Cisco Jabber for Windows Features...Cisco Jabber for Windows Features Chat History in Microsoft Outlook Procedure Step 1 Inthejabber-config.xmlfile,configuretheExchange_UseCredentialsFromparameter

Cisco Jabber for Windows Features

• Custom Emoticons, page 1

• Browser Click to Call , page 5

• Problem Reporting, page 6

• My Jabber Chats and My Jabber Files Directory Location, page 6

• IBM Notes Contact Search and Calendar Integration, page 7

• Integration with Microsoft Products, page 7

Custom EmoticonsApplies to: Cisco Jabber for Windows

You can add custom emoticons to Cisco Jabber for Windows by creating emoticon definitions in an XMLfile and saving it to the file system.

To achieve optimal results, your custom emoticons should conform to the following guidelines:Note

• Dimensions: 17 x 17 pixels

• Transparent background

• PNG file format

• RGB colors

Procedure

Step 1 Create a file named emoticonDefs.xml with any text editor.Step 2 Specify the emoticon definitions as appropriate in emoticonDefs.xml.

See Emoticon Definitions for more information on the structure and available parameters foremoticonDefs.xml.

Features and Options for Cisco Jabber 11.5 1

Step 3 Save and close emoticonDefs.xml.Step 4 Save emoticonDefs.xml in the appropriate directory on the file system.

Cisco Jabber for Windows loads emoticon definitions from the following directories on the file system.

• The directory can differ depending on your operating system

◦For 32-bit operating systems:

◦Program Files\Cisco Systems\Cisco Jabber\Emoticons

◦Program Files\Cisco Systems\Cisco Jabber\CustomEmoticons

◦For 64-bit operating systems:

◦Program Files(x86)\Cisco Systems\Cisco Jabber\Emoticons

◦Program Files(x86)\Cisco Systems\Cisco Jabber\CustomEmoticons

The Emoticons folder contains the default emoticons for Cisco Jabber for Windows and the defaultemoticonDefs.xml.

The CustomEmoticons folder does not exist by default. Administrators can create this folder tocontain custom emoticon definitions to include in organizational deployments.

Emoticons that you define in the CustomEmoticons folder take precedence over emoticon definitionsin the default Emoticons folder.

• %USERPROFILE%\AppData\Roaming\Cisco\UnifiedCommunications\Jabber\CSF\CustomEmoticons

This folder contains custom emoticon definitions for individual instances of Cisco Jabber for Windows.

Emoticons that you define in this directory take precedence over emoticon definitions in theCustomEmoticons folder in the installation directory.

Step 5 Restart Cisco Jabber for Windows.

Cisco Jabber for Windows loads the custom emoticon definitions in emoticonDefs.xml.

Custom emoticon definitions are available to users only if they are defined locally inemoticonDefs.xml. If you send custom emoticons to users who do not have the same emoticondefinitions, those users receive the default keys, not the icons; for example:

Remember

1 User A defines a custom emoticon in emoticonDefs.xml.

The custom emoticon definition exists only on User A's local file system.

2 User A sends that custom emoticon to User B.

3 User B receives only the default key for the custom emoticon. User B does not receive the icon.

Features and Options for Cisco Jabber 11.52

Cisco Jabber for Windows FeaturesCustom Emoticons

Emoticon DefinitionsCisco Jabber for Windows loads emoticon definitions from emoticonDefs.xml.

The following XML snippet shows the basic structure for the emoticon definitions file:<emoticons><emoticon defaultKey="" image="" text="" order="" hidden=""><alt></alt></emoticon></emoticons>

The following table describes the elements and attributes for defining custom emoticons:DescriptionElement or attribute

This element contains all emoticon definitions.emoticons

This element contains the definition of an emoticon.emoticon

This attribute defines the default key combination that renders theemoticon.

Specify any key combination as the value.

This attribute is required.

defaultKey is an attribute of the emoticon element.

defaultKey

This attribute specifies the filename of the emoticon image.

Specify the filename of the emoticon as the value. The emoticon imagemust exist in the same directory as emoticonDefs.xml.

This attribute is required.

Cisco Jabber for Windows supports any icon that Internet Explorer canrender, including .jpeg, .png, and .gif.

image is an attribute of the emoticon element.

image

This attribute defines the descriptive text that displays in the Insertemoticon dialog box.

Specify any string of unicode characters.

This attribute is optional.

text is an attribute of the emoticon element.

text

This attribute defines the order in which emoticons display in the Insertemoticon dialog box.

Specify an ordinal number beginning from 1 as the value.

order is an attribute of the emoticon element.

This attribute is required. However, if the value of hidden is true thisparameter does not take effect.

order


Cisco Jabber for Windows FeaturesEmoticon Definitions

DescriptionElement or attribute

This attribute specifies whether the emoticon displays in the Insertemoticon dialog box.

Specify one of the following as the value:

true

Specifies the emoticon does not display in the Insert emoticondialog box. Users must enter the key combination to render theemoticon.

false

Specifies the emoticon displays in the Insert emoticon dialog box.Users can select the emoticon from the Insert emoticon dialogbox or enter the key combination to render the emoticon. This isthe default value.

This attribute is optional.

hidden is an attribute of the emoticon element.

hidden

This element enables you to map key combinations to emoticons.

Specify any key combination as the value.

For example, if the value of defaultKey is :), you can specify :-) as thevalue of alt so that both key combinations render the same emoticon.

This element is optional.

alt

The default emoticons definitions file contains the following key combinations that enable users to requestcalls from other users:

Remember

• :callme

• :telephone

These key combinations send the callme emoticon, or communicon. Users who receive this emoticon canclick the icon to initiate an audio call. You should include these key combinations in any custom emoticonsdefinition file to enable the callme emoticon.

Emoticon Definition Example<emoticons><emoticon defaultKey=":)" image="Emoticons_Smiling.png" text="Smile" order="1"><alt>:-)</alt><alt>^_^</alt></emoticon><emoticon defaultKey=":(" image="Emoticons_Frowning.png" text="Frown" order="2"><alt>:-(</alt></emoticon></emoticons>


Cisco Jabber for Windows FeaturesEmoticon Definitions

Browser Click to CallApplies to: Cisco Jabber for Windows

With Browser Click to Call, users can start a call from any of the following browsers:

• Internet Explorer, from version 9

• Mozilla Firefox, from version 38.0a1

• Google Chrome, from version 45

Users can highlight and right-click on any number, URI, or alphanumerical string and choose one of thefollowing options:

• Call—Spaces and punctuation are stripped and the call is started.

• Call with Edit—Spaces and punctuation are stripped and the number is displayed in the Search box ofthe hub window. Users can edit the number before starting the call.

Browser Click to Call is enabledwith the CLICK2X installation parameter. If this parameter is set to ENABLED(default value), the feature is enabled. To disable this feature, you must set the CLICK2X installation parameterto DISABLE. For more information about the CLICK2X parameter, see the Deployment Guide for yourrelease.

Click to Call from Google ChromeClick to Call from the Google Chrome browser requires user input before it can be enabled. After users installand sign into Cisco Jabber, they must restart the Google Chrome browser. When the browser opens, a popupdisplays requesting users to allow installation of the “Jabber Call” extension. Users must allow the installationby clicking Enable Extension. The extension is installed and users can now make calls by highlighting andright-clicking on any phone number that is displayed in the browser.

If users do not have administrator privleges for their machine, they do not receive the popup requesting themto allow installation of the “Jabber Call” extension. In this case, users must contact their system administratorto install the extension.

Click to Call from Mozilla FirefoxClick to Call from the Mozilla Firefox browser requires user input before it can be enabled. After users installCisco Jabber, they must restart the Firefox browser. When the browser opens, a popup displays requestingusers to allow installation of the “JabberCallAddOn” add-on. Users must allow the installation by clickingAllow this installation and Continue. The add-on is installed and users can now make calls by highlightingand right-clicking on any phone number that is displayed in the browser.

Click to Call from Internet ExplorerClick to Call from the Internet Explorer browser does not require any user permissions or installations.


Cisco Jabber for Windows FeaturesBrowser Click to Call

Problem ReportingApplies to: Cisco Jabber for Windows

Setting up problem reporting enables users to send a summary of issues that they encounter with the client.There are two methods for submitting problem reports as follows:

• Users submit the problem report directly through the client interface.

• Users save the problem report locally and then upload it at a later time.

The client uses an HTTP POST method to submit problem reports. Create a custom script to accept the POSTrequest and specify the URL of the script on your HTTP server as a configuration parameter. Because userscan save problem reports locally, you should also create an HTML page with a form to enable users to uploadproblem reports.

Before You Begin

Complete the following steps to prepare your environment:

1 Install and configure an HTTP server.2 Create a custom script to accept the HTTP POST request.3 Create an HTML page that enables users to upload problem reports that are saved locally. Your HTML

page should contain a form that accepts the problem report saved as a .ZIP archive and contains an actionto post the problem report using your custom script.

The following is an example form that accepts problem reports:<form name="uploadPrt" action="http://server_name.com/scripts/UploadPrt.php" method="post"enctype="multipart/form-data"><input type="file" name="zipFileName" id="zipFileName" /><br /><input type="submit" name="submitBtn" id="submitBtn" value="Upload File" /></form>

Procedure

Step 1 Host your custom script on your HTTP server.Step 2 Specify the URL of your script as the value of the PrtLogServerUrl parameter in your configuration file.

My Jabber Chats and My Jabber Files Directory LocationApplies to: Cisco Jabber for Windows

If instant messages and file transfers are automatically saved each time a user closes a conversation (with theEnableAutosave parameter), the default location for these files is the Documents folder. Chats are saved in afolder called MyJabberChats and files are saved in a folder called MyJabberFiles.

However, you can specify a different location with the AutosaveChatsLocation parameter or let users choosetheir own location with the AllowUserSelectChatsFileDirectory parameter. If users are allowed to set theirown directory location, then the user setting takes priority over the system-defined setting. For more informationabout these parameters, see the Parameters Reference Guide for your release.


Cisco Jabber for Windows FeaturesProblem Reporting

IBM Notes Contact Search and Calendar IntegrationApplies to: Cisco Jabber for Windows

Cisco Jabber for Windows supports IBM Notes calendar integration in the Meetings tab of the client. CiscoJabber also lets users search for and add local contacts from IBM Notes. To enable this integration with IBMNotes, you must set the following parameters:

• EnableLocalAddressBookSearch=true

• EnableLotusNotesContactResolution=true

• CalendarIntegrationType=2

The CalendarIntegrationType parameter can be overridden by users. To enable calendar integration and contactresolution with IBM Notes, users must ensure that the Calendar integration type on the Calendar tab of theOptions window is set to IBM Notes.

In order for users to be able to successfully add IBM Notes contacts to their contact lists, the MessagingID field in IBM Notes must contain a valid value.

Note

Contact Resolution for Incoming Calls

For incoming calls, Cisco Jabber for Windows does not search the address book in IBMNotes, therefore onlythe phone number for an IBM Notes contact shows in the call history. If Cisco Jabber users subsequentlysearch for the contact associated with the phone number, the call history changes to show the contact's nameinstead of the phone number.

Integration with Microsoft ProductsApplies to: Cisco Jabber for Desktop Clients

Cisco Jabber for Windows supports a range of Microsoft products that integrate with the application. Thissection describes the support and integrations for these products.

Internet Explorer

Microsoft Internet Explorer 8 or later is required. Cisco Jabber for Windows uses the Internet Explorerrendering engine to display HTML content.

Cisco Jabber for Windows requires Internet Explorer active scripting to render IMs. See https://windows.microsoft.com/en-US/windows/help/genuine/ie-active-script for instructions on enabling activescripting.

Internet Explorer 9 users in Cloud-based deployments that use Single Sign On (SSO) get security alertswhen they sign in to Cisco Jabber for Windows. Add webexconnect.com to the list of websites in theCompatibility View Settings window of Internet Explorer 9 to stop these alerts.

Note


Cisco Jabber for Windows FeaturesIBM Notes Contact Search and Calendar Integration

https://windows.microsoft.com/en-US/windows/help/genuine/ie-active-script

https://windows.microsoft.com/en-US/windows/help/genuine/ie-active-script

Office

Integration with the following versions of Office is supported:

• Microsoft Office 2016, 32 and 64 bit



Office 365

Microsoft Office 365 supports different configuration types based on the plan or subscription type. CiscoJabber for Windows has been tested with small business plan P1 of Microsoft Office 365. This plan requiresan on-premises Active Directory server.

Client-side integration with Microsoft Office 365 is supported with the following applications:

• Microsoft Office 2016, 32 bit and 64 bit



• Microsoft SharePoint 2010

SharePoint

Integration with the following versions of SharePoint is supported:



Availability status in Microsoft SharePoint sites is supported only if users access those sites with MicrosoftInternet Explorer. You should add theMicrosoft SharePoint site to the list of trusted sites in Microsoft InternetExplorer.

Calendar IntegrationYou can use the following client applications for calendar integration:

• Microsoft Outlook 2016, 32 bit and 64 bit



• IBM Lotus Notes 9, 32 bit

• IBM Lotus Notes 8.5.3, 32 bit



• Google Calendar


Cisco Jabber for Windows FeaturesCalendar Integration

Microsoft Outlook Calendar EventsApplies to: Cisco Jabber for Windows

You must apply a setting in Microsoft Outlook so that calendar events display in Cisco Jabber for Windows.

Procedure

Step 1 Open the email account settings in Microsoft Outlook, as in the following example:a) Select File > Account Settings.b) Select the Email tab on the Account Settings window.

Step 2 Double-click the server name.In most cases, the server name isMicrosoft Exchange.

Step 3 Select the Use Cached Exchange Mode checkbox.Step 4 Apply the setting and then restart Microsoft Outlook.

When users create calendar events in Microsoft Outlook, those events display in theMeetings tab.

Microsoft Outlook Presence IntegrationApplies to: Cisco Jabber for Desktop Clients

To enable integration with Microsoft Outlook, you must specify SIP:user@cupdomain as the value ofthe proxyAddresses attribute inMicrosoft Active Directory. Users can then share availability inMicrosoftOutlook.

Use one of the following methods to modify the proxyAddresses attribute:

• An Active Directory administrative tool such as Active Directory User and Computers

The Active Directory User and Computers administrative tool allows you to edit attributes on MicrosoftWindows Server 2008 or later.

• ADSchemaWizard.exe utility

The ADSchemaWizard.exe utility is available in the Cisco Jabber administration package. This utilitygenerates an LDIF file that modifies your directory to add the proxyAddresses attribute to eachuser with the following value: SIP:user@cupdomain.

You should use the ADSchemaWizard.exe utility on servers that do not support the edit attribute featurein the Active Directory User and Computers administrative tool. You can use a tool such as ADSI Editto verify the changes that you apply with the ADSchemaWizard.exe utility.

The ADSchemaWizard.exe utility requires Microsoft .NET Framework version 3.5 or later.

• Create a script with Microsoft Windows PowerShell

Refer to the appropriate Microsoft documentation for creating a script to enable presence in MicrosoftOutlook.


Cisco Jabber for Windows FeaturesMicrosoft Outlook Calendar Events

Enable Presence with the Active Directory User and Computers ToolComplete the following steps to enable presence in Microsoft Outlook for individual users with the ActiveDirectory User and Computers administrative tool:

Procedure

Step 1 Start the Active Directory User and Computers administrative tool.You must have administrator permissions to run the Active Directory User and Computers administrativetool.

Step 2 Select View in the menu bar and then select the Advanced Features option from the drop-down list.Step 3 Navigate to the appropriate user in the Active Directory User and Computers administrative tool.Step 4 Double click the user to open the Properties dialog box.Step 5 Select the Attribute Editor tab.Step 6 Locate and select the proxyAddresses attribute in the Attributes list box.Step 7 Select Edit to open theMulti-valued String Editor dialog box.Step 8 In the Value to add text box, specify the following value: SIP:user@cupdomain.

For example, SIP:[email protected].

Where the user@cupdomain value is the user's instant messaging address. cupdomain corresponds tothe domain for Cisco Unified Presence or Cisco Unified Communications Manager IM and Presence Service.

Add Local Contacts from Microsoft OutlookCisco Jabber for Windows lets users search for and add local contacts in Microsoft Outlook.

All local contacts in Microsoft Outlook must have instant message addresses and phone numbers. Thesedetails allow client users to do the following:

• add local Microsoft Outlook contact to their contact lists

• see contact photos from the client

• send instant messages to local contacts

• call local contacts from the client

Administrator Tasks

To enable this integration with Microsoft Outlook, you must enable Cached ExchangeMode on the MicrosoftExchange server.

To allow users to search for local contacts in Microsoft Outlook from the client, users must have profiles setin Microsoft Outlook.

User Tasks

Users must set the correct calendar preference on the client.


Cisco Jabber for Windows FeaturesMicrosoft Outlook Presence Integration

1 Select File > Options.

2 Select the Calendar tab.

3 SelectMicrosoft Outlook.

4 Restart Cisco Jabber to apply the change.

Chat History in Microsoft OutlookApplies to: Cisco Jabber for Windows

This feature is available in the following versions of the client:Supported ServersVersion of Cisco Jabber for

Windows

Microsoft Exchange 2013


10.6

Microsoft Office 365



11.0

You can enable the client to automatically save chat histories to a Cisco Jabber Chats folder in the user'sMicrosoft Outlook application. When a user closes a chat window, the client saves the IM conversation tothe Exchange server.

To enable the feature, you must:

1 Set the EnableSaveChatHistoryToExchange parameter to true in the jabber-config.xml file.

2 (optional) Set up amethod to authenticate users to the Exchange server. If you don't specify an authenticationmethod, then users can authenticate directly from the Outlook tab in the Options menu of their clients.

3 Specify the method for determining which server to use.

For more information about all of the parameters that are needed to enable this feature, see the ParametersReference Guide.

Limitations for Saving Chat History to an Outlook FolderThis feature can only be enabled if users have a Cisco Unified Communications Manager account.

Limitations with Authentication Methods over Cisco Expressway for Mobile and Remote Access

If you are enabling this feature for users connecting via the Expressway for Mobile and Remote Access, thefollowing limitations apply:

• If the client detects that the user is connecting via the Expressway, then the client uses the ExternalServer option for the Exchange connection. If the external server is not set, then it uses the internalserver.


Cisco Jabber for Windows FeaturesChat History in Microsoft Outlook

• If the client detects that the user is not connecting via the Expressway, then the client uses the InternalServer option for the Exchange connection. If the internal server is not set, the client uses the externalserver.

• However, if either the internal or external server is set, but for some reason Cisco Jabber can't connectto it, the client doesn't revert to using the other server.

Authentication ModesYou must set up a method of authentication for the client to authenticate with the Exchange server. Whenauthentication is complete, the client has access to the Exchange server which allows saving chat histories toa folder in Outlook.

If you do not specify an authentication method, then users must manually input their Exchange credentials inthe Outlook tab in the client.

Authenticate Using Single Sign On for the Operating System

Applies to Cisco Jabber for Windows only.

The client uses the account details of the logged in user to authenticate with the Exchange server. Thisauthentication method uses the Windows NT Lan Manager (NTLM) security protocol.

Do not use this authentication method if some users share the same Windows account. The clientauthenticates with the account on the Operating System, and not with the user who is logged in to CiscoJabber. For example, User A logs onto a Windows machine and then logs into Cisco Jabber for a morningshift. When the shift is done, Jabber is reset and User B logs into the client for the afternoon shift. BecauseUser A is logged into the Windows account, then the chat messages from User B are saved in the Outlookaccount for User A.

Note

Before You Begin

Users and their computers must use domains. Authentication using single sign on does not work if users arelocal Windows users.

Procedure

In the jabber-config.xml file, set the ExchangeAuthenticateWithSystemAccount parameter to true.

Authenticate by Synching Credentials

You can sync the Exchange credentials with another set of credentials for users, such as the Cisco UnifiedCommunications Manager IM and Presence credentials. Using this method, the client uses the credentials toauthenticate to the Exchange server.



Procedure

Step 1 In the jabber-config.xml file, configure the Exchange_UseCredentialsFrom parameter.Step 2 Define the value of the parameter as the service that you want used to sync credentials. For example,

<Exchange_UseCredentialsFrom>CUCM</Exchange_UseCredentialsFrom>.In this example, Cisco Unified CommunicationsManager is defined as the service which provides the Exchangeserver with credentials for authentication.

Specify Server AddressesAfter you enable an authentication method for the client to access the Exchange server, you must enable amethod for the client to specify the Exchange server address.

If you do not specify server addresses, then users must manually enter the internal and external Exchangeservers in the client, in the Outlook > Advanced tab of the Options menu.

Detect Server Addresses Automatically

Applies to Cisco Jabber for Windows only.

You can configure the client to automatically discover the Exchange servers based on users' domain. Thisdomain is defined when you set up the authentication method by using the domain that was specified for theuser's credentials.

Procedure

Step 1 In the jabber-config.xml file, configure the ExchangeAutodiscoverDomain parameter.Step 2 Define the value of the parameter as the domain to discover the Exchange server.

The client uses the domain to search for the Exchange server at one of the following Web addresses:https://<domain>/autodiscover/autodiscover.svc

https://autodiscover.<domain>/autodiscover/autodiscover.svc

Define Server Addresses

You can define the internal and external Exchange server addresses in the configuration file.

Procedure

Step 1 In the jabber-config.xml file, configure the InternalExchangeServer and ExternalExchangeServerparameters.

Step 2 Define the value of the parameters using the Exchange server addresses.



