| Версия 5.2
Введение
Установка
Администрирование
Сеть
Объекты
Почта
Сигналы
Доступ
Услуги
Справочник
Кластеры
Программы
Разное
Лицензирование
Веб Почта
Pronto!
PBX
Обзор | POP | IMAP | WebUser | XIMSS | MAPI | AirSync | CalDAV | FTP | TFTP | ACAP
# MAPI-Коннектор Обзор технологии, используемой MAPI-Коннектором Установка MAPI-Коннектора Создание Почтового Профиля Настройка MAPI-Коннектора Сервер Установки Пользователя Подключение Дополнительно Разрешение Совместного использования Папки Делегирование Информация о Занятости Публикация информации Свободен/Занят Доступ к информации Свободен/Занят Других Пользователей Работа в Автономном режиме Задание Автоматических Правил Интеграция с Веб Доступом к почте Взаимодействие с пользователями Microsoft Exchange Коммуникации Реального Времени Шифрование на Сервере Устранение проблем Известные ограничения Сервер CommuniGate Pro может использоваться как "сервис провайдер" для приложений Microsoft Windows, поддерживающих MAPI (Microsoft Messaging API). Для того, что бы использовать этот сервис, на клиентских рабочих станциях Microsoft Windows должна быть установлена специальная библиотека-Коннектор (`dll` MAPI-Коннектора CommuniGate Pro). Использование MAPI-Коннектора CommuniGate Pro требует специального Лицензионного Ключа для групповой работы или специального Лицензионного Ключа MAPI. Вы можете ознакомится с Историей Изменений MAPI Коннектора для CommuniGate Pro.

## Обзор технологии, используемой MAPI-Коннектором

MAPI означает Messaging Application Programming Interface (Интерфейс для Прикладного Программирования обмена Сообщений); он является компонентом системы, которую корпорация Microsoft включила в операционные системы Windows® и используется приложениями Windows.

Инфраструктура MAPI вводит дополнительный уровень абстракции. Windows приложения не взаимодействуют непосредственно с сервером (или иным другим "хранилищем данных"). Вместо этого, приложения отправляют запросы на работу с сообщениями (типа "показать содержимое папки", "загрузить сообщение номер Х" и т.д.) компоненту MAPI, который, в свою очередь, использует установленный модуль "Коннектор" для отправки этих запросов на сервер Exchange®, в хранящиеся локально "персональные папки", на факс-сервер и т.д.

Расширяемая природа архитектуры MAPI делает возможным создание дополнительных "Коннекторов", которые могут взаимодействовать с различными серверами. Одной из проблем, которую должен решать такой Коннектор, является формат данных: Приложения Windows отправляют объекты данных через MAPI в модуль Коннектор в так называемом формате "MAPI объекта", в действительности имеющего мало общего с любым Интернет форматом. MAPI-Коннектор CommuniGate Pro преобразовывает данные MAPI в один из стандартных Интернет форматов и сохраняет преобразованные "объекты сообщений" как стандартные Интернет сообщения в папке CommuniGate Pro. Когда осуществляется чтение данных из папок на сервере, MAPI-Коннектор CommuniGate Pro преобразовывает (транслирует) сообщения обратно в формат "MAPI-объектов" и передает преобразованные объекты в Windows и MAPI приложения (такие, как Outlook).

MAPI-Коннектор CommuniGate Pro действует как MAPI-провайдер. Он принимает MAPI-запросы из Microsoft Outlook, работающего в режиме корпоративной рабочей группы (Outlook 98, Outlook 2000, Outlook XP, Outlook 2002 и более поздние), а так же запросы от других приложений Windows. Затем MAPI-Коннектор преобразовывает эти запросы в расширенные команды IMAP и посылает их на сервер CommuniGate Pro.

MAPI-Коннектор CommuniGate Pro также выполняет преобразование данных между "объектами" - собственным форматом данных Microsoft и стандартными форматами данных Интернет.
Благодаря использованию стандартных форматов Интернет, к сообщениям, сохранённым MAPI-Коннектором CommuniGate Pro может быть получен доступ через почтовые клиенты, работающие по стандартам POP3 или IMAP, через Веб Интерфейс Пользователя CommuniGate Pro или любой клиент XIMSS.

MAPI-Коннектор CommuniGate Pro работает в TCP/IP сетях и должен быть настроен на использование незашифрованного соединения (не TLS) с вашим сервером CommuniGate Pro (стандартный порт IMAP 143).

MAPI-Коннектор CommuniGate Pro поддерживает работу как по незашифрованному, так и по безопасному (SSL/STARTTLS) соединению и может использовать и незащищённые, и безопасные CRAM-MD5 методы Аутентификации.

MAPI-Коннектор CommuniGate Pro состоит из двух частей (совместно используемых библиотек). Часть запускающая код должна быть установлена на рабочей станции Windows. Она обеспечивает интерфейс для конфигурации и используется для соединения с сервером CommuniGate Pro. Основная функциональность MAPI-Коннектора реализована как совместно используемая библиотека, хранящаяся в директории приложений Сервера; эта часть называется серверный код.
Когда запускающая код часть MAPI-Коннектора соединяется с Сервером CommuniGate Pro, Сервер отправляет часть с серверным кодом MAPI-Коннектора на компьютер клиента.
Этот метод позволяет вам производить текущие обновления MAPI-Коннектора, обновляя только серверную часть программного обеспечения CommuniGate Pro и не запускать Установщик MAPI-Коннектора на всех клиентских рабочих станциях.

## Установка MAPI-Коннектора

Вам нужно установить запускающую код часть MAPI-Коннектора (`.dll` файл) на рабочие станции, работающие под управлением Microsoft Windows. Загрузите архив, содержащий MAPI-Коннектор и распакуйте его. В распакованной папке содержится файл `Setup.exe`.

Запустите `Setup.exe` для того, что бы установить или обновить программное обеспечение MAPI-Коннектора CommuniGate Pro. После успешной установки, приложение может попросить вас создать заново ваш почтовый профиль.

Вы можете использовать то же самое приложение `setup.exe` для удаления программного обеспечения MAPI-Коннектор с рабочих станций.

Программа `Setup.exe` MAPI-Коннектора может быть запущена в тихом режиме (без использования диалогового интерфейса пользователя) с помощью следующих аргументов командной строки:

`/i` | установить или обновить MAPI-Коннектор
`/r` | удалить MAPI-Коннектора
`/q` | Не запрашивать настройку профиля
`/Q` | не выводить сообщения об ошибках

Вы можете использовать тихий режим для установки или обновления части, запускающей код, на нескольких рабочих станциях, использую методы и средства сетевого администрирования Windows.

Для автоматического задания Установок Пользователя и Совместно используемых ресурсов может использоваться файл `cgmxui32.inf`. Загрузите этот файл и измените как вам необходимо, затем поместите его в ту директорию, где находится приложение `setup.exe`. Он будет использоваться во время процесса установки автоматически.

## Создание Почтового Профиля

Когда MAPI-Коннектор CommuniGate Pro установлен на клиентской рабочей станции, вы можете создать почтовый профиль, который позволит Outlook и другим приложениям использовать сервисы MAPI CommuniGate Pro.

Если вы используете Outlook 98 или Outlook 2000, нужно убедиться, что он настроен для работы в режиме группового взаимодействия. Запустите Outlook, выберите пункт `Options` ("Параметры") из меню `Tools` ("Сервис"). Появится диалоговое окно пункта Options. Выберите вкладку `Mail Services` ("Почтовые сервисы") и щелкните по кнопке `Reconfigure Mail Support` ("Перенастроить почтовую поддержку") для того, что бы открыть диалоговое окно `E-mail Service Options` ("Варианты работы службы электронной почты"). Проверьте, что выбран пункт `Corporate или Workgroup`.
Обратите внимание: для переключения режима Outlook вам может потребоваться установочный диск от MS Office.

Откройте в Панели Управления пункт `Mail` ("Почта") и нажмите кнопку `Show Profiles`. Появится список Почтовых профилей. Если программа установки MAPI-Коннектора CommuniGate Pro попросила пересоздать существующий почтовый Профиль, выберите старый Профиль и нажмите кнопку `Remove` ("Удалить").

Нажмите на кнопку `Add` ("Добавить") для того, что бы создать новый Профиль. В зависимости от установленной версии Outlook и Mail в Панели Управления вы можете увидеть различные диалоговые окна. Если вы видите диалоговое окно с опцией `Additional Server Types` ("Дополнительные типы серверов"), то выбирайте её. Укажите там что `Сервер CommuniGate Pro` является сервисом (service), или сервером дополнительного типа ("Additional server type").

Вы так же можете добавить другие сервисы в тот же самый Профиль.

## Настройка MAPI-Коннектора

После того, как сервис CommuniGate Pro добавлен в Почтовый профиль, параметры сервиса могут быть перенастроены. Позже вы можете выбрать пункт `Mail` ("Почта") в Панели Управления, открыть там требуемый Профиль и изменить установки сервиса `CommuniGate Pro`. Вы можете также использовать пункт `Services` в меню `Tools` программы Outlook для того, что бы изменить установки сервиса CommuniGate Pro.

### Сервер

Панель Server (Сервер) позволяет вам указать данные сервера CommuniGate Pro и данные Пользователя:

`Server Name`
  Это имя вашего сервера CommuniGate Pro. Оно должно быть именем домена, имеющего A-запись в DNS, указывающую на IP-адрес сервера.
  Обратите внимание: MAPI-Коннектор добавляет это имя к Имени Пользователя (смотрите ниже), что бы сформировать полное имя пользователя и отправить его на сервер. Эта возможность упрощает поддержку нескольких доменов на одном IP адресе. Убедитесь, что указанное имя является или именем некоторого Домена, обслуживаемого CommuniGate Pro, или Псевдонимом Домена, зарегистрированным в CommuniGate Pro; в противном случае сервер выдаст сообщение об ошибке `the account has been moved to a remote system` ("пользователь был передвинут на удаленную систему").
`Server Port`
  Порт, который использует сервер CommuniGate Pro для MAPI клиентов. Это тот же порт, что используется для IMAP клиентов.
`Use a Secure (SSL/TLS) connection`
  Если выбрана эта опция, MAPI-Коннектор устанавливает незащищённое сетевое соединение на указанный порт и использует команду STARTTLS для того, что бы шифровать все данные, пересылаемые между рабочей станцией и Сервером. Команда STARTTLS позволяет вам использовать один и тот же IMAP порт как для незащищённых, так и для безопасных соединений.
  Если выбрана эта опция и указан Порт Сервера 993 (стандартный номер порта для безопасных IMAP соединений), то MAPI-Коннектор будет устанавливать с этим портом безопасное соединение. Этот метод должен использоваться только в том случае, если единственным доступным портом на сервере является порт для установки безопасных IMAP соединений.
  Дополнительную информацию смотрите в разделе PKI.
`Use Windows Integrated Authentication (Kerberos)`
  Если ваша рабочая станция Windows входит в Windows/Active Directory Домен или контролируется другим Центром Распространения Ключей (KDC) Kerberos, то выберите эту опцию. MAPI-Коннектор будет использовать ваше имя пользователя и права в Windows для соединения с сервером CommuniGate Pro.
  Если вы используете эту опцию, то убедитесь, что:
  - У этого Пользователя CommuniGate включён метод Аутентификации через Kerberos.
  - Ваш Домен в CommuniGate Pro имеет соответствующие Kerberos Ключи, экспортированные из Active Directory или Центра Распространения Ключей (KDC) Kerberos.
`Use the Following Authentication details`
  Укажите эту опцию, если вам необходимо явно задавать имя Пользователя.
  `Account Name`
    Это имя пользователя, с которой будет работать сервер CommuniGate Pro. Имя может быть полным и иметь вид `accountName@domainName`. Если используется простая форма имени (имя, не содержащее символ `@`), то MAPI-Коннектор добавит значение, указанное в поле `Server Name`, к указанному имени пользователя.
  `Password`
    Пароль для указанного Пользователя CommuniGate Pro.
  `Remember Password`
    Если этот флажок не отмечен, MAPI-Коннектор будет открывать диалоговое окно Входа на сервер каждый раз, когда ему необходимо будет соединиться с сервером CommuniGate Pro. Если эта опция выбрана, указанный пароль будет сохранен в настройках MAPI-Коннектора.
  `Use Secure Authentication`
    Если отмечен этот флажок, MAPI-Коннектор пересылает пароли, используя безопасный (шифрующий) SASL CRAM-MD5 метод. Безопасный метод не будет работать, если пароли хранятся на сервере с использованием метода одностороннего шифрования (дополнительную информацию смотрите в разделе Безопасность). В этом случае этот флажок не должен быть отмечен, а MAPI-Коннектор будет пересылать пароли в открытом виде.
    Обратите внимание: если, соединяясь с сервером через публичные сети, вам необходимо пересылать пароли в открытом виде, то целесообразно отметить флажок `Use a Secure connection` ("Использовать безопасное соединение"), что бы вся информация передавалась в зашифрованном виде .

### Установки Пользователя

Диалоговое окно Account Settings ("Установки Пользователя") открывается при нажатии кнопки Account Settings на панели Server. Это окно позволяет вам указать имя Пользователя, используемое MAPI-Коннектором, а так же другие настройки общего характера:

### Подключение

Панель Connection ("Подключение") позволяет вам выбрать используемый метод сетевого соединения.

`Offline`
  При необходимости работы в автономном режиме (без соединения с сервером, используя только локальный кэш сообщений), вы можете указать Коннектору всегда начинать работу в автономном режиме.
  Это предотвратит попытки соединения при старте (например, ваш модем не будет пытаться совершить вызов).

### Дополнительно

На панели Advanced ("Дополнительно") вы можете указать других Пользователей CommuniGate Pro, с которыми вы хотите работать.

Используйте кнопки Add и Remove ("Добавить и Удалить") для того, что бы указать дополнительные имена Пользователей CommuniGate Pro. Если вы хотите получить доступ к Пользователю, находящемуся в другом домене, укажите его полное имя в форме: `accountName@domainName`.

Пользователи должны дать вам права на доступ к их папкам, в противном случае вы не сможете видеть и открывать папки, принадлежащие этим Пользователям. Дополнительную информацию смотрите в разделе Папки.

Настройки, указываемые в Синхронизации, будут доминировать над настройками выбора папок для работы в Автономном режиме.

`Include all folders in Send/Receive operation`
  Используйте эту опцию для того, что бы выбрать для загрузки все папки пользователя, игнорируя выбор, сделанный в Outlook -> Tools -> Options -> CommuniGate Pro.
`Always download entire message`
  Если эта опция отмечена, то Коннектор будет загружать сообщения полностью (в противном случае будут загружаться только Заголовки сообщений).

Для задания места, в котором MAPI-Коннектор должен хранить свой локальный кэш, используйте настройки Корневой папки Кэша файлов. Локальный кэш будет использоваться для большинства операций MAPI-Коннектора; он также позволяет вам использовать MAPI приложения (такие, как Outlook) в автономном режиме.

`Local Outlook Application Data folder`
  Используйте эту опцию если вы хотите хранить кэш файлы в месте, используемом на вашей рабочей станции по умолчанию. Этот кэш будет доступен только на этой рабочей станции.
`Global Outlook Application Data folder`
  Используйте эту опцию если вы хотите задействовать возможности Windows по работе на разных компьютеров и планируете использовать Outlook на нескольких компьютерах.
  Обратите внимание: кэш файлы могут быть довольно большими (так как, в зависимости от настроек Коннектора, в них может содержаться полная копия всех ваших папок, находящихся на сервере). Если кэш файлы становятся слишком большими, вы можете столкнуться с задержками при входе на другую рабочую станцию, так как это рабочая станция должна будет скопировать все данные заново.
`Custom`
  Используйте эту опцию, если вы хотите хранить кэш файлы в специальном месте. Например, для того что бы избежать задержек при работе с других компьютеров, вы можете выбрать совместно используемую папку на файловом сервере.

## Разрешение Совместного использования Папки

Вы можете задать Список Прав Доступа для ваших папок для того, что бы предоставить доступ к этим папкам другим пользователям CommuniGate Pro.

Выберите папку в Списке Папок Outlook и затем, используя элемент меню `Properties`, откройте диалоговое окно Свойства. Откройте панель Permission:

Используйте кнопку Add ("Добавить") и Remove ("Удалить") чтобы указать пользователей и другие идентификаторы, которые должны иметь доступ к объекту.

Выберите идентификаторы из списка и используйте соответствующие флажки, чтобы предоставить требуемые права этому идентификатору. Дополнительную информацию о Списке Прав Доступа к папкам смотрите в разделе Папки.
Обратите внимание: для того, что бы указать в Вид Папки по умолчанию, пользователь должен иметь Право Доступа к Папке Управлять.

## Делегирование

MAPI-Коннектор поддерживает возможность "делегирования": пользователи могут отправлять электронную почту и приглашения действуя "от имени"других пользователей или "в качестве" дргуих пользователей.

Для делегирования кому-либо прав действовать от имени вашего Пользователя, предоставьте ему право Входить для вашей папки INBOX.

## Информация о Занятости

Информация Свободен/Занят (Информация о Занятости) - это файл, указывающий когда пользователь занят, свободен, находится вне офиса и так далее. Обычно эта информация доступна всем пользователям и все имеют к ней доступ, когда планируют собрания, назначают встречи и т.д. Для того, чтобы получить данные Свободен/Занят, клиентское приложение, обеспечивающее групповое взаимодействие, собирает данные из календаря (календарей) пользователя и помещает ее в единое расписание Свободен/Занят.

### Публикация информации Свободен/Занят

MAPI-Коннектор хранит информацию Свободен/Занят в Хранилище Файлов Пользователя.
Публично доступная информация в стандартном формате vCalendar содержится в файле `freebusy.vfb` в корневой директории вашего Хранилища Файлов.

Обратите внимание: Убедитесь, что ваши Установки Пользователя в CommuniGate Pro позволяют MAPI-Коннектору сохранить файл с информацией Свободен/Занят.

Эта возможность позволяет пользователям Outlook и другим клиентам, обеспечивающим функции работы с Календарём, получать доступ по HTTP к вашему Хранилищу Файлов и загружать вашу информацию Свободен/Занят. Ссылка на информацию пользователя Свободен/Занят для Коннектора CommuniGate Pro имеет вид:
http://domainName:port/~accountName/freebusy.vfb

### Доступ к информации Свободен/Занят Других Пользователей

Для того, чтобы обрабатывать информацию о назначенных встречах и совещаниях, Outlook на клиентской машине должен получить доступ к информации Свободен/Занят других пользователей. Эта операция не осуществляется через MAPI-Коннектор и должна быть выполнена непосредственно программой Outlook. Для того, чтобы настроить Outlook, нужно выполнить следующие действия:

- Установите `Microsoft Web Publishing Wizard` (Мастер настройки Веб Публикаций); он может быть загружен с веб-сайта www.microsoft.com .
- Выберите пункт Options из меню Tools для того, что бы открыть диалоговое окно Options.
- Щелкните по кнопке Calendar Options, что бы открыть диалоговое окно Calendar Options.
- Щелкните по кнопке Free/Busy Options, что бы открыть диалоговое окно Free/Busy Options.
- Введите ссылку `http://%SERVER%/~%NAME%/freebusy.vfb` в поле Search (смотрите подробности ниже).
- Нажмите на кнопку OK, чтобы закрыть все диалоговые окна.

Эта опция будет использована приложением Outlook, когда ему необходимо получать информацию Свободен/Занят для пользователя электронной почты. Приложение осуществляет подстановку подстроки %SERVER% на домен из адреса электронной почты пользователя, а вместо подстроки %NAME% подставит имя пользователя электронной почты (его пользовательскую часть, без домена). Таким образом, если используется адрес электронной почты `john@myserver.com`, то Outlook сформирует строку `http://myserver.dom/~john/freebusy.vfb` и будет использовать этот URL для доступа к информации Свободен/Занят пользователя John.

Обратите внимание: указанная строка будет работать, только если Веб Интерфейс Пользователя вашего сервера CommuniGate Pro принимает соединения на порту 80. Если используется другой порт, например порт 8100, используемый по умолчанию, или любой другой нестандартный порт, строка так же должна включать в себя номер этого порта:
http://%SERVER%:8100/~%NAME%/freebusy.vfb

Обратите внимание: указанная строка будет работать, только если Домен, обслуживаемый сервером CommuniGate Pro, имеет в А-запись DNS, указывающую на сервер CommuniGate Pro. Зачастую в DNS не содержится такой ссылки на домен `mydomain.dom` или ссылка указывает на другое место, например на Веб Сервер компании, а сервер CommuniGate Pro находится по адресу `mail.mydomain.dom` (или `cgate.mydomain.dom`, `mx.mydomain.dom` или нечто подобное). В этом случае Search URL дожен быть изменён таким образом, что бы он указывал на правильное имя домена:
http://mail.%SERVER%/~%NAME%/freebusy.vfb

Обратите внимание: если ваш сервер CommuniGate Pro обслуживает единственный домен, можно указать эту строку в явном виде:
http://mail.mydomain.com/~%NAME%/freebusy.vfb
где mail.mydomain.com это имя Домена CommuniGate Pro или его псевдоним. Это имя должно иметь в DNS A-запись, указывающую на сервер CommuniGate Pro.

Строка поиска, указанная выше, позволяет пользователям получать информацию Свободен/Занят для пользователей той же системы CommuniGate Pro.

Строка поиска может использоваться для получения информации Свободен/Занят для пользователей других Серверов CommuniGate Pro; для этого она должна содержать в себе корректные ссылки на файлы с информацией Свободен/Занят других пользователей. На панели Advanced ("Дополнительно") вы можете указать других Пользователей CommuniGate Pro, с которыми вы хотите работать. Смотрите дополнительную информацию об этих настройках в руководстве по Microsoft Outlook.

## Работа в Автономном режиме

Когда вы работаете в Автономном режиме, MAPI-Коннектор не имеет доступа к сообщениям, хранящимся на сервере CommuniGate Pro. Для того, что бы иметь возможность работать продуктивно, вы должны убедиться, что все необходимые вам сообщения хранятся в локальном кэше MAPI-Коннектора. Вы можете задавать опции кэширования отдельно для каждой папки.

Через пункт Options ("Параметры") в меню Tools ("Сервис") программы Outlook откройте диалоговое окно Options ("Параметры"). Затем откройте панель CommuniGate Pro:

Выберите папку, с которой вам необходимо работать в Автономном режиме, и затем выберите метод загрузки. Если вы выберите загрузку всего сообщения, то имя папки будет выделено жирным шрифтом, а если вы выберите загрузку только заголовков сообщений, то имя папку будет просто отмечено флажком.

Используйте в Outlook меню Tools -> CommuniGate Pro Server (Сервис -> Сервер CommuniGate Pro) для синхронизации изменений, сделанных вами в Автономном режиме с сервером CommuniGate Pro.

Синхронизация происходит при запуске операций Отправки/Приёма почты (вручную или автоматически, с использованием расписания).

`Mark to Download Message(s)`
  Сообщения, выбранные в Просмотре Папки в Outlook будут отмечены и при следующей операции Отправления/Приёма почты будут загружены целиком.
`Mark to Delete Message(s)`
  Сообщения, выбранные в Просмотре Папки в Outlook будут отмечены и при следующей операции Отправления/Приёма почты будут удалены с Сервера.
`Unmark Selected Headers`
  Отменяет все операции с сообщениями, выполненные при Просмотре Папки Outlook работе в автономном режиме и ожидающие выполнения на сервере.

## Задание Автоматических Правил

MAPI-Коннектор позволяет вам создать Правила, выполняемые на сервере, с помощью которых вы можете обрабатывать всю почту Пользователя.

Используйте команду меню Tools->CommuniGate Pro (Сервис -> Сервер CommuniGate Pro) для того, что бы открыть окно редактора Правил:

Для того, что бы создать новое Правило, нажмите на кнопку New... ("Новое"). Новое Правило не имеет условия и действия.

Нажмите на кнопку Add ("Добавить"), для того, что бы добавить условия и действия:

Дополнительную информацию смотрите в разделе Автоматические Правила.

## Интеграция с Веб Доступом к почте

MAPI-Коннектор использует настройки Веб Интерфейса Пользователя. Он предписывает MAPI приложениям (таким как Microsoft Outlook) использовать заданные в Веб Интерфейсе Пользователя имена для "специальных" папок. В результате MAPI приложения и Веб Интерфейс Пользователя используют одни и те же папки Trash или Deleted Items для хранения удалённых сообщений, используют одну и ту же папку для Основного Календаря и т.д.

MAPI-Коннектор также загружает настройку Приписка к Отправляемой Почте для Домена. Содержимое этой настройки добавляется для всех незашифрованных и неподписанных сообщений, передаваемых через MAPI-Коннектор.

Значения, указанные на панели Установки Пользователя, хранятся в Установках Веб Интерфейс Пользователя, так что как в сессии через Веб Интерфейс Пользователя, так и в MAPI сессии будут использоваться одинаковые значений полей Имя, Адрес Ответа, Организация.

## Взаимодействие с пользователями Microsoft Exchange

Пользователи Outlook, работающие через сервера Exchange, могут столкнуться с проблемой отправки приглашений на встречи в адрес пользователей, работающих через MAPI-Коннектор CommuniGate Pro. Приглашения на собрания, отправляемые через Exchange, могут приходить как обычные сообщения в простом текстовом формате. Пользователи Exchange должны правильно настроить Outlook:

  Пользователи Outlook, работающие через Exchange, должны выбрать пункт Options ("Параметры") из меню Tools ("Сервис") для того, что бы открыть диалоговое окно Options ("Параметры"). После этого они должны нажать на кнопку Calendaring Options ("Параметры календаря") и в появившемся диалоговом окне включить опцию `Send meeting requests using iCalendar by default` ("При отправке приглашений через Интернет использовать формат iCalendar").

## Коммуникации Реального Времени

MAPI-Коннектор позволяет пользователям Outlook использовать функции коммуникаций реального времени Сервера CommuniGate Pro.

Пользователи Outlook могут инициировать телефонные вызовы, используя телефонный номер, указанный в соответствующем поле в Контактах. Щёлкните правой кнопкой мыши по записи в Контактах, и в появившемся всплывающем меню выберите пункт Позвонить используя CommuniGate Pro:

Вы можете также использовать подменю Сервер CommuniGate Pro в меню Tools ("Сервис") программы Outlook.

Появиться диалоговое окно с именем Контакта и телефонным номером:
Вы можете использовать другой телефонный номер из второго поля. Этот номер будет использоваться только для этого вызова и не будет сохранён в Контактах.

Нажмите на кнопку Start Call ("Вызов") для того, что бы совершить звонок. Сразу же начнут звонить все ваши SIP-устройства. Ответив на звонок на каком-нибудь устройстве, Сервер свяжет это устройства с требуемым телефонным номером.

Появиться диалоговое окно, отображающее статус звонка:

## Шифрование на Сервере

MAPI-Коннектор позволяет вам использовать Правила, выполняемые на Сервере, включая и те, которые сохраняют сообщения в зашифрованном виде.

Вы можете повысить безопасность хранения определённых сообщений, полученных и сохранённых на сервере в открытом виде.

Щёлкните правой кнопкой мыши на требуемом сообщении в Outlook. Откроется всплывающее меню:

Когда вы хотите зашифровать какой-нибудь элемент, MAPI-Коннектор отсылает ваш Сертификат, используемый по умолчанию (и содержащий ваш Открытый Ключ) на Сервер. Сервер будет использовать этот Сертификат для того, что бы зашифровать выбранное сообщение. Оно будет храниться на Сервере в зашифрованном формате S/MIME - так, как если бы отправитель сообщения отослал его в зашифрованном виде.

Если вы хотите читать Зашифрованные сообщения через MAPI клиенты (Outlook) и через Веб Интерфейс Пользователя, убедитесь, что как в операционной системе Windows, так и в Веб Интерфейсе Пользователя используется одинаковые Секретные ключи и Сертификаты. Вы можете сгенерировать ключ и Сертификат через Веб Интерфейс Пользователя и затем экспортировать его в Windows или же вы можете экспортировать существующие ключи из Windows в настройки Веб Интерфейса Пользователя.

## Устранение проблем

MAPI-Коннектор работает как посредник между MAPI приложениями (такими как Microsoft Outlook) и Сервером CommuniGate Pro. Сложности, с которыми пользователь может столкнуться с в работе, могут быть вызваны как ошибками (или недокументированными возможностями) клиента, так и проблемами непосредственно в программном обеспечении MAPI-Коннектора или Сервера. Для того, что бы помочь устранить проблему, MAPI-Коннектор может создавать подробный Журнал всех своих операций. Вы можете исследовать этот Журнал самостоятельно или отослать его в службу технической поддержки CommuniGate Systems.

Откройте панель Troubleshooting ("Проблемы") в окне настройки MAPI-Коннектора CommuniGate Pro ("CommuniGate Pro Service"):

Панель показывает версию обеих компонентов MAPI-Коннектора: библиотеку запускающую код на компьютере клиента и библиотеку с серверным кодом, полученную с Сервера CommuniGate Pro.

Выберите опцию Enable Logging ("Вести журнал") для того, что бы MAPI-Коннектор начал вести Журнал. Журнал MAPI-Коннектора хранит только последние записи, таким образом размер файла Журнала не превысит значения, указанного в настройке Maximum Log File Size ("Журнал не более").

Используйте флажки для того, что бы указать, какие компоненты MAPI-Коннектора должны оставлять записи о своей активности в Журнале.

Нажмите на кнопку Show Me Log File ("Показать файл") для того, что бы открыть директорию файлов, в которой храниться файл Журнала. Вы можете использовать эту возможность для того, что бы отправить файл Журнала по электронной почте в службу технической поддержки компании CommuniGate Systems.

Нажмите на кнопку Delete Log File ("Очистить файл") для того, что бы очистить файл Журнала.

Используйте опции Compatibility ("Совместимость") для настройки операций MAPI-Коннектора в смешанной операционной среде (одновременно используемых MAPI клиентов разных поколений).

`Send in Outlook native message format`
  В некоторых редких случаях специальные сообщения (такие, как Назначение Задания или переадресованные Контакты), отправляемые через MAPI-Коннектор в Интернет-формате, могут неправильно интерпретироваться пользователями Outlook Exchange (или Outlook IMAP). Отметьте эту опцию для того, что бы решить эту проблему.
`Send in Outlook 2000 compatible format`
  Более старые версии Outlook могут иметь проблемы при обработке элементов данных Контакты или Календарь в форматах, используемых более новыми версиями Outlook. Выберите эту опцию для того, что бы использовать более старый формат для таких элементов данных.
`Send in Exchange 5.5 compatible format`
  Приглашения на Встрече в форматах, используемых в новых версиях Outlook, могут некорректно интерпретироваться серверами Exchange 5.5. Если кто-либо из ваших корреспондентов использует такую версию сервера Exchange и у него возникают проблемы с обработкой ваших Приглашений на Встречу, то отметьте эту опцию.
`Conservative mass deletion`
  В некоторых конфигурациях Outlook функция Автоархивирования может удалять большие объемы сообщений. Для избежания этой проблемы выберите эту опцию.
`Always convert RTF to HTML`
  Выбор этой опции приведёт к тому, что MIME части `text/rtf` в исходящих сообщениях будут преобразованы в HTML формат, поддерживаемый в большем количестве клиентских почтовых приложений.
`Do not display "Server transaction in progress..." dialog`
  Во время длинных транзакций Коннектор показывает окно с информацией о ходе их выполнения. Если вы не хотите этого, выберите эту опцию.
`Show reports in Outlook native format`
  Outlook может использовать специальную форму для отображения сообщений с уведомлением о недоставке, предоставляющую возможность отослать недоставленные сообщения повторно. Для того, чтобы это возможность работала корректным образом, сообщения о недоставке должны включать в себя полное недоставленное сообщение, что происходит не всегда.
`Do not respond to requests for read receipts`
  Отправитель сообщения может запросить отправки уведомления в свой адрес о том, что вы открыли сообщение для прочтения. Для того, что бы игнорировать эти запросы, выберите эту опцию.
`No history uploads for large messages`
  Для выполнения запросов Outlook на установку каких-либо расширенных свойств у сообщения, MAPI-Коннектор может загружать на сервер изменённые сообщения повторно. Для больших сообщений это может занимать довольно много времени. Для того, что бы запретить работу подобным образом, отметьте эту опцию.
`Erase messages immediately, do not mark for deletion`
  Для увеличения производительности, по умолчанию сообщения не удаляются немедленно, а помечаются на удаление; физическое удаление происходит при закрытии папки, в которой они содержатся. Если папки используется одновременно несколькими клиентами, то эти помеченные на удаление сообщения могут еще некоторое время появляться у других клиентов, вводя пользователей в заблуждение. Для избежания подобной ситуации отметьте эту опцию.
`Refresh connection every minute`
  Некоторые NAT устройства и антивирусные межсетевые экраны могут в очень агрессивной манере прерывать TCP соединения, которые, как они полагают, неактивны. Закрытые подобным образом IMAP сессии могут привести к сбоям в работе Outlook. Если эта опция отмечена, то MAPI-Коннектор будет производить некоторый минимальный обмен данными с сервером CommuniGate Pro и, таким образом, для межсетевого экрана соединение не будет выглядеть неактивным.
`Restrict search to downloaded items only`
  Поиск в атрибутах сообщения может потребовать загрузки всего сообщения клиенту. Для больших объемов сообщений это может занимать довольно много времени. Если эта опция отмечена, то поиск будет производится только в ранее загруженных MAPI-Коннектором сообщениях.

## Известные ограничения

Протокол и Интерфейс для Прикладных Программ, реализованный в MAPI-Коннекторе, являются не Интернет стандартом, а собственным Интерфейсом для Прикладных Программ Корпорации Microsoft®. Этот Интерфейс для Прикладных Программ не документирован полностью, что, в результате? может привести к тому, что некоторая (незначительная) функциональность Outlook не будет работать надлежащим образом. Компания CommuniGate Systems постоянно работает над устранением проблем такого рода, и регулярно выпускает обновления MAPI-Коннектора.

Существующий специальный список Известные проблемы MAPI содержит информацию об известных проблемах и о путях их решения. Если в работе MAPI-Коннектора возникают проблемы, пожалуйста, проверьте сначала, содержится ли проблема в этом списке.

Руководство CommuniGate® Pro. Copyright © 1998-2009, Stalker Software, Inc.