Setting Required Value For Outcome Path

Overview

This tutorial demonstrates how to set required fields on the Form dynamically. Please review the Creating a Form document to learn about Required and Optional Outcome scenarios. When designing a Form with some user input controls, it can be hard to decide if an input should be required or optional. With this feature, the Flow can decide based on data evaluation before loading the 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. 
2. In the Properties panel, select the Pick or Create Form button.
3. Then, navigate to the Create or Pick window and CREATE a new Form.
4. In the Form Designer, design the Form with a Button, Label, and Text Box.
5. Navigate to the Text Box Properties.
6. Enable the Optional Outcome Scenario.

   Required Outcome Scenario	the user will not be able to submit the Form without providing input
   Optional Outcome Scenario	the user may leave an input empty and be able to submit the Form
   Not Used	the data provided in the input will not be available in the next steps in the Flow

7. Navigate to the Data section.
   1. Set the Get required from input data check-box to true.
8. Save the Form and close Form Designer.
9. In the Flow Designer, select the Show Form step.
10. In the Properties panel, the Form has two Inputs. 
    1. The first one is for Text Box; set the mapping type to Ignore. 
    2. The second one is a Boolean variable that defines if the Text Box input should be required or optional. Set the mapping type to Constant and set the Value to ‘True’.
11. Connect the outcome of the Show Form step to the End step.

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.
   1.  Notice a validation issue, and the Form will not be submitted.
3. Add text to the Text Box, and the Form will be submitted successfully.