Services Integration Framework Guide

10.4

Back Next

CreateTask

The CreateTask request creates a new task in the C_REPOS_TASK_ASSIGNMENT table and initializes the task data and task properties. Once a task is created, use the UpdateTask request to modify the task.

TaskData

The

TaskData

object contains information about a task.

The following table lists the TaskData fields that you can configure:

Field	Description
TaskRecord	A link to a data record associated with a task.
Comment	An optional task comment.
TaskType	The task type.
SubjectAreaUID	The UID of the task subject area.
Title	The task title.
TaskID	The ROWID of the task. Cannot be set by user.
DueDate	The date when the task is due.
Priority	The priority of the task. 1 : High priority. 0 : Normal priority. The default is 0 . -1 : Low priority.
StatusEnum	The workflow status. The default is TaskStatusEnum.OPEN .
OwnerUID	The user or role ID to whom the task is assigned.
InteractionID	The Interaction ID.
WorkflowProcessID	The ID of the workflow process that contains the task. Cannot be set by user.
CreateDate	The date when the task was created. Cannot be set by user.
Creator	The name of the user who created the task. Cannot be set by user.
LastUpdateDate	The date when the task was updated. Cannot be set by user.
LastUpdatedBy	The name of the user who updated the task. Cannot be set by user.
PreviousOwner	The name of the user or role to whom the task was previously assigned. The value is Null if the task is new or has not been assigned. Cannot be set by user.

TaskRecord

The

TaskRecord

object contains information about a record.

The following table describes the TaskRecord fields:

Field	Description
SiperianObjectUID	An identifier for an object in Informatica MDM Hub.
RecordKey	An identifier for a record in Informatica MDM Hub.
MatchRuleUID	An identifier for a match rule in Informatica MDM Hub. Only merge tasks require a MatchRuleUID.

Required Request Parameters

The following table describes the required parameters for a CreateTask request:

Parameter	Description
TaskData	Specifies the task to create. If an owner is not specified in the TaskData parameter, the task assignment engine will attempt to assign the task at its next scheduled execution time.

Optional Request Parameters

The

CreateTask

API does not have any optional request parameters.

Response Fields

The

CreateTask

response contains the information described in the following table:

Parameter	Description
TaskID	Contains the ROWID_OBJECT of the task that was created.
interactionID	Contains the interactionID that is used to protect any pending records associated with the task. Only SIF requests having this same interactionID can update the task. The interactionID can be set either at the request level or in the TaskData object. If an interactionID is set in both places and the IDs do not match, an SiperianServerException will be thrown.

Use Cases

The following scenario is a common use case for using the

CreateTask

request:

Create a new task and assign it to a user.

Usage Example

The code in the following example creates a new task:

CreateTaskRequest request = new CreateTaskRequest();
TaskData newTask = new TaskData();
request.setTaskData(newTask);
newTask.setTitle("Research and resolve item");
newTask.setComment("This is a new task.");
newTask.setDueDate(new Date());
newTask.setSubjectAreaUid("SUBJECT_AREA.test|Person");
newTask.setTaskType("ReviewNoApprove");
CreateTaskResponse response = (CreateTaskResponse) sipClient.process(request);