Applications Administration Guide > Audit Trail >

Configuring Audit Trail in Siebel Tools

In the preconfigured Siebel application, the Audit Trail functionality is disabled. By enabling the Audit Trail business service within Siebel Tools, Audit Trail is enabled for all application objects. However, you can turn off Audit Trail for individual applications by inactivating the Audit Trail application event service for that application's object. For custom application objects, you must add an Audit Trail application event service to the application object in order to use Audit Trail.

NOTE:  Audit Trail does not create history records for predefault values; predefault values are assumed to be part of the initial record.

To enable the Audit Trail Engine business service

  1. Launch Siebel Tools.
  2. In the Object Explorer, select the Business Service object, and then select the Business Service User Prop object.
  3. Select Audit Trail Engine in the Business Services object list.
  4. Configure the Business Service User Properties to use the following values:
    Name Field
    Value Field
    Description
    Audit Source
    TABLE
    Can be TABLE or FILE. Signifies the database or file auditing mode in which you are going to run Audit Trail.
    Cache Entries Size
    1
    The number of records to cache before writing the audit trail records for the selected mode. For example, if this field is set to 10 and Audit Source is running in FILE mode, then after the user makes 10 audited changes for a particular business component, the Audit Trail engine creates one file in the Siebel file system. When running in TABLE mode, you should use the default value of 1 because there is no performance gain from increasing this value.
    Enable
    TRUE
    Can be TRUE or FALSE. Determines the current state of the Audit Trail.

    NOTE:  Audit Trail data is cached by the business service and only written out when the number of Audit Trail changes exceeds the specified cache size. You can also flush cached entries by logging out of the current session and then logging back in to check the Audit Trail data.

To disable Audit Trail for an application

  1. Launch Siebel Tools.
  2. In the Object Explorer, double-click the Application object to expand it and select Application Event Services.
  3. In the Application Event Services list, inactivate the Audit Trail Engine business service record. (Look for a record with the following values.)
    Name Field
    Value Field
    Business Service
    Audit Trail Engine
    Event Name
    Start
    Method Name
    Start

Use the following procedure to enable a customized application object for auditing, or to re-enable an application object that has been turned off.

To configure an application for Audit Trail

  1. Launch Siebel Tools.
  2. In the Object Explorer, double-click the Application object to expand it and select Application Event Services.
  3. In the Application Event Services list, add the following record if it does not already exist.
    Name Field
    Value Field
    Business Service
    Audit Trail Engine
    Event Name
    Start
    Method Name
    Start
    Name
    Start
    Sequence
    1 or the next available sequence number

About Using Audit Trail with Object Interfaces

When accessing an Application Object Manager through object interfaces such as COM Data Control and Java Data Bean, Audit Trail is not started automatically. In these cases, you must invoke the Audit Trail Engine business service explicitly.


 Applications Administration Guide
 Published: 09 September 2004