Configure Workflow System for the Use of Web Services 

Use

You must configure your SAP system if you want to be able to execute workflows that use Web services. The procedure depends on whether you only want to configure your logical SAP system for a local execution of Web services, or whether your logical SAP system is to function as a handler server or a handler client.

Use transaction WF_HANDCUST regardless of the variant you want to configure.

Configuration for Local Web Service Execution

You can also use locally registered Web services in a logical SAP system that is configured as the handler server or handler client.

1.       Go to the Launch Handler tab page and enter the data of the local launch handler. As standard, you do not have to change the Path and Handler Name. The launch handler is the system from which the Web service is launched.

2.       Choose Generate URL and then Test URL to check that the URL works.

3.       Go to the Callback Handler tab page and enter the data of the local callback handler. As standard, you do not have to change the Path and Handler Name. The callback handler receives the confirmation of the Web service and transfers this confirmation to the workflow system.

4.       Choose Generate URL and then Test URL to check that the URL works.

5.       Go to the Callback Dialog tab page. The callback dialogs are used to allow users to complete Web services with a dialog and continue the workflow. The following HTML pages are currently available to complete a dialog Web service:

·         Dialog Service Boxset – the dialog Web service is executed in a separate HTML window and the user can complete the dialog Web service in a separate dialog window.

·         Dialog Service Frameset – the dialog Web service is executed in a frame of the HTML window and the user can complete the dialog Web service in a frame arranged above it.

Enter the Host and the Port here to generate the URLs with which the callback dialogs are to be called. Test the URLs that are generated.

Configuration as Handler Server

If you define your logical SAP system as the handler server, other logical SAP systems can execute all the Web services registered there using the handler server.

1.       The status Handler Server must be set on the System status tab page.

If the system is already defined as local only, choose Operate System as Handler Server.

If the system is defined as the handler client, you must log your logical SAP system off as the client system for the handler server. The handler server valid for your logical SAP system is entered on the Launch Handler tab page as the logical system of the remote launch handler. Then define your system as the handler server.

2.       Go to the Client System tab page. There you enter all logical SAP systems that are to access the handler server as the client.

3.       Go to the Launch Handler tab page and enter the data of the local launch handler. As standard, you do not have to change the Path and Handler Name. The launch handler is the system from which the Web service is launched.

4.       Choose Generate URL and then Test URL to check that the URL works.

5.       Choose Distribute. As a result, all client systems are defined as a handler client and receive the information for the remote launch handler.

6.       Proceed for the definition of the Callback Handler and Callback Dialogs as described for local Web service execution.

Configuration as Handler Client

If there is a handler server in your system environment, you can register your logical SAP system there as the client system. As a result, you can use all the Web services registered on the handler server in your workflows. It is still possible to register and use Web services locally on your system.

1.       The status Handler Client must be set on the System Status tab page.

This takes place automatically if your logical SAP system is logged on as the client system for the handler server and distribution of the launch handler has been performed.

2.       Go to the Launch Handler tab page and enter the data of the local launch handler. As standard, you do not have to change the Path and Handler Name. The launch handler is the system from which the Web service is launched. You also see the remote Launch Handler that is provided by the Handler Server.

3.       Choose Generate URL and then Test URL to check that the URL works.

4.       To define the Callback Handler and Callback Dialogs, proceed as described for local Web service execution.