Data pages overview
Use data pages to bridge the connection between your application and the integration and to give your application the data the way the application expects to receive it.
Data pages define the data associated with a data object and contain the data object's connection configuration to a system of record, separating your application from the integration with the system of record. Because of this separation, your application can easily adapt to integration changes and access data from a range of sources on demand. With data pages, you can connect a data page of one object type to a data source of another, incompatible type, enabling data virtualization.
Benefits of using data pages
Data pages can improve performance and reduce memory requirements when many requestors in an application need to access the same information. For example, a data page can hold last night's closing U.S. stock prices in a Value Group property indexed by ticker symbol, so that the property reference D_Stock.Price("IBM") is the closing price for IBM shares. The first time each evening (after the 4:00 P.M. New York stock market close) that a requestor attempts to access the page, Pega Platform automatically loads the page with the latest end-of-day prices. The page can remain unmodified in memory until the next day's closing.
Data pages create only as many instances as requested. When you reference a data page by using parameters, the data page creates a unique instance of itself for each unique reference, which is identified by a parameter value. For example, a single data page, D_Customer, can create as many instances of itself on the clipboard as your application requires. Each instance has exactly and only the information about one particular customer.
Data pages refresh the data only when required. Pega Platform automatically checks the data page contents (by using a when condition rule) before each property access to see whether a fresh recomputation is needed. For example, a page might list the part numbers or SKU numbers of items that are out of stock, extracted from an inventory control system. Recomputation is needed only when an out of stock condition begins or ends, not each time the inventory changes.
Data page configuration options
In App Studio you can view a list of data pages associated with a data object, replace or update the source used by a data page, and configure its environment settings.
Data pages can be simulated, production ready, or not simulated and not production ready if the data page references a source that does not have settings that are configured for production. Simulated data pages do not have a data source associated with them. You must configure the data source before the data page is ready for production.
In addition, you can work with savable data pages in App Studio and use them to update other data in your cases. Some of the advantages of saving data pages directly in App Studio include the following capabilities:
- Ability to configure a save plan from App Studio.
- Ability to list savable data relationship in a collect information step.
- Data page definition
A data page defines the contents of a clipboard page and enables the system to access data from a range of sources on demand. Learn about the components of a data page that you can define depending on your business requirements.
- Differences between data pages and clipboard pages
Data pages 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 a regular page, such as properties and embedded pages.
- Creating a data page
To enable your system to access data from a range of sources on demand, create a data page. Data pages can improve performance and reduce memory requirements when many requestors in an application need to access the same information. For example, a data page can hold last night's closing US stock prices in a Value Group property that is indexed by a ticker symbol, so that the property reference D_Stock.Price("IBM") is the closing price for IBM shares. The first time each evening (after the 4:00 P.M. New York stock market close) that a
- Editing data pages
Reflect your individual business needs and requirements by editing your data pages. You can create a refresh strategy, update data sources, or allow an API to query the data page.
- Using data pages
Pega Platform provides various ways in which you can use data pages. For example, use an API to query a data page to build a custom UI or display a read-only list of job openings available in a job posting case.
- Savable data pages
A savable data page is an editable data page that can perform additional operations to typical editable data pages, such as persisting data and attended robotic automation. Use a savable data page to save data to a system of record without using an activity.
- Ensuring seamless upgrades of data pages
After upgrading your application to the latest version of Pega Platform, you might need to make changes to existing data pages. To ensure that data pages behave as expected after an upgrade, Pega Platform restricts you from making changes to a data page that are not backwards compatible with the previous version of the data page.
- Troubleshooting data pages
To troubleshoot problems with data pages, review the following scenarios and suggested solutions.
Previous topic Changing the storage destination for the import data wizard, BIX, and file listeners Next topic Data page definition