The Clipboard tool displays two panels:
To interact with the clipboard:
The left panel presents the entire clipboard for the currently selected Thread as a tree, growing from the left.
Click a name or expand arrow to display any node in the left panel to view the page structure it contains. Click again or click a collapse arrow to hide) the pages within a page.
The clipboard contains three groups of pages:
User Pages
— Top-level pages created by your normal processing, sorted alphabetically by page name. For more information on adding user pages to facilitate testing, see Adding a user page to the clipboard.Data Pages
— Read-only data pages (created if necessary when accessed, defined by data pages rules).Linked Property Pages
— Read-only pages retrieved because a harness, section, flow action or other rule contained a property reference based on a linked property. These pages are read-only, and never updated. They are removed automatically whenever your requestor performs any Commit operation.System Pages
— Top-level created pages created during authentication. These correspond to the organization, division, access group, application rule, and organization unit of the operator. None of the pages are available to guest users. Three single, system-maintained pages are always present and are displayed when you click the Show Advanced link at the bottom of the tree:
pxThread
— Known as the Thread page, it provides the context of clipboard. See pxRequestor
— Known as the requestor page, it contains information about your access roles, RuleSet list, and HTTP protocol parameters.pxProcess
— Known as the process page, it contains information about the server's Java Virtual Machine and operating system.Each top-level page may contain other pages that in turn may contain other pages, and so on. For most pages, the class of the page appears in parentheses after the page name and a single space. (For group and list properties, additional parentheses appear around subscripts.)
Every embedded page is defined by a property. Properties of mode Page
, Page Group
, and Page List
may appear as embedded on the clipboard. Pages may contain properties (of any mode) and messages.
The branch structure of the tree in the left panel directly corresponds to the fully qualified name of a property reference. For example, the property reference:
pyWorkPage.pxFlow(VacationRequest).pyConfirmationNote
identifies a Single Value
property named pyConfirmationNote
embedded on a page named pxFlow("VacationRequest")
, an element of a Page Group
named pxFlow
on the top-level user page named pyWorkPage
.
Square brackets and the term [Refers to ..] indicate a reference property. The text in the square brackets identifies the non-reference page.
Click the Tools menu on the Clipboard header to do the following:
To eliminate unnecessary processing, disable this facility except when you need the additional detail it provides.
You can perform the following right-click commands on a page you select in the tree. Options that update the clipboard are available only to users who have the hold the clipboardViewerUpdate
privilege.
Command |
Description |
Refresh Page |
Select to cause the Clipboard tool to access and redisplay only a single aggregate property and its elements. |
Delete Page |
Select to delete a page. Confirm the deletion in the resulting dialog box. You cannot delete a data page. |
Show XML |
Select to display the page's underlying XML. Use this command to see |
Show JSON | Select to display the page's underlying JSON, which is sent to the mobile client. |
Execute Activity |
Select to test a rule without the need to create a test activity that creates the pages and properties expected as starting conditions for the rule. The selected page becomes the primary page for the activity. An Execute Activity dialog appears and displays the class of the selected page in the Page Class field.
|
When you select a page in the left panel, all Value List
, Value Group
, and Single Value
properties on that page appear in the right panel, sorted by property name. Property messages appear in red text.
Click a property name to open its form in Designer Studio.
Values of TextEncrypted
properties are encrypted. They appear as blank in this display.
The following options are available in the right panel.
Option |
Description |
Refresh |
Click to cause the Clipboard tool to access and redisplay the properties on the current page. |
Edit |
Select to add a single value property to a page, modify an editable property value, or delete an editable property from the page. When you select Edit the following occurs:
When you are finished with your edits, click Save to keep your updates and save the page to the memory, or click Cancel to cancel them. You cannot edit a read-only data page outside of the data page load and post-activity process. |
Add |
To add a single value property to a page, select the Edit option, select a row in the list, and click Add. Enter the property name and value in the Add properties dialog box. You cannot add an embedded property. |
Save |
This option is available when you click Edit. Click Save to save your updated page to the memory. Pega Platformdoes not validate properties on the page. This action can introduce invalid data into the memory. |
Delete |
This option is available when you click Edit. Select a row containing an editable property and click to delete it from the page. |
Discard |
This option is available when you click Edit. Click Discard to cancel your updates. |
Actions |
Click to select the Show XML, Show JSON, or Execute Activity commands as described previously. |
Changing your clipboard contents or structure may affect the integrity of your system or your application results. Change clipboard values with this tool only in a debugging situation. Deleting properties or saving altered pages may introduce invalid data into the memory.
Clipboard page names with errors appear in red text on the left panel. Click the name to view messages associated with properties on this page in the right panel.
A page message is a text clipboard value that is generated by the system and associated with a page. Similarly, a property message is a text clipboard value that is generated by the system and associated with a property. These messages can convey error conditions, progress, or exceptions to a user.
Although messages appear as values on the clipboard, they are not defined through properties. Generally, a clipboard page containing messages cannot be saved, because typically, the message indicates that the page, or a property on it, is invalid. The value of a property might not meet the requirements of a permanent instance of the page's class because of missing or incorrect data.
Property messages are associated with a single property and value. They might indicate that the property value is not valid. Page messages are associated with an entire page.
When a workstation user submits an HTML form, previous page messages corresponding to the input are cleared, and property messages are cleared for any value that changed.
The following items are not visible on the clipboard:
pz
). These standard properties support internal Pega Platform operations. To view these properties you can override the @baseclass.pyShowInternalProperty when rule or right-click in the left panel and select Show XML. Java Object
, Java Object Group
, and Java Object List
.The Application
page contains much, but not all, of the properties that make up the requestor's application rule.