Setting Required Value For Outcome Path

  • Published on Aug 8, 2024
  • 1 minute(s) read
Prev Next

Overview

This tutorial demonstrates how to set required fields on the Form dynamically. With this feature, the Flow automatically decides which data is/is not optional based on data evaluation before loading the Form without need of Designer input for each field.

Each data input within a Form can have its Outcome Scenarios settings changed for each outcome path in the following methods:

Data RequirementDescription
RequiredData must be entered into this control to submit the Form down this outcome path. If missing, a validation error prevents submission.
OptionalData may be entered into this control for other Flow logic, but is not required for submission. If this data is empty upon submission, the Form will still submit successfully.
Not UsedData entered here is not used for this outcome path. Regardless if a value is entered here or otherwise, it will not be present for selection in Flow logic after this Form.


Example

In this example, build a simple Flow with a Form. The Form will have a text-box control that may be set to be either required or optional. This will be set as a Form input.

  1. In the Flow Designer, add a Show Form step and create a new Form.
  2. In the Form Designer, design the Form with the following controls: two Buttons and a Text Box. Give the Text Box a Label during creation.
  3. Navigate to the Text Box Properties > Outcome Scenarios. Select Submit's outcome scenario to Required and Cancel's to Not Used.
  4. Save the Form and close Form Designer.
  5. In the Flow Designer, select the Show Form step. In the Properties panel's 'Example Data' Input, set it's mapping type to Ignore.
  6. Connect the Submit outcome path to the end step. Add a second End step, name it 'Cancelled', and connect the Cancel outcome path from the Form to it.

Debug

  1.  Select Debug on the top panel in the Flow Designer
  2. Attempt to Submit the Form without providing input in the Text-Box. Notice a validation issue preventing Form submission.
  3. Add text to the Text Box, and the Form will be submitted successfully.