Defines a predecessor-successor relationship between two ICmTask objects. A ICmTask object can be referenced by more than one instance of this class, and, consequently, can be designated as a ICmTask object in more than one relationship. This capability allows many-to-many predecessor-successor associations to be maintained between tasks. Given that a process can consist of multiple tasks that are coordinated by the same business object, the ICmTaskRelationship objects referencing these tasks collectively define the overall sequencing of the process.

A ICmTaskRelationship object is subject to the following constraints:

  • The predecessor and successor must be different ICmTask objects.
  • Both referenced ICmTask objects must have the same coordinator.
  • Cycles are not permitted in the relationships between tasks. For example, you cannot have task relationships where TaskA has TaskB as a successor and TaskB has TaskA as successor.
  • At most, one ICmTaskRelationship is allowed for a given predecessor-successor task pair.

Created with a Factory method, a ICmTaskRelationship object is independently persistable. However, it is not independently securable; it takes its security from the predecessor ICmTask object. For example, users with write permission to the predecessor ICmTask object have the same right to the ICmTaskRelationship object referenceing the predecessor. Permission to delete a ICmTaskRelationship object requires deletion rights on the predecessor ICmTask object. Deletion of a ICmTaskRelationship object does not delete the predecessor-successor ICmTask objects referenced by the ICmTaskRelationship object .

Note that deletion of a task cascades to any task relationships referencing that task as either a predecessor or successor, but the deletion does not cascade through the task relationships to other referenced tasks.

For more information, see Task Concepts.

Namespace:  FileNet.Api.Core
Assembly:  FileNet.Api (in FileNet.Api.dll)

ToggleSyntax

Visual Basic (Declaration)
Public Interface ICmTaskRelationship _
	Implements IRepositoryObject, IReplicable, ISubscribable, IIndependentlyPersistableObject,  _
	IIndependentObject, IEngineObject, ICloneable
C#
public interface ICmTaskRelationship : IRepositoryObject, 
	IReplicable, ISubscribable, IIndependentlyPersistableObject, IIndependentObject, IEngineObject, 
	ICloneable
Visual C++
public interface class ICmTaskRelationship : IRepositoryObject, 
	IReplicable, ISubscribable, IIndependentlyPersistableObject, IIndependentObject, IEngineObject, 
	ICloneable
JavaScript
FileNet.Api.Core.ICmTaskRelationship = function();
FileNet.Api.Core.ICmTaskRelationship.createInterface('FileNet.Api.Core.ICmTaskRelationship');

ToggleRemarks

Metadata

Auditable: true
AllowsInstances: true
AllowsSubClasses: true
ClassDefinitionName: ReplicableClassDefinition
IsDependent: false
IsHidden: false
Searchable: true
StorageType: ObjectStore
SuperclassName: Replicable

ToggleSee Also