Creating Web Service Elements

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 from the main menu bar.
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.
In the New Mobile Application wizard, select the Launch Element Wizard check box, select Web Service as the Element Type, and click Finish.
The Web Service Element wizard opens.

Define the following elements:

Web Service

Element	Description
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.
Method	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.
Method JSP request	Enter the method for the JSP request.
Standardization XSLT	Search for the Web Service WSDL standardization.

The following Authentication options are visible if you enabled the Show authentication in the Web Service Element Mobile Development Editors preference.

See Setting Mobile Development Preferences for more information on enabling this preference.

Authentication

Element	Description
Enable WSDL Authentication	Define a Username and Password to be used to retrieve the WSDL file from the URL. This action is required if the retrieval of the WSDL is protected. Note 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. Choose a login method from the drop-down list. Enter the login parameters to be used with the login method.
Enable Basic Authentication	Define a Username and Password to be used in the authentication method.

Element

Description

Enable WSDL Authentication

Define a Username and Password to be used to retrieve the WSDL file from the URL.

This action is required if the retrieval of the WSDL is protected.

Note

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.
Choose a login method from the drop-down list.
Enter the login parameters to be used with the login method.

Enable Basic Authentication

Define a Username and Password to be used in the authentication method.

Presentation

Element	Description
Enable Grid Rules	Enables grid rules on the display data. When you select this option, you must define the Content XSLT.
Content XSLT	Define the XSLT content: 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.

Element

Description

Enable Grid Rules

Enables grid rules on the display data. When you select this option, you must define the Content XSLT.

Content XSLT

Define the XSLT content:

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 define rules and parameters.

Create a New XSL Template for the Mobile Application

Editing Mobile Applications

Setting CGI Parameters

Using Rules and Record Layout