Mapping Form Data Inputs and Outputs
  • Updated on 09 May 2013
  • 2 minutes to read
  • Print
  • Dark
    Light

Mapping Form Data Inputs and Outputs

  • Print
  • Dark
    Light

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.
2018-01-03_163445-1.png

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.
2018-03-30_102917-3.png

Name the flow and click Create .
2018-01-03_114251.png

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.
2018-01-03_122421.png

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 .
2018-01-03_161615.png

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.
2018-01-03_161628.png

Since the outcome path of theForm 1 step has already been connected to theForm 2 step, we see the outputs from theForm 1 step listed as possible inputs.
2018-01-03_161727.png

The panel on the right displays the outputs available for the selected step (in this caseForm 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 .
2018-01-03_161915.png

Save the flow and close theFlow Designer .
To run the flow select Debug
2018-01-03_162857.png

Enter data in the fields inForm 1 and click the button to submit the form. This data is the output for Form 1 . . .
2018-01-03_163445.png

. . . and is then used as input for Form 2.
2018-01-03_163721.png

Was this article helpful?