Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle WebCenter Ensemble
10g Release 3 (10.3.0.1.0)
E14114-01
  Go To Documentation Library
Library
Go To Product List
Product
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

11 Extending Oracle WebCenter Ensemble

This chapter describes ways to extend Oracle WebCenter Ensemble, including customizing the user experience and developing web applications using Oracle WebCenter Ensemble extensions, and is divided into the following sections:

Custom Login Resources

What the user sees when she logs in and out of Oracle WebCenter Ensemble resources is controlled by customizing login resources. Based on the experience definition associated with the user, different pages can be delivered to the user at different times in the login or logout process. The following sections describe login resources and how to use them to communicate with Oracle WebCenter Ensemble.

For details on using experience definitions to determine which login resource is used with a given user, see Chapter 7, "Experience Definitions."

About Login Resources

A login resource hosts pages associated with a user's experience authenticating with Oracle WebCenter Ensemble. The following table describes the types of pages that can be delivered by a login resource:

Table 11-1 Login Resource Pages

Page Definition

Pre-login page

This page is displayed to the user prior to prompting the user for authentication the user.

Login page

This page is only applicable when form authentication is being used, and provides the form for login.

Post-login page

This page is displayed to the user after successful authentication and before the resource is accessed.

Error page

This page is displayed if there is an error in the login process.

Post-logout page

This page is displayed after the user logs out of the resource.


A web page on the login resource can be specified for any or all of these settings using experience definitions. For details on configuring experience definitions, see Login Resources and Interstitial Pages.

Communicating With Oracle WebCenter Ensemble

Login resource pages communicate with Oracle WebCenter Ensemble by using HTTP headers. The following table lists the available headers and describes how and when they are used in the login or logout process.

Table 11-2 Login Resource Headers

Page Header Values

Pre-login

runner_pre_interstitial_complete

  • true - indicates that the Pre-login page has completed successfully. The page is not displayed and Oracle WebCenter Ensemble proceeds to the login page.

  • false - Oracle WebCenter Ensemble does nothing when the header is set to false or if the header is not present. The pre-login page is displayed.

Login

runner_username

  • The username Oracle WebCenter Ensemble uses to authenticate the user.

Login

runner_password

  • The password Oracle WebCenter Ensemble uses to authenticate the user.

Login

runner_authentication_provider

  • The provider for authentication. For Oracle WebCenter Ensemble 10.3 the only valid value is portal. If the header is not present, the provider defaults to portal.

Login

runner_portal_authentication_source

  • The authentication source to authenticate the user against. This is the same as the authentication source the user would use to log in to the portal.

Post-login

runner_post_interstitial_complete

  • true - indicates that the Post-login page has completed successfully. The page is not displayed and Oracle WebCenter Ensemble proceeds to the login page.

  • false - Oracle WebCenter Ensemble does nothing when the header is set to false or if the header is not present. The post-login page is displayed.



Note:

Error and Logout pages are considered terminal pages and do not communicate with Oracle WebCenter Ensemble using headers. Oracle WebCenter Ensemble does provide information to these pages using Oracle WebCenter Ensemble Adaptive tags. For details, see Oracle WebCenter Ensemble Adaptive Tags.

Oracle WebCenter Ensemble Adaptive Tags

Oracle WebCenter Ensemble Adaptive Tags allow you to insert data and logic into your proxied web application. Oracle WebCenter Ensemble transforms tags included in proxied web applications before the page is delivered to the user.

For additional details, see the topic on Oracle WebCenter Ensemble Adaptive Tags in the Oracle Fusion Middleware Developer's Guide for Oracle WebCenter Ensemble, which is located on the Oracle Technology Network at http://download.oracle.com/docs/cd/E13158_01/ensemble/docs103/index.html.