H Oracle BPEL Process Manager and Oracle Workflow Integration

H.5.1 Creating an Oracle Workflow Partner Link

1. Drag and drop a PartnerLink activity onto the designer window.

2. Enter the following values to create an Oracle Workflow partner link. For the WSDL File field, click the flashlight (the second icon from the left named WSIL Browser) to access the WSDL Chooser window.

   
   Description of the illustration owb_pl.gif
   
   

   Field	Value
   Name	owf
   WSDL File	Access the Oracle Workflow data source URL by clicking the WSIL Browser flashlight icon and expanding and selecting server_connection, then adapters, then owf, then jdbc/ejb/OracleBPEL, and then WFDEMO. where server_connection is the name of the Oracle BPEL Server connection. Your selection here completes the directory path to this URL.
   Partner Link Type	owfBridgePortTypeLink
   My Role	receivePortTypeProvider
   Partner Role	invokePortTypeProvider

   
   

   The window now appears as follows:

   
   Description of the illustration owb_pa5.gif
   
   

3. Click OK.

4. Select Save from the File main menu.

H.5.2 Creating Invoke and Receive Activities

1. Drag and drop an Invoke activity from the Component Palette section.

2. Double-click the invoke icon to display the Invoke window.

3. Enter the following details:

   Field	Value
   Name	invokeOWF
   Partner Link	owf

   
   

   The Operation (invokeProcess) field is automatically filled in.

4. Click the first icon to the right of the Input Variable field. This is the automatic variable creation icon.

5. Click OK on the Create Variable window that appears.

   A variable named invokeOWF_invokeProcess_InputVariable is automatically created in the Input Variable field.

6. Click the first icon to the right of the Output Variable field.

7. Click OK on the Create Variable window that appears.

   A variable named invokeOWF_invokeProcess_OutputVariable is automatically created in the Output Variable field.

8. Click OK.

9. Drag and drop a Receive activity below the invokeOWF Invoke activity you just created.

10. Double-click the receive icon to display the Receive window.

11. Enter the following details:

    Field	Value
    Name	receiveOWF
    Partner Link	owf

    
    

    The Operation (receiveProcess) field is automatically filled in.

12. Click the first icon to the right of the Variable field.

13. Click OK on the Create Variable window that appears.

    A variable named receiveOWF_receiveProcess_InputVariable is automatically created in the Variable field.

14. Click OK.

15. Select Save from the File main menu.

H.5.3 Creating an Assign Activity with Multiple Statements

You now create an assign activity with multiple statements to copy all data to the input variable you automatically created in Step 4. An example of the assign section of the BPEL file as it appears after you create this assign activity is shown in Step 35.

If necessary for your environment, change the isAsync value described in Step 8, the OWFDataSource value described in Step 11, and the attribute value described in Step 30.

1. Drag and drop an Assign activity from the Component Palette section to above the invokeOWF Invoke activity you just created.

2. Double-click the assign icon to display the Assign window.

3. Click the General tab.

4. Enter assignOWF in the Name field.

5. Click Apply.

6. Click the Copy Rules tab.

7. Click Create to display the Create Copy Rule window.

8. Enter the following details:

   Field	Value
   From
   Type	Expression
   Expression	boolean(false) Note: Press Ctrl and then the space bar to display a list for selecting (double-clicking) this syntax. The namespace number values (for example, ns1, ns2) can vary. Use the namespace values that automatically appear. Remove any trailing forward slashes (/) that appear at the end.
   To
   Type	Variable
   Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:isAsync

   
   

9. Click OK to close the Create Copy Rule window.

10. Click Create to return to the Create Copy Rule window and create a second copy rule statement.

11. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	string('jdbc/ejb/OracleBPEL') where 'jdbc/ejb/OracleBPEL' represents the data source.
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:OWFDataSource

    
    

12. Select Save from the File main menu.

13. Click OK to close the Create Copy Rule window.

14. Click Create to return to the Create Copy Rule window and create a third copy rule statement.

15. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	ora:getDomainId()
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:processDomain

    
    

16. Click OK to close the Create Copy Rule window.

17. Click Create to return to the Create Copy Rule window and create a fourth copy rule statement.

18. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	ora:getProcessId()
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:processID

    
    

19. Click OK to close the Create Copy Rule window.

20. Click Create to return to the Create Copy Rule window and create a fifth copy rule statement.

21. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	ora:getProcessVersion()
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:revisionTag

    
    

22. Click OK to close the Create Copy Rule window.

23. Click Create to return to the Create Copy Rule window and create a sixth copy rule statement.

24. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	string('owf')
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:partnerLink

    
    

25. Click OK to close the Create Copy Rule window.

26. Click Create to return to the Create Copy Rule window and create a seventh copy rule statement.

27. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	ora:getInstanceId()
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:instanceID

    
    

28. Click OK to close the Create Copy Rule window.

29. Click Create to return to the Create Copy Rule window and create an eighth copy rule statement.

30. Enter the following details:

    Field	Value
    From
    Type	Variable
    Variables	Expand and select Variables, then input, then client:OWFDemo1ProcessRequest, and then client:input
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, and then ns1:attribute

    
    

31. Click OK to close the Create Copy Rule window.

32. Click Create to return to the Create Copy Rule window and create a ninth copy rule statement.

33. Enter the following details:

    Field	Value
    From
    Type	Expression
    Expression	string('procName') where 'procName' represents the process identity type.
    To
    Type	Variable
    Variables	Expand and select Variables, then invokeOWF_invokeProcess_InputVariable, then ns1:inputElement, then ns1:WFHeader, and then ns1:OWFProcess

    
    

34. Select Save from the File main menu.

35. Click the BPEL file in the Applications Navigator and select Source.

The assign section of the BPEL file now appears as follows:

<assign name="assignOWF">
  <copy>
    <from expression="boolean(false)"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:isAsync"/>
  </copy>
  <copy>
    <from expression="string('jdbc/ejb/OracleBPEL')"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:OWFDataSource"/>
  </copy>
  <copy>
    <from expression="ora:getDomainId()"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:processDomain"/>
  </copy>
  <copy>
    <from expression="ora:getProcessId()"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
  query="/ns1:inputElement/ns1:WFHeader/ns1:processID"/>
  </copy>
  <copy>
    <from expression="ora:getProcessVersion()"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:revisionTag"/>
  </copy>
  <copy>
    <from expression="string('owf')"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:partnerLink"/>
  </copy>
  <copy>
    <from expression="ora:getInstanceId()"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:instanceID"/>
  </copy>
  <copy>
    <from variable="input" part="payload" query="/client:OWFDemo1ProcessRequest/client:input"/>
<to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:attribute"/>
  </copy>
  <copy>
    <from expression="string('procName')"/>
    <to variable="invokeOWF_invokeProcess_InputVariable" part="invokeInputMessage"
 query="/ns1:inputElement/ns1:WFHeader/ns1:OWFProcess"/>
  </copy>
</assign>

H.5.4 Correlating the Actions of the Invoke and Receive Activities

If this is a synchronized Oracle Workflow call (that is, you created a receive activity), you must add a correlation set for the BPEL process to receive the correct message from Oracle Workflow processes.

1. Go to the Structure section in the lower left section of JDeveloper BPEL Designer.

2. Right-click Properties and select Create Property.

3. Enter the following details:

   Field	Value
   Name	itemKeyProperty
   Type	Click the flashlight icon and select string

   
   

4. Click OK to close the Type Chooser window and Create Correlation Set Property window.

5. Right-click Property Aliases in the Structure section and select Create Property Alias.

   The Create Property Alias window appears.

6. Enter the following details:

   Field	Value
   Property	itemKeyProperty
   Message Type Part	Expand and select WFProcessIDMessage
   Query	Select ns1:WFProcessIDElement, then ns1:WFProcessIDElement, and then ns1:itemKey

   
   

   The window now appears as follows:

   
   Description of the illustration owb_pa.gif
   
   

7. Click OK.

8. Right-click Property Aliases again and select Create Property Alias.

9. Enter the following details:

   Field	Value
   Property	itemKeyProperty
   Message Type Part	Expand and select Part - receiveMessage
   Query	Press Ctrl and then the space bar to select ns1:outputElement, then ns1:WFProcessID, and then ns1:itemKey

   
   

   The window now appears as follows:

   
   Description of the illustration owb_pa2.gif
   
   

10. Click OK.

    This correlation set is used in the invoke and the receive activities you just created.

11. Double-click the invokeOWF Invoke activity.

12. Click the Correlations tab.

13. Click Add.

14. Click Correlations Sets, then Create on the Correlation Set Chooser window.

15. Enter owfIdentifier in the Name field of the Create Correlation Set window.

16. Click Add.

17. Select itemKeyProperty on the Property Chooser window and click OK.

18. Click OK on the Create Correlation Set window and the Correlation Set Chooser window.

19. Select Yes in the Initiate column of the Invoke window. This is because the correlation is initiated here.

20. Select in in the Pattern column because this is the output variable of the invoke activity.

    
    Description of the illustration owb_pa3.gif
    
    

21. Double-click the receiveOWF Invoke activity.

22. Click the Correlations tab.

23. Click Add.

24. Click owfIdentifier on the Correlation Set Chooser window.

25. Ensure that No is the value in the Initiate column of the Receive window.

    When complete, the designer window looks as follows:

    
    Description of the illustration owb_pa4.gif
    
    

26. Select Save from the File main menu.