Form Control Key Triggers
  • 16 Jun 2022
  • 2 Minutes to read
  • Dark
    Light

Form Control Key Triggers

  • Dark
    Light

Overview

Key Triggers allow users to create key shortcuts that may perform different actions such as navigating to a different control, triggering action controls, running validation rules or data flows. 

These key shortcuts may be designed to work throughout the entire Form or for only specific Form controls.


Configuration

To set a key trigger, select a control to view its Properties then expand the Triggers section and select ADD. The following configuration options are available:

Setting NameFunction
Shortcut KeyPrompts for the shortcut/hotkey for the trigger e.g. SHIFT+R
Trigger TypeAllows selection of trigger functionality i.e. what occurs after initiating the trigger

GoToControl
This function will trigger the focus of the Form to a Form control.


Control To FocusAllows selection of which control will the shortcut trigger will autofocus towards

TriggerAction
This function will trigger an action placed on the Form; if a Button is placed on the Form it will trigger the Button based on the configured Shortcut Keys. 


Control To TriggerAllows selection of which action present on the Form to trigger

RunActiveFormFlow
This function will trigger a previously created Active Form Flow to run based on user settings which can validate user input, hide/show or enable/disable controls, and set values on controls.


Active Form FlowAllows selection of which Active Form Flow to run once initiating the trigger

RunValidation
This function will be phased out and replaced with Active Form Flows. 


Validation RulesAllows selection of which Validation Rule to run once initiating the trigger

RunDataFlow
This function will be phased out and replaced with Active Form Flows. 


Data FlowsAllows selection of which Data Flow to run once initiating the trigger



Example

  1. In a Designer Project, create a Flow. It will automatically open in the Flow Designer. 
  2. In the Flow Designer, add a Show Form step from Toolbox > FAVORITE STEPS section to create a new Form. It will automatically open in the Form Designer.
  3. In the Form Designer, from the Toolbox > FAVORITES, add a Button [Done] and a Textbox control. Provide a Data Name for the Textbox.
  4. Select the Text Box. In its Properties panel > TRIGGERS > Key Triggers, select Add New.

  5. In the Add Key Triggers window, define Shortcut Key by selecting the setting then entering a key or a combination of keys.
  6. Next, set the Trigger Type to TriggerAction. Notice the Control to Focus setting change to Control To Action. Select the [Done] Button then select OK to confirm the trigger creation.


  7. Save and close the Form Designer.
  8. In the Flow Designer, set the Form's input mapping to Ignore. Connect the Done outcome of the Form to the End step to complete the Flow. 

Debug

  1. Select Debug from the Top Action Panel.
  2. In the Debugger, click START DEBUGGING and the Form will display. The Shortcut Keys [Shift + R] will be selected on the keyboard and the Form will close; this ends the Flow.


For further information on Forms, visit the Decisions Forum.

Was this article helpful?