Chapter 27 Display Profile Properties: Global Properties

There are no global properties defined in the base Desktop. Global properties are added via the sample portal installation. So, if you did not install the sample portal, by default, you do not have any global properties defined in the base Desktop.

Use global properties to assign properties that apply to all channels. For example, Code Example 27-1 shows (a snippet of) the global properties defined in the dp-org.xml display profile file that is part of the sample portal. You assign the global properties inside the <Properties> </Properties> definition by using tags such as <Collection> </Collection>, <String> </String>, <Integer> </Integer>, and so on.

Code Example 27-1 Global Properties Sample in the Display Profile dp-org.xml File


<DisplayProfile version="1.0" priority="10">
<Properties>

<Collection name="GlobalThemes" propagate="false">
<Collection name="SunTheme">
...
</Collection>
</Collection>
<Collection name="UserTheme">
...
</Collection>
<String name="docroot" value=”/docs/”/>
<ConditionalProperties condition="locale">
<String name="en_US" value="English (United States)"/>
</ConditionalProperties>
<String name="helpURL" value="en/desktop/usedesk.htm" advanced="true"/>
<Collection name="userDefinedChannels" propagate="false"/>
</Properties>

The following is a list of all the global attributes available with the default installation of the sample portal. This two column table lists the attributes in the first column and a brief description in the second column.


GlobalThemes	Defines the global themes for the Desktop. Themes are mainly focused on channel decoration like background color, channel border color, border width, and font face. Custom themes give the end user the ability to change the look and feel of the Desktop beyond the preset themes. Global themes can be added in the display profile and changed by users in their Desktops. See “Customizing the Global Themes” on page 259 for information on adding global themes.
UserTheme	Defines the theme that shows up in the user’s Desktop. The value must be one of the collection values defined in GlobalThemes. In dp-org.xml file, the value can be either theme1 or theme2. When users customize their Desktops, the value UserTheme will change.
locales	Used by UserInfoProvider to form the Language pull-down list.
docroot	Specifies the online help doc root relative to the installed portal/static location. See the Javadocs for more information on the getHelp() method in the ProviderContext API.
helpURL	Specifies a default help file that is used by all containers. If helpURL is specified in the container provider definition, then that one is used.
userDefinedChannels	Specifies the page to allow users to Create New Channel.

Previous Contents Index Next
Sun Java System Portal Server 6 2005Q1 Technical Reference Guide