Task Engine 10.7 | Task Engine Webhelp | webMethods Task Engine API and Service Reference | Using the Task Engine Web Service API | TaskInfo
 
TaskInfo
Contains standard information about a task. You specify certain fields in TaskInfo when you start a task using the queueTask operation. After a task is queued, you can modify fields in TaskInfo using the updateTask operation.
Some fields that appear in TaskInfo can only be changed by the Task Engine. These fields are marked "read only" in the description below. If you attempt to assign a new value to a read-only field, the new value is ignored.
A task is not required to maintain information for every field in TaskInfo. Most fields are optional as noted in the description below.
Element
Description
acceptedByList
String[ ] Optional. The IDs (on My webMethods Server) of the users, groups, and roles that have accepted this task. Setting this field accepts the task for the specified users, groups, and roles.
assignedToList
String[ ] Optional. The IDs of the principals (users, groups, and roles on My webMethods Server) to which this task is assigned. Setting this field assigns the task to the specified users, groups, and roles. The Task Engine uses this field to route the task to the appropriate users.
attributes
Map Optional. Contains data that is used by the process run-time. For internal use only.
auditContext
String Read-only. The AuditContext value from the pub.prt:ProcessData document. This value appears in TaskInfo only if the task was queued by a business process.
collaborationProcessID
String Read-only. The unique ID of the collaboration process flow created when a task is used for collaboration workflow.
collaborationStepID
String Read-only. The unique ID of the task step in the process flow when task is used for collaboration workflow.
createdBy
String Read-only. The user ID (on My webMethods Server) of the user that initially queued the task.
createdDate
DateTime Read-only. The date and time when the task was queued.
currentUserAccepted
Boolean Read-only. Returns true if the task is accepted by the current user.
customTaskID
String Optional. An optional, application-defined identifier for the task. This ID is separate from the internal taskID that the Task Engine uses to identify tasks. The identifier in customTaskID is visible in the user interface and is also searchable using the searchTasks operation.
Note:
Although customTaskID is meant to uniquely identify a task, the Task Engine does not enforce uniqueness of the value in this field. The application is responsible for assigning unique identifiers to customTaskID if they are needed.
delegatedFrom
String Read-only. If a task is delegated to the current user, this field contains the user ID of the user who delegated the task to the current user.
delegatedFromList
String[ ] Optional. List of user IDs who delegated this task.
delegatedToList
String[ ] Optional. List of user IDs to whom the task was delegated
delegationMap
Map Optional. A Map containing task delegation information (not available for .NET service). The map key is the user ID of the user who delegates the task; the value for the key is the user ID of the users to whom the task is delegated.
*key String User ID of delegating user.
*value String User ID of target user.
description
String Optional. A descriptive comment or remark associated with the task. This description appears in various places in the My webMethods user interface, such as on the Details View tab in My Inbox and in the Task Management Results list.
Maximum length is 255 characters.
errorCode
String Optional. A code that identifies the error condition that caused the task to end. This field is usually present when the value in status is "error." However, the Task Engine does not require an application to report an error code, so this field might be null even if the task ends with an error.
errorMessage
String Optional. A message describing the error condition that caused the task to end. This field is usually present when the value in status is "error." However, the Task Engine does not require an application to report an error message, so this field might be null even if the task ends with an error.
expireDate
DateTime Optional. The date and time when the task expires. When expireDate is reached, the Task Engine switches the status value for the task to "expired."
If an expire date is not specified, the task never expires.
lastAcceptedBy
String Read-only. The user ID (on My webMethods Server) of the last user to accept the task. The field is set to null if no user has accepted the task, or when acceptedByList is reset to null.
lastAcceptedDate
DateTime Read-only. The date and time the task was last accepted
lastModifiedBy
String Read-only. The user ID (on My webMethods Server) of the user that last updated the task. If a process within the Task Engine was the last entity to modify the task (for example, if the Task Engine marked the task "expired"), this field contains the name of the task rule associated with that process.
lastModifiedDate
DateTime Read-only. Date and time when the task was last updated.
name
String Optional. The name of the task. This name appears in various places in the My webMethods user interface, such as on the Details View tab in My Inbox and in the Task List Management Results list.
A task does not require a name. If a name is assigned, it does not need to be unique. Maximum length is 255 characters.
parentTaskID
String Optional. The value of the parent task ID in the case when tasks are used for collaboration workflow. When queuing a new task, if a valid taskID is specified for "parentTaskID", the task to be queued is created as a child task of the parent task.
priority
String Optional. The priority of the task. Must contain one of the following values:
none low medium high critical
Values are case-sensitive.
processInstanceID
String Read-only. The ProcessInstanceID value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process.
processIteration
Integer Read-only. The ProcessIteration value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process.
processModelID
String Read-only. The ProcessModelID value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process.
processModelVersion
String Read-only. The ProcessModelVersion value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process.
status
String Optional. The state of the task. Must contain one of the following values:
*new. Task is new and not yet started. Immediately after the task starts, the status of the task changes from new to active.
*scheduled. Task is scheduled to start at the time specified in taskScheduleDate. When the task starts at the scheduled time, the status of the task changes from scheduled to active.
*active. Task is active and is available in the user's inbox queue. Only active tasks can be modified by the user.
*suspended. Task is suspended and is not available in the user's inbox queue. Suspended tasks continue to appear in the Task Management Results list.
*completed. Task has been successfully completed and is no longer available in the user's inbox queue. Completed tasks continue to appear in the Task Management Results list.
*cancelled. Task has been canceled and is no longer available in the user's inbox queue. Canceled tasks continue to appear in the Task Management Results list.
*expired. Task has expired and is no longer available in the user's inbox queue. Expired tasks continue to appear in the Task Management Results list.
*error. Task has failed or an unrecoverable error occurred during the processing of the task. This is often due to an incorrect task rule. The errorCode and errorMessage fields generally contain additional information about the error.
If you attempt to set status to any value other than the ones listed above, your value is ignored.
stepID
String Read-only. The StepID value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process.
stepIteration
Integer Read-only. The TryCount value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process.
taskScheduleDate
Date Specifies the date and time the task should start. The status of the task changes based on the specified value.
*If you specify a date that is later than the current date, the task status will be scheduled.
*If you do not specify a date, the task will be active.
When the task starts or queues at the scheduled time, the global rule for task schedule changes the status of a task from scheduled to active.
taskID
String Read only. A unique identifier assigned to the task by the Task Engine when the task is queued.
taskTypeID
String Read only. Specifies the task's type. Each task type that is deployed on the Task Engine has a unique ID. This ID is assigned by the developer when he or she creates a task application using Software AG Designer.
taskURL
String Read only. The relative URL for the task on My webMethods Server. This URL can be used to open the task instance in a browser.
taskVersionNumber
Integer Optional. This is the current version number of the task record that is automatically incremented for each task update action.
This property can be used in the updateTask() service. If a value different than 0 is passed in when executing updateTask(), then the Task Engine verifies this value against the current value of the task instance and throw an exception "Task is Out of Date" if they mismatch. For example, when the client of the API is holding a task record, but the task record has been since updated and thus "taskVersionNumber" was incremented.