|
Версия 6.4 |
|
| ||||||||||||||||||||||||
Обзор технологии, используемой 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 работает в TCP/IP сетях и должен быть настроен на использование порта для незашифрованного соединения (не TLS) с вашим сервером CommuniGate Pro (стандартный порт IMAP 143). MAPI-Коннектор CommuniGate Pro поддерживает работу как по незашифрованному, так и по безопасному (SSL/STARTTLS) соединению и может использовать и незащищённые, и безопасные CRAM-MD5 методы Аутентификации. MAPI-Коннектор CommuniGate Pro состоит из двух частей (совместно используемых библиотек). Часть запускающая код должна быть установлена на рабочей станции Windows. Она обеспечивает интерфейс для конфигурации и используется для соединения с сервером CommuniGate Pro. Основная функциональность MAPI-Коннектора реализована как совместно используемая библиотека, хранящаяся в директории приложений Сервера; эта часть называется серверный код. Установка MAPI-КоннектораВам нужно установить запускающую код часть MAPI-Коннектора (.dll файл) на рабочие станции, работающие под управлением Microsoft Windows. Загрузите архив, содержащий MAPI-Коннектор, и распакуйте его. В распакованной папке содержится файл Setup.exe. Запустите Setup.exe для того, чтобы установить или обновить программное обеспечение MAPI-Коннектора CommuniGate Pro. После успешной установки, приложение может попросить вас создать заново ваш почтовый профиль. Вы можете использовать то же самое приложение setup.exe для удаления программного обеспечения MAPI-Коннектор с рабочих станций. Программа Setup.exe MAPI-Коннектора может быть запущена в тихом режиме (без использования диалогового интерфейса пользователя) с помощью следующих аргументов командной строки:
Вы можете использовать тихий режим для установки или обновления части, запускающей код, на нескольких рабочих станциях, использую методы и средства сетевого администрирования Windows. Для локализации языка интерфейса MAPI-Коннектора может использоваться файл cgmxp32.ini. Поместите его в ту директорию, где находится приложение setup.exe. В процессе установки файл будет скопирован в C:\Windows (если MAPI-Коннектор был установлен ранее, то это можно сделать вручную). Для языка интерфейса MAPI-Коннектора будет установлен язык локализации ОС. Для автоматического задания настроек MAPI-Коннектора может использоваться файл cgmxui32.inf. Измените этот файл как вам необходимо (описание настроек приведено в файле), затем поместите его в ту директорию, где находится приложение setup.exe. В процессе установки файл будет скопирован в C:\Windows (если MAPI-Коннектор был установлен ранее, то это можно сделать вручную). Для создания конфигурации Outlook с заданными параметрами MAPI-Коннектора запустите командную строку от имени Администратора и выполните команду: regsvr32.exe cgmxui32.dll /i:16 Для Outlook 32-bit cgmxui32.dll находится в C:\Windows\SysWOW64 Для Outlook 64-bit cgmxui32.dll находится в C:\Windows\System32 В результате будет создана конфигурации Outlook с именем username_CGATE (где username - имя пользователя, вошедшего в систему), с заданными параметрами MAPI-Коннектора. Если в результате выполнения команды появляется сообщение об ошибке, убедитесь, что команда выполняется от имени Администратора, и файл cgmxui32.inf присутствует в C:\Windows. Альтернативный способ, не требующий прав Администратора: Запустить ex2cgp, соответствующую разрядности Outlook, со следующими параметрами: ex2cgp.exe profileonly полный_путь_к_cgmxui32.inf Если нужно создаваемую конфигурацию назначить по умолчанию, в конце нужно добавить ключ default. Пример:
Создание Почтового ПрофиляКогда 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. Откройте в Панели Управления пункт 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 и данные Пользователя:
Установки ПользователяДиалоговое окно Account Settings ("Установки Пользователя") открывается при нажатии кнопки Account Settings на панели Server. Это окно позволяет вам указать имя Пользователя, используемое MAPI-Коннектором, а также другие настройки общего характера:ПодключениеПанель Connection ("Подключение") позволяет вам выбрать используемый метод сетевого соединения.
ДополнительноНа панели Advanced ("Дополнительно") вы можете указать других Пользователей CommuniGate Pro, с которыми вы хотите работать.Используйте кнопки Add и Remove ("Добавить" и "Удалить") для того, чтобы указать дополнительные имена Пользователей CommuniGate Pro. Если вы хотите получить доступ к Пользователю, находящемуся в другом домене, укажите его полное имя в форме: accountName@domainName. Пользователи должны дать вам права на доступ к их папкам, в противном случае вы не сможете видеть и открывать папки, принадлежащие этим Пользователям. Дополнительную информацию смотрите в разделе Папки. Настройки, указываемые в Синхронизации, будут доминировать над настройками выбора папок для работы в Автономном режиме.
Разрешение Совместного использования ПапкиВы можете задать Список Прав Доступа для ваших папок для того, чтобы предоставить доступ к этим папкам другим пользователям 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, нужно выполнить следующие действия:
Эта опция будет использована приложением 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; для этого она должна содержать в себе корректные ссылки на файлы с информацией Свободен/Занят других пользователей. Чтобы указать явную строку поиска информации Свободен/Занят для внешнего пользователя, создайте в адресной книге запись типа Контакт и укажите в ней явно адрес данных Свободен/Занят. Смотрите дополнительную информацию об этих настройках в руководстве по Microsoft Outlook. Работа в Автономном режимеКогда вы работаете в Автономном режиме, MAPI-Коннектор не имеет доступа к сообщениям, хранящимся на сервере CommuniGate Pro. Чтобы иметь возможность работать продуктивно, вы должны убедиться, что все необходимые вам сообщения хранятся в локальном кэше MAPI-Коннектора. Вы можете задавать опции кэширования отдельно для каждой папки. Через пункт Options ("Параметры") в меню Tools ("Сервис") программы Outlook откройте диалоговое окно Options ("Параметры"). Затем откройте панель CommuniGate Pro:Выберите папку, с которой вам необходимо работать в Автономном режиме, и затем выберите метод загрузки. Если вы выберите загрузку всего сообщения, то имя папки будет выделено жирным шрифтом, а если вы выберите загрузку только заголовков сообщений, то имя папку будет просто отмечено флажком. Используйте в Outlook меню Tools -> CommuniGate Pro Server (Сервис -> Сервер CommuniGate Pro) для синхронизации изменений, сделанных вами в Автономном режиме с сервером CommuniGate Pro. Синхронизация происходит при запуске операций Отправки/Приёма почты (вручную или автоматически, с использованием расписания).
Задание Автоматических Правил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:
Коммуникации Реального Времени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 клиентов разных поколений).
Известные ограниченияПротокол и Интерфейс для Прикладных Программ, реализованный в MAPI-Коннекторе, являются не Интернет стандартом, а собственным Интерфейсом для Прикладных Программ Корпорации Microsoft®. Этот Интерфейс для Прикладных Программ не документирован полностью, что, в результате, может привести к тому, что некоторая (незначительная) функциональность Outlook не будет работать надлежащим образом. Компания CommuniGate Systems постоянно работает над устранением проблем такого рода, и регулярно выпускает обновления MAPI-Коннектора. |