.. _user-phone-associate-tool:

Fix user phone associate tool
-------------------------------

.. _19.3.1|VOSS-642:

.. tip:: 

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


Overview 
...........

:bdg-primary:`Cisco`

Automate uses the associated or controlled devices value on the Cisco UCM 
user (user in Automate) to determine which phones are associated
to that user.

The **Fix User Phone Associate Tool** verifies that UCM phones in the system with the 
ownerID value set are correctly associated to the UCM user (user), 
for correct association in Automate. 

For example, you may have phones 
synced in from an existing environment for overbuild, where the ownerID
on the phones were set, but these were not associated from the UCM user perspective.
In this case, check whether you can see the phones in the user view, 
but it appears they are owned by the user. In this scenario, you can run the **User Phone Associate Tool** to 
correct the association.


.. note::

   When adding phones and users from *within* Automate, the phone-user relationship
   is bi-directional.


Run the Fix User Phone Associate Tool
.......................................

:bdg-primary:`Cisco`

1. Navigate to the hierarchy of the UCM and choose it from the **UCM** drop-down list.

   The **Number of Phones that will be checked** value that is displayed is the number of phones
   on the UCM, at the hierarchy, that have been synced in to Automate and have an ownerID set,
   but cannot be found to be an associated device of any user at the hierarchy, or lower.

#. Click **Save** to run the **User Phone Associate Tool**. 

   The tool searches in Automate for users that match the ownerID, and, if found, 
   their associated devices will be updated with the phone.

#. Re-run the tool for the selected UCM. For any of the checked phones that were set as associated
   devices, the **Number of Phones that will be checked** value will decrease accordingly.

   .. note::

      If a user already has other associated devices, any new associated devices will be appended 
      to the existing list.