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 65 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).
The WSDL_URL property is enabled for transformation of bidirectional languages.
- 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 of operations for the expanded port, as shown
in Figure 66.
Note:
The WSDL ODA displays the ports that have SOAP/JMS
or SOAP/HTTP bindings only and excludes other types of bindings.
Figure 66. 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.
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:
- 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 66 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.
