The configuration of Agent Logins in the Configuration Database must match exactly the configuration of those Agent Logins in the switching system. Before adding or deleting a particular Agent Login, make sure that the same change was made in the database of the switching system.
When you specify Agent Logins as objects in a Switch, they are not associated with any particular agents. For information about how to assign Agent Logins to agents, refer to Creating Agents.
Viewing Agent Logins
The Agent Logins list shows the Agent Logins that are in your environment. It is sorted in a hierarchy by Tenants, configuration units, sites, and folders. To view objects by a particular hierarchy, select the hierarchy type in the drop-down menu above the list.
- The Switches list displays when you select Agent Logins in Configuration Manager. To access the Agent Logins list, you must first select a Switch object and then an Agent Logins folder.
- Agent Logins that are disabled appear grayed out in the list.
Configuration Manager respects tenancy permission settings. You can access only those objects that you have been granted permissions and privileges to access.
You can filter the contents of this list in two ways:
- Type the name or partial name of an object in the Quick Filter field.
- Click the cube icon to open the Tenant Directory filter panel. In this panel, click the Tenant that you want to select. Use the Quick Filter field in this panel to filter the Tenant list.
To select or de-select multiple objects at once, click Select.
Working with Agent Logins
To create a new Agent Login object, click New. To view or edit details of an existing object, click the name of the object, or click the check box beside an object and click Edit.
To delete one or more objects, click the check box beside the object(s) in the list and click Delete. You can also delete individual objects by clicking on the object and then clicking Delete.
Otherwise, select the check box beside one or more objects and click More to perform the following tasks:
- Clone—Copy an Agent Login.
- Move To—Move an Agent Login to another hierarchical structure.
- Enable or disable Agent Logins
- Create a folder, configuration unit, or site. See Object Hierarchy for more information.
Creating Agent Login Objects
To create an Agent Login, do the following:
- Click the Switch object in which you wish to create an Agent Login.
- Click the Agent Logins folder in which you wish to create an Agent Login.
- Click New.
- Enter the following information. For some fields, you can either enter the name of a value or click Browse to select a value from a list:
ImportantTo specify a value in the Override field, you must ensure the Use Override check box is checked.
- Code—The Agent Login code. You must specify a value for this property, and that value must be unique within the Switch. Once you set the value, you cannot change it.
- Switch—The Switch to which this Agent Login belongs. This value is automatically set, based on the Switch being viewed in the Agent Logins list.
- Override—Value to use as the override instead of the Code value for accessing this Agent Login in certain types of routing. You must specify an override value, and it must be unique within the Switch.
- Switch-specific Type—An integer that corresponds to a combination of switch-specific settings for this Agent Login. It identifies the device type (for example, Extension, ACD Position, or Trunk) for each switch (PBX) that T-Server supports. It is unique for each switch/DN/T-Server configuration. In essence, it provides a cross-reference for DN Types between T-Server and PBX. You must specify a value for this property, and it must be 1 or greater. For more information, refer to the Framework T-Server Deployment Guide for your particular T-Server.
- Password—A security protection key used along with this Agent Login to authenticate a User for contact-center activity. You can associate one User with multiple password-protected Agent Logins.
- Confirm Password—Confirmation of the password entered in the New Password field.
- Tenant—In a multi-Tenant environment, the Tenant to which this object belongs. This value is automatically set to the Tenant that was specified in the Tenant Directory field in the object list.
- State Enabled—If selected, indicates that the object is in regular operating condition and can be used without any restrictions.
- Click Save.
CSV File for Importing and Exporting
You can use the Bulk Import/Export functionality to import Agent Logins from, and export Agent Logins to, a comma-separated value (CSV) file. The import file used for importing and the export file created by exporting data are fully compatible, and a single file can be used for both importing and exporting. Or, if you wish, you can create the import file yourself, using the information on this page.
Fields of the CSV File
The source file is a text file in a comma-separated (CSV) format, with an extension of .csv.
In the source file each line represents a single Agent Login. The same Agent Login can appear in the source file only once. The unique identifier of the Agent Login in the scope of the source file is the Code field.
The columns of the file are the properties of an Agent Login. The first row in the file has column names to identify the fields. The order of the columns is not important. A comma is inserted after each column header or value, or if the column does not have a value, immediately after the previous comma. Any non-mandatory column can be omitted from the source file, depending on user preference and/or the purpose of the file.
The source file contains the following properties for each Agent Login:
|Action||ADD, UPDATE, DELETE||Yes|| Specifies the action to be taken with this Agent Login data, either create a new Agent Login (ADD) or modify the existing Agent Login (UPDATE) or delete the existing Agent Login (DELETE).
This column is added automatically by GAX when a file is exported, with a value of UPDATE for all records in it. If you create the source file from scratch, you must add this column manually. In either case, this field is mandatory, and you must provide a value for each record.
|Code||String||Yes||Agent Login number or name.|
|Switch||String||Yes||Name of the Switch under which this Agent Login is created.|
|Switch Specific Type||Integer||Yes||An integer that corresponds to a combination of switch-specific settings for this Agent Login. It identifies the device type (for example, Extension, ACD Position, or Trunk) for each switch (PBX) that T-Server supports. It is unique for each switch/DN/T-Server configuration. In essence, it provides a cross-reference for DN Types between T-Server and PBX. You must specify a value for this property, and it must be 1 or greater.|
|Enabled||String||No||Whether this Agent Login is enabled (Y) or not (N).|
The following data is to be uploaded to GAX to create two new Agent Logins and update an existing one:
The contents of the CSV file for this data looks like this:
Action,Code,Switch,Switch-Specific Type,Enabled ADD,214,Switch1,3,Y ADD,215,Switch2,5,Y ADD,212,Switch1,7,Y