Element | Description |
acceptedbyList | String List. Optional. The IDs (on My webMethods Server) of the users, groups, and roles that have accepted the task. |
assignedToList | String List. Optional. The IDs of the principals (users, groups, and roles on My webMethods Server) to which the task is assigned. |
attributes | Map. Optional. Contains data that is used by the process run-time. For internal use only. |
auditContext | String. Optional. 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. Optional. The unique ID of the collaboration process flow created when a task is used for collaboration workflow. |
collaborationStepID | String. Optional. The unique ID of the task step in the process flow when the task is used for collaboration workflow. |
createdBy | String. Required. The user ID (on My webMethods Server) of the user that initially queued the task. |
createdDate | DateTime. Required. The date and time when the task was queued. |
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. |
delegatedFromList | String List. Optional. List of user IDs who delegated this task. |
delegatedToList | String List. Optional. List of user IDs to whom the task was delegated. |
delegationMap | Map. Optional. A map containing task delegation information. 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. |
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. Required. 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. Required. The date and time the task was last accepted. |
lastModifiedBy | String. Required. 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 element contains the name of the task rule associated with that process. |
lastModifiedDate | DateTime. Required. 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. |
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. Values are: none low medium high critical |
processInstanceID | String. Optional. 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. Optional. 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. Optional. 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. Optional. 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 specified time. When the task starts, 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 still 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 still appear in the Task Management Results list. cancelled. Task has been cancelled and is no longer available in the user's inbox queue. Cancelled tasks still appear in the Task Management Results list. expired. Task has expired and is no longer available in the user's inbox queue. Expired tasks still 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. |
stepID | String. Optional. 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. Optional. The TryCount value from the pub.prt:ProcessData document. This value only appears in TaskInfo if the task was queued by a business process. |
taskID | String. Required. A unique identifier assigned to the task by the Task Engine when the task is queued. |
taskScheduleDate | Date. Optional. Specifies the date and time when the task should start. 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 status will be active. When the task starts at the scheduled time, the global rule for task schedule changes the status of the task from scheduled to active. |
taskTypeID | String. Required. 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. Optional. 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. Required. 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 throws the exception "Task is Out of Date" if they mismatch. |
taskData | Base64-encoded String. Optional. The task business data serialized in JSON format. |