导入导出

下方 API 需要配套的转换后端。请先按导入导出集成接好文件上传、转换、任务查询和下载,再配置前端插件。快照 API 也需要转换后端,但不要求创建协同文档。官方协同 Exchange 示例演示 Sheets,接入前请确认目标版本支持所需的文件类型。

插件信息

支持的格式

下表列出本页前端 API 支持的格式。Office 文件转换还需要后端支持对应的文档类型和格式。

导入导出
.pdf.pdf

这些 API 导入、导出的都是 PDF 文件,不提供将 PDF 内容转为 DOCX、XLSX 或 PPTX 的功能。浏览器打印是独立流程。

选择数据路径

路径是否持久化服务器单元是否需要协作转换服务器
单元 ID必需
快照必需

导入为持久化单元

输入可以是浏览器 File 或 URL。通过已配置的协作客户端加载返回的单元:

TypeScript
const unitId = await univerAPI.importPdfToUnitIdAsync(file)if (unitId) {  const pdf = await univerAPI.getCollaboration().loadPdfAsync(unitId)  console.log(pdf?.getName())}

导入为快照

对于不应作为转换任务一部分持久化的本地 PDF 单元,请使用快照导入:

TypeScript
const snapshot = await univerAPI.importPdfToSnapshotAsync(file)if (snapshot) {  univerAPI.createPdf(snapshot)}

导出和下载

按 ID 导出持久化单元:

TypeScript
const file = await univerAPI.exportPdfByUnitIdAsync(unitId)if (file) {  univerAPI.downloadFile(file, 'project-brief', 'pdf')}

无需先持久化即可导出当前本地快照:

TypeScript
const pdf = univerAPI.getActivePdf()if (pdf) {  const file = await univerAPI.exportPdfBySnapshotAsync(pdf.save())  if (file) {    univerAPI.downloadFile(file, pdf.getName(), 'pdf')  }}

这些 API 返回 File。浏览器打印是独立的工作流,会打开系统打印对话框;请参阅打印

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.