User Insertions

This chapter provides information to use Cisco Unified Communications Manager Bulk Administration (BAT) to add a group of users to the Cisco Unified Communications Manager database.


Note

This feature supports only custom files that are saved with the UTF-8 encoding format.

Insert Users in Unified Communications Manager Database

You can add a group of users to the Unified Communications Manager database using a CSV data file. The field values that you enter in the CSV file for inserting users override the values provided in the user template.


Attention

If the credential policy has "check for trivial password" enabled, and the password in the user template is the user ID, inserting users through BAT may fail if the user ID does not satisfy the necessary criteria for the trivial password.

Users can be inserted using BAT with primary extension configured without any devices selected for controlled devices. To do so, you must pre-populate the DN in Unified Communications Manager before inserting the users using BAT. The following steps outline the process of pre-populating the DN:

  1. Create range of DNs to be associated for primary extension for users in the DN page.

  2. Create a BAT template with primary extension configured (which should be the same DN's pre-populated).

  3. Insert the users using BAT (as shown in the following procedure)

Before you begin

You must have a CSV data file that is saved in the UTF-8 encoding format and that contains the usernames, controlled device names, and directory numbers. You can create the CSV data file by using one of these methods:

  • BAT spreadsheet that is converted to CSV format
  • Export utility that produces an export file of user data

Note

When you are inserting users by using an exported BAT file, you might get errors stating "User ID already exists" for some users that were exported in more than one file. For example, a list of first line managers and a list of users might both include the same manager user ID.

Procedure

Step 1

Choose Bulk Administration > Users > Insert Users.

Step 2

In the File Name field, choose the CSV data file that you created for this bulk transaction.

Step 3

If the CSV data file was created by using the export utility, check the File created with Export Users check box.

Step 4

From the User Template Name drop-down list, choose the user template you want to use for this insert.

Note 

The User Profile, Controlled Device Name, and Directory Number should exist in the Unified Communications Manager database. The controlled device name should be entered in full. If it contains only MAC Address, then BAT displays a non-existing device error.

Step 5

In the Job Information area, enter the Job description.

Step 6

Choose an insert method. Do one of the following:

  1. Click Run Immediately to insert the user records immediately.

  2. Click Run Later to insert the user records at a later time.

Step 7

To create a job for inserting the user records, click Submit.

To schedule and/or activate this job, use the Job Scheduler option in the Bulk Administration main menu.