The Run Data Flow Data Operation The Run Data Flow Data Operation

The Run Data Flow Data Operation

Elliot Fiske Elliot Fiske

Overview

The Run Data Flow Data Operation starts a Data Flow from within the current Data Flow. It can be used to easily reuse Data Flows across the Connection Builder. It can also be used to run a Data Flow multiple times.

run-data-flow.gif

Use Cases

  • If you find yourself repeating the same set of Actions throughout different Data Flows, combine them into one Data Flow and run them with the Run Data Flow Operation.
  • Given a list of names, use "Run Multiple Data Flows" to make new Salesforce Leads for each of the names.

Data Operation Properties

Data Flow

This dropdown will list all the Data Flows in the App. The currently selected Data Flow will run when this Operation is executed.

Asynchronous

If this is checked, this Operation will kick off its Data Flows in the background and immediately continue to the next Operation in your Data Flow. Note that the Run Results will not contain the end results of a Data Flow run asynchronously.

Skip Data Flow

The Airscript expression in this field is checked at the start of the Operation. If it is TRUE, the entire Operation will be skipped and no Data Flows will be run.

Run Multiple Data Flows?

If checked, the selected Data Flow will run multiple times using input from the Data List. There are several fields that appear when Run Multiple is checked:

  • Data: A list of inputs. For every input in the list, the selected Data Flow will be run once with that input.
  • Item Name: An implicit Variable will be created that contains the current input from the Data list. That Variable will have the name specified here.
  • Index Name: An implicit Variable will be created that contains the current index of the input in the Data list. That Variable will have the name specified here.
    • For example, with the default value of index, the first time the Data Flow is run, index will be 0. The second time index will be 1, and so on.
  • Collection Name: An implicit Variable will be created that contains the entire Data list.

Below is an example of how to use Run Multiple Data Flows. The selected Data Flow is "Combine Text", which combines 2 Text values together. The value in Data is a List containing the inputs for the Data Flow.

The first time the Data Flow is run, it sets item to the first value in the list of data: { first_input: "hello", second_input: "there" }. In the Inputs entry, that item value is used to get the first_input and second_input to the correct inputs for Combine Text.

mceclip0.png

The "Combine Text" Data Flow is run 2 times, and the 2 results are placed in a List in the Run Results.

Run Results

An automatically created Variable to hold the result of the Data Flow(s). If multiple Data Flows were run, the results of each of the Flows will be in a list in the order they were run. If Asynchronous is checked, the Run Results will not contain any results. Instead they will contain {sent: true} to denote that the Data Flows have been started in the background.

If Skip Data Flow was TRUE, this will contain {skipped: true}.

Further Reading

To learn how to create and manage Data Flows, read Introduction to Data Flows.

To start using Airscript to parse data to fit your needs, read Airscript Quick Start.