The ICmTask type exposes the following members.

ToggleProperties

Type NameDescription
Public propertyActiveMarkings
The list of ActiveMarking objects currently applied to a given object. Each ActiveMarking object represents a marking that is in a MarkingSet associated with a property on the object.
Public propertyAuditedEvents
An EventSet collection of the Event objects containing the audited events that have occurred for the object.
Public propertyClassDescription
The ClassDescription object containing the property metadata for the EngineObject.
(Inherited from IEngineObject.)
Public propertyCmInheritCoordinatorPermissions
Indicates whether permissions should be inherited from the Coordinator property.
Public propertyCmIsMarkedForDeletion
Indicates whether the object is marked (flagged) for deletion. If true, the object is the original object explicitly marked for deletion by a user, or the object is referenced by the original object through an object-valued property (OVP), and, therefore, was marked for deletion by the server.

Objects marked for deletion are represented by a ICmRecoveryItem object, through which the objects can be either recovered or purged (removed from the object store database).

See Recovery Bin Concepts.
Public propertyCoordinator
A reference to the Containable object that is acting as the coordinator for this and other related tasks. To return an enumeration of all related tasks coordinated by the object, call Containable.Coordinator.
Public propertyCreator
Indicates the name of the user assigned as the creator of the object.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is settable only on create. After initial object creation, this property is read-only for all users.

Public propertyDateCompleted
The date and time at which the task changed to the COMPLETE state.
Public propertyDateCreated
Indicates the date and time the object was created. The Content Engine server stores dates and times using Coordinated Universal Time (UTC). For more information, see Timestamps.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is settable only on create. After initial object creation, this property is read-only for all users.

Public propertyDateLastModified
Indicates the date and time the object was last modified. The Content Engine server stores dates and times using Coordinated Universal Time (UTC). For more information, see Timestamps.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is read/write. (The read/write access for those users can only change if a change is made to the ACL on the object store that controls who has privileged write access to objects in that object store).

Public propertyDateStarted
The date and time at which the task transitioned into the WORKING state.
Public propertyExternalReplicaIdentities
Specifies an ExternalIdentityList collection of the read-only ExternalIdentity objects that represent the identities of replicas of this object in external repositories.
(Inherited from IReplicable.)
Public propertyId
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:

  • PropertyDescription.Id is equal to PropertyTemplate.Id, which is equal to PropertyDefinition.PrimaryId.
  • PropertyDefinition.Id is not equal to PropertyDefinition.PrimaryId.
  • PropertyDefinition.Id is not equal to PropertyDescription.Id.

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.

Public propertyLastFailureReason
For IIndexJob and ICmIndexRequest objects, this property identifies the final failure condition for the index job.

For an IReplicationJournalEntry object, this property provides a description of the latest failure condition, if any, for the replication operation that generates this journal entry.

For an ICmThumbnailRequest object, this property states why document thumbnail generation failed.

For an ICmBackgroundSearch object, this property provides a description of the latest failure condition, if any, for the background search operation that generates this journal entry.

For an ICmTask object, this property indicates why the object has been set to the exception state. This property is settable only during the SET_EXCEPTION changeState transaction, for example:

ICmTask.changeState(SET_EXCEPTION);
ICmTask.set_LastFailureReason ( "Required document was not attached to workflow.");
ICmTask.save();

To reset LastFailureReason to a null value, clear the exception: ICmTask.changeState(CLEAR_EXCEPTION).

Public propertyLastModifier
Indicates the name of the user who last modified the object.

Settability of this property is read-only for most users. For users who have been granted privileged write access (AccessRight.PRIVILEGED_WRITE), this property is read/write. (The read/write access for those users could only change if a change is made to the ACL on the object store that controls who has privileged write access to objects in that object store).

Public propertyName
The name for this object.

For most classes, this property is read-only and returns the value of the designated name property for the object, or its ID if there is no name property. If ClassDescription.NamePropertyIndex has a value, this property contains the value of the designated name property. If there is no designated name property value, and the object has an Id property, this property contains the string value of the Id property. If neither of these conditions is satisfied, this property contains an empty string.

For a ComponentRelationship object, this property is read/write and specifies the name of the object.

Public propertyOwner
Manages the security owner assigned to the object.
Public propertyPermissions
Manages the discretionary permissions assigned to the object.
Public propertyPostCondition
A condition the ICmTask object must satisfy before it may be considered complete. Postcondition expressions are specified in the class definition for the task (as class constant properties). They cannot be set on a task instance.

A postcondition is is evaluated when aICmTask object is in the WORKING state, and changeState(LifecycleChangeFlags.PROMOTE) is invoked on the ICmTask.

A condition is expressed as an SQL predicate applied to the ICmTask object itself, or to objects related to the ICmTask through object-valued properties. For example, if you have a claim processing task that cannot be completed until its ClaimStatus property is set to CLOSED, then the postcondition expression would be ClaimStatus = 'CLOSED'.

A postcondition has the same syntax requirements as the FilterExpression property.

Public propertyPreCondition
A condition the ICmTask object must satisfy in order to be considered ready to be worked upon. Precondition expressions are specified in the class definition for the task (as class constant properties). They cannot be set on a task instance.

A precondition is evaluated when a ICmTask object is in the WAITING_PRECONDITION state, and changeState(LifecycleChangeFlags.PROMOTE) is invoked on the ICmTask.

A condition is expressed as an SQL predicate applied to the ICmTask object itself, or to objects related to the ICmTask through object-valued properties. For example, if you have a document approval activity that cannot be worked on until its InputDocument property is set to a released document version, then the precondition expression would be InputDocument SATISFIES (VersionStatus = 1).

A precondition has the same syntax requirements as the FilterExpression property.

Public propertyPredecessors
An enumeration of task relationships objects identifying the predecessors of this task. When you create a ICmTaskRelationship object and set its SuccessorTask property to this ICmTask object, the newly created ICmTaskRelationship object is added to the enumeration.
Public propertyProperties
The IProperties collection of properties for the EngineObject.
(Inherited from IEngineObject.)
Public propertyReplicationGroup
A ReplicationGroup object representing the replication group to which this replicable object belongs.

For ReplicationJournalEntry objects only, this property represents the replication group to which the source object of the replication operation generating this journal entry belongs.

(Inherited from IReplicable.)
Public propertySuccessors
An enumeration of task relationships objects identifying the successors of this task. When you create a ICmTaskRelationship object and set its PredecessorTask property to this ICmTask object, the newly created ICmTaskRelationship object is added to the enumeration.
Public propertyTaskState
The current state of the task. Some state changes are made automatically by the Content Engine server, and others are made manually with the ICmTask.ChangeState method. The states are defined by the Content Engine server. For a description of the possible states, see the TaskState enumeration.

ToggleSee Also