6.7 Adding SOAP Services to Oracle Enterprise Service Bus

Services are the means by which data gets from one application to another and in and out of the Oracle Enterprise Service Bus environment. Connectivity is provided through adapter services and Simple Object Access Protocol (SOAP) invocation services. For example, an ESB SOAP service can be used as an outbound adapter to move data to a PeopleSoft or Siebel application.

Data contained within XML messages are distributed from the source application to a target application using routing services. As the name suggests, a routing service determines how a message gets from one point to another within the Oracle Enterprise Service Bus environment. ESB includes a standards-based data mapper. The data mapper specifies an xsl file to transform data from one XML schema to another, thus enabling data interchange among applications using different schemas.

For information about managing SOAP services in Oracle Enterprise Service Bus, see "Creating Inbound and Outbound Services" in Oracle Enterprise Service Bus Developer's Guide.

6.7.1 How to Add SOAP Services

To create an ESB SOAP service, you drag a SOAP service type from the Components palette and drop it onto the Design tab. When you do so, a wizard or dialog opens to assist you in creating the service.

To create a SOAP service with Oracle JDeveloper ESB Designer:

1. In the Application Navigator, navigate to the ESB project for which you want to create a SOAP service, expand the Resources folder. Double click project-name.esb, where project-name is the name of the project to which you want to add the SOAP service.

   The Design tab for the project is displayed.

2. In the Component Palette, click the down arrow and select ESB services if not already selected.

3. Drag and drop SOAP Service into the Design tab.

   The Create SOAP Invocation Service dialog opens.

4. In the Create SOAP Invocation Service dialog, enter the Name, System/Group, and an optional Description for the service.

   Name: Enter a unique name across the ESB system in which you are creating the service; spaces are not allowed.

   System/Group: Click on the flashlight (torch) to open the ESB Service Group Browser dialog and select the system/group for this service.

   Description: Enter an optional description for this service.

5. To complete WSDL File field, you can click on the following icons to the right of the field:

   • Browse WSDL Files icon

     Click on this icon to open a dialog that enables you to search for and open a WSDL file from the local file system.

   • Service Explorer icon

     Click on this icon to launch the Service Explorer and search for and select a WSDL file of an existing service.

     For information on using the Service Explorer, see Section 6.5.1, "How to Browse for Deployed Services".

6. In the Port Type field, click the down arrow, and then select the port type for the service.

7. Click OK when finished.

   The new SOAP service appears in the Design tab.

6.7.2 How to Modify SOAP Services

You can modify SOAP services in Oracle JDeveloper ESB Designer by opening the SOAP service property page.

To modify a SOAP service:

1. In the Design tab, double click on the upper section of the SOAP service icon. The cursor is shaped like a hand on that region of the icon. An example of the Design tab is shown in Figure 6-7.

2. Make your changes to the adapter service information that can be modified. Note that the name of the service cannot be changed.

3. In the Endpoint Properties panel, you can add, delete, update, or view endpoint properties for the service. For information about endpoint properties, see Section 6.6, "Adding Endpoint Properties for Adapter or SOAP Services".

4. Save your changes.

6.7.3 How to Delete SOAP Services

You can delete a SOAP service in the Oracle JDeveloper ESB Designer Design tab.

To delete a SOAP service:

1. In the Design tab, select the SOAP service icon.

2. Click the large red X at the top of Design tab to delete the selected service.

3. Confirm that you want to delete the selected service.

4. Save your changes.

Note: Do not delete SOAP services in the Application Navigator.

6.7.4 What Happens When You Add SOAP Services

When you complete the information for adding a new SOAP service, the service icon displays in the Design tab and the service definition file appears in the Application Navigator in the Resources folder of the ESB project. The name of the service entry in the Application Navigator includes the ESB system name, the service name, and the esbsvc extension, in the form system-name_service-name.esbsvc. The actual source of the service definition file is not visible in Oracle JDeveloper ESB Designer.

When the ESB project is registered with the ESB server, the ESB files for the SOAP service that are created in Oracle JDeveloper ESB Designer are deployed to the design time metadata server. See Section 6.2.1, "What Happens When you Create an Oracle Enterprise Service Bus Flow".

6.7.5 What Happens at Runtime

During runtime, a SOAP service receives a message instance from an external source and passes it to an ESB routing service for processing or an ESB routing service passes a message instance to a SOAP service which sends it to an external source.