在JS Add-In中获取Office 365 Word文档的浏览器打开URL

网页版Office 365 Word解决方案 #

• 你提到的Office.context.document.url和getFilePropertiesAsync确实只会返回文件下载链接，要获取浏览器可直接打开的协作式URL，需使用Office.context.document.getShareLinkAsync API：
  • 调用时指定Office.ShareLinkViewType.view类型，就能生成你需要的格式（类似https://<mycompany>-my.sharepoint.com/:w:/r/...）。
  • 示例代码：

    Office.context.document.getShareLinkAsync(
      Office.ShareLinkViewType.view,
      {restrictToMembers: true}, // 可根据需求调整权限范围
      function(result) {
        if (result.status === Office.AsyncResultStatus.Succeeded) {
          const browserAccessibleUrl = result.value.url;
          // 在此处理获取到的目标URL
        } else {
          // 处理调用失败的情况
        }
      }
    );
    

  • 注意：该API仅支持存储在OneDrive/SharePoint云端的文档，本地离线文档无法调用。

桌面版MS Word的表现 #

• 桌面版Word中，Office.context.document.url返回的是本地文件的绝对路径（如C:\Users\XXX\Documents\Document1.docx），而非网页链接。
• 如果文档是从OneDrive/SharePoint同步到本地的，可通过两种方式获取网页打开链接：
  • 手动操作：点击顶部「文件」选项卡 → 选择「信息」 → 点击「复制链接」按钮，即可得到和网页版格式一致的浏览器打开URL。
  • API调用：同样使用getShareLinkAsync API，返回的是云端文档的网页访问链接，和网页版调用效果一致。

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