Предварительная настройка
Для синхронизации с 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:
•AppointmentsToExternal_NotSyncedAppointmentsLimit — Лимит встреч, которые нужно выгружать при обновлении внешних встреч по встречам, которые не были обновленны при стандартном процессе работы. Максимальное число необновленных календарных событий, которые синхронизируются из "Первой Формы" в Exchange при открытии соединения
•AppointmentsToTasks_OccurrencesCountLimit — Число повторений, которые создаются для повторяющегося календарного события, если в самой повторяющейся задаче в блоке "Продолжительность" выбрано "Без ограничений". Значение ключа влияет на синхронизацию повторяющихся событий.
•AppointmentsToTasks_OccurrencesDaysLimit — Число дней, в течение которых синхронизируются календарные события между "Первой Формой" и Exchange (вперед, начиная с текущей даты).
•EWSDoNotCheckUserRight, EWSShowBusyStatus — Возможность просмотра всех событий календаря другого пользователя, даже если у текущего пользователя нет к ним доступа в Exchange. Такие события отображаются в календаре без названия и деталей, если ключ EWSDoNotCheckUserRight принимает значение "false", а ключ EWSShowBusyStatus — "true". Комбинации значений ключей описаны здесь.
•ExchangeSubscriptionsToLog — Логирование созданиия подписок.
•ExchangeSemaphoreWait — Время ожидания семафора в миллисекундах (таймаут).
•ExchangeSemaphoreCount — Количество одновременно обрабатывающихся конкурентных запросов в семафоре.
•ExchangeConnectionLifetime — Время существования соединения с подписками.
•ExchangePermissionsCacheLifeTime — Время жизни кеширования Exchange. По умолчанию 5 минут.
