Contents

Title and Copyright Information

List of Figures

List of Tables

Send Us Your Comments

Preface

1 Introduction

1.1 New Features

1.2 What is the Wireless Edition?

1.2.1 Form Factor Considerations

1.2.2 User's View

1.3 How Wireless Edition Works

1.3.1 Alerts

1.4 Location-Based Services

1.5 Wireless Edition Architecture

1.5.1 Content Acquisition

1.5.1.1 Adapters

1.5.1.2 Services and Master Services

1.5.1.3 Service Manager

1.5.2 Content Delivery

1.5.3 Core Processing

1.5.3.1 Service Designer

1.5.3.2 Personalization Portal

1.6 Extensibility: Adding Adapters and Transformers

2 Wireless Edition Tools

2.1 Overview

2.2 Development Tools

2.2.1 Service Designer

2.2.1.1 Master Service Creation Wizard

2.2.2 The Transformer Testing Tool

2.2.3 Region Modeling Tool

2.2.4 The Web Integration Developer

2.2.5 XML Editor

2.2.6 Oracle XML Parser

2.3 Personalization

2.3.1 Personalization from Desktop

2.3.2 Personalization from Device

2.4 Oracle Performance Manager

2.4.1 Accessing the Oracle Performance Manager

2.4.2 Logging into the Oracle Performance Manager

2.4.3 Performance Data Collection Schema

2.4.3.1 PTG_SERVICE_LOG

2.4.3.2 PTG_SESSION_LOG

2.4.3.3 SERVICE_REQUEST_STATS

2.4.3.4 SERVICE_ERROR_STATS

2.4.4 Performance Statistics

2.4.4.1 Session Duration Statistics

2.4.4.2 Session Error Statistics

2.4.4.3 Session Service Statistics

2.4.4.4 Service Error Statistics

2.4.4.5 User Service Statistics

2.4.4.6 Service Invocation Statistics

2.4.4.7 Service Response Time Statistics

2.4.5 Fault Management

2.4.6 Configuration Management

3 Wireless Edition Services

3.1 Overview

3.2 Using the Service Designer

3.2.1 Starting the Service Designer

3.2.1.1 RMI Connection

3.2.2 Creating Objects

3.2.3 Modifying Objects

3.2.4 Deleting Objects

3.2.5 Flagged Objects

3.2.6 Refreshing the Repository View

3.2.7 Object Identifiers

3.3 Creating a Master Service

3.3.1 Step 1: Selecting or Creating a Service Folder

3.3.2 Step 2: Setting the Master Service Properties

3.3.3 Step 3: Selecting an Adapter

3.3.4 Step 4: Setting the Init Parameters

3.3.5 Step 5: Setting the Input Parameters

3.3.6 Step 6: Setting the Output Parameters

3.3.7 Step 7: Creating the Result Transformer (Optional)

3.3.8 Step 8: Setting the Device Transformer (Optional)

3.4 Creating a Location-Based Service

3.4.1 Using the Service Designer to Create Location-Based Services

3.4.2 Using the Master Service Creation Wizard to Create Location-Based Services

3.5 Modifying a Master Service

3.5.1 General Panel

3.5.2 Init Parameters Panel

3.5.2.1 Web Integration Init Parameters

3.5.2.2 SQL Adapter Init Parameters

3.5.2.3 URL Adapter Init Parameters

3.5.2.4 Servlet Adapter Init Parameters

3.5.2.5 Mail Adapter Init Parameters

3.5.2.6 Directory Adapter Init Parameters

3.5.3 Input Parameters Panel

3.5.3.1 Web Integration Input Parameters

3.5.3.2 Mail Adapter Input Parameters

3.5.3.3 SQL Master Service Input Parameters

3.5.3.4 Stripper Adapter Input Parameters

3.5.3.5 URL Adapter Input Parameters

3.5.3.6 Servlet Adapter Input Parameters

3.5.4 Output Parameters Panel

3.5.5 Result Transformer Panel

3.5.6 Device Transformer Panel

3.6 Deleting a Master Service

3.7 Creating a Folder

3.8 Deleting a Folder

3.8.1 Service Trees

3.9 Creating a Service Alias

4 Using the Region Modeling Tool

4.1 Overview

4.1.1 The System-Defined Region Hierarchy

4.1.2 User-Defined Regions

4.2 Accessing the Region Modeling Tool

4.3 Managing Spatial Objects

4.3.1 Accessing the Region Modeling Tool in the Standalone Mode

4.3.2 Creating User-Defined Regions

4.3.2.1 Creating a User-Defined Region from the SDR Hierarchy

4.3.2.2 Creating a UDR from an Address

4.3.3 Deleting a User-Defined Region

4.3.4 Creating a Folder

4.3.5 Deleting a Folder

4.3.6 Creating System-Defined Regions

4.3.6.1 Loading SDR Data Using SQL*Plus

4.3.6.2 Loading SDRs from the Region Modeling Tool

4.3.6.2.1 Adding Data Under a Continent

4.3.6.2.2 Adding Data Under a Country

4.3.6.2.3 Adding State Data Under a Country

4.3.6.2.4 Adding Data for the Postal Code, County, or City

4.3.7 Deleting a System-Defined Region

4.4 Creating Location-Based Master Services and Folders

4.4.1 Accessing the Region Modeling Tool in the Browse Mode

4.4.1.1 Modifying a Folder or Service to be Location-Based

4.4.1.2 Using the Service Designer to Create a Location-Based Folder or Service

4.4.1.3 Using the Master Service Creation Wizard to Create a Location-Based Service or Folder

4.5 Creating Location-Based Services with Location-Specific Content

4.5.1 Accessing the Current Subscriber's Location Using the Runtime API

4.5.2 Accessing the Current Subscriber's Location Using Derived Location-Related System Parameters

5 Managing Users and Groups

5.1 Overview

5.2 Managing Groups Using the Service Designer

5.2.1 Creating User Groups Using the Service Designer

5.2.2 Deleting Groups Using the Service Designer

5.2.3 Adding Users to a Group Using the Service Designer

5.2.4 Adding Services to a Group Using the Service Designer

5.2.5 Removing Users from a Group Using the Service Designer

5.2.6 Removing Services from a Group Using the Service Designer

5.3 Managing Groups and Users Using the Personalization Portal

5.3.1 Accessing the Personalization Portal

5.3.2 Logging in as an Administrator

5.3.3 Using the Administration Tab

5.3.3.1 Finding Users

5.3.3.2 Creating Users

5.3.3.3 Editing User Properties

5.3.3.4 Assigning a User to a Group

5.3.4 Managing Groups Using the Personalization Portal

5.3.4.1 Creating a Group Using the Personalization Portal

5.3.4.2 Managing Groups

5.3.4.3 Deleting a Group

5.3.4.4 Adding Users to a Group

5.3.4.5 Assigning Services to a Group

5.4 Integrating Users with Existing Provisioning Systems

5.4.1 ProvisioningHook Interface

5.4.2 UserAuthenticationHook Interface

6 Personalization from Desktops

6.1 Overview

6.2 Logging in to Personalize the Portal

6.3 Logging In as a User

6.4 Activating a Service for a User

6.4.1 Copying or Editing a Service

6.4.1.1 Configuring Input Arguments and Conditions

6.5 Editing a Folder

6.5.1 Reordering Folder Contents

6.6 Creating a Subfolder

6.6.1 Moving Objects Between Folders

6.7 Creating a Bookmark

6.8 Creating Alerts

6.8.1 Setting Alert Parameters

6.8.1.1 The Alert Sent Every Settings

6.8.1.2 The Alert Start Time settings

6.8.2 Editing Alert Parameters

6.9 Managing Alert Addresses

6.9.1 Creating a New Alert Address

6.10 Creating a LocationMark

6.11 Editing a LocationMark

6.12 Changing the Default Status of a LocationMark

6.13 Deleting a LocationMark

6.14 Editing a User Profile

7 Personalization from a Device

7.1 Overview

7.2 Device Personalization

7.2.1 Navigation and Data Entry

7.3 Logging in to the Portal

7.4 Creating a Folder

7.5 Creating a Bookmark

7.6 Reordering Objects

7.7 Renaming a Folder

7.8 Showing or Hiding Objects

7.9 Deleting a Folder

7.10 Editing a User Profile

7.10.1 Change Password

7.10.2 Assigning an Alert Address

7.10.3 Activating Autolocate

7.11 Creating a LocationMark

7.12 Logging Off

8 Logical Devices

8.1 Overview

8.2 Creating a Logical Device

8.3 Modifying a Logical Device

8.4 Deleting a Logical Device

8.5 Determining the Client Device Type

9 Walkthroughs

9.1 Purpose

9.2 Before You Begin

9.2.1 Creating a User Group and a User

9.3 Creating a SQL Service

9.3.1 Task 1: Using the Master Service Creation Wizard

9.3.2 Task 3: Creating an Alias that Points to SQL Time

9.3.3 Task 4: Making SQL Time Available to a Group

9.3.4 Task 5: Testing SQL Time

9.4 Creating a PL/SQL Service

9.4.1 Task 1: Loading the PL/SQL Package, demo_proc.sql

9.4.1.1 Sample Code Explanation

9.4.2 Task 2: Creating the Master Service

9.4.3 Task 3: Creating an Alias that Points to PLSQL Test

9.4.4 Task 4: Making PLSQL Test Available to a Group

9.4.5 Task 5: Testing PLSQL Test

9.5 Creating a Master Service Using the URL Adapter

9.5.1 Task 1: Building the Java Program

9.5.1.1 Java Example Overview

9.5.1.2 Running the Java Example

9.5.2 Task 2: Creating the Master Service

9.5.3 Task 3: Creating an Alias that Points to URL Adapter

9.5.4 Task 4: Making URL Example Available to a Group

9.5.5 Task 5: Testing URL Example

9.6 Creating Location-Based Services

9.6.1 Task 1: Creating the Location-Dependent Master Service

9.6.2 Task 2: Creating an Alias that Points to Geocoder

9.6.3 Task 3: Making Geocoder Available to a Group

9.6.4 Task 4: Testing the Geocoder

9.7 Creating the Spatial Adapters

9.8 Creating a Master Service Using the Web Integration Adapter

9.8.1 Task 1: Creating the WIDL File in the Web Integration Developer

9.8.2 Task 2: Publishing the WIDL Interface to the Web Integration Server

9.8.3 Task 3: Using the Service Designer

9.8.4 Task 4: Creating the Master Service

9.8.5 Task 5: Creating an Alias that Points to Stock Quotes

9.8.6 Task 6: Making Stock Quotes Available to a Group

9.8.7 Task 7: Testing Stock Quotes

9.9 Creating Chained Services Using the Web Integration Developer

9.9.1 Task 1: Creating the First Service in the Chain

9.9.2 Task 2: Creating the Second Service in the Chain

9.9.3 Adding the Service to the Wireless Edition Repository

9.9.4 Creating a User and an Alias and Test the Service

9.10 Creating External Links Using the Service Designer

A The Mail Adapter

A.1 Overview

A.1.1 Message Management Functions

A.1.2 Folders Management Functions

A.2 The End User Interface

A.3 Configuration Parameters for the Mail Adapter

Glossary

Index