Автоматическое обновление подписи при переключении между учетными записями Exchange

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

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

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

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

В следующих таблицах перечислены сочетания клиента и сервера, которые поддерживают OnMessageFromChanged события и OnAppointmentFromChanged . Выберите вкладку для соответствующего события.

Предварительные условия

Чтобы протестировать пошаговое руководство, необходимо иметь по крайней мере две учетные записи Exchange.

Настройка среды

Выполните краткое руководство по Outlook, в котором создается проект надстройки с генератором Yeoman для надстроек Office.

Настройка манифеста

Реализация обработчиков событий

Обработчики событий должны быть настроены OnNewMessageCompose для событий и OnMessageFromChanged . Функция onNewMessageComposeHandler добавляет подпись в только что созданное сообщение, если оно по умолчанию еще не настроено в текущей учетной записи. При изменении onMessageFromChangedHandler учетной записи в поле From функция обновляет подпись на основе этой только что выбранной учетной записи.

1. В том же проекте быстрого запуска перейдите в каталог ./src , а затем создайте папку с именем launchevent.

2. В папке ./src/launchevent создайте файл с именемlaunchevent.js.

3. Откройте файл ./src/launchevent/launchevent.js в редакторе кода и добавьте следующий код JavaScript.

   /*
    * Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
    * See LICENSE in the project root for license information.
    */
   
   // The OnNewMessageCompose event handler that adds a signature to a new message.
   function onNewMessageComposeHandler(event) {
       const platform = Office.context.platform;
       const signature = "<i>This is a sample signature.</i>";
   
       // On supported platforms, check if a default Outlook signature is already configured.
       if (platform !== Office.PlatformType.Android && platform !== Office.PlatformType.iOS) {
           Office.context.mailbox.item.isClientSignatureEnabledAsync({ asyncContext: { event: event, signature: signature } }, (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               // Add a signature if there's no default Outlook signature configured.
               const signatureEnabled = result.value;
               if (signatureEnabled === false) {
                   const event = result.asyncContext.event;
                   const signature = result.asyncContext.signature;
                   setSignature(signature, event);
               }
           });
       } else {
           setSignature(signature, event);
       }
   }
   
   // The OnMessageFromChanged event handler that updates the signature when the email address in the From field is changed.
   function onMessageFromChangedHandler(event) {
       const item = Office.context.mailbox.item;
       const signatureIcon =
       "iVBORw0KGgoAAAANSUhEUgAAACcAAAAnCAMAAAC7faEHAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAzUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKMFRskAAAAQdFJOUwAQIDBAUGBwgI+fr7/P3+8jGoKKAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABT0lEQVQ4T7XT2ZalIAwF0DAJhMH+/6+tJOQqot6X6joPiouNBo3w9/Hd6+hrYnUt6vhLcjEAJevVW0zJxABSlcunhERpjY+UKoNN5+ZgDGu2onNz0OngjP2FM1VdyBW1LtvGeYrBLs7U5I1PTXZt+zifcS3Icw2GcS3vxRY3Vn/iqx31hUyTnV515kdTfbaNhZLI30AceqDiIo4tyKEmJpKdP5M4um+nUwfDWxAXdzqMNKQ14jLdL5ntXzxcRF440mhS6yu882Kxa30RZcUIjTCJg7lscsR4VsMjfX9Q0Vuv/Wd3YosD1J4LuSRtaL7bzXGN1wx2cytUdncDuhA3fu6HPTiCvpQUIjZ3sCcHVbvLtbNTHlysx2w9/s27m9gEb+7CTri6hR1wcTf2gVf3wBRe3CMbcHYvTODkXhnD0+178K/pZ9+n/C1ru/2HAPwAo7YM1X4+tLMAAAAASUVORK5CYII=";
   
       // Get the currently selected From account.
       item.from.getAsync({ asyncContext: event }, (result) => {
           if (result.status === Office.AsyncResultStatus.Failed) {
               console.log(result.error.message);
               return;
           }
   
           // Create a signature based on the currently selected From account.
           const name = result.value.displayName;
           const options = { asyncContext: { event: result.asyncContext, name: name }, isInline: true };
           item.addFileAttachmentFromBase64Async(signatureIcon, "signatureIcon.png", options, (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               // Add the created signature to the mail item.
               const signature = "<img src='cid:signatureIcon.png'>" + result.asyncContext.name;
               const event = result.asyncContext.event;
               setSignature(signature, event);
           });
       });
   }
   
   // Sets the custom signature and adds it to the mail item.
   function setSignature(signature, event) {
       Office.context.mailbox.item.body.setSignatureAsync(
           signature,
           { asyncContext: event, coercionType: Office.CoercionType.Html },
           (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               console.log("Successfully added signature.");
               const event = result.asyncContext;
               event.completed();
           }
       );
   }
   
   // IMPORTANT: To ensure your add-in is supported in Outlook, remember to
   // map the event handler name specified in the manifest to its JavaScript counterpart.
   Office.actions.associate("onNewMessageComposeHandler", onNewMessageComposeHandler);
   Office.actions.associate("onMessageFromChangedHandler", onMessageFromChangedHandler);
   

Обновление HTML-файла команд

1. В папке ./src/commands откройте commands.html.

2. Добавьте следующий код под существующим тегом скрипта .

   <script type="text/javascript" src="../launchevent/launchevent.js"></script>
   

3. Сохраните изменения.

Обновление настроек конфигурации webpack

1. В корневом каталоге проекта откройте файлwebpack.config.js .

2. plugins Найдите массив в объекте config и добавьте следующий новый объект в начало массива.

   new CopyWebpackPlugin({
     patterns: [
       {
         from: "./src/launchevent/launchevent.js",
         to: "launchevent.js",
       },
     ],
   }),
   

3. Сохраните изменения.

Проверка

1. Выполните следующие команды в корневом каталоге проекта. При запуске npm startзапустится локальный веб-сервер (если он еще не запущен), и надстройка будет загружена неопубликованно.

   npm run build
   

   npm start
   

   Примечание.

   • При первом использовании генератора Yeoman для разработки надстройки Office браузер по умолчанию открывает окно, в котором вам будет предложено войти в учетную запись Microsoft 365. Если окно входа не отображается и возникает ошибка загрузки неопубликованного приложения или времени ожидания входа, выполните команду atk auth login m365 перед повторным запуском npm start .

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

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

   

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

4. Выберите От, а затем выберите другую учетную запись Exchange. Кроме того, можно вручную ввести адрес электронной почты Exchange, выбрав Из>другого Email адрес. В сообщение добавляется обновленная сигнатура, заменяющая предыдущую.

   

5. Если вы хотите остановить локальный веб-сервер и удалить надстройку, следуйте применимым инструкциям:

   • Чтобы остановить сервер, выполните следующую команду. Если вы использовали npm start, следующая команда также должна удалить надстройку.

     npm stop
     

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

Устранение неполадок с надстройкой

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

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

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

Поведение и ограничения событий

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

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

• Событие OnMessageFromChanged поддерживается только в режиме создания сообщений, а OnAppointmentFromChanged событие поддерживается только в режиме создания встреч.
• В Outlook в Интернете в Windows (новой и классической версии) и на мобильных устройствах поддерживается только OnMessageFromChanged событие.
• События OnMessageFromChanged и OnAppointmentFromChanged поддерживают только учетные записи Exchange. Если пользователь переключается на учетную запись, не относясь к Exchange, в поле От или организатор, клиент Outlook автоматически очищает подпись, заданную ранее выбранной учетной записью.
• В зависимости от клиента Outlook в создаваемых сообщениях учетная запись Exchange выбирается из раскрывающегося списка Из поля или вводится в поле вручную. Outlook на мобильных устройствах поддерживает только выбор учетной записи в раскрывающемся списке Из поля. При составлении встреч учетная запись Exchange выбирается в раскрывающемся списке поле организатора.
• В Outlook в Интернете, в Windows (новой и классической версии), а также в Mac OnMessageFromChanged события и OnAppointmentFromChanged поддерживают сценарии делегирования и общего почтового ящика. Эти сценарии не поддерживаются в Outlook на мобильных устройствах.
• Событие OnAppointmentFromChanged не поддерживается в календарях групп Microsoft 365. Если пользователь переключается со своей учетной записи Exchange на учетную запись календаря группы Microsoft 365 в поле организатора, клиент Outlook автоматически очищает подпись, заданную учетной записью Exchange.
• При переключении на другую учетную запись Exchange в поле From или organizer надстройки для ранее выбранной учетной записи прекращаются, а надстройки, связанные с только что выбранной учетной записью, загружаются перед запуском OnMessageFromChanged события или OnAppointmentFromChanged .
• В Outlook в Интернете в Windows (новой и классической версии) и в Mac поддерживаются псевдонимы учетных записей электронной почты. Если в поле From или organizer выбран псевдоним для текущей учетной записи, OnMessageFromChanged событие или OnAppointmentFromChanged происходит без перезагрузки надстроек учетной записи. Email псевдонимы учетных записей не поддерживаются в Outlook на мобильных устройствах.
• Если раскрывающийся список поле "От " или "организатор" открывается по ошибке или повторно выбрана та же учетная запись, которая отображается в поле "От " или "организатор", OnMessageFromChanged происходит событие или OnAppointmentFromChanged , но надстройки учетной записи не прекращаются и не перезагружаются.

См. также

• Активация надстроек с помощью событий
• Параметры описания в Microsoft Marketplace для надстройки на основе событий