Mapi outlook что это
Понимание структуры профилей - основа успешной диагностики Профили интерфейсов прикладного программирования Messaging API (MAPI) являются основным механизмом настройки клиента Outlook. Профили извещают эту программу о том, какие услуги доступны для конечных пользователей, и о характеристиках данных услуг.
Понимание структуры профилей — основа успешной диагностики
Профили интерфейсов прикладного программирования Messaging API (MAPI) являются основным механизмом настройки клиента Outlook. Профили извещают эту программу о том, какие услуги доступны для конечных пользователей, и о характеристиках данных услуг. Так, в профиле хранятся имена и пути к папке автономного хранилища (Offline Store, OST) и к папке персонального хранилища (Personal Store, PST). Иногда требуется внести те или иные изменения в содержимое профилей — в случаях, когда необходимо выяснить причины неполадок, или, что бывает чаще, в ходе реструктуризации систем, или при переводе пользователей на новые системы. Для решения этой задачи имеется множество инструментальных средств. Некоторые из них (такие, как profgen.exe и newprof.exe) разработаны специалистами Microsoft, другие — независимыми поставщиками. Но эти инструменты не всегда соответствуют конкретным запросам администраторов, поэтому не исключено, что придется засучить рукава и взять дело модификации профилей MAPI в свои руки. Перед тем как приступить к этой работе, следует ознакомиться со структурой профилей.
Структура профилей MAPI
Профили MAPI — не более чем наборы параметров системного реестра, и потому манипулировать ими можно с помощью множества различных методов. В данной статье я расскажу о том, как исследовать содержимое профилей с использованием редактора реестра regedit. Но перед тем как перейти к изложению материала, хочу ввести следующую предостерегающую формулу: редактор regedit + человек = мина замедленного действия. Прямое редактирование реестра — процедура опасная; при всякой возможности лучше стараться избегать таких операций. Если имеются документированные интерфейсы API, стоит пользоваться ими, поскольку они автоматически обновляют соответствующие разделы реестра. Ну, а уж если все-таки приходится вносить изменения вручную, необходимо заблаговременно делать резервную копию реестра. Я, например, всегда экспортирую тот раздел реестра, в который хочу внести изменения, и если что-то пойдет не так, у меня остается возможность вновь импортировать заготовленный файл .reg.
В системах Windows XP, Windows 2000 и Windows NT 4.0 профили записаны в разделе реестра HKEY_CURRENT_USERSoftwareMicrosoft Windows NTCurrentVersionWindows MessagingSubsystemProfiles, а в системах Windows ME, Windows98 и Windows 95 — в разделе HKEY_CURRENT_USERSoftwareMicrosoft WindowsMessaging SubsystemProfiles. Как показано на экране 1, в разделе Profiles имеются подразделы для каждого созданного администратором профиля MAPI (можно создавать столько профилей, сколько потребуется). Обратите внимание, что в качестве значения параметра DefaultProfile (типа REG_SZ) на правой панели указано имя текущего профиля, принимаемого по умолчанию (в данном случае это профиль Cached). Чтобы вручную изменить имя профиля, принимаемого по умолчанию, можно указать в качестве значения этого параметра одно из имен профилей, определенных в подразделе Profiles.
Опустившись еще на один уровень вниз, как показано на экране 2, вы можете увидеть подразделы профиля Cached и ассоциированные значения одного подраздела. Как мы видим на экране 2, имена подразделов представляют собой не более чем наборы цифр и букв. Профили определяются через службы, а каждая служба имеет один или несколько параметров, задающих ее конфигурацию. Чтобы конфигурация одной службы не изменяла конфигурацию другой, в качестве имени подраздела реестра, где описывается данная служба, используются глобально уникальные идентификаторы GUID (Globally Unique Identifier); отметим, что иногда в документации используется также термин section GUID.
Внутри профиля можно описывать множество различных служб, таких как параметры клиента Outlook, учетные записи электронной почты (скажем, POP, Exchange и IMAP), данные адресной книги, пути размещения хранилищ PST/OST, а также параметры, используемые в конкретных приложениях. Возможность манипулирования различными параметрами реестра обеспечивают многие приложения (включая программы от независимых поставщиков). Так, в результате обращения к модулю Mail из Control Panel для управления своими профилями или в результате обращения к клиенту Outlook с целью установления порядка просмотра записей адресной книги параметры служб в реестре будут обновлены.
Информацию о свойствах MAPI той или иной службы можно почерпнуть из имен параметров. Каждое свойство MAPI характеризуется типом данных (скажем, Binary, Unicode, ANSI) и идентификатором, а также буквенно-цифровыми значениями этих двух элементов из имени переменной, в которой хранятся данные свойства. Первые четыре символа имени определяют тип данных (наиболее часто встречающиеся типы приведены в таблице), а вторая группа из четырех символов определяет идентификатор элемента MAPI. Так, значение 001E6612 представляет собой строковую переменную (001E) для отличительного имени (Distinguished Name, DN) свойства Exchange Home Server (6612).
Глобально уникальные идентификаторы служб
Некоторые службы имеют хорошо известные статические идентификаторы GUID, например, в службе Exchange Server Details всегда используется GUID 13dbb0c8aa05101a9bb000aa 002fc45a. Тот, кто знаком с этими хорошо известными идентификаторами GUID, может с легкостью найти в профиле MAPI соответствующие службы их свойства. К примеру, чтобы отыскать имя Exchange Home Server для каждого сформированного профиля, нужно исследовать раздел Profiles и каждом подразделе искать значение 001E6602 переменной 13dbb0c8aa05101 a9bb000aa002fc45a. Служба Outlook Client Settings тоже имеет хорошо известный идентификатор GUID — 0a0d020000000000c000000000000046.
Подраздел Outlook Client Settings используется главным образом в клиентах, выпущенных до появления версии Outlook 2000. В более поздних версиях клиента Outlook почти для всех клиентских настроек используется подраздел HKEY_CURRENT_USERSoftwareMicrosoftOffice OutlookPreferences; такое решение принято для того, чтобы настройки могли присутствовать во всех профилях MAPI.
Идентификаторы GUID других служб генерируются динамически, так что работать с ними сложнее. Хорошей иллюстрацией к сказанному может служить процедура создания файла PST, в результате которой внутри профиля, к которому принадлежит данная персональная папка-хранилище, генерируется уникальный идентификатор службы GUID. Возникает вопрос: как же все-таки узнать, к какой службе относится тот или иной идентификатор GUID?
Большинство служб, хотя и не все, имеют имя, которое содержится в свойстве 001f3D09 (Unicode) или, что встречается не так часто, в свойстве 001e3D09 (ANSI). Имя службы для файлов PST — MSPST PS; следовательно, в поле Data переменной 001f3D09 будет значиться MSPST PS. Можно также взглянуть на свойство 001f6700, содержащее маршрут к файлу PST. Тэг свойства PR_PST_PATH имеет выраженное в шестнадцатеричном формате значение &H6700001F.
К числу хорошо известных относится еще один GUID — 9375CFF 0413111d3B88A00104B2A6676. В нем содержатся подробные описания всех учетных записей, используемых в данном профиле. В этом разделе для каждой учетной записи выделяется особый подраздел. Так, здесь обычно имеется подраздел для учетной записи адресной книги Outlook (Outlook Address Book, OAB), для учетной записи Exchange, подразделы для учетных записей всех файлов PST, внесенных в данный профиль, и для всех почтовых учетных записей POP3/IMAP, которые были сформированы внутри профиля.
Добавление второго почтового ящика
Как узнать, что означают цифры
Выяснение того, какие идентификаторы и параметры каких служб контролируют те или иные операции конечных пользователей, — задача непростая; я расскажу о двух приемах.
Во-первых, следует использовать редактор regedit и экспортировать соответствующий раздел реестра до того, как в него будут внесены некоторые изменения, и после. Сопоставление двух выходных файлов поможет определить, какие из значений реестра были изменены.
Применение файлов .prf
В Outlook можно манипулировать параметром /importprf, который позволяет создавать профили на основе определений, содержащихся в текстовых файлах профилей Outlook (файлах .prf). Синтаксис использования параметра /importprf таков:
Таким образом, администраторам полезно знать структуру профилей MAPI, поскольку это может помочь устранить причину той или иной неполадки и разработать новаторское решения проблем миграции, которые на первый взгляд казались неразрешимыми.
В этой статье представлены общие сведения о справочных документах по MAPI для Outlook 2013.
О документации
Эта документация применяется для реализации MAPI (Messaging API) в Microsoft Outlook 2013.
До Microsoft Office Outlook 2007 справочник программиста MAPI входил в состав документации по Microsoft Exchange.
Так как, начиная с Microsoft Exchange Server 2007, в Exchange уменьшено применение MAPI, поддержка реализации для Exchange ограничена.
Реализация MAPI для Outlook отличается от реализации для Microsoft Exchange. Реализация в Outlook оптимизирована для работы на клиентских компьютерах с особым вниманием к уменьшению задержек. Реализация в Exchange предназначена для серверов, где важна высокая доступность и улучшенная многопоточность.
Используйте эту документацию для приложений, работающих в системах конечных пользователей. Для серверных приложений используйте реализацию MAPI для Exchange, если применимо, или используйте текущие API Exchange, например веб-службы Exchange. Дополнительные сведения о веб-службах Exchange см. в статье Справочник по веб-службам Exchange.
Можно создавать приложения, работающие с реализациями MAPI либо для Outlook, либо для Exchange. Например, MFCMAPI хорошо работает на обеих платформах. Реализации обладают большим количеством общих функций, но есть очевидные и неявные различия. Необходимо тщательно выполнять тестирование на обеих платформах, если приложение предназначено для работы во всех средах. Для тестирования потребуются две системы, так как запуск обеих реализаций в одной операционной системе не поддерживается.
Дополнительные сведения о новых возможностях этого выпуска см. в указанных ниже статьях.
Если вы не знакомы с разработкой приложений MAPI для Outlook, см. указанные ниже статьи.
Остальная часть этого справочника разделена на три типа сведений, указанных ниже.
Примеры MAPI. Направляют к разным примерам кода, демонстрирующим использования различных элементов API, способ внедрения основных поставщиков MAPI и создание элементов Outlook.
Понятия MAPI. Объясняются основные понятия и архитектура MAPI.
Справочник по интерфейсу MAPI. Предоставляет подробные сведения о функциях, интерфейсах, структурах и свойствах в MAPI.
Сервер CommuniGate Pro может использоваться как "сервис провайдер" для приложений Microsoft Windows, поддерживающих MAPI (Microsoft Messaging API). Для того, чтобы использовать этот сервис, на клиентских рабочих станциях Microsoft Windows должна быть установлена специальная библиотека-Коннектор (dll MAPI-Коннектора CommuniGate Pro).
Использование MAPI-Коннектора CommuniGate Pro требует специального Лицензионного Ключа для групповой работы или специального Лицензионного Ключа MAPI.
Вы можете ознакомится с Историей Изменений MAPI Коннектора для CommuniGate Pro.
Обзор технологии, используемой MAPI-Коннектором
MAPI-Коннектор CommuniGate Pro действует как MAPI-провайдер. Он принимает MAPI-запросы из Microsoft Outlook, работающего в режиме корпоративной рабочей группы (Outlook 98, Outlook 2000, Outlook XP, Outlook 2002 и более поздние), а также запросы от других приложений Windows. Затем MAPI-Коннектор преобразовывает эти запросы в расширенные команды IMAP и посылает их на сервер CommuniGate Pro.
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-Коннектор с рабочих станций.
Для локализации языка интерфейса 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-Коннектора.
Альтернативный способ, не требующий прав Администратора:
Запустить ex2cgp, соответствующую разрядности Outlook, со следующими параметрами:
ex2cgp.exe profileonly полный_путь_к_cgmxui32.inf
Если нужно создаваемую конфигурацию назначить по умолчанию, в конце нужно добавить ключ default.
ex2cgp.exe profileonly C:\Users\Bob\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.
Обратите внимание: для переключения режима Outlook вам может потребоваться установочный диск от MS Office.
Обратите внимание: современные версии MAPI-Коннектора (1.54 и новее) полагаются на интерфейсы MAPI с поддержкой Unicode и несовместимы с Outlook 98 и Outlook 2000.
Откройте в Панели Управления пункт 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.
Сервер
- У этого Пользователя CommuniGate включён метод Аутентификации через Kerberos.
- Ваш Домен в CommuniGate Pro имеет соответствующие Kerberos Ключи, экспортированные из Active Directory или Центра Распространения Ключей (KDC) Kerberos.
Установки Пользователя
Диалоговое окно Account Settings ("Установки Пользователя") открывается при нажатии кнопки Account Settings на панели Server. Это окно позволяет вам указать имя Пользователя, используемое MAPI-Коннектором, а также другие настройки общего характера:
Подключение
Дополнительно
На панели Advanced ("Дополнительно") вы можете указать других Пользователей CommuniGate Pro, с которыми вы хотите работать.
Используйте кнопки Add и Remove ("Добавить" и "Удалить") для того, чтобы указать дополнительные имена Пользователей CommuniGate Pro. Если вы хотите получить доступ к Пользователю, находящемуся в другом домене, укажите его полное имя в форме: accountName@domainName.
Пользователи должны дать вам права на доступ к их папкам, в противном случае вы не сможете видеть и открывать папки, принадлежащие этим Пользователям. Дополнительную информацию смотрите в разделе Папки.
Настройки, указываемые в Синхронизации, будут доминировать над настройками выбора папок для работы в Автономном режиме.
Для задания места, в котором MAPI-Коннектор должен хранить свой локальный кэш, используйте настройки Корневой папки Кэша файлов. Локальный кэш будет использоваться для большинства операций MAPI-Коннектора; он также позволяет вам использовать MAPI приложения (такие, как Outlook) в автономном режиме. Локальная папка данных приложения Аутлук Используйте эту опцию если вы хотите хранить кэш файлы в месте, используемом на вашей рабочей станции по умолчанию. Этот кэш будет доступен только на этой рабочей станции. Глобальная папка данных приложения Аутлук Используйте эту опцию, если вы хотите задействовать возможности Windows по работе на разных компьютерах и планируете использовать Outlook на нескольких компьютерах.
Обратите внимание: кэш файлы могут быть довольно большими (так как, в зависимости от настроек Коннектора, в них может содержаться полная копия всех ваших папок, находящихся на сервере). Если кэш файлы становятся слишком большими, вы можете столкнуться с задержками при входе на другую рабочую станцию, так как это рабочая станция должна будет скопировать все данные заново. Здесь Используйте эту опцию, если вы хотите хранить кэш файлы в специальном месте. Например, для того, чтобы избежать задержек при работе с других компьютеров, вы можете выбрать совместно используемую папку на файловом сервере.
Разрешение Совместного использования Папки
Вы можете задать Список Прав Доступа для ваших папок для того, чтобы предоставить доступ к этим папкам другим пользователям CommuniGate Pro.
Выберите папку в Списке Папок Outlook и затем, используя элемент меню Properties, откройте диалоговое окно Свойства. Откройте панель Permission:
Используйте кнопку Add ("Добавить") и Remove ("Удалить") чтобы указать пользователей и другие идентификаторы, которые должны иметь доступ к объекту.
Выберите идентификаторы из списка и используйте соответствующие флажки, чтобы предоставить нужные права этому идентификатору. Дополнительную информацию о Списке Прав Доступа к папкам смотрите в разделе Папки.
Обратите внимание: для того, чтобы указать Вид Папки по умолчанию, пользователь должен иметь Право Доступа к Папке Управлять.
Делегирование
MAPI-Коннектор поддерживает возможность "делегирования": пользователи могут отправлять электронную почту и приглашения, действуя "от имени" других пользователей или "в качестве" других пользователей.
Информация о Занятости
Информация Свободен/Занят (Информация о Занятости) - это файл, указывающий, когда пользователь занят, свободен, находится вне офиса и так далее. Обычно эта информация доступна всем пользователям и все имеют к ней доступ, когда планируют собрания, назначают встречи и т.д. Чтобы получить данные Свободен/Занят, клиентское приложение, обеспечивающее групповое взаимодействие, собирает данные из календаря (календарей) пользователя и помещает их в единое расписание Свободен/Занят.
Публикация информации Свободен/Занят
MAPI-Коннектор хранит информацию Свободен/Занят в Хранилище Файлов Пользователя.
Публично доступная информация в стандартном формате vCalendar содержится в файле freebusy.vfb в корневой директории вашего Хранилища Файлов.
Обратите внимание: Убедитесь, что ваши Установки Пользователя в CommuniGate Pro позволяют MAPI-Коннектору сохранить файл с информацией Свободен/Занят.
Доступ к информации Свободен/Занят Других Пользователей
Обратите внимание: указанная строка будет работать, только если Веб Интерфейс Пользователя вашего сервера 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 обслуживает единственный домен, можно указать эту строку в явном виде:
Строка поиска, указанная выше, позволяет пользователям получать информацию Свободен/Занят для пользователей той же системы CommuniGate Pro.
Строка поиска может использоваться для получения информации Свободен/Занят для пользователей других Серверов CommuniGate Pro; для этого она должна содержать в себе корректные ссылки на файлы с информацией Свободен/Занят других пользователей. Чтобы указать явную строку поиска информации Свободен/Занят для внешнего пользователя, создайте в адресной книге запись типа Контакт и укажите в ней явно адрес данных Свободен/Занят. Смотрите дополнительную информацию об этих настройках в руководстве по Microsoft Outlook.
Работа в Автономном режиме
Через пункт Options ("Параметры") в меню Tools ("Сервис") программы Outlook откройте диалоговое окно Options ("Параметры"). Затем откройте панель CommuniGate Pro:
Используйте в Outlook меню Tools -> CommuniGate Pro Server (Сервис -> Сервер CommuniGate Pro) для синхронизации изменений, сделанных вами в Автономном режиме с сервером CommuniGate Pro.
Синхронизация происходит при запуске операций Отправки/Приёма почты (вручную или автоматически, с использованием расписания).
Задание Автоматических Правил
MAPI-Коннектор позволяет вам создать Правила, выполняемые на сервере, с помощью которых вы можете обрабатывать всю почту Пользователя.
Используйте команду меню Tools->CommuniGate Pro (Сервис -> Сервер CommuniGate Pro) для того, чтобы открыть окно редактора Правил:
Для того, чтобы создать новое Правило, нажмите на кнопку New. ("Новое"). Новое Правило не имеет условия и действия.
Нажмите на кнопку Add ("Добавить"), для того, чтобы добавить условия и действия:
Дополнительную информацию смотрите в разделе Автоматические Правила.
Интеграция с Веб Почтой
Значения, указанные на панели Установки Пользователя, хранятся в Установках Веб Интерфейс Пользователя, так что как в сессии через Веб Интерфейс Пользователя, так и в MAPI сессии будут использоваться одинаковые значений полей Имя, Адрес Ответа, Организация.
Взаимодействие с пользователями Microsoft Exchange
Коммуникации Реального Времени
MAPI-Коннектор позволяет пользователям Outlook использовать функции коммуникаций реального времени Сервера CommuniGate Pro.
Пользователи Outlook могут инициировать телефонные вызовы, используя телефонный номер, указанный в соответствующем поле в Контактах. Щёлкните правой кнопкой мыши по записи в Контактах, и в появившемся всплывающем меню выберите пункт Позвонить используя CommuniGate Pro:
Вы можете также использовать подменю Сервер CommuniGate Pro в меню Tools ("Сервис") программы Outlook.
Появится диалоговое окно с именем Контакта и телефонным номером:
Вы можете использовать другой телефонный номер из второго поля. Этот номер будет использоваться только для этого вызова и не будет сохранён в Контактах.
Нажмите на кнопку Start Call ("Вызов"), чтобы совершить звонок. Сразу же начнут звонить все ваши SIP-устройства. Ответив на звонок на каком-нибудь устройстве, Сервер свяжет это устройства с требуемым телефонным номером.
Появится диалоговое окно, отображающее статус звонка:
Шифрование на Сервере
Устранение проблем
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 ("Очистить файл"), чтобы очистить файл Журнала.
Известные ограничения
Протокол и Интерфейс для Прикладных Программ, реализованный в MAPI-Коннекторе, являются не Интернет стандартом, а собственным Интерфейсом для Прикладных Программ Корпорации Microsoft®. Этот Интерфейс для Прикладных Программ не документирован полностью, что, в результате, может привести к тому, что некоторая (незначительная) функциональность Outlook не будет работать надлежащим образом. Компания CommuniGate Systems постоянно работает над устранением проблем такого рода, и регулярно выпускает обновления MAPI-Коннектора.
11.09.2019
itpro
Exchange
комментария 4
Проверим, что атрибут ExternalUrl пустой:
Get-MapiVirtualDirectory | ft server, *url*
ExternalUrl, как мы видим, пустой, нам нужно его заполнить (в данном примере мы зададим и ExternalUrl и Internal Url, учтите что сертификат Exchange должен соответствовать адресам, указанным во внешнем и внутренним URL адресах).
Get-MapiVirtualDirectory | Set-MapiVirtualDirectory -InternalUrl –ExternalUrl -IISAuthenticationMethods NTLM,Negotiate
Get-OrganizationConfig | FL *mapi*
После выполнения команды нужно подождать около часа для применения всех изменений на стороне Exchange. Если нужно, ускорить процесс можно перезапуском MS Exchange Host Service и пула Autodiscover на Mailbox сервере.
При переключении на новый протокол Outlook выдает предупреждение:
The Microsoft Exchange administrator has made a change that requires you quit and restart Outlook.
Проверить возможность подключения по новому протоколу можно, перейдя на URL . Таким нехитрым способом мы узнаем имя CAS сервера, на котором мы авторизовались и имя Mailbox сервера.
Также проверить работу нового протокола можно с помощью командлета Powershll Test-OutlookConnectivity:
Траблшутинг:
Логи нового протокола хранятся здесь:
Сервер CommuniGate Pro может использоваться как "сервис провайдер" для приложений Microsoft Windows, поддерживающих MAPI (Microsoft Messaging API). Для того, что бы использовать этот сервис, на клиентских рабочих станциях Microsoft Windows должна быть установлена специальная библиотека-Коннектор (dll MAPI-Коннектора CommuniGate Pro).
Использование MAPI-Коннектора CommuniGate Pro требует специального Лицензионного Ключа для групповой работы. Без такого Ключа Сервер будет обслуживать до 5 одновременных MAPI сессий.
Обзор технологии, используемой MAPI-Коннектором
MAPI-Коннектор CommuniGate Pro действует как MAPI-провайдер. Он принимает MAPI-запросы из Microsoft Outlook, работающего в режиме корпоративной рабочей группы (Outlook 98, Outlook 2000, Outlook XP, Outlook 2002 и более поздние), а так же запросы от других приложений Windows. Затем MAPI-Коннектор преобразовывает эти запросы в расширенные команды IMAP и посылает их на сервер CommuniGate Pro.
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-Коннектор с рабочих станций.
Для автоматического задания Установок Пользователя и Совместно используемых ресурсов может использоваться файл 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.
Сервер
- У этого Пользователя CommuniGate включён метод Аутентификации через Kerberos.
- Ваш Домен в CommuniGate Pro имеет соответствующие Kerberos Ключи, экспортированные из Active Directory или Центра Распространения Ключей (KDC) Kerberos.
Установки Пользователя
Диалоговое окно Account Settings ("Установки Пользователя") открывается при нажатии кнопки Account Settings на панели Server. Это окно позволяет вам указать имя Пользователя, используемое MAPI-Коннектором, а так же другие настройки общего характера:
Подключение
Дополнительно
На панели Advanced ("Дополнительно") вы можете указать других Пользователей CommuniGate Pro, с которыми вы хотите работать.
Используйте кнопки Add и Remove ("Добавить и Удалить") для того, что бы указать дополнительные имена Пользователей CommuniGate Pro. Если вы хотите получить доступ к Пользователю, находящемуся в другом домене, укажите его полное имя в форме: accountName@domainName.
Пользователи должны дать вам права на доступ к их папкам, в противном случае вы не сможете видеть и открывать папки, принадлежащие этим Пользователям. Дополнительную информацию смотрите в разделе Папки.
Настройки, указываемые в Синхронизации, будут доминировать над настройками выбора папок для работы в Автономном режиме.
Для задания места, в котором 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-Коннектор поддерживает возможность "делегирования": пользователи могут отправлять электронную почту и приглашения действуя "от имени"других пользователей или "в качестве" дргуих пользователей.
Информация о Занятости
Информация Свободен/Занят (Информация о Занятости) - это файл, указывающий когда пользователь занят, свободен, находится вне офиса и так далее. Обычно эта информация доступна всем пользователям и все имеют к ней доступ, когда планируют собрания, назначают встречи и т.д. Для того, чтобы получить данные Свободен/Занят, клиентское приложение, обеспечивающее групповое взаимодействие, собирает данные из календаря (календарей) пользователя и помещает ее в единое расписание Свободен/Занят.
Публикация информации Свободен/Занят
MAPI-Коннектор хранит информацию Свободен/Занят в Хранилище Файлов Пользователя.
Публично доступная информация в стандартном формате vCalendar содержится в файле freebusy.vfb в корневой директории вашего Хранилища Файлов.
Обратите внимание: Убедитесь, что ваши Установки Пользователя в CommuniGate Pro позволяют MAPI-Коннектору сохранить файл с информацией Свободен/Занят.
Доступ к информации Свободен/Занят Других Пользователей
Обратите внимание: указанная строка будет работать, только если Веб Интерфейс Пользователя вашего сервера 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 обслуживает единственный домен, можно указать эту строку в явном виде:
Строка поиска, указанная выше, позволяет пользователям получать информацию Свободен/Занят для пользователей той же системы CommuniGate Pro.
Строка поиска может использоваться для получения информации Свободен/Занят для пользователей других Серверов CommuniGate Pro; для этого она должна содержать в себе корректные ссылки на файлы с информацией Свободен/Занят других пользователей. На панели Advanced ("Дополнительно") вы можете указать других Пользователей CommuniGate Pro, с которыми вы хотите работать. Смотрите дополнительную информацию об этих настройках в руководстве по Microsoft Outlook.
Работа в Автономном режиме
Через пункт Options ("Параметры") в меню Tools ("Сервис") программы Outlook откройте диалоговое окно Options ("Параметры"). Затем откройте панель CommuniGate Pro:
Используйте в Outlook меню Tools -> CommuniGate Pro Server (Сервис -> Сервер CommuniGate Pro) для синхронизации изменений, сделанных вами в Автономном режиме с сервером CommuniGate Pro.
Синхронизация происходит при запуске операций Отправки/Приёма почты (вручную или автоматически, с использованием расписания).
Задание Автоматических Правил
MAPI-Коннектор позволяет вам создать Правила, выполняемые на сервере, с помощью которых вы можете обрабатывать всю почту Пользователя.
Используйте команду меню Tools->CommuniGate Pro (Сервис -> Сервер CommuniGate Pro) для того, что бы открыть окно редактора Правил:
Для того, что бы создать новое Правило, нажмите на кнопку New. ("Новое"). Новое Правило не имеет условия и действия.
Нажмите на кнопку Add ("Добавить"), для того, что бы добавить условия и действия:
Дополнительную информацию смотрите в разделе Автоматические Правила.
Интеграция с Веб Доступом к почте
Значения, указанные на панели Установки Пользователя, хранятся в Установках Веб Интерфейс Пользователя, так что как в сессии через Веб Интерфейс Пользователя, так и в MAPI сессии будут использоваться одинаковые значений полей Имя, Адрес Ответа, Организация.
Взаимодействие с пользователями Microsoft Exchange
Коммуникации Реального Времени
MAPI-Коннектор позволяет пользователям Outlook использовать функции коммуникаций реального времени Сервера CommuniGate Pro.
Пользователи Outlook могут инициировать телефонные вызовы, используя телефонный номер, указанный в соответствующем поле в Контактах. Щёлкните правой кнопкой мыши по записи в Контактах, и в появившемся всплывающем меню выберите пункт Позвонить используя CommuniGate Pro:
Вы можете также использовать подменю Сервер CommuniGate Pro в меню Tools ("Сервис") программы Outlook.
Появиться диалоговое окно с именем Контакта и телефонным номером:
Вы можете использовать другой телефонный номер из второго поля. Этот номер будет использоваться только для этого вызова и не будет сохранён в Контактах.
Нажмите на кнопку Start Call ("Вызов") для того, что бы совершить звонок. Сразу же начнут звонить все ваши SIP-устройства. Ответив на звонок на каком-нибудь устройстве, Сервер свяжет это устройства с требуемым телефонным номером.
Появиться диалоговое окно, отображающее статус звонка:
Шифрование на Сервере
Устранение проблем
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-Коннектора должны оставлять записи о своей активности в Журнале.
Нажмите на кнопку Delete Log File ("Очистить файл") для того, что бы очистить файл Журнала.
Известные ограничения
Протокол и Интерфейс для Прикладных Программ, реализованный в MAPI-Коннекторе, являются не Интернет стандартом, а собственным Интерфейсом для Прикладных Программ Корпорации Microsoft®. Этот Интерфейс для Прикладных Программ не документирован полностью, что, в результате? может привести к тому, что некоторая (незначительная) функциональность Outlook не будет работать надлежащим образом. Компания CommuniGate Systems постоянно работает над устранением проблем такого рода, и регулярно выпускает обновления MAPI-Коннектора.
Существующий специальный список Известные проблемы MAPI содержит информацию об известных проблемах и о путях их решения. Если в работе MAPI-Коннектора возникают проблемы, пожалуйста, проверьте сначала, содержится ли проблема в этом списке.
Читайте также: