Обработка событий OnMessageSend и OnAppointmentSend в надстройке Outlook с помощью смарт-оповещений

События OnMessageSend и OnAppointmentSend пользуются преимуществами смарт-оповещений, которые позволяют выполнять логику после того, как пользователь выберет Отправить в своем сообщении Outlook или встрече. С помощью смарт-оповещений пользователи надстройки могут воспользоваться возможностью улучшить содержимое своей электронной почты, добавить недостающую метку конфиденциальности или включить важного получателя в приглашение на собрание.

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

Примечание.

События OnMessageSend и OnAppointmentSend были введены в наборе требований 1.12. См клиенты и платформы, поддерживающие этот набор обязательных требований.

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

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

Клиент	Exchange Online.	Локальная версия Exchange 2019 (накопительное обновление 12 или более поздняя версия)	Локальная среда Exchange 2016 (накопительное обновление 22 или более поздняя версия)
Windows Версия 2206 (сборка 15330.20196) или более поздняя	Да	Да	Да
Mac Версия 16.65.827.0 или более поздняя	Да	Неприменимо	Неприменимо
Веб-браузер (современный пользовательский интерфейс) новый Outlook в Windows (предварительная версия)	Да	Неприменимо	Неприменимо
iOS	Неприменимо	Неприменимо	Неприменимо
Android	Неприменимо	Неприменимо	Неприменимо

Поведение и сценарии функций интеллектуальных оповещений

В следующих разделах содержатся рекомендации по параметрам режима отправки и поведению функции в определенных сценариях.

Доступные параметры режима отправки

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

• XML-манифест. Задайте свойство SendMode элемента LaunchEvent .
• Унифицированный манифест для Microsoft 365 (предварительная версия): задайте параметр sendMode объекта события в массиве autoRunEvents.

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

В следующей таблице перечислены доступные параметры режима отправки.

Каноническое имя параметра режима отправки	Имя манифеста XML	Унифицированный манифест для имени Microsoft 365
запрос пользователя	PromptUser	promptUser
мягкий блок	SoftBlock	softBlock
Блок	Block	Блок

запрос пользователя

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

Если применяется одно из указанных ниже действий, воспользуйтесь параметром "Запрашивать пользователя " в надстройке.

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

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

мягкий блок

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

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

Блок

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

• Элемент не соответствует условиям надстройки.
• Надстройке не удается подключиться к серверу.
• Ошибка при загрузке надстройки.

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

Надстройка недоступна

Если надстройка недоступна при отправке сообщения или встречи (например, возникает ошибка, препятствующая загрузке надстройки), пользователь получает оповещение. Параметры, доступные пользователю, различаются в зависимости от параметра режима отправки, примененного к надстройке.

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

Если используется параметр блокировать , пользователь не сможет отправить элемент, пока надстройка не станет доступной.

Важно!

Если надстройка Smart Alerts, реализующая функцию переопределения режима отправки , не может завершить обработку события из-за ошибки или недоступна при возникновении события, она использует параметр режима отправки, указанный в манифесте.

Длительные операции надстроек

Если надстройка выполняется более пяти секунд, но менее пяти минут, пользователь получает предупреждение о том, что надстройка обрабатывает сообщение или встречу дольше, чем ожидалось.

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

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

OnMessageSend и OnAppointmentSend надстройки должны быть короткими и упрощенными. Чтобы избежать длительных операций, используйте другие события для обработки условных проверок перед активацией OnMessageSend события или OnAppointmentSend . Например, если пользователю требуется шифровать вложения для каждого сообщения или встречи, рассмотрите OnMessageAttachmentsChanged возможность использования события или OnAppointmentAttachmentsChanged для выполнения проверка.

Истекло время ожидания надстройки

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

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

Клиент Outlook в автономном режиме

В Outlook для Windows (начиная с версии 2310 (сборка 16913.10000)) надстройка Smart Alerts, реализующая параметр обратимого блока или блока , может обрабатывать почтовый элемент только во время подключения клиента Outlook. Если режим "Работать в автономном режиме" включен в клиенте Outlook при отправке почтового элемента, элемент не сохраняется в папке "Исходящие" и пользователь получает предупреждение о том, что он должен отключить режим "Работа в автономном режиме", прежде чем он сможет отправить свой элемент.

В Outlook на Mac параметр "Отправить" становится недоступным в режиме "Работа в автономном режиме". После отключения режима "Работа в автономном режиме" пользователь может выбрать Отправить и активировать надстройку Смарт-оповещения.

Пользователь переходит от текущего сообщения

Когда пользователь уходит от отправляемого сообщения (например, для чтения сообщения в папке "Входящие"), поведение надстройки Smart Alerts в разных клиентах Outlook отличается. Выберите вкладку для клиента Outlook, на котором выполняется надстройка.

Windows

Сообщение, составленное в окне

Начиная с версии 2402 (сборка 17310.10000), если сообщение создается в отдельном окне, например в новом сообщении, и пользователь переходит от него после нажатия кнопки Отправить, надстройка Smart Alerts продолжит обрабатывать сообщение в фоновом режиме. Если перед отправкой сообщения требуются дополнительные действия, пользователю будет показано соответствующее диалоговое окно смарт-оповещений (см. раздел Доступные параметры режима отправки).

Сообщение, составленное в области чтения

Начиная с версии 2402 (сборка 17310.10000), если в области чтения Outlook создается ответ, пересылаемый или существующий черновик, а пользователь переходит от него после нажатия кнопки Отправить, пользователю показано диалоговое окно с параметрами. Доступные параметры зависят от параметра режима отправки , реализованного надстройкой.

Если реализован параметр "Режим отправки запроса пользователя ", отображаются следующие параметры.

• Ожидание. Этот параметр открывает сообщение, создаваемое в новом окне, чтобы надстройка Smart Alerts могла продолжить его обработку. Если пользователь переходит из только что открытого окна во время обработки, надстройка продолжит обрабатывать сообщение в фоновом режиме (дополнительные сведения см. в разделе Сообщение, составленное в окне). Если перед отправкой сообщения требуются дополнительные действия, пользователю будет показано соответствующее диалоговое окно смарт-оповещений.
• Отправить в любом случае. Этот параметр завершает операцию надстройки и отправляет сообщение.
• Сохранить как черновик. Этот параметр завершает работу надстройки и отправляет операции и сохраняет черновик сообщения в папку Черновики почтового ящика.

Если параметр обратимого блока или режима отправки блоков реализован, отображаются только параметры Ждать и Сохранить как черновик .

Mac

В Outlook для Mac, когда пользователь удаляется от сообщения, которое он отправляет после нажатия кнопки Отправить, надстройка Smart Alerts продолжит обрабатывать элемент в фоновом режиме. Если элемент не соответствует условиям надстройки, пользователю показано диалоговое окно, предупреждающее пользователя о том, что перед отправкой элемента могут потребоваться дополнительные действия. И наоборот, если элемент соответствует условиям надстройки, он отправляется после завершения обработки надстройки.

Web/New Outlook в Windows (предварительная версия)

В Outlook в Интернете или в новом Outlook для Windows (предварительная версия) пользователь должен оставаться в сообщении, отправляемом до тех пор, пока надстройка Smart Alerts не завершит его обработку. В противном случае, когда пользователь уйдет от элемента, надстройка завершает операцию смарт-оповещений и сохраняет черновик в папке Черновики почтового ящика.

Активация смарт-оповещений в приложениях, использующих Simple MAPI

Примечание.

В настоящее время эта функция поддерживается только в Outlook для Windows, начиная с версии 2301 (сборка 17126.20004).

Пользователи могут отправлять почтовые элементы через определенные приложения, использующие Simple MAPI, даже если клиент Outlook не запущен во время отправки элемента. В этом случае все установленные надстройки Smart Alerts не будут активированы для проверка почтового элемента для соответствия требованиям.

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

Поведение при включенном параметре

Если для параметра Запуск Outlook для простой отправки почты MAPIзадано значение Включено, пользователи должны запустить клиент Outlook во время отправки почтового элемента в следующих сценариях.

• Файл отправляется в виде вложения с помощью параметра Поделиться>присоединить копию в Excel, Word или PowerPoint.

  

• Файл отправляется в виде вложения с помощью параметра Отправить получателю>почты в проводник.

  

• Файл отправляется через приложение, использующее Simple MAPI, которое открывает новое окно Outlook.

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

Поведение, когда параметр отключен или не настроен

Если для параметра Запуск Outlook для простой отправки почты MAPIзадано значение Отключено или Не настроено в вашей организации, любой пользователь, использующий приложения, реализующие Simple MAPI для отправки почтовых элементов, сможет сделать это без активации надстройки Smart Alerts для проверки соответствия требованиям.

Настройка параметра групповая политика

По умолчанию для параметра Запуск Outlook для простой отправки почты MAPI задано значение Не настроено. Чтобы включить этот параметр, выполните следующие действия.

1. Скачайте последнее средство административных шаблонов.
2. Откройте редактор локальных групповых политик (gpedit.msc).
3. Перейдите в раздел Конфигурация пользователя\Административные шаблоны\Microsoft Outlook 2016\Прочее.
4. Откройте параметр Запуск Outlook для простой отправки почты MAPI .
5. В появившемся диалоговом окне выберите Включено.
6. Нажмите кнопку ОК или Применить , чтобы сохранить изменения.

Ограничения

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

Помимо этих ограничений, в манифесте может быть объявлен только один экземпляр каждого события OnMessageSend и OnAppointmentSend . Если требуется несколько OnMessageSend событий или OnAppointmentSend , необходимо объявить каждое из них в отдельной надстройке.

Хотя вы можете изменить диалоговое сообщение Smart Alerts и кнопку Не отправлять в соответствии со сценарием надстройки, следующие параметры нельзя настроить.

• Строка заголовка диалогового окна. Имя вашей надстройки всегда отображается там.
• Формат сообщения. Например, нельзя изменить размер шрифта и цвет текста или вставить маркированный список.
• Значок рядом с диалоговым сообщением.
• Диалоговые окна, предоставляющие сведения об обработке событий и ходе выполнения. Например, текст и параметры, отображаемые в диалоговых окнах времени ожидания и длительных операций, нельзя изменить.

Если вы настроите кнопку Не отправлять в диалоговом окне, ей можно назначить только команду области задач. Команды функции не поддерживаются. При нажатии кнопки Не отправлять с назначенной функцией команды команда игнорируется, а надстройка отменяет операцию отправки и закрывает диалоговое окно. В этом случае ошибка не отображается и не регистрируется. Рекомендации по типам команд надстроек см. в разделе Типы команд надстройки.

В Outlook в Интернете и в новом Outlook в Windows (предварительная версия):

• Событие OnAppointmentSend возникает только в том случае, если собрание, отправляемое, было создано с помощью параметра Создать событие . Если отправляемое собрание было создано путем выбора даты и времени непосредственно из календаря, OnAppointmentSend событие не возникает.
• При пересылке собрания событие происходит только в том случае, OnAppointmentSend если организатор перенаправит собрание. Это не происходит, если участник перенаправит собрание, на которое он приглашен.

Лучшие методики

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

• Не позволяйте надстройке откладывать операцию отправки. Надстройки смарт-оповещений должны быть короткими и упрощенными. Избегайте перегрузки OnMessageSend обработчиков событий и OnAppointmentSend интенсивной проверкой. Чтобы избежать этого, предварительно обработайте сведения при возникновении других событий, таких как OnMessageRecipientsChanged событие или OnMessageAttachmentsChanged . Чтобы определить, на какие события может реагировать ваша надстройка, см. раздел "Поддерживаемые события" статьи Настройка надстройки Outlook для активации на основе событий.
• Не реализуйте дополнительные диалоги. Предотвращение перегрузки пользователей слишком большим количеством диалогов. Вместо этого настройте текст в диалоговом окне Смарт-оповещения для передачи информации. При необходимости можно также настроить кнопку "Не отправлять " (предварительная версия), чтобы предоставить пользователям дополнительные сведения и функции в области задач.
• Включите соответствующие параметры групповая политика в организации. Чтобы убедиться, что надстройка Smart Alerts активируется для каждого почтового элемента, включая отправленные с помощью приложений, реализующих Simple MAPI, настройте параметр Запуск Outlook для простой отправки MAPI . Дополнительные сведения об этом параметре см. в статье Активация интеллектуальных оповещений в приложениях, использующих Simple MAPI.

Отладка надстройки

Инструкции по устранению неполадок надстройки Smart Alerts см. в статье Устранение неполадок надстроек на основе событий и отчетов о спаме.

Развертывание для пользователей

Как и другие надстройки на основе событий, надстройки, использующие функцию смарт-оповещений, должны развертываться администратором организации. Инструкции по развертыванию надстройки с помощью Центр администрирования Microsoft 365 см. в разделе "Развертывание для пользователей" статьи Настройка надстройки Outlook для активации на основе событий.

Важно!

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

Различия между интеллектуальными оповещениями и функцией отправки

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

Атрибут	Интеллектуальные оповещения	При отправке
Минимальный поддерживаемый набор требований	Почтовый ящик 1.12	Mailbox 1.8
Поддерживаемые клиенты Outlook	— Windows (классическая и новая (предварительная версия)) — Веб-браузер (современный пользовательский интерфейс) — Mac (новый пользовательский интерфейс)	-Windows — веб-браузер (классический и современный пользовательский интерфейс) — Mac (классический и новый пользовательский интерфейс)
Поддерживаемые события	XML-манифест - OnMessageSend - OnAppointmentSend Унифицированный манифест для Microsoft 365 (предварительная версия) — messageSending - "appointmentSending"	XML-манифест - ItemSend Унифицированный манифест для Microsoft 365 (предварительная версия) — не поддерживается
Свойство расширения манифеста	XML-манифест - LaunchEvent Унифицированный манифест для Microsoft 365 (предварительная версия) — "autoRunEvents"	XML-манифест - Events Унифицированный манифест для Microsoft 365 (предварительная версия) — не поддерживается
Поддерживаемые параметры режима отправки	— запрос пользователя — мягкий блок -Блок Дополнительные сведения о каждом параметре см. в статье Доступные параметры режима отправки.	Блокировка
Максимальное количество поддерживаемых событий в надстройке	Одно OnMessageSend и одно OnAppointmentSend событие.	Одно ItemSend событие.
Развертывание надстройки	Надстройка может быть опубликована в AppSource, если для ее свойства режима отправки задан параметр пользователя обратимого блока или запроса . В противном случае надстройка должна быть развернута администратором организации.	Надстройка не может быть опубликована в AppSource. Он должен быть развернут администратором организации.
Дополнительная конфигурация для установки надстройки	После отправки манифеста в Центр администрирования Microsoft 365 дополнительная настройка не требуется.	В зависимости от стандартов соответствия требованиям организации и используемого клиента Outlook для установки надстройки необходимо настроить определенные политики почтовых ящиков.

Попробуйте интеллектуальные оповещения в надстройке на основе событий

Готовы реализовать интеллектуальные оповещения в надстройке на основе событий? Ознакомьтесь с пошаговым руководством , в котором вы создадите надстройку, которая проверяет, прикреплен ли документ или рисунок к сообщению перед отправкой.

См. также

• Обработка событий OnMessageSend и OnAppointmentSend в надстройке Outlook с помощью смарт-оповещений
• Настройка надстройки Outlook для активации на основе событий
• Параметры описания AppSource для надстройки Outlook на основе событий
• Пример кода надстроек Office: пример кода надстроек Office: проверка цветовых категорий сообщения или встречи перед отправкой с помощью смарт-оповещений
• Пример кода надстроек Office: проверка метки конфиденциальности сообщения