...
Universal Controller supports the following RESTful-based web services for Task Instance operations, which are listed alphabetically on this page.
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488Cancel a Task Instance
- Clear All Dependencies
- Clear Exclusive Dependencies
- Clear Predecessor Dependencies
- Clear Time Dependency
- Clear Virtual Resource Dependencies
- Delete a Task Instance
- Force/Finish a Task Instance
- Force/Finish Cancel a Task Instance
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488
- 57278488Hold a Task Instance
- Issue Set Completed Command for a Manual Task Instance
- Issue Set Started Command for a Manual Task Instance
- List Task Instances
- List Task Instance Variables (Show Variables)
- Release a Task Instance from Hold
- Rerun a Task Instance
- Retrieve Task Instance Output
- Set or Modify Wait Time/Duration for Task Instance
- Set Priority for a Task Instance
- Skip a Task Instance
- Skip a Task Instance Path
- Unskip a Task Instance
- Update a Task Instance Operational Memo
Formatting specifications for each web service, including details about parameter requirements, are provided.
...
Description | |
---|---|
URI | |
HTTP Method | POST |
Description | Cancel a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/cancel |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/cleardependencies |
HTTP Method | POST |
Description | Clears all dependencies of a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/cleardependencies |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/clearexclusive |
HTTP Method | POST |
Description | Clears all exclusive dependencies of a task instance. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/clearexclusive |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/clearpredecessors |
HTTP Method | POST |
Description | Clears all predecessor dependencies of a task instance in a Workflow. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/clearpredecessors |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/cleartimewait |
HTTP Method | POST |
Description | Clears the time dependency of a task instance. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/cleartimewait |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/clearresources |
HTTP Method | POST |
Description | Clears virtual resource dependencies of a task instance. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/clearresources |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Clear Virtual Resource Dependencies: XML and JSON Examples. |
Request Properties | See Clear Virtual Resource Dependencies: Request Properties. |
Example Response | See Clear Virtual Resource Dependencies: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance |
HTTP Method | DELETE |
Description | Deletes the specified task instance. For Workflow task instances, if the |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Example URI | http://localhost:8080/uc/resources/taskinstance |
Example Request | |
Request Properties | |
Example Response |
|
...
XML | JSON | |||||
---|---|---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/forcefinish |
HTTP Method | POST |
Description | Force Finish a task instance. (To Force Finish (Halt) a task instance, set the halt property to true.) |
Example URI | http://localhost:8080/uc/resources/taskinstance/forcefinish |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/forcefinishcancel |
HTTP Method | POST |
Description | Force Finish/Cancel a task instance. (To Force Finish/Cancel (Halt) a task instance, set the halt property to true.) |
Example URI | http://localhost:8080/uc/resources/taskinstance/forcefinishcancel |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Force Finish Cancel a Task Instance: XML and JSON Examples. |
Request Properties | See Force Finish/Cancel a Task Instance: Request Properties. |
Example Response | See Force Finish Cancel a Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/hold |
HTTP Method | POST |
Description | Hold a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/hold |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/setcompleted |
HTTP Method | POST |
Description | Issues a Set Completed command for a Manual Task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/setcompleted |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Issue Set Completed Command for a Manual Task Instance: XML and JSON Examples. |
Request Properties | See Issue Set Completed Command for a Manual Task Instance: Request Properties. |
Example Response | See Issue Set Completed Command for a Manual Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/setstarted |
HTTP Method | POST |
Description | Issues a Set Started command for a Manual Task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/setstarted |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Issue Set Started Command for a Manual Task Instance: XML and JSON Examples. |
Request Properties | See Issue Set Started Command for a Manual Task Instance: Request Properties |
Example Response | See Issue Set Started Command for a Manual Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/list |
HTTP Method | POST |
Description | Retrieves information on task instances matching specific search criteria. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/list |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
| ||||||||||||||||||||||||
|
|
|
...
Note | ||
---|---|---|
| ||
The format of multi-word task status names specified in the Task Instance Status Web Service differs from the format of task status names used in the Controller user interface. In Task Instance Status, the words are separated by an underscore character; in the user interface, they are separated by a space. |
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/showvariables |
HTTP Method | GET |
Description | Retrieve the variables for a specific task instance. (Comparable to the Show Variables functionality in the user interface.) |
Authentication | HTTP Basic |
Example URI | |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
Example URI Properties | See List Task Instance Variables (Show Variables): Example URI Properties. |
Example Response | See List Task Instance Variables (Show Variables): XML and JSON Response Examples. |
Anchor | ||||
---|---|---|---|---|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/release |
HTTP Method | POST |
Description | Releases the specified task instance from hold. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/release |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Release a Task Instance from Hold: XML and JSON Examples. |
Request Properties | |
Example Response | See Release a Task Instance from Hold: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/rerun |
HTTP Method | POST |
Description | Rerun a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/rerun |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | ||||||
---|---|---|---|---|---|---|
URI | http://host_name/uc/resources/taskinstance/retrieveoutput | |||||
HTTP Method | GET | |||||
Description | Retrieves the output of a task instance.
| |||||
Example URI | ||||||
Consumes Content-Type | n/a | |||||
Produces Content-Type | application/xml, application/json | |||||
Example URI Properties | ||||||
Example Response | See Retrieve Task Instance Output: XML and JSON Response Examples. |
Anchor | ||||
---|---|---|---|---|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/settimewait |
HTTP Method | POST |
Description | Sets or modifies a wait time/duration for a task instance. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/settimewait |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Set or Modify Wait Time/Duration for Task Instance: XML and JSON Examples. |
Request Properties | See Set or Modify Wait Time/Duration for Task Instance: Request Properties. |
Example Response | See Set or Modify Wait Time/Duration for Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/setpriority |
HTTP Method | POST |
Description | Set priority for a task instance (Linux/Unix, Windows, Universal, or z/OS). |
Example URI | http://localhost:8080/uc/resources/taskinstance/setpriority |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Set Priority for a Task Instance: XML and JSON Examples. |
Request Properties | |
Example Response | See Set Priority for a Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/skip |
HTTP Method | POST |
Description | Skip a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/skip |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/skippath |
HTTP Method | POST |
Description | Skip a task instance and all of its dependent task instances. |
Example URI | http://localhost:8080/uc/resources/taskinstance/skippath |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/unskip |
HTTP Method | POST |
Description | Unskip a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/unskip |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | |
HTTP Method | PUT |
Description | Update the operational memo for a task instance record. |
Example URI | |
Authentication | HTTP Basic |
Consumes Content-Type | text/plain |
Produces Content-Type | text/plain |
Example URI Properties | See Update a Task Instance Operational Memo: Example URI Properties. |
Example Request Body | See Update a Task Instance Operational Memo: Text/Plain Examples. |
Example Response Body | See Update a Task Instance Operational Memo: Text/Plain Examples. |
Anchor | ||||
---|---|---|---|---|
|
...