Adding Outcome Data to Step OutputLast Updated: 08/12/2016 Introduced in Verision: 2.0
When a step is placed within a flow, its outputs are automatically given path names that follow some basic default rules. To help you make these path names more meaningful, the Flow Designer offers controls to re-map the parameters of step paths in a number of ways, including renaming them. These controls are found in the Properties panel of the Flow Designer, under Outputs > [OutcomeName] > [OutputName].
The flow we’ll use in our example contains two form steps: Adding Article Form and Form 1. You might want to rename your output paths to more descriptive names, or to change unwieldy names into simpler ones.
In this example, we’ll refer to these forms as the first and second forms.
To begin, we’ll navigate to a Designer folder and click the Create Flow button.
We’ll give the new flow a name and click OK.
We’ll add two forms previously created for this example to the workspace.
In the Components panel, in the category Forms [Interaction] > [Current Folder], we will drag an Add Article component and a Form component to the workspace.
We’ll connect the outcome paths in the flow, then select our second form step and click the Show Mapping Editor link.
The default path names of step outputs follow the convention [StepName]_[OutputName]. As we can see in the input mapping panel for our second step, these default path names may not be very descriptive. Let’s change this one. We will click OK to close the Mapping Editor.
We will select the first form to change the outcome data.
In the Properties panel, under the Outcomes section, we will select the Output Outcome Name checkbox. This will add an additional output to our first step: the name of the outcome which determined it. We’ll see the implications of this change further down.
When we scroll down to the Outputs section of the Properties panel, we can see that the output tblock already has a mapping type of Rename and a default Name value of “tblock”.
All we have to do is give it a new name in the Name field, “Text Block_NameChanged”.
We can also update the tbox name in the Name field.
If we now click on the section Outputs > Done just above tblock, we will see a new output added to our list: OutcomePathName.
This is the Outcome Name we chose to output with the checkbox above, under Outcomes. Here, we are able to modify it before it goes to the second step. We will rename it “Output Path”.
To see the updates to our outcome data, we select the second form, and click the Show Mapping Editor link in the Properties panel.
The first step provides two outputs that can be used as inputs: Textbox_NameChanged and Text Block_NameChanged.
Our mappings for the second step reflect the updated names, including the outcome path which delivered our input data.