Presentation Method

Determine whether the provider will fetch content from template files or JSPs. This will determine the logistics of the getTemplate() method.

Channel template files are stored in a directory based on the name of the channel, or the name of the provider that is used by the channel. The channel directory for the provider is created under the template root directory. By default, this will be:

PortalServer-DataDir/portals/portal-ID/desktop/desktoptype/channeldirectory/templatefiles

The JSPs and templates for desktop type default are stored under PortalServer-DataDir/portals/portal-ID/desktop/default directory. Storing the files in the PortalServer-DataDir/portals/portal-ID/desktop/default directory allows the files to be shared. That is, when the Desktop service uses the comma-separated string (as an ordered Desktop type list) in the Desktop type attribute to lookup, it starts at the first element in the list and each element represents a sub directory under the Desktop template base directory. If a template is not found in the first directory (or the first string in the desktop type attribute), 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.

The directory search order for the template and JSP files is as follows:

desktoptype_locale/channelname/clientPath
desktoptype_locale/provider/clientPath
desktoptype_locale/channelname
desktoptype_locale/provider
desktoptype_locale/clientPath
desktoptype_locale
desktoptype/channelname/clientPath
desktoptype/provider/clientPath
desktoptype/channelname
desktoptype/provider
desktoptype
default_locale/channelname/clientPath
default_locale/provider/clientPath
default_locale/channelname
default_locale/provider
default_locale
default/channelname/clientPath
default/provider/clientPath
default/channelname
default/provider
default/clientPath
default
templateroot

Where

• desktoptype is the value of the desktopType property

• locale is the user’s locale

• channelname is the name of the channel

• provider is the provider name

• clientPath is an optional file-path containing client-specific templates

• templateroot is, by default, PortalServer-DataDir/portals/portal-ID/desktop

If there is no clientPath specified, then the directory search order is as follows:

desktoptype_locale/channelname
desktoptype_locale/provider
desktoptype_locale
desktoptype/channelname
desktoptype/provider
desktoptype
default_locale/channelname
default_locale/provider
default_locale
default/channelname
default/provider
default
templateroot

If the channel display profile is defined inside a container display profile definition, the lookup for the channel will be desktoptype/containername/channelname/clientPath.