User Data Block

You can use in a routing application to update an interaction's User Data and for attaching Business Attributes, Categories and Skills. Corresponds to the Universal Routing Server function _genesys.ixn.setuData(input,ixn) available in Expression Builder. This block generates ECMAScript inside an SCXML state and does not rely on External Service Protocol via <session:fetch>. For manually attaching categories to an interaction, the User Data block can be used and then a Branching block can be (optionally) used to segment interactions to different logical branches based on the different categories. Important! See Mandatory User Data For UCS Blocks.

Variable Naming

Do not assign the value of a variable named data to a key-value pair. This will not work since the generated code also declares a variable named data.

The User Data block has the following properties:

Name Property

Find this property's details under Common Properties.

Block Notes Property

Find this property's details under Common Properties.

Assign Data Property

This property specifies one or more key-value pairs to add to the interaction’s User Data. To specify hey-value pairs, click in the Value column to display the button and click it to bring up the dialog. Data from various sources can be attached as well as free form key value pairs can be specified (Default). However, note that only one category can be used in a block. Switching categories will erase previously specified values.

UserData1.gif

1. Default This option can be used to specify both the key name and the key value as literals or variables.

Note: In case the key or value contains special characters that may require encoding e.g. '<', '-', or quotes, define a variable and set its value to this literal and use the variable as the value.

2. Business Attributes This picks up specific business attributes and if connected to Configuration Server, shows a list of values configured for these attributes.

3. Skills One or more skills can be specified. If connected to Configuration Server, a list of skills is shown.

4. Categories This option requires an active connection to Configuration Server and supports attaching categories defined in Configuration Server as well as Relevancy for the category. Relevancy is a number from 1 to 100 that reflects the minimum relevance percentage that each classification category must have in order for Classification Server to consider an interaction as belonging to that category.

Click the Add button to add a key-value pair of the selected type. When done, click Ok to dismiss the dialog and Save the diagram.

Exceptions Property

Find this property's details under Common Properties.

Interaction ID Property

Set to a meaningful value or keep the default value, which is the system variable InteractionId. Can be used for "interaction-less" processing for scenarios where the InteractionId variable is not automatically initialized, but instead must wait for an event. An example would be an SCXML application triggered by a Web Service that does not add an interaction.   Background: Previous to 8.1.1, Composer did not expose an Interaction ID property.  Instead, when ORS started processing an interaction, a generated SCXML application automatically initialized the system variable, InteractionId. This variable was then used internally by Routing and certain eServices blocks when interacting with ORS. With the introduction of support for Interaction-less processing, you can now define a specific event (Wait For Event property) to initialize InteractionId, or not define an event at all. For scenarios with an interaction (IPD Diagram/Wait For Event=interaction.present for example), you may keep the default value for the Interaction ID property. The default value is the system variable InteractionId, which is initialized automatically in this case. For other scenarios (any scenario where the system variable InteractionId is not set), you may choose to:

1. Not use blocks that require an Interaction ID
2. And/or set the Interaction ID property to a meaningful value
3. And/or assign a meaningful value to the InteractionId  system variable

Wait For Event Property

This property allows you to choose whether to wait for the user data changed event before transitioning to the next block.

1. Click Wait for Event under Property.
2. Under Value, select one of the following:

• True
• False

Condition Property

Find this property's details under Common Properties.

Logging Details Property

Find this property's details under Common Properties.

Log Level Property

Find this property's details under Common Properties.

Enable Status Property

Find this property's details under Common Properties.