如何通过Word Web Add-ins任务窗格在新实例中打开下载的文档副本

可行方案概述 #

你可以通过浏览器新窗口打开文档URL结合Office.js的文档操作API实现需求，核心是先确保下载的文档副本有可访问的地址，再从当前任务窗格触发新Word实例的加载。

具体实现步骤 #

1. 获取文档的可访问URL
   • 如果下载的是Blob对象，用URL.createObjectURL()生成临时可访问URL；如果是从服务器直接获取的文档地址，直接使用该公开URL即可。
2. 从任务窗格触发新实例打开
   • 用浏览器的window.open()方法打开文档URL，Word Web会自动在新实例中加载该文档；也可以使用Office.js提供的Word.open()方法实现更集成的打开逻辑。
3. 配置Add-in清单（可选）
   • 如果希望新打开的文档自动加载你的任务窗格，需要在Add-in清单中设置：
     • 将Hosts指定为Word
     • 在WebFormFactor的ExtensionPoint中配置Document类型，确保Add-in能在所有Word文档实例中加载（或指定匹配文档URL的规则）

代码示例 #

// 假设已完成文档下载，得到documentBlob（Blob类型）
const documentBlob = await downloadDocumentFromServer(); // 你的下载逻辑

// 生成Blob的临时访问URL
const docAccessUrl = URL.createObjectURL(documentBlob);

// 方式1：用window.open打开新Word实例
window.open(docAccessUrl, '_blank');

// 方式2：用Office.js的Word.open方法（更贴合Office生态）
try {
  await Word.open(docAccessUrl);
  console.log('新文档已在Word Web实例中打开');
} catch (error) {
  console.error('打开文档失败:', error);
}

关键注意事项 #

• URL可靠性：临时Blob URL仅在当前浏览器会话有效，若需要长期访问，建议将文档上传到服务器获取公开URL；同时确保服务器配置了正确的CORS策略，避免跨域问题。
• 权限与清单：Add-in清单需正确配置权限范围（如ReadWriteDocument），若要自动加载任务窗格，需确保清单中的ExtensionPoint规则覆盖新打开的文档。
• 兼容性：Word.open()方法仅支持较新版本的Office.js，若需兼容旧环境，优先使用window.open()方案。

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