IBM Integration Bus, Version 10.0.0.2 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Developing a service interface

An example of developing a service interface using the service editor.

Before you begin

Read the concept information about Integration services, and create a service from scratch. See Creating an integration service from scratch.

About this task

A service in IBM® Integration Bus is a specialized application that contains a web services solution. It defines an interface with operations that are implemented as separate subflows. The following example shows how to create an interface and define operations. The complete interface is explained in Example of a service interface.

Procedure

  1. Open your integration service in the Service editor by double-clicking the Service Description in the Application Development view, or by right-clicking and selecting Open.
  2. Display the service interface by switching to the Interface tab in the Service editor.
  3. A default request-response operation, operation1, is created when the service is created. Rename operation1 to getApproval.
  4. Rename the inputs and outputs, and edit the types.
    1. Rename input1 to balance. In the Type field, select the default, string. From the context menu, select double. The type is changed.
    2. Change output1 to approval and the leave the type as string.

      Click in the Type field, and select "double".

  5. Add two faults to getApproval using the Add Fault icon: a timeout fault with a string type and systemFailure, also with a string type.

    Click the "Add Fault" icon to add a fault, or right-click on the operation and select "Add Fault" from the context menu.

    These faults will appear in the properties of bindings which use your interface. You can then implement the faults with fault selectors.
  6. Add another request-response operation by clicking the Add Request Response Operation icon, or right-clicking and selecting from the context menu. A request-response operation with an input and an output is created. called getHistory with an input of customerName with a string type and an output of customerHistory with a string type. Select the string type of customerHistory and change the Name field to customerPastHistory.

    Click the "Add Request Response Operation" icon to add a request-response operation, or right-click on the operation and select "Add Request Response operation".

  7. Add the same timeout and systemFailure faults in this operation as the previous one. These faults would return error messages for timeout conditions or a system failure.
  8. Add a one-way operation called updateCreditRating, either from the icons by selecting Add One Way Operation or right-clicking the canvas area in the interface editor and selecting from the context menu. Rename the input to currentRating with a string type. One-way operations send only an input as there is no response required.

    The interface is complete with defined operations.

What to do next

Implement the operations defined in the integration service as separate subflows. For more information, see Implementing an integration service operation.

bc19327_.htm | Last updated 2015-09-24 12:53:42