Building Personalized Applications

 

Welcome to the BEA WebLogic Personalization Server Developer's Guide! This guide describes: Personalization Server run-time architecture Information about core services used to deliver personalized content Information needed by JSP tag developers, Servlet developers, and Java programmers who work with Business Analysts to set up customer segmentation rules, content management policies, and ad placeholders

---

 

 

Overview of Personalization Development

Personalization Server Run-Time Architecture

Advisor

Portal Management

User Management

Content Management

Rules Management

Foundation Classes and Utilities

JSP Tags

Integration of External Components

Support for Native Types

 

Creating Personalized Applications with the Advisor

What Is the Advisor?

The Advisor Delivers Content to a Personalized Application

The Advisor Provides Information About User Classifications

You Can Use the Advisor in One of Two Ways

The WLPS Advisor Architecture

Writing Custom Advislets and Registering Them Using the Advislet Registry

Writing a Custom Advislet

Understanding the Advislet Registry

Registering a Single Advislet

Advislet Chaining

Registering a Compound Advislet

Creating Personalized Applications
with the Advisor JSP Tags

Classifying Users with the JSP <pz:div> Tag

Example

Selecting Content with the <pz:contentQuery> JSP Tag

Example

Matching Content to Users with the <pz:contentSelector> JSP Tag

Example

Creating Personalized Applications with the Advisor Session Bean

Classifying Users with the Advisor Session Bean

Querying a Content Management System with the Advisor Session Bean

Matching Content to Users with the Advisor Session Bean

 

Introducing the Rules Manager

What Is the Rules Manager?

Well-known Objects

How the Rules Engine Works

What Are Rule Sets?

Classifier Rules

The AND and OR operators

Content Selector Rules

Debugging Rule Sets

What Is the Relationship Between Property Sets and Rules?

Content Type and Content Selector Rules

Configuring the Rules Framework

The RulesManager Deployment Descriptor

The rules-common.properties file

Rules Framework Debugging

Rule Set TTL

Rules Engine Listeners

Rules Engine Expression Caching Optimizations

Rules Engine Error Handling and Reporting

JSP Tag Properties

Rules Manager Properties

Expression Evaluation Settings

 

Working with Content Selectors

What Are Content Selectors?

Using Content-Selector Tags and Associated JSP Tags

Attributes of the <pz:contentSelector> Tag

Identify the Content Selector Definition

Identify the JNDI Home for the Content Management System

Define the Array That Contains Query Results

Create and Configure the Cache to Improve Performance

Associated Tags That Support Content Selectors

Common Uses of Content-Selector Tags and Associated Tags

To Retrieve and Display Text-Type Documents

To Retrieve and Display Image-Type Documents

To Retrieve and Display a List of Documents

To Access a Content-Selector Cache on a Different JSP

How Content Selectors Select Documents

 

Foundation Classes and Utilities

Flow Manager

Dynamic Flow Determination and Handling

How the FlowManager Works

Property Set Usage

destinationdeterminer Property

destinatationhandler Property

ttl (time-to-live) Property

Creating a New Property Set

Set Parameters for Your Portal or Application

Webflow

Accessing Your Application via the Flow Manager

Repository

HTTP Handling

Personalization Request Object

Default Request Property Set

Personalization Session Object

Default Session Property Set

Utilities

JspHelper

JspBase

P13NJSPHelper

P13NJspBase

ContentHelper

CommercePropertiesHelper

Utilities in commerce.util Package

ExpressionHelper

TypesHelper

 

Creating and Managing Property Sets

Overview of Property Sets

Property Value Retrieval via ConfigurableEntity

Using the Property Set Management Tool

Creating Property Sets

Creating Properties Within a Property Set

Setting Up the Property Default Value

Editing Property Sets

Editing Properties Within a Property Set

Deleting Property Sets

Deleting Properties

 

Creating and Managing Users

Overview of User Management

Users and Groups

Unified User Profiles

Configuration 1

Configuration 2

Configuration 3

Configuration 4

Setting Properties Explicitly or Implicitly

Using WebLogic Realms

Ensure Properties Are Set in the BEA WebLogic Personalization Server's commerce.properties File

Verify That the Realm Is Active

Implementing a New Custom Realm

Anonymous User Profiles

Privacy Statement

User Manager

Using the User Management Tool

Creating Groups

Deleting Groups

Adding Users to Groups

Removing Users from Groups

Editing Group Property Values

Creating User

Editing User Property Values

Deleting Users

Creating Unified Profile Types

Editing Unified Profile Types

Deleting Unified Profile Types

Using the LDAP Realm

Setting up LDAP in the WLS Administration Console

Creating the LDAP Realm

The General Tab

The LDAP Tab

The Users Tab

The Groups Tab

Specifying/Creating the Caching Realm

Verifying the LDAP Properties in config.xml

Example

Startup WebLogic Commerce Server

Registering User Attributes for Retrieval from LDAP

Registering LDAP Properties for Use With Rules

Unregistering User Attributes for Retrieval from LDAP

Registering Group Attributes for Retrieval from LDAP

Unregistering Group Attributes for Retrieval from LDAP

Viewing LDAP Configuration Settings

Using Other Realms

Selecting Groups for Use in the WebLogic Personalization Server from the Realm

Mapping Realm Groups to the WebLogic Personalization Server

Deleting Groups from Your Database

Deleting User Records That Do Not Exist in the Realm from the Personalization Database

 

Creating and Managing Content

What Is the Content Manager?

Choosing a Content Engine

Running Querys Against the Content Repository

Methods for Retrieving and Displaying Documents

Constructing Queries Using Java

Differences Between Content Management and Document Management

Using the Document Servlet

Example 1: Usage in a JSP

Example 2: Usage in a JSP

JSP Tags

Configuring the Content Manager

Configuring the DocumentSchema EJB Deployment Descriptor

Configuring the DocumentManager EJB Deployment Descriptor

Setting Up Connection Pools

Example Connection Pool Entry

Configuring WebLogic Commerce Properties

Using the Show Document Servlet

Querying Document Content

Structuring a Query

Using Comparison Operators to Construct Queries

Using the BulkLoader to Load File-based Content

Command-Line Usage

How the BulkLoader Finds Files

How the BulkLoader Finds Metadata Properties

Cleaning Up the Database

Loading Internationalized Documents

Generating Schema Files

Using Content Management JSP Tags

Content Cache

readOnly Content Tag

Object Interfaces

 

Working with Ad Placeholders

What Are Ad Placeholders, Ad Attributes, and Placeholder Tags?

Ad Placeholders

Types of Queries That Ad Placeholders Run

Types of Documents That Ad Placeholders Display

Ad Attributes in the Content Management System

Ad Placeholder JSP Tags

The <ad:adTarget> JSP Tag

Resolving Ad Query Conflicts

How Ad Placeholders Contain Multiple Queries

How the Ad Conflict Resolver Chooses a Query

How an Ad Placeholder Chooses from Ad Query Results

Creating Ad Placeholder Tags

To Create an Ad Placeholder Tag

Supporting Additional MIME Types

Add the New Type to the Deployment Descriptor

Create and Compile a Java Class to Generate HTML

Register the New Class in weblogiccommerce.properties

How Placeholders Select and Display Ads

 

Creating Localized
Applications with the Internationalization Tags

What Is the I18N Framework?

Localizing Your JSP

<i18n:getMessage>

<i18n:localize>

The JspMessageBundle

How the Localization Tag Works

Character Encoding

Displaying More Than One Character Set on a Page

Default Character Encodings

Steps for Localizing Your Application

Code Examples

Using the JSP Internationalization Framework with JavaScript

Using the JSP Internationalization Framework with Java Scriptlets

Localizing the BEA WebLogic Personalization Server

Static Text

Constructed Messages

Resource Bundles Used in the
WebLogic Personalization Server Tools

Localizing System Messages

 

The WebLogic Personalization Server Database Schema

The Entity-Relation Diagram

List of Tables Comprising the WebLogic Personalization Server

The Personalization Server Data Dictionary

The AD_BUCKET Database Table

The AD_COUNT Database Table

The PLACEHOLDER Database Table

The PLACEHOLDER _PREVIEW Database Table

The WLCS_BOOKMARKS Database Table

The WLCS_CATEGORIES Database Table

The WLCS_COLUMN_INFORMATION Database Table

The WLCS_DOCUMENT Database Table

The WLCS_DOCUMENT_METADATA Database Table

The WLCS_ENTITY_ID Database Table

The WLCS_GROUP Database Table

The WLCS_GROUP_HIERARCHY Database Table

The WLCS_GROUP_PERSONALIZATION Database Table

The WLCS_IS_ALIVE Database Table

The WLCS_LDAP_CONFIG Database Table

The WLCS_PROP_BOOLEAN Database Table

The WLCS_PROP_DATETIME Database Table

The WLCS_PROP_FLOAT Database Table

The WLCS_PROP_ID Database Table

The WLCS_PROP_INTEGER Database Table

The WLCS_PROP_MD Database Table

The WLCS_PROP_MD_BOOLEAN Database Table

The WLCS_PROP_MD_DATETIME Database Table

The WLCS_PROP_MD_FLOAT Database Table

The WLCS_PROP_MD_INTEGER Database Table

The WLCS_PROP_MD_TEXT Database Table

The WLCS_PROP_MD_USER_DEFINED Database Table

The WLCS_PROP_TEXT Database Table

The WLCS_PROP_USER_DEFINED Database Table

The RULESET Database Table

The WLCS_RULESET_DEFINITION Database Table

The WLCS_SCHEMA Database Table

The WLCS_SEQUENCER Database Table

The WLCS_TODO Database Table

The WLCS_UIDS Database Table

The WLCS_UNIFIED_PROFILE_TYPE Database Table

The WLCS_USER Database Table

The WLCS_USER_GROUP_CACHE Database Table

The WLCS_USER_GROUP_HIERARCHY Database Table

The WLCS_USER_PERSONALIZATION Database Table

The WLCS_UUP_EXAMPLE Database Table

The SQL Scripts Used to Create the Database

Cloudscape

Oracle

SQL Server

Defined Constraints

 

Personalization Server JSP Tag Library Reference

Ads

<ad:adTarget>

Content Management

<cm:getProperty>

Example

<cm:printDoc>

Example

<cm:printProperty>

Example

<cm:select>

Example

<cm:selectById>

Example

Flow Manager

<fm:getApplicationURI>

Example

<fm:getCachedAttribute>

Example

<fm:getSessionAttribute>

Example

<fm:removeCachedAttribute>

Example

<fm:removeSessionAttribute>

Example

<fm:setCachedAttribute>

Example

<fm:setSessionAttribute>

Example

Internationalization

<i18n:localize>

Example

<i18n:getMessage>

Example

Personalization Tags

<pz:contentQuery>

Example

<pz:contentSelector>

Specify a Value for contentHome

Example

<pz:div>

Example

Placeholders

<ph:placeholder>

Property Sets

<ps:getPropertyNames>

Example

<ps:getPropertySetNames>

User Management:
Profile Management Tags

<um:getProfile>

Example 1

Example 2

Example 3

<um:getProperty>

Example 1

Example 2

<um:getPropertyAsString>

Example

<um:removeProperty>

Example

<um:setProperty>

Example

User Management:
Group-User Management Tags

<um:addGroupToGroup>

Example

<um:addUserToGroup>

Example

<um:changeGroupName>

Example

<um:createGroup>

Example

<um:createUser>

Example

<um:getChildGroupNames>

<um:getChildGroups>

Example

<um:getGroupNamesForUser>

Example

<um:getParentGroupName>

Example

<um:getTopLevelGroups>

Example

<um:getUsernames>

Example

<um:getUsernamesForGroup>

Example

<um:removeGroup>

Example

<um:removeGroupFromGroup>

<um:removeUser>

Example

<um:removeUserFromGroup>

User Management: Security Tags

<um:login>

<um:logout>

<um:setPassword>

Personalization Utilities

<es:counter>

Example

<es:date>

Example

<es:forEachInArray>

Example

<es:isNull>

Example

<es:monitorSession>

Example

<es:notNull>

Example

<es:simpleReport>

Example

<es:transposeArray>

Example

<es:uriContent>

Example

WebLogic Utilities

<wl:process>

Example

<wl:repeat>

<wl:cache>