48 Using Two-Layer Business Process Management (BPM)

48.2.1 Creating a Phase Activity

You add a Phase to a process declaratively by using the BPEL Designer in Oracle JDeveloper just as you would any other BPEL activity—by dragging and dropping it from the BPEL Activities and Components palette to the process model.

Figure 48-2 Phase Activity in BPEL Designer

Description of "Figure 48-2 Phase Activity in BPEL Designer"

48.2.2 How to Create a Phase Activity

You create the Phase activity for your composite application after you have created the necessary variables as described in "Creating Variables".

Once the Phase is dropped into the level-1 BPEL process, a wizard guides you through the various configuration steps. It first displays the Create Phase Activity dialog, in which you specify the input and the output of the Phase.

To create a Phase activity:

In the Create Phase Activity dialog:

1. Enter a value in the Name field.

2. Select the Inputs and Outputs icon, which is a green plus sign (+). The Variable Chooser dialog appears.

3. Select Process, Variables, and phaseIn, and then click OK. The Phase dialog box is displayed with the phaseIn variable populated.

4. From the Inputs and Outputs icon, select Select Output. The Variable Chooser dialog box appears.Select Process, Variables, and phaseOut.

5. Click OK. The Phase dialog box is displayed with the input and output variable names populatedClick OK. The BPEL Designer displays the .bpel page for your process.

6. Click Save All from the File menu. Close the .bpel page.

7. Click the composite.xml page. The SCA composite diagram appears.

48.2.3 What Happens When You Create a Phase Activity

When you create a Phase activity, the artifacts described in Table 48-2 are created.

48.2.4 What Happens at Runtime When You Create a Phase Activity

At runtime, the input of the Phase activity is used to evaluate the dynamic routing decision table. This is performed by a specific decision component of the Phase activity. The result of this evaluation is an instruction for the Mediator. The Mediator routes the request to a service based on instructions from the decision component.

48.2.5 What You May Need to Know About Creating a Phase Activity

When creating a phase activity, you need to know the following:

• Rules that you will need to either configure or create in the decision service. This will be based on data from payload that you will use to evaluate a rule.

• For each rule created in the decision service, you need to know the corresponding endpoint URL that needs to be invoked when a rule evaluates to true. This endpoint URL will be used by Mediator to invoke the service in layer 2.

48.3.1 How to Create the Routing Decision Table

After you have created the Phase activity, the wizard launches the Rule Designer in Oracle JDeveloper for you edit the Routing Decision Table. Figure 48-3 shows a sample decision table within rule designer.

Figure 48-3 Sample Decision Table

Description of "Figure 48-3 Sample Decision Table"

You can leave the decision table empty while modeling the level-2 process phases, and complete it after the level-1 process is being deployed using the Business Analyst tool.

Once you have created and edited the Routing Decision Table, the new level-1 phase activity appears in the BPEL process in Oracle JDeveloper as illustrated in Figure 48-4.

Figure 48-4 Completed Level-1 Phase in Oracle JDeveloper

Description of "Figure 48-4 Completed Level-1 Phase in Oracle JDeveloper"

48.3.2 What Happens When You Create the Routing Decision Table

By creating the Routing Decision Table, you are configuring the decision service to dynamically evaluate the conditions applied to the incoming payload and give the corresponding routing rules to the Mediator. The Mediator then executes these rules when invoking the service in layer 2.

More specifically, here is what happens at design time when you create the Routing Decision Table:

• A new decision component is created in the composite of the project.

• A new rule dictionary is created in the composite project directory.

• The rule dictionary is populated with a data model that reflects the data model of the phase input—that is, the XML schema of the Phase input is imported into the rule dictionary.

48.4.1 Designing the SOA Composite

You design the SOA composite application in JDeveloper.

To design the SOA composite:

1. In JDeveloper, select New from the File menu. The New Gallery dialog box appears.

2. Click OK. The Create Application dialog box appears.

3. Enter LoanFlowRouterApp in the Application Name field, and then click OK. The Create Project dialog box appears.

4. Click Cancel in the Create Project dialog box.

5. Right-click the LoanFlowRouterApp menu and select New Project. The New Gallery dialog box appears.

6. Select SOA Project from the Items list and click OK. The Create SOA Project dialog box appears.

7. Enter LoanFlowRouter in the Project Name field and select Composite With BPEL in the Composite Template list, and click OK. The Create BPEL Process page appears.

8. Enter LoanFlowRouterProcess in the Name field of the Create BPEL Process page and select Asynchronous BPEL Process from the Template list. Click OK.

9. Import the AutoLoanTypes.xsd schema into the project xsd folder. The AutoLoanTyped.xsd schema is as follows:

   <?xml version="1.0"?>
   <xsd:schema attributeFormDefault="qualified" elementFormDefault="qualified"
   <xsd:schema attributeFormDefault="qualified" elementFormDefault="qualified"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   targetNamespace="http://www.autoloan.com/ns/autoloan"
   xmlns:tns="http://www.autoloan.com/ns/autoloan">
   <xsd:element name="loanApplication" type="tns:LoanApplicationType"/>
   <xsd:element name="loanOffer" type="tns:LoanOfferType"/>
   <xsd:element name="invalidApplication" type="tns:InvalidApplicationType"/>
   <xsd:element name="loan" type="tns:LoanType"/>
   <xsd:complexType name="InvalidApplicationType">
   <xsd:sequence>
   <xsd:element name="error" type="xsd:string"/>
   <xsd:element name="application" type="tns:LoanApplicationType"/>
   </xsd:sequence>
   </xsd:complexType>
   <xsd:complexType name="LoanType">
   <xsd:sequence>
   <xsd:element ref="tns:loanApplication"/>
   <xsd:element ref="tns:loanOffer"/>
   </xsd:sequence>
   </xsd:complexType>
   <xsd:complexType name="LoanApplicationType">
   <xsd:sequence>
   <xsd:element name="SSN" type="xsd:string"/>
   <xsd:element name="email" type="xsd:string"/>
   <xsd:element name="customerName" type="xsd:string"/>
   <xsd:element name="loanAmount" type="xsd:double"/>
   <xsd:element name="carModel" type="xsd:string"/>
   <xsd:element name="carYear" type="xsd:string"/>
   <xsd:element name="creditRating" type="xsd:int"/>
   </xsd:sequence>
   </xsd:complexType>
   <xsd:complexType name="LoanOfferType">
   <xsd:sequence>
   <xsd:element name="providerName" type="xsd:string"/>
   <xsd:element name="selected" type="xsd:boolean"/>
   <xsd:element name="approved" type="xsd:boolean"/>
   <xsd:element name="APR" type="xsd:double"/>
   </xsd:sequence>
   </xsd:complexType>
   </xsd:schema>
   

10. After importing the AutoLoanTypes.xsd schema, open the LoanFlowRouterProcess.bpel page.

Creating Variables

1. Click the Variables... icon. The Variables dialog box appears.

2. Click the Create...Alt+N icon. The Create Variable dialog box appears.

3. Enter phaseIn in the Name field. Click the Element option.

4. Click the Browse Elements icon. The Type Chooser dialog box is displayed.

5. Select Project Schema Files, AutoLoanTypes.xsd, and loanApplication, and then click OK. The Create Variable dialog box appears with the element name populated.

6. Click OK. The Variables dialog box is displayed with the variable name populated.

7. Click the Create...Alt+N icon in the Variables dialog box. The Create Variable dialog appears.

8. Enter phaseOut in the Name field. Click the Element option. Click the Browse Elements icon. The Type Chooser dialog appears.

9. Select Project Schema Files, AutoLoanTypes.xsd, and loanOffer, and then click OK. The Create Variable dialog box appears with the element name populated.

10. Click OK. The Variables Dialog box is displayed with the input and output variable names populated.

11. Click OK. The variables have been created and the LoanFlowRouterProcess.bpelpage appears.

48.4.2 Creating a Phase Activity

You create the Phase activity by using JDeveloper.

To create a Phase activity:

1. Click the LoanFlowRouterProcess.bpel page. Drag and drop a Phase activity from the BPEL component palette into the process model. The Phase dialog box appears.

2. Enter routeToLoanApplication in the Name field. From the Inputs and Outputs plus icon, select Select Input. The Variable Chooser dialog box appears.

3. Select Process, Variables, and phaseIn, and then click OK. The Phase dialog box is displayed with the phaseIn variable populated.

4. Select Select Output from the Inputs and Outputs plus icon. The Variable Chooser dialog box is displayed.

5. Select Process, Variables, and phaseOut.

6. Click OK. The Phase dialog box is displayed with the input and output variable names populated.

7. Click OK. The LoanFlowRouterProcess.bpel page is displayed.

8. Click Save All from the File menu. Close the LoanFlowRouterProcess.bpel page.

9. Click the composite.xml page. The SCA composite diagram is displayed.

48.4.3 Creating and Editing the Dynamic Routing Decision Table

You create and edit the Dynamic Routing Decision Table by using Oracle JDeveloper.

To create and edit the Dynamic Routing Decision Table:

1. Open the LoanFlowRouterProcess.bpel page. Double-click the Phase activity in the process diagram. The Phase dialog box appears.

2. Click the Edit Dynamic Rules button. The Rule Designer page appears.

3. Click Ruleset_1 under Rulesets from the Types list. The Ruleset_1 page with an empty RoutingTable appear.

4. Click the arrow under Conditions and select loanAmount from the list. The text field above the list is populated with LoanApplicationType.loanAmount.

5. Right-click the loanApplicationType.loanAmount condition and select Edit Local List of Ranges. The Edit Bucketset dialog box is displayed.

6. Click the Click to add “Less Than Or Equal” Range-Position icon (first blue icon) beside Range Editor. The value 0 is displayed at the center of the range axis (the default range is -10000 to 100000).

7. Enter 0 in the Minimum field and 100000 in the Maximum field. The Minimum and Maximum fields are populated with the new values.

8. Click one of the interval icons in the Range Editor and create a range of 0 to 200000.

   Tip:

   To adjust a range, move it with the mouse along the range axis or click into the range icon, type a value, and press Enter on the keyboard.

9. Click one of the interval icons in the Range Editor and create a range of 200000 to 500000. Click OK. The RoutingTable page is displayed.

10. Right-click the LoanApplicationType.loanAmount condition and select Split Condition. The new rule columns, such as R1, R2, R3 and R4, are displayed with conditions according to the bucketset definition of the loanAmount attribute.

11. Click the plus icon in the RoutingTable page and select Add Actions and then assert new from the list. The Create Action dialog box is displayed.

12. Enter some default values for the fact type attributes. Select the Parameterized option for the serviceBindingInfo attribute.

13. Click OK. The RoutingTable page is displayed with Actions defined for the rules R1-R4.

14. Enter the values for the parametrized attributes of the Actions. See Table 48-3 for the values to be entered. This completes editing the RoutingTable page.

    Table 48-3 Attributes for the RoutingAction Fact Type

    Attribute	Default	Fixed	Parametrized	Required	Description
    caseName		No	Yes	No	Some descriptive text (used in Mediator mplan)
    cbkOperation	null	Yes	No	No
    executionType	direct	Yes	No	Yes	Execution type can be “direct” or “queued”
    onCbkOperation		No		Yes	Callback operation
    serviceBindingInfo		No	Yes	Yes	Service endpointURL
    serviceOperation		No	Yes	Yes	Service operation
    serviceReference		No	Yes	Yes	Service reference

    
    

15. Click the LoanFlowRouterProcess.bpel page. Click OK in the Phase dialog.

16. Click the composite.xml page. The SCA composite diagram appears after the Routing Table has been created and edited.

17. Click Save All from the File menu. Close the composite.xml page.

48.4.4 Adding Assign Activities to the BPEL Process Model

Before deploying the Phase activity, you must initialize the Phase variables. You do this by adding Assign activities in the phase in the BPEL process.

To add Assign activities to the BPEL Process Model

1. Click the LoanFlowRouterProcess.bpel page. Drag and drop an Assign activity from the BPEL component palette into the process model between the receiveInput activity and the Phase activity. The Assign activity is added to the process model.

2. Double-click the Assign activity. The Assign dialog box is displayed.

3. Enter AssignInput in the Name field in the General tab.

4. Select the Copy Operation tab. Click the plus icon and select Copy Operation from the list. The Create Copy Operation dialog appears.

5. Create an input copy operation for 12345.

6. Similar to Step 5, create the copy operations mentioned in the following table:

   Table 48-4 Copy Operations for Adding Assign Activities

   From	To
   'scott.tiger@oracle.com'	phaseIn/ns1:loanApplication/ns1:email
   inputVariable/payload/client:LoanFlowRouterProcessProcessRequest/client:input	phaseIn/ns1:ratingrequest/ns1:customerName
   number(15000.0)	phaseIn/ns1:loanApplication/ns1:loanAmount
   'BMW'	phaseIn/ns1:loanApplication/ns1:carModel
   '2000'	phaseIn/ns1:loanApplication/ns1:carYear
   number(300	phaseIn/ns1:loanApplication/ns1:creditRating

   
   

7. Click OK in the Create Copy Operation dialog. The Assign dialog box appears with the input copy operation values populated.

8. Click OK. The LoanFlowRouterProcess.bpel page is displayed again.

9. Drag and drop another Assign activity from the BPEL component palette into the process model between the Phase activity and the callbackClient activity. The new Assign activity is added to the process model.

10. Double-click the Assign activity. The Assign dialog box is d.isplayed.

11. Enter AssignOutput in the Name filed in the General tab.

12. Select the Copy Operation tab. Click the plus icon and select Copy Operation from the list. The Create Copy Operation dialog appears.

13. Create the output copy operation.

14. Click OK in the Create Copy Operation dialog box. The Assign dialog box is displayed with the output copy operation value populated.

15. Click OK. The LoanFlowRouterProcess.bpel page appears after the input and output Assign activities are created.

16. Click Save All from the File menu.

48.4.5 Deploying the Sample with JDeveloper

You need to deploy the application profile for the SOA project and application you created in the earlier steps. Steps to deploy the profile using JDeveloper are:

• Creating an Application Deployment Profile

• Creating an Application Server Connection

• Deploying the Application