Обзор надстроек Outlook

  • Статья

Надстройки Outlook — это встраиваемые в Outlook решения от сторонних разработчиков, использующие нашу веб-платформу. Три ключевых аспекта надстроек Outlook:

  • В классических приложениях (Outlook для Windows и Mac), веб-приложениях (Microsoft 365 и Outlook.com) и мобильных решениях используются одинаковые логика надстроек и бизнес-логика.
  • Надстройка Outlook состоит из манифеста, в котором описан способ интеграции надстройки с Outlook (например, при помощи кнопки или области задач), и кода JavaScript или HTML, который составляет пользовательский интерфейс и бизнес-логику надстройки.
  • Пользователи и администраторы могут получать надстройки Outlook из AppSource или загружать их в неопубликованном виде.

Надстройки Outlook отличаются от надстроек COM или VSTO, которые являются более ранними интеграциями, относящимися к Outlook под управлением Windows. В отличие от надстроек COM надстройки Outlook не имеют какого-либо кода, физически установленного на устройстве пользователя или в клиентах Outlook. В случае надстройки Outlook программа Outlook считывает манифест и подключает указанные элементы управления в пользовательском интерфейсе, а затем загружает JavaScript и HTML. Все веб-компоненты выполняются в контексте браузера или элемента управления webview в песочнице.

Важно!

Надстройки COM и VSTO не поддерживаются в новой предварительной версии Outlook для Windows . Эти надстройки по-прежнему поддерживаются в классическом классическом клиенте Outlook для Windows. Дополнительные сведения см. в статье Разработка надстроек Outlook для новых приложений Outlook в Windows (предварительная версия).

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

Примечание.

Если вы планируете опубликовать надстройку в AppSource и Office, она должна соответствовать Политикам сертификации коммерческого рынка.  Например, она должна работать на всех платформах, поддерживающих определенные вами методы. Дополнительные сведения см. в разделе 1120.3 и на странице с информацией о доступности для платформ и приложений Office.

Точки расширения

Надстройка использует точки расширения для интеграции с Outlook. Ниже приведены способы, которыми это можно сделать.

  • Надстройки могут объявлять кнопки, которые отображаются на панелях команд в сообщениях и встречах. Дополнительные сведения см. в разделе Команды надстройки.

    Кнопки команд надстройки на ленте.

  • Надстройки могут активироваться по совпадениям с регулярными выражениями или обнаруженным сущностям в сообщениях и встречах. Дополнительные сведения см. в разделе Контекстные надстройки Outlook.

    Важно!

    Контекстные надстройки Outlook на основе сущностей будут прекращены во 2-м квартале 2024 г. Работа по прекращению использования этой функции начнется в мае и продолжится до конца июня. После июня контекстные надстройки больше не смогут обнаруживать сущности в почтовых элементах для выполнения задач над ними. Следующие API также будут прекращены.

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

    • Разрабатывается альтернативная реализация кнопки "Присоединиться к собранию ", которая активируется надстройками собраний по сети. После завершения поддержки контекстных надстроек на основе сущностей надстройки собраний по сети автоматически переходят на альтернативную реализацию для активации кнопки Присоединиться к собранию .
    • Правила регулярных выражений будут поддерживаться после прекращения использования контекстных надстроек на основе сущностей. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Инструкции по реализации этих правил см. в статье Использование правил активации регулярных выражений для отображения надстройки Outlook.

    Дополнительные сведения см. в разделе Прекращение использования контекстных надстроек Outlook на основе сущностей.

    Контекстная надстройка карта отображается из выделенного адреса в сообщении.

Элементы почтовых ящиков, доступные надстройкам

Надстройки Outlook активизируются при создании или чтении сообщения либо встречи, но не других типов элементов. При этом надстройки не активизируются, если текущий элемент сообщения в форме создания или просмотра имеет одну из следующих особенностей:

  • Защищена службой управления правами на доступ к данным (IRM) или зашифрована другими способами для защиты и доступа к ней из Outlook на мобильных устройствах. Примером является сообщение с цифровой подписью, так как цифровая подпись зависит от одного из этих механизмов. Дополнительные сведения о поддержке IRM в надстройках Outlook см. в статье Элементы почты, защищенные IRM.

  • Почтовый элемент, защищенный IRM, с меткой конфиденциальности, для которого для параметра разрешить программный доступ настраиваемой политики задано значение false. Дополнительные сведения о поддержке IRM в надстройках Outlook см. в статье Элементы почты, защищенные IRM.

  • Отчет или уведомление о доставке имеет класс сообщения IPM.Report.*, включая отчеты о доставке, о недоставке, а также уведомления о прочтении, о непрочтении и о задержке.

  • MSG- или EML-файл, представляющий собой вложение в другое сообщение.

  • MSG- или EML-файл, открытый из файловой системы.

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

    Важно!

    * Поддержка сценариев делегированного доступа (например, папок, к которым предоставлен общий доступ из почтового ящика другого пользователя), появилась в наборе требований 1.8, а поддержка общих почтовых ящиков появилась в наборе требований 1.13. Дополнительные сведения см. в статье Включение общих папок и сценариев общих почтовых ящиков.

  • Использование настраиваемой формы.

  • Создано с помощью Simple MAPI. Simple MAPI используется, если пользователь Office создает или отправляет сообщение электронной почты из приложения Office в Windows, когда Outlook закрыт. Например, пользователь может создать сообщение электронной почты Outlook во время работы в Word, что запускает окно создания сообщения Outlook без запуска основного приложения Outlook. Однако если Outlook уже запущен, когда пользователь создает сообщение электронной почты из Word, это не сценарий Simple MAPI, поэтому надстройки Outlook работают в форме создания при условии, что выполнены другие требования к активации.

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

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

Почтовые элементы, защищенные IRM

Надстройки Outlook активируются для защищенных IRM почтовых элементов при доступе к элементу из следующих поддерживаемых клиентов.

  • Outlook в Windows, начиная с версии 2009 (сборка 13229.10000)

    Примечание.

    Цифровая подпись зависит от механизмов защиты, таких как IRM. Начиная с Outlook в Windows версии 1711 (сборка 8711.1000), связанной с подпиской На Microsoft 365, надстройки активируются в сообщениях с цифровой подписью.

  • Outlook на Mac, начиная с версии 16.77.827.0

  • Outlook в Интернете

  • новый Outlook в Windows (предварительная версия)

Однако надстройки не активируются для элементов, защищенных IRM, если:

  • Доступ к элементу, защищенному IRM, осуществляется из Outlook на мобильных устройствах.
  • Элемент, защищенный IRM, имеет метку конфиденциальности с параметром разрешить программный доступ настраиваемой политики, для которого задано значение false. Дополнительные сведения о параметрах пользовательской политики см. в разделе Права и описания использования.

Поддерживаемые клиенты

Надстройки Outlook поддерживаются в Outlook для Windows (классическая и новая (предварительная версия)), Outlook для Mac, Outlook в Интернете, Outlook для iOS, Outlook для Android и Outlook.com. Поддержка новых функции может появляться в разных клиентах в разное время. Дополнительные сведения о поддержке функций на клиентах и серверах см. в статье Наборы требований, поддерживаемые серверами Exchange и клиентами Outlook , а также статьи, относящиеся к этим функциям.

Знакомство с разработкой надстроек Outlook

Чтобы приступить к разработке надстроек Outlook, попробуйте приведенные ниже ресурсы.

  • Краткое руководство — создание простой надстройки области задач.
  • Учебник — узнайте, как создать надстройку, которая вставляет элементы gist с сайта GitHub в новое сообщение.

См. также