Data Transform form - Apply Data Transform action

Use the Apply Data Transform action to apply actions defined in another data transform (the applied data transform).

Usage

To apply the data transform to a specific page, specify a row by using an Update Page action before the Apply Data Transform action row. To apply the data transform to a specific page, precede the Apply Data Transform action with an Update Page action to identify the page.

JSON data model format

When the data model format is JSON, there are the following differences in behavior:

  • The order of the steps is not guaranteed.
  • The data transform is bidirectional.

Relation column

The Apply Data Transform action has no setting for the Relation field.

Parameters in the to-be-applied data transform

The applied data transform can have parameters defined on its Parameters tab. In the Apply Data Transform action row, click the View Data Transform Parameters icon to provide values for the applied data transform's input parameters (if any), or specify whether to pass the current parameter page.

When the Pass current parameter page? check box is selected, the two data transforms (the one that has the Apply Data Transform row and the applied data transform specified in that row) share one parameter page. If the check box is not selected, the parameters on the parameter page for the applied data transform are not available to the other data transform, and vice versa.

If the current parameter page is shared, and the applied data transform has a parameter declared as Out, if the applied data transform updates the value of that parameter, the resulting value is available to the other data transform.

Note: If the data transform that you are calling changes any values on the parameter page, those values will be lost if you do not select the Pass current parameter page? check box. For example, when calling a JSON data transform using the SERIALIZE value for the executionMode parameter, the resulting JSON data is written to the parameter page as a value of jsonData.

Restrictions

You cannot call a clipboard data transform from a JSON data transform.

You cannot use the Top or Parent keywords in the entry field when specifying the applied data transform.

You cannot use expressions when specifying the applied data transform.

When $ANY is used in the entry field (to make the class of the applied data transform assignable at run time), design-time validation does not check whether the specified data transform exists when you save this data transform form.