Editing Users
To edit an existing user, go to the Users screen and click Edit to the right of the username.
![](../../../__attachments/109529960/2022-02-02_15-28-50.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
The user configuration screen will display.
After manually adding a new user, the configuration screen for the user displays automatically.
Details
The Details tab allows for the configuration of basic user settings, the same as were configured during the user creation process. Settings, which were not configured during the user creation process or were not imported from the external system, may be added now. The username cannot be changed.
![2024-02-14_14-31-38.png](../../../__attachments/109529960/2024-02-14_14-31-38.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Configure as necessary:
Email – email address of the user (Not mandatory; however, it is recommended that a valid email address be entered. This is especially important as the email address is used to send notifications and to reset passwords.)
First Name – first name of the user
Last Name – last name of the user
Time zone – time zone of the application (when not selected, the value from Realm Settings is used), find out more on the Adding New Users page
User Enabled – by default a new user is enabled, the switch allows for deactivation of the user, find out more on the Activating and Deactivating Users page
User Temporarily Locked – user can get temporarily locked after several unsuccessful login attempts, the switch allows to activate the user, find out more on the Activating and Deactivating Users page
Email Verified – if the user's email address was verified or not
Required User Actions – actions required after user's login, find out more on the Adding New Users page
Locale – language of the application (when not selected, the default language is English)
For the users who were imported from external systems, additional settings are displayed (these settings are not visible for manually created users):
Secondary email – other email address(es), only if this attribute was imported from the external source (more emails can be imported, in such a case, they are numbered, for example,
Secondary email #1
)Phone – phone number(s), only if this attribute was imported from the external source (maximum five phone numbers can be imported, in such a case, they are numbered, for example,
Phone #1
)Synchronization enabled – by default, synchronization with an external system is enabled; the switch allows you to disable synchronization
Federation Link – redirects to a configuration of the external system from which the user was imported
![2022-05-16_10-40-01.jpg](../../../__attachments/109529960/2022-05-16_10-40-01.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Most of the fields are self-explanatory. In case of any doubts, hover the mouse pointer over the exclamation mark to display a descriptive tooltip.
Attributes
Apart from basic user metadata like name and email, arbitrary user attributes can be stored in the system. To configure attributes manually, go to the Users screen, select a user, click the Edit button, and click the Attributes tab.
![2024-02-14_14-34-54.png](../../../__attachments/109529960/2024-02-14_14-34-54.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Enter the attribute name and value in the empty fields and click the Add button to add a new field. Click Save to confirm and add the attribute.
Adding Phone Extension and Agent ID
Additional attributes that can be added manually include:
phoneExtension – Type a phone extension of the user (required to match agents to calls correctly)
agentId – Type an identification number of an agent, if it exists (required to match agents to calls correctly)
These attributes are configured locally but are independent of the synchronization process. It means that attributes added for users imported from external systems will not be overwritten or removed during the next synchronization process.
Importing Attributes
If an external user (imported from UCCE/X or CUCM) has the phoneExtension and/or secondaryEmail attributes configured in the external system, these attributes will be imported as well. They will be displayed on the Attributes and the Details tabs.
![2022-02-28_14-00-03.jpg](../../../__attachments/109529960/2022-02-28_14-00-03.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
The attributes are displayed as strings where values are divided by the ##
signs. On the Details tab, these values are shown separately.
For example, a user can have two phone numbers imported, and they will be displayed as a string 123456##456789
(where one phone number is 123456
and the second is 456789
):
![](../../../__attachments/109529960/2022-02-28_14-19-08.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
On the Details tab, these values will be displayed as Phone #1
and Phone #2
:
![](../../../__attachments/109529960/2022-02-28_14-22-30.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Multiple extensions are not currently used to identify agents in Quality Management.
Similarly, if an external user imported from Webex Contact Center has the ciUserId attribute configured in the external system, this attribute will be imported as well to enable the reception of agent adherence events (used by the RTA functionality in WFM).
![2023-03-15_14-20-12.jpg](../../../__attachments/109529960/2023-03-15_14-20-12.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Any manual changes to the attributes imported from external systems will be overwritten or removed during the next synchronization process.
Credentials
To set a password for a new user, go to the Credentials tab on the management page of the user.
![2024-02-14_14-36-28.png](../../../__attachments/109529960/2024-02-14_14-36-28.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Type in a new password in the Password and Password Confirmation fields. Click the View icon on the right to preview the password. By design, the system requires that enhanced complex passwords be used (it applies to temporary passwords as well). See the Managing Password Policies page for more details.
Use the Temporary switch to decide if the password can be used once or multiple times:
the switch is on – password can only be used once and the user will be asked to change their password after they have logged in
the switch is off – the user will not be asked to change their password
The Set password button will activate after typing the password in. Click it to confirm. A new window will display, confirming the change. Click Set password to confirm.
![](../../../__attachments/109529960/2022-05-16_10-01-56.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
The "Success! The password has been set" notification will display.
It is not necessary to set a new password for a new user. New users can set the password themselves using the Forgot Password link if a valid email address is associated with the user.
Role Mappings
Open the Role Mappings tab to assign composite roles to a new user. Composite roles are a predefined set of effective roles (privileges to use particular functionality of the application, for example: view a schedule, edit a forecast, upload a file) and they are defined separately for each client application. A new user has no roles assigned.
![2024-02-14_14-37-57.png](../../../__attachments/109529960/2024-02-14_14-37-57.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
To assign or unassign roles, follow the steps described on the Assigning Roles page.
Groups
On the Groups tab, the user can be added to any available group(s).
![2021-01-11_11-12-06.jpg](../../../__attachments/109529960/2021-01-11_11-12-06.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
To search for a group in the group database, fill in the name, or a part of it, in the search box and click the Enter key. The query brings up all groups that match the entered criteria. To list all groups that exist in the system, click the View all groups button.
Click on a group name to select it in the Available Groups section, and then click Join.
![](../../../__attachments/109529960/2021-01-11_11-10-54.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
The added group will be listed in the Groups Membership section. If it is the first group to which the user belongs, it will be set as the main group.
![](../../../__attachments/109529960/2021-01-11_11-12-06.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
The Quality Management application recognizes membership in one group only. This group should be marked as a 'main' group in User Management. If users were imported from external systems, like UCCX or UCCE, consider carefully if their group membership and/or the main group selection should be manually modified from within User Management.
The following rules apply to setting the main group in User Management:
If a user is a member of one group only, this group is set as the main.
In case a user is a member of more than one group, only one group can be set as the main.
If a user is removed from the main group, the first group from available groups sorted alphabetically will be set as the new main group.
To select a different main group, click on a group name in the Group Membership section and click the Set as main button.
![](../../../__attachments/109529960/2020-09-16_10-48-32.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
As a result, this group will be set as main.
![](../../../__attachments/109529960/2020-09-16_10-49-45.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
To remove the user from a group, click to select a group name, and then click Leave.
![](../../../__attachments/109529960/2020-09-16_10-51-09.jpg?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Can Manage
To assign the user groups, which she/he can manage in Quality Management, go to the Can Manage tab.
![2024-02-14_14-41-03.png](../../../__attachments/109529960/2024-02-14_14-41-03.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
Note that groups can be assigned to all users, but additionally, certain roles are necessary to be able to perform a review (EVAL_AGENTS
and CREATE_EVALS
) or to see conversations of assigned groups (INTERACTIONS_GROUP_VIEW
).
The following composite roles have these effective roles assigned by default: DEFAULT_CC_MANAGER
, DEFAULT_TEAM_LEADER
and DEFAULT_SUPERVISOR
.
To search for a group in the group database, fill in the name, or a part of it, in the search box and click the Enter key. The query brings up all groups that match the entered criteria. To list all groups existing in the system, click the View all groups button.
Click on a group name to select it in the Available Groups section, and then click Assign.
![2024-02-14_14-42-52.png](../../../__attachments/109529960/2024-02-14_14-42-52.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
The group will be listed in the Group(s) Can Manage section.
To reassign it, click on a group name to select it, and then click Remove.
![2024-02-14_14-43-18.png](../../../__attachments/109529960/2024-02-14_14-43-18.png?inst-v=3cebbbd6-55bc-4c3b-b338-9055acdc2807)
As a result of assigning a group, the reviewer is able to review all agents who are members of this group, but not agents being members of its subgroups.
If a group (either imported or manually created) is manually assigned for review to a user who is being synchronized with UCCX or UCCE systems, this change will be lost once the next synchronization is executed.