Outlook保存会议前如何获取保存后不变的唯一MeetingId

核心逻辑围绕「稳定获取会议唯一标识→绑定存储→打开会议时匹配加载→更新订单」链路实现，具体落地步骤如下：

1. 获取可持久化的会议唯一ID #

这是整个绑定逻辑的核心，踩坑率最高：

• 禁止在新建会议草稿阶段取ID做绑定：未保存/未发送的会议草稿返回的是临时ID，用户点击保存、发送后临时ID会直接失效，后续完全无法匹配。
• 正确触发时机：在插件初始化时，通过addHandlerAsync注册Office.EventType.ItemSaved事件，只有当会议首次被保存到用户日历（即成为已排期会议）后，再调用Office.context.mailbox.item.getItemIdAsync获取正式固定的itemId，这个ID就是可以存入数据库和订单绑定的MeetingId。
• 跨平台兼容处理：如果你的服务端需要调用Microsoft Graph接口校验会议信息，需要调用Office.context.mailbox.convertToRestId()将获取到的EWS格式ID转换为REST兼容格式，避免不同客户端返回ID格式不一致导致匹配失败。
• 容错兜底：可以同时存储会议组织者邮箱、会议创建时间、定期会议seriesId三个辅助字段，极端场景下（如会议被移动到其他日历文件夹导致ID变动）可以通过辅助字段二次匹配。

2. 订单与会议绑定存储流程 #

• 除了监听ItemSaved事件，还可以在插件清单中配置ItemSend事件支持，用户点击发送会议邀请时也触发绑定逻辑，避免漏单。
• 拿到正式MeetingId后，再将餐饮订单详情和ID关联提交到业务数据库存储，草稿阶段只在本地缓存未提交的订单内容即可，不要提前写入服务端产生脏数据。
• 建议做双层绑定：拿到订单ID后，通过Outlook自定义属性接口将订单ID写入当前会议项本身，就算后续MeetingId匹配异常，也能直接从会议属性中拿到关联的订单号，示例代码：

// 向会议项写入关联订单号
Office.context.mailbox.item.loadCustomPropertiesAsync((res) => {
  if (res.status === Office.AsyncResultStatus.Succeeded) {
    const customProps = res.value;
    customProps.set("relatedCateringOrderId", "你的业务订单唯一编号");
    customProps.saveAsync();
  }
});

3. 打开已排期会议时的订单更新逻辑 #

• 插件加载时首先校验当前打开项类型：判断Office.context.mailbox.item.itemType是否为Appointment类型，同时调用getItemIdAsync检查是否返回非空ID，确认是已排期的存量会议后再启动订单加载逻辑。
• 匹配优先级：优先读取当前会议自定义属性中存储的relatedCateringOrderId，拿到ID后直接从数据库拉取订单详情；如果自定义属性为空，再用当前会议的itemId去数据库查询关联订单。
• 用户在插件内修改餐饮订单内容后，直接根据订单ID更新业务数据库中对应的订单记录即可，不需要修改会议和订单的绑定关系，只要会议没有被彻底删除或复制为新会议，绑定关系一直有效。
• 定期会议特殊处理：如果用户打开的是定期会议的单个例外实例，获取到的是单实例ID，仅绑定当前这一次会议的订单；如果打开的是定期会议的主系列项，获取到的是系列主ID，绑定整个系列的订单即可，两种场景不要混淆。

关键注意事项 #

• 不要用会议主题、会议时间、参会人列表作为匹配依据，这些信息用户可以随时修改，会直接导致匹配失效。
• 插件清单需要配置ReadWriteMailbox权限，否则无法正常读取itemId、读写自定义属性。
• 服务端可以增加一层校验：拿到MeetingId调用Graph接口查询会议是否存在，确认存在后再返回订单数据，拦截无效ID的异常请求。

内容的提问来源于stack exchange，提问作者Vikas Rajput