Model: relation/HcsDNMultiE164AssociateREL

E164 Associations ( N to 1 DN )

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

You cannot associate numbers if Number Management has been disabled for the customer.
Only DNs or E.164 numbers that are not currently associated are available for association.

Procedure

Set the hierarchy path to the customer or site where you are associating a set of E.164 numbers with one DN.

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

Click Add.

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

In the E164 Ranges table, 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.

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.

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.

Click Save.

When listing the Directory Number Inventory and displaying a directory number, the E.164 number format is as listed in View Directory Number Inventory.
For a site-level association, one or more translation patterns that are used to route inbound PSTN calls to their proper DN are created on the Unified CM. These patterns are the mappings between the set of E.164 numbers and the single directory number. When you associate a set of E.164 numbers to a single DN, multiple translation patterns are created; that is, each DN-to-E.164 range association results in a translation pattern being created on Cisco Unified Communications Manager.
For a customer-level association, the translation patterns are created on each Unified CM cluster that has a dial plan provisioned.
For a site-level association, if the site has one or more SIP Local Gateways associated with it, the HcsSipLocalGwAddMultiE164AssociationEVT is generated. If enabled, the IOS Command Builder generates the default IOS commands associated with the event for each SIP Local Gateway.
For a customer-level association, if the E.164 number has the same country as any SIP Local Gateway configured for the customer, the HcsSipLocalGwAddE164AssociationEVT 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

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

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

Shadow

Field Name: shadow.[n]
Type: Array
Cardinality: [0..1]

Name *

Field Name: shadow.[n].name
Type: String
MaxLength: 1024