(26) WAP Service Developer's Guide for the Nokia 9110i July 2000
(26) Disclaimer: Nokia Mobile Phones Limited disclaims all liability, including liability for infringement of any proprietary rights, relating to the implementation of information presented in this document. Nokia Mobile Phones Limited does not warrant or represent that such use will not infringe such rights. Nokia Mobile Phones Limited retains the right to make changes to this specification at any time without notice.
(26) Contents 1. 2. 3. 4. 5. INTRODUCTION............................................................................................................................... 4 1.1 References............................................................................................................................... 4 1.2 Contact information.................................................................................................................. 4 WIRELESS APPLICATION PROTOCOL - WAP...............
(26) 1. INTRODUCTION This Service Developer's Guide for the Nokia 9110i Communicator provides information and practical examples for developers who want to develop WAP services for Nokia 9110i. 9110i Communicator is an advanced communications device with a feature-rich WAP services application. The document will highlight the possibilities, limitations and requirements of service development and provides a good introduction to the Nokia style of designing user interfaces.
(26) Terminology Card A single WML unit of navigation and user interface. Deck A collection of WML cards that is the smallest download unit. You cannot download a single card in a deck, but must download the entire Deck. Service developers should be aware of this, and not do a giant application in one big Deck. Hyperlink A link within a document or card that allows quick navigation to another document (card). Do element A way of defining a binding between events (e.g. a user selection) and a task (e.g.
(26) 2. WIRELESS APPLICATION PROTOCOL - WAP 2.1 Introduction The Wireless Application Protocol (WAP) is a set of protocols that allow the development of applications and services for use with Mobile Phones and other mobile devices. These protocols and their related standards and specifications are maintained by the WAP Forum. The WAP Forum consists of a number of hi-tech companies from the Information Technology, Software and Telecommunications industries.
(26) Wireless Mark-up Language (WML) - a lightweight presentation language, similar to HyperText Markup Language (HTML) but optimized for use with mobile terminals. Wireless Mark-up Language Script (WMLS) - a lightweight script language, similar to Java ScriptTM. Wireless Telephony Application / Interface (WTA / WTAI) - telephony services and programming interfaces. Content Formats - defined data formats, such as vCard and vCalendar. 2.2.
(26) Figure 2 – Network-Related Elements for WAP Applications Web Server: The Web Server stores the applications written in WML. Alternatively, existing HTML applications can be used. HTML Filter: Any applications written in HTML will have to be converted to WML before they are sent to the mobile terminal. This HTML Filter may form part of the Web Server or the WAP Proxy. WAP Proxy: The WAP Proxy acts as the gateway between the cellular network and the Inter/Intranet.
(26) 3. INTRODUCTION TO THE USER INTERFACE OF THE NOKIA 9110i COMMUNICATOR This section gives a short overview of the user interface of the Nokia 9110i Communicator. The Nokia 9110i is a Communicator device with features of both PDA and CMT sides. WAP services application is implemented in PDA side together with the other Internet services, like Mail and WWW. The phone UI in the CMT part does not contain any WML browser.
(26) • The size of the application area depends on the width of the longest command button text. The minimum width of the command button area is 430 pixels, the maximum being 480 pixels. Indicator area Application area Search field Figure 2 Command button area area Selection frame Scroll bar Different parts of the display 3.2.2 Display components The display is able to show 16 grey tones. All of these will be used when images are shown. Only 4 tones are to be used in the system UI (i.e.
(26) WAP Browser main view opens when selecting WAP services from Internet application. The homepage URL is displayed on the bottom line of the view, if the URL exceeds the end of line, the remaining part of the name is not showed to the user. View includes buttons: Button 1: Home Button 2: Bookmarks Button 3: Settings Button 4: Hang up / Close Home button fetches information from the homepage (address can be seen at the bottom of the main view). Homepage is related to the used access point.
(26) 4.2.3 Optimize for Size The size of the content is critical. If you have large decks (listings, large tables, etc.), consider splitting them in multiple parts for faster download. As for the total download time, some studies place an upper limit for acceptable delay to 10 to 15 seconds, including all images, on a PC-based browser. It is highly recommended to have a response time (excluding connection time) less than 10s in mobile environment. 4.2.
(26) 4.3.2 Use Reasonable Tables Sizes If the table size exceeds the maximum width of WAP services application screen due to number of columns the table size will be scaled down to fit the screen. To keep the cell content readable, special attention should be paid on table structuring. 4.4 Use of card titles and element labels Card titles describe the content of the display and their use is recommended.
(26) If the title of the card is too long, the end of the title is not shown. If the active element is too long the end of the element is not shown. If the title of the active hyperlink is not defined the actual URL is shown. If the URL is too long, the end of the URL is not shown. For example if the user navigates to a select element, its title is displayed. While the user is choosing something from the select menu, the title is updated to reflect the option currently under the cursor.
(26) 5.1.3 Text formatting elements The normal font size used in 9110i is 12 pixels. The 9110i browser supports all text emphasis elements of WML, listed below. The picture below demonstrates how different emphasis elements are rendered as text and in a table.
(26) 5.1.5 Fieldset The
(26) Example 4. Image handling original size:
enlarged image:
stretched image:
5.2.2 ANCHOR & A – Hyperlink Use the element to create a hyperlink.
(26) NOKIA - connecting people
Here's a link to Nokia products.
The image below can be used as a link to Nokia Group page.
PAGE 20
(26) 
…
5.3 DO element and dynamic buttons 5.3.1 WML DO Construct: Dynamic Buttons WML makes it possible to include ‘dynamic buttons’ in the card. The do element binds a task to a user action. The buttons are displayed in a neat fashion (flushed left with a little space between the buttons). Figure below illustrates the dynamic buttons with input fields.(26) PAGE 22(26) Example 8. Card-wide back-button Cardwide prev can be placed between text or other elements, on bottom of page just like deckwide prev or...
...cardwide prev can be placed on the top of page
Example 9.
(26) GO Attributes: href method specifies the destination URL. Href is an obligatory attribute. specifies the HTTP submission method. Values 'get' and 'post' are accepted, in 9110i 'get'method is default. A prev element declares a prev task, indicating navigation to the previous URI on the history stack. If there isn't any history stack the previous task will be dimmed. A noop element specifies that nothing should be done ie. no operation 5.
(26) value indicates the default value of the variable named in the name attribute iname the name of the variable to be set with the index result of the selection ivalue assigned when the variable named in the iname attribute is not set title specifies a title for this element, which may be used in the presentation of this object Variables - $identifier, $(identifier), $(identifier:conversion) 5.5.2 Input fields The input element specifies a text entry object.
(26) Please, provide your
Name: Address:
(26)
5.7 Limitations This section includes the technical limitations of the WAP services application. The limitation for encoded WML file is 8192 Bytes. META DATA (HTTP-EQUIV) is handled like WAP stack handles it. The User-Agent header Information given to the server is "Nokia9110/1.0".
