Mapping Form Data Inputs and Outputs

Last Updated: 05/03/2018 Introduced in Version: 2.0

Some components in a flow store or transform data which can then be output for use by another flow component. For example, when a user enters information in a form’s field, that data, the output of the field, can then be used as an input to another component in the flow. The data in the form field could, for example, be used as the input for a field on another form where the data can be displayed or further edited. 

Example

In this example, create a flow that displays a form.

 

The form contains six fields for capturing information. Once a user enters data in the fields and clicks a button to submit the form, the flow uses the outputs of that form as inputs for the next step in the flow, a second form. This form lists the data entered in the previous form.

This example assumes that two forms – Form 1 and Form 2 – have already been created.

To begin, navigate to a project folder and click the Create Flow button.

 

Name the flow and click Create.

 

To begin building the flow, add the two previously created forms to it.

In the Flow Designer’s startup window expand the Flows, Rules, Forms and Reports > Forms [Integration] > [Current Folder] category. Select Form 1 step and click Add to place it to the workspace.

Repeat the process to place a Form 2 component on the workspace.
Or could also create a new form by dragging the [Pick or Create Form] component to the workspace.
Next,  connect the outcome paths in the flow.

Connect the [Form] Form 1 component to the [Form] Form 2 component, and connect the [Form] Form 2 component to the End Step.

  

To map the outputs of the [Form] Form 1 step to the inputs of the [Form] Form 2 step, right-click the [Form] Form 2 step and click the Show Mapping Editor link at the button of the pop-up window.

 

Since the outcome path of the Form 1 step has already been connected to the Form 2 step, we see the outputs from the Form 1 step listed as possible inputs.

 

The panel on the right displays the outputs available for the selected step (in this case Form 2).  The Form 2 step does not have any potential outputs for other components to use yet, which is why the panel on the right displays “No Outputs.”

The list in the center displays the objects contained in the selected component that can accept input. Note that these objects are distinct from any objects that the selected component can use as output to another component; that is, objects that accept input do not necessarily provide output.

Connect each output on the left to its input on the right by dragging the arrow from the output to the input. Once the five outputs from Form 1′s fields have been mapped to the inputs on Form 2, click OK to save the changes and close the Mapping Editor.

 

Save the flow and close the Flow Designer.

To run the flow select Debug

 

Enter data in the fields in Form 1 and click the button to submit the form. This data is the output for Form 1 . . .

 

. . . and is then used as input for Form 2.

 

 

Additional Resources