Набор обязательных требований к API надстройки Outlook 1.13

Подмножество API надстройки Outlook API JavaScript для Office включает объекты, методы, свойства и события, которые можно использовать в надстройке Outlook.

Примечание.

В этой документации рассматривается не последняя версия набора обязательных элементов.

Новые возможности версии 1.13

Набор обязательных почтовых ящиков 1.13 включает все функции набора требований 1.12. В нем добавлены перечисленные ниже возможности.

  • Добавлена поддержка активации надстройки без включенной области чтения или выбранного сообщения.
  • Добавлена поддержка управления данными о доставке и временем сообщения.
  • Добавлены новые события для активации на основе событий.
  • Добавлена функция множественного выбора элементов.
  • Добавлена функция prepend-on-send.
  • Добавлена функция метки конфиденциальности.
  • Добавлена поддержка сценариев общих почтовых ящиков.

Список API

В следующей таблице перечислены API, представленные в наборе обязательных почтовых ящиков 1.13. Справочную документацию по API для всех API, поддерживаемых набором обязательных почтовых ящиков версии 1.13 или более ранней версии, см. в разделе API Outlook.

Класс Поля Описание
AppointmentCompose sensitivityLabel Возвращает объект для получения или задания метки конфиденциальности встречи.
Основной текст prependOnSendAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void) Добавляет HTML-код или обычный текст к началу сообщения или текста встречи при отправке почтового элемента.
prependOnSendAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Добавляет HTML-код или обычный текст к началу сообщения или текста встречи при отправке почтового элемента.
DelayDeliveryTime getAsync(callback?: (asyncResult: Office.AsyncResult<Date | 0>) => void) Возвращает дату и время доставки сообщения.
getAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<Date | 0>) => void) Возвращает дату и время доставки сообщения.
setAsync(datetime: Date, callback?: (asyncResult: Office.AsyncResult<void>) => void) Задает дату и время доставки сообщения.
setAsync(datetime: Date, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Задает дату и время доставки сообщения.
Mailbox getSelectedItemsAsync(callback: (asyncResult: Office.AsyncResult<SelectedItemDetails[]>) => void) Возвращает выбранные сообщения, для которых надстройка может активировать и выполнять операции.
getSelectedItemsAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SelectedItemDetails[]>) => void) Возвращает выбранные сообщения, для которых надстройка может активировать и выполнять операции.
MessageCompose delayDeliveryTime Возвращает или задает отложенную дату и время доставки сообщения.
sensitivityLabel Возвращает объект для получения или задания метки конфиденциальности сообщения.
SelectedItemDetails itemId Идентификатор элемента веб-служб Exchange (EWS) выбранного сообщения.
itemMode Режим Outlook (Read или Compose) выбранного сообщения.
itemType Тип выбранного элемента.
subject Описание, отображающееся в поле темы сообщения, выбранного в данный момент.
SensitivityLabel getAsync(callback: (asyncResult: Строка Office.AsyncResult<) => void)> Возвращает уникальный идентификатор (GUID) метки конфиденциальности, применяемой к создаваемому сообщению или встрече.
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void) Возвращает уникальный идентификатор (GUID) метки конфиденциальности, применяемой к создаваемому сообщению или встрече.
setAsync(sensitivityLabel: string | SensitivityLabelDetails, обратный вызов?: (asyncResult: Office.AsyncResult<void>) => void) Применяет указанную метку конфиденциальности к создаваемому сообщению или встрече.
setAsync(sensitivityLabel: string | SensitivityLabelDetails, параметры: Office.AsyncContextOptions, обратный вызов?: (asyncResult: Office.AsyncResult<void>) => void) Применяет указанную метку конфиденциальности к создаваемому сообщению или встрече.
SensitivityLabelChangedEventArgs type Тип создаваемого события.
SensitivityLabelDetails Детей Вложенные метки метки конфиденциальности.
color Цвет метки конфиденциальности.
id Уникальный идентификатор (GUID) метки конфиденциальности.
name Имя метки конфиденциальности.
Подсказки Описание метки конфиденциальности.
SensitivityLabelsCatalog getAsync(callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void) Возвращает все метки конфиденциальности, включенные в Outlook.
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void) Возвращает все метки конфиденциальности, включенные в Outlook.
getIsEnabledAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void) Проверяет, включен ли каталог меток конфиденциальности в Outlook.
getIsEnabledAsync(options: Office.AsyncContextOptions, обратный вызов: (asyncResult: Office.AsyncResult<boolean>) => void) Проверяет, включен ли каталог меток конфиденциальности в Outlook.

События

В следующей таблице перечислены события , представленные в наборе требований 1.13. Список всех поддерживаемых событий, которые можно обрабатывать с помощью методов иremoveHandlerAsync, см. в addHandlerAsync разделе Office.EventType.

Событие Описание Object
SelectedItemsChanged Выбирается или отменяется выбор одного или нескольких сообщений. Mailbox
SensitivityLabelChanged Метка конфиденциальности сообщения или встречи изменяется. Элемент

Примечание.

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

Обновления манифеста

В следующей таблице перечислены обновления манифеста, представленные в наборе требований почтового ящика 1.13. Дополнительные сведения о типах манифестов надстроек Office см. в разделе Манифест надстроек Office.

Функция Унифицированный манифест для Microsoft 365 Манифест только надстройки Описание
Нет контекста элемента "extensions.runtimes.actions.supportsNoItemContext" SupportsNoItemContext Позволяет надстройкам области задач активироваться без включения области чтения или выбранного сообщения.
Поддержка общих почтовых ящиков "authorization.permissions.resourceSpecific.name" установите значение "Mailbox.SharedFolder" SupportsSharedFolders Определяет, доступна ли надстройка в сценариях с общим почтовым ящиком.

См. также