When you create a Web service mobile application, you must have access to where that service resides. Unwired Accelerator allows you to identify Web services that you want to use in a mobile application using the standard Web Services Description Language (WSDL), which is a normalized description of the service that allows you to access the software in a manner independent of protocol or location.
Creating a Web service element using WSDL
Use this procedure to create an element that uses the WSDL.
Select File | New | Mobile Application.
From the New Mobile Application wizard, click the Launch Element Wizard check box, select Web Service as the Element Type, and click Finish.
Alternatively, right-click the Mobile Application status folder in which you want to create the mobile application, and select Create (status name) Mobile Application With | Web Service Element.
You see the Web Service Element window. Specify the following:
WSDL URL - enter a Web service WSDL location in the provided text field and press Enter; for example:
http://www.xmethods.net/wsdl/query.wsdl
This is a sample Web service that provides a SOAP remote procedure call (RPC) interface to the xmethods.net Web site for query operations. xmethods.net provides a listing of publicly available Web services.
If you do not know the WSDL URL you can click Browse UDDI to search a UDDI registry defined in the Enterprise Explorer for the WSDL URL. If none are defined, click New Connection Profile to create a connection to a UDDI registry. Enter the following connection information:
Connection Profile Type - select UDDI Registry Connection Profile as the connection type and click Next.
Name and Description - identifies the connection profile. You must enter a name, the description is optional.
UDDI Connection Details - provide UDDI connection information, including
Commonly Used Registries - Sybase WorkSpace includes profiles for some commonly used UDDI registries. Select one from the drop-down list and the inquiry and publish URLs are automatically filled in.
Inquiry URL - the location from which you query or browse the UDDI registry. For browsing a registry, this is the only information you need to provide.
Publish URL - The location to which you publish to a UDDI registry. To publish to a UDDI registry, you must provide both the inquiry and publish URLs.
User ID - the user identification for accessing the UDDI site.
Password - the password used with the user id used to access the UDDI site.
Test Inquiry URL Connection - tests your connection to the inquiry URL.
Test Publish URL Connection - tests your connection to the publish URL.
Methods - select a method of the WSDL from the drop-down list. If you click GetMethods, the system retrieves the WSDL XML. The list of defined services is extracted from the WSDL file and populates the Methods drop-down list.
Authentication - these options are only visible if you select the Show authentication in the Web Service Element option, which is available from the Mobile Development Editors preference screen. See Setting Preferences. Options include:
Enable WSDL Authentication - allows you to define a Username and Password to use to retrieve the WSDL file from the URL. This is required if the retrieval of the WSDL is protected. Otherwise you cannot retrieve the Web Service methods.
If you drag a SOAP service from the Service Explorer that has WSDL authentication set, the parameters are transferred to the Web service element and display in the wizard regardless of the preference setting described above.
Define Login Method - some Web services require that an authenticated session header be provided with invocation of all Web service methods. These Web services provide a login method that must be called first to get a session handle, which then must be used with subsequent method requests. To define a login method, select the Define Login Method option, then choose the login method from the drop-down list, and enter any login parameters in the field provided to use with the selected login method.
Enable Basic Authentication - allows you to define a Username and Password to use as the authentication method.
Enable Grid Rules - click this check box to enable grid rules on the display data. Grid rules require a Content XSLT and UI XSLT.
Click Next to further customize with rules or parameters.
Send your feedback on this help topic to Sybase Tech Pubs: pubs@sybase.com