现在，通过将 和 OnAppointmentFromChanged 事件添加到OnMessageFromChanged基于事件的激活功能，在使用多个 Exchange 帐户时将正确的签名应用于邮件变得更加容易。 当 OnMessageFromChanged 正在撰写的邮件的“ 发件人 ”字段中的帐户发生更改时，将发生该事件，而 OnAppointmentFromChanged 当正在撰写的会议的组织者发生更改时，将发生该事件。 这些事件进一步扩展了签名加载项的功能，并允许它们：
以下部分将指导你如何开发基于事件的外接程序，该外接程序处理 OnMessageFromChanged 事件，以在更改“ 发件人 ”字段中的邮件帐户时自动更新邮件的签名。
下表列出了支持 OnMessageFromChanged 和 OnAppointmentFromChanged 事件的客户端-服务器组合。 选择适用事件的选项卡。
| 客户端 | Exchange Online | Exchange 2019 本地 (累积更新 12 或更高版本) | Exchange 2016 本地 (累积更新 22 或更高版本) |
|---|---|---|---|
|
Web 浏览器 (新式 UI) 新的 Outlook on Windows |
支持 | 不适用 | 不适用 |
|
Windows (经典) 版本 2304 (内部版本 16327.20248) 或更高版本 |
支持 | 支持 | 支持 |
|
Mac 版本 16.77 (23081600) 或更高版本 |
支持 | 不适用 | 不适用 |
|
iOS 版本 4.2502.0 |
支持 | 不适用 | 不适用 |
|
Android 版本 4.2502.0 |
支持 | 不适用 | 不适用 |
若要测试演练，必须至少有两个 Exchange 帐户。
完成 Outlook 快速入门，使用 Office 加载项的 Yeoman 生成器创建加载项项目。
打开 manifest.json 文件。
导航到 “authorization.permissions.resourceSpecific” 数组。 在数组对象中，将 “name” 属性的值替换为“MailboxItem.ReadWrite.User”。 加载项需要此项才能更新消息的签名。
...
"authorization": {
"permissions": {
"resourceSpecific": [
{
"name": "MailboxItem.ReadWrite.User",
"type": "Delegated"
}
]
}
},
...
将以下 对象添加到 “extensions.runtimes” 数组。 关于此标记，请注意以下几点。
邮箱要求集的 “minVersion” 配置为“1.13”，因为这是支持事件 OnMessageFromChanged 的要求集的最低版本。 有关详细信息，请参阅 配置 Outlook 外接程序进行基于事件的激活中的“支持的事件”表。
运行时的 “id” 设置为描述性名称“autorun_runtime”。
“code”属性的子“page”属性设置为 HTML 文件，子“script”属性设置为 JavaScript 文件。 稍后的步骤将创建或编辑这些文件。 Office 根据平台使用这些值之一。
<script> 加载 JavaScript 文件的标记。有关详细信息，请参阅 Office 外接程序中的运行时。
“lifetime”属性设置为“short”。 这意味着运行时在事件发生时启动，并在处理程序完成时关闭。
有 “作” 用于运行 OnMessageFromChanged 和 OnNewMessageCompose 事件的处理程序。 你将在后面的步骤中创建处理程序。
{
"requirements": {
"capabilities": [
{
"name": "Mailbox",
"minVersion": "1.13"
}
]
},
"id": "autorun_runtime",
"type": "general",
"code": {
"page": "https://localhost:3000/commands.html",
"script": "https://localhost:3000/launchevent.js"
},
"lifetime": "short",
"actions": [
{
"id": "onMessageFromChangedHandler",
"type": "executeFunction",
"displayName": "onMessageFromChangedHandler"
},
{
"id": "onNewMessageComposeHandler",
"type": "executeFunction",
"displayName": "onNewMessageComposeHandler"
}
]
}
将 “autoRunEvents” 数组添加为“extensions”数组中 对象的属性。 “autoRunEvents”数组包含具有以下键属性的对象。
OnMessageFromChanged 和 OnNewMessageCompose 事件。 有关统一清单中使用的事件名称的信息，请参阅 为基于事件的激活配置 Outlook 外接程序中的“支持的事件”表。"autoRunEvents": [
{
"requirements": {
"capabilities": [
{
"name": "Mailbox",
"minVersion": "1.13"
}
],
"scopes": [
"mail"
]
},
"events": [
{
"type": "messageFromChanged",
"actionId": "onMessageFromChangedHandler"
},
{
"type": "newMessageComposeCreated",
"actionId": "onNewMessageComposeHandler"
}
]
}
]
提示
必须为 和 OnMessageFromChanged 事件配置OnNewMessageCompose事件处理程序。 如果当前帐户上尚未配置默认签名，则 onNewMessageComposeHandler 函数会将签名添加到新创建的消息。 更改“ 发件人 ”字段中的帐户时， onMessageFromChangedHandler 函数会基于此新选择的帐户更新签名。
在同一快速入门项目中，导航到 ./src 目录，然后创建名为 startvent 的新文件夹。
在 ./src/startvent 文件夹中，创建一个名为 launchevent.js的新文件。
在代码编辑器中打开文件 ./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 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'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);
重要
Windows：目前，在 JavaScript 文件中，你对基于事件的激活实现处理不支持导入。
提示
在经典 Outlook on Windows 中运行的基于事件的加载项不会运行 和 Office.initialize 函数中包含的Office.onReady()代码。 建议改为将加载项启动逻辑（例如检查用户的 Outlook 版本）添加到事件处理程序。
在 ./src/commands 文件夹中，打开 commands.html。
在现有 脚本 标记下面添加以下代码。
<script type="text/javascript" src="../launchevent/launchevent.js"></script>
保存所做的更改。
从项目的根目录中，打开 webpack.config.js 文件。
plugins在 对象中找到数组，config并将以下新对象添加到数组的开头。
new CopyWebpackPlugin({
patterns: [
{
from: "./src/launchevent/launchevent.js",
to: "launchevent.js",
},
],
}),
保存所做的更改。
在项目的根目录中运行以下命令。 运行 npm start时，如果本地 Web 服务器尚未运行) 并且加载项将被旁加载，则本地 Web 服务器将启动 (。
npm run build
npm start
备注
如果加载项未自动旁加载，请按照 旁加载 Outlook 外接程序 中的说明进行测试，在 Outlook 中手动旁加载加载项。
在首选 Outlook 客户端中，创建新邮件。 如果未配置默认 Outlook 签名，外接程序会将一个添加到新创建的邮件。 在移动设备上的 Outlook 中，即使配置了默认签名，加载项也会添加示例签名。
启用“ 发件人 ”字段（如果适用）。 有关如何启用它的指南，请参阅 更改用于发送电子邮件的帐户的“为什么缺少发件人按钮？”部分。
选择“ 发件人”，然后选择其他 Exchange 帐户。 或者，通过选择“从>其他Email地址”手动输入 Exchange 电子邮件地址。 已更新的签名将添加到消息中，替换上一个签名。
如果要停止本地 Web 服务器并卸载加载项，请按照适用的说明作：
若要停止服务器，请运行以下命令。 如果使用 npm start了 ，则以下命令还应卸载加载项。
npm stop
如果手动旁加载加载项，请参阅 删除旁加载加载项。
有关如何排查基于事件的激活加载项的指南，请参阅 基于事件的加载项和垃圾邮件报告加载项疑难解答。
与其他基于事件的外接程序类似，使用 OnMessageFromChanged 和 OnAppointmentFromChanged 事件的加载项必须由组织的管理员部署。 有关如何通过Microsoft 365 管理中心部署外接程序的指南，请参阅配置 Outlook 外接程序进行基于事件的激活的“部署到用户”部分。
OnMessageFromChanged由于 和 OnAppointmentFromChanged 事件通过基于事件的激活功能受支持，因此相同的行为和限制适用于因此事件而激活的加载项。 有关详细说明，请参阅 基于事件的激活行为和限制。
除了这些特征之外，当加载项在这些事件上激活时，以下方面也适用。
OnMessageFromChanged 仅在邮件撰写模式下受支持，而 OnAppointmentFromChanged 事件仅在约会撰写模式下受支持。OnMessageFromChanged支持事件。OnMessageFromChanged和 OnAppointmentFromChanged 事件仅支持 Exchange 帐户。 如果用户切换到“ 发件人 ”或“组织者”字段中的非 Exchange 帐户，Outlook 客户端会自动清除以前所选帐户设置的签名。OnMessageFromChanged 和 OnAppointmentFromChanged 事件支持委托和共享邮箱方案。 移动设备上的 Outlook 不支持这些方案。OnAppointmentFromChanged
Microsoft 365 组日历不支持该事件。 如果用户从其 Exchange 帐户切换到组织者字段中的 Microsoft 365 组日历帐户，Outlook 客户端会自动清除 Exchange 帐户设置的签名。OnAppointmentFromChanged 事件之前OnMessageFromChanged加载。OnMessageFromChanged将发生 或 OnAppointmentFromChanged 事件，而无需重新加载帐户的加载项。Email移动设备上的 Outlook 不支持帐户别名。OnMessageFromChanged 将发生 或 OnAppointmentFromChanged 事件，但不会终止或重新加载帐户的加载项。培训
学习路径
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
认证
Microsoft Office Specialist: Outlook Associate (Office 2019) - Certifications
通过取得 Microsoft Office Specialist (MOS) 认证，证明你具备充分利用 Outlook 2019 所需的技能。
文档
在 Outlook 外接程序中实现共享文件夹和共享邮箱方案 - Office Add-ins
讨论如何配置 Outlook 外接程序对共享文件夹的支持， (也称为委托访问) 和共享邮箱。
Outlook 加载项的 Onsend 功能 - Office Add-ins
提供了一种处理项目或阻止用户进行特定操作的方法，并允许加载项在发送时设置某些属性。
发送时将内容预置或追加到邮件或约会正文 - Office Add-ins
了解如何在发送邮件项目时将内容追加或追加到邮件或约会正文中。