Skip to main content

The extension point for field-level auditing

Suggest edit
Updated on March 29, 2022

You can override the extension point for field-level auditing to facilitate reporting. For example, you can include the index keys of the audited properties in the audit table.

The extension point that you can use for field-level auditing in Pega Platform version 8.4 and later is the pySave activity from the FLAudit- class.

To learn how you can benefit from modifying the extension point for field-level auditing, see the following article with a sample use case:

Displaying the index keys of properties in the field-level auditing layout

Increase the readability of the field-level auditing layout by adding a column that displays the index keys of your audited properties of the Page List and Page Group types. When you expose the index column inside the section that is displayed for a property of the Page List and Page Group type, you can differentiate between the list items more conveniently.

  1. Create and configure a property to represent the key of audited properties:
    1. Create a property with the IndexKey name and of the Text date type in the FLAudit- class in any of the application rulesets.
    2. On the new property form, in the Additional configuration options section, select the Optimize for reporting and Optimize for reporting on descendant classes checkboxes.
    For more information, see Optimizing properties from the user interface and the Optimizing properties for report performance challenge on Pega Academy.
  2. Override an extension activity to set the IndexKey property:
    1. Expand the Technical category, and then click Activity.
    2. Find and open the pySave activity from the FLAudit- class.
    3. On the activity form, click Save As.
    4. On the new activity form, in the Apply to (class) field, select the class that you created for the case type in the FLAudit- class.
    5. In the Add to ruleset field, select the application ruleset that contains the selected class.
    6. Click Create and open.
    7. On the Steps tab, in the Method field, select a method, and then click Expand to see method parameters.
      The activity references Param.ContextPage as the work page and the FLA record as the step page.
    8. Click Save.
  3. Override a report definition that derives records from the FLAudit table:
    1. Expand the Reports category, and then click Report Definition.
    2. Find and open the pyGetRecordsByContext report definition from the FLAudit- class.
    3. On the report definition form, click Save As.
    4. On the new report definition form, in the Apply to (class) field, select the class that you created for the case type in the FLAudit- class.
    5. In the Add to ruleset field, select the application ruleset that contains the selected class.
    6. Click Create and open.
    7. On the Query tab, click Add column, and then in the Column source field, enter .IndexKey.
    8. Click Save.
  4. Include the new property in the table section that displays the FLA records:
    1. Expand the User Interface category, and then click Section.
    2. Find and open the pyFieldGroupHistory section from the @baseclass class.
    3. On the section form, click Save As.
    4. On the new section form, in the Apply to (class) field, select the class that you created for the case type in the FLAudit- class.
    5. In the Add to ruleset field, select the application ruleset that contains the selected class.
    6. Click Create and open.
    7. On the Design tab, in the table area, click a table column, and then click Insert column after selected or Insert column before selected.
    8. Next to the new column's label area, click View properties, and then, in the Cell properties pane, in the Value field, provide the name for the column. For example, enter key.
    9. Click Submit.
    10. Next to the new column's field area, click View properties, and then, in the Cell properties pane, in the Property field, enter .IndexKey.
    11. Click Submit.
Result: The new property can be exposed and captured as part of field-level auditing. In the presented example, the screen captures the IndexKey value and displays the value in the field-level auditing table.
  • Previous topic Packaging rules and data that contain field-level auditing information
  • Next topic Sharing data between parent and child cases
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us