Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Tracking changes to a Page List property

Updated on March 15, 2022

Pega Platform auditing can be extended to other properties such as a Page List property.

Before you begin: Create a Declare Trigger rule named TrackSecurityChanges for the class you want to audit; for example Data-Admin-Operator-AccessGroup.
  1. Open the rule form that contains the field you want to include in the history memo.
    You can quickly determine the property and type underlying the Portal Layout field by clicking the Rule Data button on the toolbar to open the form’s XML.
  2. Override the pyTrackSecurityChanges model for Data-Admin-Operator-AccessGroup and add a new row.
  3. In the Property field, enter .pyUserPortals(1).pyPortalLayout. Leave the Value field blank as the field value from the property list will be displayed in the memo.
  4. Save the Model form.
  5. Because aggregate properties record Add and Remove actions, you must create two field value rules to associate the type of update with the field (which is noted in the memo): TrackSecurityChange_Add and TrackSecurityChange_Remove.
    1. In the Developer portal, click the New rule icon to create a new Field Value rule and enter the following values:
      • The class Embed-PortalLayout in the Applies To field
      • pyPortalLayout in the Field Name field
      • TrackSecurityChange_Add in the Field Value field (do not modify this value)
      • Any meaningful Short Description
      • The RuleSet for your application
    2. Click Create.
    3. In the Localized Label field, enter the text you want to see in the history memo followed by the property name in brackets ({}).
    4. Save the rule.
    5. Copy the rule (Save As) and use a Field Value of TrackSecurityChange_Remove.
    6. Modify the Short Description appropriately.
    7. In the Localized Label field, change Added to Removed.
    8. Click Save.
What to do next:

Test the modifications by opening an instance of Data-Admin-Operator-AccessGroup and changing one or more values in the Secondary Portal Layouts section. Then click the History Details button (on the History tab) to review the history.

  • Previous topic Extending the security auditing feature to record changes to additional properties
  • Next topic Tracking changes to a Single Value property

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us