Skip to main content

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

Page-Remove method

Updated on August 10, 2022

Use this method to delete one or more pages from the clipboard. The contents of the database are not affected.

As a sound development practice, design your activities or processing cycle to remove clipboard pages after they are no longer needed. A large clipboard can affect system performance. You can use the Performance tool to monitor the size (in bytes) of the clipboard.

To remove all User pages, create a Java step containing these two lines:

PRThread thread = tools.getThread();

You can use an activity to remove all user pages, either when developing or at appropriate points in an application.


This method uses the page (if any) in the Step Page field plus an optional array of page names.

PageOptional. Enter the name of a top-level or embedded clipboard page to delete.


If the Step Page field is not blank, the page identified in that field is deleted. (You can't delete the primary page of the activity.)

In addition, the method finds each page (top-level or embedded) identified in the array and deletes the page.

If a page you specified is not found on the clipboard, the Page-Remove method reports a warning error, but does not fail.

This method does not alter the contents of the PegaRULES database.

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us