Synchronous Event Processing

How to:

You can configure synchronous event processing using iWay Explorer to trigger a Web service after an event occurs in the SAP system. The event response that is received can then be routed to another disposition for further processing.


Top of page

x
Procedure: How to Configure Synchronous Event Processing Using iWay Explorer

To configure synchronous event processing:

  1. Create a Web service for an SAP Remote Function Module, for example, BAPI_MATERIAL_GETLIST.
  2. View the WSDL file.
  3. In the Create New Port pane, create a port using the SOAP disposition.
    1. In the Name field, type a name.
    2. In the Description field, type a brief description (optional).
    3. From the Disposition Protocol drop-down list, select SOAP.
    4. In the Disposition field, enter a SOAP destination, using the following format:
      soap:[wsdl-url];soapaction=[myaction];
      method=[web service method];namespace=[namespace];
      responseTo=[pre-defined port name or another disposition URL];
      errorTo=[pre-defined port name or another disposition url]

      The following table lists and describes the parameters for the disposition.

      Parameter

      Description

      wsdl-url

      The URL to the WSDL file that is required to create the SOAP message, for example:

      http://localhost:7001/ibse/IBSEServlet/test/ 
      webservice.ibs?wsdl

      where:

      webservice

      Is the name of the Web service you created using iWay Explorer.

      To find this value, you can navigate to the iWay Business Services tab and open the Service Description link in a new window. The WSDL URL appears in the Address field.

      Alternatively, you can open the WSDL file in a third-party XML editor (for example, XMLSPY) and view the SOAP request settings.

      soapaction

      Method that is called by the SOAP disposition, for example:

      webservice.method@test@@

      where:

      webservice

      Is the name of the Web service you created using iWay Explorer.

      method

      Is the method being used.

      test

      Is the license that is used by the Web service.

      To find this value, you can navigate to the iWay Business Services tab, open the Service Description link in a new window, and perform a search for soapAction.

      Alternatively, you can open the WSDL file in a third-party XML editor (for example, XMLSPY) and view the SOAP request settings.

      method

      Web service method you are using. This value is in the WSDL file.

      namespace

      The XML namespace you are using. This value is in the WSDL file.

      responseTo

      Location to which responses are posted. Can be a predefined port name or another URL. Optional.

      The URL must be complete, including the protocol.

      errorTo

      Location where error documents are sent. This can be a predefined port name or another full URL. Optional.

      Note: To use the SOAP disposition with a synchronous event, use Remote Function Modules to generate the schema and WSDL file instead of using the Business Object Repository for any RFC or BAPI.

      The following is an example of a completed SOAP disposition:

      soap:http://localhost:7001/ibse/IBSEServlet/test/soapWS.ibs?wsdl;
      soapaction=soapWS.GETLISTRequest@test@@;method=GETLIST;
      namespace=urn:iwaysoftware:ibse:jul2005:GETLIST;
      responseTo=ifile://c:\output\sap\soapOut.xml
  4. Using the Edit channels pane, create a channel.
    1. Provide the required information to connect to SAP in the System and User tabs.
    2. In the Advanced tab, from the Processing Mode drop-down list, select REQUEST_RESPONSE.
  5. Associate the port you created earlier with the new channel.
  6. Start the channel.

    A Web service for an SAP Remote Function Module, for example, BAPI_MATERIAL_GETLIST, is triggered after an event occurs in the SAP system. The response document is returned and routed to a file location.


iWay Software