Developing an Outbound Message Transport Using OSB

Before developing an OSB outbound message proxy service, you should prevent any legacy MPL services from attempting to process that type of outbound message. This is accomplished by changing the processing method from MPL to SOA in the OUAF application.

Example

This example shows how to create an OSB integration to handle OUAF Outbound Messages. In OSB, this is accomplished by creating a proxy service that is configured to receive outbound messages. Once a proxy service receives a message it can optionally transform the message and then route it to an OSB Business Service which will usually be a web service created from a WSDL.

Specifically, this example creates a proxy service that receives ZZKJHTYP outbound messages and sends them to a very simple HelloWorld web service that is described in the book Definitive Guide to SOA. In practice, any web service can be used.

To create the OSB Business for the Hello World web service, follow these steps:

  1. Save a copy of the HelloWorld web service’s WSDL to your local computer.
  2. Log in to the OSB Service bus console (for example, http://localhost:7001/sbconsole).
  3. Under Change Center, click Edit to create a new session.
  4. Click Project Explorer to see all your OSB Projects.
  5. Create a new project or click on an existing project (for example, OutboundMessage).
  6. Click on the project name in the project list to go to the project editor.
  7. In the project, select WSDL from the Create Resource menu to create a new WSDL.
  8. In the WSDL details page, give your WSDL a name and either upload the WSDL file or cut and paste its contents into the text area.
  9. Save the WSDL. this takes you back to the Project page.
  10. Select Business Service from the Create Resource menu to create a new business service resource.
  11. Give your business service a name and description.
    1. Select WSDL Web Service for the service type and then click Browse to select the WSDL that you just created.
    2. In the WSDL browser, select the WSDL and click on its port. This will enable the Submit button which will bring you back to the Business Service page
  12. Click Next to set the configuration for the Business Service’s transport. Click Add in the Endpoint URI. This will add the endpoint defined in the WSDL to the list of existing URI’s. Use the garbage can icon to delete the URI REPLACE_​​WITH_​​ACTUAL_​​URL.
  13. Click Last to verify the configuration and then click Save. Alternatively, click next to view the other configuration options that you don’t need to modify.

To create an OSB Proxy Service using the OUAF transports, follow these steps. Steps 1-5 can be skipped if you’re already in the Project Editor after creating the business service.

  1. Log in to the OSB Service bus console (for example, http://localhost:7001/sbconsole).
  2. Under Change Center, click Edit to create a new session.
  3. Click Project Explorer to see all your OSB Projects.
  4. Create a new project or click on an existing project (for example, OutboundMessage).
  5. Click on the project name in the project list to go to the project editor.
  6. In the project, select Proxy Service from the Create Resource menu to create a new proxy service.
  7. Give the new proxy service a name (for example, OutboundMessageTest) and description.
  8. For Service Type, select Any XML Service.
  9. Click Next to go to the Transport Configuration page
  10. For Protocol, select omsg .
  11. In the Endpoint URI field, enter the ID of the type of outbound message that this proxy service should process (for example, ZZKJHTYP).
  12. Get All Headers should be set to No because there are not currently any headers defined
  13. Click Next to go to the OMSG transport configuration page.
  14. Specify the name of the JDBC Data Source that connects to the OUAF database (for example, FW420DEV)
  15. Adjust the poll interval if you would like the outbound message table polled at a different frequency from the default of 60 seconds.
  16. Leave the dispatch policy set to the default values.
  17. Click Next to go to the Message Handling page.
  18. Leave all default values on the Message Handling page.
  19. Click Next to review your settings. Then click Save to save the proxy service
  20. On the project page, click the message flow icon under Actions to define the processing of the message.
  21. Define any transformations that are needed on the input and route the message to a previously defined business service set up for the endpoint for the remote system.
  22. In the OSB Change Center, activate your changes to start the ProxyServices.