Using Form Outcome Rules
  • 28 Jul 2022
  • 1 Minute to read
  • Dark
    Light

Using Form Outcome Rules

  • Dark
    Light

Overview

The following features are considered legacy content.

It is not recommended to introduce these features to new projects. Support for these features have been maintained just to grant time for projects to shift away from legacy content towards the new preferred method: Active Form Flows. 

Failure to do so may result in losing work involving legacy content in the future.

A Form Outcome Rule evaluates data provided by a control in the Form.  

Example

  1. In a Designer Project, click CREATE FLOW to create a new Flow.  
  2. Attach a Show Form step to the Start step. On the Properties panel, click PICK OR CREATE FORM and create a new Form.
  3. Configure the Form to have a Label, Drop Down List (YorN), and Button (Done) control. 
  4. Select the Drop Down List control. On the Properties panel under the INPUT DATA category, change the List Input Source option to Static and enter "Interested" and "Not Interested" options.
  5. Select the workspace. On the Properties panel, navigate to FORM RULES > Legacy > Outcome Rules and click ADD.
  6. In the Add Outcome Rules window, enter "Selection" in the Name field and "Not Interested" in the Outcome Path.
  7. Under Triggers, select the YorN [Combo]: Selection Changed option and click ADD under Rules.
  8. In the Add Rules window, enter "CheckSelection" in the RuleName field. Click PICK OR CREATE RULE, select CREATE, and select Form Rule [Validation/Visibility] to create a new Rule.
  9. Click SETUP INPUT DATA. In the Input Data window, enter "Selection" under NAME. Click Save and close the window.
  10. Configure the Rule to read if "Selection Equals Not Interested." Click Save and close the Rule Designer.
         
  11. In the Add Rules window, click UPDATE INPUTS. Click the pencil icon under Inputs.
  12. In the Edit Inputs window, change Input Type to Form Component. Change the Form Data Name to YorN. Click OK.
  13. Select OK in the Edit Inputs dialog and the Add Rules dialog. Click Save and close the Form Designer.  
  14. Connect the Done and Not Interested outcome paths to the End step. Click Save to save changes to the Flow.

Debug

  1. On the top action bar, click Debug
  2. Select START DEBUGGING.
  3. When the Form displays, select Not Interested from the dropdown list to have the Flow continue on that path. Click CREATE NEW SESSION and select the Interested option and click Done to follow the Done path.


For further information on Forms, visit the Decisions Forum.

Was this article helpful?