如何将Office Add-in（office.js）生成的Excel报告导出为PDF或保存至OneDrive/SharePoint？

直接通过内置API导出PDF #

• 无需依赖第三方组件，可直接调用Office.js原生提供的Workbook.saveAsAsync方法完成PDF导出，这是目前官方支持的最稳定实现路径
• 核心调用逻辑：获取当前Excel工作簿的上下文对象后，传入PDF格式对应的枚举值Office.SaveAsFileType.pdf，即可指定导出文件格式，同时支持自定义导出的文件名称
• 跨端适配特性：桌面端、Mac端经典Excel客户端调用时，会自动触发系统原生的PDF保存交互流程；Web端Excel环境下调用时，会自动唤起浏览器内置的PDF预览页，用户可直接通过浏览器保存导出的PDF文件
• 排版适配优化：导出前可通过内置API配置打印参数（纸张大小、边距、缩放比例、打印区域），避免导出的PDF出现内容错位、裁切问题
• 基础调用示例代码：

Excel.run(async (context) => {
  const currentWorkbook = context.workbook;
  // 触发PDF格式保存流程
  currentWorkbook.saveAsAsync(
    "业务报告_2024",
    Office.SaveAsFileType.pdf
  );
  await context.sync();
});

将文件写入OneDrive/SharePoint的实现方式 #

• 场景1：当前工作簿本身存储在OneDrive/SharePoint路径下
  • 所有对工作簿的编辑操作，只要通过context.sync完成同步提交，就会自动回写到原文件所在的云存储路径，无需额外开发文件写入逻辑
  • 如需生成独立的报告副本写入指定云盘目录，可先通过工作簿复制接口生成临时副本，再调用saveAsAsync方法传入云盘的目标相对路径，即可完成副本的写入存储
• 场景2：需要主动将生成的Excel/PDF报告推送到指定的OneDrive/SharePoint文件夹
  • 先通过saveAsAsync获取目标文件的Base64二进制内容
  • 借助Office Add-in内置的SSO单点登录能力，获取当前登录用户对目标云盘目录的访问权限令牌
  • 调用文件上传接口将获取到的二进制内容写入指定云盘路径，该实现可同时适配桌面端、Web端的Excel运行环境

落地注意事项 #

• 调用文件保存、写入相关API前，需确保Add-in已申请ReadWriteDocument权限范围，否则会触发权限校验失败
• 针对页数较多、体积较大的报告文件，导出前需增加加载态提示，避免用户无感知等待
• 需通过Office.context.requirements.isSetSupported做API能力检测，对不兼容目标API的旧版本客户端，给出手动导出的降级引导

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