Specifying the WSDL document

Web service business objects are generated from WSDL documents. This section shows you how to select and specify the source of a WSDL document in the Configure Agent window of the ODA.

The WSDL document may reside on the local file system or at a URL location on the web or in a UDDI registry--you specify where the WSDL document resides and the WSDL ODA retrieves it. (A complete WSDL service description may consist of more than one document.)

Getting a WSDL document from a URL location

As shown in Figure 64 above:

  1. Specify the URL for the WSDL document in the configuration property WSDL_URL

    The ODA then retrieves the list of web services from the WSDL document, resolving the URLs of imported documents. The WSDL_URL property also allows you to specify the location of the WSDL file on the local file system using URL syntax (for example: file://C:/test/wsdl) or an absolute path (for example: C:\test\wsdl). You must ensure that the ODA has access to this document and its dependencies (all the imported documents).

  2. Click Next.

    The ODA queries the URL for the web service provider and retrieves the list of services defined in the WSDL at this URL location and then displays the list as shown in Figure 65.

    Note:
    The WSDL ODA displays the ports that have SOAP/JMS or SOAP/HTTP bindings only and excludes other types of bindings.

    Figure 65. Select Source window

  3. Select one and only one of the operations from the list for the port (the selectable operations are highlighted). You cannot select the service or port nodes, which are for display purposes only. Note that WSDL operations may be of several types: ONE_WAY, REQUEST_RESPONSE, SOLICIT_RESPONSE, and NOTIFICATION. The WSDL ODA supports and displays only REQUEST_RESPONSE and ONE_WAY operations.
  4. Click Next and go to Confirming selections.

Getting a WSDL document from a UDDI registry

The ODA can also retrieve a WSDL document from a UDDI registry instead of a URL location. For this to occur:

  1. Specify the following properties in the Configure Agent window for your "search key":

    The WSDL ODA uses these properties, which are described in Table 47, to connect to the UDDI registry.

  2. Click Next.

    The ODA queries the UDDI registry for the web service provider and retrieves the list of services matching the web service parameter you specified. The WSDL ODA displays the list of services offered by the web service provider in a window like that shown in Figure 65 When the UDDI query returns more than one match, the WSDL ODA displays them appended with an underscore (_) and a sequence number. For example: StockQuoteService_1, StockQuoteService_2, and so on.

    Note:
    The WSDL ODA displays the ports that have SOAP/JMS or SOAP/HTTP bindings only.
  3. Select one and only one of the operations from the list for the port. You cannot select the service or port nodes, which are for display purposes only. Note that WSDL operations may be of several types: ONE_WAY, REQUEST_RESPONSE, SOLICIT_RESPONSE, and NOTIFICATION. The WSDL ODA supports and displays only REQUEST_RESPONSE and ONE_WAY operations.
  4. Click Next and go to Confirming selections
Note:
The connector supports the UDDI Version 2 API only. Accordingly, you cannot retrieve WSDL from UDDI registries that do not support UDDI Version 2.

Copyright IBM Corp. 1997, 2003