Outlook JS插件开发求助：实现邮件转发及跨组件数据传递

核心方案：正确使用Roaming Settings跨运行时共享数据 #

你之前尝试Roaming Settings失败的核心原因是缺少saveAsync()调用——这是将设置持久化、让其他运行时能读取的必要步骤。Roaming Settings是Outlook插件官方支持的跨运行时（任务窗格、撰写窗口等）共享存储方案，完全不需要依赖Graph API。

具体实现代码 #

1. 任务窗格中保存目标邮箱地址并打开回复窗口

当用户点击邮箱地址列表项时，先将地址存入Roaming Settings并完成持久化，再打开回复窗口：

// 任务窗格内的地址点击处理函数
async function onRecipientClick(targetEmail) {
  const roamingSettings = Office.context.roamingSettings;
  // 存储目标转发地址
  roamingSettings.set('forwardTarget', targetEmail);
  
  // 必须调用saveAsync完成持久化，否则其他运行时无法读取
  await new Promise((resolve, reject) => {
    roamingSettings.saveAsync(result => {
      result.status === Office.AsyncResultStatus.Succeeded ? resolve() : reject(result.error);
    });
  });
  
  // 打开回复窗口
  Office.context.mailbox.item?.displayReplyAllFormAsync();
}

2. 在撰写事件处理函数中读取地址并设置收件人

注册onNewMessageCompose事件，读取Roaming Settings中的地址并自动填充到收件人栏，完成后清除存储的地址避免重复触发：

// 新邮件撰写事件处理函数
function onNewMessageComposeHandler(event) {
  const roamingSettings = Office.context.roamingSettings;
  const targetAddress = roamingSettings.get('forwardTarget');
  
  if (targetAddress) {
    // 向收件人栏添加目标地址
    Office.context.mailbox.item.to.addAsync([targetAddress], result => {
      if (result.status === Office.AsyncResultStatus.Succeeded) {
        // 清除已使用的地址，防止后续撰写窗口自动填充
        roamingSettings.remove('forwardTarget');
        roamingSettings.saveAsync();
        event.completed();
      } else {
        console.error('添加收件人失败:', result.error);
        event.completed({ error: result.error.message });
      }
    });
  } else {
    event.completed();
  }
}

// 关联事件处理函数
Office.actions.associate('onNewMessageCompose', onNewMessageComposeHandler);

关键说明 #

• 为什么不用localStorage？：Outlook插件的任务窗格和新邮件撰写窗口属于独立的运行上下文，localStorage无法跨上下文共享数据，而Roaming Settings是插件级别的共享存储。
• 清除存储的必要性：每次完成收件人设置后清除地址，避免用户下次打开新邮件撰写窗口时自动填充错误的地址。
• 无需Graph API：整个流程仅使用Office JS原生API即可实现，完全符合你的需求。

内容的提问来源于stack exchange，提问作者David H.