Sun Java System Portal Server 7.1 Technical Reference

Desktop Dynamic Attributes

This section describes the dynamic attributes for the Desktop Service.

The table below describes the desktop service dynamic attributes and their description.

Table 1–2 Desktop Service - Dynamic Attributes


Default Value 


COS Priority 


Sets the conflict resolution level for the Desktop service template used to resolve conflicts when multiple Desktop templates are merged. There are seven conflict resolution settings available ranging from Highest to Lowest. 

Do not confuse this setting with the display profile document priority. The display profile document priority is a numeric value that is set in the XML file with the priority= syntax tag. When a merge occurs, it starts with the lowest display profile priority document (lowest number) and proceeds in increasing priority number, until it arrives at the user (base), the highest priority display profile. 

When an attribute conflict occurs, the attribute on the template set with the highest conflict resolution level is returned. 

Parent Container 


Identifies which default channel is rendered when the Desktop is called with an unspecified provider. 

Edit Container 


Specifies which default edit channel to use to wrap the content when one is not specified in the URL. When a channel is edited, an “Edit” request URL is sent to the Desktop Servlet. The URL generated for the “Edit” of each of the channels inside a container depends on the property “editContainerName” defined in the display profile. 

If you have migrated containers from iPlanet™ Portal Server 3.0, you must specify the default edit channel with which to wrap the content using this attribute because the URL format has changed. 

Desktop Type 


Retrieves template files for the specified Desktop type when different Desktop configurations are needed and when different sets of templates and JSPs are required for those configurations. 

The Desktop type attribute of the Desktop service is a comma-separated string type, that the Portal Desktop uses as an ordered list. The list is used by the Desktop lookup operation when searching for templates and JSPs. The lookup starts at the first element in the list and each element represents a subdirectory under the Desktop template base directory. If a template is not found in the first directory, then it proceeds to the next one in the list. This continues until the item is found (or not), for all Desktop type elements in the list. 

If the default directory is not included in the list, it will be added at the end of the list implicitly. For example, if the Desktop type is sampleportal, the target template will be searched in the sampleportal subdirectory, then the default subdirectory. By default, if the sample portal is installed, then the Desktop type attribute, sunPortalDesktopType, is set to sampleportal. If the sample portal is not installed, then the Desktop type attribute value is set to default.

Most sites will not use the default Desktop type, as they will have different channels, different logo, different look and feel, and the like. 

Desktop Attributes 

Show (selected) 

Specifies whether the Desktop Service attributes are displayed to the users associated with the role. This dynamic attribute is mainly used for role-based delegated administration, Values applied to this attribute are only in effect for a role. 

When the role is assigned to a user and the value of this attribute is false, users (usually delegated administrators) cannot see any Desktop Service attributes except the Channel and Container Management link when they navigate into all the roles within the organization.

DisplayProfile Priority 

The default value depends on the type of installation performed. If the sample portal was installed, a sample display profile document is installed at the organization level that contains channels that display the built-in providers defined in the global display profile. 

Displays several links for manipulating the display profile, an XML document that defines the container management, channel attributes, and provider definitions for this specific node (role, organization, suborganization). Links are: 

  • Edit XML--Allows you to edit the entire display profile XML file.

  • Upload XML--Allows you to upload an XML file containing display profile information to the Portal Server.

  • Download XML--Allows you to download the display profile to your local drive.

    These links are not attributes. Selecting these links allows you to manipulate the display profile.