在 Exchange 帐户之间切换时自动更新签名

现在，通过将 和 OnAppointmentFromChanged 事件添加到OnMessageFromChanged基于事件的激活功能，在使用多个 Exchange 帐户时将正确的签名应用于邮件变得更加容易。 当 OnMessageFromChanged 正在撰写的邮件的“ 发件人 ”字段中的帐户发生更改时，将发生该事件，而 OnAppointmentFromChanged 当正在撰写的会议的组织者发生更改时，将发生该事件。 这些事件进一步扩展了签名加载项的功能，并允许它们：

• 为用户提供为其每个帐户应用自定义签名的便利。
• 使邮箱代理能够更准确、更高效地管理来自多个邮箱的传出邮件和会议请求。
• 确保用户的消息和约会符合其组织的通信和营销策略。

以下部分将指导你如何开发基于事件的外接程序，该外接程序处理 OnMessageFromChanged 事件，以在更改“ 发件人 ”字段中的邮件帐户时自动更新邮件的签名。

支持的客户端和平台

下表列出了支持 OnMessageFromChanged 和 OnAppointmentFromChanged 事件的客户端-服务器组合。 选择适用事件的选项卡。

先决条件

若要测试演练，必须至少有两个 Exchange 帐户。

设置环境

完成 Outlook 快速入门，使用 Office 加载项的 Yeoman 生成器创建加载项项目。

配置清单

实现事件处理程序

必须为 和 OnMessageFromChanged 事件配置OnNewMessageCompose事件处理程序。 如果当前帐户上尚未配置默认签名，则 onNewMessageComposeHandler 函数会将签名添加到新创建的消息。 更改“ 发件人 ”字段中的帐户时， onMessageFromChangedHandler 函数会基于此新选择的帐户更新签名。

1. 在同一快速入门项目中，导航到 ./src 目录，然后创建名为 startvent 的新文件夹。

2. 在 ./src/startvent 文件夹中，创建一个名为 launchevent.js的新文件。

3. 在代码编辑器中打开文件 ./src/startvent/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 item = Office.context.mailbox.item;
   
       // Check if a default Outlook signature is already configured.
       item.isClientSignatureEnabledAsync({ asyncContext: event }, (result) => {
           if (result.status === Office.AsyncResultStatus.Failed) {
               console.log(result.error.message);
               return;
           }
   
           // Add a signature if there's no default Outlook signature configured.
           if (result.value === false) {
               item.body.setSignatureAsync(
                   "<i>This is a sample signature.</i>",
                   { asyncContext: result.asyncContext, coercionType: Office.CoercionType.Html },
                   addSignatureCallback
               );
           }
       });
   }
   
   // 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;
               item.body.setSignatureAsync(
                   signature,
                   { asyncContext: result.asyncContext.event, coercionType: Office.CoercionType.Html },
                   addSignatureCallback
               );
           });
       });
   }
   
   // Callback function to add a signature to the mail item.
   function addSignatureCallback(result) {
       if (result.status === Office.AsyncResultStatus.Failed) {
           console.log(result.error.message);
           return;
       }
   
       console.log("Successfully added signature.");
       result.asyncContext.completed();
   }
   
   // IMPORTANT: To ensure your add-in is supported in Outlook, remember to
   // map the event handler name specified in the manifest's LaunchEvent element (with the add-in only manifest)
   // or the "autoRunEvents.events.actionId" property (with the unified manifest for Microsoft 365)
   // 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时，如果本地 Web 服务器尚未运行) 并且加载项将被旁加载，则本地 Web 服务器将启动 (。

   npm run build
   

   npm start
   

   注意

   如果加载项未自动旁加载，请按照 旁加载 Outlook 外接程序 中的说明进行测试，在 Outlook 中手动旁加载加载项。

2. 在首选 Outlook 客户端中，创建新邮件。 如果未配置默认 Outlook 签名，外接程序会将一个添加到新创建的邮件。

   

3. 启用“ 发件人 ”字段（如果适用）。 有关如何启用它的指南，请参阅 更改用于发送电子邮件的帐户的“为什么缺少发件人按钮？”部分。

4. 选择“ 发件人”，然后选择其他 Exchange 帐户。 或者，通过选择“从>其他Email地址”手动输入 Exchange 电子邮件地址。 已更新的签名将添加到消息中，替换上一个签名。

   

5. 如果要停止本地 Web 服务器并卸载加载项，请按照适用的说明操作：

   • 若要停止服务器，请运行以下命令。 如果使用 npm start了 ，则以下命令还应卸载加载项。

     npm stop
     

   • 如果手动旁加载加载项，请参阅 删除旁加载加载项。

排查加载项问题

有关如何排查基于事件的激活加载项的指南，请参阅 基于事件的加载项和垃圾邮件报告加载项疑难解答。

部署到用户

与其他基于事件的外接程序类似，使用 OnMessageFromChanged 和 OnAppointmentFromChanged 事件的加载项必须由组织的管理员部署。 有关如何通过Microsoft 365 管理中心部署外接程序的指南，请参阅配置 Outlook 外接程序进行基于事件的激活的“部署到用户”部分。

事件行为和限制

OnMessageFromChanged由于 和 OnAppointmentFromChanged 事件通过基于事件的激活功能受支持，因此相同的行为和限制适用于因此事件而激活的加载项。 有关详细说明，请参阅 基于事件的激活行为和限制。

除了这些特征之外，当加载项在这些事件上激活时，以下方面也适用。

• 事件 OnMessageFromChanged 仅在邮件撰写模式下受支持，而 OnAppointmentFromChanged 事件仅在约会撰写模式下受支持。
• 在经典 Outlook on Windows 中，仅 OnMessageFromChanged 支持事件。
• OnMessageFromChanged和 OnAppointmentFromChanged 事件仅支持 Exchange 帐户。 在撰写的邮件中，从“ 发件人 ”字段下拉列表中选择 Exchange 帐户，或在字段中手动输入。 在撰写的约会中，从组织者字段下拉列表中选择 Exchange 帐户。 如果用户切换到“ 发件人 ”或“组织者”字段中的非 Exchange 帐户，Outlook 客户端会自动清除以前所选帐户设置的签名。
• 支持委托和共享邮箱方案。
• OnAppointmentFromChanged Microsoft 365 组日历不支持该事件。 如果用户从其 Exchange 帐户切换到组织者字段中的 Microsoft 365 组日历帐户，Outlook 客户端会自动清除 Exchange 帐户设置的签名。
• 在“发件人”或“组织者”字段中切换到另一个 Exchange 帐户时，将终止以前所选帐户的加载项（如果有），并与新选择的帐户关联的外接程序在启动 或 OnAppointmentFromChanged 事件之前OnMessageFromChanged加载。
• 支持Email帐户别名。 在“ 发件人 ”或“组织者”字段中选择当前帐户的别名时， OnMessageFromChanged 将发生 或 OnAppointmentFromChanged 事件，而无需重新加载帐户的加载项。
• 当错误打开“ 发件人 或组织者”字段下拉列表或重新选择“ 发件人 或组织者”字段中显示的同一帐户时， OnMessageFromChanged 将发生 或 OnAppointmentFromChanged 事件，但不会终止或重新加载帐户的加载项。

另请参阅

• 为基于事件的激活配置 Outlook 加载项
• 基于事件的 Outlook 加载项的 AppSource 列表选项