Обзор надстроек OutlookOutlook add-ins overview

Надстройки Outlook — это встраиваемые в Outlook решения от сторонних разработчиков, использующие нашу веб-платформу.Outlook add-ins are integrations built by third parties into Outlook by using our web-based platform. Три ключевых аспекта надстроек Outlook:Outlook add-ins have three key aspects:

  • В классических приложениях (Outlook для Windows и Mac), веб-приложениях (Office 365 и Outlook.com) и мобильных решениях используются одинаковые логика надстроек и бизнес-логика.The same add-in and business logic works across desktop (Outlook for Windows and Mac), web (Office 365 and Outlook.com), and mobile.
  • Надстройка Outlook состоит из манифеста, в котором описан способ интеграции надстройки с Outlook (например, при помощи кнопки или области задач), и кода JavaScript или HTML, который составляет пользовательский интерфейс и бизнес-логику надстройки.Outlook add-ins consist of a manifest, which describes how the add-in integrates into Outlook (for example, a button or a task pane), and JavaScript/HTML code, which makes up the UI and business logic of the add-in.
  • Пользователи и администраторы могут получать надстройки Outlook из AppSource или загружать их в неопубликованном виде.Outlook add-ins can be acquired from the Office store or side-loaded by end-users or administrators.

Надстройки Outlook отличаются от надстроек COM или VSTO, которые являются более ранними интеграциями, относящимися к Outlook под управлением Windows.Outlook add-ins are different from COM or VSTO add-ins, which are older integrations specific to Outlook running on Windows. В отличие от надстроек COM надстройки Outlook не имеют какого-либо кода, физически установленного на устройстве пользователя или в клиентах Outlook.Unlike COM add-ins, Outlook add-ins don't have any code physically installed on the user's device or Outlook client. В случае надстройки Outlook программа Outlook считывает манифест и подключает указанные элементы управления в пользовательском интерфейсе, а затем загружает JavaScript и HTML.For an Outlook add-in, Outlook reads the manifest and hooks up the specified controls in the UI, and then loads the JavaScript and HTML. Все веб-компоненты выполняется в "песочнице" в контексте браузера.The web components all run in the context of a browser in a sandbox.

К элементам Outlook, поддерживающим надстройки, относятся письма, приглашения на собрание, ответы и данные об отменах, а также сведения о встречах.The Outlook items that support add-ins include email messages, meeting requests, responses and cancellations, and appointments. Каждая надстройка Outlook определяет контекст, в котором она доступна, в том числе типы элементов и то, просматривает пользователь элемент или создает его.Each Outlook add-in defines the context in which it is available, including the types of items and if the user is reading or composing an item.

Примечание

Если вы планируете опубликовать надстройку в AppSource, она должна соответствовать политикам проверки AppSource. Например, чтобы пройти проверку, надстройка должна работать на всех платформах, поддерживающих определенные вами методы. Дополнительные сведения см. в разделе 4.12 и статье о доступности надстроек Office в ведущих приложениях.When you build your add-in, if you plan to publish your add-in to AppSource, make sure that you conform to the AppSource validation policies. For example, to pass validation, your add-in must work across all platforms that support the methods that you define (for more information, see section 4.12 and the Office Add-in host and availability page).

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

Надстройка использует точки расширения для интеграции с Outlook. Это можно сделать следующими способами:Extension points are the ways that add-ins integrate with Outlook. The following are the ways this can be done:

  • Надстройки могут объявлять кнопки, которые отображаются на панелях команд в сообщениях и встречах. Дополнительные сведения см. в статье Команды надстроек Outlook.Add-ins can declare buttons that appear in command surfaces across messages and appointments. For more information, see Add-in commands for Outlook.

    Надстройка с кнопками на лентеAn add-in with command buttons on the ribbon

    Команда надстройки для фигуры без интерфейса

  • Надстройки могут активироваться по совпадениям с регулярными выражениями или обнаруженным сущностям в сообщениях и встречах. Дополнительные сведения см. в статье Контекстно-зависимые надстройки Outlook.Add-ins can link off regular expression matches or detected entities in messages and appointments. For more information, see Contextual Outlook add-ins.

    Контекстная надстройка для выделенной сущности (адреса)A contextual add-in for a highlighted entity (an address)

    Показывает контекстное приложение на карточке

Примечание

Поскольку настраиваемые области устарели, следует убедиться, что вы используете поддерживаемую точку расширения.Custom panes have been deprecated so please ensure that you're using a supported extension point.

Элементы почтовых ящиков, доступные надстройкамMailbox items available to add-ins

Надстройки Outlook доступны при создании или просмотре сообщений или встреч. Outlook не активирует надстройки, если текущий элемент сообщения в форме создания или просмотра имеет одну из следующих особенностей:Outlook add-ins are available on messages or appointments while composing or reading, but not other item types. Outlook does not activate add-ins if the current message item, in a compose or read form, is one of the following:

  • Защищен управлением правами на доступ к данным (IRM) или зашифрован каким-либо другим способом. Один из примеров — сообщение, подписанное цифровой подписью, так как в этом случае используется один из указанных выше механизмов.Protected by Information Rights Management (IRM) or encrypted in other ways for protection. A digitally signed message is an example since digital signing relies on one of these mechanisms.

  • Отчет или уведомление о доставке имеет класс сообщения IPM.Report.*, включая отчеты о доставке, о недоставке, а также уведомления о прочтении, о непрочтении и о задержке.A delivery report or notification that has the message class IPM.Report.*, including delivery and Non-Delivery Report (NDR) reports, and read, non-read, and delay notifications.

  • Элемент является черновиком (не имеет назначенного отправителя) или находится в папке черновиков Outlook.A draft (does not have a sender assigned to it), or in the Outlook Drafts folder.

  • MSG- или EML-файл, представляющий собой вложение в другое сообщение.A .msg or .eml file which is an attachment to another message.

  • MSG- или EML-файл, открытый из файловой системы.A .msg or .eml file opened from the file system.

  • В общем почтовом ящике, почтовом ящике другого пользователя, архивном почтовом ящике или общедоступной папке.In a shared mailbox, in another user's mailbox, in an archive mailbox, or in a public folder.

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

В общем случае Outlook может активировать надстройки в формах просмотра для элементов в папке "Отправленные", за исключением надстроек, активируемых на основании совпадений строк для известных сущностей.In general, Outlook can activate add-ins in read form for items in the Sent Items folder, with the exception of add-ins that activate based on string matches of well-known entities. Дополнительные сведения о причинах этого см. "Поддержка известных сущностей" в статье Сопоставление строк в элементе Outlook как известных сущностей.For more information about the reasons behind this, see "Support for well-known entities" in Match strings in an Outlook item as well-known entities.

Поддерживаемые ведущие приложенияSupported hosts

Надстройки Outlook поддерживают Outlook 2013 или более поздней версии для Windows, Outlook 2016 или более поздней версии для Mac, Outlook в Интернете для локальной версии Exchange 2013 и более поздних версий, Outlook для iOS, Outlook для Android, Outlook в Интернете в Office 365 и Outlook.com.Outlook add-ins are supported in Outlook 2013 or later for Windows, Outlook 2016 or later for Mac, Outlook Web App for Exchange 2013 on-premises and later versions, Outlook for iOS, Outlook for Android, and Outlook on the web in Office 365 and Outlook.com. Не все новые функции поддерживаются сразу всеми клиентами.Not all of the newest features are supported in all clients at the same time. Просмотрите статьи и справочные материалы по API для этих функций, чтобы узнать, в каких ведущих приложениях они поддерживаются.Please refer to articles and API references for those features to see which hosts they may or may not be supported in.

Знакомство с разработкой надстроек OutlookGet started building Outlook add-ins

Чтобы приступить к разработке надстроек Outlook, попробуйте приведенные ниже ресурсы.To get started building Outlook add-ins, try the following.

  • Краткое руководство — создание простой надстройки области задач.Quick start - Build a simple task pane.
  • Учебник — узнайте, как создать надстройку, которая вставляет элементы gist с сайта GitHub в новое сообщение.Tutorial - Learn how to create an add-in that inserts GitHub gists into a new message.

См. такжеSee also