The IMProvider content page uses a custom tag library defined in a file called im.tld which is installed into the /var/opt/SUNWportal/portals/<portal_id>/desktop/default/tld directory. The im.tld file defines the following tags:
Tag Name |
Description |
Attributes |
---|---|---|
getContactGroups |
Returns list of contact groups that the user has defined. The list is returned as a Collection of Strings where each String is the display name for a contact group. |
id (optional) scope (optional) |
getContactGroup |
Returns the list of contacts in the named contact group. The list is returned as a Collection of internal objects that can be passed to the obtainContact tag. |
group (required) - The name of the contact group. id (optional) scope (optional) |
getUsername |
Returns the instant messaging username for the user. |
id (optional) scope (optional) |
getToken |
Returns the login token for the user (either an Sun Java System Access Manager software SSOToken or the user’s password.) |
id (optional) scope (optional) |
obtainContact |
A context setup tag that is used to obtain the presence information for the indicated contact. The remaining tags can be used inside this tag. |
contact (required) - The internal identifier of the contact, typically obtained from the getContactGroup tag. |
getContactPresence |
Returns the current presence status for the contact. The status can be: AWAY, BUSY, CLOSED, FORWARDED, IDLE, OPEN, OTHER. These are from the PresenceSession class in the instant messaging API. |
id (optional) scope (optional) |
getContactName |
Return the common name for the contact. |
id (optional) scope (optional) |
getContactUsername |
Returns the instant messaging user name for the contact. |
id (optional) scope (optional) |
getDateTime |
Returns the update time. |
format (required) id (optional) scope (optional) |
isSecureMode |
Returns boolean indicating whether the channel is being accessed through the Secure Remote Access Gateway component and the Netlet is loaded. |
id (optional) scope (optional) |
getCodebase |
Returns the codebase to use to download the applet. This takes into account whether the channel is being accessed via the Secure Remote Access Gateway component and the Netlet is loaded. |
id (optional) scope (optional) |
getIMServer |
Returns the -server argument to pass to the IM client. This takes into account whether the channel is being accessed via the Secure Remote Access Gateway component and the Netlet is loaded. |
id (optional) scope (optional) |
The entire interface to the Instant Messaging server APIs is in the getContactGroup tag. This tag will fetch all of the presence information and cache it in the request. The remaining tags will simply fetch the information out of the cache.