Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Introduction

What is Oracle Portal-to-Go?

User's View

How Portal-to-Go Works

Portal-to-Go Content Sources

Portal-to-Go Target Formats

Adding Adapters and Transformers

2 Portal-to-Go Architecture

Overview

Portal-to-Go Repository

Configuring Portal-to-Go

System Properties

Error Logging

Development Client Logging

Server Logging

Transaction Logging

3 Portal-to-Go Tools

Overview

Development Tools

Service Designer

Starting the Service Designer

In-Process Connection

RMI Connection

Creating Objects

Modifying Objects

Deleting Objects

Flagged Objects

Finding Users

Refreshing the Repository View

Object Identifiers

Web Integration Developer

XML Editor

Oracle XML Parser

Portal-to-Go Server Utilities

LoadXml

Xslt

CopyObjects

ResetPassword

4 Walkthroughs

Purpose

Before You Begin

Creating a Web Service

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

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

Task 3: Starting the Portal-to-Go Service Designer

Task 4: Creating the Master Service

Task 5: Creating an Alias that Points to the Master Service

Task 6: Creating a User Group and a User

Task 7: Making the Service Available to a Group

Task 8: Testing the Service

Accessing the Personalization Portal

Testing the Service on a Phone Simulator

Creating a SQL Service

Creating Chained Services

Task 1: Creating the First Service in the Chain

Generate the WIDL File and Edit the Input Binding

Edit the Output Binding of the WIDL File

Task 2: Creating the Second Service in the Chain

Open the Source Page for the Second Service

Generate the WIDL for the Second Service

Edit the Input and Output Binding of the WIDL File

Edit the URL of the Second Service

Publish the Service

Add the Service to Portal to Go

Create the Master Service

Create the Result Transformer

Create a User and an Alias and Test the Service

5 Portal-to-Go Services

Overview

Master Services

Creating a Master Service

Modifying a Master Service

General Panel

Init Parameters Panel

Web Integration Init Parameters

SQL Adapter Init Parameters

Stripper Adapter Init Parameters

URL Adapter Init Parameters

Servlet Adapter Init Parameters

Input Parameters Panel

Web Integration Input Parameters

SQL Master Service Input Parameters

Stripper Adapter Input Parameters

URL Adapter Input Parameters

Servlet Adapter Input Parameters

Output Parameters Panel

Result Transformer Panel

Device Transformer Panel

Deleting a Master Service

Creating a Service Using the Servlet Adapter

Service Trees

Creating a Folder

Creating a Service Alias

Creating a Bookmark

6 Managing Users and Groups

User Roles

Portal-to-Go Users

Creating Users

Adding Agent Information to a User

Deleting Users

Modifying Users

User Groups

Creating User Groups

Deleting Groups

Adding Users to a Group

Adding Services to a Group

Removing Users from a Group

Removing Services from a Group

Changing a User's Group

Integrating Users with Existing Provisioning Systems

ProvisioningHook Interface

UserAuthenticationHook Interface

7 Rebranding the Personalization Portal

Overview

Use Sequence

Directory Structure

Login Sequence

Main Page Components

Customization Components

Customizing Services

Customizing Folders

Configuring Jobs

Configuring the User Profile

Changing Password

Configuring Agents

Debug Messages

National Language Support

Overview

Multibyte Encoding Schemes

Fixed-width Encoding Schemes

Variable-width Encoding Schemes

Setting the Multi-Byte Encoding for the Personalization Portal

Localization

Service Designer

Personalization Portal

8 Working with Portal-to-Go XML

Why XML?

Oracle XML Parser

Portal-to-Go XML Formats

Adapter Result Format

Simple Result Format

Content Model

Element Reference

SimpleResult Element

SimpleContainer Element

SimpleText Element

SimpleTextItem Element

SimpleMenu Element

SimpleMenuItem Element

SimpleForm Element

SimpleFormItem Element

SimpleFormSelect Element

SimpleFormOption Element

SimpleTable Element

SimpleTableHeader Element

SimpleTableBody Element

SimpleRow Element

SimpleCol Element

SimpleImage Element

SimpleBreak Element

SimplePhone Element

SimpleEmail Element

SimpleHref Element

The Portal-to-Go Repository

Provisioning DTD

PanamaObjects Element

PUSR_LIST Element

PUSR Element

Repository XML Reference

PanamaObjects Element

PGRP_LIST Element

PGRP Element

PUSR_LIST Element

PUSR Element

TRAN_LIST Element

XTRA Element

EXT_ATTR Element

JTRA Element

LDEV_LIST Element

LDEV Element

ADAP_LIST Element

ADAP Element

PSRV_LIST Element

FOLD Element

LINK Element

MAST Element

BOMA Element

AGEN_LIST Element

AGEN Element

XML Tools

XML Editor

Requirements

Synopsis

Using the XML Editor

LoadXml

Synopsis

Options

Unload Example

Upload Example

Upload and Download Utilities

9 Adapters

What Is a Portal-to-Go Adapter?

Using Portal-to-Go Adapters

Implementing Portal-to-Go Adapters

Content Formats

Creating Adapters

Adapter Definition

Sample Adapter Class

init()

invoke()

getInitDefinition()

getAdapterDefinition()

Managing Arguments

Filtering Adapter Output

Filtering Adapter Output Sample Code

Importing an Adapter into the Repository

Deleting an Adapter

Modifying Adapters

Extending the Stripper Adapter

Naming the Strip Level Class

Required Methods in the Strip Level Class

Installing the Strip Level Class

10 Transformers

What is a Portal-to-Go Transformer?

Transformers Provided by Portal-to-Go

Creating Transformers

Java Transformers

Sample Java Device Transformer

SimpleResultToText()

format()

transform()

XSLT Stylesheets

Sample XSLT Device Transformer

Sample XSLT Result Transformer

Testing the Transformer

Managing Transformers with the Service Designer

Creating a Transformer in the Repository

Modifying a Transformer

Removing a Transformer from the Repository

11 Logical Devices

Overview

Creating a Logical Device

Modifying a Logical Device

Deleting a Logical Device

Determining the Client Device Type

12 Integrating Portal-to-Go

Asynchronous Notifications

Request Queue

Notification Queue

Notification Engine

SMS Listener

Probe Runtime Monitor and Management

RMI Server

FTP Server

13 Portal-to-Go Extensibility

Overview

Daemons

Notification Listeners

Log Listeners

Hooks

Extending the Core Components

A Simple Result DTD Notes

SimpleResult

SimpleContainer

SimpleText

SimpleTextItem

SimpleMenu

SimpleMenuItem

SimpleForm

SimpleFormItem

SimpleFormSelect

SimpleFormOption

SimpleTable

SimpleTableHeader

SimpleTableBody

SimpleRow

SimpleCol

SimpleImage

SimpleBreak

SimplePhone

SimpleEmail

SimpleHref

SimpleHelp

Glossary

Index