.. _associate-disassociate-devices-to-application-users:

Associate and Disassociate Devices to Application Users
---------------------------------------------------------

.. _19.3.4|EKB-6098:


A utility to associate and disassociate devices to Unified CM application users
can be made available by high level administrators so that it shows on administrator
menus on the user interface. 

The utility simplifies this association and disassociation of a large number of
Phones, CTI Route Points or Device Profiles to app users (``device/cucm/AppUser``).
This would for example be in the case of large contact center deployments.

The model to expose on the administrator menu layout is ``view/AddRemoveDeviceAppUser``.
This menu can be available from the Legacy Admin Portal or Admin Portal.
No Access Profile updates are needed for the default administrator access profiles.

.. raw:: html

   <p>For details on customizing menu layouts, see <a href="tasks-menu-layout.html">Create a Menu Layout</a>.</p>


.. raw:: latex

   For details on customizing menu layouts, see *Create a Menu Layout* in the 
   Core Feature Guide.

Procedure
..........

.. important::

   The utility is available only at site level, so that only devices and device profiles
   at that level are available for management.


1. Select an **Application User** to manage.

   The list of application users are those at and above the current site hierarchy.

   You can associate **Devices** and **Device Profiles** with the same application user by
   means of side-by-side transfer boxes.
2. Choose the **Action**: either to associate or disassociate devices or device profiles.

   * When associating, only devices or device profiles not associated to the user
     at the current hierarchy are shown in the **Available** transfer box.
   * When disassociating, only devices or device profiles associated to the user
     at the current hierarchy are shown in the **Available** transfer box.
3. Optionally, add a substring filter in the **Filter Devices** or **Filter Device Profiles**.
4. Manage the items in the **Available** and **Selected** transfer boxes.   

   .. note:: 

      * Since the transfer boxes can only list 200 items, filters should be chosen to manage
        more items. The filter uses the "contains"  case insensitive method. A notification
        is however displayed showing the total number of items.
      * The Legacy Admin Portal transfer boxes controls do not include a "transfer all" control -
        the muli-select of items in the "from" box is required.
      * In the Admin Portal, a filter is available within the transfer boxes.
        This filter only applies to the 200 items (or less) within the transfer box.
5. Click **Save** to carry out the selected action.

   Inspect the transaction log to verify the action. The **Detail** message
   includes the username of the app user.

.. note::

   A database lock is used in the resulting transaction in order to ensure parallel
   transactions do not conflict.