Office.js Word API问题：通过ExecuteFunction无法更新文档属性域

核心问题分析 #

控制台执行updateAllFields正常，但功能区按钮调用时无报错却失效，核心原因有两点：

• 异步时序错误：event.completed()调用过早，在Word上下文操作未完全完成前就终止了加载项执行上下文
• 属性更新未纳入Word上下文：若getFileProperties中更新自定义属性的操作不在Word请求上下文内，会导致属性与域更新不同步

修正后的代码 #

更新域主函数 #

async function updateAllFields(event) {
  try {
    await Word.run(async (context) => {
      // 1. 在Word上下文内获取并更新自定义属性
      await getFileProperties(context);

      // 2. 批量加载所有字段，减少同步次数
      const fields = context.document.body.fields;
      fields.load("items");
      await context.sync();

      // 3. 只更新DocProperty类型的字段
      for (const field of fields.items) {
        if (field.type === Word.FieldType.docProperty) {
          field.updateResult();
        }
      }
      await context.sync();
    });
  } catch (error) {
    console.error("更新域失败:", error);
  } finally {
    // 确保所有操作完成后再标记事件结束
    event.completed();
  }
}

修正属性获取函数（必须传入Word上下文） #

async function getFileProperties(context) {
  // 调用API获取最新属性
  const apiResponse = await fetch("你的API地址");
  const latestProps = await apiResponse.json();

  // 在Word上下文内更新文档自定义属性
  const customProps = context.document.properties.customProperties;
  for (const key in latestProps) {
    customProps.add(key, latestProps[key]);
  }
  await context.sync();
}

额外检查项 #

• 确认SharedRuntime已正确配置在manifest中：

  <Runtimes>
    <Runtime resid="WebViewRuntime" lifetime="long" />
  </Runtimes>
  

• 确保updateAllFields是全局作用域函数，可被功能区按钮正常调用
• 权限ReadWriteDocument配置无误，无需额外调整

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