.. _webex-location-node-mapping:

Webex Location to Hierarchy Mapping
-------------------------------------


.. _21.4-PB3|EKB-16713:

.. tip:: 

   :ref:`use-action-search-to-navigate-automate`


The **Webex Location to Hierarchy Mapping** page (``data/WebexLocationNodeMapping``) allows for the mapping 
of an existing VOSS intermediate hierarchy node to a Webex location name.

This functionality allows administrators to sort the Webex locations into business driven logical groupings.
Note that the mapping of the Webex location name must be in place before the locations are synced
from Control Hub. If the location match string is not found, a new location will be built directly
under the customer node. If a mapping is missing, an administrator may purge that location data,
create the mapping in Webex Location Node Mapping and run the data sync again.


Upon data sync, Webex locations that match the **Search String** are then moved under the Intermediate node.


.. important::

   The text entered into the **Search String** field:
   
   * can be case-insensitive
   * should be contained in the Webex location name as uniquely as possible, to exclude unwanted location name matches
   * matching operator is ``containsIgnoreCase``

1. Select the **Intermediate Node** that the Webex location should be mapped to.
2. In the **Search String**, enter (case-insensitive) a distinctly matching string from the Webex location name should
   be mapped to the intermediate node.
3. Click **Save**.


On the next Webex data sync, Webex locations matching the **Search String** are moved under the selected 
**Intermediate Node**.

.. note:

   Mapping is only supported up to one level of Intermediate node nesting under a Customer hierarchy.


.. rubric:: Related Topics
  
* :ref:`webex-app`