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:

• Properties
• Literals
• Expressions
• Parameters specified on the Parameters tab (for example, param.Name)
• Page Lists
• Page Groups
• Value Lists
• Value Groups
• Keywords: Primary, <APPEND>, param
• Function calls (for example, @addToDate(@CurrentDateTime(),1,"","",""))

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

Restrictions

Use of Top and Parent is not supported.

You cannot set properties on declarative 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 checkbox selected on the Advanced tab of their Property forms). They cannot be specified as targets.

About Data Transforms