Outlook 插件中实现邮件发送前强制分类的完整指南

本文详解如何通过 outlook javascript api 的 `onmessagesend` 事件，在用户点击“发送”按钮时拦截邮件、弹出分类面板并强制完成邮件安全分级，确保合规性要求落地。

在开发企业级 outlook 邮件分类插件（如 Confidential/internal/public 分级）时，仅依赖 ui 按钮（如 ClassifyEmail）无法真正保障合规——用户可跳过分类直接发送。真正的强制校验必须绑定到发送生命周期本身。microsoft 提供的 OnMessageSend 事件正是为此设计：它在 Outlook 客户端调用原生“发送”动作前触发，支持异步阻断、UI 弹窗与业务逻辑验证，是实现“发送前强管控”的唯一可靠方案。

✅ 正确实现路径：三步到位

1. 清单文件（manifest.xml）配置事件型权限

需启用 EventedTaskPane 权限，并声明 OnMessageSend 事件扩展点（注意：仅支持 Exchange Online / Outlook on windows/macos 最新版，不支持 Outlook on the web 的旧版渲染器）：

ReadWriteItem                                                                                                                                      

⚠️ 注意：FunctionExecution=”synchronous” 表示该函数必须在发送前完成执行并明确返回 true（允许发送）或 false（阻止发送），否则 Outlook 将报错中断。

2. 编写事件处理函数（functions.html）

该页面不渲染 UI，仅承载 js 逻辑。使用 Office.onReady 初始化后注册事件处理器：

3. 任务窗格（taskpane.html）提供交互式分类 UI

复用你原有 HTML 结构，但需增强健壮性（如防重复提交、状态反馈）：

   
NMI 邮件安全分类
   
     请选择安全级别：            — 请选择 —       机密（Confidential）       内部（Internal）       公开（Public）        
   应用分类并关闭 
  

? 关键注意事项总结

• 清单版本必须 ≥ 1.11：OnMessageSend 事件仅在 VersionOverridesV1_1 及以上支持；
• 仅限同步执行：event.completed({ allowEvent: true/false }) 必须在函数内调用，且不可异步延迟（不能 await 后再调）；
• 任务窗格需预注册：确保 taskpane.html 在 manifest 中通过 或 正确声明；
• 兼容性检查：使用 Office.context.requirements.isSetSupported(‘MailBox’, ‘1.13’) 判断运行环境是否支持；
• 用户体验优化：建议在任务窗格中缓存用户上次选择，避免重复操作；同时对已分类邮件禁用按钮或灰显提示。

通过以上结构化实现，你将构建出真正符合企业安全策略的 Outlook 分类插件——不是“建议分类”，而是“不分类就不能发”。这既是技术最佳实践，也是数据治理落地的关键一环。