Page-Change-Class method
Use this method to change the class of the top-level page or embedded page identified in the Step Page column. (To change the class of an embedded page, see How to Change the Class of a Page.)
Before changing the class of a page, be sure that all properties referenced on the page are also defined in the target class (the destination class).
Parameters
This method has three parameters:
Parameter | Description | ||||||||
ObjClassNew | Identify the target or destination class of the page. | ||||||||
Data Transform | Optional. Identify a data transform (in the target class or a superclass of that class) to apply to the page. | ||||||||
Keep |
Optional. Enter 0, 1 or 2 to control the how properties are added to the page.
If not specified, 0 is the default.
|
Results
The system creates a new page of the target class identified in the ObjClassNew parameter.
If a data transform is specified in the Data Transform parameter, the system uses rule resolution to find the rule, and uses it as described above.
The system copies properties from the existing step page to the new page, in accord with the Keep parameter.
The previous step page (with the previous class) is destroyed.
This method does not validate property values. The page name is unaltered. This method does update the pxMethodStatus property. See How to test method results using a transition.
Restrictions
This method cannot be used in a step that involves iteration.
Previous topic Obj-Validate method Next topic Page-Clear-Messages method