Sun logo      Copyright      Index      Next     

Sun ONE Portal Server 6.2 Desktop Customization Guide

Contents


About This Guide
Who Should Read This Book
What You Need to Know
How This Book Is Organized
Document Conventions Used in This Guide
Monospaced Font
Bold Monospaced Font
Italicized Font
Square or Straight Brackets
Command-Line Prompts
Variables
Where to Find Related Information
Where to Find This Guide Online

Chapter 1   Introduction to Customizing the Desktop
Types of Desktop Customizations
End User Customizations
Developer Customizations
Administrator Customizations
Using the Display Profile
Display Profile Document Structure
Modifying the Display Profile
Where to Go for More Information
Using JavaServer Pages and Template Files
The Desktop and JavaServer Pages
The Desktop and Template Files
Changing the Desktop Type
Using the Desktop Tag Library
What Is the Sample Portal?
Creating a New Desktop
Developing the Container
Editing the Display Profile
Developing JSP or Template Files
Deploying JSP or Template Files
Loading the Display Profile at the Appropriate LDAP Nodes
(Optional) Creating a Resource Bundle
Accessing the Desktop
Creating and Extending a Provider Class

Chapter 2   Display Profile Properties
Overview of Display Profile Properties
Display Profile Properties
Display Profile Property Types
Display Profile Global Properties

Chapter 3   Container Provider Display Profile Definitions and Properties
Display Profile Definitions for Building-Block Container Provider
JSPTableContainerProvider
JSPTabContainerProvider
JSPSingleContainerProvider
TemplateTableContainerProvider
TemplateTabContainerProvider
Display Profile Definitions for Internally Used Container Providers
JSPTabCustomTableContainerProvider
JSPFrameCustomTableContainerProvider
TemplateEditContainerProvider
TemplateTabCustomTableContainerProvider
PredefinedFrontPageFramePanelContainerProvider
PredefinedSamplesFramePanelContainerProvider
PredefinedToolsTemplatePanelContainerProvider
PredefinedFrontPageTemplatePanelContainerProvider
PredefinedSamplesTemplatePanelContainerProvider
PredefinedSamplesTabPanelContainerProvider
PredefinedFrontPageTabPanelContainerProvider
Container Provider Display Profile Properties
Available and Selected List
Common Properties for Table Container
Common Properties for Tab Container
Other Container Properties

Chapter 4   Leaf Provider Display Profile Definitions and Properties
Overview of Display Profile Provider Definitions and Properties
Display Profile Definitions and Properties of Leaf Building-Block Providers
JSPProvider
URLScraperProvider
XMLProvider
Display Profile Definition for Service Providers
SearchProvider
DiscussionProvider
SubscriptionsProvider
Display Profile Definitions for Content Providers
AddressBookProvider
AppProvider
BookmarkProvider
CalendarProvider
IMProvider
LoginProvider
LotusNotesAddressBookProvider
LotusNotesCalendarProvider
LotusNotesMailProvider
MailCheckProvider
MailProvider
MSExchangeAddressBookProvider
MSExchangeCalendarProvider
MSExchangeMailProvider
NotesProvider
PersonalNoteProvider
SimpleWebServiceProvider
SimpleWebServiceConfigurableProvider
UserInfoProvider
Display Profile Common Properties for Providers
isEditable
authlessState
encoderClassName
ConditionalProperties

Chapter 5   Display Profile Channel Definitions
Overview of Channel Display Profile Definitions
Display Profile Definition for Container Channels
JSPTableContainer
MyFrontPageFramePanelContainer
SamplesTabPanelContainer
SearchTabPanelContainer
MyFrontPageTabPanelContainer
SamplesFramePanelContainer
JSPTabContainer
JSPCreateChannelContainer
JSPPresetThemeContainer
JSPCustomThemeContainer
JSPPopupContainer
TemplateTableContainer
TemplateTabContainer
MyFrontPageTemplatePanelContainer
SamplesTemplatePanelContainer
ToolsTemplatePanelContainer
FrameTabContainer
JSPDynamicSingleContainer
PredefinedFrontPageTabPanelContainer
PredefinedSamplesTabPanelContainer
JSPTabCustomTableContainer
PredefinedFrontPageTemplatePanelContainer
PredefinedSamplesTemplatePanelContainer
PredefinedToolsTemplatePanelContainer
TemplateTabCustomTableContainer
PredefinedFrontPageFramePanelContainer
PredefinedSamplesFramePanelContainer
FrameCustomTableContainer
Display Profile Definition for Leaf Channels
Address Book Channel
Applications List Channel
Bookmark Channel
Calendar Channel
Discussion Channels
Instant Messaging Channel
JSP Channel
Login Channel
Lotus Notes Address Book Channel
Lotus Notes Calendar Channel
Lotus Notes Mail Channel
Mail Channel
Mail Check Channel
MS Exchange Address Book Channel
MS Exchange Calendar Channel
MS Exchange Mail Channel
Notes Channel
Search Channel
Sample Simple Web Service Channel
Sample Simple Web Service Configurable Channel
Subscriptions Channel
Sample RSS Channel
User Information Channel
Sample URL Scraper Channel
Sample XML Channel

Chapter 6   Understanding the Sample Portal
Overview of the Sample Portal
Sample Containers for the Sample Desktop
Guidelines for Using the Sample Portal
Sample Portal Installation Directories
Desktop Theme Link
JSP-based Tab Container (JSPTabContainer)
JSPTabContainer Architecture
JSPTabContainer Actions
JSPTabContainer Edit Pages
Container Display Profile
JSP Files Used by JSPTabContainer
JSP-based Table Container (JSPTableContainer)
JSPTableContainer Architecture
JSPTableContainer Actions
Container’s Display Profile
JSP Files Used by JSPTableContainer
Frame-based Container (FrameTabContainer)
FrameTabContainer Architecture
FrameTabContainer Actions
FrameTabContainer Edit Pages
Container’s Display Profile
JSP Files Used by FrameTabContainer
Template-based Containers (TemplateTabContainer and TemplateTableContainer)
TemplateTabContainer

Chapter 7   Customizing the Desktop Interface
Desktop Customization Overview
What Are the Areas for Customizing the Desktop?
Channel Refresh Times and Container Caching
Contained Containers
Guidelines for Using the dpadmin Command
Adding Containers and Channels to the Desktop
Customizing Container Tabs
To Add a Tab to JSPTabContainer
Creating a Tab Within a Tab
To Stretch a Tab Across an Entire Container
To Change the Tab Image for JSP-based Tab Containers
To Change the Color of Tabs
To Make a Tab the Start Tab
Setting a Role Tab
Adding a Channel to a User-defined Tab
Customizing Channels
To Customize Window Preference
To Remove a Button From All Channels in a Container
To Remove a Button From a Single Channel
To Disable the User from Editing Instant Messaging Server Information
To Automatically Close the Instant Messaging Invite Window
To Customize Display of Instant Messaging Contacts
Creating Customized Organization JSP and Template Files
Customizing the Anonymous Desktop
Configuring Anonymous Authentication
To Enable Anonymous Log In
To Disable Anonymous Log In
To Enable Authentication-less (authlessanoymous) Log In
To Disable Authentication-less (authlessanoymous) Log In
To Access the Anonymous Desktop Through the Identity Server Host Name (obj.conf File)
To Access the Anonymous Desktop Through the Portal Server Host Name (index.html File)
To Disable the Initial Sun ONE Identity Server Software Login Page and Always Use Anonymous Log In
To Modify the Anonymous Banner and Menu Bar
To Add the Login Channel to the Anonymous Desktop of a Newly Created Organization
Customizing Authentication
To Use Unix Authentication with LoginProvider
To Modify the Default Desktop (Container) for authlessanonymous User
Modifying the Desktop Layout
Deriving More Desktop Layouts
To Derive More Desktop Layouts
Changing Content Layout to Support Categorizing the Available and Selected Lists
Adding New Layouts
To Change the Desktop Column Layout (Command Line)
To Change the Desktop Column Layout (Sun ONE Identity Server Software Administration Console)
To Change the Channel Layout for a Table Container
To Remove the Title Bar from a Channel
To Change the Channel Border Width
To Customize the Channel Border
To Modify Column Widths Directly (Using Scriptlets)
Branding the Desktop
To Change the HTML Title (Title That Appears in the Browser)
To Change the Logo (Image) in the Banner Header
To Change the Header and Footer of the Theme, Content, and Layout Pages
Changing Desktop Colors
To Change Desktop Colors
To Change the Default Color Scheme for an Organization
Customizing the Global Themes
Customization Overview
GlobalThemes Display Profile Definition
Theme Properties
Glossary of Terms
Adding and Customizing Global Themes
Miscellaneous JSP Information
Performing Redirects
JSP vs. Theme Color
Recompiling JSPs
JavaServer Page Caching Information
Desktop Debug Information
Debugging JSPs

Chapter 8   Customizing the Service Providers
Overview of Customizing the Service Providers
Overview of Customizing the Search Provider
Overview of Customizing the Discussion Provider
Tips for Customizing the Service Providers
Debugging the Service Providers
Location of JavaServer Pages
Modifying JavaServer Pages
Accessing Channels Directly
Customizing the Search Provider
To Modify the Default Search Server
To Modify the Default Search Server:
To Add last-modified to the Search Result Display
To Remove content-length from Search Results
To Display the Total Number of Documents in the Search Result Status Message
To Remove author from the Advanced Search Interface
To Add a New Field to Advanced Search
Customizing the Discussion Channels
Customizing DiscussionLite Channel
Customizing Discussions Channel

Chapter 9   Customizing the Desktop End-User Online Help
Overview of the Desktop End-User Online Help
Location of the Desktop End-User Online Help HTML files
Modifying the Desktop End-User Online Help HTML files
To Edit An Existing Help File
To Create a New Help File

Appendix A   Desktop Template and Tag Reference
Overview of Desktop Templates and Tags
How the Desktop Template Tags Work
Template Lookup
Kinds of Tags Used in the Desktop
Desktop Templates in the default Directory and Tag Reference
AddressBookProvider
AppProvider
BookmarkProvider
CalendarProvider
error
LoginProvider
LotusNotesAddressBookProvider
LotusNotesCalendarProvider
LotusNotesMailProvider
MailCheckProvider
MailProvider
MSExchangeAddressBookProvider
MSExchangeCalendarProvider
MSExchangeMailProvider
TemplateTabContainerProvider
TemplateTableContainerProvider
UserInfoProvider
default
Desktop Templates in the sampleportal Directory and Tag Reference
MyFrontPageTemplatePanelContainer
PredefinedFrontPageTemplatePanelContainerProvider
PredefinedSamplesTemplatePanelContainerProvider
SamplesTemplatePanelContainer
TemplateTabContainerProvider
TemplateTabCustomTableContainerProvider
TemplateTableContainer
ToolsTemplatePanelContainer
sampleportal

Appendix B   JavaServer Pages Tag Library Reference
Tag Library Overview
Desktop Tag Library Hierarchy
Using Tags in JSPs
Using the Desktop Tag Library in Your Application
Example Tab Page with Selected Channels
Tag Reference
Attributes and Return Values
Tag Library Exceptions
Tag Overview
Context Setup Tags
Validator Tags
Normal Tags
Search Tags
Instant Messaging Tags

Appendix C   JavaServer Pages Reference
Anonymous Desktop JSPs
FrameTabContainer JSPs
JSPDynamicSingleContainer JSPs
JSPTabContainer JSPs
JSPTableContainer JSPs
PredefinedFrontPageFramePanelContainerProvider JSPs
PredefinedFrontPageTabPanelContainerProvider JSPs
PredefinedSamplesFramePanelContainerProvider JSPs
PredefinedSamplesTabPanelContainerProvider JSPs
Desktop JSPs in the default Directory
DiscussionLite JSPs
Discussions JSP
DiscussionsProvider JSPs
DummyChannel JSPs
IMProvider JSPs
JSPContentContainer JSPs
JSPDynamicSingleContainer
JSPEditContainer JSPs
JSPFrameCustomTableContainerProvider JSPs
JSPLayoutContainer JSPs
JSPProvider JSPs
JSPSingleContainerProvider JSPs
JSPTabContainerProvider JSPs
JSPTabCustomTableContainerProvider JSPs
JSPTableContainerProvider JSPs
Miscellaneous JSPs
SampleSimpleWebService JSPs
SampleSimpleWebServiceConfigurable JSPs
Search JSPs
SearchProvider JSPs
SimpleWebServiceConfigurableProvider JSPs
SimpleWebServiceProvider JSPs
Subscriptions JSPs
SubscriptionsProvider JSPs
TabJSPEditContainer JSPs
JSPs in the sampleportal Directory
FrameTabContainer JSPs
JSPContentContainer JSPs
JSPCreateChannelContainer JSPs
JSPCustomThemeContainer JSPs
JSPDynamicSingleContainer JSPs
JSPEditContainer JSPs
JSPFrameCustomTableContainerProvider JSPs
JSPLayoutContainer JSPs
JSPPopupContainer JSPs
JSPPresetThemeContainer JSPs
JSPSingleContainer JSPs
JSPTabContainer JSPs
JSPTabCustomTableContainerProvider JSPs
JSPTableContainerProvider JSPs
Miscellaneous JSPs
PredefinedFrontPageFramePanelContainerProvider
PredefinedFrontPageTabPanelContainerProvider
PredefinedSamplesFramePanelContainerProvider
PredefinedSamplesTabPanelContainerProvider
SampleJSP JSPs
SampleSimpleWebService JSPs


Copyright      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.