In this blogpost I will describe how you can do that and especially how you can query the Human task with your own ordering and restrictions.
You can try these examples from soapUI or any other web service framework / tool.
In this blogpost we will invoke these two WF web services
TaskQueryService, This WS can be used for task retrieval or do a query on the WorkFlow service.
The WSDL url = http://soa-server:8001/integration/services/TaskQueryService/TaskQueryService?WSDL
TaskService, This WS can be used for CRUD actions on the human tasks.
The WSDL url = http://soa-server:8001/integration/services/
Both services got two endpoints, be aware you should always use the endpoint of TaskQueryServicePortand not the SAML port unless you like to use SAML authentication.
<service name="TaskQueryService">
<port name="
<soap:address location="http://172.16.0.4:
</port>
<port name="TaskQueryServicePort" binding="tns:
<soap:address location="http://172.16.0.4:
</port>
</service>
When we know our Human TaskId ( something like this 3fa4e9f7-5719-4efa-8215-ad2b47fcbace )
then you can use the getTaskDetailsById operation.
<soapenv:Envelope xmlns:soapenv="
http://schemas.
xmlns:com="
http://xmlns.
<soapenv:Header/>
<soapenv:Body>
<
tas:taskDetailsByIdRequest
>
<com:workflowContext>
<com:credential>
<com:login>
weblogic
</com:
<com:password>
weblogic1
</com:
</com:credential>
</com:workflowContext>
<tas:taskId>
3fa4e9f7-5719-
</tas:taskDetailsByIdRequest>
</soapenv:Body>
</soapenv:Envelope>
In this case I use workflowContext for authentication. You can also do it on behalf of someone else.
Sometimes you only got a Human WorkFlow number then you can use the getTaskDetailsByNumber operation.
<soapenv:Envelope xmlns:soapenv="
http://schemas.
xmlns:com="
http://xmlns.
<soapenv:Header/>
<soapenv:Body>
<tas:
<com:workflowContext>
<com:credential>
<com:login>weblogic</com:
<com:password>weblogic1</com:
</com:credential>
</com:workflowContext>
<tas:taskNumber>
200000
</tas:
</tas:
</soapenv:Body>
</soapenv:Envelope>
When you don't know the taskId or the task number or want to do bulk operations then you can do a search on the humantask services. The queryTasks operation is very powerful and there is not really a restriction.
let's start with a simple one. In this request I want to search for a task number and also want to have some extra attributes ( blue part ) in the response together with the Comments, Attachments and the Payloads ( red part ).
<soapenv:Envelope xmlns:soapenv="
http://schemas.
xmlns:tas="
http://xmlns.
xmlns:com="
http://xmlns.
xmlns:tas1="
http://xmlns.
xmlns:task="
http://xmlns.
<soapenv:Header/>
<soapenv:Body>
<tas:taskListRequest>
<com:workflowContext>
<com:credential>
<com:login>weblogic</com:
<com:password>weblogic1</com:
</com:credential>
</com:workflowContext>
<tas1:taskPredicateQuery>
<tas1:displayColumnList>
<tas1:displayColumn>
<tas1:displayColumn>
<tas1:displayColumn>
</tas1:displayColumnList>
<tas1:optionalInfoList>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
</tas1:optionalInfoList>
<tas1:predicate>
<tas1:assignmentFilter>All</
<tas1:clause>
<tas1:column>taskNumber</tas1:
<tas1:operator>EQ</tas1:
<tas1:value>200001</tas1:
</tas1:clause>
</tas1:predicate>
</tas1:taskPredicateQuery>
</tas:taskListRequest>
</soapenv:Body>
</soapenv:Envelope>
In the predicate part we are using the old style for defining our restriction ( clause after predicate ). In the next queryTasks examples I will show the ones which also will be supported in the coming soa suite releases.
assignmentFilter can have the following values: All, My, Group, My+Group, My+Group+All, Reportees, Creator, Owner, Previous, Admin
operator can have the following values: EQ, NEQ, GT, GTE, LT, LTE, LIKE, NOT_LIKE, IN, NOT_IN, CONTAINS, NOT_CONTAINS, BEGINS, NOT_BEGINS, ENDS, NOT_ENDS, BEFORE, AFTER, ON, NEXT_N_DAYS, LAST_N_DAYS, IS_IN_FUTURE, IS_IN_PAST, IS_NULL, IS_NOT_NULL
The optionalInfoList can contain the following values: Actions, GroupActions, CustomActions, Attachments, Comments, Payload, ShortHistory, TemplateTasks
In this query I have a predicate with two clauses which do a search on the text attributes ( tableName attribute is in almost all cases WFTask , check the soa-infa database or the TableConstants class ) and the second one has an AND operator on the first one.
<soapenv:Envelope xmlns:soapenv="
http://schemas.
xmlns:com="
http://xmlns.
xmlns:tas1="
http://xmlns.
xmlns:task="
http://xmlns.
<soapenv:Header/>
<soapenv:Body>
<tas:taskListRequest>
<com:workflowContext>
<com:credential>
<com:login>weblogic</com:
<com:password>weblogic1</com:
</com:credential>
</com:workflowContext>
<tas1:taskPredicateQuery startRow="1" endRow="10">
<tas1:displayColumnList>
<tas1:displayColumn>
<tas1:displayColumn>
<tas1:displayColumn>
</tas1:displayColumnList>
<tas1:optionalInfoList>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
</tas1:optionalInfoList>
<tas1:predicate>
<tas1:assignmentFilter>All</
<tas1:predicate>
<tas1:clause>
<tas1:column tableName="
WFTask
">
<tas1:columnName>
</tas1:column>
<tas1:operator>
EQ
</tas1:
<tas1:value>MyTask</tas1:
</tas1:clause>
<tas1:clause
joinOperator="AND"
>
<tas1:column tableName="
WFTask
">
<tas1:columnName>
</tas1:column>
<tas1:operator>
EQ
</tas1:
<tas1:value>1234</tas1:value>
</tas1:clause>
</tas1:predicate>
</tas1:predicate>
</tas1:taskPredicateQuery>
</tas:taskListRequest>
</soapenv:Body>
</soapenv:Envelope>
In the next example we will add some ordering and use a valuelist in a predicate clause ( for this we need to use the IN operator).
<soapenv:Envelope xmlns:soapenv="
http://schemas.
xmlns:com="
http://xmlns.
xmlns:tas1="
http://xmlns.
<soapenv:Header/>
<soapenv:Body>
<tas:taskListRequest>
<com:workflowContext>
<com:credential>
<com:login>weblogic</com:
<com:password>weblogic1</com:
</com:credential>
</com:workflowContext>
<tas1:taskPredicateQuery>
<tas1:displayColumnList>
<tas1:displayColumn>
<tas1:displayColumn>
<tas1:displayColumn>
</tas1:displayColumnList>
<tas1:optionalInfoList>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
</tas1:optionalInfoList>
<tas1:predicate>
<tas1:assignmentFilter>My+
<tas1:predicate>
<tas1:clause>
<tas1:column tableName="
WFTask
">
<tas1:columnName>
state
</tas1:
</tas1:column>
<tas1:operator>
IN
</tas1:
<tas1:valueList>
<tas1:value>ASSIGNED</tas1:
<tas1:value>INFO_REQUESTED</
<tas1:value>OUTCOME_UPDATED</
</tas1:valueList>
</tas1:clause>
</tas1:predicate>
</tas1:predicate>
<tas1:ordering>
<tas1:clause>
<tas1:column>
priority
</tas1:
<tas1:table>
WFTask
</tas1:
<tas1:sortOrder>
ASCENDING
</
<tas1:nullFirst>false</tas1:
</tas1:clause>
<tas1:clause>
<tas1:column>
taskNumber
</tas1:
<tas1:table>
WFTask
</tas1:
<tas1:sortOrder>
DESCENDING
</
<tas1:nullFirst>false</tas1:
</tas1:clause>
</tas1:ordering>
</tas1:taskPredicateQuery>
</tas:taskListRequest>
</soapenv:Body>
</soapenv:Envelope>
For the Ordering I need to provide the column and table values ( table element is in almost all cases WFTask , check the soa-infa database or the TableConstants class )
The last query task has a more complex predicate, for this we need to use lhs , logicalOperator and rhs elements. And the rhs element contains an another lhs , logicalOperator and rhs section.
<soapenv:Envelope xmlns:soapenv="
http://schemas.
xmlns:com="
http://xmlns.
xmlns:tas1="
http://xmlns.
xmlns:task="
http://xmlns.
<soapenv:Header/>
<soapenv:Body>
<tas:taskListRequest>
<com:workflowContext>
<com:credential>
<com:login>weblogic</com:
<com:password>weblogic1</com:
</com:credential>
</com:workflowContext>
<tas1:taskPredicateQuery startRow="1" endRow="10">
<tas1:displayColumnList>
<tas1:displayColumn>
<tas1:displayColumn>
<tas1:displayColumn>
</tas1:displayColumnList>
<tas1:optionalInfoList>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
<tas1:taskOptionalInfo>
</tas1:optionalInfoList>
<tas1:predicate>
<tas1:assignmentFilter>My+
<tas1:predicate>
<tas1:
lhs
>
<tas1:clause>
<tas1:column tableName="WFTask">
<tas1:columnName>state</tas1:
</tas1:column>
<tas1:operator>
IN
</tas1:
<tas1:valueList>
<tas1:value>ASSIGNED</tas1:
<tas1:value>INFO_REQUESTED</
<tas1:value>OUTCOME_UPDATED</
</tas1:valueList>
</tas1:clause>
</tas1:
lhs
>
<tas1:logicalOperator>
AND
</
<tas1:
rhs
>
<tas1:
lhs
>
<tas1:clause>
<tas1:column tableName="WFTask">
<tas1:columnName>
</tas1:column>
<tas1:operator>
EQ
</tas1:
<tas1:value>MyTask</tas1:
</tas1:clause>
<tas1:clause joinOperator="
AND
">
<tas1:column tableName="WFTask">
<tas1:columnName>
</tas1:column>
<tas1:operator>
EQ
</tas1:
<tas1:value>1234</tas1:value>
</tas1:clause>
</tas1:
lhs
>
<tas1:logicalOperator>
OR
</
<tas1:
rhs
>
<tas1:clause>
<tas1:column tableName="WFTask">
<tas1:columnName>
</tas1:column>
<tas1:operator>
EQ
</tas1:
<tas1:value>123</tas1:value>
</tas1:clause>
</tas1:
rhs
>
</tas1:
rhs
>
</tas1:predicate>
</tas1:predicate>
</tas1:taskPredicateQuery>
</tas:taskListRequest>
</soapenv:Body>
</soapenv:Envelope>
At last we can also try update a Task with a particular outcome. For this we need to use the TaskService
http://soa-server:8001/integration/services/
Use the right endpoint ( not the SAML one ) and use the operation updateTaskOutcome ( this is the easiest way )
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tas="http://xmlns.oracle.com/bpel/workflow/taskService"
xmlns:com="http://xmlns.oracle.com/bpel/workflow/common"
xmlns:task="http://xmlns.oracle.com/bpel/workflow/task"
xmlns:tas1="http://xmlns.oracle.com/bpel/workflow/TaskEvidenceService">
<soapenv:Header/>
<soapenv:Body>
<tas:updateTaskOutcome>
<com:workflowContext>
<com:credential>
<com:login>humantask</com:login>
<com:password>Welcome01</com:password>
</com:credential>
</com:workflowContext>
<tas:taskId> 3e80842f-75c9-4e3d-b441-a7f339df4109</tas:taskId>
<tas:outcome> OK</tas:outcome>
</tas:updateTaskOutcome>
</soapenv:Body>
</soapenv:Envelope>
Just provide the taskId and what the outcome should be.
1667
到【灌水乐园】发言
Hi Edwin, the end point /integration/services/TaskQueryService/TaskQueryServicePort?WSDL gives a 404 error for me.
Reply/integration/services/TaskQueryService/TaskQueryService?WSDL is available but I get :
...
ns0:InvalidSecurity
InvalidSecurity : error in processing the WS-Security security header
...
Is this the SAML issue?
Mark
Hi,
Do you get this error in soapui when invoking a request or with loading the wsdl.
in soapui you can change the endpoint on the top of the request.
thanks
Thanks for your response. I managed to get the service working. I think my problem was not calling the authenticate service first and using the token passed back in subsequent calls.
Successful payload for me;
a075f524-53ef-4713-82e7-0145ad3853bf;;i1sDxUH6FW/5af/QlrBMDlOdu8YG65+CfbSd0fMpkOfZWUHxdUwEsV6LM3gH8c3Ic1kSNT17LPxp8kOO6uZ1LQAy2zrwa5mX9e08I01Cp8RjIPnB0k8idpIt21+Pv+tS7xsEeNBHWhASDszU/pzZONbKcYsu1auQmTEMw0iEnuCrP5PWa8t8iar/vg3CdxSCPFhhQVcNUHjAoQaIJB2ppGu7+sFyHrBPwM/TCLwsz0udQXEOT+h4uLoy/5v0uiDg
All
State
EQ
ASSIGNED
Note I could not access the endpoint .../TaskQueryServicePort?WSDL you mentioned so I'm using /TaskQueryService?WSDL We are running SOA suite 11.1.1.4.
Thanks Mark
Hi,
I also running PS3 and everything is working fine and I don't need a token. just can use username / password
Also both wsdl url are working on PS3.
TaskQueryService, This WS can be used for task retrieval or do a query on the WorkFlow service.
The WSDL url = http://soa-server:8001/integration/services/TaskQueryService/TaskQueryService?WSDL
TaskService, This WS can be used for CRUD actions on the human tasks.
The WSDL url = http://soa-server:8001/integration/services/TaskService/TaskServicePort?WSDL
thanks
Edwin, are you able to get the getDisplayURL() method to work for the TaskQueryService?
ReplyVivek
Hi,
What is getDisplayURL , is that an wsdl operation
thanks
Sorry, I meant to ask this in relation to a task obtained using getTaskDetailsById or getTaskDetailsByNumber. All task details area available except for task.getDisplayURL().
I think it is a fixed url with a taskId parameter.
you can check it in the EM instance process when you click on the humantask. it will give you a direct link to the worklist app.
thanks
I agree its a fixed URL...comes from the WorkFlowUtil class. The question is: should the task api which has this method return a fixed url.
I can check EM and get the URL. How does one solve this problem in code when a random task has to be opened?
Thanks
Vivek
Hi Edwin,
ReplyI am using BPEL human task API - createTask/initiateTask API in particular to create a new task. I am able to do this. Now I am trying to create a task with multiple owners - tried this using the setOwner() method on Task object and also tried comma separated owners through the payload - Both does not seem to work :(.
Hi,
you can assign to multiple groups or users but I think there can only be one process owner.
thanks
It is really nice and informative, it is useful for me. thank you
ReplyHi Edwin,
Replydid you ever try to initiate a task via the "initiateTask" web service operation?
I think I'm missing something here: I'm able to create (and submit) an initiate task instance this way, but here is no (SCA) process instance created for this task.
In addition, this works without providing credentials (as you have to do in all the other operations).
<soapenv:Envelope ...>
<soapenv:Header/>
<soapenv:Body>
<tas:initiateTask>
<task:task>
<task:title>My Task, just created</task:title>
<task:payload></task:payload>
<task:priority>3</task:priority>
<task:taskDefinitionURI>default/SimpleBPM!1.0/Humantask1</task:taskDefinitionURI>
<task:creator>weblogic</task:creator>
<task:ownerUser>weblogic</task:ownerUser>
</task:task>
</tas:initiateTask>
</soapenv:Body>
Hi,
I never, always use it with BPEL so I can react on the outcome. Initiate without bpel only works I guess in the Worklist application and in combination with BPM where WF is the starting of a process.
thanks
Hi Edwin,
ReplyDo you know if the Task Title can be updated?
Thanks,
Vivek
Hi,
I think it should be possible , you can assign it to a payload variable when you create the HWF from BPEL or try to use the TaskService WS/ EJB
thanks
Hi Edwin,
Thanks a lot for the reply.
I tried both the approaches:
- Assigning a payload variable to the title did give me the correct title after the task was initiated. However, after that when the payload variable changed (using the updateTask WS call), the task title remained the same.
- When I tried to change the Title directly using the WS call, it did not update (other attributes like priority were updated successfully).
Is there anything else I can try?
Thanks for the help,
Vivek
Hi,
I think you tried it all , maybe you can ask for a SR or ER on oracle support.
thanks
By the way,
not supported by Oracle , all data is in the WF Tasks table , find the right row with the task id as primary key and update the title.
Thanks Edwin, will try out that suggestion.
An unrelated question: What can I do so that weekends are ignored for for expiration? Do I need to create a new Calendar Rule in BPM workspace? Is there any other way?
Thanks,
Vivek
Hi Edwin,
ReplyWith Regards to Task Title, a DB update on the WFTask_TL title worked.
Thanks a ton for the tip.
- Vivek
Biemond Hello, I can not introspect the WSDL http://host:port/integration/services/TaskService/TaskServicePort?WSDL in jdev 11.1.1.6 (PS5). The endpoint is pointing to SOA 11.1.1.6 (PS5).
ReplyBut I can introspect the same endpoint in jdev 11.1.1.5 (PS4). Seems to be a product problem. Know it?
I´m using Windows 7 O.S.
Hi,
For the Task and TaskQuery Services (PS5) I had to patch the soa suite. there were some problems with the workflow xsd in jdeveloper and on the server. I had to use the patch the fabric runtime jar on the server and in jdeveloper.
thanks.
Hi Edwin,
ReplyThe post is very useful and informative.Could you please let me know how can we use the SAML configuration for these webservices.
Thanks
Hi,
Then you need to follow this http://biemond.blogspot.nl/2011/08/do-saml-with-owsm.html
So make osb business service or soa reference service with an owsm saml client policy and call the saml endpoint , on the proxy or soa service side use a username token policy, call this service and add your credentials and this will passed on to the human workflow services.
Thanks
Thanks
Hi Edwin, can we edit the task title when it going through multiple level of approvals? For eg. user A approves the task with title "Action Title ABC" and then goes to user B for review. In this case, when task goes to user B, can I have title set as "Review Title ABC"? Thanks in advance.
ReplyHi,
When I look at the Java API of humantask I can see the following methods
IWorkflowContext -> getTaskService() -> mergeAndUpdateTask and updateTask
probably the same operations for the HumanTask WebServices.
but you probably need to this yourself and listen for the approval events and call this API and set the new title.
Thanks
Hi Edwin,
ReplyHave you ever used the webservice method requestInfoForTaskWithReapproval of the TaskService ?
I am trying to use this method and all I get is this error:
INFO_REQUEST
Can you please try to invoke this service and let me know your findings?
Hi,
what is your scenario, cause for requestInfoForTaskWithReapproval you need to have multiple approvements and next user user asks an another user which already approved this task for extra information.
that user should respond with a info request and after this the next approval user can do a UpdateTaskOutcome
Thanks
Hi Edwin,
ReplySorry, to wake this thread up again, but I'm trying to invoke the SAML endpoint, with no success. Could you please advise me on how I might go about it?
Thanks
hi,
maybe this can help. but indeed it's hard
http://biemond.blogspot.nl/2011/08/do-saml-with-owsm.html
I mostly use the java api
http://biemond.blogspot.nl/2011/10/working-with-human-worklist-api-and.html
or set in the soap call
com:workflowContext
com:credential
com:login weblogic /com:login
com:password weblogic1 com:password
/com:credential
Hi Edwin ,
ReplyI need to take an action/outcome on HumanTask (need to take Reprocess Action defined in HumanTask).
Can i achive it using these web services(using UpdateTaskOutcome) .
I am able to authenticate and take a token , please let me know which operation will allow me doing the same.
Thanks in Advance :)
Waiting for your Reply
hi,
indeed with UpdateTaskOutcome you can achieve this
This comment has been removed by the author.
Thanks Edwin
It worked as suggested :) , must say Really Helpful Post
Thanks for all your earlier responses your advices have been a great support...
ReplyIn one of our requirement we have used human task with different number of stages (14 stages ) and to route the task through different stages I am using advance routing rules (30 rules),and for all this we are using only one human task component we have exposed this through bpel .
My code and process is working fine .
My question is:-
1- Do this kind of design contain flaws, is there is any restriction on using of number of stages and number of routing rules. Is there is any best practise involves which suggests that we cannot have more than certain number of stages or routing rules..??
2-Is it feasible to use different human task component for each of the human task stages and route the data using business rule, but that will be very exhausted and will unnecessarily makes bpel heavier, also the front end people need only one bpm urls this approach will make their work tedious as different number of human task component will have different urls..
Please suggest .
Thank you
Hi,
ReplyI want to test all the methods of the TaskService and TaskQueryService webservice.Can you please share any link containing all the input parameters for all the methods to test through SOAPUI.
Please Suggest
Thank You
It would be nice to have more examples on the interwebz, the info is almost non-existent and these xsd's are complex as hell
Hi Biemond
ReplyHow are you doing!
Your posts are really valuable to all of the SOA community.
I need a suggestion. We have a requirement where we have to expose the underlying TaskQueryService via OSB, both normal and SAML ports ( Prj requirement restricts the consumers to directly access the task information, so we are creating a service that talks to the underlying TaskQueryService and get the information)
My question is, can a single OSB Service cater to both the ports? As I see, while creating proxy or business services, it either asks for a port or binding. If I select a port, I can select only one port, so I'll end up with 2 OSB Projects(proxy & business services, one for each port). If I select the binding, I'll lose the information about ports, and in Business service, I'll have to specify the URL, so obviously here aswell, I will require 2 business services and corresponding 2 proxy services.
Is there a way where a single OSB Project can cater to expose both the ports? Just as how this wsdl is exposing both the ports?
Also, another thing is that we are told to use abstract wsdl as we are putting that in mds so that consumer will use it while calling our service which ultimately calls the TaskQueryService. So if the wsdl is abstract, and I create proxy service based on that, how can I expose both the ports?
Appreciate your help on this.
Regards
Ravi