Oracle Fusion Middleware Online Documentation Library

Oracle® Fusion Middleware
Developer's Guide for Oracle WebCenter
11g Release 1 (11.1.1.5.0)
E10148-16

August 2011

Oracle Fusion Middleware Developer's Guide for Oracle WebCenter, 11g Release 1 (11.1.1.5.0)
E10148-16
Copyright © 2007, 2011, Oracle and/or its affiliates. All rights reserved.
Primary Author:

William Witman

Contributing Authors: Ingrid Snedecor, Jennifer Shipman, Joan Carter, Lalithashree Rajesh, Michele Cyran,
Peter Jacobsen, Promila Chitkara, Rosie Harvey, Sarah Bernau, Savita Thakur, Sue Highmoor, Tom Maremaa
Contributor: Randy Akl, Maheswaran Anantharaman, Sivakumar Balagopalan, Rahmathulla Baig,
Ravishankar Belavadi, Chris Broadbent, Steve Burns, Chris Carter, Vince Casarez, Chung Cheng, Demetris
Christou, Vicki Chun, Ross Clewley, Manish Devgan, Marcus Diaz, Sumit Dubey, Frans Effendi, Paul
Encarnacion, Gaurav Mittal, Jeni Ferns, Robin Fisher, Michael Freedman, Nick Greenhalgh, Christian
Hauser, Harsha Huddar, Hsing Huang, Clayton Jung, Medini Kakade, Hrishikesh Karambelkar, Seshan

Kennan, Sanjay Khanna, Vasant Kumar, Paul Lin, Yueh-Hong Lin, Alison Macmillan, George Maggessy,
Pankaj Mittal, Peter Moskovits, Dan Mullen, Lei Oh, Nicolas Pombourcq, Prabhakar Munnangi Reddy,
Puvanenthiran Subbaraj, Rajesh Ramachandran, Sripathy Rao, Shubha Rangarajan, Shakeb Sagheer, Raghu
Sampathkrishna, Skip Sauls, Andrew Sefkow, Jennifer Shu, Ved Singh, Vidhya Sundaram, Paul Spencer,
Stephen Thornhill, Deepthi Umakanth, Kundan Vyas, Alistair Wilson, Stewart Wilson, Hui Zeng, Brad
Posner, Steve Roth, Greg Smith, Tanya Saarva, Chris Bales, Ray Polk, Jeff Mueller, Pankash Kapasi, Tim
Breeden, Sameer Sawant, Ken Young, Leevar Williams, Arun Tharakkal, Don Hayler, Stephen Thornhill,
Steve Pepper, Dawn Tyler, Jordan Douglas
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,
license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.
Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical

data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental
regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the
restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable
by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial
Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA
94065.
This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications, including
applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other
measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages
caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of
their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,
Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced
Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly

disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle
Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your
access to or use of third-party content, products, or services.

Contents
Preface ................................................................................................................................................................ lix
Audience...................................................................................................................................................... lix
Documentation Accessibility ..................................................................................................................... lx
Related Documents ..................................................................................................................................... lx
Conventions ................................................................................................................................................. lx

What's New ....................................................................................................................................................... lxi
Issues Addressed in Release 11.1.1.5.0 ....................................................................................................

Part I
1

lxi

Introduction

Developer's Quick Start Guide
1.1
1.2
1.3
1.4
1.5
1.5.1
1.5.2
1.5.3
1.5.4
1.6
1.6.1
1.6.2
1.6.3
1.7
1.8
1.9
1.10
1.10.1

1.10.2
1.10.3
1.10.4
1.11

WebCenter Portal Developer's FAQ ........................................................................................ 1-1
Installing Required Software..................................................................................................... 1-3
Preparing for Team Development............................................................................................ 1-3
Creating a New WebCenter Portal Application..................................................................... 1-3
Preparing for Iterative Development ....................................................................................... 1-4
What Is Iterative Development? ........................................................................................ 1-4
How Does Iterative Development Work? ........................................................................ 1-4
Enabling Iterative Development........................................................................................ 1-6
Turning Off Iterative Development .................................................................................. 1-6
Creating Application Resource Connections .......................................................................... 1-7
Where Are Connections Located? ..................................................................................... 1-7
How Do I Access the Connection Wizards? .................................................................... 1-7
Where Can I Learn More About Connections? ............................................................... 1-8
Planning the Portal Layout........................................................................................................ 1-8
Working with Skins .................................................................................................................... 1-8

Preparing for Round-Trip Development................................................................................. 1-8
What Configuration Files Should I Know About? ................................................................. 1-9
The WebCenter Portal Application Template Default web.xml File ........................... 1-9
The WebCenter Portal Application Template Default faces-config.xml File........... 1-10
The WebCenter Application Template Default trinidad-config.xml File................. 1-11
The WebCenter Application Template Default adfc-config.xml File........................ 1-12
Installing Database Schemas .................................................................................................. 1-12

iii

2

Understanding Oracle WebCenter
2.1
2.2
2.3
2.3.1
2.3.1.1
2.3.1.2
2.3.2

2.3.3
2.3.4
2.3.5
2.3.6
2.4
2.4.1
2.5
2.5.1
2.5.2
2.5.3
2.6
2.7
2.8
2.8.1
2.8.2
2.8.3
2.9
2.9.1
2.9.2
2.9.3

What Is Oracle WebCenter? ...................................................................................................... 2-1
Introducing the Oracle WebCenter Portal Framework ......................................................... 2-2
What WebCenter Features Can I Add to a Portal? ................................................................ 2-2
Portlets and Pagelets for Accessing Remote Applications and Services ..................... 2-2
What Are Portlets? ....................................................................................................... 2-3
What Are Pagelets? ...................................................................................................... 2-4
Oracle Composer Allows User Customization ............................................................... 2-4
Content Integration with Supported Content Repositories .......................................... 2-5
Search Framework ............................................................................................................... 2-5
Resource Catalogs Help Organize the Development Experience ................................ 2-5
Application Security............................................................................................................ 2-6
Introducing Oracle WebCenter Services ................................................................................. 2-7
WebCenter Services and the REST APIs .......................................................................... 2-9
Introducing Oracle Application Development Framework (Oracle ADF)...................... 2-10
What Is Oracle ADF?........................................................................................................ 2-10
Why Is Oracle ADF Important for WebCenter Portal Developers? .......................... 2-10
What Does Oracle ADF Technology Include?.............................................................. 2-10
Introducing Oracle JDeveloper and the WebCenter Extension ........................................ 2-11
Understanding the Application Life Cycle .......................................................................... 2-12

Design Questions to Consider Before You Start.................................................................. 2-12
User Considerations ......................................................................................................... 2-12
Site Administrator Considerations................................................................................. 2-14
Developer Considerations ............................................................................................... 2-14
Overview of WebCenter Accessibility Features .................................................................. 2-16
Generating Accessible HTML ......................................................................................... 2-16
Accessibility Features at Runtime .................................................................................. 2-17
Accessibility Considerations for Portlets ...................................................................... 2-17

3 Preparing Your Development Environment
3.1
3.2
3.3
3.4
3.4.1
3.4.2
3.4.3
3.4.4
3.4.4.1
3.4.4.2

3.4.4.3
3.5
3.5.1
3.5.2
3.6

iv

Installing Oracle JDeveloper .....................................................................................................
Installing the WebCenter Extension Bundle ...........................................................................
Setting the User Home Directory Environment Variable .....................................................
Working with the Integrated WebLogic Server .....................................................................
How to Start and Stop Integrated WLS ............................................................................
What You May Need to Know About Integrated WLS .................................................
The WebCenter Preconfigured Server Readme File .......................................................
What You May Need to Know About Preconfigured Portlet Producers ....................
OmniPortlet and Web Clipping .................................................................................
The WSRP Sample Portlet Producers and Portlets..................................................
The PDK-Java Sample Portlet Producer and Portlets .............................................
Installing Database Schemas .....................................................................................................

Installing Schemas With RCU............................................................................................
Installing the WebCenter Schema with a SQL Script .....................................................
Installing the Oracle WebCenter Adapter for Microsoft SharePoint ..................................

3-1
3-1
3-2
3-2
3-2
3-3
3-3
3-4
3-4
3-5
3-6
3-6
3-7
3-7
3-7

4

Working Productively in Teams
4.1
4.1.1
4.1.2
4.2
4.2.1
4.2.2
4.3
4.4
4.4.1
4.4.2
4.4.3

5

Enabling Source Control on WebCenter Portal Applications .............................................. 4-1
Creating a Subversion Repository..................................................................................... 4-2
Understanding Oracle Team Productivity Center.......................................................... 4-3
Understanding WebCenter Portal Application Files Affected by Developers .................. 4-4
Files Associated With Common Objects .......................................................................... 4-4
Developer Actions Affecting Metadata Files................................................................... 4-4
Implementing Common Requirements One Time.............................................................. 4-12
Portlet Producer Considerations ........................................................................................... 4-13
Portlet Producer Connections ......................................................................................... 4-13
Portlet Producer Name Clashes...................................................................................... 4-13
Combining Portlets from Different Portlet Producers ................................................ 4-13

Creating WebCenter Applications
5.1
5.2
5.2.1
5.2.2
5.3
5.3.1
5.3.2
5.3.3
5.3.4
5.3.4.1
5.3.4.2
5.4
5.4.1
5.4.2
5.5

What Are WebCenter Application Templates? ...................................................................... 5-1
Creating a WebCenter Portal Application and Adding Pages............................................. 5-2
How to Create a WebCenter Portal Application............................................................. 5-2
Adding Pages to the Portal................................................................................................. 5-8
Understanding the PortalWebAssets Project.......................................................................... 5-9
Introduction .......................................................................................................................... 5-9
Decoupling the Static Application Resources Project .................................................... 5-9
Deployment Options ........................................................................................................ 5-11
Using EL to Manage Static Resources............................................................................ 5-11
Defining a Base URL Preference.............................................................................. 5-11
Mapping URLs Dynamically ................................................................................... 5-11
Creating a Portlet Producer Application .............................................................................. 5-12
How to Create a Portlet Application Using a Template ............................................. 5-13
What Happens When You Use a Portlet Producer Application Template .............. 5-13
How Is Portal Application Security Configured by Default?............................................ 5-14

6 Advanced Configuration Options
6.1
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.1.6
6.2
6.3

7

Manually Configuring a WebCenter Application With Technology Scopes ..................... 6-1
What are Technology Scopes?............................................................................................ 6-1
Adding and Removing Technology Scopes..................................................................... 6-1
What Are the Default Technology Scopes for a Portal Application?........................... 6-4
Which Technology Scopes Are Portal Application-Specific?........................................ 6-4
Can I Create a Portal Application by Adding the Portal Framework Technology Scope
Later? 6-5
Migrating a WebCenter PS2 or Earlier Application to a WebCenter Portal Application .
6-5
Extending Non-WebCenter Applications to Include WebCenter Capabilities ................. 6-5
Creating a Project by Importing a WAR File .......................................................................... 6-6

Preparing Your Application for Oracle WebCenter Services
7.1
7.1.1

Understanding WebCenter Services Technologies................................................................ 7-1
Understanding WebCenter Horizontal Services............................................................. 7-1

v

7.1.2
Understanding WebCenter APIs....................................................................................... 7-2
7.1.3
Using WebCenter Data Controls ....................................................................................... 7-5
7.2
Preparing Your WebCenter Portal Application to Consume Services................................ 7-6
7.2.1
How to Prepare Your Application to Consume Services .............................................. 7-6
7.2.1.1
Implementing Security for Services ........................................................................... 7-7
7.2.1.2
Setting Up SSL-Protected Connections for Services................................................ 7-8
7.2.2
Setting Up a Database Connection.................................................................................... 7-9
7.2.2.1
Associating Existing Database Connections.......................................................... 7-12
7.2.3
Setting Up an External Application Connection .......................................................... 7-12
7.3
Extending Your Application with Custom Components................................................... 7-13
7.3.1
Introducing the Resource Action Handling Framework ............................................ 7-13
7.3.2
Registering a Resource Viewer ....................................................................................... 7-14
7.3.3
Creating a Resource Authorizer Class........................................................................... 7-18
7.3.4
Specifying the View Handler and Navigation Behavior ............................................ 7-19
7.4
Configuring General Settings for Your Services ................................................................. 7-21
7.4.1
Building a Preferences User Interface............................................................................ 7-23
7.4.2
Using General Settings to Specify the User's Locale ................................................... 7-24

Part II Setting Up Your Portal Structure
8

Understanding WebCenter Portal Applications
8.1
8.2
8.2.1
8.2.2
8.3
8.4
8.5
8.5.1
8.5.2
8.5.3
8.5.4
8.5.5
8.5.6
8.6
8.7
8.7.1
8.7.2
8.8
8.9
8.10
8.11
8.11.1
8.11.2
8.11.3
8.11.4
8.12

vi

What is a Portal?.......................................................................................................................... 8-1
What is the WebCenter Portal Framework? ........................................................................... 8-3
How Do I Add Portal Framework to a Project? .............................................................. 8-3
What Features Does the Portal Framework Provide? .................................................... 8-3
What is the Portal Life Cycle? ................................................................................................... 8-4
Creating a WebCenter Portal Application .............................................................................. 8-4
Understanding the Features of a Portal Application............................................................. 8-5
Understanding Pages, Page Templates, and the Portal Page Hierarchy..................... 8-5
Securing Your Portal Pages ................................................................................................ 8-9
Understanding the Navigation Model and the Navigation Registry ....................... 8-11
Understanding Resource Catalogs and the Catalog Registry .................................... 8-13
Other Design Time Folders ............................................................................................. 8-15
Tips for More Advanced Development Use Cases...................................................... 8-15
Developing Your Portal's Look and Feel.............................................................................. 8-16
Changing Default Portal Preferences ................................................................................... 8-16
What Are the Default Portal Preferences? .................................................................... 8-16
How to Change the Default Preferences at Design Time ........................................... 8-17
Using Iterative and Round Trip Development Techniques ............................................. 8-17
What is the Application Sources Folder? ............................................................................. 8-18
Running and Testing a Portal................................................................................................. 8-18
WebCenter Portals at Runtime .............................................................................................. 8-19
Preserving Runtime Customizations on the Integrated WebLogic Server .............. 8-19
Runtime WebCenter Portal Administration Console.................................................. 8-20
How Security Settings Affect the Runtime Portal?...................................................... 8-21
Runtime Editing of Portal Resources............................................................................. 8-21
How are WebCenter Portal Files Organized?...................................................................... 8-22

8.12.1
Understanding the Organization of a WebCenter Portal Application .....................
8.12.1.1
How is a Portal Application Organized? ...............................................................
8.12.1.2
Why Is a Portal Application Organized the Way It Is? .......................................
8.12.2
Viewing Your Portal Project on the Filesystem............................................................
8.12.3
Viewing Your Portal Project in JDeveloper ..................................................................
8.13
Changing the Default Home Page and Login/Logout Target Pages...............................
8.13.1
Understanding How the Home Page is Specified .......................................................
8.13.2
How to Change the Default Home Page .......................................................................
8.13.3
How is the Default Index Page Specified? ....................................................................
8.13.4
Specifying the Target Page After a Login or Logout ...................................................
8.14
Basic Portal Development Tasks............................................................................................

9

8-23
8-23
8-24
8-24
8-25
8-26
8-26
8-27
8-28
8-29
8-30

Understanding the Portal Life Cycle
9.1
What is the WebCenter Portal Life Cycle? .............................................................................. 9-1
9.2
What Are the Major Life Cycle Tasks?..................................................................................... 9-3
9.2.1
One-Time Setup Tasks ........................................................................................................ 9-3
9.2.2
Development Environment Tasks..................................................................................... 9-4
9.2.3
Nightly Build Environment Tasks .................................................................................... 9-4
9.2.4
Testing Environment Tasks................................................................................................ 9-5
9.2.5
Stage Environment Tasks ................................................................................................... 9-5
9.2.6
Production Environment Tasks ......................................................................................... 9-5
9.3
Who Participates in the Portal Life Cycle? .............................................................................. 9-6
9.4
Understanding the Build and Test Environments ................................................................. 9-6
9.5
Understanding the Staging and Production Environments ................................................. 9-7
9.5.1
Provisioning the Staging Environment ............................................................................ 9-8
9.5.2
Adding Content to the Staging Environment.................................................................. 9-9
9.5.3
Moving the Portal from Staging to Production............................................................... 9-9
9.6
Tools for Managing the Life Cycle ........................................................................................... 9-9
9.7
Configuring a Nightly Build Script ....................................................................................... 9-10
9.8
Setting Up a Staging or Production Environment for the First Time............................... 9-11
9.9
Moving a WebCenter Portal Application to an Existing Environment ........................... 9-11
9.10
Deploying to Managed Servers.............................................................................................. 9-11
9.11
Deploying and Configuring the Application on Targeted Servers .................................. 9-11
9.11.1
Introduction ....................................................................................................................... 9-12
9.11.2
Using the Deploy and Configure Script ........................................................................ 9-12
9.12
Building and Deploying WebCenter Personalization Service Files ................................. 9-14
9.12.1
Building the WCPS MAR File ......................................................................................... 9-14
9.12.2
Deploying WCPS Files to a Server ................................................................................. 9-16
9.12.3
Deploying WCPS Files to an Archive File..................................................................... 9-16
9.12.4
Importing and Exporting MAR Files ............................................................................. 9-17
9.13
Using the Propagation Tool to Propagate From Staging to Production .......................... 9-17
9.13.1
Introduction to the Propagation Tool ............................................................................ 9-17
9.13.2
Configuring the Propagation Tool ................................................................................. 9-19
9.13.2.1
Configuring the URL Connection With Oracle Enterprise Manager................. 9-19
9.13.2.2
Configuring the URL Connection with WLST ...................................................... 9-20
9.13.3
Propagating Portal Metadata .......................................................................................... 9-21
9.13.4
Propagating WCPS Files .................................................................................................. 9-21

vii

9.14
Propagating UCM Content.....................................................................................................
9.15
Managing Security Through the Life Cycle .........................................................................
9.15.1
Migrating Security Policies for First-Time Deployment .............................................
9.15.2
Migrating Security Policies On Redeployment ............................................................
9.15.3
Migrating Credentials for First-Time Deployment......................................................
9.15.4
Migrating Credentials On Redeployment.....................................................................
9.16
Migrating Portlet Preferences ................................................................................................

10

Building a Navigation Model for Your Portal
10.1
Introduction to Navigation Models ......................................................................................
10.2
Creating a Navigation Model.................................................................................................
10.3
Adding Resources to a Navigation Model ...........................................................................
10.3.1
How to Drag and Drop a Resource onto a Navigation Model ..................................
10.3.2
How to Add a Content Item to a Navigation Model...................................................
10.3.3
How to Add Content Based on the Results of a Query to a Navigation Model......
10.3.4
How to Add a Page, Portlet, Task Flow, External Application, or Web Page to a
Navigation Model 10-9
10.3.5
How to Add a Page Hierarchy to a Navigation Model.............................................
10.3.6
How to Embed Another Navigation Model Within a Navigation Model .............
10.3.7
How to Extend Navigation Model Data......................................................................
10.3.7.1
How to Add a Link to a Custom Resource ..........................................................
10.3.7.2
How to Add a Component to a Navigation Model............................................
10.3.7.3
How to Add a Custom Folder to a Navigation Model ......................................
10.3.7.4
How to Add a Custom Content Provider to a Navigation Model ...................
10.3.8
How to Organize Resources in a Navigation Model.................................................
10.3.9
How to Set Display Options for a Resource ...............................................................
10.4
Selecting the Default Navigation Model ............................................................................
10.5
Editing the Navigation Renderer.........................................................................................
10.6
Setting the REDIRECT_OPTIONS Context Parameter.....................................................
10.7
Enabling Runtime Administration of Navigation Models ..............................................
10.7.1
How to Edit the Navigation Registry File...................................................................
10.7.2
How to Enable Further Development of Deployed Navigation Models................
10.7.2.1
Importing a Navigation Model..............................................................................
10.7.2.2
Exporting a Navigation Model ..............................................................................
10.8
Working with WebCenter Spaces Navigation Models.....................................................

11

9-22
9-22
9-22
9-23
9-23
9-23
9-23

10-1
10-2
10-4
10-5
10-5
10-7

10-13
10-15
10-16
10-17
10-18
10-20
10-21
10-23
10-23
10-25
10-26
10-27
10-27
10-28
10-28
10-29
10-29
10-29

Designing the Look and Feel of Your Portal
11.1
Introduction to Page Templates and Styles.......................................................................... 11-1
11.1.1
Page Templates ................................................................................................................. 11-2
11.1.2
Page Styles ......................................................................................................................... 11-4
11.1.3
Mashup Styles ................................................................................................................... 11-6
11.1.4
Content Presenter Display Templates ........................................................................... 11-7
11.2
Working with Page Templates............................................................................................... 11-7
11.2.1
Introduction to the WebCenter Portal Application Seeded Page Templates........... 11-8
11.2.2
How to Create a Page Template ..................................................................................... 11-9
11.2.3
What You Should Know About Creating Page Templates for WebCenter Portal
Applications 11-14

viii

11.2.4
Enabling Runtime Switching of Page Templates ....................................................... 11-15
11.2.5
How to Edit a Page Template ....................................................................................... 11-16
11.2.6
How to Delete a Page Template ................................................................................... 11-17
11.2.7
How to Enable Runtime Administration of a Page Template ................................. 11-17
11.2.8
How to Enable Further Development of Deployed Page Templates...................... 11-17
11.2.8.1
Importing a Page Template.................................................................................... 11-18
11.2.8.2
Exporting a Page Template .................................................................................... 11-18
11.2.9
How to Create and Manage WebCenter Spaces Page Templates............................ 11-19
11.3
Working with Page Styles..................................................................................................... 11-19
11.3.1
How to Create a Page Style ........................................................................................... 11-20
11.3.2
How to Enable Runtime Administration of a Page Style ......................................... 11-22
11.3.3
How to Enable Further Development of Deployed Page Styles.............................. 11-23
11.3.3.1
Importing a Page Style............................................................................................ 11-23
11.3.3.2
Exporting a Page Style ............................................................................................ 11-24
11.3.4
How to Create and Manage WebCenter Spaces Page Styles .................................. 11-24
11.4
Working with Mashup Styles............................................................................................... 11-25
11.4.1
How to Create a Mashup Style ..................................................................................... 11-26
11.4.2
How to Enable Runtime Administration of Mashup Styles..................................... 11-28
11.4.3
How to Enable Further Development of Mashup Styles in a Deployed Application .......
11-29
11.4.3.1
Importing Mashup Styles ....................................................................................... 11-29
11.4.3.2
Exporting Mashup Styles ....................................................................................... 11-30
11.4.4
How to Create and Manage WebCenter Spaces Mashup Styles ............................ 11-30

12

Adding Resources to Your Portal
12.1
12.2
12.3
12.4
12.5
12.6
12.7
12.8

13

Adding Pages to Your Portal..................................................................................................
Adding Service Task Flows to Your Portal ..........................................................................
Adding Custom Task Flows to Your Portal.........................................................................
Adding Content from Oracle Content Server to Your Portal............................................
Adding Portlets to Your Portal ..............................................................................................
Adding Pagelets to Your Portal .............................................................................................
Adding External Applications to Your Portal .....................................................................
Adding Data Controls to Your Portal ...................................................................................

12-1
12-2
12-3
12-3
12-4
12-4
12-5
12-5

Visualizing Your Portal Navigation
13.1
Introduction to Navigation Visualization ............................................................................
13.2
Adding Built-in Navigation Task Flows to a Page Template............................................
13.2.1
How to Add a Navigation Task Flow to a Page Template .........................................
13.2.2
Navigation Task Flow Parameters .................................................................................
13.2.3
What You May Need to Know About Navigation Task Flow Style Classes ...........
13.3
Programmatically Adding Navigation to a Page Template ..............................................
13.3.1
Using the Navigation Expression Language APIs.......................................................
13.3.1.1
Introduction to the Navigation Context.................................................................
13.3.1.2
Introduction to the Navigation Runtime Model .................................................
13.3.1.3
Introduction to the Navigation Resource.............................................................
13.3.1.4
How to Render the Navigation Model as a List of Links ..................................

13-1
13-2
13-3
13-4
13-7
13-7
13-8
13-8
13-10
13-12
13-13

ix

13.3.1.5
How to Render the Navigation Model as a Tree ................................................
13.3.1.6
How to Render the Navigation Model as a Three-Level Menu........................
13.3.1.7
How to Render the Navigation Model as Breadcrumbs....................................
13.3.1.8
How to Render Master-Detail Navigation...........................................................
13.3.2
Using the Navigation REST APIs .................................................................................
13.4
Using Portal Navigation to Create a Sitemap ....................................................................

13-14
13-15
13-16
13-17
13-18
13-20

14 Creating and Managing Skins
14.1
Overview of Skins....................................................................................................................
14.2
Creating a Skin in JDeveloper ................................................................................................
14.2.1
What You Should Know About Skin Creation.............................................................
14.2.2
How to Create a CSS File.................................................................................................
14.2.3
How to Define Skin Selectors..........................................................................................
14.3
Editing portal-skin.css.............................................................................................................
14.3.1
What You Should Know About portal-skin.css ...........................................................
14.3.2
How to Edit portal-skin.css .............................................................................................
14.4
Enabling Runtime Administration of Skins .........................................................................
14.4.1
What You Should Know About Enabling Runtime Administration of Skins .........
14.4.2
How to Enable Runtime Administration of a Skin ......................................................
14.4.3
How to Enable Further Development of Deployed Skins ..........................................
14.4.3.1
Importing a Skin ........................................................................................................
14.4.3.2
Exporting a Skin.......................................................................................................
14.4.4
Creating a Skin in JDeveloper and Making it Available at Runtime .....................
14.4.5
How to Create and Manage Skins at Runtime ...........................................................
14.5
Applying Skins to WebCenter Portal Applications ..........................................................
14.5.1
Applying a Skin at Design Time...................................................................................
14.5.2
Applying a Skin at Runtime..........................................................................................
14.6
How to Create and Manage WebCenter Spaces Skins .....................................................
14.7
Deploying a Skin as a Separate Shared Library ...............................................................
14.7.1
About Skin Sharing.........................................................................................................
14.7.2
How to Deploy a Skin as a Separate Shared Library.................................................
14.8
Conditionally Changing Skins for Users ............................................................................
14.9
Troubleshooting Problems with Skins................................................................................
14.10 Files Relates to Skins..............................................................................................................
14.10.1
adf-config.xml .................................................................................................................
14.10.2
trinidad-config.xml.........................................................................................................
14.10.3
trinidad-skins.xml...........................................................................................................

15

Creating and Managing Resource Catalogs
15.1
Overview of Resource Catalog...............................................................................................
15.2
Creating a Custom Resource Catalog ...................................................................................
15.2.1
How to Create a Custom Resource Catalog..................................................................
15.2.2
How to Define Connections to Resources.....................................................................
15.2.3
How to Manage Content in the Resource Catalog.......................................................
15.2.3.1
Adding a Folder.........................................................................................................
15.2.3.2
Adding a Link ............................................................................................................
15.2.3.3
Adding a Resource Catalog ...................................................................................

x

14-1
14-2
14-2
14-3
14-4
14-4
14-4
14-5
14-6
14-6
14-8
14-8
14-9
14-10
14-10
14-11
14-11
14-11
14-12
14-12
14-13
14-13
14-14
14-15
14-16
14-17
14-17
14-18
14-18

15-1
15-4
15-4
15-6
15-6
15-7
15-8
15-11

15.2.3.4
15.2.3.5
15.2.3.6
15.2.3.7
15.2.3.8
15.2.3.9
15.2.3.10
15.2.4
15.2.5
15.2.6
15.2.7
15.2.8
15.2.9

Adding a Component ............................................................................................. 15-11
Adding a Custom Folder........................................................................................ 15-12
Adding a Custom Content Provider..................................................................... 15-13
Dragging and Dropping a Resource into the Catalog........................................ 15-14
Editing a Resource................................................................................................... 15-15
Deleting a Resource................................................................................................. 15-15
Rearranging Resources in the Catalog ................................................................. 15-15
How to Expose Data Controls Created at Design Time............................................ 15-16
How to Expose Data Controls Created at Runtime ................................................... 15-18
How to Control Visibility of Portlets in the Resource Catalog ................................ 15-18
How to Configure the Default Resource Catalog for an Application or Page....... 15-20
What You May Need to Know When Defining a Resource Catalog....................... 15-20
How to Define Task Flow Parameters and Attributes of the Enclosing Show Detail
Frames for Task Flows 15-21
15.3
Managing a Resource Catalog and Enabling Runtime Administration ........................ 15-22
15.3.1
Managing Resource Manager Entries.......................................................................... 15-22
15.3.2
Enabling Further Development of Deployed Resource Catalogs............................ 15-22
15.3.2.1
Exporting a Resource Catalog ............................................................................... 15-23
15.3.2.2
Importing a Resource Catalog ............................................................................... 15-23
15.3.3
Working with WebCenter Spaces Resource Catalogs ............................................... 15-24
15.4
Filtering Items in the Resource Catalog.............................................................................. 15-24
15.4.1
Resource-Level Filtering ................................................................................................ 15-24
15.4.2
Catalog-Level Filtering .................................................................................................. 15-24
15.5
Configuring Multiple Resource Catalogs........................................................................... 15-26
15.5.1
How to Configure Multiple Resource Catalogs ......................................................... 15-26
15.5.2
What Happens at Runtime ............................................................................................ 15-28
15.6
Troubleshooting Problems with the Resource Catalog .................................................... 15-29

16

Adding and Using the Resource Manager
16.1
Introduction to Runtime Resource Management................................................................
16.2
Working with Portal Resources in JDeveloper....................................................................
16.2.1
How to Add a Resource to the Resource Manager......................................................
16.2.2
What You May Need to Know About Portal Resource Images and Style Sheets ...
16.2.3
How to Update Portal Resource Properties..................................................................
16.2.4
How to Remove a Resource from the Resource Manager ..........................................
16.3
Enabling Runtime Administration of Your Portal ..............................................................
16.3.1
How to Add the Resource Manager Task Flow ...........................................................
16.3.2
How to Use the Resource Manager at Runtime ...........................................................
16.3.2.1
Accessing the Resource Manager............................................................................
16.3.2.2
Creating a Resource...................................................................................................
16.3.2.3
Uploading and Downloading a Resource............................................................
16.3.2.4
Editing a Resource...................................................................................................
16.3.2.5
Copying a Resource.................................................................................................
16.3.2.6
Setting Security for a Resource ..............................................................................
16.3.2.7
Deleting a Resource.................................................................................................
16.3.2.8
Showing or Hiding a Resource..............................................................................
16.3.2.9
Editing the Source Code of a Resource ................................................................

16-1
16-3
16-3
16-5
16-6
16-6
16-6
16-7
16-7
16-9
16-9
16-10
16-10
16-11
16-11
16-12
16-12
16-12

xi

16.3.2.10
Setting Properties on a Resource...........................................................................
16.3.2.11
Previewing a Resource............................................................................................
16.4
Enabling Round-Trip Development of Resources ...