如何通过Office JS在当前Word文档中打开数据库存储的DOCX文件？

我正在开发一款基于Office JS的Word任务窗格插件（Web应用），核心目标是替换数据库中存储文档的预定义内容控件。该插件需根据用户输入获取文件并在当前文档中打开。

最初我按照Office文档给出的方案实现：

fetch(`/arquivo?id=${idModeloDocumento}`)
     .then(response => response.text())
     .then(base64String => {

         Word.run(async context => {
             const app = context.application; 
             const doc = app.createDocument(base64String); // base64string comes from my backend app
             doc.open();
             await context.sync();
         });
     })

但此方案会在新的Word实例中打开文档，而非插件所在的当前Word实例。于是我调整方案：创建文档后提取其正文和页眉的OOXML，再插入到当前文档中替换对应内容，代码如下：

fetch(`/arquivo?id=${idModeloDocumento}`)
     .then(response => response.text())
     .then(base64String => {

        Word.run(async context => {
             var base64doc = base64String
             const app = context.application
             const doc = app.createDocument(base64doc)
             await context.sync()
             console.log("Novo documento criado")

             let bodyOoxml = doc.body.getOoxml()
             let headerOoxml = doc.sections.getFirst().getHeader(Word.HeaderFooterType.primary).getOoxml()

             await context.sync()
             console.log("Preenchendo o body do documento corrente")

             let curHeader = context.document.sections.getFirst().getHeader(Word.HeaderFooterType.primary)
             curHeader.insertOoxml(headerOoxml.value, Word.InsertLocation.replace)

             let curBody = context.document.body
             curBody.insertOoxml(bodyOoxml.value, Word.InsertLocation.replace)

             await context.sync()
             console.log("Pronto")
         });                        
            
     })

该方案可正常运行，但我不确定这是否为最佳实现方式。请问使用Office JS在当前Word文档中打开DOCX文件的推荐方案是什么？

你的OOXML替换思路是符合Office JS当前能力的可行方案，也是该场景下的推荐实现方式，以下是针对性的优化建议和拓展方向：

1. 简化OOXML提取流程（减少临时文档开销） #

当前方案先创建临时文档再提取OOXML，可优化为直接从后端获取二进制数据转换为OOXML，省去临时文档创建步骤，提升执行效率：

fetch(`/arquivo?id=${idModeloDocumento}`)
  .then(response => response.arrayBuffer())
  .then(async buffer => {
    // 将DOCX二进制数据转换为Base64编码的OOXML
    const ooxmlBase64 = btoa(String.fromCharCode(...new Uint8Array(buffer)));
    
    await Word.run(async context => {
      // 替换当前文档正文
      const currentBody = context.document.body;
      currentBody.insertOoxml(ooxmlBase64, Word.InsertLocation.replace);
      
      // 处理页眉（若需完整迁移，仍需临时文档提取独立页眉OOXML）
      const firstSection = context.document.sections.getFirst();
      const primaryHeader = firstSection.getHeader(Word.HeaderFooterType.primary);
      
      await context.sync();
    });
  });

2. 覆盖更多文档元素（保证完整性） #

如果目标文档包含页脚、样式、内容控件绑定数据等，需补充对应处理逻辑：

• 页脚：参考页眉处理逻辑，使用getFooter(Word.HeaderFooterType.primary)获取并替换
• 样式：临时文档创建后，通过doc.getStyles()提取样式集合，逐一复制到当前文档
• 内容控件关联数据：通过doc.customXmlParts获取原文档的自定义XML部件，复制到当前文档以保留内容控件绑定关系

3. 性能与稳定性优化 #

• 减少同步次数：合并不必要的context.sync()调用，一次同步获取所有需要的OOXML数据，再执行插入操作，减少Office客户端与插件的通信开销：

await Word.run(async context => {
  const doc = app.createDocument(base64doc);
  // 一次性获取所有需要的OOXML对象
  const bodyOoxml = doc.body.getOoxml();
  const headerOoxml = doc.sections.getFirst().getHeader(Word.HeaderFooterType.primary).getOoxml();
  
  // 单次同步获取所有数据
  await context.sync();
  
  // 执行替换操作
  const curHeader = context.document.sections.getFirst().getHeader(Word.HeaderFooterType.primary);
  curHeader.insertOoxml(headerOoxml.value, Word.InsertLocation.replace);
  
  const curBody = context.document.body;
  curBody.insertOoxml(bodyOoxml.value, Word.InsertLocation.replace);
  
  await context.sync();
});

• 增加错误捕获：在Word.run中加入try/catch块，处理Office操作异常，避免插件崩溃：

await Word.run(async context => {
  try {
    // 业务逻辑代码
  } catch (error) {
    console.error("文档操作失败:", error);
    // 提示用户处理异常
  }
});

总结 #

Office JS目前没有直接在现有文档中"打开"另一个DOCX的原生API，通过OOXML提取与替换是官方认可的标准实现方式。如果你的场景仅需替换正文和主页眉，当前方案已满足需求；若需完整迁移文档的所有元素，建议补充页脚、样式、自定义部件等的处理逻辑，并通过减少同步次数提升性能。

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