6 Importing BPMN Processes from a BPA Repository

This chapter describes how to create a BPM project using a BPMN process stored in a BPA repository. Importing BPA projects to Oracle BPM enables Process analysts to develop a project using Oracle BPA and then hand it over to process developers for them to complete the implementation details using Oracle BPM Studio.

This chapter includes the following sections:

6.1 Introduction to Importing Processes from the BPA Repository

Oracle BPM Studio enables you to create a BPM project based on a BPMN process stored in a BPA repository.

You can create and implement a BPMN process in BPA and then import it to Oracle BPM. This creates a BPM Project that contains the BPMN process and all of the components used to implement it, such as Human Tasks, Service Adapters and Mediators.

Figure 6-1 shows a BPMN model of the Sales Quote example implemented in BPA.

Figure 6-1 BPMN Model of the Sales Quote example process implemented using BPA Architect

Description of Figure 6-1 follows
Description of "Figure 6-1 BPMN Model of the Sales Quote example process implemented using BPA Architect"

6.2 Creating a BPM Project from a BPA Project

You can create a BPMN model using the BPA Architect application and import it to Oracle BPM. Oracle BPM Studio creates a BPM project that contains the BPMN process you selected and the components used to implement the activities in the BPMN model.

Before importing a BPA project to BPM, ensure your BPA project respects the following rules:

  • If the Catalog and Repository information are missing in the BPA project, then the process created by importing the BPA project to Oracle BPM contains unimplemented business rule tasks.

  • If the Human Tasks in the BPA project are not associated with a swimlane, then importing the BPA project to Oracle BPM causes an error because the Human Task is not associated with a valid role.

  • It does not contain nested subprocesses.

Table 6-1 shows how the different BPA constructs are translated to BPMN constructs when importing a project. Gateways and events remain the same. Note that since Oracle BPM Suite does not support pools and message flows, you can only translate one BPA tool at a time.

Table 6-1 Correspondence Between BPA and BPMN constructs

BPA Construct BPMN Construct

Automated Activity

Service Task

Human Task

User Task

Rules Task

Rules Task

Notification Task

FYI Task


6.2.1 How to Configure a BPA Project to Use It from Oracle BPM

If you want to use a BPA project to create a BPM project in Oracle BPM, then you must configure your BPA project to access it from Oracle BPM.

To configure a BPA project to use it from Oracle BPM:

  1. In the BPA Application, select SOA.

  2. Select Share Blueprint.

    A validation dialog appears.

  3. Click Yes to validate the project, or No to continue without validating.

    A dialog that displays the progress of the conversion appears.

  4. Click OK.

6.2.2 How to Create a BPM Project from a BPA Project

Before following this procedure ensure that your BPA project is configured to use it from Oracle BPM. See Section 6.2.1, "How to Configure a BPA Project to Use It from Oracle BPM" for information on how to configure a BPA project to use from Oracle BPM.

To create a BPM project from a BPA project:

  1. In Oracle BPM Studio, select File and then select New.

    The New Gallery dialog appears.

  2. In the Categories tree, select BPM Tier.

  3. In the Items list, select Create Project from BPA.

  4. Click OK.

    The Create Project from a BPA Project wizard appears.

  5. Enter a name to identify the BPM project.

  6. Enter a directory to store the project, or click the browse button to browse and select one.

  7. Click the Browse button next to the BPA Server field.

    The Create BPA Blueprint Composite dialog appears.

  8. If the BPA Servers list is empty, then you must add a new BPA server.

    See Section 6.2.3, "How to Add a BPA Server" for information on how to add a BPA server.

  9. In the BPA Servers list, expand a server node and its subfolders until the BPMN processes appear.

  10. Select a BPMN process.

  11. Click OK.

    The Create BPA Blueprint Composite dialog closes and the selected server appears in the Server field.

  12. Click OK.

    The Summary page appears.

  13. Click OK.

    The BPM project you created from the BPMN model you selected from the BPA repository appears in Oracle BPM Studio.

    Note:

    You must configure the implementation of certain BPMN flow objects, such as gateways, business rules, and human tasks, in a BPM project created from a BPA project. Not doing so causes errors when building the BPM Project.

6.2.3 How to Add a BPA Server

You must define a BPA server from which Oracle BPM obtains the BPA project. After you define a BPA server you can reuse it for all the BPA projects that reside in that BPA server to import them to Oracle BPM.

To add a BPA server:

  1. Click the Create BPA Server Connection button.

    The BPA Server Connection dialog appears.

  2. In the Name field, enter a name to identify the connection.

  3. From the Location list, select the type of location that corresponds to your BPA Architect configuration.

    The available location types are:

    • Local Server: the BPA Architect application directly connects to the BPA repository.

    • Remote Server: the BPA Architect application connects to BPA repository server, which in turn connects to the BPA repository.

  4. From the Database list, select the database that contains the BPMN process.

  5. From the Locale list, select the locale of your BPA project.

  6. In the Username field, enter the username for the BPA Architect user.

  7. In the Password field, enter the password for the BPA Architect user.

  8. If you want to test the connection, then you must click the Test tab and then click Test Connection.

    The Connection Diagnosis field shows you a message with the result of the test.

  9. Click OK.

    The BPA Server Connection dialog closes and the new connection appears in the BPA Servers list in the Create BPA Blueprint Composite dialog.

6.2.4 What Happens When You Create a BPM Project from a BPA Project

Oracle BPM Studio creates a BPM project that contains the BPMN model you chose to import. The BPMN project contains an SOA Composite with the components used to implement the BPMN model such as Human Tasks, Service Adapters, and Mediators. These components also appear in the business catalog as any component in the SOA Composite. See Chapter 9, "Using the Business Catalog" for more information on how components are organized in the business catalog.

Note that you must configure the implementation of certain BPMN flow objects, such as gateways, business rules, and human tasks, in a BPM project created from a BPA project. Not doing so, causes errors when building the BPM Project.

6.3 Merging Changes from an Updated BPA Model

After you create a BPMN process based on a BPA model you can make changes to the BPA model and then update the BPMN process.

Oracle BPM Studio shows the difference between your local BPMN process and the BPMN process that results from importing the updated BPA model, using a graphic. After looking at the graphic you can choose to accept the changes or discard them.

6.3.1 How to Merge Changes from an Updated BPA Model

After updating a BPA model that you used to create a BPMN process, you can update the BPMN process to reflect the changes in the BPA process. The resulting BPMN process shows all the changes you made to the BPA process.

To merge changes from an updated BPA model:

  1. In the Project Navigator tree, right-click the BPMN process that you imported from the BPA server.

  2. Select Refresh from BPA.

    The Process Differ dialog appears. Figure 6-2 shows an example of the Process Differ dialog.

  3. Click OK to accept the changes.

Figure 6-2 Process Differ Dialog

Shows the Process Differ dialog.

6.3.2 What Happens When You Merge the Changes from an Updated BPA Model

The updated BPMN process shows all the changes you made to the BPA model. The merge only affects the BPMN process and not the rest of the artifacts in the BPM project.

If you want to revert the changes, close the BPMN process without saving the changes.