The Data Designer lets you 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.
Control buttons appear at the top right of the Data Designer:
At the top of the tab is the Description of this data type. Click edit to update the description in a popup form, then submit the form to save your changes.
In the composition grid you can review and manage the properties that are part of the data type.
If the list is long, you can enter all or part of the name of the property in which you are interested in the Search field and click the magnifying glass to search for properties that match what you have entered.
For each property you can review its
- Name - the property's pyLabel.
- Identifier - The property unique key value, pyPropertyName, used to reference it in rules.
- Property type - Single value, page, page list, and so on.
- Data type - the type of data the property contains:
- Text, Integer, DateTime, and similar types - hold scalar and value list properties.
- Page class - contains page and page list properties.
- None - for advanced properties such as Java objects and Java lists.
Click the New link beside the field to create a new data type.
- Data Access - summarizes the data access information for the property:
- For single-value properties, Manual or Linked. This value cannot be configured here.
- For page or page list properties, Manual, Refer to a data page, or Copy data from a data page. This value can be configured here.
Add properties to the list by clicking the "Add property" link below the display.
If you change your mind, you can delete a property by clicking the x icon at the right of its row.
Note: This action only deletes the property if, as with an entry you just made, there is only a single instance of the property in the system. If the property has multiple versions, the delete action only removes the latest version. At runtime the system continues to use rule resolution to find earlier versions of the property. This function is primarily for properties you add to the grid, and then decide to remove in the same session because you do not need them after all.
On this tab you can review (but not edit) the pages and properties that use this data type. Click a column header to sort the grid in which it appears by the contents of that column. Click the header again to reverse the sort order.
Most columns in tables have a small triangle to the right of the column name. Click the triangle to display a filter form. Use the form to filter the contents of the table to include only elements whose values for the column match the filter you have set. Click "Clear filter" in the form to remove existing filters.
For each data page, the table displays:
For each property that references the data type from a specific scope, the table displays:
The system created undefined pages during processing, often when processing activities or data transforms. Refactor these pages to use data pages to enhance maintainability, reuse, and guardrail compliance,
For each undefined page, the table displays:
If you have not created a local source for the data type, the tab provides a link; click the link to create a local source with the Local Data Storage wizard.
Note: After you have used the wizard you may see on this page a warning that the system could not generate a dedicated database table for this data type. Click the link provided to display the Fix Database Table Generation form. On the form you can download a SQL script you can give to your DBA. Your DBA can run the script against the Pega 7 database to create the dedicated table. When that is complete, return to the form and click Verify to verify that the table exists.
The form displays existing data sources, displaying for each:
The Test cases tab displays all of the test cases for the data type. The Test Cases tab displays the following information for each test case.
Field |
Description |
Name |
The identifier for the test. |
Created By | The identity of the test's originator. |
Last Run | The date and time the test case was last run. |
Run/Expected time | The run/expected time displays the actual run time of the rule under test (data page) and the expected time of the rule under test (Data page). |
Select the check box next to one or more test cases and click the Run selected button to execute those test cases.
Click the Add new button to create a new test case. You need to indicate which data page you want to associate the test with when adding a test case on the data type detail.
If you have not configured a source for use with the record editor, the tab provides a link you can click to configure the source with the Local Data Storage wizard. Note: Data records cannot be configured for cases.
Note: see the note about the Sources tab about a warning message you may see here.
Data sources identified on the Sources tab appear in the Sources field at the top of this tab. Select a source to display information about its records in the section below. If you choose a source that is not yet configured for local data storage, the system helps your configure the source.
In the lower section are controls that let you:
Click the + icon below the table to add records using the Record Editor. Columns marked with an asterisk * are required. Remove the record by clicking the X at the right of the row. Click away from the record to save your changes.
On this tab you can change the context for new and updated rules, and review the current database settings.
Set the context for new rules related to this data type:
Set the context for updating rules related to this data type. Select either:
This section lists the current database information for this data type: