Active Form Flows - Validations
  • 31 Jul 2024
  • 2 Minutes to read
  • Dark
    Light

Active Form Flows - Validations

  • Dark
    Light

Article summary

Overview 

The most common use cases of Active Form Flows involve either validating data to ensure accuracy before submission or hiding/showing Form controls to dynamically populate a Form depending on the end user's selection. 

The following article details how to configure an Active Form Flow for validation. Refer to Active Form Flow - Visibility to learn more about hiding/showing Form controls.


Validation

  1. In a Designer Folder, create a Flow and add a Show Form step to create a new Form in the Flow. It will automatically open in the Form Designer.
  2. In a Form, add a Textbox with a Label named 'Validate'.
  3. Navigate to Form Properties > Form Rules > Active Form Flows. Select ADD.
  4. In the Add Active Form Flows dialog, name the Rule Flow, then select EDIT RULE FLOW.
  5. In the Rule Flow Designer, add a Text Contains Rule step from the Designer Entities > Rules > System Defaults > Default Form Validation Rules category after the Start step.
  6. With the Text Contains Rule step selected, navigate to Properties > Inputs.
    For the contains String input, change the mapping type Constant. Enter 'ABCD'. For the string Value input, change the mapping type to Select From Flow and choose Form Data > Validate Text Box > Value.
  7. Add a Set Validations step on the False outcome path on the Text Contains Rule step from the Form Rules category in the Toolbox. 
  8. With the Set Validations step selected, navigate to the Properties panel.
    Under Inputs > Form Control, change the mapping type to Select From Flow and choose Form Data > Validate Text Box. Under Inputs > Validation Issues, change the mapping type to Constant, then select ADD. 
  9. In the Add Value dialog, change the BreakLevel to Fatal. Type a Message that will appear when users trigger the validation error, then select OK.
    Validation Issue Properties
    Description
    BreakLevel

    WarningBoxes in the control in a yellow box; the Flow can progress if validation is not met.

    FatalBoxes in the control in a red box; the Flow will not proceed until validation is met. 

    IgnoredDoes not box in or highlight control; the Flow can progress if validation is not met. 
    MessageThis message will display on hover if the validation is not met. This message is meant to give guidance on what the requirements are.
  10. On the True outcome path from the Run Rule step, add a Clear All Validations step from the Form Rules category in the Toolbox.
  11. Connect all outcome paths to the End step. Save and close the Rule Flow Designer.
  12. Save and exit the Active Form Flow Designer to return back to the Add Active Form Flows dialog.
  13. Under Advanced > Triggers, set 'Validate [Textbox]' to trigger on StoppedTyping. For Run For Outcomes, select the 'Submit' outcome.
  14. Select OK to return to the Form Designer. Save and exit the Flow Designer.

Debug

  1. Select the Debug Action in the orange Action Bar.
  2. Select START DEBUGGING.

The created validation Active Form Flow will now check if the Textbox contains the specified 'ABCD' string value each time typing occurs within. If the value does not match this, the validation error prevents submission down the specified outcome path. 

Once 'ABCD' is entered, the validation issue resolves, thus allowing Form submission.


For further information on Forms, visit the Decisions Forum.

Was this article helpful?