6 Integration With BPM Service Components in the Oracle SOA Suite

OracleAS Adapter for Siebel integrates seamlessly with Oracle Business Process Management (BPM) to facilitate Web service integration. Oracle BPM is based on the Service-Oriented Architecture (SOA). It consumes adapter services exposed as Web Service Definition Language (WSDL) documents.

This chapter contains the following topics:

Overview

To integrate with Oracle BPM, OracleAS Adapter for Siebel must be deployed in the same WLS container as Oracle BPM. The underlying adapter services must be exposed as WSDL files, which are generated during design time in Oracle Adapter Application Explorer (Application Explorer) for both request-response (outbound) and event notification (inbound) services of the adapter. For more information, see "Generating WSDL (J2CA Configurations Only)".

The generated WSDL files are used to design the appropriate BPM processes for inbound or outbound adapter services. A completed BPM process must be successfully compiled in JDeveloper and deployed to a BPM server. Upon deployment to the BPM server, every newly built process is automatically deployed to the Oracle Enterprise Manager console, where you run, monitor, and administer BPM processes, and listen to adapter events.

Deployment of Adapter

During installation, OracleAS Adapter for Siebel is deployed as a J2CA 1.0 resource adapter within the WLS container. The adapter must be deployed in the same WLS container as Oracle BPM.

Configuring a New Application Server Connection

For more information on how to configure a new Application Server connection in Oracle JDeveloper, see Configuring a New Application Server Connection.

Designing an Outbound BPM Process Using Transformations for Service Integration

The following tools are required to complete your outbound design-time configuration:

  • Oracle Adapter Application Explorer (Application Explorer)

  • Oracle JDeveloper BPM Designer (JDeveloper) or Eclipse

Note:

The examples in this chapter demonstrate the use of JDeveloper.

Samples have been provided for this usecase scenario in the etc/sample folder of the Application Adapter installation.

Before you design a BPM process, you must generate the respective WSDL file using Application Explorer. For more information, see "Generating WSDL for Request/Response Service".

Creating an Empty Composite for BPM

Perform the following steps to create an empty composite for BPM:

  1. Create a new BPM application.

  2. Enter a name for the new BPM application and click Next, as shown in Figure 6-1.

    Figure 6-1 Name Your Application Page

    Name your application page
    Description of "Figure 6-1 Name Your Application Page"

    The Name your project page is displayed, as shown in Figure 6-2.

    Figure 6-2 Name Your Project Page

    Name your project page
    Description of "Figure 6-2 Name Your Project Page"

  3. Enter a project name (for example, Siebel_JCA_Outbound) and click Next.

    The Configure SOA settings page is displayed, as shown in Figure 6-3.

    Figure 6-3 Configure SOA Settings Page

    Configure SOA settings page
    Description of "Figure 6-3 Configure SOA Settings Page"

  4. From the Composite Template list, select Empty Composite and click Finish.

Defining a BPM Outbound Process

This section describes how to define a BPM outbound process, which consists of the following stages:

  1. Configuring a Third Party Adapter Service Component

  2. Configuring an Outbound BPM Process Component

  3. Creating a File Adapter for the Write Operation

Configuring a Third Party Adapter Service Component

Perform the following steps to create a third party adapter service component:

  1. As shown in Figure 6-4, drag and drop the Third Party Adapter component from the Service Adapters pane to the External References pane.

    Figure 6-4 Third Party Adapter Component Being Dragged from the Service Adapters Pane to the External References Pane

    External References pane
    Description of "Figure 6-4 Third Party Adapter Component Being Dragged from the Service Adapters Pane to the External References Pane"

    The Create Third Party Adapter Service dialog is displayed, as shown in Figure 6-5.

    Figure 6-5 Create Third Party Adapter Service Dialog

    Create Third Party Adapter Service dialog box
    Description of "Figure 6-5 Create Third Party Adapter Service Dialog"

  2. Enter a name for the third party adapter service.

  3. Ensure that Reference is selected from the Type list (default).

  4. Click the Find existing WSDLs icon, which is located to the right of the WSDL URL field.

    The SOA Resource Browser dialog is displayed, as shown in Figure 6-6.

    Figure 6-6 SOA Resource Browser Dialog

    SOA Resource Browser dialog box
    Description of "Figure 6-6 SOA Resource Browser Dialog"

  5. Browse and select an outbound Siebel WSDL file from the following directory:

    <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
    
  6. Click OK.

    The Localize Files dialog is displayed, as shown in Figure 6-7.

    Figure 6-7 Localize Files Dialog

    Localize Files dialog box
    Description of "Figure 6-7 Localize Files Dialog"

  7. Click OK.

    The outbound WSDL file and associated request and response XML schema files (.xsd) are imported to the project folder that has been created.

    You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 6-8.

    Figure 6-8 Create Third Party Adapter Service Dialog

    Create Third Party Adapter Service dialog box
    Description of "Figure 6-8 Create Third Party Adapter Service Dialog"

  8. Click the Find JCA file icon, which is located to the right of the JCA File field.

    The SOA Resource Browser dialog is displayed, as shown in Figure 6-9.

    Figure 6-9 SOA Resource Browser Dialog

    SOA Resource Browser dialog box
    Description of "Figure 6-9 SOA Resource Browser Dialog"

  9. Browse and select the JCA properties file from the following directory:

    <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
    
  10. Click OK.

    As shown in Figure 6-10, the following message is displayed.

    Figure 6-10 Copy File Confirmation Message

    Copy File message
    Description of "Figure 6-10 Copy File Confirmation Message"

  11. Click Yes.

    A copy of the JCA properties file is made in the project folder.

    You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 6-11.

    Figure 6-11 Create Third Party Adapter Service Dialog

    Create Third Party Adapter Service dialog box
    Description of "Figure 6-11 Create Third Party Adapter Service Dialog"

  12. Click OK.

    The third party adapter service component (QueryWithView) is created and displayed in the External References pane, as shown in Figure 6-12.

    Figure 6-12 Third Party Adapter Service Component

    External References pane
    Description of "Figure 6-12 Third Party Adapter Service Component"

    You are now ready to configure an outbound BPM process component.

Configuring an Outbound BPM Process Component

Perform the following steps to configure an outbound BPM process component:

  1. Drag and drop the BPMN Process component from the Service Components pane to the Components pane, as shown in Figure 6-13.

    Figure 6-13 BPMN Process Component Being Dragged to the Components Pane

    Components pane
    Description of "Figure 6-13 BPMN Process Component Being Dragged to the Components Pane"

    The Create BPMN Process dialog is displayed, as shown in Figure 6-14.

    Figure 6-14 Create BPMN Process Dialog

    Create BPMN Process dialog
    Description of "Figure 6-14 Create BPMN Process Dialog"

  2. Accept the default option that is selected under the Type area (Asynchronous Service) and click Finish.

    The BPMN Process component is created, as shown in Figure 6-15.

    Figure 6-15 BPMN Process Component

    BPMN Process component
    Description of "Figure 6-15 BPMN Process Component"

  3. Double-click the BPMN Process component in the Components pane.

    The BPMN process is displayed, as shown in Figure 6-16.

    Figure 6-16 BPMN Process Component

    BPMN Process component
    Description of "Figure 6-16 BPMN Process Component"

  4. Click the Activity icon, as shown in Figure 6-17.

    Figure 6-17 Activity Icon

    BPMN Process component
    Description of "Figure 6-17 Activity Icon"

  5. As shown in Figure 6-18, drop the Activity icon on the wire between the Start and End event components.

    Figure 6-18 Activity Icon Placed on the Wire Between the Start and End Event Components

    Start and End event components
    Description of "Figure 6-18 Activity Icon Placed on the Wire Between the Start and End Event Components"

    The Properties - Activity dialog is displayed, as shown in Figure 6-19.

    Figure 6-19 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-19 Properties - Activity Dialog"

  6. Click the Implementation tab, as shown in Figure 6-20.

    Figure 6-20 Service Task Being Selected from the Implementation Type List

    Implementation tab
    Description of "Figure 6-20 Service Task Being Selected from the Implementation Type List"

  7. Select Service Task from the Implementation Type list, as shown in Figure 6-21.

    Figure 6-21 Properties - Activity Dialog

    Implementation Type list
    Description of "Figure 6-21 Properties - Activity Dialog"

  8. Select Service Call from the Implementation list.

  9. Click the Browse icon to the right of the Name field, as shown in Figure 6-22.

    The Type dialog is displayed, as shown in Figure 6-23.

  10. Select the Third Party Service that has been created (for example, QueryWithView) and click OK.

    You are returned to the Properties - Activity dialog, as shown in Figure 6-24.

    Figure 6-24 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-24 Properties - Activity Dialog"

  11. Select the Use Associations option that is located under Data Associations.

  12. Click the Edit Data Associations icon.

    The Data Associations dialog is displayed, as shown in Figure 6-25.

    Figure 6-25 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-25 Data Associations Dialog"

  13. Right-click the Process node in the right pane and select Add.

    The Create Data Object dialog is displayed, as shown in Figure 6-26.

    Figure 6-26 Create Data Object Dialog

    Create Data Object dialog
    Description of "Figure 6-26 Create Data Object Dialog"

  14. Enter a name in the Name field (for example, Request) and click on the drop-down button in the Type field and select <Component> from the list.

    The Create Data Object dialog is displayed, as shown in Figure 6-27.

    Figure 6-27 Create Data Object Dialog

    Create Data Object Dialog
    Description of "Figure 6-27 Create Data Object Dialog"

  15. Click on the Browse icon below the Type field.

    The Browse window opens as shown in Figure 6-28

    Figure 6-28 Browse Window

    Browse dialog
    Description of "Figure 6-28 Browse Window"

  16. Select the first component (for example, Siebel) and click OK.

    You are returned to the Create Data Object dialog, as shown in Figure 6-29.

    Figure 6-29 Create Data Object Dialog

    Create Data Object dialog
    Description of "Figure 6-29 Create Data Object Dialog"

  17. Click OK.

    The Data Object (for example, Request) that has been created is displayed under the Process node in the Data Associations dialog, as shown in Figure 6-30.

    Figure 6-30 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-30 Data Associations Dialog"

  18. Create another Data Object by right-clicking the Process node in the right pane and selecting Add, as shown in Figure 6-31.

    The Create Data Object dialog is displayed, as shown in Figure 6-32.

    Figure 6-32 Create Data Object Dialog

    Create Data Object dialog
    Description of "Figure 6-32 Create Data Object Dialog"

  19. Enter a name in the Name field (for example, Response) and click on the drop down button in the Type field and select <Component> on the list.

    The Create Data Object is displayed, as shown in Figure 6-33.

    Figure 6-33 Create Data Object

    Create Data Object dialog
    Description of "Figure 6-33 Create Data Object"

  20. Click on the Browse icon below the Type field.

    The Browse window opens, as shown in Figure 6-34.

    Figure 6-34 Browse Window

    Browse dialog
    Description of "Figure 6-34 Browse Window"

  21. Select the second component (for example, SiebelResponse) and click OK.

    You are returned to the Create Data Object dialog, as shown in Figure 6-35.

    Figure 6-35 Create Data Object Dialog

    Surrounding text describes Figure 6-35 .
  22. Click OK.

    The Data Object (for example, Response) that has been created is displayed under the Process node in the Data Associations dialog, as shown in Figure 6-36.

    Figure 6-36 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-36 Data Associations Dialog"

  23. Select the Request Data Object under the Process node in the right pane and drag it to the field below the Inputs area, as shown in Figure 6-37.

    Figure 6-37 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-37 Data Associations Dialog"

  24. Select the Response Data Object under the Process node in the right pane and drag it to the field below the Outputs area, as shown in Figure 6-38.

    Figure 6-38 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-38 Data Associations Dialog"

  25. Click OK.

    You are returned to the Properties - Activity dialog, as shown in Figure 6-39.

    Figure 6-39 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-39 Properties - Activity Dialog"

  26. Click OK.

    As shown in Figure 6-40, the Service Task is created between the Start and End Event components.

    Figure 6-40 Service Task Created Between the Start and End Event Components

    Service Task
    Description of "Figure 6-40 Service Task Created Between the Start and End Event Components"

  27. Save the process and double-click the Start event component.

    The Properties - Start dialog is displayed, as shown in Figure 6-41.

    Figure 6-41 Properties - Start Dialog

    Properties - Start dialog
    Description of "Figure 6-41 Properties - Start Dialog"

  28. Click the Implementation tab, as shown in Figure 6-42.

    Figure 6-42 Implementation Tab

    Implementation tab
    Description of "Figure 6-42 Implementation Tab"

  29. Click the Plus icon to the right of the Arguments Definition field.

    The Create Argument dialog is displayed, as shown in Figure 6-43.

    Figure 6-43 Create Argument Dialog

    Create Argument dialog
    Description of "Figure 6-43 Create Argument Dialog"

  30. Enter a name in the Name field (by default, argument1) and click on the drop-down button in the Type field and select <Component> from the list.

    The Create Argument dialog is displayed, as shown in Figure 6-44.

    Figure 6-44 Create Argument

    Create Argument dialog
    Description of "Figure 6-44 Create Argument"

  31. Click on the Browse icon below the Type field.

    The Browse window appears, as shown in Figure 6-45

    Figure 6-45 Browse Window

    Browse window
    Description of "Figure 6-45 Browse Window"

  32. Select the first component (for example, Siebel) and click OK.

    You are returned to the Create Argument dialog, as shown in Figure 6-46.

    Figure 6-46 Create Argument Dialog

    Create Argument dialog
    Description of "Figure 6-46 Create Argument Dialog"

  33. Click OK.

    You are returned to the Properties - Start dialog, as shown in Figure 6-47.

    Figure 6-47 Properties - Start Dialog

    Properties - Start dialog
    Description of "Figure 6-47 Properties - Start Dialog"

  34. Select the Use Associations option that is located under Data Associations.

  35. Click the Edit Data Associations icon.

    The Data Associations dialog is displayed.

  36. As shown in Figure 6-48, select the Request Data Object under the Process node in the right pane and drag it to the field below the Outputs area.

    Figure 6-48 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-48 Data Associations Dialog"

  37. Click OK.

    You are returned to the Properties - Start dialog, as shown in Figure 6-49.

    Figure 6-49 Properties - Start Dialog

    Properties - Activity dialog
    Description of "Figure 6-49 Properties - Start Dialog"

  38. Click OK.

    You are returned to the Process workspace area.

  39. As shown in Figure 6-50, double-click composite.xml in the left pane.

    Figure 6-50 Process Workspace Area

    Process workspace area
    Description of "Figure 6-50 Process Workspace Area"

  40. Click the Save All icon in the menu bar to save the new outbound BPM process component that was configured.

    You are now ready to create a File adapter for the write operation.

Creating a File Adapter for the Write Operation

Perform the following steps to create a File adapter for the write operation:

  1. Drag and drop the File Adapter component from the Service Adapters pane to the External References pane, as shown in Figure 6-51.

    Figure 6-51 File Adapter Component Selected in the Service Adapters Pane

    File Adapter component
    Description of "Figure 6-51 File Adapter Component Selected in the Service Adapters Pane"

    The Adapter Configuration Wizard is displayed, as shown in Figure 6-52.

    Figure 6-52 Adapter Configuration Wizard

    Adapter Configuration Wizard
    Description of "Figure 6-52 Adapter Configuration Wizard"

  2. Click Next.

    The Service Name page is displayed, as shown in Figure 6-53.

    Figure 6-53 Service Name Page

    Service Name pane
    Description of "Figure 6-53 Service Name Page"

  3. Type a name for the new File adapter in the Service Name field and click Next.

    The Adapter Interface page is displayed, as shown in Figure 6-54.

    Figure 6-54 Adapter Interface Page

    Adapter Interface pane
    Description of "Figure 6-54 Adapter Interface Page"

  4. Ensure that the Define from operation and schema (specified later) option is selected.

  5. Click Next.

    The Operation page is displayed, as shown in Figure 6-55.

    Figure 6-55 Operation Page

    Operation pane
    Description of "Figure 6-55 Operation Page"

  6. Select Write File from the list of Operation Type options and specify an Operation Name (for example, Write).

  7. Click Next.

    The File Configuration page is displayed, as shown in Figure 6-56.

    Figure 6-56 File Configuration Page

    File Configuration pane
    Description of "Figure 6-56 File Configuration Page"

  8. Specify a location on your file system for the output file.

  9. In the File Naming Convention field, specify a name for the output file.

  10. Click Next.

    The Messages page is displayed, as shown in Figure 6-57.

    Figure 6-57 Messages Page

    Messages pane
    Description of "Figure 6-57 Messages Page"

  11. Click browse for schema file, which is located to the right of the URL field.

    The Type Chooser dialog is displayed, as shown in Figure 6-58.

    Figure 6-58 Type Chooser Dialog

    Type Chooser dialog box
    Description of "Figure 6-58 Type Chooser Dialog"

  12. Expand Project Schema Files, queryWithView_invoke_response.xsd, and SiebelResponse.

  13. Select the available schema (for example, SiebelResponse)

  14. Click OK.

    You are returned to the Messages page, as shown in Figure 6-59.

    Figure 6-59 Messages Page

    Messages pane
    Description of "Figure 6-59 Messages Page"

  15. Click Next.

    The Finish page is displayed, as shown in Figure 6-60.

  16. Click Finish.

    As shown in Figure 6-61, the File Adapter service is created in the External References pane.

    Figure 6-61 File Adapter Service Created in the External References Pane

    External References pane
    Description of "Figure 6-61 File Adapter Service Created in the External References Pane"

  17. Double-click the BPMN Process component.

    The BPMN process is displayed, as shown in Figure 6-62.

    Figure 6-62 Activity Icon

    BPMN process
    Description of "Figure 6-62 Activity Icon"

  18. Click the Activity icon.

  19. Drop the Activity icon on the wire between the Service Task and End event components, as shown in Figure 6-63.

    Figure 6-63 Activity Icon Placed on the Wire Between the Service Task and End Event Components

    Service Task and End components
    Description of "Figure 6-63 Activity Icon Placed on the Wire Between the Service Task and End Event Components"

    The Properties - Activity dialog is displayed, as shown in Figure 6-64.

    Figure 6-64 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-64 Properties - Activity Dialog"

  20. As shown in Figure 6-65, click the Implementation tab.

    Figure 6-65 Implementation Tab

    Implementation tab
    Description of "Figure 6-65 Implementation Tab"

  21. As shown in Figure 6-66, select Service Task from the Implementation Type list.

    Figure 6-66 Service Task Selected from the Implementation Type

    Implementation Type list
    Description of "Figure 6-66 Service Task Selected from the Implementation Type"

  22. Select Service Call from the Implementation list.

  23. Click the Browse icon to the right of the Name field, as shown in Figure 6-67.

    The Type dialog is displayed, as shown in Figure 6-68.

  24. Select the service for write operation that has been created (for example, Siebel_File_Adapter) and click OK.

    You are returned to the Properties - Activity dialog, as shown in Figure 6-69.

    Figure 6-69 Properties - Activity Dialog

    Properties - ServiceTask1 dialog
    Description of "Figure 6-69 Properties - Activity Dialog"

  25. Select the Use Transformations option that is located under Data Associations.

  26. Click the Edit XSL Transformations icon.

    The Edit Transformations dialog is displayed, as shown in Figure 6-70.

    Figure 6-70 Edit Transformations Dialog

    Edit Transformations dialog
    Description of "Figure 6-70 Edit Transformations Dialog"

  27. Click the Plus icon.

    The Create Transformation dialog is displayed, as shown in Figure 6-71.

    Figure 6-71 Create Transformation Dialog

    Create Transformation dialog
    Description of "Figure 6-71 Create Transformation Dialog"

  28. As shown in Figure 6-72, select the Response Data Object that was created from the Sources list.

    Figure 6-72 Response Data Object and Add Icon

    Transformation dialog
    Description of "Figure 6-72 Response Data Object and Add Icon"

  29. Click the Plus icon so that the Data Object 'Response' is added to the Selected Elements area.

  30. Accept the default value that is selected in the Target list, as shown in Figure 6-72.

  31. Leave the default name displayed in the Create field and click OK.

    You are returned to the Edit Transformations dialog, as shown in Figure 6-73.

    Figure 6-73 Edit Transformations Dialog

    Edit Transformations dialog
    Description of "Figure 6-73 Edit Transformations Dialog"

  32. Click OK.

    You are returned to the Properties - Activity dialog, as shown in Figure 6-74.

    Figure 6-74 Properties - Activity Dialog

    Properties - ServiceTask1 dialog
    Description of "Figure 6-74 Properties - Activity Dialog"

  33. Click OK.

    The Response_body.xsl tab is displayed, as shown in Figure 6-75.

    Figure 6-75 The Response_body.xsl Tab

    Response_body.xsl tab
    Description of "Figure 6-75 The Response_body.xsl Tab"

  34. Automap the Source and Target elements.

    The Auto Map Preferences dialog is displayed, as shown in Figure 6-76.

    Figure 6-76 Auto Map Preferences Dialog

    Auto Map Preferences dialog
    Description of "Figure 6-76 Auto Map Preferences Dialog"

  35. Accept the default values and click OK.

    The transformation is completed, as shown in Figure 6-77.

    Figure 6-77 Completed Transformation

    completed transformation
    Description of "Figure 6-77 Completed Transformation"

  36. Save the transformation.

  37. Return to the Process workspace area, as shown in Figure 6-78.

    Figure 6-78 Process Workspace Area

    Process workspace area
    Description of "Figure 6-78 Process Workspace Area"

    The ServiceTask1 component is created between the ServiceTask component and the End event component.

  38. Save the process.

  39. Double-click the End event component.

    The Properties - End dialog is displayed.

  40. As shown in Figure 6-79, click the Implementation tab.

    Figure 6-79 Properties - End Dialog

    Implementation tab
    Description of "Figure 6-79 Properties - End Dialog"

  41. Select None from the Implementation Type list, as shown in Figure 6-80.

    Figure 6-80 None Option in Implementation Type List

    Implementation Type list
    Description of "Figure 6-80 None Option in Implementation Type List"

  42. Click OK.

    You are returned to the Process workspace area.

  43. Save the Process and double-click the composite.xml file.

  44. Click OK.

    You are returned to the Process workspace area and ready to deploy the outbound BPM process.

Deploying the BPM Outbound Process

Perform the following steps to deploy the BPM outbound process.

  1. Right-click the project name in the left pane (for example, Siebel_JCA_Outbound), select Deploy, and then click Siebel_JCA_Outbound, as shown in Figure 6-81.

    The Deployment Action page is displayed.

  2. Ensure that Deploy to Application Server is selected.

  3. Click Next.

    The Deploy Configuration page is displayed, as shown in Figure 6-82.

    Figure 6-82 Deploy Configuration Page

    Deploy Configuration pane
    Description of "Figure 6-82 Deploy Configuration Page"

  4. Leave the default values selected and click Next.

    The Select Server page is displayed, as shown in Figure 6-83.

    Figure 6-83 Select Server Page

    Select Server pane
    Description of "Figure 6-83 Select Server Page"

  5. Select an available application server that was configured and click Next.

    The SOA Servers page is displayed, as shown in Figure 6-84.

    Figure 6-84 SOA Servers Page

    SOA Servers pane
    Description of "Figure 6-84 SOA Servers Page"

  6. Select a target SOA server and click Next.

    The Summary page is displayed, as shown in Figure 6-85.

  7. Review and verify all the available deployment information for your project and click Finish.

    The process is deployed successfully, as shown in Figure 6-86.

    Figure 6-86 Deployment Successful Message

    deployed process
    Description of "Figure 6-86 Deployment Successful Message"

Invoking the Input XML Document in the Oracle Enterprise Manager Console

Perform the following steps to invoke the input XML document in the Oracle Enterprise Manager console.

  1. Logon to the Oracle Enterprise Manager console., as shown in Figure 6-87.

    Figure 6-87 Oracle Enterprise Manager Console

    Oracle Enterprise Manager console
    Description of "Figure 6-87 Oracle Enterprise Manager Console"

  2. Expand your domain in the left pane followed by the SOA folder.

  3. Select an available project (for example, Siebel_JCA_Outbound).

  4. Click Test.

  5. Click the Request tab.

  6. Provide an appropriate input value in the Value field and click Test Web Service.

    A response is received in the Response tab to indicate that invocation was successful in the Oracle Enterprise Manager console.

  7. Navigate to the defined output directory on your file system and open the XML response document that was received.

    The XML response document contains the generated output with values.

Designing an Inbound BPM Process Using Transformations for Event Integration

This section demonstrates how OracleAS Adapter for Siebel integrates with Siebel to receive event data.

The following tools are required to complete your adapter design-time configuration:

  • Oracle Adapter Application Explorer (Application Explorer)

  • Oracle JDeveloper BPM Designer (JDeveloper) or Eclipse

Note:

The examples in this chapter demonstrate the use of JDeveloper.

Samples have been provided for this usecase scenario in the etc/sample folder in the Application Adapters installation.

Before you design a BPM process, you must generate the respective WSDL file using Application Explorer. For more information, see Generating WSDL for Event Integration.

Creating an Empty Composite for BPM

Perform the following steps to create an empty composite for BPM:

  1. Create a new BPM application.

  2. Enter a name for the new BPM application and click Next, as shown in Figure 6-88.

    Figure 6-88 Name Your Application Page

    Name your application page
    Description of "Figure 6-88 Name Your Application Page"

    The Name your project page is displayed, as shown in Figure 6-89.

    Figure 6-89 Name Your Project Page

    Name your project page
    Description of "Figure 6-89 Name Your Project Page"

  3. Enter a project name (for example, Siebel_JCA_Inbound) and click Next.

    The Configure SOA settings page is displayed, as shown in Figure 6-90.

    Figure 6-90 Configure SOA Settings Page

    Configure SOA settings page
    Description of "Figure 6-90 Configure SOA Settings Page"

  4. From the Composite Template list, select Empty Composite and click Finish.

Defining a BPM Inbound Process

This section describes how to define a BPM inbound process, which consists of the following stages:

  1. Configuring a Third Party Adapter Service Component

  2. Configuring an Inbound BPM Process Component

  3. Creating a File Adapter for the Write Operation

Configuring a Third Party Adapter Service Component

Perform the following steps to create a third party adapter service component:

  1. Drag and drop the Third Party Adapter component from the Service Adapters pane to the Exposed References pane, as shown in Figure 6-91.

    Figure 6-91 Third Party Adapter Component Being Dragged to the Exposed References Pane

    Exposed References pane
    Description of "Figure 6-91 Third Party Adapter Component Being Dragged to the Exposed References Pane"

    The Create Third Party Adapter Service dialog is displayed, as shown in Figure 6-92.

    Figure 6-92 Create Third Party Adapter Service Dialog

    Create Third Party Adapter Service dialog box
    Description of "Figure 6-92 Create Third Party Adapter Service Dialog"

  2. Enter a name for the third party adapter service.

  3. Ensure that Service is selected from the Type list (default).

  4. Click the Find existing WSDLs icon, which is located to the right of the WSDL URL field.

    The SOA Resource Browser dialog is displayed, as shown in Figure 6-93.

    Figure 6-93 SOA Resource Browser Dialog

    SOA Resource Browser dialog box
    Description of "Figure 6-93 SOA Resource Browser Dialog"

  5. Browse and select an inbound WSDL file from the following directory:

    <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
    
  6. Click OK.

    The Localize Files dialog is displayed, as shown in Figure 6-94.

    Figure 6-94 Localize Files Dialog

    Localize Files dialog box
    Description of "Figure 6-94 Localize Files Dialog"

  7. Click OK.

    The inbound WSDL file and associated receive_request XML schema file (.xsd) are imported to the project folder that has been created.

    As shown in Figure 6-95, you are returned to the Create Third Party Adapter Service dialog.

    Figure 6-95 Create Third Party Adapter Service Dialog

    Create Third Party Adapter Service dialog box
    Description of "Figure 6-95 Create Third Party Adapter Service Dialog"

  8. Click the Find JCA file icon, which is located to the right of the JCA File field.

    The SOA Resource Browser dialog is displayed, as shown in Figure 6-96.

    Figure 6-96 SOA Resource Browser Dialog

    SOA Resource Browser dialog box
    Description of "Figure 6-96 SOA Resource Browser Dialog"

  9. Browse and select the JCA properties file from the following directory:

    <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
    
  10. Click OK.

    The following message is displayed, as shown in Figure 6-97.

    Figure 6-97 Copy File Confirmation Message

    Copy File message
    Description of "Figure 6-97 Copy File Confirmation Message"

  11. Click Yes.

    A copy of the JCA properties file is made in the project folder.

    You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 6-98.

    Figure 6-98 Create Third Party Adapter Service Dialog

    Create Third Party Adapter Service dialog box
    Description of "Figure 6-98 Create Third Party Adapter Service Dialog"

  12. Click OK.

    The third party adapter service component (SampleAccount) is created in the Exposed References pane, as shown in Figure 6-99.

    Figure 6-99 Third Party Adapter Service Component Created in the Exposed References Pane

    Exposed References pane
    Description of "Figure 6-99 Third Party Adapter Service Component Created in the Exposed References Pane"

    You are now ready to configure an inbound BPM process component.

Configuring an Inbound BPM Process Component

Perform the following steps to configure an inbound BPM process component:

  1. As shown in Figure 6-100, drag and drop the BPMN Process component from the Service Components pane to the Components pane.

    Figure 6-100 BPMN Process Component Being Dragged to the Components Pane

    Components pane
    Description of "Figure 6-100 BPMN Process Component Being Dragged to the Components Pane"

    The Create BPMN Process dialog is displayed, as shown in Figure 6-101.

    Figure 6-101 Create BPMN Process Dialog

    Create BPMN Process dialog
    Description of "Figure 6-101 Create BPMN Process Dialog"

  2. Select the From Pattern option in the left pane and ensure that Manual Process is selected in the Patterns area, as shown in Figure 6-102.

    Figure 6-102 Manual Process

    Manual Process
    Description of "Figure 6-102 Manual Process"

  3. Click Finish.

    The BPMN Process component is created, as shown in Figure 6-103.

    Figure 6-103 BPMN Process Component

    BPMN Process component
    Description of "Figure 6-103 BPMN Process Component"

  4. Double-click the BPMN Process component in the Components pane.

    The BPMN process is displayed, as shown in Figure 6-104.

    Figure 6-104 BPMN Process Component

    BPMN Process component
    Description of "Figure 6-104 BPMN Process Component"

  5. Right-click UserTask and select Delete from the menu.

  6. As shown in Figure 6-105, double-click the Start event component.

    Figure 6-105 Start Event Component

    Start event component
    Description of "Figure 6-105 Start Event Component"

    The Properties - Start dialog is displayed, as shown in Figure 6-106.

    Figure 6-106 Properties - Start Dialog

    Properties - Start dialog
    Description of "Figure 6-106 Properties - Start Dialog"

  7. Click the Implementation tab, as shown in Figure 6-107.

    Figure 6-107 Implementation Tab

    Implementation tab
    Description of "Figure 6-107 Implementation Tab"

  8. Select Message from the Implementation Type list, as shown in Figure 6-108.

    Figure 6-108 Message Selected from the Implementation Type List

    Properties - Start dialog
    Description of "Figure 6-108 Message Selected from the Implementation Type List"

  9. Select Interface from Catalog from the Implementation list.

  10. Click the Browse icon to the right of the Name field, as shown in Figure 6-109.

    The Type dialog is displayed, as shown in Figure 6-110.

  11. Select the Third Party Service that has been created and click OK.

    You are returned to the Properties - Start dialog, as shown in Figure 6-111.

    Figure 6-111 Properties - Start Dialog

    Properties - Start dialog
    Description of "Figure 6-111 Properties - Start Dialog"

  12. Select the Use Associations option that is located under Data Associations.

  13. Click the Edit Data Associations icon.

    The Data Associations dialog is displayed, as shown in Figure 6-112.

    Figure 6-112 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-112 Data Associations Dialog"

  14. Right-click the Process node in the right pane and select Add.

    The Create Data Object dialog is displayed, as shown in Figure 6-113.

    Figure 6-113 Create Data Object Dialog

    Create Data Object dialog
    Description of "Figure 6-113 Create Data Object Dialog"

  15. Enter a name in the Name field (for example, sample_account_in) and click on the drop down button in the Type field and select <Component> from the list.

    The Create Data Object dialog is displayed, as shown in Figure 6-114.

    Figure 6-114 Create Data Object Dialog

    Create Data Object dialog
    Description of "Figure 6-114 Create Data Object Dialog"

  16. Click on the Browse icon below the Type field, as shown in Figure 6-115.

    The Browse window opens, as shown in Figure 6-116.

    Figure 6-116 Browse Types Dialog

    Browse Types dialog
    Description of "Figure 6-116 Browse Types Dialog"

  17. Select the first component (for example, SiebelMessage) and click OK.

    You are returned to the Create Data Object dialog, as shown in Figure 6-117.

    Figure 6-117 Create Data Object Dialog

    Create Data Object dialog
    Description of "Figure 6-117 Create Data Object Dialog"

  18. Click OK.

    The Data Object (for example, sample_account_in) that has been created is displayed under the Process node in the Data Associations dialog, as shown in Figure 6-118.

    Figure 6-118 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-118 Data Associations Dialog"

  19. As shown in Figure 6-119, select the sample_account_in Data Object under the Process node in the right pane and drag it to the field below the Outputs area.

    Figure 6-119 Data Associations Dialog

    Data Associations dialog
    Description of "Figure 6-119 Data Associations Dialog"

  20. Click OK.

    You are returned to the Properties - Start dialog, as shown in Figure 6-120.

    Figure 6-120 Properties - Start Dialog

    Properties - Start dialog
    Description of "Figure 6-120 Properties - Start Dialog"

  21. Click OK.

    You are returned to the Process workspace area.

  22. Double-click composite.xml in the left pane, as shown in Figure 6-121.

    Figure 6-121 Process Workspace Area

    Process workspace area
    Description of "Figure 6-121 Process Workspace Area"

  23. Click the Save All icon in the menu bar to save the new inbound BPM process component that was configured.

    You are now ready to create a File adapter for the write operation.

Creating a File Adapter for the Write Operation

Perform the following steps to create a File adapter for the write operation:

  1. Drag and drop the File Adapter component from the Service Adapters pane to the External References pane, as shown in Figure 6-122.

    Figure 6-122 File Adapter Component Being Dragged to External References Pane

    File Adapter component
    Description of "Figure 6-122 File Adapter Component Being Dragged to External References Pane"

    The Adapter Configuration Wizard is displayed, as shown in Figure 6-123.

    Figure 6-123 Adapter Configuration Wizard

    Adapter Configuration Wizard
    Description of "Figure 6-123 Adapter Configuration Wizard"

  2. Click Next.

    The Service Name page is displayed, as shown in Figure 6-124.

    Figure 6-124 Service Name Page

    Service Name pane
    Description of "Figure 6-124 Service Name Page"

  3. Type a name for the new File adapter in the Service Name field and click Next.

    The Adapter Interface page is displayed, as shown in Figure 6-125.

    Figure 6-125 Adapter Interface Page

    Adapter Interface pane
    Description of "Figure 6-125 Adapter Interface Page"

  4. Ensure that the Define from operation and schema (specified later) option is selected.

  5. Click Next.

    The Operation page is displayed, as shown in Figure 6-126.

    Figure 6-126 Operation Page

    Operation pane
    Description of "Figure 6-126 Operation Page"

  6. Select Write File from the list of Operation Type options and specify an Operation Name (for example, Write).

  7. Click Next.

    The File Configuration page is displayed, as shown in Figure 6-127.

    Figure 6-127 File Configuration Page

    File Configuration pane
    Description of "Figure 6-127 File Configuration Page"

  8. Specify a location on your file system for the output file.

  9. In the File Naming Convention field, specify a name for the output file.

  10. Click Next.

    The Messages page is displayed, as shown in Figure 6-128.

    Figure 6-128 Messages Page

    Messages pane
    Description of "Figure 6-128 Messages Page"

  11. Click browse for schema file, which is located to the right of the URL field.

    The Type Chooser dialog is displayed, as shown in Figure 6-129.

    Figure 6-129 Type Chooser Dialog

    Type Chooser dialog box
    Description of "Figure 6-129 Type Chooser Dialog"

  12. Expand Project Schema Files and then Sample_Account_receive_request.xsd.

  13. Select the available schema (for example, SiebelMessage)

  14. Click OK.

    You are returned to the Messages page, as shown in Figure 6-130.

    Figure 6-130 Messages Page

    Messages pane
    Description of "Figure 6-130 Messages Page"

  15. Click Next.

    The Finish page is displayed, as shown in Figure 6-131.

  16. Click Finish.

    As shown in Figure 6-132, the File Adapter service is created in the External References pane.

    Figure 6-132 File Adapter Service Created in the External References Pane

    File Adapter service
    Description of "Figure 6-132 File Adapter Service Created in the External References Pane"

  17. Double-click the BPMN Process component.

    The BPMN process is displayed, as shown in Figure 6-133.

    Figure 6-133 BPMN Process

    BPMN process
    Description of "Figure 6-133 BPMN Process"

  18. Click the Activity icon.

  19. As shown in Figure 6-134, drop the Activity icon on the wire between the Start and End event components.

    Figure 6-134 Activity Icon Placed on the Wire Between the Start and End Event Components

    Activity icon
    Description of "Figure 6-134 Activity Icon Placed on the Wire Between the Start and End Event Components"

    The Properties - Activity dialog is displayed, as shown in Figure 6-135.

    Figure 6-135 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-135 Properties - Activity Dialog"

  20. Click the Implementation tab, as shown in Figure 6-136.

    Figure 6-136 Implementation Tab

    Implementation tab
    Description of "Figure 6-136 Implementation Tab"

  21. Select Service Task from the Implementation Type list, as shown in Figure 6-137.

    Figure 6-137 Service Task Selected From the Implementation Type List

    Implementation Type list
    Description of "Figure 6-137 Service Task Selected From the Implementation Type List"

  22. Select Service Call from the Implementation list.

  23. Click the Browse icon to the right of the Name field, as shown in Figure 6-138.

    The Type dialog is displayed, as shown in Figure 6-139.

  24. Select the service for write operation that has been created and click OK.

    You are returned to the Properties - Activity dialog, as shown in Figure 6-140.

    Figure 6-140 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-140 Properties - Activity Dialog"

  25. Select the Use Transformations option that is located under Data Associations.

  26. Click the Edit XSL Transformations icon.

    The Edit Transformations dialog is displayed, as shown in Figure 6-141.

    Figure 6-141 Edit Transformations Dialog

    Edit Transformations dialog
    Description of "Figure 6-141 Edit Transformations Dialog"

  27. Click the Plus icon.

    The Create Transformation dialog is displayed, as shown in Figure 6-142.

    Figure 6-142 Create Transformation Dialog

    Create Transformation dialog
    Description of "Figure 6-142 Create Transformation Dialog"

  28. Click the Plus icon so that the Data Object 'sample_account_in' is added to the Selected Elements area, as shown in Figure 6-143.

    Figure 6-143 Create Transformation Dialog

    Create Transformation dialog
    Description of "Figure 6-143 Create Transformation Dialog"

  29. Accept the default value that is selected in the Target list.

  30. Leave the default name displayed in the Create field and click OK.

    You are returned to the Edit Transformations dialog, as shown in Figure 6-144.

    Figure 6-144 Edit Transformations Dialog

    Edit Transformations dialog
    Description of "Figure 6-144 Edit Transformations Dialog"

  31. Click OK.

    You are returned to the Properties - Activity dialog, as shown in Figure 6-145.

    Figure 6-145 Properties - Activity Dialog

    Properties - Activity dialog
    Description of "Figure 6-145 Properties - Activity Dialog"

  32. Click OK.

    The sample_account_in_body.xsl tab is displayed, as shown in Figure 6-146.

    Figure 6-146 The sample_account_in_body.xsl Tab

    sample_account_in_body.xsl tab
    Description of "Figure 6-146 The sample_account_in_body.xsl Tab"

  33. Automap the Source and Target elements.

    The Auto Map Preferences dialog is displayed, as shown in Figure 6-147.

    Figure 6-147 Auto Map Preferences Dialog

    Auto Map Preferences dialog
    Description of "Figure 6-147 Auto Map Preferences Dialog"

  34. Accept the default values and click OK.

    The transformation is completed, as shown in Figure 6-148.

    Figure 6-148 Completed Transformation

    completed transformation
    Description of "Figure 6-148 Completed Transformation"

  35. Save the transformation.

  36. As shown in Figure 6-149, return to the Process workspace area.

    Figure 6-149 Process Workspace Area

    Process workspace area
    Description of "Figure 6-149 Process Workspace Area"

    The ServiceTask component is created between the Start event component and the End event component.

  37. Save the Process and double-click the composite.xml file.

  38. Click the Save All icon in the menu bar to save the new inbound BPM process component that was configured.

    You are now ready to deploy the inbound BPM process, as shown in Figure 6-150.

    Figure 6-150 Process Workspace Area

    Process workspace area
    Description of "Figure 6-150 Process Workspace Area"

Deploying the BPM Inbound Process

Perform the following steps to deploy the BPM inbound process.

  1. Right-click the project name in the left pane (for example, Siebel_JCA_Inbound), select Deploy, and then click Siebel_JCA_Inbound, as shown in Figure 6-151.

    Figure 6-151 Deploy Option

    Deploy context menu
    Description of "Figure 6-151 Deploy Option"

    The Deployment Action page is displayed, as shown in Figure 6-152.

    Figure 6-152 Deployment Action Page

    Deployment Action pane
    Description of "Figure 6-152 Deployment Action Page"

  2. Ensure that Deploy to Application Server is selected.

  3. Click Next.

    The Deploy Configuration page is displayed, as shown in Figure 6-153.

    Figure 6-153 Deploy Configuration Page

    Deploy Configuration pane
    Description of "Figure 6-153 Deploy Configuration Page"

  4. Leave the default values selected and click Next.

    The Select Server page is displayed, as shown in Figure 6-154.

    Figure 6-154 Select Server Page

    Select Server pane
    Description of "Figure 6-154 Select Server Page"

  5. Select an available application server that was configured and click Next.

    The SOA Servers page is displayed, as shown in Figure 6-155.

    Figure 6-155 SOA Servers Page

    SOA Servers pane
    Description of "Figure 6-155 SOA Servers Page"

  6. Select a target SOA server and click Next.

    The Summary page is displayed, as shown in Figure 6-156.

    Figure 6-156 Summary Page

    Summary pane
    Description of "Figure 6-156 Summary Page"

  7. Review and verify all the available deployment information for your project and click Finish.

    The process is deployed successfully, as shown in Figure 6-157.

    Figure 6-157 Deployment Successful Message

    Authorization Request dialog box
    Description of "Figure 6-157 Deployment Successful Message"

Triggering an Event in Siebel

The following topic describes how to trigger an event in Siebel and verify event integration using Oracle Application Adapter for Siebel.

Triggering a Siebel Event to Test Event Runtime Integration

To trigger an event in Siebel:

  1. As shown in Figure 6-158, start the Siebel Call Center by entering the following URL in a browser:

    http://host name/callcenter/start.swe
    

    Figure 6-158 Site Map Option

    Mapping Parameters
    Description of "Figure 6-158 Site Map Option"

  2. Click View and select Site Map from the list.

    The Site Map view is displayed, as shown in Figure 6-159.

    Figure 6-159 Site Map View

    Site Map View
    Description of "Figure 6-159 Site Map View"

  3. Click Siebel Workflow Administration.

    The Siebel Workflow Administration page is displayed, as shown in Figure 6-160.

    Figure 6-160 Siebel Workflow Administration Page

    Siebel Workflow Administration
    Description of "Figure 6-160 Siebel Workflow Administration Page"

  4. Click Workflow Processes.

    The Workflow Processes page is displayed, as shown in Figure 6-161.

    Figure 6-161 Workflow Processes Page

    Workflow Processes
    Description of "Figure 6-161 Workflow Processes Page"

  5. Click Query to search for the Workflow needed to trigger a Siebel event, as shown in Figure 6-162.

    Figure 6-162 Workflow Processes Page

    Workflow Processes
    Description of "Figure 6-162 Workflow Processes Page"

  6. As shown in Figure 6-163, enter a Siebel workflow name and click Search.

    Figure 6-163 Workflow Processes Page

    Workflow Processes
    Description of "Figure 6-163 Workflow Processes Page"

  7. Select the workflow, as shown in Figure 6-164.

    Figure 6-164 Process Designer Tab

    Process Designer tab
    Description of "Figure 6-164 Process Designer Tab"

  8. Click the Process Designer tab and double-click the Send Siebel Quote Data HTTP workflow element.

    As shown in Figure 6-165, the Input Arguments tab is displayed.

    Figure 6-165 Input Arguments Tab

    Input Arguments tab
    Description of "Figure 6-165 Input Arguments Tab"

  9. Enter the IP address and port for the HTTPRequestURLTemplate input argument.

  10. Click Return To Designer, as shown in Figure 6-166.

    Figure 6-166 Return To Designer Button

    Return to Designer
    Description of "Figure 6-166 Return To Designer Button"

  11. Click the Process Simulator tab, as shown in Figure 6-167.

    Figure 6-167 Process Simulator tab

    Process Designer tab
    Description of "Figure 6-167 Process Simulator tab"

    The Simulator tab is displayed, as shown in Figure 6-168.

    Figure 6-168 Simulator Tab

    Simulator tab
    Description of "Figure 6-168 Simulator Tab"

  12. Click Start then Continue to complete the Siebel event triggering process.

Verifying the Results

To verify your results:

  1. Log in to the Oracle Enterprise Manager console by using the following URL:

    http://localhost:7001/em
    
  2. Expand your domain in the left pane followed by the SOA folder.

  3. As shown in Figure 6-169, select an available project (for example, Siebel_JCA_Inbound).

    Figure 6-169 Instances Tab

    Instances tab
    Description of "Figure 6-169 Instances Tab"

  4. Click the Instances tab in the right pane.

    Recently received run-time events are displayed in the Instances tab, as shown in Figure 6-170.

    Figure 6-170 Recently Received Run-time Events in Instances Tab

    Instances tab
    Description of "Figure 6-170 Recently Received Run-time Events in Instances Tab"

  5. Navigate to the defined output directory on your file system and open the event messages that were created.

    The event messages contain the generated output with values.