® Sametime Connect client and the Sametime embedded client for Lotus Notes
® include plug-ins that can be enabled to support Sametime
® Unified Telephony features.
- Sametime Unified Telephony plug-ins
These plug-ins provide access to Sametime Unified Telephony features for users who have access to an Sametime Unified Telephony infrastructure and are provisioned to use it. In previous releases, the Sametime Unified Telephony client plug-ins were provided as a client add-on in the Sametime Unified Telephony product, and were installed using an add-on installer or update site.
This plug-in provides the ability to display custom live name status icons. This is typically used to display telephony status icons, but this mechanism can be used to display any custom status icons. This plug-in first appeared in Sametime 7.5.1, and prior to Sametime 8.5.1, this plug-in was only available in the Sametime SDK and as part of the Sametime Unified Telephony client add-on.
This plug-in, which was added for Sametime 8.0, makes use of the extended status plug-in to display telephony status icons for live names. This plug-in is used in conjunction with the Sametime Telephony Presence Adapter server component, which integrates the Sametime server with Sametime Unified Telephony and third-party telephony presence systems. The Sametime server obtains telephony status from the Telephony Presence Adapter and publishes status changes via Sametime user attributes. The telephony status plug-in responds to telephony status user attributes by displaying the appropriate telephony status icon next to the Sametime presence icon. Like the extended status plug-in, the telephony status plug-in was only available in the Sametime SDK and Sametime Unified Telephony client add-on in previous releases.
The remainder of this topic describes how the Sametime
Unified Telephony, extended status, and telephony status plug-ins are enabled or disabled in the Sametime Connect 8.5.1 client. Since the different plug-ins are somewhat dependent on one another, it's important for both administrators and third-party developers to understand how to enable or disable them and the impact of doing so.
New client preferences
A number of different options were considered that would allow administrators to enable or disable the Sametime
Unified Telephony, extended status, and telephony status plug-ins. The two best options were client preferences and new policies, because either one could be applied to specific users and groups, but client preferences were chosen. Unlike policies, client preferences can be used to prevent plug-ins from loading at startup if the plug-ins will not be used, improving startup time, and client preferences can be used with older Sametime
This section describes the new client preferences, which are listed below. The default value in all cases is false, which means the corresponding feature is disabled. To enable a feature, set the preference value to true. To disable the feature after enabling it, set the preference to false again.
Set this preference to true to enable Sametime Unified Telephony features in the client. Once enabled, the client will only be able to make use of Sametime Unified Telephony telephony service (and Sametime audio/video service), so don't enable this preference for users who are not provisioned to use Sametime Unified Telephony, since that will prevent them from getting access to other telephony services. When this preference is enabled (true), both telephony status and extended status are used, regardless of the values of the other preferences.
Set this preference to true to enable the display of telephony presence status icons for live names on the contact list or elsewhere. This is used for telephony presence published using the Sametime Telephony Presence Adapter, used by both Sametime Unified Telephony and third-party telephony presence solutions. Enabling telephony status also enables extended status. It is not necessary to enable both preferences. In environments that include both Sametime Unified Telephony and non-Sametime Unified Telephony users, this preference can be enabled for the non-Sametime Unified Telephony users, to allow them to see telephony status for Sametime Unified Telephony users.
Set this preference to true to enable the use of non-telephony extended status icons for live names on the contact list or elsewhere. Although extended status icons are most often used for telephony presence status, some third-party applications use extended status icons for other purposes. To display telephony status icons for applications that use the Sametime Telephony Presence Adapter, enable telephony status rather than this preference.
Set this preference to true to enable the Call Computer action on the call menu and livename context menu. The Call Computer action starts a computer audio (voice chat) call using Sametime Audio/Video Conferencing, regardless of the selected preferred device and service provider preference. This action is primarily intended for Sametime Unified Telephony users, but can be enabled for any user.
The following table summarizes how these preferences affect extended status icons and telephony status:
Table 1. Extended status icons and telephony status
|enableExtendedStatus ||enableTelephonyStatus ||enableSUT ||Extended status icons displayed ||Telephony status displayed|
|any value||any value||true||yes||yes|
|any value||true||any value||yes||yes|
Modifying client preferences
Sametime provides different options for administrators to change client preferences, without requiring any action from end users. Any of these options can be used to modify the three client preferences described previously, however, IBM
recommends the managed preferences mechanism is for changing these and other client preferences. Here's an overview of the managed preferences mechanism:
- It was first supported by the Sametime Connect 8.5 client, but does not require a Sametime 8.5 server.
- You place a file named managed-settings.xml (example follows) on your server at the location specified by the administration update site URL. This is the same URL that specifies where the client looks for updated features posted by the administrator, which are automatically installed. This URL is specified by a Sametime user policy, so a different URL can be used for different users and groups.
- Sametime Connect 8.5 and later clients use the administration update site URL to look for updated features, but also look for a managed-settings.xml file at that location. If found, the managed-settings.xml settings are read and processed by the client.
- Older clients use the administration update site URL to look for updated features, but ignore any managed-settings.xml file at that location.
This is the format of the managed-settings.xml
file used to enable or disable the three preferences described in this topic, with the default values:
<setting name="enableSUT" value="false"/>
<setting name="enableTelephonyStatus" value="false"/>
<setting name="enableExtendedStatus" value="false"/>
For more information on using managed settings, see Configuring client preferences with the Expeditor managed settings framework
Unlike other client preferences, changes to the three preferences described here do not take effect until the client is restarted. Because the end user is unaware of preference changes made using the managed preferences mechanism, a dialog box with the following message appears if changes are detected to any of the three preferences:
Sametime has detected a configuration change from the administrator and needs to restart.
From the dialog, the user can choose to restart the client.
Parent topic: Enabling client features after installation