Набор обязательных Предварительная версия API надстройки Outlook
Подмножество 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
Добавлено новое свойство, представляющее конфиденциальность встречи.
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Office.MailboxEnums.AppointmentSensitivityType
Добавлено новое перечисление AppointmentSensitivityType
, представляющее параметры конфиденциальности, доступные для встречи.
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Дополнительные члены сообщения
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 и предотвращения ее отображения в конце ленты или в разделе переполнения.
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Элемент ReportPhishingCustomization
Добавлен элемент манифеста для настройки кнопки ленты и диалогового окна предварительной обработки надстройки, сообщающей о спаме.
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Office.context.mailbox.item.getAsFileAsync
Добавлен метод для получения кодировки Base64 сообщения.
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Office.SpamReportingEventCompletedOptions
Созданы параметры для настройки диалогового окна постобработки или настройки надстройки отчетов о нежелательной почте для выполнения дополнительных операций с сообщаемого сообщения, таких как удаление его из папки "Входящие".
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Office.MailboxEnums.MoveSpamItemTo
Добавлено новое перечисление для указания папки, в которую передается сообщение после его обработки надстройкой со спамом.
Доступно в: Outlook для Windows (подписка на Microsoft 365), Outlook для Mac (подписка на Microsoft 365), Outlook в Интернете (современный), новый Outlook для Windows (предварительная версия)
Дополнительные сведения о том, как реализовать встроенную функцию отчетности о спаме в надстройке, см. в статье Реализация интегрированной надстройки для создания отчетов о нежелательной почте (предварительная версия).
Элемент с несколькими выборами: дополнительные свойства сообщения
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)
Сведения о реализации этих функций см. в пошаговом руководстве по интеллектуальным оповещениям.
Временно задайте текст или тему, отображаемые в режиме чтения
Office.context.mailbox.item.display
Добавлено свойство, которое получает объект для временного задания содержимого, отображаемого в тексте или теме сообщения в режиме чтения.
Доступно в: Outlook для Windows (подписка на Microsoft 365)
Office.Display
Добавлен объект , предоставляющий свойства для временного задания содержимого, отображаемого в тексте или теме сообщения в режиме чтения.
Доступно в: Outlook для Windows (подписка на Microsoft 365)
Office.DisplayedBody
Добавлен объект , предоставляющий метод для временного задания содержимого, отображаемого в тексте сообщения в режиме чтения.
Доступно в: Outlook для Windows (подписка на Microsoft 365)
Office.DisplayedSubject
Добавлен объект , предоставляющий метод для временного задания содержимого, отображаемого в теме сообщения в режиме чтения.
Доступно в: Outlook для Windows (подписка на Microsoft 365)
См. также
Office Add-ins
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по