Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces, 11g Release 1 (11.1.1.5.0)

11g Release 1 (11.1.1.5.0)

E10149-09

Contents

Title and Copyright Information

Preface

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

What's New

- Issues Addressed in Release 11.1.1.5.0

Part I Getting Started with WebCenter

1 Introducing WebCenter Spaces

- 1.1 Understanding Portals, Communities, and Social Networking Sites

- 1.1.1 What Is a Portal?

- 1.1.2 What Is a Community?

- 1.1.3 What Is a Social Networking Site?

- 1.2 Planning Your Portals, Communities, and Social Networking Sites

- 1.2.1 Planning a Home Space to Serve All Users

- 1.2.2 Planning Multiple Portals Serving All LOBs

- 1.2.3 Planning a Department Portal

- 1.2.4 Planning a Department Portal with Diverse Collaborative Teams and Communities

- 1.2.5 Planning a Division Portal with Teams, Communities, and Social Networks

- 1.3 Where to Look for More Information

2 Leveraging Content Management

- 2.1 What Is Content Management?

- 2.2 Leveraging Content Management Features

- 2.2.1 Displaying Individual Files

- 2.2.2 Displaying and Managing the Contents of a Folder

- 2.2.3 Adding and Managing Document Workflow

- 2.2.4 Creating and Managing Content at Runtime

- 2.2.5 Collaborating on Documents

- 2.2.6 Integrating with Microsoft Office and Explorer

- 2.2.7 Adding and Managing Wikis

- 2.2.8 Adding and Managing Blogs

3 Leveraging Social and Collaborative Services

- 3.1 What Is Social Networking?

- 3.2 What Are Communities and Teams?

- 3.3 Leveraging Social and Collaborative Features and Services

- 3.3.1 What Are Social Networking and Collaborative Services?

- 3.3.2 Leveraging People Connections

- 3.3.3 Leveraging Announcements, Discussions, and Events

- 3.3.4 Leveraging Liking, Commenting, and Sharing

- 3.3.5 Leveraging Instant Messaging and Presence

- 3.3.6 Leveraging Polls and Activity Graph

- 3.3.7 Leveraging Tagging and Linking

- 3.3.8 Leveraging Wikis and Blogs

- 3.3.9 Leveraging Lists

4 Accessing WebCenter Spaces Administration Pages

- 4.1 Accessing the WebCenter Administration Page

- 4.2 Performing Actions From WebCenter Spaces Administration Pages

Part II Designing a Portal or Community

5 Configuring Global Defaults

- 5.1 Customizing the Name and Logo

- 5.2 Customizing Copyright and Privacy Statements

- 5.3 Customizing the Online Help Link

- 5.4 Choosing a Default Display Language

- 5.5 Customizing the Language List

- 5.6 Choosing a Default Start (or Landing) Page

- 5.7 Choosing a Default Skin

- 5.8 Choosing a Default Page Template

- 5.9 Choosing a Default Navigation

- 5.10 Choosing Default Resource Catalogs

- 5.11 Choosing a Default Look and Feel for New Pages

- 5.12 Enabling and Disabling Access to the Home Space

- 5.13 Setting up Defaults for WebCenter Services

6 Configuring Services, Portlet Producers, and External Applications

- 6.1 Enabling and Disabling WebCenter Services

- 6.2 Configuring Discussion Forum Options for WebCenter Spaces

- 6.2.1 Accessing the Discussions Server Admin Console

- 6.2.2 Specifying Where Discussions and Announcements are Stored on the Discussions Server

- 6.2.3 Choosing How Many Discussion Topics to Save In Space Templates

- 6.3 Configuring Send Mail Notifications for WebCenter Spaces

- 6.3.1 Enabling Shared Mail Connections for Send Mail Notifications

- 6.4 Configuring People Connections Defaults for WebCenter Spaces

- 6.4.1 What You Should Know About Administering the People Connections Service

- 6.4.2 People Connections Prerequisites

- 6.4.3 Configuring the People Connections Service for WebCenter Spaces

- 6.4.3.1 Accessing People Connections Administrative Settings

- 6.4.3.2 Configuring Activity Stream

- 6.4.3.3 Configuring Connections

- 6.4.3.4 Configuring Profile

- 6.4.3.5 Configuring Message Board

- 6.4.3.6 Configuring Feedback

- 6.4.4 Archiving the Activity Stream Schema

- 6.4.5 Troubleshooting Issues with the People Connections Service

- 6.4.5.1 Troubleshooting Activity Stream

- 6.4.5.2 Troubleshooting Connections

- 6.4.5.3 Troubleshooting Profile

- 6.4.5.4 Troubleshooting Message Board

- 6.4.5.5 Troubleshooting Feedback

- 6.5 Registering Portlet Producers

- 6.5.1 What You Should Know About Registering Portlet Producers

- 6.5.2 Registering Portlet Producers Through WebCenter Administration

- 6.5.2.1 Registering a WSRP Producer

- 6.5.2.2 Registering an Oracle PDK-Java Producer

- 6.5.2.3 Registering a Pagelet Producer

- 6.5.3 Working with the Producer Registration Task Flow

- 6.5.3.1 Adding the Producer Registration Task Flow to a Page

- 6.5.3.2 Registering Producers Through the Producer Administration Task Flow

- 6.5.3.3 Setting Producer Task Flow Properties

- 6.5.4 Deregistering Portlet Producers

- 6.6 Registering External Applications

- 6.6.1 What You Should Know About External Applications

- 6.6.2 Registering External Applications Through WebCenter Administration

- 6.6.3 Working with Task Flows for External Applications

- 6.6.3.1 Adding an External Application Task Flow to a Page

- 6.6.3.2 Registering External Applications Through the External Application Task Flow

- 6.6.3.3 Adding an Application Navigator Task Flow to a Page

- 6.6.3.4 Making External Applications Available through the Application Navigator Task Flow

- 6.6.3.5 Setting External Application Task Flow Properties

- 6.6.4 Deleting External Applications

7 Preparing Your Initial Portal Pages

- 7.1 Working with Business Role Pages

- 7.1.1 What You Should Know About Business Role Pages

- 7.1.2 Setting Page Creation Defaults for Business Role Pages

- 7.1.3 Creating a Business Role Page

- 7.1.4 Specifying the Target Audience for a Business Role Page

- 7.1.4.1 Setting Access on a Business Role Page

- 7.1.4.2 Providing Public Access to a Business Role Page

- 7.1.5 Revoking Access to a Business Role Page

- 7.1.6 Adding Business Role Pages to Navigation

- 7.1.7 Setting a Default Display Order for Business Role Pages

- 7.1.8 Editing a Business Role Page

- 7.1.9 Copying a Business Role Page

- 7.1.10 Deleting a Business Role Page

- 7.2 Working with Personal Pages

- 7.2.1 What You Should Know About Personal Page Administration

- 7.2.2 Setting Application-Level Page Creation Defaults for Personal Pages

- 7.2.3 Changing Access Permissions on a Personal Page

- 7.2.4 Preventing Users From Creating Personal Pages

- 7.2.5 Adding Personal Pages to Navigation

- 7.2.6 Editing Personal Pages with Administrative Privileges

- 7.2.7 Copying a Personal Page

- 7.2.8 Deleting a Personal Page Through Space Administration

- 7.3 Working with System Pages

- 7.3.1 What You Should Know About System Pages

- 7.3.2 Customizing System Pages

- 7.3.2.1 What You Should Know About System Page Customization

- 7.3.2.2 Customizing an Application-Level System Page

- 7.3.2.3 Customizing a Space-Level System Page

- 7.3.3 Removing All Page Customizations from a System Page

8 Customizing Task Flows

- 8.1 What You Should Know About Task Flow Customization

- 8.2 Customizing Task Flows at the Application Level

- 8.3 Customizing Task Flows at the Space Level

- 8.4 Customizing Seeded Task Flows Using the Task Flow Editor Page

- 8.5 Removing Task Flow Customizations

Part III Personalizing Your Portal

9 Using WebCenter Personalization

- 9.1 Introduction to WebCenter Personalization

- 9.2 Driving Content Using WebCenter Personalization

- 9.3 Driving Portal Look and Feel Using WebCenter Personalization

Part IV Building a Portal or Community

10 Working with the Resources that Compose a Portal or Community

- 10.1 What You Should Know About Resources

- 10.1.1 Introducing Resources

- 10.1.2 Understanding Application-Level and Space-Level Resources

- 10.1.3 Permissions Required to Work with Resources

- 10.1.4 Accessing Resources

- 10.1.4.1 Accessing Application-Level Resources

- 10.1.4.2 Accessing Space-Level Resources

- 10.1.5 Viewing Information About a Resource

- 10.2 Creating Resources

- 10.2.1 What You Should Know About Resource Creation

- 10.2.2 Creating a Resource

- 10.3 Editing Resources

- 10.3.1 What You Should Know about Resource Editing

- 10.3.2 Editing the Source Code of a Resource

- 10.3.3 Editing a Resource by Using the Edit Dialog

- 10.4 Managing Resources

- 10.4.1 Copying a Resource

- 10.4.2 Setting Properties on a Resource

- 10.4.2.1 What You Should Know About a Resource's Properties

- 10.4.2.2 Accessing the Edit Properties Dialog of a Resource

- 10.4.2.3 Renaming, Describing, and Categorizing a Resource

- 10.4.2.4 Associating an Icon with a Resource

- 10.4.2.5 Setting the Availability of an Application-Level Resource in Other Spaces

- 10.4.2.6 Working with the Attributes of a Resource

- 10.4.2.6.1 Associating an Attribute with a Resource

- 10.4.2.6.2 Deleting an Attribute of a Resource

- 10.4.3 Showing and Hiding Resources

- 10.4.3.1 What You Should Know About Showing and Hiding Resources

- 10.4.3.2 Showing a Resource

- 10.4.3.3 Hiding a Resource

- 10.4.4 Setting Security for a Resource

- 10.4.5 Deleting a Resource

- 10.4.6 Previewing a Resource

- 10.4.7 Querying for a Resource Through the Expression Builder

- 10.4.8 Applying Resources Dynamically Using EL Expressions

- 10.5 Using JDeveloper to Build WebCenter Spaces Resources

- 10.5.1 What You Should Know About Building Spaces Resources in JDeveloper

- 10.5.2 Downloading a Resource

- 10.5.3 Uploading a Resource

11 Working with Navigation

- 11.1 What You Should Know About Navigation

- 11.1.1 What You Should Know About Navigation Models

- 11.1.2 What You Should Know About Navigation Visualization

- 11.2 Building a Navigation Model

- 11.2.1 Creating a Navigation Model

- 11.2.2 Editing a Navigation Model

- 11.2.2.1 Adding Resources to a Navigation Model Using the Edit Dialog

- 11.2.2.1.1 Adding a Document to a Navigation Model

- 11.2.2.1.2 Adding Content Based on the Results of a Query to a Navigation Model

- 11.2.2.1.3 Adding a Spaces Page, Portlet, Task Flow, External Application, or Web Page to a Navigation Model

- 11.2.2.1.4 Adding a List of Pages to a Navigation Model

- 11.2.2.1.5 Adding a List of Subspaces to a Navigation Model

- 11.2.2.1.6 Nesting a Navigation Model Within a Navigation Model

- 11.2.2.1.7 Organizing Navigation Items in a Navigation Model

- 11.2.2.1.8 Setting Display Options for Navigation Items

- 11.2.2.2 Editing the Source Code of a Navigation Model

- 11.2.3 Managing a Navigation Model

- 11.2.3.1 Showing and Hiding a Navigation Model

- 11.2.3.2 Setting Properties on a Navigation Model

- 11.2.3.3 Setting Security on a Navigation Model

- 11.2.3.4 Copying a Navigation Model

- 11.2.3.5 Deleting a Navigation Model

- 11.2.4 Selecting the Default Navigation Model

- 11.2.5 Using JDeveloper to Build Your Navigation Model

- 11.3 Rendering Navigation in Your Portal

- 11.3.1 Adding Built-in Navigation Task Flows to Page Templates

- 11.3.2 Setting Navigation Task Flow Properties

- 11.3.2.1 What You Should Know About Navigation Task Flow Properties

- 11.3.2.2 Navigation Task Flow Parameters

- 11.3.2.3 Using Properties to Configure Navigation Task Flow Instances

- 11.3.2.3.1 Sample Navigation Model

- 11.3.2.3.2 Selecting the Start Path for Your Navigation

- 11.3.2.3.3 Rendering Navigation as a Tree

- 11.3.2.3.4 Rendering Navigation as a Menu

- 11.3.2.3.5 Rendering Navigation as Breadcrumbs

- 11.3.2.3.6 Linking Navigation Task Flows

- 11.3.3 Using JDeveloper to Visualize Your Navigation

- 11.4 AviTrust Employee Portal: An Example of Delegated Navigation

12 Working with Page Templates

- 12.1 What You Should Know About Page Templates

- 12.1.1 Out-of-the-Box Page Templates

- 12.2 Creating a Page Template

- 12.3 Editing a Page Template

- 12.3.1 Editing a Page Template in Oracle Composer

- 12.3.2 Editing the Source Code of a Page Template

- 12.4 Customizing a Page Template for a Space

- 12.5 Managing a Page Template

- 12.5.1 Showing and Hiding a Page Template

- 12.5.2 Setting Properties on a Page Template

- 12.5.3 Setting Security on a Page Template

- 12.5.4 Copying a Page Template

- 12.5.5 Deleting a Page Template

- 12.5.6 Previewing a Page Template

- 12.6 Applying a Page Template to a Space

- 12.7 Choosing the Page Template Resource Catalog

- 12.8 Using JDeveloper to Build Your Page Templates

13 Adding Spaces Components to Your Templates

- 13.1 Making Spaces Components Available

- 13.1.1 Adding Spaces Components to a Resource Catalog

- 13.1.2 Specifying the Resource Catalogs to Use for Space and Page Templates

- 13.1.3 Adding Spaces Components to a Template

- 13.1.4 Adding Spaces Components to a Page

- 13.2 Working with Spaces Component Properties

- 13.2.1 Accessing Spaces Component Properties

- 13.2.2 About Space

- 13.2.2.1 About Space Component Display Options

- 13.2.2.2 About Space Component Tag and XML

- 13.2.3 About WebCenter

- 13.2.3.1 About WebCenter Component Display Options

- 13.2.3.2 About WebCenter Component Tag and XML

- 13.2.4 Add to Favorites

- 13.2.4.1 Add to Favorites Component Display Options

- 13.2.4.2 Add to Favorites Component Tag and XML

- 13.2.5 Administration

- 13.2.5.1 Administration Component Display Options

- 13.2.5.2 Administration Component Tag and XML

- 13.2.6 Change Membership

- 13.2.6.1 Change Membership Component Display Options

- 13.2.6.2 Change Membership Component Tag and XML

- 13.2.7 Contact Administration

- 13.2.7.1 Contact Administration Component Display Options

- 13.2.7.2 Contact Administration Component Tag and XML

- 13.2.8 Copyright Message

- 13.2.8.1 Copyright Message Component Display Options

- 13.2.8.2 Copyright Message Component Tag and XML

- 13.2.9 Create Page

- 13.2.9.1 Create Page Component Display Options

- 13.2.9.2 Create Page Component Tag and XML

- 13.2.10 Create Space

- 13.2.10.1 Create Space Component Display Options

- 13.2.10.2 Create Space Component Tag and XML

- 13.2.11 Create Subspace

- 13.2.11.1 Create Subspace Component Display Options

- 13.2.11.2 Create Subspace Component Tag and XML

- 13.2.12 Current User Profile

- 13.2.12.1 Current User Profile Component Display Options

- 13.2.12.2 Current User Profile Component Tag and XML

- 13.2.13 Edit Page

- 13.2.13.1 Edit Page Component Display Options

- 13.2.13.2 Edit Page Component Tag and XML

- 13.2.14 Favorites Menu

- 13.2.14.1 Favorites Menu Component Display Options

- 13.2.14.2 Favorites Menu Component Tag and XML

- 13.2.15 Global Help

- 13.2.15.1 Global Help Component Display Options

- 13.2.15.2 Global Help Component Tag and XML

- 13.2.16 Home Space

- 13.2.16.1 Home Space Component Display Options

- 13.2.16.2 Home Space Component Tag and XML

- 13.2.17 Invite People as Connection

- 13.2.17.1 Invite People as Connection Component Display Options

- 13.2.17.2 Invite People as Connection Component Tag and XML

- 13.2.18 Join Space

- 13.2.18.1 Join Space Component Display Options

- 13.2.18.2 Join Space Component Tag and XML

- 13.2.19 Leave Space

- 13.2.19.1 Leave Space Component Display Options

- 13.2.19.2 Leave Space Component Tag and XML

- 13.2.20 Login

- 13.2.20.1 Login Component Display Options

- 13.2.20.2 Login Component Tag and XML

- 13.2.21 Logout

- 13.2.21.1 Logout Component Display Options

- 13.2.21.2 Logout Component Tag and XML

- 13.2.22 Mail Space Members

- 13.2.22.1 Mail Space Members Component Display Options

- 13.2.22.2 Mail Space Members Component Tag and XML

- 13.2.23 Mail Space Moderators

- 13.2.23.1 Mail Space Moderators Component Display Options

- 13.2.23.2 Mail Space Moderators Component Tag and XML

- 13.2.24 Manage Pages

- 13.2.24.1 Manage Pages Component Display Options

- 13.2.24.2 Manage Pages Component Tag and XML

- 13.2.25 Page Links

- 13.2.25.1 Page Links Component Display Options

- 13.2.25.2 Page Links Component Tag and XML

- 13.2.26 Parent Space

- 13.2.26.1 Parent Space Component Display Options

- 13.2.26.2 Parent Space Component Tag and XML

- 13.2.27 Print Preview

- 13.2.27.1 Print Preview Component Display Options

- 13.2.27.2 Print Preview Component Tag and XML

- 13.2.28 Privacy URL

- 13.2.28.1 Privacy URL Component Display Options

- 13.2.28.2 Privacy URL Component Tag and XML

- 13.2.29 RSS

- 13.2.29.1 RSS Component Display Options

- 13.2.29.2 RSS Component Tag and XML

- 13.2.30 Search

- 13.2.31 Self Registration

- 13.2.31.1 Self Registration Component Display Options

- 13.2.31.2 Self Registration Component Tag and XML

- 13.2.32 Share Resource

- 13.2.32.1 Share Resource Display Options

- 13.2.32.2 Share Resource Component Tag and XML

- 13.2.33 Spaces Switcher

- 13.2.33.1 Spaces Switcher Component Display Options

- 13.2.33.2 Spaces Switcher Component Tag and XML

- 13.2.34 Status Indicator

- 13.2.34.1 Status Indicator Component Display Options

- 13.2.34.2 Status Indicator Component Tag and XML

- 13.2.35 Subscription Preferences

- 13.2.35.1 Subscription Preferences Component Display Options

- 13.2.35.2 Subscription Preferences Component Tag and XML

- 13.2.36 Tags

- 13.2.36.1 Tags Component Display Options

- 13.2.36.2 Tags Component Tag and XML

- 13.2.37 User Preferences

- 13.2.37.1 User Preferences Component Display Options

- 13.2.37.2 User Preferences Component Tag and XML

- 13.3 Deleting Spaces Components

- 13.3.1 Removing Spaces Components from a Resource Catalog

- 13.3.2 Removing a Spaces Component from a Template

- 13.3.3 Removing a Spaces Component from a Page

14 Working with Skins

- 14.1 What You Should Know About Skins

- 14.2 Creating a Skin

- 14.3 Editing a Custom Skin

- 14.3.1 What You Should Know About Skin Editing

- 14.3.1.1 About Source Code Editing

- 14.3.1.2 About Simple Editing

- 14.3.2 Editing the Source Code of a Custom Skin

- 14.3.3 Editing a Custom Skin Using the Edit Dialog

- 14.4 Managing a Skin

- 14.4.1 Showing and Hiding a Skin

- 14.4.2 Setting Properties on a Skin

- 14.4.2.1 What You Should Know About Skin Properties

- 14.4.2.2 Naming, Describing, and Categorizing a Custom Skin

- 14.4.2.3 Associating an Icon with a Custom Skin

- 14.4.2.4 Setting the Availability of an Application-Level Custom Skin

- 14.4.2.5 Working with a Custom Skin's Attributes

- 14.4.3 Setting Security on a Skin

- 14.4.4 Copying a Skin

- 14.4.5 Deleting a Skin

- 14.4.6 Viewing Information About a Skin

- 14.5 Applying a Skin

- 14.5.1 Applying a Skin to WebCenter Spaces

- 14.5.2 Applying a Skin to a Space

- 14.5.3 Applying a Skin to Your Home Space

- 14.6 Using JDeveloper to Build Your Skins

15 Working with Page Styles

- 15.1 What You Should Know About Page Styles

- 15.2 Creating a Custom Page Style

- 15.3 Editing the Source Code of a Custom Page Style

- 15.3.1 What You Should Know About Editing Page Style Source

- 15.3.2 Editing Custom Page Style Source

- 15.4 Managing Page Styles

- 15.4.1 Showing and Hiding a Page Style in the Create Page Dialog

- 15.4.2 Setting Properties on a Custom Page Style

- 15.4.3 Setting Security on a Custom Page Style

- 15.4.4 Copying a Page Style

- 15.4.5 Deleting a Custom Page Style

- 15.4.6 Previewing a Page Style

- 15.5 Applying a Page Style

- 15.6 Using JDeveloper to Build Your Page Style

16 Working with Resource Catalogs

- 16.1 What You Should Know About Resource Catalogs

- 16.1.1 Understanding the Out-of-the-Box Resource Catalogs

- 16.1.1.1 Default Home Space Catalog

- 16.1.1.2 Default Space Catalog

- 16.1.1.3 Default Page Template Catalog

- 16.1.2 Introducing the Resource Catalog Management Page

- 16.1.3 Understanding the Resource Registry

- 16.2 Creating Resource Catalogs

- 16.3 Editing a Resource Catalog

- 16.3.1 Managing Resources in the Edit Dialog

- 16.3.1.1 Creating a Folder

- 16.3.1.2 Adding Resources

- 16.3.1.3 Creating Custom Components

- 16.3.1.4 Rearranging Resources

- 16.3.1.5 Setting Properties on a Resource

- 16.3.1.6 Copying a Resource

- 16.3.1.7 Deleting a Resource

- 16.3.1.8 Previewing the Resource Catalog

- 16.3.2 Editing the Source Code for a Resource Catalog

- 16.4 Showing and Hiding a Resource Catalog

- 16.5 Setting Properties on a Resource Catalog

- 16.6 Setting Security on a Resource Catalog

- 16.7 Copying a Resource Catalog

- 16.8 Deleting a Resource Catalog

- 16.9 Using JDeveloper to Build Your Resource Catalog

- 16.10 Configuring Resource Catalogs in Your Application

- 16.10.1 Configuring the Application-Level Resource Catalog

- 16.10.2 Configuring the Space-Level Resource Catalog

Part V Building and Wiring Pages

17 Building Pages

- 17.1 What You Should Know About Pages

- 17.2 Creating Pages

- 17.3 Editing Pages

- 17.3.1 Entering and Exiting Page Edit Mode

- 17.3.2 Introducing Design View and Source View

- 17.3.3 Accessing Portal Resources

- 17.3.4 Providing Page Background Color, Image, and CSS Encoding

- 17.3.5 Changing the Page Layout

- 17.3.5.1 What You Should Know About Page Layouts

- 17.3.5.2 Providing a Page Header and Footer

- 17.3.5.3 Adjusting the Widths of Page Columns

- 17.3.5.4 Adding New Content Regions

- 17.3.5.4.1 Enabling Box Splitting

- 17.3.5.4.2 Splitting a Layout Box

- 17.3.5.5 Creating Layered Content Regions Using Tabs

- 17.3.5.5.1 Enabling the Addition of Tabbed Content Regions

- 17.3.5.5.2 Adding Tabbed Content Regions

- 17.3.5.5.3 Creating a Tab Set

- 17.3.5.5.4 Reordering and Renaming Tabs

- 17.3.5.5.5 Adding an Icon to a Tab

- 17.3.5.5.6 Stretching Tab Content

- 17.3.5.5.7 Hiding and Showing Tabs

- 17.3.5.5.8 Deleting Tabs

- 17.4 Personalizing Pages

- 17.5 Adding Resource Catalog Components to Pages

- 17.5.1 Adding a Component to a Page

- 17.5.1.1 Adding a Component to a Page in Design View of Page Edit Mode

- 17.5.1.2 Adding a Component to a Page in Source View of Page Edit Mode

- 17.5.2 Setting Properties on Page Components

- 17.5.2.1 What You Should Know About Customizing Page Components

- 17.5.2.2 What You Should Know About Component Properties

- 17.5.2.3 Setting Component Properties

- 17.5.2.4 Working with Component Parameters

- 17.5.2.5 Working with Component Display Options

- 17.5.2.6 Working with Child Components

- 17.5.2.6.1 Hiding and Showing Child Components

- 17.5.2.6.2 Rearranging Child Components

- 17.5.2.7 Working with Style and Content Style Properties

- 17.5.2.7.1 Understanding Style and Content Style Properties

- 17.5.2.7.2 Style and Content Style Properties

- 17.5.2.7.3 Entering Other CSS

- 17.5.2.7.4 Using the Other CSS Property to Change Component Borders

- 17.5.2.8 Working with Component Contextual Events

- 17.6 Deleting Pages

18 Adding and Configuring Page Layout Components

- 18.1 Adding a Layout Component to a Page

- 18.2 Working with Layout Components

- 18.2.1 Setting Properties on a Layout Component

- 18.2.1.1 Setting Layout Component Properties in Design View

- 18.2.1.2 Setting Layout Component Properties in Source View

- 18.2.2 Working with the Box Layout Component

- 18.2.2.1 What You Should Know About the Box Layout Component

- 18.2.2.2 Setting Box Layout Component Properties

- 18.2.3 Working with the Movable Box Layout Component

- 18.2.3.1 What You Should Know About the Movable Box Layout Component

- 18.2.3.2 Setting Movable Box Layout Component Properties

- 18.2.4 Working with the HTML Markup Layout Component

- 18.2.4.1 What You Should Know About the HTML Markup Layout Component

- 18.2.4.2 Setting HTML Markup Layout Component Properties

- 18.2.4.3 Embedding Video, Music, Slides, and Other Types of Content

- 18.2.5 Working with the Links Layout Component

- 18.2.5.1 What You Should Know About the Links Layout Component

- 18.2.5.2 Configuring the Links Component

- 18.2.5.2.1 Adding Navigation Links

- 18.2.5.2.2 Configuring an Advanced Search for Content Links

- 18.2.5.2.3 Configuring a Link in the Links Component

- 18.2.5.2.4 Reordering Navigation Links

- 18.2.5.2.5 Deleting a Link from the Links Component

- 18.2.5.3 Setting Links Layout Component Properties

- 18.2.6 Working with the Hyperlink Layout Component

- 18.2.6.1 What You Should Know About the Hyperlink Layout Component

- 18.2.6.2 Setting Hyperlink Layout Component Properties

- 18.2.7 Working with the Image Layout Component

- 18.2.7.1 What You Should Know About the Image Layout Component

- 18.2.7.2 Setting Image Layout Component Properties

- 18.2.8 Working with the Text Layout Component

- 18.2.8.1 What You Should Know About the Text Layout Component

- 18.2.8.2 Setting Text Layout Component Properties

- 18.2.9 Working with the Web Page Layout Component

- 18.2.9.1 What You Should Know About the Web Page Layout Component

- 18.2.9.2 Setting Web Page Layout Component Properties

- 18.2.10 Working with Internal Layout Components

- 18.2.10.1 What You Should Know About Internal Layout Components

- 18.2.10.2 Setting panelGroupLayout Properties

- 18.2.10.3 Setting panelStretchLayout Properties

- 18.2.10.4 Setting panelTabbed Properties

- 18.2.10.5 Setting showDetailFrame Properties

- 18.2.10.6 Setting sidebarItem Properties

- 18.2.10.7 Setting spacer/Separator Properties

- 18.3 Deleting Layout Components

- 18.3.1 Deleting a Layout Component in Design View

- 18.3.2 Deleting a Layout Component in Source View

19 Wiring Pages, Task Flows, Portlets, and UI Components

- 19.1 What You Should Know About Parameter and Event Wiring

- 19.2 Wiring One Component to Another

- 19.2.1 Wiring a Task Flow to a Task Flow

- 19.2.2 Wiring a Portlet to a Portlet

- 19.2.3 Wiring a Portlet to a Task Flow

- 19.2.4 Wiring a Task Flow to a Portlet

- 19.2.5 Wiring a UI Component to a Task Flow

- 19.3 Wiring Components and Page Parameters

- 19.3.1 Creating Page Parameters

- 19.3.2 Consuming Page Parameters

- 19.4 Passing Parameter Values Through the Page URL

Part VI Securing Your Portal

20 Understanding WebCenter Spaces Security

- 20.1 Introduction to Security in WebCenter Spaces

- 20.2 Understanding Users

- 20.3 Understanding Application Roles and Permissions

- 20.3.1 Understanding Application Roles

- 20.3.1.1 Default Application Roles

- 20.3.1.2 Custom Application Roles

- 20.3.2 Understanding Application Permissions

- 20.3.2.1 Understanding the Default Permissions

- 20.3.2.2 Understanding Discussion Server Role Mapping

- 20.3.2.3 Understanding Enterprise Group Role Mapping

- 20.4 Understanding Roles and Permissions within a Space

- 20.5 Understanding Self-Registration

21 Managing Users, Roles, and Permissions

- 21.1 Managing Users

- 21.1.1 What You Need to Know About Managing Users

- 21.1.2 Assigning Users (and Groups) to Roles

- 21.1.3 Assigning a User to a Different Role

- 21.1.4 Giving a User Administrative Privileges

- 21.1.5 Revoking Application Roles

- 21.1.6 Adding or Removing Users

- 21.2 Managing Application Roles and Permissions

- 21.2.1 What You Need to Know About Application Roles and Permissions

- 21.2.2 Defining Application Roles

- 21.2.3 Modifying Application Role Permissions

- 21.2.4 Granting Permissions to the Public-User

- 21.2.5 Granting Permissions to the Authenticated-User

- 21.2.6 Deleting Application Roles

- 21.3 Troubleshooting Issues with Users and Roles

22 Enabling Self-Registration

- 22.1 What You Should Know About Self Registration

- 22.2 Enabling Self-Registration By Invitation-Only

- 22.3 Enabling Anyone to Self-Register

23 Securing Pages and Components

- 23.1 Setting Access on a Page

- 23.2 Setting Access on a Page Component

Part VII Working with Multilanguage Portals

24 Working with Multilanguage Portals

- 24.1 What You Should Know About Languages in WebCenter Spaces

- 24.1.1 Display Language Precedence

- 24.1.2 Languages Supported Out-of-the-Box by WebCenter Spaces

- 24.2 Configuring Language Options

- 24.3 Enabling Users to Choose a Language

- 24.3.1 Adding a Change Language Task Flow to a Page

- 24.3.2 Setting Change Language Task Flow Properties

- 24.3.2.1 What You Should Know About the Change Language Task Flow Properties

- 24.3.2.2 Change Language Task Flow Parameters

Part VIII Creating and Managing Portlets and Task Flows at Runtime

25 Understanding Portlet Basics

- 25.1 What Is a Portlet?

- 25.2 What Does a Portlet Look Like?

- 25.3 What Can I Do with Portlets?

- 25.4 What Kinds of Portlets Can I Use?

- 25.4.1 Prebuilt Portlets

- 25.4.2 JSF Portlets

- 25.4.3 Programmatic Portlets

- 25.4.4 Web Clipping

- 25.4.5 OmniPortlet

- 25.4.6 Parameter Form and Parameter Display Portlets

26 Creating Business Mashups

- 26.1 Introducing Business Mashups

- 26.1.1 Supported Data Controls

- 26.1.1.1 SQL Data Controls

- 26.1.1.2 Web Service Data Controls

- 26.1.2 Supported Visualizations

- 26.1.2.1 Table

- 26.1.2.2 Form

- 26.1.2.3 Graph

- 26.1.2.4 Button or Link

- 26.1.2.5 Text or Label

- 26.2 Creating and Managing Data Controls

- 26.2.1 Creating a SQL Data Control

- 26.2.1.1 Creating a Database Connection

- 26.2.1.2 Creating the Data Control

- 26.2.2 Creating a Web Service Data Control

- 26.2.2.1 Creating the Data Control

- 26.2.3 Managing Data Controls

- 26.2.3.1 Showing or Hiding a Data Control in the Resource Catalog

- 26.2.3.2 Copying Data Controls

- 26.2.3.3 Editing Data Controls

- 26.2.3.4 Editing Data Control Bind Variables

- 26.2.3.5 Setting Properties on a Data Control

- 26.2.3.6 Setting Security on a Data Control

- 26.2.3.7 Deleting Data Controls

- 26.2.4 Using Design-Time Data Controls

- 26.2.5 Exporting and Importing Data Controls Across Spaces

- 26.2.5.1 Steps You Must Perform After an Import

- 26.3 Creating and Managing Task Flows

- 26.3.1 Creating a Task Flow

- 26.3.2 Managing Task Flows

- 26.3.2.1 Showing or Hiding a Task Flow in the Resource Catalog

- 26.3.2.2 Copying a Task Flow

- 26.3.2.3 Editing a Task Flow

- 26.3.2.3.1 Editing a Task Flow in Oracle Composer

- 26.3.2.3.2 Editing a Task Flow's Source Files in a Text Editor

- 26.3.2.4 Previewing a Task Flow

- 26.3.2.5 Setting Properties on a Task Flow

- 26.3.2.6 Setting Security on a Task Flow

- 26.3.2.7 Deleting a Task Flow

- 26.3.2.8 Using JDeveloper to Modify a Task Flow

- 26.3.3 Using Task Flows Created at Design Time

- 26.3.4 Managing Mashup Styles

- 26.3.4.1 Out-of-the-Box Mashup Styles

- 26.3.4.2 Copying a Mashup Style

- 26.3.4.3 Showing or Hiding a Mashup Style in the Create Task Flow Dialog

- 26.3.4.4 Editing a Mashup Style

- 26.3.4.5 Previewing a Mashup Style

- 26.3.4.6 Setting Properties on a Mashup Style

- 26.3.4.7 Setting Security on a Mashup Style

- 26.3.4.8 Deleting a Mashup Style

- 26.3.4.9 Using JDeveloper to Build Your Mashup Style

- 26.4 Creating Data Visualizations

- 26.4.1 Consuming a Data Control in a Task Flow

- 26.4.1.1 Adding a Data Control as a Table

- 26.4.1.1.1 Adding a Data Control as a Read-Only Table

- 26.4.1.1.2 Adding a Data Control as an Editable Table

- 26.4.1.1.3 Adding a Web Services Data Control Accessor with Complex Parameters

- 26.4.1.2 Adding a Data Control as a Form

- 26.4.1.3 Adding a Data Control as a Graph

- 26.4.2 Creating Task Flow Parameters

- 26.4.3 Binding Data Control Parameters to Task Flow Parameters

- 26.4.4 Wiring a Data Control to a Parameter Form Task Flow

- 26.4.5 Consuming Task Flows that Contain Visualizations

- 26.4.6 Editing Visualizations

- 26.4.6.1 Editing Parameter Values for a Data Control Visualization

- 26.4.6.2 Customizing a Table

- 26.4.6.3 Customizing a Graph

- 26.4.7 Writing to a Data Source from a Visualization

- 26.4.7.1 Querying the Data Source

- 26.4.7.2 Updating Records in the Data Source

- 26.5 Business Mashup Examples

27 Working with OmniPortlet

- 27.1 What You Should Know About OmniPortlet

- 27.2 Working with the OmniPortlet Wizard

- 27.2.1 Adding an OmniPortlet Instance to a Page

- 27.2.2 Accessing the OmniPortlet Wizard

- 27.2.3 Selecting the Data Source Type

- 27.2.4 Identifying the Data Source

- 27.2.4.1 Proxy Authentication

- 27.2.4.2 Connection and Portlet Parameters

- 27.2.4.3 Spreadsheet

- 27.2.4.4 SQL

- 27.2.4.5 XML

- 27.2.4.6 Web Service

- 27.2.4.7 Web Page

- 27.2.5 Setting Filtering Options

- 27.2.6 Setting View Options

- 27.2.7 Setting Layout Options

- 27.2.7.1 Tabular Layout

- 27.2.7.2 Chart Layout

- 27.2.7.3 News Layout

- 27.2.7.4 Bullet Layout

- 27.2.7.5 Form Layout

- 27.2.7.6 HTML Layout

- 27.2.7.7 Parameter Form Layout

- 27.2.8 Customizing Your OmniPortlet

- 27.3 Working with OmniPortlet Parameters

- 27.4 Setting OmniPortlet Properties

- 27.4.1 What You Should Know About OmniPortlet Properties

- 27.4.2 OmniPortlet Properties

- 27.5 Troubleshooting OmniPortlet

28 Working with the Web Clipping Portlet

- 28.1 What You Should Know About Web Clipping

- 28.2 Working with the Web Clipping Portlet

- 28.2.1 Adding a Web Clipping Portlet to a Page

- 28.2.2 Clipping Content for Display in the Web Clipping Portlet

- 28.2.3 Adding a Web Clipping That Users Can Personalize

- 28.2.3.1 Selecting a Clipping from OTN

- 28.2.3.2 Parameterizing a Web Clipping Portlet

- 28.2.3.3 Personalizing a Web Clipping Portlet

- 28.3 Setting Web Clipping Portlet Properties

- 28.3.1 What you Should Know About Web Clipping Portlet Properties

- 28.3.2 Web Clipping Portlet Properties

- 28.4 Current Limitations of Web Clipping

- 28.5 Troubleshooting Web Clipping

Part IX Organizing Your Collaborative and Social Networking Environment

29 Exploring the Home Space

- 29.1 What You Can Do In the Home Space

- 29.2 Registering Yourself with WebCenter Spaces

- 29.3 Hiding, Opening, and Rearranging Pages

- 29.3.1 Opening Spaces

- 29.3.1.1 Accessing the Home Space

- 29.3.1.2 Accessing a Space

- 29.3.2 Opening Pages

- 29.3.3 Hiding Pages

- 29.3.4 Showing Hidden Pages

- 29.3.5 Rearranging Page Order

- 29.4 Adjusting Your Page View

- 29.4.1 What You Should Know About User Customizations on a Page

- 29.4.2 Performing User Customizations on Your Page View

- 29.4.2.1 Rearranging Page Content

- 29.4.2.2 Removing Components from Your View of a Page

- 29.4.2.3 Resizing Components

- 29.4.2.4 Collapsing and Expanding Components

- 29.5 Exposing a Space Page in Your View of the Home Space

- 29.6 Renaming a Page

- 29.7 Sending a Link to a Page

- 29.8 Previewing and Printing an Application Page

- 29.9 Viewing Space and Page Information

- 29.9.1 Accessing Space Information

- 29.9.2 Accessing Page Information

- 29.10 Viewing Your Personal Profile Gallery

- 29.11 Accessing WebCenter Spaces Online Help

30 Managing Your Profile

- 30.1 What You Should Know About Profile

- 30.2 Specifying a Management Chain for Organization View

- 30.3 Setting Profile Preferences

- 30.4 Adding a Profile Task Flow to a Page

- 30.5 Viewing and Editing Personal Profiles

- 30.5.1 Viewing Profile Details

- 30.5.2 Editing Your Personal Profile

- 30.5.3 Uploading and Updating a Personal Profile Picture

- 30.6 Setting Profile Task Flow Properties

- 30.6.1 What You Should Know About Profile Task Flow Properties

- 30.6.2 Profile Task Flow Parameters

- 30.6.3 Using Properties to Configure a Profile Task Flow Instance

- 30.6.3.1 Change Profile Photo in Profile - Snapshot Task Flow

- 30.6.3.2 Post a Status Update

- 30.6.3.3 Expose Additional Controls in Organization View

- 30.6.3.4 Enable Continuous Edits of Profile Details

- 30.6.3.5 Setting Size of Profile Images in Profile - Snapshot Task Flow

- 30.6.3.6 Exposing Navigational Breadcrumbs in Profile - Snapshot

- 30.6.3.7 Enabling Section-By-Section Profile Editing

31 Creating Your Social Network

- 31.1 What You Should Know About Connections

- 31.2 Setting Connections Preferences

- 31.3 Adding a Connections Task Flow to a Page

- 31.4 Setting Up Your Social Network

- 31.4.1 Viewing Your Connections

- 31.4.1.1 Viewing Your Connections

- 31.4.1.2 Searching Through Your Connections

- 31.4.2 Inviting Others to Connect

- 31.4.3 Viewing Invitations to Connect

- 31.4.3.1 Viewing Invitations You Have Sent

- 31.4.3.2 Viewing Invitations You Have Received

- 31.4.4 Responding to Invitations to Be a Connection

- 31.4.5 Creating and Managing Connections Lists

- 31.4.5.1 Creating a Connections List

- 31.4.5.2 Adding a Connection to a List

- 31.4.5.3 Removing a Connection from a List

- 31.4.5.4 Deleting a Connections List

- 31.4.6 Removing a Connection

- 31.5 Setting Connections Task Flow Properties

- 31.5.1 What You Should Know About Connections Task Flow Properties

- 31.5.2 Connections Task Flow Parameters

- 31.5.3 Using Properties to Configure a Connections Task Flow Instance

- 31.5.3.1 Adding a Remove Button to Connections - Card

- 31.5.3.2 Restricting Connections Displayed to Those on a Named List

- 31.5.3.3 Specifying an Initial View for a Connections Task Flow Instance

- 31.5.3.4 Limiting the Number of Displayed Connections

- 31.5.3.5 Specifying Numbers of Rows and Columns

- 31.5.3.6 Applying a Filter to a Connections - Card Task Flow Instance

- 31.5.3.7 Selecting a Display Format for a Connections - Card Task Flow Instance

- 31.5.3.8 Invoking a Profile Popup from a Connections - Card Task Flow Instance

32 Tracking Your Connections' Activities

- 32.1 What You Should Know About Activity Stream

- 32.2 Setting Activity Stream Preferences

- 32.3 Adding an Activity Stream Task Flow to a Page

- 32.4 Working with Activity Stream Task Flows

- 32.4.1 Selecting the People to Stream in an Activity Stream Instance

- 32.4.2 Selecting the Spaces to Stream in an Activity Stream Instance

- 32.4.3 Selecting the Services to Stream in an Activity Stream Instance

- 32.4.4 Hiding and Showing the Activities of a Selected User

- 32.4.4.1 Hiding the Activities of a Selected User

- 32.4.4.2 Showing the Activities of a Hidden User

- 32.4.5 Hiding and Showing the Activities of a Selected Space

- 32.4.5.1 Hiding the Activities of a Selected Space

- 32.4.5.2 Showing the Activities of a Hidden Space

- 32.4.6 Liking and Commenting On Activity Stream Items

- 32.4.7 Sharing Files and other Objects Through an Activity Stream Item

- 32.5 Setting Activity Stream Task Flow Properties

- 32.5.1 What You Should Know About Activity Stream Task Flow Properties

- 32.5.2 Activity Stream Task Flow Parameters

- 32.5.3 Using an Advanced Query to Filter Activity Stream Items

- 32.5.3.1 What You Should Know About the Activity Stream Advanced Query Option

- 32.5.3.2 Entering an Advanced Query Against an Activity Stream Task Flow Instance

- 32.5.4 Using Properties to Configure an Activity Stream Task Flow Instance

- 32.5.4.1 Preventing Users from Customizing an Activity Stream

- 32.5.4.2 Hiding File Previews in Streamed Items

- 32.5.4.3 Preventing Users from Commenting on Streamed Items

- 32.5.4.4 Preventing Users from Liking Streamed Items

- 32.5.4.5 Preventing Users from Sharing Streamed Items

- 32.5.4.6 Limiting the Stream to Activities from One or More Spaces

- 32.5.4.7 Limiting the Stream to One or More Services

- 32.5.4.8 Limiting the Stream to Your Own Activities

33 Posting and Managing Messages and Feedback

- 33.1 What You Should Know About Message Board and Feedback

- 33.1.1 What You Should Know About Message Board

- 33.1.2 What You Should Know About Feedback

- 33.2 Setting Message Board and Feedback Preferences

- 33.2.1 Setting Message Board Preferences

- 33.2.2 Setting Feedback Preferences

- 33.3 Enabling Other Users to Post Messages and Feedback for You

- 33.4 Working with Message Board and Feedback Task Flows

- 33.4.1 Working with Message Board Task Flows

- 33.4.1.1 Viewing Messages

- 33.4.1.1.1 Viewing Messages Others Have Left for You

- 33.4.1.1.2 Viewing Messages Others Have Received

- 33.4.1.1.3 Viewing Messages Sent to a Selected Space

- 33.4.1.2 Posting Messages

- 33.4.1.2.1 Posting a Message to all of Your Connections

- 33.4.1.2.2 Posting a Message Scoped to a Selected Space

- 33.4.1.2.3 Posting a Private Message

- 33.4.1.2.4 Sharing a Private Message

- 33.4.1.2.5 Attaching a File or URL to a Message Board Message

- 33.4.1.3 Editing Message Board Messages

- 33.4.1.4 Sorting and Filtering Message Board Messages

- 33.4.1.5 Hiding Messages in Your View of Message Board

- 33.4.1.6 Showing Hidden Messages

- 33.4.1.7 Deleting Message Board Messages

- 33.4.2 Working with Feedback Task Flows

- 33.4.2.1 Viewing Feedback

- 33.4.2.1.1 Viewing Feedback You Have Posted or Received

- 33.4.2.1.2 Sorting and Filtering Feedback Posts

- 33.4.2.1.3 Hiding Feedback in Your Own View

- 33.4.2.1.4 Showing Hidden Feedback

- 33.4.2.1.5 Marking Feedback Received as Private

- 33.4.2.2 Posting Feedback

- 33.4.2.3 Deleting Feedback

- 33.5 Setting Message Board and Feedback Task Flow Properties

- 33.5.1 What You Should Know About Message Board and Feedback Task Flow Properties

- 33.5.2 Message Board and Feedback Task Flow Parameters

- 33.5.3 Using Parameters to Configure Message Board and Feedback Task Flow Instances

- 33.5.3.1 Hiding Action Links and Icons on a Task Flow Instance

- 33.5.3.2 Limiting the Number of Messages and Feedback Posts Shown

- 33.5.3.3 Limiting the Length of Posts in a Feedback - Quick View Task Flow

- 33.5.3.4 Preventing Users from Adding Messages to a Message Board

- 33.5.3.5 Hiding the Feedback You Have Left for Others

- 33.5.3.6 Scoping the Display of Messages to a Named Space

- 33.5.3.7 Specifying the Date Range of Shown Messages and Feedback

34 Liking, Commenting On, and Sharing Objects

- 34.1 Liking and Unliking Application Objects

- 34.2 Commenting on Application Objects

- 34.3 Sharing Files, URLs, and Streamed Items with Other Users

- 34.3.1 What You Should Know About Sharing

- 34.3.2 Sharing Streamed Items with a Wider Audience

- 34.3.2.1 Reposting Streamed Items

- 34.3.2.2 Emailing Streamed Items

- 34.3.3 Sharing Items, Files, and URLs Through the Publisher Task Flow

- 34.3.3.1 What You Should Know About the Publisher Task Flow

- 34.3.3.2 Selecting the Recipients of a Published Message

- 34.3.3.3 Sharing Files Through the Publisher Task Flow

- 34.3.3.4 Sharing Links Through the Publisher Task Flow

- 34.3.3.5 Setting Publisher Task Flow Properties

- 34.3.3.5.1 What You Should Know About Publisher Task Flow Properties

- 34.3.3.5.2 Publisher Task Flow Parameters

- 34.3.3.5.3 Prohibiting File Uploads Through a Publisher Task Flow Instance

- 34.3.3.5.4 Limiting the Scope of Recipients

- 34.3.3.5.5 Using the Publisher as a Profile Status Updater

- 34.3.3.5.6 Using the Publisher as a File Uploader

35 Setting Your Personal Preferences

- 35.1 Accessing the Preferences Dialog

- 35.2 Choosing Your Preferred Display Language

- 35.3 Setting Date and Time Preferences

- 35.4 Enabling or Disabling Application Accessibility Options

- 35.4.1 What You Should Know about Application Accessibility Options

- 35.4.2 Applying Accessibility Options

- 35.5 Changing the Home Space Look and Feel in Your View

- 35.6 Changing Your WebCenter Spaces Password

- 35.7 Providing Login Information for External Applications

36 Setting Up Your Personal Subscriptions and Notifications

- 36.1 What You Should Know About Subscriptions and Notifications

- 36.2 Establishing and Managing Your Messaging Channels and Filters

- 36.2.1 Accessing Messaging Configuration Settings

- 36.2.2 Establishing a Messaging Channel

- 36.2.3 Editing a Messaging Channel

- 36.2.4 Deleting a Messaging Channel

- 36.2.5 Creating and Applying Messaging Filters

- 36.2.6 Editing Messaging Filters

- 36.2.7 Deleting Messaging Filters

- 36.3 Subscribing at the Application, Space, and Object Level

- 36.3.1 Setting Application-Level Subscriptions

- 36.3.2 Setting Space-Level Subscriptions

- 36.3.3 Setting Object-Level Subscriptions

- 36.3.3.1 Subscribing to a File

- 36.3.3.2 Subscribing to a Wiki Document

- 36.3.3.3 Subscribing to a Blog Entry

- 36.3.3.4 Subscribing to a Discussion Topic

- 36.4 Viewing and Cancelling Your Subscriptions

- 36.4.1 Viewing and Cancelling Application-Level Subscriptions

- 36.4.2 Viewing and Cancelling Space- and Object-Level Subscriptions

- 36.5 Working with Notifications Task Flows

- 36.5.1 What You Should Know About Notifications Task Flows

- 36.5.2 Adding Notifications Task Flows to a Page

- 36.5.3 Setting Notifications Task Flow Properties

- 36.5.3.1 What You Should Know About Notifications Task Flow Properties

- 36.5.3.2 Notifications Task Flow Parameters

- 36.5.3.3 Hiding Save and Refresh Actions on Subscription Preferences

- 36.5.3.4 Displaying Subscription Controls for One Space in Another

37 Creating and Managing Your Personal Favorites

- 37.1 What You Should Know About Favorites

- 37.2 Accessing the Favorites User Interface

- 37.3 Adding Favorites

- 37.4 Adding Favorites Folders

- 37.5 Managing Favorites

- 37.5.1 Adding a Favorite Through the Manage Favorites Window

- 37.5.2 Adding a Favorites Folder Through the Manage Favorites Window

- 37.5.3 Editing Favorites and Favorites Folders

- 37.5.4 Rearranging Favorites and Favorites Folders

- 37.5.5 Searching for Favorites

- 37.5.6 Deleting Favorites and Favorites Folders

38 Creating and Managing Personal Pages

- 38.1 Creating Personal Pages in the Home Space

- 38.1.1 Setting Page Creation Defaults for Personal Pages

- 38.1.1.1 Accessing Page Creation Default Settings

- 38.1.1.2 Setting Personal Page Creation Defaults

- 38.1.2 Creating a Personal Page in the Home Space

- 38.2 Controlling User Access to Your Personal Pages

- 38.2.1 Granting User Access to Your Personal Pages

- 38.2.2 Revoking User Access to a Personal Page

- 38.3 Editing a Personal Page

- 38.4 Copying a Personal Page

- 38.5 Deleting a Personal Page

Part X Working with Content

39 Introduction to Adding and Managing Content

- 39.1 What You Should Know About Adding and Managing Content

- 39.2 What You Should Know About Content Management Selections in the Resource Catalog

40 Publishing Content Using Content Presenter

- 40.1 What You Should Know About the Content Presenter Task Flow

- 40.1.1 Understanding Site Studio Integration

- 40.2 Adding a Content Presenter Task Flow to a Page

- 40.3 Displaying the Content Presenter Configuration Dialog

- 40.4 Selecting Content

- 40.4.1 Selecting a Single Content Item

- 40.4.2 Selecting the Contents of a Folder

- 40.4.3 Selecting Content Based on the Results of a Query

- 40.4.4 Selecting a List of Content Items

- 40.4.5 Selecting Content Based on the Results of a Scenario

- 40.5 Selecting a Display Template

- 40.6 Previewing the Results

- 40.7 Adding Links from Content to Navigation Nodes

- 40.8 Authoring Site Studio Content to Optimize Presentation in Content Presenter

- 40.8.1 Best Practices for Images

- 40.8.2 Best Practices for Defining Styles

- 40.8.3 Best Practices for JavaScript

- 40.9 Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog

- 40.10 Creating and Editing Files In-Context in a Content Presenter Task Flow

- 40.10.1 Editing Wiki Documents or HTML Files In-Context

- 40.10.2 Editing Site Studio Files In-Context

- 40.10.3 Creating New Site Studio Content In-Context

- 40.10.4 Changing the Edit Mode Key Sequence

- 40.11 Setting Content Presenter Task Flow Properties

- 40.11.1 What You Should Know About the Content Presenter Task Flow Properties

- 40.11.2 Content Presenter Task Flow Parameters

41 Working with the Documents Service Task Flows and Document Components

- 41.1 What You Should Know About the Documents Service Task Flows

- 41.1.1 Understanding the Document Explorer Task Flow

- 41.1.2 Understanding the Document List Viewer Task Flow

- 41.1.3 Understanding the Document Manager Task Flow

- 41.1.4 Understanding the Document Navigator Task Flow

- 41.1.5 Understanding the Folder Viewer Task Flow

- 41.1.6 Understanding the Recent Documents Task Flow

- 41.1.7 Understanding the Document Viewer Task Flow

- 41.1.8 Understanding the Document Mini Properties Task Flow

- 41.1.9 Understanding the Document Properties Task Flow

- 41.1.10 Understanding the Document Version History Task Flow

- 41.2 What You Should Know About Document Components

- 41.3 Adding a Selected Folder or File to a Page

- 41.4 Adding a Documents Service Task Flow to a Page

- 41.5 Understanding the Documents Service Task Flow Menus and Actions

- 41.5.1 Menus and Actions in the Documents Service Task Flows

- 41.5.1.1 File Menu

- 41.5.1.2 View Menu

- 41.5.1.3 New Wiki Document Action

- 41.5.1.4 Upload Action

- 41.5.1.5 Download Action

- 41.5.1.6 Folder Context Menu

- 41.5.1.7 File Context Menu

- 41.5.2 Menus and Actions in the Document Viewer Preview Pane or Window

- 41.5.2.1 File Menu

- 41.5.2.2 View Menu

- 41.5.2.3 Edit Action

- 41.5.2.4 Upload New Version Action

- 41.5.2.5 Download Action

- 41.5.2.6 Sidebar Icons and Panes

- 41.6 Personalizing Your View

- 41.6.1 Hiding and Showing Columns

- 41.6.2 Reordering Columns

- 41.6.3 Sorting Files and Folders

- 41.7 Creating a Folder

- 41.8 Creating a File

- 41.8.1 Uploading New Files

- 41.8.2 Creating a Wiki Document

- 41.9 Opening a Folder

- 41.10 Opening a File

- 41.11 Using the Rich Text Editor (RTE)

- 41.12 Editing and Updating a File

- 41.12.1 Checking a File Out

- 41.12.2 Downloading a File

- 41.12.3 Editing Files In-Place

- 41.12.3.1 Opening a File Already Checked Out By Another User

- 41.12.4 Uploading a New Version of an Existing File

- 41.13 Renaming a Folder or File

- 41.13.1 Renaming a Folder or File Using a Menu

- 41.13.2 Renaming a File and Revising Its Description Through Properties

- 41.14 Copying and Pasting Folders and Files

- 41.15 Moving Folders and Files

- 41.16 Deleting Folders and Files

- 41.17 Refreshing Folder Contents

- 41.18 Hiding and Showing Folders

- 41.19 Working with Related Items (Tags, Links, and Recommendations)

- 41.19.1 Working with Tags

- 41.19.2 Working with Links

- 41.19.3 Working with Recommendations

- 41.20 Viewing, Entering, and Deleting Comments on a File

- 41.21 Viewing and Deleting File Version History

- 41.22 Viewing and Modifying Folder and File Properties

- 41.22.1 Working with Folder Properties

- 41.22.2 Working with File Properties

- 41.23 Opening or Saving PDF Files

- 41.24 Sharing the URL for a Folder or File

- 41.24.1 Retrieving the URL for a Folder or File

- 41.24.2 Mailing the URL for a File

- 41.24.3 Publishing the URL for a File to Activity Streams

- 41.25 Setting Security Options on a Folder or File

- 41.26 Subscribing to a File

- 41.27 Liking and Unliking a File

- 41.28 Adding a File to Your Favorites

- 41.29 Running Document Searches

- 41.29.1 Running a Basic Document Search

- 41.29.2 Running an Advanced Document Search

42 Setting Documents Service Task Flow and Document Component Properties

- 42.1 What You Should Know About Documents Service Task Flow and Document Component Properties

- 42.2 Setting Document Explorer Task Flow Properties

- 42.2.1 Document Explorer Task Flow Parameters

- 42.3 Setting Document List Viewer Task Flow Properties

- 42.3.1 Document List Viewer Task Flow Parameters

- 42.4 Setting Document Manager Task Flow Properties

- 42.4.1 Document Manager Task Flow Parameters

- 42.5 Setting Document Navigator Task Flow Properties

- 42.5.1 Document Navigator Task Flow Parameters

- 42.6 Setting Folder Viewer Task Flow Properties

- 42.6.1 Folder Viewer Task Flow Parameters

- 42.7 Setting Recent Documents Task Flow Properties

- 42.7.1 Recent Documents Task Flow Parameters

- 42.8 Setting Document Viewer Task Flow Properties

- 42.8.1 Document Viewer Task Flow Parameters

- 42.9 Setting Document Mini Properties Task Flow Properties

- 42.9.1 Document Mini Properties Task Flow Parameters

- 42.10 Setting Document Properties Task Flow Properties

- 42.10.1 Document Properties Task Flow Parameters

- 42.11 Setting Document Version History Task Flow Properties

- 42.11.1 Document Version History Task Flow Parameters

- 42.12 Setting Document Link Component Properties

- 42.12.1 Document Link Component Display Options

- 42.13 Setting Document Inline Frame Component Properties

- 42.13.1 Document Inline Frame Component Display Options

- 42.14 Setting Document Image Component Properties

- 42.14.1 Document Image Component Display Options

43 Working with Workflow-Enabled Content

- 43.1 What You Should Know About Content Workflows

- 43.1.1 Understanding Workflow Types

- 43.1.2 Understanding Workflow Steps

- 43.1.3 Understanding Workflow Process

- 43.2 Assigning a Workflow to a Folder

- 43.3 Viewing Workflow Assignments

- 43.3.1 Viewing Workflow Files in a Documents Service Task Flow

- 43.3.2 Viewing Workflow Files in a Workflow Queue

- 43.4 Viewing Workflow Status and File Information

- 43.4.1 Viewing Detailed Workflow Status

- 43.4.2 Viewing Content Information and Actions

- 43.5 Changing or Deleting a Workflow

- 43.6 Participating in a Workflow

- 43.6.1 Approving or Rejecting a File in Workflow

- 43.6.2 Working with a Rejected Revision

44 Creating and Managing Content at Runtime

45 Collaborating on Documents

- 45.1 Collaborating on Documents Using the Documents Service

- 45.2 Collaborating on Documents through Workflows

- 45.3 Collaborating on Documents Using Oracle AutoVue

46 Working with Microsoft Office and Explorer Integration

- 46.1 What You Should Know About Microsoft Office and Explorer Integration

- 46.1.1 Understanding WebCenter Spaces Word, PowerPoint, and Excel Integration

- 46.1.2 Understanding Microsoft Windows Explorer Integration

- 46.2 Configuring Microsoft Office Integration with WebCenter Spaces

- 46.3 Working with Microsoft Word, PowerPoint, and Excel Integration

- 46.3.1 Creating a Space from a Microsoft Office Document

- 46.3.2 Opening and Editing a File

- 46.3.2.1 Opening a File Already Checked Out By Another User

- 46.3.3 Displaying and Hiding the Microsoft Office Task Pane

- 46.3.3.1 Displaying or Hiding the Task Pane Manually

- 46.3.3.2 Displaying or Hiding the Task Pane By Default

- 46.3.4 Working with the Microsoft Office Task Pane

- 46.3.4.1 Adding a File

- 46.3.4.1.1 Saving a File As a New File in a Space

- 46.3.4.1.2 Adding a New File Using the Task Pane

- 46.3.4.2 Adding a New Folder

- 46.3.4.3 Checking a File Out

- 46.3.4.3.1 Checking the Currently Open File Out Again After Checking It In

- 46.3.4.4 Checking a File In

- 46.3.4.5 Managing the Currently Open File

- 46.3.4.6 Managing Other Files in the Current Space

- 46.3.4.7 Managing Folders

- 46.3.4.8 Viewing Link Targets

- 46.3.4.9 Viewing Document Information

- 46.3.4.10 Working with File Version History

- 46.3.4.11 Adding Members to a Space

- 46.3.4.12 Sending a Message

- 46.3.4.12.1 Sending a Message to the Current User

- 46.3.4.12.2 Sending a Message to Your Connections

- 46.3.4.12.3 Sending a Message to Members of a Space

- 46.3.5 Closing a File

- 46.3.5.1 Closing a File After Checking It In

- 46.3.5.2 Closing a File Before Checking It In

- 46.3.5.2.1 Closing an Unchanged File

- 46.3.5.2.2 Closing an Updated File

- 46.4 Working with Microsoft Windows Explorer Integration

- 46.4.1 Adding a Space as a Network Place

- 46.4.2 Working with Files Using Windows Explorer

47 Working with Wiki Documents

- 47.1 What You Should Know About Wikis

- 47.1.1 Prerequisites for Enabling Wiki Functionality

- 47.1.2 Permissions Required for Working with Wiki Documents

- 47.2 Creating a Wiki Document

- 47.2.1 Methods of Creating a Wiki Document

- 47.2.2 Creating a Wiki Document Using the New Wiki Document Action

- 47.2.3 Creating a Wiki Document Using the Wiki Page Style

- 47.2.4 Creating a Wiki Document Within a Wiki Page Style-Based Page

- 47.3 Editing a Wiki Document

- 47.4 Exposing an Existing Wiki Document

- 47.4.1 Exposing an Existing Wiki Document Using the Wiki Page Style

- 47.4.2 Exposing an Existing Wiki Document Using Content Presenter

- 47.5 Comparing Versions of a Wiki Document

- 47.6 Managing Wiki Documents

48 Working with Blogs

- 48.1 What You Should Know About Blogs

- 48.1.1 Understanding the Blogs Interface

- 48.1.2 Directory Structure of Blogs

- 48.1.3 Requirements for Enabling the Blogs Functionality

- 48.1.4 Permissions Required for Working with Blogs

- 48.2 Creating and Managing Blogs

- 48.2.1 Creating a Blog

- 48.2.1.1 Creating a Blog Using the Blog Page Style

- 48.2.1.2 Adding a Blogs Task Flow

- 48.2.2 Setting Blog Properties

- 48.2.2.1 What You Should Know About Blog Properties

- 48.2.2.2 Blogs Task Flow Parameters

- 48.2.2.3 Blog Page Style Parameters

- 48.2.3 Subscribing to a Blog

- 48.3 Working with Blog Posts

- 48.3.1 What You Should Know About Blog Posts

- 48.3.2 Creating a Blog Post

- 48.3.3 Editing a Blog Post

- 48.3.4 Opening a Blog Post

- 48.3.5 Managing Blog Posts

Part XI Planning and Building a Space

49 Understanding Space Basics

- 49.1 What You Should Know About Spaces

- 49.2 What Does a Space Look Like?

- 49.3 Viewing Available Spaces

- 49.4 Interacting with Spaces Before Logging In (Public User)

- 49.5 Viewing Information About a Space

- 49.6 Joining a Space

- 49.6.1 Joining a Space (Registered WebCenter Spaces User)

- 49.6.2 Joining a Space (Unregistered WebCenter Spaces User)

- 49.7 Searching in a Space

- 49.8 Viewing Pages in a Space

- 49.9 Personalizing Your View of Pages in a Space

- 49.10 Creating Your Own Page in a Space

- 49.11 Showing or Hiding Pages in Your View of a Space

- 49.12 Editing Your Pages in a Space

- 49.13 Copying a Page to Your View of a Space

- 49.14 Renaming Your Pages in a Space

- 49.15 Controlling User Access to Your Space Pages

- 49.16 Deleting Your Pages in a Space

- 49.17 Exposing a Space Page in Your View of the Home Space

- 49.18 Sending a Link to a Page in a Space

- 49.19 Viewing Information About a Page in a Space

- 49.20 Changing Your Role in a Space

- 49.21 Cancelling Space Membership

50 Working with Space Templates

- 50.1 What You Should Know About Space Templates

- 50.1.1 Understanding Out-of-the-Box Space Templates

- 50.1.2 Understanding Custom Space Templates

- 50.2 Creating a Custom Space Template

- 50.3 Managing Space Templates

- 50.3.1 Viewing Available Space Templates

- 50.3.2 Searching for a Space Template

- 50.3.3 Renaming a Space Template

- 50.3.4 Setting Up Access to a Space Template

- 50.3.5 Publishing or Hiding Space Templates

- 50.3.6 Deleting Space Templates

51 Managing a Space

- 51.1 Who Is the Space Moderator?

- 51.2 Creating a New Space

- 51.3 Accessing Space Administration Pages

- 51.4 Managing General Administration Settings for a Space

- 51.4.1 Renaming a Space

- 51.4.2 Modifying the Description or Keywords for a Space

- 51.4.3 Taking a Space Offline

- 51.4.4 Bringing a Space Back Online

- 51.4.5 Closing or Reactivating a Space

- 51.4.6 Enabling or Disabling RSS News Feeds for a Space

- 51.4.7 Changing the Space Icon

- 51.4.8 Changing the Space Logo

- 51.4.9 Changing the Page Template for a Space

- 51.4.10 Changing the Skin for a Space

- 51.4.11 Changing the Resource Catalogs for Pages and the Page Template for a Space

- 51.4.12 Changing the Navigation for a Space

- 51.4.13 Displaying or Hiding a Page Footer in a Space

- 51.4.14 Customizing the Copyright Statement and Privacy URL

- 51.4.15 Setting a Space Display Language

- 51.4.16 Changing the Access to a Space

- 51.5 Managing Space Roles

- 51.6 Managing Space Members

- 51.7 Creating and Managing Space Pages

- 51.7.1 Setting a Default Page Style

- 51.7.2 Creating a Page in a Space

- 51.7.3 Showing or Hiding Pages in a Space

- 51.7.4 Searching for Pages in a Space

- 51.7.5 Editing a Page in a Space

- 51.7.6 Copying a Page in a Space

- 51.7.7 Renaming a Page in a Space

- 51.7.8 Changing Access Permissions on a Space Page

- 51.7.9 Deleting a Page in a Space

- 51.7.10 Exposing a Space Page in the Home Space

- 51.7.11 Sending a Link to a Page in a Space

- 51.7.12 Viewing Information About a Page in a Space

- 51.8 Managing Space Content

- 51.9 Managing Subspaces

- 51.10 Managing Space Services

- 51.10.1 Enabling and Disabling Services Available to a Space

- 51.10.2 Configuring a Custom Space Mail Distribution List

- 51.10.3 Modifying Discussion Forum Settings for a Space

- 51.10.4 Publishing Space Mail in a Discussion Forum

- 51.10.5 Configuring a Shared Mail Connection for a Space

- 51.11 Managing Space Resources

- 51.12 Defining Custom Attributes for a Space

- 51.13 Adding Wikis or Blogs to a Space

- 51.14 Making a Space Available

- 51.14.1 Publishing the Link to a Space

- 51.14.2 Changing a Space URL

- 51.14.3 Making a Space Known (Discoverable)

- 51.14.4 Granting WebCenter Spaces Users Access to a Space

- 51.14.5 Granting Public Access to a Space

- 51.15 Sending Mail to Space Members or Moderators

- 51.16 Working with the Space Task Flows

- 51.16.1 Adding a Space Task Flow to a Page

- 51.16.2 Setting Space Task Flow Properties

- 51.16.2.1 What You Should Know About the Spaces Task Flow Properties

- 51.16.2.2 Setting Space Members Task Flow Properties

- 51.16.2.3 Setting Spaces Browser Task Flow Properties

- 51.16.2.3.1 Spaces Browser Task Flow Parameters

- 51.17 Deleting a Space

52 Managing Space Members and Roles

- 52.1 Setting Up the Membership Policy for a Space

- 52.1.1 Managing Self-Service Membership for a Space

- 52.1.2 Managing Self-Service Membership Removal from a Space

- 52.2 Managing Roles and Permissions for a Space

- 52.2.1 What You Should Know About Roles and Permissions for a Space

- 52.2.1.1 Understanding the Default Roles for a Space

- 52.2.1.2 Understanding Permissions and Permission Models in a Space

- 52.2.1.3 Understanding Custom Roles in Spaces

- 52.2.2 Defining Custom Roles for a Space

- 52.2.3 Viewing and Editing Permissions of a Space Role

- 52.2.4 Using the Advanced Permission Model

- 52.2.5 Deleting Roles in a Space

- 52.3 Managing Members and Assigning Roles

- 52.3.1 What You Should Know About Space Membership

- 52.3.2 Viewing Members of a Space

- 52.3.3 Composing Messages to New Members

- 52.3.4 Adding Members to a Space

- 52.3.4.1 Adding WebCenter Spaces Users and Groups

- 52.3.4.2 Inviting a WebCenter Spaces User

- 52.3.4.3 Allowing a WebCenter Spaces User to Self-Subscribe

- 52.3.4.4 Inviting a Non-WebCenter Spaces User

- 52.3.5 Changing Member Role Assignments

- 52.3.6 Approving Requests for Membership of a Space

- 52.3.7 Communicating with Moderators and Members of a Space

- 52.3.7.1 Sending a Message from the Spaces Page

- 52.3.7.2 Sending a Message from the Members Page

- 52.3.7.3 Contacting Space Moderator(s)

- 52.3.8 Revoking Membership

- 52.4 Working with the Space Members Task Flow

- 52.4.1 What You Should Know About the Space Members Task Flow

- 52.4.2 Managing Space Membership Through the Space Members Task Flow

- 52.4.3 Contacting All Space Members

- 52.4.4 Contacting Individual Members of a Space

- 52.4.5 Sorting Members

- 52.4.6 Filtering Members

- 52.4.7 Setting Space Members Task Flow Properties

- 52.4.7.1 What You Should Know About Space Members Task Flow Properties

- 52.4.7.2 Space Members Task Flow Parameters

53 Administering Spaces and Templates

- 53.1 Understanding Space Management and Migration

- 53.2 Performing Administrative Tasks For All Spaces

- 53.2.1 Viewing Space Information

- 53.2.2 Taking Any Space Offline

- 53.2.3 Bringing Any Space Back Online

- 53.2.4 Closing Any Space

- 53.2.5 Reactivating Any Space

- 53.2.6 Deleting a Space

- 53.3 Performing Administrative Tasks For All Space Templates

- 53.3.1 What You Should Know About Managing Space Templates

- 53.3.2 Viewing Space Templates

- 53.3.3 Publishing and Hiding Space Templates

- 53.3.4 Deleting a Space Template

- 53.4 Enabling and Disabling Services

- 53.5 Importing and Exporting Spaces and Space Templates

- 53.5.1 Exporting Spaces

- 53.5.2 Importing Spaces

- 53.5.3 Exporting Space Templates

- 53.5.4 Importing Space Templates

- 53.6 Troubleshooting

- 53.6.1 Troubleshooting WebCenter Spaces Workflows

- 53.6.1.1 Validating the WebCenter Workflow Configuration

- 53.6.1.2 Troubleshooting Issues with WebCenter Spaces Workflows

- 53.6.2 Troubleshooting WebCenter Service Issues

- 53.6.3 Troubleshooting Issues with Space Import and Export

- 53.6.3.1 Space Blocked After Unsuccessful Export or Import

- 53.6.3.2 Page or Space Not Found Message After Import

- 53.6.3.3 Space Import Archive Exceeds Maximum Upload File Size

- 53.6.3.4 Maximum Number of Spaces Exceeded on Export

- 53.6.3.5 Lists Not Imported Properly

- 53.6.3.6 Importing from the Subspaces Page

54 Working with a Space Hierarchy

- 54.1 What You Should Know About Space Hierarchies

- 54.2 Understanding Inheritance in Space Hierarchies

- 54.2.1 Inheriting Security

- 54.2.2 Inheriting Services

- 54.3 Creating a Subspace

- 54.4 Viewing a Space Hierarchy

- 54.4.1 Viewing Subspaces of a Parent Space

- 54.4.2 Viewing Parent Spaces of a Subspace

- 54.5 Creating a Custom Space Hierarchy Navigation

- 54.6 Moving Subspaces

- 54.7 Managing a Subspace

- 54.7.1 Modifying Security Settings for a Subspace

- 54.7.2 Importing Subspaces

Part XII Analyzing and Monitoring Your Portal

55 Analyzing Usage and Performance Metrics

- 55.1 What You Should Know About the Analytics Service

- 55.1.1 Understanding the Analytics Administration Page in WebCenter Spaces

- 55.1.2 Understanding Analytics Task Flows in WebCenter Spaces

- 55.1.2.1 WebCenter Traffic

- 55.1.2.2 Page Traffic

- 55.1.2.3 Login Metrics

- 55.1.2.4 Space Traffic

- 55.1.2.5 Space Response Time

- 55.1.2.6 Portlet Traffic

- 55.1.2.7 Portlet Instance Traffic

- 55.1.2.8 Portlet Response Time

- 55.1.2.9 Portlet Instance Response Time

- 55.1.2.10 Search Metrics

- 55.1.2.11 Document Metrics

- 55.1.2.12 Wiki Metrics

- 55.1.2.13 Blog Metrics

- 55.1.2.14 Discussion Forum Metrics

- 55.1.3 Access to Analytics Task Flows in WebCenter Spaces

- 55.2 Working with Analytics Task Flows

- 55.2.1 Adding Analytics Task Flows to a Page

- 55.2.2 Customizing Analytics Reports

- 55.2.3 Personalizing Your Analytics Report View

- 55.2.3.1 Report Display Options

- 55.2.3.2 Query Options

- 55.3 Setting Analytics Task Flow Properties

- 55.3.1 What You Should Know About the Analytics Service Task Flow Properties

- 55.3.2 Analytics Service Task Flow Parameters

Part XIII Searching WebCenter and Other Sources

56 Working with the Search Service

- 56.1 What You Should Know About the Search Service

- 56.1.1 Using the Oracle Secure Enterprise Search Adapter

- 56.2 Setting Preferences for WebCenter Spaces Search Results

- 56.2.1 Selecting the Services to Search

- 56.2.2 Specifying a Display Order for Search Results

- 56.3 Working with Search Service Task Flows

- 56.3.1 Adding Search Service Task Flows

- 56.3.2 Searching in a WebCenter Application

- 56.3.2.1 Performing a Global Search

- 56.3.2.2 Performing a Space Search

- 56.3.3 Refining the Display of Search Results

- 56.3.4 Saving Searches

- 56.3.4.1 Saving a Search

- 56.3.4.2 Running a Saved Search

- 56.3.4.3 Sharing a Saved Search in WebCenter Spaces

- 56.3.4.4 Customizing a Saved Search

- 56.3.4.5 Deleting a Saved Search

- 56.4 Setting Search Service Task Flow Properties

- 56.4.1 What You Should Know About the Search Service Task Flow Properties

- 56.4.2 Search Service Task Flow Parameters

57 Working with the Tags Service

- 57.1 What You Should Know About the Tags Service

- 57.1.1 Understanding Tags

- 57.1.2 Adding the Tags Icon to Pages

- 57.1.3 Understanding the Tags Task Flow

- 57.1.4 Understanding the Similarly Tagged Items Task Flow

- 57.1.5 Understanding the Tag Center

- 57.2 Working with Tags Service Features and Task Flows

- 57.2.1 Adding a Tags Service Task Flow to a Page

- 57.2.2 Tagging WebCenter Portal Application Pages

- 57.2.3 Tagging WebCenter Portal Application Documents

- 57.2.4 Working with Tags and Tagged Items in the Tags Task Flow

- 57.2.4.1 Viewing Tags and Tagged Items in the Tags Task Flow

- 57.2.4.2 Sorting Tags and Tagged Items

- 57.2.4.3 Filtering Tags and Tagged Items

- 57.2.4.4 Renaming a Tag from the Tags Task Flow

- 57.2.4.5 Deleting a Tag from the Tags Task Flow

- 57.2.5 Viewing Tags and Tagged Items in Search Results

- 57.2.6 Working with Tags and Tagged Items in the Tag Center

- 57.2.6.1 Opening the Tag Center

- 57.2.6.2 Selecting Different Views and Arrangements of Tags in the Tag Cloud

- 57.2.6.3 Selecting Different Views and Arrangements of Tagged Items

- 57.2.6.4 Refining the Display of Information in the Tag Center

- 57.2.6.5 Discovering Who Has Used a Tag in the Tag Center

- 57.3 Setting Tags Service Task Flow Properties

- 57.3.1 What You Should Know About the Tags Service Task Flow Properties

- 57.3.2 Tags Service Task Flow Parameters

Part XIV Gathering Intelligence Based on Activities

58 Working with the Activity Graph Service

- 58.1 What You Should Know About the Activity Graph Service

- 58.2 Working with Activity Graph Service Task Flows

- 58.2.1 Adding an Activity Graph Service Task Flow to a Page

- 58.2.2 Working with the Recommended Connections Task Flow

- 58.2.2.1 Learning More About a Recommended Connection

- 58.2.2.2 Inviting a Recommended Connection to Connect with You

- 58.2.2.3 Removing a User from Your Recommended Connections

- 58.2.2.4 Setting the Number of Users to Display in the Recommended Connections Task Flow

- 58.2.2.5 Controlling Which Users to Include in the Recommended Connections Task Flow

- 58.2.3 Working with the Similar Spaces Task Flow

- 58.2.3.1 Learning More About a Suggested Space

- 58.2.3.2 Joining a Suggested Space

- 58.2.3.3 Removing a Space from the Task Flow

- 58.2.3.4 Setting the Number of Spaces to Display in the Similar Spaces Task Flow

- 58.2.3.5 Controlling Which Spaces to Include in the Similar Spaces Task Flow

- 58.2.4 Working with the Similar Items Task Flow

- 58.2.4.1 Populating the Similar Items Task Flow

- 58.2.4.2 Viewing a Suggested Item

- 58.2.4.3 Removing an Item from the Similar Items Task Flow

- 58.2.4.4 Setting the Number of Items to Display in the Similar Items Task Flow

- 58.2.4.5 Controlling Which Items to Include in the Similar Items Task Flow

- 58.3 Setting Activity Graph Service Task Flow Properties

- 58.3.1 What You Should Know About the Activity Graph Service Task Flow Properties

- 58.3.2 Activity Graph Service Task Flow Parameters

Part XV Services: Announcements through Links

59 Working with the Announcements Service

- 59.1 What You Should Know About the Announcements Service

- 59.2 Working with Announcements Service Task Flows

- 59.2.1 Adding an Announcements Service Task Flow to a Page

- 59.2.2 Working with the Announcements Task Flow

- 59.2.2.1 Viewing Announcements in the Announcements Task Flow

- 59.2.2.2 Adjusting Your View of the Announcements

- 59.2.2.3 Creating an Announcement

- 59.2.2.4 Editing Announcements

- 59.2.2.5 Deleting an Announcement

- 59.2.3 Working with the Announcements - Quick View Task Flow

- 59.2.3.1 Viewing Announcements in the Quick View Task Flow

- 59.2.3.2 Managing Announcements in the Quick View Task Flow

- 59.2.4 Sending Mail from an Announcement

- 59.2.5 Linking Announcements

- 59.3 Setting Announcements Service Task Flow Properties

- 59.3.1 What You Should Know About the Announcements Service Task Flow Properties

- 59.3.2 Announcements Service Task Flow Parameters

60 Working with the Discussions Service

- 60.1 What You Should Know About the Discussions Service

- 60.2 Working with Discussions Service Task Flows

- 60.2.1 Adding a Discussions Service Task Flow to a Page

- 60.2.2 Creating a Discussion Forum

- 60.2.3 Editing the Forum Name and Description

- 60.2.4 Creating and Managing Forum Topics and Replies

- 60.2.4.1 Posting a New Forum Topic

- 60.2.4.2 Replying to Topic Posts

- 60.2.4.3 Viewing Topic Posts and Replies

- 60.2.4.4 Editing Topics and Replies

- 60.2.4.5 Deleting Topic Posts and Replies

- 60.2.4.6 Switching Between Topic View Modes

- 60.2.5 Showing and Hiding Additional Discussion Forum Information

- 60.2.5.1 Showing or Hiding Information in the Discussions - Quick View Task Flow

- 60.2.5.2 Showing or Hiding Information in the Popular Topics Task Flow

- 60.2.5.3 Showing or Hiding Information in the Recent Topics Task Flow

- 60.2.5.4 Showing or Hiding Information in the Watched Forums Task Flow

- 60.2.5.5 Showing or Hiding Information in the Watched Topics Task Flow

- 60.2.6 Watching Forums and Topics

- 60.2.6.1 Adding a Discussion Forum or Topic to Your Watch List

- 60.2.6.2 Removing a Discussion Forum or Topic from a Watch List

- 60.2.6.3 Viewing Watched Forums and Topics from the Quick View

- 60.2.7 Sending Mail from Discussion Topics

- 60.3 Setting Discussions Service Task Flow Properties

- 60.3.1 What You Should Know About the Discussions Service Task Flow Properties

- 60.3.2 Discussions Service Task Flow Parameters

61 Working with the Events Service

- 61.1 What You Should Know About the Events Service

- 61.1.1 Calendar Overlaying

- 61.1.2 Where to View Events

- 61.1.3 Integration with Other Services

- 61.2 Working with Events Service Task Flows

- 61.2.1 Adding an Events Service Task Flow to a Page

- 61.2.2 Accessing Your Personal Microsoft Exchange Calendar

- 61.2.3 Viewing Events

- 61.2.3.1 Displaying the Events Page for a Space

- 61.2.3.2 Displaying Events by Day, Week, or Month or as a List

- 61.2.3.3 Viewing Events for a Specific Date

- 61.2.3.4 Refreshing Your View of Events

- 61.2.3.5 Setting Display Preferences

- 61.2.3.5.1 Setting the Calendar Start Time

- 61.2.3.5.2 Setting a Secondary Time Zone

- 61.2.3.5.3 Configuring List View

- 61.2.4 Scheduling Events

- 61.2.5 Viewing Event Details

- 61.2.6 Revising Scheduled Events

- 61.2.7 Cancelling Scheduled Events

- 61.2.8 Displaying Multiple Calendars in a Single Task Flow

- 61.2.8.1 Enabling Calendar Overlaying

- 61.2.8.2 Displaying Additional Calendars

- 61.2.8.3 Editing Calendar Display Options

- 61.3 Setting Events Service Task Flow Properties

- 61.3.1 What You Should Know About the Events Service Task Flow Properties

- 61.3.2 Events Service Task Flow Parameters

- 61.3.3 Events - Mini View Task Flow Parameters

62 Working with the Instant Messaging and Presence Service (IMP)

- 62.1 What You Should Know About the IMP Service

- 62.2 Identifying Your Preferred Instant Messaging Provider

- 62.3 Configuring Network Presence

- 62.4 Working with IMP Service Features

- 62.4.1 Viewing the Status of Other Users

- 62.4.2 Sending a Mail Message from the Presence Icon Menu

- 62.4.3 Sending an Instant Message from the Presence Icon Menu

- 62.4.4 Initiating a Phone Conference from the Presence Icon Menu

63 Working with the Links Service

- 63.1 What You Should Know About the Links Service

- 63.2 Working with Links Service Features

- 63.2.1 Linking to Existing Objects

- 63.2.1.1 Opening the Links Dialog to Link to Existing Objects

- 63.2.1.2 Linking to an Existing Announcement

- 63.2.1.3 Linking to an Existing Discussion Forum Topic

- 63.2.1.4 Linking to an Existing Document

- 63.2.1.5 Linking to an Existing Event

- 63.2.2 Linking to New Objects

- 63.2.2.1 Opening the Links Dialog to Link to a New Object

- 63.2.2.2 Adding and Linking to a Discussion Forum Topic

- 63.2.2.3 Adding and Linking to a Document

- 63.2.2.4 Adding and Linking to an Event

- 63.2.2.5 Adding and Linking to a Note

- 63.2.2.6 Linking to a Web Page

- 63.2.3 Accessing Link Targets

- 63.2.4 Deleting a Link

- 63.2.5 Linking in the Rich Text Editor

Part XVI Services: Lists through Worklist

64 Working with the Lists Service

- 64.1 What You Should Know About the Lists Service

- 64.2 Working with Lists Service Features

- 64.2.1 Adding Lists to a Page

- 64.2.2 Viewing Lists

- 64.2.3 Creating and Managing Lists

- 64.2.3.1 Creating Lists

- 64.2.3.2 Editing List Structure

- 64.2.3.2.1 Renaming a List and Revising a List Description

- 64.2.3.2.2 Adding Columns to a List

- 64.2.3.2.3 Revising List Column Details

- 64.2.3.2.4 Rearranging List Columns on All Instances of a List

- 64.2.3.2.5 Deleting a List Column

- 64.2.3.3 Copying a List

- 64.2.3.4 Deleting Lists

- 64.2.4 Adding and Managing List Data

- 64.2.4.1 Adding Data of a Given Data Type to a List

- 64.2.4.1.1 Adding Data to a List

- 64.2.4.1.2 Adding Plain Text Data to a List

- 64.2.4.1.3 Adding Rich Text Data to a List

- 64.2.4.1.4 Adding DateTime Data to a List

- 64.2.4.1.5 Adding Picture Data to a List

- 64.2.4.1.6 Adding Person Data to a List

- 64.2.4.2 Editing List Data

- 64.2.4.3 Deleting List Rows

- 64.2.4.4 Refreshing List Data

- 64.2.5 Customizing Lists

- 64.2.5.1 Sorting List Data on a Column

- 64.2.5.1.1 Sorting List Data Using Column Icons

- 64.2.5.1.2 Performing an Advanced Sort of List Data

- 64.2.5.2 Resizing List Columns

- 64.2.5.3 Changing Column Order on a List Instance

- 64.2.5.4 Hiding and Showing List Columns

- 64.2.5.5 Freezing a Column Position

- 64.2.5.6 Wrapping Column Data

- 64.2.5.7 Applying Color Banding to List Rows

- 64.2.5.7.1 Applying Color Banding to Your Personal View of a List

- 64.2.5.7.2 Removing Personal Color Banding

- 64.2.5.7.3 Applying Color Banding to Everyone's View of a List Instance

- 64.2.5.7.4 Removing Color Banding from Everyone's View of a List

- 64.2.5.8 Filtering List Data

- 64.2.5.8.1 Applying an Ad Hoc Filter to a List Instance

- 64.2.5.8.2 Applying a Permanent, Personal Filter to a List Instance

- 64.2.5.8.3 Removing a Permanent, Personal List Filter

- 64.2.5.8.4 Applying Filters to Everyone's View of a List

- 64.2.5.8.5 Removing Filters from Everyone's View of a List

- 64.2.6 Sending a Link to a List to Other Users

- 64.2.7 Exporting a List and Importing a List from an Excel Spreadsheet

- 64.2.7.1 What You Should Know About Exporting and Importing Lists

- 64.2.7.2 Exporting a List to a Spreadsheet

- 64.2.7.3 Importing an Exported List

- 64.3 Setting List Viewer Task Flow Properties

- 64.3.1 What You Should Know About List Viewer Task Flow Properties

- 64.3.2 List Viewer Task Flow Parameters

65 Working with the Mail Service

- 65.1 What You Should Know About the Send Mail Feature

- 65.1.1 Configuring the Send Mail Feature

- 65.2 What You Should Know About the Mail Service

- 65.3 Selecting Your Preferred Mail Connection

- 65.4 Working with the Mail Service Task Flow

- 65.4.1 Adding the Mail Service Task Flow to a Page

- 65.4.2 Logging in to Mail

- 65.4.3 Personalizing Your View of the Mail Task Flow

- 65.4.4 Opening Mail Messages

- 65.4.5 Downloading Mail Attachments

- 65.4.6 Composing and Sending Mail Messages

- 65.4.7 Sending Mail with Attachments

- 65.4.8 Removing Attachments from the Add Attachment Window

- 65.4.9 Replying to and Forwarding Mail

- 65.4.10 Refreshing Mail

- 65.4.11 Deleting Mail

- 65.5 Setting Mail Service Task Flow Properties

- 65.5.1 What You Should Know About the Mail Service Task Flow Properties

- 65.5.2 Mail Service Task Flow Parameters

66 Working with the Notes Service

- 66.1 What You Should Know About the Notes Service

- 66.2 Working with the Notes Service Task Flow

- 66.2.1 Adding the Notes Service Task Flow to a Resource Catalog

- 66.2.2 Adding the Notes Service Task Flow to a Page

- 66.2.3 Creating a Note

- 66.2.4 Filtering and Clearing Filters on Notes

- 66.2.5 Editing Note Details

- 66.2.6 Refreshing Your View of Notes

- 66.2.7 Deleting Notes

- 66.3 Setting Notes Service Task Flow Properties

67 Working with the Polls Service

- 67.1 What You Should Know About the Polls Service

- 67.2 Working with Polls Service Task Flows

- 67.2.1 Adding a Polls Service Task Flow to a Page

- 67.2.2 Working with the Quick Poll Task Flow

- 67.2.3 Working with the Polls Manager Task Flow

- 67.2.4 Working with the Take Polls Task Flow

- 67.2.5 Working with the View Poll Results Task Flow

- 67.3 Setting Polls Service Task Flow Properties

- 67.3.1 What You Should Know About the Polls Service Task Flow Properties

- 67.3.2 Polls Service Task Flow Parameters

68 Working with the RSS Service

- 68.1 What You Should Know About the RSS Service

- 68.1.1 RSS Icon

- 68.1.2 RSS Manager

- 68.1.3 RSS Task Flow

- 68.2 Obtaining Service News Feeds

- 68.2.1 Obtaining the Recent Activities News Feed

- 68.2.1.1 Obtaining a Recent Activity News Feed URL from the RSS Manager

- 68.2.1.2 Obtaining a News Feed URL from the Recent Activity Task Flow

- 68.2.2 Obtaining the Discussion Forums News Feed

- 68.2.2.1 Obtaining a Discussion Forum News Feed from the RSS Manager

- 68.2.2.2 Obtaining a News Feed from the Discussions Page

- 68.2.2.3 Obtaining a News Feed from a Discussion Forums Task Flow

- 68.2.3 Obtaining List News Feeds

- 68.2.3.1 Obtaining a List News Feed from the RSS Manager

- 68.2.3.2 Obtaining a News Feed from the Lists Page

- 68.2.3.3 Obtaining a News Feed from a Lists Task Flow

- 68.2.4 Obtaining the Announcements News Feed

- 68.2.4.1 Obtaining an Announcements News Feed from the RSS Manager

- 68.2.4.2 Obtaining a News Feed from the Announcements Page

- 68.2.4.3 Obtaining a News Feed from the Announcements Task Flow

- 68.3 Working with the RSS Task Flow

- 68.3.1 Adding an RSS Service Task Flow to a Page

- 68.3.2 Refreshing an RSS Task Flow

- 68.3.3 Deleting an RSS Task Flow From the Page

- 68.3.4 Editing the Feed Location of an RSS Task Flow

- 68.4 Setting RSS Service Task Flow Properties

- 68.4.1 What You Should Know About the RSS Service Task Flow Properties

- 68.4.2 RSS Service Task Flow Parameters

69 Working with the Recent Activities Service

- 69.1 What You Should Know About the Recent Activities Service

- 69.2 Working with the Recent Activities Task Flow

- 69.2.1 Adding the Recent Activities Task Flow to a Custom Resource Catalog

- 69.2.2 Adding the Recent Activities Task Flow to a Page

- 69.2.3 Personalizing the Recent Activities Task Flow

- 69.2.4 Accessing Recently Acted-On Items

- 69.2.5 Refreshing the Recent Activities Task Flow

- 69.3 Setting Recent Activities Task Flow Properties

- 69.3.1 What You Should Know About the Recent Activities Task Flow Properties

- 69.3.2 Recent Activities Task Flow Parameters

70 Working with the Worklist Service

- 70.1 What You Should Know About the Worklist Service

- 70.2 Adding a Worklist Service Task Flow to a Page

- 70.3 Working with the Worklist Service Task Flow

- 70.3.1 Viewing and Responding to Worklist Items

- 70.3.2 Setting Messaging Preferences

- 70.3.3 Arranging Your Display of Worklist Items

- 70.4 Setting Worklist Service Task Flow Properties

Part XVII Appendices

A WebCenter Spaces User Interface URLs

- A.1 User Interface URLs for User Profiles

- A.2 User Interface URLs for Home Space Pages

- A.3 User Interface URLs for Space Pages

- A.4 User Interface URLs for Application Administration Pages

B Expression Language Expressions

- B.1 Introducing the Expression Builder

- B.2 Expression Language Example Use Case

- B.3 Expression Language Expressions

- B.3.1 Seeded Expressions in the Expression Builder

- B.3.1.1 Application Info Seeded ELs

- B.3.1.2 Page Info Seeded ELs

- B.3.1.3 Page Parameter Seeded ELs

- B.3.1.4 Resource Info Seeded ELs

- B.3.1.5 Space Info Seeded ELs

- B.3.1.6 Space Page Info Seeded Paths

- B.3.1.7 System Seeded ELs

- B.3.1.8 User Info Seeded ELs

- B.3.1.9 WebCenter Events Seeded ELs

- B.3.2 EL Expressions Relevant to the WebCenter Spaces Application

- B.3.3 EL Expressions Relevant to Application Security

- B.3.4 EL Expressions Relevant to Application Navigation

- B.3.5 EL Expressions Relevant to Resources

- B.3.6 EL Expressions Relevant to Specific Spaces

- B.3.7 EL Expressions Relevant to Specific Pages

- B.3.8 EL Expressions Relevant to Oracle Composer

- B.3.9 EL Expressions Relevant to Event Contexts

- B.3.10 EL Expressions Relevant to Services

- B.3.11 EL Expressions Relevant to the Personalization Conductor

- B.3.12 EL Expressions Relevant to the Documents Service

- B.3.13 EL Expressions Relevant to the People Connections Service

- B.3.14 EL Expressions Relevant to User Preferences

- B.3.15 Utilitarian EL Expressions

C Business Mashup Examples

- C.1 Creating Mashups with Data from the Analytics Service

- C.1.1 Creating a Graph to Display Page Hits

- C.1.2 Using a Parameterized Task Flow to Display a Graph of Page Hits in a Space

- C.1.2.1 Creating the Page Hits Data Control

- C.1.2.2 Creating a Custom Mashup Style with a Parameter to Specify the Space Name

- C.1.2.3 Creating a Task Flow Using the Custom Mashup Style

- C.1.2.4 Consuming the Data Control in the Task Flow

- C.1.2.5 Testing the Parameter Wiring in the Task Flow

- C.1.3 Creating a Graph to View Portal Site Traffic

- C.1.4 Creating a Mashup with Two Task Flows in a Master-Detail Relationship

- C.1.4.1 Creating the Master Data Control and Task Flow

- C.1.4.2 Creating the Details Data Control and Task Flow

- C.1.4.3 Wiring the Master and Details Task Flows

- C.1.5 Creating a Table with Hyperlinks to Download Documents

- C.1.5.1 Creating the Document Views Data Control

- C.1.5.2 Creating a Custom Mashup Style with a Parameter to Specify the Space Name

- C.1.5.3 Creating a Task Flow Using the Custom Mashup Style

- C.1.5.4 Consuming the Data Control in the Task Flow

- C.1.5.5 Testing the Parameter Wiring in the Task Flow

- C.2 Creating a Mashup that Displays Employee Data from SQL Data Control

- C.2.1 Creating the SQL Data Control

- C.2.2 Adding the Data Control and Binding Task Flow Parameters to Data Control Parameters

- C.2.3 Showing a Hidden Column in the Table

- C.2.4 Adding the Data Control in a Parameter Form Task Flow

- C.3 Creating a Mashup with Data from the WebCenter Spaces MDS Repository

- C.3.1 Creating the Data Control

- C.3.2 Adding the Data Control as a Graph Inside a Task Flow

- C.4 Creating a Mashup with Data from a WebCenter Spaces Web Service Data Source

- C.4.1 Creating a Mashup to List the Spaces in the Application

- C.4.2 Creating a Mashup with a Form to Rename Spaces

- C.5 Creating a Mashup with Data from a Siebel Data Source

- C.5.1 Creating a Web Service Data Control

- C.5.2 Adding a Data Control Method as a Table to a Task Flow

- C.5.3 Querying the Data Source

- C.5.4 Updating Data Source Records

- C.6 Building and Using a Custom Mashup Style with Predefined Columns

- C.6.1 Building the Custom Mashup Style

- C.6.2 Creating a Task Flow Based on the Custom Style

- C.7 Building and Using a Custom Mashup style with Date Fields

- C.7.1 Building the Custom Mashup Style

- C.7.2 Creating a Task Flow Based on the Custom Style

- C.8 Creating a Mashup with a Graph That Is Wired to the Page Navigation

- C.8.1 Creating the Page Hits Data Control

- C.8.2 Consuming the Data Control in a Page with a Navigation Tree

- C.9 Creating a Mashup with a Graph that Is Wired to the Inherited Page Navigation

- C.9.1 Creating the Page Hits Data Control

- C.9.2 Consuming the Page Hits Data Control

- C.9.3 Creating and Applying a Custom Page Template

- C.9.4 Testing the Wiring Between the Page Hits Graph and the Inherited Navigation

- C.10 Creating a Master-Detail Mashup that Contains a Google Maps Task Flow

- C.10.1 Creating the Data Control

- C.10.2 Creating the Details Task Flow

- C.10.3 Creating the Master Task Flow

- C.10.4 Wiring the Master and Details Task Flows

- C.11 Creating a Mashup with a Customized RSS Feed OmniPortlet

- C.11.1 Creating a Task Flow with an OmniPortlet

- C.11.2 Testing the Task Flow

- C.11.3 Sharing the Task Flow with the Customized Portlet

Glossary

Index

Oracle® Fusion Middleware

User's Guide for Oracle WebCenter Spaces

11g Release 1 (11.1.1.5.0)

E10149-09

August 2011

Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces, 11g Release 1 (11.1.1.5.0)

E10149-09

Copyright © 2010, 2011, Oracle and/or its affiliates. All rights reserved.

Primary Authors: Sarah Bernau, Joan Carter, Promila Chitkara, Michele Cyran, Rosie Harvey, Susan Highmoor, Peter Jacobsen, Lalithashree Rajesh, Ingrid Snedecor, Savita Thakur

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.

Preface

Welcome to Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces. This guide describes the runtime behavior of the WebCenter Spaces application. Much of this information also applies to WebCenter Portal applications, though it is written with WebCenter Spaces users in mind. (For information about WebCenter Portal applications, see Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.)

This guide provides instructions for such tasks as creating, populating, and managing pages; setting application preferences; and working with services and portlets.

Note:

This guide depicts the application user interface (UI) in screenshots. Users can apply different templates to the application UI to adjust its look and feel; therefore, your view of the application may differ somewhat from the views depicted in screenshots.

Audience

This document is intended for WebCenter application users who are interested in personalizing and customizing application pages and in creating online communities centering around a group project or a shared area of interest. It is also intended for business developers interested in creating enterprise mashups through runtime component wiring.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information, see the following documents in the Oracle Fusion Middleware 11g Release 1 (11.1.1.5.0) documentation set:

- Oracle Fusion Middleware Tutorial for Oracle WebCenter Spaces Users

- Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter

- Oracle Fusion Middleware Developer's Guide for Oracle WebCenter

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action.

italic

Italic type indicates book titles, emphasis, placeholder variables for which you supply particular values, or terms defined in text or the glossary.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

What's New

Release 11.1.1.5.0 is a maintenance release that addresses internal issues and, consequently, strengthens your application experience. For example, in Release 11.1.1.5.0 performance and stress tolerance have been enhanced throughout the application as have error and exception handling.

Note:

Release 11.1.1.5.0 is part of a patch set. Patching involves copying a small collection of files over an existing installation. A patch is normally associated with a particular version of an Oracle product and involves updating from one minor version of the product to a newer minor version of the same product (for example, from Release 11.1.1.4.0 to Release 11.1.1.5.0).A patch set is a single patch that contains a collection of patches designed to be applied together.
All users must move to Release 11.1.1.5.0 for continued support.

Read this quick-reference page for a concise summary of the issues addressed in this release.

Issues Addressed in Release 11.1.1.5.0

The following table provides an overview of the types of issues addressed in Release 11.1.1.5.0.

Feature

Adjustment

Of General Interest

- You can now customize components that are placed inside af:forEach and af:iterator.

- In a scenario in which WebCenter is fronted by OHS, WebTier, or a load balancer, the load balancer host name is now properly seen in connection invitation emails and in MS Office document properties.

- Release 11.1.1.5.0 introduces numerous improvements to the thread safety and performance of the service framework.

- Updates to WLST commands made as part of a patch set are properly picked up.

- Unnecessary LDAP round trips to fetch Profile details have ceased in favor of storing such details in cache.

- Exporting data as an Excel spreadsheet from faces executes properly, even when the component is portletized.

- The process of creating a Resource Catalog and moving components into it in WebCenter Portal applications works as expected.

- The forward-slash character (/) has been removed from the list of Public URIs to prevent unexpected issues.

- A discrepancy in the authorization checks between the WebCenter Spaces UI and the Web Service API has been reconciled.

Accessibility

- Missing labels have been added where needed for screen readers, such as JAWS.

Activity Graph

- URN lookup calls are now batched to prevent a single call that results in too many arguments.

- The calculation of incremental gathering and decay periods has been adjusted.

Activity Stream

- Additional checks are in place to handle the business scope separately when publishing and sharing business-scope activities, thus removing the logging of exceptions when Spaces are not provisioned in a WebCenter Portal application.

- Within a Space, discussions- and announcements-related activities that are published in the Activity Stream are reported only within the scope of that Space. That is, they appear to all Space members, including those members who are also your connections. But they do not appear in the Activity Streams of your connections who are not also members of the Space.

- Import of administration settings is successful regardless of whether the import target table is empty or populated.

- The database query for Activity Stream is significantly accelerated.

- Slide preview operates more effectively in Release 11.1.1.5.0.

- Various fixes are in place to enhance accessibility.

Announcements

- Within a Space, announcements-related activities that are published in the Activity Stream are reported only within the scope of that Space. That is, they appear to all Space members, including those members who are also your connections. But they do not appear in the Activity Streams of your connections who are not also members of the Space.

Comments

- Comments counts are accurate.

Connections

- When invite or manage connections actions are invoked, they open a popup window as expected, rather than the full Connections page.

- When creating a connection list using an API to make it unmodifiable, the UI and data control also do not allow update operations on that list.

Customization Manager

- The Customization Manager works in a clustered environment.

Discussions

- Within a Space, discussions-related activities that are published in the Activity Stream are reported only within the scope of that Space. That is, they appear to all Space members, including those members who are also your connections. But they do not appear in the Activity Streams of your connections who are not also members of the Space.

Documents

- In Documents task flows, you can turn off the task flows' multifile and profile upload features using the Features Off parameter. For information about the Features Off parameter, see the chapter, "Setting Documents Service Task Flow and Document Component Properties," in Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces.

- If a file is rejected in a workflow, and a new version of the file with a different file name is uploaded, the confirmation page properly shows the new file version.

- Various issues in Internet Explorer 7 when uploading a file are resolved.

Events

- Events honors user preferences for date and time.

- Events properly handles characters including quotes, slashes, control characters and Unicode.

Instant Messaging and Presence

- When the presence of a connection changes, it is updated wherever presence is indicated. For example, the Profile page is no longer dependent on a page refresh for the change to be reflected

Pages

- When a user selects Personalize Pages from the Actions menu, the status of the Show Page setting reflects that user's personal setting rather than the value set at the Space level.

Portlets

- Release 11.1.1.5.0 introduces a new version of the Portlet Bridge.

- A new client-side API is available for triggering PPR postbacks to Bridge portlets.
Consider a scenario where you have a portlet inside of a showDetailItem, inside a panelTabbed. There is an AdfItemEvent client-side listener on the showDetailItem. This is called when the tab is closed. But before the tab is closed, you want to check if the portlets contain any unposted data. To achieve this, have the showDetailItem listener call:

AdfDhtmlPortletPeer.syncPortletsAndRestartEvent(event, component)

This will cancel the original event and then call:

AdfDhtmlPortletPeer.syncPortlets(component, context, callback, state)

This will initiate the portlet postbacks for all the portlets inside component. The other three parameters are for creating a callback to call when the portlet postbacks are done. For more information, see Oracle Fusion Middleware Tag Reference for Oracle ADF Faces.

- Portlets with parameters that are tied to a managed bean method are now handled correctly.

- Files required for the WLST portlet registration command are properly added to the portlet consumer dist directory.

- A new _x query string parameter is available for setting on URLs that are passed to the ADF portlet bridge for encoding, resulting in a direct request to the URL from the browser. This enables bridged portlets to make effective use of content delivery networks to serve static resources, such as JavaScript and CSS.

- An ADF Bridge portlet no longer reverts to the Simple skin following a file upload.

- An enhancement was made to allow ADFm events, for which no portlet event has been declared in portlet.xml, to propagate out of the PortletBridge. Additionally, it enables the PortletBinding to forward unexpected PortletEvents automatically as ADFm events.

Profile

- The REST API for Profile is more tolerant under uncommon authentication scenarios.

Resource Catalogs

- With ojdeploy, Resource Catalogs across multiple projects are included in the MAR file.

Spaces

- Space workflows, such as invite member, subscribe to or unscubscribe from Space, and change Space membership, are working as expected when GPA is enabled on the SOA server.

- When a Space administrator revokes a user's create Space privileges, that user sees neither the Create Space link nor its associated icon.

Task Flows

- Since PS1, you can configure Oracle Composer to restrict task flow editing based on task flow permission grants. This is accomplished through a JVM flag. In Release 11.1.1.5.0, you can also accomplish this through a setting in the adf_config.xml file.
In the security-config section of the adf_config.xml file, provide the following entry:

<pe:page-editor-config xmlns:pe=
"http://xmlns.oracle.com/adf/pageeditor/config">
<security-config>
<task-flow-security check-permission="[false]|true" />
</security-config></pe:page-editor-config>

The default for this option is false.

To maintain backward compatibility, the JVM flag -Doracle.composer.enableTaskflowPermissionCheck=true is supported.

- Task flows with buttons that cause navigation and that are exposed as portlets now work properly in Internet Explorer 8.

Templates

- The portlet consumer component is installed automatically from the WebCenter JDeveloper bundle Zip file; manual installation is no longer required.

Part I

Getting Started with WebCenter

Part I of the User's Guide introduces WebCenter Spaces portals and communities and describes the features that are readily available to assist you in their creation.

Part I includes the following chapters:

- Chapter 1, "Introducing WebCenter Spaces"

- Chapter 2, "Leveraging Content Management"

- Chapter 3, "Leveraging Social and Collaborative Services"

- Chapter 4, "Accessing WebCenter Spaces Administration Pages"

1 Introducing WebCenter Spaces

Welcome to Oracle WebCenter Spaces! WebCenter Spaces furnishes all the tools you require to rapidly create portals, communities, and social networking sites capable of accommodating thousands of users and encompassing diverse populations with differing languages.

This chapter defines a few useful terms and provides a sampling of some of the types of portals, communities, and social networking sites you can create using WebCenter Spaces. It also supplies a table of references to details about the resources discussed in this chapter.

This chapter includes the following sections:

- Section 1.1, "Understanding Portals, Communities, and Social Networking Sites"

- Section 1.2, "Planning Your Portals, Communities, and Social Networking Sites"

- Section 1.3, "Where to Look for More Information"

Learn More:

For more detailed information about WebCenter Spaces features that support social networking, see Chapter 3, "Leveraging Social and Collaborative Services."

1.1 Understanding Portals, Communities, and Social Networking Sites

Your decision about what to build naturally falls in line with what you plan to accomplish. This section assists you in that decision by clarifying what is meant by portals, communities, and social networking sites. It includes the following subsections:

- Section 1.1.1, "What Is a Portal?"

- Section 1.1.2, "What Is a Community?"

- Section 1.1.3, "What Is a Social Networking Site?"

1.1.1 What Is a Portal?

A portal is a web destination that presents information and resources that are diverse in location, technology, and derivation, through a single point of entry. Content and technology that originate from widespread sources appear to your users as a cohesive set of information and services that are easily available from one location.

For example, in a WebCenter Spaces portal, a user can look at all the Worklist items coming from their organization's eBusiness Suite, the detailed customer information coming from a CRM suite, and the latest sales figure charts coming from a Business Intelligence tool. Despite these multiple sources, to your user, all of this content is available in one place and appears to be coming from a single source.

Portals offer solutions for aggregating disparate content into one or multiple libraries. Authorized users are provided with controls for uploading and managing such content so that consumers have easy access to what appears to be a cohesive body of knowledge available in one location.

Applications from multiple sources can appear as a family of applications, once again, available from a single source: the portal. Through their portals, users have a go-to destination for all of their self-service applications, such as expense and time reporting, no matter the multiple points of origin. The portal provides an efficient delivery platform that saves users time and effort and creates a positive experience between the enterprise and its employees.

Also contributing to that positive experience, portals deliver personalization capabilities. Personalization provides a means of leveraging the information in a user's Profile to tailor the user's experience of the portal. For example, Mary the manager logs in and sees department-wide results information and links to reporting applications, while Sal the salesman logs in and sees his reports on his own results and links to leads.

WebCenter Spaces portals provide two arenas for the presentation of resources and information: a Space and the Home Space.

Spaces are typically used to create portals and communities that are scoped to a specific audience, for example, a specific division, department, project, or community. Subspaces, which are hierarchically lower than their parent Spaces, enable you to set up, for example, a divisional portal, with child portals for each subdivision.

You can use the Home Space to address all of your company's employees. In addition to its inherent broad appeal—by default, the Home Space is accessible to all authenticated users—the Home Space can be set up to provide a Home Space for every user. This enables each user to have a dashboard of all the information they require for starting their daily work. That is, a portal just for them.

1.1.2 What Is a Community?

A community is a group of individuals gathered together to accomplish a common goal or share a common interest. Communities can be used in conjunction with portals as well as social networks—they are not mutually exclusive.

In WebCenter Spaces, the idea of community is realized in Spaces that are designed to support collaboration among Space members.

Spaces support the formation and collaboration of project teams and communities of interest. They provide a dedicated and readily accessible area for relevant services, pages, and content.

Spaces support the assembly of team and community members through direct addition, invitation, and self-registration. They support internal hierarchies through the assignment of permissions and roles, which offer differing levels of access to Space features and resources. They support structural hierarchies through the creation of Subspaces, the management of which can be delegated to subteams or different lines of business (LOBs).

Spaces bring people together in a virtual environment for ongoing interaction and information sharing.

Learn More:

For more detailed information about Spaces, see Part XI, "Planning and Building a Space".

1.1.3 What Is a Social Networking Site?

Any number of social networking sites, such as Facebook and MySpace, may have already given you a strong understanding of web-based social networking. Users forge connections to each other. That connection provides a free pass to information about each other's activities and the resulting content. That is, links to sites of interest, photo slide shows, and statements reflecting the connection's current state of mind. A connection between two people increases exponentially as each user's connections introduce themselves through recommendations and by commenting and liking streamed posts and links.

WebCenter Spaces does not reimagine social networking, but rather focuses it on the more purposeful environment of your enterprise. Users with common interests and goals can forge connections that expose them to content of interest and enable them to follow and benefit from each other's activities.

You can provide social networking capabilities in both portals and communities—they are not mutually exclusive.

The Home Space is an excellent venue for setting up a site that is focussed on social networking. The Home Space is accessible to all employees, provided they are logged in, making it the best foundation for a broad social network.

In the Home Space, social networking capability is greatly enhanced by the People Connections service. This service provides features for forging connections to other users, viewing and customizing personal profile information, viewing the activities of other users, and sharing such activities, as well as files and links, with a broader audience.

The Home Space may include a set of pages that are created by application administrators and pushed to targeted users. Such pages are called business role pages. Use business role pages to provide content of interest to a specific group of users, such as the Sales team, and prevent uninterested users from seeing it.

Provided they are enabled to do so, users may have the ability to create and customize pages in the Home Space for their eyes only. They can add or upload content of interest specifically to them, and share that content with whomever they choose.

Learn More:

For more detailed information about WebCenter Spaces social network capabilities, see Chapter 3, "Leveraging Social and Collaborative Services."

1.2 Planning Your Portals, Communities, and Social Networking Sites

This section provides an overview of the types of portals, communities, and social networking sites you can build and describes the resources and roles you would need to build them. It also supplies pointers to relevant information in the rest of the guide. This section includes the following subsections:

- Section 1.2.1, "Planning a Home Space to Serve All Users"

- Section 1.2.2, "Planning Multiple Portals Serving All LOBs"

- Section 1.2.3, "Planning a Department Portal"

- Section 1.2.4, "Planning a Department Portal with Diverse Collaborative Teams and Communities"

- Section 1.2.5, "Planning a Division Portal with Teams, Communities, and Social Networks"

1.2.1 Planning a Home Space to Serve All Users

Requirement

Build a highly controlled, secure, and performant corporate portal that focusses on social networking among thousands of users.

Who Will It Serve?

This corporate portal is intended to serve all internal users. Its purpose is to disseminate information about corporate events, accomplishments, and initiatives, and to provide access to corporate resources, such as Payroll, Human Resources, Purchasing, and the like. Additionally, it is meant to enable employees to connect with each other and share all kinds of information about themselves and their endeavors.

To a limited degree, this portal confines access to targeted information to specific audiences. For example, only the sales people see a link to the Sales Manager's blog; only the decision makers see a link to the Purchasing page. All users see the link to the page From the CEO. In some ways, this is like the corporate "family" site. It might replace and improve upon the traditional corporate newsletter as well as provide links to resources that are available to all employees.

What Type of Access Should Users Have?

A small group of people are responsible for creating and managing pages and managing the site's look and feel. Authenticated users—that is, users who are logged in—can interact with social networking services, such as People Connections: and they can set personal Preferences. But they cannot create Personal pages nor perform page management tasks.

What Types of Resources Should Be in Place?

Portal builders require access to site resources, such as application Skins and Navigation, Page templates and Styles, and so on. They require access to application Administration pages where they can specify which resources to apply. They are also likely interested in analyzing Usage and Performance Metrics to determine heavy traffic areas and possible bottlenecks. The Analytics service will be useful to this end.

Within the small set of users who are tasked with building and maintaining the portal, a subset of users should be given the responsibility of establishing and maintaining site Security through the creation and assignment of application roles and permissions.

Such a portal could be based on the Home Space, with its application-wide scope. Basing the portal on a Home Space would simplify and centralize site resource management, and call for a security model with a fairly simple structure.

This type of portal will also make use of a few System pages and Business role pages. System pages are prebuilt utility pages, such as the application login page, that authorized users can customize in terms of content and look and feel. Business role pages are pages targeted to a specific business role, such as a salesperson, an HR representative, a Corporate Trainer, and so on. Each business role page is pushed into the Home Space views of its target audience.

The Documents service, which in encompasses files, Blogs, and Wikis, should be made available to the limited set of users who are allowed to provide content to the portal. The People Connections: service should be made available to all authenticated users to enable them to interact with social networking features, such as Profile, Activity Stream, and Connections.

Connections and Activity Stream are a particularly essential components of a robust social network. Connections enable users to create the network. Within a Home Space, Activity Stream streams the activities of each user's connections. Within a Space, it streams the activities of each Space member.

Liking, Commenting, and Sharing should be available on the Activity Stream to enable users to interact with each other by expressing approval for and commenting on streamed activities and for sharing objects of interest and useful links.

The Activity Graph service will also be of great use. It provides a means of enlarging your users' spheres of interest in WebCenter Spaces by offering recommendations for new connections, suitable items, and relevant Spaces.

You might include the Polls service to provide a means of administering simple polls to the entire corporate population regarding issues, ideas, and events of interest to all.

1.2.2 Planning Multiple Portals Serving All LOBs

Requirement

Build highly controlled, secure, and performant portals to be accessed by thousands of users. Each portal is targeted to a particular LOB. All portals must have consistent branding that is controlled by a limited set of users. The content of each portal is maintained by specific roles within each portal.

Who Will It Serve?

This portal provides a central landing place for all LOBs with the intention of directing each LOB to its own dedicated portal. Each LOB portal in turn offers information of specific interest to that LOB as well as access to External Applications aimed at the LOB's reporting requirements (status, expense, results, and the like).

What Type of Access Should Users Have?

All users have access to the central landing page, which might be the Home Space or the parent Space in a set of Hierarchical Spaces. There are advantages to both. For example, basing the landing page on the Home Space simplifies the security model, at least for that page. Basing it on a parent Space in a hierarchy enables you to take advantage of inheritance of configuration settings, simplifying the task of maintaining consistent branding across portals.

Security would likely be set up in a steeper hierarchy than discussed with the first model. Like the first model, a small set of users control the site resources for all portals, such as the templates, skins, and Resource Catalogs (these provide access to the components one adds to a page). In this multiportal environment, however, management of each portal is delegated to a few people from each LOB, each controlling access, Content management, and maintenance of their specific sites.

What Types of Resources Should Be in Place?

In addition to portal resources, such as Skins, Navigation, Page templates, and the like, LOB portals would find Announcements useful for spreading a word of interest to a like-minded group, immediately or on a selected date and time. The Activity Graph service would be useful for providing recommendations for pages and documents of interest based on an analysis of user activity. The Instant Messaging and Presence service (IMP), would keep department members alert to each others' online status and provide options for contacting another user on the spot. Finally, the Worklist service would be useful for keeping track of workflow notifications and messages channeled through the User Messaging Service (UMS).

1.2.3 Planning a Department Portal

Requirement

Enable each department to build multiple portals in one environment. These portals serve as information-sharing vehicles for their users.

Who Will It Serve?

Each of these portals serves a very large department with internal subdivisions. For example, imagine a large manufacturing corporation that is primarily divided into Marketing, Sales, Accounting, Manufacturing, Fulfillment, and Distribution. Every employee will likely fit under one of those umbrellas, but under a given umbrella there are subdivisions. Accounting will have at least two: one for Accounts Payable and one for Accounts Receivable. They may also handle Budgets, Collections, and Payroll.

Each of these departments has a portal based on a parent Space, such as the Accounting home page, with a hierarchy of Subspaces, each purposed with addressing the information requirements of a given subdivision (Accounts Receivable, Accounts Payable, and so on).

What Type of Access Should Users Have?

All department members have access to the parent Space, which is the landing page for the department. Limited access is provided for Subspaces: users belonging to a subdivision have access to the subdivision's dedicated Subspace in a group of Hierarchical Spaces.

A limited set of users would manage the portal's Resources. These users might control resources for all portals, or there might be a like group of resource managers for each portal, and possibly for each child portal. A limited set of users would handle Content management. It is likely that each portal would have its own team handling Security, and subdivisions may also handle their own.

What Types of Resources Should Be in Place?

Portal Resources and Security are useful to all portals. Hierarchical Spaces are of particular importance in this model. They provide a number of relevant benefits, such as grouping of related content under a given Space; logical navigation for drilling down into required areas for more information; delegated administration; inherited membership; and a flexible security model, where you can configure access to be identical to the parent Space, or allow it to be completely overridden by the administrator of the Subspace.

Services in support of information dissemination, such as the Documents service, the Announcements service, and the Activity Graph service, will likely come into play. Polls scoped to the department or to a subdivision could also prove useful.

1.2.4 Planning a Department Portal with Diverse Collaborative Teams and Communities

Requirement

Enable a controlled set of users to build portal sites, while the rest of the users can build team sites.

Who Will It Serve?

This is another type of departmental portal that provides information of interest to all department members as well as access to Spaces serving focussed project teams and communities of interest.

What Type of Access Should Users Have?

All users have view access to the department portal. A small set of users serve as portal administrators, who control the look and feel and content of the main site and delegate responsibilities to managers of teams and communities. A larger pool of users are assigned Space moderator roles, to enable them to manage and monitor their team and community Spaces.

What Types of Resources Should Be in Place?

In addition to all the portal-building Resources mentioned in other models, many collaborative tools will come into play. For example, the Lists service will provide useful features for creating things like project issues lists, milestones lists, and lists of deliverables. Project teams can leverage the Events service for meeting planning and event scheduling. The Members task flow is vital for keeping track of who is on the team or who belongs to the community. Team member can use Wikis for preserving meeting agendas and note taking. Teams and Communities can use Blogs for evangelizing technologies and ideas and disseminating expertise.

It will serve the users of this portal to provide the Links service to enable the creation of connections between relevant application objects, for example, from a list of project milestones to project design documents and functional specifications. Naturally, the Documents service will frequently come into play.

The Discussions service will be essential for enabling the creation and capture of discussions among colleagues. This is particularly useful for retaining a record of such exchanges and for enabling a widely distributed workforce to participate in their own time.

1.2.5 Planning a Division Portal with Teams, Communities, and Social Networks

Requirement

Enable a controlled set of users to build portal sites, while the rest of the users can build team sites and socialize using social networking features.

Who Will It Serve?

This portal will be lively and robust and serve a corporate division with a fairly open policy toward internal collaboration and communication.

What Type of Access Should Users Have?

All users will have access to the Home Space and may have permission to create their own Personal pages in their view of it. Users belonging to a subdivision will have access to the portal dedicated to that subdivision. A small team of users will control division and subdivision home pages, including Security and Content management, but control of team sites and communities will be delegated to key members of those teams and communities. All users should have permission to update People Connections: data, which would enable them to make connections, update their profiles, view the activities of their connections, and share resources.

What Types of Resources Should Be in Place?

Resources for building portals and managing portal Security should be readily available to the small set of users administering the division and subdivision portals. Resources for securing Spaces, creating Space pages, and managing services within the Space scope should be available to users tasked with such activities. A collaborative environment, either teams or communities, will benefit tremendously from the availability of the Discussions service. The Search service will be useful for searching a large set of portals with a large volume of content. The Tags service will enable users to add their own personally meaningful search terms and share them with other users. Naturally, you will want Content management, People Connections:, Lists, and Events services to support the capture, delivery, and preservation of schedules, ideas, goals, and headway. Polls will be useful across the board for taking stock. The Links service will enable users to provide links from one location to another or from a location to an application object, such as a document, a note, an event, and so on.

Connections and Activity Stream are a particularly essential components of a robust social network. Connections enable users to create the network. Within a Home Space, Activity Stream streams the activities of each user's connections. Within a Space, it streams the activities of each Space member.

Liking, Commenting, and Sharing should be available on the Activity Stream to enable users to interact with each other by expressing approval for and commenting on streamed activities and for sharing objects of interest and useful links.

The Activity Graph service will also be of great use. It provides a means of enlarging your users' spheres of interest in WebCenter Spaces by offering recommendations for new connections, suitable items, and relevant Spaces.

You might include the Polls service to provide a means of administering simple polls to the entire corporate population regarding issues, ideas, and events of interest to all.

To assist your users in keeping informed of changes to their connections and to Spaces and application objects of interest, you can incorporate Notifications into these portals. This gives users a means of subscribing to be notified over selected messaging channels when their subscribed objects change.

1.3 Where to Look for More Information

Table 1-1 provides links to information about all the resources discussed in this chapter.

Table 1-1 Where to Look for More Information

Resource

Where to Look

Activity Graph

Section 58, "Working with the Activity Graph Service"

Administration pages

Section 4, "Accessing WebCenter Spaces Administration Pages"

Analytics

Chapter 55, "Analyzing Usage and Performance Metrics"

Announcements

Chapter 59, "Working with the Announcements Service"

Blogs

Chapter 48, "Working with Blogs"

Business role pages

Section 7.1, "Working with Business Role Pages"

Content management

Part X, "Working with Content"

Discussions

Chapter 60, "Working with the Discussions Service"

Documents

Chapter 39, "Introduction to Adding and Managing Content"

Events

Chapter 61, "Working with the Events Service"

External Applications

Chapter 6, "Configuring Services, Portlet Producers, and External Applications"

Hierarchical Spaces

Chapter 54, "Working with a Space Hierarchy"

Home Space

- Section 7.2, "Working with Personal Pages"

- Chapter 29, "Exploring the Home Space"

Instant Messaging and Presence

Chapter 62, "Working with the Instant Messaging and Presence Service (IMP)"

Languages

Chapter 24, "Working with Multilanguage Portals"

Liking, Commenting, and Sharing

Chapter 34, "Liking, Commenting On, and Sharing Objects"

Links

Chapter 63, "Working with the Links Service"

Lists

Chapter 64, "Working with the Lists Service"

Members task flow

Section 52.4, "Working with the Space Members Task Flow"

Navigation

Chapter 11, "Working with Navigation"

Notifications

Chapter 36, "Setting Up Your Personal Subscriptions and Notifications"

Page templates

- Chapter 12, "Working with Page Templates"

- Chapter 13, "Adding Spaces Components to Your Templates"

People Connections:

- Connections

- Activity Stream

- Profile

- Message Board

- Feedback

- Chapter 30, "Managing Your Profile"

- Chapter 31, "Creating Your Social Network"

- Chapter 32, "Tracking Your Connections' Activities"

- Chapter 33, "Posting and Managing Messages and Feedback"

- Section 34.3.3.1, "What You Should Know About the Publisher Task Flow"

Personal pages

- Section 7.2, "Working with Personal Pages"

- Chapter 38, "Creating and Managing Personal Pages"

Polls

Chapter 67, "Working with the Polls Service"

Preferences

Chapter 35, "Setting Your Personal Preferences"

Resource Catalogs

Chapter 16, "Working with Resource Catalogs"

Resources

Chapter 10, "Working with the Resources that Compose a Portal or Community"

Search

Chapter 56, "Working with the Search Service"

Security

Part VI, "Securing Your Portal"

Skins

Chapter 14, "Working with Skins"

Styles

Chapter 15, "Working with Page Styles"

System pages

Section 7.3, "Working with System Pages"

Tags

Chapter 57, "Working with the Tags Service"

Usage and Performance Metrics

Chapter 55, "Analyzing Usage and Performance Metrics"

Wikis

Chapter 47, "Working with Wiki Documents"

Worklist

Chapter 70, "Working with the Worklist Service"

2 Leveraging Content Management

The Documents service and the flexibility of Content Presenter are available to you in WebCenter Spaces for including content from connected content repositories.

In addition to selecting and displaying content on a page in a WebCenter Spaces application, you can define workflows on content in a Space, create and edit content at runtime, collaborate on documents, integrate with Microsoft Office and Explorer, and add wikis and blogs to an application.

This chapter provides a survey of content management features and offers pointers to the information that will assist you in implementing them. It includes the following sections:

- Section 2.1, "What Is Content Management?"

- Section 2.2, "Leveraging Content Management Features"

Audience

This chapter is intended for WebCenter Spaces users interested in leveraging content management features to manage and provide access to content in connected content repositories using WebCenter Spaces.

2.1 What Is Content Management?

Content management refers to the functionality available in WebCenter Spaces to add content from one or more connected content repositories to an application, enabling application developers and end users with appropriate permissions to manipulate and display that content in a variety of ways:

- Content Presenter. Enables you to precisely customize the selection and presentation of content in a WebCenter Spaces application. The Content Presenter task flow is available only when the connected content repository is Oracle Content Server and your WebCenter Spaces administrator has completed the prerequisite configuration. With Content Presenter, you can select an Oracle Site Studio file, a single item of content, multiple content items, query for content, or select content based on the results of a WebCenter Personalization Conductor scenario, and then select a template to render the content on a page in a WebCenter Spaces application. Content Presenter has no dependency on the Documents service for adding or managing the content it displays.

Learn More:

For more information about Content Presenter, see Chapter 40, "Publishing Content Using Content Presenter."

- Documents service task flows. Provide a variety of formats to display folders and files on a page in a WebCenter Spaces application. You can choose the task flows appropriate for your application to provide features for accessing, adding, and managing folders and files; configuring file and folder properties; and searching file and folder content. The Documents service task flows are available when the connected content repository is Oracle Content Server, Oracle Portal, or SharePoint, and your WebCenter Spaces administrator has completed the prerequisite configuration. If the content repository is Oracle Content Server, you can use both the Documents service task flows and the Content Presenter task flow to add and preview Oracle Site Studio files.

Learn More:

For information about the Documents Service task flows available in WebCenter Spaces, and the unique characteristics of each task flow, see Section 41.1, "What You Should Know About the Documents Service Task Flows."

- Document components. Display an individual file on a page as a linked document, an inline preview, or an image.

Learn More:

For information about document components you can add to a page in a WebCenter Spaces application, see Section 41.2, "What You Should Know About Document Components."

- Wikis. Add wiki documents for end users to collaborate to create content that is relevant, useful, and up-to-date.

Learn More:

For information about including wikis in a WebCenter Spaces application, see Chapter 47, "Working with Wiki Documents."

- Blogs. Add blogs for end users to add, edit, and manage blog posts.

Learn More:

For information about including blogs in a WebCenter Spaces application, see Chapter 48, "Working with Blogs"

2.2 Leveraging Content Management Features

Content is the backbone of any Web-based project. This section provides a summary of the full scope of content management functionality available to you in WebCenter Spaces. It includes the following subsections:

- Section 2.2.1, "Displaying Individual Files"

- Section 2.2.2, "Displaying and Managing the Contents of a Folder"

- Section 2.2.3, "Adding and Managing Document Workflow"

- Section 2.2.4, "Creating and Managing Content at Runtime"

- Section 2.2.5, "Collaborating on Documents"

- Section 2.2.6, "Integrating with Microsoft Office and Explorer"

- Section 2.2.7, "Adding and Managing Wikis"

- Section 2.2.8, "Adding and Managing Blogs"

2.2.1 Displaying Individual Files

You can add dynamic previews of individual images and files using document components (link, image, and inline frame), a Content Presenter task flow, or a Documents service task flow:

- Document components:

- A Link displays the name of a selected file as a link, which you can click to display the file content in its native application.

- An Inline Frame displays the content of a selected file as a preview.

- An Image displays a selected file as an image.

- A Content Presenter task flow displays a selected file in the default display template for its file type. For information about the out-of-the-box display templates, see Section 40.5, "Selecting a Display Template."

- Documents service task flows:

- A Document Viewer task flow displays a preview of a file, or file properties for files that do not support a preview.

- A Document Mini Properties task flow displays the Basic properties of a file in a read-only view.

- A Document Properties task flow displays both Basic and Advanced properties of a file, along with an Edit button to allow you to modify property values.

- A Document Version History task flow displays a list of versions of a file, allowing for deletion of a selected version.

Learn More:

For more information, see:

- Chapter 40, "Publishing Content Using Content Presenter"

- Section 41.1, "What You Should Know About the Documents Service Task Flows"

- Section 41.2, "What You Should Know About Document Components"

- Section 41.3, "Adding a Selected Folder or File to a Page"

- Section 41.4, "Adding a Documents Service Task Flow to a Page"

- Section 41.5, "Understanding the Documents Service Task Flow Menus and Actions"

2.2.2 Displaying and Managing the Contents of a Folder

The content task flows available in WebCenter Spaces provide flexibility in how content displays on a page. You can display and manage the contents of a folder using the Content Presenter task flow to precisely customize the selection and presentation of content, or you can use one of the Documents service task flows that suits your purposes for presenting content management functionality:

- A Content Presenter task flow displays a selected folder in the default display template for folder content: List View. For information about the out-of-the-box display templates, see Section 40.5, "Selecting a Display Template."

- Documents service task flows:

- A Document Explorer task flow displays folders and files in two panes, combining the functionality of the Document Navigator and Folder Viewer task flows. It provides in-place previewing and editing, and robust management capabilities.

- A Document List Viewer task flow displays folders and files in a single pane as a flat listing. It provides preview and editing in a separate window, and some management capabilities.

- A Document Manager task flow displays folders and files as specified by its Layout property: Explorer, Table, or Tree Table.

- A Document Navigator task flow displays a simple listing of folders and files in a single pane, providing expand/collapse on folders to show the full hierarchy.

- A Folder Viewer task flow displays the contents of a folder in a single pane as a flat listing, providing in-place preview and editing, and robust management capabilities.

- A Recent Documents task flow displays a list of the files most recently created or modified in the current folder.

Learn More:

For more information, see:

- Chapter 40, "Publishing Content Using Content Presenter"

- Section 41.1, "What You Should Know About the Documents Service Task Flows"

- Section 41.3, "Adding a Selected Folder or File to a Page"

- Section 41.4, "Adding a Documents Service Task Flow to a Page"

- Section 41.5, "Understanding the Documents Service Task Flow Menus and Actions"

2.2.3 Adding and Managing Document Workflow

You can define workflows on Space folders that reside in Oracle Content Server. When a folder is assigned a workflow, any file added to that folder must be approved or rejected by one or more assigned approvers. Documents service task flows provide access to the workflow-enabled content.

Learn More:

Chapter 43, "Working with Workflow-Enabled Content"

2.2.4 Creating and Managing Content at Runtime

End users of a WebCenter Spaces application can create and manage content at runtime:

- The Documents service task flows offer capabilities to create, open, edit, delete, copy, rename, move, share, search, view, or manage information about folders and files in the connected content repository.

- In a Content Presenter task flow, end users can edit wikis or HTML files, and create or edit Site Studio files in the connected Oracle Content Server content repository.

Learn More:

Chapter 44, "Creating and Managing Content at Runtime"

2.2.5 Collaborating on Documents

You can collaborate on documents during the development of a document, or when a document is available to all users of a WebCenter Spaces application. Collaboration in WebCenter Spaces encompasses the review and approval process available through workflows, wikis that allow multiple authors, sharing links to documents, and using the Oracle AutoVue product.

Learn More:

Chapter 45, "Collaborating on Documents"

2.2.6 Integrating with Microsoft Office and Explorer

WebCenter Spaces integrates with Microsoft Office and Windows Explorer to provide you with flexibility in managing files in a Space when the content repository is Oracle Content Server.

Learn More:

Chapter 46, "Working with Microsoft Office and Explorer Integration"

2.2.7 Adding and Managing Wikis

You can add wiki documents and wiki pages to a WebCenter Spaces application, which multiple users can use to create and edit content that is relevant, useful, and up-to-date.

Learn More:

- Chapter 47, "Working with Wiki Documents"

2.2.8 Adding and Managing Blogs

You can create and manage personal blogs to record experiences and opinions, and group related blog posts.

Learn More:

- Chapter 48, "Working with Blogs"

3 Leveraging Social and Collaborative Services

Today no modern portal deployment is complete without some notion of social interaction—whether it is blogs or discussions or integration with social media (such as Facebook or Twitter). Your CEO may blog about product direction, your product teams may initiate discussions in online forums. All of these activities, once exotic, are now fundamental. Support must be available for virtual team sites, where representatives from different lines of business, or even different enterprises—such as your partners and suppliers—can communicate, collaborate, and socialize on a specific business task.

A powerful and easy-to-master array of services and features are available in WebCenter Spaces for introducing social networking application-wide and enhancing communication and collaboration within communities and teams.

This chapter provides a survey of these features and offers pointers to the information that will assist you in implementing them.

This chapter includes the following sections:

- Section 3.1, "What Is Social Networking?"

- Section 3.2, "What Are Communities and Teams?"

- Section 3.3, "Leveraging Social and Collaborative Features and Services"

Audience

This chapter is intended for application administrators interested in leveraging social networking features to build highly collaborative communities using WebCenter Spaces.

3.1 What Is Social Networking?

Any number of social networking sites, such as Facebook and MySpace, may have already given you a strong understanding of web-based social networking. Users forge connections to each other. That connection provides a free pass to information about each other's activities and the resulting content. That is, links to sites of interest, photo slide shows, and statements reflecting the connection's current state of mind. A connection between two people increases exponentially as each user's connections introduce themselves through recommendations and by commenting and liking streamed posts and links.

WebCenter Spaces does not reimagine social networking, but rather focuses it on the more purposeful environment of your enterprise. Users with common interests and goals can forge connections that expose them to content of interest and enable them to follow and benefit from each other's activities.

John and Mary

For example, Mary is the Manager of Financial Applications at myCorp. She meets John, the myCorp Director of Accounting, at a company-sponsored seminar. They forge a connection. In his Activity Stream, John sees that Mary has published a white paper on Financial Application Futures. John reads it and realizes that one of the innovations Mary hypothesizes would introduce valuable efficiencies into his own operation. John gives the paper a thumbs up (through Liking) and comments on the streamed item. In his comment, John tells Mary that he sees an immediate and beneficial application of her ideas and suggests a meeting. Out of that meeting, the Internal Accounting Refit community is born.

3.2 What Are Communities and Teams?

Communities and teams are groups of people gathered together to accomplish a common goal or share a common interest. In WebCenter Spaces, the idea of communities and teams is realized in a Space.

Spaces support the formation and collaboration of project teams and communities of interest by providing a dedicated and readily accessible area for relevant services, pages, and content. Spaces support the assembly of team and community members through direct addition, invitation, and self-registration. They support internal hierarchies through the assignment of permissions and roles, which offer differing levels of access to Space features and resources. They support structural hierarchies through the creation of Subspaces, the management of which can be delegated to subteams or different lines of business (LOBs).

Spaces bring people together in a virtual environment for ongoing interaction and information sharing. In essence, Spaces enable the formation and support of social networks.

Project Internal Accounting Refit

For example, the Space that John created, Internal Accounting Refit, supports the goal of customizing, deploying, and training for the department's accounting software. John assembles a team from many LOBs to accomplish this goal. He starts by creating Space roles and assigning them various levels of permissions. He adds team members to the Space and assigns them roles according to the level of access he intends each to have. He creates a shallow Space hierarchy by adding a Subspace for each LOB. Then he delegates the moderation of each Subspace to each LOB lead. He enables and configures useful services to ensure all members have access to the collaborative tools that will promote project success.

Learn More:

For information about creating and managing Spaces and Subspaces, see Part XI, "Planning and Building a Space".

3.3 Leveraging Social and Collaborative Features and Services

A significant number of Space services and features support the formation and success of project- and interest-based communities.

This section offers an overview of these services and features and provides a view of them through the lens of accomplishing John's goals. It includes the following subsections:

- Section 3.3.1, "What Are Social Networking and Collaborative Services?"

- Section 3.3.2, "Leveraging People Connections"

- Section 3.3.3, "Leveraging Announcements, Discussions, and Events"

- Section 3.3.4, "Leveraging Liking, Commenting, and Sharing"

- Section 3.3.5, "Leveraging Instant Messaging and Presence"

- Section 3.3.6, "Leveraging Polls and Activity Graph"

- Section 3.3.7, "Leveraging Tagging and Linking"

- Section 3.3.8, "Leveraging Wikis and Blogs"

- Section 3.3.9, "Leveraging Lists"

3.3.1 What Are Social Networking and Collaborative Services?

Table 3-1 provides a high-level overview of the social and collaborative services and features offered through WebCenter Spaces. Each description includes a link to more information.

Table 3-1 Social and Collaborative Services and Features in WebCenter Spaces

Service or Feature

Description

Activity Graph service

Provides suggestions for people that a user may be interested in connecting with, based on existing connections and shared interaction with objects in the application. It also directs users to Spaces or items that may be of interest, based on similar interactions with those Spaces or items the user is currently viewing. For more information, see Chapter 58, "Working with the Activity Graph Service."

Announcements service

Provides a quick, convenient way to create and distribute messages to all users within the current Space, instantly or at a specified date and time. For more information, see Chapter 59, "Working with the Announcements Service."

Blogs

An offering of the Documents service, blogs provide a means of producing an online, open diary for recording thoughts and opinions that, in a business setting, evangelize technologies, share expertise, and ruminate about future directions. For more information, see Chapter 48, "Working with Blogs."

Commenting

Provides a means of adding your thoughts, opinions, and questions directly to a given application object. For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

Discussions service

Provides text-based discussions with other members of a Space. Use Discussions service task flows to create forums, post questions, and search for answers. Discussion forums additionally provide the means to preserve and revisit discussions. For more information, see Chapter 60, "Working with the Discussions Service."

Events service

Provides calendars for scheduling meetings, appointments, and any other type of occasion on view for all members of a given Space. Also provides users with a means of viewing their personal Microsoft Exchange calendar within the Home Space and overlaying Space calendars on top of the personal calendar to view a full schedule in a single calendar. For more information, see Chapter 61, "Working with the Events Service."

Instant Messaging and Presence service

Provides a means of viewing the presence status of other authenticated users and offers on-the-spot access to instant messaging and mail. Additionally, when users travel, they can connect to a 3rd-party network presence service, such as Yahoo! Messenger. For more information, see Chapter 62, "Working with the Instant Messaging and Presence Service (IMP)."

Liking

Provides an accumulative rating system that enables you to see at a glance which objects are viewed most favorably by you and other users. A counter keeps track of the number of users who like the object. In a group of objects, you can determine the most favored by its number of likes. For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

Links service

Provides a means of explicitly associating two objects with each other through easy-access reference points, called links. The Links service assists with setting up these links from one application object to another. For example, you can associate a project plan document with a list of project issues. When users access the list, they can also immediately access the project plan by clicking a link that appears on the list. The Links service also provides a quick way to create new objects when establishing a link. For more information, see Chapter 63, "Working with the Links Service."

Lists service

Provides tools for creating, publishing, and managing lists. Users can create lists from Excel spreadsheets, from prebuilt templates, or from scratch. As lists are developed, they become available in the Resource Catalog. Users can add lists from the catalog to any page in the Space in which they were created. For more information, see Chapter 64, "Working with the Lists Service."

People Connections service

The real workhorse of social networking in WebCenter Spaces, the People Connections service provides a means of forging connections between users and partaking of the fruits of this service's other features as a result. View connections' activities in the Activity Stream. Access their Profiles. Send them messages with attachments, such as files and links through the Publisher task flow or Message Board. Post remarks on their efforts through Feedback. For more information, see:

- Chapter 30, "Managing Your Profile"

- Chapter 31, "Creating Your Social Network"

- Chapter 32, "Tracking Your Connections' Activities"

- Chapter 33, "Posting and Managing Messages and Feedback"

- Section 34.3.3.1, "What You Should Know About the Publisher Task Flow"

Polls service

Provides tools for creating, administering, and taking online polls. Use polls to survey your audience, check their recall of important information, gather feedback on the efficacy of presentations—that is, solicit responses on anything that promotes the excellence of the team. For more information, see Chapter 67, "Working with the Polls Service."

Sharing

Provides on-the-spot distribution of items, files, and URLs of particular interest to a selected audience. For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

Tags service

Provides a means of associating a personally meaningful search term to an application object, making that object easy to find through search results. Classifying an item with a tag enables you to gather disparate items into a cohesive body of knowledge and share that knowledge with others. For more information, see Chapter 57, "Working with the Tags Service."

Wikis

Epitomizes the concepts of community and collaboration by allowing all authorized community members to contribute their information to the greater body of knowledge through the wiki. For more information, see Chapter 47, "Working with Wiki Documents."

3.3.2 Leveraging People Connections

The People Connections service delivers core social networking functionality through such features as Connections, Activity Stream, Profile, Message Board, and Feedback.

Connections furnishes the means of forging connections between WebCenter Spaces users. When one user connects to another, it opens each to a flow of information about the other's activities and provides instant access to other social networking capabilities through People Connections.

Activity Stream provides a continuous stream of information about your own and other users' activities. The files your connections upload are available in the stream as are status messages, links, and notifications about specific types of activities. Such activities can include:

- John is now connected to Mary

- Mary revised the document financialApplicationFutures.docx

- John created the Space Internal Accounting Refit

- And so on

Each streamed item that alludes to an object provides a link to that object, and, in some cases, a preview of the object itself.

Profile offers a window onto information about a given connection, most of which comes from your company's LDAP identity store. A user's connections can view authorized sections of his Profile for such useful information as his contact numbers, his department, his job title, his management chain, and the like.

Message Board and Feedback supply features for entering and viewing messages between connections or posting feedback.

You can configure an instance of the Activity Stream task flow to stream only those activities occurring in the scope of a named Space.

Project Internal Accounting Refit

And that's what John has done. He recognizes the value of streaming the activities of his community. After all, seeing the streamed item about Mary's white paper is what got him started on this project. He appreciates that all members of the Internal Accounting Refit Space will automatically see the Space-related activities of other members in the scoped Activity Stream. To alert team members to this feature, he places an Announcement task flow on the Space home page and posts the following announcement:

Keep your eye on the stream! You can view all Space-related activities streaming from every Space member. Watch for activities, documents, and links of interest.

Learn More:

For information about the many features of the People Connections service, see:

- Chapter 30, "Managing Your Profile"

- Chapter 31, "Creating Your Social Network"

- Chapter 32, "Tracking Your Connections' Activities"

- Chapter 33, "Posting and Managing Messages and Feedback"

3.3.3 Leveraging Announcements, Discussions, and Events

The Announcements service offers a means of broadcasting an announcement instantly or at a time you choose to all members of a given Space.

While announcements offer effective one-way communication, the Discussions service supplies an excellent instrument for creating and managing discussion forums and topics. Members can add to the community's knowledge base by asking or answering questions that are relevant to the current effort and preserving that information for others to reference or challenge. Discussions provides a virtual meeting place where community members can deliberate, discuss, and collaborate, each according to the restrictions of his or her own schedule.

But when common scheduling times can be orchestrated, meetings and events can be arranged easily through the Events service. The Events service provides a community calendar, which can be used to schedule and post project and community meetings and events. The Events calendar is scoped to its current Space, preventing clutter and noise from other teams.

Project Internal Accounting Refit

John schedules a meeting with all LOB leads using the Events calendar. His agenda is to open the question of the best technology to use going forward. He captures meeting minutes on the LOB Meeting Minutes wiki that he created for this purpose in his team's Space. The LOBs are able to narrow the list down to three brands. John opens the discussion to the entire team through the Technology discussion forum. On this, John solicits the teams' opinions on each potential selection. Alok provides insight into one of the options, pointing out a weakness the LOB leads hadn't considered. Fifteen team members express agreement with Alok's reservations by liking his topic reply. This seems to be a very strong endorsement for omitting this option and selecting from the other two.

Learn More:

For information about Announcements, Discussions, and Events, see:

- Chapter 59, "Working with the Announcements Service"

- Chapter 60, "Working with the Discussions Service"

- Chapter 61, "Working with the Events Service"

3.3.4 Leveraging Liking, Commenting, and Sharing

Liking, commenting, and sharing are integrated with many WebCenter Spaces services right out of the box. They furnish the opportunity to team members to share, comment on, and express approval for a document, a topic reply, a streamed item, a wiki, and a blog.

You can view Liking as a type of quick poll that captures and returns on-the-spot information about the relative popularity of an application object.

You can find more verbose opinions about application objects in Comments. Wherever there is liking, there is commenting, where users can enter suggestions, opinions, questions, and other relevant communication directly on the objects to which they apply.

Sharing provides a means of sending links to content of interest to a selected audience.

Project Internal Accounting Refit

John does this frequently. As information that is relevant to his project streams in from his other Space memberships, he shares slide presentations, charts, technology updates, and the like with his project team. Today, he sent a paper to Alok that supports Alok's reservations about the candidate technology.

Alok is pleased that John shared this document. He expresses his liking for the document, clicks the link to read the document, and then clicks John's name on the document to open an instant dialog with him.

Learn More:

For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

3.3.5 Leveraging Instant Messaging and Presence

The Instant Messaging and Presence (IMP) service provides a means of observing the presence status of other authenticated users (for online, busy, away, and offline) and delivers interaction options, such as instant messaging and mail.

Figure 3-1 The Presence Icon for Online Users

When Instant Messaging and Presence is available, every application object that publishes a user name with a presence icon becomes a conduit to different forms of instant communication. Any WebCenter service that exposes a user name can integrate with the IMP service. Such services include Discussions, Documents, Mail, and Lists.

Project Internal Accounting Refit

Once Alok has read the document, he notices that John's presence status is Online. He clicks John's name on the technology article, and a context menu opens with options for contacting John. Alok selects instant messaging and starts a conversation. Here is a portion of this exchange:

...
ALOK: will do! :) ... btw, is there a code name for this project?
JOHN: no, why?
ALOK: internal acct'ng refit is a mouthful.
JOHN: true
ALOK: how about AIR
JOHN: accounting internal refit? i like air, but
ALOK: right ... was discussing with team
ALOK: popular selections were zip, freeway, and bux (air was mine)
JOHN: if team is interested, let's run a poll
JOHN: i'm ok with any of these
ALOK: i'm on it!

Learn More:

For more information about IMP, see Chapter 62, "Working with the Instant Messaging and Presence Service (IMP)."

3.3.6 Leveraging Polls and Activity Graph

The Polls service provides tools for creating, administering, and taking online polls. Use polls to survey your audience, check their recall of important information, gather feedback on the efficacy of presentations—that is, solicit responses on anything that promotes the excellence of the team.

While polls solicit the opinions of others, the Activity Graph service gathers intelligence behind the scene to generate opinions tailored to individual users.

The Activity Graph service provides a means of enlarging a user's sphere of interest in WebCenter Spaces by offering recommendations for new connections, suitable items, and relevant Spaces. It does this by tracking each user's application activity in an activity graph. The Activity Graph engine provides a central repository for actions that are collected by enterprise applications. Activities are analyzed and returned as specific recommendations for individual users. The Activity Graph service is also extentensible by allowing customers to track their custom events and recommend their own business objects.

Project Bux

In John's research on his technology options, he accesses a number of articles that discuss the pros and cons of each selection. As a result, he finds recommendations for similar articles in his personal view of an Activity Graph task flow. He tags one of these bux so he can easily find it in a Search, and adds a link to it from the page he creates to make his case to Finance and Operations.

Learn More:

For more information about Polls and Activity Graph, see:

- Chapter 67, "Working with the Polls Service"

- Chapter 58, "Working with the Activity Graph Service"

3.3.7 Leveraging Tagging and Linking

Tagging provides a means of associating a personally meaningful search term to an application object, making that object easy to find through search results. Your tags provide a higher level of relevance from search results for yourself and others by augmenting results with additional items that you or others have tagged. Classifying an item with a tag enables you to gather disparate items into a cohesive body of knowledge and share that knowledge with others through the Tag Center or a shared saved search.

Linking offers a mechanism for creating a form of ad hoc navigation by enabling you to associate a relevant and useful object with the current context. For example, you can link from a page to a document, a list to a discussion, a list row to an event. You can link to an existing object or create the target object on the spot.

Project Bux

John and Mary have collaborated on a list of project milestones. The first planned milestone is the project kickoff meeting. From the milestones list, Mary creates a link to an Event using the Link to New option. A dialog opens where she is able to schedule a date and time for the meeting and provide location details. The entire team can refresh their memories anytime they need to by clicking the link on the milestones list or referring to the community calendar.

Mary creates the blog buxBashBlog, to track the progress of the upcoming kickoff and generate buzz. Eighty percent of the team expresses approval or comments on different blog posts. The air is filled with excited anticipation.

Learn More:

For more information about tagging and linking, see:

- Chapter 57, "Working with the Tags Service"

- Chapter 63, "Working with the Links Service"

3.3.8 Leveraging Wikis and Blogs

In WebCenter Spaces, the creation of blogs and wikis has been vastly simplified. All you must do is select a blog or wiki option from the Create Page dialog. No additional configuration is required.

Blogs provide an excellent medium for evangelizing selected technologies, logistical changes, and any other organizational shifts you are eager to promote.

Wikis epitomize the concepts of community and collaboration by enabling all authorized community members to contribute their information to a greater body of knowledge. Wiki pages are web pages that offer in-place editing using HTML or a simple mark-up language. Users with sufficient permissions on a wiki page can add, revise, or delete content.

Wikipedia is a prime example of a wiki (http://www.wikipedia.com). Users from all over the world collaborate to create and edit Wikipedia pages, resulting in a rich, dynamic knowledge base for everyone's benefit.

Project Bux

Alok and his team have mapped out the logical flow of information for the upcoming customization. They collaborate on a wiki that captures each decision point and describes the conditions that influence the options available at each point. Tina, the training LOB lead, adds a column to the wiki and makes suggestions or asks questions about each point.

Alok, IMs Doris with a link to the wiki, asking her to address Tina's questions. Doris edits the wiki, as requested. Then she IMs Tina, suggesting a follow-up meeting to ensure all is clear. Tina schedules the meeting on the community Calendar. She navigates to the Training Project Issues list in her LOB's Subspace and checks off the issues, clarify project details and identify subject matter expert, entering Doris' name in the list's Contacts column. She adds a link to the scheduled meeting on the second row.

Learn More:

For more information about wikis and blogs, see:

- Chapter 47, "Working with Wiki Documents"

- Chapter 48, "Working with Blogs"

3.3.9 Leveraging Lists

Lists are useful for so many Space activities, such as tracking issues, capturing project milestones, publishing project assignments, and much more. The lists you create in WebCenter Spaces can be widely varied in their complexity. For example, you can start with a list of team members, and then include columns for contact information, project role, and links to relevant documents, such as any plans or proposals associated with a listed team member.

Project Bux

Finance and Operations approves John's project and provides a budget. John posts an announcement and IMs Mary to congratulate her on their mutual success. John creates a master list of project milestones, and links each row of high-level milestones to the pages containing each LOB's milestones. The project Activity Stream flows with information about new pages, new documents, new connections, and the like. Discussion topics proliferate. Polls are launched. Everyone is communicating, collaborating, and generating informed, consistent content.

Learn More:

For more information about Lists, see Chapter 64, "Working with the Lists Service."

4 Accessing WebCenter Spaces Administration Pages

This chapter describes how to access administration pages in WebCenter Spaces. It contains the following sections.

- Section 4.1, "Accessing the WebCenter Administration Page"

- Section 4.2, "Performing Actions From WebCenter Spaces Administration Pages"

Audience

The content of this chapter is intended for WebCenter Spaces administrators. Users granted the WebCenter Spaces Administrator role or a custom role that grants one of the following permissions:

- Application-Manage All

- Application-Manage Configuration

- Application-Manage Membership

4.1 Accessing the WebCenter Administration Page

Many administrative actions are performed from WebCenter Spaces Administration pages. Once you log in as the application administrator, there are a couple of ways to access this page:

- Click the Administration link.

- Use the following URL to navigate to the WebCenter Spaces Administration page:

http://host:port/webcenter/spaces/admin

See Also:

Appendix A, "WebCenter Spaces User Interface URLs."

4.2 Performing Actions From WebCenter Spaces Administration Pages

In WebCenter Spaces, there are five main Administration pages: Spaces, Pages, Resources, Security, and Configuration (Figure 4-1):

Figure 4-1 WebCenter Spaces Administration Pages

Table 4-1 describes the actions administrators can perform from Administration pages and lists the permission required to perform them.

Table 4-1 WebCenter Spaces Administration Pages

Page

Description

Required Permission

Spaces

- Spaces

- Space Templates

Use this page to manage Spaces and Space templates. For more information, see:

Performing Administrative Tasks For All Spaces

Performing Administrative Tasks For All Space Templates

Importing and Exporting Spaces and Space Templates

Manage All

or

Manage Configuration

Pages

- Business Role Pages

- Personal Pages

- System Pages

Use this page to manage business role pages, personal pages, and system pages in WebCenter Spaces. For more information, see:

Working with Business Role Pages

Working with Personal Pages

Working with System Pages

Manage All

or

Manage Configuration

Resources

Use this page to manage application-level resources for WebCenter Spaces, such as page templates, skins, and task flows. For more information, see:

Working with the Resources that Compose a Portal or Community

Manage All

or

Manage Configuration

Security

- Users and Groups

- Roles

Use this page to manage WebCenter users and roles. For more information, see:

Managing Users, Roles, and Permissions

Manage All

or

Manage Members

Configuration

- General

- Services

Use the Configuration page to customize WebCenter Spaces. For example, you can specify a default language, application name, and so on. For more information, see:

Configuring Global Defaults

Use the Services page to set application-wide properties for discussion forums, announcements, mail, and people connection components such as activity streams, personal profiles, connections, messages boards, and feedback. For more information, see:

Configuring Discussion Forum Options for WebCenter Spaces

Configuring Send Mail Notifications for WebCenter Spaces

Configuring People Connections Defaults for WebCenter Spaces

You can also register portlet producers and external applications from the Services tab:

Registering Portlet Producers

Registering External Applications

Manage All

or

Manage Configuration

Part II

Designing a Portal or Community

Part II of the User's Guide provides guidelines for establishing a team of builders and steps you through the process of setting up global defaults for your portal or community. It also describes how to customize task flows so that all instances are affected or just those instances appearing within a given Space.

Part II includes the following chapters:

- Chapter 5, "Configuring Global Defaults"

- Chapter 6, "Configuring Services, Portlet Producers, and External Applications"

- Chapter 7, "Preparing Your Initial Portal Pages "

- Chapter 8, "Customizing Task Flows"

The script content on this page is for navigation purposes only and does not alter the content in any way.

5 Configuring Global Defaults

Out-of-the-box, WebCenter Spaces is pre-configured with various default settings which administrators may customize to suit their audience. This chapter includes the following sections:

- Section 5.1, "Customizing the Name and Logo"

- Section 5.2, "Customizing Copyright and Privacy Statements"

- Section 5.3, "Customizing the Online Help Link"

- Section 5.4, "Choosing a Default Display Language"

- Section 5.5, "Customizing the Language List"

- Section 5.6, "Choosing a Default Start (or Landing) Page"

- Section 5.7, "Choosing a Default Skin"

- Section 5.8, "Choosing a Default Page Template"

- Section 5.9, "Choosing a Default Navigation"

- Section 5.10, "Choosing Default Resource Catalogs"

- Section 5.11, "Choosing a Default Look and Feel for New Pages"

- Section 5.12, "Enabling and Disabling Access to the Home Space"

- Section 5.13, "Setting up Defaults for WebCenter Services"

See also, Chapter 6, "Configuring Services, Portlet Producers, and External Applications"

Audience

This chapter is intended for WebCenter Spaces administrators with the Manage Configuration permissions.

5.1 Customizing the Name and Logo

Out-of-the-box, the application name WebCenter Spaces appears in the banner (see Figure 5-1). If you prefer, you can change the name to better suit your target audience. For example, you might want to display your company name here or the name of a department within your company.

Another way to apply corporate branding to WebCenter Spaces, is to add your company logo (Figure 5-1). If your company's logo is not suitable, any graphic that brings visual interest can be used.

The logo you specify will resize according to the application's page template. If you want to adjust the logo size, you can modify the page template. See, Section 12.3, "Editing a Page Template".

If you want, you can reference your application name and logo in EL expressions. For details, see Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application".

Figure 5-1 Naming Your WebCenter and Changing the Logo

To change the name or logo for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration, then General.

3. In the Application Name field, enter the new name.
Alphanumeric characters are allowed and also spaces, underscores (_) and dashes (-). For example, Finance Department - My Corporation.

4. Click Browse for the Application Logo property.
The File Upload dialog box opens.

5. Select the logo you want to use.
The logo is uploaded to the WebCenter Spaces image directory (/webcenter/images) and the new logo immediately appears in the top left corner of the application banner.

6. Click Apply.

5.2 Customizing Copyright and Privacy Statements

Administrators can customize or hide copyright and privacy statements for WebCenter Spaces:

- Copyright - Displays a copyright statement for the entire application.

- Privacy URL - Links to a document that contains a privacy policy for the entire application.

In the default page template, the copyright and privacy URL appear in the application's page footer (Figure 5-2).

If you want, you can reference your copyright message and privacy document in EL expressions. For details, see Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application".

Figure 5-2 Customizing the Copyright and Privacy URL

Individual Spaces may provide their own copyright and privacy statements. For details, see Section 51.4.14, "Customizing the Copyright Statement and Privacy URL".

To customize or hide copyright and privacy statements:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration, then General.

3. Do one of the following:

- Select Display Page Footer to display copyright and privacy information.

- Deselect Display Page Footer to hide the page footer. No legal notices or other information that normally displays in the footer will display.

4. If you have chosen to display legal notices:

- Copyright - Enter a suitable copyright statement for the WebCenter Spaces application. If no copyright information is required, leave this field blank.

- Privacy URL - Specify the location of the application's privacy policy. Enter a fully qualified URL. If no privacy information is required, leave this field blank.

5. Click Apply to save.

5.3 Customizing the Online Help Link

Online help for WebCenter Spaces displays when you click the Help link for the application (see Figure 5-3). Out-of-the-box, this Help link opens Oracle's built-in help. If you want, you can write online help specifically aimed at your end-users and redirect the Help link to a different help location.

If you want, you can reference the Help location in EL expressions. For details, see Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application".

Figure 5-3 Customizing the Online Help Link

When you customize the Help link, built-in help for WebCenter Spaces is still available through help buttons, help icons, and so on.

To customize the main Help link for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration, then General.

3. In the Global Help URL field, enter the location of your help.
Ensure that you enter a fully qualified URL in the format:

http://host:port/helplocation

For example:

http://myhost:8888/myhelp

The default Global Help URL is /webcenterhelp/spaces?topic=welcome_main. This URL opens Oracle Help for the Web (OHW) and displays Oracle's built-in help for WebCenter Spaces. Enter this URL if you want to return to the default setting.

Note:

If you leave the Global Help URL field blank, the Help link is not displayed.

4. Click Apply.

Click Help in your application to check whether your custom help opens correctly.

5.4 Choosing a Default Display Language

Out-of-the-box, WebCenter Spaces supports 27 languages and 100 different locales. It is the administrator's job to choose a default application display language for WebCenter Spaces. When picking the default language, consider which language suits the majority of people using the application. Alternatively, enter an EL expression that determines the default language dynamically based on certain criteria. For example, you may prefer the default display language to change according to the location or organization of the user that is logged in.

The first time a user logs in to WebCenter Space the default language displays but individuals can personalize their display language through user preferences. See, Section 35.2, "Choosing Your Preferred Display Language".

The default display language only applies when users log in to WebCenter Spaces. Public pages, such as the welcome page and the login page, display in the browser language. If no default language is provided, the browser language is used. See also, Section 24.1.1, "Display Language Precedence".

Note:

Moderators can nominate a display language for a particular Space. When defined, the Space language overrides both the default language and any user language preference. See also, Section 51.4.15, "Setting a Space Display Language".

To select the default display language for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration tab, then General.

3. Do one of the following:

- Choose a Default Language from the list available.
If the language you want is not available in the dropdown list, click Customize, select the check box for the language you require, and click Save.

- Click the Expression Builder icon, and enter an EL expression that determines the default language dynamically based on certain criteria.

4. Click Apply.

The display languages that are available for selection here are also offered to users and space moderators through user preferences. As the administrator, you can reduce the range of languages available to WebCenter Spaces users. For details, see Section 5.5, "Customizing the Language List".

5.5 Customizing the Language List

Out-of-the-box, WebCenter Spaces offers 27 languages and 100 different locales and all these languages are available to users by default. As WebCenter Spaces administrator, you can tailor the languages that are on offer to suit your audience. For example, you may prefer to remove all the territory language variants in favor of a more simplified language list or only offer European languages if your portal is specifically aimed at a European audience.

To customize the languages available to WebCenter Spaces users:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration tab, then General.

3. Click Customize (below Default Language).

4. Choose which languages to offer by selecting (or deselecting) each language check box.

Figure 5-4 Choosing Which Languages Are Available

5. Click Save.

5.6 Choosing a Default Start (or Landing) Page

By default, users see the Home Space when they log in but you can configure the initial landing page to be a specific Space or page.

Note:

If the application is set up to remember the page a user last accessed, this landing page setting is ignored. For details, see "Controlling Last Page Accessed Behavior in WebCenter Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To select the landing page for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration tab, then General.

3. In the Login section, choose what users see first when they login--the Home Space, or a specific Space or page.

- To specify that a particular Space displays, select Open a Specific Space and enter the Space name or click Browse to select from a list of Spaces.

- To specify that a particular page displays, select Open a Specific Page URL and enter the page location.
Typically this is an internal page. You can enter a full or relative page URL as shown in these examples:

http://mywebcenter.com:8888/webcenter/spaces/page/landingpage

http://mywebcenter.com:8888/webcenter/spaces/myspace/page/landingpage

/spaces/myspace/page/landingpage

If you specify an external page, ensure that you specify the full URL.

4. Click Apply.

5.7 Choosing a Default Skin

As WebCenter Spaces Administrator, you may customize the default appearance of WebCenter Spaces for all users by changing the default skin. A skin changes the way the user interface appears, but does not change the application's behavior. See Section 14.5.1, "Applying a Skin to WebCenter Spaces".

If you want, you can reference the default skin in EL expressions. For details, see Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application".

Individual users can change the skin applied to their Home Space view through user preferences if they do not like the default skin that you specify. See Section 14.5.3, "Applying a Skin to Your Home Space".

5.8 Choosing a Default Page Template

In WebCenter Spaces, page templates define how individual pages and groups of pages display on a user's screen. Every WebCenter page displays within a page template. Administrators can define the default page template used to display WebCenter pages in:

- The Home Space

- New Spaces, when the Space's template does not specify that a particular page template must be used

Space moderators can override the default selection within their Space but users cannot override the page template applied to the Home Space.

See also, Chapter 12, "Working with Page Templates".

To select the default page template for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration tab, then General.

3. Do one of the following:

- Choose a Default Page Template from the list available.
To learn how to add page templates to this list, read Section 12.5.1, "Showing and Hiding a Page Template".

- Click the Expression Builder icon, and enter an EL expression that determines the default page template dynamically based on certain criteria.
For example, you may like the default page template to change depending on which department or organization the logged in user belongs to.

4. Click Apply.

5.9 Choosing a Default Navigation

In WebCenter Spaces, navigation models enable users to see and navigate to information quickly and easily. Administrators can specify which navigation is used to present Home Space information.

Alternatively, you can enter an EL expression that determines the navigation dynamically based on certain criteria. For example, you may like to display different navigations depending on which department or organization the logged in user belongs to.

See also, Chapter 11, "Working with Navigation".

To select a navigation model for the Home Space:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration tab, then General.

3. Do one of the following:

- Choose a Navigation for Home Space from the list available.
To learn how to add navigations to this list, read Section 10.4.3, "Showing and Hiding Resources".

- Click the Expression Builder icon, and enter an EL expression that determines the navigation dynamically based on certain criteria.

4. Click Apply.

5.10 Choosing Default Resource Catalogs

In WebCenter Spaces, a series of Resource Catalogs display when you edit a page or a page template in Oracle Composer and click Add Content. Each catalog presents available resources in a series of folders and subfolders and the content on offer changes dynamically depending on which services are currently available and the permissions of the person who is editing the page or page template. Available resources include task flows, portlets, and page layout components, such as images, content boxes, hyperlinks, and the like.WebCenter Spaces provides several default catalogs out-of-the-box but you can add new task flows, remove task flows, or reorganize the folder hierarchy to better suit your audience or create brand new ones of your own. For details, see Chapter 16, "Working with Resource Catalogs".

WebCenter Spaces administrators can specify default page catalogs for:

- Spaces

- Home Space

- Business Role Pages

As well as, default page template catalogs for:

- Spaces

- Home Space

It is entirely up to you whether you specify a different catalog for each scenario or use the same catalog throughout.

To select default resource catalogs for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration tab, then General.

3. Choose default resource catalogs for the following:

- Resource Catalog for Spaces

- Resource Catalog for Home Space

- Resource Catalog for Business Role Pages

- Resource Catalog for Page Templates in Space

- Resource Catalog for Page Templates in Home Space

To learn how to add resource catalogs to this list, read Section 16.4, "Showing and Hiding a Resource Catalog".

Click the Expression Builder icon, and enter an EL expression that determines the default resource catalog dynamically based on certain criteria. For example, you may like the default resource catalog to change depending on the which role the logged in user belongs to.

4. Click Apply.

5.11 Choosing a Default Look and Feel for New Pages

Administrators can set up a default look and feel for personal and business role pages. Use this feature to simplify page creation for first-time users or to steer users toward a particular page scheme and style. See Chapter 7, "Preparing Your Initial Portal Pages ".

Individuals may personalize the default settings in their Home Space view. See Section 38.1.1, "Setting Page Creation Defaults for Personal Pages".

5.12 Enabling and Disabling Access to the Home Space

Access to the Home Space is optional in WebCenter Spaces—it is not mandatory to provide users with a private work area where they can store personal content and perform personal tasks. Users can fully participate in collaborative projects without access to the Home Space.

Users who do not have access to the Home Space, cannot use personal productivity tools (such as favorites), create personal pages, or see personal pages that other users might share.

The View Application permission controls whether users have access to the Home Space. Administrators can disable access to everyone using WebCenter Spaces or specific users only. Use the table shown in Step 3 to determine which permission settings you require.

To enable or disable access to the Home Space:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Roles.

3. Select or clear the View Application check box as follows:

Role

Select View Application

Clear View Application

Authenticated-User

Everyone can access the Home Space.

Users cannot access the Home Space unless you grant them another role that specifies otherwise.

Any Custom Role

Users assigned the custom role have access to the Home Space.

Users with the custom role cannot access the Home Space. Foot 1

Public-User

Unauthenticated users can see personal pages and content marked public.

Unauthenticated users only see the login page.

Administrator

Users assigned this role can always access the Home Space.

Not applicable for administrators.

Footnote 1 Assumes the View Application permission is disabled for the Authenticated-User and the Public-User.

4. Click Apply to save.

New permissions are effective immediately.

5.13 Setting up Defaults for WebCenter Services

WebCenter Spaces administrators are responsible for setting up default service options for the entire application. For more information, read:

- Section 6.2, "Configuring Discussion Forum Options for WebCenter Spaces"

- Section 6.3, "Configuring Send Mail Notifications for WebCenter Spaces"

- Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces"

The script content on this page is for navigation purposes only and does not alter the content in any way.

6 Configuring Services, Portlet Producers, and External Applications

In WebCenter Spaces, a series of WebCenter services expose portal, team collaboration, and social features through various task flows. Some services, such as lists, are ready to use out-of-the-box and require no further configuration. Other services, such as discussions and mail, require connections to external back-end servers, and additional configuration within WebCenter Spaces to get things up and running.

This chapter describes how to enable, disable, and configure WebCenter services in WebCenter Spaces. It does not describe how to set up connections to back-end servers—this is a job for your Fusion Middleware Administrator. For details, see "Getting WebCenter Spaces Up and Running" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

This chapter includes the following sections:

- Section 6.1, "Enabling and Disabling WebCenter Services"

- Section 6.2, "Configuring Discussion Forum Options for WebCenter Spaces"

- Section 6.3, "Configuring Send Mail Notifications for WebCenter Spaces"

- Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces"

- Section 6.5, "Registering Portlet Producers" *

- Section 6.6, "Registering External Applications" *

See also, Chapter 5, "Configuring Global Defaults"

Audience

This chapter is intended for WebCenter Spaces administrators with the Manage Configuration permissions.

Additional permissions are required to manage portlet producers and external applications for WebCenters, that is, you must have the appConnectionManager role.

6.1 Enabling and Disabling WebCenter Services

In WebCenter Spaces, a series of services expose portal, team collaboration, and social features through various task flows. Some services, like tags, are available and work out-of-the-box, but other services, such as Mail, require connection to an external back-end server (Table 6-1).

Table 6-1 WebCenter Services

Services A to M

Services N to W

Activity GraphFootref 1

NotesFootref 2

AnalyticsFoot 1

PageFootref 2

AnnouncementsFootref 1

People ConnectionsFootref 2

DiscussionsFootref 1

PersonalizationFootref 1

Documents (includes Wikis and Blogs)Footref 1

PollsFootref 2

EventsFootref 1

RSSFootref 2

Instant Messaging and Presence (IMP)Footref 1

Recent ActivitiesFootref 2

LinksFoot 2

SearchFootref 1

ListsFootref 2

TagsFootref 2

MailFootref 1

WorklistFootref 1

Footnote 1 Service requires a connection to external back-end server.

Footnote 2 Services, such as notes, links, pages, tags, and so on, use the same WebCenter repository and MDS repository as WebCenter Spaces to store their data.

The Fusion Middleware Administrator is responsible for managing connections to external servers and also maintains the WebCenter and MDS repositories where application data, specific to WebCenter Spaces, is stored. For details, see "Maintaining WebCenter Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

When a valid connection exists, the associated service becomes available. If you want to verify whether a service, such as Mail, is available in WebCenter Spaces, check:

- Associated task flows display in the resource catalog.

- Existing task flows function as expected.

- Space moderators can choose whether to enable or disable that service in their Space—through Space Administration Settings

When a back-end server is not configured, intentionally or otherwise, WebCenter Spaces cannot offer features or functionality related to that service:

- Associated task flows are not available in the resource catalog.

- Existing task flows display a message indicating that the service is currently unavailable.

- Service is not listed, as available, to Space moderators—through Space Administration Settings

Reporting Temporary Issues with WebCenter Services

When a service is temporarily unavailable, report the issue to the Fusion Middleware Administrator. The Fusion Middleware Administrator can use Enterprise Manager to investigate, diagnose, and solve issues with WebCenter Spaces services. See also, "Navigating to the Home Page for WebCenter Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Hiding Task Flows When Services Unavailable

Most WebCenter services are optional. If you decide not to offer a particular service in WebCenter Spaces, temporarily or permanently, consider removing any associated task flows that display, by default, out-of-the-box.

Enabling and Disabling Services for a Particular Space

Moderators can enable or disable available WebCenter services within their Space. See, Section 51.10, "Managing Space Services".

6.2 Configuring Discussion Forum Options for WebCenter Spaces

Discussion forums allow members to capture, share, and preserve content that is relevant to their project or community goals.

As WebCenter Spaces administrator, you are responsible for setting discussion forum options for the entire application through WebCenter Spaces Administration pages (Figure 6-1).

Figure 6-1 Setting Discussion Forum Options

From here you configure discussion-related setting, as well as access discussions server administration pages:

- Section 6.2.1, "Accessing the Discussions Server Admin Console"

- Section 6.2.2, "Specifying Where Discussions and Announcements are Stored on the Discussions Server"

- Section 6.2.3, "Choosing How Many Discussion Topics to Save In Space Templates"

Note:

The Fusion Middleware administrator maintains the connection between WebCenter Spaces and the discussions server. If you are experiencing issues with this connection, report the problem to the Fusion Middleware Administrator. See also, "Registering Discussions Servers" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

6.2.1 Accessing the Discussions Server Admin Console

For convenience, you can access the discussions server's Admin Console, a Web-based tool for configuring and managing discussion forums, from WebCenter Spaces Administration. From the Admin Console, you can navigate all categories and forums and edit their properties, create new categories and forums, as well as set cache, security, and various other properties for the discussions server.

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, Services, and then select Discussions.

3. Click Forum Administration.

4. Enter your discussions server administrator Username and Password.

6.2.2 Specifying Where Discussions and Announcements are Stored on the Discussions Server

Administrators can change the root category (on the discussions server) under which all WebCenter Spaces discussions and announcements are stored.

The default system root category is suitable in most cases but you can choose a different location. This might be useful when WebCenter Spaces is connected to a discussions server that is hosting discussion forums for multiple applications.

Oracle recommendations:

- Choose a category that is dedicated to this WebCenter Spaces application. There may be conflicts when multiple WebCenter Spaces applications share the same root category.

- Do not switch the root category after WebCenter Spaces is up and running. If you change the root category, then all the discussion forums under the old root continue to work, but you cannot use the Links service to create links to discussions or announcements stored in the old category.

You can retain existing discussions in a Space template saved with the data copy option. For example, on the Administration - Configuration - Services - Discussions page, enter the number (between 1 and 25) of most recent topics and replies to be copied over to the template.

Space templates support single or multiple forums under the root category that you specify. With Communities of Interest templates and Group Project templates, one forum is created automatically under the root category for each new Space based on that template.

To specify where WebCenter Spaces discussion forums are stored:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, Services, and then select Discussions.

3. Specify an appropriate Root Category for storing WebCenter Spaces discussions.
Click the Find icon to view the categories available and then select the most appropriate location.

To create a new category especially for this WebCenter Spaces application, click Create Category. You must have system administrator permissions on the Discussions server to create new categories.

4. Click Apply to save the settings.

6.2.3 Choosing How Many Discussion Topics to Save In Space Templates

WebCenter Spaces administrators can limit how many recent topics and replies are copied to Space templates. As copying large amounts of data has performance implications, there is an upper limit of 25 topics/replies.

Some of you may prefer not to include any recent topics/replies in Space templates, in which case you can specify zero.

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, Services, and then select Discussions.

3. Specify an appropriate number of Topics and Replies to save in Space templates.

4. Click Apply to save the settings.

6.3 Configuring Send Mail Notifications for WebCenter Spaces

WebCenter Spaces administrators are responsible for setting mail options through WebCenter Spaces administration (Figure 6-2).

Figure 6-2 Setting Mail Options

From this page, you can assign the mail client for the "Send Mail" feature. This feature allows application resources to send mail directly from them, with the Send Mail icon (Figure 6-3).

Figure 6-3 Send Mail Icon

For example, from an announcement, users can click the Send Mail icon to open a mail window prepopulated with information including the announcement text, author, date created, and location. They can edit and add to the mail, as necessary. The way the mail window is prepopulated depends on the resource sending it. For example, from a wiki, Send Mail opens a mail window prepopulated with the name of the wiki, the size, who created it and when, who modified it and when, and a URL link to the wiki.

Within a Space, the mail can be addressed to all members of the Space. Space moderators (and anyone granted the Manage Configuration permission on the Space) set this through the Services page in the Space administration settings See Section 51.10.2, "Configuring a Custom Space Mail Distribution List".

If the number of recipients is so large that the mail cannot be prepopulated with the addresses, then you must either enter the addresses manually or set up a distribution list for the Space.

For all Send Mail notifications throughout WebCenter, you can choose to use the local mail client, such as Microsoft Outlook or Mozilla Thunderbird, or the WebCenter Mail service. The local mail client is the default. The Send Mail feature does not require the Mail service, that is, if the Mail service is not yet configured, you can still use the Send Mail feature with your local mail client.

As administrator you can also specify whether users may override the default mail client setting.

Note:

The Fusion Middleware administrator maintains the connection between WebCenter Spaces and the mail server. If you are experiencing issues with this connection, report the problem to the Fusion Middleware Administrator. See, "Registering Mail Servers" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

6.3.1 Enabling Shared Mail Connections for Send Mail Notifications

Users do not need to specify credentials when sending mails using the WebCenter Mail service when shared credentials are configured for the external application that is associated with the mail server connection.

To enable shared mail connections in WebCenter Spaces.

1. Confirm that WebCenter Spaces is using the WebCenter Mail service to send mail.

1. Open WebCenter Spaces Administration.

2. Click Configuration, Services, and then select Mail.

3. Ensure that Default Mail Client for 'Send Mail' is set to WebCenter Mail Service.

See also, Section 6.3, "Configuring Send Mail Notifications for WebCenter Spaces".

2. Ask the Fusion Middleware administrator to set up a mail connection that uses an external application configured with the shared credentials and record the mail connection name.
For details, see "Setting Up a Shared Mail Connection" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

3. Open the Space where shared mail credentials are required and specify the name of the shared mail connection.
For details, see Section 51.10.5, "Configuring a Shared Mail Connection for a Space".

6.4 Configuring People Connections Defaults for WebCenter Spaces

This section describes how to set application defaults for the People Connections service in WebCenter Spaces. You must be a WebCenter Spaces administrator or granted Application-Configure and Manage People Connections permissions to set any of the application-wide properties described here.

This section includes the following subsections:

- Section 6.4.1, "What You Should Know About Administering the People Connections Service"

- Section 6.4.2, "People Connections Prerequisites"

- Section 6.4.3, "Configuring the People Connections Service for WebCenter Spaces"

- Section 6.4.4, "Archiving the Activity Stream Schema"

- Section 6.4.5, "Troubleshooting Issues with the People Connections Service"

6.4.1 What You Should Know About Administering the People Connections Service

People Connections administrative settings are useful for controlling all users' initial views of People Connections features, including:

- Activity Stream—A streaming view of user activity

- Connections—An organically formed community of users who share a greater level of information with each other than with the unconnected

- Profile—A summary of user information, such as contact information, job position, chain of management, and the like

- Message Board—A feature for posting and receiving messages

- Feedback—A feature for posting and receiving feedback

Use the People Connections administrative settings to enforce the values you specify or to enable users to override these values with their own People Connections Preferences (for more information, see the chapters covering specific features of the People Connections service, available in Part IX, "Organizing Your Collaborative and Social Networking Environment").

Setting default values on the WebCenter Administration page affects all users' views of People Connections features. There are a few levels at which these values can be set, and they are subject to an order of precedence:

- Administrative settings affect all users' views of People Connections features.

- Preferences settings affect the view of the user who sets them, and they override administrative settings.

- Settings on a particular task flow affect just that task flow instance, and they override Preference settings:

- Values set in edit mode (application customization) affect all users' views of the task flow instance.

- Values set in view mode (user customization) affect only that user's view of the task flow instance, and they override application customizations in that user's view.

6.4.2 People Connections Prerequisites

No special set up is required to enable users to access People Connections services. The People Connections service uses the WebCenter Repository, installed with WebCenter Spaces, to store information.

For Profile information, all but three attributes are stored and read from the LDAP identity store that is configured for WebCenter Spaces. There are three exceptions: the Profile photo, expertise, and the Publisher status message. These are stored with other WebCenter data in the WebCenter Repository.

See Also:

For information about WebCenter Spaces and the LDAP identity store, see "Configuring the Identity Store" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

6.4.3 Configuring the People Connections Service for WebCenter Spaces

This section steps you through the process of setting application-wide values for People Connections features. It includes the following subsections:

- Section 6.4.3.1, "Accessing People Connections Administrative Settings"

- Section 6.4.3.2, "Configuring Activity Stream"

- Section 6.4.3.3, "Configuring Connections"

- Section 6.4.3.4, "Configuring Profile"

- Section 6.4.3.5, "Configuring Message Board"

- Section 6.4.3.6, "Configuring Feedback"

6.4.3.1 Accessing People Connections Administrative Settings

To access People Connections administrative settings:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, Services, and then select People Connections.
Alternatively, use the following URL, and then select People Connections:

http://host:port/webcenter/spaces/admin/services

Tabs with the names of People Connections features appear to the right (Figure 6-4).

Figure 6-4 Configuration Settings for the People Connections Service

6.4.3.2 Configuring Activity Stream

Activity Stream provides a means of publishing and tracking users' application activity. Activity Stream configuration settings specify from which users and services activities are streamed, who can see a user's streamed activities, and whether liking and commenting is available on each streamed activity (Figure 6-5).

Figure 6-5 Configuration Options for Activity Stream

Who can view a user's activities and the types of activities tracked depend on Activity Stream configuration. Table 6-2 lists the types of activities that may be tracked by Activity Stream.

Table 6-2 Activities Tracked by Activity Stream

Service

Tracked Activities

Scope

Activities Shared or Private

Announcements

- Create announcement

- Edit announcement

Space

Shared with other Space members

Blogs

- Create blog

- Update blog

- Space

- Home Space

- Activities on Space blogs are shared with other Space members.

- Activities on Home Space blogs are shared with the blogger's connections.

Connections

- Invitations to connect

- People are connected

Home Space

Shared with invitor and invitee's connections

Discussions

- Create forum

- Create topic

- Reply to topic

Space

Shared with other Space members

Documents

- Create document

- Edit document

- Add tag

- Remove tag

- Space

- Home Space

- Activities on Space documents are shared with other Space members.

- Activities on Home Space documents are private to user.

Feedback

- Feedback left

- Feedback received

Home Space

Shared with whomever is permitted to view such activities (for more information, see this section and Section 33.2, "Setting Message Board and Feedback Preferences."

Lists

- Create a list

- Add a row to a list

- Edit a list row

Space

Shared with other Space members

Message Board

- Message left

- Message received

Home Space

Shared with whomever is permitted to view such activities (for more information, see this section and Section 33.2, "Setting Message Board and Feedback Preferences."

Pages

- Create page

- Edit page

- Add tag

- Remove tag

- Space

- Home Space

- Activities on Space pages are shared with other Space members.

- Activities on Home Space pages are private to user.

Profiles

- Photo updated

- Profile updated

- Personal status note updated

Home Space

Shared with whomever is permitted to view such activities (for more information, see this section and Section 30.3, "Setting Profile Preferences."

Space Events

- Create an event

- Edit an Event

Space

Shared with other Space members

Spaces Management

- Create Space

- Join Space

Space

Shared with other Space members

Tagging

- Add tag

- Remove tag

Space

- Activities in a Space are shared with all Space members.

- Activities in a Home Space are shared with whomever is permitted to view such activities (for more information, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences").

Activity Stream configuration falls under the following categories:

- People—For determining whose activities to show, either the current user's or both the current user and the user's connections.

- Spaces—For determining whether to show activities from all available Spaces or just the Home Space.

- Service Categories—For selecting the services from which to report activities and enabling users to override these default selections in their personal preferences or preventing users from overriding.

- Privacy—For selecting who may see the current user's activities.

- Comments and Likes—For enabling users to comment on a posted activity and express a liking for a posted activity

To configure Activity Stream for all users:

1. Access People Connections administrative settings as described in Section 6.4.3.1, "Accessing People Connections Administrative Settings."

2. Click the Activity Stream tab to bring it forward.

3. Expand the People node, and select whose activities to show:

- Only Me—Show only the current user's activities in his or her view of the Activity Stream.

- Me and My Connections—Show the current user's activities and the activities of that user's connections in his or her view of the Activity Stream.

- No Personal—Omit all activities streamed from Home Spaces in the current user's view of his Activity Stream.

4. Expand the Spaces node, and select to show activities from all available Spaces (All Spaces) or just the user's Home Space (No Spaces).

5. Expand the Service Categories node, and select the services from which to publish activity.

Note:

The activities of services that are not selected are still tracked, but they do not appear in the Activity Stream. If you select to show the service activities at some later point, all of the activities that occurred when the service was not selected now appear in the Activity Stream.

Table 6-2 lists the activities tracked by the Activity Stream.

6. Optionally, select Allow Owner Override to enable users to override a setting for a given service through their personal preferences.
Clear this checkbox to prevent users from overriding the application defaults you set here.

7. Expand the Privacy node, and specify who can view the current user's activities as well as whether the user can override this setting in their personal preferences.
Table 6-3 lists and describes each option.

Table 6-3 Activity Stream Privacy Options

Option

Description

Allow all of my activities to be viewed by

Specify who can view another user's activities

Choose from:

- Everyone—Any user, whether logged in or not, can view other users' activities.

- Authenticated Users—Users who have logged in can view other users' activities.

- My Connections—User A can view user B's activities if user B has accepted user A as a connection. User A can also view user A's activities.

- Myself—Only user A can view user A's activities.

Allow Owner Override

Enable users to override the application default settings using their own People Connections Preferences (for more information, see Section 32.2, "Setting Activity Stream Preferences").

8. Expand the Likes and Comments node, and specify whether liking and commenting are allowed:

- Select Enable comments on objects in the Activity Stream to enable users to comment on a given Activity Stream item. Clear the checkbox to prevent users from commenting.

- Select Enable others to like objects in the Activity Stream to enable users to express a liking for an Activity Stream item. Clear the checkbox to prevent users from commenting.

Tip:

Users can like and comment on streamed items that include objects. For example, users can like or comment on "Jack has updated doc.xml," but cannot like or comment on "Jack and Jill are now connected."
For additional information about liking and commenting, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

9. Click Apply to save your configuration settings.

6.4.3.3 Configuring Connections

Connections configuration involves specifying who can view another user's connections and whether users accept invitations to connect automatically (Figure 6-6).

Figure 6-6 Configuration Settings for Connections

To configure Connections:

1. Access People Connections administrative settings as described in Section 6.4.3.1, "Accessing People Connections Administrative Settings."

2. Click the Connections tab to bring it forward.
Table 6-4 lists and describes each option.

Table 6-4 Connections Configuration Options

Option

Description

Grant View Access to

Classes of users to whom to grant automatic view access to a user's connections

The users you select can view and interact with another user's connections.

Choose from:

- Everyone—All users, including users who are not logged in, can see other users' connections.

- Authenticated users—Only users who are logged in can see other users' connections.

- User's Connections—Only the user and the user's connections can see the user's connections.

- User Only—Only a user can see his or her own connections.

Allow Owner Override

Option to allow or prohibit users from overriding the administrator View access setting:

- Select to allow users to override the administrative View access setting specified here using their personal Preferences (for more information, see the "Setting People Connections Preferences" section in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces).

- Clear to prohibit users from overriding the administrative View access setting.

Accept Invitations Automatically

- Select to specify that, by default, all invitations to connect are accepted automatically.

- Clear to specify that, by default, a user must explicitly accept or reject invitations to connect.

3. Click Apply to save your configuration settings.

6.4.3.4 Configuring Profile

Every authenticated WebCenter user has a profile that displays personal information, such as the user's email address, phone number, office location, department, manager, direct reports, and so on. All but three attributes are stored and read from the LDAP identity store that is configured against WebCenter Spaces. The three exceptions include the Profile photo and expertise and Publisher status messages.

Use administrative configuration settings for Profile to specify whether users are allowed to change their application passwords, which profile sections display, whether users are allowed to update their profile details, and the profile attributes that users may update (Figure 6-7).

Figure 6-7 Configuration Settings for Profile

Personal profiles are presented in four sections: Summary, Employee, Business Contact, Personal Information. Each section provides information related to the section heading. For example, Summary includes a collection of basic details, such as the user's name, email address, and office location.

In configuration settings, the access setting for the Summary section controls who can search for the user in WebCenter Spaces (for example, through global search, people pickers, and the searches one uses to find and invite other users to connect). For example, if Everyone is allowed to view the Summary section, then the user can be searched for by unauthenticated (public) users. If only Authenticated Users can view another user's Summary section, then only logged in users can search for the user. If None is the selected value for Who can view this section, then the user will not appear in search results.

The Summary section is the only Profile section for which the privacy setting cannot be changed by the end-user through Preferences (for more information, see Section 30.3, "Setting Profile Preferences"). It is controlled at a global level for all users through the settings described in this section.

It is the administrator's job to specify the information to show in each section and determine whether users are allowed to edit their profile data and their application password within WebCenter Spaces.

Note:

Whether users can enter edit mode in the Profile task flow is affected by administrative settings (Can Edit); however, whether users can enter edit mode on the About subpage of the My Profile page is not affected. The Edit button is always available on the default version of the About subpage.
Note also that Administrative settings do affect which sections appear on the About subpage (and in the Profile task flow) and whether users can change given details in each section.

To configure Profile:

1. Access People Connections administrative settings as described in Section 6.4.3.1, "Accessing People Connections Administrative Settings."

2. Click the Profile tab to bring it forward.
Table 6-5 lists and describes each option.

Table 6-5 Profile Configuration Options

Option

Description

Allow Password Change

Specify whether users are allowed to change their application password

- Select to enable users to change their application password.

- Clear to prevent users from changing their application password. This option is useful when your organization provides a single, separate application for managing user credentials and, consequently, prefers not to offer password management through each application.

Profile Access

Specify which Profile sections to show and whether users are allowed to update their profile details

Set application defaults in the following table columns:

Profile Section—Identifies the groups of information shown in a user profile.

View Settings—Specify which users can view a particular profile section, and indicate whether users can change these defaults in their personal Preferences.

View Settings for the Summary section control not only who can view summary details but also for whom the user appears in people search results.

Set values for:

- Who can view this section—Specify which class of users can view the associated profile section by default. Choose from:
User's Connections—The users to whom the current user is connected can see the associated profile section in other users' profiles. This option is available for all sections except Summary.

Everyone—All users, including users who are not logged in, can see the associated profile section in other users' profiles.

Authenticated users—Only users who are logged in can see the associated profile section in other users' profiles.

User Only—Only the user can see his or her own details in the associated profile section.

None—The section is hidden from all users.

- Allow Owner Override—Enable or disable users' from overriding the default application settings you specify here. Select to enable; clear to disable.

Can Edit—Select to enable users to edit the associated profile section of their own personal profiles; clear to prohibit users from editing the associated profile section.

This setting also controls whether an Edit link appears in the Profile task flow, but it does not affect the appearance of the Edit button on the default version of the My Profile About subpage. On the default version of the About subpage, the Edit button always appears, though you can use the other Profile administrative settings to prohibit users from actually changing any Profile details.

Profile Attributes - Edit Settings

Indicate the section attributes that users are allowed to edit by default

Under Allow Update:

- Select an attribute to enable users to edit its value in their own profiles.

- Clear an attribute to prohibit users from editing it in their own profiles.

3. Click Apply to save your configuration settings.

6.4.3.5 Configuring Message Board

Message Boards provide users with a means of viewing and posting messages to their connections. Configuration settings for Message Board provide controls for who can view and post messages, who can edit and delete the messages they leave, who can delete and change the visibility of messages they receive, and whether commenting and liking are available on each message (Figure 6-8).

Figure 6-8 Configuration Settings for Message Board

See Also:

For information about likes and comments, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

To configure Message Board:

1. Access People Connections administrative settings as described in Section 6.4.3.1, "Accessing People Connections Administrative Settings."

2. Click the Message Board tab to bring it forward.
Table 6-6 lists and describes each option.

Table 6-6 Message Board Configuration Options

Option

Description

Grant View Access to

Specify who can view Message Board messages.

- Everyone—All users, whether logged in or not, can see users' Message Board messages.

- Authenticated Users—Only logged in users can see users' Message Board messages.

- User's Connections—Only the user and the user's connections can view the user's Message Board.

- User Only—Only the user can see the messages on his or her Message Board.

Grant Post Access to

Specify who can post Message Board Messages.

- Everyone—All users, whether logged in or not, can post Message Board messages.

- Authenticated Users—Only logged in users can post messages to Message Boards.

- User's Connections—Only the user and the user's connections can post messages to the user's Message Board.

- User Only—Only the user can post messages to his or her Message Board.

Allow Owner Override

Specify whether users can override these administrative defaults.

- Select to enable users to edit the default settings through user Preferences (for more information, see the "Setting People Connections Preferences" section in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces).

- Clear to enforce the administrator default application settings.

Enable users to act on messages they post on other Message Boards

Specify whether users are allowed to act on the messages they post.

- Edit message—Select to enable users to edit their own Message Board posts; clear to prohibit users from editing the messages they post.

- Delete message—Select to enable users to delete their own Message Board posts; clear to prohibit users from deleting the messages they post.

Enable users to act on messages they receive from others

Specify whether users can act on messages they receive from others

- Delete message—Select to enable users to delete messages they receive from other users; clear to prohibit users from deleting the messages they receive.

- Change the visibility of the message—Select to enable users to hide or show the messages from a given user; clear to prohibit users from hiding or showing messages.

Enable commenting on messages from Message Board

Specify whether users can comment on messages that are posted on a Message Board.

- Select to permit users to so comment. A Comment link appears below each message. Users click this to enter a comment. For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

- Clear to prohibit commenting.

Enable liking of messages from Message Board

Specify whether to enable users to indicate that they like a message.

- Select to permit users to click a Like link on a given message. For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

- Clear to prohibit liking.

3. Click Apply to save your configuration settings.

6.4.3.6 Configuring Feedback

Feedback provides a means of viewing and posting user feedback for other application users. Configuration settings for Feedback (Figure 6-9).

Figure 6-9 Configuration Settings for Feedback

Feedback configuration settings offer controls for identifying who can view, post, and delete feedback.

To configure Feedback:

1. Access People Connections administrative settings as described in Section 6.4.3.1, "Accessing People Connections Administrative Settings."

2. Click the Feedback tab to bring it forward.
Table 6-7 lists and describes each option.

Table 6-7 Feedback Configuration Options

Option

Description

Grant View Access to

Specifies who can view the current user's Feedback

- Everyone—All users, whether logged in or not, can see a given user's Feedback.

- Authenticated Users—Only users who are logged in can see a given user's Feedback.

- User's Connections—Only the user and the user's connections can see a given user's Feedback.

- User Only—Disables other users from viewing a given user's Feedback.

Grant Post Access to

Specifies who can post user Feedback

- Everyone—All users, whether logged in or not, can post Feedback for a given user.

- Authenticated Users—Only logged in users can post Feedback for a given user.

- User's Connections—Only the user and the user's connections can post Feedback for a given user.

- User Only—Users can post Feedback only for themselves. Effectively disables Feedback.

Grant View Feedback Given Access to

Specifies who can see the View menu to switch between Feedback Given and Feedback Received in a Feedback task flow

- Everyone—All users, whether logged in or not, can see the options on the View menu.

- Authenticated Users—Only logged in users can see the options on the View menu.

- User's Connections—Only the user and the user's connections can see the View menu.

- User Only—Disables the View menu for all but the current user. When users visit the current user's Feedback task flow, they can view only the Feedback the current user has received.

Allow Owner Override

Specifies whether users can override these administrative defaults

- Select to enable users to revise application default settings through user Preferences (for more information, see Section 33.2, "Setting Message Board and Feedback Preferences").

- Clear to prevent users from altering administrator settings for Feedback.

Enable users to act on the feedback given to others

Indicates whether users can delete the Feedback they post

- Select Delete Feedback to enable users to delete the Feedback they post.

- Clear Delete Feedback to prohibit users from deleting the Feedback they post.

Enable owner of the feedback to act on feedback posted by others

Indicate whether to enable users to hide or show Feedback from another user.

- Select Change the visibility of the feedback to enable users to hide or show the Feedback from another user.

- Clear Change the visibility of the feedback to prohibit users from hiding or showing Feedback left by others.

3. Click Apply to save your configuration settings.

6.4.4 Archiving the Activity Stream Schema

As the application administrator, you can use WLST commands to archive and restore data in the Activity Stream schema. The following commands are available:

- archiveASByDate—Archive activity stream data that is older than a specified date.

- archiveASByDeletedObjects—Archive activity stream data associated with deleted objects.

- archiveASByClosedSpaces—Archive activity stream data associated with Spaces that are currently closed.

- archiveASByInactiveSpaces—Archive activity stream data associated with Spaces that have been inactive since a specified date.

- restoreASByDate—Restore archived activity stream data from a specified date into production tables.

For more information, see the section, "Activity Stream," in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

6.4.5 Troubleshooting Issues with the People Connections Service

This section identifies the types of problems that may occur with each People Connections feature and provides suggestions for how to respond to them. It includes the following subsections:

- Section 6.4.5.1, "Troubleshooting Activity Stream"

- Section 6.4.5.2, "Troubleshooting Connections"

- Section 6.4.5.3, "Troubleshooting Profile"

- Section 6.4.5.4, "Troubleshooting Message Board"

- Section 6.4.5.5, "Troubleshooting Feedback"

6.4.5.1 Troubleshooting Activity Stream

Table 6-8 lists problems and responses for troubleshooting Activity Stream in WebCenter Spaces.

Table 6-8 Activity Stream Errors and Responses

Problem

Response

Unexpected error or exception

Contact Oracle Support Services.

Connections exception is thrown

Check the exception's detail for an explanation of the exception.

Service Framework exception is thrown

Check the exception's detail for an explanation of the exception.

Settings exception is thrown

Check the exception's detail for an explanation of the exception.

Property value entered is not reflected in task flow

An invalid value may have been entered for the task flow property. In such cases, the default value is used. Ensure that task flow properties have valid values. For more information, see the chapters covering features associated with the People Connections service in Part IX, "Organizing Your Collaborative and Social Networking Environment".

Database exception in EclipseLink module

Contact Oracle Support Services.

Query exception in EclipseLink module

Contact Oracle Support Services.

Unable to publish analytics event

Contact Oracle Support Services.

Operation not supported

Contact Oracle Support Services.

Cannot retrieve user Profile information

Contact Oracle Support Services.

Check for valid repository failed

Either the database is down or the WebCenter repository is not installed. Check the exception's detail for an explanation of the exception, and respond accordingly.

Activity exception during bulk publish

Check the individual activity exception's detail for an explanation of the exception.

6.4.5.2 Troubleshooting Connections

Table 6-9 lists problems and responses for troubleshooting Connections in WebCenter Spaces.

Table 6-9 Connections Errors and Responses

Problem

Response

Unexpected errors or exceptions

Contact Oracle Support Services.

User name null or blank

Supply a valid user name.

Could not find user name

Supply a valid user name.

Connection list name not specified

An invalid value may have been entered for the task flow property. Ensure that task flow properties have valid values. For more information, see the chapters covering features associated with the People Connections service in Part IX, "Organizing Your Collaborative and Social Networking Environment".

Insufficient privileges

Contact the WebCenter Spaces administrator, and request the required permission.

Cannot invite oneself as a connection

Supply a user name other than your own.

Cannot invite a user who has been invited

Wait for the invited user to act on your invitation.

Cannot invite a user who has invited you

Accept the invitation you have received from the user.

Cannot invite a user to whom you are connected

Supply a user name other than that of your existing connection.

6.4.5.3 Troubleshooting Profile

Table 6-10 lists problems and responses for troubleshooting Profile in WebCenter Spaces.

Table 6-10 Profile Errors and Responses

Problem

Response

Unexpected errors or exceptions

Contact Oracle Support Services.

Personal status message cannot be changed

Only you can change your personal status message.

User cannot view Profile.

Contact the WebCenter Spaces administrator, and request the required permission.

User cannot edit Profile.

Contact the WebCenter Spaces administrator, and request the required permission.

User was not specified

The supplied user name was null or blank. Enter a valid user name.

Modifying property is not allowed

The task flow property may be read-only. In this case, you cannot supply a value.

Error getting an Instant Message address

Contact the WebCenter Spaces administrator.

Error getting tag data

Contact the WebCenter Spaces administrator.

Tried to upload an invalid image

Try again with a valid image type. The file must have the mime-type image, and cannot have the extension *.ico.

Error instantiating object

Contact the WebCenter Spaces administrator.

Error instantiating Profile

Contact Oracle Support Services.

6.4.5.4 Troubleshooting Message Board

Table 6-11 lists problems and responses for troubleshooting Message Board in WebCenter Spaces.

Table 6-11 Message Board Errors and Responses

Problem

Response

Unexpected errors or exceptions

Contact Oracle Support Services.

Failed to create an instance of Message Board

Make sure the user is logged in.

Failed to persist Message Board message

Contact Oracle Support Services.

Failed to publish Message Board activity

Verify the reason for the failure in the Activity Stream subsystem.

Message Board message cannot be deleted

The WebCenter Spaces administrator must explicitly allow users to delete the messages they send. Contact the application administrator, and request the required permission. For more information, see Section 6.4.3.5, "Configuring Message Board."

Message Board message cannot be updated

Contact the WebCenter Spaces administrator, and request the required permission.

Message Board message cannot be added

Message content is empty. Enter message content, and try again. Otherwise, contact Oracle Support Services.

Message Board message cannot be hidden

User does not have permission to hide the message. You can hide only those messages you receive, and not the ones you send.

Failed to query preferences for Message Board

Contact Oracle Support Services.

6.4.5.5 Troubleshooting Feedback

Table 6-12 lists problems and responses for troubleshooting Feedback in WebCenter Spaces.

Table 6-12 Feedback Errors and Responses

Problem

Response

Unexpected errors or exceptions

Contact Oracle Support Services.

Failed to create an instance of Feedback

Make sure the user is logged in.

Failed to persist Feedback message

Contact Oracle Support Services.

Failed to publish Feedback activity

Verify the reason for the failure in the Activity Stream subsystem.

Feedback cannot be deleted

The WebCenter Spaces administrator must explicitly allow users to delete the Feedback they post. Contact the application administrator, and request the required permission. For more information, see Section 6.4.3.6, "Configuring Feedback."

Otherwise, contact Oracle Support Services.

Feedback cannot be updated

Contact the WebCenter Spaces administrator, and request the required permission.

Feedback cannot be added

Feedback content is empty. Enter Feedback content, and try again. Otherwise, contact Oracle Support Services.

Feedback cannot be hidden

User does not have permission to hide the Feedback. You can hide only the Feedback you receive; you cannot hide the Feedback you give.

Failed to query preferences for Feedback

Contact Oracle Support Services.

6.5 Registering Portlet Producers

A portlet producer is the object that owns portlets and makes them available to applications. To make a portlet available in WebCenter Spaces, you must register the portlet's producer with WebCenter Spaces.

This section includes the following subsections:

- Section 6.5.1, "What You Should Know About Registering Portlet Producers"

- Section 6.5.2, "Registering Portlet Producers Through WebCenter Administration"

- Section 6.5.3, "Working with the Producer Registration Task Flow"

- Section 6.5.4, "Deregistering Portlet Producers"

6.5.1 What You Should Know About Registering Portlet Producers

To be able to register and manage portlet producers in WebCenter Spaces, a user must be assigned the AppConnectionManager role. By default, users with the WebCenter Spaces Administrator role are assigned this role; and therefore, WebCenter Spaces administrators can configure portlet producers.

You can grant any other user this capability through Fusion Middleware Control or using the WLST command grantAppRole. For example, the following grantAppRole WLST command grants the AppConnectionManager role to the user monty.

grantAppRole(appStripe='webcenter', appRoleName='AppConnectionManager',  principalClass='weblogic.security.principal.WLSUserImpl', principalName='monty')

For more information about this command, see the section "grantAppRole" in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

See Also:

"Granting Application Roles Using Fusion Middleware Control" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

6.5.2 Registering Portlet Producers Through WebCenter Administration

To register portlet producers through WebCenter Administration, you must have the following roles and permissions:

- AppConnectionManager role—Enables you to manage portlet producers. See the section "Granting Application Roles Using Fusion Middleware Control" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- Application - Manage Configuration permission—Enables access to the WebCenter Administration page. See Chapter 21, "Managing Users, Roles, and Permissions."

You can register portlet producers in WebCenter Spaces using WebCenter Spaces Administration. You can also add the Portlet Producer task flow to any page in WebCenter Spaces to enable users with administration privileges to register portlet producers.

This section includes the following subsection:

- Section 6.5.2.1, "Registering a WSRP Producer."

- Section 6.5.2.2, "Registering an Oracle PDK-Java Producer."

- Section 6.5.2.3, "Registering a Pagelet Producer."

6.5.2.1 Registering a WSRP Producer

When you register a WSRP portlet producer, you provide basic information that describes the producer's operational parameters. This information is used by WebCenter Spaces to communicate with the producer and with the portlets through the producer.

Oracle WebCenter Framework supports both WSRP 1.0 and WSRP 2.0 producers. The WSRP 2.0 standard, among others, provides support for inter-portlet communication and export and import of portlet customizations. You can leverage the benefits of WSRP 2.0 while building standards-based JSR 286 portlets.

To register a WSRP producer with WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, then Services.

3. Under Services & Providers, click Portlet Producers.

4. From the menu bar, click Register.

5. In the Register Portlet Producer page, in the Name and Type section, enter basic information for the portlet producer. See Table 6-13.

Table 6-13 WSRP Producer Registration - Name and Type

Field

Description

Producer Name

Enter a unique name to identify this portlet producer registration within WebCenter Spaces. The name must be unique across all connection types within the WebCenter application.

Producer Type

Select WSRP Producer.

6. In the Portlet Producer URL section, enter connection details for the WSRP producer. See Table 6-14.

Table 6-14 WSRP Portlet Producer Registration - Portlet Producer URL

Field

Description

WSDL URL

Enter the registration URL for the WSRP portlet producer.

The syntax varies according to your WSRP implementation. For example, possible URL formats for a portlet deployed to the Oracle WSRP container include:

http://host:port/context_root/portlets/wsrp2?WDSL
http://host:port/context_root/portlets/wsrp1?WSDL
http://host:port/context_root/portlets/?WSDL

where:

- host is the server where the producer is deployed

- port is the HTTP Listener port

- context_root is the Web application's context root

In WebCenter Spaces, only v2 WSDLs are supported for Oracle WebLogic Portal Producers.

Use Proxy?

Select if WebCenter Spaces and the remote portlet producer are separated by a firewall and must use an HTTP proxy for communication. If selected, enter values for Proxy Host and Proxy Port.

Proxy Host

Enter the address for the proxy server.

Do not prefix http:// to the proxy server name.

Proxy Port

Enter the port number on which the proxy server listens. The default port is 80.

7. In the Advanced Configuration section, specify additional information for the WSRP producer. See Table 6-15.

Table 6-15 WSRP Portlet Producer Registration - Advanced Configuration

Field

Description

Default Execution Timeout

Enter a suitable timeout for design time operations. For example, the maximum time the producer may take to register, deregister, or display portlets on WebCenter pages. The default is 30 seconds.

Individual portlets may define their own timeout period, which takes precedence over the value specified here.

8. In the Security section, from the Token Profile dropdown list, select the type of security token to use for the identity propagation/assertion. The other fields in this section vary depending on the security token selected. See Table 6-16.
The security token with the propagated or asserted user information is represented as an XML element in the SOAP header. The security token and the SOAP message body are then digitally signed to prove the authenticity of the SOAP message origin from the WebCenter application. WebCenter Spaces supports six types of security tokens: WSS 1.0 Username Token Without Password, WSS 1.0 Username Token With Password, WSS 1.0 SAML Token, WSS 1.0 SAML Token With Message Integrity, WSS 1.0 SAML Token With Message Protection, and WSS 1.1 SAML Token With Message Protection.

Table 6-16 WSRP Portlet Producer Registration - Security

Field

Description

Token Profile

Select the type of token profile to use for authentication with this WSRP producer:

- None—No security on this connection. If you select None, no WS-Security header is attached to the SOAP message.

- WSS 1.0 SAML Token—This policy provides SAML-based authentication for outbound SOAP request messages in accordance with the WS-Security 1.0 standard. The policy propagates user identity and is typically used in intra departmental deployments where message protection and integrity checks are not required.
This policy does not require any keystore configuration.

- WSS 1.0 SAML Token with Message Integrity—This policy provides message-level integrity protection and SAML-based authentication for outbound SOAP requests in accordance with the WS-Security 1.0 standard. A SAML token, included in the SOAP message, is used in SAML-based authentication with sender vouches confirmation. This policy uses WS-Security's Basic 128 suite of asymmetric key technologies and SHA-1 hashing algorithm for message integrity.

- WSS 1.0 SAML Token with Message Protection—This policy provides message-level protection (integrity and confidentiality) and SAML-based authentication for outbound SOAP requests in accordance with the WS-Security 1.0 standard. The Web service consumer includes a SAML token in the SOAP header and the confirmation type is sender-vouches. This policy uses WS-Security's Basic 128 suite of asymmetric key technologies. Specifically, RSA key mechanisms for message confidentiality, SHA-1 hashing algorithm for message integrity, and AES-128 bit encryption.
When you select this policy, you must also specify the Recipient Alias.

- WSS 1.0 Username Token with Password—This policy provides username (with password) token profile based identity propagation with certificate based message protection for outbound SOAP requests in accordance with the WS-Security v1.0 standard. Both plain text and digest mechanisms are supported. This policy uses WS-Security's Basic128 suite of asymmetric key technologies. Specifically, RSA key mechanism for message confidentiality, SHA-1 hashing algorithm for message integrity, and AES-128 bit encryption.
Use this token profile if the WSRP producer has a different identity store. You must define an external application pertaining to the producer and associate the external application with this producer. The external application defined here is used to retrieve and propagate the user credentials to the producer. The producer verifies this against the identity store configured for the external application.

When you select this policy, you must also specify the Recipient Alias.

Token Profile (Cont.)

- WSS 1.0 Username Token without Password—This policy provides username (with password) token profile based identity propagation with certificate based message protection for outbound SOAP requests in accordance with the WS-Security 1.0 standard. Credentials (username only) are included in outbound SOAP request messages through a WS-Security UsernameToken header. No password is included. Message protection is provided using WS-Security 1.0's Basic128 suite of asymmetric key technologies. Specifically, RSA key mechanisms for message confidentiality, SHA-1 hashing algorithm for message integrity, and AES-128 bit encryption.
When you select this policy, you must also specify the Recipient Alias.

- WSS 1.1 SAML Token with Message Protection—This policy provides message-level protection (integrity and confidentiality) and SAML token population for outbound SOAP requests in accordance with the WS-Security 1.1 standard. A SAML token, included in the SOAP message, is used in SAML-based authentication with sender vouches confirmation. This policy uses the symmetric key technology for signing and encryption, and WS-Security's Basic128 suite of asymmetric key technologies for endorsing signatures.

Recipient Alias

Specify the key store alias that is associated with the producer's certificate.

This certificate is used to encrypt the message to the producer.

Valid for: WSS 1.0 SAML Token With Message Protection, WSS 1.1 SAML Token with Message Protection and WSS 1.0 Username Without Password.

Default User

Enter a user name to assert to the remote producer when the user is not authenticated with WebCenter Spaces.

When unauthenticated, the identity anonymous is associated with the application user. OWSM does not currently support the propagation of an anonymous identity, so you must specify an alternative identity here. Keep in mind though, that in this case, the WebCenter Spaces application has not authenticated the user so the default user you specify should be a low privileged user in the remote producer that is an appropriate identity to use for showing public content. For example, you may want to create a guest account in the identity store for this purpose. If the user has authenticated to the application, then the user's identity is asserted rather than the default user.

The remote WSRP producer must be set up to accept this information. You must also add a grant to the policy store as described in the section "Adding a Grant to the Policy Store for a Mapped User Identity" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Valid for: WSS 1.0 SAML Token With Message Integrity, WSS 1.0 SAML Token With Message Protection, WSS 1.0 SAML Token, WSS 1.1 SAML Token with Message Protection and WSS 1.0 Username Without Password.

Associated External Application

If this producer uses an external application for authentication, use the Associated External Application dropdown list to identify the application.

An external application is required to support producers using the security option WSS 1.0 Username Token With Password. The external application stores and supplies the user credentials. See also Section 6.6, "Registering External Applications."

Valid for: WSS 1.0 Username With Password only.

9. Click Test to test the registration.

10. Click Ok.

6.5.2.2 Registering an Oracle PDK-Java Producer

When you register a PDK-Java portlet producer, you provide basic information that describes the producer's operational parameters. This information is used by WebCenter Spaces to communicate with the producer and with the portlets through the producer.

To register an Oracle PDK-Java portlet producer with WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, then Services.

3. Under Services & Providers, click Portlet Producers.

4. From the menu bar, click Register.

5. In the Register Portlet Producer page, in the Name and Type section, enter basic information for the portlet producer. See Table 6-17.

Table 6-17 PDK-Java Portlet Producer Registration - Name and Type

Field

Description

Producer Name

Enter a unique name to identify this portlet producer registration within WebCenter Spaces. The name must be unique across all connection types within the WebCenter application.

Producer Type

Select Oracle PDK-Java Producer.

6. In the Portlet Producer URL section, enter connection details for the Oracle PDK-Java producer. See Table 6-18.

Table 6-18 PDK-Java Portlet Producer Registration - Portlet Producer URL

Field

Description

URL Endpoint

Enter the Oracle PDK-Java producer's URL using the following syntax:

http://host:port/context_root/providers

where:

- host is the server where the producer is deployed

- port is the HTTP Listener port number

- context_root is the Web application's context root

Service ID

Enter the unique identifier for this producer.

PDK-Java enables you to deploy multiple producers under a single adapter servlet. Producers are identified by their unique service ID. A service ID is required only if the service ID is not appended to the URL Endpoint.

The service ID is used to look up a file called serviceId.properties, which defines the characteristics of the portlet producer, such as whether to display its test page. If you do not specify a service ID, the _default.properties file is used instead.

Use Proxy?

Select if the WebCenter application and the remote portlet producer are separated by a firewall and must use an HTTP proxy for communication. If selected, enter values for Proxy Host and Proxy Port.

Proxy Host

Enter the address for the proxy server.

Do not prefix http:// to the proxy server name.

Proxy Port

Enter the port number on which the proxy server listens. The default port is 80.

Associated External Application

Select the relevant external application if one of this producer's portlets requires authentication.

See also Section 6.6, "Registering External Applications."

Establish Session?

Select to enable a user session when executing portlets from this producer. When sessions are enabled, they are maintained on the producer server. This allows the portlet code to maintain information in the session.

Message authentication uses sessions, so if you specify a shared key, you must also select this option.

For sessionless communication between the producer and the server, do not select this option.

7. In the Advanced Configuration section, specify additional information for the PDK-Java producer. See Table 6-19.

Table 6-19 PDK-Java Portlet Producer Registration - Advanced Configuration

Field

Description

Default Execution Timeout

Enter a suitable timeout for communications with the producer, in seconds. For example, the maximum time the producer may take to register, deregister, or display portlets on WebCenter pages. The default is 30 seconds.

Individual portlets may define their own timeout period, which takes precedence over the value specified here.

Subscriber ID

Enter a string to identify the consumer of the producer being registered.

When a producer is registered with an application, a call is made to the producer. During the call, the consumer (WebCenter Spaces in this instance) passes the value for Subscriber ID to the producer. If the producer does not see the expected value for Subscriber ID, it might reject the registration call.

Shared Key

Enter a shared key to use for producers that are set up to handle encryption.

The shared key is used by the encryption algorithm to generate a message signature for message authentication. Note that producer registration fails if the producer is set up with a shared key and you enter an incorrect shared key here. The shared key can contain between 10 and 20 alphanumeric characters.

This key is also used when registering a producer using the Federated Portal Adapter (FPA). The Shared Key is also known as the HMAC key.

8. Click Test to test the registration.

9. Click Ok.

6.5.2.3 Registering a Pagelet Producer

This section describes how to register a Pagelet Producer using WebCenter Spaces Administration.

To register a pagelet producer with WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, then Services.

3. Under Services & Providers, click Portlet Producers.

4. From the menu bar, click Register.

5. In the Register Portlet Producer page, in the Name and Type section, enter basic information for the pagelet producer. See Table 6-20.

Table 6-20 Pagelet Producer Registration - Name and Type

Field

Description

Producer Name

Enter a unique name to identify this pagelet producer registration within WebCenter Spaces. The name must be unique across all connection types within the WebCenter application.

Producer Type

Select Pagelet Producer.

6. In the Portlet Producer URL section, enter connection details for the pagelet producer. See Table 6-21.

Table 6-21 Pagelet Producer Registration - Portlet Producer URL

Field

Description

Producer Type

Server URL

Enter the URL of the WebCenter Pagelet Producer. The URL must include a fully-qualified domain name. Use the following syntax:

protocol://host:port

For example:http://myhost.example.com:7778/ If pagelets carry secure data, the URL registered must use the HTPPS protocol. For example:https://myhost.com:7779/

In WebCenter Spaces, if the Pagelet Producer URL is protected by OAM, the URL to the pagelet catalog must be excluded (mapped directly without access control), or the catalog will appear to be empty when using REST. The pagelet catalog URL is http://proxy_host:proxy_port/api/v2/ensemble/pagelets.

Pagelet

7. Click Test to test the registration.

8. Click Ok.

6.5.3 Working with the Producer Registration Task Flow

To manage portlet producers through the Producer Registration task flow, you must have the following roles and permissions:

- AppConnectionManager role—Enables you to manage portlet producers.

- View Page permission—Enables access to the page containing the task flow. See Section 23.1, "Setting Access on a Page."

This section includes the following subsections:

- Section 6.5.3.1, "Adding the Producer Registration Task Flow to a Page"

- Section 6.5.3.2, "Registering Producers Through the Producer Administration Task Flow."

- Section 6.5.3.3, "Setting Producer Task Flow Properties."

6.5.3.1 Adding the Producer Registration Task Flow to a Page

To add a Producer Registration task flow:

1. Go to the page where you want to add the task flow, and open it in Oracle Composer.
For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. In Oracle Composer, click the Add Content button to open the Add Content dialog.

3. In the Add Content dialog, open Portlets.

4. In the Portlets folder, open Administration.

5. In the Administration folder, click the Add link next to the Producer Registration task flow. This adds the task flow to the page.

6. Click Close to exit Add Content dialog.

6.5.3.2 Registering Producers Through the Producer Administration Task Flow

When you have added the Producer Administration task flow to your page, you can register any portlet producer as described in the following tables in Section 6.5.2, "Registering Portlet Producers Through WebCenter Administration":

- WSRP Producers

- Table 6-13, "WSRP Producer Registration - Name and Type"

- Table 6-14, "WSRP Portlet Producer Registration - Portlet Producer URL"

- Table 6-15, "WSRP Portlet Producer Registration - Advanced Configuration"

- Table 6-16, "WSRP Portlet Producer Registration - Security"

- Oracle PDK-Java Producers

- Table 6-17, "PDK-Java Portlet Producer Registration - Name and Type"

- Table 6-18, "PDK-Java Portlet Producer Registration - Portlet Producer URL"

- Table 6-19, "PDK-Java Portlet Producer Registration - Advanced Configuration"

- Pagelet Producers

- Table 6-20, "Pagelet Producer Registration - Name and Type"

- Table 6-21, "Pagelet Producer Registration - Portlet Producer URL"

See also, Section 6.5.4, "Deregistering Portlet Producers."

6.5.3.3 Setting Producer Task Flow Properties

The Producer Registration task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 6-10).

Most properties are common to all task flows, and the method for accessing task flow properties is the same from task flow to task flow. Common task flow properties and how to access them are discussed in Section 17.5.2, "Setting Properties on Page Components".

Figure 6-10 Producer Registration Task Flow Component Properties

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties".

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events".

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Section 17.5.2.6, "Working with Child Components".

All properties on Display Options tab provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions".

6.5.4 Deregistering Portlet Producers

If you no longer want to use a particular producer in WebCenter Spaces, you can deregister the producer. When you deregister a producer, registration data is removed from both WebCenter Spaces and the remote producer:

- WebCenter Spaces - The producer connection is deleted and producer metadata is also deleted.

- Remote producer - Portlet instances are deleted (not the portlets themselves).

Portlet instances are not removed from WebCenter Spaces pages. In place of the portlet, WebCenter users see a "Portlet unavailable" message.

To deregister a portlet producer:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, then Services.

3. Under Services & Providers, click Portlet Producers.

4. Select the portlet producer that you want to remove.

5. From the menu bar, click Deregister.

6.6 Registering External Applications

An external application is any application that implements its own authentication process. Specifically, it is an application that does not take part in your WebCenter Spaces's single sign-on process. If WebCenter Spaces interacts with an application that handles its own authentication, you can associate WebCenter Spaces with an external application definition to allow for credential provisioning. In doing so, you use an external application definition to provide a means of accessing content from these independently authenticated applications. The WebCenter services such as, Mail, IMP, Documents, portlet producers associate external applications with their connections to use the user credential management feature and to connect and access content from these independently authenticated applications.

You can manage external applications through the Services tab in the WebCenter Administration page, the External Application task flow, and the Application Navigator task flow. These features are discussed in details in the following subsections:

- Section 6.6.1, "What You Should Know About External Applications"

- Section 6.6.2, "Registering External Applications Through WebCenter Administration"

- Section 6.6.3, "Working with Task Flows for External Applications"

- Section 6.6.4, "Deleting External Applications"

6.6.1 What You Should Know About External Applications

To be able to register and manage external applications in WebCenter Spaces, a user be assigned the AppConnectionManager role. By default, users with the WebCenter Spaces Administrator role are assigned this role; and therefore, WebCenter Spaces administrators can configure external applications.

You can grant any other user this capability through Fusion Middleware Control or WLST command grantAppRole. For example, the following grantAppRole WLST command grants the AppConnectionManager role to the user monty.

grantAppRole(appStripe='webcenter', appRoleName='AppConnectionManager',
principalClass='weblogic.security.principal.WLSUserImpl', principalName='monty')

For more information about this command, see the section "grantAppRole" in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

See also, "Granting Application Roles Through Fusion Middleware Control" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

6.6.2 Registering External Applications Through WebCenter Administration

To register external applications through WebCenter Administration you must have the following roles and permissions:

- AppConnectionManager role - Enables you to manage external applications. See also, "Granting Application Roles Through Fusion Middleware Control" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- Application - Manage Configuration permission - Enables access to the WebCenter Administration page.

To register an external application for WebCenter Spaces:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Configuration, then Services.

3. Under Services & Providers, select External Applications.

4. To register a new external application, click Register (Figure 6-11).

Figure 6-11 Registering External Applications

External application options display (Figure 6-12).

Figure 6-12 Configuring External Application Connections

5. Enter a unique name for the external application and a display name that WebCenter users working with this external application will see.
See also, Table 6-22.

Table 6-22 External Application Connection - Name

Field

Description

Application Name

Enter a name to identify the application within WebCenter Spaces. The name must be unique (across all connection types) within the WebCenter application.

For example: yahoo

Note: Once registered, you cannot edit the Application Name.

Display Name

Enter a user friendly name for the application that WebCenter users will recognize. WebCenter end-users working with this external application will see the display name you specify here.

The display name must be unique across all external applications within WebCenter Spaces.

For example: My Yahoo

If you leave this field blank, the Application Name is used.

6. Enter login details for the external application.
For details, see Table 6-23.

Table 6-23 External Application Connection - Login Details

Field

Description

Enable Automatic Login

Select to allow automatically log users in to this application. Choosing this option requires you to complete the Login URL, HTML User ID Field Name, and HTML User Password Field Name fields

With automated single sign-on, the user directly links to the application and is authenticated automatically, as their credentials are retrieved from the credential store. Selecting this option provides the end user with a seamless single sign-on experience.

Note: Automated login is not supported for:

- External applications using BASIC authentication.

- External applications configured for SSO.

- External applications with a customized login form (built using ADF Faces) that does not implement the J2EE security container login method j_security_check for authentication.

- External sites that do not support UTF8 encoding.

Login URL

Enter the login URL for the external application.

To determine the URL, navigate to the application's login page and record the URL.

For example: http://login.yahoo.com/config/login

Note: A login URL is not required if the sole purpose of this external application is to store and supply user credentials on behalf of another service.

HTML User ID Field Name

Enter the name that identifies the "user name" or "user ID" field on the login form.

Tip: To find this name, look at the HTML source for the login page.

This property does not specify user credentials.

Note: Mandatory if the Authentication Method is GET or POST and a Login URL is specified. Leave this field blank if the application uses the basic authentication.

HTML User Password Field Name

Enter the name that identifies the "password" field on the login form.

Tip: To find this name, look at the HTML source for the login page.

Note: You must complete this field if the Authentication Method is GET or POST. Leave this field blank if the application uses basic authentication (see Authentication Method).

7. Select the authentication method used by the external application.
For details, see Table 6-24.

Table 6-24 External Application Connection - Authentication Details

Field

Description

Authentication Method

Select the form submission method used by the external application. Choose from one of the following:

- GET: Presents a page request to a server, submitting the login credentials as part of the login URL. This authentication method may pose a security risk because the user name and password are exposed in the URL.

- POST: Submits login credentials within the body of the form. This is the default.

- BASIC: Submits login credentials to the server as an authentication header in the request. This authentication method may pose a security risk because the credentials can be intercepted easily and this scheme also provides no protection for the information passed back from the server. The assumption is that the connection between the client and server computers is secure and can be trusted.

The Authentication Method specifies how message data is sent by the browser. You can find this value by viewing the HTML source for the external application's login form, for example, <form method="POST" action="https://login.yahoo.com/config/login?" AutoComplete="off">

8. Specify additional login fields and details, if required.
For details, see Table 6-25.

Table 6-25 External Application Connection - Additional Login Fields

Field

Description

Additional Login Fields

If your application requires additional login criteria, expand Additional Login Fields.

For example, in addition to user name and password, the Lotus Notes application requires two additional fields - Host and MailFilename.

Click Add to specify an additional field for the login form. For each new field, do the following:

- Name - Enter the name that identifies the field on the HTML login form that may require user input to log in. This field is not applicable if the application uses basic authentication.

- Value - Enter a default value for the field or leave blank for a user to specify. This field is not applicable if the application uses basic authentication.

- Display to User - Select to display the field on the external application login screen. If the field is not displayed (unchecked), then a default Value must be specified.

Click Delete to remove a login field.

9. Specify shared and public user credentials, if required.
For details, see Table 6-26.

Table 6-26 External Application Connection - Shared User and Public User Credentials

Field

Description

Enable Shared Credentials

Indicate whether this external application enables shared user credentials, and specify the credentials. Select Enable Shared Credentials, and then enter User Name and Password credentials for the shared user.

When shared credentials are specified, every user accessing this external application, through WebCenter Spaces, is authenticated using the user name and password defined here. WebCenter users are not presented with a login form.

Because WebCenter users do not need to define personal credentials of their own, external applications with shared credentials are not listed in the external application's change password task flows such as My Accounts (see also Section 35.7, "Providing Login Information for External Applications".)

Enable Public Credentials

Indicate whether unauthenticated users (public users) may access this external application. Select Enable Public Credentials, and then enter User Name and Password credentials for the public user.

When public credentials are specified, public users accessing this external application through WebCenter Spaces public pages are logged in using the user name and password defined here. If public credentials are not specified, public users will see an authorization error indicating this external application is not accessible to public users.

10. Click OK to register the application.

6.6.3 Working with Task Flows for External Applications

To register external applications through an external application task flow you must have the following roles and permissions:

- AppConnectionManager role - Enables you to manage external applications. See also, "Granting Application Roles Through Fusion Middleware Control" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- View Page permission - Enables access to the page containing the task flow. See also, Section 23.1, "Setting Access on a Page."

This section includes the following subsections:

- Section 6.6.3.1, "Adding an External Application Task Flow to a Page"

- Section 6.6.3.2, "Registering External Applications Through the External Application Task Flow"

- Section 6.6.3.3, "Adding an Application Navigator Task Flow to a Page"

- Section 6.6.3.4, "Making External Applications Available through the Application Navigator Task Flow"

- Section 6.6.3.5, "Setting External Application Task Flow Properties"

6.6.3.1 Adding an External Application Task Flow to a Page

Note:

External applications links exposed in the Application Navigator task flow are not automatically removed when an external application is deleted. To prevent unsuccessful access attempts, administrators are advised to remove links to unavailable applications.

To add an External Application task flow:

1. Go to the page where you want to add a task flow, and open it in Oracle Composer.
For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. In Oracle Composer, click the Add Content button to open the Add Content dialog.

3. In the Add Content dialog, open Portlet Administration, as shown in Figure 6-13.

Figure 6-13 Add Content dialog - Portlet Administration

4. In the Portlet Administration folder, click the Add link next to the External Application task flow.

5. In the Add Content dialog, click Close. This adds the task flow to the page, as shown in Figure 6-14.

Figure 6-14 External Application Task Flow in a Page

6.6.3.2 Registering External Applications Through the External Application Task Flow

Once you have added the External Application task flow to your page, you can register any external application as described in the following tables in Section 6.6.2, "Registering External Applications Through WebCenter Administration":

- Table 6-22, "External Application Connection - Name"

- Table 6-23, "External Application Connection - Login Details"

- Table 6-24, "External Application Connection - Authentication Details"

- Table 6-25, "External Application Connection - Additional Login Fields"

- Table 6-26, "External Application Connection - Shared User and Public User Credentials"

See also, Section 6.6.4, "Deleting External Applications."

6.6.3.3 Adding an Application Navigator Task Flow to a Page

The Application Navigator task flow enables centralized access to frequently used Web applications. Once links to your applications are set up, you simply click links to launch your day-to-day applications, and if necessary, supply your user name and password information.

Other WebCenter users may not want to see all the applications offered through the Applications Navigator. If this is the case, individuals may personalize their view to show only those applications they want to access.

The Applications Navigator can launch different types of application:

- External Applications - Web-based, external applications that perform their own user authentication.

- WebCenter Task Flows - Built-in task flows specific to WebCenter Spaces. Any of these can be launched directly from the Applications Navigator.

Before You Begin:

- Ensure that the Application Navigator task flow is included in the Resource Catalog you will use for your page. The Application Navigator task flow is not available in the Resource Catalog by default. To add this task flow to your Resource Catalog, follow the steps described in Section 16.3.1.2, "Adding Resources" and select Task Flows from the library. The Task Flows option in the Add Resource Catalog Item dialog includes the Application Navigator task flow, as shown in Figure 6-15.

Figure 6-15 Add Resource Catalog Item

- Consider the points described in Section 6.6.1, "What You Should Know About External Applications."

To add an Application Navigator task flow:

1. Go to the page in which you want to add a task flow, and open it in Oracle Composer.
For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. In Oracle Composer, click the Add Content button to open the Add Content dialog.

3. In the Add Content dialog, select Application Navigator, as shown in Figure 6-16, and click the Add link.

Figure 6-16 Add Content - Application Navigator

4. In the Add Content dialog, click Close.
This adds the task flow to the page, as shown in Figure 6-17.

Figure 6-17 Application Navigator Task Flow in a Page

Section 6.6.3.4, "Making External Applications Available through the Application Navigator Task Flow" describes how to add links to frequently used applications or task flows.

6.6.3.4 Making External Applications Available through the Application Navigator Task Flow

Use the Application Navigator to display links to external applications registered with WebCenter Spaces and also links to any of the built-in WebCenter task flows.

Some WebCenter users may not want to see all the applications offered through the Applications Navigator. If this is the case, individuals may personalize their view to show only those applications they want to access.

To expose an application or task flows through the Applications Navigator:

1. In the page in which you added the Application Navigator task flow, click Edit applications (spanner icon) available for the task flow.
If you do not have edit privileges you will not see this icon.

2. To add a link to an application, select the folder where you want the link to appear, and then click the green Add icon.
To add a new folder, click the New icon. To create a subfolder, expand the parent folder first.

3. Navigate to the external application or task flow you require, and click its associated Add link.

- To navigate to a previously registered external application, expand the External Applications node, and then expand the required application.
Only registered external applications which have a Login URL defined appear in this list. If the application you want is not listed, ask your WebCenter administrator to register the application for you. See also Section 6.6.3.2, "Registering External Applications Through the External Application Task Flow".

- To navigate to a task flow, expand the WebCenter Task Flows node. If necessary, expand one or more subfolders to access the required task flow.

If you are not sure of the exact name, enter a full or partial search term in the Search box, and then click Find to search for the application. Application names matching your search criteria are displayed.

An information message displays indicating whether the application link was successful.

4. Click OK to dismiss the message box.

5. To add another application, repeat steps 4 and 5.

6. Click OK to return to the Edit Applications dialog.
The selected application(s) appears within your chosen folder. From here, you can change the display name for the application link and set other display-related properties.

7. To edit link details for an application, highlight the row in the table and then click the Edit icon.
The Edit Application Link dialog opens.

8. Edit the link display properties, as required.
For details, see Table 6-27, "Application Link Properties":

Table 6-27 Application Link Properties

Property

Description

Name

Enter the link text that WebCenter users will click to launch the application.

Location

(Read-only) Displays the internal name for the application or task flow.

Open Behavior

Choose how the application displays when users click the link:

- WebCenter Tab - Application displays as a tab in WebCenter Spaces, and the application displays there. The current WebCenter Spaces context is maintained.

- New Window - Application opens in a new browser window. The current WebCenter Spaces context is maintained. This is the default selection.

- Current Window - Application opens in the current browser window (in place of WebCenter Spaces).

Type

(Read-only) Displays the link type: EXTAPP - External application or TASKFLOW - WebCenter task flow

Icon

Associate an icon with the application. Enter a full qualified URL or a relative URL that specifies the location of a valid icon.

The icon displays alongside the link in the Application Navigator. For best results, choose an icon that is 16 x 16 pixels.

Created On

Shows when the link was created.

Last Visited On

Shows the last time a user clicked the link.

If a link is not used very often or at all, you might consider removing it from the Application Navigator.

Locked

Indicate whether WebCenter users are allowed to show/hide the link.

Select Locked to prevent users from showing/hiding the link. Deselect Locked to let the user decide whether the link displays in their personal view. Individuals users can show or hide the link depending of whether they need access to the application from the Sidebar.

Visible

Indicate whether WebCenter users see a link to this application in the Applications pane.

Select Visible to show the link. Deselect Visible to hide the link.

9. Click OK to save.

10. Click Close to dismiss the Edit Application Link dialog.

If you choose not to lock application links, other users, including yourself, can hide/show links in the Application Navigator task flow by clicking Personalize applications (pencil icon), as shown in Figure 6-18.

Figure 6-18 Personalize Applications

6.6.3.5 Setting External Application Task Flow Properties

The External Application task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 6-19).

The properties are common to all task flows, and the method for accessing task flow properties is the same from task flow to task flow. Common task flow properties and how to access them are discussed in Section 17.5.2, "Setting Properties on Page Components".

Figure 6-19 External Application Task Flow Component Properties

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties".

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events".

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Section 17.5.2.6, "Working with Child Components".

All properties on Display Options tab provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions".

6.6.4 Deleting External Applications

To delete an external application:

1. Open WebCenter Spaces Administration.
For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration, then Services.

3. Under Services & Providers, select External Applications.

4. Select the name of the external application you want to remove, and click Deregister.

Note:

If you also manage external applications through the Application Navigator task flow, ensure that you manually remove the external applications links added through this task flow, to prevent unsuccessful access attempts.

7 Preparing Your Initial Portal Pages

In the process of constructing your portal, you may want to brand the Welcome page that all users see when they first access your portal, add a hint to the login page or the self-registration page, or place additional components on the default pages that users see in their Home Spaces. Such pages, called system pages, are provided out of the box and are partly or wholly customizable.

You can also start your portal out with a set of pages that are targeted to a specific type of user, such as a page for all members of your sales team, all department heads, all engineers, and the like. Such pages, called business role pages, are exposed to targeted users in their views of the Home Space.

Finally, as an application administrator, you can view, revise, and manage all personal pages that users have added to their views of the Home Space.

This chapter provides overviews of personal, business role, and system pages and describes how to work with them. It includes the following sections:

- Section 7.1, "Working with Business Role Pages"

- Section 7.2, "Working with Personal Pages"

- Section 7.3, "Working with System Pages"

Audience

This chapter is intended for administrator-level users tasked with setting up the pages users see when they access your portal. Among these are the welcome, login, and self-registration pages; pages that are targeted to a particular business role, such as sales, engineering, and finance; and the like. This chapter also provides information about providing administrative services for the personal pages that users create in their views of the Home Space.

Application administrators are users who are granted the WebCenter Spaces Administrator role or a custom role that grants the Application-Manage permission.

Note:

To enable a user to edit, delete, or perform all actions on system and business role pages, you must grant them the Application-Manage permission.

7.1 Working with Business Role Pages

Business role pages provide a powerful tool for exposing content that is highly relevant to a specific audience. Business role pages are pages targeted to a particular type of group, or user (or user role), such as your sales force, your accounting team, your administrative staff. Business role pages are exposed to targeted users in their views of the Home Space.

This section describes how to create and target business role pages and how to perform other related business role page management tasks. It includes the following subsections:

- Section 7.1.1, "What You Should Know About Business Role Pages"

- Section 7.1.2, "Setting Page Creation Defaults for Business Role Pages"

- Section 7.1.3, "Creating a Business Role Page"

- Section 7.1.4, "Specifying the Target Audience for a Business Role Page"

- Section 7.1.5, "Revoking Access to a Business Role Page"

- Section 7.1.6, "Adding Business Role Pages to Navigation"

- Section 7.1.7, "Setting a Default Display Order for Business Role Pages"

- Section 7.1.8, "Editing a Business Role Page"

- Section 7.1.9, "Copying a Business Role Page"

- Section 7.1.10, "Deleting a Business Role Page"

7.1.1 What You Should Know About Business Role Pages

A business role page appears in the Home Space views of all users who share the targeted business role, provided the administrator has set up a navigation model that publishes business role pages. For example, a business role page that targets all users assigned the HR_ORG role appears in the Home Space views of all users assigned the role HR_ORG.

Tip:

Irrespective of the applied navigation model, business role pages are always available to targeted users on the Personalize Pages page.

If an individual user who is not assigned the HR_ORG role wants to see the page, the application administrator can grant access to this user. This is true for the business role pages you, as the administrator, create. Seeded business role pages (see Table 7-1) have preconfigured access settings that cannot be altered.

A WebCenter Spaces administrator is the only type of user who can create a business role page. Only when an administrator grants permission to do so can other users edit, copy, and delete business role pages, and change page permissions (for more information, see Section 7.1.4, "Specifying the Target Audience for a Business Role Page").

Table 7-1 lists and describes the seeded business role pages included in a default WebCenter Spaces installation and provides information about the context in which they appear.

Table 7-1 Seeded Business Role Pages

Page

Description

Context

Activities

Displays the Activity Stream from the People Connections service and a Message Board Publisher component, which can be used to post a current personal status message (in response to "What's on your mind?"). For more information, see Section 32, "Tracking Your Connections' Activities," and Section 33, "Posting and Managing Messages and Feedback."

Appears by default in the Home Space views of every authenticated user.

Analytics

Displays performance metrics related to the application, Spaces, portlets, and services. For more information, see Chapter 55, "Analyzing Usage and Performance Metrics."

Is hidden by default, but can be accessed by application administrators on the Personalize Pages page in an administrator's view of the Home Space.

Documents

Displays the Document Explorer task flow. For more information, see Section 41.1, "What You Should Know About the Documents Service Task Flows."

This page also appears on the System Pages subtab (for more information, see Section 7.3, "Working with System Pages").

Appears by default in the Home Space views of every authenticated user.

My Profile

Displays the current user's Profile Gallery, which includes subpages for Activity Stream, Connections, Documents, an organization chart (Organization), and the user's profile details (About). For more information, see Chapter 30, "Managing Your Profile," and Section 41.1, "What You Should Know About the Documents Service Task Flows."

This page also appears on the System Pages subtab (for more information, see Section 7.3, "Working with System Pages").

Appears by default in the Home Space views of every authenticated user.

Spaces

Displays Spaces relevant to the current user, such as the Spaces to which the user belongs, that are discoverable by the user, to which the user has access (such as a public Space). Each listed Space has an associated menu with options for performing actions on the Space. This page also provides controls for creating Spaces and searching for additional Spaces.

Appears by default in the Home Space views of every authenticated (logged-in) user.

Space Templates

Displays a list of default and custom Space templates and provides a means of creating custom Space templates and filtering the template list.

Is hidden by default, but can be accessed on the Personalize Pages page in the Home Space views of every authenticated user.

Tag Center

Displays the Tag Center that is rendered when users click a tag in a Tags task flow or in search results. For more information, see Chapter 57, "Working with the Tags Service."

Invoked when users click tags.

7.1.2 Setting Page Creation Defaults for Business Role Pages

As the application administrator, you have the option of setting page creation defaults to reduce the number of steps required to create business role pages. That is, you can use page creation defaults to specify the options that are selected by default when you open the Create Page dialog. You can take this further by enforcing your selections, turning business role page creation into a one-click operation. When you enforce your selections, you are telling the application that you want to bypass the Create Page dialog and create business role pages based on your default selections.

See Also:

Administration-level page creation defaults apply to business role and personal pages. Authorized users can also set page creation defaults for personal pages created within the context of the Home Space (for more information, see Section 38.1.1, "Setting Page Creation Defaults for Personal Pages"). Defaults for pages created within the context of a Space are controlled by the Space moderator (for more information, see Section 51.7, "Creating and Managing Space Pages").

To set page creation defaults for business role pages:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click Business Role Pages to view a list of all business role pages (Figure 7-1).
Alternatively, use the following URL to go to this page:

http://host:port/webcenter/spaces/admin/brpages

Figure 7-1 Business Role Pages

2. Click Set Page Defaults (Figure 7-2).

Figure 7-2 Set Page Defaults Option

The Set Page Defaults dialog opens (Figure 7-3):

Figure 7-3 Set Page Defaults Dialog

3. To set page creation defaults:

1. Select a layout from the Style dropdown list.

See Also:

For illustrations and descriptions of default page styles, see Table 15-2, "Default Page Styles".

2. Select an option next to Enable One-Click Page Creation:
Yes—When you create a business role page, skip the Create Page dialog, and create the page using the defaults you set here.

No—When you create a business role page, have the defaults you set here preselected in the Create Page dialog.

4. Click Save to save your changes and exit the dialog.

Going forward, when you create business role pages, the defaults you set here determine the style that is preselected for the new page and whether the Create Page dialog opens. When users create personal pages in the Home Space, the defaults set here determine page creation behavior, provided authorized users have not overridden this application-level default with their personal page settings.

See Also:

Authorized users can also set their own page creation defaults for personal pages created within the context of the Home Space (for more information, see Section 38.1.1, "Setting Page Creation Defaults for Personal Pages").

7.1.3 Creating a Business Role Page

To create a new business role page:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click Business Role Pages to view a list of all business role pages (Figure 7-4).
Alternatively, use the following URL to go to this page:

http://host:port/webcenter/spaces/admin/brpages

Figure 7-4 Business Role Pages

2. Click Create New Business Role Page.
If you enabled one-click page creation, the new page opens. If you did not enable one-click page creation, continue with the next steps.

See Also:

The application administrator can set an attribute on a custom page style that determines whether a newly created page that is based on that style opens in page edit mode or page view mode. For more information, see Section 15.4.2, "Setting Properties on a Custom Page Style."

3. Enter a unique name for the page (Page Name), and then select a page style.

See Also:

For an overview of seeded page styles, see Table 15-2, "Default Page Styles".

4. Click Create to open the newly created page.
Later, you can add content to the page. The next section (Section 7.1.4) steps you through setting access permissions for the business role page.

5. Next steps:

- Define the page audience, see Section 7.1.4, "Specifying the Target Audience for a Business Role Page."

- Choose the page display order, see Section 7.1.7, "Setting a Default Display Order for Business Role Pages."

- Add content to the page, see Chapter 18, "Adding and Configuring Page Layout Components," and Chapter 13, "Adding Spaces Components to Your Templates."

7.1.4 Specifying the Target Audience for a Business Role Page

The target audience for business role pages may change from time to time. For example, you may want the whole Sales team to see a page originally designed for a Product Development team. You may want to provide public access to the Marketing department's page. You may want to provide additional access privileges, such as the Edit Page privilege, to a selected department member.

Note:

You, as the application administrator, can set access on the business role pages that you create. You cannot alter the default access settings of seeded business role pages (see Table 7-1, "Seeded Business Role Pages").

You can find controls for setting page access in the Personalize Pages page and on the Business Role Pages subtab of the Pages tab in the WebCenter Administration pages (Figure 7-5).

Figure 7-5 Set Page Access Option on a Business Role Page

This section describes how to set specific access on a business role page as well as how to make such a page public. It includes the following subsections:

- Section 7.1.4.1, "Setting Access on a Business Role Page"

- Section 7.1.4.2, "Providing Public Access to a Business Role Page"

7.1.4.1 Setting Access on a Business Role Page

To specify the target audience for a business role page:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click Business Role Pages to view a list of all business role pages.
Alternatively, use the following URL to go to this page:

http://host:port/webcenter/spaces/admin/brpages

2. Click the Actions icon on the business role page for which you are setting access, and select Set Page Access from the resulting context menu (Figure 7-6).

Figure 7-6 Set Page Access Option on a Business Role Page

The Set Page Access dialog opens (Figure 7-7).

Figure 7-7 Set Page Access Dialog

3. To grant access permissions to all authenticated users, that is, to users who are logged in to WebCenter Spaces, click Add Authenticated Access.
The authenticated-access role is added under Role or User.

4. To grant access permissions to all public users, that is, users who have not logged in (as well as those who have), click Add Public Access.
The role anonymous-role is added under Role or User.

See Also:

This method of enabling public access to a business role page provides a means of granting more than view option to public users. If you want to give such users view access only, you can set this quickly by following the steps in Section 7.1.4.2, "Providing Public Access to a Business Role Page."

5. To grant access permissions to selected users, groups, and application roles, click Add Access.

The Add Access dialog opens (Figure 7-8).

Figure 7-8 Add Access Dialog

6. Identify the users, groups, and application roles for whom to expose this business role page in the Home Space.

Choose from all available users, groups, and application roles. Use the Search feature to search your identity store:

1. In the Search field, enter two or more characters.

Tip:

The search is not case-sensitive.

2. Click the Search icon.
Users, groups, and application roles matching your search criteria appear in the Add User dialog.

3. Select one or multiple names from the list.
Ctrl-Click to select multiple users.

4. Click Select.
The results of your selection appear in the Set Page Access dialog. By default, selected users have the View Page permission.

7. For each user name, group, or application role, select one or more checkboxes to grant page privileges:

- View Page—Users can view the page but cannot perform any actions on the page.

- Edit Page—Users can edit the page. This includes adding, rearranging, and deleting content, and changing the page scheme.

- Delete Page—Users can delete the page.

- Perform All Page Actions—Users have full access rights to the page. These users can edit the page, revise the page layout, set additional access privileges for other users, and all other page privileges.

- Personalize Page—Users can change their personal view of the page. Such changes do not affect any other user's view of the page.

Tip:

To revoke a privilege, deselect the checkbox.

8. Click OK to save your changes.
The page is pushed to its target audience, who sees it in their views of the Home Space the next time they log in to WebCenter Spaces.

7.1.4.2 Providing Public Access to a Business Role Page

You can specific that any user, whether logged in or not, can view a particular business role page. Such a page can be exposed in a public Home Space, or you can publish the URL to the public business role page, to provide all users easy access.

See Also:

The process described in this section enables all public users to view a selected business role page. To provide public users with additional permissions on the page, follow the steps described in Section 7.1.4.1, "Setting Access on a Business Role Page."

To make a business role page public:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click Business Role Pages to view a list of all business role pages.
Alternatively, use the following URL to go to this page:

http://host:port/webcenter/spaces/admin/brpages

2. Click the Actions icon on the business role page for which you are setting access, and select Make Public (Figure 7-9).

Figure 7-9 Make Public Option on Page Actions Menu

7.1.5 Revoking Access to a Business Role Page

To revoke access privileges to a business role page:

1. Follow the steps in Section 7.1.4, "Specifying the Target Audience for a Business Role Page," to open the Set Page Access dialog.

2. Select the user, group, or application role from whom to revoke access, and click the Delete Access button (Figure 7-10).

Figure 7-10 Delete Access Option in Set Page Access Dialog

3. Click Delete in the resulting confirmation dialog.

7.1.6 Adding Business Role Pages to Navigation

Once you make a business role page available to users through page permissions, you will likely also want to make it easy to access by including a link to it in your application navigation. This process is described in detail in Section 11.2.2.1, "Adding Resources to a Navigation Model Using the Edit Dialog." For detailed information about working with application navigation, see Chapter 11, "Working with Navigation."

7.1.7 Setting a Default Display Order for Business Role Pages

If you present business role pages in a logical order, the page content is more accessible and easier for users to navigate. As administrator, you can determine the initial order in which business role pages are presented to their intended audience.

Individual users can change the initial display order you specify by accessing the Personalize Pages page and using the provided icons. Additionally, they can hide the business role pages they do not use.

Note:

There are two ways of defining the order and the visibility of pages in a Space: from the Administration pages (described here) and from the Personalize Pages page. The difference between the two is that the Administration change is an application customization and the Personalize Pages change is a user customization. Keep in mind that user customizations override application customizations in a given user's view.

See Also:

For information about changing the display order of pages using Personalize Pages, see Section 29.3.5, "Rearranging Page Order." For information about hiding pages, see Section 29.3.3, "Hiding Pages."

To change the display order of all business role pages:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to the Spaces Administration page, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Business Role Pages to view all business role pages.

3. Click the arrows in the Reorder column to change the display order (Figure 7-11).

Figure 7-11 Reorder Icons on Business Role Pages

Alternatively, drag and drop pages into the correct position.

7.1.8 Editing a Business Role Page

Anyone granted the Edit Page permission on a business role page can edit that page. For these users, the editing process is the same as for regular pages (for more information, see Section 38.3, "Editing a Personal Page").

Administrators can also initiate an edit of a business role page from WebCenter Administration pages.

To edit a business role page through Spaces Administration:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to the Spaces Administration page, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Business Role Pages to view all business role pages.

3. Click the Actions icon on the page you want to edit, and select Edit Page from the resulting context menu (Figure 7-12).

Figure 7-12 Edit Option on Page Actions Menu

The page opens in edit mode in Oracle Composer.

4. Edit the page, and click Save and then Close when you have finished.

7.1.9 Copying a Business Role Page

When you copy a business role page, you can save it as another business role page or as a personal page in your view of the Home Space. If you make the copy another business role page, you must set access on the new page because access permissions from the original page are not copied (for more information, see Section 7.1.4, "Specifying the Target Audience for a Business Role Page").

To copy a business role page:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to the Spaces Administration page, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Business Role Pages to view all business role pages.

3. Click the Actions icon on the page you want to copy, and select Copy Page from the resulting context menu (Figure 7-13).

Figure 7-13 Copy Page Option on Page Actions Menu

4. In the resulting dialog, enter a name for the new page (Figure 7-14).

Figure 7-14 Copy Page Dialog

5. Next to Copy as, specify whether the copy is a personal or business role page:

- Select Business Role Page if you intend to push the copy out to a group of people with a similar job role.

- Select Personal Page if you intend to expose the copy only in your own application view (that is, as a personal page in your view of the Home Space).

6. Click OK.
The new page opens in edit mode in Oracle Composer.

7. Optionally, edit the page, and click Save and then Close when you have finished.

7.1.10 Deleting a Business Role Page

Anyone granted the Delete Page permission on a business role page can delete it. For these users, the process is the same as deleting regular pages (for more information, see Section 17.6, "Deleting Pages"). Administrators have the additional option of deleting business role pages from the Spaces Administration page.

Note:

No one can delete seeded business role pages (see Table 7-1, "Seeded Business Role Pages").

Once a business role page is removed from WebCenter Spaces, it cannot be recovered. Deleted pages are permanently removed, and users previously assigned that page no longer see it in their views of the Home Space.

To delete a business role page through Spaces Administration:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to Administration pages, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Business Role Pages to view all business role pages.

3. Click the Actions icon on the page you want to delete, and select Delete Page from the resulting context menu (Figure 7-15).

Figure 7-15 Delete Page Option on Page Actions Menu

4. In the confirmation dialog, click Delete.

7.2 Working with Personal Pages

While individuals are primarily responsible for managing content and pages in their own personal space, it is important that administrators also have access. Administrators may be required to clean up or manage personal data when owners experience difficulties with their personal pages or leave the organization.

This section describes how to administer personal pages in WebCenter Spaces. It includes the following sections:

- Section 7.2.1, "What You Should Know About Personal Page Administration"

- Section 7.2.2, "Setting Application-Level Page Creation Defaults for Personal Pages"

- Section 7.2.3, "Changing Access Permissions on a Personal Page"

- Section 7.2.4, "Preventing Users From Creating Personal Pages"

- Section 7.2.5, "Adding Personal Pages to Navigation"

- Section 7.2.6, "Editing Personal Pages with Administrative Privileges"

- Section 7.2.7, "Copying a Personal Page"

- Section 7.2.8, "Deleting a Personal Page Through Space Administration"

7.2.1 What You Should Know About Personal Page Administration

Personal pages are the pages users create in their personal views of the Home Space. Compare this with system pages, which are provided out of the box and can appear in locations other than the Home Space, and business role pages, which are either provided out of the box or created by the application administrator and appear in the Home Space views of only those users assigned the relevant user role.

See Also:

For more information, see Section 7.1.1, "What You Should Know About Business Role Pages," and Section 7.3.1, "What You Should Know About System Pages."

As the application administrator, you have full access to all users' personal pages. Full access means you can edit, copy, rename, set access, delete, and perform other like actions on any user's personal pages.

Application administrators can access everyone's personal pages from one, central place: the Spaces Administration page. Under Spaces Administration, the Pages tab provides access to a listing of personal pages, which provide information about who created the personal page and when it was last modified.

An Actions menu is associated with each page listing, providing access to options for editing, copying, renaming, securing, deleting, and making the personal page public (Figure 7-16).

Figure 7-16 Page Actions Menu on Personal Pages Subpage

Additional options include sending a mail message containing a link to the page and viewing information about the page.

7.2.2 Setting Application-Level Page Creation Defaults for Personal Pages

In addition to the page creation defaults authorized users can set for themselves (see Section 38.1.1, "Setting Page Creation Defaults for Personal Pages"), application administrators can set application-level page creation defaults for personal pages. Once configured, application-level page creation defaults affect the creation of all personal pages.

Note, however, that the page creation defaults that authorized users set for themselves through the Personalize Pages page override the application-level settings described in this chapter.

The controls provided for setting page creation defaults for business role pages also affect the creation of personal pages application-wide.

For more information, see Section 7.1.2, "Setting Page Creation Defaults for Business Role Pages."

7.2.3 Changing Access Permissions on a Personal Page

As the administrator, you are authorized to view and manage security for any page in your portal. This includes personal pages. Page owners normally determine who can see their pages, but, occasionally, when a page owner is not available, the administrator may be required to make changes.

To change access permissions for a personal page as the WebCenter Spaces administrator:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and click Personal Pages to view all personal pages.
You can also use the following URL to access the Personal Pages page:

http://host:port/webcenter/spaces/admin/personalpages

2. Click the Actions icon on the page you want to secure, and select Set Page Access from the resulting context menu (see Figure 7-16).
The Set Page Access dialog opens (Figure 7-17).

Figure 7-17 Set Page Access Dialog

3. To set access for authenticated users, click Add Authenticated Access.
The authenticated-role is added under Role or User. Use this to set access permissions for all users who are logged in to your portal.

4. To set access for public users, click Add Public Access.
The anonymous-role is added under Role or User. Use this to set access permissions for all users who are not logged in to your portal.

5. To grant access to other users and roles, click Add Access to open the Add Access dialog (Figure 7-18).

Figure 7-18 Add Access Dialog

6. Identify the users to enable to access this page.
Choose from all available users, groups, and application roles. Use the Search feature to search your identity store:

1. In the Search field, enter two or more characters and click the Search icon.

Tip:

The search is not case sensitive.

Users, groups, and roles matching your search criteria appear in the Add Access dialog.

2. Select one or more names from the list.
Ctrl-Click to select multiple users.

3. Click Select.
The results of your selection appear in the Set Page Access dialog. By default, users have the View Page permission on the page.

7. To modify the permissions assigned to a current user or role, select or deselect the appropriate permission checkboxes:

- View Page—The selected user or role can access the page for viewing, but cannot perform any actions on the page.

- Edit Page—The selected user or role can edit the page. This includes adding, rearranging, and deleting content.

- Delete Page—The selected user or role can delete the page.

- Perform All Page Actions—The selected user or role has full access rights to the page. The user can edit the page, revise the page layout, set additional access privileges for other users, and all other page permissions.

- Personalize—The selected user or role can personalize the page. Personalizations are changes made to a page in view mode. Such changes do not affect any other user's view of the page.

Tip:

You can revoke privileges by taking the same steps and deselecting one or multiple privileges for a listed user or role.

- To revoke access to the page, select the user or role and click Delete Access.

8. Click OK.

7.2.4 Preventing Users From Creating Personal Pages

You can revoke the application-level permission Create-Pages to prevent users from creating personal pages in the Home Space. The Create-Pages application-level permission applies only to creating personal pages; the creation of pages in a Space is controlled by the given Space's own security settings (for information about Space security settings, that is, Space-level users and roles, see Section 51.5, "Managing Space Roles," and Section 51.6, "Managing Space Members").

The process of revoking an application-level permission is described in Section 21.2.3, "Modifying Application Role Permissions."

7.2.5 Adding Personal Pages to Navigation

If you want to add a link to a personal page in your application navigation, this process is described in detail in Section 11.2.2.1, "Adding Resources to a Navigation Model Using the Edit Dialog." For detailed information about working with application navigation, see Chapter 11, "Working with Navigation."

7.2.6 Editing Personal Pages with Administrative Privileges

As the administrator, you are authorized to view and modify any page in a personal space, including other people's personal pages. Individuals are primarily responsible for editing content and pages in their own personal spaces, but, occasionally, administrators may be required to clean up or edit personal data.

To edit a personal page as the WebCenter Spaces administrator:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to Administration pages, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Personal Pages to view all personal pages.

3. Click the Actions icon on the page you want to edit, and select Edit Page from the resulting context menu (see Figure 7-16).
The page opens in Oracle Composer.

See Also:

To find out more about editing a page through Oracle Composer, see Section 17.3, "Editing Pages."

4. Update the page, and click Save and then Close when you have finished.

7.2.7 Copying a Personal Page

As the administrator, you are authorized to copy any page in WebCenter Spaces. This includes other users' personal pages. When you copy a personal page as an administrator, you can save it as a business role page to be pushed to other users or as a personal page in your own personal space.

Tip:

If you create another business role page, you must set access on the new page because access permissions from the original page are not copied. For more information, see Section 7.1.4, "Specifying the Target Audience for a Business Role Page."

To copy a personal page as an administrator:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to Administration pages, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Personal Pages to view all personal pages.

3. Click the Actions icon on the page you want to copy, and select Copy Page from the resulting context menu (Figure 7-19).

Figure 7-19 Copy Page Option on Page Actions Menu

The Copy Page dialog opens (Figure 7-20).

Figure 7-20 Copy Page Dialog

4. Enter a name for the new page.

5. Next to Copy as, specify whether the copy is one of your personal pages or a business role page:

- Select Business Role Page if you intend to push the page out to a group of people with a similar job role.

- Select Personal Page if you intend to expose the copy only in your own application view.

6. Click OK.
The new page opens in edit mode in Oracle Composer.

7. Optionally, update the page, and click Save and then Close to exit Oracle Composer.

7.2.8 Deleting a Personal Page Through Space Administration

In addition to having full access to users' personal pages, an administrator can delete them. Once a personal page is removed, it cannot be recovered. Deleted pages are removed permanently.

To delete a personal page through Spaces Administration:

1. Navigate to the Spaces Administration page, and click the Pages tab to bring it forward.

See Also:

For information about navigating to Administration pages, see Section 4.1, "Accessing the WebCenter Administration Page."

2. Click Personal Pages to view all personal pages.

3. Click the Actions icon on the page you want to delete, and select Delete Page from the resulting context menu (Figure 7-21).

Figure 7-21 Delete Page Option on Page Actions Menu

4. In the confirmation dialog, click Delete.

7.3 Working with System Pages

System pages are provided out-of-the-box and are designed to fulfill a specific purpose. For example, in a default installation, public users who visit WebCenter Spaces see the public WebCenter Welcome Page. The Welcome page appears because it allows access to the role anonymous-role that is provided to accommodate users who are not logged in, also known as public users.

System pages include a variety of utility pages that you can customize to reflect your company brand, to provide useful hints, or to display some other enhancement that you determine.

This section provides information about working with system pages. It includes the following subsections:

- Section 7.3.1, "What You Should Know About System Pages"

- Section 7.3.2, "Customizing System Pages"

- Section 7.3.3, "Removing All Page Customizations from a System Page"

7.3.1 What You Should Know About System Pages

System pages are provided to support a rapid deployment of your portal. They fulfill a range of needs, from a finished introductory page (the Welcome page) to pages that provide content that is generated on the spot and tailored to the individual user (the Activity Stream page).

System pages are preconfigured with page access settings that target their anticipated audience. For example, the Welcome page is configured to target the anonymous-role, the Activity Stream page is targeted to individual users, with dynamic content that is tailored to each user. In view of this preconfiguration, you cannot alter the security settings of a system page.

You can, however, customize system pages. Customization enables you to enhance the seeded content of a system page to apply your company brand, add hint text, provide additional functionality (such as task flows and portlets), and the like.

System pages also make task flow customization possible. The system page Task Flow Edit provides an environment for customizing all instances of a seeded task flow in a given scope in one operation. (Custom task flows created through the Resource Manager are not supported.) Authorized users can add seeded task flows to this page and then customize all instances of the task flow. For more information, see Chapter 8, "Customizing Task Flows."

Table 7-2 lists and describes the system pages that are delivered out-of-the-box and provides information about the context in which they appear.

Table 7-2 Seeded System Pages

Page

Description

Context

Activity Stream

Displays the Activity Stream task flow from the People Connections service. For more information, see Chapter 32, "Tracking Your Connections' Activities."

Appears by default in the Home Space of every authenticated (logged-in) user.

Announcements

Displays the Announcement Manager task flow. For more information, see Chapter 59, "Working with the Announcements Service."

Appears by default in many out-of-the-box Space templates.

Discussions

Displays the Discussion Forum Manager task flow. For more information, see Section 60.1, "What You Should Know About the Discussions Service."

Appears by default in many out-of-the-box Space templates.

Documents

Displays the Document Explorer task flow. For more information, see Section 41.1.1, "Understanding the Document Explorer Task Flow."

Appears by default in many out-of-the-box Space templates.

Error Encountered

Displays an error page when an error occurs

Appears when an application error occurs

Events

Displays the Events task flow. For more information, see Section 61.1, "What You Should Know About the Events Service."

Appears by default in many out-of-the-box Space templates.

Lists

Displays the List Manager task flow. For more information, see Section 64.1, "What You Should Know About the Lists Service."

Appears by default in many out-of-the-box Space templates.

Login

Provides fields for logging in to your portal.

Appears in lieu of the WebCenter Welcome Page when you disable public access to all application pages and when your current session expires.

My Profile

Displays the current user's Profile Gallery, which includes subpages for Activity Stream, Connections, Documents, an organization chart (Organization), and the user's profile details (About). For more information, see Chapter 30, "Managing Your Profile," and Section 41.1, "What You Should Know About the Documents Service Task Flows."

Appears by default in the Home Space of every authenticated (logged-in) user.

No Pages Accessible

Displays a message telling the user that no pages are accessible.

Appears when a user navigates to a Space in which he has no access permissions on the Space's pages.

Outlook Add-in Discussions

Displays content from the Discussions service in the context of an Outlook window

Appears when you access content from the Discussions service through Microsoft Outlook

Outlook Add-in Documents

Displays content from the Documents service in the context of an Outlook window

Appears when you access content from the Documents service through Microsoft Outlook

Outlook Add-in Events

Displays content from the Events service in the context of an Outlook window

Appears when you access content from the Events service through Microsoft Outlook

Outlook Add-in Members

Displays content about Space members in the context of an Outlook window

Appears when you access content about the members of a given Space through Microsoft Outlook

Outlook Add-in Space Home

Displays content from a Space home page when you view it in the context of an Outlook window

Appears when you access content from a Space home page through Microsoft Outlook

Page Not Found

Displays a message telling the user that the page to which to navigate cannot be found

Appears when users navigate to a page that is no longer available in WebCenter Spaces

Page Viewer

Displays an external web site (such as google.com) in a Space, surrounded by the page template.

Used when you create a Navigation model that contains an External URL item (with target Same Page). When users click on such links in the navigation, the Page Viewer is used.

Resource Viewer

Displays a resource in a Space, surrounded by the page template.

Used when you create a Navigation model that contains a resource item (with target Same Page). When users click on such links in the navigation, the Resource Viewer is used.

Search

Displays the Search Results page. For more information, see Chapter 56, "Working with the Search Service."

Renders dynamically to display the results of a search.

Self Registration

Provides a means of enabling users to create their own login accounts to your portal. For more information, see Section 29.2, "Registering Yourself with WebCenter Spaces."

Opens in response to clicking the Register button on the Login or WebCenter Welcome Page.

Space Not Found

Displays a message telling the user that the Space to which to navigate cannot be found

Appears when users navigate to a Space that is no longer available in WebCenter Spaces

Subscribe

Provides a means of subscribing to a Space that is configured to allow membership by subscription. For more information, see Section 49.6, "Joining a Space."

Appears when a non-member navigates to a Space that is configured to allow membership by subscription.

Tag Center

Displays the Tag Center task flow. For more information, see Chapter 57, "Working with the Tags Service."

Appears when a user navigates to the Tag Center by one of several methods. For more information, see Section 57.2.6, "Working with Tags and Tagged Items in the Tag Center."

Task Flow Editor

Provides an environment for customizing all instances of a seeded task flow in a given scope in one operation. (Custom task flows created through the Resource Manager are not supported.)

Authorized users can add seeded task flows to this page and then customize all instances of the task flow. For more information, see Chapter 8, "Customizing Task Flows."

Task Flow Viewer

Displays a task flow in a Space, surrounded by the page template.

Used when you create a Navigation model that contains a task flow item (with target Same Page). When users click on such links in the navigation, the Task Flow Viewer is used.

Unauthorized

Displays a message telling users that they are not authorized to access a Space or a page.

Appears when a user navigates to a Space or a page on which he does not have access permission.

Unavailable

Displays a message telling users that the Space is not available.

Appears when a user navigates to a Space that is offline.

User Profile

Displays the Profile Gallery of a user other than the current user, which, by default, displays the same subpages and task flows as the current user's Profile Gallery. It differs in that it displays information associated with the other user.

Renders dynamically when the current user accesses another user's profile.

WebCenter Welcome Page

Displays login fields, a self-registration button, boilerplate information with links to help topics about specific features, a link to public Spaces, and a language changer for the selection of an alternate session language.

This is the public welcome page. It is the first page users see when they access WebCenter Spaces.

If you decide to disable public access to all application pages, the public welcome page is not shown and users are directed to the Login page.

Caution:

Avoid adding a Connections - Network task flow to a system page. Adding the Connections - Network task flow to a system page causes an error that prevents you from editing any other task flow on the page. You can work around this issue by clicking the Restore Default link on the system page to undo all changes made to the page, including removing the Connections - Network task flow.
For information about the Restore Default link, see Section 7.3.3, "Removing All Page Customizations from a System Page."

7.3.2 Customizing System Pages

Users granted the permissions Application: Manage All and Pages: Create, Edit, and Delete Pages can customize certain aspects of system pages through Oracle Composer.

Note:

For convenience, we will call such users Administrators.

This section describes how to customize system pages at the application or Space level. It includes the following subsections:

- Section 7.3.2.1, "What You Should Know About System Page Customization"

- Section 7.3.2.2, "Customizing an Application-Level System Page"

- Section 7.3.2.3, "Customizing a Space-Level System Page"

7.3.2.1 What You Should Know About System Page Customization

You can customize out-of-the-box system pages to bring them in line with your organization's brand or look and feel. As a WebCenter Spaces Administrator, you can remove existing components, add new components, and change the page layout. For example, you can customize the My Profile and User Profile system pages to show content other than its defined default content.

You cannot, however, edit or delete input fields and buttons.

System pages enable application- and Space-wide task flow customization, where you can change the appearance and behavior of all instances of a task flow in the current scope through Source view in Oracle Composer. For more information, see Chapter 8, "Customizing Task Flows."

7.3.2.2 Customizing an Application-Level System Page

The process of customizing a system page is the same for each page. This section generally describes the steps you take to customize any system page that is editable in WebCenter Spaces.

To customize a system page:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click System Pages to view all system pages.
You can use the following URL to get to this location:

http://host:port/webcenter/spaces/admin/systempages

2. Click the Customize link next to the system page to open it in Oracle Composer (Figure 7-22).

Figure 7-22 Customize Link Next to a System Page

3. Revise the page.

See Also:

For information about editing pages, see Section 17.3, "Editing Pages."
For information about the types of components you can add to a page, see the following chapters:

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 13, "Adding Spaces Components to Your Templates"

- Part VIII, "Creating and Managing Portlets and Task Flows at Runtime"

- Part X, "Working with Content"

- Part XIII, "Searching WebCenter and Other Sources"

- Part XIV, "Gathering Intelligence Based on Activities"

- Part XV, "Services: Announcements through Links"

- Part XVI, "Services: Lists through Worklist"

4. Click Save and then Close to exit Oracle Composer.

7.3.2.3 Customizing a Space-Level System Page

You can customize system pages such that the customizations render only within a selected Space. To do so, simply customize the system page as described in Section 7.3.2.2, "Customizing an Application-Level System Page,", but do so through the Space's Settings page.

To customize a Space-level systems page:

1. Navigate to the System Pages subpage under Space Settings.
You can use the following URL to get to this location:

http://host:port/webcenter/spaces/spaceName/admin/systempages

2. Click the Customize link next to the system page to open it in Oracle Composer (Figure 7-23).

Figure 7-23 Customize Link Next to a System Page

3. Revise the page.

See Also:

For information about editing pages, see Section 17.3, "Editing Pages."
For information about the types of components you can add to a page, see the following chapters:

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 13, "Adding Spaces Components to Your Templates"

- Part VIII, "Creating and Managing Portlets and Task Flows at Runtime"

- Part X, "Working with Content"

- Part XIII, "Searching WebCenter and Other Sources"

- Part XIV, "Gathering Intelligence Based on Activities"

- Part XV, "Services: Announcements through Links"

- Part XVI, "Services: Lists through Worklist"

4. Click Save and then Close to exit Oracle Composer.

7.3.3 Removing All Page Customizations from a System Page

You can return a system page to its default, out-of-the-box state, removing all page customizations.

Note:

This process does not also remove task flow customizations. To remove task flow customizations, you must revise the given task flow on a system page. For more information, see Chapter 8, "Customizing Task Flows."

To remove all customizations from a system page:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click System Pages to view all system pages.
You can also use the following URL to get to this location:

http://host:port/webcenter/spaces/admin/systempages

2. Click the Restore Default link next to the system page (Figure 7-24).

Figure 7-24 Restore Default Link Next to a System Page

3. In the resulting confirmation dialog, click the Restore button.
All customizations are permanently removed from the selected system page.

8 Customizing Task Flows

Through system pages, you can customize a task flow so that all instances of the task flow are affected. You can change all task flow instances in the application or limit your customizations to only those instances in a given Space.

This chapter provides details about task flow customization and steps you through the process of customizing task flows application-wide and Space-wide. It includes the following sections:

- Section 8.1, "What You Should Know About Task Flow Customization"

- Section 8.2, "Customizing Task Flows at the Application Level"

- Section 8.3, "Customizing Task Flows at the Space Level"

- Section 8.4, "Customizing Seeded Task Flows Using the Task Flow Editor Page"

- Section 8.5, "Removing Task Flow Customizations"

See Also:

For information about system pages, see Section 7.3, "Working with System Pages." Task flow customization is also possible at design time through Oracle JDeveloper. The process differs significantly from the runtime procedure we discuss in this chapter. For more information, see the chapter, "Customizing Task Flows," in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

8.1 What You Should Know About Task Flow Customization

Task flow customization provides a means of configuring a particular task flow in a way that all instances of that task flow within the current scope are affected.

The task flow customization feature is available exclusively on system pages. System pages are available at both the application and Space levels:

- To change all instances of a given task flow across all Spaces (including the Home Space), customize the task flow on an application-level system page.

- To change only those instances exposed in a given Space, customize the task flow on a Space-level system page.

Note:

When you customize a task flow element at the application level, and another user customizes the same task flow element at the Space level, the Space-level customization take precedence in that Space.

The Task Flow Editor system page is provided to enable customization of any seeded task flow (custom task flows that are created through the Resource Manager cannot be customized in this way). Customize the Task Flow Editor page and add any seeded task flow to it. Edit the task flow by selecting any of its elements on the page and then editing its properties. The changes you make here affect all instances of the task flow at the application level, when you customize the application-level system page, or within the scope of the current Space, when you customize a Space-level system page. For more information, see Section 8.4, "Customizing Seeded Task Flows Using the Task Flow Editor Page."

System pages at both the application and Space level have a Restore Default feature that enables authorized users to remove all page customizations and restore a system page to its out-of-the-box state. It is important to note that Restore Default does not also restore customized task flows that are included on the system page to their default states. A separate control, Reset Task Flow, is available to remove task flow customizations.

Note:

Customizations made to task flows created at runtime—that is, created through the Resource Manager—are base document edits rather than layered customizations. Consequently, they cannot be reset. When you edit a task flow created at runtime in Oracle Composer, edits are saved, even if you do not explicitly click Save.

See Also:

For information about removing task flow customizations, see Section 8.5, "Removing Task Flow Customizations."
For information about the Restore Default feature for system pages, see Section 7.3.3, "Removing All Page Customizations from a System Page."

Make task flow customizations in page edit mode through Source view. In Source view, an Edit Task Flow link is provided next to the region that represents the task flow. You can click this link to start the customization process (Figure 8-1).

Figure 8-1 Edit Task Flow Link Next to a Region Tag

Once in, you can select different task flow elements directly on the page and edit their properties through the Component Properties dialog. All changes made in this way affect all instances of the task flow either application-wide or within the scope of a Space, depending on where you initiated the customization. Changes to one element affect all like elements. For example, if you select a folder in the Document Explorer task flow, and change its icon, all folder icons in all Document Explorer task flows within the current scope are affected.

8.2 Customizing Task Flows at the Application Level

This section describes how to perform task flow customizations at the application level.

Note:

When you customize a task flow element at the application level, and another user customizes the same task flow element at the Space level, the Space-level customization take precedence in that Space.

To perform application-wide task flow customizations through a system page:

1. Navigate to the Spaces Administration page, click the Pages tab to bring it forward, and then click System Pages to view all system pages.
You can use the following URL to get to this location:

http://host:port/webcenter/spaces/admin/systempages

2. Click the Customize link next to the system page to open it in page edit mode (Figure 8-2).

Figure 8-2 Customize Link Next to a System Page

3. From the View menu, select Source to view the page source (Figure 8-3).

Figure 8-3 Source Option on View Menu

4. Click the Edit Task Flow link next to the task flow you want to customize (Figure 8-4).

Figure 8-4 Edit Task Flow Link Next to a Region Tag

5. In the resulting Confirm Task Flow Edit dialog, click Edit.
Source view zooms into the source code hierarchy of the task flow being edited (Figure 8-5)

Figure 8-5 Zoomed-In View of Task Flow

Tip:

Use the Show Hierarchy icon (arrow) in Source view to navigate back up the source hierarchy.

6. Select an element of the task flow by clicking it on the page (Figure 8-6).

Figure 8-6 Selected Task Flow Element on a Page in Source View

7. Click the Show the properties of selected_element icon to open the Component Properties dialog (Figure 8-7).

Figure 8-7 Show the Properties of Everyone Icon

8. Make your changes to the element's properties.

Note:

Remember that changes to one element affect all like elements in the task flow within the current scope. For example, a change to the font used on a folder name affects all folder names within the scope and not just the selected instance.

9. Click Apply to view the effect of your changes; click OK to save your changes and exit the dialog.
Every instance of the customized task flow within the current scope renders your customizations.

8.3 Customizing Task Flows at the Space Level

This section describes how to perform task flow customizations at the Space level.

Note:

When you customize a task flow element at the application level, and another user customizes the same task flow element at the Space level, the Space-level customization take precedence in that Space.

To perform Space-wide task flow customizations through a system page:

1. Navigate to the System Pages subpage under Space Settings.
You can use the following URL to get to this location:

http://host:port/webcenter/spaces/spaceName/admin/systempages

2. Click the Customize link next to the system page to open it in page edit mode (Figure 8-8).

Figure 8-8 Customize Link on a Space System Page

3. From the View menu, select Source to view the page source (Figure 8-9).

Figure 8-9 Source Option on View Menu

4. Click the Edit Task Flow link next to the task flow you want to customize (Figure 8-10).

Figure 8-10 Edit Task Flow Link In Source View

5. In the resulting Confirm Task Flow Edit dialog, click Edit.
Source view zooms into the source code hierarchy of the task flow being edited (Figure 8-11)

Figure 8-11 Zoomed-In View of Task Flow in Edit Mode

Tip:

Use the Show Hierarchy icon (arrow) in Source view to navigate back up the source hierarchy.

6. Select an element of the task flow by clicking it on the page.

7. Click the Show the properties of selected_element icon to open the Component Properties dialog (Figure 8-12).

Figure 8-12 Show the Properties of Calendar Icon

8. Make your changes to the element's properties.

Note:

Remember that changes to one element affect all like elements in the task flow within the current scope. For example, a change to the font used on a button affects all like buttons within the scope and not just the selected instance.

9. Click Apply to view the effect of your changes; click OK to save your changes and exit the dialog.
Every instance of the customized task flow within the current scope renders your customizations.

8.4 Customizing Seeded Task Flows Using the Task Flow Editor Page

The Task Flow Editor system page is available at both the application and Space level to enable you to edit all instances of any seeded task flow within a given scope in one operation.

Note:

Custom task flows created through the Resource Manager cannot be edited in this way.
When you customize a task flow element at the application level, and another user customizes the same task flow element at the Space level, the Space-level customization take precedence in that Space.

To customize any seeded task flow:

1. Navigate to the System Pages subpage at the application or Space level.
To navigate to the application Systems Pages subpage, use the following URL:

http://host:port/webcenter/spaces/admin/systempages

To navigate to a Space Systems Pages subpage, use the following URL:

http://host:port/webcenter/spaces/spaceName/admin/systempages

2. Click the Customize link next to the Task Flow Editor system page to open it in page edit mode (Figure 8-13).

Figure 8-13 Customize Link Next to a System Page

3. In Design view, click the Add Content button to open the Resource Catalog (Figure 8-14).

Figure 8-14 Add Content Button and Resource Catalog

4. In the Resource Catalog, select a task flow to add to the page.

5. Click the Add link next to the task flow to add it to the page, and then click Close to exit the Catalog.

6. From the View menu, select Source to view the page source (Figure 8-15).

Figure 8-15 Source Option on View Menu

7. Click the Edit Task Flow link next to the task flow you want to customize (Figure 8-16).

Figure 8-16 Edit Task Flow Link

8. In the resulting Confirm Task Flow Edit dialog, click Edit.
Source view zooms into the source code hierarchy of the task flow being edited (Figure 8-17)

Figure 8-17 Zoomed-In View of Task Flow in Source View

Tip:

Use the Show Hierarchy icon (arrow) in Source view to navigate back up the source hierarchy.

9. Select an element of the task flow by clicking it on the page (Figure 8-18).

Figure 8-18 Selected Task Flow Element in Source View

10. Click the Show the properties of selected_element icon to open the Component Properties dialog (Figure 8-19).

Figure 8-19 Show the Properties of Find Connection Icon

11. Make your changes to the element's properties.

Note:

Remember that changes to one element affect all like elements in the task flow within the current scope. For example, a change to the font used on a button affects all like buttons within the scope and not just the selected instance.

12. Click Apply to view the effect of your changes; click OK to save your changes and exit the dialog.
Every instance of the customized task flow within the current scope renders your customizations.

8.5 Removing Task Flow Customizations

To remove task flow customizations made at the application or Space level:

1. Navigate to the System Pages subpage at the application or Space level.
To navigate to the application Systems Pages subpage, use the following URL:

http://host:port/webcenter/spaces/admin/systempages

To navigate to a Space Systems Pages subpage, use the following URL:

http://host:port/webcenter/spaces/spaceName/admin/systempages

2. Click the Customize link next to the system page on which you have customized a task flow to open it in page edit mode (Figure 8-20).

Figure 8-20 Customize Link Next to a System Page

3. In Source view, select the customized task flow, and click Reset Task Flow (Figure 8-21).

Figure 8-21 A Selected Task Flow and the Reset Task Flow Button

4. Click Reset Task Flow in the confirmation dialog.

Part III

Personalizing Your Portal

Part III of the User's Guide introduces techniques for personalizing your users' experience of your portal. It describes a way to vary the presentation of page content and templates in accordance with the current user.

Part III includes the following chapter:

- Chapter 9, "Using WebCenter Personalization"

9 Using WebCenter Personalization

WebCenter Personalization provides a dynamically derived user experience that can be applied to any WebCenter Spaces object that can be used in conjunction with Expression Language (EL) expressions. This chapter provides an overview of how the WebCenter Personalization engine can be used to determine which WebCenter Spaces objects are presented to the user and how these objects are presented based on the outcome of a Personalization scenario.

This chapter includes the following sections:

- Section 9.1, "Introduction to WebCenter Personalization"

- Section 9.2, "Driving Content Using WebCenter Personalization"

- Section 9.3, "Driving Portal Look and Feel Using WebCenter Personalization"

9.1 Introduction to WebCenter Personalization

WebCenter Personalization provides a mechanism with which to vary the user experience based on dynamically evaluated criteria defined in a Personalization scenario. The scenario evaluates defined sources of input data, and generates a decision. The results of that decision or outcome can be applied in WebCenter Spaces using Expression Language (EL) expressions.

To use WebCenter Personalization in WebCenter Spaces, you first need to create a scenario in a WebCenter Portal application. You then use ELs to execute and return the results of the scenario, and modify the user experience accordingly in Spaces. For information about how to create Personalization scenarios, see "Personalizing WebCenter Applications" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter. The WebCenter Personalization ELs used to run a scenario are cataloged in Section B.3.11, "EL Expressions Relevant to the Personalization Conductor."

Once you've set up your scenario, you can use ELs in WebCenter Spaces to present targeted content or shape the way content is presented based on information about the user. For example, you can use a Personalization scenario to determine a user's role within an enterprise, and based on that selectively show content for that role. You can also tailor the presentation (such as page templates, page styles, skins, resource catalogs, and so on) for the user.

9.2 Driving Content Using WebCenter Personalization

WebCenter Personalization can deliver targeted content based on both user and application context. WebCenter Personalization, for example, can return content or change application flow based on information about a user in a Human Resources database, targeting the Spaces experience for that specific user.

You can define the content sources, or data providers, that are used to evaluate or provide data for a scenario. The default data provider for WebCenter Personalization is the Oracle Content Server, but a data provider for Activity Graph and a locator for PeopleConnections is also available out of the box. You can also define your own data providers for other data sources. For more information about data providers, see "WebCenter Personalization Providers" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

You can create a simple example of using WebCenter Personalization to drive content based on information about the user by creating a scenario that returns “true” if the employee hire date is within the last two months (see "Authoring Personalized Scenarios in JDeveloper" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter to learn how to create a Personalization scenario). After creating the scenario:

1. Log in as an administrator in WebCenter Spaces.

2. Create a page for new hires, naming it New Hire.

3. Edit the navigation model for the site, and add a new navigation link to the New Hire page. .

4. Select New Hire and click the Edit (Pencil) icon.

Figure 9-1 Navigation Model

5. For the Visible attribute, open the Expression Editor, select Type a value or expression and enter:

#{p13nContext.conductor.default.namespaces['p13nApp'].scenario['NewHire'].results}

Where p13nApp is the name of the WebCenter Portal application containing the scenario, and NewHire is the name of the scenario. This will execute the scenario and return the results (True or False in this case). If the user is a new hire (True) based on the results of the scenario, then the menu item will display when the user logs in.

Figure 9-2 Expression Editor

9.3 Driving Portal Look and Feel Using WebCenter Personalization

As well as targeting content to the user, you can also use WebCenter Personalization and Personalization ELs to select the page templates, page styles, skins, and navigation flow within which that content is presented.

Part IV

Building a Portal or Community

Part IV of the User's Guide introduces the resources you use to create your portal or community.

Part IV includes the following chapters:

- Chapter 10, "Working with the Resources that Compose a Portal or Community"

- Chapter 11, "Working with Navigation"

- Chapter 12, "Working with Page Templates"

- Chapter 13, "Adding Spaces Components to Your Templates"

- Chapter 14, "Working with Skins"

- Chapter 15, "Working with Page Styles"

- Chapter 16, "Working with Resource Catalogs"

10 Working with the Resources that Compose a Portal or Community

Out-of-the-box, WebCenter Spaces provides a range of built-in resources that you can use to define and enrich your application and Spaces. If these resources do not meet your specific requirements, you can create your own custom resources.

This chapter provides an introduction to WebCenter Spaces resources and describes how you can create and manage them. It includes the following sections:

- Section 10.1, "What You Should Know About Resources"

- Section 10.2, "Creating Resources"

- Section 10.3, "Editing Resources"

- Section 10.4, "Managing Resources"

- Section 10.5, "Using JDeveloper to Build WebCenter Spaces Resources"

Note:

For detailed information about a particular resource, refer to the resource-specific chapter listed in Table 10-1.

10.1 What You Should Know About Resources

Though WebCenter Spaces comes with an out-of-the-box application framework, it is a constantly evolving application. Users with appropriate privileges can continue to customize it by creating and applying various types of resources that define the structure, look and feel, and the content of the entire Spaces application or a particular Space. Users can customize WebCenter Spaces without redeploying resources or restarting the application.

This section provides an overview of the various resources and the permissions required to work with them, and describes how you can access resources. It includes the following subsections:

- Section 10.1.1, "Introducing Resources"

- Section 10.1.2, "Understanding Application-Level and Space-Level Resources"

- Section 10.1.3, "Permissions Required to Work with Resources"

- Section 10.1.4, "Accessing Resources"

- Section 10.1.5, "Viewing Information About a Resource"

10.1.1 Introducing Resources

WebCenter Spaces categorizes resources under the following categories: Structure, Look and Layout, and Mashups. Figure 10-4 shows the various types of resources available under each of these categories.

Figure 10-1 Resources Available in WebCenter Spaces

Table 10-1 describes the various types of resources, and provides links to the chapters where you can find more information about each resource.

Table 10-1 Resources Available in WebCenter Spaces

Resource

Description

Documentation

Structure

Resources under this category help you define templates, navigation, and catalogs

Page Templates

Define how individual pages and groups of pages display on a user's screen.

See Chapter 12, "Working with Page Templates"

Navigations

Define how to link together information from multiple sources, such as Spaces, pages, content repositories, and even external web pages.

See Chapter 11, "Working with Navigation"

Resource Catalogs

Define the components and connections that users can add to their pages, page templates, and task flows.

See Chapter 16, "Working with Resource Catalogs"

Look and Layout

Resources under this category help you define the appearance and layout

Skins

Define the appearance and look and feel, including colors and fonts, of a specific Space or the entire application.

See Chapter 14, "Working with Skins"

Page Styles

Define the layout of a newly created page, and may also dictate the type of content the page supports.

See Chapter 15, "Working with Page Styles"

Content Presenter

Manage Content Presenter templates for presenting content.

See Chapter 40, "Publishing Content Using Content Presenter"

Mashup Styles

Manage the templates available for creating task flows.

See Section 26.3.4, "Managing Mashup Styles"

Mashups

Resources under this category help you define task flows and data controls

Data Controls

Create and manage data controls, which connect to and read data from external repositories, particularly for use in business mashups. WebCenter Spaces does not provide any built-in data controls.

See Section 26.2, "Creating and Managing Data Controls"

Task Flows

Create and manage task flows based on a selected mashup style. WebCenter Spaces does not provide any built-in task flows.

See Section 26.3, "Creating and Managing Task Flows"

10.1.2 Understanding Application-Level and Space-Level Resources

Out-of-the-box, WebCenter Spaces provides various built-in resources at the application level and the Space level (Home Spaces or any other Spaces). You cannot modify or download built-in resources.

To meet your business requirements, you can create custom resources at the application level or at the Space level. At both these levels, the resources available and their functionality are the same. The difference between application- and Space-level resources is that of scope:

- Application-level resources are available for use to all Spaces, unless a Space has been specifically excluded.

- Space-level resources are available for use only in the Space in which they are created.

By default, application-level resource settings, such as the page template, skin, resource catalog, and navigation model, are applied to all Spaces. However, in a Space, you can choose to use the default application-level resource settings or specify your own resource settings. If your Space uses application-level settings, any changes to an application-level setting are reflected in your Space too. For example, consider that your application uses the Fusion FX skin, and there are two Spaces in your application, SpaceA and SpaceB. By default, both your Spaces will use the Fusion FX skin. Consider that you configure the application to use the skin named Dew, and SpaceB to use the Mist skin. Now, SpaceA, which is still using an application-level setting for its skin, is automatically updated to use the Dew skin; however SpaceB continues to use Mist.

When you create and publish a custom, application-level resource, it automatically becomes available to all Spaces. However, an application-level resource can be edited only at the application level.

10.1.3 Permissions Required to Work with Resources

To create and manage resources, you require appropriate application-level and Space-level permissions.

To create and manage application-level resources, you must be a WebCenter Spaces administrator. Or, you must have either of the following permissions:

- Application-Manage All (Figure 10-2)

- Application-Manage Configuration and the permission to create, edit, and delete the required resource. For example, the Create, Edit, and Delete Page Styles permission for page styles (Figure 10-3).

Figure 10-2 Manage All Permission for Application

Figure 10-3 Permissions Required to Manage Resources at the Application Level

To create and manage a resource for a particular Space, you must be granted the following permissions:

- Standard Permission Model: You must be granted the Resources-Create, Edit, and Delete Resources (Figure 10-4) and either Manage All or Manage Configuration for Space Administration (Figure 10-5).

Figure 10-4 Role with the Create, Edit, and Delete Resources Permission for a Space

- Advanced Permission Model: You must be granted the permission to create, edit, and delete the desired resource. For example, you require the Create, Edit, and Delete Content Presenter permission to create and manage content presenter templates. You must also be granted either Manage All or Manage Configuration for Space Administration (Figure 10-5).

Figure 10-5 Permissions Required for Creating Content Presenter Templates in a Space

10.1.4 Accessing Resources

You use the Resources page to manage resources. This section describes how to access resources in your application and in a specific Space. It includes the following subsections:

- Section 10.1.4.1, "Accessing Application-Level Resources"

- Section 10.1.4.2, "Accessing Space-Level Resources"

10.1.4.1 Accessing Application-Level Resources

To access the application-level Resources page:

1. Log on to WebCenter Spaces with administrative privileges.

2. After you log on as the application administrator, you can access the Resources page in either of the following ways:

- Use the following URL:

http://host:port/webcenter/spaces/admin/resources

Where, host and port refer to the host name and the port number of the server where WebCenter Spaces is deployed.

See Also:

For more information about WebCenter Spaces user interface URLs, see Appendix A, "WebCenter Spaces User Interface URLs."

- Click the Administration link (Figure 10-6). If you use this option, proceed to step 3.

Figure 10-6 Administration Link

3. In WebCenter Spaces Administration, click the Resources tab.
The application-level Resources page opens, as shown in Figure 10-7.

Figure 10-7 Application-Level Resources Page

10.1.4.2 Accessing Space-Level Resources

To access the Resources page of a Space:

1. Log on to WebCenter Spaces with Space moderator privileges.

2. You can access the Resources page in either of the following ways:

- Use the following URL:

http://host:port/webcenter/spaces/spaceName/admin/resources

Where, host:port refer to the host name and the port number of the server where WebCenter Spaces is deployed.

See Also:

For more information about WebCenter Spaces user interface URLs, see Appendix A, "WebCenter Spaces User Interface URLs."

- Use the Spaces navigation. For details, proceed to step 3.

3. In your Home Space, click Spaces.

Tip:

The way you access this page depends on the page template in use. For example, in a top navigation template, you may access it through a Spaces menu (Figure 10-8).
See also Section 29.3.1, "Opening Spaces."

Figure 10-8 Accessing a Space

4. On the Spaces page, select the required Space.

5. Display the Space administration page.

Tip:

The way you access the Space administration pages depends on the page template in use. For example, in a top navigation template, you may access Space administration pages through a Manage menu (Figure 10-9).
You can also navigate to these pages using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

Figure 10-9 Manage Menu in a Top Navigation Template

6. Click the Resources tab.
The Resources page for the selected Space displays, as shown in Figure 10-10.

Figure 10-10 Resources Page of a Space

10.1.5 Viewing Information About a Resource

Each resource has an associated About dialog that summarizes useful information about it. For information about the properties displayed in the About dialog, see Section 10.4.2.1, "What You Should Know About a Resource's Properties."

You cannot edit the properties displayed in the About dialog of a resource.

To access the About dialog of a resource:

1. Navigate to the Resources page of the application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the navigation panel on the left, select the resource type.

3. From the list of resources displayed on the right, select the resource whose details you want to view.

4. On the menu bar, click About.
The About dialog displays, showing the properties related to the selected resource (Figure 10-11).

Figure 10-11 About Dialog of a Resource

10.2 Creating Resources

This section includes the following subsections:

- Section 10.2.1, "What You Should Know About Resource Creation"

- Section 10.2.2, "Creating a Resource"

10.2.1 What You Should Know About Resource Creation

In WebCenter Spaces, you can create certain resources from scratch, and there are certain resources that you can create only by making a copy of an existing resource. For example, you can create a task flow from scratch, but you can create a skin only by making a copy of an existing skin. Further, there are certain resources, such as Content Presenter templates, that WebCenter Spaces restricts you from creating.

Table 10-1 describes the support available for creating various resources in WebCenter Spaces.

Table 10-2 Support for Creating Resources in WebCenter Spaces

Resource

Can You Create the Resource in WebCenter Spaces?

How can the Resource be Created?

Page Templates

Yes

Only by extending another page template

Navigations

Yes

From scratch or by extending another navigation resource

Resource Catalogs

Yes

From scratch or by extending another Resource Catalog

Skins

Yes

Only by making a copy of another skin

Page Styles

No

(Not applicable)

Content Presenter templates

No

(Not applicable)

Mashup styles

No

(Not applicable)

Data Controls

Yes

Only from scratch

Task flows

Yes

Only from scratch

10.2.2 Creating a Resource

To create a resource in WebCenter Spaces:

Note:

The procedure for creating a data control is different than other resources. For information about how to create a data control, see Chapter 26, "Creating Business Mashups."

1. Navigate to the Resources page of your application or the Space in which you want to create a resource, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired type of resource.

3. On the menu bar, click Create.

4. In the Create dialog, in the Name field, enter the name of the resource.

Figure 10-12 Creating a Resource

5. In the Description field, enter a description of the resource.

6. From the Copy from list, select the existing resource that you want to extend for creating a new resource.

Note:

The Copy From list is available only for page template, navigation, Resource Catalog, and skin resources. It is not available for a data control or task flow resource.
For a task flow resource, you need to select the page layout. For information, see Section 26.3.1, "Creating a Task Flow."

7. Click Create.
The newly created resource is listed on the Resources page. The gray icon next to a resource indicates that it is not yet published and hence not available to users for use. For information about publishing resources, see Section 10.4.3, "Showing and Hiding Resources."

10.3 Editing Resources

This section includes the following sections:

- Section 10.3.1, "What You Should Know about Resource Editing"

- Section 10.3.2, "Editing the Source Code of a Resource"

- Section 10.3.3, "Editing a Resource by Using the Edit Dialog"

10.3.1 What You Should Know about Resource Editing

WebCenter Spaces enables you to edit custom resources. WebCenter Spaces supports two types of resource editing:

- Simple editing - provides a simple means of editing a resource's basic settings. Use the Edit dialog to perform simple editing.

- Source editing - enables you to work with the source code of a resource. Use the Edit Source dialog to perform source editing.
You may want to edit a resource's source file to make advanced edits to its code without having to download the file, edit it in JDeveloper, and upload it back into WebCenter Spaces. You can even use the Edit Source option to create a resource from the beginning—by creating a resource and then replacing its default source code with your own original code. Note, however, that, due to the heavy hand-coding requirement, this scenario is not recommended.

You cannot edit built-in resources. If you want to modify a built-in resource, consider creating a copy of the resource and then editing the copy according to your preferences.

Oracle WebCenter supports round-trip development of resources. To get enhanced functionality for your resources, you can download your resource, edit it in JDeveloper, and then upload it back into Spaces. For information, see Section 10.5, "Using JDeveloper to Build WebCenter Spaces Resources."

10.3.2 Editing the Source Code of a Resource

Use the Edit Source dialog to get more control over resource editing at runtime. You can edit the underlying source code of any custom resource except data controls. Changes made to a resource are saved to the MDS, and are made available immediately.

To edit the source code of a resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. On the Resources page, from the navigation panel on the left, select the desired type of resource.

3. From the list of resources displayed on the right, select the resource whose code you want to edit.

4. From the Edit menu, choose Edit Source.
The Edit Source dialog displays the resource definition.

5. Edit the code as required.
The XML syntax in the code is validated and an error message is displayed if you miss any tags or add them incorrectly. Validation is not performed for non-XML files, such as a CSS file.

Figure 10-13 shows the sample source code of a skin's CSS file.

Figure 10-13 Editing the Source Code of a Resource

6. Click OK.

10.3.3 Editing a Resource by Using the Edit Dialog

Use the Edit dialog to make simple changes to your resource. The properties displayed in the Edit dialog vary from resource to resource. For information about editing a resource, refer to the resource-specific chapter listed in Table 10-1.

10.4 Managing Resources

This section includes the following subsections:

- Section 10.4.1, "Copying a Resource"

- Section 10.4.2, "Setting Properties on a Resource"

- Section 10.4.3, "Showing and Hiding Resources"

- Section 10.4.4, "Setting Security for a Resource"

- Section 10.4.5, "Deleting a Resource"

- Section 10.4.6, "Previewing a Resource"

- Section 10.4.7, "Querying for a Resource Through the Expression Builder"

- Section 10.4.8, "Applying Resources Dynamically Using EL Expressions"

10.4.1 Copying a Resource

WebCenter Spaces enables you to create a copy of a resource. This feature is useful when you want to:

- Create a backup of a resource.

- Update a resource while keeping the original in use.

- Use a built-in resource as a sample to build a new resource. Built-in resources cannot be edited, but you can create a copy of a resource to use it as a starting point for further refinement.

You can create a copy of all types of resources except Content Presenter templates. When you create a copy of a resource, the copy is marked as hidden.

To make a copy of a resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired type of resource.

3. From the list of resources displayed on the right, select the resource whose copy you want to create.

4. From the Edit menu, choose Copy.

5. In the Copy dialog, in the Display Name field, enter a name for the resource copy (Figure 10-14).

Figure 10-14 Copying a Resource

6. In the Description field, enter a description of the resource copy.

7. Click OK.

10.4.2 Setting Properties on a Resource

Each resource has certain associated properties that define its display properties, availability, and attributes. This section describes how to access and modify these properties for custom resources. It includes the following sections:

- Section 10.4.2.1, "What You Should Know About a Resource's Properties"

- Section 10.4.2.2, "Accessing the Edit Properties Dialog of a Resource"

- Section 10.4.2.3, "Renaming, Describing, and Categorizing a Resource"

- Section 10.4.2.4, "Associating an Icon with a Resource"

- Section 10.4.2.5, "Setting the Availability of an Application-Level Resource in Other Spaces"

- Section 10.4.2.6, "Working with the Attributes of a Resource"

10.4.2.1 What You Should Know About a Resource's Properties

Use the Edit Properties dialog to edit the properties associated with custom resources. The Edit Properties dialog contains these sections: General, Exclude Resource Usage, and Attributes.

General Section

The General section displays details such as the resource's name, location, and internal ID. These properties are common across all resources.

Table 10-1 describes the properties listed in the General section.

Table 10-3 Properties in the General Section of the Edit Properties Dialog

Property

Description

Display Name

Specify the name of a resource.

Description

Enter the description of a resource.

Icon URI

Specify the URI of the icon that you want to associate with a resource.

Category

Specify the category, like Sales, that you want to associate with a resource.

Resource Type

Displays the type of the resource. For example, for a page style resource, the resource type is pageStyle.

Internal ID

Displays the unique internal identification number assigned to a resource in WebCenter Spaces.

Content Directory

Displays the path where dependent objects of a resource, such as images, are stored on the managed server to which WebCenter Spaces is deployed.

JSPx File

Displays the path to the .jspx file of a resource.

Page Definition

Displays the path where the page definition (.xml file) of a resource is stored on the WebCenter Spaces server. Page definitions are used for page templates, task flows, page styles, and mashup styles.

Metadata File

Displays the path where metadata files, if any, of a resource are stored on the WebCenter Spaces server.

Created By

Displays the name of the user who created a resource.

Date Created

Displays the date and time when a resource was created.

Modified By

Displays the name of the user who last modified the resource.

Date Modified

Displays the date and time when a resource was last modified.

Exclude Resource Usage Section

When an application-level resource is marked as available, it becomes available to all Spaces and a Home Space. WebCenter Spaces gives you the control to choose whether that resource is available in a Home Space and all Spaces, or only in selected Spaces. Use the controls in the Exclude Resource Usage section to prevent or promote the display of a selected custom resource (Figure 10-15).

You can set availability of custom resources only at the application level. The Exclude Resource Usage section is not available in a Home Space and Spaces.

Figure 10-15 Setting Availability of a Resource in Other Spaces

Attributes Section

The Attributes section (Figure 10-16) lists the attributes associated with a resource. The attributes displayed in the Attributes section vary from resource to resource. For example, while a page template does not have any default attributes, skins have the following default attributes: skinFamily, skinId, and skinExtends.

Figure 10-16 Attributes of a Resource

Attributes determine the behavior of a resource. For example, editPageAfterCreation is a custom attribute of the page style resource and controls whether a newly created page opens in edit or view mode. It takes a value of true or false. When you associate this attribute with a particular page style, every time a user creates a page based on the selected style, the attribute value is considered and the page behaves accordingly.

You can add, edit, or delete attributes as described in Section 10.4.2.6, "Working with the Attributes of a Resource." For information about resource-specific attributes, if any, refer to the relevant chapter listed in Table 10-1.

10.4.2.2 Accessing the Edit Properties Dialog of a Resource

To access the Edit Properties dialog of a resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. From the left navigation panel, select the type of resource you want to edit.

3. From the list displayed on the right, select the relevant resource, and from the Edit menu, choose Edit Properties.
The Edit Properties dialog opens (Figure 10-17).

Figure 10-17 Edit Properties Dialog of a Resource

See Also:

The next thing you do depends on what you want to accomplish. For more information, see:

- Section 10.4.2.3, "Renaming, Describing, and Categorizing a Resource"

- Section 10.4.2.4, "Associating an Icon with a Resource"

- Section 10.4.2.5, "Setting the Availability of an Application-Level Resource in Other Spaces"

- Section 10.4.2.6, "Working with the Attributes of a Resource"

10.4.2.3 Renaming, Describing, and Categorizing a Resource

Resources, whether built-in or custom, are sorted on the Resource page according to their display names. To maintain a well-organized set of resources, consider developing a standard naming scheme and method of description. This is not a required step, but it may be useful in identifying and clarifying your intended purpose for a given resource.

You can classify your resources into relevant groups. For example, all page styles associated with Sales could have a sales category. This value is available and exposed only in the Edit Properties dialog.

To provide a name, description, and category for a resource:

1. Open the Edit Properties dialog for the desired resource as described in Section 10.4.2.2, "Accessing the Edit Properties Dialog of a Resource."

2. In the Display Name field, edit the display name for the resource, if required.

3. Optionally, in the Description field, enter a description of the resource.

4. Optionally, in the Category field, enter a category name.

5. Click OK to save your changes and exit the dialog.

10.4.2.4 Associating an Icon with a Resource

You can associate an icon with a resource. In the current version of WebCenter Spaces, the associated icon is visible only for page styles when you create a page using the Create dialog.

To associate an icon with a resource:

1. Open the Edit Properties dialog for the desired resource as described in Section 10.4.2.2, "Accessing the Edit Properties Dialog of a Resource."

2. In the Icon URI field, enter a standard URI path to the icon.

Note:

You can either specify an absolute URL (where the URL should also work if entered in a browser address field), or a relative URL that points to an image located somewhere in WebCenter Spaces. To store an image in Spaces, you must upload the required file using the Documents service, as described in Section 41.8.1, "Uploading New Files." You can then obtain the image's URL by copying the Download URL value as described in Section 41.24.1, "Retrieving the URL for a Folder or File."

3. Click OK to save your changes and exit the dialog.

10.4.2.5 Setting the Availability of an Application-Level Resource in Other Spaces

Use the Exclude Resource Usage section of the Edit Properties section to set the availability of an application-level resource in a Home Space or a Space. The Exclude Resource Usage section is available only at the application level, and not in a Home Space or any other Spaces.

To set the availability of an application-level resource in Home Spaces and other Spaces:

1. Open the Edit Properties dialog for the desired resource as described in Section 10.4.2.2, "Accessing the Edit Properties Dialog of a Resource."

2. Under Exclude Resource Usage:

- For the Exclude From Home Space checkbox:

- Select to hide the resource on the Resources page of Home Spaces

- Clear to show the resource on the Resources page of Home Spaces

- For Exclude From Space(s), choose:

- Include in All Spaces - to make the resource available on the Resources page of all Spaces

- Exclude from All Spaces - to exclude the resource from being listed on the Resources page of all Spaces

- Exclude from Selected Spaces - to specify the Spaces on whose Resources page the resource will not be listed
When you select this option, an Add/Choose link appears (Figure 10-18).

Figure 10-18 Exclude Resource Usage Section

Clicking this link displays the Add Space dialog. Select the Spaces from which to exclude the resource and click OK (Figure 10-19).

A list of the selected Spaces is displayed in the Edit Properties dialog.

Figure 10-19 Excluding a Resource from Selected Spaces

3. Click OK to save your changes and exit the Edit Properties dialog.

10.4.2.6 Working with the Attributes of a Resource

This section describes how to associate a custom attribute with a resource and how to remove a custom attribute. It contains the following sections:

- Section 10.4.2.6.1, "Associating an Attribute with a Resource"

- Section 10.4.2.6.2, "Deleting an Attribute of a Resource"

10.4.2.6.1 Associating an Attribute with a Resource

To associate an attribute with a resource:

1. Follow the steps outlined in Section 10.4.2.2, "Accessing the Edit Properties Dialog of a Resource."

2. In the Attributes section, in the Name field, enter the attribute name (Figure 10-20).

Figure 10-20 Adding an Attribute

For information about the attributes, if any, that can be associated with a resource, refer to the resource-specific chapter listed in Table 10-1.

3. In the Value field, enter the value of the attribute.

4. Click Add More if you want to add more attributes.
This adds a new row. You can then enter the required details in the Name and Value fields.

5. Click OK to save your changes and exit the dialog.

10.4.2.6.2 Deleting an Attribute of a Resource

To remove an attribute associated with a resource:

1. Follow the steps outlined in Section 10.4.2.2, "Accessing the Edit Properties Dialog of a Resource."

2. In the Attributes section, click the Remove icon displayed next to the attribute you want to delete.

3. Click OK to save your changes and exit the dialog.

10.4.3 Showing and Hiding Resources

This section includes the following subsections:

- Section 10.4.3.1, "What You Should Know About Showing and Hiding Resources"

- Section 10.4.3.2, "Showing a Resource"

- Section 10.4.3.3, "Hiding a Resource"

10.4.3.1 What You Should Know About Showing and Hiding Resources

All resources, whether built-in or custom, can be marked as hidden or available. For all resources that are available for use, a green tick mark and the word "Available" appear next to the resource's name on the Resources page. A gray icon and the word "Hidden" next to a resource's name indicates that the resource is marked as hidden, as shown in Figure 10-21.

Figure 10-21 Showing or Hiding a Resource

When you create or upload a resource, by default the resource is marked as hidden. A hidden application-level resource is not available for selection in the resource picker in the application, Spaces, or Home Spaces. Similarly, a hidden Space-level resource is not listed in the resource picker in that Space. For a resource to become available in the resource picker, it must be published.

You can use a hidden resource for creating a new resource. For example, Figure 10-22 shows that the page template MySpaceTemplate is marked as hidden. But it is listed in the Copy from list when you create a new page template. Figure 10-23 shows the list of all page templates that are available for use. Note that MyTemplate is not listed there.

Figure 10-22 A Hidden Resource Available for Creating a New Resource

Figure 10-23 A Hidden Resource Not Listed in the Resource Picker

10.4.3.2 Showing a Resource

To mark a hidden resource as available:

1. Navigate to the Resources page of the application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. From the left navigation panel, select the desired type of resource.

3. From the list of resources displayed on the right, select the resource that you want to mark as available.

4. From the Edit menu, choose Show.
A green checkmark and the word "Available" appear next to the resource's name, indicating that the resource is available for use.

10.4.3.3 Hiding a Resource

To hide a resource:

1. Navigate to the Resources page of the application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired type of resource.

3. From the list of resources displayed on the right, select the resource that you want to hide.

4. From the Edit menu, choose Hide.
A gray icon and the word "Hidden" appear next to the resource's name, indicating that the resource is now hidden and is not available to users.

10.4.4 Setting Security for a Resource

You can control whether all users or only specific users or groups can access the custom resources that you created in the application. By default, resource access is controlled by application-level permissions (see Section 10.1.3, "Permissions Required to Work with Resources"). After you define resource-specific permissions, the permissions defined at the application or Space level no longer apply.

To set access permissions for a resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired type of resource.

3. From the list of resources displayed on the right, select the resource for which you want to set access permissions.

4. From the Edit menu, choose Security Settings.

5. In the Security Settings dialog, specify an access method by selecting either of the following (Figure 10-24):

- Use Custom Permissions - Select this option to define who can manage and update the selected resource. When you select this option, the other controls in the dialog become available. Proceed to step 6.

Note:

When you choose Use Custom Permissions, ensure that at least one user or group is granted the Manage access.

- Use Spaces Security Settings - Select this option to inherit the selected resource's access settings from those defined for the application. After selecting this option, click OK to save your changes and exit the dialog.

Note:

Selecting Use Spaces Security Settings removes any custom permissions that you may have set.

Figure 10-24 Setting Security for a Resource

6. If you selected, Use Custom Permissions, specify the user or group to whom you want to grant resource access. In the Security Settings dialog:

- Click Add Users to open a dialog that you can use to search for and select individual users available in your identity store. Enter the characters from the name of your search target. For example, the search term 'do' finds all user names starting with 'do' such as 'don' and 'doug'. If you wish to search for a user name like 'condoleeza', then use '*' in the beginning, like '*do'.
Select the required user(s), and click OK to close the dialog.

- Click Add Groups to open a dialog that you can use to search for and select groups of users available in your identity store. Select the required group(s), and click OK to close the dialog.

7. For each user or user group listed in the Role or User column, specify the level of access you want to grant:

- Select the Manage checkbox to grant full access on the resource. Such users can perform tasks such as edit, delete, grant access, show or hide, and the like.

- Select the Update checkbox to grant the permission to edit the resource. Such users can edit the resource, but they cannot delete it.

8. If you want to revoke permissions from any user or user group, select that entity and click Delete Access.

9. Click OK.

10.4.5 Deleting a Resource

When a resource is no longer required, you may want to remove it. In WebCenter Spaces, you can delete custom resources, but not built-in resources.

Note:

Before you use delete a resource, you must ensure that the resource is not in use. If you mark a resource for deletion, WebCenter Spaces will delete it even if it is in use.

To delete a custom resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired resource type.

3. From the list of resources displayed on the right, select the resource you want to delete.

4. From the Edit menu, choose Delete.

5. In the Delete confirmation dialog, click Delete to delete the resource.

10.4.6 Previewing a Resource

WebCenter Spaces provides a means of previewing certain resources—page templates, mashup styles, and task flows. You can use the Preview option to preview a resource and make adjustments, if required.

To preview a resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. From the left navigation panel, select the desired resource type.

3. From the list of resources on the right, select the resource you want to preview.

4. Click Preview.

Note:

The Preview option is not available for all resources. For information about a particular resource, refer to the resource-specific chapter listed in Table 10-1.

10.4.7 Querying for a Resource Through the Expression Builder

You can access any resource anywhere in WebCenter Spaces through Expression Language (EL) expressions.

For example, the following EL expression returns the first template resource found with a display name myPage:

#{srmContext.resourceType['siteTemplate'].displayName['myPage'].singleResult}

You must set query parameters in the format .property['value'], where property is the name of the resource property, for example, it can be id or resourceScope, and value is the value of that property you want to search for.

For information about EL expressions that you can use to query resources, see Section B.3.5, "EL Expressions Relevant to Resources."

10.4.8 Applying Resources Dynamically Using EL Expressions

WebCenter Spaces provides a way to dynamically apply certain resources at runtime based on some criteria. For example, you can present content or shape the way content is presented by using Personalization-related ELs to select and apply a page template based on whoever is the current user.

Consider an example where you want the top-navigation page template to be displayed to Space moderators, and a side-navigation page template to be displayed to other users. Figure 10-25 shows a sample EL expression that you can use in such scenario. The EL expression uses the resource IDs of the page templates.

Figure 10-25 Specifying an EL Expression for Applying a Page Template Based on User Role

Instead of using the exact resource ID of the resource that you want to apply, you can also include queries in an EL expression as shown in the following example.

#{WCSecurityContext.userInScopedRole['Moderator'] ?  srmContext.resourceScope['space_name'].resourceType['siteTemplate'].displayName['Top'].singleResult.id :
srmContext.resourceScope['space_name'].resourceType['siteTemplate'].displayName['Side'].singleResult.id}

Figure 10-26 shows how a Space may appear to a Space Moderator, and Figure 10-27 shows how the Space may appear to other users.

Figure 10-26 A Page Template Dynamically Applied for Space Moderators

Figure 10-27 A Page Template Dynamically Applied for Other Users

You can also use EL expressions to execute personalization server scenarios, as described in Appendix B, "EL Expressions Relevant to the Personalization Conductor." For information about common EL expressions that you can use, see Appendix B, "Expression Language Expressions."

To dynamically apply a resource at runtime:

1. Note down the Internal ID of the required resource from its About dialog. For information about how to access this dialog, see Section 10.1.5, "Viewing Information About a Resource."

2. Access the WebCenter Spaces Administration page as described in Section 4.1, "Accessing the WebCenter Administration Page," and open the General sub page of the Configuration page. Or, access the Space administration page as described in Section 51.3, "Accessing Space Administration Pages," and open the General page.

Tip:

You can use "pretty URLs" to navigate to the settings page:

- Application-level Configuration page:

http://host:port/webcenter/spaces/admin/general

- Space-level General page:

http://host:port/webcenter/spaces/spaceName/admin/general

3. Click the icon next to the desired resource field, then click Expression Builder to open the editor.

Figure 10-28 Using the Expression Builder for a Resource

4. Select the Type a value or expression radio button, if not already selected.

5. Type the required expression builder statement.

Figure 10-29 Expression Editor Dialog

For example, if you want to display different page templates depending on whether the page is rendered in a browser on a Windows platform or on a mobile device, you can use the following EL expression:

#{requestContext.agent.platformName=='windows' ? 'gsr3396194a_3a72_44d6_90b4_57fd6efe4ff7' : 'gsr1472d17b_8f10_4689_89fb_7431f561567f'}

This EL expression is an 'if-then-else' statement. The EL requestContext.agent.platformName retrieves the platform information. The page template IDs are the ones noted down from the About dialog.

6. Click Apply.

10.5 Using JDeveloper to Build WebCenter Spaces Resources

This section includes the following subsections:

- Section 10.5.1, "What You Should Know About Building Spaces Resources in JDeveloper"

- Section 10.5.2, "Downloading a Resource"

- Section 10.5.3, "Uploading a Resource"

10.5.1 What You Should Know About Building Spaces Resources in JDeveloper

You may find yourself in a situation where you want to edit or create resources beyond the capabilities of WebCenter Spaces. Oracle WebCenter provides features for round-trip development of WebCenter Spaces resources. To further enhance your existing resources, you can download them from WebCenter Spaces, edit them at a really fine level of granularity in an IDE like JDeveloper, and then upload the updated resources back into WebCenter Spaces. You can upload resources directly to WebCenter Spaces from within Oracle JDeveloper or through WebCenter Spaces.

In JDeveloper, you can also create resources from scratch for the purpose of using them in WebCenter Spaces. However, you do not necessarily need to start from scratch. An efficient way is to make a copy of an existing Spaces resource and refine it further in JDeveloper without worrying about the prerequisites involved in creating it from scratch in JDeveloper. Oracle WebCenter provides a special JDeveloper workspace (DesignWebCenterSpaces.jws) to help you develop and upload resources to WebCenter Spaces. For more information about editing custom resources and uploading them into WebCenter Spaces through JDeveloper, see "Designing WebCenter Spaces Resources in JDeveloper" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

When you download a resource, its configuration is saved into an export archive (.ear file). You can save the export archive either to your local file system or a remote server file system.

When you upload resources to WebCenter Spaces:

- Existing resources, that is, resources with the same internal ID, are overwritten.

- Space-level resources are uploaded back only into their original Space. You cannot upload a Space-level resource into a different Space.

- Resources must be in an export archive (.ear) format on your local file system or a remote server

10.5.2 Downloading a Resource

To download a resource:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired resource type.

3. From the list of resources displayed on the right, select the resource you want to download as an EAR file.

4. Click Download.

5. In the Download dialog, in the Archive Name field, enter the name of the export archive file.

6. Click Download.

7. In the Download dialog, specify where you want to save the export archive file. Use either of the following options (Figure 10-30):

- Download - Click this if you want to save the export archive file to your local file system. Then, specify the path where you want to save the file.

- Save to Server - Click this to save the export archive file to a remote server file system. In the Server Location dialog, in the Save to Location field, enter the server path and then click Save.

Figure 10-30 Download Dialog

Note:

Space administrators can download resources using the WLST command, exportResources. For information, see section "Exporting WebCenter Resources Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

10.5.3 Uploading a Resource

To upload a resource in WebCenter Spaces:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, select the desired resource type.

3. Click Upload.

4. In the Upload dialog, specify the location of the resource archive file. Depending on the location of your EAR file, select either of the following (Figure 10-31):

- On Local File System: Select if the archive is located on your local file system. Enter the path to the EAR file or use the Browse button.

- On Server: Select if the archive is located on a remote server. Enter the path to the EAR file.

Figure 10-31 Upload Dialog

5. Click Upload.

Note:

Space administrators can upload resources using the WLST command, importResources. For information, see section "Importing WebCenter Resources Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

11 Working with Navigation

Navigation enables the users of your portal to see what information the portal provides and to get to that information quickly and easily.

This chapter describes how to define your portal navigation model in WebCenter Spaces and how to use built-in navigation task flows to visualize that model in page templates. It includes the following sections:

- Section 11.1, "What You Should Know About Navigation"

- Section 11.2, "Building a Navigation Model"

- Section 11.3, "Rendering Navigation in Your Portal"

- Section 11.4, "AviTrust Employee Portal: An Example of Delegated Navigation"

Portal designers with advanced navigation requirements can use development tools, such as JDeveloper, to build navigation models and then upload them to WebCenter Spaces. For more information, see Section 11.2.5, "Using JDeveloper to Build Your Navigation Model."

Similarly, page template designers can use those same development tools to build the navigation UI directly into page templates and upload those templates to WebCenter Spaces. For more information, see Section 11.3.3, "Using JDeveloper to Visualize Your Navigation."

For generic information about adding and editing different types of resources, see Chapter 10, "Working with the Resources that Compose a Portal or Community."

Audience

This chapter is intended for Portal designers with the application permission Application-Navigations-Create, Edit, and Delete.

To build navigation models for a particular Space, you need the permission Space-Resources-Create, Edit, and Delete Resources (standard permission model) or Space-Navigations-Create, Edit, and Delete Navigations (advanced permission model).

To add navigation to page templates, you also need the appropriate page template permissions, that is, Application-Page Templates-Edit to edit an application-wide page template, and either Space-Resources-Edit Resources or Space-Page Templates-Edit to edit a page template for a particular Space.

See Also:

For information about roles and permissions, see Chapter 20, "Understanding WebCenter Spaces Security."

11.1 What You Should Know About Navigation

Navigation is a fundamental aspect of your portal. Users need to be able to see what is available in the portal, move around the portal, and orient themselves within the portal.

Navigation is essentially a set of links pointing to the content of the portal, or to external resources. Examples of navigation include:

- A series of tabs or menus along the top of each page

- A tree structure or list of links on the side of each page

- A trail of breadcrumbs showing the path a user has taken to reach the current location in the portal

In WebCenter Spaces, you can break navigation down into two main concepts:

- The navigation model defines the content, structure, and metadata of the navigation. For more information, see Section 11.1.1, "What You Should Know About Navigation Models."

- The navigation visualization determines how the navigation appears on the pages of the portal, say as a menu, a tree, or breadcrumbs. For more information, see Section 11.1.2, "What You Should Know About Navigation Visualization."

11.1.1 What You Should Know About Navigation Models

When you create the navigation model, you specify the resources to which users can navigate. You can link together information from multiple sources, such as Spaces, pages, content repositories, and even external web pages. You can also introduce folders and separators to make navigations easier to use. You can include nested navigation models within a navigation model to delegate development of the navigation across multiple teams, or to control access to different items in the navigation.

Navigation models can include the following resources:

- Spaces (individual Spaces and Space hierarchies)

- Pages (individual pages and page hierarchies)

- Content (individual content items or the results of a content query)

- Other navigation models

- Portlets

- Task flows

- External applications

- External links

The navigation model is aware of the security policies that have been applied to the elements (pages, link, task flows, and so on) that the navigation model controls. If the current user is not authorized to see a particular page, the navigation model, by default hides any navigational links to that page. Navigation model metadata can also be determined contextually using EL expressions. These expressions are evaluated at runtime to determine exactly which pieces of the navigation model are rendered in the navigation UI and to whom.

WebCenter Spaces includes three built-in navigation models to get you started:

- Spaces Administration Options—This navigation model contains administration options for Spaces or the Home Space (Figure 11-1). The links displayed when the navigation is rendered on a page vary depending on whether it appears in a Space or in a Home Space and on the permissions of the current user. By default, this navigation model includes a Manage dropdown menu to provide access to administration settings.

Figure 11-1 The Spaces Administration Options Navigation Model

- Spaces Default Navigation Model—This navigation model contains the default top level entries for navigation in a Space. It includes links to the current Space pages, and links to any saved searches and Subspaces (Figure 11-2).

Figure 11-2 The Spaces Default Navigation Model

- Spaces Navigation with Blogs/Wikis/Lists Submenus—This navigation model is similar to the Spaces Default Navigation Model, except it also includes links to any blogs, wikis, and lists for the current Space (Figure 11-3).

Figure 11-3 The Navigation with Blogs/Wikis/Lists Navigation Model

You can use these built-in navigations as they are, create copies of them and edit them to support your own requirements, or create a completely new navigation model for your portal.

Note:

You cannot edit the built-in navigation models. If you want to edit these navigation models, you must first create a copy, which you can then edit.

Just like other WebCenter Spaces resources, portal designers can build navigation models that are available to the whole application (application-level resources) and navigation models that are scoped to a particular Space (Space-level resources).

If the navigation model functionality provided by WebCenter Spaces does not meet your requirements, you can create the navigation model in a development tool, such as JDeveloper, and upload the model to WebCenter Spaces using the Resource Manager. For more information, see Section 11.2.5, "Using JDeveloper to Build Your Navigation Model."

11.1.2 What You Should Know About Navigation Visualization

The navigation visualization determines how the navigation model should appear in the portal. For example, the navigation could be provided as a set of tabs along the top of each page, or perhaps as a tree-like structure down the side of the page.

WebCenter Spaces provides the following built-in navigation task flows that page template designers can add to page templates to quickly visualize a navigation model across the entire portal:

- Navigation Tree task flow—Tree navigations display navigational links in a hierarchical structure and often contain multiple-level hierarchies (Figure 11-4). Tree navigations can provide relatively simple access to a complex structure and quite often appear on the left in page templates.

Figure 11-4 The Navigation Tree Task Flow

- Navigation Menu task flow—Menu navigations display navigational links as a series of tabs, menus, bars, buttons, choices, or as a list (Figure 11-5). Menu navigation is appropriate when linking to WebCenter pages, Spaces, and documents, and where the number of items is known, such that there is enough room to display all the options that are available.

Figure 11-5 The Navigation Menu Task Flow

- Navigation Breadcrumb task flow—Breadcrumb navigations display a series of horizontal or vertical links that show users their current position in the navigation hierarchy (Figure 11-6). Breadcrumbs are particularly useful for deep hierarchies, say four levels or more, and when users might want to get back to a specific place.

Figure 11-6 The Navigation Breadcrumb Task Flow

See Also:

For information about how to add these built-in navigation task flows to your page templates, see Section 11.3, "Rendering Navigation in Your Portal."
For information about the different properties you can set for the built-in navigation task flows, see Section 11.3.2, "Setting Navigation Task Flow Properties."

WebCenter Spaces also provides the Spaces Browser task flow, which displays all the Spaces that are available to you. This includes Spaces for which you are the moderator, Spaces in which you are a member, Spaces that are public and available to non-WebCenter Spaces users, and Spaces that are private, which you must be invited to join. For more information, see Section 51.16, "Working with the Space Task Flows."

Figure 11-7 The Spaces Browser Task Flow

If the built-in task flows do not sufficiently satisfy the navigation requirements of your portal, page template designers can also edit page templates in a development tool, for example, JDeveloper, to build the navigation UI directly into the page templates themselves, then upload them to WebCenter Spaces to use there.

For more information, see Section 11.3.3, "Using JDeveloper to Visualize Your Navigation."

11.2 Building a Navigation Model

The first step in providing navigation for your portal is to define the navigation model; that is, defining the structure and content of the navigation. You do this by creating the basic navigation model, adding navigation items to it, and setting the properties of those navigation items.

This section includes the following subsections:

- Section 11.2.1, "Creating a Navigation Model"

- Section 11.2.2, "Editing a Navigation Model"

- Section 11.2.3, "Managing a Navigation Model"

- Section 11.2.4, "Selecting the Default Navigation Model"

- Section 11.2.5, "Using JDeveloper to Build Your Navigation Model"

11.2.1 Creating a Navigation Model

You can either create an entirely new navigation model or create a copy of an existing navigation model to use as a starting point for your navigation model.

You can create navigation models at the application level or at the Space level. Application-level navigation models are available for use in all Spaces, unless the Space has been specifically excluded. For more information, see Section 10.4.2, "Setting Properties on a Resource." Space-level navigation models are available for use only in the Space in which they are created.

To create a navigation model:

1. Navigate to the Resources page of your application or the Space in which you want to create the navigation model, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. On the menu bar, click Create.

4. In the Create New Navigation dialog (Figure 11-8), in the Name field, enter a name for the navigation model.

Figure 11-8 The Create New Navigation Dialog

5. In the Description field, enter a description for the navigation model.
The description is displayed below the name in the Resources page and as a tool tip when selecting a navigation model. You should ensure that the description helps page template designers determine if they want to use this particular navigation model.

6. From the Copy From list, select an existing navigation model to use as the starting point for your new navigation model, if desired. If you leave this blank, a new empty navigation model is created.

Tip:

You can also create a copy of an existing navigation model by selecting the existing navigation on the Resources page, clicking Edit and then Copy on the menu bar, and providing a name and description for the new navigation model.

7. Click Create.
The newly created navigation model is listed on the Resources page. The gray circle icon next to the navigation model indicates that it is not yet published and hence is not available to other users. For information about publishing a navigation model, see Section 10.4.3, "Showing and Hiding Resources."

11.2.2 Editing a Navigation Model

After creating the basic navigation model, the next step is to define exactly what to include in it. The resources that you include in the navigation model determine what users can navigate to when the model is displayed on a page.

This section includes the following subsections:

- Section 11.2.2.1, "Adding Resources to a Navigation Model Using the Edit Dialog"

- Section 11.2.2.2, "Editing the Source Code of a Navigation Model"

11.2.2.1 Adding Resources to a Navigation Model Using the Edit Dialog

The Edit dialog provides various options for adding resources to your navigation model.

This section includes the following subsections:

- Section 11.2.2.1.1, "Adding a Document to a Navigation Model"

- Section 11.2.2.1.2, "Adding Content Based on the Results of a Query to a Navigation Model"

- Section 11.2.2.1.3, "Adding a Spaces Page, Portlet, Task Flow, External Application, or Web Page to a Navigation Model"

- Section 11.2.2.1.4, "Adding a List of Pages to a Navigation Model"

- Section 11.2.2.1.5, "Adding a List of Subspaces to a Navigation Model"

- Section 11.2.2.1.6, "Nesting a Navigation Model Within a Navigation Model"

- Section 11.2.2.1.7, "Organizing Navigation Items in a Navigation Model"

- Section 11.2.2.1.8, "Setting Display Options for Navigation Items"

11.2.2.1.1 Adding a Document to a Navigation Model

You can add a document from your content repository to the navigation model. Selecting a document in the navigation displays that document in the page.

Note:

You can also include a set of documents that match particular query criteria in a navigation model. For more information, see Section 11.2.2.1.2, "Adding Content Based on the Results of a Query to a Navigation Model."

To add a document:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. In the Edit dialog, from the Add menu, choose Content Item.

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-9 The Add Content Item Menu Option

6. In the Target tab, in the Name field, enter a name for the navigation item. This name is displayed in the navigation when it is rendered on a page.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-10 The Edit Navigation Item Dialog for a Content Item

7. In the Description field, enter a brief description of the navigation item.

8. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

9. In the Path field, enter the path for the content item. If you do not know the path, click the Select icon to browse the content repository for available content.

Note:

You can also select a content folder, in which case, you should also select a Content Presenter display template that expects a folder and renders all the content from that folder.

10. From the Content Presenter Template dropdown list, select the Content Presenter display template to use to render the content item when it is selected in the navigation.

See Also:

For more information about Content Presenter, see Chapter 40, "Publishing Content Using Content Presenter."

11. From the Page Template dropdown list, select the page template to use to display the navigation item when it is selected in the navigation.
Select <No Selection> to use the Space or application default page template.

12. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

13. In the Parameters tab enter values, as desired, for any parameters supported by the selected page template. If the selected page template does not support any parameters, the Parameters tab is not displayed.

14. Click OK to create the navigation item.

15. Click OK to close the Edit dialog.

11.2.2.1.2 Adding Content Based on the Results of a Query to a Navigation Model

You can add a Content Query navigation item to the navigation model to include all documents that match specific search criteria.

See Also:

To add a single document, or all documents within a particular folder to the navigation model, see Section 11.2.2.1.1, "Adding a Document to a Navigation Model."

To add a content query to a navigation model:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. In the Edit dialog, from the Add menu, choose Content Query.

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-11 The Add Content Query Menu Option

6. In the Target tab, in the Name field, enter a name for the navigation item. This name is displayed in the navigation when it is rendered on a page.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-12 The Edit Navigation Item Dialog for a Content Query

7. In the Description field, enter a brief description of the navigation item.

8. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

9. In the Query String field, enter the query criteria to identify the content to include in the navigation model, for example:

select * from cmis:document WHERE cmis:name LIKE 'Foo%'

For more information about how to format the query and for more examples, see the Oracle Fusion Middleware Content Management REST Service Developer's Guide.

10. Select Hide Top-Level Folder to display the results of the query directly in the navigation rather than displaying them under a folder.

11. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

12. Click OK to create the navigation item.

13. Click OK to close the Edit dialog.

11.2.2.1.3 Adding a Spaces Page, Portlet, Task Flow, External Application, or Web Page to a Navigation Model

You can add links to individual resources, such as pages, portlets, task flows, external applications, and web pages.

See Also:

The Link navigation item type enables you to include a link to a single page in the navigation. For information about how to include an entire page hierarchy, see Section 11.2.2.1.4, "Adding a List of Pages to a Navigation Model."

To add a link to a Spaces page, portlet, task flow, external application, or web page:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. In the Edit dialog, from the Add menu, choose Link (Figure 11-13).

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-13 The Add Link Menu Option

Note:

If you provide navigation directly to a portlet or task flow, users cannot customize that portlet or task flow. If you want users to be able to customize the portlet or task flow, add it to a page and create a navigation item for that page.

6. In the Target tab, in the Name field, enter a name for the navigation item. This name is displayed in the navigation when it is rendered on a page.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-14 The Edit Navigation Item Dialog for a Link

7. In the Description field, enter a brief description of the navigation item.

8. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

9. In the Path field, enter the URL of the web page or click the Select icon to browse for available Spaces pages, portlets, task flows, or external applications to include in the navigation model.

Note:

In the Select dialog, the Select button is active only when you select an item that can be included in the navigation model. For example, if you expand the Portlets node and select a portlet producer, then the Select button is disabled. If you expand the portlet producer node and select a portlet, then the Select button is enabled.

10. From the Page Template dropdown list, select the page template to use to display the navigation item when it is selected in the navigation.
Select <No Selection> to use the Space or application default page template.

11. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

12. In the Parameters tab enter values, as desired, for any parameters supported by the selected page, task flow, or portlet, or by the page template. If the selected page, portlet, or task flow does not support parameters, or if the selected page template does not support parameters, then the Parameters tab is not displayed.

13. Click OK to create the navigation item.

14. Click OK to close the Edit dialog.

11.2.2.1.4 Adding a List of Pages to a Navigation Model

You can add a list of pages to the navigation model by selecting the starting point for the list and specifying the criteria to use to determine the pages to display. For example, you can include all the pages in a specific Space, all the Wiki pages in the current Space, or all Home Space pages. All pages below the selected starting point that match the criteria are included in the navigation model.

See Also:

If you just want to include a single page in the navigation model, use the Link navigation item type. For more information, see Chapter 11, "Adding a Spaces Page, Portlet, Task Flow, External Application, or Web Page to a Navigation Model."

To add a list of pages:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. In the Edit dialog, from the Add menu, choose Pages Query.

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-15 The Add Pages Query Menu Option

6. In the Target tab, in the Name field, enter a name for the navigation item. This name is displayed in the navigation when it is rendered on a page.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-16 The Edit Navigation Item Dialog for a Pages Query

7. In the Description field, enter a brief description of the navigation item.

8. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

9. In the Find Pages in radio group, select:

- Home Space to add the current user's Home Space and all its subpages to the navigation model.

- Space to add the home page of a specific Space and all its subpages to the navigation model. Enter the name of the Space, or click the Select Space icon to select from all available Spaces. In the Select Space dialog, you can list all available Spaces or you can filter the list of Spaces to those that you have joined, those that you moderate, or those that are public.

- Path to add a specific page and all its subpages to the navigation model. Enter the path of the page, or click the Select Page icon to select from all available pages.

10. From the Page Style dropdown list, select the style of page to include in the navigation model. For example, if you select Wiki, only pages that use the Wiki page style are included in the navigation model.
Selecting <No Selection> displays all pages, regardless of style.

11. In the Excluded Page Styles field, specify the styles of pages to exclude from the navigation model by entering a comma-separated list of page style paths, for example:

/oracle/webcenter/siteresources/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/
pageStyle/gsr1b60e8a7_2e23_48ff_9571_31ede592de1a/TemplateWiki.jspx,
/oracle/webcenter/siteresources/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/
pageStyle/gsr1b60e8a7_2e23_48ff_9571_31ede592de1b/TemplateBlog.jspx

Tip:

You can find the path of a page style by selecting it in the Resources page and clicking About in the menu bar.

Any pages that use the page styles specified here are not included in the navigation.

12. From the Visibility dropdown list, select whether to include pages even if they have been flagged as hidden in the Personalize Pages page.
Selecting <No Selection> displays all pages, regardless of visibility.

13. Select Hide Top-Level Folder to display the subpages in the hierarchy directly in the navigation rather than displaying them under a folder for the parent page.

14. From the Page Template dropdown list, select the page template to use to display the navigation item when it is selected in the navigation.
Select <No Selection> to use the Space or application default page template.

15. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

16. In the Parameters tab enter values, as desired, for any parameters supported by the page template. If the selected page template does not support any parameters, the Parameters tab is not displayed.

17. Click OK to create the navigation item.

18. Click OK to close the Edit dialog.

11.2.2.1.5 Adding a List of Subspaces to a Navigation Model

You can include a list of all the Subspaces of a particular Space in your navigation model. You can also include all the pages in those Subspaces, or specify a query to further refine which Subspaces to include in the list.

To add a list of Subspaces:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. In the Edit dialog, from the Add menu, choose Spaces Query.

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-17 The Add Spaces Query Menu Option

6. In the Target tab, in the Name field, enter a name for the navigation item. This name is displayed in the navigation when it is rendered on a page.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-18 The Edit Navigation Item Dialog for a Spaces Query

7. In the Description field, enter a brief description of the navigation item.

8. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

9. In the Space field, enter the name of the Space for which you want to display Subspaces, or click the Select Space icon to select from the available Spaces.
If you leave the field empty, then the current Space is used.

10. Select Display Subspace Pages to also include the pages within the Subspaces in the navigation.

11. Select Hide Top-Level Folder to display the Subspaces directly in the navigation rather than displaying them under a folder for the parent Space.

12. In the Advanced Query field, enter an EL expression to further refine the list of Subspaces included in the navigation model. For example, you might want to include only community Subspaces, or Subspaces with a particular string in the title. For more information about using the Expression Language editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

13. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

14. Click OK to create the navigation item.

15. Click OK to close the Edit dialog.

11.2.2.1.6 Nesting a Navigation Model Within a Navigation Model

You can nest navigation models within each other. For example, if you have a complex navigation model, it might be easier to break it down into several separate models and then nest them all within a single overarching navigation model. You can also use nested navigation models to delegate the development of navigation models to different users or to control access to different parts of the navigation.

For example, if you are creating a navigation model for a Space that contains several Subspaces, you may want to delegate the management of the navigation models for the Subspaces to the Subspace moderators. You can then include navigation references to the Subspace navigation models within the main Space navigation model. In this way, the person who is most familiar with the content of the Subspace creates the navigation model, without having to have access to other areas of the Space.

To nest navigation models:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. In the Edit dialog, from the Add menu, choose Navigation Reference.

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-19 The Add Navigation Reference Menu Option

6. In the Target tab, in the Name field, enter a name for the navigation item. This name is displayed in the navigation when it is rendered on a page.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-20 The Edit Navigation Item Dialog for a Navigation Reference

7. In the Description field, enter a brief description of the navigation item.

8. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

9. From the Include Navigation dropdown list, select the navigation model that you want to nest within this navigation model.

10. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

11. Click OK to create the navigation item.

12. Click OK to close the Edit dialog.

11.2.2.1.7 Organizing Navigation Items in a Navigation Model

You can add folders to your navigation model to create subsets of navigation items or to group similar navigation items. You can also add separators to divide the navigation model into distinct groupings of navigation items. Folders and separators enable you to break up the items in the navigation when it is rendered on in a page, making it easier to locate items.

In addition to folders and separators, you can also organize items within the navigation model by moving them up and down in relation to each other and even indenting items to indicate hierarchy.

You can also rearrange items within the navigation model by dragging them up and down in relation to each other and dragging them inside other items to indicate hierarchy.

To organize navigation items:

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model to which you want to add the navigation item.

4. From the Edit menu, choose Edit.

5. To add a separator, in the Edit dialog, from the Add menu, choose Separator.

Figure 11-21 The Add Separator Menu Option

A separator is added at the end of the navigation model. You can move the separator to the desired location as described later in this procedure.

6. To add a folder:

1. In the Edit dialog, from the Add menu, choose Folder.

Tip:

To create a navigation item within a folder, select the folder first and then click Add.

Figure 11-22 The Add Folder Menu Option

2. In the Target tab, specify a Name and Description for the navigation item.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-23 The Edit Navigation Item Dialog for a Folder

3. Select Visible if you want to display the navigation item when the navigation model is rendered on a page.
Alternatively, you can specify an EL expression to determine under which conditions the navigation item displays in the navigation. For example, to specify that the navigation item should be visible only to users with the Moderators role, using the following EL expression:

#{WCSecurityContext.userInScopedRole['Moderator']}

4. In the Options tab, set the display options for the navigation item. For more information, see Section 11.2.2.1.8, "Setting Display Options for Navigation Items."

5. Click OK to create the navigation item.
The folder is added at the end of the navigation model. You can move the folder to the desired location as described in the next step.

7. To move a navigation item within the navigation model, select the item and click the Move Up or Move Down icon as many times as necessary until the item is in the desired location.

8. To indent one navigation item (child item) under another item (parent item), move the child item so that it is immediately below the parent item, select the child item and click the Indent icon.

9. To move an indented item so that it is no longer indented below another item, select the item and click the Outdent icon.

10. Click OK to close the Edit dialog.

11.2.2.1.8 Setting Display Options for Navigation Items

You can specify various display options for navigation items to determine their appearance and behavior when the navigation is rendered on a page.

The display options available depend on the type of the navigation item.

1. Navigate to the Resources page of your application or the Space that contains the navigation model to which you want to add the navigation item, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model that contains the navigation item for which you want to specify display options.

4. From the Edit menu, choose Edit.

5. Select the navigation item.

6. From the menu bar, click Edit.

7. In the Options tab, in the Access Key field, enter a key mnemonic (single character) that can be used to access the navigation item without using the mouse.

Tip:

All fields in the Edit dialog provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a field to open the editor. For more information about using the editor and for common EL expressions, see Appendix B, "Expression Language Expressions."

Figure 11-24 The Options Tab of the Edit Navigation Item Dialog

8. In the Icon URI field, enter a path and file name of an image to use to represent the navigation item.

9. In the Search Keywords field, enter keywords to facilitate searching of the navigation item.

10. In the Tool Tip field, enter some brief descriptive text to display when users hover the mouse over the navigation item.

11. In the External ID field, enter an ID to enable a direct reference to the navigation item from a static link in the page.
Navigation items in the application's default navigation model with this attribute defined can be accessed using /faces/wcnav_externalId/externalId from an af:goLink component in a page or using /wcnav_externalId/externalId from an External Link navigation item in the navigation model. The alternative is to access the node by its hierarchy, which is faster, but may change as the application develops.

Note:

To directly access a node in the default navigation model for a particular Space, you must specify the Space by setting the wc.contextURL parameter, for example:

/faces/wcnav_externalId/myNavigationItem?wc.contextURL=/spaces/myProjectSpace

To directly access a node in a non-default navigation model, you must specify the path of the navigation model by setting the wcnav.modelPath URL parameter, for example:

/faces/wcnav_externalId/myNavigationItem?wcnav.model=
/oracle/webcenter/siteresources/scopedMD/
s7f446cab_f622_4b68_a83e_b7eaf28b52ec/navigation/
gsr0271c712_721a_4565_9f0e_755784a7093b/myNavigation.xml

Depending on where you are using the link, you may need to encode the URL parameters, for example, %2Fspaces%2FmyProjectSpace.

12. From the Open Link in dropdown list, select how to display the navigation item when it is selected, either in the same browser window, a new window, or a popup.
The options available depend on the type of navigation item.

13. Select Redirect to redirect to the URL specified for the navigation item. If you do not select this checkbox, then the URL is rendered within an IFRAME in the current page template.

Note:

This display option is available for all navigation items except for Navigation Reference, Folder, and Separator.
For Link navigation items that point to business role pages (for example, the My Profile page), the Redirect option has no effect; clicking the link always displays the page in the Home Space.

For Link navigation items that point to a page in a different Space, selecting Redirect opens the page inside the Space to which the page belongs. Deselecting Redirect opens the page in the current Space.

11.2.2.2 Editing the Source Code of a Navigation Model

If you prefer working in source code, you can use the Edit Source option.

To edit the source code of a navigation model:

1. Navigate to the Resources page of your application or the Space that contains the navigation model that you want to edit, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Navigations.

3. In the main panel, select the navigation model that you want to edit.

4. From the Edit menu, choose Edit Source.
The Edit Source dialog (Figure 11-25) displays the source code of the navigation model.

Figure 11-25 The Edit Source Dialog for a Navigation Model

5. Edit the code as required.
The XML syntax in the code is validated and an error message is displayed if you miss any tags or add them incorrectly. Validation is not provided for non-XML files.

You might prefer to copy the code from the dialog and paste it into an editor of your choice, for example, JDeveloper, where further validation can be performed. After editing the code, you can then copy it and paste it back into the Edit Source dialog.

Tip:

To make more full use of JDeveloper's capabilities for editing navigation models, you might prefer to download the navigation model from WebCenter Spaces and import it into JDeveloper for editing. For more information, see Section 11.2.5, "Using JDeveloper to Build Your Navigation Model."

6. Click OK.

11.2.3 Managing a Navigation Model

This section includes the following subsections:

- Section 11.2.3.1, "Showing and Hiding a Navigation Model"

- Section 11.2.3.2, "Setting Properties on a Navigation Model"

- Section 11.2.3.3, "Setting Security on a Navigation Model"

- Section 11.2.3.4, "Copying a Navigation Model"

- Section 11.2.3.5, "Deleting a Navigation Model"

11.2.3.1 Showing and Hiding a Navigation Model

When you create a navigation model, by default it is hidden. A hidden navigation model is not available for use in the application, the Home Space, or any other Space. To make a navigation model available, it must be marked as shown. Further, for a navigation model created at the application level, you can control whether it is available to any, all, or selected Spaces in the application.

For generic information about hiding and showing resources, see Section 10.4.3, "Showing and Hiding Resources."

For generic information about resource availability in Spaces, see Section 10.4.2, "Setting Properties on a Resource."

11.2.3.2 Setting Properties on a Navigation Model

You can control a navigation model's display attributes and availability by setting the model's properties in the Edit Properties dialog. Setting navigation model properties follows the same procedure as any other resource. For more information, see Section 10.4.2, "Setting Properties on a Resource."

To view the properties associated with a navigation model, use the About menu option.

11.2.3.3 Setting Security on a Navigation Model

You can control whether all users or only specific users or groups can access the navigation model that you created in your application or Space. Setting access to a navigation model follows the same procedure as any other resource. For more information, see Section 10.4.4, "Setting Security for a Resource."

11.2.3.4 Copying a Navigation Model

You can make a copy of a page template by selecting it and choosing Copy from the Edit menu on the Resources - Navigations page. Copying a navigation model follows the same procedure as any other resource. For more information, see Section 10.4.1, "Copying a Resource."

11.2.3.5 Deleting a Navigation Model

Provided you are assigned the required permissions, you can delete any custom navigation model. Deleting a navigation model follows the same procedure as deleting any other resource. For more information, see Section 10.4.5, "Deleting a Resource."

11.2.4 Selecting the Default Navigation Model

The default navigation model provides a convenient way to select the navigation model that is used by default at the application or Space level. Page template designers can then reference this default navigation model without having to know its actual name. For example, in navigation EL expressions, the default navigation model is often referenced, such as in:

#{navigationContext.defaultNavigationModel}

To specify the navigation model to use as the application-level default navigation model, perform the steps in Section 5.9, "Choosing a Default Navigation."

To specify a different navigation model to use as the default for a specific Space, perform the steps in Section 51.4.12, "Changing the Navigation for a Space."

11.2.5 Using JDeveloper to Build Your Navigation Model

You may want to create a navigation model that is beyond the editing capabilities of WebCenter Spaces. For example, using JDeveloper to create you navigation model enables you to use source control and also provides wizards and other tools to help you build more advanced navigation models. To do this, you have several options:

- Use the Edit Source option to edit the source code of the navigation model. You can edit the source code directly in the Edit Source dialog or you can copy the contents of the dialog to JDeveloper for editing and then copy the edited code back into the dialog. For more information, see Section 11.2.2.2, "Editing the Source Code of a Navigation Model."

- Download an existing WebCenter Spaces navigation model, import the navigation model into JDeveloper for editing, and then upload it back to WebCenter Spaces.

- Create a completely new navigation model in JDeveloper and upload it to WebCenter Spaces.

The steps to download and upload navigation models from WebCenter Spaces are described in Section 10.5, "Using JDeveloper to Build WebCenter Spaces Resources."

Oracle WebCenter provides a special JDeveloper workspace (DesignWebCenterSpaces.jws) for developing WebCenter Spaces resources, such as navigation models. The workspace offers a design environment in which to create and edit your navigation models, and also enables you to upload your navigation models to WebCenter Spaces for testing. For more information and to download the JDeveloper workspace, see the section "Developing WebCenter Spaces Resources" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

For information about specific considerations for creating navigation models for use in WebCenter Spaces, see the section "Working with WebCenter Spaces Navigation Models" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

11.3 Rendering Navigation in Your Portal

One of the key parts of a page template is the navigation visualization. This determines how the navigation looks and behaves in your portal. You can also add navigation visualization to a page, but typically you add it to a page template so that it can be defined in one place and propagated consistently across the whole portal.

This section includes the following subsections:

- Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates"

- Section 11.3.2, "Setting Navigation Task Flow Properties"

- Section 11.3.3, "Using JDeveloper to Visualize Your Navigation"

11.3.1 Adding Built-in Navigation Task Flows to Page Templates

WebCenter provides several built-in navigation task flows to enable you to quickly add navigation to your portal.

Note:

By default the Resource Catalog for pages does not include the built-in navigation task flows because the recommended method of providing navigation is through your page templates. If you want to be able to add the navigation task flows to a page, you must create a custom Resource Catalog that includes the task flows. For more information, see Section 16.2, "Creating Resource Catalogs."

Typically, you first add the desired task flow to the page template and then select the navigation model to use to drive the content of the navigation. This is the method described in this section. However, if you are using a custom Resource Catalog that includes navigation models, you can start by selecting the navigation model and then choosing which task flow to use to visualize that model. Navigation models are not included in the default page template Resource Catalog.

As well as the task flows described in this section, which you associate with navigation models, WebCenter Spaces also provides the Spaces Browser task flow, which you can use to enable users to navigate to different Spaces. For more information, see Section 51.16, "Working with the Space Task Flows."

Additional navigation task flows are available for download from Oracle Technology Network at:

http://www.oracle.com/technetwork/middleware/webcenter/samples-196325.zip

The zip file contains the following navigation task flows:

- List Navigation—Renders a navigation model in a vertical list format. Folders and their items are rendered as dropdown menus. Empty folders are not rendered.

- Menu with Links Navigation—Renders a navigation model in a horizontal menu format. For top level navigation items, folders are rendered as dropdown menus, navigable links with no children are rendered as a top level link. Empty folders are not rendered.

- Tree Navigation—Renders a navigation model in a vertical collapsed tree format.

Download the zip file and extract its contents locally. You can then upload one or more of the EAR files to your application, as described in Section 10.5.3, "Uploading a Resource." The task flows are then available in the Resource Catalog under Mash-Ups, Task Flows.

To add a built-in navigation task flow to a page template:

1. Open the page template in edit mode.
For more information, see Section 12.3, "Editing a Page Template."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that contains the built-in navigation task flows.

Tip:

The presence or location of this component depends on how the Resource Catalog is configured. For example, in the default Page Templates Resource Catalog, next to Template Development, click Open to expose a list that includes a Navigations folder. Click Open next to this folder to display the list of built-in navigation task flows.

4. Click Add next to the task flow that you want to add to your page.

5. Click Close to exit the Resource Catalog.

6. Hover the mouse over the task flow and, in the menu that pops up, click the Edit icon (wrench) for the task flow.

Tip:

Ensure that you click the Edit icon for the task flow and not the one for the region that contains the task flow.

7. In the Component Properties dialog, click the Parameters tab.

8. From the Navigation dropdown list, select the navigation model that you want to associate with the task flow.

9. Set any other properties as desired.
For information about the other properties available for the different navigation task flows, see Section 11.3.2, "Setting Navigation Task Flow Properties."

For some examples of the effects of these properties, see Section 11.3.2.3, "Using Properties to Configure Navigation Task Flow Instances."

10. Click OK.

11.3.2 Setting Navigation Task Flow Properties

The navigation task flows have associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 11-26).

Figure 11-26 Navigation Tree Task Flow - Component Properties

This section provides an overview of the navigation task flow properties and steps you through examples of configuring a task flow instance using property values. This section includes the following subsections:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Activity Graph service task flows and describe the properties on the Parameters tab:

- Section 11.3.2.1, "What You Should Know About Navigation Task Flow Properties."

- Section 11.3.2.2, "Navigation Task Flow Parameters"

- Section 11.3.2.3, "Using Properties to Configure Navigation Task Flow Instances."

11.3.2.1 What You Should Know About Navigation Task Flow Properties

When you set property values on a navigation task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 11.3.2.2, "Navigation Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. These properties are unique to the task flow type and are covered in this section. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

11.3.2.2 Navigation Task Flow Parameters

The following tables describe the parameters that are unique to each of the built-in navigation task flows.

Table 11-1 describes the parameters for the Navigation Breadcrumb task flow.

Table 11-1 Navigation Breadcrumb Task Flow Parameters

Parameter

Description

Display Style

Specifies whether to display breadcrumbs horizontally or vertically.

Navigation

The navigation model to associate with this task flow.

Show Root

Specifies whether to show the start node in the breadcrumbs.

Start Path

The level in the navigation model at which to start the navigation.

You can enter a path or an EL expression or click the Select Path icon to select the start node.

Valid values are:

- Start at the Currently Selected Page Path

- Start at This Level of the Currently Selected Page Path

- Select Page Path

For more information, see Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation."

Table 11-2 describes the parameters for the Navigation Menu task flow.

Table 11-2 Navigation Menu Task Flow Parameters

Parameter

Description

Navigation

The navigation model to associate with this task flow.

Second Level Style

The style for rendering the second level of navigation items.

Valid values are: Do Not Display, Tabs, Bar, Buttons, Choice, List

Notes:

- If the resource being rendered is non-navigable, for example, a folder, then it cannot be displayed as a tab, bar, button, choice, or list. It can be displayed only if the style Menu or Menu with Sub-Menus is selected.

- This property is available only if the Style property is not Menu or Menu with Sub-Menus.

Show Icons

Specifies whether to render icons for each resource.

Start Path

The level in the navigation model at which to start the navigation.

You can enter a path or an EL expression or click the Select Path icon to select the start node.

Valid values are:

- Start at the Currently Selected Page Path

- Start at This Level of the Currently Selected Page Path

- Select Page Path

For more information, see Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation."

Note: The Navigation Menu task flow is limited to showing a maximum of two levels of resources.

Style

The style for rendering the first level of resources.

Valid values are Tabs, Bar, Buttons, Choice, List, Menu, Menu with Sub-Menus

Notes:

- If the resource being rendered is non-navigable, for example, a folder, then it cannot be displayed as a tab, bar, button, choice, or list. It can be displayed only if the style Menu or Menu with Sub-Menus is selected.

- If a navigable item is rendered using the Menu with Sub-Menus style, the item is rendered twice, once as a dropdown menu, and once as a link to the item itself.

Table 11-3 describes the parameters for the Navigation Tree task flow.

Table 11-3 Navigation Tree Task Flow Parameters

Parameter

Description

Navigation

The navigation model to associate with this task flow.

Show Icons

Specifies whether to render icons for each resource.

Show Levels

The number of levels shown when the tree is initially rendered.

Valid values are:

- 1: Show top level nodes only; all other nodes are initially collapsed

- 2: Expand the first level of child nodes

- 3: Expand the second level of child nodes

- All: Expand all nodes

Note: This option applies only if the tree is rendered with the Style property set to Collapsed Tree. If the Style property is set to Expanded Tree then all nodes are shown expanded regardless of the value of this property.

Show Root

Specifies whether to render the start node in the tree.

Valid values are:

- Do Not Show Root: Do not render the start node

- Show Root: Render the start node

- Show Root As Box: Render the start node as the header in a box

Start Path

The level in the navigation model at which to start the navigation.

You can enter a path or an EL expression or click the Select Path icon to select the start node.

Valid values are:

- Start at the Currently Selected Page Path

- Start at This Level of the Currently Selected Page Path

- Select Page Path

For more information, see Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation."

Style

The style of the navigation.

Valid values are:

- Collapsed Tree: Render the given levels (as specified by the Show Levels property) as initially collapsed

- Expanded Tree: Render all tree nodes, expanded to show all children

- List: Render a flat list of top-level resources. If any of the top-level resources are folders, the content of those folders are provided in dropdown menus.
Note: Selecting the List option overrides the Show Levels and Show Root properties.

11.3.2.3 Using Properties to Configure Navigation Task Flow Instances

This section includes the following subsections:

- Section 11.3.2.3.1, "Sample Navigation Model"

- Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation"

- Section 11.3.2.3.3, "Rendering Navigation as a Tree"

- Section 11.3.2.3.4, "Rendering Navigation as a Menu"

- Section 11.3.2.3.5, "Rendering Navigation as Breadcrumbs"

- Section 11.3.2.3.6, "Linking Navigation Task Flows"

11.3.2.3.1 Sample Navigation Model

The following sections use examples based on the sample navigation model shown in Figure 11-27.

Figure 11-27 The Sample Navigation Model

11.3.2.3.2 Selecting the Start Path for Your Navigation

To select the start path for your navigation:

1. Create your navigation model, as described in Section 11.2, "Building a Navigation Model."

2. Add the Navigation Menu task flow to your application's page template, as described in Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."

3. In the Parameters tab of the Component Properties dialog, next to the Start Path field, click the Select Path icon.

4. In the Select Start Path dialog, select:

- Start at the Currently Selected Page Path to use the currently selected page as the starting point of the navigation. This populates the Start Path property with the following EL expression:

#{navigationContext.navigationModel['modelPath=path'].currentSelection.prettyUrl}

where path is the path to the navigation model XML file (omitting the trailing .xml), for example:

#{navigationContext.navigationModel['modelPath=/oracle/webcenter/portalapp/navigations/myNavigation'].currentSelection.prettyUrl}

In our banking application example, if this option is selected, when the user navigates to the Current Accounts page, the navigation looks as shown in Figure 11-28.

Figure 11-28 Start at the Currently Selected Page Path

- Start at This Level of the Currently Selected Page Path to use the nth level of the path to the currently selected page as the starting point of the navigation (where n is the number specified in the field next to this option). This populates the Start Path property with the following EL expression:

#{navigationContext.navigationModel['modelPath=path'].currentSelection.prettyUrlPath[level]}

where path is the path to the navigation model XML file (omitting the trailing .xml) and level is the number specified in the field.

In our banking application example, if this option is selected with the value of 1, when the user navigates to the Personal Banking page, and then the Current Accounts page, the navigation starts at the first level of this path, that is, Personal Banking (Figure 11-29).

Figure 11-29 Start at Specified Level of the Currently Selected Page Path

- Select Page Path to use a specific page as the starting point of the navigation. This populates the Start Path property with the path to the selected page.

11.3.2.3.3 Rendering Navigation as a Tree

To render your navigation model as a tree:

1. Create your navigation model, as described in Section 11.2, "Building a Navigation Model."

2. Add the Navigation Menu task flow to your application's page template, as described in Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."

3. Select the Start Path for the navigation when it is rendered on the page, as illustrated in Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation."

4. From the Show Levels dropdown list, select how many levels to expand when the tree is initially rendered with the Collapsed Tree style.

Note:

If the navigation is rendered using the Expanded Tree style, this option is ignored and the navigation is rendered will all nodes fully expanded.

5. From the Show Root dropdown list, select whether to display the start node in the tree.
For example, if the start node is Current Account, select:

- Show Tree Root to include the Current Account node in the tree (Figure 11-30).

Figure 11-30 Show Tree Root

- Do Not Show Root to not include the Current Account node (Figure 11-31).

Figure 11-31 Do Not Show Root

- Show Root As Box to include the Current Account node as the header of a box that contains the rest of the navigation(Figure 11-32).

Figure 11-32 Show Root As Box

6. From the Style dropdown list, select what style to use for the tree.

- Collapsed Tree displays the tree initially collapsed according to the levels specified by the Show Levels property.

- Expanded Tree displays the tree with all levels completely expanded.

- List displays the tree as a flat list of the top-level resources. If any of the top-level resources are folders, they are displayed as dropdown menus that display the contents of the folders.
Using our banking example, if the start node is Personal Banking, a tree navigation with the List style looks like Figure 11-33.

Figure 11-33 List Style Tree with No Folders

However, if the start node is Current Account (which contains two folders), it looks like Figure 11-34.

Figure 11-34 List Style Tree with Folders

7. Select Show Icons to display the icons associated with the navigation items in the tree (Figure 11-35).

Figure 11-35 Show Icons

11.3.2.3.4 Rendering Navigation as a Menu

To render your navigation model as a menu:

1. Create your navigation model, as described in Section 11.2, "Building a Navigation Model."

2. Add the Navigation Menu task flow to your application's page template, as described in Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."

3. Select the Start Path for the navigation when it is rendered on the page, as illustrated in Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation."

4. From the Style dropdown list, select how you want to display the first level of navigation items in the menu. Using our sample banking application, we can illustrate the different options for this property:

- Tabs

Figure 11-36 Tabs Menu Navigation Style

- Bar

Figure 11-37 Bar Menu Navigation Style

- Buttons

Figure 11-38 Buttons Menu Navigation Style

- Choice

Figure 11-39 Choice Menu Navigation Style

- List

Figure 11-40 List Menu Navigation Style

- Menu

Figure 11-41 Menu Navigation Style

5. From the Second Level Style dropdown list, select the style to use for the second level of resources in the navigation.

Note:

Menu navigations can render only two levels of resources.

6. Select Show Icons to display the icons associated with the navigation items in the menu.

11.3.2.3.5 Rendering Navigation as Breadcrumbs

To render your navigation model as breadcrumbs:

1. Create your navigation model, as described in Section 11.2, "Building a Navigation Model."

2. Add the Navigation Menu task flow to your application's page template, as described in Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."

3. Select the Start Path for the navigation when it is rendered on the page, as illustrated in Section 11.3.2.3.2, "Selecting the Start Path for Your Navigation."

4. Select Show Root to display the start node in the breadcrumbs.

5. From the Display Style dropdown list, select whether to display the breadcrumbs vertically or horizontally, for example Figure 11-42 shows breadcrumbs displayed horizontally.

Figure 11-42 Horizontal Breadcrumbs

Figure 11-43 shows breadcrumbs displayed vertically.

Figure 11-43 Vertical Breadcrumbs

11.3.2.3.6 Linking Navigation Task Flows

You may want to include more than one area of navigation in your portal. For example, you might want to include tabs along the top of the page, displaying the top level of your navigation model, and a second tree structure down the side of the page. You can link the navigation task flows together so that the tree navigation reflects the selected navigation item in the tabbed menu.

The following procedure shows how to do this using our banking example.

To link navigation task flows:

1. Create your navigation model, as described in Section 11.2, "Building a Navigation Model."

2. Add the Navigation Menu task flow to a region along the top of your application's page template, as described in Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."

3. Add the Navigation Tree task flow to a region along the side of your application's page template, as described in Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."

4. Hover the mouse over the Navigation Menu task flow and, in the menu that pops up, click the Edit icon (wrench) for the task flow.

Tip:

Ensure that you click the Edit icon for the task flow and not the one for the region that contains the task flow.

5. In the Component Properties dialog, click the Parameters tab.

6. From the Navigation dropdown list, select the desired navigation model, or enter an EL expression.

7. In the Start Path parameter, enter / to start at the root of the navigation model.

8. From the Style dropdown list, select Tabs.

9. From the Second Level Style dropdown list, select Do Not Display.
This restricts this part of the navigation to display only the top level of the navigation model. The rest of the navigation model is displayed in the tree navigation.

10. Click OK.

11. Hover the mouse over the Navigation Tree task flow and, in the menu that pops up, click the Edit icon (wrench) for the task flow.

Tip:

Ensure that you click the Edit icon for the task flow and not the one for the region that contains the task flow.

12. In the Component Properties dialog, click the Parameters tab.

13. From the Navigation dropdown list, select the same navigation model as is used for the Navigation Menu task flow, or enter the same EL expression.

14. Next to the Start Path field, click the Select Path icon.

15. In the Select Start Path dialog, select Start at the Currently Selected Page Path and click OK.
This ensures that the tree navigation displays the navigation for whatever has been selected in the menu navigation.

16. From the Show Root dropdown list, select Do Not Show Root.
The root of the navigation model is displayed in the tabs at the top of the page, so there is no need to duplicate it here.

17. Click OK.

18. Save and close the page template.
Figure 11-44 shows how the above procedure might work for our banking example. Selecting the Personal Banking tab at the top of the page displays the rest of the navigation model (from Personal Banking down) on the side of the page.

Figure 11-44 Linking Navigation Task Flows

11.3.3 Using JDeveloper to Visualize Your Navigation

The navigation task flows provided by WebCenter Spaces enable you to quickly visualize your navigation in your application. However, you may find that these task flows do not quite match your navigation requirements. If you find this is the case, you can use JDeveloper to edit the page templates you create in WebCenter Spaces and add the navigation UI directly to the templates using the navigation EL APIs provided by WebCenter. You can then upload these edited page templates back into WebCenter Spaces. You can also create your page templates entirely in JDeveloper before uploading them to WebCenter Spaces. The WebCenter Spaces seeded page templates were created in this way.

The steps to download and upload page templates from WebCenter Spaces are described in Section 10.5, "Using JDeveloper to Build WebCenter Spaces Resources."

For information about specific considerations for creating page templates for use in WebCenter Spaces, see the section "How to Create and Manage WebCenter Spaces Page Templates" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

For information about how to programmatically add navigation UI to your page templates using JDeveloper, see the section "Programmatically Adding Navigation to a Page Template" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

11.4 AviTrust Employee Portal: An Example of Delegated Navigation

AviTrust is a fictional financial organization that uses Oracle WebCenter for both its external facing web site and its internal employee portal.

The AviTrust employee portal is created using WebCenter Spaces (Figure 11-45).

Figure 11-45 The AviTrust Employee Portal Home Page

The AviTrust employee portal consists of a single Space containing several Subspaces. Some of these Subspaces in turn have their own Subspaces (Figure 11-46).

Figure 11-46 Structure of the AviTrust Employee Portal

To provide navigation around the portal, the administrator could create a single navigation model and maintain complete control over the structure and content. However, as the Subspaces are each maintained by individual department representatives, the administrator is probably not the best person to determine the navigation that is required through those Subspaces; the department representatives are much more familiar with the content. Rather than have multiple users attempting to update the same navigation model, the administrator can create several navigation models: one for the main navigation, and one for each of the different Subspaces. Each of the Subspace navigation models includes only those navigation items applicable to that particular area of the portal. The main navigation model can then include the Subspace navigation models by reference.

For example, the Banking navigation model includes a list of the pages within the Banking Subspace and a list of its Subspaces (East Coast, West Coast, DC Branch, NY Branch, and Boston Branch). These navigation items are then included in the main navigation model by referencing the Banking navigation model (Figure 11-47).

Figure 11-47 Structure of the AviTrust Employee Portal Navigation

Delegating the design of the navigation model in this way means that the department representatives can determine the navigation within their own specific areas of the portal, leading to more meaningful structure and removing the bottleneck of a single navigation model or a single navigation designer.

The following example steps through the process performed by the portal administrator and department representatives to create the navigation for the AviTrust Employee Portal.

Note:

While this example assumes the existence of a partially constructed AviTrust Employee Portal, it is still possible to go through it by creating any portal with the structure shown in Figure 11-46.

To create the navigation for the AviTrust employee portal:

1. Log in to the AviTrust Employee Portal as an administrator.

2. Click the Administration link.

3. Click the Resources tab.

4. In the left panel of the Resources Manager, click Navigations.

5. Click Create to create a new navigation model.

6. In the Create New Navigation dialog, in the Name field, enter AviTrust Intranet Navigation Model.

7. In the Description field, enter Main navigation model for the AviTrust Employee Portal.

8. Leave the Copy From dropdown list empty to create the navigation model from scratch.
Figure 11-48 shows the completed dialog.

Figure 11-48 Create the Main AviTrust Navigation Model

9. Click Create.
This is the main, top-level navigation model for the portal.

10. Next you must create the navigation models for individual departments represented in the portal.
Each of these navigation models must be created at the Subspace level, this is so that the appropriate departmental representatives can manage them.

11. First, let's create the navigation model for the HR department.
Go to the Human Resources Subspace.

12. Display the Space administration pages.

Note:

The way you access the Space administration pages depends on the page template in use. For example, in a top navigation template, you may access Space administration pages through a Manage menu.
You can also navigate to these pages using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

13. Click the Resources tab.

14. In the left panel of the Resources Manager, click Navigations.

15. Click Create to create a new navigation model.

16. Create a navigation model for the HR department with the following details:

- Name: HRNav

- Description: Navigation model for the HR Subspace

- Copy From: Leave blank

17. Next, let's create the navigation model for the Banking department.
Go to the Banking Subspace.

18. Display the Space administration pages.

Note:

The way you access the Space administration pages depends on the page template in use. For example, in a top navigation template, you may access Space administration pages through a Manage menu.
You can also navigate to these pages using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

19. Click the Resources tab.

20. In the left panel of the Resources Manager, click Navigations.

21. Click Create to create a new navigation model.

22. Create a navigation model for the Banking department with the following details:

- Name: BankingNav

- Description: Navigation model for the Banking Subspace

- Copy From: Leave blank

23. The next step is to design the navigation models for the individual Subspaces.

Note:

When implementing delegated navigation development, the following steps would be performed by the moderators of the Subspaces. However, for the purposes of this example, we will continue through the steps as the administrator.

24. With the new Banking navigation model selected, click the Edit menu, and then choose Edit.

25. The Banking navigation model includes a list of the pages within the Subspace. To do this, you can add a Pages Query navigation item.
In the Edit - BankingNav Model dialog, click the Add menu and choose Pages Query.

26. In the Edit Navigation Item - Pages Query dialog, in the Name field, enter Banking Pages.

27. In the Description field, enter List of pages in the Banking Subspace.

28. In the Find Pages in radio group, make sure that Space is selected because we want to list the pages in a Space (the Banking Subspace).
The Banking Subspace is already specified in the adjacent field.

29. From the Visibility dropdown list, select Show only visible items, to ensure that any hidden pages are not included in the navigation.

30. Select Hide Top-Level Folder so that the pages are listed directly, rather than under a folder for the Space.
Figure 11-49 shows the completed dialog.

Figure 11-49 The Pages Query in the AviTrust HR Navigation Model

31. Click OK.

32. The Banking Subspace also contains several Subspaces that should be listed in the navigation model. To do this, you can add a Spaces Query navigation item.
In the Edit - BankingNav dialog, click the Add menu and choose Spaces Query.

33. In the Edit Navigation Item - Spaces Query dialog, in the Name field, enter Banking Spaces Query.

34. In the Description field, enter List of Subspaces in the Banking Subspace.

35. Next to the Visible field, click the Expression Builder icon, and then choose Expression Builder.

36. Select Type a value or expression, and enter the following EL expression in the field:

#{!empty spaceContext.currentSpace}

This means that the Subspace is visible when the navigation model is rendered, only if the Subspace is not empty.

37. Next to the Space field, click the Select Space icon.

38. In the Select Space dialog, select Banking and click OK.

39. Select Hide Top-Level Folder so that the Subspaces are listed directly, rather than under a folder for the Space.
Figure 11-50 shows the completed dialog.

Figure 11-50 The Subspaces Query in the AviTrust Banking Navigation Model

40. Click OK.

41. Click the Preview tab to check that the Banking pages and Subspaces are listed (Figure 11-51).

Figure 11-51 Preview of the AviTrust Banking Navigation Model

42. Click OK.

43. With the navigation model still selected, click the Edit menu and then choose Show.
This makes the navigation model available to use in your application.

44. Now, lets design the HR navigation model.

Note:

Again, for real delegated navigation development, the following steps would be performed by the Space moderator.

Go to the Human Resources Subspace.

45. Display the Space administration pages.

Note:

The way you access the Space administration pages depends on the page template in use. For example, in a top navigation template, you may access Space administration pages through a Manage menu.
You can also navigate to these pages using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

46. Click the Resources tab.

47. In the left panel of the Resources Manager, click Navigations.

48. Select HRNav, click the Edit menu, and then choose Edit.

49. The HR navigation model consists of a list of the pages within the HR Subspace. To do this, as with the Banking navigation model, you can add a Pages Query navigation item.
In the Edit - HRNav Model dialog, click the Add menu and choose Pages Query.

50. In the Edit Navigation Item - Pages Query dialog, in the Name field, enter HR Pages.

51. In the Description field, enter List of pages in the HR Subspace.

52. In the Find Pages in radio group, make sure that Space is selected because we want to list the pages in a Space (the HR Subspace).
The HR Subspace is already specified in the adjacent field.

53. From the Visibility dropdown list, select Show only visible items, to ensure that any hidden pages are not included in the navigation.

54. Select Hide Top-Level Folder so that the pages are listed directly, rather than under a folder for the Space.
Figure 11-52 shows the completed dialog.

Figure 11-52 The Pages Query in the AviTrust HR Navigation Model

55. Click OK.

56. Click the Preview tab to check that the Human Resources pages are listed (Figure 11-53).

Figure 11-53 Preview of the AviTrust HR Navigation Model

57. Now that you have created and populated the department-level navigation models, you can move on to the main navigation model.
Click the Back to the Space link.

58. Click the Administration link.

59. Click the Resources tab.

60. In the left panel of the Resources Manager, click Navigations.

61. Select the AviTrust Intranet Navigation Model.

62. Click the Edit menu, and then choose Edit.

63. First, let's add a link to the home page of the portal.
In the Edit - AviTrust Intranet Navigation Model dialog, click the Add menu and choose Link.

64. In the Edit Navigation Item - Link dialog, in the Name field, enter Home.

65. In the Description field, enter Link to the AviTrust Employee Portal home page.

66. In the Path field, enter the path of the portal home page, for example:

page://oracle/webcenter/page/scopedMD/s730ab705_4b08_438c_ab2a_7ad3b3b0fcf1/
PortalSiteHome.jspx

Figure 11-54 shows the completed dialog.

Figure 11-54 The Home Link in the AviTrust Main Navigation Model

67. Click OK.

68. Next, the navigation model should link to the home page of the HR Subspace.

Click the Add menu and choose Link.

69. In the Edit Navigation Item - Link dialog, in the Name field, enter Human Resources.

70. In the Description field, enter Link to the HR Subspace home page.

71. In the Path field, enter the path of the HR Subspace home page, for example:

page://oracle/webcenter/page/scopedMD/s712f1d65_900c_418e_be91_b40b27617b47/
Page4.jspx

72. Click OK.

73. Now, add the reference to the HR navigation model to include it in the main navigation model.

Click the Add menu and choose Navigation Reference.

74. In the Edit Navigation Item - Navigation Reference dialog, in the Name field, enter Human Resources Navigation Reference.

75. In the Description field, enter Embedded HR navigation model.

76. Next to the Include Navigation dropdown list, click the Expression Builder icon, then choose Expression Builder.

77. In the Expression Editor dialog, select Type a value or expression.

78. In the field below, enter the path to the HR navigation model, for example:

/oracle/webcenter/siteresources/scopedMD/s712f1d65_900c_418e_be91_b40b27617b47/
navigation/gsr10267cfe_95d0_49df_bca4_1da5f9094082/Navigation.xml

Tip:

To obtain the path of the navigation model, select it in the Resource Manager for the HR Subspace, choose Edit Properties from the Edit menu, and then copy the value from the Metadata File field.

Figure 11-55 shows the completed dialog.

Figure 11-55 The Expression to Identify the HR Navigation Model

79. Click OK to return to the Edit Navigation Item - Navigation Reference dialog.
Figure 11-56 shows the completed dialog.

Figure 11-56 The Navigation Reference to the HR Navigation Model

80. Click OK.

81. Click the Indent icon to move the navigation reference under the HR home link.

82. Repeat steps 68 to 72 to add a link to the Banking home page.

83. Repeat steps 73 to 80 to add a navigation reference to the Banking navigation model

84. Indent the Banking navigation reference under the Banking home link.

85. Repeat steps 68 to 72 to add a link to the Insurance home page.

86. Click the Preview tab to check the main navigation model (Figure 11-57).

Figure 11-57 Preview of the Main AviTrust Navigation Model

87. Click OK.

88. With the navigation model still selected, click the Edit menu and then choose Show.
This makes the navigation model available to use in your application.

89. The next step would be to visualize this navigation within the portal, typically by adding some navigation UI to your portal's page template.
For more information about visualizing portal navigation, see Section 11.3, "Rendering Navigation in Your Portal."

12 Working with Page Templates

Out-of-the-box, WebCenter Spaces is pre-configured with a range of page templates that users can apply to Spaces and pages. Portal designers can change out-of-the-box page templates and create brand new ones to achieve a look, feel, and layout that suits their organization.

This chapter describes how to create, edit, and apply page templates in WebCenter Spaces. It contains the following sections:

- Section 12.1, "What You Should Know About Page Templates"

- Section 12.2, "Creating a Page Template"

- Section 12.3, "Editing a Page Template"

- Section 12.4, "Customizing a Page Template for a Space"

- Section 12.5, "Managing a Page Template"

- Section 12.6, "Applying a Page Template to a Space"

- Section 12.7, "Choosing the Page Template Resource Catalog"

- Section 12.8, "Using JDeveloper to Build Your Page Templates"

Portal designers with advanced layout requirements can use development tools, such as JDeveloper, to build page templates and upload them to WebCenter Spaces.

For generic information about adding and editing different types of resources, see Chapter 10, "Working with the Resources that Compose a Portal or Community."

Audience

This chapter is intended for portal designers with the application permission Application-Page Templates-Create, Edit, and Delete.

To build page templates for a particular Space, you need the permission Space-Resources-Create, Edit, and Delete Resources (standard permission model) or Space-Page Templates-Create, Edit, and Delete Page Templates (advanced permission model).

See Also:

For information about roles and permissions, see Chapter 20, "Understanding WebCenter Spaces Security."

12.1 What You Should Know About Page Templates

In WebCenter Spaces, page templates define how individual pages and groups of pages display on a user's screen. When you use page templates to display pages, the pages are always consistent in structure and layout across the application.

A typical page template, shown below, defines the following:

1. Header on top of the page

2. Navigation structure at the top of the page, or in a sidebar, to link to important targets

3. Page content area

4. Footer at the bottom of the page

Everything that surrounds the "page content" area is referred to as the page template.

Figure 12-1 Page Template - Basic Structure

Just like other WebCenter Spaces resources, portal designers can build page templates that are available to the whole application (application-level resources) and page templates that are scoped to a particular Space (Space-level resources).

Note:

If you create a page template at the Space level, the template is available only to that Space and not to any Subspaces beneath it. To make a page template available to a Space and all its Subspaces, the template must be created at the application level.

See Also:

For more information about page templates, see the section "Using Page Templates" in the Oracle Fusion Middleware Web User Interface Developer's Guide for Oracle Application Development Framework.

12.1.1 Out-of-the-Box Page Templates

WebCenter Spaces provides several out-of-the-box page templates:

- Fusion Side Navigation
The navigation panel is on the left side of the page. The main content area is stretched to fill all the available space.

- Fusion Top Navigation
The navigation panel is above the main content area. The main content area is stretched to fill all the available space.

- WebCenter Public-Pages Template
The default page template for WebCenter Spaces public pages.

- WebCenter Spaces Side Navigation
The navigation panel is on the left side of the page. The size of every component in the main content area is calculated based on the size of its children.

- WebCenter Spaces Top Navigation
The navigation panel is above the main content area. The size of every component in the main content area is calculated based on the size of its children.

You cannot directly edit or customize any of the out-of-the-box page templates listed here. If you want to exclude or display different content within one of these page templates, you must make a copy of the template, and then make changes to your copy rather than the original version.

12.2 Creating a Page Template

When you create a page template, you use an existing page template as the starting point for the new page template.

To create a page template:

1. Navigate to the Resources page of your application or the Space in which you want to create the page template, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Page Templates.

3. On the menu bar, click Create.

4. In the Create New Page Template dialog, in the Name field, enter a name for the page template.

Figure 12-2 The Create New Page Template Dialog

5. In the Description field, enter a description for the page template.
The description is displayed below the name in the Resources page and as a tool tip when selecting a page template. You should ensure that the description helps page designers determine if they want to use this particular page template.

6. From the Copy from dropdown list, select an existing page template to use as the starting point for your new page template.

Tip:

You can also create a copy of an existing page template by selecting the existing page template on the Resources page, clicking Edit and then Copy on the menu bar, and providing a name and description for the new page template.

7. Click Create.
The newly created page template is listed on the Resources page. The gray circle icon next to the page template indicates that it is not yet published and hence is not available to other users. For information about publishing a page template, see Section 10.4.3, "Showing and Hiding Resources."

12.3 Editing a Page Template

When you create a new page template, you copy an existing page template. To turn this copy into the page template that you want, you must edit it by using Oracle Composer or by editing the source code to change the layout and content of the page template as desired.

This section includes the following subsections:

- Section 12.3.1, "Editing a Page Template in Oracle Composer"

- Section 12.3.2, "Editing the Source Code of a Page Template"

12.3.1 Editing a Page Template in Oracle Composer

The most common way of editing a page template is to use Oracle Composer.

To edit a page template in Oracle Composer:

1. Navigate to the Resources page of your application or the Space that contains the page template that you want to edit, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Page Templates.

3. In the main panel, select the page template that you want to edit.

4. From the Edit menu, choose Edit.
This opens the page template in Oracle Composer where you can edit its layout and content.

5. Within Oracle Composer, choose whether to work in Design view or Source view:

- Design view provides a WYSIWYG rendering of the page template, where controls are directly selectable on each component.

- Source view provides a combined WYSIWYG and hierarchical rendering of page template components, where controls are available on the header of the hierarchical list. You can specify whether to present the page template source on the top, bottom, left, or right of the WYSIWYG portion of the page template.

6. Your page template must include at least one content region. You can create new content regions in the page template by clicking one of the Add Box icons in an existing region. This process is very similar to adding content regions to a page. For more information, see Section 17.3.5.4, "Adding New Content Regions."

7. Aside from the main content area, the other main feature of a page template is the navigation area. The navigation area of a page provides access to the rest of the portal. WebCenter Spaces provides several task flows for providing navigation within your portal, you can add these task flows anywhere within the page template. For more information, see Section 11.3.1, "Adding Built-in Navigation Task Flows to Page Templates."
If these task flows do not quite meet your requirements for navigation, you must develop your page template further in JDeveloper. You can create the main structure for your page template in WebCenter Spaces and then download it for importing into JDeveloper, or you can create the page template entirely in JDeveloper and then upload it into WebCenter Spaces. For more information, see Section 12.8, "Using JDeveloper to Build Your Page Templates."

8. You can add content to a page template by adding components from the Resource Catalog. The catalog is a gateway to a wide range of task flows, portlets, layout components, and other types of resources.
Authorized users can create custom Resource Catalogs and add any variety of the available resources. This means the content of a given Resource Catalog is dependent on the person who designed the catalog. In addition, the Resource Catalog available to application-level page templates may be different from that available for Space-level page templates. For more information about Resource Catalogs, including how to create custom Resource Catalogs and how to configure which Resource Catalog to use for page templates, see Chapter 16, "Working with Resource Catalogs."

To add a component from the Resource Catalog, click the Add Content icon in the region to which you want to add the component. Again, the process is very similar to adding components to a page. For more information, see Section 17.5, "Adding Resource Catalog Components to Pages."

9. WebCenter Spaces provides a range of reusable components that you can add to your page templates. You can customize attributes such as text, label, inlinestyle, and so on, to change the look and feel to suit your page template.

Note:

Oracle does not recommend that you modify values for attributes such as id, action, actionListener, destination, because these properties impact the functionality of the component.

Table 12-1 lists all the WebCenter Spaces components that are available. For more information about each of these components, see Chapter 13, "Adding Spaces Components to Your Templates."

Table 12-1 Reusable WebCenter Spaces Components

A to Create Sp

Create Su to I

J to P

R to U

About Space

Create Subspace

Join Space

RSS

About WebCenter

Current User Profile

Leave Space

Search

Add to Favorites

Edit Page

Login

Self Registration

Administration

Email Members

Logout

Share Resource

Change Membership

Email Space Moderators

Manage Pages

Spaces Switcher

Contact Administration

Favorites Menu

Page Links

Status Indicator

Copyright Message

Global Help

Parent Space

Subscription Preferences

Create Page

Home Space

Print Preview

Tags

Create Space

Invite People as Connection

Privacy URL

User Preferences

10. When you have finished editing the page template, click Save and then Close.

12.3.2 Editing the Source Code of a Page Template

If you prefer working in source code, you can use the Edit Source option.

To edit the source code of a page template:

1. Navigate to the Resources page of your application or the Space that contains the page template that you want to edit, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Structure, select Page Templates.

3. In the main panel, select the page template that you want to edit.

4. From the Edit menu, choose Edit Source.
The Edit Source dialog (Figure 12-3) displays the source code of the page template.

Figure 12-3 The Edit Source Dialog for a Page Template

5. Edit the code as required.
The XML syntax in the code is validated and an error message is displayed if you miss any tags or add them incorrectly. Validation is not performed for non-XML files.

You might prefer to copy the code from the dialog and paste it into an editor of your choice, for example, JDeveloper, where further validation can be performed. After editing the code, you can then copy it and paste it back into the dialog.

Note:

To make more full use of JDeveloper's capabilities for editing page templates, you might prefer to download the page template from WebCenter Spaces and import it into JDeveloper for editing. For more information, see Section 12.8, "Using JDeveloper to Build Your Page Templates."

6. Click OK.

12.4 Customizing a Page Template for a Space

Page templates created at the application level can also be used in Spaces. For example, a portal designer may create several corporate page templates for use in Spaces throughout the application. However, you may find that for a particular Space, the application-level page template does not quite work and needs a bit of fine tuning.

You could create a copy of the page template within your Space and make the changes you require. However, as soon as you create the copy, the new page template is completely separate from the original. Any changes made to the original template are not cascaded down to your copy.

Alternatively, within your Space you can customize the application-level page template. The customizations you make apply only to the Space in which you perform them. However, the connection to the original page template is retained, so any changes made at the application level are automatically cascaded down to the page template at the Space level.

To customize a page template:

1. Navigate to the Resources page of the Space that contains the page template that you want to edit, as described in Section 10.1.4.2, "Accessing Space-Level Resources."

Note:

You can customize page templates only at the Space level. You cannot customize page templates at the application level.

2. In the left navigation panel, under Structure, select Page Templates.

3. In the main panel, select the page template that you want to customize.

4. From the Edit menu, choose Customize.

5. Customize the page template as required.

6. When you have finished customizing the page template, click Save and then Close.

12.5 Managing a Page Template

This section includes the following subsections:

- Section 12.5.1, "Showing and Hiding a Page Template"

- Section 12.5.2, "Setting Properties on a Page Template"

- Section 12.5.3, "Setting Security on a Page Template"

- Section 12.5.4, "Copying a Page Template"

- Section 12.5.5, "Deleting a Page Template"

- Section 12.5.6, "Previewing a Page Template"

12.5.1 Showing and Hiding a Page Template

When you create a page template, by default it is hidden. A hidden page template is not available for use in the application, the Home Space, or any other Space. To make a page template available, it must be marked as shown. Further, for a page template created at the application level, you can control whether it is available to any, all, or selected Spaces in the application.

For generic information about hiding and showing resources, see Section 10.4.3, "Showing and Hiding Resources."

For generic information about resource availability in Spaces, see Section 10.4.2, "Setting Properties on a Resource."

12.5.2 Setting Properties on a Page Template

You can control a page template's display attributes and availability by setting the template's properties in the Edit Properties dialog. Setting page template properties follows the same procedure as any other resource. For more information, see Section 10.4.2, "Setting Properties on a Resource."

To view the properties associated with a page template, use the About menu option.

12.5.3 Setting Security on a Page Template

You can control whether all users or only specific users or groups can access the page template that you created in your application or Space. Setting access to a page template follows the same procedure as any other resource. For more information, see Section 10.4.4, "Setting Security for a Resource."

12.5.4 Copying a Page Template

You can make a copy of a page template by selecting it and choosing Copy from the Edit menu on the Resources - Page Templates page. Copying a page template follows the same procedure as any other resource. For the generic procedure, see Section 10.4.1, "Copying a Resource."

12.5.5 Deleting a Page Template

Provided you are assigned the required permissions, you can delete any custom page template. Deleting a page template follows the same procedure as deleting any other resource. For more information, see Section 10.4.5, "Deleting a Resource."

12.5.6 Previewing a Page Template

WebCenter Spaces provides a means of previewing a page template, so that you can see what it looks like while still within the Resources page, enabling you to make adjustments quickly, if required. Previewing a page template follows the same procedure as previewing other resources. For more information, see Section 10.4.6, "Previewing a Resource."

12.6 Applying a Page Template to a Space

When you create a Space, the Space inherits the page template defined for the Space template that you choose for the Space.

Note:

If the Space template does not specify that a particular page template must be used, the Space uses the default page template specified by the WebCenter Spaces administrator. See Section 5.8, "Choosing a Default Page Template."

If you are the Space moderator, or have Manage Configuration permission on a Space, you can optionally select a different page template for the Space. This overrides the Space template setting and the application setting. For more information, see Section 51.4.9, "Changing the Page Template for a Space."

12.7 Choosing the Page Template Resource Catalog

The Resource Catalog used by a page template determines which components can be added to the page template.

WebCenter Spaces provides a Default Page Template Catalog that includes the most commonly required components for page templates. Authorized users can create custom Resource Catalogs for use by page templates. For more information, see Chapter 16, "Working with Resource Catalogs."

By default, a Space uses the page template Resource Catalog set by the WebCenter Spaces administrator for all Spaces in the entire application. However, you can override this setting at the Space level.

- For information about setting the page template Resource Catalog at the application level, see Section 5.8, "Choosing a Default Page Template."

- For information about setting the page template Resource Catalog at the Space level, see Section 51.4.11, "Changing the Resource Catalogs for Pages and the Page Template for a Space."

12.8 Using JDeveloper to Build Your Page Templates

In the majority of cases, you are likely to want to create a page template that is beyond the editing capabilities of WebCenter Spaces. Specifically, to add more complex navigation UI than is available through the built-in navigation task flows, you will need to add the navigation UI programmatically. To do this, you have several options:

- Use the Edit Source option to edit the source code of the page template. You can edit the source code directly in the Edit Source dialog or you can copy the contents of the dialog to JDeveloper for editing and then copy the edited code back into the dialog. For more information, see Section 12.3.2, "Editing the Source Code of a Page Template."

- Download an existing WebCenter Spaces page template, import the page template into JDeveloper for editing, and then upload it back to WebCenter Spaces.

- Create a completely new page template in JDeveloper and upload it to WebCenter Spaces.

The steps to upload and download page templates from WebCenter Spaces are described in Section 10.5, "Using JDeveloper to Build WebCenter Spaces Resources."

Oracle WebCenter provides a special JDeveloper workspace (DesignWebCenterSpaces.jws) for developing WebCenter Spaces resources, such as page templates. The workspace offers a design environment in which to create and edit your page templates, and also enables you to upload your page templates to WebCenter Spaces for testing. For more information and to download the JDeveloper workspace, see the section "Developing WebCenter Spaces Resources" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

As mentioned earlier, specifically for page template, you might find that the functionality for visualizing portal navigation provided within WebCenter Spaces is not complex enough for the navigation that you want to expose in your application. Using JDeveloper, you can visualize a much more complex navigation UI in your page template, using ADF navigation components and EL expressions. For more information, see the chapter "Visualizing Your Portal Navigation" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

13 Adding Spaces Components to Your Templates

Spaces components are prepackaged, fully functional application widgets or tags, such as menus and links, that are available for adding to pages and, most notably, to page templates. Each component provides a ready-to-go piece of the WebCenter Spaces user interface (UI).

As an application administrator or Space moderator, you can include one or multiple Spaces components in custom Resource Catalogs. In turn, authorized users can add them from the catalog to a page template or a page.

See Also:

Many of the components discussed in the chapter are included out-of-the-box in the default Resource Catalogs provided for template development. For information about how to add resources to a custom Catalog, see Section 16.3.1.2, "Adding Resources."

This chapter provides an overview of available components, directs you to information about adding and removing components, and lists and describes component properties. It includes the following sections:

- Section 13.1, "Making Spaces Components Available"

- Section 13.2, "Working with Spaces Component Properties"

- Section 13.3, "Deleting Spaces Components"

Audience

This chapter is intended for administrator-level users who are granted the permissions Resource Catalogs: Create, Edit, and Delete Resource Catalogs and, minimally, Page Templates: Create Page Templates, Edit Page Templates.

See Also:

For information about creating custom page templates through Oracle JDeveloper, see "Working with Page Templates," in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

13.1 Making Spaces Components Available

You may need to take some preliminary steps to ensure that Spaces components are available for placement on your pages and page templates. This section provides an overview of the preliminary steps that may be required before you can start working with these components.

This section includes the following subsections:

- Section 13.1.1, "Adding Spaces Components to a Resource Catalog"

- Section 13.1.2, "Specifying the Resource Catalogs to Use for Space and Page Templates"

- Section 13.1.3, "Adding Spaces Components to a Template"

- Section 13.1.4, "Adding Spaces Components to a Page"

13.1.1 Adding Spaces Components to a Resource Catalog

Spaces components are like any other resource you would add to a Resource Catalog. (For information about adding resources to the Resource Catalog, see Section 16.3.1.2, "Adding Resources.") In the library of components that provides resources for building a custom Resource Catalog, many of these components are grouped under the Spaces Components category (Figure 13-1).

Figure 13-1 Spaces Components in the Add Resource Catalog Item Dialog

The balance of these components are available by default out-of-the-box in the Default Page Template Catalog that is provided for page template development. In this default catalog, you can find Spaces components under the folder Template Development—though keep in mind that Resource Catalog folder names can be customized, and so may be renamed (Figure 13-2).

Figure 13-2 Template Development Folder in Resource Catalog

13.1.2 Specifying the Resource Catalogs to Use for Space and Page Templates

Application Administrators

As the application administrator, you can specify the default Resource Catalog to open under any circumstance: for a page, a Space, a page template, a Space template, and so on. The General subpage of the Configuration page under the Administration page provides a Resources section for setting these defaults (Figure 13-3).

Figure 13-3 Resources Section on the Application Administration General Page

Administrative settings apply to the entire application, so, barring lower-level overrides, the default catalog you select is the one all authorized users see when they add content. For more information, see Section 16.10.1, "Configuring the Application-Level Resource Catalog."

Space Moderators

As the Space moderator, you can specify the default Resource Catalogs to open when users click Add Content for a Space page or page template. The General page under the Settings page provides a Display Settings section for setting these defaults (Figure 13-4).

Figure 13-4 Display Settings Section on the Space Settings General Page

Your selection applies only to the Space on which it is set. The Space-level setting overrides the same setting specified by the application administrator at the application level. For more information, see Section 16.10.2, "Configuring the Space-Level Resource Catalog."

13.1.3 Adding Spaces Components to a Template

As with any other component available in a Resource Catalog, you can add Spaces components from the catalog to a page template. For information about adding resources to a page template, see Section 12.2, "Creating a Page Template."

13.1.4 Adding Spaces Components to a Page

Provided Spaces components are available in the Resource Catalog, you can add them to a page in a Space or the Home Space just as you would any other component. For more information, see Section 17.5, "Adding Resource Catalog Components to Pages."

13.2 Working with Spaces Component Properties

Spaces components have associated properties that you can use to refine the appearance and behavior of a component instance.

This section provides information about the properties associated with each component. It includes the following subsections:

- Section 13.2.1, "Accessing Spaces Component Properties"

- Table 13-1 links to the remaining subsections in this section. It lists all available Spaces components and links to more information about each one. Additionally, it provides the XML code for placing the component in a Resource Catalog in a WebCenter Portal application and the tag to use to place the component on a .jspx page.

Table 13-1 Spaces Components

A to Create Sp

Create Su to I

J to P

R to U

About Space

Create Subspace

Login

RSS

About WebCenter

Current User Profile

Logout

Search

Add to Favorites

Edit Page

Mail Space Members

Self Registration

Administration

Favorites Menu

Mail Space Moderators

Share Resource

Change Membership

Global Help

Manage Pages

Spaces Switcher

Contact Administration

Home Space

Page Links

Status Indicator

Copyright Message

Invite People as Connection

Parent Space

Subscription Preferences

Create Page

Join Space

Print Preview

Tags

Create Space

Leave Space

Privacy URL

User Preferences

See Also:

For information about accessing component properties, see Section 17.5.2, "Setting Properties on Page Components."

13.2.1 Accessing Spaces Component Properties

You can access Spaces component properties in page edit mode Source view.

Note:

When you enter most types of property values in the Component Properties dialog and then click Apply, the dialog remains open. With values other than expected value types, the dialog closes, and the page is refreshed to reflect the new value. For example, if a component takes a java.util.ArrayList of java.awt.Color classes, then the Component Properties dialog closes and Composer does a full-page-refresh.

To access Spaces component properties:

1. Edit a template.

See Also:

For more information, see Section 10.3.3, "Editing a Resource by Using the Edit Dialog."

2. In edit mode, select Source from the View menu (Figure 13-5).

Figure 13-5 Source Option on View Menu

3. Select the component on the page, and click Edit to open the Component Properties dialog (Figure 13-6).

Figure 13-6 Show the Properties of userProfile Icon

4. Revise property values as required.

Note:

Wherever you enter EL on the generic Display Options tab in the Component Properties dialog, the entry is automatically validated. If the EL is invalid, an error appears and the value is neither applied nor saved. Generic Display Options are those cataloged in Table 17-1. For more information about ELs in WebCenter Spaces, seeAppendix B, "Expression Language Expressions."
EL validation is not performed on non-generic display options.

5. Click Save and then Close to exit edit mode.

Tip:

You can try out a change by clicking Apply first and observing the result on the page.

13.2.2 About Space

The About Space component is a link that opens a dialog with information about the current Space (Figure 13-7).

Figure 13-7 About Space Component

Every Space has associated information, called metadata. Space metadata includes such information as display name, internal identification (GUID), description, current user membership role, user name of the creator, date created, and direct URL. Users click the About Space link to access this information.

See Also:

For information about the About Space dialog, see Section 29.9.1, "Accessing Space Information."

This section lists and describes the Display Options associated with the About Space component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.2.1, "About Space Component Display Options"

- Section 13.2.2.2, "About Space Component Tag and XML"

13.2.2.1 About Space Component Display Options

Table 13-2 lists and describes the Display Options properties associated with the About Space component.

See Also:

The About Space component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-2 About Space Component Display Options

Property

Description

Depressed Icon

A URL or relative path to an icon that appears when the component is clicked

Use any Web-compatible image from any accessible location. That is, do not put in a path to an image on an external server that requires authentication.

Enter a full URL or a path that is relative to the application root.

Disabled Icon

A URL or relative path to an image that appears when the component is disabled

See Depressed Icon for more information.

Display Type

The render mode of the component:

- link—Show the component as a link

- button—Show the component as a command button

Hover Icon

A URL or relative path to an icon that appears when users hover their mouse pointers over the component

See Depressed Icon for more information.

Icon

A URL or relative path to an icon to represent the active component

See Depressed Icon for more information.

Icon Position

A selection of options for placement of the link's associated icon:

- leading—The icon is positioned at the start of its associated text

- trailing—The icon is positioned at the end of its associated text

Scope Name

The name of the Space to describe in the dialog

The default value is null (defaultScope), which provides information about the current Space. You can also enter a Space name in lieu of the default.

Note: If you enter a Space name, be sure to enter the Space's internal name. The Space internal name is the name specified by the Space URL on the General Settings page of a Space's administration settings.

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

Text

Display text for the component

The default is About Space. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.TITLE_SHOW_GROUP_Space_INFO}.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again through Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

13.2.2.2 About Space Component Tag and XML

The following tag is used to render the About Space component on a .jspx page:

<wcdc:aboutSpaceLink id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
text="#{uib_o_w_w_r_WebCenter.TITLE_SHOW_GROUP_SPACE_INFO}"/>

Example 13-1 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-1 XML Code for the About Space Component

<tag>
<name>aboutSpaceLink</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
AboutSpaceLinkTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.3 About WebCenter

The About WebCenter component is a link that opens a dialog with application version and copyright information (Figure 13-8).

Figure 13-8 About WebCenter Component

This section lists and describes the Display Options associated with the About WebCenter component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.3.1, "About WebCenter Component Display Options"

- Section 13.2.3.2, "About WebCenter Component Tag and XML"

13.2.3.1 About WebCenter Component Display Options

The About WebCenter component shares many of the same Display Options properties with the About Space component. Table 13-3 lists and describes the Display Options properties associated with the About WebCenter component that are not included in Table 13-2, "About Space Component Display Options" or that have different default values.

See Also:

The About WebCenter component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-3 About WebCenter Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Display WebCenter Spaces Information. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ABOUT_DESC}.

Text

Display text for the component

The default is About Spaces. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ABOUT}.

Type

The component type

The default is aboutWebcenter.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.3.2 About WebCenter Component Tag and XML

The following tag is used to render the About WebCenter component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="aboutWebcenter" displayType="link"
text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ABOUT}"
shortDesc="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ABOUT_DESC}"
inlineStyle="white-space:nowrap;"/>

Example 13-2 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-2 XML Code for the About WebCenter Component

<tag>
<name>spacesAction</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.SpacesActionTag
</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>type</name>
<required>true</required>
<deferred-value/>
</attribute>
</tag>

13.2.4 Add to Favorites

The Add to Favorites component is a link users can click to add an application object to their WebCenter Spaces Favorites (Figure 13-9).

Figure 13-9 Add to Favorites Component

For example, users can use this component to add a page, wiki, blog, list, event, task, template, and so on.

This section lists and describes the Display Options associated with the Add to Favorites component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.4.1, "Add to Favorites Component Display Options"

- Section 13.2.4.2, "Add to Favorites Component Tag and XML"

13.2.4.1 Add to Favorites Component Display Options

The Add to Favorites component shares many of the same Display Options properties with the About Space component. Table 13-4 lists and describes the properties for which Add to Favorites has different default values than those described in Table 13-2, "About Space Component Display Options".

See Also:

The Add to Favorites component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-4 Add to Favorites Component Display Options

Property

Description

Favorite Title

The display name of the application object to add as a favorite

Favorite URL

The URL to use to navigate to the application object

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Add To Favorites. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.TITLE_ADD_FAVORITE_DIALOG}.

Text

Display text for the component.

The default is Add to Favorites. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.TITLE_ADD_FAVORITE_DIALOG}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.4.2 Add to Favorites Component Tag and XML

The following tag is used to render the Add to Favorites component on a .jspx page:

<wcdc:addToFavorites id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.TITLE_ADD_FAVORITE_DIALOG}"
shortDesc="#{uib_o_w_w_r_WebCenter.TITLE_ADD_FAVORITE_DIALOG}"/>

Example 13-3 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-3 XML Code for the Add to Favorites Component

<tag>   <name>addToFavorites</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
AddToFavoritesTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>favoriteTitle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>favoriteURL</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.5 Administration

The Administration component is a navigation link that opens the Administration page (Figure 13-10).

Figure 13-10 Administration Component

Only application administrators can see this link once it is placed on a page or page template.

See Also:

For information about WebCenter Spaces administration, see Part I through Part VIII in this guide, and see the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

This section lists and describes the Display Options associated with the Administration component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.5.1, "Administration Component Display Options"

- Section 13.2.5.2, "Administration Component Tag and XML"

13.2.5.1 Administration Component Display Options

The Administration component shares many of the same Display Options properties associated with the About Space component. Table 13-5 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Administration component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-5 Administration Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Open WebCenter administration pages. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ADMINISTRATION_DESC}.

Text

Display text for the component

The default is Administration. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ADMINISTRATION}.

Type

The component type

The default is administration.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.5.2 Administration Component Tag and XML

The following tag is used to render the Administration component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="administration" displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ADMINISTRATION}"
shortDesc="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ADMINISTRATION_DESC}"/>

In the Resource Catalog, the Administration component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.6 Change Membership

The Change Membership component is a link users can click to request a change to their Space role (Figure 13-11).

Figure 13-11 Change Membership Component

See Also:

For information about changing a Space membership, see Section 49.20, "Changing Your Role in a Space."

This section lists and describes the Display Options associated with the Change Membership component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.6.1, "Change Membership Component Display Options"

- Section 13.2.6.2, "Change Membership Component Tag and XML"

13.2.6.1 Change Membership Component Display Options

The Change Membership component shares many of the same properties with the About Space component. Table 13-6 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Change Membership component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-6 Change Membership Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default value is Change Membership. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.COMMUNITY_CHANGE_MEMBERSHIP}.

Text

Display text for the component

The default is Change Membership. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.COMMUNITY_CHANGE_MEMBERSHIP}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.6.2 Change Membership Component Tag and XML

The following tag is used to render the Change Membership component on a .jspx page:

<wcdc:changeSpaceMembership id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
text="#{uib_o_w_s_r_Spaces.COMMUNITY_CHANGE_MEMBERSHIP}"
shortDesc="#{uib_o_w_s_r_Spaces.COMMUNITY_CHANGE_MEMBERSHIP}"
inlineStyle="white-space:nowrap;"/>

Example 13-4 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-4 XML Code for the Change Membership Component

<tag>
<name>changeSpaceMembership</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
ChangeSpaceMembershipTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.7 Contact Administration

The Contact Administration component is a link that opens a simple send-mail window in which users can enter and send a message to the application administrator, without having to know the administrator's address (Figure 13-12).

Figure 13-12 Contact Administration Component

This section lists and describes the Display Options associated with the Contact Administration component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.7.1, "Contact Administration Component Display Options"

- Section 13.2.7.2, "Contact Administration Component Tag and XML"

13.2.7.1 Contact Administration Component Display Options

The Contact Administrator component shares many of the same properties with the About Space component. Table 13-7 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Contact Administration component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-7 Contact Administrator Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default value is Contact the Administrator. The default value is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.CONTACT_ADMINISTRATOR_DESC}.

Text

Display text for the component

The default is Administrator. The default value is represented by the EL expression #{uib_o_w_w_r_WebCenter.CONTACT_ADMINISTRATOR}.

Type

The component type

The default is contactAdmin.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.7.2 Contact Administration Component Tag and XML

The following tag is used to render the Contact Administration component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="contactAdmin" displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.CONTACT_ADMINISTRATOR}"
shortDesc="#{uib_o_w_w_r_WebCenter.CONTACT_ADMINISTRATOR_DESC}"/>

In the Resource Catalog, the Contact Administration component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.8 Copyright Message

The Copyright Message component renders the following text string:

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.

Figure 13-13 shows an example of the Copyright Message component rendered within the user interface.

Figure 13-13 Copyright Message Component

This section lists and describes the Display Options associated with the Copyright component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.8.1, "Copyright Message Component Display Options"

- Section 13.2.8.2, "Copyright Message Component Tag and XML"

13.2.8.1 Copyright Message Component Display Options

The Copyright Message component shares many of the same properties with the About Space component. Table 13-8 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Copyright Message component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-8 Copyright Message Component Display Options

Property

Description

Inline Style

A field for entering CSS style values to define the appearance of the component

The default inline style is white-Space:nowrap;.

Type

The component type

The default is copyrightMessage.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.8.2 Copyright Message Component Tag and XML

The following tag is used to render the Copyright Message component on a .jspx page:

wcdc:outputText id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="copyrightMessage" inlineStyle="white-space:nowrap;"/>

Example 13-5 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-5 XML Code for the Copyright Message Component

<tag>
<name>outputText</name>
<tag-class>oracle.webcenter.webcenterapp.spacescomponents.internal.view.
taglib.OutputTextTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>type</name>
<required>true</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.9 Create Page

The Create Page component is an icon and a link that users click to open the Create Page dialog (Figure 13-14).

Figure 13-14 Create Page Component

See Also:

For information about creating pages, see Chapter 17, "Building Pages," and Chapter 38, "Creating and Managing Personal Pages."

This component is useful for providing an on-the-spot means of creating pages in the current Space or Home Space. Only authorized users can see and use the Create Page link.

This section lists and describes the Display Options associated with the Create Page component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.9.1, "Create Page Component Display Options"

- Section 13.2.9.2, "Create Page Component Tag and XML"

13.2.9.1 Create Page Component Display Options

The Create Page component shares many of the same properties with the About Space component. Table 13-9 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Create Page component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-9 Create Page Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Create a new page. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.TOOLTIP_MANAGE_PAGES_CREATE_PAGE}.

Task Flow Id

The component's unique identifier, for example wcdc4082953494

Text

Display text for the component

The default is Create Page. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_CREATE_PAGE}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.9.2 Create Page Component Tag and XML

The following tag is used to render the Create Page component on a .jspx page:

<wcdc:createPage id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.LABEL_CREATE_PAGE}"
shortDesc="#{uib_o_w_w_r_WebCenter.TOOLTIP_MANAGE_PAGES_CREATE_PAGE}" />

Example 13-6 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-6 XML Code for the Create Page Component

<tag>
<name>createPage</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
CreatePageTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.10 Create Space

The Create Space component is a link users click to open the Create a Space wizard (Figure 13-15).

Figure 13-15 Create Space Component

This component is useful for providing an on-the-spot means of creating a Space. Only authorized users can see and use the Create Space link.

See Also:

For information about creating Spaces, see Part XI, "Planning and Building a Space".

This section lists and describes the Display Options associated with the Create Space component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.10.1, "Create Space Component Display Options"

- Section 13.2.10.2, "Create Space Component Tag and XML"

13.2.10.1 Create Space Component Display Options

The Create Space component shares many of the same properties with the About Space component. Table 13-10 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Create Space component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-10 Create Space Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Create a Space. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.HEADING_CREATE_COMMUNITY}.

Text

Display text for the component

The default is Create a Space. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.HEADING_CREATE_COMMUNITY}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.10.2 Create Space Component Tag and XML

The following tag is used to render the Create Space component on a .jspx page:

<wcdc:createSpace id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_s_r_Spaces.HEADING_CREATE_COMMUNITY}"
shortDesc="#{uib_o_w_s_r_Spaces.HEADING_CREATE_COMMUNITY}"/>

Example 13-7 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-7 XML Code for the Create Space Component

<tag>
<name>createSpace</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
CreateSpaceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.11 Create Subspace

The Create Subspace component is a link that opens a dialog for creating a Subspace (Figure 13-16).

Figure 13-16 Create Subspace Component

A Subspace is a Space that is hierarchically lower than its parent Space. The Create Subspace component is useful for providing an on-the-spot means of creating Subspaces in the current Space. Only authorized users can see and use the Create Subspace link.

See Also:

For information about creating a SubSpace, see Section 54.3, "Creating a Subspace."

This section lists and describes the Display Options associated with the Create Subspace component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.11.1, "Create Subspace Component Display Options"

- Section 13.2.11.2, "Create Subspace Component Tag and XML"

13.2.11.1 Create Subspace Component Display Options

The Create Subspace component shares many of the same properties with the About Space component. Table 13-11 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Create Subspace component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-11 Create Subspace Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Create a Subspace. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.HEADING_CREATE_SUB_COMMUNITY}.

Text

Display text for the component

The default is Create a Subspace. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.HEADING_CREATE_SUB_COMMUNITY}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.11.2 Create Subspace Component Tag and XML

The following tag is used to render the Create Subspace component on a .jspx page:

<wcdc:createSubSpace id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_s_r_Spaces.HEADING_CREATE_SUB_COMMUNITY}"
shortDesc="#{uib_o_w_s_r_Spaces.HEADING_CREATE_SUB_COMMUNITY}"/>

Example 13-8 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-8 XML Code for the Create Subspace Component

<tag>
<name>createSubSpace</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
CreateSubspaceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.12 Current User Profile

The Current User Profile component is the name of the current user linked to the user's Profile page (Figure 13-17).

Figure 13-17 Current User Profile Component

Users click the name to open a Profile page with the user's profile details.

See Also:

The Profile page is a customizable business role page that appears in all authenticated users' Home Spaces. For more information about business role pages, see Section 7.1, "Working with Business Role Pages." For more information about Profiles, see Chapter 30, "Managing Your Profile."

This section lists and describes the Display Options associated with the Current User Profile component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.12.1, "Current User Profile Component Display Options"

- Section 13.2.12.2, "Current User Profile Component Tag and XML"

13.2.12.1 Current User Profile Component Display Options

The Current User Profile component shares many of the same properties with the About Space component. Table 13-12 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Current User Profile component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-12 Current User Profile Component Display Options

Property

Description

Short Desc

A field for entering a tooltip to display when users hover their mouse pointers over the component

The default is the current user's name. The default is the rendered value of the EL expression #{security.userDisplayName}.

Text

Display text for the component

The default is the current user's name. The default is the rendered value of the EL expression #{security.userDisplayName}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.12.2 Current User Profile Component Tag and XML

The following tag is used to render the Current User Profile component on a .jspx page:

<wcdc:userProfile id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap"
text="#{security.userDisplayName}" shortDesc="#{security.userDisplayName}" />

Example 13-9 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-9 XML Code for the Current User Profile Component

<tag>
<name>userProfile</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
UserProfileTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.13 Edit Page

The Edit Page component is a link that users click to take the current page into page edit mode (Figure 13-18).

Figure 13-18 Edit Page Component

Only users who are authorized to edit the current page can see and use the Edit Page link.

See Also:

For information about editing pages, see Section 17.3, "Editing Pages," and Section 38.3, "Editing a Personal Page."

This section lists and describes the Display Options associated with the Edit Page component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.13.1, "Edit Page Component Display Options"

- Section 13.2.13.2, "Edit Page Component Tag and XML"

13.2.13.1 Edit Page Component Display Options

The Edit Page component shares many of the same properties with the About Space component. Table 13-13 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Edit Page component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-13 Edit Page Component Display Options

Property

Description

Short Desc

A field for entering a tooltip to display when users hover their mouse pointers over the component

The default is Edit the Page. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.PAGE_CONTEXT_EDIT_PAGE_DESC}.

Task Flow Id

The component's unique identifier, for example wcdc4082953494

Text

Display text for the component

The default is Edit Page. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.PAGE_CONTEXT_EDIT_PAGE}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.13.2 Edit Page Component Tag and XML

The following tag is used to render the Edit Page component on a .jspx page:

<wcdc:editPage id="#" xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.PAGE_CONTEXT_EDIT_PAGE}"
shortDesc="#{uib_o_w_w_r_WebCenter.PAGE_CONTEXT_EDIT_PAGE_DESC}" />

Example 13-10 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-10 XML Code for the Edit Page Component

<tag>
<name>editPage</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
EditPageTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.14 Favorites Menu

The Favorites Menu component is a menu with options for opening the Add to Favorites and Manage Favorites dialogs (Figure 13-19).

Figure 13-19 Favorites Menu Component

See Also:

For information about Favorites in WebCenter Spaces, see Chapter 37, "Creating and Managing Your Personal Favorites."

This section lists and describes the Display Options associated with the Favorites Menu component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.14.1, "Favorites Menu Component Display Options"

- Section 13.2.14.2, "Favorites Menu Component Tag and XML"

13.2.14.1 Favorites Menu Component Display Options

The Favorites Menu component shares many of the same properties with the About Space component. Table 13-14 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Favorites Menu component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-14 Favorites Menu Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Manage your favorites. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_FAVORITES_DESC}.

Task Flow Id

The component's unique identifier, for example wcdc4082953494

Text

Display text for the component

The default is Manage your favorites. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_FAVORITES_DESC}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.14.2 Favorites Menu Component Tag and XML

The following tag is used to render the Favorites Menu component on a .jspx page:

<wcdc:favoritesMenu id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
styleClass="WCLinkMenu" text="#{uib_o_w_w_r_WebCenter.LABEL_FAVORITES_DESC}"
shortDesc="#{uib_o_w_w_r_WebCenter.LABEL_FAVORITES_DESC}" />

Example 13-11 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-11 XML Code for the Favorites Menu Component

<tag>
<name>favoritesMenu</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
FavoritesMenuTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.15 Global Help

The Global Help component is a link that users click to access WebCenter Spaces online Help topics (Figure 13-20).

Figure 13-20 Global Help Component

See Also:

For more information, see Section 29.11, "Accessing WebCenter Spaces Online Help."

This section lists and describes the Display Options associated with the Global Help component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.15.1, "Global Help Component Display Options"

- Section 13.2.15.2, "Global Help Component Tag and XML"

13.2.15.1 Global Help Component Display Options

The Global Help component shares many of the same properties with the About Space component. Table 13-15 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Global Help component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-15 Global Help Component Display Options

Property

Description

Short Desc

A field for entering a tooltip to display when users hover their mouse pointers over the component

The default is Help for WebCenter Spaces. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_HELP_DESC}.

Text

The component label

The default is Help. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_HELP}.

Type

The component type

The default is globalHelp.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.15.2 Global Help Component Tag and XML

The following tag is used to render the Global Help component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="globalHelp" displayType="link"
text="#{uib_o_w_w_r_WebCenter.LABEL_HELP}"
shortDesc="#{uib_o_w_w_r_WebCenter.LABEL_HELP_DESC}"
inlineStyle="white-space:nowrap"/>

In the Resource Catalog, the Global Help component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.16 Home Space

The Home Space component is a link that users click to navigate to their view of the Home Space (Figure 13-21).

Figure 13-21 Home Space Component

See Also:

For information about Home Spaces, see Chapter 29, "Exploring the Home Space."

This section lists and describes the Display Options associated with the Home Space component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.16.1, "Home Space Component Display Options"

- Section 13.2.16.2, "Home Space Component Tag and XML"

13.2.16.1 Home Space Component Display Options

The Home Space component shares many of the same properties with the About Space component. Table 13-16 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Home Space component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-16 Home Space Component Display Options

Property

Description

Text

Display text for the component

The default is Personal Space.

Type

The component type

The default is personalSpace.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.16.2 Home Space Component Tag and XML

The following tag is used to render the Home Space component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="personalSpace" displayType="link" text="Personal Space"
inlineStyle="white-space:nowrap;"/>

In the Resource Catalog, the Home Space component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.17 Invite People as Connection

The Invite People as Connection component is a link that opens a page where users can invite other users to connect (Figure 13-22).

Figure 13-22 Invite People as Connection Component

See Also:

For information about Connections, see Chapter 31, "Creating Your Social Network."

This section lists and describes the Display Options associated with the Invite People as Connection component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.17.1, "Invite People as Connection Component Display Options"

- Section 13.2.17.2, "Invite People as Connection Component Tag and XML"

13.2.17.1 Invite People as Connection Component Display Options

The Invite People as Connection component shares many of the same properties with the About Space component. Table 13-17 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Invite People as Connection component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-17 Invite People as Connection Display Options

Property

Description

Short Desc

A field for entering a tooltip to display when users hover their mouse pointers over the component

The default is Invite People. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.LABEL_INVITE_PEOPLE}.

Text

The component label

The default is Invite People. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.LABEL_INVITE_PEOPLE}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.17.2 Invite People as Connection Component Tag and XML

The following tag is used to render the Invite People as Connection component on a .jspx page:

<wcdc:invitePeopleAsConnection id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_s_r_Spaces.LABEL_INVITE_PEOPLE}"
shortDesc="#{uib_o_w_s_r_Spaces.LABEL_INVITE_PEOPLE}"/>

Example 13-12 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-12 XML Code for the Invite People as Connection Component

<tag>
<name>invitePeopleAsConnection</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
InvitePeopleAsConnectionTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.18 Join Space

The Join Space component is a link that initiates the process of becoming a member of a Space, usually the current Space (Figure 13-23).

Figure 13-23 Join Space Component

See Also:

For information about joining a Space, see Section 49.6, "Joining a Space."

This section lists and describes the Display Options associated with the Join Space component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.18.1, "Join Space Component Display Options"

- Section 13.2.18.2, "Join Space Component Tag and XML"

13.2.18.1 Join Space Component Display Options

The Join Space component shares many of the same properties with the About Space component. Table 13-18 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Join Space component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-18 Join Space Component Display Options

Property

Description

Short Desc

A field for entering a tooltip to display when users hover their mouse pointers over the component

The default is Join Space. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.GROUP_SpaceS_MANAGE_JOIN_Space}.

Text

The component label

The default is Join Space. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.GROUP_SpaceS_MANAGE_JOIN_Space}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.18.2 Join Space Component Tag and XML

The following tag is used to render the Join Space component on a .jspx page:

<wcdc:joinSpace id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_s_r_Spaces.GROUP_SPACES_MANAGE_JOIN_SPACE}"
shortDesc="#{uib_o_w_s_r_Spaces.GROUP_SPACES_MANAGE_JOIN_SPACE}" />

Example 13-13 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-13 XML Code for the Join Space Component

<tag>
<name>joinSpace</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
JoinSpaceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.19 Leave Space

The Leave Space component is a link for requesting a removal of a user's own membership in the current Space (Figure 13-24).

Figure 13-24 Leave Space Component

See Also:

For information about requesting an end of membership, see Section 49.21, "Cancelling Space Membership."

This section lists and describes the Display Options associated with the Leave Space component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.19.1, "Leave Space Component Display Options"

- Section 13.2.19.2, "Leave Space Component Tag and XML"

13.2.19.1 Leave Space Component Display Options

The Leave Space component shares many of the same properties with the About Space component. Table 13-19 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Leave Space component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-19 Leave Space Component Display Options

Property

Description

Short Desc

A field for entering a tooltip to display when users hover their mouse pointers over the component

The default is Leave Space. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.LABEL_LEAVE_Space}.

Text

The component label

The default is Leave Space. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.LABEL_LEAVE_Space}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.19.2 Leave Space Component Tag and XML

The following tag is used to render the Leave Space component on a .jspx page:

<wcdc:leaveSpace id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
text="#{uib_o_w_s_r_Spaces.LABEL_LEAVE_SPACE}"
shortDesc="#{uib_o_w_s_r_Spaces.LABEL_LEAVE_SPACE}"
inlineStyle="white-space:nowrap;"/>

Example 13-14 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-14 XML Code for the Leave Space Component

<tag>
<name>leaveSpace</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
LeaveSpaceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.20 Login

The Login component is a link for navigating to the application Login page (Figure 13-25).

Figure 13-25 Login Component

The Login link appears only to users who are not logged in. That is, if a user is logged in this link is hidden.

This section lists and describes the Display Options associated with the Login component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.20.1, "Login Component Display Options"

- Section 13.2.20.2, "Login Component Tag and XML"

13.2.20.1 Login Component Display Options

The Login component shares many of the same properties with the About Space component. Table 13-20 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Login component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-20 Login Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Login. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGIN}.

Text

Display text for the component

The default is Login. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGIN}.

Type

The component type

The default is login.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.20.2 Login Component Tag and XML

The following tag is used to render the Login component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="login" displayType="link" inlineStyle="white-space:nowrap"
text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGIN}"
shortDesc="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGIN}"/>

In the Resource Catalog, the Login component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.21 Logout

The Logout component is a link for logging out of the application (Figure 13-26).

Figure 13-26 Logout Component

The Logout link appears only to logged in users. That is, if a user is logged out, this link is hidden.

This section lists and describes the Display Options associated with the Logout component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.21.1, "Logout Component Display Options"

- Section 13.2.21.2, "Logout Component Tag and XML"

13.2.21.1 Logout Component Display Options

The Logout component shares many of the same properties with the About Space component. Table 13-21 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Logout component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-21 Logout Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Logout of WebCenter Spaces. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGOUT_DESC}.

Text

Display text for the component

The default is Logout. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGOUT}.

Type

The component type

The default is logout.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.21.2 Logout Component Tag and XML

The following tag is used to render the Logout component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"    type="logout" displayType="link" inlineStyle="white-space:nowrap"    text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGOUT}"    shortDesc="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_LOGOUT_DESC}"/>

In the Resource Catalog, the Logout component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.22 Mail Space Members

The Mail Space Members component is a link that opens a simple send-mail window (Figure 13-27).

Figure 13-27 Mail Space Members Component

Such messages are sent to the in-boxes of all members of the current Space.

This section lists and describes the Display Options associated with the Mail Space Members component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.22.1, "Mail Space Members Component Display Options"

- Section 13.2.22.2, "Mail Space Members Component Tag and XML"

13.2.22.1 Mail Space Members Component Display Options

The Email Members component shares many of the same properties with the About Space component. Table 13-22 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

Table 13-22 Mail Space Members Component Display Options

Property

Description

Text

The default is Send Mail to Members. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_SEND_EMAIL_TO_MEMBERS}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.22.2 Mail Space Members Component Tag and XML

The following tag is used to render the Mail Space Members component on a .jspx page:

<wcdc:emailMembersLink id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"    text="#{uib_o_w_w_r_WebCenter.LABEL_SEND_EMAIL_TO_MEMBERS}"/>

Example 13-15 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-15 XML Code for the Mail Space Members Component

<tag>
<name>emailMembersLink</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
EmailMembersLinkTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.23 Mail Space Moderators

The Mail Space Moderators component is a link that opens a simple send-mail window (Figure 13-28).

Figure 13-28 Mail Space Moderators Component

Such messages are sent to the in-boxes of all users assigned the role Moderator for the current Space.

This section lists and describes the Display Options associated with the Mail Space Moderators component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.23.1, "Mail Space Moderators Component Display Options"

- Section 13.2.23.2, "Mail Space Moderators Component Tag and XML"

13.2.23.1 Mail Space Moderators Component Display Options

The Mail Space Moderators component shares many of the same properties with the About Space component. Table 13-23 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Mail Space Moderators component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-23 Mail Space Moderators Component Display Options

Property

Description

Text

The default is Send Mail to Moderators. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_SEND_EMAIL_TO_MODERATORS}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.23.2 Mail Space Moderators Component Tag and XML

The following tag is used to render the Mail Space Moderators component on a .jspx page:

<wcdc:emailModeratorsLink id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
text="#{uib_o_w_w_r_WebCenter.LABEL_SEND_EMAIL_TO_MODERATORS}"/>

Example 13-16 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-16 XML Code for the Mail Space Moderators Component

<tag>   <name>emailModeratorsLink</name>   <tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
EmailModeratorsLinkTag</tag-class>   <body-content>empty</body-content>   <attribute>      <name>id</name>   </attribute>   <attribute>      <name>rendered</name>      <deferred-value>         <type>boolean</type>      </deferred-value>   </attribute>   <attribute>      <name>binding</name>      <deferred-value/>   </attribute>   <attribute>      <name>clientComponent</name>      <deferred-value>         <type>boolean</type>      </deferred-value>   </attribute>   <attribute>      <name>customizationId</name>      <deferred-value/>   </attribute>   <attribute>      <name>disabled</name>      <required>false</required>      <deferred-value/>   </attribute>   <attribute>      <name>displayType</name>      <required>false</required>      <deferred-value/>   </attribute>   <attribute>      <name>shortDesc</name>      <required>false</required>      <deferred-value/>   </attribute>   <attribute>      <name>scopeName</name>      <required>false</required>      <deferred-value/>   </attribute>   <attribute>      <name>text</name>      <required>false</required>      <deferred-value/>   </attribute></tag>

13.2.24 Manage Pages

The Manage Pages component is a link that opens the Manage Pages dialog (Figure 13-29).

Figure 13-29 Manage Pages Component

The Manage Pages dialog lists all of the pages to which the current user has access. Manage Pages provides controls for creating more pages, setting page creation defaults (Home Space only), and performing actions on pages, such as editing, renaming, setting access, and the like. Additionally, users can click a listed page name to navigate to that page.

See Also:

For information about the types of actions users can perform through Manage Pages, see Chapter 17, "Building Pages," and Chapter 38, "Creating and Managing Personal Pages."

This section lists and describes the Display Options associated with the Manage Pages component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.24.1, "Manage Pages Component Display Options"

- Section 13.2.24.2, "Manage Pages Component Tag and XML"

13.2.24.1 Manage Pages Component Display Options

The Manage Pages component shares many of the same properties with the About Space component. Table 13-24 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Manage Pages component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-24 Manage Pages Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Logout of WebCenter Spaces. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.TITLE_MANAGE_PAGES}.

Task Flow Id

The component's unique identifier, for example wcdc4082953494

Text

Display text for the component

The default is Logout. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.TITLE_MANAGE_PAGES}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.24.2 Manage Pages Component Tag and XML

The following tag is used to render the Manage Pages component on a .jspx page:

<wcdc:managePages id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.TITLE_MANAGE_PAGES}"
shortDesc="#{uib_o_w_w_r_WebCenter.TITLE_MANAGE_PAGES}"/>

Example 13-17 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-17 XML Code for the Manage Pages Component

<tag>
<name>managePages</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
ManagePagesTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>   </attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.25 Page Links

The Page Links component is an icon for opening the Links dialog (Figure 13-30).

Figure 13-30 Page Links Component

See Also:

For information about linking in WebCenter Spaces, see Chapter 63, "Working with the Links Service."

The Links dialog enables users to add personal links to related content to the current page and to navigate to those link targets. For more information, see Chapter 63, "Working with the Links Service."

This section lists and describes the Display Options associated with the Page Links component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.25.1, "Page Links Component Display Options"

- Section 13.2.25.2, "Page Links Component Tag and XML"

13.2.25.1 Page Links Component Display Options

Table 13-25 lists and describes the Display Options properties associated with the Page Links component.

Table 13-25 Page Links Component Display Options

Property

Description

Task Flow Id

A unique identifier for the component instance

Caution: Never change this property's default value

Show Label

Display text for the component

By default, the Page Links component is labeled Links.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again through Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.25.2 Page Links Component Tag and XML

The following tag is used to render the Page Links component on a .jspx page:

<wcdc:pageLinks id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"/>

Example 13-18 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-18 XML Code for the Page Links Component

<tag>
<name>pageLinks</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
PageLinksTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>showLabel</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.26 Parent Space

The Parent Space component is a link users click to navigate to the top Space in a Space hierarchy (Figure 13-31).

Figure 13-31 Parent Space Component

See Also:

For information about Space hierarchies, see Section 54, "Working with a Space Hierarchy."

This section lists and describes the Display Options associated with the Parent Space component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.26.1, "Parent Space Component Display Options"

- Section 13.2.26.2, "Parent Space Component Tag and XML"

13.2.26.1 Parent Space Component Display Options

The Parent Space component shares many of the same properties with the About Space component. Table 13-24 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Parent Space component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-26 Parent Space Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Navigate to Parent Space. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_NAVIGATE_TO_PARENT_Space}.

Text

Display text for the component

The default is Navigate to Parent Space. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_NAVIGATE_TO_PARENT_Space}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.26.2 Parent Space Component Tag and XML

The following tag is used to render the Parent Space component on a .jspx page:

<wcdc:parentSpace id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.LABEL_NAVIGATE_TO_PARENT_SPACE}"
shortDesc="#{uib_o_w_w_r_WebCenter.LABEL_NAVIGATE_TO_PARENT_SPACE}"/>

Example 13-19 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-19 XML Code for the Parent Space Component

<tag>
<name>parentSpace</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
ParentSpaceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.27 Print Preview

The Print Preview component is a link users click to open a print preview of the current page in the user's browser (Figure 13-32).

Figure 13-32 Print Preview Component

See Also:

For more information, see Section 29.8, "Previewing and Printing an Application Page."

This section lists and describes the Display Options associated with the Print Preview component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.27.1, "Print Preview Component Display Options"

- Section 13.2.27.2, "Print Preview Component Tag and XML"

13.2.27.1 Print Preview Component Display Options

The Print Preview component shares many of the same properties with the About Space component. Table 13-27 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Print Preview component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-27 Print Preview Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Print Preview. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_PAGE_PRINT_PREVIEW}.

Text

Display text for the component

The default is Print Preview. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_PAGE_PRINT_PREVIEW}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.27.2 Print Preview Component Tag and XML

The following tag is used to render the Print Preview component on a .jspx page:

<wcdc:printPreview id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
text="#{uib_o_w_w_r_WebCenter.LABEL_PAGE_PRINT_PREVIEW}"
shortDesc="#{uib_o_w_w_r_WebCenter.LABEL_PAGE_PRINT_PREVIEW}"
inlineStyle="white-space:nowrap;"/>

Example 13-20 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-20 XML Code for the Print Preview Component

<tag>
<name>printPreview</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
PrintPreviewTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.28 Privacy URL

The Privacy URL component is a link that users click to navigate to the application privacy statement (Figure 13-33).

Figure 13-33 Privacy URL Component

This section lists and describes the Display Options associated with the Privacy URL component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.28.1, "Privacy URL Component Display Options"

- Section 13.2.28.2, "Privacy URL Component Tag and XML"

13.2.28.1 Privacy URL Component Display Options

The Privacy URL component shares many of the same properties with the About WebCenter component. Table 13-28 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Privacy URL component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-28 Privacy URL Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Display privacy statement. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.PRIVACY_STMT_DESC}.

Text

Display text for the component

The default is Privacy Statement. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.PRIVACY_STMT}.

Type

The component type

The default is privacyURL.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.28.2 Privacy URL Component Tag and XML

The following tag is used to render the Privacy URL component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="privacyURL" displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.PRIVACY_STMT}"
shortDesc="#{uib_o_w_w_r_WebCenter.PRIVACY_STMT_DESC}"/>

In the Resource Catalog, the Privacy URL component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.29 RSS

The RSS component is a link users click to open the RSS Manager (Figure 13-34).

Figure 13-34 RSS Component

The RSS Manager enables users to subscribe to news feeds from WebCenter Spaces services. For more information, see Chapter 68, "Working with the RSS Service."

This section lists and describes the Display Options associated with the RSS component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.29.1, "RSS Component Display Options"

- Section 13.2.29.2, "RSS Component Tag and XML"

13.2.29.1 RSS Component Display Options

The RSS component shares many of the same properties with the About Space component. Table 13-29 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The RSS component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-29 RSS Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Open RSS Manager. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_RSS_DESC}.

Text

Display text for the component

The default is RSS. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_RSS}.

Type

The component type

The default is rss.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.29.2 RSS Component Tag and XML

The following tag is used to render the RSS component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="rss" displayType="link" text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_RSS}"
inlineStyle="white-space:nowrap;"/>

In the Resource Catalog, the Home Space component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.30 Search

The Search component provides a means entering search terms against the application or against a scoped Space, depending on how its parameters are configured (Figure 13-35).

Figure 13-35 Search Component

See Also:

For more information, see Chapter 56, "Working with the Search Service."

Note:

The Search component is a task flow and has no associated XML definition.

Table 13-10 lists and describes the parameters associated with the Search component.

See Also:

The Search component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-30 Search Component Parameter

Property

Description

Search Box Size

Specifies the width of the Search field to render

Enter a number and a unit of measure, such as 400px.

Search Scope ID

The intended scope of the search

By default, the current scope is searched. This means that Search components placed on pages in the Home Space search the entire application, and Search components placed in a particular Space search just that Space.

To limit the search to a Space other than the current Space, set this to the intended Space's GUID. For information about obtaining a Space's GUID, see Section 29.9.1, "Accessing Space Information."

See Also:

Parameters in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.31 Self Registration

The Self Registration component is a link users click to open the Self Registration page (Figure 13-36).

Figure 13-36 Self Registration Component

The Self Registration page is a system page that enables users to create their own application login credentials. For more information, see Section 7.3, "Working with System Pages," and Section 29.2, "Registering Yourself with WebCenter Spaces."

This section lists and describes the Display Options associated with the Self Registration component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.31.1, "Self Registration Component Display Options"

- Section 13.2.31.2, "Self Registration Component Tag and XML"

13.2.31.1 Self Registration Component Display Options

The Self Registration component shares many of the same properties with the About WebCenter component. Table 13-31 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Self Registration component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-31 Self Registration Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Register with WebCenter Spaces. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_SELFREG_DESC}.

Text

Display text for the component

The default is Register. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_SELFREG}.

Type

The component type

The default is selfRegistration.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.31.2 Self Registration Component Tag and XML

The following tag is used to render the Self Registration component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="selfRegistration" displayType="link"
text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_SELFREG}"
shortDesc="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_SELFREG_DESC}"
inlineStyle="white-space:nowrap"/>

In the Resource Catalog, the Self Registration component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.32 Share Resource

The Share Resource component renders as Share Link. Users click this link to open a popup version of the Publisher task flow for publishing messages, links, and documents (Figure 13-37).

Figure 13-37 Share Resource Component

Messages, links, and documents are published on the user's own Message Board or a Space Message Board, depending on the selected recipient. In turn, if activities on the user's Message Board are shared with the user's connections via Activity Stream, then the published message, document, or link is shared with all of the user's connections through their Activity Streams. Messages published to a Space are shared with all members of that Space through their Activity Streams.

See Also:

For information about the Publisher task flow, see Section 34.3.3, "Sharing Items, Files, and URLs Through the Publisher Task Flow."

This section lists and describes the Display Options associated with the Share Resource component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.32.1, "Share Resource Display Options"

- Section 13.2.32.2, "Share Resource Component Tag and XML"

13.2.32.1 Share Resource Display Options

The Share Resource component shares many of the same properties with the About WebCenter component. Table 13-32 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Share Resource component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-32 Share Resource Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Share Link. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter['NAV_TOOLS_ACTIONS_FOLDER_SHARE.TITLE']}.

Text

Display text for the component

The default is Share Link. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter['NAV_TOOLS_ACTIONS_FOLDER_SHARE.TITLE']}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.32.2 Share Resource Component Tag and XML

The following tag is used to render the Share Resource component on a .jspx page:

<wcdc:shareResource id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter['NAV_TOOLS_ACTIONS_FOLDER_SHARE.TITLE']}"
shortDesc="#{uib_o_w_w_r_WebCenter
['NAV_TOOLS_ACTIONS_FOLDER_SHARE.TITLE']}"/>

Example 13-21 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-21 XML Code for the Share Resource Component

<tag>
<name>shareResource</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
ShareResourceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.33 Spaces Switcher

The Spaces Switcher component provides access to a popup window where users can select a Space to which to navigate (Figure 13-38).

Figure 13-38 Spaces Switcher Component

This section lists and describes the Display Options associated with the Spaces Switcher component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.33.1, "Spaces Switcher Component Display Options"

- Section 13.2.33.2, "Spaces Switcher Component Tag and XML"

13.2.33.1 Spaces Switcher Component Display Options

The Spaces Switcher component shares many of the same properties with the About WebCenter component. Table 13-33 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

Table 13-33 Spaces Switcher Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Access Spaces and create new ones. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.LABEL_COMMUNITIES_DESC}.

Text

Display text for the component

The default is Spaces. The default is the rendered value of the EL expression #{uib_o_w_s_r_Spaces.LABEL_COMMUNITIES}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.33.2 Spaces Switcher Component Tag and XML

The following tag is used to render the Spaces Switcher component on a .jspx page:

<wcdc:spacesSwitcher id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
inlineStyle="white-space:nowrap;" styleClass="WCLinkMenu"
text="#{uib_o_w_s_r_Spaces.LABEL_COMMUNITIES}"
shortDesc="#{uib_o_w_s_r_Spaces.LABEL_COMMUNITIES_DESC}"/>

Example 13-22 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-22 XML Code for the Spaces Switcher Component

<tag>
<name>SpacesSwitcher</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
SpacesSwitcherTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.34 Status Indicator

The Status Indicator component is an animated icon that spins when the application is processing information (Figure 13-39).

Figure 13-39 Status Indicator Component

This section lists and describes the Display Options associated with the Status Indicator component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.34.1, "Status Indicator Component Display Options"

- Section 13.2.34.2, "Status Indicator Component Tag and XML"

13.2.34.1 Status Indicator Component Display Options

The Status Indicator component shares many of the same properties with the About WebCenter component. Table 13-34 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Status Indicator component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-34 Status Indicator Component Display Options

Property

Description

Type

The component type

The default is statusIndicator.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.34.2 Status Indicator Component Tag and XML

The following tag is used to render the Status Indicator component on a .jspx page:

<wcdc:spacesAction id="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
type="statusIndicator" displayType="link" />

In the Resource Catalog, the Status Indicator component uses the same XML code as the About WebCenter component. For more information, see Section 13.2.3.2, "About WebCenter Component Tag and XML."

13.2.35 Subscription Preferences

The Subscription Preferences component is a link users can click to subscribe to be notified about specific types of activities that occur in the context of the Space (Figure 13-40).

Figure 13-40 Subscription Preferences Component

See Also:

For more information, see Section 36.3.2, "Setting Space-Level Subscriptions."

This section lists and describes the Display Options associated with the Subscription Preferences component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.35.1, "Subscription Preferences Component Display Options"

- Section 13.2.35.2, "Subscription Preferences Component Tag and XML"

13.2.35.1 Subscription Preferences Component Display Options

The Subscription Preferences component shares many of the same properties with the About WebCenter component. Table 13-35 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The Subscription Preferences component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-35 Subscription Preferences Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Subscribe. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_SUBSCRIBE_TO_GET_NOTIFICATION}.

Text

Display text for the component

The default is Subscribe. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.LABEL_SUBSCRIBE_TO_GET_NOTIFICATION}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.35.2 Subscription Preferences Component Tag and XML

The following tag is used to render the Subscription Preferences component on a .jspx page:

<wcdc:notificationSubscriptionsLink id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
text="#{uib_o_w_w_r_WebCenter.LABEL_SUBSCRIBE_TO_GET_NOTIFICATION}"
shortDesc="#{uib_o_w_w_r_WebCenter.LABEL_SUBSCRIBE_TO_GET_NOTIFICATION}" />

Example 13-23 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-23 XML Code for the Subscription Preferences Component

<tag>
<name>notificationSubscriptionsLink</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.
taglib.NotificationSubscriptionsLinkTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>scopeName</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.36 Tags

The Tags component is an icon that users click to open the Add Tags dialog (Figure 13-41).

Figure 13-41 Tags Component

Add tags to associate personally meaningful search terms to a page or a WebCenter Spaces item. For more information, see Chapter 57, "Working with the Tags Service."

This section lists and describes the Display Options associated with the Tags component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.36.1, "Tags Component Display Options"

- Section 13.2.36.2, "Tags Component Tag and XML"

13.2.36.1 Tags Component Display Options

Table 13-36 lists and describes the Display Options associated with the Tags component.

See Also:

The Tags component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-36 Tags Component Display Options

Property

Description

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again through Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

Show Label

Display text for the component

By default, no display text is associated with the Tag icon.

Task Flow Id

The component's unique identifier, for example wcdc4082953494

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.36.2 Tags Component Tag and XML

The following tag is used to render the Tags component on a .jspx page:

<wcdc:pageTags id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"/>

Example 13-24 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-24 XML Code for the Tags Component

<tag>
<name>pageTags</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
PageTagsTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>showLabel</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.2.37 User Preferences

The User Preferences component is a link that users click to access the Preferences dialog (Figure 13-42).

Figure 13-42 User Preferences Component

User preferences enable users to configure their views of the application to suit their working styles. For more information, see Chapter 35, "Setting Your Personal Preferences."

This section lists and describes the Display Options associated with the User Preferences component. Additionally, it provides the tag that invokes this component on a .jspx page and the XML code that defines this component in a Resource Catalog.

This section includes the following subsections:

- Section 13.2.37.1, "User Preferences Component Display Options"

- Section 13.2.37.2, "User Preferences Component Tag and XML"

13.2.37.1 User Preferences Component Display Options

The User Preferences component shares many of the same properties with the About WebCenter component. Table 13-37 lists the properties that have defaults other than those specified in Table 13-2, "About Space Component Display Options".

See Also:

The User Preferences component has Style properties you can use to change the component's look and feel. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

Table 13-37 User Preferences Component Display Options

Property

Description

Short Desc

A field for entering tooltip text to display when users hover their mouse pointers over the component

The default is Set user preferences. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_PREFERENCES_DESC}.

Text

Display text for the component

The default is Preferences. The default is the rendered value of the EL expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_PREFERENCES}.

See Also:

Display Options properties in the Component Properties dialog provide access to an Expression Language (EL) editor for entering and testing EL values. For more information, see Appendix B, "Expression Language Expressions."

13.2.37.2 User Preferences Component Tag and XML

The following tag is used to render the User Preferences component on a .jspx page:

<wcdc:userPreferences id="#" __taskFlowId="#"
xmlns:wcdc="http://xmlns.oracle.com/webcenter/spaces/taglib"
displayType="link" inlineStyle="white-space:nowrap;"
text="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_PREFERENCES}"
shortDesc="#{uib_o_w_w_r_WebCenter.GLOBAL_LINK_PREFERENCES_DESC}"/>

Example 13-25 provides the XML code that represents the component in the Resource Catalog file (SiteTemplateCatalog.xml) in a WebCenter Portal application.

Example 13-25 XML Code for the User Preferences Component

<tag>
<name>userPreferences</name>
<tag-class>oracle.webcenter.webcenterapp.internal.view.taglib.
UserPreferencesTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>id</name>
</attribute>
<attribute>
<name>rendered</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>binding</name>
<deferred-value/>
</attribute>
<attribute>
<name>clientComponent</name>
<deferred-value>
<type>boolean</type>
</deferred-value>
</attribute>
<attribute>
<name>customizationId</name>
<deferred-value/>
</attribute>
<attribute>
<name>depressedIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabled</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>disabledIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>displayType</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>hoverIcon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>icon</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>iconPosition</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>inlineStyle</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>shortDesc</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>styleClass</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>__taskFlowId</name>
<required>false</required>
<deferred-value/>
</attribute>
<attribute>
<name>text</name>
<required>false</required>
<deferred-value/>
</attribute>
</tag>

13.3 Deleting Spaces Components

This section points to information about removing Spaces components from the various venues in which they may appear. It includes the following subsections:

- Section 13.3.1, "Removing Spaces Components from a Resource Catalog"

- Section 13.3.2, "Removing a Spaces Component from a Template"

- Section 13.3.3, "Removing a Spaces Component from a Page"

13.3.1 Removing Spaces Components from a Resource Catalog

You can remove a Spaces component from a Resource Catalog as you would any other resource. For more information, see Section 16.3.1.7, "Deleting a Resource."

13.3.2 Removing a Spaces Component from a Template

To remove a Spaces component from a template:

1. Access the template in edit mode as described in Section 12.3, "Editing a Page Template."

2. In Source view, select the Spaces component by clicking it in the hierarchical list of components.

Tip:

In Source view, you can also click the component directly on the page to select it.

3. Click Delete.

4. In the resulting confirmation dialog, click Delete.

13.3.3 Removing a Spaces Component from a Page

To remove a Spaces component from a page:

1. Access the page in edit mode as described in Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. In Source view, select the Spaces component by clicking it in the hierarchical list of components.

Tip:

In Source view, you can also click the component directly on the page to select it.

3. Click Delete.

4. In the resulting confirmation dialog, click Delete.

14 Working with Skins

To give individual Spaces or the entire Spaces application a distinct personality or to associate them with specific branding, portal designers can use skins to achieve the appearance and look and feel that suits their organization.

This chapter describes how to create and manage skins in WebCenter Spaces. It includes the following sections:

- Section 14.1, "What You Should Know About Skins"

- Section 14.2, "Creating a Skin"

- Section 14.3, "Editing a Custom Skin"

- Section 14.4, "Managing a Skin"

- Section 14.5, "Applying a Skin"

- Section 14.6, "Using JDeveloper to Build Your Skins"

For generic information about adding and editing different types of resources, see Chapter 10, "Working with the Resources that Compose a Portal or Community."

Audience

This chapter is intended for users who want to create and manage skins in their Oracle WebCenter Spaces application.

Portal designers with the application permission Application-Skins-Create, Edit, and Delete Skins can manage application-level skins. Space moderators with the permission Space-Resources-Create, Edit, and Delete Resources (standard permission model) or Space-Skin-Create, Edit, and Delete Skins (advanced permission model) can manage Space-level skins. For information about roles and permissions, see Chapter 20, "Understanding WebCenter Spaces Security."

14.1 What You Should Know About Skins

A skin is a resource that defines colors, fonts, and other aspects of various components used on the pages of a Space. A skin changes the way the user interface appears, and not how the application functions.

Skins are based on the Cascading Style Sheet (CSS) specification. A skin is made up of various selectors that define the CSS styles or properties of different parts of a component. You can adjust the look and feel of any component by changing its style-related properties. Some selectors, like a background or foreground color or a font style, may be global and affect all components.

Out-of-the-box, WebCenter Spaces provides certain built-in skins (Figure 14-1). Authorized users can change the appearance of a specific Space or the entire application by using built-in skins.

Figure 14-1 Built-in Skins

If built-in skins do not quite match your requirements, you can create custom skins of your own within WebCenter Spaces to brand your application or Space as desired.

WebCenter Spaces also gives you the flexibility to use an IDE like Oracle JDeveloper to create new skins or edit custom WebCenter Spaces skins. You can then upload these skins back into WebCenter Spaces.

14.2 Creating a Skin

If you have specific branding requirements for the way your application looks, you may want to create a custom skin of your own instead of using built-in skins. In WebCenter Spaces, you can create skins at two levels—application level and Space level.

To create a custom skin:

1. Navigate to the Resources page of your application or the Space in which you want to create the custom skin, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Look and Layout, select Skins.

3. On the menu bar, click Create.

4. In the Create New Skin dialog, in the Name field, enter a name for the custom skin (Figure 14-2).

Figure 14-2 The Create New Skin Dialog

5. In the Description field, enter a description for the custom skin.
The description is displayed below the skin name on the Resources page and as a tool tip when selecting a skin. You should ensure that the description helps users determine if they want to use this particular skin.

6. From the Copy from list, select an existing skin to use as the starting point for your new custom skin.

Tip:

You can also create a new custom skin by making a copy of an existing skin, as described in Section 14.4.4, "Copying a Skin."

7. Click OK.
The newly created custom skin is listed on the Resources page. The gray circle icon next to the custom skin indicates that it is not yet published and hence is not available to other users. For information about publishing a skin, see Section 14.4.1, "Showing and Hiding a Skin."

Note:

You can also create skins in tools like Oracle JDeveloper that provide you more control and flexibility in skin creation. For information, see Section 14.6, "Using JDeveloper to Build Your Skins."

14.3 Editing a Custom Skin

This section describes how to edit custom skins. It includes the following subsections:

- Section 14.3.1, "What You Should Know About Skin Editing"

- Section 14.3.2, "Editing the Source Code of a Custom Skin"

- Section 14.3.3, "Editing a Custom Skin Using the Edit Dialog"

14.3.1 What You Should Know About Skin Editing

WebCenter Spaces supports two types of skin editing, source code editing and simple editing.

This section includes the following subsections:

- Section 14.3.1.1, "About Source Code Editing"

- Section 14.3.1.2, "About Simple Editing"

14.3.1.1 About Source Code Editing

Source editing enables you to edit the source code of a custom skin in a text editor. This provides a powerful means of editing all the skin selectors available in a skin's CSS file.

Use the Edit Source dialog to edit a custom skin's source code. In this dialog, the source code is presented on the CSS tab (Figure 14-3).

Figure 14-3 Editing Skin Selectors

A skin's CSS file supports and contains ADF skin selectors and the skin selectors associated with Oracle Composer components. For information about ADF skin selectors, refer to Oracle Fusion Middleware Tag Reference for Oracle ADF Faces Skin Selectors. For information about Oracle Composer components skin-specific selectors, refer to the section "Style Selectors for Oracle Composer Components" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

In addition to ADF and Oracle Composer skin selectors, a skin's CSS file contains three WebCenter Spaces-specific selectors. These include:

- .WCPageTemplate:alias - Defines the background color and the image and its position for the main area of the page template below the top banner, as shown in the example below:

.WCPageTemplate:alias
{
background-image:url(/afr/fusion/dbd_centerGradient.png);
background-repeat:repeat-y;
background-position:top center;
background-color: #024296;
color: white;
}

- .WCContent - Defines the background color of the area of the page template containing the actual page content.

.WCContent
{
background-color:#EEF3F8;
border-top:1px solid #BECFE2;
}

- .WCPortletContentMedium:alias - Defines the background color and image of task flows and portlets in showDetailFrame components.

.WCPortletContentMedium:alias
{
background-image:url(/adf/images/gradient-275x275-fcfcfc.png);
background-repeat:no-repeat;
}

While editing the source code of a custom skin, you can add, edit, or delete any skin selector to suit your requirements. For example, if you want to override the default font size, then in your skin's CSS file, you can specify the required size in the skin selector shown in Example 14-1.

Example 14-1 Overriding the Default Font Size in a Skin's CSS File

.AFDefaultFont:alias
{
font-size:12px;
}

When you edit the code using the Edit Source dialog, the format of the code is validated and an error message is displayed if you miss any tags or add them incorrectly.

For information about how to edit the source code of a skin, see Section 14.3.2, "Editing the Source Code of a Custom Skin."

14.3.1.2 About Simple Editing

Simple editing provides a simple means of editing a skin's basic appearance settings: font, background color, and background image. To perform simple editing, you use the Edit dialog (Figure 14-4).

Figure 14-4 The Edit Dialog

In the Edit dialog, you can define settings for the target areas listed below. Each target area maps to a WebCenter-specific skin selector available in a skin's CSS file (described in Section 14.3.1.1, "About Source Code Editing.")

- Page Template - Enables you to define the background color, background image, and font for the template used on a page. In a Skin's CSS file, this target area maps to the .WCPageTemplate:alias selector, which is used by all page templates.

- Page - Enables you to choose the color and image of the page background. This target area sets the .WCContent style selector in the CSS file.

- Task Flow/Portlet - Enables you to define the background color and image of task flows and portlets on a page. In the CSS file, this sets the .WCPortletContentMedium:alias selector, which defines the background color of Show Detail Frames that use medium background.

For information about how to edit the source code of a skin, see Section 14.3.3, "Editing a Custom Skin Using the Edit Dialog."

14.3.2 Editing the Source Code of a Custom Skin

Use the Edit Source dialog to expose the underlying code of a custom skin and make adjustments to the skin selectors that make up the skin.

Caution:

You must have a thorough understanding of CSS specification about selectors if you plan to edit skin selectors. You might get into a situation where you are not sure why your style is not getting picked up, whereas it could very well be that the skin you are extending has a selector that is more specific than your selector.

To edit the source code of a custom skin:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Look and Layout, click Skins.

3. From the list of skins displayed on the right, select the skin whose source code you want to edit.

4. From the Edit menu, choose Edit Source.

5. In the Edit Source dialog, change the required settings (Figure 14-5).

Figure 14-5 Editing Skin Selectors

6. Click OK.

14.3.3 Editing a Custom Skin Using the Edit Dialog

To perform simple editing of a custom skin using the Edit dialog:

1. Navigate to the Resources page of your application or the desired Space, as described in Section 10.1.4, "Accessing Resources."

2. In the left navigation panel, under Look and Layout, click Skins.

3. From the list of skins displayed on the right, select the skin that you want to edit.

4. From the Edit menu, choose Edit.

Figure 14-6 Editing Skin Properties

5. In the Edit dialog, from the Item list, select the target area for which you want to update skin properties.
Select any one of the following options:

- Page Template - Select to choose the background color, background image, and font for the template used on a page.

- Page - Select to choose the color and image of the page background.

- Task Flow/Portlet - Select to choose the background color and image of task flows and portlets on a page.

6. From the Background Color list, select the background color you want to use for the target area.
When you select a background color, its RGB value appears in the Color field, and the selected target area is highlighted with that color in the Preview panel on the right.

7. In the Image field, enter the URI path of the image you want to use as a background image.

Note:

You can either specify an absolute URL (where the URL should also work if entered in a browser address field), or a relative URL that points to an image located somewhere in WebCenter Spaces. To store an image in Spaces, you must upload the required file using the Documents service, as described in Section 41.8.1, "Uploading New Files." You can then obtain the image's URL as described in Section 41.24.1, "Retrieving the URL for a Folder or File."

8. You can choose to repeat the background image horizontally and/or vertically. Depending on your requirement, select the following checkboxes:

- Repeat Horizontally - Select to show the background image aligned horizontally at the top of the page, with the image repeated across the horizontal bar (Figure 14-7).

Figure 14-7 Repeating an Image Horizontally Across a Target Area

- Repeat Vertically - Select to show the background image aligned vertically on the left side of the page, with the image repeated across the vertical bar (Figure 14-8).

Figure 14-8 Repeating an Image Vertically Across a Target Area

If you select both these checkboxes, copies of the selected image are repeated across the entire target area (Figure 14-9).

Figure 14-9 Repeating an Image Across the Entire Target Area

9. From the Font Family list, select the font you want to use for the Page Template area.
The Font list is displayed only when Page Template is selected as the target area.

10. Click OK.

14.4 Managing a Skin

This section describes the tasks involved in managing skins. It includes the following subsections:

- Section 14.4.1, "Showing and Hiding a Skin"

- Section 14.4.2, "Setting Properties on a Skin"

- Section 14.4.3, "Setting Security on a Skin"

- Section 14.4.4, "Copying a Skin"

- Section 14.4.5, "Deleting a Skin"

- Section 14.4.6, "Viewing Information About a Skin"

14.4.1 Showing and Hiding a Skin

When you create a custom skin, by default it is marked as hidden. A hidden skin is not available for use in the application, Home Space, or any other Space. To make a skin available, you must publish it. Further, for a custom skin created at the application level, you can control whether it is available to all or only selected Spaces in the application.

Showing or hiding a skin follows the same procedure as any other resource. For information, see Section 10.4.3, "Showing and Hiding Resources."

For generic information about resource availability in Spaces, see Section 10.4.2, "Setting Properties on a Resource."

14.4.2 Setting Properties on a Skin

A range of properties is associated with custom skins that authorized users can access through the Edit Properties dialog.

This section includes the following subsections:

- Section 14.4.2.1, "What You Should Know About Skin Properties"

- Section 14.4.2.2, "Naming, Describing, and Categorizing a Custom Skin"

- Section 14.4.2.3, "Associating an Icon with a Custom Skin"

- Section 14.4.2.4, "Setting the Availability of an Application-Level Custom Skin"

- Section 14.4.2.5, "Working with a Custom Skin's Attributes"

14.4.2.1 What You Should Know About Skin Properties

Use custom skin properties to:

- Enter a display name and description

- Provide an icon for use

- Apply a category to classify a skin

- Specify availability (for application-level skins only)

- Associate attribute name/value pairs, for example, to control whether a page based on a selected page style opens in view or edit mode once it is created

Figure 14-10 shows the Edit Properties dialog of a custom skin. You specify the various properties in the General, Exclude Resource Usage, and Attributes sections.

Figure 14-10 Setting Skin Properties

With each custom skin, three default attributes are associated: skinId, skinFamily, and skinExtends. Table 14-1 provides a description of these attributes.

Note:

As an authorized user, you can add, modify, or delete the attributes of a custom skin. However, you must have a thorough understanding of these attributes if you want to manage them.

Table 14-1 Default Attributes of a Skin

Attribute

Description

skinId

Specifies the unique identifier of a skin. Typically, it is a combination of the skin family and the render kit, for example BrightBlue.desktop.

skinFamily

Specifies the family to which a skin belongs. It is an identifier that can be used by a number of skins with different renderkits. For example, you could have a family named BrightBlue. It can be used with renderkit desktop or mobile.

skinExtends

Specifies the ID of the skin being extended. For example, suppose you like the midnight skin, but want a different font size in that skin. You can configure your skin to extend the midnight.desktop skin and then you can edit the source code of your skin to override the font size.

14.4.2.2 Naming, Describing, and Categorizing a Custom Skin

Setting the name, description, and category of a custom skin follows the same procedure as any other resource. For information, see Section 10.4.2.3, "Renaming, Describing, and Categorizing a Resource."

14.4.2.3 Associating an Icon with a Custom Skin

Associating an icon with a custom skin follows the same procedure as any other resource. For information, see Section 10.4.2.4, "Associating an Icon with a Resource."

14.4.2.4 Setting the Availability of an Application-Level Custom Skin

Setting the availability of an application-level custom skin in a Space follows the same procedure as any other resource. For information, see Section 10.4.2.5, "Setting the Availability of an Application-Level Resource in Other Spaces."

14.4.2.5 Working with a Custom Skin's Attributes

Setting the attributes of a custom skin follows the same procedure as any other resource. For information, see Section 10.4.2.6, "Working with the Attributes of a Resource."

For information about default skin attributes, see Table 14-1.

14.4.3 Setting Security on a Skin

You can control whether all users or only specific users or groups can access the custom skin that you created in your application or Space. Setting access to a custom skin follows the same procedure as any other resource. For more information, see Section 10.4.4, "Setting Security for a Resource."

14.4.4 Copying a Skin

WebCenter Spaces enables you to create copies of a skin. You can use this feature when you want to back up a skin or update a skin while keeping the original in use.

Copying a skin follows the same procedure as any other resource. For the generic procedure, see Section 10.4.1, "Copying a Resource."

14.4.5 Deleting a Skin

Provided you are assigned the required permissions, you can delete any custom skin. Deleting a skin follows the same procedure as deleting any other resource. For information, see Section 10.4.5, "Deleting a Resource."

14.4.6 Viewing Information About a Skin

Each skin has an associated About page that summarizes useful information about it (Figure 14-11).

Accessing information about a skin follows the same procedure as any other resource. For information about how to access the About dialog, and for a description of the properties displayed in the dialog, see Section 10.1.5, "Viewing Information About a Resource."

For information about skin-specific default attributes, see Table 14-1.

Figure 14-11 About Dialog of a Skin

14.5 Applying a Skin

As a WebCenter Spaces Administrator, you may customize the default appearance of WebCenter Spaces for all users by changing its skin. As a Space moderator, you may customize the appearance of your Space for all members by changing its skin. Individual users can change the skin applied to their Home Space through user preference settings.

This section includes the following subsections:

- Section 14.5.1, "Applying a Skin to WebCenter Spaces"

- Section 14.5.2, "Applying a Skin to a Space"

- Section 14.5.3, "Applying a Skin to Your Home Space"

14.5.1 Applying a Skin to WebCenter Spaces

When you set a skin for the WebCenter Spaces application, the skin is applied to the Home Spaces and all Spaces that use the application-level skin setting. The skin is also applied to any new Spaces that are created. However, the skin is not applied to existing Spaces for which a specific skin has already been set. Also, the skin is not applied to the administration pages. By default, these pages use the Fusion FX skin.

To apply a skin to the WebCenter Spaces application:

1. Open WebCenter Spaces Administration. See Section 4.1, "Accessing the WebCenter Administration Page."

2. Click the Configuration tab.

3. In the Global section of the General tab, select the desired skin from the Application Skin list (Figure 14-12).

Figure 14-12 Applying a Skin to WebCenter Spaces

Note:

If the desired skin does not appear in the Application Skin list, it may be because it is marked as hidden. A skin must be marked as Available to be available for selection. For information, see Section 14.4.1, "Showing and Hiding a Skin."

4. Click Apply.
The skin you select is applied to Home Space, new Spaces, and all Spaces that use the application-level skin setting. The skin is not applied to Spaces that override the application-level skin setting.

14.5.2 Applying a Skin to a Space

When you apply a skin to a Space, the skin is applied to all the pages of the Space. However, the administration pages are not affected; they always appear in the default skin. For information about applying a skin to a Space, see Section 51.4.10, "Changing the Skin for a Space."

14.5.3 Applying a Skin to Your Home Space

For information about applying a skin to your Home Space, see Section 35.5, "Changing the Home Space Look and Feel in Your View."

14.6 Using JDeveloper to Build Your Skins

You may want to create a skin that is beyond the editing capabilities of WebCenter Spaces, or you may prefer working in JDeveloper. To do this, you have several options:

- Use the Edit Source option to edit the source code of the skin. You can edit the source code directly in the Edit Source dialog or you can copy the contents of the dialog to JDeveloper for editing and then copy the edited code back into the dialog. For more information, see Section 14.3.2, "Editing the Source Code of a Custom Skin."

- Download an existing WebCenter Spaces skin, import the skin into JDeveloper, edit the skin, and then upload it back to WebCenter Spaces.

- Create a completely new skin in JDeveloper and upload it to WebCenter Spaces.

The steps to upload and download skins from WebCenter Spaces are described in Section 10.5.2, "Downloading a Resource" and Section 10.5.3, "Uploading a Resource."

Oracle provides a special JDeveloper workspace (DesignWebCenterSpaces.jws) for developing WebCenter Spaces resources, including skins. The workspace offers a design environment in which to create and edit your skins, and also enables you to upload your skins to WebCenter Spaces for testing. For more information and to download the JDeveloper workspace, see "Developing WebCenter Spaces Resources" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

For information about specific considerations for creating skins for use in WebCenter Spaces, see the chapter "Creating and Managing Skins" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

15 Working with Page Styles

In planning and building your portal, you may find it useful to offer a wide selection of page styles to the users who add pages to your portal. It may also be useful to restrict page styles so that users build only the types of pages that you intend.

This chapter provides information about default, out-of-the-box page styles included with WebCenter Spaces and the custom page styles that you add your portal.

This chapter includes the following sections:

- Section 15.1, "What You Should Know About Page Styles"

- Section 15.2, "Creating a Custom Page Style"

- Section 15.3, "Editing the Source Code of a Custom Page Style"

- Section 15.4, "Managing Page Styles"

- Section 15.5, "Applying a Page Style"

- Section 15.6, "Using JDeveloper to Build Your Page Style"

See Also:

For general information about adding and editing different types of resources, see Chapter 10, "Working with the Resources that Compose a Portal or Community."

Audience

This chapter is intended for users who want to provide and manage page styles in a WebCenter Spaces application. By default, users with an application-level role that includes the permissions Application: Manage All and Page Styles: Create, Edit, and Delete Page Styles or a Space role that includes the permissions Administration: Manage All and Resources: Create, Edit, and Delete Resources can perform the actions described in this chapter.

15.1 What You Should Know About Page Styles

When users create a page, a Create Page dialog opens with a selection of page styles (Figure 15-1).

Figure 15-1 Create Page Dialog

Page styles describe the layout of a newly created page and may also dictate the type of content the page supports. For example, the Wiki page style provides a one-column layout and automatic connection to Oracle Content Server, which provides wiki services; a Blank page style provides a one-column layout and has few restrictions on the types of content users can add to the pages that are based on it.

All page styles are provided to the Create Page dialog through the Resource Manager (Figure 15-2).

Figure 15-2 Application-Level Resources Manager

Application-level page styles are provided on the Resources page accessed through the Administration link. Space-level page styles are provided on the Resources page in the administration settings for a Space.

The difference between application- and Space-level page styles is one of scope:

- Application-level page styles are available to all spaces.

- Space-level page styles are available only in the space in which they reside.

There may be more page styles available on the Resources tab than appear in a Create Page dialog. The site administrator and the Space moderator determine which page styles are shown in the dialog through the following considerations:

- Is the page style shown or hidden?
For more information, see Section 15.4.1, "Showing and Hiding a Page Style in the Create Page Dialog."

- Has the page style been configured to appear in specific Spaces (custom application-level page styles only)?
For more information, see Section 15.4.1, "Showing and Hiding a Page Style in the Create Page Dialog."

WebCenter Spaces offers a range of page styles out of the box (default page styles) and provides a means of copying page styles and editing their source (custom page styles). You can also download custom page styles, bring them into Oracle JDeveloper for additional customization, and upload them back into WebCenter Spaces. The difference between default and custom page styles is one of flexibility: many of the actions available to custom page styles are not available to default page styles.

Table 15-1 compares the types of actions authorized users can perform on default and custom page styles in WebCenter Spaces.

Table 15-1 Actions Available to Default and Custom Page Styles

Action

Default

Custom

More Information

Upload

Yes

Yes

Section 10.5.3, "Uploading a Resource"

Download

No

Yes

Section 10.5.2, "Downloading a Resource"

Preview

Yes

Yes

This control provides a means of previewing the page style. Select a page style and click Preview to render the page style in a page.

Copy

Yes

Yes

Section 10.4.1, "Copying a Resource"

Security Settings

No

Yes

Section 15.4.3, "Setting Security on a Custom Page Style"

Delete

No

Yes

Section 15.4.5, "Deleting a Custom Page Style"

Hide/Show

Yes

Yes

Section 15.4.1, "Showing and Hiding a Page Style in the Create Page Dialog"

Edit Source

No

Yes

Section 15.3, "Editing the Source Code of a Custom Page Style"

Edit Properties

No

Yes

Section 15.4.2, "Setting Properties on a Custom Page Style"

About

Yes

Yes

Section 10.1.5, "Viewing Information About a Resource"

Table 15-2 lists, and describes the default page styles provided with WebCenter Spaces out of the box.

Table 15-2 Default Page Styles

Name

Illustration

Description

Blank

A one-column page with one layout box into which you can add content, including additional layout components.

Blog

A page preconfigured to expose blog controls from the Oracle Content Server. This page style becomes available in the Create Page dialog when the server is integrated with WebCenter Spaces.

Home Page

A preseeded Home page, based on the Right Narrow Column Layout page style. The Home page style comes prepopulated with task flows and other content.

Left Narrow

A two-column page with two layout boxes into which you can add content, including additional layout components. Layout boxes are positioned side-by-side, with the narrower layout box on the left.

Right Narrow

A two-column page with two layout boxes into which you can add content, including additional layout components. Layout boxes are positioned side-by-side, with the narrower layout box on the right.

Three Column

A three-column page with three layout boxes into which you can add content, including additional layout components. Layout boxes are positioned side-by-side, with the narrower layout boxes on the left and right sides.

Switching this page style is allowed.

Web Page

A page that takes a URL value, enabling you to expose external web content in your WebCenter Spaces application.

Wiki

A page preconfigured to expose wiki controls from the Oracle Content Server. This page style becomes available in the Create Page dialog when the server is integrated with WebCenter Spaces.

For both application- and Space-level page styles, the About action opens a dialog that provides information about the selected page style. For more information, see Section 10.1.5, "Viewing Information About a Resource."

15.2 Creating a Custom Page Style

There is no direct way to create a page style in WebCenter Spaces. That is, no Create button is available for starting this process. To create a new page style, you must first copy an existing style and then revise its source code in the source code editor or through JDeveloper. Or, you can create a page style in JDeveloper and upload it to WebCenter Spaces.

For information about revising a page style's source code, see Section 15.3, "Editing the Source Code of a Custom Page Style." For information about copying a page style, see Section 15.4.4, "Copying a Page Style." For information about working with WebCenter Spaces page styles in Oracle JDeveloper, see the section, "Developing and Uploading WebCenter Spaces Resources," in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

15.3 Editing the Source Code of a Custom Page Style

Source editing enables you to work with the source code of a custom page style. For example, you can upload a page style you create in JDeveloper and perform additional adjustments to it through the Edit Source dialog. You can even create a style from scratch in the Edit Source dialog, but this entails a lot of hand coding, and we do not recommend it.

This section provides information about editing custom page style source and steps you through the process of editing a custom page style. It includes the following subsections:

- Section 15.3.1, "What You Should Know About Editing Page Style Source"

- Section 15.3.2, "Editing Custom Page Style Source"

See Also:

For general information about editing the source of a resource, see Section 10.3.2, "Editing the Source Code of a Resource."

15.3.1 What You Should Know About Editing Page Style Source

Use the Edit Source dialog to expose the underlying code of a selected custom page style and make adjustments to it. For example, you can create a new page style in JDeveloper, upload it to WebCenter Spaces through the Resource Manager, preview it, and edit the source to make adjustments.

In contrast, you can copy a default page style, download the copy to your local drive, bring it into JDeveloper for customization, upload it back into WebCenter Spaces, and open it in the Edit Source dialog for further adjustments.

You can simply copy a default page style and make adjustments to the copy's source in the Edit Source dialog.

You can even create a page style from the beginning, by copying another page style, and then replacing its code with your own original code through the Edit Source dialog. Note, however, that, due to the heavy hand-coding requirement, we do not recommend this scenario.

In the Edit Source dialog, the custom page style source is presented on two tabs: Page and Page Definition. The Page tab source defines the page layout and style. The Page Definition tab source holds parameter definitions and task flow and data control bindings. Each represents the underlying *.jspx page and page definition file that comprise the page style.

Example 15-1 illustrates custom page style encoding. It creates a basic page that is designed to flow and provide two columns that are 35 percent and 65 percent in proportion. This is an example of a custom page style that was created in JDeveloper, imported into WebCenter Spaces, and opened in the Edit Source dialog Page tab for minor revisions. The relevant code is in bold.

Example 15-1 Source Code of a Custom Page Style

<?xml version='1.0' encoding='utf-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page"
xmlns:pe="http://xmlns.oracle.com/adf/pageeditor"
xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
xmlns:trh="http://myfaces.apache.org/trinidad/html" version="2.1">
<jsp:directive.page deferredSyntaxAllowedAsLiteral="true"/>
<jsp:directive.page contentType="text/html;charset=utf-8"/>
<f:view>
<af:document title="#{pageDocBean.title}" id="docrt">
<af:form usesUpload="true" id="f1">
<af:pageTemplate value="#{bindings.shellTemplateBinding.templateModel}"
id="T">
<f:facet name="content">
<pe:pageCustomizable id="pcl1">
<af:panelGroupLayout id="pgl1" layout="scroll"
styleClass="replace_with_scheme_name"
inlineStyle="replace_with_inline_style">
<trh:tableLayout id="tl1" width="100%">
<trh:rowLayout id="rl1">
<trh:cellFormat id="cf1" width="35%" valign="top">
<cust:panelCustomizable id="hm_pnc1" layout="scroll"/>
</trh:cellFormat>
<trh:cellFormat id="cf2" width="65%" valign="top">
<cust:panelCustomizable id="hm_pnc2" layout="scroll"/>
</trh:cellFormat>
</trh:rowLayout>
</trh:tableLayout>
<trh:tableLayout id="tl2"/>
</af:panelGroupLayout>
<f:facet name="editor">
<pe:pageEditorPanel id="pep1"/>
</f:facet>
</pe:pageCustomizable>
</f:facet>
</af:pageTemplate>
</af:form>
</af:document>
</f:view>
</jsp:root>

15.3.2 Editing Custom Page Style Source

The following procedure works equally for custom page styles edited in a Space and those edited at the application level

To edit the source of a custom page style:

1. Go to the Space or application-level Resources page, and select Page Styles from the panel on the left.

Tip:

You can use "pretty URLs" to navigate to the Resources page:

- Application-level Resources page:

http://host:port/webcenter/spaces/admin/resources

- Space-level Resources page:

http://host:port/webcenter/spaces/spaceName/admin/resources

2. Select the custom page style, and then from the Edit menu select Edit Source to open the selected page style in the Source Editor (Figure 15-3).

Figure 15-3 Source Editor

3. Make changes to the source according to your requirements.

4. When finished, click OK to save your changes and close the editor.

15.4 Managing Page Styles

This section provides information about managing your seeded and custom page styles. It includes the following sections:

- Section 15.4.1, "Showing and Hiding a Page Style in the Create Page Dialog"

- Section 15.4.2, "Setting Properties on a Custom Page Style"

- Section 15.4.3, "Setting Security on a Custom Page Style"

- Section 15.4.4, "Copying a Page Style"

- Section 15.4.5, "Deleting a Custom Page Style"

- Section 15.4.6, "Previewing a Page Style"

15.4.1 Showing and Hiding a Page Style in the Create Page Dialog

When you create a page style, by default it is hidden. A hidden page style is not available for use in the application, the Home Space, or any other Space. To make a page style available, it must be marked as shown. Further, for a page style created at the application level, you can control whether it is available to any, all, or selected Spaces in the application. Finally, you can set access on a selected page style through its security settings.

- For information about a page style's security settings, see Section 15.4.3, "Setting Security on a Custom Page Style."

- For information about a page style's exclusion settings, see Section 10.4.2, "Setting Properties on a Resource."

- For information about hiding and showing application resources, including page styles, see Section 10.4.3, "Showing and Hiding Resources."

15.4.2 Setting Properties on a Custom Page Style

You can control a page style's display attributes and availability by setting its properties in the Edit Properties dialog. Setting page style properties follows the same procedure as any other resource. For more information, see Section 10.4.2, "Setting Properties on a Resource."

Tip:

To view the properties associated with a resource, use the About option.

In addition to the default attributes exposed through the Edit Properties dialog (Display Name, Description, and the like), you can expose any custom attributes built into an custom page style. The Edit Properties dialog provides a Custom Attributes section for entering attribute name/value pairs (Figure 15-4).

Figure 15-4 Attributes Section of Edit Properties Dialog

For example, the following custom attribute is available to all custom page styles:

editPageAfterCreation

This custom attribute controls whether a newly created page opens in edit or view mode. It takes a value of true or false:

- Enter ${true} to open a newly created page in edit mode. This is the default value.

- Enter ${false} to open a newly created page in view mode.

When you associate this custom attribute with a particular page style, every time a user creates a page based on that style, the attribute value is considered and the page behaves accordingly.

15.4.3 Setting Security on a Custom Page Style

You can control whether all users or only specific users or groups can access the page style that you created in your application or Space. Setting access to a page style follows the same procedure as any other resource. For more information, see Section 10.4.4, "Setting Security for a Resource."

15.4.4 Copying a Page Style

You can make a copy of a page style by selecting it and choosing Copy from the Edit menu on the Resources - Page Styles page. Copying a page style follows the same procedure as any other resource. For the generic procedure, see Section 10.4.1, "Copying a Resource."

15.4.5 Deleting a Custom Page Style

Provided you are assigned the required permissions, you can delete any custom page style. Deleting a page style follows the same procedure as any other resource. For more information, see Section 10.4.5, "Deleting a Resource."

15.4.6 Previewing a Page Style

You can preview how a page style will look by selecting it on the Resources - Page Styles page and clicking Preview. For more information, see Section 10.4.6, "Previewing a Resource."

15.5 Applying a Page Style

Once you have made a page style available (see Section 15.4.1, "Showing and Hiding a Page Style in the Create Page Dialog"), you can apply it by selection. That is, when you create a page, the page style is shown as one of your options in the Create Page dialog, depending on where you have exposed it (for example, at the application level, in a Space, in a selection of Spaces, or in the views of selected users or groups). To apply a page style, select it in the Create Page dialog.

Tip:

For information about accessing the Create Page dialog, see Section 17.2, "Creating Pages."

15.6 Using JDeveloper to Build Your Page Style

If you want to create a page style that is beyond the editing capabilities of WebCenter Spaces, you can download the page style, import it into Oracle JDeveloper for editing, and then upload it back to WebCenter Spaces. You can upload page styles directly to WebCenter Spaces from within JDeveloper or through WebCenter Spaces.

The steps to upload and download page styles from WebCenter Spaces are described in Section 10.5.2, "Downloading a Resource," and Section 10.5.3, "Uploading a Resource."

For information about editing resources and uploading custom resources to WebCenter Spaces through JDeveloper, see the section, "Developing and Uploading WebCenter Spaces Resources," in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

16 Working with Resource Catalogs

Oracle WebCenter Spaces provides rich Resource Catalogs, also known as Business Dictionaries, which expose components and connections that WebCenter Spaces users can add to their pages. You can use a Resource Catalog to populate resources such as page templates, navigation models, pages, and task flows. WebCenter applications are preconfigured with three Resource Catalogs out-of-the-box. If these catalogs do not meet your business requirements, you can modify them or create new ones.

This chapter provides information about the default, out-of-the-box Resource Catalogs included in WebCenter Spaces, and also describes how to create and manage Resource Catalogs. It includes the following sections:

- Section 16.1, "What You Should Know About Resource Catalogs"

- Section 16.2, "Creating Resource Catalogs"

- Section 16.3, "Editing a Resource Catalog"

- Section 16.4, "Showing and Hiding a Resource Catalog"

- Section 16.5, "Setting Properties on a Resource Catalog"

- Section 16.6, "Setting Security on a Resource Catalog"

- Section 16.7, "Copying a Resource Catalog"

- Section 16.8, "Deleting a Resource Catalog"

- Section 16.9, "Using JDeveloper to Build Your Resource Catalog"

- Section 16.10, "Configuring Resource Catalogs in Your Application"

For generic information about adding and editing different types of resources, see Chapter 10, "Working with the Resources that Compose a Portal or Community."

Audience

This chapter is intended for users who want to provide and manage Resource Catalogs in their Oracle WebCenter Spaces application. Portal designers with the application permission Application-Resource Catalogs-Create Edit Delete can manage application-level Resource Catalogs. Space moderators with the permission Space-Resources-Create Edit Delete (simple permission model) or Space-Resource Catalogs-Create Edit Delete (detailed permission model) can manage Space-level Resource Catalogs. For information about roles and permissions, see Chapter 20, "Understanding WebCenter Spaces Security."

16.1 What You Should Know About Resource Catalogs

The Resource Catalog is displayed when you edit a page or page template in Oracle Composer and click Add Content. You can add resources from the catalog on to your page or page template.

As a WebCenter Spaces user, you can use a Resource Catalog to populate pages in Oracle Composer.

As an administrator or delegate, you can use a Resource Catalog to populate the following artifacts in the Resources Manager:

- Page templates

- Task flows

16.1.1 Understanding the Out-of-the-Box Resource Catalogs

WebCenter Spaces provides the following out-of-the-box Resource Catalogs:

- Default Home Space Catalog - The application-level Resource Catalog. You see this catalog when you edit a page or task flow in your Home space.

- Default Space Catalog - The Space-level Resource Catalog. You see this catalog when you populate a page or task flow within a Space.

- Default Page Template Catalog - The catalog used for page template creation in both your Home Space and other Spaces. You see this catalog when you edit a page template.

This section describes these catalogs. It includes the following subsections:

- Section 16.1.1.1, "Default Home Space Catalog"

- Section 16.1.1.2, "Default Space Catalog"

- Section 16.1.1.3, "Default Page Template Catalog"

16.1.1.1 Default Home Space Catalog

This catalog is displayed when designing pages and task flows in your application. The Default Home Space Catalog (Figure 16-1) contains items that users may typically want to add to a task flow or a business role page, such as page layout components, portlets, and WebCenter Services task flows.

Figure 16-1 Resource Catalog Used to Populate Pages

Table 16-1 provides a description of each folder in the default Resource Catalog.

Table 16-1 Resources in the Default Resource Catalog

Folder Name

Description

Alerts and Updates

Includes task flows from the following WebCenter Services to track alerts and notifications:

- Activity Stream, to view activities of your connections, actions taken in Spaces, and business activities. For more information, see Chapter 32, "Tracking Your Connections' Activities."

- Announcements, to view current announcements. For more information, see Chapter 59, "Working with the Announcements Service."

- Discussion Forums, to list the most frequently used and most recently accessed topics. For more information, see Chapter 60, "Working with the Discussions Service."

- Documents, to list recently created or modified documents. For more information, see Section 41.1, "What You Should Know About the Documents Service Task Flows."

- Notifications, to view Space- and object-level subscriptions. For more information, see Section 36.5, "Working with Notifications Task Flows."

- Polls, to view available polls. For more information, see Chapter 67, "Working with the Polls Service."

- RSS, to view feeds from external sources and WebCenter services. For more information, see Section 68.3, "Working with the RSS Task Flow."

- Worklist, to view all worklist items that require your attention. For more information, see Chapter 70, "Working with the Worklist Service."

Analytics

Includes the Analytics service task flows. These task flows help to track and display different metrics, such as response times and usage behavior, for the WebCenter Spaces application.

For more information, see Chapter 55, "Analyzing Usage and Performance Metrics."

Content Management

Includes the documents task flows, which can be used to access, add, and manage folders and files, or display content in a predefined template.

For more information, see Part X, "Working with Content".

Mash-Ups

Includes the following resources that enable you to create business mashups:

- Data Controls: Folder that includes data controls created for the application at design time and runtime.
For more information about these items, see Chapter 26, "Creating Business Mashups."

- Task Flows: Folder that includes task flows created in the Resource Manager at runtime. These are visualizations created by gathering data from various data sources and publishing to different layouts such as charts, tables, and graphs.
For more information, see Chapter 26, "Creating Business Mashups."

- Omniportlet: A portlet to publish data from a variety of data sources (including SQL, XML, web services, spreadsheets, and web pages) to several different layouts, such as customizable charts and tables

- Pagelet Producers: Folder that includes pagelets deployed in the pagelet producer. For more information, see Section 6.5.2.3, "Registering a Pagelet Producer."

Polls and Surveys

Includes the Polls service task flows that can be used to create, edit, and take online polls on your application pages. Polls let you survey your audience, check whether they can recall important information, and gather feedback on the efficacy of presentations.

For more information, see Chapter 67, "Working with the Polls Service."

Portlets

Includes the following resources:

- Administrator-level tools for registering and managing external applications and portlet producers.

- Portlets, which provide a means of presenting data from multiple sources in a meaningful and related way. Out-of-the-box, this folder contains the Omniportlet and Web Clipping portlets.

For more information, see Chapter 25, "Understanding Portlet Basics."

Social and Communication

Includes the following resources to enable social networking and communication among users:

- Lists folder: Includes individual Space lists. The folder is displayed only if it contains resources inside it. For more information about these items, see Chapter 64, "Working with the Lists Service."

- Message Board - Quick View: WebCenter Services task flow used for adding, viewing, updating, hiding, and deleting messages. For more information, see Section 33.4, "Working with Message Board and Feedback Task Flows."

- Message Board: WebCenter Services task flow used for adding, viewing, updating, hiding, deleting, and managing your view of messages.

- Organization View: WebCenter Services task flow used for adding a graphical depiction of the current user's position within the company. which provides quick access to contact and status information about you and your connections.

- Profile - Snapshot: WebCenter Services task flow used for viewing a user photo and status message. For more information, see Chapter 30, "Managing Your Profile."

- Profile: WebCenter Services task flow used for displaying a user's profile details and uploading a photo.

- Profile Gallery: WebCenter Services task flow used for accessing all of your social networking information from one view.

- Connections: WebCenter Services task flow used for viewing and managing your connections, and creating connections lists. For more information, see Section 31.1, "What You Should Know About Connections."

- Connections - Card: WebCenter Services task flow used for photos, status messages, and instant contact options to your connections.

- Connections - Detailed View: WebCenter Services task flow used for photos and quick access to your connections and to features for inviting new connections and organizing your connections into lists.

- Connections - Quick View: WebCenter Services task flow used for photos and quick access to your connections.

- Recommended Connections: WebCenter Services task flow used for viewing and connecting to people considered to be similar to you.

- Similar Items: WebCenter Services task flow used for listing items that are similar to the currently selected item on the page. For more information, see Section 58.2, "Working with Activity Graph Service Task Flows."

- Mail: WebCenter Services task flow used for viewing, responding to, and managing your personal mail. For more information, see Section 65.4, "Working with the Mail Service Task Flow."

- Watched Topics: WebCenter Services task flow used for providing a cohesive view of all the topics you have selected to watch from a particular Space or from all Spaces. For more information, see Section 60.2, "Working with Discussions Service Task Flows."

- Watched Forums: WebCenter Services task flow used for viewing all discussion forums you have selected to watch from a particular Space or from all Spaces.

- Forums: WebCenter Services task flow used for viewing Recent Topics, Popular Topics, Watched Topics, and Watched Forums.

- Events: WebCenter Services task flow used for adding calendars that you can use to schedule meetings, appointments, and any other type of occasion. For more information, see Section 61.1, "What You Should Know About the Events Service."

- Blogs: WebCenter Services task flow used to expose a blog on a page along with other services instead of having a dedicated blog page. For more information, see Section 48.2.1.2, "Adding a Blogs Task Flow."

- Publisher: WebCenter Services task flow used for publishing messages, files, and URLs to the Activity Streams of all of your connections or to those connections who have access to a specified Space. For more information, see Section 34.3.3.1, "What You Should Know About the Publisher Task Flow."

Tagging and Searching

Includes the following WebCenter Services task flows to enable effective search of WebCenter and other sources:

- Saved Searches folder: For displaying a list of all searches saved by you or other Space members.

- All Saved Searches: For running saved searches within the application. For more information, see Section 56.3, "Working with Search Service Task Flows."

- Similarly Tagged Items: For displaying a list of links to other pages that have at least one tag in common with the currently-displayed page.

- Tags: For adding a view of the tags you have added to your application and the items you have tagged. For more information, see Section 57.2, "Working with Tags Service Features and Task Flows."

- Tag Cloud: For displaying the tags currently applied to WebCenter Spaces items. For more information, see Section 57.2, "Working with Tags Service Features and Task Flows."

- Tag Cloud Related Resources: For displaying related resources for a selected tag. For more information, see Section 57.2, "Working with Tags Service Features and Task Flows."

Web Development

Includes the following components that you can use to design your pages:

- Data Controls: Includes data controls created for the application at runtime.
For more information, see Chapter 26, "Creating Business Mashups."

- Layout components such as Box, HTML Markup, Hyperlink, Image, Movable Box, Separator, Text, and Web Page.
For more information about these components, see Chapter 18, "Adding and Configuring Page Layout Components."

With the default WebCenter Spaces configuration, this Resource Catalog is displayed when you create pages at the application level.

When creating pages in a Space, the Default Space Catalog is displayed. This catalog is similar to the Default Home Space Catalog, except that its resources display content specific to the Space, where applicable.

16.1.1.2 Default Space Catalog

The Default Space Catalog is the same as the Default Home Space Catalog, except for a few resources that display data relevant to the current Space, for example, the Personal Documents folder, which displays documents associated with the current Space. Table 16-2 describes the resources that are exclusive to the Default Space Catalog.

Table 16-2 Resources that Are Exclusive to the Default Space Catalog

Resource or Folder Name

Description

Similar Spaces

This resource in the Social and Communication folder displays all Spaces that are similar to the one you are currently viewing. For more information, see Section 58.2.3, "Working with the Similar Spaces Task Flow."

Lists folder

This resource in the Social and Communication folder enables you to add lists to pages in your Space. Lists are useful for many Space activities, such as tracking issues, capturing project milestones, publishing project assignments, and much more. However, the Lists service is not available to the Home Space. For more information, see Chapter 64, "Working with the Lists Service."

Members

This resource in the Social and Communication folder lists all members in the Space. For more information, see Section 52.4, "Working with the Space Members Task Flow."

Spaces documents

This resource from the Content Management folder exposes a list of folders and files associated with the current Space. For more information, see Section 39.2, "What You Should Know About Content Management Selections in the Resource Catalog."

16.1.1.3 Default Page Template Catalog

This catalog is displayed when designing page templates. A page template defines the layout of your portal. It defines the location of content on the page and contains artifacts that display on each page of the portal; for example, a navigation pane to the left of the page, a header or banner with the company logo at the top, and a copyright notice at the bottom of the page. When you build a page template, you should be able to add all such components to it. To address this requirement, WebCenter Spaces provides the Default Page Template Catalog to be used for page template creation. For more information about page templates, see Chapter 12, "Working with Page Templates."

In addition to all the folders available in the Default Home Space Catalog (Table 16-1), the Default Page Template Catalog also includes the Template Development folder. This folder includes a Navigations folder and all the resources that are typically used in page templates only, for example logos, navigation components, navigation models, layout components, and copyright statements.

The Navigations subfolder includes three navigation task flows. You can add these task flows, described as follows, to page templates to quickly visualize your portal navigation model:

- Navigation Breadcrumb, to display a series of horizontal or vertical links that show users their current position in the navigation hierarchy.

- Navigation Menu, to display navigational links as a series of tabs, menus, bars, buttons, choices, or as a list.

- Navigation Tree, to display navigational links in a hierarchical structure.

For information about navigation structures, see Chapter 11, "Working with Navigation."

For information about the other resources in the Template Development folder, see Chapter 13, "Adding Spaces Components to Your Templates."

16.1.2 Introducing the Resource Catalog Management Page

If the default catalogs provided in WebCenter Spaces do not meet your company's requirements, you can create custom Resource Catalogs and offer those to users. The Resource Manager, shown in Figure 16-2, provides options to create and manage custom Resource Catalogs.

Only users with permissions to create, edit, and delete Resource Catalogs can access the Resource Manager.

Figure 16-2 Resource Catalogs Page in the Resource Manager

On this page, you can create, copy, publish, edit, preview, and delete Resource Catalogs. When you publish a custom Resource Catalog, it is available for selection on the application's Configuration page or a Space's administration settings.

16.1.3 Understanding the Resource Registry

The Resource Registry is a central repository of all the resources available to the WebCenter Spaces application. It contains all resources that you can add to Resource Catalogs in the application. In addition to the out-of-the-box resources, it is also updated dynamically to include new resources, such as task flows, data controls, and navigations, as and when they are created in the Resource Manager or deployed as shared libraries from JDeveloper. As a result, a resource that is created and published in the Resource Manager is available for consumption right away.

The Resource Registry (Figure 16-4) is displayed when you click the Add From Library option (Figure 16-3) in the Edit dialog for a Resource Catalog.

Figure 16-3 Add From Library Option to Access the Resource Registry

Figure 16-4 Add Resource Catalog Item Dialog (Resource Registry)

Table 16-3 describes the folders in the Resource Registry.

Table 16-3 Folders in the Resource Registry

Resource Folder

Description

Runtime DataControls

Lists all data controls created at runtime. When you add these data controls in a Resource Catalog, you enable users to consume them in pages or task flows using different visualizations such as tables, graphs, buttons, and so on.

For more information, see Section 26.2, "Creating and Managing Data Controls."

This folder is empty if there are no runtime data controls in your WebCenter Spaces instance.

Design Time DataControls

Lists all data controls deployed from JDeveloper. At a minimum, it displays the WebCenter Services data controls that are available out-of-the-box. In addition, it also displays data controls that an application developer may have created in JDeveloper and deployed WebCenter Spaces.

For information about the data controls available for a WebCenter service, refer to the chapter describing that service.

Business Mashups

Lists the task flows created at runtime in the Resources Manager. For more information, see Section 26.3, "Creating and Managing Task Flows."

This folder is empty if there are no runtime task flows in your WebCenter Spaces instance.

Spaces Components

Lists components, such as menus, links, copyright message, and so on, that are typically used in page templates. These resources are available out-of-the-box in the Default Page Template Catalog, in a folder named Template Development.

For more information, see Chapter 13, "Adding Spaces Components to Your Templates."

Components

Lists a selection of layout components that you can use to design pages, templates, and task flows. For more information, see Chapter 18, "Adding and Configuring Page Layout Components."

All Documents

Lists all documents that you have access to. For more information, see Part X, "Working with Content".

Portlet Producers

Lists all registered portlet producers. For more information, see Chapter 25, "Understanding Portlet Basics."

Connections

Lists all available repository connections. Many resources, such as portlets, external applications, and some WebCenter services, require a connection to a database schema where relevant information is stored.

The chapters describing the various resources and services provide information about whether a connection is required for that resource or service.

Task Flows

Lists all task flows deployed from JDeveloper. At a minimum, it displays the WebCenter Services task flows that are available out-of-the-box. In addition, it also displays task flows that an application developer may have created in JDeveloper and deployed WebCenter Spaces.

For information about the task flows available for a WebCenter service or resource, refer to the chapter describing that service or resource.

Resource Catalogs

Lists all available Resource Catalogs. You can embed multiple Resource Catalogs inside a catalog.

Navigations

Lists all available navigations. These resources are available out-of-the-box in the Default Page Template Catalog. For more information, see Chapter 11, "Working with Navigation."

Lists

Displays all the lists created using the Lists service. For more information, see Chapter 64, "Working with the Lists Service."

Saved Searches

Displays all saved searches. For more information, see Chapter 56, "Working with the Search Service."

Analytics

Displays all the Analytics service task flows. These task flows help to track and display different metrics, such as response times and usage behavior, for the WebCenter Spaces application. For more information, see Chapter 55, "Analyzing Usage and Performance Metrics."

16.2 Creating Resource Catalogs

You can build a custom Resource Catalog either from scratch or by extending an existing Resource Catalog. Creating a Resource Catalog follows the same procedure as any other resource. For information about creating a Resource Catalog, see Section 10.2, "Creating Resources." For information about copying an existing Resource Catalog, see Section 10.4.1, "Copying a Resource."

The new Resource Catalog is listed on the Resources - Resource Catalogs page. However, the catalog is hidden by default. To make the new Resource Catalog available to the application or Space, you must do the following:

- Publish it in the Resource Manager. For more information, see Section 16.4, "Showing and Hiding a Resource Catalog."

- Configure the application or Space to use the new catalog as the default one. For more information, see Section 16.10, "Configuring Resource Catalogs in Your Application."

16.3 Editing a Resource Catalog

When you edit a Resource Catalog in the Resource Manager, you are basically managing its resources. The Resource Manager provides the following two options for editing Resource Catalogs:

- Managing resources in the Edit dialog.

- Editing the source code of the Resource Catalog definition file in a text editor.

This section explains both options. It includes the following sections:

- Section 16.3.1, "Managing Resources in the Edit Dialog"

- Section 16.3.2, "Editing the Source Code for a Resource Catalog"

Note:

To perform certain advanced editing tasks, you may want to download the Resource Catalog to JDeveloper, edit it, and upload it back to your WebCenter Spaces instance. For more information, see Section 16.9, "Using JDeveloper to Build Your Resource Catalog."

16.3.1 Managing Resources in the Edit Dialog

The Edit option in the Resource Manager opens an Edit dialog (Figure 16-5), which provides various options to manage resources in the selected Resource Catalog.

Note:

You cannot edit out-of-the-box catalogs. The Edit option on these catalogs is grayed out.

Figure 16-5 Edit Dialog Used to Edit a Resource Catalog

You can edit a Resource Catalog to:

- Create folders

- Create custom components by providing the XML code

- Add resources from the Resource Registry

- Edit resource properties

- Copy resources

- Delete resources

- Rearrange resources

- Preview the catalog

This section describes the steps to perform these tasks. It includes the following subsections:

- Section 16.3.1.1, "Creating a Folder"

- Section 16.3.1.2, "Adding Resources"

- Section 16.3.1.3, "Creating Custom Components"

- Section 16.3.1.4, "Rearranging Resources"

- Section 16.3.1.5, "Setting Properties on a Resource"

- Section 16.3.1.6, "Copying a Resource"

- Section 16.3.1.7, "Deleting a Resource"

- Section 16.3.1.8, "Previewing the Resource Catalog"

16.3.1.1 Creating a Folder

To organize your catalog better, you can group similar resources together; for example, group all layout components or all resources from a particular service.

To add a folder to a catalog:

1. Select the catalog in the Resource Manager and from the Edit menu, select Edit.

2. In the Edit dialog, from the Add menu, select Folder.
The Edit Resource Catalog Item dialog displays with two tabs, Target and Options. The Target tab is selected by default.

3. On the Target tab, specify a name and description for the folder, and leave the Visible option checked to ensure that the folder is displayed in the catalog.

4. Optionally, use the Options tab to define display options for the folder. For more information, see Section 16.3.1.5, "Setting Properties on a Resource."

5. Click OK.
You can now add resources inside this folder, or move resources inside it by dragging and dropping them from the top level folder.

16.3.1.2 Adding Resources

This section describes how to populate your catalog using the Resource Registry. For more information, see Section 16.1.3, "Understanding the Resource Registry."

To add a resource:

1. Select the Resource Catalog in the Resource Manager and from the Edit menu, select Edit.

2. If you have created folders (see Section 16.3.1.1, "Creating a Folder") and want to add resources inside a particular folder, then select the folder in the Edit dialog.

3. From the Add menu, select Add From Library.

4. In the Add Resource Catalog Item dialog (Figure 16-4), select a folder name in the left pane to display its contents in the right pane, or search for a resource by specifying its name in the Search field.
For a description of the available resources, see Section 16.1.3, "Understanding the Resource Registry."

5. Select a resource.

Tip:

You can select multiple resources using the standard shortcut keys for selection.

6. Optionally, in the Name field, specify a different name for the resource, if required. You can skip this step to retain the default resource name.

Note:

If you selected multiple resources at a time, you cannot rename them at this point. However, you can edit them after adding them to the catalog. For more information, see Section 16.3.1.5, "Setting Properties on a Resource."

7. Click Add.

Notes:

- The Runtime DataControls folder lists the available data controls. You can expand a data control node to display its accessors and methods. However, you can only add the data control as a whole. Adding its accessors, methods, or attributes separately is not supported. You may see catalog errors if you try to add these objects.

- Avoid adding a data control more than once in a catalog. The data control is added to the catalog as many times, but when you use the catalog to populate a page or task flow, you will not be able to add accessors, methods, or attributes from such data control instances.

- The Design-Time DataControls folder lists all the WebCenter Services data controls. However, adding the ConnectionsNetworkDC and KudosServiceDC data controls at runtime is not supported. Avoid adding these data controls to your page or task flow.

8. Repeat the previous four steps to add more resources from the available folders.

9. Click OK in the Edit dialog.

16.3.1.3 Creating Custom Components

The Resource Registry in WebCenter Spaces provides a large repository of resources that you can add to a catalog. However, if this is not sufficient and your business requires you to add other resources, such as ADF Faces components, custom JSPX, or raw HTML, you can create a custom component and specify the XML code for the component. Using a custom component is the only way to make such components available to a page in Oracle Composer.

You may want to create a custom component for the following purposes:

- Create seeded layouts that can be added to a page. You can add a layout component and include a combination of design and container components inside it. The container components provide empty content areas that can be filled later.

- Add external content by including the raw HTML code.

- Define seeded layouts in which to consume data controls. You can then bind the data control to the layout.

To create a custom component:

1. Select the catalog in the Resource Manager and from the Edit menu, select Edit.

2. If you have created folders and want to add resources inside a particular folder, select the folder in the Edit dialog.

3. From the Add menu, select Component.

4. In the Edit Resource Catalog Item dialog, on the Target tab, specify a name and description for the new resource, and leave the Visible option checked to ensure that the resource is displayed in the catalog.

5. In the XML text area, enter the XML code for the component.
The following are a few examples of custom components:

- Output Text component:

<af:outputText xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
value="Weather Foercast for the Day" id="#"/>

- Custom navigation:

<af:forEach xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
var="level_1_menu"
items="#{SiteStructureContext.defaultSiteStructure.listModel['startNode=/, includeStartNode=false']}">
<af:outputText id="#"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
value="#{level_1_menu.title}"/>
</af:forEach>

- External HTML content:

<f:verbatim xmlns:f="http://java.sun.com/jsf/core">

Part V

Building and Wiring Pages

Part V of the User's Guide provides information about creating pages; working with a page's underlying structure using layout components; and wiring pages, task flows, portlets and UI components.

Part V includes the following chapters:

- Chapter 17, "Building Pages"

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components"

17 Building Pages

No matter how you structure your portal, there is always a need for new pages in addition to those that are available out of the box. WebCenter Spaces provides a variety of prebuilt page styles to simplify page creation. It also offers an embedded page editor for in-place page revision and easy content placement.

This chapter describes how to create, edit, populate, and delete WebCenter Spaces pages. It includes the following sections:

- Section 17.1, "What You Should Know About Pages"

- Section 17.2, "Creating Pages"

- Section 17.3, "Editing Pages"

- Section 17.4, "Personalizing Pages"

- Section 17.5, "Adding Resource Catalog Components to Pages"

- Section 17.6, "Deleting Pages"

Audience

This chapter is intended for users with the Space-level permission Basic Services: Edit Page Access, Structure, and Content. The users with this permission are typically tasked with creating and editing pages, revising page properties, adding page content, and deleting pages from a Space.

17.1 What You Should Know About Pages

WebCenter Spaces provides a variety of page types to suit the requirements of your portal. Some pages are seeded, such as system pages. These offer a ready set of editable, utilitarian pages, such as the Login page and the Self Registration page. System pages are prepopulated with relevant input fields and boilerplate text (for more information about system pages, see Section 7.3, "Working with System Pages").

Another page type, the business role page, can be populated with information of relevance to a particular business role, such as salesperson, accountant, or marketing associate, and then pushed into the Home Space views of all users who are assigned that role (for more information about business role pages, see Section 7.1, "Working with Business Role Pages").

Personal pages are the pages users create for themselves in their views of the Home Space (for more information about personal pages, see Section 7.2, "Working with Personal Pages," and Chapter 38, "Creating and Managing Personal Pages").

This chapter covers information about pages that are designed to contribute to the knowledge base of the portal. Such pages provide greater flexibility than seeded pages (such as system pages and business role pages), in that you have more control over their content and their availability. You can control user access to such pages and change their properties.

WebCenter Spaces also provides a variety of page layouts (called styles) that you can use to create different types of pages with different layouts. Page types may restrict the type of content that you can add to a page, such as text only, wiki only, blog only, and the like. Page layouts define the number of columns and content areas that define a page's geometry. Layouts are initially determined by the style you select when you create the page. Some page styles inherently allow switching to another page layout, others, such as wikis and blogs, do not (for more information, see Table 15-2, "Default Page Styles").

In addition to the preseeded layouts available through page styles, you can create your own layouts using the layout components available through the Resource Catalog. This chapter provides an overview of that process, for detailed information about the layout components themselves, see Chapter 18, "Adding and Configuring Page Layout Components."

17.2 Creating Pages

To create a page in a Space:

See Also:

For information about creating pages in the Home Space, see for more information about personal pages, see Chapter 38, "Creating and Managing Personal Pages."

1. Navigate to the Space in which to create the page, and open the Create Page dialog (Figure 17-1).

Figure 17-1 Create Page Dialog

Note:

Portal administrators can control the options that appear in the Create Page dialog. So, your view may differ from that depicted in Figure 17-1. For more information, see Section 15.4.1, "Showing and Hiding a Page Style in the Create Page Dialog."

2. Provide a name for the page, select a page style, and click Create.

Note:

For wiki and blog pages, you must not use the following characters in the page name:

\ / : [ ] * ' " |

You can use character spaces and periods (.).

See Also:

For information about page styles, Section 15.1, "What You Should Know About Page Styles."

The new page opens in page edit mode (Oracle Composer).

See Also:

The next step you take depends on what you want to accomplish:

For information about adding content to the page, see one of the following topics:

- Section 17.5, "Adding Resource Catalog Components to Pages"

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 13, "Adding Spaces Components to Your Templates"

For information about defining who can access the page, see Chapter 23, "Securing Pages and Components."

17.3 Editing Pages

One of the most powerful offerings in WebCenter Spaces is the ability to add and edit page content at application runtime. This capability is delivered through Oracle Composer, a fully-integrated page editor for revising the properties, layout, and content of application pages.

Use Oracle Composer to change a page layout; add task flows, portlets, documents, layout components, and other objects to a page; to provide values for the properties associated with pages and the objects they contain; and to wire pages, task flows, and portlets to each other.

This section provides an overview of Oracle Composer and describes how to perform basic editorial tasks, such as entering and exiting page edit mode, accessing page properties, and the like.

This section includes the following subsections:

- Section 17.3.1, "Entering and Exiting Page Edit Mode"

- Section 17.3.2, "Introducing Design View and Source View"

- Section 17.3.3, "Accessing Portal Resources"

- Section 17.3.4, "Providing Page Background Color, Image, and CSS Encoding"

- Section 17.3.5, "Changing the Page Layout"

See Also:

Additional tasks that you perform in page edit mode are discussed more thoroughly in their own sections and chapters. These include the following:

- Section 17.5, "Adding Resource Catalog Components to Pages"

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 13, "Adding Spaces Components to Your Templates"

17.3.1 Entering and Exiting Page Edit Mode

To enter and exit Oracle Composer:

1. Log in, and go to the page you want to edit.

2. Enter page edit mode (Figure 17-2).

Tip:

One way to enter page edit mode is to pressCtrl-Shift-E.

Figure 17-2 Example of a Page in Edit Mode

3. Edit the page.

4. Click the Save button to save your changes and remain in Oracle Composer.

5. Click the Close button to exit Oracle Composer.

A Few Notes About Concurrent Users

Because users access WebCenter Spaces from the Web, multiple users may attempt to edit the same page at the same time. In such cases, a concurrency warning appears in Oracle Composer that alerts each user to the others (Figure 17-3).

Figure 17-3 A Concurrency Warning in Oracle Composer

The final state of the page is determined by the last user to save. That is, the last changes saved overwrite the changes made by other concurrent users.

Tip:

Time duration is added to the concurrency message only when the first or a subsequent concurrent user has made (but not yet saved) a page customization.

WebCenter applications do not support single-user concurrency. That is, one user cannot log in to the same WebCenter application at the same time to create multiple, simultaneous sessions.

Because concurrent page editing is supported, there may be occasions when one user deletes a page that another user is editing. In such cases, the user performing the edits sees an error message with each action. For example, a message saying the user does not have permission to edit the page may appear. When the user tries to save changes, a Page Not Found error appears with a link redirecting the user to the Home page. The error message may differ, depending on whether the user is editing a page in a Space or the Home Space.

If you view a page at the same time that another user is editing the page, you may not immediately see the results of those edits in your session. To reliably see any changes, view the page after the other user has saved.

If you revise a component in page view mode while another user deletes the same component in page edit mode, a WebCenter error page opens. Simply navigate back to the original page. The deleted component does not appear, and you can continue working on other components.

17.3.2 Introducing Design View and Source View

Oracle Composer provides two views for working with page content: Design view and Source view. To open either of these views, enter Oracle Composer, and select Source or Design from the View menu (Figure 17-4).

Figure 17-4 View Menu in Oracle Composer

Design view provides a WYSIWYG rendering of the page and its content, where controls are directly selectable on each component (Figure 17-5).

Figure 17-5 Design View of Page Edit Mode

Source view provides a combined WYSIWYG and hierarchical rendering of page components, where controls are available on the header of the hierarchical list (Figure 17-6)

Figure 17-6 Source View of Page Edit Mode

Tip:

In Source view, controls on individual components are inactive, although you can click an individual component to select it.

The Source position option on the View menu is available for specifying whether the page source is presented on the top, bottom, left, or right of the WYSIWYG portion of the page. The Source position option is active when the page is open in Source view (Figure 17-7).

Figure 17-7 Source Position Options on View Menu in Page Edit Mode

Source view additionally provides access to page layout components that are otherwise not exposed on the page. Source view enables the selection and configuration of such components. Select a component on the hierarchical list, and it is automatically selected on the page. For more information, see Section 18.2.10.1, "What You Should Know About Internal Layout Components."

Component selection is indicated by an outline. Access the selected component's properties by clicking the Show the properties of component name icon on the Source view header (Figure 17-8).

Figure 17-8 Show the Properties of Everyone Icon

You can also select components in Source view by clicking them directly on the page. In Source view, your mouse cursor changes to a magnifying glass when you move it over a selectable component (Figure 17-9).

Figure 17-9 Mouse Cursor as Magnifying Glass

Tip:

If you reset the page while in Source view, the selection cursor (the magnifying glass) goes away. To get it back, simply click a component on the hierarchical list of components.

17.3.3 Accessing Portal Resources

When you want to add components to a page, you do so through the Resource Catalog. The catalog is a gateway to a wide range of task flows, portlets, layout components, and other types of resources (Figure 17-10).

Figure 17-10 Resource Catalog

Authorized users can create custom Resource Catalogs and add any variety of the available resources. This means the content of a given Resource Catalog is dependent on the person who designed the catalog.

In Design view of page edit mode, open the catalog by clicking the Add Content button on a region where you want to add content (Figure 17-11).

Figure 17-11 Add Content in Design View of Page Edit Mode

In Source view of page edit mode, open the catalog by selecting the component into which to add content, and clicking the Add Content button (Figure 17-12)

Figure 17-12 Add Content in Source View of Page Edit Mode

The content of the catalog is determined by the application administrator or the users to whom the administrator has delegated the task of creating and managing Resource Catalogs. Different catalogs are available in different venues. For example, the Resource Catalog available to the Home Space is likely very different from a Resource Catalog that is available to a Space. Users who create Page Templates have access to components that are not available in the catalogs shown in either a Space or the Home Space. For more information, see Chapter 16, "Working with Resource Catalogs."

The catalog is organized into components and folders. Some components are readily available at the top level of the catalog. Other components are organized into folders and subfolders, which you can drill down into. You can distinguish between the two by noting whether a listing has an Open or Add link next to it (Figure 17-13).

Figure 17-13 Open and Add Links in a Resource Catalog

Navigate the folder hierarchy using the Up icon (Figure 17-14)

Figure 17-14 Up Icon in Resource Catalog

Use the catalog's Search feature to locate components by name or description. Use the Refresh the Resource Catalog icon to update the catalog with newly added components.

See Also:

Resource Catalogs and how to configure them are discussed in detail in Chapter 16, "Working with Resource Catalogs."

17.3.4 Providing Page Background Color, Image, and CSS Encoding

Page properties provide a means of controlling the width of page columns, specifying a page background color and image, and applying additional CSS encoding to the page. Additionally, page properties provide access to page security settings and to page parameters, which you can use in wiring pages to page components.

See Also:

For information about page security settings, see Chapter 23, "Securing Pages and Components." For information about page wiring, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

To edit a page's properties:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctrl-Shift-E.

2. Click the Page Properties button (Figure 17-15).

Figure 17-15 Page Properties Button in Page Edit Mode

3. On the Display Options tab, open the color picker next to Background Color, and select a background color for the page in one of the following ways (Figure 17-16):

Figure 17-16 Page Background Color Picker

- Select a color by clicking it.

- Enter the color's RGB equivalent in the Background Color field.

Tip:

Enter RGB values in the format RRGGBB or #RRGGBB or r,g,b

- Create a custom color by clicking Custom Color in the picker and selecting a color and a saturation level using the selector and the slider provided (Figure 17-17).

Figure 17-17 Custom Color Picker

Click OK to enter the color value in the Background Color field.

4. In the Background Image field, enter a full URL or a URL that is relative to the application root.

For example, enter:

http://www.abc.com/image.jpg

5. In the Other CSS field, add any other CSS encoding you care to that is not covered by the other page properties.

For example, enter:

background-position:center;

You must use standard CSS syntax for this value to be valid (for more information about Other CSS, see Section 17.5.2.7.3, "Entering Other CSS").

6. Click OK to save your changes and apply them to the page.

17.3.5 Changing the Page Layout

This section describes how to revise the page layout by adjusting underlying page columns and adding tabs and content areas. It includes the following subsections:

- Section 17.3.5.1, "What You Should Know About Page Layouts"

- Section 17.3.5.2, "Providing a Page Header and Footer"

- Section 17.3.5.3, "Adjusting the Widths of Page Columns"

- Section 17.3.5.4, "Adding New Content Regions"

- Section 17.3.5.5, "Creating Layered Content Regions Using Tabs"

17.3.5.1 What You Should Know About Page Layouts

Page layout is defined by the number, placement, and orientation of content regions on a page and the widths of page columns. A page's initial layout is provided when you first create a page, through your style selection.

See Also:

Table 15-2, "Default Page Styles" illustrates WebCenter default page styles.

You can adjust the width of underlying page columns through page parameters. You can add content regions to a page to change the page layout. You can also add tabs to create layered content regions.

17.3.5.2 Providing a Page Header and Footer

Many of the seeded page styles provided out-of-the-box in WebCenter Spaces have associated page properties that you can use to add a header and footer to a page. These styles include:

- Blank

- Home Page

- Left Narrow

- Right Narrow

- Three Column

Adding a page header adds a content area to the top of the page. Adding a page footer adds a content area to the bottom of the page. Both of these content areas are immune to use customizations, preventing them from being dragged to a new position or otherwise altered in page view mode. Figure 17-18 and Figure 17-19 illustrate a page in edit mode Design view before and after a header and footer are added.

Figure 17-18 A Page Based on the Style Three Column Before a Header or Footer Is Added

Figure 17-19 A Page Based on the Style Three Column After a Header and Footer Are Added

This section steps you through the process of adding a header and footer to a page that is based on one of these styles.

To add a page header or footer:

1. Go to the page you want to change.

To navigate to a personal page in the Home Space:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

To navigate to a page in a Space:

http://host:port/webcenter/spaces/SpaceName/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Open the page in edit mode.

Tip:

To open a page in edit mode, press Ctrl-Shift-E.

3. Click Page Properties (Figure 17-20) to open the Page Properties dialog.

Figure 17-20 Page Properties Button in Page Edit Mode

4. To add a page header, change the value of showHeader to true; to add a page footer, change the value of showFooter to true (Figure 17-21).

Figure 17-21 Default Page Parameters for the Three Column Page Style

5. Click OK.

6. Add content as desired to the page header and footer layout Boxes (Figure 17-22).

Figure 17-22 Unpopulated Page with a Header and Footer

See Also:

For information about adding content to a page, see Section 17.5, "Adding Resource Catalog Components to Pages." For information about adding layout components to a page, such as images, text, HTML, and the like, see Section 18, "Adding and Configuring Page Layout Components."

7. Click Save and then Close to exit Oracle Composer.

17.3.5.3 Adjusting the Widths of Page Columns

Many seeded page styles come with parameters that control the percentage of width allotted to each underlying page column (Figure 17-23).

Figure 17-23 Default Page Parameters for the Three Column Page Style

The seeded page styles that provide these parameters include:

- Blank

- Home Page

- Left Narrow

- Right Narrow

- Three Column

See Also:

For illustrations and descriptions of seeded page styles, see Table 15-2, "Default Page Styles".

You can adjust the default values of these parameters to control the width of page layout columns.

To adjust the width of page columns:

1. Go to the page you want to change.

To navigate to a personal page in the Home Space:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

To navigate to a page in a Space:

http://host:port/webcenter/spaces/SpaceName/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Open the page in edit mode.

Tip:

To open a page in edit mode, press Ctrl-Shift-E.

3. Click Page Properties to open the Component Properties dialog (Figure 17-24).

Figure 17-24 Page Properties Button in Page Edit Mode

4. Adjust the leftWidth, centerWidth, and rightWidth parameter values to the desired percentages (Figure 17-25).

Figure 17-25 Default Page Parameters for the Three Column Page Style

5. Click OK.

6. Click Save and then Close to exit Oracle Composer.

17.3.5.4 Adding New Content Regions

You can add content regions to a page by splitting existing layout Boxes. This section describes how. It includes the following subsections:

- Section 17.3.5.4.1, "Enabling Box Splitting"

- Section 17.3.5.4.2, "Splitting a Layout Box"

See Also:

For information about Boxes and other layout components, see Chapter 18, "Adding and Configuring Page Layout Components."

17.3.5.4.1 Enabling Box Splitting

You can create additional content regions by splitting a Box into multiple Boxes. Before you can split a Box, the Box must be configured to allow it.

See Also:

You can also create additional content regions by adding more Boxes to a page. For more information, see Section 18.1, "Adding a Layout Component to a Page."

To enable the splitting of a Box:

1. Navigate to the relevant page, and enter page edit mode Design view.

Tip:

To enter page edit mode, press Ctrl-Shift-E.

2. Click the Edit icon on a Box to open the Component Properties dialog, and then click the Display Options tab to bring it forward (Figure 17-26).

Figure 17-26 Box Layout Component Display Options

3. Select Show Split Action, and click OK.

Add Box icons appear on the Box's toolbar (Figure 17-27).

Figure 17-27 Add Box Icons

17.3.5.4.2 Splitting a Layout Box

To split a layout Box:

See Also:

Before you can split a Box, it must be configured to allow it. For more information, see Section 17.3.5.4.1, "Enabling Box Splitting."

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctrl-Shift-E.

2. Go to the layout Box you want to split, and click the Add Box icon that splits the Box in the manner you prefer (Figure 17-28).

Figure 17-28 Add Box Below Icon

Choose from:

- Add Box Above

- Add Box Below

- Add Box Left

- Add Box Right

3. Click Save and then Close.

See Also:

For information about setting properties on a Box layout component, see Chapter 18, "Working with the Box Layout Component."

17.3.5.5 Creating Layered Content Regions Using Tabs

When page real estate is tight, you can add layered content regions using tabs. Tabs are content regions that each have a tab and sit on top of other tabbed content regions (Figure 17-29).

Figure 17-29 Tabbed Content Regions

Much of the actions you can performed on a tab, such as renaming, reordering, and so on, are available through tab properties. This section describes how to add tabbed content regions and how to perform various actions on tabs through tab properties.

The tab properties themselves are documented in Section 18.2.10.4, "Setting panelTabbed Properties," and Section 18.2.10.6, "Setting sidebarItem Properties."

This section includes the following subsections:

- Section 17.3.5.5.1, "Enabling the Addition of Tabbed Content Regions"

- Section 17.3.5.5.2, "Adding Tabbed Content Regions"

- Section 17.3.5.5.3, "Creating a Tab Set"

- Section 17.3.5.5.4, "Reordering and Renaming Tabs"

- Section 17.3.5.5.5, "Adding an Icon to a Tab"

- Section 17.3.5.5.6, "Stretching Tab Content"

- Section 17.3.5.5.7, "Hiding and Showing Tabs"

- Section 17.3.5.5.8, "Deleting Tabs"

See Also:

For information about working with tab properties, see Section 18.2.10.4, "Setting panelTabbed Properties," and Section 18.2.10.6, "Setting sidebarItem Properties."

17.3.5.5.1 Enabling the Addition of Tabbed Content Regions

The creation of tabbed content regions takes place initially on a Box layout component. Before you can create tabs on a Box, the Box must be configured to allow the creation of tabs.

To enable a Box to support the creation of tabs:

1. Navigate to the relevant page, and enter page edit mode Design view.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click the Edit icon on a Box to open the Component Properties dialog, and then click the Display Options tab to bring it forward (Figure 17-30).

Figure 17-30 Box Layout Component Display Options

3. Select Show Tab Action, and click OK.

The Add a Tab Set or a Tab icon appears on the Box's toolbar (Figure 17-31).

Figure 17-31 Add a Tab Set or a Tab Icon

17.3.5.5.2 Adding Tabbed Content Regions

Each tab you add to a page provides its own region to which you can add content. In page edit mode, you will note the Add Content button on the tab. Additionally, if the layout region you converted to a tab already contains content, that region retains its own Add Content capabilities. In other words, it becomes nested in the tab.

You may want to avoid content nesting to keep your page layout as simple and manageable as possible, though you pay no penalty in performance if you do nest. Nonetheless, to avoid this sort of complication, consider creating tabs in empty regions.

Note:

The icon for adding tabs appears on Box layout components only when the Box is configured to allow the creation of tabs. For more information, see Section 17.3.5.5.1, "Enabling the Addition of Tabbed Content Regions."

To add tabbed content regions:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctrl-Shift-E.

2. Go to the region on which to add tabs, and click the Add a Tab Set or a Tab icon (Figure 17-32).

Figure 17-32 Add a Tab Set or a Tab Icon

A tab appears, containing the content present in the layout region on which the tab was created (Figure 17-33).

Figure 17-33 A Newly-Added Tab

3. Continue adding tabs as desired.

Click Save and then Close to exit Oracle Composer.

See Also:

For information about renaming a tab, see Section 17.3.5.5.4, "Reordering and Renaming Tabs."

17.3.5.5.3 Creating a Tab Set

When you intend to create tabs you are likely to want to create a set of tabs rather than just one. A quick way to accomplish this is available through tab properties.

To create a tab set:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctrl-Shift-E.

2. Click the Edit icon on the tab you want to include in your tab set (Figure 17-34).

Figure 17-34 Edit Icon on a Tab

3. In the resulting Component Properties dialog, click the Add Tab button to add a tab to the list headed Reorder the tabs (Figure 17-35).

Figure 17-35 Add Tab Button in Component Properties Dialog

4. Continue in this manner until you have the desired number of tabs.

5. Click OK to save your changes and exit the dialog.

6. Click Save and then Close to exit Oracle Composer.

17.3.5.5.4 Reordering and Renaming Tabs

Once you create a tab, you can use tab properties to change its default name, New Tab. You can also use page properties to change the tab order.

To rename and reorder tabs:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctrl-Shift-E.

2. Click the Edit icon on the tab you want to rename or reorder.

3. In the resulting Component Properties dialog, select the tab you want to rename or reorder in the Reorder the tabs list and do one of the following.

- To rename the tab, enter the new name in the Text field.

- To reorder the tab, click a Move icon to the right of the Reorder the tabs list.

4. Click OK to save your changes and exit the dialog.

5. Click Save and then Close to exit Oracle Composer.

17.3.5.5.5 Adding an Icon to a Tab

You may want to add a meaningful icon to a tab to make its purpose obvious to knowledgeable users. Added icons are rendered to the left of the tab display name (Figure 17-36).

Figure 17-36 Icon on a Tab

To add an icon to a tab:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctr-Shift-E.

2. Click the Edit icon on the tab to which to add an icon.

3. In the resulting Component Properties dialog, select the tab in the Reorder the tabs list and provide the URI of an image in the Icon Location field.

This property supports these various types of URIs:

- An absolute path to the image, such as:

http://oracleimg.com/admin/images/ocom/hp/oralogo_small.gif

- A path located relatively to the source page, such as

bullet.jpg

- A path relatively based on the web application's context root, such as

/images/error.png

- A path relatively based on the web server by application name, such as

//adf-richclient-demo-context-root/images/error.png

4. Click OK to save your changes and exit the dialog.

5. Click Save and then Close to exit Oracle Composer.

17.3.5.5.6 Stretching Tab Content

Using tab properties, you can stretch a single component to fill the tab's available display area. When you do this, the tab can display only the single component. You cannot add a second component to the tab region.

To stretch tab content:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctr-Shift-E.

2. Click the Edit icon on the tab whose content you want to stretch.

3. In the resulting Component Properties dialog, click the Stretch Contents checkbox.

4. Click OK to save your changes and exit the dialog.

5. Click Save and then Close to exit Oracle Composer.

17.3.5.5.7 Hiding and Showing Tabs

You can take a tab out of action by hiding it. Hiding a tab might be preferable to deleting because it leaves you the option of returning it to view. Hidden tabs are listed in tab properties, so you always have access to them.

Tip:

If you hide all tabs in a tab set, you can access their properties in Source view of page edit mode (for more information, see Section 17.3.2, "Introducing Design View and Source View"). Select the tabs parent element, panelTabbed, and edit its properties.

To hide or show a tab:

1. Navigate to the relevant page, and enter page edit mode.

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click the Edit icon on a tab in the tab set containing a tab you want to hide or show.

3. In the resulting Component Properties dialog, select the relevant tab under Reorder the tabs, and do one of the following:

- Select the Hide this tab checkbox to hide the tab.

- Clear the checkbox to show a hidden tab.

4. Click OK to save your changes and exit the dialog.

5. Click Save and then Close to exit Oracle Composer.

17.3.5.5.8 Deleting Tabs

You have a few options for deleting a tab or a tab set. You can do so through Source or Design view in page edit mode, through tab properties, or on the tab itself.

Note:

Whether you can delete tabs and how many tabs you can delete may be controlled by the panelTabbed property Tab Removal (see Section 18.2.10.4, "Setting panelTabbed Properties").

You can delete an entire tab set by deleting panelTabbed, but you cannot delete every tab from a tab set. That is, you can select panelTabbed in Source view and delete it, but, when you are removing tabs individually through Box properties (in Design view), you can remove all but the current tab. The current, active tab cannot be deleted.

To delete a tab or a tab set:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

To enter page edit mode, press Ctr-Shift-E.

2. Delete the relevant tab or tab set by doing one of the following:

- To delete a tab set, go to Source view of page edit mode, select the relevant panelTabbed element, and click Delete (Figure 17-37).

Figure 17-37 Deleting a panelTabbed Element in Source View of Page Edit Mode

Click Delete in the confirmation dialog.

See Also:

For more information about page edit mode views, see Section 17.3.2, "Introducing Design View and Source View."

- To delete one or more tabs, go to Design view of page edit mode, click the Edit icon on one of the tabs in the relevant set, select the tab to delete under Reorder the tabs, and click the Delete button (Figure 17-38).

Figure 17-38 Delete Tab Button in Box Component Properties Dialog

Click Delete in the confirmation dialog.

Tip:

You can also access tab set properties by selecting the panelTabbed in Source view of page edit mode and clicking the Edit button.

3. Click Save and then Close to exit Oracle Composer.

17.4 Personalizing Pages

WebCenter Personalization provides a way to vary the presentation of page content and templates in accordance with the current user. Using Personalization-related Expression Language expressions (ELs), you can present targeted content or shape the way content is presented by selecting and applying a page template based on whoever is the current user. For example, one user role sees a page through template A, while another user role sees the same page through template B.

There is a wide variety of user and application context that can determine the content a user sees. For example, content can be restricted by role through a security mechanism, such as page hierarchy security. Content can be targeted based on more dynamic user and application context, such as user profile values, session information, and the like.

When you use Personalization ELs, you personalize the content that is shown based on the user or application context that is being pulled by the ELs from a Personalization Conductor Scenario. The Personalization Conductor in turn is dynamically pulling the actual content or page template from a provider source, that is, a content repository, such as the Oracle Content Server.

For more information about personalization in WebCenter Spaces, see Chapter 9, "Using WebCenter Personalization."

The ELs related to the Personalization Conductor are cataloged in Section B.3.11, "EL Expressions Relevant to the Personalization Conductor." The Personalization Conductor is discussed in more detail in the chapter, "Personalizing WebCenter Applications" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

17.5 Adding Resource Catalog Components to Pages

This section generally describes how to add components from the Resource Catalog to a page, how to personalize content according to user role, and how to set properties on components. It includes the following subsections:

- Section 17.5.1, "Adding a Component to a Page"

- Section 17.5.2, "Setting Properties on Page Components"

See Also:

For information about specific types of components, see:

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 13, "Adding Spaces Components to Your Templates"

- Part VIII, "Creating and Managing Portlets and Task Flows at Runtime"

- Part X, "Working with Content"

- Part XV, "Services: Announcements through Links"

- Part XVI, "Services: Lists through Worklist"

17.5.1 Adding a Component to a Page

The method for adding page components differs between Design view and Source view of page edit mode. In Design view, you place content using controls directly on the containing layout component. In Source view, you select the containing layout component and use the same set of controls in every case.

This section describes how to add content from the Resource Catalog to your application pages. It includes the following subsections:

- Section 17.5.1.1, "Adding a Component to a Page in Design View of Page Edit Mode"

- Section 17.5.1.2, "Adding a Component to a Page in Source View of Page Edit Mode"

See Also:

For information about adding components to the Resource Catalog, see Section 16.3.1.2, "Adding Resources."

17.5.1.1 Adding a Component to a Page in Design View of Page Edit Mode

To add a Resource Catalog component in page edit mode Design view:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Add Content button on the target region to open the Resource Catalog (Figure 17-39)

Figure 17-39 Add Content Button on a Box Layout Component

3. Navigate to the component you want to add, and click the Add link next to it (Figure 17-40).

Figure 17-40 Add Link in a Resource Catalog

Tip:

If the component you want is not present in the Resource Catalog, you may need to add it. For more information, see Section 16.3.1.2, "Adding Resources."

4. Continue to add content, or click Close to exit the Catalog.

5. Click Save and then Close to exit page edit mode.

17.5.1.2 Adding a Component to a Page in Source View of Page Edit Mode

To add a Resource Catalog component in page edit mode Source view:

1. Navigate to the relevant page, and enter page edit mode.

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. From the View menu, select Source.

3. From the list of page components, select the component in which to place content.

Tip:

You can also select a component by clicking it. A selected component is outlined in blue.

4. Click the Add Content button to open the Resource Catalog (Figure 17-41)

Figure 17-41 Selected Box and Add Content Button in Source View

5. Navigate to the component you want to add and click the Add link next to it (Figure 17-42).

Figure 17-42 Add Link in a Resource Catalog

6. Continue to add content, or click Close to exit the Catalog.

7. Click Save and then Close to exit page edit mode.

17.5.2 Setting Properties on Page Components

Components, such as task flows, portlets, documents, and layout components, carry with them a set of configurable properties that control the appearance and behavior of a particular component instance. Such properties are exposed in Oracle Composer through its Component Properties dialog (Figure 17-43).

Figure 17-43 Component Properties Dialog

Components of all types have many common properties. Typically, individuality is expressed on the Parameters and Events tabs, though there may be variations on Display Options, Style, and Content Style tabs.

Note:

When you enter most types of property values in the Component Properties dialog and then click Apply, the dialog remains open. With values other than expected value types, the dialog closes, and the page is refreshed to reflect the new value. For example, if a component takes a java.util.ArrayList of java.awt.Color classes, then the Component Properties dialog closes and Composer does a full-page-refresh.

This section discusses commonly-shared properties. It includes the following subsections:

- Section 17.5.2.1, "What You Should Know About Customizing Page Components"

- Section 17.5.2.2, "What You Should Know About Component Properties"

- Section 17.5.2.3, "Setting Component Properties"

- Section 17.5.2.4, "Working with Component Parameters"

- Section 17.5.2.5, "Working with Component Display Options"

- Section 17.5.2.6, "Working with Child Components"

- Section 17.5.2.7, "Working with Style and Content Style Properties"

- Section 17.5.2.8, "Working with Component Contextual Events"

See Also:

In this guide, properties that are unique to a particular WebCenter component are discussed in the chapters that cover the components. For more information, see:

- Section 51.16.2, "Setting Space Task Flow Properties"

- Section 52.4.7, "Setting Space Members Task Flow Properties"

- Section 36.5.3, "Setting Notifications Task Flow Properties"

- Chapter 42, "Setting Documents Service Task Flow and Document Component Properties"

- Section 48.2.2, "Setting Blog Properties"

- Part XIII, "Searching WebCenter and Other Sources"

- Part XIV, "Gathering Intelligence Based on Activities"

- Section 27.4, "Setting OmniPortlet Properties"

- Section 28.3, "Setting Web Clipping Portlet Properties"

For information about page parameters, see Section 19.3, "Wiring Components and Page Parameters."

17.5.2.1 What You Should Know About Customizing Page Components

The runtime flexibility of your portal pages is realized in both application customization and user customization. Application customization involves changes made in page edit mode. Application customizations affect all users' views of a page. User customization involves changes made in page view mode. User customizations affect only the view of the user who made them.

Note:

When you revise a component in page view mode (user customization) while another user deletes the same component in page edit mode (application customization), an error page opens. Simply navigate back to the original page. The deleted component does not appear, and you can continue working on other components.

In page edit mode, you see only application customizations. In page view mode, you see your user customizations layered over application customizations. If the same property is set at both the application and user levels, the user value takes precedence (in your view of a page in page view mode). For example, imagine a List task flow where an authorized user performs an application customization to display color banding every other column. In your page view, you perform a user customization on the list to instead show color banding every other row. As you toggle between page edit mode and page view mode, you see column color banding in page edit mode, but your own row color banding in page view mode.

You can perform both types of customization at the page level and at the component level. Page-level customizations include such actions as rearranging page content, changing the page layout, and the like. Component customizations—made to task flows, portlets, and layout components—include such actions as resizing and rearranging columns and filtering content.

Through the Child Components tab in the Component Properties dialog, you can also perform page-like application customizations at the component level. For example, you can rearrange, hide, and show page content. For more information, see Section 17.5.2.6, "Working with Child Components." The types of customizations available to components differ from component to component.

Note:

Application customizations made directly to service task flows and to portlets are committed immediately, regardless of whether you click the Save button in Oracle Composer. These types of customizations include entering page edit mode and resizing a list column, adding color banding, sorting discussion forums, and the like. They do not include changes made through the Component Properties dialog, which must be saved before they are committed.

User customization is available to users with, minimally, personalize permission on the page. Provided the component supports it, some user customization settings are available through the Personalize icon that appears on the component header in page view mode. For example, Figure 17-44 shows an instance of a List Viewer task flow in page view mode with the task flow's Personalize icon (pencil) called out.

Figure 17-44 Personalize Icon on a Component Header

Application customization is available to users with, minimally, edit permission on the page. Provided the component supports it, some customization settings are available through the Edit icon that appears in the component header or on a floating tool palette when the component's host page is opened in Oracle Composer. For example, Figure 17-45 shows an instance of a List Viewer task flow in page edit mode, with the task flow's Edit icon (wrench) called out.

Figure 17-45 The Edit Icon on a List Task Flow

17.5.2.2 What You Should Know About Component Properties

Changes to component properties are always made in page edit mode and are always a customization. Use component properties to adjust the appearance and behavior of a component instance and to wire components to each other and to page parameters and page definition variables.

See Also:

For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

The Component Properties dialog is divided into multiple tabs. These can include all of the following tabs, but more likely include a subset of them:

- Parameters—Settings, unique to the component type, that can control such things as the source of the component's content. For more information, see Section 17.5.2.4, "Working with Component Parameters."

- Display Options—Settings for determining content orientation, hiding and showing a header, selecting a display method for an actions menu, and the like. For more information, see Section 17.5.2.5, "Working with Component Display Options."

- Child Components—A list of all the components contained in the parent component. For more information, see Section 17.5.2.6, "Working with Child Components."

- Style—Font, color, and dimension settings on the component that override such values on the parent component, the page, and the application. Style values affect component content and the elements that surround the content. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

- Content Style—Font, color, and dimension settings on component content that override such values specified for Style. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

- Events—Contextual events and event handlers for all the components on the current page that can be consumed by the currently selected component. Events are defined occurrences within the current context, and event handlers are the engines that drive the results of that occurrence. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

Some components include settings in all of these sections. Other components include a subset of these sections.

17.5.2.3 Setting Component Properties

The steps outlined in this section are useful for all selectable components on a page.

Note:

When you enter most types of property values in the Component Properties dialog and then click Apply, the dialog remains open. With values other than expected value types, the dialog closes, and the page is refreshed to reflect the new value. For example, if a component takes a java.util.ArrayList of java.awt.Color classes, then the Component Properties dialog closes and Composer does a full-page-refresh.

To set component properties:

1. Navigate to the relevant page, and enter page edit mode.

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. In Design view of page edit mode, click the Edit icon (wrench) on the component of interest (Figure 17-46) to open the Component Properties dialog (Figure 17-48).

Figure 17-46 Edit Icon on a Box in Design View

Alternatively, in Source view of page edit mode, select the relevant component, and click the Edit button (Figure 17-47) to open the Component Properties dialog (Figure 17-48).

Figure 17-47 Edit Button in Source View

Figure 17-48 Component Properties Dialog

Enter Parameters and Display Options values either unwrapped or wrapped in Expression Language syntax; for example, value or #{value}.

Tip:

For information about component properties and the types of values they require, see:

- Section 17.5.2.4, "Working with Component Parameters"

- Section 17.5.2.5, "Working with Component Display Options"

- Section 17.5.2.6, "Working with Child Components"

- Section 17.5.2.7, "Working with Style and Content Style Properties"

- Section 17.5.2.8, "Working with Component Contextual Events"

3. When you finish revising component properties, click OK.

4. Click Save and then Close to exit Oracle Composer.

Note:

When you encounter errors in page edit mode inWebCenter Portal applications where the sandbox is enabled, you can recover by closing your browser and then reopening it and relogging in to the application instance.

17.5.2.4 Working with Component Parameters

Component parameters appear on the Parameters tab of the Component Properties dialog (Figure 17-49).

Figure 17-49 Component Parameters

See Also:

For information about accessing the Component Properties dialog, Section 17.5.2, "Setting Properties on Page Components."

Component parameters vary from component to component. For example, on some components they provide the opportunity to specify the source and range of task flow content; on other components they present read-only, application-generated identifiers that are used in maintaining a task flow instance's association with its customizations.

Enter parameter values, or click the icon next to a parameter field to select and open the Expression Builder. (Figure 17-50).

Figure 17-50 Expression Builder Icon and Expression Editor

The editor provides a means of entering an expression when a value is retrievable, but otherwise unknown, for example, when you want a parameter value to be the name of the current user or the current application skin.

See Also:

For more information about using the editor and for a table of useful EL expressions, see Appendix B, "Expression Language Expressions."

In view of the uniqueness of parameters within a particular service or a particular portlet, parameter details are discussed with their associated services and portlets.

- For information about documents and their associated parameters, see Chapter 42, "Setting Documents Service Task Flow and Document Component Properties."

- For information about services and their associated parameters, see the chapters dedicated to a particular service or a service feature throughout this guide.

- For information about portlets and their associated parameters, see Part VIII, "Creating and Managing Portlets and Task Flows at Runtime".

17.5.2.5 Working with Component Display Options

The Display Options tab in the Component Properties dialog provides access to properties that control a range of display-related behaviors on a given component instance (Figure 17-51).

Figure 17-51 Component Display Options

See Also:

For information about accessing the Component Properties dialog, Section 17.5.2, "Setting Properties on Page Components."

For example, use the display options on an Image layout component to specify the image source URL and its optional link target. Use the display options on the Announcement Manager task flow to hide or show a header and enable or disable menus and other options on the header.

The showDetailFrame (Movable Box) layout component has a Display Options tab that is divided into two subtabs: Basic and Advanced.

This provides a means of separating an otherwise long list of display options into more manageable and relevant groups. Though it is not obvious in Design view of page edit mode, the showDetailFrame component is usually wrapped around the task flows provided by the various services. Consequently, the Display Options properties for task flows, and any other component wrapped in a showDetailFrame, have Basic and Advanced subtabs on their Display Options tab (see Figure 17-51).

Another consequence of being wrapped in a showDetailFrame is commonality of properties on the Display Options tab. Task flows and any other components that are wrapped in a showDetailFrame share the same Display Options properties.

For many of the properties on the Display Options tab, an Expression editor is available for entering custom values, such as text strings and Expression Language (EL) expressions. You can tell which properties take expressions by the menu icon that displays to the right of a given property (Figure 17-52).

Figure 17-52 Edit Icon for Expression Editor

Typically, the Display Options tab presents settings that affect the display elements surrounding component content (that is, its chrome). Chrome includes the header, the Actions menu, Expand and Collapse icons, and the like.

Table 17-1 lists and describes the Display Options properties that generally apply to most components (task flows, portlets, and layout components). Where there are variations, they are noted in the chapters covering specific services, task flows, and components.

Table 17-1 Display Options Properties

Property

Description

Allow Minimize

Select whether to show the minimize action on the component header (that is, a Collapse icon on the component chrome).

- Select the checkbox to show the Collapse icon.

- Clear the checkbox to omit the Collapse icon.

The minimize action collapses the component like a window shade, showing only its header.

When a component is minimized, the icon toggles to an Expand icon, which you can use to restore the full component to view.

Allow Move

Select whether to show Move Up and Move Down (or Move Left and Move Right) options on the component Actions menu. Choose from:

- Select the checkbox to show the Move options on the component Actions menu.

- Clear the checkbox to omit the Move options.

Move options include Move Up, Move Down, or Move Left, Move Right, depending on the orientation of the parent container (horizontal or vertical). Move options are context sensitive. For example, in a vertically-oriented parent container if there are no components above the current task flow the Move Up option does not appear on the Actions menu.

Allow Remove

Select whether to show the Remove icon on the component header (that is, the component chrome). Choose from:

- Select the checkbox to show the Remove option on the component header.

- Clear the checkbox to omit the Remove option.

Note that after you select to remove a component in this way in page view mode, you can restore it only by editing the page and adding another component instance.

Allow Resize

Select whether to show a window resizer on a component instance. The window resizer enables you to increase the component height.

- Select the checkbox to show the Resize option on the component.

- Clear the checkbox to omit the Resize option.

Chrome Style

Select to specify a shade for the component background.

Enter:

- light (light is transparent; the prevailing background color shows through)

- medium

- dark

Display Header

Select this checkbox to show a header on the component instance. The Display Actions component is affected by the value you specify here. For more information, see Display Actions.

Display Shadow

Select to render a shadow behind the component instance.

Font

Specify the font to use for text appearing in the component header.

Enter one or more fonts. Separate multiple values with a comma (,), for example arial,helvetica,sans serif. Enclose font names that contain spaces in single quotation marks, for example 'Times New Roman'. The browser tries to use the first value, and uses other values in turn, depending on which font is available to the local system.

Font Color

Select a color for the text appearing in the component header.

Select a color using one of the following techniques:

- Select a color by clicking it.

- Enter the color's RGB equivalent in the Font Color field. Enter RGB values in the format RRGGBB or #RRGGBB or r,g,b

- Create a custom color by clicking Custom Color in the picker and selecting a color and a saturation level using the selector and the slider provided.

Font Size

Specify the size of text appearing in the component header.

Enter a value using one of the following types of values:

- length–Sets the font size to a fixed size. For example, enter: 14px, 1.5em, and so on

- xx-small, x-small, or small

- medium–The default

- large, x-large, or xx-large

- smaller–Sets the font size to a size smaller than the parent element.

- larger–Sets the font size to a size larger than the parent element.

- %–Sets the current font size to a percentage of the font size of the parent element. For example, enter: 75%

Font Style

Select an option for applying a font style to the text in a component header:

Choose from:

- Bold

- Italic

- Underline

- Strikethrough

Short Desc

Provide tooltip text for the component instance. When users roll their mouse pointers over the component instance, the text you enter here pops up.

Show Actions On Hover

Select to show actions when users hover their mouse pointers over the component header.

- Select the checkbox to show actions only when users hover their mouse pointers over the component header.

- Clear the checkbox to always show actions on the component header.

Display Header must be selected for this option to apply.

Show Component

Option for hiding or showing the component instance on the page

- Select to show the component.

- Clear to hide the component.

Once you hide a component in this way, you can show it again using controls available in Oracle Composer Source view. In Source view, right-click the hidden component, and select Show Component from the resulting context menu.

Stretch Content

Select to stretch the content to fill the container. For example, all task flows and portlets are wrapped in a container. If you change the height of the container, through the Content Style Height property, Stretch Content specifies that the component should be stretched to fill the specified height.

Content always takes up the full width of its parent container.

Text

Enter text to appear in the component header. If you select to hide the header, the value you enter here is ignored.

17.5.2.6 Working with Child Components

The Child Components tab in the Component Properties dialog (Figure 17-53) provides controls for hiding, showing, and rearranging the components that are contained within the current (parent) component.

Figure 17-53 Child Components Tab in Component Properties Dialog

See Also:

For information about accessing the Component Properties dialog, Section 17.5.2, "Setting Properties on Page Components."

The changes you make through the Child Components tab are customizations that affect every user's view of the component instance.

This section provides information about how to use the controls on the Child Components tab. It includes the following subsections:

- Section 17.5.2.6.1, "Hiding and Showing Child Components"

- Section 17.5.2.6.2, "Rearranging Child Components"

17.5.2.6.1 Hiding and Showing Child Components

Hiding is useful for keeping a component instance out of general view while still maintaining its presence on the page. When you hide a child component through the Component Properties dialog, it is hidden in everyone's view of the page. When you are ready to show the component instance, it is a simple matter to reselect the component to show through the Child Components tab.

To hide or show child components:

1. Access component properties as described in Section 17.5.2.3, "Setting Component Properties."

2. Click the Child Components tab to bring it forward (see Figure 17-53).

3. The next step depends on whether you want to hide or show a component:

- Clear the checkbox to the left of any components you want to hide.

- Select the checkbox to the left of any components you want to show.

4. Click OK to exit the dialog.

5. Click Save and then Close to exit Oracle Composer.

17.5.2.6.2 Rearranging Child Components

The Child Components tab provides a convenient and efficient way to rearrange the content within a particular container, such as a Box layout component. When you rearrange child components through the Component Properties dialog, they are rearranged on everyone's view of the page.

Tip:

You can also rearrange page components in a way that affects everyone's view by dragging and dropping components while in Oracle Composer.

Note:

When you use Box controls to split a Box, the rearrange capability is disabled in the Component Properties dialog on the Child Components tab. You can still rearrange content in such boxes by dragging and dropping on the page itself.

To rearrange a child component:

1. Access component properties as described in Section 17.5.2.3, "Setting Component Properties."

2. Click the Child Components tab to bring it forward (see Figure 17-53).

3. Click the up or down arrows next to the component you want to move, depending on where you want to move it.

Tip:

The direction that a child component is moved depends on the orientation of its parent container. For example, if the container is oriented vertically, child components move up (up arrow) or down (down arrow); if the container is oriented horizontally, child components move right (up arrow) or left (down arrow).

4. Click OK to exit the dialog.

5. Click Save and then Close to exit Oracle Composer.

17.5.2.7 Working with Style and Content Style Properties

Style and Content Style properties, available in the Component Properties dialog, provide an opportunity to fine-tune your application look-and-feel at the component level. Enter values for Style and Content Style properties, or specify your own values through the Other CSS property that appears on both tabs.

See Also:

For information about accessing the Component Properties dialog, Section 17.5.2, "Setting Properties on Page Components."

This section introduces Style and Content Style properties and provides tables that list and describe them. Additionally, it provides information about how to use the Other CSS property. It includes the following subsections:

- Section 17.5.2.7.1, "Understanding Style and Content Style Properties"

- Section 17.5.2.7.3, "Entering Other CSS"

- Section 17.5.2.7.4, "Using the Other CSS Property to Change Component Borders"

17.5.2.7.1 Understanding Style and Content Style Properties

Use component Style and Content Style properties to specify color, style, and margin settings on the selected component instance.

Style settings override the style settings on hierarchically superior components, such as the component's parent container, the page, and the application. Content Style settings override Style settings. For example, Style settings control the look and feel of a Movable Box; when Content Style settings come into play, Style settings control only the Movable Box chrome. Content Style settings control the look and feel of the components contained within the Movable Box. This look and feel may, in turn, be overridden by the Style settings set on those individual components.

See Also:

For information on layout components, such as Movable Boxes, see Chapter 18, "Adding and Configuring Page Layout Components."

Note, however, that Content Style properties set for a container, such as a Movable Box, may not take effect if the component inside the container overrides the container Content Style properties by a means other than the component's own Content Style properties. For example, the background color set for a Movable Box that contains a task flow may not take effect if, at design time, instead of being set to inherit from the container, the task flow background color was set with a hard-coded value.

17.5.2.7.2 Style and Content Style Properties

Table 17-2 lists and describes common component Style and Content Style properties.

Table 17-2 Style and Content Style Properties

Property

Description

Background Color

A pick-list for selecting a component background color

If you specify a background color for Content Style, then the background color specified for the Style property is not applied.

Background Image

A field for entering a URL to a component background image

Enter the URL to an image you want to render in the component background. Use standard CSS syntax. For example:

url(http://www.abc.com/image.jpg)

Color

A pick-list for selecting a default color for text

Select a default color for any text included in the component instance. For example, imagine that you have added a Text layout component to a Box layout component. When you set Box Style properties, the default text color you apply to the Box is also automatically applied to the Text layout component, unless you also define a Color value for the Text layout component.

Select a color using one of the following techniques:

- Select a color by clicking it.

- Enter the color's RGB equivalent in the Color field. Enter RGB values in the format RRGGBB or #RRGGBB or r,g,b

- Create a custom color by clicking Custom Color in the picker and selecting a color and a saturation level using the selector and the slider provided.

Font

A field for specifying the font to use for component content

Select a default font for any text included in the component

The font you select here applies to any text inside the container/parent component.

Select a default font for component content. Separate multiple values with a comma (,), for example arial,helvetica,sans-serif. Enclose font names that contain spaces in single quotation marks, for example 'Times New Roman'. The browser tries to use the first value, and uses other values in turn, depending on which font is available to the local system.

Font Size

The size of component text relative to either your browser's default font size or the font size of the parent element

Enter one value from the following types of values:

- length–Sets the font size to a fixed size. For example, enter: 14px. 1.5em, and so on

- xx-small, x-small, or small

- medium–The default

- large, x-large, or xx-large

- smaller–Sets the font size to a size smaller than the parent element.

- larger–Sets the font size to a size larger than the parent element.

- %–Sets the current font size to a percentage of the font size of the parent element. For example, enter: 75%

Font Style

Options for applying styles to component fonts

Choose from:

- Bold

- Italic

- Underline

- Strikethrough

The font style you select here applies to any text inside the component.

Height

A field for specifying the height of component content

Set a fixed height for component content. You can use any standard CSS unit of measure, such as pt, px, pc, li, and so on.

Never express a Height value as a percentage. Because of differences between browsers and between layout containers, percentages do not work as you expect. If you want your component to take up 100% of a page, consider creating a page using the Stretch page style and adding the component to it (for more information, see Section 15.1, "What You Should Know About Page Styles").

The Height property works with the Stretch Content property, available on the Display Options tab. Stretch Content enables a container to stretch its content to the specified height.

Margin

Fields for specifying the border of space to draw around the component

Enter one of the following types of values:

- An absolute value. Include your preferred unit of measurement.

For example:

2px

Use only those units of measurement supported in standard CSS, such as pt, px, pc, li, and so on.

- A percentage of the margin of a parent component (provide a percent sign with your value, such as 10%).

- auto: Set the value automatically according to browser defaults.

Other CSS

A field for specifying additional CSS for the component

Add any other CSS encoding you care to that is not covered by the other Style or Content Style properties. You must use standard CSS syntax for this value to be valid (for more information about Other CSS, see Section 17.5.2.7.3, "Entering Other CSS").

Width

A field for specifying the width of component content

Set a fixed width for component content. You can use any standard CSS unit of measure, such as pt, px, pc, li, %, and so on.

17.5.2.7.3 Entering Other CSS

The Other CSS field that appears on Style and Content Style tabs offers an opportunity to apply CSS styles that are not otherwise provided on the tabs. Use standard CSS syntax (for information about standard CSS syntax, see http://www.w3.org/TR/CSS2/propidx.html). Separate multiple entries with a semicolon (;), for example:

background: #00FF00 url(http://www.google.com/intl/en_ALL/images/logo.gif) no-repeat fixed top; font-size: xx-small

Note, however, that some CSS styles are not supported by popular browsers. Moreover, some styles are specific to one browser and may not work correctly in another browser.

Table 17-3 provides a few examples of CSS you can use in the Other CSS field.

Table 17-3 Example Values for Other CSS

Value

Description and Examples

background-repeat

Specify whether and how the background image should repeat. Enter a value in the format background-repeat: <value>

For example:

background-repeat: repeat

- no-repeat–Forgo repeating the image.

- repeat–Repeat the image to fill the container.

- repeat-x–Repeat the image horizontally but not vertically.

- repeat-y–Repeat the image vertically but not horizontally.

background-position

Set the starting position of a background image. Enter values in the format background-position: <value> <value>

For example:

background-position: top left

Except as noted, if you specify only one value, the second value defaults to center.

The first set of value pairs express horizontal and vertical as positions:

- top left, top center, or top right

- center left, center center, or center right

- bottom left, bottom center, or bottom right

The second set of value pairs express horizontal and vertical positions as either percentages or units of measure:

- x% y%–The horizontal (x) and vertical (y) positions expressed as a percentage. The top left corner is 0% 0%. The bottom right corner is 100% 100%. If you specify only one value, the second value defaults to 50%.

- xpos ypos–The horizontal (x) and vertical (y) positions expressed as a unit of measurement. The top left corner is 0 0. Units can be pixels (0px 0px) or any other CSS units. If you specify only one value, the second value defaults to 50%.

You can mix % and positions.

font-size

The size of component text relative to either your browser's default font size or the font size of the parent element. Enter a value in the format font-size: <value>

For example:

font-size: xx-small

- length–Sets the font size to a fixed size, for example font-size: 14px

- xx-small, x-small, or small

- medium–The default

- large, x-large, or xx-large

- smaller–Sets the font size to a size smaller than the parent element.

- larger–Sets the font size to a size larger than the parent element.

- %–Sets the current font size to a percentage of the font size of the parent element, for example, font-size: 75%

padding

A collective property for setting the white space (or clear space) around a component in one expression. Enter up to four values. Express values in a specific length or as a percentage of the closest element, using the syntax padding: <value> <value> <value> <value>

For example:

padding: 5px 10px 5px 10px

Where:

- One value sets padding for all four sides. For example, padding: 10px

- Two values set padding for top/bottom and left/right. For example, padding: 10px 15px

- Three values set padding for top, left/right, and bottom. For example, padding: 10px 5% 10px

- Four values set padding in turn for top, right, bottom, left. For example, padding: 5px 10px 15px 20px

Use any standard CSS unit of measure, such as pt, px, pc, li, %, and so on.

padding-bottom

Sets the white space (or clear space) at the bottom of the element. Express values in a specific length or as a percentage of the closest element. For example:

padding-bottom: 10px

padding-left

Sets the white space (or clear space) at the left side of the element. Express values in a specific length or as a percentage of the closest element. For example:

padding-left: 2%

padding-right

Sets the white space (or clear space) at the right of the element. Express values in a specific length or as a percentage of the closest element. For example:

padding-right: 1pc

padding-top

Sets the white space (or clear space) at the top of the element. Express values in a specific length or as a percentage of the closest element. For example:

padding-top: 16pt

17.5.2.7.4 Using the Other CSS Property to Change Component Borders

One application of the Other CSS property is to provide a variety of borders on task flows, portlets, and some layout components.

For example, Figure 17-54 depicts a Recent Activity task flow without borders.

Figure 17-54 Task Flow Without Borders

To create borders around the task flow, access its properties (for more information, see Section 17.5.2.3, "Setting Component Properties") and add CSS encoding. For example, enter the following code in the Other CSS field on the Style tab in the Component Properties dialog:

Example 17-1 Other CSS for Creating Borders

border-bottom-width:4px;
border-bottom-color:red;
border-bottom-style:dashed;
border-top-width:4px;
border-top-color:red;
border-top-style:dashed;
border-left-width:4px;
border-left-color:red;
border-left-style:dashed;
border-right-width:4px;
border-right-color:red;
border-right-style:dashed;

Figure 17-55 illustrates the result.

Figure 17-55 A Border Created Through the Other CSS Property

17.5.2.8 Working with Component Contextual Events

Events are defined occurrences within the current context. Event handlers are the engines that drive the results of that occurrence. The Events tab in the Component Properties dialog provides a means of wiring a contextual event to an action handler to enable the passing of values from a producer component to a consumer component when the event is triggered on the producer (Figure 17-56).

Figure 17-56 Events Tab in the Component Properties Dialog

See Also:

For information about accessing the Component Properties dialog, Section 17.5.2, "Setting Properties on Page Components."

For example, imagine two components: one is the producer of some kind of content (a payload) and the other consumes the content. When you wire these components to each other, you can use events to specify that when an event is triggered on the producer, the producer broadcasts a contextual event with a payLoad parameter, which the consumer component consumes through an event handler.

Note:

Contextual events differ from the business events that can be raised by ADF Business Components. Additionally, contextual events differ from events raised by UI components. Contextual events can be used in association with UI events. In this case, an action listener that is invoked due to a UI event can, in turn, invoke a method action binding that then raises the event.

See Also:

For information about business events, see Oracle Fusion Middleware Web User Interface Developer's Guide for Oracle Application Development Framework.

Not all components support contextual events because not all components were created to include them; therefore, the Events tab does not appear for all components. For events to be available at runtime, event capability must be included in a component when the component is developed.

Table 17-4 lists and describes the properties presented on an Events tab.

Table 17-4 Properties on the Events Tab

Property

Description

Events

A list of all contextual events associated with components on the current page

An event describes the type of action that triggers another action, such as the passing of a value. The events listed in the Events pane were built-in to the component when the component was created. All components do not include events; therefore, all components are not intrinsically capable of being wired to other components.

Actions

A list of action handlers associated with the selected consumer component

The actions listed in the Actions pane vary according to which consumer component is selected. Actions enable you to associate an event with an event handler, which specifies what should happen when the triggering event occurs. The actions listed in the Actions pane were built-in to the component when the component was created.

Enable Action

A checkbox for enabling or disabling the selected event and action

When you select this checkbox, a list of selected action handler parameters appears.

List of selected action handler parameters

Fields for entering values to use to deliver the payload from the producer component to the consumer component whenever the event occurs

Enter parameter values, or click the Edit icon next to a parameter field to open an Expression Language Editor. For more information, see Section B.1, "Introducing the Expression Builder"

Parameter fields appear only when the Enable Action checkbox is selected.

For information about wiring components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

17.6 Deleting Pages

You have a few options for deleting WebCenter Spaces pages:

- If the page is rendered as a tab, you can select the Delete Page command from the page Actions menu, which you access by right-clicking the tab.

- Navigate to the Personalize Pages page, and select the Delete Page command on the Actions menu associated with the page.

- As the application administrator, you can navigate to the Pages tab in the Administration pages and select the Delete Page command on the Actions menu associated with the page.

To navigate to the Administration Pages tab, use the following URL:

http://host:port/webcenter/spaces/admin/personalpages

For information about deleting a Space, see Section 51.17, "Deleting a Space."

Note:

You cannot delete the Home Space.

18 Adding and Configuring Page Layout Components

Layout components provide a means of enhancing a page's given layout with additional content areas, images, links, text, and the like. Use page layout components to boost company branding (Image), provide a mission statement (Text), direct users to related information (Links and Hyperlink), and so on.

This chapter describes how to work with page layout components that are packaged with WebCenter Spaces. It includes the following sections:

- Section 18.1, "Adding a Layout Component to a Page"

- Section 18.2, "Working with Layout Components"

- Section 18.3, "Deleting Layout Components"

Audience

This chapter is intended for users granted the application-level permission Pages: Create, Edit, and Delete Pages or the Space-level permission Basic Services: Edit Page Access, Structure, and Content. Typically such users want to enhance page layout by adding and configuring layout components. Such users include authorized users working in the Home Space and in Spaces.

Your application administrator has the authority to expose or hide application resources and revise default permissions. Tasks discussed in this chapter are not available to you if the relevant resource is hidden or you are not authorized to perform them.

18.1 Adding a Layout Component to a Page

The process of adding a layout component to a page is the same for every layout component. Therefore, you can use the steps in this section for any layout component you add to a page.

See Also:

This section provides information about adding a layout component while the page is in Design view. For information about adding content while the page is in Source view, see Section 17.5.1.2, "Adding a Component to a Page in Source View of Page Edit Mode."

To add a layout component to a page:

1. Go to the page where you want to add a layout component, and open it in Oracle Composer.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click the Add Content button in the content area where you want to place the layout component to open the Resource Catalog (Figure 18-1).

Figure 18-1 Add Content Button and Resulting Resource Catalog

Note:

In WebCenter Spaces, the content of the Resource Catalog varies according to the services that are integrated with the application, the location from which the catalog is opened, and the resources provided by your administrator. For example, the components that appear in the catalog when you open it from the Home Space differ from those that appear when you open it from a Space. Additionally, authorized users can create custom catalogs that may or may not contain the components you want. Such users can reconfigure the catalog if needed components are not present. They can also rename catalog folders. For more information, see Chapter 16, "Working with Resource Catalogs."

3. In the catalog, click the Open link next to Web Development to display a selection of layout components (Figure 18-2).

Figure 18-2 Web Development Components in Resource Catalog

4. Click the Add link next to the component you want to add to the page.

Tip:

By default, new components are added to the top of their content areas.

When you add a component to a page, you must wait for the application status indicator to finish processing before taking additional action.

5. Click the Close button to exit the catalog.

6. Optionally, drag-and-drop the newly-added component to the desired position on the page, or use the Move icons on the component to reposition it.

Tip:

As you drag a component around, a dark box marks the target drop location.

7. Click Save to save your changes, and then Close to exit Oracle Composer.

Tip:

Some layout components are provided as part of the page infrastructure and are not obviously exposed in the Resource Catalog. An example of this is the spacer component. Although you cannot add more of them to a page, you can configure their properties. For more information, see Section 18.2.10, "Working with Internal Layout Components."

18.2 Working with Layout Components

Each layout component has associated properties that you can use to refine the appearance and behavior of a layout component instance. This section provides information about accessing and providing values for layout component properties. It contains the following subsections:

- Section 18.2.1, "Setting Properties on a Layout Component"

- Section 18.2.2, "Working with the Box Layout Component"

- Section 18.2.3, "Working with the Movable Box Layout Component"

- Section 18.2.4, "Working with the HTML Markup Layout Component"

- Section 18.2.5, "Working with the Links Layout Component"

- Section 18.2.6, "Working with the Hyperlink Layout Component"

- Section 18.2.7, "Working with the Image Layout Component"

- Section 18.2.8, "Working with the Text Layout Component"

- Section 18.2.9, "Working with the Web Page Layout Component"

- Section 18.2.10, "Working with Internal Layout Components"

18.2.1 Setting Properties on a Layout Component

Layout components have associated properties, which authorized users can access from the Oracle Composer Component Properties dialog.

Note:

When you enter most types of property values in the Component Properties dialog and then click Apply, the dialog remains open. With values other than expected value types, the dialog closes, and the page is refreshed to reflect the new value. For example, if a component takes a java.util.ArrayList of java.awt.Color classes, then the Component Properties dialog closes and Composer does a full-page-refresh.

There are two ways to access the Component Properties dialog: through Oracle Composer Design view and Oracle Composer Source view. This section describes both methods. It includes the following subsections:

- Section 18.2.1.1, "Setting Layout Component Properties in Design View"

- Section 18.2.1.2, "Setting Layout Component Properties in Source View"

18.2.1.1 Setting Layout Component Properties in Design View

To set layout components properties in Design view:

1. Go to the page where you want to edit layout component properties, and open it in Oracle Composer.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click the Edit icon (Figure 18-3) on the layout component of interest to open the Component Properties dialog.

Figure 18-3 Edit Icon on a Layout Component

3. Edit component properties, and click OK when you have finished.

Tip:

in addition to entering literal text (value), you can also enter an Expression Language (EL) expressions (#{value}). For information about EL expressions, see Appendix B, "Expression Language Expressions."

See Also:

For information about properties associated with a particular layout component, see the section that covers the particular component. For example, see Section 18.2.2.2, "Setting Box Layout Component Properties" for information about properties associated with the Box layout component.

For detailed information about properties that are common to most types of components, see Section 17.5.2, "Setting Properties on Page Components."

18.2.1.2 Setting Layout Component Properties in Source View

To set layout component properties in Source view:

1. Go to the page where you want to edit layout component properties, and open it in Oracle Composer.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. From the View menu, select Source (Figure 18-4).

Figure 18-4 Source Option on View Menu

3. In the list of components, click the component with properties you want to configure.

4. Click the Edit icon in the Source view header (Figure 18-5) to open the Component Properties dialog.

Figure 18-5 Edit Button and Selected Box Layout Component

5. Edit component properties, and click OK when you have finished.

Tip:

in addition to entering literal text (value), you can also enter an Expression Language (EL) expressions (#{value}). For information about EL expressions, see Appendix B, "Expression Language Expressions."

18.2.2 Working with the Box Layout Component

A Box is a content area that you can use to place other components on the page. Unlike its counterpart, Movable Box, a Box cannot be moved around the page at application runtime, though its content can be rearranged. This section provides an overview of the Box layout component and lists and describes its associated properties. It includes the following subsections:

- Section 18.2.2.1, "What You Should Know About the Box Layout Component"

- Section 18.2.2.2, "Setting Box Layout Component Properties"

18.2.2.1 What You Should Know About the Box Layout Component

The Box layout component is the landing place for the task flows, portlets, and layout components that you add to a page.

In page edit mode, a Box is typically rendered as rectangle comprised of dashed lines, an Add Content button, and Add a Tab Set or a Tab, Add Box, Edit, and Delete icons (Figure 18-6).

Figure 18-6 Box Layout Component

Not all Box controls appear every time. What you see depends on your permissions, whether the Box is the top-most Box (which cannot be deleted, thus no Delete icon), whether the Box is stretched (in which case you cannot add other Boxes to it, thus no controls for doing so), and whether Box properties are set to show or omit certain controls (for more information, see Table 18-1, "Box Layout Component Display Options").

You can place content within a Box, and you can place one or more Boxes within a Box (unless the Box is configured to stretch its content, that is, Layout equals stretch). You can configure Box properties to display content horizontally, vertically, or stretched. You can specify the display of a scrollbar or set the Box to devote all its area to a single component (stretched). You can use Box controls to add Boxes above, below, or to either side of a given Box and to add a tab or a tab set within the Box.

See Also:

For information about adding tab sets and configuring tabs, see Section 17.3.5.5, "Creating Layered Content Regions Using Tabs."

You could, if you like, add one Box to a page, and use its controls to add all the Boxes and tabs you require, rather than adding multiple Boxes for that purpose.

18.2.2.2 Setting Box Layout Component Properties

Box layout component properties provide a means of enabling or disabling the display of an Actions menu, a tab creation icon, and Box split icons; specifying the alignment and orientation of Box content; rearranging Box components; and providing tooltip text on the Box.

Box layout component properties include a Child Components tab with options for hiding, showing, and rearranging the Box content. For more information, see Section 17.5.2.6, "Working with Child Components."

A Style tab is available for setting styles on the component instance. The styles you set here override the styles that would otherwise govern the component's appearance, primarily the styles otherwise provided by the application skin. Box style properties are common to many other components. Commonly shared Style properties are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-1 lists and describes Box layout component display options.

Table 18-1 Box Layout Component Display Options

Property

Description

Allow Action

Enables or disables the display of various actions on the Box and on the components you add to the box:

- all—Show the Add Content button on the Box, show the Add Box icons, display the Actions menu on all Box child components that support it, and allow the movement of Movable Boxes into and out of the Box.

- none—Hide the Add Content button on the Box, hide the Add Box icons, and disable the display of the Actions menu on all Box child components. Additionally, any Movable Boxes inside the Box are frozen and cannot be moved; and users cannot move Movable Boxes into the Box.

Horizontal Alignment

Specifies how Box content should align between its left and right boundaries:

- start—Align content with the front position, determined by the reading order of the selected language. This value is provided to accommodate environments that support bidirectional languages.

- center—Align content with the center of the Box.

- end—Align content with the final position, determined by the reading order of the selected language. This value is provided to accommodate environments that support bidirectional languages.

- left—Align content with the left side of the Box.

- right—Align content with the right side of the Box.

Layout

Specifies the orientation of Box content:

- vertical—Align Box content in a vertical orientation (that is, as a column of objects).

- horizontal—Align Box content in a horizontal orientation (that is, as a row of objects). When Layout is set to horizontal, this component cannot be stretched by a parent component that stretches its children.

- scroll—Align Box content vertically with a scrollbar. The scrollbar is rendered when the height/width of its content exceeds the Box's height or width.

- stretch—The Box content stretches to accommodate the specified size of the Box. If no height (see Section 17.5.2.7, "Working with Style and Content Style Properties") is specified for the Box, it defaults to a height of 200 pixels, unless the Box is placed inside another stretching component. In this case, the Box height is controlled by its parent (but see, horizontal). When you select stretch, the Add Content button is hidden after one component is added to the Box, and you cannot drag and drop content into the Box. Additionally, you cannot split a Box with a Layout value of stretch.

Short Desc

Specifies tooltip text for the Box

Tooltip text appears when users roll their mouse pointers over the Box.

Show Component

Hides or shows the component on the page:

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

Show Split Action

Show or hide the icons that enable splitting a Box into one or more Boxes

- Select the checkbox to show Add Box icons on the Box

- Clear the checkbox to hide the icons on the Box

Show Tab Action

Show or hide the icon that enables adding tabbed regions to a Box

- Select the checkbox to show the Add a Tab Set or a Tab icon on the Box

- Clear the checkbox to hide the icon on the Box

Vertical Alignment

Specifies how Box content should align between its top and bottom boundaries:

- top—Align content at the top of the Box.

- middle—Align content with the middle of the Box.

- bottom—Align content at the bottom of the Box.

- baseline—Align content at the Box baseline, which is slightly above the bottom.

Vertical Alignment applies only when the layout is horizontal.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.3 Working with the Movable Box Layout Component

A Movable Box is a container wrapped around a Box that not only enables the placement of content on a page (via the Box), but also provides a means of moving all of that content at once in both page edit mode and page view mode. This section provides an overview of the Movable Box layout component. It includes the following subsections:

- Section 18.2.3.1, "What You Should Know About the Movable Box Layout Component"

- Section 18.2.3.2, "Setting Movable Box Layout Component Properties"

18.2.3.1 What You Should Know About the Movable Box Layout Component

The Movable Box layout component (Figure 18-7) enhances the features of a Box by adding mobility.

Figure 18-7 Movable Box Layout Component

Users can grab the Movable Box by its header and drag it and all of its content to a new position on a page. Users can reposition a Movable Box in both page edit and page view modes. Movable Boxes can also be resized.

Tip:

Avoid adding a portlet to a Movable Box layout component. Adding a portlet to a Movable Box creates an unnecessary and potentially error-prone redundancy.

18.2.3.2 Setting Movable Box Layout Component Properties

The Display Options associated with Movable Boxes provide a means of hiding or showing the Movable Box header, providing header text, adding a tooltip to the Movable Box that users see when they roll their mouse pointers over the header, and other like controls.

Movable Box Display Options are common to many other types of components and are listed in Table 17-1, "Display Options Properties".

Movable Box Display Options are presented on two subtabs: Basic and Advanced (Figure 18-8).

Figure 18-8 Movable Box Layout Component Display Options

By default, each Movable Box encloses a Box layout component. For information about Box component properties, see Section 18.2.2.2, "Setting Box Layout Component Properties."

18.2.4 Working with the HTML Markup Layout Component

The HTML Markup layout component is a simple editor for adding HTML markup to a page. (This includes JavaScript embedded in HTML <script> tags.) This section provides an overview of the HTML Markup layout component and lists and describes its associated properties. It also provides a sample use case for embedding a YouTube video onto a page.

This section includes the following subsections:

- Section 18.2.4.1, "What You Should Know About the HTML Markup Layout Component"

- Section 18.2.4.2, "Setting HTML Markup Layout Component Properties"

- Section 18.2.4.3, "Embedding Video, Music, Slides, and Other Types of Content"

18.2.4.1 What You Should Know About the HTML Markup Layout Component

The HTML Markup layout component is a simple editor for entering raw text and HTML tags, including HTML <script> tags (Figure 18-9).

Figure 18-9 An HTML Markup Layout Component

Enter markup through the editor's component properties. Enter any type of valid HTML. Enclose JavaScript in the appropriate HTML markup. For example, enter (Figure 18-10):

<script type="text/javascript">
document.write("This is my JavaScript.");
</script>

Figure 18-10 Sample JavaScript in HTML Markup Display Options

The editor's header appears in page edit mode, but does not appear in page view mode. So you can place an individualized message on a page, for example, Welcome #{securityContext.userName}!, and the message will not be cluttered with the component header.

18.2.4.2 Setting HTML Markup Layout Component Properties

HTML Markup layout component properties provide a means of entering a brief bit of HTML markup, JavaScript, text, or Expression Language (EL). For example, use the HTML Markup layout component to embed a personalized message to page visitors, a YouTube video, a Google Gadget, a Pandora Music Station, and the like (for more information, see Section 18.2.4.3, "Embedding Video, Music, Slides, and Other Types of Content").

In addition to content entry, use the properties on the Display Options tab to control text entry behavior and provide tooltip text (see Table 18-2).

HTML Markup layout component properties include a Style tab with options for setting styles on the component instance. The styles you set here override the styles that would otherwise govern the component's appearance. These include styles set on the component's parent container, the current page, and the application. HTML Markup style properties are common to many other components, and are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-2 lists and describes HTML Markup layout component display options.

Table 18-2 HTML Markup Layout Component Display Options

Property

Description

Escape

A checkbox for enabling or disabling literal evaluation of special characters

Use this property to make the output safe or not safe. Safe means that any tags, such as <script> are escaped into &lt;script&gt; so that they do not run. Not safe means whatever you enter for value finds its way onto the page, even if it does something undesirable.

- Checked (true) enables literal evaluation of such characters as angle brackets (<|>) and HTML special characters. For example, when a user enters &#8212; it is rendered as &#8212;.

- Cleared (false) disables literal interpretation of special characters. For example, when a user enters &#8212;, it is rendered as —. False is the default value.

No Wrap

A checkbox for enabling or disabling text wrapping

- Checked (true) disables text wrapping. Users must enter line breaks manually.

- Cleared (false) enables text wrapping. Lines wrap in accordance with the component width. False is the default value.

Short Desc

A field for entering tooltip text for the HTML Markup layout component

When users roll their mouse pointers over the component, this text appears as a tooltip.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

Value

A field for specifying the content that this component renders

In addition to text, this parameter also accepts HTML, JavaScript, and Expression Language (EL) expressions. For guidelines and examples, see Section 18.2.4.1, "What You Should Know About the HTML Markup Layout Component."

After you save your changes and close the page editor, the HTML Markup component shows the evaluated value of the markup.

Tip:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.4.3 Embedding Video, Music, Slides, and Other Types of Content

You can use the HTML Markup layout component to expose video, music, Google Gadgets, and other types of content in your application pages. This section describes how.

Note:

When you add a component to a page, you must wait for the application status indicator to finish processing before taking additional action.

To embed different types of media on an application page:

1. Copy the HTML code you want to embed.

For example:

<object width="640" height="385">
<param name="movie"
value="http://www.youtube.com/v/cAYw2zcSIPw?fs=1&amp;hl=en_US" />
<param name="allowFullScreen" value="true" />
<param name="allowscriptaccess" value="always" />
<embed src="http://www.youtube.com/v/cAYw2zcSIPw?fs=1&amp;hl=en_US"
type="application/x-shockwave-flash" allowscriptaccess="always"
allowfullscreen="true" width="640" height="385" />
</object>

2. Go to the page where you want to embed video, music, or some other type of medium, and open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

3. Click the Add Content button associated with the Box or Movable Box where you want to embed content to open the Oracle Composer Catalog.

4. Click the Open link next to Layout, and then click the Add link next to HTML Markup.

Optionally, use the Catalog Search feature to locate the HTML Markup layout component, and then click the Add link next to the component.

5. Click the Close button to close the Catalog.

6. Click the Edit icon on the HTML Markup component (Figure 18-11) to open the Component Properties dialog.

Figure 18-11 Edit Icon on an HTML Markup Layout Component

7. Click the Display Options tab to bring it forward, and then, in the Value field, paste the copied HTML code.

8. Click OK to close the Component Properties dialog.

9. Click Save and then Close to exit Oracle Composer.

18.2.5 Working with the Links Layout Component

Use the Links layout component to add a navigation instance to a page. Links component navigation can include links to pages, external web sites, and application content. A browse capability is available to simplify the process of locating link targets. An advanced search feature is also available to assist in locating content objects.

This section provides information about the Links layout component, how to set it up, and how to configure its properties. It includes the following subsections:

- Section 18.2.5.1, "What You Should Know About the Links Layout Component"

- Section 18.2.5.2, "Configuring the Links Component"

- Section 18.2.5.3, "Setting Links Layout Component Properties"

18.2.5.1 What You Should Know About the Links Layout Component

The Links layout component enables you to add a single instance of navigation to a page, outside the more formal structure of your portal's navigation resources (Figure 18-12).

Figure 18-12 Links Layout Component

The links component is associated with the page or template on which it is placed. When you put a links component on a page and add some links, those links are associated with the page. That is, the lifecycle of the links component respects the lifecycle of the page or template on which it is placed. For example:

- When a page containing links is copied, all the links are also copied, and the page copy has its own set of links. Modifying links on the original page does not affect the page copy. The same is true for links on page templates.

- When a page is deleted, all links associated with the page are also deleted. The same is true for links on page templates.

- If a Space template contains pages with links, creating a new Space based on the template effectively creates a clone of all the pages in the template. Consequently, the new Space has pages with links that are separate from the ones in the template.

- When a Space is exported or imported, any links associated with Space pages are also exported or imported.

The Links component's Add, Edit, and Delete Link UI is available in both page view and page edit modes to users with Edit permission on the page. Users without Edit permission see only the added navigation links. Changes in both edit and view modes are visible to all users who can view the page. That is, the addition of links falls outside the constraints of user customization, where changes made in page view mode are visible only to the user who made them.

A control is available for specifying that a link target is opened within the context of the current page template or in place of the page on which it was invoked. There are also controls on each link for configuring a given link's properties and deleting the link (Figure 18-13).

Figure 18-13 Controls on Individual Links

The Links component's properties provide opportunities for controlling the behavior and look and feel of a Links component instance. For more information, see Section 18.2.5.3, "Setting Links Layout Component Properties."

18.2.5.2 Configuring the Links Component

This section steps you through the process of setting up informal navigation using the Links component. It includes the following sections:

- Section 18.2.5.2.1, "Adding Navigation Links"

- Section 18.2.5.2.2, "Configuring an Advanced Search for Content Links"

- Section 18.2.5.2.3, "Configuring a Link in the Links Component"

- Section 18.2.5.2.4, "Reordering Navigation Links"

- Section 18.2.5.2.5, "Deleting a Link from the Links Component"

18.2.5.2.1 Adding Navigation Links

To add links using the Links component:

1. Open the Add Link menu and select a link type:

- Page Link—Add a link that targets an application page.

- External Link—Add a link that targets a site that is external to the application.

- Content Link—Add a link that targets a document from a content repository.

To add a Page Link:

1. Select Page Link to open the New Page Link dialog (Figure 18-14).

Figure 18-14 New Page Link Dialog

2. In the Name field, enter a display name for the link.

3. For Path, click Browse to open the Select a Page dialog (Figure 18-15).

Figure 18-15 Select a Page Dialog

4. Select a page from the given options, or click Search to locate a page on the available list of pages.

Tip:

In the Home Space, you can select from pages that are available to you in your view of the Home Space. In other Spaces, you can select from pages that are available within the scope of the current Space.

5. Click Select.

6. Click OK.

To add an External Link:

1. Select External Link to open the New External Link dialog (Figure 18-16).

Figure 18-16 New External Link Dialog

2. In the Name field, enter a display name for the link.

3. In the URL field, enter the URL to the link target, for example:

http://www.mywebdestination.com

4. Select Render in page template to present the link target content within the context of the current page template.

Clear this checkbox to redirect the current page to the link target.

5. Click OK.

To add a Content Link:

1. Select Content Link to open the New Content Link dialog (Figure 18-17).

Figure 18-17 New Content Link Dialog

2. In the Name field, enter a display name for the link.

3. For Path, click Browse to open the Select Document dialog (Figure 18-18).

Figure 18-18 Select Document Dialog

If the link target is not readily accessible, you can use the Search feature to locate it. For a more pointed search, click Advanced. For more information, see Section 18.2.5.2.2, "Configuring an Advanced Search for Content Links."

4. Click Select.

5. Click OK.

18.2.5.2.2 Configuring an Advanced Search for Content Links

The Links component's Advanced Search feature provides controls for specifying additional search criteria and filters for Content Links searches (Figure 18-19).

Figure 18-19 Advanced Search Dialog

This search is very similar to an advanced document search. For more information, see Section 41.29.2, "Running an Advanced Document Search."

18.2.5.2.3 Configuring a Link in the Links Component

Users with Edit permission on the page can access a configure control on a given link to revise the link's name and target. If you can see the Configure icon to the right of each link, you are authorized to configure links (Figure 18-20).

Figure 18-20 Configure Icon on a Link

To configure a link in the Links component:

1. Go to the instance of the Links component where you want to configure a link.

2. Click the Configure icon to open the Edit Page Link dialog (Figure 18-21).

Figure 18-21 Edit Page Link Dialog

3. Revise the values as required.

See Also:

For information about the values required by Edit Page Link fields, see Section 18.2.5.2.1, "Adding Navigation Links"

4. Click OK.

18.2.5.2.4 Reordering Navigation Links

You can reorder navigation links in a Links layout component by dragging and dropping. Click and hold on a link, drag it to its new position, and release the link.

18.2.5.2.5 Deleting a Link from the Links Component

Authorized users can access a delete control on a given link to remove the link from the Links component. If you can see the Delete icon to the right of each link, you are authorized to delete links (Figure 18-22).

Figure 18-22 Delete Icon on a Link

To delete a link from the Links component:

1. Go to the instance of the Links component where you want to delete a link.

2. Click the Delete icon to delete the link.

3. Click the Delete button in the confirmation dialog.

18.2.5.3 Setting Links Layout Component Properties

The Links component parameters Navigation and Start Path are preconfigured and must not be changed. Changing these parameters can result in breaking the instance's functionality. Table 18-3 lists and describes the parameters associated with the Links layout component.

Table 18-3 Links Layout Component Parameters

Parameter

Description

Navigation

The path to a navigation model that is created specifically for this instance

You should not change this value. Changing this value risks breaking the component instance.

Start Path

The starting location for this navigation instance

Because the Links layout component supports only one hierarchical level, any value other than the default (/) is not supported.

Show Levels

The number of levels of navigational hierarchy to show

Because the Links layout component supports only one hierarchical level, any value you specify has no effect.

Show Root

Specify how to show the navigation root in a tree model

- Do Not Show Root—Do not show the navigation root

- Show Tree Root—Show the navigation root as a stem under which all other navigation is listed

- Show Root As Box—Show the navigation root as a box under which all other navigation is listed

Because the Links layout component supports only one hierarchical level, any value you specify has no effect.

Style

The display style for navigation links

- Collapsed Tree—Navigation is rendered in a tree hierarchy that is initially shown as collapsed

- Expanded Tree—Navigation is rendered in a tree hierarchy that is initially shown as expanded

- List—Navigation links are rendered as a list

Because the Links layout component supports only one hierarchical level, the tree selections have no effect. Navigational links are rendered as a list.

Show Icons

Indicate whether to show or hide any icon associated with a navigation link

The Links layout component also has associated properties that you can safely change. These include Display Options, Style, and Content Style properties. Use these to set default behavior and styles on the component instance.

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

The Display Options you set on the component affect only the particular instance. Links Display Options are common to many other components. Commonly shared Display Options are listed and described in Section 17.5.2.5, "Working with Component Display Options."

The styles you set on the component override the styles that would otherwise govern the component's appearance. These include styles set on the component's parent container, the current page, and the application skin. Links style properties are common to many other components. Commonly shared Style properties are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

18.2.6 Working with the Hyperlink Layout Component

Use the Hyperlink layout component to add a link to a web location to a page. The Hyperlink can point to a location that is either internal or external to the application. This section provides an overview of the Hyperlink layout component and lists and describes its unique properties.

This section includes the following subsections:

- Section 18.2.6.1, "What You Should Know About the Hyperlink Layout Component"

- Section 18.2.6.2, "Setting Hyperlink Layout Component Properties"

18.2.6.1 What You Should Know About the Hyperlink Layout Component

A Hyperlink layout component (Figure 18-23) is comprised of two elements: the link text and the link URL, both of which are added through component properties.

Figure 18-23 Hyperlink Layout Component

Hyperlinks can take both internal and external link targets. For an internal target, you can use a relative directory path. For an external target, that is, a target outside of your portal, always use the full URL.

Tip:

An easy way to obtain the relative directory path of a WebCenter Spaces page is to navigate to the target page and go through the motions of adding it as a Favorite. By default, the Add Favorite dialog provides the relative URL of the current page. Simply copy this information, and use it to define the Hyperlink target. For information about adding a Favorite to WebCenter Spaces, see Section 37.3, "Adding Favorites."

An easy way to obtain the direct URL to a page is to access its About this Page dialog. For more information, see Section 29.9.2, "Accessing Page Information."

Hyperlink layout component properties include a Style tab with options for setting styles on the component instance. The styles you set here override the styles that would otherwise govern the component's appearance. These include styles set on the component's parent container, the current page, and the application. Hyperlink style properties are common to many other components. Commonly shared Style properties are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

18.2.6.2 Setting Hyperlink Layout Component Properties

Hyperlink layout component properties provide a means of specifying link text, target destination, and open behavior.

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-4 lists and describes Hyperlink layout component display options.

Table 18-4 Hyperlink Layout Component Display Options

Property

Description

Destination

A field for entering the hyperlink target URL

Enter the Web address of the page you want to link to.

Open in a new window

Option for determining link target open behavior

- Select to open the link target in a new browser tab or window.

- Clear to open the link target in the current browser tab or window.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

Title

A field for specifying hyperlink text

Enter the word or phrase you want to use as link text.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.7 Working with the Image Layout Component

You can add images from two places in the Resource Catalog:

- Image layout components

- Image files from Documents folder

Unlike images from the Documents folder, Image layout components provide controls for associating a link target with the image. You have the option of associating or omitting a link with an Image layout component.

Tip:

Another difference between image files from the Documents folder and an Image layout component is that image files can be discovered in a search, Image layout components cannot, preventing a return of irrelevant search results.

This section provides an overview of the Image layout component, and lists and describes its associated properties.

This section includes the following subsections:

- Section 18.2.7.1, "What You Should Know About the Image Layout Component"

- Section 18.2.7.2, "Setting Image Layout Component Properties"

18.2.7.1 What You Should Know About the Image Layout Component

Use the Image layout component to add a picture, a logo, a linked image, and the like to a page (Figure 18-24).

Figure 18-24 Image Layout Component

Use any Web-compatible image from any accessible location. That is, do not put in a path to an image on an external server that requires authentication.

Tip:

If you want to display an image that is not linked and is returned in a search, consider using the Documents service Content Presenter task flow in lieu of the Image layout component. For more information, see Section 41.1, "What You Should Know About the Documents Service Task Flows."

The Image layout component includes properties for defining not only the image, but also an optional target URL and short-description (ALT text) text to enhance application accessibility. Target frame options are provided to enable you to define open behavior for the Image's link target.

18.2.7.2 Setting Image Layout Component Properties

Image layout component properties provide a means of specifying the location of the image file, an optional hyperlink target, ALT text, and a target frame for the hyperlink.

Image layout component properties include a Style tab with options for setting styles on the component instance. The styles you set here override the styles that would otherwise govern the component's appearance. These include styles set on the component's parent container, the current page, and the application. Image style properties are common to many other components. Commonly shared Style properties are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-5 lists and describes Image layout component display options.

Table 18-5 Image Layout Component Display Options

Property

Description

Depressed Icon

A URL to the image that represents the image in a clicked state

Use any web-compatible image from any internal or publicly-accessible location.

Destination

A URL for the Image link target destination

For your link target, you can use URLs that are internal or external to the application.

For an internal target, that is, for a WebCenter Spaces page, you can use a directory path relative to the application root directory.

Disabled Icon

A URL to the image that represents the image in a disabled state

Use any web-compatible image from any internal or publicly-accessible location.

Hover Icon

A URL to the image that represents the image when a mouse pointer hovers over it

Use any web-compatible image from any internal or publicly-accessible location.

Icon

The URL to the image file that represents the image in its active, unclicked state

Use any web-compatible image from any internal or publicly-accessible location.

Icon Position

A selection of options for placement of the image

- leading—The image renders at the start of its associated text

- trailing—The image renders at the end of its associated text

Short Desc

Image ALT text

ALT text appears as a tooltip when users roll their mouse pointers over the image.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

Target Frame

Open behavior for the link target

Enter any standard browser target, such as:

- _top—Loads the link target in the current browser window (as opposed to the current frame)

- _parent—Loads the link target in the parent frame of the current frame.

- _self—Loads the link target within the same frame as the frame containing the link.

- _blank—Loads the link target in a new browser tab or window, without closing the original tab or window.

Text

An optional text label to accompany the image

The Icon Position determines whether the image is placed before or after the text specified here.

Text And Access Key

Sets both text and an access key on the image

The access key is denoted by a leading ampersand (&amp;). For example, enter &amp;click me to set the text to click me and the access key to c.

An access key provides a keyboard shortcut to an action. In this case, users press Alt-<access_key>, or Alt-Shift-<access_key> to jump to the image's target destination. The keys that users press to engage the access key depend on the requirements of their browsers.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.8 Working with the Text Layout Component

Use the Text layout component to add a brief statement, page instructions, or any other kind of informative content to a page. This section provides an overview of the Text layout component and lists and describes its associated properties.

This section includes the following subsections:

- Section 18.2.8.1, "What You Should Know About the Text Layout Component"

- Section 18.2.8.2, "Setting Text Layout Component Properties"

18.2.8.1 What You Should Know About the Text Layout Component

The Text layout component provides a convenient way to add static display text and HTML to a WebCenter Spaces page (Figure 18-25).

Figure 18-25 Text Layout Component

The Text layout component provides a Rich Text Editor (RTE), which you can use to enter text, apply text styles, and add links and images (Figure 18-26).

Figure 18-26 Text Layout Component Rich Text Editor

See Also:

For information about the RTE, see Section 41.11, "Using the Rich Text Editor (RTE)."

18.2.8.2 Setting Text Layout Component Properties

The Display Options associated with the Text layout component provide a means of hiding or showing the component header, providing header text, adding a tooltip that users see when they roll their mouse pointers over the header, and other like controls.

Text Display Options are common to many other types of components and are listed in Table 17-1, "Display Options Properties".

Text layout component properties include a Style tab with options for setting styles on the component instance. The styles you set here override the styles that would otherwise govern the component's appearance. These include styles set on the component's parent container, the current page, and through the application skin. Text style properties are common to many other components. Commonly shared Style properties are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

18.2.9 Working with the Web Page Layout Component

The Web Page layout component provides a means of opening a view onto another web page within the context of an application page. This section provides an overview of the Web Page layout component and lists and describes its associated properties.

This section includes the following subsections:

- Section 18.2.9.1, "What You Should Know About the Web Page Layout Component"

- Section 18.2.9.2, "Setting Web Page Layout Component Properties"

18.2.9.1 What You Should Know About the Web Page Layout Component

The Web Page layout component provides a means of displaying a window onto other web pages within the context of a WebCenter application page (Figure 18-27).

Figure 18-27 Web Page Layout Component

The content exposed through a Web Page layout component retains all of the controls associated with the exposed web page. These controls retain their functionality, enabling you to, for example, control the volume of a video, edit a wiki, or post an entry to a blog, depending on the type of content you expose.

You can use internal and external link targets for a Web Page. For an internal target, you can use a relative directory path.

Tip:

In WebCenter Spaces, an easy way to obtain the relative directory path of an application page is to navigate to the target page and go through the motions of adding it as a Favorite. By default, the Add Favorite dialog provides the relative URL of the current page. Simply copy this information, and use it to define the Web Page target.

For information about adding a Favorite to WebCenter Spaces, see Chapter 37, "Creating and Managing Your Personal Favorites."

The Web Page layout component provides a variation on the Web Page page style offered through the Create Page dialog (for more information, see Table 15-2, "Default Page Styles"). The Web Page page style is useful for offering the full external Web page experience. In contrast, the Web Page layout component is useful for including Web page content along with other content types on an application page.

Web Page layout component properties include a Style tab with options for setting styles on the component instance. The styles you set here override the styles that would otherwise govern the component's appearance. These include styles set on the component's parent container, the current page, and the application. Web Page style properties are common to many other components. Commonly shared Style properties are listed and described in Section 17.5.2.7, "Working with Style and Content Style Properties."

18.2.9.2 Setting Web Page Layout Component Properties

Web Page layout component properties provide a means of specifying the URL of the content to render in the Web Page area and the ALT text to display when users roll their mouse pointers over the component border.

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-6 lists and describes Web Page layout component display options.

Table 18-6 Web Page Layout Component Display Options

Property

Description

Short Desc

A field for entering ALT text for the Web Page area

Note that, for the Web Page component, the ALT text appears only when users hover their mouse pointers over the component border. You can improve the ease of this occurrence by increasing, for example, the padding around the component using the Other CSS property on the Component Properties Style tab. For example, you can enter the following in the Other CSS text box:

padding-top:30px;

Source

A field for entering the fully qualified URL to the source Web content to render in the Web Page area

For example:

http://www.oracle.com

Note that www.oracle.com (that is, without http://) does not qualify. If a given URL is invalid, your content does not render within the Web Page layout component.

Note: Use the component's Style properties to adjust the width and height of the display area (for more information, see Section 17.5.2.7, "Working with Style and Content Style Properties.").

If you plan to display the content of another WebCenter Spaces page, you can use a relative address. For more information, see Section 18.2.9.1, "What You Should Know About the Web Page Layout Component."

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.10 Working with Internal Layout Components

This section provides information about the types of layout components that support page infrastructure, but are not available through the Resource Catalog (thus, internal). Such components are exposed through Source view of page edit mode.

This section includes the following subsections:

- Section 18.2.10.1, "What You Should Know About Internal Layout Components"

- Section 18.2.10.2, "Setting panelGroupLayout Properties"

- Section 18.2.10.3, "Setting panelStretchLayout Properties"

- Section 18.2.10.4, "Setting panelTabbed Properties"

- Section 18.2.10.5, "Setting showDetailFrame Properties"

- Section 18.2.10.6, "Setting sidebarItem Properties"

- Section 18.2.10.7, "Setting spacer/Separator Properties"

18.2.10.1 What You Should Know About Internal Layout Components

Some page layout components are not exposed for use in the Catalog. They are nonetheless on view and configurable when you edit a page and set Oracle Composer to Source view (Figure 18-28).

Figure 18-28 Internal Layout Components in Source View

Table 18-7 lists and describes the internal layout components you are likely to encounter in Source view of page edit mode.

Table 18-7 Internal Layout Components

Layout Component

Description

panelGroupLayout

Provides a means of arranging a series of child components vertically or horizontally (no wrapping), or consecutively (wrapping). The Layout property determines the arrangement of the child components. For more information, see Section 18.2.10.2, "Setting panelGroupLayout Properties."

panelStretchLayout

Provides a means of arranging content in defined areas on a page. Useful useful for enabling content to stretch when the browser is resized. For more information, see Section 18.2.10.3, "Setting panelStretchLayout Properties."

panelTabbed

The parent component of a tab set. For more information, see Section 18.2.10.4, "Setting panelTabbed Properties."

showDetailFrame

Renders a border, or chrome, around its child component along with a header that contains icons to enable users to perform some operations. These include a menu icon with options for moving the component, along with its content, to new positions on the page. Users can drag and drop showDetailFrame components from one panelCustomizable component to another on the page. Note that a showDetailFrame must be included inside a panelCustomizable component for it to be movable.

For more information, see Section 18.2.10.5, "Setting showDetailFrame Properties."

sidebarItem

A child component of a tab set (panelTabbed). For more information, see Section 18.2.10.6, "Setting sidebarItem Properties."

spacer

Provides a means of incorporating some blank space in pages so that the page appears less cluttered than it would if all the components were presented immediately next to each other or immediately below each other. For more information, see Section 18.2.10.7, "Setting spacer/Separator Properties."

See Also:

For information about setting component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

18.2.10.2 Setting panelGroupLayout Properties

The panelGroupLayout component provides a means of arranging a series of child components vertically or horizontally (no wrapping), or consecutively (wrapping). The component's Layout property determines the arrangement of child components.

Properties for the panelGroupLayout component include a Child Components tab with options for hiding, showing, and rearranging component content. For more information, see Section 17.5.2.6, "Working with Child Components."

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-8 lists and describes the panelGroupLayout properties that appear on the Display Options tab in the Component Properties dialog.

Table 18-8 panelGroupLayout Display Options

Property

Description

Halign

A means of expressing the horizontal alignment of component content

Select one of:

- start—align content horizontally, starting from the starting position

This is either left or right depending on whether the current context is localized for a left-reading or right-reading language.

- center—align content horizontally, starting from the center

- end—align content horizontally, starting from the ending position

This is either right or left depending on whether the current context is localized for a left-reading or right-reading language.

- left—align content horizontally, starting from the left

- right—align content horizontally, starting from the right

Landmark

A means of enhancing user accessibility as described by the Web Accessibility Initiative for Accessible Rich Internet Applications (WAI-ARIA). Each option describes the intended role of a content area to assist in using the area as a navigational landmark on the page.

Screen readers and other assistive technologies can make use of these landmarks in page navigation.

Select an option to clarify the role or purpose of a content area's content:

- none—A content area that is not intended as a page navigational landmark

- banner—A content area containing mostly site-oriented content, rather than page-specific content, such as the company logo or the portal-wide search feature

Typically, a banner appears at the top of a page and spans the page width.

- complementary—Supporting content, designed to be complementary to the main content at a similar level on the page, but still meaningful when separated from the main content, such as related documents

- content info—A content area that contains information about the application, such as the copyright or privacy statement.

- main—The main content area of the page

- navigation—A collection of navigational elements (usually links) for navigating the page or related pages.

- search—A content area that contains one or more widgets used to define and execute a search.

Layout

A means of specifying the orientation of component content

Choose from:

- default—align content vertically.

- horizontal—align content horizontally

- vertical—align content vertically

- scroll—align content vertically with a scrollbar

The scrollbar is rendered when the height/width of component content exceeds the component height or width.

Short Desc

A field for entering ALT text for the component

ALT text appears as a tooltip when users roll their mouse pointers over the component.

Theme

The component style theme to apply to the children of this component. Use this property to change the theme without causing associated skin changes. Application skins are the sources of the themes. Some skins may have no themed definitions.

Enter one of:

- dark

- medium

- light

No theme (none) is the default.

Valign

A means of expressing the vertical alignment of component content.

Select one of:

- middle—content is aligned with the middle of the parent component

- top—content is aligned with the top of the parent component

- bottom—content is aligned with the bottom of the parent component

- baseline—content is aligned with the baseline of the parent component

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.10.3 Setting panelStretchLayout Properties

The panelStretchLayout component provides a means of arranging content in defined areas on a page. This component is useful for enabling content to stretch when the browser is resized.

The panelStretchLayout component's defined areas are called facets (Figure 18-29).

Figure 18-29 Facets of a panelStretchLayout Component

Note:

Figure 18-29 shows the facets when the language reading direction of the application is configured left-to-right. If instead the language direction is right-to-left, the start and end facets are switched.

Facets are controlled by the values you enter for its Display Options properties. When you set the height of the top and bottom facets, any contained components are stretched to fit the height. Similarly, when you set the width of the start and end facets, any components contained in those facets are stretched to that width. If no components are placed in a facet, then the facet does not take up any space.

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-9 lists and describes the panelStretchLayout properties that appear on the Display Options tab in the Component Properties dialog.

Note:

All panelStretchLayout height and width facets take the value auto; however, using auto slows page performance.

Table 18-9 panelStretchLayout Display Options

Property

Description

Bottom Height

The height of the bottom facet. Use any standard CSS unit of measure, such as pt, px, pc, li, and so on.

Never express a Height value as a percentage. Because of differences between browsers and between layout containers, percentages do not work as you expect. If you want your component to take up 100% of a page, consider creating a page using the Stretch page style and adding the component to it.

End Width

The width of the end facet. Use any standard CSS unit of measure, such as pt, px, pc, li, and so on.

Short Desc

A field for entering tooltip text for the component

The tooltip appears when users roll their mouse pointers over the component.

Start Width

The width of the start facet. Use any standard CSS unit of measure, such as pt, px, pc, li, and so on.

Theme

The component style theme to apply to the children of this component. Use this property to change the theme without causing associated skin changes. Application skins are the sources of the themes. Some skins may have no themed definitions.

Enter one of:

- dark

- medium

- light

No theme (none) is the default.

Top Height

The height of the top facet. Use any standard CSS unit of measure, such as pt, px, pc, li, and so on.

Never express a Height value as a percentage. Because of differences between browsers and between layout containers, percentages do not work as you expect. If you want your component to take up 100% of a page, consider creating a page using the Stretch page style and adding the component to it.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.10.4 Setting panelTabbed Properties

The panelTabbed layout component is the parent component of a tab or tab set. Its unique set of Display Options control the behind-the-scenes method of tab creation, the source for the tabs dimensions, the tab's position, and the like.

See Also:

For information about working with tabs, see Section 17.3.5.5, "Creating Layered Content Regions Using Tabs."

Table 18-10 lists and describes Display Options associated with the panelTabbed layout component.

Table 18-10 panelTabbed Display Options

Property

Description

Child Creation

Specifies when tab content is rendered

- immediate—All tab content is rendered as soon as the page is accessed.

- lazy—Tab content is rendered when the tab is brought forward. This selection may enhance performance by delaying the trip to the server to fetch content.

Dimensions From

Specifies the source of the dimensions applied to the component

- auto—Either parent or disclosedChild, depending on the panelTabbed parent container. If the parent's Layout attribute is set to stretch, then parent is used; otherwise disclosedChild is used.

- disclosedChild—The dimension is taken from the currently active tab.

- parent—(default) The dimension is taken from any values specified on the component; if no values are specified, then they are taken from the parent; if no values are specified on the parent, then they are taken from the skin.

Position

The position of the tab portion of the panelTabbed

- above—(default) Tabs are shown above the tab content area.

- below—Tabs are shown below the tab content area.

- both—Tabs are shown above and below the tab content area.

In accessibility screen reader mode, the tab position is always above.

Short Desc

A field for entering tooltip text for the component

The tooltip appears when users roll their mouse pointers over the component.

Tab Removal

Specifies whether some, none, or all tabs can be removed

- none—Tabs cannot be deleted from the tab set

- all—All tabs can be deleted from the tab set

- allExceptLast—All but one the last tab can be deleted from the tab set

Note: The selection allExceptLast renders a Close icon on all except the last tab when users hover their mouse pointers over them. Additional coding is required on the panelTabbed component before the Close action can execute.

Developers must write code to respond to ItemEvent with a listener attached to the showDetailItem's itemListener attribute. For example:

<af:panelTabbed tabRemoval="allExceptLast" id="pt1">
<af:showDetailItem itemListener="myBean.onRemove" id="sdi1">
…

Write the deletion code in a Java bean named myBean with the method onRemove.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

For information about working with tabs, see Section 17.3.5.5, "Creating Layered Content Regions Using Tabs."

18.2.10.5 Setting showDetailFrame Properties

The showDetailFrame component renders a border, or chrome, around its child component along with a header that contains icons to enable users to perform some operations. These include a menu icon with options for moving the component, along with its content, to new positions on the page. Users can drag and drop showDetailFrame components from one panelCustomizable component to another on the page. Note that a showDetailFrame must be included inside a panelCustomizable component for it to be movable.

A showDetailFrame component enables the following actions:

- Collapse and expand the component

- Move content to different positions on the page

- Rearrange task flows using options on the Actions menu

- Edit and save text in the Rich Text Editor.

The Display Options associated with showDetailFrame are common to many other types of components and are listed in Table 17-1, "Display Options Properties" with one exception: the showDetailFrame layout component does not expose the property Allow Child Selection.

Display Options for showDetailFrame are presented on two subtabs: Basic and Advanced (Figure 18-30).

Figure 18-30 Basic and Advanced Display Options

18.2.10.6 Setting sidebarItem Properties

The sidebarItem component is a child component of panelTabbed (see Section 18.2.10.4). Unlike panelTabbed, which provides all of the properties associated with a tab set, sidebarItem provides all of the properties associated with a single tab.

Table 18-11 describes the sidebarItem properties that appear on the Display Options tab in the Component Properties dialog.

Table 18-11 sidebarItem Display Options

Property

Description

Disclosed

Indicates the current active tab, that is, the tab that is forward

This value is set by default depending on whether the selected tab is forward. Changes you make to this value have no effect.

Icon

The URL to an image

Use any Web-compatible image from any accessible location. That is, do not put in a path to an image on an external server that requires authentication.

Enter a full URL or a URL that is relative to the application root. Use CSS formatting. For example, enter:

url(http://www.abc.com/image.jpg)

Inflexible Height

The number of pixels the component will use when in a container that allocates size among multiple sibling items

If the component requires more than the set limit, its sibling components are pushed to overflow menus. The default is 100 pixels.

Note: This attribute is valid only when the parent container is a panelAccordion component.

Short Desc

A field for entering tooltip text for the component

The tooltip appears when users roll their mouse pointers over the component.

Text

The text to render on the tab

The default value, an EL expression, evaluates to New Tab.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, any child components are also hidden. You can show the component again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.2.10.7 Setting spacer/Separator Properties

The spacer component provides a means of incorporating some blank space in pages so that the page appears less cluttered than it would if all the components were presented immediately adjacent to each other.

Tip:

In the Resource Catalog, this component is called a Separator.

See Also:

For information about setting layout component properties, see Section 18.2.1, "Setting Properties on a Layout Component."

Table 18-12 lists and describes the spacer properties that appear on the Display Options tab in the Component Properties dialog.

Table 18-12 spacer Display Options

Property

Description

Height

A field for specifying the spacer height

Use any standard CSS unit of measure, such as pt, px, pc, li, and so on.

Never express a Height value as a percentage. Because of differences between browsers and between layout containers, percentages do not work as you expect.

Short Desc

A field for entering tooltip text for the component

The tooltip appears when users roll their mouse pointers over the component.

Width

A field for specifying spacer width

Use any standard CSS unit of measure, such as pt, px, pc, li, %, and so on.

Show Component

An option for hiding or showing the component on the page

- Select to show the component

- Clear to hide the component

Once you hide a component in this way, you can show it again in Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

See Also:

Display Options properties additionally provide access to an Expression Language (EL) editor, which you can use to enter and test EL values. For more information, see Appendix B, "Expression Language Expressions."

18.3 Deleting Layout Components

When you delete a layout component, such as a Box, all of the component's children—that is, anything contained in the component—are also deleted. For example, if you delete a Box that contains multiple task flows, the Box and all of the task flow instances it contains are deleted.

The controls for deleting a component are located on the component itself in Oracle Composer Design view and on the header of the list of components in Source view. This section describes how to delete layout components in both Design view and Source view. It includes the following subsections:

- Section 18.3.1, "Deleting a Layout Component in Design View"

- Section 18.3.2, "Deleting a Layout Component in Source View"

18.3.1 Deleting a Layout Component in Design View

To delete a layout component in Design view:

1. Go to the page where you want to delete a layout component, and open it in Oracle Composer.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. If necessary, open the View menu and select Design.

3. Click the Remove icon on the component header (Figure 18-31), or, if no header is shown, on the component's floating palette.

Figure 18-31 Remove Icon on a Layout Component

4. In the resulting confirmation dialog, click the Delete button.

The layout component is permanently removed from the page. If the layout component had any child components, those child components are deleted as well.

18.3.2 Deleting a Layout Component in Source View

To delete a layout component in Source view:

1. Go to the page where you want to delete a layout component, and open it in Oracle Composer.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. From the View menu, select Source (Figure 18-32).

Figure 18-32 Source Option on View Menu

3. In the list of components, select the component you want to delete.

4. Click the Delete button on the list header (Figure 18-33).

Figure 18-33 Delete Button in Source View

5. In the resulting confirmation dialog, click the Delete button.

The layout component is permanently removed from the page. If the layout component had any child components, those child components are deleted as well.

19 Wiring Pages, Task Flows, Portlets, and UI Components

Often a page needs information from a component on the page, or a region needs information from another region. While you can pass parameters through the page URL to obtain that information, doing so makes sense only when the parameters are well-known and the inputs are accessible to the page through Expression Language (EL). For more information, see Section 19.4, "Passing Parameter Values Through the Page URL."

Consider the case where you have a task flow with multiple page fragments that contain various interesting values that could be used as input on a page in the flow. For example, consider a page devoted to the display of information specific to the company that a user specifies in an input form. If you were to use parameters to pass the value, the task flow must surface output parameters for the union of each of the interesting values on each and every fragment. This is where component wiring becomes useful. Instead, for each fragment that contains the needed information, you can use component wiring to define a contextual event that is raised when the page is submitted. The page or fragment that requires the information can then subscribe to the various events and receive the information through the event.

Oracle Composer provides tools for wiring pages and components through its Page Properties and Component Properties dialogs. This chapter describes the use of these tools in the following sections:

- Section 19.1, "What You Should Know About Parameter and Event Wiring"

- Section 19.2, "Wiring One Component to Another"

- Section 19.3, "Wiring Components and Page Parameters"

- Section 19.4, "Passing Parameter Values Through the Page URL"

Note:

If you navigate away from a page while editing it, unsaved changes are lost.

Audience

This chapter is intended for advanced users who have experience with and knowledge of component wiring. Interested users include those who want to create more complex relationships between a page and its components and between the components themselves.

19.1 What You Should Know About Parameter and Event Wiring

You can use parameters and events to pass values from one component to another, or from a page to a component on that page. Additionally, you can pass values to page components by specifying them in the page's URL.

Note:

In this chapter, component refers collectively to UI components, such as buttons; layout components, such as hyperlinks; task flows; and portlets.

Value passing is useful for synchronizing the content of a page with its components, or the content of one component to another. For example, you can wire a Parameter Form portlet so that the event of clicking its OK button triggers the passing of its user-entered values to another component on the page. One way to apply this model is to pass a user-entered name to a task flow or portlet that displays details relevant to that name.

To clarify what it going on in a parameter passing scenario, it helps to think of one component as the producer and the other component as the consumer. The producer component provides the payload that the consumer component consumes. For example, a form portlet is typically a producer. Its payload is the data that users enter into the form. An event defined on the producer triggers the passing of the producer's payload to the consumer. Consumer components use the payload in various ways. For example, as a display string, a master in a master-detail relationship, and the like. How a consumer component uses the payload is specified in an event handler that was defined when the consumer component was created.

The heavy lifting required to produce meaningful parameter and event wiring is performed mostly at application and component design time. When developers build applications and components, they specify events and event maps in page definition files. Consequently, for runtime wiring to work, the components you want to wire must provide support for wiring through elements that were built-in at design time.

Note:

Runtime refers to the time when users run the application in a real-world environment. Contrast this with design time, which refers to the time developers build the application.

Runtime wiring creates a relationship between a producer event and a consumer event handler. You can create these relationships in Oracle Composer. Select a component and view its events support on the Events tab of the Component Properties dialog (Figure 19-1).

Figure 19-1 Events Tab in the Component Properties Dialog

Once you select and enable an event and an event handler (see the Action section in Figure 19-1), you can define the type of payload to deliver when the event is triggered.

Oracle Composer additionally provides an opportunity to create page parameters on the Parameters tab of the Page Properties dialog (Figure 19-2).

Figure 19-2 Parameters Tab in the Page Properties Dialog

Use the Parameters tab to create new page parameters and to revise existing page parameters. Create parameters that consume value types, including constants, EL expressions, page parameters, and page definition variables

You can easily configure page components to consume page parameters, and you can pass values to those parameters through the page URL.

19.2 Wiring One Component to Another

Components with built-in events and event handlers can be wired to each other to enable the passing of values from a producer component to a consumer component. This section describes how to set up such wiring. It includes the following subsections:

- Section 19.2.1, "Wiring a Task Flow to a Task Flow"

- Section 19.2.2, "Wiring a Portlet to a Portlet"

- Section 19.2.3, "Wiring a Portlet to a Task Flow"

- Section 19.2.4, "Wiring a Task Flow to a Portlet"

- Section 19.2.5, "Wiring a UI Component to a Task Flow"

19.2.1 Wiring a Task Flow to a Task Flow

In addition to seeded services and task flows, you can bring custom task flows into the WebCenter Spaces application. To bring custom task flows into WebCenter Spaces, you must first portletize them, so that they can be consumed by WebCenter Spaces across a portlet bridge.

Note:

When you work with contextual event wiring across a portlet bridge and no payload or a null payload is propagated across the wire from the producer portlet to the consumer, such payloads are delivered as an empty string. If the consumer portlet is required to differentiate between an empty string and null, you can encode the null in the producer portlet payload. The consumer portlet consequently looks for this custom encoding to detect the null payload.

Custom task flows may support events and may include the capability of parameter passing. Events and parameter passing could enable one custom task flow to pass values to other custom task flows on the same page. For example, you could wire custom task flows so that when a user clicks a particular document, an event is raised that triggers parameter passing to the other custom task flows on the page. The passed parameters could cause the other custom task flows to rerender with content relevant to the clicked document.

When a custom task flow is portletized, any portlet events or public render parameters raised by the portletized task flow are automatically delivered to other portletized task flows that declare support for those events or parameters. You can also manually wire portletized custom task flows using Oracle Composer's Component Properties dialog. The events and parameters that you configure vary according to the functionality that developers build into custom task flows. The steps provided in this section describe how to perform this manual mapping.

Creating and portletizing custom task flows and using the portlet bridge are all discussed in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter. For information about consuming custom task flows and other custom components in the WebCenter Spaces application, see Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To manually wire a task flow to a task flow:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Edit icon on the task flow that consumes the payload provided by the producer task flow.

The Component Properties dialog opens.

3. Click the Events tab to bring it forward, and, from the Events pane, select an event associated with the producer task flow.

The Events pane lists all of the events that can be raised from any component on the page. An asterisk (*) on an event indicates that an action is handling it.

4. In the Actions pane, select the action to execute when the event occurs.

The Actions pane lists all of the event handlers associated with the consumer task flow that are supported by the selected producer task flow. Only those actions that can be invoked for the event that is selected in the Events pane are shown. An asterisk (*) on an action indicates that it is handling an event.

5. Select Enable Action to enable the selected event and action.

An asterisk (*) appears next to the selected event and action. Value options appear below the checkbox.

6. From the displayed value options, select the type of value to use to deliver the payload from the producer task flow to the consumer task flow whenever the event occurs.

Choose from:

- Constant—Select Constant, and enter a constant or EL expression value to pass to the consumer task flow.

- EventData—Select to pass the variable ${payLoad}, which delivers whatever payload is specified by the producer task flow.

Note:

The value for ${payLoad} is specified when the task flow is created.

7. Click Save at the top right of Oracle Composer to save your changes.

8. Click Close to exit Oracle Composer.

9. Test your wiring by triggering the event.

19.2.2 Wiring a Portlet to a Portlet

When a portlet is added to a page, it is automatically configured to listen to public render parameters and portlet events generated on the page and respond accordingly. This means that in many cases portlets are automatically wired, as long as the name of the public render parameter or publishing event on the producer side matches that of the public render parameter or processing event on the consumer side, or if an appropriate alias has been created to associate parameters or events.

When portlets have not been designed to explicitly work together, you can manually wire portlets as described in the steps below.

To manually wire a portlet to a portlet:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Edit icon on the portlet that consumes the payload provided by the producer portlet.

The Component Properties dialog opens.

3. Click the Events tab to bring it forward, and select an event associated with the producer portlet.

The Events pane lists all of the events that can be raised from any component on the page. An asterisk (*) on an event indicates that an action is handling it.

4. In the Actions pane, select the action to execute when the event occurs.

The Actions pane lists all of the event handlers associated with the consumer portlet that are supported by the selected producer portlet. Only those actions that can be invoked for the event that is selected in the Events pane are shown. An asterisk (*) on an action indicates that it is handling an event.

5. Select Enable Action to enable the selected event and action.

An asterisk (*) appears next to the selected event and action.

6. Provide values for the portlet parameters that now display at the bottom of the Events tab.

Select Constant, and enter a composite data value, for example:

${payLoad.ora_wsrp_navigparam_Parameter1}

Note:

The parameter names and values were specified when the portlet was created.

7. Click Save at the top right of Oracle Composer to save your changes.

8. Click Close to exit Oracle Composer.

9. Test your wiring by triggering the event.

19.2.3 Wiring a Portlet to a Task Flow

In this scenario, the portlet is the producer, providing the event payload, and the task flow is the consumer of that payload.

To wire a portlet to a task flow:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Edit icon on the task flow that consumes the payload provided by the producer portlet.

The Component Properties dialog opens.

3. Click the Events tab to bring it forward, and select an event associated with the producer portlet from the Events pane.

The Events pane lists all of the events that can be raised from any component on the page. An asterisk (*) on an event indicates that an action is handling it.

4. In the Actions pane, select the action to execute when the event occurs.

The Actions pane lists all of the event handlers associated with the consumer task flow that are supported by the selected producer portlet. Only those actions that can be invoked for the event that is selected in the Events pane are shown. An asterisk (*) on an action indicates that it is handling an event.

5. Select Enable Action to enable the selected event and action.

An asterisk (*) appears next to the selected event and action. Value options appear below the checkbox.

6. Select Constant, and enter a composite data value for a parameter associated with the producer portlet.

For example:

${payLoad.ora_wsrp_navigparam_Parameter1}

7. Click Save at the top right of Oracle Composer to save your changes.

8. Click Close to exit Oracle Composer.

9. Test your wiring by triggering the event.

19.2.4 Wiring a Task Flow to a Portlet

In this scenario, the task flow is the producer, providing the event payload, and the portlet is the consumer of that payload.

To wire a task flow to a portlet:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Edit icon on the portlet that consumes the payload provided by the producer task flow.

The Component Properties dialog opens.

3. Click the Events tab to bring it forward, and select an event associated with the producer task flow in the Events pane.

The Events pane lists all of the events that can be raised from any component on the page. An asterisk (*) on an event indicates that an action is handling it.

4. In the Actions pane, select the action to execute when the event occurs.

The Actions pane lists all of the event handlers associated with the consumer portlet that are supported by the selected producer task flow. Only those actions that can be invoked for the event that is selected in the Events pane are shown. An asterisk (*) on an action indicates that it is handling an event.

5. Select Enable Action to enable the selected event and action.

An asterisk (*) appears next to the selected event and action.

6. Provide values for the portlet parameters that now appear at the bottom of the Events tab.

Select Constant, and enter a composite data value, for example:

${payLoad.ora_wsrp_navigparam_Parameter1}

Note:

The parameter names and values were specified when the portlet was created.

7. Click Save at the top right of Oracle Composer to save your changes.

8. Click Close to exit Oracle Composer.

9. Test your wiring by triggering the event.

19.2.5 Wiring a UI Component to a Task Flow

In this scenario, the UI component is the producer of the payload, and the task flow is the consumer of the payload.

To wire a UI component to a task flow:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Edit icon on the task flow that consumes the payload provided by the producer UI component.

The Component Properties dialog opens.

3. Click the Events tab to bring it forward, and select an event associated with the producer UI component in the Events pane.

The Events pane lists all of the events that can be raised from any component on the page. An asterisk (*) on an event indicates that an action is handling it.

4. In the Actions pane, select the action to execute when the event occurs.

The Actions pane lists all of the event handlers associated with the consumer task flow that are supported by the selected producer UI Component. Only those actions that can be invoked for the event that is selected in the Events pane are shown. An asterisk (*) on an action indicates that it is handling an event.

5. Select Enable Action to enable the selected event and action.

An asterisk (*) appears next to the selected event and action. Value options appear below the checkbox.

6. Select the type of value to use to deliver the payload from the producer UI component to the consumer task flow whenever the event occurs.

Choose from:

- Constant—Select Constant, and enter a constant or EL expression value to pass to the consumer task flow.

- EventData—Select to pass the variable ${payLoad}, which delivers whatever payload is specified by the producer UI component.

Note:

The value for ${payLoad} was specified when the UI component was created.

7. Click Save at the top right of Oracle Composer to save your changes.

8. Click Close to exit Oracle Composer.

9. Test your wiring by triggering the event.

19.3 Wiring Components and Page Parameters

Page parameters and page variables are central to the process of creating enterprise mashups. They enable communication between components and the pages that contain them.

For example, imagine a page that contains stock ticker and stock news components. You want the ticker and the news components to both consume the same parameter value so that they both show information for the same company. Page parameters and page variables are part of a simple mechanism for setting this up.

Page parameters provide a means of storing values for passing to page components that have been configured to consume them. Create page parameters through Oracle Composer at application runtime. Page variables contain output values that are produced by portlets. Page variables are created at application design time.

This section describes how to create and consume page parameters in the following subsections:

- Section 19.3.1, "Creating Page Parameters"

- Section 19.3.2, "Consuming Page Parameters"

19.3.1 Creating Page Parameters

Use the Parameters tab in the Oracle Composer Page Properties dialog to create page parameters.

To create page parameters:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click Page Properties at the top left of Oracle Composer to open the Page Properties dialog (Figure 19-3).

Figure 19-3 Page Properties Dialog

3. Click the Parameters tab to bring it forward, and then click the Add a page parameter link.

The Add a Page Parameter dialog opens (Figure 19-4).

Figure 19-4 Add a Page Parameter Dialog

4. Enter a name for the new parameter, and then click Add Parameter.

The parameter displays on the Parameters tab with a value entry field and an Edit icon for opening the Expressions Editor (Figure 19-5).

Figure 19-5 A New Parameter on the Parameters Tab

5. Open the EL Editor and select from prebuilt values under Choose a value or enter a value manually under Type a value or expression.

For example, enter any of the following types of values:

- Constant—Enter a specific, fixed value.

- Page Parameter—Enter a page parameter to enable the page to take values through its URL.

- EL Expression—Enter an EL expression to enable the page to take a value expressed through Expression Language (EL). For information about EL, see Appendix B, "Expression Language Expressions."

This option can provide a much more dynamic response. For example, the page could set a page parameter based on a component on the page. In this case, you would want the other components on the page to be refreshed whenever this value changed.

6. Click Save at the top right of Oracle Composer to save your changes.

7. As desired, repeat these steps to continue adding page parameters.

8. Click Close to exit Oracle Composer.

19.3.2 Consuming Page Parameters

In addition to wiring components to each other, you can wire them to page parameters. Page parameters are user-constructed name/value pairs for use in passing values to page components, such as task flows, portlets, and UI components.

You can create page parameters and configure task flows and portlets to consume them. This section describes how to wire a task flow with a page parameter.

Note:

Before you can take the steps outlined in this section, you must create a page parameter and provide it with a value. For more information, see Section 19.3.1, "Creating Page Parameters."

To wire a task flow to a page parameter:

1. Navigate to the relevant page, and enter page edit mode.

Tip:

One way to enter page edit mode is to press Ctrl-Shift-E.

2. Click the Edit icon on the task flow to be wired to a page parameter.

The Component Properties dialog opens.

3. Click the Parameters tab to bring it forward.

4. Click the Edit icon next to the property that takes the parameter value.

An editor opens, which you can use to provide the name of the page parameter.

5. Select Choose a value.

6. Under Choose a value, select Page Parameter from the first list, and the name of the relevant page parameter from the second.

7. Click OK to exit the editor.

8. Click OK to save your changes and exit the Component Properties dialog.

The task flow is refreshed, now displaying the result of the value passed through the page parameter.

19.4 Passing Parameter Values Through the Page URL

You can provide Expression Language (EL) expressions in lieu of other types of values to component parameters. This is discussed in Appendix B, "Expression Language Expressions." You can take this capability one step further by passing parameter values with your page URLs.

This section provides one scenario, which you can use as a model for other parameter passing situations.

To pass parameter values through a page URL:

1. Go to the page that contains a component to which you want to pass values through the page URL.

2. Edit the relevant component's properties.

3. Open the EL Editor for the Parameter or Display Option to which you want to pass a value.

4. Under Type a value or expression, enter #{param.val}.

5. Save your changes.

6. To pass a value to the parameter, append the following to your page URL:

?val=value

Where value represents the value you want to pass, for example, true, medium, or Default.

Part VI

Securing Your Portal

Part VI of the User's Guide provides an overview of security in WebCenter Spaces applications and describes how to set up the application roles and permissions that determine user access. It describes how to secure individual pages and page components. And it provides information about enabling users to register themselves with the application.

Part VI includes the following chapters:

- Chapter 20, "Understanding WebCenter Spaces Security"

- Chapter 21, "Managing Users, Roles, and Permissions"

- Chapter 22, "Enabling Self-Registration"

- Chapter 23, "Securing Pages and Components"

20 Understanding WebCenter Spaces Security

This chapter provides information about security in WebCenter Spaces. It contains the following sections:

- Section 20.1, "Introduction to Security in WebCenter Spaces"

- Section 20.2, "Understanding Users"

- Section 20.3, "Understanding Application Roles and Permissions"

- Section 20.4, "Understanding Roles and Permissions within a Space"

- Section 20.5, "Understanding Self-Registration"

Audience

The content of this chapter is intended for WebCenter Spaces administrators and anyone who wants to understand the application's security model. For detailed instructions, see Chapter 21, "Managing Users, Roles, and Permissions".

See also, "Managing Security" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

20.1 Introduction to Security in WebCenter Spaces

WebCenter Spaces provides a comprehensive security model that enables you to control what users can see and change on your portal. You can control which users (and groups) have access to individual Spaces, Space hierarchies, and the Home Space, and you can also control exactly what users and groups can see and do by enabling and disabling various permissions.

With a particular Space you can restrict user and group access to individual WebCenter pages, page content (such as task flows, portlets, documents, and folders), and WebCenter resources (such as page templates, page styles, skins, resource catatlogs, and so on).

Figure 20-1 WebCenter Spaces Security

User and Groups

A user is a single person in the identity store and a group contains multiple users. In WebCenter Spaces you can grant permissions to individual users and to groups of users.

Unregistered Users and Self-Registration

Self-registration allows unregistered users to create their own login and password for WebCenter Spaces. A user who self registers is immediately and automatically granted access to WebCenter Spaces and a new user account is created in the application's identity store.

Application Roles and Space Roles

Application roles determine what a user (or group) can see and do in the Home Space which, for some administrative functions, can impact the entire WebCenter Spaces application. Space roles control actions within a particular Spaces.

Spaces and Space Hierarchies

Spaces support the formation and collaboration of project teams and communities of interest by providing a dedicated and readily accessible area for relevant services, pages, and content and by supporting the inclusion of specified members.

A Space hierarchy consists of a parent Space with one or more Subspaces. Subspaces can inherit the security (members, roles, and permissions) of their parent.

Home Space

The Home Space is a shared Space that, by default, is accessible to everyone who is logged in. Application roles apply while a user is working within the Home Space. In most applications, the Home Space focuses on social networking and personal content.

Resources

Various portal resources help define the overall structure, look and feel, and content in WebCenter Spaces, and these include page templates, page styles, skins, navigation models, resource catalogs, content presenter display templates, mashup styles, data controls, task flows. Users with appropriate privileges can build and customize portal resources for the entire application, a single Space, or a Space hierarchy.

Pages

Anyone authorized to edit a page can grant access and permissions to other users and groups. For example, you might grant view-only permissions to everyone in the sales group, edit permissions to sales managers, and manage permissions to a single user. Alternatively, you can specify that the page inherits its access from the application.

Page Content, Files and Folders

Some pages might contain content that you want only a select set of users, or even only one other user, to see. For example, a page aimed at sales people might include two Announcement task flows; one aimed at all sales people and the other at sales managers only. By restricting access to the second Announcement task flow, you can hide management-level announcements from anyone who is not a sales manager.

20.2 Understanding Users

A WebCenter user has a login account for WebCenter Spaces—provisioned directly from an existing identity store. See also, "Adding Users to the Embedded LDAP Identity Store" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

All users in the identity store are assigned minimal WebCenter Spaces privileges through the Authenticated-User role. The only exception is the Fusion Middleware Administrator (weblogic by default). Out-of-the-box, the Fusion Middleware Administrator is the only user assigned full administrative privileges through the Administrator role. For more information, read the next section Section 20.3.1.1, "Default Application Roles".

It is the Fusion Middleware Administrator's job to assign each WebCenter user an appropriate application role. Alternatively, the Fusion Middleware Administrator may choose to assign the Administrator role to another user and delegate this responsibility.

Table 20-1 Default Administrator in WebCenter Spaces

User

Description

Fusion Middleware Administrator (weblogic)

Administrator for the entire application server, sometimes referred to as the super administrator. This user can manage any application on the server, including WebCenter Spaces.

20.3 Understanding Application Roles and Permissions

Application roles control the level of access a user has to information and services in WebCenter Spaces. Specifically, application roles and their permissions determine what a user can see and do in the Home Space.

This section includes:

Section 20.3.1, "Understanding Application Roles"

Section 20.3.2, "Understanding Application Permissions"

20.3.1 Understanding Application Roles

Application role assignment is the responsibility of the WebCenter Spaces administrator. Administrators can assign users a default application role or create additional, custom roles specific to their WebCenter Spaces application. For more detail, see:

- Section 20.3.1.1, "Default Application Roles"

- Section 20.3.2, "Understanding Application Permissions"

Application roles only apply while a user is working within the Home Space. Within all other Spaces a different set of roles and permissions apply and it is the Space moderator's responsibility to determine suitable role assignments for each of its members. See also Section 52.2, "Managing Roles and Permissions for a Space".

Note:

Application roles and permissions defined within WebCenter Spaces are stored in its policy store and, consequently, apply to this WebCenter Spaces application only. Enterprise roles are different; enterprise roles are stored within the application's identity store and do not imply any permissions within WebCenter Spaces. See "Application Roles and Enterprise Roles" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

20.3.1.1 Default Application Roles

WebCenter Spaces provides several default application roles that cannot be deleted (Table 20-2).

Table 20-2 Default Application Roles for WebCenter Spaces

Application Role

Description

Modify?

Administrator

Users with the Administrator role can set application-wide properties for WebCenter Spaces, create business role pages, configure defaults for discussion forums, mail, and people connection services, register producers and external applications, as well as perform other administrative duties such as editing the login page and the self-registration page.

Administrators can also manage users and roles for WebCenter Spaces, delegate or revoke privileges to/from other users, manage Spaces and Space templates, and also import and export Space information.

Out-of-the-box, the Fusion Middleware Administrator is the only user assigned full WebCenter Spaces administrative privileges through the Administrator role.

Yes*

*Except for Application permissions which are read-only

Authenticated-User

Authenticated users of WebCenter Spaces are granted the Authenticated-User role. Users who login are assigned with this role and, by default, have access to their own Home Space, pages that they create, and public pages. These users can also view public Spaces, create Spaces, and create Space templates.

This role inherits permissions from the Public_User role.

In WebCenter Spaces, the Authenticated-User role is equivalent to authenticated-role—a standard OPSS (Oracle Platform Security Services) role.

Yes

Public-User

Anyone with access to WebCenter Spaces who is not logged in, is granted the Public_User role. Such users are anonymous, unidentified, and can see public content only.

In WebCenter Spaces, the Public-User role is equivalent to anonymous-role—a standard OPSS (Oracle Platform Security Services) role.

Yes

20.3.1.2 Custom Application Roles

Custom application roles (sometimes known as user-defined roles) are specific to your WebCenter Spaces application. When setting up WebCenter Spaces, it is the WebCenter Spaces administrator's job to identify which application roles are required, choose suitable role names, and define the responsibilities of each role.

For example, an education environment might require roles such as Teacher, Student, and Guest. While roles such as Finance, Sales, Human Resources, and Support would be more appropriate for a corporate environment.

In WebCenter Spaces, custom application roles inherit permissions from the Authenticated-User role.

To learn how to set up applications roles for WebCenter users, see Section 21.2.2, "Defining Application Roles"

20.3.2 Understanding Application Permissions

Every application role has specific, defined capabilities known as permissions. These permissions allow individuals to perform specific actions in the Home Space. Permissions are categorized as follows and listed individually in the subsequent tables:

- Application

- Spaces

- Space Templates

- Pages

- Content Presenter Templates

- Data Controls

- Discussions

- Links

- Mashup Styles

- Navigations

- Page Styles

- Page Templates

- People Connections

- Resource Catalogs

- Skins

- Task Flows

No permission, except for Manage All, inherits privileges from other permissions.

Table 20-3 Application Permissions in WebCenter Spaces

Category

Application Permissions

Application

Manage All - Enables access to all WebCenter Spaces Administration pages: Spaces, Pages, Resources, Security, and Configuration. Through these pages, users can manage application security (users/roles), configure application-wide properties and services, manage resources, create business role pages, manage everyone's personal pages, customize system pages, view Spaces accessible to them, as well as export/import Spaces and Space templates.

Some administrative tasks are exclusive to the out-of-the-box Administrator role and cannot be performed by granting the Application-Manage All permission. These tasks include editing the login page, the self-registration page, and profile gallery pages, as well as the ability to manage all Spaces, all Space templates, external applications, and portlet producers.

Manage Configuration - Same as the Application-Manage All permission but excludes security privileges. Users with this permission cannot access the Security page.

View Application - Enables users to view the WebCenter Spaces application, and gives user access to the Home Space. See also, Section 5.12, "Enabling and Disabling Access to the Home Space".

Spaces

Manage All - Enables access to all Space administration pages (General, Roles, Members, Pages, Content, Subspaces, Services, Services, Custom Attributes). Through these pages users can manage Space membership, assign permissions and roles, manage, delete, and export Spaces and resources, set Space properties, and manage service availability.

Manage Configuration - Same as the Spaces-Manage permission but excludes security privileges. Users with this permission cannot access the Roles and Members pages unless they are a Space moderator.

Manage Membership - Users can manage Space membership through Roles and Members pages.

Create Spaces -Users can create Spaces.

Space Templates

Manage All - Enables users to manage and delete any Space templates that is accessible to them.

Create Space Templates - Users can create Space templates.

Pages

Create, Edit, and Delete - Create, edit and delete pages in your Home Space.

Delete - Delete pages in your Home Space.

Edit - Add or edit personal page content, rearrange content, and set page parameters and properties.

Customize - Customize your view of pages in the Home Space by adding, editing, or removing content.

View - View pages in the Home Space.

Create - Create or design a new page for your Home Space view.

These permissions only apply to the Home Space. The permissions do not apply to pages that are created within a Space. Page permissions within a Space are granted on a per Space-basis by the moderator. See Section 52.2, "Managing Roles and Permissions for a Space".

Content Presenter Templates

Create, Edit, and Delete - Create, edit and delete content display templates for the application through WebCenter Administration.

Create - Create content display templates for the application.

Edit - Edit application-level content display templates.

See also, Chapter 40, "Publishing Content Using Content Presenter".

Data Controls

Create, Edit, and Delete - Create, edit and delete data controls for the application through WebCenter Administration.

Create - Create data controls for the application.

Edit - Edit application-level data controls.

See also, Section 26.2, "Creating and Managing Data Controls".

Discussions

Create, Edit, and Delete - Manage categories, forums, and topics on the back-end discussions server. Set discussion forum properties for all Spaces.

See also, Section 20.3.2.2, "Understanding Discussion Server Role Mapping".

Links

Create, and Delete - Create and delete links between objects, and manage link permissions.

Delete - Delete a link between two objects.

Create - Create links between objects, and delete links that you create.

Mashup Styles

Create, Edit, and Delete - Create, edit and delete content display templates for the application through WebCenter Administration.

Create - Create content display templates for the application.

Edit - Edit application-level content display templates.

See also, Chapter 40, "Publishing Content Using Content Presenter".

Navigations

Create, Edit, and Delete - Create, edit and delete navigations for the application through WebCenter Administration.

Create - Create navigations for the application.

Edit - Edit application-level navigations.

See also, Chapter 11, "Working with Navigation".

Page Styles

Create, Edit, and Delete - Create, edit and delete page styles through WebCenter Administration.

Create - Create page styles for the application.

Edit - Edit application-level page styles.

See also, Chapter 15, "Working with Page Styles".

Page Templates

Create, Edit, and Delete - Create, edit and delete page templates through WebCenter Administration.

Create - Create page templates for the application.

Edit - Edit application-level page templates.

See also, Chapter 12, "Working with Page Templates".

People Connections

Manage People Connections -Manage application-wide settings for People Connection services.

Update People Connections Data -Edit content associated with People Connection services.

Connect with People -Share content associated with People Connection services with others.

Resource Catalogs

Create, Edit, and Delete - Create, edit and delete resource catalogs for the application through WebCenter Administration.

Create - Create resource catalogs for the application.

Edit - Edit application-level resource catalogs.

See also, Chapter 16, "Working with Resource Catalogs".

Skins

Create, Edit, and Delete - Create, edit and delete skins through WebCenter Administration.

Create - Create skins for the application.

Edit - Edit application-level skins.

See also, Chapter 14, "Working with Skins".

Task Flows

Create, Edit, and Delete - Create, edit and delete task flows based on a mashup style through WebCenter Administration.

Create - Create task flows for the application.

Edit - Edit application-level task flows.

See also, Section 26.3, "Creating and Managing Task Flows".

20.3.2.1 Understanding the Default Permissions

Table 20-4 shows the default permissions assigned to out-of-the-box application roles.

✔ - Shows an explicitly granted permission or action.

✙ - Shows an implied permission because of an explicitly granted permission.

Table 20-4 Default Application Roles and Permissions in WebCenter Spaces

Default Application Roles

Permissions

Administrator

Authenticated-User

Public-User

Application

Manage All

✔

Manage Configuration

✙

View Application

✙

✔

✔

Spaces

Manage All

✔

Manage Configuration

Manage Membership

Create Spaces

✔

Space Templates

Manage All

✔

Create Space Templates

✔

Pages

Create, Edit, and Delete

✔

Delete

Edit

Customize

View

Create

✔

Content Presenter Templates

Create, Edit and Delete

✔

Create

Edit

Data Controls

Create, Edit and Delete

✔

Create

Edit

Discussions

Create, Edit, and Delete

✔

Links

Create and Delete

✔

Delete

Create

Mashup Styles

Create, Edit and Delete

✔

Create

Edit

Navigations

Create, Edit and Delete

✔

Create

Edit

Page Styles

Create, Edit and Delete

✔

Create

Edit

Page Templates

Create, Edit and Delete

✔

Create

Edit

People Connections

Manage

✔

Update

✔

Connect

✔

Resource Catalogs

Create, Edit and Delete

✔

Create

Edit

Skins

Create, Edit and Delete

✔

Create

Edit

Task Flows

Create, Edit and Delete

✔

Create

Edit

20.3.2.2 Understanding Discussion Server Role Mapping

Some WebCenter services that need access to "remote" (back-end) resources also require role-mapping based authorization, that is, the WebCenter roles that allow users to work with the Discussions service in WebCenter Spaces, must be mapped to corresponding roles on the Oracle WebCenter Discussions Server.

WebCenter Spaces uses application roles to manage user permissions in the Home Space and Space roles to manage user permissions within a Space. On the Oracle WebCenter Discussions server, a different set of roles and permissions apply.

Users who are working with discussions and announcements in WebCenter Spaces automatically map to the appropriate Oracle WebCenter Discussions server role, shown in Table 20-5 and Table 20-6.

Table 20-5 Discussions Server Roles and Permissions - Application

Discussion Server Role

Discussion Server Permissions

WebCenter Spaces

Equivalent Application Permission

Administrator

Category Admin

Discussions-Create, Edit, and Delete

Create, read, update and delete sub categories, forums and topics inside the category for which permissions are granted.

Table 20-6 Discussions Server Roles and Permissions - For a Space

Discussion Server Role

Discussion Server Permissions

WebCenter Spaces

Equivalent Permissions in a Space

Moderator

Category Admin

Forum Admin

- Discussions-Create, Edit, and Delete

Create, read, update and delete forums and topics.

- Announcements-Create, Edit, and Delete

Create, read, update and delete announcements.

Read Forum

Create Message

Create Announcement

- Discussions-Create, and Edit

Create and edit topics.

- Announcements-Create, and Edit

Create and edit announcements.

Read Forum

Create Thread

- Discussions-Reply To

Reply to discussion topics.

Read Forum

- Discussions-View

View forums and topics.

- Announcements-View

View announcements.

Any user assigned the Application-Discussions-Create Edit Delete permission in WebCenter Spaces is automatically added to Oracle WebCenter Discussions and assigned the Administrator role with the Category Admin permission. Out-of-the box, WebCenter Spaces assigns the Application-Discussions-Create Edit Delete permission to the Administrator role only, as shown in Figure 20-2.

Figure 20-2 Application Roles - Default Discussion Permissions

Similarly, in a Space, any member assigned discussion and announcement permissions is granted the corresponding permissions on the Oracle WebCenter Discussions server. Figure 20-3 shows out-of-the box discussion and announcement permissions for the default roles Moderator, Participant, and Viewer.

Figure 20-3 Space Roles - Default Discussion Permissions

20.3.2.3 Understanding Enterprise Group Role Mapping

In WebCenter Spaces you can assign individual users or multiple users in the same enterprise group to WebCenter roles. Subsequent enterprise group updates in the back-end identity store are automatically reflected in WebCenter Spaces. Initially, when you assign an enterprise group to a WebCenter Spaces role, everyone in the enterprise group is granted that role. If someone moves out of the group, the role is revoked. If someone joins the group, they are granted the role

For WebCenter Spaces to properly maintain enterprise group-to-role mappings, back-end servers, such as the discussions server and content server, must support enterprise groups too. When back-end servers do not support enterprise groups, users belonging to enterprise groups are individually added to WebCenter Spaces roles and subsequent group updates in the identity store are not reflected in WebCenter Spaces. This can quickly become a maintenance issue, especially when enterprise groups contain a large number of users. Both versions of Oracle WebCenter Discussion Server and Oracle Universal Content Management provided with Oracle WebCenter Spaces 11.1.1.2.0 and later support enterprise groups but previous versions may not.

20.4 Understanding Roles and Permissions within a Space

When a WebCenter user becomes a member of a Space, a different set of roles and responsibilities apply. For details, see Section 52.2, "Managing Roles and Permissions for a Space".

20.5 Understanding Self-Registration

WebCenter Spaces administrators can enable self-registration for the application. Through self-registration, invited and uninvited users can create their own login and password for WebCenter Spaces. A user who self registers is immediately and automatically granted access to WebCenter Spaces and a new user account is created in the identity store. See also, Chapter 22, "Enabling Self-Registration".

21 Managing Users, Roles, and Permissions

Application roles control the level of access a user has to information and services in WebCenter Spaces. Specifically, application roles and their permissions determine what a user can see and do in their Home Space. This chapter describes how to define and grant application roles to WebCenter users. It contains the following sections:

- Section 21.1, "Managing Users"

- Section 21.2, "Managing Application Roles and Permissions"

- Section 21.3, "Troubleshooting Issues with Users and Roles"

When a WebCenter user becomes a member of a Space, a different set of roles and responsibilities apply. For details, see Section 52, "Managing Space Members and Roles."

Audience

The content of this chapter is intended for WebCenter Spaces administrators with the Application-Manage All permission.

21.1 Managing Users

Administrators must ensure that all WebCenter users have appropriate permissions. To get permissions, users must be assigned to an appropriate application role.

This section tells you how to assign roles and contains the following subsections:

- Section 21.1.1, "What You Need to Know About Managing Users"

- Section 21.1.2, "Assigning Users (and Groups) to Roles"

- Section 21.1.3, "Assigning a User to a Different Role"

- Section 21.1.4, "Giving a User Administrative Privileges"

- Section 21.1.5, "Revoking Application Roles"

- Section 21.1.6, "Adding or Removing Users"

21.1.1 What You Need to Know About Managing Users

From the Users and Groups page (Figure 21-1), administrators can manage application roles for all the users who have access to WebCenter Spaces, that is, all users defined in the identity store. From here, you can change user role assignments, grant administrative privileges, and revoke user permissions.

Only users granted special (nondefault) application privileges appear in this table. Initially, all users in the WebCenter Spaces identity store are assigned minimal privileges through the Authenticated-User role. Users with the default Authenticated-User role are not listed here. See also, Section 20.3.1.1, "Default Application Roles".

Figure 21-1 WebCenter Administration - Users and Groups Page

21.1.2 Assigning Users (and Groups) to Roles

Initially, all users in the WebCenter Spaces identity store are assigned minimal privileges through the Authenticated-User role. You can assign individual users (or multiple users in the same enterprise group) to a different application role through WebCenter Spaces Administration.

Updates in your back-end identity store, such as new users or someone leaving an enterprise group, are automatically reflected in WebCenter Spaces. Initially, when you assign an enterprise group to a WebCenter Spaces role, everyone in the enterprise group is granted that role. If someone moves out of the group, the role is revoked. If someone joins the group, they are granted the role.

Note:

For WebCenter Spaces to properly maintain enterprise group-to-role mappings, back-end servers, such as the discussions server and content server, must support enterprise groups too. When back-end servers do not support enterprise groups, users belonging to enterprise groups are individually added to WebCenter Spaces roles and subsequent group updates in the identity store are not reflected in WebCenter Spaces. This can quickly become a maintenance issue, especially when enterprise groups contain a large number of users. Both versions of Oracle WebCenter Discussion Server and Oracle Universal Content Management provided with Oracle WebCenter Spaces 11.1.1.2.0 and later support enterprise groups but previous versions may not.

To assign a user (or a group of users) to a different application role:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Users and Groups (Figure 21-1).

This page lists WebCenter users to which additional roles are defined.

3. Choose User or Group from the drop down.

Select User to grant permissions to one or more users defined in the identity store. Select Group to grant permissions to groups of users.

4. If you know the exact name of the user or group, enter the name in the box provided, separating multiple names with a comma.

If you are not sure of the name you can search your identity store:

1. Click the Find icon (Figure 21-2).

Figure 21-2 Find Icon

The Find User (or Find Group) dialog box opens (Figure 21-3).

Figure 21-3 Finding Users and Groups in the Identity Store

2. Enter one or more characters that appear in the name you are looking for and then click the Search icon.

Users (or groups) matching your search criteria display in the Select User dialog box. The First Name, Last Name, Mail Address, and CN fields are included in the search.

Tip:

- Use * as a wildcard, for example *sales.

- Leave the search field blank to list all users (or groups) in the identity store.

- Enter a space between two search terms to search First Name and Last Name, for example jo sm, searches for jo in First Name and sm in Last Name.

3. Select one or more names from the list.

To assign roles to multiple users or groups, multi-select all the names required. Ctrl-Click rows to select multiple names.

4. Click OK.

The names that you select are display on the User and Groups tab.

5. To assign a role, select a Role from the drop down (Figure 21-4).

Figure 21-4 Assigning a User Role

Select an appropriate role for the selected users (or groups). Only choose Administrator to assign full, administrative privileges for WebCenter Spaces.

If the role you want is not listed, create a new role that meets your requirements (see Section 21.2.2, "Defining Application Roles").

When no role is selected, the user assumes the Authenticated-User role. See Section 20.3.1.1, "Default Application Roles".

6. Click Grant Access.

User's names and new role assignment display in the table.

21.1.3 Assigning a User to a Different Role

From time to time, a user's role in WebCenter Spaces may change. For example, a user may move out of sales into the finance department and in this instance, the user's role assignment may change from Sales to Finance.

Note:

You cannot modify your own role or the Fusion Middleware Administrator's role. See Section 20.3.1, "Understanding Application Roles".

To assign a user to a different role:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Users and Groups (Figure 21-1).

3. In the Manage Existing Grants table, scroll down to the user you want.

Only users with nondefault role assignments are listed in the table. If the user you want is not listed, grant the role required as described in Section 21.1.2, "Assigning Users (and Groups) to Roles."

4. Click the Actions icon, then choose Change Role from the drop down list.

The Change Role dialog box opens (Figure 21-5).

Figure 21-5 Changing a User's Application Role

5. Select roles as follows:

- Select Administrator to assign full, administrative privileges for WebCenter Spaces.

- Select select one or more roles from the list available.

If the role you want is not listed, create a new role that meets your requirements (see Section 21.2.2, "Defining Application Roles").

At least one role must be selected. To revoke all role assignments, reverting user permissions to the default Authenticated-User role, see Section 21.1.5, "Revoking Application Roles".

6. Click OK.

New role assignments display in the table.

21.1.4 Giving a User Administrative Privileges

It is easy to give a user full, administrative privileges for WebCenter Spaces through the Administrator role. Administrators have the highest privilege level and can view and modify anything in WebCenter Spaces so take care when assigning the Administrator role.

Some administrative tasks are exclusive to the Administrator role and cannot be performed by granting the Application-Manage All permission. These tasks include editing the login page, the self-registration page, and profile gallery pages. See also, Section 20.3.1.1, "Default Application Roles".

To give a user administrative privileges:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Users and Groups (Figure 21-1).

The Role column indicates which users already have full administrative privileges through the Administrator role.

3. Click the Users and Groups tab.

4. In the Manage Existing Grants table, scroll down to the user you want.

Only users with nondefault role assignments are listed in the table. If the user you want is not listed, follow steps in Section 21.1.2, "Assigning Users (and Groups) to Roles" to grant the Administrator role.

5. Click the Actions icon, then choose Change Role from the drop down list.

The Change Role dialog box opens (Figure 21-6).

Figure 21-6 Changing a User's Application Role

6. Select Administrator to assign full, administrative privileges for WebCenter Spaces.

7. Select OK.

The new role assignment displays in the table.

21.1.5 Revoking Application Roles

It is easy to revoke application role assignments that no longer apply. You can revoke roles individually or revoke all application roles assigned to a particular user at once.

Revoking all a user's application roles does not remove that user from the identity store and the user still has access to WebCenter Spaces through the default Authenticated-User role.

Note:

You cannot revoke your own role assignments or the Fusion Middleware Administrator's role. See Section 20.3.1, "Understanding Application Roles".

To revoke application roles:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Users and Groups (Figure 21-1).

This page lists WebCenter users to which additional roles are defined.

3. In the Manage Existing Grants table, scroll down to the user you want.

4. Click the Actions icon:

- Choose Change Role icon to revoke one or more, specific application roles. See also Section 21.1.3, "Assigning a User to a Different Role".

- Choose Delete Role Assignments to revoke all roles assigned to that user, and then click Delete when asked for confirmation.

Access for that user is revoked immediately.

When you delete all the roles assigned to a particular user, the user is no longer listed on the Users page. The user remains in the identity store and still has access to WebCenter Spaces through the Authenticated-User role. See Section 20.3.1.1, "Default Application Roles".

21.1.6 Adding or Removing Users

WebCenter Spaces administrators cannot add new user data directly to the WebCenter Spaces identity store or remove user credentials. Identity store management is the responsibility of the systems administrator and takes place through the WLS Administration Console or directly into embedded LDAP identity stores using LDAP commands. See also, "Adding Users to the Identity Store Using the WLS Administration Console" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

WebCenter Spaces administrators can, however, enable self-registration for the application. Through self-registration, invited and uninvited users can create their own login and password for WebCenter Spaces. A user who self registers is immediately and automatically granted access to WebCenter Spaces and a new user account is created in the identity store. See also, Chapter 22, "Enabling Self-Registration".

21.2 Managing Application Roles and Permissions

WebCenter Spaces uses application roles to manage permissions for users working in their Home Space. This section tells you how to manage application roles, and their permissions from WebCenter Administration pages. It contains the following subsections:

- Section 21.2.1, "What You Need to Know About Application Roles and Permissions"

- Section 21.2.2, "Defining Application Roles"

- Section 21.2.3, "Modifying Application Role Permissions"

- Section 21.2.4, "Granting Permissions to the Public-User"

- Section 21.2.5, "Granting Permissions to the Authenticated-User"

- Section 21.2.6, "Deleting Application Roles"

21.2.1 What You Need to Know About Application Roles and Permissions

From the Roles page (Figure 21-7), administrators can manage application roles and permissions. From here, you can edit the permissions assigned to an application role, create new application roles, or delete unused roles.

Figure 21-7 WebCenter Administration - Roles Page

Application roles apply when a user is working within their Home Space. A different set of roles and permissions apply when a user is working within a particular Space. It is the Space moderator's responsibility to determine suitable role assignments for each of its members. See also, Section 21.2, "Managing Application Roles and Permissions".

WebCenter Spaces provides several default application roles. You cannot delete default application roles but you can modify the default permission assignments for each role. For more information, see Section 20.3, "Understanding Application Roles and Permissions".

21.2.2 Defining Application Roles

Use roles to characterize groups of WebCenter users and determine what they can see and do in their Home Spaces.

When defining application roles, use self-descriptive role names and try to keep the role policy as simple as possible. Choose as few roles as you can, while maintaining an effective policy.

Take care to assign appropriate access rights when assigning permissions for new roles. Do not allow users to perform more actions than are necessary for the role but at the same time, try not to inadvertently restrict them from activities they must perform. In some cases, users might fall into multiple roles.

To define a new application role:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Roles (Figure 21-7).

Current application roles for WebCenter Spaces display as columns in the table.

3. Click Create Role to define a new role for WebCenter users.

Figure 21-8 Creating a New Role

4. Enter a suitable name for the role.

Ensure the role names that are self-descriptive. Make it as obvious as possible which users should belong to which roles. Role names can contain alphanumeric characters, blank spaces, @, and underscores.

5. (Optional) Choose a Template Role.

The new role inherits permissions from the template role. You can modify these permissions in the next step.

Choose Administrator to create a role that inherits full, administrative privileges. Conversely, choose Public-User to create a role that typically provides minimal privileges. Alternatively, choose a custom application role to be your template.

6. Click OK.

The new role appears as a column in the table. The permissions list shows which actions users with this role can perform.

7. To modify user permissions for the role, select or clear each permission checkbox.

8. Click Apply to save any changes that you make to the role's permissions.

21.2.3 Modifying Application Role Permissions

Administrators can modify the permissions associated with application roles at any time. Application permissions are described in Section 20.3.2, "Understanding Application Permissions".

Application role permissions allow individuals to perform specific actions in their Home Space. No permission, except for Manage All, inherits privileges from other permissions.

Note:

Application permissions cannot be modified for the Administrator role. See also Section 20.3.1.1, "Default Application Roles".

To change the permissions assigned to a role:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Roles (Figure 21-7).

Current application roles for WebCenter Spaces display as columns in the table.

3. Select or clear Permissions checkboxes to enable or disable permissions for a role.

4. Click Apply to save.

The new permissions are effective immediately.

21.2.4 Granting Permissions to the Public-User

Anyone who is not logged in to WebCenter Spaces assumes the Public-User role. Out-of-the-box, the Public-User role is granted minimal privileges, that is, the View Application permissions only.

Caution:

Take care when granting permissions to the Public-User role. Avoid granting administrative permissions such as Application-Manage All, Application-Manage Configuration, or any permission that might be considered unnecessary. See also, Section 20.3.2, "Understanding Application Permissions".

Granting the Application-View Permission

The View Application permission allows unauthenticated users to see public WebCenter Spaces application pages, such as the welcome page, and also content that individual WebCenter users choose to make public.

When View Application permissions are granted to the Public-User role:

- Ensure that your WebCenter users understand that any personal page or personal content they choose to make public will become accessible to unauthenticated users outside of the WebCenter Spaces community, that is, anyone with Web access.

- Consider customizing the default welcome page that displays to public users before they login (WebCenter Welcome Page). See Section 7.3.2, "Customizing System Pages".

If you do not want unauthenticated users to see WebCenter Spaces content that is marked 'public', do not grant the View Application permission to the Public-User role. When public access is disabled, public content cannot be seen by unauthenticated users. Also, the welcome page for WebCenter Spaces is not displayed; public users are directed straight to a login page. Administrators may customize the default login page, if required. See Section 7.3, "Working with System Pages".

Granting Other Permissions

Be careful when assigning permissions to the Public-User role. For security reasons, Oracle recommend that you limit what anonymous users can see and do in WebCenter Spaces.

21.2.5 Granting Permissions to the Authenticated-User

Anyone who is logged in to WebCenter Spaces assumes the Authenticated-User role. Out-of-the-box, the Authenticated-User role is granted minimal privileges, through the following permissions: View Application, Spaces-Create, Space Templates-Create, Pages-Create, Update People Connections Data, and Connect with People.

Other important notes:

- The Authenticated-User role always inherits permissions from the Public-User role.

- Custom application roles all inherit permissions from the Authenticated-User role.

21.2.6 Deleting Application Roles

When an application role is no longer required you should remove it from WebCenter Spaces. This helps maintain a valid role list, and prevents inappropriate role assignment.

Application roles are deleted even when users are still assigned to the them. As you cannot delete any default roles, WebCenter users will always have the Authenticated-User role.

Note:

Default roles cannot be deleted (Administrator, Authenticated-User, Public-User). See Section 20.3.1.1, "Default Application Roles".

To delete an application role:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Security, then Roles (Figure 21-7).

Current application roles for WebCenter Spaces display as columns in the table.

3. Select the Delete Role icon next to the role you want to delete (Figure 21-9).

Figure 21-9 Deleting an Application Role

4. Click OK to confirm that you want to delete the role.

The role is removed from the table. Any users assigned to this role only, assume the default Authenticated-User role and do not display on the Users and Groups tab.

21.3 Troubleshooting Issues with Users and Roles

For WebCenter Spaces to properly maintain enterprise group-to-role mappings, the back-end discussions server and content server must support enterprise groups. Oracle WebCenter Discussion Server and Oracle Universal Content Management versions provided with Oracle WebCenter 11.1.1.2.0 and later support enterprise groups but previous versions may not.

If a back-end server does not support enterprise groups, users belonging to enterprise groups are individually added to WebCenter Spaces roles and subsequent group updates in the identity store are not reflected in WebCenter Spaces. This can quickly become a maintenance issue, especially when enterprise groups contain large number of users.

An error message displays if a new back-end server that does not support enterprise groups is enabled in WebCenter Spaces where enterprise group-to-role assignments exist. In this instance, delete all the enterprise group-to-role assignments and reassign roles to individual users instead.

22 Enabling Self-Registration

WebCenter Spaces administrators can enable self-registration for the application. Through self-registration, invited and uninvited users can create their own login and password for WebCenter Spaces. This chapter describes how to enable self-registration. It contains the following sections:

- Section 22.1, "What You Should Know About Self Registration"

- Section 22.2, "Enabling Self-Registration By Invitation-Only"

- Section 22.3, "Enabling Anyone to Self-Register"

Audience

The content of this chapter is intended for WebCenter Spaces administrators with the Application-Manage All permission.

22.1 What You Should Know About Self Registration

Self-registration allows users to create their own login and password for WebCenter Spaces. A user who self registers is immediately and automatically granted access to WebCenter Spaces and a new user account is created in the application's identity store.

If anyone is allowed to self-register, that is any public user, a Register link or button displays below the WebCenter Spaces login form. To enable this feature, see Section 22.3, "Enabling Anyone to Self-Register".

Self-registration by invitation is available too. This feature allows Space moderators to send out membership invitations to people who are not currently registered with WebCenter Spaces but might be interested in their Space. Before accessing the Space, invitees must create an account with WebCenter Spaces and their account details are added to the application's identity store. If approval is required, the moderator must approve their subscription request before gaining access to the Space. If the Space is public or further approval is not required, then new user gains access to the Space immediately he logs in for the first time. See also, Section 22.2, "Enabling Self-Registration By Invitation-Only".

Note:

If self-registration is not enabled in WebCenter Spaces, identity store management takes place through the WLS Administration Console (or directly into embedded LDAP identity stores using LDAP commands) and is the responsibility of your systems administrator. See also, "Adding Users to the Embedded LDAP Identity Store" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

A self-registration page is supplied out-of-the-box. Users with the Administrator role can add new components to the page and change the page layout if required. See, Section 7.3, "Working with System Pages".

The self-registration page provided with WebCenter Spaces offers to send a "user name reminder email" to anyone who tries to register with an email address that has already been used (Figure 22-1).

Figure 22-1 Email Address Already Registered

This feature only works if public credentials are defined for the external application that is providing authentication for the Mail service in WebCenter Spaces. If users experience issues with this feature, ask your Fusion Middleware Administrator to check the mail server connection and its associated external application connection are configured correctly and that public credentials are defined. See also, "Registering Mail Servers" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

22.2 Enabling Self-Registration By Invitation-Only

Out-of-the-box, only existing WebCenter users are candidates for Space membership. While this might meet the needs of most WebCenter Spaces applications it is likely that some Spaces will want to recruit members outside of the WebCenter Spaces community.

The WebCenter Spaces administrator can extend Space membership to users outside of WebCenter Spaces by allowing them to self-register on an invitation-only basis. When this facility is enabled, moderators can invite anyone to join their Space by sending them a customizable invitation by mail. The invitation includes a secure, self-registration URL which the invited party clicks to accept Space membership.

New members recruited in this way must create an account with WebCenter Spaces before gaining access to the Space. Users who self-register by invitation are added to the identity store, and to the Space's member list.

Note:

Users who self-register by invitation will be assigned the default application role too—Authenticated-User. Out-of-the box, users with the Authenticated-User role have access to their own Home Space, pages that they create, and public pages. They are also allowed to view public Spaces, join any Space that allows self-subscription, and create Spaces of their own. When you enable self-registration, consider modifying Authenticated-User permissions to suit your exact requirements. See also, Section 21.2.3, "Modifying Application Role Permissions".

To allow external users to join Spaces:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration, then General.

3. Select Allow Self-Registration Through Invitations (Figure 22-2).

When you deselect this option, only existing WebCenter users are candidates for Space membership.

Figure 22-2 Allowing Self-Registration Through Invitations

4. Click Apply.

Moderators may invite non-WebCenter users to become members of their Space. See "Inviting a Non-WebCenter Spaces User" in Oracle Fusion Middleware User's Guide for Oracle WebCenter Spaces.

22.3 Enabling Anyone to Self-Register

When anyone is allowed to self-register, that is any public user, a Register link or Register button displays on the WebCenter Spaces login page (Figure 22-3).

Figure 22-3 Self-Registration Available on Login Form

New users must create an account before gaining access to the WebCenter Spaces application.

Users who self-register are added directly to the WebCenter Spaces identity store and assigned the Authenticated-User application role. Out-of-the-box, users with Authenticated-User role have access to their own Home Space, pages that they create, and public pages. They are also allowed to view public Spaces, join any Space that allows self-subscription, and create Spaces of their own. If you enable self-registration, consider modifying Authenticated-User permissions to suit your exact requirements. See Section 21.2.3, "Modifying Application Role Permissions".

To allow anyone to self-register with WebCenter Spaces:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Configuration, then General.

3. Select Allow Public Users to Self-Register (Figure 22-4).

When you deselect this option, public users cannot self-register with WebCenter Spaces. You still enable self-registration on an invitation-only basis if you want. See Section 22.2, "Enabling Self-Registration By Invitation-Only".

Figure 22-4 Allowing Self-Registration Through Invitations

4. Click Apply.

See also, Section 29.2, "Registering Yourself with WebCenter Spaces".

23 Securing Pages and Components

You are authorized to specify who can access any page on which you also have edit permission. Among those you authorize to access the page, you can assign varying levels of access, so that some users can edit the page while others can merely view it. If you prefer, you can specify that the page inherits its access settings from the application.

You may want to open a page to many users, but limit the exposure of a particular page component to a specific user, a user group, or to users who are assigned a specific application role. You can accomplish this by associating a security-related EL expression with the component instance.

This chapter provides information about securing pages and page components. It includes the following sections:

- Section 23.1, "Setting Access on a Page"

- Section 23.2, "Setting Access on a Page Component"

Audience

This chapter is intended for Space Moderators and Participants and for page editors with the create, edit, and delete permission on pages and on the services that provide the components to be secured. For more information about application roles and permissions, see Section 21.2, "Managing Application Roles and Permissions."

23.1 Setting Access on a Page

Page properties include a Security tab with controls for specifying who can do what to the current page (Figure 23-1).

Figure 23-1 Security Tab in Page Properties Dialog

In WebCenter Spaces, the options that appear on the Security tab vary according to whether you are accessing it from a Space page or a Home Space page.

Space security provides the additional options of inheriting page access permission settings from the application, enabling page access to public users (that is, users who are not logged in), and enabling page access for all authenticated users (that is, users who are logged in).

This section describes how to set page access through page properties. It is also possible to set page access through the Personalize Pages page. Setting page access through the Personalize Pages page is discussed in Section 38.2, "Controlling User Access to Your Personal Pages."

Note:

Page access permissions set through the Page Properties dialog in Oracle Composer are committed after you click OK on the Security tab. Closing Oracle Composer without saving does not discard such changes.

Page access permissions set through the Personalize Pages page take effect after you click OK in the Set Page Access dialog.

To access the Security tab in the Page Properties dialog:

1. Go to the page you want to secure, and open it in Oracle Composer.

See Also:

To open a page in edit mode, press Ctrl-Shift-E.

2. Click the Page Properties button (Figure 23-2).

Figure 23-2 Page Properties Button in Page Edit Mode

3. In the resulting Page Properties dialog, click the Security tab to bring it forward (Figure 23-3).

Figure 23-3 Security Tab in Page Properties Dialog

4. Space pages only:

- To specify that the page should inherit access settings from the permissions established for the Space, select Use Application Permissions (Figure 23-4), then click OK to save your changes and exit the dialog.

See Also:

For more information about setting global Space permissions, see Section 52.2, "Managing Roles and Permissions for a Space."

Figure 23-4 Security Tab for a Space Page

- To set custom access on the current page, select Use Custom Access Settings.

If you select Use Custom Access Settings, continue with the next steps.

5. To grant page access permissions to all authenticated users, that is, to users who are logged in to WebCenter Spaces, click Add Authenticated Access.

The role authenticated-role is added under Role or User.

6. To grant page access permissions to all public users, that is, users who have not logged in to WebCenter Spaces, click Add Public Access.

The role anonymous-role is added under Role or User.

7. To grant page access permissions to selected users, groups, and application roles, click the Add Access button to open the Add Access dialog (Figure 23-5).

Figure 23-5 The Add Access Dialog

8. In the Search field, enter a search term or the name of the user, group, or role for whom you want to enable access, and click the Search icon.

Tip:

Search terms must contain at least two characters.

9. Select a user, group, or role by clicking in its row.

Note:

When you select a user name, the permissions you set are granted to that specific user. When you select a group or application role, the permissions you set are granted to all users who are members of that group or who are assigned that role.

To make multiple selections:

- Ctrl-Click to select multiple rows.

- Shift-Click to select a range of rows.

10. Click Select.

The Add Access dialog closes, and the Set Page Access dialog populates with the selected users (Figure 23-6).

Figure 23-6 Populated Security Tab in Page Properties Dialog

11. For each user, group, or role, grant access by selecting one or more access privileges from the Page Access columns (Table 23-1).

Table 23-1 Page Access Privileges in the Set Page Access Dialog

Icon

Name

Description

View Page

Users can access the page for viewing, but cannot perform any other actions on the page.

Edit Page

Users can edit the page using Oracle Composer. This includes adding, rearranging, and deleting content; renaming the page; and changing page properties, such as the page scheme.

Delete Page

Users can delete the page.

Perform All Page Actions

Users can perform all actions on the page.

Personalize Page

Users can rearrange page content and personalize his or her view of task flows, provided the task flow includes personalization settings.

Tip:

By default, all authenticated users and user roles that you add to the Set Page Access dialog are granted page view access. The other access privileges require page view access.

12. Click OK to save your changes and close the Set Page Access dialog.

23.2 Setting Access on a Page Component

There may be pages you want to expose to many users that have components you want only a select set of users, or even only one other user, to see. For example, imagine that you have created a Space for all sales people. The Space's home page includes two Announcements task flow instances: one for all sales people and one for sales managers only. You can secure the second Announcements instance so that only those users assigned the custom role sales_manager can see it.

Any component that has an associated Show Component property can be secured in this way. Those components that do not have an associated Show Component property can be placed inside a component that does, and in this way be secured. For example, you can place an Announcements task flow, which does not have an associated Show Component property, inside a Box layout component, which does. You can set the property on the Box, and that setting will also affect the display of Announcements.

See Also:

You can also set security on the custom components that you import through the Resource Manager. For more information, see Section 10.4.4, "Setting Security for a Resource."

To set access on a component instance:

1. Go to the component instance you want to secure and access its Display Options properties.

See Also:

For information about accessing component properties, see Section 17.5.2, "Setting Properties on Page Components."

2. Open the Expression Builder by clicking the Edit icon to the right of the Show Component property and selecting Expression Builder (Figure 23-7).

Figure 23-7 Expression Builder Option Next to Show Component

3. Under Type a Value or Expression, enter one of the following EL expressions:

- To expose a component only to members of a particular scope who are assigned a particular role in that scope, enter:

#{WCSecurityContext.userInScopedRole['role']}

In lieu of role, enter the role name, for example Moderator.

The scope is implicitly resolved to be the current scope. If you use this EL in the Home Space, it resolves to Home Space GUID and roles defined at the application level. If you use this EL in a Space scope, it resolves to roles defined for the Space.

- To expose a component only to members of a group, enter:

#{WCSecurityContext.userInGroup['group_name']}

In lieu of group_name, enter the name of the group, for example Administrators.

- To expose a component only to a specific user, enter:

#{WCSecurityContext.currentUser['user_name']}

In lieu of user_name, enter the user name, for example jdoe.

See Also:

For more information about EL expressions, see Appendix B, "Expression Language Expressions." For information about EL expressions relevant to security, see Section B.3.3, "EL Expressions Relevant to Application Security."

4. Click OK to exit the Expression Builder, and click OK to save your changes and exit the Component Properties dialog.

5. Click Save and then Close to exit Oracle Composer.

The secured component appears only to those users with the name, role, or group you specified.

Part VII

Working with Multilanguage Portals

Part VII of the User's Guide provides information about the languages available with WebCenter Spaces, how to manage that availability, and how to provide translations of user content.

Part VII includes Chapter 24, "Working with Multilanguage Portals."

24 Working with Multilanguage Portals

If your portal will be viewed by users in more than one country, you can configure it to display localized content based on the user's selected language and locale. For example, if you know your page will be viewed in Italy, you can localize your page so that when Italian is selected (in browser, user preferences, Space, or application settings), text strings in the page will appear in Italian.

Additionally, locale selection applies special formatting considerations applicable to the selected locale. For example, whether information is typically viewed from left to right or right to left, how numbers are depicted (such as monetary information), and the like.

This chapter includes the following sections:

- What You Should Know About Languages in WebCenter Spaces

- Configuring Language Options

- Enabling Users to Choose a Language

24.1 What You Should Know About Languages in WebCenter Spaces

There are three main types of information that are displayed in WebCenter Spaces:

- User interface (UI) elements, such as field and button labels and seeded boilerplate text

- User-entered metadata, such as Space and page names

- Content added by users, such as announcements, documents, and discussion forum content

Each type of information is handled differently when it comes to translation:

- UI elements include out-of-the-box translations for 27 languages and 100 different locales. If the default UI text is not suited to your company's needs or if your company needs to support additional languages, your WebCenter Spaces administrator can edit the string files containing this text.

- User-entered metadata can be translated by your WebCenter Spaces administrator the same way that UI elements are translated, by editing the string files.

- Content added by users is generally displayed in the language used by the contributing user, though there is a way that your WebCenter Spaces administrator can display translated content using Content Presenter.

For information on translating information, see Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

24.1.1 Display Language Precedence

The display language controls the language in which translated information is rendered in your browser.

On the Internet, browser settings normally control the display language used for the various web sites a user visits. However, WebCenter Spaces provides additional controls for language selection at the application, Space, and user levels. The order of precedence for WebCenter Spaces display language settings from weakest to strongest is as follows:

- Browser setting—This is the language selected in the user's browser preferences. Browser documentation describes how to change this setting.

- Public cookie—This is the session language a public user—that is, a user who is not logged in to WebCenter Spaces—can select on your portal's Welcome page. A session language is retained for the life of the cookie. If the user clears the browser cookies, the session language is also cleared.

- Application setting—This is the application default language configured by your WebCenter Spaces administrator (for more information, see Section 5.4, "Choosing a Default Display Language").

- User preference setting—This is the language the user selects through the personal Preferences settings (for more information, see Section 35.2, "Choosing Your Preferred Display Language")

- Current scope—This is the language set the Space moderator sets for a given Space (for more information, see Section 51.4.15, "Setting a Space Display Language").

Note:

If the server on which WebCenter Spaces is running does not support the character set of the language preference set in WebCenter Spaces, the output information related to Spaces becomes garbled or displays as question marks.

To work around this issue, users can change the session language or their personal language preference to English. This creates new log file information. The log file is typically located at $WC_DOMAIN/servers/WLS_Spaces/logs.

24.1.2 Languages Supported Out-of-the-Box by WebCenter Spaces

WebCenter Spaces provides runtime translations for 27 languages and 100 different locales.

Table 24-1 Languages Available for Oracle WebCenter Spaces

A to Fi

Fr to No

P to T

Arabic

French

Polish

Brazilian Portuguese

German

Portuguese

Chinese (Simplified)

Greek

Romanian

Chinese (Traditional)

Hebrew

Russian

Czech

Hungarian

Slovak

Danish

Italian

Spanish

Dutch

Japanese

Swedish

English

Korean

Thai

Finnish

Norwegian

Turkish

The list in Table 24-1 includes all the languages available to WebCenter Spaces out-of-the-box. Users can also select locales associated with particular languages. For example, a user can change the language to Arabic and, within that language group, select from 20 different locales, including Algeria, Bahrain, Djibouti, and so on.

Note:

The administrative tier that offers services to WebCenter Spaces, including such tools as Oracle Enterprise Manager, provides a subset of the languages available to WebCenter Spaces. These include:

- English

- Brazilian Portuguese

- Chinese (Simplified)

- Chinese (Traditional)

- French

- German

- Italian

- Japanese

- Korean

- Spanish

The Discussions service uses the Jive application. Out-of-the-box, the Jive application bundled with WebCenter supports English and Spanish. It does not support other languages listed in Table 24-1. However, Jive is open to your own translation files. For more information, see http://www.jivesoftware.com/builds/docs/latest/documentation/developer-guide.html#i18n. This information is explicit to the Jive application user interface.

24.2 Configuring Language Options

This section describes how to configure the language options available in WebCenter Spaces. It includes the following sections:

- WebCenter Spaces administrators can configure the language displayed by default in WebCenter Spaces and the languages available to choose from in the WebCenter Spaces UI. For more information, see Section 5.4, "Choosing a Default Display Language."

- Space moderators can configure the language displayed by default in their specific Spaces and the languages available to choose from in their Spaces UI. For more information, see Section 51.4.15, "Setting a Space Display Language."

- Users can select a language preference that applies whenever they are logged in to WebCenter Spaces. For more information, see Section 35.2, "Choosing Your Preferred Display Language."

24.3 Enabling Users to Choose a Language

This section describes how to enable users to choose a language by adding a Change Language component to a page. It includes the following sections:

- Adding a Change Language Task Flow to a Page

- Setting Change Language Task Flow Properties

24.3.1 Adding a Change Language Task Flow to a Page

You can add the Change Language task flow to any page (in a Home Space, in a Group Space, or a business role page) to allow users to choose the language in which to display the UI.

To add a Change Language task flow to a page:

1. Go to the page where you want to add the task flow, and open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content to open the Resource Catalog.

3. Locate the Change Language task flow in the Resource Catalog.

Note:

This task flow is not available in the default Resource Catalogs provided out-of-the-box with WebCenter Spaces, so you will only see the Change Language task flow if it has been added to the Resource Catalog that has been made available to the page.

For more information, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Web Development, then scroll to Change Language).

4. Click Add next to the Change Language task flow, then Close the Resource Catalog.

5. Click Save, then Close.

24.3.2 Setting Change Language Task Flow Properties

You can customize the languages displayed in the Change Language component. For example, your Spaces application might be available in 27 different languages, but you might only need to display the content in your Space in three or four different languages, so you could filter the languages list to display only those languages. To customize the languages displayed in the Change Language component in your Space, view your Space in Edit mode, then click the Customize button associated with the Change Language component.

The Change Language task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 24-1).

Figure 24-1 Change Language Task Flow - Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Events service task flows and describe the properties on the Parameters tab:

- Section 24.3.2.1, "What You Should Know About the Change Language Task Flow Properties"

- Section 24.3.2.2, "Change Language Task Flow Parameters"

24.3.2.1 What You Should Know About the Change Language Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 24.3.2.2, "Change Language Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

24.3.2.2 Change Language Task Flow Parameters

Table 24-1 describes the parameters that are unique to the Change Language task flow.

Table 24-2 Change Language Task Flow Parameters

Parameter

Description

Display Detailed List

Display a detailed list of languages, including locales.

Default: Not selected

Persist Change to Preferences

Persist the user's language choice to the user's preferences.

Default: Not selected

Scope

The name or GUID of the scope to which you want this language selection to apply.

By default, the language selection is applied to the current scope. This means that a Change Language component placed on a page in the Home Space affects the entire application, and a Change Language component placed in a particular Space affects just that Space.

To limit the language selection to a Space other than the current Space, set this to the intended Space's GUID. For information about obtaining a Space's GUID, see Section 29.9.1, "Accessing Space Information."

Part VIII

Creating and Managing Portlets and Task Flows at Runtime

Part VIII of the User's Guide provides information about creating visualizations, such as forms, tables, and graphs, by gathering and publishing data from various data sources. It describes these tasks in terms of a data composer and seeded portlets.

Part VIII includes the following chapters:

- Chapter 25, "Understanding Portlet Basics"

- Chapter 26, "Creating Business Mashups"

- Chapter 27, "Working with OmniPortlet"

- Chapter 28, "Working with the Web Clipping Portlet"

25 Understanding Portlet Basics

This chapter provides an overview of portlets. It contains the following sections:

- Section 25.1, "What Is a Portlet?"

- Section 25.2, "What Does a Portlet Look Like?"

- Section 25.3, "What Can I Do with Portlets?"

- Section 25.4, "What Kinds of Portlets Can I Use?"

Audience

This chapter is intended for users who want to learn about portlets and how they integrate with Oracle WebCenter.

25.1 What Is a Portlet?

Portlets are reusable web components that can draw content from a variety of different sources. Portlets provide a means of presenting data from multiple sources in a meaningful and related way. Portlets can display excerpts of other web sites, generate summaries of key information, perform searches, and access assembled collections of information from a variety of data sources. Because different portlets can be placed on a common page, you receive a single-source experience, though the content may be derived from multiple sources.

25.2 What Does a Portlet Look Like?

Figure 25-1 shows the sample Lottery portlet on a page in a WebCenter application. Note that the same portlet displayed in a different application could look different, depending on how the portlet styles are defined.

Figure 25-1 The Sample Lottery Portlet

The following list describes some of the elements you might see in a portlet, depending on the application consuming the portlet:

- Portlet chrome. The collection of visual elements that surround the portlet, including the header, border, resize handle, and icons.

- Portlet header. The area of the portlet that displays the portlet title and the icons that enable interaction with the portlet. The user who added the portlet to the page may have chosen to not display the portlet header.

- Portlet title. Text in the portlet header that indicates the purpose of the portlet. You may be able to personalize this title to make it more meaningful for your particular usage.

- Minimize/Expand icon. An icon in the portlet header. Clicking the Minimize icon causes the portlet content to collapse so that only the portlet header is displayed. This saves space on the page and reduces clutter without permanently removing the portlet from the page. When the portlet is minimized, the icon becomes an Expand icon that you can click to display the content again.

- Personalize icon. An icon in the portlet header. Clicking the Personalize icon enables users to personalize the portlet (that is, make changes that only that user can see).

- Customize icon. An icon in the portlet header. Clicking the Customize icon enables users to customize the portlet (that is, make changes that are visible to everyone).

- Actions icon. An icon in the portlet header. Clicking the Actions icon displays the Actions menu.

- Actions menu. Lists the various other actions that you can perform on the portlet. The actions depend on whether you are logged in, your privileges, the logic of the portlet, and the specifics of how the portlet was placed on the page. Actions include Maximize, Restore, Refresh, and Move Up or Down. If the portlet provides modes such as Help and About, these are also listed in the Actions menu.

If the user who added the portlet to the page chose to not display a portlet header, the Actions menu is displayed on a fade in/fade out toolbar that displays on mouse rollover.

- Resize handle. Enables you to make the portlet bigger or smaller.

- Portlet content. The actual content of the portlet as determined by the portlet developer.

The appearance of a portlet is determined by the internal logic of the portlet itself, as written by the portlet developer, the attributes specified by the user who added the portlet to the page, and any of your own personalizations. For example, the portlet developer can determine, during portlet creation, whether users can personalize the portlet at runtime. The user who adds the portlet to a page can decide whether the personalize option is displayed in the Actions menu. The user at runtime can minimize the portlet so that the content is not even displayed on the page.

25.3 What Can I Do with Portlets?

If your application includes portlets, and you are logged in, you can edit those portlets to make them display the information that you, personally, want to see (this is known as personalization). To personalize a portlet, click the Personalize icon in the portlet header. The personalizations you can make depend on how the portlet developer designed the portlet. You can also hide portlets, or remove them entirely from the page. Note that the changes that you make apply only to you. If you delete a portlet, other users can still see it when they view the page (unless they have deleted it themselves).

If you have the appropriate privileges, you can also edit the way the portlet appears to all users (this is known as customization). To customize a portlet, click the Customize icon in the portlet header. The changes you make are visible to all users.

If you have the appropriate privileges to edit a page in a WebCenter application, you can add portlets to that page.

See Also:

For more information, see Section 17.5, "Adding Resource Catalog Components to Pages."

The portlets you can add depend on the portlet producers that have been registered with the application. A portlet producer is the object that owns the portlet and makes it available to an application. If you want to add a particular portlet to a page, but cannot find it in the Resource Catalog, this could mean that the associated producer is not registered with your application. If you have the appropriate privileges, you can register portlet producers yourself through WebCenter Administration.

See Also:

For more information, see Section 6.5, "Registering Portlet Producers."

If you do not have the privileges to register portlet producers, you must ask your WebCenter application administrator to register the producer for you.

Note:

In WebCenter Spaces, avoid adding a portlet to a Movable Box layout component. The Movable Box layout component duplicates the showDetailFrame that the portlet provides by default. There are no additional benefits to including a portlet in a Movable Box.

25.4 What Kinds of Portlets Can I Use?

There are several different kinds of portlets available to you. Portlets fall into the following categories: prebuilt portlets provided by Oracle and third-party sources; portlets built for you by your own developers; and portlets that you can build yourself. However, you can only use portlets that the WebCenter application administrator has registered with the application. When it comes to adding portlets to a page, a portlet's category and how it was created are irrelevant; all portlets are listed in the Resource Catalog and are available for inclusion.

This section includes the following subsections:

- Section 25.4.1, "Prebuilt Portlets"

- Section 25.4.2, "JSF Portlets"

- Section 25.4.3, "Programmatic Portlets"

- Section 25.4.4, "Web Clipping"

- Section 25.4.5, "OmniPortlet"

- Section 25.4.6, "Parameter Form and Parameter Display Portlets"

25.4.1 Prebuilt Portlets

Prebuilt portlets include partner portlets and integration solutions.

Partner portlets are available through Oracle's partnerships with leading system integrators, software vendors, and content providers. You can access these portlets by using the keywords portal or portlet when searching the Oracle PartnerNetwork (OPN) Solutions Catalog, available at:

http://solutions.oracle.com

Examples of these include portlets for the following purposes:

- Generating point-to-point driving directions

- Accessing Information Technology (IT) information from a wide variety of sources

- Viewing summary information about news, stocks, and weather

If you think a particular portlet would be useful for your application, ask your WebCenter application administrator to register the appropriate producer for you.

25.4.2 JSF Portlets

JSF portlets expose existing JSF applications and task flows as JSR 286 portlets. They are created using the Oracle JSF Portlet Bridge. The Oracle JSF Portlet Bridge simplifies the integration of JSF applications with WSRP portlet consumers, such as Oracle Portal. Developers create JSF portlets in Oracle JDeveloper using the JSR 286 Java Portlet Wizard or the Portlet Bridge design-time wizard for pages and task flows.

JSF portlets do not require separate source code from that of the JSF application. Since these portlets are created using the Oracle JSF Portlet Bridge, developers need only to maintain one source for both the application and the portlets. Similarly, when the JSF application is deployed, JSF portlets are also deployed with it. Therefore, using the bridge eliminates having to store, maintain, and deploy portlets separately from the application.

25.4.3 Programmatic Portlets

Programmatic portlets are portlets that have been written specifically for your organization to meet a particular requirement not met by the out-of-the-box portlets. Oracle WebCenter Framework provides two declarative wizards for simplifying the creation of standards-based JSR 286 portlets and Oracle PDK-Java portlets. These wizards assist in the construction of the framework within which developers create the portlet.

Some examples of programmatic portlets might be:

- Photo album portlet. A portlet that facilitates uploading, storing, and viewing user photos.

- Shopping cart portlet. A portlet that facilitates the viewing and purchasing of, for example, company-branded items, such as mouse pads, pens, flash drives, tee shirts, and so on.

Programmatic portlets are written by experienced Java developers who are familiar with the Java Portlet Specification or Oracle PDK-Java.

See Also:

For more information about programmatic portlets, see the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

25.4.4 Web Clipping

Web Clipping is a publishing portlet that enables you to integrate any web application with your WebCenter application. It is designed to give you quick integration by leveraging the existing user interface of a web application. With Web Clipping, you can collect web content into portlets in a single centralized web page. You can use Web Clipping to consolidate content from web sites scattered throughout a large organization.

To create a Web Clipping portlet, use a web browser to navigate to a web page that contains the desired content. Through the Web Clipping Studio, you can drill down through a visual rendering of the target page to choose the desired content.

Web Clipping supports the following:

- Navigation through various styles of login mechanisms, including form- and JavaScript-based submission and HTTP Basic and Digest Authentication with cookie-based session management.

- Fuzzy matching of clippings. If a web clipping gets reordered within the source page or if its character font, size, or style changes, it can still be identified correctly by the Web Clipping engine and delivered as the portlet content.

- Reuse of a wide range of web content, including basic support of pages written with HTML 4.0.1, JavaScript, applets, and plug-in enabled content, retrieved through HTTP GET and POST (form submission).

- Personalization, allowing you to expose input parameters that you can then modify when you personalize the portlet. You can expose these parameters as public parameters that you can map as page parameters. This feature enables you to obtain personalized clippings.

- Integrated authenticated web content through Single Sign-On, including integration with external applications, which enables you to leverage Oracle Single Sign-On and to clip content from authenticated external web sites.

- Inline rendering, enabling you to set up Web Clipping portlets to display links within the context of the portlet. As a result, when you click a link in the Web Clipping product, the results display within the same portlet. You can use this feature with internal and external web sites.

- Proxy Authentication, including support for global proxy authentication and authentication for each other. You can specify the realm of the proxy server and whether all users automatically log in using a user name and password you provide, each user logs in using an individual user name and password, or all users log in using a specified user name and password.

- Resource Tunneling of images.

- Open Transport API for customizing authentication mechanisms to clipped sites.

Some examples of how you might use Web Clipping are:

- Stock chart portlet. Create a portlet that displays the stock market's daily performance chart from your financial advisor's web site. You can clip this information from an external web site, even if your company is using a proxy.

- Web mail portlet. Access your confidential web mail account through a portlet and to display your in-boxes in the portlet.

See Also:

For more information about using Web Clipping, see Chapter 28, "Working with the Web Clipping Portlet."

25.4.5 OmniPortlet

OmniPortlet is a data publishing portlet that you add to your application at design time, so that users can customize at runtime. Using a wizard, page designers can publish data from a variety of data sources (including SQL, XML, web services, spreadsheets, and web pages) to several different layouts, such as customizable charts and tables.

Like Web Clipping, OmniPortlet supports proxy authentication, including support for global proxy authentication and authentication for each user. You can specify whether all users automatically log in using a user name and password you provide, each user logs in using an individual user name and password, or all users log in using a specified user name and password.

Some examples of how you might use OmniPortlet are:

- RSS news feed portlet. Create a portlet that displays live, scrolling news information to your users from a Really Simple Syndication (RSS) news feed, such as Oracle Technology Network Headlines. You can also include hyperlinks to the news source.

- Sales chart portlet. Present up-to-date information about your company's sales results. You can choose to display the data as a pie chart and store the sales information in a remote relational database for later use.

See Also:

For more information about OmniPortlet, see Chapter 27, "Working with OmniPortlet."

25.4.6 Parameter Form and Parameter Display Portlets

The Parameter Form and Parameter Display portlets provide a quick and easy way to pass values between components. They are provided by the WSRP Tools producer.

The Parameter Form portlet has three output parameters that are set when values are submitted in the form inside the portlet. The parameters can then be used to drive the content of other portlets. You can customize the Parameter Form portlet to determine how many of the three fields are displayed on the form, depending on how many parameters you require.

The Parameter Display portlet enables you to quickly test the wiring from the Parameter Form portlet. However, typically you use the values passed from the Parameter Form portlet to drive the content of some other portlet, for example, to pass a ZIP code to a weather portlet, or a stock symbol to a stock ticker portlet.

Figure 25-2 shows a Parameter Form portlet that has been customized to accept a single value (ZIP code). When a user enters a ZIP code and clicks OK, the Parameter Display portlet refreshes to display the same ZIP code.

Figure 25-2 Parameter Form and Display Portlets

See Also:

For more information about linking portlets, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

26 Creating Business Mashups

Business mashups are reusable components that you can create or edit at runtime. A mashup can be an ensemble of multiple UI widgets that interact with each other. Each component in a business mashup could be working against a different data source such as SQL, Web Services, or XML. A mashup can display data retrieved from a data source as a graph or table, or write to a data source using a form.

Oracle WebCenter provides a powerful way for developers, administrators, and power users to create mashups in the running portal or social and collaborative application without bringing the system to a halt. A fully-integrated data publisher enables you to perform the following tasks:

- Create data controls to retrieve information from different data sources.

- Create mashups by consuming data controls in task flows or application pages.

- Provide users the flexibility to customize their view of a mashup.

This chapter explains how to perform these tasks. It includes the following sections:

- Section 26.1, "Introducing Business Mashups"

- Section 26.2, "Creating and Managing Data Controls"

- Section 26.3, "Creating and Managing Task Flows"

- Section 26.4, "Creating Data Visualizations"

- Section 26.5, "Business Mashup Examples"

Audience

This chapter is intended for users who want to provide and manage Resource Catalogs in their WebCenter Spaces application. Portal designers with the application permission Application-Resource Catalogs-Create Edit Delete can manage application-level Resource Catalogs. Space moderators with the permission Space-Resources-Create Edit Delete (simple permission model) or Space-Resource Catalogs-Create Edit Delete (detailed permission model) can manage Space-level Resource Catalogs. For information about roles and permissions, see Chapter 20, "Understanding WebCenter Spaces Security."

26.1 Introducing Business Mashups

Business mashups are visualizations created by gathering data from various data sources and publishing the gathered data using different layouts such as forms, tables, and graphs. The Resource Manager (Resources page), shown in Figure 26-1, provides the following options to create business mashups:

- Data Controls: Opens the Data Controls page to create and manage SQL and Web Services data controls.

- Task Flows: Opens the Task Flows page to create and manage task flows that can be consumed in application pages. You may want to create task flows to consume data controls and wire parameters so that users can control the data displayed in their view of the data controls.

- Mashup Styles: Opens the Mashup Styles page to manage the templates available for creating task flows.

Figure 26-1 Mashups Section in the Resource Manager

You can create data controls, task flows, and mashup styles at the application level and Space level. While application-level resources are also available for consumption in Spaces, Space-level resources are available only to the Space in which they were created. You cannot modify or delete application-level resources from within a Space.

Note:

If you consume application-level data controls inside a Space and want to export that Space to another WebCenter Spaces instance, you must perform all the necessary checks to ensure that the data control works properly. For more information, see Section 26.2.5.1, "Steps You Must Perform After an Import."

This section includes the following subsections:

- Section 26.1.1, "Supported Data Controls"

- Section 26.1.2, "Supported Visualizations"

26.1.1 Supported Data Controls

WebCenter applications support the creation of data controls that can be used to view data from a data source and filter the data using parameters, enter data into a data source (provided the data source supports it), and drive the data in one component from the data in another component.

The advantage of creating data controls at runtime is that you can get data from different data sources and create visualizations or mashups without having to redeploy and restart your application. What's more, you can modify visualizations at any point of time and control what is retrieved from the data source and rendered. You can also write to the data sources using forms within business mashups.

The type of data control to use depends on where the data is stored and how it is exposed. For example, use a Web Service data control to call a Web Service for data. The process of collecting data is different for each data source. The Resource Manager - Data Controls page in your application or Space provides options to create SQL and Web Service data controls. The following sections provide a brief description of these data control types:

26.1.1.1 SQL Data Controls

Used to collect data from relational databases. To create a SQL data control, you must have a data source connection from the application server to the database. You can retrieve data by specifying a SQL query. To limit the data retrieved to specific criteria, you can specify bind parameters as part of the SQL query. You can add as many bind parameters as required.

Data controls created at runtime can be used only to query the database, you cannot update the retrieved data. However, design time data controls that were created with read-write capabilities allow the retrieved data to be updated.

Bind parameters provide the following benefits:

- They enable reuse of a data control. A data control with one or more bind variables can be used many times in different visualizations, each instance displaying different data.

- They enable end users to control the data displayed in the data control. Data controls that you create are eventually consumed in pages or task flows and viewed by end users. You can include the data control in a task flow and wire its parameters to task flow parameters so that the task flow parameter drives the data in the data control. For more information, see Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

Another way to control the data displayed is by wiring a data control parameter to an input text component on the task flow. You can achieve this type of wiring easily by using a parameter form task flow. For more information, see Section C.2.4, "Adding the Data Control in a Parameter Form Task Flow."

- If a database has imposed an IO limit, and the query happens to traverse large number of records that exceed the IO limit, then adding such a data control to a page or task flow may result in an error and failure to render. You can limit the data retrieved from a database to specific criteria by specifying bind parameters in your query.

For the steps to create a SQL data control, see Section 26.2.1, "Creating a SQL Data Control."

26.1.1.2 Web Service Data Controls

Used to collect data from a business service that can be accessed over the Internet using standard protocols, such as SOAP and HTTP. To collect data from a Web Service, you must know the path to the Web Service Description Language (WSDL) file. The WSDL file describes the Web Service and specifies the methods that can be called, including the expected parameters. It also describes the returned data.

Based on the permissions you have on a Web Service data source, you can only specify values for parameters exposed by its methods; you cannot add or delete parameters. You can specify values for the following types of parameters:

- Scalar parameters: These are simple parameters for which you can directly specify string or EL values to display data.

- Complex parameters: These are derived parameters that take objects as parameters. They may also get their value from scalar parameters exposed by the method. Complex parameters are available in XML format.

See Section C.5, "Creating a Mashup with Data from a Siebel Data Source" for an example of how you can use complex parameters.

Note:

You cannot pass values to complex parameters that are recursive, that is, if A includes B and B in turn references A.

- Array parameters: These parameters enable you to pass mulitple values at a time, thereby updating multiple records in the data source simultaneously. See Section C.5, "Creating a Mashup with Data from a Siebel Data Source" for an example of how you can use array parameters.

Apart from querying the data source, for data sources that allow updating, Web Service data controls also provide an option to update records.

For more information, see Section 26.2.2, "Creating a Web Service Data Control."

26.1.2 Supported Visualizations

The data gathered using SQL and Web Service data controls can be rendered on a page or task flow in different ways. While editing a page or task flow, when you click Add against a data control's accessor, method, or parameter in the Resource Catalog, the Add menu displays different drop handlers. The drop handlers enable you to add a data control's objects as UI elements such as tables, graphs, forms, buttons, or labels. Depending on the type of object and the flavors supported, you can add the following types of UI elements:

26.1.2.1 Table

This option is displayed when you select a data control accessor that returns a collection of objects that can be displayed in columns of a table. Select this option to display data in a tabular layout. When you add a data control inside a task flow, you can wire data control parameters to task flow parameters so that the table displays data based on a parameter value that you specify. You can add an editable table, or a read-only table that displays data based on your specification, but cannot be edited.

For more information, see Section 26.4.1.1, "Adding a Data Control as a Table."

26.1.2.2 Form

This option is displayed when you select a data control accessor that returns a collection of objects that can be displayed in a form. Select this option to display source data in a form. When you add a data control inside a task flow, you can wire data control parameters to task flow parameters so that the form displays data based on a parameter value that you specify. You can add an editable form, or a read-only form that displays data based on your specification, but cannot be edited. However, using an editable form makes sense only if the data source supports writing back to it.

For more information, see Section 26.4.1.2, "Adding a Data Control as a Form."

26.1.2.3 Graph

This option is displayed when you select a data control accessor that returns a collection of objects that can be displayed in a graph. This is useful for the purpose of analysis, when you want to generate a report. Graphs cannot be edited. Select this option to display your data graphically, as a bar, pie, line, or an area chart. When you add a data control inside a task flow, you can wire data control parameters to task flow parameters so that the graph displays data based on a parameter value that you specify.

For more information, see Section 26.4.1.3, "Adding a Data Control as a Graph."

26.1.2.4 Button or Link

The ADF Button, ADF Link, ADF Image Link, and ADF Toolbar Button options are displayed when you select a data control's methods or operations that perform an action. Select any of the button or link options while adding methods or operations such as Create, Update, Delete, Commit, Rollback, Save, or Close. Different options are available for different data controls depending on the methods exposed by the data source. For more information, see Section 26.4.7, "Writing to a Data Source from a Visualization."

26.1.2.5 Text or Label

The ADF Output Text, ADF Output Text w/ Label, ADF Output Formatted, ADF Output Formatted w/ Label, ADF Input Text, ADF Input Text w/ Label, and ADF Label options are displayed when you select a data control's attributes or methods that return a single object. An attribute can be a scalar parameter of an accessor, a method return, or an object member of a complex parameter. Select a text or label option depending on whether you want to display the value to users or want users to specify a value. When you add a data control inside a task flow, you can wire data control parameters to task flow parameters so that the task flow displays data based on a parameter value that you specify. You can even add an input text component and wire it to a data control parameter. For more information about this type of wiring, see Section 26.4.4, "Wiring a Data Control to a Parameter Form Task Flow."

26.2 Creating and Managing Data Controls

This section describes how to create SQL and Web Service data controls. It includes the following sections:

- Section 26.2.1, "Creating a SQL Data Control"

- Section 26.2.2, "Creating a Web Service Data Control"

- Section 26.2.3, "Managing Data Controls"

- Section 26.2.4, "Using Design-Time Data Controls"

- Section 26.2.5, "Exporting and Importing Data Controls Across Spaces"

26.2.1 Creating a SQL Data Control

SQL data controls enable you to retrieve data from a relational database using a SQL query. Therefore, before creating the data control, you must have a database connection. This section describes the steps to create a database connection and a SQL data control.

26.2.1.1 Creating a Database Connection

This section describes the procedure to create a database connection from the Oracle WebLogic Server Administration Console.

Note:

Using a DB2 or SQL Server Database Connection:

The default SQL style for all database connections is "Oracle". If you create a database connection to an IBM DB2 or Microsoft SQL Server database, then you must manually override the SQL style with one that supports the DB2 or SQL Server database. For this, you must specify jbo.SQLBuilder as a system property with the value DB2 or SQLServer. Specify the system property as a Java command line option in either of the following ways:

- Open the DomainHome/bin/setDomainEnv.sh file and add -Djbo.SQLBuilder=DB2 to the JAVA_OPTIONS line.

- Edit the managed server start script in a text editor and add -Djbo.SQLBuilder=DB2 to the JAVA_OPTIONS line.

For more information, see "Specifying Java Options for a WebLogic Server Instance" in Oracle Fusion Middleware Managing Server Startup and Shutdown for Oracle WebLogic Server.

To create a database connection:

1. In the Domain Configuration section, under Services, select Data Sources.

2. On the Summary of Data Sources page, click New and select Generic Data Source.

3. On the JDBC Data Sources Properties page, enter or select the following information:

- Name - Enter a name for this JDBC data source.

- JNDI Name - Enter the JNDI path to where this JDBC data source will be bound. Applications look up the data source on the JNDI tree by this name when reserving a connection.

- Database Type - Select the DBMS of the database that you want to connect to. If your DBMS is not listed, select Other.

4. Click Next to continue.

5. Select the JDBC driver you want to use to connect to the database. The list includes common JDBC drivers for the selected DBMS.

- Note:

You must install JDBC drivers before you can use them to create database connections. Some JDBC drivers are installed with WebLogic Server, but many are not installed.
For more information, see "Using JDBC Drivers with Weblogic Server" in Oracle Fusion Middleware Configuring and Managing JDBC Data Sources for Oracle WebLogic Server.

6. On the Transaction Options page, follow these steps. Depending on the driver you selected on the JDBC Data Source Properties page, you may not need to specify any of these options.

- Supports Global Transactions - Select this checkbox (the default) to enable global transaction support in this data source. Clear this checkbox to disable (ignore) global transactions in this data source. In most cases, you should leave the option selected.

If you selected Supports Global Transactions, select an option for transaction processing: (available options vary depending on whether you select an XA driver or a non-XA driver)

- Two-Phase Commit - Select this option to enable standard XA processing.

This option is only available when you select an XA JDBC driver to make database connections.

- Logging Last Resource - Select this option to enable a non-XA JDBC connection to participate in global transactions using the Logging Last Resource (LLR) transaction optimization. Recommended in place of Emulate Two-Phase Commit.

This option is only available when you select a non-XA JDBC driver to make database connections.

- Emulate Two-Phase Commit - Enables a non-XA JDBC connection to emulate participation in distributed transactions using JTA. Select this option only if your application can tolerate heuristic conditions.

This option is only available when you select a non-XA JDBC driver to make database connections.

- One-Phase Commit - Select this option to enable the non-XA connection to participate in a global transaction as the only transaction participant.

This option is only available when you select a non-XA JDBC driver to make database connections.

7. Click Next to continue.

8. On the Connection Properties page, enter values for the following properties:

- Database Name - Enter the name of the database that you want to connect to. Exact database name requirements vary by JDBC driver and by DBMS.

- Host Name - Enter the DNS name or IP address of the server that hosts the database. If you are creating an Oracle GridLink service-instance connection, this must be the same for each data source in a given multi data source.

- Port - Enter the port on which the database server listens for connections requests.

- Database User Name - Enter the database user account name that you want to use for each connection in the data source.

- Password/Confirm Password - Enter the password for the database user account.

9. Click Next to continue.

10. On the Test Database Connection page, review the connection parameters and click Test Configuration.

WebLogic attempts to create a connection from the Administration Server to the database. Results from the connection test are displayed at the top of the page. If the test is unsuccessful, you should correct any configuration errors and retry the test.

If the JDBC driver you selected is not installed on the Administration Server, you should click Next to skip this step.

11. Click Next to continue.

12. On the Select Targets page, select the server on which you want to deploy the data source. Select WC_SPACES to deploy the data source to your WebCenter Spaces instance.

13. Click Finish to save the JDBC data source configuration and deploy the data source to the target that you selected.

See Also:

Oracle Fusion Middleware Configuring and Managing JDBC Data Sources for Oracle WebLogic Server for information about JDBC data sources.

26.2.1.2 Creating the Data Control

To create a SQL data control:

1. On the Resources page, under Mashups, select Data Controls, and on the resulting Data Controls page, click Create.

2. In the Create new Data Control dialog, select SQL in the left pane (Figure 26-2).

3. In the Name and Description fields at the bottom of the dialog, enter a name and description for the data control.

4. In the Database Connection section, from the dropdown list, select the database connection that you will use for this SQL data control. For more information, see Section 26.2.1.1, "Creating a Database Connection."

Figure 26-2 New SQL Data Control Wizard

5. In the password field, specify the connection password.

This field is used to ensure that only users who know the password to connect to the data source can create a data control. You must specify the password every time you create or edit a data control.

6. In the SQL Statement text box, enter a SQL query, for example:

SELECT * FROM Persons WHERE City LIKE 'sa%'

Specify any bind parameters as part of the query. Bind parameters are useful in controlling the data displayed in the data control. Consider the following example:

select ename, empno, mgr, deptno from emp where job in (:job) order by empno asc

This query returns details of all employees with a particular designation, for example, sales managers. In this query :job defines the parameter job, which maps to the job column in the emp database table. The query returns data based on the job value (how you specify this is explained in the next step). You can add as many parameters as required. You can also use the same parameter multiple times in a statement.

Note:

You may encounter an error if the query contains a column with the NCHAR data type. As a workaround, you can use the to_char(NCHAR_COLUMN NAME) function.

7. If you added bind variables in your SQL query, for example, job, then click Enter bind parameter values to define initial values for those variables.

8. In the Enter bind parameter values dialog, shown in Figure 26-3, specify values for the parameters. The dialog lists all parameters that you defined as part of your SQL query.

Figure 26-3 The Dialog for Setting Bind Parameter Values

9. Click OK.

10. Click Test to test the query you entered.

If you added bind parameters, but did not specify initial values for the parameters, you will see a validation exception.

If the query is correct, you will see a table displaying the data retrieved from the data source. The table displays up to a maximum of 25 rows.

11. Click OK to return to the Create new Data Control dialog.

12. Click OK.

The new data control is listed on the Resources - Data Controls page. However, the data control is hidden by default. You can consume it in pages or task flows only if it is made available to the application. For more information, see Section 26.2.3.1, "Showing or Hiding a Data Control in the Resource Catalog."

You can now add this data control to a page or task flow. For more information, see Section 26.4.1, "Consuming a Data Control in a Task Flow."

26.2.2 Creating a Web Service Data Control

This section describes the steps to create the Web Service data control.

26.2.2.1 Creating the Data Control

To create a Web Service data control:

1. On the Resources page, under Mashups, select Data Controls, and on the resulting Data Controls page, click Create.

2. In the Create new Data Control dialog, select Web Service in the left pane (Figure 26-4).

Figure 26-4 New Web Service Data Control Wizard

3. At the bottom of the dialog, use the Name and Description fields to specify a name and description for the Web Service data control.

4. In the WSDL URL field, enter the WSDL for the data control. For example:

http://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?wsdl

5. Use the Proxy Host Name and Proxy Port Number fields to configure proxy authentication.

To ensure a secure connection to the Web Service, you must first configure your application to use proxy authentication.

Notes:

- If a central WebCenter proxy (or RSS proxy) is already configured, then the proxy fields are automatically populated with that proxy host name and port number. You can modify the proxy details or clear the fields if you do not want to configure proxy.

Changing the WebCenter central proxy does not change the proxy setting against the Web Service data control. However, changing the Web Service data control proxy setting changes the WebCenter central proxy setting.

For more information about RSS proxy, see "Setting Up a Proxy Server for the RSS Service" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

- If Web Logic Domain proxy is already configured, and if you choose not to set proxy while creating or editing the Web Service data control, then the Web Logic Domain proxy is used as the default setting.

6. If you are connecting to a secured Web Service, enter user name and password to access the Web Service endpoint.

If access to the WSDL itself is secured, then you cannot connect to the Web Service from the Create new Data Control dialog. To workaround this limitation, access the WSDL in a browser by specifying the username and password, download the WSDL page, save it locally as a .wsdl document, then specify the path to this document in the WSDL URL field in the Create new Data Control dialog.

7. Optionally, click Connect to establish the connection to the producer whose WSDL you specified.

If the connection is successful, the Service Details section displays a count of the services and methods that exist in the Web Service.

If you do not click Connect at this stage, the connection is established later, when required.

8. Optionally, click View XML to view the XML content of the WSDL document.

9. Click Next.

The Methods page displays the methods available for the selected service, and the parameters exposed for each method, as shown in Figure 26-5.

Figure 26-5 Web Service Data Control Methods

A Web Service may expose scalar and complex parameters that control the data displayed in the data control. For more information, see Section 26.1.1.2, "Web Service Data Controls."

You can specify values for any exposed parameters. However, you can specify values only while consuming the data control in a task flow or a page. For more information, see "Editing Parameter Values for Web Service Data Controls".

10. From the Service dropdown list, select a different service, if required.

11. From the Port dropdown list, select one of the available ports.

All methods under that port are added to the data control. These methods are later available for selection in the Resource Catalog.

12. Click Next.

13. If the Web Service is secured using OWSM, use the OWSM Security panel to specify the policies to be used, as described in Table 26-1.

Table 26-1 OWSM Security Information

Name

Description

MTOM

The MTOM (message transmission optimization mechanism) policy you want to use.

Reliability

The reliability policy you want to use.

Addressing

The addressing policy you want to use.

Security

Any additional security policies you want to apply.

For example, if your Web Service is secured using a policy named mycompany/wss_username_token_service_policy, populate the Security field with the client policy, which is mycompany/wss_username_token_client_policy.

See Also:

Oracle Fusion Middleware Security and Administrator's Guide for Web Services for more information about security policies.

14. You can override properties on the security policy that you specified in the previous step. Use the Add Property and Remove Property buttons to add or remove entries in the Override OWSM Policy Properties section.

Note:

Override properties are defined by the policy. Therefore, to perform this step, you must know the policy being used and the properties that you can override.

For example, if you specified a Security policy, mycompany/wss_username_token_client_policy, and the policy has a csf-key property, then in the override section, shown in Figure 26-6, click Add Property to add a value for csf-key. Note that this key must exist in configured keystore.

See Also:

"Configuring the Credential Store Provider" in Oracle Fusion Middleware Security and Administrator's Guide for Web Services for information about adding csf-key to the credential store.

Figure 26-6 New Web Service Data Control - OWSM Security

15. Click OK.

The new data control is listed on the Resources - Data Controls page. However, the data control is hidden by default. You can consume it in pages or task flows only after it is made available to the application. For more information, see Section 26.2.3.1, "Showing or Hiding a Data Control in the Resource Catalog."

You can now add this data control to a page or task flow. For more information, see Section 26.4.1, "Consuming a Data Control in a Task Flow."

26.2.3 Managing Data Controls

In addition to creating data controls, you can also edit, copy, expose, and delete data controls on the Resources - Data Controls page. This section describes these tasks. It includes the following subsections:

- Section 26.2.3.1, "Showing or Hiding a Data Control in the Resource Catalog"

- Section 26.2.3.2, "Copying Data Controls"

- Section 26.2.3.3, "Editing Data Controls"

- Section 26.2.3.4, "Editing Data Control Bind Variables"

- Section 26.2.3.5, "Setting Properties on a Data Control"

- Section 26.2.3.6, "Setting Security on a Data Control"

- Section 26.2.3.7, "Deleting Data Controls"

What You Should Know About Editing or Deleting a Data Control

The data controls that you create are consumed in pages or task flows. As a result, when you edit or delete a data control, the references to this data control in pages or task flows may be broken. Therefore, use the Edit and Delete options on a data control with caution, after considering the impact on the consuming pages and task flows.

If you added a data control inside a task flow and later deleted the data control, you can repair the task flow by removing references to the data control from the task flow's source files. Perform the following steps to repair a task flow that has broken references to a data control:

1. On the Resource Manager - Task Flows page, select the task flow that you need to repair.

2. From the Edit menu, select Edit Source.

3. Click each of the three tabs, Taskflow Definition, Fragment, and Page Definition, and remove any references to the data control from the source files.

Note:

To ensure that you do not end up with an invalid task flow that does not render properly, edit the source code very carefully.

4. Click OK.

26.2.3.1 Showing or Hiding a Data Control in the Resource Catalog

Data controls created from the Resources - Data Controls page must be available in the Resource Catalog so that they can be consumed in your application pages or task flows. By using the Show and Hide options from the Edit menu on the Resources - Data Controls page, you can control whether a selected data control is included in the Resource Catalog. When you mark a data control as shown, it is automatically included in the default Resource Catalog for the application or current Space. Further, for a data control created at the application level, you can control whether it is available to any, all, or selected Spaces in the application.

For generic information about hiding and showing resources, see Section 10.4.3, "Showing and Hiding Resources."

For generic information about resource availability in Spaces, see Section 10.4.2.5, "Setting the Availability of an Application-Level Resource in Other Spaces."

26.2.3.2 Copying Data Controls

You can make a copy of a data control by selecting it and choosing Copy from the Edit menu. The procedure to copy a data control is similar to that for copying any other resource. For the generic procedure, see Section 10.4.1, "Copying a Resource."

Note:

Avoid copying an inherited Web Service data control as you may see an internal error when you run or edit the copy.

26.2.3.3 Editing Data Controls

You can modify a data control by selecting it and choosing Edit from the Edit menu. The Edit dialog enables you to modify the values that you provided while creating the data control. For information about the fields, see the detailed steps in Section 26.2.1, "Creating a SQL Data Control" and Section 26.2.2, "Creating a Web Service Data Control."

See Also:

"What You Should Know About Editing or Deleting a Data Control"

26.2.3.4 Editing Data Control Bind Variables

You can add or rename bind variables in existing SQL data controls by editing the SQL query used for the data control. Modify the SQL query in the Create or Edit Data Control dialog. For the detailed steps, see Section 26.2.1.2, "Creating the Data Control."

Note:

You cannot create or edit parameters for Web Services data controls. A Web Services data control only allows you to specify values for the parameters exposed by its methods.

When you consume a data control, you can control the display of data in the visualization by specifying proper values for the data control's bind variables or parameters. For more information, see Section 26.4.6.1, "Editing Parameter Values for a Data Control Visualization."

26.2.3.5 Setting Properties on a Data Control

Each data control has certain properties associated with it that control how it is displayed in the application or Space. You can edit these properties through the Edit Properties dialog. For the generic procedure, see Section 10.4.2, "Setting Properties on a Resource."

26.2.3.6 Setting Security on a Data Control

When you create a data control, the default application-level or Space-level security settings are applied to it. You can use the Security Settings option on the Edit menu to modify the default settings in the following ways:

- Change the default permissions granted to users and roles.

- Revoke all permissions for a user or role.

- Grant Edit and Manage permissions to additional users and roles.

For the detailed steps, see Section 10.4.4, "Setting Security for a Resource."

26.2.3.7 Deleting Data Controls

You can delete a data control by selecting it and choosing Delete from the Edit menu. For the generic procedure, see Section 10.4.5, "Deleting a Resource."

See Also:

"What You Should Know About Editing or Deleting a Data Control"

26.2.4 Using Design-Time Data Controls

Oracle WebCenter Framework exposes a large number of service data controls that can be added to application pages and task flows. Design-time data controls are not available out-of-the-box in the WebCenter Spaces Resource Catalogs, but they are available in the Resource Registry. You can add these data controls to custom catalogs from the Resource Registry. The data controls can then be added to pages and task flows in your WebCenter Spaces instance.

Note:

The Design-Time DataControls folder lists all the WebCenter Services data controls. However, adding the ConnectionsNetworkDC and KudosServiceDC data controls at runtime is not supported. Avoid adding these data controls to your page or task flow.

Design-time data controls can also be added to custom catalogs in JDeveloper. For more information, see "How to Expose Design-Time Data Controls" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

26.2.5 Exporting and Importing Data Controls Across Spaces

WebCenter Spaces enables you to export and import runtime data controls as part of a Space export and import. You can export a Space, and therefore the included data controls, between WebCenter applications, and stage or production environments. This is the only way to export data controls created at runtime. For the steps to export and import a Space, see Section 53.5, "Importing and Exporting Spaces and Space Templates."

Note:

- Unlike other portal resources, you cannot edit runtime data controls in JDeveloper. The Data Controls page in the Resource Manager does not provide Upload and Download options.

- While importing or exporting a Space that contains a Web Service data control, the Web Service must be up and accessible. If not, the import or export operation throws exceptions.

After a successful import, the following files on the target instance list the data controls being used in different pages, page templates, and task flows:

- oracle/webcenter/webcenterapp/bindings/DataBindings.cpx

- oracle/webcenter/sitetemplate/view/DataBindings.cpx

26.2.5.1 Steps You Must Perform After an Import

You must be careful while exporting and importing data controls. You may get errors if you use application-level data controls in Spaces, for example, if you create an application-level data control, consume it in a Space, export the Space, and import it into another instance, then pages or task flows containing the application-level data control may be broken.

To ensure that an imported data control works properly, you must perform the following tasks after importing the Space to the target instance:

- Open pages in the imported Space and verify that the data controls display properly. If a data control is available on the page but does not display any data, then you must edit the page and add that data control to the page again. For the steps to add a data control, see Section 26.4.1, "Consuming a Data Control in a Task Flow."

An imported data control may not display data due to the following issues:

- The target WebCenter Spaces instance and the imported Space use different data bindings CPX files.

- The CPX file used by the page does not contain a usage entry for that data control.

- For SQL data controls: In the WLS Administration Console of the target instance, create a JDBC data source connection with the same name as the connection used on the source instance. For the detailed steps, see Section 26.2.1.1, "Creating a Database Connection."

An imported page or task flow that uses a SQL data control will not work in the new Space until a JDBC Connection of the same name is created.

- For Web Services data controls:

- Edit the data control in the Resource Manager and provide the credentials afresh. Credentials are not exported or imported with the application. For the detailed steps, see Section 26.2.3.3, "Editing Data Controls."

You do not have to specify security policies again as they are imported and exported along with the application.

- Open the DCConnections.xml file in the imported EAR and modify the proxy host name and port number to point to the target instance. The DCConnections.xml file is available in the /META-INF/mdssys/cust/adfshare/adfshare/ directory.

To ensure a secure connection to the Web Service, you must set up a proxy server on the target instance.

26.3 Creating and Managing Task Flows

In the previous sections, you learned how to create data controls to retrieve data from different data sources. These data controls can be added to pages or task flows to provide visualizations of the gathered data. Just like pages, task flows are also containers in which you can add components such as portlets, content, and other task flows. However, task flows provide the advantage of component wiring to create mashups of your choice. When you add a data control to a page, you cannot modify or control the data displayed in the data control. If you want a more flexible setup, you can add a data control inside a task flow.

You can control the data displayed in the data control by adding it inside a task flow and wiring data control parameters to task flow parameters or input text components. For example, if you have a SQL data control, with a bind parameter DeptNo, that retrieves data from an employee database, you can add this data control inside a task flow and wire a task flow parameter to the DeptNo parameter. The data control now displays data based on the value specified for the task flow parameter. You can change the task flow parameter value in Oracle Composer to view corresponding data in the data control.

This section describes how to create and manage task flows in the Resource Manager. It includes the following subsections:

- Section 26.3.1, "Creating a Task Flow"

- Section 26.3.2, "Managing Task Flows"

- Section 26.3.3, "Using Task Flows Created at Design Time"

- Section 26.3.4, "Managing Mashup Styles"

26.3.1 Creating a Task Flow

To create a task flow:

1. On the Resources page, under Mashups, select Task Flows, and on the resulting Task Flows page, click Create.

2. In the Create new Task Flow dialog, in the Name field, enter a name for the task flow.

3. In the Description field, enter a meaningful description of the task flow (Figure 26-7).

Figure 26-7 New Task Flow

4. Select a style for the task flow. For more information, see Section 26.3.4.1, "Out-of-the-Box Mashup Styles."

5. Click OK.

The new task flow is listed on the Resources - Task Flows page. However, the task flow is hidden by default. You cannot consume it unless it is made available to the application. For more information, see Section 26.3.2.1, "Showing or Hiding a Task Flow in the Resource Catalog."

You can now edit the new task flow and populate it with different resources, including data controls, that are available in the Resource Catalog. For more information, see Section 26.3.2.3, "Editing a Task Flow."

26.3.2 Managing Task Flows

This section includes the following subsections:

- Section 26.3.2.1, "Showing or Hiding a Task Flow in the Resource Catalog"

- Section 26.3.2.2, "Copying a Task Flow"

- Section 26.3.2.3, "Editing a Task Flow"

- Section 26.3.2.4, "Previewing a Task Flow"

- Section 26.3.2.5, "Setting Properties on a Task Flow"

- Section 26.3.2.6, "Setting Security on a Task Flow"

- Section 26.3.2.7, "Deleting a Task Flow"

- Section 26.3.2.8, "Using JDeveloper to Modify a Task Flow"

26.3.2.1 Showing or Hiding a Task Flow in the Resource Catalog

Task flows created from the Resources - Task Flows page must be available in the Resource Catalog so that they can be consumed in pages. By using the Show and Hide options from the Edit menu on the Resources - Task Flows page, you can control whether a selected task flow is included in the Resource Catalog. When you mark a task flow as shown, it is automatically included in the default Resource Catalog for the application or Space. In the out-of-the-box catalog, the task flow is available in a Task Flows folder that is nested inside the Mash-Ups folder.

For generic information about hiding and showing resources, see Section 10.4.3, "Showing and Hiding Resources."

In addition to showing or hiding a task flow, you can control whether an application-level task flow is available to any, all, or selected Spaces in the application. For generic information about resource availability in Spaces, see Section 10.4.2.5, "Setting the Availability of an Application-Level Resource in Other Spaces."

26.3.2.2 Copying a Task Flow

You can create a copy of a task flow by selecting it and choosing Copy from the Edit menu on the Resources - Task Flows page. The Copy feature enables you to replicate a local task flow in the runtime environment without having to actually export and upload the task flow.

For the generic procedure, see Section 10.4.1, "Copying a Resource."

26.3.2.3 Editing a Task Flow

You may want to edit a task flow for the following reasons:

- Design the task flow's view fragment.

- Create or modify task flow parameters.

The Resource Manager provides the following two options to edit a task flow:

- Edit the task flow's view fragment in Oracle Composer.

- Edit the source code of the task flow definition file, its view fragment, and the fragment's page definition file in a text editor.

Note:

To perform certain advanced editing tasks, you may need to download the task flow to JDeveloper, edit it, and upload it back to your WebCenter Spaces instance. For more information, see Section 26.3.2.8, "Using JDeveloper to Modify a Task Flow."

This section describes both these editing tasks. It includes the following sections:

- Section 26.3.2.3.1, "Editing a Task Flow in Oracle Composer"

- Section 26.3.2.3.2, "Editing a Task Flow's Source Files in a Text Editor"

26.3.2.3.1 Editing a Task Flow in Oracle Composer

You can modify a task flow by selecting it and choosing Edit from the Edit menu on the Resources - Task Flows page. The task flow's view fragment opens in Oracle Composer. You can add a variety of resources to the view fragment from the Resource Catalog.

As this chapter focuses on how to create mashups using data from different data sources, it is useful to know how to populate task flows with data controls and bind task flow parameters to data control parameters. For more information, see Section 26.4.1, "Consuming a Data Control in a Task Flow."

For generic information about adding content to a page or task flow in Oracle Composer, see Part IX, "Organizing Your Collaborative and Social Networking Environment".

26.3.2.3.2 Editing a Task Flow's Source Files in a Text Editor

The Resource Manager provides the Edit Source option for editing the source code of the task flow fragment, its page definition, and the task flow definition file. You may want to edit a task flow's source files for the following reasons:

- Clean up the page fragment and its page definition when you delete a referenced component, such as a data control.

When you delete a data control after it is included in a task flow, the task flow has broken links. The source editor enables you to search and delete references to the data control from the fragment and its page definition file.

- Make adjustments to the task flow's code without having to download it, edit it in JDeveloper, and upload it back into WebCenter Spaces.

To edit a task flow's source files:

Note:

Edit a task flow's source files only when absolutely necessary. To ensure that you do not end up with an invalid task flow that does not render properly, edit the source code very carefully.

1. Select the task flow, from the Edit menu in the Resource Manager, select Edit Source.

A simple Edit Source dialog (Figure 26-8) displays with three tabs, Taskflow Definition (task flow definition XML file), Fragment (page fragment JSFF file), and Page Definition (fragment's page definition XML file).

Figure 26-8 Edit Source Dialog for a Task Flow

2. Click a tab to edit the source code for that file.

The format of the code is validated and an error message is displayed if you miss any tags or add them incorrectly.

3. Click OK.

26.3.2.4 Previewing a Task Flow

Use the Preview option to see how the task flow appears when it is consumed in a page or another task flow. In preview mode, the task flow displays Edit and Close buttons. Click Close to exit preview mode. Click Edit if you want to modify the task flow in Oracle Composer. For more information, see Section 26.3.2.3, "Editing a Task Flow."

26.3.2.5 Setting Properties on a Task Flow

Each task flow has certain properties associated with it that control how it is displayed in the application or Space. You can edit these properties through the Edit Properties dialog. For the generic procedure, see Section 10.4.2, "Setting Properties on a Resource."

26.3.2.6 Setting Security on a Task Flow

When you create a task flow, the default application-level or Space-level security settings are applied to it. You can use the Security Settings option on the Edit menu to modify the default settings in the following ways:

- Change the default permissions granted to users and roles.

- Revoke all permissions for a user or role.

- Grant Edit and Manage permissions to additional users and roles.

For the detailed steps, see Section 10.4.4, "Setting Security for a Resource."

26.3.2.7 Deleting a Task Flow

You can delete a task flow by selecting it and choosing Delete from the Edit menu on the Resources - Task Flows page. For the generic procedure, see Section 10.4.5, "Deleting a Resource."

26.3.2.8 Using JDeveloper to Modify a Task Flow

You may prefer to edit a runtime task flow in JDeveloper. To do this, you have several options:

- Use the Edit Source option to view the source code of the task flow's source files. You can copy the contents of the dialog to JDeveloper for editing and then copy the edited code back into the dialog. For more information, see Section 26.3.4.4, "Editing a Mashup Style."

- Download an existing WebCenter Spaces task flow, import it into JDeveloper, edit it, and then upload it back to WebCenter Spaces.

Note:

As a task flow typically involves multiple files, trying to create a task flow in JDeveloper, expose it as a portal resource, and export all files and metadata correctly can cause errors. The deployed task flow may be broken and not work poperly. Therefore, it is recommended that you use JDeveloper to only modify runtime task flows. Do not export design-time task flows as portal resources.

For information about using design-time task flows in WebCenter Spaces, see Section 26.3.3, "Using Task Flows Created at Design Time."

The generic steps to upload and download a resource from WebCenter Spaces are described in Section 10.5.2, "Downloading a Resource"and Section 10.5.3, "Uploading a Resource."

For information about how a task flow is imported, edited, and exported in JDeveloper, see the section "Working with Mashup Styles" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Note:

Task flows and mashup styles are similar resources and can be edited the same way in JDeveloper.

You must note that task flows created at runtime may contain components that are bound to data controls. When you download such a task flow, the referenced data controls are not downloaded. When you open such a task flow in JDeveloper, you will not see a fully running task flow because the associated data controls are not available in JDeveloper. The task flow will work properly only when you take it back to the WebCenter Spaces instance.

26.3.3 Using Task Flows Created at Design Time

If you created a custom task flow in Oracle JDeveloper and want to consume it in WebCenter Spaces, you must ensure that the task flow is available in the Resource Catalog. Users can then consume the task flow in their pages and task flows. To expose a custom task flow created in JDeveloper, you must deploy the application containing the task flow as a shared library to the WebCenter Spaces instance. The task flow is then included automatically in the Resource Registry. You can add the task flow to custom catalogs from the Resource Registry.

Oracle WebCenter Framework provides a workspace specifically for deploying and undeploying WebCenter Spaces Shared Library Extensions. You must use that workspace to deploy task flows to WebCenter Spaces. For more information, see "Deploying Your Own Custom Code and Task Flows in Shared Libraries" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Design-time data controls can also be added to custom catalogs in JDeveloper. For more information, see "How to Manage Content in the Resource Catalog" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

26.3.4 Managing Mashup Styles

Mashup styles are templates used to create new task flows in your application. They are useful if you want to reuse a custom visualization in different task flows in your application. The Create Task Flow dialog, which is invoked from the Resources - Mashup Styles page, displays all available mashup styles. The Resource Manager (Resources page) provides options to manage mashup styles that are displayed in the Create Task Flow dialog. You can offer a wider selection of mashup styles to users or restrict mashup styles so that users build only the types of task flows that you intend.

You can manage mashup styles in the following ways:

- Copy an out-of-the-box mashup style and modify its properties.

- Upload a mashup style created in Oracle JDeveloper.

- Download a custom mashup style, edit it in Oracle JDeveloper, and upload it back to the runtime application.

- Show or hide a mashup style in the Create Task Flow dialog.

- Edit a custom mashup style or its properties.

- Change security settings on a custom mashup style.

- Delete a custom mashup style.

Note:

The default, out-of-the-box mashup styles cannot be edited or deleted. You can only copy these styles or hide them in the Create Task Flow dialog.

See Section C.6, "Building and Using a Custom Mashup Style with Predefined Columns" for an example of how to create a custom mashup style.

This section provides information about the out-of-the-box mashup styles included with Oracle WebCenter Spaces and explains how to manage mashup styles in the Resource Manager. It includes the following sections:

- Section 26.3.4.1, "Out-of-the-Box Mashup Styles"

- Section 26.3.4.2, "Copying a Mashup Style"

- Section 26.3.4.3, "Showing or Hiding a Mashup Style in the Create Task Flow Dialog"

- Section 26.3.4.4, "Editing a Mashup Style"

- Section 26.3.4.5, "Previewing a Mashup Style"

- Section 26.3.4.6, "Setting Properties on a Mashup Style"

- Section 26.3.4.7, "Setting Security on a Mashup Style"

- Section 26.3.4.8, "Deleting a Mashup Style"

- Section 26.3.4.9, "Using JDeveloper to Build Your Mashup Style"

26.3.4.1 Out-of-the-Box Mashup Styles

Table 26-2 describes the mashup styles available out of the box.

Table 26-2 Mashup Styles

Name

Description

Blank

A one-column task flow with one layout box into which you can add content, including additional layout components.

Switching this task flow style is allowed.

Stretch

Maximizes the task flow to take up all available space.

For an example of a page based on the Stretch style, see the Documents page or the Announcements page in your WebCenter Spaces application.

Task flows based on this style cannot be switched.

Parameter Form

Provides an input text field where a user can specify a value. Out-of-the-box, the input text is wired to pageFlowScope.bindVarId. When you use this style, you can add other components to the task flow and use the input text's pageFlowScope variable as an input parameter for another component, for example, a data control.

For example, you can use this mashup style to create a task flow with a search field and a search results table. If the results table displays data from a data control, you can wire the search field parameter to the data control parameter, so that the table displays data specific to the criteria you specify in the search field.

26.3.4.2 Copying a Mashup Style

You can make a copy of an existing mashup style by selecting it and choosing Copy from the Edit menu on the Resources - Mashup Styles page. Copying a mashup style enables you to replicate a local style in the runtime environment without having to actually export and upload the mashup style. As there is no option to create a mashup style from scratch, you can create a copy of a default style and replace its code with that of a custom visualization that you want to create.

For the generic procedure, see Section 10.4.1, "Copying a Resource."

You can create a custom visualization with the required UI components and use a dummy EL value, #{dataPresenter.dummyData.collectionModel}, as a placeholder for the real data. When you create a new task flow using this style, you can replace the dummy EL value with the real binding. For an example showing how to create a custom mashup style, see Section C.6, "Building and Using a Custom Mashup Style with Predefined Columns."

26.3.4.3 Showing or Hiding a Mashup Style in the Create Task Flow Dialog

The Create Task Flow dialog displays all the mashup styles available for building task flows. You can control whether a mashup style is displayed in the Create Task Flow dialog by marking it as shown or hidden. For generic information about hiding and showing resources, see Section 10.4.3, "Showing and Hiding Resources."

Further, for a mashup style created at the application level, you can control whether it is available to any, all, or selected Spaces in the application. For generic information about availability in Spaces, see Section 10.4.2.5, "Setting the Availability of an Application-Level Resource in Other Spaces."

26.3.4.4 Editing a Mashup Style

Use the Edit Source option in the Resource Manager to edit the source code of the mashup style's task flow definition file, view fragment, and the fragment's page definition file. You may want to edit a custom mashup style to alter its layout. You can create a create a custom visualization with the required UI components and use a dummy EL value, #{dataPresenter.dummyData.collectionModel}, as a placeholder for the real data. When you create a new task flow using this style, you can replace the dummy EL value with the real binding. For an example showing how to create a custom mashup style, see Section C.6, "Building and Using a Custom Mashup Style with Predefined Columns."

To edit a mashup style's source files:

Note:

Edit a mashup style's source files only when absolutely necessary. To ensure that you do not end up with an invalid style that does not render properly, edit the source code very carefully.

1. Select the mashup style, from the Edit menu in the Resource Manager, select Edit Source.

A simple Edit Source dialog displays with three tabs, Taskflow Definition, Fragment, and Page Definition, as shown in Figure 26-9.

Figure 26-9 Edit Source Dialog

2. Click a tab and edit the source code for that file.

The format of the code is validated and an error message is displayed if you miss any tags or add them incorrectly.

3. Click OK.

To perform certain advanced editing tasks, you may need to download the style, edit it in JDeveloper, and upload it back to your WebCenter Spaces instance. For more information, see Section 26.3.4.9, "Using JDeveloper to Build Your Mashup Style."

26.3.4.5 Previewing a Mashup Style

Use the Preview option to see how the style appears when it is applied to a task flow. In preview mode, the mashup style displays Edit and Close buttons. Click Close to exit preview mode. Click Edit if you want to modify the style in Oracle Composer. For more information, see Section 26.3.4.4, "Editing a Mashup Style."

26.3.4.6 Setting Properties on a Mashup Style

Default, out-of-the-box mashup styles do not have associated runtime properties. However, each custom mashup style has certain properties associated with it. You can edit these properties through the Edit Properties dialog. For the generic procedure, see Section 10.4.2, "Setting Properties on a Resource."

26.3.4.7 Setting Security on a Mashup Style

When you copy or upload a mashup style, the default application-level or Space-level security settings are applied to it. You can use the Security Settings option on the Edit menu to modify the default settings in the following ways:

- Change the default permissions granted to users and roles.

- Revoke all permissions for a user or role.

- Grant Edit and Manage permissions to additional users and roles.

For the generic procedure, see Section 10.4.4, "Setting Security for a Resource."

26.3.4.8 Deleting a Mashup Style

You can delete a custom mashup style by selecting it and choosing Delete from the Edit menu on the Resources - Mashup Styles page. For the generic procedure, see Section 10.4.5, "Deleting a Resource."

26.3.4.9 Using JDeveloper to Build Your Mashup Style

You may want to create a mashup style that is beyond the editing capabilites of WebCenter Spaces, or you may prefer working in JDeveloper. To do this, you have several options:

- Use the Edit Source option to edit the source code of the mashup style's source files. You can edit the source code directly in the Edit Source dialog or you can copy the contents of the dialog to JDeveloper for editing and then copy the edited code back into the dialog. For more information, see Section 26.3.4.4, "Editing a Mashup Style."

- Download an existing WebCenter Spaces mashup style, import it into JDeveloper, for editing, and then upload it back to WebCenter Spaces.

- Create a completely new mashup style in JDeveloper and upload it to WebCenter Spaces.

The generic steps to upload and download a resource from WebCenter Spaces are described in Section 10.5.2, "Downloading a Resource"and Section 10.5.3, "Uploading a Resource."

Oracle provides a special JDeveloper workspace (DesignWebCenterSpaces.jws) for developing WebCenter Spaces resources, including mashup styles. The workspace offers a design environment in which to create and edit your mashup style, and also enables you to upload them to WebCenter Spaces for testing. For more information and to download the JDeveloper workspace, see "Developing WebCenter Spaces Resources" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

For information about how a mashup style is imported, edited, and exported in JDeveloper, see the section "Working with Mashup Styles" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter. You may need to look at the special considerations for mashup styles in JDeveloper.

26.4 Creating Data Visualizations

You have seen how to create data controls and task flows. Data controls created from the Resources - Data Controls page are available automatically in the Resource Catalog and can therefore be added to task flows and pages. You can consume data controls in task flows or pages and render them in different ways, such as tables, graphs, and forms, to create useful mashups. If you consume them in task flows, you can define parameters on the data control and bind those parameters to task flow parameters so that users can specify a value for a task flow parameter and display data based on that value.

This section describes how to consume data controls and bind data control parameters to task flow parameters. It includes the following subsections:

- Section 26.4.1, "Consuming a Data Control in a Task Flow"

- Section 26.4.2, "Creating Task Flow Parameters"

- Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters"

- Section 26.4.4, "Wiring a Data Control to a Parameter Form Task Flow"

- Section 26.4.5, "Consuming Task Flows that Contain Visualizations"

- Section 26.4.6, "Editing Visualizations"

- Section 26.4.7, "Writing to a Data Source from a Visualization"

26.4.1 Consuming a Data Control in a Task Flow

When you add a data control, its accessors, or its methods to a task flow, you can select different UI options for rendering the data. Depending on the object you select and the visualizations it supports, different options are listed on the Add menu. For more information, see Section 26.1.2, "Supported Visualizations."

If you populate a task flow with different elements from a data control that uses bind parameters, then all the objects display data for the same parameter values. You cannot specify different parameter values for elements coming from the same data control.

This section describes the different ways in which you can add a data control inside a task flow. It includes the following subsections:

- Section 26.4.1.1, "Adding a Data Control as a Table"

- Section 26.4.1.2, "Adding a Data Control as a Form"

- Section 26.4.1.3, "Adding a Data Control as a Graph"

26.4.1.1 Adding a Data Control as a Table

The Table option is displayed only for data control accessors that return a collection of objects that can be displayed in columns of a table. You can add a data control as a read-only table that displays data using Output Text components by default, or as an editable table that displays data using Input Text components by default. You can also display data using Output Formatted components and hyperlinks.

This section describes the steps to add a sample SQL data control as a read-only table and editable table.

26.4.1.1.1 Adding a Data Control as a Read-Only Table

A read-only table displays the data retrieved from a data control in Output Text components. The content in the table cannot be edited.

To add a SQL data control as a read-only table:

1. Select the task flow in which you want to add the data control, then from the Edit menu, select Edit to open the task flow in Oracle Composer.

2. Click Add Content in the container in which you want to add the data control.

3. In the Add Content dialog, navigate to the section of the Resource Catalog that contains runtime data controls.

Tip:

The location of data controls depends on the Resource Catalog used for editing pages. For example, in the default Resource Catalog, runtime data controls are present in the Data Controls subfolder, which is nested inside the Web Development folder or Mash Ups folder.

4. Click the Open link next to a data control, for example PageHits, to display its content.

5. Click the Add link next to the PageHits accessor. From the dropdown menu, select Table, as shown in Figure 26-10.

Figure 26-10 Add Content Dialog - Table Option

6. In the Create Table - Type page, shown in Figure 26-11, select Read-only Table.

Figure 26-11 Create Table - Type

7. Optionally, in the Behavior section, select the Row Selection, Filtering, and Sorting options to enable customization of the table.

Select Row Selection to enable selection of a row on which you can perform any operation.

Note:

Using Values from Row Selection

When you enable row selection in a table and select a row, internally, the column values of the selected row are added into a row selection bean. The column values are stored in the following EL format:

#{dataComposerViewContext.dataSelection.COLUMN_NAME}

You can use this format to reference the table columns from elsewhere in the task flow. Typically, this is useful in mashups where data visualizations are wired in a master-detail relationship.

However, row selection is not supported if the data control contains bind parameters.

Select Filtering to display a text field above each column in the table. You can specify a filter criteria in these text fields to display only rows that match the criteria.

Select Sorting to enable sorting of columns. When you select this option, the column headers display Up and Down arrows, which you can use to sort columns in an ascending or descending order.

8. Click Next.

9. In the Create Table - Items page, select the accessor attributes that you wish to display in the table and move them from the Available Items list to the Selected Items list (Figure 26-12).

The table displays columns for attributes in the same order as they are in this dialog. You can use the Up and Down arrows to the right of the Selected Items box to resequence attributes and thereby, the table columns.

Figure 26-12 Create Table - Items

10. Click Next.

11. In the Create Table - Columns page (Figure 26-14), specify values for the table's display attributes, as follows:

- Column Header: Specify a name to be used as a header for the selected column.

- Display As: Select an output format for the column. Choose from:

- Output Text

Use to display data records as styled read-only text.

- Output Formatted

Use to display data records as read-only text with limited formatting.

- Hyperlink

Use to display data in the selected column as a link, for example, when connecting to an employee database, you can display employee names as hyperlinks. When a user clicks a link, it takes them to the employee's profile page. Another example would be where you add a WebCenter Spaces Web Service data control as a table that list the Spaces; you can use the URL option to display Space names as hyperlinks so that clicking a Space name opens the Space.

- Align: Select whether the data in the table cells must be aligned to the center, end, left, right, or start.

- URL: Use this field to create dynamic URLs based on the values coming from the data control. Specify the URL along with the EL value that must be appended to the URL. The URL field is enabled only if you selected Hyperlink as the column format.

For example, if you are adding a WebCenter Spaces Web Service data control as a table that list the Spaces of which the current user is a member, you can use the URL option, as shown in Figure 26-13, to display Space names as hyperlinks. Clicking a Space name in the table opens the Space in a separate window.

Figure 26-13 Create Table - Columns

- Open in New Window: Select to open the URL in a separate window. This field is enabled only when you select Hyperlink as the column format.

Note:

The Display As field lists both Input Text and Output Text options if you selected the table type as Table.

Figure 26-14 Create Table - Columns

12. Click Next.

13. In the Create Table - DC Parameters page, shown in Figure 26-15, change the default values for the exposed data control parameters, then click Create.

Figure 26-15 Create Table - DC Parameters

The DC Parameters page is enabled only if the accessor being added has associated parameters. You can use this page to bind data control parameters to task flow parameters. For more information, see Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

If you skip this step, the parameter values that you specified while creating the data control are used.

14. A table is created in the task flow based on the options you selected, as shown in Figure 26-16.

Figure 26-16 Data Control Added as a Read-Only Table

You can format the table by sorting data, reordering columns, and so on. For more information, see Section 26.4.6.2, "Customizing a Table."

Now that you have added the data control as a table inside a task flow, you can bind the task flow's parameters to the data control's parameters. By doing this, when you consume the task flow in a page, users can specify a value for the task flow parameter to view corresponding data in the table. For more information, see Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

26.4.1.1.2 Adding a Data Control as an Editable Table

If the data source supports updating of records, you can add a data control accessor or operation return as an editable table. When you create an editable table, you can edit information in the table and commit those changes to the data source. In an editable table, most attributes are represented using ADF Input Text components whose values can be edited. To save your changes back to the data control, you can create command buttons using operations that can modify data records, and place those buttons in a toolbar in the table. For example, you can use the Delete operation to create a button that allows a user to delete a record from the current range. Or you can use the built-in Submit button to submit changes.

If you add an editable table and the underlying data control does not support updating, the table displays as a read-only table.

Note:

Data controls created at runtime do not support editing of data. Currently, only design time BC4J-based SQL data controls support editing of data through tables.

The procedure to add a data control as an editable table is similar that of adding a read-only table. This section lists the additional tasks required to add an editable table and include Create, Update, and Delete options on the table.

To add a data control accessor as an editable table:

1. Perform the steps in Section 26.4.1.1.1, "Adding a Data Control as a Read-Only Table," but with the following exceptions:

1. On the Create Table - Type page, select Table.

2. On the Create Table - Columns page, for each column that you want to make editable, set the Display As field to Input Text w/Label.

Note:

If the data control does not support updating of data, the columns display read-only fields.

2. A table is created in the task flow based on the options you selected, as shown in Figure 26-17.

Figure 26-17 Data Control as an Editable Table

When you add a Web Service data control as an editable table, you can edit records in the table and write the changes back to the Web Service data source. However, you can update data only if the Web Service exposes a method to do so. For more information, see Section 26.4.7, "Writing to a Data Source from a Visualization."

For information about formatting a table and customizing it further, see Section 26.4.6.2, "Customizing a Table."

The next step is to create task flow parameters and bind the task flow's parameters to the data control's parameters. When you consume such a task flow in a page, users can specify a value for the task flow parameter to view corresponding data in the table. For more information, see Section 26.4.2, "Creating Task Flow Parameters" and Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

26.4.1.1.3 Adding a Web Services Data Control Accessor with Complex Parameters

As explained in Section 26.1.1.2, "Web Service Data Controls," Web Services data control accessors may expose scalar or complex parameters. When you add a Web Services data control accessor as a table, you can specify values for data control parameters in the DC Parameters page of the wizard. You must specify values for scalar and complex parameters as follows:

- Simple EL or static values for scalar parameters.

- XML values for complex parameters. A complex parameter can expose a set of scalars using an EL value.

The steps to specify values for simple parameters is the same for all types of data controls and are explained in the previous section. However, if a Web Services data control accessor exposes complex parameters, the DC Parameters page of the table creation wizard displays an extra context menu option, Parameter Structure. The Parameter Structure option invokes a Parameters dialog, which lets you expand the complex parameter, as shown in Figure 26-18, and specify values for the complex parameter itself or its included simple parameters.

Figure 26-18 Parameters Dialog Displaying a Complex Parameter

Section C.5, "Creating a Mashup with Data from a Siebel Data Source" provides an example of using the Parameters dialog to specify values for complex parameters.

26.4.1.2 Adding a Data Control as a Form

The Form option is displayed only for data control accessors that return a collection of objects that can be displayed as a form element. You can add a data control accessor as a read-only form that displays data using Output Text components, or as an editable form that typically displays data using Input Text components. You can also display data using Output Formatted components and URLs.

To add a Web Service data control as a form:

1. In the Resource Manager, select the task flow in which you want to add the data control, then from the Edit menu, select Edit to open the task flow in Oracle Composer.

2. Click Add Content in the container in which you want to add the task flow.

3. In the Add Content dialog, navigate to the section of the Resource Catalog that contains runtime data controls.

Tip:

The location of data controls depends on the Resource Catalog used for editing pages. For example, in the default Resource Catalog, runtime data controls are present in the Data Controls subfolder, which is nested inside the Web Development folder and Mash Ups folder.

4. Click the Open link next to a data control name, for example DelayedStockQuoteDC, to display its contents.

5. Click the Add link next to the DelayedStockQuoteDC accessor. From the dropdown menu, select Form to display the Create Form dialog.

6. Click the Add link next to the operation, and select Form to display the Create Form dialog.

7. In the Create Form - Type page, select the desired type of form, for example, Form, as shown in Figure 26-19.

Figure 26-19 Create Form - Type

8. Select Include Submit Button to display a Submit button on the form. This option is enabled only if you are creating an editable form, because you must display a submit button if users are allowed to specify values or edit form data.

9. Select Include Navigation Controls to display First, Previous, Next, and Last buttons on the form. Navigation controls are helpful when multiple records are retrieved from the data source.

Note:

Navigation controls may not work properly if the data control provides bind parameters.

10. In the Create Form - Items page, from the Available Items box, select the items you wish to display in your form, then click Next.

11. In the Create Form - Fields page, define a label and form component (Figure 26-20) for each column, then click Next.

Figure 26-20 Create Form - Fields

12. In the Create Form - DC Parameters page, specify the parameter value to display data for that value, then click Create.

Note:

Ensure that you provide parameter values at this stage as you cannot specify them later.

Unlike a table or a graph, after you create a form, if you edit it in Composer, the Component Properties dialog does not display the Data panel. Therefore, you cannot modify parameter values for a form once it is created.

The new form looks like the one in Figure 26-21.

Figure 26-21 New Form in the Task Flow

When you add a Web Service data control as an editable form, you can edit data in the form and write the changes back to the Web Service data source by clicking the Submit button. However, you can update data only if the Web Service supports it by providing methods for creating, updating, and deleting records. For more information, see Section 26.4.7, "Writing to a Data Source from a Visualization."

The next step is to create task flow parameters and bind the task flow's parameters to the data control's parameters. When you consume such a task flow in a page, users can specify a value for the task flow parameter to view corresponding data in the form. For more information, see Section 26.4.2, "Creating Task Flow Parameters" and Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

26.4.1.3 Adding a Data Control as a Graph

To display data as a Graph:

1. Edit the task flow in Oracle Composer.

2. Click Add Content to display the Add Content dialog.

3. In the Add Content dialog, navigate to the section of the Resource Catalog that contains runtime data controls.

Tip:

The location of data controls depends on the Resource Catalog used for editing pages. For example, in the default Resource Catalog, runtime data controls are present in the Data Controls subfolder, which is nested inside the Web Development folder and Mash Ups folder.

4. Click the Open link next to the data control to display its accessor, operations, and methods associated with it.

5. Click the Add link next to the data control accessor or operation return. From the dropdown menu, select Graph (Figure 26-10), to display the Create Graph dialog.

6. In the Create Graph - Type page, select the desired type of form, for example, Bar, as shown in Figure 26-22, then click Next.

Figure 26-22 Create Graph - Type

7. In the Create Graph - Sub-Type page, select a subtype, for example Bar, as shown in Figure 26-23, then click Next.

Figure 26-23 Create Graph - Sub-Type

8. In the Create Graph - Layout page, select a suitable layout, then click Next.

9. In the Create Graph - Items page, from the Available Items box, select the items you wish to display in your graph, then click Next.

10. In the Create Graph - Placement page, select the appropriate placement, as shown in Figure 26-24, then click Next.

Figure 26-24 Create Graph - Placement

11. In the Create Graph - Format page, define titles and labels for each graph item, then click Next.

12. In the Create Graph - DC Parameters page, specify the parameter value to display data for that value, then click Create. The new graph looks like Figure 26-25.

Figure 26-25 New Graph in the Task Flow

For information about formatting a graph and customizing it further, see Section 26.4.6.3, "Customizing a Graph."

The next step is to create task flow parameters and bind the task flow's parameters to the data control's parameters. When you consume such a task flow in a page, users can specify a value for the task flow parameter to view corresponding data in the graph. For more information, see Section 26.4.2, "Creating Task Flow Parameters" and Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

26.4.2 Creating Task Flow Parameters

Task flow parameters enable you to view specific content in the task flow by providing different values for the parameter. When you add a data control inside a task flow, you can wire the task flow parameter to the data control parameter so that the data control displays data based on the task flow parameter you specify. For example, if your task flow contains a data control displaying the top five page hits in a given Space, and the data control provides a spacename bind variable, you can create a corresponding spacename parameter on the task flow. When a user edits the task flow and specifies a Space name, the data control displays the top five page hits in that Space.

To create task flow parameters:

1. Select the task flow on the Resources - Task Flows page and choose Edit from the Edit menu.

The task flow opens in Oracle Composer.

2. Click the Task Flow Properties button.

3. In the Taskflow Properties dialog, click Create to display the parameter table, shown in Figure 26-26.

Figure 26-26 Taskflow Properties Dialog

4. Enter a name, type, and storage value for the new parameter.

The storage value identifies the scope for the parameter. It specifies the location for storing the parameter value. Out-of-the-box, you are provided with four storage options, as described in Table 26-3. However, you can specify any custom storage by providing the EL value.

Table 26-3 Storage Values

Name

Description

pageFlowScope

The value is available to all instances of the task flow on the page.

viewScope

The value is available only to the selected instance, for the current user.

applicationScope

The value is available to all instances of the task flow within the application or across applications.

sessionScope

The value is available only to the current user, for the current session.

5. Click OK.

26.4.3 Binding Data Control Parameters to Task Flow Parameters

Data control parameters are used to restrict the data displayed in the data control based on the criteria you specify; for example, if you have a data control that displays page hits in your WebCenter Spaces application, you can create a spacename bind variable to limit the data retrieved to a given Space only. What's more, you can add the data control inside a task flow and bind the data control parameter to a task flow parameter, which can be used to control the data displayed in the data control. As page and task flow designers can edit task flow parameters, you are allowing them to control what is displayed in the data control.

Note:

If you do not want to use task flow parameters or if a data control is added directly on a page, you can wire the data control's parameters to input text components on the page. This type of wiring is similar for pages and task flows. For more information, see Section 26.4.4, "Wiring a Data Control to a Parameter Form Task Flow."

This section describes, with an example, how to bind a task flow parameter to a data control parameter. Before performing the steps in this section, ensure that you have added the data control inside a task flow and created the required task flow parameters. For more information, see Section 26.4.1, "Consuming a Data Control in a Task Flow" and Section 26.4.2, "Creating Task Flow Parameters."

To bind a task flow parameter to a data control parameter, spacename:

1. Click the Task Flow Properties button on the Oracle Composer toolbar to open the Task Flow Properties dialog.

2. Select the parameter that you want to bind to a data control parameter, copy its storage value, then close the dialog.

3. Click the Edit icon on the table or graph to open the Component Properties dialog.

4. On the Data tab, shown in Figure 26-27, select a data control parameter and paste the storage value in the field next to the parameter name, for example, #{pageFlowScope.spacename}.

Figure 26-27 Data Panel in the Component Properties Dialog for a Table

The data control now displays data specific to the task flow parameter value.

For a SQL data control, if there is no initial value defined for the task flow parameter, the data control retrieves data specific to the initial value of the bind parameter.

However, if you are using a Web Service data control for which you have not defined a parameter value, you must set an initial value for the task flow parameter. If not, the task flow displays an empty visualization (table, form, or graph). Therefore, in the Data tab for a Web Service data control, you must pass an initial value for the task flow parameter as shown in the following example:

#{empty pageFlowScope.stock_Quote ? 'ORCL' : pageFlowScope.stock_Quote}

See Also:

Section 26.2.2, "Creating a Web Service Data Control"

5. Click OK.

6. Click Close to exit Oracle Composer.

When you consume this task flow on a page, the data control displays data specific to the task flow parameter value. For more information, see Section 26.4.5, "Consuming Task Flows that Contain Visualizations."

To get a better idea about building mashups, see the different examples in Appendix C, "Business Mashup Examples."

26.4.4 Wiring a Data Control to a Parameter Form Task Flow

If you added a data control as a table inside a task flow, and if the task flow is based on the Parameter Form mashup style, then you can wire the input text field in the parameter form task flow to a data control parameter so that the table displays records based on the value provided in the input text field.

To wire the input text field to a data control parameter:

1. Edit the Parameter Form task flow in Oracle Composer.

2. Switch to Source view of the task flow.

3. Select Input Text in the component structure and click Edit on the toolbar.

4. Optionally, specify a suitable label for the field, for example, use Department if your task flow contains an employee details table and the data control has a bind parameter for the department ID.

5. From the Value field, copy the value, #{pageFlowScope.bindVarId} (Figure 26-28), and switch back to Design view.

Figure 26-28 Parameter Form Input Text Field Value

6. Click the Edit icon on the table.

7. In the Component Properties dialog for the table, click the Data tab.

8. Select the parameter that you want to bind to the Parameter Form's Input Text component and paste the #{pageFlowScope.bindVarId} value for that parameter, as shown in Figure 26-29.

Figure 26-29 Data Control Bind Variable

9. Click OK.

The wiring is effective immediately. You can specify a value in the input text field to view the corresponding records in the table, as shown in Figure 26-30.

Figure 26-30 Data Control in a Parameter Form Task Flow

You can find another example for this in Section C.2, "Creating a Mashup that Displays Employee Data from SQL Data Control."

26.4.5 Consuming Task Flows that Contain Visualizations

To add the task flow to a page where the visualization is displayed to users:

1. Edit the business role page in which you want to add the task flow.

2. In Oracle Composer, click Add Content in the container in which you want to add the mashup.

3. In the Add Content dialog, navigate to the section of the Resource Catalog that contains task flows created at runtime.

Tip:

The location of task flows depends on the Resource Catalog used for editing pages. For example, in the default Resource Catalog, task flows are present in the Mashups folder.

4. Select a task flow and click Add.

5. Click Close.

The page displays the mashup with the visualization. If the data control parameters are bound to the task flow parameters, the task flow parameters drive the data that is displayed.

See Also:

Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters"

6. To view data for different parameter values:

1. Select the mashup on the page and click Edit to view its properties.

2. On the Parameters tab in the task flow properties dialog, change the values for any exposed parameters, then click OK.

26.4.6 Editing Visualizations

The Resource Manager provides different options to modify data control parameter values. In addition, you can modify the visualizations that are created by adding data controls to task flows as tables, graphs, forms, or command buttons and links. This section describes the different editing tasks that you can perform on data visualizations. It includes the following subsections:

- Section 26.4.6.1, "Editing Parameter Values for a Data Control Visualization"

- Section 26.4.6.2, "Customizing a Table"

- Section 26.4.6.3, "Customizing a Graph"

26.4.6.1 Editing Parameter Values for a Data Control Visualization

If a data control provides bind variables or parameters, and you consume the data control in a page or task flow, you can use the parameter values to control the display of data in the visualization.

You can change values for a data control's parameters after the data control is consumed in a page or task flow. However, for a SQL data control, you can also change the values in the Edit Data Control wizard. This section describes how to edit parameter values for SQL and Web Services data controls.

Editing Parameter Values for SQL Data Controls

You can edit SQL data control parameters in either of the following ways:

- Edit the data control directly by selecting it on the Resource Manager - Data Controls page.

- Edit the data control in the consuming task flow, from the Resource Manager - Task Flows page.

To edit parameters directly on the data control:

1. On the Resource Manager - Data Controls page, select the data control whose parameters you want to modify.

2. From the Edit menu, select Edit.

3. In the Edit dialog, click Enter bind parameter values.

4. In the resulting Enter bind parameter values dialog, modify values for any of the listed parameters.

5. Click OK.

6. Click OK to exit the Edit dialog.

The table, form, or graph now displays data specific to the parameter values you provided.

To edit data control parameters through the consuming task flow:

1. On the Resource Manager - Task Flows page, select the task flow containing the data control you want to edit.

2. From the Edit menu, select Edit.

3. In Oracle Composer, click the Edit icon on the header of the visualization (table or graph).

4. In the Component Properties dialog displayed for the task flow, click the Data tab.

5. Modify values for any of the listed data control parameters.

6. Click OK.

7. Click Save, then Close to exit Oracle Composer.

The table or graph now displays data specific to the parameter values you provided.

Editing Parameter Values for Web Service Data Controls

Unlike SQL data controls that allow you to expose any number of bind parameters, for Web Service data controls, you can only specify values for the parameters already exposed by the Web Service method. The Edit dialog for a Web Service data control does not provide options to specify or modify parameter values. You can specify parameter values only after adding the data control inside a page or task flow.

To specify parameter values for a Web Service data control:

1. On the Resource Manager - Task Flows page, select the task flow containing the data control you want to edit.

2. From the Edit menu, select Edit.

3. In Oracle Composer, click the Edit icon on the header of the visualization (table or graph).

4. In the Component Properties dialog, click the Data tab.

The Data tab lists all parameters exposed by the Web Service method.

5. Modify values for any of the listed data control parameters.

6. Click OK.

7. Click Save, then Close to exit Oracle Composer.

The table or graph now displays data specific to the parameter values you provided.

26.4.6.2 Customizing a Table

You can customize a table in the following ways:

- Sort columns: If you enabled column sorting while creating the table, the column headers display Up and Down arrows, which you can use to sort the contents either in ascending or descending order.

- Reorder columns: Edit the task flow in Oracle Composer. Click the Edit icon on the table to open the Component Properties dialog. On the Child Components tab, use the Up and Down arrows on the right to reorder table columns.

- Hide or show columns: Edit the task flow in Oracle Composer. Click the Edit icon on the table to open the Component Properties dialog. On the Child Components tab, clear the checkbox to the left of a column name to hide it. By default all columns are displayed in the table.

Adding a Column to a Table

When you add a data control as a table, the table displays only those data columns that you selected in the Create Table dialog. However, the data control retrieves all the columns that you specified in your SQL query. These columns are just not rendered in the table. To display an additional column in the table, all you need to do is edit the source of the task flow, find the hidden column, and set its rendered attribute to true.

Notes:

- You can edit the source only if the task flow or underlying mashup style was created at runtime.

- You cannot display additional columns if the table was added to a page directly as you cannot edit the source of a page.

To display an additional column in a table:

1. On the Resource Manger - Task Flows page, select the task flow with the table.

2. From the Edit menu, select Edit Source.

Note:

To ensure that you do not end up with an invalid task flow that does not render properly, edit the source code very carefully.

3. Click the Fragment tab.

4. Select the column that you want to display in the table and set the rendered attribute to true.

The following example shows the source code for a table column:

<column sortProperty="MGR" filterable="true" sortable="true"
headerText="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.label}"
id="column4" rendered="true">
<af:inputText value="#{row.bindings.MGR.inputValue}"
label="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.label}"
required="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.mandatory}"
columns="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.displayWidth}"
maximumLength="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.precision}"
shortDesc="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.tooltip}"
id="inputText4">
<f:validator binding="#{row.bindings.MGR.validator}"/>
<af:convertNumber groupingUsed="false" pattern="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.format}"
id="convertNumber3"/>
</af:inputText>
</column>

5. Click OK to save the changes.

If you want to customize the table further, you can edit the table's properties and modify attributes such as row selection, grid lines, column groups, editable cells, column stretching, and column reordering. For more information about formatting tables, see the section titled "Displaying Data in Tables" in Oracle Fusion Middleware Web User Interface Developer's Guide for Oracle Application Development Framework.

26.4.6.3 Customizing a Graph

You can edit a graph and modify its display attributes in the Component Properties dialog. For more information about formatting graphs, see the section titled "Using ADF Graph Components" in Oracle Fusion Middleware Web User Interface Developer's Guide for Oracle Application Development Framework

26.4.7 Writing to a Data Source from a Visualization

When you add a data control as an editable table or form, you can update the records in the table or form and write those values back to the data source. However, you can update records only if the following is true:

- The data control is created for a Web Services data source that supports updating, and the insert or update operation is exposed through the published Web Service end-point.

- For editable tables only - the data control is a BC4J-based SQL data control created at design time. SQL data controls created at runtime do not support editing of data in a table.

You can add the data control's accessor as a table inside a task flow and add the update method so that changes made to the table can be saved to the data source.

If a Web Service supports updating, then the Web Service data control may provide methods to query and update records. Further, to enable multiple records to be updated simultaneously, Web Service data controls created at runtime provide array parameters. You can wire an array parameter to multiple input fields in the task flow so that the values specified in the fields are passed to the data source in one go. This section describes the high-level steps to use the query and update methods from a Web Service data control. It contains the following sections:

- Section 26.4.7.1, "Querying the Data Source"

- Section 26.4.7.2, "Updating Records in the Data Source"

For an end-to-end example showing how to query and update a data source, see Section C.5, "Creating a Mashup with Data from a Siebel Data Source."

To perform the steps in this section, you must have created a Web Service data control, which provides methods to query and update data, and consumed the data control's accessor as a table inside a task flow. For the detailed steps, see Section 26.2.2, "Creating a Web Service Data Control" and Section 26.4.1, "Consuming a Data Control in a Task Flow."

26.4.7.1 Querying the Data Source

To add a query option to a task flow displaying records from a database:

1. On the Resource Manger - Task Flows page, select the task flow containing the Web Service data control.

2. From the Edit menu, select Edit.

3. Click Add Content in the container that has the table.

4. In the Add Content dialog, navigate to the Web Service data control and click Open.

5. Locate the method available for querying the data source, and click Add. You can add the method as a button or link of your choice.

The query method in this example takes only one parameter, which is already defined when you add the data control's accessor to the task flow. As a result, the query option added to the task flow is automatically wired to the task flow parameter. However,

The task flow displays the query option, as shown in Figure 26-31.

Figure 26-31 Query Button and Table Inside a Parameter Form Task Flow

You can specify a task flow parameter value and click the query button or link to the relevant records.

26.4.7.2 Updating Records in the Data Source

To add an update option to a task flow displaying records from a database:

1. Open the task flow containing the data visualization.

2. In the Resource Catalog, locate the method available for updating the data source, and add it to the task flow. You can add the method as a button or link of your choice.

Note:

Methods to insert or update records are available only if the Web Service supports updating and the data control was added as an editable table or form.

Typically, an insert or update the method expects values for exposed parameters, based on which it performs the operation. Therefore, the next step is to provide UI elements to specify values for parameters.

3. Add input text components to specify the method parameter values.

Tip:

As the Resource Catalog does not provide ADF Faces components such as Input Text out-of-the-box, edit the task flow's source files and add the code for such components.

4. Wire the update method's parameters to the input text components value attributes. This involves:

- Setting an input text component's value attribute using the format: #{pageFlowScope.COLUMN_NAME}.

- Referencing the same location, #{pageFlowScope.COLUMN_NAME}, from the method's parameter. You can set this by selecting the button or link in Oracle Composer Source view, editing its properties, and specifying the value on the Data tab.

When you specify values in the input fields and click the update method's button or link, the values are passed back as Web Service parameter values.

For an end-to-end example showing how to query and update a data source, see Section C.5, "Creating a Mashup with Data from a Siebel Data Source."

26.5 Business Mashup Examples

To help you understand better the tasks involved in creating business mashups, Appendix C, "Business Mashup Examples" describes many use cases that illustrate how to create different types of mashups.

In addition, sample applications developed to showcase the different mashup building capabilities are published on Oracle Technology Network (OTN). The following page on OTN provides links to business mashup-specific samples and other sample applications that illustrate the different WebCenter Spaces capabilities:

http://www.oracle.com/technetwork/middleware/webcenter/ps3-samples-176806.html

A readme file available with each sample on this page describes what the application illustrates and provides guidance for extending or customizing the application for real life use cases.

27 Working with OmniPortlet

This chapter provides an overview of OmniPortlet and explains the user interface elements associated with OmniPortlet. This chapter contains the following sections:

- Section 27.1, "What You Should Know About OmniPortlet"

- Section 27.2, "Working with the OmniPortlet Wizard"

- Section 27.3, "Working with OmniPortlet Parameters"

- Section 27.4, "Setting OmniPortlet Properties"

- Section 27.5, "Troubleshooting OmniPortlet"

For information regarding troubleshooting OmniPortlet, see Section 27.5, "Troubleshooting OmniPortlet."

Audience

This chapter is intended for users who want to understand OmniPortlet and learn how to use its features. It introduces how to customize OmniPortlet at runtime and in Spaces, in addition to troubleshooting issues with OmniPortlet.

27.1 What You Should Know About OmniPortlet

OmniPortlet is a subcomponent of Oracle WebCenter Framework that enables developers to easily publish data from various data sources using a variety of layouts without writing any code. You can base an OmniPortlet on almost any kind of data source, including Web services, SQL databases, spreadsheets (that is, files with character-separated values), XML, and even application data from existing Web pages.

Note:

If your data source is a spreadsheet, the spreadsheet must be unsecured or must require only HTTP authentication; SSO authentication is not supported.

Additionally, OmniPortlet enables developers to:

- Sort the data to display

- Format data using a variety of layouts, including a customized layout

- Use portlet parameters

- Expose personalizable settings to page viewers

To display personalized data, you can refine the results returned from a data source and parameterize the credential information used to access secure data. Out of the box, OmniPortlet provides the most common layout for portlets: tabular, chart, news, bulleted list, form, HTML, and parameter form.

Notes:

For more information about developing different types of portlets and information about producers and other portlet technologies, see Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

For more information about adding an instance of OmniPortlet to a page, see Section 27.2.1, "Adding an OmniPortlet Instance to a Page."

27.2 Working with the OmniPortlet Wizard

This section includes the following subsections:

- Section 27.2.1, "Adding an OmniPortlet Instance to a Page"

- Section 27.2.2, "Accessing the OmniPortlet Wizard"

- Section 27.2.3, "Selecting the Data Source Type"

- Section 27.2.4, "Identifying the Data Source"

- Section 27.2.5, "Setting Filtering Options"

- Section 27.2.6, "Setting View Options"

- Section 27.2.7, "Setting Layout Options"

- Section 27.2.8, "Customizing Your OmniPortlet"

27.2.1 Adding an OmniPortlet Instance to a Page

The steps for adding an instance of OmniPortlet to a page vary between a custom WebCenter portal application and the WebCenter Spaces application. For one thing, in a custom WebCenter portal application adding a portlet to a page is a design-time activity, carried out by the application developer. For information about adding OmniPortlet to a page in a custom WebCenter portal application, see the “Creating Portlets with OmniPortlet” chapter in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

In WebCenter Spaces, portlets are added to pages at runtime—when you run the application. Portlets are available for dragging and dropping from the Oracle Composer Catalog by any user with sufficient privileges. For information about adding a portlet to a page in WebCenter Spaces, see Section 17.5, "Adding Resource Catalog Components to Pages."

Note:

In WebCenter Spaces, avoid adding a portlet to a Movable Box layout component (For information, see Section 18.2.3, "Working with the Movable Box Layout Component"). The Movable Box layout component duplicates the showDetailFrame that the portlet provides by default. Adding a portlet to a Movable Box creates an unnecessary and potentially error-prone redundancy.

When you add an instance of OmniPortlet to a page, access the portlet's Component Properties dialog and ensure that the RenderPortletInIFrame property is set to true. This displays the OmniPortlet in its own inline frame (IFRAME) in View mode.

For information about the Component Properties dialog, see Section 27.4, "Setting OmniPortlet Properties."

27.2.2 Accessing the OmniPortlet Wizard

Once you add an instance of OmniPortlet to your page, click the Customize link to start the OmniPortlet wizard.

The OmniPortlet wizard initially contains five steps:

1. Select a data source type.

2. Identify the data source.

Note:

If your data source is a spreadsheet, the spreadsheet must be unsecured or must require only HTTP authentication; SSO authentication is not supported.

3. Set filtering options.

4. Set view options.

5. Set layout options.

Once you complete these steps, you are done. If you want to change your initial values, you can reenter the wizard by selecting the Customize option from the portlet's Actions menu. Tabs representing the steps you took to set up OmniPortlet display. Although the data type cannot be changed, you can revise values on the Source, Filter, View, and Layout tabs.

Table 27-1 provides a high-level overview of the steps/tabs provided for configuring an OmniPortlet instance.

Table 27-1 OmniPortlet Wizard and Customize Mode

Step/Tab

Description

Type

Provides your data source options. Displays only in the initial definition of the portlet, and is not available when customizing the portlet defaults. For more information, see Section 27.2.3, "Selecting the Data Source Type."

Source

Provides options for configuring the data source connection, such as the URL of the Web Service you want to use. You can change these options later when editing the portlet defaults. For more information, see Section 27.2.4, "Identifying the Data Source."

Filter

Provides sorting options at the WebCenter portal application level to enable you to refine your results. You can change these options later when editing the portlet defaults. For more information, see Section 27.2.5, "Setting Filtering Options."

View

Provides options for displaying portlet header and footer text, the layout style, and caching. You can change these options later when editing the portlet defaults. For more information, see Section 27.2.6, "Setting View Options."

Layout

Provides detailed options for customizing the layout of content retrieved from the data source. You can change these options later when editing the portlet defaults. For more information, see Section 27.2.7, "Setting Layout Options."

Note:

On the IBM Linux on Power platform, if the action buttons (Next, Previous, Finish, and Cancel) are minimized to dots when defining the OmniPortlet, increase the stack size shell limit to unlimited and restart the oc4j_portlet instance. Run the following command to set the stack size shell limit to unlimited: prompt> ulimit -s unlimited.

The following sections provide more detail about the different steps/tabs in the OmniPortlet wizard.

27.2.3 Selecting the Data Source Type

When you first start OmniPortlet, the Type step displays (Figure 27-1).

Figure 27-1 Type Tab of the OmniPortlet Wizard

Use the Type step to identify the type of data to display in your OmniPortlet instance. Table 27-2 lists and describes the data types that OmniPortlet supports out of the box.

Table 27-2 OmniPortlet Supported Data Source Types

Data Source Type

Description

Spreadsheet

Displays data from a text file containing character-separated values (CSV).

Note: If your data source is a spreadsheet, the spreadsheet must be unsecured or must require only HTTP authentication; SSO authentication is not supported.

SQL

Displays data from a database using SQL.

XML

Displays data from an XML file.

Web Service

Displays data from a discrete business service that can be accessed over the Internet using standard protocols.

Web Page

Displays data based on existing Web content.

After you complete the OmniPortlet wizard, you cannot change the data source type.

27.2.4 Identifying the Data Source

Once you choose a data type, you are ready to identify a data source. The Source tab renders according to the data type you selected in step 1. That is, the options that display on the Source tab vary according to the selected data type.

Additionally, if the OmniPortlet producer has been configured to use a proxy server requiring authentication, the Source tab contains a Proxy Authentication section and a Connection section where you can provide the necessary information for connecting to the data source.

This section contains information about the settings common to all Source tabs, including settings specific to the selected data type. It contains the following subsections:

- Section 27.2.4.1, "Proxy Authentication"

- Section 27.2.4.2, "Connection and Portlet Parameters"

- Section 27.2.4.3, "Spreadsheet"

- Section 27.2.4.4, "SQL"

- Section 27.2.4.5, "XML"

- Section 27.2.4.6, "Web Service"

- Section 27.2.4.7, "Web Page"

27.2.4.1 Proxy Authentication

If the OmniPortlet producer was set up at design time to use proxy authentication that requires login credentials, then a Proxy Authentication section displays on the Source tab where you can enter this information.

OmniPortlet's support for proxy authentication includes support for global proxy authentication and authentication for each user, which means you can specify a login scenario for your OmniPortlet instance:

- All users automatically log in using a user name and password you provide.

- Each user logs in using an individual user name and password.

- All users log in using the same specified user name and password.

The Proxy Authentication section displays only for the following data types, and only when the specific data source requires a proxy server for access:

- CSV (character-separated values)

- XML

- Web Page

Notes:

Configuring an OmniPortlet producer is a design-time activity applicable to custom applications (that is, those applications created with Oracle WebCenter Framework). For more information about configuring the OmniPortlet producer to use proxy authentication, see the Oracle WebCenter Framework online Help topic that displays when you click Help on the Edit Producers: OmniPortlet Producer page.

If the OmniPortlet producer is configured to require login for all users, then each user must set his or her own proxy login information at runtime as follows:

- For page designers, set this on the Customize: Source tab.

- For page viewers, set this on the Personalize page.

To access the Customize: Source tab, click the Customize link on the portlet's Actions menu. To access the Personalize page, click the Personalize link on the portlet's Actions menu.

If you are using the Web Page data source, then the Proxy Authentication section displays in the Web Clipping Studio when you click the Select Web Page button on the Source tab.

For more information about Web Clipping Studio, see Chapter 28, "Working with the Web Clipping Portlet."

27.2.4.2 Connection and Portlet Parameters

For each data source—except the Web Page data source—the Source step contains a Connection section, where you can define connection information for accessing secured data. The Source step for all data sources includes a Portlet Parameters section, where you can define portlet parameters (Figure 27-2).

Figure 27-2 Source Tab: Connection and Portlet Parameters Sections

Note:

You can use the format ##ParamN## (for example, ##Param1##) for Username, Password, or Connection String. The Test button returns an error, however, even though the connection information is correct when parameter values are substituted.

Once you define the portlet parameters, you can map them to page parameters. For more information, see Section 27.3, "Working with OmniPortlet Parameters" and Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

To edit the connection information, click the Edit Connection button to open the Connection Information page (Figure 27-3).

Figure 27-3 OmniPortlet Connection Information Page for a SQL Data Source

On the Connection Information page, you can enter a name for the connection information, and also the user name and password. For a SQL data source, you can also enter information to specify the driver you want to use to connect to the data source. For more information, see Section 27.2.4.4, "SQL."

Note:

For more information about the Connection Information page, click Help on the Source tab of the OmniPortlet wizard.

27.2.4.3 Spreadsheet

Spreadsheets are a common method of storing small data sets. OmniPortlet enables you to share spreadsheets by supporting character-separated values (CSV) as a data source. Use the Source tab to specify the location of the CSV file (Figure 27-4).

Figure 27-4 Source Tab: Spreadsheet (CSV)

If the file is located on a secure server, then you can specify the connection information in the Connection Information section illustrated in Figure 27-3. You can select the character set to use when WebCenter Suite reads the file, and also the delimiter and text qualifier.

Note:

- As the OmniPortlet producer exists and executes in a tier different from the WebCenter portal application and does not have access to the session information, you must expose CSV files as PUBLIC for OmniPortlet to be able to access them.

- The CSV file must be unsecured or must require only HTTP authentication; SSO authentication is not supported.

27.2.4.4 SQL

A relational database is the most common place to store data. OmniPortlet enables you to use standard JDBC drivers and provides out-of-the-box access to Oracle and any other JDBC database. You can specify the driver type when you configure the connection information.

Figure 27-5 shows the Source tab for a SQL data source.

Figure 27-5 Source Tab: SQL

You can use DataDirect JDBC drivers to access other relational databases. To do so, you must configure OmniPortlet to recognize the driver. This is a design-time activity, typically carried out by an application developer.

Notes:

For information about configuring OmniPortlet to use DataDirect drivers, see Appendix E, “Additional Portlet Configuration” in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

For more information about DataDirect drivers, see the Certification Matrix for Oracle Application Server and DataDirect JDBC on the Oracle Technology Network (OTN) at http://www.oracle.com/technetwork.

Once the driver is installed, it displays in the Driver Name dropdown list on the Connection Information page (Figure 27-6).

Figure 27-6 Driver Name Dropdown List on the Connection information Page

When you enter a connection string for a DataDirect driver, keep in mind that you must enter a value in the Connection String field using the syntax: host_name:port. The host_name is the name of the server where the database is running. The port is the database's listening port.

27.2.4.5 XML

You can access XML data sources across an intranet or the Internet. On the Source tab, you can specify the URL of the XML file that contains your data (Figure 27-7).

Figure 27-7 Source Tab: XML

Use the Test buttons next to the XML URL and the XSL Filter URL fields to validate your XML data source and the XSL filter.

The specified XML file can be in a tabular (ROWSET/ROW) structure, or you can provide an XML Style Sheet (XSL) that transforms data into the ROWSET/ROW structure. Example 27-1 provides an illustration of the ROWSET/ROW structure of an XML data source.

Example 27-1 ROWSET/ROW Structure of an XML Data Source

<TEAM>
<EMPLOYEE>
<DEPTNO>10</DEPTNO>
<ENAME>KING</ENAME>
<JOB>PRESIDENT</JOB>
<SAL>5000</SAL>
</EMPLOYEE>
<DEPTNO>20</DEPTNO>
<ENAME>SCOTT</ENAME>
<JOB>ANALYST</JOB>
<SAL>3000</SAL>
<EMPLOYEE>
</TEAM>

In Example 27-1, the <TEAM> tags delineate the rowset, and the <EMPLOYEE> tags delineate the rows.

Regardless of the format of the XML file, OmniPortlet automatically inspects the XML to determine the column names, which are then used to define the layout. If you want to specify this information yourself, you can supply a URL to an XML schema that describes the data.

If the XML file is located on a secured server protected by HTTP Basic Authentication, you can specify connection information on the Connection Information page.

Note:

Because the OmniPortlet producer exists and executes in a tier different from the WebCenter portal application and does not have access to the session information, you must expose XML files as PUBLIC in order for OmniPortlet to access them.

27.2.4.6 Web Service

A Web Service is a discrete business service that can be programmatically accessed over the Internet using standard protocols, such as SOAP and HTTP. Web Services are specific to neither platform nor language and are typically registered with a Web Service broker. When you find a Web Service you want to use, you must obtain the URL to the Web Service Description Language (WSDL) file. The WSDL file describes the Web Service and specifies the methods that can be called, including the expected parameters. It also describes the returned data.

OmniPortlet supports both types of Web Services: Document and Remote Procedure Calls (RPC). After a WSDL document/file is supplied, it is parsed, and the available methods that can be called display on the Source tab.

Similar to the XML data source, OmniPortlet expects the Web Service data in ROWSET/ROW format, though you can also use an XSL file to transform the data. OmniPortlet inspects the WSDL document/file to determine the column names, though you may also specify an XML schema to describe the returned data set.

Figure 27-8 shows the Source tab for a sample Web service.

Figure 27-8 Source Tab: Web Service

27.2.4.7 Web Page

OmniPortlet enables you to use existing Web content as a data source. It integrates the Web Clipping portlet's Web Clipping Studio to provide a means of clipping and rendering Web content within the context of an OmniPortlet instance.

OmniPortlet's Web Page data source extends the scope offered by the Web Clipping portlet to include scraping functionality. Additional features include:

- Navigation through various login mechanisms, including form- and JavaScript-based submission, and HTTP Basic and Digest Authentication with cookie-based session management.

- Fuzzy matching of clippings. If a Web clipping gets reordered within the source page or if its character font, size, or style changes, then it is still identified correctly by the Web page data source and delivered as the portlet content.

- Reuse of a wide range of Web content, including basic support of pages written with HTML 4.0.1 and JavaScript, retrieved through HTTP GET and POST (form submission).

By default, all Web clipping definitions are stored persistently in Oracle Metadata Services (MDS). However, you can also use an Oracle database. Using MDS does not require any changes in the configuration files. If you use an Oracle database as the Web Clipping repository, then at design time you must update the provider.xml file.Any secure information, such as passwords, is stored in encrypted form, according to the Data Encryption Standard (DES), using Oracle Database encryption technology.

When Web Page is selected as the data type, the OmniPortlet wizard's Source tab (Figure 27-9) includes a Select Web Page button that launches Web Clipping Studio.

Figure 27-9 Source Tab: Web Page

Within Web Clipping Studio, the Oracle Application Server Web Clipping online Help becomes available through the Help icon at the top of the page. You can use the Help to navigate your way through the process of sectioning and saving Web content.

Note:

For more information about using the Web Clipping Studio or clipping content for a Web Clipping Portlet, see Chapter 28, "Working with the Web Clipping Portlet."

27.2.5 Setting Filtering Options

Once you have selected the data source and specified the data source options, you can further refine your data using OmniPortlet's filtering options. To use filtering efficiently, it is better to refine the data as much as possible at the data source level on the Source tab, then use the options on the Filter tab to streamline the data. For example, if you are using a SQL data source, then you could use a WHERE clause to return only specific data from the specified columns. In this case, you could skip the Filter tab and continue to the wizard's View tab. However, if there are no filtering options at the data source level, then you can use the options on the Filter tab to sort your data (Figure 27-10).

Figure 27-10 Filter Tab

27.2.6 Setting View Options

Once you have specified and filtered the data, you are ready to choose view and layout options for your OmniPortlet. The View tab (Figure 27-11) provides options for adding header and footer text, enabling caching, and choosing a layout style that you can later refine on the Layout tab.

Figure 27-11 View Tab

On the View tab, you can choose from the following layouts:

- Tabular

- Chart

- News

- Bullet

- Form

- HTML

- Parameter Form

Note:

For more information about the different layout styles you can use with OmniPortlet, see the next section or click Help in the OmniPortlet wizard.

27.2.7 Setting Layout Options

The Layout tab enables you to further customize the appearance of your OmniPortlet. The options on the Layout tab change according to your selection on the View tab. For example, when you select Chart Layout, options are provided for setting up chart hyperlinks. With chart hyperlinks, clicking a specific part of the chart triggers an event (for example, navigation to another URL).

For the other layout styles, you can define each column to display in a specific format, such as plain text, HTML, an image, a button, or a field. For example, suppose you selected a data source that includes a URL to an image. To see this image, you can select Image for the display of this column. Each column can also be mapped to an action, similar to the behavior of chart hyperlinks.

This section includes the following subsections that provide more detail about the layout options available on the OmniPortlet Layout tab:

- Section 27.2.7.1, "Tabular Layout"

- Section 27.2.7.2, "Chart Layout"

- Section 27.2.7.3, "News Layout"

- Section 27.2.7.4, "Bullet Layout"

- Section 27.2.7.5, "Form Layout"

- Section 27.2.7.6, "HTML Layout"

- Section 27.2.7.7, "Parameter Form Layout"

Note:

Because events are not currently supported, selecting an action when designing your layout may produce unexpected results.

27.2.7.1 Tabular Layout

Typically, you use tabular layout when you have one or more columns of data to display in a table. You can choose Plain to display all rows in the table without any background color, or Alternating to display a background color for every other row in the table (Figure 27-12).

Figure 27-12 Layout Tab: Tabular

Note:

You can control the background color of a portlet using its style properties. Portlet style properties are exposed through the Properties panel in Oracle Composer. For more information, refer to Setting OmniPortlet Properties.

The Column Layout section provides options for selecting the data columns to display in the portlet and a display format. Additionally, you can associate a URL with a column to display column data as a hyperlink. You can also specify whether the secondary Web page displays in a new window. Figure 27-13 shows an example of an OmniPortlet using a tabular format.

Figure 27-13 Example of an OmniPortlet Using a Tabular Layout

Note:

For more information about using the OmniPortlet wizard, click the Help link on the Layout tab.

27.2.7.2 Chart Layout

Use the chart layout to display your data graphically, as a bar, pie, or line chart. The Layout tab (Figure 27-14) provides options for specifying the chart style to use (Chart Style) and the data source columns to display (Column Layout).

Figure 27-14 Layout Tab: Chart

Under the Column Layout section, you can choose the data source columns to use in the chart (Group); the values to use in creating the chart legend (Category); and the relative size of the chart's bars, lines, or pie slices (Value).

Note:

To group the information in the chart, you must group the information at the data level (for example, in your SQL query statement). Also, if numeric values in a data source contain formatted strings, commas, or currency (for example, $32,789.00), then they are considered to be text and ignored when the chart is generated. You should remove these formatting characters if you want them to be correctly read as numeric values.

You can also select whether the sections of the chart should point to a hyperlink and whether the link target should display in a new window.

You can define chart hyperlinks so that each bar, pie section, or line links to another Web page. For example, you can place a pie chart and a report portlet on your page, then set up hyperlinks on the pie wedges. Users click a wedge to display a row in the report with detailed information about the wedge data.

Figure 27-15 displays an example of a pie chart. In this example, the Category value DEPARTMENT is used as the chart legend.

Figure 27-15 Example of an OmniPortlet Using a Pie Chart Layout

27.2.7.3 News Layout

Use the News layout to display links to articles and brief article descriptions. You can use the News layout to publish information in standard XML formats, such as Resource Description Framework (RDF) or RSS (Really Simple Syndication).

Use the Column Layout section (Figure 27-16) to add a heading that displays at the top of the portlet, a logo, or a scrolling layout that enables users to view all the information in the portlet as it moves vertically.

Figure 27-16 Layout Tab: News

Note:

The OmniPortlet News Layout Scroll type is supported on Microsoft Internet Explorer and Netscape 7.0.

The Layout tab also provides options for associating a URL with column data. Users click column data in the portlet to navigate to your specified target location.

Figure 27-17 shows an example OmniPortlet using a News layout.

Figure 27-17 Example of an OmniPortlet Using a News Layout

Note:

For more information about using the OmniPortlet wizard, click the Help link on the Layout tab.

27.2.7.4 Bullet Layout

Use the Bullet layout to display your data in a bulleted or numbered list. The Layout tab (Figure 27-18) provides a variety of different bullet and numbering styles.

Figure 27-18 Layout Tab: Bullet

In the Column Layout section, you can choose how the columns display in the portlet and associate a URL with column data.

Figure 27-19 shows an example of an OmniPortlet using a Bullet layout.

Figure 27-19 Example of an OmniPortlet Using a Bullet Layout

Note:

For more information about using the OmniPortlet wizard, click the Help link in the Layout tab.

27.2.7.5 Form Layout

Figure 27-20 Layout Tab: Form

Use the Form layout when you want to display source data in a form with labeled fields, such as Name: <name>. You can then use portlet parameters to determine the data that displays.

Use the Column Label column to enter row labels and the Column column to specify which column to use from your data source. Additionally, you can specify data alignment, select a display mode (text, HTML, image, button, field, or hidden), associate a URL or an event with the column data, and specify whether to open the URL target in a new window.

Figure 27-21 shows an example of an OmniPortlet using a Form layout.

Figure 27-21 Example of an OmniPortlet Using a Form Layout

Note:

For more information about using the OmniPortlet wizard, click the Help link in the upper right corner of the Layout tab.

27.2.7.6 HTML Layout

Use the HTML layout to create a customized look and feel for your OmniPortlet content. The Layout tab (Figure 27-22) provides a means of selecting a built-in HTML layout and modifying the code, or creating a new layout.

Figure 27-22 Layout Tab: HTML

You can hand-code your own HTML or JavaScript based on data columns that OmniPortlet has retrieved from the selected data source. By coding your own HTML and JavaScript, you have full control over the portlet's appearance, enabling you to develop a rich portlet interface.

For more information about using the fields on the Layout tab, click the Help button in the wizard. For an example of using JavaScript in the HTML layout, choose the Sortable Table layout from the Quick Start dropdown list on this tab.

Note:

The maximum number of characters you can enter in each of the sections (Heading, Repeating, and Footer) is 30,000 (30k).

Figure 27-23 shows an example of an OmniPortlet using the HTML layout.

Figure 27-23 Example of an OmniPortlet Using the HTML Layout

27.2.7.7 Parameter Form Layout

Use the Parameter Form layout to create a customized parameter form for your OmniPortlet content. The Layout tab (Figure 27-22) provides a means of selecting a built-in parameter form layout and modifying the code, or creating a new layout.

Figure 27-24 Layout Tab: Parameter Form

You can hand-code your own parameter form based on data columns that OmniPortlet has retrieved from the selected data source. By coding your own parameter form, you have full control over the portlet's appearance, enabling you to develop a rich portlet interface. To do so, choose the Custom style option, then use the Custom HTML field to edit the parameter form (Figure 27-25).

Figure 27-25 Layout Tab: Parameter Form Custom HTML Field

For more information about using the fields on the Layout tab, click the Help button in the wizard.

27.2.8 Customizing Your OmniPortlet

After you have created your OmniPortlet and returned to your application, you can select the Customize option from the portlet's Actions menu to revise your original selections. When you revise a defined OmniPortlet, tabs correspond to the different steps originally presented in the OmniPortlet wizard. An exception to this is the Type step—you cannot change the originally selected data type, and so there is no corresponding Type tab.

When you revise an OmniPortlet using customize mode, keep in mind the following notes:

- Any modifications you make to your portlet using customize mode apply to all users, regardless of the current session language and the locale of the user's browser.

- You can personalize the portlet at runtime by clicking the Personalize link on the portlet or by selecting the Personalize option on the portlet's Action menu. Personalizing the portlet creates a copy of the personalization object. As all properties are duplicated, subsequently modifying the portlet through Customize mode does not affect the personalized version of the portlet. To ensure the latest customizations are made to the portlet, after you make modifications in Customize mode, you must click Personalize again, and then select the Reset to Defaults option.

- The personalization of OmniPortlet is stored in a file-preference store. For more information about configuring OmniPortlet and modifying the preference store, see Appendix E, “Additional Portlet Configuration” in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

27.3 Working with OmniPortlet Parameters

You can define up to five portlet parameters for an OmniPortlet. You can define parameters in the following screens:

- On the Source screen of the wizard when you define the OmniPortlet

- On the Source tab when you select Customize for a defined OmniPortlet

Figure 27-26 shows the Portlet Parameters section on the Source tab.

Figure 27-26 Source Tab: Portlet Parameters Section

If you select any of these portlet parameters to be personalizable (by selecting the Personalizable checkbox), you can set their values on the Personalize screen.

Note:

You can learn more about portlet parameters in the online Help, which you can access by clicking the Help link on the Source tab in the OmniPortlet wizard. The online Help describes portlet parameters in detail, and how to set them up for your OmniPortlet.

Once you have set up portlet parameters in your OmniPortlet, you can contextually map the portlet to other portlets or components on a page. For more information about doing so, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

27.4 Setting OmniPortlet Properties

OmniPortlet has associated properties that users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 27-27).

Figure 27-27 OmniPortlet Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Events service task flows and describe the properties on the Parameters tab:

- Section 27.4.1, "What You Should Know About OmniPortlet Properties"

- Section 27.4.2, "OmniPortlet Properties"

27.4.1 What You Should Know About OmniPortlet Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 27.4.2, "OmniPortlet Properties." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

27.4.2 OmniPortlet Properties

Table 27-3 describes the properties that are unique to OmniPortlet.

Table 27-3 OmniPortlet Component Properties

Property

Description

Location

Param#

Use to map page parameters to the parameters specified when the OmniPortlet was defined. These parameters enable you to contextually wire portlets and pages. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Parameters tab

All Modes Shared Screen

For OmniPortlet, set this property to false to ensure that all portlet modes, except Show, are rendered each on their own page. Setting this property to true may prevent you from editing certain sections of your OmniPortlet in the OmniPortlet wizard.

Display Options tab

Id

A unique identifier for the portlet instance.

Display Options tab

Partial Triggers

Use to initialize a partial page refresh, which is a way of refreshing an area of a page without having to redraw the entire page.

Display Options tab

Render Portlet In I Frame

Use to render the portlet in an inline frame (IFRAME), omit an IFRAME, or let the portlet decide. Valid values are:

- auto (default): The portlet tag checks the portlet response and decides if an IFRAME is required

- true: Render the portlet instance in an IFRAME

- false: Render the portlet instance inline

Placing a portlet inline on a page provides a better user experience as compared to placing it in an IFRAME. However, at times, it may be required to include a portlet in an IFRAME. For example:

- The portlet is a JSF portlet

- The portlet contains a file upload element

- The parser throws an exception because it is not able to parse the markup

Display Options tab

Title

Enter a title for the OmniPortlet, to display in the portlet header.

Display Options tab

27.5 Troubleshooting OmniPortlet

This section provides information to help you troubleshoot problems you may encounter while using OmniPortlet.

Cannot Define OmniPortlet Using the Customize Link

You are not able to define the OmniPortlet at runtime by using the Customize link.

Problem

OmniPortlet only supports a RenderPortletInIFrame value of true, which means that OmniPortlet must be rendered within an IFRAME and therefore, the OmniPortlet property, RenderPortletInIFrame, must be set to true. At design time, the RenderPortletInIFrame property is available in the Property Inspector under Display Options. At runtime, the RenderPortletInIFrame property is available on the Properties panel in Oracle Composer.

Solution

Currently, the RenderPortletInIFrame property has a value of false and, consequently, when you click the Define link at runtime, the Type tab may not display and you cannot proceed with defining the OmniPortlet.

You can choose Customize from the Action menu to define OmniPortlet, or, for custom WebCenter applications at design time, select the OmniPortlet in the Structure window in Oracle JDeveloper, and in the Property Inspector, set RenderPortletInIFrame to true.

28 Working with the Web Clipping Portlet

This chapter provides a brief description of the Web Clipping portlet and producer and explains how you can register a Web Clipping producer and use this producer to add a Web Clipping portlet to a JSP document created through Oracle JDeveloper.

This chapter includes the following sections:

- Section 28.1, "What You Should Know About Web Clipping"

- Section 28.2, "Working with the Web Clipping Portlet"

- Section 28.3, "Setting Web Clipping Portlet Properties"

- Section 28.4, "Current Limitations of Web Clipping"

- Section 28.5, "Troubleshooting Web Clipping"

28.1 What You Should Know About Web Clipping

Web Clipping is a publishing portlet that enables you to integrate any web application with your custom WebCenter portal application and with WebCenter Spaces. It is designed to give you quick integration by leveraging the existing user interface of the web application. With Web Clipping, you can consolidate content from web sites scattered throughout a large organization.

With Web Clipping, you can clip an entire web page, or a portion of it, and reuse it as a portlet. You can clip basic and HTML-form-based sites. Use Web Clipping when you want to copy content from an existing web page and expose it in your WebCenter portal application as a portlet.

Web Clipping supports the following features:

- Navigation through various styles of login mechanisms

Web Clipping supports various login mechanisms including form- and JavaScript-based submission and HTTP Basic and Digest Authentication with cookie-based session management.

- Fuzzy matching of clippings

Fuzzy matching enables the Web Clipping engine to correctly identify a web clipping and deliver it as portlet content even if the web clipping is reordered within the source page or if its character font, size, or style changes.

- Personalization

Personalization enables you to expose input parameters that end users can modify when they personalize the portlet. Parameters can be exposed as public parameters that you can map as page parameters. This feature enables end users to obtain personalized clippings.

- Integrated authenticated web content through single sign-on

You can use external applications and leverage Oracle Single Sign-On to clip content from authenticated external web sites.

- Inline rendering

Inline rendering enables you to set up Web Clipping portlets to display links within the context of the portlet. When a user clicks a link in the Web Clipping portlet, the results display within the same portlet. You can use this feature with internal and external web sites.

- Proxy authentication

Web Clipping supports proxy authentication, including global proxy authentication and authentication for each user. You can use this feature if proxy servers require authentication. You can specify proxy server authentication details, including type (Basic or Digest) and realm in the provider.xml file. In addition, you can specify a scheme for entering user credentials as follows:

- All users automatically log in using a user name and password that you provide.

- All users are required to log in using a user name and password that they provide.

- All public users (not authenticated into the WebCenter application) automatically log in using a user name and password that you provide, while valid users (authenticated into the WebCenter application) log in using a user name and password that they provide.

For more information, see the “HTTP or HTTPS Proxy Configuration” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

- Support for HTTPS

Web Clipping enables you to clip content from HTTPS-based external web sites if appropriate server certificates are acquired.

- Open Transport API

By default, the Web Clipping provider supports only HTTP challenge-based authentication methods, such as Basic and Digest and form submission logins. To support custom authentication methods, such as Kerberos proxy authentication, you can use the Web Clipping Transport API. For more information, see the “Using Web Clipping Open Transport API” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

- Reuse of a wide range of web content

Web Clipping provides basic support of pages written with JavaScript, applets, and plug-in enabled content, retrieved through HTTP GET and POST methods of form submission.

Web Clipping also supports clipping of content from pages written with HTML 4.01, including:

- Clipping of <applet>, <body>, <div>, <embed>, <img>, <object>, <ol>, <span>, <table>, and <ul> tagged content

- Preservation of <head> styles and fonts, and CSS

- Support for UTF-8 compliant character sets

- Navigation through hyperlinks (HTTP GET), form submissions (HTTP POST), frames, and URL redirection

- Globalization support

Web Clipping provides globalization support in URLs and URL parameters. For information about how Web Clipping determines the character set of clipped content, see Section 28.4, "Current Limitations of Web Clipping."

- Persistent storage of Web Clipping definitions

Web Clipping definitions are stored persistently in a repository. For information about Web Clipping repository, see the “Web Clipping Portlet Configuration Tips” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

- Encryption of secure information

Any secure information, such as passwords, is stored in an encrypted form, according to the Data Encryption Standard (DES), using Oracle encryption technology.

28.2 Working with the Web Clipping Portlet

This section describes how to clip content for a Web Clipping portlet and make the portlet personalizable. It includes the following subsections:

- Section 28.2.1, "Adding a Web Clipping Portlet to a Page"

- Section 28.2.2, "Clipping Content for Display in the Web Clipping Portlet"

- Section 28.2.3, "Adding a Web Clipping That Users Can Personalize"

28.2.1 Adding a Web Clipping Portlet to a Page

The steps for adding a Web Clipping portlet to a page vary between a custom WebCenter portal application and the WebCenter Spaces application. For one thing, in a custom WebCenter portal application adding a portlet to a page is a design-time activity, carried out by the application developer. For information about adding a portlet to a page in a custom WebCenter portal application, see the “Creating Content-Based Portlets with Web Clipping” chapter in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

In WebCenter Spaces, portlets are added to pages at runtime—when you run the application. Portlets are available for dragging and dropping from the Oracle Composer Catalog by any user with sufficient privileges. For information about adding a portlet to a page in WebCenter Spaces, see Section 17.5.1, "Adding a Component to a Page."

Note:

In WebCenter Spaces, avoid adding a portlet to a Movable Box layout component (For information, see Section 18.2.3, "Working with the Movable Box Layout Component"). The Movable Box layout component duplicates the showDetailFrame that the portlet provides by default. Adding a portlet to a Movable Box creates an unnecessary and potentially error-prone redundancy.

28.2.2 Clipping Content for Display in the Web Clipping Portlet

Though the point at which you add a Web Clipping portlet to a page varies between custom applications and WebCenter Spaces—at design time or at runtime—Web Clipping content is defined at runtime for both scenarios.

There are two ways to clip and save web content:

- Customize the portlet to set up a Web Clipping portlet to display content to all users

- Personalize the portlet to set up your own, personal view of a Web Clipping portlet

Both options take you into Web Clipping Studio, where you can:

- Browse for web content

- Choose the exact portion of the web content to clip

- Preview the clipped content as a portlet

- Save the clipped content as a portlet

- Set portlet properties and save the updated portlet information

To clip web content for display in the Web Clipping portlet:

1. Open the Find a Web clipping page:

- To set up a Web Clipping portlet to display content to all users, open the page in edit mode (Oracle Composer) and click the Customize icon in the portlet header.

- To set up your own, personal view of a Web Clipping portlet, click the Personalize icon in the portlet header.

The Find a Web clipping page opens (Figure 28-1).

Figure 28-1 The Find a Web Clipping Page

Note:

When running a portlet that has an Edit mode, the Personalize option in the portlet header appears only to authenticated users. Unauthenticated or public users do not see the Personalize option. What this means is that, for personalization to work, some form of security must be implemented for your application.

If you are a developer creating portlets and pages, then you may want a quick way to test the Edit mode of your portlet without creating a complete security model for your application. For information about how you can quickly add the necessary security for testing portlet personalization, see the “Configuring Basic Authentication for Testing Portlet Personalization” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

2. In the URL Location field, enter the URL of the web page that contains or links to the content you want to clip.

3. Click Start.

Web Clipping Studio displays the page you specified (Figure 28-2).

Note:

You can clip Secure Socket Layer (SSL)-enabled web sites if certificates of those sites are added to the certificate store. Certificates of SSL-enabled web sites that use Equifax, VeriSign, or Cybertrust certificates are included in the default certificate store.

For information about adding certificates, see the “Adding Certificates for Trusted Sites” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Figure 28-2 A Web Page Displayed in Web Clipping Studio

4. If your starting web page is not the page you plan to clip, then within Web Clipping Studio browse to the content you want to clip.

As you click hyperlinks in the web page, Web Clipping Studio records your navigation links.

Notes:

Only the significant browsing operations are recorded for later playback during the show mode. Any browsing operations that do not contribute to the eventual web clipping are discarded. Discarded links are not visited.

For any web sites that require HTTP Basic or Digest Authentication, a form is displayed that requests user name and password information. This encoded authentication information is recorded as part of the browsing information.

5. On the page that contains the content you want to clip, click the Section icon or link on the Web Clipping Studio banner (Figure 28-3).

If you intend to clip the full web page, it is not necessary to section the page. You can clip the full page by clicking the Select icon or link instead of Section when you are on a page you want to clip.

Figure 28-3 The Section Icon and Link in the Web Clipping Studio Banner

Sectioning divides the target web page into its clippable sections (Figure 28-4).

Figure 28-4 Sectioned Web Page in Web Clipping Studio

After you click Section, you cannot browse links in the displayed page. If you want to browse to other locations through page links, then click Unsection on the Web Clipping Studio banner. For more information about using Web Clipping, you can click the Help icon or link on any of the Web Clipping pages.

Note:

To adjust sectioning to encompass smaller or larger areas on the web page, use the Section Smaller and Section Larger options on the Web Clipping Studio banner. Click Section Smaller to divide the web page into more, smaller sections. For example, click Section Smaller to drill down one level of nested tables. Click Section Larger to divide the web page into fewer, larger sections.

6. At the top-left corner of the section you want to clip, click Choose.

You can choose only one section at a time. Web Clipping Studio displays a preview of your chosen section.

7. If the displayed section is the clipping you want, then click Select on the Web Clipping Studio banner.

If the displayed section is not the clipping you want, then click Unselect to return to the page containing the section. You can choose another section on the page, or click Unsection to remove sectioning, enabling you to navigate to another page.

Note:

Some sections may contain no data, only whitespace. For example, a web page may contain an HTML <DIV> tag that contains no text or images. If you click Choose on a section that contains no data, then Web Clipping displays a preview, but the preview correctly shows only whitespace. In this case, click Unselect on the preview page to return to the sectioned page. Then, select a section containing data.

Once you have made your selection, the Web Clipping Studio displays the Find a Web clipping page with the selected web clipping's properties.

8. Adjust the clipping's property values as necessary:

- URL Rewriting—Controls the behavior of links embedded in the clipped content.

Select from:

- None—To specify that link targets display on a new browser tab.

- Inline—To specify that link targets display inside the portlet. If you have integrated with an external application or are logged into the clipped site, and if you choose Inline for URL Rewriting, then the session is maintained to the clipped site while browsing.

Note:

The URL Rewriting option is available only when you customize a portlet. This option is not available when you personalize a portlet.

- Title—A title to display in the portlet header.

- Description—A description of the clipping. The description is not displayed in the portlet.

- Time Out (seconds)—The number of seconds to allow for the portlet to render before it times out.

- Expires (minutes)—The number of minutes before cached portlet content expires. Once cached content expires, the next time the portlet is refreshed—either by a browser refresh or by clicking the Refresh link in the portlet itself—portlet content is retrieved from the web page from which the clipping originated.

- Parameterize Inputs—Options for customizing parameters associated with the clipped content.

Click the Click to start parameterizing checkbox to customize parameters associated with the content, and then perform the following steps:

1. From the Parameters list, choose the parameters you intend to customize.

2. From the Personalizable list, select a parameter if you intend to enable users to provide their own parameter values when they personalize the portlet. Select None if you do not want to allow this.

3. In the Display Name field, enter a name to be displayed for the parameter.

4. In the Default Value field, enter a default value for the parameter.

For an example of personalizing the parameters of a web clipping, see Section 28.2.3.2, "Parameterizing a Web Clipping Portlet."

Note:

The Parameterize Inputs section displays only if you entered information in a form and then selected the section including the form for your web clipping.

9. Click OK to save changes to property values and to display the selected clipping in the Web Clipping portlet on your page.

Note:

Web Clipping portlets support additional properties that influence the way the portlet is rendered. For information, see Section 28.3, "Setting Web Clipping Portlet Properties."

Figure 28-5 shows the selected web clipping in your Web Clipping portlet.

Figure 28-5 Clipped Content in a Web Clipping Portlet

Note:

The Refresh link in the Web Clipping portlet retrieves data from cache or from the originating web site, depending upon the value you provided for Expires (minutes).

28.2.3 Adding a Web Clipping That Users Can Personalize

This section walks you through a demonstration of how you can enable end users to personalize their own view of the content in a Web Clipping portlet. It includes the following subsections:

- Section 28.2.3.1, "Selecting a Clipping from OTN"

- Section 28.2.3.2, "Parameterizing a Web Clipping Portlet"

- Section 28.2.3.3, "Personalizing a Web Clipping Portlet"

28.2.3.1 Selecting a Clipping from OTN

In this task, you navigate to the Oracle Technology Network (OTN) and search for specific information to clip.

To select a clipping from OTN:

1. In the portlet header, click the Customize icon.

The Find a Web clipping page opens.

2. In the URL Location field, enter the following URL, and click Start:

http://www.oracle.com/technology/products/ias/portal/index.html

OTN displays the Portal page.

3. Enter a search string in the Search field at the top of the page. For this example, enter web clipping portlet, then click the Search icon.

Results display in Web Clipping Studio (Figure 28-6).

Figure 28-6 OTN Search Results in Web Clipping Studio

4. Click Section on the Web Clipping Studio banner.

Web Clipping Studio divides the target web page into clippable sections (Figure 28-7).

Figure 28-7 The Choose Links on an OTN Search Results Page in Web Clipping Studio

5. At the top-left corner of the area that contains the search results (just above the text Revise search), click Choose.

A preview of the search result section opens.

6. Click Select to confirm that the search result section is the one you want to clip.

7. On the Find a Web clipping page, click OK to display the clipped content in the Web Clipping portlet (Figure 28-8).

Figure 28-8 Clipped Content Displayed in Web Clipping Portlet

28.2.3.2 Parameterizing a Web Clipping Portlet

In this task, you edit the properties of the Web Clipping portlet to enable users to display different search results in the portlet.

To parameterize a Web Clipping portlet:

1. Once you have clipped the OTN search results as described in Section 28.2.3.1, "Selecting a Clipping from OTN," click the Customize icon in the Web Clipping portlet header.

2. In the Find a Web clipping page, modify the following items in the Properties section:

- From the URL Rewriting dropdown list, choose Inline to specify that link targets open inside the portlet, rather than in a new browser window.

- In the Title field, enter OTN Search. This title appears in the header of your Web Clipping portlet and on the pages where users can personalize parameters for the web clipping.

Figure 28-9 shows the Properties and Parameterize Inputs sections of the Find a Web clipping page.

Figure 28-9 Web Clipping Properties

3. Because the content displayed in the portlet was reached by entering information in the Search field on OTN, you can customize the parameters used by the search to enable users to specify their own search string.

4. Under the Parameterize Inputs section, select Click to start parameterizing, and make the following changes in the parameters table:

- In the Parameters column, select keyword from the dropdown list.

- In the Personalizable column, select Param1 from the dropdown list.

- In the Display Name column, enter OTN Search.

- Make sure that Default Value displays web clipping portlet to be sure you have selected the right parameter.

5. Click OK to display the default search results in the Web Clipping portlet.

28.2.3.3 Personalizing a Web Clipping Portlet

In this task, you personalize a Web Clipping portlet to display different search results in the portlet.

To personalize a Web Clipping portlet to display different search results:

1. In the Web Clipping portlet header, click the Personalize icon.

Note:

When running a portlet that has an Edit mode, the Personalize option in the portlet header appears only to authenticated users. Unauthenticated or public users do not see the Personalize option. What this means is that, for personalization to work, some form of security must be implemented for your application.

If you are a developer creating portlets and pages, then you may want a quick way to test the Edit mode of your portlet without creating a complete security model for your application. For information about how you can quickly add the necessary security for testing portlet personalization, see the “Configuring Basic Authentication for Testing Portlet Personalization” section in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

2. In the resulting Find a Web clipping page, scroll down to the Inputs section.

Notice that the parameter field for the search string is labeled OTN Search, as you specified for the Display Name while parameterizing the Web Clipping portlet. (Figure 28-10).

Figure 28-10 A Web Clipping in the Personalize Mode

3. In the OTN Search field, enter a different search string.

For example, enter WebCenter.

4. Click OK.

The Web Clipping portlet now displays the search results for WebCenter from OTN.

28.3 Setting Web Clipping Portlet Properties

The Web Clipping portlet has associated properties that control the look and feel of the portlet on the page. Users with sufficient privileges can access these properties through the Component Properties dialog (Figure 28-11).

Figure 28-11 Web Clipping Portlet Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Events service task flows and describe the properties on the Parameters tab:

- Section 28.3.1, "What you Should Know About Web Clipping Portlet Properties"

- Section 28.3.2, "Web Clipping Portlet Properties"

28.3.1 What you Should Know About Web Clipping Portlet Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 28.3.2, "Web Clipping Portlet Properties." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

28.3.2 Web Clipping Portlet Properties

Table 28-1 describes the properties that are unique to the Web Clipping portlet.

Table 28-1 Web Clipping Portlet Component Properties

Property

Description

Location

Param#

Use to map page parameters to the parameters specified when the Web Clipping portlet was defined. These parameters enable you to contextually wire portlets and pages. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Parameters tab

All Modes Shared Screen

For Web Clipping, set this property to false to ensure that all portlet modes, except Show, are rendered each on their own page. Setting this property to true may prevent you from editing certain sections of your web clipping in the Web Clipping wizard.

Display Options tab

Id

A unique identifier for the portlet instance.

Display Options tab

Partial Triggers

Use to initialize a partial page refresh, which is a way of refreshing an area of a page without having to redraw the entire page.

Display Options tab

Render Portlet in I Frame

Use to render the portlet in an inline frame (IFRAME), omit an IFRAME, or let the portlet decide. Valid values are:

- auto (default): The portlet tag checks the portlet response and decides if an IFRAME is required

- true: Render the portlet instance in an IFRAME

- false: Render the portlet instance inline

Placing a portlet inline on a page provides a better user experience as compared to placing it in an IFRAME. However, at times, it may be required to include a portlet in an IFRAME. For example:

- The portlet is a JSF portlet

- The portlet contains a file upload element

- The parser throws an exception because it is not able to parse the markup

Display Options tab

Title

Enter a title for the Web Clipping portlet, to display in the portlet header.

Display Options tab

28.4 Current Limitations of Web Clipping

When you use Web Clipping, you should be aware of the following limitations:

- If the site that you intend to clip uses a large amount of JavaScript to manipulate cookies or uses the document.write JavaScript method to modify the HTML document being written, then you may not be able to clip content from the site.

- When you integrate with partner applications (by using mod_osso), you cannot clip directly through those partner applications in an authenticated manner. However, you can use partner applications through the external application framework.

- You cannot use the Web Clipping portlet to clip Oracle Portal pages and ADF pages. As a workaround, reregister the same producer in the destination portal and edit the portal manually.

- You cannot use the Web Clipping portlet to clip a web page that contains multiple frames, that is, a frameset.

- Note the following about Web Clipping and the use of a CSS:

- If a web page contains multiple portlets that use a CSS, then they should not conflict if the CSS uses distinct style names (such as OraRef) to specify a style within an HTML tag, rather than using an HTML tag name (such as <A>) as the name of the style.

- If one portlet uses a CSS, and that CSS overwrites the behavior of HTML tags by using the name of the tag (such as <A>) as the name of the style, and a second portlet on the same page does not use a CSS, the second portlet is affected by the style instructions of the CSS of the first portlet.

- If two portlets on the same page use a different CSS and each CSS overwrites the behavior of HTML tags by using the name of an HTML tag (such as <A>) as the name of the style, then the style that is displayed depends on the browser.

- Web Clipping checks for globalization support settings in the following way:

1. Web Clipping checks the Content-Type in the HTTP header for the charset attribute. If this is present, then it assumes that this is the character encoding of the HTML page.

2. If the charset attribute is not present, then Web Clipping checks the HTML META tag on the page to determine the character encoding.

3. If the HTML META tag is not found, then Web Clipping uses the charset in the previous browsed page. If this is the first page, then it defaults to the ISO-8859-1 character encoding.

4. If the value of the charset for Content-Type or META tag is not supported (for example, if the charset was specified as NONE), then Web Clipping uses the default character set, ISO-8859-1, not the charset in the previously browsed page.

- To use the Web Clipping portlet, you must use Microsoft Internet Explorer 5.5 or later for Windows 2000, or Microsoft Internet Explorer 6.0 or later for Windows XP. If you use browser versions older than these, then you may encounter JavaScript errors.

28.5 Troubleshooting Web Clipping

This section provides information to help you troubleshoot problems you may encounter while using Web Clipping.

Encountered "x" at line n, column n. Was expecting one of : "x", "y" ...

Parser error message written to the log file.

Problem

The web content displayed in the Web Clipping portlet contains invalid HTML or JavaScript.

Solution

This is a site-specific issue, not a Web Clipping error. Contact the site's administrator for assistance.

Part IX

Organizing Your Collaborative and Social Networking Environment

Part IX of the User's Guide steps through the process of setting up and managing a Home Space and creating a social network. It includes details about social networking and collaboration and personal management tasks, such as bookmarking pages and subscribing to application objects.

Part IX includes the following chapters:

- Chapter 29, "Exploring the Home Space"

- Chapter 30, "Managing Your Profile"

- Chapter 31, "Creating Your Social Network"

- Chapter 32, "Tracking Your Connections' Activities"

- Chapter 33, "Posting and Managing Messages and Feedback"

- Chapter 34, "Liking, Commenting On, and Sharing Objects"

- Chapter 35, "Setting Your Personal Preferences"

- Chapter 36, "Setting Up Your Personal Subscriptions and Notifications"

- Chapter 37, "Creating and Managing Your Personal Favorites"

- Chapter 38, "Creating and Managing Personal Pages"

29 Exploring the Home Space

This chapter provides basic information to get you started in the WebCenter Spaces Home Space. It includes the following sections:

- Section 29.1, "What You Can Do In the Home Space"

- Section 29.2, "Registering Yourself with WebCenter Spaces"

- Section 29.3, "Hiding, Opening, and Rearranging Pages"

- Section 29.4, "Adjusting Your Page View"

- Section 29.5, "Exposing a Space Page in Your View of the Home Space"

- Section 29.6, "Renaming a Page"

- Section 29.7, "Sending a Link to a Page"

- Section 29.8, "Previewing and Printing an Application Page"

- Section 29.9, "Viewing Space and Page Information"

- Section 29.10, "Viewing Your Personal Profile Gallery"

- Section 29.11, "Accessing WebCenter Spaces Online Help"

Audience

This chapter is intended for users minimally assigned the role Authenticated-User, that is, any user who is logged in, who wants to understand basic information about WebCenter Spaces self-registration, Home Spaces, page access, and online help. To create and manage pages in a Home Space, you must be granted, minimally, Pages: Create, Edit, and Delete Pages.

Tip:

You can initiate many of the actions described in this chapter from a context menu that is available when pages are rendered as tabs. To access this menu, click the menu icon on the active tab (the one that is forward) or right-click an inactive tab. Options vary according to your permissions on the page; whether the page is active or inactive; whether the page is a custom, system, or business role page; and whether the page is in a Space or your Home Space.

29.1 What You Can Do In the Home Space

Provided your portal administrator has granted you the privileges to do so, you can create pages in the Home Space, edit those pages, rename them, rearrange them, and add content to them. Such pages are for your view only, unless you specifically share them with other users.

To have page create and manage privileges in the Home Space makes almost all of the information in this guide useful to you, no matter your position in your company's hierarchy. For example, you can use the information in Chapter 38, "Creating and Managing Personal Pages," to create and manage your personal pages and to share such pages with the users you specify.

Note:

Application administrators may choose to prohibit the creation of personal pages in the Home Space, allowing only the display of business role pages and system pages, over which you have less control.

You can use the information in Chapter 17, "Building Pages," to add content to your pages and to configure that content.

You can use the information in Part X, "Working with Content", Part XIII, "Searching WebCenter and Other Sources", Part XV, "Services: Announcements through Links", and Part XVI, "Services: Lists through Worklist" to take advantage of the many services and their associated task flows provided out of the box.

Tip:

Some services are active only in Spaces other than the Home Space. These include such services as Events, Announcements, Lists, and the like.

This chapter provides a basic orientation to the types of actions you can take in the Home Space. Note that the actions discussed here and in the chapters cited earlier apply primarily to the personal pages you create in the Home Space. There are other types of pages, too, over which you have fewer default permissions.

For example, the Home Space may contain business role pages, that are provided to you by your application administrator. Business role pages are pushed to your view of the Home Space based on your assigned application role. For example, if you are part of the Sales team, there may be a business role page in your view of the Home Space that you and all the members of the Sales team can access.

See Also:

Section 7.1, "Working with Business Role Pages."

Additionally, there are system pages. System pages are typically utility pages that, in the Home Space, either expose your personal view onto a given service, such as the Documents page or the Activity Stream page, or provide an application-wide function, such as the Self-Registration page.

See Also:

Section 7.3, "Working with System Pages."

Keep in mind, though you own and operate your personal pages in the Home Space, your application administrator sees all, and can access anyone's personal pages, no matter the security settings you put in place.

29.2 Registering Yourself with WebCenter Spaces

Your WebCenter Spaces administrator may provide the opportunity to self-register to WebCenter Spaces. Self-registration enables you to create your own login credentials and enter WebCenter Spaces from there forward as an authenticated user. The privileges of authentication are many: your own view of the Home Space, access to other features based on your assigned user role, a broader range of available interactive features, and the like.

Note:

Whether self-registration is available depends on how your WebCenter Spaces administrator configures your WebCenter application.

To register yourself as a WebCenter Spaces user:

1. Open the WebCenter Spaces application.

For example:

http://host:port/webcenter

Where <host>:<port> refers to the host name and port number of the system where Oracle WebCenter is installed. By default, Oracle WebCenter is installed on port 8888.

2. Click the Register button on the application Welcome page (Figure 29-1).

Note:

Your WebCenter Spaces administrator can customize the look and feel of the Login dialog, but the information depicted in Figure 29-1 is essentially the same whatever the customization.

See Also:

Advanced users can extend WebCenter Spaces by customizing, for example, where the Login dialog appears. For more information, see Section 7.3.2, "Customizing System Pages."

Figure 29-1 The Register Button on the Welcome Page

3. On the resulting Self-Registration page (Figure 29-2), enter your user information:

Note that fields marked with an asterisk require a value.

Tip:

Your application administrator can customize the Self-Registration page, so it may not appear as depicted in Figure 29-2.

Figure 29-2 WebCenter Spaces Self-Registration Page

Before you begin, you should know that the user name and password policy is set by the underlying identity store. Your application administrator may customize the Self-Registration page to include information that explains your organization's user name and password policy.

1. Enter your preferred user name in the Choose User Name field.

2. Click the Check User Name Available button to ensure the uniqueness of your chosen user name.

If the name you entered is in use, provide another user name and test that. Continue this cycle until the check assures you that your entry is unique.

3. Provide a password in the Choose Password field.

4. Reenter the password in the Re-enter Password field.

5. Enter your first name in the First Name field.

6. Enter your last name (that is, your surname) in the Last Name field.

7. Enter your company email address in the Email Address field.

Note:

You can create only one user account per email address.

4. Click the Register button.

If the data you entered is accepted, a log-in dialog opens, enabling you to log in to WebCenter Spaces.

Note:

By default, if a user name with the same mail ID exists, when you click Register, a dialog opens informing you that the mail ID exists. The dialog includes a button for sending a message to the mail ID associated with the existing user name.

Because you are not yet authenticated, your message is sent to a public mail box, provided your application administrator has configured public mail credentials.

Note that this default behavior may be overridden by customizations provided by your portal developers.

29.3 Hiding, Opening, and Rearranging Pages

Showing and hiding pages is a user customization. That is, such changes affect only your view of the application. Pages are not simultaneously shown or hidden in other users' application views.

The type of navigation that is in place in a given Space affects which steps you take to hide, show, open, and close that Space and its pages. Administrators and Space moderators can set up navigation as they choose. The procedures in this section are offered as examples of how to hide, show, open, and close Spaces and pages and how to rearrange page order. Your methods may differ based on your portal's navigation.

This section includes the following subsections:

- Section 29.3.1, "Opening Spaces"

- Section 29.3.2, "Opening Pages"

- Section 29.3.3, "Hiding Pages"

- Section 29.3.4, "Showing Hidden Pages"

- Section 29.3.5, "Rearranging Page Order"

29.3.1 Opening Spaces

Two types of Spaces may be available to you in your WebCenter Spaces portal: a Space, which is exposed to a group of users who are working toward a common goal, and a Home Space, which is for everyone (the application administrator may also provide you with options for creating and managing your own personal pages in the Home Space). This section provides examples of how to open both types of Space. It includes the following subsections:

- Section 29.3.1.1, "Accessing the Home Space"

- Section 29.3.1.2, "Accessing a Space"

29.3.1.1 Accessing the Home Space

This section provides examples of how to access the Home Space. Your portal navigation may differ, and may therefore not respond to these approaches. These examples should, nonetheless, provide some ideas for how to go about this action in your own portal.

Examples of ways to access the Home Space:

- Use the following URL:

http://host:port/webcenter/spaces/home

- Click your user name where it appears as a link in the application, for example, Figure 29-3.

Figure 29-3 Example of a User Name as a Link

This takes you to the My Profile page in the Home Space.

29.3.1.2 Accessing a Space

This section provides examples of how you can access Spaces other than the Home Space. Your portal navigation may differ, and may therefore not respond to all of these approaches. These examples should, nonetheless, provide some ideas for how to go about accessing a Space in your own portal.

Examples of ways to access Spaces other than the Home Space:

- Use the following URL:

http://host:port/webcenter/spaces/spaceName

In lieu of spaceName, enter the name of the Space.

See Also:

For additional URLs to use in navigating to pages, see Appendix A, "WebCenter Spaces User Interface URLs."

- In any Space, open the Spaces Switcher menu and click the name of the destination Space, or click Browse Spaces to access the Spaces page (Figure 29-4).

Figure 29-4 Browse Spaces Option on Spaces Switcher Menu

You can use the Search feature on this page to locate a specific Space.

Note:

The way that you open the Spaces Switcher menu depends on the page template in use. For example, you may open it by clicking a menu icon to the right of the Space name.

29.3.2 Opening Pages

You have a few options for opening pages. How you proceed depends on the controls your application administrator or Space moderator has made available to you and the navigation model in use. In all configurations, however, you can open pages using a pretty URL or through the Personalize Pages page (Figure 29-5).

Figure 29-5 Personalize Pages Page

To open pages:

- To open pages in the Home Space, use the following URL:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

- To open pages in a Space, use the following URL:

http://host:port/webcenter/spaces/spaceName/page/escapedPageDisplayName

- Open the Personalize Pages page, and click the name of the page you want to open (Figure 29-6).

Figure 29-6 Opening a Page through the Personalize Pages Page

29.3.3 Hiding Pages

As you add pages to Spaces, it may become useful to hide some less-frequently-used pages. Once a page is hidden, it is easy to restore it to view (see Section 29.3.4, "Showing Hidden Pages").

To hide a page:

1. Go to the Space with pages you want to hide, and open the Personalize Pages page.

See Also:

For more information, see Section 29.3.2, "Opening Pages."

2. Clear the Show Page checkbox for each page you want to hide.

Note:

If you clear the Show Page checkbox for the current page, the Personalize Pages page closes and the current page is hidden.

Within a particular scope, such as a Space or the Home Space, one page must always be shown; therefore, you cannot use this method to hide all pages within a particular scope.

29.3.4 Showing Hidden Pages

To show a hidden page:

1. Go to the Space with pages you want to show, and open the Personalize Pages page.

See Also:

For more information, see Section 29.3.2, "Opening Pages."

2. Select the Show Page checkbox for each page you want to show.

29.3.5 Rearranging Page Order

In a Space, you can use the Personalize Pages page to change the order in which pages are listed or arranged. When you change page order on the Personalize Pages page, you are doing so in your own view only. That is, it is a user customization that affects only your view of the page.

Note:

There are two ways of defining the order and the visibility of pages in a Space: from the Administration pages (described in Section 7.1.7, "Setting a Default Display Order for Business Role Pages") and from the Personalize Pages page (described here). The difference between the two is that the Administration change is an application customization and the Personalize Pages change is a user customization. Keep in mind that user customizations override application customizations in a given user's view.

See Also:

F or more information about user customization, see Section 29.4.1, "What You Should Know About User Customizations on a Page."

To rearrange page order:

1. Go to the Space with pages you want to rearrange, and open the Personalize Pages page.

See Also:

For more information, see Section 29.3.2, "Opening Pages."

2. Use the icons in the Reorder column to rearrange page order (Figure 29-7).

Figure 29-7 Reorder Icons on the Personalize Pages Page

Pages are now arranged in the order you specified.

29.4 Adjusting Your Page View

The WebCenter Spaces application provides many opportunities for changing your view of a given page. This includes rearranging your view of page content, hiding components, changing your page layout, and the like. All of these options are user customizations, that is, they affect only your view of the application. All other users' views remain unchanged.

See Also:

For information about the difference between user- and application-level customizations, see Section 17.5.2.1, "What You Should Know About Customizing Page Components."

This section steps you through the process of adjusting your own page view through user customization. It includes the following subsections:

- Section 29.4.1, "What You Should Know About User Customizations on a Page"

- Section 29.4.2, "Performing User Customizations on Your Page View"

29.4.1 What You Should Know About User Customizations on a Page

You can customize the way pages appear in many ways without opening the page editor (Oracle Composer). For example, you can reposition components, remove components from your view of a page, resize a component's height, and collapse components to display just their headers.

User customizations are yours and yours alone. That is, the changes you make through the procedures described in the following sections affect only your view of WebCenter Spaces. No other users are affected by your changes.

For example, when you reposition page components in page view mode, that change applies only to your view of the application. Other users may reorganize their own views of pages, and their changes do not affect your view—only their own.

Note:

When you revise a component in page view mode while another user deletes the same component in page edit mode, a WebCenter error page opens. Simply navigate back to the original page. The deleted component does not appear, and you can continue working on other components.

See Also:

Advanced users with sufficient permission can change everyone's view of a page. For more information, see Section 17.3, "Editing Pages."

29.4.2 Performing User Customizations on Your Page View

Whether you can customize a page depends on permissions granted to you or your application role and on how user customizations are configured. You can tell if you have such permission by the presence or absence of the controls discussed in this section. If you do not see these controls, contact your application administrator to ask for a higher-level of access or for a configuration change.

Tip:

An Administrator link for contacting your application administrator may be available to you, depending on the design of your portal.

This section describes how to perform the user customizations rearrange, resize, minimize, and maximize. It includes the following subsections:

- Section 29.4.2.1, "Rearranging Page Content"

- Section 29.4.2.2, "Removing Components from Your View of a Page"

- Section 29.4.2.3, "Resizing Components"

- Section 29.4.2.4, "Collapsing and Expanding Components"

29.4.2.1 Rearranging Page Content

Use drag-and-drop to rearrange the position of a component on a page. Components moved by drag-and-drop can be moved into any open position on a page.

Dragging and dropping is arguably the easiest and least restricted way to rearrange components on a page. Simply drag the component over the spot you want to place it. A shadow indicates a receptive drop location (Figure 29-8).

Figure 29-8 Shadow Indicating a Receptive Drop Location

To rearrange components by dragging and dropping:

1. Go to the page where you want to rearrange components by dragging and dropping.

See Also:

For more information, see Section 29.3.2, "Opening Pages."

2. Click and hold the header of the component you want rearrange, drag it to its target position, and drop it onto the page.

A shadow indicates where the component is placed when you drop it (Figure 29-9).

Figure 29-9 Dragging an Issues List Above an Events Task Flow

29.4.2.2 Removing Components from Your View of a Page

If you find that a component, such as a task flow or portlet, is not useful to you and the component displays a Remove icon (Figure 29-10), you can remove it from your view of the page.

Figure 29-10 Remove Icon on a Task Flow

To remove a component from your view of a page:

1. Go to the page where you want to remove a component from your page view.

See Also:

For more information, see Section 29.3.2, "Opening Pages."

2. Click the Remove icon on the component header (see Figure 29-10).

The component is removed from your view of the page.

Tip:

You can restore a removed component only by editing the page and adding a new component instance (for more information, see Section 17.5, "Adding Resource Catalog Components to Pages").

29.4.2.3 Resizing Components

The border and header surrounding a component, such as a task flow or a portlet, is also known as chrome. Chrome not only clarifies the boundaries of the component, but also provides an access point for component actions, such as those on the Actions menu and those embedded in the chrome itself. In the latter case, the chrome may include a Resize handle that you can use to increase or decrease the height of the component (Figure 29-11).

Figure 29-11 Resize Handle on a Task Flow

Note:

The position of the resize handle differs for bidirectionally displayed components. Those components displayed in a right-to-left orientation display the resize handle on the left side.

To use this feature, click and hold the Resize handle and drag it up to decrease the height of the component or down to increase the height of the component.

29.4.2.4 Collapsing and Expanding Components

With one click, you can collapse some components, such as task flows or portlets, so that they roll up like a window shade, leaving only their headers on view (Figure 29-12).

Figure 29-12 Collapse/Expand Icon on a Task Flow

With another click, you can expand a collapsed component.

Collapsing is useful for removing the visual noise of an unused component from your application view. Collapse is available when a component shows a header.

To collapse and expand components:

1. Go to the page you want to customize.

See Also:

For more information, see Section 29.3.2, "Opening Pages."

2. Click the Collapse icon on the component header to roll the component up like a window shade (Figure 29-13).

Figure 29-13 Collapsed Task Flow

3. Click the Expand icon on the component header to restore the full component to view (see Figure 29-12).

29.5 Exposing a Space Page in Your View of the Home Space

You can expose some Space pages within your view of the Home Space. For example, if you would like to keep close track of a Space page named Sales Results, you can specify that the Sales Results page should be available in your view of the Home Space.

Note:

System pages that are exposed in a Space, such as Events, Lists, and Announcements, do not provide the option of being exposed in the Home Space. For information about System pages, see Section 7.3, "Working with System Pages."

The page is available for viewing and revising from within your view of the Home Space according to your permissions on the page. The Space name is prepended to the page name, so the Sales Results page in the Space Finance becomes Finance - Sales Results in your view of the Home Space.

If you delete such a page from your view of the Home Space, it remains a part of its original Space. In other words, deleting it simply removes it from your view of the Home Space; it does not actually delete the page. If the page is deleted from its parent Space, it is unavailable in your view of the Home Space. To clear it from your view, you must refresh the page list in the Home Space's Personalize Pages page.

Tip:

Personalize Pages is an option on the Page and Spaces Actions menu. How you access this menu depends on your portal design.

To expose a Space page in your view of the Home Space:

1. Go to the Space that contains the page of interest.

See Also:

For more information, see Section 29.3.1, "Opening Spaces."

2. Access the Space's Personalize Pages page.

3. Open the Actions menu next to the page of interest, and select Add Page to Home Space (Figure 29-14).

Figure 29-14 Add to Home Space Option on the Actions Menu

29.6 Renaming a Page

When you rename a page, keep in mind that any pretty URLs that use the old name will be broken. Also note that system pages, such as the Announcements, Lists, and Events pages, do not provide the option of being renamed.

See Also:

For information about pretty URLs, see Appendix A, "WebCenter Spaces User Interface URLs."

To rename a page:

1. Go to the Space that contains the page of interest.

See Also:

For more information, see Section 29.3.1, "Opening Spaces."

2. Access the Space's Personalize Pages page.

3. Open the page's Actions menu, and select Rename Page (Figure 29-15).

Figure 29-15 Rename Page Option on Actions Menu

4. Revise the page name, and click Save.

29.7 Sending a Link to a Page

To send a link to a page:

1. Go to the Space that contains the page of interest.

See Also:

For more information, see Section 29.3.1, "Opening Spaces."

2. Open the Space's Personalize Pages page.

3. Open the page's Actions menu, and select Send Mail (Figure 29-16).

Figure 29-16 Send Mail Option on Actions Menu

A compose mail window containing the URL to the current page opens. Compose and send the message as you would any other mail message.

The compose message window opens either in your native mail application or in WebCenter's mail compose window, depending on how your application administrator has configured this feature. If the administrator has made such controls available to users, you may define for yourself which mail client opens. For more information, see Section 65.3, "Selecting Your Preferred Mail Connection."

29.8 Previewing and Printing an Application Page

Use the Print Preview option to preview and print pages that largely contain text. Print options are useful for pages where content is mainly text, such as the Announcements page, wiki and blog pages, and other custom pages comprised primarily of text.

Note that the Print Preview control may not be present if your application designer has not made it available, either through the inclusion of a Print Preview link or through the rendering of pages as tabs. When pages are rendered as tabs, a context menu is available on the tab portion of the page. You can access the Print Preview option from this menu.

To preview and print an application page:

1. Go to the Space that contains the page of interest.

See Also:

For more information, see Section 29.3.1, "Opening Spaces."

2. Either click the Print Preview link or select Print Preview from the page's context menu.

A printable version of the page opens in a new browser tab or window. Print the page by pressing Ctrl-P, or simply preview the page.

29.9 Viewing Space and Page Information

Every Space and every page has associated information, called metadata. Space and page metadata include such information as display name, internal identification (GUID), description, membership role (Spaces only, that is, not the Home Space), user name of the creator, date created, and direct URL.

This section provides information about how to access Space and page information. It includes the following subsections:

- Section 29.9.1, "Accessing Space Information"

- Section 29.9.2, "Accessing Page Information"

29.9.1 Accessing Space Information

To access information about a Space:

1. Go to the Spaces page.

See Also:

For information about accessing the Spaces page, see Section 29.3.1.2, "Accessing a Space."

2. Right-click the Space of interest, and select About and then About this Space (Figure 29-17) to open the About Space dialog (Figure 29-18).

Figure 29-17 About this Space Option on Space Context Menu

Figure 29-18 About Space Dialog

3. Click OK to close the dialog.

29.9.2 Accessing Page Information

To access information about a page from the Personalize Pages page:

1. Go to the Personalize Pages page in the Home Space or the Space that includes the page of interest.

Tip:

Personalize Pages is an option on the Page and Spaces Actions menu. How you access this menu depends on your portal design.

2. Open the page's Actions menu (Figure 29-19), and select About This Page to open the Page Information dialog (Figure 29-20).

Figure 29-19 About this Page Option on Personalize Pages Page

Figure 29-20 Page Information Dialog

3. Click OK to close the dialog.

29.10 Viewing Your Personal Profile Gallery

When you log in to the WebCenter Spaces application, you may notice your user name at some position in the application user interface. Click this to open your personal profile gallery (Figure 29-21).

Figure 29-21 Profile Page

Your personal profile gallery presents a series of tabs, each devoted to information of interest to you:

- Activities—Provides a Publisher, which you can use to make statements about your personal status and provide links to external or internal objects, and an Activity Stream, which streams information about the activities of you and your connections. For more information, see Chapter 32, "Tracking Your Connections' Activities," and Chapter 34, "Liking, Commenting On, and Sharing Objects."

- Connections—Provides a view of all of your connections and features for making and managing your connections. Chapter 31, "Creating Your Social Network."

- Documents—Provides a view of your personal document library. For more information, see Part X, "Working with Content".

- Organization—An organization chart that depicts you and the organization members directly associated with you. For more information, see Chapter 30, "Managing Your Profile."

- About—Your personal profile details. For more information, see Chapter 30, "Managing Your Profile."

29.11 Accessing WebCenter Spaces Online Help

Wherever you see a Help link or a Help button, click it to access help.

The Help link at the top of the application (Figure 29-22) opens the application's main help page. From there, you can navigate to topics of interest.

Figure 29-22 Help Link

Help buttons, located throughout the application, open help topics that describe what is currently shown.

Figure 29-23 Help Button

30 Managing Your Profile

In WebCenter Spaces, your Profile is a collection of useful data about you. It can include contact information, a photo, your location within the company hierarchy, and so on. The social networking capabilities in WebCenter Spaces enable you to view and manage your own Profile and to view the Profiles of others if they have made them available to you.

This chapter provides an overview of Profile-related features and steps you through the process of Profile viewing and managing. It includes the following sections:

- Section 30.1, "What You Should Know About Profile"

- Section 30.2, "Specifying a Management Chain for Organization View"

- Section 30.3, "Setting Profile Preferences"

- Section 30.4, "Adding a Profile Task Flow to a Page"

- Section 30.5, "Viewing and Editing Personal Profiles"

- Section 30.6, "Setting Profile Task Flow Properties"

Audience

This chapter is intended for users assigned an application role that includes, minimally, the permission Update People Connections Data. Users who plan to edit task flow properties must be assigned a role that also includes the permission Pages: Edit Pages. In a Space (other than the Home Space), users must be assigned a role that includes the permission Edit Page Access and Structure.

30.1 What You Should Know About Profile

Profile provides a variety of views into your own and other users' personal profile information. Such information can include your mail address, phone number, office location, department, manager, direct reports, and so on. In a typical WebCenter Spaces installation, Profile takes the bulk of its information from the back-end identity store that provides your WebCenter application with its users (for more information, see Section 30.2, "Specifying a Management Chain for Organization View"). Additionally, Profile may offer opportunities for altering some of this information and for providing additional data not included in the identity store.

When you connect with other users, you give them access to your Profile, and gain access to theirs. You can control how much of your Profile a connection can view through Profile Preferences. For information about setting your Profile Preferences, see Section 30.3, "Setting Profile Preferences."

Before you access your Profile or Profile Preferences, your application administrator can set global application defaults that affect what all users may see and do with their own and other users' Profiles. For more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."

You can access a view of a Profile, including your own, by clicking a user name wherever you see it in WebCenter Spaces. In addition to brief, popup views of user Profiles, you can see a full view of your Profile on the WebCenter Spaces Profile page. The Profile page is a business role page that is pushed to all authenticated users' views of the Home Space (Figure 30-1).

Figure 30-1 Profile Page

Tip:

Authenticated users are users who are logged in to WebCenter Spaces.

See Also:

For information about business role pages, see Section 7.1, "Working with Business Role Pages."

By default, the Profile page presents a series of subpages that include your view of the Activity Stream (Activities), a detailed view of your connections (Connections), a view of the documents and folders in the Public folder of your personal document library (Documents), a chart view of your location within the organization (Organization), and a view of your full Profile (About).

Of all of these subpages, only Organization and About pull their content from the identity store and belong to the Profile family of task flows. The other subpages pull their content from other features and services as follows:

- Activities comes from the Activity Stream feature of the People Connections service (for more information, see Chapter 32, "Tracking Your Connections' Activities")

- Connections comes from the Connections feature of the People Connections service (for more information, see Chapter 31, "Creating Your Social Network")

- Documents comes from the Documents service (for more information, see Part X, "Working with Content".

Your portal designer can revise the default Profile business role pages to include additional components, remove existing components, and revise the page look and feel. Consequently, the page described here may finally have little to do with the final Profile page that you see.

See Also:

For information about revising business role pages, see Section 7.1, "Working with Business Role Pages."

In addition to Profile business role pages, Profile provides several task flows that each offer a unique view of a user's Profile information. Provided you have edit permission on a page, you can place a Profile task flow wherever you find it of use.

Profile provides the following task flows:

- Organization View for a graphical depiction of the current user's position within the company—that is, a detail of the overall organization chart. In Organization View, you can cycle through three views of the current user's Profile information, including contact information; the user's address and the current time in the user's locale; and a summary About Me statement. It also provides a link to a full-blown profile of the current user (Figure 30-2).

Figure 30-2 Organization View Task Flow

See Also:

For information about enabling a hierarchical view of your organization, as depicted in Figure 30-2, see Section 30.2, "Specifying a Management Chain for Organization View."

- Profile for displaying a user's profile details, uploading a photo, and (if enabled) editing Profile details (Figure 30-3)

Figure 30-3 Profile Task Flow

- Profile Gallery for accessing all of your social networking information from one view (Figure 30-4)

Figure 30-4 Profile Gallery Task Flow

- Profile - Snapshot for viewing a user photo and status message (Figure 30-5)

Figure 30-5 Profile - Snapshot Task Flow

See Also:

For information about working with Profile task flow features, see Section 30.5, "Viewing and Editing Personal Profiles."

Profile task flows have associated properties that you can use to control the appearance and behavior of a task flow instance. For example, you can use Profile properties to specify that the statements you enter into a Publisher task flow (see Section 33.1.1, "What You Should Know About Message Board") are included in those Profile views that provide a status message. You can control whether a Profile allows the display of a photo and whether the photo can be updated in page view mode.

See Also:

For more information about Profile properties, see Section 30.6, "Setting Profile Task Flow Properties."

For information about using Profile features, see Section 30.5, "Viewing and Editing Personal Profiles."

30.2 Specifying a Management Chain for Organization View

The Organization View task flow and the Organization subpage on a Profile page can provide a visualization of your management chain, that is, they can render a view of a manager and the manager's direct reports (Figure 30-6).

Figure 30-6 Organization View of a Manager and the Manager's Direct Reports

Organization views of a user profile are available on a user's Profile page—on the Organization subpage—and through the Organization View task flow. By default, the values that define the management chain for these organization views are blank. This means that managers are not automatically specified for users in the back-end identity store that provides user details.

Tip:

The value for Manager on the Profile page's About subpage is also defined by the methods suggested in this section.

For the management chain to be rendered in organization views, the back-end identity store that is used for WebCenter Spaces authentication must be set up in such a way that direct report users have a manager attribute. And the manager attribute must be defined as the Distinguished Name (DN) of their manager user (see "Example Embedded LDAP Configuration").

Tip:

In an LDAP environment, a user can be managed by only one person; in the same environment, a user can manage many people.

Example Embedded LDAP Configuration

You can specify a management chain within the Oracle WebLogic Server (WLS) embedded LDAP or within an external LDAP, such as Oracle Internet Directory (OID). Note, however, that the management chain you define through the embedded LDAP is for testing or proof of concept and not for production. For production, you must use an external LDAP, such as OID, for the identity store for WebCenter Spaces authentication.

See Also:

For more information, see the chapter "Configuring the Identity Store," in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter, or refer to the documentation provided with your LDAP implementation.

This example describes how to define a management chain within the embedded LDAP in WebLogic Server for testing or proof of concept.

Note:

The steps provided in this example are similar to those you take for an external LDAP. That is, you create an attribute (manager) and set a value on the attribute for each user. For this value, enter the DN of the selected user's manager.

In this example, there are three users:

- user1

- user2

- manager_user

To define a management chain with these users:

1. Enable browsing of the embedded LDAP using an external viewer, such as Apache Directory Studio:

1. Go to the WLS Administration Console, and log in as the administrator user.

2. Click your domain, for example, wc_domain, then open the Security Tab and then the Embedded LDAP Sub-tab (Figure 30-7).

Figure 30-7 Oracle WebLogic Server Administration Console

3. Enter a value in the Credential field, and then reenter that value in the Confirm Credential field.

Tip:

The default credential is a randomly generated password. Set it to something memorable.

4. Restart your administration and managed servers.

2. Start up the LDAP viewer you selected in Step 1, and create a connection using the following details:

- hostname (for example, example.com)

- port (the WLS administration port, for example 7001)

- Bind DN (cn=Admin)

- Password (that is, the credential you set in Step 1c)

3. Navigate to user1 by finding the users within the DIT tree (Figure 30-8).

For example, click in succession:

- dc=wc_domain

- ou=myrealm

- ou=people

- uid=user1

Figure 30-8 Selecting a User in the DIT Tree of an LDAP Browser

4. In the Attribute Description column, add a new attribute of type manager.

Tip:

Press Ctrl-Shift-+ to open the New Attribute dialog.

5. For the attribute value, choose the DN for manager_user (Figure 30-9).

For example, under the root choose in succession:

- dc=wc_domain

- ou=myrealm

- ou=people

- uid=manager_user

Figure 30-9 Select DN Dialog

6. Repeat Steps 3 through 5 for user2.

Now user1 and user2 are managed by manager_user. You can check this by logging in to WebCenter Spaces as user1 and navigating to the About subpage of the My Profile page. The user manager_user is displayed as the manager (Figure 30-10).

Figure 30-10 About Subpage of the My Profile Page

Tip:

Click the value for Manager (in this example, manager_user) to view the manager's profile. Access the Organization subpage to see the organization view associated with the currently viewed profile (see Figure 30-6).

30.3 Setting Profile Preferences

The Profile details that are affected by your Preferences settings appear in your full Profile view, for example, in the Profile task flow and on the About subpage of the default My Profile business role page (Figure 30-11).

Figure 30-11 About Subpage on Profile Page

Full profiles are presented in four sections: Summary, Employee, Business Contact, Personal Information. Each section provides information related to the section heading. For example, Summary includes a collection of basic details, such as your user name, mail address, and office location.

Note:

Your portal administrator can control every users' access to their own Profile information. For example, the administrator can control whether a Profile section is shown, whether a given section is editable, and who can see what Profile information. Consequently, the control you can exercise over your own Profile preferences is determined by the actions of your administrator. For more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."

Only the administrator can control access to the Summary section. For more information, see Section 6.4.3.4, "Configuring Profile."

Use Profile preferences to specify who can view different types of information associated with your personal profile.

To set Profile preferences:

1. Open the Preferences dialog.

2. Click People Connections to display People Connections preferences.

3. Click the Profile tab to bring it forward (Figure 30-12).

Figure 30-12 Profile Preferences

For each section of your personal profile, specify the users who can view it:

- Everyone—All users, including users who are not logged in, can view the associated section of your Profile.

- Authenticated Users—Only users who are logged in can view the associated section of your Profile.

- User's Connections—Only you and your connections can view the associated section of your Profile.

- User Only—Only you can view the associated section of your Profile.

4. Click OK.

30.4 Adding a Profile Task Flow to a Page

For the steps to add a Profile task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

30.5 Viewing and Editing Personal Profiles

Profile task flows provide quick access to contact and status information about you and your connections. This section describes how to use the features offered through Profile task flows. It includes the following subsections:

- Section 30.5.1, "Viewing Profile Details"

- Section 30.5.2, "Editing Your Personal Profile"

- Section 30.5.3, "Uploading and Updating a Personal Profile Picture"

See Also:

Advanced users can extend WebCenter Spaces by customizing user Profile attributes. For more information, read the white paper, "Using WebCenter Spaces Extension Samples (11.1.1.5.0)," available on the Oracle Technology Network at http://www.oracle.com/technetwork/index.htm.

30.5.1 Viewing Profile Details

You can view your full profile details by clicking your user name, provided it appears in the application chrome. For example, in Figure 30-13 the user name Josie Smith appears at the top of the application.

Figure 30-13 User Name at Top of Application

On the resulting page, click the About tab to view your full profile details (Figure 30-14).

Figure 30-14 About Subpage on Profile Page

You can view summary profile details for yourself, all of your connections, and all of the members of the Spaces for which you have access (through the Members task flow) simply by clicking a user name wherever it appears in the application context. Clicking a name opens a Profile popup (Figure 30-15).

Figure 30-15 Profile Popup

In some application contexts, such as in a Document Library or on an announcement, a context menu opens in lieu of a Profile popup. Click the user name and select View Profile Gallery from the resulting context menu (Figure 30-16) to access a view of the user's profile gallery.

Figure 30-16 View Profile Gallery Option on the Documents Page

30.5.2 Editing Your Personal Profile

Your application administrator determines how much of your personal profile you may revise (for more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."). When you have permission to revise your Profile, an Edit link is shown on the Profile page (Figure 30-17).

Figure 30-17 Edit Button on a Profile

Click the Edit button to open an edit view of your personal profile.

Note:

Even when your application administrator has enabled the editing of a particular Profile section, all fields in that section may not be editable.

To edit your personal profile:

1. Open your Profile page.

See Also:

For more information, see Section 30.5.1, "Viewing Profile Details."

2. Click Edit to open your Profile in edit mode (Figure 30-18).

Figure 30-18 Profile in Edit Mode

3. Make your changes, and click Save.

30.5.3 Uploading and Updating a Personal Profile Picture

Provided the Profile task flow is configured to allow it, users with a personal Profile can upload or update their Profile image.

Note:

The file must have the mime-type image, and cannot have the extension *.ico.

The task flow property Allow photo upload must be set to #{true}. For more information, see Section 30.6, "Setting Profile Task Flow Properties."

To upload or update your profile image:

1. Open your Profile page.

See Also:

For more information, see Section 30.5.1, "Viewing Profile Details."

2. Click the Change Photo link to open the Upload Photo dialog (Figure 30-19).

Figure 30-19 Change Photo Link and Upload Photo Dialog

3. Click Browse to locate and select a photo.

4. Click OK to complete the upload.

When you update your profile photo (as opposed to providing a new one), additional dialogs may come into play. When you click the Change Photo link, the Upload Photo dialog opens, displaying the name of the current file along with an Update button (Figure 30-20).

Figure 30-20 Upload Photo Dialog (Update Photo)

Click Update to open the Upload Photo dialog depicted in Figure 30-19, and complete the process as described in this section.

30.6 Setting Profile Task Flow Properties

Profile task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 30-21).

Figure 30-21 Profile Task Flow Component Properties Dialog

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties associated with Profile task flows and describe the properties available on the Parameters tab:

- Section 30.6.1, "What You Should Know About Profile Task Flow Properties"

- Section 30.6.2, "Profile Task Flow Parameters"

- Section 30.6.3, "Using Properties to Configure a Profile Task Flow Instance"

30.6.1 What You Should Know About Profile Task Flow Properties

When you set property values on a Profile task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog can affect the default task flow content. For descriptions of the parameters on this tab, see Section 30.6.2, "Profile Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

30.6.2 Profile Task Flow Parameters

Table 30-1 describes the parameters that are unique to Profile task flows.

Table 30-1 Profile Task Flow Parameters

Parameter

Description

Allow photo upload

A Boolean value representing whether the task flow exposes a means of uploading a profile photo

Check for #{true}, clear for #{false}.

This parameter is associated with the Profile - Snapshot task flow.

Allow status update

A Boolean value representing whether the Profile - Snapshot task flow exposes a means of entering a personal status message

Check for #{true}, clear for #{false}.

If status updates are enabled (#{true}), users can enter updates through an embedded Publisher task flow. For information about the Publisher task flow, see Section 34.3.3, "Sharing Items, Files, and URLs Through the Publisher Task Flow."

This parameter is associated with the Profile – Snapshot task flow.

Control Panel Shown

A Boolean value representing whether a control panel for manipulating the style, alignment, and size of the content is available on the runtime task flow instance

Check for #{true}, clear for #{false}.

This parameter is associated with the Organization View task flow.

Edit Mode

A means of determining whether to display Profile details as editable without requiring specific navigation to an editable view

- Enter #{true} to always show Profile details in edit mode.

- Enter #{false} to show Profile details as read-only.

When the value is set to #{false}, users click an Edit button to take Profile details into edit mode. Note that this parameter is recognized only if the parameter sectionWiseEditEnabled is set to #{false}.

This parameter is associated with the Profile task flow.

Image Size

The size of the Profile photo to show

Values can be one of: ORIGINAL, LARGE, MEDIUM, SMALL.

This parameter is associated with the Profile – Snapshot task flow.

Org Bread Crumbs Shown

A Boolean value representing whether a breadcrumbs component delineating the user's upward path in the organization hierarchy is shown

Check for #{true}, clear for #{false}.

This parameter is associated with the Profile - Snapshot task flow.

Profile Edit Link Shown

A Boolean value representing whether a link to edit the user Profile is shown

Check for #{true}, clear for #{false}.

This link does not perform any operation, but instead leads to a region navigation event (to the same view), which the consumer can listen to and perform navigation appropriately.

Out of the box, the My Profile business role page, which contains the Profile - Snapshot task flow, is wired to the Profile task flow on the About subpage. Upon receiving a region navigation event from the Profile - Snapshot task flow, clicking the Edit link switches the Edit Mode parameter of the Profile task flow on the About subpage, effectively toggling the mode. Because of this out-of-the-box wiring, the Edit link works on the My Profile business role page. If you plan to expose the Profile Edit link, you must retain the code to listen to the region navigation event and provide the same type of wiring to the target task flow.

This parameter is associated with the Profile - Snapshot task flow.

Profile ID

The ID of the user to display in the task flow

The value for this parameter, #{securityContext.userName}, is set automatically. The value is an Expression Language expression that returns the name of the current user.

For information about Expression Language expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the Profile task flow.

Resource Id

The ID of the user to display in the task flow

The value for this parameter, #{securityContext.userName}, is set automatically. The value is an Expression Language expression that returns the name of the current user.

For information about Expression Language expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the Profile Gallery task flow.

Section-Wise Edit Enabled

A means of enabling or disabling section-by-section edit capability on the task flow

- Enter #{true} to enable section-by-section editing. An Edit button is shown on each editable Profile section.

- Enter #{false} to disable section-by-section editing. One Edit button is shown for the whole task flow.

This parameter is associated with the Profile task flow.

User Id

The ID of the user to display in the task flow

The value for this parameter, #{securityContext.userName}, is set automatically. The value is an Expression Language expression that returns the name of the current user.

For information about Expression Language expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the Organization View task flow.

User Name

The ID of the user to display in the task flow

The value for this parameter, #{securityContext.userName}, is set automatically. The value is an Expression Language expression that returns the name of the current user.

For information about Expression Language expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the Profile - Snapshot task flow.

30.6.3 Using Properties to Configure a Profile Task Flow Instance

This section provides examples of how you use property values to affect the behavior of a given task flow instance. It includes the following subsections:

- Section 30.6.3.1, "Change Profile Photo in Profile - Snapshot Task Flow"

- Section 30.6.3.2, "Post a Status Update"

- Section 30.6.3.3, "Expose Additional Controls in Organization View"

- Section 30.6.3.4, "Enable Continuous Edits of Profile Details"

- Section 30.6.3.5, "Setting Size of Profile Images in Profile - Snapshot Task Flow"

- Section 30.6.3.6, "Exposing Navigational Breadcrumbs in Profile - Snapshot"

- Section 30.6.3.7, "Enabling Section-By-Section Profile Editing"

30.6.3.1 Change Profile Photo in Profile - Snapshot Task Flow

Use the property Allow photo upload to enable users to upload their own Profile photos in an instance of the Profile - Snapshot task flow. Photos uploaded to Profile - Snapshot are persisted to all other Profile task flows that expose a photo.

To enable users to change their Profile photo in the Profile - Snapshot task flow:

1. Edit the properties of a Profile - Snapshot task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Allow photo upload:

- Select the checkbox (#{true}) to enable users to change their Profile photo on the task flow instance. When you apply this change, Upload and Refresh controls appear close to the photo display area (Figure 30-22).

Figure 30-22 Upload and Refresh Icons on Profile - Snapshot Task Flow

- Clear the checkbox (#{false}) to disable this feature.

4. Click OK.

30.6.3.2 Post a Status Update

Use the property Allow Status Update to show or hide a means of entering a personal status message in the Profile - Snapshot task flow. If status updates are enabled, users can enter their status messages through an embedded Publisher task flow (Figure 30-23).

Figure 30-23 Publisher Task Flow in Profile - Snapshot

See Also:

For information about the Publisher task flow, see Section 34.3.3.1, "What You Should Know About the Publisher Task Flow."

When this property is enabled, whenever the current user posts a status message using the Publisher task flow, it is also posted as a Profile status message to Profile - Snapshot, Profile Gallery, and Profile task flows.

To enable users to post a status update to their Profile:

1. Edit the properties of a Profile - Snapshot task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Allow Status Update:

- Select the checkbox (#{true}) to expose controls for updating Profile status in the Profile - Snapshot task flow.

- Clear the checkbox (#{false}) to hide this feature.

4. Click OK.

30.6.3.3 Expose Additional Controls in Organization View

The Organization View task flow provides additional controls for manipulating your view of task flow content (Figure 30-24).

Figure 30-24 Control Panel Shown in Organization View

Use additional controls to zoom in and out and select a display format.

Use the property Control Panel Shown to expose these controls in an instance of the Organization View task flow.

To expose additional controls in an Organization View task flow:

1. Edit the properties of an Organization View task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Control Panel Shown:

- Select the checkbox (#{true}) to expose the Organization View control panel.

- Clear the checkbox (#{false}) to disable this feature.

4. Click OK.

30.6.3.4 Enable Continuous Edits of Profile Details

Use the property Edit Mode to enable users to edit Profile details without having to specifically enter an edit mode. Users navigate to the task flow instance and make changes to editable fields without having to first click an Edit button or link.

Note:

This parameter is recognized only if the parameter sectionWiseEditEnabled is set to #{false}. For more information, see Section 30.6.3.7, "Enabling Section-By-Section Profile Editing."

To enable continuous edits of Profile details:

1. Edit the properties of a Profile task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Edit Mode:

- Enter #{true} to always show Profile details in edit mode.

- Enter #{false} to disable this feature. When the value is set to #{false}, users click an Edit button to take Profile details into edit mode.

4. Click OK.

30.6.3.5 Setting Size of Profile Images in Profile - Snapshot Task Flow

Use the property Image Size to specify the display size of images that are uploaded through a Profile - Snapshot task flow. The value you enter affects the size of the photo in only the given task flow instance. No other types of Profile task flows and no other task flow instances are affected.

To set the size of a Profile image in the Profile - Snapshot task flow:

1. Edit the properties of a Profile - Snapshot task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Enter a value for the property Image Size:

- ORIGINAL (Figure 30-25)

Figure 30-25 Image Size Set to ORIGINAL

- SMALL (Figure 30-26)

Figure 30-26 Image Size Set to SMALL

- MEDIUM (Figure 30-27)

Figure 30-27 Image Size Set to MEDIUM

- LARGE (Figure 30-28)

Figure 30-28 Image Size Set to LARGE

4. Click OK.

30.6.3.6 Exposing Navigational Breadcrumbs in Profile - Snapshot

Use the property Org Bread Crumbs Shown to enable the display of breadcrumbs that visualize the current users position in the organization hierarchy (Figure 30-29).

Figure 30-29 Breadcrumbs in Profile - Snapshot Task Flow

Users can click a name in the hierarchy to navigate to a view of that user's Profile.

To expose navigational breadcrumbs in a Profile - Snapshot task flow:

1. Edit the properties of a Profile - Snapshot task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Set a value for Org Bread Crumbs Shown:

- Select the checkbox (#{true}) to expose hierarchical breadcrumbs.

- Clear the checkbox (#{false}) to disable this feature.

4. Click OK.

30.6.3.7 Enabling Section-By-Section Profile Editing

Use the Section-Wise Edit Enabled property to specify whether section-by-section editing is enabled, exposing Edit buttons on each editable section of a Profile task flow instance, or disabled, exposing only a single Edit button for the entire Profile (Figure 30-30).

Figure 30-30 Section-Wise Edit Enabled Parameter Enabled

Note:

Whether Profile details are editable in all Profile task flow instances is determined by your application administrator. For more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."

To enable section-by-section editing in a Profile task flow instance:

1. Edit the properties of a Profile task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Set a value for Section-Wise Edit Enabled:

- Enter (#{true}) to enable section-by-section editing of the Profile task flow instance. Edit buttons are shown on each details section.

- Clear the checkbox (#{false}) to disable section-by-section editing of the Profile task flow instance. One Edit button is shown for all Profile details.

4. Click OK.

31 Creating Your Social Network

In WebCenter Spaces, Connections provides a means of establishing a social network that is comprised of your work friends and associates. Once you have connected with others, you can set up your working environment to provide different levels of access to those who are and are not connected to you. For example, you can enable access to your views of Profile, Message Board, Activity Stream, and Feedback to just your connections, leaving the unconnected without access. For Message Board and Feedback, you can give everyone view access, but limit post access to just your connections or to a limited set of your connections through a connections list.

This chapter provides an overview of Connections task flows and steps you through the tasks you can accomplish using them. It includes the following subsections:

- Section 31.1, "What You Should Know About Connections"

- Section 31.2, "Setting Connections Preferences"

- Section 31.3, "Adding a Connections Task Flow to a Page"

- Section 31.4, "Setting Up Your Social Network"

- Section 31.5, "Setting Connections Task Flow Properties"

Audience

This chapter is intended for users assigned an application role that includes, minimally, the permission People Connections: Connect with People. To work with connections lists, users must also be granted the permission People Connections: Update People Connections Data.

Users who plan to edit task flow properties must be assigned a role that also includes the permission Edit Pages. In a Space (other than the Home Space), users must be assigned a role that includes the permission Edit Page Access and Structure.

31.1 What You Should Know About Connections

Connections provides a means of collecting your business friends and contacts into a social network. It furnishes tools for managing your own connections and viewing the connections of others. Using People Connections Preferences, you can grant differing levels of access to those who are and are not your connections. For example, you can limit view privileges on your Profile to just your connections or enable your connections to view certain sections of your Profile, while hiding those sections from users who are not your connections.

See Also:

For information about setting your Connections Preferences, see Section 31.2, "Setting Connections Preferences."

When you connect with other users, you give them access to your People Connections views, and gain access to theirs.

Note:

The People Connections service encompasses Connections, Profile, Activity Stream, Message Board, and Feedback. For more information, see:

- Chapter 30, "Managing Your Profile"

- Chapter 32, "Tracking Your Connections' Activities"

- Chapter 33, "Posting and Managing Messages and Feedback"

Before you begin to build your social network, your application administrator can set global application defaults that affect what all users may see and do with their own and other users' connections. For more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."

WebCenter Spaces provides the following Connections task flows:

- Connections for viewing and managing your connections, creating connections lists, and sending and responding to invitations to connect (Figure 31-1)

Figure 31-1 Connections Task Flow

- Connections - Card for photos, status messages, and instant contact options to your connections (Figure 31-2)

Figure 31-2 Connections - Card Task Flow

- Connections - Detailed View for photos and quick access to your connections and to features for inviting new connections, managing existing connections, and organizing your connections into lists (Figure 31-3)

Figure 31-3 Connections - Detailed View Task Flow

- Connections - Quick View for photos and quick access to your connections (Figure 31-4)

Figure 31-4 Connections - Quick View Task Flow

Connections task flows have associated properties that you can use to control the appearance and behavior of a task flow instance. For example, you can use Connections properties to specify the number of connections to show or the number of rows to show in Connections - Card and Connections - Quick View task flows.

See Also:

For more information about Connections properties, see Section 31.5, "Setting Connections Task Flow Properties."

For information about using Connections features, see Section 31.4, "Setting Up Your Social Network."

31.2 Setting Connections Preferences

Use Connections Preferences to specify who can view information about the people you have connected with and whether to accept invitations to be others' connections automatically.

To set Connections preferences:

1. Open the Preferences dialog.

2. Click People Connections to display People Connections preferences.

3. Click the Connections tab to bring it forward (Figure 31-5).

Figure 31-5 Connections Preferences

4. From the Grant View Access to dropdown list, select the users who can view your list of connections:

- Everyone—All users, including users who are not logged in, can see information about your connections.

- Authenticated Users—Only users who are logged in can view your connections.

- User's Connections—Only you and your Connections can view your connections.

- User Only—Only you can view your connections.

Note:

The Grant View Access to dropdown is disabled in your view if the administrator disables user override for these settings in Connections configuration settings. For more information, see Section 6.4.3.3, "Configuring Connections."

5. Select Accept Invitations Automatically to automatically accept invitations to connect with another user.

Clear this checkbox to leave yourself the option of accepting, refusing, or ignoring an invitation to connect with another user.

6. Click OK.

31.3 Adding a Connections Task Flow to a Page

For the steps to add a People Connections service task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

31.4 Setting Up Your Social Network

Connections provides the core features for building and visualizing your social network. Use Connections task flows to invite other users to connect, to accept connection invitations, to create connections lists, and to remove obsolete connections.

Note:

The level of access you have to a connection is determined by the People Connections defaults set by the application administrator, a given connection's People Connections Preference settings, and properties set on a Connections task flow instance.

For information about Connections Preferences, see Section 31.2, "Setting Connections Preferences." For information about People Connections defaults set by the application administrator, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces." For information about Connections task flow properties, see Section 31.5, "Setting Connections Task Flow Properties."

This section provides information about using Connections to set up and manage your personal social network. It contains the following subsections:

- Section 31.4.1, "Viewing Your Connections"

- Section 31.4.2, "Inviting Others to Connect"

- Section 31.4.4, "Responding to Invitations to Be a Connection"

- Section 31.4.5, "Creating and Managing Connections Lists"

- Section 31.4.6, "Removing a Connection"

31.4.1 Viewing Your Connections

You can view your connections in any Connections task flow. One of these is always available on the Connections page, which you can navigate to by clicking your user name wherever it appears in the application. In large lists of connections, you can use a search feature to locate a particular connection.

This section describes how to access the Connections page and view or search through your connections. It includes the following subsections:

- Section 31.4.1.1, "Viewing Your Connections"

- Section 31.4.1.2, "Searching Through Your Connections"

31.4.1.1 Viewing Your Connections

To view your connections:

1. Go to the Home Space, and open the Profile page, for example, by clicking on your user name in the UI.

You can also use the following URL to navigate to a Profile page:

http://host:port/webcenter/spaces/profile/userName

Tip:

For userName:

- When userName matches the current user or is not specified, this URL navigates to your view of the Profile page.

- When userName is not the current user's, it navigates to the specified user's view of the Profile page.

2. On the resulting page, click the Connections tab to bring it forward (Figure 31-6).

Figure 31-6 Connections Tab on Profile Page

3. From the Show dropdown, select All Connections.

31.4.1.2 Searching Through Your Connections

The Connections search feature provides an efficient way to locate a particular connection in an otherwise long list of connections.

To search through your connections:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. From the Show dropdown, select All Connections.

3. In the Filter field, enter the user name of the connection, and click the Find connection icon next to the field.

Tip:

Click a connection name to open a Profile dialog and view profile details.

To exit the search, click the Clear icon that appears to the right of the Filter field (Figure 31-7).

Figure 31-7 Clear Icon Next to Filter Field

31.4.2 Inviting Others to Connect

Connecting to another user potentially provides view access to that user's personal Profile and Activity Stream, and view and post access to the user's Message Board. The level of access you have to a connection is determined by the People Connections defaults set by the application administrator, the individual user's People Connections Preference settings, and properties set on the task flow instance.

See Also:

For information about Connections Preferences, see Section 31.2, "Setting Connections Preferences." For information about People Connections defaults set by the application administrator, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces." For information about Connections task flow properties, see Section 31.5, "Setting Connections Task Flow Properties."

You can issue invitations from the Connections - Detailed View task flow and from the Connections page that you access in the Home Space. This section describes the Connections page method.

To invite another user to connect:

1. Go to the Connections page, for example, by clicking your user name in the UI and then selecting the Connections subpage on the resulting Profile page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. On the Connections page, click the Invite People link to open the Invite People dialog.

3. In the Find User field, enter the user name of the person you want to invite to be your connection, then click the Find user icon (Figure 31-8).

Figure 31-8 Invite People Dialog

4. Click the Invite link next to the user of interest to open the Invitation Message dialog (Figure 31-9).

Figure 31-9 Invitation Message Dialog

5. Enter a connection invitation or use the default message.

6. Optionally, from the Select connection lists dropdown, select one or more connections lists to which to add the user once the invitation is accepted.

7. Click Invite.

If the person you have invited set Preferences to automatically accept all invitations, you are connected immediately. Otherwise, the invitation becomes available in the recipient's view of the Connections page.

Tip:

You can also view invitations from the Connections - Detailed View task flow For more information, see Section 31.4.3, "Viewing Invitations to Connect."

See Also:

For information about Connections Preferences, see Section 31.2, "Setting Connections Preferences."

31.4.3 Viewing Invitations to Connect

You can view the invitations you have sent and received in the Connections - Detailed View task flow and on the Connections page. This section describes the Connections page case. It includes the following subsections:

- Section 31.4.3.1, "Viewing Invitations You Have Sent"

- Section 31.4.3.2, "Viewing Invitations You Have Received"

31.4.3.1 Viewing Invitations You Have Sent

To view invitations you have sent:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. From the Show menu, select Sent Invitations.

The Connections page refreshes, now showing a list of the pending invitations to connect that you have sent (Figure 31-10).

Figure 31-10 Sent Invitations View

Note:

In the Show menu, the number next to Sent Invitations represents the number of pending invitations you have sent.

31.4.3.2 Viewing Invitations You Have Received

To view invitations you have received:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. From the Show menu, select Pending Invitations.

The Connections page refreshes, now showing a list of the pending invitations to connect that you have received (Figure 31-11).

Figure 31-11 Pending Invitations View

Tip:

In the Show menu, the number next to Pending Invitations represents the number of pending invitations you have received.

31.4.4 Responding to Invitations to Be a Connection

Connections provides two methods for responding to an invitation to connect:

- You can set your Connections Preferences to accept such invitations automatically.

See Also:

For information about setting Connections Preferences, see Section 31.2, "Setting Connections Preferences."

- You can manually accept, decline, or ignore such invitations through the Connections - Detailed View task flow or in your view of the Connections page.

This section describes the manual method of responding to invitations to connect from the Connections page.

To respond to invitations to connect:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. From the Show menu, select Pending Invitations to display a list of your pending invitations (Figure 31-12).

Figure 31-12 Pending Invitations View Showing Accept, Decline, and Ignore Buttons

Tip:

Alternatively, click the Invitations icon (flag).

3. Next to a given invitation, click your desired response.

Choose from:

- Accept—Make the connection.

- Decline—Refuse the connection, with notification. When you decline an invitation to connect, the issuer becomes aware of this by watching his sent invitations.

- Ignore—Remove the connection, without responding. When you ignore an invitation to connect, the issuer does not become aware of this by watching his sent invitations.

Once you respond to an invitation, it is removed from the list of received invitations. The users whose invitations you accept appear in your view of the Connections page.

4. Optionally, return to your default view of the Connections page by selecting All Connections from the Show menu.

31.4.5 Creating and Managing Connections Lists

Connections provides a means of grouping your connections into lists for managing the display of your connections and your connections activities. For example:

- You can select a list and view just its members on your Connections page.

- You can configure a Connections - Card task flow instance to display only the connections on a specified list (for more information, see Section 31.5, "Setting Connections Task Flow Properties").

- You can configure Activity Stream Preferences to show activities only from specified connections lists (for more information, see Chapter 32, "Tracking Your Connections' Activities").

This section describes how to create and manage lists of connections. It includes the following subsections:

- Section 31.4.5.1, "Creating a Connections List"

- Section 31.4.5.2, "Adding a Connection to a List"

- Section 31.4.5.3, "Removing a Connection from a List"

- Section 31.4.5.4, "Deleting a Connections List"

31.4.5.1 Creating a Connections List

You can create a connections list using the Connections and Connections - Detailed View task flows and on the Connections page. This section describes how to create a connections list on the Connections page.

To create a list of connections:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. Click Organize to open the Organize Connections and Lists dialog (Figure 31-13).

Figure 31-13 Organize Button and Resulting Dialog

3. Click New Connection List to open the Create List dialog

4. Enter a name for your list of connections, and click OK to create the list and open it in the Organize Connections and Lists dialog (Figure 31-14).

Figure 31-14 New ST Team Connections List

Tip:

To view all of your connections, click All connections.

See Also:

For information about adding connections to a list, see Section 31.4.5.2, "Adding a Connection to a List."

31.4.5.2 Adding a Connection to a List

You can add connections to a Connections list using the Connections page and the Connections and Connections - Detailed View task flows. This section describes the Connections page case.

To add a connection to a Connections list:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. Click Organize to open the Organize Connections and Lists dialog, and select All connections, to show all of your connections (Figure 31-15).

Figure 31-15 Organize Connections and Lists Dialog

3. Click Add to List next to the user, and select one or more lists from the resulting dialog (Figure 31-16).

Figure 31-16 Add to List Dialog

4. Click Save and Close.

Tip:

Click All to add the selected user to all of your Connections lists.

5. Repeat steps 3 and 4 until you are done.

6. Click OK to close the Organize Connections and Lists dialog.

31.4.5.3 Removing a Connection from a List

To remove a connection from a list:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. Click Organize to open the Organize Connections and Lists dialog, and select the list from which to remove a connection to show the list (Figure 31-17).

Figure 31-17 Organize Connections and Lists Dialog with ST Team List Selected

3. Click Remove from List next to the user to open the Remove from List dialog (Figure 31-18).

Figure 31-18 Remove from List Dialog

4. Select one or more lists from which to remove the selected user, or select My Connections and All My Lists to remove the selected user from all lists and as your connection.

5. Click Save and Close.

6. Repeat steps 3 through 5 until you are done.

7. Click OK to close the Organize Connections and Lists dialog.

31.4.5.4 Deleting a Connections List

When you delete a Connections list, you are not deleting the connections you added to the list. You are deleting only the selected grouping, that is, the list itself. The connections that were on the deleted list continue to be your connections.

You can delete a Connections list from the Connections page and from the Connections and Connections - Detailed View task flows. This section describes the Connections page case.

To delete a connections list:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. Click Organize to open the Organize Connections and Lists dialog.

3. Click the Actions icon next to the Connections list you want to delete, and select Delete List from the resulting menu (Figure 31-19).

Figure 31-19 Delete List Option on Actions Menu

4. In the resulting confirmation dialog, click Yes to delete the list.

5. Click OK to close the Organize Connections and Lists dialog.

31.4.6 Removing a Connection

Included in the process of managing your connections is the occasional necessity of weeding people out: they may leave your group or the company, or there may no longer be a compelling reason to stay connected.

Controls for removing a connection are available through the Connections page and the Connections and Connections - Detailed View task flow. This section describes the Connections Page case.

To remove one of your connections:

1. Go to the Connections page.

See Also:

For more information, see Section 31.4.1.1, "Viewing Your Connections."

2. Click Organize to open the Organize Connections and Lists dialog.

3. Click the Remove button next to the connection to remove.

4. In the resulting dialog, click Yes to remove the selected connection (Figure 31-20).

Figure 31-20 Confirmation Dialog for Remove Connection Action

5. Click OK to close the Organize Connections and Lists dialog.

31.5 Setting Connections Task Flow Properties

Connections task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 31-21).

Figure 31-21 Connections Task Flow Component Properties

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties associated with Connections task flows and describe the properties available on the Parameters tab:

- Section 31.5.1, "What You Should Know About Connections Task Flow Properties"

- Section 31.5.2, "Connections Task Flow Parameters"

- Section 31.5.3, "Using Properties to Configure a Connections Task Flow Instance"

31.5.1 What You Should Know About Connections Task Flow Properties

When you set property values on a Connections task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 31.5.2, "Connections Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

31.5.2 Connections Task Flow Parameters

Table 31-1 describes the parameters that are unique to Connections task flows.

Table 31-1 Connections Task Flow Parameters

Parameter

Description

Allow Remove

A Boolean value representing whether a control is available on the task flow for removing a connection

Enter either true or false.

This value is honored only when the task flow instance is rendered in list format. For more information, see Profile Format.

This parameter is associated with the Connections - Card task flow.

Connection List Name

The name of a grouped list of connections

Use this parameter to limit the display of connections to those on the specified Connections list.

Enter the name of a Connections list.

This parameter is associated with the Connections - Card task flow.

Current View

The view to display by default

Valid values include:

- connections—(the default value) a list of connections

- receivedInvitations—a list of connections invitations you received

- sentInvitations—a list of connections invitations you sent

- people—a search field for finding people with whom to connect

When users access the task flow instance, the view specified here is the first one they see. All selections, except people, provide controls for navigating to the application default view (connections). Selecting people provides search and select controls for inviting other users to connect.

This parameter is associated with the Connections task flow.

Filter Pattern

A value to act as a filter against task flow content

For example, to show only those connections with a user name that includes the term pat (including patrick or sripathy), enter pat in the Filter Pattern field.

This parameter is associated with the Connections - Card task flow.

Hide Footer

A Boolean value representing whether to hide the task flow footer

Use this parameter to show or hide a link at the bottom of the task flow that enables users (when shown) to navigate to a detailed view of Connections when the number of available connections exceeds the number of connections that are shown.

- Select the checkbox (#{true}) to hide the task flow footer.

- Clear the checkbox (#{false}) to show the task flow footer.

This parameter is associated with the following task flows:

- Connections – Card

- Connections – Quick View

Hide Header

A Boolean value representing whether to hide the task flow header

Use this parameter to show or hide a link at the bottom of the task flow that enables users (when shown) to navigate to a detailed view of Connections when the number of available connections exceeds the number of connections that are shown.

- Select the checkbox (#{true}) to hide the task flow header.

- Clear the checkbox (#{false}) to show the task flow header.

This parameter is associated with the Connections - Quick View task flow.

Number of Columns

The number of columns to show in the task flow

For example, with six connections to show, a value of 2 means those connections are shown in two columns with three rows.

When a user's number of connections exceeds the number of connections allowed after column and row restrictions are applied, Previous and Next links are shown, enabling the user to page through his connections. (See also Number of Rows.)

This parameter is associated with the following task flows:

- Connections - Card

- Connections - Quick View

Number of Connections per page

The number of connections to show in the given task flow instance

Enter a numeric value, such as 10, 2, 15, and so on.

The number you enter here limits the number of connections that are shown in the task flow instance. If a user's number of connections exceeds the specified value, a More link is shown, enabling the user to navigate to a full view of the Profile page's Connections subpage.

This parameter is ignored if both the number of rows and the number of columns have been specified together as parameters.

This parameter is associated with the following task flows:

- Connections - Card

- Connections - Detailed View

- Connections - Quick View

Number of Rows

The number of rows to show in the task flow

For example, with six connections to show and a value of 2 for Number of Columns, a value of 2 for Number of Rows means connections are shown in two columns with two rows. That is, four connections are shown.

When a user's number of connections exceeds the number of connections allowed after column and row restrictions are applied, Previous and Next links are shown, enabling the user to page through his connections. (See also, Number of Columns.)

This parameter is associated with the following task flows:

- Connections - Card

- Connections - Quick View

Number of Rows (list layout)

The number of rows to show in a list layout of the Connections task flow

This value is honored only when the view of the Connections task flow is set to connections. (For more information, see Current View.)

When a user's number of connections exceeds the number of connections allowed after row restrictions are applied, Previous and Next links are shown, enabling the user to page through his connections.

This parameter is associated with the Connections task flow.

Profile Format

The layout style for the task flow

Enter one of the following:

- vcard—Renders each connection in a virtual business card and includes the connection's user name and status message and quick-access buttons for interacting with your connections.

- iconic—Renders the connection's personal profile photo and shows the user name below the photo.

- list—Renders connections in a list, showing the personal profile photo, user name, information about recent profile updates, and quick-access buttons for interacting with your connections.

- tiled—Renders the connection's personal Profile photo and shows the user name and job title beside the photo.

This parameter is associated with the Connections - Card task flow.

Profile Launched on Selection

A Boolean value representing whether a Profile popup should open when a user clicks a connection listed in the task flow

- Select the checkbox (#{true}) to enable a Profile popup to launch when a user clicks a connection.

- Clear the checkbox (#{false}) to suppress this option.

This parameter is associated with the Connections - Card task flow.

Sort Criteria

The connections sort order

Enter LAST_ACTIVITY_TIME to sort connections in descending date/time order. Leave blank to sort alphabetically by name.

This parameter is associated with the following task flows:

- Connections - Card

- Connections - Detailed View

User Id

The ID of the user to show in the task flow

This value is set automatically (#{securityContext.userName}). Do not edit this value.

This parameter is associated with the following task flows:

- Connections - Quick View

- Connections - Detailed View

User Name

The ID of the user to show in the task flow

This value is set automatically (#{securityContext.userName}). Do not edit this value.

This parameter is associated with the following task flows:

- Connections - Card

- Connections

31.5.3 Using Properties to Configure a Connections Task Flow Instance

This section provides examples of how you use property values to affect the behavior of a given task flow instance. Because you make these changes in page edit mode (Oracle Composer), they affect all users' views of the affected task flow instance.

This section includes the following subsections:

- Section 31.5.3.1, "Adding a Remove Button to Connections - Card"

- Section 31.5.3.2, "Restricting Connections Displayed to Those on a Named List"

- Section 31.5.3.3, "Specifying an Initial View for a Connections Task Flow Instance"

- Section 31.5.3.4, "Limiting the Number of Displayed Connections"

- Section 31.5.3.5, "Specifying Numbers of Rows and Columns"

- Section 31.5.3.6, "Applying a Filter to a Connections - Card Task Flow Instance"

- Section 31.5.3.7, "Selecting a Display Format for a Connections - Card Task Flow Instance"

- Section 31.5.3.8, "Invoking a Profile Popup from a Connections - Card Task Flow Instance"

31.5.3.1 Adding a Remove Button to Connections - Card

By default, the Connections - Card task flow does not provide a control for permanently removing a connection. You can use the Allow Remove property on a Connections - Card task flow instance to render a Remove button next to each listed connection. Allow Remove is honored when the task flow's Profile Format property is set to List or Virtual Business Card.

To enable the removal of a connection in a Connections - Card task flow:

1. Edit the properties of a Connections - Card task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Set Profile Format to list.

4. Provide a value for Allow Remove:

- Select the checkbox (#{true}) to enable the display of a Remove button next to a listed connection (Figure 31-22).

Figure 31-22 Remove Icon on a Connections - Card Task Flow

- Clear the checkbox (#{false}) to disable this feature.

5. Click OK.

31.5.3.2 Restricting Connections Displayed to Those on a Named List

In an instance of the Connections - Card task flow, you can use the Connection List Name property to restrict the display of connections to only those users included on a named Connections list.

See Also:

For information about Connections lists, see Section 31.4.5, "Creating and Managing Connections Lists."

To restrict a Connections - Card task flow to a particular Connections list:

1. Edit the properties of a Connections - Card task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. In the Connection List Name field, enter the name of the Connections list to use to limit the display of connections.

4. Click OK.

31.5.3.3 Specifying an Initial View for a Connections Task Flow Instance

Use the Current View property to specify the initial view of a Connections task flow instance. For most views, users can change the default you specify here. The exception is the people view, in which there are no controls for switching to a different view.

To specify an initial view for a Connections task flow instance:

1. Edit the properties of a Connections task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. For Current View, select one of the following:

- connections—(the default value) a list of connections

- receivedInvitations—a list of connections invitations you received

- sentInvitations—a list of connections invitations you sent

- people—a search field for finding people with whom to connect

4. Click OK.

31.5.3.4 Limiting the Number of Displayed Connections

The Connections - Card, Connections - Detailed View, and Connections - Quick View task flows provide the property Number of Connections per page for limiting the number of connections to show at a time. If a user's number of connections exceeds the specified value, a link is shown at the bottom of the task flow to enable the user to navigate to a full view of the Profile page's Connections subpage.

To limit the number of displayed connections in a Connections - Card, Connections - Detailed View, or Connections - Quick View task flow instance:

1. Edit the properties of a Connections - Card, Connections - Detailed View, or Connections - Quick View task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for Number of Connections per page.

4. Click OK.

31.5.3.5 Specifying Numbers of Rows and Columns

The Connections, Connections - Card, and Connections - Quick View task flows provide properties for controlling the number of columns and rows to show at a time. When column and row values are both specified, and a user's number of connections exceeds the specified values, Previous and Next links are shown, enabling the user to page through his connections.

To specify the number of rows and columns of connections to show:

1. Edit the properties of a Connections, Connections - Card, or Connections - Quick View task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Enter a numeric value to control the number of rows to show:

- For Connections, enter a number for Number of Rows (list layout).

- For Connections - Card and Connections - Quick View, enter a number for Number of Rows.

4. For Connections - Card and Connections - Quick View, enter a numeric value in the Number of Columns field to control the number of columns to show.

5. Click OK.

31.5.3.6 Applying a Filter to a Connections - Card Task Flow Instance

The Filter Pattern property enables you to apply a filtering term that limits the display of connections in a Connections - Card task flow instance to only those who meet the filtering criteria. For example, to show only those connections with a user name that includes the term pat (including patrick or sripathy), enter pat for the Filter Pattern property.

The filter is applied to all of the information in a given card, so you can filter against things like the user's job title or name. For example, entering the term manager, ensures that only those connections whose job title includes manager are displayed in the task flow instance.

To apply a filter to a Connections - Card task flow instance:

1. Edit the properties of a Connections - Card task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Enter a filtering term for Filter Pattern.

Tip:

For example, enter a job title, a user name, or partial values, such as man.

4. Click OK.

31.5.3.7 Selecting a Display Format for a Connections - Card Task Flow Instance

The Profile Format property provides options for controlling the arrangement of connections within a Connections - Card task flow instance. Both the placement of information and the amount of information shown are affected by your selection.

To select a display format for a Connections - Card task flow instance:

1. Edit the properties of a Connections - Card task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Select a format from the Profile Format dropdown list:

- Virtual Business Card—Renders each connection in a virtual business card and includes the connection's user name and status message and quick-access buttons for interacting with your connections (Figure 31-23).

Figure 31-23 Connections - Card in Virtual Business Card Format

- Iconic—Renders the connection's personal profile photo and shows the user name below the photo (Figure 31-24).

Figure 31-24 Connections - Card in Iconic Format

- List—Renders connections in a list, showing the personal profile photo, user name, information about recent profile updates, and quick-access buttons for interacting with your connections (Figure 31-25).

Figure 31-25 Connections - Card in List Format

- Tiled—Renders the connection's personal Profile photo and shows the user name and job title beside the photo (Figure 31-26).

Figure 31-26 Connections - Card in Tiled Format

4. Click OK.

31.5.3.8 Invoking a Profile Popup from a Connections - Card Task Flow Instance

The Profile Launched on Selection property provides a means of launching a Profile popup when users click a connection name in a Connections - Card task flow instance (Figure 31-27).

Figure 31-27 Invoking a Profile Popup from the Connections - Card Task Flow

When this option is not selected, clicking a connection name in the task flow simply selects the connection.

To enable the launch of a Profile popup from a Connections - Card task flow instance:

1. Edit the properties of a Connections - Card task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Select an option for Profile Launched on Selection:

- Select the checkbox (#{true}) to enable a Profile popup to launch when a user clicks a connection.

- Clear the checkbox (#{false}) to suppress this option.

4. Click OK.

32 Tracking Your Connections' Activities

The social networking capabilities in WebCenter Spaces enable you to view and manage your own Activity Stream and to view the Activity Streams of others if they have made them available to you. Additionally, all members of a given Space can view the streamed activities of all other members without formally connecting to them when the Activity Stream is scoped to that Space.

This chapter provides an overview of Activity Stream and its associated features and functions, and catalogs the properties associated with Activity Stream task flows. It includes the following sections:

- Section 32.1, "What You Should Know About Activity Stream"

- Section 32.2, "Setting Activity Stream Preferences"

- Section 32.3, "Adding an Activity Stream Task Flow to a Page"

- Section 32.4, "Working with Activity Stream Task Flows"

- Section 32.5, "Setting Activity Stream Task Flow Properties"

Audience

This chapter is intended for users assigned an application role that includes, minimally, the permission People Connections: Update People Connections Data. Users who plan to edit task flow properties must be assigned a role that also includes the permission Edit Pages. In a Space (other than the Home Space), users must be assigned a role that includes the permission Edit Page Access and Structure.

32.1 What You Should Know About Activity Stream

In WebCenter Spaces, Activity Stream provides a streaming view of the activities of your connections, actions taken in Spaces, and business activities. For example, Activity Stream can note when you or a connection posts feedback, uploads a document, and creates a discussion forum. Additionally, it streams messages entered through the Publisher task flow.

See Also:

For information about the Publisher task flow, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

Through Activity Stream Preferences, you can select to show connection and Space activities. (Note, however, that your application administrator may disable all users from overriding application-level settings.) Through application programming interfaces (APIs), you can control the display of business activities.

See Also:

For information about tracking business activities using APIs, see the chapter, "Integrating the People Connections Service," in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

In addition to streaming messages, your Activity Stream can provide access to file attachments and web links added through the Publisher task flow. Further, users can share a streamed activity and its attachments using a Share feature, available on each streamed item.

See Also:

For information about sharing, see Section 32.4.7, "Sharing Files and other Objects Through an Activity Stream Item."

Table 32-1 lists and describes the types of activities that are reported through Activity Stream.

Note:

Delete activities do not appear per se in the Activity Stream. But references to objects, such as Joe Smith created the document file.xml, are removed from the stream when such objects are deleted.

Table 32-1 Activities Tracked by Activity Stream

Service

Tracked Activities

Scope

Activities Shared or Private

Announcements

- Create announcement

- Edit announcement

Space

Shared with other Space members

Blogs

- Create blog

- Update blog

- Space

- Home Space

- Activities on Space blogs are shared with other Space members.

- Activities on Home Space blogs are shared with the blogger's connections.

Connections

- Invitations to connect

- People are connected

Home Space

Shared with invitor and invitee's connections

Discussions

- Create forum

- Create topic

- Reply to topic

Space

Shared with other Space members

Documents

- Create document

- Edit document

- Add tag

- Remove tag

- Space

- Home Space

- Activities on Space documents are shared with other Space members.

- Activities on Home Space documents are private to user.

Feedback

- Feedback left

- Feedback received

Home Space

Shared with whomever is permitted to view such activities (for more information, see this section and Section 33.2, "Setting Message Board and Feedback Preferences."

Lists

- Create a list

- Add a row to a list

- Edit a list row

Space

Shared with other Space members

Message Board

- Message left

- Message received

Home Space

Shared with whomever is permitted to view such activities (for more information, see this section and Section 33.2, "Setting Message Board and Feedback Preferences."

Pages

- Create page

- Edit page

- Add tag

- Remove tag

- Space

- Home Space

- Activities on Space pages are shared with other Space members.

- Activities on Home Space pages are private to user.

Profiles

- Photo updated

- Profile updated

- Personal status note updated

Home Space

Shared with whomever is permitted to view such activities (for more information, see this section and Section 30.3, "Setting Profile Preferences."

Space Events

- Create an event

- Edit an Event

Space

Shared with other Space members

Spaces Management

- Create Space

- Join Space

Space

Shared with other Space members

Tagging

- Add tag

- Remove tag

Space

- Activities in a Space are shared with all Space members.

- Activities in a Home Space are shared with whomever is permitted to view such activities (for more information, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences").

Provided task flow parameters are set to do so (see Appendix 32, "Setting Activity Stream Task Flow Properties"), you can preview some file types that are added through the Publisher task flow. Activity Stream previews files through either a native web format or through UCM slide rendition. The previewer used depends on the mime type of the file to be previewed.

The mime types that use the native web format include:

- image

- htm

- text

- pdf

The mime types that use UCM slide rendition include:

- powerpoint

- powerpnt

Note that these are the only mime types that are previewed. Other mime types appear as links, which you can use to navigate to and view file content.

In page view mode, use Activity Stream Preferences to specify who can view your Activity Stream and the types of activities to show. For more information about Preferences relating to Activity Stream task flows, see Section 32.2, "Setting Activity Stream Preferences."

In page edit mode, use Activity Stream task flow properties to hide or show various controls on everyone's view of a task flow instance and to limit the types of services and objects and the specific Spaces that are tracked. For more information about Activity Stream task flow properties, see Section 32.5, "Setting Activity Stream Task Flow Properties."

WebCenter Spaces provides the following Activity Stream task flows:

- Activity Stream for viewing application activities and the activities of your connections and for providing access to the attachments added through the Share link (Figure 32-1)

Figure 32-1 Activity Stream Task Flow

This full view of Activity Stream functionality includes options for liking and commenting on listed activities and for sharing different types of objects, such as images, URLs, documents, and the like. Activity Stream also provides a means of hiding the activities and posts of a given user. You can use Activity Stream Options to show those users you have hidden.

The Activities page in the Home Space combines an instance of the Publisher task flow with the Activity Stream task flow.

See Also:

For information about the Publisher task flow, see Section 34.3.3.1, "What You Should Know About the Publisher Task Flow."

- Activity Stream - Quick View provides a summary view of application activities and the activities of your connections (Figure 32-2)

Figure 32-2 Activity Stream - Quick View Task Flow

Unlike the full view of Activity Stream, Activity Stream - Quick View does not display Like, comments, and Share links.

A hierarchy of configuration settings control what you can do with your view of the Activity Stream. The application administrator sets application-wide values on the Administration page. You can set your own personal values through People Connections Preferences. You can also set values on a given task flow instance in both page edit mode, which affects all users' views of the task flow instance (application customization), and page view mode, which affects only your view of the task flow (user customization).

Tip:

If you adjust a setting through Preferences that does not seem to affect the behavior of a task flow as you expected, it may be because settings on the task flow itself override Preferences settings.

The Activity Stream task flow provides an Options link for accessing configuration settings for a given task flow instance (Figure 32-3).

Figure 32-3 Options Link for Activity Stream Options

The Activity Stream - Quick View provides access to its own configuration settings through a pencil icon (Change the source, filter, and display options) (Figure 32-4).

Figure 32-4 Pencil Icon and Resulting Configure Dialog

Use these controls to adjust an individual task flow instance with the same kinds of settings that are provided for all of your views of Activity Stream task flows through Activity Stream Preferences (for more information, see Section 32.2, "Setting Activity Stream Preferences," and Section 32.4, "Working with Activity Stream Task Flows").

Clicking an object in an Activity Stream opens the object. For example, clicking the name of a newly created document in an Activity Stream opens the document. Clicking a user name in an Activity Stream opens a user profile pop-up. Clicking an attachment, such as a file or a URL, navigates you to that attachment.

See Also:

You can attach object to messages streamed from the Publisher task flow to the Activity Stream. For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

Activity Stream compares somewhat to the Recent Activities service, which also tracks and reports on application activities (for more information, see Chapter 69, "Working with the Recent Activities Service"). Both track the application activities of integrated services, though Activity Stream tracks a broader range. For example, Recent Activities tracks the Document, Announcements, and Discussions services, as well as page-related activities. Activity Stream tracks all of these as well as People Connections, Wikis, and Blogs. Recent Activities tracks activities no matter who performs the action. Activity Stream tracks activities performed by a user's connections. Activity Stream can be scoped to the Space (including the Home Space) in which it is placed. It also provides the name of the person performing the action. Recent Activities cannot be scoped to the Home Space, and it does not provide the name of the person who performed the action.

To summarize the basic difference between these two services: Recent Activities provides an overview of what is happening in an application. Activity Stream provides an overview of what is happening with a user's connections.

For more information, see Section 32.4, "Working with Activity Stream Task Flows."

Advanced users, such as application administrators, can archive streamed activities to relieve the burden on your storage and to maintain a record of past activities. For more information, see the section, "Activity Stream," in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

32.2 Setting Activity Stream Preferences

Use Activity Stream Preferences to specify who can view your Activity Stream; the users, services, and Spaces for which to track activities; and the activities to show in an Activity Stream task flow.

See Also:

For information about the services that Activity Stream tracks, see Table 32-1, "Activities Tracked by Activity Stream".

To set Activity Stream preferences:

1. Open the Preference dialog.

2. Click People Connections to display People Connections preferences.

3. Click the Activity Stream tab to bring it forward (Figure 32-5).

Figure 32-5 Activity Stream Preferences

4. Under People, specify whose activities to show in your view the Activity Stream:

Tip:

This setting relates only to the activities that stream from the People Connections service. Such activities include making connections, posting Feedback and Messages, adjusting your Profile, and so on.

From the dropdown list, select one option from:

- Only Me—Show only your own activities in your view of the Activity Stream.

- Me and My Connections—Show only your activities and the activities of your connections in your view of the Activity Stream.

- No Personal—Do not show any user activities in your view of the Activity Stream, including your own.

- Selected Connection Lists—Show the activities of only those users on the selected connections lists in your view of the Activity Stream.

When you select this option, all available connections lists appear below it. Select one or more connections lists to limit the display of activities to the users on those lists.

Note:

Use this option only after you have created one or more connections lists (for more information, see Section 31.4.5, "Creating and Managing Connections Lists").

5. Under Spaces, select to show activities from all available Spaces in your view of the Activity Stream (All Spaces), or omit the display of any Space activities (No Spaces).

6. Under Service Categories, select the services for which to track activities.

Select a checkbox to track the activity of a particular service; clear a checkbox to ignore the activity of a particular service.

Tip:

Selecting No Spaces in the previous step affects the outcome of your service selection: despite their selection here, services publish no activities to your view of the Activity Stream.

7. Under Privacy, identify the types of users who can see your view of the Activity Stream:

- Everyone—All users, whether they are logged in, can see your view of the Activity Stream.

- Authenticated Users—All users who are logged in can see your view of the Activity Stream.

- My Connections—The people to whom you are connected can see your view of the Activity Stream.

- Myself—Only you can see your view of the Activity Stream.

8. Click OK.

32.3 Adding an Activity Stream Task Flow to a Page

For the steps to add a People Connections service task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

32.4 Working with Activity Stream Task Flows

In page view mode, you can perform user customizations on a task flow instance that affect only your view of that task flow. Activity Stream task flows provide user customization controls for determining whose activities and what activities are streamed.

In page edit mode, you can perform application customizations on a task flow instance that affect everyone's view of that task flow. For example, Activity Stream provides controls for enabling or disabling the display of links for liking, sharing, and commenting on individual Activity Stream items. In view of this, some of the actions described in this section may not be available, depending on such customizations.

See Also:

For information about performing application-level customizations on Activity Stream task flows, see Section 32.5, "Setting Activity Stream Task Flow Properties."

This section provides information about controlling whose activities what activities are shown in a given task flow instance, as well as how to like and comment on a streamed item, and how to share a file or URL with other users through the Activity Stream.

This section includes the following subsections:

- Section 32.4.1, "Selecting the People to Stream in an Activity Stream Instance"

- Section 32.4.2, "Selecting the Spaces to Stream in an Activity Stream Instance"

- Section 32.4.3, "Selecting the Services to Stream in an Activity Stream Instance"

- Section 32.4.4, "Hiding and Showing the Activities of a Selected User"

- Section 32.4.5, "Hiding and Showing the Activities of a Selected Space"

- Section 32.4.6, "Liking and Commenting On Activity Stream Items"

- Section 32.4.7, "Sharing Files and other Objects Through an Activity Stream Item"

32.4.1 Selecting the People to Stream in an Activity Stream Instance

Use the Options link on an Activity Stream task flow instance to specify the people from whom to stream activities in your view of an Activity Stream instance. Use the pencil icon on an Activity Stream - Quick View task flow to perform the same operation.

To select the people from whom to stream activities in your view of an Activity Stream task flow instance:

1. Go to an instance of an Activity Stream or Activity Stream - Quick View task flow.

2. On an Activity Stream task flow, click Options.

On an Activity Stream - Quick View task flow, click the Change the source, filter, and display options icon (pencil).

3. For Activity Stream only: in the resulting dialog, click the Settings tab to bring it forward.

4. Under People, select the people from whom to stream activities:

- Only Me—Show only your own activities in your view of the Activity Stream.

- Me and My Connections—Show only your activities and the activities of your connections in your view of the Activity Stream.

- No Personal—Do not show any user activities in your view of the Activity Stream, including your own.

- Selected Connection Lists—Show the activities of only those users on the selected connections lists in your view of the Activity Stream.

When you select this option, all available connections lists appear below it. Select one or more connections lists to limit the display of activities to the users on those lists.

Note:

Use this option only after you have created one or more connections lists (for more information, see Section 31.4.5, "Creating and Managing Connections Lists").

5. Click Save to save your changes and exit the dialog.

32.4.2 Selecting the Spaces to Stream in an Activity Stream Instance

Use the Options link on an Activity Stream task flow instance to select the Spaces from which to stream activities. Use the pencil icon on an Activity Stream - Quick View task flow to perform the same operation.

To select the Spaces from whom to stream activities in an Activity Stream task flow instance:

1. Go to an instance of an Activity Stream or Activity Stream - Quick View task flow.

2. On an Activity Stream task flow, click Options.

On an Activity Stream - Quick View task flow, click the Change the source, filter, and display options icon (pencil).

3. For Activity Stream only: in the resulting dialog, click the Settings tab to bring it forward.

4. Under Spaces, select to show activities from all available Spaces in your view of the Activity Stream (All Spaces), or omit the display of any Space activities (No Spaces).

Tip:

Selecting No Spaces affects the outcome of your service selection (see Section 32.4.3): despite their selection, services publish no activities to your view of the Activity Stream.

5. Click Save to save your changes and exit the dialog.

32.4.3 Selecting the Services to Stream in an Activity Stream Instance

Use the Options link on an Activity Stream task flow instance to select the services from which to stream activities. Use the pencil icon on an Activity Stream - Quick View task flow to perform the same operation.

To select the services from whom to stream activities in an Activity Stream task flow instance:

1. Go to an instance of an Activity Stream or Activity Stream - Quick View task flow.

2. On an Activity Stream task flow, click Options.

On an Activity Stream - Quick View task flow, click the Change the source, filter, and display options icon (pencil).

3. For Activity Stream only: in the resulting dialog, click the Settings tab to bring it forward.

4. Under Service Categories, select the services for which to track activities.

Select a checkbox to track the activity of a particular service; clear a checkbox to ignore the activity of a particular service.

Tip:

Selecting No Spaces in Section 32.4.2 affects the outcome of your service selection: despite their selection here, services publish no activities to your view of the Activity Stream.

5. Click Save to save your changes and exit the dialog.

32.4.4 Hiding and Showing the Activities of a Selected User

Some of your connections may post activities with a frequency that is more of a distraction than a help. In this case, or for any other reason, you can select to hide the activities streamed from selected users in your view of the Activity Stream task flow (or from the Activities page in the Home Space).

You can easily reverse this action by showing one or more hidden users through the Options link on the affected Activity Stream task flow.

This section describes how to hide or show the activities of individual users in an Activity Stream task flow instance. It includes the following subsections:

- Section 32.4.4.1, "Hiding the Activities of a Selected User"

- Section 32.4.4.2, "Showing the Activities of a Hidden User"

32.4.4.1 Hiding the Activities of a Selected User

To hide the activities streaming from a selected user in an Activity Stream task flow instance:

1. Go to an instance of an Activity Stream task flow.

2. Open the Hide menu next to the user you want to hide, and select the relevant user name (Figure 32-6).

Figure 32-6 The Hide Option in the Activity Stream

3. Click OK in the confirmation dialog.

The page refreshes, and the task flow no longer shows activities from the selected user.

See Also:

For information about showing a hidden user, see Section 32.4.4.2, "Showing the Activities of a Hidden User."

32.4.4.2 Showing the Activities of a Hidden User

To reinstate the streaming of activities from a hidden user:

1. Go to an instance of an Activity Stream task flow where a user's activities are hidden.

2. Click Options.

3. In the resulting dialog, click the People tab to bring it forward.

4. Next to the person whose activities you want to show, click Show (Figure 32-7).

Figure 32-7 The Options Link and the Show Button

32.4.5 Hiding and Showing the Activities of a Selected Space

If there is a Space that streams activities that are not currently of interest to you, you can hide that Space's activities from a selected instance of the Activity Stream task flow (or from the Activities page in the Home Space).

You can easily reverse this action by showing one or more hidden Spaces through the Options link on the affected Activity Stream task flow.

In order to be able to hide the activities streaming from a particular Space, the affected Activity Stream task flow instance must be configured to show All Spaces (for more information, see Section 32.2, "Setting Activity Stream Preferences," and Section 32.4.2, "Selecting the Spaces to Stream in an Activity Stream Instance").

Tip:

Whether or not the activities streaming from Space are shown can be determined at the application level, in personal Preferences, and on an individual task flow instance in both page view mode and page edit mode. If you find you cannot hide or show activities streaming from Spaces, it is likely that at one of these levels, the facility to see such activities has been blocked.

This section describes how to hide the activities streaming from a particular Space, and how to show those hidden activities. It includes the following subsections:

- Section 32.4.5.1, "Hiding the Activities of a Selected Space"

- Section 32.4.5.2, "Showing the Activities of a Hidden Space"

32.4.5.1 Hiding the Activities of a Selected Space

To hide the activities streaming from a selected Space in an Activity Stream task flow instance:

Note:

Your Preference settings may prevent any Space activities from streaming. For information about Activity Stream Preferences, see Section 32.2, "Setting Activity Stream Preferences."

1. Go to an instance of an Activity Stream task flow.

2. Open the Hide menu next to an activity that has streamed from the Space you want to hide, and select the relevant Space name (Figure 32-8).

Figure 32-8 Selecting to Hide the Space teamsite2

3. Click OK in the confirmation dialog.

The page refreshes, and the task flow no longer shows activities from the selected Space.

See Also:

For information about showing a hidden Space, see Section 32.4.5.2, "Showing the Activities of a Hidden Space."

32.4.5.2 Showing the Activities of a Hidden Space

To reinstate the streaming of activities from a hidden Space:

1. Go to an instance of an Activity Stream task flow where a Space's activities are hidden.

2. Click Options.

3. In the resulting dialog, click the Spaces tab to bring it forward.

4. Next to the Space whose activities you want to show, click Show (Figure 32-9).

Figure 32-9 The Options Link and the Show Button in Activity Stream Options Dialog

32.4.6 Liking and Commenting On Activity Stream Items

Provided the Activity Stream task flow has been configured to do so, you and the users to whom you have provided access to your Activity Stream can express a liking for or comment on a particular streamed item.

To express a liking for a streamed item, go to an Activity Stream task flow and click the Like link. You can remove your liking by clicking the resulting Unlike link.

To comment on a streamed item, click the comments link, enter a comment in the resulting field, and click the Comment button. For each comment you add, a delete icon is provided to enable you to remove your comment.

See Also:

For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

32.4.7 Sharing Files and other Objects Through an Activity Stream Item

Provided the Activity Stream task flow is configured to support it, you can share a streamed item with all of the users who are allowed to view your streamed activities. This could be all of your connections or all of the users on a selected connections list. Who an item is shared with is determined by how you or your application administrator has configured your Activity Stream.

If you prefer, you can send a streamed item through mail, and consequently select all recipients yourself.

To share a streamed item:

1. Go to the streamed item of interest.

2. Select an option from the Share menu (Figure 32-10).

Figure 32-10 Share Menu on a Streamed Activity

- Select This activity to stream a URL to the item (such as a new Space, a new announcement or discussion topic, and the like) to all enabled users.

- Select Send Mail to send a mail with a link to the item to all specified recipients.

See Also:

For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

32.5 Setting Activity Stream Task Flow Properties

Activity Stream task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 32-11).

Figure 32-11 Activity Stream Task Flow Component Properties

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties associated with Activity Stream task flows and describe the properties available on the Parameters tab:

- Section 32.5.1, "What You Should Know About Activity Stream Task Flow Properties"

- Section 32.5.2, "Activity Stream Task Flow Parameters"

- Section 32.5.3, "Using an Advanced Query to Filter Activity Stream Items"

- Section 32.5.4, "Using Properties to Configure an Activity Stream Task Flow Instance"

32.5.1 What You Should Know About Activity Stream Task Flow Properties

When you set property values on an Activity Stream task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 32.5.2, "Activity Stream Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

32.5.2 Activity Stream Task Flow Parameters

Table 32-2 describes the parameters that are unique to Activity Stream task flows.

Table 32-2 Activity Stream Task Flow Parameters

Parameter

Description

Advanced Query

A field for specifying a custom query to filter streamed items

For more information, see Section 32.5.3, "Using an Advanced Query to Filter Activity Stream Items."

This parameter is associated with the Activity Stream task flow.

Enable Context Info

A checkbox for specifying whether contextual information is shown when users click a Context Info icon

For example, if the item John created the purchase order General Supplies appears in the Activity Stream with a Context Info icon (the reddish dot), users who see the streamed item can click the icon to view the PO in a popup or navigate to the PO, depending on how the event is configured.

This parameter is primarily for use with WebCenter Portal applications. In WebCenter Spaces, unless otherwise handled (such as the Profile popup on a user name), resources are rendered within the Resource Viewer system page (see Table 7-2, "Seeded System Pages").

- Select the checkbox to enable context information (#{true}).

- Clear the checkbox to prevent the display of context information (#{false}).

This parameter is associated with the Activity Stream task flow.

Hide Comments

A checkbox for specifying whether a comments link is shown on a task flow instance

- Select the checkbox to show the comments link (#{true}).

- Clear the checkbox to hide the comments link (#{false}).

This parameter is associated with the Activity Stream task flow.

Hide Configuration Button

A checkbox for specifying whether the Options link appears on the Activity Stream task flow or the pencil icon appears on Activity Stream - Quick View

- Select the checkbox to show the configuration control (#{true}).

- Clear the checkbox to hide the configuration control (#{false}).

This parameter is associated with the following task flows:

- Activity Stream - Quick View

- Activity Stream

Hide Footer

A checkbox for specifying whether a More link is shown at the base of the task flow

Users click the More link to navigate to the Activities business role page in the Home Space.

- Select the checkbox to hide the More link (#{true}).

- Clear the checkbox to show the More link (#{false}).

This parameter is associated with the Activity Stream - Quick View task flow.

Hide Header

A checkbox for specifying whether to hide the controls that appear in the task flow header

- Select the checkbox to hide the task flow header (#{true}). The Refresh and pencil icons are hidden.

- Clear the checkbox to show the task flow header (#{false}).

This parameter is associated with the Activity Stream - Quick View task flow.

Hide Inline Preview

A checkbox for specifying whether to hide previews of streamed files

- Select the checkbox to hide previews of streamed files (#{true}). Links to streamed files are provided but previews are omitted.

- Clear the checkbox to show previews of streamed files (#{false}). Both links to and previews of streamed files are shown.

This parameter is associated with the Activity Stream task flow.

Hide Like

A checkbox for specifying whether to hide the Like link on streamed items

- Select the checkbox to hide the Like link (#{true}).

- Clear the checkbox to show the Like link (#{false}).

This parameter is associated with the Activity Stream task flow.

Hide Share

A checkbox for specifying whether to hide the Share menu on streamed items

- Select the checkbox to hide the Share menu (#{true}).

- Clear the checkbox to show the Share menu (#{false}).

This parameter is associated with the Activity Stream task flow.

No of activities to display per page

A field for entering the number of streamed items to show per page

This parameter is associated with the following task flows:

- Activity Stream

- Activity Stream - Quick View

Pagination

A checkbox for specifying whether to provide Previous and Next links to enable users to page through streamed activities

- Select the checkbox to show Previous and Next links (#{true}).

- Clear the checkbox to hide them (#{false}).

This parameter is associated with the Activity Stream task flow.

Profile Only

A checkbox for specifying whether to stream activities only from user profiles

- Select the checkbox to stream only those activities associated with the current user (#{true}).

- Clear the checkbox to stream the activities of other users along with those associated with the current user (#{false}).

This parameter is associated with the Activity Stream task flow.

Profile User Id

A field for entering the ID of the current user

This value is provided by default, #{securityContext.userName}.

This parameter is associated with the Activity Stream - Quick View task flow.

Resource Id

A field for entering the ID of the current user

This value is provided by default, #{securityContext.userName}. Users should not change this value when the task flow instance appears in the context of a Space. You can use it in the Home Space to view the activities of a named user.

This parameter is associated with the Activity Stream task flow.

Service Categories

A field for entering the IDs of services from which to stream activities

Use this parameter to limit the display of streamed activities to only those associated with the specified service or services. Enter the service category ID or the service ID. For a list of valid service IDs, see Table B-19, "Service IDs".

This parameter is associated with the Activity Stream task flow.

Spaces

A field for entering the names of Spaces from which to stream activities

Use this parameter to limit the display of streamed activities to only those associated with the specified Space or Spaces.

Enter the GUID of the Space or the Space's internal name. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings.

Note that the activities that are streamed in an Activity Stream task flow that is scoped to a particular Space are visible to all members of that Space, regardless of whether they are formally connected to each other.

This parameter is associated with the Activity Stream task flow.

32.5.3 Using an Advanced Query to Filter Activity Stream Items

The Activity Stream task flow provides an Advanced Query parameter, which you can use to create custom filters against streamed activities using a SQL WHERE clause. For example, using SQL you can set up an Activity Stream instance to show only those activities relating to the Page service or streaming from the current user or a named user.

This section provides an overview of the Activity Stream Advanced Query option and steps you through the process of entering an advanced query. It includes the following subsections:

- Section 32.5.3.1, "What You Should Know About the Activity Stream Advanced Query Option"

- Section 32.5.3.2, "Entering an Advanced Query Against an Activity Stream Task Flow Instance"

32.5.3.1 What You Should Know About the Activity Stream Advanced Query Option

Use Advanced Query to create filters against user names, service IDs, and object details, such as a document's display name. You can use SQL syntax for parameter values. Additionally you can place EL expressions within the SQL.

You can construct queries against specific database objects, which are represented by aliases that are prefixed to the inquiry. Table 32-3 lists and describes the types of database objects against which you can construct a query and provides their alias prefixes.

See Also:

In many cases, you can use EL expressions to obtain the value you require for the supported fields and columns listed in Table 32-3. For more information, see Appendix B, "Expression Language Expressions."

Table 32-3 Supported Database Objects for Constructing a SQL WHERE Clause

Database Object

Alias Prefix

Supported Fields/Columns

ACTIVITY

AE

- SCOPE_ID—The GUID of the scope (e.g., #{serviceCtx.scope.GUID}).

- SERVICE_ID—The service ID of the service to track. See Table B-19, "Service IDs" for a list of service IDs.

- ACTIVITY_TIME—The time the activity occurs.

Use the datetime format that is supported in the SQL or target database. You can also use Oracle database SQL constructs, such as to_date().

- ACTIVITY_TYPE—The type of activity to track

For a list of valid activity type names, see Table 32-4.

ACTIVITY (ACTOR)

AD

ACTOR_NAME—The user name of the person performing the activity.

ACTIVITY (OBJECT)

OD

- SERVICE_ID—The service ID of the service from which the tracked object issues. See Table B-19, "Service IDs" for a list of service IDs.

- OBJECT_ID—The GUID of the object.

- DISPLAY_NAME—The object display name.

- OBJECT_TYPE—The object type.

Object type names for use with Advanced Query include:

- event

- announcement

- forum

- topic

- bookmark

- list

- page

- blog

- document

- wiki

Table 32-4 Activity Type Names for Advanced Query

Service

Activity Type Name

Events

- createEvent

- updateEvent

Announcements

- createAnnouncement

- updateAnnouncement

Discussions

- createForum

- createTopic

- replyTopic

Tags

- updateBookmark

Lists

- createList

- editList

Page

- createPage

- editPage

Documents

- create-blog

- update-blog

- create-document

- create-wiki

- update-document

- update-wiki

People Connections (Profile)

- updateStatus

- updateProfile

- updatePhoto

People Connections (Message Board)

- postScope

- postself

- post

- sharescope

- shareself

- share

- shareobjectscope

- shareobjectself

- shareobject

- updatescope

- updateself

- update

People Connections (Connections)

- connect

- inviteForConnection

People Connections (Feedback)

- post

The SQL string that is passed as the advanced query parameter complies with SQL standards. That is, it supports SQL constructs, such as AND, OR, IN, and the like. Note, however, that it does not support INSERT, UPDATE, DELETE, SELECT, JOIN constructs. The syntax of the advanced query must contain only the WHERE clause portion of a SQL query. Because SELECT is not supported, the WHERE clause cannot have nested queries or subqueries.

The Advanced Query parameter also supports EL expressions, which can be embedded in the WHERE clause or used to generate the whole WHERE clause.

All the literals in the query must be escaped by prepending a backward slash (\), otherwise such characters generate syntax errors (see Table 32-5 for examples).

Note that the advanced query WHERE clause is always AND'ed to the internal query that is generated by Activity Stream based on the current user, Space membership, connection list, and the like. This is to prevent a user from viewing activities to which he or she does not have access.

Table 32-5 lists examples of advanced queries.

Table 32-5 Examples of Advanced Queries for Use with Activity Stream

Use Case

Query Syntax

Stream only document creation activities.

AE.SERVICE_ID = \'oracle.webcenter.doclib\'

Stream activities only from an object or current Space.

OD.OBJECT_ID = \'objectA\' OR AE.SCOPE_ID = \'#{serviceCtx.scope.GUID}\'

Stream activities only about wikis created by the current user.

OD.OBJECT_TYPE = \'Wiki\' AND AD.ACTOR_NAME = \'#{securityContext.userName}\'

Stream activities for documents and discussions, but only create activities or all activities for the current user.

(AE.SERVICE_ID IN (\'oracle.webcenter.doclib\', \'oracle.webcenter.collab.forum\') AND AE.ACTIVITY_TYPE IN (\'createDocument\', \'createTopic\')) OR AD.ACTOR_NAME = \'#{securityContext.userName}\'

32.5.3.2 Entering an Advanced Query Against an Activity Stream Task Flow Instance

To enter an advanced query against an instance of the Activity Stream task flow:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward (Figure 32-12).

Figure 32-12 Activity Stream Task Flow Component Properties

3. Provide a value for the property Advanced Query:

See Also:

See Section 32.5.3.1, "What You Should Know About the Activity Stream Advanced Query Option," for information about the type and format of values to provide for this field.

4. Click OK.

Going forward, streamed activities are filtered by your query.

32.5.4 Using Properties to Configure an Activity Stream Task Flow Instance

This section provides examples of how you use property values to affect the behavior of a given task flow instance. It includes the following subsections:

- Section 32.5.4.1, "Preventing Users from Customizing an Activity Stream"

- Section 32.5.4.2, "Hiding File Previews in Streamed Items"

- Section 32.5.4.3, "Preventing Users from Commenting on Streamed Items"

- Section 32.5.4.4, "Preventing Users from Liking Streamed Items"

- Section 32.5.4.5, "Preventing Users from Sharing Streamed Items"

- Section 32.5.4.6, "Limiting the Stream to Activities from One or More Spaces"

- Section 32.5.4.7, "Limiting the Stream to One or More Services"

- Section 32.5.4.8, "Limiting the Stream to Your Own Activities"

32.5.4.1 Preventing Users from Customizing an Activity Stream

By default, Activity Stream task flows provide user customization controls that enable users to specify whose actions they want to see and from what services and Spaces in a given Activity Stream task flow. On the Activity Stream task flow, this is the Options link. On the Activity Stream - Quick View task flow, this is the pencil icon.

The Hide Configuration Button property is available when you want to prevent users from overriding application-level customizations with their own user-level customizations.

To prevent users from customizing an Activity Stream task flow instance:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Hide Configuration Button:

- Select the checkbox (#{true}) to omit the display of the Options link or pencil icon on the task flow instance.

- Clear the checkbox (#{false}) to show these controls on the task flow instance.

4. Click OK.

32.5.4.2 Hiding File Previews in Streamed Items

By default, when an Activity Stream item has an associated file, such as a document or an image, both a file link and a file preview are shown with the item (Figure 32-13).

Figure 32-13 Previewed File in Activity Stream

You can use the Hide Inline Preview property to suppress the file preview, leaving the link for accessing the file should users want to do so.

The Hide Inline Preview property is provide with the Activity Stream task flow.

To hide a file preview in streamed items:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Hide Inline Preview:

- Select the checkbox (#{true}) to omit the display of a file preview with items streamed from the Documents service.

- Clear the checkbox (#{false}) to show inline previews with items streamed from the Documents service.

4. Click OK.

32.5.4.3 Preventing Users from Commenting on Streamed Items

By default, a comments link is shown with all items in an Activity Stream task flow to enable users to comment on a given item (Figure 32-14).

Figure 32-14 Comments Link on a Streamed Item

You can use the Hide Comments property to suppress the display of the comments link and, consequently, prevent users from commenting on streamed items in a given task flow instance.

To prevent users from commenting on streamed items:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Hide Comments:

- Select the checkbox (#{true}) to hide the comments link on streamed items.

- Clear the checkbox (#{false}) to show the comments link on streamed items.

4. Click OK.

32.5.4.4 Preventing Users from Liking Streamed Items

By default, a Like link is shown with all items in an Activity Stream task flow to enable users to express a favorable opinion of a given item (Figure 32-15).

Figure 32-15 Like Link on a Streamed Item

Once clicked, the Like link switches to an Unlike link to enable users to undo their favorable opinion.

You can use the Hide Like property to suppress the display of the Like link, and, consequently, prevent users from liking streamed items in a given task flow instance.

To prevent users from liking streamed items:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Hide Like:

- Select the checkbox (#{true}) to hide the Like link on streamed items.

- Clear the checkbox (#{false}) to show the Like link on streamed items.

4. Click OK.

32.5.4.5 Preventing Users from Sharing Streamed Items

By default, a Share menu is shown with all items in an Activity Stream task flow to enable users to share a streamed item with their connections (Figure 32-16).

Figure 32-16 Share Menu on a Streamed Item

You can use the Hide Share property to suppress the display of the Share menu, and, consequently prevent users from sharing streamed items from a given task flow instance.

To prevent users from sharing streamed items:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Hide Share:

- Select the checkbox (#{true}) to hide the Share menu on streamed items.

- Clear the checkbox (#{false}) to show the Share menu on streamed items.

4. Click OK.

32.5.4.6 Limiting the Stream to Activities from One or More Spaces

Configuration options in both the Activity Stream and Activity Stream - Quick View task flows provide all-or-none options for streaming activities from Spaces (see Section 32.4.2, "Selecting the Spaces to Stream in an Activity Stream Instance"). The Spaces property associated with the Activity Stream task flow provides the additional dimension of selecting specific Spaces from which to stream activities.

To limit the stream to activities from one or more Spaces:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. In the Spaces field, enter a comma-separated list of the Space names or Space GUIDs from which to stream activities in this task flow instance.

Tip:

Enter the Space internal name. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings.

You can obtain the Space GUID from the About Space dialog (see Section 29.9.1, "Accessing Space Information") or by using the EL expression

4. Click OK.

32.5.4.7 Limiting the Stream to One or More Services

Configuration options for both the Activity Stream and Activity Stream - Quick View task flows provide a means of selecting the service categories from which to stream activities (see Section 32.4.3, "Selecting the Services to Stream in an Activity Stream Instance").

The Service Categories property associated with the Activity Stream task flow extends this capability by enabling you to enforce a particular selection. For example, you can specify the service category documents, and only those connections' activities that stream from the Documents service are shown in the task flow instance.

To limit streamed activities to one or more services:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. In the Service Categories field, enter a comma-separated list of the services from which to stream activities in this task flow instance.

Tip:

Enter the service category ID or the service ID. For a list of valid service IDs, see Table B-19, "Service IDs"

4. Click OK.

32.5.4.8 Limiting the Stream to Your Own Activities

You can use the Profile Only property associated with the Activity Stream task flow to limit the display of streamed activities to just your own activities.

To limit streamed activities to just your own:

1. Edit the properties of an Activity Stream task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Provide a value for the property Profile Only:

- Select the checkbox (#{true}) to show only your own activities.

- Clear the checkbox (#{false}) to stream your own and your connections' activities.

4. Click OK.

33 Posting and Managing Messages and Feedback

WebCenter Spaces provides task flows for posting messages and Feedback to your connections. Use Message Board task flows to post, view, and manage messages to and from your connections. Use Feedback task flows to post, view, and manage Feedback to and from your connections.

This chapter provides an overview of Message Board and Feedback and steps you through the process of enabling, viewing, and managing messages and Feedback. It includes the following sections:

- Section 33.1, "What You Should Know About Message Board and Feedback"

- Section 33.2, "Setting Message Board and Feedback Preferences"

- Section 33.3, "Enabling Other Users to Post Messages and Feedback for You"

- Section 33.4, "Working with Message Board and Feedback Task Flows"

- Section 33.5, "Setting Message Board and Feedback Task Flow Properties"

Audience

This chapter is intended for users assigned an application role that includes, minimally, the permission People Connections: Update People Connections Data. Users who plan to edit task flow properties must be assigned a role that also includes the permission Edit Pages. In a Space (other than the Home Space), users must be assigned a role that includes the permission Edit Page Access and Structure.

33.1 What You Should Know About Message Board and Feedback

This section provides an overview of the task flows and features associated with Message Board and Feedback. It includes the following sections:

- Section 33.1.1, "What You Should Know About Message Board"

- Section 33.1.2, "What You Should Know About Feedback"

33.1.1 What You Should Know About Message Board

Message Board provides a means of viewing and posting messages and attachments to Message Boards and Activity Streams. Messages posted to and received on a Message Board (even those marked private) are shared with all of your connections and all of the recipient's connections in their views of the Activity Stream, depending on your portal configuration and your Activity Stream preference settings.

Note:

The messages you mark private are shown only to you and the recipient in your views of Message Board. However, private messages are shared with all of your connections and with all of the recipient's connections in their views of Activity Stream, unless your administrator configures Activity Stream to omit showing actions from Message Board or you do so through your personal Activity Stream preferences. For more information, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences."

In your view of the Home Space, Message Board enables you to view messages and attachments from your connections.

Message Boards in your connections' view of the Home Spaces enable you to view the messages and attachments they have received and to post messages and attachments to their Message Boards, provided they have granted you access.

In Spaces other than the Home Space, Message Board provides a means of viewing and posting messages within the scope of the Space. In a Space, every instance of a Message Board task flow shows the same content: messages left by authorized users who are members of the Space. The Space Message Board leverages Page service permissions as its permission model.

Table 33-1 lists the page permissions required for performing actions in a Space Message Board.

Table 33-1 Page Permissions for a Space Message Board

Page Permission

Post

View

Update

Delete

View Page

No

Yes

No

No

Personalize Page

Yes

Yes

Yes for messages posted by this user

Yes for messages posted by this user

Perform All Page Actions

Yes

Yes

Yes for all messages

Yes for all messages

See Also:

For information about Space permissions, see Chapter 52, "Managing Space Members and Roles."

When you connect with other users, you potentially give them access to your Message Board and gain access to theirs. Access to other users' Message Boards must be specifically granted through Message Board Preferences.

See Also:

You can grant access to your Message Board through People Connections Preferences. For more information, see Section 33.2.1, "Setting Message Board Preferences."

Before you access your Message Board or Message Board Preferences, your application administrator can set global application defaults that affect what all users may see and do with their own and other users' Message Boards. For more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."

WebCenter Spaces provides the following Message Board task flows:

- Message Board for adding, viewing, updating, hiding, deleting, and managing your view of messages, and for marking messages as private and sharing private messages (Figure 33-1)

Figure 33-1 Message Board Task Flow

- Message Board - Quick View for adding, viewing, updating, hiding, and deleting messages, and for marking messages as private and sharing private messages (Figure 33-2)

Figure 33-2 Message Board - Quick View Task Flow

See Also:

The Publisher task flow has many qualities in common with Message Board, but is a separate feature. For more information about the Publisher task flow, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

For more information about Message Board features, see Section 33.4, "Working with Message Board and Feedback Task Flows."

33.1.2 What You Should Know About Feedback

Feedback provides a means of viewing, posting, and managing feedback remarks. By default, you can view Feedback in your own Feedback view. You can view and post Feedback in your connections' Feedback views—provided they have granted you access.

Note:

The feedback you mark private are shown only to you and the recipient in your views of Feedback task flows. However, private Feedback is shared with all of your connections and with all of the recipient's connections in their views of Activity Stream, unless your administrator configures Activity Stream to omit showing actions from Feedback or you do so through your personal Activity Stream preferences. For more information, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences."

When you connect with other users, you potentially give them access to your Feedback view and gain access to theirs. Access to other users' Feedback views must be specifically granted through Feedback preferences.

See Also:

You can grant access to your view of Feedback through People Connections preferences. For more information, see Section 33.2.2, "Setting Feedback Preferences."

Feedback posts are also streamed to the Activity Stream, unless the application administrator has configured the Activity Stream not to show Feedback activity. Additionally, you can elect not to show Feedback activity in your own view of the Activity Stream through your personal Preference settings.

See Also:

For information about administrator-level Activity Stream settings, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces." For information about your personal Activity Stream Preferences, see Section 32.2, "Setting Activity Stream Preferences."

Before you access your view of Feedback or your Feedback Preferences, your application administrator can set global application defaults that affect what all users may see and do with their own and other users' views of Feedback. For more information, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces."

WebCenter Spaces provides the following Feedback task flows:

- Feedback for viewing, posting, and managing Feedback (Figure 33-3)

Figure 33-3 Feedback Task Flow

- Feedback - Quick View for viewing and posting Feedback (Figure 33-4)

Figure 33-4 Feedback - Quick View Task Flow

See Also:

For information about business role pages, see Section 7.1, "Working with Business Role Pages."

For more information about Feedback features, see Section 33.4.2, "Working with Feedback Task Flows."

33.2 Setting Message Board and Feedback Preferences

This section describes how to use Message Board and Feedback Preferences to specify who can view and who can post messages to your view of these task flows. It includes the following subsections:

- Section 33.2.1, "Setting Message Board Preferences"

- Section 33.2.2, "Setting Feedback Preferences"

33.2.1 Setting Message Board Preferences

Use Message Board preferences to specify who can view and post to your Message Board.

To set Message Board Preferences:

1. Open the Preferences dialog.

2. Click People Connections to display People Connections Preferences.

3. Click the Message Board tab to bring it forward (Figure 33-5).

Figure 33-5 Message Board Preferences

4. Set your Preferences for the Message Board.

Table 33-2 lists and describes each option.

Table 33-2 Message Board Preference Options

Option

Description

Grant View Access to

Select who can view your Message Board:

- Everyone—All users, including users who are not logged in, can view your Message Board messages.

- Authenticated Users—Only users who are logged in can view your Message Board messages.

- User's Connections—Only you and the users you your Connections can view your Message Board messages.

- User Only—Only you can view your Message Board messages.

Grant Post Access to

Select who can post messages to your Message Board:

- Everyone—All users, including users who are not logged in, can post messages to your Message Board.

- Authenticated Users—Only users who are logged in can post messages to your Message Board.

- User's Connections—Only you and your Connections can post messages to your Message Board.

- User Only—Only you can post messages to your Message Board.

5. Click OK.

33.2.2 Setting Feedback Preferences

Use Feedback preferences to specify who can view the Feedback you have given and received and who can post Feedback in your view of Feedback task flows.

To set Feedback Preferences:

1. Open the Preferences dialog.

2. Click People Connections to display People Connections Preferences.

3. Click the Feedback tab to bring it forward (Figure 33-6).

Figure 33-6 Feedback Preferences

4. Set your Preferences for Feedback.

Table 33-3 lists and describes each option.

Table 33-3 Feedback Preference Options

Option

Description

Grant View Access to

Select who can view Feedback given to you.

- Everyone—All users, including users who are not logged in, can view the Feedback you have given.

- Authenticated Users—Only users who are logged in can view the Feedback you have given.

- User's Connections—Only you and your Connections can view the Feedback you have given.

- User Only—Only you and the user for whom you have provided Feedback can view the Feedback you have given.

Grant Post Access to

Select who can provide Feedback to you.

- Everyone—All users, including users who are not logged in, can post Feedback messages to you.

- Authenticated Users—Only users who are logged in can post Feedback messages to you.

- User's Connections—Only you and your Connections can post Feedback messages to you.

- User Only—No one can post Feedback messages to you.

Grant View Feedback Given Access to

Select who can view Feedback you have received.

- Everyone—All users, including users who are not logged in, can view Feedback you have received.

- Authenticated Users—Only users who are logged in can view Feedback you have received.

- User's Connections—Only you and your Connections can view Feedback you have received.

- User Only—No one can view Feedback you have received.

5. Click OK.

33.3 Enabling Other Users to Post Messages and Feedback for You

To set up your Message Board and Feedback task flows so that users can post messages and Feedback specifically for you, you must add a Message Board or Feedback task flow to a page in your view of the Home Space, and share that page with your connections. Additionally, you must set a parameter on the task flow to identify yourself as the task flow owner. Once this is set up, your connections can access this page and post messages and Feedback for you. This section steps you through this process.

To enable other users to post messages and Feedback for you:

1. Go to the page in the Home Space to which to grant access to your connections, or create such a page.

See Also:

For more information, see Chapter 38, "Creating and Managing Personal Pages."

2. Set page access to enable your connections to view and personalize the page.

See Also:

For more information, see Section 38.2, "Controlling User Access to Your Personal Pages."

Tip:

When you share one of your personal pages in the Home Space with other users, the shared page appears in their Personalize Pages page. Such users can use controls on the Personalize Pages page to show the page in their own views of the Home Spaces.

3. Enter page edit mode and add a Message Board or Feedback task flow to the page.

See Also:

For information about editing a page and adding content, see Section 17.5, "Adding Resource Catalog Components to Pages."

4. Edit the task flow instance.

See Also:

For information about editing a task flow instance, see Section 17.5.2, "Setting Properties on Page Components."

5. In the Component Properties dialog, bring the Parameters tab forward and enter your user name in the required field:

- For Message Board and Message Board - Quick View task flows, enter your user name in the User Name field.

- For the Feedback task flow, enter your user name in the Resource Id field.

- For the Feedback - Quick View task flow, enter your user name in the User Id field.

6. Save your changes and exit page edit mode.

If you care to, you can send a link to this page to your connections, inviting them to leave you messages or Feedback whenever they are moved to do so. For more information, see Section 29.7, "Sending a Link to a Page."

All users who have access to the page see the Message Board or Feedback task flows that you place there. But only the users to whom you have granted access, through Preferences, see any content in the task flows.

See Also:

For information about setting Message Board and Feedback Preferences, see Section 33.2, "Setting Message Board and Feedback Preferences."

33.4 Working with Message Board and Feedback Task Flows

This section steps you through using the features provided with Message Board and Feedback task flows. It includes the following subsections:

- Section 33.4.1, "Working with Message Board Task Flows"

- Section 33.4.2, "Working with Feedback Task Flows"

See Also:

The properties available on a given task flow instance provide additional opportunities to affect the appearance and behavior of the task flow. For more information, see Section 33.5, "Setting Message Board and Feedback Task Flow Properties."

33.4.1 Working with Message Board Task Flows

Message Board task flows provide a means of viewing and posting messages to your connections and attaching files and URLs to your posts. This section discusses how to post messages and attachments and how to edit, hide, show, sort, filter, and delete messages. It includes the following subsections:

- Section 33.4.1.1, "Viewing Messages"

- Section 33.4.1.2, "Posting Messages"

- Section 33.4.1.3, "Editing Message Board Messages"

- Section 33.4.1.4, "Sorting and Filtering Message Board Messages"

- Section 33.4.1.5, "Hiding Messages in Your View of Message Board"

- Section 33.4.1.6, "Showing Hidden Messages"

- Section 33.4.1.7, "Deleting Message Board Messages"

33.4.1.1 Viewing Messages

Once you and your connections have set up your own Message Boards, you can see your own and, potentially, each other's messages. This section provides information about how to view each other's messages post-set-up. It includes the following subsections:

- Section 33.4.1.1.1, "Viewing Messages Others Have Left for You"

- Section 33.4.1.1.2, "Viewing Messages Others Have Received"

- Section 33.4.1.1.3, "Viewing Messages Sent to a Selected Space"

Tip:

For information about setting up your view of Message Board, see Section 33.3, "Enabling Other Users to Post Messages and Feedback for You."

33.4.1.1.1 Viewing Messages Others Have Left for You

To view Message Board messages other users have left for you, go to the personal page in the Home Space that you have set up to receive Message Board messages (Figure 33-7).

Figure 33-7 Message Board Task Flow

33.4.1.1.2 Viewing Messages Others Have Received

To view Message Board messages other users have received (including those you have left for them), go to the page the user has made available to you in your view of the Home Space. You can access this page through the Home Space Personalize Pages page. For more information, see Section 29.3.2, "Opening Pages."

33.4.1.1.3 Viewing Messages Sent to a Selected Space

Message Boards placed in a Space provide a means of viewing and posting messages within the Space context. All default Message Board task flow instances within a given Space display the same content: messages left by authorized users who are members of the Space. All users with access to the Space can see the posted messages.

33.4.1.2 Posting Messages

This section describes the various ways you can post messages and attachments. It includes the following subsections:

- Section 33.4.1.2.1, "Posting a Message to all of Your Connections"

- Section 33.4.1.2.2, "Posting a Message Scoped to a Selected Space"

- Section 33.4.1.2.3, "Posting a Private Message"

- Section 33.4.1.2.4, "Sharing a Private Message"

- Section 33.4.1.2.5, "Attaching a File or URL to a Message Board Message"

33.4.1.2.1 Posting a Message to all of Your Connections

Using the Share menu on the Message Board - Quick View task flow, you can select whether to post a message to all of your connections or to all of your connections who belong to a selected Space.

This section describes how to share a message with all of your connections. For information about sharing a message with all of your connections in a Space, see Section 33.4.1.2.2, "Posting a Message Scoped to a Selected Space."

See Also:

For information about Connections, see Chapter 31, "Creating Your Social Network."

To post a Message Board message to a selected audience:

1. Go to your view of the Message Board - Quick View task flow.

2. From the Share something with menu, select Everyone (Figure 33-8).

Figure 33-8 Share Option on Message Board - Quick View Task Flow

3. Enter a message in the field provided, and click Publish (Figure 33-9).

Figure 33-9 Publish Button on a Message Board - Quick View Task Flow

The message appears in all of your connections' views of Message Board and Activity Stream.

33.4.1.2.2 Posting a Message Scoped to a Selected Space

The Message Board - Quick View task flow provides a means of posting a message that is pushed to the Message Boards and Activity Streams of a selected Space.

To post a message scoped to a selected Space:

1. Go to your view of the Message Board - Quick View task flow.

2. From the Share Something With menu, select the Space and go to step 5; or, if the Space is not listed, select More Spaces, and go to step 3.

3. In the resulting Select a Space dialog, open the Show Spaces menu and select to show:

- All—all Spaces that are available to you

- Joined—The Spaces you have joined

- Public—The Spaces that do not require a user to be logged in

- Moderated—The Spaces that you moderate

If you prefer, search for the Space name using the provided field.

4. Select a Space from the resulting list, and click OK.

5. Enter your message.

6. Optionally, attach a file or URL.

See Also:

For more information, see Section 33.4.1.2.5, "Attaching a File or URL to a Message Board Message."

7. Click Share to post your message.

The message is posted to Message Boards and Activity Streams in the selected Space.

33.4.1.2.3 Posting a Private Message

Provided you are authorized to do so, you can post a private message to any of your connections. When you mark a message as private, only you and the recipient can see the message in your views of Message Board; however, all of your connections and all of the recipient's connections can see private messages in Activity Stream, unless the application is configured to omit Message Board activity from the Activity Stream or you have configured your Activity Stream preferences to do so.

See Also:

For more information, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences."

To post a private message:

1. Go to your My Profile page and click Connections to bring it forward.

Tip:

If necessary, set the Show menu to All Connections.

2. Click the name of the user for whom to leave a message to open the Profile popup, and click Add Message (Figure 33-10).

Figure 33-10 Add Message Link in Profile Popup

3. Enter your message in the Add Message dialog (Figure 33-11).

Figure 33-11 Add Message Dialog

4. Select the Private checkbox to allow only the recipient to see the message.

5. Click Save and Close when you have finished.

The message appears in the recipient's views of Message Board and Activity Stream.

33.4.1.2.4 Sharing a Private Message

When you receive a private message, you can opt to share that message with all users who have access to your Message Board by marking it as shared. When someone sends you a message marked private, only you and the sender can see it in the Message Board (though all of your connections and the sender's connections can see the message in their Activity Streams, unless the Activity Stream in configured to omit Message Board activity).

See Also:

For information about omitting services from Activity Stream at the application and personal levels, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences."

When you mark a private message as shared, you open it up to those permitted to see your view of the Message Board.

To mark a message as shared:

1. Go to the message you want to mark as shared in your view of the Message Board task flow.

2. Click the Share link next to the relevant message (Figure 33-12).

Figure 33-12 Share Link on a Private Message

The message can be viewed by everyone who can access your Message Board.

33.4.1.2.5 Attaching a File or URL to a Message Board Message

Provided the task flow is configured to allow it, you can attach files and URLs to the messages you post to a Message Board - Quick View task flow in a Home Space.

Note:

Message Boards in Spaces, other than the Home Space, cannot be posted to any Space other than the current Space.

To attach a file or URL to a message:

1. Go to the Home Space, and enter a message in a Message Board - Quick View task flow.

2. Next to Attach, click the File or Link icon (Figure 33-13).

Figure 33-13 Attach Options on a Message Board - Quick View Task Flow

3. For File, click Browse to locate and select the file to share (Figure 33-14)

Figure 33-14 Attach File Feature

For Link, enter the target URL, and click Attach (Figure 33-15).

Figure 33-15 Attach Link Feature

4. Click Share.

33.4.1.3 Editing Message Board Messages

Your application administrator can configure the Message Board feature to enable users to revise the messages they leave. Provided this permission is in place, you can edit any message you post.

See Also:

For information about configuring application-level Message Board settings, see Section 6.4.3.5, "Configuring Message Board."

To edit a Message Board message:

1. Go to the message you want to edit.

2. Click the Edit link associated with the message (Figure 33-16).

Figure 33-16 Edit Link on a Message

The Edit Message dialog opens with a Rich Text Editor prepopulated with your message text (Figure 33-17).

Figure 33-17 Edit Message Dialog

3. Revise your message, and click Save.

33.4.1.4 Sorting and Filtering Message Board Messages

Your full view of the Message Board task flow includes sorting and filtering features for managing your view of your messages. Use the sorting feature to sort your messages by date or by the person who left the message. Use the filtering feature to show messages posted on a particular date or within a given date range.

To sort and filter your Message Board messages:

1. Go to the Message Board task flow.

2. From the Sort By menu, select a sorting option (Figure 33-18):

Figure 33-18 Options on Sort By Menu

- Date—Sort your messages by the date they were posted, from most recent to oldest.

- Person Name—Sort your messages by the user name of the person who posted them, from A to Z.

3. To show messages between a particular range of dates, enter the beginning and end of the range respectively in the fields after From and To (Figure 33-19).

Figure 33-19 Sort By Date Range Options

Tip:

Instead of entering dates, you can click the Select Date icon next to a field to select a date from a calendar.

Accessibility Note:

In WebCenter Spaces, you cannot use the keyboard to select a date from the calendar that pops up when you click the Select Date icon. Instead, manually enter the date into the field.

4. Click the button to the right of the fields to apply the filter.

The Message Board refreshes, showing only those messages that fit your sorting and filtering criteria.

Tip:

To remove the date filtering criteria from your Message Board view, click the Clear Date icon to the right of the date range fields.

33.4.1.5 Hiding Messages in Your View of Message Board

You can hide any message you have received on your Message Board. Hiding provides a means of removing messages from your own view without actually deleting them. It is a non-permanent way to reduce the visual clutter of your Message Board view.

Users to whom you have given access to your messages can still see the messages that you have hidden.

To hide Message Board messages:

1. Go to the message you want to hide in your view of the Message Board task flow.

2. Click the Hide link next to the message you want to hide (Figure 33-20).

Figure 33-20 Hide Link on a Message

The message is hidden in your view of the Message Board. Other users you have permitted to view your Message Board can see this message when they visit your view.

33.4.1.6 Showing Hidden Messages

Use the Hidden checkbox on the Message Board task flow to show all of the messages you have hidden. The Hidden checkbox provides a means of showing all hidden messages in one operation, making it available to be unhidden or deleted.

To show hidden Message Board messages:

1. In your view of the Message Board task flow, select the Hidden checkbox to show the messages you have hidden (Figure 33-21).

Figure 33-21 Hidden Checkbox on a Message Board Task Flow

2. Click the Unhide link next to the message you want to show (Figure 33-22).

Figure 33-22 Unhide Link on a Message Board Task Flow

3. Optionally, clear the Hidden checkbox to hide the messages that are still marked as hidden.

33.4.1.7 Deleting Message Board Messages

Your application administrator can configure the Message Board to allow users to delete the messages they send. Provided this permission is in place, you can delete any message you send.

See Also:

For information about configuring application-level Message Board settings, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces.".

To delete a message you sent:

1. Go to your view of the Message Board, and click the Delete icon next to the message you want to delete (Figure 33-23).

Figure 33-23 Delete Icon on a Message

2. In the resulting confirmation dialog, click the Delete button.

33.4.2 Working with Feedback Task Flows

Feedback provides a means of viewing and posting remarks on the job performance of your connections. In your own view of the Feedback task flow, you can view the Feedback you have posted and that was posted for you. In a connection's view of the Feedback task flow, you can post Feedback for that connection and view all of the Feedback left for that connection, provided he has granted you view and post access.

See Also:

Feedback is also posted to the Activity Stream, unless Activity Stream is configured not to show Feedback activity. For more information, see Section 33.1.2, "What You Should Know About Feedback."

When you view another user's Feedback, you can view only the Feedback they have received. To view the Feedback they have sent, you must go to the recipients' views of the Feedback task flow.

See Also:

Use Preferences settings to configure user access to your Feedback. For more information, see Section 33.2.2, "Setting Feedback Preferences."

This section discusses how to view, hide, show, sort, filter, post, and delete Feedback messages. It includes the following subsections:

- Section 33.4.2.1, "Viewing Feedback"

- Section 33.4.2.2, "Posting Feedback"

- Section 33.4.2.3, "Deleting Feedback"

33.4.2.1 Viewing Feedback

This section provides information about accessing the Feedback you have posted or received and hiding and unhiding posted Feedback. It includes the following sections:

- Section 33.4.2.1.1, "Viewing Feedback You Have Posted or Received"

- Section 33.4.2.1.2, "Sorting and Filtering Feedback Posts"

- Section 33.4.2.1.3, "Hiding Feedback in Your Own View"

- Section 33.4.2.1.4, "Showing Hidden Feedback"

- Section 33.4.2.1.5, "Marking Feedback Received as Private"

33.4.2.1.1 Viewing Feedback You Have Posted or Received

A View menu on Feedback task flows provides a means of viewing the Feedback you have posted for others and the Feedback you have received from others.

To view Feedback you have posted or received:

1. Go to your view of a Feedback task flow in the Home Space.

2. Select an option from the View menu (Figure 33-24):

- Given—To view the Feedback you have posted for others

- Received—To view the Feedback others have left for you

Figure 33-24 Feedback Task Flow View Menu

33.4.2.1.2 Sorting and Filtering Feedback Posts

The main Feedback task flow includes sorting and filtering features for controlling what is shown in your view. Use the sorting feature to sort your Feedback by date or by person—that is, the user name of the person who left the Feedback. Use the filtering feature to display Feedback posted on a particular date or within a given date range.

To sort and filter your Feedback:

1. Go to your view of the main Feedback task flow.

2. Select an option from the Sort By menu (Figure 33-25):

Figure 33-25 Sort By Menu on Feedback Task Flow

- Date—To sort Feedback posts from the most recent to the oldest.

- Person Name—To sort Feedback posts by the name of the user who left it for you (View is set to Received) or by the name of the user you left it for (View is set to Given).

3. To specify a date range, enter a start date in the field that follows From and enter an end date in the field that follows To (Figure 33-26).

Figure 33-26 Sort By Date Range Fields on Feedback Task Flow

Tip:

You must enter both a start and end date, even when you want to view Feedback posts from a given day. In such a case, enter the same date in both fields.

Instead of entering dates, you can click the Select Date icon next to a field to select a date from a calendar.

Accessibility Note:

In WebCenter Spaces, you cannot use the keyboard to select a date from the calendar that pops up when you click the Select Date icon. Instead, manually enter the date into the field.

4. Click the Search Feedback icon.

All of the Feedback posts (either received or given) that fall within the specified date range appear in the Feedback task flow.

Tip:

To remove the date filtering criteria from your Feedback view, click the Clear Date icon.

33.4.2.1.3 Hiding Feedback in Your Own View

You can hide any Feedback in your own view of the Feedback task flow. Hiding provides a means of removing Feedback posts from your own view without actually deleting them. Users to whom you have given access to your Feedback can still see the posts you have hidden.

See Also:

For information about undoing this action, see Section 33.4.2.1.4, "Showing Hidden Feedback").

To hide Feedback in your own view:

1. Go to your view of the main Feedback task flow.

2. Click the Hide link next to the Feedback message you want to hide (Figure 33-27).

Figure 33-27 Hide Link on a Feedback Message

33.4.2.1.4 Showing Hidden Feedback

Use the Hidden checkbox on the Feedback task flow to show all the Feedback you have hidden. The Hidden checkbox provides a means of showing all hidden Feedback in one operation, making it available to be unhidden or deleted.

To show hidden Feedback posts:

1. Go to your view of the Feedback task flow.

2. Select the Hidden checkbox (Figure 33-28).

Figure 33-28 Hidden Checkbox on a Feedback Task Flow

3. All the Feedback posts you have hidden are shown.

4. Click the Unhide link to the right of the Feedback you want to show (Figure 33-29).

Figure 33-29 Unhide Link on a Feedback Task Flow

5. To remove hidden Feedback posts from your view, clear the Hidden checkbox.

33.4.2.1.5 Marking Feedback Received as Private

When you view Feedback you have received, you typically have the option of clicking a Private link to shield the Feedback from other viewers (Figure 33-30).

Figure 33-30 Private Link on a Feedback Message

It is possible to set a property on the task flow that suppresses the Private link (for more information, see Section 33.5, "Setting Message Board and Feedback Task Flow Properties"). Also, unless Activity Stream is configured at the application level or the personal level (through Preferences) to omit Feedback activity, your connections and the poster's connections can see even private Feedback in their Activity Streams.

See Also:

For more information, see Section 6.4.3.2, "Configuring Activity Stream," and Section 32.2, "Setting Activity Stream Preferences."

33.4.2.2 Posting Feedback

Use Feedback to pass along remarks to your connections about their efforts and results. Keep in mind that a wider audience than just your connections may see your Feedback message.

To post a Feedback message:

1. Go to the page the user has set up to receive Feedback.

See Also:

For more information, see Section 33.3, "Enabling Other Users to Post Messages and Feedback for You."

2. Click Add Feedback (Figure 33-31).

Figure 33-31 Add Feedback Button on a Feedback Task Flow

3. In the resulting Add Feedback dialog, enter your Feedback in the text area (Figure 33-32).

Tip:

The Add Feedback dialog provides an integrated Rich Text Editor that enables you to add styles, links, and other HTML encoding to your Feedback.

Figure 33-32 Add Feedback Dialog with Rich Text Editor

4. When you finish entering text, click Add.

Once you click Add, your Feedback appears in the selected user's view of the Feedback task flow.

33.4.2.3 Deleting Feedback

You can delete Feedback you have posted to other users, provided your WebCenter Spaces administrator has enabled you to do so.

If Activity Stream is configured to show Feedback activity, deleted Feedback posts nonetheless continue to show in the Activity Stream of the recipient and all of your connections.

See Also:

for information about administrator-level Feedback settings, see Section 6.4, "Configuring People Connections Defaults for WebCenter Spaces." For information about configuring your personal Activity Stream Preferences, see Section 32.2, "Setting Activity Stream Preferences."

To delete Feedback you have posted:

1. Go to your view of the Feedback task flow.

2. From the View menu, select Given.

3. Click the Delete icon next to the post you want to delete (Figure 33-33).

Figure 33-33 Delete Icon on a Feedback Message

4. Click Delete in the resulting confirmation dialog.

The Feedback is deleted from your view and from the view of the user for whom you left it.

33.5 Setting Message Board and Feedback Task Flow Properties

Both Message Board and Feedback task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 33-34).

Figure 33-34 Component Properties Dialog for a Feedback Task Flow

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of Message Board and Feedback task flows and describe the properties on the Parameters tab:

- Section 33.5.1, "What You Should Know About Message Board and Feedback Task Flow Properties"

- Section 33.5.2, "Message Board and Feedback Task Flow Parameters"

- Section 33.5.3, "Using Parameters to Configure Message Board and Feedback Task Flow Instances"

33.5.1 What You Should Know About Message Board and Feedback Task Flow Properties

When you set property values on a Message Board or Feedback task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog can affect the default task flow content. For descriptions of the parameters on this tab, see Section 30.6.2, "Profile Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

33.5.2 Message Board and Feedback Task Flow Parameters

Table 33-4 describes the parameters that are unique to Message Board and Feedback task flows.

Table 33-4 Message Board and Feedback Task Flow Parameters

Parameter

Description

Display Message Size

The number of characters to show for each Feedback message

Messages exceeding the specified value are truncated.

This parameter is associated with the Feedback – Quick View task flow.

End Date

The ending date for a date range within which to show messages and posts

Use the format YYYY/MM/DD. Use this parameter with Start Date.

This parameter is associated with the following task flows:

- Feedback

- Feedback - Quick View

- Message Board

Group Space

Specifies the Space for which to show messages

Enter the Space internal name. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the banner at the top of a Space.

This parameter is associated with the following task flows:

- Message Board

- Message Board - Quick View

Hide Actions

Specifies whether to show or hide the actions normally associated with a Feedback or Message Board entry, such as Private, Edit, Hide, and Delete

- Select the checkbox to hide actions associated with a Feedback or Message Board entry (#{true}).

- Clear the checkbox to show such actions (#{false}). When no value is entered, this is the default.

This parameter is associated with the following task flows:

- Feedback – Quick View

- Message Board – Quick View

Hide Footer

Specifies whether to hide the task flow footer

- Select the checkbox to hide the task flow footer (#{true}).

- Clear the checkbox to show the task flow footer (#{false}).

This parameter turns the More link on (#{false}) or off (#{true}). Note that it does not affect the Previous and Next links that may also display toward the bottom of the task flow.

This parameter is associated with the following task flows:

- Feedback - Quick View

- Message Board - Quick View

Hide Given

Specifies whether to enable or disable the display of Feedback left for others

- Select the checkbox to disable the display of Feedback left for others in a given task flow instance (#{true}).

- Clear the checkbox to allow the display of Feedback left for others in a given task flow instance (#{false}).

Selecting Hide Given hides the View menu so that only Feedback received is shown.

This parameter is associated with the following task flows:

- Feedback

- Feedback - Quick View

Hide Header

Specifies whether to show or hide the task flow header

- Select the checkbox to hide the task flow header (#{true}).

- Clear the checkbox to show the task flow header (#{false}).

This parameter is associated with the following task flows:

- Feedback

- Feedback - Quick View

- Message Board

- Message Board - Quick View

Hide Publisher

Specifies whether to show or hide the message entry field and the upload file and URL controls (the Publisher)

- Select the checkbox to disable the display of the message entry field in a given task flow instance (#{true}).

- Clear the checkbox to allow the display of the message entry field in a given task flow instance (#{false}).

This parameter is associated with the following task flows:

- Message Board

- Message Board - Quick View

No of Feedback items

The number of Feedback items to show in the task flow

For example, enter 5 to specify that a maximum of five items can appear in the task flow. In quick view, a More link appears at the bottom of the task flow when there are more items than the specified number of items. Users click More to open the main view of the task flow where all items are accessible. In main view, Previous and Next links are shown. Users click these to page through entries.

This parameter is associated with the following task flows:

- Feedback

- Feedback - Quick View

No of Messages

The number of messages to show in the task flow

For example, enter 5 to specify that a maximum of five items can appear in the task flow. In quick view, a More link appears at the bottom of the task flow when there are more items than the specified number of items. Users click More to open the main view of the task flow where all items are accessible. In main view, Previous and Next links are shown. Users click these to page through entries.

This parameter is associated with the following task flows:

- Message Board

- Message Board - Quick View

Resource Id

The ID of the user to show in the task flow

This value is set automatically, #{securityContext.userName}, which returns the name of the current user.

Note: For information about this and other EL expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the Feedback task flow.

Start Date

The starting date for a date range within which to show messages and posts

Use the format YYYY/MM/DD. Use this parameter with End Date.

This parameter is associated with the following task flows:

- Feedback

- Feedback - Quick View

- Message Board

User Id

The ID of the user to show in the task flow

This value is set automatically, #{securityContext.userName}, which returns the name of the current user.

Note: For information about this and other EL expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the Feedback - Quick View task flow.

User Name

The ID of the user to show in the task flow

This value is set automatically, #{securityContext.userName}, which returns the name of the current user.

Note: For information about this and other EL expressions, see Appendix B, "Expression Language Expressions."

This parameter is associated with the following task flows:

- Message Board

- Message Board - Quick View

33.5.3 Using Parameters to Configure Message Board and Feedback Task Flow Instances

The properties associated with Message Board and Feedback task flows make it possible to control such things as the number of messages to show, the maximum length of Feedback posts, the presence or absence of a message input field, and so on.

Setting task flow properties affects every users' view of the task flow instance.

This section provides examples of how to use task flow parameters to achieve these results. It includes the following subsections:

- Section 33.5.3.1, "Hiding Action Links and Icons on a Task Flow Instance"

- Section 33.5.3.2, "Limiting the Number of Messages and Feedback Posts Shown"

- Section 33.5.3.3, "Limiting the Length of Posts in a Feedback - Quick View Task Flow"

- Section 33.5.3.4, "Preventing Users from Adding Messages to a Message Board"

- Section 33.5.3.5, "Hiding the Feedback You Have Left for Others"

- Section 33.5.3.6, "Scoping the Display of Messages to a Named Space"

- Section 33.5.3.7, "Specifying the Date Range of Shown Messages and Feedback"

33.5.3.1 Hiding Action Links and Icons on a Task Flow Instance

Users with page edit privileges can set the Hide Actions parameter on a Message Board - Quick View or Feedback - Quick View task flow to hide the actions normally associated with each posted message. Such actions include the Edit, Hide, and Private links and the Delete icon (Figure 33-35).

Figure 33-35 Actions on a Feedback Message

To hide actions on a Message Board - Quick View or Feedback - Quick View task flow instance:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. Select the Hide Actions checkbox.

Note:

To show hidden actions, clear this checkbox.

4. When you finish revising component properties, click OK.

5. Save your changes, and exit page edit mode.

33.5.3.2 Limiting the Number of Messages and Feedback Posts Shown

Parameters on all Message Board and Feedback task flow types enable you to specify how many messages or Feedback posts to show in a given task flow instance. When the number of messages or posts exceeds the value that you provide:

- Previous and Next icons appear on the full task flow views, enabling users to page through all messages and posts.

- A More link appears on task flow quick views. Users click this to launch a dynamically-generated page that shows all messages or posts.

For Message Board and Message Board - Quick View task flows, use the No of Messages parameter. For Feedback and Feedback - Quick View task flows, use the No of Feedback Items parameter.

To limit the number of messages and Feedback posts shown in a given task flow instance:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. Enter the number of messages or Feedback posts you want to allow in the task flow instance:

- For Message Board and Message Board - Quick View task flows, enter a number for the parameter No of Messages.

- For Feedback and Feedback - Quick View task flows, enter a number for the parameter No of Feedback Items.

4. When you finish revising component properties, click OK.

5. Save your changes, and exit page edit mode.

33.5.3.3 Limiting the Length of Posts in a Feedback - Quick View Task Flow

Use the Display Message Size parameter on a Feedback - Quick View task flow instance to limit the number of characters that can be entered for a given post. Posts that exceed the limit are truncated.

To limit the number of characters allowed for a post to a Feedback - Quick View task flow:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. For the Display Message Size parameter, enter the number of characters to allow for a given post.

4. When you finish revising component properties, click OK.

5. Save your changes, and exit page edit mode.

33.5.3.4 Preventing Users from Adding Messages to a Message Board

You can use the Hide Publisher parameter to hide the message input field and its associated icons in a Message Board or Message Board - Quick View task flow instance. This is useful when you want a Message Board to be a window onto current messages without also being a point of input.

To prevent users from adding messages to a Message Board task flow instance:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. Select the Hide Publisher checkbox to hide the message input field and its associated Share document and Share link icons.

4. When you finish revising component properties, click OK.

5. Save your changes, and exit page edit mode.

33.5.3.5 Hiding the Feedback You Have Left for Others

You can use the Hide Given parameter to prevent the display of the Feedback you have left for others in both types of Feedback task flows. Selecting Hide Given hides the View menu, so that only Feedback received is shown.

To hide the Feedback you have left for others:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. Select the Hide Given checkbox to hide the Feedback you have left for others by hiding the View menu.

4. When you finish revising component properties, click OK.

5. Save your changes, and exit page edit mode.

33.5.3.6 Scoping the Display of Messages to a Named Space

Both types of Message Board task flows provide the Group Space parameter for specifying the Space for which to display messages. For example, imagine that, from the Home Space, you want to see the messages people are entering in the Standards Space. You can place either type of Message Board task flow on a page in the Home Space, and configure it to show the messages entered in the Standards Space.

To scope the display of messages to a named Space:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. In the Group Space field, enter the internal name of the Space of interest.

Tip:

The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the banner at the top of a Space.

4. When you finish revising component properties, click OK.

5. Save your changes, and exit page edit mode.

33.5.3.7 Specifying the Date Range of Shown Messages and Feedback

You can use the Start Date and End Date parameters on the Message Board, Feedback, and Feedback - Quick View task flows to limit the display of messages and Feedback posts to those entered between the two specified dates.

For both parameters, use the date format YYYY-MM-DD, for example 2010-01-02.

To limit the display of messages and Feedback posts to those entered within a specified date range:

1. Edit the task flow instance's properties as described in Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, click the Parameters tab to bring it forward.

3. In the Start Date field, enter the date after which to show messages and posts.

4. In the End Date field, enter the date before which to show messages and posts.

5. When you finish revising component properties, click OK.

6. Save your changes, and exit page edit mode.

34 Liking, Commenting On, and Sharing Objects

Opportunities are available throughout your portal to express a favorable judgment on an application object, through liking, and associate a comment with an application object, through commenting. Opportunities to share application objects, files, and URLs are also readily available.

This chapter provides information about liking, commenting, and sharing in WebCenter Spaces. It includes the following sections:

- Section 34.1, "Liking and Unliking Application Objects"

- Section 34.2, "Commenting on Application Objects"

- Section 34.3, "Sharing Files, URLs, and Streamed Items with Other Users"

Audience

This chapter is intended for users assigned an application role that includes, minimally, the permission People Connections: Update People Connections Data. Users who plan to edit task flow properties must be assigned a role that also includes the permission Edit Pages. In a Space (other than the Home Space), users must be assigned a role that includes the permission Edit Page Access and Structure.

34.1 Liking and Unliking Application Objects

Liking is an accumulative rating system that enables you to see at a glance which objects are viewed most favorably by you and other users. A counter keeps track of the number of users who like the object. In a group of objects, you can determine the most favored by its number of likes (Figure 34-1).

Figure 34-1 Like Link on a Streamed Item

You can like streamed items that include objects. For example, you can like "Jack has updated doc.xml," but you cannot like "Jack and Jill are now connected."

You can express liking for the following types of application objects:

- Message Board messages (for more information, see Section 33.1.1, "What You Should Know About Message Board")

- Activity Stream items (for more information, see Section 32.1, "What You Should Know About Activity Stream")

Tip:

Whether you or any user can like an Activity Stream or Message Board object depends on whether the administrator has enabled liking for these features. For more information, see Section 6.4.3, "Configuring the People Connections Service for WebCenter Spaces."

- Documents (for more information, see Section 41.27, "Liking and Unliking a File")

To like something, click the Like link or icon (a star) (Figure 34-2).

Figure 34-2 Like Icon on a Document

To remove your favorable rating (that is, unlike the object), click Unlike or click the Like icon again (Figure 34-3).

Figure 34-3 Unlike Link on a Streamed Item

34.2 Commenting on Application Objects

Commenting provides a means of adding your thoughts, opinions, and questions directly to a given application object.

You can comment on the following types of application objects:

- Message Board messages (for more information, see Section 33.1.1, "What You Should Know About Message Board")

- Activity Stream items (for more information, see Section 32.1, "What You Should Know About Activity Stream")

Tip:

You can comment on streamed items that include objects. For example, you can comment on "Jack has updated doc.xml," but you cannot comment on "Jack and Jill are now connected."

- Documents and other types of files (for more information, see Section 41.5.2, "Menus and Actions in the Document Viewer Preview Pane or Window")

Tip:

When you comment on a file through the Activity Stream, the comment appears with the file in the Document Library as well as in the Activity Stream.

Note:

Public users viewing a public document cannot comment on the document.

- Wikis (for more information, see Chapter 47, "Working with Wiki Documents")

- Blogs (for more information, see Chapter 48, "Working with Blogs")

To comment on an object:

1. Click an object's associated Comment link (Figure 34-4).

Figure 34-4 Comment Link on a Streamed Item

2. Fill in the resulting field (Figure 34-5)

Figure 34-5 Write a Comment Text Field

3. Click the Comment button to save the comment.

To delete the comment, click its associated Delete icon (Figure 34-6).

Figure 34-6 Delete Icon on a Comment

34.3 Sharing Files, URLs, and Streamed Items with Other Users

This section provides an overview of the different types of sharing that are available through WebCenter Spaces, and steps you through each type. It includes the following subsections:

- Section 34.3.1, "What You Should Know About Sharing"

- Section 34.3.2, "Sharing Streamed Items with a Wider Audience"

- Section 34.3.3, "Sharing Items, Files, and URLs Through the Publisher Task Flow"

34.3.1 What You Should Know About Sharing

Sharing provides a means of on-the-spot distribution of items, files, and URLs of particular interest to a selected audience. Sharing is available in a few different forms:

- Share an item you receive in your Activity Stream by posting it to your connections' Activity Streams (for more information, see Section 34.3.2.1, "Reposting Streamed Items").

- Share an item you receive in your Activity Stream through email (for more information, see Section 34.3.2.2, "Emailing Streamed Items").

- Share an item, file, or URL through the Publisher task flow (for more information, see Section 34.3.3, "Sharing Items, Files, and URLs Through the Publisher Task Flow").

To share an item directly from your Activity Stream, the item must contain an object. For example, you can share "Jack has updated doc.xml," but you cannot share "Jack and Jill are now connected." Less obvious, you can share anything you post through the Publisher task flow because the post itself is an object.

34.3.2 Sharing Streamed Items with a Wider Audience

You can share items that appear in your view of the Activity Stream with a wider audience. For example, when your view of the Activity Stream reports that one of your connections updated a document of great interest to all of your connections, you can share that streamed item with all of your connections.

You can do so by posting the streamed item to all of your connections' Activity Streams or to the Activity Streams of connections who belong to a named Space. You can also share streamed items through email, enabling you to share it with users to whom you are not connected or to make use of mail distribution lists.

Note:

To share an item directly from your Activity Stream, the item must contain an object. For more information, see Section 34.3.1, "What You Should Know About Sharing."

This section includes the following subsections:

- Section 34.3.2.1, "Reposting Streamed Items"

- Section 34.3.2.2, "Emailing Streamed Items"

34.3.2.1 Reposting Streamed Items

Use the Share menu's This activity option to share a streamed item with your connections through their view of the Activity Stream.

To repost a streamed item to your connections' Activity Streams:

1. Go to the item you want to share, and from the Share menu select This activity (Figure 34-7)

Figure 34-7 This Activity Option on the Share Menu

2. In the resulting Share dialog:

- Select Everyone to share the item with all of your connections (Figure 34-8).

Figure 34-8 Everyone Option on Share Something With Menu

- Select a Space, or select More Spaces to share the item with those of your connections who have access to the selected Space.

Selecting More Spaces opens the Select a Space dialog, from which you can choose a Space (Figure 34-9).

Figure 34-9 Select a Space Dialog

From the Show Spaces menu:

- Select All to show all of the Spaces to which you have access.

- Select Joined to show all of the Spaces you have explicitly joined.

- Select Moderated to show all of the Spaces for which you are a moderator.

- Select Public to show all public Spaces.

Alternatively, enter the name of a Space in the Search field and execute the search. Results appear in the dialog.

Highlight a Space, and click OK.

- Optionally, in the Share dialog, enter a message to accompany the link (Figure 34-10).

Figure 34-10 Adding a Message to a Shared Link

Note:

When you share a message, rather than a file or a link, you cannot enter another message to accompany it.

- Click OK.

The item is posted to the Activity Streams of the selected recipients.

34.3.2.2 Emailing Streamed Items

Use the Share menu's Send Mail option to share a streamed item through email. The Send Mail option is available on streamed items that include objects, such as a document. It is otherwise not available.

To share a streamed item through email:

1. Go to the item you want to share, and from the Share menu select Send Mail (Figure 34-11)

Figure 34-11 Send Mail Option on the Share Menu

A mail message opens, prepopulated with a link to the selected item.

2. Address, write, and send the message as you would any other email.

34.3.3 Sharing Items, Files, and URLs Through the Publisher Task Flow

The Publisher task flow provides a means of publishing messages, files, and URLs to the Activity Streams of all of your connections or to those connections who have access to a specified Space. Publisher also has an associated property, Is Update Status, that enables users to publish a message as their Profile status message.

This section steps you through Publisher features and provides information about its associated properties. It includes the following subsections:

- Section 34.3.3.1, "What You Should Know About the Publisher Task Flow"

- Section 34.3.3.2, "Selecting the Recipients of a Published Message"

- Section 34.3.3.3, "Sharing Files Through the Publisher Task Flow"

- Section 34.3.3.4, "Sharing Links Through the Publisher Task Flow"

- Section 34.3.3.5, "Setting Publisher Task Flow Properties"

See Also:

For information about Activity Stream, see Chapter 32, "Tracking Your Connections' Activities." For information about Profiles, see Chapter 30, "Managing Your Profile." For information about properties associated with the Publisher task flow, see Section 34.3.3.5, "Setting Publisher Task Flow Properties."

34.3.3.1 What You Should Know About the Publisher Task Flow

The Publisher task flow is very similar in operation to Message Board task flows (see Chapter 33, "Posting and Managing Messages and Feedback"). It differs in a few ways:

- You can use it to send out messages, but not to receive them. It provides no feature for viewing messages.

- It is specifically made to work in conjunction with Activity Stream, where the messages you enter are published.

- It has its own distinct set of properties (see Section 34.3.3.5, "Setting Publisher Task Flow Properties").

- It is not controlled by configuration settings at the application level nor through your own personal Preferences. You specify who sees your published messages through a control on the task flow itself. You can also exercise some control over the message destination through task flow properties. For example, the Publisher task flow has an associated property, Is Update Status, that enables users to publish a message as their Profile status message.

See Also:

For information about Profile, see Chapter 30, "Managing Your Profile."

There is one Publisher task flow (Figure 34-12).

Figure 34-12 Publisher Task Flow

In default WebCenter Spaces installations, the Publisher task flow is placed on the Activities business role page, which is provided in the Home Space for all authenticated users (that is, users who are logged in).

The default Activities business role page also contains an Activity Stream task flow where the messages you enter through the Publisher are published.

See Also:

For information about business role pages, see Section 7.1, "Working with Business Role Pages."

34.3.3.2 Selecting the Recipients of a Published Message

The Publisher task flow has a menu at the top where you can select who may see your message in their Activity Streams (Figure 34-13).

Figure 34-13 Share Something With Menu on Publisher Task Flow

To select the recipients of a published message:

1. Go to the Activities page in the Home Space.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through an Activities link.

2. In the Publisher task flow, select a value from the Share something with menu:

- Select Everyone to share the item with all of your connections.

- Select a Space, or select More Spaces to share the item with those of your connections who have access to the selected Space.

Selecting More Spaces opens the Select a Space dialog, from which you can choose a Space (Figure 34-14).

Figure 34-14 Select a Space Dialog

From the Show Spaces menu:

- Select All to show all of the Spaces to which you have access.

- Select Joined to show all of the Spaces you have explicitly joined.

- Select Moderated to show all of the Spaces for which you are a moderator.

- Select Public to show all public Spaces.

Alternatively, enter the name of a Space in the Search field and execute the search. Results appear in the dialog.

Highlight a Space, and click OK.

3. Click in the text area, and enter your message (Figure 34-15).

Figure 34-15 Adding a Message to a Shared Link

Note:

When you share a message, rather than a file or a link, you cannot enter another message to accompany it.

4. Click Share.

Your message appears in your view of the Activity Stream and in the Activity Streams of the selected recipients.

34.3.3.3 Sharing Files Through the Publisher Task Flow

In addition to sharing messages through the Publisher task flow, you can select to share files. When you share a file through the Publisher task flow, the uploaded file is also stored in the Public folder of your personal document library.

Tip:

If you prefer to have greater control over where a shared file is stored in your document library, you can upload it to the folder you prefer. Such uploads are also reported in your connection's activity streams, provided your activity stream is configured to show them. For more information, see Section 32.2, "Setting Activity Stream Preferences."

A Publisher task flow can be configured to hide the Attach: File link. If you do not see this link below the task flow, it could be because the instance is configure, through the Hide Document Uploader property, not to show it. For more information, see Section 34.3.3.5.3, "Prohibiting File Uploads Through a Publisher Task Flow Instance."

To share files through the Publisher task flow:

1. Go to an instance of the Publisher task flow, and select the recipients of your message.

See Also:

For more information, see Section 34.3.3.2, "Selecting the Recipients of a Published Message."

2. Optionally, click in the text area and enter the message you want to accompany the file.

3. Next to Attach, click the File link to open a file upload feature (Figure 34-16)

Figure 34-16 Attach File Field on Publisher Task Flow

4. Click Browse to navigate to and select the file you want to share.

5. Click Publish.

The file is streamed to your Activity Stream and to the Activity Streams of your selected recipients.

See Also:

Whether a file or a link to a file is shown depends on how the Activity Stream task flow instance is configured. For more information, see Section 32.5.4.2, "Hiding File Previews in Streamed Items."

34.3.3.4 Sharing Links Through the Publisher Task Flow

In addition to sharing messages through the Publisher task flow, you can select to share links.

To share links through the Publisher task flow:

1. Go to an instance of the Publisher task flow, and select the recipients of your message.

See Also:

For more information, see Section 34.3.3.2, "Selecting the Recipients of a Published Message."

2. Optionally, click in the text area and enter the message you want to accompany the link.

3. Next to Attach, click the Link link to open a field for entering a URL (Figure 34-17)

Figure 34-17 Attach Link Field on Publisher Task Flow

4. Enter the URL you want to share, and click Attach.

5. Click Publish.

The link is streamed to your Activity Stream and to the Activity Streams of your selected recipients.

34.3.3.5 Setting Publisher Task Flow Properties

The Publisher task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 34-18).

Figure 34-18 Publisher Parameters in the Component Properties Dialog

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties associated with the Publisher task flow and describe the properties available on the Parameters tab:

- Section 34.3.3.5.1, "What You Should Know About Publisher Task Flow Properties"

- Section 34.3.3.5.2, "Publisher Task Flow Parameters"

- Section 34.3.3.5.3, "Prohibiting File Uploads Through a Publisher Task Flow Instance"

- Section 34.3.3.5.4, "Limiting the Scope of Recipients"

- Section 34.3.3.5.5, "Using the Publisher as a Profile Status Updater"

- Section 34.3.3.5.6, "Using the Publisher as a File Uploader"

34.3.3.5.1 What You Should Know About Publisher Task Flow Properties

When you set property values on the Publisher task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog can affect the default task flow content. For descriptions of the parameters on this tab, see Section 34.3.3.5.2, "Publisher Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

34.3.3.5.2 Publisher Task Flow Parameters

Table 34-1 describes the parameters that are unique to the Publisher task flow.

Table 34-1 Publisher Task Flow Parameters

Parameter

Description

Hide Attach Links

Specifies whether the Attach: File|Link option is shown or hidden

- Check for #{true} to hide the Attach: File|Link option.

- Clear for #{false} to show the Attach: File|Link option.

Hide Document Uploader

Specifies whether the Share document icon is available on the task flow for uploading a document

- Check for #{true} to hide the Share document icon

- Clear for #{false} to show the Share document icon.

Hide Sharing Picker

Specifies whether the Share something with option is shown or hidden

- Check for #{true} to hide the Share something with option.

- Clear for #{false} to show the Share something with option.

Is Update Status

Indicates whether the message entered in the task flow instance should also be published as the user's Profile status message

- Check for #{true} to publish the message as the user's Profile status message and in the selected recipients' Activity Streams.

- Clear for #{false} to publish the message only in the selected recipients' Activity Streams.

If you attach a file or URL to a published message, then no matter what the state of Is Update Status, the message is not also used as a Profile status message.

For information about Profiles, see Chapter 30, "Managing Your Profile."

Keep open the Publisher after publish

Specifies whether the text box remains active after a user clicks the Publish button

- Check for #{true} to keep the text box open after a message is published.

- Clear for #{false} to close the text box after a message is published.

Message key of hints text

Specifies the resource bundle class and message key for hint text

Use the format key[,RBClass]. __EMPTY__ as the predefined key for no hint text. This is the default value.

Object Id

The ID of the object to be shared

This property value assists in generating a link for use in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. For information about EL expressions, see Appendix B, "Expression Language Expressions."

Object Type

The type of object to be shared

This property value assists in generating a link for use in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. For information about EL expressions, see Appendix B, "Expression Language Expressions."

Scope Id

The ID of the scope to which to publish

This property value assists in generating a link for use in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. For information about EL expressions, see Appendix B, "Expression Language Expressions."

Service Id

The service ID of the service to which the shared object belongs

This property value assists in generating a link for use in navigating to the published object. It is not necessary to provide a value, unless you plan to do so by entering a specific service ID or using an EL expression. For a list of valid service IDs, see Table B-19, "Service IDs". For information about EL expressions, see Appendix B, "Expression Language Expressions."

Space Name

The name of the Space in which to publish the messages entered in this task flow instance

Enter the Space internal name and not the Space display name. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the Space banner at the top of the Space.

Upload Document Only

Specifies that only the file upload feature is available in the task flow instance, hiding the text entry area and the Share link icon

- Check for #{true} to show only the file upload feature and hide the text entry area and the Share link icon.

- Clear for #{false} to show the text entry area and the Share link and Share document icons.

User Name

The name of the user who owns the current view

This value is supplied by default. We recommend that you do not change the default value, #{o_w_w_i_v_b_resourceViewerBean.username}.

Via User

The user name of the person who provided the object the current user is sharing

For example, John is sharing a document with everyone that Jane originally shared with him. In this case, Jane is the via user.

34.3.3.5.3 Prohibiting File Uploads Through a Publisher Task Flow Instance

You can use the Hide Document Uploader property to omit the display of the Share document icon on a Publisher task flow instance. Users will be able to share links but not files.

To prohibit file uploads through a Publisher task flow instance:

1. Edit the properties of a Publisher task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Select the checkbox for the property Hide Document Uploader.

4. Click OK.

34.3.3.5.4 Limiting the Scope of Recipients

You can use the Space Name property to limit the scope of recipients of published messages to a user's connections in a particular Space. When you do this, the message does not even stream to your own view of the Activity Stream in the Home Space. It is streamed only to your and your connections' views of the Activity Stream in the named Space.

To limit the scope of recipients to a particular Space:

1. Edit the properties of a Publisher task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Enter the internal name of the Space in the Space Name field.

Tip:

The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the Space banner at the top of the Space.

4. Click OK.

Messages posted through that Publisher task flow instance will be shared with only those connections who have access to the named Space.

34.3.3.5.5 Using the Publisher as a Profile Status Updater

You can use the Is Update Status property to specify that all messages without attachments are published not only to specified recipients, but also as the user's Profile status message (Figure 34-19).

Figure 34-19 Published Message Used as Profile Status

Messages that have an attached file or link are not simultaneously published as a Profile status message.

To specify that messages are also published as Profile status messages:

1. Edit the properties of a Publisher task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Select the Is Update Status checkbox.

4. Click OK.

Messages that do not include attachments that are posted through that Publisher task flow instance are also shared as the user's personal Profile status message.

34.3.3.5.6 Using the Publisher as a File Uploader

You can use the Upload Document Only property to limit the functionality of the Publisher task flow to a file uploader (Figure 34-20).

Figure 34-20 Publisher Task Flow as Document Uploader

Files uploaded through the Publisher task flow are placed in the Public folder in the document library of the selected scope. That is:

- In the Home Space:

- Select Everyone to publish the file to the Public folder in each of your connections' personal Document Library.

- Select a named Space to publish the file to the Public folder in the selected Space's Document Library.

- In a Space, the file is published to the Public folder in the Space's Document Library.

To use the Publisher task flow as a file uploader:

1. Edit the properties of a Publisher task flow instance.

See Also:

For information about editing task flow properties, see Section 17.5.2, "Setting Properties on Page Components."

2. In the Component Properties dialog, bring the Parameters tab forward.

3. Select the Upload Document Only checkbox.

4. Click OK.

The Publisher task flow instance renders as a file uploader (see Figure 34-20). The text area and the Share link icon are not rendered.

35 Setting Your Personal Preferences

WebCenter Spaces Preferences provide easy configuration settings for tailoring your application environment to your particular working style. These include settings for your preferred application display language; your preferred application look and feel; your WebCenter Spaces password; and the like. Additionally, WebCenter Spaces Preferences provide an accessibility setting to optimize the application user interface for use with a screen reader, such as JAWS.

Preferences settings are a user-level customization that affects only your view of the WebCenter Spaces application.

This chapter describes how to specify your personal WebCenter Spaces Preferences. It includes the following sections:

- Section 35.1, "Accessing the Preferences Dialog"

- Section 35.2, "Choosing Your Preferred Display Language"

- Section 35.3, "Setting Date and Time Preferences"

- Section 35.4, "Enabling or Disabling Application Accessibility Options"

- Section 35.5, "Changing the Home Space Look and Feel in Your View"

- Section 35.6, "Changing Your WebCenter Spaces Password"

- Section 35.7, "Providing Login Information for External Applications"

See Also:

Preferences associated with specific services are discussed in the chapters that cover each service.

For information about Messaging, Subscription, and Notifications preferences, see:

- Section 36.2, "Establishing and Managing Your Messaging Channels and Filters"

- Section 36.3.1, "Setting Application-Level Subscriptions"

- Section 36.4, "Viewing and Cancelling Your Subscriptions"

For information about People Connections preferences, see:

- Section 30.3, "Setting Profile Preferences"

- Section 31.2, "Setting Connections Preferences"

- Section 32.2, "Setting Activity Stream Preferences"

- Section 33.2, "Setting Message Board and Feedback Preferences"

For information about Instant Messaging and Presence preferences, see Section 62.2, "Identifying Your Preferred Instant Messaging Provider"

For information about Search preferences, see Section 56.2, "Setting Preferences for WebCenter Spaces Search Results"

For information about Mail preferences, see Section 65.3, "Selecting Your Preferred Mail Connection"

Audience

This chapter is intended for users minimally assigned the authenticated-role (that is, users who can log in to the WebCenter Spaces application) who want to establish their general application preferences. This includes selecting a display language, identifying your preferred date and time formats, specifying a time zone, providing external application login information, and the like.

35.1 Accessing the Preferences Dialog

The easiest way to open the Preferences dialog is to click the Preferences link (Figure 35-1).

Figure 35-1 Preferences Link

The availability of navigational links, such as the Preferences link, is determined by the people who design and build your WebCenter Spaces portal. This being so, you may not see a Preferences link. In such a case, ask your application administrator to make the Preferences link available.

35.2 Choosing Your Preferred Display Language

The display language controls the language in which user interface (UI) elements are rendered in your browser. UI elements include button and field labels, application links, screen text, and so on. The display language also provides options for reflecting the current locale. Locale controls the appearance of symbols, such as monetary symbols, and the reading direction in which UI text is rendered.

To set a display language:

1. Open the Preferences dialog (Figure 35-2).

Figure 35-2 Preferences Dialog

See Also:

For information about accessing the Preferences dialog, see Section 35.1, "Accessing the Preferences Dialog."

2. Click General to access general preferences.

3. From the Language dropdown list, select your preferred display language-locale (Figure 35-3).

Figure 35-3 Language List in Preferences Dialog

Alternatively, select No Preference to accept the application-level default set by your WebCenter Spaces Administrator.

See Also:

For information about setting the application-level default display language, see Chapter 5, "Configuring Global Defaults." For information about display languages in WebCenter Spaces, see Chapter 24, "Working with Multilanguage Portals."

4. Click OK to save your change and exit the Preferences dialog, or click Apply to save your change without exiting.

Your change takes effect once you click OK.

35.3 Setting Date and Time Preferences

Use WebCenter Spaces date and time preferences to specify your preferred date and time formats and your current locale's time zone:

Note:

Some services may be developed with an intrinsic time display format. In such cases, these services are not influenced by your date and time format selections.

To set your preferred time format, date format, and time zone:

1. Open the Preferences dialog (for more information, see Section 35.1, "Accessing the Preferences Dialog").

2. Click General to access general preferences.

3. Set your date and time preferences.

Table 35-1 lists and describes the date and time options available on the Preferences General panel.

Table 35-1 Date and Time Preference Settings

Preference

Setting Options

Time Format

The following list shows time formats; the formats in the UI reflect the current time:

- No Preference—To display the default Time Format established by the WebCenter Spaces administrator

- H:M AM/PM—To display hour, minutes, and AM or PM, such as 4:47 PM

- H:M:S AM/PM—To display hour, minutes, seconds, and AM or PM, such as 4:47:52 PM

- H:M:S AM/PM Time Zone—To display hour, minutes, seconds, AM or PM, and the abbreviation of the specified time zone, such as 4:47:52 PM PDT

Date Format

The following list shows date formats; the formats in the UI reflect the current date:

- No Preference—To use the default date format set by the WebCenter Spaces administrator

- M/D/YY—To use a number format, such as 6/18/10

- MON D, YYYY—To use an abbreviation format and the full year, such as Jun 18, 2010

- Month D, YYYY—To display the full month name and the full year, such as June 18, 2010

- DAY, MONTH D, YYYY—To display the full month name, the full year, and include the day of the week, such as Friday, June 18, 2010

Time Zone

From the Time Zone pick list, select your preferred time zone. Alternatively select No Preference to accept the application-level default set by your WebCenter Spaces Administrator.

4. Click OK to save your changes and exit the Preferences dialog, or click Apply to save your changes without exiting.

35.4 Enabling or Disabling Application Accessibility Options

The General panel in the Preferences dialog provides options related to user accessibility. Select an option to optimize the application user interface (UI) for use with a screen reader, such as JAWS, or disable such optimization.

This section provides information about the use of screen readers with WebCenter Spaces and steps you through the process of enabling the optimization of UI content for use with a screen reader.

This section includes the following subsections:

- Section 35.4.1, "What You Should Know about Application Accessibility Options"

- Section 35.4.2, "Applying Accessibility Options"

35.4.1 What You Should Know about Application Accessibility Options

The WebCenter Spaces application provides accessibility features to enable visually and non-visually impaired users to navigate successfully through the application user interface. This section contains some tips to assist you in using them successfully.

Use the Accessibility Settings option Disable Screen Reader to enable keyboard-centric accessibility capabilities for a sighted user with non-visual impairments, such as mouse usage issues. This option also handles color contrasts.

Use the Accessibility Settings option Enable Screen Reader to optimize the UI for the JAWS screen reader. Once you set your screen reader preference to enabled, click OK to exit Preferences. If you want to set other options in Preferences, then reopen the Preferences dialog. The other Preferences panels, Password, My Accounts, Messaging, People Connections, Presence, Subscriptions, Search, and Mail, are redrawn as radio buttons, enabling the screen reader to detect and access them.

Normally, the screen reader JAWS announces the links associated with a menu selection. With the Actions menu, JAWS does not announce the submenu items. For example, JAWS does not read the submenu items under Manage on the Actions menu. The workaround is to select the menu items using direct keyboard navigation. That is, instead of using JAWS Links chooser, navigate to the Manage submenu of the Actions menu using the Tab key on your keyboard.

Not all dropdown menus, fields, and radio buttons on Space administration pages are labeled. As a result, the JAWS screen reader renders a pound sign (#) instead of a label when the JAWS command Insert-F7 is invoked. The problem occurs in the following areas:

- Dropdown menus in Space administration pages

- Radio buttons on Space administration pages

- Fields on the Documents page

The workaround is to use the Tab and arrow keys to navigate to each individual form field in order to hear each form field read.

When you add resources from the Resource Catalog, JAWS announces all Resource Catalog items as Add. This makes it difficult to identify the selected resource. To work around this issue, press the Tab key to get to the Add link for the resource, then press the Down Arrow key. JAWS then reads the description of the resource.

35.4.2 Applying Accessibility Options

To apply accessibility options to the application UI:

1. Open the Preferences dialog (for more information, see Section 35.1, "Accessing the Preferences Dialog").

2. Click General to access general preferences.

3. From the Accessibility Settings pick list, select your preferred accessibility setting.

Choose from the following options:

- No Preference—Accessibility capabilities are not enabled. Screen readers can still process the application UI, but the UI is not optimized.

- Enable Screen Reader Mode—Specifically for the visually challenged, enables the use of JAWS, the screen reader software.

- Disable Screen Reader Mode—Enables keyboard-centric accessibility capabilities for a sighted users with non-visual impairments, such as mouse usage issues. Additionally, in this mode color contrasts are handled.

Once you enable screen reader mode, click OK to exit Preferences. If you want to set other options in Preferences, then reopen the Preferences dialog. The other Preferences panels: Password, My Accounts, Messaging, People Connections, Presence, Subscriptions, Search, and Mail, are redrawn as radio buttons, enabling the screen reader to detect and access them.

4. Click OK to save your change and exit the Preferences dialog, or click Apply to save your change without exiting.

Alternatively, click Cancel to cancel your change and exit the Preferences dialog.

35.5 Changing the Home Space Look and Feel in Your View

The General panel in the Preferences dialog provides a pick-list of application skins for your view of the Home Space. Application skins specify the application background color, screen fonts, and, with some skins, the shapes and images used for application buttons and icons. The skin you select through Preferences affects the look and feel of your view of the Home Space. No other users' views and no other areas of the application are affected.

To change the Home Space skin in your view:

1. Open the Preferences dialog (for more information, see Section 35.1, "Accessing the Preferences Dialog").

2. Click General to access general preferences.

3. From the Application Skin pick list, select your preferred application skin.

Choose from the following options:

- No Preference—To defer to the application's configured skin setting

- Skin_Name—To select a predefined application skin from the list of skins available to you

4. Click OK to save your change and exit the Preferences dialog, or click Apply to save your change without exiting.

The application refreshes, using the skin you selected for your view of the Home Space.

See Also:

Advanced users can create custom application skins and deploy them to WebCenter Spaces. For more information, see the chapter, "Creating and Managing Skins," in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

35.6 Changing Your WebCenter Spaces Password

Provided your application administrator has enabled you to do so, you can change your WebCenter Spaces password. Changing your password on a regular basis is one way you can participate directly in securing your application software.

See Also:

Your application administrator can prohibit you from changing your application password. If this feature is disabled, you cannot take the steps described in this section. For more information, see Section 6.4.3.4, "Configuring Profile."

To change your WebCenter Spaces password:

1. Open the Preferences dialog (for more information, see Section 35.1, "Accessing the Preferences Dialog").

2. Click Password to open the Password panel (Figure 35-4).

Figure 35-4 Preferences Password Panel

3. In the Old Password field, enter your current password.

4. In the New Password field, enter your new password.

Note:

The requirements for this password are driven by the identity store that manages WebCenter Spaces application users. Every ID store has its own password policy that enforces rules such as password length, password history, and so on. If you have issues setting a new password, contact your application administrator for the password requriements and restricitions of your ID store.

5. In the Confirm New Password field, enter your new password again.

6. Click OK to save your change and exit the Preferences dialog, or click Apply to save your change without exiting.

35.7 Providing Login Information for External Applications

The My Accounts panel in the Preferences dialog provides one-stop access to login credentials for all external applications that have been configured by your application administrator. My Accounts provides a way to store application login credentials so that you provide them only once for the life of the credential. Once you have provided your credentials, every time you access an external application within WebCenter Spaces, the login credentials are provided automatically. This gives you a single-sign-on type of experience where one login (to WebCenter Spaces) provides access to multiple applications.

Note:

If you change the login credentials for an application, you must enter them again into WebCenter Spaces Preferences as described in this section.

To provide login credentials for external applications:

1. Open the Preferences dialog (see Section 35.1, "Accessing the Preferences Dialog").

2. Click My Accounts to open the My Accounts panel (Figure 35-5).

Figure 35-5 Preferences My Accounts Panel

3. In the left pane of the My Accounts panel, select an application.

Log-in credential fields and checkboxes are shown in the right pane.

Tip:

The applications you see on the My Accounts panel are the ones that were configured by your application administrator. Contact your application administrator to request additional applications.

4. Enter log-in credentials as required for the selected application.

Fields requiring values are marked with an asterisk (*).

Note:

Login credentials vary from one application to another. For example, some applications may require user name and password, while others may require those values along with additional values, such as your mail address.

5. Select Remember my login information to enable automatic authentication to the selected application every time you log in to WebCenter Spaces.

Note:

When you do not select Remember my login information, the login information that you enter is used only for the current user session. The next time you log in to WebCenter Spaces, you must also log in to this application.

6. Click OK to save your change and exit the Preferences dialog, or click Apply to save your change without exiting.

The script content on this page is for navigation purposes only and does not alter the content in any way.

36 Setting Up Your Personal Subscriptions and Notifications

Use Subscriptions and Notifications to receive timely notice of changes to your portal and to content surfaced through your portal. Track changes that occur to your connections, your Space memberships, and services scoped to specific Spaces and to the application objects that are important to you. Specify how you are notified: through phone text, mail, or your Worklist.

This chapter describes how to subscribe and unsubscribe to Spaces and application objects, specify how you are notified when they are changed, and manage your subscriptions.

This chapter includes the following sections:

- Section 36.1, "What You Should Know About Subscriptions and Notifications"

- Section 36.2, "Establishing and Managing Your Messaging Channels and Filters"

- Section 36.3, "Subscribing at the Application, Space, and Object Level"

- Section 36.4, "Viewing and Cancelling Your Subscriptions"

- Section 36.5, "Working with Notifications Task Flows"

Audience

This chapter is for users interested in being notified when changes occur to the Spaces and application objects that are important to them.

Your application administrator can enforce certain application defaults that prevent you from setting subscription and notification preferences for yourself. In such cases, you will be unable to perform some of the actions described in this chapter.

See Also:

For information about administrative settings associated with Notifications, see the chapter, "Managing Subscriptions and Notifications," in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

36.1 What You Should Know About Subscriptions and Notifications

Notifications provides an automated means of triggering notices across different messaging channels. Messages are triggered when the Spaces and application objects to which you have subscribed change.

Messaging channels can include phone text, mail, or Worklist (depending on how your administrator has configured Notifications). For example, you can receive a mail message when a particular document changes, a text message when someone responds to a particular discussion topic, a Worklist alert when you receive an invitation to connect. All messages contain links that take you to the scene of the change.

You can choose the objects that trigger a notice by subscribing to them. In WebCenter Spaces, there are three levels of subscription:

- Application, which you can use to receive notices about changes to your Spaces memberships, Message Board, Connections, and Feedback

Such notifications occur only for application-level activities that involve you as the user.

- Space, for changes to a subscribed service, such as Events, Discussions, Announcements, Documents, and Blogs, that occur within the scope of a selected Space

- Object, for changes to the application objects to which you have specifically subscribed, such as a particular document, wiki, blog, and so on

Table 36-1 describes the types of activities that can trigger a notification and indicates the level and location of the associated subscription (for more information, see Section 36.3, "Subscribing at the Application, Space, and Object Level").

Note:

Owning an object, such as a document, wiki, or blog, does not automatically subscribe you to that object. You must explicitly subscribe to an object to receive subscription-related notifications about it, unless the administrator has set and enforced company-wide subscription defaults. For more information about object-level subscriptions, see Section 36.3.3, "Setting Object-Level Subscriptions."

Table 36-1 Activities that Can Trigger Notifications

Activity

Level

Where to Subscribe

A user sends you an invitation to connect

Note: Out of the box, the option to send notifications for invitations to connect is enabled and is not end-user configurable.

Application

Preferences (for more information, see Section 36.3.1, "Setting Application-Level Subscriptions")

Your Space role changes, for example from participant to moderator

Application

Preferences

You are added as a member of a Space

Application

Preferences

Your Space membership is removed

Application

Preferences

A user posts a message to your Message Board

Application

Preferences

A user likes your Message Board post (messages explicitly set on a Message Board and not those added from Publisher to the Activity Stream)

Application

Preferences

A user comments on your Message Board post (messages explicitly set on a Message Board and not those added from Publisher to the Activity Stream)

Application

Preferences

A user posts feedback for you

Application

Preferences

An announcement is created

Space

On the Space, for example, from the Space Actions menu on a Space in Browse Spaces (for more information, see Section 36.3.2, "Setting Space-Level Subscriptions")

A new event is created

Space

On the Space

An event is updated

Space

On the Space

An event is deleted

Space

On the Space

A new discussion topic is created

Space

On the Space

A new discussion forum is created

Space

On the Space

A new document is created or uploaded

Space

On the Space

A wiki document is created

Space

On the Space

A new blog entry is posted

Space

On the Space

A user replies to a discussion topic

Object

On the topic (for more information, see Section 36.3.3, "Setting Object-Level Subscriptions")

A user comments on a discussion topic

Object

On the topic

A user deletes a discussion topic

Object

On the topic

A user comments on a document

Object

On the document

A user likes a document

Object

On the document

A user updates a document

Object

On the document

A user deletes a document

Object

On the document

A user comments on a wiki document

Object

On the wiki

A user likes a wiki document

Object

On the wiki

A user updates a wiki document

Object

On the blog entry

A user deletes a wiki document

Object

On the blog entry

A user comments on a blog entry

Object

On the blog entry

A user likes a blog entry

Object

On the blog entry

A user updates a blog entry

Object

On the blog entry

A user deletes a blog entry

Object

On the blog entry

You can establish your preferred messaging channels through the Messaging panel in the Preferences dialog (for more information, see Section 36.2, "Establishing and Managing Your Messaging Channels and Filters"). Additionally, you can use messaging preferences to create filters for the types of notifications you want to receive.

Messaging configuration is available when your application administrator selects a BPEL server as the connection type for outbound notifications. If the administrator selects a Mail server, the only available messaging channel is mail; consequently, you are neither required nor able to configure your own messaging channels when your administrator selects a Mail server as the connection type for outbound notifications.

See Also:

For information about administrative settings associated with Notifications, see the chapter, "Managing Subscriptions and Notifications," in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default settings for application-level subscriptions are configurable by the application administrator. This means that your initial view of application-level Subscription Preferences is determined by these administrator defaults. Application-level subscriptions appear on the General Subscriptions tab of the Subscriptions panel in the Preferences dialog (Figure 36-1).

Figure 36-1 General Subscriptions Preferences

For each functional area or service on the General Subscriptions tab, the application administrator controls two settings:

- Is subscription enabled for the function or service?

- Are users allowed to change the default setting?

The answers to these questions determine how and whether general subscription options appear on your view of the tab. Table 36-2 illustrates how administrator-level subscription settings affect the appearance of the General Subscriptions tab.

Table 36-2 Effect of Administrator Defaults on Subscriptions Preferences

Subscription EnabledFoot 1

User Can Change Default

Option in Preferences

True

True

Rendered normally, checkbox checked

False

True

Rendered normally, checkbox cleared

True

False

Grayed out, checkbox checked

False

False

Hidden, checkbox hidden

Footnote 1 Rather than enabling or disabling the entire subscription capability, the subscription-enabled attribute merely sets the initial state of the preference option. For example, if subscription-enabled="true", then the associated subscription option is checked by default in the WebCenter Spaces Preferences dialog. If subscription-enabled="false", then the associated subscription option is not checked by default in the dialog.

See Also:

For information about administrative settings associated with Notifications, see the chapter, "Managing Subscriptions and Notifications," in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

You can view and delete all of your subscriptions from one location: the Current Subscriptions tab on the Subscriptions panel in the Preferences dialog (Figure 36-2).

Figure 36-2 Current Subscriptions Preferences

Use the Space Subscriptions tab to view and manage all of your application-, Space-, and object-level subscriptions. For more information, see Section 36.4, "Viewing and Cancelling Your Subscriptions."

36.2 Establishing and Managing Your Messaging Channels and Filters

Out of the box, your mail address is your default messaging channel, and, with no filters defined, a subscription is sufficient to trigger a notification, provided your administrator has configured the external application associated with the Mail server connection to contain shared credentials and provided mail is selected as the messaging default.

See Also:

For information about administrative settings associated with Notifications, see the chapter, "Managing Subscriptions and Notifications," in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

The administrator's selection of a mail server as the messaging default presupposes that the administrator has also established a connection with a mail server. Additionally, the external application associated with the mail server connection must contain shared credentials. For information about connecting to a mail server, see the chapter "Managing the Mail Service," in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Once you have subscribed to an application object, no additional configuration is required to receive a notification through your mail when that object changes.

However, if you want to receive notifications over your phone, through your Worklist, or via an alternate mail address, a little configuration is required. First you must establish a messaging channel. Then you must define a messaging filter. The channel identifies the delivery medium and its associated address (user ID, mail, or phone number). The filter refines the types of notifications you receive and sets the conditions under which a notification is triggered.

This section steps you through the process of setting up your messaging channels and filters. It includes the following subsections:

- Section 36.2.1, "Accessing Messaging Configuration Settings"

- Section 36.2.2, "Establishing a Messaging Channel"

- Section 36.2.3, "Editing a Messaging Channel"

- Section 36.2.4, "Deleting a Messaging Channel"

- Section 36.2.5, "Creating and Applying Messaging Filters"

- Section 36.2.6, "Editing Messaging Filters"

- Section 36.2.7, "Deleting Messaging Filters"

36.2.1 Accessing Messaging Configuration Settings

The Messaging panel in WebCenter Spaces Preferences provides a Manage Configuration button for navigating to User Messaging Preferences.

User Messaging Preferences derive from the User Messaging Service.

See Also:

For information about the User Messaging Service, see the Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

To access messaging configuration settings:

1. Open the Preferences dialog, and click Messaging to bring the Messaging panel forward.

2. Click the Manage Configuration button to open User Messaging Preferences login page.

Note:

The Manage Configuration button is active only when a BPEL server is configured with WebCenter Spaces. Because the BPEL server provides notification features to services, the Manage Configuration button may be active even when your application administrator elects to use a mail server in lieu of a BPEL server for Notifications.

3. Log in to the User Messaging Server (this is not required if single sign-on is implemented).

This opens the User Messaging Preferences panel (Figure 36-3).

Figure 36-3 Messaging Panel in Preferences Dialog

The Messaging Channels tab provides controls for creating and managing messaging channels and a view of all configured messaging channels, such as WORKLIST, EMAIL, and SMS. The EMAIL channel is always available. By default, it uses your email address from the LDAP identity store. If the WORKLIST driver is deployed by your application administrator, it is also automatically added for each user.

The Messaging Filters tab provides a means of defining the conditions under which you are notified and associating a messaging channel with a defined set of conditions.

For information about messaging configuration, see the following subsections:

- Section 36.2.2, "Establishing a Messaging Channel"

- Section 36.2.3, "Editing a Messaging Channel"

- Section 36.2.4, "Deleting a Messaging Channel"

- Section 36.2.5, "Creating and Applying Messaging Filters"

- Section 36.2.6, "Editing Messaging Filters"

- Section 36.2.7, "Deleting Messaging Filters"

Note:

In environments where multiple BPEL connections are registered against the WebCenter Worklist component, the messaging preferences repository is shared by all. When you set messaging preferences for one connection, you set them for all.

36.2.2 Establishing a Messaging Channel

Establishing a messaging channel involves selecting the channel over which a notification is sent and providing the delivery address for that channel.

To establish a messaging channel:

1. Go to the User Messaging Preferences page as described in Section 36.2.1, "Accessing Messaging Configuration Settings."

2. If necessary, click the Messaging Channels tab to bring it forward.

3. Click the Create icon to open the Add Channel dialog (Figure 36-4).

Figure 36-4 Create Icon and Add Channel Dialog

4. In the Name field, enter a display name for the channel.

For example, enter MyPhone.

5. From the Type list, select the channel over which to send notifications:

Tip:

The presence of a channel is determined by the application administrator, who deploys them and makes them available.

- EMAIL to specify that notifications are sent to you through your mail

- SMS to specify that notifications are sent as text messages to your phone

- WORKLIST to specify that notifications are posted to your Worklist

6. In the Address field, enter an address for the selected type:

- For EMAIL, enter the address of the mail account to which to send notifications, for example, my.name@mycompany.com.

- For SMS, enter the phone number to which to send notifications in the format <country_code><area_code><number>, for example, 14154444444.

- For WORKLIST, your user name is provided as a read-only value.

7. For the Default checkbox:

- Select to identify one or more channels as the default channel over which to send notifications.

Default channels are the channels over which are sent all notifications that do not meet any of your defined filtering conditions.

- Clear to prevent selected channels from being used as defaults.

8. Click OK to save your changes and exit the dialog.

To complete your configuration, see Section 36.2.5, "Creating and Applying Messaging Filters."

36.2.3 Editing a Messaging Channel

To revise messaging channel values:

1. Go to the User Messaging Preferences page as described in Section 36.2.1, "Accessing Messaging Configuration Settings."

2. If necessary, click the Messaging Channels tab to bring it forward.

3. Select the messaging channel you want to revise, and click the Edit icon to open the Modify Channel dialog.

4. Change values as desired.

5. Click OK to save your changes and exit the dialog.

36.2.4 Deleting a Messaging Channel

When you delete a messaging channel, any filters that rely on the deleted channel revert to the channel identified as the default. In the absence of a specifically identified default channel, the mail channel is used for sending notifications.

To delete a messaging channel:

1. Go to the User Messaging Preferences page as described in Section 36.2.1, "Accessing Messaging Configuration Settings."

2. If necessary, click the Messaging Channels tab to bring it forward.

3. Select the messaging channel you want to delete, and click the Delete icon.

4. Click OK in the resulting Confirmation dialog.

36.2.5 Creating and Applying Messaging Filters

Messaging filters enable you to qualify the types of notifications you want to receive and weed out the notifications of no interest. Filters also provide a means of associating a selected messaging channel with a particular type of notification. For example, using messaging filters, you can specify that all notifications about document updates go to mail while all notifications about event changes go to your phone, provided your administrator has configured Notifications to use multiple messaging channels.

Two important things to know about setting up messaging filters:

- Text values in your filtering conditions are case-sensitive. For example, messaging filters differentiate between Document and document.

- Create separate conditions for multiple terms. For example, for a Subject that contains Monty gave feedback, create three filtering conditions, one for each term.

To create and apply messaging filters:

1. Go to the User Messaging Preferences page as described in Section 36.2.1, "Accessing Messaging Configuration Settings."

2. If necessary, click the Messaging Filters tab to bring it forward.

3. Click the Create icon to open a filter-creation page.

4. In the Filter Name field, enter a display name for the filter.

5. Optionally, enter a filter description in the Description field.

6. From the Matching list, select from:

- All of the following conditions to require that all of the conditions you specify are met

- Any of the following conditions to require that at least one of the conditions you specify is met

7. From the first Add Filter Condition list, select from:

- Subject to base a condition on words appearing in the message subject

It is likely that the most useful filter condition option is Subject. The subjects of notification messages are standardized and can therefore be anticipated. This makes subjects ideal for setting up filtering conditions. See Table 36-4 for a list of standard notification message subjects and examples of filter conditions.

- From to base a condition on the message sender

All notification messages are sent from the same entity—as configured by your application administrator.

- Date to base a condition on when the message was generated

Date and Time options may be useful for ad hoc situations, for example, you want to ensure that any notifications about events delivered on the day of the event are sent right to your phone.

- Time to base a condition on the time the message was generated

Note:

Of all the filter conditions available on the Add Filter Condition list, Subject, From, Date, and Time are the options that are relevant to and work with the types of messages generated by Notifications. The other options have no effect.

8. From the second Add Filter Condition list, select an operator for the condition.

See Also:

See Table 36-3 for an alphabetical list of operators that are relevant to the attributes Subject, From, Date, and Time.

9. Click the Click to add filter condition icon.

10. From the Messaging Option list, select from:

- Send No Messages to omit notification for the defined filter conditions

- Send Messages to all Selected Channels to send notification through all channels selected from the Add Notification Channel list

- Send to the First Available Channel to send notification through the first open channel of all the selected channels

11. From the Add Notification Channel list, select the channel over which to send the notification messages that meet your defined filter conditions, and then click the Click to add channel to this filter icon.

The Add Notification Channel list is populated with the channels that are defined on the Messaging Channels tab. You can add multiple channels in turn.

12. Click OK to save and apply the messaging filter.

Tip:

if your defined filtering conditions do not match an incoming notification, the User Messaging Server will send notifications over all the channels you have identified as default channels.

Table 36-3 provides an alphabetical list of operators that are relevant to the attributes Subject, From, Date, and Time and describes the values they require.

Table 36-3 Operators relevant to Subject, From, Date, and Time

Operator

ValueFoot 1

Attributes

Between

In the fields provided:

- For Date, enter a start date and end date between which to apply the filter

- For Time, select a start time (hours and minutes) and end time between which to apply the filter

Date, Time

Contains

Enter a string that must be included in the message Subject or return address (From)

Separate multiple values with commas.

Subject, From

isEqual

Enter the literal value that must be used for the message Subject, Date, Time, or return address (From)

Subject, From, Date, Time

isGreaterThan

Enter the message delivery date beyond which to apply the filter

Date

isGreaterThanOrEqual

Enter the message delivery date on which to start applying the filter

Date

isLessThan

Enter the message delivery date before which to start applying the filter

Date

isLessThanOrEqual

Enter the message delivery date on which to stop applying the filter

Date

isNotEqual

Enter a literal value that must be ignored for the message Subject, Date, Time, or return address (From)

Subject, From, Date, Time

isWeekday

No value is required. This operator applies to messages sent on week days.

Date

isWeekend

No value is required. This operator applies to messages sent on weekends.

Date

NotContains

Enter a string that must be excluded from the message Subject or return address (From).

Separate multiple values with commas.

Subject, From

Footnote 1 String values are case sensitive. Multiple values in strings must be separated by a comma.

Table 36-4 provides a list of standard notification message subjects and examples of condition formulations.

Table 36-4 Standard Notification Message Subjects

Standardized Notification Subject

Example Filter Conditions

userName has invited you to become a connection

- Subject Contains connection

- Subject Contains Monty

You can set the condition action to route or ignore all messages concerning a named user for any subject that includes a user name.

userName posted message on your message board

- Subject Contains message

- Subject Contains board

userName commented on your message board posting

Subject Contains commented

userName likes on your message board posting

Subject Contains likes

userName gave feedback to you

- Subject Contains gave

- Subject Contains feedback

Space Membership Change

Subject isEqual Space Membership Change

userName created the documentType documentName

Note: For documentType, either Document or Wiki Document is returned. This means that all file types, except wikis, are identified in the subject as Document.

- Subject Contains Document

- Subject Contains Wiki

- Subject Contains java.txt

- Subject Contains Monty

userName changed the documentType documentName

- Subject Contains changed

- Subject Contains myFile.docx

userName deleted the documentType documentName

- Subject Contains deleted

- Subject Contains document

- Subject isNotEqual java.txt

userName posted a comment on the documentType documentName

- Subject Contains Monty

- Subject Contains comment

- Subject Contains movingforward.docx

userName likes the documentType documentName

- Subject Contains likes

- Subject Contains movingforward.docx

userName created the blog post blogName

- Subject Contains kirk

- Subject Contains tribbles

userName changed the blog post blogName

Subject NotContains tribbles

userName deleted the blog post blogName

- Subject Contains deleted

- Subject Contains blog

userName posted a comment on the blog post blogName

- Subject Contains comment

- Subject Contains blog

userName likes the blog post blogName

- Subject Contains like

- Subject Contains blog

userName created the forum forumName

- Subject Contains Monty

- Subject Contains created

- Subject Contains forum

userName created the discussion topic topicName

- Subject Contains Monty

- Subject Contains topic

This example affects both created and deleted topics. Consider adding the verb, for example, created or deleted, in the filter condition when you want to make a distinction between the two types of actions.

Note, however, that the verb alone is not likely to have the effect you want. For example, if you set the filter condition, Subject Contains deleted, messages for all types of objects upon which a delete action is performed are handled by the filter.

userName replied to the discussion topic topicName

- Subject Contains replied

- Subject Contains topic

- Subject Contains NewTech

userName deleted the discussion topic topicName

- Subject Contains deleted

- Subject Contains topic

userName posted a comment on the discussion topic topicName

- Subject Contains comment

- Subject Contains topic

- Subject Contains NewTech

userName likes the discussion topic topicName

- Subject Contains likes

- Subject Contains NewTech

userName created the event eventName

- Subject Contains Java

- Subject Contains Summit

userName changed the event eventName

- Subject Contains Java

- Subject Contains Summit

- Subject Contains changed

userName deleted the event eventName

- Date isEqual 5/31/10

- Subject Contains event

- Subject Contains Java

- Subject Contains Summit

On the day of the event, all notifications concerning the Java Summit event are routed to a selected channel. You can omit the term event, and receive other related notifications, such as an announcement concerning Java Summit.

userName created the announcement announcementName

- Subject Contains created

- Subject Contains announcement

userName changed the announcement announcementName

- Subject Contains Monty

- Subject Contains announcement

userName deleted the announcement announcementName

- Subject Contains announcement

- Subject Contains mySpace

36.2.6 Editing Messaging Filters

To edit a messaging filter:

1. Go to the User Messaging Preferences page as described in Section 36.2.1, "Accessing Messaging Configuration Settings."

2. If necessary, click the Messaging Filters tab to bring it forward.

3. Select the filter condition to edit, and click the Edit icon.

4. Make your changes.

5. Click OK to save and apply your changes.

36.2.7 Deleting Messaging Filters

To delete a messaging filter:

1. Go to the User Messaging Preferences page as described in Section 36.2.1, "Accessing Messaging Configuration Settings."

2. If necessary, click the Messaging Filters tab to bring it forward.

3. Select the filter condition to delete, and click the Delete icon.

4. Click OK in the resulting Confirmation dialog.

Note:

You can remove a filtering condition without deleting the entire filter. Follow the steps in Section 36.2.6, "Editing Messaging Filters," and click the Delete icon next to the condition to remove.

36.3 Subscribing at the Application, Space, and Object Level

Where you perform a subscription varies according to the level at which the subscription is applied as well as the type of object being subscribed to. For example:

- Application-level subscriptions are made through your personal preferences.

- Space-level subscriptions are made on the Space's Actions menu on the Browse Spaces page.

- Object-level subscriptions are made on the object itself.

This section steps you through these subscription scenarios. It includes the following subsections:

- Section 36.3.1, "Setting Application-Level Subscriptions"

- Section 36.3.2, "Setting Space-Level Subscriptions"

- Section 36.3.3, "Setting Object-Level Subscriptions"

36.3.1 Setting Application-Level Subscriptions

Set application-level subscriptions on the Subscriptions panel in the Preferences dialog (Figure 36-5).

Figure 36-5 General Subscriptions Preferences

You can use subscription preferences to specify whether to receive notifications from the People Connections service for activities related to Connections, Feedback, and Message Board. Additionally, you can use subscriptions preferences to subscribe to Space management activities, such as a changes to any of your Space memberships or roles.

Application-level subscriptions are affected by the defaults set by the application administrator. In your view of Preferences, some subscription options may appear but be unavailable, while others may be hidden completely. For more information, see Section 36.1, "What You Should Know About Subscriptions and Notifications."

To set application-level subscriptions:

1. Open the Preferences dialog, click Subscriptions to open the Subscriptions panel, and, if necessary, click the General Subscriptions tab to bring it forward.

2. Select the checkbox next to an option for which to receive notifications through mail or other selected channels.

See Also:

For more information about messaging channels, see Section 36.2, "Establishing and Managing Your Messaging Channels and Filters."

Select from:

- Message Board to receive notification when other users post messages to your Message Board, like your posts, and comment on your posts

- Space Management to receive notification when you are added or removed as a member or your role changes

- Connections to receive notification when another user invites you to connect

- Feedback to receive notification when other users leave feedback for you

Clear the checkbox next to the options for which to omit notifications.

3. Click Apply to apply your changes and remain in the dialog; or click OK to save your changes and exit the dialog.

See Also:

For information about managing application-level subscriptions, see Section 36.4.1, "Viewing and Cancelling Application-Level Subscriptions."

36.3.2 Setting Space-Level Subscriptions

Subscribe to a Space on the Space's Actions menu on the Spaces page (Figure 36-6).

Figure 36-6 Subscribe Option on Spaces Actions Menu

You can use Space-level subscriptions to trigger notification messages whenever any of the following actions occur within the scope of the subscribed Space:

- An announcement is created

- An event is created, updated, or deleted

- A discussion forum or topic is created

- A document is created or uploaded

- A wiki document is created

- A blog entry is posted

To subscribe to a Space:

1. Navigate to the Spaces page (Figure 36-7).

Figure 36-7 Browse Spaces Option on the Spaces Menu

2. Right-click the Space's icon or name, and select Contact and then Subscribe (Figure 36-8).

Figure 36-8 Subscribe Option on Spaces Actions Menu

3. In the Subscribe dialog, select one or more of the following options:

Note:

An option appears in this dialog only when its associated service has been provided to the Space. For example, if the Space is not provided with the Discussions service, the Discussions option does not appear in this dialog.

- Space Event, to receive notice whenever an event is created, updated, or deleted from this Space

- Documents, to receive notice whenever a document is created or uploaded to this Space

See Also:

To see a more detailed level of notifications regarding a specific document, such as when it is updated, subscribe to the document at the object level. For more information, see Section 36.3.3.1, "Subscribing to a File."

- Blogs, to receive notice whenever a blog entry is posted in this Space

See Also:

To see a more detailed level of notifications regarding a specific blog entry, such as when it is edited, liked, or commented on, subscribe to the blog entry at the object level. For more information, see Section 36.3.3.3, "Subscribing to a Blog Entry."

- Discussions, to receive notice whenever a discussion topic is created in this Space

See Also:

To see a more detailed level of notifications regarding a specific discussion topic, such as when it is edited, liked, or commented on, subscribe to the topic at the object level. For more information, see Section 36.3.3.4, "Subscribing to a Discussion Topic."

- Announcements, to receive notice whenever an announcement is created in this Space

4. Click Save to save your settings and exit the dialog.

Once you have subscribed to a Space, the subscription is reflected on the Space Subscriptions tab on the Subscriptions panel in the Preferences dialog. Here you can view all of your Space- and object-level subscriptions. For more information, see Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

36.3.3 Setting Object-Level Subscriptions

You can use object-level subscriptions to trigger notification messages for actions performed on a selected document, wiki, blog entry, or discussion topic. This section describes how to subscribe to each. It includes the following subsections:

- Section 36.3.3.1, "Subscribing to a File"

- Section 36.3.3.2, "Subscribing to a Wiki Document"

- Section 36.3.3.3, "Subscribing to a Blog Entry"

- Section 36.3.3.4, "Subscribing to a Discussion Topic"

36.3.3.1 Subscribing to a File

When you subscribe to a file, whenever a user revises or deletes the file, or likes or comments on it, you are notified through your selected messaging channel.

See Also:

For more information, see Section 36.2, "Establishing and Managing Your Messaging Channels and Filters."

To subscribe to a file:

1. Go to the location where the file you want to subscribe to is listed.

2. Click the file link to open the file in the Document Viewer.

3. From the File menu, select Subscribe (Figure 36-9).

Figure 36-9 Subscribe Option on a File Menu

See Also:

For information about unsubscribing, see Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

36.3.3.2 Subscribing to a Wiki Document

When you subscribe to a wiki, whenever a user performs a major edit on, deletes, likes, or comments on the selected wiki, you are notified through your selected messaging channel.

Tip:

Users can identify a wiki document edit as major, in which case notification is sent. If the edit is not marked as major, no notification is sent.

To subscribe to a wiki:

1. Go to the wiki you want to subscribe to.

2. Open the File menu, and select the Subscribe option (Figure 36-10).

Figure 36-10 Subscribe Option on a File Menu

See Also:

For information about unsubscribing, see Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

36.3.3.3 Subscribing to a Blog Entry

When you subscribe to a blog entry, whenever a user edits, likes, comments on, or deletes the selected blog entry, you are notified through your selected messaging channel.

See Also:

For more information, see Section 36.2, "Establishing and Managing Your Messaging Channels and Filters."

To subscribe to a blog entry:

1. Go to the blog that contains the entry you want to subscribe to.

2. Click the link to the blog entry of interest to display its content.

3. From the File menu, select Subscribe (Figure 36-11).

Figure 36-11 Subscribe Option on a File Menu

See Also:

For information about unsubscribing, see Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

36.3.3.4 Subscribing to a Discussion Topic

When you subscribe to a discussion topic, whenever a user, edits, deletes, likes, or comments on the selected discussion topic, you are notified through your selected messaging channel.

See Also:

For more information, see Section 36.2, "Establishing and Managing Your Messaging Channels and Filters."

To subscribe to a discussion topic:

1. Go to the discussion topic you want to subscribe to.

2. Click the Subscribe link at the top of the topic (Figure 36-12).

Figure 36-12 Subscribe Link on a Discussion Topic

See Also:

For information about unsubscribing, see Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

36.4 Viewing and Cancelling Your Subscriptions

Where you view and cancel your current subscriptions depends on the level of the subscription:

- In addition to making application-level subscriptions, you can view and cancel application-level subscriptions on the General Subscriptions tab on the Subscriptions panel in the Preferences dialog.

- View and cancel Space- and object-level subscriptions on the Current Subscriptions tab on the Subscriptions panel in the Preferences dialog.

See Also:

The settings available on the Current Subscriptions tab are also provided through the Subscriptions Viewer task flow. For more information, see Section 36.5, "Working with Notifications Task Flows."

This section provides information about how to view and cancel your application-level subscriptions and how to view and cancel your Space- and object-level subscriptions. It includes the following subsections:

- Section 36.4.1, "Viewing and Cancelling Application-Level Subscriptions"

- Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions"

36.4.1 Viewing and Cancelling Application-Level Subscriptions

View and cancel application-level subscriptions through Preferences or through the Subscription Preferences task flow (for more information, see Section 36.5, "Working with Notifications Task Flows").

To view or cancel application-level subscriptions:

1. Open the Preferences dialog, click Subscriptions to open the Subscriptions panel, and, if necessary, click the General Subscriptions tab to bring it forward.

Here you can readily view and change your current application-level subscriptions.

2. To cancel a subscription, clear its checkbox.

36.4.2 Viewing and Cancelling Space- and Object-Level Subscriptions

Both Space- and object-level subscriptions are listed in the Preferences dialog on the Subscriptions panel. Use the controls on the Current Subscriptions tab to adjust your view of these subscriptions and to cancel (or unsubscribe from) a Space- or object-level subscription.

Tip:

Space- and object-level subscriptions can be cancelled through the same action you took to create the subscription. At the Space- and object-levels, subscription options toggle between subscribed and unsubscribed. Follow the steps outlined in Section 36.3.2, "Setting Space-Level Subscriptions," and Section 36.3.3, "Setting Object-Level Subscriptions," but select to unsubscribe instead.

See Also:

The settings available on the Current Subscriptions tab are also provided in the Subscriptions Viewer task flow. For more information, see Section 36.5, "Working with Notifications Task Flows."

To view and cancel Space- and object-level subscriptions:

1. Open the Preferences dialog, click Subscriptions to open the Subscriptions panel, and, if necessary, click the Current Subscriptions tab to bring it forward.

2. Use the View menu to control the display order of columns and to hide or show individual columns.

3. To cancel or unsubscribe from a Space- or object-level subscription, select the subscription, and click Unsubscribe.

4. In the resulting Unsubscribe Notification Subscription dialog, click Unsubscribe.

The selected subscription no longer appears on the list of subscriptions.

5. Click OK to exit the Preferences dialog.

36.5 Working with Notifications Task Flows

The Notifications task flows duplicate the features provided through Notifications preferences, with the added benefit of flexibility. That is, you can place Notifications task flows on any page on which you have Edit permission. Additionally, the Subscription Preferences task flow changes scope according to where it is placed.

The options available through Notifications task flows duplicate those available in Subscription Preferences and in Space-level subscription dialogs. These options are discussed in Section 36.3, "Subscribing at the Application, Space, and Object Level."

This section provides an overview of Notifications task flows and catalogs their associated task flow parameters. It includes the following subsections:

- Section 36.5.1, "What You Should Know About Notifications Task Flows"

- Section 36.5.2, "Adding Notifications Task Flows to a Page"

- Section 36.5.3, "Setting Notifications Task Flow Properties"

36.5.1 What You Should Know About Notifications Task Flows

Two Notifications task flows are available through the Resource Catalog:

Note:

The content of the Resource Catalog is determined by the application administrator. For example, by default, the Subscription Preferences task flow is not available in the Resource Catalog, but your application adminstrator can add it. Consequently, it is documented here. For more information, see Section 16.3.1.2, "Adding Resources."

- Subscription Preferences, which provides subscription options according to where its is placed:

- A Subscription Preferences task flow on a Home Space page provides application-level subscription options (Figure 36-13).

Figure 36-13 Subscription Preferences Task Flow on a Home Space Page

- A Subscription Preferences task flow on a Space page provides Space-level subscription options (Figure 36-14).

Figure 36-14 Subscription Preferences Task Flow on a Space Page

See Also:

For information about controls for:

- Application-level subscriptions, see Section 36.3.1, "Setting Application-Level Subscriptions," and Section 36.4.1, "Viewing and Cancelling Application-Level Subscriptions."

- Space-level subscriptions, see Section 36.3.2, "Setting Space-Level Subscriptions," and Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

- Subscription Viewer, which provides the same controls that are available on the Space Subscriptions tab of the Subscriptions panel in the Preferences dialog (Figure 36-15)

Figure 36-15 Subscription Viewer Task Flow

See Also:

For information about the controls that are available on the Space Subscriptions tab, see Section 36.4.2, "Viewing and Cancelling Space- and Object-Level Subscriptions."

36.5.2 Adding Notifications Task Flows to a Page

The process of adding a Notifications task flow to a page is the same for all task flows (for more information, see Section 17.5, "Adding Resource Catalog Components to Pages").

36.5.3 Setting Notifications Task Flow Properties

Notifications task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 36-16)

Figure 36-16 Subscription Preferences Task Flow Component Properties

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties associated with Notifications task flows and describe the properties available on the Parameters tab:

- Section 36.5.3.1, "What You Should Know About Notifications Task Flow Properties"

- Section 36.5.3.2, "Notifications Task Flow Parameters"

- Section 36.5.3.3, "Hiding Save and Refresh Actions on Subscription Preferences"

- Section 36.5.3.4, "Displaying Subscription Controls for One Space in Another"

36.5.3.1 What You Should Know About Notifications Task Flow Properties

When you set property values on a Notifications task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog can affect the default task flow content. For descriptions of the parameters on this tab, see Section 36.5.3.2, "Notifications Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

36.5.3.2 Notifications Task Flow Parameters

Table 36-5 describes the parameters that are unique to the Subscription Preferences task flow. The Subscription Viewer task flow does not have associated parameters.

Table 36-5 Subscription Preferences Task Flow Parameters

Parameter

Description

Hide Actions

A control for showing or hiding the Save button and Refresh icon

- true to hide these controls

- false to show them (default)

Scope Name

The name of the Space for which to display Space-level subscription options

Use the Space internal name, available on the General Settings page under Space Settings. The Space internal name is at the end of the value in the Space URL field. For example, in the following URL, the Space internal name is standards:

http://myHost[...]/webcenter/spaces/standards

36.5.3.3 Hiding Save and Refresh Actions on Subscription Preferences

The Subscription Preferences task flow has an associated parameter, named Hide Actions, that you can use to hide the Save button and Refresh icon on a selected task flow instance.

To hide the Save and Refresh actions on a task flow instance:

1. Go to the page that contains the task flow instance you want to change.

2. Open the page in edit mode.

3. Click the Edit icon (wrench) on the task flow header to open the Component Properties dialog.

4. Click the Parameters tab to bring it forward.

5. Click the menu icon next to Hide Actions, and select Expression Builder to open an Expression Language (EL) editor.

6. Select Type a value or expression, remove the current value in the field, and enter #{true}.

7. Click OK to exit the editor.

8. Click OK to exit the Component Properties dialog.

9. Click Save to save the page, and click Close to exit edit mode.

Tip:

To show the Save and Refresh actions, repeat the steps in this section, entering #{false} in lieu of the current value.

36.5.3.4 Displaying Subscription Controls for One Space in Another

The Subscriptions Preferences task flow has an associated parameter, named Scope Name, that enables you to display the subscription options for one Space in another Space.

Scope Name can be handy in a few use cases. For example, normally, a Subscription Preferences task flow shows application-level subscription options when it is situated in the Home Space. Instead, you could use Scope Name to control your subscription options for a particular Space from the Home Space. You could also set up a control center from which to control settings for various Spaces from one location.

To display subscription controls for one Space in another:

1. Go to the page that contains the task flow instance you want to change.

2. Open the page in edit mode.

3. Click the Edit icon (wrench) on the task flow header to open the Component Properties dialog.

4. Click the Parameters tab to bring it forward.

5. In the Scope Name field, enter the name of the Space for which to display subscription controls.

Note:

Use the Space internal name, available on the General Settings page under Space Settings. The Space internal name is at the end of the value in the Space URL field. For example, in the following URL, the Space internal name is standards:

http://myHost[...]/webcenter/spaces/standards

6. Click OK to exit the Component Properties dialog.

7. Click Save to save the page, and click Close to exit edit mode.

Tip:

To change the instance to show subscription controls for the current scope, repeat the steps in this section, but remove the value in the Scope Name field.

37 Creating and Managing Your Personal Favorites

Use Favorites to keep your own personal list of favorites to access from any browser you choose. This chapter describes how to create, organize, and manage a list of personal favorites.

This chapter includes the following sections:

- Section 37.1, "What You Should Know About Favorites"

- Section 37.2, "Accessing the Favorites User Interface"

- Section 37.3, "Adding Favorites"

- Section 37.4, "Adding Favorites Folders"

- Section 37.5, "Managing Favorites"

Audience

This chapter is intended for users who want to create and manage portable links to their favorite and most useful web sites.

37.1 What You Should Know About Favorites

The great advantage to WebCenter Spaces Favorites is their portability. They are not dependent on a particular web browser, so any browser you use to access your WebCenter Spaces application provides access to your WebCenter Spaces Favorites. You can create favorite links to sites internal or external to WebCenter Spaces. This makes WebCenter Spaces the best choice for managing and tracking your favorites list.

Favorites are personal. The favorites you see on the Favorites menu are the favorites you create. No other user sees your favorites, and you do not see any other user's favorites. If you like, though, you can share favorites with other users, by making one or more of them discoverable in a search.

Favorites are not associated with the space that was open when you created them. That is, when you move from one Space to another, the favorites on the Favorites menu stay the same.

WebCenter Spaces provides a Manage Favorites window, which you can use to further customize your favorites. Use the Manage Favorites window to:

- Control the order of display of links on the Favorites menu

- Specify a method for opening a favorite target

- Create folders for organizing your favorites

- Create, edit, or delete favorite links and folders

For more information about the Manage Favorites window, see Section 37.5, "Managing Favorites."

37.2 Accessing the Favorites User Interface

The easiest way to access the Favorites user interface is to access the Favorites menu. However, the availability of navigational links and menus is determined by the people who design and build your WebCenter Spaces portal. This being so, you may not see a Favorites menu.

The Favorites Menu and Add To Favorites option are available as Spaces components (see Section 13.2.4, "Add to Favorites," and Section 13.2.14, "Favorites Menu."). If the WebCenter Spaces administrator has added these components to the Resource Catalog that is used for personal pages, then you can edit the page (provided you are authorized) and add the Add To Favorites or Favorites Menu component to your page.In a Space, these components must be included in the Resource Catalog that is provided for all Spaces or just this Space.

See Also:

For information about adding components to a Resource Catalog, see Section 16.3.1.2, "Adding Resources." For information about configuring the application or a Space to use a particular Resource Catalog, see Section 16.10.1, "Configuring the Application-Level Resource Catalog," and Section 16.10.2, "Configuring the Space-Level Resource Catalog."

37.3 Adding Favorites

Add favorite links for quick access to WebCenter Spaces pages and the web sites you find most useful. If you like, you can share favorites with other users by making one or more of them discoverable in a search. This section describes how to add new favorites and how to share them with other users.

Note:

This section describes how to add favorites through the Favorites menu. You can also add favorites through the Manage Favorites window. For more information, see Section 37.5.1, "Adding a Favorite Through the Manage Favorites Window."

You can add files, including wikis and blogs, through the Document Previewer. For more information, see Section 41.28, "Adding a File to Your Favorites."

To add a favorite:

1. The way you obtain your favorite's URL differs depending on the circumstances:

- For pages external to WebCenter Spaces, go to a favorite web location and copy its URL.

- For WebCenter Spaces pages, log in and go to the page you want to make a favorite.

- If you know the URL, enter it manually when the time comes.

2. Log in, and, navigate to the Add To Favorites dialog (for more information, see Section 37.2, "Accessing the Favorites User Interface").

3. In the Name field, enter a name for the favorite (Figure 37-1).

Figure 37-1 Add To Favorites Dialog

Note:

The value you enter for Name becomes the favorite's link text. The name of the current page is provided by default. You can change this or leave it as is.

4. In the Web Address field, enter the target URL for the favorite.

The default entry for this field is the URL of the current WebCenter Spaces page; you have three options:

- Leave the default entry as is.

- Paste the URL you copied in step 1.

- Enter the URL manually.

5. From the Create In pick list, select the favorites folder in which to create the favorite.

See Also:

WebCenter provides one top-level default folder: Favorites. You can also create your own folders by clicking the New Folder button. For more information, see Section 37.4, "Adding Favorites Folders."

6. To enable this favorite to be discovered by other users during a search, select the Shared checkbox.

Clear the Shared checkbox if you do not want other users to have any kind of access to this favorite.

7. Click OK to add the favorite to the Favorites menu and the Manage Favorites window.

37.4 Adding Favorites Folders

To keep your list of favorites manageable, you can organize them into folders. The folder hierarchy you create appears on the Favorites menu and in the Manage Favorites window. Because the favorite folders you create are user-level customizations, they display only in your application view and not in any other user's.

Note:

This section describes one way to create favorites folders. You can also create them in the Manage Favorites window. For more information, see Section 37.5.3, "Editing Favorites and Favorites Folders."

To add a favorites folder:

1. Log in, and, navigate to the Add To Favorites dialog.

See Also:

For more information, see Section 37.2, "Accessing the Favorites User Interface."

2. Click the New Folder button to open the Create Folder dialog (Figure 37-2).

Figure 37-2 New Folder Button and Create Folder Dialog

3. In the Folder Name field, enter a name for the new folder.

4. Click Create to save the new folder and close the Create Folder dialog.

The new folder appears as a selection in the Add To Favorites dialog on the Create In pick list.

5. Click OK to close the Add To Favorites dialog.

37.5 Managing Favorites

The WebCenter Spaces Manage Favorites window provides a convenient, one-stop location for creating, editing, and deleting favorite links and folders and rearranging their display order on the Favorites menu (Figure 37-3).

Figure 37-3 Manage Favorites Dialog

This section describes how to use the controls available in the Manage Favorites window. It contains the following subsections:

- Section 37.5.1, "Adding a Favorite Through the Manage Favorites Window"

- Section 37.5.2, "Adding a Favorites Folder Through the Manage Favorites Window"

- Section 37.5.3, "Editing Favorites and Favorites Folders"

- Section 37.5.4, "Rearranging Favorites and Favorites Folders"

- Section 37.5.5, "Searching for Favorites"

- Section 37.5.6, "Deleting Favorites and Favorites Folders"

37.5.1 Adding a Favorite Through the Manage Favorites Window

When you want to add multiple favorites, the best place to do this is in the Manage Favorites window. This is because the Manage Favorites window remains open until you close it, saving you steps in the creation process.

To add favorites through the Manage Favorites window:

1. Go to the web page you want to make a favorite, and copy its URL.

You can skip this step if you plan to enter the URL manually.

2. Log in, and, navigate to the Manage Favorites window (for more information, see Section 37.2, "Accessing the Favorites User Interface").

3. Select the folder to which you want to add the favorite.

Tip:

Select a folder by clicking in its row.

4. Click the Add button in the toolbar at the top of the window (Figure 37-4).

Figure 37-4 Add Button in Manage Favorites Dialog

5. In the resulting Add Favorites dialog, go to the Name field and enter a display name for the favorite (Figure 37-5).

Figure 37-5 The Add To Favorites Dialog from the Manage Favorites Window

6. In the Web Address field, paste the URL you copied in step 1, or enter a URL manually.

7. To enable the sharing of this favorite in other users' search results, select Shared.

8. Click OK.

The new favorite appears in the Manage Favorites window and on the Favorites menu (Figure 37-6).

Figure 37-6 New Favorite on Favorites Menu

9. Click Close to exit the Manage Favorites window.

37.5.2 Adding a Favorites Folder Through the Manage Favorites Window

To keep your list of favorites manageable, you can organize them into folders. The folder hierarchy you create appears on the Favorites menu and in the Manage Favorites window. Because the favorite folders you create are user-level customizations, they display only in your application view and not in any other user's.

In addition to adding favorites folders through the Add To Favorites dialog (see Section 37.4, "Adding Favorites Folders") you can add them through the Manage Favorites window.

To add a favorites folder through the Manage Favorites window:

1. Log in, and, navigate to the Manage Favorites window (for more information, see Section 37.2, "Accessing the Favorites User Interface").

2. Select the folder in which to create the new folder, and click the New button in the toolbar at the top of the window (Figure 37-7).

Figure 37-7 New Button in Manage Favorites Dialog

3. In the resulting Create Folder dialog, go to the Folder Name field and enter a display name for the favorite folder (Figure 37-8).

Figure 37-8 Create Folder Dialog

4. Click Create.

The new folder appears in the Manage Favorites window and on the Favorites menu.

5. Click Close to exit the Manage Favorites window.

37.5.3 Editing Favorites and Favorites Folders

The Manage Favorites window provides controls for editing favorites and favorites folders. Use this feature to revise a folder or favorite name, a favorite target URL, or a favorite open behavior.

Open behavior determines how a favorite target URL opens from the Favorites menu or the Manage Favorites dialog. Choose from opening a favorite target in the current browser window, in a new browser window, or on a new WebCenter Spaces tab.

To edit a favorite or favorite folder:

1. Log in, and, navigate to the Manage Favorites window (for more information, see Section 37.2, "Accessing the Favorites User Interface").

2. If necessary, expand favorites folders to access the favorite or folder you want to edit.

Tip:

To expand a folder, click the Expand icon to the left of the folder.

3. Select the favorite or favorite folder you want to edit, and click the Edit button in the toolbar to open the Edit Favorite or Folder dialog (Figure 37-7).

Tip:

To select a favorite or a folder, click in its row.

Figure 37-9 Edit Favorite Dialog

Table 37-1 lists and describes the types of values you can enter for the Edit Favorite and Edit Folder dialogs.

Table 37-1 Values Taken By Edit Favorite and Edit Folder Dialogs

Label

Applies To

Value

Name

Edit Favorite and Folder

The display name of the favorite or folder. This is the name that appears on the Favorites menu and in the Manage Favorites window.

This field is editable.

Location

Edit Favorite

The favorite target URL.

This field is editable

Shared

Edit Favorite

Specify whether to allow other users to discover this favorite through a search.

Checked means yes, cleared means no.

This checkbox is editable.

Open Behavior

Edit Favorite

An option for specifying how a favorite opens. Choose from:

- New Window—The favorite opens in a new browser tab or window.

- WebCenter Tab—The favorite opens on a new WebCenter Spaces tab.

- Current Window—The current browser window redraws, displaying the favorite target.

This field is editable.

Note: The open behavior you specify for a Favorite does not apply to Favorites returned in a search. To control the open behavior of a Favorite returned in a search, right click the search result and select an open behavior from your browser's context menu.

Open behavior does not affect WebCenter Spaces targets. Such pages always open as a tab in WebCenter Spaces. Open behavior affects URL targets outside the WebCenter Spaces context, such as www.google.com and the like.

Type

Edit Favorite

The link type, always URL.

This field is read-only.

Icon

Edit Favorite and Folder

An option for providing an icon to display along with the display name shown in the Favorites menu.

Enter the full URL to the icon.

This field is editable.

Created On

Edit Favorite and Folder

The date the favorite or folder was created.

This field is read-only.

Last Visited On

Edit Favorite

The date the favorite was last visited using the favorites link.

This field is read-only.

4. Make your changes to the fields and pick lists.

5. Click OK to save your changes and close the Edit Favorites dialog.

37.5.4 Rearranging Favorites and Favorites Folders

The Manage Favorites window provides controls for moving a favorite or a favorite folder higher or lower on the Favorites menu. You can accomplish a move by clicking icons or by dragging and dropping. Use this feature to arrange your view of the Favorites menu exactly to your liking.

To rearrange favorites and favorites folders:

1. Log in, and, navigate to the Manage Favorites window (for more information, see Section 37.2, "Accessing the Favorites User Interface").

2. If necessary, in the Manage Favorites window, expand favorites folders and then select the favorite or folder you want to rearrange.

Tip:

To select a favorite or a folder, click in its row.

3. Click the Move Up or Move Down icon in the Manage Favorites toolbar to rearrange the selected favorite or folder (Figure 37-10).

Figure 37-10 Move Icons in Manage Favorites Dialog

Alternatively, drag the favorite or folder to its target position.

Accessibility Note:

In WebCenter Spaces, you cannot move a favorite into an existing folder using only the keyboard. To work around this issue, create a duplicate favorite within the existing folder, then delete the original favorite.

4. Click Close to exit the Manage Favorites window.

The favorite or folder is repositioned in the Manage Favorites window and on the Favorites menu.

37.5.5 Searching for Favorites

The Manage Favorites window includes a search feature that enables you to locate favorites. You can use the favorites search feature to search for favorite display names or target URLs. This search feature does not search for favorite folder names. Search results display in the Manage Favorites window.

To search for favorites:

1. Log in, and, navigate to the Manage Favorites window (for more information, see Section 37.2, "Accessing the Favorites User Interface").

2. Enter a search term in the Search field, and click the Search icon (Figure 37-11).

Figure 37-11 Filter Feature in Manage Favorites Dialog

Results display in the Manage Favorites window.

Tip:

To exit search results, you must exit the Manage Favorites window. Alternatively, you can delete the search term from the Search field and click the Search icon. A search without a search term returns the Manage Favorites window to its default view.

3. Click Close to close the Manage Favorites window.

37.5.6 Deleting Favorites and Favorites Folders

When you delete a favorite or a favorites folder, it is permanently removed from both the Favorites menu and the Manage Favorites window. Additionally, when you delete a favorites folder all the favorites it contains are also deleted.

To delete favorites and favorites folders:

1. Log in, and, navigate to the Manage Favorites window (for more information, see Section 37.2, "Accessing the Favorites User Interface").

2. Select the favorite or favorite folder you want to delete.

Tip:

To select a favorite or favorite folder, click in its row.

3. Click the Delete button on the Manage Favorites toolbar (Figure 37-12).

Figure 37-12 Delete Button in Manage Favorites Dialog

The selected favorite or favorite folder and any favorites the folder contained are permanently removed from the Manage Favorites window and the Favorites menu.

4. Click Close to close the Manage Favorites window.

38 Creating and Managing Personal Pages

Provided your administrator has enabled you to do so, in the Home Space you can create, secure, edit, copy, and delete your own personal pages. This chapter steps you through the process of creating, securing, editing, copying, and deleting personal pages in the Home Space. It includes the following sections:

- Section 38.1, "Creating Personal Pages in the Home Space"

- Section 38.2, "Controlling User Access to Your Personal Pages"

- Section 38.3, "Editing a Personal Page"

- Section 38.4, "Copying a Personal Page"

- Section 38.5, "Deleting a Personal Page"

Note:

Application administrators may choose to prohibit the creation of personal pages in the Home Space, allowing only the display of business role pages and system pages, over which you have less control.

For information about business role pages and system pages, see Chapter 7, "Preparing Your Initial Portal Pages ."

Audience

This chapter is intended for users granted the application-level permission Pages: Create, Edit, and Delete Pages. Typically such users want to create and manage pages for their personal use. This includes creating personal pages in the Home Space and copying, hiding or showing, securing, editing, and performing other like actions such pages.

The actions described in this chapter are for the personal pages that you create in your own view of the Home Space. Other types of pages, such as business role pages, may also be exposed in the Home Space and do not provide the same level of access.

38.1 Creating Personal Pages in the Home Space

Provided the proper permissions are in place, in the Home Space you can create your own personal pages and populate them with layout components, such as Rich Text Editors and Boxes, and content, such as task flows, portlets, and documents.

WebCenter Spaces provides a feature for setting up page creation defaults. This enables you to predetermine the options that are selected in the Create Page dialog by default and even to skip the dialog entirely by enforcing your selections.

This section describes how to set up page creation defaults and how to create pages. It includes the following subsections:

- Section 38.1.1, "Setting Page Creation Defaults for Personal Pages"

- Section 38.1.2, "Creating a Personal Page in the Home Space"

38.1.1 Setting Page Creation Defaults for Personal Pages

In the Home Space, provided your WebCenter Spaces administrator has made the option available, you can set page creation defaults to reduce the number of steps required to create a personal page. That is, you can use page creation defaults to specify the options that are selected by default when you open the Create Page dialog. You can take this further by enforcing your selections, turning page creation into a one-click operation. When you enforce your selections, you are telling the application that you want to bypass the Create Page dialog and create pages based on your default selections.

Tip:

When you skip the Create Page dialog, your result is a page with a generic name. Easy access controls are in place for enabling a quick rename of a page. For more information, see Section 29.6, "Renaming a Page."

Use page creation default settings to specify a default page style and enable or disable one-click page creation. The style describes the page layout (for examples of seeded page styles, see Table 15-2, "Default Page Styles").

Note:

The settings you establish for yourself override any page-creation settings an administrator may provide.

This section provides examples of how to access page creation default settings and how to set personal page creation defaults. It includes the following subsections:

- Section 38.1.1.1, "Accessing Page Creation Default Settings"

- Section 38.1.1.2, "Setting Personal Page Creation Defaults"

See Also:

The application administrator can set application-wide page creation defaults for personal pages. Individual users can override these defaults by following the steps in this section.

The page creation defaults an administrator sets for business role pages also affect personal pages. For more information about application-level page creation defaults, see Section 7.1.2, "Setting Page Creation Defaults for Business Role Pages."

38.1.1.1 Accessing Page Creation Default Settings

In a Home Space, page creation default settings are available to authorized users from the Personalize Pages page (Figure 38-1).

Figure 38-1 Set Page Defaults on Personalize Pages

The person who designs the template that is used for pages in the Home Space determines if access to this page or dialog is easily available. The designer may select a default, out-of-the-box template that provides easy access to the Personalize Pages page via an Actions menu, for example Figure 38-2.

Figure 38-2 Personalize Pages Option on Actions Menu

Additionally, the designer may create a custom page template and include the Manage Pages component. Authorized users can access the Manage Pages dialog by clicking this component (Figure 38-3).

Figure 38-3 Manage Pages Link and Dialog

38.1.1.2 Setting Personal Page Creation Defaults

To set personal page creation defaults:

1. Go to the Home Space.

You can use the following URL to go to the Home Space:

http://host:port/webcenter/spaces/home

2. Open the Personalize Pages page (Figure 38-4).

Figure 38-4 Set Page Defaults on Personalize Pages

See Also:

For methods of accessing Personalize Pages or Manage Pages, see Section 38.1.1.1, "Accessing Page Creation Default Settings."

3. Click Set Page Defaults to open the Set Page Defaults dialog (Figure 38-5).

Figure 38-5 Set Page Defaults Dialog

4. To set page creation defaults:

1. Select a layout from the Style dropdown list.

See Also:

For examples of seeded page styles, see Table 15-2, "Default Page Styles". Note, however, that your application administrator may provide additional custom page styles or restrict page styles to a shorter list.

2. Select an option next to Enable One-Click Page Creation:

Yes—When you create personal pages in the Home Space, skip the Create Page dialog, and create the page using the default page style you set here.

No—When you create personal pages in the Home Space, have the default page style you set here preselected in the Create Page dialog.

5. Click Save to save your changes and exit the dialog.

Going forward, when you create personal pages in the Home Space, the default page style you set here determines the style that is preselected for the new page and whether the Create Page dialog opens.

38.1.2 Creating a Personal Page in the Home Space

Depending on how your portal navigation is implemented, in the Home Space you can find the Create Page command on the Personalize Pages page and through the Manage Pages dialog (Figure 38-6).

Figure 38-6 Create Page Option on Personalize Pages Page

Tip:

There is a Create Page user interface component that your portal designers can add to page templates. So another way to initiate the creation of a page is to click this control if it is provided. For more information, see Section 13.2.9, "Create Page."

This section describes both methods for creating personal pages in your own view of the Home Space.

To create a personal page in the Home Space:

1. Go to the Home Space.

You can use the following URL to go to the Home Space:

http://host:port/webcenter/spaces/home

2. Open the Personalize Pages page and click Create Page to open the Create Page dialog (Figure 38-7).

Figure 38-7 Create Page Dialog

If you (or the application administrator) set page creation defaults to one-click page creation, then, after this step, the new page is created and opened. If you did not select one-click page creation, continue with the next step.

See Also:

For more information, see Section 38.1.1, "Setting Page Creation Defaults for Personal Pages."

The application administrator can set an attribute on a custom page style that determines whether a newly created page that is based on that style opens in page edit mode or page view mode. For more information, see Section 15.4.2, "Setting Properties on a Custom Page Style."

3. In the Page Name field, enter a display name for the new page.

4. Select a page style to define the page structure.

See Also:

For examples of seeded page styles, see Table 15-2, "Default Page Styles". Note, however, that your application administrator may provide additional custom page styles or restrict page styles to a shorter list.

5. Click the Create button.

The new page opens in Oracle Composer, the WebCenter page editor, ready for adding content (Figure 38-8).

Figure 38-8 A New Page

For information about editing personal pages in the Home Space, see Section 38.3, "Editing a Personal Page." For information about working with the page layout, look, and feel, see Section 29.4, "Adjusting Your Page View."

38.2 Controlling User Access to Your Personal Pages

By default, the personal pages you create in the Home Space are accessible to you and no one else (except your application administrator). You can use page access settings to enable other users to view and work with your personal pages and to remove that access. Page access settings are available through the Set Page Access dialog, which you can open from the Manage Pages dialog and the Personalize Pages page (Figure 38-9).

Figure 38-9 Set Page Access Option on Actions Menu on Personalize Pages Page

When you grant access to one of your personal pages to another user, the other user must deliberately show the page in his or her view. The user must take this step for each session because shared pages are not automatically shown on login.

See Also:

For information about how to show a hidden page, see Section 29.3.4, "Showing Hidden Pages."

This section provides information about setting and revoking user access to your personal pages. It includes the following subsections:

- Section 38.2.1, "Granting User Access to Your Personal Pages"

- Section 38.2.2, "Revoking User Access to a Personal Page"

38.2.1 Granting User Access to Your Personal Pages

When you share one of your personal pages with other users, the shared page appears in those users' views of the Manage Pages dialog or the Personalize Pages page in the Home Space. They can use the Show Page control in Manage Pages or Personalize Pages to show the shared page in their own views of the Home Space (for more information, see Section 29.3.4, "Showing Hidden Pages").

To enable other users to access one of your personal pages:

1. Go to the personal page you want to share.

You can navigate to a personal page in the Home Space using the following URL:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Open the Manage Pages dialog or the Personalize Pages page, and, from the page's Actions menu, select Set Page Access (Figure 38-10).

Figure 38-10 Set Page Access Option on Actions Menu on Personalize Pages Page

See Also:

For methods of accessing Manage Pages or Personalize Pages, see Section 38.1.1.1, "Accessing Page Creation Default Settings."

3. To grant page access permissions to all authenticated users, that is, to users who are logged in to WebCenter Spaces, click Add Authenticated Access.

The role authenticated-role is added under Role or User.

4. To grant page access permissions to all public users, that is, users who have not logged in to WebCenter Spaces, click Add Public Access.

The role anonymous-role is added under Role or User.

5. To grant page access permissions to selected users, groups, and application roles, click the Add Access button to open the Add Access dialog (Figure 38-11).

Figure 38-11 The Add Access Dialog

6. In the Search field, enter a search term or the name of the user, group, or role for whom you want to enable access, and click the Search icon.

Tip:

Search terms must contain at least two characters.

7. Select a user, group, or role by clicking in its row.

Note:

When you select a user name, the permissions you set are granted to that specific user. When you select a group or application role, the permissions you set are granted to all users who are members of that group or who are assigned that role.

To make multiple selections:

- Ctrl-Click to select multiple rows.

- Shift-Click to select a range of rows.

8. Click the Select button.

The Add Access dialog closes, and the Set Page Access dialog populates with the selected users (Figure 38-12).

Figure 38-12 Set Page Access Dialog

9. Repeat the previous steps to add all the users and roles of interest to the Set Page Access dialog.

10. For each user, group, or role, grant access by selecting one or more access privileges from the Page Access columns (Table 38-1).

Table 38-1 Page Access Privileges in the Set Page Access Dialog

Icon

Name

Description

View Page

Users can access the page for viewing, but cannot perform any other actions on the page.

Edit Page

Users can edit the page using Oracle Composer. This includes adding, rearranging, and deleting content; renaming the page; and changing page properties, such as the page scheme.

Delete Page

Users can delete the page.

Perform All Page Actions

Users can perform all actions on the page.

Personalize Page

Users can rearrange page content and personalize his or her view of task flows, provided the task flow includes personalization settings.

Tip:

By default, all authenticated users and user roles that you add to the Set Page Access dialog are granted View Page access. All users for whom you are granting privileges must have View Page access.

11. Click OK to save your changes and close the Set Page Access dialog.

38.2.2 Revoking User Access to a Personal Page

To revoke user access to a personal page:

1. Go to the personal page from which to revoke user access.

You can navigate to a personal page in the Home Space using the following URL:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Open the Manage Pages dialog or the Personalize Pages page, and, from the page's Actions menu, select Set Page Access (Figure 38-13).

Figure 38-13 Set Page Access Option on Actions Menu on Personalize Pages Page

See Also:

For methods of accessing Manage Pages or Personalize Pages, see Section 38.1.1.1, "Accessing Page Creation Default Settings."

3. Select the user or role from which to revoke page access, and click Delete Access (Figure 38-14).

Figure 38-14 Delete Access Button

4. Click Delete in the resulting confirmation dialog.

38.3 Editing a Personal Page

When you edit a personal page, provided you are granted sufficient permissions, you can add or remove content, set properties on content and on the page itself, and perform additional customizations that affect the view of everyone who has access to the page.

Depending on how your portal is designed, you can enter page edit mode from a page Actions menu, an Actions menu next to a page in the Manage Pages dialog or Personalize Pages page, or by pressing Ctrl-Shift-E.

Additionally, your page designer may provide an Edit Page link on the template you use to create the page.

To edit a personal page:

1. Go to the Home Space page you want to edit.

You can navigate to a personal page in the Home Space using the following URL:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Using one of the methods described at the beginning of this section, open the page in edit mode.

3. Edit the page.

See Also:

For information about adding content to the page, see Section 17.5, "Adding Resource Catalog Components to Pages.".

4. Click Save to save your changes.

5. Click Close to exit page edit mode.

38.4 Copying a Personal Page

When you copy a page, all content from the original page is also copied. The copy opens in page edit mode (Oracle Composer) so that you can start immediately making the adjustments you planned for the copy.

Note that a copy does not also include the original page's access settings. You must set access on the copy as if it were a new page (for more information, see Section 38.2, "Controlling User Access to Your Personal Pages").

Depending on your portal design, you can initiate a page copy from the Actions menu next to a page in the Manage Pages dialog on the Personalize Pages Page (Figure 38-15)

Figure 38-15 Copy Page Option on Actions Menu

To copy a personal page:

1. Go to the personal page you want to copy.

You can navigate to a personal page in the Home Space using the following URL:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Open the Manage Pages dialog or the Personalize Pages page, and then select Copy Page from the page's Actions menu (see Figure 38-15).

See Also:

For methods of accessing the Manage Pages dialog or Personalize Pages page, see Section 38.1.1.1, "Accessing Page Creation Default Settings."

3. In the Copy Page dialog, enter a name for the copy in the Page Name field (Figure 38-16).

Figure 38-16 Copy Page Dialog

4. Click OK.

The copied page opens in page edit mode (Oracle Composer).

5. Make the adjustments you planned for the copy (you can always edit the copy at another time).

6. Click Save to save your changes.

7. Click Close to exit Oracle Composer.

38.5 Deleting a Personal Page

Depending on your portal design, you can delete a personal page from the Actions menu next to a page in the Manage Pages dialog or the Personalize Pages page (Figure 38-17).

Figure 38-17 Delete Page Option on Actions Menu

To delete a personal page:

1. Go to the Home Space.

You can navigate to a personal page in the Home Space using the following URL:

http://host:port/webcenter/spaces/page/escapedPageDisplayName

Tip:

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

2. Open the Manage Pages dialog or the Personalize Pages page.

See Also:

For methods of accessing Manage Pages or Personalize Pages, see Section 38.1.1.1, "Accessing Page Creation Default Settings."

3. Select Delete Page from the page's Actions menu (see Figure 38-17).

4. Click Delete in the confirmation dialog.

Part X

Working with Content

Part X of the User's Guide provides information about the various content management features readily available in WebCenter Spaces.

Part X includes the following chapters:

- Chapter 39, "Introduction to Adding and Managing Content"

- Chapter 40, "Publishing Content Using Content Presenter"

- Chapter 41, "Working with the Documents Service Task Flows and Document Components"

- Chapter 42, "Setting Documents Service Task Flow and Document Component Properties"

- Chapter 43, "Working with Workflow-Enabled Content"

- Chapter 44, "Creating and Managing Content at Runtime"

- Chapter 45, "Collaborating on Documents"

- Chapter 46, "Working with Microsoft Office and Explorer Integration"

- Chapter 47, "Working with Wiki Documents"

- Chapter 48, "Working with Blogs"

39 Introduction to Adding and Managing Content

See Also:

For an overview of content management in WebCenter Spaces, see Section 2, "Leveraging Content Management."

In a WebCenter Spaces application, you can add content from one or more connected content repositories to the application in a variety of ways. You can use the Content Presenter task flow to precisely customize the selection and presentation of content, or you can use a Documents service task flow that suits your purposes for presenting content management functionality. You can also add individual folders and files to a page using links, images, or previews.

This chapter introduces the functionality available to add and manage content in a WebCenter Spaces application in the following sections:

- Section 39.1, "What You Should Know About Adding and Managing Content"

- Section 39.2, "What You Should Know About Content Management Selections in the Resource Catalog"

Audience

This chapter is intended for WebCenter Spaces users who want to learn about the functionality available in WebCenter Spaces to add and manage content using Content Presenter and the Documents service.

39.1 What You Should Know About Adding and Managing Content

WebCenter Spaces provides the following types of containers in which to display and manage content:

- Content Presenter. Enables you to precisely customize the selection and presentation of content in a WebCenter Spaces application. The Content Presenter task flow is available only when the connected content repository is Oracle Content Server and your WebCenter Spaces administrator has completed the prerequisite configuration. With Content Presenter, you can select an Oracle Site Studio file, a single item of content, multiple content items, query for content, or select content based on the results of a WebCenter Personalization Conductor scenario, and then select a template to render the content on a page in a WebCenter Spaces application. Content Presenter has no dependency on the Documents service for adding or managing the content it displays.

Learn More:

For more information about Content Presenter, see Chapter 40, "Publishing Content Using Content Presenter."

- Documents service task flows. Provide a variety of formats to display one or more folders and files. You can choose the task flows appropriate for your application to provide features for accessing, adding, and managing folders and files; configuring file and folder properties; and searching file and folder content. The Documents service task flows are available when the connected content repository is Oracle Content Server, Oracle Portal, or SharePoint, and your WebCenter Spaces administrator has completed the prerequisite configuration. If the content repository is Oracle Content Server, you can use both the Documents service task flows and the Content Presenter task flow to add and preview Oracle Site Studio files.

Learn More:

For information about the Documents Service task flows available in WebCenter Spaces, and the unique characteristics of each task flow, see Section 41.1, "What You Should Know About the Documents Service Task Flows."

- Document components. Display an individual file on a page as a linked document, an inline preview, or an image.

Learn More:

For information about document components you can add to a page in a WebCenter Spaces application, see Section 41.2, "What You Should Know About Document Components."

- Wikis. Add wiki documents for end users to collaborate to create content that is relevant, useful, and up-to-date.

Learn More:

For information about including wikis in a WebCenter Spaces application, see Chapter 47, "Working with Wiki Documents."

- Blogs. Add blogs for end users to add, edit, and manage blog posts.

Learn More:

For information about including blogs in a WebCenter Spaces application, see Chapter 48, "Working with Blogs"

39.2 What You Should Know About Content Management Selections in the Resource Catalog

WebCenter Spaces users with permissions to edit pages use the Oracle Composer Resource Catalog to add content to a page.

Note:

The presence or location of the content selections in the Resource Catalog depends on how the Resource Catalog is configured. In the default Oracle Composer Resource Catalog, the Content Management section includes the content task flows and document components, as shown in Figure 39-1 and Table 39-1.

Figure 39-1 Resource Catalog in WebCenter Spaces: Content Management Section (when editing a Space page)

Table 39-1 describes the selections available in the Content Management section of the default Oracle Composer Resource Catalog:

Table 39-1 Content Management Selections in the Default Oracle Composer Resource Catalog

Item

Task Flow?

Description and Use

All Content

No

A virtual node that exposes a list of all folders and files to which you have access. Click Open to drill down, or enter a file name in the Search field. When you reach the target folder or file, click Add to display a menu where you can choose how to display the folder or file. See Section 41.3, "Adding a Selected Folder or File to a Page."

Content Presenter

Yes

Available only when the content repository is Oracle Content Server. Displays the selected folders or files in a predefined template. See Chapter 40, "Publishing Content Using Content Presenter."

Document Explorer

Yes

Displays folders and files in two panes, combining the functionality of the Document Navigator and Folder Viewer task flows. Provides in-place previewing and editing, and robust management capabilities. See Section 41.1.1, "Understanding the Document Explorer Task Flow."

Document List Viewer

Yes

Displays folders and files in a single pane as a flat listing. Provides preview and editing in a separate window, and some management capabilities. See Section 41.1.2, "Understanding the Document List Viewer Task Flow."

Document Manager

Yes

Shown in the default Resource Catalog only if it has been added by the WebCenter Spaces administrator. Displays folders and files as specified by its Layout property: Explorer, Table, or Tree Table. See Section 41.1.3, "Understanding the Document Manager Task Flow."

Document Navigator

Yes

Shown in the default Resource Catalog only if it has been added by the WebCenter Spaces administrator. Displays a simple listing of folders and files in a single pane, providing expand/collapse on folders to show the full hierarchy. There are no menu options available for this task flow. See Section 41.1.4, "Understanding the Document Navigator Task Flow."

Folder Viewer

Yes

Displays the contents of a folder in a single pane as a flat listing, providing in-place preview and editing, and robust management capabilities. See Section 41.1.5, "Understanding the Folder Viewer Task Flow."

Space Documents

Personal Documents

No

A shortcut that exposes a list of folders and files associated with the current Space or your personal documents in the Home Space. Click Open to drill down, or enter a file name in the Search field. When you reach the target folder or file, click Add to display a menu where you can choose how to display the folder or file. See Section 41.3, "Adding a Selected Folder or File to a Page."

40 Publishing Content Using Content Presenter

In a WebCenter Spaces application, you can add content from one or more connected content repositories to the application, as described in Chapter 39, "Introduction to Adding and Managing Content."

This chapter describes how to publish content on a page in a WebCenter Spaces application using the Content Presenter task flow:

- Section 40.1, "What You Should Know About the Content Presenter Task Flow"

- Section 40.2, "Adding a Content Presenter Task Flow to a Page"

- Section 40.3, "Displaying the Content Presenter Configuration Dialog"

- Section 40.4, "Selecting Content"

- Section 40.5, "Selecting a Display Template"

- Section 40.6, "Previewing the Results"

- Section 40.7, "Adding Links from Content to Navigation Nodes"

- Section 40.8, "Authoring Site Studio Content to Optimize Presentation in Content Presenter"

- Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog"

- Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow"

- Section 40.11, "Setting Content Presenter Task Flow Properties"

Audience

This chapter is intended for WebCenter Spaces users assigned, minimally, the Pages-Edit Pages permission who want to add content in a Content Presenter task flow to a page in a WebCenter Spaces application.

40.1 What You Should Know About the Content Presenter Task Flow

Content Presenter enables you to precisely customize the selection and presentation of content in a WebCenter Spaces application. The Content Presenter task flow is available only when the connected content repository is Oracle Content Server and your WebCenter Spaces administrator has completed the prerequisite configuration.

See Also:

For more information, see:

- "Oracle Content Server Prerequisites" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter

- "How to Create a Content Repository Connection Based on the Oracle Content Server Adapter" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter

With Content Presenter, you can select a single item of content, multiple content items, query for content, or select content based on the results of a WebCenter Personalization Conductor scenario, and then select a template to render the content on a page in a WebCenter Spaces application.

Note:

Oracle Content Server exposes a content item only after it has a revision status of Released. If content item does not have Released status, you will not be able to configure Content Presenter to show the item. You can find the status of a content item in Oracle Content Server on the Content Information Page, as described in "Determining the Revision Status" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

In addition to displaying the folders and files in an Oracle Content Server repository, Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."

Content Presenter has no dependency on the Documents service for adding or managing the content it displays.

40.1.1 Understanding Site Studio Integration

Oracle Site Studio is a powerful, flexible web development application suite that offers a comprehensive approach to designing, building, and maintaining enterprise-scale web sites. Site Studio uses Oracle Content Server as the main repository for a web site.

Site Studio region templates are defined in Site Studio Designer or JDeveloper. They define the layout and look-and-feel of the data in contribution regions within web pages. They are partial HTML files in that they do not have a head and body section. At runtime, the Site Studio contributor data file (an Oracle Content Server document) is merged with the Site Studio region template to create the HTML fragment. This allows Site Studio region templates to be inserted into other HTML code as the web pages are generated for the Site Studio site.

Content Presenter integrates with Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template.

Note:

Oracle Site Studio files can also be included in the Folder Viewer, Document Explorer, and Document Manager task flows, and previewed using the Document Viewer. See Section 41.1.7, "Understanding the Document Viewer Task Flow."

Before you can display Site Studio contributor data files in Content Presenter, the WebCenter application administrator must complete the followings tasks, described in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter:

- Enable Site Studio components (SiteStudio, SiteStudioExternalApplications, as described in "Configuring Oracle Content Server 11g for All WebCenter Applications."

- Disable or hide Site Asset categories that are not needed for typical Content Presenter implementations, as described in "Disabling Undesirable Site Asset Categories in Oracle Site Studio."

- Enable the WebCenterConfigure component to allow for adding and editing Site Studio documents from within Content Presenter, as described in "What You Should Know About the WebCenterConfigure Component."

For proper surfacing in Content Presenter, the following link types can be used in both Site Studio region templates, as well as in a Site Studio contributor data file:

- Links to nodes in the default navigation model, as described in Section 40.7, "Adding Links from Content to Navigation Nodes."

- Links to inlined images.

- Links to documents (except for absolute or relative path links). When clicking the link at runtime, it renders within the context of the application and display the document using the Default View display template.

- Links to Site Studio sections when editing a WYSIWYG field in contribution mode and creating a server-side link.

- Absolute HTTP links, whether created in Site Studio contributor mode or in Site Studio Designer region template HTML.

The following Site Studio link types are not supported in Content Presenter:

- Links to Site Studio sections, except for the server-side link case listed above.

- Absolute or relative path links to Site Studio documents.

For guidelines on authoring recommendations for displaying a Site Studio contributor data file in Content Presenter, see Section 40.8, "Authoring Site Studio Content to Optimize Presentation in Content Presenter."

You can create and edit Site Studio contributor data files from the Content Presenter Configuration dialog (see Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog") or in-context when displayed in Content Presenter at runtime (see Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow").

For more information about creating and using Site Studio contributor data files and Site Studio region templates, refer to the Oracle Site Studio documentation library.

40.2 Adding a Content Presenter Task Flow to a Page

To add a Content Presenter task flow to a page:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that provides access to the folders and files in the connected content repository.

Tip:

The presence or location of this section depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, next to Content Management, click Open to expose the content selections (Figure 40-1).

Figure 40-1 Opening the Content Management Section in the Resource Catalog

For information about the selections shown in the default Resource Catalog, see Section 39.2, "What You Should Know About Content Management Selections in the Resource Catalog."

4. Add the Content Presenter task flow to the page in one of two ways:

- Next to Content Presenter, click Add (Figure 40-2).

Figure 40-2 Adding a Content Presenter Task Flow to a Page

A new empty region appears on your page (Figure 40-3).

Figure 40-3 Adding a Content Presenter Task Flow to a Page

- Or, drill down in the Resource Catalog to the folder or file you want to display on the page: In the default Resource Catalog, next to All Content (or, in WebCenter Spaces, Space Documents or Personal Documents), click Open until you locate the target content, then click Add, and choose Content Presenter from the menu (Figure 40-4).

Note:

Oracle Content Server exposes a content item only after it has a revision status of Released. If content item does not have Released status, you will not be able to configure Content Presenter to show the item. You can find the status of a content item in Oracle Content Server on the Content Information Page, as described in "Determining the Revision Status" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

Figure 40-4 Adding Content to a Content Presenter Task Flow

The selected folder or file displays in a default display template, as shown in Figure 40-5 and Figure 40-6.

:

Figure 40-5 Content Presenter Task Flow: Default Template for Word Document

Figure 40-6 Content Presenter Task Flow: Default Template for Image File

40.3 Displaying the Content Presenter Configuration Dialog

The Content Presenter Configuration dialog enables you to easily configure the Content Presenter task flow to select or change content, or choose a different display template.

Note:

You can also specify content and a display template by clicking the properties Edit icon (the second wrench icon in the task flow chrome) and specifying parameters on the Parameters tab of the Component Properties dialog. However, specifying parameters in this way is generally intended for use at design time by developers creating a WebCenter Portal application, or for advanced users who want to bind a parameter to an EL expression. If you modify a property value in the Component Properties dialog, the new value overrides the value specified in the Content Presenter Configuration dialog, and that value cannot subsequently be changed through the Content Presenter Configuration dialog. For information about Content Presenter task flow parameters, see Section 40.11, "Setting Content Presenter Task Flow Properties."

To display the Content Presenter Configuration dialog:

1. In the Content Presenter task flow (see Section 40.2, "Adding a Content Presenter Task Flow to a Page"), click the task flow Edit icon (the first wrench icon in the task flow chrome) (Figure 40-7).

Figure 40-7 Editing a Content Presenter Task Flow

The Content Presenter Configuration dialog opens (Figure 40-8).

Figure 40-8 Content Presenter Configuration Dialog

A green check mark alongside an item indicates that the required information is complete and valid.

40.4 Selecting Content

Note:

Content Presenter does not support non-ASCII characters in files that are encoded using the non-UTF-8 character encoding. When users preview such files in Content Presenter, non-ASCII characters appear garbled.

Depending on the type of content you want to display, follow the steps in one of the following sections:

- Section 40.4.1, "Selecting a Single Content Item"

- Section 40.4.2, "Selecting the Contents of a Folder"

- Section 40.4.3, "Selecting Content Based on the Results of a Query"

- Section 40.4.4, "Selecting a List of Content Items"

- Section 40.4.5, "Selecting Content Based on the Results of a Scenario"

40.4.1 Selecting a Single Content Item

To select a specific item (including a Site Studio contributor data file) to display in a Content Presenter display template or Oracle Site Studio region template (see Section 40.1.1, "Understanding Site Studio Integration"):

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.

2. On the Content page, expand the Content Source list, and select Single Content Item (Figure 40-9).

Figure 40-9 Selecting the Content Source: Single Content Item

3. Click Browse to locate the content item.

Note:

Oracle Content Server exposes a content item only after it has a revision status of Released. The revision status of a new content item changes from Done to Released after it has reached its specified release date (specified by the dInDate property). Content items that do not have Released status will not appear in the Browse list. You can find the status of a content item in Oracle Content Server on the Content Information Page, as described in "Determining the Revision Status" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

If the WebCenter Spaces application is connected to multiple Oracle Content Server repositories, the browse tree shows the parent folder for the current user, or for the current Space, in the repository that is specified as the primary connection. To access other connected repositories, click the navigation icon in the toolbar to expose the VCR parent node (Figure 40-10). Click VCR to show all connected content repositories.

Figure 40-10 Navigating to Other Content Repositories

Note:

If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reports Unable to retrieve content type information.

40.4.2 Selecting the Contents of a Folder

To select a folder to display its contents on a page (in the order stored in the folder) in a Content Presenter display template:

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.

2. On the Content page, expand the Content Source list, and select Contents Under a Folder (Figure 40-11).

Figure 40-11 Selecting the Content Source: Contents Under a Folder

3. Click Browse to locate the folder.

If the WebCenter Spaces application is connected to multiple Oracle Content Server repositories, the browse tree shows the parent folder for the current user, or for the current Space, in the repository that is specified as the primary connection. To access other connected repositories, click the Show Hierarchy navigation icon to the left of the repository name to expose the VCR parent node. Click VCR to show all connected content repositories.

Note:

If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reports Unable to retrieve content type information.

40.4.3 Selecting Content Based on the Results of a Query

To enter query criteria to refine the selection of the content to display in a Content Presenter display template:

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.

2. On the Content page, expand the Content Source list, and select Results of a Query (Figure 40-12).

Figure 40-12 Selecting the Content Source: Results of a Query

3. In the Results of a Query pane (Figure 40-13), enter desired values in the fields that you want the query to retrieve, as described in Table 40-1.

Figure 40-13 Results of a Query Pane

Table 40-1 Specifying Query Criteria for Results of a Query

Element

Description

File Name

Enter the name of a file that you want to display in the selected template. To retrieve multiple content items, use * as a wild card character. For example, a value of *.jpg retrieves all JPEG image files in the specified Repository.

Keywords

Enter any value that may be present in the content of the documents. The value may be one or more words or phrases. Keyword search requires full-text search to be configured in Oracle Content Server.

Content Type

Choose All Content Types to retrieve content items regardless of the content type. Or, choose the name of a content type profile or Site Studio region template definition (see Section 40.1.1, "Understanding Site Studio Integration") defined in Oracle Content Server. A content type profile specifies properties that define a specific type of content (for example, a press release, or a news flash, or an image). The content type IDC:GlobalProfile is the name of a default content type profile defined in Oracle Content Server that can be applied if no other content type profiles are defined.

Limit Results

Specify the maximum number of content items to be returned by the query.

Add Fields

Choose from the list any of the following to display additional fields to narrow the query:

- Dates: Adds a Dates section to the Content page. Enter a date to find content item(s) that match the creation or last modified date.You can modify the dates search criteria by selecting a modifier to search for an exact date (is), a following date (is after), a preceding date (is before), or a date between two other dates (is between), which adds an additional date field for entering the second date.

- Users: Adds a Users section to the Content page. Enter a user name to find content item(s) that user created or last modified.

- Filters: Not applicable when Content Type is set to All Content Types. For a selected content type profile (prefixed IDC:), adds an Additional Query Filters section to the Content page. Click the Add icon to list all the properties that are defined for the selected content type profile. Select one or more properties to refine the query to find content items with specific property settings.

- Sorting: Not applicable when Content Type is set to All Content Types. For a selected content type profile (prefixed IDC:), adds a Sort Order section to the Content page. Specify a sort order for the properties shown in the Sort On list.

4. Click Preview Results to see the results of the query.

Note:

If the content repository includes an invalid type configuration, then no content displays when you click Preview Results. Instead, an error message reports Unable to retrieve content type information.

40.4.4 Selecting a List of Content Items

Content Presenter allows you to create a list of multiple content items. The order you use when creating the list is the order in which they are presented at runtime.

To browse or search for any number of items to add to a list, and delete or reorder the items before adding the list to a page in a Content Presenter display template:

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.

2. On the Content page, expand the Content Source list, and select List of Items (Figure 40-9).

Figure 40-14 Selecting the Content Source: List of Items

3. In the Select Items to Display pane (Figure 40-15), click Add to browse or search for any number of items to add to a list.

Figure 40-15 Selecting Items to Display

If your WebCenter Spaces application is connected to multiple Oracle Content Server repositories, the browse tree shows the parent folder for the current user, or for the current Space, in the repository that is specified as the primary connection. To access other connected repositories, click the Show Hierarchy navigation icon to the left of the repository name to expose the VCR parent node. Click VCR to show all connected content repositories.

Note:

If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reports Unable to retrieve content type information.

40.4.5 Selecting Content Based on the Results of a Scenario

If your WebCenter Spaces application is configured to run WebCenter Personalization scenarios using Content Presenter, you can select content based on the results of a WebCenter Personalization Conductor scenario. For more information, see "Personalizing WebCenter Applications" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter and "Configuring Content Presenter" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To enter Conductor scenario criteria to refine the selection of the content to display in a Content Presenter display template:

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.

2. On the Content page, expand the Content Source list, and select Results of a Scenario (Figure 40-16).

Figure 40-16 Selecting the Content Source: Results of a Scenario

3. In the Results of a Scenario pane, review the list of scenarios that have been tagged for Content Presenter consumption, select those for which you want to generate results, and enter required parameter (Figure 40-17).

Figure 40-17 Results of a Scenario Pane

4. Click Preview Results to see the results of the selected scenarios.

Note:

If the content repository includes an invalid type configuration, then no content displays when you click Preview Results. Instead, an error message reports Unable to retrieve content type information.

Any results that are returned from a scenario for use by Content Presenter must return a valid CMIS query, as Content Presenter takes the return value and runs it (as a CMIS query) against the repository specified within the Conductor URL. For information about how to format the query and examples, see Oracle Fusion Middleware Content Management REST Service Developer's Guide.

40.5 Selecting a Display Template

The display template for the content you have selected on the Content page of the Content Presenter Configuration dialog may be one of the out-of-the-box templates provided with WebCenter Spaces (see Table 40-2 and Table 40-3), a custom template designed for your organization in JDeveloper, or a Site Studio region template (see Section 40.1.1, "Understanding Site Studio Integration").

For information about creating and uploading custom display templates, see "Creating Custom Content Presenter Display Templates" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter. For information about creating and using Site Studio region templates, refer to the Oracle Site Studio documentation library.

By default, WebCenter Spaces selects an appropriate display template based on the type of content selected. You can change the default template as required.

The WebCenter Spaces administrator can show, hide, and manage the custom display templates on the Resources page of the application administration settings. For more information, see Section 10.4, "Managing Resources."

To change the display template for the selected content:

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Template or the Template tab.

The templates that are available for selection in the Template list are those that are identified by Content Presenter as suitable for displaying the selected content item(s). For more information, see "Identifying Display Templates for Selected Content Items" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

2. On the Template page:

- If the Content Source selected on the Content page is a Site Studio contributor data file or any other single content item, select a Site Studio region template or a Content Presenter display template, respectively, from the Template list.

The list of available Site Studio region templates includes only the templates that match the region definition of the Site Studio contributor data file selected on the Content page. To identify the Site Studio region templates, hover your mouse pointer over the templates in the list to display hint text identifying the Site Studio region templates. For more information, see Section 40.1.1, "Understanding Site Studio Integration."

The Content Presenter display templates in the list include the out-of-the-box templates for single content items (see Table 40-2). Other selections that may be available in the list are custom display templates that the application administrator has uploaded to your WebCenter Spaces application. For more information, see the "Creating Content Presenter Display Templates" chapter in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Figure 40-18 shows the Template list, with a Site Studio region template named PressReleaseFullDisplay selected.

Figure 40-18 Selecting the Custom Display Template

- If the Content Source selected on the Content page is a multiple content item (Contents Under a Folder, Results of a Query, or List of Items), select the desired Template Category (Figure 40-19), then the Template (Figure 40-20).

Figure 40-19 Selecting the Template Category (for Multiple Content Items)

Figure 40-20 Selecting the Display Template (for Multiple Content Items)

By default, there is only one category: Default Templates. This selection defines the collection of out-of-the-box templates available for multiple content items (see Table 40-3).

Other selections that may be available are custom template categories and display templates that the application administrator has uploaded to your WebCenter Spaces application. For more information, see the "Creating Content Presenter Display Templates" chapter in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Table 40-2 Out-of-the-Box Templates for Displaying Single Content Items

Single Content Item Templates

View ID

Description

Default Document Details View

oracle.webcenter.content.templates.default.document.details

Displays detailed information about any single content item including creation date, modification date, created by username, modified by username, path, and any comments.

Default List Item View

oracle.webcenter.content.templates.default.list.item

Used by multiple content item views to display each individual item. Displays a single line with an icon and item name as a link that either displays or downloads the item when clicked.

Default View

(default when no template is selected)

oracle.webcenter.content.templates.default.detail

Displays any single content item, either directly in the browser (images, HTML, text) or as a link that downloads the associated file when clicked.

For example, when the selected document type is .doc, the Default View template is assigned to be the Default Document Details View template.

Table 40-3 Out-of-the-Box Templates for Displaying Multiple Content Items

Multiple Content Item Templates

View ID

Description

Accordion View

oracle.webcenter.content.templates.default.list.panel.accordion

Displays multiple content items in an accordion format, where each item can be expanded to display its details.

Bulleted View

oracle.webcenter.content.templates.default.list.bulleted

Displays multiple content items in a bulleted list format. Only content items display; folder items are omitted.

Bulleted with Folder Label View

oracle.webcenter.content.templates.default.list.bulleted.label

Displays multiple content items in a bulleted list format. The name of the folder containing the first item in the list displays as a label above the list. This template is intended to be used with Content Source set to Contents Under a Folder to ensure that all items have the same parent folder. Only content items display; folder items are omitted.

Carousel View

oracle.webcenter.content.templates.default.list.carousel

Displays multiple content items in a carousel format, where items can be browsed by moving a slider left or right.

Icon View

oracle.webcenter.content.templates.default.list.tile

Displays multiple content items in a tiled format with large icons and file names.

List View

(default when no template is selected)

oracle.webcenter.content.templates.default.list.simple

Displays multiple content items in a simple list.

List with Details Panel View

oracle.webcenter.content.templates.default.list.details.panel

Displays multiple content items in a list on the left, with a panel to the right displaying the details of a selected item.

Sortable Table View

oracle.webcenter.content.templates.default.list.tabular

Displays multiple content items in a sortable table that includes the document name, date created, and date modified.

Tabbed View

oracle.webcenter.content.templates.default.list.panel.tabbed

Displays multiple content items as tabs that can be selected to display item details.

40.6 Previewing the Results

To see a preview of your selected content before adding it to the page:

- Click Preview or the Preview tab.

The appearance of the content on the Preview page is dependent on whether the selected display template uses a stretch or flow layout. While the final view of the task flow can be configured to use either a stretch layout or a flow layout, the Preview page only uses a flow layout. As a result, the preview of content using templates that were designed for a stretch layout displays unstretched at a fixed default size. This is the normal behavior of stretchable content when displayed in non-stretching flow layout. To allow stretchable content to stretch to its full size and fill the task flow space entirely, click the Edit icon for the task flow to display the Component Properties dialog, and select the Stretch Content property (on the Display Options tab). For more information, see Section 17.5.2.5, "Working with Component Display Options."

Note:

Content Presenter does not support non-ASCII characters in files that are encoded using the non-UTF-8 character encoding. When users preview such files in Content Presenter, non-ASCII characters appear garbled.

From the Preview tab, you can click Edit Web Content to edit HTML and Site Studio files in-context, as described in Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow" (Figure 40-21).

Figure 40-21 Previewing an Oracle Site Studio Contributor Data File

40.7 Adding Links from Content to Navigation Nodes

When you expose content stored in Oracle Content Server in a Content Presenter task flow, consider whether or not you want add one or more links from the content to a node in the default navigation model (see Section 11.2.2.1.8, "Setting Display Options for Navigation Items").

When the content displays in Content Presenter at runtime, an end user can click the links to navigate to the desired navigation model node.

You can create a link in the following content items in Oracle Content Server:

- in a document of MIME type text/html (typically HTML files)

- in a Site Studio contributor data file (in a Rich Text element)

- in Site Studio region template

To add a link to a node in the default navigation model from a content item:

1. Edit the content item, as described in:

- Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog"

- Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow"

2. Add a link using the following syntax:

$wcUrl('externalId')

where externalId is the external identifier as configured in the WebCenter default navigation model.

For example:

<a target="" href="$wcUrl('NEWCUSTOMERSLINK')">New Customers</a>

40.8 Authoring Site Studio Content to Optimize Presentation in Content Presenter

Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."

To optimize the presentation of Oracle Site Studio content in Content Presenter, follow the guidelines provided in the following sections:

- Section 40.8.1, "Best Practices for Images"

- Section 40.8.2, "Best Practices for Defining Styles"

- Section 40.8.3, "Best Practices for JavaScript"

40.8.1 Best Practices for Images

Keep the following guidelines in mind as you work with images in Site Studio that will be displayed using Content Presenter:

- Store images in Oracle Content Server in a common location (filed).

- Insert images into WYSIWYG elements using the Site Studio Contributor image wizard.

- Set the image tag src attribute to a relative link to an image file in Oracle Content Server. This attribute is rewritten by Content Presenter during rendering to use the GET_FILE service.

- For performance improvement, use web proxy to cache artifacts at URLs from Oracle Content Server, and set expiration based on tolerance for updates in Oracle Content Server.

Example for Apache mod_cache:

- CacheEnable mem /cs

- CacheDefaultExpire 3600 (one hour)

40.8.2 Best Practices for Defining Styles

Keep the following guidelines in mind as you work with style definitions for Site Studio contributor data files that will be displayed using Content Presenter:

- Define styles in CSS files.

- Store CSS files either in Oracle Content Server or in your WebCenter portal application.

- If stored in Oracle Content Server, add <link> in <head> of page template.

- Load style class names into WYSIWYG region element definitions.

- Select your CSS to format HTML in WYSIWYG elements.

- For performance improvement, use web proxy to cache artifacts at URLs from Oracle Content Server, and set expiration based on tolerance for updates in Oracle Content Server.

Example for Apache mod_cache:

- CacheEnable mem /cs

- CacheDefaultExpire 3600 (one hour)

40.8.3 Best Practices for JavaScript

Keep the following guidelines in mind as you work with JavaScript in Site Studio contributor data files that will be displayed using Content Presenter:

- Recommended: Do not use JavaScript within web content that is rendered within WebCenter Portals.

- If your web content uses JavaScript, follow these guidelines:

- Add <link> in <head> of page template

- For performance improvement, use web proxy to cache artifacts at URLs from Oracle Content Server, and set expiration based on tolerance for updates in Oracle Content Server.

Example for Apache mod_cache:

- CacheEnable mem /cs

- CacheDefaultExpire 3600 (one hour)

40.9 Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog

Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."

Note:

To create or edit Oracle Site Studio content in a seamless interface within WebCenter Spaces, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Without this configuration, it is still possible to create or edit Site Studio content from within Content Presenter, but the create and edit actions launch new browser windows (or tabs) rather than opening within the Content Presenter task flow.

To create or edit Oracle Site Studio content from the Content Presenter Configuration dialog:

1. In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.

2. On the Content page, click Create Web Content (Figure 40-22).

Figure 40-22 Selecting the Content Source: Site Studio

Tip:

The Create Web Content button displays only when the Content Source field displays Single Content Item and when at least one Oracle Content Server repository (11g or higher) has the Site Studio component installed.

The Oracle Site Studio Choose Region Content pane opens (Figure 40-23).

Figure 40-23 Adding Site Studio Content: Choose Region Content

3. In the Choose Region Content pane, select a Site Studio region definition on which the content you want to create or edit is based.

4. Click Next.

The Choose content file pane opens (Figure 40-24).

Figure 40-24 Adding Site Studio Content: Choose Content File

5. In the Choose content file pane, select one of the following:

- New Contributor data file to open the Check-in Content pane (Figure 40-25), where you can specify the standard document properties for the new Site Studio contributor data file that you want to check in to Oracle Content Server.

Figure 40-25 Adding Site Studio Content: Check-in Content

- Existing file from server to open Oracle Content Server (Figure 40-26), showing Site Studio contributor data files that are based on the selected region definition.

Figure 40-26 Oracle Content Server: Search Results

6. Make note of the file name, then click Next.

The Check-in Confirmation pane opens (Figure 40-27).

Figure 40-27 Adding Site Studio Content: Check-in Confirmation

7. In the Check-in Confirmation pane, choose one of the following:

- Edit content item now to open the Site Studio Contributor editor, where you can edit the content item as described in Section 40.10.2, "Editing Site Studio Files In-Context" (beginning with Step 4).

- Exit without editing to make no changes to the file.

8. Click Finish to return to the Content Presenter Configuration dialog.

- If you access the WebCenter Spaces application through Oracle HTTP Server (OHS) and have configured the webContextRoot parameter, as described in the Note at the top of this section, the Site Studio contributor data file you selected is shown auto-selected in the Content Presenter Configuration dialog.

- If OHS and the webContextRoot parameter are not configured, you can now select the Site Studio contributor data file to display in the Content Presenter task flow: On the Content page, browse to the Site Studio file, select it, and click Select.

9. In the Content Presenter Configuration dialog, click Save.

40.10 Creating and Editing Files In-Context in a Content Presenter Task Flow

In-context editing refers to editing content directly in a WebCenter Spaces application at runtime, where the editor opens in a separate window.

With appropriate permissions, end users can edit HTML and Site Studio content in-context in a Content Presenter task flow.

Note:

Users must have permissions to view and edit the page containing the Content Presenter instance, as well as being assigned a role with write permissions on Oracle Content Server. For more information, see Chapter 20, "Understanding WebCenter Spaces Security" and the chapter "Managing WebCenter Portal Application Security" in Oracle Fusion Middleware System Administrator's Guide for Oracle Content Server.

The following sections describe how to perform in-context editing:

- Section 40.10.1, "Editing Wiki Documents or HTML Files In-Context"

- Section 40.10.2, "Editing Site Studio Files In-Context"

- Section 40.10.3, "Creating New Site Studio Content In-Context"

- Section 40.10.4, "Changing the Edit Mode Key Sequence"

40.10.1 Editing Wiki Documents or HTML Files In-Context

With appropriate permissions, end users can edit wiki documents or HTML files in-context in a Content Presenter task flow.

To edit a wiki or HTML file in a Content Presenter task flow:

1. In the Content Presenter task flow, click anywhere in the file content.

2. Press Ctrl-Shift-C to enter the in-context edit mode. The editable areas of the web page are highlighted with a dashed border.

Note that you can change the key sequence to enter in-context edit mode if you wish. See Section 40.10.4, "Changing the Edit Mode Key Sequence."

3. Click the Edit icon in the upper right corner of the document chrome (Figure 40-28) to open the file in the Document Viewer preview pane.

Figure 40-28 Entering In-Context Edit Mode In a Content Presenter Task Flow

4. In the Document Viewer preview pane, click the Edit action (Figure 40-29) to automatically check the file out and open it for editing in the Rich Text Editor (RTE).

See Also:

For information about the RTE, see Section 41.11, "Using the Rich Text Editor (RTE)."

Figure 40-29 Opening the Rich Text Editor

5. Make required updates, then save and close the file.

The modified file is automatically checked back in.

6. In the Content Presenter task flow in the WebCenter Spaces application, press Ctrl-Shift-C again to exit the in-context editing mode.

40.10.2 Editing Site Studio Files In-Context

Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."

With appropriate permissions, end users can edit Site Studio contributor data files in-context in a Content Presenter task flow.

To edit a Site Studio file in a Content Presenter task flow:

1. In the Content Presenter task flow, click anywhere in the Site Studio file content.

2. Press Ctrl-Shift-C to enter the in-context edit mode. The editable areas of the web page are highlighted with a dashed border.

Note that you can change the key sequence to enter in-context edit mode if you wish. See Section 40.10.4, "Changing the Edit Mode Key Sequence."

3. Click the Edit icon in the upper right corner of the document chrome (Figure 40-30) to open the file in Site Studio Contributor

Figure 40-30 Entering In-Context Edit Mode in a Content Presenter Task Flow

4. In the Site Studio Contributor Data File editor, click a region to edit, as shown in Figure 40-31.

For information about editing files in Site Studio Contributor, see the Oracle Site Studio documentation.

Figure 40-31 Editing a File in Site Studio Contributor

5. Click Save And Close to exit the Site Studio Contributor editor and return to the WebCenter Spaces application.

6. In the Content Presenter task flow in the WebCenter Spaces application, press Ctrl-Shift-C again to exit the in-context editing mode.

40.10.3 Creating New Site Studio Content In-Context

Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."

With appropriate permissions, end users can create new web content in Site Studio during in-context editing in a Content Presenter task flow.

In-context creation of Site Studio files is slightly different than creating Site Studio files in the Content Presenter Configuration dialog, as described in Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog." When creating a new Site Studio file in-context, you are limited to creating content that is of the same region definition, file location, security group, and document type as the content selected in the Content Presenter task flow.

To create a new Site Studio file in a Content Presenter task flow:

1. In the Content Presenter task flow, click anywhere in the currently displayed Site Studio file.

2. Press Ctrl-Shift-C to enter the in-context edit mode. The editable areas of the web page are highlighted with a dashed border.

Note that you can change the key sequence to enter in-context edit mode if you wish. See Section 40.10.4, "Changing the Edit Mode Key Sequence."

3. Click the Create icon in the upper right corner of the document chrome (Figure 40-32).

Figure 40-32 Selecting the Create Icon in a Site Studio File

4. In the Choose Content window, select New Contributor data file, then click Next (Figure 40-33).

Figure 40-33 Choose New Content File Window

5. Fill out the Check-in Content form. This form provides the metadata for the contributor data file and checks the file into Oracle Content Server. The file is empty until you (or another contributor) edits it. For more information on filling out this form, see "Checking in Files" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

6. In the Check-in Confirmation window, select Edit content item now.

7. Click Finish.

The Site Studio Contributor Data File editor opens (Figure 40-34).

Figure 40-34 Site Studio Contributor File Editor

8. Edit the file, then click Save and Close.

40.10.4 Changing the Edit Mode Key Sequence

To change the edit mode key sequence used to enter in-content editing mode for a Site Studio file in Content Presenter, edit the <key-sequence> entry in the application's adf-config.xml file:

******** Content Contributor Mode adf-config.xml entries ***************

<page-editor-config xmlns="http://xmlns.oracle.com/adf/pageeditor/config">
<mode-switch-key>
<enabled>true</enabled>
<key-sequence>ctrl e</key-sequence>
</mode-switch-key>
</page-editor-config>

40.11 Setting Content Presenter Task Flow Properties

The Content Presenter task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 40-35).

Figure 40-35 Content Presenter Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Content Presenter task flow and describe the properties on the Parameters tab:

- Section 40.11.1, "What You Should Know About the Content Presenter Task Flow Properties"

- Section 40.11.2, "Content Presenter Task Flow Parameters"

40.11.1 What You Should Know About the Content Presenter Task Flow Properties

Note:

The Content Presenter properties are intended for use at design time by developers creating a WebCenter Portal application (see "Adding Content Task Flows and Document Components to a Portal Page" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter), or for advanced users who want to bind a parameter to an EL expression. If you modify a property value in the Component Properties dialog, the new value overrides the value specified in the Content Presenter Configuration dialog, and that value becomes read-only in the Content Presenter Configuration dialog.

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 40.11.2, "Content Presenter Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

40.11.2 Content Presenter Task Flow Parameters

Table 40-4 describes the parameters that are unique to the Content Presenter task flow.

Table 40-4 Content Presenter Task Flow Parameters

Parameter

Description

Data Source

The data source of the content. The value depends on the value of Data Source Type:

- When Data Source Type=Single Node, set Data Source to a single node identifier in the format:

connection_name#dDocName:content_id

For example: myconnection.us.oracle.com#dDocName:STAN_IDC-007619

- When Data Source Type=Folder Contents, set Data Source to a single node identifier in the format:

connection_name#dCollectionID:collection_id

For example: myconnection.us.oracle.com#dCollectionID:45535

- When Data Source Type=Query Expression, set Data Source to a CMIS (Content Management Interoperability Services) query expression.

Examples:

select * from cmis:document where cmis:name like \'test%\'

connectionName=connection_name#select * from cmis:document where cmis:createdBy = \'weblogic\'

Note: If connectionName is not specified, then the primary connection will be used.

For more information about how to format the query and for more examples, see Oracle Fusion Middleware Content Management REST Service Developer's Guide.

- When Data Source Type=Multi Node, set Data Source to a set of comma-delimited node identifiers in the format:

connection_name#dDocName:content_id, connection_name#dDocName:content_id, ...

For example: myconn#dDocName:DOCUMENT_ID_12345,myconn#dDocName:DOCUMENT_ID_56789

- When Data Source Type=Scenario Results, set Data Source to the results from a scenario in the format:

conductor-connection-name=conductor_conn_name,namespace=scenario_namespace,scenario-name=scenario_name,inputparm1=value1,inputparm2=value2, ...

For example:

conductor-connection-name=ConductorServiceLocal,namespace=CPNamespace,scenario-name=GetRelatedDocsScenario,topic=outdoors,interests=hiking

For information about the WebCenter Personalization Conductor and scenarios, see "Personalizing WebCenter Applications" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Data Source (cont'd)

where:

- connection_name = the name of the content repository connection.

- content_id = the Content ID for the content specified on the content information page for the item in Oracle Content Server, or the CollectionID value on the content server.

- collection_id = the dCollectionID found in the URL for the folder information page in Oracle Content Server.

- conductor_connection_name = the name of the URL connection that points to the WebCenter Personalization Conductor (this name must start with Conductor). This value must match the Reference name attribute value in the connections.xml file for this URL connection. For more information, see "Configuring Content Presenter" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter and the appendix "Files for WebCenter Portal Applications" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

- namespace = the name of the namespace that contains the specified scenario.

- scenario_name = the name of the scenario that Content Presenter will be using.

Data Source Type

The data source type of the content. Corresponds to the Content Source value in the Content Presenter Configuration dialog. Valid values are:

- Single Node: A single content item.

- Folder Contents: The contents of a folder.

- Query Expression: The results of a query.

- Multi Node: An ordered list of content items.

- Scenario Results: The results of the specified scenario created using the Scenario Editor in JDeveloper. See "Personalizing WebCenter Applications" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Maximum Results

The maximum number of results to display when Data Source Type is Query Expression.

Default: 100

Region Template

Specifies whether the display template is a Site Studio region definition template. This value is valid only with Oracle Content Server 11g or higher:

- ${true}: Display template is a Site Studio region definition template. The TemplateView ID value is used to select the region template.

- ${false} (default): Display template is not a Site Studio region definition template.

For information about creating and using Site Studio region templates, see Section 40.1.1, "Understanding Site Studio Integration" and the Oracle Site Studio documentation library.

Task Flow Instance ID

The unique identifier of this task flow instance, used internally to maintain the association of the task flow instance with its customization and personalization settings. Do not edit this value.

Template Category ID

The display template category ID to use in rendering results for multiple content items. This ID may reference one of the out-of-the-box display templates or a custom display template (see "Creating Content Presenter Display Templates" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter).

Template View ID

The display template view ID to use in rendering results for single content items. Enter the view ID of a template that is configured in the Resource Manager for a specific content type, or for list-based templates by category ID. This ID may reference one of the out-of-the-box display templates or a custom display template (see "Creating Content Presenter Display Templates" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter).

The script content on this page is for navigation purposes only and does not alter the content in any way.

41 Working with the Documents Service Task Flows and Document Components

In a WebCenter Spaces application, you can add content from one or more connected content repositories to the application, as described in Chapter 39, "Introduction to Adding and Managing Content."

See Also:

For an overview of content management in WebCenter Spaces, see Section 2, "Leveraging Content Management."

This chapter describes how to access, add, and manage folders and files in a WebCenter Spaces application using the Documents service task flows and document components:

- Section 41.1, "What You Should Know About the Documents Service Task Flows"

- Section 41.2, "What You Should Know About Document Components"

- Section 41.3, "Adding a Selected Folder or File to a Page"

- Section 41.4, "Adding a Documents Service Task Flow to a Page"

- Section 41.5, "Understanding the Documents Service Task Flow Menus and Actions"

- Section 41.6, "Personalizing Your View"

- Section 41.7, "Creating a Folder"

- Section 41.8, "Creating a File"

- Section 41.9, "Opening a Folder"

- Section 41.10, "Opening a File"

- Section 41.11, "Using the Rich Text Editor (RTE)"

- Section 41.12, "Editing and Updating a File"

- Section 41.13, "Renaming a Folder or File"

- Section 41.14, "Copying and Pasting Folders and Files"

- Section 41.15, "Moving Folders and Files"

- Section 41.16, "Deleting Folders and Files"

- Section 41.17, "Refreshing Folder Contents"

- Section 41.18, "Hiding and Showing Folders"

- Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)"

- Section 41.20, "Viewing, Entering, and Deleting Comments on a File"

- Section 41.21, "Viewing and Deleting File Version History"

- Section 41.22, "Viewing and Modifying Folder and File Properties"

- Section 41.23, "Opening or Saving PDF Files"

- Section 41.24, "Sharing the URL for a Folder or File"

- Section 41.25, "Setting Security Options on a Folder or File"

- Section 41.26, "Subscribing to a File"

- Section 41.27, "Liking and Unliking a File"

- Section 41.28, "Adding a File to Your Favorites"

- Section 41.29, "Running Document Searches"

Note:

Many of the tasks described in this chapter can also be accomplished for Microsoft Office (Word, Excel, and PowerPoint) files using the task pane available through Microsoft Office shared document management functionality, as described in Chapter 46, "Working with Microsoft Office and Explorer Integration."

Audience

This chapter is intended for WebCenter Spaces users assigned, minimally, the Pages-Edit Pages permission who want to view, create, edit, and manage folders and files as individual items or in one of the Documents service task flows on a page in a WebCenter Spaces application.

41.1 What You Should Know About the Documents Service Task Flows

The Documents service task flows provide a variety of formats to display folders and files on a page in a WebCenter Spaces application. You can choose the task flows appropriate for your application to provide features for accessing, adding, and managing folders and files; configuring and viewing file and folder properties; and searching file and folder content in the connected content repositories.

The Documents service task flows are available when the connected content repository is Oracle Content Server, Oracle Portal, or SharePoint, and your WebCenter Spaces administrator has completed the prerequisite configuration. If the content repository is Oracle Content Server, you can use both the Documents task flows and the Content Presenter task flow to add and preview Oracle Site Studio files.

In a Space, you can add Documents service task flows to a page without necessarily enabling the Documents service in the Space. If the Documents service is not enabled in a Space, adding a Documents service task flow to a page does not auto-populate the task flow with folders and files by default, unless you edit the default task flow properties. Once you enable the Documents service in the Space (see Section 51.10.1, "Enabling and Disabling Services Available to a Space"), the following additional content functionality is made available:

- Documents service task flows added to the Space are auto-populated by default with folder and file listings based on the default content repository connection.

- Documents added to the Space are stored in a folder whose security is managed by the Space.

- You can add a Documents service task flow that displays only the documents belonging to the current Space (in the Content Management section of the Oracle Composer Resource Catalog, select Space Documents).

Table 41-1 provides an overview of the Documents service task flows, which offer different ways to display folder and file listings to add and manage content in the connected content repository, or to display individual files in WebCenter Spaces.

Table 41-1 Documents Service Task Flows

Folder and File Listings

Individual Folders

Individual Files

Document Explorer task flow. Displays folders and files in two panes, combining the functionality of the Document Navigator and Folder Viewer task flows. It provides in-place previewing and editing, and robust document management capabilities with an interface that should be familiar to users of Windows Explorer. Size: medium to full page width.

X

X

Document List Viewer task flow. Displays folders and files in a single pane as a flat listing. It provides preview and editing in separate window, and some management capabilities. Size: narrow to medium page width.

X

X

Document Manager task flow. Displays folders and files as specified by its Layout property: Explorer, Table, or Tree Table.

X

X

Document Navigator task flow. Displays a nested hierarchy of folders and files in a single pane, providing expand and collapse on folders to show the full hierarchy. Size: narrow to medium page width.

X

X

Folder Viewer task flow. Displays the contents of a folder in a single pane as a flat listing, providing in-place preview and editing, and robust document management capabilities with a straightforward interface that should be familiar to Windows users. Size: medium to full page width.

X

X

Recent Documents task flow. Displays a list of the files most recently created or modified in the current folder.

X

Document Viewer task flow. Displays a preview of a file, or file properties for files that do not support a preview.

XFoot 1

X

Document Mini Properties task flow. Displays the Basic properties of a file in a read-only view.

X^1

X

Document Properties task flow. Displays both Basic and Advanced properties of a file, along with an Edit button to allow you to modify property values.

X^1

X

Document Version History task flow. Displays a list of versions of a file, allowing for deletion of a selected version.

X

Footnote 1 To show folder information in a Document Viewer, Document Mini Properties, or Document Properties task flow, you can set the task flow's Item ID or Resource ID property to the ID of the target folder. See Chapter 42, "Setting Documents Service Task Flow and Document Component Properties."

For more information about each Documents service task flow, refer to the following sections:

- Section 41.1.1, "Understanding the Document Explorer Task Flow"

- Section 41.1.2, "Understanding the Document List Viewer Task Flow"

- Section 41.1.3, "Understanding the Document Manager Task Flow"

- Section 41.1.4, "Understanding the Document Navigator Task Flow"

- Section 41.1.5, "Understanding the Folder Viewer Task Flow"

- Section 41.1.6, "Understanding the Recent Documents Task Flow"

- Section 41.1.7, "Understanding the Document Viewer Task Flow"

- Section 41.1.8, "Understanding the Document Mini Properties Task Flow"

- Section 41.1.9, "Understanding the Document Properties Task Flow"

- Section 41.1.10, "Understanding the Document Version History Task Flow"

41.1.1 Understanding the Document Explorer Task Flow

The Document Explorer task flow displays a list of folders and files in two panes, combining the functionality of the Document Navigator and Folder Viewer task flows. The left pane shows folders in a nested hierarchy, and the right pane shows the contents of the currently selected folder (Figure 41-1). This task flow provides robust document management capabilities with an interface that should be familiar to users of Windows Explorer. The size of this task flow is medium to full page width.

Figure 41-1 Document Explorer Task Flow

This is the task flow used to display folders and files on the Documents page in your WebCenter Spaces application (see Section 7.3.1, "What You Should Know About System Pages").

Note:

The Documents service is exposed on the Documents page and administration settings in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, the Documents page is not shown in a Space, and the Documents service is not available in the Space administration settings (Services and Roles). To use the Documents service functionality in 10g, you can create a page in a Space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

If you see only a single pane (default), click the Restore Pane icon at the bottom left of the task flow to expose the left pane (Figure 41-2).

Figure 41-2 Restore Pane Icon

Conversely, click the Collapse Pane icon at the bottom left of the task flow to hide the left pane (Figure 41-3).

Figure 41-3 Collapse Pane Icon

The Document Explorer task flow is a feature-rich Documents service task flow for viewing, managing, and collaborating on folders and files. In the Document Explorer task flow, you can:

- Click the expand and collapse icons for a folder to show and hide the subfolders of the folder.

- Click a folder in the left or right pane to display the contents of that folder in the right pane, and drill down further into subfolders.

- Click a file in the right pane to display a preview of the file contents in-place in the Document Viewer preview pane, with file management options, including in-place editing for some file types. If the file type does not support a preview (for example, .mp3 music files, video files, or .zip files), the preview pane displays the file properties.

- Click in a row in the right pane to perform menu actions on the folder or file in that row.

- Drag and drop folders and files in the task flow hierarchy.

For information about the menus and actions available in the Document Explorer task flow that allow you to work with the folders and files in the connected content repository, see Section 41.5, "Understanding the Documents Service Task Flow Menus and Actions."

To add a Document Explorer task flow to a page, refer to Section 41.4, "Adding a Documents Service Task Flow to a Page." In the Resource Catalog, open Content Management, then click Add next to Document Explorer to display the default listing of folder and files in the root folder of the active content repository connection.

You can change the default listing displayed in a Document Explorer task flow in any of the following ways:

- In the task flow chrome, click the Edit (wrench) icon (Figure 41-4) to open the Component Properties dialog, then set the Connection Name and Root Folder Path properties to change the target folder (see Table 42-1, "Document Explorer Task Flow Parameters").

Figure 41-4 Edit Icon in Task Flome Chrome

- Drill down to a target folder in the Resource Catalog, then click the corresponding Add link, and choose Document Explorer (Figure 41-5). For more information, see Section 41.3, "Adding a Selected Folder or File to a Page."

Figure 41-5 Add Menu for Folder

For information about viewing and modifying the properties for a Document Explorer task flow, see Section 42.2, "Setting Document Explorer Task Flow Properties."

41.1.2 Understanding the Document List Viewer Task Flow

The Document List Viewer task flow displays the contents of a folder in a single pane as a flat listing (Figure 41-6). In this task flow, you can navigate a folder hierarchy, and customize search queries. While this task flow may be useful for a specific need, its search functionality is replicated and enhanced by using the Content Presenter task flow instead. The size of this task flow is narrow to medium page width.

Figure 41-6 Document List Viewer Task Flow

In the Document List Viewer task flow, you can:

- Click a folder to display the contents of that folder, and drill down further into subfolders.

- Click a file to display a preview of the file contents in a separate Document Viewer preview window, with file management options, including editing for some file types. If the file type does not support a preview (for example, .mp3 music files, video files, or .zip files), the preview window displays the file properties.

- Click in a row to perform View menu actions on the folder or file in that row. View is the only menu available for this task flow.

To add a Document List Viewer task flow to a page, refer to Section 41.4, "Adding a Documents Service Task Flow to a Page." In the Resource Catalog, open Content Management, then click Add next to Document List Viewer.

You can change the default listing displayed in a Document List Viewer task flow in any of the following ways:

- In the task flow chrome, click the Edit (wrench) icon (Figure 41-7) to open the Component Properties dialog, then set the Show Folders property to true to display folders as well as files (see Table 42-2, "Document List Viewer Task Flow Parameters").

Figure 41-7 Edit Icon in Task Flome Chrome

- Set the Connection Name and Root Folder Path properties to change the target folder (see Table 42-2, "Document List Viewer Task Flow Parameters").

- Drill down to a target folder in the Resource Catalog, then click the corresponding Add link, and choose Document List Viewer (Figure 41-8). For more information, see Section 41.3, "Adding a Selected Folder or File to a Page."

Figure 41-8 Add Menu for Folder

- In the task flow heading, click the Edit icon to enter customization settings (Figure 41-9):

Figure 41-9 Customization Settings in Document List Viewer Task Flow

- Results of a Document Search. Enter an advanced document search, and click Save. For more information, see Section 41.29, "Running Document Searches."

In page edit mode, click Save and then Close to return to page view mode and view the results in the Document List Viewer task flow.

- Content from a Selected Folder (folders display in the task flow pane only when the Show Folders property is set to true). Click the Browse icon, navigate to and select the folder with the content you want to initially display in the task flow, then click Save.

In page edit mode, click Save and then Close to return to page view mode and view the content of the selected folder in the Document List Viewer task flow.

41.1.3 Understanding the Document Manager Task Flow

The Document Manager task flow displays folders and files as specified by its Layout property:

- Explorer layout (default): Displays folders and files in two panes; the left pane shows folders, and the right pane show the contents of the currently selected folder (Figure 41-10). This layout is identical to the Document Explorer task flow, without the properties Show Documents, Show Folders, and Collapse Tree Navigation (see Chapter 42, "Setting Documents Service Task Flow and Document Component Properties").

- Table layout: Displays only the contents of the current folder in a single pane, with the capability to click a folder to drill down, refreshing the pane with the folder contents (Figure 41-11).

- Tree Table layout: Displays the folder hierarchy in a single pane, beginning with the root folder, with the capability to expand and collapse folders (Figure 41-12). This layout may be familiar to Mac OS X users.

Figure 41-10 Document Manager Task Flow: Explorer Layout

Figure 41-11 Document Manager Task Flow: Table Layout

Figure 41-12 Document Manager Task Flow: Tree Table Layout

In the Document Manager task flow, you can:

- Click the expand and collapse icons for a folder to show and hide the contents in the folder within the folder hierarchy.

- Click a folder to display the contents of only that folder, and drill down further into subfolders.

- Click a file to display a preview of the file contents in-place in the Document Viewer preview pane, with file management options, including in-place editing for some file types. If the file type does not support a preview (for example, .mp3 music files, video files, or .zip files), the preview pane displays the file properties.

- Click in a row to perform menu actions on the folder or file in that row.

- Drag and drop folders and files in the task flow hierarchy.

For information about the menus and actions available in the Document Manager task flow that allow you to work with the folders and files in the connected content repository, see Section 41.5, "Understanding the Documents Service Task Flow Menus and Actions."

To add a Document Manager task flow to a page, refer to Section 41.4, "Adding a Documents Service Task Flow to a Page." In the Resource Catalog, open Content Management, then click Add next to Document Manager to display the default listing of folders and files in the root folder of the active content repository connection.

Note:

The Document Manager task flow is not shown under Content Management in the default Resource Catalog provided out-of-the-box with WebCenter Spaces, so you will only see an entry for this task flow if it has been added to a custom Resource Catalog that has been made available to the page. However, if you navigate to a specific folder in the default Resource Catalog, this task flow is selectable from the Add menu for the folder (Figure 41-14).

For information about creating a custom Resource Catalog, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Task Flows, then scroll to Documents for a list of all available content task flows).

You can change the default folders and files displayed in a Document Manager task flow in any of the following ways:

- In the task flow chrome, click the Edit (wrench) icon (Figure 41-13) to open the Component Properties dialog, then set the Connection Name and Root Folder Path properties to change the target folder (see Table 42-3, "Document Manager Task Flow Parameters").

Figure 41-13 Edit Icon in Task Flome Chrome

- Drill down to a target folder in the Resource Catalog, then click the corresponding Add link, and choose Document Manager (Figure 41-14). For more information, see Section 41.3, "Adding a Selected Folder or File to a Page."

Figure 41-14 Add Menu for Folder

41.1.4 Understanding the Document Navigator Task Flow

The Document Navigator task flow displays a nested hierarchy of folders and files in a single pane, with the capability to expand and collapse folders to view folder hierarchy within the current folder (Figure 41-15). There are no menu options available for this task flow. The size of this task flow is narrow to medium page width.

Figure 41-15 Document Navigator Task Flow

In the Document Navigator task flow, you can:

- Click the expand and collapse icons for a folder to show and hide the contents in the folder within the folder hierarchy.

- Drag and drop folders and files in the task flow hierarchy.

To add a Document Navigator task flow to a page, refer to Section 41.4, "Adding a Documents Service Task Flow to a Page." In the Resource Catalog, open Content Management, then click Add next to Document Navigator to display the default listing of folders in the root folder of the active content repository connection.

Note:

The Document Navigator task flow is not shown under Content Management in the default Oracle Composer Resource Catalog provided out-of-the-box with WebCenter Spaces, so you will only see an entry for this task flow if it has been added to a custom Resource Catalog that has been made available to the page. However, if you navigate to a specific folder in the default Resource Catalog, this task flow is selectable from the Add menu for the folder (Figure 41-17).

For information about creating a custom Resource Catalog, see see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Task Flows, then scroll to Documents for a list of all available content task flows).

You can change the default listing displayed in a Document Navigator task flow in any of the following ways:

- In the task flow chrome, click the Edit (wrench) icon(Figure 41-16) to open the Component Properties dialog, then set the Connection Name and Start Folder Path properties to change the target folder (see Table 42-4, "Document Navigator Task Flow Parameters").

Figure 41-16 Edit Icon in Task Flome Chrome

- Drill down to a target folder in the Resource Catalog, then click the corresponding Add link, and choose Document Navigator (Figure 41-17). For more information, see Section 41.3, "Adding a Selected Folder or File to a Page."

Figure 41-17 Add Menu for Folder

41.1.5 Understanding the Folder Viewer Task Flow

The Folder Viewer task flow displays the contents of a folder in a single pane as a flat listing (Figure 41-18), providing in-place preview and editing of the contents of the folder, and robust document management capabilities with a straightforward interface that should be familiar to Windows users. The size of this task flow is medium to full page width.

Figure 41-18 Folder Viewer Task Flow

In the Folder Viewer task flow, you can:

- Click a folder to display the contents of that folder, and drill down further into subfolders.

- Click a file to display a preview of the file contents in-place in the Document Viewer preview pane, with file management options, including editing for some file types. If the file type does not support a preview (for example, .mp3 music files, video files, or .zip files), the preview pane displays the file properties.

- Click in a row to perform menu actions on the folder or file in that row.

- Drag and drop folders and files in the task flow hierarchy.

For information about the menus and actions available in the Folder Viewer task flow that allow you to work with the folders and files in the connected content repository, see Section 41.5, "Understanding the Documents Service Task Flow Menus and Actions."

To add a Folder Viewer task flow to a page, refer to Section 41.4, "Adding a Documents Service Task Flow to a Page." In the Resource Catalog, open Content Management, then click Add next to Folder Viewer to display the default listing of folders and files in the root folder of the active content repository connection.

You can change the default listing displayed in a Folder Viewer task flow in any of the following ways:

- In the task flow chrome, click the Edit (wrench) icon (Figure 41-19) to open the Component Properties dialog, then set the Connection Name and Start Folder Path properties to change the target folder (see Table 42-5, "Folder Viewer Task Flow Parameters").

Figure 41-19 Edit Icon in Task Flome Chrome

- Drill down to a target folder in the Resource Catalog, then click the corresponding Add link, and choose Folder Viewer (Figure 41-20). For more information, see Section 41.3, "Adding a Selected Folder or File to a Page."

Figure 41-20 Add Menu for Folder

41.1.6 Understanding the Recent Documents Task Flow

The Recent Documents task flow displays a listing of the files most recently created or modified by the current user (Figure 41-21).

Figure 41-21 Recent Documents Task Flow

In the Recent Documents task flow, you can:

- Click a file to display a preview of the file contents in a separate window, with file management options, including editing for some file types. If the file type does not support a preview (for example, .mp3 music files, video files, or .zip files), the preview window displays the file properties.

To add a Recent Documents task flow to a page, refer to Section 41.4, "Adding a Documents Service Task Flow to a Page." In the Resource Catalog, open Content Management, then click Add next to Recent Documents to display the most recently created or modified files in the current Space.

The default property settings add a listing of the most recently created or modified files in the entire root folder of the active content repository connection to the page. See Section 42.7, "Setting Recent Documents Task Flow Properties" to modify the property settings for the Recent Documents task flow.

41.1.7 Understanding the Document Viewer Task Flow

The Document Viewer task flow can display:

- Folder properties and settings. To show folder information in a Document Viewer task flow, you can set the task flow's Item ID property to the ID of the target folder. See Section 42.8, "Setting Document Viewer Task Flow Properties."

- A preview of an individual file (Figure 41-22, Figure 41-23, and Figure 41-24). This choice is available for all file types that support a preview. For files that do not support a preview, such as audio or video files, the Document Viewer task flow displays the file properties.

The Document Viewer task flow includes selections unique to the file type. For example, a preview of a Microsoft Office Word document includes an Edit with Word action to open the file in-place in Microsoft Word, and a preview of an Oracle Site Studio file includes a Select Template menu for choosing a Site Studio region display template or a custom Content Presenter display template in which to display the file.

Figure 41-22 Document Viewer Task Flow for Word Document

Figure 41-23 Document Viewer Task Flow for Image File

Figure 41-24 Document Viewer Task Flow for Site Studio File

To add a Document Viewer task flow to a page, refer to Section 41.3, "Adding a Selected Folder or File to a Page." In the Resource Catalog, open Content Management, navigate to the folder or file that you want to add to the page, then click the Add link next to the folder or file, and choose Document Viewer.

For information about setting properties on the Document Viewer task flow, see Section 42.8, "Setting Document Viewer Task Flow Properties."

41.1.8 Understanding the Document Mini Properties Task Flow

The Document Mini Properties task flow can display:

- Folder properties and settings. To show folder information in a Document Mini Properties task flow, you can set the task flow's Resource ID property to the ID of the target folder. See Section 42.9, "Setting Document Mini Properties Task Flow Properties."

- The Basic properties of an individual file in a read-only view (Figure 41-25). This choice is available for all file types.

Figure 41-25 Mini Properties Task Flow for File

To add a Document Mini Properties task flow to a page, refer to Section 41.3, "Adding a Selected Folder or File to a Page." In the Resource Catalog, open Content Management, navigate to the folder or file that you want to add to the page, then click the Add link next to the folder or file, and choose Mini Properties.

For information about setting properties on the Mini Properties task flow, see Section 42.9, "Setting Document Mini Properties Task Flow Properties."

41.1.9 Understanding the Document Properties Task Flow

The Document Properties task flow can display:

- Folder properties and settings. To show folder information in a Document Properties task flow, you can set the task flow's Item ID property to the ID of the target folder. See Section 42.10, "Setting Document Properties Task Flow Properties."

- Both Basic and Advanced properties of an individual file, along with an Edit button to allow you to modify property values (Figure 41-26). This choice is available for all file types. See Section 41.22, "Viewing and Modifying Folder and File Properties."

Figure 41-26 Document Properties Task Flow for File

To add a Document Properties task flow to a page, refer to Section 41.3, "Adding a Selected Folder or File to a Page." In the Resource Catalog, open Content Management, navigate to the folder or file that you want to add to the page, then click the Add link next to the folder or file, and choose Document Properties.

For information about setting properties on the Document Properties task flow, see Section 42.10, "Setting Document Properties Task Flow Properties."

41.1.10 Understanding the Document Version History Task Flow

The Document Version History task flow displays a list of versions of an individual file, allowing for deletion of a selected version (Figure 41-27). This choice is available for all file types. See Section 41.21, "Viewing and Deleting File Version History."

Figure 41-27 Version History Task Flow for File

To add a Document Version History task flow to a page, refer to Section 41.3, "Adding a Selected Folder or File to a Page." In the Resource Catalog, open Content Management, navigate to the file that you want to add to the page, then click the Add link next to the file, and choose Version History.

For information about setting properties on the Document Version History task flow, see Section 42.11, "Setting Document Version History Task Flow Properties."

41.2 What You Should Know About Document Components

The Documents service provides the features for adding document components to a page in a WebCenter Spaces application. Document components enable you to display an individual file on a page in a variety of ways, depending on the file type:

- A Link displays the name of a selected file as a link, which end users can click to display the file content in its native application.

- An Inline Frame displays the content of a selected file as a preview.

- An Image displays a selected file as an image.

To display a file using one of these document components, see Section 41.3, "Adding a Selected Folder or File to a Page."

41.3 Adding a Selected Folder or File to a Page

You can display an individual folder or file from a connected content repository on a page in any of the containers listed in Table 41-2:

Table 41-2 Adding Individual Folders and Files to a Page

For Folders

For Individual Files

- Content Presenter task flow

- Document Explorer task flow

- Document List Viewer task flow

- Document Manager task flow

- Document Navigator task flow

- Folder Viewer task flow

- Document Viewer task flowFoot 1

- Document Mini Properties task flow^1

- Document Properties task flow^1

- Content Presenter task flow

- Document Viewer task flow

- Document Mini Properties task flow

- Document Properties task flow

- Document Version History task flow

- Link component

- Inline Frame component

- Image component

Footnote 1 To show folder information in a Document Viewer, Document Mini Properties, or Document Properties task flow, you can set the task flow's resource ID parameter to the ID of the target folder. See Chapter 42, "Setting Documents Service Task Flow and Document Component Properties."

For more information, see Section 41.1, "What You Should Know About the Documents Service Task Flows" and Section 41.2, "What You Should Know About Document Components."

Note:

Another way of adding folders and files to a page is through a custom navigation model added to a page. WebCenter application designers can build custom navigation models, which can be added to the page templates for a Space to allow end users to navigate the documents in the Space. For more information, see Section 11.2.2.1.1, "Adding a Document to a Navigation Model."

Note:

When an item that is stored in a content repository is added to a page, the WebCenter application instructs the browser to check whether the content is up-to-date before a cached copy, if available, displays in the browser. The default content validation process supports collaboration use cases that require real-time content exchange.

For static content or content that does not change frequently, content validation checks incur an unnecessary performance overhead. For static content, Oracle recommends the following:

- Oracle Content Server: use Content Presenter to display static content stored in Oracle Content Server. Content Presenter shows only the latest released version of content; it does not show any unreleased content that is in workflow.

- Other content repositories, such as SharePoint: ask your administrator to override the default content cache setting by editing the Web Tier mod_wl_ohs configuration file (mod_wl_ohs.conf). This is fully explained in "Setting the Cache-Control Response Header" in the white paper "Integrating the SharePoint 2007 Adapter with WebCenter Spaces" available from Oracle Technology Network at http://www.oracle.com/technetwork/middleware/webcenter/overview/index.html.

To add a selected folder or file to a page:

1. Go to the page where you want to add a folder or file, and open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that provides access to the folders and files in the connected content repository.

Tip:

The presence or location of this section depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, next to Content Management, click Open to expose the content selections (Figure 41-28).

Figure 41-28 Opening the Content Management Section in the Resource Catalog

4. The next link you click depends on your current location in the application. If you are using the default Resource Catalog (Figure 41-29):

- Click All Content to display all folders and files to which you have access.

- In a Space, click Space Documents, which provides a shortcut to a list of all of the folders and files to which you have access in the current Space. This selection is shown only if the Documents service is enabled in the Space (see Section 51.10, "Managing Space Services").

- In the Home Space, click Personal Documents, which provides a shortcut to a list of all the folders and files to which you have access in the Home Space.

Figure 41-29 Content Selections in a Space

5. Continue to drill down into folders until you arrive at the folder or file that you want to add to the page, then click the Add link next to the folder or file to display a menu of available containers for the folder or file (Figure 41-30,Figure 41-31, Figure 41-32, and Figure 41-33).

Note:

When you drill down to the folders and files in the connected content repository, you are drilling into the live connection with the content repository. The documents you see listed are not static resources, but reflect the latest status of folders and files in the content repository associated with your WebCenter Spaces application.

Figure 41-30 Add Menu for Folder

Figure 41-31 Add Menu for Microsoft Word File

Figure 41-32 Add Menu for HTML File

Figure 41-33 Add Menu for Image File

6. Choose the content task flow or document component that you wish to use. The menu displays only those containers that support the selected folder or file.

Note:

The Content Presenter task flow is available only when the connected content repository is Oracle Content Server. When you select the Content Presenter task flow, the folder or file displays in a default display template for its type. For more information, see Chapter 40, "Publishing Content Using Content Presenter."

7. Click Save, then Close.

41.4 Adding a Documents Service Task Flow to a Page

See Section 41.1, "What You Should Know About the Documents Service Task Flows" to help you select the task flow most appropriate for your needs.

To add a Documents service task flow to a page in a WebCenter Spaces application:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that provides access to the folders and files in the connected content repository.

Tip:

The presence or location of this section depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, next to Content Management, click Open to expose the content selections (Figure 41-34).

Figure 41-34 Opening the Content Management Section in the Resource Catalog

For information about the selections shown in the default Resource Catalog, see Section 39.2, "What You Should Know About Content Management Selections in the Resource Catalog."

4. Click Add next to the task flow that you want to add to your page (Figure 41-35).

Figure 41-35 Content Selections in a Space

Note:

The Document Manager and Document Navigator task flows are not shown under Content Management in the default Oracle Composer Resource Catalog provided out-of-the-box with WebCenter Spaces, so you will only see entries for these task flows if they have been added to a custom Resource Catalog that has been made available to the page. However, if you navigate to a specific folder in the default Resource Catalog, these task flows are selectable from the Add menu for the folder.

For information about creating a custom Resource Catalog, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Task Flows, then scroll to Documents for a list of all available content task flows).

In a Space, if the Documents service is enabled (see Section 51.10, "Managing Space Services"), the selected task flow will by default display folders and files based on the primary content repository connection, or you can display only documents belonging to the Space. If the Documents service is not enabled in a Space, folders and files will not display in the task flow unless you edit the default task flow properties to specify a content repository (see Chapter 42, "Setting Documents Service Task Flow and Document Component Properties").

41.5 Understanding the Documents Service Task Flow Menus and Actions

The Documents service task flows that offer content management functionality are Document Explorer, Folder Viewer, and Document Manager. For these task flows, Table 41-3 summarizes the menus and actions for working with the folders and files. More detail is provided in the following sections:

- Section 41.5.1, "Menus and Actions in the Documents Service Task Flows"

- Section 41.5.2, "Menus and Actions in the Document Viewer Preview Pane or Window"

Table 41-3 Documents Service Task Flow Menus and Actions for Folders and Files

Menus and Actions

Document Explorer and Folder Viewer

Document Manager

File Menu:

EditFoot 1

Upload New VersionFoot 2

Check Out^2

Cancel Check Out^2

New Folder

Rename

Cut

Copy

Paste

Delete

file

file

file

file

folder or file

folder or file

folder or file

folder or file

folder or file

folder or file

file

file

file

file

folder or file

folder or file

folder or file

folder or file

folder or file

folder or file

View Menu:

Related Items

Comments

Version History

Properties

Get a Link

Containing Folder Properties

Refresh Content

Hide Folders

Columns submenu

Expand

Show as Top

Go to Top

Scroll to First

Scroll to Last

Reorder Columns

file

file

file

folder or file

folder or file

folder or file

folder or file

folder or file

folder or file

NA

NA

NA

NA

NA

folder or file

file

file

file

folder or file

folder or file

NA

folder or file

NA

folder or file

folder

folder

folder

folder or file

folder or file

folder or file

New Wiki Document Action

folder or file

folder or file

Upload Action

folder or file

folder or file

Download Action

file

file

Document Viewer Preview Pane

Click a folder to display the contents of that folder.

Click a file to display a preview of file contents, with management options shown below. This allows for file previewing and editing for some file types. If the file type does not support a preview (for example, .mp3 music files, video files, or .zip files), the Document Viewer preview pane displays the file properties.

File Menu:

Send Mail

Subscribe

Share

Add to Favorites

Check Out^2

Worklow Settings

Security

file

file

file

file

file

folder

folder or file

file

file

file

file

file

folder

folder or file

View Menu:

Open in BrowserFoot 3

Open as PDFFoot 4

Download PDFFoot 5

Related Items

Comments

Version History

Properties

Get a Link

file

file

file

file

file

file

file

file

file

file

file

file

file

file

file

file

Edit ActionFoot 6

file

file

Upload New Version Action^2

file

file

Download Action

file

file

Sidebar Icons and Panes

file

file

Footnote 1 Folder/file listing pane: In-place editing available for wiki documents, blog posts, HTML, and Microsoft Office (Word, Excel, PowerPoint) files only. Wiki documents and HTML files open in RTE; Office files open in their corresponding application.

Footnote 2 Check Out, Cancel Check Out, and Upload New Version not available for wiki documents.

Footnote 3 Open in Browser available for image, text, and HTML files only.

Footnote 4 Open as PDF available for any file type for which Oracle Content Server is configured to convert to PDF.

Footnote 5 Download PDF available any file type for which Oracle Content Server is configured to convert to PDF.

Footnote 6 Edit action available for wiki documents, blog posts, HTML, and Microsoft Office (Word, Excel, PowerPoint) files only.

41.5.1 Menus and Actions in the Documents Service Task Flows

The following sections describe the purpose of the menus and actions listed in Table 41-3 when viewing a listing of folders and/or files in a Documents service task flow:

- Section 41.5.1.1, "File Menu"

- Section 41.5.1.2, "View Menu"

- Section 41.5.1.3, "New Wiki Document Action"

- Section 41.5.1.4, "Upload Action"

- Section 41.5.1.5, "Download Action"

- Section 41.5.1.6, "Folder Context Menu"

- Section 41.5.1.7, "File Context Menu"

41.5.1.1 File Menu

The File menu is available in the Document Manager, Document Explorer, and Folder Viewer task flows for folders and files. The actions available on the File menu are:

- Edit: Active for wiki documents, HTML, and Microsoft Office (Word, Excel, and PowerPoint) files only. For a selected file, opens the file in-place in the application that corresponds to the file type and automatically checks the file out. See Section 41.12.3, "Editing Files In-Place."

- Upload New Version: Inactive for folders and wiki documents. If you have write permissions on a selected file, opens the Upload Document pane where you can specify a new version of the file to upload to replace the existing file. See Section 41.12.4, "Uploading a New Version of an Existing File."

- Check Out: Inactive for folders and wiki documents. For a selected file, checks the file out, locking it for update by other users. See Section 41.12.1, "Checking a File Out."

- Cancel Check Out: Inactive for folders and wiki documents. For a selected file, cancels the checked out status without updating it, unlocking it to allowing other users to update it. See Section 41.12.1, "Checking a File Out."

- New Folder: Opens the Create Folder dialog where you can specify a name for a new folder. The location of the new folder is dependent on the Documents service task flow used, and the current selection. See Section 41.7, "Creating a Folder."

- Rename: Opens the Rename dialog where you can rename the selected folder or file. See Section 41.13, "Renaming a Folder or File."

- Cut: Stores the path to the selected folder(s) or file(s) to paste elsewhere. If a folder or file is not subsequently pasted, it is restored to the location where it was cut. If a folder or file is deleted at the source location before pasting, it will not be moved to the paste location. See Section 41.15, "Moving Folders and Files."

- Copy: Stores the path to the selected folder or file to paste as a copy elsewhere. If a folder or file is deleted at the source location before pasting, it will not be copied to the paste location. See Section 41.14, "Copying and Pasting Folders and Files."

- Paste: Pastes the folder or file in the buffer to the current folder. See Section 41.14, "Copying and Pasting Folders and Files."

- Delete: Deletes the selected folder or file. See Section 41.16, "Deleting Folders and Files."

41.5.1.2 View Menu

The View menu is available in the Document Manager, Document Explorer, and Folder Viewer task flows, as well as the Document List Viewer task flow, for folders and files. The actions available on the View menu are:

- Related Items: Inactive for folders. Opens a preview of the current file alongside the Related Items pane, providing access to the file's tags, links, and recommendations. See Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)."

- Comments: Inactive for folders. Opens a preview of the current file alongside the Comments pane, where you can enter or delete comments for a file to provide additional information that you want to convey to other users about the file. See Section 41.20, "Viewing, Entering, and Deleting Comments on a File."

- Version History: Inactive for folders. Opens a preview of the current file alongside the History pane, which provides version information about the current file, and allows you to selectively delete versions. For more information, see Section 41.21, "Viewing and Deleting File Version History."

- Properties: For a folder, open a Properties pane; for a file, opens a preview of the file alongside the Properties pane, which provides read-only information details about the selected file or folder, with the option to edit some properties such a file name and description. See Section 41.22, "Viewing and Modifying Folder and File Properties."

- Get a Link: Opens the Get a Link dialog, where Direct URL provides a direct link to open the folder or file in WebCenter Spaces or a WebCenter Portal application. For files, the Download URL provides a direct link to allow users to open the file in its default application, or choose to save the file to their local file system. See Section 41.24, "Sharing the URL for a Folder or File."

- Containing Folder Properties: Opens the Properties pane of the parent folder of the current folder or file. See Section 41.22, "Viewing and Modifying Folder and File Properties."

- Refresh Content: Retrieves the contents of the current folder from the content repository to reflect all changes since the last retrieval. See Section 41.17, "Refreshing Folder Contents."

- Hide Folders: Refreshes the listing to show only files in the current folder, or show folders if this action is currently active. See Section 41.18, "Hiding and Showing Folders."

- Columns: Provides a submenu to select the columns that you want to display in the task flow. See Section 41.6.1, "Hiding and Showing Columns."

- Expand: Active for folders in the Document Manager task flow. Expands the selected folder to show its contents.

- Show as Top: Active for folders in the Document Manager task flow. Makes the selected folder the topmost folder in the hierarchy.

- Scroll to First: Active for folders and files in the Document Manager task flow. Moves focus to the topmost item in the parent folder.

- Scroll to Last: Active for folders and files in the Document Manager task flow. Moves focus to the bottommost item in the parent folder.

- Reorder Columns: Opens the Reorder Columns dialog where you can organize the displayed columns into a different order. See Section 41.6.2, "Reordering Columns."

41.5.1.3 New Wiki Document Action

The New Wiki Document action is available in the Document Manager, Document Explorer, and Folder Viewer task flows for opening the Rich Text Editor where you can define a new wiki document, created at the same level as the currently selected file, or in the current folder. See Section 41.8.2, "Creating a Wiki Document."

41.5.1.4 Upload Action

The Upload action is available in the Document Manager, Document Explorer, and Folder Viewer task flows for uploading files from a local file system or network drive. See Section 41.8.1, "Uploading New Files."

41.5.1.5 Download Action

The Download action is available in the Document Manager, Document Explorer, and Folder Viewer task flows for saving files to the local file system. See Section 41.12.2, "Downloading a File."

41.5.1.6 Folder Context Menu

You can right-click a folder in a Documents service task flow to display a context menu that provides a shortcut to many menu actions (Figure 41-36).

Figure 41-36 Folder Context Menu in Documents Service Task Flows

41.5.1.7 File Context Menu

You can right-click a file in a Documents service task flow to display a context menu that provides a shortcut to many menu actions (Figure 41-37).

Figure 41-37 File Context Menu in Documents Service Task Flows

41.5.2 Menus and Actions in the Document Viewer Preview Pane or Window

Table 41-3 shows which menus and actions are available when previewing a document. The following sections describe the purpose of each available action in the Document Viewer preview pane or window:

- Section 41.5.2.1, "File Menu"

- Section 41.5.2.2, "View Menu"

- Section 41.5.2.3, "Edit Action"

- Section 41.5.2.4, "Upload New Version Action"

- Section 41.5.2.5, "Download Action"

- Section 41.5.2.6, "Sidebar Icons and Panes"

41.5.2.1 File Menu

The File menu includes the following actions:

- Send Mail: Opens your mail application with the body of the mail message showing the direct URL to the currently open file, as well as the URL to the current Space, if applicable. See Section 41.24.2, "Mailing the URL for a File."

- Subscribe: Activates monitoring of the activities on a file. Whenever any change is made to the file, you will be notified in your activity stream on the Activities page in your Home Space. See Section 41.26, "Subscribing to a File."

- Share: Opens a dialog where you specify the users, groups, or select a Space where the URL for the selected file will be added to the activity stream, along with a message. See Section 41.24.3, "Publishing the URL for a File to Activity Streams."

- Add to Favorites: Adds the selected file to your WebCenter Spaces Favorites list. See Section 41.28, "Adding a File to Your Favorites."

- Check Out: Inactive for wiki documents. Checks the current file out, locking it from update by other users. See Section 41.12.1, "Checking a File Out."

- Workflow Settings: When the properties for a folder display in the preview pane, the File menu includes the Workflow Settings selection. For more information, see Chapter 43, "Working with Workflow-Enabled Content."

- Security: Opens the Security Settings dialog, where you can set custom access permissions for the selected file, or select to inherit the permissions of the parent folder. For more information, see Section 41.25, "Setting Security Options on a Folder or File."

- Annotate with AutoVue: When Oracle AutoVue is installed and your configuration enables Oracle AutoVue functionality, opens the selected file in the AutoVue file viewer on Oracle Content Server, where you can provide comments and individualized mark-up. For more information, see Section 45.3, "Collaborating on Documents Using Oracle AutoVue."

41.5.2.2 View Menu

The View menu includes the following actions:

- Open in Browser: Active for images, text, wiki documents, and HTML files only. Opens the current file in your default browser application. See Section 41.10, "Opening a File."

- Open as PDF: Active for any file type for which Oracle Content Server is configured to convert to PDF. Opens the current file in the Document Viewer preview pane in PDF. See Section 41.10, "Opening a File" and Section 41.23, "Opening or Saving PDF Files."

- Download PDF: Active for any file type for which Oracle Content Server is configured to convert to PDF. Opens a browser dialog where you can choose to open the file with Adobe Acrobat Reader, or save it to your local file system as a PDF file. See Section 41.12.2, "Downloading a File" and Section 41.23, "Opening or Saving PDF Files."

- Related Items: Opens the Related Items pane for the current file, providing access to the file's tags, links, and recommendations. See Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)."

- Comments: Opens the Comments pane for the current file, providing a text input area where you can enter a comment for the file. See Section 41.20, "Viewing, Entering, and Deleting Comments on a File."

- Version History: Opens the History pane for the currently selected file, showing the existing versions of the file, where you can delete selected versions. See Section 41.21, "Viewing and Deleting File Version History."

- Properties: Opens the Properties pane for the currently selected file, where you can view and edit Basic and Advanced properties. See Section 41.22, "Viewing and Modifying Folder and File Properties."

- Get a Link: Opens the Get a Link dialog, where Direct URL provides a direct link to open the file in WebCenter Spaces or a WebCenter Portal application, and the Download URL provides a direct link to allow users to open the file in its default application, or choose to save the file to their local file system. See Section 41.24, "Sharing the URL for a Folder or File."

41.5.2.3 Edit Action

The Edit action is active for wiki documents, HTML, and Microsoft Office 2003 or higher files (Word, Excel, and PowerPoint) only. Select this action to automatically check the current file out, and open it in-place in the Rich Text Editor (RTE) or its Microsoft application. See Section 41.12.3, "Editing Files In-Place."

41.5.2.4 Upload New Version Action

The Upload New Version action is active for all files except for wiki documents. If you have write permissions on the current file, select this action to open the Upload Document screen where you can specify a new version of the file to upload. See Section 41.12.4, "Uploading a New Version of an Existing File."

41.5.2.5 Download Action

The Download action opens a dialog to download the current file to your local file system. See Section 41.12.2, "Downloading a File."

41.5.2.6 Sidebar Icons and Panes

The Sidebar in the Document Viewer preview pane includes icons that provide access to items associated with the current file, as illustrated in Figure 41-38:

Figure 41-38 Sidebar Icons

- The Like icon is highlighted if you have given the currently open file your preference. If the currently open file is already liked, you can click the Like icon to "unlike" the file if you no longer wish to highlight it in any way. If a number greater than zero displays alongside the Like icon, you can click the number to view a list of other users who have "liked" the file. See Section 41.27, "Liking and Unliking a File."

- The Related Items icon is a shortcut to open the Related Items pane for the current file, providing access to the file's tags and links. See Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)."

- The Comments icon is a shortcut to open the Comments pane for the current file, showing current comments, and providing a text input area where you can enter a comment for the file. See Section 41.20, "Viewing, Entering, and Deleting Comments on a File."

- The History icon is a shortcut to open the History pane for the currently selected file, showing the existing versions of the file, where you can delete selected versions. See Section 41.21, "Viewing and Deleting File Version History."

- The AutoVue icon displays when Oracle AutoVue is installed and your configuration enables Oracle AutoVue functionality. Clicking this icon opens the AutoVue pane for the currently selected file, showing the AutoVue markup for the file in a table of hyperlinked markup names. Clicking a markup name opens the AutoVue file viewer on Oracle Content Server, displaying the markup details. If no AutoVue markups are present for a given document, a message displays to notify you that the document does not have any markups. For more information, see Section 45.3, "Collaborating on Documents Using Oracle AutoVue."

Note:

To enable Oracle AutoVue functionality, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

- The Properties icon is a shortcut to open the Properties pane for the currently selected file, where you can view and edit Basic and Advanced properties. See Section 41.22, "Viewing and Modifying Folder and File Properties."

41.6 Personalizing Your View

The Documents service supports personalizations that enable you to change your own view of a Documents service task flow by hiding or showing columns and by rearranging the list of documents according to the sort order of a particular column, as described in the following sections:

- Section 41.6.1, "Hiding and Showing Columns"

- Section 41.6.2, "Reordering Columns"

- Section 41.6.3, "Sorting Files and Folders"

41.6.1 Hiding and Showing Columns

Hiding and showing one or more informational columns is useful for simplifying or expanding the details that are displayed with folders and files.

To hide or show informational columns in your unique view of a task flow:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click the View menu, and choose Columns (Figure 41-39).

Figure 41-39 View Menu in Document Explorer Task Flow

2. Select or clear individual columns to show or hide them, or select Show All to display all available columns.

If changes do not display immediately, click the View menu and choose Refresh Content.

41.6.2 Reordering Columns

Reordering the informational columns is useful for prioritizing the details that are displayed with folders and files, depending on the information in which you are most interested.

To reorder the informational columns in your unique view of a task flow:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click the View menu, and choose Reorder Columns.

The Reorder Columns dialog opens (Figure 41-40).

Figure 41-40 Reorder Columns Dialog

2. Select one or more columns, then click the reorder icons to rearrange the order of the columns in the task flow.

41.6.3 Sorting Files and Folders

Sorting columns enables you to quickly rearrange the order of the content in a Document Manager or Document List Viewer task flow. Each task flow column provides a one-click sorting feature that you can use to instantly rearrange all task flow content according to the ascending (1, 2, 3, A, B, C) or descending (C, B, A, 3, 2, 1) order of a particular column.

To sort folders and files in your unique view of a Documents service task flow:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, move your cursor over the header of the column you want to use to sort folders and files.

2. Click the Sort Ascending icon to sort the column in ascending order (1, 2, 3, A, B, C, or smallest to largest), or click the Sort Descending icon to sort the column in descending order (C, B, A, 3, 2, 1, or largest to smallest) (Figure 41-41).

Figure 41-41 Sort Ascending and Sort Descending Icons

Note:

The sorting icons display over the column that is the current sorting column. For other columns, the icons display when you hover your mouse pointer over the column name.

41.7 Creating a Folder

With appropriate permissions, you can create a folder in any Documents service task flow that displays folders. In the Document Manager task flow, when the task flow is configured as a Tree Table layout (see Section 41.1.3, "Understanding the Document Manager Task Flow") and the currently selected item is a file, the new folder is created in the same folder as that file; if the currently selected item is a folder, the new folder is created within that folder. In the Document Explorer or Folder Viewer task flows, the new folder is always created at the same level as the current location.

If you create a subfolder in a parent folder that is assigned a worfklow (see Section 43.2, "Assigning a Workflow to a Folder"), the subfolder inherits the workflow assignment of the parent folder.

Note:

Other methods to create and copy folders when the backend content repository is Oracle Content Server are:

- Create a network place to a Space, then use Windows Explorer to create and copy folders, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

- Use the task pane available through Microsoft Office shared document management functionality to create a new folder in a Space, as described in Section 46.3.4.2, "Adding a New Folder."

To create a folder:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, navigate to the folder under which to create the new folder.

2. From the File menu, choose New Folder.

The Create Folder dialog opens (Figure 41-42).

Figure 41-42 Create Folder Dialog

3. In the Folder Name field, enter a name for the folder; for example, Local Events.

4. Click Create to create the folder and close the dialog.

41.8 Creating a File

You can create new files in the connected content repository using the Documents service task flows by either uploading a file, or creating a new wiki document in-place using the Rich Text Editor (RTE), as described in the following sections:

- Section 41.8.1, "Uploading New Files"

- Section 41.8.2, "Creating a Wiki Document"

41.8.1 Uploading New Files

You can upload files from your local file system or a mapped network drive to the content repository. To upload a new version of an existing file, see Section 41.12.4, "Uploading a New Version of an Existing File."

Note:

WebCenter Spaces does not support uploading a new wiki document or a new version of a wiki document from the file system. If you upload an HTML file, you cannot convert it to a wiki document due to differences in underlying metadata. For information about wiki documents in WebCenter Spaces, see Chapter 47, "Working with Wiki Documents."

Note:

Other methods to upload files when the backend content repository is Oracle Content Server are:

- Create a Windows network place to a Space, then use Windows Explorer to add files of any type, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

- Use the Microsoft Office shared document management functionality to save a local Microsoft Word, Excel, or PowerPoint file, or use the task pane to add files of any type to the Oracle Content Server repository, as described in Section 46.3.4.1, "Adding a File."

- Use WebDAV, which is installed with Oracle Content Server out-of-the-box, to establish a connection to your WebCenter Spaces application, then drag and drop content in your Oracle Content Server repository to the folder assigned to the target Space, or drag and drop content between Spaces. When dragging and dropping content to the target folder, do not drag the source folder to the target; drag and drop only the content that is stored under the folder. If you do not know the WebDAV URL for the Oracle Content Server that is used to store documents, contact your Fusion Middleware Administrator. If the base URL for that Oracle Content Server is http://host:port/relative_web_root, the WebDAV root URL will be http://host:port/relative_web_root/idcplg/webdav. For example: http://wchost:16200/dav/cs/idcplg/webdav/

- Use the Batch Loader utility, as described in "Batchloading Content" in Oracle Fusion Middleware System Administrator's Guide for Oracle Content Server.

To upload up to ten files at a time:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, navigate to the folder for the documents you plan to upload or create a new folder (see Section 41.7, "Creating a Folder").

2. Click the Upload action (Figure 41-43).

Figure 41-43 Upload Action

The Upload Document pane opens (Figure 41-44), providing fields for up to five files by default.

Figure 41-44 Upload Document Screen

Note:

To enable the Upload Profiles functionality, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

3. From the Upload Profiles list (see Note above):

- Leave the default selection as <None> (Figure 41-44) to upload files without an associated content profile.

- Alternatively, select a content profile (defined in Oracle Content Server) for the document(s) you want to upload (Figure 41-45). Selecting a content profile enforces uniformity by requiring values for certain metadata fields that must be provided before the file can be uploaded. For example, a press release profile might include fields about who to contact, release date, and so on.

Note:

For information about creating content profiles in Oracle Content Server, refer to "Managing Content Profiles" in Oracle Fusion Middleware Application Administrator's Guide for Content Server.

Figure 41-45 Selecting Content Type for Document(s)

The Profile Upload pane displays the metadata fields for the selected content profile (Figure 41-46).

Figure 41-46 Content Profile Metadata Fields

4. If you selected a content profile, enter metadata field values to associate with the file(s) you want to upload, then click Check In.

Note:

Oracle Content Server may require certain mandatory metadata field values for a selected content profile to ensure a successful checkin. Mandatory fields are identified in the dialog by an asterisk and red text.

For information about content profile metadata field requirements for Oracle Content Server, refer to Oracle Fusion Middleware User's Guide for Oracle Content Server, specifically the chapter "Checking In Files". The fields described in the "Content Check-In Form" section in the appendix are mandatory for Oracle Content Server. All content profiles must include them, otherwise the checkin will fail.

In addition to the mandatory metadata field values required by Oracle Content Server for specific content profiles, every content profile must include additional metadata fields required by WebCenter Spaces. For a list and descriptions of the required fields, which should be added to a content profile as hidden fields so that the end user cannot override the values populated by WebCenter Spaces, see "What You Should Know About Creating Content Profiles in Oracle Content Server" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

5. For each file you want to upload:

- Click Browse next to the Document to Upload field, and then navigate to and select the file you want to upload.

- Optionally, provide a description of the file in the Description field.

Accessiblity Note:

If you press the Enter key to select Browse, you may encounter unexpected results:

- In Internet Explorer 7, this action opens the File Upload dialog to select a file as expected, but when you select Upload, an error message displays "Please verify your upload data" and the selected file is removed from the Document to Upload field.

- In Firefox: This action has no effect.

As a workaround in both Internet Explorer 7 and Firefox, press the space bar to select Browse.

6. Click More to add more files, up to a maximum of ten files.

7. Click Upload to add the specified files at the same level as the currently selected file, or under the currently selected folder.

If a file with the same name already exists in the target folder, the Resolve Name Conflict pane opens (Figure 41-47).

Figure 41-47 Resolve Name Conflict Pane

If the file is already checked out to another user, the pane displays the message This file is checked-out to another user.

Select the desired action:

- Ignore this file to cancel the upload operation for the current file. This is useful when uploading multiple files to skip only the current file, and continue to upload subsequent files in the batch.

- Create a new version of the existing file to create a new version of the file. See Section 41.21, "Viewing and Deleting File Version History."

If the file is already checked out to another user, this selection is disabled.

Note:

If the connected content repository does not support versioning, this selection is Overwrite the existing file to replace the existing file with the new file.

If you do not have the permissions required to create a new version or overwrite the file, this selection is disabled.

- Use another name for the uploaded file to display a Name field where you can enter a new name for the file. If you specify a name that matches another existing file, a message notifies you to enter a different name.

41.8.2 Creating a Wiki Document

In addition to uploading files (see Section 41.8.1, "Uploading New Files") to the connected content repository, you can create wiki documents using either of the following two methods

- New Wiki Document action through Documents service task flows, as described in Section 47.2.2, "Creating a Wiki Document Using the New Wiki Document Action"

- Wiki page syle, as described in Section 47.2.3, "Creating a Wiki Document Using the Wiki Page Style"

For more information about wiki documents in WebCenter Spaces, see Chapter 47, "Working with Wiki Documents."

41.9 Opening a Folder

You can open a folder to display its contents in all Documents service task flows except the Recent Documents task flow, which does not display folders.

Note:

Other methods to open folders when the backend content repository is Oracle Content Server are:

- Create a network place to a Space, then use Windows Explorer to open folders and files, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

- Use the task pane available through Microsoft Office shared document management functionality to open folders in a Space, as described in Section 46.3.4.7, "Managing Folders"

To open a folder to display its contents and make it the top-level folder:

- On the Documents page or in a Documents service task flow, either:

- Click the folder name.

- Or, right-click in the folder's row to display the folder context menu (Figure 41-36) and choose Open.

41.10 Opening a File

With appropriate permissions, you can open files of any type in all Documents service task flows to preview file contents or properties in a read-only view.

The Document Explorer, Document Manager, and Folder Viewer task flows open files in-place in a Document Viewer preview pane; the Document List Viewer and Recent Documents task flows open files in a separate Document Viewer preview window.

Note:

Another method to open files when the backend content repository is Oracle Content Server is:

- Create a network place to a Space, then use Windows Explorer to open folders and files, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

To open a read-only view of a file:

- On the Documents page or in a Documents service task flow, click the file name to open the file in-place in a Document Viewer preview pane or in a separate Document Viewer window.

Note:

Some file types do not support a preview. An attempt to open such a file displays the properties of the file in the Document Viewer.

The appearance of the file in the preview pane or window depends on the file type:

- For files that support PDF format: The file displays either in an in-place PDF viewer (Figure 41-48) or in a slide viewer (Figure 41-49).

Figure 41-48 File Preview in PDF Viewer

Note:

To enable the slide preview functionality, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Figure 41-49 File Preview in Slide Viewer (see Note)

- For HTML, text, image, XML files: In the preview pane or window, click the View menu and choose Open in Browser to open the file in your default browser application.

- For any file type for which Oracle Content Server is configured to convert to PDF: In the preview pane or window, click the View menu and choose Open as PDF to open a PDF version of the file.

To edit files, see Section 41.12, "Editing and Updating a File".

41.11 Using the Rich Text Editor (RTE)

The Rich Text Editor (RTE) is a fully-integrated HTML text editor, which you can use to create new wiki documents (Figure 41-50) and edit wiki documents, blog posts, and HTML files in the content repository (Figure 41-51).

Figure 41-50 New Wiki Document in Rich Text Editor

Figure 41-51 Editing HTML File in Rich Text Editor

Table 41-4 describes the RTE toolbar icons and controls:

Table 41-4 Rich Text Editor Toolbar Icons and Controls

Control

Description

Print or Preview. Click to print the file or preview it in your default browser.

Spell Check As You Type. Click to enable the SCAYT spelling checker, and set options, languages, and dictionaries for checking spelling in the document.

Undo or Redo. Click to back out or restore the previous change. Change history is cleared when you click Create or Save.

Cut, Copy, or Paste. Select text, then click the desired icon to cut or copy selected text, or paste text in the buffer at the current cursor location.

Paste as plain text. Click to open a text box where you can press Ctrl-v to paste any text currently in the buffer, then click OK to insert the text, unformatted, into the RTE at the current cursor location.

Paste from Word. Click to open a text box where you can press Ctrl-v to paste text from Microsoft Word, then click OK to insert the text, with formatting maintained, into the RTE at the current cursor location.

Select mode. Select an editing mode, described in Step 3 below.

Wiki Markup Help. Active only in Wiki Markup mode, click to view examples of wiki markup.

Maximize/Minimize. Click to expand the RTE to fill the entire screen, or reduce the RTE to display inside the WebCenter Spaces application.

Find. Click to open the Find and Replace dialog, where you can search for a string, or replace a given string with specified text.

Image. Click to open the Image Properties dialog:

- To add an image in-place at the current cursor location: On the Image Info tab, enter the URL where the image is located, alt text, sizing, and choose alignment for the image.

- To add a link to an image at the current cursor location: On the Link tab, enter the URL where the image is saved, and choose from the Target list how the image displays when the link is clicked in the document.

- On the Advanced tab, specify additional image attributes.

- Click OK to add the image or image link to the document.

Note: To insert an image saved in the content repository, use the Embed Image icon.

Table. Click to open the Table Properties dialog, where you can specify the number of rows and columns, sizing, spacing, alignment, caption, and summary for a table. Click OK to insert the table into the document.

Insert Horizontal Line. Click to insert a horizontal line at the current cursor location.

Link. Select text to convert into a link, then click this icon to open the Link dialog:

- On the Link Info tab, choose a Link Type:

URL. Enter a URL to be linked from the selected text.

Link to anchor in the text. Choose an anchor name or ID from the dropdown lists to be linked from the selected text. Note: create target anchors in HTML Source mode; for example: <a name="setup" id="setup"></a>

E-mail. Enter a mail address, subject, and body to be linked from the selected text. Clicking the link in the document opens the mail message in the default mail application.

- On the Advanced tab, specify additional link attributes.

- Click OK to add the link to the document.

Unlink. Select linked text, then click this icon to remove the link from the text.

Select Resource. Select text to link to an existing WebCenter resource, then click this icon to open the Select Resource dialog. Select a resource (for example, a document or an announcement) in the current Space to be linked from the selected text. Clicking the linked text in the document opens the selected resource in the Document Viewer preview pane.

New Resource. Select text to link to a new WebCenter resource, then click this icon to open the New Resource dialog. Select a resource to be linked from the selected text, then create the resource (for example, a note or announcement), specify the external location of the resource (for example, a URL), specify the name of the resource (for example, a wiki document), or upload the resource from your local file system or a connected network drive (for example, a document). For information about creating links to resources in WebCenter Spaces, see Chapter 63, "Working with the Links Service."

Note: If you create a new wiki document in this manner, WebCenter Spaces creates a placeholder for the new wiki document in the current folder. To add content to the new wiki document, you must navigate to it and open it in the RTE.

Embed Image. Click to open the Embed Image dialog:

- Click Select Image to select an image in the current Space.

- Click Upload Image to upload an image from your local file system or a connected network drive.

Note: To insert an image available at a URL location, use the Image icon.

Paragraph Format. Select a format, then enter text; or highlight text, then select a format.

Font Name. Select a font, then enter text; or highlight text, then select a font.

Font Size. Select a size, then enter text; or highlight text, then select a size.

Bold, Italic, Underline, and Strike Through. Select text, and click the desired font style icon; or click an icon, and enter text. Click the icon again to exit the font style.

Left Justify, Right Justify, Center Justify, and Block Justify. Select text, and click to apply the desired text alignment; or click an icon, and enter text.

Numbered List and Bulleted List. Start a new line, click the desired list type icon, and enter text. Or, select lines of text and click an icon. Click the icon again to remove the list formatting. Alternately, end list mode by pressing Enter twice after the last item.

Decrease Indent and Increase Indent. Select text, and click the desired indent icon to move text left or right.

Snippet. In a blog post, select a portion of text, then click this icon to display that portion as a summary of the blog post on the blog summary page (or digest page), with a Read More link to allow users to view the full blog. In a wiki document, this functionality is not available.

Text Color or Background Color. Select text, and click the desired text or background color icon, then select a color. Or, click an icon and select a color, then enter text.

Remove Format. Select text, and click this icon to remove all font styling, such as font types, sizes, weights, and colors. Lists and indents are not affected.

Ctrl-x

Use this key combination to cut highlighted selections to the clipboard.

Ctrl-c

Use this key combination to copy highlighted selections to the clipboard.

Ctrl-v

Use this key combination to paste the content on the clipboard at the current cursor location.

To use the RTE:

1. Open the RTE either by creating a new wiki document (see Section 41.8.2, "Creating a Wiki Document") or editing a wiki, blog, or HTML file (see Section 41.12.3, "Editing Files In-Place").

Fields that require a value are marked with an asterisk (*).

2. For a new wiki document, enter the wiki name in the Title field.

3. From the Mode list, choose the desired editing mode:

Figure 41-52 Rich Text Editor (RTE) Mode Selection

- WYSIWYG: Create and revise content in a WYSIWYG environment using the icons and controls in the RTE toolbar.

- HTML Source: Enter your own HTML manually. This includes entering source code for HTML not handled by the WYSIWYG icons. In this mode, most icons and controls in the RTE toolbar are not available.

- Wiki Markup: Enter your own wiki markup. For examples of wiki markup, click the Wiki Markup Help icon.

Note:

The RTE ignores the following types of tags when entered in HTML Source mode because they are irrelevant or redundant within the RTE context:

- script tags

- form elements, such as input, select, textarea, and form

- frame/frameset

- document tags, such as html, head, body, meta, and title

- unknown tags; for example: <foo></foo>

4. Add or revise text, formatting, styling, and links using the methods available in the selected Mode.

5. When editing a file, click the Major Edit? checkbox to update the Activity Stream and send a notification to other Space members with access to the file of your updates. The notification is sent after you save your changes.

6. Create or update the file:

- To create and save a new wiki document, click Create.

- To save updates to an existing wiki, blog, or HTML file, click Save and Close.

41.12 Editing and Updating a File

In a Documents service task flow or in the Document Viewer preview pane, you can check a file out, download it to your local file system for editing, edit a file in-place, or upload a new version of an existing file. The actions available to you depend on the file type:

- For all file types except wiki documents, check the file out to lock it from being updated by other users.

- For all file types, download the file to your local file system for saving or editing locally.

- For wiki and HTML documents, edit the file in-place using the Rich Text Editor (RTE).

- For all file types except wiki documents, upload a new version of the file.

The following sections provide more information:

- Section 41.12.1, "Checking a File Out"

- Section 41.12.2, "Downloading a File"

- Section 41.12.3, "Editing Files In-Place"

- Section 41.12.4, "Uploading a New Version of an Existing File"

41.12.1 Checking a File Out

When you want to retain exclusive use of a file—for example, when you're editing it on your local machine, or need to prevent other users from modifying it—you must check the file out. Other WebCenter Spaces users can view the file, but they cannot upload a file of the same name into the same folder while the file is checked out.

Note:

When you edit a file in-place (see Section 41.12.3, "Editing Files In-Place"), it is automatically checked out of the content repository. When you save it, it is automatically checked back in.

When you're ready to release the file, you can either check the file back in, or cancel file check out. Checking a file back in involves uploading the revised file (see Section 41.12.4, "Uploading a New Version of an Existing File"). Cancelling check out removes the file's checked out status without requiring a file upload.

Note:

To use the task pane available through the Microsoft Office shared document management functionality to check a Microsoft Word, Excel, or PowerPoint file out or in when the backend content repository is Oracle Content Server, see Section 46.3.4.3, "Checking a File Out" and Section 46.3.4.4, "Checking a File In"

To check a file out:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file you want to check out.

Alternatively, you can check out an open file in the Document Viewer preview pane.

Note:

File check out is not available for wiki documents. In-place editing is the optimal way to update wiki documents, as described in Section 41.12.3, "Editing Files In-Place."

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the File menu and choose Check Out, or right-click to display the file's context menu (Figure 41-37) and choose Check Out.

- In the Document Viewer preview pane, click the File menu and choose Check Out.

3. On the Documents page or in a Documents service task flow, click the View menu and choose Refresh Content to confirm that the Checked Out (padlock) icon appears in the file's Checked Out column:

- Roll your mouse pointer over the icon to see details about the user who has checked the file out.

- Click the icon to expose actions to upload a new version of the file, or cancel the checkout (Figure 41-53).

Figure 41-53 Checked Out Icon with Details

To cancel the checked out status of a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file.

Alternatively, you can cancel the checked out status of an open file in the Document Viewer preview pane.

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the Checked Out (padlock) icon in the file's row and choose Cancel Check Out (Figure 41-53), click the File menu and choose Cancel Check Out, or right-click to display the file's context menu (Figure 41-37) and choose Cancel Check Out.

- In the Document Viewer preview pane, click the Cancel Check Out action.

3. On the Documents page or in a Documents service task flow, click the View menu and choose Refresh Content to confirm that the Checked Out (padlock) icon no longer appears in the file's Checked Out column.

41.12.2 Downloading a File

When you want to save a file to your local file system, you can download it from the content repository.

To download a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file you want to download to your local file system.

Alternatively, you can download an open file in the Document Viewer preview pane.

2. Depending on your view and the file type, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the Download action, or right-click to display the file's context menu (Figure 41-37) and choose Download.

- In the Document Viewer preview pane, click the Download action.

- (For any file type for which Oracle Content Server is configured to convert to PDF) In the Document Viewer preview pane, click the View menu and choose Download PDF to save a PDF version of the open file to your local file system.

3. In the Open/Save dialog, select Save File to open the Save dialog, where you can navigate to the folder in which to save the file.

41.12.3 Editing Files In-Place

With appropriate permissions, end users can directly edit the following types of files in-place:

- Wiki documents

- Blog posts

- HTML files

- Microsoft Office 2003 or higher files (Word, Excel, PowerPoint)

Note:

If you are using Windows 7 or a 64-bit machine with Firefox 3.6, you may need to install the Java plugin available at http://support.mozilla.com to edit a Microsoft Office file. This plugin is included in Java 6 Update 15 and above.

In-place editing refers to editing content directly in a WebCenter Spaces application at runtime, where the editor opens in the document preview pane. When you edit a file in-place, it is automatically checked out of the content repository. When you save it, it is automatically checked back in.

To edit HTML and Site Studio files that display in a Content Presenter task flow, see Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow."

To edit a file in-place:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file you want to edit, but not on the file name.

Alternatively, you can edit an open file in the Document Viewer preview pane.

2. Depending on your view and the file type, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the File menu and choose Edit, or right-click to display the file's context menu (Figure 41-37) and choose Edit.

- In the Document Viewer preview pane, click the Edit action.

Note:

If the file is already checked out by another user, the File in Use dialog opens. See Section 41.12.3.1, "Opening a File Already Checked Out By Another User."

The file opens in the appropriate editor:

- Wiki documents, blog posts, and HTML files open in-place in the Rich Text Editor (RTE). For information about the RTE, see Section 41.11, "Using the Rich Text Editor (RTE)."

- Microsoft Office (Word, Excel, PowerPoint) files may first display a confirmation prompt, then an authentication dialog. Use the same credentials used to log in to WebCenter Spaces to open the file in-place in its corresponding application.

Note:

The user name and password must contain only ASCII characters. A user name or password containing multi-byte characters cannot be successfully authenticated.

To configure Microsoft Office integration with WebCenter Spaces, see Chapter 46, "Configuring Microsoft Office Integration with WebCenter Spaces." To work with Microsoft Office files using the Microsoft Office shared document functionality, see Chapter 46, "Working with Microsoft Word, PowerPoint, and Excel Integration."

3. When the file opens, it is automatically checked out. In WebCenter Spaces, click the Refresh icon to show the Checked Out icon for the selected file (Figure 41-54).

Figure 41-54 Checked Out Icon in WebCenter Spaces

4. Make required updates, then save and close the file.

The modified file is automatically checked back in.

41.12.3.1 Opening a File Already Checked Out By Another User

If the file that you attempt to open is already checked out by another user, the File In Use dialog opens (Figure 41-55).

Figure 41-55 File in Use Dialog

In the File In Use dialog, select the desired option:

- Open a Read Only copy to open the file in its default application to view it.

- Create a local copy and merge your changes later is not supported.

- Receive notification when the original copy is available to open a read-only copy of the file until it is available for editing. When the file is available, the File Now Available dialog (Figure 41-56) notifies you; in the dialog, click Read-Write to change the read-only state to editable.

Figure 41-56 File Now Available Dialog

41.12.4 Uploading a New Version of an Existing File

If you have write permissions on the current file, you can replace the file with a new version that you have saved on your local file system, specifying the name of the file that contains the changed content.

To upload a new version of a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file you want to replace.

Alternatively, you can upload a new version of an open file in the Document Viewer preview pane.

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the Checked Out (padlock) icon in the file's row and choose Upload New Version (Figure 41-53). click the File menu and choose Upload New Version, or right-click to display the file's context menu (Figure 41-37) and choose Upload New Version.

- In the Document Viewer preview pane, click the Upload New Version action.

The Upload New Version pane opens (Figure 41-57).

Figure 41-57 Upload New Version Pane

3. In the Document to Upload field, enter or browse to the new version of the document.

4. If the original version of the document is associated with a content profile, the Profile Upload screen displays the metadata fields for the selected profile.

Note:

To enable the Upload Profiles functionality, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Change metadata fields values if necessary for the new version of the document, then click Check In.

Note:

Oracle Content Server may require certain mandatory metadata field values for a selected content profile to ensure a successful checkin. Mandatory fields are identified in the dialog by an asterisk and red text.

For information about content profile metadata field requirements for Oracle Content Server, refer to Oracle Fusion Middleware User's Guide for Oracle Content Server, specifically the chapter "Checking In Files". The fields described in the "Content Check-In Form" section in the appendix are mandatory for Oracle Content Server. All content profiles must include them, otherwise the checkin will fail.

In addition to the mandatory metadata field values required by Oracle Content Server for specific content profiles, every content profile must include additional metadata fields required by WebCenter Spaces. For a list and descriptions of the required fields, which should be added to a content profile as hidden fields so that the end user cannot override the values populated by WebCenter Spaces, see "What You Should Know About Creating Content Profiles in Oracle Content Server" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

5. In the Upload New Version pane, click Upload.

The file is uploaded and checked in with the revised content. For information about viewing versions of a file, see Section 41.21, "Viewing and Deleting File Version History."

41.13 Renaming a Folder or File

In a Documents service task flow, you can rename a folder or file as described in the following sections:

- Section 41.13.1, "Renaming a Folder or File Using a Menu"

- Section 41.13.2, "Renaming a File and Revising Its Description Through Properties"

Note:

To use Windows Explorer to rename folders and files in a Space when the backend content repository is Oracle Content Server, see Section 46.4.2, "Working with Files Using Windows Explorer."

41.13.1 Renaming a Folder or File Using a Menu

To rename a folder or file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the folder or file you want to rename.

2. Click the File menu and choose Rename, or right-click in the folder or file's row to display the context menu (Figure 41-36 and Figure 41-37) and choose Rename.

The Rename Folder or Rename Document dialog opens (Figure 41-58).

Figure 41-58 Rename Document Dialog

3. In the Name field, enter a new folder or file name.

4. Click Rename.

41.13.2 Renaming a File and Revising Its Description Through Properties

To rename a file or revise its description through its properties, see Section 41.22, "Viewing and Modifying Folder and File Properties."

41.14 Copying and Pasting Folders and Files

In a Documents service task flow, you can copy and paste folders and files in the following ways:

- Use menu actions as described in the steps below.

- Drag and drop into a target folder while pressing the Ctrl key. You can even drag and drop into another Documents service task flow on the same page as long as both task flows are connected to the same content repository.

- Download a file to your local file system, as described in Section 41.12.2, "Downloading a File."

To copy one or more folders (including all of its subfolders and files) or files using menu actions:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the folder(s) or file(s) you want to copy.

To select multiple folders or files, Ctrl-click in the rows.

2. Click the File menu and choose Copy, or right-click to display the context menu (Figure 41-36 and Figure 41-37) and choose Copy.

3. Navigate to the folder where you want to paste the copied folder(s) or file(s).

You can also navigate to a folder in another Documents service task flow on the same or a different page as long as both task flows are connected to the same content repository.

4. Click the File menu and choose Paste, or right-click to display the folder's context menu (Figure 41-36) and choose Paste.

If you are copying into another Documents service task flow, you may need to refresh the target folder if the Paste menu action is not active (see Section 41.17, "Refreshing Folder Contents").

The selected folder(s) and file(s) are copied to the current folder.

Note:

If a folder or file is deleted at the source location before pasting, it will not be copied to the paste location.

41.15 Moving Folders and Files

In a Documents service task flow, you can move folders and files in the following ways:

- Use the menu actions as described in the steps below.

- Drag and drop into a target folder. You can even drag and drop into another Documents service task flow on the same page as long as both task flows are connected to the same content repository.

Note:

To use Windows Explorer to move folders and files in a Space when the backend content repository is Oracle Content Server, see Section 46.4.2, "Working with Files Using Windows Explorer."

To move one or more folders (including all of its subfolders and files) or files using menu actions:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the folder(s) or file(s) you want to move.

To select multiple folders or files, Ctrl-click in the rows.

2. Click the File menu and choose Cut, or right-click to display the context menu (Figure 41-36 and Figure 41-37) and choose Cut.

3. Navigate to the folder where you want to move the folder(s) or file(s).

You can also navigate to a folder in another Documents service task flow on the same or a different page as long as both task flows are connected to the same content repository

4. Click the File menu and choose Paste, or right-click to display the folder's context menu (Figure 41-36) and choose Paste.

If you are moving folders or files into another Documents service task flow, you may need to refresh the target folder if the Paste menu action is not active (see Section 41.17, "Refreshing Folder Contents").

The selected folder(s) and file(s) are moved to the current folder.

Note:

If you do not paste the cut folder(s) or file(s), they are restored to the location where they were cut. If a folder or file is deleted at the source location before pasting, it will not be moved to the paste location.

41.16 Deleting Folders and Files

When you delete a folder, all the subfolders and files the folder contains are also deleted in the content repository.

Note:

The root folder of the task flow cannot be deleted.

Note:

To use Windows Explorer to move folders and files in a Space when the backend content repository is Oracle Content Server, see Section 46.4.2, "Working with Files Using Windows Explorer."

To delete one or more folders or files:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the folder(s) or file(s) you want to delete.

To select multiple folders or files, Ctrl-click in the rows.

2. Click the File menu and choose Delete, or right-click to display the context menu (Figure 41-36 and Figure 41-37) and choose Delete.

The Delete dialog opens (Figure 41-59).

Figure 41-59 Deleting a File

3. Click Delete to delete your selection from the content repository.

41.17 Refreshing Folder Contents

Refreshing the contents of the current folder retrieves all changes made in the content repository since the last retrieval.

To refresh folder contents:

- On the Documents page or in a Document Explorer, Document Manager, or Folder Viewer task flow, click the View menu and choose Refresh Content.

- In the Document List Viewer task flow, click the Refresh icon.

41.18 Hiding and Showing Folders

To hide or show the folders in a listing of folders and files:

- On the Documents page or in a Document Explorer, Document Manager, or Folder Viewer task flow, click the View menu and choose Hide Folders.

When folders are hidden, a checkmark displays alongside the Hide Folders menu selection.

41.19 Working with Related Items (Tags, Links, and Recommendations)

You can associate the following information with a file, categorized under Related Items:

- Tags specify keywords related to the content of the file. Tags are useful for making a file more widely discoverable in search results.

- Links provide a way to view, access, and associate related information by linking to another document, note, or URL. For example, you can create a link to associate a project plan document with a list of project issues.

- Recommendations shows suggestions of other documents you might want to view, based on the current document.

Note:

The Recommendations section displays in the Related Items pane only if the Activity Graph service is configured in your application. For more information, see "Activity Graph service Prerequisites" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To work with the tags, links, or recommendations for a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file.

Alternatively, you can view related items of an open file in the Document Viewer preview pane.

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the View menu and choose Related Items, or right-click to display the file's context menu (Figure 41-37) and choose Related Items.

- In the Document Viewer preview pane, click the View menu and choose Related Items, or simply click the Related Items icon (Figure 41-60).

Figure 41-60 Related Items Icon

The Document Viewer preview pane displays the Related Items pane on the right, with Tags, Links, and Recommendations (if configured) sections (Figure 41-61).

Figure 41-61 Related Items Pane

3. View and update the Related Items sections as described in the following sections:

- Section 41.19.1, "Working with Tags"

- Section 41.19.2, "Working with Links"

- Section 41.19.3, "Working with Recommendations"

41.19.1 Working with Tags

Tags specify keywords related to the content of the file. Tags are useful for making a file more widely discoverable in search results.

In the Tags section of the Related Items pane:

- In the input area, enter new tags, and edit or delete existing tags, then click Save.

See Also:

For information about tags in WebCenter Spaces, see Chapter 57, "Working with the Tags Service."

41.19.2 Working with Links

Links provide a way to view, access, and associate related information by linking to another document, note, or URL. For example, you can create a link to associate a project plan document with a list of project issues.

In the Links section of the Related Items pane:

1. To create a link to a new document, note, or URL, click Link to New, then choose the required item (Figure 41-62).

Figure 41-62 Adding a Link to a New Document, Note, or URL

2. To create a link to an existing document, click Link to Existing, then choose Document (Figure 41-63).

Figure 41-63 Adding a Link to an Existing Document

See Also:

For information about creating links in WebCenter Spaces, see Chapter 63, "Working with the Links Service."

41.19.3 Working with Recommendations

Note:

The Recommendations section displays in the Related Items pane only if the Activity Graph service is configured in your application. For more information, see "Activity Graph service Prerequisites" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

The Recommendations section provides suggestions of other documents you might want to view, based on the current document. This list uses the Similar Items task flow of the Activity Graph service. For more information, see Section 58.2.4, "Working with the Similar Items Task Flow."

In the Recommendations section of the Related Items pane:

- Click the Display Options icon (Figure 41-64) to open the Display Options dialog (Figure 41-65), where you can select the items you want to show in the Recommendations section.

Figure 41-64 Recommendations Display Options Icon

Figure 41-65 Display Options for Recommendations

- In the Recommendations section of the Related Items pane:

- Click the Delete icon to delete the associated recommendation.

- Click the link text for each recommendation to view that document.

- Click the Refresh icon to display the most recent recommendations.

See Also:

For more information about working with recommendations, see Chapter 58, "Working with the Activity Graph Service."

41.20 Viewing, Entering, and Deleting Comments on a File

You can associate comments with a file to provide additional information that you want to convey to other users about the file.

Note:

Users viewing a public document are not given the ability to comment on the document.

To view, enter, or delete comments on a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file.

Alternatively, you can view comments for an open file in the Document Viewer preview pane.

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, open the Comments pane in any of the following ways:

- Click the View menu and choose Comments.

- Right-click to display the file's context menu (Figure 41-37) and choose Comments.

- Click the value in the Comments column (Figure 41-66) for the file. This value indicates the number of comments that have been entered for each file.

Figure 41-66 Comments Column in Documents Service Task Flow

- In the Document Viewer preview pane, click the View menu and choose Comments, or simply click the Comments icon (Figure 41-67).

Figure 41-67 Comments Icon and Comment Count

The Document Viewer preview pane displays the Comments pane on the right (Figure 41-68), where you can view existing comments on the current file.

Figure 41-68 Comments Pane

3. To add a comment, enter it in the input area, then click Comment.

4. To delete a prior comment that you have entered, click the red Delete icon beneath the comment (Figure 41-69).

Figure 41-69 Deleting a Comment

41.21 Viewing and Deleting File Version History

Whenever you check in a file or upload a file into a folder that already contains a file of the same name, WebCenter Spaces creates a new version of the file. When a file has multiple versions, it has a version history.

This section describes how to view a file's version history to track when a file was last revised, to determine which user revised it, and to delete a particular file version. For wiki documents and blog posts, you can also compare versions.

Note:

To use the the task pane available through Microsoft Office shared document management functionality to work with a Microsoft Word, Excel, or PowerPoint file's version history, see Section 46.3.4.10, "Working with File Version History."

To view or delete versions of a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file.

Alternatively, you can view comments for an open file in the Document Viewer preview pane.

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the View menu and choose Version History, or right-click to display the file's context menu (Figure 41-37) and choose Version History.

- In the Document Viewer preview pane, click the View menu and choose Version History, or simply click the Version History icon (Figure 41-70).

Figure 41-70 Version History Icon and Version Count

The Document Viewer preview pane displays the History pane on the right (Figure 41-61).

Figure 41-71 History Pane

3. Select a version of the file to display a preview of that version in the preview pane.

4. To delete a particular version, select it in the History pane, then click Delete (Figure 41-72).

Note:

The Delete icon displays only if you have been granted delete permissions.

Figure 41-72 Delete Button on the Version History Screen

5. (For wiki documents and blog posts only) To compare a particular version with the current version of the file, select it in the History pane, then click Compare to open the Compare Versions dialog, showing the differences (Figure 41-73).

Figure 41-73 Comparing Older Version with Current Version (Wiki or Blog)

41.22 Viewing and Modifying Folder and File Properties

Folder and file properties provide access to informational details. You can use file properties to perform activities such as rename a file, provide or revise a file description, or obtain a reusable link to the file.

Additionally, both folder and file properties provide read-only information about location, type, and creation and modification dates. Folder and file properties also provide contact information for the users who created or last modified the folder or file.

To access folder or file properties, refer to the steps in the following sections:

- Section 41.22.1, "Working with Folder Properties"

- Section 41.22.2, "Working with File Properties"

41.22.1 Working with Folder Properties

To view or modify folder properties:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the folder.

2. Click the View menu and choose Properties, or right-click to display the context menu (Figure 41-36) and choose Properties.

The Basic properties pane opens (Figure 41-74).

Figure 41-74 Folder Properties

41.22.2 Working with File Properties

To view or modify file properties:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the file.

Alternatively, you can view properties of an open file in the Document Viewer preview pane.

2. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click the View menu and choose Properties, or right-click to display the context menu (Figure 41-37) and choose Properties.

- In the Document Viewer preview pane, click the View menu and choose Properties, or simply click the Properties icon (Figure 41-75).

Figure 41-75 Properties Icon

A preview of the file opens, showing the Properties pane on the right (Figure 41-76).

Figure 41-76 Properties Pane

3. To modify the editable Basic properties, click Edit in the Basic properties area. In the Edit dialog (Figure 41-77), revise the file name and description as desired, then click Save.

Figure 41-77 Edit Dialog for Basic Properties

4. To modify the editable Advanced properties, click Edit in the Advanced properties area. In the Edit dialog (Figure 41-78), revise the property values as desired, then click Save.

Note:

To enable Edit functionality on Advanced properties, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Figure 41-78 Advanced Properties Edit Dialog

Note:

Most advanced properties are unique to the content repository (such as Oracle Content Server) where the file is stored.

41.23 Opening or Saving PDF Files

From the Document Viewer preview pane, you can open or save the PDF version of the currently open file to your local file system. This choice is available for any file type for which Oracle Content Server is configured to convert to PDF.

To open or save a file in PDF:

- In the Document Viewer preview pane, click the View menu and choose:

- Open as PDF to open the file in a new tab in your browser in Adobe Acrobat Reader's PDF Viewer plug-in.

- Download PDF to open a browser dialog where you can save the file to your local file system as a PDF file.

41.24 Sharing the URL for a Folder or File

With appropriate permissions, users can directly access folders and files by clicking the URL, or entering it in a browser. You can retrieve and share the URL to a folder or file in several ways, as described in the following sections:

- Section 41.24.1, "Retrieving the URL for a Folder or File"

- Section 41.24.2, "Mailing the URL for a File"

- Section 41.24.3, "Publishing the URL for a File to Activity Streams"

41.24.1 Retrieving the URL for a Folder or File

Every folder and file that resides in a connected content repository can be accessed through a direct URL, which you can provide to other users. If they have permissions to access the folder or file, they can click the URL link to open the folder or file directly in a WebCenter application, open the file in its default application, or save the file to their local file system.

To retrieve the URL for a folder or file:

1. Open the Get a Link dialog in any of the following ways:

- On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click in the row of the folder or file, then click the View menu and choose Get a Link.

- Right-click in the folder or file's row to display the context menu (Figure 41-36 and Figure 41-37) and choose Get a Link.

- If you are already viewing a file in the Document Viewer preview pane, click the View menu and choose Get a Link.

The Direct URL provides a direct link to open the folder or file in WebCenter application. For files, the Download URL provides a direct link to allow users to open the file in its default application, or choose to save the file to their local file system (Figure 41-79).

Figure 41-79 Clicking Download URL Value in Get a Link Dialog

2. Drag your mouse pointer over the URL to select it, then press Ctrl-c to copy it so that you can paste it wherever you need it.

41.24.2 Mailing the URL for a File

From the Document Viewer preview pane, you can send a mail message to other users with the body of the message populated with the direct URL to the currently open file. If the file is in a Space, the direct URL to the Space is also included.

Note:

To use the task pane available through the Microsoft Office shared document management functionality to send a message to any user who has a mail address defined in WebCenter Spaces, see Section 46.3.4.12, "Sending a Message."

To send the URL to file in a mail message:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click the file to open it in the Document Viewer preview pane.

2. In the Document Viewer preview pane, click the File menu and choose Send Mail.

Your mail application opens a compose window, populated with the direct URL to the current Space if applicable, and a direct URL the currently open file.

3. Modify the mail message as desired, and send it.

41.24.3 Publishing the URL for a File to Activity Streams

From the Document Viewer preview pane, you can publish the URL for the currently open file to an activity stream for all users or groups who have permissions to access to the file.

To publish a file's URL to an activity stream:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click the file to open it in the Document Viewer preview pane.

2. In the Document Viewer preview pane, click the File menu and choose Share.

The Share dialog opens (Figure 41-80).

Figure 41-80 Share Dialog

3. Optionally, enter a comment to appear with the URL.

4. Click Publish.

The URL to the file is added to the activity stream for all users or groups who have permission to access the file, along with your comments, if any.

41.25 Setting Security Options on a Folder or File

Security can set be on a folder or a file through inheritance from the parent folder, or by setting custom permissions. If set on a folder, the security is propagated to child files and folders that do not already have their own custom permissions defined. A child file or folder (at any depth) that already has custom permissions defined will retain that security definition.

To set security options on a folder or file:

1. Verify that the WebCenter Spaces administrator has completed the prerequisite steps before setting security options on folder or file, as described in "Configuring Item Level Security between Oracle Content Server 11g and WebCenter Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

2. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow:

- To set security on a folder, click in the folder's row, then click the View menu, and choose Properties.

- To set security on a file, click the file to open it in the Document Viewer preview pane.

3. Click the File menu and choose Security.

The Security Settings dialog opens (Figure 41-81).

Figure 41-81 Security Settings Dialog

4. Select the Access Method:

- To specify that the folder or file should inherit access settings from the parent folder, select Inherit Parent Folder Permissions, then click OK to save your changes and exit the dialog.

- To set custom access on the current folder or file, select Use Custom Permissions, and continue with the next steps.

5. To grant access permissions to all authenticated users (that is, to users who are logged in to WebCenter Spaces), click the Add Authenticated Role for Logged in User Access icon (Figure 41-82).

Figure 41-82 Add Authenticated Role for Logged in User Access Icon

The role authenticated-role is added under Role or User with default Read access to the folder or file.

6. To grant access permissions to all public users (that is, users who have not logged in to WebCenter Spaces), click the Add Anonymous Role for Public Access (Figure 41-83).

Figure 41-83 Add Anonymous Role for: Access Icon

The role anonymous-role is added under Role or User with default Read access to the file.

7. To grant access permissions to selected users or groups, click Add Users or Add Groups to open the corresponding Search dialog where you can select users or groups to populate the list in the Security Settings dialog.

8. For each user, group, or role, grant access by selecting one or more access privileges from the Access columns: Administer, Delete, Write, and Read.

9. Click OK to save your changes and close the Security Settings dialog.

41.26 Subscribing to a File

To monitor the activities on a file, you can subscribe to it. Whenever any change is made to the file, you will be notified in your personal activity stream.

To subscribe to a file:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click the file to open it in the Document Viewer preview pane.

2. Click the File menu and choose Subscribe.

3. If you no longer wish to monitor the activities on a file, click the File menu and choose Unsubscribe.

41.27 Liking and Unliking a File

To indicate that a file is of particular interest to you, you can "like" it. Liking a file simply highlights the Like icon for the file to show that you have given it this preference. If a file is already liked, you can "unlike" it if you no longer wish to highlight it in any way. If a number greater than zero displays alongside the Like icon, you can click the number to view a list of other users who have "liked" the file.

See Also:

For more information, see Chapter 34, "Liking, Commenting On, and Sharing Objects."

To like or unlike a file:

1. Click the Like icon for the file in either of the following locations:

- On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click the Like icon in the file's row (Figure 41-84).

Figure 41-84 Like Icon in Documents Service Task Flow: Like This File

- In the Document Viewer preview pane, click the Like icon in the menu bar (Figure 41-85).

Figure 41-85 Like Icon in Document Viewer: Like this File

The number alongside the Like icon (Figure 41-86) indicates the number of users that like the file. You can click the number to view a list of other users who have "liked" the file.

Figure 41-86 Like Icon Count

2. To "unlike" the file if you no longer wish to highlight it in any way, click the Like icon (Figure 41-87).

Figure 41-87 Like Icon in Document Viewer: Unlike this File

41.28 Adding a File to Your Favorites

For quick access to a file (including wki documents and blog posts), you can add it to your personal favorites.

See Also:

For more information, see Chapter 37, "Creating and Managing Your Personal Favorites."

To add a file to your personal WebCenter Spaces favorites:

1. On the Documents page or in a Documents service task flow, click the file name to open it in a Document Viewer preview pane.

2. From the File menu, click Add to Favorites (Figure 41-88).

Figure 41-88 Adding a File to Personal Favorites

41.29 Running Document Searches

In addition to the WebCenter Search service, which searches a particular Space or across the entire application (see Chapter 56, "Working with the Search Service"), the Documents service provides its own search engine for file searches. A Documents service search saves time and increases the relevancy of results by narrowing the scope of a search to files.

In WebCenter Spaces, the document search searches within a specific Space root folder. In a WebCenter Portal application, the document search searches through all files to which you have access.

The document search feature is exposed in the Document Manager, Document Explorer, and Folder Viewer task flows. It provides two levels of search: Basic and Advanced. To perform Basic and Advanced searches for files, refer to the following sections:

- Section 41.29.1, "Running a Basic Document Search"

- Section 41.29.2, "Running an Advanced Document Search"

41.29.1 Running a Basic Document Search

A basic document search searches for a full or partial file name. To include more file information in a search, see Section 41.29.2, "Running an Advanced Document Search."

To perform a basic document search:

1. On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, enter a search string that is a full or partial file name in the Filter field (Figure 41-89).

Figure 41-89 Filter Field

2. Press the Enter key, or click the Search icon.

The search results pane displays files matching the search string (Figure 41-90).

Figure 41-90 Search Results

In the search results pane, the presence of the highlighted area indicates that you're looking at the results of a query, not the contents of a folder. Look in the Location column to determine where a file or folder is located. Alternatively, click the file name to open it from the search results pane.

3. To remove a search criterion and automatically execute the search again with the remaining search criteria, click the Remove icon next to the search criterion. This is useful with an advanced search containing two or more search strings (see Section 41.29.2, "Running an Advanced Document Search").

4. Click the Clear action to clear the Filter field and return to the default folder display.

41.29.2 Running an Advanced Document Search

The advanced document search includes searches against file keywords, content type, dates, users, and content. Additionally, you can narrow your search to a particular folder.

To perform an advanced document search:

1. Open the Advanced Search dialog in either of the following ways:

- On the Documents page or in a Document Manager, Document Explorer, or Folder Viewer task flow, click Advanced next to the Filter field.

- Click Edit Search Criteria in the highlighted toolbar area of the search results pane (Figure 41-90).

The Advanced Search dialog opens (Figure 41-91).

Figure 41-91 Advanced Search Dialog

2. Enter search terms in one or more of the default fields:

- File Name: Enter a full or partial file name.

- Keywords: Enter any keywords related to the content of the file to make the file more widely discoverable in search results.

- Look In: Click the Browse icon to open a list of content repository folders. Select one of these to narrow your search to the selected folder.

- Content Type: Choose All Content Types to retrieve content items regardless of the content type. Or, choose from the list the name of a content profile defined in the Oracle Content Server repository. A content profile specifies the properties that define a specific type of content (for example, a press release, or a news flash, or an image). The content type IDC:GlobalProfile is the name of a default content profile defined in Oracle Content Server that can be applied if no other content profiles are defined.

- Limit Results: Specify the maximum number of files to be returned by the search.

3. Optionally, select additional search criteria from the Add Fields dropdown list (Figure 41-92).

Figure 41-92 Add Fields Dropdown List

- Dates: Select to add the Dates pane with search fields for Created date and Last Modified date. You can modify the dates search criteria by selecting a modifier to search for an exact date (is), a following date (is after), a preceding date (is before), or a date between two other dates (is between), which adds an additional date field for entering the second date (Figure 41-93).

Figure 41-93 Dates Search Pane

Click the Select Date icon to select a date in the correct format (mm/dd/yyyy), for example 6/18/2009, or enter a date manually.

- Users: Select to add the Users pane with search fields for Created By (user who uploaded) and Last Modified By (Figure 41-94).

Figure 41-94 Users Search Pane

Enter a user name for the creator or modifier, or click the Browse icon to open the Search Users dialog where you can select from a list of users or search for a user name. Enter—minimally—two consecutive characters from the name of your search target (the search term do finds both condoleeza and doug).

Note:

In the WebCenter Spaces application, when you search documents in a Space, the user selection list and the user search find user names for current members of the Space.

- Filters: Select to add the Additional Query Filters pane. Not applicable when Content Type is set to All Content Types. For a selected content profile (prefixed IDC), click the Add icon (Figure 41-95) to list all the properties that are defined for the selected content profile. Select one or more properties to refine the query to find files with specific property settings.

Figure 41-95 Filters Search Pane

4. Click Search to execute the advanced search.

Files matching the search criteria display in the search results pane.

The script content on this page is for navigation purposes only and does not alter the content in any way.

42 Setting Documents Service Task Flow and Document Component Properties

All Documents service task flows and individual document components have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 42-1).

Figure 42-1 Document Explorer Task Flow Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Documents service task flows and document components (links, inline frames, and images) and describe the properties on the Parameters tab for each Documents service task flow and document component:

- Section 42.1, "What You Should Know About Documents Service Task Flow and Document Component Properties"

- Section 42.2, "Setting Document Explorer Task Flow Properties"

- Section 42.3, "Setting Document List Viewer Task Flow Properties"

- Section 42.4, "Setting Document Manager Task Flow Properties"

- Section 42.5, "Setting Document Navigator Task Flow Properties"

- Section 42.6, "Setting Folder Viewer Task Flow Properties"

- Section 42.7, "Setting Recent Documents Task Flow Properties"

- Section 42.8, "Setting Document Viewer Task Flow Properties"

- Section 42.9, "Setting Document Mini Properties Task Flow Properties"

- Section 42.10, "Setting Document Properties Task Flow Properties"

- Section 42.11, "Setting Document Version History Task Flow Properties"

- Section 42.12, "Setting Document Link Component Properties"

- Section 42.13, "Setting Document Inline Frame Component Properties"

- Section 42.14, "Setting Document Image Component Properties"

For the steps to add a Documents service task flow or document item to a page, see Chapter 41, "Working with the Documents Service Task Flows and Document Components."

Audience

This chapter is intended for WebCenter Spaces users who want to change the properties of Documents service task flows and document components (links, inline frames, and images).

42.1 What You Should Know About Documents Service Task Flow and Document Component Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. These properties are unique to the task flow type. For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor.

For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

42.2 Setting Document Explorer Task Flow Properties

The Document Explorer task flow displays a list of folders and files in two panes: the left pane shows folders, and the right pane show the contents of the currently selected folder. It is a feature-rich Documents service task flow for viewing, managing, and collaborating on folders and files.

See Also:

Section 41.1.1, "Understanding the Document Explorer Task Flow"

Properties that are unique to the Document Explorer task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-2).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-2 Document Explorer Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.2.1 Document Explorer Task Flow Parameters

Table 42-1 describes the parameters that are unique to the Document Explorer task flow.

Table 42-1 Document Explorer Task Flow Parameters

Parameter

Description

Collapse Tree Navigation

Specifies whether to collapse the panel containing the tree navigation:

- Selected (default): Collapse panel.

- Cleared: Expand panel.

Connection Name

The name of the content repository connection. If no value is selected from the list, the default connection specified by the application developer or administrator is used. For information about configuring content repository connections, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default: The connection selected as default in the Create Content Repository Connection dialog box by the application developer, which can be changed by the administrator.

Features Off

A list of disabled features for the task flow. Use commas or spaces to separate items. Valid values are exposed in the JavaDoc: checkin, checkout, clipboard, close, delete, download, dnd, editwiki, editoffice, newfolder, newwiki, rename, upload, multifile-upload, profile-upload, search, advancedSearch, workflow, properties, history, comments, likes, links, tags, recommendations, autovue, title, related-items, social, sidebars, ils.

Example:

${'search, advancedSearch, clipboard, dnd, rename, newfolder, upload, newwiki, checkin, checkout, editoffice, edithtml, delete, sidebars, history'}

Page Size

The maximum number of rows to show in the task flow. If the listing of folders and files in the task flow is larger than the specified number of rows, the task flow displays a scroll bar. Default: 27

Typical scenarios where you may wish to alter this value are:

- The majority of end users have bigger screens, allowing for the display of more rows.

- You want to fit this task flow into a smaller area of a page.

Note: If you set Page Size to a value that is too big for the size of the screen, the end user will experience difficulty coordinating the task flow scroll bar with the application scroll bar.

Read Only

Specifies whether to disable and hide all content management operations:

- Selected: Disable content management.

- Cleared (default): Expose content management to users.

Resource Id

The currently focused resource. This value can be a folder ID or a document ID (as shown in the properties pane of the Document Viewer task flow).

The Resource Id value is checked for coherence with the Connection Name and Start Folder Path values, and influences their default values when they are not explicitly specified. For example, if Resource Id alone is specified, the Connection Name value will be inherited from it and the start folder will be either the resource itself for a folder or the parent folder for a file.

Show Documents

Specifies whether the navigation tree shows documents and folders, or folders only:

- Selected: Show documents and folders.

- Cleared (default): Show folders and hide documents.

Show Folders

Specifies whether the navigation tree shows documents and folders, or documents only:

- Selected (default): Show folders and documents.

- Cleared: Show documents and hide folders.

Start Folder Path

The name of the folder to use as the root folder in the current task flow instance. Click the magnifier icon to open a dialog where you can navigate the connected content repository and select a folder.

This is a content-scoping parameter that assists with determining the source and range of content to display in the task flow instance.

There is no need to set this value for task flows that display the content of the current Space's default root folder. But it is useful, for example, when you want the start folder to be other than a Space's default root folder and when you want to display content from another Space.

Example:

- /PersonalSpaces/monty/Public

- /WebCenterB5/Proj_X/Specs

You can specify an EL expression to set this value. See Section B.3.12, "EL Expressions Relevant to the Documents Service" in Appendix B.

Default: The root folder of the content repository configured with the specified connection for the current Space.

42.3 Setting Document List Viewer Task Flow Properties

The Document List Viewer task flow displays folders and files in a single pane as a flat listing. In this task flow, users can navigate a folder hierarchy, and customize search queries. While this task flow may be useful for a specific need, its search functionality is replicated and enhanced by using the Content Presenter task flow instead.

See Also:

Section 41.1.2, "Understanding the Document List Viewer Task Flow"

Properties that are unique to the Document List Viewer task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-3).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-3 Document List Viewer Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.3.1 Document List Viewer Task Flow Parameters

Table 42-2 describes the parameters that are unique to the Document List Viewer task flow.

Table 42-2 Document List Viewer Task Flow Parameters

Parameter

Description

Connection Name

The name of the content repository connection. If no value is selected from the list, the default connection specified by the application developer or administrator is used. For information about configuring content repository connections, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default: The connection selected as default in the Create Content Repository Connection dialog box by the application developer, which can be changed by the administrator.

Created After

A filtering value to limit the display of task flow content to folders and files created after a specified date and time. Click the magnifier icon to open a dialog where you can select the date from a calendar.

The value uses the ISO 8601 format:

yyyy-mm-ddThh:mm:ss.sssTZFoot 1

Example:

2010-11-17T18:24:36.000+01:00

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Created Before

A filtering value to limit the display of task flow content to folders and files created before a specified date and time. Click the magnifier icon to open a dialog where you can select the date from a calendar.

The value uses the ISO 8601 format:

yyyy-mm-ddThh:mm:ss.sssTZ^1

Example:

2010-11-17T18:24:36.000+01:00

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Creator

A filtering value to limit the display of task flow content to folders and files created by a particular user. Enter the user name as specified by the user login credentials. Only one user name may be entered. If no value is entered, then content created by any user is shown.

Example: ${'monty'}

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Last Modified After

A filtering value to limit the display of task flow content to folders and files last modified after a specified date and time. If no value is entered, then content modified in the last three months is shown. Click the magnifier icon to open a dialog where you can select the date from a calendar.

The value uses the ISO 8601 format:

yyyy-mm-ddThh:mm:ss.sssTZD^1

Example:

2010-11-17T18:24:36.000+01.00

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Last Modified Before

A filtering value to limit the display of task flow content to folders and files modified before a specified date and time. If no value is entered, then no such filtering is applied is applied. Click the magnifier icon to open a dialog where you can select the date from a calendar.

The value uses the ISO 8601 format:

yyyy-mm-ddThh:mm:ss.sssTZD^1

Example:

2010-11-17T18:24:36.000+01:00

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Last Modifier

A filtering value to limit the display of task flow content to folders and files last modified by a particular user. Enter the user name as specified by the user login credentials. Only one user name may be entered. If no value is entered, then all modified documents are shown.

Example: ${'monty'}

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Page Size

The maximum number of rows to show in the task flow. If the listing of folders and files in the task flow is larger than the specified number of rows, the task flow displays a scroll bar. Default: 27

Typical scenarios where you may wish to alter this value are:

- The majority of end users have bigger screens, allowing for the display of more rows.

- You want to fit this task flow into a smaller area of a page.

Note: If you set Page Size to a value that is too big for the size of the screen, the end user will experience difficulty coordinating the task flow scroll bar with the application scroll bar.

Root Folder Path

The name of the folder to use as the root folder in the current task flow instance. Click the magnifier icon to open a dialog where you can navigate the connected content repository and select a folder.

This is a content-scoping parameter that assists with determining the source and range of content to display in the task flow instance.

There is no need to set this value for task flows that display the content of the current Space's default root folder. But it is useful, for example, when you want the start folder to be other than a Space's default root folder and when you want to display content from another Space.

Example:

- /PersonalSpaces/monty/Public

- /WebCenterB5/Proj_X/Specs

You can specify an EL expression to set this value. See Section B.3.12, "EL Expressions Relevant to the Documents Service" in Appendix B.

Default: The root folder of the content repository configured with the specified connection for the current Space.

Show Folders

Specifies whether to show documents and folders, or documents only:

- ${true}: show folders and documents

- ${false} (default): show documents and hide folders

Task Flow Instance ID

The unique identifier for this task flow instance, used internally to maintain the association of the task flow instance with its customization and personalization settings and to manage saved queries. Do not edit this value.

Footnote 1 "TZ" is the time zone indicator. If the time being described is in UTC (Coordinated Universal Time), then the time zone indicator is "Z". If the time is from any other time zone, then TZ describes the offset from UTC of the time zone. For example, if the time is in California in December (Pacific Standard Time, PST), then the TZ indicator would be "-08:00".

42.4 Setting Document Manager Task Flow Properties

The Document Manager task flow displays folders and files as specified by its layout parameter: it may display folders and files in two panes (Explorer layout), or a single pane showing only the content of the current folder (Table layout), or a single pane showing the folder hierarchy starting from the root folder (Tree-Table layout). The Document Manager task flow provides comprehensive document management functionality, such as copying, moving, pasting, and deleting folders and files.

See Also:

Section 41.1.3, "Understanding the Document Manager Task Flow"

Properties that are unique to the Document Manager task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-4).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-4 Document Manager Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.4.1 Document Manager Task Flow Parameters

Table 42-3 describes the parameters that are unique to the Document Manager task flow.

Table 42-3 Document Manager Task Flow Parameters

Parameter

Description

Connection Name

The name of the content repository connection. If no value is selected from the list, the default connection specified by the application developer or administrator is used. For information about configuring content repository connections, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default: The connection selected as default in the Create Content Repository Connection dialog box by the application developer, which can be changed by the administrator.

Features Off

A list of disabled features for the task flow. Use commas or spaces to separate items. Valid values are exposed in the JavaDoc: checkin, checkout, clipboard, close, delete, download, dnd, editwiki, editoffice, newfolder, newwiki, rename, upload, multifile-upload, profile-upload, search, advancedSearch, workflow, properties, history, comments, likes, links, tags, recommendations, autovue, title, related-items, social, sidebars, ils.

Example:

${'search, advancedSearch, clipboard, dnd, rename, newfolder, upload, newwiki, checkin, checkout, editoffice, edithtml, delete, sidebars, history'}

Layout

A target layout for the task flow. Choose from:

- Explorer (default): Displays folders and files in two panes; the left pane shows folders, and the right pane show the contents of the currently selected folder. This layout looks identical to the Document Explorer task flow, without the properties Show Documents, Show Folders, and Collapse Tree Navigation.

- Table: Displays only the contents of the current folder in a single pane, with the capability to click a folder to drill down, refreshing the pane with the folder contents.

- Tree Table: Displays the folder hierarchy in a single pane, beginning with the root folder, with the capability to expand and collapse folders.

Page Size

The maximum number of rows to show in the task flow. If the listing of folders and files in the task flow is larger than the specified number of rows, the task flow displays a scroll bar. Default: 27

Typical scenarios where you may wish to alter this value are:

- The majority of end users have bigger screens, allowing for the display of more rows.

- You want to fit this task flow into a smaller area of a page.

Note: If you set Page Size to a value that is too big for the size of the screen, the end user will experience difficulty coordinating the task flow scroll bar with the application scroll bar.

Read Only

Specifies whether to disable and hide all content management operations:

- ${true}: Disable content management.

- ${false} (default): Expose content management to users.

Resource Id

The currently focused resource. This value can be a folder ID or a document ID (as shown in the properties pane of the Document Viewer task flow).

The Resource Id value is checked for coherence with the Connection Name and Start Folder Path values, and influences their default values when they are not explicitly specified. For example, if Resource Id alone is specified, the Connection Name value will be inherited from it and the start folder will be either the resource itself for a folder or the parent folder for a file.

Start Folder Path

The name of the folder to use as the root folder in the current task flow instance. Click the magnifier icon to open a dialog where you can navigate the connected content repository and select a folder.

This is a content-scoping parameter that assists with determining the source and range of content to display in the task flow instance.

There is no need to set this value for task flows that display the content of the current Space's default root folder. But it is useful, for example, when you want the start folder to be other than a Space's default root folder and when you want to display content from another Space.

Example:

- /PersonalSpaces/monty/Public

- /WebCenterB5/Proj_X/Specs

You can specify an EL expression to set this value. See Section B.3.12, "EL Expressions Relevant to the Documents Service" in Appendix B.

Default: The root folder of the content repository configured with the specified connection for the current Space.

42.5 Setting Document Navigator Task Flow Properties

The Document Navigator task flow displays folders and files in a single pane, with the capability to expand and collapse folders to view folder hierarchy within the current folder. There are no menu options available to the end user for this task flow.

See Also:

Section 41.1.4, "Understanding the Document Navigator Task Flow"

Properties that are unique to the Document Navigator task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-5).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-5 Document Navigator Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.5.1 Document Navigator Task Flow Parameters

Table 42-4 describes the parameters that are unique to the Document Navigator task flow.

Table 42-4 Document Navigator Task Flow Parameters

Parameter

Description

Connection Name

The name of the content repository connection. If no value is selected from the list, the default connection specified by the application developer or administrator is used. For information about configuring content repository connections, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default: The connection selected as default in the Create Content Repository Connection dialog box by the application developer, which can be changed by the administrator.

Features Off

A list of disabled features for the task flow. Use commas or spaces to separate items. Valid values are exposed in the JavaDoc: checkin, checkout, clipboard, close, delete, download, dnd, editwiki, editoffice, newfolder, newwiki, rename, upload, multifile-upload, profile-upload, search, advancedSearch, workflow, properties, history, comments, likes, links, tags, recommendations, autovue, title, related-items, social, sidebars, ils.

Example:

${'search, advancedSearch, clipboard, dnd, rename, newfolder, upload, newwiki, checkin, checkout, editoffice, edithtml, delete, sidebars, history'}

Page Size

The maximum number of rows to show in the task flow. If the listing of folders and files in the task flow is larger than the specified number of rows, the task flow displays a scroll bar. Default: 27

Typical scenarios where you may wish to alter this value are:

- The majority of end users have bigger screens, allowing for the display of more rows.

- You want to fit this task flow into a smaller area of a page.

Note: If you set Page Size to a value that is too big for the size of the screen, the end user will experience difficulty coordinating the task flow scroll bar with the application scroll bar.

Read Only

Specifies whether to disable and hide all content management operations:

- ${true}: Disable content management.

- ${false} (default): Expose content management to users.

Resource Id

The currently focused resource. This value can be a folder ID or a document ID (as shown in the properties pane of the Document Viewer task flow).

The Resource Id value is checked for coherence with the Connection Name and Start Folder Path values, and influences their default values when they are not explicitly specified. For example, if Resource Id alone is specified, the Connection Name value will be inherited from it and the start folder will be either the resource itself for a folder or the parent folder for a file.

Show Documents

Specifies whether the navigation tree shows documents and folders, or folders only:

- ${true} (default): Show documents and folders.

- ${false}: Show folders and hide documents.

Start Folder Path

The name of the folder to use as the root folder in the current task flow instance. Click the magnifier icon to open a dialog where you can navigate the connected content repository and select a folder.

This is a content-scoping parameter that assists with determining the source and range of content to display in the task flow instance.

There is no need to set this value for task flows that display the content of the current Space's default root folder. But it is useful, for example, when you want the start folder to be other than a Space's default root folder and when you want to display content from another Space.

Example:

- /PersonalSpaces/monty/Public

- /WebCenterB5/Proj_X/Specs

You can specify an EL expression to set this value. See Section B.3.12, "EL Expressions Relevant to the Documents Service" in Appendix B.

Default: The root folder of the content repository configured with the specified connection for the current Space.

42.6 Setting Folder Viewer Task Flow Properties

The Folder Viewer task flow displays a listing of the contents of a folder in a single pane as a flat listing.

See Also:

Section 41.1.5, "Understanding the Folder Viewer Task Flow"

Properties that are unique to the Folder Viewer task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-6).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-6 Folder Viewer Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.6.1 Folder Viewer Task Flow Parameters

Table 42-6 describes the parameters that are unique to the Folder Viewer task flow.

Table 42-5 Folder Viewer Task Flow Parameters

Parameter

Description

Connection Name

The name of the content repository connection. If no value is selected from the list, the default connection specified by the application developer or administrator is used. For information about configuring content repository connections, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default: The connection selected as default in the Create Content Repository Connection dialog box by the application developer, which can be changed by the administrator.

Features Off

A list of disabled features for the task flow. Use commas or spaces to separate items. Valid values are exposed in the JavaDoc: checkin, checkout, clipboard, close, delete, download, dnd, editwiki, editoffice, newfolder, newwiki, rename, upload, multifile-upload, profile-upload, search, advancedSearch, workflow, properties, history, comments, likes, links, tags, recommendations, autovue, title, related-items, social, sidebars, ils.

Example:

${'search, advancedSearch, clipboard, dnd, rename, newfolder, upload, newwiki, checkin, checkout, editoffice, edithtml, delete, sidebars, history'}

Page Size

The maximum number of rows to show in the task flow. If the listing of folders and files in the task flow is larger than the specified number of rows, the task flow displays a scroll bar. Default: 27

Typical scenarios where you may wish to alter this value are:

- The majority of end users have bigger screens, allowing for the display of more rows.

- You want to fit this task flow into a smaller area of a page.

Note: If you set Page Size to a value that is too big for the size of the screen, the end user will experience difficulty coordinating the task flow scroll bar with the application scroll bar.

Read Only

Specifies whether to disable and hide all content management operations:

- ${true}: Disable content management.

- ${false} (default): Expose content management to users.

Resource ID

The currently focused resource. This value can be a folder ID or a document ID (as shown in the properties pane of the Document Viewer task flow).

The Resource ID value is checked for coherence with the Connection Name and Start Folder Path values, and influences their default values when they are not explicitly specified. For example, if Resource ID alone is specified, the Connection Name value will be inherited from it and the start folder will be either the resource itself for a folder or the parent folder for a file.

Show Folders

Specifies whether the navigation tree shows documents and folders, or documents only:

- ${true} (default): Show folders and documents.

- ${false}: Show documents and hide folders.

Start Folder Path

The name of the folder to use as the root folder in the current task flow instance. Click the magnifier icon to open a dialog where you can navigate the connected content repository and select a folder.

This is a content-scoping parameter that assists with determining the source and range of content to display in the task flow instance.

There is no need to set this value for task flows that display the content of the current Space's default root folder. But it is useful, for example, when you want the start folder to be other than a Space's default root folder and when you want to display content from another Space.

Example:

- /PersonalSpaces/monty/Public

- /WebCenterB5/Proj_X/Specs

You can specify an EL expression to set this value. See Section B.3.12, "EL Expressions Relevant to the Documents Service" in Appendix B.

Default: The root folder of the content repository configured with the specified connection for the current Space.

42.7 Setting Recent Documents Task Flow Properties

The Recent Documents task flow displays a listing of the most recently created or modified files by the current user.

See Also:

Section 41.1.6, "Understanding the Recent Documents Task Flow"

Properties that are unique to the Recent Documents task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-7).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-7 Recent Documents Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.7.1 Recent Documents Task Flow Parameters

Table 42-6 describes the parameters that are unique to the Recent Documents task flow.

Table 42-6 Recent Documents Task Flow Parameters

Parameter

Description

Connection Name

The name of the content repository connection. If no value is entered, the default connection specified by the application developer or administrator is used. For information about configuring content repository connections, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Default: The connection selected as default in the Create Content Repository Connection dialog box by the application developer, which can be changed by the administrator.

Group Space

(Used in WebCenter Spaces only)

The name of a Space that is the source of the recently created or modified documents listed in the task flow. Valid values are:

- no value or ${null} (default): Displays documents for the entire connected content repository.

- Display name or ID of a specific Space: Displays documents in that Space.

- ${'all'}: Displays documents from any Space, excluding non-Space documents.

Last Modified After

A filtering value to limit the display of task flow content to folders and files last modified after a specified date and time. If no value is entered, then content modified in the last three months is shown. Click the magnifier icon to open a dialog where you can select the date from a calendar.

The value uses the ISO 8601 format:

yyyy-mm-ddThh:mm:ss.sssTZDFoot 1

Example:

2010-11-17T18:24:36.000+01.00

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Last Modified Before

A filtering value to limit the display of task flow content to folders and files modified before a specified date and time. If no value is entered, then no such filtering is applied is applied. Click the magnifier icon to open a dialog where you can select the date from a calendar.

The value uses the ISO 8601 format:

yyyy-mm-ddThh:mm:ss.sssTZD^1

Example:

2010-11-17T18:24:36.000+01:00

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Last Modifier

A filtering value to limit the display of task flow content to folders and files last modified by a particular user. Enter the user name as specified by the user login credentials. Only one user name may be entered. If no value is entered, then all modified documents are shown.

Example: ${'monty'}

This parameter is available for contextual wiring. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components".

Maximum Documents

The maximum number of files to show. If no value is entered, then all matching files are shown.

Example: ${10}

Note that there is no single quote surrounding the value.

Default: ${null}

Most Recent First

Specifies the sort order of files in the task flow:

- ${true} (default): Most recent documents listed first.

- ${false}: Oldest documents listed first.

Footnote 1 "TZ" is the time zone indicator. If the time being described is in UTC (Coordinated Universal Time), then the time zone indicator is "Z". If the time is from any other time zone, then TZ describes the offset from UTC of the time zone. For example, if the time is in California in December (Pacific Standard Time, PST), then the TZ indicator would be "-08:00".

42.8 Setting Document Viewer Task Flow Properties

The Document Viewer task flow displays a preview of an individual file in the default template for its file type.

See Also:

- Section 41.1.7, "Understanding the Document Viewer Task Flow"

- Section 41.3, "Adding a Selected Folder or File to a Page"

Properties that are unique to the Document Viewer task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-8).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-8 Document Viewer Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.8.1 Document Viewer Task Flow Parameters

Table 42-6 describes the parameters that are unique to the Document Viewer task flow.

Table 42-7 Document Viewer Task Flow Parameters

Parameter

Description

Features Off

A list of disabled features for the task flow. Use commas or spaces to separate items. Valid values are exposed in the JavaDoc: checkin, checkout, clipboard, close, delete, download, dnd, editwiki, editoffice, newfolder, newwiki, rename, upload, multifile-upload, profile-upload, search, advancedSearch, workflow, properties, history, comments, likes, links, tags, recommendations, autovue, title, related-items, social, sidebars, ils.

Example:

${'search, advancedSearch, clipboard, dnd, rename, newfolder, upload, newwiki, checkin, checkout, editoffice, edithtml, delete, sidebars, history'}

Initial Sidebar

Specifies a pane to display in the sidebar of the Document Viewer. Valid values are:

- ${'comments'} (default). Displays a Comments pane (see "Section 41.20, "Viewing, Entering, and Deleting Comments on a File").

- ${'history'}. Displays a History pane (see Section 41.21, "Viewing and Deleting File Version History").

- ${'relatedItems'}. Displays a Related Items pane (see Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)").

- ${'docInfo'}. Displays a Properties pane (see Section 41.22, "Viewing and Modifying Folder and File Properties").

- ${'autovue'}. Displays an AutoVue pane showing the AutoVue markup for the current document in a table of hyperlinked markup names (see Section 45.3, "Collaborating on Documents Using Oracle AutoVue").

Item ID

The ID of the document to display in the Document Viewer.

Read Only

Specifies whether to disable and hide all content management operations:

- Selected: Disable content management.

- Cleared (default): Expose content management to users.

42.9 Setting Document Mini Properties Task Flow Properties

The Document Mini Properties task flow displays the basic properties of a selected file in a read-only view. This choice is available for all file types.

See Also:

- Section 41.1.8, "Understanding the Document Mini Properties Task Flow"

- Section 41.3, "Adding a Selected Folder or File to a Page"

- Section 41.22.2, "Working with File Properties"

Properties that are unique to the Document Mini Properties task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-9).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-9 Document Mini Properties Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.9.1 Document Mini Properties Task Flow Parameters

Table 42-8 describes the parameters that are unique to the Document Mini Properties task flow.

Table 42-8 Document Mini Properties Task Flow Parameters

Parameter

Description

Resource ID

The ID of the current document for which to display basic properties.

42.10 Setting Document Properties Task Flow Properties

The Document Properties task flow displays both Basic and Advanced properties of a selected file, along with an Edit button to modify property values. This choice is available for all file types.

See Also:

- Section 41.1.9, "Understanding the Document Properties Task Flow"

- Section 41.3, "Adding a Selected Folder or File to a Page"

- Section 41.22.2, "Working with File Properties"

Properties that are unique to the Document Properties task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-11).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-10 Document Properties Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.10.1 Document Properties Task Flow Parameters

Table 42-8 describes the parameters that are unique to the Document Properties task flow.

Table 42-9 Document Properties Task Flow Parameters

Parameter

Description

Item ID

The ID of the document for which to display properties.

Read Only

Specifies whether or not to allow end user to edit document properties:

- Selected: Do not display Edit button in Basic and Advanced properties panes, thus disabling the ability for the end user to edit document properties.

- Cleared (default): Display Edit button in Basic and Advanced properties panes, allowing end users to edit document properties.

42.11 Setting Document Version History Task Flow Properties

The Document Version History task flow displays a list of versions of a selected file in a read-only view. This choice is available for all file types.

See Also:

- Section 41.1.10, "Understanding the Document Version History Task Flow"

- Section 41.3, "Adding a Selected Folder or File to a Page"

- Section 41.21, "Viewing and Deleting File Version History"

Properties that are unique to the Document Version History task flow are shown on the Parameters tab of the Component Properties dialog (Figure 42-11).

Figure 42-11 Version History Task Flow Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.11.1 Document Version History Task Flow Parameters

Table 42-8 describes the parameters that are unique to the Document Version History task flow.

Table 42-10 Document Version History Task Flow Parameters

Parameter

Description

Item ID

The ID of the document for which to display version history.

Read Only

Specifies whether to disable and hide all content management operations:

- Selected: Disable content management.

- Cleared (default): Expose content management to users.

42.12 Setting Document Link Component Properties

The Link component displays the file name of a selected file as a link on the page.

See Also:

Section 41.3, "Adding a Selected Folder or File to a Page"

Properties that are unique to the Link component are shown on the Display Options tab of the Component Properties dialog (Figure 42-4).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-12 Link Component Properties

For information about the properties on the Style tab, which is common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.12.1 Document Link Component Display Options

Table 42-11 describes the properties that are unique to the link component.

Table 42-11 Link Component Properties: Display Options

Property

Description

Title

The display name of the selected file.

Default: file name.

Destination

Path to the file relative to the application root.

Example:

/resources/images/cologo.gif

Open in a new window

Specifies where the file opens:

- Selected: Open file in new browser tab or window.

- Cleared (default): Open file in current browser window.

This option is relevant only to files that open in a browser. Some files, such as Microsoft Word files, open in their native applications.

Show Component

Specifies whether to show or hide the link component on the page:

- Selected (default): Show the link component.

- Cleared: Hide the link component.

Once you hide a component in this way, any child components are also hidden. You can show the component again through Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

42.13 Setting Document Inline Frame Component Properties

The Inline Frame component displays a preview of the file content of a selected file. This choice is available for HTML and TXT types.

See Also:

Section 41.3, "Adding a Selected Folder or File to a Page"

Properties that are unique to the inline frame component are shown on the Display Options tab of the Component Properties dialog (Figure 42-4).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-13 Inline Frame Component Properties

For information about the properties on the Style tab, which is common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.13.1 Document Inline Frame Component Display Options

Table 42-12 describes the properties that are unique to the inline frame component.

Table 42-12 Inline Frame (IFRAME) Component Properties: Display Options

Property

Description

Short Desc

The ALT text to display when the mouse pointer hovers over the component.

The default is the name of the document.

Source

The path to the file relative to the WebCenter application root. Example:

/resources/images/cologo.gif

Show Component

Specifies whether to show or hide the inline frame component on the page:

- Selected (default): Show the inline frame component.

- Cleared: Hide the inline frame component.

Once you hide a component in this way, any child components are also hidden. You can show the component again through Oracle Composer Source view. Right-click the hidden component, and select Show Component from the resulting context menu.

42.14 Setting Document Image Component Properties

The Image component displays a selected file as an image on a page. This choice is available only for image file types (such as JPG, PNG, and GIF).

See Also:

Section 41.3, "Adding a Selected Folder or File to a Page"

Properties that are unique to the image component are shown on the Display Options tab of the Component Properties dialog (Figure 42-4).

Tip:

For information about accessing the Component Properties dialog, see Section 17.5.2, "Setting Properties on Page Components."

Figure 42-14 Image Component Properties

For information about the properties on the Style tab, which is common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

42.14.1 Document Image Component Display Options

Table 42-13 describes the properties that are unique to the image component.

Table 42-13 Image Component Properties: Display Options

Property

Description

Image Map Type

The map type when the selected file is an image map. Choose from:

- none

- server

Long Desc URL

A URL to a file containing a description of the image.

Example:

http://www.abc.com/image_desc.htm

Short Desc

The ALT text to display when users hover their mouse pointers over the image component.

The default is Display WebCenter Spaces Information. The default is the rendered value of the Expression Language (EL) expression #{uib_o_w_w_r_WebCenter.GLOBAL_LINK_ABOUT_DESC}.

Source

The path to the image file relative to the WebCenter application root.

Example:

/resources/images/cologo.gif

Show Component

Specifies whether to show or hide the image component on the page:

- Selected (default): Show the image component.

- Cleared: Hide the image component.

Once you hide a component in this way, any child components are also hidden. You can show the component again through Oracle Composer Source view. Right-click the hidden component, and select Show Component from the context menu.

43 Working with Workflow-Enabled Content

WebCenter Spaces includes the following types of workflows:

- Internally-defined workflows, available through the Worklist service, are discussed in Chapter 70, "Working with the Worklist Service." For example, Space moderators receive a workflow notification in their worklists for Space subscription requests, or when a new file is checked in or uploaded to the Space. The Oracle Fusion Middleware Installation Guide for Oracle WebCenter describes how to install and configure internally-defined workflows for WebCenter Spaces.

- Externally-defined workflows enabled in a Workflow server that comes with Oracle SOA Suite, also available through the Worklist service discussed in Chapter 70, "Working with the Worklist Service." The definition of these workflows is an administrative or development task in Oracle SOA Suite.

- Workflows defined on Space folders that reside in Oracle Content Server. When a folder is assigned a workflow, any file (including wiki documents and blog posts) checked in or uploaded to that folder must be approved or rejected by one or more assigned approvers. Documents service task flows and the Oracle Workflow Queue portlet from the Universal Content Management Portlet Suite provide access to the workflow-enabled content. This chapter discusses this type of workflow.

See Also:

For more information about working with workflows in the Oracle Content Server user interface, see the "Working with Workflows" chapter in Oracle Fusion Middleware User's Guide for Oracle Content Server.

The following sections describe how to work with workflows on content in a Space:

- Section 43.1, "What You Should Know About Content Workflows"

- Section 43.2, "Assigning a Workflow to a Folder"

- Section 43.3, "Viewing Workflow Assignments"

- Section 43.4, "Viewing Workflow Status and File Information"

- Section 43.5, "Changing or Deleting a Workflow"

- Section 43.6, "Participating in a Workflow"

Audience

This chapter is intended for WebCenter Spaces users who want to assign and manage workflows on folders in a Space when the connected content repository is Oracle Content Server.

43.1 What You Should Know About Content Workflows

Workflows on content in WebCenter Spaces are available only when the connected content repository is Oracle Content Server and your WebCenter Spaces administrator has completed the prerequisite configuration.

See Also:

For more information, see:

- "Oracle Content Server Prerequisites" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter

- "How to Create a Content Repository Connection Based on the Oracle Content Server Adapter" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter

A workflow specifies how to route content for review and approval before it is released to the system. The workflow notifies approvers through mail messages when they have a file to review and approve.

In WebCenter Spaces, you define workflows by assigning a workflow to a folder in a Documents service task flow. Once you assign a workflow to a folder, WebCenter Spaces automatically assigns the workflow to every file subsequently checked in or uploaded to the folder. Documents service task flows and the Oracle Workflow Queue portlet from the Universal Content Management Portlet Suite provide access to the workflow-enabled content.

In all Documents service task flows, any user with privileges to view the contents of a folder that is assigned a workflow can view the files while they are in a workflow. The Content Presenter task flow, and REST APIs, show only the latest released version of a file, and do not show any unreleased versions of files that are in workflow.

The following sections provide conceptual information about workflow on files in WebCenter Spaces:

- Section 43.1.1, "Understanding Workflow Types"

- Section 43.1.2, "Understanding Workflow Steps"

- Section 43.1.3, "Understanding Workflow Process"

43.1.1 Understanding Workflow Types

WebCenter Spaces provides three built-in workflows for content in a Space. These are single-step workflows that allow one or more approvers to approve, reject, or edit a file in workflow:

- AllApprover: A single-step workflow that requires all assigned approvers to approve the document to release it from workflow. Approvers are not able to edit the file, unless they are the file owner.

- AllReviewer: A single-step workflow that requires all assigned approvers to approve the document to release it from workflow. Approvers may optionally edit the file.

- SingleApprover: A single-step workflow that requires only one assigned approver to approve the document to release it from workflow.

For more information about configuring Oracle Content Server to enable the built-in workflows, see "What You Should Know About the WebCenterConfigure Component" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

43.1.2 Understanding Workflow Steps

The three workflows provided with WebCenter Spaces (AllApprover, AllReviewer, and SingleApprover) each contain a workflow contribution step and an approval step. Different users will typically participate in each of the steps.

Table 43-1 Workflow Steps

Step Type

Description

contribution

This is the initial step of a workflow. In this step, the user who participates as the contributor is the WebCenter Spaces user who submits the document or edits an existing document in a folder that has workflow enabled on it.

ApprovalStep

In this step, approvers can approve or reject the file. Editing is allowed by an approver during this step only if the workflow selected is AllReviewer.

43.1.3 Understanding Workflow Process

The workflow process is as follows:

1. A document enters the workflow approval step by exiting the initial contribution step as a result of a new document upload or editing an existing document that was previously uploaded into a workflow-enabled folder. See Section 43.1.2, "Understanding Workflow Steps."

2. If any approver rejects a revision, it goes back to the most recent contribution step for editing.

3. When approvers approve a revision in the workflow, the content item is released to the system.

43.2 Assigning a Workflow to a Folder

With appropriate permissions (the WebCenter Spaces administrator, Space members with Manage Configuration permissions), you can assign a workflow to a folder in a Documents service task flow when the connected content repository is Oracle Content Server. Once you assign a workflow to a folder, WebCenter Spaces automatically assigns the workflow to every file subsequently checked in or uploaded to the folder.

If you create a subfolder in a parent folder that is assigned a worfklow, the subfolder automatically inherits the workflow assignment of the parent folder.

To assign a workflow to a folder:

1. On the Documents page or in a Documents service task flow in a Space, create a new folder (see Section 41.7, "Creating a Folder"), or click in the row of an existing folder.

Note:

The Documents page is exposed in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, you can create a page in a Space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

2. Click the View menu and choose Properties, or right-click to display the folder's context menu and choose Properties.

The Basic properties pane for the folder opens (Figure 43-1).

Figure 43-1 Folder Properties

3. From the File menu, choose Workflow Settings.

4. In the Workflow Settings dialog, select from the Workflow Name list (Figure 43-2) to apply a workflow to the folder.

Note:

The selections in the Workflow Name list are preceded with the WebCenter Spaces installation name used during the installation procedure.

Figure 43-2 Workflow Settings Dialog

For information about the built-in workflows, see Section 43.1.1, "Understanding Workflow Types." Additional workflows may be listed if they have been defined in Oracle Content Server and added by the system administrator. For more information about defining workflows, see the "Working with Workflows" chapter in Oracle Fusion Middleware User's Guide for Oracle Content Server.

5. After selecting a workflow name, click Add Approvers (Figure 43-3).

Note:

WebCenter Spaces does not support group names as approvers.

Figure 43-3 Workflow Settings Dialog

6. In the Select User window, search for and select users to whom to assign the workflow. Click OK.

7. In the Workflow Settings dialog, click OK to save the workflow.

Every assigned approver receives a mail message to notify them that they are assigned to the workflow as document approvers. The format and contents of the mail message are controlled by how the system administrator installed and configured the Oracle Content Server.

With a workflow established on a folder in a Space, WebCenter Spaces automatically enters every file that is subsequently checked in or uploaded to the folder into workflow. If you want to assign the workflow to a file that was already in the Space prior to the workflow being defined, you can save the file to your local file system, delete the file from the Space, then reupload the file into the folder so that the file can inherit the workflow properties of the folder. See Section 41.8.1, "Uploading New Files."

A workflow icon alongside a file in a Documents service task flow indicates that the file is assigned to a workflow (Figure 43-4). For more information, see Section 43.3, "Viewing Workflow Assignments." Note that the only way to determine if a folder has a workflow defined on it is to view its workflow settings, as describedin the steps above.

Figure 43-4 Workflow Icon

43.3 Viewing Workflow Assignments

You can identify the files that have workflows assigned and view workflow details in either a Documents service task flow or in an Oracle Workflow Queue portlet:

- Section 43.3.1, "Viewing Workflow Files in a Documents Service Task Flow"

- Section 43.3.2, "Viewing Workflow Files in a Workflow Queue"

43.3.1 Viewing Workflow Files in a Documents Service Task Flow

On the Documents page or in a Documents service task flow in a Space, a workflow icon alongside a file in a Documents service task flow indicates that the file is assigned to a workflow (Figure 43-5).

Figure 43-5 Workflow Icon

Note:

The Documents page is exposed in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, you can create a page in a Space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

To view a file that is in workflow:

1. Click the file name to open the file in the Document Viewer preview pane.

The Document Viewer preview pane shows that the file is in workflow (Figure 43-6).

Figure 43-6 Properties Pane of File in Workflow

Note:

To enable the availability of workflow details in the Document Viewer preview pane, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the front-end to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

2. If you are an approver or reviewer for the file, you can click Approve or Reject to indicate the result of your review of the file. These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection. For other ways to approve or reject a file, see Section 43.6.1, "Approving or Rejecting a File in Workflow."

3. To view further details about the workflow, click Details to display the workflow information in Oracle Content Server.

43.3.2 Viewing Workflow Files in a Workflow Queue

If you have Content Portlet Suite installed, you can add the Oracle Workflow Queue portlet to a page to list the files in workflow, along with details about each workflow. For information about how to deploy Content Portlet Suite, see Oracle Fusion Middleware Deployment Guide for Content Portlet Suite.

To add the Oracle Workflow Queue portlet to a page:

1. Create a new page in a Space or go to the page where you want to add the portlet, and open the page in edit mode.

See Also:

For more information, see Section 51.7.2, "Creating a Page in a Space" and Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content to open the Resource Catalog.

3. Locate the Oracle Workflow Queue portlet in the Resource Catalog.

Tip:

The presence or location of the Oracle Workflow Queue portlet depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, click Portlets, then <Host> Portlets to locate the Oracle Workflow Queue portlet.

4. Click Add next to the Oracle Workflow Queue portlet to add it to the page, then Close the Resource Catalog.

On the page, the Oracle Workflow Queue portlet (Figure 43-7) displays a list of all the files in workflow assigned to you to approve or reject.

Figure 43-7 Oracle Workflow Queue Portlet

In the Oracle Workflow Queue portlet, you can perform the following actions if you have appropriate permissions:

- In the Title column, click a file name to open it in its native application.

- In the Workflow Info column, click a link to display the Workflow Step Information pane, which provides steps required to complete the workflow, the current step, the number of approvals required, and the remaining reviewers. For more information, see Section 43.4.1, "Viewing Detailed Workflow Status."

- In the Actions column, click Approve or Reject to indicate the result of your review of the file. These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection. For other ways to approve or reject a file, see Section 43.6.1, "Approving or Rejecting a File in Workflow."

- In the Info column, click the Content Information icon to display the Content Info pane, which provides access to actions you can perform, file metadata information, and revision history. For more information, see Section 43.4.2, "Viewing Content Information and Actions."

43.4 Viewing Workflow Status and File Information

As an approver or owner of a file in workflow, you may want to get more information about the current state of the workflow, details about the file itself, or perform file management actions to update or share the file to advance its approval:

- Section 43.4.1, "Viewing Detailed Workflow Status"

- Section 43.4.2, "Viewing Content Information and Actions"

43.4.1 Viewing Detailed Workflow Status

To view the details of the workflow status of a file:

1. Go to the Oracle Workflow Queue portlet that lists the file.

To add an Oracle Workflow Queue portlet to a page, see Section 43.3.2, "Viewing Workflow Files in a Workflow Queue."

2. In the Workflow Info column, click the workflow step link to display the Workflow Step Information pane (Figure 43-8), which includes the steps required to complete the workflow, the current step, the number of approvals required, and the remaining reviewers. For information about workflow steps, see Section 43.1.2, "Understanding Workflow Steps."

Figure 43-8 Workflow Step Information

3. Click Back to return to the Oracle Workflow Queue portlet.

43.4.2 Viewing Content Information and Actions

To display a Content Info pane that provides details about a file in workflow and perform file management actions to update or share the file to advance its approval:

1. Go to the Oracle Workflow Queue portlet that lists the file.

To add an Oracle Workflow Queue portlet to a page, see Section 43.3.2, "Viewing Workflow Files in a Workflow Queue."

2. In the Info column, click the Content Information icon to display the Content Info pane (Figure 43-9), which provides access to actions you can perform, file metadata information, and revision history. For more information, see "Content Information Page" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

Figure 43-9 Content Info Pane

3. Optionally, from the Actions list, choose any of the following actions:

- Check Out to check the file out so that you can lock it from changes by other contributors while you are making updates.

- Update to display the Info Update Form, where you can update editable metadata of the file without creating a new revision of the file. Only the WebCenter Spaces administrator, Space members with Manage Configuration permissions, or file owners can edit the file properties. For more information, see "Info Update Form" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

- Check in Similar to display the Content Check In Form, where you can update editable metadata of the file and check the file in to Oracle Content Server. Only the WebCenter Spaces administrator, Space members with Manage Configuration permissions, or file owners can edit the metadata properties. For more information, see "Content Check-In Form" in Oracle Fusion Middleware User's Guide for Oracle Content Server.

- Send link by e-mail to open your e-mail application with a new message that contains a link to the URL of the web-viewable file, which you can mail to other users with requests for input or review to further the approval of the file.

4. Click Back to return to the Oracle Workflow Queue portlet.

43.5 Changing or Deleting a Workflow

With appropriate permissions (the WebCenter Spaces administrator, Space members with Manage Configuration permissions), you can change or delete the workflow assigned to a folder in a Documents service task flow when the connected content repository is Oracle Content Server.

To change or delete the workflow assigned to a folder:

1. On the Documents page or in a Documents service task flow in a Space, click in the row of the folder.

Note:

The Documents page is exposed in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, you can create a page in a Space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

2. Follow the steps in Section 43.2, "Assigning a Workflow to a Folder":

- To change the workflow, choose a different workflow from the Workflow Name list, and optionally add or delete approvers.

- To delete the workflow, choose <None> from the Workflow Name list.

Note:

If you change or delete the workflow assigned to a folder, the files that were previously in that folder remain assigned to the prior workflow. Only files that are subsequently checked in or uploaded to the folder are not assigned to workflow.

43.6 Participating in a Workflow

The workflow process is as follows:

- A document enters the workflow approval step by exiting the initial contribution step as a result of a new document upload or the editing of an existing document that was previously uploaded into a workflow-enabled folder.

- If any reviewer rejects a revision, it goes back to the contribution step for editing.

- When a revision is approved at the last step in the workflow, the content item is released to the system.

The following sections describe how to work with a file through the workflow process:

- Section 43.6.1, "Approving or Rejecting a File in Workflow"

- Section 43.6.2, "Working with a Rejected Revision"

43.6.1 Approving or Rejecting a File in Workflow

As an assigned approver for a workflow, you will need to review and either approve or reject the files to which you are assigned. Depending on the workflow type (see Section 43.1.1, "Understanding Workflow Types"), the file will be released from workflow when it is approved.

To approve or reject a file in workflow:

1. View the files for which you are an assigned approver in either of the following ways:

- In the Document Viewer preview pane, as described in Section 43.3.1, "Viewing Workflow Files in a Documents Service Task Flow."

- In an Oracle Workflow Queue portlet, as described in Section 43.3.2, "Viewing Workflow Files in a Workflow Queue."

2. Click Approve or Reject to indicate the result of your review of the file. These links are active only when the file is pending approval. If you reject the file, enter the justification for your rejection.

43.6.2 Working with a Rejected Revision

If a file in worfklow is rejected, it returns to the original submitter in the contribution workflow step. The contributor can then revise the file and save it. Upon execution of the save, the file will automatically move back into the workflow approval step again.

44 Creating and Managing Content at Runtime

End users of a WebCenter Spaces application can create and manage content at runtime through the content task flows:

- The Documents service task flows offer capabilities to create, open, edit, delete, copy, rename, move, share, search, view, and manage information about folders and files in any connected content repository. For more information about the Documents service task flows, see Section 41.1, "What You Should Know About the Documents Service Task Flows."

- In a Content Presenter task flow, end users can edit wiki documents, HTML files, or Site Studio files in-context, and create new Site Studio files in the connected Oracle Content Server content repository. For more information about the Content Presenter task flow, see Section 40.1, "What You Should Know About the Content Presenter Task Flow."

This chapter offers pointers to the information that will assist you in creating and managing content at runtime using the content task flows.

To create and manage content at runtime using one of the Documents service task flows, refer to the steps in the following sections:

- Section 41.6, "Personalizing Your View"

- Section 41.9, "Opening a Folder"

- Section 41.10, "Opening a File"

- Section 41.7, "Creating a Folder"

- Section 41.8.1, "Uploading New Files"

- Section 41.8.2, "Creating a Wiki Document"

- Section 41.12.1, "Checking a File Out"

- Section 41.12.2, "Downloading a File"

- Section 41.13, "Renaming a Folder or File"

- Section 41.14, "Copying and Pasting Folders and Files"

- Section 41.15, "Moving Folders and Files"

- Section 41.16, "Deleting Folders and Files"

- Section 41.17, "Refreshing Folder Contents"

- Section 41.18, "Hiding and Showing Folders"

- Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)"

- Section 41.20, "Viewing, Entering, and Deleting Comments on a File"

- Section 41.21, "Viewing and Deleting File Version History"

- Section 41.22, "Viewing and Modifying Folder and File Properties"

- Section 41.23, "Opening or Saving PDF Files"

- Section 41.24, "Sharing the URL for a Folder or File"

- Section 41.25, "Setting Security Options on a Folder or File"

- Section 41.26, "Subscribing to a File"

- Section 41.27, "Liking and Unliking a File"

- Section 41.29, "Running Document Searches"

To create and manage content at runtime using Content Presenter, refer to the steps in the following sections:

- Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog"

- Section 40.10.1, "Editing Wiki Documents or HTML Files In-Context"

- Section 40.10.2, "Editing Site Studio Files In-Context"

- Section 40.10.3, "Creating New Site Studio Content In-Context"

45 Collaborating on Documents

Almost every enterprise spends a lot of time collaborating on documents. This includes joint authoring, sharing, reviewing, approving, editing, and so on. WebCenter Spaces provides several ways to collaborate on documents, as described in the following sections:

- Section 45.1, "Collaborating on Documents Using the Documents Service"

- Section 45.2, "Collaborating on Documents through Workflows"

- Section 45.3, "Collaborating on Documents Using Oracle AutoVue"

Note:

The Documents service is exposed on the Documents page and administration settings in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, the Documents page is not shown in a Space, and the Documents service is not available in the Space administration settings (Services and Roles). To use the Documents service functionality in 10g, you can create a page in a Space and add Documents service task flows to the page.

Audience

This chapter is intended for WebCenter Spaces users interested in sharing and collaborating on documents in a WebCenter Spaces application.

45.1 Collaborating on Documents Using the Documents Service

The Documents service provides features for accessing, adding, and managing folders and files; configuring and viewing file and folder properties; and searching file and folder content in the connected content repositories.

Within the context of managing documents, the Documents service provides features for collaborating on documents. These features include:

- Viewing a document in-place. See Section 41.10, "Opening a File."

- Tagging a document. See Section 41.19.1, "Working with Tags."

- Linking to supporting documents. See Section 41.19.2, "Working with Links."

- Viewing recommendations for similar documents. See Section 41.19.3, "Working with Recommendations."

- Commenting on a document. See Section 41.20, "Viewing, Entering, and Deleting Comments on a File."

- Sharing the link to a document. See Section 41.24, "Sharing the URL for a Folder or File."

- Subscribing to a document. See Section 41.26, "Subscribing to a File."

- Liking a document. See Section 41.27, "Liking and Unliking a File."

- Adding a document to your list of favorites. See Section 41.28, "Adding a File to Your Favorites."

You can also add wiki documents to a WebCenter application that people can use to collaborate to create content that is relevant, useful, and up-to-date. End users without appropriate permissions can create wiki documents by using either of the two methods: New Wiki Document method or the Wiki page style method. For complete information about wiki documents in WebCenter Spaces, see Chapter 47, "Working with Wiki Documents."

45.2 Collaborating on Documents through Workflows

While a document is being developed, it must typically be reviewed and approved by a number of people. To assist in managing this process, WebCenter Spaces provides a built-in workflow capability to move a document through required approvals by assigned approvers. This capability is available when the connected content repository is Oracle Content Server.

For information about assigning, viewing, updating, and participating in document workflows, see Chapter 43, "Working with Workflow-Enabled Content."

45.3 Collaborating on Documents Using Oracle AutoVue

In addition to the wide range of functionality offered by WebCenter Spaces to manage and collaborate on documents through workflows, wiki documents, and Spaces, you also have the option to use Oracle AutoVue.

Note:

To enable Oracle AutoVue functionality, both of the following two requirements must be met:

- You must access the WebCenter Spaces application through Oracle HTTP Server (OHS) to expose Oracle Content Server and the WebCenter Spaces application under the same host and port. For information about setting up OHS as the frontend to WebCenter Spaces, see "Oracle Content Server - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- WebCenter Spaces must be connected to an Oracle Content Server repository, with the webContextRoot parameter set to an Oracle Content Server host name. For information on setting webContextRoot, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. To set webContextRoot through WLST, see "createJCRContentServerConnection" and "setJCRContentServerConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Oracle AutoVue, packaged separately from WebCenter Spaces, integrates easily with an Oracle Content Server back-end repository to provide document review and collaboration features. AutoVue supports a wide range of file types, including Word, Excel, PDF, as well as 2D and 3D CAD file types. For more information about Oracle AutoVue, see http://www.oracle.com/applications/autovue/index.html.

To use Oracle AutoVue to review and collaborate on a file:

1. In the Document Viewer preview pane, click the File menu and choose Annotate with AutoVue.

The Oracle Content Server login screen opens.

2. Log in to Oracle Content Server to open the file in the AutoVue file viewer, where you can provide comments and individualized mark-up.

3. To view the file containing the AutoVue markup, click the AutoVue icon in the Document Viewer preview pane Sidebar (Figure 45-1).

Figure 45-1 AutoVue Icon

46 Working with Microsoft Office and Explorer Integration

WebCenter Spaces integrates with Microsoft Office and Windows Explorer to provide you with flexibility in managing files in a Space when the content repository is Oracle Content Server.

Note:

The Documents service is exposed on the Documents page and administration settings in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, the Documents page is not shown in a Space, and the Documents service is not available in the Space administration settings (Services and Roles). To use the Documents service functionality in 10g, you can create a page in a Space and add Documents service task flows to the page.

The differences in Microsoft Office 2003, 2007, and 2010 mean that each version may support a particular feature in a different way, and one or more versions may not support some of the tasks described in this chapter. Each section in this chapter provides information about which Microsoft Office version supports the task described, and how that support is implemented, where there are differences.

This chapter includes the following sections:

- Section 46.1, "What You Should Know About Microsoft Office and Explorer Integration"

- Section 46.2, "Configuring Microsoft Office Integration with WebCenter Spaces"

- Section 46.3, "Working with Microsoft Word, PowerPoint, and Excel Integration"

- Section 46.4, "Working with Microsoft Windows Explorer Integration"

Audience

This chapter is intended for WebCenter Spaces users interested in using Microsoft Office applications and Windows Explorer to manage information in a Space.

46.1 What You Should Know About Microsoft Office and Explorer Integration

This following sections provide an overview of the added functionality that integration with Microsoft Office and Windows Explorer offers:

- Section 46.1.1, "Understanding WebCenter Spaces Word, PowerPoint, and Excel Integration"

- Section 46.1.2, "Understanding Microsoft Windows Explorer Integration"

46.1.1 Understanding WebCenter Spaces Word, PowerPoint, and Excel Integration

WebCenter Spaces integrates with the Microsoft Office shared document management functionality for working the with Microsoft Word, PowerPoint, or Excel files in a Space (the Home Space or a group Space). This functionality is available in Microsoft Office 2003 and later, when the backend content repository is Oracle Content Server.

Note:

The differences in Microsoft Office 2003, 2007, and 2010 mean that each version may support a particular feature in a different way, and one or more versions may not support some of the tasks described in this chapter. Each section provides information about which version supports the task described, and how that support is implemented, where there are differences.

Microsoft Office shared document management functionality offers alternate ways to perform tasks that can also be performed within WebCenter Spaces, as shown in Table 46-1.

Table 46-1 File Management Tasks

Task

Microsoft Office Document Management

WebCenter Spaces Application

Opening a file.

See Section 46.3.2, "Opening and Editing a File."

See Section 41.10, "Opening a File."

Editing a file.

See Section 46.3.2, "Opening and Editing a File."

Section 41.12, "Editing and Updating a File."

Adding a new file to a Space.

See Section 46.3.4.1, "Adding a File."

See:

- Section 41.14, "Copying and Pasting Folders and Files."

- Section 41.8.1, "Uploading New Files."

Adding a new folder to a Space.

See Section 46.3.4.2, "Adding a New Folder."

See Section 41.7, "Creating a Folder."

Checking a file out and in.

See Section 46.3.4.3, "Checking a File Out" and Section 46.3.4.4, "Checking a File In."

See Section 41.12.1, "Checking a File Out."

Performing actions on the currently open file.

See Section 46.3.4.5, "Managing the Currently Open File."

See Chapter 41, "Working with the Documents Service Task Flows and Document Components."

Performing actions on other files in the current folder.

See Section 46.3.4.6, "Managing Other Files in the Current Space."

See Chapter 41, "Working with the Documents Service Task Flows and Document Components."

Performing actions on subfolders in the current folder.

See Section 46.3.4.7, "Managing Folders."

See Chapter 41, "Working with the Documents Service Task Flows and Document Components."

Viewing link targets.

See Section 46.3.4.8, "Viewing Link Targets."

See Section 63.2.3, "Accessing Link Targets."

Working with file version histories.

See Section 46.3.4.10, "Working with File Version History."

See Section 41.21, "Viewing and Deleting File Version History."

Adding new members to a Space.

See Section 46.3.4.11, "Adding Members to a Space."

See Section 51.14.4, "Granting WebCenter Spaces Users Access to a Space."

Sending a mail message.

See Section 46.3.4.12, "Sending a Message."

See:

- Section 41.24.2, "Mailing the URL for a File"

- Section 65.1, "What You Should Know About the Send Mail Feature"

- Section 65.4.6, "Composing and Sending Mail Messages."

46.1.2 Understanding Microsoft Windows Explorer Integration

WebCenter Spaces integrates with Microsoft Windows Explorer to manage the folders and files in a Space when the backend content repository is Oracle Content Server. To use this functionality, you create a network place in Windows Explorer for the Space documents. See Section 46.4, "Working with Microsoft Windows Explorer Integration."

46.2 Configuring Microsoft Office Integration with WebCenter Spaces

Desktop integration of Microsoft Office with WebCenter Spaces requires the following configuration:

- (All versions of Microsoft Office) If you access the WebCenter Spaces application through Oracle HTTP Server (OHS), you must modify system properties and server configuration files to allow for full integration of Microsoft Office with WebCenter Spaces. For more information, refer to "Configuring Microsoft Clients" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- (All versions of Microsoft Office) If you access the WebCenter Spaces application through Oracle HTTP Server (OHS), set up a virtual host for your application, as described in "Configuring SSO with Virtual Hosts" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- (Microsoft Office 2010 only) If WebCenter is using Windows Integrated authentication, integration with WebCenter Spaces requires no additional configuration. If WebCenter is not configured to use Windows Integrated authentication, you need to modify the registry as described in http://support.microsoft.com/kb/2123563.

46.3 Working with Microsoft Word, PowerPoint, and Excel Integration

WebCenter Spaces integrates with the Microsoft Office shared document management functionality for working with Microsoft Word, Excel, or PowerPoint files that belong to a Space. This functionality is available in Microsoft Office 2003 and later, when the backend content repository is Oracle Content Server. For more information, see Section 46.1.1, "Understanding WebCenter Spaces Word, PowerPoint, and Excel Integration."

Many of the tasks you can perform using the Microsoft Office shared document management functionality can also be performed in WebCenter Spaces, as shown in Table 46-1, and described in Chapter 41, "Working with the Documents Service Task Flows and Document Components."

This section provides steps to perform the following tasks using Microsoft Office shared document management:

- Section 46.3.1, "Creating a Space from a Microsoft Office Document"

- Section 46.3.2, "Opening and Editing a File"

- Section 46.3.3, "Displaying and Hiding the Microsoft Office Task Pane"

- Section 46.3.4, "Working with the Microsoft Office Task Pane"

- Section 46.3.4.1, "Adding a File"

- Section 46.3.4.2, "Adding a New Folder"

- Section 46.3.4.3, "Checking a File Out"

- Section 46.3.4.4, "Checking a File In"

- Section 46.3.4.5, "Managing the Currently Open File"

- Section 46.3.4.6, "Managing Other Files in the Current Space"

- Section 46.3.4.7, "Managing Folders"

- Section 46.3.4.8, "Viewing Link Targets"

- Section 46.3.4.9, "Viewing Document Information"

- Section 46.3.4.10, "Working with File Version History"

- Section 46.3.4.11, "Adding Members to a Space"

- Section 46.3.4.12, "Sending a Message"

- Section 46.3.5, "Closing a File"

Note:

Oracle WebCenter does not implement administrative features of the Microsoft Office shared document management functionality, such as creating a workspace using the task pane, deleting a workspace, or changing a workspace title.

46.3.1 Creating a Space from a Microsoft Office Document

Note:

This feature is available only in Microsoft Office 2007. It is not available in Microsoft Office 2003 or 2010.

With Microsoft Office 2007, you can create a Space from a Microsoft Office document, as long as your permissions on the document are the same as your permissions in WebCenter Spaces.

To create a Space from a Microsoft Office document:

1. If you are using Internet Explorer as a browser, add WebCenter to your list of trusted sites in the browser settings.

2. In the Microsoft Office document, click the Office Button (Figure 46-1) in the top left corner of the Microsoft Office application.

Figure 46-1 Office Button in Microsoft Office

3. From the Publish menu, choose Create Document Workspace (Figure 46-2).

Figure 46-2 Creating a Space from an Office Document

4. The Microsoft Office application displays the Document Management task pane, displaying the file name as the default workspace name.

Note:

If the pane does not display, see Section 46.3.3, "Displaying and Hiding the Microsoft Office Task Pane."

Figure 46-3 Document Management Task Pane: Document Workspace

5. In the Document Workspace name field, type a name for the Space if you want to change the default name.

6. In the Location for new workspace field, type the Explorer URL for the WebCenter Spaces instance. For example:

http://myserver.oracle.com:8888/wcsdocs/conn/myserver-ucm11g/spaces
/WebCenter/

You can find this URL in the About Space dialog for an existing Space, as described in Section 49.5, "Viewing Information About a Space."

7. Click Create.

8. At the prompt, enter your WebCenter Spaces login credentials.

WebCenter Spaces creates the new Space in WebCenter Spaces.

In Microsoft Office, the Status section of the Microsoft Office task pane (see Table 46-2) displays one of the following status messages:

This document is up to date.  If you have unsaved changes, you must save the document before you can update the workspace copy.

A copy of this document is stored in a Document Workspace.  Changes made to your document have not been udpated in the workspace copy.

If you update the document in Microsoft Office, you can simply click the Update Workspace Copy link to synchronize the document with the version in the Space (on the server).

46.3.2 Opening and Editing a File

When you open a Microsoft Office file from WebCenter Spaces, the file is automatically checked out of the Oracle Content Server repository. When you refresh the page in WebCenter Spaces, the Status column for the file shows a Checked Out icon. To make your changes available to other users, you can save and close it in Microsoft Office, or explicitly check the file in using the Microsoft Office task pane.

To open a Microsoft Word, Excel, or PowerPoint file from WebCenter Spaces in-place in its Microsoft Office application:

Note:

If you are using Windows 7 or a 64-bit machine with Firefox 3.6, you may need to install the Java plugin available at http://support.mozilla.com to edit a Microsoft Office file. This plugin is included in Java 6 Update 15 and above.

1. On the Documents page, or in a Documents service task flow on a page, click in the row of the file you want to edit, but not on the file name.

Alternatively, you can edit an open file in the Document Viewer preview pane.

2. Depending on your view and the file type, perform one of the following actions:

- On the Documents page or in a Documents service task flow, from the File menu or the context (right-click) menu, choose the Edit action that opens the file in-place in its Microsoft Office application. For example, for Microsoft Word files, choose Edit with Word (Figure 46-4)

Figure 46-4 Open a File in Microsoft Word

- In the Document Viewer preview pane, click the Edit action.

Note:

If the file is already checked out by another user, the File in Use dialog opens. See Section 46.3.2.1, "Opening a File Already Checked Out By Another User."

3. If prompted, enter the same credentials used to log in to WebCenter Spaces to open the file in-place in its corresponding application.

Note:

The user name and password must contain only ASCII characters. A user name or password containing multi-byte characters cannot be successfully authenticated.

- In Microsoft Office 2003. The Microsoft Office application displays a Shared Workspace task pane by default (Figure 46-5).

- In Microsoft Office 2007. The Microsoft Office application displays no task pane by default. To display the Document Management task pane, see Section 46.3.3, "Displaying and Hiding the Microsoft Office Task Pane."

Figure 46-5 Microsoft Office 2003 Shared Workspace Task Pane

4. When the file opens, it is automatically checked out. In WebCenter Spaces, click the Refresh icon to show the Checked Out icon for the selected file (Figure 46-6).

Figure 46-6 Checked Out Icon in WebCenter Spaces

5. Make required updates, then save and close the file.

The modified file is automatically checked back in.

You can use the Microsoft Office task pane to open other files in the Space directly from Microsoft Office, instead of from WebCenter Spaces. See Section 46.3.4.6, "Managing Other Files in the Current Space."

46.3.2.1 Opening a File Already Checked Out By Another User

If the file that you attempt to open is already checked out by another user, the File In Use dialog opens (Figure 46-7).

Figure 46-7 File in Use Dialog

In the File In Use dialog, select the desired option:

- Open a Read Only copy to open the file in its default application to view it.

- Create a local copy and merge your changes later is not supported.

- Receive notification when the original copy is available to open a read-only copy of the file until it is available for editing. When the file is available, the File Now Available dialog (Figure 46-8) notifies you; in the dialog, click Read-Write to change the read-only state to editable.

Figure 46-8 File Now Available Dialog

46.3.3 Displaying and Hiding the Microsoft Office Task Pane

Note:

The Microsoft Office task pane is available only in Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

In Microsoft Office 2003, the task pane displays by default when you open a file, whereas in Microsoft Office 2007, the task pane does not display by default.

You can manage the display of the Microsoft Office task pane as described in the following sections:

- Section 46.3.3.1, "Displaying or Hiding the Task Pane Manually"

- Section 46.3.3.2, "Displaying or Hiding the Task Pane By Default"

46.3.3.1 Displaying or Hiding the Task Pane Manually

To display or hide the Microsoft Office task pane manually:

In Microsoft Office 2003:

- From the Tools menu, choose Shared Workspace to toggle between displaying and hiding the task pane.

In Microsoft Office 2007:

1. Click the Office Button (Figure 46-9) in the top left corner of the Microsoft Office application.

Figure 46-9 Office Button in Microsoft Office

2. From the Server menu, choose Document Management Information to toggle between displaying and hiding the Document Management task pane (Figure 46-10).

Figure 46-10 Microsoft Office 2007 Document Management Task Pane

46.3.3.2 Displaying or Hiding the Task Pane By Default

To display or hide the Microsoft Office task pane automatically by default every time you open a Microsoft Word, Excel, or PowerPoint file:

In Microsoft Office 2003:

1. From the Tools menu, choose Options.

2. In the Options dialog, on the General tab, click Service Options.

3. In the Shared Workspace category, select or clear the checkbox The document is part of a workspace or SharePoint site to respectively display or hide the task pane by default.

In Microsoft Office 2007:

1. At the bottom of the Microsoft Office task pane, click Options (Figure 46-11).

Figure 46-11 Options Link in Task Pane (Microsoft Office 2007)

2. In the Service Options dialog, select or clear the checkbox The document is part of a workspace or SharePoint site to respectively display or hide the task pane by default.

46.3.4 Working with the Microsoft Office Task Pane

Note:

The Microsoft Office task pane is available only in Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

The Microsoft Office task pane provides information pertaining to the currently open file and access to tasks for all folders and files in the current Space, as described in Table 46-2.

Table 46-2 Microsoft Office Task Pane for Files in a Space

Task Pane Area

Description

Top section in Microsoft Office 2003:

Top section in Microsoft Office 2007:

Dropdown menu:

For a file in the Home Space:

- Shows the user name.

- Open site in browser. Click to display the WebCenter Spaces Home page.

For a file in a Space:

- Shows the Space name.

- Open site in browser. Click to display the Space Home page.

Additionally, the top section provides a dropdown menu of actions available for the user or Space:

- Open Site in Browser. See above.

- Change Site Title. Not supported.

- Change Site Settings. For the Home Space, displays the WebCenter Spaces Home page; for a Space, displays the Settings tab of the Space.

- Disconnect from Workspace. Not supported.

- Delete Workspace. Not supported.

Status section in Microsoft Office 2003:

Status section in Microsoft Office 2007:

Dropdown menu:

Displays information only if the file is checked out.

Shows the following information:

- The user who checked out the file.

- Check in link. See Section 46.3.4.4, "Checking a File In."

After checking a file in, you can subsequently check the file out again. See Section 46.3.4.3, "Checking a File Out."

Additionally, the Status section provides a dropdown menu of actions available for the user:

- Schedule a Meeting. Opens the Microsoft Outlook calendar scheduler.

- Call. Not supported.

- Send Mail. Opens a Microsoft Outlook message with the To field populated with the mail address that is specified for the user in WebCenter Spaces. See Section 46.3.4.12, "Sending a Message." This selection has the same effect as clicking the user name in the Members section.

- Additional Actions. Not supported.

- Add to Outlook Contacts. Opens the Microsoft Outlook Contacts page populated with contact information for the user.

- Outlook Properties. Opens the Microsoft Outlook E-mail Properties dialog.

Members section:

Dropdown menu:

For a file in the Home Space:

- Lists the current people connections.

- Add new members. Not supported for Home Space.

- Send e-mail to all members. See Section 46.3.4.12, "Sending a Message."

For a file in a Space:

- Lists the user editing the file, followed by the user and group names of all Space members, up to the limit of 99 members. The distinction between Online and Not Online users is not supported; all Space members show in the list as Not Online.

- Add new members. See Section 46.3.4.11, "Adding Members to a Space."

- Send e-mail to all members. See Section 46.3.4.12, "Sending a Message."

Additionally, the Members section provides a dropdown menu of actions available for the listed member(s). The actions in this menu are not supported.

To send a message to any member, simply click the member's user name to open a Microsoft Outlook window with the To field populated with the mail address that is specified for the member in WebCenter Spaces.

Tasks section:

Not supported.

Documents section:

Provides access to other files in the current Space directly from Microsoft Office.

Sort by. Choose from the menu to sort the list of documents by Creation Date, Modified Date, File Name, File Type, Ascending, or Descending.

- Shows all folders and files in the folder where the open file resides. See Section 46.3.4.6, "Managing Other Files in the Current Space."

Note: Navigating upward in the folder hierarchy from the current document is not supported; you can drill down and then back up to the current level.

- Provides a menu of actions available on the currently open file. See Section 46.3.4.5, "Managing the Currently Open File."

- Provides a menu of actions available on other documents in the list. See Section 46.3.4.6, "Managing Other Files in the Current Space."

- Provides a menu of actions for each folder listed. See Section 46.3.4.7, "Managing Folders."

- Add new document. See Section 46.3.4.1, "Adding a File."

- Add new folder. See Section 46.3.4.2, "Adding a New Folder."

- Alert me about documents. Not supported. Opens the Home page in WebCenter Spaces.

Links section:

The Links section shows all document and URL links defined in WebCenter Spaces to the currently open file.

Sort by. Choose from the menu to sort the list of links by Creation Date, Modified Date, URL, Ascending, or Descending.

- Lists all links for the currently open file. See Section 46.3.4.8, "Viewing Link Targets." Click a link to navigate to the linked object.

Document Information section (Microsoft Office 2003 only):

Provides information about the currently open document:

- Document Information. See Section 46.3.4.9, "Viewing Document Information."

- Restrict permission. Not supported.

- Alert me about this document. Not supported. Opens the Home page in WebCenter Spaces.

- Check out or Check in. See Section 46.3.4.3, "Checking a File Out" and Section 46.3.4.4, "Checking a File In."

- Version history. See Section 46.3.4.10, "Working with File Version History."

Bottom section:

Includes:

- Get Updates. Refreshes the files and associated information from the WebCenter Spaces server.

- Options. Opens the Service Options dialog. Refer to the Microsoft Office online help for more information.

- Shows the date and time that the file was last modified.

The following sections describe the tasks you can perform using the Microsoft Office task pane:

- Section 46.3.4.1, "Adding a File"

- Section 46.3.4.2, "Adding a New Folder"

- Section 46.3.4.3, "Checking a File Out"

- Section 46.3.4.4, "Checking a File In"

- Section 46.3.4.5, "Managing the Currently Open File"

- Section 46.3.4.6, "Managing Other Files in the Current Space"

- Section 46.3.4.7, "Managing Folders"

- Section 46.3.4.8, "Viewing Link Targets"

- Section 46.3.4.9, "Viewing Document Information"

- Section 46.3.4.10, "Working with File Version History"

- Section 46.3.4.11, "Adding Members to a Space"

- Section 46.3.4.12, "Sending a Message"

46.3.4.1 Adding a File

Using the Microsoft Office shared document management functionality, you can add a new file to the Oracle Content Server repository, exposing the file in a Space, as described in the following sections:

- Section 46.3.4.1.1, "Saving a File As a New File in a Space" (Microsoft Word, Excel, or PowerPoint file only)

- Section 46.3.4.1.2, "Adding a New File Using the Task Pane" (files of any type)

Note:

Other methods to add a file to the connected content repository are:

- Create a network place to a Space, then use Windows Explorer to add files of any type when the backend content repository is Oracle Content Server, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

- In WebCenter Spaces, copy and paste, upload, or create a file using the Rich Text Editor (RTE), as described in Section 41.14, "Copying and Pasting Folders and Files," Section 41.8.1, "Uploading New Files," and Section 41.12, "Editing and Updating a File."

46.3.4.1.1 Saving a File As a New File in a Space

To save a local Microsoft Word, Excel, or PowerPoint file to a Space:

Note:

This feature is supported in Microsoft Office 2003 and 2007 only.

1. Add the Space as a new network place in Windows Explorer, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

2. Open the file in its Microsoft Office application.

3. (In Microsoft Office 2007 only) Set save options for shared documents:

1. Click the Office Button in the top left corner of the Microsoft Office application, then click Word Options (Figure 46-12) at the bottom of the menu.

Figure 46-12 Office Button Menu: Word Options

2. In the Word Options dialog, select Save in the left pane (Figure 46-13).

3. Under Offline editing options for document management server files, select The web server (Figure 46-13).

Figure 46-13 Word Options Dialog

4. Publish the file to the Space:

In Microsoft Office 2003. From the File menu, choose Save As.

In Microsoft Office 2007. Click the Office Button, then choose either:

- Publish, then Document Management Server.

- Or, Save As, then Application Document.

5. In the Save As dialog, select the Space network place, then click Save. For more information about Space network place URLs, see Section 46.4.1, "Adding a Space as a Network Place."

6. Enter login credentials for WebCenter Spaces, then click OK.

7. In WebCenter Spaces, on the Documents page of the Space, click the Refresh icon to confirm that the file was added.

Note:

To make the file visible to others, you must check the file in. See Section 46.3.4.4, "Checking a File In."

8. To display the Microsoft Office task pane in the open file, see Section 46.3.3, "Displaying and Hiding the Microsoft Office Task Pane."

46.3.4.1.2 Adding a New File Using the Task Pane

To add a new file to a Space using the Microsoft Office task pane:

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

1. Open a Microsoft Word, Excel, or PowerPoint file to use the Microsoft Office shared document management functionality (see Section 46.3.2, "Opening and Editing a File").

2. At the bottom of the Documents section of the task pane, click Add new document (Figure 46-14).

Figure 46-14 Task Pane Documents Section: Adding a New File

The Add New Document dialog opens (Figure 46-15).

Figure 46-15 Add New Document Dialog

3. Browse to the file that you want to add to the current Space.

Note:

WebCenter Spaces supports files up to 2GB in size.

The checkbox Make workspace updates available when I open my copy is not supported.

4. Click OK.

The new file displays at the top of the document list in the Documents section of the Microsoft Office task pane. When you refresh the Documents page of the Space in WebCenter Spaces, the file appears in the document list in alphabetical order.

46.3.4.2 Adding a New Folder

Using the Microsoft Office shared document management functionality, you can add a new folder to the Oracle Content Server repository, exposing the folder in a Space.

Note:

Other methods to add a new folder to a Space are:

- Create a network place to a Space, then use Windows Explorer to add a folder, as described in Section 46.4, "Working with Microsoft Windows Explorer Integration."

- Use the WebCenter Spaces application to add a folder to any connected content repository, as described in Section 41.7, "Creating a Folder."

To add a new folder to a Space using the Microsoft Office task pane:

1. Open a Microsoft Word, Excel, or PowerPoint file in the Space to use the Microsoft Office shared document management functionality (see Section 46.3.2, "Opening and Editing a File").

2. At the bottom of the Documents section of the task pane, click Add new folder (Figure 46-16).

Figure 46-16 Task Pane Documents Section: Adding a New Folder

The Add New Folder dialog opens (Figure 46-17).

Figure 46-17 Add New Folder Dialog

3. Enter a name for the new folder, then click OK.

Note:

The rules for folder names follow the Windows Explorer standards.

The new folder displays at the top of the document list in the Documents section of the Microsoft Office task pane. When you refresh the Documents page of the Space in WebCenter Spaces, the folder appears in the folder list in alphabetical order.

46.3.4.3 Checking a File Out

Note:

To check any file out using the WebCenter Spaces application, see Section 41.12.1, "Checking a File Out."

When you open a Microsoft Office file in a Space using the Microsoft Office shared document management functionality, the file is automatically checked out from the Oracle Content Server repository. If you have been granted the appropriate permissions, you can open and check a file out in two environments:

- From WebCenter Spaces. Open a file in-place (see Section 46.3.2, "Opening and Editing a File") to automatically check out the file.

- (Microsoft Office 2003 and 2007) From the Microsoft Office task pane. In the Documents section of the task pane, click a file name to automatically check out the file and open it in its default Microsoft Office application.

46.3.4.3.1 Checking the Currently Open File Out Again After Checking It In

After you check a file in (see Section 46.3.4.4, "Checking a File In"), the file remains displayed in Microsoft Office until you close it (see Section 46.3.5, "Closing a File"). If you want to check in further changes to the file, it must be checked out again:

- In Microsoft Office 2003. In the Document Information section of the Microsoft Office task pane, you can optionally click Check out to check the file out again (Figure 46-18). However, even if you do not explicitly check out the file, you can continue to edit the file, then save it, and the Status and Document Information sections of the task pane automatically provide a Check in link to check the changed file back in to the repository.

Figure 46-18 Checking Out a Checked In File

- In Microsoft Office 2007 and 2010. When you check a file in, the Check In dialog (Figure 46-21) provides a checkbox labeled Keep the document checked out after checking in this version:

- Select the checkbox to keep the file checked out after checking in the current version. This allows you to refresh the version of the file available to other users, yet still retain the checked out status to make further changes.

- Clear the checkbox to check the file in and cancel the checked out status.

If you clear the checkbox, you can optionally check the file out again:

- Click Edit Document in the area below the toolbar (Figure 46-19).

After you check a file in, Microsoft Office 2007 locks editing that file until you click Edit Document.

Figure 46-19 Checking Out and Editing the Current Document

46.3.4.4 Checking a File In

When you open a file using the Microsoft Office shared document management functionality, you can check it back in to the repository, whether or not you have made changes to it.

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

In Microsoft Office 2010, you can find file checkin and checkout information on the Info tab (from the File menu, choose Info). When a file is opened in Microsoft Office 2010, it is automatically checked out, changes are (temporarily) applied when saved, and the file is automatically checked in when the file is closed, with a default checkin comment. There is no explicit Check in option in Microsoft Office 2010.

Note:

Intermittently saving the file saves it on the server, but changes are not visible to others until you check the file in. To update the file stored in the WebCenter Spaces repository, you must either save and close it, or explicitly check it in. If you close the Microsoft Office application and do not check the file in when prompted, your changes are lost.

To check a file in:

1. In the Status section of the Microsoft Office task pane, click Check in.

Note:

In Microsoft Office 2003, you can also find Check in in the Document Information section of the task pane.

2. In Microsoft Office 2003. In the Check In Comments dialog (Figure 46-20), optionally enter comments about the changes made to the file since it was last checked out.

Figure 46-20 Check In Comments Dialog (Microsoft Office 2003)

In Microsoft Office 2007. In the Check In dialog (Figure 46-21), optionally enter comments about the changes made to the file since it was last checked out, and select the state in which to leave the file:

Figure 46-21 Check In Dialog (Microsoft Office 2007 and 2010)

- Select the checkbox to keep the file checked out after checking in the current version. This allows you to refresh the version of the file available to other users, yet still retain the checked out status to make further changes.

- Clear the checkbox to check the file in and cancel the checked out status. To check the file out again, see Section 46.3.4.3.1, "Checking the Currently Open File Out Again After Checking It In."

3. Click OK.

If the file was modified since its prior version, it is automatically saved and checked in to WebCenter Spaces as a new version. If check in comments were entered in the Check In dialog, a new file revision is created with the new comments, which display as the file description in WebCenter Spaces (Figure 46-22).

Figure 46-22 Documents Listing in WebCenter Spaces after Check In

4. After checking a file in, the file remains displayed in Microsoft Office until you close it (see Section 46.3.5, "Closing a File"). If you wish to make further changes to the file, see Section 46.3.4.3.1, "Checking the Currently Open File Out Again After Checking It In.":

5. When you have finished making changes and checking in the file, close the Microsoft Office application (see Section 46.3.5, "Closing a File").

46.3.4.5 Managing the Currently Open File

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

To manage the currently open file using the Microsoft Office task pane:

1. In the Documents section of the task pane, click the dropdown menu icon to the right of the file name (Figure 46-23).

Figure 46-23 Task Pane Documents Section: Current File Menu

2. Select an available action, as described in Table 46-3:

Table 46-3 Dropdown Menu Actions for Currently Open File

Menu Action

Description

Open in Microsoft Office Application

Not applicable.

Delete

Not supported. To delete a file in a Space, you must use the WebCenter Spaces application (see Section 41.16, "Deleting Folders and Files") or Windows Explorer (see Section 46.4, "Working with Microsoft Windows Explorer Integration").

Alert Me About This Document

Not supported. Opens the home page of the Space in WebCenter Spaces.

Check Status

Displays the Status section of the task pane.

Document Updates

Not supported.

Save Updatable Copy

Not supported.

Create Document Workspace

Not supported.

Publish Back to Source Location

Not supported.

46.3.4.6 Managing Other Files in the Current Space

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

To manage a file other than the currently open file in the current Space using the Microsoft Office task pane:

1. In the Documents section of the task pane, navigate to the file.

Note:

Navigating upward in the folder hierarchy from the current document is not supported; you can drill down and then back up to the current level.

2. To open the file, click its name.

Depending on the file type, the file opens as described in Section 46.3.2, "Opening and Editing a File" for Microsoft Word, Excel, and PowerPoint files, or Section 41.10, "Opening a File" for other file types (such as HTML files or images).

Note:

If you have OpenOffice installed, an error may occur when attempting to open a file from the task pane. To resolve the error, uninstall OpenOffice.

3. To perform other actions, click the dropdown menu icon to the right of a file name (Figure 46-24):

Figure 46-24 Task Pane Documents Section: Other Files Menu

4. Select an available action, as described in Table 46-4:

Table 46-4 Dropdown Menu Actions for Other Files

Menu Action

Description

Open in Microsoft Office Application

Attempts to check out the file: if checked out by another user, it opens read-only; if not checked out, the file opens in its Microsoft Office application for editing. For more information, see Section 46.3.2, "Opening and Editing a File."

Delete

Not supported. To delete a file in a Space, you must use the WebCenter Spaces application (see Section 41.16, "Deleting Folders and Files") or Windows Explorer (see Section 46.4, "Working with Microsoft Windows Explorer Integration").

Alert Me About This Document

Not supported. Opens the home page of the Space in WebCenter Spaces.

46.3.4.7 Managing Folders

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

To manage a folder under the current folder using the Microsoft Office task pane:

1. In the Documents section of the task pane, navigate to the folder.

Note:

Navigating upward in the folder hierarchy from the current document is not supported; you can drill down and then back up to the current level.

2. To open the folder, click its name.

3. To perform other actions, click the dropdown menu icon to the right of the folder name (Figure 46-25):

Figure 46-25 Task Pane Documents Section: Folder Menu

4. Select an available action, as described in Table 46-5:

Table 46-5 Dropdown Menu Actions for a Folder

Menu Action

Description

View Contents

Refreshes the list of files with the contents of the folder only (same effect as clicking the folder name). Click the folder name to refresh to the original list.

Delete

Not supported. To delete a folder in a Space, you must use the WebCenter Spaces application (see Section 41.16, "Deleting Folders and Files") or Windows Explorer (see Section 46.4, "Working with Microsoft Windows Explorer Integration").

46.3.4.8 Viewing Link Targets

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

The Links section of the Microsoft Office task pane lists the links defined in WebCenter Spaces that are associated with the currently open file (Figure 46-26). Files can have links to related documents, discussions, announcements, events, and notes; the Links section in the task pane shows the links to associated documents and notes.

Links are prefixed with the name of the service with which they are associated. For example, a link to another document is prefixed Document, a link to a note is prefixed URL.

Figure 46-26 Task Pane Links Section

To display the target of a link, simply click the link:

- Document links open in the same way as files in the Document section, namely Microsoft Word, Excel, and PowerPoint files open in Microsoft Office with a task pane, and other file types open in their default viewer or a browser.

- URL links open a browser window displaying the link target.

46.3.4.9 Viewing Document Information

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

In Microsoft Office 2003: The Document Information section of the Microsoft Office task pane shows the user who last modified the file and the modified date (Figure 46-27).

Figure 46-27 Task Pane Document Information Section (Microsoft Office 2003 Only)

In Microsoft Office 2007. Information about the user who last modified the file and the modified date is shown in the Version History. See Section 46.3.4.10, "Working with File Version History."

46.3.4.10 Working with File Version History

Whenever you check in a file or upload a file into a folder that already contains a file of the same name, WebCenter Spaces creates a new version of the file. When a file has multiple versions, it has a version history.

Note:

To use the WebCenter Spaces application to work with the version history of a file in any connected content repository, see Section 41.21, "Viewing and Deleting File Version History."

In Microsoft Office 2003: To view the version history of the currently open file using the Microsoft Office task pane:

1. In the Document Information section of the task pane, click Version history (Figure 46-28).

Figure 46-28 Task Pane Document Information Section: Version History

The version history dialog for the file opens (Figure 46-29):

Figure 46-29 Version History for Currently Open File in Microsoft Office 2003

In the version history dialog, select a file version, then select the desired action:

- Open to open the selected file version read-only.

- Restore is not supported.

- Delete to delete the selected file version (inactive for the most recent version).

- View Comments to display the comments entered for the selected file version (most useful when the comments are especially long).

2. To open the Documents page in the current Space, click Modify settings for document versions.

In Microsoft Office 2007: To view the version history of the currently open file:

1. Click the Office Button (Figure 46-30) in the top left corner of the Microsoft Office application.

Figure 46-30 Office Button in Microsoft Office

2. From the Server menu, choose View Version History.

The version history dialog for the file opens (Figure 46-31):

Figure 46-31 Version History for Currently Open File in Microsoft Office 2007

3. In the version history dialog, select a file version, then select the desired action:

- Open to open the selected file version read-only.

- Compare to compare the selected file version with the currently open file.

- Restore is not supported.

- Delete to delete the selected file version (inactive for the most recent version).

4. To view the check in comments for a file version, click the link under Comments.

5. To open the Documents page in the Space, click the link next to Versions saved to.

In Microsoft Office 2010: To view the version history of the currently open file:

- From the File menu, choose Info.

The Info tab shows version history information on the Info tab in the Versions section. Refer to the Microsoft Office online help for more information.

46.3.4.11 Adding Members to a Space

Note:

To add members to a Space using the WebCenter Spaces application, see Section 52.3, "Managing Members and Assigning Roles."

If you are granted the moderator role or Manage All permissions in a Space, you can add new members to a Space using the Microsoft Office task pane. The currently open file must be a Space document.

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

To add members to a Space when the currently open file is a Space document:

1. In the Members section of the task pane, click Add new members.

The Add New Members dialog opens (Figure 46-32).

Figure 46-32 Add New Members Dialog

2. Enter the login names or mail addresses of the users you want to add to the Space, separated by semicolons.

Note:

Users who are already members of the Space cannot be added again. The user names that you enter must have an associated mail address defined in WebCenter Spaces.

3. From the site group dropdown list, select the role to be given to the listed users. The listed roles are those defined for the current Space. The permissions granted to each role are defined by the WebCenter Spaces administrator or Space moderator. For more information about Space roles, see Section 52.2, "Managing Roles and Permissions for a Space."

Note:

To define different roles to different users, limit the list of users to those who should be assigned the same role, finish this assignment, then click Add new members again to assign a different role to one or more different users.

4. Click Next.

5. Confirm or modify the member information, then click Finish.

6. In the Add New Members dialog (Figure 46-33), select or clear the checkbox to send an invitation to the new members to join the Space, then click OK.

Figure 46-33 Add New Members Dialog

46.3.4.12 Sending a Message

From the Microsoft Office task pane, you can send a message to any user who has a mail address defined in WebCenter Spaces:

- Section 46.3.4.12.1, "Sending a Message to the Current User"

- Section 46.3.4.12.2, "Sending a Message to Your Connections"

- Section 46.3.4.12.3, "Sending a Message to Members of a Space"

Note:

This feature is available with Microsoft Office 2003 and 2007. Microsoft Office 2010 does not include a task pane.

Note:

To send messages using the WebCenter Spaces application, see Section 51.15, "Sending Mail to Space Members or Moderators", Section 65.1, "What You Should Know About the Send Mail Feature", and Section 65.4.6, "Composing and Sending Mail Messages."

46.3.4.12.1 Sending a Message to the Current User

To send a message to the user who has the currently open document checked out:

- In the Status section of the Microsoft Office task pane, click the dropdown menu icon next to the user name, and choose Send Mail (Figure 46-34).

Figure 46-34 Send a Message to the Current Document User

A Microsoft Outlook message composition window opens with the To field populated with the mail address that is specified for the user in WebCenter Spaces.

46.3.4.12.2 Sending a Message to Your Connections

To send a message to your connections when you are working with a document in the Home Space:

1. In the Members section of the Microsoft Office task pane:

- To send a message to an individual who is one of your connections, click the user name in the Members list (Figure 46-35):

Figure 46-35 Send a Message to a Connection

- To send a message to all of your connections, click Send e-mail to all members (Figure 46-36).

Figure 46-36 Send a Message to All Connections

A Microsoft Outlook message composition window opens, where the Home Space name is the subject, and the To field is populated with the mail address(es) specified for the people connection(s) in WebCenter Spaces.

2. Modify the addresses and content of the message as desired, then click Send.

46.3.4.12.3 Sending a Message to Members of a Space

To send a message to the members of a Space when you are working with a document in a Space:

1. In the Members section of the Microsoft Office task pane:

- To send a message to an individual who is a member of the Space, click the user name in the Members list (Figure 46-37):

Figure 46-37 Send a Message to an Individual Space Member

- To send a message to all members of the Space, click Send e-mail to all members.

Figure 46-38 Send a Message to All Space Members

A Microsoft Outlook message composition window opens, where the Space name is the subject, and To field is populated with the mail address(es) specified for the Space member(s) in WebCenter Spaces

2. Modify the addresses and content of the message as desired, then click Send.

46.3.5 Closing a File

You can close a file opened in a Microsoft Office application with or without checking it in, as described in the following sections:

- Section 46.3.5.1, "Closing a File After Checking It In"

- Section 46.3.5.2, "Closing a File Before Checking It In"

46.3.5.1 Closing a File After Checking It In

After checking a file in, the file remains open in the Microsoft Office application until you close it.

To close a file after you have checked it in (see Section 46.3.4.4, "Checking a File In"):

- From the File menu, choose Close.

46.3.5.2 Closing a File Before Checking It In

If you attempt to close a file or the Microsoft Office application before you have checked the file in, the Check In dialog provides the opportunity to check it in or cancel the check out and discard changes to the file. The selections in the Check In dialog are dependent on whether or not the file has been modified since the last time it was checked in.

46.3.5.2.1 Closing an Unchanged File

In Microsoft Office 2003: To close a file that has not been modified since the last time it was checked in:

1. From the File menu, choose Close.

2. In the Check In dialog (Figure 46-39), select one of the following actions:

Figure 46-39 Check In Dialog for File with No Changes (Microsoft Office 2003)

- Check in file to check the file in with no changes. In the Check In Comments dialog (Figure 46-20), optionally enter new comments, then click OK.

- Keep checked out to close the file, but keep it in a checked out and locked to changes by other users. To later cancel the checked out status, see Section 41.12.1, "Checking a File Out."

- Discard changes and undo check out to cancel the checked out status.

3. Click OK.

In Microsoft Office 2007: To close a file that has not been modified since the last time it was checked in:

- Click the Office Button (Figure 46-40) in the top left corner of the Microsoft Office application, then choose Close.

Figure 46-40 Office Button in Microsoft Office

Microsoft Office 2007 does not prompt you to first check the file back in again, so the file remains in a checked out state and locked to changes by other users. To later cancel the checked out status, see Section 41.12.1, "Checking a File Out."

46.3.5.2.2 Closing an Updated File

In Microsoft Office 2003: To close a file that has been modified since the last time it was checked in:

1. From the File menu, choose Close.

2. In the Check In dialog (Figure 46-41), select one of the following actions:

Figure 46-41 Check In Dialog for File with Changes (Microsoft Office 003)

- Save changes and check in to save the changes since the last check in and check the file in.

- Save changes only to save changes since the last check in, but keep the file checked out and locked to changes by other users. To later cancel the checked out status, see Section 41.12.1, "Checking a File Out."

- Discard changes and undo check out to retain the prior saved version of the file and cancel the checked out status.

- Discard changes only to retain the prior saved version of the file and keep the file checked out.

3. Click OK.

In Microsoft Office 2007: To close a file that has been modified since the last time it was checked in:

1. Click the Office Button (Figure 46-42) in the top left corner of the Microsoft Office application, then choose Close.

Figure 46-42 Office Button in Microsoft Office

2. If you have not already saved the changes, respond to the confirmation prompt to save or discard your changes.

3. In the confirmation dialog (Figure 46-43), respond to the prompt:

Figure 46-43 Close File Confirmation Prompt (Microsoft Office 2007)

- Yes to display the Check In dialog where you can enter version comments and select whether or not you want the file to remain checkout out (see Section 46.3.4.4, "Checking a File In"). If you choose to keep the file checked out and locked to changes by other users, see Section 41.12.1, "Checking a File Out" to later cancel the checked out status.

- No to keep the file checked out and locked to changes by other users. To later cancel the checked out status, see Section 41.12.1, "Checking a File Out."

46.4 Working with Microsoft Windows Explorer Integration

WebCenter Spaces integrates with Microsoft Windows Explorer to manage the folders and files in the Home Space or a group Space when the backend content repository is Oracle Content Server.

In WebCenter Spaces, the most useful feature of Windows Explorer integration is the ability to add multiple files at once to a Space, rather than uploading up to 10 files at a time (see Section 41.8.1, "Uploading New Files"). It is important to be aware that Windows Explorer is not designed as a content repository, so if you try to open, delete, or rename a file that is checked out by another user, an error message displays to notify you that the operation failed, but the error message will not be specific as to the cause of the failure.

To expose the folders and files in a Space in Windows Explorer, you create a new Windows network place to work with the files, as described in the following sections:

- Section 46.4.1, "Adding a Space as a Network Place"

- Section 46.4.2, "Working with Files Using Windows Explorer"

46.4.1 Adding a Space as a Network Place

To expose the folders and files in a Space using Windows Explorer, you can add the Space as a Windows network place.

To add a Space as a Windows network place:

1. In Microsoft Windows, open My Network Places and click Add Network Place. Refer to the Microsoft Windows online help for more information.

2. In the Add Network Place wizard, enter the network address using the following format:

- To access all Spaces in your WebCenter Spaces application through Windows Explorer:

http://hostname:port/wcsdocs/conn/repository_server/spaces/

For example:

http://myserver:8888/wcsdocs/conn/myserver-ucm/spaces/

- To access the Home Space through Windows Explorer:

http://hostname:port/wcsdocs/conn/repository_server/spaces/PersonalSpaces/username

For example:

http://myserver:8888/wcsdocs/conn/myserver-ucm/spaces/PersonalSpaces/wcsadmin

- To access a specific Space through Windows Explorer, open the About Space dialog, and copy the Explorer URL. See Section 49.5, "Viewing Information About a Space."

http://hostname:port/wcsdocs/conn/repository_server/spaces/instance/spacename

For example:

http://myserver:8888/wcsdocs/conn/myserver-ucm/spaces/WebCenter/philatelists

Tip:

The host name and port is shown in the browser URL for your WebCenter Spaces application.

To find the name of the repository server, view the information for any Space in the WebCenter Spaces application, and note the name of the content repository specified by the Explorer URL. See Section 49.5, "Viewing Information About a Space."

3. At the prompt, enter your WebCenter Spaces login credentials.

4. Optionally enter a name for the Space network place, then click Finish.

Windows Explorer displays a drive for all Spaces or the folders and files of Space, depending on the URL you entered.

46.4.2 Working with Files Using Windows Explorer

Once you have created a Windows network place to a Space (see Section 46.4.1, "Adding a Space as a Network Place"), you can manage the folders and files using Windows Explorer.

Note:

If you change the internal name of a Space (see Section 51.14.2, "Changing a Space URL"), the original network place to that individual Space is no longer accessible. You will need to add the Space as a Windows network place again using the new Space internal name. Changing the internal name of a Space has no effect if you create a network place to the parent URL for all Spaces (http://hostname:port/wcsdocs/conn/repository_server/spaces/).

In Windows Explorer, navigate to the network place for the Space to perform any of the following actions:

- Copy and paste folders and files from your local file system.

- Create folders and files.

- Delete folders and files if not checked out by another user.

- Open Microsoft Word, Excel, and PowerPoint files using the Microsoft Office shared document functionality. See Section 46.3, "Working with Microsoft Word, PowerPoint, and Excel Integration."

- Open other file types in their default applications.

When you open a file, an attempt is made to check the file out. If it is checked out by another user, or you do not have permissions to update the file, it will open read-only. A file remains checked out until you check it back in (see Section 46.3.4.4, "Checking a File In").

The changes you make in Windows Explorer are reflected in WebCenter Spaces, and vice versa.

Note:

To use the WebCenter Spaces application to manage folders and files in a Space in any connected content repository, see Chapter 41, "Working with the Documents Service Task Flows and Document Components."

47 Working with Wiki Documents

WebCenter Spaces enables you to create wiki documents that authorized users can use to collaborate to create content that is relevant, useful, and up-to-date.

This chapter describes how to create and manage wiki documents. It includes the following sections:

- Section 47.1, "What You Should Know About Wikis"

- Section 47.2, "Creating a Wiki Document"

- Section 47.3, "Editing a Wiki Document"

- Section 47.4, "Exposing an Existing Wiki Document"

- Section 47.5, "Comparing Versions of a Wiki Document"

- Section 47.6, "Managing Wiki Documents"

Note:

The tasks described in this chapter are available only if Oracle Content Server 11g is configured as the content repository.

Audience

This chapter is intended for WebCenter Spaces users interested in creating and managing wiki documents. Much of this information applies to any WebCenter Portal application, though it is written with WebCenter Spaces users in mind.

47.1 What You Should Know About Wikis

Wiki documents epitomize the concepts of community and collaboration by allowing all authorized community members to contribute their information to a body of knowledge. Wiki documents are web pages that offer in-place editing using HTML or a simple mark-up language called wiki mark-up. Users with sufficient permissions on a wiki document can add, revise, or delete content. Wikipedia (http://www.wikipedia.com) is a widely-known example of the use of wiki documents. Users from all over the world collaborate to create and edit Wikipedia pages, resulting in a rich, dynamic knowledge base for everyone's benefit.

The following subsections discuss the requirements for creating and managing wiki documents in a WebCenter Spaces application:

- Section 47.1.1, "Prerequisites for Enabling Wiki Functionality"

- Section 47.1.2, "Permissions Required for Working with Wiki Documents"

47.1.1 Prerequisites for Enabling Wiki Functionality

In WebCenter Spaces, you create and manage wiki documents through the Documents service. To support wiki functionality, the Documents service relies on Oracle Content Server, the content repository that stores the wiki documents.

For wiki functionality to be available in WebCenter Spaces, the following prerequisites must be met:

- Oracle Content Server 11g must be configured as the content repository for WebCenter Spaces. The wiki functionality is not available with Oracle Content Server 10g. For information about setting up a connection to Oracle Content Server, see "Registering Content Repositories" section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- The Documents service must be enabled for the Space in which you plan to create wiki documents. For information, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."

47.1.2 Permissions Required for Working with Wiki Documents

You can create wiki documents using either of the two methods:

- New Wiki Document action through Documents service task flows, as described in Section 47.2.2, "Creating a Wiki Document Using the New Wiki Document Action"

- Wiki page syle, as described in Section 47.2.3, "Creating a Wiki Document Using the Wiki Page Style"

To create a wiki document using the New Wiki Document action and edit the document, you must be granted the Create and Edit Documents permission (Figure 47-1). To delete wiki documents, you require the Delete Documents permission. These permissions are available to the Moderator and Participant roles by default.

Figure 47-1 Documents Service Permissions

To create and edit wiki documents using the Wiki page style, you must be granted Page service permissions in addition to the Documents service permissions:

- Standard permission model: If this permission model is used, users require:

- Create and Edit Documents permission for the Documents service (Figure 47-1)

- Edit Page Access, Structure, and Content permission for Basic Services

- Advanced permission model: If this permission model is used, users require:

- Create and Edit Documents permission for the Documents service

- Create Pages or Create, Edit, and Delete Pages permission for the Pages service (Figure 47-2)

Figure 47-2 Page Service Permissions

47.2 Creating a Wiki Document

This section describes the different ways in which you can create wiki documents in the following subsections:

- Section 47.2.1, "Methods of Creating a Wiki Document"

- Section 47.2.2, "Creating a Wiki Document Using the New Wiki Document Action"

- Section 47.2.3, "Creating a Wiki Document Using the Wiki Page Style"

- Section 47.2.4, "Creating a Wiki Document Within a Wiki Page Style-Based Page"

47.2.1 Methods of Creating a Wiki Document

You can create a wiki document using either of the following two methods:

- Use the New Wiki Document action on the Documents page in your WebCenter Spaces application (Figure 47-3), or in any of the following Documents service task flows when they have been added to a page: Document Explorer, Document Manager, or Folder Viewer.

Figure 47-3 New Wiki Document Option

- Use the Wiki page style to create a dedicated wiki-related WebCenter Spaces page (Figure 47-4).

Figure 47-4 Create Dialog

This creates a Wiki page with a default wiki document that offers a simplified user interface and a dedicated wiki experience.Anyone with appropriate permissions (see Section 47.1.2, "Permissions Required for Working with Wiki Documents") can create additional wiki documents using the New Wiki Document action. These wiki documents are siblings of the default wiki document, and are all stored in the dedicated folder that is automatically created for the Wiki page.

Wiki documents created using either of the two methods offer the same in-place editing features.

The method you choose for creating wiki documents really depends on your preferences. If you want to expose a wiki document as a separate page in your WebCenter Spaces application, and want users to feel that there is a dedicated area for wikis, use the Wiki page style method. If you do not require these features, and just want to create a wiki document (among other types of documents) in your Space's document hierarchy, use the New Wiki Document action.

Table 47-1 summarizes the differences between the two methods of creating wiki documents:

Table 47-1 Distinguishing Features Between Methods of Creating Wikis

Feature

Wiki Page Style Method

New Wiki Document Method

Exposure

Exposes wiki documents within a dedicated page in the navigation area of a Space (the location depends on the page template used). The screenshot shows an example of navigation to a Wiki page in a Space using the default side navigation page template.

A wiki page is exposed as a folder on the Documents page of the Space, just like any other page.

In the default side navigation page template, does not display wiki documents as a separate page in the Space navigation area.

A wiki document is exposed as a file in the folder where it was created on the Documents page of the Space, just like any other file.

Document storage

Automatically creates a new folder (with the same name as the Wiki page) under the root folder in the document hierarchy, and creates a default wiki document in the folder, with the same name as the page name. This method restricts navigation to start at this folder.

The screenshot shows the folder named MyWikiPage. It contains a default wiki document named MyWikiPage. The folder and the wiki document were automatically created when the Wiki page style method was used for creating a page named MyWikiPage.

Does not create a separate folder to store a wiki document, and the navigation is not constrained.

The screenshot shows Savs Wiki as the wiki document created in the document hierarchy.

Permissions inherited by a wiki document

In a Space, the newly created wiki page inherits Space permissions (where Moderator and Participant roles have Create, Edit, and Delete permissions, and Viewer role has only View permission).

In the Home Space, a newly created wiki page inherits the same permissions as a public folder; the owner is granted the Administer, Read, Write, and Delete permissions, and public users are granted only the Read access.

Inherits permissions from the folder in which it is created.

Permissions required to create wiki documents

See also Section 47.1.2, "Permissions Required for Working with Wiki Documents"

To create a page based on the Wiki page style and then be able to create wiki documents within the page, users require:

- Create Pages or Create, Edit, Delete Pages permission for the Page service.

- Create and Edit Documents permission for the Documents service.

Create and Edit Documents permission.

Note:

The root folder where Oracle Content Server stores a Space is /spaces/space_name; a Home Space is stored in /spaces/user_name.

47.2.2 Creating a Wiki Document Using the New Wiki Document Action

To understand the differences between the two methods of creating wiki documents, see Section 47.2.1, "Methods of Creating a Wiki Document."

To create a wiki document using the New Wiki Document action on the Documents page or in a Documents service task flow:

1. Navigate to the Documents page or the page that contains the Document Explorer, Document Viewer, Document Manager, or Folder Viewer task flow. Browse to the folder where you want to create a wiki document.

2. Click New Wiki Document.

The Rich Text Editor (RTE) opens (Figure 47-5), displaying a blank wiki document.

Figure 47-5 Creating a New Wiki Document

3. In the Title field, enter a name for the wiki document.

Note:

For naming wiki documents, you must not use the following characters:

\ / : [ ] * ' " |

Spaces and periods (.) are allowed.

4. In the RTE, from the Mode list, choose the desired editing mode, described in Table 47-2.

5. Add the text, formatting, styling, and links using the methods available in the selected mode in the RTE. Table 47-2 describes the RTE toolbar icons and controls.

Note:

Instead of adding the content while creating a wiki document, you can choose to add the content later after the document has been created. For information, see Section 47.3, "Editing a Wiki Document."

6. Click Create to save your changes and exit the editor.

The wiki document is listed under the current folder, as shown in Figure 47-6.

Figure 47-6 Wiki Document Created Using the New Wiki Document Option

47.2.3 Creating a Wiki Document Using the Wiki Page Style

To understand the differences between the two methods of creating wiki documents, see Section 47.2.1, "Methods of Creating a Wiki Document."

To create a wiki document using the Wiki page style:

1. Navigate to the Space in which you want to create a wiki document.

2. From the Actions menu, choose Create, and then Page.

3. In the Page Name field, enter a display name for the dedicated Wiki page (for example, MyWiki).

The name that you enter here is also shown as the name of dedicated folder that is created, and the name of the first, default wiki document created within the folder.

Note:

For naming wiki documents, you must not use the following characters:

\ / : [ ] * ' " |

Spaces and periods (.) are allowed.

4. From the Page Style options, select Wiki (Figure 47-7).

Figure 47-7 Creating a Wiki Document Using the Wiki Page Style

Note:

The Wiki page style becomes available in the Create Page dialog in a Space only if WebCenter Spaces is integrated with Oracle Content Server 11g, and the Documents service is enabled for the Space.

For information about setting up a connection to Oracle Content Server, see "Registering Content Repositories" section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. For information about enabling the Documents service, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."

5. Click Create.

The newly created Wiki page displays, containing a default wiki document with default text (Figure 47-8). The breadcrumbs at the top display the path where the wiki document is created in the document hierarchy. In the wiki document, you can replace the default text with the desired content. For information, see Section 47.3, "Editing a Wiki Document."

Figure 47-8 A Newly Created Wiki Page Containing a Default Wiki Document

If you navigate to the Documents page, you can find the newly created wiki document (MyWiki) stored in a separate folder (MyWiki) under the root folder, as shown in Figure 47-9. Both the folder and the default wiki document share the same name.

Figure 47-9 A Newly Created Wiki Document in the Document Hierarchy

Note:

By default, for a Wiki page, the authenticated-role role is granted View permission. So, all authenticated users can view the page listed in the Activity Stream. However, additional permissions on the page are determined by the security set on the page through the Security Settings dialog, as described in Section 41.25, "Setting Security Options on a Folder or File."

47.2.4 Creating a Wiki Document Within a Wiki Page Style-Based Page

A page based on the Wiki page style contains a default wiki document. You can create additional wiki documents within that page.

To create an additional wiki document within a Wiki page:

1. Navigate to the Wiki page where you want to expose a new wiki document.

The way you access the Wiki page depends on the page template used in your Space.

2. Select the New Wiki Document action.

The way you select this action depends on the page template used in your Space.

Figure 47-10 shows a Wiki page open in a Space that uses a side navigation page template. Clicking the page name in the breadcrumbs or the dropdown arrow next to the page name displays a menu that contains the New Wiki Document action.

Figure 47-10 The New Wiki Document Option Available for a Wiki Page

3. In the Rich Text Editor (RTE), in the Title field, enter a name for the new wiki document (for example, Popular Quotes).

4. From the Mode list, choose the desired editing mode, described in Table 47-2.

5. Add the text, formatting, styling, and links using the methods available in the selected mode in the RTE. Table 47-2 describes the RTE toolbar icons and controls.

Note:

Instead of adding the content while creating a wiki document, you can choose to add the content later after the document has been created. For information, see Section 47.3, "Editing a Wiki Document."

6. Click Create to save your changes and exit the editor.

The new wiki document is listed under the dedicated folder of your Wiki page.

Figure 47-11 shows the document hierarchy of the folder named MyWikiPage. Note the newly created wiki document, Popular Quotes, is stored under the folder, along with the wiki document created as the default Wiki page document.

Figure 47-11 Wiki Document Created Using the New Wiki Document Option

When you open the dropdown menu for the MyWikiPage Wiki page, Popular Quotes is listed as one of the wiki documents exposed through the Wiki page (Figure 47-12).

Figure 47-12 List of Wiki Documents

47.3 Editing a Wiki Document

You use the Rich Text Editor (RTE) to add or revise the content of your wiki documents.

When you open a wiki document for editing, WebCenter Spaces automatically check the file out. If another user is already editing a wiki document when you try to open it, the Documents service displays a message that the wiki document has already been checked out. On the Documents page or in a Documents service task flow, a lock icon displays alongside a wiki document that is checked out. When you hover the mouse cursor over the lock icon, the name of the user who has checked out the wiki document displays.

Whenever you save changes to a wiki document, a new version of the wiki document is created. This means that the last saved version of a wiki document appears as the current version.

To edit a wiki document:

1. Open your wiki document in edit mode. Depending on your view, perform one of the following actions:

- On the Documents page or in a Documents service task flow, click in the row of the file you want to edit. From the File menu, choose Edit, or right-click the file to display the file's context menu and choose Edit to open the wiki document in the Rich Text Editor (RTE).

You can also click your wiki document in the document hierarchy to open the document in the Document Viewer. Then, click the Edit action to open the wiki document in the Rich Text Editor (RTE).

- To open the default wiki document created using the Wiki page style, click the required Wiki page in the navigation area in the Space, then click the Edit action to open the wiki document in the Rich Text Editor (RTE).

To open any other wiki document created within a Wiki page, click the Wiki page or the dropdown arrow next to it in the navigation area, select the required wiki document from the list (Figure 47-13), then click the Edit action.

Figure 47-13 Opening a Wiki Documented Created within a Dedicated Wiki Page

2. From the Mode list in the RTE, choose the desired editing mode (Figure 47-14). Table 47-2 describes all editing modes.

Figure 47-14 Selecting the Editing Mode in the RTE

3. Add or revise text, formatting, styling, and links using the icons and controls available in the selected mode in the RTE.

Table 47-2 describes the icons available in the RTE.

Table 47-2 Rich Text Editor Toolbar Icons and Controls

Control

Description

Print or Preview. Click to print the file or preview it in your default browser.

Spell Check As You Type. Click to enable the SCAYT spelling checker, and set options, languages, and dictionaries for checking spelling in the document.

Undo or Redo. Click to back out or restore the previous change. Change history is cleared when you click Create or Save.

Cut, Copy, or Paste. Select text, then click the desired icon to cut or copy selected text, or paste text in the buffer at the current cursor location.

Paste as plain text. Click to open a text box where you can press Ctrl+V to paste any text currently in the buffer, then click OK to insert the text, unformatted, into the RTE at the current cursor location.

Paste from Word. Click to open a text box where you can press Ctrl+V to paste text from Microsoft Word, then click OK to insert the text, with formatting maintained, into the RTE at the current cursor location.

Select mode. Select an editing mode:

- WYSIWYG: Create and revise content in a WYSIWYG environment using the icons in the toolbar for font styling, adding links and lists, and special text effects.

- HTML Source: Enter your own HTML markup manually. This includes entering source code for HTML not handled by the WYSIWYG icons. In this mode, most icons and controls in the RTE toolbar are not available.

The RTE ignores the following types of tags when entered in HTML Source mode because they are irrelevant or redundant within the RTE context: script tags, form elements, such as input, select, textarea, and form, frame/frameset, document tags, such as html, head, body, meta, and title, and unknown tags; for example, <foo></foo>.

- Wiki Markup: Enter your own content, formatted using wiki markup. For examples of wiki markup, click the Wiki Markup Help icon.

Wiki Markup Help. Active only in Wiki Markup mode, click to view examples of wiki markup.

Maximize/Minimize. Click to expand the RTE to fill the entire screen, or reduce the RTE to display inside the WebCenter Spaces application.

Find. Click to open the Find and Replace dialog, where you can search for a string, or replace a given string with specified text.

Image. Click to open the Image Properties dialog:

- To add an image in-place at the current cursor location: On the Image Info tab, enter the URL where the image is located, alt text, sizing, and choose alignment for the image.

- To add a link to an image at the current cursor location: On the Link tab, enter the URL where the image is saved, and choose from the Target list how the image displays when the link is clicked in the document.

- On the Advanced tab, specify additional image attributes.

- Click OK to add the image or image link to the document.

Note: To insert an image saved in the content repository, use the Embed Image icon.

Table. Click to open the Table Properties dialog, where you can specify the number of rows and columns, sizing, spacing, alignment, caption, and summary for a table. Click OK to insert the table into the document.

Insert Horizontal Line Click to insert a horizontal line at the current cursor location.

Link. Select text to convert into a link, then click this icon to open the Link dialog:

- On the Link Info tab, choose a Link Type:

URL. Enter a URL to be linked from the selected text.

Link to anchor in the text. Choose an anchor name or ID from the dropdown lists to be linked from the selected text. Note: create target anchors in HTML Source mode; for example: <a name="setup" id="setup"></a>

E-mail. Enter a mail address, subject, and body to be linked from the selected text. Clicking the link in the document opens the mail message in the default mail application.

- On the Advanced tab, specify additional link attributes.

- Click OK to add the link to the document.

Unlink. Select the linked text, then click this icon to remove the link from the text.

Select Resource. Select text to link to an existing WebCenter resource, then click this icon to open the Select Resource dialog. Select a resource (for example, a document or an announcement) in the current Space to be linked from the selected text. Clicking the linked text in the document opens the selected resource in the Document Viewer preview pane.

New Resource. Select text to link to a new WebCenter resource, then click this icon to open the New Resource dialog. Select a resource to be linked from the selected text, then create the resource (for example, a note or announcement), specify the external location of the resource (for example, a URL), specify the name of the resource (for example, a wiki document), or upload the resource from your local file system or a connected network drive (for example, a document). For information about creating links to resources in WebCenter Spaces, see Chapter 63, "Working with the Links Service."

Note: If you create a new wiki document in this manner, WebCenter Spaces creates a placeholder for the new wiki document in the current folder. To add content to the new wiki document, you must navigate to it and open it in the RTE.

Embed Image. Click to open the Embed Image dialog:

- Click Select Image to select an image in the current Space.

- Click Upload Image to upload an image from your local file system or a connected network drive.

Note: To insert an image available at a URL location, use the Image icon.

Paragraph Format. Select a format, then enter text; or highlight text, then select a format.

Font Name. Select a font, then enter text; or highlight text, then select a font.

Font Size. Select a size, then enter text; or highlight text, then select a size.

Bold, Italic, Underline, and Strike Through. Select text, and click the desired font style icon; or click an icon, and enter text. Click the icon again to exit the font style.

Left Justify, Right Justify, Center Justify, and Block Justify. Select text, and click to apply the desired text alignment; or click an icon, and enter text.

Numbered List and Bulleted List. Start a new line, click the desired list type icon, and enter text. Or, select lines of text and click an icon. Click the icon again to remove the list formatting. Alternately, end list mode by pressing Enter twice after the last item.

Decrease Indent and Increase Indent. Select text, and click the desired indent icon to move text left or right.

Snippet. In a blog post, select a portion of text, then click this icon to display that portion as a summary of the blog post on the blog summary page (or digest page), with a Read More link to allow users to view the full blog. In a wiki document, this functionality is not available.

Text Color or Background Color. Select text, and click to the desired text or background color icon, then select a color. Or, click an icon and select a color, then enter text..

Remove Format. Select text, and click this icon to remove all font styling, such as font types, sizes, weights, and colors. Lists and indents are not affected.

Ctrl-x

Use this key combination to cut highlighted selections to the clipboard.

Ctrl-c

Use this key combination to copy highlighted selections to the clipboard.

Ctrl-v

Use this key combination to paste the content on the clipboard at the current cursor location.

4. Click the Major Edit? checkbox to update the Activity Stream and send a notification of your updates to other Space members who have access to the wiki document and have subscribed. The notification is sent after you save your changes.

5. Click Save to save your changes and continue editing, or click Save and Close to save your changes and exit the editor.

47.4 Exposing an Existing Wiki Document

This section includes the following subsections:

- Section 47.4.1, "Exposing an Existing Wiki Document Using the Wiki Page Style"

- Section 47.4.2, "Exposing an Existing Wiki Document Using Content Presenter"

47.4.1 Exposing an Existing Wiki Document Using the Wiki Page Style

When you create a wiki page using the Wiki page style, it is listed in the document hierarchy, and is exposed as a separate page in the navigation are in your Space. However, when you create a wiki document using the New Wiki Document action in a task flow, the wiki document is listed in only in the document hierarchy. For easy access to such a wiki document, you can publish it to appear as a separate page in the navigation area by using the Wiki page style.

To publish an existing wiki document as a separate page in the navigation area by using the Wiki page style:

1. At the root level of the Space, create a folder with the same name as the existing wiki document. For example, if the existing wiki is named Sales, create a folder named Sales (Figure 47-15).

Figure 47-15 Folder Created at the Space Root Level

2. Move the existing wiki document to the newly created folder (see Section 41.14, "Copying and Pasting Folders and Files").

Note:

Note that the wiki document must have been created using the New Wiki Document action.

3. From the Actions menu, select Create, and then Page.

4. In the Page Name field, enter the display name of the existing wiki document that you want to expose, for example Sales.

Note:

Document names are case-sensitive.

5. From the Page Style options, select Wiki.

6. Click Create.

The wiki document is listed in the document hierarchy. It is also listed in the navigation area; the actual location depends on the page template used in your Space. Figure 47-16 shows the Sales wiki document listed in the document hierarchy and in the navigation area in a Space using a top navigation template.

Figure 47-16 A Wiki Document Exposed Under the Wiki Category

47.4.2 Exposing an Existing Wiki Document Using Content Presenter

The Content Presenter task flow allows you to select a wiki document, and render its content in a specific template on a page. For information, see Section 40, "Publishing Content Using Content Presenter."

47.5 Comparing Versions of a Wiki Document

Whenever you save changes to a wiki document, WebCenter Spaces automatically checks the file in and creates a new version of the wiki document. WebCenter Spaces tracks every version of the document, including its authors and creation dates.

Using the History pane, you can view, delete, or compare different versions (Figure 47-17). For information about viewing and deleting a document version, see Section 41.21, "Viewing and Deleting File Version History."

Figure 47-17 Versions of a Wiki Document

The History pane lists all the versions of a wiki document. You can compare an older version of a document with its latest version. Changes are highlighted in different colors, showing the new and the old content (Figure 47-18).

Figure 47-18 Comparing Versions of a Wiki Document

Note:

WebCenter Spaces does not support uploading a new version of a wiki document from the file system, nor restoring an older version of a wiki document.

To compare versions of a wiki document:

1. Open the History pane in any of the following ways:

- On the Documents page or in a Documents service task flow, select the wiki document from the document hierarchy. Then, from the View menu, choose Version History.

A preview of the file opens, showing the History pane on the right.

- If your wiki document is already open, click the History icon (Figure 47-19) to view the version history of the document.

Figure 47-19 History Icon

2. In the History pane, select the older version that you want to compare with the latest version.

3. Click Compare.

The Compare Versions dialog shows a comparison of the selected version and the latest version of the wiki document, as shown in Figure 47-18.

47.6 Managing Wiki Documents

The Documents service provides various features to help you manage your wiki documents, described in Table 47-3.

Note:

If your wiki document is based on the Wiki page style, you can perform some of the tasks listed in Table 47-3 by accessing the required options from the File or the View menu available in the wiki document.

Table 47-3 Tasks Involved in Managing Wiki Documents

Task

Description

For more information, see...

Opening a wiki document

You can open a wiki document on the Documents page or in a Documents service task flow.

If your wiki document is exposed through a Wiki page, you can open the Wiki page through the navigation area, then access the wiki document from the Wiki page's dropdown menu, as shown in Figure 47-12.

Section 41.10, "Opening a File"

Downloading a wiki document

You can download a wiki document from the content repository to your local file system using the Download action on the Documents page or in a Documents service task flow.

Note: WebCenter Spaces does not support uploading a new wiki document or a new version of a wiki document from the file system. If you upload an HTML file, you cannot convert it to a wiki document due to differences in underlying metadata.

Section 41.12.2, "Downloading a File"

Sharing the URL of a wiki document

You can directly access a wiki document using its URL. You can share the link by publishing it to the Activity Stream or sending the link in a mail message.

Section 41.24, "Sharing the URL for a Folder or File"

Setting up the security for a wiki document

You can secure a wiki document by setting custom access permissions or choosing to inherit the permissions of the parent folder.

The option to set security for wiki documents is available if item level security has been enabled on Oracle Content Server.

Section 41.25, "Setting Security Options on a Folder or File"

Subscribing to a wiki document

You can subscribe to a wiki document to receive notifications for activities such as when it gets updated or when a user posts comments or likes it. You are notified through your selected messaging channel.

Section 41.26, "Subscribing to a File"

Liking or unliking a wiki document

To indicate that a wiki document is of particular interest to you, you can "like" it. If a wiki document is already liked, you can "unlike" it if you no longer wish to highlight your preference.

To like or unlike a wiki document, use the Like icon. The icon is available when you open a wiki document. The icon is also displayed for a file on the Documents page and Documents service task flows.

Section 41.27, "Liking and Unliking a File"

Deleting a wiki document

You can delete a wiki document from the Documents page or from a Documents service task flow.

Section 41.16, "Deleting Folders and Files"

Renaming a wiki document

You can rename a wiki document as desired.

Section 41.13, "Renaming a Folder or File"

Viewing and adding tags and links to a wiki document

You can associate keywords with a wiki document, and add links to other documents.

Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)"

Viewing and modifying properties of a wiki document

You can view the basic and advanced properties associated with a wiki document. However, you can modify only the name and description of a wiki document.

Section 41.22, "Viewing and Modifying Folder and File Properties"

Viewing, adding, and deleting comments

You can associate comments with a wiki document to provide additional information that you may want to convey to other users about it.

Section 41.20, "Viewing, Entering, and Deleting Comments on a File"

Viewing and deleting versions of a wiki document

Every time you save a wiki document, a version is saved. You can view and delete the various versions. However, you cannot restore an older version of a wiki document.

Section 41.21, "Viewing and Deleting File Version History"

Opening or saving wiki documents as PDF files

You can open or save the PDF version of the currently open wiki document. This choice is available if Oracle Content Server is configured to convert wiki documents to the PDF format.

Section 41.23, "Opening or Saving PDF Files"

48 Working with Blogs

This chapter describes how to create and manage blogs in WebCenter Spaces.

It includes the following sections:

- Section 48.1, "What You Should Know About Blogs"

- Section 48.2, "Creating and Managing Blogs"

- Section 48.3, "Working with Blog Posts"

Note:

The tasks described in this chapter are available only if Oracle Content Server 11g is configured as the content repository.

Audience

This chapter is intended for WebCenter Spaces users interested in adding, editing, and managing blogs. Much of this information applies to any WebCenter Portal application, though it is written with WebCenter Spaces users in mind.

48.1 What You Should Know About Blogs

Blogs are typically personal records of an individual user's experience and opinions. The word blog is a contraction of the term Web log. It was coined to describe the online diaries spawned in the late 1990s.

In WebCenter Spaces, you can create blogs to group related blogs posts, for example group by the same author or related topics.

This section describes the blog functionality and the requirements for enabling it in WebCenter Spaces. It includes the following subsections:

- Section 48.1.1, "Understanding the Blogs Interface"

- Section 48.1.2, "Directory Structure of Blogs"

- Section 48.1.3, "Requirements for Enabling the Blogs Functionality"

- Section 48.1.4, "Permissions Required for Working with Blogs"

48.1.1 Understanding the Blogs Interface

In WebCenter Spaces, each blog contains various blog posts, with the most recently added blog post displayed at the top.

In a Blog page style mode, the Archives pane on the right provides controls for navigating to blog posts (Figure 48-1). Blog posts are automatically categorized by year and subcategorized by month. Next to a year, the number in parenthesis represents the total number of blog posts created during the year. Likewise, the number next to a month represents the total number of blog posts created during a month. For example, December (2) represents that there are two blog posts for the month of December. Clicking any particular month displays all blog posts created during that month. You can view all blog posts available in a blog, irrespective of their month or year of creation by clicking the View all link. If there are more blog posts than can be displayed on one page (typically 10 posts), the Next and Previous buttons get enabled, and you can use these buttons to navigate through the list of blog posts.

Figure 48-1 A Blog Page

The blog page displays various details for each blog post. These include the blog post title, the blog post content, date of creation or modification, name of the user who created or last modified the post, and the number of comments on the blog post. You can use the Edit Post link to edit a post. Use the Post comments icon to post comments on a blog post. The number next to the Post comments icon indicates the number of comments posted on a blog post.

Titles of blog posts are hyperlinked. Clicking a title opens the blog post, which occupies the entire the blog page (Figure 48-2). You can use the controls on the blog post page to perform tasks such as edit, subscribe, share, and comment on the post. For more information, see Section 48.3.1, "What You Should Know About Blog Posts."

Figure 48-2 A Blog Post

48.1.2 Directory Structure of Blogs

For each Space or Home Space, blogs are stored in a separate folder named Blogs under the root folder of the Space in the document hierarchy. On Oracle Content Server, the root folder of a Space is /spaces/space_name, and that of a Home Space is /spaces/user_name. When you create a blog, an empty folder gets created for that blog under the Blogs folder. All blog posts that you create in that blog are stored under the corresponding blog folder.

For example, suppose you create a blog named Standards. You then added two blog posts in the blog, named Naming_Products and Writing_Procedures. Figure 48-3 displays the directory structure for this blog on the Documents page. (The Documents pages uses the Document Explorer task flow to display folders and files.) The breadcrumb at the top shows that the blog posts are created in the Blogs > Standards folder in your Space.

Figure 48-3 Directory Structure of a Blog

48.1.3 Requirements for Enabling the Blogs Functionality

In WebCenter Spaces, the Documents service provides the blogs functionality. For the blog functionality to become available in a Space, the following requirements must be met:

- Oracle Content Server 11g must be configured as the default content repository for WebCenter Spaces. WebCenter Spaces stores all blogs on Oracle Content Server 11g. The blog functionality is not available with Oracle Content Server 10g.

For information about setting up a connection to Oracle Content Server, see "Registering Content Repositories" section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

- The Documents service must be enabled for the Space in which you plan to create a blog. For information, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."

In WebCenter Spaces, you can create and manage blogs in your Home Space and in any other Spaces on which you have the required permissions.

48.1.4 Permissions Required for Working with Blogs

By default, Space members can view blogs and blog posts created by other members of a Space.

In a Space, access to a blog is controlled through the permissions granted to a role for the Documents service in the Space. For example, suppose you grant the Viewer role for a Space to a user named Monty. This assigns the View Documents permission to Monty, who can now only browse the files and folders and view blog posts in the specified Space. If you want to allow Monty to be able to create and edit blog posts, you must ensure that Monty is granted a role that has the required permissions enabled for the Documents service. For general information about roles and permissions, see Chapter 52, "Managing Space Members and Roles."

A Space moderator can control blog access by using the Set Page Access option. Page access allows users to rearrange a page, add additional widgets, and so on. It does not influence a user's access to the blog document itself, which is controlled through the Document service permissions.

Note:

In a Home Space, only the owner has access to pages. However, the authenticated-role is automatically added for any Blog page style page that the owner creates in the Home Space (Figure 48-4). Therefore, all authenticated users can view the blogs in a user's Home Space.

For information about controlling page access, see Section 51.7.8, "Changing Access Permissions on a Space Page."

Figure 48-4 Setting Page Access for Blogs in Home Space

Permissions for Creating and Managing Blogs

Users can create blogs by using the Blog page style or by adding the Blogs task flow. To create and manage blogs using a Blogs task flow, users require the Create and Edit Documents permission on the Documents service.

To create and manage blogs by using the Blog page style, users require permissions on both the Documents service and the Page service.

- Standard Permission Model: If this permission model is used, users require:

- Create and Edit Documents permission for the Documents service (Figure 48-5).

Figure 48-5 Documents Service Permissions for Working with Blogs

- Edit Page Access, Structure, and Content permission for Basic Services (Figure 48-6).

Figure 48-6 Basic Services Permission for Working with Blogs

- Advanced Permission Model: If this permission model is used, users require:

- Create and Edit Documents permission for the Documents service

- Create Pages or Create, Edit, and Delete Pages permission for the Page service (Figure 48-7).

Figure 48-7 Page Service Permissions for Working with Blogs

Creating and Managing Blog Posts

By default, all users can create blog posts in their Home Space. To create blog posts in other Spaces, users must have the Create and Edit Documents permission for the Documents service (Figure 48-8).

All users with the permission to view documents can post comments on blog posts.

Figure 48-8 Documents Service Permissions

48.2 Creating and Managing Blogs

This section contains the following subsections:

- Section 48.2.1, "Creating a Blog"

- Section 48.2.2, "Setting Blog Properties"

- Section 48.2.3, "Subscribing to a Blog"

48.2.1 Creating a Blog

In WebCenter Spaces, you can create blogs by using either of the two methods:

- Creating a dedicated blog page by using the Blog page style

- Creating a folder under the Blogs folder, and exposing it on a page using the Blogs task flow

This section contains the following subsections:

- Section 48.2.1.1, "Creating a Blog Using the Blog Page Style"

- Section 48.2.1.2, "Adding a Blogs Task Flow"

48.2.1.1 Creating a Blog Using the Blog Page Style

WebCenter Spaces provides certain default page styles to enable rapid creation of application pages. These page styles describe the positioning of content layout areas and the content flow. Out-of-the-box, WebCenter Spaces provides the Blog page style for creating a dedicated blog page.

To create a blog by using the Blog page style:

1. Navigate to the Space in which you want to create a blog.

2. From the Actions menu, select Create, then Page.

3. In the Create dialog, in the Page Name field, enter a display name for your blog page.

Note:

For blog pages, you must not use the following characters:

\ / : [ ] * ' " |

You can use character spaces and periods (.).

4. From the Style options, select Blog to create a blog page (Figure 48-9).

Note:

The Blog page style becomes available in the Create dialog in a Space only if WebCenter Spaces is integrated with Oracle Content Server, and the Documents service is enabled for the Space.

For information about setting up a connection to Oracle Content Server, see "Registering Content Repositories" section in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. For information about enabling the Documents service, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."

Figure 48-9 The Blog Page Style

5. Click Create.

Figure 48-10 shows a newly created blog listed as a separate page on the top navigation bar of a Space. The location of the page in the UI depends on the page template used in your Space.

Figure 48-10 A Blog Created Using the Blog Page Style

You can choose to add blog posts to your newly created blog. For information, see Section 48.3.2, "Creating a Blog Post."

48.2.1.2 Adding a Blogs Task Flow

The Documents service provides various task flows that offer a different view and set of capabilities for working with documents in your content repository.

In WebCenter Spaces, you can add various service task flows, such as Discussions and Mail, on a single page. Instead of creating a dedicated blog page, you may want your blog to appear along with various other services on a page. You can do this by creating a folder for the blog, and then exposing it on a page using the Blogs task flow.

To add a Blogs task flow:

1. On the Documents page or in a documents task flow, create a folder under the Blogs folder.

2. Right-click the newly created folder, and click Properties.

3. From the Identifier field, copy the value (Figure 48-11).

This value is the resource ID that uniquely identifies the folder. You need to provide this resource ID in the Blogs task flow to expose the folder as a blog.

Figure 48-11 Resource ID of a Folder

4. Create a page or navigate to an existing page where you want to add the blog.

5. From the Actions menu, select Edit Page to open the page in Oracle Composer.

6. Click Add Content in the target region to open the Resource Catalog.

7. Click Social and Communication or click the Open button next to it.

8. Click Add next to the Blogs task flow to add it to your page (Figure 48-12).

Figure 48-12 Adding the Blogs Task Flow

9. Click Close.

The Blogs task flow is added, and a message displays that there is no blog post in the blog (Figure 48-13).

Figure 48-13 Blogs Task Flow Added to a Page

10. Click the Edit icon, highlighted in Figure 48-13.

11. In the Component Properties dialog, in the Resource Id field, paste the resource ID that you copied in step 3. Figure 48-14 shows a sample value.

Figure 48-14 Component Properties Dialog of a Blogs Task Flow

For information about the other blog properties that you can set in the Component Properties dialog, see Section 48.2.2.2, "Blogs Task Flow Parameters."

12. Click OK.

The Blogs task flow exposes the folder as a blog.

Figure 48-15 A Folder Exposed in a Blogs Task Flow

After adding a blogs task flow, you can add blog posts, as described in Section 48.3.2, "Creating a Blog Post."

48.2.2 Setting Blog Properties

The Blogs task flow and the Blog page style have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer.

This section contains the following subsections:

- Section 48.2.2.1, "What You Should Know About Blog Properties"

- Section 48.2.2.2, "Blogs Task Flow Parameters"

- Section 48.2.2.3, "Blog Page Style Parameters"

48.2.2.1 What You Should Know About Blog Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of parameters of the Blogs task flow, see Section 48.2.2.2, "Blogs Task Flow Parameters." For description of parameters of the Blog page style, see Section 48.2.2.3, "Blog Page Style Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. However, the Content Style tab is not available for the Blog page style. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. This tab is available for a Blog page style, but not for a Blogs task flow. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

48.2.2.2 Blogs Task Flow Parameters

The Parameters tab displays the parameters that are unique to the Blogs task flow (Figure 48-16).

Figure 48-16 Blogs Task Flow Properties

Table 48-1 describes the Blogs task flow parameters.

Table 48-1 Blogs Task Flow Parameters

Parameter

Type

Description

Default Value

Hide Comments

Boolean

Specify whether to display blog post comments or not:

- true: comments are shown for blog posts

- false: comments are hidden for blog posts

false

Number of Rows Displayed

Long

Specify the number of rows to be displayed on the blog page.

10

Resource Id

String

The unique identifier of the selected task flow. It can be a blog folder name or a file name. If you specify a blog folder as a resource ID, all the blog post files in that folder are listed. If you specify a blog post file name, the blog post is displayed.

None

48.2.2.3 Blog Page Style Parameters

The Blog page style, which is a built-in page style, uses an internal task flow. The Parameters tab displays the parameters that are unique to the internal task flow (Figure 48-17).

Figure 48-17 Blog Page Style Parameters

Table 48-2 describes the parameters of the internal task flow of the Blog page style.

Table 48-2 Blog Page Style Parameters

Parameter

Description

Default Value

Hide Comments

Boolean

Specify whether to display blog post comments:

- true: comments are shown for blog posts

- false: comments are hidden for blog posts

false

PageName

String

Do not edit this value.

Shows the name of the blog exposed in the Blog page style. If you change the blog name, it does not rename your existing blog, but creates another blog and wires it to the built-in task flow. For every new name specified in PageName, a new folder with that name is created in the document hierarchy.

For example, if you rename a blog named 'Standards' to 'StandardsChanges', a new blog named 'StandardsChanges' gets created. This blog does not contain the blog posts that were a part of the blog 'Standards'.

To learn how to rename a blog, see Section 41.13, "Renaming a Folder or File"; to learn how to rename a page, see Section 29.6, "Renaming a Page."

Page name that you specified while creating the page

Number of Rows Displayed

Long

Specify the number of rows to be displayed on the blog page.

${param.resourceId}

Resource Id

String

Do not edit this value.

The unique identifier of the blog page, used internally to maintain association of the page style instance with its customization and personalization settings.

${param.resourceId}

48.2.3 Subscribing to a Blog

Users can subscribe to be notified whenever a blog entry is posted or commented upon in a Space. Owning a blog does not automatically subscribe a blog owner to it. A blog owner must also explicitly subscribe to receive blog notifications. For information about how to subscribe to a blog, see Section 36.3.2, "Setting Space-Level Subscriptions." Whenever there is a change, you are notified through your selected messaging channel. For information about messaging channels, see Section 36.2, "Establishing and Managing Your Messaging Channels and Filters."

There is no subscription available for blogs in a Home Space. However, you can subscribe to be notified for individual blog posts in your Home Space. For information about subscribing to a specific blog post, see Section 48.3.5, "Tasks Involved in Managing Blog Posts."

48.3 Working with Blog Posts

This section describes how to add and manage blog posts. It includes the following subsections:

- Section 48.3.1, "What You Should Know About Blog Posts"

- Section 48.3.2, "Creating a Blog Post"

- Section 48.3.3, "Editing a Blog Post"

- Section 48.3.4, "Opening a Blog Post"

- Section 48.3.5, "Managing Blog Posts"

48.3.1 What You Should Know About Blog Posts

For each blog post, you can use the controls on the blog post page to perform tasks such as edit, subscribe, share, and comment upon the post (Figure 48-18). For information, see Section 48.3.5, "Managing Blog Posts."

Figure 48-18 A Blog Post

You must keep your blog post titles unique. When you create a blog post (say Naming_Products) a file is created in the content repository with the same name as the blog post title (Naming_Products). Therefore, you cannot create two blogs posts with the same title under a blog. You can edit the content of a blog post, but not its title.

You use the Rich Text Editor (RTE) to add the content and style elements to a blog post. The RTE provides features such as the ability to embed images, create new resources on the fly, and add links. For more information, see Section 41.11, "Using the Rich Text Editor (RTE)."

By default, the entire content of a blog post gets displayed on the blog page. You can choose to display only a snippet. You can do this by using the Snippet icon in the RTE.

When you create a blog post, the blog post file is marked as a blog entry in the metadata Type field. Uploading an HTML file (which is what a blog entry is saved as when downloaded) in a blog folder does not update the Type field. Therefore, uploading HTML files in a blog folder does not expose them as blog posts.

48.3.2 Creating a Blog Post

To create a blog post:

1. Navigate to the blog in which you want to create a blog post.

2. Click New Post.

3. In the resulting page, in the Title field, enter a display name for the blog post (Figure 48-19).

A blog post title can be of maximum 250 characters.

Figure 48-19 Creating a Blog Post

4. In the RTE, from the Mode list, choose the desired editing mode. Add the text, formatting, styling, and links using the methods available in the selected mode in the RTE. For information about RTE toolbar icons and controls, see Table 47-2, "Rich Text Editor Toolbar Icons and Controls".

5. Choose a mode for publishing the blog post:

- Draft: Select to mark the blog post as a draft. On a blog page, a draft blog post is marked as "Draft". Only the author of a blog post and Space moderators can view draft posts. Users with just the viewing permissions can view only published posts.

- Publish: Select to publish the blog post. On a blog page, a published post is marked as "Posted".

By default, a post is published with the current date and time details. If you want the blog post to be published on a future date and time, use the date picker. The blog post will be published automatically on the specified date.

Note:

The Activity Stream shows a blog post that has a publish date, regardless of the publish date. Only draft posts are not listed in the Activity Stream.

6. Click Create to save your changes and exit the editor.

The newly created blog post appears as the top-most entry on the blog page.

On the Document page, the newly created blog post (MyPost) is saved as a document under its parent blog folder (Office), which in turn, is stored under the Blogs folder, as shown in Figure 48-20.

Figure 48-20 Blog Posts in the Document Hierarchy

48.3.3 Editing a Blog Post

You use the RTE to add or revise the content of your blog posts.

In WebCenter Spaces, you do not need to manually check out or check in a blog post; the Documents service automatically handles this in the background. However, when you attempt to open a blog post that is already being edited by another user, WebCenter Spaces displays a message that another user has checked out the post. You can either wait until the other user finishes editing, or you can override the checkout operation by using the Cancel Check Out link and continue editing the blog post. Whenever a user saves changes, a new version of the post is created. So, effectively the last saved post appears as the current version.

To edit a blog post:

1. Open your blog post in edit mode in any of the following ways, depending on your view:

- On the Documents page, or in a Documents service task flow, click in the row of the blog post file you want to edit, then click the Edit menu and choose Edit.

- In Document Viewer in which your blog post is exposed, click the Edit button.

- In the Blog page style mode or the Blogs task flow, click the Edit Post link for the required blog post.

- In the Blog page style mode or the Blogs task flow, open the blog post by clicking its title, and select the Edit button on the resulting page.

2. In the RTE, from the Mode list, choose the desired editing mode. Add the text, formatting, styling, and links using the methods available in the selected mode in the RTE. For information about RTE toolbar icons and controls, see Section 47.3, "Rich Text Editor Toolbar Icons and Controls."

3. Select the Major Edit checkbox if you want to notify Space members about your changes.

Selecting this checkbox updates the Activity Stream and sends notifications after you save your changes.

4. Click Save to save your changes and continue editing, or click Save and Close to save your changes and exit the editor.

48.3.4 Opening a Blog Post

You can view a blog post by opening it in the Document Viewer preview pane, or by accessing the page in which the blog post resides—the page containing the Blogs task flow or the page created using the Blogs page style.

To view a blog post from the Blog page style mode or from a page that contains the Blogs task flow:

1. Open the required page by using the navigation bar. The way you open the page depends on the page template in use in your Space.

2. Click the title of the blog post.

Figure 48-21 shows a blog post in a Space that uses a top navigation page template.

Figure 48-21 Opening a Blog Post from the Blog Page Style Mode

To view a blog post in a Document Viewer preview pane:

1. On the Documents page or in a Documents service task flow, navigate to the Blogs folder.

2. Open the blog folder that contains the blog post.

3. Click the blog post file to open it in-place.

Figure 48-22 shows a blog post in the document hierarchy.

Figure 48-22 Opening a Blog Post in the Document Viewer Preview Pane

If you want to view the blog post in a separate tab in full screen mode showing only the contents of the post, choose Open in Browser from the View menu.

For more information about opening a file, see Section 41.10, "Opening a File."

48.3.5 Managing Blog Posts

The Documents service provides various features to help you manage your blog posts. Table 48-2 lists the tasks that you can perform to manage blog posts. It also lists the documentation links you can visit to know more about each task.

Note:

Some of the tasks listed in Table 48-2 can be performed by using the File menu or the View menu available in a currently open blog post, whereas some tasks can be performed by using the File menu and the View menu available on the Documents page or a Documents service task flow.

Table 48-3 Tasks Involved in Managing Blog Posts

Task

Description

Documentation

Downloading a blog post

You can download blog posts from the content repository to your local system. You can access the Download action from the Documents page, Documents service task flows, or the Document Viewer preview pane.

The Download option is not available when you open a blog post directly from the page that contains it.

Note: You can upload HTML files into your blog folder. However, the Documents service does not recognize those files as blog posts.

Section 41.12.2, "Downloading a File"

Sharing the URL of a blog post

Users can directly access a blog post by using its URL. You can share the link by publishing it to the Activity Stream or sending it through e-mail.

The Share option is available on the File menu of a currently open blog post.

Section 41.24, "Sharing the URL for a Folder or File"

Subscribing to a blog post

You can subscribe to a blog post to monitor activities like when a user posts comments, updates, or deletes a blog entry. You are notified through your selected messaging channel.

The Subscribe option is available on the File menu of a currently open blog post.

Section 41.26, "Subscribing to a File" and Section 36.3.3.3, "Subscribing to a Blog Entry"

Liking or unliking a blog post

To indicate that a blog post is of particular interest to you, you can "like" it. If a post is already liked, you can "unlike" it if you no longer wish to highlight it in any way.

To like or unlike a post, use the Like icon. The icon is available when you open a blog post. The icon is also displayed next to a blog post file on the Documents page and in Documents service task flows.

The number alongside the Like icon indicates the number of users who like the post.

Section 41.27, "Liking and Unliking a File"

Deleting a blog post

You can delete a blog post if it is no longer required.

The Delete option is available on the File menu on the Documents page and in a Documents service task flow.

Section 41.16, "Deleting Folders and Files"

Renaming a blog post

You can rename a blog post as desired. You can rename a post by using the Rename option available on the File menu on the Documents page or in a Documents service task flow.

You can also rename a blog post by using its Properties pane.

Section 41.13, "Renaming a Folder or File"

Section 41.22, "Viewing and Modifying Folder and File Properties"

Viewing and adding tags to a blog post

You can add tags to a blog post to specify keywords related to the content of the post to make it easily discoverable in search results.

Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)"

Viewing and adding links to a blog post

You can add links to another document, note, or URL to provide a way to view, access, or associate related information.

Section 41.19, "Working with Related Items (Tags, Links, and Recommendations)"

Viewing and modifying properties of a blog post

Each blog post has certain associated properties, such as the read-only information about location, type, and creation and modification dates. You can use blog post properties to rename a blog post file, provide or revise a description, or obtain a reusable link to the blog post.

Blog post properties are listed in the Properties pane, which you can access by clicking the Properties icon. This icon is not available when you open a blog post directly from the page that contains the post.

Section 41.22, "Viewing and Modifying Folder and File Properties"

Viewing, adding, and deleting comments

You can post comments on a blog post to express your views.

Use the Comments pane to add and manage comments. You can access the Comments pane by choosing Comments from the View menu on the Documents page, Documents service task flows, Document Viewer preview pane, or the blog post page in the Blog page style mode. You can also access the pane by using the Comments icon on a currently open blog post.

Note: A user with view-only permissions can add comments to a blog post.

Section 41.20, "Viewing, Entering, and Deleting Comments on a File"

Viewing and deleting versions of a blog post

Every time you save a blog post, WebCenter Spaces saves a new version of the post and maintains the version history, available through the History pane.

You can access the History pane from the Documents page, Documents service task flows, or the Document Viewer preview pane. The History pane is not accessible when you open a blog post directly from the page containing the post.

Section 41.21, "Viewing and Deleting File Version History"

Setting security options for a blog post

You can specify whether you want to use custom access permissions or inherit the permissions of the parent folder for a blog post.

The option to set security for a blog post is available if item level security has been enabled on Oracle Content Server.

The Security option is available when you open a blog post using the Documents page or a Documents service task flow. It is not available when you open the post directly from the page that contains the post.

Section 41.25, "Setting Security Options on a Folder or File"

Opening or saving blog posts as PDF files

You can open or save the PDF version of the currently open blog post. This choice is available if Oracle Content Server is configured to convert blog posts to the PDF format.

Section 41.23, "Opening or Saving PDF Files"

Part XI

Planning and Building a Space

Part XI of the User's Guide describes how to build and manage Spaces other than Home Spaces (for information about Home Spaces, see Chapter 29, "Exploring the Home Space"). It includes general information about Spaces as well as the specifics of managing Space members and roles, administering Space resources, and using hierarchical Spaces.

Part XI includes the following chapters:

- Chapter 49, "Understanding Space Basics"

- Chapter 50, "Working with Space Templates"

- Chapter 51, "Managing a Space"

- Chapter 52, "Managing Space Members and Roles"

- Chapter 53, "Administering Spaces and Templates"

- Chapter 54, "Working with a Space Hierarchy"

49 Understanding Space Basics

WebCenter Spaces supports the formation and collaboration of project teams and communities of interest through Spaces. A Space provides a dedicated and readily accessible area for relevant services, pages, and content and supports the inclusion of specified members, each of whom have defined roles associated with permissions in the Space. Spaces bring people together in a virtual environment for ongoing interaction and information sharing—in essence, Spaces enable the formation and support of social networks.

This chapter provides information about working with Spaces. It contains the following sections:

- Section 49.1, "What You Should Know About Spaces"

- Section 49.2, "What Does a Space Look Like?"

- Section 49.3, "Viewing Available Spaces"

- Section 49.4, "Interacting with Spaces Before Logging In (Public User)"

- Section 49.5, "Viewing Information About a Space"

- Section 49.6, "Joining a Space"

- Section 49.7, "Searching in a Space"

- Section 49.8, "Viewing Pages in a Space"

- Section 49.9, "Personalizing Your View of Pages in a Space"

- Section 49.10, "Creating Your Own Page in a Space"

- Section 49.11, "Showing or Hiding Pages in Your View of a Space"

- Section 49.12, "Editing Your Pages in a Space"

- Section 49.13, "Copying a Page to Your View of a Space"

- Section 49.14, "Renaming Your Pages in a Space"

- Section 49.15, "Controlling User Access to Your Space Pages"

- Section 49.16, "Deleting Your Pages in a Space"

- Section 49.17, "Exposing a Space Page in Your View of the Home Space"

- Section 49.18, "Sending a Link to a Page in a Space"

- Section 49.19, "Viewing Information About a Page in a Space"

- Section 49.20, "Changing Your Role in a Space"

- Section 49.21, "Cancelling Space Membership"

Audience

This chapter is intended for WebCenter Spaces users who want to learn more about working with Spaces in a WebCenter Spaces application.

49.1 What You Should Know About Spaces

Within any company, large groups or departments frequently must break into smaller groups to focus on a particular goal, project, or even topic. Or, outside of a professional environment, communities of people with a common interest may wish to share and post information to foster the community. To help these groups organize themselves, WebCenter Spaces provides the notion of Spaces, which bring content together through a single access point, accessible through the WebCenter Spaces application or by direct URL, to help groups of people share information and interact in a collaborative social network. For example:

- Internal departments within your company that must share common information, such as HR, Sales, and so on.

- Software projects that must bring together the efforts and input of Development, Quality Assurance, Product Management, Documentation, and Curriculum Development.

- Special interest groups that share a common interest in a particular topic.

Many features and tools to facilitate teamwork are built into the Space framework, instantly allowing Space members to share documents, discuss issues, schedule meetings, exchange messages, create lists, and much more. Spaces can be monitored through RSS feeds, which you can add to your personalized view of the Home Space or view in any external RSS reader.

WebCenter Spaces provides templates for creating Spaces that support different types of endeavors. The flexibility of Space templates means that every Space can have a different look and feel. You can use an out-of-the-box template, or create your own custom templates using an existing Space as the basis for the template. For information about Space templates, see Chapter 50, "Working with Space Templates." After creation, Spaces can be completely customized, including the navigation controls, the color scheme, and the look and feel of any task flow or portlet, all from within the browser.

When you create a Space, you are the Space moderator. As the moderator, you manage the Space and establish the rules for membership to a Space (see Section 52.1, "Setting Up the Membership Policy for a Space"). When a new Space is created, WebCenter Spaces creates default Space roles with default permissions. The Space moderator can assign Space members to these roles and modify the default permissions as required, or create new custom roles (see Section 52.2, "Managing Roles and Permissions for a Space" and Section 52.3, "Managing Members and Assigning Roles").

Any Space can be parent to one or more Subspaces. This allows you to develop a Space hierarchy. For more information, see Chapter 54, "Working with a Space Hierarchy."

49.2 What Does a Space Look Like?

A newly created Space may look similar to Figure 49-1 (side navigation) or Figure 49-1 (top tabbed navigation). It is important to realize, however, that your WebCenter Spaces administrator or the Space moderator has most likely created and applied a custom page template to expose or hide tabs, features, and display a unique look and feel for your organization. A new Space that you create may look nothing like these examples.

Figure 49-1 A New Space Using the WebCenter Spaces Side Navigation Page Template

Figure 49-2 A New Space Using the WebCenter Spaces Top Navigation Page Template

Each page in a Space provides access to related information. In the example Space above, the Home page summarizes important information about the Philatelists club, the Documents page lists folders and files associated with the Philatelists club, the Discussions page provides a view of ongoing discussions with discussion forum management features, and so on. The Space moderator (or any Space member assigned the Moderator role or a custom role that includes the Spaces-Manage Configuration permission) uses the pages available through the Space administration settings to build and manage the Space, expanding and customizing it as needs change and grow. For information about Space administration tasks, see Chapter 50, "Working with Space Templates," Chapter 51, "Managing a Space," Chapter 52, "Managing Space Members and Roles," and Chapter 53, "Administering Spaces and Templates."

49.3 Viewing Available Spaces

WebCenter Spaces enables you to participate in multiple Spaces and manage your Space memberships through the Spaces Switcher menu, a Spaces Browser task flow, or the Spaces page, which display all the Spaces that are available to you.

To display a list of available Spaces:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

Tip:

Your WebCenter Spaces application may provide other ways to access the Spaces available to you. See Section 29.3.1, "Opening Spaces."

2. On the Spaces page, from the Show list, choose:

- All Spaces (Figure 49-3) to show all Spaces that are available to you, both public and private. Spaces defined as hidden when created are not shown.

Figure 49-3 Showing All Spaces

- Joined by Me to display Spaces to which you subscribe.

- Moderated by Me to display names of Spaces for which you have moderator privileges.

3. To list one or more specific Spaces, enter a full or partial search term in the Filter field, then click the Filter icon to refresh the list with all Spaces for which a match is found in the Display Name, Description, or Search Keywords (specified on the General page in the administration settings for the Space).

4. To clear the current search string and display all Spaces, click the Clear Filter icon.

5. To refresh the list of Spaces, first ensure that any prior search is cleared (click the Clear Filter icon), then click the Refresh icon.

6. To go to the Home page of a Space, click the Space name or icon.

7. To display a menu of actions available on the Space, right-click a Space icon or name to explore the actions that are available to you, depending on your permissions in the Space (Figure 49-4):

Figure 49-4 Space Actions Menu

Note:

Space administration selections (Manage Settings, Rename Space URL, and Delete the Space) are shown only if you are the Space moderator or have Manage Configuration permission on the Space.

Choose:

- Manage Settings to open the Space administration settings pages. See Chapter 51, "Managing a Space."

- Rename Space URL to change a Space URL that other people use to navigate to the Space. See Section 51.14.2, "Changing a Space URL."

- Delete the Space to delete the Space. See Section 51.17, "Deleting a Space."

- Contact menu:

- Subscribe to open the Subscribe dialog, where you can select notification messages that you want to receive whenever the listed actions occur within the scope of the Space. See Section 36.3.2, "Setting Space-Level Subscriptions."

- Send Mail to Members and Send Mail to Moderators. See Section 51.15, "Sending Mail to Space Members or Moderators."

- Membership menu:

- Change Role to change your role in the Space. See Section 49.20, "Changing Your Role in a Space"

- Cancel Membership to cancel your membership in the Space. See Section 49.21, "Cancelling Space Membership".

- About menu:

- About this Space to view information about the Space. See Section 49.5, "Viewing Information About a Space."

- Similar Spaces to open the Similar Spaces dialog, which provides suggestions of other Spaces similar to the current Space. A Space is considered similar to another Space if the same people perform similar actions in it, especially if they edit the content. Similar Spaces is provided by the Activity Graph service. For more information, see Chapter 58, "Working with the Activity Graph Service."

- Share Link to share the URL link to the Space with others. See Section 51.14.1, "Publishing the Link to a Space."

49.4 Interacting with Spaces Before Logging In (Public User)

Public Spaces are available to anyone with Internet access, without logging in to WebCenter, allowing a Space to be shared with non-members and people outside of the WebCenter Spaces community.

Public users who are not registered WebCenter Spaces users can access public Spaces in two ways:

- Directly, using the Space URL provided to them.

- From the WebCenter Spaces Welcome page, if their installation is configured to display this page (Figure 49-5).

Figure 49-5 Public Spaces Link on Welcome Page

The WebCenter Spaces administrator controls what a public user can see or do at the application level. For more information, see Section 21.2.4, "Granting Permissions to the Public-User."

When a Space is made public, the Public-User role in the Space is automatically granted View Pages and Content permission in the Space, which allows public users to view pages, lists, events, links and notes. To view announcements, discussions, and documents, the Space moderator must explicitly grant these permissions, as described in Section 51.14.5, "Granting Public Access to a Space." The public permissions granted by the Space moderator override the public permissions set by the administrator at the application level.

49.5 Viewing Information About a Space

To view information about a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

Tip:

Your WebCenter Spaces application may provide other ways to access the Spaces available to you. See Section 29.3.1, "Opening Spaces."

2. On the Spaces page, locate the Space that you want to learn about (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose About, then About this Space (Figure 49-6).

Figure 49-6 Space Actions Menu: About this Space

The About Space dialog opens (Figure 49-7).

Figure 49-7 About Space Dialog

3. Explore the information in the About Space dialog:

- Name: Internal name of the Space displayed in the Space URL. To change the internal Space name, see Section 51.14.2, "Changing a Space URL." Caution: When you change the internal Space name, bookmarks to the Space must be updated as they will no longer work.

- Display Name: Display name of the Space. This name displays at the top of the Space and other places where Spaces are available for selection, such as the Spaces Switcher menu and the Spaces page. To change the Space display name, see Section 51.4.1, "Renaming a Space." Changing the display name does not impact the URL that people use to navigate to the Space.

- Internal ID: ID of the Space, which other applications may use to reference this Space.

- Description: A description of the Space, specified when creating the Space or in the Space administration settings, as described in Section 51.4.2, "Modifying the Description or Keywords for a Space."

- Membership: Your role in the Space. If you are not a member of this Space and the Space allows membership self-service, a Join Space button displays here. See Section 49.6.1, "Joining a Space (Registered WebCenter Spaces User)."

- Created By: User name of the Space creator.

- Date Created: Date and time that the Space was created.

- Explorer URL: URL used expose the folders and files in a Space using Windows Explorer. See Section 46.4.1, "Adding a Space as a Network Place."

- Direct URL: URL that provides direct access to the Space.

49.6 Joining a Space

To become a member of a Space, you can join the Space. You may be registered with WebCenter Spaces, or you may be a public user. If a Space allows membership self-service (see Section 52.1.1, "Managing Self-Service Membership for a Space"), you can request membership to the Space. Or, you may receive an invitation to join a Space.

This section includes the following subsections:

- Section 49.6.1, "Joining a Space (Registered WebCenter Spaces User)"

- Section 49.6.2, "Joining a Space (Unregistered WebCenter Spaces User)"

49.6.1 Joining a Space (Registered WebCenter Spaces User)

To become a member of a Space, you can join the Space. If a Space is configured to allow membership self-service, you can request membership to the Space. Or, you may receive an invitation to join a Space.

Some membership requests require approval from the Space moderator so you may not gain access immediately. You will receive a Worklist notification when your membership is approved.

To join a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

Tip:

Your WebCenter Spaces application may provide other ways to access the Spaces available to you. See Section 29.3.1, "Opening Spaces."

2. On the Spaces page, from the Show menu, choose All Spaces.

3. To join a Space, you may have several options available to you, depending on the page template in use. For example, you may be able to simply click a Space to open the Request Membership dialog.

A generally available method to join a Space is through the About Space dialog: right-click the Space icon or name, and choose About, then About this Space (Figure 49-8).

Figure 49-8 Space Actions Menu: About this Space

4. In the About Space dialog, next to Membership, click Join Space (Figure 49-9).

Figure 49-9 About Space Dialog

Note:

Join Space is active only if the Space allows self-service membership (see Section 52.1.1, "Managing Self-Service Membership for a Space"). If Join Space is disabled, contact the Space moderator directly to request membership.

A Space membership request page similar to Figure 49-10 opens, showing the default Request Membership page. Because the Space moderator may customize this page, the page and roles you see may be different to the example shown here.

Figure 49-10 Requesting Space Membership

5. Select the type of Role you want to play in this Space.

Note:

Out-of-the-box Space roles include Viewer, Participant, and Moderator, but a subset of these or other custom roles names may display, depending on what roles the Space moderator has defined for the Space.

6. (Optional) In the Purpose field, enter an explanation of why you need access to the Space with the role you have requested.

7. Click Request Membership.

You should see a confirmation message similar to Figure 49-11, depending on whether or not the selected role requires moderator approval.

Figure 49-11 Confirmation Message (No Approval Required)

8. Click OK.

9. On the Spaces page, click the Refresh icon to confirm your new membership status.

Note:

If membership requests require approval, you do not gain access immediately. Check back later or monitor your Worklist—you will receive notification as soon as your membership is approved.

49.6.2 Joining a Space (Unregistered WebCenter Spaces User)

If you do not have are not a registered WebCenter Spaces, you can still view public Spaces but you cannot join a Space unless you receive a mail message from the Space moderator inviting you to join a Space (see Section 52.3.4.4, "Inviting a Non-WebCenter Spaces User"). If you want to join a Space, you must become a registered WebCenter Spaces user.

Some membership requests require approval from the Space moderator so you may not gain access immediately. You will receive a Worklist notification when your membership is approved.

1. In the mail message you receive inviting you to join a Space, click the Register Yourself link included in the invitation mail to open the Self-Registration page, similar to Figure 49-12. Because the Space moderator may customize this page, the page you see may be different to the example shown here.

Note:

For the Self-Registration page to display, either of the following must be checked in the WebCenter Spaces administration Membership Options, under Membership Self-Service:

- Allow Self-Service Membership or Self-Service Membership Change (All Roles Available)

- Allow Self-Service Membership or Self-Service Membership Change (Selected Roles Available)

For more information, see Chapter 52, "Managing Self-Service Membership for a Space."

Figure 49-12 Registering with WebCenter Spaces

2. Choose a suitable User Name. The user name restrictions depend on the underlying identity store that is configured with WebCenter Spaces.

Click Check User Name Available to determine whether a WebCenter user is registered with that name. Click OK to dismiss the confirmation message and, if necessary, enter a different name.

3. Enter a suitable Password, and then Re-enter Password for verification. The password restrictions depend on the underlying identity store that is configured with WebCenter Spaces.

4. Enter your First Name and Last Name, and an Email Address.

5. Click Register.

Once your User Name and Password are registered with WebCenter Spaces, the Space to which you were invited opens.

49.7 Searching in a Space

WebCenter Spaces includes the Search field at the top of the application for global (that is, application-wide) searches. To perform searches limited to a single Space, the Space administrator must create a new Resource Catalog, add the Search task flow from the library to the Catalog, and then assign this Catalog to the Space. The Search task flow is not available in the default Resource Catalog. For more information, see Section 56.3.2.2, "Performing a Space Search."

To search for individual pages in a Space, see Section 51.7.4, "Searching for Pages in a Space."

49.8 Viewing Pages in a Space

In a Space, members have access to system pages (see Table 7-2) and member-created pages. The content on a Space page is typically targeted to a particular audience or objective.

The way that you access the pages of a Space depends on the page template that is defined for the Space. At the application-level, the WebCenter Spaces administrator can define the page template to be used for all new Spaces, but anyone with Manage Configuration permission on a Space can modify the page template of an individual Space (see Section 51.4.9, "Changing the Page Template for a Space").

Note:

If you view a page at the same time that another user is editing the page, you may not immediately see the results of changes made by the other user in your session. To reliably see any changes, you must view the page after the other user has saved their edits.

Spaces moderators and members with page management permissions (see Table 52-2, "Space Permissions - Simple Permission Model") can manage Space pages on the Pages page (Figure 49-13) in the administration settings for the Space, which configures the default page settings for all members of the Space. For more information, see Section 51.7, "Creating and Managing Space Pages."

49.9 Personalizing Your View of Pages in a Space

You can personalize your view of pages in a Space on the Personalize Pages page. The actions available to you on this page depend on the permissions you are granted in the Space. If you have permissions to delete, edit, or set access privileges to a page, performing these actions affect all members in the Space as these actions alter the page itself. Actions such as reordering or showing and hiding pages is reflected in your "personal" view of the Space only.

To personalize your view of pages in a Space:

1. In the Space, display the Personalize Pages page (Figure 49-13)

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

Figure 49-13 Personalize Pages Page

2. On the Personalize Pages page, perform any of the actions available to you on the page or through the Actions menu for a specific page (Figure 49-13):

Figure 49-14 Personalize Pages: Page Actions Menu

- Create a new page. See Section 49.10, "Creating Your Own Page in a Space."

- Customize which pages you see in the Space. See Section 49.11, "Showing or Hiding Pages in Your View of a Space."

- Edit a page that you own or have privileges to edit. See Section 49.12, "Editing Your Pages in a Space."

- Make a personal copy of a page. See Section 49.13, "Copying a Page to Your View of a Space."

- Rename a page that you own or have privileges to manage. See Section 49.14, "Renaming Your Pages in a Space."

- Add or remove access to a page by user role. See Section 49.15, "Controlling User Access to Your Space Pages."

- Delete a page that you own or have privileges to manage. See Section 49.16, "Deleting Your Pages in a Space."

- Add a page to your personal view of the Home Space. See Section 49.17, "Exposing a Space Page in Your View of the Home Space."

- Send a link to a page that you own or have privileges to manage. See Section 49.18, "Sending a Link to a Page in a Space."

- View information about a page. See Section 49.19, "Viewing Information About a Page in a Space."

49.10 Creating Your Own Page in a Space

If you are granted permission to create pages (see Table 52-2, "Space Permissions - Simple Permission Model"), you can add your own pages to a Space (see Section 51.7.2, "Creating a Page in a Space").

The pages you create can be viewed by you and anyone to whom you grant access (see Section 49.15, "Controlling User Access to Your Space Pages").

To create your own page in a Space:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

2. On the Personalize Pages page, click Create Page (Figure 49-15)

Figure 49-15 Creating Your Own Page in a Space

3. In the Create Page dialog, specify the name and style for the new page.

For detailed information about each page style, see Section 15.1, "What You Should Know About Page Styles."

The new Space page opens in edit mode (Oracle Composer), where you can add content, then Save and Close the page.

See Also:

For information about adding content to a Space page, see:

- Chapter 17, "Building Pages"

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 41, "Working with the Documents Service Task Flows and Document Components"

49.11 Showing or Hiding Pages in Your View of a Space

To show or hide pages in your personal view of a Space:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

2. On the Personalize Pages page, select or clear the Show Page checkbox for the pages you want to show or hide.

49.12 Editing Your Pages in a Space

If you own or have write permissions on a page, you can edit the page. However, you should be aware that edit actions affect all members in the Space as these actions alter the page itself, not only your personalized view.

To edit a page that you own or have permission to edit:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose Edit Page to display the page in edit mode (Oracle Composer).

See Also:

For information about adding content to a Space page, see:

- Chapter 17, "Building Pages"

- Chapter 18, "Adding and Configuring Page Layout Components"

- Chapter 41, "Working with the Documents Service Task Flows and Document Components"

49.13 Copying a Page to Your View of a Space

To copy a page in a Space for your own purposes:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose Copy Page to open the Copy Page dialog.

The new page is available only to you, unless you make it available to others (see Section 49.15, "Controlling User Access to Your Space Pages."

49.14 Renaming Your Pages in a Space

If you own or have privileges to manage a page, you can rename the page. However, you should be aware that renaming a page affects all members in the Space as this action alters the page itself, not only your personalized view.

When you rename a page, keep in mind that any pretty URLs that use the old name will be broken. Also note that system pages, such as the Announcements, Lists, and Events pages, do not provide the option of being renamed.

See Also:

For information about pretty URLs, see Appendix A, "WebCenter Spaces User Interface URLs."

To rename a page that you own or have privileges to manage:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose Rename Page to open the Rename Page dialog.

3. Enter a new name for the page, and click the Save icon.

49.15 Controlling User Access to Your Space Pages

By default, the pages you create in a Space are accessible only to you and other Space members assigned the Moderator role or a custom role that includes the Spaces-Manage Configuration permission. You can use page access settings to enable other members to view and work with your pages and to remove that access.

When you grant access to one of your own Space pages to another user, the other user must deliberately show the page in his or her view. The user must take this step for each session because shared pages are not automatically shown on login.

See Also:

For information about how to show a hidden page, see Section 49.11, "Showing or Hiding Pages in Your View of a Space."

To control the access for other Space members to your pages:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose Set Page Access to open the Set Page Access dialog (Figure 49-16).

Figure 49-16 Set Page Access Dialog

3. Select the Access Method:

- To specify that the page should inherit access settings from the permissions established for the Space, select Use Application Permissions, then click OK to save your changes and exit the dialog. For information about setting global Space permissions, see Section 52.2, "Managing Roles and Permissions for a Space."

- To set custom access on the current page, select Use Custom Access Settings, and continue with the next steps.

4. To grant page access permissions to all authenticated users (that is, to users who are logged in to WebCenter Spaces), click Add Authenticated Access.

The role authenticated-role is added under Role or User with default Read access to the page.

5. To grant page access permissions to all public users, that is, users who have not logged in to WebCenter Spaces, click Add Public Access.

The role anonymous-role is added under Role or User with default Read access to the page (Figure 49-17).

Figure 49-17 Authenticated and Public User Read Access to a Page

6. To grant page access permissions to selected users, groups, and application roles, click the Add Access button to open the Add Access dialog (Figure 49-18).

Figure 49-18 The Add Access Dialog

7. In the Search field, enter a search term or the name of the user, group, or role for whom you want to enable access, and click the Search icon.

Tip:

Search terms must contain at least two characters.

Note:

In the Add Access dialog, you can add the default roles Moderator, Participant, and Viewer, and any custom roles that have been created for the Space.

For more information about Space roles, see Section 52.2, "Managing Roles and Permissions for a Space"

8. Select a user, group, or role by clicking in its row.

Note:

When you select a user name, the permissions you set are granted to that specific user. When you select a group or application role, the permissions you set are granted to all users who are members of that group or who are assigned that role.

To make multiple selections:

- Ctrl-Click to select multiple rows.

- Shift-Click to select a range of rows.

9. Click Select to close the Add Access dialog, and populate the Set Page Access dialog with the selected users, group, or roles (Figure 49-19)

Figure 49-19 Set Page Access Dialog

10. In the Set Page Access dialog, set the Page Access permissions as desired for each user, group, or role (Table 49-1).

Note:

If you set page access permissions for the anonymous-role (public users), the Space must also be made public to allow this page to be seen by public users. See Section 51.14.5, "Granting Public Access to a Space."

Table 49-1 Page Access Privileges in the Set Page Access Dialog

Icon

Name

Description

View Page

Users can access the page for viewing, but cannot perform any other actions on the page.

Edit Page

Users can edit the page using Oracle Composer. This includes adding, rearranging, and deleting content; renaming the page; and changing page properties, such as the page scheme.

Delete Page

Users can delete the page.

Perform All Page Actions

Users can perform all actions on the page.

Personalize Page

Users can rearrange page content and personalize his or her view of task flows, provided the task flow includes personalization settings.

Tip:

By default, all authenticated users and user roles that you add to the Set Page Access dialog are granted page view access. The other access privileges all require page view access.

11. If you wish to delete access to the page for a user role, select the user or role from which to revoke page access, and click Delete Access (Figure 49-20).

Figure 49-20 Delete Access Button

12. Click OK to save your changes and close the Set Page Access dialog.

49.16 Deleting Your Pages in a Space

If you own or have manage permissions on a page, you can delete the page. However, you should be aware that deleting a page affects all members, not only your personalized view.

To delete a page that you own or have permission to manage:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose Delete Page to display the Delete Page dialog.

3. Confirm deletion of the page, and click Delete.

49.17 Exposing a Space Page in Your View of the Home Space

You can make a Space page is available for viewing and revising from within your view of the Home Space according to your permissions on the page. The Space name is prepended to the page name, so the Sales Results page in the Space Finance becomes Finance - Sales Results in your view of the Home Space.

Note:

System pages that are exposed in a Space, such as Events, Lists, and Announcements, do not provide the option of being exposed in the Home Space. For information about System pages, see Section 7.3, "Working with System Pages."

If you delete such a page from your view of the Home Space, it remains a part of its original Space. In other words, deleting it simply removes it from your view of the Home Space; it does not actually delete the page. If the page is deleted from its parent Space, it is unavailable in your view of the Home Space. To clear it from your view, you must refresh the page list in the Home Space's Personalize Pages page.

To add a Space page to the list of pages in the Home Space, visible only to you in your personalized view of the Home Space:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and select Add to Home Space.

When you add a Space page to your view of the Home Space, the page scope remains that of the Space.

49.18 Sending a Link to a Page in a Space

If you own or have manage permissions on a page, you can send other Space members a link to the page.

To send mail to other Space members populated with a link to a particular page:

1. In the Space, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose Send Mail to open your mail application compose window, showing a URL link to the page.

49.19 Viewing Information About a Page in a Space

To view information about a page that you can view in a Space:

1. In the Space administration settings, display the Personalize Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Personalize Pages page, click the Actions icon for the page, and choose About This Page to open the Page Information dialog, which shows Name, Created By, Date Created, Last Modified, and Direct URL.

49.20 Changing Your Role in a Space

If you are unable to perform all the actions that you would like in your Space, you can request a change to your membership role. For example, you might want to participate in an interesting discussion thread or raise a new issue but in your current role you are only allowed to view ongoing discussions.

Role change requests may or may not require approval, depending on how the Space moderator has defined membership changes for a particular role (see Section 52.1.1, "Managing Self-Service Membership for a Space"). You will receive a Worklist notification when your new role is approved.

To change your Space role:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

Tip:

Your WebCenter Spaces application may provide other ways to access the Spaces available to you. See Section 29.3.1, "Opening Spaces."

2. On the Spaces page, locate the Space in which you want to change your role (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose Membership, then Change Role (Figure 49-21).

Figure 49-21 Change Membership Role

3. In the Change Membership dialog (Figure 49-22), choose your preferred role from the New Role list.

Note:

The New Role list is active only if the Space allows self-service membership changes (see Section 52.1.1, "Managing Self-Service Membership for a Space"). If New Role selections are disabled, contact the Space moderator directly to request a member role change.

If you wish to cancel your membership in the Space, click Cancel Membership.

Figure 49-22 Change Membership Dialog

The Space moderator controls the list of roles displayed here. Out-of-the-box Space roles include Viewer, Participant, and Moderator but a subset of these or other custom roles may display. For more information, see Section 52.1.1, "Managing Self-Service Membership for a Space"

4. Click OK.

A confirmation message displays whether or not the selected role change requires approval.

5. Click OK to acknowledge the confirmation message.

6. On the Spaces page, click the Refresh icon to confirm your membership status has changed for the Space.

Note:

Your new role is not effective immediately when membership change requests require approval. Check back later or monitor your Worklist; your new role will be effective as soon as the Space moderator approves it.

49.21 Cancelling Space Membership

When you no longer want or need membership in a Space, you can cancel your membership.

Some cancellation requests require approval from the Space moderator so you may not be removed from the Space immediately (see Section 52.1.1, "Managing Self-Service Membership for a Space"). You will receive a Worklist notification when your membership is removed.

Once you have successfully cancelled your membership in a Space, it will no longer be shown on the Spaces page when you select Joined by Me from the Show menu.

To cancel your membership in a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

Tip:

Your WebCenter Spaces application may provide other ways to access the Spaces available to you. See Section 29.3.1, "Opening Spaces."

2. On the Spaces page, locate the Space from which you want to remove your membership (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose Cancel Membership (Figure 49-21).

Figure 49-23 Cancelling Space Membership

A confirmation message displays to confirm that you want to cancel your membership in the Space.

3. Click OK to acknowledge the confirmation message.

4. On the Spaces page, select Joined by Me from the Show menu, then click the Refresh icon to confirm that the Space no longer displays.

Note:

If a cancellation request requires approval, you are not removed from the Space immediately. Check back later or monitor your Worklist; you will receive notification when your unsubscription request is approved or rejected by the Space moderator.

50 Working with Space Templates

If you have been granted the Spaces-Create permission by the WebCenter Spaces administrator, you can create a Space using one of the out-of-the-box Space templates, your own custom Space template, or a published Space template created by others. Space templates provide a consistent look and feel and an efficient way to get started creating a Space that is configured exactly as required by an organization.

This chapter includes the following sections:

- Section 50.1, "What You Should Know About Space Templates"

- Section 50.2, "Creating a Custom Space Template"

- Section 50.3, "Managing Space Templates"

Audience

This chapter is intended for users who want to know more about Space templates, create custom Space templates, and manage Space templates.

The WebCenter Spaces administrator has the authority to expose or hide some Space features and services. Contact your WebCenter Spaces administrator if some tasks discussed in this chapter are not available to you.

50.1 What You Should Know About Space Templates

When you create a Space, you can base it on a template, either provided out-of-the-box by WebCenter Spaces or a custom template that you or the WebCenter Spaces administrator design, as described in the following sections:

- Section 50.1.1, "Understanding Out-of-the-Box Space Templates"

- Section 50.1.2, "Understanding Custom Space Templates"

50.1.1 Understanding Out-of-the-Box Space Templates

WebCenter Spaces provides several Space templates out-of-the box from which you can choose when creating a new Space. These templates are named according to their general purpose, and can be used as a starting point for developing your own custom templates.

The out-of-the-box Space templates are:

- Blogger: Template for a Space where members can publish their opinions through blogs, and preconfigures announcements, discussions, documents, events, lists, and mail.

- Discussion Site: Template for a Space where members can exchange ideas in discussion forums to quickly resolve issues, come up with new product ideas, resolve customer escalations, determine new service offerings, and more.

- Document Exchange: Template for a Space centered around sharing and organizing documents to enable teams to quickly hone in on delivering agreed upon wording and messaging. This template also enables checkin and workflow around document approvals and working in teams.

- Portal Site: Template for a Space appropriate for a large organization with several smaller groups or departments, each of which needs to store their own content, engage in discussions, and more. This template speeds enterprise portal construction and delivery and enables teams to easily provide their unique value to the company, promoting their group's charter to all other organizations while securely collaborating within their team or organization.

This template provides an essentially unpopulated, unconfigured starting point for building a Space exactly to your specifications. When you create a Space using this template, it results in a blank Home page. All Space services such as discussions, announcements, and so on, are disabled.

- Project Site: Template for a Space where members can share information about a common project and maintain a common calendar. This template provides an optimal structure for supporting a core project team where members might come from different departments to work together toward reaching a common goal.

The focus of a Space based on this template is to streamline the process of starting a new project, defining the project team, and executing on project deliverables. Members can share documents, communicate with one other, keep up to date on status, and generally function better as a team than as individuals working side by side.

- Team Site: Template for a Space that provides an optimal structure for supporting communities of people who are working together to achieve a common goal, collaborating through document sharing, team announcements, discussion forums, mail, wikis, and more.

The focus of a Space based on this template is to learn more about a subject area through the sharing of expertise, ideas, and content. Team Site Spaces provide a consistent, dynamic, timely, and interactive participant experience. For example, all the Java programmers responsible for supporting your customer-facing Web site might want a place to keep up with what's happening in the Java world using discussion forums, links to articles about upcoming patches, and so on.

Note:

The out-of-the-box Space templates available in prior releases (Basic, Community of Interest, and Group Project) are deprecated. However, if needed, you can expose them in your WebCenter Spaces application by following the steps in "Exposing WebCenter Spaces Templates From a Previous Release" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

50.1.2 Understanding Custom Space Templates

A custom Space template may be simple, or may include robust functionality such as:

- Preseeded data, such as discussions, documents, lists, member information (including roles), pages, or site resources. When you select such a template to build a new Space, the new Space includes all the preseeded data.

- Custom java code that executes when you select the template for a new Space. For example, custom code may include logic to automatically create a mailing list for a new Space. For more information, see the chapter "Extending WebCenter Spaces Using JDeveloper" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

50.2 Creating a Custom Space Template

You cannot modify or delete the out-of-the-box Space templates described in Section 50.1, "What You Should Know About Space Templates", but any user with Create Space Template or higher permission can create new Space templates.

To create a custom Space template, you start by creating a Space based on an existing template (see Section 51.2, "Creating a New Space"), and customize it according to your requirements. Then, you can create a new Space template based on the customized Space that you have developed. During the creation of a Space template, you can select to inherit the discussions, documents, lists, member information (including roles), pages, or site resources from the parent Space. The security settings for the parent Space are inherited by the template

Note:

When creating a new Space template, the template does not inherit announcements from a parent Space.

As a Space template creator, you can publish Space templates for others to use; otherwise, they remain private and hidden from others. To make the template public, you must be granted Space Templates-Manage All permission.

Note:

WebCenter Spaces administrators can also create Space templates to be made available at the application level, and import and export custom Space templates from and to other WebCenter Spaces applications, including seeded data. For more information, see Chapter 53, "Administering Spaces and Templates."

To create a Space template:

1. In the Home Space, go to the Space Templates page (see Section 50.3.1, "Viewing Available Space Templates").

2. On the Space Templates page, click Create a Space Template.

The Create a Space Template dialog opens (Figure 50-1).

Figure 50-1 Create a Space Template Dialog: Setup Step

3. In the Setup step, enter a suitable Space Template Name and (optionally) Description. Choose a name that describes the Space template and other WebCenter Spaces users will recognize.

Space template names can contain alphanumeric characters, underscores, spaces, multi-byte characters, and special characters such as & and #. The maximum allowable length is 200 characters. The following reserved keywords are not allowed as the full Space template name either in upper or lowercase, or a combination of both—webcenter, pages, page, spaces, space, group, groups, Space, Spaces, webcenter space, webcenter spaces, webcenter administration, my Spaces, admin, last. These reserved words are allowable as part of a longer name (for example, Sales Group).

4. Click Next.

5. In the Spaces step, select a Space to use as the basis for your new Space template, then click Next.

6. In the Content step, select the services that contain data that you want the Space template to inherit from the parent Space (Figure 50-2).

Note:

Space templates can not inherit Announcements from a parent Space.

List definitions are always copied; checking Lists in this step specifies that you want to copy the list data, too.

Figure 50-2 Create a Space Template Dialog: Content Step

7. Click Create.

Note:

If an error message notifies you that the template creation failed because selected services could not be provisioned, the most likely cause is that backend servers (such as UCM or JIVE server) are down. Contact your WebCenter administrator to resolve this issue.

The new Space template displays on your Space Templates page in the Home Space. By default, the template is private, which means that only you as the template creator can see the template on your personal Space Templates page in the Home Space. Other users will not see the private template on their personal Space Templates page in the Home Space, but users granted the Application-Manage Configuration permission can view and manage private templates on the application-level Space Templates page. For more information, see Chapter 53, "Administering Spaces and Templates."

8. To publish your Space template to make it available to all WebCenter Spaces users, you must be granted the Space Templates-Manage All permission by the WebCenter Spaces administrator. If you have this permission, select the template name, then click the Edit menu, and choose Make Public.

The template is published and displays on the Space Templates page in the Home Space for all users.

50.3 Managing Space Templates

You cannot modify or delete the out-of-the-box Space templates provided by WebCenter Spaces (see Section 50.1.1, "Understanding Out-of-the-Box Space Templates"), but any user with Create Space Template or higher permission can create new Space templates, based on Spaces that they own (see Section 50.2, "Creating a Custom Space Template"), and manage the Space templates that they own.

The Space Templates page in the Home Space displays the out-of-the-box Space templates, Space templates created by the current user, and published templates available for general use.

The following sections describe the management tasks available to Space template creators, WebCenter Spaces administrators, and users granted the Space Templates - Manage All permission by the WebCenter Spaces administrator:

- Section 50.3.1, "Viewing Available Space Templates"

- Section 50.3.2, "Searching for a Space Template"

- Section 50.3.3, "Renaming a Space Template"

- Section 50.3.4, "Setting Up Access to a Space Template"

- Section 50.3.5, "Publishing or Hiding Space Templates"

- Section 50.3.6, "Deleting Space Templates"

50.3.1 Viewing Available Space Templates

To display the Space Templates page, showing the Space templates available to you for creating new Spaces:

- In the Home Space, click Space Templates.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Personalize Pages link.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

If Space Templates is not exposed In the Home Space, refer to Section 29.3.4, "Showing Hidden Pages."

50.3.2 Searching for a Space Template

To search for a Space template by a string in the Name or Description:

1. On the Space Templates page (see Section 50.3.1, "Viewing Available Space Templates"), enter a search string in the Filter field.

2. Click the Filter icon (Figure 50-3).

Figure 50-3 Filter Icon

The Space Templates page displays Space templates where the search string is found in the Name or Description.

3. To clear the current search string and display all Space templates, click the Clear Filter icon (Figure 50-4).

Figure 50-4 Clear Filter Icon

50.3.3 Renaming a Space Template

To rename a Space template:

1. On the Space Templates page (see Section 50.3.1, "Viewing Available Space Templates"), select the Space template.

2. From the Edit menu, choose Rename Space Template.

The Rename Space Template dialog opens.

3. In the Display Name field, enter a new name for the Space template. Optionally, enter a Description.

4. Click OK.

50.3.4 Setting Up Access to a Space Template

You can grant specific users and groups read-only or manage access to a Space template.

To set up access to a Space template:

1. On the Space Templates page (see Section 50.3.1, "Viewing Available Space Templates"), select the Space template.

2. From the Edit menu, choose Set Template Access.

The Set Template Access dialog opens (Figure 50-5).

Figure 50-5 Set Template Access Dialog

3. In the Set Template Access dialog:

- Click Add Users to open the Search Users dialog where you can select from a list of users or search for a user name. Enter—minimally—two consecutive characters from the name of your search target, using an asterisk as a wild card for preceding or following characters (the search term *do finds both condoleeza and doug).

- Click Add Groups to open the Search Groups dialog where you can search for a user group.

4. For each user or user group listed in the Set Template Access dialog, specify the level of access granted to grant:

- Select the View checkbox to grant read-only access to the Space template.

- Select the Manage checkbox to grant full access to the Space template.

5. Click OK.

50.3.5 Publishing or Hiding Space Templates

When you create a Space template (see Section 50.2, "Creating a Custom Space Template"), it is private by default. This means that only you as the template creator can see the template on your personal Space Templates page in the Home Space. Other users will not see the private template on their personal Space Templates page in the Home Space, but users granted the Application-Manage Configuration permission can view and manage private templates on the application-level Space Templates page. For more information, see Chapter 53, "Administering Spaces and Templates."

To publish or hide Space templates that you create to make them available to all WebCenter Spaces users, you must be granted the Space Templates-Manage All permission by the WebCenter Spaces administrator. If you have this permission:

1. On the Space Templates page (see Section 50.3.1, "Viewing Available Space Templates"), select the Space template(s).

To select multiple Space templates, Ctrl-click each template.

2. From the Edit menu, choose either of the following, depending on the template's current state:

- Make Public to publish the template to all WebCenter Spaces users.

- Remove Public Access to hide the template from all other WebCenter Spaces users (except yourself, as the template creator).

Note:

If you are in the process of creating a new Space (see Section 51.2, "Creating a New Space"), and the Space template you select for the Space is made private by another user before you have completed creating the Space, the template remains valid for your use while you are still creating the Space.

50.3.6 Deleting Space Templates

To delete one or more Space templates:

1. On the Space Templates page (see Section 50.3.1, "Viewing Available Space Templates"), select the Space template(s).

To select multiple Space templates, Ctrl-click each template.

2. From the Edit menu, choose Delete Space Template.

In the confirmation prompt, click Delete.

Note:

Out-of-the-box Space templates cannot be deleted. However, WebCenter Spaces administrators and users granted the Space Templates-Manage All permission can hide the out-of-the-box templates from everyone's view by making them private on the application-level Space Templates page, if granted the Application-Manage Configuration permission by the WebCenter Spaces administrator. For more information, see Chapter 53, "Administering Spaces and Templates."

51 Managing a Space

This chapter provides information about configuring and managing an environment dedicated to a group effort or an area of interest. It describes how to access Space administration pages, manage services, and perform administrative tasks for all members of a Space. It contains the following sections:

- Section 51.1, "Who Is the Space Moderator?"

- Section 51.2, "Creating a New Space"

- Section 51.3, "Accessing Space Administration Pages"

- Section 51.4, "Managing General Administration Settings for a Space"

- Section 51.5, "Managing Space Roles"

- Section 51.6, "Managing Space Members"

- Section 51.7, "Creating and Managing Space Pages"

- Section 51.8, "Managing Space Content"

- Section 51.9, "Managing Subspaces"

- Section 51.10, "Managing Space Services"

- Section 51.11, "Managing Space Resources"

- Section 51.12, "Defining Custom Attributes for a Space"

- Section 51.13, "Adding Wikis or Blogs to a Space"

- Section 51.14, "Making a Space Available"

- Section 51.15, "Sending Mail to Space Members or Moderators"

- Section 51.16, "Working with the Space Task Flows"

- Section 51.17, "Deleting a Space"

Audience

This chapter is intended for WebCenter Spaces users assigned the Moderator role or a custom role that includes the Spaces-Manage Configuration and Spaces-Manage Membership permissions.

Note:

For information about Space roles, see Section 52.2.1.1, "Understanding the Default Roles for a Space".

51.1 Who Is the Space Moderator?

If you have been granted the Spaces-Create permission by the WebCenter Spaces administrator, you can create a Space. When you create a Space, you become the default Space moderator, which means that you assigned the Moderator role. In this role, you have full control over the Space presentation and content, as well as administrative responsibilities, as listed in Section 52.2.1.1, "Understanding the Default Roles for a Space".

Other users may be assigned the Moderator role, or granted the permissions to manage specific areas of the Space. For more information, see Section 52.2, "Managing Roles and Permissions for a Space"

51.2 Creating a New Space

A Space provides an environment dedicated to a group effort or an area of interest. For more information, see Section 49.1, "What You Should Know About Spaces." If you have been granted the Spaces-Create permission by the WebCenter Spaces administrator, you can create a Space in a WebCenter Spaces application.

WebCenter Spaces creates a single discussion forum for a new Space. You can modify this default setting to allocate multiple discussion forums to the Space. See Section 51.10.3, "Modifying Discussion Forum Settings for a Space."

To create a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

2. On the Spaces page, click Create a Space.

If you do not see this option, ask your WebCenter Spaces administrator to grant you Create Spaces permission.

The Create a Space dialog opens.

3. In the Setup step (Figure 51-1), specify a Space name and, optionally, a description and keywords for the Space. Enter any keywords related to the content of the Space to make it more easily discoverable in search results. Separate keywords with a space or comma.

Figure 51-1 Create a Space Dialog: Setup Step

The name that you enter here displays at the top of the Space and other places where Spaces are available for selection, such as the Spaces Switcher menu and the Spaces page. Space names can contain alphanumeric characters, underscores, spaces, multibyte characters, and special characters such as & and #. The maximum allowable length is 200 characters. The following reserved keywords are not allowed as the full Space name either in upper or lowercase, or a combination of both—webcenter, pages, page, spaces, space, group, groups, Space, Spaces, webcenter space, webcenter spaces, webcenter administration, my Spaces, admin, last. These reserved words are allowable as part of a longer name (for example, Sales Group).

4. Click Next.

5. In the Access step (Figure 51-2), enter the last value of the URL for the Space. This value can be same as the Space name. The value you enter here has the same restrictions as the display name for the Space, noted above. The internal name of the Space is derived from this field.

This URL becomes the pretty URL the access the Space and must be unique.

Figure 51-2 Create a Space Dialog: Access Step

6. Choose an access level for the Space:

- Public: Anyone can visit the Space and view public information. When this setting is selected, the Public-User role in the Space is automatically granted View Pages and Content permission in the Space, which allows public users to view pages, lists, events, links and notes. To grant public users permissions to view announcements, discussions, and documents, you need to grant these permissions, as described in Section 51.14.5, "Granting Public Access to a Space."

- Private: People can discover this Space in search results and in the list of available Spaces, and can subscribe to it if invited to join or if self-subscription is enabled.

- Hidden: People must be invited to join this Space. The Space will not appear in search results or in the list of available Spaces.

Note:

To grant public access to the information in a Space, including its pages and any services you want to expose on the public pages See Section 51.14.5, "Granting Public Access to a Space."

7. Click Next.

8. In the Content step (Figure 51-3), select a Space template to use as the basis for your new Space. Use the Filter field to search for templates by name.

Figure 51-3 Create a Space Dialog: Content Step

See Also:

For more information, see Section 50.1, "What You Should Know About Space Templates".

Note:

A custom Space template may include preseeded data, such as discussions, documents, lists, member information (including roles), pages, or site resources. When you select such a template, the new Space includes all the preseeded data.

Note:

When you select a template on which to base a new Space, then subsequently the template is made private by another user before you have completed creating the Space, the template remains valid for your use while you are still creating the Space.

9. Click Create.

The new Space opens, displaying its Home page and the default look and feel that has been defined by your WebCenter Spaces administrator for all new Spaces. As the Space creator, you are automatically granted the Moderator role for this Space, and can being to populate, customize, and manage the Space as required. Later, when you are ready, you can set up the Space membership policy. See Section 52.3, "Managing Members and Assigning Roles."

Any Space can be parent to one or more Subspaces. This allows you to develop a Space hierarchy. For more information, see Chapter 54, "Working with a Space Hierarchy."

51.3 Accessing Space Administration Pages

Space moderators (or anyone granted Manage permissions in the Space) can access the administration pages for the Space:

Page

Description

General

Use this page to set various Space properties. For more information, see Section 51.4, "Managing General Administration Settings for a Space."

Roles

Use this page to manage Space roles and permissions. For more information, see Section 51.5, "Managing Space Roles."

Members

Use this page to manage Space members and assign member roles. For more information, see Section 51.5, "Managing Space Roles."

Pages

Use this page to manage Space pages. For more information, see Section 51.7, "Creating and Managing Space Pages."

Content

For more information, see Section 51.8, "Managing Space Content."

Subspaces

Use this page to manage child Spaces of the Space. For more information, see Chapter 54, "Working with a Space Hierarchy."

Services

Use this page to enable and disable services operating in the Space; for example: Announcements, Discussions, Documents, Events, and Lists. For more information, see Section 51.10, "Managing Space Services."

Resources

Use this page to manage the resources for the Space. For more information, see Section 51.11, "Managing Space Resources."

Custom Attributes

Use this page to define custom attributes for the Space. For more information, see Section 51.12, "Defining Custom Attributes for a Space."

To access administration pages for a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Spaces menu.

See also Section 29.3.1, "Opening Spaces."

2. On the Spaces page, select the Space.

See also Section 49.3, "Viewing Available Spaces".

3. Display the Space administration settings pages.

Tip:

The way you access these pages depends on the page template in use. For example, in a side navigation template, you may access Space administration pages through a Manage menu.

You can also navigate to these pages using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

If you do not have access to the Space administration pages, you do not have Manage permissions for this Space. See Section 49.20, "Changing Your Role in a Space".

51.4 Managing General Administration Settings for a Space

The General page of the Space administration settings provides access to the tasks described in the following sections:

- Section 51.4.1, "Renaming a Space"

- Section 51.4.2, "Modifying the Description or Keywords for a Space"

- Section 51.4.3, "Taking a Space Offline"

- Section 51.4.4, "Bringing a Space Back Online"

- Section 51.4.5, "Closing or Reactivating a Space"

- Section 51.4.6, "Enabling or Disabling RSS News Feeds for a Space"

- Section 51.4.7, "Changing the Space Icon"

- Section 51.4.8, "Changing the Space Logo"

- Section 51.4.9, "Changing the Page Template for a Space"

- Section 51.4.10, "Changing the Skin for a Space"

- Section 51.4.11, "Changing the Resource Catalogs for Pages and the Page Template for a Space"

- Section 51.4.12, "Changing the Navigation for a Space"

- Section 51.4.13, "Displaying or Hiding a Page Footer in a Space"

- Section 51.4.14, "Customizing the Copyright Statement and Privacy URL"

- Section 51.4.15, "Setting a Space Display Language"

- Section 51.4.16, "Changing the Access to a Space"

51.4.1 Renaming a Space

A Space display name appears in the top banner of the Space and in dialogs and pages where users can select the Space.

Note:

Changing the display name does not affect the internal name and URL for the Space. See Section 51.14.2, "Changing a Space URL".

To change the display name of a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, modify the Display Name.

Figure 51-4 Changing a Space Display Name

3. Click Apply to save.

51.4.2 Modifying the Description or Keywords for a Space

A Space description appears in the listing of the Space on the Spaces page. Keywords are useful to make a Space more easily discoverable in search results.

To enter or change the description of keywords for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, enter or modify the Description. and/or Search Keywords. Separate keywords with a space or comma.

Figure 51-5 Modifying a Space Description or Keywords

3. Click Apply to save.

51.4.3 Taking a Space Offline

You can take a Space temporarily offline for maintenance. For example, if you notice inappropriate content, you can take a Space offline to make required updates, then bring it back online. Only the WebCenter Spaces administrator or Space members with Manage Configuration permission can access a Space that is offline. Other members see the Space Unavailable page (see Section 7.3, "Working with System Pages.").

To permanently close down a Space that is not being used any more, see Section 51.4.5, "Closing or Reactivating a Space."

To take a Space offline:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, select Take Space Temporarily Offline (Figure 51-6).

Figure 51-6 Taking a Space Offline

3. Click Apply to save.

51.4.4 Bringing a Space Back Online

When a Space is offline, only the WebCenter Spaces administrator or Space members with Manage Configuration permission can bring the Space back online.

To bring a Space back online:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, clear the Take Space Temporarily Offline checkbox (Figure 51-7).

Figure 51-7 Bringing a Space Back Online

3. Click Apply to save.

51.4.5 Closing or Reactivating a Space

You can close a Space that is no longer being actively used. Closing a space archives its content. When you close a Space, it is removed from everyone's Spaces Switcher menu to avoid clutter, but it remains listed on the Spaces page. Space content remains accessible and searchable to those who still want to reference it and Space members can continue working in the Space.

To close down a Space temporarily, take the Space offline instead. See Section 51.4.3, "Taking a Space Offline."

To close a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, select the Close Space checkbox (Figure 51-8).

Figure 51-8 Closing a Space

To reactivate the Space, clear the Close Space checkbox.

3. Click Apply to save.

51.4.6 Enabling or Disabling RSS News Feeds for a Space

Space members can find out what is happening in a Space through RSS news feeds. Within the context of a Space, members can:

- Monitor recent activities.

- Track contributions to discussion forums.

- View announcements.

- Watch for revisions to lists.

For more information about publishing RSS new feeds, see Chapter 68, "Working with the RSS Service".

To enable or disable RSS news feeds for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, set Publish RSS as follows:

- To allow members access to Space information through RSS feeds, select Enable RSS Publishing (Figure 51-9).

- To disable RSS feeds for this Space, clear Enable RSS Publishing.

Figure 51-9 Enabling and Disabling Space RSS Feeds

3. Click Apply to save.

51.4.7 Changing the Space Icon

The space icon displays alongside the Space display name in menus and smaller areas. For example, it may display on the Spaces Switcher menu (Figure 51-10) or at the top of the Space (Figure 51-11).

Figure 51-10 Space Icon in Spaces Switcher Menu

Figure 51-11 Space Icon at Top of Space

A default icon is provided by the template used when you create the Space, but you can assign a different icon if desired.

To change the Space icon:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, enter the location and file name of a Group Space Icon, or click Browse to select an icon. For best results, select an icon of 16 x 16 pixels.

Note:

The icon file can be up to 1 MB. Supported file formats are .gif or .GIF, .png or .PNG, and .jpg or .JPG.

3. Click Apply to save.

51.4.8 Changing the Space Logo

The Space logo displays alongside the Space name in larger areas. For example, it may display on the Spaces page (Figure 51-12).

Figure 51-12 Space Logo on Spaces Page

A default logo is provided by the template used when you create the Space, but you can assign a different logo if desired.

To change the Space logo:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, enter the location and file name of a Space Logo, or click Browse to select a logo. For best results, select a logo to fit the 28 pixel height restriction.

Note:

The logo file can be up to 1 MB. Supported file formats are .gif or .GIF, .png or .PNG, and .jpg or .JPG.

3. Click Apply to save.

51.4.9 Changing the Page Template for a Space

A page template defines how individual pages and groups of pages display on a user's screen. For more information about page templates, see Chapter 12, "Working with Page Templates."

WebCenter Spaces provides several out-of-the-box page templates (see Section 12.1.1, "Out-of-the-Box Page Templates"). Alternatively, portal designers can create custom page templates to offer more ways to display pages on the screen, as described in Section 12.2, "Creating a Page Template." Within a Space, you can copy or customize an existing page template, as described below and in Section 51.11, "Managing Space Resources."

By default, a Space inherits the page template defined for the Space template that you choose when you create the Space.

Note:

If the Space template does not specify a page template, the Space uses the default page template specified by WebCenter Spaces administrator. See Section 5.8, "Choosing a Default Page Template".

You can optionally choose a different page template for the Space, overriding the Space template setting and the application setting.

To change the page template for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, choose a new Page Template (Figure 51-13).

Figure 51-13 Choosing a Page Template for a Space

The WebCenter Spaces administrator may choose to hide one or more out-of-the-box page templates (see Section 12.5.1, "Showing and Hiding a Page Template"). The [system default] selection applies the page template specified for the application by the WebCenter Spaces administrator (see Section 5.8, "Choosing a Default Page Template"). Additional custom page templates may be listed if they have been added to the application or the Space.

You can add custom page templates for the Space to this list in two ways:

- Copy an existing page template into a new page template, completely separate from the original, as described in Section 51.11, "Managing Space Resources."

- Customize an application-level page template to create a new page template for the Space. Any changes that are subsequently made to the page template at the application level are automatically cascaded down to the page template at the Space level. See Section 12.4, "Customizing a Page Template for a Space."

Note:

If you create a new page template for a Space, the custom page template is not shown in the Page Template list for Subspaces of the Space. To set the page template for a Subspace to the same page template used by its parent Space, you must use an EL expression. To make a custom page template available in the Page Templates list for all Spaces and Subspaces, it must be created at the application-level (see Section 12.2, "Creating a Page Template").

If you want WebCenter Spaces to determine the page template dynamically based on certain criteria, click the Expression Builder icon next to the Page Template list to open the editor, and then enter an EL expression that specifies the required behavior. For example: in a Subspace, the following EL expression sets the Page Template to the same setting as the parent Space:

{srmContext.resourceType['siteTemplate'].displayName['parent_page_template'].singleResult}

3. Click Apply.

51.4.10 Changing the Skin for a Space

A skin defines the appearance and look and feel of the application or a Space. For more information about skins, see Chapter 14, "Working with Skins."

WebCenter Spaces provides several out-of-the-box skins (see Section 14.1, "What You Should Know About Skins"). Alternatively, portal designers can develop custom skins to reflect a personality, or to incorporate specific branding, as described in Section 14.2, "Creating a Skin." Within a Space, you can copy an existing skin, as described below and in Section 51.11, "Managing Space Resources."

By default, a Space inherits its skin from the application-level settings, described in Section 5.7, "Choosing a Default Skin."

You can optionally choose a different skin for the Space, overriding the application setting. When you change the skin for a Space, the skin is applied to all the pages of the Space. However, the Space administration pages are not affected. They always appear with the default skin, Fusion FX.

To change the skin for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, choose a new Skin in which to wrap the Space (Figure 51-14).

Figure 51-14 Choosing a Skin for a Space

The WebCenter Spaces administrator may choose to hide one or more out-of-the-box skins (see Section 14.4.1, "Showing and Hiding a Skin"). The [system default] selection applies the skin specified for the application by the WebCenter Spaces administrator (see Section 5.7, "Choosing a Default Skin"). Additional custom skins may be listed if they have been added to the application or the Space.

You can add custom skins for the Space to this list by copying an existing skin into a new skin. For more information, see Section 51.11, "Managing Space Resources."

Note:

If you create a new skin for a Space, the custom skin is not shown in the Skin list for Subspaces of the Space. To set the skin for a Subspace to the same skin used by its parent Space, you must use an EL expression. To make a custom skin available in the Skin list for all Spaces and Subspaces, it must be created at the application-level (see Section 14.2, "Creating a Skin").

If you want WebCenter Spaces to determine the skin dynamically based on certain criteria, click the Expression Builder icon next to the Skin list to open the editor, and then enter an EL expression that specifies the required behavior.

3. Click Apply to save.

51.4.11 Changing the Resource Catalogs for Pages and the Page Template for a Space

When you edit a page or page template in a Space and click Add Content, a Resource Catalog displays. A Resource Catalog lists items that users may typically want to add to the page or page template, such as page layout components, portlets, and task flows. You can select items in the Resource Catalog to add them to your page or page template. For more information about Resource Catalogs, see Chapter 16, "Working with Resource Catalogs."

WebCenter Spaces provides two out-of-the-box Resource Catalogs for pages and the page template in a Space:

- Default Page Template Catalog for editing page templates.

- Default Space Catalog for editing individual pages and task flows in a Space.

For more information, see Section 16.1.1, "Understanding the Out-of-the-Box Resource Catalogs."

Alternatively, portal designers can develop custom Resource Catalogs, as described in Section 16.2, "Creating Resource Catalogs." Within a Space, you can create a new Resource Catalog from scratch or copy an existing Resource Catalog into a new Resource Catalog, as described below and in Section 51.11, "Managing Space Resources."

By default, a Space inherits the Resource Catalogs for its pages and the page template from the application-level settings, described in Section 5.10, "Choosing Default Resource Catalogs."

You can optionally choose different Resource Catalogs for the Space, overriding the application settings.

To change the Resource Catalogs used to edit pages or the page template in a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, choose a new Resource Catalog from the Resource Catalog for Pages or Resource Catalog for Page Templates lists (Figure 51-15).

Figure 51-15 Choosing a Resource Catalog for a Space

The WebCenter Spaces administrator may choose to hide one or more out-of-the-box Resource Catalogs (see Section 16.4, "Showing and Hiding a Resource Catalog"). The [system default] selection applies the Resource Catalogs specified for the application by the WebCenter Spaces administrator (see Section 5.10, "Choosing Default Resource Catalogs"). Additional custom Resource Catalogs may be listed if they have been added to the application or the Space.

You can add custom Resource Catalogs for the Space to this list by creating a new Resource Catalog from scratch or by copying an existing Resource Catalog into a new Resource Catalog. For more information, see Section 51.11, "Managing Space Resources."

Note:

If you create a new Resource Catalog for a Space, the custom Resource Catalog is not shown in the Resource Catalog lists for Subspaces of the Space. To set the Resource Catalogs for a Subspace to the same Resource Catalogs used by its parent Space, you must use an EL expression. To make a custom Resource Catalog available in the Resource Catalog lists for all Spaces and Subspaces, it must be created at the application-level (see Section 16.2, "Creating Resource Catalogs").

If you want WebCenter Spaces to determine the Resource Catalog dynamically based on certain criteria, click the Expression Builder icon next to the Resource Catalog lists to open the editor, and then enter an EL expression that specifies the required behavior.

3. Click Apply to save.

51.4.12 Changing the Navigation for a Space

Navigation enables Space members to see what information the Space provides and to get to that information quickly and easily. For more information about navigation models, see Chapter 11, "Working with Navigation."

WebCenter Spaces provides the following out-of-the-box navigation models for a Space:

- Spaces Administration Options contains administration options for a Space. By default, it includes a Manage dropdown menu to provide access to administration settings

- Spaces Default Navigation Model displays links to Space pages. By default, it is positioned at the top of the sidebar on the left-hand side of a Space.

- Spaces Navigation with Blogs/Wikis/Lists Submenus displays links to Space pages, and links to any wiki documents, blogs, and lists. By default, it is positioned at the top of the sidebar on the left-hand side of a Space.

For more information, see Section 11.1.1, "What You Should Know About Navigation Models."

Alternatively, portal designers can develop custom navigations, as described in Section 11.2, "Building a Navigation Model." Within a Space, you can create a new navigation from scratch or copy an existing navigation into a new navigation, as described below and in Section 51.11, "Managing Space Resources."

By default, a Space inherits its navigation from the application-level settings, described in Section 5.9, "Choosing a Default Navigation."

You can optionally choose a different navigation for the Space, overriding the application settings.

To change the navigation for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, choose a new Navigation (Figure 51-16).

Figure 51-16 Choosing a Navigation for a Space

The WebCenter Spaces administrator may choose to hide one or more out-of-the-box navigation models (see Section 10.4.3, "Showing and Hiding Resources"). The [system default] applies the navigation specified for the application by the WebCenter Spaces administrator (Section 5.9, "Choosing a Default Navigation"). Additional navigation models may be listed if they have been added to the application or the Space.

You can add custom navigations for the Space to this list by creating a new navigation from scratch or by copying an existing navigation into a new navigation. For more information, see Section 51.11, "Managing Space Resources."

Note:

If you create a new navigation for a Space, the custom navigation is not shown in the Navigation list for Subspaces of the Space. To set the navigation for a Subspace to the same navigation used by its parent Space, you must use an EL expression. To make a custom navigation available in the Navigation list for all Spaces and Subspaces, it must be created at the application-level (see Section 11.2.1, "Creating a Navigation Model").

If you want WebCenter Spaces to determine the navigation dynamically based on certain criteria, click the Expression Builder icon next to the Navigation list to open the editor, and then enter an EL expression that specifies the required behavior.

3. Click Apply to save.

51.4.13 Displaying or Hiding a Page Footer in a Space

A page footer can display copyright details for the Space and a link to its Privacy Statement.

To display or hide a page footer for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, select the Page Footer checkbox to display a page footer, or clear the checkbox to hide the page footer.

3. Click Apply to save.

51.4.14 Customizing the Copyright Statement and Privacy URL

When enabled, the copyright statements and URL to the privacy statement specific to the Space display in the page footer of the Space (Figure 51-17 and Figure 51-18):

Figure 51-17 WebCenter Spaces Copyright Statement

Figure 51-18 WebCenter Spaces Privacy URL

To customize the copyright statement and privacy URL for a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, select Display Page Footer to display the area at the bottom of the Space for the copyright statement and privacy URL (Figure 51-19). Clear the checkbox to hide the page footer, including the copyright statement and privacy URL.

Figure 51-19 Customizing the Copyright Statement and Privacy URL

3. In the Copyright and Privacy URL fields, enter appropriate values.

4. Click Apply to save.

51.4.15 Setting a Space Display Language

You can optionally set a Space display language to control the language in which the user interface (UI) elements of a particular Space render in WebCenter Spaces. UI elements include button and field labels, application links, screen text, and so on.

For more information about working with languages in WebCenter Spaces, and the different levels at which a display language can be set, see Chapter 24, "Working with Multilanguage Portals."

Within the scope of viewing a Space, the Space display language setting is given precedence over all other language settings. For example, if a Space named WebCenter Central has its display language set to German, and Monica (a member of WebCenter Central) sets her user preference language to Dutch, assuming no other language settings are in effect:

- Monica views the WebCenter Central Space in German, and cannot change this language setting.

- Monica views other parts of WebCenter Spaces, outside the WebCenter Central Space, in Dutch.

Note:

If you create a Space based on a Space template that is defined to use a specific language, that language setting is not inherited by the Space. Instead, the initial language setting for a new Space is based on the order of precedence described in Section 24.1.1, "Display Language Precedence.".

To set a Space display language:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Display Settings, select a language for the Space from the Default Language list (Figure 51-20).

Figure 51-20 Setting the Space Display Language

If you want WebCenter Spaces to determine the language dynamically based on certain criteria, click the Expression Builder icon next to the property field to open the editor, and then enter an EL expression that specifies the required behavior.

3. To customize the languages displayed in the Default Language list, click Customize. For example, your WebCenter Spaces application might be available in 27 different languages, but you might only need to display the content in your Space in three or four different languages, so you could filter the list to display only those languages.

51.4.16 Changing the Access to a Space

Access to a Space is defined when the Space is created (see Section 51.2, "Creating a New Space"). This access can be changed to make the Space more or less visible.

To change the access to a Space:

1. In the Space administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Access, select how you want the Space to be exposed:

Figure 51-21 Space Access Settings

- Public: Anyone can visit the Space, whether they are a registered WebCenter Spaces user or not. When this setting is selected, the Public-User role in the Space is automatically granted View Pages and Content permission in the Space, which allows public users to view pages, lists, events, links and notes. To grant public users permissions to view announcements, discussions, and documents, you need to grant these permissions, as described in Section 51.14.5, "Granting Public Access to a Space."

- Private: To access the Space, membership is required (either through invitation or self-registration if enabled). The Space will be shown in the list of available Spaces and will appear in search results.

- Hidden: To access the Space, membership is required (through invitation). The Space will be not shown in the list of available Spaces and will not appear in search results.

3. Click Apply to save.

51.5 Managing Space Roles

To manage the roles for assigning permissions in a Space:

1. In the Space administration settings, display the Roles page (Figure 51-22).

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

Figure 51-22 Space Administration: Roles Page

2. To work with Space roles, refer to Chapter 52, "Managing Space Members and Roles."

51.6 Managing Space Members

To manage the members of a Space:

1. In the Space administration settings, display the Members page (Figure 51-23).

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

Figure 51-23 Space Administration: Members Page

2. To work with Space members, refer to Chapter 52, "Managing Space Members and Roles."

51.7 Creating and Managing Space Pages

In a Space, members have access to member-created pages and system pages. The content on a Space page is typically targeted to a particular audience or objective.

System pages are provided to support a rapid deployment of your portal. They fulfill a range of needs, from a finished informational page (the Unauthorized page) to pages that provide content that is generated on the spot and tailored to members of the Space (the Activity Stream page). For complete information about system pages, including how to customize them, see Section 7.3, "Working with System Pages."

Figure 51-24 Space Administration: Pages Page

The following sections describe how to create and manage pages in a Space:

- Section 51.7.1, "Setting a Default Page Style"

- Section 51.7.2, "Creating a Page in a Space"

- Section 51.7.3, "Showing or Hiding Pages in a Space"

- Section 51.7.4, "Searching for Pages in a Space"

- Section 51.7.5, "Editing a Page in a Space"

- Section 51.7.6, "Copying a Page in a Space"

- Section 51.7.7, "Renaming a Page in a Space"

- Section 51.7.8, "Changing Access Permissions on a Space Page"

- Section 51.7.9, "Deleting a Page in a Space"

- Section 51.7.10, "Exposing a Space Page in the Home Space"

- Section 51.7.11, "Sending a Link to a Page in a Space"

- Section 51.7.12, "Viewing Information About a Page in a Space"

51.7.1 Setting a Default Page Style

To specify a default style for new pages in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click Set Page Defaults to display the Set Page Defaults dialog (Figure 51-25).

Figure 51-25 Set Page Defaults Dialog

For information about each page style, see Section 15.1, "What You Should Know About Page Styles."

3. Select an option next to Enable One-Click Page Creation:

Yes: Pages created for this Space must always use the Page Style chosen here. This enforces a common look and feel across the entire Space by skipping the Create Page dialog, and creating pages directly using this style.

No: Space members can create pages with a different style, with the default Page Style you specify displayed as the initial style in the Create Page dialog.

51.7.2 Creating a Page in a Space

To create a new page in a Space:

1. Use either of the following methods:

- In the Space, click Create Page. This method is available to anyone granted permission to create pages in the Space (see Table 52-2, "Space Permissions - Simple Permission Model")

Tip:

The location of the Create Page link depends on the page template in use. For example, in a side navigation template, you may access it through an Actions menu.

- In the Space administration settings, display the Pages page, then click Create Page. This method is available to anyone granted permission to manage pages in the Space (see Table 52-2, "Space Permissions - Simple Permission Model")

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

WebCenter Spaces will either:

- Open the Create Page dialog.

- Immediately create a new page with a default style, if specified in the Set Page Defaults dialog (see Section 51.7.1, "Setting a Default Page Style").

2. If the Create Page dialog opens, specify the name and style for the new page.

For detailed information about each page style, see Section 15.1, "What You Should Know About Page Styles."

The new Space page opens in edit mode (Oracle Composer), where you can add content, then Save and Close the page.

See Also:

For information about adding content to a Space page, see:

- Chapter 17, "Building Pages"

- Chapter 18, "Adding and Configuring Page Layout Components."

- Chapter 41, "Working with the Documents Service Task Flows and Document Components."

51.7.3 Showing or Hiding Pages in a Space

You can control the display of pages in the Space in either of the following ways:

- Define a navigation model for the Space to control what pages display and in what order and hierarchy. See Section 51.11, "Managing Space Resources" to access the Navigations resource for the Space and Chapter 11, "Working with Navigation" to build a navigation that includes the pages of the Space.

- If the navigation used by the Space shows all pages in the Space, selectively show or hide pages in the Space administration settings on the Pages page.

To show or hide pages for all members in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, select or clear the Show Page checkbox for the pages you want to show or hide.

51.7.4 Searching for Pages in a Space

To search for pages in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, use either of the following search methods:

- Filter search: Enter a full or partial search string in the Filter field, then click the Filter icon to refresh the list with all Space pages for which a match is found in Name or Created By. To clear the current search string and display all Space pages, click the Clear Filter icon.

- Filter panel: Click the Show or hide the filter panel icon to display a filter panel above the page list, then enter a full or partial search string in the fields above Name and/or Created By, and press Enter to refresh the list with all Space pages that match the filtering criteria. To clear the current search string and display all Space pages, clear the filter panel fields and press Enter.

To refresh the list of pages, first ensure that any prior filter is cleared (click the Clear Filter icon), and no filter is specified in the filter panel, then click the Refresh icon.

51.7.5 Editing a Page in a Space

To edit a page in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and choose Edit Page to display the page in edit mode (Oracle Composer).

See Also:

For information about adding content to a Space page, see:

- Chapter 17, "Building Pages"

- Chapter 18, "Adding and Configuring Page Layout Components."

- Chapter 41, "Working with the Documents Service Task Flows and Document Components."

51.7.6 Copying a Page in a Space

To copy a page in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and choose Copy Page to open the Copy Page dialog.

3. Enter a name for the new page, and click OK.

Note:

You must have the Spaces-Manage All permission (see Table 52-2, "Space Permissions - Simple Permission Model") to copy a page that is available to all members of a Space. If you have not been granted this permission, then the Copy Page selection is not available to you.

51.7.7 Renaming a Page in a Space

When you rename a page, keep in mind that any pretty URLs that use the old name will be broken. Also note that system pages, such as the Announcements, Lists, and Events pages, do not provide the option of being renamed.

See Also:

For information about pretty URLs, see Appendix A, "WebCenter Spaces User Interface URLs."

To rename a page in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and choose Rename Page to open the Rename Page dialog.

3. Enter a new name for the page, and click the Save icon.

51.7.8 Changing Access Permissions on a Space Page

Note:

To make an entire Space public, see Section 51.14.5, "Granting Public Access to a Space."

As the Space moderator, you are authorized to view and manage security for any page in the Space. Page owners normally determine who can see the Space pages they create (see Section 49.15, "Controlling User Access to Your Space Pages"), but, occasionally, when a page owner is not available, the Space moderator may be required to make changes.

In a public Space, public users (who are assigned the Public-User role by WebCenter Spaces) are granted View Pages and Content permission in the Space by default, which allows public users to view pages, lists, events, links and notes. If you want to restrict access to a specific page, you can remove public view access from the page. WebCenter Spaces provides a shortcut to remove and grant public read-only access to a page using the page Actions icon menu:

- To restrict access to a specific page to Space members only, click the Actions icon for the page, and choose Remove Public Access.

- To grant read-only access to a specific page in a public Space, click the Actions icon for the page, and choose Make Public.

Note:

These selections are active only if the Space is public (see Section 51.14.5, "Granting Public Access to a Space.").

To control the access to an individual page in a Space:

1. In the Space administration settings, display the Roles page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Roles page, select the role for which you want to specify page access permissions, then click Edit Permissions (Figure 51-26). For information about the default WebCenter Spaces roles in this list, see Section 52.2.1.1, "Understanding the Default Roles for a Space."

Figure 51-26 Granting WebCenter Spaces User Access to Space

3. In the Edit Permissions dialog, clear any checkboxes for page permissions under Basic Services, which apply to all pages in the Space. For information about the permissions listed in the Edit Permission dialog, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

4. Click Save.

5. In the Space administration settings, display the Pages page.

6. To modify user access to a page, click the Actions icon for the page, and choose Set Page Access to open the Set Page Access dialog (Figure 51-27).

Figure 51-27 Set Page Access Dialog

7. Select the Access Method:

- To specify that the page should inherit access settings from the permissions established for the Space, select Use Application Permissions, then click OK to save your changes and exit the dialog. For information about setting global Space permissions, see Section 52.2, "Managing Roles and Permissions for a Space."

- To set custom access on the current page, select Use Custom Access Settings, and continue with the next steps.

8. To grant page access to all authenticated users (that is, to users who are logged in to WebCenter Spaces), click Add Authenticated Access.

The role authenticated-role is added under Role or User with default Read access to the page.

9. To grant page access to all public users (that is, users who have not logged in to WebCenter Spaces), click Add Public Access.

The role anonymous-role is added under Role or User with default Read access to the page (Figure 51-28).

Figure 51-28 Authenticated and Public User Read Access to a Page

10. To grant page access permissions to selected users, groups, and application roles, click Add Access to open the Add Access dialog (Figure 51-29).

Figure 51-29 The Add Access Dialog

- In the Search field, enter a search term or the name of the user, group, or role for whom you want to enable access, and click the Search icon.

Tip:

Search terms must contain at least two characters.

Note:

In the Add Access dialog, you can add the default roles Moderator, Participant, and Viewer, and any custom roles that have been created for the Space.

For more information about Space roles, see Section 52.2, "Managing Roles and Permissions for a Space"

- Select a user, group, or role by clicking in its row.

Note:

When you select a user name, the permissions you set are granted to that specific user. When you select a group or application role, the permissions you set are granted to all users who are members of that group or who are assigned that role.

Ctrl-click or Shift-click to make multiple selections.

- Click Select to close the Add Access dialog, and populate the Set Page Access dialog with the selected users, group, or roles.

11. In the Set Page Access dialog, set the Page Access permissions as desired for each user, group, or role (Table 51-1).

Note:

If you set page access permissions for the anonymous-role (public users), the Space must also be made public to allow this page to be seen by public users. See Section 51.14.5, "Granting Public Access to a Space."

Table 51-1 Page Access Privileges in the Set Page Access Dialog

Icon

Name

Description

View Page

Users can access the page for viewing, but cannot perform any other actions on the page.

Edit Page

Users can edit the page using Oracle Composer. This includes adding, rearranging, and deleting content; renaming the page; and changing page properties, such as the page scheme.

Delete Page

Users can delete the page.

Perform All Page Actions

Users can perform all actions on the page.

Personalize Page

Users can rearrange page content and personalize his or her view of task flows, provided the task flow includes personalization settings.

Tip:

By default, all authenticated users and user roles that you add to the Set Page Access dialog are granted page view access. The other access privileges all require page view access.

12. Click OK to save your changes and close the Set Page Access dialog.

51.7.9 Deleting a Page in a Space

To delete a page in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and choose Delete Page to display the Delete Page dialog.

3. Confirm deletion of the page, and click Delete.

51.7.10 Exposing a Space Page in the Home Space

To add a Space page to the list of pages in the Home Space, visible to all WebCenter Spaces users:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and select Add to Home Space.

When you add a Space page to the Home Space, the page scope remains that of the Space.

51.7.11 Sending a Link to a Page in a Space

To send mail to Space members prepopulated with a link to a particular page:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and choose Send Mail to open your mail application compose window, showing a URL link to the page.

51.7.12 Viewing Information About a Page in a Space

To view information about a page in a Space:

1. In the Space administration settings, display the Pages page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Pages page, click the Actions icon for the page, and choose About This Page to open the Page Information dialog, which shows Name, Created By, Date Created, Last Modified, and Direct URL.

51.8 Managing Space Content

To manage the content in a Space in a centralized location:

1. In the Space administration settings, display the Content page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Content page (Figure 51-30), click the subtab for the service that supports the content with which you want to work:

- Announcements. For more information, see Chapter 59, "Working with the Announcements Service."

- Documents. For more information, see Section 41.1.1, "Understanding the Document Explorer Task Flow."

- Discussions. For more information, see Chapter 60, "Working with the Discussions Service."

- Events. For more information, see Chapter 61, "Working with the Events Service."

- Lists. For more information, see Chapter 64, "Working with the Lists Service."

- Polls. For more information, see Chapter 67, "Working with the Polls Service."

Figure 51-30 Space Administration: Content Page

The subtabs provide quick access to creating and managing content made available through the services that are enabled in the Space:

51.9 Managing Subspaces

To manage the Subspaces of a Space:

1. In the parent Space administration settings, display the Subspaces page (Figure 51-31).

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

Figure 51-31 Space Administration: Subspaces Page

2. To work with Subspaces, refer to Chapter 54, "Working with a Space Hierarchy."

51.10 Managing Space Services

Most service-related configuration is the responsibility of the Fusion Middleware administrator. The administrator configures and maintains service connections, which make the services available in WebCenter Spaces. For more information, see "Managing Oracle WebCenter Services" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. Also see Section 53.4, "Enabling and Disabling Services.".

You can check the Services page to see which services are available and can enable or disable services as required. If a service is not shown on the Services page, then the administrator has not configured that service connection.

You use the Roles page to configure role permissions for each service that is enabled in the Space. If a service is not shown on the Roles page, then the service is disabled in the Space. For more information, see Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

When you enable a service in a Space, you are automatically granted Manage permissions on that service.

The following sections describe service-related configuration activities that Space moderators can perform in a Space:

- Section 51.10.1, "Enabling and Disabling Services Available to a Space"

- Section 51.10.2, "Configuring a Custom Space Mail Distribution List"

- Section 51.10.3, "Modifying Discussion Forum Settings for a Space"

- Section 51.10.4, "Publishing Space Mail in a Discussion Forum"

- Section 51.10.5, "Configuring a Shared Mail Connection for a Space"

51.10.1 Enabling and Disabling Services Available to a Space

Most services operating within a Space are optional. Optional services include Announcements, Discussions, Documents, Space Events, Instant Messaging and Presence, and Lists.

When you disable a service, task flows associated with the service are no longer available. For example, if you disable the Discussions service:

- The Discussions page is not shown in the Space.

- Discussions task flows included in custom Space pages are replaced with a message Service was not enabled for this Space.

- Discussions task flows are not offered in the Resource Catalog for Space pages.

Additionally, permissions granted for disabled services are removed, and any existing data associated with the Discussions, Announcements, Documents, Space Events, and Lists services is deleted from the Space when you disable these services.

Space members do not automatically gain access to service-related task flows when you enable them here. You must also grant appropriate usage permissions for the service on the Roles page, as described in Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

To enable or disable a service in your Space:

1. In the Space administration settings, display the Services page (Figure 51-32).

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

Figure 51-32 Space Administration: Services Page

2. On the Services page, select or clear checkboxes to enable or disable services, respectively.

Note:

If you disable the Mail service, WebCenter deletes the default distribution list that was automatically created for the Space. Attempts to send mail to all members of the Space opens the mail window with the To field blank instead of pre-populated with the mail distribution list.

If you previously specified a custom distribution list (see Section 51.10.2, "Configuring a Custom Space Mail Distribution List"), then disable the Mail service, the custom distribution list is not deleted, but the relationship between the distribution list and the Space is deleted.

Note:

The Documents service is exposed on the Services page in a Space only with Oracle Content Server 11g. If the connected content repository is Oracle Content Server 10g, the Documents service is not available in the Space administration settings (Services and Roles). To use the Documents service functionality in 10g, you can create a page in a Space and add Documents service task flows to the page (see Section 41.4, "Adding a Documents Service Task Flow to a Page").

Refer to the online help for the Services page for more information about each of the services.

3. Click Apply to save.

4. To allow Space members to access the enabled services, you must grant appropriate permissions to the services for each member role on the Roles page. See Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

51.10.2 Configuring a Custom Space Mail Distribution List

Mail distribution lists provide an efficient mechanism for Space communication. WebCenter Spaces creates a default distribution list for every Space if the Mail Server is Microsoft Exchange and active directory connection details (LDAP) are provided in the mail server connection settings. For more information, see "Managing the Mail Service" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

A default distribution list is named as follows: space_name@mail_domain.

For example, the default distribution list for a Space named Finance Project is FinanceProject@mail_domain, where mail_domain is derived from the LDAP Domain setting in the Edit Mail Server Connection screen (accessed through Oracle Enterprise Manager). As members leave or join the Space, WebCenter Spaces updates the default distribution list.

If you disable the Mail service, WebCenter Spaces deletes the default distribution list that was automatically created for the Space. Attempts to send mail to all members of the Space (see Section 51.15, "Sending Mail to Space Members or Moderators") opens the Mail Compose dialog with the To field blank instead of prepopulated with the mail distribution list.

If you create a new custom distribution list for the Space, members of the new custom distribution list are not managed by WebCenter Spaces. As members leave or join the Space, they are not automatically removed from or added to the custom distribution list. If you create a new custom distribution list, then disable the Mail service, the custom distribution list is not deleted, but the relationship between the distribution list and the Space is deleted.

To configure a custom Space mailing list:

1. In the Space administration settings, display the Services page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Services page, select Mail (Figure 51-33).

Figure 51-33 Configuring the Space Mail Distribution List

3. To change the current Space mail distribution list, type a new Distribution List. Allowable characters are alphanumeric, dash (-), and underscore (_). Any other character is converted to a dash (-), and spaces are removed.

If the Distribution List field is left blank, the mail window will open with the To field blank.

4. Under 'Send Mail' Options, select one, both, or neither of the checkboxes:

- Select Include the Distribution List to populate the To field with the name of the Space distribution list.

- Select Include the Email Addresses of Space Members to populate the To field with the individual email address of the Space members.

5. Click Apply.

51.10.3 Modifying Discussion Forum Settings for a Space

By default, WebCenter Spaces creates a single discussion forum for a new Space. You can modify this default setting to allocate multiple discussion forums to the Space.

WebCenter Spaces stores all discussion forums and categories under the application root category on the discussions server. The WebCenter Spaces administrator can change the root category, as described in Section 6.2.2, "Specifying Where Discussions and Announcements are Stored on the Discussions Server". If required, you can change the default storage location for the discussion forums for a particular Space.

For more information about the discussions server, see "Setting Up Discussions Server Connections" and "Setting Defaults for Discussion Forums" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. For more information about the Discussions service, see Chapter 60, "Working with the Discussions Service."

To modify the discussion forum settings for a Space:

1. In the Space administration settings, display the Services page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Services page, select Discussions.

3. (Optional) To launch the Jive Forums Administration Console, the Web-based tool for configuring and managing discussion forums, click Forum Administration.

4. To allocate multiple discussion forums to the Space, select Support Multiple Forums for the Space (Figure 51-34).

Figure 51-34 Space Discussion Forum Settings: Single Forum

The page refreshes to show a category, under which the multiple forums are stored.

5. To store Space discussions in a different category and discussion forum than those specified by Category Name and Forum Name, click the Find icons (Figure 51-35) to change the storage location.

Figure 51-35 Space Discussion Forum Settings: Multiple Forums

6. Click Apply on to save the settings.

51.10.4 Publishing Space Mail in a Discussion Forum

Communication through the Space mail distribution list can be published as discussion forum posts. When a mail message is new, a new topic is created for it. When a mail message is a reply to an existing mail message, a topic reply is created for it.

Note:

WebCenter supports Microsoft Exchange server or any mail server that supports IMAP4 and SMTP. To enable WebCenter users to access mail within a WebCenter Spaces application and perform basic operations such as read, reply, and forward, you must first register the appropriate mail server with the WebCenter Spaces application. The Mail service is not configured out-of-the-box. Refer to "Setting Up Mail Server Connections" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To publish Space mail in a discussion forum:

1. In the Space administration settings, display the Services page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Services page, select Discussions.

3. To publish Space mail on a discussion forum of your choice, select Monitor Incoming Email (Figure 51-36)

To disable this feature so that mail is not published for any Space, clear this checkbox.

Figure 51-36 Space Discussion Forum Settings: Mail

4. Enter the Space Mail Account.

This is the distribution list used to mail Space members. For details, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List".

5. In the IMAP Host field, enter the name of the computer where the IMAP (Internet Message Access Protocol) service is running; in IMAP Port, enter the port on which the IMAP service listens.

6. Select Use SSL if a secured connection (SSL) is required for incoming mail over IMAP.

7. Enter the User Name and Password of a Space member with sufficient privileges to modify these settings (Manage privilege).

8. To publish Space mail on a different discussion forum than the forum specified by Forum Name, edit the value in Forum Name or Forum ID

Click the magnifier icon to display list of available forums in the Space (Figure 51-37).

Figure 51-37 Selecting a Forum for Space Mail

9. Single-click a forum in the list to select it.

Alternatively, create a forum from scratch. Click Create Forum, then enter a suitable name and description.

Note:

If you specify a mail distribution list that has been defined as the distribution list for a different Space, then the mail sent to that distribution list are by default archived in the discussion forum specified in the Mail Settings for that Space. Mail sent to a Space distribution list can only be archived one time in one forum, on a first come first served basis.

10. Click Apply to save the settings.

Note:

If no forum is specified for mail archiving, or the specified forum is deleted, mail sent to the distribution list is not archived anywhere.

51.10.5 Configuring a Shared Mail Connection for a Space

When a Space is configured to use a shared mail connection, users do not have to specify credentials when sending mails using the WebCenter Mail Service.

1. Confirm that WebCenter Spaces is using the WebCenter Mail service to send mail.

See also, Section 6.3.1, "Enabling Shared Mail Connections for Send Mail Notifications".

2. Ask your Fusion Middleware administrator to set up a mail connection that uses an external application configured with the shared credentials you require, and then record the name of that mail connection.

For details, see "Setting Up a Shared Mail Connection" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

3. In the Space administration settings, display the Custom Attributes page.

4. Add the custom attributes listed in Table 51-2 (and as shown in Figure 51-38):

Table 51-2 Custom Attributes for Shared Mail Connections

Name

Value

collab.mail.compose.sharedConnectionName

Name of the shared mail connection. For example: MySharedMailConnection

notifications.use.mail.composer

Must be set to true.

Figure 51-38 Setting Shared Mail Connection Attributes for a Space

5. (Optional). By default, Send Mail notifications are disabled for public/anonymous users. To enable them in a Space, add the following Space custom attribute:

notifications.anonymous.enabled = true

51.11 Managing Space Resources

The resources for a Space and the tasks associated with managing those resources are identical to the resources for the entire WebCenter Spaces application. For more information, see Chapter 10, "Working with the Resources that Compose a Portal or Community." Any custom resources that you create for a Space can be managed in both the Space and by the WebCenter Spaces administrator.

Table 51-3 describes the support available for creating various resources in a Space.

Table 51-3 Support for Creating Resources in a Space

Resource

Can You Create the Resource in a Space?

How can the Resource be Created?

Page Templates

Yes

Only by extending another page template.

Navigations

Yes

From scratch or by extending another navigation

Resource Catalogs

Yes

From scratch or by extending another Resource Catalog

Skins

Yes

Only by making a copy of another skin

Page Styles

No

(Not applicable)

Content Presenter templates

No

(Not applicable)

Mashup Styles

No

(Not applicable)

Data Controls

Yes

Only from scratch

Task flows

Yes

Only from scratch

To view, manage, or create resources for a Space:

1. In the Space administration settings, display the Resources page (Figure 51-37).

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

Figure 51-39 Space Administration: Services Page

2. On the Resources page, select the resource you want to view or manage:

3. Refer to the following sections for tasks related to working with Space resources:

- Section 10.1.5, "Viewing Information About a Resource"

- Section 10.2, "Creating Resources"

- Section 10.4, "Managing Resources"

51.12 Defining Custom Attributes for a Space

Every Space includes built-in attributes such as name, description, date created, icon, and so on. In addition to these built-in attributes, you can add custom attributes that are unique to the Space and its characteristics.

Custom attributes let you specify additional Space information (metadata). Custom attributes are propagated throughout the Space. Any Space pages, task flow, or portlet that delivers customized content based on parameter values can accept custom attribute values and display content accordingly using the following Expression Language (EL) syntax to access the custom attribute value:

#{spaceContext.currentSpace.metadata.customAttributes[attributeName]}

A custom attribute is simply a name value pair (such as customerId=400, orderId=11, or userName=Smith). The custom attribute name is unique within a Space. For example, if you build a Space for customer analysis purposes, it might contain several custom task flows that take the parameter customerId as an input: task flows such as Customer Sales History, Customer Satisfaction Rating, Future Sales Prospects, or Customer Contact Information. With a custom attribute defined named customerId with an appropriate customer value, all the task flows that can accept a customerId can display information specific to that customer.

A custom attribute can also be dynamic, using Expression Language (EL) expressions. For example, a custom attribute could use an EL expression to read a value that is passed in. A URL that displays the Space could pass the attribute value in the URL (for example, customerid=10), which would be applied to the custom attribute using the EL expression. For more information, see Section 19.4, "Passing Parameter Values Through the Page URL."

New Spaces based on a Space template that includes custom attributes will inherit the custom attributes and their values.

To add a custom attribute for a Space:

1. In the Space administration settings, display the Custom Attributes page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Custom Attributes page, click Add Attribute (Figure 51-40).

Figure 51-40 Space Administration: Custom Attributes Page

The Add Attribute dialog opens (Figure 51-41).

Figure 51-41 Entering Custom Attribute Name and Value

3. Enter a unique Name for the attribute.

4. Optionally, enter a Value for the custom attribute. You can type a static value, or specify a dynamic value by entering an Expression Language (EL) expression. See Appendix B, "Expression Language Expressions."

5. Click Add to save the custom attribute and display it in the list on the Custom Attributes page.

6. To edit or delete a selected attribute, click the Actions icon for the attribute and select the desired action:

- Edit Attribute to display the Edit Attribute dialog to modify the attribute name or value.

- Delete Attribute to display the Delete Attribute dialog to remove the attribute from the Space.

51.13 Adding Wikis or Blogs to a Space

You can include wikis and blogs as pages in a Space.

Wiki pages are populated and monitored by a collaborative group of users with common interests and goals. Users with sufficient permission on a wiki can edit the page to add to, revise, or remove information. Everyone works together to create resource pages that are relevant, useful, and up-to-date. For more information, see Chapter 47, "Working with Wiki Documents."

Blogs, however, are more personal records of experiences and opinions. Blog pages provide a useful means of capturing and publishing the knowledge and opinions of subject matter experts who are members of the Space. For more information, see Chapter 48, "Working with Blogs."

51.14 Making a Space Available

Once you have created a Space, you probably want others to be able to use it. As the Space moderator, you can determine whether the Space should be discoverable only by other WebCenter users, or publicly available:

- Section 51.14.1, "Publishing the Link to a Space"

- Section 51.14.2, "Changing a Space URL"

- Section 51.14.3, "Making a Space Known (Discoverable)"

- Section 51.14.4, "Granting WebCenter Spaces Users Access to a Space"

- Section 51.14.5, "Granting Public Access to a Space"

51.14.1 Publishing the Link to a Space

You can share a new Space or updates to an existing Space by publishing the link to the Space. With appropriate permissions, users can directly access a Space by clicking the link that specifies the Space display name.

To publish the direct link to a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

2. On the Spaces page, locate the Space you want to share (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose About, then Share Link (Figure 51-42).

Figure 51-42 Space Actions Menu Selection: Share Link

The Share Link dialog opens (Figure 51-43).

Figure 51-43 Share Link Dialog for a Space

3. Optionally, enter a comment to appear with the link.

4. Click Publish.

The URL to the Space is added to the activity stream for all users or groups who have permission to access the Space, along with your comments, if entered.

51.14.2 Changing a Space URL

You can change the URL that other people use to navigate to the Space. The format of a Space pretty URL is as follows:

http://host:port/webcenter/spaces/internal_space_name

For example: http://mycompany:8888/webcenter/spaces/release_meetings.

While it is possible to change the Space URL, it is important to note that any existing bookmarks to the Space will no longer work.In most cases you need only change the display name; that is, the name displayed on the main Space tab and on dialogs and pages where users can select the Space. For more information, see Section 51.4.1, "Renaming a Space".

To change a Space URL:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

2. On the Spaces page, locate the Space that you want to rename (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose Rename Space URL (Figure 51-44).

Figure 51-44 Space Actions Menu Selection

3. In the Rename Space URL dialog (Figure 51-45), revise the Space internal name portion of the URL as desired.

Figure 51-45 Rename Space URL Dialog

4. Click OK.

51.14.3 Making a Space Known (Discoverable)

You can make a Space discoverable by other WebCenter Spaces users on their Spaces page and in search results to let them know that it exists. Making a Space discoverable does not make its content accessible. Users interested in the Space can request membership through self-service (if enabled) or by mail.

To make a Space discoverable by other WebCenter Spaces users:

1. Set general access to the Space:

- If you are creating a new Space, select either Public or Private in the Access step of the Create a Space dialog, as described in Section 51.2, "Creating a New Space."

- If the Space is currently Hidden, select either Public or Private on the General page of the Space administration settings, as described in Section 51.4.16, "Changing the Access to a Space."

2. (Optional) To allow users to join the Space, you can enable self-registration too (you can still retain control by requiring approval for any subscription request). See Section 52.1.1, "Managing Self-Service Membership for a Space".

3. To add or invite specific WebCenter Spaces users and groups to the Space, allow WebCenter Spaces users to self-subscripe, or invite non-WebCenter Spaces users to subscribe to the Space, see Section 52.3, "Managing Members and Assigning Roles."

51.14.4 Granting WebCenter Spaces Users Access to a Space

After making the Space discoverable (see Section 51.14.3, "Making a Space Known (Discoverable)"), the next step is to assign the permissions that you want different user roles to have in the Space, if the default permissions are not satisfactory.

WebCenter Spaces users have the default Authenticated-User role. A Space is not fully accessible until you give the Authenticated-User role permissions to access the pages of the Space:

- To grant access to the entire Space: In the Edit Permissions dialog, under Pages, select the desired checkboxes for page permissions, which apply to all pages in the Space. See Section 52.2, "Managing Roles and Permissions for a Space." for detailed information.

- To grant access to a limited number of individual pages in the Space, see Section 51.7.8, "Changing Access Permissions on a Space Page.".

Note:

To use the task pane available through the Microsoft Office shared document management functionality (while editing a Microsoft Word, Excel, or PowerPoint file in a Space) to add members to a Space, see Section 52.3.4, "Adding Members to a Space."

51.14.5 Granting Public Access to a Space

You can make a Space available to anyone with access to the WebCenter Spaces instance that contains the Space. Registering for a WebCenter Spaces account is not required.The public information provided allows the Space to be shared with non-members and people outside of the WebCenter Spaces community.

Public users who are not registered WebCenter Spaces users can access public Spaces in two ways:

- Directly, using the Space URL provided to them.

- From the WebCenter Spaces Welcome page, if their installation is configured to display this page (Figure 51-46).

Figure 51-46 Public Spaces Link on Welcome Page

Public users are assigned the Public-User role, which has no access to Space information by default. To grant public access to a Space, including its pages and any content and services you want to expose on the public pages:

1. Specify the general access settings for the Space:

- If you are creating a new Space, select Public in the Access step of the Create a Space dialog, as described in Section 51.2, "Creating a New Space."

- If the Space is currently Hidden or Private, select Public on the General page of the Space administration settings, as described in Section 51.4.16, "Changing the Access to a Space."

When a Space is made public, the Public-User role is automatically granted View Pages and Content permission in the Space, which allows public users to view pages, lists, events, links and notes.

To see what the public view of a Space will look like, copy the Direct URL value in the About Space dialog (see Section 49.5, "Viewing Information About a Space"), log out of WebCenter Spaces, and paste the URL into your browser. Because you are logged out of WebCenter Spaces, only pages designated as public display.

2. (Optional) To allow public users to join your Space, you may want to enable self-registration too (you can still retain control by requiring approval for any subscription request). See Section 52.1.1, "Managing Self-Service Membership for a Space".

3. Now that you have made the Space public, the next step is to assign additional permissions that you want Public-User user role to have in the Space, if the default read-only View Pages and Content permission is not sufficient. You can additionally grant public users permissions to view announcements, discussions, and documents.

In the Space administration settings, display the Roles page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

4. On the Roles page, select Public-User, then click Edit Permissions (Figure 51-47).

Figure 51-47 Granting Public User Access to Space

5. In the Edit Permissions dialog, select the checkboxes for the desired public permissions for the Space to view announcements, discussions, or documents. For information about the permissions listed in the Edit Permission dialog, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

The public permissions that you grant here override the public permissions set by the administrator at the application level (see Section 21.2.4, "Granting Permissions to the Public-User").

6. If you want to restrict public access to certain pages in the Space, see Section 51.7.8, "Changing Access Permissions on a Space Page."

7. On the Roles page, click Apply to save.

51.15 Sending Mail to Space Members or Moderators

You can send mail to the members or the moderators of a Space using the default mail distribution list for the Space, and a custom distribution list. For more information, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List."

Note:

To use the task pane available through the Microsoft Office shared document management functionality (while editing a Microsoft Word, Excel, or PowerPoint file in a Space) to send mail to members of a Space, see Section 46.3.4.12, "Sending a Message."

To send mail to Space members or moderators:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

2. On the Spaces page, locate the Space to which the members or moderators belong (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose Contact, then Send Mail to Members or Send Mail to Moderators (Figure 51-48).

Figure 51-48 Space Actions Menu Selection: Send Mail

Your mail application opens, where you can compose and send mail to all members or moderators of the Space.

51.16 Working with the Space Task Flows

WebCenter Spaces provides two Space task flows that you can add to a page (Figure 51-49):

- Space Members: Adds an area that shows the Space members and provides controls to add new members, send a mail message to all members, filter the list by role, and search for members. For more information about this task flow, see Section 52.4, "Working with the Space Members Task Flow."

- Spaces Browser: Adds an area that operates identically to the Spaces page, as described in Section 49.3, "Viewing Available Spaces."

Figure 51-49 Space Task Flows: Space Members and Spaces Browser

The following sections provide information about working with the Space task flows:

- Section 51.16.1, "Adding a Space Task Flow to a Page"

- Section 51.16.2, "Setting Space Task Flow Properties"

51.16.1 Adding a Space Task Flow to a Page

To add a Space task flow to a page:

1. Go to the page where you want to add the task flow, and open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content to open the Resource Catalog.

3. Locate the Space Members and Spaces Browser task flows in the Resource Catalog.

Note:

These task flows are not available in the default Resource Catalogs provided out-of-the-box with WebCenter Spaces, so you will only see entries for the Space task flows if they have been added to the Resource Catalog that has been made available to the page.

For more information, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Task Flows, then scroll to Spaces Browser and/or Space Members). Once you have added a task flow to a custom Resource Catalog, you need to Show that catalog, then make that Resource Catalog active for pages in the Space, as described in Section 51.4.11, "Changing the Resource Catalogs for Pages and the Page Template for a Space."

4. Click Add next to the Space task flow you want to add to the page, then Close the Resource Catalog.

5. Click Save, then Close the page.

51.16.2 Setting Space Task Flow Properties

The Space Members and Spaces Browser task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 51-50 and Figure 51-51).

Figure 51-50 Space Members Task Flow Component Properties

Figure 51-51 Spaces Browser Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Spaces task flows and describe the properties on the Parameters tab for each task flow:

- Section 51.16.2.1, "What You Should Know About the Spaces Task Flow Properties"

- Section 51.16.2.2, "Setting Space Members Task Flow Properties"

- Section 51.16.2.3, "Setting Spaces Browser Task Flow Properties"

51.16.2.1 What You Should Know About the Spaces Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 51.16.2.3, "Setting Spaces Browser Task Flow Properties" and Section 51.16.2.2, "Setting Space Members Task Flow Properties." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Expression Builder icon next to a property field to open the editor.

For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

51.16.2.2 Setting Space Members Task Flow Properties

See Section 52.4.7, "Setting Space Members Task Flow Properties."

51.16.2.3 Setting Spaces Browser Task Flow Properties

Properties that are unique to the Spaces Browser task flow are shown on the Parameters tab of the Component Properties dialog (Figure 51-52).

Figure 51-52 Spaces Browser Task Flow Component Properties

For information about the properties on the other tabs, which are common to all WebCenter components, see Section 17.5.2, "Setting Properties on Page Components."

51.16.2.3.1 Spaces Browser Task Flow Parameters

Table 51-4 describes the parameters that are unique to the Spaces Browser task flow.

Table 51-4 Spaces Browser Task Flow Parameters

Parameter

Description

Advanced Query

Specifies an EL expression to retrieve a list of Spaces based on custom criteria. The expression may include the population from which to choose, a WHERE clause, and sort criteria. The expression must not be enclosed in #{ and }, and any backlashes and quotes must be escaped (using a backslash). For example, to display a list of publicly accessible Spaces created by user scott, sorted alphabetically by display name:

spaceContext.spacesQuery.unionOf[\'PUBLIC_ACCESSIBLE\'].whereClause[\'sp.createdBy = \\\'scott\\\'\'].sortCriteria[\'sp.displayName asc\']

For additional help with syntax, refer to the JavaDoc for oracle.webcenter.spaces.query.SpacesQueryParameters

Display Tool Bar

Specifies whether the tool bar displays:

- #{true} (default): Display the toolbar.

- #{false}: Hide the toolbar.

Display View

Specifies the type of layout in which to display Spaces in the Spaces Browser.

- Card Layout: Display Spaces in a card view.

- Tiled Layout (default): Display Spaces in a tiled view.

Filter

Specifies which Spaces should display in the Spaces Browser task flow.

- Show All (default)

- Show Joined

- Show Moderated

- Show Public

- Show Discoverable (all Public and Private Spaces)

Space Launched on Selection

Specifies whether to navigate to a Space when selected in the Spaces Browser task flow:

- #{true} (default): Clicking a Space opens the Space on the Home page.

- #{false}: Clicking a Space does not navigate to the Space. Instead, allows user to select the Space, staying on the same page with the selected Space highlighted.

51.17 Deleting a Space

When a Space has been closed or inactive for some time, you may want to remove it from WebCenter Spaces. Deleting a Space is permanent; it cannot be restored after it is deleted.

Deleting a Space means that:

- All pages associated within the Space are deleted.

- All Space data managed by WebCenter Spaces (links, lists, notes, tags, and Space events) is deleted.

- All Space roles and membership is deleted.

- Content managed by discussions and announcements is deleted when it is stored in the default forum or category created by WebCenter Spaces. However, content managed by nondefault forums or categories is not deleted (see Section 51.10.3, "Modifying Discussion Forum Settings for a Space").

- The Space mail distribution list that is automatically created byWebCenter Spaces is deleted. However, distribution lists that are customized by the Space moderator are not deleted (see Section 51.10.2, "Configuring a Custom Space Mail Distribution List").

- Content managed by external services, such as content repositories, mail, and so on, is removed.

To delete a Space:

1. In the Home Space, click Spaces, then choose Browse Spaces in the Spaces Switcher menu.

2. On the Spaces page, locate the Space that you want to delete (see Section 49.3, "Viewing Available Spaces"), then right-click the Space icon or name, and choose Delete the Space (Figure 51-53).

Figure 51-53 Deleting a Space

3. In the confirmation prompt, click Delete to confirm or Cancel to preserve the Space

52 Managing Space Members and Roles

This chapter provides information about managing members and roles for a Space. It contains the following sections:

- Section 52.1, "Setting Up the Membership Policy for a Space"

- Section 52.2, "Managing Roles and Permissions for a Space"

- Section 52.3, "Managing Members and Assigning Roles"

- Section 52.4, "Working with the Space Members Task Flow"

Audience

This chapter is intended for users who are responsible for managing Space members and their role assignments. It describes how to set up a Space membership policy and define member roles and responsibilities.

This chapter is intended for users assigned, minimally, the Space Moderator role or a custom role that includes the default permissions granted to a moderator.

The WebCenter Spaces administrator has the authority to expose or hide some features and services for all Spaces. Contact your WebCenter Spaces administrator if some tasks discussed in this chapter are not available to you.

Note:

For more information about Space roles, see Section 52.2.1, "What You Should Know About Roles and Permissions for a Space".

52.1 Setting Up the Membership Policy for a Space

Space moderators determine the membership policy for their Space, choosing between an "invitation only" membership policy, allowing WebCenter users to join themselves by subscribing to (and unsubscribing from) the Space, adding new members directly, or using any combination of these membership options.

Enabling self-service does not necessarily mean that users automatically gain access to a Space. Moderators can still control who joins (or leaves) the Space through an approval process.

Default membership permissions are derived from the template used to create the Space. Moderators can change these settings at any time. This section describes:

- Section 52.1.1, "Managing Self-Service Membership for a Space"

- Section 52.1.2, "Managing Self-Service Membership Removal from a Space"

52.1.1 Managing Self-Service Membership for a Space

As Space moderator, you can limit access to a Space, or allow WebCenter users to join themselves, without an invitation, through self-service.

Additionally, you may allow WebCenter users to join a Space or change their Space membership without approval, or require approval for certain roles. When membership requests require approval, new members do not automatically gain access when they subscribe to a Space. Instead, the moderator receives a subscription notification that he or she can either accept or reject.

To manage self-service for a Space:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select Membership Options in the toolbar.

3. Under Membership Self-Service:

- To prevent non-members from joining the Space through self-service or requesting changes to their current membership, select Do Not Allow Self-Service Membership or Self-Service Membership Change (Figure 52-1).

Figure 52-1 Disabling Self-Service

- To allow non-members to join a Space and members to request changes to their current membership, select Allow Self-Service Membership or Self-Service Membership Change (All Roles Available).

Note:

If you select this option, make sure that other people can see the Space through their Spaces page and through searches (see Section 51.14.3, "Making a Space Known (Discoverable)").

When you select this option, the following additional options become available through the Spaces page:

- Spaces that allow self-service display a Join Space button in the Space Information dialog box (select About> About this Space from the Space's Actions menu, as described in Section 49.6, "Joining a Space").

- Select Membership> Change Role from the Space's Action menu.

4. To be notified of self-service requests so you can approve or reject them before users become members of the Space, select Moderator Approval Required.

Tip:

This checkbox only displays when WebCenter Spaces workflows are configured for your application and the Worklist service is up and running.

5. To specify which roles users see on Request Membership and Change Membership pages, select Allow Self-Service Membership or Self-Service Membership Change (Selected Roles Available) to display a table showing all the roles available (Figure 52-2).

- Select Enable to offer the role on the Request Membership and Change Membership pages. Clear Enable to hide a role.

- Select Approval Required to specify that moderator approval is required before the request is granted. The request is sent to the moderator's Worklist to approve or reject (if the Space has multiple moderators, all moderators receive the request; only one moderator must process the request). Clear Approval Required to allow the change without moderator approval.

The Approval Required checkbox only displays when WebCenter Spaces workflows are configured for your application and the Worklist service is up and running.

Figure 52-2 Choosing Roles Available on Self-Service Membership

6. Click Save.

New members can now join this Space through self-service. For more information, see Section 49.6, "Joining a Space".

52.1.2 Managing Self-Service Membership Removal from a Space

If moderator approval is required to unsubscribe from a Space, an unsubscription request is sent to the moderator's Worklist when a member leaves to either accept or reject.

To configure approval options for Space unsubscription:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select Membership Options in the toolbar.

3. Under Membership Self-Service (Figure 52-3):

- To specify that moderator approval is required to leave a Space, select Moderator Approval Required for Self-Service Membership Removal.

- To allow members to leave without approval, clear Moderator Approval Required for Self-Service Membership Removal.

Tip:

This checkbox only displays when WebCenter Spaces workflows are configured for your application and the Worklist service is up and running.

Figure 52-3 Specifying Unsubscribe Request Approval Requirements

4. Click Save.

52.2 Managing Roles and Permissions for a Space

The Space moderator is responsible for setting up roles to control what members can do in the Space. Space moderators can manage permission assignments for existing roles, create new roles, and delete roles that are no longer required.

This section describes how moderators manage member roles and permissions:

- Section 52.2.1, "What You Should Know About Roles and Permissions for a Space"

- Section 52.2.2, "Defining Custom Roles for a Space"

- Section 52.2.3, "Viewing and Editing Permissions of a Space Role"

- Section 52.2.4, "Using the Advanced Permission Model"

- Section 52.2.5, "Deleting Roles in a Space"

52.2.1 What You Should Know About Roles and Permissions for a Space

When you create a new Space, WebCenter Spaces automatically creates some defaults roles, with default permissions. If the default roles do not meet the needs of the Space, Space moderators can define custom roles. This section provides the following information:

- Section 52.2.1.1, "Understanding the Default Roles for a Space"

- Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space"

- Section 52.2.1.3, "Understanding Custom Roles in Spaces"

52.2.1.1 Understanding the Default Roles for a Space

WebCenter Spaces automatically creates several default roles for a new Space, as shown in Table 52-1.

Note:

These default roles are always available for Spaces based on out-of-the-box templates (Basic, Group Project, and Community of Interest). Spaces based on user-defined templates may offer a different set of default roles. The default permissions assigned to the default roles are shown in Table 52-2.

Table 52-1 Default Roles for Spaces

Space Role

Description

Modify Permissions

Delete Role

Moderator

The Moderator role is automatically assigned to the creator of a Space. This role is automatically granted the highest level of permissions, as shown in Table 52-2.

The Space moderator or anyone with the Space Manage All permission can modify permissions as necessary and appropriate.

Yes (except for Manage All)

No

Participant

The Participant role is automatically granted the default permissions shown in Table 52-2.

The Space moderator or anyone with Space Manage All permission can grant additional permissions as necessary and appropriate.

Yes

Yes

Viewer

The Viewer role is automatically granted the default permissions shown in Table 52-2.

The Space moderator or anyone with Space Manage All permission can grant additional permissions as necessary and appropriate.

Yes

Yes

Authenticated-User

The Authenticated-User role is given to authenticated users of WebCenter Spaces, with no access to Space information by default. Once logged in, users assigned this role typically have access to the Home Space, and always inherit any permissions granted to the Public-User role.

To grant access to a Space, additional permissions must be granted by the Space moderator or anyone with Space Manage All permission (see Section 52.2.3, "Viewing and Editing Permissions of a Space Role").

Yes

No

Public-User

Any user with access to WebCenter Spaces who is not logged in assumes the Public-User role. Users with the Public-User role have no access to Space information by default. Such users are anonymous, unidentified, and Space permissions must be granted explicitly by the Space moderator or anyone with Space Manage All permission (see Section 52.2.3, "Viewing and Editing Permissions of a Space Role" and Section 51.14.5, "Granting Public Access to a Space").

Yes

No

52.2.1.2 Understanding Permissions and Permission Models in a Space

Members can perform actions within a Space as specified by the permissions assigned to their role.

When assigning roles, moderators can choose one of two permission models:

- Standard permission model:

- Basic Services collectively control access to pages, lists, events, links and notes

- Resources collectively control access to all resources types, including page templates, navigations, skins, resource catalogs, and so on

Table 52-2 lists the permission categories and permissions that are available when standard permissions are enabled.

- Advanced permission model:

- Separate service categories enable you to control access on a service-by-service basis. Separate permissions are provided for the following services: Pages, Events, Links, Lists, Notes.

- Separate resource categories enable you to control access on a resource-by-resource basis. Separate permissions are provided for the following resources: Skins, Page Templates, Navigations, Resource Catalogs, Page Styles, Content Presenter Templates, Data Controls, Task Flows.

While detailed permissions give you more flexibility over role assignments, they can become complex to manage and maintain. Table 52-3 lists the permission categories and permissions that are available when advanced permissions are enabled.

It is the Space template that determines the default permission model for a Space. Spaces that are based on out-of-the-box Space templates adopt the simpler, standard permission model by default, but moderators can switch to the advanced permission model if required. For more information. see Section 52.2.4, "Using the Advanced Permission Model".

Note:

Permissions do not inherit the privileges of "lesser" permissions. Therefore, be careful to assign the appropriate set of permissions to allow users to perform required actions. For example, whenever you assign the Create permission, select the View permission too.

Table 52-2 Space Permissions - Simple Permission Model

Permission Category

Permissions

Roles Granted Permission By Default

Administration

Manage All - Enable access to all Space Administration pages.

Includes Manage Configuration and Manage Membership permissions.

Moderator

Manage Configuration - Same as the Manage All permission but excludes security privileges. Users with this permission cannot access the Roles and Members pages.

Users with the Configure permission must be allowed to view the Space.

Manage Membership -Enables access to the Roles and Members pages in the Space administration settings. Through these pages, users can create, edit and delete members and roles for the Space.

Basic Services

(Events, Links, Lists, and Notes)

Edit Page Access, Structure, and Content - Create, edit and delete pages in the Space. Manage page access and edit page properties. Add and remove task flows and portlets. Create, edit, and delete lists, events, links, and notes.

Specifically, users with this permission can perform the following operations within the Space:

- Events - Create, delete, edit, and view events

- Links - Create, and delete links

- Lists - Create, delete, edit, update, and view lists

- Notes - Create, delete, edit, and view events

Moderator

Edit Page Access and Structure - Manage page access and edit properties of pages in the Space. Add and remove task flows and portlets.

Moderator
Participant

Customize Pages and Edit Content - Customize your view of pages in the Space. Add and remove list content, events, links, and notes.

Moderator
Participant

View Pages and Content - View pages, lists, events, links, and notes in the Space.

Moderator
Participant
Viewer

Announcements

Create, Edit, and Delete Announcements - Perform any operation on announcements associated with the Space.

Note: This permission does not take effect for the Public-User role.

Moderator

Create and Edit Announcements - Create and edit announcements. Delete announcements that you create.

Users with the Edit permission must be allowed to view announcements.

Note: This permission does not take effect for the Public-User role.

Participant

View Announcements - View announcements.

Participant
Viewer

Discussions

Create, Edit, and Delete Discussions - Perform any operation on discussions associated with the Space; create topics and replies. Edit and delete any topic or reply.

Note: The Manage permission does not take effect for the Public-User role.

Moderator

Create and Edit Discussions - Create topics and replies. Edit topics and replies that you create. Users with this permission must be allowed to view discussions.

Participant

Reply To Discussions - Reply to existing topics and edit replies that you create. Users with this permission must be allowed to view discussions.

Participant

View Discussions - View discussions.

Participant
Viewer

Documents

Administration - Configure document workflows and access control settings.

Moderator

Delete Documents - Delete any folder and any file in the Space, including wikis and blogs. Users with this permission can also move folder and files.

Users with the Delete permission must be allowed to create and view folders and files.

Moderator
Participant

Create and Edit Documents - Create files, wikis, blogs, and folders, and upload files. Delete files, wikis, blogs, and folders that you create. Delete other files and folders if permissions allow.

Users with the Create permission must be allowed to view folders and files.

Moderator
Participant

View Documents - Browse files, wikis, blogs, and folders.

Moderator
Participant
Viewer

Resources

Create, Edit, and Delete Resources - Create, edit, and delete resources owned by the Space, such as page, templates, navigations, resource catalogs, skins, page styles, content presenter templates, mashup styles, task flows, and data controls.

Moderator

Create Resources - Create new resources for the Space.

Edit Resources - Edit resources owned by the Space.

Table 52-3 Space Permissions - Advanced Permission Model

Permission Category

Permissions

Roles Granted Permission By Default

Administration

Manage All - Enable access to all Space administration pages.

Includes Manage Configuration and Manage Membership permissions.

Manage Configuration - Same as the Manage All permission but excludes security privileges. Users with this permission cannot access the Roles and Members pages.

Users with the Configure permission must be allowed to view the Space.

Manage Membership -Enables access to the Roles and Members pages in the Space administration settings. Through these pages, users can create, edit and delete members and roles for the Space.

Moderator

Pages

Create, Edit, and Delete Pages - Create and delete pages in the Space. Manage page access and edit page properties. Add and remove page content.

Moderator

Create Pages - Create pages in the Space.

Edit Pages - Edit page properties and content for any page in the Space.

Moderator
Participant

Delete Pages - Delete any page in the Space.

Customize Pages - Customize your page view.

Moderator
Participant

View Pages - View pages in the Space.

Moderator
Participant
Viewer

Announcements

Create, Edit, and Delete Announcements - Perform any operation on announcements associated with the Space.

Note: This permission does not take effect for the Public-User role.

Moderator

Create and Edit Announcements - Create and edit announcements. Delete announcements that you create.

Users with the Edit permission must be allowed to view announcements.

Note: This permission does not take effect for the Public-User role.

Participant

View Announcements - View announcements.

Participant
Viewer

Content Presenter Templates

Create, Edit, and Delete Content Presenter Templates - Create, edit and delete content display templates for the Space.

Create Content Presenter Templates - Create content display templates for the Space.

Edit Content Presenter Templates - Edit Space-level content display templates.

See also, Chapter 40, "Publishing Content Using Content Presenter".

Discussions

Create, Edit, and Delete Discussions - Perform any operation on discussions associated with the Space; create topics and replies. Edit and delete any topic or reply.

Note: The Manage permission does not take effect for the Public-User role.

Moderator

Create and Edit Discussions - Create topics and replies. Edit topics and replies that you create. Users with this permission must be allowed to view discussions.

Participant

Reply To Discussions - Reply to existing topics and edit replies that you create. Users with this permission must be allowed to view discussions.

Participant

View Discussions - View discussions.

Participant
Viewer

Documents

Administration - Configure document workflows and access control settings.

Moderator

Delete Documents - Delete any folder and any file in the Space. Users with this permission can also move folder and files.Users with the Delete permission must be allowed to create and view folders and files.

Moderator
Participant

Create and Edit Documents - Create files and folders, and upload files. Delete files and folders that you create. Delete other files and folders if permissions allow.

Users with the Create permission must be allowed to view folders and files.

Moderator
Participant

View Documents - Browse files and folders.

Moderator
Participant
Viewer

Links

Create, and Delete Links - Create and delete links between objects, and manage link permissions.

Create Links - Create links between objects.

Delete Links - Delete a link between two objects.

Lists

Create, Edit, and Delete Lists - Create, edit, and delete lists and list data.

Create Lists - Create a list.

Edit Lists - Edit list column definitions.

Delete Lists - Delete any list.

Edit List Data - Add, edit, and delete list data.

View Lists - View lists and list data.

Mashup Styles

Create, Edit, and Delete Mashup Styles - Create, edit and delete mashup styles for the Space.

Create Mashup Styles - Create mashup styles for the Space.

Edit Mashup Styles - Edit Space-level mashup styles.

See also, Section 26.3.4, "Managing Mashup Styles".

Navigations

Create, Edit, and Delete Navigations - Create, edit and delete navigations for the Space.

Create Navigations - Create navigations for the Space.

Edit Navigations - Edit Space-level navigations.

See also, Chapter 11, "Working with Navigation".

Notes

Create, Edit, and Delete Notes - Create, edit and delete notes for the Space.

Create Notes - Create notes for the Space.

Edit Notes - Edit notes.

Delete Notes - Delete notes.

View Notes - View notes.

Page Styles

Create, Edit, and Delete Page Styles - Create, edit and delete page styles for the Space.

Create Page Styles - Create page styles for the Space.

Edit Page Styles - Edit Space-level page styles.

See also, Chapter 15, "Working with Page Styles".

Page Templates

Create, Edit, and Delete Page Templates - Create, edit and delete page templates for the Space.

Create Page Templates - Create page templates for the Space.

Edit Page Templates - Edit Space-level page templates.

See also, Chapter 12, "Working with Page Templates".

Resource Catalogs

Create, Edit, and Delete Resource Catalogs - Create, edit and delete resource catalogs for the Space.

Create Resource Catalogs - Create resource catalogs for the Space.

Edit Resource Catalogs - Edit Space-level resource catalogs.

See also, Chapter 16, "Working with Resource Catalogs".

Skins

Create, Edit, and Delete Skins - Create, edit and delete skins for the Space.

Create Skins - Create skins for the Space.

Edit Skins - Edit Space-level skins.

See also, Chapter 14, "Working with Skins".

Space Events

Create, Edit, and Delete Events - Create, edit and delete events for the Space.

Create Events - Create events.

Edit Events - Edit any event.

Delete Events - Delete any event.

View Events - View events.

Task Flows

Create, Edit, and Delete Task Flows - Create, edit and delete task flows based on a mashup style for the Space.

Create Task Flows - Create task flows for the Space.

Edit Task Flows - Edit Space-level task flows.

See also, Section 26.3, "Creating and Managing Task Flows".

52.2.1.3 Understanding Custom Roles in Spaces

If the default roles do not meet the requirements of your Space, moderators can define custom roles that better suit its members. See Section 52.2.2, "Defining Custom Roles for a Space".

Alternatively, moderators can modify the permissions assigned to the default roles. See Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

52.2.2 Defining Custom Roles for a Space

If the default roles provided by WebCenter Spaces do not meet the needs of the Space, you can define custom roles to better suit the requirements of your members.

To create a new role for a Space:

1. In the Space administration settings, display the Roles page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

On the Roles page, current roles defined for this Space display as columns in the table.

2. To define a new role for this Space, click Create Role.

The Create Role dialog box opens (Figure 52-4).

Figure 52-4 Creating a New Role for a Space

3. Enter a suitable Role Name. Names can contain alphanumeric characters, blank spaces, @, and underscores. Ensure that role names are self-descriptive to make it as obvious as possible which member should belong to which roles.

4. Enter a Description for the role.

5. Optionally, choose a Template Role.

The new role inherits permissions from the template role. You can modify these permissions in the next step. If you do not choose a template role, the new role is created with no permissions.

Choose Moderator to create a role that inherits full administrative privileges for the Space. Choose Viewer (if available) to create a role starting with minimal, view-only privileges.

6. Click OK.

The new role appears as a column in the table on the Roles page.

7. To modify permissions for the role, select Edit Permissions, and then select or clear each permission checkbox. For details, see Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

Take care to assign appropriate access rights when assigning permissions for new roles. Do not allow users to perform more actions than are necessary for the role but at the same time, try not to inadvertently restrict them from activities they must perform.

52.2.3 Viewing and Editing Permissions of a Space Role

The Edit Permissions dialog lists permissions available for the Space, pages in the Space, Space resources, and services that are enabled for the Space. If a service is not shown, then either no permissions are required for that service (for example, the Mail service), or the service is disabled in the Space. For more information, see Section 51.10.1, "Enabling and Disabling Services Available to a Space".

If the default permissions assigned by WebCenter Spaces do not meet the needs of the Space, or you want to change previously assigned permissions, you can modify the permissions to better suit your role requirements.

Note:

The Moderator role permission Manage All cannot be modified.

To change the permissions assigned to a role:

1. In the Space administration settings, display the Roles page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select the role you want to change, then click Edit Permissions.

3. On the Edit Permissions for <role_name> dialog, select or clear the checkboxes to enable or disable permissions for a role (Figure 52-5).

Figure 52-5 Modifying Permissions for a Space

4. Click Save.

New permissions are effective immediately.

Note:

For more detailed information about granting access permissions to a Space, and to individual pages within a Space, refer to Section 51.14.4, "Granting WebCenter Spaces Users Access to a Space".

52.2.4 Using the Advanced Permission Model

Advanced permissions are detailed permissions that give you more flexibility over role assignments, but can become complex to manage and maintain. For example, you can set create, edit, view, and delete permissions for individual services and resources, rather than setting the same permission for all services or all resource types.If you switch to using the advanced permission model, you cannot revert back to standard permissions later. See also, Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space".

To use advanced permissions:

1. In the Space administration settings, display the Roles page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Click Advanced Permissions.

A warning message displays.

3. Click OK to continue.

52.2.5 Deleting Roles in a Space

When a role is no longer required, the Space moderator can remove it from the Space. This helps maintain a valid role list and prevents inappropriate role assignment.

Note:

The roles Moderator, Authenticated-User, and Public-User cannot be deleted.

To delete a role in a Space:

1. In the Space administration settings, display the Roles page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select the role you want to delete, then click Remove Role (Figure 52-6).

Figure 52-6 Deleting a Role for a Space

3. In the Delete Role confirmation dialog box, click Delete to confirm that you want to delete the role.

52.3 Managing Members and Assigning Roles

This section describes how moderators manage membership for a Space. It includes the following subsections:

- Section 52.3.1, "What You Should Know About Space Membership"

- Section 52.3.2, "Viewing Members of a Space"

- Section 52.3.3, "Composing Messages to New Members"

- Section 52.3.4, "Adding Members to a Space"

- Section 52.3.5, "Changing Member Role Assignments"

- Section 52.3.6, "Approving Requests for Membership of a Space"

- Section 52.3.7, "Communicating with Moderators and Members of a Space"

- Section 52.3.8, "Revoking Membership"

52.3.1 What You Should Know About Space Membership

Member participation is central to any Space. It is the moderator's responsibility to manage membership and determine member participation through the permissions assigned to the various roles defined for the Space. A Space can gather members in several ways:

- If a Space is marked as discoverable (see Section 51.14.3, "Making a Space Known (Discoverable)"), it can be made known to anyone logged in to WebCenter Spaces through searches and through their Spaces page.

- If a Space is made public (see Section 51.14.5, "Granting Public Access to a Space"), it is available to anyone with access to the WebCenter Spaces instance providing that the Public-User role is granted with appropriate permissions.

- Moderators can add or invite individual members or groups at the time a Space is created, or later (see Section 52.3.4, "Adding Members to a Space").

52.3.2 Viewing Members of a Space

To review current membership for a Space:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. In the Members table, review the current list of members and their current role assignment.

3. Using the Filter dropdown, choose All Members to see a full list or choose the name of a role to list members with a particular role.

52.3.3 Composing Messages to New Members

When you add or invite someone to your Space, they receive a message through the Mail service (if configured) and through their Worklist (if Worklists are set up). Before you start recruiting new members, take some time to compose suitable greetings and messages for the following scenarios:

- Adding a WebCenter Spaces user as a member of your Space.

- Inviting a WebCenter Spaces user to join your Space.

- Inviting someone to register with WebCenter Spaces and join your Space.

To compose messages sent out to new members:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select Membership Options in the toolbar.

The Membership Options dialog displays (Figure 52-7).

Figure 52-7 Editing Messages to New Members

3. Enter a short message to include in membership notifications or invitations in the appropriate sections, as required. Use the message text to describe the Space and how it might be of use to new members.

4. Click OK to save.

52.3.4 Adding Members to a Space

This section describes various ways that a moderator can enlist Space members:

- Section 52.3.4.1, "Adding WebCenter Spaces Users and Groups"

- Section 52.3.4.2, "Inviting a WebCenter Spaces User"

- Section 52.3.4.3, "Allowing a WebCenter Spaces User to Self-Subscribe"

- Section 52.3.4.4, "Inviting a Non-WebCenter Spaces User"

52.3.4.1 Adding WebCenter Spaces Users and Groups

As Space moderator, you can add any registered WebCenter Spaces user to become a member of your Space. WebCenter Spaces users receive notification through the Mail service (if configured) and through their Worklist (if Worklists are set up).

To add a member to your Space:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. (Optional) Click Membership Options to edit the greeting messages sent to new members (see Section 52.3.3, "Composing Messages to New Members").

3. Choose one of:

- Add People to add one or more individual users as members of the Space.

- Add Groups to add multiple users belonging to a named user group in the identity store.

4. If you know the exact name of the person or group, enter the name in the box provided, separating multiple names with a comma (Figure 52-8).

If you are not sure of the name you can search the identity store. Enter one or more characters of the name you are looking for and click the Filter icon. Users (or groups) matching your search criteria display in the table.

The First Name, Last Name, Mail Address, and CN fields are included in the search.

Search Tips:

- Use * as a wildcard, for example *sales.

- Leave the search field blank to list all users (or groups) in the identity store.

- Enter a space between two search terms to search First Name and Last Name, for example jo sm, searches for jo in First Name and sm in Last Name.

Figure 52-8 Adding a New Member

5. Select one or more user names from the list.

Note:

Adding the PUBLIC user to a Space does not make the Space available to the public. To find out how to make a Space public, see Section 51.14.5, "Granting Public Access to a Space".

6. Select a role for the new (or invited) members. If the role you want is not listed, create a role that meets your requirements (see Section 52.2.2, "Defining Custom Roles for a Space").

7. Click Add.

All the users and groups you select display in the Members table.

52.3.4.2 Inviting a WebCenter Spaces User

As Space moderator, you can invite anyone who is a registered WebCenter Spaces users to become a member of your Space. WebCenter Spaces users receive notification through the Mail service (if configured) and through their Worklist (if Worklists are set up).

To invite a member to your Space:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. (Optional) Click Membership Options to edit the greeting message sent to invited members (see Section 52.3.3, "Composing Messages to New Members").

3. Choose Invite People to invite individual users to become a member of the Space.

4. If you know the exact name of the person, enter the name in the box provided, separating multiple names with a comma (Figure 52-8).

If you are not sure of the name you can search the identity store. Enter one or more characters of the name you are looking for and click the Filter icon. Users (or groups) matching your search criteria display in the table.

The First Name, Last Name, Mail Address, and CN fields are included in the search.

Search Tips:

- Use * as a wildcard, for example *sales.

- Leave the search field blank to list all users (or groups) in the identity store.

- Enter a space between two search terms to search First Name and Last Name, for example jo sm, searches for jo in First Name and sm in Last Name.

Figure 52-9 Inviting a New Member

5. Select one or more user names from the list.

Note:

Adding the PUBLIC user to a Space does not make the Space available to the public. To find out how to make a Space public, see Section 51.14.5, "Granting Public Access to a Space".

6. Select a role for the invited members. If the role you want is not listed, create a role that meets your requirements (see Section 52.2.2, "Defining Custom Roles for a Space").

7. Click Invite.

52.3.4.3 Allowing a WebCenter Spaces User to Self-Subscribe

Self-service enables a WebCenter Spaces user to request membership without an invitation from the Space moderator. Certain types of Spaces, especially interest-based communities, are particularly suited to this form of member enrollment as the Space often reaches a wider audience.

The capabilities of self-service members depends on which roles you decide to offer on the Request Membership page. For more information, see Section 52.1.1, "Managing Self-Service Membership for a Space".

52.3.4.4 Inviting a Non-WebCenter Spaces User

If your WebCenter Spaces application allows unregistered people to become members, Space moderators can invite anyone with a valid mail address to join the Space. Prospective members receive an invitation by mail, inviting them to join the Space. Upon accepting the invitation, unregistered users are prompted to register with WebCenter Spaces before gaining access to the Space.

To invite someone outside the WebCenter Spaces community to join your Space:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Click Membership Options to edit the greeting message that is sent to non-WebCenter Spaces users (see Section 52.3.3, "Composing Messages to New Members").

3. Click Invite People, then Invite Non-WebCenter Spaces Users:

Note:

The Invite Non-WebCenter Spaces Users section displays only when self-registration is enabled through WebCenter Spaces Administration:

- Allow Self-Registration Through Invitations

- Allow Public Users to Self-Register

See also, Chapter 22, "Enabling Self-Registration".

4. Enter the Email Address(es) for one or more prospective members, separated by commas.

5. Select a Role for the prospective members. If the role you want is not listed, create a role that meets your requirements (see Section 52.2.2, "Defining Custom Roles for a Space").

6. Click Invite.

Prospective members receive an mail invitation to join the Space with the message you compose using the Invite Non-WebCenter Spaces User Message (see Section 52.3.3, "Composing Messages to New Members"). The invitation includes a secure, self-registration URL that the invited party can click to register with WebCenter Spaces and accept Space membership (see Section 49.6.2, "Joining a Space (Unregistered WebCenter Spaces User)".

52.3.5 Changing Member Role Assignments

Moderators can change a member's role at any time. Users are notified of membership changes through their Worklist.

To change a member's current role:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select one or more members, and then click the Change Role icon.

3. In the Change Role dialog box, choose a different role.

If you are not sure which role to choose, click the Roles tab to determine the range of actions that current roles allow (see Section 52.2.3, "Viewing and Editing Permissions of a Space Role"). If the existing roles do not meet your requirements, consider creating a new role (see Section 52.2.2, "Defining Custom Roles for a Space").

4. Click OK.

52.3.6 Approving Requests for Membership of a Space

If someone requests membership of your Space or an existing member requests a new role, a notification appears in your Worklist. As Space moderator, you can approve or reject these requests.

The person making the request receives notification of your decision. If you reject a request, you should explain the reasons why.

For details, see Chapter 70, "Working with the Worklist Service".

52.3.7 Communicating with Moderators and Members of a Space

You can send messages to individual members, and also to the moderator(s) or all the members of a Space. WebCenter creates a default distribution list for every Space if the Mail server is Microsoft Exchange and active directory connection details (LDAP) are provided in the mail server connection settings. As members leave or join the Space, WebCenter updates the default distribution list.

For information about setting up a custom Space mail distribution list, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List".

There are several ways to communicate with the moderator(s) and members of a Space:

- (Moderators/members only) Sending a Message from the Spaces Page

- (Moderators only) Sending a Message from the Members Page

- (Moderators/members and non-members) Contacting Space Moderator(s)

52.3.7.1 Sending a Message from the Spaces Page

(Members only) To send a message to the moderator(s) or all members from the Spaces page:

1. In the Home Space, click Spaces.

2. On the Spaces page, find the Space to which you want to send mail. If it is not shown, use Filter or Search to list it (see Section 49.3, "Viewing Available Spaces").

3. Right-click the Space's icon, and then choose Contact> Send Mail to Members or Send Mail to Moderators (Figure 52-10).

These options are available only to members.

Figure 52-10 Actions Menu

52.3.7.2 Sending a Message from the Members Page

(Moderators only) To send a message to all members, or an individual member, from the Members page:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Under Members:

- To send a message to all members of the Space, click Mail Members in the toolbar.

- To send a message to an individual member, click the member's icon, and then click the members mail address.

52.3.7.3 Contacting Space Moderator(s)

You can contact a Space moderator from the Spaces page:

1. In the Home Space, click Spaces.

2. On the Spaces page, find the Space to which you want to send mail. If it is not shown, use Filter or Search to list it (see Section 49.3, "Viewing Available Spaces").

3. Right-click the Space's icon, and then choose Contact> Send Mail to Moderators (Figure 52-10).

These options are available only to members.

Figure 52-11 Actions Menu

52.3.8 Revoking Membership

Moderators can revoke user membership for a Space at any time. Users receive notification through their Worklist when you cancel their membership.

To revoke membership:

1. In the Space administration settings, display the Members page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. Select one or more members in the table, and then click Remove Member. (Figure 52-12)

Figure 52-12 Removing a Member

3. In the Remove Member dialog box, click Remove to confirm.

52.4 Working with the Space Members Task Flow

WebCenter Spaces provides a Space Members Task Flow, which lists all the members of a particular Space. This task flow is an abbreviated version of the Members page in the Space administration settings, as described in Section 52.3.2, "Viewing Members of a Space."

To add a Space Members task flow to a page, see Section 51.16.1, "Adding a Space Task Flow to a Page."

This section includes the following subsections:

- Section 52.4.1, "What You Should Know About the Space Members Task Flow"

- Section 52.4.2, "Managing Space Membership Through the Space Members Task Flow"

- Section 52.4.3, "Contacting All Space Members"

- Section 52.4.4, "Contacting Individual Members of a Space"

- Section 52.4.5, "Sorting Members"

- Section 52.4.6, "Filtering Members"

- Section 52.4.7, "Setting Space Members Task Flow Properties"

52.4.1 What You Should Know About the Space Members Task Flow

The Space Members Task Flow enables you to get an at-a-glance view of the members of a Space. It lists the members of the Space and also shows each user's role within the Space, for example, Moderator, Participant, and Viewer. The Space Members Task Flow also provides a quick way of getting to the Space administration Members page where you can manage Space membership, if you have the appropriate permissions.

To add a Space Members task flow to a page, see Section 51.16.1, "Adding a Space Task Flow to a Page."

52.4.2 Managing Space Membership Through the Space Members Task Flow

Moderators can quickly access the tools for managing membership from the Space Members Task Flow.

To manage Space membership:

1. Log in and locate the Space Members Task Flow.

2. In the Space Members Task Flow, click the Add icon (Figure 52-13).

The Add icon only displays to moderators or members with the Space permission Manage All.

Figure 52-13 The Add Icon in the Space Members Task Flow

3. This takes you to the Members tab where you can add members as described in Section 52.3.4.1, "Adding WebCenter Spaces Users and Groups."

4. On the Members tab, you can also remove members, invite users to join the Space, and edit exiting members' roles within the Space. For more information, see Section 52.3, "Managing Members and Assigning Roles."

52.4.3 Contacting All Space Members

If you have a message to send to all members of the Space, you can do this from the Space Members Task Flow.

To contact all Space members:

1. Log in and locate the Space Members Task Flow.

2. Click Mail All Members in the Space Members Task Flow toolbar (Figure 52-14).

You may be presented with a login window. If so, then enter your user name and password for your mail application. If your preferences are set up to deliver your login credentials automatically, then you can start your message right away. For more information about login credentials and preferences, see Chapter 35, "Setting Your Personal Preferences."

Figure 52-14 Mail All Members Icon in the Space Members Task Flow

3. Compose your message and click Send.

52.4.4 Contacting Individual Members of a Space

It's easy to contact a Space member from the Space Members Task Flow:

To contact a member:

1. Log in and locate the Space Members Task Flow.

2. In the Space Members Task Flow, click the name of the member you want to contact (Figure 52-15).

Figure 52-15 Contacting a Member Using the Space Members Task Flow

By default, when you click a member's name their profile summary displays. From here, you can contact the member by mail, send them an instant message, and so on. See also, Section 30.5.1, "Viewing Profile Details."

The profile does not display if the Profile Launched on Selection parameter is disabled, for details see Section 52.4.7.2, "Space Members Task Flow Parameters".

52.4.5 Sorting Members

You can sort the list of members by name or by recent activity. Use the Sort Criteria parameter described in Section 52.4.7.2, "Space Members Task Flow Parameters".

52.4.6 Filtering Members

Use filtering to help find a particular member in the Members task flow.

To filter the list of members:

1. Log in and locate the Members task flow.

2. In the Members task flow, enter a full or partial name in the Filter field (Figure 52-16), and then click the Filter arrow icon to the right of the field.

Figure 52-16 Filtering Options in the Members Task Flow

3. The list of members refreshes, displaying only those members that match the search term.

Filtering searches against a listed member's user name. For example, if your search criteria is "c", the search results might include members named "chris", "vicki", or "weblogic".

4. Alternatively, filter the members by role by selecting a Role from the dropdown list.

5. To return the list of members to its default display, click the Clear Filter icon (Figure 52-17) and select All Members from the Role dropdown.

Figure 52-17 Clear Search Icon in the Members Task Flow

52.4.7 Setting Space Members Task Flow Properties

The Space Members Task Flow has associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 52-18).

Figure 52-18 Space Members Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Space Members task flow and describe the properties on the Parameters tab:

- Section 52.4.7.1, "What You Should Know About Space Members Task Flow Properties"

- Section 52.4.7.2, "Space Members Task Flow Parameters"

52.4.7.1 What You Should Know About Space Members Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 52.4.7.2, "Space Members Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

52.4.7.2 Space Members Task Flow Parameters

Table 52-4 describes the parameters that are unique to the Space Members Task Flow.

Table 52-4 Space Members Task Flow Parameters: Parameter Tab

Parameter

Description

Group Space Name

The name of the Space for which to display members. Default value is the current Space. Use this parameter to display member details for a different Space.

You can obtain a Space's name from its About this Space dialog.

Express values using the following formats:

- Constant—Express a constant value, such as Marketing.

- Page parameter—Enter a page parameter to fetch the value from the page on which the task flow is placed. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

- EL expression—Enter an Expression Language (EL) expression.

Number of Columns

The number of columns used to display members. The default is null which means 'no limit' and in this case member details wrap to fill the entire width of the task flow.

To fix the number of members displayed in each row, enter the number of 'columns' you require. Horizontal scroll bars display if there is not enough space to display the number of members specified here.

Express values using the following formats:

- Constant—Express a constant value, such as 2 or 5.

- Page parameter—Enter a page parameter to fetch the value from the page on which the task flow is placed. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

- EL expression—Enter an Expression Language (EL) expression.

Number of Rows

The number of rows used to display members. The default is null which means that member details wrap to fill the space available. Vertical scroll bars display if there is not enough space to display all the members.

To fix the maximum number of rows displayed, enter the number of 'rows' you require. Previous and Next buttons automatically display if more member details are available.

Express values using the following formats:

- Constant—Express a constant value, such as 2 or 5.

- Page parameter—Enter a page parameter to fetch the value from the page on which the task flow is placed. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

- EL expression—Enter an Expression Language (EL) expression.

Profile Launched on Selection

Determines whether to launch a profile popup when you select a member's name.

Deselect this option if you do not want to launch profile details.

Sort Criteria

The order in which to sort the members.

Specify LAST_ACTIVITY_TIME to sort the members in descending order of date/time at which they were last involved in any activity. If not specified, members are sorted by name, alphabetically.

53 Administering Spaces and Templates

This chapter describes how a WebCenter Spaces administrator with Spaces-Manage All or Space Templates-Manage All permissions can manage everyone's Spaces and Space templates in WebCenter Spaces.

It includes the following sections:

- Section 53.1, "Understanding Space Management and Migration"

- Section 53.2, "Performing Administrative Tasks For All Spaces"

- Section 53.3, "Performing Administrative Tasks For All Space Templates"

- Section 53.4, "Enabling and Disabling Services"

- Section 53.5, "Importing and Exporting Spaces and Space Templates"

- Section 53.6, "Troubleshooting"

For more information about exporting and importing an entire WebCenter Spaces application, see "Exporting and Importing WebCenter Spaces for Data Migration" Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Audience

This chapter is intended for WebCenter Spaces administrators with the Manage Configuration, and Spaces-Manage All or Space Templates-Manage All permissions.

53.1 Understanding Space Management and Migration

WebCenter Spaces administrators with Spaces-Manage All or Space Templates-Manage All permissions can manage any Space or Space template from WebCenter Spaces Administration (Figure 53-1). From here, you can take any Space temporarily offline and close down any Spaces deemed inactive. Administrators can rename and edit any Space, as well as delete Spaces when they are no longer required.

Space moderators do not have access to this page. While moderators may perform some of these tasks for Spaces that they own through Space administration pages, the WebCenter Spaces administrator can manage all of them.

The WebCenter Spaces Administration pages also offers import and export services that enable you to back up or move information between WebCenter applications, and stage or production environments. Import and export options are only available to users with full administrative permission, that is, have the Application-Manage All permission. See also Section 53.5, "Importing and Exporting Spaces and Space Templates".

Figure 53-1 WebCenter Administration - Spaces

Table 53-1 shows which application-level permissions are required to perform administrative tasks through these tabs. See also, Section 20.3, "Understanding Application Roles and Permissions".

Table 53-1 Permission Requirements for Space Administration and Migration

Administrative Tasks

Application Permissions Required

Spaces Tab

Application-Manage Configuration

- About Spaces

Application-Manage Configuration

- Create Spaces

Spaces-Create

- Edit Spaces

Spaces-Manage All

- Delete Spaces

Spaces-Manage All

- Import/Export Spaces

Application-Manage All

Space Templates Tab

Application-Manage Configuration

- About Space Templates

Application-Manage Configuration

- Create Space Templates

Space Templates-Create

- Edit Space Templates

Space Templates-Manage All

- Delete Space Templates

Space Templates-Manage All

- Import/Export Space Templates

Application-Manage All

53.2 Performing Administrative Tasks For All Spaces

WebCenter Spaces administrators can change the status of any Space. This section describes the steps to perform the following tasks:

- Section 53.2.1, "Viewing Space Information"

- Section 53.2.2, "Taking Any Space Offline"

- Section 53.2.3, "Bringing Any Space Back Online"

- Section 53.2.4, "Closing Any Space"

- Section 53.2.5, "Reactivating Any Space"

- Section 53.2.6, "Deleting a Space"

- Section 53.4, "Enabling and Disabling Services"

53.2.1 Viewing Space Information

WebCenter Spaces administrators can view and manage any Space through WebCenter Spaces Administration. From here, you can quickly see whether Spaces are active, online, offline, how recently the Space was accessed, as well as membership numbers.

The toolbar offers additional options for editing, changing status, and deleting Spaces, and if you select About Space you can access useful information such as the Spaces's direct URL and internal ID (Figure 53-2).

Figure 53-2 About Space Dialog

By default, Spaces are listed alphabetically. To view the information sorted by a different column, click the sort icon for the column. Sort icons appear when you hover the mouse cursor over the column header.

To display the Space administration page:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages.".

2. Click Spaces, then Spaces (Figure 53-1).

53.2.2 Taking Any Space Offline

When a Space is offline, members of the Space who do not have Spaces-Manage All permission are unable to access the Space. If members try to access the Space, they will see the Space Unavailable page. See also Section 7.3, "Working with System Pages.".

Administrators and members with the Spaces-Manage All permission can access a Space that is offline. So if, for example, an administrator who notices inappropriate content can take a Space offline, fix the content, and bring it back online later.

To permanently close down a Space that is not being used any more, see Section 53.2.4, "Closing Any Space".

To take a Space offline:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces (Figure 53-1).

3. On the Spaces page, select the Space you require by highlighting the row in the table. Ctrl-Click rows to select more than one.

4. From the Edit menu, select Offline for Maintenance (Figure 53-3).

Figure 53-3 Taking a Space Offline

5. Click OK.

53.2.3 Bringing Any Space Back Online

To bring any Space back online:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces (Figure 53-1).

3. On the Spaces page, select the required Space by highlighting the row in the table. Use Ctrl-Click to select more than one.

4. From the Edit menu, select Bring the Space Online (Figure 53-4).

Figure 53-4 Bringing a Space Online

5. Click OK.

53.2.4 Closing Any Space

A WebCenter Spaces administrator can close any Space that is no longer being used. When you close a Space, the content is archived. The Space is removed from everyone's "Spaces switcher menu" to avoid clutter but it remains on the Spaces page. The Space's content remains accessible and searchable to those who still want to reference it and Space members can continue working in the Space.

If you want to close down a Space temporarily, take the Space offline instead. See Section 53.2.2, "Taking Any Space Offline".

To close a Space:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces (Figure 53-1).

3. On the Spaces page, select the required Space by highlighting the row in the table. Use Ctrl-Click to select more than one.

4. From the Edit menu, select Close to All Users (Figure 53-5).

Figure 53-5 Closing a Space

5. Click OK.

53.2.5 Reactivating Any Space

WebCenter Spaces administrators and Space moderators may close a Space if it is no longer being used. If you want to reopen a Space, you can do so.

To reactivate a Space:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces (Figure 53-1).

3. On the Spaces page, select the required Space by highlighting the row in the table. Use Ctrl-Click to select more than one.

4. From the Edit menu, select Activate the Space (Figure 53-6).

Figure 53-6 Activating a Space

5. Click OK.

53.2.6 Deleting a Space

WebCenter Spaces administrators with the Spaces-Manage All permission can delete any Space. Once a Space is removed from WebCenter Spaces, it cannot be recovered. Spaces are permanently removed and current members will no longer see the Space in their view.

When you delete a Space:

- All pages associated with the Space are deleted.

- WebCenter Spaces data associated with the Space is deleted (links, lists, notes, tags, and Space events).

- Space roles and membership details are deleted.

- Content managed by discussions and announcements is deleted when it is stored in the default forum or category created by WebCenter Spaces. Content managed by nondefault forums or categories is not deleted (for details, see Section 51.10.3, "Modifying Discussion Forum Settings for a Space").

- The Space mail distribution list that is automatically created by WebCenter Spaces is deleted. However, distribution lists that are customized by the Space moderator are not deleted (for details, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List").

- Content managed by external services, such as content repositories, mail, and so on, is removed.

- If the Space is a parent in a Space hierarchy, child Subspaces are deleted too.

You cannot delete a Space while the moderator is editing Space settings, but there are no other restrictions.

To delete a Space that is no longer required:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces (Figure 53-1).

3. On the Spaces page, select the required Space by highlighting the row in the table. Use Ctrl-Click to select more than one.

4. Select the Edit menu, and choose Delete the Space(s) (Figure 53-7).

Figure 53-7 Deleting a Space

5. Click Delete to confirm that you want to delete the Space(s).

If the delete process fails for any reason, the Space is not removed from the administrator's Spaces tab; this sometimes happens when a back-end server cannot be contacted. If the administrator clicks Delete again from here, the Space will be removed.

53.3 Performing Administrative Tasks For All Space Templates

WebCenter Spaces administrators with the Space Templates-Manage All permission can review, publish, hide, and delete any Space template. This section describes how to perform these tasks:

- Section 53.3.1, "What You Should Know About Managing Space Templates"

- Section 53.3.2, "Viewing Space Templates"

- Section 53.3.3, "Publishing and Hiding Space Templates"

- Section 53.3.4, "Deleting a Space Template"

53.3.1 What You Should Know About Managing Space Templates

Several Space templates are provided out-of-the-box: Group Project, Community of Interest, and Basic. In addition to these, users with the Spaces-Create permission can create customized templates from Spaces and share them with other users. For more information, see Section 50.2, "Creating a Custom Space Template".

WebCenter administrators with the Space Templates-Manage All permission can manage every Space template from WebCenter Spaces Administration (Figure 53-8). You can see which Space templates are currently available and delete Space templates when they are no longer required. You can also publish templates—making them available to everyone—or restrict them to private use only.

It is important to keep the template list up to date and valid. Anyone who creates a Space will see public templates as well as their own private templates.

The Templates page provides import and export services, too. For more information, see Chapter 53, "Importing and Exporting Spaces and Space Templates".

Figure 53-8 WebCenter Administration - Templates Page

53.3.2 Viewing Space Templates

WebCenter Spaces administrators with the Space Templates-Manage All permission can view and manage any Space through WebCenter Spaces Administration. From here, you can quickly see who created each Space template (a Space moderator), and the date on which it was created. The Actions menu offers additional options for deleting Space templates, and you can publish and hide templates from here, too.

By default, Space templates are listed alphabetically. To view the information sorted by a different column, click the sort icon for the column. Sort icons appear when you hover the mouse cursor over the column header.

To see a list of every Space template in WebCenter Spaces, together with their description, creator, and other useful information:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces, then Templates (Figure 53-8).

53.3.3 Publishing and Hiding Space Templates

While WebCenter Spaces can accommodate any number of templates, a limited number of templates is sometimes more effective. The WebCenter Spaces administrator or users granted the Space Templates-Manage All permission can maintain the template list through WebCenter Spaces Administration. To view the Space Templates page, a user must additionally be granted Application-Configure permission by the WebCenter Spaces administrator.

To publish or hide a Space template:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces, then Templates (Figure 53-8).

3. Select the required Space templates by highlighting the row in the table. Ctrl-Click rows to select more than one.

4. From the Edit menu, choose:

- Make Public to share the template with everyone.

- Remove Public Access to remove the template from the Space template list. The template owner can use the template, but nobody else will see it.

5. Confirm your selection.

Note:

The seeded (out-of-the-box) templates can be made private and published by the WebCenter Spaces administrator or users granted the Space Templates - Manage All permission. If made private, they are not shown on the Templates page in a user's Home Space; they can only be seen on the WebCenter Administration-Space Templates page.

53.3.4 Deleting a Space Template

WebCenter Spaces administrators with the Space Templates-Manage permission can delete any Space template except the seeded (out-of-the-box) templates: Basic, Community of Interest, Group Project.

To delete a Space template that is no longer required:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces, then Templates (Figure 53-8).

3. Select the required Space templates by highlighting the row in the table. Ctrl-Click rows to select more than one.

4. From the Edit menu (Figure 53-9), select Delete Space Template.

Figure 53-9 Deleting a Space Template

5. Click Delete to confirm that you want to delete the selected template(s).

53.4 Enabling and Disabling Services

You can enable and disable services for individual Spaces. In most cases, the Space moderator will manage service requirements for their own Space, but WebCenter Spaces administrators can also perform this task if required to do so. For details, see Section 51.10.1, "Enabling and Disabling Services Available to a Space".

WebCenter Spaces services, such as Discussions and Mail, are configured by your Fusion Middleware Administrator through Fusion Middleware Control or using the WLST command-line tool. All services automatically become available in WebCenter Spaces when the application starts up—no additional configuration is required inside WebCenter Spaces.

There is no facility to disable services for the entire application as the Fusion Middleware Administrator takes care of this through Fusion Middleware Control. See "Getting WebCenter Spaces Up and Running" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

53.5 Importing and Exporting Spaces and Space Templates

WebCenter Spaces provides a set of export and import utilities that enable you to back up or move information between WebCenter applications, and stage or production environments. To use these utilities you must have the WebCenter Spaces Administrator role or a custom role that grants the Application-Manage All permission.

This section describes how to export and import Spaces and Space templates through WebCenter Spaces administration pages. It includes the following sections:

- Section 53.5.1, "Exporting Spaces"

- Section 53.5.2, "Importing Spaces"

- Section 53.5.3, "Exporting Space Templates"

- Section 53.5.4, "Importing Space Templates"

- Section 53.6.3, "Troubleshooting Issues with Space Import and Export"

Fusion Middleware Administrators can also export and import Spaces and Space templates using WLST commands. To find out more about these WLST commands, how to migrate the back-end data associated with Spaces, and also how to export an entire WebCenter Spaces application, see "Exporting and Importing WebCenter Spaces for Data Migration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

53.5.1 Exporting Spaces

WebCenter Spaces administrators can export Spaces and import them into other WebCenter Spaces applications. Spaces must be taken offline, even if only temporarily, to prevent data conflicts during the export process. See, Section 51.4.3, "Taking a Space Offline."

Space information is exported into a single export archive (.ear file). The EAR file contains a metadata archive (.mar file) and, optionally, a single XML file containing Space security policy information. You can save export archives to your local file system or to a remote server file system.

For more information about what is exported, read "Understanding WebCenter Spaces Export and Import" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

The export process does not include data associated with external services such as Mail, Discussions, Announcements, Instant Messaging and Presence, Events, and Documents, as all this data is stored on external servers. To learn how to move data associated with these services, refer to documentation for that product. See also, "Migrating Back-end Components for Individual Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Note:

Space artefacts must be located in the content directory to be exported. For example, icons and images, and so on, associated with a page template must be placed in the page template's content directory to be exported. For more information, see Section 10.4.2.1, "What You Should Know About a Resource's Properties".

If the Space contains Web Service data controls, all the associated Web Services must be up and accessible for the export to succeed.

Out-of-the-box templates and user customizations are never exported. For information on user customizations, see Section 29.4.2, "Performing User Customizations on Your Page View."

WebCenter Spaces administrators can export Spaces through WebCenter Spaces Administration as described here. Fusion Middleware administrators can also export Spaces using WLST commands. For details, see "Importing Spaces Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

You can also export Space templates but this is a separate process. You cannot export Spaces and Space templates into a single archive. For details, see Section 53.5.3, "Exporting Space Templates".

To export one or more Spaces through WebCenter Spaces Administration

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces.

3. Select the Space required by highlighting the row in the table.

Ctrl-click rows to select more than one.

Ensure that all the Spaces you select are offline. Spaces must be taken offline, even if only temporarily, to prevent data conflicts during the export process. Unsaved changes are not exported. See also Section 51.4.3, "Taking a Space Offline."

Note:

Other members with the Spaces-Manage All permission should not edit Spaces during the export process.

4. Click Export in the toolbar.

The Export Spaces dialog box opens (Figure 53-10).

Figure 53-10 Exporting Spaces

5. Change the Archive Name or accept the default name.

To ensure uniqueness, the default .ear filename contains a timestamp: webcenter_<timestamp>.ear

6. Click Export.

Progress information is displayed during the export process (Figure 53-11).

Figure 53-11 Exporting Spaces In Progress

7. When the export process is complete, specify a location for the export archive (.ear). Select one of:

- Download - Saves the export EAR file to your local file system.

Your Browser downloads and save the archive locally. The actual download location depends on your Browser set up.

- Save to Server - Saves the export .ear file to a server location.

When the Save to Server dialog box displays (Figure 53-12), enter a suitable path in Server Location, for example, /tmp, and then click Save. Ensure that the server directory you specify has write permissions.

Figure 53-12 Saving Space Export Archives to a Server Location

8. Click Close to dismiss the Export Spaces window.

The export archive (.ear) is saved to the specified location.

53.5.2 Importing Spaces

WebCenter Spaces administrators can import a Space archive (.ear) into another WebCenter Spaces application.

On import, all Spaces included in the archive are created or re-created on the target application. Existing Spaces are deleted then replaced, and new Spaces are created. Spaces are locked during an import operation to prevent simultaneous imports/exports of the same Space. If someone else is importing a particular Space, all subsequent attempts to import (or export) the same Space are blocked.

All Spaces need a security policy to work properly so, when you import a brand new Space for the first time, you must ensure that the Space's security policy is included in the export archive. Existing Spaces have a security policy in place so in this case, it's up to you whether to overwrite the security information on import or maintain the existing security policy.

If data migration is important, documents, and discussions can be migrated for individual Spaces. For details, see "Migrating Back-end Components for Individual Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

WebCenter Spaces administrators can import Spaces through WebCenter Spaces Administration as described here. Fusion Middleware administrators can also import Spaces using WLST commands. For details, see "Importing Spaces Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To import one or more Spaces or Subspaces:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces.

3. Click Import in the toolbar.

Tip:

To import one or more Spaces as a SubSpace of an existing Space, select the target Space before clicking the Import button.

The Import Spaces dialog box opens (Figure 53-13).

Figure 53-13 Importing Spaces

4. Specify the location of your Space archive (.ear). Select one of:

- On Local System - Enter the location in the text box. Alternatively, click Browse to locate the directory on the local file system where the .ear file is stored.

- On Server - Enter the path, including the archive filename, in the text box. For example, /tmp/MySpaceExport.ear. You can specify any shared location accessible from this WebCenter Spaces application.

5. Click Browse Archive to review the content available for import.

6. Set import options as required. For details, see Table 53-2:

Table 53-2 Space Import Options

Field

Description

Include Services Data

Select to import the following

- Data stored in the WebCenter repository for the following services: Activity Streams, Events, Feedback, Lists, Links, Message Boards, People Connections, Profiles, and Tags

- Default settings for Profiles, Message Boards, Feedback, Connections, Activity Streams

- Activity Stream Task Flow Customizations

If the Spaces selected for export contain a large amount of data, consider using the database import utilities to move the WebCenter schema data instead. For example:

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\" OWNER=srcrcuprefix_WEBCENTER DUMPFILE=/tmp/WCS.dmp STATISTICS=none

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"remap_schema=srcrcuprefix_WEBCENTER:tgtrcuprefix_WEBCENTER remap_tablespace=source_tablespace:target_tablespaceDUMPFILE=/tmp/WCS.dmp STATISTICS=none TRANSFORM=oidn

For details, refer to the Oracle Database Utilities guide.

Deselect this option if you do not want to export any data associated with lists, events, tags, links, connections, profiles, message boards, activity streams, and feedback. For example, when moving a Space from a test environment to a stage or production environment where test data is not required.

Include Customizations

Select to import Space customizations. For information about which customizations are optional on import, read "Understanding WebCenter Spaces Export and Import" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

If you deselect this option, WebCenter Spaces is imported without Space customizations.

Portlet and page customizations are always imported.

Include Security Policy

Select to import security information with the Space.

When selected, the following security related information is imported:

- Space roles (and permissions assigned to each role).

- Space members (and member role assignments).

Deselect this option if you do not want to import Space security information. This option is useful when importing Spaces between a stage and production environments, where:

- Members used during testing are not required in the production environment.

- The Space exists on the production instance and you do not want to overwrite the security information.

Note: When importing a brand new Space, always select (check) this option as you cannot import a new Space without a security policy.

7. Click Import.

If you try to import Spaces that exist in the target WebCenter Space application, you must confirm whether you want to overwrite them. To delete existing Spaces and replace them with imported versions, answer Yes. Answer No to cancel the import process.

If the import process detects a conflict between the Spaces you are trying to import and those which exist on the target, a message displays to help you resolve the issue. For example, conflict messages display if a Space on the target application has the same name but a different GUID to a Space you are trying to import. In this instance you could change the name of the source Space and create a new export archive, or rename the conflicting Space in the target application and import the same archive.

An information message displays when all Spaces import successfully.

8. Click Close to dismiss the Import Space window.

Imported Spaces are offline initially because, mostly, some additional work is required before they are ready for general use. For example, you may want to migrate data associated with back-end components. For details, refer to the "Migrating Back-end Components for Individual Spaces" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter:

Once content and membership details are finalized you may bring the Space online, see Section 51.4.4, "Bringing a Space Back Online."

53.5.3 Exporting Space Templates

WebCenter Spaces administrators can export Space templates and import them into other WebCenter Spaces applications. Out-of-the-box templates cannot be exported.

Space templates can include pages, resources, discussions, lists, service information, and security information such as custom roles and current members; no other data, such as documents, are stored with the template.

While export and import utilities are primarily used to move information between WebCenter Spaces applications, the Space template export feature is also useful as a backup service, and for sharing and exchanging templates with others.

Space template information is exported into a single export archive (.ear file). The EAR file contains a metadata archive (.MAR file) and a single XML file containing Space security policy information.

You can save export archives to your local file system or to a remote server file system.

WebCenter Spaces administrators can export Space templates through WebCenter Spaces Administration as described here. Fusion Middleware administrators can also export Space templates using WLST commands. For details, see "Exporting Space Templates Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Note:

You can also export Space information but this is a separate process. For details, see Section 53.5.1, "Exporting Spaces". You cannot export Spaces and Space templates into a single archive.

To export one or more Spaces templates using WebCenter Spaces:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces, then Templates.

3. Select the Space template required by highlighting the row in the table.

Ctrl-click rows to select more than one.

4. Click Export on the toolbar.

The Export Space Template dialog box opens (Figure 53-14).

Figure 53-14 Exporting Space Templates

5. Change the Archive Name or accept the default name.

To ensure uniqueness, the default .ear filename contains a timestamp: webcenter_<timestamp>.ear

6. Click Export.

Progress information is displayed during the export process (Figure 53-15).

Figure 53-15 Exporting Space Templates In Progress

7. When the export process is complete, specify a location for the export archive (.ear). Select one of:

- Download - Saves the export EAR file to your local file system.

Your Browser downloads and save the archive locally. The actual download location depends on your Browser set up.

- Save to Server - Saves the export .ear file to a server location. For example, /tmp. Ensure that there are write permissions on the server directory that you specify.

After clicking Save to Server, enter the Server Location and then click Save.

8. Click Close to dismiss the Export Space Templates window.

The export archive (.ear) is saved to the specified location.

53.5.4 Importing Space Templates

WebCenter Spaces administrators can import a Space template archive (.ear) into another WebCenter Spaces application.

On import, all Space templates included in the archive are re-created on the target application. If a Space template exists on the target, then it is deleted and replaced. If a Space template does not exist, then it is created.

Newly imported Space templates are not immediately available for general use. You must publish the imported templates to make them available to everyone. See Section 10.4.3, "Showing and Hiding Resources."

If you want the Documents service to be enabled in Spaces created from imported templates you must migrate the Space template's folder (on Oracle Content Server) to the target instance as well. For details, see "Importing the Back-end Folder for a Space Template" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

WebCenter Spaces administrators can import Space templates through WebCenter Spaces Administration as described here. Fusion Middleware administrators can also import Space templates using WLST commands. For details, see "Importing Space Templates Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To import one or more Space templates using WebCenter Spaces:

1. Open WebCenter Spaces Administration.

For details, see Chapter 4, "Accessing WebCenter Spaces Administration Pages."

2. Click Spaces, then Templates.

3. Click Import on the toolbar.

The Import Space Templates dialog box opens (Figure 53-16).

Figure 53-16 Importing Space Templates

4. Specify the location of your Space template archive (.ear). Select one of:

- On Local System - Enter the location in the text box. Alternatively, click Browse to locate the directory on the local file system where the .ear file is stored.

- On Server - Enter the path, including the archive filename, in the text box. For example, /tmp/MySpaceTemplateExport.ear. You can specify any shared location accessible from this WebCenter Spaces application.

5. Click Import.

If you try to import a Space template that exists in the WebCenter Spaces application, you must confirm whether you want to continue. To delete existing Space templates and replace them with imported versions, answer Yes. Answer No to cancel the import process.

An information message displays when all templates import successfully.

6. Click Close to dismiss the Import Space Templates window.

Newly imported Space templates are not immediately available for general use. You must publish the imported templates to make them available to everyone. See Section 10.4.3, "Showing and Hiding Resources."

53.6 Troubleshooting

This section includes troubleshooting information in the following sections:

- Section 53.6.1, "Troubleshooting WebCenter Spaces Workflows"

- Section 53.6.2, "Troubleshooting WebCenter Service Issues"

- Section 53.6.3, "Troubleshooting Issues with Space Import and Export"

53.6.1 Troubleshooting WebCenter Spaces Workflows

If you experience issues with WebCenter Spaces workflows, review the following sections:

- Section 53.6.1.1, "Validating the WebCenter Workflow Configuration"

- Section 53.6.1.2, "Troubleshooting Issues with WebCenter Spaces Workflows"

53.6.1.1 Validating the WebCenter Workflow Configuration

The Oracle Fusion Middleware Installation Guide for Oracle WebCenter describes how to install and configure WebCenter Spaces workflows. For details, see "Back-End Requirements for WebCenter Spaces Workflows". You can validate the workflow configuration as follows:

1. Log in to WebCenter Spaces.

2. Create a Space and then navigate to the Members tab (Space Administration).

3. Invite a new member with any role (say User2).

4. Log out, and then log in to WebCenter Spaces as User2.

5. Navigate to a Worklist task flow.

6. Open the invite notification and click the Accept button.

7. Open the Spaces page.

If the WebCenter Spaces workflows are working properly, the newly created Space appears in the Spaces page for User2. If the Space is not listed, there is some issue with the configuration.

53.6.1.2 Troubleshooting Issues with WebCenter Spaces Workflows

If WebCenter Spaces workflows are not working properly, follow these steps to help troubleshoot the issue:

1. Check that WebCenter Spaces workflows are deployed on the Oracle SOA server:

1. Log in to Fusion Middleware Control.

2. Check that WebCenterWorklistDetailApp.ear is deployed.

3. Verify that sca_CommunityWorkflows_rev1.0.jar is deployed.

See "Oracle SOA Server - Workflow Deployment" in Oracle Fusion Middleware Installation Guide for Oracle WebCenter.

2. Ensure the Web Service connection between the Oracle SOA server and WebCenter Spaces is secure:

1. Check the alias in the keystore file on the Oracle SOA server.

For example, use the following command to list the content of the keystore file on the Oracle SOA server:

keytool -list -v -keystore bpel.jks -storepass <password>

There should be an entry with:

Alias name: webcenter_spaces_ws

See "Oracle SOA and Oracle WebCenter - WS-Security Configuration" in Oracle Fusion Middleware Installation Guide for Oracle WebCenter.

2. Verify that the credential stores for both WebCenter Spaces and Oracle SOA server are configured correctly.

See "Updating the Credential Stores" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

3. Check that keystores exist at both ends of the connection, for example:

- webcenter.jks (copied to WebCenter Spaces end)

- bpel.jks (copied to Oracle SOA server end)

For example, the following commands generate webcenter.jks and bpel.jks:

keytool -genkeypair -keyalg RSA -dname "cn=webcenter,dc=us,dc=oracle,dc=com" -alias webcenter -keypass mypassword -keystore webcenter.jks -storepass mypassword -validity 360
keytool -exportcert -v -alias webcenter -keystore webcenter.jks -storepass mypassword -rfc -file webcenter.cer
keytool -importcert -alias webcenter_spaces_ws  -file webcenter.cer -keystore bpel.jks -storepass mypassword
keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=us,dc=oracle,dc=com" -alias bpel -keypass mypassword -keystore bpel.jks -storepass mypassword -validity 360
keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass mypassword -rfc -file bpel.cer
keytool -importcert -alias bpel -file bpel.cer -keystore webcenter.jks -storepass mypassword

See "Generating the Keystores" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

4. Configure role members for the BPMWorkflowAdmin application role in Oracle SOA server (soa-infra).

When associating the domain with an identity store that does not contain the user weblogic, you must assign some other valid user to the application role BPMWorkflowAdmin. Use WLST commands to do this from the SOA Oracle home, for example, to assign a user named "monty" that exists in LDAP:

cd $SOA_ORACLE_HOME/common/bin/
wlst.sh

connect('<admin username>','<admin password>', 'mysoahost.us.oracle.com:7001')
revokeAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin", principalClass="oracle.security.jps.service.policystore.ApplicationRole", principalName="SOAAdmin")
grantAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin", principalClass="weblogic.security.principal.WLSUserImpl", principalName="monty")

See "Security Commands" in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

53.6.2 Troubleshooting WebCenter Service Issues

When you create a Space, an error similar to the following may display if enabling a service exceeds the time allowed:

Space created with the following warning(s) : Issues were faced while
provisioning the service(s) - List Service. Check the Space services
settings page if these services have been provisioned.

When a Space is created, services are enabled in parallel in multiple threads. If provisioning a service exceeds the specified timeout, the thread is interrupted. The timeout may be exceeded due to time needed to copy the metadata when the latency between the midtier and the database is too high, network issues, database performance issues, and so on.

To check if the issue is due to exceeding the timeout, search the log file for a message similar to the following:

[2009-10-19T08:43:22.659+00:00] [WLS_Spaces] [WARNING] []
[oracle.webcenter.webcenterapp] [tid: [ACTIVE].ExecuteThread: '0' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: weblogic] [ecid:
0000IHfxTHMDScX_TtCCyc1Ar22000002f,0] [APP: webcenter] Concurr: The thread is
timed out in 5000 milisec. for oracle.webcenter.list:Execution timedout[[
queued :   13 ms
suspended :    0 ms
running : 5787 ms
timeout : 5000 ms
service : oracle.webcenter.community
resource : oracle.webcenter.list
source : oracle.webcenter.concurrent.RunnableTask@43c4d1
(oracle.webcenter.concurrent.RunnableTask)
submission : 3
]]

In this case, the running time of 5787 ms exceeded the timeout of 5000 ms.

If possible, the root cause of the timeout should be addressed; for example, resolve networking or database performance issues. Once this is done, the Space can be created again and the error should not be encountered. If the performance cannot be improved and the error persists, the timeout value may be increased for the service encountering the error. Refer to the chapter "Oracle WebCenter Performance Tuning" in the Oracle Fusion Middleware Performance and Tuning Guide for more information on setting concurrency management parameters in adf-config.xml.

53.6.3 Troubleshooting Issues with Space Import and Export

This section contains the following subsections:

- Section 53.6.3.1, "Space Blocked After Unsuccessful Export or Import"

- Section 53.6.3.2, "Page or Space Not Found Message After Import"

- Section 53.6.3.3, "Space Import Archive Exceeds Maximum Upload File Size"

- Section 53.6.3.4, "Maximum Number of Spaces Exceeded on Export"

- Section 53.6.3.5, "Lists Not Imported Properly"

53.6.3.1 Space Blocked After Unsuccessful Export or Import

If an error occurs during a Space export/import operation, some Space(s) may appear blocked. To unblock a Space, bring the Space back online temporarily, and then take the Space offline again to complete the export/import operation. Switching between the online and offline modes will unblock the Space.

53.6.3.2 Page or Space Not Found Message After Import

When users first login to WebCenter Spaces after an import operation they may see a "Page not found" or "Space not found" message if the page or Space they last visited no longer exists. Last accessed page information is retained during import operations which is why these messages display sometimes.

53.6.3.3 Space Import Archive Exceeds Maximum Upload File Size

Problem

There is a file size limitation uploading content to WebCenter Spaces. If your export archive exceeds the maximum upload size then the import operation through WebCenter Spaces administration will fail.

Solution

Ask your system administrator to import the Space archive using WLST. For details, see "Importing Individual Spaces Using WLST" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Alternatively, modify the maximum upload size in webcenter-config.xml. The default maximum upload size is 2 MB. See also, "Changing the Maximum File Upload Size" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

53.6.3.4 Maximum Number of Spaces Exceeded on Export

Problem

The maximum number of Spaces that you can export must be less than or equal to 80% of the connection pool size specified for the MDS Data Source. If you try to export too many Spaces you might see a ResourceLimitException error:

Weblogic.common.resourcepool.ResourceLimitException

Solution

Export fewer Spaces. Alternatively, ask your system administrator to modify the connection pool setting. For details, see "Setting JDBC Data Source" in Oracle Fusion Middleware Performance and Tuning Guide.

53.6.3.5 Lists Not Imported Properly

Problem

Lists are not importing properly due to list definition differences in the source and target systems.

Solution

Consider exporting and importing list data. This ensures that list data is consistent with the list definitions being imported.

If you choose to import without data, the list data in the target system is migrated to be consistent with the imported list definitions. If a list column data type is changed, the column values are converted from the target data type to the imported data type, if possible, otherwise the value is deleted. If a list column is removed during import, the column values are deleted.

53.6.3.6 Importing from the Subspaces Page

Problem

When you import a Space from the Space Administration-Subspaces page, the imported Space does not automatically become a Subspace of the current Space. The newly imported Space displays in the Spaces Switcher menu, Spaces Browser task flow, or the Spaces page, which display all the Spaces that are available to you.

Solution

You can import a Space as a Subspace from WebCenter Administration, by selecting the parent Space before you import the archive.

54 Working with a Space Hierarchy

This chapter provides information about working with a Space hierarchy consisting of a parent Space and its Subspaces. It contains the following sections:

- Section 54.1, "What You Should Know About Space Hierarchies"

- Section 54.2, "Understanding Inheritance in Space Hierarchies"

- Section 54.3, "Creating a Subspace"

- Section 54.4, "Viewing a Space Hierarchy"

- Section 54.5, "Creating a Custom Space Hierarchy Navigation"

- Section 54.6, "Moving Subspaces"

- Section 54.7, "Managing a Subspace"

Audience

This chapter is intended for WebCenter Spaces users assigned the Moderator role or a custom role that includes the Spaces-Manage Configuration permission who want to work with the Subspaces in a Space hierarchy.

Note:

For information about Space roles, see Section 52.2.1.1, "Understanding the Default Roles for a Space".

54.1 What You Should Know About Space Hierarchies

A Space hierarchy consists of a parent Space and one or more Subspaces. A Subspace is simply a child Space created in an existing Space. A Space hierarchy provides several benefits:

- Organization: Spaces with related content can be grouped together under a parent Space. For example, in a software development environment, Subspaces can be dedicated to primary features under the parent product Space. Or, each department can maintain a Subspace under a company's parent Space. Other hierarchical structures may be specific to your company, such as the unique requirements of a WebCenter Spaces applications that are provided to your customers.

- Navigation. The hierarchical organization provides for logical navigation and drilling down into required areas for more information. For example, users can navigate through a product hierarchy from product family to products to demos, or into different departments and functions in a company.

- Delegated administration: A Subspace can be managed by a user who does not necessarily have access to the parent Space. In this way, an administrator can maintain control of a parent Space, and assign individual owners to any number of Subspaces, who in turn can delegate administration to others.

- Inherited membership: A Subspace can optionally inherit the membership defined for the parent Space as a starting point. Subsequently, membership can be modified to suit the purposes of the Subspace.

- Security. Content may be generally accessible, where a limited number of users have administrative permissions, or security may be identical to the parent Space, or completely overridden by the administrator of the Subspace.

For information about creating a Subspace, see Section 54.3, "Creating a Subspace."

54.2 Understanding Inheritance in Space Hierarchies

A newly created Subspace inherits all services enabled for the parent Space, along with the security (members, roles, and permissions) defined in the parent Space.

54.2.1 Inheriting Security

When you create a Subspace, the initial security (members, roles, and permissions) is inherited from the parent Space.

To change the security settings of members, roles, and permissions in a Subspace, see Section 54.7.1, "Modifying Security Settings for a Subspace."

Any roles that are defined in the template that is used to create the Subspace are ignored.

54.2.2 Inheriting Services

If security inheritance is enabled (see Section 54.7.1, "Modifying Security Settings for a Subspace."), the Subspace initially inherits all services enabled for the Space template on which it is based. You can further limit services available to the Subspace, but cannot provision new services in the Subspace that are not enabled in the parent Space.If the Space template used to create the Subspace has additional services enabled that are not enabled in the parent Space, those additional services will not be available in the Subspace. Conversely, if the template has fewer services enabled than the parent Space, the Subspace will inherit only the subset of services that are enabled in the template.

For example:

- If a template used to create a Subspace has the Discussions, Lists, and Documents services enabled, and the parent Space has only Discussion and Lists enabled, then the Subspace will have only Discussion and Lists enabled, not Documents.

- If a template used to create a Subspace has the Discussions and Lists services enabled, and the parent Space has Discussions, Lists, and Documents enabled, then the Subspace will have only Discussions and Lists enabled, not Documents.

If security inheritance is not enabled, then the Subspace inherits all services that are enabled in the Space template.

54.3 Creating a Subspace

You can create one or more Subspaces (child Spaces) in any Space. From a parent Space, you can navigate to its Subspaces.

Note:

If you create a new resource (page template, skin, Resource Catalog, or navigation) for a parent Space, the custom resource is not shown for selection in the administration settings for Subspaces of the Space. To set a resource for a Subspace to the same custom resource used by its parent Space, you must use an EL expression (see Section 51.4, "Managing General Administration Settings for a Space"). To make a custom resource available for selection in all Spaces and Subspaces, it must be created at the application-level (see Section 16.2, "Creating Resource Catalogs").

To create a Subspace of the current Space:

1. Do either of the following, depending on the permissions you have been granted:

- On the Home page of the Space, click the link to create a Subspace

Tip:

The location of the Create Subspace link depends on the page template in use by the Space. For example, in a side navigation template, you may access it through a Subspaces menu, or an Actions menu.

- In the Space administration settings, display the Subspaces page, then click the Create icon.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

If you do not see these options, ask your WebCenter Spaces administrator to grant you Create Spaces permission.

The Create a Subspace dialog opens.

2. In the Setup step (Figure 54-1), specify a Subspace name and, optionally, a description and keywords for the Subspace. Enter any keywords related to the content of the Subspace to make it more easily discoverable in search results. Separate keywords with a space or comma.

Figure 54-1 Create a Subspace Dialog: Setup Step

The name that you enter here displays at the top of the Subspace and other places where Spaces are available for selection, such as the Spaces Switcher menu and the Spaces page. Subspace names can contain alphanumeric characters, underscores, spaces, multi-byte characters, and special characters such as & and #. The maximum allowable length is 200 characters. The following reserved keywords are not allowed as the full Subspace name either in upper or lowercase, or a combination of both—webcenter, pages, page, spaces, space, group, groups, Space, Spaces, webcenter space, webcenter spaces, webcenter administration, my Spaces, admin, last. These reserved words are allowable as part of a longer name (for example, Sales Group).

3. Click Next.

4. In the Access step (Figure 54-2), enter the last value of the URL for the Subspace. This value can be same as the Subspace name.

Figure 54-2 Create a Subspace Dialog: Access Step

Note:

The initial security (members, roles, and permissions) is inherited from the parent Space. To change the security settings of members, roles, and permissions in a Subspace, see Section 54.7.1, "Modifying Security Settings for a Subspace."

5. Click Next.

6. In the Content step, select a template to use as the basis for your new Subspace. Use the Filter field to search for templates by name.

See Also:

For more information, see Section 50.1, "What You Should Know About Space Templates".

Note:

A custom Space template may include seeded data, such as folders and files, discussion forums, wikis, lists, announcements, or links. When you select such a template, the new Subspace includes all the seeded data.

Any roles that are defined in the template that is used to create the Subspace are ignored.

7. Click Create.

The new Subspace opens, displaying its Home page. As the Subspace creator, you are automatically granted the Moderator role for this Subspace, and can begin to populate, customize, and manage the Subspace as required.

54.4 Viewing a Space Hierarchy

The extent to which you can see Subspaces and parent Spaces depends on your role and permissions, as described in the following sections:

- Section 54.4.1, "Viewing Subspaces of a Parent Space"

- Section 54.4.2, "Viewing Parent Spaces of a Subspace"

54.4.1 Viewing Subspaces of a Parent Space

To view the Subspaces of a Space, do any of the following, depending on the permissions you have been granted:

- On the Home page of the parent Space, click Subspaces to expose a list of the Subspaces for the Space.

Tip:

The location of the Subspaces link depends on the page template in use by the Space. For example, it may be available through a Subspaces menu in a side navigation, or through a Subspaces link at the top of the application in top tabbed navigation.

- In the Space administration settings, display the Subspaces page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

- (WebCenter Spaces administrator only) Open WebCenter Spaces Administration (see Chapter 4, "Accessing WebCenter Spaces Administration Pages"), and on the Spaces page, click a link under the Subspaces column that shows the number of Subspaces belonging directly to a parent Space. The Spaces page refreshes with a list of Subspaces for the parent Space, which may in turn show another level of Subspaces.

For more information about application-level Space administration, see Chapter 53, "Administering Spaces and Templates."

54.4.2 Viewing Parent Spaces of a Subspace

Navigating from a Subspace to a parent Space can be accomplished by adding a link to the page template for the Subspace. This is a design decision made by the page template developer, and may be exposed depending on whether or not the security of the parent Space allows direct access from the Subspace.

54.5 Creating a Custom Space Hierarchy Navigation

WebCenter application designers can build custom navigation models, which can be added to the s for a Space to allow end users to easily navigate the Space hierarchy. For more information, see Section 11.2.2.1.5, "Adding a List of Subspaces to a Navigation Model."

54.6 Moving Subspaces

With appropriate permissions, you can move Subspaces from their current parent Space. All of the metadata (such as pages, navigation, security, and so on) and data is maintained when a Subspace is moved.

To move one or more Subspaces from their current parent Space:

1. In the Space administration settings, display the Subspaces page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the Subspaces page, click in the row of the Subspace that you want to move. Ctrl-click to select multiple Subspaces.

3. From the Edit menu, choose Change Parent for Space(s).

4. In the Select New Parent dialog, choose the new parent Space, or select the No Parent Space checkbox to move the Subspace to the root Space of the Space hierarchy.

Note:

All Spaces and Subspaces in the WebCenter Spaces application are listed, which means you can move the selected Subspace lower in the Space hierarchy, under another Subspace.

5. Click OK.

6. In the confirmation prompt, click OK.

54.7 Managing a Subspace

Within a Subspace, management tasks are the same as within any top-level Space, as described in the following chapters:

- Chapter 49, "Understanding Space Basics"

- Chapter 51, "Managing a Space"

- Chapter 52, "Managing Space Members and Roles"

- Chapter 53, "Administering Spaces and Templates"

Additionally, Subspaces include the following administrative tasks that are not applicable to parent Spaces:

- Section 54.7.1, "Modifying Security Settings for a Subspace"

- Section 54.7.2, "Importing Subspaces"

54.7.1 Modifying Security Settings for a Subspace

On creation, a Subspace inherits its initial security (members, roles, and permissions) from the parent Space. If you set custom security for the Subspace, you cannot revert back to inheriting security from the parent Space.

To modify the members, roles, and permissions of a Subspace:

1. In the Subspace administration settings, display the General page.

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

2. On the General page, under Space Options, clear the Security Setting checkbox to specify that the Subspace should not inherit security settings from the parent Space (Figure 54-3).

Figure 54-3 Inheriting Security from a Parent Space

Once this checkbox has been cleared, it becomes inactive and you cannot revert back to inheriting security from the parent Space.

3. Click Apply to save.

Note that the administration settings now expose the Roles and Members pages, and the Access section displays on the General page.

54.7.2 Importing Subspaces

You can import Subspaces into your WebCenter Spaces application, as described inSection 53.5.2, "Importing Spaces." When importing Subspaces, note the following:

- When you import a parent Space, any Subspaces are also imported as child Spaces of the parent Space.

- If you begin the import process on the Subspaces page of a parent Space, the imported Space will not automatically become a child space (Subspace) and display on the Subspaces page. Instead, it is imported as a root-level Space. You can then move the Space to its appropriate position in the Space hierarchy, as described in Section 54.6, "Moving Subspaces."

Part XII

Analyzing and Monitoring Your Portal

Part XII of the User's Guide provides information about analyzing your portal's usage and performance metrics.

Part XII includes Chapter 55, "Analyzing Usage and Performance Metrics."

55 Analyzing Usage and Performance Metrics

The Analytics service offers real-time usage and activity reporting for your portal. This chapter describes how to use the pages and task flows provided through the Analytics service. It includes the following sections:

- Section 55.1, "What You Should Know About the Analytics Service"

- Section 55.2, "Working with Analytics Task Flows"

- Section 55.3, "Setting Analytics Task Flow Properties"

For Analytics task flows to work, the Analytics schema(ACTIVITIES) must be installed and configured, and a connection set up between your application and the Analytics Collector. For more details on the Analytics schema and information on managing the Analytics service backend, see “Managing the Analytics Service” in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. This chapter describes how to add Analytics task flows to application pages at runtime; to learn how to add Analytics task flows at design time, using Oracle JDeveloper, see Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Audience

This chapter is intended for WebCenter Spaces administrators with the Application-Manage Configuration permission and individual Space moderators who want to analyze activity within their Spaces.

55.1 What You Should Know About the Analytics Service

The Analytics Service allows WebCenter Spaces administrators and moderators to track and analyze WebCenter Spaces traffic and usage. The Analytics Service provides the following basic functionality:

- Usage Tracking Metrics: The Analytics Service collects and reports metrics of common WebCenter Spaces functions, including community and portlet traffic.

- Behavior Tracking: The Analytics Service can be used to analyze WebCenter Spaces metrics to determine usage patterns, such as page visit duration and usage over time.

- User Profile Correlation: The Analytics Service can be used to correlate metric information with user profile information. Usage tracking reports can be viewed and filtered by user profile data such as country, company or title.

This section contains the following topics:

- Understanding the Analytics Administration Page in WebCenter Spaces

- Understanding Analytics Task Flows in WebCenter Spaces

- Access to Analytics Task Flows in WebCenter Spaces

55.1.1 Understanding the Analytics Administration Page in WebCenter Spaces

An analytics console that displays metrics for the entire WebCenter Spaces application is available to WebCenter Spaces administrators with the Manage Configuration permission. The console consists of four pages, grouping several different reports:

- Summary Metrics - portal traffic, page views, and login metrics

- Space Metrics - Space usage and response times

- Portlet Metrics - portlet views and response times

- Service Metrics - Usage of searches, documents, wikis, blogs and discussions

Figure 55-1 Analytics Console for Administrators

Out-of-the-box, this console is available through a business role page named Analytics. It is the WebCenter Spaces administrator's responsibility to grant people permissions to see the Analytics page. This page is intended for anyone who needs to analyze access and usage statistics; this could include administrators, sales or marketing managers or directors, business analysts, and so on.

Just like other business role pages, the Analytics page is pushed to all the users to whom it is assigned, appearing in the Home Space. Once the Analytics page is available in the Home Space, users can show and hide the page through the Manage Page dialog.

See also, Section 7.1.4, "Specifying the Target Audience for a Business Role Page".

55.1.2 Understanding Analytics Task Flows in WebCenter Spaces

This section lists and describes all the Analytics task flows that are provided with WebCenter Spaces. The following task flows are available out-of-the-box:

Application Analytics:

- WebCenter Traffic

- Page Traffic

- Login Metrics

Space Analytics:

- Space Traffic

- Space Response Time

Portlet Analytics:

- Portlet Traffic

- Portlet Instance Traffic

- Portlet Response Time

- Portlet Instance Response Time

Service Analytics:

- Search Metrics

- Discussion Forum Metrics

- Document Metrics

- Wiki Metrics

- Blog Metrics

Note:

The images shown in the following sections represent one view of each report. However each report can be customized to display the data in different ways (for example, a bar chart, a pie chart, a line chart, or a table). For information on customizing reports, see Section 55.2.2, "Customizing Analytics Reports" and Section 55.2.3, "Personalizing Your Analytics Report View."

55.1.2.1 WebCenter Traffic

The WebCenter Traffic task flow (Figure 55-2) displays a summarized view for common events within the portal.

Use this task flow to track application-wide events—Space views, page views, portlet views, logins, number of searches, wiki views, blog views, discussion forum views, and document views.

Figure 55-2 Analytics Task Flow - WebCenter Traffic

55.1.2.2 Page Traffic

The Page Traffic task flow (Figure 55-3) displays the number of page hits and the number of unique users that have visited any portal page.

Use this task flow to quickly see the most visited pages (top pages) and/or the least visited pages (bottom pages). You can view page data by hits (total number of page views) and/or users (unique number of users who viewed pages). You can filter the report to show data only for specific pages (in the Display options list, select Specify, then click Select, select pages, then click OK) or pages from specific Spaces (in the Spaces query options).

Figure 55-3 Analytics Task Flow - Page Traffic

Note:

Pages belonging to the Home Space are excluded by default but there is an option to include this information if you want to do so.

55.1.2.3 Login Metrics

The Login task flow (Figure 55-4) reports the number of times users log in to WebCenter Spaces.

Use this task flow to see the total number of portal logins and/or the number of times unique users logged into the portal.

Figure 55-4 Analytics Task Flow - Login Metrics

55.1.2.4 Space Traffic

The Space Traffic task flow (Figure 55-5) displays usage information—the number of page hits, number of unique users, and the number of unique visits (multiple consecutive page views within the same Space during the same WebCenter session is treated as one visit)—for individual Spaces.

Use this task flow to quickly see the most popular Spaces (top), and the least popular Spaces (bottom). You can filter the data to only show specific Spaces or show all Spaces.

Figure 55-5 Analytics Task Flow - Space Traffic

Note:

The Home Space is not included in the data.

55.1.2.5 Space Response Time

The Space Response Time task flow (Figure 55-6) displays page performance information—average, minimum, or maximum response time—for individual Spaces over any time period you specify.

Use this task flow to quickly see the slowest Spaces (bottom), and the fastest Spaces (top). You can filter the data to only show specific Spaces or show all Spaces.

Figure 55-6 Analytics Task Flow - Space Response Time

Note:

The Home Space is not included in the data.

55.1.2.6 Portlet Traffic

The Portlet Traffic task flow (Figure 55-7) displays portlet usage information—the number of portlet hits (the number of times a portlet is displayed) and number of unique users that access a portlet.

Use this task flow to quickly see the most popular portlets (top), and the least popular portlets (bottom). You can filter the data to only show specific portlets or show all portlets. Similarly, you can filter the portlet data by Space.

Figure 55-7 Analytics Task Flow - Portlet Traffic

Note:

The Home Space is not included in the data.

55.1.2.7 Portlet Instance Traffic

The Portlet Instance Traffic task flow (Figure 55-8) displays usage information—the number of portlet hits (the number of times a portlet is displayed) and number of unique users that access a portlet—for individual portlet instances. If the same portlet displays on several different pages, each placement is considered as a portlet instance.

Use this task flow to quickly see the most popular portlet instances (top), and the least popular portlet instances (bottom). You can filter the data to only show specific portlet instances or show all portlet instances. Similarly, you can filter the portlet data by Space.

Figure 55-8 Analytics Task Flow - Portlet Instance Traffic

Note:

The Home Space is not included in the data.

55.1.2.8 Portlet Response Time

The Portlet Response Time task flow (Figure 55-9) displays performance information—average, minimum, and maximum response time—for individual portlets.

Use this task flow to quickly see the slowest portlets (bottom), the fastest portlets (top), and compare performance data. Portlet response times are important because there is often a direct link between page performance and the slowest portlets. When troubleshooting poor performance within a Space, it is important to identify the worst performing portlets. You can filter the data to only show specific portlets or show all portlets. Similarly, you can filter the portlet data by Space.

Figure 55-9 Analytics Task Flow - Portlet Response Time

55.1.2.9 Portlet Instance Response Time

The Portlet Instance Response Time task flow (Figure 55-10) displays performance information—average, minimum, and maximum response time—for individual portlet instances. If the same portlet displays on several different pages, each placement is considered as a portlet instance.

Use this task flow to quickly see the slowest portlet instances (bottom), the fastest portlet instances (top), and compare performance data. You can filter the data to only show specific portlet instances or show all portlet instances. Similarly, you can filter the portlet data by Space.

Figure 55-10 Analytics Task Flow - Portlet Instance Response Time

55.1.2.10 Search Metrics

The Search Metrics task flow (Figure 55-11) tracks searches performed within the portal.

Use this task flow to quickly see the most popular (top) and least popular (bottom) search phrases.

Figure 55-11 Analytics Task Flow - Search Metrics

55.1.2.11 Document Metrics

The Document Metrics task flow (Figure 55-12) tracks how often a document is accessed.

Use this task flow to quickly see the most popular (top) and least popular (bottom) documents. You can filter the data to only show specific Spaces or show all Spaces.

Note:

Documents in the Home Space are included in this report.

Note:

If you have two different documents with the same name, they are treated as two separate documents. The metrics include the parent folder for context.

Figure 55-12 Analytics Task Flow - Document Metrics

55.1.2.12 Wiki Metrics

The Wiki Metrics task flow (Figure 55-15) tracks how often wikis are accessed within the portal.

Use this task flow to quickly see the most popular (top) and least popular (bottom) wikis. You can filter the data to only show specific Spaces or show all Spaces.

Figure 55-13 Analytics Task Flow - Wiki Metrics

55.1.2.13 Blog Metrics

The Blog Metrics task flow (Figure 55-14) tracks how often blogs are accessed within the portal.

Use this task flow to quickly see the most popular (top) and least popular (bottom) blogs. You can filter the data to only show specific Spaces or show all Spaces.

Figure 55-14 Analytics Task Flow - Blogs Metrics

55.1.2.14 Discussion Forum Metrics

The Discussion Forum Metrics task flow (Figure 55-15) tracks discussion forums within the portal.

Use this task flow to quickly see the most popular (top) and least popular (bottom) discussions. You can filter the data to only show specific Spaces or show all Spaces.

Figure 55-15 Analytics Task Flow - Discussion Metrics

55.1.3 Access to Analytics Task Flows in WebCenter Spaces

In WebCenter Spaces, Resource Catalogs only display analytics task flows to users with appropriate permissions:

- Administrators - Users with the Administrator role have access to all the analytics task flows

- Moderators - Within a Space, members with the Moderator role can only access task flows specific to that Space

After a task flow is added to a page, anyone with access to the page can see the task flow.

55.2 Working with Analytics Task Flows

This section contains the following topics:

- Adding Analytics Task Flows to a Page

- Customizing Analytics Reports

- Personalizing Your Analytics Report View

55.2.1 Adding Analytics Task Flows to a Page

The process of adding an Analytics task flow to a page is the same as for any other task flow (for more information, see Section 17.5, "Adding Resource Catalog Components to Pages"). The process varies only in where you can find these task flows in the Resource Catalog. All the Analytics task flows are under the Analytics folder.

Figure 55-16 Analytics Folder in Resource Catalog

Note:

When you add an Analytics task flow to a Space, it displays information for that Space, not for all Spaces.

55.2.2 Customizing Analytics Reports

If you want to set defaults for Analytics reports, you can do so by editing the report settings in page Edit mode. Any changes you make while in Edit mode will become the default report settings for all users in page View mode. For example, you can edit the Analytics page, changing the following settings on the Summary Metrics page in the Traffic report: set the report type to pie chart, set the time frame to this week, and remove Discussion Forums from the display. When users visit the Analytics page, those settings will be applied by default. Users can then edit the report as necessary for their needs. This can be useful if there are particular settings you know are commonly used by your users, or to customize a particular instance of an Analytics task flow on a group-specific page.

You can also configure the report settings to determine the controls available to users in View mode. In page Edit mode, click the Configure report preferences icon to display the Report Settings popup. In this popup, you can specify whether to show or hide the following report settings:

- Chart

- Chart Style list allows you to select a color scheme for reports

- Chart Type Options allows you to show or hide the chart types (bar, pie, line, table) at the top of the report

- Data Selection

- Report Summary allows you to show or hide the Report Summary section to the left of the report

- Metrics Selector allows you to show or hide the list of metrics (Hits, Unique Users, and such)

- Display Options (not available with Logins) allows you to show or hide the list of display options (Spaces, Pages, Portlets, and such)

- Selection Button (not available with Traffic, Logins, Space Traffic, Space Response Time, Search Metrics, Document Metrics, Wiki Metrics, Blog Metrics, Discussion Forum Metrics) allows you to show or hide the Specify option in the Display list and the Select button at the top of the report

- Additional Options (not available with Traffic, Logins, Space Traffic, Space Response Time, Portlet Traffic, Portlet Instances Traffic, Portlet Response Time, Portlet Instances Response Time, Search Metrics, Document Metrics, Wiki Metrics, Blog Metrics, Discussion Forum Metrics) allows you to show or hide the Additional Options section to the left of the report

- Filtering

- Time Frame Filters allows you to show or hide the Time Frame section to the left of the report

- User Property Filters allows you to show or hide the User Property section to the left of the report

- Space Filter (not available with Traffic, Logins, Search Metrics) allows you to show or hide the Spaces section to the left of the report

- Grouping

- Group By Options allows you to show or hide the Grouping Options section to the left of the report

55.2.3 Personalizing Your Analytics Report View

Analytics task flows include display options at the top of the report and query options to the left of the report. These options enable you to personalize the report for your needs by changing the metrics included in the report and the way the report is presented. Most options are the same for all Analytics task flows.

55.2.3.1 Report Display Options

The report display options at the top of the report enable you to select the type of report, select the type of metrics to include, and, for some task flows, control the top/bottom range to display.

Report Types

You can display your report as a bar chart, pie chart, line chart, or table depending on the display and query options you select. To choose your report type, click the associated icon.

Table 55-1 lists the report types available for different display and query options. It includes the following columns:

- Selected Metrics specifies what has been selected in the list of metrics, a single metric or multiple metrics. Note: Search Metrics and Document Metrics task flows show only those single metrics; there is no list to select metrics.

- Group By Options specifies what has been selected in the Grouping Options section to the left of the report, No Selection or one of the available selections.

- Bar, Pie, Line, and Table specify whether you can view that type of report with the specified selections.

Table 55-1 Display Options for the Analytics Task Flows

Selected Metrics

Group By Option

Bar

Pie

Line

Table

Single metric

Login Traffic task flow

No selection

N

N

N

Y

Single metric

All other task flows

No selection

Y

Y

N

Y

Single metric

Time interval, user property, or Both*

Y

N

Y

Y

Multiple metrics

WebCenter Traffic and

Login Traffic task flows

No selection

Y

Y

N

Y

Multiple metrics

All other task flows

No selection

Y

N

Y

Y

Multiple metrics

WebCenter Traffic and Login Traffic task flows

Time interval or user property

Y

N

Y

Y

Multiple metrics

All other task flows

Time interval or user property

N

N

N

Y

Multiple metrics

Login Traffic task flow

Both*

N

N

N

Y

* The grouping option Both is available only for the Login Traffic task flow.

Metrics

You can select which type of metrics to include in your report. Your metrics options differ depending on the task flow you are using:

- WebCenter Traffic: Spaces, Pages, Portlets, Logins, Searches, Wikis, Blogs, Discussion Forums, Documents

- Page Traffic: Hits, Unique Users

- Login Metrics: Logins, Unique Users

- Space Traffic: Hits, Unique Users, Visits

- Space Response Time: Average Response Time, Minimum Response Time, Maximum Response Time

- Portlet Traffic: Hits, Unique Users

- Portlet Instance Traffic: Hits, Unique Users

- Portlet Response Time: Average Response Time, Minimum Response Time, Maximum Response Time

- Portlet Instance Response Time: Average Response Time, Minimum Response Time, Maximum Response Time

- Search Metrics: This task flow shows only search metrics, so it does not include an option to select metrics.

- Document Metrics: This task flow shows only document metrics, so it does not include an option to select metrics.

- Wiki Metrics: Views, Unique Users

- Blog Metrics: Views, Unique Users

- Discussion Forum Metrics: Views, Unique Users

To select which metrics to include in your report, select the metrics from the list above the report.

Figure 55-17 Analytics Task Flow - Metrics Selection

Top, Bottom, or Custom Ranges

With some task flows you can specify whether you want to see the top, bottom, all, or a custom ranges of metrics in your report. Use these options to see the most and least popular items in your portal.

To display the top or bottom ranges of metrics in your report, in the lists above the report, select Top or Bottom, and then select a number to define the range.

To display a custom range, in the list above the report, select Specify, then click Select.

The top and bottom options are available for Pages, Portlet Traffic, Portlet Instances Traffic, Response Time, Portlet Response Time, Portlet Instances Response Time.

The custom range option is available for Pages, Traffic, Response Time, Portlet Traffic, Portlet Instances Traffic, Response Time, Portlet Response Time, Portlet Instances Response Time, Search Metrics, Document Metrics, Wiki Metrics, Blog Metrics, Discussion Forum Metrics.

55.2.3.2 Query Options

Analytics task flows include the following query options to the left of the report:

- Report Summary

Displays a summary of the selected display and query options shown in the report.

- Time Frame

Enables you to specify the date range for the metrics displayed in the report. You can select from the following options: Yesterday, Today, This Week, Last Week, This Month, Last Month, Last Three Months, Last Six Months, This Year, Last Year, or you can specify your own date range.

- User Property

Enables you to filter your report by user property. After selecting a property from the list, you can specify a value that the property must contain or must not contain, and only metrics that apply to the filtered property display in the report.

- Property: Select a property on which to filter the report. You can select City, Company, Country, Department, Display Name, Employee ID, IM User, Manager, Phone, State or Province, Street, Title, or ZIP code

- Operator: Select how you want to filter the property. You can select Contains or Does Not Contain.

- Value: Type a value on which to filter the property.

Note:

To search using a wildcard (for example, % or ?), you must prefix the wildcard with a forward slash (\). For example, to search for give or giving, type giv\% in the Value box.

- Additional Options

Enables you Include Home Space Pages. These options are available with the Pages task flow.

- Spaces

When Analytics task flows display in the Home Space or on a business role page, you can choose which Spaces to include in your report. When Analytics task flows are used within a particular Space, only metrics only for that Space display; the Spaces option is unavailable (grayed out).

To specify the Spaces to include in your report, click the Space Filter icon to display the Specify Spaces popup. Select the Spaces you want to include in your report, using CTRL+click and SHIFT+click to select multiple Spaces.

This option is not available with the Traffic, Logins, or Search Metrics task flows.

- Grouping Options

Enables you to select an option by which to group the metrics in your report. You can group by a time interval (Hour, Day, Week, Month, or Year), a user property, or, with the Logins task flow, both.

Note:

This setting affects the available display options for the report (see Table 55-1.

55.3 Setting Analytics Task Flow Properties

The Analytics service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 55-18).

Figure 55-18 Analytics Task Flow - Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Events service task flows and describe the properties on the Parameters tab:

- Section 55.3.1, "What You Should Know About the Analytics Service Task Flow Properties"

- Section 55.3.2, "Analytics Service Task Flow Parameters"

55.3.1 What You Should Know About the Analytics Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 55.3.2, "Analytics Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor.

55.3.2 Analytics Service Task Flow Parameters

Table 55-2 describes the parameters that are unique to the Analytics service task flows.

Table 55-2 Analytics Task Flow Parameters

Parameter

Description

Analytics Report Title

Specifies the display title that appears above the analytics data.

Note:

- Use the Analytics Report Title rather than the Text property on the Display Options page. Changing the Text value has no effect on Analytics task flows.

- You cannot change the report titles in the Analytics console.

Analytics Resource Id

Specifies the MDS document used to store user customizations/application customizations for the task flow instance in MDS.

Warning: Do not edit this value.

Application Name*

Specifies the WebCenter application for which you want to display analytics data. For WebCenter Spaces, this is always webcenter.

The analytics database can be used to store event data from multiple applications so this parameter is required to identify which application data to display.

If omitted, the task flow displays analytics data for all applications.

Max Data Points Per Series

Indicates the maximum number of data points to be displayed in a bar or line chart. The default value is 25. Valid values are between 1 and 1000.

Note: Increasing the number of data points might increase the time it takes to render the report.

Part XIII

Searching WebCenter and Other Sources

Part XIII of the User's Guide provides information about searching both WebCenter Spaces and sources outside of WebCenter Spaces. It includes information about creating your own search terms using the Tags service.

Part XIII includes the following chapters:

- Chapter 56, "Working with the Search Service"

- Chapter 57, "Working with the Tags Service"

56 Working with the Search Service

This chapter describes how to use the features provided through the Search service.

This chapter includes the following sections:

- Section 56.1, "What You Should Know About the Search Service"

- Section 56.2, "Setting Preferences for WebCenter Spaces Search Results"

- Section 56.3, "Working with Search Service Task Flows"

- Section 56.4, "Setting Search Service Task Flow Properties"

Audience

This chapter is intended for users who want to use and manage search, as well as WebCenter Spaces administrators with the Application-Manage Configuration permission and individual Space moderators who want to configure search within their Spaces. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

56.1 What You Should Know About the Search Service

The Search service enables the discovery of information and people through an intuitive user interface, returning only the results you are authorized to view. With all relevant information easily navigable, you do not have to switch between applications performing multiple searches.

Use the Search service to run, refine, and save custom searches. By default, WebCenter Search looks for your search terms in every searchable service enabled in the application. You can configure the services to which a search has access with your personal preferences (see Section 56.2.1, "Selecting the Services to Search").

Information in WebCenter services is searched by name and content. When a search is run for a term that has been added as a tag to a document, the document is returned in the results, and the related tags appear in the Tag refiner section. For more information about tagging, see Chapter 57, "Working with the Tags Service."

In all cases, searches return only the results you are authorized to view. For example, if you are not a member of the Finance Space, then any search results from that Space do not display.

In addition to WebCenter Search, the Documents service provides its own search engine for file searches. This saves time and increases the relevancy of results by narrowing the scope of a search to files. The Documents service searches within a specific Space's document library. For more information, see Section 41.29, "Running Document Searches."

56.1.1 Using the Oracle Secure Enterprise Search Adapter

With WebCenter Spaces applications, internal WebCenter live search adapters are set as the default search platform; however, large-scale WebCenter implementations should be configured to use Oracle SES for best performance. Oracle SES provides unified ranking results for the following resources:

- Documents, including wikis and blogs

- Announcements and Discussions

- Spaces, lists, pages, and people resources in WebCenter Spaces

Note:

Oracle WebCenter Spaces includes the additional Oracle SES crawler that indexes Spaces, lists, pages, and people resources in WebCenter Spaces. Oracle SES crawling of these resources supported in WebCenter Portal applications.

For example, when you run a search for a user name, most likely, you are looking for that persons's contact information (that is, the exact user name in the People Connections service), not necessarily documents that the user wrote. The unified ranking in Oracle SES enables you to see the most relevant results, across all different types of searches, without configuring Search Preferences.

Additionally, with Oracle SES as the WebCenter search engine, you can use the wildcard character [*] in the middle or end of a term for wildcard matching. For example, when you search for keywords like wiki or page, Oracle SES does not return the wiki page MyWikiPage in search results. However, My* or My*Page does return MyWikiPage.

Note:

The default WebCenter search adapters do not support any wildcard searching.

You can set your personal search preferences to specify which services to search and the order of services in your search results. For example, you may find that search results from the Documents service prove more useful that search results from other services. You can disable any service from which you do not want to see search results. For more information about setting search preferences, see Section 56.2, "Setting Preferences for WebCenter Spaces Search Results."

Oracle Portal applications automatically set Oracle SES as the default search crawler, but you can manually override search with Oracle SES and have WebCenter Portal applications search using the original WebCenter search adapters.

See Also:

"Configuring Search with WebCenter Search Adapters" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter

56.2 Setting Preferences for WebCenter Spaces Search Results

When you search content, you may find that the results from one service are more relevant to you than results from other services. You may find it useful to be able to exclude some services from a search and specify the order in which the results from selected services are listed.

Use WebCenter Spaces search preferences to choose the services to search and specify the display order for search results. This section contains the following subsections:

- Section 56.2.1, "Selecting the Services to Search"

- Section 56.2.2, "Specifying a Display Order for Search Results"

See Also:

Section 41.29, "Running Document Searches"

56.2.1 Selecting the Services to Search

Your WebCenter administrator makes services available to the application. By default, all enabled services are selected to be searched. You can disable any service from which you do not want to see search results. For example, if you frequently search for a particular type of technology, including your personal contacts in the search is probably not useful.

To specify which services should be searched:

1. Click the Preferences link at the top of the application.

2. Click Search to open the Search Preferences pane (Figure 56-1).

Figure 56-1 The Search Preferences Pane

3. To add a service to a search, choose one or more services on the Available Services list and click the Move selected items to list icon to move them to the Selected Services list.

To remove services from search, choose one or more services on the Selected Services list and click the Remove selected items from list icon to move them to the Available Services list.

Note:

When Oracle SES is configured in the application, the Oracle SES service cannot be deselected, and services that do not support Oracle SES search (such as Notes) are not listed.

4. Click OK to save your changes and exit the Preferences dialog.

Alternatively, click Apply to save your changes without exiting.

The services you add to the Selected Services list are included in future WebCenter Spaces searches. The services on the Available Services list are not searched.

56.2.2 Specifying a Display Order for Search Results

Of all the services you include in a WebCenter Spaces search, you may find that some services provide more relevant results than others. For example, you may find that search results from the Documents service prove more useful that search results from other services. WebCenter Spaces Preferences provide controls for specifying the order in which services are listed in search results.

To specify a display order for search results:

1. Click the Preferences link at the top of the application.

2. Click Search to open the Search Preferences panel (Figure 56-2).

Figure 56-2 Search Preferences

3. Choose one or more services on the Selected Services list and click the Move icons to the right of the list to move your selections higher or lower on the list.

The order you specify here determines the order each service is listed in search results.

4. Click OK to save your changes and exit the Preferences dialog.

Alternatively, click Apply to save your changes without exiting.

56.3 Working with Search Service Task Flows

WebCenter provides search services for the application and beyond.

This section includes the following subsections:

- Section 56.3.1, "Adding Search Service Task Flows"

- Section 56.3.2, "Searching in a WebCenter Application"

- Section 56.3.3, "Refining the Display of Search Results"

- Section 56.3.4, "Saving Searches"

56.3.1 Adding Search Service Task Flows

Table 56-1 lists the Search service task flows.

Table 56-1 Search Service Task Flows

Task Flow

Definition

Search

This task flow provides a rich search experience with features for refining and saving search results.

All Saved Searches

This task flow enables you to create a simple launch pad for running saved searches within the application.

Search Preferences

This task flow enables users to select which WebCenter services to search.

Search Toolbar

This task flow enables users to enter simple search criteria and run the search from the application. Search results are rendered as links.

To add a Search service task flow to a page in a WebCenter Spaces application:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that provides access to the search task flows.

Tip:

The presence or location of this section depends on how the Resource Catalog is configured. In the default Resource Catalog, next to Tagging and Searching, click Open.

Figure 56-3 Opening the Search Section in the Resource Catalog

4. Click Add next to the task flow that you want to add to your page.

Note:

The Search, Search Preferences, and Search Toolbar task flows are not available in the default Oracle Composer Resource Catalog, so you will only see entries for these task flows if they have been added to the Resource Catalog that has been made available to the page.

For more information, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Task Flows, then scroll to Search for a list of all available content task flows.

56.3.2 Searching in a WebCenter Application

This section describes how to run a global search and how to run a search within a specific Space.

This section includes the following subsections:

- Section 56.3.2.1, "Performing a Global Search"

- Section 56.3.2.2, "Performing a Space Search"

56.3.2.1 Performing a Global Search

Global search provides an application-wide search. By default, you can perform a global search from the search field at the top-right of the application.

To perform a global search:

1. Locate the global search field and enter a search term.

For example, the search field at the top right of the WebCenter application is a global search field (Figure 56-4).

Figure 56-4 Global Search Field in WebCenter Spaces

2. Press Enter or click the Search icon next to the global search field (Figure 56-5).

Figure 56-5 Search Icon

Results display in the search Results page (Figure 56-6).

Figure 56-6 Global Search Results

3. Click a link to open a result.

4. Optionally, refine the search.

With the default WebCenter search adapters, you can refine by author or last modified date using the Refine Search section. With the Oracle SES adapter, you can refine by author, content type, last modified date, Space, and tag. For more information, see Section 56.3.3, "Refining the Display of Search Results." You can also save the search so that you can access the results later. For more information, see Section 56.3.4, "Saving Searches."

You can configure how search results are displayed. Specifically, you can control which services are included in the search and the order in which those services are listed in the results. Set this in the Search Preferences panel of the Preferences dialog (for information see Section 56.2, "Setting Preferences for WebCenter Spaces Search Results").

An estimated number of search results appears if your application is configured with the Oracle SES adapter (Figure 56-7).

Figure 56-7 Estimated Number of Search Results

If your application uses the WebCenter search adapters, then an estimated number of results is not included. Click the Previous and Next links to view any additional results. These links may appear even if no additional results are available.

56.3.2.2 Performing a Space Search

WebCenter search performs global (that is, application-wide) searches.

For members of a Space to perform searches limited to that Space, the Space administrator must add the Search task flow. In most cases, this involves creating a Resource Catalog, adding the Search task flow to the catalog, and then assigning this catalog to the Space. (The Search task flow is not available in the default Resource Catalog.) For example:

1. Go to Administration - Resources - Resource Catalogs, and either click to create a new resource catalog or select an existing resource catalog and select Edit - Copy.

2. Enter a name for this new Resource Catalog (Figure 56-8).

Figure 56-8 Editing a Default Resource Catalog to Include Search

3. Click Edit - Edit, Add, then Add from Library.

4. Select Task Flows, then scroll down to select the Search task flow, and click Add (Figure 56-9).

Figure 56-9 Add Resource Catalog Item Dialog

5. You see the Search task flow added to the Resource Catalog. Optionally, you can drag and drop the task flow into a folder. With the Search task flow selected, click Edit (pencil) to add a description for this new catalog item (Figure 56-10).

Figure 56-10 New Resource Catalog with the Search Task Flow Added

6. On the Target tab, add a description (Figure 56-11).

Figure 56-11 Edit Resource Catalog Item - Target Tab

7. On the Options tab, for New Attribute Name select Icon URI, and for New Attribute Value, enter /adf/webcenter/search_qualifier.png (Figure 56-12).

Figure 56-12 Edit Resource Catalog Item - Options Tab

8. Click Add, then OK and OK again to close the Edit. You see the new icon and description appear in the Resource Catalog (Figure 56-13).

Figure 56-13 Search Task Flow Icon and Description

9. Back on the Administration - Resources - Resource Catalogs page, select this new Resource Catalog, and click Edit - Show to make it available.

10. Create a new Space, and display the General page of the Space administration settings.

11. For Resource Catalog for Pages, select the new Resource Catalog, and click Apply (Figure 56-14).

Figure 56-14 Space Administration Settings for New Resource Catalog

12. In the new Space, create a new page (Figure 56-15).

Figure 56-15 Create New Page Dialog

13. On the new page, click Add Content, navigate to the Search task flow, and click Add to add the Search task flow to the page. Click Close.

14. Click Save, then Close.

15. Run a search term in the Search field (Figure 56-16).

Figure 56-16 Search Task Flow in a Space

You can configure how the search results are displayed. Specifically, you can control which services are included in the search and the order in which those services are listed in the results. For information about setting display options for Space search results, see Section 56.2, "Setting Preferences for WebCenter Spaces Search Results."

56.3.3 Refining the Display of Search Results

Users can narrow down searches using refiners to produce a smaller set of results. For example, to see all documents that one particular person posted, rather than scrolling through pages of results to find them, you can just click that name or profile picture, and the results are filtered to show only results from that person.

With the default WebCenter search adapters, you can refine your search by specifying a time range within which the result was last modified and by limiting results to those associated with a particular user.

Note:

Results from people, tags, tagged items, and favorites, which do not supply refiners to the Search service, do not appear in refined searches.

With the Oracle SES adapter, you additionally can refine the search by content type, Space, and tag.

To refine the display of search results:

1. Perform a global search as described in Section 56.3.2.1, "Performing a Global Search."

Or perform a Space search as described in Section 56.3.2.2, "Performing a Space Search."

The search results display on the Search results page.

2. In the Refine Search section, choose criteria to refine the search. For example, choose a time-range limitation from the Last Modified box (Figure 56-17).

Figure 56-17 The Last Modified Refiner on the Search Results Page

For example, click Past 7 Days to view all results that originated in the past week. Click March 2010 to view all results that originated in March 2010.

The number next to each time range indicates the search's best guess at how many search results fall within the specified range.

Some date selections, such as years or months, provide additional refinement options when you choose them. For example, when you refine a search by all results occurring within 2007, your refined results display and additional refinements appear in the Last Modified box.

Alternatively, click Custom Date Range and enter a date in the field provided (optionally, with an end date also), or click the Select Date icon and choose a date from a date picker (Figure 56-18).

Figure 56-18 Date Picker for Custom Date Range

3. To refine the display of search results by author (that is, by the user name of the person who created, uploaded, or originated the result), choose someone from the Author box (Figure 56-19).

Figure 56-19 The Author Box on the Search Results Page

For example, click vicki to view all results contributed by the user vicki.

The number next to each user name indicates the search's best guess at how many search results are associated with the specified user.

Click More... or Less... to see more or less authors in the Author box.

4. When a refinement is selected, it appears above the Results list with a Delete icon, enabling you to remove the refinements you have applied to search results (Figure 56-20).

Figure 56-20 Delete Icon to Remove Refinement of Search Results

Click the Delete icon to remove that particular search results refinement and broaden the list of displayed results.

56.3.4 Saving Searches

After you have performed a search, you can save it so that you can run it again later without having to reenter the search terms. You can also share the saved search with Spaces.

Note:

You can save searches only if you are logged in to the application.

This section includes the following subsections:

- Section 56.3.4.1, "Saving a Search"

- Section 56.3.4.2, "Running a Saved Search"

- Section 56.3.4.3, "Sharing a Saved Search in WebCenter Spaces"

- Section 56.3.4.4, "Customizing a Saved Search"

- Section 56.3.4.5, "Deleting a Saved Search"

56.3.4.1 Saving a Search

Saved searches are useful for the searches you run frequently. They assist in keeping you current as new information is added to the search pool.

To save a search:

1. Perform a global search as described in Section 56.3.2.1, "Performing a Global Search."

Or perform a Space search as described in Section 56.3.2.2, "Performing a Space Search."

The search results display on the Search results page.

2. Click Save below the search field (Figure 56-21).

Figure 56-21 Save and Manage Buttons

The Create Saved Search dialog opens (Figure 56-22).

Figure 56-22 The Create Saved Search Dialog

3. In the Name field, enter a meaningful name for the search.

The value you enter in the Name field is the value that appears on the dropdown list of saved searches.

The search that was in the Search field is saved, no matter what name you give it. For example, if the search term was admin, but you enter jcr in the Name field. The saved search searches for the term admin and not jcr.

4. Optionally, in the Description field, enter a description of the search.

5. Select the Share in space checkbox to enable other members of the Space to see this search on the Space's dropdown list of saved searches. Only one Space can be specified.

6. Click the Spaces icon to select the spaces in which to share the saved search.

7. Click OK to save the search.

56.3.4.2 Running a Saved Search

The All Saved Searches task flow provides a quick and easy way to see all saved searches. The saved searches to which you have access depends on the location.

- Go to your Home Space. After you have saved searches, there is a dropdown list for Saved Searches in your Home Space.

- Go to any page containing the All Saved Searches task flow (Figure 56-23).

In a Space, the All Saved Searches task flow lists all your saved searches for the Space and all shared saved searches for the Space (made both by yourself and other users). It does not list your global saved searches or saved searches made against other Spaces. In a Home Space, the All Saved Searches task flow lists all your global saved searches.

Figure 56-23 The All Saved Searches Task Flow

- Go to any page where the saved search was placed.

The Saved Search task flow shows the results of the particular search.

To run a saved search:

1. Log in and find the saved search:

- Locate the page containing the All Saved Searches task flow.

- Locate the page containing the saved search. In this case, the search results are immediately visible.

2. From the All Saved Searches task flow or the Saved Search panel in the Home space, click the link for the saved search you want to run.

Tip:

The description is rendered as a tooltip when you move your cursor over the name of the saved search.

3. View the results on the dynamically-generated Search Results page.

56.3.4.3 Sharing a Saved Search in WebCenter Spaces

In WebCenter Spaces, you can share a saved Space search if you think the results of a search might be useful for other Space members.

To share a saved search:

1. Go to the Space where the search was performed and saved.

2. Click Manage (Figure 56-28).

Figure 56-24 Save and Manage Buttons

The Manage Saved Searches window opens (Figure 56-29).

Figure 56-25 The Manage Saved Searches Window

In the Saved searches dropdown list, select the saved search you want to share.

3. Select the Share in space checkbox, and click the Spaces icon to select the Spaces in which you want to share this saved search.

The saved search is now available for other members of the Space to run. The search is listed in the Saved Searches list for all Space members and in the All Saved Searches task flow, if one exists.

4. Click Apply, then OK.

56.3.4.4 Customizing a Saved Search

After you have added the results of a saved search to a page, you can customize it.

Click the Personalize icon (Figure 56-26) to make changes to the saved search.

Figure 56-26 Personalize Icon

In the Customizing Saved Searches dialog, you can to change the search terms, add refiners, or choose the services to search (Figure 56-27).

Figure 56-27 Customizing Saved Searches Dialog

56.3.4.5 Deleting a Saved Search

To delete a saved search:

1. Click Manage (Figure 56-28).

Figure 56-28 Save and Manage Buttons

The Manage Saved Searches window opens (Figure 56-29).

Figure 56-29 The Manage Saved Searches Window

2. In the Saved searches dropdown list, select the saved search you want to delete.

3. Click the Delete button, then Apply and OK.

56.4 Setting Search Service Task Flow Properties

The Search service task flows have associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 56-30).

Figure 56-30 Saved Search Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Search service task flows and describe the properties on the Parameters tab.

- Section 56.4.1, "What You Should Know About the Search Service Task Flow Properties"

- Section 56.4.2, "Search Service Task Flow Parameters"

56.4.1 What You Should Know About the Search Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 56.4.2, "Search Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor.

56.4.2 Search Service Task Flow Parameters

Table 56-2 describes the parameters that are unique to Search service task flows.

Table 56-2 Search Service Task Flow Parameters

Parameter

Description

Task Flow

Services to be Excluded

A list of IDs of services or executors to omit when displaying search results.

This parameter is intended for internal use only. Do not change this value.

Search

Show or hide input box

Show or hide the input box. Set to true (default) to show the input box, or set to false to hide it.

Search

Resource ID

Either search keywords or the saved search GUID.

This parameter is intended for internal use only. Do not change this value unless you want coded search main views. If you do change this value, then you must also specify Resource Type.

Search

Resource Scope

Unique ID to limit the search scope. To limit the search to a particular Space, set this to the GUID of the Space; for example, #{spaceContext.currentSpaceGUID}.

Search

Resource Type

A marker specifying whether the Resource ID parameter means search keywords or saved search GUID.

This value is set automatically and is for internal use only. Do not change it unless you want coded search main views.

Search

Search Scope ID

Unique ID to limit the search scope. To limit the search to a particular Space, set this to the GUID of the Space; for example, #{spaceContext.currentSpaceGUID}.

Search Toolbar

Search Box Size

Value to limit the size of the search box. The default value is 42. Enter a lower number (for example, 30) to shorten the length of the search box. This also changes the size of the search box in the Search task flow.

Search Toolbar

Note:

The All Saved Searches and the Search Preferences task flows do not have any unique properties.

57 Working with the Tags Service

This chapter describes how to use the features provided through the Tags service. Tagging enables users to apply their own meaningful terms to WebCenter application items, making those items more easily discoverable in search results and the Tag Center.

This chapter includes the following sections:

- Section 57.1, "What You Should Know About the Tags Service"

- Section 57.2, "Working with Tags Service Features and Task Flows"

- Section 57.3, "Setting Tags Service Task Flow Properties"

Audience

This chapter is intended for users who want to use and manage tags. Such users must be granted, minimally, the Space-level permission View Pages and Content to view tags. They can view shared tags only for resources for which they have view permission.

Authenticated users who plan to create and manage tags require the Space-level permission Customize Pages and Edit Content. They must have view permission on the resource.

WebCenter Spaces administrators with the Application-Manage Configuration permission and individual Space moderators can add tags to a page template. Page creation permissions are required to add task flows to a page. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter may not be available if the Tags service is not enabled in the current Space.

57.1 What You Should Know About the Tags Service

The Tags service provides a means of bookmarking application objects, making them easy to locate the next time you go looking for them. You can tag pages and documents in WebCenter applications. This section provides an overview of the Tags service: what tags are and how to use tags. It contains the following subsections:

- Section 57.1.1, "Understanding Tags"

- Section 57.1.2, "Adding the Tags Icon to Pages"

- Section 57.1.3, "Understanding the Tags Task Flow"

- Section 57.1.4, "Understanding the Similarly Tagged Items Task Flow"

- Section 57.1.5, "Understanding the Tag Center"

57.1.1 Understanding Tags

A tag is a word you associate with WebCenter application pages or documents, applying your own classification to improve search results. For example, you could apply the tag jcr to a page that provides useful insight into Java Content Repositories. When you search for information about JCRs, the tagged page appears in the results.

Tags are available for viewing in the Tags task flow, in search results, and in the Tag Center, where you can see what tags were used and what items were tagged. Tagging assists with building a knowledge network where each user can benefit from the assessments of all users.

Your tags help provide a higher level of relevance from search results for yourself and others by augmenting results with relevant items that you or others have tagged. Additionally, classifying an item with a tag enables you to gather disparate items into a cohesive body of knowledge and share it with others.

You have the option of sharing tags or keeping them to yourself. Share tags to enable other users to discover them in their searches. When you do not share a tag, users searching on an identical term do not discover the items you tagged with that term, unless some other user tagged the item with the same term and shared that tag.

Anywhere you see the Tags icon (Figure 57-1), you can apply a tag.

Figure 57-1 The Tags Icon

When you place your cursor over the Tags icon, you see a list of any tags you have applied to the item and the tags that have been applied most frequently to the item by you and other users. To see the items associated with a displayed tag, click the tag.

When looking at tags in search results, note the number of times the tag was applied to a particular object. This number indicates the tag's relevance to that object, and ultimately causes a collective classification scheme popularly known as a folksonomy.

Note:

According to Wikipedia, folksonomies make a body of information increasingly easy to search, discover, and navigate over time (http://en.wikipedia.org/wiki/Folksonomy).

The scope of tags is both personal and application-wide. The tag data you view in the Tags task flow includes only the tags you apply; however, when you tag data through the Tag Center or through a Tags service task flow you see application-wide tag data.

Application-wide (global) searches look for tagged items wherever they might be. You can run global searches from the search field near the top-right of the WebCenter Spaces application.

You can provide one or multiple tags to a given item. And multiple users can use the same tag term that you used and apply it to the same item. Duplicates of tags across users are tabulated and provide extra weight to the relevance of the tag term.

57.1.2 Adding the Tags Icon to Pages

If you do not see the Tags Icon on pages, then your WebCenter administrator or Space moderator must follow these steps to add the Tags icon to pages.

1. On the Administration - Resources tab, edit the page template. Select Edit - Copy, and enter a meaningful name for this new page template.

Figure 57-2 Copying Default Page Templates

2. Click Edit - Edit, and add the Tags icon to the template page. For example, at the top of the page, click Add Content, click to open the Template Development folder, and then click to add Tags.

3. Click Save, then Close to stop editing the template.

4. On the Administration - Resources - Page Templates tab, select this template. Click Edit - Show to make the template available.

5. In the Space administration settings, on the General page, set this new template as the Default Page Template for the Space, and click Apply.

The Tags icon displays on the page (Figure 57-3).

Figure 57-3 Tags Icon on a Page

57.1.3 Understanding the Tags Task Flow

The Tags task flow provides a view of the tags you have added to your application and the items you have tagged. It is available in the Oracle Composer Catalog (Figure 57-4).

Figure 57-4 Tags Task Flow

You can use the Tags task flow to navigate to a tag's associated resources or to open the Tag Center and further refine your resource selection (see Section 57.2.6, "Working with Tags and Tagged Items in the Tag Center"). You can also use it to display a tag cloud or the items you have tagged in your WebCenter application.

To learn how to work with tags in the Tags task flow see Section 57.2.4, "Working with Tags and Tagged Items in the Tags Task Flow."

57.1.4 Understanding the Similarly Tagged Items Task Flow

The Similarly Tagged Items task flow (Figure 57-5) provides a list of links to other pages or documents that have at least one tag in common with the currently-displayed page.

Figure 57-5 The Similarly Tagged Items Task Flow

57.1.5 Understanding the Tag Center

The Tag Center is a dynamically-generated page that displays all the tags you and other users have applied to WebCenter application pages and documents (Figure 57-6).

Figure 57-6 The Tag Center

The Tag Center offers the most complete use of tag data by providing access not only to your tags, but to the tags applied by other users. Additionally it provides a visual depiction of tag popularity, which enables you to refine tag results using filters. Filter for multiple tags simultaneously or filter by other users who have applied the same tags. A sorting feature provides an additional means of controlling your view of tagged items.

The Tag Center has three sections:

- The Tag Cloud section, which you can use to view a cloud or list of the tags currently applied to WebCenter application items.

- The Refine Tag Results section with two types of list: a list of all other tags used on items that also use the currently-selected tag and a list of other users who have applied the selected tag.

- The All Tagged Items section, which provides a list of all items to which you have access that use the currently-selected tag and options to edit, sort, and filter the items.

The Tag Cloud is a visual depiction of currently-applied tags (Figure 57-7).

Figure 57-7 The Tag Cloud

Tags are presented according to the frequency of their use. More frequently used tags display in bold fonts and varying font sizes—the larger the font, the more the tag has been applied. Click a tag in the tag cloud to execute a search that returns a list of all items to which you have access that use the tag.

To learn how to work with tags in the Tag Center see Section 57.2.6, "Working with Tags and Tagged Items in the Tag Center."

57.2 Working with Tags Service Features and Task Flows

This section provides information about tagging and describes how to make best use of tags. It includes the following subsections:

- Section 57.2.1, "Adding a Tags Service Task Flow to a Page"

- Section 57.2.2, "Tagging WebCenter Portal Application Pages"

- Section 57.2.3, "Tagging WebCenter Portal Application Documents"

- Section 57.2.4, "Working with Tags and Tagged Items in the Tags Task Flow"

- Section 57.2.5, "Viewing Tags and Tagged Items in Search Results"

- Section 57.2.6, "Working with Tags and Tagged Items in the Tag Center"

57.2.1 Adding a Tags Service Task Flow to a Page

For the steps to add a Tags service task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

57.2.2 Tagging WebCenter Portal Application Pages

This section steps you through the process of applying tags to WebCenter application pages. You can apply a tag to any application page on which you see the Tags icon and link (Figure 57-8).

Figure 57-8 A Page's Tags Icon and Link

To tag a WebCenter application page:

1. Go to the page you want to tag.

2. Click the page's Tags icon or link.

The Tag this Page dialog opens (Figure 57-9).

Figure 57-9 The Tag this Page Dialog

3. Enter tag values:

- Page Name—The page's display name, a read-only value.

- Tags—Enter one or more tags, separated with a space. Use underscores or hyphens in multi-word tag entries.

- Recommended Tags—Recommended tags are automatically generated using a ranking algorithm. They indicate the system's best estimation of tags that suit the page you are currently tagging. Click a recommended tag to add it to the Tags field.

- Shared—Imagine that you have tagged a page with the term essential and selected the Shared checkbox. When other users search using the term essential, the page you tagged appears in their search results. If you clear the Shared checkbox, other users' search on the term essential does not include this page in their results (unless others, too, have tagged it essential or another user tagged it essential and shared the tag).

Regardless of whether you select or clear Shared, when you search on the term essential, the page you tagged with that term appears in your search results.

4. Click Save to apply the tag and close the dialog.

Note:

For information about tags and searches, see Section 57.2.5, "Viewing Tags and Tagged Items in Search Results."

57.2.3 Tagging WebCenter Portal Application Documents

The section steps you through the process of applying tags to documents. You can apply tags to any documents you can view.

To apply tags to WebCenter application documents:

1. Go to a Document Library main view, either the task flow or the Documents page, and locate the document you want to tag.

2. Click the document to open it, then click View - Related Items. The Tags section displays the tags you have put on the document. It also lets you update these tags and add new tags. (Figure 57-10).

Figure 57-10 Related Items - Tags

3. Enter tag values:

- Tags—Enter one or more tags. Separate one tag from another with a Space.

- Recommended Tags—Recommended tags are automatically generated using a ranking algorithm. They indicate the system's best estimation of tags that suit the document you are currently tagging. Click a recommended tag to add it to the Tags field.

- Shared—Imagine that you have tagged a document with the term essential and selected the Shared checkbox. When other users search using the term essential, the document you tagged appears in their search results. If you clear the Shared checkbox, other users' search on the term essential does not include this document in their results (unless they, too, have tagged it essential).

Regardless of whether you select or clear Shared, when you search on the term essential, the document you tagged with that term appears in your search results.

4. Click Save to apply the tag.

Note:

For information about tags and searches, see Section 57.2.5, "Viewing Tags and Tagged Items in Search Results."

57.2.4 Working with Tags and Tagged Items in the Tags Task Flow

This section describes how to work with tags in the Tags task flow. It contains the following subsections:

- Viewing Tags and Tagged Items in the Tags Task Flow

- Sorting Tags and Tagged Items

- Filtering Tags and Tagged Items

- Renaming a Tag from the Tags Task Flow

- Deleting a Tag from the Tags Task Flow

57.2.4.1 Viewing Tags and Tagged Items in the Tags Task Flow

Drop the Tags task flow on a page from the Resource Catalog. The Tags task flow displays all the tags you have added to your WebCenter application (Figure 57-11).

Figure 57-11 Tags Task Flow

To view a tag cloud depiction of your tags, choose Tag Cloud.

To view tagged items, choose Tagged Items from the display options menu. The task flow redraws to display all the items that you have tagged in your WebCenter application.

57.2.4.2 Sorting Tags and Tagged Items

When your tag list is long, sorting the list makes it easier to find specific tags. Sort the tag list by name, date, or popularity. This section describes how.

To sort the tags in the Tags task flow:

1. Click the Sorting options icon at the top of the Tags task flow.

The Sorting options dialog opens (Figure 57-12).

Figure 57-12 The Sorting Options Dialog

2. From the Sorting options dialog, choose a sorting criteria.

Choose from:

- Name—Sorts the list alphabetically from 1 to 9 and a to z.

- Date—When tags are shown, Date sorts the list from the tags you applied most recently to the oldest tags you applied. When tagged items are shown, Date sorts the list from the items you tagged most recently to the items with the oldest tags you applied.

- Popularity—When tags are shown, Popularity sorts the list from the tags you have applied most frequently to those you have applied least frequently. When tagged items are shown, Popularity sorts the list from the items that have been tagged by the most people to the items tagged by the fewest.

3. Click Save to apply your selection and close the dialog.

57.2.4.3 Filtering Tags and Tagged Items

Filtering provides a way to eliminate all tags on the list except for those that meet the filtering criteria. This section describes how to apply a filter to the Tags list in the Tags task flow:

To filter the Tags list in the Tags task flow:

1. Click the Filter icon to open a filtering term field (Figure 57-13).

Figure 57-13 The Filter Icon

Filtering works for both Tags and Tagged Items views of the task flow.

2. Enter a filtering term, and click the Search icon.

The Tags list refreshes, showing only those tags that match or include the filtering term.

3. Clear the filtering term, and click the Search icon to restore all of your tags to view.

4. Click the Filter icon to exit filtering.

57.2.4.4 Renaming a Tag from the Tags Task Flow

When you rename a tag, you rename all instances of the tag that you applied. If other users applied the same tag, their instances are not renamed.

To rename tags from the Tags task flow:

1. Choose Rename from the menu next to the tag you want to rename (Figure 57-14).

Figure 57-14 The Rename Command on a Tag Menu

2. In the Rename dialog, enter a new name for the selected tag, and click Rename (Figure 57-15).

Figure 57-15 The Rename Dialog

All of the tags you created using the original tag name, are renamed.

57.2.4.5 Deleting a Tag from the Tags Task Flow

When you delete a tag, it is deleted wherever you applied it. If others applied the same tag, their tags are left as is.

To delete a tag from the Tags task flow:

1. Choose Delete from the menu next to the tag you want to delete (Figure 57-16).

Figure 57-16 The Delete Command on a Tag Menu

2. Click Delete in the Delete dialog (Figure 57-17).

Figure 57-17 The Delete Dialog

The tag is removed from the Tags task flow and from any items to which you applied it.

57.2.5 Viewing Tags and Tagged Items in Search Results

Tag search results appear under two headings:

- Tags, which shows tags that at least partially match the search criteria; for example, if you search for page, the following tags are returned: page, pages, or pager.

- Tagged Items, which shows items that are associated with a tag that matches the search criteria exactly; for example, if you search for page, only items associated with the tag page are returned; items associated with the following tags are not returned: pages or pager

Under these headings, tag search results appear like any other search results; however, tags in tag search results behave a little differently. When you click tagged items in tag search results or when you click other types of search results, their associated content is shown. When you click a tag in tag search results, the Tag Center opens with that tag preselected.

To view tags and tagged items in search results:

1. Run a search as described in Section 56.3.2, "Searching in a WebCenter Application."

2. The search results open in the Search page (Figure 57-18). The Tags section shows the number of items to which a tag has been applied. The Tagged Items section shows the number of users who have applied a tag to an item.

Figure 57-18 Search Page with Tag Results

Note:

Results appear different if you are using the WebCenter live search adapters or Oracle SES for the search engine. For more information, see Section 56.1.1, "Using the Oracle Secure Enterprise Search Adapter."

57.2.6 Working with Tags and Tagged Items in the Tag Center

This section describes how to work with tags in the Tag Center. It contains the following subsections:

- Opening the Tag Center

- Selecting Different Views and Arrangements of Tags in the Tag Cloud

- Selecting Different Views and Arrangements of Tagged Items

- Refining the Display of Information in the Tag Center

- Discovering Who Has Used a Tag in the Tag Center

57.2.6.1 Opening the Tag Center

There are several ways to open the Tag Center (Figure 57-19):

Figure 57-19 The Tag Center

- Click a tag displayed in the Tags task flow

- Click a tag returned as a search result

- Click a tag that appears when you hover over the Tags icon

Additionally, the administrator can add a page for the Tag Center in the Home Space.

The selected tag determines all the other tag-related information that appears in the Tag Center. For example:

- The selected tag is highlighted in the tag cloud (Figure 57-20).

Figure 57-20 A Tag Cloud

You can choose another tag in the tag cloud to change the information that is displayed in the Tag Center. Additionally, you can use the controls above the tag cloud to rearrange your tag-cloud view (see Section 57.2.6.2, "Selecting Different Views and Arrangements of Tags in the Tag Cloud").

- Other tags used on items that also use the currently-selected tag display in the Tagged with panel (Figure 57-21).

Figure 57-21 Tagged with Panel in the Tag Center

- Other users who applied the selected tag are listed in the Tagged by panel (Figure 57-22).

Figure 57-22 Tagged by Panel in the Tag Center

- Items tagged with the currently-selected tag appear in the right panel of the Tag Center (Figure 57-23). Click an item link to display the item.

Figure 57-23 Items Tagged with "Concurrency" in the Tag Center

57.2.6.2 Selecting Different Views and Arrangements of Tags in the Tag Cloud

The Tag Center's Tag Cloud displays the tags currently applied to WebCenter Spaces items. You can adjust your view of the Tag Cloud using its sorting and filtering features.

To display the tag cloud:

1. Open the Tag Center as described in Section 57.2.6.1, "Opening the Tag Center."

The Tag Center opens with the tag cloud displayed in the top left corner (Figure 57-24).

Figure 57-24 The Tag Cloud

To adjust your view of the tag cloud:

- To search for tags, enter a search term in the text box on the tag cloud toolbar, and click the Search icon to the right of the text box.

The tag display refreshes showing only those tags that meet the search criteria. To show just your matching tags or to remove the search criteria, choose an option from the menu above the tag cloud:

- All Tags—Removes the search criteria, showing every tag used in your WebCenter application

- My Tags—Removes the search criteria, showing just the tags you have applied

- All tags containing '<search term>'—Shows all tags in your WebCenter application that meet the search criteria

- My tags containing '<search term>'—Shows just the tags which you have applied that meet the search criteria

- To switch between displaying the tags in cloud view or list view, click the cloud icon (Figure 57-25).

Figure 57-25 Tags Displayed in a List

- To sort the tags:

1. Click the Sorting options icon on the tag cloud toolbar.

The Sorting options dialog opens (Figure 57-26).

Figure 57-26 The Sorting Options Dialog

2. From the Sorting options dialog, choose sorting criteria.

Choose from:

- Name—Sorts the list alphabetically. If you choose Ascending, the list is sorted from 1 to 9 and a to z. If you choose Descending, the list is sorted from z to a and 9 to 1.

- Date—Sorts the list based on when you applied the tags. If you choose Ascending, the tags are sorted from the ones you applied most recently to the ones applied longest ago. If you choose Descending, the tags are sorted from the ones applied longest ago to the ones applied most recently.

- Popularity—Sorts the list based on how frequently the tag has been applied. If you choose Ascending, the tags are sorted from the ones that have been applied most frequently to the one that have been applied least frequently. If you choose Descending, the tags are sorted from the ones applied least frequently to the ones applied most frequently.

3. Click Sort to apply your selection and close the Sorting options dialog.

- To refresh the list of tags, click the Refresh tags icon.

- To show all tags or just your tags, choose an option from the menu above the tag cloud:

- All Tags—Shows every tag used in your WebCenter application

- My Tags—Shows just the tags you have applied

57.2.6.3 Selecting Different Views and Arrangements of Tagged Items

The Tag Center provides a selection of sorting criteria to enable you to display tagged items in the way that you prefer. Using the Tagged by and Sort By options above the list of tagged items (Figure 57-27), you can choose which tags to show and the order in which to show them.

Figure 57-27 Tagged by and Sort By Options for Tagged Items in the Tag Center

To choose the tagged items to view, choose from:

- Tagged by Me—Click to show only the items that use the selected tag that you have tagged yourself.

- Tagged by Anyone—Click to show all items that use the selected tags.

To arrange the order of displayed tagged items, choose from:

- Popularity—To sort the list from items that have been tagged most frequently with the current tag to those tagged least frequently

- Name—To sort the list alphabetically from 1 to 9 and a to z

- Date—To sort the list from items that have been tagged most recently to the ones tagged longest ago

57.2.6.4 Refining the Display of Information in the Tag Center

You can further refine your view of information in the Tag Center by selecting additional tags in the Tagged with panel (Figure 57-28).

Figure 57-28 Tagged with Panel in the Tag Center

The Tagged with panel displays all the other tags used on objects that also use the currently-selected tag. Click a tag in the Tagged with panel to further restrict the information in the Tag Center to information associated with both the selected tag and the related tag you clicked.

For example, imagine that the Tag Center displays all items tagged with the term help. Click jcr_docs in the Tagged with panel to further refine the information in the Tag Center to information that is associated with both help and jcr_docs.

57.2.6.5 Discovering Who Has Used a Tag in the Tag Center

You can further refine your view of information in the Tag Center by selecting other users in the Tagged by panel (Figure 57-29).

Figure 57-29 Tagged by Panel in the Tag Center

The Tagged by panel lists all other users who have applied the selected tag or tags. Click a user in the Tagged by panel to limit the information in the Tag Center to information tagged with the selected tag and also tagged by the user you clicked.

Using Figure 57-29 as an example, and assuming the currently-selected tag is help, clicking orcladmin shows information associated with the tag help, applied by orcladmin.

57.3 Setting Tags Service Task Flow Properties

The Tags service task flow has associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 57-30).

Figure 57-30 Similarly Tagged Items Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Tags service task flows and describe the properties on the Parameters tab.

- Section 57.3.1, "What You Should Know About the Tags Service Task Flow Properties"

- Section 57.3.2, "Tags Service Task Flow Parameters"

57.3.1 What You Should Know About the Tags Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 57.3.2, "Tags Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about ELs in WebCenter Spaces, seeAppendix B, "Expression Language Expressions."

57.3.2 Tags Service Task Flow Parameters

Table 57-1 describes the parameters that are unique to the Tags service task flows.

Table 57-1 Tags Service Task Flow Parameters

Parameter

Description

Task Flow

Resource ID

Unique ID of the item or resource within a given service that is used to find similarly tagged items. This value is set automatically. Do not change this value unless you want to show items similar to a different resource.

Similarly Tagged Items

Service ID

This parameter has a different meaning for the Similarly Tagged Items task flow and the Tags task flow.

- In Similarly Tagged Items, it is a resourceId/serviceId pair that describes what item the listed objects are similar to. This value is set automatically. Do not change this value unless you want to show items similar to a different resource belonging to a different service.

- In Tags, it limits the tags and tagged items to this service; for example, oracle.webcenter.page.

Similarly Tagged Items

Tags

Scope of Tags

Scope of tags. This value is set automatically. Do not change this value.

Tag Cloud

Related Resources

Note:

You should not change the Tags service task flow properties unless you want to show items from a different resource or different service.

Part XIV

Gathering Intelligence Based on Activities

Part XIV of the User's Guide provides information about accumulating portal and community usage intelligence from the actions of your users.

Part XIV includes Chapter 58, "Working with the Activity Graph Service."

58 Working with the Activity Graph Service

The Activity Graph service provides a means of enlarging your sphere of interest in WebCenter Spaces by offering recommendations for new connections, suitable items, and relevant Spaces, and by returning more relevant search results. It does this by tracking application activities across users for a period of time. Based on these activities the Activity Graph engine starts to provide recommendations.

This chapter provides an overview of Activity Graph service features and describes how to use them. It includes the following sections:

- Section 58.1, "What You Should Know About the Activity Graph Service"

- Section 58.2, "Working with Activity Graph Service Task Flows"

- Section 58.3, "Setting Activity Graph Service Task Flow Properties"

For Activity Graph task flows to work, the Analytics schema (activities) must be installed and configured, and a connection set up between your application and the Analytics Collector.

See Also:

For more information, see the chapter "Managing the Analytics Service" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

58.1 What You Should Know About the Activity Graph Service

The advent of Enterprise 2.0 has enabled users to contribute content at unprecedented rates. In view of this, there is now a need for better information retrieval technologies that are seamlessly integrated with Enterprise 2.0 products, such as WebCenter Spaces. The Activity Graph service provides the solution by leveraging collective intelligence, gathered by the underlying Activity Graph engine, to benefit search and social applications.

The Activity Graph service provides suggestions of people that a user may be interested in connecting with, based on existing connections and shared interaction with objects in the application. It also directs users to Spaces or items that may be of interest, based on similar interactions with those Spaces or items the user is currently viewing.

The Activity Graph service presents these suggestions based on data gathered and analyzed by the Activity Graph engine. The Activity Graph engine provides a central repository for actions that are collected by enterprise applications.

The Activity Graph service serves up its recommendations in the following three out-of-the-box task flows:

- Recommended Connections

Use the Recommended Connections task flow (Figure 58-1) to view and connect with users similar to you.

Figure 58-1 The Recommended Connections Task Flow

See Also:

For more information about this task flow, see Section 58.2.2, "Working with the Recommended Connections Task Flow."

- Similar Spaces

Use the Similar Spaces task flow (Figure 58-2) to identify and interact with Spaces that may be of interest to you.

Figure 58-2 The Similar Spaces Task Flow

See Also:

For more information about this task flow, see Section 58.2.3, "Working with the Similar Spaces Task Flow."

- Similar Items

Use the Similar Items task flow (Figure 58-3) to identify and interact with WebCenter content that may be of interest to you.

Figure 58-3 The Similar Items Task Flow

See Also:

For more information about this task flow, see Section 58.2.4, "Working with the Similar Items Task Flow."

Note:

The Activity Graph service task flows display recommendations only if the Activity Graph service is configured in your application. For more information, see the section "Activity Graph Service Prerequisites" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Out of the box, the Activity Graph service tracks certain WebCenter objects and actions. However, you can extend the service to track other WebCenter objects or actions, or objects and actions from other applications.

See Also:

For more information, see the section "Extending the Activity Graph Service" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

58.2 Working with Activity Graph Service Task Flows

The Activity Graph service task flows expose the functionality available from the Activity Graph service.

This section includes the following subsections:

- Section 58.2.1, "Adding an Activity Graph Service Task Flow to a Page"

- Section 58.2.2, "Working with the Recommended Connections Task Flow"

- Section 58.2.3, "Working with the Similar Spaces Task Flow"

- Section 58.2.4, "Working with the Similar Items Task Flow"

58.2.1 Adding an Activity Graph Service Task Flow to a Page

By default, the Recommended Connections task flow is included in each user's Profile Gallery, available through the Home Space. The Similar Items task flow is included, by default, in the Document Viewer Related Items pane for files, to show items similar to the currently viewed file.

To include any of the Activity Graph service task flows anywhere else, you must add the task flow to the appropriate page.

To add an Activity Graph service task flow to a page:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that contains the Activity Graph service task flows or search for the task flow.

Tip:

The presence or location of this component depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, next to Social and Communication, click Open to expose a list that includes the Activity Graph service task flows.

4. Click Add next to the task flow that you want to add to your page.

58.2.2 Working with the Recommended Connections Task Flow

The Recommended Connections task flow enables viewing and connecting to people considered to be similar to you.

Note:

The recommendations provided in the task flow reflect the contents of the activity graph when the Activity Graph Engines were last run. Activities that occurred after the last run are not included. For more information, see the section "Preparing Data for the Activity Graph Service" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

This section includes the following subsections:

- Section 58.2.2.1, "Learning More About a Recommended Connection"

- Section 58.2.2.2, "Inviting a Recommended Connection to Connect with You"

- Section 58.2.2.3, "Removing a User from Your Recommended Connections"

See Also:

For general information about connections, see Chapter 31, "Creating Your Social Network."

58.2.2.1 Learning More About a Recommended Connection

Before you connect with someone new, you probably want to find out a bit more about that person to determine whether it is really a connection that you want to make. The Recommended Connections task flow enables this by providing access to the user profile information and by including reasons why the recommendation has been made.

To view information about a recommended connection:

1. Go to a Recommended Connections task flow.

Tip:

By default, you can find a Recommended Connections task flow on the Profile page in your Home Space.

2. For each of your recommended connections, the task flow includes the name, title, and profile icon of the user. This provides a snapshot to help you decide quickly if you want to connect to this person.

3. To find out more information about the user, click name of the user to display the User Detail popup.

Note:

Alternatively, you can click the user icon to display the user's Profile Gallery.

4. In the User Detail popup (Figure 58-4), you can view additional information about the user, such as his or her location and current status. You can also choose to view the full profile or contact the user by email or instant message.

Figure 58-4 The User Detail Popup

Note:

The information in the User Detail popup depends on the information that the user has provided in their profile, and the services that are enabled in the Space.

5. Click anywhere away from the popup to close it.

6. The task flow may also provide a reason why each person was recommended as a potential connection. For example, you may be connected to some of the same people or you may have worked on the same documents or wikis.

Reasons for recommending a connection are:

- You share connections with the user

- You and the user edited one or more of the same items

- You and the user worked in one or more of the same Spaces

- You and the user tagged one or more of the same items

Click the reason to find out more details. For example, a list of the connections you have in common, or a list of the objects that you have both worked on (Figure 58-5).

Figure 58-5 Details for Reasons for Recommended Connections

7. Click anywhere away from the popup to close it.

8. After examining this information you can decide whether to connect to this person, or remove him or her from the list of recommended connections.

58.2.2.2 Inviting a Recommended Connection to Connect with You

If you find a person in the list of recommended connections that you want to connect with, you can do so quickly from the User Detail popup or the user's Profile Gallery.

To invite a recommended connection to connect with you:

1. Go to a Recommended Connections task flow.

Tip:

By default, you can find a Recommended Connections task flow on the Profile page in your Home Space.

2. Find the person in the list of recommended connections.

3. Click the name of the user to display the User Detail popup, or the user icon to display the user's Profile Gallery.

4. Click Get Connected (Figure 58-6).

Figure 58-6 The Get Connected Link

5. In the Invitation Message dialog (Figure 58-7), enter your own message or keep the default.

Figure 58-7 The Invitation Message Dialog

6. From the Select connection lists dropdown list, select the connection list to which you want to add this user.

See Also:

For more information about connections lists, see Section 31.4.5, "Creating and Managing Connections Lists."

7. Click Invite.

If the person you have invited set Preferences to automatically accept all invitations, you are connected immediately. Otherwise, the invitation becomes available in the recipient's Connections page.

See Also:

For more information, see Section 31.4.3, "Viewing Invitations to Connect."

58.2.2.3 Removing a User from Your Recommended Connections

If the list of recommended connections includes people that you do not want to connect with, you can remove them, making space for more recommendations. You might also choose to remove someone after you have issued them an invitation to connect. If you do so, the recommendation is removed from the list, but the invitation is not canceled.

To remove a recommended connection:

1. Go to a Recommended Connections task flow.

Tip:

By default, you can find a Recommended Connections task flow on the Profile page in your Home Space.

2. Find the person in the list of recommended connections.

3. Click the Do not show this person icon next to the user in the list (Figure 58-8).

Figure 58-8 The Do Not Show This Person Icon

4. The task flow is refreshed with a new recommended connection taking the place of the one you removed.

58.2.2.4 Setting the Number of Users to Display in the Recommended Connections Task Flow

You can control the number of users that are displayed in the Recommended Connections task flow.

To set the number of recommended connections to display:

1. Go to a Recommended Connections task flow.

Tip:

By default, you can find a Recommended Connections task flow on the Profile page in your Home Space.

2. Click the Display Options icon.

3. In the Display Options dialog, in the Number of People field (Figure 58-9), enter how many recommended connections you want to list in the task flow. The default value is 5.

Figure 58-9 The Number of People Field

4. Click OK.

58.2.2.5 Controlling Which Users to Include in the Recommended Connections Task Flow

By default, the Recommended Connections task flow includes all recommended connections except those with whom you are already connected. You can change this setting by editing the task flow's display options. For example, you could use the task flow to show users who are similar to you, rather than to show recommended connections. In this case, you might want to include existing connections.

To control which users to include in the task flow:

1. Go to a Recommended Connections task flow.

Tip:

By default, you can find a Recommended Connections task flow on the Profile page in your Home Space.

2. Click the Display Options icon.

3. In the Display Options dialog, select the Users I am connected with checkbox (Figure 58-10) to include users in the list of recommended connections even if you are already connected with them.

Deselect the checkbox to remove users from the list if you are already connected with them.

Figure 58-10 The Users I Am Connected With Option

Note:

This checkbox is not selected by default.

4. Click OK.

58.2.3 Working with the Similar Spaces Task Flow

The Similar Spaces task flow can be placed on any page in a Space. It provides you with suggestions of other Spaces that are similar to the one you are currently viewing. A Space is considered similar to another Space if the same people interact with it, especially if they edit the content.

Only Spaces that you are permitted to view are listed in the Similar Space task flow.

Note:

The suggestions made in the Similar Spaces task flow are determined based on the currently viewed Space only; they are not specific to the current user.

Note:

The recommendations provided in the task flow reflect the contents of the activity graph when the Activity Graph Engines were last run. Activities that occurred after the last run are not included. For more information, see the section "Preparing Data for the Activity Graph Service" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

This section includes the following subsections:

- Section 58.2.3.1, "Learning More About a Suggested Space"

- Section 58.2.3.2, "Joining a Suggested Space"

- Section 58.2.3.3, "Removing a Space from the Task Flow"

- Section 58.2.3.4, "Setting the Number of Spaces to Display in the Similar Spaces Task Flow"

- Section 58.2.3.5, "Controlling Which Spaces to Include in the Similar Spaces Task Flow"

58.2.3.1 Learning More About a Suggested Space

When looking at a Space in the Similar Spaces task flow, one of the first things you will probably want to do is find out more about that Space. This will help you determine whether the Space is one that you are interested in joining or not.

To learn more about a suggested Space:

1. Go to the Similar Spaces task flow that includes the Space about which you want to learn more.

2. For each of the suggested Spaces, the task flow includes the name and description of the Space. This provides a snapshot to help you decide quickly if the Space is one that you might be interested in.

3. To go to the Space to find out more about it, click the name.

4. Examine the contents of the Space to determine if you are interested in it.

5. After examining the Space you can decide whether to join the Space, or remove it from the task flow.

58.2.3.2 Joining a Suggested Space

If you find a Space in Similar Spaces task flow that you want to join, you can do so by visiting the Space.

To join a suggested Space:

1. Go to the Similar Spaces task flow that includes the Space that you want to join.

2. Find the Space that you want to join.

3. Click the Space name to open the Space.

4. In the Space, subscribe to the Space. Some membership requests require approval from the Space moderator so you may not gain access immediately.

See Also:

For more information, see Section 49.6, "Joining a Space."

58.2.3.3 Removing a Space from the Task Flow

If you decide that you are not particularly interested in a Space listed in the Similar Spaces task flow, you can remove it, making space for more suggestions. The Space is removed only from your view of the task flow; the Space will continue to be listed for other users, as long as they have permission to view it.

To remove a Space from the task flow:

1. Go to the Similar Spaces task flow that includes the Space that you want to remove.

2. Find the Space that you want to remove.

3. Click the Do no show this space icon next to the Space (Figure 58-11).

Figure 58-11 The Do Not Show This Space Icon

4. The task flow is refreshed with a new similar Space taking the place of the one you removed.

58.2.3.4 Setting the Number of Spaces to Display in the Similar Spaces Task Flow

You can control the number of Spaces that are displayed in the Similar Spaces task flow.

To set the number of similar Spaces to display:

1. Go to the Similar Spaces task flow that you want to edit.

2. Click the Display Options icon.

3. In the Display Options dialog, in the Number of Spaces field (Figure 58-12), enter how many similar Spaces you want to list in the task flow. The default value is 5.

Figure 58-12 The Number of Spaces Field

4. Click OK.

58.2.3.5 Controlling Which Spaces to Include in the Similar Spaces Task Flow

By default, the Similar Spaces task flow does not include Spaces that you are already a member of, but it does include Spaces that you have already viewed. You can change these settings by editing the task flow's display options.

To which Spaces to include in the task flow:

1. Go to the Similar Spaces task flow that you want to edit.

2. Click the Display Options icon.

3. In the Display Options dialog, select the Show Spaces I have worked on before checkbox (Figure 58-13) to display Spaces in which you have performed an action (excluding viewing) in the list of similar Spaces.

Deselect the checkbox if you do not want to include Spaces that you have worked on.

Figure 58-13 The Show Spaces I Have Worked on Before Option

Note:

This checkbox is not selected by default.

4. Select the Show Spaces I have visited before checkbox (Figure 58-14) to include Spaces in the list of similar Spaces even if you have already viewed them.

Deselect the checkbox to remove Spaces from the list if you have already viewed them.

Figure 58-14 The Show Spaces I Have Visited Before Option

Note:

This checkbox is selected by default.

5. Click OK.

58.2.4 Working with the Similar Items Task Flow

The Similar Items task flow provides you with suggestions of other items you might want to view, based on the item you have currently selected on the page.

Note:

The suggestions made in the Similar Items task flow are determined based on the currently selected item only; they are not specific to the current user.

Note:

The recommendations provided in the task flow reflect the contents of the activity graph when the Activity Graph Engines were last run. Activities that occurred after the last run are not included. For more information, see the section "Preparing Data for the Activity Graph Service" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

This section includes the following subsections:

- Section 58.2.4.1, "Populating the Similar Items Task Flow"

- Section 58.2.4.2, "Viewing a Suggested Item"

- Section 58.2.4.3, "Removing an Item from the Similar Items Task Flow"

- Section 58.2.4.4, "Setting the Number of Items to Display in the Similar Items Task Flow"

- Section 58.2.4.5, "Controlling Which Items to Include in the Similar Items Task Flow"

58.2.4.1 Populating the Similar Items Task Flow

The Similar Items task flow lists items that are similar to the currently selected item on the page. When you initially display a page that contains the Similar Items task flow, the task flow will probably be empty. To populate the task flow, you need to select an item for which you want to see similar items.

Note:

If the page containing the Similar Items task flow also contains the Document Viewer, the document currently displayed in the Document Viewer drives the content of the Similar Items task flow and you do not need to explicitly select an item.

To populate the Similar Items task flow:

1. Go to the page containing the Similar Items task flow.

2. In one of the other task flows on the page, select the item for which you want to see similar items.

The Similar Items task flow works in conjunction with the following task flows:

- Documents service task flows:

- Recent Documents

- Document List Viewer

- Document Navigator

- Document Explorer

- Folder Viewer

- Document Manager

- Document Browser

- Discussions Manager task flow

3. The Similar Items task flow refreshes to display items that are similar to the one you selected.

58.2.4.2 Viewing a Suggested Item

If you see an item in the Similar Items task flow that you think might be useful, you can go ahead and view it.

To view a suggested item:

1. Go to the Similar Items task flow that includes the item that you want to view.

2. Click the item's name to display the item.

The way the item is displayed depends on the type of item. For example, documents are displayed in the Document Viewer task flow.

58.2.4.3 Removing an Item from the Similar Items Task Flow

If you decide that you are not particularly interested in an item listed in the Similar Items task flow, you can remove it, making space for more suggestions. The item is removed only from your view of the task flow; the item will continue to be listed for other users, as long as they have permission to view it.

To remove an item from the task flow:

1. Go to the Similar Items task flow that includes the item that you want to remove.

2. Find the item that you want to remove.

3. Click the Do not show this item icon next to the item (Figure 58-15).

Figure 58-15 The Do Not Show This Item Icon

4. The task flow is refreshed with a new similar item taking the place of the one you removed.

58.2.4.4 Setting the Number of Items to Display in the Similar Items Task Flow

You can control the number of items that are displayed in the Similar Items task flow.

To set the number of items to display in the task flow:

1. Go to the Similar Items task flow that you want to edit.

2. Click the Display Options icon.

3. In the Display Options dialog, in the Number of items field (Figure 58-16), enter how many similar items you want to list in the task flow. The default value is 5.

Figure 58-16 The Number of Items Field

4. Click OK.

58.2.4.5 Controlling Which Items to Include in the Similar Items Task Flow

By default, the Similar Items task flow include items that you have already viewed. It also includes all types of supported items (documents, wiki pages, blogs, and discussion topics). You can change these settings by editing the task flow's display options. For example, you could use the task flow to show only discussion topics that are similar to the selected item.

To control which items to include in the task flow:

1. Go to the Similar Items task flow that you want to edit.

2. Click the Display Options icon.

3. In the Display Options dialog , select the Show items I have viewed before checkbox (Figure 58-17) to include items in the list of similar items even if you have already viewed them.

Deselect the checkbox to remove items from the list of similar items if you have already viewed them.

Figure 58-17 The Show Items I Have Viewed Before Option

Note:

This checkbox is selected by default.

4. Select the Show items I have worked on before checkbox () to include items in the list of similar items even if you have already interacted with them in some way (other than viewing).

Deselect the checkbox to remove items from the list of similar items if you have interacted with them already.

Figure 58-18 The Show Items I Have Worked on Before Option

Note:

This checkbox is not selected by default.

5. Select or deselect the following checkboxes as required to determine which types of items to display in the task flow (Figure 58-19):

- Show documents

- Show wiki pages

- Show blogs

- Show discussion topics

Figure 58-19 Options for Displaying Different Types of Items

Note:

These checkboxes are selected by default.

6. Click OK.

58.3 Setting Activity Graph Service Task Flow Properties

The Activity Graph service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 58-20).

Figure 58-20 Recommended Connections Task Flow - Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Activity Graph service task flows and describe the properties on the Parameters tab:

- Section 58.3.1, "What You Should Know About the Activity Graph Service Task Flow Properties"

- Section 58.3.2, "Activity Graph Service Task Flow Parameters"

58.3.1 What You Should Know About the Activity Graph Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 58.3.2, "Activity Graph Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

58.3.2 Activity Graph Service Task Flow Parameters

Table 58-1 describes the parameters that are unique to the Activity Graph service task flows.

Table 58-1 Activity Graph Service Task Flow Parameters

Parameter

Description

Task Flow

Resource Id

The ID of the person, Space, or item to use as a context for recommendations.

For connections, the default value is the expression language token for the logged in user.

For Spaces, the default value is the expression language token for the resource ID of the Space containing the task flow.

For items, the value is derived from the selection event using the EL expression #{wcEventContext.events.WebCenterResourceSelected}

Recommended Connections

Similar Spaces

Similar Items

Class URN

The class of the context. By default the information is derived from the selection event.

Similar Items

Object Name

The name of the Space or item to use as a context for recommendations.

For Spaces, the default value is the expression language token for the resource ID of the Space containing the task flow.

For items, the default value is derived from the selection event.

Similar Spaces

Similar Items

Recipe

A comma separated list of registered similarity calculation = weight pairs. The list determines what recommendations appear and how they are ordered.

For more information about the default recipes for Activity Graph task flows, see the section "Activity Graph Service Task Flows" in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

Recommended Connections

Similar Spaces

Similar Items

Class URN Restrictions

A comma separated list of object classes to exclude from recommendations.

Similar Items

Exclude Object Actions

A comma separated list of registered actions. The task flow will not show people, Spaces, or items on which the logged in user took any of the listed actions.

Recommended Connections

Similar Spaces

Similar Items

Service Id

Used in conjunction with resourceId, and optionally resourceType, as an alternative to classURN for identifying the node class of an object.

Similar Items

Resource Type

Used in conjunction with resourceId and serviceId, as an alternative to classURN for identifying the node class of a WebCenter object.

For example resourceType is used by the Documents service to identify whether an object is a wiki, blog, or document.

Similar Items

Suppress Popup

Determines whether links in the task flow launch content in inline popups (false) or in browser windows (true).

The default value is false.

Similar Items

Part XV

Services: Announcements through Links

Part XV of the User's Guide provides overview and usage information about services from Announcements through Links.

Part XV includes the following chapters:

- Chapter 59, "Working with the Announcements Service"

- Chapter 60, "Working with the Discussions Service"

- Chapter 61, "Working with the Events Service"

- Chapter 62, "Working with the Instant Messaging and Presence Service (IMP)"

- Chapter 63, "Working with the Links Service"

59 Working with the Announcements Service

This chapter describes how to use the features provided with the Announcements service. Announcements offer a quick, convenient way to create and distribute messages instantly or at a time you specify. You can use the Announcements service to view, create, and manage announcements.

This chapter includes the following sections:

- Section 59.1, "What You Should Know About the Announcements Service"

- Section 59.2, "Working with Announcements Service Task Flows"

- Section 59.3, "Setting Announcements Service Task Flow Properties"

Audience

This chapter is intended for WebCenter users who want to view, create, and manage Space announcements. To perform announcement-related tasks, you must have appropriate permissions: Create, Edit, and Delete Announcements, Create and Edit Announcements, or View Announcements. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter are not available if the Announcements service is not enabled in the current Space.

59.1 What You Should Know About the Announcements Service

The Announcements service provides the ability to post announcements about important activities and events to all authenticated users. For example, an application administrator can use this service to announce the availability of a new feature or the plan to shut down the application temporarily for maintenance (Figure 59-1).

Figure 59-1 Sample Announcement in the Announcements - Quick View Task Flow

The Announcements service is integrated with many WebCenter services, such as the Activity Stream, RSS, Search (to search announcement text), Instant Messaging and Presence services. You can use link announcements to other services, such as Events or Discussions. For example, suppose your company is announcing a new product, you can link from the announcement directly to a discussion forum, where potential customers can ask other customers about the product, or link to an instant messenger to speak directly with a customer service representative to purchase the product.

In Spaces, announcements are scoped to the Space where you create them. In Home Space pages, announcements are scoped application-wide, to all logged-in (authenticated) users.

The Announcements page is added to Spaces created with the Communities of Interest and Group Project templates (Figure 59-2). The Announcements page is available in every Space, provided the Space is configured to display announcements. For information about enabling services in a Space, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."

Figure 59-2 The Announcements Page in a Space

59.2 Working with Announcements Service Task Flows

Both the Announcements and the Announcements - Quick View task flows display current announcements. The Announcements task flow additionally offers tools for managing announcements within the task flow. With the Announcements - Quick View task flow, you must click the Open Announcement Manager icon to manage announcements.

The Announcements - Quick View task flow includes numerous parameters to customize your view. For example, administrators can remove the link to the Announcement Manager. This lets you present announcements to end users where manage controls are not needed. The task flow lists 10 announcements by default, but you can change this number and change how much of the announcement is displayed. The More Announcements ... link launches a popup containing the complete list of all announcements with pagination behavior. This is called the Extended Quick View (or Extended Mini View).

Depending on the privileges you have on the page, you can perform some or all tasks described in this section:

- View announcements in the Announcements task flow—All participants in Home Spaces, and Space moderators in Spaces.

- Create announcements—All participants in WebCenter Spaces.

- Edit announcements—Creator of the announcement in WebCenter Spaces applications, discussions server administrators in Home Spaces, and Space moderators in Spaces.

- Delete announcements—Discussions server system administrators in Home Spaces, and Space moderators in Spaces

This section contains the following subsections:

- Section 59.2.1, "Adding an Announcements Service Task Flow to a Page"

- Section 59.2.2, "Working with the Announcements Task Flow"

- Section 59.2.3, "Working with the Announcements - Quick View Task Flow"

- Section 59.2.4, "Sending Mail from an Announcement"

- Section 59.2.5, "Linking Announcements"

59.2.1 Adding an Announcements Service Task Flow to a Page

For the steps to add an Announcements service task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

Notes:

- You cannot add an Announcements task flow to your Home Space page. The Announcements task flow only displays in the component catalog if you have manage privilege and if you are adding content in a Space page. By default, this privilege is available to a Space moderator.

- All instances of the Announcements task flow in an application run against the same server and therefore, it serves no purpose to add multiple Announcements task flow instances.

The Announcements task flow is displayed on your page, as shown in Figure 59-3.

Figure 59-3 Announcements Task Flow

Users with Edit privileges can access the task flow's region parameter through the Component Properties dialog in Oracle Composer to specify the ID of the discussion forum under which announcements must be created.

For information about accessing the Component Properties dialog and editing properties, see Section 59.3, "Setting Announcements Service Task Flow Properties."

Note:

The Announcements - Quick View task flow opens in a Space, regardless of the discussion forum ID specified.

For more information about setting task flow properties, see Section 59.3, "Setting Announcements Service Task Flow Properties."

59.2.2 Working with the Announcements Task Flow

The Announcements task flow not only provides the tools to create, edit, and delete announcements, it also provides controls for determining when an announcement is published and when it expires and is consequently removed from the task flow. It provides Show lists, which you can use to personalize your view of announcements. After you create an announcement, you are offered the option to mail or link the announcement.

Depending on the privileges you have on the page and whether the required WebCenter services are configured in your application, you may see only a subset of these options in the Announcement Manager. For example, the Delete icon is displayed only to users with manage privilege.

This section provides information about viewing, creating, and managing announcements through the Announcements task flow. Discussions server administrators in Home Spaces and Space moderators in Spaces can access the Announcements task flow.

This section contains the following subsections:

- Section 59.2.2.1, "Viewing Announcements in the Announcements Task Flow"

- Section 59.2.2.2, "Adjusting Your View of the Announcements"

- Section 59.2.2.3, "Creating an Announcement"

- Section 59.2.2.4, "Editing Announcements"

- Section 59.2.2.5, "Deleting an Announcement"

59.2.2.1 Viewing Announcements in the Announcements Task Flow

To view announcements in the Announcements task flow, either select the Announcements task flow on a page, or select the Announcements page.

Figure 59-4 shows an announcement in the Announcements task flow.

Figure 59-4 An Announcement in the Announcements Task Flow

If Announcements is not available, then in the Space administration settings, display the Services page. On the Services page, choose Announcements. For more information, see Chapter 51, "Managing a Space."

Tip:

The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

59.2.2.2 Adjusting Your View of the Announcements

You can customize your own view of the Announcements task flow, which does not affect other users' view of announcements. All users who can view the Announcements task flow can customize it.

A Show list provides options for displaying only those announcements that were created within a selected time range. Choose from displaying all announcements to displaying only those created today, since yesterday, and so on—up to 30 days. For example, you may select the option Today from the Show menu, and only those announcements posted today display in the task flow.

Another Show list provides options to display current, future or expired announcements.

To adjust your view of the Announcement Manager:

1. Go to the application page that contains the Announcements task flow.

2. In the task flow, expand the Show menu and select from the listed display options (Figure 59-5).

Figure 59-5 Show Menu on Announcements

Choose:

- All— To display all available announcements.

- Today—To display only today's announcements.

- Since Yesterday—To display today and yesterday's announcements.

- Last 7 Days—To display all announcements made in the last seven days.

- Last 30 Days—To display all announcements made in the last 30 days.

The Announcements task flow refreshes and displays the announcements that match your selection.

3. Expand the other dropdown list to show active, future or expired announcements (Figure 59-6).

Figure 59-6 Active, Future or Expired Announcements

Table 59-1 shows what different combinations of these Show lists display.

Table 59-1 Announcements Displayed Based on Show Lists

Days Range

Announcement Type

Display Result

All

Active

All announcements as of today

Today

Active

All announcements with a start date of today.

Since Yesterday

Active

All announcements with a start date as of yesterday.

Last 7 Days

Active

All announcements for the last seven days.

Last 30 Days

Active

All announcements for the last 30 days.

All

Future

All announcements scheduled for a later date.

Today

Future

All announcements scheduled for a later date.

Since Yesterday

Future

All announcements scheduled for a later date.

Last 7 Days

Future

All announcements scheduled for a later date.

Last 30 Days

Future

All announcements scheduled for a later date.

All

Expired

All expired announcements.

Today

Expired

No announcements.

Since Yesterday

Expired

All expired announcements as of yesterday.

Last 7 Days

Expired

All expired announcements for the last seven days.

Last 30 Days

Expired

All expired announcements for the last 30 days.

59.2.2.3 Creating an Announcement

Create an announcement to distribute information to all members of an application or a Space in one operation. For example, if you are an administrator and want to shut down the application for maintenance, you can create an announcement to inform all application users about the down time. On the publication date you specify while creating the announcement, the announcement appears in the Announcements and Announcements - Quick View task flows, and on the Activity Stream.

In WebCenter Spaces, all participants can create announcements.

To create a new announcement:

1. Access the Announcements task flow, access the Announcements page, or open the Announcement Manager from the Announcements - Quick View task flow. For more information, see Section 59.2.2.1, "Viewing Announcements in the Announcements Task Flow."

2. Click Create (Figure 59-7).

Figure 59-7 Create an Announcement

The Create Announcement dialog opens (Figure 59-8).

Figure 59-8 The Create Announcement Dialog

3. In the Subject field, enter a heading for the announcement.

4. In the message body text box, enter the text of the announcement.

The message body is provided through the Rich Text Editor. You can style the announcement with colors, special fonts, and images. For information about Rich Text Editor controls, see the online help.

Styling information is applied when the announcement is configured with the Content View Only region parameter set to true. For more information, see Section 59.3, "Setting Announcements Service Task Flow Properties."

5. Under Announcement Active Date, choose:

- Make Active Now — To post the announcement immediately (the default option)

- Make Active on Specific Date — To select a date and time to post the announcement

Click the Select Date icon to the right of the text field to open the Select Date pop-up calendar (Figure 59-9).

Figure 59-9 The Select Date Pop-Up Calendar

In the calendar, click a date to select it. The current date is marked by a solid box.

Alternatively, use the controls at the top of the calendar to select a month and year for publication.

After you select a date, the calendar closes.

6. Under Announcement Expire Date, choose:

- Never Expires — To post the announcement indefinitely (the default option)

- Expire After Days — To specify the number of days the announcement is active

Enter the number of days to display the announcement.

- Expire on a Specific Date — To set the date and time to expire and remove the announcement

Click the Select Date icon next to the text field to open the Select Date pop-up calendar (Figure 59-10).

Figure 59-10 The Select Date and Time Icon

In the calendar, only those dates after the publication date are enabled for selection.

7. Click Create to create the announcement.

If you chose to post the announcement immediately, then the new announcement appears in following locations: in any Announcements task flow included on a page, on the Activity Stream, and at the top of the list of announcements in the Announcements - Quick View task flow.

59.2.2.4 Editing Announcements

After you have created an announcement, you easily can modify it. For example, if the details of an announcement change, or you want to change the font or color of the announcement text, you can quickly make these changes using the Announcement Manager. You can change an announcement's title, content and expiration date. However, you cannot change its publication date, which is the date on which the announcement is made active (Announcement Active Date).

Note:

To change an announcement's publication date, you must delete the announcement, and re-create it with the correct publication date. For information about deleting an announcement, see Section 59.2.2.5, "Deleting an Announcement." For information about creating an announcement, see Section 59.2.2.3, "Creating an Announcement."

You can edit an announcement only if you created that announcement or have been granted privileges to do so. Typically, Space moderators have privileges to edit all announcements in the Announcements task flow.

To edit an announcement:

1. Open the Announcements task flow. For information, see Section 59.2.2.1, "Viewing Announcements in the Announcements Task Flow."

2. Click the Edit Announcement icon (Figure 59-11) on the announcement you want to edit.

Figure 59-11 Edit Announcement Icon

The Edit Announcement dialog opens (Figure 59-12).

Figure 59-12 The Edit Announcement Dialog

3. Make the changes you want to the announcement. For example, you can change the text of the announcement, or modify its look and feel.

The Edit Announcement dialog provides Rich Text Editor controls for styling announcement text. For information on Rich Text Editor controls, see the online help.

You can change an announcement's title and content and, also its expiration date. However, you cannot change its publication date.

4. Click Save to save your changes and close the dialog.

59.2.2.5 Deleting an Announcement

After you've created an announcement, you can delete it if you are a Space moderator. Other users do not have privileges to delete announcements.

To delete an announcement:

1. Open the Announcements task flow. For information, see Section 59.2.2.1, "Viewing Announcements in the Announcements Task Flow."

2. Click the Delete Announcement icon on the announcement you want to delete (Figure 59-13). This icon only displays if you have the appropriate privileges.

Figure 59-13 The Delete Announcement Icon on an Announcement

3. In the Delete Announcement dialog (Figure 59-14), click Delete to delete the announcement and close the dialog.

Figure 59-14 Delete Announcement Dialog

The selected announcement is removed from the Announcements task flow, the Announcements - Quick View task flow, and the Activity Stream.

59.2.3 Working with the Announcements - Quick View Task Flow

The Announcements - Quick View task flow is essentially a viewer for convenient access to current announcements. More robust features, for such actions as creating and editing announcements, are offered in the Announcements task flow (see Section 59.2.2).

By default, announcements in the Announcements - Quick View task flow show announcement titles as links. But you can configure the task flow to display only announcement titles, titles with some amount of content, or only content.

This section contains the following subsections:

- Section 59.2.3.1, "Viewing Announcements in the Quick View Task Flow"

- Section 59.2.3.2, "Managing Announcements in the Quick View Task Flow"

59.2.3.1 Viewing Announcements in the Quick View Task Flow

The Announcements - Quick View task flow provides a read-only view of announcements. To view announcements in an Announcements - Quick View task flow:

1. In the Announcements - Quick View task flow, click the announcement you want to view (Figure 59-15).

Figure 59-15 The Announcements - Quick View Task Flow

The announcement details display in the Announcement dialog (Figure 59-16). Similar to the announcement content displayed in the Announcements task flow, this dialog displays content with all the formatting that was applied to it

Figure 59-16 Announcement Accessed from Quick View Task Flow

2. Click Close to exit the dialog.

59.2.3.2 Managing Announcements in the Quick View Task Flow

You can manage announcements in the Announcements - Quick View task flow with the Announcement Manager. The Announcement Manager provides the functionality in the Announcements task flow.

Administrators can remove the link to the Announcement Manager. If your administrator allows this functionality, then you see the Open Announcement Manager icon (Figure 59-17). The Announcement Manager lets you create, edit, delete, mail, and link announcements.

Figure 59-17 Open Announcement Manager Icon

59.2.4 Sending Mail from an Announcement

Each announcement in the Announcements or Announcements - Quick View task flow has an associated Send Mail icon in its toolbar (Figure 59-18). Click the Send Mail icon to initiate a mail message containing the announcement text, location, author, and date it was created. This feature makes it easy for you to communicate interesting announcements to others.

Figure 59-18 Send Mail Icons on Announcement Headers

The WebCenter administrator determines the mail client to use with the Send Mail icon. If a local mail client was set, then a plain text message opens. If the WebCenter Mail service was set as the mail client, then the HTML Mail Compose dialog opens. With either mail client, you can add or edit the standard, prepopulated message before sending.

59.2.5 Linking Announcements

Each announcement in the Announcement Manager or Announcements task flow has an associated Links icon in its toolbar to link other objects to the announcement. For example, you can link an announcement to a new discussion, document, event, note or URL, or you can link an announcement to an existing announcement, discussion, document, or event.

The Links icon displays to all users accessing the Announcements and Announcement Manager task flows, if the Links service is configured in the application (Figure 59-19).

Figure 59-19 Links Icon with Announcements

For more information, see Chapter 63, "Working with the Links Service."

59.3 Setting Announcements Service Task Flow Properties

The Announcements service task flows have associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 59-20).

Figure 59-20 Announcements Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Announcements service task flows and describe the properties on the Parameters tab.

- Section 59.3.1, "What You Should Know About the Announcements Service Task Flow Properties"

- Section 59.3.2, "Announcements Service Task Flow Parameters"

59.3.1 What You Should Know About the Announcements Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 59.3.2, "Announcements Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

59.3.2 Announcements Service Task Flow Parameters

Table 59-2 describes the properties that are unique to the Announcements task flows.

Table 59-2 Announcements Service Task Flow Parameters

Parameter

Description

Task Flow

Expand All Announcements in Extended Mini View

Select to display details for all announcements in the extended quick view. The default value is unselected, in which case announcements display the announcement title only.

Announcements - Quick View

Number of Expanded Announcements

The number of announcements to display announcement details. Announcements exceeding this value display the announcement title only. Use only when Content View Only is unselected.

Express values using the following formats:

- Constant—Express a constant value, such as 2 or 5.

- Page parameter—Enter a page parameter to grab the value from the page on which the task flow is placed. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

- EL expression—The default. Enter an Expression Language (EL) expression.

Announcements - Quick View

Content View Only

Select to remove the announcement title and display just the announcement content. Leave unchecked to render the title.

When selected, the values for Announcement Length and Number of Expanded Announcements are ignored.

Announcements - Quick View

Hide Toolbar

Hides the Announcements toolbar.

Announcements - Quick View

Navigate to Announcement Viewer

Select to navigate to the announcement resource. Default behavior (unselected) is to launch in a popup.

Announcements - Quick View

Number of Announcements on Extended Mini View

The number of announcements to show in a page on extended mini view.

Announcements - Quick View

Forum ID

The ID of the forum under which announcements are created in the back-end discussions server.

In WebCenter Spaces, this property is blank by default. However, internally it maps to the forum ID associated with the current Space. For Home Spaces, global (system) announcements are returned. You can edit this property to specify a different forum ID.

Announcements - Quick View

Announcements

Announcement Length

The number of characters to show in announcement details. Use only when Content View Only is unselected.

If no value is specified, then WebCenter displays 200 characters.

This parameter takes effect with Number of Expanded Announcements.

Express values using the following formats:

- Constant—Express a constant value, such as 200 or 500.

- Page parameter—Enter a page parameter to grab the value from the page on which the task flow is placed. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

- EL expression—The default. Enter an Expression Language (EL) expression.

The value you enter for Announcement Length is ignored if Content View Only is selected.

Announcements - Quick View

Number of Announcements to Show

The number of announcements to show on the quick view.

Announcements - Quick View

60 Working with the Discussions Service

This chapter describes how to use the features provided through the Discussions service. The Discussions service provides a means of creating and participating in text-based discussions with other members of a Space. Use Discussions service task flows to create forums, post questions, and search for answers. Discussion forums additionally provide the means to preserve and revisit discussions.

This chapter includes the following sections:

- Section 60.1, "What You Should Know About the Discussions Service"

- Section 60.2, "Working with Discussions Service Task Flows"

- Section 60.3, "Setting Discussions Service Task Flow Properties"

Audience

This chapter is intended for WebCenter users who want to view, create, and manage Space discussion forums and topics. To perform discussion-related tasks, you must have appropriate permissions: Create, Edit, and Delete Discussions, Create and Edit Discussions, or View Discussions. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter are not available if the Discussions service is not enabled in the current Space.

60.1 What You Should Know About the Discussions Service

You can use the Discussions service to post, respond to, and preserve topical information in discussion forums scoped to Spaces or to entire applications. Users post topics to a discussion forum, and other users post information relevant to those topics. All of this information is preserved within the forum.

The back-end server that provides the Discussion service manages content in a hierarchy. At the top of the hierarchy are categories, below that are forums, and then topics. Where categories are exposed in your WebCenter application, authorized users can create multiple forums within a given scope and multiple topics under those forums. Where categories are not exposed, authorized users can create multiple topics under one forum within a given scope.

A new Space is assigned a single discussion forum by default. Space moderators can allocate multiple forums to a Space if required, as described in Section 6.2, "Configuring Discussion Forum Options for WebCenter Spaces."

In WebCenter Spaces, the Discussions service is scoped to Spaces. That is, you can create forums and topics only within the context of a Space. You can view and participate in discussions in both Spaces and Home Spaces, depending on your application permissions.

Access to discussions is influenced by application security. The WebCenter Spaces application is, by default, a secure application. Users can access discussions according to the permissions they are granted by their specific user roles within a given Space.

Scoping additionally limits the users who can view and participate in discussions. For example, only members of the Finance Space can view discussions that transpire in Finance Space forums.

To expose a discussion forum to a specific set of users, you must add just those users as members of the Space where you hold the forum (for more information, see Section 51.14.4, "Granting WebCenter Spaces Users Access to a Space"). To open a discussion to all users, you must create a publicly-accessible Space (for more information, see Section 51.14.5, "Granting Public Access to a Space").

Most Discussions service task flows provide configuration settings for specifying which forum content to show. This is of particular use in Home Spaces, which exist outside a specific Space scope (for more information, see Section 60.3, "Setting Discussions Service Task Flow Properties").

Note:

You can add a Discussions task flow to your page from the Catalog dialog in Oracle Composer. For information about adding a task flow, see Section 17.5, "Adding Resource Catalog Components to Pages."

However, all instances of the Discussions task flow in an application run against the same back end and it serves no purpose to add multiple Discussions task flow instances. This is true for all service task flows that require connections to back-end servers, for example, task flows from IMP, Announcements, and Mail services.

The Discussions service provides a wide variety of task flows for viewing and participating in discussions. These include:

- Discussion Forums provides controls for creating discussion forums; creating, replying to, and managing discussion forum topics; and selecting watched forums and watched topics (Figure 60-1).

Figure 60-1 Discussion Forums Task Flow

In WebCenter Spaces, the Discussion Forums task flow is additionally exposed on a Discussions page. You cannot add Discussion Forums to a Home Space.

- Discussions - Quick View provides a means of accessing all possible views of a particular Space's discussions: Recent Topics, Popular Topics, Watched Topics, and Watched Forums (Figure 60-2).

Figure 60-2 Discussions - Quick View

The Discussions - Quick View task flow also provides controls for determining the data to show in addition to the forum or topic title. Click the Edit icon (pencil) in the task flow toolbar to open the Display Settings dialog (Figure 60-3).

Figure 60-3 Display Settings Dialog

The available display settings vary according to the option currently selected on the task flow Display Options menu (Figure 60-4).

Figure 60-4 Display Options Menu (Discussions - Quick View)

For example, when Recent Topics is selected on the menu, the Display Settings dialog offers the options Author, Date, and Replies. When the task flow displays Watched Forums, the Display Settings dialog offers the options Date and Topics.

The Discussions - Quick View task flow is available for placement on any application page, regardless of whether the page is scoped to a Home Space or Space.

- Popular Topics (Figure 60-5) provides a look at the most frequently viewed discussion topics in all the discussion forums in a given Space.

Figure 60-5 Popular Topics Task Flow

The Popular Topics task flow also provides controls for determining the data to show in addition to the topic title. Click the Personalize icon in the task flow header to open a panel with controls for selecting the type of additional data to show (Figure 60-6).

Figure 60-6 Show Panel in a Popular Topics Task Flow

The Popular Topics task flow is available for placement on any application page, regardless of whether the page is scoped to a Home Space or Space.

- Recent Topics (Figure 60-7) provides a look at the most recently accessed discussion topics in all the discussion forums in a given Space.

Figure 60-7 Recent Topics Task Flow

Access to Space discussion topics is restricted to those Spaces of which you are a member.

The Recent Topics task flow also provides controls for determining the data to show in addition to the topic title. Click the Personalize icon in the task flow header (Figure 60-8) to open a panel with controls for selecting the type of additional data to show.

Figure 60-8 Show Panel in a Recent Topics Task Flow

The Recent Topics task flow is available for placement on any application page, regardless of whether the page is scoped to a Home Space or Space.

- Watched Forums (Figure 60-9) provides a means of viewing all discussion forums you have selected to watch from a particular Space or from all Spaces.

Figure 60-9 Watched Forums Task Flow

The Watched Forums task flow also provides controls for determining the data to show with the topic title. Click the Personalize icon in the task flow header (Figure 60-10) to open a panel with controls for specifying the type of additional data to show. See Section 60.2.6, "Watching Forums and Topics."

Figure 60-10 Show Panel in a Watched Forums Task Flow

The Watched Forums task flow is available for placement on any application page, regardless of whether the page is scoped to a Home Space or Space.

- Watched Topics (Figure 60-11) provides a cohesive view of all the topics you have selected to watch from a particular Space or from all Spaces.

Figure 60-11 Watched Topics Task Flow

The Watched Topics task flow also provides controls for determining the data to show with the topic title. Click the Personalize icon in the task flow header (Figure 60-12) to open a panel with controls for specifying the type of additional data to show. See Section 60.2.6, "Watching Forums and Topics."

Figure 60-12 Show Panel in a Watched Topics Task Flow

The Watched Topics task flow is available for placement on any application page, regardless of whether the page is scoped to a Home Space or Space.

Note:

All instances of the Mail task flow in an application run against the same mail server and it serves no purpose to add multiple Mail task flow instances. This is true for all service task flows that require connections to back-end servers, for example, task flows from Announcements, Mail, and IMP services.

The Discussions service is tightly integrated with other WebCenter services, such as Links and Mail. For example, all mail sent to a Space distribution list can additionally be posted to that Space's default discussion forum. The Space moderator must choose Monitor Incoming Mail in the Space settings for the Discussions service (see Section 51.10.4, "Publishing Space Mail in a Discussion Forum"). Every discussion topic provides the opportunity to link from the topic to another Space item, such as a document or an announcement. (For information about the Mail service, see Chapter 65, "Working with the Mail Service." For information about the Links service, see Chapter 63, "Working with the Links Service.")

60.2 Working with Discussions Service Task Flows

The Discussions service task flows expose all of the functionality available from the Discussions service. The Discussion Forums is the most feature-rich task flow, providing controls for creating and managing discussion forums and posting and managing discussion topics and replies. The other task flows are useful windows into discussion forum content. They provide different views of the discussion forums and topics available to a particular Space or all Spaces.

Note:

For information about configuring a Discussions service task flow to display the discussions from a particular Space or from all Spaces, see Section 60.3, "Setting Discussions Service Task Flow Properties."

Most of the subsections in this section describe tasks you can accomplish through the Discussion Forums task flow. When you can use other task flows to perform the described actions, this is noted.

This section contains the following subsections:

- Section 60.2.1, "Adding a Discussions Service Task Flow to a Page"

- Section 60.2.2, "Creating a Discussion Forum"

- Section 60.2.3, "Editing the Forum Name and Description"

- Section 60.2.4, "Creating and Managing Forum Topics and Replies"

- Section 60.2.5, "Showing and Hiding Additional Discussion Forum Information"

- Section 60.2.6, "Watching Forums and Topics"

- Section 60.2.7, "Sending Mail from Discussion Topics"

60.2.1 Adding a Discussions Service Task Flow to a Page

To add a Discussions service task flow to a page in a WebCenter Spaces application:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that provides access to the discussions task flows.

Tip:

The presence or location of this section depends on how the Resource Catalog is configured. In the default Resource Catalog, next to Social and Communication, click Open.

Figure 60-13 Opening the Discussions Section in the Resource Catalog

4. Click Add next to the task flow that you want to add to your page.

Note:

Not all discussions task flows are not available in the default Oracle Composer Resource Catalog, so you will only see entries for these task flows if they have been added to the Resource Catalog that has been made available to the page.

For more information, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Task Flows, then scroll to Discussions for a list of all available content task flows.

60.2.2 Creating a Discussion Forum

Create discussion forums on the Discussions page or with the Discussion Forums task flow.

To create forums in WebCenter Spaces, you must be the Space moderator.

Note:

A new Space is assigned a single discussion forum by default. Space moderators can allocate multiple forums to a Space if required, as described in Section 6.2, "Configuring Discussion Forum Options for WebCenter Spaces."

To create a discussion forum:

1. Go to the Discussions page. If multiple forums have been enabled, then you see a Forums link pointing to the default forum (Figure 60-14).

Figure 60-14 Discussions Page with Multiple Forums Enabled

2. Click the Forum link, and then the Create Forum button (Figure 60-15).

Figure 60-15 Create Forum

The Create Forum dialog opens (Figure 60-16).

Figure 60-16 The Create Forum Dialog

3. In the Forum Name field, enter a name for the discussion forum.

Enter up to 255 characters.

4. Optionally, in the Forum Description text box, enter a description of the discussion forum.

Enter up to 4000 characters.

5. Click Create.

The new forum appears on the list of forums (Figure 60-17). Click a forum name to view forum content.

Figure 60-17 New Discussion Forum (May Service Requests)

60.2.3 Editing the Forum Name and Description

To rename a discussion forum or revise its description:

1. Go to the Discussions page or the Discussions Forums task flow, and click the forum you want to edit (Figure 60-18).

Figure 60-18 Edit Forum Link

The Edit Forum dialog opens (Figure 60-19).

Figure 60-19 The Edit Forum Dialog

2. Optionally, in the Forum Name field enter a new name for the discussion forum.

Enter up to 255 characters.

3. Optionally, in the Forum Description text box, revise the description of the discussion forum.

Enter up to 4000 characters.

4. Click Save.

60.2.4 Creating and Managing Forum Topics and Replies

The life of a discussion forum takes place in its topics and replies. There users can ask questions, post information, exchange ideas, and otherwise communicate in interesting and useful ways.

This section describes how to work with discussion forum topics and replies. It contains the following subsections:

- Section 60.2.4.1, "Posting a New Forum Topic"

- Section 60.2.4.2, "Replying to Topic Posts"

- Section 60.2.4.3, "Viewing Topic Posts and Replies"

- Section 60.2.4.4, "Editing Topics and Replies"

- Section 60.2.4.5, "Deleting Topic Posts and Replies"

- Section 60.2.4.6, "Switching Between Topic View Modes"

60.2.4.1 Posting a New Forum Topic

When you consider discussion forums hierarchically, the forum is the top container and forum topics are the next level down. Each posted topic additionally has subordinate replies, and the replies themselves may have replies (Figure 60-20).

Figure 60-20 A Posted Topic and a Reply to the Topic

This section describes how to post forum topics using the Discussion Forums task flow. For information about replying to a posted topic, see Section 60.2.4.2, "Replying to Topic Posts."

To post a topic under a discussion forum:

1. Go to the Discussion Forums task flow in which to post a topic., and click Create Topic (Figure 60-21).

Figure 60-21 Create Topic

The Create Topic dialog opens (Figure 60-22).

Figure 60-22 The Create Topic Dialog

2. In the Subject field, enter the topic subject.

Enter up to 255 characters.

3. In the Message field, enter your post about the topic.

Enter up to 4000 characters.

4. Click Create.

The newly-posted topic appears under the selected forum in Discussion Forums. Click the topic subject to view the message (Figure 60-23).

Figure 60-23 A New Discussion Forum Topic

60.2.4.2 Replying to Topic Posts

This section describes how to reply to topic posts through the Discussion Forums, though you can reply to a topic post through any other Discussions service task flow.

By default, the Discussion Forums task flow is exposed as the Discussions page in Spaces.

To reply to topic posts:

1. Go to the Discussions task flow in which to read and reply to topic posts, and click the relevant topic (Figure 60-24).

Figure 60-24 Discussion Forums Topic

The selected topic opens.

2. Click Reply Topic (Figure 60-25).

Figure 60-25 Reply Topic

The Reply Topic dialog opens (Figure 60-26).

Figure 60-26 The Reply Topic Dialog

3. In the Subject field, either leave the text as is or revise it.

Enter up to 255 characters.

4. In the Message text box, enter your reply to the topic.

Enter up to 4000 characters.

5. Click Reply.

Your reply appears below the main topic post (Figure 60-27).

Figure 60-27 A Topic Post and a Reply

To post a reply to a reply, click the Reply to message icon (Figure 60-28) and follow the steps described in this section (starting with step 5).

Figure 60-28 Reply to message Icon

60.2.4.3 Viewing Topic Posts and Replies

With the Discussion Forums task flow, topics and replies to the topic open directly in the Discussions Forums task flow. To navigate back up the forum hierarchy, click the breadcrumbs that display above the topic reply area (Figure 60-29).

Figure 60-29 Forum Breadcrumbs

With all the other Discussions service task flows, topics open in a separate window (Figure 60-30).

Figure 60-30 Viewing a Topic in the Discussions - Popular Topics Task Flow

To return to the task flow main view, click Close button in the window.

60.2.4.4 Editing Topics and Replies

After you post a topic or a reply, you retain the option of returning to it and revising its content. Only you and Space moderators can edit your replies. This section describes how.

To edit a topic or a reply:

1. Go the Discussion Forums task flow that displays the topic or reply you want to edit, and click the relevant topic.

The selected topic opens.

2. Your next step depends on whether you want to edit a topic or a reply:

- To edit the topic, click the Edit Topic link at the top of the topic screen (Figure 60-31).

Figure 60-31 Edit Topic Link

- To edit a reply, click the Edit message icon (pencil) associated with the reply (Figure 60-32).

Figure 60-32 Edit message Icon

The Edit Topic (or Edit Message) dialog opens (Figure 60-33).

Figure 60-33 The Edit Topic Dialog

3. Revise the topic (up to 255 characters) or reply (up to 4000 characters).

4. Click Edit in the Edit Topic dialog, or click Reply in the Edit Reply dialog.

Your changes are posted to the forum.

60.2.4.5 Deleting Topic Posts and Replies

When you delete a topic, the original topic post and all of its subordinate replies are deleted. When you delete a reply, the original reply and all of its subordinate replies are deleted. Both actions involve very similar steps, which are described in this section.

Note:

To delete a topic post or reply, you must have created it or you must have access equivalent to Space moderator.

To delete a topic or a reply:

1. Go to the Discussion Forums task flow that displays the topic or reply you want to delete, and click the relevant topic (Figure 60-34).

Figure 60-34 Discussion Forum Topic

The selected topic opens.

2. Your next step depends on whether you want to delete a topic or a reply:

- To delete a topic, click the Delete Topic link at the top of the topic screen (Figure 60-35).

Figure 60-35 Delete Topic Link

- To delete a reply, click the Delete message icon associated with the reply (Figure 60-36).

Figure 60-36 Delete Message Icon

A Delete confirmation dialog opens (Figure 60-37).

Figure 60-37 The Delete Confirmation Dialog

3. Click Delete.

The topic and all of its replies or the reply and all of its subordinate replies are deleted.

60.2.4.6 Switching Between Topic View Modes

You have the option of viewing a topic and all of its replies in a hierarchical, indented mode or a flat, unindented mode. The hierarchical mode (Figure 60-38) uses indenting to indicate whether a reply is to the topic or to another reply.

Figure 60-38 Hierarchical View Mode

For example, in Figure 60-38 the first entry is the main topic, the second is a reply to the topic, and so on.

The flat mode (Figure 60-39) makes no such distinctions.

Figure 60-39 Flat View Mode

All Discussion task flows that show topics and replies in the same screen provide view mode options.

To switch between topic view modes:

1. Go to the Discussions task flow that contains the topic you want to view, and click the topic.

2. From the Show dropdown list, choose either Flat or Hierarchical.

The topic view rerenders according to your selection.

60.2.5 Showing and Hiding Additional Discussion Forum Information

Most discussions task flows provide personalization settings for determining information to show in addition to the forum or topic title (the Discussion Forums task flow does not provide such settings). Additional information can include forum or topic author, creation date, and replies or topics.

How you set these display settings is personal, affecting only your view of a task flow instance. How you access these display settings varies slightly from task flow to task flow.

This section describes how to configure display settings for Discussions service task flows. It contains the following subsections:

- Section 60.2.5.1, "Showing or Hiding Information in the Discussions - Quick View Task Flow"

- Section 60.2.5.2, "Showing or Hiding Information in the Popular Topics Task Flow"

- Section 60.2.5.3, "Showing or Hiding Information in the Recent Topics Task Flow"

- Section 60.2.5.4, "Showing or Hiding Information in the Watched Forums Task Flow"

- Section 60.2.5.5, "Showing or Hiding Information in the Watched Topics Task Flow"

60.2.5.1 Showing or Hiding Information in the Discussions - Quick View Task Flow

To show or hide additional information in the Discussions - Quick View task flow:

1. Go to the Discussions - Quick View task flow where you want to configure display settings.

2. Click the Select the data to display icon in the task flow toolbar (Figure 60-40).

Figure 60-40 Select the data to display Icon in the Discussions - Quick View Task Flow

The Display Settings dialog opens (Figure 60-41).

Figure 60-41 Display Settings Dialog

3. Choose the data you want to show, or clear the checkbox of data you want to hide. Choose or clear one or more from:

- Author—The user name of the person who created the forum or topic

- Date—The date the forum or topic was last updated

- Replies—The replies associated with the topic (for Watched Forums, this displays forums)

4. Click Save to save your changes and close the dialog.

60.2.5.2 Showing or Hiding Information in the Popular Topics Task Flow

To show or hide additional information in the Popular Topics task flow:

1. Go to the Popular Topics task flow where you want to show or hide additional information.

2. Click the Personalize icon in the task flow header.

This opens a panel where you can choose or clear additional data (Figure 60-42).

Figure 60-42 Show Panel in a Popular Topics Task Flow

3. Choose the data you want to show, or clear the checkbox of data you want to hide. Choose or clear one or more from:

- Author—The user name of the person who posted the topic

- Date—The date the topic was last updated

- Replies—The replies associated with the topic

4. Click Save to save your changes and close the panel.

60.2.5.3 Showing or Hiding Information in the Recent Topics Task Flow

To show or hide additional information in the Recent Topics task flow:

1. Go to the Recent Topics task flow where you want to show or hide additional information.

2. Click the Personalize icon in the task flow header.

This opens a panel where you can choose or clear additional data (Figure 60-43).

Figure 60-43 Show Panel in a Recent Topics Task Flow

3. Choose the data you want to show, or clear the checkbox of data you want to hide. Choose or clear one or more from:

- Author—The user name of the person who posted the topic

- Date—The date the topic was last updated

- Replies—The replies associated with the topic

4. Click Save to save your changes and close the panel.

60.2.5.4 Showing or Hiding Information in the Watched Forums Task Flow

To show or hide additional information in the Watched Forums task flow:

1. Go to the Watched Forums task flow where you want to show or hide additional information.

2. Click the Personalize (pencil) icon in the task flow header.

This opens a panel where you can choose or clear additional data (Figure 60-44).

Figure 60-44 Show Panel in a Watched Forums Task Flow

3. Choose the data you want to show, or clear the checkbox of the data you want to hide. Choose or clear one or more from:

- Date—The date the forum was last updated

- Topics—The topics associated with the forum

4. Click Save to save your changes and close the panel.

60.2.5.5 Showing or Hiding Information in the Watched Topics Task Flow

To show or hide additional information in the Watched Topics task flow:

1. Go to the Watched Topics task flow where you want to show or hide additional information.

2. Click the Personalize icon in the task flow header.

This opens a panel where you can choose or clear additional data (Figure 60-45).

Figure 60-45 Show Panel in a Watched Topics Task Flow

3. Choose the data you want to show, or clear the checkbox of the data you want to hide. Choose or clear one or more from:

- Author—The user name of the person who posted the topic

- Date—The date the topic was last updated

- Replies—The replies associated with the topic

4. Click Save to save your changes and close the panel.

60.2.6 Watching Forums and Topics

Watching discussion forums and topics provides a convenient means of keeping a close eye on the information most current and relevant to your efforts. The forums and topics you choose to watch are personal, in that your selections appear on your view of watch lists. No other user is affected by the forums and topics you choose to watch.

When a user places a watch on a forum or a topic, whenever users add to that forum or topic, in addition to it appearing in the user's watched forums or topics list, the user receives a mail notification.

In WebCenter Spaces, all watched forums and topics are accessible from the Discussions panel in the quick view. All watched forums and topics are accessible from the Forums task flow. The Watched Forums and Watched Topics task flows provide more focussed views of watched forums or watched topics.

This section includes information about how to add, view, and manage watched topics and forums. It contains the following subsections:

- Section 60.2.6.1, "Adding a Discussion Forum or Topic to Your Watch List"

- Section 60.2.6.2, "Removing a Discussion Forum or Topic from a Watch List"

- Section 60.2.6.3, "Viewing Watched Forums and Topics from the Quick View"

60.2.6.1 Adding a Discussion Forum or Topic to Your Watch List

To add a discussion forum or topic to your watch list:

1. Go to the discussion forum or topic you want to add to your watch list.

2. The next step depends on whether you want to watch a forum or a topic:

- To watch a forum, click the Watch Forum link at the top of the forum (Figure 60-46).

Figure 60-46 Watch Forum Link on the May - June Service Requests Forum

- To watch a topic, click the Watch Topic link at the top of the topic (Figure 60-47).

Figure 60-47 Watch Topic Link on the Topic Dropped calls around Sacramento

The watched forum or topic is listed on all Watched Forums or Watched Topics lists, for example, on the Discussions panel in the WebCenter Spaces quick view (Figure 60-48) and in Watched Forums and Watched Topics task flows.

Figure 60-48 Watched Forums on the Discussions Panel in the Quick View

60.2.6.2 Removing a Discussion Forum or Topic from a Watch List

To remove a discussion forum or a discussion topic from your watch list:

1. Go to the discussion forum or topic you want to remove from your watch list.

2. Click the Remove Watch icon on the forum or topic (Figure 60-49).

Figure 60-49 The Remove Watch Icon

The selected item is removed from your forum or topic watch list.

60.2.6.3 Viewing Watched Forums and Topics from the Quick View

To view a watched forum or topic from the Quick View:

1. From the Discussions - Quick View task flow, set the panel display option to Watched Forums or Watched Topics (Figure 60-50).

Figure 60-50 Watched Forums on the Discussions - Quick View

2. Click the link to the discussion forum or forum topic you want to view.

The forum or topic opens (Figure 60-51).

Figure 60-51 A Watched Forum Opened from the Quick View

60.2.7 Sending Mail from Discussion Topics

Each discussion topic in has an associated Send Mail icon in its toolbar (Figure 60-52). Click the Send Mail icon to initiate a mail message containing the discussion text, location, author, and date it was created. This feature makes it easy for you to communicate interesting discussions to others.

Figure 60-52 Send Mail Icons on Discussion Topics

The WebCenter administrator determines the mail client to use with the Send Mail icon. If a local mail client was set, then a plain text message opens. If the WebCenter Mail service was set as the mail client, then the HTML Mail Compose dialog opens. With either mail client, you can add or edit the standard, perpetuated message before sending.

60.3 Setting Discussions Service Task Flow Properties

The Discussions service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 60-53).

Figure 60-53 Forums Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Discussions service task flows and describe the properties on the Parameters tab.

- Section 60.3.1, "What You Should Know About the Discussions Service Task Flow Properties"

- Section 60.3.2, "Discussions Service Task Flow Parameters"

60.3.1 What You Should Know About the Discussions Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 60.3.2, "Discussions Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

60.3.2 Discussions Service Task Flow Parameters

Table 60-1 describes the properties that are unique to the Discussions task flows.

Table 60-1 Discussions Service Task Flow Parameters

Parameter

Description

Task Flow

Category ID

On the discussions server, the category ID under which a given set of forums is managed

For the Forums task flow, use this parameter to specify the set of forums to present. For all other discussions task flows, use this parameter to specify the parent ID of the topics to show by default.

If omitted, the value defaults to the Category ID associated with the current Space. In Home Spaces, it takes the root Category ID.

Use the following EL expression to return the Category ID of a named Space:

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['SpaceName'].categoryId}

Enter the Space internal name (not the Space display name) for the variable SpaceName. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the Space banner at the top of the Space.

- Forums

- Discussions - Quick View

- Popular Topics

- Recent Topics

- Watched Forums

- Watched Topics

Forum ID

On the discussions server, the identifier under which topics are managed

Use this parameter to identify the default forum to show in the task flow.

Use the following EL expression to return the forum ID of a named Space:

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['SpaceName'].forumId}

Enter the Space internal name (not the Space display name) for the variable SpaceName. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the Space banner at the top of the Space.

- Popular Topics

- Recent Topics

- Watched Topics

Hide Toolbar

A means of showing or hiding the task flow personalization feature (see Section 60.2.5, "Showing and Hiding Additional Discussion Forum Information")

- true means you want to hide the task flow personalization feature available.

- false means you want to show the task flow personalization feature. This is the default value.

- Popular Topics

- Recent Topics

- Watched Forums

- Watched Topics

Show Recursive Forums

Determines if you show forums either in a category only or in subcategories.

- true means all forums under a given category/subcategory are shown.

- false means only the category's direct child forums are shown. This is the default value.

Note: A value of true can impact performance.

Forums

Show Categories

A means of showing the forums grouped under the Category ID or the topics specified under the Forum ID.

- true means you want the task flow to display the forums classified under Category ID.

- false means you want the task flow to display the topics associated with the specified Forum ID. This is the default value.

This parameter value works in combination with other parameters.

Forums

61 Working with the Events Service

The Events service provides calendars that you can use to schedule meetings, appointments, and any other type of occasion. A dedicated Events page is available to every Space where the Space's moderator has enabled the Events service.

The Events service also enables you to view your own personal Microsoft Exchange calendar within your Home Space. In addition, you can overlay Space calendars on top of that calendar, so that you can view your entire schedule in a single calendar.

WebCenter Portal Applications:

The Events service is also available in WebCenter portal applications to provide access to users' personal calendars.

This chapter explores the features offered through the Events service. It contains the following sections:

- Section 61.1, "What You Should Know About the Events Service"

- Section 61.2, "Working with Events Service Task Flows"

- Section 61.3, "Setting Events Service Task Flow Properties"

Audience

This chapter is intended for WebCenter Spaces users who want to use Events service task flows to schedule and track events. Users with a Space role that includes the permissions Create, Edit, and Delete Events (for event-related tasks), Edit Pages (to add the Events task flow to a page), and Edit Task Flows (to enable calendar overlays). For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter are not available if the Events service is not enabled in the current Space.

61.1 What You Should Know About the Events Service

Events include appointments, meetings, presentations, and so on. Within WebCenter Spaces, there are two kinds of events:

- Personal Events are those that concern only you. They could include things like dentist appointments or lunch with a friend.

Personal Events come from your Microsoft Exchange calendar and display only to you and only in Events task flows that are located on pages in your Home Space.

WebCenter Portal Applications:

Personal Events are also available in WebCenter portal applications.

- Space Events are those that are related to a specific Space. They could include weekly meetings or presentations.

Space Events display to all members of the Space on the Space's dedicated Events page or in any Events task flow that is located on a page in the Space. Members with the required level of permission can schedule or update events.

WebCenter Portal Applications:

Space Events are not available in WebCenter portal applications.

Note:

If your application uses WebCenter's default user roles, then the required permissions to create an event are included in both the participant and moderator roles. Participants and Moderators can manage all events.

61.1.1 Calendar Overlaying

In addition to displaying your personal Microsoft Exchange calendar, in the Events task flow in your Home Space you can overlay your personal calendar with events from significant Spaces. In this way, you can have all your important events available in one location, rather than having to go to multiple Spaces to manage your daily schedule. In a Space, if you can create a page and add an Events task flow to it, you can also extend that task flow to display events from other Spaces. This is useful if some Spaces are very closely connected with similar membership lists.

Note:

The Events page displays only Space Events from the current Space.

61.1.2 Where to View Events

Your application may provide a variety of locations from which to view events.

- You can add the Events task flow to any page in a Space (Figure 61-1).

Figure 61-1 An Events Task Flow on a Space Page

- Every Space includes an Events page (a page with the Events calendar task flow) that can be displayed or hidden. If you cannot see the Events page, it could be hidden. For information about how to show it, see Section 61.2.3.1, "Displaying the Events Page for a Space."

- You can also add the Events task flow to a page in your Home Space. In a Home Space, the task flow does not initially display the calendar of events. Instead it displays a link prompting you to Login to Personal Calendar (Figure 61-2). For information about logging in to your Microsoft Exchange calendar, see Section 61.2.2, "Accessing Your Personal Microsoft Exchange Calendar."

Figure 61-2 Events Task Flow in Home Space Before Logging In

If you do not have a Microsoft Exchange calendar, or do not want to display Personal Events, but still want to view Space Events in your Home Space, enable calendar overlaying and then click Continue (Figure 61-3). For information about calendar overlaying, see Section 61.2.8, "Displaying Multiple Calendars in a Single Task Flow."

Figure 61-3 Events Task Flow in Home Space with Calendar Overlay Enabled

61.1.3 Integration with Other Services

Through its tight integration with the Links service, the Events service provides the opportunity to associate events with other WebCenter Spaces items. Linking enables you to associate documents, notes, announcements, discussions, and URLs with an event. You can create links from an event by editing the event and clicking the Links icon. For more information, see Chapter 63, "Working with the Links Service."

The Events service also enables you to send email about an event to members of the Space. You can send mail from an event by editing the event and clicking the Send Mail icon. For more information, see Chapter 6, "Configuring Send Mail Notifications for WebCenter Spaces."

61.2 Working with Events Service Task Flows

Meetings are a fact of life. The art is in keeping on top of all those meetings, making sure you can attend all those that matter and keep abreast of what is going on.

Note:

The steps in the following sections apply to both Personal Events and Space Events. Where there are any differences, these are noted.

This section includes the following subsections:

- Section 61.2.1, "Adding an Events Service Task Flow to a Page"

- Section 61.2.2, "Accessing Your Personal Microsoft Exchange Calendar"

- Section 61.2.3, "Viewing Events"

- Section 61.2.4, "Scheduling Events"

- Section 61.2.5, "Viewing Event Details"

- Section 61.2.6, "Revising Scheduled Events"

- Section 61.2.7, "Cancelling Scheduled Events"

- Section 61.2.8, "Displaying Multiple Calendars in a Single Task Flow"

61.2.1 Adding an Events Service Task Flow to a Page

To add an Events service task flow to a page:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that contains the Events service task flows or search for the task flow.

Tip:

The presence or location of this component depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, next to Social and Communication, click Open to expose a list that includes the Events service task flows.

4. Click Add next to the task flow that you want to add to your page.

61.2.2 Accessing Your Personal Microsoft Exchange Calendar

You may maintain a calendar of events outside of WebCenter Spaces that does not relate to specific Spaces. If you use Microsoft Exchange 2003 or 2007 for this calendar, you can include the information in your WebCenter Spaces Home Space. This keeps all your calendar information in a single place, making it much easier for you to organize your day.

You can view your Exchange calendar in your Home Space. You can also edit or delete those events or create new Personal Events that are pushed to your Exchange calendar.

Note:

You can use calendar overlaying to display Space Events alongside Personal Events in your Home Space, but you cannot push Space Events into your Exchange calendar.

For more information about calendar overlaying, see Section 61.2.8, "Displaying Multiple Calendars in a Single Task Flow."

Before You Begin

Before you can access your Microsoft Exchange calendar in WebCenter Spaces, your administrator must have created a connection to the Microsoft Exchange Server. For more information, see the chapter “Managing the Events Service” in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

To access your Microsoft Exchange calendar:

1. In your Home Space, locate the page where you want to add your Microsoft Exchange calendar.

2. Edit the page and add the Events task flow to the appropriate region on the page.

For more detailed information, see Section 61.2.1, "Adding an Events Service Task Flow to a Page."

3. Click Save and then Close.

4. In the Events task flow, click Login to Personal Calendar.

Note:

If you see the link Try Again instead of Login to Personal Calendar, there is a problem with the connection to the Microsoft Exchange Server. Contact your administrator.

5. Enter your Microsoft Exchange login credentials and click OK.

Figure 61-4 Personal Calendar

61.2.3 Viewing Events

You can view events as a grid or a list; choose to display events a day, a week, or a month at a time; select the range of hours displayed per day; and include a second time zone in the display.

This section includes the following subsections:

- Section 61.2.3.1, "Displaying the Events Page for a Space"

- Section 61.2.3.2, "Displaying Events by Day, Week, or Month or as a List"

- Section 61.2.3.3, "Viewing Events for a Specific Date"

- Section 61.2.3.4, "Refreshing Your View of Events"

- Section 61.2.3.5, "Setting Display Preferences"

61.2.3.1 Displaying the Events Page for a Space

In every Space, Space Events display on the Events page. However, the Events page may not display by default. If so, it is easy to display the Events page using the Manage Pages dialog.

Note:

Home Spaces do not have an Events page.

To display the Events page:

1. Go to the Space where you want to display the Events page.

2. From the Page Actions menu, choose Manage, then Pages (Figure 61-5).

Figure 61-5 The Manage Pages Command

3. On the Pages page, select the Show Page checkbox for the Events page. (Figure 61-6).

Figure 61-6 Showing the Events Page through the Pages Page

4. In the Space, there is now a link to the Events page (Figure 61-7).

Figure 61-7 The Events Tab for a Space

5. If you later decide that you no longer want to display the Events page, from the Page Actions menu, choose Manage, then Pages, and uncheck the Show Page checkbox fro the Events page.

61.2.3.2 Displaying Events by Day, Week, or Month or as a List

You can use icons on the Events task flow or Events page toolbar to display events in grid form or in list form (Figure 61-8).

Figure 61-8 Calendar Layout Icons in the Events Toolbar

When you display events as a grid, you can display events by day, week, or month. When you display events as a list, the number of upcoming events listed depends on the display options for the task flow (for more information, see Section 61.2.3.5, "Setting Display Preferences.")

To display events by day, week, or month or as a list:

1. Go to the Events task flow (or Events page) where you want to view events.

If the Events page is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. On the toolbar:

- Click the Day icon to display the calendar one day at a time (Figure 61-9).

Figure 61-9 Events Displayed by Day

- Click the Week icon to display the calendar for the whole week (Figure 61-10).

Figure 61-10 Events Displayed by Week

- Click the Month icon to display the calendar for the whole month (Figure 61-11).

Figure 61-11 Events Displayed by Month

- Click the List icon to display a list of upcoming events (Figure 61-12).

Figure 61-12 Events Displayed as a List

The calendar refreshes and appears in the selected mode.

61.2.3.3 Viewing Events for a Specific Date

Usually, in grid mode, the Events page or Events task flow displays events for the current day, week, or month. To view events for a specific point in time, you can use the previous or next buttons or select a date so that the calendar displays events for a specific date.

To select a date:

1. Go to the Events task flow (or Events page) where you want to view events.

If the Events page is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. On the toolbar, click the Previous or Next icon until the appropriate date is displayed.

In Day view, this displays the previous or next day. In Week view, this displays the previous or next week. In Month view, this displays the previous or next month. In List view, this displays the previous or next number of days as specified in the Display Preferences.

Note:

For information on the Display Preferences for List view, see Section 61.2.3.5.3, "Configuring List View."

3. If you know the specific date for which you want to view events, on the toolbar, click the Select Date icon (Figure 61-13).

Figure 61-13 The Select Date Icon

The date picker opens (Figure 61-14). Today's date is boxed, and the currently selected date (which may also be today's date) is highlighted. For example, in Figure 61-14, today's date is the 11th and the selected date is the 15th.

Figure 61-14 The Date Picker

Note:

If the calendar overlay feature is enabled in Full mode for the task flow, the Date Picker is always visible to the left of the calendar.

4. Use the date picker to select the month, year, and day.

For example, select a month from the dropdown list; select a year using the controls to the right of the current year, or enter the value yourself; click a date to select a day. Once you select a day, the date picker closes and the calendar shows events for that date.

5. To quickly return to today's date, click the Today button.

61.2.3.4 Refreshing Your View of Events

The Events task flow and Events page include a Refresh icon that you can use to refresh your calendar (Figure 61-15).

Figure 61-15 The Refresh Icon

This is useful for updating your view of the calendar with any recent changes made by other users. Click the Refresh icon and the calendar redraws, reflecting recent changes.

61.2.3.5 Setting Display Preferences

Events service display preferences:

- Determine the earliest time displayed on the calendar when events are viewed by day or week.

- Identify a secondary time zone.

- Specify how to display events in List view: by day, week, month, or for a specified number of days.

You set these preferences in the Display Preferences dialog (Figure 61-16).

Figure 61-16 The Events Display Preferences Dialog

This section includes the following subsections:

- Section 61.2.3.5.1, "Setting the Calendar Start Time"

- Section 61.2.3.5.2, "Setting a Secondary Time Zone"

- Section 61.2.3.5.3, "Configuring List View"

61.2.3.5.1 Setting the Calendar Start Time

In Day and Week view, the calendar grid is divided into hours. If vertical space for your calendar is limited, you can specify the earliest hour to display on the calendar grid to save space. If the space available is big enough to display hours from before the specified start time up until 11PM, it does so.

To set the calendar start time:

1. Go to the Events task flow (or Events page) where you want to set the calendar start time.

If the Events tab is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Click the Set time display preferences icon on the toolbar (Figure 61-17).

Figure 61-17 The Set Display Preferences Icon

3. In the Display Preferences dialog (Figure 61-16), from the Start Time dropdown list, select the earliest hour to display on the grid.

Choose from 12AM to 11PM.

4. Click OK to save your changes.

61.2.3.5.2 Setting a Secondary Time Zone

In these days of distributed workforces, it is not unusual to be working in teams with members in different locations. When scheduling meetings, it is useful to know the hours most optimal to all invitees. To make this easier, you can specify a secondary time zone to see what time a meeting is in that time zone as well as your own.

When you hover your mouse over an event, the event details popup shows the time of the meeting in your time zone and in the secondary time zone (Figure 61-18).

Figure 61-18 An Event Details Popup Displaying Primary and Secondary Time Zones

To set a secondary time zone:

1. Go to the Events task flow (or Events page) where you want to set time display preferences.

If the Events tab is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Click the Set time display preferences icon on the toolbar (Figure 61-19).

Figure 61-19 The Set Time Display Preferences Icon

3. In the Display Preferences dialog (Figure 61-16), from the Secondary Time Zone dropdown list select a secondary time zone to display along with the primary time zone.

4. Click OK to save your changes.

61.2.3.5.3 Configuring List View

You you can specify how you want to display events, when the calendar is displayed in List view. You can display events by day, week, month, or for a specified number of days.

To configure List view:

1. Go to the Events task flow (or Events page) where you want to set time display preferences.

If the Events tab is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Click the Set time display preferences icon on the toolbar (Figure 61-20).

Figure 61-20 The Set Time Display Preferences Icon

3. In the Display Preferences dialog, from the List Type list, choose how you want to display events in List view:

- Day Count—List all upcoming events for a specified number of days.

- Day—List all upcoming events for the currently selected day.

- Week—List all upcoming events for the currently selected week.

- Month—List all upcoming events for the currently selected month.

4. If you selected Day Count in the previous step, in the List Count field, specify the number of days for which you want to display events. The default is 14.

5. Click OK to save your changes.

61.2.4 Scheduling Events

You can schedule Space Events and Personal Events. When you schedule a Personal Event, the details are pushed to your Microsoft Exchange calendar.

To schedule an event:

1. Go to the Events task flow (or Events page) where you want to schedule an event.

If the Events tab is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Click the Create a new event icon on the toolbar (Figure 61-21).

Figure 61-21 The Create a New Event Icon

The Create Event dialog opens (Figure 61-22). The fields in the Create Event dialog are slightly different depending on whether you are creating a Personal Event or a Space Event. For Space Events, the dialog includes a Category dropdown list; for Personal Events, the dialog includes a Private checkbox. These options are described in further detail later in this procedure.

Note:

You can also easily invoke the Create Event dialog in grid view by double-clicking an empty space or right-clicking an empty space and choosing Create. The advantage of this is that the date and time of the event are automatically specified in the dialog.

Figure 61-22 The Create Event Dialog Invoked from a Space

3. In the Title field, enter a brief descriptive title for the event.

For example, Project Update.

4. In the Location field, enter the location of the event.

For example, Conference Room 5.

5. From the Calendar dropdown list, select the calendar against which you want to create the event.

If you do not have the calendar overlay feature enabled, there is only one option in this list: the calendar for the current Space or Home Space (depending on where you are creating the event). For more information about calendar overlays, see Section 61.2.8, "Displaying Multiple Calendars in a Single Task Flow."

6. In the Time section, select All Day Event to block out the entire day for the event.

All-day events can span multiple days.

7. In the Start Time field enter a date and time to start the event. You can click the Select Date and Time icon and select a start time from the Date Picker, if you prefer.

8. In the End Time field enter a date and time to finish the event. You can click the Select Date and Time icon and select an end time from the Date Picker, if you prefer.

Note:

All selections under the Options section are optional.

9. In the Options section, assign a priority for the event: Highest, High, Normal, Low, or Lowest.

The priority of an event determines where it appears when events clash. An event with Highest priority is displayed first.

10. Select a category to classify this event from the Category dropdown list.

Optionally, click the Create Category button to create a category and automatically select it for this event.

Categories are useful for creating distinct groups of events, organized according to their general purpose.

Note:

The Category dropdown list is available only for Space Events.

11. In the Details text box, enter any additional details you want to include, up to a maximum of 4000 characters.

For example, you might want to describe the purpose of the meeting, provide a brief agenda, or indicate if attendees need to prepare anything for the meeting.

Note:

The details that you enter here are available only when editing the event, they do not display in the event popup when users hover over the event. You should not assume that all users will read these details. Important details about the meeting should be communicated in a different way, for example, through the meeting notification email or by using an announcement.

12. Select the Private checkbox if you do not want other users to be able to view the event.

If the Events task flow is included on page in your Home Space that you have made available to other users, those users are not able to see the event.

13. Click Create to add the event to the calendar (Figure 61-23).

Figure 61-23 An Event in Day View

61.2.5 Viewing Event Details

The Events page or Events task flow displays basic information about events. To view more information, such as the location or start and end times, simply hover your mouse over an event.

To view event details:

1. Go to the Events task flow (or Events page) where you want to view event details.

If the Events page is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Hover the mouse over a link to an event to display the event details (Figure 61-24).

Figure 61-24 An Event with Details Popup

To view the priority, category, or details of the event you must edit the event. For more information, see Section 61.2.6, "Revising Scheduled Events."

61.2.6 Revising Scheduled Events

You may want to change some aspect of an event; for example, it may become necessary to change the time to accommodate a particular attendee, or the location may become unavailable.

To revise a scheduled event:

1. Go to the Events task flow (or Events page) where you want to revise a scheduled event.

If the Events page is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Right-click the event and choose Edit (Figure 61-25).

Figure 61-25 Editing an Event

The Edit Event dialog opens (Figure 61-26).

You can also access the Edit Event dialog by clicking an event, or by moving the mouse pointer (or using the Tab key) to highlight an event and pressing Enter.

Figure 61-26 The Edit Event Dialog Invoked from a Home Space

3. Revise the event details.

For information about the different options available in the dialog, see Section 61.2.4, "Scheduling Events."

4. Click Update to save your changes.

61.2.7 Cancelling Scheduled Events

To cancel an event, you delete it from the Events page or task flow.

To cancel a scheduled event:

1. Go to the Events task flow (or Events page) where you want to cancel a scheduled event.

If the Events tab is not available, see Section 61.2.3.1, "Displaying the Events Page for a Space."

2. Right-click the event and choose Delete (Figure 61-27).

Figure 61-27 Deleting an Event

You can also delete an event by hovering your mouse over the event and pressing the Delete key or, in the Edit Event dialog, clicking Delete.

3. Click Delete in the Delete Confirmation dialog.

The event is removed from the calendar.

61.2.8 Displaying Multiple Calendars in a Single Task Flow

Within WebCenter Spaces, you may be a member of several Spaces. Each of those Spaces probably has its own calendar of events. In addition to that, you may also have your own calendar where you track those events that concern only yourself. At the start of each day, you probably do not want to view each of these calendars individually to determine your schedule for the day.

To solve this issue, the Events service enables you to view multiple calendars in a single Events task flow. This is called calendar overlaying. You can do this in your Home Space so that you can also include your personal appointments. You can also overlay calendars in an Events task flow on a Space page.

Note:

The events from each calendar are displayed in a different color to help identify the source of the event.

For example, you might have a sales event that involves your Marketing, Sales, and Facilities departments. You want to create a calendar that includes events and tasks for all the departments so that each group has a clear picture of the overall plan. To create the sales event calendar:

1. Create a Space for the sales event.

2. Create Spaces or Subspaces for each department (Marketing, Sales, and Facilities), adding the Events Task Flow to each Space/Subspace, then adding events to each calendar.

3. Add the Events Task Flow to the sales event Space, overlaying the calendars from the Marketing, Sales, and Facilities Spaces/Subspaces.

This section includes the following subsections:

- Section 61.2.8.1, "Enabling Calendar Overlaying"

- Section 61.2.8.2, "Displaying Additional Calendars"

- Section 61.2.8.3, "Editing Calendar Display Options"

61.2.8.1 Enabling Calendar Overlaying

To display additional calendars in the Events task flow, you must first enable the calendar overlaying feature for the task flow.

To enable calendar overlaying:

1. Go to your Home Space or the appropriate Space and locate the page that contains the Events task flow.

If you have not yet added the Events task flow to a page, see Section 61.2.1, "Adding an Events Service Task Flow to a Page."

2. Open the page in edit mode (Oracle Composer) by pressing Ctrl+Shift+E.

3. Click the Edit icon (wrench) for the Events task flow.

Note:

If you are working in a Space, you may not have the appropriate permissions to edit the task flow. To enable calendar overlaying, contact the Space moderator.

4. In the Component Properties: Events dialog, click the Parameters tab.

5. From the Calendar Overlay Style dropdown list, choose:

- Full to use a detailed calendar overlay. Use this option if space is not an issue on the page and to provide a richer user interface.

- Mini to use a more compact view of the calendar overlay. This takes up less space on the page, but it might not be immediately obvious how to work with the overlays. Use this option if space is very limited on the page, or when your users have become familiar with calendar overlays and how to use them.

- None if you do not want to use calendar overlays.

Figure 61-28 The Calendar Overlay Style Events Service Property

6. Click OK to save your changes and exit the Component Properties dialog.

7. Click Save at the top right of Oracle Composer to save your changes.

8. Click Close at the top right to exit Oracle Composer.

The Events task flow now includes an area to the left of the calendar where you can choose other calendars to display in the task flow.

If you selected the Full option for the Calendar Overlay Style, the calendar overlay area includes text as well as icons and also includes a date picker to help you easily move around your calendar (Figure 61-29).

Figure 61-29 Events Task Flow with Full Calendar Overlay Area

If you selected the Mini option for the Calendar Overlay Style, the calendar overlay area is much smaller, displaying icons only and no date picker (Figure 61-30).

Figure 61-30 Events Task Flow with Mini Calendar Overlay Area

Note:

If you have not yet set up and logged in to your personal calendar, click the Continue link to display the calendar in the task flow. For information about how to set up your personal calendar, see Section 61.2.2, "Accessing Your Personal Microsoft Exchange Calendar."

61.2.8.2 Displaying Additional Calendars

When the calendar overlaying feature is enabled, users can display as many calendars as they want in the Events task flow. Each calendar's events are displayed in a different color to make it easier to distinguish which calendar it belongs to.

To display additional calendars:

1. Go to your Home Space or the appropriate Space and locate the page that contains the Events task flow.

2. In the calendar overlay area of the Events task flow, click the Add Calendar icon.

Figure 61-31 The Add Calendar Icon

3. In the Add Calendar dialog (Figure 61-32), select the Space that provides the calendar that you want to display in the task flow.

You can select multiple Spaces.

Figure 61-32 The Add Calendar Dialog

4. Click Add Calendar.

The calendar overlay area now includes the selected Space and the calendar on the right includes events from that Space. The events from each Space are displayed in a different color.

Figure 61-33 The Events Task Flow Displaying Multiple Calendars

61.2.8.3 Editing Calendar Display Options

After adding a Space's events to your calendar you can change various display options, including the order the calendar appears in the list and the color used to identify events from the calendar.

To edit calendar display options:

1. Go to your Home Space or the appropriate Space and locate the page that contains the Events task flow.

2. Click the arrow icon to the right of the Space for which you want to edit display options. This displays the calendar overlay popup menu (Figure 61-34).

Figure 61-34 The Calendar Overlay Menu

3. From the popup menu, choose:

- Visible to toggle the display of this Space's events in the calendar.

You can also toggle the display of a Space's events by clicking the Space name (Full view only) or the colored square next to the Space name.

- Change display name to make the name in the list of Spaces in Full view more meaningful to you than just the Space name.

- Remove Calendar to remove this Space's calendar from the task flow.

- Open Space to open the Space associated with this calendar.

- Move to Top/Move up/Move down/Move to Bottom to rearrange this Space in the list.

The order in which the Spaces are listed determines the order in which events are listed when events from multiple Spaces occur in the same time slot. Events from the Space at the top of the list are displayed first.

- A color to change the color used for the events from this Space.

61.3 Setting Events Service Task Flow Properties

The Events service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 61-35).

Figure 61-35 Events Service Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Events service task flows and describe the properties on the Parameters tab:

- Section 61.3.1, "What You Should Know About the Events Service Task Flow Properties"

- Section 61.3.2, "Events Service Task Flow Parameters"

61.3.1 What You Should Know About the Events Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 61.3.2, "Events Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So this tab may be omitted. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

61.3.2 Events Service Task Flow Parameters

Table 61-1 describes the parameters that are unique to the Events service task flow.

Table 61-1 Events Service Task Flow Parameters

Property

Description

Calendar Style Class

The name of the custom style class you want to apply to the calendar component.

Default Current Date

The default current date on the calendar. Valid values are:

- Empty (default): The current date (that is, today's date)

- Any date using the format mm/dd/yyyy

Customization ID

A unique identifier for event view customization.

Customization ID assists with maintaining the association of this task flow instance with its customization and personalization settings. This value is set automatically. Do not edit this value.

Group Space

The name of the Space that is the source of listed events.

Valid values are:

- Empty: Task flow displays events for the current Space (that is, the Space in which it is placed)

- Any Space display name: Task flow displays events for the named Space

The Space display name is available on the General page in the Space administration settings.

Maximum Enabled Calendars

The maximum number of calendars that a user can display simultaneously.

This value must not be greater than the value specified for Maximum Calendars.

Default value: The same value as that specified for Maximum Calendars

Maximum Calendars

The maximum number of calendars that a user can add to the task flow.

When the maximum is reached, the Add Calendar icon no longer appears in the task flow.

Default value: 20

Calendar Overlay Style

Whether calendar overlay is enabled. Valid values are:

- Empty (default): No calendar overlay

- FULL: Calendar overlay is enabled in Full mode

- MINI: Calendar overlay is enabled in Mini mode, which takes up less screen space

Disable Personalize and Customize

Whether users can personalize or customize the task flow. If selected, users can personalize and customize the task flow.

61.3.3 Events - Mini View Task Flow Parameters

Table 61-1 describes the parameters that are unique to the Events - Mini View task flow.

Table 61-2 Events - Mini View Task Flow Parameters

Property

Description

Calendar Toolbox Layout

Custom calendar toolbox layout. The value will be passed to the ADF calendar component as an attribute toolboxLayout.

Customization ID

A unique identifier for event view customization.

Customization ID assists with maintaining the association of this task flow instance with its customization and personalization settings. This value is set automatically. Do not edit this value.

List Events in Number of Upcoming Days

Number of days for upcoming events. Default value: 30

Event Text Length

The maximum length of event text displayed in mini view. Default value: 18. No truncation will be made if value is 0.

Number of Events Per Page

Number of events per page. Default value: 5

Using ADF Calendar Component

A switch to use ADF Calendar UI Component or simple list with page flow in events mini view. Default value: false.

62 Working with the Instant Messaging and Presence Service (IMP)

This chapter describes how to use the features provided through the Instant Messaging and Presence (IMP) service. The IMP service lets you see the presence status of other authenticated application users. It provides instant access to interaction options, such as instant messages and mails. Additionally, if enterprise presence is unavailable, you can connect to a 3rd-party network presence service, such as Yahoo! Messenger.

This chapter includes the following sections:

- Section 62.1, "What You Should Know About the IMP Service"

- Section 62.2, "Identifying Your Preferred Instant Messaging Provider"

- Section 62.4, "Working with IMP Service Features"

Audience

This chapter is intended for authenticated users who want to view, create, and manage instant messaging and presence. It also is intended for WebCenter Spaces administrators with the Application-Manage Configuration permission and individual Space moderators who want to configure instant messaging and presence within their Spaces. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter are not available if the IMP service is not enabled in the current Space.

62.1 What You Should Know About the IMP Service

The IMP service enables you to observe the presence status of other authenticated users (online, offline, busy, or away) and provides instant access to interaction options, such as instant messages (IM) and mail. Any WebCenter service that has a user name can integrate with the IMP service; for example, Discussions, Documents, or Mail. Wherever a user is indicated, for example as the author of a document in the document library, you can see an icon (Figure 62-1) depicting the presence state of that user.

Figure 62-1 The Presence Icon for Online Users

If you hover your mouse over the Presence icon, a tooltip displays the current status message for that user, if available. If the user has not provided a status message, or the message cannot be retrieved, then the tooltip displays the presence state of the user (online, offline, busy, or away).

Note:

There is no idle status. In the case of extended user inactivity, the status still displays as online.

Additionally, you can click the Presence icon to invoke a context menu (Figure 62-2).

Figure 62-2 The Presence Icon Context Menu

From the context menu you can:

- Send mail to the user. For more information, see Section 62.4.2, "Sending a Mail Message from the Presence Icon Menu."

- View the user's profile. For more information, see Section 30.5.1, "Viewing Profile Details."

- Send an instant message to the user. For more information, see Section 62.4.3, "Sending an Instant Message from the Presence Icon Menu."

- Change credentials, which works as an alternative to using an external application. This option is available with Microsoft Office Live Communications Server (LCS) 2005 and Microsoft Office Communications Server (OCS) 2007.

Note:

The options that display on the context menu depend on what services are available to your WebCenter Spaces application, how those services are configured, and which services are supported by the back-end presence server. For example, the Phone Conference option is supported by Oracle WebLogic Communications Services (OWLCS) only.

62.2 Identifying Your Preferred Instant Messaging Provider

If Oracle WebCenter presence is not available (for example, if your enterprise uses a Jabber/XMPP presence server or has federated presence servers with users distributed across identity management systems), you can connect to a public network presence service.

Out-of-the-box, WebCenter supports Yahoo! Messenger on network presence. However, the network presence model can be extended to include other providers, such as ICQ.

To enable network presence:

1. Click the Preferences link at the top of the application.

2. Click Presence to open the Presence Preferences pane.

3. Enter the IM address for the presence status and a display name (Figure 62-3).

Figure 62-3 The Presence Preferences Pane

4. Click OK to save your change and exit the Preferences dialog.

Presence tags for that user shows their network presence, either online (Figure 62-4) or offline (Figure 62-5).

Figure 62-4 Yahoo Presence Icon - Online

Figure 62-5 Yahoo Presence Icon - Offline

62.3 Configuring Network Presence

To set your presence to Yahoo! Messenger:

1. Click the Preferences link at the top of the application.

2. Click Presence to open the Presence Preferences pane.

3. Enter your Yahoo! Messenger ID and a display name for yourself (Figure 62-3).

Figure 62-6 The Presence Preferences Pane

4. Click OK to save your change and exit the Preferences dialog.

To revert back to your enterprise presence, when you are back on your network, simply remove this information from Presence Preferences.

Note:

To send instant messages to an online user on Yahoo! Messenger, you also must have Yahoo! Messenger installed.

62.4 Working with IMP Service Features

Many WebCenter task flows include a presence capability that enables you to make contact with other users from within the context of what you want to contact them about. For example, if you see a post in a discussion topic and want to contact the author of that post, you can do so directly from the Discussions task flow.

This section includes the following subsections:

- Section 62.4.1, "Viewing the Status of Other Users"

- Section 62.4.2, "Sending a Mail Message from the Presence Icon Menu"

- Section 62.4.3, "Sending an Instant Message from the Presence Icon Menu"

- Section 62.4.4, "Initiating a Phone Conference from the Presence Icon Menu"

62.4.1 Viewing the Status of Other Users

Many task flows support on-the-spot communication with other users. That is, wherever a task flow includes a Presence icon (Figure 62-1), you can start an instant chat or send a mail to the user associated with the icon.

The way you communicate with another user depends upon their availability. For example, if the user is online, then you could send an instant message to make immediate contact. However, if the user is offline or busy, then sending a mail is probably a better option.

Additionally, users can provide further information about their status by providing status messages. If such a status message exists for a user, hovering over the Presence icon displays that message as a tooltip. The status message enables you to make an even more informed decision about how to make contact. If there is no status message for the user, then the presence state is displayed in the tooltip instead (online, offline, busy, or away).

To view the current presence status or status message of a user, simply hover the mouse over the Presence icon next to the user's name.

Note:

The presence state of the user is held in a cache with a default expiry time of 60 seconds. As a result, the Presence icon may not reflect the actual status of the user if the status has changed between the initial retrieval and the cache expiry time.

Table 62-1 describes the presence state each Presence icon indicates.

Table 62-1 Presence Icon Presence States

Presence Icon

State

Associated user is online.

Associated user is online, but busy. Please do not disturb.

Associated user is still connected but away from the computer.

Error indicator. This icon appears against the name of the current logged-in user, meaning the user has not provided required credentails to log on to the presence server.

62.4.2 Sending a Mail Message from the Presence Icon Menu

Wherever you see a Presence icon, you can send a mail message to its associated user.

To send a mail message:

1. Locate a Presence icon (Figure 62-1) for the person you want to contact.

For example, you can find Presence icons associated with documents and discussion topics, and anywhere a task flow is configured to support IMP.

2. Click the Presence icon associated with the user you want to contact.

For example, in Figure 62-7 the Presence icon is associated with the user monty.

Figure 62-7 The Presence Icon Associated with the User monty

3. From the menu, choose Send Mail.

You may be presented with a login window. If so, then enter your user name and password for your mail application. If your preferences are set up to deliver your login credentials automatically, you can start your message right away. For more information about login credentials and preferences, see Chapter 35, "Setting Your Personal Preferences."

4. Compose your message and click Send (Figure 62-8).

Figure 62-8 Sending Mail Using the IMP Service

62.4.3 Sending an Instant Message from the Presence Icon Menu

Wherever you see a Presence icon, you can send an instant message to its associated user.

Before you can send an instant message, you must install the appropriate chat client (and only that client) on your local computer. The client must be configured to connect to the back-end presence server.

- If the back-end presence server is Microsoft Live Communications Server (LCS) 2005, then install Microsoft Communicator.

- If the back-end presence server is Microsoft Office Communications Server (OCS) 2007, then install Microsoft Communicator.

- If the back-end presence server is Oracle WebLogic Communications Server (OWLCS), then install Oracle Communicator.

Contact your administrator if you are not sure which client to install or how to connect to the presence server.

To send an instant message:

1. Locate a Presence icon (Figure 62-1) for the person you want to contact.

For example, you can find Presence icons associated with documents and discussion topics, and anywhere a task flow is configured to support IMP.

2. Click the Presence icon associated with the user you want to contact.

For example, in Figure 62-9 the Presence icon is associated with the user monty.

Figure 62-9 The Presence Icon Associated with the User monty

3. From the menu, choose Send Instant Message.

WebCenter invokes your instant messaging client, and starts a chat session with the selected user.

62.4.4 Initiating a Phone Conference from the Presence Icon Menu

If you are using Oracle WebLogic Communications Server (OWLCS) as the presence server, then wherever you see a Presence icon, you can initiate a phone conference with its associated user.

To initiate a phone conference:

1. Locate a Presence icon (Figure 62-1) for the person you want to contact.

For example, you can find Presence icons associated with documents and discussion topics, and anywhere a task flow is configured to support IMP.

2. Click the Presence icon associated with the user you want to contact.

For example, in Figure 62-10 the Presence icon is associated with the user monty.

Figure 62-10 The Presence Icon Associated with the User monty

3. From the menu, choose Start Phone Conference.

OWLCS places a call to you and then to the target user, using the phone numbers specified in the user profiles.

Notes:

- This functionality requires the Third Party Call Center (TPCC) Service. Refer to OWLCS Documentation for more information.

- If you encounter an error when initiating a phone conference with other WebCenter users, ensure that user names are lowercase.

63 Working with the Links Service

This chapter describes how to use the features provided through the Links service. The Links service provides a way to view, access, and associate related information.

This chapter includes the following sections:

- Section 63.1, "What You Should Know About the Links Service"

- Section 63.2, "Working with Links Service Features"

Audience

This chapter is intended for users who want to view, create, and manage links.

Such users must be granted, minimally, the Space-level permission View Pages and Content to view links. They can view shared links only for resources for which they have view permission.

Authenticated users who plan to create and manage links require the Space-level permission Customize Pages and Edit Content. They must have view permission on the resource. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter are not available if the Links service is not enabled in the current Space.

63.1 What You Should Know About the Links Service

Linking gives users a means of explicitly associating two objects with each other through easy-access reference points, called links. The Links service assists with setting up these links from one application object to another. For example, using links you can associate a project plan document with a list of project issues. When users access the list, they can also immediately access the project plan by clicking a link that appears on the list (Figure 63-1). This service also provides a quick way to create new objects when establishing a link.

Figure 63-1 A Link on a List Row

In WebCenter Spaces, links are scoped to Spaces. For example, the links that display in the Finance Space differ from the links that display in the Infrastructure Space, even though links are accessed from the same places in both Spaces. The objects to which you can link also depend on which services have been enabled in your application.

Anywhere you see a Links icon, you can create a link to both new and existing content.

There are two Links icons that each indicate the state of the Links dialog:

- The gray Links icon (Figure 63-2) indicates that no links are present in the Links dialog.

Figure 63-2 The Links Icon (No Links Present)

- The gold Links icon (Figure 63-3) indicates that links are present in the Links dialog.

Figure 63-3 The Links Icon (Links Present)

Use the Link to Existing option in the Links dialog to link to existing application objects, such as documents, discussion forum topics, and announcements. For more information, see Section 63.2.1, "Linking to Existing Objects."

Use the Link to New option in the Links dialog to both create an application object and link to it in a single operation. Choose Link to New to upload and link to documents, create and link to discussion forum topics, enter the URL of a web page to link to, and create and link to other types of items. For more information, see Section 63.2.2, "Linking to New Objects."

You can create links from announcements, discussions, documents, events, lists, and pages.

The items you can link to differ between the Link to New and Link to Existing lists. For example, while you can link to a new note, you cannot link to an existing note. Additionally, in WebCenter Spaces, the items you can link to from a Home Space differ from those you can link to from a Space. Table 63-1 lists the types of objects you can link to and from.

Table 63-1 Linking to Objects

Object Type

Link to New Resource

Link to Existing Resource

Home Space

Space

Announcement

No

Yes

No

Yes

Discussion Topic

Yes

Yes

No

Yes

Document/Wiki

Yes

Yes

Yes

Yes

Event

Yes

Yes

No

Yes

Note

Yes

No

Yes

Yes

URL

Yes

No

Yes

Yes

Given the right permission, other users can see your links, and you can see other users' links. For most services, what you can do with a link (such as view, create, delete) is handled by your Links permission. However, with the Notes service, you can delete a link only if you also have delete permission on the Notes service. For more information on Links permission, see the section "Managing Application Roles and Permissions" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

What you can do with the linked object is handled by the target object's security.

Links retain their originating location. For example, if you create a link on a list row, then that link appears only on that row, and not on all the other rows in the same list. Suppose you link to an article about a particular widget from the list row that describes that widget. The link to that article appears only on that row's Links dialog (Figure 63-4). It does not display on the Links dialog associated with the other rows on the same list.

Figure 63-4 The Links Dialog

Most Links are also bidirectional. That is, when you create a link from a discussion to a document, a return link from the document to the discussion is automatically created. This bidirectional relationship holds for most, though not all, links. Links on notes, URLs, and list rows do not create a reciprocal link on the link target. For example, if you create a link from a document to a note, from a document to a URL, or from a list row to a document, then a reciprocal link is not created on the link target. However, a link from an entire list (rather than an individual list row) does create a reciprocal link from the target.

63.2 Working with Links Service Features

Many WebCenter task flows include a linking capability that enables you to associate application objects with other application objects, and with internal and external web pages. For example, the List task flow automatically includes a Links icon on each list and on each list row. Additionally, the Lists page has its own link (Figure 63-5).

Figure 63-5 Link Icons on the Lists Page

Use the Links feature to link to relevant documents, discussions, notes, web pages, events, and announcements. When viewing the details of an event, you can link to the event's agenda. In a list of project assignments, you can link to the functional and design specifications relevant to each assignment. In a discussion forum, you can link to a related discussion, document, web page, or WebCenter Spaces page. No more fruitless wandering through different lines of business to find information.

This section describes how to link one thing to another in WebCenter applications and how to access those links.

This section includes the following subsections:

- Section 63.2.1, "Linking to Existing Objects"

- Section 63.2.2, "Linking to New Objects"

- Section 63.2.3, "Accessing Link Targets"

- Section 63.2.4, "Deleting a Link"

- Section 63.2.5, "Linking in the Rich Text Editor"

63.2.1 Linking to Existing Objects

This section describes how to use the Link to Existing option on the Links dialog to link to announcements, discussion forum topics, documents, and events currently available in your application.

This section includes the following subsections:

- Section 63.2.1.1, "Opening the Links Dialog to Link to Existing Objects"

- Section 63.2.1.2, "Linking to an Existing Announcement"

- Section 63.2.1.3, "Linking to an Existing Discussion Forum Topic"

- Section 63.2.1.4, "Linking to an Existing Document"

- Section 63.2.1.5, "Linking to an Existing Event"

63.2.1.1 Opening the Links Dialog to Link to Existing Objects

To create a link to an existing object, first go to the object from which you want to link and open the Links dialog. From there, the steps vary depending on the type of object you are linking to.

To open the Links dialog:

1. Go to the object from which you want to link.

2. Click the object's associated Links icon (Figure 63-6).

Figure 63-6 The Links Icon

This opens the Links dialog (Figure 63-7).

Figure 63-7 The Links Dialog

3. From the Links dialog, choose Link to Existing and then the type of object you want to link to.

For information about what to do next see:

- Section 63.2.1.2, "Linking to an Existing Announcement"

- Section 63.2.1.3, "Linking to an Existing Discussion Forum Topic"

- Section 63.2.1.4, "Linking to an Existing Document"

- Section 63.2.1.5, "Linking to an Existing Event"

63.2.1.2 Linking to an Existing Announcement

You can bring timely announcements to the highest traffic areas in your application by linking to them.

To link to an existing announcement:

1. Go to the object from which you want to link to an announcement and click the Links icon.

For more information, see Section 63.2.1.1, "Opening the Links Dialog to Link to Existing Objects."

2. From the Links dialog, choose Link to Existing and then Announcement.

A window listing announcements opens (Figure 63-8).

Figure 63-8 Existing Announcements

3. In the window, click the announcement to which you want to link.

4. Click Link.

The title of the selected announcement appears on the list of links in the Links dialog (Figure 63-9).

Figure 63-9 Newly-Added Announcement on Links Dialog

5. Close the Links dialog.

63.2.1.3 Linking to an Existing Discussion Forum Topic

Help users find answers to questions before they even ask them by linking to relevant discussion forum topics.

To link to an existing discussion forum topic:

1. Go to the object from which you want to link to a discussion forum message and click the Links icon.

For more information, see Section 63.2.1.1, "Opening the Links Dialog to Link to Existing Objects."

2. From the Links dialog, choose Link to Existing and then Discussion.

A window listing available topics opens (Figure 63-10). If the Space or application supports multiple discussion forums, then a dropdown list at the top enables you to switch to a different forum.

Figure 63-10 Existing Discussion Topics

3. Click the discussion topic to which you want to link.

4. Click Link.

The title of the selected discussion topic appears on the list of links in the Links dialog (Figure 63-11).

Figure 63-11 Newly-Added Discussion Topic on Links Dialog

5. Close the Links dialog.

63.2.1.4 Linking to an Existing Document

To save users from having to search for documents in the document library, link to them directly. For example, link to a meeting's agenda directly from the meeting's event details.

To link to an existing document:

1. Go to the object from which you want to link to a document and click the Links icon.

For more information, see Section 63.2.1.1, "Opening the Links Dialog to Link to Existing Objects."

2. From the Links dialog, choose Link to Existing and then Document.

The Link to Existing Document dialog opens (Figure 63-12).

Figure 63-12 Existing Documents

3. Choose the document, and click Select.

The document link appears on the list of links in the Links dialog (Figure 63-13).

Figure 63-13 A Document Link on the Links Dialog

4. Close the Links dialog.

63.2.1.5 Linking to an Existing Event

You can link to information about events that are relevant to the current object. For example, you could provide a link from an issues document to an event scheduled to discuss those very issues.

To link to an existing event:

1. Go to the object from which you want to link to an event and click the Links icon.

For more information, see Section 63.2.1.1, "Opening the Links Dialog to Link to Existing Objects."

2. From the Links dialog, choose Link to Existing and then Event.

A window opens listing all of the events you can access.

Figure 63-14 Existing Events

3. In the window, click the event to which you want to link.

The title of the selected event appears on the list of links in the Links dialog (Figure 63-15).

Figure 63-15 Newly-Added Event on Links Dialog

4. Close the Links dialog.

63.2.2 Linking to New Objects

When you use Link to New, you accomplish two things at the same time: you create a new object, and you create a link to that object. Use the Link to New option on the Links dialog to link to a new discussion forum topic, a new document, a new event, a new note, or a web page.

This section describes how to link to these types of objects. It contains the following subsections:

- Section 63.2.2.1, "Opening the Links Dialog to Link to a New Object"

- Section 63.2.2.2, "Adding and Linking to a Discussion Forum Topic"

- Section 63.2.2.3, "Adding and Linking to a Document"

- Section 63.2.2.4, "Adding and Linking to an Event"

- Section 63.2.2.5, "Adding and Linking to a Note"

- Section 63.2.2.6, "Linking to a Web Page"

63.2.2.1 Opening the Links Dialog to Link to a New Object

When you want to create a link to a new object, the first thing to do is go to the object from which you want to link and open the Links dialog. From there the steps vary depending on the type of object you are linking to.

To open the Links dialog:

1. Go to the object from which you want to link.

2. Click the object's associated Links icon (Figure 63-16).

Figure 63-16 The Links Icon

This opens the Links dialog (Figure 63-17).

Figure 63-17 The Links Dialog

3. From the Links dialog, choose Link to New and then the type of object you want to link to.

For information about what to do next see:

- Section 63.2.2.2, "Adding and Linking to a Discussion Forum Topic"

- Section 63.2.2.3, "Adding and Linking to a Document"

- Section 63.2.2.4, "Adding and Linking to an Event"

- Section 63.2.2.5, "Adding and Linking to a Note"

- Section 63.2.2.6, "Linking to a Web Page"

63.2.2.2 Adding and Linking to a Discussion Forum Topic

You can create a new thread directly from the object that first prompted the discussion, adding a link at the same time.

To link to a new discussion forum topic:

1. Go to the object from which you want to link to a new discussion forum topic and click the Links icon.

For more information, see Section 63.2.2.1, "Opening the Links Dialog to Link to a New Object."

2. From the Links dialog, choose Link to New and then Discussion.

The Link to New Discussion Topic dialog opens (Figure 63-18).

Figure 63-18 Link to New Discussion Dialog

3. If the Space or application supports multiple discussion forums, then in the Forum list, choose the forum in which you want to create the discussion topic.

4. In the Subject field, enter a subject for the new topic.

5. In the Message field, enter the topic content.

6. Click OK.

The topic is added to the selected discussion forum, and the link is added to the Links dialog.

7. Close the Links dialog.

63.2.2.3 Adding and Linking to a Document

When viewing an object, such as a discussion forum topic, you might be aware of an informative document that would help other viewers of the object. You can add the document or wiki to the document library directly from the original object, adding a link to it at the same time.

To link to a new document:

1. Go to the object from which you want to link to a new document and click the Links icon.

2. From the Links dialog, choose Link to New and then Document.

The Upload Document dialog opens (Figure 63-19).

Figure 63-19 Link to New Document Dialog

3. Click Browse, and navigate to the location of the document you want to upload.

4. Choose the document, and click Open.

5. Enter an optional description and change the default destination directory, if necessary. Click the Browse icon to locate a destination, if necessary.

6. Click Upload.

The document is uploaded, and the link is added to the Links dialog.

The location of the uploaded document depends on where you initiated the linking action. The document could be uploaded to the selected Space's document library or to the root folder of your WebCenter's default document repository connection.

7. Close the Links dialog.

63.2.2.4 Adding and Linking to an Event

You can create a new event and immediately add a link to it, for example, to schedule a meeting to address issues raised in a discussion forum topic.

To add and link to a event:

1. Go to the object from which you want to link to a new event and click the Links icon.

For more information, see Section 63.2.2.1, "Opening the Links Dialog to Link to a New Object."

2. From the Links dialog, choose Link to New and then Event.

The Link to New Event dialog opens (Figure 63-20).

Figure 63-20 The Link to New Event Dialog

3. Enter event details as described in Section 61.2.4, "Scheduling Events."

4. Click Create.

The event is added and the link is added to the Links dialog.

5. Close the Links dialog.

63.2.2.5 Adding and Linking to a Note

Create a personal note about another object, maybe to buy doughnuts for the team meeting, or to add an annotation to an object, like an online post-it note. The note is also linked to the object, serving as a reminder whenever you view it.

To add and link to a note:

1. Go to the object from which you want to add and link to a note and click the Links icon.

2. From the Links dialog, choose Link to New and then Note.

The Link to New Note dialog opens (Figure 63-21).

Figure 63-21 The Link to New Note Dialog

3. In the Title field, enter a title for the note.

4. In the Detail field, enter the note content.

5. Click Create.

The note link is added to the Links dialog.

6. Close the Links dialog.

63.2.2.6 Linking to a Web Page

Link to a web page to provide access to additional information.

To link to a web page:

1. Go to the object from which you want to link to a web page and click the Links icon.

For more information, see Section 63.2.2.1, "Opening the Links Dialog to Link to a New Object."

2. From the Links dialog, choose Link to New and then URL.

The Link to New URL dialog opens (Figure 63-22).

Figure 63-22 The Link to New URL Dialog

3. In the Name field, enter a name to use for the link.

4. In the Address field, enter the URL of the page to which you want to link.

5. Click Create.

The link is added to the Links dialog.

6. Close the Links dialog.

63.2.3 Accessing Link Targets

You access link targets from the Links dialog. Click the Links icon (Figure 63-23) associated with the item of interest, and then click the link you want to open on the resulting Links dialog (Figure 63-24).

Figure 63-23 The Links Icon

Figure 63-24 Links in the Links Dialog

63.2.4 Deleting a Link

When a link ceases to serve any purpose, you can delete it.

To delete a link:

1. Go to the object associated with the link you want to delete, such as the document, list, list row, or other item on which the link was created.

2. Click the Links icon (Figure 63-25).

Figure 63-25 The Links Icon

This opens the Links dialog.

3. Click the Delete icon next to the link you want to delete (Figure 63-26).

Figure 63-26 Delete Icon Next to a Link

63.2.5 Linking in the Rich Text Editor

The Rich Text Editor (RTE) included with the Documents services is an HTML text editor, which you can use to link to existing and new WebCenter resources. For example, this provides a quick way to add and link to a new, empty wiki page.

Figure 63-27 shows the highlighted RTE icons to link to existing or new resources and also to embed an image.

Figure 63-27 New Wiki Document in Rich Text Editor (RTE)

For more information, see Section 41.11, "Using the Rich Text Editor (RTE)."

Part XVI

Services: Lists through Worklist

Part XVI of the User's Guide provides overview and usage information about services from Lists through Worklist.

Part XVI includes the following chapters:

- Chapter 64, "Working with the Lists Service"

- Chapter 65, "Working with the Mail Service"

- Chapter 66, "Working with the Notes Service"

- Chapter 67, "Working with the Polls Service"

- Chapter 68, "Working with the RSS Service"

- Chapter 69, "Working with the Recent Activities Service"

- Chapter 70, "Working with the Worklist Service"

The script content on this page is for navigation purposes only and does not alter the content in any way.

64 Working with the Lists Service

Use the Lists service to create, publish, and manage lists in WebCenter Spaces. Create lists from Excel spreadsheets or from prebuilt templates, or create your own custom lists from scratch. When you create a list, it becomes available in the Resource Catalog. You can add lists from the catalog to any page in the Space in which it was created.

This chapter describes how to use the features offered through the Lists service. It includes the following sections:

- Section 64.1, "What You Should Know About the Lists Service"

- Section 64.2, "Working with Lists Service Features"

- Section 64.3, "Setting List Viewer Task Flow Properties"

Audience

This chapter is for users who are interested in viewing, creating, populating, revising, importing, exporting, and removing lists and filtering list data. Such users must be granted, minimally, the Space-level permission View Pages and Content. Such users can view lists. Users who plan to create and manage lists require the Space-level permission Customize Pages and Edit Content.

Note:

Tasks discussed in this chapter are not available if the Lists service is not enabled in the current Space.

64.1 What You Should Know About the Lists Service

The Lists service provides a means of creating, publishing, and managing lists (Figure 64-1).

Figure 64-1 A List in the List Viewer Task Flow

Lists are useful for many Space activities, such as tracking issues, capturing project milestones, publishing project assignments, and much more. The lists you create in WebCenter Spaces can be widely varied in their complexity. For example, you can start with a list of team members, and then include columns for contact information, project role, and links to relevant documents, such as any plans or proposals associated with a listed team member.

The Lists service is available to all Spaces except the Home Space. Whether it is exposed for use depends on the actions of your Space moderator (for more information, see Section 51.10.1, "Enabling and Disabling Services Available to a Space"). The lists you create in a Space are unique to that Space. One Space cannot consume the lists created in another Space.

Create and populate lists using the controls on the Lists page. Place populated lists on a page using the List Viewer task flow. Users must have appropriate permissions to perform actions on lists (for more information, see Audience).

Use the controls on the Lists page to create and revise lists and list data and to view all of a Space's current lists (Figure 64-2).

Figure 64-2 A List on the Lists Page

On the Lists page, you can make use of templates for rapid creation of lists and tools for designing and revising list structure. If you prefer, you can create a list from scratch, adding and configuring all of the columns yourself, or you can create a list from an Excel spreadsheet. For more information, see Section 64.2.3, "Creating and Managing Lists."

The List Viewer task flow (Figure 64-3) provides a means of placing a particular list on a page.

Figure 64-3 A List in the List Viewer Task Flow

The List Viewer provides easy access to all the tools required for adding and revising list data, importing/exporting list data, filtering list data, obtaining a list RSS feed, and linking to other WebCenter Spaces objects from the list and from a list row.

Additionally, the List Viewer provides access to customization tools that enable you to control the look of a particular list instance and its data. For example, use customization to control color banding of rows or columns or to apply filters to list data. For more information, see Section 64.2.5, "Customizing Lists."

Use the Lists page and the List Viewer to add and revise list data throughout the life of the list (for more information, see Section 64.2.4, "Adding and Managing List Data"). Add and revise content directly on a list, or use the list Export/Import feature to send list data to an Excel file, revise it there, and then import it back into the original list in WebCenter Spaces (for more information, see Section 64.2.7, "Exporting a List and Importing a List from an Excel Spreadsheet").

All of the lists created in a given Space are available on the Lists page and through the Space's Resource Catalog (Figure 64-4).

Figure 64-4 Lists in the Resource Catalog

Tip:

By default, you can find lists under Lists in the Social and Communication folder in the Resource Catalog. However, the location of lists in a Resource Catalog depends on how the catalog was structured by its designer. You can use the catalog's Search feature to search for Lists or the list name.

In the Resource Catalog, click the Add link next to a list to add it to the current page (for more information, see Section 17.5.1, "Adding a Component to a Page"). The list is rendered within a List Viewer task flow.

The Lists page is available in any Space where the Lists service is enabled. If the Lists page is not shown by default when you navigate to a Space, you can open it through the Personalize Pages page. For more information, see Section 29.3.4, "Showing Hidden Pages."

Note:

The Lists service is not available in the Home Space.

Through its tight integration with the Links service, the Lists service provides the opportunity to associate other WebCenter Spaces items with an entire list or an individual list row. Linking enables you to associate documents, notes, and URLs with a list or a list row. For more information, see Chapter 63, "Working with the Links Service."

The Lists service additionally provides RSS feeds for all lists and for individual lists. For information about the Lists service and RSS, see Chapter 68, "Working with the RSS Service."

64.2 Working with Lists Service Features

This section provides information about using the features available through the Lists page and the List Viewer task flow. It includes the following subsections:

- Section 64.2.1, "Adding Lists to a Page"

- Section 64.2.2, "Viewing Lists"

- Section 64.2.3, "Creating and Managing Lists"

- Section 64.2.4, "Adding and Managing List Data"

- Section 64.2.5, "Customizing Lists"

- Section 64.2.6, "Sending a Link to a List to Other Users"

- Section 64.2.7, "Exporting a List and Importing a List from an Excel Spreadsheet"

64.2.1 Adding Lists to a Page

For the steps to add a list to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

See Also:

If you do not find lists in the Resource Catalog, it may be that you need to add them. For more information, see Section 16.3.1.2, "Adding Resources."

64.2.2 Viewing Lists

To view the lists associated with a particular Space, you must have access to that Space. Once you have access, you can view all of a Space's lists on its Lists page.

To view a list on the Lists page:

1. Go to the Space that contains the list you want to view, and open its Lists page.

If the Lists page is not available, see Section 29.3.4, "Showing Hidden Pages."

2. From the Lists panel, select the list you want to view.

List details appear to the right (Figure 64-5).

Figure 64-5 List of Lists on a Lists Page

64.2.3 Creating and Managing Lists

This section describes how to create, edit, copy, and delete lists on the Lists page.

This section includes the following subsections:

- Section 64.2.3.1, "Creating Lists"

- Section 64.2.3.2, "Editing List Structure"

- Section 64.2.3.3, "Copying a List"

- Section 64.2.3.4, "Deleting Lists"

64.2.3.1 Creating Lists

In WebCenter Spaces, you can create a list using one of the following methods:

- Create a blank list for which you create and configure all columns (up to 30).

- Create a list from a template, and use that "as is" or as a starting point.

- Create a list from a Microsoft Excel spreadsheet.

This section describes how to create a list using each method.

To create a list:

1. Go to the Lists page of the Space where you want to create a list.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel toolbar, click the Create a new list icon (Figure 64-6).

Figure 64-6 Create a New List Icon on a Lists Page

3. In the resulting Create List dialog, enter a name for the list in the Name field (Figure 64-7).

Figure 64-7 Create List Dialog

4. Optionally, in the Description field enter a description of the list.

Tip:

In a completed list, the description appears between the list title and list data.

5. Under Create From, select to create the list using a Template or from an Excel Spreadsheet.

6. If you select to create a list from a Template, select a template from the Template menu:

- Custom List—To create a list without using a template.

- Issues—To create a list of, for example, project issues. By default, this template provides the columns Subject, Assigned To, Closed, and Comments.

- Milestones—To create a list of, for example, project milestones. By default, this template provides the columns Date, Description, and Status.

- Objectives—To create a list of, for example, project objectives. By default, this template provides the columns Title, and Description.

If you select to create a list from an Excel Spreadsheet, click Browse to navigate to and select the spreadsheet:

- The first row of the spreadsheet is used as column headings. The subsequent rows are added as data.

- All the columns are created with the data type Plain Text. After creation, you can modify the data types as desired. For information about data types, see Table 64-1, "Data Type Selections for List Columns"

Tip:

You can use the Excel Spreadsheet option to import a list from a different Space or from a different WebCenter instance. That is, you can export the list from the Space or WebCenter instance and import it into the current Space or instance.

7. Click OK.

The new list appears in the Lists panel on the Lists page.

You may now revise default list columns and add new columns to the list by clicking the Edit list icon. For more information, see Section 64.2.3.2, "Editing List Structure." For a custom list, you must add columns to the list before you can add rows.

See Also:

For information about adding new list rows, see Section 64.2.4, "Adding and Managing List Data."

64.2.3.2 Editing List Structure

When you edit list structure, you can revise everything about the list. For example, you can change column details; remove, add, and rearrange columns; and rename or redescribe the list.

This section describes the various tasks you can perform while editing a list structure. It contains the following subsections:

- Section 64.2.3.2.1, "Renaming a List and Revising a List Description"

- Section 64.2.3.2.2, "Adding Columns to a List"

- Section 64.2.3.2.3, "Revising List Column Details"

- Section 64.2.3.2.4, "Rearranging List Columns on All Instances of a List"

- Section 64.2.3.2.5, "Deleting a List Column"

64.2.3.2.1 Renaming a List and Revising a List Description

To rename a list and revise a list description:

1. Go to the Space where you want to rename a list or revise a list description, and open its Lists page.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list you want to change, and click the Edit list icon (Figure 64-8).

Figure 64-8 Edit List Icon

The list enters edit list mode (Figure 64-9).

Figure 64-9 List in Edit List Mode

3. Click the Edit link to the right of the Name field to open the Edit List dialog (Figure 64-10).

Figure 64-10 Edit List Dialog

4. Revise the list name and description.

5. Click OK to close the dialog and save your changes.

6. Click the Close button in edit list mode to return to view list mode.

64.2.3.2.2 Adding Columns to a List

This procedure is useful when you create a custom list or you want to alter a list that you created from a template or a spreadsheet.

Note:

A list supports up to 30 columns.

When you add a column to a list, the new column is added after the selected column. If no column is selected, the new column is added as the first column.

To add columns to a list:

1. Go to the Lists page of the Space where you want to add columns to a list.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list to which to add columns and click the Edit list icon (Figure 64-11).

Figure 64-11 Edit List Icon

The Lists page enters list edit mode (Figure 64-12).

Figure 64-12 List in Edit List Mode

3. Under Columns, click the Create button to open the Create Column dialog (Figure 64-13).

Figure 64-13 Create Column Dialog

Tip:

Select a column to add a new column after it.

4. In the Name field, provide a name for this column.

5. From the Data Type list, select the type of data you want to enter in this column.

Note:

The data type you select affects the type of data that can be entered for the column and the way the data is rendered (see Table 64-1 and Table 64-2). It also affects the type of validation that is run on column data when you and other authorized users add list rows. For example, if you select a DateTime data type, and a user enters text that is not in the DateTime format, WebCenter Spaces returns an error.

Table 64-1 lists and describes the data types available to list columns, and provides information about the additional details that appear for each type.

See Also:

For information about additional column details, see Table 64-2, "Data Type Column Details".

Table 64-1 Data Type Selections for List Columns

Data Type

Description

Comments

Plain Text

Unformatted text, provides options for making the text a link

Additional column details include:

- Required

- Default Value

- Maximum Length

- Number of Lines for Editing

- Allow Links

- Link Window

- Display Width

- Hint

Rich Text

Rich, formatted text entered through a rich text editor, may include links

Additional column details include:

- Required

- Display Width

- Hint

Number

Numbers

Additional column details include:

- Required

- Format

- Default Value

- Minimum Value

- Maximum Value

- Display Width

- Hint

For Format, select from:

- Number—an unformatted number; decimal separator is based on the currently selected locale. For more information, see Section 35.2, "Choosing Your Preferred Display Language."

- Currency—value is formatted as a currency value; the currency symbol and decimal separator are based on the currently selected locale. For more information, see Section 35.2, "Choosing Your Preferred Display Language."

- Percent—value is formatted as a percentage; the value 0.6 is formatted as 0.6%; the value 60 is formatted as 60%.

The Number data type supports numbers from ±1.79769313486231570e+308 with 14 to 15 significant digits.Foot 1

DateTime

Dates and times in the format specified in a given user's WebCenter Spaces Preferences (for more information, see Section 35.3, "Setting Date and Time Preferences")

Additional column details include:

- Required

- Format

- Default Value

- Display Width

- Hint

For Format, select from:

- Date—For requiring a date.

- Time—For requiring a time.

- Date and Time—For requiring a date and a time.

The way the selected Format is rendered is controlled by the user's date and time preferences.

The Default Value field includes a date picker, which you can use to select a default date in the correct format. The current date has a box around it, for example, March 30th in the following figure.

This field does not require leading zeroes, for example, it does not require 05/04/2009. Instead, you can use 5/4/2009.

Boolean

Either TRUE or FALSE

Additional column details include:

- Default Value

- Display Width

- Hint

TRUE or FALSE is rendered as a checkbox. Checked equals TRUE; cleared equals FALSE.

Picture

A directory path to an image (the image is rendered in list view mode)

Additional column details include:

- Required

- Display Width

- Hint

Person

A valid user name

Additional column details include:

- Required

- Range of Users

- Default Value

- Display Width

- Hint

The Range of Users field enables you to limit the valid range of users to the membership of the current Space (or to include all users). The Default Value field includes a Find user icon, which you can use to locate and select a default user. Click the Find user icon, and in the resulting dialog, enter, minimally, two consecutive characters from the name of your search target, using an asterisk as a wild card for preceding or following characters (the search term *do finds both condoleeza and doug). Click the Search icon, and all names in your company LDAP directory that match your search criteria appear in the results area. To populate the Default Value field with your selection, select a user and click OK.

The list column contains a presence indicator next to the user name. Click the presence indicator to open a context menu with options for making contact with the person instantly. For more information, see Section 62.4.1, "Viewing the Status of Other Users."

Footnote 1 Number data-type columns adhere to the range and precision specified for the 8 byte IEEE 754 double data type. When the maximum number of significant digits is exceeded, the number is rounded.

6. After you select a data type, enter values for the remaining fields.

Table 64-2 lists the possible remaining fields and their associated data types.

Table 64-2 Data Type Column Details

Column Detail

Description

Associated Data Type(s)

Allow Links

Specify whether to allow column data to be hyperlinked. Specifying Allow Links enables the user to enter both a column value and a URL. If a URL is specified, the column value is rendered as a hyperlink.

Plain Text

Default Value

Optionally, provide a default value for the column entry, such as a default image, number, user name, and the like.

- Plain Text

- Number

- DateTime

- Boolean

- Person

Display Width

Enter a value in pixels to set the column width.

All data types

Format

Use this pick list to specify the format for column values. For more information, see Table 64-1.

- Number

- DateTime

Hint

Enter text to assist the user in understanding the content to enter into the column. This text appears when focus is on this column in edit list data mode.

All data types

Link Window

Indicate how a hyperlink on column data should open.

Choose from:

- New Window—The link opens in a new browser tab or window.

- Current Window—The link opens in the current browser window.

Plain Text

Maximum Length

Enter the maximum number of characters for this column entry. This includes character spaces.

Plain Text

Maximum Value

Indicate the highest number that can be entered in this column.

Number

Minimum Value

Indicate the lowest number that can be entered in this column.

Number

Number of Lines for Editing

Indicate the number of lines to make available for editing. When the value is 1, the user enters data in a single line text field when editing list data. Long values scroll horizontally. When the value is greater than 1, the user enters data in a multiline text field. Long values scroll vertically. This makes entering and viewing large values much easier.

Plain Text

Range of Users

Indicate whether to limit the selection of users to members of the current Space (Space Members) or to allow a selection from all authenticated users (All Users).

Person

Required

Select this checkbox to require that data is entered in this column.

- Plain Text

- Rich Text

- DateTime

- Number

- Picture

- Person

7. Click OK to save your changes and exit the dialog.

8. Click Close to exit List Edit mode.

64.2.3.2.3 Revising List Column Details

You can revise every detail of a list column. That is, you can rename the column, change the column data type, require a value, or remove a value requirement. Keep in mind, however, if you change a column data type, any values currently entered in the list column are either converted to the new data type or removed irrevocably.

For example, if you move from a Plain Text data type to a Number data type, values that can be converted to a number are retained; other values are removed. Before any values are removed by the change, you are asked for confirmation. In contrast, if you move from a Number data type to a Plain Text data type, all values are retained.

Note:

Validation occurs only on data entry. If a user changes column details after data has been entered into the column, the existing data is not affected (that is, validated) even if it does not meet the new column detail conditions on the columns.

If you want to validate new list data, you can export the list data to an Excel spreadsheet and then import it. On import, all rows are validated. The rows that fail validation are noted. You can fix invalid rows in the spreadsheet and import again.

See Also:

For more information, see Section 64.2.7, "Exporting a List and Importing a List from an Excel Spreadsheet."

To revise list column details:

1. Go to the Lists page of the Space where you want to revise list column details.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list you want to change and click the Edit list icon (Figure 64-14).

Figure 64-14 Edit List Icon

The Lists page enters edit list mode (Figure 64-15).

Figure 64-15 List in Edit List Mode

3. Under Columns, select the list column you want to revise and click the Edit button to open the Edit Column dialog (Figure 64-16).

Figure 64-16 Edit Column Dialog

4. Edit column details as you prefer.

For information about column details, see Section 64.2.3.2.2, "Adding Columns to a List."

5. Click OK to save your changes and close the dialog.

6. Click the Close button to exit edit list mode.

64.2.3.2.4 Rearranging List Columns on All Instances of a List

You can rearrange list columns in the list structure, affecting all instances of a list, by clicking rearrange icons or by dragging and dropping.

See Also:

For information about rearranging column order of a particular list instance in your view or everyone's view, see Section 64.2.5.3, "Changing Column Order on a List Instance."

To rearrange columns on all instances of a list:

1. Go to the Lists page of the Space where you want to rearrange list columns.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list you want to change and click the Edit list icon to enter list edit mode.

3. Under Columns, click an icon under the Reorder column to move a column higher or lower in the order of columns (Figure 64-17).

Figure 64-17 Reorder Column Icons on Edit List Page

Tip:

Moving a column higher causes it to appear further to the left in column display order. Moving a column lower causes it to appear further to the right.

Alternatively, drag and drop a column higher or lower in the column hierarchy.

4. Click the Close button to exit list edit mode.

64.2.3.2.5 Deleting a List Column

To delete a list column:

1. Go to the Lists page of the Space where you want to delete list columns.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list you want to change and click the Edit list icon to enter list edit mode (Figure 64-18).

Figure 64-18 List in Edit List Mode

3. Select a column, and click the Delete button (Figure 64-19).

Figure 64-19 Delete Button on Edit List Page

4. In the resulting confirmation dialog, click the Delete button to complete the deletion.

64.2.3.3 Copying a List

You can use an existing list as a template simply by copying it. First, copy the list, and then edit the copied list as you like.

To copy a list:

1. Go to the Lists page of the Space that contains the list you want to copy.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list you want to copy.

3. Click the Copy List icon (Figure 64-20).

Figure 64-20 Copy List Icon on Lists Page

A copy of the list becomes available for selection in the Lists panel (Figure 64-21).

Figure 64-21 A List Copy

See Also:

For information about changing the list name or description, see Section 64.2.3.2.1, "Renaming a List and Revising a List Description." For information about revising list structure, see Section 64.2.3.2, "Editing List Structure."

64.2.3.4 Deleting Lists

To delete a list:

1. Go to the Lists page of the Space that contains the list you want to delete.

See Also:

For information about navigating to a Lists page, see Section 64.2.2, "Viewing Lists."

2. In the Lists panel, select the list you want to delete.

To select multiple lists, use Ctrl+Click; to select a range of lists, use Shift+Click.

3. Click the Delete list icon (Figure 64-22).

Figure 64-22 Delete List Icon on Lists Page

4. In the resulting confirmation dialog, click the Delete button.

After confirmation, the selected lists are removed from the Lists panel.

64.2.4 Adding and Managing List Data

Once you have created a list structure, you can add data to the list. This section describes how to add, edit, and refresh list data, and how to delete lists rows. It includes the following subsections:

- Section 64.2.4.1, "Adding Data of a Given Data Type to a List"

- Section 64.2.4.2, "Editing List Data"

- Section 64.2.4.3, "Deleting List Rows"

- Section 64.2.4.4, "Refreshing List Data"

See Also:

For information about list structure, see Section 64.2.3, "Creating and Managing Lists." For information about list data types, see Table 64-1, "Data Type Selections for List Columns" and Table 64-2, "Data Type Column Details".

64.2.4.1 Adding Data of a Given Data Type to a List

This section describes how to add data to a list. When you add data to a list, you do so row-by-row (unless you are importing a spreadsheet). The placement of a new row depends on the following considerations:

- When you add a new row, it is created after the selected row.

- If no row is selected, the new row is created as the first row.

- Once you save, list data is refreshed and rows are shown in sort order.

See Also:

for more information, see Section 64.2.5.1, "Sorting List Data on a Column"

You can add one or multiple list rows before you add content, or you can create a list row and add content to it right away.

This section provides an overview procedure for adding list data, and steps you through how to add data for a given data type. It includes the following subsections:

- Section 64.2.4.1.1, "Adding Data to a List"

- Section 64.2.4.1.2, "Adding Plain Text Data to a List"

- Section 64.2.4.1.3, "Adding Rich Text Data to a List"

- Section 64.2.4.1.4, "Adding DateTime Data to a List"

- Section 64.2.4.1.5, "Adding Picture Data to a List"

- Section 64.2.4.1.6, "Adding Person Data to a List"

Tip:

The Number and Boolean data types are not included here because, for a Number data type, you simply enter a number, and, for a Boolean data type, you simply select or clear a checkbox.

64.2.4.1.1 Adding Data to a List

To add data to a list:

1. Go to the Lists page or the List Viewer task flow that displays the list you want to populate with data, and click the Edit List Data icon to open the list in edit list data mode (Figure 64-23).

Figure 64-23 Edit List Data Icon

Tip:

You can also enter list edit mode by selecting Edit from the Actions menu or by pressing Crtl+E.

2. Click the Add a New Row icon to add a row to the list (Figure 64-24).

Figure 64-24 Add A New Row Icon on a List

Tip:

You can also start the add-row process by selecting Add Row from the Actions menu or by pressing Ctrl+I.

The new row is added after the selected row. If no row is selected, it is added as the first row (Figure 64-25).

Figure 64-25 A Newly Added Row

3. Add data to the new row.

Tip:

You can only edit the row with focus. Click a row to give it focus and edit it.

4. Repeat the previous two steps to create new rows and add data.

5. When you finish adding rows and data, click Save to save your changes and exit edit list data mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

When you save your changes, the list data is refreshed and the rows are rendered in sort order (for more information, see Section 64.2.5.1, "Sorting List Data on a Column").

64.2.4.1.2 Adding Plain Text Data to a List

The Plain Text data type allows for the entry of unformatted text, and provides options for making the text a link.

Tip:

To create a hyperlink on a Plain Text data type, the list column must be configured to allow for the creation of hyperlinks. For more information, see Section 64.2.3.2.2, "Adding Columns to a List."

To enter Plain Text data into a list row:

1. Enter edit list data mode as described in Section 64.2.4.1.1, "Adding Data to a List."

2. Go to the column that is formatted to support the Plain Text data type:

To enter unlinked text, enter text in the field provided.

To enter linked text:

1. Click the Edit Column Link icon to the right of the data entry field (Figure 64-26).

Figure 64-26 Edit Column Link Icon

2. In the resulting Edit Column Link dialog, enter text in the Text field, and enter a full URL in the Link Location field (Figure 64-27).

Figure 64-27 Edit Column Link Dialog

3. Click OK.

Tip:

To remove a link, click the Edit Column Link icon, and delete the URL from the resulting dialog.

3. When you finish adding rows and data, click Save to save your changes and exit edit list data mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

If both text and a link location were specified, the text is rendered as a hyperlink.

64.2.4.1.3 Adding Rich Text Data to a List

The Rich Text data type allows for the entry of rich, formatted text through a rich text editor. Rich text may include links.

See Also:

For information about using the Rich Text Editor, see Section 41.11, "Using the Rich Text Editor (RTE)."

To enter Rich Text data into a list row:

1. Enter edit list data mode as described in Section 64.2.4.1.1, "Adding Data to a List."

2. Go to the column that is formatted to support the Rich Text data type, and click the Edit Text icon to the right of the data entry field (Figure 64-28).

Figure 64-28 Edit Text Icon

This launches the rich text editor (Figure 64-29).

Figure 64-29 The Rich Text Editor

3. Enter text and apply styles according to your requirements.

4. To add a link:

1. Highlight the link text, and click the Add Link icon in the editor's toolbar (Figure 64-30).

Figure 64-30 Add Link through Rich Text Editor

2. In the resulting dialog, enter a URL in the field provided.

3. Click OK.

Tip:

To remove a link, highlight the linked text and click the Remove Link icon.

5. Click OK to exit the editor.

6. When you finish adding rows and data, click Save to save your changes and exit edit list data mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

64.2.4.1.4 Adding DateTime Data to a List

The DateTime data type allows for the entry of dates and times in the format specified in a given user's WebCenter Spaces Preferences (for more information, see Section 35.3, "Setting Date and Time Preferences").

To enter DateTime data into a list row:

1. Enter edit list data mode as described in Section 64.2.4.1.1, "Adding Data to a List."

2. Go to the column that is formatted to support the DateTime data type, and enter a value or click the Select <data type> icon to the right of the data entry field (Figure 64-31).

Figure 64-31 Select Date Icon

3. If you click the icon, from the resulting calendar, select a date, a time, or a date and time, according to the column's requirements (Figure 64-32).

Figure 64-32 Popup Calendar for Date Selection

4. If the column requires just a date, the calendar closes once you select a value.

If the calendar requires a time or a date and time, click OK to close the calendar.

5. When you finish adding rows and data, click Save to save your changes and exit edit list data mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

64.2.4.1.5 Adding Picture Data to a List

The Picture data type allows for the entry of a path to an image (the image is rendered in list view mode).

To enter a Picture data type into a list row:

1. Enter edit list data mode as described in Section 64.2.4.1.1, "Adding Data to a List."

2. Go to the column that is formatted to support the Picture data type, and enter a path to a picture or click the Edit Picture icon to the right of the data entry field (Figure 64-33).

Figure 64-33 Edit Picture Icon

3. If you click the icon, in the Edit Picture dialog, enter a directory path or a URL to an image in the Picture Location field (Figure 64-34).

For example, enter:

http://www.oracleimg.com/admin/images/ocom/hp/oralogo_small.gif

Or

d:/corporateImageBank/images/myimage.png

Figure 64-34 Edit Picture Dialog

Tip:

The image must be available in a location that does not require login credentials for access.

You can select an image that is located in your WebCenter Spaces Document Library. In a Documents service task flow, select the image and use the Get a Link option on the View menu to access a link to the image. Copy the link and paste it into the Picture Location field.

4. Provide ALT text for the image in the Description field.

5. Click OK.

6. When you finish adding rows and data, click Save to save your changes and exit edit list data mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

64.2.4.1.6 Adding Person Data to a List

The Person data type allows for the entry of a user name from your company's identity store. The selection of a Person may be further limited to the members of the current Space. If you search for a user name, the values returned indicate whether such a limit is in place.

To enter a Person data type into a list row:

1. Enter edit list data mode as described in Section 64.2.4.1.1, "Adding Data to a List."

2. Go to the column that is formatted to support the Person data type, and enter a user name or click the Find user icon to the right of the data entry field (Figure 64-35).

Figure 64-35 Find User Icon

3. If you click the icon, in the resulting Find user dialog, enter, minimally, two consecutive characters from the name of your search target, using an asterisk as a wild card for preceding or following characters (the search term *do finds both condoleeza and doug), and click the Search icon.

Either all names in your company LDAP directory, or those users who belong to the current Space, that match your search criteria appear in the results area (Figure 64-36).

Figure 64-36 Find User Dialog

4. Select a user, and click OK to populate the field with your selection.

5. When you finish adding rows and data, click Save to save your changes and exit edit list data mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

64.2.4.2 Editing List Data

When a list is in edit mode, you can edit one or multiple list rows. In edit mode, you can initiate a row edit simply by clicking within the row. You can continue to click in rows and edit row content until you exit edit mode.

To edit list data:

1. Go to the list that contains data you want to edit, and click the Edit List Data icon to open the list in edit mode (Figure 64-37).

Figure 64-37 Edit List Data Icon

2. Click a list row to revise its data (Figure 64-38).

Figure 64-38 A Row Open for Edit

Tip:

The type of list data affects the action that you take:

- To edit a Picture data type, click the Edit Picture icon next to the data entry field. Enter the URL to the picture and ALT text.

- To edit a Rich Text data type, click the Edit Text icon next to the data entry field to launch the editor.

- To edit a hyperlink in a column that allows links, click the Edit Link icon.

3. Continue clicking rows and revising data until you are finished.

4. Click Save to save your changes and exit edit list mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

64.2.4.3 Deleting List Rows

You can delete one or multiple list rows in one operation.

Tip:

selecting a row and clicking Delete marks a list row for deletion. The row is removed from your view, but the list data continues to exist in the WebCenter repository. The actual delete takes place when you save the change.

To delete one or multiple list rows:

1. Go to the list with rows to delete.

2. Click the Edit List Data icon to open the list in edit mode (Figure 64-39).

Figure 64-39 Edit List Data Icon

3. Select one or more rows to delete.

In Windows, use Ctrl+Click to select multiple rows. In UNIX, simply click multiple rows. In both operating systems, use Shift+Click to select a range of rows.

4. Click the Delete button above the list (Figure 64-40).

Figure 64-40 Delete Button and Selected Rows

The selected rows are marked for deletion removed from your view of the list.

5. Click Save to save your changes and exit edit list mode.

Tip:

To save, you can also select Save from the Actions menu, or press Ctrl+M. To close, click Close, select Close from the Actions menu, or press Ctrl+Q.

64.2.4.4 Refreshing List Data

All lists come with a Refresh List icon, which you can click to refresh the display of list data (Figure 64-41).

Figure 64-41 Refresh List Icon

64.2.5 Customizing Lists

You can perform user customizations on your own view of a list instance, or you can perform application customizations on a list instance, affecting everyone's view. User customizations involve changes made in page view mode; while application customizations involve changes made in page edit mode (that is, in Oracle Composer). Everyone can perform user customizations their own view of a list; but page edit privileges are always required for application-level list customizations.

User and application customizations apply to a list rendered in a List Viewer task flow. They do not apply to lists rendered on the Lists page.

A second instance of a list is not affected by the customizations you make to the first instance. For example, imagine that you have placed the Issues list on both the Sales page and the What's New page. If you sort the list by the Number column on the Sales page, the Issues list is not automatically sorted by Number on the What's New page.

While application customizations affect everyone's view of a list instance, user customizations are layered over them. For example, someone may perform an application customization on a list containing columns A, B, and C, so that column C is first in list column order (C, A, B). You can then perform a user customization on the list so that column A is first in list column order in your personal view of the same list instance (A, C, B).

Note:

In page edit mode, you see only application customizations. In page view mode, you see user customizations layered over application customizations. If the same property is set at both the application and user levels, the user value takes precedence in your own view.

This section describes various application- and user-level customizations you can make to a list instance. It includes the following subsections:

- Section 64.2.5.1, "Sorting List Data on a Column"

- Section 64.2.5.2, "Resizing List Columns"

- Section 64.2.5.3, "Changing Column Order on a List Instance"

- Section 64.2.5.4, "Hiding and Showing List Columns"

- Section 64.2.5.5, "Freezing a Column Position"

- Section 64.2.5.6, "Wrapping Column Data"

- Section 64.2.5.7, "Applying Color Banding to List Rows"

- Section 64.2.5.8, "Filtering List Data"

64.2.5.1 Sorting List Data on a Column

By default, list data is sorted by create date. You can control the sort order of list data by clicking sort icons in each column's header. You can perform an advanced sort using View menu options.

Sort list data in the List Viewer task flow. You can sort list data on the Lists page, but the sort is not persisted. It will revert back if you change lists or navigate away from the page.

To sort list data on a column in your view, perform the actions described in this section in page view mode. To sort list data on a column in everyone's view, perform the actions described in this section in page edit mode.

This section describes regular and advanced sorting. It includes the following subsections:

- Section 64.2.5.1.1, "Sorting List Data Using Column Icons"

- Section 64.2.5.1.2, "Performing an Advanced Sort of List Data"

Note:

When your WebCenter Spaces application is running against an Oracle database, a click on a column header in the List View results in a linguistic sort based on your locale. For non-Oracle databases, the sorting is based on the linguistic sorting specified in the database (collation in the case of SQL Server). This means when you connect to a WebCenter Spaces instance in different languages, list rows are sorted according to the default collation of the database, regardless of the language your application is currently using.

64.2.5.1.1 Sorting List Data Using Column Icons

To sort list data on a column using column icons:

1. Go to the list instance you want to change.

2. Go to the column you want to use to control the sort, roll your mouse over the column header, and click the Sort Ascending icon to sort the list in ascending order (1, 2, 3, a, b, c); or click the Sort Descending icon to sort the list in descending order (c, b, a, 3, 2, 1) (Figure 64-42).

Figure 64-42 Sort Icons on a List Column

Tip:

You can also sort list data on a column by selecting a column and then selecting Sort and then Ascending or Descending from the View menu. You can right-click a column and select these options from a context menu.

64.2.5.1.2 Performing an Advanced Sort of List Data

The View menu provides an Advanced option that presents another way to sort list data.

To use the Advanced option to sort list data:

1. Go to the list instance you want to change.

2. From the View menu, select Advanced to open the Advanced Sort dialog (Figure 64-43).

Figure 64-43 Advanced Sort Dialog

3. From the Sort By list, select the column to be considered first in sorting list data.

The Sort By and Then By fields are arranged in order of precedence, with Sort By considered first, and Then By in second and third positions.

4. Select either Ascending, to sort list data on the selected column in ascending order (1, 2, 3, a, b, c), or Descending, to sort list data on the selected column in descending order (c, b, a, 3, 2, 1).

Note:

Currently, you can sort against only one column. Look to future releases for this feature to be fully realized.

5. Click OK.

Tip:

You can access the options described in this section by right-clicking a column header and selecting from a context menu.

64.2.5.2 Resizing List Columns

You can control the width of a list column by dragging it wider or by setting a specific column width through a dialog. You can also control column width by expressing a default width in column details (for more information, see the Display Width detail in Table 64-2, "Data Type Column Details").

Resize columns in the List Viewer task flow. You can resize columns on the Lists page, but these are not persisted and will revert back when changing lists or navigating away.

To resize list columns in your view, perform the following actions in page view mode. To resize list columns in everyone's view, perform the following actions in page edit mode.

Note:

To resize list columns, the list must contain at least one row.

To resize list columns:

1. Go to the list instance you want to change.

2. Resize columns using one of the following methods:

- Click and hold on a column splitter, and drag it to make the column wider or narrower.

- In the list, select the column to resize.

From the Format menu, select Resize Columns.

In the resulting dialog, enter a column width and select a unit of measure (Figure 64-44).

Figure 64-44 Resize Column Dialog

Choose from:

- Pixels—To express column width in a specified number of pixels.

- Percent—To express column width as a percentage of the total list width.

Click OK.

Tip:

You can access the options described in the section by right-clicking a column and selecting from a context menu.

64.2.5.3 Changing Column Order on a List Instance

You can rearrange the order of list columns by dragging a column and dropping it to the desired position or by using the reorder dialog.

Change column order in the List Viewer task flow. You cannot change column order on the Lists page.

To change column order on a list instance in your view, perform the following actions in page view mode. To change column order on a list instance in everyone's view, perform the following actions in page edit mode.

Note:

To reorder columns by dragging, the list must have at least one row.

To change column order:

1. Go to the list instance you want to change.

2. Rearrange list columns using one of the following methods:

- Click and hold on a list column title, and drag and drop it to the desired location.

- Select Reorder Columns from the View menu.

In the resulting dialog, select a column and click a Move icon to the right of the list of Visible Columns to reposition your selection (Figure 64-45).

Figure 64-45 Reorder Columns Dialog

Repeat until you have columns arranged in the desired order.

Click OK.

Tip:

You can access the options described in the section by right-clicking a column and selecting from a context menu.

64.2.5.4 Hiding and Showing List Columns

You can use an option on a list's View menu to hide selected list columns. To hide or show columns in your view, perform the following actions in page view mode. To change column order in everyone's view, perform the following actions in page edit mode.

Hide or show list columns in the List Viewer task flow. You can hide or show columns on the Lists page, but this setting is not persisted and reverts back when changing lists or navigating away.

To hide or show list columns:

1. Go to the list instance you want to change.

2. On the View menu, open the Columns submenu (Figure 64-46):

Figure 64-46 Columns Submenu on View Menu

- Select a column you want to show (a check appears on the menu next to shown columns).

- Clear a column you want to hide (no check appears on the menu next to hidden columns).

- Select Show All to show all columns (all columns are checked on the menu).

64.2.5.5 Freezing a Column Position

When a list is too wide to display all of its columns in one view, you can scroll the list left and right. If there is a column you always want to keep in view, you can use column freezing to hold a column in place during scrolling. Freezing causes a selected column to hold its position while the columns to the right of it scroll by. You can set Freeze on one column on a given list instance. Freezing holds in place the selected column and any column to the left of it.

Note:

To freeze a column position in your view, perform the following actions in page view mode. To freeze a column position in everyone's view, perform the following actions in page edit mode.

To freeze a column position:

1. Go to the list with a column you want to freeze.

2. Select the relevant column by clicking its header.

The Freeze icon becomes available.

3. Click the Freeze icon (Figure 64-47).

Tip:

You can also freeze a column by selecting it and then selecting Freeze from the View menu.

Figure 64-47 Freeze Icon

To unfreeze a column, select it as described in step 2, and click the Freeze icon again.

Tip:

You can access the options described in the section by right-clicking a column and selecting from a context menu.

64.2.5.6 Wrapping Column Data

Use the Wrap feature to control whether to allow column data to wrap in a selected list column. Data that wraps breaks onto additional lines if it would otherwise exceed the column width. Data that does not wrap, shows only as much data as fits into the current column width (you can widen the column to view the data if you prefer, see Section 64.2.5.2, "Resizing List Columns").

Note:

By default, column data is wrapped.

To wrap column data:

1. Go to the list in which to wrap column data.

2. Select the relevant column by clicking its header.

3. Click the Wrap icon.

Tip:

You can also wrap data by selecting the column and then selecting Wrap from the Format menu.

You can access the options described in the section by right-clicking a column and selecting from a context menu.

If any data was previously truncated, it now appears in the row with line breaks to accommodate the column's width.

To turn wrapping off, select the relevant column and click the Wrap icon again.

64.2.5.7 Applying Color Banding to List Rows

Color banding refers to a transparent overlay of color applied at specified intervals to list rows or columns. When you define color banding on a list, you specify whether to apply color banding and how often to apply it.

You can easily enhance the readability of a list by applying row or column color banding (Figure 64-48).

Figure 64-48 List with Color Banding

You can apply color banding to your personal view of a list instance or to everyone's view of a list instance. This section describes how. It contains the following subsections:

- Section 64.2.5.7.1, "Applying Color Banding to Your Personal View of a List"

- Section 64.2.5.7.2, "Removing Personal Color Banding"

- Section 64.2.5.7.3, "Applying Color Banding to Everyone's View of a List Instance"

- Section 64.2.5.7.4, "Removing Color Banding from Everyone's View of a List"

64.2.5.7.1 Applying Color Banding to Your Personal View of a List

You can apply color banding to list rows or to list columns.

To apply color banding to your personal view of a list instance:

1. Go to the list you want to change.

2. Click the Personalize icon on the task flow header (Figure 64-49).

Figure 64-49 Personalize Icon

The List Viewer enters personalize list mode (Figure 64-50).

Figure 64-50 List in Personalize List Mode

3. From the Banding pick list, select a banding style for the list instance.

Choose from:

- Row—To specify color banding on list rows.

- Column—To specify color banding on list columns.

- None—To turn color banding off.

4. In the Interval field, enter the number of rows or columns to skip between color bands.

For example, when you apply color bands to rows, a value of 1 applies a color band to the second row, fourth row, sixth row, and so on. Figure 64-51 illustrates an interval value of 1.

Figure 64-51 List with Color Banding

5. Click Save to save your settings and return to the list.

List data is refreshed, now reflecting your color banding settings.

64.2.5.7.2 Removing Personal Color Banding

To remove personal color banding from a list:

1. Go to the list from which to remove color banding.

2. Click the Personalize icon on the task flow header (Figure 64-52).

Figure 64-52 Personalize Icon

The List Viewer enters personalize list mode.

3. From the Banding pick list, select None.

4. Click Save to save your settings and return to the list.

List data is refreshed, now showing no color banding.

64.2.5.7.3 Applying Color Banding to Everyone's View of a List Instance

When you want your color banding settings to affect everyone's view of a particular list instance, follow the steps in this section.

Note:

If you have previously performed a user customization on a list instance to omit color banding, you may need to reset your user customization, as described in Section 64.2.5.7.1, "Applying Color Banding to Your Personal View of a List." Your user customizations take precedence over Space-level customizations, and thus may prevent you from seeing the change described in this procedure.

To apply color banding to everyone's view of a list instance:

1. Go to the list you want to customize with color banded rows or columns.

2. Enter edit page mode.

See Also:

For information about entering edit page mode, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

The page opens in Oracle Composer.

3. Go to the list instance you want to customize, and click the Edit icon on the task flow header (Figure 64-53).

Figure 64-53 Edit Icon on the Task Flow Header in Page Edit Mode

The list enters customize list mode (Figure 64-54).

Figure 64-54 Customize List Mode

4. Configure color-banding settings as described in Section 64.2.5.7.1, "Applying Color Banding to Your Personal View of a List."

5. Click Close to exit Oracle Composer.

64.2.5.7.4 Removing Color Banding from Everyone's View of a List

To remove color banding from everyone's view of a list instance:

1. Go to the list from which to remove color banding.

2. Enter edit page mode.

See Also:

For information about entering edit page mode, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

The page opens in Oracle Composer.

3. Go to the list instance you want to customize, and click the Edit icon on the task flow header (Figure 64-55).

Figure 64-55 Edit Icon on the Task Flow Header in Page Edit Mode

The List Viewer enters customize list mode.

4. From the Banding pick list, select None.

5. Click Save to save your changes and exit customize list mode.

The list refreshes, with color banding removed.

6. Click Close to exit Oracle Composer.

64.2.5.8 Filtering List Data

The Lists service provides data filtering options for your personal view of a list instance and for everyone's view of the instance. Filtering provides a means of limiting the display of list data to those rows that match your filtering criteria.

Temporary, personal filtering (also called ad hoc filtering) is available with both the List Viewer task flow and Lists page. Custom filtering that affects everyone's view of a list instance is available only with the List Viewer task flow.

This section describes the processes of applying ad hoc, permanent personal, and permanent list filters. It contains the following subsections:

- Section 64.2.5.8.1, "Applying an Ad Hoc Filter to a List Instance"

- Section 64.2.5.8.2, "Applying a Permanent, Personal Filter to a List Instance"

- Section 64.2.5.8.3, "Removing a Permanent, Personal List Filter"

- Section 64.2.5.8.4, "Applying Filters to Everyone's View of a List"

- Section 64.2.5.8.5, "Removing Filters from Everyone's View of a List"

64.2.5.8.1 Applying an Ad Hoc Filter to a List Instance

Use ad hoc list filtering to easily find a particular list entry or group of entries in a list instance.

Note:

Ad hoc list filtering applies only to Plain Text and Person data types. Columns that use other data types, such as Date and Number, are not used in ad hoc filtering. For example, if you have dates shown in format dd-mon-yy and you filter on jan, you do not see rows with dates in January.

To apply an ad hoc filter to a list instance:

1. Go to the list that contains the data you want to temporarily filter.

2. Click the Filter Rows icon in the List toolbar (Figure 64-56).

Figure 64-56 Filter Rows Icon

Tip:

You can also select Filter Rows from the Actions menu.

The Filter field opens (Figure 64-57).

Figure 64-57 The Filter Field

3. Enter space-separated keywords in the Filter field, and click the Filter icon to execute the filter.

All row details that match any of the keywords are shown.

4. Click the Filter Rows icon again to hide the Filter field and remove the temporary filter.

Tip:

You can also select Cancel Filter from the Actions menu.

64.2.5.8.2 Applying a Permanent, Personal Filter to a List Instance

In addition to an ad hoc filter, you can apply a permanent personal filter to your view of a list instance. We use the term permanent to convey the fact that you can keep your list filtered in a particular way for as long as you like. The filter is retained across page navigations within a browser session and across browser sessions.

It is still possible to remove such a filter. This section describes how to apply and remove a permanent personal filter.

To apply or remove a permanent filter on your view of a list instance:

1. Go to the list that contains the data you want to permanently filter.

2. Click the Personalize icon on the task flow header (Figure 64-58).

Figure 64-58 Personalize Icon

The list enters personalize list mode (Figure 64-59).

Figure 64-59 List in Personalize List Mode

3. From the Add Filter list, select a column against which to apply a filter.

The selected column appears, ready for a filter definition.

4. Select an operator from the list, and enter the filter content in the field provided (Figure 64-60).

Figure 64-60 Filter Operator and Content

The filter operators that appear on the list vary according to the data type of the selected column. Table 64-3 lists and describes filter operators as they apply to different data types.

Table 64-3 Filter Operators for List Data Types

Data Type

Description

Boolean

Use Boolean data type filter operators to specify that Boolean values in the selected list column must:

- = —Match the value you specify

- <>—Not match the value you specify

The Boolean value is expressed as a checkbox. A checked box means TRUE or YES; a cleared box means FALSE or NO.

DateTime

Use DateTime data type filter operators to specify that date and time values in the selected column must be:

- = —The same as the date or date and time that you specify

- >= —More recent or the same as the date or date and time that you specify

- <>—Any date or date and time other than the value you specify

- >—More recent than the date or date and time that you specify

- <= —Preceding or matching the date or date and time that you specify

- <—Preceding the date or date and time that you specify

Number

Use Number data type filter operators to specify that number values in the selected column must be:

- = —Equal to the value you specify

- >= —Equal to or greater than the value you specify

- <>—Greater or lesser than the value you specify

- >—Greater than the value you specify

- <= —Equal to or lesser than the value you specify

- <—Lesser than the value you specify

Person

Use Person data type filter operators to specify that person values in the selected list column must:

- = —Match the user name you specify

- Starts With—Start with the character(s) you specify

- Ends With—End with the character(s) you specify

- Contains—Include the character(s) you specify

- <>—Contain any user name other than the one you specify

Picture

You cannot apply filter operators to a Picture data type in a list.

Plain Text

Use Plain Text data type filter operators to specify that values in the selected column must:

- = —Match the characters you specify

- Starts With—Start with the character(s) you specify

- Contains—Include the character(s) you specify

- Ends With—End with the character(s) you specify

- <>—Contain any value other than the one you specify

Rich Text

You cannot apply filter operators to a Rich Text data type in a list.

5. When you define multiple filters, Match All Any options appear:

- Select All to require that displayed rows match all conditions.

- Select Any to require that displayed rows match at least one condition.

6. Click Save to save your filter criteria and return to the list.

The list is refreshed, now displaying data that matches your filter criteria.

64.2.5.8.3 Removing a Permanent, Personal List Filter

To remove a permanent, personal list filter:

1. Go to the list from which you want to remove personal filtering.

2. Click the Personalize icon on the task flow header (Figure 64-61).

Figure 64-61 Personalize Icon

The List Viewer enters personalize list mode.

3. Click the Remove icon next to the filtering criteria you want to remove (Figure 64-62), and then click Save.

Figure 64-62 Remove Icon on a Filter

List data is refreshed, now displaying any data previously hidden by a filter.

64.2.5.8.4 Applying Filters to Everyone's View of a List

If you want the list filters you create to apply to all users' views of a particular list instance, simply create the filters in page edit mode.

To apply filters to everyone's view of a list:

1. Go to the list that contains the data you want to filter from everyone's view.

2. Enter edit page mode.

See Also:

For information about entering edit page mode, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

The page opens in Oracle Composer.

3. Go to the task flow instance you want to filter, and click the Edit icon on the task flow header (Figure 64-63).

Figure 64-63 Edit Icon on the Task Flow Header in Page Edit Mode

The list enters customize list mode (Figure 64-64).

Figure 64-64 Customize List Mode

4. Create and apply filtering criteria as described in Section 64.2.5.8.2, "Applying a Permanent, Personal Filter to a List Instance."

5. Click Close to exit Oracle Composer.

See Also:

For information about removing a filter from everyone's view of a list instance, see Section 64.2.5.8.5, "Removing Filters from Everyone's View of a List."

64.2.5.8.5 Removing Filters from Everyone's View of a List

To remove a filter from everyone's view of a list:

1. Go to the list from which to remove a filter.

2. Enter edit page mode.

See Also:

For information about entering edit page mode, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

The page opens in Oracle Composer.

3. Click the Edit icon on the List Viewer task flow header (Figure 64-65).

Figure 64-65 Edit Icon on the Task Flow Header in Page Edit Mode

The list enters customize list mode.

4. Click the Remove icon next to the filters you want to remove (Figure 64-66), and then click Save.

Figure 64-66 Remove Filter Icon

List data is refreshed, now displaying all unfiltered data.

5. Click Close to exit Oracle Composer.

64.2.6 Sending a Link to a List to Other Users

The list Actions menu includes a Send Mail option for sending a link to a list through a mail message.

To send a link to a list through mail:

1. Log in, and go to the list instance you want to send as a link through mail.

2. From the list Actions menu, select Send Mail (Figure 64-67).

Figure 64-67 Send Mail Option on Actions Menu

A compose message window opens, addressed to Space members, with the following information:

- The name of the Space from which the list instance originates

- The list title and description

- A link to the Space

- A link to the list instance

Users click the link to the list instance to open a view of the list.

Note:

To view the list, users must have access to the Space that contains the list instance.

3. Compose the message and send as you would any other mail message.

64.2.7 Exporting a List and Importing a List from an Excel Spreadsheet

The Lists service provides a means of exporting and importing lists. If you can view the list, you can export it to Microsoft Excel 1997 - 2003 and 2007 formats and revise list data in Excel. If you sufficient privileges to edit the list, you can import the revised list back into WebCenter Spaces.

Tip:

You can also create a list by importing an Excel spreadsheet. For more information, see Section 64.2.3.1, "Creating Lists."

This section describes how to export and import lists and provides information about additional software that may be of use in this process. It includes the following subsections:

- Section 64.2.7.1, "What You Should Know About Exporting and Importing Lists"

- Section 64.2.7.2, "Exporting a List to a Spreadsheet"

- Section 64.2.7.3, "Importing an Exported List"

64.2.7.1 What You Should Know About Exporting and Importing Lists

Use list export and import to add and revise list rows in a Microsoft Excel spreadsheet. List structure and links for the list and list rows are unaffected by export and import. When exporting a list, only the list data is exported, not the list structure nor the links. When a list is imported, new links and modified links will not be affected by the import.

After you export a list, if other changes are made to list data in WebCenter Spaces, they are overwritten when you import the list. Before content is overwritten, a confirmation dialog provides you with an opportunity to stop the import and preserve the WebCenter Spaces changes.

Importing a spreadsheet cannot be used to modify list structure. However, you can import any spreadsheet to a list that has the same columns. A warning is raised if the spreadsheet was not created from an export of the list, but you can dismiss this warning and proceed if desired. You can also export a rowless list to a spreadsheet, add rows in Excel, and then import it.

You must take care when you export a list not to revise list structure in Excel nor in WebCenter Spaces. You cannot import an exported list if the list structure is changed in WebCenter Spaces after export. You can add and remove list rows in the spreadsheet; such changes are reflected in the list on import.

Adding and removing list columns in the spreadsheet does not affect the list structure. Consequently, when you import a spreadsheet with columns that were removed through Excel, the import succeeds. The columns continue to appear in the imported list; though the deleted column data does not.

When you export a list from WebCenter Spaces, you are prompted for the Excel format (1997 - 2003 and 2007 formats are offered). To import a spreadsheet, the same formats are accepted.

64.2.7.2 Exporting a List to a Spreadsheet

When you can view a list, you can export the list to a Microsoft Excel file. Exporting enables you to use your Excel skills to easily add to and revise list data. Controls for exporting lists are available in both the List Viewer task flow and on the Lists page.

To export a WebCenter Spaces list:

1. Go to the list you want to export, and select Export from the Actions menu.

2. Select a format for the output file:

- MS Excel 2007

- MS Excel 1997 - 2003

3. Follow your browser's prompts to save the exported file to your local file system.

The list is saved in the Excel format you select. The file name is the list name, with underscores in lieu of character spaces. For example, my list becomes my_list.xlsx or my_list.xls.

64.2.7.3 Importing an Exported List

After you have created or revised list data and saved it in an Excel format, you can import it using controls available in both the List Viewer task flow and on the Lists page. To import list data, you must have, minimally, Edit permission on the page that contains the list.

To import an exported list:

1. Go to the list into which to import a spreadsheet, and select Import from the Actions menu.

2. In the Import from Excel dialog (Figure 64-68), click the Browse button and navigate to and select the relevant spreadsheet.

Note:

The spreadsheet must have the same columns as the list.

The file must be in Excel 1997-2003 (*.xls) or 2007 format (*.xlsx).

Figure 64-68 Import from Excel Dialog

3. Click Import.

If the spreadsheet was not created from an export of the list, a warning is given. Click Import to proceed.

The list is refreshed, now displaying the imported data. List data is validated on import. If any rows contain validation errors, such errors are presented in a dialog and the import is terminated. You can correct validation errors in the spreadsheet and import again.

64.3 Setting List Viewer Task Flow Properties

The List Viewer task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 64-69).

Figure 64-69 List Viewer Task Flow Parameters in the Component Properties Dialog

See Also:

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties associated with the List Viewer task flow and describe the parameters that are unique to it:

- Section 64.3.1, "What You Should Know About List Viewer Task Flow Properties"

- Section 64.3.2, "List Viewer Task Flow Parameters"

64.3.1 What You Should Know About List Viewer Task Flow Properties

When you set property values on a List Viewer task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 64.3.2, "List Viewer Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

64.3.2 List Viewer Task Flow Parameters

Table 64-4 describes the parameters that are unique to the List Viewer task flow. Note that List Viewer task flow parameter values are set automatically and should not be changed.

Table 64-4 List Viewer Task Flow Parameters

Parameter

Description

List ID

A unique identifier for the list to show

Either List ID or Local List ID must have a value. This value is set automatically. Do not edit this value.

List Scope ID

A unique identifier for the scope containing the list

If no value is present, the current scope is used. This value is set automatically. Do not edit this value.

Local List Customization ID

A unique identifier within the scope for the list customization

This value is set automatically. Do not edit this value.

Local List ID

A unique identifier within the scope for the list to show

Either List ID or Local List ID must have a value. This value is set automatically. Do not edit this value.

Show List Name and Description

A checkbox for specifying whether to display the list name and description

If no value is present, the list name and description are not shown. Values include true and false. This value is set automatically. Do not edit this value.

65 Working with the Mail Service

This chapter describes how to use the Send Mail feature and also the features provided through the Mail service. The Send Mail feature does not require the Mail service. That is, even if the Mail service has not been configured in your application, you can use the Send Mail feature with your local mail client.

This chapter includes the following sections:

- Section 65.1, "What You Should Know About the Send Mail Feature"

- Section 65.2, "What You Should Know About the Mail Service"

- Section 65.3, "Selecting Your Preferred Mail Connection"

- Section 65.4, "Working with the Mail Service Task Flow"

- Section 65.5, "Setting Mail Service Task Flow Properties"

Audience

This chapter is intended for users who want to use and manage mail, as well as WebCenter Spaces administrators with the Application-Manage Configuration permission and individual Space moderators who want to configure mail within their Spaces. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

Note:

Tasks discussed in this chapter are not available if the Mail service is not enabled in the current Space.

65.1 What You Should Know About the Send Mail Feature

Throughout the WebCenter application, you can click the Send Mail icon to mail directly from that resource (Figure 65-1).

Figure 65-1 Send Mail Icon

For example, Figure 65-2 shows a discussion topic with the Send Mail icon.

Figure 65-2 Send Mail Icon in a Discussion Topic

Click the Send Mail icon to open a mail compose window prepopulated with information including the discussion topic title, author, date created, topic text, and links to the discussion and the Space. You can edit and add to the mail, as necessary.

Figure 65-3 Mail Compose from a Discussion Topic

The way the mail window is prepopulated depends on the resource sending it. For example, from a wiki, Send Mail opens a mail window prepopulated with the name of the wiki, the size, who created it and when, who modified it and when, and a URL link to the wiki.

With Spaces, the mail can be addressed to all members of the Space. Space moderators (and anyone granted the Manage Configuration permission on the Space) set this through the Services page in the Space administration settings. For more information, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List."

If the number of recipients is so large that the mail cannot be prepopulated with the addresses, then you must either enter the addresses manually or set up a distribution list for the Space.

Tips:

With the Microsoft Outlook local mail client, you must configure Outlook to support comma-delimited mail addresses; that is, choose the Allow comma as address separator checkbox on the Tools - Options - Preferences - E-mail Options - Advanced E-mail Options page.

65.1.1 Configuring the Send Mail Feature

The Send Mail feature does not require the WebCenter Mail service. That is, even if the Mail service has not been configured in your application, the Send Mail feature is available using your local mail client.

Your administrator determines the mail client that the Send Mail feature uses: either the WebCenter Mail service or a local mail client. The default value is a local mail client. If your administrator enabled users to override this mail client setting, then you can choose to use a different mail client on the Mail Preferences page (Figure 65-4).

Figure 65-4 Mail Preferences for Send Mail

65.2 What You Should Know About the Mail Service

The Mail service conveniently exposes familiar mail functionality in your WebCenter application interface. The Mail service runs against the same mail server that provides your regular business mail, and the mail messages exposed in your WebCenter application are the same messages you would see in your mail inbox. Many of the same actions are also supported. For example, you can send messages with attachments, forward messages, and so on. The Mail service does not replace your company mail, but rather enhances it by making it accessible within WebCenter.

The Mail service enables users to perform simple mail functions, such as view, read, create and create with attachments, reply, forward, and delete. All mail is stored in your inbox and can be accessed from there through a link.

The Mail service fetches mails from the inbox folder only. It does not support fetching mails from other folders or moving messages.

The Mail service supports any mail server based on IMAP4 and SMTP protocol. A WebCenter Spaces application provides access to multiple mail connections. You can use a different mail connection by selecting it in the application's Preferences settings. For more information, see Section 65.3, "Selecting Your Preferred Mail Connection."

Note:

You can add a Mail task flow to your page from the Catalog dialog in Oracle Composer. For information about adding a task flow, see Section 17.5, "Adding Resource Catalog Components to Pages."

However, all instances of the Mail task flow in an application run against the same mail server and it serves no purpose to add multiple Mail task flow instances. This is true for all service task flows that require connections to back-end servers, for example, task flows from Discussions, Announcements, and IMP services.

The Mail service exposes features from your mail server through the Mail task flow, available to both WebCenter Portal applications and WebCenter Spaces (Figure 65-5).

Figure 65-5 The Mail Task Flow

The Mail task flow presents the following features:

- A menu for specifying which messages to display

- A Compose icon for starting the process of creating a new message

- A Refresh icon for updating the task flow with new messages

A Space moderator can configure the Mail service to automatically create a mailing list of all Space members. Once configured, as members are added to or deleted from the Space, the mailing list is updated automatically. For more information, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List." All mails sent to a Space mailing list are also posted to the Space discussion forum.

Use the Mail service to mail other WebCenter application users or any user recognized by the back-end server that supports the Mail service.

The Mail service is integrated with the Instant Messaging and Presence (IMP) service to provide additional options for contacting others. Each mail message includes the sender's user name and status icon (Figure 65-6), which you can click to open a context menu with options for starting a chat session or sending a new mail.

Note:

If the IMP service is not configured in your application, the status icons are grayed out.

Figure 65-6 User Name and Status Icon

For more information, see Chapter 62, "Working with the Instant Messaging and Presence Service (IMP)."

Users with page-edit privileges can access the task flow's region parameter through the Component Properties dialog in Oracle Composer. For more information about setting the Mail service task flow properties, see Section 65.5, "Setting Mail Service Task Flow Properties."

65.3 Selecting Your Preferred Mail Connection

When your WebCenter Spaces application provides access to multiple mail connections, it also provides a way for you to choose which connection to use. This section describes how.

To choose your preferred mail connection:

1. Click the Preferences link at the top of the application.

2. Click Mail to open the Mail Preferences panel (Figure 65-7).

Figure 65-7 The Mail Preferences Panel

3. From the Connection dropdown list, choose the mail connection you want to use for accessing your mail through WebCenter Spaces.

The options available on this list depend on the connections your system administrator makes available to your WebCenter Spaces application. The No Preference option uses your system-level active mail connection.

4. Under Default mail client for 'Send Mail' action, choose an option to identify the mail application to open when the SendMail command is invoked.

Choose from:

- Local mail client—Choose to specify that the local mail client you normally use, such as Microsoft Outlook or Mozilla Thunderbird, should open a compose message window when the SendMail command is invoked.

- WebCenter Mail Service—Choose to specify to open a WebCenter Mail service compose message window when the SendMail command is invoked.

5. Click OK to save your change and exit the Preferences dialog.

6. Log out of WebCenter Spaces.

7. Log in to WebCenter Spaces.

8. If you previously saved your credentials for this mail connection to the WebCenter Spaces credential store, you are logged in to the new mail connection automatically.

If you have not previously saved your credentials, log in to this mail connection using Preferences (see Section 35.7, "Providing Login Information for External Applications") or using the login link in a Mail task flow (see Section 65.4.2, "Logging in to Mail").

65.4 Working with the Mail Service Task Flow

The Mail task flow exposes your company's mail server features within the context of your application. Use the Mail task flow to view, respond to, and manage your personal mail.

This section provides information on how to use the Mail task flow. It contains the following subsections:

- Section 65.4.1, "Adding the Mail Service Task Flow to a Page."

- Section 65.4.2, "Logging in to Mail"

- Section 65.4.3, "Personalizing Your View of the Mail Task Flow"

- Section 65.4.4, "Opening Mail Messages"

- Section 65.4.5, "Downloading Mail Attachments"

- Section 65.4.6, "Composing and Sending Mail Messages"

- Section 65.4.7, "Sending Mail with Attachments"

- Section 65.4.8, "Removing Attachments from the Add Attachment Window"

- Section 65.4.9, "Replying to and Forwarding Mail"

- Section 65.4.10, "Refreshing Mail"

- Section 65.4.11, "Deleting Mail"

65.4.1 Adding the Mail Service Task Flow to a Page

For the steps to add a Mail service task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

65.4.2 Logging in to Mail

Before you can access your mail in a WebCenter application, you must provide your mail login credentials. The first time you access a Mail task flow, it displays the message depicted in Figure 65-8.

Figure 65-8 Login Message in a Mail Task Flow

To log in to a Mail task flow:

1. Go to a Mail task flow, and click the Login to Mail link (Figure 65-8) to open an External Application Login dialog (Figure 65-9).

Figure 65-9 External Application Login Dialog

Note:

The External Application Login dialog may include additional fields and information, depending on the requirements of the service that provides it. For more information about external applications and storing your login credentials in a WebCenter Spaces application, see Section 35.7, "Providing Login Information for External Applications."

2. Enter your user name and password and any other login credentials that your mail application requires.

Required fields are marked with an asterisk (*).

3. Optionally, choose Remember my login information to store your credentials.

The next time you log in to the application, your mail credentials are retrieved from storage and you are logged in.

4. Click OK, and the Mail task flow displays mails from your inbox.

65.4.3 Personalizing Your View of the Mail Task Flow

You can personalize your view of the Mail task flow by filtering the number of displayed messages. For example, you can choose to display only the messages that were delivered Today, Since Yesterday, This Week, or This Month. Additionally, you can choose to display All messages in your inbox.

Note:

By default, the Mail service displays the 50 most recent mail messages from your mail server inbox folder. However, if required, your Fusion Middleware administrator can configure this to a higher value, if your server supports the increase in memory cache that fetching additional mail requires. Care should be taken to have a value suitable to your environment. This value impacts all users. That is, if the Mail service is configured to read 200 recent mail messages, then the Mail service reads 200 recent mail messages for all users.

Personalizations affect only your view of the Mail task flow. No other user's view is changed because of your selection.

To personalize your view of the Mail task flow:

1. Go to the Mail task flow.

2. Open the menu at the top of the task flow (Figure 65-10).

Figure 65-10 The Mail Personalization Menu

3. Choose a display option. Choose from:

- All—to show all messages

- Today—to show all messages received today

- Since Yesterday—to show all messages received yesterday and today

- This Week—to show all messages received in this calendar week

- This Month—to show all messages received in this calendar month

The Mail task flow redraws, displaying only those messages that match your selection.

65.4.4 Opening Mail Messages

The messages that display in your Mail task flow are the same messages that display in your regular mail application inbox. You open them in much the same way, too.

To open a mail message:

1. Go to a Mail task flow, and click the link to the message you want to open (Figure 65-11).

2. Figure 65-11 A Mail Message Link

The message opens (Figure 65-12).

Figure 65-12 A Mail Message

3. After reading the message click Cancel to close the message (Figure 65-13).

Figure 65-13 Cancel a Mail Message

Note:

HTML reports, tables, images that are inlined (copy paste), and fonts viewed in a mail message may not render correctly. The Mail service requires HTML data to be well-formed to display as expected in a mail message.

The mail should show everything that your browser supports. However, some tags, like <script>, are encoded and disabled from execution.

65.4.5 Downloading Mail Attachments

Attachments display in mail messages as links (Figure 65-14).

Figure 65-14 Mail Attachments

Accessing files associated with attachments is the same as accessing a file from any browser window: simply click the link. Clicking an attachment link opens a download dialog that gives you the option of viewing the file in its native application or saving the file to a local drive. This is browser behavior, so the way you follow through depends on the browser you use.

65.4.6 Composing and Sending Mail Messages

Composing and sending messages through the Mail service in a WebCenter portal application is very much like doing so in your regular mail.

To compose and send a mail message:

1. In a Mail task flow, click the Compose icon (Figure 65-15).

2. Figure 65-15 The Compose Icon on a Mail Task Flow

3. In the Compose window (Figure 65-16), enter recipients in the To field. Separate multiple addresses with a comma (,).

Figure 65-16 Compose Window

Click the Options dropdown list to include Cc, Bcc, or Reply-to fields in the message. The Reply-to field is prepopulated with the user composing the mail, but it can be changed to any address. From this dropdown list, you also can select to compose the message in plain text, instead of the Rich Text Editor.

The selected options persist until they are changed.

Figure 65-3 shows the compose window with the Cc, Bcc, and Reply-to fields added as well as the Rich Text Editor removed.

Figure 65-17 Mail Compose Window with Different Options Selected

The Compose window is directly connected to your mail server, so you can use the Find User icons (Figure 65-18) to find mail addresses and contacts.

Figure 65-18 Find User Icons in a Compose Window

Click the Find User icon and, in the resulting dialog, enter—minimally—the first two characters of the user name for which you are searching. Click Search, and all names matching your search criteria appear in the results area.

Figure 65-19 Select User Dialog

4. In the Subject field, enter a subject for your message.

Enter up to 255 characters.

5. Compose your message.

6. Click Send.

65.4.7 Sending Mail with Attachments

Just like your regular mail, you can use the Mail task flow to send messages with attachments.

To send a mail with attachments:

1. Create a mail message as described in Section 65.4.6.

2. In the Compose window, click the Attach Files link (Figure 65-20).

Figure 65-20 The Attach Link

The Add Attachment window opens (Figure 65-21).

Figure 65-21 The Add Attachment Window

3. Click Browse to locate and choose an attachment.

4. Click Attach to attach the selected file.

The file size must be greater than zero bytes but less than 2 MB. Zero-byte files do not get attached.

Note:

It is recommended that you avoid attaching large files, as this causes the server to slow down or not respond. If you attach large files (greater than 2MB), then because of how the HTTP protocol handles attachments, the system reports an error only after reading all of the 2MB characters.

5. Repeat steps 3 and 4 to add additional attachments.

Attachments are listed under the Attachments heading in the Add Attachment window (Figure 65-22).

Figure 65-22 Attachments in the Add Attachment Window

A Remove Attachment icon appears next to each attachment (Figure 65-22). Click this to remove a selected attachment from the window.

6. Click the Back to Compose link to go back to the Compose window.

7. Click Send.

65.4.8 Removing Attachments from the Add Attachment Window

You can remove attachments from the Add Attachment window and from the Compose window:

- To remove mail attachments from the Add Attachment window, click the Remove Attachment icon next to the attachment you want to remove (Figure 65-23).

Figure 65-23 Attachments in the Add Attachment Window

For information about accessing the Add Attachment window, see Section 65.4.7, "Sending Mail with Attachments."

- To remove mail attachments from the Compose window, click the Remove Attachment icon next to the attachment you want to remove (Figure 65-24).

Figure 65-24 Remove Attachment Icon in the Compose Window

For information about accessing the Compose window, see Section 65.4.6, "Composing and Sending Mail Messages."

65.4.9 Replying to and Forwarding Mail

When you reply to or forward a mail, the mail content is sent as an attached HTML file instead of being displayed in the mail message window. Replying to and forwarding mail is as straightforward as in your regular mail application.

To reply to or forward a mail message:

1. Go to a Mail task flow.

2. Click the link to the message you want to reply to or forward (Figure 65-25).

Figure 65-25 A Mail Message Link

The message opens (Figure 65-26).

Figure 65-26 A Mail Message

3. Choose one from the following options:

- Click Reply to reply to the sender. Figure 65-27 shows the Reply Mail window.

Figure 65-27 A Reply Mail Message Window

- Click Reply All to reply to all recipients (including users who received a blind copy).

- Click Forward to send the message on to a third party. Figure 65-28 shows the resulting window.

Figure 65-28 A Forwarded Mail Message Window

4. In the resulting Compose window, enter recipients in the To field as you require. Separate multiple entries with a comma (,)

Click the Options dropdown list to add Cc, Bcc, or Reply-to fields or to remove the Rich Text Editor and use plain text..

The Compose window is directly connected to your mail server, so you can use the Find User icon to find mail addresses and contacts. Click the Find User icon and, in the resulting dialog, enter—minimally—the first two characters of the user name for which you are searching. Click Search, and all names matching your search criteria appear in the results area.

5. Optionally, revise the subject in the Subject field.

6. In the Mail's message area, enter your reply or any forwarding message before or after the original message.

7. Optionally, add attachments as described in Section 65.4.7, "Sending Mail with Attachments."

8. Click Send.

The message is sent, and the original message reappears.

9. Click Cancel at the bottom of the original message to close the window (Figure 65-29).

Figure 65-29 Cancel Message

65.4.10 Refreshing Mail

You must perform a refresh to check for new mail messages. Because the refresh operation triggers an event to the server to check for new mails, it may take a while to get new messages. Therefore, you may have to refresh a couple of times to display new mails in the Mail task flow.

To refresh Mail:

1. Go to the Mail task flow.

2. Click the Refresh icon (Figure 65-30) on the task flow.

Figure 65-30 The Refresh Icon on the Mail Task Flow

The Mail task flow displays the latest mails.

65.4.11 Deleting Mail

You can easily remove a message from your inbox.

To delete a Mail message:

1. Open the message you want to delete as described in Section 65.4.4, "Opening Mail Messages."

2. Click Delete at the top of the message (Figure 65-31).

Figure 65-31 Delete Message

65.5 Setting Mail Service Task Flow Properties

The Mail service task flow has associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 65-32).

Figure 65-32 Mail Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Mail service task flow and describe the properties on the Parameters tab.

- Section 65.5.1, "What You Should Know About the Mail Service Task Flow Properties"

- Section 65.5.2, "Mail Service Task Flow Parameters"

65.5.1 What You Should Know About the Mail Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 65.5.2, "Mail Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

65.5.2 Mail Service Task Flow Parameters

The Mail task flow has one associated region parameter: Tabular. Using the EL value type, enter a value of true to display the information associated with a mail message, such as its subject, sender, and, date sent, in a tabular format. Figure 65-33 illustrates a tabular format Mail task flow.

Figure 65-33 A Mail Task Flow where the Region Parameter Tabular Is Set to True

66 Working with the Notes Service

This chapter describes the features and functions of the Notes service, and provides specific how-to information about creating personal notes.

Note:

The Notes service is available only in the WebCenter Spaces application, not in WebCenter Portal applications.

This chapter includes the following sections:

- Section 66.1, "What You Should Know About the Notes Service"

- Section 66.2, "Working with the Notes Service Task Flow"

- Section 66.3, "Setting Notes Service Task Flow Properties"

Audience

This chapter is intended for WebCenter Spaces users interested in creating personal notes in the WebCenter Spaces application.

The WebCenter Spaces application administrator has the authority to expose or hide a particular service's task flows. Tasks discussed in this chapter are not available to you if the Notes service is hidden.

66.1 What You Should Know About the Notes Service

The Notes service provides useful features for writing yourself reminders in the form of personal notes. You can add notes by using the Notes task flow, which displays the personal notes of the currently logged in user (Figure 66-1). Only the notes that you create are displayed in the Notes task flow. No other user sees your notes, and you do not see any other user's notes.

Figure 66-1 A Notes Task Flow

You can filter your Notes list by note titles. Filtering enables you to narrow the focus of your Notes to just the notes that match your filtering criteria. Consider devising a naming scheme for your notes to make the most of filtering.

The Notes service is integrated with the Links service. In a Space or Home Space, by using the Link service, you can link a note to an object like a document, list, or announcement. While you can link to a new note (Figure 66-2), you cannot link to existing notes. All users who have access to the object can view the linked note too. For more information, see Section 63.2.2.5, "Adding and Linking to a Note."

Figure 66-2 Linking a Discussion Topic to a New Note

66.2 Working with the Notes Service Task Flow

Every work day brings new things that you, and only you, must remember: I before E except after C. Use only bonded 25# paper for your report. John hides his candy in the coffee room stir-stick drawer. WebCenter Spaces offers a way for you to keep track of these useful, sometimes vital, bits of information through Notes.

This section describes how to use the Notes task flow. It includes the following subsections:

- Section 66.2.1, "Adding the Notes Service Task Flow to a Resource Catalog"

- Section 66.2.2, "Adding the Notes Service Task Flow to a Page"

- Section 66.2.3, "Creating a Note"

- Section 66.2.4, "Filtering and Clearing Filters on Notes"

- Section 66.2.5, "Editing Note Details"

- Section 66.2.6, "Refreshing Your View of Notes"

- Section 66.2.7, "Deleting Notes"

66.2.1 Adding the Notes Service Task Flow to a Resource Catalog

WebCenter Spaces provides rich Resource Catalogs that expose components and connections that WebCenter Spaces users can add to their pages. You can use a Resource Catalog to populate resources such as page templates, navigation models, pages, and task flows.

As a Spaces administrator or a Space moderator, you can make the Notes task flow available in a custom Resource Catalog so that users can add the task flow to their pages and use it for adding personal notes.

To make the Notes task flow available in a custom Resource Catalog:

1. Create a Resource Catalog or make a copy of an existing one. Creating a Resource Catalog follows the same procedure as any other resource. For information about creating a blank Resource Catalog, see Section 10.2, "Creating Resources." For information about copying an existing Resource Catalog, see Section 10.4.1, "Copying a Resource."

2. On the Resources page, select the Resource Catalog to which you want to add the Notes task flow.

3. From the Edit menu, choose Edit.

4. If you have created folders (see Section 16.3.1.1, "Creating a Folder") and want to add resources inside a particular folder, select the folder in the Edit dialog.

5. In the Edit dialog, select Add, and then Add From Library, as shown in Figure 66-3.

Figure 66-3 Adding a Resource to a Resource Catalog

6. In the Add Resource Catalog Item dialog, select Task Flows from the list displayed on the left.

7. From the list on the right, select Notes (Figure 66-4).

Figure 66-4 Adding the Notes Task Flow to a Resource Catalog

8. Click Add.

The Notes task flow displays in the Edit dialog of your Resource Catalog (Figure 66-5).

Figure 66-5 Notes Task Flow in a Resource Catalog

9. Click OK to close the Edit dialog.

10. Configure the application or Space to use the new catalog as the default one. For information, see Section 16.10, "Configuring Resource Catalogs in Your Application."

66.2.2 Adding the Notes Service Task Flow to a Page

To add the Notes task flow to a page, you need to click Add next to the Notes task flow in the Resource Catalog, as shown in Figure 66-5.

The procedure for adding the Notes service task flow to a page is same as adding any other component from the Resource Catalog. For the generic procedure, see Section 17.5.1, "Adding a Component to a Page."

Figure 66-6 Selecting the Notes Task Flow from the Resource Catalog

66.2.3 Creating a Note

Create notes to track personally relevant bits of information, such as your favorite route to the fifth floor, the place to find the most plentiful desk supplies, and so on. This section describes how to create a note.

To create a note:

1. Navigate to the page that contains the Notes task flow.

2. In the Notes task flow, click the Create a new note icon (Figure 66-7).

Figure 66-7 The Create a New Note Icon in a Notes Task Flow

A panel opens with fields for entering your note (Figure 66-8).

Figure 66-8 Panel for Creating a New Note

3. In the Title field, enter a note title.

The note title is rendered as a link in the list of notes. You can filter your notes by their titles. Consider devising a naming scheme for your notes to make the most of filtering. For more information about filtering, see Section 66.2.4, "Filtering and Clearing Filters on Notes."

4. In the Detail field, enter note content.

5. Click Save to save the note.

When you click Save, the detail panel remains open, allowing you to create additional notes. After you finish, click Close to exit the panel.

66.2.4 Filtering and Clearing Filters on Notes

Your note list may become lengthy, making it a challenge to find a particular note. In a given session with the Notes task flow, you can shorten the list by filtering out all but the note titles that contain your filtering criteria. Enter a filtering value to temporarily limit display to notes that match the value. You can filter the Notes list against whole or partial words. Filtering looks for matches anywhere in the title.

To clear the filter, click the filtering icon again.

To filter notes:

1. Go to a Notes task flow, and click the Filter notes icon (Figure 66-9).

Figure 66-9 The Filter Notes Icon

A filtering toolbar opens.

2. Enter your filtering term in the field provided in the filtering toolbar, then click the Filter icon next to the field, to apply the filter (Figure 66-10).

Figure 66-10 Filtering Toolbar

Note:

Filtering terms are not case sensitive. Use whole or partial words. Filtering looks for matches anywhere in the title.

3. Click the Cancel Filter icon to remove the filter and display all notes (Figure 66-11).

Figure 66-11 The Cancel Filter Icon

66.2.5 Editing Note Details

Things change. This truism may apply to the details you have entered about a particular note. If so, it's an easy matter to revise note details. This section tells you how.

To edit note details:

1. Go to a Notes task flow, then click the title of the note that you want to edit (Figure 66-12).

Figure 66-12 A Note Title in the Notes Task Flow

Note details display at the top of the task flow (Figure 66-13).

Figure 66-13 Note Details

2. Edit the details in the Title and Detail fields as you prefer.

3. Click the Update button to save your changes and exit the edit panel.

66.2.6 Refreshing Your View of Notes

The Notes task flow includes a Refresh notes icon that you can use to refresh your display of notes (Figure 66-14).

Figure 66-14 The Refresh Notes Icon on a Notes Task Flow

This comes in handy for updating your view of the task flow with any recent changes. Click the Refresh notes icon, and the Notes task flow redraws, reflecting recent changes.

66.2.7 Deleting Notes

When a note has outlived its usefulness, you can remove it from the Notes task flow. Each note comes equipped with its own Delete note icon. This section describes how to delete a note.

To delete a note:

1. Go to a Notes task flow, and click the Delete note icon next to the note you want to delete (Figure 66-15).

Figure 66-15 Delete Note Icon

A Delete Note dialog opens (Figure 66-16).

Figure 66-16 Delete Note Dialog

2. Click the Delete button to delete the selected note.

66.3 Setting Notes Service Task Flow Properties

The Notes service task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 66-17). Many properties are common to all task flows, and the method for accessing task flow properties is the same from task flow to task flow. Common task flow properties and how to access them are discussed in Section 17.5.2, "Setting Properties on Page Components."

Figure 66-17 Notes Service Task Flow Component Properties

To access the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The Notes service task flow does not have any unique properties, and therefore no Parameters tab in the Component Properties dialog.

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

67 Working with the Polls Service

This chapter discusses the Polls service and provides information about its task flows. The Polls service lets you create, edit, and take online polls. With polls, you can survey your audience (such as their opinions and their experience level), check whether they can recall important information, and gather feedback on the efficacy of presentations.

This chapter includes the following sections:

- Section 67.1, "What You Should Know About the Polls Service"

- Section 67.2, "Working with Polls Service Task Flows"

- Section 67.3, "Setting Polls Service Task Flow Properties"

Audience

This chapter is intended for users who want to create and manage polls, as well as WebCenter Spaces administrators with the Application-Manage Configuration permission and individual Space moderators who want to configure polls within their Spaces. For more information, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."

67.1 What You Should Know About the Polls Service

With the Polls service, in addition to taking available polls, you can do the following:

- Create a poll. You can create quick polls with only a name, description, and question, or you can create detailed polls.

- Create a template for polls. Templates contain the same questions, sections, and welcome and closing content.

- Edit an existing poll; for example, add questions to the poll, change existing questions, or publish (open) and close the poll.

- Take a specific or the most recently-published poll.

- View poll results

- See the status of all polls and available actions for each poll, such as edit, delete, publish, analyze, and clear results.

The Polls service is integrated with the Instant Messaging and Presence service in the Polls Manager.

Figure 67-1 shows a sample poll.

Figure 67-1 Quick Poll

More detailed poll functionality is available through the Polls Manager (Figure 67-2).

Figure 67-2 Polls Manager

Polls created through the Polls Manager must be published and open to be taken. Users cannot take unpublished or closed polls.

67.2 Working with Polls Service Task Flows

The Polls task flows let you create, take, and manage polls. This section includes the following subsections:

- Section 67.2.1, "Adding a Polls Service Task Flow to a Page"

- Section 67.2.2, "Working with the Quick Poll Task Flow"

- Section 67.2.3, "Working with the Polls Manager Task Flow"

- Section 67.2.4, "Working with the Take Polls Task Flow"

- Section 67.2.5, "Working with the View Poll Results Task Flow"

67.2.1 Adding a Polls Service Task Flow to a Page

To add a Polls service task flow to a page in a WebCenter Spaces application:

1. Open the page in edit mode.

See Also:

For more information, see Section 17.3.1, "Entering and Exiting Page Edit Mode."

2. Click Add Content in the target region to open the Resource Catalog.

3. Navigate to the section of the Resource Catalog that provides access to polls (Figure 67-3).

Figure 67-3 Opening the Polls Section in the Resource Catalog

4. Click Add next to the task flow that you want to add to your page (Figure 67-4).

Figure 67-4 Polls Selections in a Space

See Also:

Chapter 16, "Working with Resource Catalogs"

67.2.2 Working with the Quick Poll Task Flow

Quick Polls allow one-question polls to be published immediately. Each quick poll needs its own Quick Poll task flow on the page. Edit the page with the Quick Poll task flow to create the poll. In Edit Page mode, you see the Design Poll button.

Quick polls can be managed with the Polls Manager.

On the General tab, enter a name and description for your poll, and the number of days for the poll to stay open. The name you enter appears in the Component Properties as a parameter in the Take Polls and View Poll Results task flows.

Figure 67-5 Quick Poll - General

On the Question tab, design your one-question poll, and click OK.

Note:

The same types of questions are available in the Quick Poll task flow and in the Polls Manager task flow.

Figure 67-6 Quick Poll - Question

67.2.3 Working with the Polls Manager Task Flow

The Polls Manager task flow displays a view that lets you create polls, view the status all current polls, and perform operations on them, including edit, save (as poll or as a poll template), publish, close, analyze, and delete. See the latest poll data by clicking the Refresh icon on the Polls Manager view (Figure 67-7).

Figure 67-7 Polls Manager

To add a new poll, click Click Create Poll.

On the Design page, click Add to populate the poll with an existing template or with questions and surrounding text (Figure 67-8).

Figure 67-8 Polls Manager - Add

Click Add Section to enter any explanatory text in a rich text editor (Figure 67-9).

Figure 67-9 Polls Manager - Design Page to Create/Edit Section

Click Add Question to add each poll question (Figure 67-10). New questions are added to top of the poll, so you may want to enter poll questions in reverse order.

Figure 67-10 Polls Manager - Design Page to Create/Edit Questions

There are four question types:

- Multiple Choice (Only One Answer)

- Multiple Choice (Multiple Answer)

- Matrix of Choices (Only One Answer Per Row)

- Matrix of Choices (Multiple Answers Per Row)

In this example, the current design looks like Figure 67-11.

Figure 67-11 Polls Manager - Design Page

On Schedule page, choose publish and close options for the poll. Polls must be published and open to be taken. Users cannot take unpublished or closed polls.

In Publish Options, choose to keep the poll in draft mode for further editing, publish it immediately, or publish it on a future date. Click the Select Date and Time icon to enter the publishing time through a calendar. Click Edit Introduction Message to customize in the rich text editor the text provided at the beginning of the poll.

In Close Options, choose to close the published poll after it reaches a certain number of responses or on a certain date. If you choose both options, then the poll closes when either condition is first met. Click the Select Date and Time icon to enter the closing time through a calendar. Click Edit Closing Message to customize in the rich text editor the text provided at the end of the poll.

Figure 67-12 Polls Manager - Schedule

On the Settings page, choose what to display after the poll is taken (Figure 67-13). For example, you can set a custom JSF task flow as Thank You page that appears after the poll is taken.

Figure 67-13 Polls Manager - Settings

On the Analyze page, view the poll data. Use the Questions box on the right to toggle between multiple questions (Figure 67-14).

Figure 67-14 Polls Manager - Analyze

67.2.4 Working with the Take Polls Task Flow

The Take Polls task flow displays the most recently-published available poll, unless it is set to display a specific poll with the Poll Id parameter. After a user submits a response for that poll, this task flow displays the next most recently-published poll.

For more information, see Section 67.3, "Setting Polls Service Task Flow Properties."

Figure 67-15 Take Polls

67.2.5 Working with the View Poll Results Task Flow

The View Poll Results task flow must be set to display a specific poll with the Poll Id parameter.

For more information, see Section 67.3, "Setting Polls Service Task Flow Properties."

67.3 Setting Polls Service Task Flow Properties

The Polls service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 67-16).

Figure 67-16 Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Polls service task flows and describe the properties on the Parameters tab.

- Section 67.3.1, "What You Should Know About the Polls Service Task Flow Properties"

- Section 67.3.2, "Polls Service Task Flow Parameters"

67.3.1 What You Should Know About the Polls Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 67.3.2, "Polls Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Section 17.5.2.6, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

67.3.2 Polls Service Task Flow Parameters

Table 67-1 describes the parameters that are unique to the Polls service task flows.

Table 67-1 Polls Service Task Flow Parameters

Parameter

Description

Scope

The Space name from which polls are to be fetched. If this is supplied, then polls of that particular Space are shown.

On the Home space, when this parameter is not supplied, it fetches polls from all Spaces.

This parameter appears in the properties for the Polls Manager task flow.

Show User Data Only

This parameter determines whether to display only those polls created by the user.

Set to Yes to display only those polls created by the user. Set to No (default) to display all polls. If the scope parameter is specified, then this parameter works the same but within only that scope.

This parameter appears in the properties for the Polls Manager task flow.

Poll Id

The name of the poll to display, available from the dropdown list.

This parameter appears in the properties for the following task flows.

- Take Polls

- View Poll Results

Show In Edit Mode

This parameter determines whether users can edit a quick poll. When a quick poll is in Edit mode, a Design Poll box for editing the poll appears. When a quick poll is not a Edit mode, the Design Poll box for editing is not visible.

This parameter appears in the properties for the Quick Poll task flow.

68 Working with the RSS Service

This chapter describes how to use the RSS service features. The RSS service provides the ability to publish content from Oracle WebCenter services as news feeds in RSS 2.0 and Atom 1.0 formats. News feeds deliver content update information to your favorite RSS or Atom reader. In addition, the RSS service enables you to view news feeds from external sources on your application pages in an RSS Viewer.

This chapter includes the following sections:

- Section 68.1, "What You Should Know About the RSS Service"

- Section 68.2, "Obtaining Service News Feeds"

- Section 68.3, "Working with the RSS Task Flow"

- Section 68.4, "Setting RSS Service Task Flow Properties"

Audience

This chapter is intended for WebCenter Spaces users interested in publishing news feeds from WebCenter services and external sources on their application pages. Much of this information also applies to any WebCenter Portal application, though it is written with WebCenter Spaces users in mind. For information about WebCenter Portal applications, see "Integrating the RSS Service" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

The WebCenter Spaces administrator has the authority to expose or hide some Space features and services. Contact your WebCenter Spaces administrator if some tasks discussed in this chapter are not available to you.

68.1 What You Should Know About the RSS Service

The RSS service exposes its features in the following ways:

- The RSS icon on a service task flow - enables you to publish content from WebCenter services as a news feed.

- A dedicated RSS Manager page (WebCenter Spaces only) - displays a list of published feeds from all accessible Spaces for viewing in either RSS 2.0 or Atom 1.0 news readers.

- The RSS task flow - adds an RSS viewer to the page for displaying feeds from external sources and WebCenter services.

Note:

The RSS service does not support non-ASCII user names and passwords if the character encoding of the browser-based basic authentication is different from the character encoding of the system on which Oracle WebCenter is deployed. On a Linux system, the character encoding is generally different, and therefore the RSS service does not support non-ASCII credentials.

If the character encoding is same, users can use corresponding non-ASCII credentials. For example, for the Oracle WebCenter instance installed on French Windows Server 2003, users can use a French user name on the French Windows to pass the basic authentication using Internet Explorer.

This section includes the following subsections:

- Section 68.1.1, "RSS Icon"

- Section 68.1.2, "RSS Manager"

- Section 68.1.3, "RSS Task Flow"

68.1.1 RSS Icon

RSS news feeds deliver content update information on the Recent Activities, Discussions, Lists, and Announcements services. Figure 68-1 shows the RSS icon available on the Announcements task flow in a WebCenter Spaces page.

Figure 68-1 RSS Icon in the Announcements Task Flow

68.1.2 RSS Manager

In a WebCenter Spaces application, you can obtain news feeds from individual task flow instances and also from the RSS Manager. Access the RSS Manager by clicking the RSS link at the bottom of the WebCenter Spaces application (Figure 68-2).

Figure 68-2 The RSS Link in WebCenter Spaces

The RSS Manager displays nodes for all the Spaces for which RSS feeds have been enabled (Figure 68-3).

Figure 68-3 Expanded Space Nodes in the RSS Manager

Expand a Space node to obtain both RSS 2.0 and Atom 1.0 news feeds from individual services.

A Space must be news feed-enabled before you can obtain feed URLs from it. For information, see Section 51.4.6, "Enabling or Disabling RSS News Feeds for a Space." Additionally, your reader of choice must support HTTP authentication.

When you access a news feed item in your reader of choice, the item links back into your WebCenter application. Because the application itself requires authentication before you can access much of its content, your reader must be equipped to pass your login credentials to securely deliver access.

The level of detail provided through a service news feed depends on the feed source. For example, when you pull a news feed for recently added or modified lists, your news reader provides the list titles and (if available) shows descriptions of the most recently added or modified lists (Figure 68-4).

Figure 68-4 A Lists News Feed

The list titles in a feed are linked. Click a list title, and it takes you back into your WebCenter application with the selected list displayed (Figure 68-5).

Figure 68-5 A List Opened from an RSS Feed and Displayed in WebCenter Spaces

In contrast, when you pull a news feed from a particular list, it shows recently added or revised row details and provides links to individual rows. When you click such a link, it also takes you back into your WebCenter application, with the list content displayed.

The news feeds you obtain from a WebCenter Spaces application are context-aware, providing content only from the Space from which they originate. For example, if you provide a list feed from the Finance Space, your news reader displays list content that is unique to the Finance Space. If you add a list feed from the Languages Space, your news reader displays list content that is unique to the Languages Space.

The RSS service delivers news feeds from the following services:

- Recent Activities

The recent activity news feed tracks updates to your WebCenter application that are normally reflected in a Recent Activity list and that have occurred within the last three days. For more information, see Section 68.2.1, "Obtaining the Recent Activities News Feed."

- Discussions

The discussion forums news feed tracks updates to all discussion forums in a particular Space. See Section 68.2.2, "Obtaining the Discussion Forums News Feed."

- Lists (WebCenter Spaces only)

There are two types of news feeds that can be delivered from the Lists service—all newly created or changed lists in a Space (from the Lists task flow) and revisions to the data of a particular list in a Space (from the List Viewer task flow on the Lists page). The news feed content depends on whether you get the news feed URL from the Lists task flow or the List Viewer task flow. For more information, see Section 68.2.3, "Obtaining List News Feeds."

- Announcements

The Announcements news feed tracks additions and revisions to announcements from a particular Space, from all Spaces, or application-wide, depending on the location of the feed source. For more information, see Section 68.2.4, "Obtaining the Announcements News Feed."

You can to obtain news feed URLs for all applicable services either from the RSS Manager or the required service's task flows.

68.1.3 RSS Task Flow

If you want to add a news feed from an external site to your WebCenter application, the RSS service provides an RSS task flow (Figure 68-6).

Figure 68-6 The RSS Task Flow

You can add the RSS task flow to a page and configure it to display content from any external RSS feed. Additionally, the RSS task flow supports login credential passing, by using an external application.

See Also:

- For information about adding the RSS task flow, see Section 68.3.1, "Adding an RSS Service Task Flow to a Page."

- For information about specifying a feed for the RSS task flow, see Section 68.3.4, "Editing the Feed Location of an RSS Task Flow."

The RSS task flow can render news feeds outside of a corporate firewall. However, to consume external news feeds outside of the firewall, your application administrator must have configured proxies for the RSS service. Contact your Spaces administrator if you cannot consume external feeds but want to do so. To contact the administrator, click the Administrator link at the bottom of the Spaces application.

Accessing External Applications

Every time you access a secure news feed item, you must log on to that secure application to view content. You can either supply login credentials each time you access an application, or let an external application store and manage your login credentials. After your credentials for a particular application are stored, you are logged in to that application automatically when you log in to your WebCenter Spaces application. You can provide this capability for all frequently used external applications.

If the secured application you want to access is not registered as an external application, perform the steps listed in Section 35.7, "Providing Login Information for External Applications."

68.2 Obtaining Service News Feeds

Each participating service provides news feeds from locations unique to that service.

This section steps you through obtaining those feeds. It includes the following subsections:

- Section 68.2.1, "Obtaining the Recent Activities News Feed"

- Section 68.2.2, "Obtaining the Discussion Forums News Feed"

- Section 68.2.3, "Obtaining List News Feeds"

- Section 68.2.4, "Obtaining the Announcements News Feed"

68.2.1 Obtaining the Recent Activities News Feed

Use news feeds from the Recent Activities service to keep track of the wide range of activity happening in one or more Spaces within the last three days. To consume a Space Recent Activities news feed, you must be a member of the selected Space and the Space must be enabled to provide news feeds.

WebCenter Spaces provides two locations for pulling a news feed from the Recent Activities service: the RSS Manager and the Recent Activity task flow.

Both the RSS Manager and the Recent Activity task flow provide the same news feed content: additions or revisions to Spaces and Space pages, documents, discussion forums, lists, and so on. For more information, see Chapter 69, "Working with the Recent Activities Service."

Assuming a default configuration, a news feed URL from a Recent Activity task flow in a Space provides information about the activity in that Space. A news feed URL from a Recent Activity task flow in your Home Space provides information about the activities in a particular Space.

Note:

A Recent Activity task flow can be configured to display the recent activity of a Space other than the one where it has been placed. In such a case, the news feed from that list provides information on the activities of the Space identified during configuration. For more information, see Section 69.3, "Setting Recent Activities Task Flow Properties."

This section describes how to obtain a news feed for the Recent Activity task flow from both the locations, the RSS Manager and the Recent Activity task flow. It contains the following subsections:

- Section 68.2.1.1, "Obtaining a Recent Activity News Feed URL from the RSS Manager"

- Section 68.2.1.2, "Obtaining a News Feed URL from the Recent Activity Task Flow"

68.2.1.1 Obtaining a Recent Activity News Feed URL from the RSS Manager

The RSS Manager provides news feeds for both RSS 2.0 and Atom 1.0 news readers. It lists all RSS-enabled Spaces of which you are a member. Each listed Space can be expanded to display the services for which it offers news feeds (Figure 68-7).

Figure 68-7 The Recent Activity Service for a Space in the RSS Manager

To obtain a Recent Activity list news feed URL from the RSS Manager:

1. Click the RSS link at the bottom of the WebCenter Spaces application (Figure 68-8).

Figure 68-8 The RSS Link

2. If required, expand the node of the Space for which you want to monitor recent activities.

You can expand a Space node by clicking the Expand icon, as shown in Figure 68-9, or by right-clicking the Space name and selecting the Expand option from the resulting context menu.

Figure 68-9 Expand Icon in RSS Manager

3. Under the relevant Space, right-click the RSS 2.0 or Atom 1.0 icon next to Recent Activity, and, from the resulting browser context menu, select the copy-link command.

The command you select depends on your current browser. For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

4. Go to your news reader and initiate an add-subscription action.

How you do this depends on the news reader you use.

5. Paste the link you copied in step 3 into the relevant field in your news reader.

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.1.2 Obtaining a News Feed URL from the Recent Activity Task Flow

The Recent Activity task flow has its own RSS icon. Using this icon, you can get the Recent Activity list news feed URL. Recent Activity RSS feeds provide the same information that you can find in a Recent Activity list. This includes such things as additions or revisions to pages, documents, discussion forums, lists, and so on. The news feed tracks activity occurring over the last three days.

For an RSS icon to be active in a Recent Activity task flow, you must be a member of the Space from which you want to obtain the news feed and news feeds must be enabled for the relevant Space.

To obtain a Recent Activity list news feed URL from the Recent Activity list:

1. Go to your Home Space or the Space that contains the Recent Activity list from which you want to obtain an RSS feed.

For information about navigating to a Space, see Section 29.3.1, "Opening Spaces." A Space may be configured to display in full-screen mode. For more information, see Section 51.4.9, "Changing the Page Template for a Space."

2. Right-click the RSS icon in the toolbar of the Recent Activity list, and from the resulting context menu, select the copy-link command.

The command you select depends on your current browser. For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Alternatively, drag the RSS icon onto your news reader of choice. This may allow you to skip the other steps in this procedure. If you use the drag-and-drop method, you may have to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

3. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

4. Paste the link you copied in step 2 into the relevant field in your RSS reader.

Note:

The news feed URL in a Recent Activity task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.1.1, "Obtaining a Recent Activity News Feed URL from the RSS Manager."

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.2 Obtaining the Discussion Forums News Feed

Use Discussion Forum news feeds to keep track of additions and revisions to a selected Space's discussions. There are three locations from which to obtain discussion forums news feed URLs: the RSS Manager, the Discussions page, and the Discussion Forums task flow. All discussion RSS and Atom URLs provide the same feed; that is, additions and revisions to all discussions in a selected Space.

This section contains the following subsections:

- Section 68.2.2.1, "Obtaining a Discussion Forum News Feed from the RSS Manager"

- Section 68.2.2.2, "Obtaining a News Feed from the Discussions Page"

- Section 68.2.2.3, "Obtaining a News Feed from a Discussion Forums Task Flow"

68.2.2.1 Obtaining a Discussion Forum News Feed from the RSS Manager

The RSS Manager provides Discussion Forum news feeds for both RSS 2.0 and Atom 1.0 news readers. Select a feed from any news-feed-enabled Space of which you are a member. Use discussion forum news feeds to track additions and revisions to a selected Space's discussion forums.

To obtain a discussion forum news feed URL from the RSS Manager:

1. Click the RSS link at the bottom of the WebCenter Spaces application (Figure 68-10).

Figure 68-10 The RSS Link

2. In RSS Manager, if required, expand the node of the Space that contains the discussions you want to use as a news feed.

You can expand a Space node by clicking the Expand icon to the left of it or by right-clicking the Space name and selecting an expand option from the resulting context menu.

3. Right-click the RSS 2.0 or Atom 1.0 icon next to Discussions (Figure 68-11), and, from the resulting context menu, select the copy-link command.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-11 RSS 2.0 and Atom 1.0 Icons Next to a Discussions Node in the RSS Manager

Alternatively, if you drag the RSS icon onto a news reader, you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

4. Go to your news reader and initiate an add-subscription action.

How you do this depends on the news reader you use.

5. Paste the link you copied in step 3 into the relevant field in your preferred news reader.

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.2.2 Obtaining a News Feed from the Discussions Page

The Discussions page provides a convenient location for grabbing a news feed URL while monitoring discussions.

To get an RSS URL for all discussions of a Space from the Discussions page:

1. Go to the Space that contains the discussion forums you want to use as an RSS feed.

For information about navigating to a Space, see Section 29.3.1, "Opening Spaces." For information about showing hidden pages, see Section 29.3.4, "Showing Hidden Pages."

2. Click Discussions on the navigation bar to open the Discussions page.

If the Discussions page is not available, open the Personalize Pages page and select Discussions. When the page appears on the navigation bar, click it to open it. For more information about locating and opening pages, see Section 29.3.2, "Opening Pages."

3. Right-click the RSS icon on the Discussions page (Figure 68-12), and from the resulting context menu, select the copy-link command.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-12 An RSS Icon on a Discussions Page

Alternatively, if you drag the RSS icon onto your news reader, you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

4. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.

You may need to enter your WebCenter Spaces credentials. To learn more, see Section 68.1, "What You Should Know About the RSS Service."

Note:

The news feed URL on the Discussions page is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, then do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.2.1, "Obtaining a Discussion Forum News Feed from the RSS Manager."

68.2.2.3 Obtaining a News Feed from a Discussion Forums Task Flow

The Discussion Forums task flow provides another location from where you can obtain a discussions news feed for a selected Space. The placement of this task flow within a Space is at the discretion of the Space's designers, so we cannot pinpoint where you may find this task flow. But, wherever you find it, an RSS icon is available to provide you with an RSS news feed URL. This section describes how to use it.

To obtain a news feed URL from a Discussion Forums task flow:

1. Go to the page in the required Space that contains a Discussion Forums task flow.

For information about navigating to a Space, see Section 29.3.1, "Opening Spaces."

2. Right-click the RSS icon on the task flow (Figure 68-13), and, from the resulting context menu, select the copy-link command.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-13 An RSS Icon in a Discussion Forums Task Flow

Alternatively, if you drag the RSS icon onto your news reader, you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

3. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

4. Paste the link you copied in step 2 into the relevant field in your preferred RSS reader.

Note:

The news feed URL in the Discussions task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.2.1, "Obtaining a Discussion Forum News Feed from the RSS Manager."

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.3 Obtaining List News Feeds

Lists provide a vital form of tracking just about everything within an organization. For example, a group might want a membership list that outlines assigned roles and contact information. A project lead might set up a list that tracks issue resolution.

It follows that it would be useful to track creation of and revisions to such lists from one convenient location: your favorite news reader.

The Lists service provides two options for keeping track of changes through a news reader:

- Keep track of all recently added or modified lists in a given Space.

- Keep track of recently added or modified data rows in a given list.

You can obtain the news feed URL for lists from three locations: the RSS Manager, the Lists page, and any Lists task flow on a given page. The RSS Manager and the Lists page provide access to both types of Lists feeds. Individual List task flows provide feeds for data changes to the rows of the displayed list.

This section describes how to obtain a news feed for recently added or modified list rows or lists from a selected Space. It includes the following subsections:

- Section 68.2.3.1, "Obtaining a List News Feed from the RSS Manager"

- Section 68.2.3.2, "Obtaining a News Feed from the Lists Page"

- Section 68.2.3.3, "Obtaining a News Feed from a Lists Task Flow"

68.2.3.1 Obtaining a List News Feed from the RSS Manager

The RSS Manager provides two types of list news feeds: a feed of recently added or revised lists in a Space and a feed of recent data changes to the rows of one particular list. Additionally, the RSS Manager provides feeds for an RSS 2.0 reader and an Atom 1.0 reader. The main requirement for any news reader you use is that it supports HTTP authentication (for more information, see Section 68.1, "What You Should Know About the RSS Service").

To obtain a list news feed from the RSS Manager:

1. Click the RSS button at the bottom of the WebCenter Spaces application (Figure 68-14).

Figure 68-14 The RSS Link

2. In the RSS Manager, expand the node for the Space that contains the lists from which to obtain an RSS feed.

3. Right-click the RSS 2.0 or Atom 1.0 icon next to List Service to get RSS feeds for all lists in the Space (Figure 68-15). Then, from the resulting context menu, select the copy-link command.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-15 The Lists Service Node on the RSS Manager Page

Alternatively, if you drag the news feed icon onto your reader you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

4. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.3.2 Obtaining a News Feed from the Lists Page

Each Space has its own Lists page from where you can access all the lists available in your Space. As you navigate through Space pages in your WebCenter Spaces application, you may come across a list you find particularly informative, for example, a list of project issues. It may be useful to you to track recent additions and revisions to such a list. Each list comes with its own RSS news feed, making it easy to subscribe to the list on-the-spot.

This section describes how to obtain news feed URLs from the Lists page. Note that the Lists page provides news feeds for RSS 2.0 readers only. If you want to obtain a feed for an Atom 1.0 news reader, use the RSS Manager.

To obtain a news feed from the Lists page:

1. Go to the Space that contains the list you want to track.

For information about navigating to a Space, see Section 29.3.1, "Opening Spaces."

2. Navigate to the Lists page and open the required list.

If the Lists page is not available, open the Personalize Pages page and select the Lists page for display. For more information, see Section 29.3, "Hiding, Opening, and Rearranging Pages."

3. Right-click the RSS icon (Figure 68-16), and from the resulting context menu, select the copy-link command.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-16 A List on the Lists Page

Alternatively, if you drag the news feed icon onto your reader you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

4. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.

Note:

The news feed URL on the Lists page is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.3.1, "Obtaining a List News Feed from the RSS Manager."

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.3.3 Obtaining a News Feed from a Lists Task Flow

Each Lists task flow provides RSS news feeds for recent additions and revisions to all of the lists it contains and also for recent data changes to the rows of an individual list.

To obtain a news feed from a Lists task flow:

1. Go to the Space that contains the list you want to track.

For information about navigating to a Space, see Section 29.3.1, "Opening Spaces." For information about showing hidden pages, see Section 29.3.4, "Showing Hidden Pages."

2. To obtain a news feed of recently added and revised lists in a Space, right-click the RSS icon in the Lists pane on the left side of the Lists task flow (Figure 68-16), and select the copy-link command from the resulting context menu.

To obtain a news feed of data changes to the rows of an individual list, display the list in the right pane by selecting the list name from the left pane (Figure 68-16). Right-click the RSS icon in the right pane, and select the copy-link command from the resulting context menu.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-17 A List Task Flow

Alternatively, if you drag the RSS icon onto your news reader you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

3. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

4. Paste the link you copied in step 2 into the relevant field in your preferred RSS reader.

Note:

The news feed URL in the List task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.3.1, "Obtaining a List News Feed from the RSS Manager."

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.4 Obtaining the Announcements News Feed

Announcements are excellent candidates for news feeds. Usually they are short, concise, and full of timely and valuable information. If you are a member of multiple Spaces, it would be convenient to be able to access all announcements from one location: your favorite news reader.

You can obtain an announcement news feed from three locations: the RSS Manager, the Announcements page, and an Announcements task flow.

This section contains the following subsections:

- Section 68.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager"

- Section 68.2.4.2, "Obtaining a News Feed from the Announcements Page"

- Section 68.2.4.3, "Obtaining a News Feed from the Announcements Task Flow"

68.2.4.1 Obtaining an Announcements News Feed from the RSS Manager

The RSS Manager provides two types of feeds for the Announcements service: RSS 2.0 and Atom 1.0. Use either of these to keep track of all new and revised announcements in a particular Space.

To obtain an Announcements news feed from the RSS Manager:

1. Click the RSS link at the bottom of the WebCenter Spaces application (Figure 68-18).

Figure 68-18 The RSS Link

2. In the RSS Manager, expand the node for the Space that contains the announcements you want to track through a news reader.

3. Right-click the RSS 2.0 or Atom 1.0 icon next to Announcements (Figure 68-15), and, from the resulting context menu, select the copy-link command.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-19 Announcements Node on the RSS Page

Alternatively, if you drag the news feed icon onto your reader, you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

4. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.

You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.4.2 Obtaining a News Feed from the Announcements Page

The Announcements service provides the Announcement Manager, which is exposed from the main Announcements page in the WebCenter Spaces application. You can use it to create and revise announcements and to obtain an announcements news feed URL.

Unlike the RSS Manager, the Announcement Manager provides a news feed only for RSS 2.0 news readers. If you prefer an Atom 1.0 feed, use the RSS Manager to obtain the feed URL. For more information, see Section 68.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager."

To obtain a news feed from the Announcements page:

1. Open the Announcements page. For more information, see Section 29.3, "Hiding, Opening, and Rearranging Pages."

The Announcements page is available in every Space provided the Space is configured to display announcements. For information about enabling services in a Space, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."

Note:

You can also access the Announcement Manager by clicking the Open Announcement Manager icon in the Announcements task flow. This icon is not displayed in the Announcements task flow if you do not have the required privileges.

2. Right-click the RSS icon on the right on the Announcements page (Figure 68-20), and select the copy-link command from the resulting context menu.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-20 The RSS Icon on the Announcements Page

Alternatively, if you drag the news feed icon onto your reader you can skip most of the other steps. You may need to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

3. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

4. Paste the link you copied in step 2 into the relevant field in your preferred RSS reader.

Note:

The news feed URL on the Announcements page is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager."

You may require to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.2.4.3 Obtaining a News Feed from the Announcements Task Flow

The Announcements task flow also provides access to a news feed URL. Like the Announcements page, the task flow provides feeds only for RSS 2.0 news readers. If you prefer an Atom 1.0 feed, use the RSS Manager to obtain the feed URL. For more information, see Section 68.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager."

To obtain a news feed from the Announcements task flow:

1. Go to the page that contains the Announcements task flow you want to view.

2. Right-click the RSS icon on the Announcements task flow (Figure 68-21), and select the copy-link command from the resulting context menu.

For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

Figure 68-21 RSS Icon in the Announcements Task Flow

Alternatively, if you drag the news feed icon onto your reader you can skip most of the other steps. You may require to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

3. Go to your RSS reader and initiate an add-subscription action.

How you do this depends on the RSS reader you use.

4. Paste the link you copied in step 2 into the relevant field in your preferred RSS reader.

Note:

The news feed URL in the Announcements task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

- Append &format=ATOM1.0 to the RSS news feed URL you pasted.

- Get the Atom 1.0 URL from the RSS Manager and use that URL here. For more information, see Section 68.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager."

You may require to enter your WebCenter Spaces credentials. For more information, see Section 68.1, "What You Should Know About the RSS Service."

68.3 Working with the RSS Task Flow

The RSS task flow enables you to include an RSS viewer, which you can use to view content from external news feeds within your application page.

This section contains the following subsections:

- Section 68.3.1, "Adding an RSS Service Task Flow to a Page"

- Section 68.3.2, "Refreshing an RSS Task Flow"

- Section 68.3.3, "Deleting an RSS Task Flow From the Page"

- Section 68.3.4, "Editing the Feed Location of an RSS Task Flow"

68.3.1 Adding an RSS Service Task Flow to a Page

You can incorporate news feeds from external sources into your application pages by using the RSS task flow. You can add the RSS task flow from the Resource Catalog in Oracle Composer.

Each instance of the RSS viewer displays news feeds from one source. If you plan to display multiple external news feeds on a particular page, you can place multiple RSS task flows on that page.

To display content from an external RSS feed, proxies must be configured in your application. Contact your Spaces administrator if you have problems accessing external RSS feeds in your task flow.

WebCenter Spaces provide the ability to store and manage your login credentials by using external applications. After your credentials for a particular application are stored, you are logged in to that application automatically when you log on to your WebCenter application. So, if an external RSS news feed or WebCenter services feed requires your login credentials, when you get to the step where you specify the feed URL, you may have to also specify the name of the external application that is configured to store your login credentials for reading a secure RSS feed.

To add the RSS service task flow, you need to select the RSS service task flow from the Alerts and Updates folder in the Resource Catalog (Figure 68-22). The procedure to add the RSS task flow to a page is same as adding any other task flow. For information about the generic procedure, see Section 51.16.1, "Adding a Space Task Flow to a Page."

After adding the RSS task flow, you need to edit the task flow to specify the RSS feed location. For information, see Section 68.3.4, "Editing the Feed Location of an RSS Task Flow."

Figure 68-22 RSS Service Task Flow in the Resource Catalog

68.3.2 Refreshing an RSS Task Flow

The RSS task flow, along with other page components, gets refreshed with every server request. However, as the content from news feeds may be dynamic, you have the option of refreshing the RSS task flow yourself by using the Refresh icon (Figure 68-23), when required.

Figure 68-23 The Refresh Icon on an RSS Task Flow

The task flow updates and displays latest data from the external source.

68.3.3 Deleting an RSS Task Flow From the Page

If you have the required privileges, you have the option to delete the RSS task flow from a page by using the Remove icon on the task flow (Figure 68-24) in Edit mode of the page.

Figure 68-24 Remove Icon on an RSS Task Flow

When you click the Remove icon, the Delete Component dialog displays. Click Delete in this dialog to delete the task flow from the page.

68.3.4 Editing the Feed Location of an RSS Task Flow

You can change the feed URL or the external application ID specified for an RSS task flow at any point of time.

To change the feed location of an RSS task flow:

1. Go to the web site that provides the RSS feed you want to view through the RSS viewer, and copy its RSS URL.

2. Log on to your WebCenter Spaces application, and go the page that contains the RSS task flow you want to modify.

3. Switch to the page's Edit mode.

4. Click the Edit icon on the header of the RSS task flow.

5. In the Component Properties dialog, click the Parameters tab, if not open already. (Figure 68-25).

Figure 68-25 Specifying the Feed Location in the RSS Task Flow

6. In the RSS Feed URL field, paste the URL that you copied in step 1.

For information about the RSS task flow parameters, see Section 68.4, "Setting RSS Service Task Flow Properties."

7. If the feed you want to publish requires authentication, in the External Application ID field, specify the name of the external application configured to store your login credentials for accessing that feed.

For information about external applications, see "Accessing External Applications".

8. Click Apply to save your changes and continue editing, or click OK to save your changes and close the dialog.

Content from the external feed you specified is displayed within the RSS task flow.

9. Click Save at the top-right corner of Oracle Composer to save your changes and remain in Oracle Composer.

10. Optionally, click Close to exit Oracle Composer.

68.4 Setting RSS Service Task Flow Properties

The RSS service task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 68-26).

Figure 68-26 RSS Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the RSS service task flow and describe the properties on the Parameters tab:

- Section 68.4.1, "What You Should Know About the RSS Service Task Flow Properties"

- Section 68.4.2, "RSS Service Task Flow Parameters"

68.4.1 What You Should Know About the RSS Service Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 68.4.2, "RSS Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

68.4.2 RSS Service Task Flow Parameters

Table 68-1 describes the parameters that are unique to the RSS task flow.

Table 68-1 RSS Service Task Flow Parameters

Parameter

Description

External Application ID

The name of the external application that is configured to store a user's login credentials for reading a secure RSS feed.

If you are not sure whether there is an external application configured to store your credentials, contact your Spaces administrator. To contact the administrator, click the Administrator link at the bottom of the WebCenter Spaces application.

RSS Feed URL

The URL to access the RSS feed. For example, to use the Oracle Press Releases RSS feed, enter:

http://www.oracle.com/rss/rss_ocom_pr.xml

69 Working with the Recent Activities Service

The Recent Activities service provides a means of tracking recent activities within a WebCenter application. For example, the Recent Activities task flow tracks the changes you and other users make to application pages, documents, discussion forums, lists, and the like (Figure 69-1).

Figure 69-1 The Recent Activities Task Flow

This chapter provides information about the Recent Activities service. It contains the following sections:

- Section 69.1, "What You Should Know About the Recent Activities Service"

- Section 69.2, "Working with the Recent Activities Task Flow"

- Section 69.3, "Setting Recent Activities Task Flow Properties"

Note:

You can track recent activities through your favorite RSS reader. For more information, see Chapter 68, "Working with the RSS Service."

Audience

This chapter is intended for users interested in understanding and using the features of the Recent Activities service.

The WebCenter Spaces application administrator has the authority to expose or hide task flows from a particular service. Tasks discussed in this chapter are not available to you if the relevant service is hidden.

Note:

For information about WebCenter Spaces seeded user roles, see Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

69.1 What You Should Know About the Recent Activities Service

The Recent Activities service provides the Recent Activities task flow, which links to the additions and revisions to some services available to your application (Figure 69-2).

Figure 69-2 The Recent Activities Task Flow

Tracked changes include additions and revisions to pages, documents, discussion forums, lists (WebCenter Spaces only), and events.

By default, the Recent Activity list displays 25 recent activities for a given service. If more than 25 activities have occurred, the Recent Activity list displays the 25 most recent. Your application administrator can change the default value, so your limit may be more or less than 25.

The level of information provided in the Recent Activity list depends on the context in which the list is placed. For example, in a WebCenter portal application, changes are tracked on all applicable services across the entire application.

In a WebCenter Spaces Space page, the Recent Activity list summarizes changes occurring in that Space. In a WebCenter Spaces personal space, the Recent Activities task flow must have a Space specified (see Section 69.3, "Setting Recent Activities Task Flow Properties"). The Recent Activity list summarizes changes occurring in the specified Space.

You can use the Recent Activity list as an access point to new and revised content. The Recent Activity list displays new and revised content as links, which you can click to go directly to the content.

69.2 Working with the Recent Activities Task Flow

With the Recent Activities task flow, there is very little to do to make the most of its features. It automatically detects recent activities on other WebCenter services and reports on its findings.

There are, nonetheless, a few recent-activity-centered actions you can take on the task flow. For example, you can personalize your view of recent activities, access a changed item, and refresh your view to update the task flow with the latest changes. This section tells you how. It contains the following subsections:

- Section 69.2.1, "Adding the Recent Activities Task Flow to a Custom Resource Catalog"

- Section 69.2.2, "Adding the Recent Activities Task Flow to a Page"

- Section 69.2.3, "Personalizing the Recent Activities Task Flow"

- Section 69.2.4, "Accessing Recently Acted-On Items"

- Section 69.2.5, "Refreshing the Recent Activities Task Flow"

69.2.1 Adding the Recent Activities Task Flow to a Custom Resource Catalog

WebCenter Spaces provides rich Resource Catalogs that expose components and connections that WebCenter Spaces users can add to their pages. You can use a Resource Catalog to populate resources such as page templates, navigation models, pages, and task flows.

As a Spaces administrator or a Space moderator, you can make the Recent Activities task flow available in a custom Resource Catalog so that users can add the task flow to their pages and use it for keeping track of recent activities.

To make the Recent Activities task flow available in a custom Resource Catalog:

1. Create a Resource Catalog or make a copy of an existing one. Creating a Resource Catalog follows the same procedure as any other resource. For information about creating a blank Resource Catalog, see Section 10.2, "Creating Resources." For information about copying an existing Resource Catalog, see Section 10.4.1, "Copying a Resource."

2. To add the Recent Activities task flow to the Resource Catalog, on the Resources page, select your newly created Resource Catalog.

3. From the Edit menu, choose Edit.

4. If you have created folders (see Section 16.3.1.1, "Creating a Folder") and want to add resources inside a particular folder, select the folder in the Edit dialog.

5. In the Edit dialog, select Add, and then Add From Library.

6. In the Add Resource Catalog Item dialog, click Task Flows on the left.

7. From the list on the right, select Recent Activities (Figure 69-3).

Figure 69-3 Adding the Recent Activities Task Flow to a Resource Catalog

8. Click Add.

The Recent Activity task flow displays in your Resource Catalog.

Figure 69-4 Recent Activities Task Flow in a Resource Catalog

9. Click OK to close the Edit dialog of your Resource Catalog.

10. Configure the application or Space to use the new catalog as the default one. For information, see Section 16.10, "Configuring Resource Catalogs in Your Application."

69.2.2 Adding the Recent Activities Task Flow to a Page

To add the Recent Activities task flow to a page, you need to add Recent Activities using the Resource Catalog (Figure 69-5).

Figure 69-5 Selecting the Recent Activities Task Flow from the Resource Catalog

The procedure for adding the Recent Activities task flow to a page is same as adding any component from the Resource Catalog. For the generic procedure, see Section 17.5.1, "Adding a Component to a Page."

69.2.3 Personalizing the Recent Activities Task Flow

The Recent Activities task flow provides a way to specify the range of time within which to view changes and additions to other services. These time-range options display on the Show menu in the Recent Activities task flow toolbar (Figure 69-6).

Figure 69-6 Time-Range Options on the Recent Activity List

Select an option from the Show menu to view recent activities occurring within the selected time range. The time range you select is applicable only to that task flow instance. If you have more than one Recent Activities task flow instance on the page, you can display activities from a different time range in each task flow instance.

Tip:

Ensure that your application Preferences reflect your own local time zone. To access your time zone preference in the WebCenter Spaces application, click the Preferences link at the top of the application and then select General. For more information, see Section 35.3, "Setting Date and Time Preferences."

The default options on the Show menu include:

- Today—The task flow displays all activities that have taken place between 12:00AM (2400 hours) and now.

- Since Yesterday—The task flow displays all activities that have taken place between now and yesterday at 12:00AM (2400 hours).

- Last 7 days—The task flow displays all activities that have taken place in the last 7 days.

- Last 30 days—The task flow displays all activities that have taken place in the last 30 days.

Note:

These options are described according to their default meanings. In some instances, an advanced user can provide alternative definitions for them. For more information, see Section 69.3, "Setting Recent Activities Task Flow Properties."

69.2.4 Accessing Recently Acted-On Items

The Recent Activities task flow groups the different services it reports on into nodes that are named for each service (Figure 69-7).

Figure 69-7 Service Nodes in the Recent Activities Task Flow

Expand a node, and access the changed item directly by clicking its link (Figure 69-8).

Figure 69-8 Recent Discussion Link in the Recent Activities Task Flow

The targets of linked items open on dynamically-generated pages, or in the WebCenter Spaces application, on dynamically-generated, top-level tabs. Link targets display according to their parent service. For example, click a Discussions service link to access a forum or a specific topic under a forum; click a Lists service link to access an updated list of lists or a specific updated list; click an event to display event details; and so on.

69.2.5 Refreshing the Recent Activities Task Flow

If you prefer not to wait for an automatic refresh of the Recent Activities task flow, you always have the option of refreshing the task flow yourself by clicking its Refresh icon (Figure 69-9).

Figure 69-9 The Refresh Icon on a Recent Activities Task Flow

The task flow updates and indicates the number of recently-changed items by increasing the value displayed in parenthesis next to each affected service.

69.3 Setting Recent Activities Task Flow Properties

For the steps to add a Recent Activities task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

The Recent Activities task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 69-10).

Figure 69-10 Recent Activities Task Flow Component Properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Recent Activities task flow and describe the properties on the Parameters tab:

- Section 69.3.1, "What You Should Know About the Recent Activities Task Flow Properties"

- Section 69.3.2, "Recent Activities Task Flow Parameters"

69.3.1 What You Should Know About the Recent Activities Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 69.3.2, "Recent Activities Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. These properties are unique to the task flow type. For more information, see Chapter 17, "Setting Properties on Page Components." For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Chapter 17, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Chapter 17, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Chapter 17, "Working with Child Components."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Expression Builder icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

69.3.2 Recent Activities Task Flow Parameters

Table 69-1 describes the parameters that are unique to the Recent Activities task flow.

Table 69-1 Recent Activities Task Flow Parameters

Parameter

Description

Group Space Name

Applicable in WebCenter Spaces only. Leave this field blank if the task flow is on a WebCenter portal application page.

Use this parameter to specify the Space for which to display recent activities. On a personal space page, use this to narrow the range of displayed activities. Rather than tracking activities application-wide—the default behavior—you can, for example, set a Constant value of a particular Space's display name.

On a Space page, use this parameter to display some other Space's recent activities or to display recent activities for all Spaces.

Valid values include:

- The display name or GUID of the Space to search

- null (empty), to search according to the contextual default

Use for Space pages only. An empty value on a Space page searches the current Space.

Note: Always specify a value on a personal space page. An empty value does not return any results. If no value is specified, then the following message displays in the Recent Activities task flow:

Recent Activity in the Personal Space requires a groupSpace taskflow parameter value to use for the search.

- defaultScope (or the defaultScope GUID), to search all Spaces

Medium Time Period in minutes

Defaults to Yesterday on the Recent Activity Show menu. For defining the time range between Short and Long within which activities are displayed on the Recent Activity list.

Valid values include:

- TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

- YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

- A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

Long Time Period in minutes

Defaults to Last 7 Days on the Recent Activity Show menu. Used for defining the time range between Medium and Longest within which activities are displayed on the Recent Activity list.

Valid values include:

- TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

- YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

- A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

Longest Time Period in minutes

Defaults to Last 30 Days on the Recent Activity Show menu. For defining the longest range of time within which activities are displayed on the Recent Activity list.

Valid values include:

- TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

- YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

- A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

Shortest Time Period in minutes

Defaults to Today on the Recent Activity Show menu. Used for defining the shortest range of time within which activities are displayed on the Recent Activity list. Today is measured from midnight in your selected time zone.

Valid values include:

- TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

- YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

- A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

70 Working with the Worklist Service

The Worklist service provides access to all the worklist items that require your attention. These worklist items are displayed on your application page, where you can view and act on all items in one place. These worklist items may be queried from all of the BPEL servers configured in your application.

This chapter contains the following sections:

- Section 70.1, "What You Should Know About the Worklist Service"

- Section 70.2, "Adding a Worklist Service Task Flow to a Page"

- Section 70.3, "Working with the Worklist Service Task Flow"

- Section 70.4, "Setting Worklist Service Task Flow Properties"

Audience

This chapter is intended for users interested in understanding and using the features of the Worklist service to track their tasks, notifications, and alerts.

The WebCenter Spaces application administrator has the authority to expose or hide task flows from a particular service. Tasks discussed in this chapter are not available to you if the relevant service is hidden.

Note:

For information about WebCenter Spaces seeded user roles, see "Managing Users and Roles for WebCenter Spaces" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

70.1 What You Should Know About the Worklist Service

The Worklist service provides access to BPEL worklist items that are created when a BPEL workflow process is invoked, or when messages are sent to the worklist channel on the Oracle User Messaging Service.

In WebCenter Spaces, the Worklist task flow (Figure 70-1) enables you to view and respond to all the worklist items that are allocated to you. If BPEL workflows are enabled in WebCenter Spaces, you must add a Worklist task flow to a page if you want to see your Space membership notifications, invitations to join new Spaces, and so on.

Figure 70-1 Worklist Task Flow

The Worklist task flow provides a fast and easy way to view and respond to messages, alerts, and notifications from the automated processes in place in your organization. You can click an item in the Worklist task flow to view details in a separate window (Figure 70-2).

Figure 70-2 Worklist Notification

For example, in WebCenter Spaces, if you are selected as an approver for Space membership, every time a user applies to become a member of the Space a notification is sent to your Worklist. This is just one example of the types of notifications and requests that can be posted on your Worklist.

One Worklist item might be a request for Space membership. Response to such a request would be to approve or reject it. Another Worklist item might be a notice of acceptance as a member of a Space. Response to such a notification would be to acknowledge that you have received it. These are two small examples of a much wider range of possible messages, alerts, notifications, and responses.

The Worklist only shows items from the Oracle SOA Suite BPEL Servers. Some Worklist items are kicked off by events that are associated with an externally defined workflow. A workflow maps the route an item follows after an event kicks off. For example, a workflow might define the way a project assignment is routed, such as from administrator, to moderator, and then to participant. Additionally, it specifies what happens (if anything) when the assignee responds (such as with an Acknowledge). This type of workflow is enabled in a Workflow server that comes with Oracle SOA Suite. The definition of these workflows is an administrative or development task.

The WebCenter Spaces application also has internally-defined workflows. An example of an internally-defined workflow includes the process of subscribing to a Space. A user requests a subscription. The request appears on the Space moderator's Worklist. If the Space has multiple moderators, the first response to the Worklist item is to claim ownership of the request, so that only one moderator responds to the request itself.

Messages, alerts, and notifications might also come from the User Messaging Service. The Worklist task flow includes a control for accessing messaging preferences on this server (Figure 70-3). Clicking the Messaging preferences icon displays the User Messaging Preferences page in which you can specify the channels over which to receive User Messaging Service messages and define messaging filters.

Figure 70-3 Worklist Messaging Preferences Icon

For information about setting messaging preferences for the User Messaging Service through WebCenter Spaces, see Section 70.3.2, "Setting Messaging Preferences."

Every 15 minutes, the Worklist task flow refreshes automatically with new messages, alerts, and notifications. Optionally, you can update your view yourself by clicking the task flow's Refresh Worklist icon (Figure 70-4).

Note:

The Worklist task flow does not get refreshed automatically when you perform an action on any task. You must refresh the task flow to list the latest items.

Figure 70-4 The Refresh Worklist Icon

Roll your mouse pointer over the Refresh Worklist icon to display the date and time the task flow was last refreshed.

To assist you in maintaining an organized view of your Worklist items, the Worklist task flow provides a variety of display options, accessible from the Worklist toolbar (Figure 70-5).

Figure 70-5 Worklist Display Options

Worklist display options enable you to approach responding to messages, alerts, and notifications according to timeliness and relevance.

For more information about Worklist display options, see Section 70.3.3, "Arranging Your Display of Worklist Items."

70.2 Adding a Worklist Service Task Flow to a Page

For the steps to add a Worklist service task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

Note:

You can add worklist task flows in personal pages only.

70.3 Working with the Worklist Service Task Flow

The Worklist task flow provides a fast and easy way to read and respond to items from the automated processes in place in your organization. All of the information on the Worklist is specifically relevant to you.

This section provides information about the Worklist task flow and describes how to use it. This section includes the following subsections:

- Section 70.3.1, "Viewing and Responding to Worklist Items"

- Section 70.3.2, "Setting Messaging Preferences"

- Section 70.3.3, "Arranging Your Display of Worklist Items"

70.3.1 Viewing and Responding to Worklist Items

To view a task, message, alert, or notification, simply click the Details link (Figure 70-6).

Figure 70-6 Selecting a Worklist Item for Viewing

Any Worklist item that is no longer of the Assigned state is removed from the Worklist during the next refresh.

70.3.2 Setting Messaging Preferences

The Worklist Messaging preferences icon provides access to controls for specifying your messaging preferences on the User Messaging Service. Use messaging preferences to specify the channels over which to receive User Messaging Service messages and to define messaging filters. User Messaging Service messages may include Worklist notifications in addition to other notifications and alerts from other consumers of the server.

Messaging channels are the channels over which messages, notifications, and alerts are received from the User Messaging Service. These include mail, voice over internet (VoIP), and the like. Messages, notifications, and alerts come from the services that are registered with the User Messaging Service.

Messaging filters define sorting conditions for messages and specify the channels through which to send messages that meet those conditions.

You can define messaging channels and filters using the User Messaging Preferences dialog. This section provides an overview of how to use this dialog to configure messaging channels and define messaging filters for messages generated from the User Messaging Service. For more information, see the User Messaging Service online help and the chapter "Oracle User Messaging Service Applications" in Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

To access the User Messaging Preferences dialog from the Worklist task flow:

1. Log in to your application.

2. Click the Messaging preferences icon in the Worklist toolbar and specify credentials to log in to the BPEL server.

Note:

In WebCenter Spaces, you can access the Worklist service by expanding the Worklist pane.

Figure 70-7 User Messaging Preferences

A web page opens with two tabs (Figure 70-7):

- Messaging Channels—Configure channels (such as mail, voice, and so on) to receive your User Messaging Service notifications and alerts.

- Messaging Filters—Define rules for filtering your User Messaging Service notifications and alerts.

3. Configure channels and filters by referring to the User Messaging Service online help.

70.3.3 Arranging Your Display of Worklist Items

This section describes how to use Worklist sorting and grouping options to arrange your display of the Worklist. Sorting affects the display order of Worklist items. Grouping divides items into groups that share a common attribute, such as a common category, a shared priority level, or some other common attribute.

You may notice a number next to each group (Figure 70-8). These indicate the number of items contained in a particular group. To expand a group and see the items it contains, click the Expand icon to the left of the group title.

Figure 70-8 Numbers Next to Worklist Groups

To arrange your display of Worklist items:

1. Log in to your application.

2. Click the Display Options icon at the top of the Worklist on your application page.

Note:

In WebCenter Spaces, you can access the Worklist by expanding the Worklist pane.

3. In the Display Options dialog box, expand the Group By list (Figure 70-9), and select an option for grouping your Worklist items.

Figure 70-9 The Worklist Group By List

Choose from:

- Category—Group Worklist items into their assigned categories. Items that do not belong to a category are grouped under the heading Not Categorized. Whether a Worklist item includes a category is determined by the workflow developer; consequently, not all items might include categories.

- Create Date—Group Worklist items according to the date they were created, starting with the most recent.

- Due Date—Group Worklist items according to when they are due. Due dates are optional; therefore, some items may not have them. In such cases, the date the item was created is used.

- Expiration Date—Group Worklist items according to when they are due to expire. Expiration dates are optional; therefore, some items may not have them. In such cases, the date the item was created is used.

- Not Grouped—Do not group Worklist items. When you group Worklist items by Not Grouped, the Worklist displays items in a flat list. All other grouping options display the items in a tree format.

- Priority—Group Worklist items according to priority, either high, normal, or low. Table 70-1 illustrates the priority indicators that are used in the Worklist.

Table 70-1 Worklist Priority Indicators

High

Normal

Low

No indicator

- Worklist Server—Group Worklist items according to the server from which they originated.

4. Select a Sort By option (Figure 70-10).

Figure 70-10 Sort By Options in the Worklist Display Options Dialog Box

Choose from:

- Create Date—Sort Worklist items according to the date they were created, starting with the most recent.

- Due Date—Sort Worklist items according to when they are due. Due dates are optional; therefore, some items may not have them. In such cases, the date the item was created is used.

- Expiration Date—Sort Worklist items from the most recent expiration to the furthest away. Expiration dates are optional; therefore, some items may not have them. In such cases, the date the item was created is used.

- Priority—Sort Worklist items from highest to lowest priority (see Table 70-1 for illustrations of priority indicators).

- Title—Sort Worklist items first from 0 to 9 then from a to z.

5. Click Save to save your changes and close the Display Options dialog box.

The Worklist displays newest created 25 items per Worklist server connection. For items exceeding the 25-item limit, follow the link to the BPEL Worklist Application, where you can view and act on a larger volume of Worklist items.

70.4 Setting Worklist Service Task Flow Properties

The Worklist service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 70-11). Many properties are common to all task flows, and the method for accessing task flow properties is the same from task flow to task flow. Common task flow properties and how to access them are discussed in Section 17.5.2, "Setting Properties on Page Components."

Figure 70-11 Worklist Task Flow Component Properties

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Section 17.5.2.7, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on Display Options tab provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Expression Builder icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

Part XVII

Appendices

Part XVII of the User's Guide catalogs short, user-friendly URLs to locations within the WebCenter Spaces UI, such as Administration pages and pages in Spaces and Home Spaces (pretty URLs). It also catalogs Expression Language expressions for use in a WebCenter Spaces context.

Part XVII includes the following appendices:

- Appendix A, "WebCenter Spaces User Interface URLs"

- Appendix B, "Expression Language Expressions"

- Appendix C, "Business Mashup Examples"

A WebCenter Spaces User Interface URLs

In view of the many options available in WebCenter Spaces for defining navigation in your portal, a consistent and reliable method for accessing pages and application user interface pages (UI) is essential. This requirement is easily met through WebCenter Spaces user interface URLs—or pretty URLs.

Pretty URLs provide a means of delivering predictable URLs to navigate to specific locations within the WebCenter Spaces UI. For example, when you create a Space, pretty URLs make it possible to know which URL to use to go to the General Settings page of that Space. Imagine that you create a page template for a Space or the Home Space. You do not provide a link in the template for accessing the Resources page, where you can edit the template. Rather than being an error, this may very well be a choice: you can always use a pretty URL to go to the Space's Resources page, under Space Settings, or, for the Home Space, the Resources page in the Administration pages.

Because pretty URLs are shorter than standard URLs, you can use them to shield your users from complex application page URLs.

This appendix provides the syntax for the pretty URLs you can use to access user Profiles, pages, Spaces, and administration screens in the WebCenter Spaces UI.

This appendix includes the following sections:

- Section A.1, "User Interface URLs for User Profiles"

- Section A.2, "User Interface URLs for Home Space Pages"

- Section A.3, "User Interface URLs for Space Pages"

- Section A.4, "User Interface URLs for Application Administration Pages"

A.1 User Interface URLs for User Profiles

Use Profile pretty URLs to navigate to your own or another user's Profile page. Note that when you omit the user name or when the user name is the current user's name, the URL launches the My Profile page; but if the user name is provided and is not the current user's name, the URL launches the User Profile page.

See Also:

For information about the My Profile and User Profile pages, see Table 7-2, "Seeded System Pages".

Table A-1 lists and describes the syntax for the UI URLs you can formulate for easy access to your own or another user's Profile.

Table A-1 User Interface URLs to a User Profile

Use Case

Pretty URL Syntax

Take the user to the My Profile or User Profile page that is defined at the application level

http://host:port/webcenter/spaces/profile/userName

http://host:port/webcenter/spaces/profile

Take the user to the My Profile or User Profile page that is defined at the Space level

http://host:port/webcenter/spaces/spaceName/profile/userName

http://host:port/webcenter/spaces/spaceName/profile

A.2 User Interface URLs for Home Space Pages

Table A-2 lists and describes the syntax for the UI URLs you can formulate for easy access to pages in the Home Space.

Table A-2 User Interface URLs to Pages in the Home Space

Use Case

Pretty URL Syntax

Take user to the home page of the Home Space

http://host:port/webcenter/spaces/home

Take user to the Home Space page he or she last accessed

http://host:port/webcenter

http://host:port/webcenter/spaces

Take user to a specific page in the Home Space

http://host:port/webcenter/spaces/page/escapedPageDisplayName

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

A.3 User Interface URLs for Space Pages

Table A-3 lists and describes the syntax for the UI URLs you can use to access Space pages and Space administration pages. Only users assigned a role that includes the permission Administration: Manage All can access Space administration pages.

In Table A-3, wherever the variable SpaceName is indicated, use the Space name that is specified by the Space URL on the General page of a Space's administration settings (Figure A-1).

Figure A-1 Space Internal Name on Space Settings General Page

You can also find the appropriate Space name next to the Name label by accessing the About Space dialog. For more information, see Section 29.9.1, "Accessing Space Information."

Table A-3 User Interface URLs to Pages in a Space

Use Case

Pretty URL Syntax

Take user to the specified Space, where the last-accessed page is displayed

http://host:port/webcenter/spaces/SpaceName

Take user to the first page of a Space

http://host:port/webcenter/spaces/SpaceName/home

Take user to a specific page in a Space

http://host:port/webcenter/spaces/SpaceName/page/escapedPageDisplayName

The variable escapedPageDisplayName indicates the use of an escaped version of the page display name. For example, when you create a page with the name My Page, the URL to this page ends with My+Page.

Take Space moderator to Space Settings page

http://host:port/webcenter/spaces/spaceName/admin

Take Space moderator to General subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/general

Take Space moderator to Roles subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/roles

Note: When a Subspace inherits its members and roles from the parent Space, you cannot use a pretty URL to navigate to the Subspace Roles page because it does not exist.

Take Space moderator to Members subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/members

Note: When a Subspace inherits its members and roles from the parent Space, you cannot use a pretty URL to navigate to the Subspace Members page because it does not exist.

Take Space moderator to Available Pages under the Pages subpage of the Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/spacepages

Take Space moderator to System Pages under the Pages subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/systempages

Take Space moderator to Services subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/services

Take Space moderator to Subspaces subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/subspaces

Take Space moderator to Custom Attributes subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/attributes

Take Space moderator to Resources subpage of Space Settings page

http://host:port/webcenter/spaces/spaceName/admin/resources

A.4 User Interface URLs for Application Administration Pages

Table A-4 lists and describes the UI URL syntax to use to access WebCenter Spaces Administration pages. These pages are accessible only to WebCenter Spaces administrators and are used for application configuration.

Table A-4 User Interface URLs to WebCenter Spaces Administration Pages

Use Case

Pretty URL Syntax

Take the administrator to the application Administration page

http://host:port/webcenter/spaces/admin

Take the administrator to the General subpage of the Configuration page

http://host:port/webcenter/spaces/admin/general

Take the administrator to the Spaces subpage of the Spaces page

http://host:port/webcenter/spaces/admin/spaces

Take the administrator to the Space Templates subpage of the Spaces page

http://host:port/webcenter/spaces/admin/templates

Take the administrator to the Roles subpage of the Security page

http://host:port/webcenter/spaces/admin/roles

Take the administrator to the Users and Groups subpage of the Security page

http://host:port/webcenter/spaces/admin/users

Take the administrator to the Resources page

http://host:port/webcenter/spaces/admin/resources

Take the administrator to the Services subpage of the Configuration page

http://host:port/webcenter/spaces/admin/services

Take the administrator to the Business Role Pages subpage of the Pages page

http://host:port/webcenter/spaces/admin/brpages

Take the administrator to the Personal Pages subpage of the Pages page

http://host:port/webcenter/spaces/admin/personalpages

Take the administrator to the System Pages subpage of the Pages page

http://host:port/webcenter/spaces/admin/systempages

B Expression Language Expressions

When configuring page components, you can express values as variables that take advantage of the current application context by grabbing information that happens to be true at the moment. For example, you can use variables to obtain the name of the current user, the user's assigned role, the state of the current page, and the like.

Such flexibility is made possible through the Expression Builder that is provided with each Parameter and Display Option property.

This appendix provides information about the editor and useful EL expressions. It includes the following subsections:

- Section B.1, "Introducing the Expression Builder"

- Section B.2, "Expression Language Example Use Case"

- Section B.3, "Expression Language Expressions"

See Also:

For additional information about EL APIs, see Oracle Fusion Middleware Java API Reference for Oracle WebCenter.

B.1 Introducing the Expression Builder

All properties on the Parameters and Display Options tabs provide an Expression Builder icon that opens a simple Expression Language (EL) editor, called the Expression Builder. Use the Expression Builder when you want to formulate a dynamic computation for an otherwise unknown property value, for example, to specify the current user, the current page mode, and the like.

Click the Expression Builder icon next to a property to open the editor. (Figure B-1).

Figure B-1 Expression Builder Icon Next to a Parameter Value Field and the Resulting Editor

See Also:

For information about accessing component properties, see Section 17.5.2, "Setting Properties on Page Components."

The Expression Builder is particularly useful when you want a value that is retrievable but otherwise unknown, for example, when you want a value to be the name of the current user or the current application skin.

The Expression Builder provides two options for entering expressions:

- Choose a value, for selecting a seeded EL expression

- Type a value or expression, for entering an expression manually

The options under Choose a value are categorized according to the type of information an expression returns. Select a category from the first menu, and then select the type of value you want returned from the second menu (Figure B-2).

Figure B-2 Options Under Choose a value in the Expression Builder

See Also:

For information about seeded EL expressions, see Section B.3.1, "Seeded Expressions in the Expression Builder."

The option Type a value or expression is followed by a text box, which you can use to manually enter the expression you intend (Figure B-3).

Figure B-3 Text Box Under Type a value or expression in the Expression Builder

Many expressions in the tables in this appendix are building blocks for narrowing down the object or objects you want returned. That is, they are not necessarily meant to be used by themselves, but rather in an assembly of ELs to form the desired query.

For example, the following expression uses three resource-related ELs to form a single query that returns a particular Space template. It retrieves the template storesMasterTemplate from the parent Space stores:

#{srmContext.resourceScope['stores'].resourceType['siteTemplate'].displayName['storesMasterTemplate'].singleResult}

In the Expression Builder, select predefined values, under Choose a value, or enter a value or an Expression Language expression, under Type a value or expression.

Use the following formats to enter values:

- a literal number: #{123}

- a literal string: #{'string'}

- a literal Boolean: #{true}

- a Java Bean called to return a value: #{generalSettings.preferredTimeStyle}

The editor provides a Test button for validating your EL entry. The Test button is available for expressions entered in the text box under Type a value or expression.

Validation checks the EL syntax and evaluates the expression. Because expression values vary according to the context in which they are executed, the resulting value that appears in the editor may differ from the value returned during actual use.

Note, however, that only EL is validated when you click Test; other types of values are not validated.

Test results are shown in a popup (Figure B-4).

Figure B-4 Test Result in EL Editor

B.2 Expression Language Example Use Case

This section provides an example of using EL expressions to display something based on a user's role, permissions, and the like.

In this example, we will use Expression Language to reveal or hide an item in the navigation model based on the user's role. Because there is Expression Language for almost every piece of metadata maintained by WebCenter Spaces, using ELs to personalize the user's experience is an extremely powerful tool.

You can use the following EL to determine a user's role:

#{WCSecurityContext.userInScopedRole['Role 1'] or   WCSecurityContext.userInScopedRole['Role 2']}

This EL compares the current user's credentials (in this case, the role), against what is specified in the EL. If the result is true, that is, if the user is assigned one of the specified roles then the navigation item is visible to the user. If the result is false, the navigation item is hidden from the user.

The roles referred to in the EL can be a system role, such as Administrator, Moderator, Participant, or a custom role.

Notice that this EL joins two conditions with the use of an OR clause; that is, the user must have either Role 1 OR Role 2 to be able to see the navigational item.

These steps demonstrate how to add a navigational item (a page query for another Space) that is visible only to user assigned the role Moderator.

Note:

This exercise assumes you have applied a custom navigation model to your Space. You cannot edit a seeded navigation model.

To personalize navigation:

1. Go to Space Settings, and access the Navigations panel under Resources.

You can use the following URL to navigate to the Resources subpage, from there, click Navigations:

http://host:port/webcenter/spaces/spaceName/admin/resources

2. Select the navigation model that the Space is using.

Tip:

To find out which navigation model the current Space is using, go to the General subpage under Space Settings, and look for the value in the Navigation field.

3. From the Edit menu, select Edit.

4. In the Edit - navigation model dialog, expand the Add menu, and select Pages Query.

5. Bring the Target tab forward:

- In the Name field, enter a name for your query, for example, moderatorQuery.

- Next to Find Page in, select Space, and ensure that the current Space name appears in the field.

- Click the icon to the right of the Visible checkbox, and select Expression Builder.

6. Select Choose a value, and then select Space Info from the first dropdown and CurrentSpace Role - Moderator from the second.

The expression #{WCSecurityContext.userInScopedRole['Moderator']} appears in the text field.

Tip:

If you are working with a custom role, you choose CurrentSpace Role - Custom from the dropdown. In the text area, highlight CustomRole, then type in the name of your custom role.

7. Click OK until you return to the Resources tab.

To test this, add a member to the Space, and assign this user any role other than Moderator. Log off and log back in as that user. You should not see the Pages Query navigational item.

B.3 Expression Language Expressions

This section provides a series of tables that list and describe useful EL expressions. Tables are grouped according to the context in which the expressions they contain apply.

This section includes the following subsections:

- Section B.3.1, "Seeded Expressions in the Expression Builder"

- Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application"

- Section B.3.3, "EL Expressions Relevant to Application Security"

- Section B.3.4, "EL Expressions Relevant to Application Navigation"

- Section B.3.5, "EL Expressions Relevant to Resources"

- Section B.3.6, "EL Expressions Relevant to Specific Spaces"

- Section B.3.7, "EL Expressions Relevant to Specific Pages"

- Section B.3.8, "EL Expressions Relevant to Oracle Composer"

- Section B.3.9, "EL Expressions Relevant to Event Contexts"

- Section B.3.10, "EL Expressions Relevant to Services"

- Section B.3.11, "EL Expressions Relevant to the Personalization Conductor"

- Section B.3.12, "EL Expressions Relevant to the Documents Service"

- Section B.3.13, "EL Expressions Relevant to the People Connections Service"

- Section B.3.14, "EL Expressions Relevant to User Preferences"

- Section B.3.15, "Utilitarian EL Expressions"

B.3.1 Seeded Expressions in the Expression Builder

In the Expression Builder editor, when you select the option Choose a value you can populate the text box in the dialog with a seeded EL expression. First, select an expression category, and then select the type of information you want the expression to return. Your selection's associated EL appears in the text box at the bottom of the dialog (Figure B-5).

Figure B-5 Options Under Choose a value in the Expression Builder

This section is broken into subsections for each category. Each subsection lists and describes the ELs associated with that category.

This section includes the following subsections:

- Section B.3.1.1, "Application Info Seeded ELs"

- Section B.3.1.2, "Page Info Seeded ELs"

- Section B.3.1.3, "Page Parameter Seeded ELs"

- Section B.3.1.4, "Resource Info Seeded ELs"

- Section B.3.1.5, "Space Info Seeded ELs"

- Section B.3.1.6, "Space Page Info Seeded Paths"

- Section B.3.1.7, "System Seeded ELs"

- Section B.3.1.8, "User Info Seeded ELs"

- Section B.3.1.9, "WebCenter Events Seeded ELs"

B.3.1.1 Application Info Seeded ELs

Application Info seeded EL expressions return values related to the WebCenter Spaces application. For example, the expression #{WCAppContext.application.applicationConfig.title}, returns the application title that is specified on the Configuration page in the WebCenter Administration pages.

See Also:

For additional EL expressions related to the application, see Section B.3.2, "EL Expressions Relevant to the WebCenter Spaces Application."

Table B-1 lists the seeded EL expressions available under the category Application Info and provides an example of the types of values each returns.

Table B-1 Seeded EL Expressions Under Application Info

Option

Expression

Example of Returned Value

Current Scope

#{serviceCtx.scope}

Scope[name=standards, guid=sa78185d3_9d65_49ab_ac1d_4809380d0b30]

Current Page Template Scope

#{WCAppContext.currentScope}

Scope[name=standards, guid=sa78185d3_9d65_49ab_ac1d_4809380d0b30]

Previously Set Page Template

#{WCAppContext.previouslySetPageTemplate}

Fusion Side Navigation

Application

#{WCAppContext.application}

oracle.webcenter.webcenterapp.internal.view.shell.WCApplication

Application URL

#{WCAppContext.applicationURL}

http://host:port/webcenter

Current WebCenter URL

#{WCAppContext.currentWebCenterURI}

/oracle/webcenter/page/scopedMD/GUID/businessRolePages/Page3.jspx?wc.contextURL=%2Fspaces

Application Config

#{WCAppContext.application.applicationConfig}

oracle.webcenter.webcenterapp.beans.WebCenterMetadataImpl@123db9d

Application Config Title

#{WCAppContext.application.applicationConfig.title}

WebCenter

Application Config Logo

#{WCAppContext.application.applicationConfig.logo}

/oracle/webcenter/webcenterapp/metadata/images/logo.gif

Application Config HelpPage

#{WCAppContext.application.applicationConfig.helpPage}

/webcenterhelp/spaces?topic=welcome_main

Application Config CopyrightMessage CustomValue

#{WCAppContext.application.applicationConfig.copyrightMessage.customValue}

http://www.oracle.com/html/copyright.html

Application Config Privacy Policy URL

#{WCAppContext.application.applicationConfig.privacyPolicyUrl}

http://www.oracle.com/html/privacy.html

Application Config Skin

#{WCAppContext.application.applicationConfig.skin}

webcenterfx

B.3.1.2 Page Info Seeded ELs

Page Info seeded EL expressions return values related to WebCenter Spaces pages. For example, the expression #{pageDocBean.createdBy}, returns the user name of the person who created the current page.

Table B-2 lists the seeded EL expressions available under the category Page Info and provides an example of the types of values each returns.

Table B-2 Seeded EL Expressions Under Page Info

Option

Expression

Example of Returned Value

Title

#{pageDocBean.title}

Welcome Page (BRP)

Created By

#{pageDocBean.createdBy}

j.doe

Create Date String

#{pageDocBean.createDateString}

2010-11-17T13:27:52

Last Updated By

#{pageDocBean.lastUpdatedBy}

j.smith

Last Update Date String

#{pageDocBean.lastUpdateDateString}

2010-11-17T13:27:52

Page Path

#{pageDocBean.pagePath}

/oracle/webcenter/page/scopedMD/GUID/businessRolePages/Page3.jspx

Name

#{pageDocBean.name}

Page3.jspx

UI CSS Style

#{pageDocBean.UICSSStyle}

WCSchemeCustom

UI Scheme BG Image

#{pageDocBean.UISchemeBGImage}

#{facesContext.externalContext.requestContextPath}/adf/oracle/webcenter/page/images/clouds.png

UI BG String Color Scheme

#{pageDocBean.UISchemeBGColorString}

null

Page Permission

#{pageDocBean.pagePermission}

oracle.webcenter.page.model.security.CustomPagePermission

Page Security Target

#{pageDocBean.pageSecurityTarget}

oracle_webcenter_page_scopedMD_sa78185d3_9d65_49ab_ac1d_4809380d0b30_COIHomePageDef

B.3.1.3 Page Parameter Seeded ELs

Page Parameter seeded EL expressions return values related to WebCenter Spaces page parameters. The editor lists all parameters that are defined for the current page. If no parameters are defined, the Page Parameter category is not available.

For example, the seeded page style Three Column provides five seeded page parameters (see Table B-3). The width parameters describe the percentage of total width allotted to each column. The show parameters specify whether a page header and footer are rendered. Of the seeded page styles, Blank, Home Page, Left Narrow, and Right Narrow all provide the same seeded page parameters (see Table B-3). Additionally, any page may have its own custom page parameters.

Whether seeded or custom, available page parameters are exposed in the Expression Builder editor under the Page Parameter category.

See Also:

For more information about creating and using page parameters, see Section 19.3, "Wiring Components and Page Parameters."

Table B-3 lists the EL expressions available under the Page Parameter category for pages based on the styles Three Column, Blank, Home Page, Left Narrow, and Right Narrow. It provides an example of the types of values each returns.

Table B-3 Seeded EL Expressions Under Page Parameter

Option

Expression

Example of Returned Value

leftWidth

#{bindings.leftWidth}

25%

centerWidth

#{bindings.centerWidth}

50%

rightWidth

#{bindings.rightWidth}

25%

showHeader

#{bindings.showHeader}

false

showFooter

#{bindings.showFooter}

false

B.3.1.4 Resource Info Seeded ELs

Resource Info seeded EL expressions return values related to WebCenter Spaces resources, such as templates, styles, resource catalogs, and the like. For example, the expression #{srmContext.id['ResourceID'].singleResult}, returns the resource with the specified GUID.

See Also:

For additional resource-related EL expressions, see Section B.3.5, "EL Expressions Relevant to Resources."

Table B-4 lists the seeded EL expressions available under the category Resource Info and provides an example of the types of values each returns.

Table B-4 Seeded EL Expressions Under Resource Info

Option

Expression

Example of Returned Value

Resource ID

#{srmContext.id['ResourceID'].singleResult}

id:gsr3396194a_3a72_44d6_90b4_57fd6efe4ff7 resourceScope:Scope[name=defaultScope, guid=s8bba98ff_4cbb_40b8_beee_296c916a23ed] resourceType:siteTemplate serviceId:oracle.webcenter.siteresources.sitetemplate category: displayName:Fusion Side Navigation displayNameKey:SITE_TEMPLATE_FUS_SIDE_STRETCH_NAV_DN description:Stretching Page Layout with Side Navigation. Use Fusion FX Skin. descriptionKey:SITE_TEMPLATE_FUS_SIDE_STRETCH_NAV_DESC contentDirectory:/oracle/webcenter/siteresources/shared metadataFile: jspx:/oracle/webcenter/webcenterapp/view/templates/WCSiteTemplateSideNavStretch.jspx pageDef:/oracle/webcenter/webcenterapp/bindings/pageDefs/oracle_webcenter_webcenterapp_view_templates_WCSiteTemplateSideNavStretchPageDef.xml iconURI: excludeFrom: usesCustomSecurity:false visible:TRUE seeded:true createdBy:system createdDate:Fri Jul 02 05:44:19 PDT 2010 modifiedBy:system resourceBundle:oracle.webcenter.sitetemplate.view.resource.SiteTemplateBundle modifiedDate:Fri Jul 02 05:44:19 PDT 2010 logoUrl:/adf/webcenter/srm_dflt_logo_qualifier.png attributes:[]

Resource Display Name

#{srmContext.displayName['DisplayName'].singleResult}

See Resource ID for an example of a returned value.

Description

#{srmContext.description['Description'].singleResult}

See Resource ID for an example of a returned value.

Creation Date

#{srmContext.createdDate['creationDate'].singleResult}

See Resource ID for an example of a returned value.

Modified By

#{srmContext.modifiedBy['UserName'].singleResult}

See Resource ID for an example of a returned value.

Modified Date

#{srmContext.modifiedDate['ModifiedDate'].singleResult}

See Resource ID for an example of a returned value.

Resource Scope

#{srmContext.resourceScope['ResourceScope'].singleResult}

See Resource ID for an example of a returned value.

B.3.1.5 Space Info Seeded ELs

Space Info seeded EL expressions return values related to Spaces (other than the Home Space). For example, the expression #{spaceContext.space['spaceName'].children}, returns a list of the Subspaces under the named parent Space.

See Also:

For additional Space-related EL expressions, see Section B.3.6, "EL Expressions Relevant to Specific Spaces."

Table B-5 lists the seeded EL expressions available under the category Space Info and provides an example of the types of values each returns.

Note:

Use the EL expressions listed in Table B-5 only in the context of Spaces other than the Home Space.

Table B-5 Seeded EL Expressions Under Space Info

Option

Expression

Example of Returned Value

NamedSpace

#{spaceContext.space['spaceName']}

oracle.webcenter.spaces.internal.model.SpaceImpl@15fc839

CurrentSpace

#{spaceContext.currentSpace}

oracle.webcenter.spaces.internal.model.SpaceImpl@d5e197

CurrentSpace Name

#{spaceContext.currentSpaceName}

standards

NamedSpace Metadata Path

#{spaceContext.space['spaceName'].metadataPath}

/oracle/webcenter/space/metadata/spaces/spaceName/space.xml

CurrentSpace Metadata Path

#{spaceContext.currentSpace.metadataPath}

/oracle/webcenter/space/metadata/spaces/standards/space.xml

NamedSpace Metadata

#{spaceContext.space['spaceName'].metadata}

oracle.webcenter.spaces.beans.SpaceMetadataImpl@1d7320a

CurrentSpace Metadata

#{spaceContext.currentSpace.metadata}

oracle.webcenter.spaces.beans.SpaceMetadataImpl@1096c64

NamedSpace Metadata DisplayName

#{spaceContext.space['spaceName'].metadata.displayName}

Standards

CurrentSpace Metadata DisplayName

#{spaceContext.currentSpace.GSMetadata.displayName}

Sales

NamedSpace Metadata Icon

#{spaceContext.space['spaceName'].metadata.icon}

/oracle/webcenter/space/metadata/spaces/standards/images/wc_coi_icon.png

CurrentSpace Metadata Icon

#{spaceContext.currentSpace.metadata.icon}

/oracle/webcenter/space/metadata/spaces/Test_Space/images/wc_prj_icon.png

NamedSpace Metadata Description

#{spaceContext.space['spaceName'].metadata.description}

Central point for all standards, templates, and stylesheets for company collateral

CurrentSpace Metadata Description

#{spaceContext.currentSpace.GSMetadata.description}

Sales Force Team Site

NamedSpace Metadata CreationDate

#{spaceContext.space['spaceName'].metadata.creationDate}

java.util.GregorianCalendar[time=1290103432242,areFieldsSet=true,areAllFieldsSet=false,lenient=false,zone=java.util.SimpleTimeZone[id=,offset=-28800000,dstSavings=3600000,useDaylight=false,startYear=0,startMode=0,startMonth=0,startDay=0,startDayOfWeek=0,startTime=0,startTimeMode=0,endMode=0,endMonth=0,endDay=0,endDayOfWeek=0,endTime=0,endTimeMode=0],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2010,MONTH=10,WEEK_OF_YEAR=?,WEEK_OF_MONTH=?,DAY_OF_MONTH=18,DAY_OF_YEAR=?,DAY_OF_WEEK=?,DAY_OF_WEEK_IN_MONTH=?,AM_PM=0,HOUR=10,HOUR_OF_DAY=10,MINUTE=3,SECOND=52,MILLISECOND=242,ZONE_OFFSET=?,DST_OFFSET=?]

CurrentSpace Metadata CreationDate

#{spaceContext.currentSpace.metadata.creationDate}

java.util.GregorianCalendar[time=1290103432242,areFieldsSet=true,areAllFieldsSet=false,lenient=false,zone=java.util.SimpleTimeZone[id=,offset=-28800000,dstSavings=3600000,useDaylight=false,startYear=0,startMode=0,startMonth=0,startDay=0,startDayOfWeek=0,startTime=0,startTimeMode=0,endMode=0,endMonth=0,endDay=0,endDayOfWeek=0,endTime=0,endTimeMode=0],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2010,MONTH=10,WEEK_OF_YEAR=?,WEEK_OF_MONTH=?,DAY_OF_MONTH=18,DAY_OF_YEAR=?,DAY_OF_WEEK=?,DAY_OF_WEEK_IN_MONTH=?,AM_PM=0,HOUR=10,HOUR_OF_DAY=10,MINUTE=3,SECOND=52,MILLISECOND=242,ZONE_OFFSET=?,DST_OFFSET=?]

NamedSpace Metadata CreatedBy

#{spaceContext.space['spaceName'].metadata.createdBy}

j.doe

NamedSpace Metadata Keywords

#{spaceContext.space['spaceName'].metadata.keywords}

standards templates style sheets collateral

CurrentSpace Metadata Keywords

#{spaceContext.currentSpace.metadata.keywords}

sales salesReports salesNews salesTeam

NamedSpace Metadata Offline

#{spaceContext.space['spaceName'].metadata.offline}

false or true, depending on whether the named Space is offline

CurrentSpace Metadata Offline

#{spaceContext.currentSpace.metadata.offline}

false or true, depending on whether the current Space is offline

NamedSpace Metadata Closed

#{spaceContext.space['spaceName'].metadata.offline}

false or true, depending on whether the named Space is closed

CurrentSpace Metadata Closed

#{spaceContext.currentSpace.metadata.closed}

false or true, depending on whether the current Space is closed

NamedSpace Metadata SelfRegistration

#{spaceContext.space['spaceName'].metadata.selfRegistration}

false or true, depending on whether self registration is enabled for the named Space

CurrentSpace Metadata SelfRegistration

#{spaceContext.currentSpace.metadata.selfRegistration}

false or true, depending on whether self registration is enabled for the current Space

NamedSpace Metadata Discoverable

#{spaceContext.space['spaceName'].metadata.discoverable}

false or true, depending on whether the named Space is discoverable

CurrentSpace Metadata Discoverable

#{spaceContext.currentSpace.metadata.discoverable}

false or true, depending on whether the current Space is discoverable

NamedSpace Metadata PublishRSS

#{spaceContext.space['spaceName'].metadata.publishRSS}

false or true, depending on whether the named Space can be published in an RSS reader

CurrentSpace Metadata PublishRSS

#{spaceContext.currentSpace.metadata.publishRSS}

false or true, depending on whether the current Space can be published in an RSS reader

NamedSpace Distribution List

#{spaceContext.space['spaceName'].distributionList}

standardsGroup@myCompany.com

CurrentSpace Distribution List

#{spaceContext.currentSpace.distributionList}

salesTeam@myCompany.com

NamedSpace Metadata CustomAttributes

#{spaceContext.space['spaceName'].metadata.customAttributes['attributeName']}

Returns the value provided for the named custom attribute

CurrentSpace Metadata CustomAttributes

#{spaceContext.currentSpace.metadata.customAttributes['attributeName']}

Returns the value provided for the named custom attribute

CurrentSpace Metadata Logo

#{WCAppContext.spacesResourcesPath}#{spaceContext.currentSpace.metadata.logo}

/webcenter-spaces-resources/oracle/webcenter/space/metadata/spaces/standards/images/wc_coi_logo.png

CurrentSpace Role - Moderator

#{WCSecurityContext.userInScopedRole['Moderator']}

false or true, depending whether any users in the current scope are assigned the role Moderator

CurrentSpace Role - Participant

#{WCSecurityContext.userInScopedRole['Participant']}

false or true, depending whether any users in the current scope are assigned the role Participant

CurrentSpace Role - Viewer

#{WCSecurityContext.userInScopedRole['Viewer']}

false or true, depending whether any users in the current scope are assigned the role Viewer

CurrentSpace Role - Custom

#{WCSecurityContext.userInScopedRole['CustomRole']}

false or true, depending on if any users in the current scope are assigned the named custom role

NamedSpace Children

#{spaceContext.space['spaceName'].children}

[oracle.webcenter.spaces.internal.model.SpaceImpl@5705f4, oracle.webcenter.spaces.internal.model.SpaceImpl@147d658]

Note: The braces ([]) denote a set.

CurrentSpace Children

#{spaceContext.currentSpace.children}

[oracle.webcenter.spaces.internal.model.SpaceImpl@5705f4, oracle.webcenter.spaces.internal.model.SpaceImpl@147d658]

Note: The braces ([]) denote a set.

NamedSpace Parent

#{spaceContext.space['spaceName'].parent}

oracle.webcenter.spaces.internal.model.SpaceImpl@15fc839

CurrentSpace Parent

#{spaceContext.currentSpace.parent}

oracle.webcenter.spaces.internal.model.SpaceImpl@15fc839

NamedSpace Security Parent

#{spaceContext.space['spaceName'].securityParent}

oracle.webcenter.spaces.internal.model.SpaceImpl@1392793

CurrentSpace Security Parent

#{spaceContext.currentSpace.securityParent}

oracle.webcenter.spaces.internal.model.SpaceImpl@1392793

All visible root level spaces

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE,DISCOVERABLE,PUBLIC_ACCESSIBLE,ALLUSER_ACCESSIBLE,USER_JOINED,USER_MODERATED'].shape['ROOT_LEVEL']}

oracle.webcenter.spaces.query.SpacesQueryParameters@ae34c8

All children and descendent spaces for specified Parent Space GUID

#{spaceContext.spacesQuery.parentSpaceGuid['spaceGuid'].shape['RECURSIVE_FLATTENED']}

oracle.webcenter.spaces.query.SpacesQueryParameters@4da22f

Immediate Sub Spaces for specified Parent Space name

#{spaceContext.spacesQuery.parentSpaceName['spaceGuid'].shape['ROOT_LEVEL']}

oracle.webcenter.spaces.query.SpacesQueryParameters@1089971

List of Spaces matching given Space Names

#{spaceContext.spacesQuery.containingNames['space1, space2,space3']}

oracle.webcenter.spaces.query.SpacesQueryParameters@68e467

List of Spaces matching given Space GUID

#{spaceContext.spacesQuery.containingGuids['spaceGuid1, spaceGuid2']}

oracle.webcenter.spaces.query.SpacesQueryParameters@1c56009

List of Spaces sorted based on criteria

#{spaceContext.spacesQuery.unionOf.ALL_QUERIABLE.sortCriteria['sp.lastUpdateDate desc']}

oracle.webcenter.spaces.query.SpacesQueryParameters@6c3def

List of Spaces based on search pattern

#{spaceContext.spacesQuery.unionOf.ALL_QUERIABLE.search['searchKeyword']}

oracle.webcenter.spaces.query.SpacesQueryParameters@19b2cf3

List of Spaces with limited page size

#{spaceContext.spacesQuery.unionOf.USER_JOINED.itemsPerPage[2].pageNumber[1]}

oracle.webcenter.spaces.query.SpacesQueryParameters@4f8818

List of Spaces matching the where clause

#{spaceContext.spacesQuery.unionOf.USER_JOINED.whereClause['sp.createdBy = \'userName\'']}

oracle.webcenter.spaces.query.SpacesQueryParameters@1ba816d

B.3.1.6 Space Page Info Seeded Paths

Rather than EL expressions, the selections under Space Page Info are directory paths to different application pages. Use them, for example, to provide navigation information to a specified page.

Table B-6 lists the seeded directory paths available under the category Space Page Info and provides an example of the types of values each returns.

Table B-6 Seeded Paths Under Space Page Info

Option

Path

Destination

COIHome.jspx

/faces/oracle/webcenter/page/scopedMD/se2dff4fb_202a_4f4c_b56d_c7cf59ad1c04/COIHome.jspx

Path to the Home page of the current Space

GroupSpaceDocLibMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/GroupSpaceDocLibMainView.jspx

Path to the Documents page in the current Space

ForumMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/ForumMainView.jspx

Path to Discussions page in the current Space

AnnouncementsMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/AnnouncementsMainView.jspx

Path to Announcements page in current Space

EventsMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/EventsMainView.jspx

Path to Events page in current Space

ListsMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/ListsMainView.jspx

Path to Lists page in current Space

GroupSpaceActivityMainView.jspx

/faces/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/GroupSpaceActivityStreamMainView.jspx

Path to Activity Stream page in current Space

B.3.1.7 System Seeded ELs

System seeded EL expressions return values related to system settings, such as the user name of the current user or the current user's specified locale. For example, the expression #{securityContext.userName}, returns the name of the currently logged in user. For example, if user j.doe is viewing a page where this expression is used, the returned value in j.doe's view is j.doe. If user j.smith is looking at the same page, the value returned in j.smith's view is j.smith.

See Also:

For additional utilitarian EL expressions, see Section B.3.15, "Utilitarian EL Expressions."

Table B-7 lists the seeded EL expressions available under the category System and provides an example of the types of values each returns.

Table B-7 Seeded EL Expressions Under System

Option

Expression

Example of Returned Value

User

#{securityContext.userName}

The current user's user name

Locale

#{facesContext.externalContext.requestLocale}

The current user's specified locale

This may be taken from application or Space-level settings or user Preferences, whichever is taking precedence.

For example:

en_US

B.3.1.8 User Info Seeded ELs

User Info seeded EL expressions return values related to a given user's Profile. For example, the expression #{webCenterProfile[securityContext.userName].description}, returns the content of the About Me attribute of the current user's Profile.

See Also:

For additional user-related expressions, see Section B.3.13, "EL Expressions Relevant to the People Connections Service."

Table B-8 lists the seeded EL expressions available under the category User Info and provides an example of the types of values each returns.

Table B-8 Seeded EL Expressions Under User Info

Option

Expression

Example of Returned Value

About Me

#{webCenterProfile[securityContext.userName].description}

Returns the content of the About Me attribute of the current user's Profile

Username

#{webCenterProfile[securityContext.userName].userName}

The user name specified in the current user's Profile

Compare this with the current user's display name.

First Name

#{webCenterProfile[securityContext.userName].firstName}

The current user's first name

Middle Name

#{webCenterProfile[securityContext.userName].middleName}

The current user's middle name

Last Name

#{webCenterProfile[securityContext.userName].lastName}

The current user's last name

Initials used

#{webCenterProfile[securityContext.userName].initials}

The current user's initials

Display Name

#{webCenterProfile[securityContext.userName].displayName}

The current user's display name

Compare this with the current user's user name.

Email

#{webCenterProfile[securityContext.userName].businessEmail}

The current user's business email address

Department

#{webCenterProfile[securityContext.userName].department}

The current user's department

Job Title/Designation

#{webCenterProfile[securityContext.userName].title}

The current user's job title or designation

Manager

#{webCenterProfile[securityContext.userName].managerDisplayName}

The current user's manager's display name

Time zone

#{webCenterProfile[securityContext.userName].timeZone}

The time zone associated with the current user

Employee type

#{webCenterProfile[securityContext.userName].employeeType}

The current user's employee type

Employee Number

#{webCenterProfile[securityContext.userName].employeeNumber}

The current user's employee number

Preferred Language Code

#{webCenterProfile[securityContext.userName].preferredLanguage}

The current user's preferred language

Organization

#{webCenterProfile[securityContext.userName].organization}

The company organization to which the current user belongs

Organizational Unit

#{webCenterProfile[securityContext.userName].organizationalUnit}

The unit of the company organization to which the current user belongs

Expertise

#{webCenterProfile[securityContext.userName].expertise}

The current user's expertise, for example, Application, system, and database administration

Business Fax

#{webCenterProfile[securityContext.userName].businessFax}

The current user's business fax number

Business Mobile

#{webCenterProfile[securityContext.userName].businessMobile}

The current user's business mobile or cell phone number

Business Phone

#{webCenterProfile[securityContext.userName].businessPhone}

The current user's business phone number

Business Pager

#{webCenterProfile[securityContext.userName].businessPager}

The curren user's business pager number

Business Street

#{webCenterProfile[securityContext.userName].businessStreet}

The street address of the current user's business office

Business City

#{webCenterProfile[securityContext.userName].businessCity}

The city where the current user's business office is located

Business State

#{webCenterProfile[securityContext.userName].businessState}

The state where the current user's business office is located

Business PO Box

#{webCenterProfile[securityContext.userName].businessPOBox}

The current user's business Post Office Box number

Business Postal Code

#{webCenterProfile[securityContext.userName].businessPostalCode}

The postal or ZIP code of the current user's business office

Business Country

#{webCenterProfile[securityContext.userName].businessCountry}

The country where the current user's business office is located

Home Address

#{webCenterProfile[securityContext.userName].homeAddress}

The current user's home address

Home phone

#{webCenterProfile[securityContext.userName].homePhone}

The current user's home phone number

Date of Birth

#{webCenterProfile[securityContext.userName].dateofBirth}

The current user's date of birth

Maiden Name

#{webCenterProfile[securityContext.userName].maidenName}

The current user's maiden name

Date of hire

#{webCenterProfile[securityContext.userName].dateofHire}

The date the current user was hired by the company

Name Suffix

#{webCenterProfile[securityContext.userName].nameSuffix}

Titles or credentials appended to the current user's name, for example, MD, Esq, and the like

Wireless Account Number

#{webCenterProfile[securityContext.userName].wirelessAcctNumber}

The account number for the current user's wireless internet account

B.3.1.9 WebCenter Events Seeded ELs

WebCenter Events seeded EL expressions return values related to document-related events, such a selected document, the document's creator, the date the document was last modified, and so on. For example, the expression #{wcEventContext.events.WebCenterResourceSelected.name}, returns the name of the currently selected document.

Table B-9 lists the seeded EL expressions available under the category WebCenter Events and provides an example of the types of values each returns.

Table B-9 Seeded EL Expressions Under WebCenter Events

Option

Expression

Example of Returned Value

Selected User Name

#{wcEventContext.events.WebCenterUserSelected.UserName}

The user name of the currently selected user

Selected Document Name

#{wcEventContext.events.WebCenterResourceSelected.name}

The name of the currently selected document

Selected Document Creator

#{wcEventContext.events.WebCenterResourceSelected.createdBy}

The name of the user who created the currently selected document

Selected Document Last Modified

#{wcEventContext.events.WebCenterResourceSelected.lastModifiedBy}

The date the selected document was last modified

B.3.2 EL Expressions Relevant to the WebCenter Spaces Application

Table B-10 lists EL expressions relevant to WebCenter Spaces application information and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both).

Table B-10 EL Expressions Relevant to WebCenter Spaces Application Information

Expression

Function

Context

#{WCAppContext}

An oracle.webcenter.webcenterapp.context.WCApplicationContext object that provides an access point in the current web request for all WebCenter application-related information.

WCS

#{WCAppContext.currentWebCenterURI}

Returns a URL representing the current web request with bookmarkable WebCenter Spaces URL parameters of the request appended to the end (parameters are not necessarily in a fixed order).

Example:

http://name.us.oracle.com/webcenter/faces/oracle/webcenter/page/scopedMD/someguid/SomePage.jspx?
wc.contextURL=/spaces/somename&wc.pageScope=1234

WCS

#{WCAppContext.application.applicationConfig}

An oracle.webcenter.webcenterapp.beans.WebCenterType bean with a payload of metadata from the current WebCenter Spaces application.

WCS

#{WCAppContext.application.applicationConfig.title}

Returns the display name of the current WebCenter Spaces application (as configured through WebCenter Administration settings).

Out of the box, this returns WebCenter.

WCS

#{WCAppContext.application.applicationConfig.logo}

If an application logo was uploaded through WebCenter Administration settings, this expression returns the URL to the application logo image.

Out of the box, this returns null.

WCS

#{WCAppContext.application.applicationConfig.helpPage}

Returns the URL to the Help application used for the current WebCenter Spaces application (as configured through WebCenter Administration settings).

Out of the box, this returns /webcenterhelp/spaces.

WCS

#{WCAppContext.application.applicationConfig.copyrightMessage.customValue}

If a copyright message was configured through WebCenter Administration settings, this expression returns the application copyright message.

Out of the box, this returns null.

WCS

#{WCAppContext.application.applicationConfig.privacyPolicyUrl}

Returns the URL to the document that contains the application's privacy policy (as configured through WebCenter Administration settings).

Out of the box, this returns http://www.oracle.com/html/privacy.html

WCS

#{WCAppContext.application.applicationConfig.skin}

Returns the name of the default ADF Faces skin family to use for rendering pages in the application (as configured through WebCenter Administration settings).

This expression represents only the application-level setting that may not necessarily be used in all web requests. For example, you cannot use it successfully if a user has chosen to override the skin through application Preferences (for more information, see Chapter 35, "Setting Your Personal Preferences").

WCS

#{requestContext.skinFamily}

Returns the name of the ADF Faces skin family being used for the current web request, depending on factors such as what has been configured at the application level, the current user's preference setting, and so on.

Returns the same value as #{adfFacesContext.skinFamily}.

Both

B.3.3 EL Expressions Relevant to Application Security

Table B-11 lists EL expressions relevant to application security and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both).

See Also:

For example implementations of expressions related to component-level security, see Section 23.2, "Setting Access on a Page Component."

Table B-11 EL Expressions Relevant to Security

Expression

Function

Context

#{security.authenticated}

Returns true when the current user is authenticated in the context in which the EL is being invoked, otherwise false.

Both

#{securityContext.userName}

Returns the user name of the currently logged in user. If the current user is not logged in, this expression returns no value.

Both

#{security.pageContextCommunityModerator}

Returns the value true if the current user is a moderator of the current Space.

WCS

#{WCSecurityContext.userInScopedRole['role']}

Returns the value true if the current user is assigned the specified role in the current scope. Role can be Moderator, Participant, Viewer, or a custom role defined in that scope.

The scope is implicitly resolved to be the current scope. If you use this EL in the Home Space, it resolves to Home Space GUID and roles defined at the application level. If you use this EL in a Space scope, it resolves to roles defined for the Space.

WCS

#{WCSecurityContext.userInGroup['group']}

Returns the value true if the current user is assigned the specified group, for example, Administrators.

Both

#{WCSecurityContext.currentUser['userName']}

Returns the value true if the current user is the specified user.

Both

B.3.4 EL Expressions Relevant to Application Navigation

Table B-12 lists EL expressions relevant to WebCenter Spaces navigation and describes the types of functionality it provides. All navigation ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-12 EL Expressions Relevant to Navigation

Expression

Function

Navigation Context Expressions

#{navigationContext.defaultNavigationModel}

Returns default navigation model. It gets the value from the preference bean. The preference bean gets the value based on the preference setting in adf-config.xml, static value.

The following example returns the specified default tree model:

#{navigationContext.defaultNavigationModel.defaultTreeModel}

You can also use defaultMenuModel and defaultListModel (see next listing).

#{navigationContext.currentNavigationModel}

Returns the navigation model used to navigate to the current view (that is, the current page)

There may be a number of navigation models on the page. Only the one used to navigate to the page is the current navigation model.

The current navigation model is set only when the processAction is called.

The following example returns the default tree model for the current navigation model:

#{navigationContext.currentNavigationModel.defaultTreeModel}

You can also use defaultMenuModel and defaultListModel.

See Also: #{navigationContext.processAction}.

#{navigationContext.navigationModel['model_path']}

Returns the navigation model specified by path.

Example:

#{navigationContext.navigationModel['/oracle/webcenter/portalapp/navigations/default-navigation-model']}

User can simply enter the path in the square bracket without having to remember the parameter name. For backward compatibility, comma-separated parameters are also supported. Available parameters (with examples) are:

- modelPath=/oracle/webcenter/portalapp/navigations/default-navigation-model

- modelScope=/oracle/webcenter/portalapp/navigation

- modelId=default-navigation-model

Note: modelScope and modelId are used together, for example:

#{navigationContext.navigationModel['modelScope=/oracle/webcenter/portalapp/navigations,modelId=default-navigation-model']}

#{navigationContext.processAction}

Returns the default navigation method for binding to UI component's actionListener attribute. This assumes that the target resource to navigate to is passed in through the action UI component's node or path attribute.

The node attribute is typically used for the iterative case; while the path attribute is typically used to create a static link. If both are specified, the node attribute is used. Note that when using the path attribute, you must also specify the model attribute to pass in the navigation model object. If the model attribute is not specified, the current navigation model is used.

Example using the node attribute:

<af:forEach var="node" varStatus="vs"
items="#{navigationContext.defaultNavigationModel.rootNode.children}">
<af:subform id="pt_sfm1">
<af:commandLink id="pt_cl1"
text="#{node.title}"
inlineStyle="font-size:small;color:White;"
actionListener="#{navigationContext.processAction}"
action="pprnav">
<f:attribute name="node" value="#{node}"/>
<af:showPopupBehavior popupId="menuPopup"
align="afterStart"
triggerType="mouseOver"/>
</af:commandLink>

Example using the path attribute:

<af:commandLink id="pt_cl1" text="Prescriptions"
inlineStyle="font-size:small; color:White;"
actionListener="#{navigationContext.processAction}"
action="pprnav">
<f:attribute name="path" value="/prescriptions"/>
<f:attribute name="model"   value="#{navigationContext.defaultNavigationModel}"/>
</af:commandLink>

Navigation Model Expressions

#{navigationContext.defaultNavigationModel.defaultTreeModel}

#{navigationContext.defaultNavigationModel.defaultMenuModel}

#{navigationContext.defaultNavigationModel.defaultListModel}

#{navigationContext.defaultNavigationModel.defaultSiteMap}

Returns a tree/menu/list model based on the default settings

The default values for the settings are specified in the next row. For example, the default value for depth is 0.

For defaultSiteMap, it returns the XML for the sitemap of the navigation based on the default settings.

This expression returns a model of type:

- ChildPropertyTreeModel—used in <af:tree> component

- ChildPropertyMenuModel—used in <af:breadcrumbs> or <af:menu> component

- List<NavigationResource>—used in <af:foreach>

#{navigationContext.defaultNavigationModel.treeModel['parameters']}

#{navigationContext.defaultNavigationModel.menuModel['parameters']}

#{navigationContext.defaultNavigationModel.listModel['parameters']}

#{navigationContext.defaultNavigationModel.siteMap['parameters']}

Returns tree/menu/list model based on the specified comma-separated parameters. Available parameters (with default values as examples) are:

- startNode=/—specify the starting node of the model (do not need "/" prefix unless requesting the root node, for example, home).

- includeStartNode=true—specify true if you want to include the starting node (for example, the root node above) or false to start from its children.

- depth=0—defines the initial depth of fetching. "0" means fetch the entire tree, which may take a long time. In which case, use "1" to fetch on demand (when users click the Expand icon).

- prefetchOnly=false—by default (true), it returns nodes up to the depth level requested initially; deeper level nodes are returned on demand. Use false if you want only the initial sets of nodes. In which case, it does not return deeper nodes later on when requested, even when there are deeper nodes.

For siteMap, the available parameters are startNode and includeStartNode.

Example:

#{navigationContext.defaultNavigationModel.treeModel['startNode=home,includeStartNode=false,depth=2']}

#{navigationContext.defaultNavigationModel.rootNode}

Returns a root node (of type NavigationResource) of the navigation model.

Example:

<af:commandLink id="pt_cl1" text="Prescriptions"
inlineStyle="font-size:small; color:White;"
actionListener="#{navigationContext.processAction}"
action="pprnav">
<f:attribute name="node"
value="#{navigationContext.
defaultNavigationModel.
rootNode.children[2]"/>
</af:commandLink>

#{navigationContext.defaultNavigationModel.node['path']}

Returns a node (of type NavigationResource) based on the path specified (you do not need "/" prefix unless you are requesting the root node, for example, '/')

Example:

#{navigationContext.defaultNavigationModel.node['home/page1']}

#{navigationContext.defaultNavigationModel.currentSelection}

Returns currently selected navigation resource.

#{navigationContext.defaultNavigationModel.newCurrentSelection['path']}

Sets the current selection to a node specified by the given path (you do not need "/" prefix unless you are requesting the root node, for example, '/'). If successful, returns the newly selected node of type NavigationResource.

The user must have the ability to explicitly set the current selection without having to actually navigate to a node.

This can be used where the user enters a page directly, and no selection is set. It provides a mechanism for the user to control what is the default when there is no current selection.

Example:

<c:set  value="${navigationContext.defaultNavigationModel.newCurrentSelection['home/page1']}"
var="currSel" scope="session"/>
<c:if test="${currSel!=null}">
<af:forEach items="#{currSel.children}"
var="cnode" varStatus="cnodestatus">
...</c:if>

#{navigationContext.defaultNavigationModel.attributes.Description}

#{navigationContext.defaultNavigationModel.attributes['Description']}

Returns the value of the specified attribute of the navigation model.

Navigation Resource Expressions

#{node.attributes.Description}

#{node.attributes['Description']}

Returns the value of the specified attribute of the navigation resource.

#{node.parameters.StockSymbol}

#{node.parameters['StockSymbol']}

Returns the value of the specified parameter of the navigation resource.

#{node.parametersRaw.StockSymbol}

#{node.parametersRaw['StockSymbol']}

Returns the raw value of the specified parameter of the navigation resource (before it is evaluated).

#{node.title}

Returns the title of the navigation resource.

#{node.path}

Returns the path to the navigation resource.

#{node.externalURL}

Returns the URL for the navigation resource of type External Link.

#{node.prettyUrl}

Returns the identifying path for this navigation resource.

#{node.prettyUrlPath}

#{node.prettyUrlPath[N]}

Returns a collection of identifying paths by depth to enable its use as a starting path to drive another navigation view.

For example, assuming the currentSelection is home/company/products/applications, the following EL returns home/company/products:

#{node.prettyUrlPath[3]}

#{node.goLinkPretty Url}

Returns the identifying path for this navigation resource suitable for goLink destination

<af:goLink id="pt_gl2" text="#{node.title}"
destination="#{node.goLinkPrettyUrl}"
targetFrame="#{node.attributes['Target']}"
inlineStyle="font-size:small;#{node.selected ?
'font-weight:bold;' : ''}"/>

#{node.separator ? ... : ...}

Returns whether this resource is a separator item.

#{node.navigable ? ... : ...}

Returns whether it is possible to navigate to this resource.

#{node.selected ? ... : ...}

Returns whether this resource is currently selected.

#{node.currentlySelected ? ... : ...}

Returns whether the resource is the currently selected resource and the model is the currently selected model.

#{node.onSelectedPath ? ... : ...}

Returns whether this node lies on the selected path. This is useful for highlighting the selected tab, for example.

For example, assuming the currently selected node is home/company/products/applications, the following EL highlights the home tab.

<c:set  value="${navigationContext.defaultNavigationModel.node['home']}"
var="home" scope="session"/>
<af:commandImageLink id="cil1"
icon="#{(home.onSelectedPath) ?
'/images/caremark/nav/HomeSelected.png' :
'/images/caremark/nav/HomeIcon.png'}"
actionListener="#{navigationContext.processAction}"
action="pprnav">
<f:attribute name="node" value="#{home}"/></af:commandImageLink>

#{node.leaf ? ... : ...}

Returns whether this resource is a leaf node.

#{node.parent}

Returns the parent node (of type NavigationResource) of this node. For the root node, null is returned.

#{node.ancestors}

Returns the hierarchy list of ancestors of this node (of type NavigationResource) starting with the root node.

For example, assuming the current node is home/company/products/applications, the following ELs return the following values:

- #{node.ancestors[1]} returns the node for home

- #{node.ancestors[3]} returns the node for home/company/products

#{node.depth}

Returns the depth of this node from the root node. Root node has a depth of zero.

#{node.siblings}

Returns the list of siblings (of type NavigationResource) of this node (inclusive).

#{node.nextSibling}

Returns the next sibling in the list (of type NavigationResource) of this node.

For example, the following code ensures that you do not output two separators in a row:

<c:if test="${(node.separator) && (!node.nextSibling.separator}">
<af:separator id="s166"/>
</c:if>

#{node.previousSibling}

Returns the previous sibling in the list (of type NavigationResource) of this node.

#{node.index}

Returns the zero-relative index of this node relative to its siblings.

#{node.children}

#{node.children[N].title}

#{node.children[N].children[N].title}

Returns a collection of child resources.

#{node.childCount}

Returns the number of children of this node.

#{node.childByIndex['index']}

Returns the child node (of type NavigationResource) specified by the zero-relative index

If not found, this returns null.

#{node.childByPath['admin']}

Returns the child node (of type NavigationResource) specified by the path relative to this node

The path can be deeper than one level and does not need the '/' prefix. If not found, this returns null.

B.3.5 EL Expressions Relevant to Resources

Use the expressions in this section to query for resources. Querying for a resource through an EL expression is similar to querying for it through an API call. That is, you must set query parameters in the format .property['value'], where property is the name of the property, for example, id, resourceScope, and the like, and value is the search value for the attribute.

A query can result in single or multiple results. The query designer must decide what is wanted. The query designer determines whether to return one or multiple results by encountering one of the following values in the expression:

- singleResult—Returns a single resource. When no matching resource is found, null is returned.

- resultList—Returns a list of resources. When no matching resources are found, an empty list is returned.

Note:

Occurrences of singleResult or resultList in the expression are used internally as the query end point, and, after this, the query is executed immediately. Anything set after the end point can result in unexpected behavior.

The following example returns the first template resource found with a display name that contains myPage:

#{srmContext.resourceType['siteTemplate'].displayName['myPage'].singleResult}

The following example returns a list of template resources residing in the directory resourceDir, with a description that contains sampleDesc:

#{srmContext.resourceType['siteTemplate'].description['sampleDesc'].contentDirectory['resourceDir'].resultList}

A property of this class includes any attribute of this class. Example properties include: Id, DisplayName, iconURI, contentDirectory, and the like.

The property value can be an explicit value or an EL expression that returns that type of value. For example, the following two queries return the same result:

#{srmContext.id['resourceId'].singleResult}

#{srmContext.id['spacesContext.currentSpace.uiMetadata.siteTemplateId'].singleResult}

You can use any property of this class in an EL-based query in the format property['value'] and in any order. For example, the following two queries return the same result:

#{srmContext.resourceScope['scopeName'].id['resourceId'].singleResult}

#{srmContext.id['resourceId'].resourceScope['scopeName'].singleResult}

Table B-13 lists EL expressions relevant to WebCenter resources and describes the types of functionality each provides. You can use all resource EL expressions in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-13 ELs Relevant to WebCenter Site Resources

EL

Function

#{srmContext.id['resourceGUID']}

Returns the resource with the specified ID

#{srmContext.displayName['resourceDisplayName']}

Returns any resources with the specified display name

#{srmContext.displayNameKey['displayNameKey']}

Returns any resources with the specified display name key

#{srmContext.description['resourceDescription'].singleResult}

Returns one result of a resource that contains the specified value in its description

To get multiple results, use resultList in lieu of singleResult.

#{srmContext.descriptionKey[descriptionKey].singleResult}

Returns one result of a resource with the specified description key

The description key is the key in the xsrt file for the resource description.

To get multiple results, use resultList in lieu of singleResult.

#{srmContext.createdDate['resourceCreationDate']}

Returns any resource with the specified creation date

#{srmContext.modifiedBy['resourceLastModifiedBy']}

Returns any resource that was last modified bythe user with the specified user name

#{srmContext.modifiedDate['resourceLastModifiedDate']}

Returns any resource that was last modified by the specified date

#{srmContext.resourceScope['resourceScope']}

Returns any resource that falls within the specified scope

#{srmContext.category['categoryName']}

Returns any resource that falls within the specified category

For example:

#{srmContext.category['siteTemplates']}

#{srmContext.contentDirectory['contentDirectory']}

Returns any resource that is stored within the specified directory

#{srmContext.metadataFile['metadataFileLocation']}

Returns resource metadata from the specified metadata file

For example, the following expression returns resource metadata from the following file /home/metadata/data.xml:

#{srmContext.metadataFile['/home/metadat/data.xml']}

#{srmContext.jspx['jspxFileLocation']}

Returns any jspx file in the specified location

For example, the following expression returns the page.jspx file:

#{srmContext.jspx['/home/web/page.jspx']}

#{srmContext.pageDef['pageDefinition']}

Returns any jspx file with the specified page definition

#{srmContext.iconURI['iconURI']}

Returns the icon at the specified icon URI

#{srmContext.excludeFrom['excludeFromScopes']}

In a larger expression, returns all specified resources except those available in the excluded scopes

#{srmContext.usesCustomSecurity['usesCustomSecurity']}

In a larger expression, returns any resource the either does or does not use custom security

Set usesCustomSecurity to TRUE or FALSE. For example:

#{srmContext.usesCustomSecurity['TRUE']}

#{srmContext.seeded['seeded']}

In a larger expression, returns any resource that is or is not seeded, depending on the provided value

Set seeded to TRUE or FALSE. For example:

#{srmContext.seeded['TRUE']}

#{srmContext.visibleType['visibleType']}

In a larger expression, returns any resource that is of the specified type of visibility

Set visibleType to TRUE, FALSE, or NEVER to indicate that the resource is never shown. For example, the following expression returns resources that are visible, that is, resources that are set to Show:

#{srmContext.visibleType['TRUE']}

#{srmContext.visible['visible']}

In a larger expression, returns one or multiple resources with visibility set to either TRUE or FALSE

#{srmContext.createdBy['resourceCreator']}

In a larger expression, returns any resource created by the specified user

#{srmContext.resourceType['resourceType']}

In a larger expression, returns one or multiple resources of the specified type

For example, the following expression searches for a resource of the type SITE_TEMPLATE:

#{srmContext.resourceType['SITE_TEMPLATE']}

Note that all resource types are listed in Oracle Fusion Middleware Java API Reference for Oracle WebCenter, in the GenericSiteResourceTypes class.

#{srmContext.version['version']}

In a larger expression, returns one or multiple resources available in the application of the specified version

#{srmContext.resourceScope['scopeName']}

In a larger expression, returns one or multiple resources available in the specified scope

For example, the following expression searches for resources in the scope (in this instance, the Space) MySpace:

#{srmContext.resourceScope['MySpace']}

To search in the default scope, that is, the application scope, use defaultScope.

#{srmContext.searchType['searchType']}

In a larger expression, returns one or multiple resources that contain or equal the values set by other included expressions

Set searchType to CONTAINS or EQUALS.

B.3.6 EL Expressions Relevant to Specific Spaces

Table B-14 lists EL expressions relevant to Spaces and describes the types of functionality each provides. All of the listed ELs are for use in WebCenter Spaces.

Note:

The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name. Many of the EL expressions in Table B-14 call for the Space internal name.

Table B-14 EL Expressions Relevant to WebCenter Spaces Spaces

Expression

Function

#{spaceContext}

An oracle.webcenter.spaces.context.SpacesContext object that provides an access point in the current web request for all Space-related information.

The value of this expression is whatever is returned on invoking the java API: SpacesContext.getCurrentInstance()

#{spaceContext.currentSpace}

An oracle.webcenter.spaces.Space object that represents the Space associated with the current web request. If the current web request is in the Home Space context, it returns a value of null.

The value of this expression is whatever is returned on invoking the Java API: SpacesContext.getCurrentInstance().getCurrentSpace()

#{spaceContext.currentSpaceName}

The name of the Space associated with the current web request. If the current web request is in a Home Space context, it returns a value of null.

The value of this expression is whatever is returned on invoking the java API: SpacesContext.getCurrentInstance().getCurrentSpace()

#{spaceContext.space['spaceName']}

#{spaceContext.currentSpace}

An oracle.webcenter.spaces.Space object that represents the Space that is named spaceName or the current Space (currentSpace). For example, #{spaceContext.space['FinanceProject']} returns the Space object for the Space called FinanceProject.

The value of this expression is whatever is returned in Java on invoking .getSpace(...) on the current SpacesManager passing in the MDSSession of the current ADFContext.

#{spaceContext.space['spaceName'].metadataPath}

#{spaceContext.currentSpace.metadataPath}

The MDS path of the space metadata document for the Space with specified name spaceName or the current Space (currentSpace). For example, #{spaceContext.space['FinanceProject'].metadataPath} evaluates to /oracle/webcenter/space/metadata/spaces/FinanceProject/space.xml

The value of this expression is whatever is returned in java on invoking .getMetadataPath() on the space object for the Space.

#{spaceContext.space['spaceName'].metadata}

#{spaceContext.currentSpace.metadata}

An oracle.webcenter.spaces.beans.SpaceType bean that carries metadata about the Space that is named spaceName or the current Space (currentSpace).

The value of this expression is whatever is returned in java on invoking .getMetadata() on the space object for the Space passing in the MDSSession of the current ADFContext.

#{spaceContext.space['spaceName'].metadata.displayName}

#{spaceContext.currentSpace.metadata.displayName}

The display name of the Space that is named spaceName or the current Space (currentSpace). For example, if a Space called Web20Space has the display name web 2.0 Space, then #{spaceContext.space['Web20Space'].metadata.displayName} evaluates to web 2.0 Space.

#{WCAppContext.spacesResourcesPath}#{spaceContext.space['spaceName'].metadata.icon}

#{WCAppContext.spacesResourcesPath}#{spaceContext.currentSpace.metadata.icon}

A URL to the icon associated with the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.description}

#{spaceContext.currentSpace.metadata.description}

The description of the Space that is named spaceName or the current Space (currentSpace). For example, #{spaceContext.space['FinanceProject'].metadata.description} evaluates to Conglomeration of all teams involved in financial activities.

#{spaceContext.space['spaceName'].metadata.creationDate}

#{spaceContext.currentSpace.metadata.creationDate}

A java.util.Calendar object representing the date-time on which the Space with specified name spaceName or the current Space (currentSpace) was created.

#{spaceContext.space['spaceName'].metadata.createdBy}

#{spaceContext.currentSpace.metadata.createdBy}

The user-name of the person who created the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.keywords}

#{spaceContext.currentSpace.metadata.keywords}

A comma-delimited list of searchable keywords associated with the Space with the name spaceName or the current Space (currentSpace). For example, if the Space FinanceProject has the keywords finance, project, money, then #{spaceContext.space['FinanceProject'].metadata.keywords} evaluates to finance, project, money.

#{spaceContext.space['spaceName'].metadata.offline}

#{spaceContext.currentSpace.metadata.offline}

Boolean value that indicates whether the Space that is named spaceName or the current Space (currentSpace) is offline.

#{spaceContext.space['spaceName'].metadata.closed}

#{spaceContext.currentSpace.metadata.closed}

Boolean value that indicates whether the Space that is named spaceName or the current Space (currentSpace) is closed.

#{spaceContext.space['spaceName'].metadata.selfRegistration}

#{spaceContext.currentSpace.metadata.selfRegistration}

Boolean value that indicates whether users are allowed to register themselves with the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.discoverable}

#{spaceContext.currentSpace.metadata.discoverable}

Boolean value that indicates whether users can discover the existence of the Space that is named spaceName or the current Space (currentSpace) by searching for it or seeing it listed on the My Spaces page.

#{spaceContext.space['spaceName'].metadata.publishRSS}

#{spaceContext.currentSpace.metadata.publishRSS}

Boolean value indicating whether the Space that is named spaceName or the current Space (currentSpace) publishes RSS feeds.

#{spaceContext.space['spaceName'].distributionList}

#{spaceContext.currentSpace.distributionList}

The email address of the mailing list associated with the Space that is named spaceName or the current Space (currentSpace).

#{spaceContext.space['spaceName'].metadata.customAttributes['attributeName']}

#{spaceContext.currentSpace.metadata.customAttributes['attributeName']}

The value of a specific custom attribute of the name attributeName for the Space that is named spaceName or the current Space (currentSpace). For example, if the FinanceProject Space has a custom attribute called stockPrice with a value of 13.9, then #{spaceContext.space['FinanceProject'].metadata.customAttributes['stockPrice']} evaluates to 13.9.

#{WCAppContext.spacesResourcesPath}#{spaceContext.space['spaceName'].metadata.logo}

#{WCAppContext.spacesResourcesPath}#{spaceContext.currentSpace.metadata.logo}

Returns the logo URL for the Space named spaceName or the current Space (currentSpace).

#{spaceContext.spacesQuery.property['value']}

#{spaceContext.spacesQuery.property['value'].listSpaces}

A means of querying a Space using a query parameter in the form of property['value'], where property means the name of the property, for example, unionOf, shape, and the like; and value means the criteria to use in fetching the list of all Spaces, discoverable Spaces, and the like.

If listSpaces is appended to the expression, the query returns the list of Spaces of type GSMetadata. (For more information, see Interface GSMetadata in Oracle Fusion Middleware Java API Reference for Oracle WebCenter.)

For example, the following EL expression returns a list of all discoverable Spaces.

#{spaceContext.spacesQuery.unionOf['DISCOVERABLE'].listSpaces}

If listSpaces is not appended to the EL, then the EL evaluates to an object of type SpacesQueryParameter. This object type must be evaluated using SpacesManager.getSpaces(SpacesQueryParameters), which in turn returns a list of spaces of type GSMetadata.

For example, the following EL expression returns an instance of type SpacesQueryParameters with all the query conditions populated.

#{spaceContext.spacesQuery.unionOf['DISCOVERABLE']}

#{spaceContext.spacesQuery.unionOf['USER_JOINED'].shape['ROOT_LEVEL'].listSpaces}

Returns a list of all top-level Spaces of which the current user is a member

This EL returns only those Spaces that do not have a parent, that is, it does not return Subspaces.

#{spaceContext.spacesQuery.unionOf['USER_JOINED'].shape['RECURSIVE_FLATTENED'].listSpaces}

Returns a list of all Spaces of which the current user is a member

This EL also returns all the Subspaces under each of the parent Spaces to which the current user has access.

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].sortCriteria[sortBy fields picked from WcSpaceHeader]}

Returns Spaces sorted into the order specified by the sort criteria

For example, the following query returns a list of Spaces to which the user has access sorted by discoverable and lastUpdateDate fields.

Note that in the following example, the idenitifier sp represents the JPA entity for a space, WcSpaceHeader.

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].sortCriteria['sp.discoverable, sp.lastUpdateDate desc'].listSpaces}

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].pageNumber[page_num].listSpaces}

Allows specifying the page number (0-based) to select from the results matching the query criteria

For example, the following expression returns a list of all Spaces to whichc a user has access and returns the third page of the result set:

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].pageNumber[2].listSpaces]}

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].itemsPerPage[page_num].listSpaces}

Allows specifying the number of results to be included in each page when breaking down the result space into pages

For example, the following expression returns a list of all Spaces to which a user has access, listing 10 records per page.

#{spaceContext.spacesQuery.unionOf['ALL_QUERIABLE'].pageNumber[10].listSpaces]}

B.3.7 EL Expressions Relevant to Specific Pages

Table B-15 lists EL expressions relevant to application pages and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both). These expressions are useful in WebCenter Spaces and in custom WebCenter applications that include the Page service.

Table B-15 EL Expressions Relevant to Application Pages

Expression

Function

#{pageDocBean.title}

Returns the page display name, for example:

FinanceProject

#{pageDocBean.createdBy}

Returns the user name of the person who created the page, for example:

monty

#{pageDocBean.createDateString}

Returns the date and time the page was created, for example:

2008-11-19T10:18:36

#{pageDocBean.lastUpdatedBy}

Returns the user name of the person who last updated the page, for example:

monty

#{pageDocBean.lastUpdateDateString}

Returns the date and time the page was last updated, for example:

2008-11-19T10:18:36

#{pageDocBean.pagePath}

Returns the file directory path to the page relative to the application root directory, for example:

/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/user/Umonty/Page4.jspx

#{pageDocBean.name}

Returns the file name of the page, for example:

Page4.jspx

#{pageDocBean.UICSSStyle}

Returns the name of the style scheme used on the page, for example:

WCSchemeEggShell

#{pageDocBean.UISchemeBGImage}

Returns the directory path and file name of the page scheme background image.

#{pageDocBean.UISchemeBGColorString}

Returns the hexadecimal value of the page scheme background color, for example:

#ffa500

#{pageDocBean.pagePermission}

Returns the permission the current user has on the page, for example:

oracle.webcenter.page.model.security.CustomPagePermission

#{pageDocBean.pageSecurityTarget}

A string of 60 or so characters that uniquely identifies the current page to the security system, for example:

oracle_webcenter_page_scopedMD_s8bba98ff_4cbb_40b8_beee_296c916a23ed_user_Umonty_Page4PageDef

B.3.8 EL Expressions Relevant to Oracle Composer

Table B-16 lists EL expressions relevant to Oracle Composer. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both). These expressions are useful in WebCenter Spaces and in custom WebCenter applications that include Oracle Composer.

Table B-16 EL Expressions Relevant to Oracle Composer

Expression

Function

Context

#{composerContext.inEditMode}

Determines whether the current page is in View mode or Edit mode, for example:

<af:outputText id="ot1"
value="#{composerContext.inEditMode ne
true ? 'View mode' : 'Edit mode'} />

This example shows an ADF Faces outputText component that returns View mode when the page is in View mode and Edit mode when the page is in Edit mode.

Both

B.3.9 EL Expressions Relevant to Event Contexts

Table B-17 lists EL expressions relevant to the types of events that can trigger the passing of payloads (rather than events relevant to the Events service).

You can access all or part of the event payloads provided in Table B-17 once they have been raised.

For example, for the whole payload, use the following EL:

#{wcEventContext.events.<eventName>}

For example:

#{wcEventContext.events.WebCenterUserSelected}

All of the payloads for the ELs in Table B-17 are Maps. To dereference a map entry, use the standard EL for Maps:

#{wcEventContext.events.WebCenterUserSelected.UserName}

See Also:

For more information about event wiring, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Table B-17 EL Expressions Relevant to Event Contexts

Expression

Function

Event Context

#{wcEventContext.events.WebCenterResourceSelected}

Document Name

#{wcEventContext.events.WebCenterResourceSelected.name}

Document Creator

#{wcEventContext.events.WebCenterResourceSelected.createdBy}

Document Last Modified By

#{wcEventContext.events.WebCenterResourceSelected.lastModifiedBy}

Use in context wiring between producer and consumer task flows. Returns a map that relates some piece of metadata from the producer to some piece of metadata from the consumer, for example, from a document creator to the creator's Profile.

Producer task flows include:

- Document Manager

- Recent Documents

- Document List Viewer

Consumer task flows include:

- Activity Graph - Similar Items (show other documents that may be of interest to the user)

- Links (showthe items that are linked to the selected document)

- Profile (view the Profile of the document's author)

- Activity Stream (view activities related to this document)

- Tags (tags on this document and a means of accessing the Tag Center)

Event Context

#{wcEventContext.events.WebCenterUserSelected}

User Name

#{wcEventContext.events.WebCenterUserSelected.userName}

User GUID

#{wcEventContext.events.WebCenterUserSelected.userGUID}

Space Name

#{wcEventContext.events.WebCenterUserSelected.spaceName}

Space GUID

#{wcEventContext.events.WebCenterUserSelected.spaceGUID}

Use in context wiring between producer and consumer task flows. Returns a map that relates some piece of metadata from the producer to some piece of metadata from the consumer, for example, from a user to the user's connections.

Producer task flows include:

- Connections

- Space Members

Consumer task flows include:

- Connections (show connections of the selected user)

- Documents task flows (show documents created by the selected user)

- Activity Stream (view this user's activities)

- Tags (tags created by this user)

- Profile (show this user's Profile)

Event Context

#{wcEventContext.events.WebCenterConnectionSelected}

Profile User Name

#{wcEventContext.events.WebCenterConnectionSelected.profileUserName}

Profile User GUID

#{wcEventContext.events.WebCenterConnectionSelected.profileUserGUID}

Connected User Name

#{wcEventContext.events.WebCenterConnectionSelected.userName}

Connected User GUID

#{wcEventContext.events.WebCenterConnectionSelected.userGUID}

--

#{wcEventContext.events.WebCenterSpaceSelected.SpaceName}

Returns the name of the selected Space

#{wcEventContext.events.WebCenterSpaceSelected.SpaceGUID}

Returns the GUID of the selected Space

B.3.10 EL Expressions Relevant to Services

Table B-18 lists EL expressions relevant to services and describes the types of functionality it provides. All listed ELs can be used in both WebCenter Spaces and WebCenter Framework.

Table B-18 EL Expressions Relevant to Services

Expression

Function

#{webcenterService['serviceId']}

An oracle.webcenter.framework.service.Service object representing the WebCenter service with the service ID serviceId. For example, the following EL returns Documents Service.

#{webcenterService['oracle.webcenter.doclib']}

For service IDs, see Table B-19.

#{webcenterService['serviceId'].configured}

Returns a Boolean value that indicates whether the WebCenter service with the service ID serviceId is configured for use in the current WebCenter Spaces application. For example, the following EL returns true if Discussions service can be used in the application, false otherwise:

#{webcenterService['oracle.webcenter.collab.forum'].configured}

For service IDs, see Table B-19.

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['spaceName'].forumId}

Returns the forum ID of the specified Space discussion forum. Enter the Space name in lieu of spaceName.

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['spaceName'].categoryId}

Returns the category ID of the specified Space discussion forums. Enter the Space name in lieu of spaceName.

Table B-19 lists service IDs associated with services at runtime.

Table B-19 Service IDs

Service

ID

Announcements

oracle.webcenter.collab.announcement

Discussions

oracle.webcenter.collab.forum

Documents and Wikis

oracle.webcenter.doclib

Events

oracle.webcenter.collab.calendar.community

Space Management

oracle.webcenter.community

Instant Messaging and Presence (IMP)

oracle.webcenter.collab.rtc

Links

oracle.webcenter.relationship

Lists

oracle.webcenter.list

Mail

oracle.webcenter.collab.mail

Notes

oracle.webcenter.note

Notifications

oracle.webcenter.notification

Page

oracle.webcenter.page

People Connections: Activity Stream

oracle.webcenter.activitystreaming

People Connections: Connections

oracle.webcenter.peopleconnections.connections

People Connections: Feedback

oracle.webcenter.peopleconnections.kudos

People Connections: Message Board

oracle.webcenter.peopleconnections.wall

People Connections: Profile

oracle.webcenter.peopleconnections.profile

Polls

oracle.webcenter.collab.survey

Recent Activities

oracle.webcenter.recentactivity

Activity Graph

oracle.webcenter.activitygraph

RSS

oracle.webcenter.rss

Search

oracle.webcenter.search

Tags

oracle.webcenter.tagging

Blogs

oracle.webcenter.blog

Worklist

oracle.webcenter.worklist

B.3.11 EL Expressions Relevant to the Personalization Conductor

Table B-20 lists EL expressions relevant to the Personalization Conductor and describes the types of functionality it provides. All listed ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-20 EL Expressions Relevant to the Personalization Conductor

Expression

Function

#{p13nContext.reset}

Clears the state of the context object in which it is invoked.

Other examples:

#{p13nContext.conductor['ConductorConnection'].reset}

#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].reset}

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].reset}

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].update}

Updates the property set with new values if bound to a form.

The update method applies only to the context PropertySetContext, and can be called onlyas part of a form-based action.

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].results}

Retrieves the results of the context object. In the case of PropertySetContext, it retrieves the property set by name and property set definition, if they exist.

In the case of ScenarioExecutionContext and ParameterizedScenarioExecutionContext, the scenario results are retrieved.

Other examples:

#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].scenario['MyScenario'].results}

#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].scenario['MyScenario'].withInput['input1=val1;input2=value2;input3=value3'].results}

#{p13nContext.conductor['PropertiesConnection'].namespaces['MyNamespace'].scenario['MyScenario'].results}

Executes a scenario by name.

#{p13nContext.conductor['ConductorConnection'].namespaces['MyNamespace'].scenario['MyScenario'].withInput['input1=val1;input2=value2;input3=value3'].results}

Executes a scenario by name with input parameters. Input parameters must be in the following format:

<paramOne>=<valueOne>;<paramTwo>=<valueTwo>;<paramThree>=<valueThree>

Where each parameter name and value is separated by semicolon.

The withInput method applies only to the context ScenarioExecutionContext.

#{p13nContext.conductor['ConductorConnection'].namespaces[myManagedBean.namespace].scenario[myManagedBean.scenario].isError}

Determines if an error has occurred in the current context object.

The isError method applies only to PropertySetContext and ~ScenarioExecutionContext.

Other examples:

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].isError}

#{p13nContext.conductor['ConductorConnection'].namespaces['myManagedBean.namespace'].scenario['myManagedBean.scenario'].errorMessage}

Returns the error message if an error has occurred in the current context object.

The errorMessage method applies only to PropertySetContext and ~ScenarioExecutionContext.

Other examples:

#{p13nContext.properties['PropertiesConnection'].namespaces['MyNamespace'].setDefinitions['MyPropertySetDefinition'].set['MyPropertySet'].errorMessage}

B.3.12 EL Expressions Relevant to the Documents Service

Table B-21 lists EL expressions relevant to the Documents service and describes the types of functionality it provides. The Context column indicates whether the expression can be used in a WebCenter Spaces context (WCS) or in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper (Both).

Table B-21 EL Expressions Relevant to the Documents Service

Expression

Function

Context

#{documentsService.currentGroupSpace}

Provides information on the Space's documents. Returns a bean that provides access to documents-related information for the Space.

WCS

#{documentsService.currentUser}

Provides information about the current user's documents.

WCS

#{documentsService.defaultConnectionName}

Gets the default content repository connection name. Returns null if no connection name is defined.

Both

#{documentsService.groupSpaceByGUID['GUID']}

Provides a way to look up a given Space's documents information by the Space's GUID. Returns a bean that provides documents-related information for the Space.

WCS

#{documentsService.groupSpaceByName['spaceName']}

Provides a way to look up a given Space's documents information by the Space's name. Returns a bean that provides access to documents-related information for the Space.

Enter the Space internal name. The Space internal name is the name specified by the Space URL on the General page of a Space's administration settings. The Space display name is specified by Display Name, and is the name that appears in the banner at the top of a Space. Many of the EL expressions in Table B-14 call for the Space internal name.

WCS

#{documentsService.userByName['userName']}

Provides a way to look up user documents information by user name. Returns a bean that provides access to documents-related information for the user.

WCS

#{documentsService.configured}

Checks whether the Documents service is configured. Returns true if the Documents service is configured, otherwise false.

Both

B.3.13 EL Expressions Relevant to the People Connections Service

Table B-22 lists EL expressions relevant to the Profile feature of the People Connections service and describes the types of functionality it provides. All listed ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Note:

The entry securityContext.userName, included in every Profile expression, returns the name of the current user. Note also that information is returned only if it is present in the user's profile. If the information is not included in the profile, a null value is returned.

Table B-22 EL Expressions Relevant to the People Connections Service (Profile)

Expression

Function

#{WebCenterProfile[userName].ManagerDisplayName}

#{WebCenterProfile[securityContext.userName].ManagerDisplayName}

The display name of the specified user's manager if the current user is allowed to know it.

#{WebCenterProfile[userName].employeeNumber}

#{WebCenterProfile[securityContext.userName].employeeNumber}

The specified user's employee number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPOBox}

#{WebCenterProfile[securityContext.userName].businessPOBox}

The post office box number associated with the specified user if the current user is allowed to know it.

#{WebCenterProfile[userName].timeZone}

#{WebCenterProfile[securityContext.userName].timeZone}

The time zone in which the specified user's home office is located if the current user is allowed to know it.

#{WebCenterProfile[userName].description}

#{WebCenterProfile[securityContext.userName].description}

A description of the specified user (from Profile "About Me") if the current user is allowed to know it.

#{WebCenterProfile[userName].department}

#{WebCenterProfile[securityContext.userName].department}

The department to which the specified user belongs if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPager}

#{WebCenterProfile[securityContext.userName].businessPager}

The specified user's business pager number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessCity}

#{WebCenterProfile[securityContext.userName].businessCity}

The city in which the specified user is located if the current user is allowed to know it.

#{WebCenterProfile[userName].maidenName}

#{WebCenterProfile[securityContext.userName].maidenName}

The specified user's surname or last name before marriage if the current user is allowed to know it.

#{WebCenterProfile[userName].businessFax}

#{WebCenterProfile[securityContext.userName].businessFax}

The specified user's business fax number if the current user is allowed to know it.

#{WebCenterProfile[userName].dateofHire}

#{WebCenterProfile[securityContext.userName].dateofHire}

The specified user's date of hire if the current user is allowed to know it.

#{WebCenterProfile[userName].nameSuffix}

#{WebCenterProfile[securityContext.userName].nameSuffix}

Additional information appended to the user's name, such as Esq., Jr., and so on if the current user is allowed to know it.

#{WebCenterProfile[userName].middleName}

#{WebCenterProfile[securityContext.userName].middleName}

The specified user's middle name if the current user is allowed to know it.

#{WebCenterProfile[userName].homePhone}

#{WebCenterProfile[securityContext.userName].homePhone}

The specified user's home phone number if the current user is allowed to know it.

#{WebCenterProfile[userName].employeeType}

#{WebCenterProfile[securityContext.userName].employeeType}

The specified user's employee type classification, for example, IC4 if the current user is allowed to know it.

#{WebCenterProfile[userName].lastName}

#{WebCenterProfile[securityContext.userName].lastName}

The specified user's surname or last name if the current user is allowed to know it.

#{WebCenterProfile[userName].dateofBirth}

#{WebCenterProfile[securityContext.userName].dateofBirth}

The specified user's birthday if the current user is allowed to know it.

#{WebCenterProfile[userName].businessState}

#{WebCenterProfile[securityContext.userName].businessState}

The state in which the specified user's home office is located if the current user is allowed to know it.

#{WebCenterProfile[userName].homeAddress}

#{WebCenterProfile[securityContext.userName].homeAddress}

The specified user's home street address if the current user is allowed to know it.

#{WebCenterProfile[userName].businessStreet}

#{WebCenterProfile[securityContext.userName].businessStreet}

The street on which the specified user's home office is located if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPostalCode}

#{WebCenterProfile[securityContext.userName].businessPostalCode}

The specified user's postal or ZIP code if the current user is allowed to know it.

#{WebCenterProfile[userName].initials}

#{WebCenterProfile[securityContext.userName].initials}

The specified user's initials if the current user is allowed to know it.

#{WebCenterProfile[userName].firstName}

#{WebCenterProfile[securityContext.userName].firstName}

The specified user's first name if the current user is allowed to know it.

#{WebCenterProfile[userName].organizationalUnit}

#{WebCenterProfile[securityContext.userName].organizationalUnit}

The organizational unit to which the specified user belongs, for example, D10, if the current user is allowed to know it.

#{WebCenterProfile[userName].wirelessAcctNumber}

#{WebCenterProfile[securityContext.userName].wirelessAcctNumber}

The specified user's wireless account number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessPhone}

#{WebCenterProfile[securityContext.userName].businessPhone}

The specified user's business telephone number if the current user is allowed to know it.

#{WebCenterProfile[userName].businessCountry}

#{WebCenterProfile[securityContext.userName].businessCountry}

The country in to which the specified user is assigned if the current user is allowed to know it.

#{WebCenterProfile[userName].preferredLanguage}

#{WebCenterProfile[securityContext.userName].preferredLanguage}

The specified user's preferred language if the current user is allowed to know it.

#{WebCenterProfile[userName].displayName}

#{WebCenterProfile[securityContext.userName].displayName}

The specified user's display name if the current user is allowed to know it.

#{WebCenterProfile[userName].userName}

#{WebCenterProfile[securityContext.userName].userName}

The specified user's actual name if the current user is allowed to know it.

#{WebCenterProfile[userName].title}

#{WebCenterProfile[securityContext.userName].title}

The specified user's job title if the current user is allowed to know it.

#{WebCenterProfile[userName].businessEmail}

#{WebCenterProfile[securityContext.userName].businessEmail}

The specified user's business email address if the current user is allowed to know it.

#{WebCenterProfile[userName].organization}

#{WebCenterProfile[securityContext.userName].organization}

The organzation to which the specified user belongs, for example, Sales, if the current user is allowed to know it.

#{WebCenterProfile[userName].businessMobile}

#{WebCenterProfile[securityContext.userName].businessMobile}

The specified user's cell or mobile phone number if the current user is allowed to know it.

#{WebCenterProfile[userName].expertise}

#{WebCenterProfile[securityContext.userName].expertise}

The specified user's business expertise if the current user is allowed to know it.

B.3.14 EL Expressions Relevant to User Preferences

Table B-23 lists EL expressions relevant to user preferences and describes the types of functionality they provide. All listed ELs can be used in both WebCenter Spaces and custom portal applications built with Oracle JDeveloper.

Table B-23 EL Expressions Relevant to User Preferences

Expression

Function

#{generalSettings.userTimeZone}

Returns the time zone the current user has selected in application Preferences. For more information, see Section 35.3, "Setting Date and Time Preferences."

#{generalSettings.preferredDateStyle}

Returns the date format the current user has selected in application Preferences. For more information, see Section 35.3, "Setting Date and Time Preferences."

#{generalSettings.preferredDatePattern}

Returns the current user's preferred date format pattern if it has been set, else, returns null.

Note that date + pattern is applicable only to custom WebCenter applications, where they take precedence over date + style if they are set.

#{generalSettings.preferredTimeStyle}

Returns the time format the current user has selected in application Preferences. For more information, see Section 35.3, "Setting Date and Time Preferences."

#{generalSettings.preferredTimePattern}

Returns the current user's preferred time format pattern if it has been set, else, returns null.

#{generalSettings.preferredDateTimePattern}

Returns the current user's preferred date and time format pattern if it has been set, else, returns null.

#{generalSettings.preferredAccessibilityMode}

Returns the current user's preferred accessibility mode (either default, inaccessible, or screenReader)

#{generalSettings.preferredSkinName}

The current user's preferred skin name if one is specified, otherwise the default value.

#{generalSettings.formattedCurrentDate}

Returns the current date in the current user's selected locale.

#{generalSettings.formattedCurrentTime}

Returns the current time in the current user's selected locale.

#{generalSettings.formattedCurrentDateTime}

Returns the current date and time in the current user's selected locale.

#{requestContext.skinFamily}

Returns the name of the ADF Faces skin family being used for the current web request, depending on factors such as what has been configured at the application level, the current user's preference setting, and so on.

B.3.15 Utilitarian EL Expressions

Table B-24 lists utilitarian EL expressions and describes the types of functionality it provides.

Table B-24 Utilitarian EL Expressions

Expression

Function

#{userPreferences.currentDate}

Returns the current date in the format specified in the current user's preferences.

#{WCTruncator['text']['numberOfChars']}

Returns a truncation of the string specified as text to the number of characters specified as numberOfChars, followed by a trailing ellipsis, for example: #{WCTruncator['abracadabra']['5']} evaluates to abrac...

#{facesContext.viewRoot.locale}

#{facesContext.externalContext.requestLocale}

Both of these expressions return the request locale (that is, the browser locale setting).

#{changeModeBean.inEditMode}

Returns true if current application page is in Oracle Composer mode. Returns false if current application page is not in Oracle Composer mode

#{adfFacesContext.skinFamily}

Returns the current application skin family. Returns the same value as #{requestContext.skinFamily}.

C Business Mashup Examples

To help you leverage most of the mashup building capabilities in WebCenter Spaces, this appendix describes a variety of business scenarios that require creation of business mashups, and explains how to meet those requirements. It includes the following sections:

- Section C.1, "Creating Mashups with Data from the Analytics Service"

- Section C.2, "Creating a Mashup that Displays Employee Data from SQL Data Control"

- Section C.3, "Creating a Mashup with Data from the WebCenter Spaces MDS Repository"

- Section C.4, "Creating a Mashup with Data from a WebCenter Spaces Web Service Data Source"

- Section C.5, "Creating a Mashup with Data from a Siebel Data Source"

- Section C.6, "Building and Using a Custom Mashup Style with Predefined Columns"

- Section C.7, "Building and Using a Custom Mashup style with Date Fields"

- Section C.8, "Creating a Mashup with a Graph That Is Wired to the Page Navigation"

- Section C.9, "Creating a Mashup with a Graph that Is Wired to the Inherited Page Navigation"

- Section C.10, "Creating a Master-Detail Mashup that Contains a Google Maps Task Flow"

- Section C.11, "Creating a Mashup with a Customized RSS Feed OmniPortlet"

Note:

This appendix describes only the high level steps to perform a task. For the detailed steps, you are pointed to Chapter 26, "Creating Business Mashups."

Sample Applications on OTN

Sample applications created for some of the examples in this appendix are available on Oracle Technology Network (OTN). The following page on OTN provides links to business mashup-specific samples and other sample applications that illustrate the different WebCenter Spaces capabilities:

http://www.oracle.com/technetwork/middleware/webcenter/ps3-samples-176806.html

A readme file available with each sample describes what the application illustrates and provides guidance for extending or customizing the application for real life use cases.

C.1 Creating Mashups with Data from the Analytics Service

The Analytics service displays metrics, such as community traffic, portlet traffic, searched keywords, response times, and usage behavior, for the entire WebCenter Spaces application. This section describes how to create a mashup with date retrieved from the Analytics service data source. It includes the following sections:

- Section C.1.1, "Creating a Graph to Display Page Hits"

- Section C.1.2, "Using a Parameterized Task Flow to Display a Graph of Page Hits in a Space"

- Section C.1.3, "Creating a Graph to View Portal Site Traffic"

- Section C.1.4, "Creating a Mashup with Two Task Flows in a Master-Detail Relationship"

- Section C.1.5, "Creating a Table with Hyperlinks to Download Documents"

If you have configured WebCenter Services in your application, WebCenter Spaces provides an Analytics service connection, ActivitiesDS, out-of-the-box. You can use this connection to create a SQL data control and consume that data control as a graph to display statistics for the WebCenter Spaces application.

For information about configuring the Analytics service, see "Managing the Analytics Service" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

C.1.1 Creating a Graph to Display Page Hits

To create a graph that displays statistics for pages in your application:

1. Create a SQL data control, PageStats, using the ActivitiesDS connection. Specify the following SQL query and bind parameters:

Query:

SELECT space.name_ spaceName, page.name_ pageName, space.id, page.id, count(1),
fact.page_, page.resourceid_ FROM asfact_wc_pagevie_0 fact ,
asdim_wc_groupsp_0 space , asdim_wc_pages_0 page, asdim_wc_applica_0 app
WHERE space.id = fact.groupspace_ and page.id = fact.page_ and app.id =
fact.application_ and fact.occurred between to_date(:startdate, :dateformat)
and to_date(:enddate, :dateformat) and app.name_ = :appname and page.personal_
= :ispersonal and space.name_ is not null and page.name_ is not null and
space.id is not null and page.id is not null
and fact.page_ is not null and page.resourceid_ is not null GROUP BY
space.name_, page.name_, space.id, page.id, fact.page_, page.resourceid_ ORDER BY count(1) desc

Bind Parameters:

startdate - 01/01/2008

dateformat - MM/DD/YYYY

appname - webcenter

ispersonal - 1

enddate - 01/01/2011

For the detailed steps, see Section 26.2.1.2, "Creating the Data Control."

2. Expose the data control in the Resource Catalog by selecting Show from the Edit menu.

3. Create a task flow, Page Hits, based on the blank mashup style.

For detailed steps, see Section 26.3.1, "Creating a Task Flow."

4. Edit the task flow, click Add Content, and in the catalog, locate the PageStats data control and drill down to the Analytics_PageViews_DC accessor.

5. Add the accessor as a graph. In the Create Graph dialog, select the following options:

- Select the Bar graph type.

- On the Placement page, select the Space Name, Page Name and Page ID data columns to be mapped along the X-axis, and Count to be mapped as Bars.

- Accept the default values on all other pages of the dialog.

For the detailed steps, see Section 26.4.1.3, "Adding a Data Control as a Graph."

The graph is displayed as shown in Figure C-1.

Figure C-1 Bar Graph Displaying Page Hits

C.1.2 Using a Parameterized Task Flow to Display a Graph of Page Hits in a Space

In the previous example, you saw how to view page hits in your WebCenter Spaces application. This section describes a similar example, but with the ability to display page hits for a specific Space only. In this case, the data control is added as a graph to a parameter form task flow. The input parameter allows users to specify a Space name and display statistics for that Space in the graph. This section includes the following subsections:

- Section C.1.2.1, "Creating the Page Hits Data Control"

- Section C.1.2.2, "Creating a Custom Mashup Style with a Parameter to Specify the Space Name"

- Section C.1.2.3, "Creating a Task Flow Using the Custom Mashup Style"

- Section C.1.2.4, "Consuming the Data Control in the Task Flow"

C.1.2.1 Creating the Page Hits Data Control

If you have configured WebCenter Services in your application, an Analytics service connection, ActivitiesDS, is available out-of-the-box. You can use this connection to create a SQL data control. This section describes how to create a data control to view the top five page hits for the last 7 days for a given Space.

To create the data control:

See Also:

Section 26.2.1.2, "Creating the Data Control" for the detailed steps to create a data control.

1. Use the ActivitiesDS connection and create a SQL data control named PageHits.

2. Specify the following SQL query:

SELECT * FROM
(SELECT page.name_ pageName, space.name_ spaceName, COUNT(1) hits
FROM asdim_users u, asdim_wc_pages_0 page, asdim_wc_applica_0 app, asdim_wc_groupsp_0 space, asfact_wc_pagevie_0 fact
WHERE fact.page_ = page.id AND fact.userid = u.id AND fact.application_ = app.id
AND fact.groupspace_ = space.id AND fact.occurred BETWEEN(SYSDATE-6) AND (SYSDATE+1) AND app.name_ = 'webcenter'
AND u.userid <> 'anonymous' AND  upper(space.name_) LIKE upper(:spacename) AND space.name_ IS NOT NULL
AND page.name_  IS NOT NULL AND space.id IS NOT NULL AND page.id IS NOT NULL
AND fact.page_  IS NOT NULL AND page.resourceid_ IS NOT NULL
GROUP BY page.name_, space.name_ ORDER BY hits DESC)
WHERE rownum <= 5 ORDER BY rownum

The data control is created with the spacename bind variable.

3. Set the spacename bind variable to Home space.

4. Test the query and view the data retrieved from the data source, as shown in Figure C-2.

Figure C-2 SQL Data Control Query Test Result

C.1.2.2 Creating a Custom Mashup Style with a Parameter to Specify the Space Name

This section describes how to create a custom mashup style, Input Space Name, with an input text field that can be wired to the SQL data control's bind variable. With this type of wiring, users can provide a Space name to view page hits for that Space.

To create the custom mashup style:

1. Copy an existing mashup style in the Resource Manager and name it Input Space Name.

2. Edit the source of the task flow, click the Fragment tab, and replace the entire code with the following:

<?xml version='1.0' encoding='UTF-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1"
xmlns:pe="http://xmlns.oracle.com/adf/pageeditor"
xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich">
<af:panelGroupLayout id="pgl">
<af:panelGroupLayout id="pg2" layout="horizontal" halign="center" inlineStyle="padding-bottom:5px;">
<af:inputText id="ip1" value="#{pageFlowScope.bindVarId}" label="Space Name"
shortDesc="Enter a Space name. The default value is home space."/>
<af:commandButton text="#{dataComposerBundle.MASHUP_STYLES_GO}" id="cb1"/>
</af:panelGroupLayout>
<cust:panelCustomizable id="pc1" halign="center"/>
</af:panelGroupLayout>
</jsp:root>

3. Select the mashup style in the Resource Manager, and from the Edit menu, click Show.

For the detailed steps to create and edit a mashup style, see Section 26.3.4, "Managing Mashup Styles."

C.1.2.3 Creating a Task Flow Using the Custom Mashup Style

In the Resource Manager, create a task flow, Top Five Page Hits for a Space, based on the new mashup style, as shown in Figure C-3.

Figure C-3 Create New Task Flow Dialog Displaying the New Mashup Style

For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

From the Edit menu, select Show to include the task flow in the Resource Catalog.

C.1.2.4 Consuming the Data Control in the Task Flow

To add the page hits data control to the new task flow:

1. Edit the Top Five Page Hits for a Space task flow, and add the PageHits data control accessor as a graph, as shown in Figure C-4.

Figure C-4 Graph Option on the PageHits Data Control Accessor

2. In the Create Graph dialog, on the Type page, choose Bar.

3. On the Placement page, place PAGENAME and SPACENAME on the X Axis, and HITS as the Bars.

4. On the DC Parameters page, specify the following value for the spacename parameter:

#{empty pageFlowScope.bindVarId ? 'home space' : pageFlowScope.bindVarId}

C.1.2.5 Testing the Parameter Wiring in the Task Flow

This section describes the steps you must perform to test whether the graph in the task flow displays data specific to the Space name you provide.

To test the task flow:

1. Create a test page and add the task flow from the Add Content dialog.

2. To ensure that the graph displays properly on the page:

1. Edit the task flow.

2. In the Component Properties dialog, on the Basic page of the Display Options tab, deselect the Allow Resize option.

3. On the Advanced page of the Display Options tab, set Stretch Content to Auto.

3. Specify a different Space name in the input text field. The graph displays data specific to that Space, as shown in Figure C-5.

Figure C-5 Bar Graph Displaying Page Hits for a Given Space

C.1.3 Creating a Graph to View Portal Site Traffic

This section explains how to retrieve the site traffic data from the Analytics service and display it as a Pie graph.

To create a mashup with the portal site traffic data:

1. Create a SQL data control, PortalStats, using the ActivitiesDS connection. Specify the following SQL query and bind parameters:

Query:

SELECT 'Spaces' Name, count(1) Hits
FROM asfact_wc_groupsp_0 fact , asdim_wc_groupsp_0 space , asdim_wc_applica_0 app
WHERE space.id = fact.groupspace_ and app.id = fact.application_ and fact.occurred between
to_date(:startdate, :dateformat) and to_date(:enddate, :dateformat) and
app.name_ = :appname and
space.personal_ = :ispersonal
UNION ALL
SELECT 'Pages' Name, count(1) Hits
FROM asfact_wc_pagevie_0 fact , asdim_wc_pages_0 page , asdim_wc_applica_0 app
WHERE page.id = fact.page_ and app.id = fact.application_ and fact.occurred
between
to_date(:startdate, :dateformat) and to_date(:enddate, :dateformat) and
app.name_ = :appname and
page.personal_ = :ispersonal
UNION ALL
SELECT 'Portlets' Name, count(1) Hits
FROM asfact_wc_portlet_0 fact , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.occurred between to_date(:startdate,
:dateformat) and
to_date(:enddate, :dateformat) and app.name_ = :appname
UNION ALL
SELECT 'Logins' Name, count(1) Hits
FROM asfact_wc_logins_0 fact , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.occurred between to_date(:startdate,
:dateformat) and
to_date(:enddate, :dateformat) and app.name_ = :appname
UNION ALL
SELECT 'Searches' Name, count(1) Hits
FROM asfact_wc_searche_0 fact , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.occurred between to_date(:startdate,
:dateformat) and
to_date(:enddate, :dateformat) and app.name_ = :appname
UNION ALL
SELECT 'Wikis' Name, count(1) Hits
FROM asfact_wc_doclib__0 fact , asdim_wc_documen_0 doc , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.document_ = doc.id and fact.occurred
between
to_date(:startdate, :dateformat) and to_date(:enddate, :dateformat) and
app.name_ = :appname and
doc.objecttype_ like '%WIKI%'
UNION ALL
SELECT 'Blogs' Name, count(1) Hits
FROM asfact_wc_doclib__0 fact , asdim_wc_documen_0 doc , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.document_ = doc.id and fact.occurred
between
to_date(:startdate, :dateformat) and to_date(:enddate, :dateformat) and
app.name_ = :appname and
doc.objecttype_ like '%BLOG%'
UNION ALL
SELECT 'Documents' Name, count(1) Hits
FROM asfact_wc_doclib__0 fact , asdim_wc_documen_0 doc , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.document_ = doc.id and fact.occurred
between
to_date(:startdate, :dateformat) and to_date(:enddate, :dateformat) and
app.name_ = :appname and
doc.objecttype_ like '%DOCUMENT%'
UNION ALL
SELECT 'Discussions' Name, count(1) Hits
FROM asfact_wc_discuss_1 fact , asdim_wc_applica_0 app
WHERE app.id = fact.application_ and fact.occurred between to_date(:startdate,
:dateformat) and
to_date(:enddate, :dateformat) and app.name_ = :appname

Bind Parameters:

startdate - 01/01/2008

dateformat - MM/DD/YYYY

appname - webcenter

ispersonal - 1

enddate - 01/01/2011

For the detailed steps, see Section 26.2.1.2, "Creating the Data Control."

2. Expose the data control in the Resource Catalog by selecting Show from the Edit menu.

3. Create a task flow, Portal Traffic, based on the blank mashup style.

For detailed steps, see Section 26.3.1, "Creating a Task Flow."

4. Edit the task flow, click Add Content, and in the catalog, locate the PortalStats data control and drill down to the Site_Traffic_DC accessor.

5. Add the accessor as a graph. In the Create Graph dialog, select the following options:

- Select the Pie graph type.

- On the Placement page, select Name data column to be plotted as slices and Hits as the pie.

- Accept the default values on all other pages of the dialog.

For the detailed steps, see Section 26.4.1.3, "Adding a Data Control as a Graph."

The graph is displayed as shown in Figure C-6.

Figure C-6 Graph Displaying Portal Traffic Statistics

C.1.4 Creating a Mashup with Two Task Flows in a Master-Detail Relationship

This example describes how to wire two task flows in a master-detail relationship so that a selection in one task flow results in an action on the second one. This section illustrates how to do the following:

- Create a master task flow that displays page hits in a table.

- Hyperlink the user names column in the table.

- Create a details task flow that displays a graph of top five page hits for a user.

- On clicking a user name in the master, display the details task flow in a popup window.

C.1.4.1 Creating the Master Data Control and Task Flow

The master task flow displays a table with the top five page views for a given Space during the last seven days.

To create the task flow:

1. Create a SQL data control, TopFiveDocViewsForSelectedSpace, using the ActivitiesDS connection. Specify the following SQL query:

select * from (select  u.id id , u.userid userid, count(fact.userid)  pageviewsfrom asdim_users u , asfact_wc_pagevie_0 fact,asdim_wc_applica_0 app where fact.userid=u.idand u.userid <> 'anonymous' and fact.application_ = app.id and app.name_ = 'webcenter'  and fact.occurred BETWEEN (SYSDATE-7) and ( SYSDATE+1)group by u.id,u.useridorder by pageviews desc )where rownum<11

For the detailed steps, see Section 26.2.1.2, "Creating the Data Control."

This query returns the top five page hits for a given Space for the last seven days.

2. Select the new data control, and from the Edit menu, click Show.

3. Create a task flow, Top 10 Visitor Page Hits, based on the Blank mashup style.

For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

4. Edit the task flow and add the TopFiveDocViewsForSelectedSpace data control accessor as a table.

Create a read-only table. On the Columns page in the Create Table dialog, choose to display the USERID column as hyperlinks, and specify the URL to be http://www.oracle.com, as shown in Figure C-7.

Figure C-7 Display Columns as Hyperlinks

The table displays a user-wise listing of the top page hits. The USERID column displays user names as hyperlinks, as shown in Figure C-8.

Figure C-8 Master Task Flow Displaying Top Page Hits

5. Select the new task flow, and from the Edit menu, click Show.

C.1.4.2 Creating the Details Data Control and Task Flow

You have seen how to create a master task flow that displays the top page hits in a table, in which the user names are hyperlinked. The next step is to create a details task flow that must be displayed on clicking a user name in the master task flow. This section describes how to create a details task flow that displays a graph of all page hits for a given user.

To create the details data control and task flow:

1. Create a SQL data control, PageHitsForSelectedUser, using the ActivitiesDS connection. Specify the following SQL query and bind variable:

SELECT page.name_ pageName, space.name_ spaceName, COUNT(1) hits
FROM asdim_users u, asdim_wc_pages_0 page, asdim_wc_applica_0 app,
asdim_wc_groupsp_0 space, asfact_wc_pagevie_0 fact
WHERE fact.page_          = page.id AND fact.userid = u.id
AND u.userid=(:userid) AND fact.application_ = app.id
AND fact.groupspace_  = space.id AND fact.occurred
BETWEEN (SYSDATE-7) and SYSDATE and app.name_ = 'webcenter'
AND u.userid <> 'anonymous' AND space.name_ IS NOT NULL
AND page.name_  IS NOT NULL AND space.id         IS NOT NULL
AND page.id IS NOT NULL AND fact.page_  IS NOT NULL
AND page.resourceid_ IS NOT NULL GROUP BY page.name_, space.name_

Set the userid bind variable to weblogic.

For the detailed steps, see Section 26.2.1.2, "Creating the Data Control."

2. Select the new data control, and from the Edit menu, click Show.

3. Create a task flow, Page Hits for Selected User, based on the Blank mashup style.

For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

4. Edit the task flow and add the PageHitsForSelectedUser data control accessor as a graph.

Create a bar graph, and plot SPACENAME and PAGENAME along the X-Axis and HITS as Bars.

On the DC Parameters page in the Create Graph dialog, specify the following value for the userid parameter:

#{empty pageFlowScope.userid ?'weblogic': pageFlowScope.userid}

This ensures that weblogic is selected as the default user if no user name is specified for the parameter. The graph displays as shown in Figure C-9.

Figure C-9 Bar Graph Displaying Page Hits for a Selected User

5. Create a task flow parameter called userid, and set its value to the pageFlowScope, as shown in Figure C-10.

Figure C-10 Parameter Defined on the Details Task Flow

6. Select the new task flow, and from the Edit menu, click Show.

C.1.4.3 Wiring the Master and Details Task Flows

This section describes how to wire the master and details task flows so that a user can click a user name in the master task flow to pop up the details task flow displaying the page hits graph for that user.

To wire the master and details task flows:

1. Edit the source of the master task flow, Top 10 Visitor Page Hits. Click the Fragment tab in the Edit Source dialog, and paste the following code below <af:panelGroupLayout id="pgl1"> to reference the details task flow in a popup:

<af:popup id="popup1" launcherVar="source" eventContext="launcher" contentDelivery="lazyUncached">
<af:dialog>
<af:region xmlns:af="http://xmlns.oracle.com/adf/faces/rich" id="oc_449838760region1"
value="#{bindings.popTaskflow.regionModel}"/>
</af:dialog>
<af:setPropertyListener from="#{source.attributes.userid}"
to="#{viewScope.userid}" type="popupFetch"/>
</af:popup>

2. Find the <af:goLink> code segment and replace it with the following so that the USERID column displays command links that invoke a popup dialog:

<af:commandLink text="#{row.bindings.USERID.inputValue}" id="userLink">
<af:clientAttribute name="userid" value="#{row.bindings.USERID.inputValue}"/>
<af:showPopupBehavior popupId="::popup1" alignId="userLink" align="afterEnd"/>
</af:commandLink>

3. Click the Page Definition tab, and add a reference to the details task flow. Paste the following code within the <executable> tag and below the <iterator> tag:

<taskFlow id="popTaskflow" taskFlowId="details_taskflow_definition_path#blanktaskflow"
xmlns="http://xmlns.oracle.com/adf/controller/binding" Refresh="ifNeeded">
<parameters>
<parameter id="userid" value="#{viewScope.userid}"/>
</parameters>
</taskFlow>

where details_taskflow_definition_path is the path to the task flow in your instance, for example, /oracle/webcenter/siteresources/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/taskFlow/gsr34e6278e_9e9a_45eb_bbbf_31aa5ae34381/taskflow-definition.xml.

You can get this path by selecting the task flow in the Resources Manger, and clicking Edit Properties on the Edit Menu. The Metadata File attribute provides the complete path to the task flow.

4. Test the master-detail relationship. Preview the Top 10 Visitor Page Hits task flow in the Resources Manager. When you click a user name link, the page hits graph for that user is displayed in a popup window, as shown in Figure C-11.

Figure C-11 Master-Detail Relationship Between Two Task Flows

C.1.5 Creating a Table with Hyperlinks to Download Documents

This section describes how to create a mashup with a table listing the top five documents viewed in a Space. The document names in the table are displayed as hyperlinks so that a user can click a link to open the selected document in a new window. The data for the table comes from a SQL data control to the WebCenter Spaces Analytics service. This section includes the following sections:

- Section C.1.5.1, "Creating the Document Views Data Control"

- Section C.1.5.2, "Creating a Custom Mashup Style with a Parameter to Specify the Space Name"

- Section C.1.5.3, "Creating a Task Flow Using the Custom Mashup Style"

- Section C.1.5.4, "Consuming the Data Control in the Task Flow"

- Section C.1.5.5, "Testing the Parameter Wiring in the Task Flow"

C.1.5.1 Creating the Document Views Data Control

This section describes how to create a data control to view the top five document hits for the last 7 days for a given Space.

1. Use the ActivitiesDS connection and create a SQL data control named Top Five Doc Views for Given Space in the Past Week and specify the following SQL query:

SELECT *
FROM( SELECT  doc.name_ name,space.name_ space,count(1) hits,doc.path_  download_url
FROM asfact_wc_doclib__0 fact , asdim_wc_documen_0 doc , asdim_wc_applica_0 app,asdim_wc_groupsp_0 space
WHERE
app.name_ = 'webcenter'
AND  app.id = fact.application_
AND fact.document_ = doc.id
AND fact.occurred BETWEEN (SYSDATE-6)  AND (SYSDATE+1)
AND doc.name_ is not null
AND doc.id is not null
AND fact.document_ is not null
AND doc.resourceid_ is not null
AND  fact.GROUPSPACE_ = space.id
AND  upper(space.name_) LIKE upper(:spacename)
AND space.name_ IS NOT NULL
GROUP BY doc.name_, doc.id,space.name_ ,doc.path_
ORDER BY hits  DESC)
WHERE rownum <= 5
ORDER BY rownum

The data control is created with the spacename bind variable.

2. Set the spacename bind variable to Home space.

3. Test the query and view the data retrieved from the data source, as shown in Figure C-12.

Figure C-12 New Data Control Query Test Results

C.1.5.2 Creating a Custom Mashup Style with a Parameter to Specify the Space Name

This section describes how to create a custom mashup style, Input Space Name, with an input text field that can be wired to the SQL data control's bind variable. With this type of wiring, users can provide a Space name to view page hits for that Space.

To create the custom mashup style:

1. Copy an existing mashup style in the Resource Manager and name it Input Space.

2. Edit the source of the task flow, click the Fragment tab, and replace the entire code with the following:

<?xml version='1.0' encoding='UTF-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1"
xmlns:pe="http://xmlns.oracle.com/adf/pageeditor"
xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich">
<af:panelGroupLayout id="pgl">
<af:panelGroupLayout id="pg2" layout="horizontal" halign="center" inlineStyle="padding-bottom:5px;">
<af:inputText id="ip1" value="#{pageFlowScope.bindVarId}" label="Space
Name" shortDesc="Enter A Space Name, by default it's all spaces"/>
<af:commandButton text="#{dataComposerBundle.MASHUP_STYLES_GO}" id="cb1"/>
</af:panelGroupLayout>
<cust:panelCustomizable id="pc1" halign="center"/>
</af:panelGroupLayout>
</jsp:root>

3. Select the mashup style in the Resource Manager, and from the Edit menu, click Show.

C.1.5.3 Creating a Task Flow Using the Custom Mashup Style

To create a task flow using the custom style:

1. In the Resource Manager, create a task flow, Top Five Doc Hits for a Given Space in a Week, based on the new mashup style, as shown in Figure C-13.

Figure C-13 New Mashup Style in the Create New Task Flow Dialog

2. Select the task flow in the Resource Manager, and from the Edit menu, click Show.

C.1.5.4 Consuming the Data Control in the Task Flow

To consume the page hits data control in the new task flow:

1. Edit the Top Five Doc Hits for a Given Space in a Week task flow and add the Top Five Doc Views for Given Space in the Past Week data control accessor as a table, as shown in Figure C-14.

Figure C-14 Table Option on the Data Control Accessor

Create a read-only table. On the Items page in the Create Table dialog (shown in Figure C-15), ensure that the DOWNLOAD_URL column is not displayed.

Figure C-15 Items Page of the Create Table Dialog

On the Columns page, choose to display the Name column as hyperlinks, and specify the URL to be the following (as shown in Figure C-16):

{doc path pre fix}#{empty row.DOWNLOAD_URL ? '' : row.DOWNLOAD_URL}

where

doc path pre fix is the prefix to be used for the document URL. To find the prefix for a document path, select a document on the Documents page and click Get a Link from the View menu. The first part of the Download URL (ending in path) is the prefix to be used. For example, http://my.company.com:8889/webcenter/content/conn/xyz18-ucm11g/path.

Figure C-16 Name Column Defined as a Hyperlink

2. On the DC Parameters page, specify the following value for the spacename parameter:

spacename: #{empty pageFlowScope.bindVarId ? '%' : pageFlowScope.bindVarId}

The data control is now shown as a table in the task flow.

3. Optionally, edit the table. In the Component Properties dialog, change the value of the Column Stretching field to last, as shown in Figure C-17. This ensures that the last column is stretched when required.

Figure C-17 Component Properties Dialog for the Table

4. To ensure that the table displays properly on the page:

1. Edit the task flow.

2. In the Component Properties dialog, on the Basic page of the Display Options tab, deselect the Allow Resize option.

3. On the Advanced page of the Display Options tab, set Stretch Content to Auto.

C.1.5.5 Testing the Parameter Wiring in the Task Flow

This section describes the steps you must perform to test whether the table in the task flow displays data specific to the Space name you provide.

To test the task flow:

1. Create a test page and add the task flow from the Resource Catalog.

The task flow displays the table.

2. Specify a different Space name in the input text field. The table displays data specific to that Space.

The NAME column displays hyperlinks that enable you to download the documents, as shown in Figure C-18.

Figure C-18 Table with Hyperlinked Document Names

C.2 Creating a Mashup that Displays Employee Data from SQL Data Control

The tasks in this section use examples based on an employee database. This section describes how to add a visualization for the retrieved employee data and customize this visualization by performing a few simple configurations. This section describes how to add the EmpDetails data control as a table to the Employee Details task flow and perform different customizations on the table, such as showing or hiding columns and sorting rows. It includes the following sections:

- Section C.2.1, "Creating the SQL Data Control"

- Section C.2.2, "Adding the Data Control and Binding Task Flow Parameters to Data Control Parameters"

- Section C.2.3, "Showing a Hidden Column in the Table"

- Section C.2.4, "Adding the Data Control in a Parameter Form Task Flow"

C.2.1 Creating the SQL Data Control

Perform the following tasks to create a data control for the employee database:

1. Create a connection to the employee database. For the detailed steps, see Section 26.2.1.1, "Creating a Database Connection."

2. Create a SQL data control, EmpDetails, to retrieve data using this database connection. Use the following query to retrieve data:

select ename, empno, mgr, deptno from emp where job in (:jobId) order by empno asc

For the detailed steps, see Section 26.2.1.2, "Creating the Data Control."

This data control returns records for all employees whose designation matches the value of jobId. The records are sorted by employee number.

3. Create a task flow, Employee Details, based on the Blank mashup style. For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

C.2.2 Adding the Data Control and Binding Task Flow Parameters to Data Control Parameters

Perform the following steps to add the data control as a table:

1. Edit the Employee Details task flow in Oracle Composer.

2. In the Add Content dialog, navigate to the EmpDetails data control's accessor, click Add, and select Table, as shown in Figure C-19.

Figure C-19 Employee Details Data Control Accessor

3. Create an editable table, enable row selection, filtering and sorting, and select columns ename, empno, and deptno to be displayed in the table.

For the detailed steps, see Section 26.4.1.1, "Adding a Data Control as a Table."

The table displays with an empty field at the top of each column, as shown in Figure C-20. You can use those fields to specify filter criteria for the columns.

Figure C-20 Table in the Employee Details Task Flow

4. Create a task flow parameter, designation.

For the detailed steps, see Section 26.4.2, "Creating Task Flow Parameters."

5. To use the designation parameter to drive the data displayed in the table, copy the storage value of the parameter, #{pageFlowScope.designation}, and paste it as the value for the bind variable, jobId, on the Data tab of the table's Component Properties dialog.

For the detailed steps, see Section 26.4.3, "Binding Data Control Parameters to Task Flow Parameters."

6. Create a page and add the Employee Details task flow to the page.

For the detailed steps, see Section 26.4.5, "Consuming Task Flows that Contain Visualizations."

7. Edit the Employee Details task flow on the page, and on the Parameters tab, specify a designation to view corresponding details in the table.

C.2.3 Showing a Hidden Column in the Table

In your SQL query, you specified that the data control must retrieve the columns ename, empno, deptno, and mgr. However, you chose to display only the ename, empno, and deptno columns. In this case, the data control retrieves data from all four data columns, but displays only three. You can render the fourth column in the table but editing the table's source code. To do this:

1. On the Resource Manager - Task Flows page, select the Employee Details task flow.

2. Click Edit Source, then the Fragments tab, and locate the code for the hidden column. It would be similar to the code in the following example:

<column sortProperty="MGR" filterable="true" sortable="true"
headerText="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.label}"
id="column4" rendered="false">
<af:inputText value="#{row.bindings.MGR.inputValue}"
label="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.label}"
required="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.mandatory}"
columns="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.displayWidth}"
maximumLength="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.precision}"
shortDesc="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.tooltip}"
id="inputText4">
<f:validator binding="#{row.bindings.MGR.validator}"/>
<af:convertNumber groupingUsed="false" pattern="#{bindings.accessor_gsrf2d136f7_d907_481d_ad3a_eb2b9dbe7c35.hints.MGR.format}"
id="convertNumber3"/>
</af:inputText>
</column>

3. Set the rendered attribute to true.

The table now displays all four columns, as shown in Figure C-21.

Figure C-21 Table Displaying Four Columns

Similarly, you can hide a visible column by setting its rendered attribute to false.

C.2.4 Adding the Data Control in a Parameter Form Task Flow

The Parameter Form task flow provides an input text field where a user can specify a value. This value is passed to a data control accessor parameter so that the accessor displays data based on the user input.

You can add a data control as a table inside a Parameter Form task flow so that users can specify a value in the field to view corresponding details in the table.

To add a data control inside a Parameter Form task flow:

1. Create a task flow based on the Parameter Form mashup style.

For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

2. Edit the task flow in Oracle Composer and add the EmpDetails data control as a table inside the task flow.

For the steps, see Section C.2.2, "Adding the Data Control and Binding Task Flow Parameters to Data Control Parameters."

3. Wire the jobId parameter on the data control to the Input Text component in the Parameter Form task flow, by specifying the jobId value to be #{pageFlowScope.bindVarId}.

For detailed steps, see Section 26.4.4, "Wiring a Data Control to a Parameter Form Task Flow."

You can now specify a value in the input text field to view the corresponding records in the table, as shown in Figure C-22.

Figure C-22 Data Control in a Parameter Form Task Flow

C.3 Creating a Mashup with Data from the WebCenter Spaces MDS Repository

WebCenter Spaces applications are seeded with the following repository connections:

- WebCenterDS

- mds-owsm

- mds-SpacesDS

- ActivitiesDS

You can create data controls for any of these connections and consume them in pages and task flows. This section describes how to create a data control to connect to the WebCenter Spaces repository and display details about the Spaces and pages in the application and so on. It includes the following subsections:

- Section C.3.1, "Creating the Data Control"

- Section C.3.2, "Adding the Data Control as a Graph Inside a Task Flow"

C.3.1 Creating the Data Control

Create a data control, WebCenter Pages, to retrieve page-related data from the WebCenter Spaces data source. Use the mds-SpacesDS connection and enter the following SQL query:

select 'Home Space Pages' metric, count(*) value from mds_paths where path_type = 'DOCUMENT'
and path_name like '%.jspx' and path_high_cn is null and path_fullname like '%/user/%'
union select 'Business Role Pages' metric, count(*) value  from mds_paths where path_type = 'DOCUMENT'
and path_name like '%.jspx' and path_high_cn is null and path_fullname like '%/businessRolePages/%'
union select 'Space Template Pages' metric, count(*) value from mds_paths where path_type = 'DOCUMENT'
and path_name like '%.jspx' and path_high_cn is null and path_fullname like '%/spacetemplate/%'
union select 'Group Space Pages' metric, count(*) value from mds_paths where path_type = 'DOCUMENT'
and path_name like '%.jspx' and path_high_cn is null and (path_fullname not like '%/user/%'
and path_fullname not like '%/businessRolePages/%' and path_fullname not like '%/spacetemplate/%')

This query retrieves information about the different type of pages and the count of each page type, as shown in Figure C-23.

Figure C-23 Data Control with Page Information from the WebCenter Spaces Repository

This type of information can be represented either in a table or a graph. The following section describes how to add this data control as a graph.

C.3.2 Adding the Data Control as a Graph Inside a Task Flow

Create a blank task flow and add the data control as a Graph. Select the Pie graph type, and place the METRIC column as slices and the VALUE column as the Pie. The graph is added to the task flow as shown in Figure C-24.

Figure C-24 Page Metrics Displayed as a Pie Graph

C.4 Creating a Mashup with Data from a WebCenter Spaces Web Service Data Source

You can create a data control to the WebCenter Spaces Web Service and retrieve information about the application and Spaces, for example, list the Spaces in the instance. However, you must first prepare your WebCenter Spaces instance to expose Web Services.

Getting Started

Before you begin with the configurations in this section, you must configure WS-Security for your WebCenter Spaces instance. For the detailed steps, see the "Configuring WS-Security" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. If you create a mashup without configuring WS-Security, an error occurs when retrieving data from the data source.

This section describes the following use cases:

- Section C.4.1, "Creating a Mashup to List the Spaces in the Application"

- Section C.4.2, "Creating a Mashup with a Form to Rename Spaces"

C.4.1 Creating a Mashup to List the Spaces in the Application

This section describes how to create a mashup to display a list of Spaces. The Space names are displayed as hyperlinks so that a user can click a link to view the selected Space.

To create a data control and task flow to display the list of Spaces:

1. Create a Web Service data control, SpacesWS, (Figure C-25) using a WSDL URL with the appropriate machine name and port number, as shown in the following example:

http://myserver.us.oracle.com:8888/webcenter/SpacesWebService?WSDL

For the detailed steps, see Section 26.2.2.1, "Creating the Data Control."

Figure C-25 WebCenter Spaces Web Service Data Control

2. On the OWSM Security page, apply the following additional policy, as shown in Figure C-26:

oracle/wss11_saml_token_with_message_protection_client_policy

Figure C-26 WebCenter Spaces Web Service Data Control - OWSM Security

3. Click Create.

4. Select the data control, and from the Edit menu, select Show.

5. Create a blank task flow, Spaces, to consume the data control.

For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

6. Edit the Spaces task flow and add the SpacesWS data control accessor as a table.

For the detailed steps, see Section 26.4.1.1, "Adding a Data Control as a Table."

To display the Space names as links, on the Columns page in the Create Table dialog, select Hyperlink in the Display As field. Then in the URL field (Figure C-27), specify the URL to which the Space name must be appended so that it opens the Space in a separate window, for example /spaces/#{row.item}.

Figure C-27 Hyperlink Option on the Table Create - Columns Page

The table displays as shown in Figure C-28

Figure C-28 Mashup Displaying a List of Spaces

C.4.2 Creating a Mashup with a Form to Rename Spaces

This section references the SpacesWS Web Service data control created in the previous section and describes how to create a form that can be used to rename a given Space.

To create a custom form:

1. Create a task flow, Rename Space, using the Blank mashup style.

2. Edit the task flow and click Add Content.

3. Drill down to view the SpacesWS data control, and add the renameGroupSpace method.

4. Open the renameGroupSpace method and add arg1 and arg0 attributes as ADF Input Text w/Label, as shown in Figure C-29. This step adds two input text fields, where users can specify the old Space name and new Space name.

Figure C-29 Options to Add renameGroupSpace Attributes

5. Save and close the task flow.

6. Change the labels for the input text fields:

1. Select the task flow, and from the Edit menu, select Edit Source.

2. Replace the label value for the first inputText component (#{bindings.arg0.hints.label}) to Old Space Name.

3. Replace the label value for the second inputText component (#{bindings.arg1.hints.label}) to New Space Name.

4. Click OK.

The task flow now appears as shown in Figure C-30.

Figure C-30 Task Flow to Change a Space Name

7. In the Resources Manager, select the task flow, and click Show from the Edit menu.

You can now add this task flow to any page and provide the capability to change Space names.

C.5 Creating a Mashup with Data from a Siebel Data Source

This section describes how to create a mashup with data from a Siebel data source using a Web Service data control. It includes the following sections:

- Section C.5.1, "Creating a Web Service Data Control"

- Section C.5.2, "Adding a Data Control Method as a Table to a Task Flow"

- Section C.5.3, "Querying the Data Source"

- Section C.5.4, "Updating Data Source Records"

Prerequisites

To create a Web Service data control to the Siebel data source, you must first create an inbound Web Service and generate a WSDL for the service. Refer to the following document for the steps to be performed:

http://st-curriculum.oracle.com/obe/fmw/soa_apps_integ/10g/10_132_siebel/siebel.htm

C.5.1 Creating a Web Service Data Control

On the Resource Manager - Data Controls page, create a Web Service data control, CustData, using the WSDL for the Siebel Web Service.

For the detailed steps, see Section 26.2.2.1, "Creating the Data Control."

This example shows a connection to a Web Service that provides two methods, MyQueryById and MyInsertOrUpdate. MyQueryById takes a complex parameter, MyQueryById_Input, and MyInsertOrUpdate takes a parameter, MyInsertOrUpdate_Input. MyInsertOrUpdate_Input is an array parameter, which can be used to update multiple records in the table.

Note:

The parameter names used in this section are examples only. You can provide parameter names of your choice while creating the Web Service.

Expose the CustData data control in the Resource Catalog by selecting Show from the Edit menu.

C.5.2 Adding a Data Control Method as a Table to a Task Flow

To consume the CustData data control in a task flow:

1. On the Resource Manager - Task Flows page, create a task flow based on the Parameter Form style.

For the detailed steps, see Section 26.3.1, "Creating a Task Flow."

2. Edit the task flow and click Add Content.

3. Locate the CustomerData data control and expand it to view its contents. Open MyQueryById, Return, then ListOfAccountInterface.

4. Add Account, shown in Figure C-31, as an editable table.

Figure C-31 Table Option on the Account Method

5. In the Create Table dialog, select the columns to be displayed, as shown in Figure C-32.

Figure C-32 Items Page in the Create Table Dialog

6. On the DC Parameters page of the wizard, from the context menu next to the MyQueryById_Input field, click Parameter Structure.

7. In the Parameters dialog, expand the complex parameter to view the PrimaryRowId parameter, specify the binding for this parameter as #{pageFlowScope.id}, as shown in Figure C-33, then click OK.

Figure C-33 Parameters Dialog

8. Click Create.

At this point, as the parameter passes a null value, the table displays all available records, as shown in Figure C-34.

Figure C-34 Table Inside a Parameter Form Task Flow

9. As the table is inside a parameter form task flow, you must wire the task flow parameter to the data control parameter. To do this:

1. From the View menu, select Source.

2. In Source view, select the inputText component at the bottom of the page and click Edit on the toolbar.

3. Change its Value attribute to #{pageFlowScope.id}, as shown in Figure C-35.

Figure C-35 Component Properties Dialog for Input Text Field

4. Click OK.

5. Additionally, delete the commandButton component with the title GO.

As an alternative to this button, you will learn how to use one of the Web Service methods to query the data source.

10. Switch back to Design mode of the page.

As you deleted the GO button in the parameter form task flow, there is currently no way to query the data source from the task flow. Therefore, the next step is to add a Web Service method to query the data source.

C.5.3 Querying the Data Source

The Siebel Web Service in this example provides the MyQueryById method, which supports a single parameter, MyQueryById_Input. Add this method as a button to the task flow. As you already wired the MyQueryById_Input parameter to the task flow parameter in the previous step, the button is automatically wired to the task flow parameter.

To enable querying using the MyQueryById method:

1. Edit the task flow and click Add Content.

2. In the catalog, locate the CustData data control and expand it.

3. Add the MyQueryById method as an ADF Button.

You can now specify an account ID in the parameter field to view details for that account in the table, as shown in Figure C-36.

Figure C-36 Table and Query Button inside the Parameter Form Task Flow

C.5.4 Updating Data Source Records

If a data source allows writing into it, Web Service data controls provide array parameters to update multiple records simultaneously. The Siebel Web Service in this example allows writing back to the data source. It provides the MyInsertorUpdate_Input parameter, which is a complex parameter that can be used to populate multiple records at a time. This section describes how to use array parameters to update records in the table. Input Text fields added to the bottom of the page are used to update table columns.

To update records in the table:

1. Edit the task flow and click Add Content.

2. In the catalog, locate the CustData data control and expand it.

3. Add the MyInsertOrUpdate method as an ADF Button.

4. Switch to Source view of the page, select the new button, and click Edit to view its properties.

5. Click the Data tab, and from the context menu on the MyInsertOrUpdate_Input field, select Parameter Structure.

6. In the Parameter dialog, expand MyInsertOrUpdate_Input, ListOfAccountInterface, and Account.

The Account parameter is an array type parameter and therefore displays an Add link.

7. In each row, define a bind parameter value for each column that you want to update, as shown in Figure C-37. For example, #{pageFlowScope.id1} and #{pageFlowScope.alias1} in the first row, and #{pageFlowScope.id2} and #{pageFlowScope.alias2} in the second row.

Tip:

To delete any of the columns you just added, leave the columns empty. Empty columns are deleted before passing the values back as Web Service parameter values.

Figure C-37 Array Parameter Definition in the Parameter Dialog

8. You can update values for two rows, Account[0] and Account[1], by default. Click Add to add more rows.

9. Click OK in the Parameters dialog, then again in the Component Properties dialog.

10. Save and close the task flow.

11. To update values in the table, at the bottom of the page, add one Input Text field for each table cell that you want to update. To do this:

1. Select the task flow in the Resource Manager and click Edit Source from the Edit menu.

2. Copy the source code for the parameter form's inputText component and paste it four times.

3. Change the id attribute value so that each ID is unique.

4. Change the value attribute to contain the values you defined in the Parameters dialog in step 7, for example, #{pageFlowScope.id1}.

Figure C-38 shows the source code for the new components.

Figure C-38 Source Code of the New Input Text Components

12. Optionally, to organize the page components better, group the four inputText components in a Box component.

The task flow is now wired to write back to the data source. Figure C-39 shows how the task flow appears. The first field is wired to the MyQueryById button and the remaining fields are used to provide values for the table. The new values are written to the data source when you click the MyInsertOrUpdate button.

Figure C-39 Task Flow with a Table and Options to Query and Update

C.6 Building and Using a Custom Mashup Style with Predefined Columns

This section describes how to create a custom mashup style in the Resource Manager and use that style to create a task flow. The custom style is designed to list the top five page hits in a Space in a layout similar to the WebCenter Spaces Activity Stream layout. An input text field allows users to specify a Space name to view page hits for that Space.

C.6.1 Building the Custom Mashup Style

As the Resource Manager does not provide a Create option on the Mashup Styles page, the only way to build a new mashup style is by copying an out-of-the-box mashup style and replacing its source code.

To build the custom mashup style:

1. Create a copy of the blank mashup style and name it PageHitsStyle.

2. Edit the source of PageHitsStyle and replace the code on the Fragment tab with the following:

<?xml version='1.0' encoding='UTF-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1"
xmlns:pe="http://xmlns.oracle.com/adf/pageeditor"
xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich">
<af:panelGroupLayout id="pgl1">
<af:panelGroupLayout id="pg2" layout="horizontal" halign="center"
inlineStyle="padding-bottom:5px;">
<af:inputText id="ip1" value="#{pageFlowScope.bindVarId}" label="Space Name"
shortDesc="Enter A Space Name, by default it's all spaces"/>
<af:commandButton text="#{dataComposerBundle.MASHUP_STYLES_GO}" id="cb1"/>
</af:panelGroupLayout>
<cust:panelCustomizable id="pc1">
<table border="0" width="100%">
<af:iterator id="i1" value="#{dataPresenter.dummyData.collectionModel}" var="row">
<tr class="PortletText1">
<td width="12px">
<af:image id="img1" source="/adf/webcenter/star_sm_ena.png"/>
</td>
<td>
<af:outputText id="otCol1" value="#{empty row.USERNAME ? '#{row.USERNAME}' : row.USERNAME}"
inlineStyle="color:#333333; font-size:12px; font-weight:bold;"/>
<af:spacer id="spacer1" width="5px"/>
<af:outputText id="otCol2" value="viewed" inlineStyle="color:#333333; font-size:12px;"/>
<af:spacer id="spacer2" width="5px"/>
<af:goLink id="gl1" destination="{doc path pre fix}#{empty row.DOWNLOAD_URL ? '#{row.DOWNLOAD_URL}' : row.DOWNLOAD_URL}"
targetFrame="_blank" text="#{empty row.DOCNAME ? '#{row.DOCNAME}' : row.DOCNAME}"/>
</td>
</tr>
<tr>
<td/>
<td>
<af:outputText id="otCol3" value="#{empty row.HITS? '#{row.HITS}' : row.HITS}"
inlineStyle="color:#666666; font-size:12px;"/>
<af:spacer id="spacer3" width="5px"/>
<af:outputText id="otCol4" value="TIMES" inlineStyle="color:#666666; font-size:12px;"/>
<af:spacer id="spacer4" width="5px"/>
<af:outputText id="otCol5" value="in the last 7 days" inlineStyle="color:#333333; font-size:12px;"/>
</td>
</tr>
<tr>
<td/>
<td>
<af:outputText id="otCol6" value="Last Visit at " inlineStyle="color:#333333; font-size:12px;"/>
<af:outputText id="otCol7" value="#{empty row.LASTVIEWED ? '#{row.LASTVIEWED}' : row.LASTVIEWED}"
inlineStyle="color:#666666; font-size:12px;">
<af:convertDateTime type="both"/>
</af:outputText>
</td>
</tr>
</af:iterator>
</table>
</cust:panelCustomizable>
</af:panelGroupLayout>
</jsp:root>

where,

#{pageFlowScope.bindVarId} is a reference that provides the input Space name

#{dataPresenter.dummyData.collectionModel} is a dummy reference that gets replaced when you use the mashup style

#{row.COLUMN} are placeholders that will reference data from data controls when the mashup style is used

{doc path pre fix} is the prefix to be used for the document URL. To find the prefix for a document path, select a document on the Documents page and click Get a Link from the View menu. The first part of the Download URL (ending in path) is the prefix to be used. For example, http://my.company.com:8889/webcenter/content/conn/xyz18-ucm11g/path.

If you preview the mashup style, it displays as shown in Figure C-40.

Figure C-40 Preview of the Custom Mashup Style

You can use this mashup style to build mashups that display page hits.

C.6.2 Creating a Task Flow Based on the Custom Style

This section describes how to use the PageHits mashup style to create a mashup that displays page hits in an Activity Stream layout. To illustrate this, you must create a SQL data control using the ActivitiesDS database connection, then consume the data control in a task flow based on the PageHits mashup style. However, to display the data from the data control in an Activity Stream layout instead of the typical table or graph layout, you must perform the following tasks:

- Create a SQL data control.

- Create a task flow based on the new PageHits mashup style.

- Add the data control as a table.

- Copy the data control's accessor ID from the table's properties.

- Hide the table.

- Wire the input text field in the task flow to the data control using the accessor ID.

To use the custom mashup style:

1. Creare a SQL data control, Top Five Viewed Documents in a Given Space, using the ActivitiesDS connection. Specify the following query:

SELECT * FROM
(SELECT users.userid  username, doc.name_  docname,doc.path_  download_url, count(1) hits,max(fact.occurred) lastviewed
FROM asfact_wc_doclib__0 fact , asdim_wc_documen_0 doc , asdim_wc_applica_0 app,asdim_wc_groupsp_0 space , asdim_users users
WHERE app.id = fact.application_
AND app.name_ = 'webcenter'
AND fact.occurred BETWEEN (SYSDATE-7) AND SYSDATE
AND fact.document_ = doc.id
AND doc.name_ is not null
AND doc.id is not null
AND fact.document_ is not null
AND doc.resourceid_ is not null
AND  fact.GROUPSPACE_ = space.id
AND  upper(space.name_) LIKE upper(:spacename)
AND space.name_ IS NOT NULL
AND fact.userid=users.id
GROUP BY users.userid, doc.name_,doc.path_
ORDER BY hits  DESC)
WHERE rownum <= 5
ORDER BY rownum

See Also:

Section C.1.2.1, "Creating the Page Hits Data Control"

2. Set the spacename bind parameter value to Home Space.

3. Select the data control in the Resources Manager and click Show on the Edit menu.

4. Create a task flow, Top Five Viewed Documents in a Given Space, using the PageHits mashup style, as shown in Figure C-41.

Figure C-41 Create New Task Flow Dialog with PageHits Style

5. Edit the task flow and add the data control as a table, as shown in Figure C-42.

Figure C-42 Top Five Viewed Documents in a Given Space

Create a read-only table, and accept the defaults on Items and Columns pages of the Create Table dialog.

On the DC Parameters page, specify the following as the parameter value for spacename:

#{empty pageFlowScope.bindVarId ? '%' : pageFlowScope.bindVarId}

6. To get the accessor ID:

1. Switch to Source view of the task flow, and select the Table component.

2. Click Edit to view the table's properties.

3. In the Component Properties dialog, copy the value of the Value attribute. This is the accessor ID for the data control. The value may be as shown in the following example:

#{bindings.accessor_gsraffebf20_b500_480f_bf92_a9d33922a0a7.collectionModel}

7. Select the showDetailFrame component wrapping the table and click Hide on the context menu.

8. Right-click the iterator component, and click Edit.

9. Replace the value in the Value attribute with the accessor ID you copied from the table's properties.

You now have a task flow with the Activity Stream-like seeded layout.

10. Save the task flow and exit Oracle Composer.

11. In the Resources Manager, select the task flow and click Show on the Edit menu.

12. Consume the task flow in a page. It appears as shown in Figure C-43.

Figure C-43 Page Displaying Top Five Page Hits in a Space

C.7 Building and Using a Custom Mashup style with Date Fields

This section describes how to create a custom mashup style with fields to specify a date range and a content area to display a visualization of data for the specified date range. Figure C-44 shows a task flow created using such a mashup style. This section also describes how to create a task flow using the custom style.

Figure C-44 Task Flow Using Custom Mashup Style with Date Fields

C.7.1 Building the Custom Mashup Style

As the Resource Manager does not provide a Create option on the Mashup Styles page, the only way to build a new mashup style is by copying an out-of-the-box mashup style and replacing its source code.

To build the custom mashup style:

1. Create a copy of the blank mashup style and name it Input Dates.

2. Edit the source of Input Dates and replace the code on the Fragment tab with the following:

<?xml version='1.0' encoding='UTF-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1"
xmlns:pe="http://xmlns.oracle.com/adf/pageeditor"
xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich">
<af:panelGroupLayout id="pgl">
<af:panelGroupLayout id="pg2" layout="horizontal" halign="center" inlineStyle="padding-bottom:5px;">
<af:panelFormLayout id="pfl1" partialTriggers="ipl" inlineStyle="padding-bottom:5px;">
<af:inputDate id="ip1" value="#{pageFlowScope.bindVarId1}" label="Start Date" autoSubmit="true"/>
<af:inputDate id="ip2" value="#{pageFlowScope.bindVarId2}" label="End Date"/>
<af:commandButton text="#{dataComposerBundle.MASHUP_STYLES_GO}" id="cb1"/>
</af:panelFormLayout>
</af:panelGroupLayout>
<cust:panelCustomizable id="pc1" halign="center"/>
</af:panelGroupLayout>
</jsp:root>

The inputDate components provide the two date fields, and the panelCustomizable provides the content area. When previewed, the mashup style appears as shown in Figure C-45.

Figure C-45 Preview of Custom Style with Date Fields

You can use this mashup style to build a mashup and populate the content area with a visualization of your choice.

C.7.2 Creating a Task Flow Based on the Custom Style

This section describes how to use the Input Dates mashup style to create a mashup that displays a graph of the page hits for a specified date range. To illustrate this, you must create a SQL data control using the ActivitiesDS database connection, then consume the data control in a task flow based on the Input Dates mashup style.

To use the custom mashup style:

1. Creare a SQL data control, Page Usage Between Two Dates, using the ActivitiesDS connection. Specify the following query:

SELECT page.name_ pageName, space.name_ spaceName, COUNT(1) hits
FROM asdim_users u, asdim_wc_pages_0 page, asdim_wc_applica_0 app, asdim_wc_groupsp_0 space, asfact_wc_pagevie_0 fact
WHERE
app.name_ = 'webcenter'
AND fact.page_ = page.id
AND fact.userid = u.id
AND fact.application_ = app.id
AND fact.groupspace_  = space.id
AND fact.occurred BETWEEN to_timestamp_tz(to_char(:startdate), :dateformat)
AND to_timestamp_tz(to_char(:enddate), :dateformat)
AND space.name_ IS NOT NULL
AND page.name_ IS NOT NULL
AND space.id IS NOT NULL
AND page.id IS NOT NULL
AND fact.page_ IS NOT NULL
AND page.resourceid_ IS NOT NULL
GROUP BY page.name_, space.name_

The data control is created with the bind variables startdate, dateformat, and enddate.

2. Set the bind parameter values as required, for example, to query the usage of all pages in the year 2010, as shown in Figure C-46.

Figure C-46 Bind Parameter Values for the Data Control

3. Test the query and view the data retrieved from the data source, as shown in Figure C-47.

Figure C-47 Data Control Query Test Results

4. Select the data control in the Resources Manager and click Show on the Edit menu.

5. Create a task flow, Page Usage Between Two Dates, using the Input Dates mashup style, as shown in Figure C-48.

Figure C-48 Input Dates Mashup Style in the Create New Task Flow Dialog

6. Edit the task flow and add the data control as a graph (Figure C-49).

Figure C-49 Graph Option on the Data Control Accessor

- In the Create Graph dialog, on the Type page, choose Bar.

- On the Placement page, place PAGENAME and SPACENAME on the X Axis, and HITS as the Bars.

- On the DC Parameters page, specify the following values for the bind parameters:

startdate:

#{empty pageFlowScope.bindVarId1 ? '01' :
pageFlowScope.bindVarId1.month+1}/#{empty pageFlowScope.bindVarId1 ? '01' :
pageFlowScope.bindVarId1.date}/#{empty pageFlowScope.bindVarId1 ? '2010' :
pageFlowScope.bindVarId1.year+1900}

(01/01/2010 is set as the default initial start date value if no date selected)

dateformat: MM/DD/YYYY

enddate:

#{empty pageFlowScope.bindVarId2 ? '01' :
pageFlowScope.bindVarId2.month+1}/#{empty pageFlowScope.bindVarId2 ? '01' :
pageFlowScope.bindVarId2.date}/#{empty pageFlowScope.bindVarId2 ? '2011' :
pageFlowScope.bindVarId2.year+1900}

(01/01/2011 is set as the default initial end date value if no date selected)

7. Create the graph, save the task flow, then exit Oracle Composer.

8. In the Resources Manager, select the task flow and click Show on the Edit menu.

9. Consume the task flow in a page. It appears as shown in Figure C-50.

Figure C-50 Mashup Showing Graph for Specified Date Range

C.8 Creating a Mashup with a Graph That Is Wired to the Page Navigation

This section describes how to create a sample page that contains a navigation tree and a mashup wired in such a way that clicking a Space name displays the page hits for that Space in the graph, as shown in Figure C-51.

Figure C-51 Mashup with Left Navigation and a Page Hits Graph

The steps to build such a mashup include:

- Section C.8.1, "Creating the Page Hits Data Control"

- Section C.8.2, "Consuming the Data Control in a Page with a Navigation Tree"

C.8.1 Creating the Page Hits Data Control

If you have configured WebCenter Services in your application, an Analytics service connection, ActivitiesDS, is available out-of-the-box. You can use this connection to create a SQL data control. This section describes how to create a data control to view the top five page hits for the last 7 days for a given Space.

To create the data control:

See Also:

Section 26.2.1.2, "Creating the Data Control" for the detailed steps to create a data control.

1. Use the ActivitiesDS connection and create a SQL data control named PageHits.

2. Specify the following SQL query:

SELECT * FROM
(SELECT page.name_ pageName, space.name_ spaceName, COUNT(1) hits
FROM asdim_users u, asdim_wc_pages_0 page, asdim_wc_applica_0 app, asdim_wc_groupsp_0 space, asfact_wc_pagevie_0 fact
WHERE fact.page_ = page.id AND fact.userid = u.id AND fact.application_ = app.id
AND fact.groupspace_ = space.id AND fact.occurred BETWEEN(SYSDATE-6) AND (SYSDATE+1) AND app.name_ = 'webcenter'
AND u.userid <> 'anonymous' AND  upper(space.name_) LIKE upper(:spacename) AND space.name_ IS NOT NULL
AND page.name_  IS NOT NULL AND space.id IS NOT NULL AND page.id IS NOT NULL
AND fact.page_  IS NOT NULL AND page.resourceid_ IS NOT NULL
GROUP BY page.name_, space.name_ ORDER BY hits DESC)
WHERE rownum <= 5 ORDER BY rownum

The data control is created with the spacename bind variable.

3. Set the spacename bind variable to Home space.

4. Test the query and view the data retrieved from the data source, as shown in Figure C-52.

Figure C-52 SQL Data Control Query Test Result

5. Select the data control in the Resource Manager and click Show on the Edit menu.

C.8.2 Consuming the Data Control in a Page with a Navigation Tree

This section describes how to create a navigation tree to list the available Spaces, consume it in a JSPX page, then add the page hits data control to the page.

To create a page with a navigation and page hits graph:

1. Create a page, Top Five Page Views for Given Space Within Past Week, using the Left Narrow page style.

The new page opens in Oracle Composer.

2. Click Page Properties and create a new page parameter, space, with the following value (Figure C-53):

#{empty navigationContext.currentNavigationModel.currentSelection.parameters.space ? 'Space_Name' : navigationContext.currentNavigationModel.currentSelection.parameters.space}

Replace Space_Name with sample1 or the name of any other Space for which you want to display details by default.

Figure C-53 Page Properties Dialog with new Parameter

3. Click OK.

4. Add the PageHits data control accessor as a graph, as shown in Figure C-54.

Figure C-54 Graph Option on the PageHits Data Control Accessor

In the Create Graph dialog, on the Type page, choose Bar.

On the Placement page, place PAGENAME and SPACENAME on the X Axis, and HITS as the Bars.

On the DC Parameters page, wire the data control parameter, spacename, to the page parameter, space, as follows:

#{empty bindings.space ? 'sample1' : bindings.space}

5. In the Resource Manager, create a navigation model called Spaces Navigation with three Link navigation items, Sample1, Sample2, and Sample3, as shown in Figure C-55.

Figure C-55 Navigation Component with Three Link Navigation Items

6. Select Sample1 and click Edit.

7. In the Edit Navigation Item dialog, specify the path to the Top Five Page Views for Given Space Within Past Week page, as shown in Figure C-56.

Figure C-56 Navigation Item Properties Dialog

8. Click the Parameters tab and specify the space parameter value to be Sample1.

9. Similarly, edit the Sample2 and Sample3 links in the navigation model by repeating the previous three steps.

In these steps, you are wiring the same task flow to the three links in the navigation, but by specifying different Space names for each link.

10. Click OK to close the navigation editor.

11. Select Spaces Navigation in the Resource Manager and click Show on the Edit menu.

12. Edit the Five Page Views for Given Space Within Past Week page and add a Navigation Tree component in the left column of the page.

A default navigation displays on the left of the page.

13. Click the Edit icon on the default navigation, as shown in Figure C-57.

Figure C-57 Edit Icon on the Default Navigation Tree Component

14. On the Parameters tab, specify Spaces Navigation in the Navigation field, as shown in Figure C-58, then click OK.

Figure C-58 Navigation Tree Component Properties Dialog

15. The new navigation model now displays on the left side of the page, as shown in Figure C-59.

Figure C-59 Navigation Model with Space Name Links

16. Click Save and Close to exit page edit mode.

17. When you view the page, it displays the navigation tree and the graph as shown in Figure C-60.

Figure C-60 Mashup with Left Navigation and Page Hits Graph for Sample1

18. Click a different Space in the navigation to view the page hits graph for that Space, as shown in Figure C-61.

Figure C-61 Mashup with Left Navigation and Page Hits Graph for Sample2

C.9 Creating a Mashup with a Graph that Is Wired to the Inherited Page Navigation

The previous example described how to create a graph of page hits for a given Space and wire it to a page containing a navigation tree. Taking this one step further, this section describes how to wire the page hits graph to the navigation tree inherited from a page template.

The steps to build such a mashup include:

- Section C.9.1, "Creating the Page Hits Data Control"

- Section C.9.2, "Consuming the Page Hits Data Control"

- Section C.9.3, "Creating and Applying a Custom Page Template"

- Section C.9.4, "Testing the Wiring Between the Page Hits Graph and the Inherited Navigation"

C.9.1 Creating the Page Hits Data Control

Perform the steps in Section C.8.1, "Creating the Page Hits Data Control."

C.9.2 Consuming the Page Hits Data Control

This section describes how to consume the data control in a task flow, then consume the task flow in a page that displays the inherited navigation tree.

To consume the data control:

1. Create a task flow, Top Five Page Views for Given Space Within Past Week, using the Blank mashup style.

2. Add the PageHits data control accessor as a graph.

In the Create Graph dialog, on the Type page, choose Bar.

On the Placement page, place PAGENAME and SPACENAME on the X Axis, and HITS as the Bars.

On the DC Parameters page, set the data control parameter, spacename, to the following:

#{empty pageFlowScope.spacename ? 'home space' : pageFlowScope.spacename}Click Create.

3. Click Task Flow Properties and create a string parameter, spacename, in pageFlowScope, as shown in Figure C-62.

Figure C-62 New Parameter in the Taskflow Properties Dialog

4. Click Save and Close to exit edit mode.

5. Select the task flow in the Resource Manager and click Show on the Edit menu.

6. Create a page, Sample8b, and add the new task flow inside the page.

This ensures that the task flow displays the page hits graph for the Home Space by default.

C.9.3 Creating and Applying a Custom Page Template

This section describes how to create a custom navigation component and a page template containing a navigation tree, and how to apply the new page template.

To create a custom navigation component:

1. In the Resource Manager, create a navigation model called Spaces Navigation with three Link navigation items, Sample1, Sample2, and Sample3, as shown in Figure C-63.

Figure C-63 Navigation Component with Three Link Navigation Items

2. Select Sample1 and click Edit.

3. In the Edit Navigation Item dialog, specify the path to the Top Five Page Views for Given Space Within Past Week page, as shown in Figure C-64.

Figure C-64 Navigation Item Properties Dialog

4. Click the Parameters tab and specify the space parameter value to be Sample1.

5. Similarly, edit the Sample2 and Sample3 links in the navigation model by repeating the previous three steps.

In these steps, you are wiring the same task flow to the three links in the navigation, but by specifying different Space names for each link.

6. Click OK to close the navigation editor.

7. Select Spaces Navigation in the Resource Manager and click Show on the Edit menu.

To create and apply a custom page template:

1. Create a custom page template, Sample Template, based on the out-of-the-box Side Navigation – Flow template.

2. Add a Navigation Tree component to the template.

A default navigation displays on the left of the page.

3. Click the Edit icon on the default navigation, as shown in Figure C-65.

Figure C-65 Edit Icon on the Default Navigation Tree Component

4. On the Parameters tab, specify Spaces Navigation in the Navigation field, then click OK.

The new navigation model now displays on the left side of the template, as shown in Figure C-66.

Figure C-66 Custom Page Template with a Navigation Tree

5. Click Save and Close to exit page edit mode.

6. Select the new template in the Resource Manager and click Show on the Edit menu.

7. Navigate to the Spaces administration page, then click the Configuration tab.

8. On the General page, in the Default Page Template field, select the new sample template that you created (Figure C-67), then click Apply.

Figure C-67 Default Page Template Configuration

The navigation tree in the template now displays on all application pages.

C.9.4 Testing the Wiring Between the Page Hits Graph and the Inherited Navigation

To verify that the graph is wired to the navigation correctly:

1. Open the page, Sample8b.

It displays the navigation tree and the page hits graph for the home Space, as shown in Figure C-68.

Figure C-68 Page Hits Graph for Sample1 Selected in the Navigation

2. Click a different Space in the navigation to view the page hits graph for that Space, as shown in Figure C-69.

Figure C-69 Page Hits Graph for Sample2 Selected in the Navigation

C.10 Creating a Master-Detail Mashup that Contains a Google Maps Task Flow

This section describes how to create a mashup that displays two task flows wired in a master-detail relationship so that a selection in the master task flow results in an update to the Google Map address in the details task flow, as shown in Figure C-70.

Figure C-70 Mashup Displaying a Table and Google Map

The steps to create a similar mashup include:

- Creating a SQL data control to retrieve static data for the purpose of the demo.

- Creating a master task flow that consumes this data control as a static table.

- Adding hyperlinks in the user names column in the table.

- Creating a details task flow to integrate the latest Google Maps API Version 3.

- Wiring the master and detail task flows so that clicking a record in the master table results in a location change in the Google Map.

This section describes how to perform these tasks. It includes the following subsections:

- Section C.10.1, "Creating the Data Control"

- Section C.10.2, "Creating the Details Task Flow"

- Section C.10.3, "Creating the Master Task Flow"

- Section C.10.4, "Wiring the Master and Details Task Flows"

C.10.1 Creating the Data Control

For the purpose of this example, create a data control to get address data using select * from dual statements. You can use any existing data source connection to create the data control. In real time, you must replace it with the required SQL data source connection. To create the data control:

1. Create a SQL data control, addresses, using any available database connection, and specify the following query:

SELECT 'Steve' Buddy, 'Palo Alto' City, 'CA' State
FROM dual
UNION
SELECT 'Doris' Buddy, 'Belmont' City, 'CA' State
FROM dual
UNION
SELECT 'John' Buddy, 'New York' City, 'NY' State
FROM dual
UNION
SELECT 'Lily' Buddy, 'Boston' City, 'MA' State
FROM dual

2. Select the new data control in the Resource Manager, and from the Edit menu, click Show.

C.10.2 Creating the Details Task Flow

This section describes how to create a details task flow that will display the Google map.

To create the details task flow:

1. Create a task flow, Basic Maps, based on the Blank mashup style.

2. Select the task flow and click Edit Source on the Edit menu.

3. Replace the code on the Fragment tab with the following:

<?xml version='1.0' encoding='UTF-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1"
xmlns:pe="http://xmlns.oracle.com/adf/pageeditor"
xmlns:cust="http://xmlns.oracle.com/adf/faces/customizable"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
xmlns:trh="http://myfaces.apache.org/trinidad/html">
<af:resource type="javascript" source="http://maps.google.com/maps/api/js?sensor=true"/>
<af:resource type="javascript">
var geocoder;
var map;
function initialize(){
geocoder = new google.maps.Geocoder();
var latlng = new google.maps.LatLng(37.529526, -122.263969);
var myOptions = {
zoom: 3,
center: latlng,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
map = new google.maps.Map(document.getElementById("map_canvas"),myOptions);
}
function navigate(event) {
initialize();
var city= event.getSource().getProperty('city')+"";
var state= event.getSource().getProperty('state')+"";
var address;
if(city== "undefined"||state== "undefined"||city== "NULL"||state== "NULL"){
address="CA, USA";
} else {
map.setZoom(8);
address=city+" "+state+" USA";
}
geocoder.geocode( { 'address': address}, function(results, status)
{
if (status == google.maps.GeocoderStatus.OK) {
map.setCenter(results[0].geometry.location);
var marker = new google.maps.Marker({
map: map,
position: results[0].geometry.location
});
}
else {
alert("Geocode was not successful for the following reason: " + status);
}
});
}
</af:resource>
<af:panelGroupLayout id="pgl1">
<af:group id="g1">
<div id="map_canvas" style="width: 600px; height: 600px"/>
</af:group>
<af:inlineFrame source="">
<af:clientListener type="inlineFrameLoad" method="navigate"/>
<af:clientAttribute name="city" value="#{empty pageFlowScope.city? '' : pageFlowScope.city}"/>
<af:clientAttribute name="state" value="#{empty pageFlowScope.state ? '' : pageFlowScope.state}"/>
</af:inlineFrame>
</af:panelGroupLayout>
</jsp:root>

The code in bold, <af:inline>, calls the navigate Google Map javascript method each time the page is loaded, and it parses two pageFlowScope parameters to the navigate method to update the address on the map.

4. Click OK to exit the source editor.

5. Ensure that the task flow is selected in the Resource Manager and click Edit on the Edit menu.

6. Click Task Flow Properties and create two string task flow parameters, city and state, in pageFlowScope, as shown in Figure C-71.

Figure C-71 New Parameters on the Basic Maps Task Flow

C.10.3 Creating the Master Task Flow

This section describes how to create the master task flow to consume the addresses data control as a table and the Basic Maps task flow.To create the master task flow:

1. Create a task flow, Address on Google Maps, based on the Blank mashup style.

2. Edit the task flow and add the Basic Maps task flow, as shown in Figure C-72.

Figure C-72 Basic Maps Task Flow in the Resource Catalog

3. Add the Address on Google Maps data control accessor as a read-only table with row selection enabled.

The master task flow displays the addresses table on top and the map below it, as shown in Figure C-73.

Figure C-73 Master-Detail Task Flow with Table and Google Map

C.10.4 Wiring the Master and Details Task Flows

This section describes how to wire the master and details task flows so that a user can click a name in the table to show the corresponding location in the map.To wire the master and details task flows:

1. Click the Edit icon on the Basic Maps task flow.

2. In the Component Properties dialog, modify the values for the two task flow parameters, city and state, as follows:

city: #{empty dataComposerViewContext.dataSelection.CITY ? 'NULL' : dataComposerViewContext.dataSelection.CITY}

state: #{empty dataComposerViewContext.dataSelection.CITY ? 'NULL' : dataComposerViewContext.dataSelection.CITY}

3. To hide the header on the map, click the Display Options tab and clear the Display Header checkbox.

4. Click the Advanced link on the Display Options tab, then set Stretch Content to Auto.

This ensures that the map displays a scroll bar only when required.

5. Click OK to save your changes.

The map displays the location corresponding to the currently selected name in the table.

6. Click Save and Close to exit edit mode.

The task flow displays as shown in Figure C-74.

Figure C-74 Master-Detail Task Flow with Table and Google Map

7. Optionally, you can change the layout of the task flow so that the table displays to the left of the map. To refine the layout of the master task flow:

1. 1.Edit the source of the master task flow, and on the Fragment tab, replace the following lines:

<af:panelGroupLayout id="pgl1">
<cust:panelCustomizable id="pc1">

with

<af:panelGroupLayout id="pgl1" layout="horizontal" valign="top">
<cust:panelCustomizable id="pc1" layout="vertical" valign="top">

2. Move the end tag of </cust:panelCustomizable> to the right, after the first </showDetailFrame> tag and before the second <showDetailFrame> tag.

3. To disable default selection in the table, remove the selectedRowKeys attribute on the <table> tag.

4. To ensure that the map stretches when required, change the columnStretching attribute to last.

8. To test the master-detail task flow further, create a page and add the Address on Google Maps task flow to it.

Edit the task flow on the page and set the Stretch Content option to auto.

Note:

To ensure that the page reflects your recent changes, you may need to directly use the URL to open the page afresh, as against clicking the Refresh button.

The task flow displays as shown in Figure C-75.

Figure C-75 Mashup Displaying a Table and Google Map

Click a name in the table; the map points the location corresponding to that name.

C.11 Creating a Mashup with a Customized RSS Feed OmniPortlet

This section describes how to create a mashup with an OmniPortlet instance that displays live, scrolling news information to users from a Really Simple Syndication (RSS) news feed, such as Oracle Technology Network Headlines. It also describes how to share the portlet across WebCenter Spaces instances.

Registering the Producer

To consume an OmniPortlet in a task flow, you must first register the portlet producer with the application. For the detailed steps, see Section 6.5, "Registering Portlet Producers."

C.11.1 Creating a Task Flow with an OmniPortlet

To create a mashup with an Omniportlet instance:

1. Create a new task flow based on the Blank mashup style.

2. Add the Omniportlet to the task flow from the Resource Catalog, shown in Figure C-76.

Figure C-76 OmniPortlet in the Resource Catalog

3. Click the Customize icon on the top right corner of the portlet header, shown in Figure C-77.

Figure C-77 Customize Icon on the OmniPortlet Header

See Also:

Section 27.2, "Working with the OmniPortlet Wizard" for detailed information.

4. On the Type page of the OmniPortlet wizard, shown in Figure C-78, choose XML as the data source type, then click Next.

Figure C-78 OmniPortlet Wizard Type Page

5. On the Source page, specify the XML URL and the XSL Filter URL to be the following, as shown in Figure C-79:

XML URL: http://www.oracle.com/technology/syndication/rss_otn_news.xml

XSL Filter URL: http://www.oracle.com/technology/products/ias/portal/viewlets/omniportletnews.xsl

Figure C-79 Source Page of the OmniPortlet Wizard

6. In the Portlet Parameters section, define a new parameter, Display Num, as shown in Figure C-80, then click Next.

Figure C-80 Portlet Parameters Section of the OmniPortlet Wizard Source Page

7. On the Filter page, shown in Figure C-81, set the filter limit to ##Param1##, then click Next.

Figure C-81 Limit Section on the Filter Page of the OmniPortlet Wizard

8. On the View page, in the Layout Style section, select News, as shown in Figure C-82.

Figure C-82 Layout Style Section on the View Page of the OmniPortlet Wizard

9. On the Layout page, under the Column Layout section, use two fields to specify a title and description as shown in Figure C-83.

Figure C-83 Column Layout Section on the Layout Page of the OmniPortlet Wizard

10. Click Finish to exit the wizard.

11. Click Save and Close to exit Oracle Composer.

12. Select the new task flow in the Resource Manager, and from the Edit menu, click Show.

C.11.2 Testing the Task Flow

To verify that the portlet in the task flow renders correctly:

1. Preview the task flow or consume it in an application page.

The portlet displays ten news items.

2. Click the Personalize icon, shown in Figure C-84, on the top right corner of the task flow.

Figure C-84 Personalize Icon on the Task Flow Header

3. In the resulting screen, shown in Figure C-85, change the value of the Display Num variable to a number of your choice.

Figure C-85 Portlet Parameter Customization Screen

The portlet displays the specified number of news items.

C.11.3 Sharing the Task Flow with the Customized Portlet

You can share the task flow containing the portlet with another WebCenter Spaces instance by exporting it from your instance and importing it in that instance. However, the imported task flow renders the portlet only if the producer for the OmniPortlet is registered with the same name on the other instance also.

To share the task flow with another WebCenter Spaces instance:

1. On the target instance, register the OmniPortlet producer with the same name that was used for the producer registration on your instance.

For the detailed steps, see Section 6.5, "Registering Portlet Producers."

2. Export the task flow from the Resource Manager on the source instance.

For the detailed steps, see Section 10.5.2, "Downloading a Resource."

3. Import the task flow in the Resource Manager of the target instance. For the detailed steps, see Section 10.5.3, "Uploading a Resource."

The portlet is now available with all customizations made on the source instance.

Glossary

About mode

A portlet mode that typically displays information such as copyright, version, and author of the portlet.

Activity Stream

In the People Connections service, a feature for viewing the application activities tracked for you and other users.

Activity Graph

A WebCenter service that provides suggestions of people, items, and spaces that users may be interested in interacting with.

The engine used by the Activity Graph service to provide a central repository for actions that are collected by enterprise applications. The data stored in the activity graph is analyzed to calculate ranks for nodes, predict new actions, and make recommendations.

Activity Rank

Determines the relevance of a search result.

ADF

Application Development Framework. A range of technologies aimed at making Java EE application development faster and simpler for developers while at the same time taking advantage of proven software patterns to ensure that the developed application is scalable, performant, and the like.

administrator

In WebCenter Spaces there are two types of administrator:

- Fusion Middleware administrator: Also referred to as systems administrator. A user with complete administrative capabilities. This administrator can perform the complete range of security-sensitive administrative duties, and all installation, configuration, and audit tasks.

- WebCenter Spaces administrator: A WebCenter Spaces user who is responsible for customizing WebCenter Spaces out of the box, managing and granting application roles, and maintaining the application when it is in use.

Ajax

A combination of asynchronous JavaScript, dynamic HTML (DHTML), XML, and XmlHttpRequest communication channel that enables requests to be made to the server without fully re-rendering the page. Ajax enables rich client-like applications to use standard internet technologies.

Analytics service

The Analytics service offers real-time usage and activity reporting for your portal. In WebCenter Spaces, users can track and analyze WebCenterSpaces traffic and usage.

Announcements service

A WebCenter service that offers a quick, convenient way to create and widely distribute messages instantly or at a specific time.

APD

AviTrust Portal Demo. An enterprise application built using Oracle Fusion Middleware, including Oracle WebCenter, used to provide examples of WebCenter functionality.

API

Application Programming Interface. A set of exposed data structures and functions that an application can use to invoke services on an application object, such as a portlet.

application customization

Performed by an administrator, all users see the change. These are static changes to an application that affect a site or sites that do not involve changes to the application's code or schema.

See also user customization and personalization

Application Development Framework

See ADF.

Application Programming Interface

See API.

application role

Roles that are specific to a particular application and are stored in an application-specific stripe of the policy store.

application skin

Specifies the WebCenter Spaces application background color, screen fonts, and, with some skins, the shapes and images used for application buttons and icons. The WebCenter Spaces administrator chooses the default application skin. WebCenter users may change the application skin on the General tab of the Preferences dialog.

application templates

WebCenter provides templates for creating two kinds of applications: WebCenter Portal applications and WebCenter Portlet Producer applications. Templates ensure that the right technology scopes are set, tag libraries added, and required Java classes are added to the class path. Once you do this, relevant components are included to the Component Palette and relevant context menus become available in JDeveloper.

authenticated user

A user who is logged into a WebCenter Portal application. Credentials of this user are verified against the identity store. By default, an authenticated user can access public information. To access secured information, such as pages and portlets, this user must be authorized through the policy and credential store.

Contrast with public users, who are not logged in, and can access public content only.

authentication

Identification of a user through an identity management system. You can require ADF authentication to enforce credentials for users to access the WebCenter application only (all ADF resources in the application remain accessible), or authentication and authorization to enforce credentials for users to access the WebCenter application and any ADF resources that have been secured in the application.

authorization

The policies that define the access rights of an individual or group to a secured resource. This resource may be a page or component within a page.

authorized user

An individual who has access to a secured resource. For non-public resources, this individual is also an authenticated user.

blog page

A page that provides a personal record of an individual user's experience and opinions. There are two kinds of blog: personal blogs are written by an individual; group blogs are written by several users.

Box layout component

An Oracle Composer layout component. A container that enables the placement of content on a WebCenter Spaces page. In Oracle Composer, a Box is rendered as a rectangle comprised of dashed lines. For designers of WebCenter portal applications, this is the runtime equivalent of a Panel Customizable component.

BPEL

Business Process Execution Language. An XML-based markup language for composing a set of discrete web services into an end-to-end process flow.

business role page

A page, created by the WebCenter Spaces administrator, specifically provided for a given role in an organization. Business role pages provide a targeted environment for users of a particular role by delivering information that is timely and relevant to individual roles without the noise of irrelevant information from other lines of business. Business role pages appear in the personal Spaces of users classified under the specified role.

caching

The act of storing frequently accessed information, typically web pages, in a location where it can be accessed quickly to avoid frequent content generation.

See also expiry-based caching and validation-based caching.

calendar overlay

The ability to display multiple calendars in a single Events task flow.

Change Mode Button component

A component provided in the Oracle Composer tag library that enables users to change from page View mode to page Edit mode.

Change Mode Link component

A component provided in the Oracle Composer tag library that enables users to change from page View mode to page Edit mode.

check out/check in

A mechanism that enables a user to lock information, by checking it out, so that other users cannot modify that same piece of information. This prevents users from overwriting each other's changes. After making modifications, the user releases it by checking it back in, making it available again for other users to modify.

Child Components

The components contained within a parent component. For example, the task flows contained within a Box layout component are the child components of the Box.

See also Box layout component and parent component.

chrome

Visual elements surrounding a portlet or task flow that provide an access point for actions, such as those on the Actions menu and those embedded in the chrome itself, such as the minimize icon or resize handles.

CMIS

Content Management Interoperability Services (CMIS) standard defines a domain model and Web services and Restful AtomPub bindings that can be used by applications to work with one or more Content Management repositories or systems.

component

An individual piece of an application, for example, a task flow, portlet, page, or layout element such as a box or image.

Component Catalog

A dialog, accessed from Oracle Composer, that provides access to all the content you can add to a WebCenter application page.

component developer

The developer who builds components (such as portlets, JavaServer Faces components, and web services).

Component Properties

A dialog, accessed from Oracle Composer, that provides access to a component's parameters, display options, child components, style settings, and associated events.

Connections

In the People Connections service, a feature for establishing a social network with other application users.

container

An application program or subsystem in which the program building block, known as a component, is run.

container runtime option

A JSR 286 feature that provides a way to customize the behavior of the portlet container and therefore customize the runtime environment.

content integration services

Services provided by Oracle WebCenter to enable developers to display content from a content repository, such as by creating data controls.

Content Presenter

A feature of the Documents service that enables end users to select and search content items and then display those items using available display templates. Oracle WebCenter provides out-of-the-box templates for displaying single and multiple content items on your pages. You can also define custom templates for the content that you want to display in your WebCenter Portal application, or for selection by end users at runtime.

content repository

A specialized storage and management mechanism that provides such features as author-based versioning, full text searching, and content categorization and attribution. A content repository is optimized for storing unstructured information, which differentiates it from a data repository.

content repository data control

A data control sourced though a content repository. In a WebCenter Portal application, you can create content repository data controls for the following content repositories: Oracle Portal, Oracle Universal Content Management, third-party repositories that support the Java Content Repository (JCR) standard, and your local file system.

credential provisioning page

A JSF (*.jspx) page used for authenticating to an external application. At runtime, the Credential Provisioning page displays login data fields consisting of the data fields specified through external application registration. Login information is passed to the producer, which in turn passes the login values to the external application. The application provides the producer with the requested portlets.

After authentication, the user's login credentials are preserved in a credential store, which subsequently supplies that information at future sessions. Unless his information changes, the user supplies his credentials only one time.

credential store

Provides storage for login credentials for its associated domain. It also preserves the login credentials that a user provides for authentication to an external application. Credential store is usually combined with the policy store as a single logical store.

Although the credentials stored in the credential store are used during subsequent logins for authentication, the main function of this store is to provide authorization for those accounts.

CSS

Cascading Style Sheet. A simple mechanism for ensuring a consistent look and feel or adding style, such as fonts, colors, and spacing, to web documents.

custom action

Icons or menu items rendered on the header or the Actions menu of a Show Detail Frame component surrounding a task flow. Custom actions can represent actions that were defined in the task flow when it was created. For example, at design time a developer can build a task flow with custom personalization settings. At runtime, users can access these settings through icons or Actions menu items provided in the task flow's surrounding chrome (or Show Detail Frame).

custom attribute

Specifies Space information in addition to that provided by the built-in attributes. Custom attributes can be used to determine the content of the components in a Space based on the parameter passed in. For example, a component can display data for a specific customer by passing in the customer ID. A custom attribute is simply a name value pair, for example customerId=400, orderId=11, userName=Smith, and so on. Custom attributes are stored within the Space template.

custom page

Any page created by a user rather than one provided out of the box.

custom display template

A Content Presenter display template is a JSFF file (JSF page fragment) that defines how Content Presenter renders content items on a WebCenter application page. WebCenter provides several out-of-the-box display templates to get you started, or, you can create your own templates.

custom resource catalog

A resource catalog that has been customized to control the components that are visible to specific users.

Contrast with default resource catalog.

custom role

A user role created by an administrator or a Space moderator to meet a specific Home Space or Space requirement.

Customize mode

A portlet mode that enables users to set the default values for portlet preferences for all users.

customizable component

A WebCenter component that can be added to a page at runtime to enable end users to perform personalizations such as move, minimize, restore, or remove on content within those components. Customizable components are the Panel Customizable component and the Show Detail Frame component.

data control

A mechanism that provides an abstraction of the business service's data model. The ADF data controls provide a consistent mechanism for clients and web application controllers to access data objects, collections, methods, and operations.

default language (application-level)

A display language specified by the WebCenter Spaces administrator that is used when users log in to WebCenter Spaces. The WebCenter Spaces administrator sets the application-level default language on the General tab of the Administration page. Individual users can set their own user-level default language on the General tab of the Preferences dialog.

default language (user preference)

A user-specified display language that is rendered when the user logs in to WebCenter Spaces. This language selection lasts until the user specifies a different default language. It can be overridden by a session language, but returns as the default when the session cookie is purged or expires. This value is set on the General tab of the Preferences dialog.

default resource catalog

The resource catalog that is provided by default for an application. It contains all of the Oracle ADF components and portlets available to the application.

Contrast with custom resource catalog.

Default Server

See Integrated WLS.

delegated administration

Provides a mechanism for securing portal resources based on user roles. You apply delegated administration to a page hierarchy, and the specific security assignments are automatically propagated down through the hierarchy through pages and sub pages.

deployment profile

A file used in application deployment that specifies the following types of information:

- The source files, deployment descriptors, and other auxiliary files that are packages

- The type and name of the archive file to be created

- Dependency information

- Platform-specific instructions

- Other information

WebCenter services provides a special deployment profile, the WebCenter Portal application WAR deployment profile, that includes an option to export project metadata.

Design view (JDeveloper)

A view, in Oracle JDeveloper, that provides a WYSIWYG representation of a file.

See also Source view (JDeveloper).

Design view (WebCenter Spaces)

A view, in Oracle Composer, that provides a WYSIWYG representation of a page and its components.

See also Source view (WebCenter Spaces).

discoverable Space

A Space that can be found by anyone logged into WebCenter Spaces, for example through a search. Any Public or Private Space is discoverable. Discoverable Spaces are listed on the Spaces page when All Spaces is selected from the Show list. Users wishing to join the Space can request membership through self-service (if enabled) or by contacting the Space moderator.

Discussions service

A WebCenter service that provides a means of creating and participating in text-based discussions with members of a particular Space.

display language

Controls the language in which application user interface elements, such as buttons, field labels, and screen text, are rendered in the browser. The order of precedence for WebCenter application display language settings from weakest to strongest is: browser setting, application setting, user preference setting, session setting, Space setting.

Documents page

A predefined page provided in every WebCenter Spaces group and Home Space that includes the Document Manager task flow for managing content.

Documents service

A WebCenter service that provides several task flows that offer a variety of formats to display folders and files on a page. You can choose the task flows appropriate for your application to provide features for accessing, adding, and managing folders and files; configuring and viewing file and folder properties; and searching file and folder content in the connected content repositories.

domain

Any tree or subtree within the Domain Name System (DNS) namespace. Domain most commonly refers to a group of computers whose host names share a common suffix: the domain name.

dynamically-generated page

A page that displays as the result of a user action, such as a search or a click on a tag. As the name suggests, dynamically-generated pages are not stored, but rather are created as and when needed.

EAR

Enterprise Archive file. A Java EE archive file that is used in deploying applications on a Java EE application server. WebCenter Portal applications are deployed using both a generic EAR file, which contains the application and the respective runtime customization, and a targeted EAR file, which contains only the application for deployment to the application server. EAR files simplify application deployment by reducing the possibility of errors when moving an application from development to test, and test to production.

See also WAR.

ECMA-262 specification

A standardization of scripting programming languages, such as ECMAScript and JavaScript.

ECMAScript

A scripting programming language, standardized by Ecma International according to the ECMA-262 specification. Frequently referred to as JavaScript or JScript, which are both extensions of the ECMA-262 specification.

Edit Defaults mode

(JSR 286 portlets only.) A portlet mode that enables personalization of a JSR 286 portlet. Edit Defaults mode is a display mode for the JSR 286 portlet's properties. In a WebCenter Portal application, the Edit Defaults mode displays on the portlet's Actions menu as the Customize command.

See also Edit mode.

Edit mode

A portlet mode that enables personalization of the portlet for each user, for each instance.

See also Edit Defaults mode.

edit mode

A view mode that enables users to modify the content, style, and layout of a page. Access edit mode by choosing Edit Page from the Page Actions menu.

EL

Expression Language. Provides a shorthand way of working with web application data by providing operators for retrieving and manipulating application data residing in a Java EE web container. In a WebCenter Portal application, EL expressions are encapsulated in the characters "#{" and "}" and typically come in the form #{object.data} where object represents any Java object or ADF component placed in the Java EE web container's page, request, session, or application's scope.

Enterprise Archive file

See EAR.

enterprise mashup

An application that enables users to bring all sorts of content and services together in a single place.

Events service

A WebCenter service that provides calendars for scheduling meetings, appointments, and so on. In WebCenter Spaces, the service provides calendars in Spaces to record events relevant to the specific Space. You can also integrate the Events service with Microsoft Exchange Server to enable individual users to access their personal calendars in their Home Space. Personal calendars are also available in WebCenter portal applications.

expiry-based caching

A caching method that uses a retention period to specify how long the item is valid in the cache before a refresh is required. When there is a request for the item beyond the retention period, it is refreshed in the cache.

See also validation-based caching.

Expression Language

See EL.

external application

Applications that do not delegate authentication to the single sign-on server. Instead, they display HTML login forms that ask for application user names and passwords. At the first login, users can choose to have the single sign-on server retrieve these credentials for them. Thereafter, they are logged in to these applications transparently.

farm

A collection of components managed by Fusion Middleware Control. A farm can contain a Managed Server domain and other Oracle Fusion Middleware system components that are installed, configured, and running on the domain.

favorites

A personal list of links to favorite WebCenter Spaces pages and external web sites.

Federated Portal Adapter

See FPA.

Feedback

In the People Connections service, a feature for posting informal appraisals for and receiving informal appraisals from other application users.

FPA

Federated Portal Adapter. A component of Oracle Portal that enables Oracle Portal instances to share their database portlets through the web portlet interface. Using the FPA, Oracle Portal database portlets, including PL/SQL portlets, Portlet Builder portlets, and page portlets can be made available for use in WebCenter applications.

Full Screen mode (Portlets)

(PDK-Java portlets only.) A portlet mode that provides more content than can be shown in the portlet when it is sharing a page with other portlets.

Fusion Middleware Control

A browser-based management application that is deployed when you install Oracle WebCenter. From Fusion Middleware Control, you can monitor and administer a farm (such as Oracle WebCenter).

Fusion Order Demo (FOD)

See APD.

HA

High Availability. A collection of solutions to ensure that your applications meet the required availability to achieve your business goals, eliminating single points of failure with no or minimal outage in service.

Help mode

A portlet mode that displays usage information about the functionality of the portlet.

High Availability

See HA.

Home Space

A work area within WebCenter Spaces that provides individual users with a private Space for storing personal content, keeping notes, viewing and responding to assignments, maintaining a list of online buddies, and performing many other tasks relevant to their unique working day. Users can also extend this environment by creating additional personal pages and custom content.

HTML Markup layout component

An Oracle Composer layout component. A simple HTML component that renders raw HTML and JavaScript mark-up inline on the page.

Hyperlink layout component

An Oracle Composer layout component. A link to an internal or external web page. For designers of WebCenter portal applications, this is the runtime equivalent of a Go Link component.

IDE

Integrated Development Environment. A visual application development tool containing editors, debuggers, screen painters, object browsers, and the like. Oracle JDeveloper is an example of an IDE.

Identity Propagation

For a WebCenter Portal application and associated content repositories, selecting this option allows propagation of current user's identity across the application and processes. The propagated identity is verified on the receiver's side, and then it is used to make decisions such as assigning role based access control.

Image layout component

An Oracle Composer layout component. An illustration that can include a hyperlink. For designers of WebCenter portal applications, this is the runtime equivalent of an Image Link component.

IMP service

See Instant Messaging and Presence service.

initialization parameters

The parameters initialized upon the start-up of a standard JSR 286 portlet. Initialization parameters provide an alternative to JNDI (Java Naming and Directory Interface) variables. Use initialization parameters instead of JNDI to configure the behavior of all of the different components of the portlet—for example, servlets and other portlets—in a compatible way. In Oracle WebCenter, initialization parameters are entered into the portlet.xml file.

Instant Messaging and Presence service

A WebCenter service that enables users to observe the presence status of other authenticated users and provides instant access to interaction options, such as instant messages, emails, and phone calls.

Integrated Development Environment

See IDE.

Integrated WLS

Integrated WebLogic Server. A WLS instance used as a platform for pretesting WebCenter application deployments on a local computer. Integrated WLS also contains preconfigured portlet producers and several useful prebuilt portlets.

Iterative development

Iterative development lets you make changes to your WebCenter Portal application while it is running on the Integrated WebLogic Server and immediately see the effect of those changes simply by refreshing the current page in your browser. The iterative development feature works by disabling certain optimization features. Iterative development allows developers to work more quickly and efficiently when building a portal application.

JAAS

Java Authentication and Authorization Service (JAAS) is a Java package that enables applications to authenticate and enforce access controls upon users. JAAS is designed to complement Java 2 security and implements a Java version of the standard Pluggable Authentication Module (PAM) framework. This enables an application to remain independent from the authentication service, and supports the use of custom authentication modules.

JAAS extends the access control architecture of the Java 2 Security Model to support subject-based authorization. It also supports declarative security settings in deployment descriptors instead of being limited to code-based security settings.

Java Authentication and Authorization Service

See JAAS.

Java Content Repository

See JCR 1.0.

Java EE

Also known as Java EE 5. Java Enterprise Edition 5 Platform. A platform that enables application developers to develop, deploy, and manage multitier, server-centric, enterprise-level applications. The Java EE platform offers a multitiered distributed application model, integrated XML-based data interchange, a unified security model, and flexible transaction control. You can build your own Java EE portlets and expose them through web producers.

Java Enterprise Edition 5 Platform

See Java EE.

Java Portlet Specification

Standardizes how components for portal servers are to be developed. This specification defines a common portlet API and infrastructure that provides facilities for personalization, presentation, and security. Portlets using this API and adhering to the specification are product-agnostic, and can be deployed to any portal product that conforms to the specification. See also JSR 286.

Java Specification Request

See JSR 286.

JavaServer Faces

See JSF.

JavaServer Page

See JSP.

JCR 1.0

Java Content Repository 1.0. Also known as JSR 170. It proposes a standard access and interaction API for content repositories, much like JDBC does for databases.

JDeveloper

See Oracle JDeveloper.

JSF

JavaServer Faces. A standard Java framework for building web applications. It simplifies development by providing a component-centric approach to developing Java web user interfaces. JSF offers rich and robust APIs that provide programming flexibility and ensures that applications are well designed with greater maintainability by integrating the Model-View-Controller (MVC) design pattern into its architecture. As JSF is a Java standard developed through Java Community Process, development tools like Oracle JDeveloper are fully empowered to provide easy to use, visual, and productive development environments for JSF.

JSF JSP

JavaServer Faces JavaServer Page. JSF JSPs differ from plain JSPs through their support of Oracle ADF Faces components for the user interface and JSF technology for page navigation. JSF JSP pages leverage the advantages of the Oracle Application Development Framework (Oracle ADF) by using the ADF Model binding capabilities for the components in the pages.

JSP

JavaServer Page. An extension to servlet functionality that provides a simple programmatic interface to web pages. JSPs are HTML pages with special tags and embedded Java code that is executed on the web or application server. JSPs provide dynamic functionality to HTML pages. They are actually compiled into servlets when first requested and run in the servlet container.

See also JSP tags.

JSP tags

Tags that can be embedded in JSPs to enclose Java code. These tags use the <jsp: syntax and enclose action elements in the JSP with begin and end tags similar to XML elements.

JSR 286

Java Specification Request (JSR) 286. Defines a set of APIs for building standards-based portlets using Java. Portlets built to this specification can be rendered to a portal locally or deployed to a WSRP container for rendering portlets remotely. For more information, see http://jcp.org/en/jsr/detail?id=286.

JSR 170

See JCR 1.0

JSR 329

See Oracle JSF Portlet Bridge.

keystore

A file that provides information about available public and private keys that are used for authentication and data integrity. User certificates and the trust points needed to validate the certificates of peers are also stored securely in the keystore.

layout box

A container that enables placement of content on a WebCenter Spaces page.

layout component

An object for enhancing the usefulness and appearance of a given page. Layout components include layout boxes, a rich text editor, images, hyperlinks, and so on.

Layout Customizable component

A component provided in the Oracle Composer tag library that enables users to select from a set of predefined layouts (for example, two column, three column, two row, and so on) and apply it to the page. Users can apply these layouts to a particular area of the page or to the entire page.

LDAP

Lightweight Directory Access Protocol. A standard, extensible directory access protocol. It is a common language that LDAP clients and servers use to communicate. The framework of design conventions supporting industry-standard directory products, such as the Oracle Internet Directory.

life cycle

See portal application life cycle.

Lightweight Directory Access Protocol (LDAP)

See LDAP.

Links service

A WebCenter service that provides a means of creating a bidirectional association between two objects, thus setting up easy access between those objects.

Lists service

A WebCenter service that provides a means of creating lists and exposing them for placement on application pages at runtime. At design time, you can make the Lists task flow available in your runtime Resource Catalog. At runtime, users can add the task flow from the Catalog to a page and use the task flow to create lists.

Lists page

A predefined page that displays the Space's current lists.

Look and feel

A look and feel file determines the appearance of your portal application, from the placement and behavior of elements on a portal page to the colors used in the portlet title bars. The look and feel is determined by skins, navigations, page templates, layouts, content display templates, and other similar components.

Mail service

A WebCenter service for exposing familiar email functionality in WebCenter applications.

Managed Server

In a production environment, a Managed Server hosts applications and the resources needed by those applications. A domain, which is a logically related group of Oracle WebLogic Server resources, can have any number of Managed Servers. An Administration Server manages these servers.

mashup

A web application that enables end users to pull information from different sources to create a personalized application that exactly meets their individual requirements.

See also enterprise mashup.

MBean Browser

In Fusion Middleware Control, MBean browsers enable the administrator to perform specific monitoring and configuration tasks and browse MBeans for an Oracle WebLogic Server or a selected application.

MDS

Oracle Metadata Services. A core technology of the Application Development Framework. MDS provides a unified architecture for defining and using metadata in an extensible and customizable manner.

MDS repository

An application server and Oracle relational database that keep metadata in these areas: a file-based repository, dictionary tables accessed by build-in functions, and a metadata registry. One of the primary uses of MDS is to store customizations and persisted personalization for Oracle applications.

Message Board

In the People Connections service, a feature for posting messages to and receiving messages from other application users.

metadata

Information about a content item, such as title, author, or security group. Metadata is used to describe, find, and group content items. Also referred to as content information.

Model-View-Controller

See MVC.

moderator

A WebCenter Spaces user who is responsible for managing a particular Space. A Space moderator can add and remove members, invite new members, enable self registration, provide and update Space metadata, and manage the services available to the Space.

Movable Box layout component

An Oracle Composer layout component. A container that enables the placement of content on a WebCenter Spaces page. Movable Boxes, along with their content, can be moved around on the page. For designers of WebCenter portal applications, this is the runtime equivalent of Show Detail Frame component.

MVC

Model-View-Controller. A classic design pattern often used by applications that need the ability to maintain multiple views of the same data. The MVC pattern hinges on a clean separation of objects into one of three categories: models for maintaining data, views for displaying all or a portion of the data, and controllers for handling events that affect the model or views. Because of this separation, multiple views and controllers can interface with the same model. Even new types of views and controllers that never existed before, such as portlets, can interface with a model without forcing a change in the model design.

My Spaces page

A predefined page that displays a list of all the Spaces available to the currently logged in user. The user can select from the Show menu to display All Spaces, only Spaces of which the user is a member (Joined by Me), or only Spaces of which the user is the moderator (Moderated by Me).

navigation

WebCenter provides three navigation components to create portal navigation. These components are: Breadcrumb navigation, menu navigation, and tree navigation.

navigation model

Navigation models provide data to the navigation user interface and enable navigation to resources in your application, such as pages, page hierarchies, task flows, external sites, portlets, and other entities. You can configure navigation models at both design time and runtime.

Notes service

A WebCenter service that provides useful features for writing personal notes and reminders. This service is available only in WebCenter Spaces, and not in WebCenter portal applications.

Notifications service

A WebCenter service that provides an automated means of triggering notices across different messaging channels, such as phone, mail, Worklist, and so on. Messages are triggered when the Spaces and application objects to which you have subscribed change.

OAM

See Oracle Access Manager (OAM).

OHS

See Oracle HTTP Server (OHS).

OmniPortlet

A component of Oracle WebCenter that enables you to inject portal-like capabilities, such as portlets, content integration, and customization, into your Oracle ADF Faces applications.

Oracle Access Manager (OAM)

Part of Oracle's enterprise class suite of products for identity management and security, Oracle Access Manager provides a wide range of identity administration and security functions, including several single sign-on options for WebCenter Spaces and WebCenter portal applications. OAM is the recommended single sign-on solution for Oracle WebCenter 11g installations.

Oracle ADF Faces

Oracle ADF Faces is a rich set of user interface components based on the new JavaServer Faces JSR (JSR 127). Oracle ADF Faces provide various user interface components with built-in functionality, such as data tables, hierarchical tables, and color and date pickers, that can be customized and reused in an application.

Oracle Composer

A seamlessly integrated environment for populating, revising, and configuring WebCenter application pages. It enables users to easily build or revise page layout and content. It also provides the means of adding different components, such as task flows, portlets, content, and other objects, onto a page and then linking those components for a more relevant or personalized view of the information.

Oracle Content Server

A content repository for building secure business libraries with check in and check out, revision control, and automated publishing in web-ready formats. Current information is available to authorized users anytime, anywhere.

Oracle Content Server is a component of Oracle Universal Content Management.

Oracle WebCenter Discussions Server

Enables integration of discussion forums and announcements into WebCenter application.

Oracle Enterprise Manager

A component that enables administrators to manage Oracle Fusion Middleware services through a single environment. The Fusion Middleware administrator uses Enterprise Manager to configure, manage, and monitor WebCenter applications.

Oracle HTTP Server (OHS)

Software that processes web transactions that use the Hypertext Transfer Protocol (HTTP). Oracle uses HTTP software developed by the Apache Group.

Oracle Internet Directory

Oracle's LDAP V3 compliant LDAP server. It is used as a repository for provisioning users and groups. By default, the Oracle Single Sign-On (OSSO) authenticates user credentials against Oracle Internet Directory information about dispersed users and network resources. Oracle Internet Directory combines LDAP version 3 with the high performance, scalability, robustness, and availability of the Oracle database.

Oracle JDeveloper

Oracle JDeveloper is an integrated development environment (IDE) for building applications and web services using the latest industry standards for Java, XML, and SQL. Developers can use Oracle JDeveloper to create Java portlets.

Oracle JSF Portlet Bridge

Based on and conforming to JSR 329, the Oracle JSF Portlet Bridge enables application developers to expose a JSF application or task flow as a JSR 286 portlet for consumption in another application.

Oracle Metadata Services

See MDS.

Oracle Portal

A component used for the development, deployment, administration, and configuration of enterprise class portals. Oracle Portal incorporates a portal building framework with self-service publishing features to enable you to create and manage information accessed within your portal.

See also Oracle WebLogic Portal.

Oracle SES

Oracle Secure Enterprise Search (SES) provides easy-to-use search for public and secure data. It is included with Oracle WebCenter. You can override the default search adapters in WebCenter Spaces and use Oracle SES, which provides unified ranking results. The results are listed together, instead of being clustered into separate sections for Documents, Discussions, and so on, with the most relevant items appearing first.

Oracle Single Sign-On (OSSO)

A component that enables users to log in to all features of the Oracle Fusion Middleware product suite, and to other web applications, using a single user name and password.

Oracle Site Studio

A powerful, flexible web development application suite that offers a comprehensive approach to designing, building, and maintaining enterprise-scale web sites. Site Studio uses Oracle Content Server as the main repository for a web site.

In WebCenter, Content Presenter integrates with Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template.

Oracle SOA Suite

A middleware component of Oracle Fusion Middleware. Oracle SOA Suite enables services to be created, managed, and orchestrated into SOA composite applications. Composites enable you to easily assemble multiple technology components into one SOA composite application. Oracle SOA Suite plugs into heterogeneous infrastructures and enables enterprises to incrementally adopt SOA.

Oracle Technology Network

See OTN.

Oracle Universal Content Management

A consolidated content management application that provides multisite web content management, document management, digital asset management and records management.

Oracle WebCenter

A suite of services that enables you to build WebCenter portal applications. Oracle WebCenter reduces the front-end labor historically required to bring necessary business components to the user by capitalizing on the notion of Service Oriented Architecture (SOA). The suite includes a wide range of plug-and-play products, tools, and services that make it easy to build the applications your users need. Oracle WebCenter includes:

- WebCenter services

- Oracle WebCenter Framework

- content integration services

- ADF

- Oracle SES

- Oracle WebCenter Discussions Server

- Mobile Services

- Portlet Pack

Oracle WebCenter Framework

A set of features provided by Oracle WebCenter that augments the Java Server Faces (JSF) environment by providing additional integration and runtime customization options. It integrates capabilities historically included in portal products, such as site navigation, page hierarchies, portlets, customization, personalization, and integration, directly into the fabric of the JSF environment. This eliminates artificial barriers for the user and provides the foundation for developing context-rich applications. You can selectively add only desired Oracle WebCenter components or services to your WebCenter application.

Oracle WebCenter Pagelet Producer

Provides a collection of useful tools and features that facilitate dynamic pagelet development.

Oracle WebLogic Server Administration Console

A browser-based, graphical user interface to manage a WebLogic Server domain. Use to:

- Configure, start, and stop WebLogic Server instances

- Configure WebLogic Server clusters

- Configure WebLogic Server services, such as database connectivity (JDBC) and messaging (JMS)

- Configure security parameters, including creating and managing users, groups, and roles

- Configure and deploy your applications

- Monitor server and application performance

- View server and domain log files

- View application deployment descriptors

- Edit selected run-time application deployment descriptor elements

Oracle WebCenter Wiki and Blog Server

Supports integration of wikis and blogs into WebCenter applications. It also supports features that enable application users to create their own wikis and blogs.

OTN

Oracle Technology Network. The online Oracle technical community that provides a variety of technical resources for building Oracle-based applications. You can access OTN at http://www.oracle.com/technetwork.

Oracle WebLogic Portal

WebLogic Portal enables you to provide a user interface to integrate your applications. WebLogic Portal lets you surface application data and functionality from heterogeneous environments into an integrated, dynamic, and customizable web-based portal user interface that can simultaneously support multiple devices. In addition to a powerful portal framework and its J2EE security foundation, WebLogic Portal provides many business services, such as content management, communities, personalization, search, and user management. WebLogic Portal provides a virtual content repository that lets you federate external content management systems into a single management interface. You can then build portals using content in those external resource. WebLogic Portal also provides a WLP content repository for creating and managing content.

Page Customizable component

A component provided in the Oracle Composer tag library that defines the editable area of a page at runtime. Within this area, users can edit properties for a component, add content to the page, arrange content, and so on.

page hierarchy

A model that associates pages in a parent-child relationship, where any page can have one or more sub pages. This parent-child model not only helps define the overall structure of the portal, but also allows child pages to inherit the security policies from their parent.

page parameter

A parameter associated with a page that can be used to store values that can then be passed to the components on the page. It also enables your page to take values through its URL. Page parameters are defined using the <parameter> tag at the top of your PageDef.xml. You can bind page parameters to your page variables.

Page Properties

A dialog, accessed from Oracle Composer, that provides access to a page's display options, security settings, and parameters.

page scheme

Determines the background image used in the page. WebCenter Spaces provides several default page schemes and an option for specifying a custom page scheme.

page style

Determines the initial page structure, for example one column or two column. Some default page styles also include the task flows, components, and page properties useful for a particular purpose. For example, a page created using the Text page style includes a Text layout component.

page template

Lets you specify view elements that you intend to be common to all of your pages. A page template file is a JSPX file that includes ADF layout components and other elements. Typically, page templates define a page layout, with headers, footers, and content areas. In addition, the page template usually specifies the positioning and style of the navigation UI for your pages.

page variable

A variable that binds your public portlet parameter to the page. Page variables are defined within the <variableIterator> of your PageDef.xml. One page variable can be bound to multiple public portlet parameters.

Panel Customizable component

A component provided in the Oracle Composer tag library that provides a container region for a group of Oracle ADF components and portlets that are customizable at runtime. Any Show Detail Frame components and portlets added as child components to a Panel Customizable component can be moved or maximized with the Panel Customizable component.

parameter

A variable that controls the default behavior of task flow content and facilitates the wiring of a task flow to page parameters and page definition variables.

parent component

A component that contains other components, such as a Box layout component that contains task flows. The Box is the parent component of the task flows. In contrast, the task flows are the Box's child components.

See also Child Components.

participant

A WebCenter Spaces user who can manipulate the content of a Space. A participant can upload and share documents, initiate and take part in chats with other members, create discussion topics, create new or view existing lists.

PDK-Java

Java Portlet Developer Kit. The development framework used to build and integrate web content and applications with Oracle WebCenter. It includes toolkits, samples, and technical articles that help make portal development simple. You can take existing Java servlets, JSPs, URL-accessible content and web services and turn them into portlets. It is typically used by external developers and vendors to create portlets and services.

People Connections service

A WebCenter service that provides social networking tools for creating, interacting with, and tracking the activities of one's enterprise connections.

See also, Activity Stream, Connections, Feedback, Message Board, and Profile.

personalization

Dynamic changes to an application's behavior based on user context, facilitated by the WebCenter personalization services.

See also application customization and user customization

Personalization service

A WebCenter service that enables you to deliver content within your application to targeted application users based on selected criteria. WebCenter Personalization also provides a declarative means for specifying dynamic application flow.

personal page

A page created by a user in his or her Home Space. Personal pages are viewable by other users only if specifically granted access by the user who created the page.

personal profile

A page that displays a user's personal information such as email address, phone number, office location, department, manager, direct reports, and so on.

See also, Profile.

Polls service

A WebCenter service that enables you to create, edit, and take online polls on your application pages. Polls let you survey your audience (such as their opinions and their experience level) and check whether they can recall important information, and gather feedback on the efficacy of presentations.

portal

A common interface (that is, a web page) that provides a personalized, single point of interaction with web-based applications and information relevant to individual users or class of users.

portal application life cycle

The process of creating and testing a portal application in a design time environment, deploying it to a production system, and then performing routine maintenance, such as monitoring performance and migrating customization data. The life cycle of an application also includes performing further enhancements, restaging, and then redeploying the application to the production system.

portal application template

See application templates.

Portal Developer Kit

See PDK-Java.

portlet

A reusable web component that can draw content from many different sources. Portlets can display excerpts of other web sites, generate summaries of key information, perform searches, and access assembled collections of information from a variety of data sources. Because different portlets can be placed on a common page, the user receives a single-source experience, even though the content may be derived from multiple sources. Portlet resources include the many prebuilt portlets available out of the box and programmatic portlets built through WebCenter's JSR 286, PDK-Java Portlet wizards, and other portlet building tools.

portlet event

A JSR 286 feature that allows portlets to react to actions or state changes not directly related to an interaction of the user with the portlet.

portlet filter

A JSR 286 feature that allows on-the-fly transformations of information in both the request to and the responses from a portlet. A portlet filter is a reusable piece of code that can transform the content of portlet requests and portlet responses.

portlet mode

The ways by which a portlet can be called to display information. These methods include:

- Shared Screen mode or View mode

- Edit mode or Edit Defaults mode

- Customize mode

- Help mode

- About mode

- Full Screen mode (Portlets) or Show Details Page mode

Portlet Producer Application template

An application template, provided by JDeveloper, for creating an application with the recommended projects and technology scopes required for developing portlets. The Portlet Producer Application template consists of a single project scoped for portlet creation (Portlets).

See also WebCenter Portal Application template and producer.

predefined page

A page created by WebCenter Spaces to perform a specific function. Examples of predefined pages include, Welcome pages, Search pages, and Documents pages.

Predeployment Tool

A utility for WebCenter Portal applications that assists you in configuring your target system with the new producer registrations you have added to your application in Oracle JDeveloper. You must run this utility before deploying your application. You can also use this utility after deployment to migrate metadata from stage to production, for example, to export and import your customizations. This tool also enables you to define the MDS repository location to allow run-time customizations to be migrated.

pretty URL

A shortened version of a page's URL that hides the complexity of the real web address.

private parameter

A portlet parameter that is known only to the portlet itself and has no connection to the page on which the portlet resides.

Contrast with public parameter.

producer

A communication link between portlet consumers (such as a WebCenter Portal application or a portal). When a consumer application renders a portlet, it calls the producer of that portlet, which in turn executes the portlet and returns the results in the form of portlet content. A producer can contain one or more portlets. A portlet can be contained by only one producer.

Oracle WebCenter supports two types of producers:

- Oracle PDK-Java producers: Deployed to a Java EE application server, which is often remote and communicates through Simple Object Access Protocol (SOAP) over HTTP.

- Web Services for Remote Portlets (WSRP): A web services standard that enables the plug-and-play of visual, user-facing web services with portals or other intermediary web applications. Being a standard, WSRP enables interoperability between a standards-enabled container based on a particular language (such as JSR 286, .NET, Perl) and any WSRP portal. A portlet (regardless of language) deployed to a WSRP-enabled container can be rendered in any application that supports this standard.

Profile

In the People Connections service, a feature for viewing and managing information about yourself, such as your contact information, manager, and direct reports, and for viewing this information about other application users.

programmatic portlets

Portlets constructed in a non-declarative manner using APIs. Also referred to as hand- or manually-coded portlets.

public render parameters

A JSR 286 feature that enables portlets to share parameter values, allowing a form of interportlet communication.

public Space

A Space that is available to all users, even those who are not logged in to WebCenter Spaces.

public page

A page within WebCenter Spaces that is available to all users, even those who are not logged in to WebCenter Spaces.

public parameter

A portlet parameter that is known to the page and bound to it by way of a page variable.

Contrast with private parameter.

public user

A user who can access, but is not logged into, a WebCenter Portal application. A public user can view any page that has been marked as public, but cannot personalize or edit any content, or view pages that have any form of access control.

Contrast with authenticated user.

Recent Activities service

A WebCenter service that provides a means of tracking recent activities in a WebCenter application.

recipe

A weighted list of similarity calculations. The weighting of each calculation determines its significance in deciding the overall recommendation score. Recommendations are ordered by their total recommendation score.

resize handle

A user interface element in a task flow chrome increasing or decreasing the height of the task flow.

resource

Items users can manage through the Resource Manager, like page templates, skins, task flows, navigations, and so on. WebCenter Spaces categorizes resources under the following categories: Structure, Look and Layout, and Mashups.

Resource Action Handling framework

Enables services that expose custom resources to be viewed, searched, and tagged.

Resource Catalog

A catalog that provides a federated view of one or more otherwise unrelated repositories in a unified search and browse user interface. Resources are created and published in their source repository and are then exposed to the developer in JDeveloper's Resource Palette and to the end user in the Resource Catalog Viewer. Resource catalogs can contain layout components, Oracle ADF components, portlets, service task flows, and documents.

Resource Index

The starting point for accessing WebCenter REST APIs. Sending a GET request to the Resource Index URI returns a list of links to entry points for all available services.

Resource Manager

Enables users with the appropriate privileges to continue developing the portal after the application has been deployed. Using the Resource Manager users can also download runtime portal resources (from WebCenter portal applications and WebCenter Spaces) and import them into Oracle JDeveloper for further development. These resources can then be exported from JDeveloper and uploaded back into the deployed application.

resource type

Defines the type of resource that a WebCenter REST API link identifies. Use resource types to determine the response bodies for GET requests and allowable request bodies for POST and PUT. Also use resourceType attributes on entities to uniquely identify their type.

REST APIs

Oracle WebCenter provides a set of web-based REST (REpresentational State Transfer) APIs for retrieving and modifying server data dynamically from the client. REST APIs are available for Discussions service, People Connections service, and WebCenter Spaces.

Reverse Proxy Server

A server process that hides the physical location of internal servers by exposing the servers as a single public site. Requests to the public site are routed to the appropriate internal server.

Round-trip development

Round-trip development refers to features and techniques that allow you to retrieve resources from a deployed, runtime portal back to JDeveloper for maintenance or enhancement. After modifying a resource in JDeveloper, you can use the Resource Manager to upload the resource back to the deployed portal. WebCenter's round-trip development features provide a simple, convenient way to modify portal resources without redeploying the entire application.

RSS service

A WebCenter service that provides a means of publishing content from other services as news feeds. The RSS service supports both RSS 2.0 and Atom 1.0 formats.

Search page

A predefined page for running searches, creating and managing saved searches, and viewing and refining search results.

Search service

A WebCenter service that enables the discovery of information and people in a WebCenter application, returning only the results users are authorized to see

Secure Enterprise Search

See Oracle SES.

secured application page

A page created by a user that has not been made available to public users.

Self-Registration page

A predefined page where users can register with WebCenter Spaces, thus creating themselves an identity store login account. Administrators can customize certain aspects of this page.

Self-Subscription page

A predefined page where users can register to become members of a Space. Moderators can customize certain aspects of this page.

service ID

In Expression Language, the string that identifies a particular service. For example, the string oracle.webcenter.collab.announcement is the service ID for the Announcements service.

A PDK-Java producer's unique identifier. PDK-Java enables you to deploy multiple producers under a single adapter servlet. Different producers are identified by their unique service IDs. A service ID is required only when a service ID/producer name is not appended to the URL endpoint.

Service Oriented Architecture

See SOA.

servlet

A Java program that usually runs on a Web server, extending the web server's functionality. HTTP servlets take client HTTP requests, generate dynamic content (such as through querying a database), and provide an HTTP response.

session language

A display language specified by the user that remains in effect for the life of the session cookie (from log on to log off). If the user clears browser cookies, the display language reverts to the user-level default language, if specified, then to the application-level default language set by the WebCenter Spaces administrator. Set the session language in the Change Language pop-up, accessible from the Welcome page.

Shared Screen mode

A portlet mode that renders the body of the portlet and enables you to display a portlet on a page that can contain other portlets. Every portlet must have at least a Shared Screen mode.

See also View mode.

Show Detail Frame component

A component provided in the Oracle Composer tag library that renders a border or chrome around the child component. It provides a header with an Actions menu and thereby providers user interface (UI) controls to customize the display of the child component. However, to customize the display of the child component, the Show Detail Frame component must be included inside a Panel Customizable component.

Show Details Page mode

A portlet mode that provides full-browser display of the portlet. For example, a portlet in Show Page mode could be limited to displaying only the ten most recently submitted expense reports, while the same portlet in Show Details Page mode could show all submissions.

Contrast with Show Page mode.

show modes

Types of portlet modes encompassing Show Page mode and Show Details Page mode.

Show Page mode

A portlet mode that provides a smaller portlet display to allow space for additional portlets and other objects in the browser window. For example, a portlet in Show Page mode could be limited to displaying only the ten most recently submitted expense reports, while the same portlet in Show Details Page mode could show all submissions.

Contrast with Show Details Page mode.

similarity calculation

Used by the Activity Graph service to provide a similarity score (a number between zero and one) that designates how similar two objects are to each other given a specific criterion. The weighting of each calculation determines its significance in deciding the overall recommendation score. Recommendations are ordered by their total recommendation score.

skin

A style sheet based on the CSS 3.0 syntax specified in one place for an entire application. Instead of providing a style sheet for each component, or inserting a style sheet on each page, you can create one skin for the entire application.

SOA

Service Oriented Architecture. A design methodology aimed at maximizing the reuse of application services.

Source view (JDeveloper)

A view, in Oracle JDeveloper, that provides a way to directly edit the source code of a file.

Source view (WebCenter Spaces)

A view, in Oracle Composer, that provides a selectable structural representation of a page and its components.

See also Design view (WebCenter Spaces).

Space

A work area within WebCenter Spaces that supports a group of people of any size that is organized around an area of interest or a common goal.

Space icon

An image displayed alongside Space names on the Spaces page in My Spaces to help other users with identification and location.

Space logo

An image displayed on the Home Space page to provide a visual identity for the Space. The Home Space logos also display alongside the Space name at the top of the page in Full Screen Mode.

Space member

A user who is participating in a Space. Members can be added or invited to a Space, or they can subscribe to a Space themselves if self-registration is enabled.

Space owner

A user who initially created a Space. The Space owner is automatically also a moderator of the Space.

Spaces Switcher

A menu showing three areas: Recent Spaces lists up to ten recently accessed Spaces, followed by Spaces to which current user most recently gained access. My Spaces lists all Spaces to which the current user has access, in alphabetical order. A list of links provides direct access from the menu to the Home Space, the Spaces browser page, and the Create a Space dialog.

Space template

A starting point for creating a new Space. WebCenter Spaces includes several out-of-the-box templates to get you started, and you can create custom Space templates using existing Spaces as the basis.

Space Unavailable page

A predefined page that displays when a Space member tries to open a Space that is temporarily offline. Moderators can customize this page.

struts

A development framework for Java servlet applications based upon the MVC design paradigm.

style properties

Used to override the style information from the skin CSS to set specific instances of component display.

Tags service

A WebCenter service that enables users to apply their own terms to application objects, making it possible to search for those objects using personally meaningful terms.

task flow

A set of ADF Controller activities, control flow rules, and managed beans that interact to allow a user to complete a task. Task flows provide a modular approach for defining control flow in an application. Instead of representing an application as a single JSF page flow, developers can break it up into a collection of reusable task flows.

task flow header

An area at the top of a task flow that displays the task flow name and various tools for interacting with the task flow.

template

See Space template, application templates, and custom display template.

Text layout component

An Oracle Composer layout component. A rich text editor for providing static page text. For designers of WebCenter portal applications, this is the runtime equivalent of a Rich Text Editor component.

Unauthorized Access page

A predefined page that is shown when someone without access permission tries to open a page.

Universal Content Management

Provides a flexible, secure, centralized, web-based repository that manages all phases of the content life cycle: from creation and approval to publishing, searching, expiration, and archival or disposition. It enables contributors to easily contribute content from native desktop applications, efficiently manage business content through rich library services, and securely access that content anywhere using a web browser. All content, regardless of content type, is stored in the web repository or database for management, reuse and access.

URL parameter

See private parameter.

user customization

Changes that affects only a user's own work space.

See also application customization and personalization

validation-based caching

A caching method that uses a validation check to determine if the cached item is still valid.

Contrast with expiry-based caching.

Virtual Content Repository

Virtual Content Repository (VCR) enables you to plug in multiple, heterogeneous content repositories.

viewer

WebCenter Spaces users who can look at the information in a Space but cannot contribute any of their own.

View mode

(JSR 286 portlets only.) A portlet mode that enables you to display a JSR 286 portlet on a page that can contain other portlets. It is the only required mode for JSR 286 portlets.

See also Shared Screen mode.

WAR

Web application archive file. This file is used in deploying applications on a Java EE application server. WAR files encapsulate in a single module all of the components necessary to run an application. WAR files typically contain an application's servlet, JSP, and JSF JSP components.

See also EAR.

Web 2.0

Technologies, such as wiki, RSS, and blogs, that enable the construction of highly interactive web applications.

See also WebCenter services.

Web Application Archive file

See WAR.

Web Clipping portlet

A browser-based declarative tool that enables you to integrate any web application with your WebCenter Portal application. It is designed to give you quick integration by leveraging the web application's existing user interface. You can drag and drop Web Clipping portlets onto a *.jspx page.

Web Page layout component

An Oracle Composer layout component. A means of embedding another web site, wiki, or blog within the context of a WebCenter Spaces page. For designers of WebCenter portal applications, this is the equivalent of an Inline Frame component.

Web server

A program that delivers web pages.

Web Services for Remote Portlets

See WSRP.

WebCenter

See Oracle WebCenter.

WebCenter Portal application

A WebCenter Portal application is built on top of the ADF using the WebCenter Extension for Oracle JDeveloper. This application combines web content, portlets, content integration, and collaborative services for the end user. Developers and administrators can create a WebCenter Portal application based on their roles and skill levels in the organization.

A portal also includes page hierarchies, navigation models, and delegated administration.

WebCenter portal application administrator

The administrator responsible for maintaining the WebCenter Portal application. For example, in WebCenter Spaces, the administrator performs tasks such as implementing the branding for the WebCenter application, making new content available, modifying pages, and granting and revoking privileges.

Contrast with systems administrator who has administrative rights for entire Fusion Middleware functions. The Fusion Middleware administrator is also responsible for deploying, setting up, and configuring the WebCenter application, and performing on-going administrative tasks for the WebCenter application and other WebCenter components through Fusion Middleware Control.

WebCenter portal application developer

The developer who plans, builds, and maintains a WebCenter Portal application using the Oracle Application Development Framework, Oracle JDeveloper, and Oracle WebCenter.

WebCenter portal application end user

The WebCenter portal application end user is the runtime user of the WebCenter Portal application, who accesses pages, portlets, and content, and personalizes portlets (assuming the appropriate privileges).

WebCenter Extension for Oracle JDeveloper

An extension available through the Oracle JDeveloper Update Wizard that installs the necessary libraries, templates, wizards, and dialogs needed to build and deploy WebCenter Portal applications in Oracle JDeveloper.

WebCenter Framework

See Oracle WebCenter Framework.

WebCenter Portal Application template

An application template that enables developers to generate default projects with unique technology scopes, libraries, and default files. Additionally, it limits the types of options that are exposed in the JDeveloper user interface to those appropriate to portal projects. The WebCenter Portal Application template includes portal framework features like site navigation, page hierarchies, delegated administration, and page templates.

See also Portlet Producer Application template.

WebCenter services

A collection of Web 2.0 services that expose social networking and personal productivity features through various services.

- Activity Graph

- Announcements service

- Analytics service

- Discussions service

- Documents service

- Events service

- Instant Messaging and Presence service

- Links service

- Lists service

- Mail service

- Notes service

- Notifications service

- People Connections service

- Personalization service

- Polls service

- Recent Activities service

- RSS service

- Search service

- Tags service

- Worklist service

WebCenter Spaces

A web-based application that offers the very latest technology for social networking, communication, collaboration, and personal productivity. WebCenter Spaces uses services and applications to bring everything together that users require to exchange ideas with others, keep track of personal and work-related tasks, interact with critical applications, and zero in on projects and interests; all within a single integrated environment.

WebCenter Spaces is a WebCenter Portal application.

WebCenter Spaces application administrator

See administrator.

WebCenter Spaces RSS reader

An RSS reader provided with WebCenter Spaces that incorporates public news feeds from external sources onto application pages. This RSS reader is available only in WebCenter Spaces, and not in WebCenter portal applications.

WebCenter systems administrator

See administrator.

WebLogic Server

See WLS.

Welcome page

There are two types of Welcome page:

- Public Welcome page: A predefined page that users encounter before logging in to WebCenter Spaces.

- Personal Welcome page: A predefined page that introduces users to their Home Space.

wiki page

A page that provides in-place editing using HTML or a simple mark-up language. Any user with sufficient privileges can add, revise, and remove wiki content.

WLS

WebLogic Server. A scalable, enterprise-ready Java Platform, Enterprise Edition (Java EE) application server. The WebLogic Server infrastructure supports the deployment of many types of distributed applications and is an ideal foundation for building applications based on Service Oriented Architectures (SOA).

See also Integrated WLS

WLST

WebLogic Scripting Tool. A command line tool for managing Oracle Fusion Middleware components, such as Oracle WebCenter.

Worklist service

A WebCenter service that provides access to notifications, alerts, and BPEL tasks assigned to the current user.

WSRP

Web Services for Remote Portlets (WSRP) is a web services standard that allows the plug-and-play of visual, user-facing web services with portals or other intermediary web applications. Being a standard, WSRP enables interoperability between a standards-enabled container based on a particular language (such as JSR 286, .NET, Perl) and any WSRP portal. A portlet (regardless of language) deployed to a WSRP-enabled container can be rendered on any portal that supports this standard.

XSL

Extensible Stylesheet Language (XSL) is the language used within style sheets to transform or render XML documents.

Index

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  R  S  T  U  V  W  X

A

About Space Spaces component, 13.2.2

About WebCenter Spaces component, 13.2.3

access settings, Space template, 50.3.4

accessibility settings, 35.4

Accordion View display template, 40.5

action handlers, 17.5.2.8

Actions property, 17.5.2.8

Activities business role page, 7.1.1

Activity Graph service

about, 58.1

configuration, 58.1

extending, 58.1

task flows

adding to a page, 58.2.1

Recommended Connections, 58.1

Similar Items, 58.1

Similar Spaces, 58.1

Activity Stream

about, 32.1

archiving, 6.4.4

commenting

on application object, 34.2

on streamed item, 32.4.6

Comments option, 6.4.3.2

configuring, 6.4.3.2

hiding

activities of a Space, 32.4.5

activities of a user, 32.4.4

Likes option, 6.4.3.2, 32.4.6, 34.1

Options link, 32.4.1, 32.4.2, 32.4.3, 32.4.4, 32.4.5

People options, 6.4.3.2

preferences, 32.2

Privacy options, 6.4.3.2, 6.4.3.2

properties

about, 32.5.1

Hide Header, 32.5.2

selecting

services to stream, 32.4.3

Spaces to stream, 32.4.2

whose activities to stream, 32.4.1

Service Categories options, 6.4.3.2

sharing streamed items, 32.4.7, 34.3.2

by reposting, 34.3.2.1

through mail, 34.3.2.2

through Publisher, 34.3

showing

hidden Space activities, 32.4.5

hidden user activities, 32.4.4

Spaces options, 6.4.3.2

task flows

about, 32.1

customization, application, 32.4

customization, user, 32.4

properties, 32.5, 32.5.2

tracked activities, 6.4.3.2, 32.1

Announcements, 6.4.3.2, 32.1

Blogs, 6.4.3.2, 32.1

Connections, 6.4.3.2, 32.1

Discussions, 6.4.3.2, 32.1

Documents, 6.4.3.2, 32.1

Events, 6.4.3.2, 32.1

Feedback, 6.4.3.2, 32.1

Lists, 6.4.3.2, 32.1

Message Board, 6.4.3.2, 32.1

Pages, 6.4.3.2, 32.1

Profiles, 6.4.3.2, 32.1

Spaces management, 6.4.3.2, 32.1

Tags, 6.4.3.2, 32.1

troubleshooting, 6.4.5.1

Activity Stream - Quick View task flow

about, 32.1

parameters

Hide Configuration Button, 32.5.2, 32.5.4.1

Hide Footer, 32.5.2

No of activities to display per page, 32.5.2

Profile User Id, 32.5.2

Service Categories, 32.5.4.7

Spaces, 32.5.4.6

Activity Stream system page, 7.3.1

Activity Stream task flow

about, 32.1

Advanced Query Filter, 32.5.3

about, 32.5.3.1

activity type names, 32.5.3.1

entering, 32.5.3.2

examples, 32.5.3.1

supported database objects, 32.5.3.1

parameters

Advanced Query, 32.5.2

Enable Context Info, 32.5.2

Hide Comments, 32.5.2, 32.5.4.3

Hide Configuration Button, 32.5.2, 32.5.4.1

Hide Inline Preview, 32.5.2, 32.5.4.2

Hide Like, 32.5.2, 32.5.4.4

Hide Share, 32.5.2, 32.5.4.5

No of activities to display per page, 32.5.2

Pagination, 32.5.2

Profile Only, 32.5.2, 32.5.4.8

Resource Id, 32.5.2

Service Categories, 32.5.2, 32.5.4.7

Spaces, 32.5.2, 32.5.4.6

Add to Favorites menu action, 41.5.2.1

Add to Favorites Spaces component, 13.2.4

ADF Faces skins, using, 5.7

Administration pages

business role pages, 7

General page, 4.2

Pages page, 4.2

personal pages, 7

Resources page, 4.2

Security page, 4.2

Spaces page, 4.2

system pages, 7

Administration Spaces component, 13.2.5

Administrator role, 20.3.1.1

assigning, 21.1.4

default application roles, 20.3.1.1

advanced display options, 18.2.3.2

advanced permissions (for a Space), 52.2.1.2

Advanced Query

property, 51.16.2.3.1

Advanced Query property, 32.5.2, 32.5.3

All Content selection in Resource Catalog, 39.2

All Modes Shared Screen property, 27.4.2, 28.3.2

All Saved Searches task flow, 56.3.1, 56.3.4.2

Allow Action property, 18.2.2.2

Allow Links column detail in lists, 64.2.3.2.2

Allow Minimize property, 17.5.2.5

Allow Move property, 17.5.2.5

Allow photo upload property, 30.6.2

Allow Remove property, 17.5.2.5, 31.5.2, 31.5.3.1

Allow Resize property, 17.5.2.5

Allow Status Update property, 30.6.2

Analytics

about, 55.1

associated properties, 55.3

task flow parameters, 55.3

Analytics business role page, 7.1.1

Analytics service

See Analytics, 55.3

Annotate with AutoVue menu action, 41.5.2.1

Announcement Length property, 59.3.2

announcements

about, 59

creating, 59.2.2.3

creating links, 63.2.1.2

deleting, 59.2.2.5

editing, 59.2.2.4

linking, 59.2.5

sending mail, 59.2.4

viewing, 59.2.2.1, 59.2.3.1

Announcements - Quick View task flow

about, 59.2, 59.2.3

parameters

Announcement Length, 59.3.2

Content View Only, 59.3.2

Expand All Announcements in Extended Mini View, 59.3.2

Forum ID, 59.3.2

Hide Toolbar, 59.3.2

Navigate to Announcement Viewer, 59.3.2

Number of Announcements on Extended Mini View, 59.3.2

Number of Announcements to Show, 59.3.2

Number of Expanded Announcements, 59.3.2

using, 59.2.3

viewing announcements, 59.2.3.1

Announcements service

activities tracked by Activity Stream, 6.4.3.2, 32.1

root category, 6.2.2

subscribing to, 36.3.2

task flows

Announcements, 59.2.2

Quick View, 59.2, 59.2.3

Announcements system page, 7.3.1

Announcements task flow

about, 59.2.1, 59.2.2

adding to a page, 59.2.1

Announcements page, 59.1

creating announcements, 59.2.2.3

deleting announcements, 59.2.2.5

editing announcements, 59.2.2.4

parameters

Forum ID, 59.3.2

personalizing, 59.2.2.2

using, 59.2.2

viewing announcements, 59.2.2.1

anonymous-role, 20.3.1.1

AppConnectionManager role, 6.5.1

application administration page URLs, A.4

Application Navigator, 6.6.3.3

application password, 35.6

application permissions, 20.3.2

application roles, 20.3

Administrator, 20.3.1.1

anonymous-role, 20.3.1.1

assigning to enterprise groups, 21.1.2

assigning to users, 21.1.2

authenticated-role, 20.3.1.1

Authenticated-User, 20.3.1.1

changing users, 21.1.3

creating, 21.2.2

custom, 20.3.1.2

default roles, 20.3.1.1

deleting, 21.2.6

granting permissions, 21.2.3

permissions, 20.3.2

Public-User, 20.3.1.1

revoking from a user, 21.1.5

application skins, using, 5.7

applications, self registering to, 29.2

Application-View permission, granting to Public-User role, 21.2.4

authenticated-role, 20.3.1.1

Authenticated-User role

in a Space, 52.2.1.1

in the Home Space, 20.3.1.1

Authentication Method, 6.6.2

authentication to Microsoft Office files, 41.12.3

automatic login for external applications, 6.6.2

AutoVue, 45.3

icon, 41.5.2.6

menu action, 41.5.2.1

requirements, 41.5.2.6

B

Background Color property, 17.5.2.7.2

background color, pages, 17.3.4

Background Image property, 17.5.2.7.2

background image, pages, 17.3.4

banding

See lists, color banding

BASIC Authentication Method, 6.6.2

basic display options, 18.2.3.2

Blank page style, 15.1

Blog page style, 15.1

Blogger template, 50.1.1

blogs

about, 48.1

activities tracked by Activity Stream, 6.4.3.2, 32.1

adding to a Space, 51.13

blog posts

about, 48.3.1

adding links, 48.3.5

adding tags, 48.3.5

creating, 48.3.2

deleting, 48.3.5

downloading, 48.3.5

editing, 48.3.3

liking, 48.3.5

managing comments, 48.3.5

managing versions, 48.3.5

modifying properties, 48.3.5

opening, 48.3.4

opening or saving as PDF, 48.3.5

renaming, 48.3.5

setting security, 48.3.5

sharing the URL, 48.3.5

subscribing, 48.3.5

unliking, 48.3.5

commenting, 34.2

comparing versions, 41.21

creating, 48.2.1

using Blog page style, 48.2.1.1

using Blogs task flow, 48.2.1.2

directory structure, 48.1.2

editing in-place, 41.12.3

enabling functionality, 48.1.3

permissions required, 48.1.4

properties

about, 48.2.2, 48.2.2.1

Blog page style parameters, 48.2.2.3

Blogs task flow, 48.2.2.2

subscribing, 48.2.3

subscribing to, 36.3.3.3

subscriptions, 36.3.2

bookmarks

See tags

See also favorites

Boolean data type in lists, 64.2.3.2.2

Boolean values, Expression Language, B.1

borders, changing on components, 17.5.2.7.4

Bottom Height property, 18.2.10.3

Box layout component, 18.2.2, 18.2.2.2

about, 18.2.2.1

display options

Allow Action, 18.2.2.2

Horizontal Alignment, 18.2.2.2

Layout, 18.2.2.2

Short Desc, 18.2.2.2

Show Component, 18.2.2.2

Show Split Action, 18.2.2.2

Show Tab Action, 18.2.2.2

Vertical Alignment, 18.2.2.2

browser support in Web Clipping, 28.4

bulleted layout for OmniPortlet, 27.2.7.4

Bulleted View display template, 40.5

Bulleted with Folder Label View display template, 40.5

business mashups

See mashups

business role pages, 7.1

about, 7.1.1

adding to navigation, 7.1.6

choosing the default Resource Catalog, 5.10

copying, 7.1.9

creating, 7.1.3

deleting, 7.1.10

display order, 7.1.7

editing, 7.1.8

granting access, 7.1.4

making public, 7.1.4.2

revoking access, 7.1.4.1, 7.1.5

seeded

Activities, 7.1.1

Analytics, 7.1.1

Documents, 7.1.1

My Profile, 7.1.1

Space Templates, 7.1.1

Spaces, 7.1.1

Tag Center, 7.1.1

setting page creation defaults, 7.1.2

specifying a target audience, 7.1.4

C

Calendar Overlay Style property, 61.3.2

Calendar Style Class property, 61.3.2

Calendar Toolbox Layout property, 61.3.3

Cancel Check Out action, 41.12.1

Cancel Check Out menu action, 41.5.1.1

Carousel View display template, 40.5

Category ID property, 60.3.2

Change Membership component, 13.2.6

character sets, Web Clipping and, 28.4

chart layout in OmniPortlet, 27.2.7.2

Check Out menu action, 41.5.1.1, 41.5.2.1

child components

about, 17.5.2.2, 17.5.2.6

hiding, 17.5.2.6.1

rearranging, 17.5.2.6.2

showing hidden, 17.5.2.6.1

Child Creation property, 18.2.10.4

Chrome Style property, 17.5.2.5

chrome, components and, 17.5.2.5

Class URN property, 58.3.2

Class URN Restrictions property, 58.3.2

collaboration, documents and, 45

collaborative services, 3

about, 3.3.1

Activity Graph and, 3.3.6

Announcements service and, 3.3.3

blogs and, 3.3.8

commenting and, 3.3.4

communities and, 3.2

Discussions service and, 3.3.3

Events service and, 3.3.3

instant messaging and, 3.3.5

liking and, 3.3.4

Links service and, 3.3.7

Lists service and, 3.3.9

People Connections and, 3.3.2

Polls service and, 3.3.6

sharing and, 3.3.4

Spaces and, 3.2

Tags service and, 3.3.7

wikis and, 3.3.8

Collapse Tree Navigation property, 42.2.1

color banding

See lists, color banding

Color property, 17.5.2.7.2

columns

hiding in documents task flows, 41.6.1

reordering in documents task flows, 41.6.2

showing hidden in documents task flows, 41.6.1

Columns menu action, 41.5.1.2

comments

application objects and, 34.2

files and, 41.20

Comments icon, 41.5.2.6

Comments menu action, 41.5.1.2, 41.5.2.2

communities, about, 1.1.2

component wiring

about, 19.1

consumer components, 19.1

page parameters and, 19.3

portlet to portlet, 19.2.2

portlet to task flow, 19.2.3

producer components, 19.1

task flow to portlet, 19.2.4

task flow to task flow, 19.2.1

UI component to task flow, 19.2.5

components

changing component borders, 17.5.2.7.4

chrome, 17.5.2.5

collapsing and expanding, 29.4.2.4

consumer components, 19.1

dragging and dropping, 29.4.2.1

producer components, 19.1

properties

See properties]

rearranging, 17.5.2.6.2, 29.4.2.1

removing, 29.4.2.2

resizing, 29.4.2.3

setting access on, 23.2

setting properties on, 17.5.2.3

wiring, 19

concurrency warning, 17.3.1

Connection List Name property, 31.5.2, 31.5.3.2

Connection Name property, 42.2.1, 42.3.1, 42.4.1, 42.5.1, 42.6.1, 42.7.1

Connections, 31

about, 31.1

activities tracked by Activity Stream, 6.4.3.2, 32.1

configuring, 6.4.3.3

deleting users, 31.4.6

inviting users to connect, 31.4.2

lists

adding users to, 31.4.5.2

creating, 31.4.5, 31.4.5.1

deleting, 31.4.5.4

managing, 31.4.5

removing users from, 31.4.5.3

preferences, 31.2

properties, 31.5

responding to invitations, 31.4.4

searching, 31.4.1.2

setting up, 31.4

subscribing to, 36.3.1

task flows

about, 31.1

properties, 31.5, 31.5.2

troubleshooting, 6.4.5.2

viewing, 31.4.1.1

pending invitations, 31.4.3.2

received invitations, 31.4.3.2

sent invitations, 31.4.3.1

Connections - Card task flow

about, 31.1

parameters

Allow Remove, 31.5.2, 31.5.3.1

Connection List Name, 31.5.2, 31.5.3.2

Filter Pattern, 31.5.2, 31.5.3.6

Hide Footer, 31.5.2

Number of Columns, 31.5.2

Number of Connections per page, 31.5.2, 31.5.3.4

Number of Rows, 31.5.2, 31.5.3.5

Profile Format, 31.5.2, 31.5.3.7

Profile Launched on Selection, 31.5.2, 31.5.3.8

Sort Criteria, 31.5.2

User Name, 31.5.2

Connections - Detailed View task flow

about, 31.1

parameters

Number of Connections per page, 31.5.2, 31.5.3.4

Sort Criteria, 31.5.2

User Id, 31.5.2

Connections - Quick View task flow

about, 31.1

parameters

Hide Footer, 31.5.2

Hide Header, 31.5.2

Number of Columns, 31.5.2

Number of Connections per page, 31.5.2, 31.5.3.4

Number of Rows, 31.5.2, 31.5.3.5

User Id, 31.5.2

Connections task flow

about, 31.1

parameters

Current View, 31.5.2, 31.5.3.3

Number of Rows (list layout), 31.5.2, 31.5.3.5

User Name, 31.5.2

Contact Administration Spaces component, 13.2.7

Containing Folder Properties menu action, 41.5.1.2

content

adding, 17.5.1

adding a content query to a navigation model, 11.2.2.1.2

adding to a page, 39.1, 41.3

collaborating on documents, 45

creating and managing at runtime, 44

including in application, 2

setting properties on, 17.5.2

stretching, 17.5.2.5

content management, overview of, 2

content orientation, 18.2.2.1

Content page in Spaces, 51.8

Content Presenter Configuration dialog, displaying, 40.3

Content Presenter task flow

about, 40.1

adding to a page, 40.2

Content Presenter Configuration dialog, 40.3

creating Site Studio files, 40.10.3

editing HTML files, 40.10.1

editing Site Studio files, 40.10.2

editing wikis, 40.10.1

out-of-the-box display templates, 40.5

previewing, 40.6

properties, 40.11

Data Source, 40.11.2

Data Source Type, 40.11.2

Maximum Results, 40.11.2

Region Template, 40.11.2

Task Flow Instance ID, 40.11.2

Template Category ID, 40.11.2

Template View ID, 40.11.2

selecting

display template, 40.5

folder contents, 40.4.2

results of query, 40.4.3

results of scenario, 40.4.5

single content item, 40.4.1

Content Presenter templates, managing, 10.1.1

content repositories

adding content to a page, 39.1, 41.3

adding files, 46.3.4.1

deleting folders and files, 41.16

content style properties

about, 17.5.2.2, 17.5.2.7, 17.5.2.7.1

properties

Background Color, 17.5.2.7.2

Background Image, 17.5.2.7.2

Color, 17.5.2.7.2

Font, 17.5.2.7.2

Font Size, 17.5.2.7.2

Font Style, 17.5.2.7.2

Height, 17.5.2.7.2

Margin, 17.5.2.7.2

Other CSS, 17.5.2.7.3, 17.5.2.7.3, 17.5.2.7.4

Width, 17.5.2.7.2

properties Other CSS, 17.5.2.7.2

content task flows

See documents task flows

Content Type, accessing properties for, 40.4.3, 41.29.2

Content View Only property, 59.3.2

contextual events, 17.5.2.8

Control Panel Shown property, 30.6.2

cookies, Web Clipping and, 28.4

Copy menu action, 41.5.1.1

Copyright Message Spaces component, 13.2.8

copyright statement

for a Space, 51.4.14

for application, 5.2

Create Page Spaces component, 13.2.9

Create Space Spaces component, 13.2.10

Create Subspace Spaces component, 13.2.11

Created After property, 42.3.1

Created Before property, 42.3.1

Creator property, 42.3.1

credential provisioning

public credentials, 6.6.2

shared credentials, 6.6.2

CSS

Other CSS property, 17.5.2.7.2

pages, 17.3.4

Web Clipping and, 28.4

See also Other CSS property

Current User Profile Spaces component, 13.2.12

Current View property, 31.5.2, 31.5.3.3

custom application roles, 20.3.1.2

Custom Attributes page, Spaces and, 51.12

custom attributes, Spaces and, 51.12

Customization ID property, 61.3.2, 61.3.3

customizations

application, 17.5.2.1

lists and, 64.2.5

user, 17.5.2.1, 29.4.1

Web Clipping, 28.2.2

See also, user customizations

Cut menu action, 41.5.1.1

D

data controls, 26.1.1

Data Source property, 40.11.2

Data Source Type property, 40.11.2

data sources

filtering data, 27.2.5

using a spreadsheet, 27.2.4.3

using an existing Web page, 27.2.4.7

using SQL, 27.2.4.4

using Web Services, 27.2.4.6

using with OmniPortlet, 27.2.4

using with portlets, 27.2.3

using XML, 27.2.4.5

data, filtering portlet, 27.2.5

database connection, OmniPortlet and, 27.2.4.2

databases, list sorting and, 64.2.5.1

date preference, 35.3

DateTime data type in lists, 64.2.3.2.2

Default Current Date property, 61.3.2

Default Document Details View display template, 40.5

Default List Item View display template, 40.5

default navigation model, 11.2.4

Default Value column detail in lists, 64.2.3.2.2

Default View display template, 40.5

Delete menu action, 41.5.1.1

Delete Page permission, 23.1, 38.2.1

Depressed Icon property, 13.2.2.1, 18.2.7.2

Design view

deleting layout components in, 18.3.1

page edit mode in, 17.3.2

design-time defined, 19.1

Destination property, 18.2.6.2, 18.2.7.2, 42.12.1

Dimensions From property, 18.2.10.4

Disable Personalize and Customize property, 61.3.2

Disabled Icon property, 13.2.2.1, 18.2.7.2

Disclosed property, 18.2.10.6

discoverable Spaces, 51.14.3

Discussion Forums task flow

about, 60.1

parameters

Category ID, 60.3.2

Show Categories, 60.3.2

Show Recursive Forums, 60.3.2

Discussion Site template, 50.1.1

discussions

about, 60.1

access to, 60.1

adding to a watch list, 60.2.6.1

categories, 60.1

character limits, 60.2.3

creating, 60.2.2

creating links, 63.2.1.3, 63.2.2.2

editing name and description, 60.2.3

forums, 60.1

hiding additional information, 60.2.5

permissions, 20.3.2

publishing Space mail in, 51.10.4

removing from a watch list, 60.2.6.2

root category on server, 6.2.2

sending mail, 60.2.7

showing additional information, 60.2.5

topics

deleting posts, 60.2.4.5

deleting replies, 60.2.4.5

editing posts, 60.2.4.4

editing replies, 60.2.4.4

posting, 60.2.4.1

replying to, 60.2.4.2

view modes, 60.2.4.6

viewing posts, 60.2.4.3

viewing replies, 60.2.4.3

watching, 60.2.6

watching forums, 60.2.6

Discussions - Popular Topics task flow

about, 60.1, 60.2.5.2

parameters

Category ID, 60.3.2

Forum ID, 60.3.2

Hide Toolbar, 60.3.2

Discussions - Quick View task flow

about, 60.1

parameters

Category ID, 60.3.2

Discussions - Recent Topics task flow

about, 60.1, 60.2.5.3

parameters

Category ID, 60.3.2

Forum ID, 60.3.2

Hide Toolbar, 60.3.2

Discussions - Watched Forums task flow

about, 60.1, 60.2.5.4

parameters

Category ID, 60.3.2

Hide Toolbar, 60.3.2

Discussions - Watched Topics task flow

about, 60.1, 60.2.5.5

parameters

Category ID, 60.3.2

Forum ID, 60.3.2

Hide Toolbar, 60.3.2

Discussions server

role mapping, 20.3.2.2

discussions server

about, 60.1

Discussions service, 60

activities tracked by Activity Stream, 6.4.3.2, 32.1

permissions, 20.3.2

root category, 6.2.2

subscribing to topics, 36.3.3.4

subscriptions, 36.3.2

task flows

Discussion - Quick View, 60.1

Discussion Forums, 60.1

Popular Topics, 60.1, 60.2.5.2

Recent Topics, 60.1, 60.2.5.3

Watched Forums, 60.1, 60.2.5.4

Watched Topics, 60.1, 60.2.5.5

Discussions system page, 7.3.1

discussions task flows

adding to a page, 60.2.1

Display Header property, 17.5.2.5

Display Message Size property, 33.5.2, 33.5.3.3

display name

changing for Space, 51.4.1

viewing Space, 49.5

display options

about, 17.5.2.2, 17.5.2.5

basic and advanced, 18.2.3.2

Box layout component, 18.2.2.2

component, 17.5.2.5

EL editor, 17.5.2.5, B.1

HTML Markup layout component, 18.2.4.2

Hyperlink layout component, 18.2.6.2

Image layout component, 18.2.7.2

Links layout component, 18.2.5.3

Movable Box layout component, 18.2.3.2

panelGroupLayout layout component, 18.2.10.2

panelStretchLayout layout component, 18.2.10.3

panelTabbed layout component, 18.2.10.4

properties

Allow Action, 18.2.2.2

Allow Minimize, 17.5.2.5

Allow Move, 17.5.2.5

Allow Remove, 17.5.2.5

Allow Resize, 17.5.2.5

Bottom Height, 18.2.10.3

Child Creation, 18.2.10.4

Chrome Style, 17.5.2.5

Depressed Icon, 13.2.2.1, 18.2.7.2

Destination, 18.2.6.2, 18.2.7.2

Dimensions From, 18.2.10.4

Disabled Icon, 13.2.2.1, 18.2.7.2

Disclosed, 18.2.10.6

Display Header, 17.5.2.5

Display Shadow, 17.5.2.5

Display Type, 13.2.2.1

End Width, 18.2.10.3

Favorite Title, 13.2.4.1

Favorite URL, 13.2.4.1

Font, 17.5.2.5

Font Color, 17.5.2.5

Font Size, 17.5.2.5

Font Style, 17.5.2.5

Halign, 18.2.10.2

Height, 18.2.10.7

Horizontal Alignment, 18.2.2.2

Hover Icon, 13.2.2.1, 18.2.7.2

Icon, 13.2.2.1, 18.2.7.2, 18.2.10.6

Icon Position, 13.2.2.1, 18.2.7.2

Inflexible Height, 18.2.10.6

Inline Style, 13.2.8.1

Landmark, 18.2.10.2

Layout, 18.2.2.2, 18.2.10.2

Open in new window, 18.2.6.2

Position, 18.2.10.4

Scope Name, 13.2.2.1

Short Desc, 13.2.2.1, 17.5.2.5, 18.2.2.2, 18.2.4.2, 18.2.7.2, 18.2.9.2, 18.2.10.2, 18.2.10.3, 18.2.10.4, 18.2.10.6, 18.2.10.7

Show Actions On Hover, 17.5.2.5

Show Component, 13.2.2.1, 17.5.2.5, 18.2.2.2, 18.2.4.2, 18.2.6.2, 18.2.7.2, 18.2.9.2, 18.2.10.2, 18.2.10.3, 18.2.10.4, 18.2.10.6, 18.2.10.7

Show Label, 13.2.25.1

Show Split Action, 18.2.2.2

Show Tab Action, 18.2.2.2

Source, 18.2.9.2

Start Width, 18.2.10.3

Stretch Content, 17.5.2.5

Tab Removal, 18.2.10.4

Target Frame, 18.2.7.2

Task Flow Id, 13.2.9.1

Text, 13.2.2.1, 17.5.2.5, 18.2.7.2, 18.2.10.6

Text And Access Key, 18.2.7.2

Theme, 18.2.10.2, 18.2.10.3

Title, 18.2.6.2

Top Height, 18.2.10.3

Type, 13.2.3.1

Valign, 18.2.10.2

Value, 18.2.4.2

Vertical Alignment, 18.2.2.2

Width, 18.2.10.7

separator layout component, 18.2.10.7

showDetailFrame layout component, 18.2.10.5

sidebarItem layout component, 18.2.10.6

spacer layout component, 18.2.10.7

Text layout component, 18.2.8.2

validating expressions, B.1

Web Page layout component, 18.2.9.2

Display Shadow property, 17.5.2.5

Display Style property, 11.3.2.2

Display Tool Bar property, 51.16.2.3.1

Display Type property, 13.2.2.1

Display View property, 51.16.2.3.1

Display Width column detail in lists, 64.2.3.2.2

document components, about, 41.2

Document Exchange template, 50.1.1

Document Explorer task flow, 42.2.1

about, 41.1.1

parameters

Collapse Tree Navigation, 42.2.1

Connection Name, 42.2.1

Features Off, 42.2.1

Read Only, 42.2.1

Resource ID, 42.2.1

Show Documents, 42.2.1

Show Folders, 42.2.1

Start Folder Path, 42.2.1

Document List Viewer task flow

about, 41.1.2

parameters

Connection Name, 42.3.1

Created After, 42.3.1

Created Before, 42.3.1

Creator, 42.3.1

Last Modified After, 42.3.1

Last Modified Before, 42.3.1

Last Modifier, 42.3.1

Root Folder Path, 42.3.1

Show Folders, 42.3.1

Task Flow Instance ID, 42.3.1

Document Manager task flow

about, 41.1.3

parameters

Connection Name, 42.4.1

Features Off, 42.4.1

layout, 42.4.1

Page Size, 42.4.1

Read Only, 42.4.1

Resource ID, 42.4.1

Start Folder Path, 42.4.1

Document Mini Properties task flow

about, 41.1.8

parameters

Resource ID, 42.9.1

Document Navigator task flow

about, 41.1.4

parameters

Connection Name, 42.5.1

Page Size, 42.5.1

Read Only, 42.5.1

Resource ID, 42.5.1

Show Documents, 42.5.1

Start Folder Path, 42.5.1

Document Properties task flow

about, 41.1.9

parameters

Item ID property, 42.10.1

Read Only, 42.10.1

Document Version History task flow

about, 41.1.10

parameters

Item ID, 42.11.1

Read Only, 42.11.1

Document Viewer preview pane

File menu, 41.5.2.1

menu actions, 41.5.2

sidebar, 41.5.2.6

View menu, 41.5.2.2

Document Viewer task flow

about, 41.1.7

parameters

Features Off, 42.8.1

Initial Sidebar property, 42.8.1

Item ID property, 42.8.1

Read Only property, 42.8.1

documents

adding to navigation model, 11.2.2.1.1

applying tags to, 57.2.3

commenting on, 34.2

creating links, 63.2.1.4, 63.2.2.3

liking, 34.1

subscribing to, 36.3.2

Documents business role page, 7.1.1

Documents service

activities tracked by Activity Stream, 6.4.3.2, 32.1

blogs, subscribing to, 36.3.2

EL expressions relating to, B.3.12

parameters

Features Off, 42.5.1

Page Size, 42.3.1

properties

Data Source, 40.11.2

Data Source Type, 40.11.2

Maximum Results, 40.11.2

Region Template, 40.11.2

Task Flow Instance ID, 40.11.2

Template Category ID, 40.11.2

Template View ID, 40.11.2

task flows

Content Presenter, 40.1

Document Explorer, 41.1.1, 42.2

Document List Viewer, 41.1.2, 42.3

Document Manager, 41.1.3, 42.4

Document Mini Properties, 41.1.8, 42.9

Document Navigator, 41.1.4, 42.5

Document Properties, 41.1.9, 42.10

Document Version History, 41.1.10, 42.11

Document Viewer, 41.1.7

Document Viewerr, 42.8

Folder Viewer, 41.1.5, 42.6

Recent Documents, 41.1.6, 42.7

setting properties, 42

wikis, subscribing to, 36.3.2

Documents service task flows

See documents task flows

Documents system page, 7.3.1

documents task flows

about, 41.1

adding to a page, 41.4

cancelling file checkout, 41.12.1

checking out files, 41.12.1

commenting on files, 41.20

creating files, 41.8

creating folders, 41.7

deleting folders and files, 41.16

downloading files, 41.12.2

editing files in-place, 41.12.3

File menu, 41.5.1.1

hiding columns, 41.6.1

moving folders and files, 41.15

opening files, 41.10

opening files in PDF, 41.23

opening folders, 41.9

renaming folders and files, 41.13

reordering columns, 41.6.2

saving files in PDF, 41.23

searching folders and files, 41.29

setting file security, 41.25

showing hidden columns, 41.6.1

sorting files and folders, 41.6.3

uploading files, 41.8.1

uploading new version of file, 41.12.4

URL for folders and files, 41.24

using Rich Text Editor, 41.11

View menu, 41.5.1.2

viewing properties of folders and files, 41.22

viewing version history of files, 41.21

See also Content Presenter task flow

Download action, 41.5.1.5, 41.5.2.5

Download PDF menu action, 41.5.2.2

dragging and dropping files and folders, 41.14, 41.15

E

Edit action, 41.5.2.3

Edit Defaults mode in OmniPortlet, 27.2.8

Edit menu action, 41.5.1.1

Edit Mode property, 30.6.2

Edit Page permission, 23.1, 38.2.1

Edit Page Spaces component, 13.2.13

Edit Web Content, 40.6

editors

rich text, 18.2.8.1

simple text, 18.2.4.1

See also EL editor

EL editor, 17.5.2.4, 17.5.2.5, B.1

EL expressions, B

application pages, B.3.7

Documents service, B.3.12

event contexts, B.3.9

example, B.2

navigation operations, B.3.4

Oracle Composer, B.3.8

Oracle WebCenter Spaces, B.3.2

People Connections service, B.3.13

Personalization Conductor, B.3.11

Profile, B.3.13

resources, B.3.5

security, B.3.3

seeded, B.3.1

Application Info, B.3.1.1

Page Info, B.3.1.2

Page Parameter, B.3.1.3

Resource Info, B.3.1.4

Space Info, B.3.1.5

Space Page Info, B.3.1.6

System, B.3.1.7

User Info, B.3.1.8

WebCenter Events, B.3.1.9

service IDs, B.3.10

services, B.3.10

Spaces, B.3.6

use case, B.2

user preferences, B.3.14

utilitarian, B.3.15

validating, B.1

value formats, B.1

Enable Action property, 17.5.2.8

Enable Context Info property, 32.5.2

End Date property, 33.5.2, 33.5.3.7

End Width property, 18.2.10.3

enterprise groups, assigning to roles, 21.1.2

Error Encountered system page, 7.3.1

Escape property, 18.2.4.2

event contexts, EL expressions relating to, B.3.9

Event Text Length property, 61.3.3

events

about, 61.1

calendar overlay, 61.2.8

canceling, 61.2.7

contextual events, 17.5.2.8

creating, 61.2.4

creating links, 63.2.1.5, 63.2.2.4

deleting, 61.2.7

displaying multiple calendars, 61.2.8

editing, 61.2.6

Events page, 61.1.2, 61.2.3.1, 61.2.3.1

Events tab, 17.5.2.8

personal calendar, 61.2.2

refreshing, 61.2.3.4

scheduling, 61.2.4

secondary time zone, 61.2.3.5.2

selecting date, 61.2.3.3

selecting display mode, 61.2.3.2

setting display preferences, 61.2.3.5

viewing, 61.1.2

viewing details, 61.2.5

Events - Mini View task flow

parameters

Calendar Toolbox Layout, 61.3.3

Customization ID, 61.3.3

Event Text Length, 61.3.3

List Events in Number of Upcoming Days, 61.3.3

Number of Events Per Page, 61.3.3

Using ADF Calendar Component, 61.3.3

Events page

about, 61.1.2

displaying, 61.2.3.1

hiding, 61.2.3.1

See also events

events properties

about, 17.5.2.2, 17.5.2.8

properties

Action Handlers, 17.5.2.8

Actions, 17.5.2.8

Enable Action property, 17.5.2.8

Events, 17.5.2.8

Events service

activities tracked by Activity Stream, 6.4.3.2, 32.1

subscriptions, 36.3.2

task flows, 61.2

See also events

Events system page, 7.3.1

Events tab, 17.5.2.8

Events task flow

about, 61.1.2

editing properties, 61.3

parameters

Calendar Overlay Style, 61.3.2

Calendar Style Class, 61.3.2

Customization ID, 61.3.2

Default Current Date, 61.3.2

Disable Personalize and Customize, 61.3.2

Group Space, 61.3.2

Maximum Calendars, 61.3.2

Maximum Enabled Calendars, 61.3.2

See also events

Excel

See Microsoft Office integration

Exclude Object Actions property, 58.3.2

Expand All Announcements in Extended Mini View property, 59.3.2

Expand menu action, 41.5.1.2

Explorer

See Microsoft Explorer integration

export and import

Space templates, 53.5

Spaces, 53.5

Expression Language

See EL expressions

Expression Language editor

See EL editor

External Application ID property, 68.4.2

external applications

adding to a navigation model, 11.2.2.1.3

additional login fields, 6.6.2

deleting, 6.6.4

launching from Applications Navigator, 6.6.3.3

login preferences, 35.7

registering, 6.6.2

task flows, 6.6.3.3

adding to a page, 6.6.3.1

registering, 6.6.3.2

required permissions, 6.6.3

setting properties of, 6.6.3.5

F

Favorite Title property, 13.2.4.1

Favorite URL property, 13.2.4.1

favorites, 37

about, 37.1

accessing, 37.2

Add to Favorites Spaces component, 13.2.4

adding folders, 37.4, 37.5.2

adding links, 37.3, 37.5.1

deleting folders, 37.5.6

deleting links, 37.5.6

editing folders, 37.5.3

editing links, 37.5.3

Favorites Menu Spaces component, 13.2.14

making discoverable, 37.3

managing, 37.5

rearranging folders, 37.5.4

rearranging links, 37.5.4

searching, 37.5.5

setting open behavior, 37.5.3

sharing, 37.3

Favorites Menu Spaces component, 13.2.14

Features Off property, 42.2.1, 42.4.1, 42.5.1, 42.6.1, 42.8.1

Feedback, 33

about, 33.1.2

activities tracked by Activity Stream, 6.4.3.2, 32.1

configuring, 6.4.3.6

deleting, 33.4.2.3

enabling others to post, 33.3

filtering, 33.4.2.1.2

hiding, 33.4.2.1.3

marking as private, 33.4.2.1.5

posting, 33.4.2.2

preferences, 33.2.2

properties, 33.5, 33.5.1

showing hidden, 33.4.2.1.4

sorting, 33.4.2.1.2

subscribing to, 36.3.1

task flows

about, 33.1.2

properties, 33.5, 33.5.1, 33.5.2

working with, 33.4.2

troubleshooting, 6.4.5.5

viewing, 33.4.2.1

posted, 33.4.2.1.1

received, 33.4.2.1.1

Feedback - Quick View

parameters

User Id, 33.5.2

Feedback - Quick View task flow

about, 33.1.2

parameters

Display Message Size, 33.5.2, 33.5.3.3

End Date, 33.5.2, 33.5.3.7

Hide Actions, 33.5.2, 33.5.3.1

Hide Footer, 33.5.2

Hide Given, 33.5.2, 33.5.3.5

Hide Header, 33.5.2

No of Feedback Items, 33.5.2, 33.5.3.2

Start Date, 33.5.2, 33.5.3.7

Feedback task flow

about, 33.1.2

parameters

End Date, 33.5.2, 33.5.3.7

Hide Given, 33.5.2, 33.5.3.5

Hide Header, 33.5.2

No of Feedback Items, 33.5.2, 33.5.3.2

Resource Id, 33.5.2

Start Date, 33.5.2, 33.5.3.7

File In Use dialog, 41.12.3.1

File menu

Document Viewer, 41.5.2.1

documents task flows, 41.5.1.1

File Now Available dialog, 41.12.3.1

files

adding tags, 41.19

adding to a page, 41.3

adding to Space

in documents task flows, 41.8.1

using Microsoft Office integration, 46.3.4.1

checking in using Microsoft Office integration, 46.3.4.4

checking out

cancelling, 41.12.1, 41.12.1

in documents task flows, 41.12.1

using Microsoft Office integration, 46.3.4.3

closing in Microsoft Office, 46.3.5

commenting on in documents task flows, 41.20

copying and pasting, 41.14

creating, 41.8

deleting, 41.16

downloading, 41.12.2

drag and drop, 41.14, 41.15

editing and updating, 41.12

editing in-place, 41.12.3

liking, 41.27, 41.28

linking to other items, 41.19

moving, 41.15

opening

as PDF, 41.10

in browser, 41.10

in documents task flows, 41.10

PDF in documents task flows, 41.23

using Microsoft Office, 46.3.2

recommendations to other documents, 41.19

renaming, 41.13

saving PDF in documents task flows, 41.23

saving to Space, 46.3.4.1.1

searching, 41.29

security, 41.25

sharing through Publisher, 34.3

sharing through Publisher task flow, 34.3.3.3

sorting in document task flows, 41.6.3

subscribing to, 36.3.3.1, 41.26

unliking, 41.27, 41.28

uploading, 41.8.1

uploading new version, 41.12.4

URL to, 41.24

viewing

information using Microsoft Office, 46.3.4.9

properties of, 41.22

version history in documents task flows, 41.21

version history using Microsoft Office integration, 46.3.4.10

working with Related Items, 41.19

Filter Pattern property, 31.5.2, 31.5.3.6

Filter property, 51.16.2.3.1

first page, selecting, 5.6

Folder Viewer task flow

about, 41.1.5

parameters

Connection Name, 42.6.1

Features Off, 42.6.1

Page Size, 42.6.1

Read Only, 42.6.1

Resource ID, 42.6.1

Show Folders, 42.6.1

Start Folder Path, 42.6.1

folders

adding to a page, 41.3

creating

in documents task flows, 41.7

using Microsoft Office integration, 46.3.4.2

deleting, 41.16

drag and drop, 41.14, 41.15

hiding and showing, 41.18

managing using Microsoft Office, 46.3.4.7

moving, 41.15

opening in documents task flows, 41.9

refreshing contents, 41.17

renaming, 41.13

searching, 41.29

sorting in documents task flows, 41.6.3

URL to, 41.24

viewing properties of, 41.22

folksonomies, tagging and, 57.1.1

Font Color property, 17.5.2.5

Font property, 17.5.2.5, 17.5.2.7.2

Font Size property, 17.5.2.5, 17.5.2.7.2

Font Style property, 17.5.2.5, 17.5.2.7.2

footer, adding to a page, 17.3.5.2

Format column detail in lists, 64.2.3.2.2

forms layout in OmniPortlet, 27.2.7.5

Forum ID property, 59.3.2, 60.3.2

framesets in Web Clipping, 28.4

G

General page in a Space, 51.4

Get a Link menu action, 41.5.1.2, 41.5.2.2

GET Authentication Method, 6.6.2

Get Updates, 46.3.4

Global Help Spaces component, 13.2.15

Global Help URL, 5.3

global search field, 56.3.2.1

globalization support in Web Clipping, 28.4

Group Space Name property, 52.4.7.2, 69.3.2

Group Space property, 33.5.2, 33.5.3.6, 42.7.1, 61.3.2

group spaces

See Spaces

GUID

of page, 29.9.2

of Space, 29.9.1

H

Halign property, 18.2.10.2

headers

adding to a page, 17.3.5.2

Display Header property, 17.5.2.5

Height property, 17.5.2.7.2, 18.2.10.7

help

accessing online, 29.11

Global Help Spaces component, 13.2.15

Help link, 5.3

Hide Actions property, 33.5.2, 33.5.3.1, 36.5.3.2, 36.5.3.3

Hide Attach Links property, 34.3.3.5.2

Hide Comments property, 32.5.2, 32.5.4.3

Hide Configuration Button property, 32.5.2, 32.5.4.1

Hide Document Uploader property, 34.3.3.5.2, 34.3.3.5.3

Hide Folders menu action, 41.5.1.2

Hide Footer property, 31.5.2, 32.5.2, 33.5.2

Hide Given property, 33.5.2, 33.5.3.5

Hide Header property, 31.5.2, 32.5.2, 33.5.2

Hide Inline Preview property, 32.5.2, 32.5.4.2

Hide Like property, 32.5.2, 32.5.4.4

Hide Publisher property, 33.5.2, 33.5.3.4

Hide Share property, 32.5.2, 32.5.4.5

Hide Sharing Picker property, 34.3.3.5.2

Hide Toolbar property, 59.3.2, 60.3.2

Hint column detail in lists, 64.2.3.2.2

History icon, 41.5.2.6

Home Page page style, 15.1

Home Space

about, 1.1.1

about, 29.1

adding as Windows network place, 46.4.1

adding Space pages to, 49.17, 51.7.10

choosing default page template, 5.8, 5.9

choosing default Resource Catalog template, 5.10

clearing deleted Space page, 29.5, 49.17

disabling the presence of, 5.12

enabling the presence of, 5.12

exposing Space pages in, 29.5

in Windows Explorer, 46.4.1

managing files using Microsoft Office, 46.3.4.6

navigating to, 29.3.1

pages

controlling access, 38.2, 38.2.1

copying, 38.4

creating in, 38.1.2

deleting, 38.5

editing, 38.3

page creation defaults, 38.1.1

revoking access, 38.2.2

securing, 38.2, 38.2.1

pretty URLs, A.2

printing pages, 29.8

renaming a page, 29.6

saving file to, 46.3.4.1.1

user interface URLs, A.2

Home Space Spaces component, 13.2.16

Horizontal Alignment property, 18.2.2.2

Hover Icon property, 13.2.2.1, 18.2.7.2

HTML files

editing in-context in Content Presenter, 40.10.1

editing in-place, 41.12.3

HTML Markup layout component

about, 18.2.4

display options, 18.2.4.2

Escape, 18.2.4.2

No Wrap, 18.2.4.2

Short Desc, 18.2.4.2

Show Component, 18.2.4.2

Value, 18.2.4.2

embedding media, 18.2.4.3

Hyperlink layout component, 18.2.6.2

about, 18.2.6.1

display options

Destination, 18.2.6.2

Open in new window, 18.2.6.2

Show Component, 18.2.6.2

Title, 18.2.6.2

I

Icon Position property, 13.2.2.1, 18.2.7.2

Icon property, 13.2.2.1, 18.2.7.2, 18.2.10.6

Icon View display template, 40.5

icon, changing a Space, 51.4.7

Id property, 27.4.2, 28.3.2

IDC:GlobalProfile, 40.4.3, 41.29.2

Image layout component, 18.2.7, 18.2.7.2

about, 18.2.7

display options

Depressed Icon, 18.2.7.2

Destination, 18.2.7.2

Disabled Icon, 18.2.7.2

Hover Icon, 18.2.7.2

Icon, 18.2.7.2

Icon Position, 18.2.7.2

Short Desc, 18.2.7.2

Show Component, 18.2.7.2

Target Frame, 18.2.7.2

Text, 18.2.7.2

Text And Access Key, 18.2.7.2

Image Map Type property, 42.14.1

Image Size property, 30.6.2

images

document image component, 41.2

document image properties, 42.14

Image Map Type, 42.14.1

Long Desc URL, 42.14.1

Short Desc, 42.14.1

Show Component, 42.14.1

Source, 42.14.1

Image layout component, 18.2.7, 18.2.7.2

in search results, 18.2.7

IMP service

about, 62.1

Microsoft LCS, 62.4.3

Microsoft OCS, 62.4.3

OWLCS, 62.4.3

Presence icon, 62.1

Presence icon context menu, 62.1

presence states, 62.4.1

sending instant messages, 62.4.3

sending mail, 62.4.2

starting phone conferences, 62.4.4

status message, 62.4.1

viewing user presence, 62.4.1

import and export

Space templates, 53.5

Spaces, 53.5

Subspaces, 54.7.2

Inflexible Height property, 18.2.10.6

Initial Sidebar property, 42.8.1

inline frames

properties

Short Desc, 42.13.1

Show Component, 42.13.1

Source, 42.13.1

inline frames properties, 41.2

Inline Style property, 13.2.8.1

Instant Messaging and Presence (IMP)

See IMP

internal ID of a Space, 49.5

internal layout components, 18.2.10.1

panelGroupLayout, 18.2.10.1, 18.2.10.2

panelStretchLayout, 18.2.10.1, 18.2.10.3

panelTabbed, 18.2.10.1, 18.2.10.4

separator, 18.2.10.7

showDetailFrame, 18.2.10.1, 18.2.10.5

sidebarItem, 18.2.10.1, 18.2.10.6

spacer, 18.2.10.1, 18.2.10.7

internal name of a Space, 49.5

Invite People as Connection Spaces component, 13.2.17

Is Update Status property, 34.3.3.5.2, 34.3.3.5.5

ISO-8859-1 character set, 28.4

Item ID property, 42.8.1, 42.10.1, 42.11.1

J

JavaBeans, Expression Language, B.1

JavaScript

HTML Markup layout component and, 18.2.4.1

Web Clipping and, 28.4

JAWS, 35.4

Join Space Spaces component, 13.2.18

JSF portlets, 25.4.2

K

Keep open the Publisher after publish property, 34.3.3.5.2

L

landing page, selecting, 5.6

Landmark property, 18.2.10.2

languages

choosing the default display language, 5.4

customizing the language list, 5.5

setting in a Space, 51.4.15

user preference, 35.2

Last Modified After property, 42.3.1, 42.7.1

Last Modified Before property, 42.3.1, 42.7.1

Last Modifier property, 42.3.1, 42.7.1

layout

adding a page footer, 17.3.5.2

adding a page header, 17.3.5.2

adding page content regions, 17.3.5.4

adding tabs, 17.3.5.5

changing a page layout, 17.3.5.1

changing page column widths, 17.3.5.3

content orientation, 18.2.2.1

layout components

about, 18

adding, 18.1

Box, 18.2.2

deleting in Design view, 18.3.1

deleting in Source view, 18.3.2

HTML Markup, 18.2.4, 18.2.4.3

Hyperlink, 18.2.6.1

Image, 18.2.7

Links, 18.2.5

adding, 18.2.5.2.1

advanced search and, 18.2.5.2.2

configuring a link, 18.2.5.2.3

configuring the component, 18.2.5.2

deleting links, 18.2.5.2.5

permissions required, 18.2.5.1

reordering links, 18.2.5.2.4

Movable Box, 18.2.3

panelGroupLayout, 18.2.10.1

panelStretchLayout, 18.2.10.1

panelTabbed, 18.2.10.1

properties, 18.2

Allow Action, 18.2.2.2

Bottom Height, 18.2.10.3

Child Creation, 18.2.10.4

Depressed Icon, 18.2.7.2

Destination, 18.2.6.2, 18.2.7.2

Dimensions From, 18.2.10.4

Disabled Icon, 18.2.7.2

Disclosed, 18.2.10.6

End Width, 18.2.10.3

Escape, 18.2.4.2

Halign, 18.2.10.2

Height, 18.2.10.7

Horizontal Alignment, 18.2.2.2

Hover Icon, 18.2.7.2

Icon, 18.2.7.2, 18.2.10.6

Icon Position, 18.2.7.2

Image, 18.2.7.2

Inflexible Height, 18.2.10.6

Landmark, 18.2.10.2

Layout, 18.2.2.2, 18.2.10.2

Links, 18.2.5.3

Navigation, 18.2.5.3

No Wrap, 18.2.4.2

Open in new window, 18.2.6.2

Position, 18.2.10.4

setting in Design view, 18.2.1.1

setting in Source view, 18.2.1.2

Short Desc, 18.2.2.2, 18.2.4.2, 18.2.7.2, 18.2.9.2, 18.2.10.2, 18.2.10.3, 18.2.10.4, 18.2.10.7

Show Component, 18.2.2.2

Show Icons, 18.2.5.3

Show Levels, 18.2.5.3

Show Root, 18.2.5.3

Show Split Action, 18.2.2.2

Show Tab Action, 18.2.2.2

Source, 18.2.9.2

Start Path, 18.2.5.3

Start Width, 18.2.10.3

Style, 18.2.5.3

Tab Removal, 18.2.10.4

Target Frame, 18.2.7.2

Text, 18.2.7.2, 18.2.10.6

Text And Access Key, 18.2.7.2

Theme, 18.2.10.2, 18.2.10.3

Title, 18.2.6.2

Top Height, 18.2.10.3

Valign, 18.2.10.2

Value, 18.2.4.2

Vertical Alignment, 18.2.2.2

Width, 18.2.10.7

rearranging, 17.5.2.6.2

showDetailFrame, 18.2.10.1

sidebarItem, 18.2.10.1

spacer, 18.2.10.1

Text, 18.2.8.1

Web Page, 18.2.9.1

See also internal layout components

Layout property, 18.2.2.2, 18.2.10.2, 42.4.1

LDAP identity store, People Connections service and, 6.4.2

Leave Space Spaces component, 13.2.19

Left Narrow page style, 15.1

Like icon, 41.5.2.6, 41.27

liking

a file, 41.27, 41.28

application objects, 34.1

unliking a file, 41.27, 41.28

unliking application objects, 34.1, 34.1

Link Window column detail in lists, 64.2.3.2.2

links

about, 63.1

creating, 63.2

deleting, 63.2.4

document component, 41.2

from content to navigation nodes, 40.7

from files to other items, 41.19

icon, 63.1

lists and, 64.1, 64.2.6

permissions, 20.3.2

properties, 42.12

Destination, 42.12.1

Open in new window, 42.12.1

Show Component, 42.12.1

Title, 42.12.1

sharing through Publisher, 34.3

sharing through Publisher task flow, 34.3.3.4

to existing objects, 63.2.1

announcements, 63.2.1.2

discussions, 63.2.1.3

documents, 63.2.1.4

events, 63.2.1.5

to new objects, 63.2.2

discussions, 63.2.2.2

documents, 63.2.2.3

events, 63.2.2.4

notes, 63.2.2.5

to Space, 51.14.1

to URLs, 63.2.2.6

viewing using Microsoft Office integration, 46.3.4.8

Links layout component

about, 18.2.5

adding, 18.2.5.2.1

content link, 18.2.5.2.1

external link, 18.2.5.2.1

page link, 18.2.5.2.1

advanced search and, 18.2.5.2.2

configuring a link, 18.2.5.2.3

configuring the component, 18.2.5.2

deleting links, 18.2.5.2.5

display options, 18.2.5.3

parameters

Navigation, 18.2.5.3

Show Icons, 18.2.5.3

Show Levels, 18.2.5.3

Show Root, 18.2.5.3

Start Path, 18.2.5.3

Style, 18.2.5.3

permissions required, 18.2.5.1

reordering links, 18.2.5.2.4

List Events in Number of Upcoming Days property, 61.3.3

List ID property, 64.3.2

List Scope ID property, 64.3.2

List View display template, 40.5

List Viewer task flow

about, 64.1

parameters

about, 64.3

List ID, 64.3.2

Local List Customization ID, 64.3.2

Local List ID, 64.3.2

Show List Name and Description, 64.3.2

parametersr

List Scope ID, 64.3.2

List with Details Panel View display template, 40.5

lists, 64

about, 64.1

activities tracked by Activity Stream, 6.4.3.2, 32.1

adding a list row, 64.2.4.1

adding columns to, 64.2.3.2.2

adding data, 64.2.4.1.1

DateTime data type, 64.2.4.1.4

Person data type, 64.2.4.1.6

Picture data type, 64.2.4.1.5

Plain Text data type, 64.2.4.1.2

Rich Text data type, 64.2.4.1.3

color banding, 64.2.5.7

applying to all views, 64.2.5.7.3

applying to your view, 64.2.5.7.1

removing from all views, 64.2.5.7.4

removing from your view, 64.2.5.7.2

column details, 64.2.3.2.2

Allow Links, 64.2.3.2.2

Default Value, 64.2.3.2.2

Display Width, 64.2.3.2.2

Format, 64.2.3.2.2

Hint, 64.2.3.2.2

Link Window, 64.2.3.2.2

Maximum Length, 64.2.3.2.2

Maximum Value, 64.2.3.2.2

Minimum Value, 64.2.3.2.2

Number of Lines for Editing, 64.2.3.2.2

Range of Users, 64.2.3.2.2

Required, 64.2.3.2.2

revising, 64.2.3.2.3

validation on, 64.2.3.2.3

columns

freezing, 64.2.5.5

hiding, 64.2.5.4

rearranging, 64.2.3.2.4, 64.2.5.3

resizing your own view, 64.2.5.2

showing hidden, 64.2.5.4

sorting your own view, 64.2.5.1.1

turning text wrapping off, 64.2.5.6

unfreezing, 64.2.5.5

wrapping text, 64.2.5.6

copying, 64.2.3.3

creating, 64.2.3.1

customizing, 64.2.5

data types, 64.2.3.2.2

Boolean, 64.2.3.2.2

DateTime, 64.2.3.2.2

Number, 64.2.3.2.2

Person, 64.2.3.2.2

Picture, 64.2.3.2.2

Plain Text, 64.2.3.2.2

Rich Text, 64.2.3.2.2

deleting

a list, 64.2.3.4

list columns, 64.2.3.2.5

list rows, 64.2.4.3

editing

a list row, 64.2.4.2

list data, 64.2.4.2

structure, 64.2.3.2

exporting, 64.2.7

about, 64.2.7.1

to a spreadsheet, 64.2.7.2

filtering list data, 64.2.5.8

ad hoc filtering, 64.2.5.8.1

Boolean operators, 64.2.5.8.2

DateTime operators, 64.2.5.8.2

filtering all views of one instance, 64.2.5.8.4

Numbering operators, 64.2.5.8.2

permanent, personal filtering, 64.2.5.8.2

Person operators, 64.2.5.8.2

Plain Text operators, 64.2.5.8.2

removing from all views of one instance, 64.2.5.8.5

removing personal filter, 64.2.5.8.3

importing, 64.2.7

about, 64.2.7.1

from a spreadsheet, 64.2.7.3

integration with Links service, 64.1

integration with RSS service, 64.1

Lists system page, 64.1

number of columns allowed, 64.2.3.2.2

properties

about, 64.3.1

rearranging columns

of all instances, 64.2.3.2.4

of one instance, 64.2.5.3

renaming, 64.2.3.2.1

revising description of, 64.2.3.2.1

rows

adding, 64.2.4.1

deleting, 64.2.4.3

editing, 64.2.4.2

sending a link to a, 64.2.6

sorting against non-Oracle databases, 64.2.5.1

task flows

List Viewer task flow, 64.1

properties, 64.3.2

templates

custom, 64.2.3.1

issues, 64.2.3.1

milestones, 64.2.3.1

objectives, 64.2.3.1

viewing, 64.2.2

Lists service, 64

Lists system page, 7.3.1, 64.1

Local List Customization ID property, 64.3.2

Local List ID property, 64.3.2

Login Spaces component, 13.2.20

Login system page, 7.3.1

logo

changing for a Space, 51.4.8

changing for the application, 5.1

Logout Spaces component, 13.2.21

Long Desc URL property, 42.14.1

Long Time Period in minutes property, 69.3.2

Longest Time Period in minutes property, 69.3.2

M

mail

about, 65.2

account limit, 29.2

attaching files, 65.4.7

composing and sending, 65.4.6

configuring for Spaces, 51.10.2

configuring send mail notifications, 6.3

deleting, 65.4.11

downloading attachments, 65.4.5

duplicate mail IDs, 29.2

forwarding, 65.4.9

logging in to Mail service, 65.4.2

opening, 65.4.4

personalizing the task flow, 65.4.3

preferences, 65.3

public mail credentials, 29.2

publishing for Spaces, 51.10.4

refreshing, 65.4.10

removing attachments, 65.4.8

replying, 65.4.9

sending from Microsoft Office task pane, 46.3.4.12

Space members for page, 51.7.11

to connections, 46.3.4.12.2

to current user of document, 46.3.4.12.1

to Space members, 46.3.4.12.3, 52.3.7

Mail service, 65

task flows

Mail, 65.2

See also mail

Mail Space Members Spaces component, 13.2.22

Mail Space Moderators Spaces component, 13.2.23

Mail task flow, 65.5.2

Make Public action, 51.7.8

Manage Pages Spaces component, 13.2.24

Margin property, 17.5.2.7.2

mashups

about, 26.1

data controls

about, 26.1.1

adding as forms, 26.4.1.2

adding as graphs, 26.4.1.3

adding as tables, 26.4.1.1

consuming, 26.4

copying, 26.2.3.2

database connections, 26.2.1.1

deleting, 26.2.3.7

editing, 26.2.3.3

editing bind variables, 26.2.3.4

exporting and importing, 26.2.5

hiding or showing, 26.2.3.1

managing, 26.2.3

setting properties, 26.2.3.5

SQL data controls, 26.2.1

Web Services data controls, 26.2.2

editing visualizations, 26.4.6

examples, C

Analytics service, C.1

custom mashup style, C.6

Siebel data source, C.5

SQL data control, C.2

WebCenter Spaces Web Services, C.4

mashup styles, 26.3.4

copying, 26.3.4.2

creating in JDeveloper, 26.3.4.9

deleting, 26.3.4.8

editing, 26.3.4.4

hiding in Create Task Flow dialog, 26.3.4.3

managing, 26.3.4

seeded, 26.3.4.1

showing hidden in Create Task Flow dialog, 26.3.4.3

supported visualizations, 26.1.2

task flows, 26.3

consuming, 26.4.5

copying, 26.3.2.2

creating, 26.3.1

deleting, 26.3.2.7

editing, 26.3.2.3

editing in JDeveloper, 26.3.2.8

hiding or showing, 26.3.2.1

managing, 26.3.2

parameters, 26.4.2

previewing, 26.3.2.4

setting properties, 26.3.2.5

using design-time data controls, 26.2.4

using design-time task flows, 26.3.3

wiring parameters, 26.4.4

writing to a data source, 26.4.7

Maximum Calendars property, 61.3.2

Maximum Documents property, 42.7.1

Maximum Enabled Calendars property, 61.3.2

Maximum Length column detail in lists, 64.2.3.2.2

Maximum Results property, 40.11.2

Maximum Value column detail in lists, 64.2.3.2.2

media, embedding, 18.2.4.3

Medium Time Period in minutes property, 69.3.2

members

adding to Spaces, 52.3.4

Spaces, 52.3.2

Members page in Spaces, 51.6

Members task flow

about, 52.4

contacting members, 52.4.3, 52.4.4

editing parameters, 52.4.7.2

filtering, 52.4.6

managing membership, 52.4.2

parameters

Group Space Name, 52.4.7.2

Number of Columns, 52.4.7.2

Number of Rows, 52.4.7.2

Profile Launched on Selection, 52.4.7.2

Sort Criteria, 52.4.7.2

sorting, 52.4.5

membership

policy in Spaces, 52.1

revoking from Spaces, 52.3.8

Spaces, 52.3.6

Message Board, 33

about, 33.1.1

activities tracked by Activity Stream, 6.4.3.2, 32.1

attaching a file, 33.4.1.2.5

attaching a link, 33.4.1.2.5

commenting, 34.2

configuring, 6.4.3.5

deleting messages, 33.4.1.7

editing messages, 33.4.1.3

enabling others to post, 33.3

filtering messages, 33.4.1.4

hiding messages, 33.4.1.5

liking, 34.1

permissions required, 33.1.1

posting

private messages, 33.4.1.2.3

to a Space, 33.4.1.2.2

to connections, 33.4.1.2.1

preferences, 33.2.1

properties, 33.5.1

sharing a private message, 33.4.1.2.4

showing hidden messages, 33.4.1.6

sorting messages, 33.4.1.4

subscribing to, 36.3.1

task flows

about, 33.4.1

properties, 33.5, 33.5.1, 33.5.2

troubleshooting, 6.4.5.4

viewing messages, 33.4.1.1

Message Board - Quick View task flow

about, 33.1.1

parameters

Group Space, 33.5.2, 33.5.3.6

Hide Actions, 33.5.2, 33.5.3.1

Hide Footer, 33.5.2

Hide Header, 33.5.2

Hide Publisher, 33.5.2, 33.5.3.4

No of Messages, 33.5.2, 33.5.3.2

User Name, 33.5.2

Message Board task flow

about, 33.1.1

parameters

End Date, 33.5.2, 33.5.3.7

Group Space, 33.5.2, 33.5.3.6

Hide Header, 33.5.2

Hide Publisher, 33.5.2, 33.5.3.4

No of Messages, 33.5.2, 33.5.3.2

Start Date, 33.5.2, 33.5.3.7

User Name, 33.5.2

Message key of hints text property, 34.3.3.5.2

messaging

accessing configuration settings, 36.2.1

applying a filter, 36.2.5

creating a filter, 36.2.5

deleting a channel, 36.2.4

deleting filters, 36.2.7

editing a channel, 36.2.3

editing filters, 36.2.6

establishing channels, 36.2, 36.2.2

establishing filters, 36.2

preferences, 36.1, 36.2

standard notification subjects, 36.2.5

valid operators, 36.2.5

metadata

of pages, 29.9

of Spaces, 29.9

Microsoft Excel, building lists with, 64.2.7.1

Microsoft Exchange Server, accessing calendar, 61.2.2

Microsoft Office

creating a Space from, 46.3.1

files

authentication, 41.12.3

editing in-place, 41.12.3

integration

about, 46.1.1

adding files to content repository, 46.3.4.1

checking in files, 46.3.4.4

checking out files, 46.3.4.3

closing files, 46.3.5

creating folders, 46.3.4.2

managing current file, 46.3.4.5

managing folders, 46.3.4.7

managing Space files, 46.3.4.6

opening files, 46.3.2

task pane, 46.3.4

viewing document information, 46.3.4.9

viewing document links, 46.3.4.8

viewing version history of files, 46.3.4.10

working with, 46.3

task pane

displaying or hiding, 46.3.3.1

sections, 46.3.4

Microsoft Windows Explorer integration, about, 46.1.2

Microsoft Word

See Microsoft Office integration

Minimum Value column detail in lists, 64.2.3.2.2

mod_osso, Web Clipping and, 28.4

moderator of a Space, 51.1

Moderator role (in a Space), 52.2.1.1

Most Recent First property, 42.7.1

Movable Box layout component

about, 18.2.3

display options, 18.2.3.2, 18.2.3.2

music files, embedding, 18.2.4.3

My Accounts preferences, 35.7

My Profile

business role page, 7.1.1

page in Home Space, 29.10

system page, 7.3.1

N

Navigate to Announcement Viewer property, 59.3.2

navigation, 11

adding ad hoc navigation, 18.2.5.1

built-in navigation models, 11.1.1

choosing the default, 5.9

EL expressions relating to, B.3.4

in a Space, 51.11

Links layout component, 18.2.5.1

navigation model, 11.1, 11.2.1

navigation visualization, 11.1

sending a link to a page, 29.7

task flows, 11.3.1

to a Space, 29.3.1

to pages, 29.3.2

to the Home Space, 29.3.1

Navigation Breadcrumb task flow, 11.3.2.2

Navigation Menu task flow, 11.1.2, 11.1.2, 11.3.2.2

navigation model

about, 11.1.1

adding

a document, 11.2.2.1.1

content query, 11.2.2.1.2

external application, 11.2.2.1.3

pages, 11.2.2.1.4

portlet, 11.2.2.1.3

Spaces, 11.2.2.1.5

Spaces page, 11.2.2.1.3

task flow, 11.2.2.1.3

Web page, 11.2.2.1.3

copying, 11.2.3.4

creating, 11.2.1

creating in JDeveloper, 11.2.5

default, 11.2.4

delegated management, 11.2.2.1.6

deleting, 11.2.3.5

direct reference, 11.2.2.1.8

display options, 11.2.2.1.8

editing source code, 11.2.2.2

hiding, 11.2.3.1

linking to nodes from content, 40.7

nesting, 11.2.2.1.6

organizing, 11.2.2.1.7

properties, 11.2.3.2

security, 11.2.3.3

showing, 11.2.3.1

Navigation property, 11.3.2.2, 11.3.2.2, 11.3.2.2, 18.2.5.3

navigation task flows

about, 11.1.2, 11.3.1

breadcrumbs, 11.3.2.3.5

linking, 11.3.2.3.6

menu structure, 11.3.2.3.4

parameters

Display Style, 11.3.2.2

Navigation, 11.3.2.2, 11.3.2.2, 11.3.2.2

Second Level Style, 11.3.2.2

Show Icons, 11.3.2.2, 11.3.2.2

Show Levels, 11.3.2.2

Show Root, 11.3.2.2, 11.3.2.2

Start Path, 11.3.2.2, 11.3.2.2, 11.3.2.2

Style, 11.3.2.2, 11.3.2.2

start path, 11.3.2.3.2

tree structure, 11.3.2.3.3

Navigation Tree task flow, 11.1.2, 11.3.2.2

navigation visualization, 11.1

about, 11.1.2

breadcrumbs, 11.3.2.3.5

creating in JDeveloper, 11.3.3

linking task flows, 11.3.2.3.6

menu, 11.3.2.3.4

task flows, 11.1.2

tree, 11.3.2.3.3

network place, adding a Space as, 46.4.1

New Folder menu action, 41.5.1.1

New Wiki Document action, 41.5.1.3

No of activities to display per page property, 32.5.2

No of Feedback Items property, 33.5.2, 33.5.3.2

No of Messages property, 33.5.2, 33.5.3.2

No Page Accessible system page, 7.3.1

No Wrap property, 18.2.4.2

notes

about, 66.1

creating, 66.2.3

creating links, 63.2.2.5

deleting, 66.2.7

editing, 66.2.5

filtering, 66.2.4

Notes task flow

adding to a page, 66.2.2

adding to Resource Catalog, 66.2.1

editing properties, 66.3

refreshing, 66.2.6

Notes task flow

adding to a page, 66.2.2

adding to Resource Catalog, 66.2.1

editing properties, 66.3

notifications

about, 36.1

activities that can trigger, 36.1

administrator defaults, 36.1

properties, 36.5.3

standard message subjects, 36.2.5

Subscription Preferences Spaces component, 13.2.35

task flows, 36.5

about, 36.5.1

properties, 36.5.3, 36.5.3.2

Subscription Preferences, 36.5.1

Subscription Viewer, 36.5.1

Number data type in lists, 64.2.3.2.2

Number of Announcements on Extended Mini View property, 59.3.2

Number of Announcements to Show property, 59.3.2

Number of Columns property, 31.5.2, 52.4.7.2

Number of Connections per page property, 31.5.2, 31.5.3.4

Number of Events Per Page property, 61.3.3

Number of Expanded Announcements property, 59.3.2

Number of Lines for Editing column detail in lists, 64.2.3.2.2

Number of Rows (list layout) property, 31.5.2, 31.5.3.5

Number of Rows property, 31.5.2, 31.5.3.5, 52.4.7.2

numbers, Expression Language, B.1

O

Object Id property, 34.3.3.5.2

Object Name property, 58.3.2

Object Type property, 34.3.3.5.2

OmniPortlet

about, 25.4.5, 27.1

customizing, 27.2.2, 27.2.8

database connection, 27.2.4.2

Edit Defaults mode, 27.2.8

editing component properties, 27.4

Filter tab, 27.2.5

filtering data, 27.2.5

Layout tab, 27.2.7

layouts

bullet, 27.2.7.4

chart, 27.2.7.2

customized, 27.2.7.6

form, 27.2.7.5

HTML, 27.2.7.6

news, 27.2.7.3

parameter form, 27.2.7.7

tabular, 27.2.7.1

portlet parameters, 27.3

properties

All Modes Shared Screen, 27.4.2

Id, 27.4.2

Param#, 27.4.2

Partial Triggers, 27.4.2

Render Portlet In I Frame, 27.4.2

Title, 27.4.2

proxy authentication, 27.2.4.1

Source tab, 27.2.4

SQL data source, 27.2.4.4

troubleshooting, 27.5

Type tab, 27.2.3

using data sources, 27.2.3

using the wizard, 27.2.2

using Web pages as a data source, 27.2.4.7

View tab, 27.2.6

Web Service data source, 27.2.4.6

XML data source, 27.2.4.5

Open as PDF menu action, 41.5.2.2, 41.10

Open in Browser menu action, 41.5.2.2, 41.10

Open in new window property, 18.2.6.2, 42.12.1

Open Site in Browser, 46.3.4

Oracle AutoVue, 45.3

Oracle Composer

concurrency warning, 17.3.1

Design view, 17.3.2

EL expressions relating to, B.3.8

Resource Catalog, 18.1

Source view, 17.3.2

Oracle JSF Portlet Bridge, 19.2.1

Oracle PDK-Java producers

deregistering, 6.5.4

registering, 6.5.2.2, 6.5.3.2

Oracle Portal pages, Web Clipping limitation for, 28.4

Oracle Site Studio

See Site Studio content

Oracle WebCenter Spaces

accessibility, 35.4

assistive technology, 35.4

date preference, 35.3

EL expressions relating to, B.3.2

password policy, 29.2

self registering, 29.2

time preferences, 35.3

URL format, 29.2

user name policy, 29.2

See also WebCenter Spaces

Org Bread Crumbs Shown property, 30.6.2

Organization View task flow

about, 30.1

parameters

Control Panel Shown, 30.6.2, 30.6.3.3

User Id, 30.6.2

orientation of content, 18.2.2.1

Other CSS property, 17.5.2.7.2

changing component borders, 17.5.2.7.4

examples, 17.5.2.7.3

background-position, 17.5.2.7.3

background-repeat, 17.5.2.7.3

font-size, 17.5.2.7.3

padding, 17.5.2.7.3

padding-bottom, 17.5.2.7.3

padding-left, 17.5.2.7.3

padding-right, 17.5.2.7.3

padding-top, 17.5.2.7.3

on Content Style tab, 17.5.2.7.3

on Style tab, 17.5.2.7.3

Outlook Add-in Discussions system page, 7.3.1

Outlook Add-in Documents system page, 7.3.1

Outlook Add-in Events system page, 7.3.1

Outlook Add-in Members system page, 7.3.1

Outlook Add-in Space Home system page, 7.3.1

out-of-the-box Space templates, 50.1

P

Page Links Spaces component, 13.2.25

Page Not Found system page, 7.3.1

page permissions, 20.3.2

Page service

activities tracked by Activity Stream, 6.4.3.2, 32.1

EL expressions relating to, B.3.7

Page Size property, 42.2.1, 42.3.1, 42.4.1, 42.5.1, 42.6.1

page templates, 5.8

about, 12.1

adding

content, 12.3.1

navigation, 12.3.1

Spaces components, 12.3.1

applying to a Space, 12.6

changing in a Space, 51.4.9

choosing default resource catalogs, 5.10

content region, 12.3.1

copying, 12.5.4

creating, 12.2

creating with JDeveloper, 12.8

customizing for a Space, 12.4

default Resource Catalog, 12.7

deleting, 12.5.5

editing, 12.3

editing source code, 12.3.2

hiding, 12.5.1

in a Space, 51.11

out-of-the-box page templates, 12.1.1

previewing, 12.5.6

properties, 12.5.2

security, 12.5.3

selecting, 5.8, 5.9

showing, 12.5.1

Page Viewer system page, 7.3.1

pagelet producers, registering

through the Producer Registration task flow, 6.5.3.2

through WebCenter Administration, 6.5.2.3

pages

about, 17.1

adding

a page footer, 17.3.5.2

a page header, 17.3.5.2

content, 17.5

files, 41.3

folders, 41.3

new content regions, 17.3.5.4

Search task flow, 56.3.2.2

tabs, 17.3.5.5

to a navigation model, 11.2.2.1.3, 11.2.2.1.4

to Home Space, 49.17, 51.7.10

administration pretty URLs, A.4

applying tags, 57.2.2

background color, 17.3.4

background image, 17.3.4

business role pages, 7.1

about, 7.1.1

Activities, 7.1.1

Analytics, 7.1.1

copying, 7.1.9

creating, 7.1.3

deleting, 7.1.10

display order, 7.1.7

Documents, 7.1.1

editing, 7.1.8

granting access, 7.1.4

My Profile, 7.1.1

revoking access, 7.1.4.1

seeded, 7.1.1

setting page creation defaults, 7.1.2

Space Templates, 7.1.1

Spaces, 7.1.1

specifying a target audience, 7.1.4

Tag Center, 7.1.1

changing

page column widths, 17.3.5.3

page layout, 17.3.5.1

page order, 29.3.5

clearing deleted Space page from Home Space, 29.5, 49.17

concurrency warning, 17.3.1

consuming page parameters, 19.3.2

content

adding, 17.5.1

orientation of, 18.2.2.1

setting properties on, 17.5.2

controlling access in Space, 49.15, 51.7.8

copying in a Space, 49.13, 51.7.6

creating

in a Space, 17.2, 51.7.2

page parameters, 19.3.1

personal in Space, 49.10

CSS encoding, 17.3.4

customizing page components, 17.5.2.1

deleting, 17.6, 49.16, 51.7.9

description, 29.9.2

directory path, obtaining, 18.2.6.1

edit mode

Design view, 17.3.2

Source view, 17.3.2

editing, 17.3, 49.12, 51.7.5

EL expressions relating to, B.3.7

embedding media, 18.2.4.3

exposing Space pages in Home Space, 29.5

GUID, 29.9.2

hiding, 29.3.3, 49.11, 51.7.3

Home Space

controlling access, 38.2, 38.2.1

copying, 38.4

creating, 38

creating pages in, 38.1.2

deleting, 38.5

editing, 38.3

managing, 38

page creation defaults, 38.1.1

revoking access, 38.2.2

security, 38.2, 38.2.1, 38.2.2

internal ID, 29.9.2

layout components

about, 18

adding, 18.1

Box, 18.2.2

deleting, 18.3

HTML Markup, 18.2.4

Hyperlink, 18.2.6.1

Image, 18.2.7

Links, 18.2.5

Movable Box, 18.2.3

panelGroupLayout, 18.2.10.1

panelStretchLayout, 18.2.10.1

panelTabbed, 18.2.10.1

properties, 18.2

setting properties on, 18.2.1.1

showDetailFrame, 18.2.10.1

sidebarItem, 18.2.10.1

spacer, 18.2.10.1

Text, 18.2.8.1

Web Page, 18.2.9.1

See also internal layout components

Lists system page, 64.1

mailing link in a Space, 49.18, 51.7.11

managing in a Space, 51.7

marking as a favorite, 37.3

metadata, 29.9

My Profile, 29.10

navigating to, 29.3.2

page access permissions, 23.1

page parameters, about, 19.1

passing parameter values, 19.4

personal pages

about, 7.2.1

adding to navigation, 7.2.5

changing permissions, 7.2.3

copying, 7.2.7

deleting, 7.2.8

editing, 7.2.6

granting access, 7.2.3

managing, 7.2

preventing creation of, 7.2.4

revoking access, 7.2.3

setting page creation defaults, 7.2.2

personalization, 9.1, 17.4

printing, 29.8

rearranging, 29.3.5

rearranging content, 29.4.2.1

renaming, 29.6

renaming in a Space, 49.14, 51.7.7

reordering, 29.3.5

security, 23.1, 49.15, 51.7.8

Delete Page permission, 23.1, 38.2.1

Edit Page permission, 23.1, 38.2.1

Perform All Page Actions permission, 23.1, 38.2.1

Personalize Page permission, 23.1, 38.2.1

View Page permission, 23.1, 38.2.1

sending a link to, 29.7

setting page access, 23.1

showing hidden, 29.3.4, 49.11, 51.7.3

styles

about, 15.1

applying, 15.5

Blank page style, 15.1

Blog page style, 15.1

building with JDeveloper, 15.6

copying, 15.4.4

creating a custom page style, 15.2

default page styles, 15.1

deleting, 15.4.5

editing style source, 15.3

editPageAfterCreation attribute, 15.4.2

hiding in Create Page dialog, 15.4.1

Home Page page style, 15.1

Left Narrow page style, 15.1

managing, 15.4

previewing, 15.4.6

Right Narrow page style, 15.1

setting security on, 15.4.3

setting style attributes, 15.4.2

setting style properties, 15.4.2

showing in Create Page dialog, 15.4.1

Three Column page style, 15.1

Web Page page style, 15.1

Wiki page style, 15.1

system pages, 7.3

about, 7.3.1

Activity Stream, 7.3.1

Announcements, 7.3.1

customizing, 7.3.2

Discussions, 7.3.1

Documents, 7.3.1

Error Encountered, 7.3.1

Events, 7.3.1

Lists, 7.3.1

Login, 7.3.1

My Profile, 7.3.1

No Page Accessible, 7.3.1

Outlook Add-in Discussions, 7.3.1

Outlook Add-in Documents, 7.3.1

Outlook Add-in Events, 7.3.1

Outlook Add-in Members, 7.3.1

Outlook Add-in Space Home, 7.3.1

Page Not Found, 7.3.1

Page Viewer, 7.3.1

Resource Viewer, 7.3.1

Search, 7.3.1

seeded, 7.3.1

Self Registration, 7.3.1

Space Not Found, 7.3.1

Subscribe, 7.3.1

Tag Center, 7.3.1

Task Flow Editor, 7.3.1, 8.4

Task Flow Viewer, 7.3.1

Unauthorized, 7.3.1

Unavailable, 7.3.1

User Profile, 7.3.1

WebCenter Welcome Page, 7.3.1

user customizations, 29.4.1, 29.4.2

viewing, 49.8

viewing information about, 29.9, 49.19, 51.7.12

wiring, 19

wiring page parameters to components, 19.3

Pagination property, 32.5.2

panelGroupLayout layout component, 18.2.10.1

about, 18.2.10.2

display options

Halign, 18.2.10.2

Landmark, 18.2.10.2

Layout, 18.2.10.2

Short Desc, 18.2.10.2

Show Component, 18.2.10.2

Theme, 18.2.10.2

Valign, 18.2.10.2

panelStretchLayout layout component, 18.2.10.1

about, 18.2.10.3

display options

Bottom Height, 18.2.10.3

End Width, 18.2.10.3

Short Desc, 18.2.10.3

Show Component, 18.2.10.3

Start Width, 18.2.10.3

Theme, 18.2.10.3

Top Height, 18.2.10.3

panelTabbed layout component, 18.2.10.1

about, 18.2.10.4

display options

Child Creation, 18.2.10.4

Dimensions From, 18.2.10.4

Position, 18.2.10.4

Short Desc, 18.2.10.4

Show Component, 18.2.10.4

Tab Removal, 18.2.10.4

Param# property, 27.4.2, 28.3.2

Parameter Display portlet, about, 25.4.6

parameter form layout in OmniPortlet, 27.2.7.7

Parameter Form portlet, about, 25.4.6

parameters

about, 17.5.2.2, 17.5.2.4

consuming page parameters, 19.3.2

creating page parameters, 19.3.1

EL editor, 17.5.2.4, B.1

Page Size, 42.2.1

passing values through page URL, 19.4

Tabular, 65.5.2

validating expressions, B.1

See also properties

Parent Space Spaces component, 13.2.26

Partial Triggers property, 19.2.2, 27.4.2, 28.3.2

Participant role (in a Space), 52.2.1.1

password policy, 29.2

passwords

enabling users to change, 6.4.3.4

external applications, 35.7

setting for application, 35.6

Paste menu action, 41.5.1.1

PDF

opening files in, 41.23

saving files in, 41.23

People Connections service, 6.4

about administering, 6.4.1

accessing administrative settings, 6.4.3.1

Activity Stream, 6.4.4, 32

Comments option, 6.4.3.2

Likes option, 6.4.3.2

People options, 6.4.3.2

Privacy options, 6.4.3.2, 6.4.3.2

properties, 32.5.2

Service Categories options, 6.4.3.2

Spaces options, 6.4.3.2

collaborative services and, 3.3.2

configuring, 6.4.3

Activity Stream, 6.4.3.2, 6.4.3.2, 32.1

Connections, 6.4.3.3

Feedback, 6.4.3.6

Message Board, 6.4.3.5

order of precedence of, 6.4.1

Profile, 6.4.3.4

Connections, 31

adding users to lists, 31.4.5.2

creating lists of, 31.4.5.1

deleting lists of, 31.4.5.4

deleting users, 31.4.6

inviting users to connect, 31.4.2

lists, creating, 31.4.5

lists, managing, 31.4.5

properties, 31.5.2

removing users from lists, 31.4.5.3

responding to invitations, 31.4.4

searching, 31.4.1.2

sending mail to, 46.3.4.12.2

setting up, 31.4

viewing, 31.4.1.1

viewing pending invitations, 31.4.3.2

viewing received invitations, 31.4.3.2

viewing sent invitations, 31.4.3.1

EL expressions relating to, B.3.13

Feedback, 33

LDAP identity store and, 6.4.2

Message Board, 33

Profile, 30.1, 30.5

defining access, 6.4.3.4

editing, 30.5.2

enabling attribute edits, 6.4.3.4

information sections, 6.4.3.4

uploading a profile photo, 30.5.3

viewing, 30.5.1

social networking and, 3.3.2

task flows

Activity Stream, 32.1

Activity Stream - Quick View, 32.1

Connections, 31.1

Connections - Card, 31.1

Connections - Detailed View, 31.1

Connections - Quick View, 31.1

Feedback, 33.1.2

Feedback - Quick View, 33.1.2

Message Board, 33.1.1

Message Board - Quick View, 33.1.1

Organization View, 30.1

Profile, 30.1

Profile - Snapshot, 30.1

Profile Gallery, 30.1

properties, 31.5.1

Publisher, 34.3.3.1

troubleshooting, 6.4.5

Activity Stream, 6.4.5.1

Connections, 6.4.5.2

Feedback, 6.4.5.5

Message Board, 6.4.5.4

Profile, 6.4.5.3

WebCenter Repository and, 6.4.2

Perform All Page Actions permission, 23.1, 38.2.1

permissions, 20.3.2

Discussions server, 20.3.2.2

Spaces, 52.2

advanced model, 52.2.1.2

standard model, 52.2.1.2

WebCenter Spaces, 20.3.2

Person data type in lists, 64.2.3.2.2

personal calendar, accessing, 61.2.2

Personal Documents in Resource Catalog, 39.2

personal pages

about, 7.2.1

adding to navigation, 7.2.5

changing permissions, 7.2.3

copying, 7.2.7

deleting, 7.2.8

editing, 7.2.6

granting access, 7.2.3

managing, 7.2

preventing creation of, 7.2.4

revoking access, 7.2.3

personalization

of pages, 9.1, 17.4

of pages in a Space, 49.9

Web Clipping, 28.2.2

See also user customization

Personalization Conductor

EL expressions relating to, B.3.11

selecting content based on scenario, 40.4.5

Personalize Page permission, 23.1, 38.2.1

photo, uploading for Profile, 30.5.3

Picture data type in lists, 64.2.3.2.2

picture, uploading for Profile, 30.5.3

Plain Text data type in lists, 64.2.3.2.2

Poll Id property, 67.3.2

polls

analyzing, 67.2.3, 67.2.3

creating, 67.2.2

managing, 67.2.3

publishing, 67.2.2

viewing status, 67.2.3

Polls - Polls Manager task flow, 67.3.1

about, 67.2.3

parameters

Scope, 67.3.2

Show User Data Only, 67.3.2

Polls - Quick Poll task flow

about, 67.2.2

parameters

Show In Edit Mode, 67.3.2

Polls - Take Polls task flow, 67.3.1

about, 67.2.4

parameters

Poll Id, 67.3.2

Polls - View Poll Results task flow, 67.3.1

about, 67.2.5

parameters

Poll Id, 67.3.2

Polls service

about, 3.3.6, 67

task flows

Polls Manager, 67.2.3, 67.3.1

Quick Poll, 67.2.2, 67.3.2

Take Polls, 67.2.4, 67.3.1

View Poll Results, 67.2.5, 67.3.2

polls task flows

adding to a page, 67.2.1

Portal Site template, 50.1.1

portals

about, 1.1.1

self registering to, 29.2

portlet parameters, OmniPortlet and, 27.3

portlet producers

AppConnectionManager role, 6.5.1

deregistering, 6.5.4

registering, 6.5

portlets

about, 25.1

Actions menu, 25.2

adding to a navigation model, 11.2.2.1.3

appearance, 25.2

automatic wiring, 19.2.2

chrome, 25.2

collapsing and expanding, 29.4.2.4

data source, 27.2.3, 27.2.4

spreadsheet, 27.2.4.3

SQL, 27.2.4.4

Web page, 27.2.4.7

Web Service, 27.2.4.6

XML, 27.2.4.5

dragging and dropping, 29.4.2.1

header, 25.2

JSF portlets, 25.4.2

OmniPortlet, 25.4.5, 27

Parameter Display portlet, 25.4.6

Parameter Form portlet, 25.4.6

rearranging, 29.4.2.1

registering producers, 6.5

removing, 29.4.2.2

resizing, 29.4.2.3

setting access on, 23.2

types, 25.4

Web Clipping, 25.4.4, 28

wiring, 19

automatic, 19.2.2

one to another, 19.2.2

to task flows, 19.2.3, 19.2.4

with OmniPortlet, 27.3

Position property, 18.2.10.4

POST Authentication Method, 6.6.2

PowerPoint

See Microsoft Office integration

Preferences

accessibility settings, 35.4

accessing, 35.1

Activity Stream, 32.2

application skin selection, 35.5

Connections, 31.2

date, 35.3

display language, 35.2

EL expressions relating to, B.3.14

external application logins, 35.7

general, 35.2

mail, 65.3

Messaging, 36.1, 36.2

my accounts, 35.7

password, 35.6

People Connections

Activity Stream, 32.2

Connections, 31.2

Feedback, 33.2.2

Message Board, 33.2.1

Profile, 30.3

presence, 62.3

Profile, 30.3

screen readers, 35.4

search, 56.2

setting, 35

Subscription Preferences Spaces component, 13.2.35

time, 35.3

User Preferences Spaces component, 13.2.37

Presence icon

about, 62.1

context menu, 62.1

presence states, 62.4.1

status message, 62.4.1

pretty URLs, A

application administration pages, A.4

Home Space, A.2

Space pages, A.3

user profile, A.1

Print Preview Spaces component, 13.2.27

privacy statement

for a Space, 51.4.14

for application, 5.2

Privacy URL Spaces component, 13.2.28

private Space pages, 51.7.8

private Space templates, 50.3.5

Producer Registration task flow, 6.5.3

adding to a page, 6.5.3.1

permissions, 6.5.3

properties, 6.5.3.3

registering Oracle PDK-Java producers, 6.5.3.2

registering pagelet producers, 6.5.3.2

registering WSRP producers, 6.5.3.2

Profile, 30.5

about, 30.1

activities tracked by Activity Stream, 6.4.3.2, 32.1

configuring, 6.4.3.4

defining access, 6.4.3.4

editing, 30.5.2

EL expressions relating to, B.3.13

enabling attribute edits, 6.4.3.4

in People Connections service, 30.1

information sections, 6.4.3.4

managing permissions, 20.3.2

My Profile

business role page, 7.1.1

system page, 7.3.1

viewing, 29.10

preferences, 30.3

properties, 30.6

about, 30.6.1

described, 30.6.2

task flows

about, 30.1

properties, 30.6

troubleshooting, 6.4.5.3

uploading a profile photo, 30.5.3

User Profile system page, 7.3.1

viewing profile gallery, 29.10, 30.5.1

Profile - Snapshot task flow

about, 30.1

parameters

Allow photo upload, 30.6.2, 30.6.3.1

Allow Status Update, 30.6.3.2

Allow status update, 30.6.2

Image Size, 30.6.2, 30.6.3.5

Org Bread Crumbs Shown, 30.6.2, 30.6.3.6

Profile Edit Link Shown, 30.6.2

User Name, 30.6.2

Profile Edit Link Shown property, 30.6.2

Profile Format property, 31.5.2, 31.5.3.7

Profile Gallery task flow

about, 30.1

parameters

Resource Id, 30.6.2

Profile ID property, 30.6.2

Profile Launched on Selection property, 31.5.2, 31.5.3.8, 52.4.7.2

Profile Only property, 32.5.2, 32.5.4.8

Profile task flow

about, 30.1

parameters

Edit Mode, 30.6.2, 30.6.3.4

Profile ID, 30.6.2

Section-Wise Edit Enabled, 30.6.2, 30.6.3.7

Profile User Id property, 32.5.2

Project Site template, 50.1.1

properties

about component, 17.5.2.2

action handlers, 17.5.2.8

Actions, 17.5.2.8

Activity Stream, 32.5, 32.5.2

Advanced Query, 32.5.2, 51.16.2.3.1

All Modes Shared Screen, 27.4.2, 28.3.2

Allow Action, 18.2.2.2

Allow Minimize, 17.5.2.5

Allow Move, 17.5.2.5

Allow photo upload, 30.6.2

Allow Remove, 17.5.2.5, 31.5.2, 31.5.3.1

Allow Resize, 17.5.2.5

Allow Status Update, 30.6.2

Announcement Length, 59.3.2

Background Color, 17.5.2.7.2

Background Image, 17.5.2.7.2

Bottom Height, 18.2.10.3

Calendar Overlay Style, 61.3.2

Calendar Style Class, 61.3.2

Calendar Toolbox Layout, 61.3.3

Category ID, 60.3.2

Child Components tab, 17.5.2.2, 17.5.2.6

Child Creation, 18.2.10.4

Chrome Style, 17.5.2.5

Class URN, 58.3.2

Class URN Restrictions, 58.3.2

Collapse Tree Navigation, 42.2.1

Color, 17.5.2.7.2

Connection List Name, 31.5.2, 31.5.3.2

Connection Name, 42.2.1, 42.3.1, 42.4.1, 42.5.1, 42.6.1, 42.7.1

Connections, 31.5.2

Content Presenter task flow, 40.11

Content Style tab, 17.5.2.2, 17.5.2.7

Content View Only, 59.3.2

Control Panel Shown, 30.6.2

Created After, 42.3.1

Created Before, 42.3.1

Creator, 42.3.1

Current View, 31.5.2, 31.5.3.3

Customization ID, 61.3.2, 61.3.3

Data Source, 40.11.2

Data Source Type, 40.11.2

Default Current Date, 61.3.2

Depressed Icon, 13.2.2.1, 18.2.7.2

Destination, 18.2.6.2, 18.2.7.2, 42.12.1

Dimensions From, 18.2.10.4

Disable Personalize and Customize, 61.3.2

Disabled Icon, 13.2.2.1, 18.2.7.2

Disclosed, 18.2.10.6

Display Header, 17.5.2.5

Display Message Size, 33.5.2, 33.5.3.3

Display Options tab, 17.5.2.2, 17.5.2.5

Display Shadow, 17.5.2.5

Display Style, 11.3.2.2

Display Tool Bar, 51.16.2.3.1

Display Type, 13.2.2.1

Display View, 51.16.2.3.1

Edit Mode, 30.6.2

EL editor, 17.5.2.4, 17.5.2.5

Enable Action, 17.5.2.8

Enable Context Info, 32.5.2

End Date, 33.5.2, 33.5.3.7

End Width, 18.2.10.3

Escape, 18.2.4.2

Event Text Length, 61.3.3

Events, 17.5.2.8

Events tab, 17.5.2.2, 17.5.2.8, 17.5.2.8

Exclude Object Actions, 58.3.2

Expand All Announcements in Extended Mini View, 59.3.2

Expression Language and, B

External Application ID, 68.4.2

Favorite Title, 13.2.4.1

Favorite URL, 13.2.4.1

Features Off, 42.2.1, 42.4.1, 42.5.1, 42.6.1, 42.8.1

Feedback, 33.5, 33.5.2

Filter, 51.16.2.3.1

Filter Pattern, 31.5.2, 31.5.3.6

Font, 17.5.2.5, 17.5.2.7.2

Font Color, 17.5.2.5

Font Size, 17.5.2.5, 17.5.2.7.2

Font Style, 17.5.2.5, 17.5.2.7.2

Forum ID, 59.3.2, 60.3.2

Group Space, 33.5.2, 33.5.3.6, 42.7.1, 61.3.2

Group Space Name, 52.4.7.2, 69.3.2

Halign, 18.2.10.2

Height, 17.5.2.7.2, 18.2.10.7

Hide Actions, 33.5.2, 33.5.3.1, 36.5.3.2, 36.5.3.3

Hide Attach Links, 34.3.3.5.2

Hide Comments, 32.5.2, 32.5.4.3

Hide Configuration Button, 32.5.2, 32.5.4.1

Hide Document Uploader, 34.3.3.5.2, 34.3.3.5.3

Hide Footer, 31.5.2, 32.5.2, 33.5.2

Hide Given, 33.5.2, 33.5.3.5

Hide Header, 31.5.2, 32.5.2, 33.5.2

Hide Inline Preview, 32.5.2, 32.5.4.2

Hide Like, 32.5.2, 32.5.4.4

Hide Publisher, 33.5.2, 33.5.3.4

Hide Share, 32.5.2, 32.5.4.5

Hide Sharing Picker, 34.3.3.5.2

Hide Toolbar, 59.3.2, 60.3.2

Horizontal Alignment, 18.2.2.2

Hover Icon, 13.2.2.1, 18.2.7.2

Icon, 13.2.2.1, 18.2.7.2, 18.2.10.6

Icon Position, 13.2.2.1, 18.2.7.2

Id, 27.4.2, 28.3.2, 33.5.2

Image Map Type, 42.14.1

Image Size, 30.6.2

images, 42.14

Inflexible Height, 18.2.10.6

Initial Sidebar, 42.8.1

inline frames, 42.13, 42.13

Inline Style, 13.2.8.1

Is Update Status, 34.3.3.5.2, 34.3.3.5.5

Item ID, 42.8.1, 42.10.1, 42.11.1

Keep open the Publisher after publish, 34.3.3.5.2

Landmark, 18.2.10.2

Last Modified After, 42.3.1, 42.7.1

Last Modified Before, 42.3.1, 42.7.1

Last Modifier, 42.3.1, 42.7.1

Layout, 18.2.2.2, 18.2.10.2, 42.4.1

links, 42.12

List Events in Number of Upcoming Days, 61.3.3

List ID, 64.3.2

List Scope ID, 64.3.2

Local List Customization ID, 64.3.2

Local List ID, 64.3.2

Long Desc URL, 42.14.1

Long Time Period in minutes, 69.3.2

Longest Time Period in minutes, 69.3.2

Margin, 17.5.2.7.2

Maximum Calendars, 61.3.2

Maximum Documents, 42.7.1

Maximum Enabled Calendars, 61.3.2

Maximum Results, 40.11.2

Medium Time Period in minutes, 69.3.2

Message Board, 33.5, 33.5.2

Message key of hints text, 34.3.3.5.2

Most Recent First, 42.7.1

Navigate to Announcement Viewer, 59.3.2

Navigation, 11.3.2.2, 11.3.2.2, 11.3.2.2, 18.2.5.3

No of activities to display per page, 32.5.2

No of Feedback Items, 33.5.2, 33.5.3.2

No of Messages, 33.5.2, 33.5.3.2

No Wrap, 18.2.4.2

notifications, 36.5.3, 36.5.3.2

Number of Announcements on Extended Mini View, 59.3.2

Number of Announcements to Show, 59.3.2

Number of Columns, 31.5.2, 52.4.7.2

Number of Connections per page, 31.5.2, 31.5.3.4

Number of Events Per Page, 61.3.3

Number of Expanded Announcements, 59.3.2

Number of Rows, 31.5.2, 31.5.3.5, 52.4.7.2

Number of Rows (list layout), 31.5.2, 31.5.3.5

Object Id, 34.3.3.5.2

Object Name, 58.3.2

Object Type, 34.3.3.5.2

of folders and files, 41.22

Open in new window, 18.2.6.2, 42.12.1

Org Bread Crumbs Shown, 30.6.2

Other CSS, 17.5.2.7.2, 17.5.2.7.3, 17.5.2.7.3, 17.5.2.7.4

Page Size, 42.2.1, 42.3.1, 42.3.1, 42.4.1, 42.5.1, 42.6.1

Pagination, 32.5.2

Param#, 27.4.2, 28.3.2

Parameters tab, 17.5.2.2

Partial Triggers, 19.2.2, 27.4.2, 28.3.2

Poll Name, 67.3.2

Position, 18.2.10.4

Profile Edit Link Shown, 30.6.2

Profile Format, 31.5.2, 31.5.3.7

Profile ID, 30.6.2

Profile Launched on Selection, 31.5.2, 31.5.3.8, 52.4.7.2

Profile Only, 32.5.2, 32.5.4.8

Profile User Id, 32.5.2

Publisher, 34.3.3.5

Read Only, 42.2.1, 42.4.1, 42.5.1, 42.6.1, 42.8.1, 42.10.1, 42.11.1

Recipe, 58.3.2

Region Template, 40.11.2

Render Portlet In I Frame, 27.4.2, 28.3.2

Resource ID, 42.2.1, 42.4.1, 42.5.1, 42.6.1, 42.9.1, 56.4.2, 57.3.2

Resource Id, 30.6.2, 32.5.2, 33.5.2, 58.3.2

Resource Scope, 56.4.2

Resource Type, 56.4.2, 58.3.2

Root Folder Path, 42.3.1

RSS Feed URL, 68.4.2

Scope, 67.3.2

Scope Id, 34.3.3.5.2

Scope Name, 13.2.2.1, 36.5.3.2, 36.5.3.4

Scope of Tags, 57.3.2

Search Box Size, 13.2.30, 56.4.2

Search Scope ID, 13.2.30, 56.4.2

Second Level Style, 11.3.2.2

Section-Wise Edit Enabled, 30.6.2

Service Catagories, 32.5.4.7

Service Categories, 32.5.2

Service ID, 57.3.2

Service Id, 34.3.3.5.2, 58.3.2

Services to be Excluded, 56.4.2

setting component, 17.5.2.3

setting on page content, 17.5.2

Short Desc, 13.2.2.1, 17.5.2.5, 18.2.2.2, 18.2.4.2, 18.2.7.2, 18.2.9.2, 18.2.10.2, 18.2.10.3, 18.2.10.4, 18.2.10.7, 42.13.1, 42.14.1

Shortest Time Period, 69.3.2

Show Actions On Hover, 17.5.2.5

Show Categories, 60.3.2

Show Component, 13.2.2.1, 17.5.2.5, 18.2.2.2, 42.12.1, 42.13.1, 42.14.1

Show Documents, 42.2.1, 42.5.1

Show Folders, 42.2.1, 42.3.1, 42.6.1

Show Icons, 11.3.2.2, 11.3.2.2, 18.2.5.3

Show In Edit Mode, 67.3.2

Show Label, 13.2.25.1

Show Levels, 11.3.2.2, 18.2.5.3

Show List Name and Description, 64.3.2

Show or hide input box, 56.4.2

Show Recursive Forums, 60.3.2

Show Root, 11.3.2.2, 11.3.2.2, 18.2.5.3

Show Split Action, 18.2.2.2

Show Tab Action, 18.2.2.2

Show User Data Only, 67.3.2

Sort Criteria, 31.5.2, 52.4.7.2

Source, 18.2.9.2, 42.13.1, 42.14.1

Space Launched on Selection, 51.16.2.3.1

Space Name, 34.3.3.5.2, 34.3.3.5.4

Spaces, 32.5.2, 32.5.4.6

Spaces Browser task flow, 51.16.2

Start Date, 33.5.2, 33.5.3.7

Start Folder Path, 42.2.1, 42.4.1, 42.5.1, 42.6.1

Start Path, 11.3.2.2, 11.3.2.2, 11.3.2.2, 18.2.5.3

Start Width, 18.2.10.3

Stretch Content, 17.5.2.5

Style, 11.3.2.2, 11.3.2.2, 18.2.5.3

Style tab, 17.5.2.2, 17.5.2.7

Suppress Popup, 58.3.2

Tab Removal, 18.2.10.4

Tabular, 65.5.2

Target Frame, 18.2.7.2

Task Flow Id, 13.2.9.1

Task Flow Instance ID, 40.11.2, 42.3.1

Template Category ID, 40.11.2

Template View ID, 40.11.2

Text, 13.2.2.1, 17.5.2.5, 18.2.7.2, 18.2.10.6

Text And Access Key, 18.2.7.2

Theme, 18.2.10.2, 18.2.10.3

Title, 18.2.6.2, 27.4.2, 28.3.2, 42.12.1

Top Height, 18.2.10.3

Type, 13.2.3.1

Upload Document Only, 34.3.3.5.2, 34.3.3.5.6

User Id, 30.6.2, 31.5.2

User Name, 30.6.2, 31.5.2, 33.5.2, 34.3.3.5.2

Using ADF Calendar Component, 61.3.3

Valign, 18.2.10.2

Value, 18.2.4.2

Vertical Alignment, 18.2.2.2

Via User, 34.3.3.5.2

Width, 17.5.2.7.2, 18.2.10.7

Properties icon, 41.5.2.6

Properties menu action, 41.5.1.2, 41.5.2.2

provisioning issues, 53.6.2

proxy authentication in OmniPortlet, 27.2.4.1

public access to Spaces, 51.14.5

public credentials, 6.6.2

public Space pages, 51.7.8

public Space templates, 50.3.5

public Spaces, 49.4

Public-User role, 20.3.1.1

granting permissions, 21.2.4

in public Spaces, 51.4.16

Public-User role (in a Space), 52.2.1.1

Public-User role (in the Home Space), 20.3.1.1

Publisher task flow, 34.3.3, 34.3.3.5

about, 34.3.3.1

parameters, 34.3.3.5.2

about, 34.3.3.5.1

Hide Attach Links, 34.3.3.5.2

Hide Document Uploader, 34.3.3.5.2, 34.3.3.5.3

Hide Sharing Picker, 34.3.3.5.2

Is Update Status, 34.3.3.5.2, 34.3.3.5.5

Keep open the Publisher after publish, 34.3.3.5.2

Message key of hints text, 34.3.3.5.2

Object Id, 34.3.3.5.2

Object Type, 34.3.3.5.2

Scope Id, 34.3.3.5.2

Service Id, 34.3.3.5.2

Space Name, 34.3.3.5.2, 34.3.3.5.4

Upload Document Only, 34.3.3.5.2, 34.3.3.5.6

User Name, 34.3.3.5.2

Via User, 34.3.3.5.2

selecting recipients, 34.3.3.2

sharing files, 34.3.3.3

sharing links, 34.3.3.4

R

Range of Users column detail in lists, 64.2.3.2.2

Read Only property, 42.2.1, 42.4.1, 42.5.1, 42.6.1, 42.8.1, 42.10.1, 42.11.1

recent activities

about, 69

accessing, 69.2.4

Recent Activities service, 69

Recent Activities task flow

about, 69.1

accessing recent items, 69.2.4

adding to a custom Resource Catalog, 69.2.1

adding to a page, 69.2.2

personalizing, 69.2.3

properties

Group Space Name, 69.3.2

Long Time Period in minutes, 69.3.2

Longest Time Period in minutes, 69.3.2

Medium Time Period in minutes, 69.3.2

Shortest Time Period, 69.3.2

refreshing, 69.2.5

using, 69.2

Recent Documents task flow

about, 41.1.6

parameters

Connection Name, 42.7.1

Group Space, 42.7.1

Last Modified After, 42.7.1

Last Modified Before, 42.7.1

Last Modifier, 42.7.1

Maximum Documents, 42.7.1

Most Recent First, 42.7.1

Recipe property, 58.3.2

recommendations for current document, 41.19

Recommended Connections task flow

about, 58.1

adding to a page, 58.2.1

display options, 58.2.2.4, 58.2.2.5

inviting connection, 58.2.2.2

parameters

Exclude Object Actions, 58.3.2

Recipe, 58.3.2

Resource Id, 58.3.2

removing recommendation, 58.2.2.3

user details, 58.2.2.1

using, 58.2.2

Refresh Content menu action, 41.5.1.2

Region Template property, 40.11.2

registered user, joining a Space as, 49.6.1

registration, self registering to application, 29.2

Related Items, 41.19

Related Items icon, 41.5.2.6

Related Items menu action, 41.5.1.2, 41.5.2.2

Related Items pane

Links section, 41.19.2

Recommendations section, 41.19.3

Tags section, 41.19.1

Related Resources task flow

parameters

Scope of Tags, 57.3.2

Remove Public Access action, 51.7.8

Rename menu action, 41.5.1.1

Render Portlet In I Frame property, 27.4.2, 28.3.2

Reorder Columns menu action, 41.5.1.2

Required column detail in lists, 64.2.3.2.2

Resource Catalogs

about, 16.1, 17.3.3

adding components to pages, 17.5

adding resources, 16.3.1.2

changing in a Space, 51.4.11

configuring, 16.10

content management selections, 39.2

copying, 16.7

creating, 16.2

creating custom components, 16.3.1.3

creating in JDeveloper, 16.9

default for page templates, 12.7

deleting, 16.8

determining content of, 18.1

editing, 16.3

editing catalog source files, 16.3.2

hiding, 16.4

in a Space, 51.11

managing resources in, 16.3.1

rearranging resources, 16.3.1.4

removing Spaces components from, 13.3.1

Resource Registry, 16.1.3

seeded, 16.1.1

selecting, 5.10

setting

properties, 16.5

resource properties, 16.3.1.5

security, 16.6

showing hidden, 16.4

Resource ID property, 42.2.1, 42.4.1, 42.5.1, 42.6.1, 42.9.1, 56.4.2, 57.3.2

Resource Id property, 30.6.2, 32.5.2, 33.5.2, 58.3.2

Resource Scope property, 56.4.2

Resource Type property, 56.4.2, 58.3.2

Resource Viewer system page, 7.3.1

resources

about, 10.1, 10.1.1, 10.1.2

accessing, 10.1.4

application-level resources, 10.1.4.1

Space-level resources, 10.1.4.2

building with JDeveloper, 10.5.1

copying, 10.4.1

creating, 10.2

deleting, 10.4.5

downloading, 10.5.2

editing

about, 10.3.1

source code, 10.3.2

using Edit dialog, 10.3.3

EL expressions relating to, B.3.5

expression builder

applying, 10.4.8

querying, 10.4.7

managing for Space, 51.11

permissions required, 10.1.3

previewing, 10.4.6

properties

about, 10.4.2.1

accessing, 10.4.2.2

associating an icon, 10.4.2.4

renaming, describing, and categorizing, 10.4.2.3

setting attributes, 10.4.2.6

setting availability, 10.4.2.5

setting security, 10.4.4

showing and hiding

about, 10.4.3.1

hiding, 10.4.3.3

showing, 10.4.3.2

uploading, 10.5.3

viewing information, 10.1.5

Resources page in a Space, 51.11

Rich Text data type in lists, 64.2.3.2.2

Rich Text Editor, 18.2.8.1

mode, 41.11

toolbar, 41.11, 47.3

using, 41.11

Right Narrow page style, 15.1

roles

changing in a Space, 49.20, 52.3.5

discovering your own, 29.9

managing in a Space, 52.2, 52.2

Roles page in a Space, 51.5

Root Folder Path property, 42.3.1

RSS Feed URL property, 68.4.2

RSS service

about, 68.1

RSS icon, 68.1.1

RSS Manager, 68.1.2

RSS task flow, 68.1.3

editing properties, 68.4.2

enabling and disabling for Space, 51.4.6

lists and, 64.1

obtaining news feeds

Announcements service, 68.2.4

Discussions service, 68.2.2

Lists service, 68.2.3

Recent Activities service, 68.2.1

properties

External Application ID, 68.4.2

RSS Feed URL, 68.4.2

RSS Spaces component, 13.2.29

RSS task flow

adding to a page, 68.3.1

deleting, 68.3.3

editing feed information, 68.3.4

editing properties, 68.4.2

refreshing, 68.3.2

using, 68.3

RSS, publishing using OmniPortlet, 27.2.4.5, 27.2.7.3

runtime defined, 19.1

S

Saved Search task flow, 56.4.2

saved searches

creating, 56.3.4.1

sharing, 56.3.4.3

Scope Id property, 34.3.3.5.2

Scope Name property, 13.2.2.1, 36.5.3.2, 36.5.3.4

Scope of Tags property, 57.3.2

Scope property, 67.3.2

screen readers, 35.4

Scroll to First menu action, 41.5.1.2

Scroll to Last menu action, 41.5.1.2

search

adding Search task flow, 56.3.2.2

for favorites, 37.5.5

images in results, 18.2.7

preferences, 56.2, 56.2.1

refining results, 56.3.3

removing refinements, 56.3.3

results display order, 56.2.2

results not returned, 56.3.3

saving, 56.3.4.1

scope of results, 56.1

Search service, 56

Search Spaces component, 13.2.30

searchable services, 56.2.1

searching

a Space, 56.3.2.2

connections, 31.4.1.2

globally, 56.3.2.1

sharing saved searches, 56.3.4.3

tag sharing and, 57.1.1

viewing tagged items in results, 57.2.5

viewing tags in results, 57.2.5

wildcards, 56.1.1

Search Box Size property, 13.2.30, 56.4.2

Search Preferences task flow, 56.3.1

Search Scope ID property, 13.2.30, 56.4.2

Search service, 56

about, 56.1

global search, 56.3.2.1

refining results, 56.3.3

saved searches

creating, 56.3.4.1

sharing, 56.3.4.3

sharing saved searches, 56.3.4.3

Space search, 56.3.2.2

task flows

All Saved Searches, 56.3.1, 56.3.4.2

Search, 56.3.1, 56.3.2.2

Search Preferences, 56.3.1

Search Toolbar, 56.3.1

with documents, 56.1

with tags, 56.1

Search Spaces component, 13.2.30

Search system page, 7.3.1

Search task flow, 56.4.2

about, 56.3.1, 56.3.2.2

parameters

Resource ID, 56.4.2

Resource Scope, 56.4.2

Resource Type, 56.4.2

Services to be Excluded, 56.4.2

Show or hide input box, 56.4.2

See also Search service

search task flows

adding to a page, 56.3.1

Search Toolbar task flow

about, 56.3.1

parameters

Search Box Size, 56.4.2

Search Scope ID, 56.4.2

Second Level Style property, 11.3.2.2

Section-Wise Edit Enabled property, 30.6.2

security

Delete Page permission, 23.1, 38.2.1

Edit Page permission, 23.1, 38.2.1

EL expressions relating to, B.3.3

files, 41.25

granting access to Space, 51.14.4

in a Space, 51.4.16

inheriting page access permissions, 23.1

page access permissions, 23.1

Perform All Page Actions permission, 23.1, 38.2.1

Personalize Page permission, 23.1, 38.2.1

setting access on components, 23.2

setting page access, 23.1

Subspaces, 54.7.1

View Page permission, 23.1, 38.2.1

Security menu action, 41.5.2.1

Self Registration Spaces component, 13.2.31

Self Registration system page, 7.3.1

self-registration to application, 22.1, 29.2

enabling by invitation, 22.2

enabling for anyone, 22.3

self-subscribing to Spaces, 52.3.4.3

Send Mail menu action, 41.5.2.1

separator layout component

about, 18.2.10.7

display options

Height, 18.2.10.7

Short Desc, 18.2.10.7

Show Component, 18.2.10.7

Width, 18.2.10.7

Service Categories property, 32.5.2, 32.5.4.7

Service ID property, 57.3.2

Service Id property, 34.3.3.5.2, 58.3.2

service IDs, B.3.10

services

See WebCenter services

Services page in a Space, 51.10

Services to be Excluded property, 56.4.2

shadows, Display Shadow property, 17.5.2.5

Share Link, 51.14.1

Share menu action, 41.5.2.1

Share Resource Spaces component, 13.2.32

shared credentials, 6.6.2

shared searches, creating, 56.3.4.3

sharing

about, 34.3.1

streamed items, 34.3.2

Short Desc property, 13.2.2.1, 17.5.2.5, 18.2.2.2, 18.2.4.2, 18.2.7.2, 18.2.9.2, 18.2.10.2, 18.2.10.3, 18.2.10.4, 18.2.10.7, 42.13.1, 42.14.1

Shortest Time Period property, 69.3.2

Show Actions On Hover property, 17.5.2.5

Show as Top menu action, 41.5.1.2

Show Categories property, 60.3.2

Show Component property, 13.2.2.1, 17.5.2.5, 18.2.2.2, 18.2.4.2, 42.12.1, 42.13.1, 42.14.1

Show Documents property, 42.2.1, 42.5.1

Show Folders property, 42.2.1, 42.3.1, 42.6.1

Show Icons property, 11.3.2.2, 11.3.2.2, 18.2.5.3

Show In Edit Mode property, 67.3.2

Show Label property, 13.2.25.1

Show Levels property, 11.3.2.2, 18.2.5.3

Show List Name and Description property, 64.3.2

Show or hide input box property, 56.4.2

Show Recursive Forums property, 60.3.2

Show Root property, 11.3.2.2, 11.3.2.2, 18.2.5.3

Show Split Action property, 18.2.2.2

Show Tab Action property, 18.2.2.2

Show User Data Only property, 67.3.2

showDetailFrame layout component, 18.2.10.1

about, 18.2.10.5

display options, 18.2.10.5

sidebarItem layout component, 18.2.10.1

about, 18.2.10.6

display options

Disclosed, 18.2.10.6

Icon, 18.2.10.6

Inflexible Height, 18.2.10.6

Short Desc, 18.2.10.6

Show Component, 18.2.10.6

Text, 18.2.10.6

Similar Items task flow

about, 58.1

adding to a page, 58.2.1

display options, 58.2.4.4, 58.2.4.5

item details, 58.2.4.2

parameters

Class URN, 58.3.2

Class URN Restrictions, 58.3.2

Exclude Object Actions, 58.3.2

Object Name, 58.3.2

Recipe, 58.3.2

Resource Id, 58.3.2

Resource Type, 58.3.2

Service Id, 58.3.2

Suppress Popup, 58.3.2

populating, 58.2.4.1

removing an item, 58.2.4.3

using, 58.2.4

Similar Spaces task flow

about, 58.1

adding to a page, 58.2.1

display options, 58.2.3.4, 58.2.3.5

joining a Space, 58.2.3.2

parameters

Exclude Object Actions, 58.3.2

Object Name, 58.3.2

Recipe, 58.3.2

Resource Id, 58.3.2

removing a Space, 58.2.3.3

Space details, 58.2.3.1

using, 58.2.3

Similarly Tagged Items task flow

about, 57.1.4, 57.1.4

parameters

Resource ID, 57.3.2

Service ID, 57.3.2

simultaneous page edits, 17.3.1

single sign-on and external applications, 6.6.2

Site Studio content

best practices, 40.8

changing edit mode key sequence, 40.10.4

creating files in-context in Content Presenter, 40.10.3

displaying in Content Presenter, 40.1, 40.1.1, 40.9, 40.10.2, 40.10.3

displaying in Documents service task flow, 41.1.7

editing files in-context in Content Presenter, 40.10.2

optimizing for display in Content Presenter, 40.8

skins

about, 14.1

applying

applying to a Space, 14.5.2

applying to Home Space, 14.5.3

applying to WebCenter Spaces, 14.5.1

building with JDeveloper, 14.5.3

changing in a Space, 51.4.10

copying, 14.4.4

creating, 14.2

deleting, 14.4.5

editing, 14.3

simple editing, 14.3.1.2, 14.3.3

source code editing, 14.3.1.1, 14.3.2

hiding, 14.4.1

in a Space, 51.11

preference selections, 35.5

setting properties, 14.4.2

about, 14.4.2.1

associating an icon, 14.4.2.3

attributes, 14.4.2.5

naming, describing, and categorizing, 14.4.2.2

setting availability, 14.4.2.4

setting security, 14.4.3

showing hidden, 14.4.1

using, 5.7

viewing details, 14.4.6

slides, embedding, 18.2.4.3

social networking, 3

about, 1.1.3

Activity Graph service and, 3.3.6

Announcements service and, 3.3.3

blogs and, 3.3.8

commenting and, 3.3.4

communities and, 3.2

Discussions service and, 3.3.3

establishing a network, 31.4

Events service and, 3.3.3

instant messaging and, 3.3.5

liking and, 3.3.4

Links service and, 3.3.7

lists and, 3.3.9

People Connections and, 3.3.2

Polls service and, 3.3.6

services and, 3.3.1

sharing and, 3.3.4

Spaces and, 3.2

Tags service and, 3.3.7

wikis and, 3.3.8

Sort Criteria property, 31.5.2, 52.4.7.2

Sortable Table View display template, 40.5

Source property, 18.2.9.2, 42.13.1, 42.14.1

Source view

deleting layout components in, 18.3.2

page edit mode in, 17.3.2

setting component properties in, 18.2.1.2

Space Documents in Resource Catalog, 39.2

Space Launched on Selection property, 51.16.2.3.1

Space Members task flow

about, 51.16

Space Name property, 34.3.3.5.2, 34.3.3.5.4

Space Not Found system page, 7.3.1

Space pages

adding to Home Space, 49.17, 51.7.10

copying, 49.13, 51.7.6

creating, 51.7.2

deleting, 49.16, 51.7.9

direct URL, 49.19, 51.7.12

editing, 49.12, 51.7.5

filtering list, 51.7.4

hiding, 49.11, 51.7.3

mailing link to, 49.18, 51.7.11

making public or private, 51.7.8

managing, 51.7

refreshing list, 51.7.4

renaming, 49.14, 51.7.7

searching for, 51.7.4

security, 49.15, 51.7.8

setting default style, 51.7.1

showing hidden, 49.11, 51.7.3

viewing information about, 49.19, 51.7.12

Space templates

about, 50.1

creating, 50.2

custom, 50.1.2

deleting, 50.3.6

displaying list of, 50.3.1

exporting, 53.5.3

hiding, 50.3.5

importing, 53.5.4

managing, 50.3

out-of-the-box, 50.1

publishing, 50.3.5, 53.3.1

renaming, 50.3.3

searching, 50.3.2

setting access, 50.3.4

unpublishing, 50.3.5, 53.3.1

viewing, 53.3.2

working with, 50

Space Templates business role page, 7.1.1

spacer layout component, 18.2.10.1

about, 18.2.10.7

display options

Height, 18.2.10.7

Short Desc, 18.2.10.7

Show Component, 18.2.10.7

Width, 18.2.10.7

Spaces

about, 1.1.1, 49

activities tracked by Activity Stream, 6.4.3.2, 32.1

adding

as Windows network place, 46.4.1

blogs, 51.13

files, 41.8.1

members, 52.3.4

members using Microsoft Office integration, 46.3.4.11

pages to Home Space, 49.17, 51.7.10

to a navigation model, 11.2.2.1.5

wikis, 51.13

administering, 51.3

applying a page template, 12.6

approving membership requests, 52.3.6

bringing online, 51.4.4, 53.2.3

cancelling membership, 49.21

changing

access, 51.4.16

display name, 51.4.1

member roles, 52.3.5

page template, 51.4.9

Resource Catalogs, 51.4.11

role, 49.20

skin, 51.4.10

URL, 51.14.2

choosing the default page template, 5.8, 5.9

choosing the default Resource Catalog, 5.10

closing, 51.4.5, 53.2.4

composing messages to members, 52.3.3

configuring mail distribution, 51.10.2

Content page, 51.8

controlling page access, 49.15, 51.7.8

copying pages, 49.13, 51.7.6

copyright and privacy statements, 51.4.14

creating, 51.2

from MS Office document, 46.3.1

pages, 51.7.2

personal pages, 49.10

templates, 50.2

custom attributes, 51.12

Custom Attributes page, 51.12

customizing page templates, 12.4

deleting, 51.17, 53.2.6

custom attributes, 51.12

pages, 49.16, 51.7.9

description, 29.9.1

determining your role, 29.9.1

disabling services, 51.10.1, 53.4

discoverable, 51.14.3

discussion forums, 51.10.3

editing custom attributes, 51.12

editing pages, 17.3, 49.12, 51.7.5

EL expressions relating to, B.3.6

enabling and disabling services, 6.1

enabling services, 51.10.1, 53.4

Explorer URL, 49.5

exporting, 53.5.1

exposing pages in Home Space, 29.5

forums, 51.10.3

General page, 51.4

granting access, 51.14.4

granting public access, 51.14.5

GUID, 29.9.1

hierarchy, 54

icon, 51.4.7

importing, 53.5.2

in Windows Explorer, 46.4.1

inheriting page access permissions, 23.1

internal ID, 29.9.1, 49.5

internal name, 49.5

inviting non-user, 52.3.4.4

joining as registered user, 49.6.1

joining as unregistered user, 49.6.2

listing, 49.3

logo, 51.4.8

mailing link to page, 49.18, 51.7.11

mailing members, 52.3.7

managing, 51, 53.1

managing files using Microsoft Office, 46.3.4.6

managing services, 51.10

members, 52

Members page, 51.6

Members task flow, 52.4

membership policy, 52.1

membership, about, 52.3.1

metadata, 29.9

moderator, 51.1

modifying description or keywords, 51.4.2

name compared to display name, B.3.6

navigating to, 29.3.1

navigation, 54.5

permissions, 20.3.2, 52.2

pretty URLs, A.3

printing pages, 29.8

public, 49.4

publishing link to, 51.14.1

publishing mail in discussion forum, 51.10.4

reactivating, 53.2.5

refreshing list, 49.3

renaming, 51.4.1, 51.14.2

renaming a page, 29.6

renaming pages, 49.14

Resources page, 51.11

revoking membership, 52.3.8

roles

discovering your own, 29.9

managing, 52.2

Roles page, 51.5

RSS news feeds, 51.4.6

saving file to, 46.3.4.1.1

Search page, 56.3.2.2

searching, 49.3, 49.7

searching content, 56.3.2.2

security, 51.4.16

self-subscribing, 52.3.4.3

Services page, 51.10

setting language, 51.4.15

Subspaces page, 51.9

taking offline, 51.4.3, 53.2.2

templates, 50.1

deleting, 53.3.4

managing application, 53.3.1

permissions, 20.3.2

publishing, 53.3.1

unpublishing, 53.3.1

viewing, 53.3.2

troubleshooting, 53.6.2

user interface URLs, A.3

viewing

available, 49.3

display name, 49.5

information about, 29.9, 49.5, 53.2.1

information about pages, 49.19, 51.7.12

lists in a Space, 64.2.2

members, 52.3.2

pages in a Space, 49.8

working with Subspaces, 54

Spaces Browser task flow

about, 11.1.2, 51.16

properties

Advanced Query, 51.16.2.3.1

Display Tool Bar, 51.16.2.3.1

Display View, 51.16.2.3.1

Filter, 51.16.2.3.1

Space Launched on Selection, 51.16.2.3.1

Spaces business role page, 7.1.1

Spaces components, 13

About Space, 13.2.2

About WebCenter, 13.2.3

accessing properties of, 13.2.1

Add to Favorites, 13.2.4

adding to a page, 13.1.4

adding to a template, 13.1.3

adding to page templates, 12.3.1

adding to Resource Catalog, 13.1.1

Administration, 13.2.5

Change Membership, 13.2.6

Contact Administration, 13.2.7

Copyright Message, 13.2.8

Create Page, 13.2.9

Create Space, 13.2.10

Create Subspace, 13.2.11

Current User Profile, 13.2.12

deleting, 13.3

Edit Page, 13.2.13

Favorites Menu, 13.2.14

Global Help, 13.2.15

Home Space, 13.2.16

Invite People as Connection, 13.2.17

Join Space, 13.2.18

Leave Space, 13.2.19

Login, 13.2.20

Logout, 13.2.21

Mail Space Members, 13.2.22

Mail Space Moderators, 13.2.23

making available, 13.1

Manage Pages, 13.2.24

Page Links, 13.2.25

Parent Space, 13.2.26

Print Preview, 13.2.27

Privacy URL, 13.2.28

properties

Depressed Icon, 13.2.2.1

Disabled Icon, 13.2.2.1

Display Type, 13.2.2.1

Favorite Title, 13.2.4.1

Favorite URL, 13.2.4.1

Hover Icon, 13.2.2.1

Icon, 13.2.2.1

Icon Position, 13.2.2.1

Inline Style, 13.2.8.1

Scope Name, 13.2.2.1

Search Box Size, 13.2.30

Search Scope ID, 13.2.30

Short Desc, 13.2.2.1

Show Component, 13.2.2.1

Show Label, 13.2.25.1

Task Flow Id, 13.2.9.1

Text, 13.2.2.1

Type, 13.2.3.1

removing

from page, 13.3.3

from Resource Catalog, 13.3.1

from template, 13.3.2

RSS, 13.2.29

Search, 13.2.30

Self Registration, 13.2.31

Share Resource, 13.2.32

Spaces Switcher, 13.2.33

Status Indicator, 13.2.34

Subscription Preferences, 13.2.35

Tags, 13.2.36

User Preferences, 13.2.37

working with properties of, 13.2

Spaces Management, subscribing to, 36.3.1

Spaces property, 32.5.2, 32.5.4.6

Spaces Switcher Spaces component, 13.2.33

Spaces templates

deleting, 53.3.4

managing, 53.3.1

Spaces-User role

understanding, 20.2

Spaces-User role (WebCenter Spaces)

granting permissions, 21.2.5

spreadsheets

exporting lists to, 64.2.7.2

importing lists from, 64.2.7.3

lists and, 64.2.7.1

using as a data source, 27.2.4.3

SQL as data source, 27.2.4.4

standard permissions (for a Space), 52.2.1.2

Start Date property, 33.5.2, 33.5.3.7

Start Folder Path property, 42.2.1, 42.4.1, 42.5.1, 42.6.1

Start Path property, 11.3.2.2, 11.3.2.2, 11.3.2.2, 18.2.5.3

Start Width property, 18.2.10.3

Status Indicator Spaces component, 13.2.34

Stretch Content property, 17.5.2.5

strings, Expression Language, B.1

style properties

about, 17.5.2.2, 17.5.2.7, 17.5.2.7.1

properties

Background Color, 17.5.2.7.2

Background Image, 17.5.2.7.2

Color, 17.5.2.7.2

Font, 17.5.2.7.2

Font Size, 17.5.2.7.2

Font Style, 17.5.2.7.2

Height, 17.5.2.7.2

Margin, 17.5.2.7.2

Other CSS, 17.5.2.7.2, 17.5.2.7.3, 17.5.2.7.3, 17.5.2.7.4

Width, 17.5.2.7.2

Style property, 11.3.2.2, 11.3.2.2, 18.2.5.3

styles

about, 15.1

applying, 15.5

Blank page style, 15.1

Blog page style, 15.1

building with JDeveloper, 15.6

copying, 15.4.4

creating a custom page style, 15.2

default page styles, 15.1

deleting, 15.4.5

editing style source, 15.3

editPageAfterCreation attribute, 15.4.2

hiding in Create Page dialog, 15.4.1

Home Page page style, 15.1

Left Narrow page style, 15.1

managing, 15.4

previewing, 15.4.6

Right Narrow page style, 15.1

setting security on, 15.4.3

setting style attributes, 15.4.2

setting style properties, 15.4.2

showing in Create Page dialog, 15.4.1

Three Column page style, 15.1

Web Page page style, 15.1

Wiki page style, 15.1

Subscribe menu action, 41.5.2.1, 41.26

Subscribe system page, 7.3.1

subscribing to file, 41.26

Subscription Preferences Spaces component, 13.2.35

Subscription Preferences task flow

about, 36.5.1

parameters

about, 36.5.3.1

Hide Actions, 36.5.3.2, 36.5.3.3

Scope Name, 36.5.3.2, 36.5.3.4

Subscription Viewer task flow

about, 36.5.1

subscriptions, 36.3

about, 36.1

administrator defaults, 36.1

application level, 36.3.1

Connections, 36.3.1

Feedback, 36.3.1

Message Board, 36.3.1

Space Management, 36.3.1

blogs, 36.3.2, 36.3.3.3

cancelling, 36.4

application level, 36.4.1

object level, 36.4.2

Space level, 36.4.2

discussion topics, 36.3.3.4

files, 36.3.3.1

object level, 36.3.3

Space level, 36.3.2

announcements, 36.3.2

discussions, 36.3.2

documents, 36.3.2

events, 36.3.2

viewing, 36.4

application level, 36.4.1

object level, 36.4.2

Space level, 36.4.2

wikis, 36.3.2, 36.3.3.2

Subspaces

creating, 54.3

importing, 54.7.2

inheritance from parent, 54.2

managing, 51.9, 54.7

moving, 54.6

security, 54.7.1

viewing, 54.4

Subspaces page in a Space, 51.9

Suppress Popup property, 58.3.2

system pages, 7.3

about, 7.3.1

Activity Stream, 7.3.1

Announcements, 7.3.1

customizing, 7.3.2

about, 7.3.2.1

application level, 7.3.2.2

removing customizations, 7.3.3

Space level, 7.3.2.3

Discussions, 7.3.1

Documents, 7.3.1

Error Encountered, 7.3.1

Events, 7.3.1

Lists, 7.3.1

Login, 7.3.1

My Profile, 7.3.1

No Page Accessible, 7.3.1

Outlook Add-in Discussions, 7.3.1

Outlook Add-in Documents, 7.3.1

Outlook Add-in Events, 7.3.1

Outlook Add-in Members, 7.3.1

Outlook Add-in Space Home, 7.3.1

Page Not Found, 7.3.1

Page Viewer, 7.3.1

Resource Viewer, 7.3.1

Search, 7.3.1

Self Registration, 7.3.1

Space Not Found, 7.3.1

Subscribe, 7.3.1

Tag Center, 7.3.1

Task Flow Editor, 7.3.1, 8.4

Task Flow Viewer, 7.3.1

Unauthorized, 7.3.1

Unavailable, 7.3.1

User Profile, 7.3.1

WebCenter Welcome Page, 7.3.1

T

Tab Removal property, 18.2.10.4

Tabbed View display template, 40.5

table layout in OmniPortlet, 27.2.7.1

tabs

adding, 17.3.5.5

adding an icon to, 17.3.5.5.5

creating a tab set, 17.3.5.5.3

deleting, 17.3.5.5.8

hiding, 17.3.5.5.7

renaming, 17.3.5.5.4

reordering, 17.3.5.5.4

showing hidden, 17.3.5.5.7

stretching tab content, 17.3.5.5.6

Tabular property, 65.5.2

Tag Center business role page, 7.1.1

Tag Center system page, 7.3.1

Tag Cloud task flow

parameters

Scope of Tags, 57.3.2

tags

about, 57.1

adding to file, 41.19

all tagged items, 57.1.5

applying

to documents, 57.2.3

to pages, 57.2.2

deleting, 57.2.4.5

discovering who has used, 57.2.6.5

filtering

tagged items, 57.2.4.3

tags, 57.2.4.3

folksonomy, 57.1.1

opening the Tag Center, 57.2.6.1

recommended, 57.2.3

refining display of, 57.2.6.4

refining tag results, 57.1.5

renaming, 57.2.4.4

sharing, 57.1.1, 57.2.2

sorting

Tag Cloud, 57.2.6.2

tagged items, 57.2.4.2

Tag Center, 57.1.5

Tag Center business role page, 7.1.1

Tag Center system page, 7.3.1

Tag Cloud, 57.1.5

adjusting view of, 57.2.6.2

searching for tags, 57.2.6.2

tagged items

sorting, 57.2.6.3

viewing items, 57.2.6.3

viewing

tagged items, 57.2.5

tags, 57.2.4.1, 57.2.5

Tags service, 57

activities tracked by Activity Stream, 6.4.3.2, 32.1

task flows

Related Resources, 57.3.2

Similarly Tagged Items, 57.1.4, 57.3.2

Tag Cloud, 57.3.2

Tags, 57.1.3, 57.3.2

Tags Spaces component, 13.2.36

Tags task flow, 57.1.3

about, 57.1.3, 57.2.4.1

parameters

Service ID, 57.3.2

Target Frame property, 18.2.7.2

Task Flow Editor system page, 7.3.1, 8.4

Task Flow Id property, 13.2.9.1

Task Flow Instance ID property, 40.11.2, 42.3.1

task flow properties

Analytics service, 55.3

Lists service, 64.3

Notes service, 66.3

notifications, 36.5.3.2

People Connections service

Activity Stream, 32.5

Connections, 31.5

Feedback, 33.5.2

Message Board, 33.5.2

Profile, 30.6

Publisher, 34.3.3.5.2

RSS service, 68.4.2

Task Flow Viewer system page, 7.3.1

task flows

Activity Graph service

Recommended Connections, 58.1

Similar Items, 58.1

Similar Spaces, 58.1

Activity Stream

customization, application, 32.4

customization, user, 32.4

adding to a navigation model, 11.2.2.1.3

Announcements service

Announcements, 59.2.1, 59.2.2

Quick View, 59.2

availability in WebCenter Spaces, 6.1

collapsing and expanding, 29.4.2.4

Content Presenter, 40.1

customizing, 8

about, 8.1

application level customization, 8.2

removing all customizations, 8.5

Space level customization, 8.3

Task Flow Editor page, 8.4

Discussions service

Discussion Forums, 60.1

Popular Topics, 60.1, 60.2.5.2

Quick View, 60.1

Recent Topics, 60.1, 60.2.5.3

Watched Forums, 60.1, 60.2.5.4

Watched Topics, 60.1, 60.2.5.5

Documents service

Document Explorer, 42.2

Document List Viewer, 42.3

Document Manager, 42.4

Document Mini Properties, 42.9

Document Navigator, 42.5

Document Properties, 42.10

Document Version History, 42.11

Document Viewer, 42.8

Folder Viewer, 42.6

Recent Documents, 42.7

See documents task flows

dragging and dropping, 29.4.2.1

editing, 8

about, 8.1

application level editing, 8.2

removing all edits, 8.5

Space level editing, 8.3

Task Flow Editor page, 8.4

Events, 61.1.2

Events service, 61.2

Feedback

properties, 33.5.2

viewing, 33.4.2.1, 33.4.2.1.1

hiding for disabled services, 6.1

launching from Applications Navigator, 6.6.3.3

Lists service, 64.3.2

List Viewer, 64.1

Mail service

Mail, 65.5.2

Members, 52.4

Message Board, 33.4.1

attaching a file, 33.4.1.2.5

attaching a link, 33.4.1.2.5

deleting messages, 33.4.1.7

editing messages, 33.4.1.3

filtering messages, 33.4.1.4

hiding messages, 33.4.1.5

posting, 33.4.1.2.1, 33.4.1.2.2, 33.4.1.2.3

properties, 33.5, 33.5.2

sharing a private message, 33.4.1.2.4

showing hidden messages, 33.4.1.6

sorting messages, 33.4.1.4

viewing messages, 33.4.1.1

navigation, 11.1.2, 11.3.1

notifications, 36.5

about, 36.5.1

properties, 36.5.3, 36.5.3.2

Subscription Preferences, 36.5.1

Subscription Viewer, 36.5.1

Oracle JSF Portlet Bridge and, 19.2.1

People Connections service

Activity Stream, 32.1, 32.1

Activity Stream - Quick View, 32.1

Connections, 31.1, 31.1

Connections - Card, 31.1

Connections - Detailed View, 31.1

Connections - Quick View, 31.1

Feedback, 33.1.2, 33.1.2

Feedback - Quick View, 33.1.2

Message Board, 33.1.1, 33.1.1

Message Board - Quick View, 33.1.1

Organization view, 30.1

Profile, 30.1, 30.1

Profile - Snapshot, 30.1

Profile Gallery, 30.1

Publisher, 34.3.3.1

Polls service

Polls Manager, 67.2.3

Quick Poll, 67.2.2

Take Polls, 67.2.4

View Poll Results, 67.2.5

portletizing, 19.2.1

Producer Registration, 6.5.3

properties

See properties

Publisher, 34.3.3

properties, 34.3.3.5

rearranging, 29.4.2.1

removing, 29.4.2.2

resetting to default, 8.5

resizing, 29.4.2.3

Search service

All Saved Searches, 56.3.1, 56.3.4.2

Search, 56.3.1, 56.3.2.2

Search Preferences, 56.3.1

Search Toolbar, 56.3.1

setting access on, 23.2

Tags service

Similarly Tagged Items, 57.1.4

Tags, 57.1.3

Task Flow Editor system page, 7.3.1

Task Flow Viewer system page, 7.3.1

wiring, 19

one to another, 19.2.1

to page parameters, 19.3.2

to portlets, 19.2.3, 19.2.4

zoomed-in view, 8.4

Team Site template, 50.1.1

Template Category ID property, 40.11.2

Template View ID property, 40.11.2

templates

application

customizing, 5.8

deleting, 53.3.4

publishing, 53.3.1

unpublishing, 53.3.1

viewing, 53.3.2

application skin selections, 35.5

Content Presenter, 40.5

creating for a Space, 50.2

deleting for a Space, 50.3.6

exporting, 53.5.3

for lists, 64.2.3.1

importing, 53.5.4

managing application, 53.3.1

renaming a Space template, 50.3.3

searching in a Space, 50.3.2

Space

about, 50.1

hiding, 50.3.5

managing, 50.3

publishing, 50.3.5

setting access, 50.3.4

unpublishing, 50.3.5

Spaces components, 13

About Space, 13.2.2

About WebCenter, 13.2.3

accessing properties of, 13.2.1

Add to Favorites, 13.2.4

adding, 13.1.3

adding to Resource Catalog, 13.1.1

Administration, 13.2.5

Change Membership, 13.2.6

Contact Administration, 13.2.7

Copyright Message, 13.2.8

Create Page, 13.2.9

Create Space, 13.2.10

Create Subspace, 13.2.11

Current User Profile, 13.2.12

Edit Page, 13.2.13

Favorites Menu, 13.2.14

Global Help, 13.2.15

Home Space, 13.2.16

Invite People as Connection, 13.2.17

Join Space, 13.2.18

Leave Space, 13.2.19

Login, 13.2.20

Logout, 13.2.21

Mail Space Members, 13.2.22

Mail Space Moderators, 13.2.23

making available, 13.1

Manage Pages, 13.2.24

Page Links, 13.2.25

Parent Space, 13.2.26

Print Preview, 13.2.27

Privacy URL, 13.2.28

removing, 13.3.2

removing from Resource Catalog, 13.3.1

RSS, 13.2.29

Search, 13.2.30

Self Registration, 13.2.31

Share Resource, 13.2.32

Spaces Switcher, 13.2.33

Status Indicator, 13.2.34

Subscription Preferences, 13.2.35

Tags, 13.2.36

User Preferences, 13.2.37

working with properties of, 13.2

specifying Resource Catalog to use, 13.1.2

Text And Access Key property, 18.2.7.2

Text layout component, 18.2.8.2

about, 18.2.8.1

display options, 18.2.8.2

Text property, 13.2.2.1, 17.5.2.5, 18.2.7.2, 18.2.10.6

Tgas task flow

about, 57.1.1

Theme property, 18.2.10.2, 18.2.10.3

Three Column page style, 15.1

through the Producer Registration task flow, 6.5.3.2

time preferences, 35.3

timeouts, service provisioning and, 53.6.2

Title property, 18.2.6.2, 27.4.2, 28.3.2, 42.12.1

Top Height property, 18.2.10.3

two page editors, 17.3.1

Type property, 13.2.3.1

U

UI components, wiring, 19

Unauthorized system page, 7.3.1

Unavailable system page, 7.3.1

unregistered user, joining a Space as, 49.6.2

Upload action, 41.5.1.4

Upload Document Only property, 34.3.3.5.2, 34.3.3.5.6

Upload New Version action, 41.5.2.4

Upload New Version menu action, 41.5.1.1

Upload Profiles, 41.8.1

URLs

adding to a navigation model, 11.2.2.1.3

creating links, 63.2.2.6

folders and files, 41.24

format in Oracle WebCenter Spaces, 29.2

obtaining page relative directory path, 18.2.6.1

passing parameter values through, 19.4

pretty URLs, A

application administration pages, A.4

Home Space, A.2

Space pages, A.3

user profile, A.1

to Space, 51.14.2

to Space page, 49.19, 51.7.12

user customizations

about, 29.4.1

collapsing and expanding components, 29.4.2.4

of pages, 29.4.2

removing components, 29.4.2.2

resizing components, 29.4.2.3

User Id property, 30.6.2, 31.5.2, 33.5.2

user interface URLs, A

application administration pages, A.4

Home Space, A.2

Space pages, A.3

user profile, A.1

user name policy, 29.2

User Name property, 30.6.2, 31.5.2, 33.5.2, 34.3.3.5.2

User Preferences Spaces component, 13.2.37

User Profile system page, 7.3.1

user-defined roles, 20.3.1.2

users

adding to application, 21.1.6

assigning roles to, 21.1.2

Authenticated-User role, 21.1.1

changing roles, 21.1.3

granting administrator role, 21.1.4

managing application, 21.1

Public-User role, 21.2.4

removing from application, 21.1.6

revoking roles, 21.1.5

Using ADF Calendar Component property, 61.3.3

V

validation on list column details, 64.2.3.2.3

Valign property, 18.2.10.2

Value property, 18.2.4.2

version history

of files, 41.21

of files using Microsoft Office integration, 46.3.4.10

Version History menu action, 41.5.1.2, 41.5.2.2

Vertical Alignment property, 18.2.2.2

Via User property, 34.3.3.5.2

video files, embedding, 18.2.4.3

View menu

Document Viewer, 41.5.2.2

documents task flows, 41.5.1.2

View Page permission, 23.1, 38.2.1

View-Application permission, 5.12

Viewer role (in a Space), 52.2.1.1

visually impaired users, screen readers, 35.4

W

Web Clipping

about, 25.4.4, 28.1

adding portlet, 28.2

browser support, 28.4

browsing for web content, 28.2.2

customizing, 28.2.2, 28.2.3.1

editing component properties, 28.3

features, 28.1

limitations, 28.4

parameterizing, 28.2.2, 28.2.3.2

personalizing, 28.2.2, 28.2.3.3

properties

All Modes Shared Screen, 28.3.2

Id, 28.3.2

Param#, 28.3.2

Partial Triggers, 28.3.2

Render Portlet In I Frame, 28.3.2

Title, 28.3.2

using cascading style sheets (CSS), 28.4

Web Clipping Studio, 28.2.2

Web Clipping Studio, 28.2.2

Web Page layout component, 18.2.9.2

about, 18.2.9.1

display options

Short Desc, 18.2.9.2

Show Component, 18.2.9.2

Source, 18.2.9.2

Web Page page style, 15.1

Web pages, using as a data source, 27.2.4.7

Web Services

using as a data source, 27.2.4.6

WebCenter Administration, registering portlet producers through, 6.5.2

WebCenter Personalization scenarios, selecting content in Content Presenter, 40.4.5

WebCenter Repository

People Connections service and, 6.4.2

WebCenter Schema and, 6.4.2

WebCenter Schema, 6.4.2

WebCenter services, 53.6.2

Activity Graph service, 58

Announcements service, 59

disabling for a Space, 51.10.1

disabling in application, 6.1, 53.4

Discussions service, 51.10.3, 60

EL expressions relating to, B.3.10

enabling for a Space, 51.10.1

enabling in application, 6.1, 53.4

Events service, 61.1

hiding task flows for disabled services, 6.1

IMP service, 62.1

Links service, 63.1

Lists service, 64.1

Mail service, 51.10.2, 51.10.4, 65

managing for a Space, 51.10

Notes service, 66.1

People Connections service, 6.4

about administering, 6.4.1

accessing administrative settings, 6.4.3.1

Activity Stream, 6.4.3.2, 6.4.4, 32

configuration settings, order of precedence of, 6.4.1

configuring, 6.4.3

Connections, 6.4.3.3, 31

Feedback, 6.4.3.6, 33

LDAP identity store and, 6.4.2

Message Board, 6.4.3.5, 33

Profile, 6.4.3.4, 30.1

Publisher, 34.3.3

troubleshooting, 6.4.5

WebCenter Repository and, 6.4.2

Polls service, 3.3.6, 67, 67

Recent Activities service, 69

reporting issues, 6.1

RSS service, 68

Spaces, 51.4.6

Search service, 56, 56.1

selecting for searches, 56.2.1

service IDs, B.3.10

Tags service, 57

Worklist service, 70

WebCenter Spaces

changing application name, 5.1

customizing

copyright statement, 5.2

page templates, 5.8

privacy statement, 5.2

skins, 5.7

enabling services, 6.1

logo, 5.1

navigation, 11

permissions, 20.3.2

policy store permissions, 20.3.2.1

View-Application permission, 5.12

See also Oracle WebCenter Spaces

WebCenter Welcome Page system page, 7.3.1

WebDAV, uploading files to a Space through, 41.8.1

Width property, 17.5.2.7.2, 18.2.10.7

Wiki page style, 15.1

wikis

about, 47.1

adding to a Space, 51.13

commenting, 34.2

comparing versions, 47.5

creating

choosing a method, 47.2.1

methods, 47.2.1

within a Wiki page style-based page, 47.2.4

editing, 47.3

editing in-context in Content Presenter, 40.10.1

editing in-place, 41.12.3

enabling wiki functionality, 47.1.1

exposing

using Content Presenter, 47.4.2

using Wiki page style, 47.4.1

managing

adding tags and links, 47.6

comments, 47.6

deleting, 47.6

downloading, 47.6

liking, 47.6

modifying properties, 47.6

opening, 47.6

PDF files, 47.6

renaming, 47.6

securing, 47.6

sharing the URL, 47.6

subscribing, 47.6

versions, 47.6

permissions required, 47.1.2

Rich Text Editor icons, 47.3

subscribing to, 36.3.2, 36.3.3.2

wildcards in a search, 56.1.1

Windows Explorer integration, working with, 46.4

Windows Explorer URL to a Space, 49.5

Windows network place, adding a Space as, 46.4.1

Workflow Settings menu action, 41.5.2.1

workflows

about content workflows, 43.1

assigning to folder, 43.2

built-in, 43.1.1

changing, 43.5

deleting, 43.5

on Space folders, 43

participating in, 43.6

steps, 43.1.2

troubleshooting, 53.6.1

viewing

in Documents service task flow, 43.3.1

in Workflow Queue portlet, 43.3.2

status, 43.4

WebCenter Spaces workflows, 53.6.1

working with workflow-enabled content, 43

worklist

about, 70

arranging items, 70.3.3

messaging preferences, 70.3.2

responding, 70.3.1

viewing, 70.3.1

Worklist task flow

arranging items, 70.3.3

using, 70.3

viewing and responding to items, 70.3.1

WSRP producers

deregistering, 6.5.4

registering

using Producer Registration task flow, 6.5.3.2

using WebCenter Administration, 6.5.2.1

X

XML

Spaces components

About Space, 13.2.2.2

About WebCenter, 13.2.3.2

Add to Favorites, 13.2.4.2

Administration, 13.2.5.2

Change Membership, 13.2.6.2

Contact Administration, 13.2.7.2

Copyright Message, 13.2.8.2

Create Page, 13.2.9.2

Create Space, 13.2.10.2

Create Subspace, 13.2.11.2

Current User Profile, 13.2.12.2

Edit Page Component, 13.2.13.2

Favorites Menu, 13.2.14.2

Global Help, 13.2.15.2

Home Space, 13.2.16.2

Invite People as Connection, 13.2.17.2

Join Space, 13.2.18.2

Leave Space, 13.2.19.2

Login, 13.2.20.2

Logout, 13.2.21.2

Mail Space Members, 13.2.22.2

Mail Space Moderators, 13.2.23.2

Manage Pages, 13.2.24.2

Page Links, 13.2.25.2

Parent Space, 13.2.26.2

Print Preview, 13.2.27.2

Privacy URL, 13.2.28.2

RSS, 13.2.29.2

Self Registration, 13.2.31.2

Share Resource, 13.2.32.2

Spaces Switcher, 13.2.33.2

Status Indicator, 13.2.34.2

Subscription Preferences, 13.2.35.2

Tags, 13.2.36.2

User Preferences, 13.2.37.2

using as a data source, 27.2.4.5

Copyright © 2010, 2011, Oracle and/or its affiliates. All rights reserved.