Discussion
Pegasystems Inc.
US
Last activity: 20 May 2024 8:11 EDT
How to enable field-level auditing for a Constellation based application
Important Note: Field-level auditing is included automatically in 24.1 or higher and these changes described below are no longer needed - see one of the reply below for more details: FLA support in 24.1 - see Field-level auditing in Constellation and documentation update: Enabling field-level auditing.
Field-level auditing is an important feature of a typical workflow application - Field-level auditing is done in the case management layer and records any changes applied to a certain set of properties.
For more details on field-level auditing https://docs.pega.com/bundle/platform-88/page/platform/case-management/enabling-field-level-auditing.html
This functionality is available for Traditional UI on Theme Cosmos or UI-Kit and uses a drill down approach to view the embedded data properties that have changed - While the UI is intuitive to use, it does not offer the ability to easily group and filter by property name when you have a lot of embedded data.
The document showcases how to add similar functionality on a Pega 8.8 application running on Constellation UI. The RAP attached to this document contains a ruleset FLA-Audit:01-01 that will provide a data page called D_FieldHistory to get the field-level changes and 2 views (FLAList and FLATimeline) to use in your case view.
The ruleset also contains 7 properties set as relevant record at the FLAudit- class
For more details on how the functionality works in Theme-Cosmos and how to enable it in Constellation UI - you can watch the embedded video
Here is a screenshot of the functionality in Constellation UI
Note: In the video - the table is refreshed using a browser refresh but it is possible to provide a 'click to refresh' action that will let the user know that the data are outdated and the list view needs to be refreshed - to enable this functionality - you need to call the activity 'pxC11NPublishDatapageUpdate' in the FLAudit-.Save activity.
For more details on how to notify users to refresh an outdated List View in Constellation UI - https://support.pega.com/discussion/how-notify-users-refresh-outdated-list-view-constellation-ui
History:
- 1.0 - 9/2023 - Initial version of the functionality
- 1.1 - 1/3/2024 - Fix bug with embedded page - condition on step 9.2 of the GetFieldGroupHistory has a typo on the condition for page
- 1.2 - 2/15/2024 - Updated the zip file RAP to also include the 7 relevant record properties needed at FLAudit-