User's Guide
Contents
1. Web server Using a local gateway If you want to test your own local web server applications that are not available on the Internet or if you are placed behind a firewall that prevents you from communi cating with external gateways you need to install a local test gateway The local gateway can also be used to access web servers on the Internet If your local network 1s protected by a firewall you must then specify an HTTP proxy server to use WaplDE WAP gateway ma Firewall Proxy server Web server A demo version of Ericsson s Enterprise WAP Gateway Proxy 2 0 can be downloaded from the Ericsson Developers Zone Refer to Installing a local gateway on page 55 for more information 52 e Setting up a WAP application environment WapIDE User s Guide Configuring a web server When you place your WAP application on a web server you have to configure it to support the right MIME types Refer to the documentation of your web server for information on how to do this Content type MIMEtype Fileextension __ WML source text vnd wap wml wml WML Script source text vnd wap wmlscript wmls Compiled WML application vnd wap wmlc wmlc Compiled WMLScript application vnd wap wmlscriptc wmlsc2. Compile Note It is not necessary to compile the files to test them in the WAP browser When you test an application the browser automatically compiles WML and WMLScript to temporary files Creating applications in other character sets To create applications in other character sets than ASCII you should specify the xml encoding parameter on the first line in each WML deck for example lt xml version 1 0 encoding 1s0 8859 1 gt The WML editor checks the encoding parameter when it reads and writes WML files Note If no encoding is specified the system default encoding is used This means that the encoding can change if you move your files to another machine The character sets supported in the WML editor depends on the support in Java and the operating system When you compile or test your applications in the WAP browser the following character sets are supported 34 e Using the WapIDE application designer WapIDE User s Guide Type Unicode Western European Central European Baltic Arabic Greek Turkish Japanese Korean Chinese Thai Character set iso 10646 ucs 2 iso 10646 ucs 4 utf 8 utf 16 us ascii iso 8859 1 iso 8859 2 windows 1250 windows 1257 iso 8859 6 iso 8859 7 windows 1253 iso 8859 9 shift jis euc jp iso 2022 jp ks c 5601 1987 euc kr gb2312 big5 windows 874 Aliases cp819 csisolatin1 ibm819 iso 8859 1 1s08859 1
3. GEL Beles File View Bookmarks Help A Mobile Internet ERICSSON amp Login SignUp Announcement Currencies NOoss gt 1ua sogey Mnhila Chat Push initiator The WapIDE push initiator is used to create and send push messages to the WapIDE browser or a real terminal WAP Client WAapIDE Push Initiator Push Proxy Gateway WapIDE User s Guide System overview e 9 Installing WapIDE This chapter describes the system requirements and installation procedure for WapIDE WapIDE can be found at the Ericsson Developers Zone WAP gt Developers tools To access the zone you have to register at the web site The registration gives you access to the documentation and developer resources located at the site System requirements Software requirements e Microsoft Windows NT 4 0 Windows 98 or Windows 2000 e Java 2 Platform version 1 3 0 or later Java can be downloaded from http java sun com e Microsoft Internet Explorer 5 or a later version is required for local WML file access including the use of the application designer e The font Arial Narrow is required to get a correct simulation of the real telephones Arial Narrow 1s part of many Microsoft software packages such as Office 97 Outlook 2000 Word 2000 etc e Adobe Acrobat Reader 3 0 or later is required to view online documentation Acrobat Reader can be
4. L7 WapIDE 3 1 Root directory C bin Java archive JAR files and DLLs CI dat WapIDE settings bookmarks and DTD files device Device specific code and settings doc This User s Guide in PDF format samples Contains samples a default home page and is the default root directory for file accesses Uninstalling WapIDE To uninstall the WapIDE use the Windows Add Remove Program in the Control Panel folder in the Settings section of the Windows Start menu Note Deleting the WapIDE files and directories manually will not completely uninstall it You have to use the procedure above WapIDE User s Guide Installing WapIDE e 11 Using the WapIDE browser The WapIDE browser is used to view WAP applications It can be used instead of a WAP device to access WML decks developed by you or others It also interprets WMLScript The browser can simulate different devices It also supports applications in languages with different character sets such as Chinese There are two ways to load content to the browser from a e Local WML file e Web server via a WAP gateway To access web servers on the Internet you can use a WAP gateway on the Internet If you want to test applications on local web servers or 1f you are placed behind a firewall that prevents you from communicating with external gateways you can download a gateway from the Ericsson Developers Zone Refer to Setting up a WAP application environment on page
5. File View Bookmarks Help File View Bookmarks Help R380s ES R380s WaplDE File View Bookmarks Help WA Mobile Internet ERICSSON amp Login SignUp Announcement Currencies Minhila Chat S NOSSIIVI The browser capabilities of the different devices are described in the following sections For further information on the user interface of Ericsson WAP devices you can download Design guidelines for different Ericsson WAP terminals from the Ericsson Developers Zone WapIDE User s Guide Using the WapIDE browser e 15 Using the R320s R520m browser The R320s and R520m devices are very similar Using the device buttons When the browser is started you can see the application in the display and use the buttons on the device to enter commands and data Button User action Device action Short click Follows the current link confirms input or r selection etc Hold down Shows a list of options as described in Using click the options menu below Up Down Scrolls up or down in the current card or selection list Left Right Scroll left or right in tables or between multiple links on the same row s Short click Text entry in input fields The and buttons om are also used for selecting check boxes For cards with access keys these buttons can also be used as a quick way to activate a link or input field R520m only Access keys are indicated with a small icon next to the link or input f
6. System overview Ericsson WapIDE WapIDE is a Software Development Kit SDK that enables operators application developers or any interested party to develop and test real WAP applications swiftly and easily WapIDE can be downloaded free of charge from the Ericsson Develop ers Zone The main functions in WapIDE are e The browser simulates a WAP device and allows you to test WAP applications on different Ericsson phones e The application designer lets you create and test your own WAP applications e The push initiator sends push messages to the WapIDE browser or a real terminal An online version of this User s Guide can be accessed directly from the Windows Start menu or from inside WapIDE by using the help menu Browser The WapIDE browser allows the user to access WML decks and cards using a simulated WAP device The following Ericsson devices are currently supported e R320s e R380s e R520m The Chinese versions of these terminals are also indirectly supported since Chinese characters can be entered from the computer keyboard The browser can access content from a web server via a WAP gateway or from a local disk WAP gateway Web server 8 e System overview WapIDE User s Guide Application designer The WapIDE application designer is a WML editor with which you can design and test WAP applic
7. iso ir 100 11 latin1 csisolatin2 iso 8859 2 iso8859 2 iso ir 101 12 latin2 arabic csisolatinarabic ecma 114 iso 8859 6 iso ir 127 csisolatingreek ecma 118 elot_928 greek greek8 iso 8859 7 iso ir 126 csisolatin9 iso 8859 9 latin9 ms kanji csshiftjis extended unix code packed format for japanese cseucpkdfmtjapanese csiso2022j p cp874 All character set names are case insensitive WapIDE User s Guide Using the WapIDE application designer e 35 Setting application designer preferences These settings control the text presentation in the application designer source pane Fonts E Settings Colors Code Se Monospaced I Pick a font size and style to change me Font Select the font to use from the list Size Select the font size from the list Colors lt Comment gt tag parameter Quoted Value parameter Unquoted value gt Normal text especial Caracter lt davascript gt Attribute Select the attribute type to change the color for from the list a Press this button to open a color chooser for the selected attribute 36 e Using the WapIDE application designer WapIDE User s Guide Code style E Settings Use smart When this box is checked new lines are indented at the same indenting position as the previous line WapIDE User s Guide Using the WapIDE application designer e 37 Working with push messages Push is anew WAP feature In the traditional
8. Configuring a Web Serve ccoooonnnnnnncncnnnnnnnnncnonononnnnnnnnnnnnos Creating dynamic WML applicati0DS ooooononononononnnonooo Managing SESSIONS ida atean ia Creating WMLScript applicati00S ooooonnnnnoooooooonnnnnnnnnnos Installing a local gateway Downloading and installing the gateway oocccnnnnnnnnnnn Configuring the gateway for push o oonnnnnnnonooooonnnnnnnos Define push InItIator ococccccccnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnos Turn off authentication occccccncnnccncnnnnnnnnnnnnnnnnnnnnnnnn WapIDE User s Guide Peme SUDSCIID GT sce caiesinsd Miseecd casei ascend aii a7 Detine receiver IP addres Sanoin ea assee ten cnt nar al 57 Appendix A Device limitations 59 DEVICES suppor od dis 59 Optional WAP features not SUPported ococccccnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnss 59 Functions not supported by WapPIDE deso 60 Glossary of terms 61 WapIDE User s Guide Contents e 5 Introduction Purpose and scope of the user s guide This document provides information on how to install and use Ericsson s WAP Integrated Development Environment WapIDE 3 1 WapIDE is a Software Development Kit SDK that helps you develop and test services for a WAP platform Who is this guide for This user s guide 1s for developers of WAP services It assumes that the user has a basic knowledge of WAP Otherwise we refer to the WAP resources listed in Related documents and ot
9. 51 for more information Starting the browser Start the browser by selecting Programs gt Ericsson WapIDE 3 1 gt Browser from the Windows Start menu The window shown on the next page 1s opened Initially the browser starts with the R520 device and the default home page a local WML file The default gateway 1s one that 1s available for external test use at the Ericsson Developers Zone To change the gateway refer to Gateway settings on page 22 12 e Using the WapIDE browser WapIDE User s Guide Browser window EAR520m WapIDE Mal ES File View Bookmarks Help Menu bar sA E lencIProgramt20Files Erl oolbar Location bar Device Device display Device buttons At the top of the browser window is a menu bar a toolbar and a location bar Below that 1s the device The toolbar offers quick access to common menu choices It also contains a progress indicator that rotates while a file is being loaded The location bar allows you to enter a URL to load and also keeps an history list of previously entered URLs The toolbar and location bar can be removed using the View menu Initially the window is shown with a default size but it can be resized e g to make the location field wider The device picture can be moved by dragging it centered or locked within the window using the View menu or a pop up menu WapIDE User s Guide Using the WapIDE browser e 13 Accessing an applicati
10. Windows Explorer Bookmarks Edit opens a window where you can delete and rename bookmarks WapIDE User s Guide Using the WapIDE browser e 19 Using the browser trace In the browser trace you can see system events of different types Selecting Trace from the View menu opens the trace window The trace window is also opened automatically if an error such as a timeout occurs ere WaplDE OR ES File Options Consale Device WAE Network Push searching for installed devices Found device com erics3on wap browzer gai device Raz0 a Dt Found device con ericsson wap browser gadi device Raisa De Found device con ericsson wap browser qui device R520n D Loading device R3isus FileManager loading device settings for RsoDs C Log Processing local file C Program Files Ericsson Wap_ E Log Processing local file C Program Files fEricszon Wap Tracing for Device 13 turned on Tracing for WAE is turned on Tracing for Network is turned on Tracing for Push is turned on UNI MlcLloadO0RL 1 mobileinternet ericsson com false JNI Mlastatus 1 1 http mobileinternet ericsson com Content 13 opened http s mobileinternet ericsson con The trace messages are divided into different tabs All All trace messages in the order they were written Console Startup messages settings etc The console trace is always on since 1t can contain startup errors and other impo
11. basic authentication WapIDE User s Guide Working with push messages e 39 Using the push initiator Start the push initator by selecting Programs gt Ericsson WapIDE 3 1 gt Push Initiator from the Windows Start menu F Push Initiator WapIDE Cancellation Status Query Client Capabilities Query aplbE 3 0_P 411111111 WAP Service Indication 40 e Working with push messages WapIDE User s Guide The WapIDE push initiator allows you to create push messages and send them to a push proxy gateway It also receives and displays responses from the gateway The push initiator window has three main areas Push Operation defines the type of push operation and control information that the PPG uses to send the message to the correct client Content Definition the push message content intended for the WAP client only present for push submission operations The push message can consist of one or more parts PPG Communication shows the messages sent to and responses received from the PPG in XML format The following steps are used to send a push message to the WapIDE browser or another client l Open the push settings window and enter the correct PPG information See Push settings on page 42 for more information Select the Push Submission tab and enter the PAP header information for the PPG See Push operation on page 42 Define the content to be sent to the WAP client It may consist of one or
12. downloaded from http www adobe com In some cases it is also necessary to install a WAP gateway as described in Setting up a WAP application environment on page 51 and Installing a local gateway on page 55 To use WapIDE with other character sets such as Chinese the following is recommended see Testing applications in other character sets on page 25 for more information e Windows 2000 e Java 2 Runtime Environment JRE 1 3 0 internationalized version Hardware requirements e 20 Mbytes free disk space is required for installation e Pentium II 266 MHz and 128 Mbytes RAM is recommended to get acceptable performance 10 e Installing WapIDE WapIDE User s Guide Installation procedure To install WapIDE on Windows 1 Install the prerequisite software listed above 2 Download the file WapIDE_ 31 exe from http www ericsson com developerszone 3 Run the file WapIDE_ 31 exe by double clicking on it and follow the instructions Installation overview By default an Ericsson WapIDE 3 1 menu is added to the Programs section of the Windows Start menu The structure 1s Ericsson WapIDE 3 1 gt Application Designer The WML editor Browser The WAP browser Push Initiator The push message creator Readme Release notes User s Guide This manual in PDF format WaplDE files The default directory for installation is C Program Files Ericsson WapIDE 3 1 The following subdirectories are created
13. from a web server via a WAP gateway WapIDE can also read local files without a gateway In the following three scenarios are described 1 Accessing local WML files This is an easy way to test static applications 2 Using a gateway on the Internet This method can be used to test applications that are available on the Internet 3 Using a local gateway If you want to test local applications on a web server or if a firewall prevents you from using a gateway on the Internet you have to install a local test gateway Accessing local WML files Static local WML applications can be tested in the WapIDE browser without using a web server or a gateway Place your WML files on a local disk and access them with file path file wml Local files can use relative references to other files so you can develop an appli cation and then move the directory structure to a web server Using a gateway on the Internet To access web servers on the Internet you can use a WAP gateway on the Internet Ericsson provides a WAP gateway for external test use Refer to the Ericsson Developers Zone for more details Note that the IP communication between WapIDE and the WAP gateway uses UDP ports 9200 and 9201 If you have any firewalls between WapIDE and the WAP gateway these ports must be opened in the firewall WapIDE User s Guide Setting up a WAP application environment e 51
14. not supported The progress indicator that indicates that a URL is being loaded is not shown in the device display but in the toolbar rotating globe Long options are truncated instead of scrolled sideways The optgroup element is ignored R520m e R380s Long values in input fields are truncated instead of wrapped on multiple lines The layout of options in a multiple select element is different in some cases Long options are not wrapped and a right aligned multiple select looks slightly different Image alignment is different when there are multiple images or buttons with different alignment on the same row WML lt Script confirm dialogs are not scrollable The hspace and vspace attributes on the image element are not supported e General Characters entered in password fields are not shown as asterisks The soft hyphen character entity amp shy or amp 173 is ignored The maximum size of an image that can be downloaded 1s different In Chinese mode western characters are larger than in the real devices The WTAI and Crypto WMLScript libraries are not supported 60 e Appendix A Device limitations WapIDE User s Guide Bookmark Card Character Encoding Client Content Content Encoding Cookie Deck Device DTD HTTP JavaScript WapIDE User s Guide Glossary of terms A named reference to a URL Enables the user to keep track of favorite pages and then return to them ea
15. 53 Creating WMLScript applications WMLScript is used together with WML to create WAP applications It places some procedural logic at the client side and thus reduces the need for communication with the server Typical usage is to validate user input and access function libraries stored in the client To use WMLScript you must first create your own WMLScript and then call it from a WML file as in the following example lt wml gt lt card gt lt p gt Enter amount lt input type text format N name N gt lt br gt Total SSum lt p gt lt do type accept gt lt go href calc wmls calcInterest N 12 gt lt do gt lt card gt lt wml gt The file calc wm1s contains the WMLScript code extern function calcInterest N r var Total Total Lang parseFloat N r 100 1 WMLBrowser setVar Sum Float int Total WMLBrowser refresh 54 e Setting up a WAP application environment WapIDE User s Guide Installing a local gateway This chapter describes how you install and configure a demo version of Ericsson Enterprise WAP Gateway Proxy 2 0 A local gateway is required for some test configurations as described in Setting up a WAP application environment on page 51 It is also required to test push messages Note The demo version of the gateway does not support WTLS To test WTLS applications you need access to another gateway Downloading and installing the gateway A demo version of
16. DE application designer e 31 When you insert an element a pop up menu with the element attributes is shown fs card attributes EJ title newcontext C tue false ordered i true false oOnenterfonvard onenterbackward ontimer Three attributes xml lang 1d and class are available on all elements but not often used They are not shown 1n the attribute list Formatting text The bold italic underline big small emphasis and strong icons on the toolbar are used to format selected text parts BIUAS ES Select the text to be formatted and press the icon or select Edit Insert Markup gt from the menu bar Validating a WML deck When you open a WML file the WML structure in the project pane and the element attributes are created As you modify the WML source code there is no automatic update of the project and attribute panes To verify the syntax of a WML file and update the project and attribute panes select Tools Validate or press the G icon If there are syntax errors messages are shown in the message pane welcome wml FatalError The end tag for element type p must end with a delimiter Line 14 Colurnn 1 You can click on a message to highlight the line with the syntax error You can also validate all WML files in the project by selecting Tools Validate all 32 e Using the WapIDE application designer WapIDE User s Guide Encoding a WML deck WML fi
17. Ericsson s Enterprise WAP Gateway Proxy 2 0 can be downloaded from the Ericsson Developers Zone WAP gt Developers tools Refer to the instructions for installation and configuration The gateway can be installed on the same machine as WapIDE or on a separate machine Configuring the gateway for push These configuration steps are required to test the WapIDE push functions e Define WapIDE as a push initiator e Turn off authentication this is only required if no security is used from the push initiator e Define a subscriber to receive the push messages e Define receiver IP address this is necessary to reroute push messages to the WapIDE browser Define push initiator All push initiators must be defined in the gateway 1 Select Programs gt Enterprise WGP 2 0 gt EWGP Provisioning from the Windows Start menu 2 Press Push Initiator Create WapIDE User s Guide Installing a local gateway e 55 E http localhost 6060 WGPProvisioning Lui igp asp Microsoft Internet Explorer File Edit View Favorites Tools Help Back fat Gd search Ge Favorites EA History E5 Address A http localhost 6060 WGPProvisioning Luivigo asp Go WGP Provisioning Push Initiator Create Push Initiator Create Read Modify Delete Content Types PI Name User Agents PI Name Password a PI Authenticated Aurenicoed E Create Read Modify Delete PI Trusted Trusted User Access Zones S
18. To simplify testing this address is always part of the address list initially Push operation The following operations are supported by the WapIDE push initiator e Push submission send a push message to the PPG e Cancellation cancel a previously submitted push message e Status query request current status of previously submitted push message e Client capabilities query query the PPG for the capabilities of a specific device Note that Ericsson Enterprise WAP Gateway Proxy does not support cancellation and client capabilities query 42 e Working with push messages WapIDE User s Guide For push submission cancellation and status query the following can be specified aplDE_3 0_PIA IS 411111111 Push ID A unique ID of the push message It can be used to cancel or check status on the message WapIDE generates this ID automatically but 1t can be changed by the user Address One or more receivers of the message This should contain the subscriber MSISDN number For cancellation and status query this field is optional If omitted the request applies to all messages with the specified push ID For client capabilities query these fields can be specified apIDE _3 0_ Plo 11111111 Query ID An optional identification of the query that 1s returned in the response Application ID An optional ID of the application in the client that will be the target for subsequent push messages Addr
19. User s Guide Using the WapIDE browser e 21 Gateway settings Ea wapIDE Settings SEN Timeout Mode Security 22 e Using the WapIDE browser Select the WAP gateway to use from the list The default gateway is one that Ericsson provides for external test use IP address 195 58 110 201 See the Ericsson Developers Zone for more information When you add or edit a gateway the following information can be entered Title An optional description of the gateway If not specified the IP address is used IP address The IP address of the gateway required User ID Password Some gateways require a user ID and password Removes the selected gateway Note that no confirmation window 1s shown The number of seconds that WapIDE will wait for a reply from the gateway Use connectionless or connection oriented sessions not supported by the R320s device Not used WapIDE User s Guide Cache settings To improve performance WapIDE keeps a non persistent cache memory where the downloaded files WML WMLScript and images are stored Ea wapIDE Settings Cache description WapIDE uses the same cache size and options as the devices it simulates This field describes the cache settings for the current device Disable cache Turns the cache off While developing dynamic applications it is recommended that you disable the cache to ensure that the decks are reloaded each time __Clearcache E
20. WaplDE 3 1 User s Guide File Eda View Toots Help Cee HIS oo lman oa iD welco welcome wrnl O welcome wr i E cardivapiDE 3 1 cal veraions 1 077 gt a T pl lt DOCTYPE mul FUBLIC WAFFORUH S O lii RETE SUL wap imp Cwm led card titiez s MspITE 3 1 2 lt p slign entec gt text lt img scc eciesson_logo whap l BR be Cho WapTIDE 3 1 lt b gt 5 CBE ria heece Pl HEARE cbesfrte heet links gt Linka lt on T Foard TEAU titles heteweye id gateway E worse 08m http www ericsson com developerszone Version April 9 2001 ERICSSON Ericsson 1s the leading provider in the new telecom world with communication solutions that combine telecom and datacom technologies with freedom of mobility for the user With more than 100 000 employees in 140 countries Ericsson simplifies communications for its customer network operator service providers enterprises and consumers the world over WAP and WAP Forum are registered trademarks of Wireless Application Protocol Forum Ltd a registered company in the United Kingdom Java and JDK are registered trademarks of Sun Microsystems Inc in the United States and other countries Microsoft Windows and Windows NT are registered trademarks of Microsoft Corporation in the United States and or other countries Adobe and Acrobat Reader are either registered trade
21. Wireless bitmap image vnd wap wbmp wbmp Creating dynamic WML applications In dynamic applications the WML decks are generated from input given by the user contents of a database etc This 1s typically done with JavaServer Pages JSP Java servlets Active Server Pages ASP or CGI scripts Testing these applications requires a web server with support for the chosen method It is important that the response content type is set correctly in the generated WML Here is a simple JSP example lt response setContentType text vnd wap wml lt gt lt xml Vversion I 0 95S lt DOCTYPE wml PUBLIC WAPFORUM DTD WML 1 1 EN http www wapforum org DTD wml_1 1 xml gt lt wml gt Gard 1a earal s lt p gt JSP test lt p gt lt card gt lt wml gt In ASP the following is used instead lt Response ContentType text vnd wap wml gt Managing sessions Dynamic applications often require that the web server keeps session information which is usually handled with cookies Most WAP devices do not support cookies Some WAP gateways e g Ericsson s WAP Gateway Proxy support cookies and store them on the client s behalf This means that you cannot assume that cookies are supported in the WAP environment and that you have to use other methods for session management such as including a session ID in the decks URL rewriting WapIDE User s Guide Setting up a WAP application environment e
22. al you should not perform this step l WapIDE User s Guide the Windows Start menu Select Gateway Proxy and then Proxy and click on the right mouse button Select Properties from the pop up menu Installing a local gateway e 57 Select Programs gt Enterprise WGP 2 0 gt EWGP Configuration Tool from 4 Select the Push proxy parameters tab Local Computer imyGetewyNeme SSS http Aa ani cor WWEIP LIO30U4 A AH 100 29002 147 214 152 124 5 Under Bearer gateway to use enter 29002 for Port number and the address of the WapIDE machine for IP address Make a note of the previous values if you want to use the gateway for pushing to real terminals later For the changes to take effect the push service must be restarted 1 Select Programs gt Enterprise WGP 2 0 gt EWGP Node supervisor client from the Windows Start menu 2 Press Show Details 3 Restart the Push Delivery Service by first selecting Stop Service and then Start Service from the pop up menu 58 e Installing a local gateway WapIDE User s Guide Appendix A Device limitations The objective of WapIDE is to simulate the real WAP devices as realistically as possible This chapter describes optional WAP functions not supported by the Ericsson devices and therefore not by WapIDE and areas where WapIDE does not work exactly like the real devices Devices supported The following devices are currently supported by WapIDE Device WAP releas
23. ations There is also a WMLScript editor for writing and compiling WMLScript code WML WMLScript and other files can be managed in projects The application designer is integrated with the WapIDE browser so you can easily test your applications on different devices FAR520m WapIDE fel E3 File View Bookmarks Help HJ waplDE untitled olx File Edit View Tools Help DES eS oo sO Od F O ome Sb ee we BIUASE 5 untitled accesskey_01 wml text_1 wml dialogs wmis 4 1 text_01 wml accesskey_01 wnl lt xml version 1 0 2 gt 8 0 card Accesskey 1 lt DOCTYPE wml PUBLIC WAPFORUM DTD WML 1 2 EN 3 8 card Link followed http www wapforum org DTD wm112 dtd gt T lp lt WapIDE SDK WML Application Wed Nov 17 20 42 43 W Europe Daylight Time 1999 gt Ol lt wml gt BR br lt card title Accesskey 1 gt text lt p gt text anchor lt a accesskey 1 href linkl gt link 1 lt a gt s 0 text more text lt br gt lt br gt ERICSSON S dialogs wmls lt a href accesskey_02 wml gt next lt a gt lt a href accesskey_menu wml gt up lt a gt lt p gt lt card gt Be Attribute Value lt card id linkl title Link followed gt align lef lt p gt It worked lt br gt lt anchor gt lt prev gt lt anchor gt lt p gt lt card gt lt tm1l gt Row 7 Col 8
24. byte oriented form called UTF 8 A Uniform Resource Locator is an address identifying the location of a file on the Internet consisting of the protocol the computer on which the file is located and the file s location on that computer A user agent is any software or device that interprets WML WML lt Script WTAI or other resources This may include textual browsers voice browsers search engines etc A WAP gateway converts between the WAP protocol stack WSP WTP and WDP and the WWW protocol stack HTTP and TCP IP and performs encoding of WML and WMLScript This is an acronym for Ericsson s Wireless Application Protocol Integrated Development Environment The Wireless Markup Language 1s a hypertext markup language used to represent information for delivery to a narrowband device e g a phone A scripting language used to program the mobile device WML lt Script is an extended subset of the JavaScript scripting language Wireless Telephony Application A framework for accessing the telephony related functions in a mobile terminal Wireless Transport Layer Security A security protocol based upon the industry standard Transport Layer Security TLS protocol formerly known as Secure Sockets Layer SSL The Extensible Markup Language is a World Wide Web Consortium W3C standard for Internet markup languages of which WML is one such language WapIDE User s Guide
25. ck on x to confirm the input and return to the main window 18 e Using the WapIDE browser WapIDE User s Guide Using the buttons At the right hand side of the screen is a menu with buttons The desktop button does nothing WapIDE only emulates the WAP browser part of the R380s The tasks button opens a menu with different options but selecting them has no effect Some of the functions on this menu reloading the page adding a bookmark etc can be performed from the WapIDE menu bar b The view button works in the same way as the tasks button The back button goes back to the previous page as described above e e e The stop button 1s only shown while a page 1s being loaded It works in the same way as the stop button on the WapIDE toolbar Working with bookmarks Bookmarks work in the same way as in a web browser Add a bookmark for the current card by selecting Add from the Bookmarks menu It 1s recommended that you bookmark only the first card in an application Other cards may have dependencies on the browser context To retrieve a bookmarked card you select 1t from the Bookmarks menu EJA520m WaplDE ei File View i Add de Aa v 1178cc 9 News Mobile Internet dl ld se When you add a bookmark a file with the bookmark name is created As shown in the example above you can create a tree structure of bookmarks by moving them to subfolders This must be done outside WapIDE using e g
26. e Push UAProf R320s 1 1 R380s 1 1 R520m 1 2 1 y N There are also Chinese versions of these devices for example R320sc is the Chinese version of R320s These versions are partly supported since Chinese characters can be displayed in the device and entered from the computer keyboard However Chinese characters can not be entered using the buttons on the device Optional WAP features not supported These optional and new features are not supported 1 e ignored by the real devices e The optgroup R320s only fieldset R320s and R520m and pre elements e The align height width hspace vspace and localsre attributes on the image element R320s and R520m e The tabindex attribute on e g select and input elements e The big and i elements on R320s and R520m displayed as bold and normal font respectively e Thei and u elements on R380s displayed as bold font WAP 1 2 1 is also known as the June 2000 conformance release WapIDE User s Guide Appendix A Device limitations e 59 Functions not supported by WapIDE These functions are not supported or work differently in WapIDE e R320s and R520m There are no scroll indicators that indicate whether the window can be scrolled up or down or not In the real devices when an input window is opened a text with abc or 123 1s shown briefly to indicate the format of the input field WapIDE does not show this text The maxlength attribute on input fields is
27. e described Standard texts The standard texts in the device can be displayed in English or Chinese see Device dependent settings on page 24 To use the Chinese language you must have a Unicode font on your computer Windows 2000 has full support for East Asian languages built in For other Windows versions you must install a Unicode font and update the Java font properties file Ejrszom WapIDE als fe File View Bookmarks Help WML presentation WAP applications in any language can be presented in the browser A Unicode font is required as described above East Asian text input The Chinese models of the Ericsson phones allow entry of Chinese text from the device buttons WapIDE does not support this Instead you can use an Input Method Editor in Windows 2000 that allows you to enter Chinese text from the computer keyboard The default system locale must be set to the language you want to use The Input Method Editor is started automatically when you enter text in input fields WapIDE User s Guide Using the WapIDE browser e 25 Using the WapIDE application designer The WapIDE application designer is a WML editor with which you can design and test WAP applications There is also a WMLScript editor for writing and compiling WMLScript code WML WMLScript and other files can be managed in projects The application designer 1s integrated with the WapIDE browser so you can easily test your application
28. eceeeeeeeeeeeeeees Working with files cccccccccceeceeeeeeeeeeeeeeeeeeeeeeeeeeeees Creating ne wilson iii Adding files to a projeCt occcccnnncnnnnnnninnnnnininininnnnnnns Removing files from a project oooccnnnnnnnnnnnnininininininm Saving and closing files oonnnnnnnnonononononooonnnnnnnoos Edine WML decks atada Structure of WML deckb cccsccccccccssessssssssseees Inserting elements in a WML deck P ORMAUING ted i s Validating a WML deck oononnnnninininininonininininininnninn Encoding a WML deck ooooonnnnnnnnninnnnnnnnnnnnnnnnnncnnnnnnnos Editimo WWIE Scarlett Testino application i adds Creating applications in other character sets Setting application designer preferences occccccccnnnnnnnnos A eae E EEE Working with push messages WapIDE implementation of push ccccccceeeeeeeees Using the push initiator ta PUSH setini Sanda a A a PUSIPOPErAlION Aan Mea ea teat Content dennitiOn id PPG COMMUNIC AION a RECEIVING Push MESSAGES sai eens ia es Service INCICALI OM do Other message TYPES sie ita Pushing messages to a real terminal occcnccnnnnnncncnnnn Writing applications that generate push messages Setting up a WAP application environment OVINA Accessing local WML files ooonnnnnnninininininnnnnnnnnnnnnnnnnnnnnos Using a gateway on the Internet ococnnnnnnnnnninnninnninnninnnm sine a local Cate Way id
29. erver Modify Delete Done EE Local intranet 3 Fill in PI Name e g wapide and Password e g Wapide31 The other fields can be left as they are Press Create This should create the push initiator in the gateway database and as a Windows user If you get the message WIN2000 account could not be created the installation 1s probably not correctly done Try this procedure 1 Open Push proxy parameters as described in Define receiver IP address on page 57 2 Inthe field Domain or machine for Push initiators authentication insert before the machine name 3 Restart the push service as described under Define receiver IP address Then delete and recreate the push initiator delete may give error messages which you can ignore Turn off authentication Note This step is only required if you want to use WapIDE or another push initiator without HTTP basic authentication security 1 Select Programs gt Administrative Tools gt Internet Services Manager from the Windows Start menu Select Default Web Site and then ppgctrl and click on the right mouse button Select Properties from the pop up menu Select the Directory Security tab ee ee ye Under Anonymous access and authentication control press the Edit button 56 e Installing a local gateway WapIDE User s Guide Authentication Methods x 6 fe 8 9 10 Restart the Default Web Site Select first Stop and then Start from the
30. ess The target device address subscriber MSISDN number WapIDE User s Guide Working with push messages e 43 Push submission advanced settings The push submission operation has additional options that can be accessed using the Advanced button Many of these are not supported by Ericsson Enterprise WAP Gateway Proxy EWGP Push Message Advanced Settings MAMM DE 2001 gt gt 7 mmes 13 10 38 25 Pinclude T M Do 2001 gt 4 e mms 13 10 38 25 Include T A A progress notes requested medium E Jnotspeciied OOOO O FO Required 7 FO Required Push Message Fields Deliver Before Deliver After Source Reference ppa notiferequested to Quality of Service Fields Priority Delivery Method Metwork Bearer EA Deliver before The date and time by which the content must be delivered to the WAP client The default is one day from the current time Check nclude to add this field Not supported by EWGP Deliver after The date and time after which the content should be delivered to the WAP client The default is the current date and time Check nclude to add this field Not supported by EWGP Source A textual name of the content provider This is useful to a PPG reference operator in identifying the originator of the message Ignored by EWGP Ppg notify The address e g URL that the PPG should use for notification requested to Progress notes of results related to this message Note tha
31. hat should be 12 untitled EL penguin wml 1 47 card Pizza Penguin Eli card nop 3 o text el card Select Pizza FP card Mame Address Hi card Contact Us FP card Oven On li cardivhat s Or Attribute present in all cards The order of the cards does not matter except that the first card in the deck is the one that is displayed when the deck is loaded The structure of the WML deck is shown in a tree in the project pane When you click on an element in the tree the source for that file 1s displayed and the attributes of the elements are shown in the attribute pane In this example the p paragraph element has been selected and the attributes for the paragraph are shown The only attribute specified or defaulted is align The other attributes are shown in a different color to indicate that they have not been specified Inserting elements in a WML deck From the toolbar or by using Edit Insert from the menu bar you can insert new elements into a WML deck The elements that are allowed at the current position are highlighted the others are gray These toolbar icons are used to insert elements Er i card j do T p PRE pre 2 a T anchor WapIDE User s Guide template head meta access p P br fieldset _JH select option optgroup image input HT table tr td 7 timer onevent go prev noop refresh setvar postfield Using the WapI
32. hen the SL is received e Execute low high The service identified by the URI is loaded either from an origin server or from the client s cache and executed The exact behavior for the different actions depends on the client e Cache The service is loaded in the same way as above but placed in the cache instead of being displayed in the browser Working with push messages e 47 WAP CO The Cache Operations CO content type provides a means to invalidate content objects in the user agent cache The invalidated content objects must be reloaded from the origin server the next time they are needed There are two operations invalidate object and invalidate service e invalidate object invalidate the object uniquely identified by the given URI e invalidate service invalidate all the objects that share the same URI prefix Invalidate object The URI of the cached object to invalidate Invalidate service The URI prefix of the cached objects to invalidate User defined Other content types for specific applications may be added under the User defined tab extend wap rr es ee Content type Select a content type from the list or type in another content type Content file Enter a file name or use the Es button to locate the file 48 e Working with push messages WapIDE User s Guide PPG communication The PPG communication field shows the messages sent to and responses received from the push proxy ga
33. her resources Related documents and other resources Related Internet sites Ericsson http www ericsson com Ericsson Developers Zone http www ericsson com developerszone Ericsson Mobile Internet http www mobileinternet ericsson com WAP Forum http www wapforum org Related documents These related documents can be found at http www ericsson com developerszone Mobile Phone R320 Design Guidelines for WAP Services Mobile Phone R380 Design Guidelines for WAP Services Mobile Phones R520 T20 and A2628 Developers Guidelines WAP Services 6 e Introduction WapIDE User s Guide Changes from previous version The main differences between WapIDE 3 1 and 3 0 are e An application designer WML editor is added e Support for the R380s smartphone is added e Support for the WAP push framework is added e Support for connection oriented mode is added e Support for user agent profiles UAProf 1s added e The WML encoder now supports other character sets e WapIDE now uses the same cache options as the real terminals e Devices can be shown in different colors Support Support can be found at the Ericsson Developers Zone see Related Internet sites free of charge Typographical conventions The following typographical conventions are used in this document Bold Names of commands in menus buttons Italic Specific terminology Courier Computer text file names WapIDE User s Guide Introduction 7
34. his button in the Push Message tab to delete parts Advanced content settings Additional HTTP header settings that apply to all parts of the content can be accessed using the Advanced button Fd Advanced Content Settings X Wap Application Id_ See the WAP Push Message specification on X Wap Content URI www wapforum org for a description of these HTTP X Wap Initiator URI headers WapIDE User s Guide Working with push messages e 45 WAP SI The Service Indication SI content type provides the ability to send notifications to end users in an asynchronous manner Such notifications may for example be about new e mails changes in stock price news headlines etc In its most basic form an SI contains a short message and a URI indicating a Service DE DE Inttptwap etse 00 rap vd se SI ID May provide the SI with an identity in order to make it possible to distinguish between different SIs If not specified it is considered to be the same as the value of Service URI Service URI This attribute specifies the URI that is used to access the service If no service URI is specified the SI corresponds to a notification no service can be initiated Message The text presented to the end user upon reception Include Add the fields under advanced settings to the message advanced fields Sl advanced settings Using the Advanced button the following fields can be specified SI Advanced Settings 46 e Working wi
35. ield Entering data You can enter data in input fields in two ways e By clicking on the buttons on the device This works in the same as for the real telephones e g press button 2 three times to get the character C e By using the computer keyboard This is a faster way to enter text The Enter key corresponds to the Yes button and the Esc key to the No button Input fields can be in different formats such as numeric alphabetic etc and of different lengths WapIDE verifies that the input is in the correct format and stops 16 e Using the WapIDE browser WapIDE User s Guide you from entering e g alphabetic characters in numeric fields or strings that are too long When you enter text on a real telephone a character menu is shown in the upper right corner each time you press a button WapIDE shows similar information in a small pop up window tool tip when you hold the mouse over a device button Using the options menu When you hold down the Yes button an options menu is shown On the R320s device a short click on Yes will also display the options menu if no link is in focus On the R520m device the microphone button will also display the options menu The options menu contains any actions defined in the current card soft options In the example below prev and TV4 SE are such options The options menu also contains a number of fixed options such as 1 Mobile Internet above but these options have
36. les can be encoded 1 e compiled to verify the syntax and to create a compiled wmlc file Select Tools Compile or press the Eb icon to compile a file If it is modified the file is automatically saved before compilation Compilation information and error messages are shown in the message pane The compiled file is stored in the same directory as the source file Editing WMLScript files The WMLScript editor is a standard text editor WML lt Scripts can be compiled to verify that the syntax is correct and to create a compiled wmlsc file Select Tools Compile or press the Eb icon to compile a file Compilation messages are shown in the message pane Compiler Read 166 bytes into buffer Compiler Compiling WMLScript file E calc wmls Compiler The result is stored in E calc wmlsc Compiler The file size is 51 bytes The compiled file is stored in the same directory as the source file As with WML files it is not necessary to compile WML Scripts to test them in the WAP browser but it 1s the only way to test the syntax since there 1s no validate function for WMLScript WapIDE User s Guide Using the WapIDE application designer e 33 Testing applications For WML decks select Tools Test or press the b icon to display the current deck in the WAP browser window If the file has been modified it is saved before the browser is invoked WapIDE Application WAP browser designer
37. les created in the project Description An optional description of the project The project properties are then shown in the attribute pane when the project is selected in the project pane Attribute Value Default Project cUrrentDtd 1 2 projectLocation l projectwapid projecihame untitled Opening an existing project To open an existing project select File Open project from the menu bar or press the La icon and locate the project file 28 e Using the WapIDE application designer WapIDE User s Guide Working with files Multiple files may be open at the same time Each file is shown in a separate tab in the source pane Files are opened when you click on the file in the project pane When you hold the mouse over a file name in the project pane the full path to the file is shown in pop up window tool tip In the source pane normal text editing functions such as cut amp paste undo redo and find amp replace are available Creating new files Select File New gt New WML deck or New WMLScript or press the Li icon to create a new file The window below is shown FA New Deck 53 Deck name Type fmni Deck directory hapide_nglbimicormericssorwapeditor Pe Cancel A new file is automatically added to the current project When a new WML file is created it contains the required header tags xml IDOCTYPE and wml and a card with an empty paragraph Adding files to a projec
38. marks or trademarks of Adobe Systems Incorporated in the United States and or other countries This product includes software developed by the Apache Software Foundation http www apache org First edition April 2001 This document is published by Ericsson Radio Systems AB without any warranty Improvements and changes to this text necessitated by typographical errors inaccuracies of current information or improvements to programs and or equipment may be made by Ericsson Radio Systems AB at any time and without notice Such changes will however be incorporated into new editions of this document Reproduction distribution or transmission of part of or all of this document in any form without the prior written permission from Ericsson Radio Systems AB is prohibited All rights reserved Ericsson Internet Applications AB 2001 Contents Introduction 6 Purpose and scope of the user s Quide ccccccesessseeeseseeeeeeeeesseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 6 Who ISS Id TOA a 6 Related documents and other reSQUICES ccccccccconnnnnooonononnnnnnnnnnnonnnnnnnnnnnnnnnnnnononnnnnnnnnnnnnnns 6 Related IMteine G SES ii is 6 Related GO CUM is 6 C hances Moni Previous VEO da 7 A S A A 7 TIPOS ica CAN A to 7 System overview 8 A A neon Rem AE Se EE Aen AAE OUR E HL MT E ne See 8 TOW Sais 8 Application dei 9 SR ohana ea iotacsaden oNcuaaconn ie tase ae S Rat 9 Installing WapIDE 10 System A a aR 10 SOME Sd e
39. more parts See Content definition on page 45 Send the message by pressing the Send Message button or by using File Send from the menu bar You can also look at the PAP message source before it 1s sent by using File Preview Check the response messages from the gateway See PPG communication on page 49 Check the result in the browser See Receiving push messages on page 49 WapIDE User s Guide Working with push messages 41 Push settings Select View Settings from the menu bar to open the Push Settings window These settings must match the configuration of the gateway see Configuring the gateway for push on page 55 Ea wapIDE Push Settings Push Proxy Gateway URL nttew 127 0 0 ppgetippgcontrollogic dll Lise Basic Authentication Liser ID Pra Password Pra PPG Address Domain pipercssonse ssi lt sSSCS Default Target Address PA s i i Ciz OK Cancel Push proxy gateway URL The URL for posting push messages For Enterprise WAP Gateway Proxy 1t should be specified as http lt hostname gt ppgctrl ppgcontrollogic dll Use basic authentication Indicates that HTTP basic authentication should be used when posting to the PPG Otherwise no security is used User ID If basic authentication is used the user ID and Password password must be specified PPG address domain The Internet host name of the PPG Ignored by Enterprise WAP Gateway Proxy Default target address
40. mpties the cache memory WapIDE User s Guide Using the WapIDE browser e 23 Device dependent settings The options available in this tab depend on which device is currently active The example below is for R380s Ea wapIDE Settings Classic Blue Cache size For the 380 device you can select the size of the internal cache memory 0 4 8 16 or 32 kB WAP browser The language can be set to English or simplified Chinese language Note that this only controls the language for the fixed texts in the device The WapIDE windows are always in English See also Testing applications in other character sets on page 25 Title bar sequence For the 380 device this indicates that the titles of the preceding cards in the application should be included in the window title e g Card 1 gt Card 2 gt Device image For each device you can choose between different colors WAP browser font For the R520 device you can specify the font size to use in the size device display small medium or large This affects the number of lines that can be shown When the language is set to Chinese the largest font size is always used 24 e Using the WapIDE browser WapIDE User s Guide Testing applications in other character sets It is possible to test WML applications in other character sets such as Chinese Windows 2000 is recommended for developing international applications Below some aspects of using other character sets ar
41. n in a trusted network For a complete description of the WAP push framework refer to the specifications on www wapforum org 38 e Working with push messages WapIDE User s Guide WaplDE implementation of push WapIDE supports push in the following way e WapIDE provides a push initiator where push messages can be created and sent to a push proxy gateway using PAP e Normally the PPG sends the messages to a mobile phone The Ericsson Enterprise WAP Gateway Proxy 2 0 or WAP Gateway Proxy 3 0 can be configured to instead send the messages to the WapIDE browser using an internal protocol Refer to Installing a local gateway on page 55 for configuration instructions e The WapIDE browser can receive and display push messages in the same way as the real devices Push is currently supported by the R520m device only WaplDE Push initiator WAP browser Push y Enterprise WAP Gateway Proxy You can also use the WapIDE push initiator to push messages to a real terminal or use other push initiators with the WapIDE browser Note When the gateway 1s configured to send push messages to WapIDE all messages will be sent to one WapIDE browser regardless of the address specified in the push message To push messages to another WapIDE browser or to a real terminal the configuration must be changed The WapIDE push initiator supports two security levels e No security e HTTP
42. nate se toe es 10 Hardware requirements soe sop sar erie ates A oo declan ey 10 Installation EOC URC lt i scent ii A E a de 11 lastalla OM OV CE VIC Wi a pida 11 WapIDE TS ia isa 11 Unmstallino Wap DE lt a ii 11 Using the WapIDE browser 12 STA he DI de id 12 ISRO WSER WAN Wi a a A A 13 Accessine am applica OM sgh octets cheat A A ati 14 Delectmo He Cai 6 Ce VC ea a aa 14 Usina hie 037R Z0 DOWNS EE sea e dida 16 Osina THE device DUON dices 16 Eorna 002 O Me ene Ce eRe A A ee er EE 16 Siti TH OP UONS Malta 17 Usina The RS SOS DO WS ad 18 MSN AIIM oped fected alte catia a dde 18 EMO Catate 5204 on ett iii 18 Usina he DUtlONS iba 19 Working with DOOKINALKS A 19 Usina The browser tace iis iaccnia tices sauheans itiianaseeta i e a a 20 Seting browser PESTE o 21 BEI ad 21 Gateway CNO title 22 Cache IO atico 23 Device dependent settings ais 24 Testing applications in other character Sets oooooconccocococacacaoononononononorn nono nono nono nono nono nn nnnnnnos 25 A odasnaasaut sesoaeson E A 25 WML PEES ENAMORA a 25 WapIDE User s Guide Contents e 3 4 e Contents East Asian text input sesso hceiecinoacntaniesnnaee Using the WapIDE application designer Starting the application designer oocccccccccnnnnnnnnnnnnnnnnnns Application designer Window cccccccccccncccccnnnnnnnononos Working With projects cccccccccceseeeeeeeeeeeeeeeeeeeeeeeeeees Creatine a New Pro ets Opening an existing project ce c
43. nd attributes that are available for use in an XML document that complies with the DTD The Hypertext Transfer Protocol is the client server protocol that defines how messages are formatted and transmitted on the World Wide Web A de facto standard language that can be used to add dynamic behaviour to HTML documents JavaScript is one of the Glossary of terms e 61 Origin Server Proxy Server Resource Terminal UAProf Unicode URL User Agent WAP Gateway WapIDE WML WMLScript WTA WTLS XML 62 e Glossary of terms originating technologies of ECMAScript The server on which a given resource resides or is to be created Often referred to as a web server or an HTTP server An HTTP server typically running on a firewall machine that provides access to the outside world for clients on a local network A network data object or service that can be identified by a URL A device providing the user with user agent capabilities including the ability to request and receive information Also called a mobile terminal or mobile station User agent profiles specify device characteristics that are used by the origin server for content formatting purposes A universal character encoding scheme for written characters and text It defines a consistent way of encoding multilingual text that enables the exchange of text data internationally Unicode provides for two encoding forms a default 16 bit form and a
44. no effect in WapIDE The same functions reloading the page adding a bookmark etc can be performed from the menu bar WapIDE User s Guide Using the WapIDE browser e 17 Using the R380s browser The R380s device is quite different from the traditional mobile phones It provides a large touch screen and is controlled with a pen instead of buttons on the device ER380s WaplDE Al ES File View Bookmarks Help O htpiimobileinternetericsson comid asp _s 97b493622 F Mobile Internet ERICSSON Login Signs Announcement Currencies Maha Chat NOSSIIY3 Navigating Follow links by clicking on them with the mouse like in a web browser Click on the arrows in the scroll bars to scroll horizontally or vertically The browser keeps a history list of visited applications The Back button goes back to the previous card When the first card in the current application is reached Back goes to the first card in the previous application Entering data Open input fields and single select fields by clicking between the lt gt brackets User ID bob ila wie r tlyl ulilolp xl capsa s a t Jo n i kI EE A z x c v b n m L F F A a A EA WapIDE allows text input from the computer keyboard only The real R380s device allows text input from an on screen keyboard or a character recognition screen but these methods are not supported by WapIDE The on screen keyboard is displayed but has no effect Cli
45. on Applications are accessed by an URL To load a URL you can do one of the following e Type the address in the Location field as a normal Internet URL e g http mobileinternet ericsson com You can also load a local WML file by typing file C path file wml If you use a relative file URL that does not start with e g C the reference is relative to the WapIDE samples directory For example file project1 test wml 1s the same as file C Program Files Ericsson WapIDE 3 1 samples project1 test wml e Select an URL from the history list for the Location field e Select a bookmark as described in Working with bookmarks on page 19 e Select Load URL from the File menu and type a URL in the same way as above Load URL Load URL hitte mobileinternet ericsson com Ok Cancel Browse Pressing the Browse button opens a file chooser window where you can select local WML files to load file access The browser will load the application and show the first card in the display Note At Ericsson Mobile Internet there is a list of links to WAP enabled sites that you can try Selecting the device To open the current card with another device select Load device from the File menu EAR520m WapIDE Mel Ea MEM view Bookmarks Help Load UEL Load device P Exit R520m 14 e Using the WapIDE browser WapIDE User s Guide The window switches to the selected device R320s R520m
46. pes are handled in the following way Service loading the specified URI is loaded and displayed in the browser immediately Cache operations these operations are not visible for the user User defined not supported by the WapIDE browser Pushing messages to a real terminal You can also use the WapIDE push initiator to push messages to a real terminal provided that your gateway is connected to a network that supports push In this case you should not reroute push messages from the gateway to WapIDE as described in Define receiver IP address on page 57 It is also important that a real MSISDN 1s defined see Define subscriber on page 57 Writing applications that generate push messages You can use WapIDE as a help in creating push applications l 2 Use the WapIDE push initiator to create the push messages you want Copy the XML messages from the PPG communication window and use them as a model Write the application that creates the push messages and sends them to the gateway using HTTP post Note that you need to use HTTP basic authentication or a higher security if you don t deactivate that in the gateway Test the application by pushing messages to the WapIDE browser When the application is working deploy it in a real environment 50 e Working with push messages WapIDE User s Guide setting up a WAP application environment Overview The WapIDE browser like a mobile phone accesses content
47. pop up AMOMYMOUS access No user name password required to access this resource Account used for anonymous access Edit Authenticated access For the following authentication methods username and password are required when anonymous access le disabled or access ls restricted using NTFS access control lists Basic authentication password is sent in clear text Select a default domain Edit P Digest authentication for Windows domain servers Integrated Windows authentication Cancel Help Activate Anonymous access Press Edit and specify the push initiator created above as anonymous user Deactivate Basic authentication Press OK twice to return to the Internet Information Services window menu Define subscriber One or more subscribers to receive the push messages must be defined in the gateway When you reroute push messages to the WapIDE browser it does not matter which subscriber MSISDN number you specify However the address subscriber you specify when you send push messages must be defined in the gateway 1 Start EWGP Provisioning in the same way as above 2 Select Subscriber Create 3 Fill in MSISDN e g 11111111 User ID and Password Refer to the online help for further instructions Press Create Define receiver IP address This step 1s necessary to route push messages to the WapIDE browser If you are pushing to a real termin
48. pull case the transactions are always initiated from the client Push technology allows a push initiator somewhere on the Internet to send content to a WAP client via a push proxy gateway PPG Push Over the Air Protocol Push Access Protocol Push Initiator Push Proxy Gateway WAP Client The push initiator sends content to the PPG using the push access protocol PAP The PPG delivers the push message to the WAP client using the push over the air protocol OTA PAP uses XML documents that are sent over HTTP The following operations are defined Push submission initiator to PPG Result notification PPG to initiator not supported by WapIDE Push cancellation initiator to PPG Status query initiator to PPG Client capabilities query initiator to PPG PAP allows any content type to be pushed to the WAP client However the client may not be able to receive them The WAP standard defines three push content types e Service Indication SI send a notification to the WAP client e Service Loading SL cause the WAP client to load and execute a service e Cache Operations CO invalidate content objects in the WAP client cache Different security levels can be used for authenticating the push initiator such as TLS SSL signed or encrypted content HTTP authentication or no authenticatio
49. rtant information Device Device related traces WAE Wireless Application Environment WAE information related to the WAP stack and interpretation of WML code Network Network communication traces such as files read from the network Push Push related traces By default only the Console trace is active The other traces Device WAE Network and Push can be activated using the Options menu Using File Clear you can clear the traces written so far for the current tab File Clear all clears all traces Some of the messages in the trace window contain internal WapIDE information that is normally not relevant to the user but can be important if you report a WapIDE problem 20 e Using the WapIDE browser WapIDE User s Guide Setting browser preferences Selecting Settings from the View menu opens the settings window There are four tabs in the window e Browser e Gateway e Cache e Device dependent Browser settings This tab contains general browser settings Ea waplDE Settings le fwelcome wrnlc E ES rico Home page The home page is loaded when WapIDE is started and when the Home button is pressed History WapIDE keeps an internal history list of loaded WML decks The size of this list limits the number of times you can go back to the previous card Location bar The location bar history list contains all the URLs entered in history the location field Pressing Clear empties this list WapIDE
50. s on different devices Starting the application designer Start the application designer by selecting Programs gt Ericsson WapIDE 3 1 gt Application Designer from the Windows Start menu The application designer opens with the last project used The first time it 1s started there 1s an empty project untitled Application designer window At the top of the application designer window 1s a menu bar and a toolbar Below these are a number of different areas or panes e The project pane shows a tree view of the current project the files in the project and the structure of the WML files e The attribute pane shows the attributes of the current project file or element in a WML file e The source pane shows the source code for the selected WML or WMLScript file Each open file is shown in a separate tab e The message pane shows messages from compilation etc All panes can be resized and scrolled if necessary 26 e Using the WapIDE application designer WapIDE User s Guide Menu bar Toolbar Source pane Ea wapIDE untitled de untitled H O text_O1 wml E i accesskey 01 werrl lt xnbl version 1 0 2 gt BB carapaccesskey 1 lt DOCTYPE wml PUBLIC WAPFORUM DTD WML 1 2 EN B card Link followed http myu wapforum org DTD wml12 dta gt aT lt WapIDE SDK WML Application Wed Now 17 20 42 43 W Europe Daylight Time 1999 gt bot Ol cum gt gt BR br lt eard title Accesskey 1 gt pe te
51. sily later on A single WML unit of navigation and user interface May contain information to present to the user instructions for gathering user input etc Conversion between a sequence of characters and a sequence of bytes and vice versa Normally WML document character encoding 1s captured in transport header attributes such as the Content Type s charset parameter meta information placed within a document or the XML declaration A device or application that initiates a request for connection with a server Subject matter data stored or generated at an origin server Content is typically displayed or interpreted by a user agent in response to a user request Conversion of content from one format to another Typically the resulting format requires less physical space than the original is easier to process or store and or is encrypted Itis can also specify a particular format or encoding standard or process A cookie is a small piece of information that an HTTP server sends to a browser when the browser connects for the first time Thereafter the browser returns a copy of the cookie to the server each time it connects Typically the server uses the cookie to maintain a session for the user A collection of WML cards A WML deck is also an XML document In this document used as a synonym for terminal A document type definition DTD 1s a collection of declarations that defines the legal structure elements a
52. t To add a file to a project select File Add to project Add WML deck or Add WMLScript or press the icon and locate the file When a WML file is added it is validated against the DTD stored locally If there are invalid tags error messages are written but the parsing continues and the file is shown Other file types including WMLScript wmls pictures wbmp gif and jpeg and different text files txt html jsp and asp are shown as a single node in the project pane The source code is shown if possible Removing files from a project Select File Remove from project to delete a file from the list in the project pane The file itself is not changed Note that this works on the file selected in the project pane not on the currently active tab like other menu options WapIDE User s Guide Using the WapIDE application designer e 29 Saving and closing files Modified files are marked with small red x in the file icon You can save a selected file or all modified files When you close files or exit the application WapIDE prompts you for the modified files Ea Select IM text 01 win W table 14am I dialogs wmls 30 e Using the WapIDE application designer WapIDE User s Guide Editing WML decks Structure of WML decks A WML deck contains one or more cards and optionally a template The template contains elements that are common to all cards A typical example is a Back action t
53. t the WapIDE push initiator can not receive these notifications Informs the PPG as to whether or not the push initiator wants to requested receive progress notes Ignored by EWGP Priority The delivery priority of the message low medium or high Ignored by EWGP Delivery method The desired OTA delivery method For EWGP notspecified unconfirmed and preferconfirmed all result in unconfirmed push Confirmed is not supported by EWGP Network The network desired for use when delivering the message If Required is checked the specified network must be used EWGP only supports GSM Bearer The bearer desired for use when delivering the message If 44 e Working with push messages Required 1s checked the specified bearer must be used EWGP only supports SMS WapIDE User s Guide Content definition The push message contents to be sent to the WAP client typically consists of a single WAP SI or SL message It may also be a multi part message with e g a WAP CO message followed by a WAP SL message note that multi part messages are not supported by Enterprise WAP Gateway Proxy texbind wap si WAP Service Indication The Push Message tab in the content definition area contains a list of all the parts The other tabs are used to create parts of the message Addtomessage Use this button in the WAP SI WAP SL WAP CO and User defined tabs to create message parts Use t
54. teway in XML format PPG Communication lt 2xml version 1 0 2 gt lt DOCTYPE pap PUBLIC WAPFORUM DTD PAP 1 0f EN http sw waptorum pap lt push message push id WapIDE 5 0 P1fs0 gt address address value wappush 11111111 type plunteip ericsson se push messaqe gt The following colors are used for the text in the PPG communication field Blue Messages sent to the PPG Green Messages received from the PPG Red Error messages such as HTTP errors Recelving push messages The WapIDE browser can receive and display push messages in the same way as the real devices An exception 1s the push inbox function that allows you to look at old push messages The WapIDE browser does not support this function Push is currently supported by the R520m device only Under the Push tab in the browser trace window see Using the browser trace on page 20 you can see details about received push messages Service indication When the browser receives a WAP SI message a window like this is shown sm The text 1s the user message specified on the SI message the title 1s the first part of the text When Proceed is selected this window is shown Load loads the URI specified in the SI message Delete removes the message Postpone is not supported since WapIDE does not store old push messages WapIDE User s Guide Working with push messages e 49 Other message types The other content ty
55. th push messages WapIDE User s Guide Action priority Created S expires Class Value WAP SL The action to be taken when the SI is received e Signal low medium high Present the message to the user The exact behavior for the different actions depends on the client e Signal none The SI will not be presented to the end user However the client may use the information carried in the SI info fields to perform certain tasks e Delete The received SI and any other SI with identical SI ID will be deleted SI ID must be specified The date and time of creation or last modification of the content indicated by Service URI The date and time when the SI expires and thereby is automatically deleted or marked as expired If this attribute 1s not specified the SI never expires The SI info fields provide a means to specify additional information to the WAP client Refer to WAP Service Indication on www wapforum org for more information The Service Loading SL content type provides the ability to cause a user agent on a mobile client to load and execute a service that for example can be in the form of a WML deck Content Definition Push Message WAP SI WAP SL wap co User defined WAP Service Loading service URI fttp Action Jexecute low Add to message Service URI The URI that is used to access the service Action WapIDE User s Guide The action to be taken w
56. xt lt p gt text lt a accesskey 1 href linkl gt link 1 lt a gt more text lt br gt lt br gt lt a href accesskey_02 wml gt next lt a gt lt a href accesskey menu wnl gt up lt a gt lt p gt lt card gt lt card id link1 title Link followed gt lt p gt It worked lt br gt lt anchar gt lt prev gt lt anchor gt lt p gt lt card gt lt wml gt Project pane Attribute pane Message pane The following functions are available from the menu bar Many of them are also available from the toolbar Edit Tools Li WapIDE User s Guide Using the WapIDE application designer e 27 Working with projects To simplify the administration of WAP applications the source files are grouped into projects Information about a project is saved in a project file with the extension wpr There is always one project active If you don t want to work with files without storing them in a project use the default project untitled but never save it Creating a new project To create a new project select File New gt New project from the menu bar The following window 1s shown New Project E Project name Type wor Project directory hapide_nglbimicormericssorwapmeditor e WhiL Version 41 f 12 Description Cancel Project name The name of the project file Project directory The directory for the project file WML version The default WML version for fi
Download Pdf Manuals
Related Search