When you create a Web service mobile application, such as Remedy or SAP, you must have access to the location 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
Select File|New|Mobile Application.
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.
From the New Mobile Application wizard, select the Launch Element Wizard check box, select Web Service as the Element Type, and click Finish.
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 where 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 Get Methods, the system retrieves the WSDL XML. The list of defined services is extracted from the WSDL file and populates the Method drop-down list.
Authentication – these options are visible only if you select the Show authentication in the Web Service Element option, which is available from the Mobile Development Editors preference screen. See Setting Mobile Development 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 how you set the Enable WSDL Authentication preference.
Define Login Method – some Web services require that you provide an authenticated session header with the 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 – select this option to enable grid rules on the display data. When you select this option, you must enter:
Content XSLT – click Select to retrieve a predefined content XSLT template.
Click New to launch the Web Services Output XSLT Template Customization wizard.
UI XSLT – click Select to retrieve predefined 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