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

Статья
04/13/2024

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

Api предварительной версии могут быть изменены и не предназначены для использования в рабочей среде. Рекомендуется использовать их только в тестовой среде и среде разработки. Не используйте предварительные версии API в рабочей среде или в критически важных для бизнеса документах.

Чтобы использовать API предварительной версии:

Необходимо использовать предварительную версию библиотеки API JavaScript для Office из сети доставки содержимого (CDN)Office.js. Файл определения типа для компиляции TypeScript и IntelliSense находится в сети CDN и имеет тип DefinitelyTyped. Эти типы можно установить с npm install --save-dev @types/office-js-preview помощью (не забудьте удалить типы для @types/office-js , если они были установлены ранее).
Возможно, вам потребуется присоединиться к программе предварительной оценки Microsoft 365 для доступа к более поздним сборкам Office в Outlook в Windows и на Mac.
Возможно, вам потребуется настроить параметр Целевой выпуск в клиенте Microsoft 365 для предварительного просмотра функций в Outlook в Интернете. Дополнительные сведения см. в разделе "Целевой выпуск" статьи Настройка параметров стандартного или целевого выпуска.

Набор предварительных требований включает все функции набора требований 1.13.

Важно!

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

Возможности предварительной версии

Ниже перечислены возможности предварительной версии.

Активация надстройки на основе событий в сообщении в режиме чтения

События OnMessageReadWithCustomAttachment и OnMessageReadWithCustomHeader

Добавлены события для активации надстройки на основе событий в сообщении в режиме чтения, если оно содержит определенные типы вложений или пользовательские заголовки Интернета.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Атрибут HeaderName в элементе LaunchEvent

Добавлен атрибут к XML-элементу <LaunchEvent> для указания имени заголовка Интернета, в котором OnMessageReadWithCustomHeader происходит событие.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Элемент MessageAttachments

Добавлен XML-элемент для указания расширения файла вложения, включенного в сообщение, в котором OnMessageReadWithCustomAttachment происходит событие.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Дополнительные свойства календаря

Office.IsAllDayEvent

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

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Office.Sensitivity

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

Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)

Office.context.mailbox.item.isAllDayEvent

Добавлено новое свойство, представляющее, является ли встреча событием всего дня.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Office.context.mailbox.item.sensitivity

Добавлено новое свойство, представляющее конфиденциальность встречи.

Office.MailboxEnums.AppointmentSensitivityType

Добавлено новое перечисление AppointmentSensitivityType , представляющее параметры конфиденциальности, доступные для встречи.

Дополнительные члены сообщения

Office.context.mailbox.item.inReplyTo

Добавлено свойство для получения идентификатора исходного сообщения, на которое отвечает текущее сообщение.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Office.context.mailbox.item.getConversationIndexAsync

Добавлен метод для получения позиции текущего сообщения в кодировке Base64 в потоке беседы.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Office.context.mailbox.item.getItemClassAsync

Добавлен метод для получения класса элементов веб-служб Exchange (EWS) сообщения в режиме создания.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Закрытие и отмена сообщения в compose

Office.context.mailbox.item.closeAsync

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

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Получение URL-адреса среды выполнения JavaScript надстройки

Office.context.urls.javascriptRuntimeUrl

Добавлено свойство для получения URL-адреса среды выполнения JavaScript надстройки.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Интегрированные отчеты о спаме

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

Добавлена точка расширения для активации надстройки отчетов о спаме на ленте Outlook и предотвращения ее отображения в конце ленты или в разделе переполнения.

Элемент ReportPhishingCustomization

Добавлен элемент манифеста для настройки кнопки ленты и диалогового окна предварительной обработки надстройки, сообщающей о спаме.

Office.context.mailbox.item.getAsFileAsync

Добавлен метод для получения кодировки Base64 сообщения.

Office.SpamReportingEventCompletedOptions

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

Office.MailboxEnums.MoveSpamItemTo

Добавлено новое перечисление для указания папки, в которую передается сообщение после его обработки надстройкой со спамом.

Дополнительные сведения о том, как реализовать встроенную функцию отчетности о спаме в надстройке, см. в статье Реализация интегрированной надстройки для создания отчетов о нежелательной почте (предварительная версия).

Элемент с несколькими выборами: дополнительные свойства сообщения

Office.SelectedItemDetails

Возможность получать свойства выбранных сообщений в Outlook с помощью Office.context.mailbox.getSelectedItemsAsync появилась в наборе требований 1.13. Дополнительные свойства, такие как conversationId, internetMessageIdи hasAttachment, теперь доступны в предварительной версии.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Тема Office

Office.context.officeTheme

Добавлена возможность получения темы Office.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Office.EventType.OfficeThemeChanged

Добавлено событие OfficeThemeChanged для объекта Mailbox.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Интеллектуальные оповещения: настройте параметр "Не отправлять" и переопределите режим отправки во время выполнения.

Office.SmartAlertsEventCompletedOptions: дополнительные параметры

Добавлены дополнительные event.completed параметры для настройки кнопки Не отправлять в диалоговом окне смарт-оповещений и переопределения режима отправки во время выполнения.

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Office.MailboxEnums.SendModeOverride

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

Доступно в: Outlook для Windows (подписка на Microsoft 365)

Сведения о реализации этих функций см. в пошаговом руководстве по интеллектуальным оповещениям.

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

Возможности предварительной версии

Активация надстройки на основе событий в сообщении в режиме чтения

Дополнительные свойства календаря

Дополнительные члены сообщения

Закрытие и отмена сообщения в compose

Получение URL-адреса среды выполнения JavaScript надстройки

Интегрированные отчеты о спаме

Элемент с несколькими выборами: дополнительные свойства сообщения

Тема Office

Интеллектуальные оповещения: настройте параметр "Не отправлять" и переопределите режим отправки во время выполнения.

Office.SmartAlertsEventCompletedOptions: дополнительные параметры

Временно задайте текст или тему, отображаемые в режиме чтения

См. также

Обратная связь

Дополнительные ресурсы