Excelブックから複雑な3DチャートをポータブルなPDFファイルに変換することは、レポート作成や視覚データの共有で頻繁に求められます。Aspose.Cells Cloud SDK for Javaは、Java開発者向けにこの作業を簡素化する強力なクラウドベースのライブラリを提供します。このガイドでは、環境の準備から最終ドキュメントの取得まで、Javaでの3DからPDFへの変換プロセス全体を順を追って説明します。詳細なコード解説、完全なサンプル、そしてREST API統合のための同等のcURLコマンドをご覧いただけます。
Aspose.Cells Cloud SDK for Java の設定
開始する前に、以下が揃っていることを確認してください。
- Java 17 以上がインストールされていること。
- 依存関係管理のための Maven または Gradle。
- Client Id と Client Secret を持つ Aspose Cloud アカウント。
- クラウド呼び出しのためにインターネットにアクセスできること。
以下に示すMaven依存関係を使用してSDKをプロジェクトに追加し、公式ダウンロードページから最新のJARをダウンロードしてください。
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cells-cloud</artifactId>
<version>26.7</version>
</dependency>
ライブラリは、ダウンロード URL から直接取得することもできます。
クライアントをあなたの資格情報で構成します。このスニペットは完全な例から直接取得したものです。
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
設定が完了したので、変換ワークフローを開始する準備ができました。
Javaでの3DからPDFへの変換 - ステップバイステップのウォークスルー
ステップ 1: Excel ワークブックをクラウド ストレージにアップロード
まず、3Dチャートを含むXLSXファイルをアップロードします。FilesApiがアップロードを処理します。
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
ステップ 2: PDF 保存オプションの準備
フォントキャッシュ、画像圧縮、メモリ最適化を有効にして PDF 出力を微調整します。これらのオプションは、3D ビジュアル品質を維持しながら PDF のサイズを小さく保つのに役立ちます。
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);
ステップ 3: ワークブックを PDF に変換
postWorkbookSaveAs メソッドを CellsApi で呼び出して変換を実行します。このメソッドの API リファレンスは Aspose.Cells API リファレンス にあります。
WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
remoteInputName, // source workbook name
"pdf", // target format
remoteOutputName, // output path in cloud storage
pdfOptions, // save options
"", // folder (root)
null); // storage (default)
ステップ 4: 結果の PDF をダウンロード
変換が成功したら、PDF バイトをダウンロードし、ローカル ファイルに書き込みます。
byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
ステップ 5: 任意のクリーンアップ
クラウドストレージから一時ファイルを削除して、アカウントを整理整頓しましょう。
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
3D から PDF への変換の完全な Java 実装 - 完全コード例
次の例は、Aspose.Cells Cloud SDK for Java を使用して、3D Excel ワークブックを PDF にエンドツーエンドで変換する方法を示しています。
import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.api.FilesApi;
import com.aspose.cloud.cells.client.ApiException;
import com.aspose.cloud.cells.client.Configuration;
import com.aspose.cloud.cells.model.PdfSaveOptions;
import com.aspose.cloud.cells.model.FilesUploadResult;
import com.aspose.cloud.cells.model.WorkbookResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
public class AsposeCells3DToPdfExample {
public static void main(String[] args) {
// -------------------- Configuration --------------------
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
// -------------------- API Instances --------------------
CellsApi cellsApi = new CellsApi(config);
FilesApi filesApi = new FilesApi(config);
// -------------------- Local & Remote Paths --------------------
String localInputPath = "input.xlsx"; // Excel file containing 3D charts
String remoteInputName = "input.xlsx"; // Name used in cloud storage
String remoteOutputName = "output.pdf"; // Desired PDF name in cloud storage
String localOutputPath = "output.pdf"; // Where to save the downloaded PDF
try {
// -------------------- Upload Excel to Cloud --------------------
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
// -------------------- Prepare PDF Save Options (Performance) --------------------
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true); // Cache fonts for faster processing
pdfOptions.setCompressImages(true); // Compress images to reduce size
pdfOptions.setImageQuality(80); // Balance quality and size
pdfOptions.setEnableMemoryOptimization(true); // Reduce memory footprint
// -------------------- Convert Workbook to PDF --------------------
WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
remoteInputName, // source workbook name
"pdf", // target format
remoteOutputName, // output path in cloud storage
pdfOptions, // save options
"", // folder (root)
null // storage (default)
);
if (convertResponse == null || convertResponse.getCode() != 200) {
System.err.println("Conversion failed.");
return;
}
// -------------------- Download Resulting PDF --------------------
byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
} catch (ApiException | IOException e) {
e.printStackTrace();
} finally {
// -------------------- Optional Cleanup --------------------
try {
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
} catch (ApiException ignored) {
}
}
}
}
注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパス（
input.xlsx、output.pdfなど）を実際の場所に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。
Aspose.Cells Cloud を使用した cURL による REST API 変換
言語に依存しないアプローチを好む場合、同じ変換は Aspose.Cells Cloud REST API に対してシンプルな cURL コマンドで実行できます。
1. 認証してアクセストークンを取得する
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
レスポンスには、今後の呼び出しで使用する access_token が含まれています。
2. ソース XLSX ファイルをアップロード
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@input.xlsx"
3. ワークブックを PDF に変換する
curl -X POST "https://api.aspose.cloud/v3.0/cells/input.xlsx/saveAs/pdf?outputPath=output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"CacheFont": true,
"CompressImages": true,
"ImageQuality": 80,
"EnableMemoryOptimization": true
}'
4. 生成された PDF をダウンロード
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
これらのコマンドは、Java コードを書かずに同じ Java における 3D から PDF への変換 ワークフローを実行します。詳細については、公式 API ドキュメントをご覧ください。
結論
上記の手順に従うことで、Aspose.Cells Cloud SDK for Java を使用して 3D Excel ブックを高品質な PDF ファイルに確実に変換できます。ライブラリは 3D 図のレンダリングという重い処理を担当し、PDF 保存オプションでサイズやパフォーマンスを制御できます。製品版で使用する際は適切なライセンスを取得することを忘れないでください。価格情報は製品ページで確認でき、一時ライセンスページから一時ライセンスを取得できます。この知識があれば、Java アプリケーションに 3D から PDF への変換を統合し、エンドユーザーに洗練されたレポートを提供できるようになります。
よくある質問
-
JavaでAspose.Cellsを使用して3DからPDFへの変換を実装するにはどうすればよいですか？
SDKを使用してXLSXファイルをアップロードし、PdfSaveOptionsを構成し、postWorkbookSaveAsを呼び出して、生成されたPDFをダウンロードします。この記事の完全なコードサンプルには正確な手順が示されています。 -
Javaでコードを書かずに3DダイアグラムPDF変換を実行する方法はありますか？
はい、提供されたREST APIとcURLコマンドを使用すれば、HTTPリクエストを送信できる任意のプラットフォームから同じ結果を得ることができます。 -
3D Visualization PDF変換と標準的なExcelからPDFへの変換の違いは何ですか？
3Dビジュアライゼーションでは、チャートオブジェクトの追加レンダリングが必要ですが、SDKが自動的に処理します。標準の変換ではこれらの3Dレンダリング手順が省略されることがあり、その結果、グラフィックが欠落することがあります。 -
JavaのExcelからPDFへの変換で、3Dでないワークブックに同じワークフローを使用できますか？
もちろんです。同じAPI呼び出しはすべてのExcelファイルで機能します。必要ない場合は、3D固有のオプションを省略するか調整するだけです。