Show TOC

Function documentationDisplaying WSDL Locate this document in the navigation structure

 

You can, for a service interface from the Enterprise Services Repository and additional configuration data, create a Web Service description and save the Web Service description as WSDL file. You can then, for example, hand these files out to business partners, who do not have access to the content in the ES Repository. On the basis of the WSDL description the business partner can then send a message to the Integration Server or through direct communication to the receiver system. The WSDL description contains all the necessary configuration data on the basis of which the massage can then be processed.

Note for enhanced communication (using an Integration Broker), that you only set out the inbound processing of a message in the Integration Server or in the Adapter Engine with this function . In addition, to set the further processing of the message and the forwarding to the receiver, you must define the receiver determinations, interface determinations and receiver agreements in the Integration Directory.

You have the following options for generating a WSDL description:

  • Create the WSDL description on the basis of an already defined configuration object.

    If the inbound processing for your preferred communication scenario has already been configured, then you can create the WSDL description directly from the corresponding sender agreement or direct connection. The configuration data contained in the sender agreement/direct communication will then automatically be taken into consideration.

    Note Note

    This is only supported for the following adapter types: XI, HTTP; SOAP; WS.

    End of the note.
  • Manually enter the service interface and configuration data into a wizard.

    You can choose this option if your configuration does not contain any sender agreements or direct connections. You must, however, enter all the necessary information manually using the wizard.

Note that the WSDL descriptions for SOAP; HTTP and XI adapters are created according to the W3C Standard Web Services Description Language (WSDL) 1.1.

Note Note

For more information, see http://www.w3.org/TR/wsdl.

End of the note.

This means that the WSDL description does not yet contain any definitions regarding policies, user names, passwords or, for example, timeouts. Note that the WSDL description still therefore needs to be manually completed with all this information.

Procedure
Create the WSDL description on the basis of an already defined configuration object.

Perform the following steps:

  1. Open the sender agreement or direct connection.

  2. In the menu of the object editor, select   Sender Agreement   Display WSDL   or   Direct Connection   Display WSDL  .

    The WSDL description is created.

    If you save the WSDL description, you can then, for example, provide a business partner with the file.

    If you have created the WSDL description for a sender agreement with a communication channel of adapter type WS or for a direct connection, then a business partner can access the WSDL description directly using the URL. To receive the URL, display the created WSDL description in your browser and copy the URL from the address field of the browser.

    Note, that this URL remains stable so long as you do not change the sender agreement or direct connection as well as the assignment to the communication channel.

    Note Note

    Correct the inbound address for SOAP messages in the WSDL document if the sender agreement is assigned to a communication channel of the type SOAP.

    For more information, see: Configuring the Sender SOAP Adapter

    End of the note.
Manually enter the service interface and configuration data into a wizard.

Perform the following steps:

  1. In the Integration Builder (Integration Directory) menu bar choose   Tools   Display WSDL  .

    A wizard starts.

  2. Choose Continue.

  3. Enter the URL of the server that is to process the message.

    This can be either the Integration Server or an Adapter Engine.

    Note Note

    Click Propose URL to specify the URL of the Integration Server entered in the System Landscape Directory.

    End of the note.
  4. Choose Continue.

  5. Specify a service interface from the Enterprise Services Repository for which you want to create the Web service document.

    Use the input help.

  6. Choose Continue.

  7. Enter the sender of the message (party, communication component, and outbound interface).

    The information about the sender of the message (party, service, and outbound interface) is required to complete the message header with the corresponding information.

  8. Choose Continue.

    An overview of all the information that will be used to create the WSDL description is then displayed.

  9. Choose Finish.

    The WSDL description is displayed. You can save the WSDL description as a file or display it in your browser.