addTask
- Description
- This transaction creates a task to be performed by a given user role. The newly created task resides in a general task list until it assigned to a user who belongs to the user role specified for the task. Once assigned, the task is added to the task owner's task list.
- Web Services
- Operation name: addTask
- Service name: DWLBusinessServices
- Example
Add a task for a Data Steward to collapse the record for John Adams with an identified A2 suspect, Jack Adams.
Add a task for a supervisor, Daniel Schlitz, to approve a new campaign.
- Usage information
- AddTask can be either a fine-grained transaction or a coarse-grained
transaction in which the task can be assigned to a specified user,
entities can be associated, and comments can be added.
The task owner must belong to the same user role identified in the task.
For the addTask transaction to associate one or more entities to a task, the InstancePK and EntityName must be provided in the WorkbasketEntityBObj.
For the addTask transaction to be able to associate one or more comments, the CommentText must be provided in the TaskCommentBObj.
The TaskOwner is an optional input attribute.
- Preconditions
- A Task Definition must exist.
- Mandatory input
- TaskDefinitionId
- TaskOwnerRole
- TaskDueDate
- PriorityType
- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
- A task can only have one task owner role and task owner at a time.
A task can only be assigned to a task owner belonging to the same user role identified for the task.
To associate one or more entities with a task, the InstancePK and EntityName must be provided.
Each active task associated with an entity is unique.
Upon creation, each task is returned with a task status. If the task is unassigned, the status is "New". If it is assigned to a task owner, the status is "Pending". A task can be assigned at creation by providing a task owner name in the transaction request.
- Request message
- <TCRMTxType> addTask
<TCRMTxObject> TaskBObj
<TCRMObject> TaskBObj
with optional business objects: - Response objects
- TaskBObj with optional
business objects:
- WorkbasketBObj with a list of WorkbasketEntityBObj
- TaskCommentBObj
- Special note
- Not applicable