Sun Java System Portal Server 7.1 Technical Reference

desktop.tld Tags With Attributes

Table 55–1 desktop.tld Tags with Attributes

Tag Name 

Description 

Attributes 

getProviderClassName 

Returns the class name of the provider that backs the channel. 

id (optional) 

scope (optional) 

getContent 

Returns a string buffer with the contents of the provider’s object’s default view. This method is called by the clients of the provider object to request the provider’s default view. This method may return null if the provider does not implement a default view. In this case, the provider should return false from its isPresentable() method. 

none 

getTitle 

Returns a string with the title of the channel. 

id (optional) 

scope (optional) 

silentException (optional) 

getDescription 

Returns a string with the description for the channel. 

id (optional) 

scope (optional) 

silentException (optional) 

getEdit 

Returns a string buffer with the provider’s Edit page. 

id (optional) 

scope (optional) 

getHelp 

Returns the help URL for this provider. The returned help URL can be either fully qualified URL string (http://server:port/portal/docs/en/desktop/usedesk.htm) or a relative path (desktop/usedesk.htm). When it is a relative path, the Desktop software resolves it to the full URL. 

id (optional) 

scope (optional) 

silentException (optional) 

getName 

Returns a string with the name of the provider, which must match the name of the provider the channel was initialized with. 

id (optional) 

scope (optional) 

getRefreshTime 

Returns a long with the refresh time for this provider in seconds. 

Use this value to determine if you should fetch a fresh default view for the provider. 

If the return value from this method is X, you may choose not to fetch fresh content (and use a cached copy instead) if less than X seconds has elapsed since the last time the content was refreshed. 

If provider content is expected to change infrequently, this method can return some value so that the provider’s content is not fetched every time the front page is drawn, thereby saving significant processing time. 

id (optional) 

scope (optional) 

getWidth 

Returns an integer with the suggested width for the channel to the container of the channel as to how much screen real estate it requires. The values correspond to thick, thin, full top and full bottom. 

id (optional) 

scope (optional) 

silentException (optional) 

getEditType 

Returns an integer that defines edit type either EDIT_SUBSET or EDIT_COMPLETE. 

id (optional) 

scope (optional) 

isEditable 

Returns a Boolean that gives the editable status of the channel. Returns true if the channel is editable; otherwise false. 

id (optional) 

scope (optional) 

isPresentable 

Returns a Boolean that gives the presentable status for a channel. Returns true if the channel is presentable. 

Searches for the key HTML with the value true on the client data for the session’s client type and returns true. 

If there is no such key, the method returns true if the session’s client type is named HTML. 

In both cases, the content-type for the session’s client type must equal text/html in order for the method to return true. 

id (optional) 

scope (optional) 

processEdit 

Performs the provider’s Edit page processing. Processes a form for this provider. This method is called to process form data associated with the provider. Typically, this method is called to process the Edit page generated from the getEdit() method. Usually, the client calling this method on a provider object is the desktop servlet. Form data that is passed into this method in the request has been decoded into Unicode. 

id (optional) 

scope (optional) 

getContainerClassName 

Returns the class name of the container that backs the container. 

id (optional) 

scope (optional) 

getSelectedChannels 

Returns a list of selected channel names. The list returned is a Collection of Strings. Each of the Strings is the name of a channel that has been selected. 

id (required) 

scope (optional) 

getAvailableChannels 

Returns a list of available channel names. The list returned is a Collection of Strings. Each of the Strings is the name of a channel that is available 

id (required) 

scope (optional) 

scontent 

Returns the URL of the directory that has the static content (for example, images and style sheet). This utility tag can be used anywhere. 

none