You create new System Variables using the New System Variable dialog. Any variables added here will be immediately available to all Interactions.
To create a new System Variable:
Note: System Variables cannot be added while working in TEST or PROD environments of a Multi Environment Account.
- At the upper right corner of the System Variables page, click Add. The New System Variable dialog opens.
- In the Variable Name textbox, enter a unique name for the variable. The name is a required field. The new name cannot be identical to that of any other existing System or User Variable.
- From the Variable Type dropdown list, select its type. The default variable type is Text.
- If desired, configure the default value for the new variable. The default input field will vary, depending on the variable type chosen:
- Text, Number, Currency: A textbox is presented.
- Boolean: A checkbox is presented.
- Date: A textbox with a date picker is presented. Use the date picker to navigate to and select a date, or simply enter the date in the textbox.
- Image: No default value may be defined.
- Custom Types: You can select variables defined on the Custom Types page of the Admin Console.
When using this type, only the name of the selected variable appears in this dialog. For detailed information, refer to Working with Custom Types.
- In the Description field, enter notes or comments related to the variable.
- If it appears as an option, you can select the Do not audit the variable’s value checkbox to prevent this variable from being saved in the Interact database. This field helps to ensure the privacy of the variable's data.
- If it appears as an option, you can select the desired status of the new variable from the Read Only dropdown list:
Note: Image and Custom variable types do not provide a Read Only option.
- Yes: The variable will be Read Only. (The user is not able to update the default value.)
- No: The variable will not be Read Only. (The user is able to update the default value.) This is the default status.
- When adding a date variable, specify the required date format by selecting it from the Format dropdown menu that appears below.
The Custom option allows you to define a customized date format:
- When the variable is Read Only, in the Client Header textbox, enter a name to be passed at the start of the Interaction to populate the variable.
- When using a Multi-Environment Accounts, an additional parameter called Environment Variable is displayed. For more information about this variable, refer to Using Environment Variables.
- Click Save. A confirmation message is displayed, and the new variable is displayed in the System Variables list.
Note: When you add or make changes to a System Variable, we recommend that you Refresh currently active Interactions to update them with the new information and redraw them in the Web Designer. Use the Refresh button in the main toolbar of the Web Designer. For more information, click here.
Handling Conflicts Caused by Duplicate Variable Names
Duplicating the names of System and User variables is not allowed in the Interaction Designer.
Should a System Variable be created in the Admin Console that has the same name as an existing User Variable in an Interaction, the Conflicts Center panel will be displayed when an Interaction with the duplicate User Variable is opened in the Web Designer.
The Conflicts Center will assist you in locating the conflicting User Variable and prompt you to assign it a unique new name. Conflicting instances of the User Variable in the Interaction will then be renamed with the new name.