Page-Merge-Into method
Use the Page-Merge-Into method to merge the contents of two or more pages into one page. Specify the source pages in the MergeFromList parameter.
Parameters
The Page-Merge-Into method accepts a list of source pages and one base parameter.
| Parameter | Description |
| MergeFromList |
List one or more page names to merge into the step page. Order is significant,
because the pages are processed in the sequence that you specify here. Don't include
the step page (the destination) as one of the source pages.
Identify one or more single pages for this parameter. You can reference a Page List property but you must include an explicit index value. |
| Keep |
Optional. The parameter controls the merge operation. Specify how properties
and values are copied from the source pages into the destination page, by entering
one of the following values:
|
Results
The system finds the destination page named in the Step page column in the activity step that calls this method. If not found, it creates a new page with this name.
If any of the pages that are specified in the MergeFromList parameter are not found, the merge process ignores them.
It copies properties and values from the source pages into the destination page, retaining or overwriting property values in the destination page according to the value of the Keep parameter.
It processes the source pages in the sequence that you entered them in the parameter array. As it copies a property and value, the system validates the value against the property definition (the Rule-Obj-Property rule) and marks any property that has an error. It updates the pxErrorList property with error messages.
Source pages are unaltered.
Checking the method status
This method updates the pxMethodStatus property. For more information, see How to test method results using a transition.
Restrictions
This method cannot be used in a step that involves iteration.
Previous topic Page-Copy method Next topic Page-New method