[Index]

Model: relation/HcsDNMultiE164AssociateREL

E164 Associations ( N to 1 DN )

To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com

Use this procedure to associate a set of E.164 numbers with one Directory Number (DN) at a customer or site. For example, you could associate a set of E.164 numbers for the sales department with an attendant's DN.

If you create the association at a site, you can mix customer-level DNs and E.164 numbers with site-level DNs and E.164 numbers.

You can optionally specify a primary E.164 number to associate with the DN. This step can be useful when you perform a DN-to-E.164 translation (for example, when provisioning translation rules for LBO gateways) and the DN is associated to more than one E.164 presentation.

Note

begin{itemize} item {}
Note: Underlined flowchart titles refer to topic headings in this guide. end{itemize}

To access the flowcharts, view the topic via Documentation and Resources at: https://voss.portalshape.com

Procedure

  1. Choose Dial Plan Management > Number Management > E164 Associations (N to 1 DN).

    You can change the hierarchy if needed.

  2. Click Add.

  3. From the DN Number drop-down, choose an extension number. This field is mandatory.

  4. In the E164 Ranges group, click + as required, to add multiple sets of E.164 numbers. The E.164 numbers do not need to be contiguous. Provide the following information:

    Field Description
    E164 Range

    Choose one of these ranges:

    Note:

    The range values you choose map to the mask value when the association translation pattern is created. For example, when 10 is chosen, all E.164 numbers and directory numbers that end in 0 are listed. The mask affects all digits 0 to 9, so you can't start the mask on a nonzero number. Likewise, when 100 is chosen, the E.164 number and DN end in two zeros. This pattern results in a mask of XX.

    • 1 - To list all E.164 numbers
    • 10 - To list all E.164 numbers that end in one zero (0)
    • 100 - To list all E.164 numbers that end in two zeros (00)
    • 1000 - To list all E.164 numbers that end in three zeros (000)

    This field is mandatory and affects what appears in the E.164 Number field.
    E164 Number Choose the starting number of E.164 numbers. For a customer-level association, customer-level E.164 numbers are available. For a site-level configuration, both customer-level and site-level E.164 numbers are available. This field is mandatory.

  5. In the optional Primary E164 field, enter the primary E.164 number to associate with the DN. Make sure the E.164 number you enter starts with \+ and falls within the range you specified in the E164 Range drop-down.

  6. Click Save.

Notes

E164 Associations ( N to 1 DN )

Full HTML Help

Overview

This topic describes managing single internal numbers associated with a range of E164 numbers.

View E164 Associations (N to 1 DN)

This procedure displays sets of E164 numbers associated with a single internal number (directory number, or DN).

  1. Go to (default menus) Number Management > E164 Associations (N to 1 DN).

  2. On the E164 Associations ( N to 1 DN ) list, view E164 Associations (N to 1 DN).

    Note

    You can filter the list and change the hierarchy by selecting a link in the Located At column.

    The table describes column data in the E164 Associations (N to 1 DN) list view:

    Column Description
    DN Number The associated internal number (directory number).
    Located At The hierarchy of the site where the E164 number range and internal number association was created.

  1. Click on a directory number in the list to view its details.

    The page displays read-only details about the E164 Association (N to 1 DN) configuration (the sets of E164 numbers that are associated with the internal number):

    DN Number The number you're viewing.
    Primary E164

    Displays the E164 number associated to the internal number in the Number Inventory.

    Other E164s are indicated as [x] showing that there are more associated E164s to this internal number but their details are only available when opening the relevant Number Inventory.

.

Add E164 Association (N to 1 DN)

This procedure associates multiple E164 numbers (a set of E164 number) to a single internal number, at a site. For example, you could associate a set of E164 numbers for the sales department with an attendant's internal number.

Note

You can also perform association in ranges of 10, 100, and 1000, on a one-to-one basis. These associations create Direct Dial Inward (DDI) associations so that incoming PSTN numbers are routed to internal numbers.

You can optionally specify a primary E164 number to associate with the internal number. This is useful when performing an internal number to E164 translation (for example, when provisioning translation rules for LBO gateways) and the internal number is associated to more than one E164 presentation.

You can only associate internal numbers or E164 numbers that are not currently associated.

Prerequisites:

Perform these steps:

  1. Go to (default menu) Number Management > E164 Associations (N to 1 DN) to open the list view.
  2. Choose the site (if required).
  3. In the E164 Associations ( N to 1 DN ) list view, click the Plus icon (+) to add a new record.
  4. Configure E164 Association ( N to 1 DN ). The table describes configuration options:
Field Description
DN Number

Choose an internal number.

  • If the association is performed at Customer level, the drop-down only shows internal numbers that were added at Customer level.
  • If the association is performed at Site level, the drop-down shows internal numbers added at either Customer or Site.
  • You can't associate internal numbers that begin with the prefix '*' (asterisk) or '#" (hash).
E164 Ranges

Click the Plus icon (+) to add one or more sets of E164 numbers. These E164 numbers do not need to be contiguous. For each E164 number you add, choose an E164 range and the E164 number, as follows:

  • E164 Range

    Choose an E164 range, either 1, 10, 100, or 1000.

    The range value you choose maps to the mask value when the association translation pattern is created. For example, choose 10 to list all E164 numbers and internal numbers ending in 0. The mask affects all digits 0 to 9, so you can't start the mask on a non-zero number. When 100 is chosen the E164 number and internal number end in two zeros, resulting in a pattern with a mask of XX.

    • 1 - to list all E164 numbers
    • 10 - to list all E164 numbers ending in one zero (0)
    • 100 - to list all E164 numbers ending in two zeros (00)
    • 1000 - to list all E164 numbers that end in three zeros (000)

This field is mandatory and affects what appears in the E164 Number field.
E164 Number

Mandatory. Choose the starting number of E164 numbers.

  • If the association is performed at customer level, the drop-down only shows E164 numbers that were added at customer level.
  • If the association is performed at site level, the drop-down contains E164 numbers that were added at either customer or site level provided the country matches the site's country.
Primary E164 Optional. Fill out the primary E164 number to associate with the internal number. Ensure the E164 number you enter starts with \+ and falls within the range you specified in in E164 Range
Dial Plan Model Selection

This field displays only when the Enforce HCS Dialplan Rules setting in the Global Settings is set to False

Defines the translation pattern template configured in the dial plan modeling tool. The values for the pattern, transform mask, and associated range masking are hard coded in the workflow. +1555 111 5555 (Range 10) = +1555 111 555X

Other values, such as partition and CSS) come from this template.

The translation pattern must have its description set to display in this drop-down.

  1. Save your changes.

    Note

    • When listing the Number Inventory and displaying an internal number, the E164 number format is as listed in E164 Column Description.

    • One or more translation patterns are created on the CUCM. The translation patterns are the mappings between the set of E164 numbers and the single internal number, and are used to route inbound PSTN calls to their proper internal numbers.

      When you associate a set of E164 numbers to a single internal number, multiple translation patterns are created (each DN-to-E164 range association results in a translation pattern being created on the CUCM).

    • If the association is performed at Site level, the translation pattern is only added to the CUCM referenced by the site's network device list (NDL).

    • If the association is performed at Customer level, the translation pattern is added to all of the CUCMs that exist for the customer.

    • If the site is associated with one or more SIP Local Gateways, the HcsSipLocalGwAddMultiE164AssociationEVT event is generated. If enabled, the IOS Command Builder generates the default IOS commands associated with the event for each SIP Local Gateway.

Delete an E164 Associations (N to 1 DN) Association

This procedure disassociates a set of E164 numbers from an internal number.

Note

  1. Go to (default menu) Number Management > E164 Associations (N to 1 DN).
  2. Change the hierarchy, if required.
  3. In the E164 Associations ( N to 1 DN ) list, view the following details:
Column Description
DN Number The internal number.
Located At The hierarchy of the site where the E164 number range and internal number range association was created.

  1. Choose an option:

  2. Click Delete, then click Yes to confirm the disassociation.

    Note

    • The translation pattern mapping between the E164 set and the internal number is deleted from the CUCM.

      The E164 number association with the internal number is removed from the Number Inventory list view, and from any Lines drop-downs and Lines displays.

    • If the site is associated with one or more SIP Local Gateways, the HcsSipLocalGwDelMultiE164AssociationEVT event is generated. If enabled, the IOS Command Builder generates the default IOS commands associated with the event for each SIP Local Gateway.

Model Details: relation/HcsDNMultiE164AssociateREL

Title Description Details
DN Number * The Directory Number.
  • Field Name: dn_number
  • Type: String
  • MaxLength: 50
E164 Ranges The E164 ranges the DN is associated with.
  • Field Name: members.[n]
  • Type: Array
E164 Range * The E164 Range
  • Field Name: members.[n].e164_range
  • Type: String
  • MaxLength: 1024
E164 Number * The starting E614 Number for the range.
  • Field Name: members.[n].e164_number
  • Type: String
  • MaxLength: 17
Primary E164 The Primary E164 for the ranges.
  • Field Name: primary_e164
  • Type: String
  • MaxLength: 1024
Evaluate HCS DP Enforcement Default: false
  • Field Name: hcsdpeval
  • Type: String
  • Default: false
Dial Plan Model Selection Select the required Translation Pattern Dial Plan Model. Translation Pattern must have the Description field set to be displayed in this dropdown.
  • Field Name: dpModelSelect
  • Type: String
Shadow
  • Field Name: shadow.[n]
  • Type: Array
  • Cardinality: [0..1]
Name *
  • Field Name: shadow.[n].name
  • Type: String
  • MaxLength: 1024