.. _device_data_sync_errors_in_transactions:

Device Data Sync Errors in Transactions
---------------------------------------


.. _18.1-Patch-Bundle-3|EKB-697:
.. _19.2.1|EKB-3175:
.. _19.3.4-PB2|EKB-4098:

The DataSync from a device has two steps:

1. A list request for all the resources of a specific type is made, for example for
   a User or Phone.
2. Requests for detailed information of each resource of the specific type.

The tables below show errors raised by devices and how these are handled 
or written to the transaction log by VOSS Automate. In the case of failed transactions,
the tables point to possible causes of some errors.

.. note::
   
   * A number of CUCM device model errors are non-critical and will not fail data sync transactions.


* CUCM AXL handled by VOSS Automate (DataSync transaction final status is not failed)

.. tabularcolumns:: |p{4.5cm}|p{1.5cm}|p{5cm}|p{4cm}|

+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           |                             | VOSS Automate            |
| Model                        | Operation | Device Error Message Match  | DataSync                 |
|                              |           |                             | Action and/or error log  |
+==============================+===========+=============================+==========================+
|                              |           |                             | Ignored known            |
| LocalRouteGroup              | GET       | No Search Criteria Defined  | error                    |
|                              |           |                             |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | Item not valid: The         | Ignored known            |
| LdapDirectory                | GET       | specified LdapDirectory was | error                    |
|                              |           | not found                   |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | Item not valid: The         | Ignored known            |
| UniversalDeviceTemplate      | GET       | specified                   | error                    |
|                              |           | UniversalDeviceTemplate was |                          |
|                              |           | not found                   |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | Item not valid: The         |                          |
|                              |           | specified LicensedUser  was | Ignored known            |
| LicensedUser                 | GET       | not found','The endpoint    | error                    |
|                              |           | reference (EPR) for the     |                          |
|                              |           | Operation not found is      |                          |
|                              |           |                             |                          |
|                              |           | No License found for the    |                          |
|                              |           | specified user:             |                          |
|                              |           | Could not open database     |                          |
|                              |           | table                       |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | Invalid                     | Ignored known            |
| LdapSyncCustomField          | GET       | ldapConfigurationName       | error                    |
|                              |           |                             |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | Column (name) not found in  |                          |
|                              |           | any table in the query (or  | Ignored known            |
| EndpointReleaseKey           | GET       | SLV is undefined)','The     | error                    |
|                              |           | endpoint reference (EPR)    |                          |
|                              |           | for the Operation not found |                          |
|                              |           | is                          |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | Item not valid: The         | Ignored known            |
| DirNumberAliasLookupan dSync | GET       | specified                   | error                    |
|                              |           | DirNumberAliasLookupandSync |                          |
|                              |           | was not found               |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | endpoint reference (EPR)    | Ignored known            |
| DeviceSerialNumber           | GET       | for the Operation not found | error                    |
|                              |           | is                          |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
|                              |           | The endpoint reference      | Ignored known            |
| LicenseCapabilities          | GET       | (EPR) for the Operation not | error                    |
|                              |           | found is                    |                          |
+------------------------------+-----------+-----------------------------+--------------------------+
| PhoneTypeDisplayInstance     | GET       | Wrong value for Protocol.   | Not all Phone Types have |
|                              |           | Please enter a valid value. | Vendor Config Rules.     |
|                              |           |                             | Ignored.                 |
+------------------------------+-----------+-----------------------------+--------------------------+

* HCMF handled by VOSS Automate (DataSync transaction final status is not failed)

.. tabularcolumns:: |p{4.5cm}|p{1.5cm}|p{5cm}|p{4cm}|

+--------------------------------+-----------+----------------------------+-------------------------+
|                                |           |                            | VOSS Automate           |
| Model                          | Operation | Device Error Message Match | DataSync                |
|                                |           |                            | Action and/or error log |
+================================+===========+============================+=========================+
|                                |           |                            | Ignored known           |
| TransportModeSettings          | GET       | API Call Error [404]       | error                   |
|                                |           |                            |                         |
+--------------------------------+-----------+----------------------------+-------------------------+
|                                |           |                            | Ignored known           |
| SmartAccountsAccessCredentials | GET       | API Call Error [404]       | error                   |
|                                |           |                            |                         |
+--------------------------------+-----------+----------------------------+-------------------------+

* CUCM Device errors not handled by VOSS Automate (DataSync transaction final status is failed)

.. tabularcolumns:: |p{3.5cm}|p{1.5cm}|p{3.5cm}|p{6.5cm}|

+--------------+-----------+--------------+-------------------------------------+
| Model        | Operation | Model Error  | Possible Cause                      |
+==============+===========+==============+=====================================+
|              |           |              | A workflow in VOSS Automate deleted |
| (All         | GET       | Resource not | an item between the DataSync        |
| model types) |           | found        | LIST operation and the GET          |
|              |           |              | operation                           |
+--------------+-----------+--------------+-------------------------------------+
|              |           |              | This is a non-specific error        |
| (All         | GET       | AXL Error    | raised by CUCM. Follow up with      |
| model types) |           | [-1]         | the CUCM team.                      |
+--------------+-----------+--------------+-------------------------------------+

* CUC Device errors not handled by VOSS Automate (DataSync transaction final status is failed)

.. tabularcolumns:: |p{3cm}|p{1.5cm}|p{3.5cm}|p{7cm}|

+------------+-----------+-------------+-------------------------------------+
| Model      | Operation | Model Error | Possible Cause                      |
+============+===========+=============+=====================================+
|            |           |             | A workflow in VOSS Automate deleted |
| (All model | GET       | Resource    | an item between the DataSync        |
| types)     |           | not found   | LIST operation and the GET          |
|            |           |             | operation                           |
+------------+-----------+-------------+-------------------------------------+
|            |           |             | 1. A sync between CUC and           |
|            |           |             |    LDAP is running at the           |
|            |           |             |    same time as the VOSS Automate   |
|            |           |             |    sync to CUC.  If the             |
|            |           |             |    User is disabled or              |
|            |           |             |    deleted on LDAP, then            |
|            |           |             |    the User would removed           |
| ImportUser | GET       | Resource    |    as an Import User on CUC.        |
|            |           | not found   |                                     |
|            |           |             | 2. A workflow on VOSS Automate      |
|            |           |             |    promoted a user from Import      |
|            |           |             |    User to User by creating a       |
|            |           |             |    Voicemail Box for that User,     |
|            |           |             |    which also causes the user       |
|            |           |             |    to be removed as Import          |
|            |           |             |    User and created as a full       |
|            |           |             |    User.                            |
+------------+-----------+-------------+-------------------------------------+