Das Konvertieren komplexer 3D Diagramme aus einer Excel‑Arbeitsmappe in eine portable PDF-Datei ist ein häufiger Bedarf für Berichte und das Teilen visueller Daten. Aspose.Cells Cloud SDK for Java bietet eine leistungsstarke cloudbasierte Bibliothek, die diese Aufgabe für Java‑Entwickler vereinfacht. In diesem Leitfaden führen wir Sie durch den gesamten 3D‑zu‑PDF‑Konvertierungsprozess in Java, von der Vorbereitung Ihrer Umgebung bis zum Abrufen des endgültigen Dokuments. Sie sehen eine detaillierte Code‑Durchführung, ein vollständiges Beispiel und äquivalente cURL‑Befehle für die REST‑API‑Integration.

Einrichtung des Aspose.Cells Cloud SDK für Java

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Java 17 oder neuer installiert.
  • Maven oder Gradle für die Abhängigkeitsverwaltung.
  • Ein Aspose Cloud‑Konto mit Client Id und Client Secret.
  • Zugriff auf das Internet für Cloud‑Aufrufe.

Fügen Sie das SDK zu Ihrem Projekt hinzu, indem Sie die unten gezeigte Maven‑Abhängigkeit verwenden, und laden Sie die neueste JAR von der offiziellen Download‑Seite herunter.

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cells-cloud</artifactId>
    <version>26.7</version>
</dependency>

Sie können die Bibliothek auch direkt von der Download-URL erhalten.

Konfigurieren Sie den Client mit Ihren Anmeldeinformationen. Dieser Codeausschnitt stammt direkt aus dem vollständigen Beispiel.

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default

Mit der Konfiguration sind Sie bereit, den Konvertierungs‑Workflow zu starten.

3D‑zu‑PDF‑Konvertierung in Java – Schritt‑für‑Schritt‑Durchgang

Schritt 1: Excel‑Arbeitsmappe in den Cloud‑Speicher hochladen

Zuerst laden Sie die XLSX Datei hoch, die die 3D‑Diagramme enthält. Die FilesApi übernimmt den Upload.

FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
    System.err.println("Upload failed.");
    return;
}

Schritt 2: PDF-Speicheroptionen vorbereiten

Feinabstimmung der PDF‑Ausgabe durch Aktivieren von Schriftzwischenspeicherung, Bildkomprimierung und Speicheroptimierung. Diese Optionen helfen, die PDF‑Größe gering zu halten und gleichzeitig die 3D‑visuelle Qualität zu erhalten.

PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);

Schritt 3: Arbeitsmappe in PDF konvertieren

Rufen Sie die Methode postWorkbookSaveAs von CellsApi auf, um die Konvertierung durchzuführen. Die API‑Referenz für diese Methode ist in der Aspose.Cells API Reference verfügbar.

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)

Schritt 4: Laden Sie das resultierende PDF herunter

Nach einer erfolgreichen Konvertierung laden Sie die PDF‑Bytes herunter und schreiben sie in eine lokale Datei.

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);

Schritt 5: Optionale Bereinigung

Entfernen Sie die temporären Dateien aus dem Cloud‑Speicher, um Ihr Konto ordentlich zu halten.

filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);

Vollständige Java-Implementierung für die 3D-zu-PDF-Konvertierung – Vollständiges Codebeispiel

Das folgende Beispiel demonstriert die End‑zu‑Ende‑Konvertierung einer 3D‑Excel‑Arbeitsmappe in PDF mithilfe von Aspose.Cells Cloud SDK for Java.

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) {
            }
        }
    }
}

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input.xlsx, output.pdf, usw.) an Ihre tatsächlichen Dateistandorte anpassen, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

REST-API-Konvertierung über cURL mit Aspose.Cells Cloud

Wenn Sie einen sprachunabhängigen Ansatz bevorzugen, kann dieselbe Konvertierung mit einfachen cURL‑Befehlen gegen die Aspose.Cells Cloud REST API durchgeführt werden.

1. Authentifizieren und ein Zugriffstoken erhalten

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"

Die Antwort enthält ein access_token, das Sie in nachfolgenden Aufrufen verwenden.

2. Laden Sie die Quell‑XLSX‑Datei hoch

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. Arbeitsmappe in PDF konvertieren

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. Laden Sie das generierte PDF herunter

curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Diese Befehle führen denselben 3D-zu-PDF-Konvertierungs-Workflow in Java aus, ohne Java-Code zu schreiben. Weitere Details finden Sie in der offiziellen API-Dokumentation.

Fazit

Indem Sie den obigen Schritten folgen, können Sie 3D‑Excel‑Arbeitsmappen zuverlässig in hochwertige PDF‑Dateien konvertieren, indem Sie Aspose.Cells Cloud SDK for Java verwenden. Die Bibliothek übernimmt das aufwändige Rendern von 3D‑Diagrammen, während die PDF‑Speicheroptionen Ihnen die Kontrolle über Größe und Leistung ermöglichen. Denken Sie daran, für den Produktionseinsatz eine gültige Lizenz zu sichern; Preisdetails finden Sie auf der Produktseite, und eine temporäre Lizenz kann über die temporäre Lizenzseite bezogen werden. Mit diesem Wissen sind Sie bereit, die 3D‑zu‑PDF‑Konvertierung in Ihre Java‑Anwendungen zu integrieren und den Endbenutzern professionell aufbereitete Berichte bereitzustellen.

FAQs

  • Wie implementiere ich die 3D‑zu‑PDF‑Konvertierung in Java mit Aspose.Cells?
    Verwenden Sie das SDK, um Ihre XLSX‑Datei hochzuladen, konfigurieren Sie PdfSaveOptions, rufen Sie postWorkbookSaveAs auf und laden Sie das resultierende PDF herunter. Das vollständige Codebeispiel in diesem Artikel zeigt die genaue Reihenfolge.

  • Gibt es eine Möglichkeit, die 3D-Diagramm-PDF-Konvertierung in Java ohne Schreiben von Code durchzuführen?
    Ja, die bereitgestellte REST‑API und die cURL‑Befehle ermöglichen es Ihnen, dasselbe Ergebnis von jeder Plattform aus zu erzielen, die HTTP‑Anfragen stellen kann.

  • Was ist der Unterschied zwischen der 3D-Visualisierungs-PDF-Konvertierung und der Standard-Excel-zu-PDF-Konvertierung?
    3D-Visualisierungen erfordern eine zusätzliche Renderung von Diagrammobjekten, die das SDK automatisch übernimmt. Bei der Standardkonvertierung können diese 3D-Render-Schritte übersprungen werden, was zu fehlenden Grafiken führt.

  • Kann ich denselben Workflow für die Java‑Excel‑zu‑PDF‑Konvertierung von nicht‑3D‑Arbeitsmappen verwenden?
    Absolut. Die gleichen API‑Aufrufe funktionieren für jede Excel‑Datei; Sie lassen einfach die 3D‑spezifischen Optionen weg oder passen sie an, wenn sie nicht benötigt werden.

Read More