You are here: Reference > Rule types > Data Transforms > Data Transform form - Set action

Data Transform form - Set action

Usage

The Set action sets the target equal to the source.

When target pages are specified that do not yet exist on the clipboard, the Set action creates the pages.

JSON data model format

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

Examples

Set .pyWorkIDPrefix equal to "W-"
Set .HardwareItems(1).Price equal to ""

Relationship settings

The Set action has a fixed Relation setting of equal to. That is, the Set action always sets the target equal to the source, and makes no other sort of relationship between the target and source.

Supported features clipboard data model format

The Set action supports the following target and source combinations when the data model format is clipboard. These features are not supported when the data model format is JSON.

The class of the target does not have to match the class of the source.

Target

Relation

Source

Example

Property equal to Property Reference .Department
Property equal to Literal "W-"
Property equal to Expression .FIRSTNAME + " " + .LASTNAME
Property equal to Linked Property Reference .pxCreateOperator.pyUserName
Page equal to Page OrderItems(1) equal to HardwareItems(1)

Use of the following items is supported:

In the Source field, you can use values from data pages, when the Set action is preceded by an Update Page action that sets the context of the Source to the data page.

Restrictions

Use of Top and Parent is not supported.

You cannot set properties on data pages. Such properties cannot be specified as targets.

References to linked properties are read-only. Such properties can be specified as sources, but not targets.

You cannot set reference properties (properties that have the Reference Property check box selected on the Advanced tab of their Property forms). They cannot be specified as targets.

About Data Transforms