Sun Java System Portal Server Mobile Access 7.1 Developer's Reference

Preface

Sun Java System Portal Server Mobile Access 7.1 (formerly known as Sun^TM ONE Portal Server, Mobile Access) software is an extension to Sun Java System Portal Server (formerly Sun ONE Portal Server) software that enables users to access portal services from mobile devices such as cellular phones and PDAs. Mobile Access software ships with three mobile applications—Calendar, Address Book, and Mail—which developers can fully customize.

The mobile applications listed above are based on JavaServer^TM Pages (JSP^TM) 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 Java^TM programming language.

In addition, Mobile Access software contains support for voice accessibility; therefore, applications that respond directly to voice commands can be written.

This preface includes the following sections:

Who Should Read This Book

This reference is intended for developers who want to:

Gain a developer’s perspective of the mobile address book, calendar, and mail applications
Create voice-enabled applications accessible from any telephone
Customize or extend the Portal Desktop for their mobile devices
Create pages for mobile devices using Abstract Markup Language (AML)
Gain a developer’s perspective of the Mobile Access software schema definitions for Sun Java System Identity Server software (formerly Sun ONE Identity Server software)

What You Need to Know

What you need to know will vary with the characteristics of your site. Knowledge of the following is recommended:

Sun Java Enterprise System
- Sun Java System Portal Server 7.1 software
- Sun Java System Portal Server SRA 7.1 software
- Sun Java System Identity Server 7 2005Q4 software
- Sun Java System Directory Server
Your Web Container
- Sun Java System Application Server
- Sun Java System Web Server
Programming and Markup Languages
- The Java Programming Language
- JavaScript^TM Programming Language
- Markup languages used to create portal content appropriate for users’ mobile and voice environments, such as Wireless Markup Language (WML), compact Hypertext Markup Language (cHTML), Handheld Device Markup Language (HDML), Extensible Hypertext Markup Language (XHTML), and Voice Extensible Markup Language (VoiceXML).
Other Technologies
- Java Server Pages^TM (JSP)
- Java Servlet Technology
- LDAP (Lightweight Directory Access Protocol)
Your Operating System
- Solaris^TM 8 Operating System or Solaris 9 Operating System
- Solaris Operating System (x86 Platform Edition)
  
  In addition, you should have knowledge of basic UNIX® administrative procedures and you should have knowledge of the applications provided to your users—for example, Sun Java System Calendar Server (formerly Sun ONE Calendar Server).

How This Book Is Organized

This book contains the following chapters:

Chapter 1, Chapter 1, Calendar Control Flow Reference Charts, lists the AML and WML-based JSP pages that comprise the mobile Calendar application.
Chapter 2, Chapter 2, Address Book Control Flow Reference Charts, lists the AML and WML-based JSP pages that comprise the mobile Address Book application.
Chapter 3, Chapter 3, Mail Control Flow Reference Charts, lists the AML and WML-based JSP pages that are included with the mobile Mail application.
Chapter 4, Chapter 4, Common Voice Prompts, lists commonly-used voice prompts that are not specific to any one particular application.
Chapter 5, Chapter 5, Authentication and Channel Chooser Voice Prompts, lists the authentication and channel chooser voice prompts that are provided in this release.
Chapter 6, Chapter 6, Notes, Personal Notes and Mail Provider Voice Prompts, lists the notes, personal notes, and multiple email provider prompts that are provided in this release.
Chapter 7, Chapter 7, Calendar Voicelet Prompts, lists the calendar voice prompts that are provided in this release.
Chapter 8, Chapter 8, Mail Voicelet Prompts, lists the mail voice prompts that are provided in this release.
Chapter 9, Chapter 9, Abstract Markup Language (AML) Elements, lists and describes the usage of AML elements.
Chapter 10, Chapter 10, Mobile Access Software Schema Reference, lists Mobile Access software schema definitions used by Identity Server software.

An index is also provided with this guide.

Conventions Used in This Guide

This guide uses certain 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. This font is also used for file names, distinguished names, functions, and examples.

Italicized Font

An italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). This font is used for server paths and names and account IDs.

Book Title	Description
Sun Java System Portal Server Mobile Access 7.1 Deployment Planning Guide	Describes how to plan for and deploy Sun Java System Portal Server Mobile Access 7.1 software.
Sun Java System Portal Server Mobile Access 7.1 Administration Guide	Describes how to administer Sun Java System Portal Server Mobile Access 7.1 using the administration console and the command line.
Sun Java System Portal Server 7.1 Release Notes	Available after the product is released. Contains last-minute information, including a description of what is new in this current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation.
Sun Java System Portal Server Mobile Access 7.1 Developer’s Guide	Describes a developer’s perspective of the mobile access software. It also provides information about three mobile applications that is shipped with the software: Calendar, Address Book, and Mail, all of which can be fully customized by developers.
Sun Java System Portal Server Mobile Access 7.1 Developer’s Reference Guide	This Guide. It provides reference to developer’s on how they can customize the three mobile application that is shipped along with the software: Calendar, Address Book, and Mail.
Sun Java System Portal Server Mobile Access 7.1 Tag Reference Library	Provides detailed information on the Java Enterprise System Portal Server Mobile Access tag libraries (in the software).

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

Download Center http://wwws.sun.com/software/download/
Professional Services http://www.sun.com/service/sunps/sunone/index.html
Sun Enterprise Services, Solaris Patches, and Support http://sunsolve.sun.com/
Developer Information http://developers.sun.com/prodtech/index.html

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.

Related Third-Party Web Site References

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:

http://www.sun.com/hwdocs/feedback

Please provide the full document title and part number in the appropriate fields. The part number of this guide is 820-1049.

Documentation, Support, and Training

The Sun web site provides information about the following additional resources:

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Table P–1 Typographic Conventions


Typeface	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories, and onscreen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`aabbcc123`	Placeholder: replace with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows the default UNIX system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–2 Shell Prompts


Shell	Prompt
C shell	`machine_name%`
C shell for superuser	`machine_name#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell for superuser	`#`