Skip Headers
Oracle® WebCenter Framework Developer's Guide
10
g
(10.1.3.2.0)
Part Number B31074-05
Home
Book List
Index
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 Introduction to Oracle WebCenter Suite
1
Understanding Oracle WebCenter Suite
1.1
What is Oracle WebCenter Suite?
1.1.1
Oracle WebCenter Framework
1.1.1.1
Building and Consuming Portlets
1.1.1.2
Customizable Components
1.1.1.3
Content Integration
1.1.1.4
Securing Your Application
1.1.1.5
Managing Your Application Throughout the Life Cycle
1.1.2
Oracle WebCenter Services
1.1.3
Oracle JDeveloper
1.2
What Will You Learn in This Developer's Guide?
2
Planning Your WebCenter Application
2.1
Introduction to WebCenter Applications
2.1.1
About Customizable Pages
2.1.2
About Customizable Components
2.1.3
About Portlets
2.1.4
About Content (Through JCR Data Controls)
2.1.5
About Skins
2.1.6
About Security
2.1.7
About Life Cycle
2.2
Design Questions to Consider Before You Start
2.3
Using the Service Request Demo
2.3.1
Introduction to the Oracle ADF Service Request Demo
2.3.2
Setting Up the Oracle ADF Service Request Demo
Part II Building a WebCenter Application
3
Preparing Your Development Environment
3.1
Creating a WebCenter Application
3.1.1
Creating a WebCenter Application Using a Template
3.1.2
What Happens When You Use the WebCenter Application Template
3.1.2.1
Template Projects, Technology Scopes, and Libraries
3.1.2.2
WebCenter Application Template Default Files and Folders
3.1.3
Manually Creating a WebCenter Application and Projects
3.1.3.1
Manually Creating a WebCenter Application
3.1.3.2
Manually Creating WebCenter Application Projects
3.1.4
Importing a WAR File to Create a WebCenter Application Project
3.2
Using the Preconfigured OC4J
3.2.1
What You Should Know About the Preconfigured OC4J
3.2.2
Starting and Stopping the Preconfigured OC4J
3.2.3
The Preconfigured OC4J Readme File
3.2.4
What You Should Know About Preconfigured Portlet Producers
3.2.4.1
Preconfigured OC4J Portlet Producers and Portlets
3.2.4.2
The PDK-Java Sample Portlet Producer and Portlets
3.2.4.3
The WSRP Sample Portlet Producers and Portlets
3.3
Enabling Oracle SOA Suite or a Standalone OC4J for WebCenter Applications
4
Populating Pages
4.1
Introduction to Page Content
4.1.1
Portlet Overview
4.1.2
Customizable Components Overview
4.1.2.1
Defining Appearance and Customization Characteristics
4.1.2.2
Nesting Customizable Components
4.1.3
JCR Data Control Overview
4.2
Building WebCenter Application-Enabled Pages in Oracle JDeveloper with Oracle ADF
4.3
Consuming Portlets
4.3.1
Registering Portlet Producers
4.3.1.1
Registering WSRP Portlet Producers
4.3.1.2
Registering PDK-Java Portlet Producers
4.3.1.3
Editing Portlet Producer Registration Settings
4.3.1.4
Testing a Portlet Producer Connection
4.3.1.5
Refreshing a Portlet Producer
4.3.1.6
Deregistering a Portlet Producer
4.3.2
Adding Portlets to a Page
4.3.3
Setting Attribute Values for the adfp:portlet Tag
4.3.3.1
General Attributes of the adfp:portlet Tag
4.3.3.2
Actions Attributes of the adfp:portlet Tag
4.3.3.3
What You Should Know About Maximize, Minimize, Restore, and Move
4.3.3.4
Core Attributes of the adfp:portlet Tag
4.3.3.5
Display Mode Attributes of the adfp:portlet Tag
4.3.3.6
iframes and form Tags
4.3.4
Copying Portlets
4.3.4.1
Copying and Placing a Portlet on the Same Page
4.3.4.2
Copying Portlets from One Application Page to Another
4.3.5
Deleting Portlets from Application Pages
4.4
Using Customizable Components
4.4.1
Adding Customizable Components
4.4.1.1
Adding a PanelCustomizable Component
4.4.1.2
Adding a ShowDetailFrame Component
4.4.1.3
Adding ShowDetailFrame Facets
4.4.2
Dragging and Dropping Components onto a Page
4.4.3
Changing the Look and Feel of Customizable Components
4.4.4
Implementing Security for Customizable Components
4.5
Contextually Linking Components
4.5.1
Linking Portlets to Pages
4.5.2
Linking Portlets
4.5.3
Linking Faces Component to Portlets
5
Integrating Content
5.1
Introduction to Content Integration Capabilities of Oracle WebCenter Suite
5.2
Configuring Content Data Controls for JCR Adapters
5.2.1
Understanding Content Data Controls
5.2.2
Configuring a Content Data Control Based on the File System Adapter
5.2.3
Configuring a Content Data Control Based on the OracleAS Portal Adapter
5.2.3.1
What You Should Know About OracleAS Portal
5.2.3.2
Creating a Content Data Control Based on the OracleAS Portal Adapter
5.2.4
Configuring a Content Data Control Based on the Oracle Content DB Adapter
5.2.4.1
Configuring Keystores and Keys to Enable WS-Security
5.2.4.2
Creating a Content Data Control Based on the Oracle Content DB Adapter
5.2.4.3
Enabling Cleartext Authentication Over HTTP (Optional)
5.2.4.4
Configuring SSL (Optional)
5.2.5
Configuring a Content Data Control Based on Oracle Content DB Version 10.2
5.2.5.1
Creating a Content Data Control Based on Oracle Content DB
5.2.5.2
Enabling Cleartext Authentication Over HTTP (Optional)
5.2.5.3
Configuring SSL (Optional)
5.2.6
Configuring a Content Data Control Based on Oracle WebCenter Adapter for IBM Lotus Domino
5.2.6.1
Overview of the Oracle WebCenter Adapter for IBM Lotus Domino
5.2.6.2
Platform Requirements for Oracle WebCenter Adapter for IBM Lotus Domino
5.2.6.3
What You Should Know About Oracle WebCenter Adapter for IBM Lotus Domino
5.2.6.4
Installing Oracle WebCenter Adapter for IBM Lotus Domino in Oracle JDeveloper
5.2.6.5
Installing Oracle WebCenter Adapter for IBM Lotus Domino on Oracle Application Server
5.2.6.6
Configuring a Data Control based on Oracle WebCenter Adapter for IBM Lotus Domino
5.2.6.7
Verifying the JCR Domino Adapter Library in the Model Project
5.2.7
Configuring a Content Data Control Based on Oracle WebCenter Adapter for Microsoft SharePoint
5.2.7.1
Overview of Oracle WebCenter Adapter for Microsoft SharePoint
5.2.7.2
Platform Requirements
5.2.7.3
What You Should Know About Oracle WebCenter Adapter for Microsoft SharePoint
5.2.7.4
Installing Oracle WebCenter Adapter for Microsoft SharePoint in Oracle JDeveloper
5.2.7.5
Installing Oracle WebCenter Adapter for Microsoft SharePoint on Oracle Application Server
5.2.7.6
Installing Additional SharePoint Services on Microsoft SharePoint 2003 Server
5.2.7.7
Configuring a Data Control Based on Oracle WebCenter Adapter for Microsoft SharePoint
5.2.7.8
Verifying the Library of Oracle WebCenter Adapter for Microsoft SharePointin the Model Project
5.2.8
Configuring a Content Data Control Based on Oracle WebCenter Adapter for EMC Documentum
5.2.8.1
Overview of the Oracle WebCenter Adapter for EMC Documentum
5.2.8.2
Platform and DFC Requirements for the Oracle WebCenter Adapter for EMC Documentum
5.2.8.3
What You Should Know About the Oracle WebCenter Adapter for EMC Documentum
5.2.8.4
Installing Oracle WebCenter Adapter for EMC Documentum in Oracle JDeveloper
5.2.8.5
Installing the Oracle WebCenter Adapter for EMC Documentum on Oracle Application Server
5.2.8.6
Configuring a Data Control Based on Oracle WebCenter Adapter for EMC Documentum
5.2.8.7
Verifying the Library of the Oracle WebCenter Adapter for EMC Documentum in the Model Project
5.2.9
Editing Content Data Controls
5.2.10
Applying Oracle ADF Security on JCR Data Controls
5.3
Using JCR Data Controls: Examples
5.3.1
Publishing Content As Links
5.3.1.1
Publishing Content As a Textual Link
5.3.1.2
Publishing Content As an Image Object
5.3.2
Publishing Content in a Table
5.3.2.1
Displaying Files and Folders in Read-Only Format
5.3.2.2
Displaying the Name Attribute As a GoLink
5.3.2.3
Configuring a Table to Show Only a Single Column
5.3.2.4
Configuring a Table to Show Only Files
5.3.3
Publishing Folder Content in a Tree
5.3.3.1
Displaying Files and Folders in Read-Only Format
5.3.3.2
Displaying File Names As Hyperlinks
5.3.4
Adding Search Capabilities to Content Repositories
5.3.4.1
What You Should to Know When Using Search Capabilities
5.3.4.2
Adding Simple Search Capabilities
5.3.4.3
Adding Advanced Search Capabilities
5.3.4.4
Adding Advanced Search Capabilities Using the Data Control based on Oracle WebCenter Adapter for EMC Documentum
5.3.5
Configuring Custom Attributes in Oracle Content DB
5.3.5.1
Creating Attributes in Oracle Content DB
5.3.5.2
Adding Custom Attributes to the Oracle Content DB Data Control
5.3.6
Creating Clickable Images Using Custom Attributes
5.3.6.1
Creating a Custom Attribute in Oracle Content DB
5.3.6.2
Creating a Data Control based on Oracle Content DB Adapter
5.3.6.3
Creating a Clickable Image and Table of Clickable Images
5.4
Configuring Data Controls Based on Stellent Content Server
5.4.1
Configuring Web Service Data Controls Based on Stellent Content Server
5.4.2
Integrating Content from Stellent Content Server Using a Custom Data Control
5.4.2.1
Creating a Java Proxy
5.4.2.2
Creating the Custom Java Class
5.4.2.3
Creating a Custom Data Control
5.5
Using Stellent Content Server-Based Data Controls: Examples
5.5.1
Adding Simple Search Capabilities Using the Web Service Data Control
5.5.2
Adding Simple Search Capabilities Using the Custom Data Control
5.6
Integrating Oracle Business Intelligence Publisher
5.6.1
Integrating BI Publisher Reports into Your WebCenter Application
5.6.2
Storing BI Publisher Reports in the WebCenter Content Repository
6
Integrating Oracle WebCenter Wiki
6.1
Introduction to Wiki
6.2
Setting Up Oracle WebCenter Wiki
6.2.1
Installing Oracle WebCenter Wiki
6.2.2
Configuring Security
6.2.2.1
User Groups
6.2.2.2
Clustered Configurations for Java SSO
6.2.2.3
Generating the Passphrase
6.2.3
Locations
6.3
Using Oracle WebCenter Wiki
6.3.1
Structure of Wiki Content
6.3.2
Editing and Creating Pages
6.3.2.1
Editing Pages
6.3.2.2
Creating Pages
6.3.3
Wiki Markup
6.4
Integrating Oracle WebCenter Wiki into a WebCenter Application
6.4.1
Oracle WebCenter Wiki Web Service Interface
6.4.1.1
Definition of the Interface
6.4.1.2
Web Service Security
6.4.1.3
Example Java program
6.4.1.4
Creating and Using a Data Control
6.4.2
Sample Portlets
6.4.2.1
Setting Up the Portlet Environment
6.4.2.2
Viewing the Sample Portlets
6.4.2.3
SelectPagePortlet
6.4.2.4
PageInfoPortlet
6.4.2.5
CreateDomainPortlet
6.4.2.6
CreatePagePortlet
6.4.3
Writing a Portlet
7
Integrating Oracle WebCenter Discussions
7.1
Introduction to Oracle WebCenter Discussions
7.2
Integrating Oracle WebCenter Discussions
7.2.1
How to Install and Configure Oracle WebCenter Discussions
7.2.2
How to Configure Java SSO with Your Oracle WebCenter Discussions Application and Portlet
7.2.2.1
Configuration Tips
7.2.2.2
Manual Configuration Steps for Portlet Deployment
7.2.3
How to Consume the Discussion Forum Portlet in Your WebCenter Application
7.2.3.1
Configuring Security for the Portlet and Oracle WebCenter Discussions Application
8
Integrating Oracle Secure Enterprise Search
9
Defining and Applying Styles to Core Customizable Components
9.1
Introduction to Skins, Style Selectors, and Style-Related Properties
9.1.1
About Oracle ADF Faces Skins
9.1.2
About Style Selectors
9.1.3
About Component Style Properties
9.2
Applying Custom Skins to Applications
9.2.1
How to Make Default Skins Available in an Application
9.2.2
How to Add a Custom Skin to an Application
9.2.2.1
How to Create a CSS in Oracle JDeveloper
9.2.2.2
How to Add a CSS to a Project Root
9.2.3
How to Register a Skin
9.2.4
How to Tell an Application to Use a Particular Skin
9.3
Specifying Style Definitions for Portlet and Core Customizable Component Style and Icon Selectors
9.3.1
Core Customizable Component Property Keys
9.3.2
Global Style Selectors
9.3.3
ShowDetailFrame Style Selectors
9.3.4
PanelCustomizable Style Selectors
9.3.5
Icon Selectors for Core Customizable Components
9.3.6
Applying Color Schemes to Portlets and Core Customizable Components
9.3.7
What You May Need to Know About Oracle ADF Faces Skin Resources
9.4
Defining Styles Through the Property Inspector
9.4.1
Understanding Style-Related Properties
9.4.1.1
Understanding ContentInlineStyle and InlineStyle Properties
9.4.1.2
What You Should Know About EL and the InlineStyle Property
9.4.1.3
Understanding the StyleClass Property
9.4.2
Changing Style-Related Properties
9.4.3
Attributes of the ContentInlineStyle and InlineStyle Properties
9.5
Building a Run-Time Skin Selector
9.5.1
Changing Skins for One User
9.5.1.1
Creating a Java Class to Serve As a Managed Bean (ClientSkinBean.java)
9.5.1.2
Registering the ClientSkinBean Class As a JSF Managed Bean
9.5.1.3
Using an Expression Language Expression to Reference the Bean
9.5.1.4
Adding User Interface Components to the Page for Switching the Skin
9.5.2
Changing Skins for All Users
9.5.2.1
Creating a Java Class to Serve As a Managed Bean (ServerSkinBean.java)
9.5.2.2
Registering the ServerSkinBean Class As a JSF Managed Bean
9.5.2.3
Using an EL Expression to Reference the Bean
9.5.2.4
Adding UI Components to the Page for Switching the Skin
10
Securing Your WebCenter Application
10.1
Introduction to WebCenter Application Security
10.1.1
Authentication
10.1.2
Authorization
10.1.2.1
Oracle ADF Permissions
10.1.2.2
Anonymous Access
10.1.3
External Application Credentials and Portlets
10.2
Setting Up Security for Your Application
10.2.1
Defining Roles for Developing Secured WebCenter Applications
10.2.2
Configuring Security for Your Application
10.2.3
Defining Access Policies
10.2.3.1
Getting Information from the Oracle ADF Security Context
10.2.3.2
Securing Pages in Your Application
10.2.3.3
Securing Iterators, Attributes, and Methods in Your Application
10.2.3.4
Applying Security on JCR Data Controls
10.2.3.5
Using Regular Expressions to Define Policies on Groups of Resources
10.2.4
Enforcing Security Policies in Your Application
10.2.4.1
Evaluating Policies Using Expression Language (EL)
10.2.4.2
Evaluating Policies Using Java
10.2.5
Configuring Deployment Descriptor Files with Security Information
10.2.5.1
Creating the Deployment Descriptor File
10.2.5.2
Configuring Security Role Mappings
10.2.5.3
Additional Requirement for Running the Application in Oracle JDeveloper's Embedded OC4J
10.3
Creating a Login Component for Your Application
10.4
Creating a Login Page for Your Application
10.4.1
Creating an Oracle ADF Faces-Based Login Page
10.4.2
Adding Login Code to the Backing Bean
10.4.3
Adding Portlets to the Login Page
10.4.4
Configuring the web.xml File for an Oracle ADF Faces-Based Login Page
10.4.5
Editing Authorization for the Login Page
10.5
Creating a Public Welcome Page for Your Application
10.5.1
Making the Welcome Page Public
10.5.2
Adding Login and Logout Links
10.5.3
Hiding Links to Secured Pages
10.6
Configuring Basic Authentication for Testing Portlet Personalization
10.7
Accessing External Applications Requiring Credentials
10.7.1
Working with External Applications
10.7.1.1
Registering an External Application
10.7.1.2
Editing External Application Registration Details
10.7.1.3
Deleting External Application Registration Details
10.7.2
Working with Credential Provisioning Pages
10.7.2.1
Adding a Credential Provisioning Page
10.7.2.2
Adding Credentials at Run time
10.8
Registering Custom Certificates with the Keystore
10.9
Overriding Inherited Security on Portlets and Customizable Components
10.9.1
Portlets Security
10.9.1.1
Defining Security at the Actions Category Level
10.9.1.2
Defining Security at the Actions Level
10.9.2
Customizable Components Security
10.9.2.1
Defining Security at the Actions Category Level
10.9.2.2
Defining Security at the Actions Level
10.10
Securing Identity Propagation Through WSRP Producers With WS-Security
10.10.1
Setting Up the Keystores
10.10.1.1
Setting Up Keystores Using an Oracle Wallet
10.10.1.2
Setting Up the Keystores Using Java Keystore
10.10.2
Configuring the Producer
10.10.3
Configuring the Consumer
10.11
Configuring a WebCenter Application to Use LDAP and Single Sign-On
10.11.1
Configuring a WebCenter Application to Use Oracle Internet Directory
10.11.2
Configuring a WebCenter Application to Use Oracle Single Sign-On
10.11.3
Configuring a WebCenter Application to Use Java Single Sign-On
10.11.4
Configuring a WebCenter Application to Use an External LDAP Provider
10.11.5
Configuring a WebCenter Application to Use Oracle Access Manager
11
Working Productively in Teams
11.1
General Advice for Using CVS on WebCenter Applications
11.2
Advice for WebCenter Application Files in CVS
11.2.1
Files Associated With Common Objects
11.2.2
Developer Actions Affecting Metadata Files
11.3
Implementing Common Requirements Once
11.4
Producer Considerations
11.4.1
Producer Connections
11.4.2
Producer Name Clashes
11.4.3
Combining Portlets from Different Producers
11.5
Security Considerations
Part III Deploying and Monitoring Your WebCenter Application
12
Deploying Your WebCenter Application
12.1
Introduction to WebCenter Application Deployment
12.1.1
Understanding the WebCenter Application Deployment Life Cycle
12.1.1.1
Scenario 1: Portlet Customization in the Development Environment
12.1.1.2
Scenario 2: Customization Performed Only In the Production Environment
12.1.1.3
Scenario 3: Customization of Deployed Applications in Both the Stage and Production Environments
12.1.2
About WebCenter Application Deployment in the Production Environment
12.1.3
About WebCenter Application Deployment in the Development Environment
12.1.4
About Transporting Customizations between Environments
12.2
Deploying Your WebCenter Application
12.2.1
Packaging Your WebCenter Application
12.2.1.1
What You Should Know About Packaging a WebCenter Application
12.2.1.2
Creating the WebCenter Application WAR Deployment Profile
12.2.1.3
Manually Creating and Editing the orion-application.xml File
12.2.1.4
Creating the Generic EAR File
12.2.2
Predeploying Your WebCenter Application
12.2.2.1
What You Should Know About Predeployment
12.2.2.2
Predeploying WebCenter Applications and JCR Adapter-based Applications
12.2.3
Deploying Your WebCenter Application Using Application Server Control Console
12.2.3.1
Deploying Your WebCenter Application
12.2.3.2
Testing Your WebCenter Application
12.2.4
Migrating Security and Application Roles
12.2.4.1
About Modes of Migration
12.2.4.2
Updating Policy Information (Optional)
12.2.4.3
Using the JAZN Migration Tool
12.2.4.4
Using the ldapmodify Command-Line Tool
12.2.5
Deploying Your WebCenter Application Using the Command Line
12.2.5.1
Deploying the EAR File to OC4J in Oracle Application Server
12.2.5.2
Testing the Deployment
12.2.5.3
Binding web_module to a Web Site
12.2.6
Deploying Your WebCenter Application Using Oracle JDeveloper
12.2.6.1
Deploying to Embedded OC4J
12.2.6.2
Deploying to Standalone OC4J
12.2.7
Deploying an External Application
12.2.8
Deploying a Content Integration Application
12.3
Deploying Your WebCenter Application with WebCenter Ant Tasks
12.3.1
Overview of WebCenter Ant Tasks
12.3.2
Preparing to Use Ant Tasks
12.3.2.1
Incorporating Ant Tasks in Your Oracle WebCenter Framework
12.3.2.2
Installing Ant Tasks
12.3.3
Deploying Your WebCenter Application with Ant Tasks
12.3.3.1
Namespacing Class Definitions
12.3.3.2
Creating the build.xml File
12.3.3.3
Deploying with the build.xml File
12.4
Transporting Customizations Between Environments
12.4.1
Exporting Customizations
12.4.2
Importing Customizations
12.5
Updating Credentials in a Deployed Application
12.6
Cloning WebCenter Applications
12.6.1
Expanding an Oracle Application Server Cluster
12.6.2
Using Cloning to Move from Stage to Production
12.7
Configuring Your WebCenter Application to Run in a Distributed Environment
12.8
Undeploying Your WebCenter Application
12.8.1
Undeploying Your WebCenter Application Using Application Server Control Console
12.8.2
Undeploying Your WebCenter Application Using the Command Line
13
Monitoring Your WebCenter Application
13.1
Displaying the Application Server Control Console
13.2
Navigating to WebCenter Application Pages
13.3
Interpreting the Information in Oracle Enterprise Manager 10
g
13.3.1
Portlet Producers - Summary Page
13.3.2
Portlet Producer - Detail Page
13.3.3
Portlet - Detail Page
Part IV Building Portlets
14
Understanding Portlets
14.1
Understanding Portlets
14.2
Portlet Anatomy
14.3
Portlet Resources
14.3.1
Rich Text Portlet
14.3.2
Prebuilt Portlets
14.3.3
Web Clipping
14.3.4
OmniPortlet
14.3.5
Programmatic Portlets
14.3.6
Deciding Which Tool to Use
15
Portlet Technologies Matrix
15.1
The Portlet Technologies Matrix
15.2
General Suitability
15.2.1
Web Clipping
15.2.2
OmniPortlet
15.2.3
Oracle Portlet Factory
15.2.4
Programmatic Portlets
15.3
Expertise Required
15.3.1
Web Clipping
15.3.2
OmniPortlet
15.3.3
Oracle Portlet Factory
15.3.4
Programmatic Portlets
15.4
Deployment Type
15.4.1
PDK-Java Producers
15.4.2
WSRP Producers
15.4.3
Producer Architecture
15.5
Caching Style
15.5.1
Web Clipping and OmniPortlet
15.5.2
Oracle Portlet Factory
15.5.3
Programmatic Portlets
15.6
Development Tool
15.6.1
Web Clipping and OmniPortlet
15.6.2
Oracle Portlet Factory
15.6.3
Programmatic Portlets
15.7
Portlet Creation Style
15.7.1
OmniPortlet and Web Clipping
15.7.2
Oracle Portlet Factory
15.7.3
Programmatic Portlets
15.8
User Interface Flexibility
15.8.1
Web Clipping
15.8.2
OmniPortlet
15.8.3
Oracle Portlet Factory
15.8.4
Programmatic Portlets
15.9
Ability to Capture Content from Web Sites
15.9.1
Web Clipping
15.9.2
OmniPortlet
15.9.3
Oracle Portlet Factory
15.9.4
Programmatic Portlets
15.10
Ability to Render Content Inline
15.10.1
Web Clipping
15.10.2
OmniPortlet
15.10.3
Oracle Portlet Factory
15.10.4
Programmatic Portlets
15.11
Charting Capability
15.11.1
Web Clipping
15.11.2
OmniPortlet
15.11.3
Oracle Portlet Factory
15.11.4
Programmatic Portlets
15.12
Public Portlet Parameter Support
15.13
Private Portlet Parameter Support
15.13.1
OmniPortlet and Web Clipping
15.13.2
Oracle Portlet Factory
15.13.3
Programmatic Portlets
15.14
Ability to Hide and Show Portlets Based on User Privileges
15.14.1
Web Clipping and OmniPortlet
15.14.2
Programmatic Portlets
15.15
Multilingual Support
15.16
Pagination Support
15.16.1
Web Clipping
15.16.2
OmniPortlet
15.16.3
Oracle Portlet Factory
15.16.4
Programmatic Portlets
15.17
Authenticating to External Applications
15.17.1
Web Clipping
15.17.2
OmniPortlet
15.17.3
Oracle Portlet Factory
15.17.4
Programmatic Portlets
16
Creating Portlets with OmniPortlet
16.1
Introduction to OmniPortlet
16.2
OmniPortlet Wizard
16.2.1
Type
16.2.2
Source
16.2.2.1
Proxy Authentication
16.2.2.2
Connection Information
16.2.2.3
Spreadsheet
16.2.2.4
SQL
16.2.2.5
XML
16.2.2.6
Web Service
16.2.2.7
Web Page
16.2.3
Filter
16.2.4
View
16.2.5
Layout
16.2.5.1
Tabular Layout
16.2.5.2
Chart Layout
16.2.5.3
News Layout
16.2.5.4
Bullet Layout
16.2.5.5
Form Layout
16.2.5.6
HTML Layout
16.2.6
Customize mode
16.3
Parameters
16.4
Summary
17
Creating Content-Based Portlets with Web Clipping
17.1
Introduction to Web Clipping
17.2
Adding Web Page Content to a Page
17.2.1
Registering a Web Clipping Producer
17.2.2
Adding a Web Clipping Portlet to a Page
17.2.3
Selecting a Section of a Web Page to Display in the Web Clipping Portlet
17.2.4
Setting Web Clipping Portlet Properties
17.3
Integrating Authenticated Web Content Using Single Sign-On
17.4
Adding a Web Clipping That Users Can Personalize
17.4.1
Selecting a Clipping in OTN
17.4.2
Personalizing a Web Clipping Portlet
17.5
Current Limitations for Web Clipping
17.6
Summary
18
Creating Java Portlets
18.1
Guidelines for Creating Java Portlets
18.1.1
Guidelines for Portlet Modes
18.1.1.1
Shared Screen Mode (View Mode for JPS)
18.1.1.2
Edit Mode (JPS and PDK-Java)
18.1.1.3
Edit Defaults Mode (JPS and PDK-Java)
18.1.1.4
Preview Mode (JPS and PDK-Java)
18.1.1.5
Full Screen Mode (PDK-Java)
18.1.1.6
Help Mode (JPS and PDK-Java)
18.1.1.7
About Mode (JPS and PDK-Java)
18.1.2
Guidelines for Navigation within a Portlet
18.1.2.1
Intraportlet Links
18.1.2.2
Application Links
18.1.2.3
External Links
18.1.2.4
Internal/Resource Links
18.1.3
Guidelines for JavaScript
18.1.3.1
Heed Device Information
18.1.3.2
Tailor Personalization Pages
18.2
Introduction to Java Portlet Specification (JPS) and WSRP
18.3
Configuring Your Application Server or Standalone OC4J to Run Portlets
18.4
Setting Up a Preference Store
18.4.1
Setting Up a Database Preference Store
18.4.1.1
Creating the Schema for a Database Preference Store
18.4.1.2
Mapping Connection Details to a JDBC Data Source
18.4.1.3
Setting Portlet Preference Store Variables in Producer Configuration Files
18.4.1.4
Database-Related Attributes and Parameters of the preferenceStore Tag
18.4.2
Setting Up a File-Based Preference Store
18.4.2.1
Configuring a WSRP Producer to Use a File-Based Preference Store
18.4.2.2
Configuring a PDK-Java Producer to Use a File-Based Preference Store
18.4.2.3
File-Related Attributes and Parameters of the preferenceStore Tag
18.4.3
What You Should Know About the Web Clipping Portlet and a Preference Store
18.4.3.1
Configuring a Web Clipping Portlet Producer to Use a Database Repository
18.4.3.2
Configuring a Web Clipping Portlet Producer to Use an Oracle Metadata Services Repository
18.4.3.3
Attributes and Child Tags of the repositoryInfo Tag
18.5
Building JPS-Compliant Portlets with Oracle JDeveloper
18.6
Introduction to PDK-Java
18.7
Building PDK-Java Portlets with Oracle JDeveloper
18.8
Adding Portlet Logic
18.9
Deploying Your Portlet to an Application Server
18.9.1
Deploying Your JPS-compliant WebCenter Application Portlet
18.9.2
Deploying Your PDK-Java Portlet
18.9.3
Deploying a Third-Party JPS-compliant Portlet
18.9.4
Validating Your JPS-Compliant Portlet and Producer
18.9.5
Validating Your PDK-Java Portlet and Producer
18.10
Registering and Viewing Your Portlet
19
Enhancing Java Portlets
19.1
Enhancing Java Portlet Specification (JPS) Portlets
19.1.1
Adding Personalization
19.1.1.1
Assumptions
19.1.1.2
Implementing Personalization
19.1.2
Implementing Navigational Parameters (WSRP 2.0)
19.1.3
Implementing Export/Import of Customizations (WSRP 2.0)
19.1.4
Implementing Rewritten URLs for Resource Proxy
19.1.5
Implementing Security for JPS Portlets
19.2
Enhancing PDK-Java Portlets
19.2.1
Adding Portlet Modes
19.2.1.1
Assumptions
19.2.1.2
Implementing Extra Portlet Modes
19.2.1.3
Updating the XML Producer Definition
19.2.1.4
Viewing the Portlet
19.2.2
Passing Parameters and Submitting Events
19.2.2.1
Assumptions
19.2.2.2
Adding Public Parameters
19.2.2.3
Passing Private Portlet Parameters
19.2.2.4
Creating Private Events
19.2.3
Using JNDI Variables
19.2.3.1
Declaring JNDI Variables
19.2.3.2
Setting JNDI Variable Values
19.2.3.3
Retrieving JNDI Variables
19.2.4
Accessing Session Information
19.2.4.1
Assumptions
19.2.4.2
Implementing Session Storage
19.2.4.3
Viewing the Portlet
19.2.5
Implementing Portlet Security
19.2.5.1
Assumptions
19.2.5.2
Introduction to Portlet Security Features
19.2.5.3
Single Sign-On
19.2.5.4
Portlet Security Managers
19.2.5.5
Server Security
19.2.5.6
Message Authentication
19.2.5.7
User Input Escape
19.2.6
Enhancing Portlet Performance with Caching
19.2.6.1
Assumptions
19.2.6.2
Activating Caching
19.2.6.3
Adding Expiry-Based Caching
19.2.6.4
Adding Invalidation Based Caching
19.2.6.5
Adding Validation-Based Caching
19.3
Testing Portlet Personalization
19.4
Building Struts Portlets
19.4.1
The Apache Struts Framework
19.4.1.1
Model View Controller Overview
19.4.1.2
Apache Struts Overview
19.4.1.3
OracleAS PDK Integration with Struts
19.4.1.4
Summary
19.4.2
Creating a Struts Portlet
19.4.2.1
Creating a Struts Portlet
19.4.2.2
Registering the Producer
19.4.2.3
Summary
19.4.3
Creating an Oracle Application Development Framework Portlet
19.5
Building Portlets from Oracle ADF Faces Applications (JSF Portlet Bridge)
19.5.1
Creating a JSF Portlet
19.5.1.1
Passing Parameters
19.5.2
Guidelines for Oracle ADF Faces Applications
19.5.2.1
General Guidelines
19.5.2.2
Portlet Guidelines
19.5.2.3
Oracle ADF Faces Guidelines
19.5.2.4
Oracle ADF Guidelines
Part V Appendixes
A
Reuse of OracleAS Portal Components
A.1
Reusing Your OracleAS Portal Components in WebCenter Suite
A.1.1
Reusing Portlets
A.1.1.1
iframes
A.1.1.2
Events
A.1.1.3
Mobile Portlets
A.1.1.4
Portlet Chrome
A.1.1.5
Personalizations and Customizations
A.1.1.6
OracleAS Portal System Resources
A.1.1.7
Partner and External Applications
A.1.1.8
Federated Portal Adapter
A.1.1.9
PDK-Java Producers from Earlier Oracle Application Server Versions
A.1.2
Reusing Items
B
Additional Portlet Configuration
B.1
Java Portlet Configuration Tips
B.2
OmniPortlet Configuration Tips
B.2.1
Configuring the OmniPortlet Producer to Access Data Outside a Firewall
B.2.2
Configuring the OmniPortlet Producer to Access Other Relational Databases
B.2.2.1
Installing DataDirect JDBC Drivers
B.2.2.2
Registering DataDirect Drivers in OmniPortlet
B.2.3
Configure Portal Tools and Web Producers (Optional)
B.3
Web Clipping Portlet Configuration Tips
B.3.1
Configuring the Web Clipping Repository
B.3.2
Configuring HTTP or HTTPS Proxy Settings
B.3.3
Securing the Web Clipping Producer
B.3.3.1
Adding Certificates for Trusted Sites
B.3.3.2
Configuring Oracle Advanced Security for the Web Clipping Producer
B.4
Portlet Preference Store Migration Utilities
B.4.1
JPS Portlet Preference Store
B.4.1.1
PersistenceMigrationTool
B.4.1.2
How to Determine and Set Your Preference Store
B.4.2
PDK-Java Portlet Preference Store
B.4.3
Web Clipping Repository
C
Files for WebCenter Applications
C.1
About Files
C.2
Files Overview
C.3
Files Related to JPS Portlets
C.3.1
oracle-portlet.xml
C.3.1.1
oracle-portlet.xml Syntax
C.3.1.2
oracle-portlet.xml Sample With Navigation Parameters
C.3.2
oracle-portlet-tags.jar
C.3.3
portlet.xml
C.3.4
portlet_mode.jsp
C.3.5
portlet_name.java
C.3.6
portlet_nameBundle.jar
C.3.7
web.xml
C.3.8
profile_name.deploy
C.4
Files Related to PDK-Java Portlets
C.4.1
producer_name.properties
C.4.2
_default.properties
C.4.3
index.jsp
C.4.4
portlet_name_modePage.jsp
C.4.5
provider.xml
C.4.5.1
provider.xml Syntax
C.4.5.2
provider.xml Sample
C.4.6
web.xml
C.4.7
profile_name.deploy
C.5
Files Related to Pages
C.5.1
adf-config.xml
C.5.2
adf-faces-config.xml
C.5.3
DataBindings.cpx
C.5.4
faces-config.xml
C.5.5
page_name.jspx
C.5.6
PageDef.xml
C.5.7
web.xml
C.5.8
profile_name.deploy
C.5.9
mds Subdirectory
C.5.10
wsdl Subdirectory
C.6
Files Related to Security
C.6.1
app-jazn-data.xml
D
Manually Packaging and Deploying PDK Portlet Producers
D.1
Introduction
D.1.1
WAR and EAR files
D.1.2
Service Identifiers
D.2
Packaging and Deploying Your Producers
D.2.1
Packaging Your Producer
D.2.1.1
Preparing Your Directories
D.2.1.2
Specifying Your Default Service
D.2.1.3
Creating Your WAR File
D.2.1.4
Creating Your EAR File
D.2.2
Deploying Your EAR File
D.2.2.1
Deploying with the Grid Control Console
D.2.2.2
Deploying Manually with dcmctl
D.2.2.3
Deploying Manually to Standalone OC4J
D.2.3
Testing Deployment
D.2.4
Setting Deployment Properties
D.2.5
Securing Your Producer
D.2.6
Registering Your Producer
E
Administering Oracle WebCenter Wiki
E.1
Accessing the Administration Mode
E.2
Domains and Menus
E.2.1
Domains
E.2.2
Menus
E.3
Locking and Unlocking Pages
E.4
User Interface Templates
E.5
Changing Themes of the Wiki Page
E.6
Monitoring Oracle WebCenter Wiki
E.7
Backing Up and Restoring Wiki Content
E.8
Exporting a Domain
E.9
Blocking an IP Address
E.10
Permissions
E.11
Enabling Anonymous Access to Oracle WebCenter Wiki
E.12
Other Configuration Parameters
F
Node Type Definitions for Oracle WebCenter Adapters
F.1
Node Type Definitions for the Oracle WebCenter Adapter for IBM Lotus Domino
F.1.1
Reading
F.1.2
Node Type Mapping
F.1.2.1
IBM Lotus Notes/Domino Namespace
F.1.2.2
Documents
F.1.2.3
Views
F.1.3
Searching
F.1.4
Authorization
F.1.4.1
Workspaces Access
F.1.4.2
Document read access
F.2
Node Type Definitions for the Oracle WebCenter Adapter for Microsoft SharePoint
F.2.1
SharePoint Namespace
F.2.2
Object
F.2.3
Collection
F.2.3.1
Web Collection
F.2.3.2
List Collection
F.2.3.3
Field Collection
F.2.3.4
Site Template Collection
F.2.3.5
Item Collection
F.2.3.6
File Collection
F.2.4
Site
F.2.5
Template
F.2.5.1
List Template
F.2.5.2
Site Template
F.2.6
Item
F.2.7
Web
F.2.8
Web Site
F.2.9
List
F.2.10
Field
F.2.10.1
Field Type
F.2.10.2
Computed Field
F.2.10.3
Calculated Field
F.2.10.4
Choice Field
F.2.10.5
Number Field
F.2.10.6
Currency Field
F.2.10.7
Date Time Field
F.2.10.8
Lookup Field
F.2.10.9
Multi Choice Field
F.2.10.10
Multi Line Text Field
F.2.10.11
Rating Scale Field
F.2.10.12
Text Field
F.2.10.13
URL Field
F.2.10.14
User Field
F.2.11
Form
F.2.12
View
F.2.13
List Item
F.2.14
Folder and Files
F.2.14.1
Folder
F.2.14.2
File
F.2.14.3
Attachment
F.3
Node Type Definitions for the Oracle WebCenter Adapter for EMC Documentum
F.3.1
Documentum Namespace
F.3.2
Node Type Mapping
F.3.3
Hierarchy Mapping
F.3.4
Virtual Documents Mapping
F.3.5
Accessing Permissions Mapping
F.3.6
Caching for Oracle WebCenter Adapter for EMC Documentum
G
Troubleshooting WebCenter Applications
G.1
Problems and Solutions
G.1.1
Troubleshooting Your WebCenter Application
G.1.1.1
Credentials MBean Not Showing Up in Oracle Enterprise Manager
G.1.1.2
Large WebCenter Application Fails With Various Errors
G.1.1.3
Error While Deploying a WebCenter Application to a Preseeded Standalone OC4J
G.1.2
Troubleshooting Generic Portlet Problems
G.1.2.1
Portlet Appears Twice in Component Palette
G.1.2.2
Customizations Missing for Duplicate Application
G.1.2.3
Error Accessing the Update login information Link on a Portlet
G.1.2.4
Portlet Producers Not Accessible
G.1.2.5
Error in Credential Provisioning Page Displayed Using the Update Login Information Link
G.1.2.6
Error in Displaying Portlet at Run Time
G.1.2.7
Portlet Error When Page URLs Vary
G.1.3
Troubleshooting JPS Portlets
G.1.3.1
WS-Security SAML Verification by Producer Fails
G.1.3.2
Portlet Unavailable for Producer with WS Security
G.1.3.3
Error When Converting the JPS Producer EAR File to WSRP Producer EAR File
G.1.3.4
Portlets Unavailable for Producer with Different Preference Store Path
G.1.3.5
JPS portlet Does Not Work on Pluto
G.1.4
Troubleshooting PDK-Java Portlets
G.1.4.1
Redirect Error in PDK-Java Portlet
G.1.4.2
Images Not Appearing in Full Page Portlet Modes
G.1.4.3
PDK-Java Portlet With Non-ASCII Characters Fails
G.1.4.4
PDK-Java Producer with Multibyte Characters in Service ID Fails
G.1.4.5
Images Not Found Running PDK-Java Portlets of a JSF Application
G.1.5
Troubleshooting Portlets Built from Oracle ADF Faces Applications
G.1.5.1
Error Creating the Portlet
G.1.5.2
Error Finding Images and Resources in Your Portlet
G.1.5.3
Private Portlet Parameters Lost on Navigating to Another Page
G.1.5.4
Error When Testing a Producer's WSDL URL
G.1.5.5
Error When Accessing WSRP Portlets
G.1.5.6
Unable to Navigate to Another Page from the Portlet
G.1.5.7
Portlet Not Rendered on Page
G.1.5.8
Missing Class Error When Deploying a Portlet
G.1.5.9
Portlet Unavailable Error
G.1.6
Troubleshooting OmniPortlet Problems
G.1.6.1
Cannot Define OmniPortlet Using the Define Link
G.1.7
Troubleshooting Application Life Cycle Issues
G.1.7.1
Predeployment Tool Unable to Create Temporary Area on MS Windows
G.1.7.2
Cannot Create Generic EAR File
G.1.7.3
Unable to Find MDS for Portlet Producer
G.1.7.4
Predeployment Tool Fails with Unexpected PortletException
G.1.7.5
Portlets Not Appearing on Deployed Application Pages
G.1.7.6
No MDS Data Found, MDSRuntimeException
G.1.7.7
Garbled MDS Path When Predeploying on Europeans MS Windows
G.2
Diagnosing WebCenter Applications (Logging)
G.2.1
Understanding Logging
G.2.2
Configuring Logging
G.2.2.1
Logger Names and Scope
G.2.2.2
Logging Levels
G.2.2.3
Configuring Logging Through the ODL Configuration File
G.2.2.4
Configuring Logging Through the Default JDK Logging Properties File
G.2.3
Viewing the Log
G.3
Need More Help?
Glossary
Index