Data pages

A data page (formerly called a declare page) rule defines the contents of a clipboard page.

The following tabs are available on this form:

Data pages are only created when first accessed and do not persist. They are not saved to the PegaRULES database, and are reconstructed when next accessed and the previous version is expired.

There are three types of data pages:

  • Read-only — Provides a read-only page available to only one Thread, to a Requestor, or to multiple requestors (on one node) in your application.
    • Read-only data pages can be modified only during page load and post-activity processing.
    • Read-only data pages are displayed in the Data Page list on the clipboard.
  • Editable — Provides the initial contents of a page that can be accessed in normal read-write mode.
    • Editable data pages do not have a refresh strategy and cannot be node-level in scope.
    • Editable data pages are displayed in the User Page list on the clipboard.
  • Savable — Provides the data page with a save plan through a database source or an activity so users can update data and write to a system of record.
    • Only savable data pages are referencable in save data page locations.

Where referenced

Almost all rule types can reference data page rules and provide values for the properties on such pages because they do not explicitly reference the rule.

When a requestor accesses a data page, the data page creates a new instance of itself on the clipboard. Each data page and each instance of it on the clipboard have a name that starts with Declare_ or D_.

Rules of any type that can reference properties on pages other than the current or primary page, including activities, decisions, and parse rules, can reference properties on data pages in a read-only context. When a non-existent property is referenced, the data page creates the property in read-only mode.

Access

Use the Data Explorer to list all data pages that are available to your application.

Category

Data pages are instances of the Rule-Declare-Pages class and are part of the Data Model category.