Edge Documentation

{{DISPLAYTITLE:Show Actions Menu Action}}
[[Category:AppBoard old]]
The "Show Actions Menu" Action provides a list of Actions for the User to choose from.  The list of available Actions is pre-configured by the visualization designer, and each selection can invoke one Action or a series of Actions.  This Action is similar to the [[appboard/old/actions/bundled_actions|Bundled Actions]] Action.  The difference is that "Bundled Actions" has a single set of Actions that will execute when an item is clicked, while "Show Actions Menu" provides a visual list of two or more sets of Bundled Actions for the User to choose from.


== How To Create a Show Actions Menu Action ==

For instructions on adding an Action to a Widget, see the general instructions in [[appboard/old/actions#How_To_Create_an_Action_in_a_Widget|How To Create an Action in a Widget]].

== How To Configure a Show Actions Menu Action ==

Perform the following steps to configure a "Show Actions Menu" Action:


# Follow the instructions above to create the basic "Show Actions Menu" Action.
# Click the <b>Edit Actions Menu</b> button to open the <b>Edit Actions Menu</b> window.
# Click <b>Add Action to Menu</b> and select an Action type to create the first option to be provided in the Actions Menu.
## Under <b>Menu label for action</b>, enter the label to be displayed to the User for this Action (or group of Actions) in the Actions Menu.
## [Optional] If you want to have multiple Actions for this menu choice, click <b>Add Action</b> to implement additional Actions that will be invoked for this menu option.
# Click <b>Add Action to Menu</b> and select an Action type to create the first option to be provided in the Actions Menu.
## Under <b>Menu label for action</b>, enter the label to be displayed to the User for this second Action (or group of Actions) in the Actions Menu.
## [Optional] Again, click <b>Add Action</b> to implement additional Actions that will be invoked for this menu option.
# Continue adding options until the list contains all of the options to be provided to the User.
# Click <b>Close</b> to return to the Widget Wizard.
# Click <b>Finish</b>
# Click in the Widget and verify that the desired labels are shown in the Action Menu.
# Test each of the options to confirm that it implements the expected Action or group of Actions.


{{Tip|The Actions Menu should have at least two labeled options. Otherwise, a standard Action can be used and there would be no need to use the Actions Menu}}


== Nested Show Actions Menus ==

The "Show Actions Menu" Action can be used to create nested menus of Actions.  To do so, configure one of the Actions in the menu to be another "Show Actions Menu" Action.  This menu can itself have another "Show Actions Menu" Action as one of the options in the list.  This can be repeated and nested as deeply as desired by the Board designer.


== Sample Use Case ==

Suppose you want to give the User two different options when clicking a point on a Map Widget:

# Show the Record Details Window for the node on the map
# Drill down to another Board with a filtered Data Collection


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


[[Image:ActionsMenuConfigure.png|thumb|center|500px|Sample Configuration of an Actions Menu]]


When the User clicks in the Map Widget, he will receive the following menu of Actions:


[[Image:ActionsMenuResult.png|thumb|center|500px|Display of Actions Menu in Widget]]