Business Entity Services Guide

10.3 HotFix 1

Back Next

Request Body

Specify the task attributes when you create the task. Use the JSON format or the XML format to send the task data in the request.

The following table describes the task parameters in the request body:

Parameter	Description
taskType	A set of actions that you can perform on a record. Use the name attribute to specify the task type. For more information about task types, see the Multidomain MDM Data Director Implementation Guide .
owner	User to whom the creator assigns the task.
title	Short description for the task.
comments	Comments for the task.
attachments	Attachments for the task.
dueDate	Date when the owner must complete the task.
status	Status of the task in the workflow. Use one of the following two values: Open: Task has not started or is in progress. Closed: Task is completed or is cancelled.
priority	Level of importance of the task. Use one of the following values: high, normal, and low. Default is normal.
creator	User who creates the task.
createDate	Date when you create the task.
orsId	ID of the Operational Reference Store (ORS) as registered in the Databases tool in the Hub Console.
processId	ActiveVOS^® task type ID. For more information, see the Multidomain MDM Data Director Implementation Guide .
taskRecord	The business object root record or the cross-reference record associated with the task. Use the row ID or the source system and source key to specify the record.
businessEntity	Name of the business entity to which the taskRecord belongs.
interactionId	ID of the interaction. Use the interaction ID to keep a task context relationship between a task and records.
groups	Assign a task to all users in the specified user groups. You define user groups in the MDM Hub Console. Specify the groups as an array.

The following sample code uses the rowId to specify the taskRecord:

taskRecord: [{
       businessEntity:{
         name: "Person",
         key:{
            rowid: "233",
         }
       }
     }]

The request body has the following format:

{    
     taskType: {name:"name of the task"},
     owner: "user who performs the task",
     title: "title of the task",
     comments: "description of the task",
     attachments: [
          {
               id: "TEMP_SVR1.1VDVS"
          }
     ],
     dueDate: "date to complete the task",
     status: "status of the task",
     priority: "priority of the task",
     creator: "use who creates the task",
     createDate: "date on which the task is created",
     updatedBy: "user who last updated the task",
     lastUpdateDate: "date on which the task was last updated",
     businessEntity: "name of the business entity",
     interactionID: "ID of an interaction",
     groups: ["group name A", "group name B", ...],
     orsId: "database ID",
     processId: "ActiveVOS task type ID",
     taskRecord: [{
       businessEntity:{
         name: "name of the business entity",
         key:{
            rowid: "rowId of the record", //Use the rowId or the source system and source key to identify the record.
         }
       }
     }]
}

Rename Saved Search

Table of Contents

Business Entity Services Guide

Business Entity Services Guide

Request Body

Request Body