13.4 Using the BPEL Processes Tab to Manage a Process Life Cycle

The BPEL Processes tab displays process life cycles and states, including the version numbers of BPEL processes that are currently active. An asterisk identifies the default process.

Figure 13-4 shows the BPEL Processes tab for the SelectManufacturer process in the SOA Order Booking application.

Figure 13-4 Oracle BPEL Control: The BPEL Processes Tab for the SelectManufacturer Process

Description of "Figure 13-4 Oracle BPEL Control: The BPEL Processes Tab for the SelectManufacturer Process"

Use the following links on the BPEL Processes tab to do related tasks:

• Clear WSDL Cache: Clears the cache for all WSDLs of the selected domain

• Deploy New Process: Deploys BPEL processes from Oracle BPEL Control instead of using Oracle JDeveloper

• Perform Manual Recovery: Performs a manual recovery of messages. For example, if you are using the file adapter and your system server crashes while inbound messages are being processed, you can manually recovery undelivered messages when the server is restarted. If a file has ten messages and the server crashes after three messages have been processed, then the fourth message is not delivered. When the server restarts and begins processing with message five (the offset of the last successfully rejected message), you can manually recover the fourth message.

• Refresh Alarm Table: Refreshes the alarm table for the selected domain. This registers all pending wait/onAlarm activities with the system.

• View Process Log: Shows the events of all BPEL processes in the selected domain (for example, when a process was compiled, undeployed, or marked as the default instance)

13.4.1 How to Manage a Process Life Cycle

Use the BPEL Processes tab to manage a process life cycle.

To manage the process life cycle:

1. Click the BPEL Processes tab.

2. Click a specific process in the BPEL Process list.

3. Use the Manage tab to manage the life cycle and state of the BPEL process.

   See Section 13.4.2, "How to Manage a Specific Process" for more information.

13.4.2 How to Manage a Specific Process

Figure 13-5 shows the BPEL Processes tab after you select the SelectManufacturer process.

Figure 13-5 Oracle BPEL Control: The Manage Page of the BPEL Processes Tab

Description of "Figure 13-5 Oracle BPEL Control: The Manage Page of the BPEL Processes Tab"

Use the following links on the BPEL Processes tab to manage the SelectManufacturer process:

• Manage: (Displayed in the figure.) For each BPEL process, Oracle BPEL Control provides the following status indicators.

  • Process Life Cycle: A process life cycle can be active or retired. If the process life cycle is retired, you cannot create a new instance.

  • Process State: A process state can be on or off. If the process state is off, you cannot access instances or create new ones.

  • Default Revision: The designated process and revision that is instantiated when a new request comes in. There is only one default process, identified by an asterisk. If you retire a default process, the default does not change to another process. The retired process remains the default. You must explicitly select a new default process.

    Designating a process as the default works as follows: If you deploy version 1.0 of a BPEL process, it is displayed as the default process in Oracle BPEL Control. If you deploy version 2.0 of that process, it is displayed as the default. If you redeploy version 1.0 of the same process, it is again displayed as the default.

  • Undeploy the BPEL Process: Undeploy removes all traces of the process from the system. You cannot view previously completed processes. Instances belonging to this process are usually purged before undeploying a process. Undeploying the only version of a process (which is also the default) results in the complete removal of this process.

• Initiate: Use this page to run processes from the BPEL Processes tab. This is the same window that displays when you click a process in the Deployed BPEL Processes list of the Dashboard tab.

• Descriptor: Use this page to view and change deployment descriptor bpel.xml file properties of a BPEL process at runtime. This prevents you from having to reset these properties during design time and redeploy the BPEL process. See Oracle BPEL Process Manager Developer's Guide for information about deployment descriptor properties.

• WSDL: Use this page to view the WSDL file contents for a process.

• Sensors: Use this page to view the fault, activity, and variable sensor data of a process.

• Source: Use this page to view the BPEL file contents of a process

• Test Suites: Use this page to run the test cases of a test suite on a BPEL process instance and view XML document reports. By default, report results are formatted as JUnit XML test results. See Oracle BPEL Process Manager Developer's Guide for more information about test suites.

• Reports: Use this page to create reports in Oracle BPEL Control that enable you to

  • Receive an overall view of business process instance performance

  • Analyze data for the BPEL process instances and make critical decisions

  • Analyze data of the activities that constitute a business process

  • Identify and debug faults and take appropriate corrective actions

  See Oracle BPEL Process Manager Developer's Guide for more information on Oracle BPEL Control reports.