Auditing Process Data

By default, process data does not appear in the audit trail (that is, in Audit) for a process instance. You can configure a process so that certain data fields appear in the audit trail.

This capability makes use of the process data to work item attributes mapping facility. For example, if a work list facade has been defined, and display labels were assigned to Attributes 3 and 8, the labels would be shown in Audit rather than "Attribute3" and "Attribute8".

Note: Audit displays audit entries across all processes on the system, and therefore it is usual that specific attributes are used for the same data items across all processes. For example, you might want to consistently use Attribute2 for the value of 'Order Id'. Creating and sharing the same work list facade project across all BPM applications on the system can help to achieve this consistency.

To configure your system to show process data in Audit, you must map process data fields to the desired work item attributes. This mapping process is the same as the process for mapping data fields to work item attributes when creating a work list facade. If you have defined a work list facade, and you map process data fields to attributes for which you have specified a display label in the facade, those custom labels also appear in Audit for the process data entries.

Procedure

  1. Open your process and select it in the Process Editor.
  2. In the Properties view, select the Work Resource tab, then expand Work Item Attribute / Audit Event Data Attribute Mappings.
    This displays all of the data fields defined for the process (in the left column) and all of the work item attributes (in the right column). For example:

    If you have a work list facade defined, the list of attributes in the right column shows the display labels for those attributes that were mapped to data fields in the facade.

  3. Map the data fields that you want to appear in Audit to attributes that are of the same data type. For example:

    As shown in this illustration, data fields can be mapped to multiple attributes, if desired.

    Note that if you map a data field to an attribute of a smaller size, a warning marker is shown that indicates this:

    This may result in data shown in Audit being truncated to the length of the attribute.