Transform units

Learn how to transform data source outputs for use in pipelines.

Transform units allow you to modify the output of a data source. They can also be used to prepare output for a Merge unit.

In a Transform unit, you first match the structure of a data source. You then add the attributes required for your pipeline as parameters in the Transform unit. Finally, you modify the parameters you added as required. This results in a subset of parameters being provided as output from the transform unit.

You can add multiple Transform units to a pipeline.

The following screenshot shows a pipeline with a Transform unit connected to a data source and endpoint.

Pipeline with Transform unit and connected to an endpoint

To add the Transform unit as shown in the pipeline above, follow these steps.

  1. In a pipeline, drag a line from a unit and drop it onto a connection indicator.

  2. From the Select unit to place pane, click Transform Unit to add it to the pipeline.

  3. Click the Transform unit in the pipeline to display the Edit Transform pane.

  4. In the Transform area, click Create root parameter.

  5. You need to recreate the structure of the source data.

    1. Add body folder - enter body in the element name field, then click the checkmark to save the folder.

    2. Within the body folder, add data folder: hover over the new body folder, click the folder icon, then enter data in the element name field. Click the checkmark to save the folder

  6. Select the attributes you want to map to parameters and drag them to the data folder. The selected parameters determine the output from mapped data source(s).

  7. Click Done to save your changes.


In this example, a Transform unit is added to modify the data output from one of the sub-pipelines.

Click to create a root parameter
Add body folder
Add data folder within the body folder
Map attributes to parameters
Transform unit added