PGP Option Map

PGP Option Map

Description	Driving UI with Local Data
Version as of	8.5
Application	Platform
Capability/Industry Area	Public Sector

PGP Option Map feature

The PGP Option Map is a pattern for supplying customizable, configurable data collections to Pega Picker user interface selection controls like pxAutoComplete and pxDropdown (drop-down list). The following are the benefits of this pattern:

• Instances can be managed from App Studio using the Data Type Record Editor in support of the low-code/no-code developer.
• Value display order can be explicitly controlled (not just alphabetical).
• The solution scales from a few instances to thousands of instances.
• The solution is localizable.
• The data instances are supplied by a parameterized data page can be used as a source in many data driven use cases.
• The data page is loaded by a data transform that may be customized in an implementation layer.

Architecture

The Option Map consists of three basic elements.

• A Pega local data type that holds the collections of name-value pairs grouped by field name group.
• An interface to manage the OptionMap data instances.
• A data page to retrieve collections of name-value pairs based on parameters.

Data Type Definition

PegaPS-Data-Config-OptionMap Data Type

Label	Property	Description
ID	.pyID	Unique Instance ID
Display Value	.pyLabel	Display Name
Code	.Code	Value
Display Order	.DisplayOrder	Integer index
Field Name / Group	.Purpose	Field Group (Category)

Option Map Data Management

The OptionMap data type is created under Pega's local Data Type Wizard and can fully leverage the App Studio Data Designer for instance management and record editing.

D_OptionMapList Data Page

The D_OptionMapList is a Requestor scoped data page that takes two parameters.

• FieldName (required) which supplies the label common to a collection of OptionMap instances.
• Code (optional) which may be provided in special circumstances to retrieve a specific OptionMap instance.

LoadOptionMapList Data Transform

The D_OptionMapList data page is populated by the LoadOptionMapList data transform which may be superseded or overridden in an implementation layer should detailed control of the list be required..

Using OptionMap Data in a Picker control

The OptionMap data can be utilized in a Pega UI picker control by configuring the List source to call the D_OptionMapList data page passing parameters to identify the field name/group that identifies the collection instances to be loaded.

A chart type that displays geographical data distributed by categories, regions, or entities on the map. For example, you can show sales activity by state, by country, or by continent, depending on the map that you select and the data that is available in the report. On the Maps tab of the Reporting Settings landing page, you can set default mappings between specific maps and the properties of specific classes.

Information that is captured during the life cycle of a case.

A business solution that automates workflows in your organization. Multiple, unrelated applications can be hosted in the same system. You create an application by running the New Application wizard.

A capability that you implement in your application. By defining features that are linked to rules and work items, you can improve the traceability of capabilities to their respective implementations.

The low-code development environment of Pega Platform.

A characteristic that defines and holds data for your application. For example, the Customer data type might be used to manage customer contact information. It might include the customer's name, email, phone number, and so on. Data types are managed using the Data Explorer.

A tool for adding, editing, and deleting data type records. You can access the record editor on the Records tab of a data type in the Data Designer.

Within Pega Robot Studio, solutions and projects are containers for all the items required to build and run a project. Solutions can include multiple projects. Once you deploy a solution to the Pega Robotic Automation Deployment Portal, it is known as a package.

An entity that you use to cache data on demand to a clipboard page for use by one or more applications. A data page rule defines the source, scope, refresh strategy, editability, and structure of the cached data. Data pages were previously known as declare pages.

A layer that contains application elements that are specialized for a specific business audience or purpose. The contents of the implementation layer extend the elements of the framework to create a composite application that targets a specific organization or division.

A characteristic that defines and holds data for your application. For example, the Customer data type might be used to manage customer contact information. It might include the customer's name, email, phone number, and so on. Data types are managed using the Data Explorer.

An entity that models data in your business processes and defines what information you need to provide to reach your business goal. For example, in a process of hiring new employees, you can create properties that correspond to the personal details of a candidate, such as a name, a surname, and an address. Then, when you review applications from different candidates, you provide values specific to each candidate. To save time and make your application more relevant to customers, you can reference properties in different elements of your application, and then populate them with data at run time. For example, you can include a property that references a customer name in an email that your application sends automatically. As a result, each time that the email message is personalized and includes an actual customer name. Properties help you collect and provide consistent data irrespectively of the method in which users interact with your application. By referencing properties, you ensure that a user receives the same information through a website, an email, or a mobile app.

A durable, potentially permanent, saved representation of a concrete class that is stored in the database. An instance corresponds to a row in the relational database, or to a record. An instance consists of properties and values, and some of these property values form a unique key to the instance.

A value that identifies one element (or member) of an aggregate data structure. These indexes are sometimes called subscripts. In addition, an index is a PegaRULES database feature that provides faster access and improved database performance. Use Declare Index rules to add and delete index objects.

A view that you can use to review and manage data types in your application. When you select a data type in the Data Explorer, the data type opens in the Data Designer.

A durable, potentially permanent, saved representation of a concrete class that is stored in the database. An instance corresponds to a row in the relational database, or to a record. An instance consists of properties and values, and some of these property values form a unique key to the instance.

An entity that you use to cache data on demand to a clipboard page for use by one or more applications. A data page rule defines the source, scope, refresh strategy, editability, and structure of the cached data. Data pages were previously known as declare pages.

An ordered sequence of rules to run. In each step of a collection, you can define a precondition that is evaluated before execution, and a response action that runs after the step is completed.