导入导出
下方 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。浏览器打印是独立的工作流,会打开系统打印对话框;请参阅打印。
你觉得这篇文档如何?