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.)
As shown in Figure 63 above:
- 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).
- 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 64.
- Note:
- The WSDL ODA displays the ports that have SOAP/JMS or SOAP/HTTP bindings only
and excludes other types of bindings.
Figure 64. Select Source window

- 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.
- Click Next and go to Confirming selections.
The ODA can also retrieve a WSDL document from a UDDI registry instead of a
URL location. For this to occur:
- Specify the following properties in the Configure Agent window for your
"search key":
- UDDI_InquiryAPI_URL (for example:
https://uddi.ibm.com/ubr/inquiryapi)
- WebServiceProvider (for example: IBM Corporation)
- WebService (for example: StockQuoteService)
- The WSDL ODA uses exact name match (findQualifier) for inquiry within the
UDDI registry. Ensure that you are entering the right values for the
parameters. You can use a regular UDDI browser to find services
provided by the service provider.
The WSDL ODA uses these properties, which are described in Table 37, to connect to the UDDI registry.
- 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 64 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.
- 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.
- 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.
