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. |