Applications Administration Guide > Audit Trail >

Configuring Audit Trail in Siebel Tools

The Audit Trail functionality is not enabled in the preconfigured application. By enabling the Audit Trail business service with Siebel Tools, Audit Trail becomes available to application objects. You can turn off the Audit Trail for individual applications by deactivating the Audit Trail application event service for the application.

For workflows, the Audit Trail function will not work unless the Start Method of the Audit Trail Engine Business Service is included as a first step in the workflow process. For more information, see About the Audit Trail Engine Business Service.

NOTE:  Audit Trail does not create history records for predefault values; predefault values are assumed to be part of the initial record. If, however, the default values are changed at a later date and those fields are set to be audited, then both the original and changed values are recorded.

Enabling the Audit Trail Engine Business Service

This task is a step in Process of Configuring and Using Audit Trail.

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.

Disabling Audit Trail for an Application

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, deactivate 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

Configuring an Application for Audit Trail

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, create 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.