Reco Set Simulator Script State

This Reco tool changes the active state in the simulation script for an interaction. It also returns the <CustomData> child element if the <State> element has one.

Note: The state can be changed at any time, but changing the state while an input operation is active could lead to unexpected behavior.

Inputs

Interaction

Identifier of the simulated interaction.

New State

Identifier of the state in the simulation script ('id' attribute of the <State> element) to be activated. If this is an empty string, the first state will be activated.

Outputs

Custom Data

<CustomData> child element of the <State> element in the simulation script. NULL node if the <State> element does not have a <CustomData> child element.

Exit Paths

Success

This path is taken if the simulated interaction successfully queried. 

Failure

This path is taken if there is an error changing the state. Common causes for this are if the state is invalid, the interaction has already been disconnected, or it's not a simulated interaction.