Edge Documentation

The Quick Action Widget provides a simple mechanism for filtering Data Collections, and is designed to provide contextual filtering for other Widgets on a Board.

[[Image:QuickActionWidget.png|thumb|center|700px|A Sample Quick Action Widget]]


== How To Create a Quick Action Widget ==


For instructions on creating a Widget, see the general instructions in [[appboard/old/widgets#Adding_Widgets|Adding Widgets]].  The <b>Quick Action</b> Widget type is located under the <b>System</b> category on the Widget selection screen.

== How To Configure a Quick Action Widget ==


# Follow the instructions above to create the basic "Quick Action" Widget.
# Enter the following information on the <b>Data</b> tab:
#* <b>Data collection</b>: Select the name of the Data Collection that will provide the data to be displayed in the Quick Action.
#: Note: For convenience, buttons are provided for Adding, Editing, or Previewing a Data Collection.
#* <b>Label Field</b>: Select the field in the Data Collection which contains the values that will populate the Quick Action's drop down menu.
#* <b>Startup Selection</b>: This setting allows a value from the "Label Field" to act as an initial selection, pre-filtering the data displayed when first arriving on a board.   
#** First Value & Last Value:  These settings will use either the first or last value in the data set as the initial selection.  Use these settings if the values in the Label Field change frequently.
#** Specific Value:  This setting lets the Widget designer fix the initial selection based on a value that is available in the Data Collection at the time of configuration.  This works well if the values are fairly static.  However, If the values in the dataset change, then it is recommended to use First or Last Value, in conjunction with a sort, to provide the initial selection. 
#* <b>Initialize Action</b>: This setting determines when the Actions associated with the Quick Action widget will fire.  
#** Select "On Startup" If you want the initial selection to act as a pre-filter for the Widgets on a Board.
#** Select "On Selection" to show all available data initially.  This option forces an explicit selection before applying filters to data.
# Provide additional configuration on the <b>Options</b> tab.  For details on the available Options, see [[appboard/old/options|Options]].
# Click <b>Next</b> to proceed to the <b>Actions</b> tab.
# Click <b>Add Event Action</b> to configure one or more [[appboard/old/actions|Actions]] to be invoked when a user clicks on the Quick Action Widget.  The action will apply to the current data record being displayed.
# Click <b>Finish</b>.
# In the <b>Builder Modes</b> panel, select <b>Builder</b> and navigate to the appropriate Board to observe the new Quick Action Widget.

== Sample Data ==

Perform the following steps to create a Quick Filter using sample data provided with Appboard:


# Follow the instruction on the [[Sample_Chart_Data|Sample Chart Data]] page to create sample Data Collections.
# Select any of the Data Collections to use as the Data Collection for the Quick Filter.
# Select any field in the Data Collection to use as the Label Field for the Use this setting.