Zebra Workforce Connect: Voice Client Workforce Connect Voice Client 8.2.x Administrator Guide for IP Office

Download

WORKFORCE CONNECT

Voice Client 8.2.x

Administrator Guide

for Avaya IP Office v9

MN-001359-08EN

Copyright

ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners. ©2019 Zebra Technologies Corporation and/or its affiliates. All rights reserved.

COPYRIGHTS & TRADEMARKS: For complete copyright and trademark information, go to www.zebra.com/ copyright.

WARRANTY: For complete warranty information, go to www.zebra.com/warranty.

END USER LICENSE AGREEMENT: For complete EULA information, go to www.zebra.com/eula.

Terms of Use

• Proprietary Statement

This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the express, written permission of Zebra Technologies.

• Product Improvements

Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are subject to change without notice.

• Liability Disclaimer

Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.

• Limitation of Liability

In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever (including, without limitation, consequential damages including loss of business profits, business interruption, or loss of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.

Revision History

Changes to the original guide are listed below:

Change Date Description

-01 Rev A 1/2017 Initial release.

-02 Rev A 7/2017 Update to Voice Client 8.2.x.

-03 Rev A 9/2017 Update licensing information.

Change Date Description

-04 Rev A 12/2017 Add information on configuring multiple PBXs, WiFi Preferred, importing contacts.

-05 Rev A 3/2018 Add information on TCP/UDP port usage.

-06 Rev A 5/2019 Updating features for most recent release of the client.

-07 Rev A 7/2019 Updates to custom ringtone and audio prompt file formats. Update to Home Screen Dashboard section.

-08EN Rev A5/2020 Ringtone option added to main menu. Sign out and reload are now separate options in main menu. When selecting ringtone from SD card, option should read Custom Ringtones.

Copyright ............................................................................................................................................ i

Terms of Use ..................................................................................................................................... i

Revision History ................................................................................................................................. i

About This Guide

Introduction ....................................................................................................................................... 8

PBX Integration Statement ............................................................................................................... 8

Chapter Descriptions 9

Notational Conventions ................................................................................................................... 10

Related Documents and Software .................................................................................................. 10

Service Information ......................................................................................................................... 10

Configuring the Client

Introduction ....................................................................................................................................... 1

Determine Deployment Readiness ................................................................................................... 1

Connect Android Wireless Device to Network .................................................................................. 1

Install Workforce Connect Voice Client ............................................................................................. 2

Download and Install Board Support Package (BSP) Operating System ................................... 2

Download and Install Android Application Packager (APK) Client .............................................. 2

Installing the APK Manually .................................................................................................. 2

Installing the APK Using ADB Commands ............................................................................ 2

Create a Shortcut for the Workforce Connect Voice Client ......................................................... 2

Open Workforce Connect Voice Client ............................................................................................. 3

Activate Workforce Connect Voice Client ......................................................................................... 4

Activate Using an Activation Key ................................................................................................ 4

Activate Using an MDM ............................................................................................................... 6

MDM Deployment ................................................................................................................. 6

Activate Using a USB Tether ...................................................................................................... 6

Update License ........................................................................................................................... 6

Configure Workforce Connect Voice Client ...................................................................................... 6

Configure Using the WFC Voice Client GUI ................................................................................ 7

Configure Using an MDM ............................................................................................................ 9

MDM Deployment ................................................................................................................. 9

Configure Using a USB Tether .................................................................................................... 9

Table of Contents

Configuring the PBX

Introduction ..................................................................................................................................... 10

Collect Necessary Information .................................................................................................. 10

Open the Avaya IP Office Web Manager .................................................................................. 10

Add New SIP User .................................................................................................................... 11

Add User Credentials ................................................................................................................ 11

Setup Extension (If not already configured) .............................................................................. 12

Edit User Properties ........................................................................................................................ 13

Check Device Settings .................................................................................................................... 14

Dynamic Configuration

Introduction ..................................................................................................................................... 15

Overview ................................................................................................................................... 15

General Device Use Cases ............................................................................................................. 15

Device Start-Up ............................................................................................................................... 16

Device Identification ........................................................................................................................ 16

Profile Configuration ....................................................................................................................... 17

Connection Attributes ................................................................................................................ 17

Dynamic Configuration .................................................................................................................... 18

Enabling Dynamic Configuration ............................................................................................... 18

Wcfvariable.xml File ................................................................................................................. 18

XML File Location ..................................................................................................................... 19

DHCP Option 150 ..................................................................................................................... 20

Configuration Resynchronization .................................................................................................... 20

Dynamic Configuration Start-Up - Server Side ............................................................................... 21

Dynamic Configuration Start-Up - Client Side ................................................................................. 22

XML File Examples ......................................................................................................................... 23

Testing Remote Dynamic Configuration ......................................................................................... 24

Settings

Introduction ..................................................................................................................................... 26

Exiting WFC Voice Client: ......................................................................................................... 26

Reloading WFC Voice Client: .................................................................................................... 26

Profile Settings ................................................................................................................................ 27

Create Profile ............................................................................................................................ 27

Change Profile Name ................................................................................................................ 27

Shared Profiles URI .................................................................................................................. 27

Load New Profile ....................................................................................................................... 28

Loading a New Profile Using the GUI ................................................................................. 28

Loading a New Profile Using XML ...................................................................................... 28

Installing the APK Using ADB Commands .......................................................................... 28

Save Current Profile .................................................................................................................. 28

Edit a Profile Using XML ........................................................................................................... 29

Connection Parameters .................................................................................................................. 30

Configuring Multiple PBX Types ............................................................................................... 31

Audio Settings ................................................................................................................................. 32

Audio Codecs Priorities ............................................................................................................. 34

Jitter Buffer ................................................................................................................................ 35

Jitter Initial Delay ................................................................................................................. 35

Table of Contents

Jitter Buffer Max Buffer Size ............................................................................................... 35

RTP Parameters ....................................................................................................................... 36

Real-Time Transport Protocol (RTP) Parameters - Payload Size ....................................... 36

First Real-Time Transport Protocol (RTP) Port ................................................................... 36

Last Real-Time Transport Protocol (RTP) Port ................................................................... 36

Audio Enhancements ................................................................................................................ 37

Configuring Audio Enhancements ....................................................................................... 37

Input / Output Audio ............................................................................................................ 37

Audio Debugging Tools ....................................................................................................... 37

UI Settings ...................................................................................................................................... 39

Configuration File Sections ....................................................................................................... 39

Profile Section ..................................................................................................................... 39

Footer Section ..................................................................................................................... 39

Dashboard Section .............................................................................................................. 40

Call Buttons Section ............................................................................................................ 40

Headless Mode ......................................................................................................................... 40

Background Logo ...................................................................................................................... 41

Icon Library ......................................................................................................................... 41

Custom Background Configuration ..................................................................................... 41

Buttons Padding ........................................................................................................................ 41

Dialer Padding ........................................................................................................................... 42

Graphical User Interface Design Tool ....................................................................................... 42

Using the UI Settings GUI Design Tool ............................................................................... 43

Home Screen Dashboard .......................................................................................................... 45

In-Call Dashboard ..................................................................................................................... 45

Button Configuration ................................................................................................................. 46

Call ...................................................................................................................................... 46

Dial ...................................................................................................................................... 48

Start App ............................................................................................................................. 49

Log Marker .......................................................................................................................... 50

Speed Dial 0-9 .................................................................................................................... 51

Redial .................................................................................................................................. 52

Suspend Mode .................................................................................................................... 53

History ................................................................................................................................. 54

Contacts ......................................................

Favorites ............................................................................................................................. 56

Voicemail ............................................................................................................................. 57

Do Not Disturb ..................................................................................................................... 58

Follow Me ............................................................................................................................ 58

Add Call ............................................................................................................................... 60

Home ................................................................................................................................... 61

Hold ..................................................................................................................................... 62

Resume ............................................................................................................................... 63

Transfer ............................................................................................................................... 64

Conference .......................................................................................................................... 65

Complete ............................................................................................................................. 66

End Call ............................................................................................................................... 67

List ....................................................................................................................................... 68

Blank ................................................................................................................................... 71

Reload ................................................................................................................................. 72

........................................................................ 55

Table of Contents

Sign Out .............................................................................................................................. 73

Ringtone .............................................................................................................................. 74

Icons .......................................................................................................................................... 75

Icon Library ......................................................................................................................... 75

Custom Icon Configuration .................................................................................................. 75

Icon Scale Type .................................................................................................................. 76

Button Color .............................................................................................................................. 78

Button Background Color .................................................................................................... 78

Button Text Color ................................................................................................................ 79

Global Button Color Settings ..................................................................................................... 80

Global Button Background Color ......................................................................................... 80

Global Button Text Color ..................................................................................................... 81

Reset Colors to Default ............................................................................................................. 82

Restore Buttons ........................................................................................................................ 82

Call Settings .................................................................................................................................... 83

Call Waiting Volume .................................................................................................................. 84

Call Waiting Interval .................................................................................................................. 85

Ringer OFF In Charger ............................................................................................................. 85

Disable Speaker mode .............................................................................................................. 85

Speaker on table ....................................................................................................................... 86

Call Accept Style ....................................................................................................................... 87

Configure the Glow Pad Buttons ......................................................................................... 88

Auto Answer Mode .................................................................................................................... 89

Incoming Call Voice Announcer ................................................................................................ 89

No Audio Cutoff ......................................................................................................................... 89

Audio Prompt File ...................................................................................................................... 89

MOH Enabled ............................................................................................................................ 90

MOH File ................................................................................................................................... 90

Ringtones ........................................................................................................................................ 91

Line Ringtones .......................................................................................................................... 91

Miscellaneous Settings ................................................................................................................... 92

Sign OUT in Charger ................................................................................................................. 92

Setting Sign OUT in Charger .............................................................................................. 92

Flexible TLS .............................................................................................................................. 92

Setting Flexible TLS .........................................................................................................

WiFi Preferred ........................................................................................................................... 92

Setting WiFi Preferred ......................................................................................................... 93

Help URL ................................................................................................................................... 93

Setting Help URL ................................................................................................................ 93

Settings Password .................................................................................................................... 93

Additional Profile URI ................................................................................................................ 94

Setting Additional Profile URI .............................................................................................. 94

Contacts URL ............................................................................................................................ 94

Setting Contacts URL .......................................................................................................... 94

Sync Contacts ........................................................................................................................... 94

Creating a Contacts List ...................................................................................................... 94

Syncing Contacts ................................................................................................................ 95

... 92

Logging

Introduction ..................................................................................................................................... 96

Table of Contents

Logging Level .................................................................................................................................. 96

Setting Logging Level .......................................................................................................... 96

Logging Types ................................................................................................................................ 97

Logging to Console ................................................................................................................... 97

Logging to File ........................................................................................................................... 97

Logging to HTTP Post URL ....................................................................................................... 97

Log Files ......................................................................................................................................... 98

Workforce Connect Logs ........................................................................................................... 98

Fusion Logs ............................................................................................................................... 98

Collecting LogCat with RxLogger .................................................................................................... 98

Enabling RXLogger ................................................................................................................... 98

Log Marker .................................................................................................................................... 100

Adding a Log Marker ............................................................................................................... 100

Configuring Log Marker ........................................................................................................... 100

Fusion Logs .................................................................................................................................. 100

Enabling Fusion Settings In Android 6 or 7 ............................................................................. 101

Enabling Fusion Settings In Android 8 or Later ....................................................................... 101

Capturing the Logs ........................................................................................................................ 101

Headless Mode and WFCVoice Service

Introduction ................................................................................................................................... 102

Integrating WFCVoice Service Plug-in .......................................................................................... 103

Enabling Headless Mode .............................................................................................................. 103

Initiating a Call .............................................................................................................................. 103

Reporting App State ...................................................................................................................... 104

WFCDemo Android Project ........................................................................................................... 105

Using the Client

Introduction ................................................................................................................................... 108

Home Screen Dashboard ............................................................................................................. 110

In-Call Dashboard ......................................................................................................................... 110

Signal Quality ................................................................................................................................ 111

Calling ........................................................................................................................................... 111

Making a Call .......................................................................................................................... 111

Receiving a Call ...................................................................................................................... 113

Accept-Reject Buttons ....................................................................................................... 113

Sliding Tab ........................................................................................................................ 113

Glow Pad .....................................................................................................................

Popup Window .................................................................................................................. 113

End Call ................................................................................................................................... 114

Add Call ................................................................................................................................... 114

Call Hold and Resume ............................................................................................................ 117

Call Park and Unpark .............................................................................................................. 117

Call Park ............................................................................................................................ 117

Call Unpark ....................................................................................................................... 118

................................................................................................................................................ 118

Voicemail ...................................................................................................................................... 119

Message Waiting ..................................................................................................................... 119

Message Retrieval .................................................................................................................. 119

...... 113

Table of Contents

Contacts ........................................................................................................................................ 120

Favorites ....................................................................................................................................... 121

Call Log / Call History ................................................................................................................... 122

View Recent Calls ................................................................................................................... 122

Dial from Call History .............................................................................................................. 122

Delete Call History .................................................................................................................. 122

View Call History ..................................................................................................................... 122

Advanced Calling Features ........................................................................................................... 124

Multiple Lines .......................................................................................................................... 124

Multiple Line Appearances ................................................................................................ 124

Busy Indicator ................................................................................................................... 124

Transfer (attended, semi-attended) ......................................................................................... 125

Ad hoc Conference ................................................................................................................. 126

Call Forward ............................................................................................................................ 127

Miscellaneous Features ................................................................................................................ 132

Ringtone .................................................................................................................................. 132

Reload ..................................................................................................................................... 132

Sign Out .................................................................................................................................. 132

Speed Dial Numbers ............................................................................................................... 132

Do Not Disturb ......................................................................................................................... 132

Suspend Mode ........................................................................................................................ 134

List ........................................................................................................................................... 134

Home ....................................................................................................................................... 135

Adjusting the Ring Volume ...................................................................................................... 135

Unique Ringtone per Line Appearance ................................................................................... 135

Unique Ringtone per Contact .................................................................................................. 135

Distinctive Ringing ................................................................................................................... 135

Vibrate/Ring Tone ................................................................................................................... 135

Start Application ...................................................................................................................... 136

Log Marker .............................................................................................................................. 136

Adding a Log Marker ......................................................................................................... 136

Caller ID .................................................................................................................................. 136

Hold Recall .............................................................................................................................. 136

On-hook Dialing ...................................................................................................................... 136

Table of Contents

Button Actions

XML Tags

XML Example - Profile

XML Example - Footer

XML Example - Dashboard

XML Example - Call Buttons

Configuring a Proxy Server

Configuring a Proxy Server ........................................................................................................... 165

Network Ports and Protocols

Network Ports and Protocols ........................................................................................................ 166

About This Guide

Introduction

This manual describes how to install, configure and use Workforce Connect Voice Client on an Avaya IP Office network.

NOTE: Screens and windows pictured in this guide are samples and can differ from actual screens.

PBX Integration Statement

Avaya IPO configuration references contained within this document is based on Avaya IP Office version 9.0. Generally Avaya configuration elements are maintained in subsequent releases, however cannot be guaranteed. Reader is advised to consult Avaya IP Office configuration guide for releases above 9.0 and use in conjunction with this documentation.

NOTE: Workforce Connect Voice Client requires a minimum Avaya IP Office version 9.0.

Chapter Descriptions

Topics covered in this guide are as follows:

• Configuring the Client, describes the steps you need to take prior to beginning to configure the device.

• Configuring the PBX, describes the steps you need to take to configure Avaya IP Office.

• Dynamic Configuration, describes the procedures to dynamically configure the WFC client using an XML

variable file.

• Settings, provides detailed information on configuring settings.

• Logging, describes the process used to capture and collect WFC Voice Client log files and Fusion log files.

• Headless Mode and WFCVoice Service, describes the procedures to configure WFC Voice client as a

background service.

• Using the Client, explains how to use the functions and features of the WFC client.

• Button Actions, includes a table listing the XML tags used to define a button action.

• XML Tags, includes a table listing all XML tags used in the Workforce Connect Voice Client configuration

file and where they are valid.

• XML Example - Profile, provides an XML example for the Profile section.

About This Guide

• XML Example - Footer, provides an XML example for the Footer section.

• XML Example - Dashboard, provides an XML example for the Dashboard section.

• XML Example - Call Buttons, provides an XML example for the In-Call Buttons section.

• Configuring a Proxy Server, explains how to configure a proxy server.

• Network Ports and Protocols, provides an overview of the ports and protocols the WFC Voice Client uses

on supported Zebra devices.

Notational Conventions

The following conventions are used in this document:

• Bold text is used to highlight the following:

• Dialog box, window and screen names

• Drop-down list and list box names

• Check box and radio button names

• Icons on a screen

• Key names on a keypad

• Button names on a screen.

• Bullets (•) indicate:

• Action items

• Lists of alternatives

• Lists of required steps that are not necessarily sequential.

• Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.

About This Guide

Service Information

If you have a problem with your equipment, contact Zebra Global Customer Support for your region. Contact information is available at: www.zebra.com/support

When contacting support, please have the following information available:

• Serial number of the unit

• Model number or product name

• Software type and version number.

Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.

If your problem cannot be solved by Zebra Customer Support, you may need to return your equipment for servicing and will be given specific directions. Zebra is not responsible for any damages incurred during shipment if the approved shipping container is not used. Shipping the units improperly can possibly void the warranty.

If you purchased your Zebra business product from a Zebra business partner, contact that business partner for support.

Configuring the Client

Introduction

This chapter describes how to install, activate and configure the Workforce Connect Voice Client (WFC Voice Client).

Determine Deployment Readiness

Assess the suitability of your Wireless Local Area Network (WLAN) for voice traffic, using the Best Practices Guide: Deploying VoWLAN Over Aruba Wireless Networks, Deploying VoWLAN Over Cisco Wireless Networks or Deploying VoWLAN Over WiNG5 Wireless Networks.

WARNING: If your WLAN is not suitable for voice traffic, WFC Voice Client will perform on a best effort basis.

Contact the Zebra Software Support Desk for more information: www.zebra.com/support.

Connect Android Wireless Device to Network

Zebra WFC Voice Client for Android includes support for the following device types:

• Enterprise Mobile devices

• Consumer Smartphone devices (evaluation only).

Connect the Android wireless device to the network. See device instructions for more information. If you need assistance, contact the Zebra Support at: www.zebra.com/support

Configuring the Client

Install Workforce Connect Voice Client

There are two ways to install the WFC Voice Client:

• USB tether or web server - This section describes using a USB tether or web server to install the WFC

Voice Client APK manually or using ADB commands.

• Mobile Device Manager (MDM) - For information on installing the WFC Voice Client APK using an MDM,

refer to the Workforce Connect Voice Client Configuration Guide for Mobile Device Managers.

Download and Install Board Support Package (BSP) Operating System

For instructions please refer to www.zebra.com/support and login using your partner login for latest BSP and integration instructions. If you need assistance, contact Zebra Support at: www.zebra.com/support

Download and Install Android Application Packager (APK) Client

1. From a web browser, go to the Zebra Licensing End User Portal.

To access the Zebra Licensing End User Portal, follow the instructions in the Software Entitlement email from Zebra. Portal access requires registration at Zebra.com and authorization as a portal user by Zebra Support.

2. From the Zebra Licensing End User Portal, download the latest WFC Voice APK file.

Installing the APK Manually

To install the APK manually:

1. Save the APK file to the root directory of the target device using one of the following methods:

• USB tether

• Web server download (if your network supports this option).

2. On the Android device, go to the Apps list and open the file browser.

3. Navigate to the APK file.

4. Run and install the APK file.

5. Check that the WFC Voice Client is available in the Apps Screen.

The WF Connect icon should be visible in the list of available applications.

Installing the APK Using ADB Commands

To install the APK using an Android Debug Bridge (ADB) connection, open a command prompt and send the following ADB commands to the device:

adb install –g <apk_file_name> adb shell dumpsys deviceidle whitelist +com.symbol.wfc.voice adb shell appops set com.symbol.wfc.voice SYSTEM_ALERT_WINDOW allow

Where

<apk_file_name> is the name of the WFC Voice APK file.

Create a Shortcut for the Workforce Connect Voice Client

To create a shortcut:

1. In the Apps Screen, press and hold on the WF Connect icon.

Configuring the Client

Press and hold WF Connect icon

Drag icon to the Home screen

Figure 1 Apps Screen

2. Drag the WF Connect Icon to the Home screen.

Figure 2 Home Screen

3. Drop icon on Home screen.

Open Workforce Connect Voice Client

To open the WFC Voice Client, use one of the following methods:

• Touch the WF Connect icon on the Home screen.

Configuring the Client

Touch on the WF Connect icon on the Android Home Screen.

Touch on the WF Connect icon on the Android Apps Screen.

Figure 3 Home Screen

• Touch on the WF Connect icon on the Apps screen.

Figure 4 App Screen

The App Activation screen displays.

Activate Workforce Connect Voice Client

When the WFC Voice Client starts for the first time, the App Activation screen appears. A valid license is required for each PBX. The WFC Voice Client is activated by using an activation key, Mobile Device Manager (MDM), or USB tether.

NOTE: When activating a device that does not have direct access to the license source, use a proxy server. See

Configuring a Proxy Server on page 165.

Activate Using an Activation Key

To activate the WFC Voice Client:

Configuring the Client

Toggle Button

Clear All Fields

1. Open the WFC Voice Client.

Figure 5 App Activation Screen

2. Use one of the following activation methods:

• Keys or features - Acquires licenses from the default licensing source.

In the keys or features field, enter your activation code(s) separated by commas.

NOTE: The WFC Voice Client version 8.2.729 requires a license source URL when activating using an activation

key. Refer to the Workforce Connect Voice Client 8.2.x Administration Guide for Licensing.

3. To enter a device alias, touch the toggle button and, in the device alias field, enter a name to identify the

device on the license source.

4. Touch Register App.

The About screen appears, displaying currently licensed keys and features.

Figure 6 About Screen

5. Touch OK.

Configuring the Client

Activate Using an MDM

Configuring the WFC Voice Client using an MDM requires a deployment package and the WFC Voice Client configuration file. The configuration file including licensing information, as key and value pairs. For detailed information on the XML configuration file, see

Settings on page 26.

Define the licensing information using the following XML tags:

• license_key - Contains one or more WFC Voice Client activation keys separated by commas.

Example:

<license_key>abcd‐1234‐ab12‐cd34‐5678‐efgh‐ef56‐gh78</license_key>

• license_source - The URL of a license source.

• WFC Voice Client version 8.2.729 - Enter the following URL:

https://zebra-licensing.flexnetoperations.com/flexnet/deviceservices.

• WFC Voice Client version 8.2.730 or later - Leave this field blank.

• license_alias - Identifies the device on the license source. (Optional)

MDM Deployment

During runtime, WFC Voice Client listens for wfc.voice.ACTION_UPDATE_CONFIG intent. When the WFC Voice Client receives the intent from an MDM, the configuration file uses configuration parameters. Use a single intent to update multiple configuration parameters by including multiple element and value pairs.

WFConnect.xmlstores all WFC Voice client configuration parameters,

WFConnect.xml to update the WFC Voice Client

For detailed information on MDM deployment, refer to the Workforce Connect Voice Client 8.x Configuration Guide for Mobile Device Managers.

Activate Using a USB Tether

Send theWFConnect.xmlconfiguration file to the device using a USB tether, use an Android Debug Bridge (ADB) connection.

NOTE: It is not recommended to install the WFConnect.xml file using a USB tether because it can cause

permission issues on the device.

1. Install the WFC Voice Client APK. See Download and Install Android Application Packager (APK) Client on

page 2.

2. Copy the WFConnect.xml file in the /sdcard/WFConnect directory.

3. Open a command prompt and send the following adb command to the device:

adb shell am start -a "wfc.voice.ACTION_NEW_CONFIG" --es "profile_uri" "/WFConnect/WFConnect.xml"

Update License

To update all WFC Voice Client licenses, refer to the Workforce Connect Voice Client 8.2.x Administration Guide for Licensing.

Configure Workforce Connect Voice Client

The WFC Voice Client is configured using the Graphical User Interface (GUI), an MDM, or a USB Tether.

Configuring the Client

Enter Settings password.

NOTE: It is not recommended to install the WFConnect.xml file using a USB tether because it can cause

permission issues on the device.

Configure Using the WFC Voice Client GUI

To configure the WFC Voice Client:

1. Touch the menu button.

Figure 7 WFC Voice Client Menu

2. Touch Settings.

Figure 8 Enter Password Screen

3. Enter the settings password. The default password is: zamboni.

4. Touch Connection Parameters.

Figure 9 Connection Parameters

Configuring the Client

User ID

Password

Server Address

PBX Type

5. Select a PBX configuration. The default configuration is: PBX#1 Configuration.

For information on configuring additional PBX types, see Configuring Multiple PBX Types on page 31.

6. Touch the PBX Type field and select Avaya IP Office.

7. Enter the User ID.

8. Enter the Password.

9. Enter the Address of the PBX server.

Figure 10 Enter Parameters

NOTE: For information on optional configuration settings, see XML Tags on page 140.

10. Touch the back button three times to return to the WFC Voice Client home screen.

Figure 11 Confirmation Message

A confirmation that the Configuration has been saved to WFConnect.xml displays.

Configuring the Client

Configure Using an MDM

Settings on page 26.

Define the licensing information using the following XML tags:

• license_key - Contains one or more WFC Voice Client activation keys separated by commas.

Example:

<license_key>abcd‐1234‐ab12‐cd34‐5678‐efgh‐ef56‐gh78</license_key>

• license_source - The URL of a license source.

• WFC Voice Client version 8.2.729 - Enter the following URL:

https://zebra-licensing.flexnetoperations.com/flexnet/deviceservices.

• WFC Voice Client version 8.2.730 or later - Leave this field blank.

• license_alias - Identifies the device on the license source. (Optional)

MDM Deployment

WFConnect.xmlstores all WFC Voice client configuration parameters,

WFConnect.xml to update the WFC Voice Client

For detailed information on MDM deployment, refer to the Workforce Connect Voice Client 8.x Configuration Guide for Mobile Device Managers.

Configure Using a USB Tether

To send theWFConnect.xmlconfiguration file to the device using a USB tether, use an Android Debug Bridge (ADB) connection.

NOTE: It is not recommended to install the WFConnect.xml file using a USB tether because it can cause

permission issues on the device.

1. Install the WFC Voice Client APK. See Download and Install Android Application Packager (APK) Client on

page 2.

2. Copy the WFConnect.xml file to the WFConnect directory.

3. Open a command prompt and send the following ADB command to the device:

adb shell am start -a "wfc.voice.ACTION_NEW_CONFIG" --es "profile_uri" "/WFConnect/WFConnect.xml"

To update a specific parameter in the send an ADB command to the device in the following format:

$ adb shell am start -a wfc.voice.ACTION_UPDATE_CONFIG --es element value

For a list of possible elements and values, see XML Tags.

WFConnect.xml configuration file using ADB, open a command prompt and

Configuring the PBX

Introduction

This chapter describes the steps you need to take to configure Avaya IP Office.

Perform the following steps to configure Avaya IP Office:

• Verify that the Avaya IP Office software is at version of 9.1 or above.

• Collect necessary information

• Add User

• Set Extension number

• Set Caller ID

• Set Supervisor Password

• Check the configuration of the mobile device.

Collect Necessary Information

Assemble the following information before you begin to configure the Avaya IP Office PBX and the mobile device:

• User ID (extension #) and Password

• Extension Number

• Supervisor Password

• Server Address

Open the Avaya IP Office Web Manager

1. Open the Avaya IP Office web interface.

2. Click Call Management.

3. Click View All.

Figure 12 IP Office Web Interface

Add New SIP User

To add a new SIP user, click Add User.

Figure 13 Add User Button

Configuring the PBX

IMPORTANT: If you do not have Administrative rights, contact Zebra Help Desk at: 1.800.653.5350.

Add User Credentials

Add User credentials by following these steps:

1. Enter the following items:

Name

Password

Extension.

2. Click OK.

Figure 14 Add User Credentials

Configuring the PBX

Setup Extension (If not already configured)

If the extension has not been previously created, AIPO opens a window that allows the administrator to create an extension matching the number that he has just set in the user configuration.

1. Click SIP Extension to add a SIP extension.

Figure 15 Select Extension Dialog Box

2. Click OK.

Edit User Properties

In order for the phone to register to the PBX the administrator has to add a Supervisor password for the user.

1. Click Edit to edit the user properties. The following screen appears.

Figure 16 Edit User Settings

2. Click the Telephony tab.

Figure 17 Telephony Tab

Configuring the PBX

3. Click Supervisor Settings.

4. Enter Login Code (Supervisor Password).

Figure 18 Enter Login Code

5. Click Save.

Check Device Settings

At the device there are only 3 fields the administrator must set:

• User ID

• Password

• Server address.

Figure 19 Device Settings

Configuring the PBX

Dynamic Configuration

Introduction

The WFC Voice Client configuration file defines the operational environment of the SIP client running on Zebra mobile android devices. It has various elements that define the network location of the PBX and, for each device, unique defining operational aspects affecting the user experience. Creating this file manually and distributing this file for each device on an enterprise-wide scale introduces significant administrative overhead.

Dynamic configuration:

• Reduces the administrative effort preparing the WFC Voice Client for enterprise operation

• Provides a flexible delivery environment for the customized configuration

• Provides a method for shared device use without manually reloading the configuration

• Provides backward compatibility for existing customers.

Rather than manually creating a unique configuration for each device, this approach dynamically configures the WFC Voice Client using an XML variable file. File delivery can be manual, by an MDM, or automatic through existing network services.

Overview

The chapter includes:

• Providing a new XML tag that triggers dynamic configuration

• Building a multi-user variable file to build user specific configurations for the WFC Voice Client

• Re-synchronizing the WFC Voice Client with the variable file on a regular basis

• Using DHCP resources to provide auto installation for the file.

Properly configuring these elements allows the WFC Voice Client to register to the PBX.

General Device Use Cases

• A unique user is typically a supervisor or manager with a device with a more advanced feature set that is

not shared with any other user. This extension may be shared with that person’s desk phone.

• A shared device is typically for line workers or department staff that use a phone representing a functional

area, as opposed to a specific person. The device has a basic feature and may also be uniform, sharing common elements (e.g.; button configurations) across all shared devices.

Device Start-Up

There are three stages of device life-cycle in the customer environment that affect how the WFC Voice Client obtains the suitable runtime configuration:

• Initialized out of the box configuration (no configuration)

• A rebooted device previously configured

• A device reassigned to a new extension / user

Device Identification

The system identifies each mobile device by a unique user ID and password. The user’s credentials are mapped to a specific feature set in the PBX. This requires that the user credentials are loaded into the WFC Voice Client XML and passed to the PBX at registration time.

Dynamic Configuration

Profile Configuration

For the WFC Voice Client to connect to a PBX, the Profile section of the WFConnect.xml file must contain XML tags which the device uses to:

• Establish a link to the PBX

• Identify itself to the PBX

• Retrieve the correct privileges and settings.

NOTE: Any element in the WFC Voice Client configuration file can be replaced with a variable.

Connection Attributes

The sip_userid and sip_userpass provide access to the PBX as shown in the following example:

... <profile_type>IP Office</profile_type> <display>true</display> <profname>IP Office</profname> <prof_password></prof_password> <sip_userid>2808</sip_userid> <sip_userpass>123456</sip_userpass> <prof_description>Test-2808</prof_description> <sip_mac></sip_mac> <sip_remhost>10.80.212.44</sip_remhost> ...

</Profile>

Dynamic Configuration

The profile section requires:

• An IP address in the sip_remhost field to target the appropriate PBX.

• A user ID (sip_userid) and password (sip_pass) to identify the client to the PBX.

Dynamic Configuration

Enabling Dynamic Configuration

The var_location tag enables dynamic configuration, and reduces the entire profile section of the WFConnect.xml file to one line.

<var_location>file:///wfconnect/wfcvariable.xml</var_location>

</Profile>

NOTE: File location is for demonstration purposes. The actual file location may vary.

When the WFC Voice Client initializes and parses the XML file, this tag instructs the device to retrieve the

wfcvariable.xml file from the stated location. The location can be:

• A local file on the mobile device

• Provisioned by an MDM

• Side loaded manually

Dynamic Configuration

• A URL

Wcfvariable.xml File

This file collects and organizes XML tags to populate the run-time WFConnect.xml file. Tags that are not declared

use default values. The Users tag supports and organizes multiple users. The users section is displayed as a list

on WFC Voice Client sign-in screen. When the display tag for an entry is set to true, users can select a profile from the list.

When the display tag is set to false, the profname and prof_password tags are used. These tags are used for user authentication when selecting a hidden profile for a dedicated user. For a shared extension, these tags are rarely used.

Users can each be a complete and unique configuration, or they can re-use components, such as the following buttons example.

<Entry>

<profile_type>IP Office</profile_type> <display>true</display> <profname>IP Office-2797</profname> <prof_password></prof_password>

<sip_userid>2797</sip_userid>

<sip_userpass>123456</sip_userpass> <prof_description>MC40.1</prof_description> <sip_mac></sip_mac> <sip_remhost>10.80.212.44</sip_remhost>

</Entry>

Dynamic Configuration

<Entry>

<profile_type>IP Office</profile_type> <display>true</display> <profname>IP Office-2799</profname> <prof_password></prof_password>

<sip_userid>2799</sip_userid>

<sip_userpass>123456</sip_userpass> <prof_description>MC40.2</prof_description> <sip_mac></sip_mac> <sip_remhost>10.80.212.44</sip_remhost>

</Entry> <Entry>

<profile_type>IP Office</profile_type> <display>true</display> <profname>IP Office-2800</profname> <prof_password></prof_password>

<sip_userid>2800</sip_userid>

<sip_userpass>123456</sip_userpass> <prof_description>MC40.3</prof_description> <sip_mac></sip_mac> <sip_remhost>10.80.212.44</sip_remhost>

</Entry> <Entry>

<profile_type>IP Office</profile_type> <display>true</display> <profname>IP Office-2801</profname> <prof_password></prof_password>

<sip_userid>2801</sip_userid>

<sip_userpass>123456</sip_userpass> <prof_description>MC40.4</prof_description> <sip_mac></sip_mac> <sip_remhost>10.80.212.44</sip_remhost>

</Entry>

XML File Location

The previous example shows the wfcvariable.xml variable file resident on the device. The variable file can also reside on a centrally accessible server that the client can access. This provides service to all devices in the enterprise and central administrative control.

The var_location element specifies whether the WFC Voice Client looks for the XML file on the device (a local file) or at a network location, for example:

• Local: file:///WFConnect/wfcvariable.xml

Dynamic Configuration

• HTTP: http://10.5.90.10/wfcvariable.xml

• HTTPS: https://10.5.90.10/wfcvariable.xml

• TFTP: tftp://10.5.90.10/wfcvariable.xml

This provides options for deploying the configuration files. For example, an enterprise using an MDM may supply both the Profile section and the variable file to the device and also have a central location for the variable file.

DHCP Option 150

The WFC Voice Client also supports DHCP Option 150 for retrieving the wfcvariable.xml file. If the var_location tag is not specified in the WFConnect.xml configuration, the client attempts to download the wfcvariable.xml file from the TFTP server specified in the Option 150 string.

Configuration Resynchronization

Synchronizing dynamic configuration ensures that devices always have the most current configuration available from the network server or MDM. For example, when a user logs in to an extension, the configuration files may change. The new configuration files are available when the user logs off from the current session and the WFC service re-processes the variable files.

NOTE: The system administrator must ensure that updates are posted to the correct location available to the

WFC Voice Client client.

Dynamic Configuration

MC WLAN

initialization

Is DHCP

Enabled?

Is Zebra Vendor

Class defined?

Are Options

186 & 188

defined?

The MC knows the

TFTP server address

(Option 186) and

the Config file name

to request from

TFTP (Option 188).

The

WFConnect.XML

file is

downloaded

from the

specified TFTP

server.

The config file has location specified

for the variable

file

(WFCvariable.xml)

File is

downloaded to

the MC for

processing. A

WFCconfig.xml

file is built.

Boot with

Static

Standard DHCP

Boot

Standard DHCP

Boot

Does WFConnect

file exist?

Does var_location

statement exist?

Var file downloaded

for later processing

once extension is

selected.

No Dynamic Config

process. End.

Start Up WFC for

Manual Config

<var_location>http://192.168.10.10/WFConnect/wfcvariable.xml<var_location>

</Profile>

Dynamic Mode

<var_location>http://(Option 186)(Option 188)<var_location>

</Profile>

Network Services – Option 60 Support in Sunrise products

MDM or Side loaded config file

WFConnect.xml file

Dynamic Configuration Start-Up - Server Side

The following diagram describes the steps WFC Voice Client follows on the server side to download dynamic configuration during initialization.

Figure 20 Dynamic Configuration Start-Up Process

Dynamic Configuration

User selects

value, or enters

hidden

extension and

password

WFC looks for

‘Var_Location” In

Profile section.

(Local or server)

Can we

determine

which

extensions are

taken?

WFC Startup

Show Extensions

and Department in

reference table.

The MC has Var

Table loaded via

MDM, TFTP, or manually and is present in WFC

folder.

Has Variable

Table?

End

WFC reaches web

server to download

Var File.

Local Variable

File?

Connect to PBX

Exit WFC due to

reboot or abnormal

termination

Exit WFC for Profile

change

WFC Builds Profile

section of config

Button File

variable

declared?

Local Button File

Location?

WFC reaches web

server to download

Button File.

Complete

Configuration file

built.

Dynamic Configuration Start-Up - Client Side

The following diagram describes the steps WFC Voice Client follows on the client side to download dynamic configuration during initialization.

Figure 21 Dynamic Configuration Start-Up Process - Continued

XML File Examples

Standard Config

(Legacy Mode)

<profile_type>Wy</profile_type> <sip_mac>aaaabbbbccc1sip_mac</sip_mac> <sip_remhost>192.168.10.50</sip_remhost>

</Profile>

Variable File

Wfcvariable.xml

<Users> <Entry> <display>false</display>

<password>abc123</password> <prof_descriptiont>boss</prof_description> <sip_mac>aaaabbbbccc1</sip_mac> <sip_remhost>192.168.10.50<sip_remhost> <layout_location>http://192.168.10.10/WFConnect/buttons_1001.xml </ůĂǇŽƵƚͺůŽĐĂƚŝŽŶх

</Entry> </Users>

192.168.10.10

WFC Service Start-up:

- Request Var File

Var File sent to device. At WFC UI Activation user prompted for Prof_Names User scrolls through Profile Names and makes selecttion.

192.168.10.10

Button File external reference for profile.

- Request Button File

Button File sent to device. Var file and Button file has all information needed to build WFConfig.xml file.

Buttons_1001.xml

<Footer> <Button> <title>History</title> <action>HISTORY</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description></description> <fg_color>#FFFFFFFF</fg_color> <icon></icon>

</Button> <&ŽŽƚĞƌ>

….

<var_location>http://192.168.10.10/WFConnect/wfcvariable.xml<var_location>

</Profile>

Dynamic Mode

<var_location>http://(Option 186)(Option 188)<var_location>

</Profile>

Network Services – Option 60 Support in Sunrise products

MDM or Side loaded config file

WFConnect.xml file

The following example displays the standard profile and different ways the voice client is able to retrieve a Dynamic Workforce Configuration XML file. Options include local XML and TFTP downloaded XML configuration.

Figure 22 XML Files Example

Dynamic Configuration

Testing Remote Dynamic Configuration

A test environment can use any remote server supporting web services.

To set up a lab system:

1. Ensure the server is running IIS to support Web services.

2. Establish a WFC Voice Client website.

3. Create the website and add a virtual folder.

4. Open the Default Documents properties.

Figure 23 Server Manager

5. Set the folder for the WFC Voice Client XML file repository.

Dynamic Configuration

Figure 24 Edit Virtual Directory

6. Test the settings to verify the system and default user can access the files.

NOTE: To test accessibility of the files, point your browser to the web site.

7. After determining access to the files, modify the XML files accordingly:

• An example of remote access in WFConnect.xml is:

<var_location>http://192.168.10.45/var/wfcvariable.xml</var_location>

</Profile>

• An example of remote access in the wfcvariable.xml is:

<layout_location>http://192.168.10.45/var/buttons_5002.xml</layout_location>

A remote server allows consistency of delivery to the remote device. Logging on and off the device synchronizes changes to the device. Each login retrieves the existing XML file targeted for that device.

Settings

Introduction

This chapter contains information on settings used to configure and customize the WFC Voice Client.

The following sections provide detailed information on:

• Profile Settings - creating, editing, loading and saving a settings profile.

• Connection Parameters - configuring up to four PBX types.

• Audio Settings - configuring advanced audio settings.

• UI Settings - controlling the appearance and functionality of WFC Voice Client.

• Call Settings - configuring advanced call settings.

• Ringtones - configuring WFC Voice Client ringtones.

• Miscellaneous Settings - locating help files and editing the settings password.

Exiting WFC Voice Client:

1. Touch the menu button, then Settings. The password dialog box appears.

2. Enter password (default: zamboni).

3. Touch Enter.

4. Touch Stop Service > Yes.

This action can also be initiated using ADB, an MDM, or a third party app. For example, in ADB you can use the following command:

$ adb shell am broadcast -a wfc.voice.STOP_APP

Reloading WFC Voice Client:

1. Touch the menu button.

2. Touch Reload.

This action can also be initiated using ADB, an MDM, or a third party app. For example, in ADB you can use the following command:

$ adb shell am broadcast -a wfc.voice.SIGN_OUT

Profile Settings

The WFC Voice Client profile is an XML file that contains all the settings for the current WFC Voice Client session.

Create Profile

Create a new profile. A new XML file is created in the WFConnect folder.

To create a new profile:

1. Touch the menu button, then Settings. The password dialog box appears.

2. Enter password (default: zamboni).

3. Touch Enter.

4. Touch the menu button, then Create new profile.

5. Touch Save current profile.

6. Enter a file name for the new profile.

7. Touch Save. The file is saved in the WFConnect folder.

8. Touch the Back button to return to the WFC Voice Client home screen.

Settings

Change Profile Name

To change the name of the current profile:

1. Touch the menu button, then Settings. The password dialog box appears.

2. Enter password (default: zamboni).

3. Touch Enter.

4. Touch Profile name.

5. Enter a file name for the new profile.

6. Touch OK. The file name in the WFConnect folder is updated.

7. Touch the Back button to return to the WFC Voice Client home screen.

Shared Profiles URI

Set the URI of shared profile located on a remote or local server.

To set the URI of a shared profile:

1. Copy the profile from the WFConnect folder using a USB tether.

2. Move the profile to a remote or local server.

Supported protocols are file, http, https, and tftp.

3. From the WFC Voice Client, touch the menu button, then Settings. The password dialog box appears.

4. Enter password (default: zamboni).

5. Touch Enter.

6. Touch Shared Profiles URI.

7. Enter the URI of the shared profile.

8. Touch OK.

9. Touch the Back button to return to the WFC Voice Client home screen.

Settings

Load New Profile

Load profiles previously saved to the:

• WFConnect folder

• SD Card

Loading a New Profile Using the GUI

1. Touch the menu button, then Settings. The password dialog box appears.

2. Enter password (default: zamboni).

3. Touch Enter.

4. Scroll to the bottom of the screen.

5. Touch Load new profile. The Select Profile File dialog box appears.

Figure 25 Select Profile Popup

6. Select a profile file name.

7. Touch the Back button or Refresh button to load new profile.

Loading a New Profile Using XML

<profname>WFConnect.xml</profname>

</Profile>

Installing the APK Using ADB Commands

To install the APK using an Android Debug Bridge (ADB) connection, open a command prompt and send the following ADB command to the device:

$ adb shell am start -a wfc.voi ce.ACTION_NEW _CONFIG --es profile_uri < configuration_fi le>

Where

<configuration_file> is the URI of the new XML configuration file.

Save Current Profile

Using the same file name, save the current profile to replace an existing XML file.

To save an existing profile:

1. Touch the menu button, then Settings. The password dialog box appears.

2. Enter password (default: zamboni).

3. Touch Enter.

4. Scroll the bottom of the screen.

5. Touch Save current profile. The current profile name appears.

Settings

6. Touch Save. The file is saved in the WFConnect folder.

7. Touch the Back button to return to the WFC Voice Client home screen.

Edit a Profile Using XML

To edit a saved profile using XML, copy the new profile from the WFConnect folder using a USB tether.

Connection Parameters

Users can make and receive a call using any configured PBX type. This section describes how to configure up to three additional PBX types using the WFC Voice Client GUI or WFConnect.xml file.

To configure the default PBX (PBX#1 Configuration) see Configure Workforce Connect Voice Client on page 6.

Figure 26 Connection Parameters

Settings

Configuring Multiple PBX Types

Set the configuration parameters for additional PBX types:

IMPORTANT: When configuring multiple PBXs, ensure the server IP address and credentials are pointing to the

correct PBX call server as indicated by the profile type. For example, the IPOFFICE profile must be configured with the IP address and credentials of a IPOFFICE call manager.

Using the GUI

1. Touch the menu button, then Settings. The

password dialog box appears.

2. Enter the password (default: zamboni).

3. Touch Enter.

4. Touch Advanced Settings > Connection

Parameters.

5. Touch PBX#2 Configuration.

6. Touch PBX#2 Type.

7. Select the PBX type that is the same as the

target PBX call server.

8. Enter the configuration information.

Refer to the Getting Started chapter of the WFC Voice Client Administrator Guide for the desired PBX type.

9. Touch the Back button to return to the

Connection Parameters screen.

10. Repeat steps 5 through 7 for up to two

more PBX types (optional).

11. Touch the Back button to return to the

WFC Voice Client home screen.

Using XML

<profile_type>Licensed PBX One </profile_type> <sip_userid>1001</sip_userid> <sip_userpass>1234</sip_userpass> <sip_localport>5060</sip_localport> <sip_remhost>10.5.97.99</sip_remhost> <sip_remport>5060</sip_remport> <sip_transport>UDP</sip_transport> <sip_realm>10.16.2.111</sip_realm> <profile2_type>Licensed PBX Two </profile2_type> <sip2_userid>1002</sip2_userid> <sip2_userpass>1234</sip2_userpass> <sip2_device_type>9971</sip_device_type> <sip2_mac>00-11-22-33-44-55</sip2_mac> <sip2_localport>5060</sip2_localport> <sip2_remhost>10.5.97.99</sip2_remhost> <sip2_remport>5060</sip2_remport> <sip2_transport>UDP</sip2_transport>

<sip2_realm>10.16.2.111</sip2_realm> </Profile> ... </WFConnect>

Audio Settings

CAUTION: Changing the default audio settings may have adverse results.

Do not modify these settings unless directed to so by Zebra Technical Support.

This section provides detailed information on configuring advanced audio settings. Use the WFC Voice Client GUI or WFConnect.xml file to customize the Profile section. Both methods are discussed with each Function description.

To configure audio settings:

1. Touch the menu button, then Settings. The password dialog box appears.

Figure 27 WFC Voice Client Menu

Settings

2. Enter password (default: zamboni).

3. Touch Enter.

Figure 28 WFC Voice Client Settings Menu

4. Touch Advanced Settings > Audio Settings.

Figure 29 Advanced Settings / Audio Settings

Settings

Audio Codecs Priorities

Set the audio Codecs preferences.

NOTE: Only select audio Codecs available in the PBX.

Settings

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Select Audio Codecs Priorities.

3. Select the Codec preference (default order

preferred). See Table 1 for descriptions.

4. Touch Back button to return to the WFC

Voice Client home screen.

Table 1 Codecs Priorities

Field Type Description XML

G.711 u-Law When selected, assigns preference priority for

G.711 u-LAW Voice codec negotiations between PBX and Client.

G.711 A-Law When selected, assigns preference priority for

G.711 A-Law Voice codec negotiations between PBX and Client.

G.729 When selected assigns preference priority for

G.729 Voice codec negotiations between PBX and Client.

Using XML

<codec_ulaw_priority>1</codec_ulaw_p

riority> </Profile> ... </WFConnect>

<codec_ulaw_priority>1 </codec_ulaw_priority>

<codec_alaw_priority>2 </codec_alaw_priority>

<codec_g729_priority>3 </codec_g729_priority>

G.722 When selected assigns preference priority for

G.722 Voice codec negotiations between PBX and Client.

GSM When selected assigns preference priority for

GSM Voice codec negotiations between PBX and Client.

<codec_g722_priority>4 </codec_g722_priority>

<codec_gsm_priority>5 </codec_gsm_priority>

Jitter Buffer

Jitter Initial Delay

Set the Jitter Buffer initial delay settings.

Settings

Using the GUI

1. In Advanced Settings select Audio Settings.

2. Slide the Jitter Initial Delay slider (default 60

msec).

3. Touch Back button to return to the WFC Voice

Client home screen.

Jitter Buffer Max Buffer Size

Set the maximum Jitter Buffer size.

Using the GUI

1. In Advanced Settings select Audio Settings.

2. Slide the Jitter Buffer Size slider (default 250

msec).

3. Touch Back button to return to the WFC Voice

Client home screen.

Using XML

<jitter_min>60</jitter_min> </Profile> ... </WFConnect>

Using XML

<jitter_max>250</jitter_max> </Profile> ... </WFConnect>

Settings

RTP Parameters

Real-Time Transport Protocol (RTP) Parameters - Payload Size

Set the RTP Payload size.

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Select RTP payload size.

3. Select the RTP payload size from the dialog

box (default 20 ms).

4. Touch the Back button to return to the WFC

Voice Client home screen.

First Real-Time Transport Protocol (RTP) Port

Set the First RTP Port.

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Select First RTP port.

3. Enter the First RTP port number (default

50000).

4. Select OK.

5. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<sip_rtp_ptime>20</sip_rtp_ptime> </Profile> ... </WFConnect>

Using XML

<sip_rtp_port1>50000</sip_rtp_port1> </Profile> ... </WFConnect>

Last Real-Time Transport Protocol (RTP) Port

Select the Last RTP Port.

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Select Last RTP Port.

3. Enter the Last RTP port number (default

50025).

4. Select OK.

5. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<sip_rtp_port2>50025</sip_rtp_port2> </Profile> ... </WFConnect>

Settings

Audio Enhancements

This section describes how to enable and disable audio enhancements.

Configuring Audio Enhancements

Set the following audio enhancements:

• Echo Cancellation

• Noise Reduction

• AGC on speaker

• AGC on earpiece

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Scroll down to Audio Enhancements.

3. Tap the check boxes next to the items to

enable (default: disabled).

4. Touch the Back button to return to the WFC

Voice Client home screen.

Input / Output Audio

Set the input / output volume.

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Scroll down to Input Audio Volume and

Output Audio Volume under Audio Enhancements.

3. Use the slider to select the volume levels for

Input and Output Audio (default 1).

4. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<use_aec>false</use_aec> <use_noise>false</use_noise> <use_agc_speaker>false</use_agc_speake

<use_agc_ear>false</use_agc_ear> </Profile> ... </WFConnect>

Using XML

<audio_gain_in>1</audio_gain_in>

<audio_gain_out>1</audio_gain_out> </Profile> ... </WFConnect>

Audio Debugging Tools

Set the following debugging tools:

• Show jitter stats

• Save incoming voice

• Native Sample Rate

Settings

Using the GUI

1. In Advanced Settings select Audio

Settings.

2. Scroll down to Audio Debugging Tools.

3. Tap the check boxes next to the items to

enable (default: disabled).

4. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<show_jitter_stats>false</show_jitter_

stats>

<save_incoming_voice_to_file>false</sa

ve_incoming_voice_to_file>

<use_native_sample_rate>false</use_nat

ive_sample_rate> </Profile> ... </WFConnect>

UI Settings

Use the GUI to configure the User Interface. Settings made in the GUI are saved to the XML file. The GUI settings and the XML file drives the WFC Voice Client look and functionality. Alternatively edit the XML file, WFConnect.xml, to make the same GUI settings. The saved WFConnect.xml file can be modified and use to configure other devices.

The WFConnect.xml file must be stored on the device in the WFCconnect folder. If this file does not exist, the application uses the default parameter values. The WFC Voice Client XML configuration file has the following sections which must be present in the file and in the following order:

• Profile section

• Footer section

• Dashboard section

• Call buttons section.

Settings

IMPORTANT: All these sections must be present in the XML file and they must be in the order listed above.

Configuration File Sections

Profile Section

The Profile section contains all the global settings and only requires one item to begin using the WFC Voice Client on a PBX.

• SIP Remote Host (PBX Server Address) <sip_remhost>

Unless specified, the Profile section of the WFC Voice Client uses the default settings for Audio Settings, Call Settings, Miscellaneous Settings, Logging and Optional Services (This is a suggested best practice). Use the WFC Voice Client GUI or WFConnect.xml file to customize the Profile section. Both methods are discussed with each Function description.

See XML Example - Profile for a profile section example.

Footer Section

The Footer section defines the buttons, or soft keys, on the WFC Voice Client home screen. The buttons are listed in the order they appear on the screen. A maximum of six buttons can be added. The Footer always displays until a call is initiated. While additional items can be defined in the Footer, the following items are strongly recommended:

• History

• Redial

• Dial

• Contacts

• Voicemail.

Use the WFC Voice Client GUI or WFConnect.xml file to customize the Footer. Both methods are discussed with each Function description.

Settings

NOTE: The footer area does not require a <columns> element as it is always one row of buttons.

IMPORTANT: If a footer section is not required, do not define any buttons between the <Footer> and the

</Footer> tags.

See XML Example - Footer for a footer section example.

Dashboard Section

The Home Screen Dashboard section defines the buttons in the dashboard area of the screen and their layout on the WFC Voice Client screen. The Dashboard displays functions and features specific to the end user. A maximum of 12 buttons can be displayed on the screen; additional buttons are accessed by scrolling up and down. Use the WFC Voice Client GUI or WFConnect.xml file to customize the Footer. Both methods are discussed with each Function description.

See XML Example - Dashboard for a dashboard section example.

Call Buttons Section

The Call Buttons section defines the buttons in the call buttons area of the screen and their layout on the WFC Voice Client screen. In-Call displays the available function and action of call buttons that can be accessed during a call. While on a call the user may wish to perform one of the following:

• Add Call

• Home

• Hold

• Resume

• Park

• Transfer

• Conference

• Complete

• End Call.

See XML Example - Call Buttons for a call button section example.

Headless Mode

For detailed information on Headless Mode see Headless Mode and WFCVoice Service.

Background Logo

Icon Library

To choose a background from the icon library:

Settings

Using the GUI

1. In Advanced Settings select UI Settings >

Background Logo.

2. From the LIBRARY tab, select the new

background. A yellow box appears around the selected background.

3. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<background_logo>logo</background_lo

go> </Profile> ... </WFConnect>

Custom Background Configuration

The user can create a custom background. To select a custom background:

1. Connect the device to a host computer using a USB cable.

2. From the host computer, copy the icon file to the WFConnect folder on device.

Custom Background Configuration

Using the GUI

1. In Advanced Settings select UI Settings >

Background Logo.

2. From the SDCARD tab, select the new

background. A yellow box appears around the selected background.

3. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<background_logo>custom_logo.png</ba

ckground_logo> </Profile> ... </WFConnect>

Buttons Padding

Set the horizontal spacing between in-call buttons from 0 pixels to 50 pixels, in 10 pixel increments.

Using the GUI

1. In Advanced Settings select UI Settings >

Background Logo.

2. Slide the Buttons padding slider (default 0).

3. Touch Back to return to the WFC Voice

Client home screen.

Using XML

<buttons_padding>50</buttons_padding </Profile> ... </WFConnect>

Settings

Dialer Padding

Set vertical padding at the bottom of the contacts and history screens from 0 pixels to 200 pixels, in 1 pixel increments.

Using the GUI

1. In Advanced Settings select UI Settings >

Background Logo.

2. Slide the Dialer padding slider (default 0).

3. Touch Back to return to the WFC Voice

Client home screen.

Using XML

<dialer_padding>78</dialer_padding </Profile> ... </WFConnect>

Graphical User Interface Design Tool

Use the GUI Design Tool to customize the Footer, Dashboard and In-Call screen from within the WFC Voice Client. Configure each to fit the specific needs of the customer. The appearance of the WFC Voice Client is configured using the GUI or by directly modifying the WFConnect.xml file. Details on specific XML settings and the construct of the XML configuration file are discussed in more detail later in this guide.

To begin using the GUI Design Tool, follow the steps below to configure the Footer, Dashboard or In-Call screens:

1. Launch WFC Voice Client.

2. Touch the menu button, then Settings. The password dialog box appears.

Figure 30 WFC Voice Client Menu

3. Enter password (default: zamboni).

4. Touch Enter.

Figure 31 WFC Voice Client Settings Menu

5. Touch Advanced Settings > UI Settings.

Figure 32 Advanced Settings / UI Settings

Settings

6. Select Edit Dashboard, Edit Footer or Edit In-Call Button.

Using the UI Settings GUI Design Tool

The following diagram describes the buttons available for each area.

Figure 33 GUI Design Tool - Footer

Buttons that will be

available for use in the

selected area:

• Footer

• Dashboard

• In-Call

Touch Add to add a button.

Touch a button to edit. A yellow boarder appears indicating the button to be configured.

Touch Up to move the button to the left in the list.

Touch Delete to remove selected button.

Touch Down to move the button right in the list.

Touch Edit to edit the button

configuration

Header Label will change based on the selected area to configure:

• Footer Design

• Dashboard Design

• In-Call Designer

Touch 3 Columns or 4 Columns to change the number of columns.

Settings

The Footer and In-Call views use the layout displayed in Figure 33. The Dashboard view has an additional toggle button in the bottom center of the screen to change the number of columns on the dashboard (3 or 4).

Figure 34 GUI Design Tool - Dashboard

Home Screen Dashboard

Dashboard Buttons

Footer

In-Call Dashboard Buttons (Configurable)

In-Call Footer (Not Configurable)

Figure 35 Home Screen Dashboard

Settings

In-Call Dashboard

Figure 36 In-Call Dashboard

Settings

Button Configuration

The following sections describes each button that can be placed on the UI. Each section lists the Designer Tool procedure and corresponding XML configuration.

Call

Call is the ability to make a telephone call to a specific number or location using a prefix. The administrator identifies a target by its extension (phone number) and enters this into the Value field along with the prefix. The user can then use this function to initiate a call to the preset destination.

Figure 37 Sample Button Edit Screen

Configuring the Call Button

Settings

Using the GUI

1. In UI Settings select Edit Footer, Edit

Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select CALL from the

Select Action menu.

6. If the dialed number has a prefix, in the Value

field, enter the prefix number.

7. In the Title field, enter Call.

8. In the Description field, enter a short

description of the button function.

9. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

10. Touch BG to set the background color. See

Button Background Color on page 78.

11. Touch FG to set the foreground text color.

See Button Text Color on page 79.

12. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Call</title> <action>CALL</action> <value>9</value> <enabled>true</enabled> <confirm>false</confirm> <description>Make a

call</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Dial

Dial is the ability to dial a specified extension or number to initiate a telephone call. A caller identifies a target by its extension (phone number) and originates the call.

Configuring the Dial Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select DIAL from the

Select Action menu.

6. In the Title field, enter Dial.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Dial</title> <action>DIAL</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Dial a number or

extension</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Start App

Start Application defines a button to launch another application on the device. When the button is pressed WFC Voice Client minimizes to run in the background and the defined application launches. For example, a button can be placed in the Footer to open an email application.

Configuring the Start App

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box

appears around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is

Disabled).

5. Touch Action and select START_APP.

6. Touch Select App Package and select the

application from the Select App Package menu.

7. In the Title field, enter the application

name.

8. In the Description field, enter a short

description of the button function.

9. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

10. Touch BG to set the background color. See

Button Background Color on page 78.

11. Touch FG to set the foreground text color.

See Button Text Color on page 79.

12. Touch the Back button to return to the

WFC Voice Client home screen.

Using XML

Opening the music application example is shown in the following XML.

<Footer> or <Dashboard> or <CallButtons> ...

<title>Email</title> <action>START_APP</action> <value>com.android.email</value> <enabled>true</enabled> <confirm>false</confirm> <description>Open email

application</description> <icon>email.png</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Log Marker

Log Marker creates a time stamp in the logs. If you experience any issues with WFC Voice Client functionality, the time stamp focuses troubleshooting of the device to the time the issue occurred for more rapid resolution.

Configuring the Log Marker

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select LOG_MARKER

from the Select Action menu.

6. In the Title field, enter Log Marker.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Log Marker</title> <action>LOG_MARKER</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Create time

stamp</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Speed Dial 0-9

Speed Dial places a telephone call to a preset number/extension. Set up to 10 speed dial buttons on the dashboard through the GUI interface.

Configuring the Speed Dial Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select SPEED_DIALx

from the Select Action menu.

6. In the Value field, enter the extension.

7. In the Title field, enter Speed Dial (#).

8. In the Description field, enter a short

description of the button function.

9. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

10. Touch BG to set the background color. See

Button Background Color on page 78.

11. Touch FG to set the foreground text color.

See Button Text Color on page 79.

12. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Speed Dial #1</title> <action>SPEED_DIAL1</action> <value>5133</value> <enabled>true</enabled> <confirm>false</confirm> <description>Speed dial

#1</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Redial

Redial places a telephone call to the most recently call location. It is highly recommended that the redial button resides only in the Footer.

Configuring the Redial Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select REDIAL.

6. In the Title field, enter Redial.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> ...

<title>Redial</title> <action>REDIAL</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Dial the last number

called</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer>

Settings

Suspend Mode

Suspend Mode blocks all incoming or outgoing calls.

Configuring the Suspend Mode Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select SUSPEND_MODE.

6. In the Title field, enter Suspend Mode.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Suspend Mode</title> <action>SUSPEND_MODE</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Block all incoming

calls</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or <Dashboard> or

Settings

History

History lists recently called numbers and incoming calls, including missed calls.

Configuring the History Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select HISTORY.

6. In the Title field, enter History.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>History</title> <action>HISTORY</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Display recently

called numbers and incoming calls</description>

<bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Contacts

The Contacts button dials a new number by selecting an existing contact. Add and store contacts locally on the device.

Configuring the Contacts Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select CONTACTS.

6. In the Title field, enter Contacts.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Contacts</title> <action>CONTACTS</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Display contacts

</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Favorites

The Favorites button dials a new number by selecting a contact that is set as a favorite. Set contacts as favorites locally on the device.

Configuring the Favorites Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select FAVORITES.

6. In the Title field, enter Favorites.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Favorites</title> <action>FAVORITES</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Display favorites

</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Voicemail

The Voicemail button dials a number configured on the PBX to access Voicemail messages.

Configuring the Voicemail Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select VOICEMAIL.

6. In the Value field, enter the Voicemail Pilot

number.

7. In the Title field, enter Voicemail.

8. In the Description field, enter a short

description of the button function.

9. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

10. Touch BG to set the background color. See

Button Background Color on page 78.

11. Touch FG to set the foreground text color.

See Button Text Color on page 79.

12. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Voicemail</title> <action>VOICEMAIL</action> <value>9999</value> <enabled>true</enabled> <confirm>false</confirm> <description>Voicemail

messages</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Do Not Disturb

Access the Do Not Disturb (DND) feature directly on the phone. Use a Feature Access Code (FAC) to enable or disable this feature. Enabling DND suspends all personal calls targeted to the extension, and sends the call immediately to the defined Coverage Path. DND also removes the extension from consideration during any Coverage Answer Group, Simultaneous Ringing, and Hunt Group call. This feature is the PBX-based implementation of an endpoint device Call Ignore feature.

Configuring the DND Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select

DO_NOT_DISTURB.

6. In the Value field, enter the FAC for the Do

Not Disturb feature.

7. In the Title field, enter DND.

8. In the Description field, enter a short

description of the button function.

9. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

10. Touch BG to set the background color. See

Button Background Color on page 78.

11. Touch FG to set the foreground text color.

See Button Text Color on page 79.

12. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <CallButtons> ...

<title>DND</title> <action>DO_NOT_DISTURB</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Ignore incoming

calls</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Note: DND is enabled/disabled using Feature Access Code (FAC).

Follow Me

Follow me diverts all telephone calls targeted to one extension to a second extension. All incoming calls targeted to a phone with Follow Me enabled are immediately diverted to the Follow Me target. User settings from a phone with Follow Me enabled are applied to calls received at the target extension.

IMPORTANT: Only available on the In-Call screen.

Configuring Follow Me

Settings

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select FOLLOW ME.

6. In the Title field, enter Follow Me.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Follow Me</title> <action>FOLLOW ME</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Follow me to another

extension </description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Notes:

• Follow Me To: From their own extension,

the user commands the PBX to send all calls to another destination (similar to Call Forwarding (unconditional)).

• Follow Me Here: From another

extension the user commands the PBX to send all calls to that extension.

• *14*N# - Follow Me To. (To disabled this

perform Follow me to own extension.)

• *12*N# - Follow Me Here.

• *13*N# - Cancel Follow Me Here.

Settings

Add Call

During an active call the Add Call button can dial a preset number. If there is no number in the Value field, it opens the dialer. The current call is placed on hold while the new call is initiated. When the new call connects, you can Transfer, Conference, or End the second call and resume the first call.

IMPORTANT: Only available on the In-Call screen only.

Configuring the Add Call Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select ADD_CALL.

6. In the Title field, enter Add Call.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Add Call</title> <action>ADD_CALL</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Add a call by

opening the dialer </description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

Home

During an active call the Home button invokes the Dashboard to provide access to Dashboard functions.

IMPORTANT: Only available on the In-Call screen.

Configuring the Home Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select HOME.

6. In the Title field, enter Home.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Home</title> <action>HOME</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Return to the Home

Dashboard</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

Hold

Call Hold politely suspends an active call while you tend to other business or place an additional call using an additional Call Appearance. During call hold, you can switch between the active and held calls at any time.

IMPORTANT: Only available on the In-Call screen.

Configuring the Hold Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select HOLD.

6. In the Title field, enter Hold.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Hold</title> <action>HOLD</action> <value></value> <enabled>false</enabled> <confirm>false</confirm> <description>Place call on

hold</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

Resume

During an active call touch the Resume button to access the current call on hold.

IMPORTANT: Only available on the In-Call screen.

Configuring the Resume Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select RESUME.

6. In the Title field, enter Resume.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Resume</title> <action>RESUME</action> <value></value> <enabled>false</enabled> <confirm>false</confirm> <description>Resume an active

call</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

Transfer

Transfer transfers an active call to a third party. While Call Forwarding must be preconfigured, Call Transfer allows making such call exchanges in real-time with an active call.

IMPORTANT: Only available on the In-Call screen.

Configuring the Transfer Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select TRANSFER.

6. In the Title field, enter Transfer.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Transfer</title> <action>TRANSFER</action> <value></value> <enabled>false</enabled> <confirm>false</confirm> <description>Transfer a call

</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

Conference

Conference joins two separate calls for collaboration between each party on the line at the same time. Use a Feature Access Code (FAC) to enable or disable this feature. See System Feature Settings on page 27.

IMPORTANT: Only available on the In-Call screen.

Configuring the Conference Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select CONFERENCE.

6. In the Title field, select Conference.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>Conf</title> <action>CONFERENCE</action> <value></value> <enabled>false</enabled> <confirm>false</confirm> <description>Start a conference

call</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

Complete

This internal type is used for call transfer or conference scenarios.

IMPORTANT: Only available on the In-Call screen.

Configuring the Complete Button

Using the GUI

1. In Advanced Settings select UI Settings

> Edit In-Call > Add.

2. Select the new button. A yellow box

appears around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is

Disabled).

5. Touch Action and select COMPLETE.

6. In the Title field, enter Complete.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color.

See Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the

WFC Voice Client home screen.

Using XML

<CallButtons> ...

<title>Complete</title>

<action>COMPLETE</action>

<confirm>false</confirm>

<description>End a call transfer or

conference call</description>

<bg_color>#FF001425</bg_color>

<fg_color>#FFFFFFFF</fg_color>

<icon>Default</icon> </Button>

... </CallButtons>

Settings

End Call

This function ends a call in any state. It is pushed back from the Workforce Connect client to the PBX.

IMPORTANT: Only available on the In-Call screen.

NOTE: Placing the End Call button on the in-call dashboard replaces the default End Call button.

Configuring the End Call Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select END_CALL.

6. In the Title field, enter End Call.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<CallButtons> ...

<title>End Call</title> <action>END_CALL</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>End a call

</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </CallButtons>

Settings

List

By default, List displays the speed dial list 0-9. Alternatively, configure the List button to open a menu built from other WFC Voice Client buttons.

IMPORTANT: Only available on the In-Call screen.

Configuring the Default List Button

NOTE: This only creates a button. Edit XML file to customize the list.

The List button description appears at the top of the List popup dialog.

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer or Edit Dashboard > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select LIST.

6. In the Title field, enter List.

7. In the Description field, enter a short

description of the button function.

8. Touch Icon and select an icon from the

Select Icon menu. See Icons on page 75.

9. Touch BG to set the background color. See

Button Background Color on page 78.

10. Touch FG to set the foreground text color.

See Button Text Color on page 79.

11. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> ...

<title>List</title> <action>LIST</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Department

extensions </description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

</Button> ... </Footer> or </Dashboard>

Configuring List Buttons Using XML

List buttons are configured using XML. The List button contains each sub button before the closing </Button> element. The List button description appears at the top of the List popup dialog. The sub button description appears as a comment under the button title, identifying which action is performed.

For example, to create a list with three custom buttons (Bedding, Electronics and Toys):

Figure 38 List Button Example

<Footer> or <Dashboard> or <CallButtons> ...

<title>List</title> <action>LIST</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Department Extensions </description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>Default</icon>

<title>Bedding</title> <action>CALL</action> <value>1111</value> <enabled>true</enabled> <confirm>false</confirm> <description>Bedding Department</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color>

<title>Electronics</title>

<confirm>false</confirm>

<description>Electronics Department</description

<bg_color>#FF001425</bg_color>

Settings

</Button>

...

Settings

<fg_color>#FFFFFFFF</fg_color>

<confirm>false</confirm>

<description>Toys Department</description

<bg_color>#FF001425</bg_color>

<fg_color>#FFFFFFFF</fg_color>

</Footer> or </Dashboard> or </CallButtons>

Settings

Blank

Blank provides an empty space between buttons for a more customized look and feel. If touched, the Blank button does not perform an action.

Configuring the Blank Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select BLANK.

6. In the Title field, enter Blank.

7. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Blank</title> <action>BLANK</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Empty

space</description> <icon></icon>

</Button> ... </Footer> or </Dashboard> or

</CallButtons>

Settings

Reload

Reload allows a user to sign out and then automatically sign back in to the WFC Voice Client.

Configuring the Reload Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select

SIGNOUT_CHANGE.

6. Ensure the Value field is empty.

7. In the Title field, enter Sign Out.

8. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Dashboard> or <CallButtons> ...

<title>Sign Out</title> <action>SIGNOUT_CHANGE</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description></description> <icon></icon> <scale>CENTER_INSIDE</scale>

</Button> ... </Dashboard> or </CallButtons>

This action can also be initiated using ADB, an MDM, or a third party app. For example, in ADB you can use the following command:

$ adb shell am broadcast -a wfc.voice.SIGN_OUT

Settings

Sign Out

Sign Out allows a user to sign out of the WFC Voice Client.

Configuring the Sign Out Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select

SIGNOUT_CHANGE.

6. In the Value field, enter 0.

7. In the Title field, enter Sign Out.

8. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Dashboard> or <CallButtons> ...

<title>Sign Out</title> <action>SIGNOUT_CHANGE</action> <value>0</value> <enabled>true</enabled> <confirm>false</confirm> <description></description> <icon></icon> <scale>CENTER_INSIDE</scale>

</Button> ... </Dashboard> or </CallButtons>

This action can also be initiated using ADB, an MDM, or a third party app. For example, in ADB you can use the following command:

$ adb shell am broadcast -a wfc.voice.SIGN_OUT --es change 0

Settings

Ringtone

Sign Out allows a user to sign out of the WFC Voice Client.

Configuring the Blank Button

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. Touch Action and select RINGTONE.

6. In the Title field, enter Ringtone.

7. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Dashboard> or <CallButtons> ...

<title>Ringtone</title> <action>RINGTONE</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description></description> <icon></icon> <scale>CENTER_INSIDE</scale>

</Button> ... </Dashboard> or </CallButtons>

Icons

Icon Library

To choose a button from the icon library:

Settings

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. In the Description field, enter a short

description of the button function.

6. Touch Icon. The Select Icon menu is

displayed.

7. From the Library tab, select an icon.

8. Touch BG to set the background color. See

Button Background Color on page 78.

9. Touch FG to set the foreground text color.

See Button Text Color on page 79.

10. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Dial</title> <action>DIAL</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Dial button from

library</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>ic_dialpad</icon>

</Button> ... <Footer> or <Dashboard> or <Call Buttons>

Custom Icon Configuration

NOTE: Icons must be 128 pixels by 128 pixels and in PNG format.

The user can create custom icons. To select a custom icon:

1. Connect the device to a host computer using a USB cable.

2. From the host computer, copy the icon file to the WFConnect folder on device.

Settings

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call > Add.

2. Select the new button. A yellow box appears

around the selected button.

3. Touch Edit.

4. Select the check box next to Confirm On

Click to enable this (the default is Disabled).

5. In the Description field, enter a short

description of the button function.

6. Touch Icon. The Select Icon menu displays.

7. From the SDCARD tab, select an icon.

8. Touch BG to set the background color. See

Button Background Color on page 78.

9. Touch FG to set the foreground text color.

See Button Text Color on page 79.

10. Touch the Back button to return to the WFC

Voice Client home screen.

Icon Scale Type

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<title>Dial</title> <action>DIAL</action> <value></value> <enabled>true</enabled> <confirm>false</confirm> <description>Dial button from SD

card</description> <bg_color>#FF001425</bg_color> <fg_color>#FFFFFFFF</fg_color> <icon>dialbtn.png</icon>

</Button> ... <Footer> or <Dashboard> or <Call Buttons>

• CENTER_INSIDE

Position image in the center area above title. Size of the image will be equal to or less than the size of the button. This is the default scale type.

• SCALE_CENTER

Scale image in the center to fill area above title. Maintain aspect ratio of the image.

• FILL_CENTER

Scale in the center to fill button size (no padding) and maintain the aspect ratio. The title is on top of the image in the center.

• FILL_XY

Scale to fill button size (no padding) in both directions. Does not maintain aspect ratio. The title is on top of the image in the center.

To set the scale type for an icon:

Settings

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call

2. Select a button. A yellow box appears around

the selected button.

3. Touch Edit.

4. In the Scale field, select a Scale Type.

5. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<Footer> or <Dashboard> or <Call Buttons> ...

<action>DIAL</action> <title>Title</title> <value></value> <icon>conference</icon> <scale>SCALE_CENTER</scale>

</Button> ... <Footer> or <Dashboard> or <Call Buttons>

Settings

Button Color

Button Background Color

Use Button Background Color to set the color of individual buttons. Setting a background color overrides the Global

Button Background Color. The default background color is dark gray (#FF001425).

Figure 39 Button Background Color

Setting Button Background Color

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call

2. Select a button. A yellow box appears around

the selected button.

3. Touch Edit.

4. Touch the BG button.

5. Select a color and touch Set.

6. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<bg_color>#FF001425</bg_color> </Button>

Settings

Button Text Color

Use Button Text Color to set the color of individual buttons. Setting a text color overrides the Global Button Text

Color. The default text color is white (#FFFFFFFF).

Figure 40 Button Text Color

Setting Button Text Color

Using the GUI

1. In Advanced Settings select UI Settings >

Edit Footer, Edit Dashboard or Edit In-Call

2. Select a button. A yellow box appears around

the selected button.

3. Touch Edit.

4. Touch the FG button.

5. Select a color and touch Set.

6. Touch the Back button to return to the WFC

Voice Client home screen.

Using XML

<fg_color>#FFFFFFFF</fg_color> </Button>

Settings

Global Button Color Settings

Global Button Background Color

Use Global Button Background Color to set the color of all buttons on the dashboard. The button color can be overridden by the individual Button Background Color. The default background color is dark gray (#FF001425).

Figure 41 Button Background Color

Setting Button Background Color

Using the GUI

1. In Advanced Settings select UI Settings.

2. Select Button Background color.

3. Select a color from the color wheel for the

button background or enter RGB color in hex format.

4. Touch Set.

5. Touch Back button to return to the WFC

Voice Client home screen.

Using XML

<gbg_color>#FF001425</gbg_color> </Profile> ... </WFConnect>

Settings

Global Button Text Color

Use Global Button Text Color to set the color of all buttons on the dashboard. The button color can be overridden by the individual Button Text Color. The default text color is white (#FFFFFFFF).

Figure 42 Button Text Color

Setting Button Text Color

Using the GUI

1. In Advanced Settings select UI Settings.

2. Select Button text color.

3. Select a color from the color wheel for the

button text or enter RGB color in hex format.

4. Touch Set.

5. Touch Back button to return to the WFC

Voice Client home screen.

Using XML

<gfg_color>#FFFFFFFF</gfg_color> </Profile> ... </WFConnect>

Settings

Reset Colors to Default

To reapply the factory default button colors:

1. In Advanced Settings select UI Settings > Reset colors to default.

2. Touch the Back button to return to the WFC Voice Client home screen.

Restore Buttons

To reapply the factory default buttons and their layout:

1. In Advanced Settings select UI Settings > Restore buttons.

2. Touch the Back button to return to the WFC Voice Client home screen.

Call Settings

This section provides detailed information on configuring advanced call settings.

To configure call settings:

1. Touch the menu button, then Settings. The password dialog box appears.

Figure 43 WFC Voice Client Menu

Settings

2. Enter password (default: zamboni).

3. Touch Enter.

Figure 44 WFC Voice Client Settings Menu

4. Touch Advanced Settings > Call Settings.

Call Waiting Volume

Set the Call Waiting Volume setting.

Settings

Using the GUI

1. In Advanced Settings select Call Settings.

2. Slide the Call Waiting Volume slider (default

80).

3. Touch Back to return to the WFC Voice Client

home screen.

Using XML

<callwaiting_volume>80</callwaiting_

volume> </Profile> ... </WFConnect>

Call Waiting Interval

Set the Call Waiting Interval setting.

Settings

Using the GUI

1. In Advanced Settings select Call Settings.

2. Slide the Call Waiting Interval slider (default

2000).

3. Touch Back to return to the WFC Voice Client

home screen.

Using XML

<callwaiting_interval>2000</callwait

ing_interval> </Profile> ... </WFConnect>

Ringer OFF In Charger

Enable Ringer OFF in Charger to disable the ringer while the device is charging.

Using the GUI

1. In Advanced Settings select Call Settings.

2. Select the check box next to Ringer OFF in

Charger to enable this (the default is

Disabled).

3. Touch Back to return to the WFC Voice

Client home screen.

Using XML

<ringer_off_in_charger>false</ringer

_off_in_charger> </Profile> ... </WFConnect>

Disable Speaker mode

Enable Speaker Mode to answer all incoming calls in speaker mode when the device is placed on a horizontal surface, such as a desk.

Using the GUI

1. In Advanced Settings select Call Settings.

2. Select the check box next to Disable

Speaker Mode to enable this (the default is

Disabled).

3. Touch Back to return to the WFC Voice

Client home screen.

Using XML

<disable_speaker>false</disable_spea

ker> </Profile> ... </WFConnect>

Settings

Speaker on table

Enable Speaker Mode to answer all incoming calls in speaker mode when the device is placed on a horizontal surface, such as a desk.

Using the GUI

1. In Advanced Settings select Call Settings.

2. Select the check box next to Speaker on

table to enable this (the default is Disabled).

3. Touch Back to return to the WFC Voice

Client home screen.

Using XML

<speaker_on_horizontal>false</speake

r_on_horizontal> </Profile> ... </WFConnect>

Settings

Accept-Reject Buttons Sliding Tab Glow Pad

Call Accept Style

There are various call accept styles on the incoming call screen, such as simple accept and reject buttons, a slider (Gingerbread Android), and Glow Pad buttons (JellyBean Android).

• Accept-Reject - The operator touches one of two buttons to accept or reject an incoming call.

• Slider - The operator swipes one of two buttons across the screen to accept or reject an incoming call.

• Glow Pad - The operator touches a handset symbol to accept or reject an incoming call.

Figure 45 Call Accept Buttons

Zebra Workforce Connect: Voice Client Workforce Connect Voice Client 8.2.x Administrator Guide for IP Office

Specifications and Main Features

Frequently Asked Questions

User Manual

Copyright

Terms of Use

Revision History

Table of Contents

About This Guide

Introduction

PBX Integration Statement

Notational Conventions

Related Documents and Software

Service Information

Configuring the Client

Introduction

Determine Deployment Readiness

Connect Android Wireless Device to Network

Install Workforce Connect Voice Client

Download and Install Board Support Package (BSP) Operating System

Download and Install Android Application Packager (APK) Client

Installing the APK Manually

Installing the APK Using ADB Commands

Create a Shortcut for the Workforce Connect Voice Client

Open Workforce Connect Voice Client

Activate Workforce Connect Voice Client

Activate Using an Activation Key

Activate Using an MDM

MDM Deployment

Activate Using a USB Tether

Update License

Configure Workforce Connect Voice Client

Configure Using the WFC Voice Client GUI

Configure Using an MDM

MDM Deployment

Configure Using a USB Tether

Configuring the PBX

Introduction

Collect Necessary Information

Open the Avaya IP Office Web Manager

Add New SIP User

Add User Credentials

Setup Extension (If not already configured)

Edit User Properties

Check Device Settings

Dynamic Configuration

Introduction

Overview

General Device Use Cases

Device Start-Up

Device Identification

Profile Configuration

Connection Attributes

Dynamic Configuration

Enabling Dynamic Configuration

Wcfvariable.xml File

XML File Location

DHCP Option 150

Configuration Resynchronization

Dynamic Configuration Start-Up - Server Side

Dynamic Configuration Start-Up - Client Side

XML File Examples

Testing Remote Dynamic Configuration

Settings

Introduction

Exiting WFC Voice Client:

Reloading WFC Voice Client:

Profile Settings

Create Profile

Change Profile Name

Shared Profiles URI

Load New Profile

Loading a New Profile Using the GUI

Loading a New Profile Using XML

Installing the APK Using ADB Commands

Save Current Profile

Edit a Profile Using XML

Connection Parameters

Configuring Multiple PBX Types

Audio Settings