pub.task.taskclient:updateTask
WmTaskClient. This service modifies a task on the Task Engine that is connected to the Integration Server. You use this service to change information in the task's TaskInfo and TaskData documents. By default, this service enables you to update only tasks in Active, Error, and Suspended state; for information about updating tasks with other statuses, see Usage Notes, below.
To end a task, you use this service to change the status field in the task's TaskInfo document to "closed" or "cancelled" as appropriate.
Input Parameters
user | String Optional. The user ID of the My webMethods Server user on whose behalf this service will execute. If user is not specified, the user ID associated with the WmTaskClient package is used. For information about configuring this user ID, see the PDF publication webMethods Task Engine User’s Guide. |
taskID | String The ID that identifies the task you want to modify. |
TaskInfo | Document TaskInfo object that specifies the changes you want to make to the standard information maintained for the task. See pub.task:TaskInfo for a description of the fields in this document. |
TaskData | Document TaskData object that contains the business data that you want to associate with the task.TaskData does not have a specified structure. Its content varies according to the task. |
retryOnFailure Count | String Optional. Specifies the number of times to attempt to invoke the service. The default is 0 times. When specified, this value will override the configuration value set on the WmTaskClient Home page in IS Administrator. |
retryDelay | String Optional. Specifies the number of milliseconds to wait between attempts. The default is 1000 ms (this field is ignored if retryOnFailureCount = 0). When specified, this value will override the configuration value set on the WmTaskClient Home page in IS Administrator |
Output Parameters
None.
Usage Notes
When you use this service to update information in the task's TaskInfo document, the Task Engine modifies only the fields that have assigned values in TaskInfo. All other fields in the target task retain their existing values. For example, to change just the name assigned to a task, set only the name field in the TaskInfo document that you pass to this service.
When you use this service to update information in the task's TaskData document, the TaskData document that you pass to the service replaces the task's existing TaskData document in its entirety.
By default, this operation enables you to update only tasks in Active, Error, and Suspended state. Tasks with other statuses (such as Completed, Canceled, or Expired) cannot be updated.
However, a Task Engine optional setting, -Dupdate.completed.task=true, is available to apply update actions to a task regardless of its current status. When this option is not present or set to = false, task updates apply only to tasks in Active, Error, or Suspended status.
For information about setting this option, see “Specifying Task Update Behavior” and “Applying Task Engine Optional Settings” in Chapter 6 of the PDF publication, webMethods Task Engine User’s Guide.
You can edit the taskScheduleDate field only when the task is in scheduled state.
You cannot edit the schedules of task instances created using Task Engine 9.9 or earlier because those task instances will be in active state.
Contact Support
|
Community
|
Feedback