1. Developing SOA Applications with Oracle SOA Suite
  2. Using the BPEL Process Service Component
  3. Manipulating XML Data in a BPEL Process
  4. Delegating XML Data Operations to Data Provider Services
  5. How to Create an Entity Variable
  6. Creating a Binding Key

Creating a Binding Key

You now create a key to point to the order data in the Oracle ADF Business Component data provider service.

To create a binding key:

  1. In the Components window, expand Oracle Extensions.
  2. Scroll down to the SDO section.
  3. Drag a Bind Entity activity into your BPEL process service component. Figure 6-4 provides details.

    Figure 6-4 Bind Entity Activity in the Components Window

    Description of Figure 6-4 follows
    Description of "Figure 6-4 Bind Entity Activity in the Components Window"

    The Bind Entity dialog appears.

  4. In the Name field, enter a name.
  5. To the right of the Entity Variable field, click the Search icon.

    The Variable Chooser dialog appears.

  6. Select the entity variable created in Creating an Entity Variable and Choosing a Partner Link and click OK.
  7. In the Unique Keys section, click the Add icon.

    The Specify Key dialog appears. You use this dialog to create a key for retrieving the order ID from the Oracle ADF Business Component data provider service.

  8. Enter the details described in Table 6-2 to define the binding key:

    Table 6-2 Specify Key Dialog Fields and Values

    Field Value

    Key Local Part

    Enter the local part of the key.

    Key Namespace URI

    Enter the namespace URI for the key.

    Key Value

    Enter the key value expression. This expression must match the type of a key. The following examples show expression value keys for a POID key:

    • $inputMsg.payload/tns:poid

    • bpws:getVariableData('inputmsg','payload','tns:poid')

    The POID key for an entity variable typically comes from another message. If the type of POID key is an integer and the expression result is a string of ABC, the string-to-integer fails and the bind entity activity also fails at runtime.

    Figure 6-5 shows the Specify Key dialog after completion.

    Figure 6-5 Specify Key Dialog

    Description of Figure 6-5 follows
    Description of "Figure 6-5 Specify Key Dialog"
  9. Click OK to close the Specify Key dialog.

    A name-pair value appears in the Unique Keys table, as shown in Figure 6-6. Design is now complete.

    Figure 6-6 Bind Entity Dialog

    Description of Figure 6-6 follows
    Description of "Figure 6-6 Bind Entity Dialog"
  10. Click OK to close the Bind Entity dialog.

    After the Bind Entity activity is executed at runtime, the entity variable is ready to be used.

For more information about using SDOs, see Publishing Service-Enabled Application Modules in Developing Fusion Web Applications with Oracle Application Development Framework. This guide describes how to expose application modules as web services and publish rows of view data objects as SDOs. The application module is the ADF framework component that encapsulates business logic as a set of related business functions.