Appboard/old/actions/set widget selection

The "Set Widget Selection" Action controls what item is selected in a Widget based on an event or selection in another Widget.

How To Create a Set Widget Selection Action

For instructions on adding an Action to a Widget, see the general instructions in How To Create an Action in a Widget.

How To Configure a Set Widget Selection Action

Perform the following steps to configure a "Set Widget Selection" Action:

1. Follow the instructions above to create the basic "Set Widget Selection" Action.
2. Under Set selection on, select the name of the target Widget in which you want to set the selected value.
3. Choose one of the options for how the selection should be determined:
   1. as no selection: Set the Widget to remove any previous selection so that nothing in the Widget will be selected.
   2. from event: Select the name of the property on the data used to trigger this event.
   3. from widget's last selection: Use the last selected item in a source Widget to determine what to select in the target Widget.
4. Check the box next to Trigger actions on last widget if you want any Actions associated with clicking on the target Widget to be invoked, as if the User had clicked the selected item in the target Widget.
5. Click Finish to exit the Widget Wizard and test the Action.

Sample Use Case

Suppose you have two Widgets, a Map and a table. You want to select (highlight) the row in the table that corresponds to the node that is clicked in the map. Perform the following steps to configure the Set Widget Selection Action:

1. In the Map Widget, click the lightning bolt to go to the Actions panel in the Widget Wizard.
2. Click Add Event Action and select the Set Widget Selection Action.
3. Under Set selection on, select the name of the Table Widget.
4. Choose from widget's last selection and select the name of the Map Widget from the list.

Perform the steps outlined above to create an Action configuration similar to what is presented in the following image:

Sample Configuration of Set Widget Selection Action

When the User clicks a node in the Map Widget, the corresponding row in the Table Widget is selected:

Sample Result of Set Widget Selection Action