インポートとエクスポート
以下のブラウザー API を使用する前にインポート・エクスポート統合を完了してください。アップロード、変換、タスク照会、認可されたダウンロードの契約をアプリ側で実装します。スナップショット API にも変換バックエンドが必要です。Exchange サンプルは Sheets を対象とするため、他の製品や形式の対応状況は個別に確認してください。
エクスポート失敗時はライセンスエラーとタスク失敗の処理を参照してください。
対応形式
以下は本ページのブラウザー API が対応する形式です。Office ファイルの変換には、同じドキュメント種類と形式に対応したバックエンドが必要です。
| インポート | エクスポート |
|---|---|
.pdf | .pdf |
データ経路を選択する
| 経路 | サーバーユニットを永続化 | 共同編集が必要 | 変換サーバー |
|---|---|---|---|
| ユニット ID | はい | はい | 必須 |
| スナップショット | いいえ | いいえ | 必須 |
永続ユニットとしてインポートする
入力にはブラウザーの File または URL を使用できます。返されたユニットは、構成済みの共同編集クライアントを通じて読み込みます。
const unitId = await univerAPI.importPdfToUnitIdAsync(file)if (unitId) { const pdf = await univerAPI.getCollaboration().loadPdfAsync(unitId) console.log(pdf?.getName())}スナップショットとしてインポートする
変換タスクの一部として永続化しないローカル PDF ユニットには、スナップショットのインポートを使用します。
const snapshot = await univerAPI.importPdfToSnapshotAsync(file)if (snapshot) { univerAPI.createPdf(snapshot)}エクスポートしてダウンロードする
永続化されたユニットを ID でエクスポートします。
const file = await univerAPI.exportPdfByUnitIdAsync(unitId)if (file) { univerAPI.downloadFile(file, 'project-brief', 'pdf')}現在のローカルスナップショットは、先に永続化せずにエクスポートできます。
const pdf = univerAPI.getActivePdf()if (pdf) { const file = await univerAPI.exportPdfBySnapshotAsync(pdf.save()) if (file) { univerAPI.downloadFile(file, pdf.getName(), 'pdf') }}これらの API は File を返します。ブラウザー印刷はシステムの印刷ダイアログを開く別のワークフローです。印刷を参照してください。
組み込みのインポート・エクスポートメニューと UI 操作の削除
注意
1.2.0 以降、Univer の組み込みインポート・エクスポートメニューと UI 操作は削除されました。基盤となるサービスと Facade API は引き続き利用できます。
既存のインポート・エクスポートメニューと UI 操作が必要な場合は、組み込みインポート・エクスポートメニューと UI 操作の移行例を参考に、カスタムプラグインで移行できます。サンプルの完全なソースコードは、オンラインで閲覧・ダウンロードできます。
このガイドはいかがですか？