MobileAware Interaction Server User Guide

MobileAware Interaction Server User Guide

About This Manual

Prerequisites

Terminology Used in this Manual

Content Examples

Further Reading

Documentation Roadmap

Where do I start?

What manuals are provided?

Is there a demonstration Workshop mobility project?

What authoring tools do I need?

What format do I use for marking up content?

How do I change the appearance of web content for mobile devices?

Where can I find more information on delivering images and other media to mobile devices?

How do I tailor content for different devices?

How can I create dynamic content that accommodates device characteristics?

How do I brand or use logos on my device?

How do I troubleshoot the output from the MobileAware Interaction Server?

How can I modify the basic start-up parameters for the MobileAware Interaction Server?

How do I take advantage of access keys on WML devices?

How do I find out more about working with tables?

The Mobility Extension for BEA Workshop

Summary of the Mobility Extension Features

Enable Multi-Channel

Mobility Palette

Mobility Toolbar

IDE Properties additions

Mobility Menu

Fundamentals of Mobile Content

Overview of the Process

Three Steps to Creating and Delivering your Service

Introducing the Mobility Tags

The History of XHTML

Extending XHTML with the Mobility Tags

The Mobility Tags

The mmXHTML Document Type Definition (DTD)

The MobileAware Interaction Server JSP Tag Library

Enhanced Performance

Syntax

Examples

Mixing mm-tags and mm:tags

Exception Handling and Diagnostics

Optimizing Performance with the JSP Tag Library

MobileAware Interaction Server Transformation Steps

Optimizing Full Browser Performance

Skipping Multi-Mode Tag Checking

Skipping Multi-Mode Tag Checking for Specific Files in an Application

Flagging a Page for Optimisation

Skipping Device Recognition

Delivering a Web Application Without a MobileAware Interaction Server License or Filter

Working with XHTML

Syntax Rules

Document Rules

Automating HTML to XHTML Mark-up

Enabling Less Strict Document Checking

Organizing Content

Introducing Groups

Creating Explicit Groups

Examples: mm-group

Creating Sub-Groups

Working with Implicit Groups

Targeting Content for Specific Devices

Referencing Groups

Creating Conditional Content

Creation of Conditional Content

The "where" Attribute

Proper `where' Usage

Invalid Expressions

Using `where' with Request Headers

Examples of `where' Usage

Presentation Of Mobile Content

Organising Content for Handheld Devices

Arranging and Styling Content

Restyling for PDAs

Restyling for Menu-Driven Devices

Navigational Menu Styling

Styling Navigational Menus Using Multi-Column Tables

Styling Navigational Menus Using Lists

Styling Navigational Menus Using Images

Styling Navigation Text and Images

Menu Design Tips

More Navigation Lists for Handheld Devices

Working with Style Sheets

Introduction to Style Sheets

Understanding Cascading Style Sheets

Rules In CSS

Linking Style Sheets

Server Side Application of CSS for PDAs

Using Multiple Device-Specific Style Sheets

Using the Default Style Sheet

MobileAware Interaction Server CSS Support

Styles Available in HTML 3.2

Defining Colors in HTML 3.2

Managing Navigation

Pagination

Automatic Pagination

Author-Controlled Pagination

Controls Applied to Multiple Elements

Making Your Site Easy to Navigate

Back to Top

Working with Tables

The Problem with Tables

The <mm:table-model> Tag

Understanding the Table-Model Attributes

Tables and Style Sheets

Working with Images

About Images

Using <mm-img>

Using <mm-media-group>

Displaying a Logo on a WML Device

Working with Character Sets

About Character Encoding/Decoding

Encoding Mechanisms

How Content Gets Encoded

JSP Files and Servlets

How the MobileAware Interaction Server Determines Character Encoding

Influencing the Character Encoding Delivered to the Device

Fine-Tuning Mobile Content

Horizontal Rule

Textarea

Configuring URL Compression

Mode Support

Conditional Content

Access Key Support

Emoji Characters

iMode-Specific Styles

Phone Number Dialing and CTI

The Delivery Context API

Overview of the CC/PP Delivery Context API

About the Device Database

Device Profiles

Accessing CC/PP Device Profile Information

Delivery Context Example

Results

Example Breakdown

Additional Information

Diagnostics

Working with Diagnostics

Diagnostic Tools

Ensure Diagnostics is Installed in Your Web Application

Starting the Diagnostic Console

Starting the Diagnostic Command Line

Using the Diagnostic Console

Configuring the Diagnostics Console

Simulating HTTP Requests

Using the Response View

Interception: Using the Diagnostics Console as a Proxy

Using the Diagnostic CLI

Using the Diagnostic CLI with WebLogic

Starting the Diagnostics CLI

Getting Help

Specifying the Connection

Using Parameter Files

Filtering Content

Specifying Diagnostic Messages

Example Usage

Diagnosing Problems

Identifying the Source of a Problem

Identifying Connection Problems

Resolving MobileAware Interaction Server Error Pages

Device-Specific Errors

Monitoring Diagnostic Output

About Diagnostic Topics

Monitoring Client Transactions

Monitoring Database Transactions

Monitoring Devices

Monitoring Web Application Transactions

Monitoring Transformation

Monitoring Browser Activity

Monitoring Flow of Control

Monitoring the Mobility Filter

Monitoring Response Received

Monitoring the JSP Tag Library

Exception Handling

Development Mode

Production Mode

Glossary

Appendix A - Mobility Tag Reference

meta, mm:meta

DESCRIPTION

USAGE A: To create a link on an Options menu

ATTRIBUTES

EXAMPLE

USAGE B: TO GIVE PAGE-WIDE SETTINGS TO CDATA ELEMENTS

ATTRIBUTES

EXAMPLE USING THE JSP TAGLIB

EXAMPLE USING mmXHTML

SEE ALSO

mm-body, mm:body

DESCRIPTION

ATTRIBUTES

COMMENTS

EXAMPLE

SEE ALSO

<![CDATA[...]]> / mm:cdata

DESCRIPTION

SEE ALSO

mm-exclude, mm:exclude

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-group-ref, mm:group-ref

DESCRIPTION

ATTRIBUTES

SEE ALSO

mm-head, mm:head

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-id-ref, mm:id-ref

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-img, mm:img

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-include, mm:include

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-layout, mm:layout

DESCRIPTION

ATTRIBUTES

SEE ALSO

mm-li, mm:li

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-logo, mm:logo

DESCRIPTION

ATTRIBUTES

EXAMPLE 1

EXAMPLE 2

SEE ALSO

mm-media-group, mm:media-group

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-nl, mm:nl

DESCRIPTION

ATTRIBUTES

SEE ALSO

mm:page

DESCRIPTION

ATTRIBUTES

EXAMPLE

mm-phone-number, mm:phone-number

DESCRIPTION

EXAMPLE

mm-structure, mm:structure

DESCRIPTION

ATTRIBUTES

EXAMPLE

SEE ALSO

mm-table-model, mm:table-model

DESCRIPTION

ATTRIBUTES

EXAMPLE

Appendix B - MobileAware Delivery Context API

Introduction

Requesting the Delivery Context for an Active HTTP Session

Requesting Out-of-Session Delivery Contexts

Establishing the Delivery Context Store

Methods for Retrieving Delivery Contexts

Available Public Methods

Public Methods

Handling Exceptions

DeliveryContextRuntimeException

InvalidAttributeTypeException

NoSuchAttributeException

AttributeValueUndefinedException

Appendix C - Deprecated Items

Appendix D - FAQ

Question 1

Solution

Question 2

Solution

Question 3

Solution

Question 4

Solution

Question 5

Solution

Question 6

Solution

Question 7

Solution

Question 8

Solution

Question 9

Solution

Question 10

Solution

Question 11

Solution

Question 12

Solution

Question 13

Solution