Sun Java System Portal Server 7.1 Technical Reference

Chapter 13 Introduction to Display Profile

This chapter contains the following sections:

What is Display Profile?

The display profile is a series of XML documents describing container management and properties for providers and channels. The display profile creates the display configuration for the Desktop by defining the following items in the XML document:

Provider definition

Specifies the name and the Java class for the provider. A provider is a template used to generate content, which is displayed in the channel. See Provider Object for more information.

Channel definition

Specifies the run-time configuration of an instance of the provider class. A channel is a unit of content, usually (but not necessarily) arranged in rows and columns. You can also have channels of channels, that is, container channels. See Channel Object for more information.

The container channel properties include the display definition about how to display the contained channels in the container, including: the layout of the container (thin-wide, wide-thin, or thin-wide-thin); a list of the contained channels; the position of the channel (the row and column number); and the window state of the contained channels (minimized or detached).

Provider and channel property definitions

Specify the values for provider and channel properties. Properties defined in a provider usually specify default values for the channels that are derived from the provider. The display configurations for the channels include properties such as the title, description, channel width, and so on. The properties defined in the channel usually specify the specific value for that channel that is different from the default value. See Property object for more information.


Note –

If a property is not defined in the channel, then the default value for the property as defined in the provider is used. If a property is defined in the channel, then the value for the property defined in the provider is ignored.


The display profile does not actually define the overall layout or organization of what users see on their Desktops. The display profile exists only to provide property values for channels. However, the display profile does indirectly control some aspects of channel presentation, such as column layout for a table container or how the table container draws channels in a table.

Administering the Display Profile

You can use the Portal Server Console and psadmin to administer the Portal Desktop Service data and the Display Profile. In the Portal Server console, you can upload, download, and remove the display profile from a specific dn. You can edit the desktop service attributes. You can modify channels and containers properties. You can also create, edit, and remove channels in the containers. The psadmin provides commands, which allow you to list, add, remove, modify, and merge display profiles. For more information, see the Sun Java System Portal Server 7.1 Administration Guide.