Using the Admin Console, you can create new System Variables that store values for global use in Interact.
When you create a System Variable, it is immediately available for use in any Flow. In addition, any default value set for it will automatically be assigned to it in the Web Designer and during runtime.
The following rules apply when creating System Variables:
- The variable name cannot be identical to that of an existing System Variable.
- The variable name cannot be identical to that of a User variable being used in the latest version of an existing Flow.
To create a new System Variable:
- From the Resources section of the Admin Console, click System Variables. The System Variables page is displayed.
- At the top left of the page, click Add New:
A new System Variables definition page is displayed:
- In the Variable Name field, enter a unique name for the variable.
- From the Variable Type dropdown list, select its type. Along with primitive types, you can also select a Dynamic Variable, a Collection or (at the bottom of the dropdown list) choose a Custom Type.
- Use the Read Only toggle to assign the status for the new variable:
- On (Green Checkmark): The default value for the variable cannot be updated from the Web Designer.
- Off (Red X): The default value for the variable can be allocated and updated from the Web Designer.
- In the Description field, optionally enter notes or comments related to the System Variable.
- When the variable is set to Read Only, enter a name in the Client Header field that will be used to populate the variable before the Flow is run.
- When using a Multi-Environment account, an additional parameter called Environment Variable is displayed. Use the toggle to indicate whether the new variable is an Environment-level variable. For more information see Using Environment Variables.
Note: When Environment Variable is selected, the variable cannot be set to Read Only.
- If desired, enter a Default Value for the new variable. The default input field contents will vary, depending on the variable type chosen:
- Text: A textbox is provided.
- Number: A numeric counter is provided.
- Boolean: A dropdown menu is provided.
- Date: A date picker is provided.
- Dynamic: A JSON editor is provided, as detailed here. (You can paste default JSON code here as well.)
- Custom Type: Fields are provided for each selected variable type, as described here.
- Enum Type: A Default selection dropdown menu is provided, as described here.
- Collection: Fields are provided for the selected Collection type, as described here.
- Use the Format field to set a preferred format for the new variable. Formats will vary, depending on the variable type chosen.
To format a date variable, select the required date format from the dropdown menu that appears at the right. You can also use the Custom option to define a customized date format:
For more information on formatting variables, click here.
- If it appears as an option, you can activate 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.
- Optionally activate the Secure checkbox to encrypt all information that is passed by this variable. Note that this option is available only for Text type variables.
- Click Save. A confirmation message is displayed.
You can exit the operation at anytime without saving changes by clicking Cancel.
Note: When you add or make changes to a System Variable, we recommend that you Refresh currently active Flows 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.
Adding a Dynamic Variable Type as a System Variable
You can create a Dynamic Variable that will be available globally to all Flows as a System Variable.
- From the Variable Type dropdown list, select Dynamic:
- In the Default Value field, enter or paste the JSON code directly into the built-in JSON editor, as shown below:
For more information on using the editor, click here.
Adding a Custom Type as a System Variable
When choosing the Variable Type for a new System Variable, you can assign a Custom Type that already has been defined in the Admin Console for use as a System Variable:
Find and select the name of the desired Custom Type at the bottom of the dropdown menu. For detailed information, refer to Working with Custom Types.
The Default Value field will provide a separate entry for each variable type of a regular Custom Type:
If the Custom Type is an Enum, you can select the Default Value field from a dropdown menu:
Adding a Collection as a System Variable
You can create a Collection of values that will be available globally to all Flows as a System Variable.
Remember that all Collection values must be of the same type.
- From the Variable Type dropdown list, select Collection:
- From the Of dropdown list, select the variable type that will be used for the Collection, as shown in the example above.
For more details on creating Collections, click here.
- In the Default Value field, enter a value for each member of the new Collection. The new Collection size will be set according to the number of Default Values that you provide.
The following example adds default Date values:
Handling Conflicts Caused by Duplicate Variable Names
Duplicating the names of System and User variables is not allowed.
Should a System Variable be created in the Admin Console that has the same name as an existing User Variable in a Flow, the Conflicts Center panel will be displayed when the Flow with 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 Flow will then be renamed with the new name.