Data Transform form - Apply Data Transform action

Usage

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

To apply the data transform to a specific page, specify a row 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.

In addition, you can only apply a data transform that is a JSON data model format. You cannot apply a data transform that is a clipboard data model format.

Example

Apply Data Transform

SetShippingInformation

Relationship settings

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

Supported features

You can specify the following items in the Apply Data Transform action:

  • Data transform rule - JSON data transforms can only call other JSON data transforms. Clipboard data transforms can call any data transform.
  • Input parameters
  • Passing the current parameter page

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.

Restrictions

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 runtime), design-time validation does not check to see if the specified data transform exists when you save this data transform form.