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. Он будет использоваться во время процесса установки автоматически.

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

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

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

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

Для того, чтобы обрабатывать информацию о назначенных встречах и совещаниях, 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, используемый по умолчанию, или любой другой нестандартный порт, строка так же должна включать в себя номер этого порта:

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

Обратите внимание: если ваш сервер CommuniGate Pro обслуживает единственный домен, можно указать эту строку в явном виде:

где mail.mydomain.com это имя Домена CommuniGate Pro или его псевдоним. Это имя должно иметь в DNS A-запись, указывающую на сервер CommuniGate Pro.

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

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

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

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

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

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

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

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-Коннектора возникают проблемы, пожалуйста, проверьте сначала, содержится ли проблема в этом списке.