Contents

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 Cisco Unified Communications Manager Database

You can add a group of users to the Cisco Unified Communications Manager database using a CSV data file. The field values that you enter in the CSV file for inserting users will 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 Cisco Unified Communications Manager prior to inserting the users using BAT. The following steps outline the process of pre-populating the DN:

  1. Create range of DN's 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 user names, 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. The Insert Users Configuration window displays.
    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 box, choose the user template you want to use for this insert.
    Note   

    The User Profile, Controlled Device Name, and Directory Number should already exist in the Cisco Unified Communications Manager database. The controlled device name should be entered in full. If it contains only MAC Address, then BAT will display 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.
    Related References
    BAT Log Files
    Related Information
    Manage Scheduling Jobs
    Topics Related to User Insertions

    Topics Related to User Insertions

    User Insertions

    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 Cisco Unified Communications Manager Database

    You can add a group of users to the Cisco Unified Communications Manager database using a CSV data file. The field values that you enter in the CSV file for inserting users will 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 Cisco Unified Communications Manager prior to inserting the users using BAT. The following steps outline the process of pre-populating the DN:

    1. Create range of DN's 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 user names, 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. The Insert Users Configuration window displays.
      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 box, choose the user template you want to use for this insert.
      Note   

      The User Profile, Controlled Device Name, and Directory Number should already exist in the Cisco Unified Communications Manager database. The controlled device name should be entered in full. If it contains only MAC Address, then BAT will display 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.
      Related References
      Related Information

      Topics Related to User Insertions