.. _manage-single-DNs:
E164 associations ( N to 1 DN )
---------------------------------
.. _20.1.1|EKB-5576:
.. _19.3.3|EKB-5576:
.. _21.4|EKB-7419:
.. _24.1|EKB-18892:
.. _25.2|EKB-24394:
.. tip::
:ref:`use-action-search-to-navigate-automate`
Overview
..........
This topic describes managing single internal numbers associated with a range of E164 numbers.
.. _view-single-dn-associations:
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 the **E164 Associations (N to 1 DN)** list view.
#. 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:
.. tabularcolumns:: |p{3cm}|p{12cm}|
+-------------+--------------------------------------------------------+
| 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. |
+-------------+--------------------------------------------------------+
3. 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):
.. tabularcolumns:: |p{3cm}|p{12cm}|
======================= ===================================================================
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.
======================= ===================================================================
.
.. _assoc-set-e164-numbers-to-one-dir-number:
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.
* You can also *modify* a **E164 Associations (N to 1 DN)** association instance
and add additional ranges of E164 numbers to a DN. Open the existing, saved association
and then add the additional ranges using the plus icon (+) - as described in the steps below.
**Prerequisites**:
* Enable number management for the customer.
**Perform these steps**:
1. Go to the **E164 Associations (N to 1 DN)** list view.
#. Choose the site (if required).
#. In the **E164 Associations ( N to 1 DN )** list view, click the Plus icon (+) to add a new record.
#. Configure E164 association ( N to 1 DN ). The table describes configuration options:
.. tabularcolumns:: |p{3cm}|p{12cm}|
+---------------------------+------------------------------------------------------+
| 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. |
+---------------------------+------------------------------------------------------+
5. Save your changes.
View transaction progress and details in the Transaction Logs.
.. note::
* When listing the number inventory and displaying an internal number,
the E164 number format is as listed in :ref:`e164-number-inventory-column`.
* 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.
.. rubric:: Related Topics
*
.. raw:: latex
Transaction Logging and Audit in the Core Feature Guide
.. raw:: html
Transaction Logging and Audit
Delete an E164 associations (N to 1 DN)
........................................
This procedure disassociates a set of E164 numbers from an internal number.
.. note::
* When disassociating a set of E164 numbers from an internal number, multiple translation patterns
are deleted. For each association you delete, a translation pattern is deleted from the CUCM.
In Automate, the ``HcsSipLocalGwDelMultiE164AssociationEVT`` event related to
SIP Local Gateway is generated as a result.
* If the Local Gateway is set up to override the Voice Translation limit
and the **Enable Command Builder** setting is enabled, disassociation
will fail if it exceeds the default Voice Translation limit.
In this case, first disable the **Enable Command Builder** setting.
1. Go to the **E164 Associations (N to 1 DN)** list view.
#. Change the hierarchy, if required.
#. In the **E164 Associations ( N to 1 DN )** list, view the following details:
.. tabularcolumns:: |p{3cm}|p{12cm}|
+-----------+----------------------------------------------------+
| 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. |
+-----------+----------------------------------------------------+
4. Choose an option:
* To disassociate multiple associations, click the check box in the
far left column of the table, next to the numbers you want to disassociate.
* To disassociate one association, click its row in the table. The details
about the association appear.
5. 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.
.. rubric:: Related Topics
*
.. raw:: latex
Transaction Logging and Audit in the Core Feature Guide
.. raw:: html
Transaction Logging and Audit