You are here: Reference > Rule types > Data Transforms > Data Transform form - Completing the Definition tab - Append and Map to action
Data Transform form
Completing the Definition tab — Append and Map to action
|
|
Usage
Use the Append and Map to action to append a page to the target Page List mode property and set the context to that page for subsequent child actions to map properties on that page. The target and source can be of different Applies To classes.
The Append and Map to action is equivalent to doing an Update Page action using the <APPEND> keyword. When the system invokes the Append and Map to action, it creates a new page in the target Page List property, without creating any embedded properties in that new page. Then, subsequent children actions create the embedded properties on the page.
When you select the Append and Map to action, the system automatically displays a child Set action, because no properties yet exist on the newly created page.
When using a Source that is a Page List or a Page Group property (using the each page in choice for the Relation), the 
button appears next to the each page in choice. Click this button to specify a when condition rule for the Append and Map to action, so that a page from the source is appended to the target only if the condition is true. For example, when your target is a Page List property of PreferredCustomers, and you want to map data from an AllCustomers source Page List property only for those customers that are "preferred" customers, click the button and specify a when condition rule named IsPreferred.
Example
Append and Map to pyWorkPage
Relationship settings
a new page — The default. Use when you want to create a new page in the target Page List, and subsequently create properties on that page.an existing page — Use when you want to create a new page in the target Page List, and subsequently create properties on that page that are to be mapped from a source page.each page in — Use when you want to create a new page in the target Page List, and subsequently create properties on that page that are to be mapped from a source Page List or Page Group.
Supported features
You can use the following items in the Append and Map to action:
- In the Target, Page List mode properties
- In the Source, Page, Page List, and Page Group mode properties
- Conditionalizing the Append and Map to action, when the Source is a Page List or a Page Group (using the button).
Restrictions
You cannot specify a Page Group mode property as the target for the Append and Map to action. That is, you cannot append to a Page Group mode property using this action.
About Data Transforms
Open topic with navigation