Oracle Human Workflow Web Service APIs

Oracle SOA Suite offers an exhaustive set of both java and web service APIs for Human Workflows. In this blogpost i will show how we can use the two most important workflow webservices to query and update Human Tasks in Oracle SOA Suite 11g.

The two Taskflow webservices API’s that I would talk here about are

TaskQueryService

The TaskQueryService service can be accessed at your SOA suite installation at the below endpoint.

http://host:port/integration/services/TaskQueryService/TaskQueryService

And the API is here

http://host:port/integration/services/TaskQueryService/TaskQueryService?TaskQueryServicePortstub.html

This webservice api has many useful methods to query tasks like getting task details, task history, query assignees of a task etc.

Tow important method in the API are getTaskDetailsByNumber and getTaskDetailsById that can be used to query task details from the task number that we see in the worklist user interface.

image

Now use any soap client to invoke the query service operation to see how it works

image

As you see that the entire task details has been retrieved. If we take a closer look at the response we would find thas the taskId is also retrieved. This taskId is required in many other operations of this webservice and it can be retrieved using the taskNumber.

image

There is one more operation queryTasks that can be used to query tasks based on various where clauses like the task state, the assignee, column name etc.

TaskService

Another useful webservice is the TaskService that has practically all operations to modify any aspect of a task like adding/removing task comments, attachments, delegating, withdrawing and reassigning tasks, deleting or purging them etc.

We can go ahead and build our own custom user interface with underlying actions that are implemented by these operations. Or also call from service clients like OSB in case we need to do any custom task operations.

The service can be accessed at your SOA suite installation at the below endpoint.

http://host:port/integration/services/TaskService/TaskServicePort

And the full API can be viewed at

http://host:port/integration/services/TaskService/TaskServicePort?TaskServicePortstub.html

Here is a small demonstration explaining how we can add a comment to a task from the addComment operation of the service.

See how I have used the taskId that was retrieved from the getTaskDetailsByNumber operation is used to add comment to an existing task

image

Verify it in the workslist user interface to validate that the comment is added and appearing.

image

The above blog demonstrates some simple webservice operations using the Task service APIs. However they provide a very rich and exhaustive mechanism to do a great lot of important stuff with human tasks in Oracle SOA Suite 11g.

.

9 thoughts on “Oracle Human Workflow Web Service APIs

  1. Pingback: Using Java APIs for Oracle Human Workflows « Oracle Technologies Premier

  2. Hi there, You’ve done a fantastic job. I will certainly digg it and personally suggest to my friends. I’m sure they’ll be benefited from this website.

    Like

  3. Pingback: Functional Testing Business Processes In Oracle BPM Suite 11g | Oracle Technologies Premier

  4. Pingback: Functional Testing Business Processes In Oracle BPM Suite 11g | Rubicon Red

  5. Pingback: Restrict Reassignments in Oracle BPM | Oracle Technologies Primer

  6. Pingback: Functional Testing Business Processes In Oracle BPM Suite | Oracle Technologies Primer

If you have any comments, suggestions or feedback about the post, please feel free to type it here and I will do my best to address them asap

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s