User variables are variables created for local use, while building and running an Interaction.
Once defined, User variables are available only to the Interaction in which they were created (unlike System Variables, which are available for use in any Interaction).
As a designer, you'll likely create numerous User variables as placeholders for input that customers supply, data that the Interaction retrieves, or pieces of information that you pre-define. These values can be used and referenced at any stage during the Interaction workflow.
For example, a user is purchasing several items on your merchandise website. If the sum total exceeds a certain amount, you will offer him free delivery. To do this, you can create a User variable to store the value of the total cost of his purchase. Then you can analyze this variable in a Decision Point to determine whether or not to offer the user free delivery.
About the Variable Editor
The Variable Editor opens when you add or select a variable from the Solution Explorer. You use the Variable Editor to create, edit, or view variable details.
Note: The Variable Editor settings that are available will depend on the variable type being used.
The following table details Variable Editor settings:
|Variable Name||Each variable in the system must have a unique name which is used as its identifier.|
|Variable Type||Values must correspond to a pre-defined data structure, or type. A variable can be used only to store data that matches its type. The drop-down menu displays the available types:
|Default Value||Enter a default value to appear to the user (optional). If the user does not provide input, the default value will be used, so make this value meaningful.
Note: Image type variables do not have an option for a default value.
|Do not audit the variable's value||When this checkbox is selected, the value entered by the user is not saved in the Interact databases. Use this option for protecting sensitive data. This option is dependent on the variable type and may not always be available.|
|Secure||When this checkbox is selected, the information is encrypted for security purposes. This option is only available for Text type variables.|
|Format||Determine the preferred format for the variable type (not relevant for Boolean or Image types). For details, refer to Formatting Variables.|
Create variables using the Variable Editor, which can be accessed either from:
- Solution Explorer - Displays all available System and User variables.
- Variables List - Enter a "@" in an entry field when defining Decision Points, Allocators, or Integration Points in the Interaction to display all available System and User variables.
To Create a User Variable:
- When variables are displayed, click the icon to add a new variable. The Variable Editor opens.
- In the Variable Name field, enter a unique name for the variable.
- From the Variable Type drop-down list, select the relevant variable type:
- Boolean (True or False value)
- Custom Type. If Custom Types have already been defined (using the Admin Console), they will appear at the bottom of this list. When selecting a Custom Type, complete the required values that are displayed here.
- Collection. Create a group of variables of similar data type, or a collection of objects. For details about this data type, refer to Defining Collections.
- If desired, enter a value in the Default Value field. (This field is not relevant for Image variable types.)
- Select the Security checkboxes as required. Refer to About the Variable Editor above for more details.
- If relevant, define formatting settings for the variable. Refer to Designing Variable Display Formats for more details.
- Click Save Variable. The new User variable is stored and the Variable Editor closes.