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
64 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 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

- 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 47, 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 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.
- 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.
