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.
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.
Previous topic Data Transform form - Append to action Next topic Data Transform form - Auto-map action