In Communicator 2007 R2, the procedure for configuring context-sensitive custom tabs has been modified in the following ways:
<client>
This topic discusses configuring context-sensitive tabs in more detail.
You can extend the Office Communicator 2007 R2 user interface by adding pages of Web-based content to the Office Communicator window. The pages appear in a pane just below the Contact List, and the user switches between pages by clicking tabs at the bottom of the pane. Custom tabs are particularly powerful because they enable Office Communicator to pass the URI of the current user to the tab defined in the Office Communicator window.
In Communicator 2007 R2, you can now also add tabs to the contact card. The tabs appear at the bottom of the contact card, and clicking a tab opens a browser window with the defined page. The URI of the contact displayed in the contact card can be passed to the page defined in the custom tab.
The process for displaying a custom tab in Office Communicator consists of the following steps:
A registry string value, TabURL, contains a URL that points to the XML descriptor file. TabURL can be added to the following registry keys.
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Communicator
HKEY_CURRENT_USER\Software\Policies\Microsoft\Communicator
The TabURL setting can be added to either section of the registry. However, settings in the HKEY_LOCAL_MACHINE\SOFTWARE section take precedence.
Office Communicator 2007 R2 uses an XML tab definition file to define the displayed tabs and the address of the each tab’s main page. The tab definition file has the following format:
<?xml version="1.0" ?> <tabdata> <tab> <image>https://site/image.png</image> <name>Tab title</name> <tooltip>Tooltip text</tooltip> <contenturl> http://site/content</contenturl> <userid>true</userid> <contactid>true</contactid> <accessibility>inside</accessibility> <client> <communicatorWebAccess>true</communicatorWebAccess> </client> </tab> </tabdata>
!ELEMENT tabdata tab*
Contains 0 or more tab elements. The maximum number of tab elements is 32.
No
!ELEMENT tab (image, name, tooltip, contenturl, userid, contactid, accessibility, client)
Contains image, name, tooltip, contenturl, userid, contactid, and accessibility elements.
!ELEMENT image %URI
Provides a URL for the tab image icon. The image must be in PNG format.
!ELEMENT name (#PCDATA)
A friendly name for the XML node. This is not displayed in the user interface.
Yes
!ELEMENT tooltip (#PCDATA)
Displays the text of the tooltip when the mouse pauses over the tab.
!ELEMENT contenturl %URI
Provides the URI of the page to be displayed when the user selects the tab. The file must be located on the intranet, or on a secure or trusted site on the internet. The link must be in https:// format (recommended), or in http:// or file:/// format.
!ELEMENT userid (“true” | “false”)
Determines whether Communicator will pass the user’s Session Initiation Protocol (SIP) account ID information to the tab URL. The default value is “false.”
!ELEMENT contactid (“true” | “false”)
Determines whether the tab appears in the contact card. Tabs defined without contactid or with contactid=false will appear only in the Communicator window. Tabs defined with contactid=true will appear in the contact card, and Communicator will pass the selected contact to the defined page. The default value is “false.”
!ELEMENT accessibility (“inside” | “outside” | “both”)
Determines whether the URL must be displayed when the user logs in from inside the enterprise, outside the enterprise, or both. This is provided so that Communicator 2007 R2 does not attempt to display intranet pages when the user logs in from outside the company, resulting in a “page not found” error.
!ELEMENT client (communicatorWebAccess)
Specifies the clients that should display the tab, in addition to Office Communicator.
!ELEMENT communicatorWebAccess (“true” | “false”)
Specifies that Communicator Web Access clients should display the tab.
The following example shows a tab definition file with two tabs.
<?xml version="1.0" ?> <tabdata> <tab> <image>https://site/news.png</image> <name> News</name> <tooltip>Technology News</tooltip> <contenturl>http://www.contoso.com/news</contenturl> <userid>true</userid> <contactid>true</contactid> <accessibility>inside</accessibility> <client> <communicatorWebAccess>true</communicatorWebAccess> </client> </tab> <tab> <image>https://site/sports.png</image> <name>Sports</name> <tooltip>Sports News</tooltip> <contenturl>http://www.contoso.com/sports</contenturl> <userid>true</userid> <contactid>true</contactid> <accessibility>inside</accessibility> <client> <communicatorWebAccess>true</communicatorWebAccess> </client> </tab> </tabdata>