Skip to main content

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

More about data page rules

Updated on April 6, 2022

Benefits of using data pages

Data page removal

Note: You can use Page-Remove for node-level, requestor-level, and thread-level data pages. However, you cannot use the Clipboard tool to remove data pages.

A data page with a Node scope is removed when the Pega Platform is shut down for that node or when the rule is deleted.

A data page with a Thread scope is removed when the requestor of that Thread logs out.

Data pages with a specific name are removed when you save a data page rule form that has a key ( Page Name field) with a matching name.

Supporting Global Resource settings

Use a data page rule to hold global resource settings. These allow service rules and connector rules to be identical in multiple Pega Platform instances, such as a test system and a production system, while still using different ports, URLs, and servers.

Data pages and clipboard pages

Data pages (known as declare pages in versions prior to PRPC 7.1) have many similarities with other clipboard pages. They are accessed the same way, so it is not necessary to write a Java step to access the data on a data page. Data pages also contain the same kinds of data as regular page: properties, embedded pages, and so on.

However, there are important differences between data pages and other clipboard pages.

  • Clipboard location

    • Read-only data pages (all scopes) appear in the data pages (version 7.1) or the declare pages (versions 5.1-6.3 SP2) area of the clipboard and not under user pages or system pages.

    • Editable data pages (thread and requestor scope) appear in user pages.

  • Edit operation – Data pages can be read-only or editable.

    • Read-only mode: You cannot add or remove data after the data pages are created.

    • Editable mode: You can modify the data after the data pages are created.

  • Naming convention – The names of data pages must begin with the string Declare_ (for versions 5.1-6.3 SP1) or either D_ or Declare_ (for version 7.1). Other types of pages cannot begin with these strings.

  • Creation – A data page is automatically created whenever any properties on the page are accessed, if the page does not already exist. You do not have to explicitly create these pages by using the Page-New method or other methods. Data pages with parameters are loaded only when mandatory parameters are provided.

  • Update procedure – Data pages can have an automatic refresh strategy, which ensures that their contents are up-to-date.
  • Database persistence

    • Unlike other pages (such as work item pages), read-only data pages cannot be saved.

    • Editable data pages can be saved.

  • Passivation – When a requestor is passivated, all of that user’s information is serialized and temporarily saved to persistent storage. If this user's clipboard contains any read-only data pages, those pages are not saved. Instead, the system deletes these pages when it passivates the requestor, and then re-creates them whenever they are next referenced by that requestor (after the requestor is reactivated). Editable data pages are saved like normal pages.

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