Data Pages

Unlike most pages that are used in Pega Platform, applications attempt to populate the contents of a Data Page only when the page is accessed, rather than through an explicit Action. Due to the on-demand nature of Data Page content, Data Pages are considered a type of declarative Rule. Pega Platform automatically prepends the characters D_ to the name of a Data Page to differentiate the page from other pages in memory.

In the following image, click the + icons to explore how Pega Platform populates the contents of a Data Page:

In Dev Studio, you can create Data Pages. When creating a Data Page, a developer must provide four key pieces of information:

1. The structure of the page contents.
2. The Object Type represented by the contents of the Data Page.
3. The edit mode supported by the page.
4. The scope of the Data Page.

The structure of the page determines whether the Data Page can contain one item or many items. Set the structure of a Data Page by selecting an option from the Structure drop-down list.

When using a list structure, the Data Page embeds the list items in an ordered array named pxResults. To access a specific record within the list, use the syntax DataPageName.pxResults(n), where n is the index of the ordered array that corresponds to the record.

Consider a Data Page that contains pricing information for a single stock. The structure is set to Page. However, if a Data Page contains pricing information for all the stocks in an investment portfolio, you set the structure to List. 

In the center of the following image, slide the vertical line to compare the page and list structures:

The Object Type of the page identifies the information contained by the Data Page. To set the Object Type for a Data Page, enter the class of the object in the Object Type field. The Object Type allows the Data Page to reference any property defined for the class. For example, a Data Page that lists dental insurance plans provided by an insurer contains the plan name, cost, and deductible and a Data Page that lists recent orders placed by a customer contains the order number, order date, total cost, and shipping address as shown in the following figure:

The edit mode of a Data Page indicates how or if an application can manipulate the information on a Data Page. Set the Data Page mode by selecting an option from the Mode drop-down list.

Set the edit mode to Read-Only to prevent an application from updating the Data Page except when loading and updating the contents from the data source. Read-only mode prevents you from editing information sourced from a system of record and ensures that the Data Page content always matches the content loaded from the system of record. For example, when accessing the accident history of an auto insurance customer from the Department of Motor Vehicles (DMV) database, state or national laws may prohibit editing the sourced data. To comply with this legal requirement, set the page mode to Read-Only.

Set the edit mode to Editable to allow an application to edit the Data Page contents. For example, a retailer allows customers to save one or more preferred shipping addresses when placing an order. The list of addresses is loaded from the customer database using a Data Page. To allow a customer to update an address during an order, you set the page mode to Editable.

Set the edit mode to Savable to configure a save plan that allows the application to push the page contents back to the data source. For example, after a customer updates a shipping address, the application copies the updated address to a savable Data Page configured to update the customer database. When the customer completes the order, the application follows the save plan to connect to the customer database.

The scope of a Data Page determines the Visibility of the page contents within the application. To set the page scope, select one of the supported options in the Scope drop-down: Thread, Requestor, or Node.

In the following image, click the + icons to learn more about the scope options and examine how you can leverage scope settings to manage cached data within Pega Platform applications: