Creating iWay Business Services

How to:

An iWay Business Service, also known as a Web service, is a self-contained, modularized function that can be published and accessed across a network using open standards. It is the implementation of an interface by a component and is an executable entity. For the caller or sender, a Web service can be considered a "black box" that may require input and delivers a result. Web services integrate within an enterprise as well as across enterprises on any communication technology stack, whether asynchronous or synchronous, in any format.

Each iWay Business Service defines one or more methods, which are executable functionality invoked through an adapter to a back-end EIS process.


Top of page

x
Procedure: How to Create an iWay Business Service

To create an iWay Business Service:

  1. Right-click the object node of interest, and select Create iWay Business Service from the drop-down list, as shown in the following image.

    The New iWay Business Service dialog box opens, as shown in the following image.

  2. From the Existing Service Names drop‑down list, select an existing service or select <new service> to create a new service.
  3. If you are creating a new service, type a name in the Name field.
  4. In the Description field, type a brief description of the service (optional).
  5. Click Next.

    The Define License and Method dialog box opens, as shown in the following image.

  6. From the License Name drop-down list, select a license definition.
  7. In the Method Name field, type the name of the method for the service.
  8. In the Method Description field, type a brief description of the method (optional).
  9. Click Finish.

    Designer opens the Web Services tab of the Navigator pane and displays the list of available services, including the newly created service.

    The following image shows the open Web Services tab with several Web services appearing under the Services node in the left pane and Services information in the right pane.


Top of page

x
Procedure: How to Test a Business Service

To test an iWay Business Service:

  1. In the Web Services tab of the Navigator pane, expand the Services node under the repository in which you are working.
  2. Expand the Web service of interest and then expand the Method node.
  3. Select the method you want to test.

    The Test pane for the selected method opens on the right. The following image is an example of a Test pane.

  4. Enter a sample XML document that queries the service in the Input xml field.
  5. Click Invoke.

    The results appear in the right pane.


Top of page

x
Procedure: How to Export WSDL Using iWay Explorer

The Web Service Description Language (WSDL) file is an XML file that describes the Web service documents and provides access to the service. It specifies the location of the service and the operations (or methods) the service exposes.

To export WSDL using iWay Explorer:

  1. In the Web Services tab of the Navigator pane, expand the Services node.
  2. Expand the name of the business service node you created, for example, Company.
  3. Right-click the business service node, select Export WSDL and then Save As from the drop-down list, as shown in the following image.

    The Save As dialog box opens, as shown in the following image.

  4. In the Save in field, select a directory where you want to export the WSDL file.
  5. In the File name field, select or type a name for the WSDL file.
  6. Click Save.

Top of page

x
Procedure: How to Edit a Web Service

To edit a Web Service description or security policy:

  1. In the Web Services tab, expand the Services node.
  2. Select the name of the business service node you created, for example, Company.
  3. Right-click the business service and select Edit from the drop-down list, as shown in the following image.

    The Edit Service dialog box opens, as shown in the following image.

  4. Click the Name or Privacy tab and edit the Web Service description or change the policy based security, as needed.
  5. Click OK.

Top of page

x
Procedure: How to Delete a Web Service

To delete a Web service:

  1. In the Web Services tab, expand the Services node.
  2. Select the name of the business service node you created, for example, Company.
  3. Right-click the business service and select Delete from the drop-down list, as shown in the following image.

    The business service node is removed from the Services list in the Navigator pane.


iWay Software