| Sun ONE Portal Server, Mobile 6.2 Developer's Manual |
About This Manual
SunTM ONE Portal Server, Mobile Access 6.2 is an extension to SunTM ONE Portal Server that enables users to access portal services from mobile devices such as cellular phones and PDAs. It ships with three mobile applications: Calendar, Address Book, and Mail, all of which are fully customizable by developers.
The mobile applications listed above are based on JavaServerTM Pages (JSPTM) technology, and as such, make extensive use of custom tag libraries that implement their behavior. Each tag library is customizable through a corresponding set of APIs written in the JavaTM programming language.
In addition, the SunTM ONE Portal Server, Mobile Access 6.2 software contains support for voice accessibility, making it possible to write applications that respond directly to voice commands.
This preface includes the following sections:
Who Should Read This BookThis manual is intended for developers who want to:
- Gain a developer’s perspective of the mobile address book, calendar, and mail applications
- Change the default behavior of the application-specific tag libraries provided in this release
- Customize or extend the Portal Desktop for their mobile devices
- Create voice-enabled applications accessible from any telephone
What You Need to KnowThis manual assumes familiarity with the following:
How This Book Is OrganizedThis book contains the following chapters and appendixes:
- Chapter 1, Understanding the Mobile Applications, provides a developer’s perspective of each mobile application by illustrating control flow through the various JSP pages.
- Chapter 2, Developing Voice Applications, explains how to add voice support to the applications that you develop. It describes voice application prerequisites, and instructions for creating new voice-enabled applications.
- Chapter 3, Using the Mobile Access Public APIs, describes how to change the behavior of the application-specific tag libraries by extending the Tag Library API. It also lists the utility classes exposed by the Desktop and Rendered Desktop APIs.
- Appendix A, Calendar Control Flow Reference Charts, lists the AML and WML-based JSP pages that comprise the Calendar mobile application.
- Appendix B, Address Book Control Flow Reference Charts, lists the AML and WML-based JSP pages that comprise the Address Book mobile application.
- Appendix C, Mail Control Flow Reference Charts, lists the AML and WML-based JSP pages that comprise the Mail mobile application.
- Appendix D, Common Voice Prompts, lists commonly-used voice prompts that are not specific to any one particular application.
- Appendix E, Authentication and Channel Chooser Voice Prompts, lists the corresponding voice prompts that are provided in this release.
- Appendix F, Notes, Personal Notes, Message Board, and Mail Provider Prompts, lists the corresponding voice prompts that are provided in this release.
- Appendix G, Calendar and Mail Voicelet Prompts, lists the corresponding voice prompts that are provided in this release.
An index is also provided.
Conventions Used in This GuideThe guide uses several typographical conventions to represent types of information presented.
Monospaced Font
Monospaced font is used for any text that appears on the computer screen or text that you should type. It is also used for file names, distinguished names, functions, and examples.
Bold Monospaced Font
Bold monospaced font is used to represent text within a code example that you should type. For example, you might see something like this:
./pssetup
*******************************************************************
Sun(TM) ONE Portal Server
*******************************************************************
Installation log at
/var/sadm/install/logs/ipsinstall.13343/install.log
This product will run without a license. However, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with, Sun Microsystems, to legally use this product.
Do you accept? yes/[no]
In this example, ./pssetup is what you would type from the command line. The rest is what would appear as a result.
Italicized Font
An italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). It is used for server paths and names and account IDs.
Square or Straight Brackets
Square (or straight) brackets [] are used to enclose optional parameters. For example, in Portal Server software documentation, you will see the usage for the dpadmin command described as follows:
dpadmin list|modify|add|remove [command-specific options]
The presence of [command-specific] indicates that optional parameters can be added to the dpadmin command.
Command-Line Prompts
Command-line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in examples. Depending on which operating system environment you are using, you will see a variety of different command-line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.
Where to Find Related InformationIn addition to this guide, this Mobile Access software release provides supplementary information for administrators as well as documentation for developers.
Use the following URL to view all the Portal Server documentation:
http://docs.sun.com/db/prod/s1.s1portals#hic
Additional documents that are available include:
Where to Find This Guide OnlineYou can find the Sun™ ONE Portal Server, Mobile Access 6.2 Developer’s Manual online in PDF and HTML formats. This book can be found at the following URL:
http://docs.sun.com/db/prod/s1.s1portals#hic
