Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Data Transform form - Set action

Updated on January 14, 2022

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.

TargetRelationSourceExample
Single Value Propertyequal toProperty Reference.Department
Single Value Propertyequal toLiteral"W-"
Single Value Propertyequal toExpression.FIRSTNAME + " " + .LASTNAME
Single Value Propertyequal toLinked Property Reference.pxCreateOperator.pyUserName
Pageequal toPageOrderItems(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.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us