如何开发兼容Outlook桌面与OWA、一键转发邮件为附件到指定地址的Web插件

一、基础实现思路 #

你要开发的是基于Office JS API的Outlook Web Add-In，天然兼容Windows/Mac桌面端Outlook、网页版OWA，完全覆盖你的需求场景，核心逻辑和你现有VBA逻辑完全对应：

• 配置插件清单文件定义Ribbon入口按钮
• 用JS调用Office JS官方API实现邮件获取、组装、自动发送逻辑
• 无需用户手动输入任何内容，点击按钮即完成上报

二、第一步：配置插件清单（manifest.xml） #

清单文件是Outlook加载插件的配置文件，核心要配置2项：

1. 权限等级设为ReadWriteMailbox，满足发送邮件、读取邮件内容的权限要求
2. 配置Ribbon按钮扩展点，分别支持「邮件列表选中邮件后显示」和「打开邮件阅读时显示」两种场景，按钮点击触发自定义的reportPhishing函数

三、第二步：核心JS代码实现 #

核心逻辑对应你现有VBA的功能，代码示例如下：

// Office初始化完成后执行
Office.onReady(() => {
  // 注册按钮触发事件
});

// 上报按钮点击触发的核心函数
async function reportPhishing() {
  const mailbox = Office.context.mailbox;
  // 获取选中的邮件列表，支持多选
  mailbox.getSelectedItemsAsync(async (result) => {
    if (result.status !== Office.AsyncResultStatus.Succeeded) {
      showNotification("错误", "未选中任何邮件");
      return;
    }
    const targetMail = "security.team@gmail.com";
    for (let item of result.value) {
      // 组装上报邮件参数
      const reportMail = {
        toRecipients: [targetMail],
        subject: "Suspicious Email",
        body: "Please check whether it is a phishing email.",
        // 将原邮件作为EML格式附件添加
        attachments: [
          {
            type: Office.MailboxEnums.AttachmentType.Eml,
            name: `${item.subject || 'suspicious_mail'}.eml`,
            itemId: item.itemId
          }
        ]
      };
      // 自动发送：如果需要完全静默不弹出编辑窗口，可替换为调用Graph API后台发送
      mailbox.displayNewMessageForm(reportMail, (formResult) => {
        if (formResult.status === Office.AsyncResultStatus.Succeeded) {
          formResult.value.sendAsync(() => {
            showNotification("成功", "可疑邮件上报完成");
          });
        }
      });
    }
  });
}

// 弹出操作提示
function showNotification(title, message) {
  Office.context.mailbox.item.notificationMessages.addAsync("reportNotice", {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: message,
    icon: "Icon.80x80",
    persistent: false
  });
}

四、兼容说明 #

• 要求用户Outlook版本支持Office JS API 1.8及以上，2019及以后版本的桌面端Outlook、所有主流OWA版本都已原生兼容
• 插件打包完成后可通过企业管理员统一部署到组织内所有用户的Outlook中，无需用户手动安装配置

内容的提问来源于stack exchange，提问作者John Aman