Register Web Service Definition

Use

Web services that are to be used in a workflow must first be registered in the Web service directory. The workflow system also offers the following possibilities:

  • Manual registration of a Web service

Here you manually enter all relevant definition data of the Web service. Use the transaction WF_EXTSRV.

  • Reading a WSDL file.

A WSDL file contains the definition data of a Web service. If you have such a file for a Web service, you can import this directly using transaction WFWS. You can import WSDL files Release 1.1 with the following restrictions:

  • Only HTTP bindings are supported
  • Only simple schema types are supported
  • The definition may not be divided between several WSDL files

Manual registration of a Web service

  1. Choose the transaction WF_EXTSRV.
  2. To register a Web service, choose Service in the dialog structure and then New Entries.
  3. Enter a Service ID and a short text for the Web service.
  4. Choose the log with which the Web service is to be called.
  5. For Host add the address of the Web service and for Port add a port number, if necessary.
  6. Enter the directory and the call name of the Web service in the field Path.
  7. Define the Call mode of the Web service. Here you determine whether a dialog or a background Web service is involved and whether and then how a callback is performed.
  8. Choose Parameter in the dialog structure by double-clicking.

    The parameters determine the interface of the Web service. The task container is created from the parameters in the subsequent task generation.

  9. Enter all the Web service parameters. Make sure you also assign the service ID of your Web service to the parameters. The assignment as import element and export element is required for the subsequent creation of the task container.

Use of a WSDL file for registration of a Web service

  1. Choose the transaction WFWS.
  2. Select the WSDL Import tab page, select the file, and choose Import.

    The WSDL file is displayed.

  3. Select the WSDL file in the left-hand screen area and choose Expand Tree.

    The general data of the Web service plus its interface and its port are opened. By choosing Display you can display the individual areas separately.

  4. Select the general data of the Web service and choose Change. Enter a name for the Web service and mark whether a dialog Web service is involved.
  5. Select the interface of the Web service and choose Change. Choose the log with which the Web service is to be called and the call mode.
  6. Select the port of the Web service and choose Change. Enter a name for the port and check the port address.
  7. Select the WSDL file in the left-hand screen area and choose Import selection. The parts that are relevant for the registration are selected and imported to the Web service directory.

Only the port can subsequently be changed in an imported Web service definition. On the Web service browser tab page you can display all imported Web service definitions and display the detail view by choosing Load definition.

If the interface subsequently changes for a Web service, you have to import an updated version of the relevant WSDL file and generate new tasks.

Result

You can create tasks that you can use in workflows for all Web services registered in the Web service directory.