You are here: Reference > Rule types > Data Transforms > Data Transform form - Completing the Definition tab - Set action

  Data Transform form
Completing the Definition tab — 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.

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

The Set action supports the following target and source combinations. 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