База знаний UtiClock
Техническое описание интеграции с Exchange/Office365/Teams
Приложение UtiClock поддерживает синхронизацию событий с сервером Microsoft Exchange. Мы используем клиент-серверную архитектуру в нашем продукте. Планшет с программным обеспечением UtiClock выполняет роль толстого клиента, а сервер с календарём в этом случае является хранилищем данных.
Для корректной работы синхронизации требуется установить на Exchange сервер EWS-Managed-API. EWS-Managed-API является официальным модулем компании Microsoft, предоставляющий API для получения и добавления событий в корпоративный календарь Exchange.
Важно, что Exchange сервер располагается на ресурсах заказчика, и компания Utinet не имеет и не должна иметь к нему доступ.
Планшет UtiClock выполняет https-запросы на Exchange сервер заказчика под отдельной учётной записью, используя исключительно задокументированное Microsoft API. EWS и управляемый API EWS предоставляют широкий набор операций и методов, которые позволяют выполнять широкий спектр задач, связанных с календарем. Например, с помощью управляемого API EWS можно создать собрание и отправить приглашения участникам с помощью всего нескольких строк кода, как показано в следующем примере.
Для корректной работы программного обеспечения UtiClock у учётной записи, из-под которой выполняются запросы, должны быть следующие права:
- права на чтение и запись событий в своём календаре,
- права на чтение и запись событий в календарях ресурсов,
- права на чтение и запись событий в календарях сотрудников,
- права на чтение всех ресурсов,
- права на чтение списка сотрудников,
- права на олицетворение почтового ящика Exchange
здесь Олицетворение и EWS в Exchange,
здесь Настроить олицетворение,
и здесь Добавление встреч с помощью олицетворения Exchange
Мы не добавляем на сервер клиента свой код, не встраиваем подозрительные модули или библиотеки, работаем исключительно с официальными библиотеками и используем штатный API системы с календарём. Никакие данные сотрудников и событий не передаются третьим лицам или на сторонние ресурсы.