What Happens When You Configure the Display Mode for a User Task How to Configure the Task Access Mode for a Guided Business Process

25 Building a Guided Business Process Client Application 25-1 25 Building a Guided Business Process Client Application This chapter explains how to build a client application to display your process instances using the milestones you defined when creating your Guided Business Process. This chapter includes the following sections: ■ Section 25.1, Introduction to Building a Guided Business Process Client Application ■ Section 25.2, Developing a Guided Business Process Client Application with Oracle ADF ■ Section 25.3, Securing the Guided Business Process Client Application ■ Section 25.4, Localizing a Guided Business Process Client Application ■ Section 25.5, Guided Business Process Run-time APIs ■ Section 25.6, Developing an Example of a User Interface for Guided Business Process Tasks Using Guided Business Process Run-Time Services ■ Section 25.7, Using Guided Business Process Logging

25.1 Introduction to Building a Guided Business Process Client Application

Guided Business Processes provide you with predefined ADF tasksflows that you can use to build an ADF application to display and run Guided Business Processes. If the provided ADF taskflows do not satisfy your requirements, then you can use the set of APIs that Guided Business Processes provide, to obtain the information that your UI client applications displays. These APIs allow you to obtain data about the milestones and tasks using web services and Enterprise Java Beans.

25.2 Developing a Guided Business Process Client Application with Oracle ADF

A Guided Business Process client application provides a user interface for the Guided Business Process task flow. The client application can be developed in a simple ADF JSPX page in any configuration. Typically, a client application includes a region displaying the Activity Guide tree and another region displaying the details of the specific node selected from the tree. 25-2 Modeling and Implementation Guide for Oracle Business Process Management One way to display these two regions is to include a dynamic region on the left side of a JSPX page and a human task flow on the right. However, any configuration is possible.

25.2.1 How to Develop a Guided Business Process Client Application

To develop a Guided Business Process client application: 1. In JDeveloper, create a new application.

2. Right-click the ViewController Project and then select Project Properties.

3. Select Libraries and Classpath.

4. Click Add JARDirectory.

A file browser dialog box opens.

5. Select the oracle.bpm.activityguide-ui.jar file located under JDEV_

HOMEjdevelopersoamodules .

6. Click Select.

7. Add the run-time shared library references oracle.soa.bpel. and

oracle.soa.workflow.wc to the weblogic-application.xml file by adding the following code: library-ref library-nameoracle.soa.bpellibrary-namelibrary-reflibrary-ref library-nameoracle.soa.workflow.wclibrary-name library-ref 8. Create a new JSF Page .jspx in which to display the Activity Guide. 9. Drag and drop the following task flows onto the JSF Page .jspx: ■ ag-tasktree-task-flow: for displaying the Activity Guide tree ■ ag-humantask-task-flow: for displaying the individual Activity Guide node

10. Create a file called activityguide.properties.

For more information on Activity Guide properties, see Section 24.7, Configuring Activity Guide Properties . If using identity propagation to secure the Activity Guide, then the properties WorkflowAdminUser and WorkflowAdminPassword are not required.

11. To enable a task flow popup with summary information, include the following

properties in the activityguide.properties file: AGTasksPopupTaskFlowID : Use this parameter to display a task flow summary in ADF dynamic regions. Enter the relevant task flow ID. If this parameter is not set then the popup shows the value of OutputText as the default task summary. If you provide an invalid task flow region ID, then the Guided Business Process does not render the region and logs a message in the server log. Note: Dragging and dropping a task flow automatically creates a region for that task flow.