Zebra Workforce Connect: Interworking Gateway Workforce Connect Interworking Gateway V2 Customer Administrator Guide
Page 1
Workforce Connect
Interworking Gateway V2
Customer Administrator
Guide
MN-004003-01EN
Page 2
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.
© 2020 Zebra Technologies Corporation and/or its affiliates. All rights reserved.
Information in this document is subject to change without notice. The software described in this document
is furnished under a license agreement or nondisclosure agreement. The software may be used or copied
only in accordance with the terms of those agreements.
For further information regarding legal and proprietary statements, please go to:
SOFTWARE:http://www.zebra.com/linkoslegal
COPYRIGHTS:http://www.zebra.com/copyright
WARRANTY:http://www.zebra.com/warranty
END USER LICENSE AGREEMENT: http://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.
Publication Date
September 24, 2020
2
Page 3
Contents
About This Guide................................................................................................................................ 5
Notational Conventions.................................................................................................... 5
Service Information .......................................................................................................... 5
Overview.............................................................................................................................................. 6
Introduction ...................................................................................................................... 6
PTT Pro Interworking ....................................................................................................... 6
PTT Pro Interworking Example................................................................................. 7
Licensing.......................................................................................................................... 8
Activation ............................................................................................................................................ 9
Logging in to the IWG ...................................................................................................... 9
Activating the IWG ........................................................................................................... 9
Configuration .................................................................................................................................... 11
Configuring Endpoints.................................................................................................... 11
Configuration Example ........................................................................................... 11
Configuration Methods.................................................................................................. 13
IWG Manager GUI.................................................................................................. 13
IWG Manager - Import a Configuration File............................................................ 13
Importing a Configuration File .......................................................................... 13
IWG Manager REST APIs ...................................................................................... 14
Configuration Parameters .............................................................................................. 14
Using the IWG Manager ................................................................................................................... 15
IWG Manager................................................................................................................ 16
Sites ............................................................................................................................... 16
Pro Endpoints................................................................................................................. 16
Pro Endpoints Page................................................................................................ 17
3
Page 4
About Pro Endpoints............................................................................................... 18
Adding a Pro Endpoint............................................................................................ 18
Sending an Announcement .................................................................................... 19
Sending a Message................................................................................................ 19
Pro Tasks....................................................................................................................... 19
Calls History................................................................................................................... 20
Events ............................................................................................................................ 20
Stats............................................................................................................................... 21
License........................................................................................................................... 21
Adding a License Code .......................................................................................... 21
Portal Users ...................................................................................................................22
User Roles.............................................................................................................. 22
User Info ................................................................................................................. 22
Resetting the API Token .................................................................................. 23
Changing Your Password ................................................................................ 23
4
Page 5
About This Guide
This guide provides information about how to operate the Zebra Workforce Connect Interworking Gateway
V2.
Screens and windows pictured in this guide are samples and can differ from actual screens.
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.
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:
• Licensing information
• Software version.
Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.
If you purchased your Zebra business product from a Zebra business partner, contact that business
partner for support.
.
5
Page 6
Overview
PTT Pro
“Help needed
in Aisle 2!”
IWG
PTT Pro
“Team meeting
in 10 minutes”
IWG
Introduction
The Zebra Workforce Connect Interworking Gateway (IWG) allows third party applications to submit audio
files or text messages to PTT Pro individuals or groups. PTT Pro is a server-based Push-to-Talk service
supporting individual and group communications.
The IWG supports interworking via APIs:
• Announcer REST APIs - Allows audio messages to be submitted to the IWG with the target endpoints.
The audio message is processed and immediately broadcast to available target endpoints. Endpoints
which are not available at the time of the broadcast do not receive the message.
• Messenger REST APIs - Allows text messages to be submitted to the IWG with the target PTT ProText
endpoints. The audio text is processed and sent to the target PTT Pro endpoints. The PTT Pro system
can store text messages. Target endpoints which are not available at the time of the broadcast will
receive the text message when they become active again in PTT Pro.
Text interworking is currently only supported from external applications to the PTT Pro Text endpoint.
Text messaging in the reverse direction is not supported.
Figure 1 Interworking APIs
PTT Pro Interworking
PTT Pro is a Push To Talk system supporting group and individual communications for both audio and text
messaging. It supports several advanced features including late join and priority override. PTT Pro is
supported via an app on the end user device which communicates with server infrastructure.
To send an audio or text message from the IWG to PTT Pro, a destination group or individual is configured
in the IWG as a PTT Pro endpoint. In order for the PTT Pro endpoint to reach the destination PTT Pro
group or user, the IWG must communicate with the PTT Pro server using a proxy user, or a proxy client.
The PTT Pro server is not aware that the proxy client is not being used as a normal PTT Pro user. The
proxy client acts like any other PTT Pro user, but instead of running on a device, it runs on the IWG and
forwards communications from the Messenger and Announcer APIs.
6
Page 7
Proxy clients must be configured in PTT Pro as users, and have an associated PTT Pro user client running
on the IWG. If the appropriate configuration information is provided when a PTT Pro endpoint is added, the
IWG adds the proxy client to the PTT Pro server automatically.
PTT Pro Interworking Example
In the following example, the enterprise owner desires to connect the PTT Pro group Hardware to other
IWG endpoints.
Figure 2 PTT Pro Audio Interworking
Overview
For this example, the customer admin adds an endpoint to the IWG with the following information:
• Endpoint name - PTT_Pro_Hardware
• Group name - Hardware
• Proxy client name - Hardware_Proxy
• PTT Pro server information.
The IWG performs the following actions:
1. The IWG adds a user to PTT Pro with the specified proxy client name, in this case Hardware_proxy.
2. If this proxy client is communicating with a group, the IWG adds the proxy client to the specified group.
In this case, the group is called Hardware. If the group does not yet exist, the IWG creates the group.
3. The IWG then adds the endpoint to the IWG with a proxy of Hardware_proxy.
As a result of adding Hardware_proxy as the proxy client, the IWG registers with the PTT Pro server as the
user Hardware_proxy. It also verifies that the Hardware group exists, and if not, the IWG creates the group.
After this setup, whenever the PTT Pro group Hardware starts a group call, the PTT Pro server includes
the user Hardware_proxy and routes control and audio to the IWG. The IWG forwards the communication
from Announcer or Messenger to this PTT Pro endpoint.
Note that when communication is forwarded from Announcer and Messenger to the Hardware group, the
originator is identified by the name of proxy – in our example, this is Hardware_proxy.
A proxy may be used with multiple PTT Pro endpoints. However, only one audio message
(Announcement) using that proxy may occur at any time. If an audio communication comes in for a PTT
Pro endpoint whose proxy is employed in another audio communication, the second audio communication
will fail.
7
Page 8
Licensing
Overview
PTT Pro endpoints are licensed in the IWG. The PTT Pro Proxy users are NOT licensed in the IWG;
however, since they appear as normal users to the PTT Pro system, each proxy user consumes a PTT Pro
user license when it is configured in the PTT Pro system.
The IWG V2 is included with your PTT Pro purchase. Each endpoint added in the IWG uses one PTT Pro
license. Before adding endpoints in the IWG, ensure the necessary PTT Pro licenses are available in the
PTT Pro portal.
For information on how to view licenses, see License on page 21.
8
Page 9
Activation
This chapter describes how to log in and activate the IWG.
To access the IWG Manager, use a host computer with one of the following supported web browsers.
Mobile browsers are not supported.
• Chrome 63 or higher
• Internet Explorer 11 or higher
• Firefox 44 or higher
• Safari 11 or higher
• Edge 16 or higher
Logging in to the IWG
Log in to the IWG using a supported web browser.
When a new user is added to the IWG, an email is automatically sent to the user’s email address
containing a link to set their password.
1. In the email from the Zebra IWG Manager, click the link to set your password.
The Reset Password popup displays.
2. In the New Password field, enter a new password. The password must be at 8 to 40 characters long,
contain at least one digit, one lower case, one upper case, and one special character (! @ # $ % .).
3. In the Confirm Password field, re-enter the password.
4. Select Submit.
Links to set or reset a user’s password expire after approximately one hour. To send a new link, see Portal
Users on page 22.
Activating the IWG
Use the IWG Manager to add licenses to the IWG. In some instances, licenses may have already been
added by your Zebra administrator.
1. In the IWG Manager, select License from the left menu.
2. From the Actions menu, select +.
9
Page 10
Activation
Figure 3 Adding a License
3. In the License Code field, enter the license code provided in the Zebra software entitlement email.
4. In the Count field, enter the number of times to activate the license.
5. Select Add.
10
Page 11
Configuration
This section explains how to configure the Zebra Workforce Connect Interworking Gateway (IWG).
Configuring Endpoints
Before configuring endpoints, ensure that all required Sites (PTT Pro departments) are configured in the
IWG Manager. For more information contact your Zebra administrator.
• Configure endpoints to identify the target PTT Pro user or group. Endpoints must specify a proxy user
name and a Site.
Configuration Example
The following flow chart shows how Sites added in the IWG correspond to departments in the PTT Pro
server. It also shows that when adding PTT Pro groups as endpoints, the IWG adds the group (if
necessary), then adds the proxy user. A proxy user is first added as a PTT Pro user and then as a member
of the group.
In the following flow chart, the Hardware group is added to the IWG as an endpoint. First, it is added as a
proxy user with Proxy_hardware as the proxy name. Then, it is added as a member of the Hardware group.
11
Page 12
Figure 4 Configuration Flow Chart
PTT Pro Server
Department
Groups:
Hardware Group
User1.ID
User2.ID
.
.
Proxy_hardware
Users
.
.
User1.ID
User2.ID
User3.ID
Proxy_hardware
IWG
Site
Corresponds to PTT Pro department.
G
w
a
Endpoints
Corresponds to PTT Pro user or group.
Admin adds an endpoint by specifying
endpoint name, target user/group name,
proxy name and site name.
Configuration
12
Page 13
Configuration Methods
Configure the IWG using the following methods:
• Using the IWG Manager Graphical User Interface (GUI).
• Using the IWG Manager to Import a configuration file.
• Using the IWG Manager REST APIs to manage endpoints or import a configuration file.
IWG Manager GUI
Use the IWG Manager to:
• Configure endpoints
• View sites
• View PTT Pro tasks
• View call log
• View event log
• View system statistics
Configuration
• Configure licensing
• Configure portal users
For more information on the IWG Manager and available configuration actions, see Using the IWG
Manager on page 15.
IWG Manager - Import a Configuration File
Use the import feature in the IWG Manager GUI to import an XML configuration file.
It is highly recommended to release licenses before using a configuration file to modify activation IDs. To
release licenses using the IWG Manager, see License on page 21.
If licenses are not properly released and become unusable, contact Zebra support and have your
activation ID available.
Importing a Configuration File
Create an XLS configuration file and then import it using the IWG Manager GUI.
The configuration file must be a spreadsheet in XLS format with up to three sheets. If no configuration
changes are required for a sheet, leave that sheet empty. For descriptions of the parameters in the XLS
configuration file, see Configuration Parameters on page 14.
A template for the XLS configuration file is available for download through the IWG Manager REST API’s
Import Controller. For more information, refer to the Workforce Connect IWG Manager REST API
Developer’s Guide.
1. Log in to the IWG Manager.
2. From the IWG Manager header menu, select Import.
3. Before selecting a file to import, set the following optional parameters.
• If desired, enable the Delete all existing records to remove all previously imported configuration
information.
13
Page 14
• If desired, enter a comma separated list of sites to reset and import.
When entering multiple sites, make sure there are no spaces in the list.
4. Drag and drop the XML configuration file, or select Import to browse for the file.
The file loads and the total records imported displays.
5. Select Close to return to the IWG Manager.
IWG Manager REST APIs
Use the IWG Manager REST APIs to manage endpoints or import an XLS configuration file. To try out the
REST APIs, select APIs from the IWG Manager header menu.
For details on using the IWG Manager REST APIs to configure the IWG Manager, refer to the Workforce
Connect IWG Manager REST API Developer’s Guide.
Configuration Parameters
The following table describes the configuration parameters for the IWG Manager.
Configuration
Table 1 Configuration Parameters
Sheet Name Column Name Description
Endpoints site Name of the site where this endpoint is located.
name Name of the endpoint in the IWG.
proxy PTT Pro proxy user name associated with this endpoint. Must be
made up of letters, numbers, and “.”s, and between 3-25
characters long.
target Target of the target user or group name in PTT Pro.
contact Indicates if the target is a contact or group. Set to true if the
target is a user, or set to false if the target is a group.
userPriority Optional proxy user priority (default - 0).
groupPriority Optional group priority (default - 0).
Licenses code Activation ID (AID) formated as
xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx. The activation ID is
found in the Zebra Software Licensing entitlement email. Make
sure to use the Activation ID (AID), and not the Entitlement ID
(EID).
count Number of licenses to claim for the activation code. For example,
an AID could include 50 IWG groups. To activate all 50 groups,
set the count field to 50.
Users name Name of the user.
email User’s email address. This is used as the username to log in to
the IWG Manager.
role Role of the user in the IWG Manager. See Portal Users on
page 22.
14
Page 15
Using the IWG Manager
The IWG provides a Graphical User Interface (GUI) allowing the administrator to enable interworking between
services managing PTT Pro endpoints.
Figure 5 IWG Manager Screen
Table 2
Item Description
1 Left menu
2 Header menu
3 Actions menu
4 Main Window
15
Page 16
IWG Manager
Use the IWG Manager to add endpoints, map between endpoints, modify licensing information, perform
administrative actions, and display logs. The management portal is divided into the following tabs:
• Sites on page 16
• Pro Endpoints on page 16
• Pro Tasks on page 19
• Calls History on page 20
• Events on page 20
• Stats on page 21
• License on page 21
• Portal Users on page 22
Options and information displayed varies depending on the user role. To view information about the
currently logged in user account, select the user name from the header menu bar. For information on how
to view, add, and modify all users, or how to change your password, see Portal Users on page 22.
Using the IWG Manager
Sites
The Sites page lists available PTT Pro departments. To edit, add, or remove sites, contact your Zebra
administrator.
• Actions menu - Buttons used to perform actions on or filter sites. Click on a site to select it.
• - Refresh the list of sites.
• - Restart all endpoints on the selected site.
• Verify/Update Pro Server - Enable to sync the data of all endpoints on the site with the Pro
Server.
• Clear Public Key - Enable to clear the public key.
• - Resume all endpoints on the selected site.
• - Pause all endpoints on the selected site.
• Show All - Enable to show all sites, including sites without endpoints.
• Name Filter - Use this field to filter the list of sites by a specific site ID or site name.
• Main window - Provides information for each site.
• Site ID/Name - Name assigned to the site when it was added.
• Endpoints Count- Displays the number of endpoints added to this Site.
Pro Endpoints
Use the Pro Endpoints page to view, add, and modify endpoints. The Pro Endpoints page displays a list
of all available endpoint types.
To add an endpoint, from the actions menu select +. For detailed information on adding endpoints, see
Adding a Pro Endpoint on page 18.
16
Page 17
Endpoints may also be referred to as resources. For example, the PttPro Audio endpoint may also be
referred to as the PttPro Audio resource. Resources display as licensed endpoints on the License tab, and
are configured as endpoints on the Endpoints tab.
Pro Endpoints Page
Use the Pro Endpoints page to add, modify, or delete endpoints.
• Actions menu - Buttons used to perform actions on or filter endpoints. To select one or more endpoints,
check the box to the left of the endpoint ID.
• - Refresh the list of endpoints.
• - Add an endpoint. See About Pro Endpoints on page 18 for more information.
• - Delete an endpoint.
• - Reload the selected endpoints.
• Verify/Update Pro_data - Enable to sync the IWG’s endpoint data with the Pro Server.
• Clear Public Key - Enable to clear the IWG’s public key. Use this option if the endpoint is
showing an authentication error.
Using the IWG Manager
• - Send an audio announcement to the selected endpoints.
• - Send a text message to the selected endpoints.
• - Pause the selected endpoints.
• Endpoint statistics - Quickly view the total number of endpoints, the number of licenses belonging to
a customer, and the number of endpoints that are not registered.
• Site Filter - Use this drop-down menu to filter the list of endpoints by type, name, or information.
• Name/Site/Pro Filter - Use this field to filter the list of endpoints by a specific endpoint name, site,
or Pro server.
• Main window - Provides information for each endpoint.
•ID- A unique ID of the endpoint. The IWG automatically assigns an ID to a new endpoint when it is
added via the IWG management portal.
• - Edit the settings for an endpoint.
•State- The state of the endpoint is shown as a colored icon.
• red - UNREGISTERED
• red and gray - NOT LICENSED
• blue - AUTHENTICATING
• green - IDLE or REGISTERING
• orange - IN_CALL.
The endpoint is receiving/sending audio or in the active session. This depends on endpoint type
and is updated in real-time.
The IN_CALL state only applies to calls originating from the IWG.
• yellow - The endpoint cannot reach a green state even after it is reloaded.
17
Page 18
Using the IWG Manager
• - PAUSED
•Mode- An icon defines the audio mode for the endpoint. This is updated in real-time.
• Idle
• Receiving
• Sending
• Not licensed
•Info - A description of the current endpoint state.
•Site - Name of the site where this endpoint is located. See Sites for more information.
•Pro - Name of the PTT Pro server associated with this endpoint. See Sites for more information.
•Name- Name of the endpoint in the IWG. Set when a new endpoint is added.
• Proxy User - PTT Pro proxy user name associated with this endpoint. Must be made up of letters,
numbers, and “.”s, and between 3-25 characters long.
• Proxy ID - The proxy ID (optional).
•Target- Name of the endpoint in PTT Pro.
• Mapping - Not supported.
• LogLevel - The log level of the endpoint. The logging level for each endpoint can fine tuned (OFF,
SEVERE, WARNING, INFO, FINE, FINER, FINEST). ALARM is the lowest log level.
About Pro Endpoints
A PTT Pro account is required to use a PTT Pro endpoint. For information on configuring PTT Pro, refer to
the PTT Pro Management Portal Customer Administrator Guide.
PTT Pro supports multiple group types. When PTT Pro surveillance and unicast groups are configured as
PTT Pro endpoints, communication is only in one direction, from the IWG to PTT Pro. Use surveillance and
unicast groups to send IWG initiated communication, such as announcements and text messages. For a
definition of PTT Pro group types, refer to the PTT Pro Management Portal Administrator Guide.
The PTT Pro endpoint represents a group or individual from the PTT Pro system. To communicate with the
PTT Pro system, the IWG creates a proxy client that is configured as a user on the PTT Pro server. The
proxy client connects PTT Pro endpoints to other endpoints, such as announcer.
Multiple PTT Pro endpoints may share the same proxy client. However, PTT Pro endpoints sharing the
same proxy can not be active in audio communications simultaneously.
When a PTT Pro endpoint is deleted in the IWG, the associated proxy client is not automatically deleted
from PTT Pro.
Adding a Pro Endpoint
Add a Pro endpoint from the Pro Endpoints page of the IWG Manager.
1. Ensure that the necessary Pro Server and Site are configured. If these are already configured, skip this
step.
a. On the Pro Servers page, select from the Actions menu.
b. On the pop-up dialog, enter the required information. Fields marked with a dot are required.
18
Page 19
c.
Select Add.
d. On the Sites page, select from the Actions menu.
e. On the pop-up dialog, enter the required information. Fields marked with a dot are required.
f. Select Add.
2. On the Pro Endpoints page, select from the Actions menu.
3. On the pop-up dialog, enter the required information. Fields marked with a dot are required.
When entering a Proxy User, use letters, numbers, and “.”s, and it must be between 3-24 characters
long.
Do not enter a value in the Mapping field.
4. Select Add.
Sending an Announcement
Announcements are sent from third party applications or from the IWG Manager.
To send announcements from a third party application, use one of the following APIs:
Using the IWG Manager
• Announcer REST API - Refer to the Announcer REST API document for more information.
To send announcements from the Pro Endpoints page of the IWG Manager:
1. Select one or more endpoints by checking the boxes to the left of the endpoint ID.
2. From the Actions menu, select .
3. On the pop-up dialog, select Select WAVE file, navigate to the WAV file, and select Open.
Or, drag and drop a WAV file.
After the announcement is sent, the call is immediately ended and may appear as a missed call to PTT
Pro recipients.
Sending a Message
Messages are sent from third party applications or from the IWG Manager.
To send messages from a third party application, use the Messenger REST API. Refer to the Messenger
REST API Developer’s Guide for more information.
To send messages from the Pro Endpoints page of the IWG Manager:
1. Select one or more endpoints by checking the boxes to the left of the endpoint ID.
2. From the Actions menu, select .
3. On the pop-up dialog, enter a text message.
Pro Tasks
4. Select Select image file to attach an image to the message (optional).
Or, drag and drop a WAV file.
5. Select Send.
Pro Tasks lists all tasks performed by the IWG.
19
Page 20
Using the IWG Manager
• Actions menu - Buttons used to perform actions on or filter Pro tasks.
• - Refresh the list of servers.
• Name Filter - Use this field to filter the list of servers.
• Main window - Provides information for each task.
•ID - System assigned ID number of the task.
• Created - Time stamp of when the task began.
• ProJob ID/Name - Short description of the task.
•State - Green if the task was completed or red if it failed.
•Key - Proxy name of the endpoint in PTT Pro.
• Endpoint - Name of the IWG endpoint.
• Pro Server - Pro server on which the task was performed.
• Retries - Number of times the task was attempted.
•Info - Provides a reason if the task failed.
Calls History
This page lists all call transactions that take place in this IWG. The following fields display for each audio
transaction:
• Actions menu - Buttons used to perform actions on or filter Pro tasks.
• - Refresh the list of servers.
• Name Filter - Use this field to filter the list of servers by endpoint name.
• Show All - Displays all audio transactions. Uncheck to only display errors.
• Main window - Provides information for each call.
• Created - Time stamp of when the transaction started.
• Source - Indicates the user who initiated the event.
• Forwarded To - A list of target endpoints to which messages and announcements are forwarded.
•Failed- Displays a reason that a message or announcement failed.
•Duration- Duration of the call in seconds.
Events
This page displays logging messages from IWG. It is updated in real-time. The following actions are
available on the Events page:
• Actions menu - Buttons used to perform actions on or filter events.
• - Refresh the list.
• User Filter - Use the drop-down menu to filter log messages by user.
• Event Filter - Use the drop-down menu to filter log message by event type.
• Main window - Provides information for each event.
•ID - System generated ID of the event.
20
Page 21
Stats
Using the IWG Manager
•Timestamp - Time stamp of when the event started.
•User - User who initiated the event.
•Event - Description of the event.
•Info - Information entered by the user during the event.
To configure logging levels for each endpoint, go to the Pro Endpoints page and select .
This page lists all announcer and messenger transactions that take place in this IWG. The following fields
display for each transaction:
• Actions menu - Buttons used to perform actions on or filter events.
• - Refresh the list.
• Name Filter - Use this field to filter stats by the stat name.
• Main window - Provides information for each statistic.
•Name - System generated name of the event.
License
•Value - Displays the number of transactions.
• Updated - Time stamp of when the transaction was completed.
The License page lists all IWG license codes on the left side of the page.
IMPORTANT: Do not make any changes to the licensing information. This page is for reference only.
• Main window - Provides information for each license code.
•AID - Preview of the license code.
• Count - Total number of number of licenses acquired for this code.
•Feature - Name of the feature.
• Version - Version of the feature.
• Count - Total number of licenses acquired for this feature.
•Issued - Date the feature was added.
• Expires - Expiration date of the feature.
•State - Current state of the license.
•AID - Preview of the license code associated with this feature.
Adding a License Code
Each license code provides additional licenses for the IWG. License codes may also be referred to as
activation codes in your entitlement email.
1. From the License page, select .
2. Enter the license code.
21
Page 22
3.
4. Select Add.
Portal Users
Use the Portal Users page to manage IWG Manager users.
• Actions menu - Buttons used to perform actions on or filter endpoints. To select one or more endpoints,
Using the IWG Manager
To enter a single license multiple times, enter number of times to retrieve the license in the Count field.
check the box to the left of the endpoint ID.
• - Refresh the list of users.
• - Add a new user. See User Roles on page 22 for more information.
• - Select a user, then select the edit button to modify their information.
• - Select a user, then select the delete button to remove a user.
• - Select a user, then select the reset button to reset that user’s password. An email is sent to the
user with information on how to reset their password.
• Name Filter - Use text field to search for a user.
• Main window - Provides information for each user.
User Roles
User roles determine what information and options are available to a user in the IWG Manager.
Table 3 User Roles
Pro Endpoints Can add, modify, and view Can modify and view View only
Sites View only View only View only
Pro Tasks View only View only View only
Calls History View only View only View only
Events View only View only Not available
Stats View only View only View only
License Can add, modify, and view Not available Not available
Portal Users Can add, modify, and view Not available Not available
•User Role- Options and information displayed in the IWG Manager varies depending on the user
role.
• User Name - Displays the user name.
• Login/Email - Displays the user’s email address. Use this email address to log in to the IWG
Manager. When the user’s password is reset, an email is sent to this email address.
Page Super-Admin Admin User
User Info
View information about the currently logged in user by selecting the user name from the header menu.
22
Page 23
Resetting the API Token
Super-Admins can view or reset the API Token by selecting Reset token from the User Info popup.
The API Token is required for sending messages or announcements using the Messenger REST API or
Announcer REST API. For more information, refer to the Workforce Connect Messenger REST API
Developer’s Guide and the Workforce Connect Announcer REST API Developer’s Guide.
Changing Your Password
It is recommended to change your password regularly for security purposes.
1. Select your name from the Header menu.
2. Select Change password.
3. Enter the required information.
4. Select Submit.
Using the IWG Manager
23
Page 24
www.zebra.com
Loading...