Oracle Application Adapter for J.D. Edwards OneWorld 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
Configuring Outbound Processing Using Oracle Service Bus (J2CA Configuration)
Configuring Inbound Processing Using Oracle Service Bus (J2CA Configuration)
Configuring Outbound Processing Using Oracle Service Bus (BSE Configuration)
To integrate with Oracle Service Bus (OSB), Oracle Application Adapter for J.D. Edwards OneWorld 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.
This section describes how to configure outbound processing using Oracle Service Bus for J2CA configurations.
This section includes the following topics:
Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus
Publishing a WSDL From Application Explorer to Oracle Service Bus
Samples have been provided for this use case scenario under the etc/sample
folder of the Application Adapters installation.
Perform the following steps to start Oracle Service Bus and create project folders:
Start the Oracle WebLogic Server for the Oracle WebLogic Server domain that you have configured.
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.
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.
Click Create in the Change Center area to start a new Oracle Service Bus session, as shown in Figure 7-2.
Click Project Explorer in the left pane, as shown in Figure 7-3.
The Project Explorer page is displayed, as shown in Figure 7-4.
Provide a valid name for the new project (for example, JDE_Project) and click Add Project.
The project is successfully created and listed.
Click on the created project.
The project page is displayed, as shown in Figure 7-5.
In the Enter New Folder Name field, type Business Service and click Add Folder.
In the Enter New Folder Name field, type Proxy Service and click Add Folder.
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.
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:
Open the command prompt window.
Navigate to the following directory:
<OSB_Home>\user_projects\domains\base_domain\bin
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.
Do not close the command prompt window.
Navigate to the following directory:
<OSB_Home>\3rdparty\ApplicationAdapters\tools\iwae\bin
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.
Perform the following steps to publish a WSDL from Application Explorer to Oracle Service Bus:
Start Application Explorer, connect to a J2CA configuration, and connect to a J.D. Edwards OneWorld target.
For more information, see Chapter 2, "Configuring Oracle Application Adapter for J.D. Edwards OneWorld".
Expand Services, CALLBSFN, and Addressbook, as shown in Figure 7-7.
Figure 7-7 Create Outbound JCA Service (Request/Response) Option
Right-click GetEffectiveAddress, and then select Create Outbound JCA Service (Request/Response).
The Export WSDL dialog is displayed, as shown in Figure 7-8.
In the Name field, a default file name for the WSDL file is provided. You can accept the default or provide your own.
Select the Export to OSB option.
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 “/”.
In the Host field, enter the name of the machine where Oracle Service Bus is installed.
In the Port field, enter the port that is being used by Oracle Service Bus.
In the User field, enter your username to access Oracle Service Bus.
In the Password field, enter your password to access Oracle Service Bus.
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.
Perform the following steps to configure a WSDL-based Business Service:
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.
Ensure that the exported WSDL is listed, as shown in Figure 7-10.
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
Provide a new WSDL name and a new service name in the corresponding fields, as shown in Figure 7-12.
Figure 7-12 Generate WSDL and Service Page
In the Location area, select an available project and the sub-folder that is designated for Business Services.
Click Generate.
If the WSDL and Service resources are successfully created, then the following message is displayed, as shown in Figure 7-13.
Perform the following steps to configure a File type Business Service:
Select the Business Service folder you created in the left pane, as shown in Figure 7-14.
In the right pane, select Business Service from the Create Resource menu, as shown in Figure 7-15.
The General Configuration page is displayed, as shown in Figure 7-16.
Provide a name for the Business Service and from the Service Type area select Messaging Service.
Click Next.
The Message Type Configuration page is displayed, as shown in Figure 7-17.
Figure 7-17 Message Type Configuration Page
Select XML as the Request Message Type and None as the Response Message Type.
Click Next.
The Transport Configuration page is displayed, as shown in Figure 7-18.
Select file from the Protocol list.
Enter the path to a destination folder on your file system in the Endpoint URI field and click Add.
Click Next, as shown in Figure 7-19.
The FILE Transport Configuration page is displayed, as shown in Figure 7-20.
Figure 7-20 FILE Transport Configuration Page
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
Click Next.
The following Summary page is displayed, as shown in Figure 7-22.
Review all the information for your Business Service and click Save.
Perform the following steps to configure a Proxy Service:
Select the Proxy Service folder you created in the left pane, as shown in Figure 7-23.
Figure 7-23 Create Resource Menu Proxy Service
In the right pane, select Proxy Service from the Create Resource menu.
The General Configuration page is displayed, as shown in Figure 7-24.
Provide a name for the Proxy Service and from the Service Type area select Any XML Service.
Click Next, as shown in Figure 7-25.
Select file from the Protocol list.
Enter the path to an input folder on your file system in the Endpoint URI field.
Click Next, as shown in Figure 7-26.
Figure 7-26 FILE Transport Configuration Page
Provide any folder locations on your file system for the Stage Directory and Error Directory fields.
Click Next, as shown in Figure 7-27.
Accept the default values and click Next.
The following Summary page is displayed, as shown in Figure 7-28.
Review all the information for your Proxy Service and click Save.
Check if the success message is displayed, as shown in Figure 7-29.
Perform the following steps to configure a Pipeline:
Click the Edit Message Flow icon in the row of the Proxy Service you created, as shown in Figure 7-30.
The Edit Message Flow workspace area is displayed, as shown in Figure 7-31.
Figure 7-31 Edit Message Flow Workspace Area
Click the Proxy Service icon and select Add Pipeline Pair from the menu.
Click the PipelinePairNode1 icon and select Add Route from the menu, as shown in Figure 7-32.
The RouteNode1 icon is added below the Request Pipeline icon, as shown in Figure 7-33.
Click the RouteNode1 icon and select Edit Route from the menu.
The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-34.
Figure 7-34 Edit Stage Configuration Workspace Area
Click Add an Action, select Communication from the menu, and click Routing, as shown in Figure 7-35.
Figure 7-35 Edit Stage Configuration Workspace Area
Click <Service>.
The Select Service dialog is displayed, as shown in Figure 7-36.
Select a WSDL type Business Service and click Submit.
You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-37.
Figure 7-37 Edit Stage Configuration Workspace Area
Select the name of the J.D. Edwards OneWorld business object (for example, GetEffectiveAddress) as the operational attribute from the list, as shown in Figure 7-38.
Click Save, as shown in Figure 7-39.
Click the Response Pipeline icon and select Add Stage from the menu.
The Stage1 icon is added below the Response Pipeline icon, as shown in Figure 7-40.
Click the Stage1 icon and select Edit Stage from the menu.
The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-41.
Figure 7-41 Edit Stage Configuration Workspace Area
Click Add an Action, select Communication from the menu, and click Publish, as shown in Figure 7-42.
Figure 7-42 Edit Stage Configuration Workspace Area
Click <Service>.
The Select Service dialog is displayed, as shown in Figure 7-43.
Select a File type Business Service and click Submit.
You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-44.
Figure 7-44 Edit Stage Configuration Workspace Area
Click Save.
You are returned to the Edit Message Flow workspace area, as shown in Figure 7-45.
Figure 7-45 Edit Message Flow Workspace Area
Click Save, as shown in Figure 7-46.
Check if the success message is displayed and click Activate in the Change Center.
The Activate Session page is displayed, as shown in Figure 7-47.
Click Submit.
Check if the View Configuration Changes page is displayed, as shown in Figure 7-48.
Figure 7-48 View Configuration Changes Page
Copy and paste an input XML file in the input folder you have configured, as shown in Figure 7-49.
Output is received in the configured output location.
This section describes how to configure inbound processing using Oracle Service Bus for J2CA configurations.
This section includes the following topics:
Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus
Publishing a WSDL From Application Explorer to Oracle Service Bus
Importing the Inbound J.D. Edwards OneWorld WSDL File Into Oracle Service Bus
Samples have been provided for this use case scenario under the etc/sample
folder of the Application Adapters installation.
Perform the following steps to start Oracle Service Bus and create project folders:
Start the Oracle WebLogic Server for the Oracle WebLogic Server domain that you have configured.
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.
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-50.
Figure 7-50 Oracle Service Bus Console Home Page
Click Create in the Change Center area to start a new Oracle Service Bus session, as shown in Figure 7-51.
Click Project Explorer in the left pane, as shown in Figure 7-52.
The Project Explorer page is displayed, as shown in Figure 7-53.
Provide a valid name for the new project (for example, JDE_Project) and click Add Project.
The project is successfully created and listed.
Click on the created project.
The project page is displayed, as shown in Figure 7-54.
In the Enter New Folder Name field, type Business Service and click Add Folder.
In the Enter New Folder Name field, type Proxy Service and click Add Folder.
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-55.
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:
Open the command prompt window.
Navigate to the following directory:
<OSB_Home>\user_projects\domains\base_domain\bin
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.
Do not close the command prompt window.
Navigate to the following directory:
<OSB_Home>\3rdparty\ApplicationAdapters\tools\iwae\bin
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.
Before you publish a WSDL from Application Explorer to Oracle Service Bus, you must create a separate channel for every J2CA event and select that channel when you generate WSDL for inbound interaction using Application Explorer.
Creating a Channel in Application Explorer
To create a channel:
In Application Explorer, connect to a J2CA configuration.
Expand the Events node and then the JDEdwards node, as shown in Figure 7-56.
Figure 7-56 Application Explorer Add Channel Option
Right-click the Channels node, and select Add Channels.
The Add Channel dialog is displayed, as shown in Figure 7-57.
In the Name field, enter a descriptive name for the channel.
In the Description field, enter a description (optional).
From the Protocol list, choose a protocol for your channel.
Click Next.
The dialog is displayed for the selected listener, as shown in Figure 7-58.
Enter the port number of the channel in the Port Number field.
Enter the location of the server in the Host/IP Binding field.
Select the Synchronization type from the Synchronization Type list.
Select Is Length Prefix for events that send data which is not in XML format. The TCP/IP event application must prefix the data with a 4-byte binary length field when writing the data to the TCP/IP port.
Select Is XML for events that send data back in XML format. No preparser is required.
Select Is Keep Alive to maintain a continuous communication between the event transaction and the channel.
Click the PreParser tab, as shown in Figure 7-59.
Enter values based on the table.
Parameter | Description |
---|---|
User id* | A valid user ID for J.D. Edwards OneWorld. |
User password* | The password associated with the user ID. |
JDE environment* | Your J.D. Edwards OneWorld environment. For more information about this parameter, see your J.D. Edwards OneWorld documentation or ask your OneWorld system administrator. |
Application | XMLInterop or the application name in J.D. Edwards OneWorld. Optional. |
Server IP address* | The name of the server on which J.D. Edwards OneWorld is running. This can be the name of the server, for example, JDEOW, or its IP address, for example, 123.45.67.89. |
Server Port* | The port number on which the server is listening, for example, 6009. |
User Role | Define a user role according to your requirements. |
Schema Location | The location of the XML schema (.xsd file) that was generated from the event output. For example:
<OSB_Home>\3rdparty\ApplicationAdapters\config\config_name\schemas\JDEdwards\target_name\jde-schema.xsd |
Schema style | Choose from one of the following options:
|
Click OK.
The channel is created and displayed under the Channels node. An X over the icon indicates that the channel is currently disconnected.
Generating WSDL for Event Notification (Command Prompt Only)
You cannot generate WSDL for J.D. Edwards OneWorld event notification using Application Explorer. To generate WSDL from the command prompt, you must perform the following steps.
You can create inbound J2CA service only if the node you have selected supports events.
Note:
The schema validation options (Root, Namespace, Schema) are not applicable for the Oracle Application Adapter for J.D. Edwards OneWorld.To generate a WSDL file for J.D. Edwards OneWorld event notification:
Create a channel using Application Explorer under the J.D. Edwards Events node.
Start the channel.
Do not restart the Oracle Application Server after the channel is started.
Send an inbound message from J.D. Edwards OneWorld.
Capture the inbound message payload in the log file, which is located in the following directory based on your adapter installation:
For Oracle SOA Suite:
<ORACLE_HOME>\soa\thirdparty\ApplicationAdapters\config\configuration_name\log\iwaf_jca1500.log
For OSB:
<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\config\configuration_name\log\iwaf_jca1500.log
Alternatively, you can create a port using the File protocol under the Events node in Application Explorer, which disposes the event message to the file system.
Use a third party tool (for example, XMLSpy) to create the XML schema (.xsd file) using the XML payload that was captured in the previous step.
In the generated XML schema (.xsd file) perform the following modifications:
Search for Schemas-jdedwards-com
and replace it with iwaysoftware
.
<xs:schematargetNamespace="urn:Schemas-jdedwards-com:trans.response.JDESOOUT" xmlns="urn:Schemas-jdedwards-com:trans.response.JDESOOUT" xmlns:xs=http://www.w3.org/2001/XMLSchema elementFormDefault="qualified">
to:
<xs:schema targetNamespace="urn:iwaysoftware:trans.response.JDESOOUT" xmlns="urn:iwaysoftware:trans.response.JDESOOUT"xmlns:xs=http://www.w3.org/2001/XMLSchema elementFormDefault="qualified">
Cut the following syntax:
<xs:element name="jdeResponse"><xs:complexType> </xs:complexType> </xs:element>
Paste it before the following line:
<xs:element name="transaction">
Copy the XML schema (.xsd file) to the following directory based on your adapter installation:
For Oracle SOA Suite:
<ORACLE_HOME>\soa\thirdparty\ApplicationAdapters\config\configuration_name\schemas\JDEdwards\target_name\
For OSB:
<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\config\configuration_name\schemas\JDEdwards\target_name\
Note:
Edit the created channel by providing the location of the schema (.xsd) file (as mentioned in step 7) in the PreParser tab of Application Explorer. For example:For Oracle SOA Suite:
<ORACLE_HOME>\soa\thirdparty\ApplicationAdapters\config\configuration_name\schemas\JDEdwards\target_name\jde-schema.xsd
For OSB:
<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\config\configuration_name\schemas\JDEdwards\target_name\jde-schema.xsd
Open a command prompt and navigate to the base domain directory and and execute the setDomainEnv.sh
file:
<ORACLE_HOME>\user_projects\domains\base_domain\bin
Navigate to the following Application Explorer directory based on your adapter installation:
For Oracle SOA Suite:
<ORACLE_HOME>\soa\thirdparty\ApplicationAdapters\tools\iwae\bin
For OSB:
<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\tools\iwae\bin
Execute the obadapter.bat
file to set the environment.
Based on your adapter installation, navigate to the following directory where the XML schema (.xsd file) is copied:
For Oracle SOA Suite:
<ORACLE_HOME>\soa\thirdparty\ApplicationAdapters\config\configuration_name\schemas\JDEdwards\target_name\
For OSB:
<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\config\configuration_name\schemas\JDEdwards\target_name\
Enter the following command to generate a WSDL:
java -Diway.oem=oracle11g com.iwaysoftware.af.container.tools.wsdl.IWayWSILBrowser adapterhome adapter target channel schemaPrefix wsdlFileName
where:
adapterhome
is the path to your ApplicationAdapters home. For example:
For Oracle SOA Suite:
<ORACLE_HOME>\soa\thirdparty\ApplicationAdapters\
For OSB:
<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\
adapter
is the name of the adapter. For example, JDEdwards.
target
is the name of the adapter target you created in Application Explorer.
channel
is the name of the channel you created in Application Explorer.
schemaPrefix
is the prefix for the XSD schema. The schema file must be in the same directory where the Java command is executed, for example:
java -Diway.oem=oracle11g com.iwaysoftware.af.container.tools.wsdl.IWayWSILBrowser C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\wsdls\JDEdwards jde812_tgt jde_ch Jde812_Schema Jde812_salesorder_receive.wsdl
Once the command is executed, the following is displayed in the command window:
Running Inbound WSDL generation tool...-> user.dir = java com.iwaysoftware.af.container.tools.wsdl.IWayWSILBrowser C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\wsdls\JDEdwards jde812_tgt jde_ch Jde812_Schema Jde812_salesorder_receive.wsdl -> Generating WSDL...-> Done.-> Writing WSDL 'C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\wsdls\Jde812_salesorder_receive.wsdl ' to disk...-> Done.
Note:
It is good practice to append _receive to the names of WSDL files that are generated for event notification services. This allows you to easily distinguish between them and those generated for request-response services.Stop the channel in Application Explorer.
Note:
You can organize your WSDL files in subfolders, creating your own WSDL hierarchy structure. Create the folders under<OSB_Home>\3rdparty\ApplicationAdapters\wsdls
. The WSIL browser in Oracle JDeveloper displays the full tree structure of your WSDL hierarchy.Once you have generated the inbound WSDL for J.D. Edwards OneWorld, you must import the inbound WSDL file into Oracle Service Bus.
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.
In the right pane, select XML Schema from the Create Resource menu.
The Create a New XML Schema Resource page is displayed, as shown in Figure 7-61.
Figure 7-61 Create a New XML Schema Resource Page
Enter a name for the inbound XML schema in the Resource Name field.
You can also provide a brief description for the resource (optional).
Using the Browse option in the XML Schema field, navigate to the location of the inbound XML schema file (.xsd) on your file system.
Click Save.
The inbound XML schema is added to the OSB console, as shown in Figure 7-62.
In the right pane, select WSDL from the Create Resource menu, as shown in Figure 7-63.
Figure 7-63 Create Resource Menu WSDL Option
The Create a New WSDL Resource page is displayed, as shown in Figure 7-64.
Figure 7-64 Create a New WSDL Resource Page
Enter a name for the inbound WSDL in the Resource Name field.
You can also provide a brief description for the resource (optional).
Using the Browse option in the WSDL field, navigate to the location of the inbound WSDL file (.wsdl) on your file system.
Click Save.
The inbound WSDL is added to the OSB console, as shown in Figure 7-65.
In the right pane, select JCA Binding from the Create Resource menu, as shown in Figure 7-66.
Figure 7-66 Create Resource Menu JCA Binding Option
The Create a New JCA Binding Resource page is displayed, as shown in Figure 7-67.
Figure 7-67 Create a New JCA Binding Resource Page
Enter a name for the inbound JCA binding in the Resource Name field.
You can also provide a brief description for the resource (optional).
Using the Browse option in the JCA File field, navigate to the location of the inbound JCA binding file (.jca) on your file system.
Click Save.
The inbound JCA binding is added to the OSB console, as shown in Figure 7-68.
Click the icon that corresponds to the exported WSDL in the Actions column, as shown in Figure 7-69.
The Generate WSDL and Service page is displayed.
Provide a new WSDL name and a new service name in the corresponding fields, as shown in Figure 7-70.
Figure 7-70 Generate WSDL and Service Page
In the Location area, select an available project and the sub-folder that is designated for Proxy Services.
Click Generate.
If the WSDL and Service resources are successfully created, then the following message is displayed, as shown in Figure 7-71.
Select the Proxy Service folder you created in the left pane and verify that the Proxy Service is successfully generated and listed, as shown in Figure 7-72.
Perform the following steps to configure a File type Business Service:
Select the Business Service folder you created in the left pane, as shown in Figure 7-73.
In the right pane, select Business Service from the Create Resource menu, as shown in Figure 7-74.
The General Configuration page is displayed, as shown in Figure 7-75.
Provide a name for the Business Service and from the Service Type area select Messaging Service.
Click Next.
The Message Type Configuration page is displayed, as shown in Figure 7-76.
Figure 7-76 Message Type Configuration page
Select XML as the Request Message Type and None as the Response Message Type.
Click Next.
The Transport Configuration page is displayed, as shown in Figure 7-77.
Select file from the Protocol list.
Enter the path to a destination folder on your file system in the Endpoint URI field and click Add.
Click Next.
The FILE Transport Configuration page is displayed, as shown in Figure 7-78.
Figure 7-78 FILE Transport Configuration Page
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-79.
Figure 7-79 Message Handling and Advanced Settings Page
Click Next.
The following Summary page is displayed, as shown in Figure 7-80.
Review all the information for your Business Service and click Save.
Perform the following steps to configure a Pipeline:
Click the Edit Message Flow icon in the row of the Proxy Service you created, as shown in Figure 7-81.
The Edit Message Flow workspace area is displayed, as shown in Figure 7-82.
Figure 7-82 Edit Message Flow Workspace Area
Click the displayed Proxy service icon and select Add Route from the menu.
The RouteNode1 icon is added below the Request Pipeline icon, as shown in Figure 7-83.
Figure 7-83 Edit Message Flow Edit Route Option
Click the RouteNode1 icon and select Edit Route from the menu.
The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-84.
Figure 7-84 Edit Stage Configuration Routing Option
Click Add an Action, select Communication from the menu, and click Routing, as shown in Figure 7-85.
Figure 7-85 Edit Stage Configuration Page
Click <Service>.
The Select Service dialog is displayed, as shown in Figure 7-86.
Select a File type Business Service and click Submit.
You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-87.
Figure 7-87 Edit Stage Configuration Workspace Area
Click Save.
You are returned to the Edit Message Flow workspace area, as shown in Figure 7-88.
Figure 7-88 Edit Message Flow Workspace Area
Click Save, as shown in Figure 7-89.
Check if the success message is displayed and click Activate in the Change Center.
The Activate Session page is displayed as shown in Figure 7-90.
Click Submit.
Check if the View Configuration Changes page is displayed, as shown in Figure 7-91.
Figure 7-91 View Configuration Changes Page
Trigger an event from the J.D. Edwards OneWorld system and check if the output is received in the configured output location.
This section describes how to configure outbound processing using Oracle Service Bus for BSE configurations.
This section includes the following topics:
Setting the Class Path for Application Explorer to Integrate With Oracle Service Bus
Publishing a WSDL From Application Explorer to Oracle Service Bus
Samples have been provided for this use case scenario under the etc/sample
folder of the Application Adapters installation.
Perform the following steps to start Oracle Service Bus and create project folders:
Start the Oracle WebLogic Server for the Oracle WebLogic Server domain that you have configured.
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.
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-92.
Figure 7-92 Oracle Service Bus Console Home Page
Click Create in the Change Center area to start a new Oracle Service Bus session, as shown in Figure 7-93.
Click Project Explorer in the left pane, as shown in Figure 7-94.
The Project Explorer page is displayed, as shown in Figure 7-95.
Provide a valid name for the new project (for example, JDE_Project) and click Add Project.
The project is successfully created and listed.
Click on the created project.
The project page is displayed, as shown in Figure 7-96.
In the Enter New Folder Name field, type Business Service and click Add Folder.
In the Enter New Folder Name field, type Proxy Service and click Add Folder.
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-97.
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:
Open the command prompt window.
Navigate to the following directory:
<OSB_Home>\user_projects\domains\base_domain\bin
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.
Do not close the command prompt window.
Navigate to the following directory:
<OSB_Home>\3rdparty\ApplicationAdapters\tools\iwae\bin
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.
This section describes how to publish a WSDL from Application Explorer (BSE configuration) to Oracle Service Bus.
Start Application Explorer, connect to a BSE configuration, and connect to a J.D. Edwards target, as shown in Figure 7-98.
Figure 7-98 Application Explorer Create Web Service Option
Expand the Services node, followed by CALLBSFN and Addressbook.
Right-click the GetEffectiveAddress business object and select Create Web Service from the menu.
The Create Web Service dialog is displayed, as shown in Figure 7-99.
Enter a service name and click Next.
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-100.
Figure 7-100 Application Explorer Export WSDL Option
Right-click the new Web service and select Export WSDL from the menu.
The Export WSDL dialog is displayed, as shown in Figure 7-101.
In the Name field, a default file name for the WSDL file is provided. You can accept the default or provide your own.
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 “/”.
In the Host field, enter the name of the machine where Oracle WebLogic Server is running.
In the Port field, enter the port for the domain you are using.
In the User field, enter your username to access Oracle Service Bus.
In the Password field, enter your password to access Oracle Service Bus.
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.
This section describes how to configure a File type Business Service using the Oracle Service Bus Console.
Select the Business Service folder you created in the left pane, as shown in Figure 7-102.
In the right pane, select Business Service from the Create Resource menu.
The General Configuration page is displayed, as shown in Figure 7-103.
Provide a name for the Business Service and from the Service Type area select Messaging Service.
Click Next.
The Message Type Configuration page is displayed, as shown in Figure 7-104.
Figure 7-104 Message Type Configuration Page
Select XML as the Request Message Type and None as the Response Message Type.
Click Next.
The Transport Configuration page is displayed, as shown in Figure 7-105.
Figure 7-105 Transport Configuration Page
Select file from the Protocol list.
Enter the path to a destination folder on your file system in the Endpoint URI field and click Add.
Click Next.
The FILE Transport Configuration page is displayed, as shown in Figure 7-106.
Figure 7-106 FILE Transport Configuration Page
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-107.
Review all the information for your Business Service and click Save.
This section describes how to configure a WSDL type Business Service using the Oracle Service Bus Console.
Select the Business Service folder you created in the left pane, as shown in Figure 7-108.
In the right pane, select Business Service from the Create Resource menu.
The General Configuration page is displayed, as shown in Figure 7-109.
Provide a name for the Business Service and from the Service Type area select WSDL Web Service.
Click Browse.
The Select a WSDL dialog is displayed, as shown in Figure 7-110.
Select a BSE WSDL that you published for Oracle Application Adapter for J.D. Edwards OneWorld using Application Explorer and click Submit.
The Select a WSDL Definition dialog is displayed, as shown in Figure 7-111.
Figure 7-111 Select a WSDL Definition Dialog
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.
Click Next.
The Transport Configuration page is displayed, as shown in Figure 7-112.
Figure 7-112 Transport Configuration Page
Leave the default values and click Next.
The HTTP Transport Configuration page is displayed, as shown in Figure 7-113.
Figure 7-113 HTTP Transport Configuration Page
Leave the default values and click Next.
The SOAP Binding Configuration page is displayed, as shown in Figure 7-114.
Figure 7-114 SOAP Binding Configuration Page
Click Next.
The Message Content Handling page is displayed, as shown in Figure 7-115.
Figure 7-115 Message Content Handling Page
Click Next.
The Summary page is displayed, as shown in Figure 7-116.
Review all the information for your Business Service and click Save.
This section describes how to configure a Proxy Service using the Oracle Service Bus Console.
Select the Proxy Service folder you created in the left pane, as shown in Figure 7-117.
In the right pane, select Proxy Service from the Create Resource menu.
The General Configuration page is displayed, as shown in Figure 7-118.
Provide a name for the Proxy Service and from the Service Type area select Any XML Service.
Click Next.
The Transport Configuration page is displayed, as shown in Figure 7-119.
Figure 7-119 Transport Configuration Page
Select file from the Protocol list.
Enter the path to an input folder on your file system in the Endpoint URI field.
Click Next.
The FILE Transport Configuration page is displayed, as shown in Figure 7-120.
Figure 7-120 FILE Transport Configuration Page
Provide any folder locations on your file system for the Stage Directory and Error Directory fields.
Click Next.
The Message Content Handling page is displayed, as shown in Figure 7-121.
Figure 7-121 Message Content Handling Page
Click Next.
The Summary page is displayed, as shown in Figure 7-122.
Review all the information for your Proxy Service and click Save.
This section describes how to configure a Pipeline using the Oracle Service Bus Console.
Click the Edit Message Flow icon in the row of the Proxy Service you created, as shown in Figure 7-123.
The Edit Message Flow workspace area is displayed.
Click the Proxy Service icon and select Add Pipeline Pair from the menu, as shown in the following image, as shown in Figure 7-124.
Click the PipelinePairNode1 icon and select Add Route from the menu, as shown in Figure 7-125.
Click the RouteNode1 icon and select Edit Route from the menu, as shown in Figure 7-126.
Figure 7-127 Edit Stage Configuration Routing Option
Click Add an Action, select Communication from the menu, and click Routing, as shown in Figure 7-127.
Figure 7-128 Edit Stage Configuration Workspace Area
Click <Service>.
The Select Service dialog is displayed, as shown in Figure 7-129.
Select a WSDL type Business Service and click Submit.
You are returned to the Edit Stage Configuration workspace area, as shown in Figure 7-130.
Figure 7-130 Edit Stage Configuration Workspace Area
Select GetEffectiveAddress as the operational attribute from the list.
Click Validate and then Save, as shown in Figure 7-131.
Click the Response Pipeline icon and select Add Stage from the menu.
The Stage1 icon is added below the Response Pipeline icon, as shown in Figure 7-132.
Click the Stage1 icon and select Edit Stage from the menu.
The Edit Stage Configuration workspace area is displayed, as shown in Figure 7-133.
Figure 7-133 Edit Stage Configuration Workspace Area
Click Add an Action, select Communication from the menu, and click Publish, as shown in Figure 7-134.
Figure 7-134 Edit Stage Configuration Workspace Area
Click <Service>.
The Select Service dialog is displayed, as shown in Figure 7-135.
Select a File type Business Service and click Submit.
You are returned to the Edit Stage Configuration workspace area.
Click Validate and then Save.
The completed Pipeline is displayed, as shown in Figure 7-136.
Click Save.
Click Activate in the Change Center area to activate your changes in the Oracle Service Bus session, as shown in Figure 7-137.
Figure 7-137 Change Center Activate Button
Copy and paste an input XML file in the input folder you have configured, as shown in Figure 7-138.
An output XML file is received in the destination folder, as shown in Figure 7-139.
Figure 7-139 Output XML Destination Folder