How to Localize a BPMN Guided Business Process

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. Building a Guided Business Process Client Application 25-3 12. Configure the Activity Guide to display a refresh button in the Activity Guide tree., using the following alternative methods: ■ In the file activityguide.properties, add the parameter ShowRefreshButton . Set its value to true to enable the display of a refresh button, and false or any other value to disable the refresh button. ■ In the Activity Guide tree task flow, add the parameter ShowRefreshButton and set its value to true. This task flow parameter overrides the value of the parameter set in the activityguide.properties file. If the value of the ShowRefreshButton parameter is empty or null, then the property ShowRefreshButton in the file activityguide.properties defines if the refresh button is shown. If the activityguide.properties file does not specify a value for this property then the refresh button is not shown in the client. Example 25–1 illustrates adding a ShowRefreshButton parameter to the tree task flow. Example 25–1 Add the ShowRefreshButton Parameter to the Tree Task Flow taskFlow id=dynamicRegion1 taskFlowId={backingBeanScope.dynamicLeft.dynamicTaskFlowId} xmlns=http:xmlns.oracle.comadfcontrollerbinding parameters parameter id=ShowRefreshButton value=true” xmlns=http:xmlns.oracle.comadfmuimodel parameters taskFlow 13. Edit the file adfc-config.xml to include the location of the activity.properties file. This should be the absolute path to the activityguide.properties file. An example adfc-config.xml is shown in Example 25–2 . Example 25–2 adfc-config.xml File with Reference to activityguide.properties File managed-bean id=__10 managed-bean-name id=__12agPropsmanaged-bean-name managed-bean-class id=__ 11oracle.bpel.activityguide.ui.beans.model.AGPropertiesmanaged-bean-class managed-bean-scope id=__9sessionmanaged-bean-scope managed-property id=__15 property-nameagPropsFilePathproperty-name property-classjava.lang.Stringproperty-class value id=__14-- relative path or absolute path should be given here--activityguide.propertiesvalue managed-property managed-bean 14. Create a Workflow Service client configuration file. An example is shown in Example 25–3 . Example 25–3 Workflow Services Client Configuration File ?xml version=1.0 encoding=UTF-8 standalone=yes? workflowServicesClientConfiguration xmlns=http:xmlns.oracle.combpelservicesclient server default=true name=default