Segment #7 User Task

Transcription

1 Segment #7 User Task

2 Problem/Use Case How do I integrate a user review step within a BPEL process? I would like that step to be implemented by a custom web application that displays the StockReviewSheet to the user and allows the review task to be updated and completed BPEL PM Training - Slide 73

3 BPEL Concepts TaskManager Service BPEL Process receive TaskManager Service Custom Web Application invoke initiatetask( task ) Worklist Java API listtasksbyassignee ( assignee ) Worklist Page (JSP) Minutes, hours or days TaskManager (Service) lookuptask(taskid) Display Task (JSP) receive ontaskresult( task ) completetask(taskid) Complete Task (JSP) WSDL Interface invoke BPEL PM Training - Slide 74

4 BPEL Concepts TaskManager Service Interface initiatetask( task ) updatetask( task ) BPEL Business Process completetask( task ) ontaskresult( task ) TaskManager (Service) ontaskexpired( task ) WSDL Interface TaskManager.wsdl BPEL PM Training - Slide 75

5 BPEL Concepts Task Document taskmessage task element taskid (string) title (string) creationdate (datetime) creator(string) modifydate (datetime) modifier (string) assignee (string) status (active completed) expired (boolean) expirationdate (datetime) duration (duration) priority (int) customkey (string) conclusion (string) attachment (anytype) BPEL PM Training - Slide 76

6 BPEL Concepts Worklist Java API Custom Web Application initiatetask( task ) Worklist Java API listtasksbyassignee ( assignee ) Worklist Page (JSP) TaskManager (Service) lookuptask(taskid) Display Task (JSP) ontaskresult( task ) completetask(taskid) Complete Task (JSP) BPEL PM Training - Slide 77

7 BPEL Concepts Java XML Facades XML Façade (aka JAXB++): A set of Java classes, generated based on an XML Schema definition, allowing a developer to create and manipulate a DOM tree through a bean-like interface. Note: a Façade is a view; it does not duplicate the underlying DOM tree. StockReviewSheet XML Façade schemac setsymbol/getsymbol gettargetprice/settargetprice. Defined in *.wsdl or *.xsd file In the context of the UserTask segment, XML Facades make it easier for developers to manipulate (read/update) the attachment associated with a TaskMessage BPEL PM Training - Slide 78

8 BPEL Concepts Code Review The UserTask macro is composed of several BPEL activities: 1) The outer review <scope> wraps all the details 2) The configuretask <assign> activity prepares the task document (assignee, title, priority, expiration date, attachment) 3) The setpayload <assign> creates the taskmessage that will be sent to the TaskService 4) The initiatetask <invoke> sends the taskmessage to the task service and asks for a task to be added to the worklist of the assignee 5) The ontaskresult <receive> waits until the assignee completes the task 6) The readpayload <assign> reads the updated task document and updated the process variable BPEL PM Training - Slide 79

9 BPEL Designer Overview Drag User Task palette item Define Task Name Configure Task Document (assignee, priority, attachment) Build Web App UI (list, display, complete) BPEL PM Training - Slide 80

10 BPEL Designer Add User Task to Process Flow Drag and drop user task element to generate user task macro BPEL PM Training - Slide 81

11 BPEL Designer Prepare Task Document Edit copy rule to configure each element of the task document used to ask user to review loan offer BPEL PM Training - Slide 82

12 BPEL Designer Building a Java UI for Listing Tasks (I) Import the client packages associated with Worklist C:\orabpel\samples\tutorials\110.UserTasks\TaskSampleUI\listTasks.jsp Use Locator to connect to BPEL Server and get access to worklist service Retrieve list of tasks assigned to an ID BPEL PM Training - Slide 83

13 BPEL Designer Building a Java UI for Listing Tasks (II) Iterate through list of tasks and create table view C:\orabpel\samples\tutorials\110.UserTasks\TaskSampleUI\listTasks.jsp We are only interested in the tasks generated by the TaskSample BPEL process Retrieve title, id, expiration date and priority associated with the task Create link to allow user to drill down and view the details associated with a task BPEL PM Training - Slide 84

14 BPEL Designer Building a Java UI for Displaying a Task C:\orabpel\samples\tutorials\110.UserTasks\TaskSampleUI\displayTask.jsp Look up task based on task id Get a DOM reference to the Stock Review Sheet XML document Use XML Façade bean to extract information from DOM element and present it into an HTML form BPEL PM Training - Slide 85

15 BPEL Designer Building a Java UI for Updating a Task Use XML Façade bean to create a StockReviewSheet based on posted information C:\orabpel\samples\tutorials\110.UserTasks\TaskSampleUI\completeTask.jsp Attach updated StockReviewSheet to task Assign conclusion to task Mark task as completed BPEL PM Training - Slide 86

16 BPEL Console Deploy And Testing TaskSampleUI.war 2 listtasks.jsp 3 1 displaytask.jsp 5 4 Task Service completetask.jsp BPEL PM Training - Slide 87

17 Lab Exercise Lab 7: User Tasks 1. Add a manual approval step so that your user will manually approve/confirm the selected loan offer. 2. Use the UI to complete the task during testing. 3. Test and review the C:\orabpel\samples\tutorials\110.UserTasks sample to see how to build a custom UI for a user task. Extra Credit: Modify the TaskSampleUI to provide a custom web interface for your user to complete the loan offer approval step BPEL PM Training - Slide 88

18 What Did We Learn? How to include a user interaction in a BPEL process using the TaskManager service How to use the Java API of the TaskService to build a JSP that lists all the tasks assigned to a user How to use the Java API of the TaskService to build a JSP that displays the contents of a specific task How to use the Java API of the TaskService to build a JSP that updates the content of a task and marks it as completed BPEL PM Training - Slide 89

19 Related Material Building a C# app for listing, viewing and completing tasks Using LDAP for assignment/escalation notification The TaskManager Java API and JTA (see BPEL-TN006 regarding crash testing BPEL PM) BPEL PM Training - Slide 90