"Первая Форма" позволяет настроить синхронизацию внутреннего календаря со почтовым сервером Exchange. Это позволяет пользователям видеть в своем календаре Exchange события, созданные в "Первой Форме", и наоборот. Участники могут вносить изменения в параметры события и эти изменения будут отражены в "Первой Форме". Изменения параметров встречи в "Первой Форме" также синхронизируются в календарь.
Обратите внимание: если у пользователя в системе добавлено несколько календарей, при постановке встречи в календарь действует следующий приоритет: EWS, CalDav, внутренний календарь "Первой Формы". |
---|
Предварительная настройка
Для синхронизации с Exchange необходимо:
1. Адрес EWS.
2. Системная учетная запись на сервере Exchange.
3. Наличие прав доступа у данной учетной записи (п.2) к календарям: делегирование прав доступа к календарю (метод AddDelegate) или выдача служебному пользователю права перевоплощения в Exchange (impersonate).
Настройка интеграции
Процесс настройки интеграции с сервером MS Exchange зависит от наличия в системе синхронизации с Active Directory (AD).
Настроена синхронизация с AD
Если в системе настроена синхронизация с AD, включить синхронизацию календаря с сервером Exchange можно в настройках сервиса.
Добавьте сервис ExchangeWebService.
Настройки сервиса ExchangeWebService
Параметр |
Описание |
---|---|
Описание |
Название\краткое описание сервиса |
Домен |
Имя домена, используемого в компании |
Url |
Адрес вызова сервиса |
Логин |
Логин и пароль |
Пароль |
|
Использовать имперсонализацию |
Если настройка включена, то при синхронизации изменений из Первой формы в Exchange пользователь, под которым устанавливается соединение, будет перевоплощаться в пользователя от чьего имени нужно внести изменения на сервере Exchange. Иначе изменения будут совершаться от лица установившего соединение пользователя. Настройка сервиса "Использовать имперсонализацию" является более приоритетной, чем "Использовать перевоплощение " в общих настройках приложения. |
Использовать SID для перевоплощения |
Если настройка активна, для перевоплощения будет использован уникальный идентификатор SID, который берется из ActiveDirectory. В обратном случае используется Email. |
Разрешить пользователям смотреть чужие календари используя права системной учетной записи |
Если настройка активна, пользователи смогут видеть события других пользователей, используя права системной учетной записи. |
Показывать пользователям только занятость при просмотре календарей с чужого сервиса |
Если настройка активна, пользователи, которые не имеют отношения к текущему сервису, смогут увидеть в календаре коллег вместо календарных событий некликабельных синие слоты с заголовком Занят без детальной информации. Если пользователь при этом отсутствует в данный момент, в его профиле и краткой карточке будет отображаться только тип занятости: Занят, Под вопросом, Нет на месте, Свободен и время события. |
Показывать пользователям только занятость при просмотре чужих календарей с домашнего сервиса |
Если настройка активна, пользователи с домашнего сервиса смогут увидеть в календаре коллег вместо календарных событий некликабельных синие слоты с заголовком Занят без детальной информации. Если пользователь при этом отсутствует в данный момент, в его профиле и краткой карточке будет отображаться только тип занятости: Занят, Под вопросом, Нет на месте, Свободен и время события. |
При активной настройке "Использовать имперсонализацию", а также в случае, если пользователь находится в домене, вход в аккаунт осуществляется по SID. Если настрока "Использовать SID для перевоплощения" неактивна или SID отсутствует, а также, если имперсонализация не используется, вход в аккаунт осуществляется по почте, указанной в профиле пользователя. |
---|
После завершения настройки сервиса его необходимо выбрать в поле "Настройки EWS" при настройке синхронизации AD.
Поле "Настройки EWS"
Отсутствие синхронизации с AD
Если в системе не настроена синхронизация с AD, включить синхронизацию календаря с сервером Exchange можно в блоке Синхронизировать календарь с Exchange в общих настройках приложения.
Настройки синхронизации с Exchange Server
Параметр |
Описание |
---|---|
Адреc EWS |
Url адрес Exchange Web Service. Необходим для синхронизации календарей и импорта контактов Exchange. |
Категории событий которые не будут синхронизированы |
Список названий категорий Exchange, которые исключаются из процесса синхронизации. В качестве разделителя списка используется символ ";". |
Режим работы с сервисами Exchange |
Календарь "Первой Формы" будет синхронизироваться с календарем Exchange Server, для новых пользователей эта настройка будет включаться автоматически |
Синхронизировать календарь с Exchange (событийный режим) |
Календарь "Первой Формы" будет синхронизироваться с календарем Exchange Server каждый раз при любых изменениях календарных задач. Синхронизация осуществляется от имени пользователя, указанного в поле "Логин", он должен соответствовать следующим требованиям: •В настройках профиля активна опция "Сотрудник компании". •Участник группы Administrators - пользователь обладает правами администратора системы. |
Синхронизировать периодические встречи с Exchange |
Периодические встречи, созданные в "Первой Форме", синхронизируются с календарем Exchange Server. |
Не синхронизировать события старше, дней |
Для событийной синхронизации можно задать максимальное количество дней, за которые выполняется синхронизация календарных событий. Все события, дата окончания которых отстоит от текущей даты больше чем на указанное количество дней, исключаются из синхронизации – любые изменения таких событий в "Первой Форме" или в Exchange сохраняются только в той системе, где они были произведены. Если указано значение 0, то в синхронизации всегда участвуют все события |
Количество неудачных попыток |
Максимальное количество неудачных попыток синхронизации для конкретного пользователя. Если указано значение 0, то число попыток не ограничено. Если количество неудачных попыток синхронизации для конкретного пользователя превысило максимальное количество, установленное в настройках приложения, этот пользователь исключается из синхронизации календаря. В журнал пользователя записывается сообщение об остановке синхронизации. Также ошибки синхронизации фиксируются в общем системном журнале ошибок. Администратор может сбросить счетчик неудачных попыток синхронизации для конкретного пользователя в Профиле пользователя, на вкладке "Сервис", в блоке "Синхронизация с Exchange". Ошибки при синхронизации могут возникать, например, если календарь пользователя недоступен или переполнен. |
Использовать перевоплощение |
Если настройка включена, то при синхронизации изменений из Первой формы в Exchange пользователь, под которым устанавливается соединение (он указан в параметре "Логин"), будет перевоплощаться в пользователя от чьего имени нужно внести изменения на сервере Exchange. В этом случае нужно выдать служебному пользователю право перевоплощения в Exchange. Настройка является менее приоритетной, чем опция "Использовать имперсонализацию" в настройках сервиса. |
Доменная авторизация |
Если настройка активна, то синхронизация будет выполняться для сервера в домене, если отключена — то для сервера в рабочей группе |
Логин |
Логин и пароль пользователя, от имени которого выполняется синхронизация |
Пароль |
|
Домен |
Адрес домена |
Установка режима для пользователя
Для включения синхронизации необходимо выбрать Режим работы с сервисами Exchange — он находится во вкладке Сервис в настройках пользователя.
Синхронизация выполняется только для пользователей, обладающих лицензией "Первой Формы". Для пользователей без лицензии календарь не синхронизируется, даже если флажок "Синхронизировать календарь с Exchange" включен. |
---|
Блок "Режим работы с сервисами Exchange" во вкладке "Сервис"
Режимы работы:
•Выключено — Выключает синхронизацию с календарем Exchange.
•Онлайн — Включает синхронизацию с EWS напрямую. События в "Первой Форме" отображаются напрямую из Exchange без создания сущностей. Для корректной работы необходимо обновить систему до актуальной версии.
Для работы режима Онлайн требуется Exchange версии 2013 или выше |
---|
Для перехода на новую синхронизацию с EWS необходимо, чтобы учетная запись системно обладала правами олицетворения — они настраиваются на стороне Exchange.
•Синхронизация (Устаревшее, не рекомендуется использовать) — Включает синхронизацию с календарем Exchange. Режим синхронизирует все события между сервисами, создает задачи в "Первой Форме" из Exchange. Служебная функция, не должна быть включена для пользователей.
Дополнительные настройки
Запрет доступа к календарным событиям
Администратор может настроить ограничение доступа к информации обо всех календарных событиях коллег в системе — в таком случае пользователь будет видеть только свои встречи в календаре. При этом события других сотрудников будут отображаться в виде некликабельных синих слотов с заголовком Занят без детальной информации.
Если пользователь при этом отсутствует в данный момент, в его профиле и краткой карточке будет отображаться только тип занятости: Занят, Под вопросом, Нет на месте, Свободен и время события.
Отображение календаря другого пользователя при отсутсвии доступа
Для ограничения доступа к календарным событиям других пользователей необходимо выполнение одного из двух условий:
1. Право группы на группу "Просматривать календарные события членов группы" должно быть отключено для групп пользователей.
2. В настройках сервиса ExhangeWebService должна быть включена опция "Показывать пользователям только занятость при просмотре календарей с чужого сервиса".
Типы отсутствий
Для синхронизации с календарем Exchange цветового обозначения имен пользователей в зависимости от типа его занятости в настройках определенного типа отсутствия должна быть активна опция "Синхронизировать с Exchange".
Настройки типа отсутствия
Пользовательские ключи
Список пользовательских ключей, влияющих на работу с Exchange:
•AppointmentsToExternal_NotSyncedAppointmentsLimit — Лимит встреч, которые нужно выгружать при обновлении внешних встреч по встречам, которые не были обновленны при стандартном процессе работы. Максимальное число необновленных календарных событий, которые синхронизируются из "Первой Формы" в Exchange при открытии соединения
•AppointmentsToTasks_OccurrencesCountLimit — Число повторений, которые создаются для повторяющегося календарного события, если в самой повторяющейся задаче в блоке "Продолжительность" выбрано "Без ограничений". Значение ключа влияет на синхронизацию повторяющихся событий.
•AppointmentsToTasks_OccurrencesDaysLimit — Число дней, в течение которых синхронизируются календарные события между "Первой Формой" и Exchange (вперед, начиная с текущей даты).
•EWSDoNotCheckUserRight, EWSShowBusyStatus — Возможность просмотра всех событий календаря другого пользователя, даже если у текущего пользователя нет к ним доступа в Exchange. Такие события отображаются в календаре без названия и деталей, если ключ EWSDoNotCheckUserRight принимает значение "false", а ключ EWSShowBusyStatus — "true". Комбинации значений ключей описаны здесь.
•ExchangeConnectionPoolSize — Размер пула, допустимое количество одновременных соединений.
•ExchangeNotification_ConnectionLifetime — Время действия соединения при обновлении событий из Exchange в "Первой Форме".
•ExchangeSubscriptionsToLog — Логирование созданиия подписок.
•ExchangeSemaphoreWait — Время ожидания семафора в миллисекундах (таймаут).
•ExchangeSemaphoreCount — Количество одновременно обрабатывающихся конкурентных запросов в семафоре.
•ExchangeConnectionLifetime — Время существования соединения с подписками.
•ExchangePermissionsCacheLifeTime — Время жизни кеширования Exchange. По умолчанию 5 минут.