Cisco Unified Communications Manager Bulk Administration Guide, Release 9.0(1)
Imported directory URI
Downloads: This chapterpdf (PDF - 357.0KB) The complete bookPDF (PDF - 6.72MB) | Feedback

Imported directory URI

Imported directory URI

This chapter describes how to import directory URIs from a third party call control system into Cisco Unified Communications Manager.

Use the Bulk Administration > Imported Directory URIs > Insert Imported Directory URIs path to import directory URIs from a third party call control system into Cisco Unified Communications Manager.

Import Directory URIs from a non-ILS system

Follow this procedure if you are running the intercluster lookup service (ILS) on your local cluster and you want to import directory URIs from a csv file for a call control system that is not running ILS, such as a Cisco TelePresence Video Communications Server (VCS), or a third-party call control system.

To perform this procedure, the Cisco Bulk Provisioning Service must be running on the local cluster, which must be configured as a hub cluster in an ILS network. Once the catalog is imported into Cisco Unified Communications Manager, ILS replicates the imported catalog out to the other clusters in the ILS network.


Note


Within Cisco Unified CM Administration, you can enter directory URIs with embedded double quotes or commas. However, when you use Bulk Administration to import a csv file that contains directory URIs with embedded double quotes and commas, you must use enclose the entire directory URI in double quotes and escape the embedded double quotes with a double quote. For example, the Jared, "Jerry",Smith@test.com directory URI must be input as "Jared,""Jerry"",Smith@test.com" in the csv file.


Procedure
    Step 1   In Cisco Unified CM, choose Routing > Directory URIs > Imported Directory URI Catalogs.
    Step 2   In the Name field, enter a name for the directory URI catalog.
    Step 3   In the Description field, enter a description of the directory URI catalog.
    Step 4   In the Route String field, create a route string for the system from which you are importing the URI catalog.
    Step 5   Click Save.
    Step 6   In Cisco Unified CM Administration, chooseBulk Administration > Upload/Download Files.
    Step 7   Click Add New.
    Step 8   Click Browse and select the csv file for the directory URI catalog that you want to import.
    Step 9   In the Select the Target drop-down list box, choose Imported Directory URIs.
    Step 10   In the Select TransactionType drop-down list box, choose Insert Imported Directory URIs.
    Step 11   Click Save.
    Step 12   In Cisco Unified CM Administration, choose Bulk Administration > Imported Directory URIs > Insert Imported Directory URIs.
    Step 13   In the File Name drop-down list box, choose the csv file that contains the imported directory URI catalog.
    Step 14   In the Imported Directory URI Catalog drop-down list box, choose the directory URI catalog that you named in the Imported Directory URI Catalog window.
    Step 15   In the Job Description text box, enter a name for the job that you are about to run.
    Step 16   Select when you want to run the job.
    • If you want to run the job now, click the Run Immediately radio button, and click Submit.
    • If you want to schedule the job to run at a specified time, check the Run Later radio button and click Submit. If you choose this option, you must use the Bulk Administration Job Scheduler to schedule when the job runs.

    Directory URI format

    Directory URIs are alphanumeric strings consisting of a user and a host address separated by the @ symbol. Cisco Unified Communications Manager supports the following formats for directory URIs:

    • user@domain (for example, joe@cisco.com)
    • user@ip_address (for example, joe@10.10.10.1)

    Cisco Unified Communications Manager supports the following formats in the user portion of a directory URI (the portion before the @ symbol):

    • Accepted characters are a-z, A-Z, 0-9, !, $, %, &, *, _, +, ~, -, =, \, ?, \, ‘, ,, ., /.
    • The user portion has a maximum length of 47 characters.
    • The user portion accepts percent encoding from %2[0-9A-F] through %7[0-9A-F]. For some accepted characters, Cisco Unified CM automatically applies percent encoding. See below for more information on percent encoding.
    • The user portion is case-sensitive.

    Cisco Unified Communications Manager supports the following formats in the host portion of a directory URI (the portion after the @ symbol):

    • Supports IPv4 addresses or fully qualified domain names.
    • Accepted characters are a-z, A-Z ,0-9, hyphens, and dots.
    • The host portion cannot start or end with a hyphen.
    • The host portion cannot have two dots in a row.
    • Minimum of two characters.
    • The host portion is not case-sensitive.

    Due to database restrictions, the Directory URI field has a maximum length of 254 characters.


    Note


    You can also enter a directory number in the user portion of a directory URI. However, Cisco Unified Communications Manager may treat the directory URI as a directory number depending on which Dial String Interpretation option you choose for the SIP Profile.



    Note


    For compatibility with third party call control systems, Cisco recommends using lower case for directory URIs.


    Percent Encoding of Directory URIs

    In the user portion of a directory URI, Cisco Unified CM automatically applies percent encoding to the following characters when the directory URI is saved in the database:

    # % ^ ` { } | \ : ” < > [ ] \ ‘ and spaces.

    When percent encoding is applied, the digit length of the directory URI increases. For example, if you input joe smith#@cisco.com (20 characters) as a directory URI, Cisco Unified Communications Manager stores the directory URI in the database as joe%20smith%23@cisco.com (24 characters). Due to database restrictions, Cisco Unified Communications Manager rejects any attempt to save a directory URI of greater than 254 characters.

    Directory URI format exception for Bulk Administration

    Within Cisco Unified CM Administration, you can enter directory URIs with embedded double quotes or commas. However, when you use Bulk Administration to import a csv file that contains directory URIs with embedded double quotes and commas, you must use enclose the entire directory URI in double quotes and escape the embedded double quotes with a double quote. For example, the Jared, "Jerry",Smith@test.com directory URI must be input as "Jared,""Jerry"",Smith@test.com" in the csv file.