Task Engine 10.11 | Task Engine Webhelp | webMethods Task Engine User's Guide | Administering Tasks | Administering Task EDA Event Emission | About EDA Predefined Task Event Types | EDA Task Event Element Definitions | Key Supporting Schemas
 
Key Supporting Schemas
The Task schema provides support for the predefined EDA task event type. The schema can be found in the folder Software AG_directory \common\EventTypeStore\WebM\Task\1.0, along with the EDA task event schema.
Task
Provides standard information (TaskInfo) and business data information, when available, about a task.
Schema file: Task.xsd
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.