Configuring Actions

Defining Actions On Controls

1. On the Layout board, choose Action from the context menu of the control for which you want to define an action.

2. In the Actions tab of the Define Action dialog box, click the Add Action button.

3. Choose an action that you want to define for the control. You can choose either a predefined action from the list or Custom Action to define a specialized action.

Defining Action Behavior

1. Under Action Properties , define the properties for the action. The available properties depend on the action you choose. For a description of all the action properties, see Define Action Dialog Box in the Visual Composer Reference Guide .

   For certain action properties, you can define the value using a dynamic expression (by clicking the fx button). For more information, see Working with Dynamic Expressions .

2. If you have defined multiple actions for a control, choose an option in the Execution mode dropdown list box to specify how the actions should be performed:

   • Sequence : Indicates that the first action in the list should be checked at runtime to see whether its defined condition criteria are met. If yes, the action is performed and the next action in the list is then checked, and so on. This process continues until all actions in the list have been checked and all actions that meet the condition criteria have been performed.

   • Switch : Indicates that the first action in the list should be checked at runtime to see whether its defined condition criteria are met. If yes, the action is performed and no other actions in the list are checked or performed. If no, the next action in the list is checked, and so on.

3. To ensure that a control loaded with a predefined action is enabled at runtime, that action must meet its precondition. Preconditions for predefined actions are mentioned in the table below:

   Action	Precondition
   Back	The navigation history is not empty
   Assign	The target node is not empty
   Copy Row(s)	The set of source objects to copy is not empty
   Move Row(s)	The set of source objects to move is not empty
   Clear	The node to clear is not empty
   Delete Row(s)	The set of objects to delete is not empty
   Find Row	The node to search is not empty
   Insert Row(s)	If the node is not a root node, then its parent node is not empty
   Sort Rows	The node to be sorted is not empty

   For Insert Row(s) and Delete Row(s) actions, in addition to preconditions, cardinality determines their runtime behavior:

   Cardinality	Behavior
   0...1	User cannot insert more than one element to a node
   1...1	User cannot insert or delete an element
   1...n	User cannot delete the last element of a node

4. In the Validation tab, specify the controls that are validated when this action is triggered

5. Choose Close .