Skip Headers
Oracle® Fusion Middleware Portal Development Guide for Oracle WebLogic Portal
10
g
Release 3 (10.3.4)
Part Number E14243-06
Home
Contact Us
Next
View PDF
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
Part I Architecture
1
Introduction to Portals
1.1
What is a Portal?
1.2
What is the Portal Framework?
1.3
Portal Development and the Portal Life Cycle
1.3.1
Architecture
1.3.2
Development
1.3.3
Staging
1.3.4
Production
1.4
Getting Started
1.4.1
Prerequisites
1.4.2
Related Guides
2
Planning Your Portal
2.1
Production Operations (Propagation and Deployment)
2.2
Portal Development in a Distributed Portal Team
2.3
Federated Portals
2.4
Security
2.5
Content Management
2.6
Interaction Management
2.7
Performance
2.8
Portals and Mobile Devices
Part II Development
3
Understanding Portal Development
3.1
Portal Components
3.2
Portal Component Hierarchy
3.3
Portal Development Environment in Oracle Enterprise Pack for Eclipse
3.4
Web Application Frameworks
3.5
WebLogic Portal and Shared J2EE Libraries
3.6
File-Based Portals and Streaming Portals
3.7
Java Controls in Portals
3.8
JSP Tags in Portals
3.9
Asynchronous Rendering
3.10
Backing Files
3.10.1
How Backing Files are Executed
3.10.2
Thread Safety and Backing Files
3.10.3
Scoping and Backing Files
3.10.4
Using the Session to Pass Data Between Life Cycle Methods
3.10.5
Backing File Guidelines
3.10.5.1
Adding a Backing File Using Oracle Enterprise Pack for Eclipse
3.10.5.2
Adding the Backing File by Editing the XML File
3.11
HTTP Session Sharing
4
Setting up Your Portal Development Environment
4.1
Roadmap for Environment Setup Tasks
4.2
Portal Perspective
4.3
WebLogic Domain Configuration Wizard
4.4
Portal EAR Project Wizard
4.4.1
Select Project Facets Dialog
4.5
Add and Remove Projects Dialog
4.6
Portal Web Project Wizard
4.6.1
New Portal Web Project – Portal Web Project
4.6.2
New Portal Web Project – Select Project Facets dialog
4.6.3
New Portal Web Project - Web Module Dialog
4.6.4
New Portal Web Project - JSF Capabilities Dialog
4.6.5
New Portal Web Project - WebLogic Integrated Commons Logging Dialog
4.7
Portal Datasync Project Wizard
4.7.1
Create New Datasync Project – EAR Projects
4.8
Associating Web and Datasync Projects with EAR Projects
4.8.1
Associating an Web Project with an EAR Project
4.8.2
Associating an Datasync Project with an EAR Project
4.9
Using the Merged Projects View
4.9.1
Opening the Merged Projects View
4.9.2
Working with the Merged Projects View
4.10
Running a Project on the Server
4.11
Stopping the Server
4.12
Customizing a Perspective
4.13
Setting WebLogic Portal Preferences in Oracle Enterprise Pack for Eclipse
4.13.1
Preferences in the WebLogic Portal Section
4.13.2
WebLogic Portal Preferences in the General Section
4.14
Adding Apache Beehive Support
4.15
Adding Apache Struts Support
5
Integrating Existing Web Applications into WebLogic Portal
5.1
Apache Beehive and Apache Struts Supported Configurations
5.1.1
About Apache Beehive and Apache Struts
5.1.2
Supported Configurations for Apache Beehive
5.1.3
Supported Configurations for Apache Struts
5.1.4
Mixing Apache Struts 1.3 and Apache Beehive NetUI Applications
5.2
Importing Existing Struts Applications into WebLogic Portal
5.2.1
Struts-Enabling the Portal Application
5.2.2
Preparing Your Struts Application for Integration
5.2.2.1
Refactor
5.2.2.2
Add Tags if Needed
5.2.2.3
Override Certain Behaviors of a RequestProcessor
5.2.2.4
Refactor any Existing Custom Action Servlet
5.2.2.5
Remove the <html:link> Tag
5.2.3
Integration Steps
5.2.4
Best Practices and Development Issues
5.3
Integrating Existing Java Page Flow Applications into WebLogic Portal into WebLogic Portal
5.4
Integrating Existing Java Server Faces Applications into WebLogic Portal
5.4.1
JSF and the namingContainer JSP Tag
5.5
Adding Facets to an Existing Project
5.6
Other Methods of Integrating an External Web Application into a Portal
6
Integrating WebLogic Portal into Existing Web Applications
6.1
Introduction
6.2
Integrating WebLogic Portal into an Existing Web Application
7
User Interface Development with Look And Feel Features
7.1
Look And Feel Framework Overview
7.2
Working with Look And Feel Files
7.2.1
Introduction
7.2.2
Defining a Look And Feel for a Desktop
7.2.3
Adding Deprecated Look and Feel Components to a Web Project
7.2.3.1
Which Components are Deprecated?
7.2.3.2
What Changes Will I Notice?
7.2.3.3
Upgrading a WLP Application to Use Deprecated Components
7.3
Customizing Look and Feels
7.3.1
Combining Skins and Skeletons in a New Look And Feel
7.3.2
Defining Titlebar Buttons and Window Icons
7.3.3
Modifying CSS Files
7.3.4
Working with Genes and Chromosomes
7.3.4.1
Gene Example
7.3.4.2
Creating a Chromosome and Genes
7.3.4.3
Using the Look And Feel Editor with Genes
7.4
Creating a New Look and Feel
7.4.1
Working with Skins
7.4.1.1
Best Practices
7.4.1.2
Considerations for Microsoft Internet Explorer
7.4.1.3
About Portlet Title Bar Icons
7.4.2
Working with Skeletons
7.4.2.1
What is a Skeleton?
7.4.2.2
Guidelines for Creating Custom Skeletons
7.4.2.3
Enabling XHTML in a Portal
7.5
Working with Themes
7.5.1
Using Themes with Microsoft Internet Explorer
7.5.2
Developing a Theme
7.6
Using Look And Feels From Previous Portal Releases
7.7
Troubleshooting Look And Feels
7.8
The Look And Feel Editor
7.8.1
Overview
7.8.2
The Look and Feel Editor Window
7.8.3
Opening the Look And Feel Editor
7.8.4
Style Hierarchy Tab
7.8.5
Style Description Panel
7.8.5.1
CSS Inheritance
7.8.6
View Area
7.8.7
Outline View
7.8.8
Properties View
7.8.9
Tips for Using the Look and Feel Editor
7.8.9.1
Using the Link Style Hierarchy Selection with HTML Preview Selection Button
7.8.9.2
Enabling the Mouse Motion Button
7.9
Look And Feel API
7.10
Working with Shells
7.10.1
Creating a New Shell
7.10.2
Modifying a Shell
7.10.3
Applying a Shell to a Portal Desktop
7.10.4
Placing Portlets in a Header or Footer
7.11
Working with Layouts
7.11.1
Creating a Standard Layout
7.11.2
Creating a Custom Layout
7.11.2.1
The Layout File
7.11.2.2
Example of a Custom Layout
7.12
Working with Navigation Menus
7.12.1
Using Images for Page Tabs
7.13
Building User Interfaces to Address Accessibility Guidelines
7.13.1
Accessibility Checkpoints
7.13.2
W3C Web Content Accessibility Guidelines
7.13.3
Government Regulations and Standards
7.13.4
Accessibility Evaluation and Testing Tools
7.13.4.1
W3C Web Accessibility Initiative
7.13.4.2
Lynx Viewer
8
Developing Portals Using Oracle Enterprise Pack for Eclipse
8.1
Creating a Portal
8.1.1
Add a Page or Book to Your Portal
8.1.2
Creating a Standalone Book or Page
8.1.3
Extracting an Existing Page or Book to Re-Use
8.1.4
Adding a Book or Page Reference (Content)
8.1.4.1
Adding a Book or Page Reference from the Portal Editor
8.1.4.2
Adding a Book or Page Reference Using the Outline View
8.1.5
Rearranging Books and Pages
8.1.6
Adding Render Dependencies to Books and Pages
8.2
Setting Portal Component Properties
8.2.1
Editing Portal Properties
8.2.2
Tips for Using the Properties View
8.2.2.1
Presentation Properties
8.2.2.2
Desktop Properties
8.2.2.3
Book Properties
8.2.2.4
Page Properties
8.2.2.5
Placeholder Properties
8.3
Copying J2EE Library Files into a Project
8.3.1
Viewing Files that Override Shared J2EE Library Files
8.4
Custom Controls in Page Flows
8.4.1
Adding a Portal Control to a Page Flow
8.4.2
Adding an Action to the Page Flow
8.4.3
Portal Control Security
8.5
Deploy and View a Portal
8.6
Working with URLs
8.6.1
Creating URLs to Portal Resources
8.6.2
URL Compression
8.6.2.1
Implementing URL Compression
8.6.2.2
URL Compression Special Considerations
8.6.3
URL Troubleshooting
8.6.3.1
URL Templates and Web Services for Remote Portlets (WSRP)
8.6.4
Ampersand Entities in Portal URLs
8.6.5
Optional Look And Feel URL Templates
8.7
Working with Encoding in HTTP Responses
8.8
Cache Management in Oracle Enterprise Pack for Eclipse
8.8.1
Changing Cache Settings in Oracle Enterprise Pack for Eclipse
8.9
Cache Management With Oracle Coherence
8.9.1
Introduction
8.9.2
Installing and Configuring Coherence
8.9.3
Removing Deprecated and Obsolete Caches
8.10
Improving WebLogic Server Administration Console Performance on a Managed Server
8.11
Behavior of the "Return to Default Page" Attribute
8.12
Customizing Problem Validation Settings
8.12.1
Enabling/Disabling WebLogic Portal Validation
8.12.1.1
Enabling/Disabling Validation Globally
8.12.1.2
Enabling/Disabling Validation Per Project
8.12.2
Customizing WebLogic Portal Validation Mappings
8.12.2.1
Overview
8.12.2.2
Customizing Validation Globally
8.12.2.3
Customizing Validation Per Project
8.13
Enabling Placeable Movement
8.13.1
Configuring the Portal in Oracle Enterprise Pack for Eclipse
8.13.2
Setting Up a Desktop in the Administration Console
8.13.3
Testing Placeable Movement
8.13.4
Enabling Placeable Movement for an Existing Desktop
8.13.5
Limitations
8.14
Using Placeable Movement with Custom Layouts
8.14.1
Introduction
8.14.2
Rules for Using Placeable Movement with Custom Layouts
8.14.3
Sample Code
8.15
Localizing Titles for File-Based Books, Pages, and Portlets
9
Using the Dynamic Visitor Tools
9.1
What Is the DVT?
9.2
Configuring the DVT
9.2.1
Adding the Portal Dynamic Visitor Tools Facet to the Portal Web Project
9.2.2
Enabling the DVT
9.2.2.1
Enabling the DVT in a File-based Portal
9.2.2.2
Enabling the DVT for a Streaming Portal
9.2.3
Testing the DVT Configuration
9.3
Working with the DVT
9.3.1
Accessing Customization Options
9.3.2
Adding a Page Tab or Book of Tabs
9.3.3
Changing the Appearance of the Portal, Pages, Books, and Portlets
9.3.3.1
Changing the Appearance of the Portal
9.3.3.2
Changing the Appearance of Pages, Books, and Portlets
9.3.4
Changing the Menu of the Desktop or a Book
9.3.5
Restoring the Default View
9.3.6
Customizing the Desktop for All Desktop Users
9.3.7
Changing the Layout of a Page
9.3.8
Adding and Removing Content
9.3.9
Making Remote Portlets Available to Your Users
9.3.10
Implementing Custom Look and Feels for the DVT
9.3.10.1
Creating a Look and Feel Injector
9.3.10.2
Instantiating a Look and Feel Injector
9.4
Installing the Sample Login Shell
9.4.1
Summary of Steps
9.4.2
Installing the Portal Examples Component
9.4.3
Add the Sample Framework Components Facet
9.4.4
Adding the Sample Login Shell to a Portal Desktop
10
Advanced DVT Development
10.1
Localizing the DVT
10.1.1
Overview
10.1.2
Localizing the Out-Of-The-Box DVT
10.1.3
Localizing Custom Widgets
10.1.4
Extending _Localizable to Customize L10N Features
10.1.4.1
Customizing How L10N Modules Are Loaded
10.1.4.2
Customizing Message Aliases
10.1.4.3
Handling Parameterized Messages
10.2
Extending the DVT with Mixins
10.2.1
What are Extensions?
10.2.2
How Mixins are Implemented
10.2.3
Enabling Mixins
10.2.4
Mixin Examples
10.3
Using the Server Data Store
10.3.1
Server Data Store Features
10.3.2
Using Server Data Store: A Basic Example
10.3.3
The Server Data Store Constructor
10.3.4
Request Object Parameters
10.3.5
Server Data Store Examples
11
Enabling Visitor Tools
11.1
What Are Visitor Tools?
11.2
Enabling Visitor Tools
11.2.1
Verifying the Portal Visitor Tools Facet
11.2.2
Enabling Visitor Tools for a Desktop
12
Creating Portals for Multiple Device Types
12.1
Enabling Multichannel Features in a Portal Web Application
12.2
Roadmap for Multichannel Processing
12.3
Developing Portals for Use in a Multichannel Environment
12.3.1
Manage Portlet Client Classifications
12.3.2
Use the Client Attribute in JSP Tags
12.3.3
Develop Appropriate Look And Feels
12.3.4
Interaction Management Development
13
Designing Portals for Optimal Performance
13.1
Asynchronous Desktop Rendering
13.1.1
Choosing the Method of Asynchronous Rendering
13.1.2
Configuring Asynchronous Desktop Rendering
13.1.3
Programmatically Disabling Asynchronous Desktop Rendering
13.2
Control Tree Design
13.2.1
How the Control Tree Works
13.2.2
How the Control Tree Affects Performance
13.3
Using Multiple Desktops
13.3.1
Why This is a Good Idea
13.3.2
Design Decisions for Using Multiple Desktops
13.4
Optimizing the Control Tree
13.4.1
Enabling Control Tree Optimization
13.4.1.1
Setting the Current Page
13.4.2
How Tree Optimization Works
13.4.3
Multi Level Menus and Control Tree Optimization
13.4.4
Limitations to Using Tree Optimization
13.4.5
Disabling Tree Optimization
13.5
Other Ways to Improve Performance
13.5.1
Use Entitlements Judiciously
13.5.1.1
How Entitlements Affect Performance
13.5.1.2
Recommendations for Using Entitlements
13.5.2
Limit User Customizations
13.5.3
Optimize Page Flow Session Footprint
13.5.4
Use File-Based Portals for Simple Applications
13.5.4.1
Why Use a File-based Portal?
13.5.4.2
Limitations to Using File-based Portals
13.5.5
Create a Production Domain in Development
13.5.6
Optimize Portlet Performance
13.5.7
Use Oracle WebCenter Portal's Analytics to Track Usage
14
Obtaining Debug Information
14.1
Introduction
14.2
Configuring and Enabling Debug
14.2.1
Using Debug in Your WLP Code
14.2.2
Turning Debug Output On and Off
14.2.3
Package-Level Debugging
14.2.4
Directing Output to a File
14.2.5
Reloading Debug Properties
14.2.6
Example debug.properties File
14.3
Public WLP Class Debug Reference
14.3.1
WLP Framework Classes with Debug Support
14.3.2
WLP Core Services Classes with Debug Support
14.3.3
WLP Virtual Content Repository Classes with Debug Support
14.3.4
WLP Oracle WebCenter Content Classes with Debug Support
14.3.5
WLP Administration Console Classes with Debug Support
Part III Staging
15
Managing Portal Desktops
15.1
Administration Console Overview
15.2
Administration Console Library of Resources
15.3
Starting and Logging In to the Administration Console
15.3.1
Opening the Administration Console
15.3.2
Logging In to the Administration Console
15.4
Overview of Library Administration
15.5
Overview of Portal Administration
15.6
Portal Management
15.7
Overview of the Library
15.8
Desktop Templates
15.8.1
Creating a Desktop Template
15.8.2
Modifying Desktop Template Properties
15.9
Communities
15.10
Portal Resources
15.10.1
Updating Portal Resources
15.10.2
Viewing Resources for a Portal Web Application (Update WebApp)
15.10.3
Deleting a Portal Resource
15.10.4
Localizing a Portal Resource
15.11
Portals
15.11.1
Creating a Portal
15.11.2
Modifying Portal Properties
15.12
Desktops
15.12.1
Creating a Desktop
15.12.1.1
Disassembling to the Library
15.12.1.2
Decoupling of Property Settings
15.12.2
Modifying Desktop Properties
15.13
Books
15.13.1
Creating a Book
15.13.2
Managing Book Content
15.13.2.1
Adding Portal Elements to a Book
15.13.2.2
Positioning or Removing Portal Elements on a Book
15.13.3
Modifying Library Book Properties and Contents
15.13.4
Modifying Desktop Book Properties
15.14
Pages
15.14.1
Creating a New Page
15.14.2
Managing Page Content
15.14.2.1
Adding Contents to a Page
15.14.2.2
Positioning Elements on a Page
15.14.3
Modifying Library Page Properties
15.14.4
Modifying Desktop Page Properties
15.14.5
Moving a Page or Book to Another Location on the Desktop
15.15
Portlets
15.15.1
Copying a Portlet in the Library
15.15.2
Deleting a Portlet
15.15.3
Modifying Library Portlet Properties
15.15.4
Modifying Desktop Portlet Properties
15.16
Portlet Preferences
15.16.1
Creating a Portlet Preference
15.16.2
Editing a Portlet Preference
15.17
Portlet Categories
15.17.1
Creating a Portlet Category
15.17.2
Adding Portlets to a Portlet Category
15.17.3
Modifying Portlet Category Properties
15.18
Look And Feels
15.18.1
Modifying Look And Feel Properties
15.19
Shells
15.19.1
Modifying Shell Properties
15.20
Themes
15.20.1
Modifying Theme Properties
15.21
Menus (Navigation)
15.21.1
Modifying Menu Properties
15.22
Layouts
15.22.1
Modifying Layout Properties
16
Deploying Portals to Production
16.1
Shared J2EE Libraries
16.1.1
Shared J2EE Library References in config.xml
16.1.1.1
Anatomy of a Shared J2EE Library
16.1.2
Overriding Shared J2EE Library Settings in the web.xml File
16.1.2.1
Servlet Mapping Overrides
Part IV Production
17
Managing Portals in Production
17.1
Pushing Changes from the Library into Production
17.2
Transferring Changes from Production Back to Development
A
Facet-to-Library Reference Tables
A.1
WebLogic Portal EAR Project Facets
A.2
WebLogic Portal Web Project Facets