Data Transform form - Set action

Use the Set action to set the target equal to the source. When you specify a target page that does not yet exist on the clipboard, the Set action creates the page.

Usage

To select a value for the target property from the set of values defined in case instances for the property, click Select values.

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.

Examples

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

Relation column

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 establishes no other sort of relationship between the target and source.

Note: When serializing JSON, the source is clipboard, and when deserializing JSON, clipboard is the target.

Supported features clipboard data model format

When the data model format is clipboard, the Set action supports the target and source combinations shown in the following table. 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
Single Value Property equal to Property Reference .Department
Single Value Property equal to Literal "W-"
Single Value Property equal to Expression .FIRSTNAME + " " + .LASTNAME
Single Value Property equal to Linked Property Reference .pxCreateOperator.pyUserName
Page equal to Page OrderItems(1) equal to HardwareItems(1)

The source and target support the following items:

  • Properties
  • Literals
  • Expressions (in the source column only)
  • Parameters specified on the Parameters tab (for example, param.Name )
  • Page Lists
  • Page Groups
  • Value Lists
  • Value Groups
  • Keywords: Primary, <APPEND>
  • Function calls (in the source column only )

When the Set action is preceded by an Update Page, the context of the source is reset and all property references are relative to the new page.

Restrictions

The use of Top and Parent keywords 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 as 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.