Data Transform form
Completing the Definition tab — Update Page action

Usage

The Update Page action sets the page context for the subsequent (children) steps.

Use the Update Page action when you want to set values on a target page that is different from the data transform's primary page, and you want to:

• Avoid entering the target page name each time in the children Set actions
• Use source values from a page that is different from the data transform's primary page

For example, the following data transforms are equivalent:

Set pyWorkPage.CustomerType equal to "Existing"
Set pyWorkPage.CustomerLevel equal to "Bronze"

and

Update PagepyWorkPage
  Set .CustomerType equal to "Existing"
  Set .CustomerLevel equal to "Bronze"

In the second example, the Update Page action sets the page context to the pyWorkPage, so that the page does not have to be specified for the Target fields in the following children steps.

You can set the page context for the target only, or for both the target and source. To set the page context for the source, select with values from in the Relation list.

Examples

Update Page pyWorkPage
  Set .ZipCode equal to "02139"
  Set .TelPrefix equal to "617"

Update Page pyWorkPage with values from Employees
  Set .ZipCode equal to .PostalCode
  Set .TelPrefix equal to .Prefix

Relationship settings

• blank — The default. Use when setting values on a target page using source values that are on this data transform's primary page (the clipboard page with the same class as the data transform's Applies To class).
• With values from — Use when the source values are on a page other than the data transform's primary page.

Supported features

You can use the following items in the Update Page action:

• Page (top-level or embedded clipboard page)
• Page in a Page List
• Page in a Page Group
• Keywords: <APPEND>, <LAST>, Primary
• Expressions in the index (subscript) of an aggregate property

Restrictions

• You cannot use the Parent keyword.
• It is not recommended that you use the Top keyword in data transforms. There are situations where using Top does not work if a top-level page is not clearly defined (for example, if a row has both source and target pages).
• You cannot use data pages (pages that are instances of data page rules).

About Data Transforms

Open topic with navigation