Outlook外接程序roamingSettings使用及跨平台数据同步问题咨询

saveAsync方法的正确用法 #

Office.context.roamingSettings的读写逻辑分为内存修改和持久化提交两个阶段：

• 调用Office.context.roamingSettings.set("keyVal", value)时，仅修改当前会话内存中的临时设置副本，这就是你之前遇到的仅当前会话生效的原因。
• saveAsync方法设计上不需要传入配置参数，它会自动将当前内存中所有未提交的设置改动一次性持久化到云端，你当前写的saveAsync调用代码是完全符合规范的。

使用时的注意事项：

• 建议批量完成所有设置的新增、修改、删除操作后，统一调用一次saveAsync，避免短时间内频繁提交引发的冲突报错
• 回调中做好错误处理，遇到网络异常、权限不足等保存失败场景时，可根据错误信息做重试或用户提示

roamingSettings的跨端同步能力 #

roamingSettings本身就是为用户级漫游配置设计的存储接口，只要用户在OWA、桌面端Outlook、移动端Outlook登录的是同一个微软365账号，存储的配置会自动跨全平台同步。使用时需注意以下限制：

• 单个外接程序的roamingSettings存储总容量上限为100KB，超出上限会触发保存失败
• 跨端同步存在一定延迟，部分场景下可能需要等待数分钟才能在其他端获取到最新的配置值
• 仅支持存储可JSON序列化的数据类型，无法存储函数、循环引用等不可序列化的内容

内容的提问来源于stack exchange，提问作者Rogério Ferreira de Melo