The IAuditDefinition type exposes the following members.
Properties
Type | Name | Description |
---|---|---|
![]() | AuditFailure |
A boolean value that indicates whether auditing for failed event operations
is enabled (true) or not (false). Currently, auditable failures are limited to
an access-denied result of an operation.
NOTE If all audit definitions for a class specify that neither failed nor successful operations should be logged, then auditing for the class is effectively disabled. |
![]() | AuditSuccess |
A boolean value that indicates whether auditing for successful event operations
is enabled (true) or not (false).
NOTE If all audit definitions for a class specify that neither failed nor successful operations should be logged, then auditing for the class is effectively disabled. |
![]() | ClassDescription |
The ClassDescription object containing the property metadata for the EngineObject.
(Inherited from IEngineObject.) |
![]() | DisplayName |
The user-readable, provider-specific name of an object. This property is usually the designated Name property of the object's class.
For ICmAuditProcessingBookmark and IAuditDefinition objects, this property is intended to identify client applications that process the audit log. For ICmAuditProcessingBookmark objects, this property, in support of the audit disposition feature, identifies the client that created the object. For IAuditDefinition objects, this property identifies a set of audit definitions for a given client or client functionality. For ICmAuditProcessingBookmark and IAuditDefinition objects, it is recommended that you set this property. Specify a unique value to distinguish one client application from another. Note, however, that the server does not prevent identical display names across multiple ICmAuditProcessingBookmark or IAuditDefinition objects. Therefore, the client application is responsible for enforcing uniqueness. |
![]() | EventClass |
The class definition of the event that's being subscribed to or audited.
|
![]() | FilteredPropertyId |
The symbolic name of a singleton, object-valued property defined on the source object for use in evaluation by the
filter expression. (The filter expression is defined by the FilterExpression property.)
For example, an event on a IReferentialContainmentRelationship can specify Head in the FilterPropertyId
property to have the containable object -- rather than the IReferentialContainmentRelationship -- used for filtering.
The use of a filter expression is optional. If FilteredPropertyId is null, the source object itself is evaluated by the filter expression. NOTE For IPublishRequestEvent, apply the filter expression on the InputDocument property of the IPublishRequest object, not on an object-valued property of the source object being published. When you publish a document, a IPublishRequest object is created, which, at runtime, is the source object on which IPublishRequestEvent is triggered. |
![]() | FilterExpression |
The text of a filter expression that, when evaluated, determines the action to be taken on the object.
This property applies to IStoragePolicy, ISubscription, IAuditDefinition,
ICmSweepPolicy, and ICmSweepJob objects.
For a IStoragePolicy object, FilterExpression is used as the selection criteria for determining into which storage area the content for a document or annotation should be stored. The expression is evaluated against all storage areas to determine which ones are deemed "equivalent" in terms of this storage policy. For more information, see Storage policies. For a ISubscription-based object, FilterExpression is used to determine whether the event action should be launched. For IAuditDefinition, FilterExpression is used to determine whether an event should be audited. The filter is applied to either the source object, or optionally, to the object specified in the FilteredPropertyId property of ISubscription or IAuditDefinition. Note that for version series subscriptions, the filter is applied to the document version in the transaction and not to the version series. For ISubscription, the Content Engine server evaluates the filter expression, as follows:
For a sweep job or sweep policy, FilterExpression is used to evaluate each instance of of the sweep-target class. If the value of the expression evaluates to true, an operation is applied to the instance. The operation performed depends on the type of sweep. For IAuditDefinition objects, FilterExpression is only applicable to events of type IObjectChangeEvent. If the value of the expression evaluates to true, the event is audited; otherwise, it is not audited. The syntax of this property must be a fragment of a SQL where-clause expression (for example, VersionStatus = 1) and use supported operators. See SQL Syntax Reference. Note that some operators that are valid in an ad hoc SQL query are not supported in FilterExpression. The following operators are not supported.
Note that a filter expression can include conditions expressed against non-queryable and non-persistent properties. For example, the following is a valid expression: Owner='jsmith' For ISubscription and IAuditDefinition objects only, you can use the IsModified predicate, for filtering events based on modified properties of the source object. A filter expression using the IsModified predicate must be constructed as follows: IsModified(property), where property can be in any form supported elsewhere in the query, for example, table_alias.property_alias. Note that the IsModified predicate can only be used in a filter expression. It cannot be used in an ad hoc SQL query. |
![]() | Id |
A representation of the Globally Unique Identifier (GUID), a unique 128-bit number, that is assigned to this Content Engine object when the object is created.
When converted to a string, the Id property is typically depicted as 32 hexadecimal characters enclosed by brackets in the following
format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}. For example, {3F2504E0-4F89-11D3-9A0C-0305E82C3301}.
For IUser and IGroup classes, the Id property takes the value of the Security Identifier (SID) rather than the 128-bit GUID. The string representation of the SID is in this example format: S-1-5-21-1559522492-2815155736-3711640725-55269. When Active Directory is used as the directory service for IBM FileNet P8, IUser.Id and IGroup.Id always return the current SID for the principal, even if this user or group has only historical SIDs populating the Active Directory server. For a given property representation, the Id property has the following characteristics:
For a newly created document object, you can override the Id property of its associated VersionSeries object before you save or check in the document for the first time. |
![]() | IncludeSubclassesRequested |
Indicates whether the operation should apply to the subclasses of the class.
For a ClassSubscription object, this property indicates whether the subscription should also apply to the subclasses of the target class.
For an AuditDefinition object, this property indicates whether auditing should also apply to the subclasses of the class
configured for auditing.
|
![]() | IsEnabled |
Indicates whether a given object is enabled or disabled. For example, you can globally disable or enable active
events by setting an IEventAction object's IsEnabled property to False (off) or True (on).
Likewise, you can enable or disable a subscription, a security template, an audit definition, an audit disposition policy,
a change preprocessor definition, a change preprocessor action, and a sweep The property defaults to true.
Enabling a security template indicates that it can be applied to an object. A disabled security template remains part of its security policy container, but cannot be applied to an object. Disabling a security template is useful when you are testing or developing the security templates that make up a security policy. Disabling a subscription prevents the function associated with the event from being loaded and executed. You might want to disable a subscription that is undergoing modifications due to a change in business processes or when you do not want functions to execute against federated documents. Note that when you disable an IEventAction, all of its associated subscriptions are also disabled. However, when you disable one particular ISubscription, you only disable events that are in its subscribed event list. Disabling a change preprocessor action has system scope, that is, it prevents code handler execution for all class definitions that reference the change preprocessor action. On the other hand, disabling a change preprocessor definition has class scope; it prevents code handler execution for only that class definition, and for any subclass definitions to which the changed property value is propagated. |
![]() | ObjectStateRecordingLevel |
Specifies the audit recording level of the source object for an event of type ObjectChangeEvent.
(The source object is the object on which the event is fired.)
The recording levels are ORIGINAL_AND_MODIFIED_OBJECTS (both the original, pre-event object and the modified,
post-event object are recorded), MODIFIED_OBJECT (only the modified, post-event object is recorded),
and NONE (no source objects are recorded).
If MODIFIED_OBJECT is set, the event's OriginalObject property will be null.
If NONE is specified, the event's OriginalObject and SourceObject properties will be null, and the event's
ModifiedProperties property will be empty.
NOTE Persisting audited source objects in a database can result in substantial consumption of large object (LOB) storage. |
![]() | Properties |
The IProperties collection of properties for the EngineObject.
(Inherited from IEngineObject.) |