After you have installed Unified Intelligent Contact Management (Unified ICM) and have it running, use the Configuration Manager to view and update the configuration information in the Unified ICM database. The configuration information describes the people, groups, and devices that are part of your enterprise.
For example, use the Configuration Manager to specify:
The devices in your system and the clients they serve, which:
The peripherals at your contact centers
The routing clients served by your system
Targets at the peripherals to which the system software can direct calls, which:
Trunks and trunk groups connected to peripherals
Skill targets associated with each peripheral: agents, skill groups, services, and translation routes
Information used by scripts to organize call requests and direct calls to targets, including call types, regions, prefixes, and dialed numbers
Targets understood by the routing client, including announcements, peripheral targets, and routing labels
The associations among routing labels, routes, peripheral targets, and skill targets
Enterprise services and enterprise skill groups as a combination of individual services and groups from different contact centers
To access the Configuration Manager do one of the following:
Double-click the Unified CCE Administration Tools folder icon, then double-click the Configuration Manager icon.
From the Start menu, select All Programs > Cisco Unified CCE Tools > Administration Tools > Configuration Manager.
Configuration Manager menus
When you start the Configuration Manager, the Configuration Manager window appears. The figure following shows the window with the top-level directories displayed for all its menus.
Figure 1. Configuration Manager
The Configuration Manager lets you view and update configuration information in the Unified ICM database. The configuration information describes the people, groups, and devices that are part of your enterprise.
To set up the configuration of a new system when you are a new user, follow the steps in the menu bar's Step by Step Configuration selection list.
Use the tools in the Telephony Contact Center Configuration menu in the order given to configure, first NICs, then peripherals. After you configure the system software for your telephony contact center, you can configure the software for multimedia applications.
The tools in the MultiMedia Contact Center Configuration menu are also in the order in which you generally use them. For example: you must have a media class before you can create an MRD for that class. And you must have an application instance before you can specify the path to that application.
The configuration tools according to the menu selections of the former Configure ICM tool, in the menu, select Configure ICM.
All the tools you can use in the Configuration Manager, in the menu bar, select Tools.
For information about any Configuration Manager tools, menu options, or other interface features, refer to the online help.
You can activate help from within the system software in any of three ways:
Click Help in the tool bar or in the dialog
Select Help > Help Contents from the menu bar
Press the F1 key
Figure 2. Explorer Tools help
Configuration Manager tools
Use the menu bar in the Configuration Manager window to select the task or tool you want.
Use the Explorer tools to configure and manage database records that have hierarchical relationships to other records. In this way, at one time, you can see and update both the individual records and their relationships. You can configure and manage the following records with the Explorer tools.
The tools are named for the type of records they manage:
Database Lookup Explorer
Device Target Explorer
ICM Instance Explorer
Network VRU Explorer
Network Trunk Group Explorer
Scheduled Target Explorer
Service Array Explorer
Skill Group Explorer
Translation Route Explorer
Refer to each tool's online help for detailed information.
Use the List tools to configure and manage database records that have limited or no hierarchical relationship to other records. You can configure and manage the following individual records with the List tools.
The tools are named for the type of records they manage:
Agent Desk Settings List
Agent Targeting Rule List
Agent Team List
Application Gateway List
Application Instance List
Bucket Intervals List
Business Entity List
Call Type List
Class Security List (on partitioned systems only)
Dialed Number/Script Selector List
Enterprise Route List
Enterprise Service List
Enterprise Skill Group List
Expanded Call Variable List
Feature Control Set List
Media Class List
Media Routing Domain List
Network VRU Script List
Reason Code List
Service Level Threshold List
User Group List
User Variable List
VRU Currency List
VRU Defaults List
VRU Locale List
Refer to each tool's online help for detailed information.
The following Configuration Manager tools enable you to do miscellaneous functions not available with the other tools:
Deleted Objects: Enables you to view all records deleted from the database and to permanently delete them if you no longer want them.
Integrity Check: Allows you to perform specific integrity checks on the configuration data in the Unified ICM database.
Region Editor: Allows you to:
View, create, update (cut, copy, paste, move, or edit), and delete custom regions
View, copy, move, or delete predefined regions, but not edit them
Script Reference: Allows you to generate a report that shows which routing scripts reference a specific configuration record.
System Information: Allows you to view and set general and application gateway information about your enterprise.
Unreferenced Objects: Lists the database tables that have unreferenced records. Use this tool to find specific integrity problems within the database.
Two wizards guide you through the configuration of:
Translation routes (Translation Route Wizard)
Call center applications (Application Wizard)
Use these wizards for step-by-step guidance.
Bulk, List, and Explorer tools common features
The Bulk, List, and Explorer tools have the following common features:
Common filter access To access data from the database, in the Select filter data box of the Bulk, List, Explorer Configuration Insert tool window, select the type of data you want and click the Retrieve button.
Record status symbols When you make an edit, the record's status symbol updates accordingly. This appears to the left of the record name in the list box of the Explorer or List tool and in the State column of the Bulk tool.
Table 2 Record status symbol descriptions
A green check mark means the object has not changed since you retrieved it from the database or made a save.
This feature is not common to the Explorer tools.
A red X means the object is marked for deletion and will be deleted when you click the Save button.
A yellow arrow means that the object's data has been changed and the changes have not yet been saved in the database.
A yellow addition sign means the object is to be inserted into the database when you click the Save button.
A red circle with a red slash through it indicates the object was created using an application and is controlled by the Application Object Filter (AOF) or by Peripheral Auto-Configuration.
Other common features:
ID status box The label in the ID box at the bottom of the screen identifies the Unified Intelligent Contact Management Enterprise (Unified ICME) system (instance) on which you are working.
Delete/Undelete button When a record is selected and you click the Delete button, that button toggles to Undelete and a red X marks the record for deletion. As soon as you save your database changes, marked records are deleted from the database.
Save button No changes are made to the database until you click the Save button.
List and Explorer tool, common features
The List and Explorer tools share the following features.
List Box of Retrieved Records Both the Explorer and List tools have a list box that displays retrieved records. Selecting a record in this list displays that record's properties in the right side of the tool window. Once the record is displayed, you can edit it if you have maintenance access to it. Retrieved records:
Tree (only in Explorer tools) In an Explorer window, the retrieved list is called a directory tree, which can be expanded or contracted to show a hierarchy of records. A legend above the tree identifies the types of records that can be displayed in the tree. With the mouse, you can select a record in a tree and move it to another part of the tree, as long as its object type belongs in that tree location.
UNASSIGNED (only in Explorer tools) The Explorer tree can also contain UNASSIGNED records. These are stored in an UNASSIGNED directory for the selected directory tree object. A record is named UNASSIGNED if it was not assigned (mapped) to a parent object. For example, a label created in the Bulk Configuration tool might not have been assigned to a peripheral target, or a route might not have been assigned to a service. You can also use the Label Bulk Configuration tool to take the output of a switch and create 20 or 30 labels. Then, using an Explorer tool, you can attach the labels to an appropriate location.
List (only in List tools) In a list window, the retrieved list is called a list and has no legend above it since its records have no or only one relationship to another record.
Adding New Records The Add button is enabled only after you use the Select filter data section of the window. In the Explorer tools, when a record in the tree is selected, you can add another record of the same kind or a record immediately below it in the tree hierarchy. In the List tools, the Add button is enabled only for the single type of records listed.
Deleting Records Selecting a record and clicking Delete marks the record (with a red X) for deletion. However, the record is not deleted until you click Save. Delete toggles to Undelete when you select an object marked for deletion. To undelete an object marked for deletion, select it and click Undelete.
Options Menu In the Explorer and List tool windows, right clicking on a retrieved record displays an options menu containing all the editing options for that record.
The Options Menu is not available in the List tools if you have read-only access.
Database records access
The Bulk Configuration, List, and Explorer tools enable you to access records from the database in the same way. In these tools, use the Select filter data box to select and retrieve data from the database. Until you retrieve database data, no data is displayed.
In the top left of the Bulk Configuration Insert, the Explorer, and the List tool windows is a Select filter data box similar to the following.
Figure 3. Select filter data box
In this example, all records belonging to the Boston_PG_1 peripheral and having Jo in their names are selected for retrieval from the database.
The filters used to select data vary according to the type of data. In the preceding example, data is first selected by peripheral and then by name. Some filter selection boxes have only optional filters.
To achieve maximum response time when retrieving records:
Always select a specific member from the Primary Filter, even if only one exists. For example, for the Dialed Number/Script Selector List tool, always select a specific Routing client and Customer. In addition to reducing the number of records loaded and listed, this also improves response time when navigating through the list of records and when adding new ones.
Specify an Optional Filter whenever possible to further reduce the number of records retrieved. For example, when using the Dialed Number/Script Selector List tool, this could be a Name, Dialed number string, or Description.
Separate the operation of adding records from editing existing records. In addition to selecting the targeted Primary Filter, specify a unique Optional Filter for the new record that will result in no existing records being loaded. For example, when using the Dialed Number/Script Selector List tool, specify the exact Dialed Number string to be added. The retrieval response time will be almost instantaneous and the list of records being added will be easier to manage.
If any editable field is changed, an additional dialog appears (below the Select filter data dialog) displaying the original filter settings. In addition, the tree list box and all buttons except Retrieve, Close, and Help are disabled.
Clicking Close cancels the filter changes and returns the fields to their original settings. Clicking Retrieve closes the Select filter data dialog and enables the display (in the tree list box) of the record retrieved based on the selected filter criteria.
The following table describes how the optional filters, the check box, and the filter buttons work for all the Bulk Insert, Explorer, and List tools.
Table 3 Common filter functions
None in the optional filter box means no optional filtering. All data is displayed for the selected records.
The optional fields to filter on differ by record type according to both the fields in a record and the fields considered useful as filters.
If the selected Optional Filter is
The Condition filter is ignored.
A text filter (for example, Description)
Select one of the text conditions (Contains, Ends With, Starts With, Is Blank) and enter an appropriate entry in the Value field.
A numeric filter (for example, Trunk Number)
Select one of the numeric conditions (Equal, Greater Than, Less Than, Not Equal) and enter an appropriate entry in the Value field.
The available numeric conditions can change depending on the record data. For example, Equal or Not Equal might be the only choices.
The entry in this field is based on the selections made in the Optional Filter and Condition fields. If None is selected in the Optional Filter field, this field is ignored.
Save check box
If checked, indicates that the current settings are saved so that when you next open the List tool for this type of record, the current settings will be selected. However, no data is displayed until you click the Retrieve button.
This button displays the data selected in the Select filter data box.
Cancel filter changes button
If you change the Optional Filter settings after a Retrieve, clicking this button resets the filter settings back to the preceding ones.
Save configuration data to database
When you have completed adding information in an open configuration window, click
The system software saves the configuration data and immediately applies your changes to both the local and central Unified ICM database.
Whenever any data is retrieved by a configuration tool, the tool notes the last change mark on that data at this point in time. If you attempt to change that item, the tool first checks the current copy in the database for its change mark. If the change marks do not agree, another user has changed this item since you last retrieved it, and an error is returned. You must then discard any changes, using Retrieve to obtain the latest information for editing.
This approach is called optimistic locking, and assumes that it is rare to have two people needing to change the same item at the same time. This prevents the performance and maintenance issues involved with hard-locking items, while still preventing one person from accidentally overwriting another user's changes.
In general, feature control addresses the need of restricting users, or classes of users, from all functionality of the system software.
Observe the following distinctions between object-level control and feature control:
Object control, part of the system software partitioning feature, is a method of security for prohibiting access to configuration data in the Unified ICM database.
Feature control, like the previously available Limited (Single Instance) Administration & Data Server, is a method of security for prohibiting access to the system software features.
Script Editor feature control addresses the need of restricting users, or classes of users, from some or all of the functionality of the Script Editor software. In a possible deployment scenario, a system software administrator can restrict certain people from doing specific types of script editing. Similar functionality was previously available in the system software in the Limited (Single Instance) Administration & Data Servers feature control.
An administrator has two means to restrict access to the editing features of Script Editor and Internet Script Editor:
Script node control
It is also possible for an administrator to use a combination of both feature control options.
In previous Unified ICM Software versions (including and before Unified ICM 4.x), any change made to the read-only status of a user was not dynamically updated in the Script Editor. Script Editor had to be closed, then reopened, before the change took effect.
In Unified ICM Release 7.0(0) and higher, any change made to a user's read-only status (using the User List tool) is automatically updated in Script Editor.
Refer to the Scripting and Media Routing Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted for additional feature control information.
Script node control allows an administrator to create feature sets that can be assigned to users. The feature set controls which script nodes are accessible to the user.
Node control table
The node control table (in the Configuration Manager Script Editor Feature Control dialog) has two columns, the Node column and the Available column. This table allows an administrator to create feature control sets that can be assigned to users. The feature control set controls which script nodes are accessible to the user.
If a script is opened that contains a disabled node, you can browse or monitor the script but you cannot put the script into edit mode. If you attempt to put this script into edit mode a message indicating you are not authorized to enter edit mode is displayed. However, you can still Quick Edit the script, just not the node.
A node is an executable element within a script. A script consists of nodes, connections, routing targets, and comments. Every script begins with a Start node. The node column lists of all the nodes that can be used in a script.
Each checked node in the available column appears on the editing pallet of the feature-control-set user, regardless of the edit mode (Full Edit or Quick Edit Only).
There are two possible presentation effects:
Enabled nodes are displayed on the object palette
Disabled nodes are removed from the object palette
To check the integrity of your configuration data, perform the following:
In the Configuration Manager, select Miscellaneous Tools > Integrity Check. The Integrity Check dialog appears.
Choose the type of check option that you want to perform or click Select All to choose all the check options. (For specific information about each of these options and the tables and fields they check, refer to the Configuration Manager online help.)
Click Perform Check. The Configuration Manager performs the check and one of the following happens:
If the check discovers a problem, the Configuration Manager displays messages in the Integrity Problems text box. Double-click on a message to receive specific information about the records in the data table at the bottom of the window.
If the check completes without finding any invalid data, the Configuration Manager displays a message saying the integrity check completed successfully.
When all checks are complete, click Close. The Integrity Check dialog closes.
Many database records need references to related records. For example, each peripheral target must reference a route and each trunk group must reference a network trunk group.
Check record references
To check record references, perform the following:
In the Configuration Manager menu, select Miscellaneous Tools > Unreferenced Objects. The Unreferenced Objects dialog appears listing the database tables containing objects that are missing references.
To see the specific rows that are missing references in a table, double-click on the table name. Double-clicking on a table name entry displays that table showing the records that are missing references.
Configuration record deletion
At some point, you might want to remove configuration records from your database; for example, if data has been entered in error or changes occur in your business.
Depending on the record involved, the Configuration Manager performs one of two types of deletion:
Immediate deletion. The system software immediately removes the record from the database. (Also known as physical deletion.)
Logical deletion. The system software sets the record's Deleted field to Y (yes), but the record remains in the database. The Configuration Manager and the CallRouter treat the record as though it were deleted. The record remains in the database, however, for historical reporting purposes.
Some tables — for example, the Skill Group Member table, which maps agents to skill groups — do not have a Deleted field. When you delete a record from such a table, the system software immediately removes the record from the central and local database.
Other tables, for example, the Skill Group table, which describes a skill group associated with a peripheral — do have a Deleted field. When you delete a record from such a table, the system software does not remove the record from the central and local database. Instead, the system software sets the record's Deleted field to Y to indicate that it is logically deleted.
Logical deletion ensures that any references to the record — for example, references to a skill group in call detail records — remain valid. However, the Configuration Manager and the Script Editor treat the record as though it were deleted.
Never attempt to set a configuration record's Deleted field directly. Changing a Deleted field directly can compromise the integrity of your Unified ICM database. Use the Configuration Manager Tools > Miscellaneous Tools > Deleted Objects option to permanently remove logically deleted records.
How a configuration tool processes a record deletion request depends on whether, and how, the record is referenced by other configuration records:
If no other records reference the current record, the configuration tool deletes the record.
If other records reference the current record — and the configuration tool can neither modify the references nor delete the other records — the configuration tool does not delete the record.
Administering deleted records
The Configuration Manager lets you view logically deleted records. It also allows you to permanently delete these records.
In Configuration Manager menu, select Tools > Miscellaneous Tools > Deleted Objects. The Deleted Objects dialog appears, indicating the tables in which records are marked for deletion and the number of records so marked.
To see the specific records marked for deletion within a table, double-click on a table name. If you double-click on a table name entry, a list window appears showing records from that table that are marked for logical deletion.
To remove records from the database entirely, select a record from the list (or use the Select All button to select all) and click Delete Permanently. The Configuration Manager displays a message indicating the operation completed.
You must have access rights to a record to be able to delete it permanently.
Click Close to close the dialog.
You can configure call type intervals in relation to your service levels. For example, if your service level threshold is 15 seconds and you want to see when callers are abandoning within that service level, you can set intervals of 5 seconds, 10 seconds, and 15 seconds.
Call types on the Child Central Controller contains an example of how to configure call types on a child deployment, which is documented in the Cisco Contact Center Gateway Deployment Guide for Cisco Unified ICME/CCE/CCX.
Reports can display information from up to ten intervals. You can configure up to nine intervals, and the tenth interval shows all the remaining data. To configure bucket intervals, perform the following:
Open the Configuration Manager tool and expand the Tools menu.
Expand the List Tools menu and double-click Bucket Intervals List.
Click Retrieve to display the default values.
Click Add to add a new list of interval values.
In the Name filed of the Attributes tab, assign the list a name.
Assign your new values to the Upper bound 1 - 9 fields.
Click Close to close the Bucket Interval List tool.
Double-click the Call Type List tool.
In the Name field of the Attributes tab, assign the new list a name.
Select the Customer from the pull-down menu.
Check the Override System Information Default box for the Bucket Intervals section.
Using the pull-down menu, select the Bucket Intervals list you previously created.
Call types on the Child Central Controller
Access the Configuration Manager on the Child Administration & Data Server to configure call types.