Skip Headers
Oracle® Fusion Middleware Application Adapter for PeopleSoft User's Guide for Oracle WebLogic Server
11g Release 1 (11.1.1.4.0)

Part Number E17055-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

7 Configuring Outbound and Inbound Processing Using Oracle Service Bus

Oracle Application Adapter for PeopleSoft integrates seamlessly with Oracle Service Bus (OSB) to facilitate Web service integration. OSB 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 of Application Adapter Integration with Oracle Service Bus

To integrate with Oracle Service Bus (OSB), Oracle Application Adapter for PeopleSoft must be deployed in the same Oracle WebLogic Server as OSB. 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.

Configuring Outbound Processing Using Oracle Service Bus (J2CA Configuration)

This section describes how to configure outbound processing using Oracle Service Bus for J2CA configurations.

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

This section includes the following topics:

Starting Oracle Service Bus and Creating Project Folders

Perform the following steps to start Oracle Service Bus and create project folders:

  1. Start the Oracle WebLogic Server for the Oracle WebLogic Server domain that you have configured.

  2. Open the Oracle Service Bus Console in a Web browser by entering the following URL:

    http://hostname:port/sbconsole
    

    Where hostname is the name of the machine where Oracle WebLogic Server is running and port is the port for the domain you are using. The port for the default domain is 7001.

    The Oracle Service Bus Console logon page is displayed.

  3. Log on to the Oracle Service Bus Console using a valid user name and password.

    The Oracle Service Bus Console home page is displayed, as shown in Figure 7-1.

    Figure 7-1 Oracle Service Bus Console Home Page

    OSB home
    Description of "Figure 7-1 Oracle Service Bus Console Home Page"

  4. Click Create in the Change Center area to start a new Oracle Service Bus session, as shown in Figure 7-2.

  5. Click Project Explorer in the left pane, as shown in Figure 7-3.

    Figure 7-3 Project Explorer Option

    Project Explorer option
    Description of "Figure 7-3 Project Explorer Option"

    The Project Explorer page is displayed, as shown in Figure 7-4.

    Figure 7-4 Project Explorer Page

    Project Explorer
    Description of "Figure 7-4 Project Explorer Page"

  6. Provide a valid name for the new project and click Add Project.

    The project is successfully created and listed.

  7. Click on the created project.

    The project page is displayed.

    Figure 7-5 Enter New Folder Name Field

    Project page
    Description of "Figure 7-5 Enter New Folder Name Field"

  8. In the Enter New Folder Name field, type Business Service and click Add Folder, as shown in Figure 7-5.

  9. In the Enter New Folder Name field, type Proxy Service and click Add Folder.

  10. In the Enter New Folder Name field, type wsdls and click Add Folder.

    The Business Service, Proxy Service, and wsdls folders are listed in the left pane below the project node, as shown in Figure 7-6.

Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus

Before starting and using Application Explorer to publish a WSDL directly to the Oracle Service Bus (OSB) Console (project/folder), OSB users must perform the following steps:

  1. Open the command prompt window.

  2. Navigate to the following directory:

    <OSB_Home>\user_projects\domains\base_domain\bin
    
  3. Execute setDomainEnv.cmd (Windows) or . ./setDomainEnv.sh (UNIX/Linux).

    This command sets the class path for Application Explorer to access the Oracle WebLogic Server APIs to publish the WSDLs to the OSB Console.

  4. Do not close the command prompt window.

  5. Navigate to the following directory:

    <OSB_Home>\3rdparty\ApplicationAdapters\tools\iwae\bin
    
  6. Execute ae.bat (Windows) or iwae.sh (UNIX/Linux) to start Application Explorer.

    You are now ready to publish WSDLs from Application Explorer to the OSB Console.

Publishing a WSDL From Application Explorer to Oracle Service Bus

Perform the following steps to publish a WSDL from Application Explorer to Oracle Service Bus:

  1. Start Application Explorer, connect to a J2CA configuration, and connect to a PeopleSoft target.

    For more information, see Chapter 2, "Configuring Oracle Application Adapter for PeopleSoft".

  2. Expand Component Interfaces.

  3. Right-click the DEPT business object and select Create Outbound JCA Service(Request/Response) from the menu, as shown in Figure 7-7.

    Figure 7-7 Create Outbound JCA Service(Request/Response) Option

    browse metadata
    Description of "Figure 7-7 Create Outbound JCA Service(Request/Response) Option"

    The Export WSDL dialog is displayed, as shown in Figure 7-8.

    Figure 7-8 Export WSDL Dialog

    Export WSDL dialog
    Description of "Figure 7-8 Export WSDL Dialog"

  4. In the Name field, a default file name for the WSDL file is provided. You can accept the default or provide your own.

  5. Select the Export to OSB option.

  6. In the Location field, enter the folder name in Oracle Service Bus where you want to publish the WSDL document.

    The location is composed of an Oracle Service Bus project name and optionally, one or more folder names. The project name and any folder names must be separated by a forward slash character “/”.

  7. In the Host field, enter the name of the machine where Oracle Service Bus is installed.

  8. In the Port field, enter the port that is being used by Oracle Service Bus.

  9. In the User field, enter your username to access Oracle Service Bus.

  10. In the Password field, enter your password to access Oracle Service Bus.

  11. Click OK.

    The WSDL is published to the location specified in the Export WSDL dialog and is now available for use with a Business Service or Proxy Service in Oracle Service Bus.

Configuring a WSDL-based Business Service

Perform the following steps to configure a WSDL-based business service:

  1. Open the Oracle Service Bus Console and select the created WSDL folder in the left pane (for example, wsdls), as shown in Figure 7-9.

  2. Ensure that the exported WSDL is listed, as shown in Figure 7-10.

    Figure 7-10 Exported WSDL

    exported WSDL
    Description of "Figure 7-10 Exported WSDL"

  3. Click the icon that corresponds to the exported WSDL in the Actions column.

    The Generate WSDL and Service page is displayed, as shown in Figure 7-11.

    Figure 7-11 Generate WSDL and Service Page

    Generate WSDL and Service page
    Description of "Figure 7-11 Generate WSDL and Service Page"

  4. Provide a new WSDL name and a new service name in the corresponding fields, as shown in Figure 7-12.

    Figure 7-12 WSDL Name and New Service Name Fields

    Generate WSDL and Service page
    Description of "Figure 7-12 WSDL Name and New Service Name Fields"

  5. In the Location area, select an available project and the sub-folder that is designated for Business Services.

  6. Click Generate.

    If the WSDL and Service resources are successfully created, the following message is displayed, as shown in Figure 7-13.

    Figure 7-13 Resources Created Successfully Message

    success message
    Description of "Figure 7-13 Resources Created Successfully Message"

Configuring a File Type Business Service

Perform the following steps to configure a File type Business Service:

  1. Select the Business Service folder you created in the left pane, as shown in Figure 7-14.

    Figure 7-14 Business Service Folder

    Select Business Service
    Description of "Figure 7-14 Business Service Folder"

  2. In the right pane, select Business Service from the Create Resource menu, as shown in Figure 7-15.

    Figure 7-15 Business Service

    Select Business Service
    Description of "Figure 7-15 Business Service"

    The General Configuration page is displayed, as shown in Figure 7-16.

    Figure 7-16 General Configuration Page

    General Configuration page
    Description of "Figure 7-16 General Configuration Page"

  3. Provide a name for the Business Service and from the Service Type area select Messaging Service.

  4. Click Next.

    The Message Type Configuration page is displayed, as shown in Figure 7-17.

    Figure 7-17 Message Type Configuration Page

    Message Type Configuration page
    Description of "Figure 7-17 Message Type Configuration Page"

  5. Select XML as the Request Message Type and None as the Response Message Type.

  6. Click Next.

    The Transport Configuration page is displayed, as shown in Figure 7-18.

    Figure 7-18 Transport Configuration Page

    Transport Configuration page
    Description of "Figure 7-18 Transport Configuration Page"

  7. Select file from the Protocol list.

  8. Enter the path to a destination folder on your file system in the Endpoint URI field and click Add.

  9. Click Next, as shown in Figure 7-19.

    Figure 7-19 Transport Configuration Page

    Transport Configuration page
    Description of "Figure 7-19 Transport Configuration Page"

    The FILE Transport Configuration page is displayed, as shown in Figure 7-20.

    Figure 7-20 FILE Transport Configuration Page

    FILE Transport Configuration page
    Description of "Figure 7-20 FILE Transport Configuration Page"

  10. Enter the prefix and suffix for the output file to be received and click Next.

    The Message Handling and Advanced Settings page is displayed, as shown in Figure 7-21.

    Figure 7-21 Message Handling and Advanced Settings Page

    Message Handling page
    Description of "Figure 7-21 Message Handling and Advanced Settings Page"

  11. Click Next.

    The following Summary page is displayed, as shown in Figure 7-22.

  12. Review all the information for your Business Service and click Save.

  13. Check if the success message is displayed once it is saved, as shown in Figure 7-23.

    Figure 7-23 Success Message

    Success Message
    Description of "Figure 7-23 Success Message"

Configuring a Proxy Service

Perform the following steps to configure a Proxy Service:

  1. Select the Proxy Service folder you created in the left pane, as shown in Figure 7-24.

    Figure 7-24 Proxy Service

    Select Proxy Service
    Description of "Figure 7-24 Proxy Service"

  2. In the right pane, select Proxy Service from the Create Resource menu.

    The General Configuration page is displayed, as shown in Figure 7-25

    Figure 7-25 General Configuration Page

    General Configuration
    Description of "Figure 7-25 General Configuration Page"

  3. Provide a name for the Proxy Service and from the Service Type area select Any XML Service.

  4. Click Next, as shown in Figure 7-26.

    Figure 7-26 Transport Configuration Page

    Transport Configuration page
    Description of "Figure 7-26 Transport Configuration Page"

  5. Select file from the Protocol list.

  6. Enter the path to an input folder on your file system in the Endpoint URI field.

  7. Click Next, as shown in Figure 7-27.

    Figure 7-27 FILE Transport Configuration Page

    File Transport Configuration page
    Description of "Figure 7-27 FILE Transport Configuration Page"

  8. Provide any folder locations on your file system for the Stage Directory and Error Directory fields.

  9. Click Next, as shown in Figure 7-28.

    Figure 7-28 Message Handling Page

    Message Handling page
    Description of "Figure 7-28 Message Handling Page"

  10. Accept the default values and click Next.

    The following Summary page is displayed, as shown in Figure 7-29.

  11. Review all the information for your Proxy Service and click Save.

  12. Check if the success message is displayed, as shown in Figure 7-30.

    Figure 7-30 Success Message

    success message
    Description of "Figure 7-30 Success Message"

Configuring a Pipeline

Perform the following steps to configure a Pipeline:

  1. Click the Edit Message Flow icon in the row of the Proxy Service you created, as shown in Figure 7-31.

    Figure 7-31 Edit Message Flow Icon

    Edit Message Flow Icon
    Description of "Figure 7-31 Edit Message Flow Icon"

    The Edit Message Flow workspace area is displayed, as shown in Figure 7-32.

    Figure 7-32 Edit Message Flow Workspace Area

    Edit Message Flow workspace
    Description of "Figure 7-32 Edit Message Flow Workspace Area"

  2. Click the Proxy Service icon and select Add Pipeline Pair from the menu, as shown in Figure 7-33.

    Figure 7-33 Add Pipeline Pair

    Add Pipeline Pair
    Description of "Figure 7-33 Add Pipeline Pair"

  3. Click the Request Pipeline icon and select Add Route from the menu, as shown in Figure 7-34.

    The RouteNode1 icon is added below the Request Pipeline icon.

    Figure 7-35 Edit Route Option

    Edit Stage
    Description of "Figure 7-35 Edit Route Option"

  4. Click the RouteNode1 icon and select Edit Route from the menu, as shown in Figure 7-35.

    The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-36.

    Figure 7-36 Edit Stage Configuration Workspace Area

    Add Log
    Description of "Figure 7-36 Edit Stage Configuration Workspace Area"

  5. Click Add an Action, select Communication from the menu, and click Routing.

    Figure 7-37 Route Destination

    Edit Expression
    Description of "Figure 7-37 Route Destination"

  6. Click <Service>, as shown in Figure 7-37.

    The Select Service dialog is displayed, as shown in Figure 7-38.

    Figure 7-38 Select Service Dialog

    Select Service dialog
    Description of "Figure 7-38 Select Service Dialog"

  7. Select a WSDL type Business Service and click Submit.

    You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-39.

    Figure 7-39 Edit Stage Configuration Workspace Area

    Edit Stage Configuration
    Description of "Figure 7-39 Edit Stage Configuration Workspace Area"

  8. Select the name of the PeopleSoft business object (for example, DEPT) as the operational attribute from the list, as shown in Figure 7-40.

    Figure 7-40 Operational Attribute

    Edit Stage Configuration
    Description of "Figure 7-40 Operational Attribute"

  9. Click Save.

  10. Click the Response Pipeline icon and select Add Stage from the menu, as shown in Figure 7-41.

    The Stage1 icon is added below the Response Pipeline icon.

    Figure 7-42 Edit Stage Selected

    Edit Stage
    Description of "Figure 7-42 Edit Stage Selected"

  11. Click the Stage1 icon and select Edit Stage from the menu, as shown in Figure 7-42.

    The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-43.

    Figure 7-43 Edit Stage Configuration Workspace Area

    Select Publish
    Description of "Figure 7-43 Edit Stage Configuration Workspace Area"

  12. Click Add an Action, select Communication from the menu, and click Publish.

    Figure 7-44 Edit Stage Configuration Workspace Area

    Add Service
    Description of "Figure 7-44 Edit Stage Configuration Workspace Area"

  13. Click <Service>, as shown in Figure 7-44.

    The Select Service dialog is displayed, as shown in Figure 7-45.

    Figure 7-45 Select Service Dialog

    Select Service dialog
    Description of "Figure 7-45 Select Service Dialog"

  14. Select a File type Business Service and click Submit.

    You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-46.

    Figure 7-46 Edit Stage Configuration Workspace Area

    Edit Stage Configuration
    Description of "Figure 7-46 Edit Stage Configuration Workspace Area"

  15. Click Save.

    You are returned to the Edit Message Flow workspace area, as shown in Figure 7-47.

    Figure 7-47 Edit Message Flow Workspace Area

    Edit Message Flow
    Description of "Figure 7-47 Edit Message Flow Workspace Area"

  16. Click Save.

    Figure 7-48 Successful Update Message

    success message
    Description of "Figure 7-48 Successful Update Message"

  17. Check if the success message is displayed and click Activate in the Change Center, as shown in Figure 7-48.

    The Activate Session page is displayed, as shown in Figure 7-49.

    Figure 7-49 Activate Session Page

    Activate Session page
    Description of "Figure 7-49 Activate Session Page"

  18. Click Submit.

  19. Check if the View Configuration Changes page is displayed, as shown in Figure 7-50.

    Figure 7-50 View Configuration Changes Page

    View Configuration Changes page
    Description of "Figure 7-50 View Configuration Changes Page"

  20. Copy and paste an input XML file in the input folder you have configured, as shown in Figure 7-51.

    Figure 7-51 Input XML File

    Input XML document
    Description of "Figure 7-51 Input XML File"

  21. Output is received in the configured output location.

Configuring Inbound Processing Using Oracle Service Bus (J2CA Configuration)

This section describes how to configure inbound processing using Oracle Service Bus for J2CA configurations.

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

This section includes the following topics:

Starting Oracle Service Bus and Creating Project Folders

Perform the following steps to start Oracle Service Bus and create project folders:

  1. Start the Oracle WebLogic Server for the Oracle WebLogic Server domain that you have configured.

  2. Open the Oracle Service Bus Console in a Web browser by entering the following URL:

    http://hostname:port/sbconsole
    

    Where hostname is the name of the machine where Oracle WebLogic Server is running and port is the port for the domain you are using. The port for the default domain is 7001.

    The Oracle Service Bus Console logon page is displayed.

  3. Log on to the Oracle Service Bus Console using a valid user name and password.

    The Oracle Service Bus Console home page is displayed, as shown in Figure 7-52.

    Figure 7-52 Oracle Service Bus Console Home Page

    OSB home
    Description of "Figure 7-52 Oracle Service Bus Console Home Page"

  4. Click Create in the Change Center area to start a new Oracle Service Bus session, as shown in Figure 7-53.

    Figure 7-53 Create Button

    Change Center
    Description of "Figure 7-53 Create Button"

  5. Click Project Explorer in the left pane, as shown in Figure 7-54.

    Figure 7-54 Project Explorer Option

    Project Explorer option
    Description of "Figure 7-54 Project Explorer Option"

    The Project Explorer page is displayed, as shown in Figure 7-55.

    Figure 7-55 Project Explorer Page

    Project Explorer
    Description of "Figure 7-55 Project Explorer Page"

  6. Provide a valid name for the new project and click Add Project.

    The project is successfully created and listed.

  7. Click on the created project.

    The project page is displayed.

    Figure 7-56 Enter New Folder Name Field

    Project page
    Description of "Figure 7-56 Enter New Folder Name Field"

  8. In the Enter New Folder Name field, type Business Service and click Add Folder, as shown in Figure 7-56.

  9. In the Enter New Folder Name field, type Proxy Service and click Add Folder.

  10. In the Enter New Folder Name field, type wsdls and click Add Folder.

    The Business Service, Proxy Service, and wsdls folders are listed in the left pane below the project node, as shown in Figure 7-57.

Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus

Before starting and using Application Explorer to publish a WSDL directly to the Oracle Service Bus (OSB) Console (project/folder), OSB users must perform the following steps:

  1. Open the command prompt window.

  2. Navigate to the following directory:

    <OSB_Home>\user_projects\domains\base_domain\bin
    
  3. Execute setDomainEnv.cmd (Windows) or . ./setDomainEnv.sh (UNIX/Linux).

    This command sets the class path for Application Explorer to access the Oracle WebLogic Server APIs to publish the WSDLs to the OSB Console.

  4. Do not close the command prompt window.

  5. Navigate to the following directory:

    <OSB_Home>\3rdparty\ApplicationAdapters\tools\iwae\bin
    
  6. Execute ae.bat (Windows) or iwae.sh (UNIX/Linux) to start Application Explorer.

    You are now ready to publish WSDLs from Application Explorer to the OSB Console.

Publishing a WSDL From Application Explorer to Oracle Service Bus

Perform the following steps to publish a WSDL from Application Explorer to Oracle Service Bus:

  1. Start Application Explorer, connect to a J2CA configuration, and connect to a PeopleSoft target.

    For more information, see Chapter 2, "Configuring Oracle Application Adapter for PeopleSoft".

  2. Expand Messages.

  3. Right-click the DEPT_SYNC.VERSION.1 business object and select Create Inbound JCA Service(Event) from the menu, as shown in Figure 7-58.

    Figure 7-58 Create Inbound JCA Service(Event) Option

    browse metadata
    Description of "Figure 7-58 Create Inbound JCA Service(Event) Option"

    The Export WSDL dialog is displayed, as shown in Figure 7-59.

    Figure 7-59 Export WSDL Dialog

    Export WSDL dialog
    Description of "Figure 7-59 Export WSDL Dialog"

  4. In the Name field, a default file name for the WSDL file is provided. You can accept the default or provide your own.

  5. Select a configured channel from the Channel list.

    The Validation options can be used for schema validation scenarios, but are optional.

  6. Select the Export to OSB option.

  7. In the Location field, enter the folder name in Oracle Service Bus where you want to publish the WSDL document.

    The location is composed of an Oracle Service Bus project name and optionally, one or more folder names. The project name and any folder names must be separated by a forward slash character “/”.

  8. In the Host field, enter the name of the machine where Oracle Service Bus is installed.

  9. In the Port field, enter the port that is being used by Oracle Service Bus.

  10. In the User field, enter your username to access Oracle Service Bus.

  11. In the Password field, enter your password to access Oracle Service Bus.

  12. Click OK.

    The WSDL is published to the location specified in the Export WSDL dialog and is now available for use with a Proxy Service in Oracle Service Bus.

Configuring a WSDL-based Proxy Service

Perform the following steps to configure a WSDL-based Proxy Service:

  1. Open the Oracle Service Bus Console and select the created WSDL folder in the left pane (for example, wsdls), as shown in Figure 7-60.

  2. Ensure that the exported WSDL is listed, as shown in Figure 7-61.

    Figure 7-61 Exported WSDL

    exported WSDL
    Description of "Figure 7-61 Exported WSDL"

  3. Click the icon that corresponds to the exported WSDL in the Actions column.

    The Generate WSDL and Service page is displayed, as shown in Figure 7-62.

    Figure 7-62 Generate WSDL and Service Page

    Generate WSDL and Service page
    Description of "Figure 7-62 Generate WSDL and Service Page"

  4. Provide a new WSDL name and a new service name in the corresponding fields.

  5. In the Location area, select an available project and the sub-folder that is designated for Proxy Services.

  6. Click Generate.

    If the WSDL and Service resources are successfully created, a message is displayed, as shown in Figure 7-63.

    Figure 7-63 Resources Successfully Created Message

    success message
    Description of "Figure 7-63 Resources Successfully Created Message"

  7. Click Proxy Service under Project Explorer and check if the generated WSDL and Proxy Service are listed, as shown in Figure 7-64.

Configuring a File Type Business Service

Perform the following steps to configure a File type Business Service:

  1. Select the Business Service folder you created in the left pane, as shown in Figure 7-65.

    Figure 7-65 Business Service Folder

    Select Business Service
    Description of "Figure 7-65 Business Service Folder"

  2. In the right pane, select Business Service from the Create Resource menu, as shown in Figure 7-66.

    Figure 7-66 Business Service

    select Business Service
    Description of "Figure 7-66 Business Service"

    The General Configuration page is displayed, as shown in Figure 7-67.

    Figure 7-67 General Configuration Page

    General Configuration page
    Description of "Figure 7-67 General Configuration Page"

  3. Provide a name for the Business Service and from the Service Type area select Messaging Service.

  4. Click Next.

    The Message Type Configuration page is displayed, as shown in Figure 7-68.

    Figure 7-68 Message Type Configuration Page

    Message Type Configuration page
    Description of "Figure 7-68 Message Type Configuration Page"

  5. Select XML as the Request Message Type and None as the Response Message Type.

  6. Click Next.

    The Transport Configuration page is displayed, as shown in Figure 7-69.

    Figure 7-69 Transport Configuration Page

    Transport Configuration page
    Description of "Figure 7-69 Transport Configuration Page"

  7. Select file from the Protocol list.

  8. Enter the path to a destination folder on your file system in the Endpoint URI field and click Add.

  9. Click Next.

    The FILE Transport Configuration page is displayed, as shown in Figure 7-70.

    Figure 7-70 FILE Transport Configuration Page

    FILE Transport Configuration page
    Description of "Figure 7-70 FILE Transport Configuration Page"

  10. Enter the prefix and suffix for the output file to be received and click Next.

    The Message Handling and Advanced Settings page is displayed, as shown in Figure 7-71.

    Figure 7-71 Message Handling and Advanced Settings Page

    Message Handling page
    Description of "Figure 7-71 Message Handling and Advanced Settings Page"

  11. Click Next.

    The following Summary page is displayed, as shown in Figure 7-72.

  12. Review all the information for your Business Service and click Save.

  13. Check if the success message is displayed once it is saved, as shown in Figure 7-73.

    Figure 7-73 Success Message

    Success Message
    Description of "Figure 7-73 Success Message "

Configuring a Pipeline

Perform the following steps to configure a Pipeline:

  1. Click the Edit Message Flow icon in the row of the Proxy Service you created, as shown in Figure 7-74.

    Figure 7-74 Edit Message Flow Icon

    Edit Message Flow Icon
    Description of "Figure 7-74 Edit Message Flow Icon"

    The Edit Message Flow workspace area is displayed, as shown in Figure 7-75.

    Figure 7-75 Edit Message Flow Workspace Area

    Edit Message Flow workspace
    Description of "Figure 7-75 Edit Message Flow Workspace Area"

  2. Right-click the displayed Proxy Service icon and select Add Route from the menu.

    The RouteNode1 icon is added below the Request Pipeline icon.

  3. Click the RouteNode1 icon and select Edit Route from the menu, as shown in Figure 7-76.

    The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-77.

    Figure 7-77 Edit Stage Configuration Workspace Area

    select Routing
    Description of "Figure 7-77 Edit Stage Configuration Workspace Area"

  4. Click Add an Action, select Communication from the menu, and click Routing.

    Figure 7-78 Edit Stage Configuration Page

    Edit Expression
    Description of "Figure 7-78 Edit Stage Configuration Page"

  5. Click <Service>, as shown in Figure 7-78.

    The Select Service dialog is displayed, as shown in Figure 7-79.

    Figure 7-79 Select Service Dialog

    Select Service dialog
    Description of "Figure 7-79 Select Service Dialog"

  6. Select the File type Business Service and click Submit.

    You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-80.

    Figure 7-80 Edit Stage Configuration Workspace Area

    Edit Stage Configuration
    Description of "Figure 7-80 Edit Stage Configuration Workspace Area"

  7. Click Save.

    You are returned to the Edit Message Flow workspace area, as shown in Figure 7-81.

    Figure 7-81 Edit Message Flow Workspace Area

    Edit Message Flow
    Description of "Figure 7-81 Edit Message Flow Workspace Area"

  8. Click Save.

    Figure 7-82 Successful Update Message

    Activate button
    Description of "Figure 7-82 Successful Update Message"

  9. Check if the success message is displayed and click Activate in the Change Center, as shown in Figure 7-82.

    The Activate Session page is displayed, as shown in Figure 7-83.

    Figure 7-83 Activate Session Page

    Surrounding text describes Figure 7-83 .
  10. Click Submit.

  11. Check if the View Configuration Changes page is displayed, as shown in Figure 7-84.

    Figure 7-84 View Configuration Changes Page

    View Configuration Changes page
    Description of "Figure 7-84 View Configuration Changes Page"

  12. Trigger an event from the PeopleSoft system and check if the output is received in the configured output location.

Configuring Outbound Processing Using Oracle Service Bus (BSE Configuration)

This section describes how to configure outbound processing using Oracle Service Bus for BSE configurations.

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

This section includes the following topics:

Starting Oracle Service Bus and Creating Project Folders

Perform the following steps to start Oracle Service Bus and create project folders:

  1. Start the Oracle WebLogic Server for the Oracle WebLogic Server domain that you have configured.

  2. Open the Oracle Service Bus Console in a Web browser by entering the following URL:

    http://hostname:port/sbconsole
    

    Where hostname is the name of the machine where Oracle WebLogic Server is running and port is the port for the domain you are using. The port for the default domain is 7001.

    The Oracle Service Bus Console logon page is displayed.

  3. Log on to the Oracle Service Bus Console using a valid user name and password.

    The Oracle Service Bus Console home page is displayed, as shown in Figure 7-1.

    Figure 7-85 Oracle Service Bus Console Home Page

    OSB home
    Description of "Figure 7-85 Oracle Service Bus Console Home Page"

  4. Click Create in the Change Center area to start a new Oracle Service Bus session, as shown in Figure 7-2.

    Figure 7-86 Change Center

    Change Center
    Description of "Figure 7-86 Change Center"

  5. Click Project Explorer in the left pane, as shown in Figure 7-3.

    Figure 7-87 Project Explorer Option

    Project Explorer option
    Description of "Figure 7-87 Project Explorer Option"

    The Project Explorer page is displayed, as shown in Figure 7-4.

    Figure 7-88 Project Explorer Page

    Project Explorer
    Description of "Figure 7-88 Project Explorer Page"

  6. Provide a valid name for the new project and click Add Project.

    The project is successfully created and listed.

  7. Click on the created project.

    The project page is displayed.

    Figure 7-89 Enter New Folder Name Field

    Project page
    Description of "Figure 7-89 Enter New Folder Name Field"

  8. In the Enter New Folder Name field, type Business Service and click Add Folder, as shown in Figure 7-5.

  9. In the Enter New Folder Name field, type Proxy Service and click Add Folder.

  10. In the Enter New Folder Name field, type wsdls and click Add Folder.

    The Business Service, Proxy Service, and wsdls folders are listed in the left pane below the project node, as shown in Figure 7-6.

Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus

Before starting and using Application Explorer to publish a WSDL directly to the Oracle Service Bus (OSB) Console (project/folder), OSB users must perform the following steps:

  1. Open the command prompt window.

  2. Navigate to the following directory:

    <OSB_Home>\user_projects\domains\base_domain\bin
    
  3. Execute setDomainEnv.cmd (Windows) or . ./setDomainEnv.sh (UNIX/Linux).

    This command sets the class path for Application Explorer to access the Oracle WebLogic Server APIs to publish the WSDLs to the OSB Console.

  4. Do not close the command prompt window.

  5. Navigate to the following directory:

    <OSB_Home>\3rdparty\ApplicationAdapters\tools\iwae\bin
    
  6. Execute ae.bat (Windows) or iwae.sh (UNIX/Linux) to start Application Explorer.

    You are now ready to publish WSDLs from Application Explorer to the OSB Console.

Publishing a WSDL From Application Explorer to Oracle Service Bus

This section describes how to publish a WSDL from Application Explorer (BSE configuration) to Oracle Service Bus.

  1. Start Application Explorer, connect to a BSE configuration, and connect to a PeopleSoft target, as shown in Figure 7-91.

    Figure 7-91 BSE Configuration

    browse metadata
    Description of "Figure 7-91 BSE Configuration"

  2. Expand the Component Interfaces node and select the DEPT component interface.

  3. Right-click the DEPT component interface and select Create Web Service from the menu.

    The Create Web Service dialog is displayed, as shown in Figure 7-92.

    Figure 7-92 Create Web Service Dialog

    Create Web Service dialog
    Description of "Figure 7-92 Create Web Service Dialog"

  4. Enter a service name and click Next.

  5. Click OK on the next dialog that is displayed.

    Application Explorer switches the view to the Business Services node, and the new Web service appears in the left pane, as shown in Figure 7-93.

    Figure 7-93 Business Services Node

    New Web Service
    Description of "Figure 7-93 Business Services Node"

  6. Right-click the new Web service and select Export WSDL from the menu.

    The Export WSDL dialog is displayed, as shown in Figure 7-94.

    Figure 7-94 Export WSDL Dialog

    Export WSDL dialog
    Description of "Figure 7-94 Export WSDL Dialog"

  7. In the Name field, a default file name for the WSDL file is provided. You can accept the default or provide your own.

  8. In the Location field, enter the location where you want to publish the WSDL document.

    The location is composed of an Oracle Service Bus project name and optionally, one or more folder names. The project name and any folder names must be separated by a forward slash character “/”.

  9. In the Host field, enter the name of the machine where Oracle WebLogic Server is running.

  10. In the Port field, enter the port for the domain you are using.

  11. In the User field, enter your username to access Oracle Service Bus.

  12. In the Password field, enter your password to access Oracle Service Bus.

  13. Click OK.

    The WSDL is published to the location specified in the Export WSDL dialog and is now available for use with a Business Service or Proxy Service in Oracle Service Bus.

Configuring a File Type Business Service

This section describes how to configure a File type Business Service using the Oracle Service Bus Console.

  1. Select the Business Service folder you created in the left pane, as shown in Figure 7-95.

    Figure 7-95 Business Service

    Select Business Service
    Description of "Figure 7-95 Business Service"

  2. In the right pane, select Business Service from the Create Resource menu.

    The General Configuration page is displayed, as shown in Figure 7-96.

    Figure 7-96 General Configuration Page

    General Configuration
    Description of "Figure 7-96 General Configuration Page"

  3. Provide a name for the Business Service and from the Service Type area select Messaging Service.

  4. Click Next.

    The Message Type Configuration page is displayed, as shown in Figure 7-97.

    Figure 7-97 Message Type Configuration Page

    Message Type Configuration
    Description of "Figure 7-97 Message Type Configuration Page"

  5. Select XML as the Request Message Type and None as the Response Message Type.

  6. Click Next.

    The Transport Configuration page is displayed, as shown in Figure 7-98.

    Figure 7-98 Transport Configuration Page

    Transport Configuration
    Description of "Figure 7-98 Transport Configuration Page"

  7. Select file from the Protocol list.

  8. Enter the path to a destination folder on your file system in the Endpoint URI field and click Add.

  9. Click Next.

    The FILE Transport Configuration page is displayed, as shown in Figure 7-99.

    Figure 7-99 FILE Transport Configuration Page

    FILE Transport Configuration
    Description of "Figure 7-99 FILE Transport Configuration Page"

  10. Enter the prefix and suffix for the output file to be received and click Next.

    The Summary page is displayed, as shown in Figure 7-100.

    Figure 7-100 Summary Page

    Summary
    Description of "Figure 7-100 Summary Page"

  11. Review all the information for your Business Service and click Save.

Configuring a WSDL Type Business Service

This section describes how to configure a WSDL type Business Service using the Oracle Service Bus Console.

  1. Select the Business Service folder you created in the left pane, as shown in Figure 7-101.

    Figure 7-101 Business Service

    Select Business Service
    Description of "Figure 7-101 Business Service"

  2. In the right pane, select Business Service from the Create Resource menu.

    The General Configuration page is displayed, as shown in Figure 7-102.

    Figure 7-102 General Configuration Page

    General Configuration
    Description of "Figure 7-102 General Configuration Page"

  3. Provide a name for the Business Service and from the Service Type area select WSDL Web Service.

  4. Click Browse.

    The Select a WSDL dialog is displayed, as shown in Figure 7-103.

    Figure 7-103 Select a WSDL Dialog

    Select a WSDL dialog
    Description of "Figure 7-103 Select a WSDL Dialog"

  5. Select a BSE WSDL that you published for Oracle Application Adapter for PeopleSoft using Application Explorer and click Submit.

    The Select a WSDL Definition dialog is displayed, as shown in Figure 7-104.

    Figure 7-104 Select a WSDL Definition Dialog

    Select WSDL dialog
    Description of "Figure 7-104 Select a WSDL Definition Dialog"

  6. Select the WSDL definition under the Ports section and click Submit.

    You are returned to the General Configuration page where the WSDL you selected is now available, as shown in Figure 7-105.

    Figure 7-105 General Configuration Page

    General Configuration
    Description of "Figure 7-105 General Configuration Page"

  7. Leave the default values and click Next.

    The Transport Configuration page is displayed, as shown in Figure 7-106.

    Figure 7-106 Transport Configuration Page

    Transport Configuration
    Description of "Figure 7-106 Transport Configuration Page"

  8. Leave the default values and click Next.

    The HTTP Transport Configuration page is displayed, as shown in Figure 7-107.

    Figure 7-107 HTTP Transport Configuration Page

    HTTP Transport Configuration
    Description of "Figure 7-107 HTTP Transport Configuration Page"

  9. Leave the default values and click Next.

    The SOAP Binding Configuration page is displayed, as shown in Figure 7-108.

    Figure 7-108 SOAP Binding Configuration

    SOAP Binding Configuration
    Description of "Figure 7-108 SOAP Binding Configuration"

  10. Click Next.

    The Message Content Handling page is displayed, as shown in Figure 7-109.

    Figure 7-109 Message Content Handling Page

    Message Content Heading
    Description of "Figure 7-109 Message Content Handling Page"

  11. Click Next.

    The Summary page is displayed, as shown in Figure 7-110.

    Figure 7-110 Summary Page

    Summary
    Description of "Figure 7-110 Summary Page"

  12. Review all the information for your Business Service and click Save.

Configuring a Proxy Service

This section describes how to configure a Proxy Service using the Oracle Service Bus Console.

  1. Select the Proxy Service folder you created in the left pane, as shown in Figure 7-111.

    Figure 7-111 Proxy Service

    Select Proxy Service
    Description of "Figure 7-111 Proxy Service"

  2. In the right pane, select Proxy Service from the Create Resource menu.

    The General Configuration page is displayed, as shown in Figure 7-112.

    Figure 7-112 General Configuration Page

    General Configuration
    Description of "Figure 7-112 General Configuration Page"

  3. Provide a name for the Proxy Service and from the Service Type area select Any XML Service.

  4. Click Next.

    The Transport Configuration page is displayed, as shown in Figure 7-113.

    Figure 7-113 Transport Configuration Page

    Transport Configuration
    Description of "Figure 7-113 Transport Configuration Page"

  5. Select file from the Protocol list.

  6. Enter the path to an input folder on your file system in the Endpoint URI field.

  7. Click Next.

    The FILE Transport Configuration page is displayed, as shown in Figure 7-114.

    Figure 7-114 FILE Transport Configuration Page

    File Transport Configuration
    Description of "Figure 7-114 FILE Transport Configuration Page"

  8. Provide any folder locations on your file system for the Stage Directory and Error Directory fields.

  9. Click Next.

    The Message Content Handling page is displayed, as shown in Figure 7-115.

    Figure 7-115 Message Content Handling Page

    Message Content Heading
    Description of "Figure 7-115 Message Content Handling Page"

  10. Click Next.

    The Summary page is displayed, as shown in Figure 7-116.

    Figure 7-116 Summary Page

    Summary
    Description of "Figure 7-116 Summary Page"

  11. Review all the information for your Proxy Service and click Save.

Configuring a Pipeline

This section describes how to configure a Pipeline using the Oracle Service Bus Console.

  1. Click the Edit Message Flow icon in the row of the Proxy Service you created, as shown in Figure 7-117.

    Figure 7-117 Edit Message Flow Icon

    Edit Message Flow Icon
    Description of "Figure 7-117 Edit Message Flow Icon"

    The Edit Message Flow workspace area is displayed.

  2. Click the Proxy Service icon and select Add Pipeline Pair from the menu, as shown in Figure 7-118.

    Figure 7-118 Add Pipeline Pair Option

    Add Pipeline Pair
    Description of "Figure 7-118 Add Pipeline Pair Option"

  3. Click the PipelinePairNode1 icon and select Add Route from the menu, as shown in Figure 7-119.

    Figure 7-119 Add Route Option

    Edit Route
    Description of "Figure 7-119 Add Route Option"

  4. Click the RouteNode1 icon and select Edit Route from the menu, as shown in Figure 7-120.

  5. Click Add an Action, select Communication from the menu, and click Routing.

    The Route Node configuration page is displayed, as shown in Figure 7-121.

    Figure 7-121 Route Node Configuration Page

    Add Service
    Description of "Figure 7-121 Route Node Configuration Page"

  6. Click <Service>.

    The Select Service dialog is displayed, as shown in Figure 7-122.

    Figure 7-122 Select Service Dialog

    Select Service dialog
    Description of "Figure 7-122 Select Service Dialog"

  7. Select a WSDL type Business Service and click Submit.

    You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-123.

    Figure 7-123 Edit Stage Configuration Workspace Area

    Edit Stage Configuration
    Description of "Figure 7-123 Edit Stage Configuration Workspace Area"

  8. Select DEPT as the operational attribute from the list.

  9. Click Validate and then Save.

  10. Click the Response Pipeline icon and select Add Stage from the menu, as shown in Figure 7-124.

    The Stage1 icon is added below the Response Pipeline icon, as shown in Figure 7-125.

    Figure 7-125 Stage 1 Icon

    Edit Stage
    Description of "Figure 7-125 Stage 1 Icon"

  11. Click the Stage1 icon and select Edit Stage from the menu.

    The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-126.

    Figure 7-126 Edit Stage Configuration Workspace Area

    Select Publish
    Description of "Figure 7-126 Edit Stage Configuration Workspace Area"

  12. Click Add an Action, select Communication from the menu, and click Publish.

    The Publish configuration page is displayed, as shown in Figure 7-127.

    Figure 7-127 Publish Configuration Page

    Add Service
    Description of "Figure 7-127 Publish Configuration Page"

  13. Click <Service>.

    The Select Service dialog is displayed, as shown in Figure 7-128.

    Figure 7-128 Select Service Dialog

    Select Service dialog
    Description of "Figure 7-128 Select Service Dialog"

  14. Select a File type Business Service and click Submit.

    You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-129.

    Figure 7-129 Edit Stage Configuration Workspace Area

    Add Log
    Description of "Figure 7-129 Edit Stage Configuration Workspace Area"

  15. Click Validate and then Save.

    The pipeline configuration is now completed, as shown in Figure 7-130.

    Figure 7-130 Completed Pipeline Configuration

    Completed Message Flow
    Description of "Figure 7-130 Completed Pipeline Configuration"

  16. Click Save.

  17. Click Activate in the Change Center area to activate your changes in the Oracle Service Bus session, as shown in Figure 7-131.

    Figure 7-131 Change Center Area

    Change Center
    Description of "Figure 7-131 Change Center Area"

  18. Copy and paste an input XML file in the input folder you have configured to receive an output XML file in the destination folder.