Das Kombinieren mehrerer PDF-Dokumente zu einer einzigen Datei ist ein häufiges Bedürfnis beim Aufbau von Dokumenten‑Workflows oder beim Erstellen von Berichten. Das GroupDocs.Merger Cloud SDK for Node.js erleichtert das Zusammenführen von PDFs in Node.JS, ohne sich mit Low‑Level‑PDF‑Strukturen befassen zu müssen. Dieser Leitfaden führt Sie durch die Einrichtung, eine schrittweise Implementierung, ein vollständiges Code‑Beispiel, äquivalente cURL‑Aufrufe und Leistungstipps für große oder verschlüsselte PDFs.

Bevor Sie beginnen: Voraussetzungen und Installation

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

  • Node.js 14 oder neuer, installiert auf Ihrem Entwicklungsrechner.
  • Ein aktives GroupDocs Cloud‑Konto mit Client‑ID und Client‑Secret.
  • Zugriff auf die PDF‑Dateien, die Sie kombinieren möchten, gespeichert im GroupDocs Cloud‑Speicher.

Installieren Sie das SDK über npm und laden Sie das neueste Paket herunter:

npm install groupdocs-merger-cloud

Sie können das SDK auch von der offiziellen Release‑Seite abrufen: Download SDK. Nach der Installation sind Sie bereit, mit dem Codieren zu beginnen.

Schritt-für-Schritt-Anleitung zum Zusammenführen von PDF in Node.JS

Schritt 1: SDK installieren und erforderliche Klassen importieren

Zuerst importieren Sie die Klassen, die Sie zum Zusammenführen von PDFs benötigen.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Dieser Import gibt Ihnen Zugriff auf die Kern‑API, Konfigurationsobjekte und Dateideskriptoren.

Schritt 2: Konfigurieren Sie Ihre GroupDocs Credentials

Erstellen Sie ein Konfigurationsobjekt mit Ihren Client‑Anmeldeinformationen.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Das Bereitstellen der richtigen Anmeldeinformationen ermöglicht es der Bibliothek, Ihre Anfragen zu authentifizieren.

Schritt 3: Definieren Sie die PDF-Dateien, die zusammengeführt werden sollen

Listen Sie die PDF‑Dokumente auf, die Sie kombinieren möchten. Dieser Schritt bereitet Sie darauf vor, PDF in Node.JS effizient zusammenzuführen.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Jede FileInfo verweist auf eine Datei, die in Ihrem GroupDocs Cloud‑Speicher gespeichert ist.

Schritt 4: Merge-Optionen festlegen

Konfigurieren Sie den Ausgabespeicherort und fügen Sie die Dateiliste dem Merge‑Request bei.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Diese Einstellungen steuern, wie Sie PDF in Node.JS zusammenführen und wo das Ergebnis gespeichert wird.

Schritt 5: Ausführen der Merge-Operation

Erstellen Sie die API‑Instanz, rufen Sie die Merge‑Methode auf und verarbeiten Sie die Antwort.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

Der asynchrone Aufruf gibt den Pfad des zusammengeführten Dokuments zurück, wenn die Operation erfolgreich ist.

Vollständiges Implementierungsbeispiel für das Zusammenführen von PDFs in Node.JS

Der folgende Code demonstriert den vollständigen Workflow von der Konfiguration bis zur Ergebnisverarbeitung.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, 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.

Zusammenführen von PDFs über die REST-API mit cURL

Wenn Sie einen reinen REST‑Ansatz bevorzugen, kann dieselbe Operation mit cURL‑Befehlen ausgeführt werden.

Zuerst ein Zugriffstoken erhalten:

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET","grant_type":"client_credentials"}'

Laden Sie die Quell‑PDFs in Ihren Speicher hoch (ersetzen Sie YOUR_ACCESS_TOKEN durch das Token aus dem vorherigen Schritt):

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

Wiederholen Sie den Upload für input2.pdf. Anschließend fordern Sie die Merge‑Operation an:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Laden Sie schließlich die zusammengeführte Datei herunter:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

Für eine vollständige Liste der Endpunkte und Parameter siehe die API‑Referenz.

Merge-Optionen konfigurieren

Das SDK bietet mehrere Optionen, mit denen Sie den Zusammenführungsprozess feinabstimmen können:

  • outputPath – Zielpfad für das zusammengeführte PDF. Passen Sie dies an, um zu steuern, wo das Ergebnis gespeichert wird.
  • fileInfos – Ein Array von FileInfo‑Objekten, das die Quell‑PDFs und deren Reihenfolge definiert.

Sie können auch zusätzliche Eigenschaften wie pages festlegen, um bestimmte Seitenbereiche zusammenzuführen, oder password für verschlüsselte PDFs. Weitere Informationen finden Sie in der offiziellen Dokumentation für die vollständige Liste der konfigurierbaren Felder.

Leistungsüberlegungen beim Zusammenführen von PDFs

Beim Zusammenführen großer oder vieler PDF-Dateien sollten Sie diese Tipps beachten:

  • Verwenden Sie async/await um die Event‑Schleife nicht zu blockieren, insbesondere bei großen Dokumenten.
  • Batch‑Uploads: Laden Sie Quell‑PDFs parallel hoch, bevor Sie den Merge aufrufen, um die Gesamtlatenz zu reduzieren.
  • Stream‑Verarbeitung: Für extrem große PDFs sollten Sie erwägen, Zwischenergebnisse im Cloud‑Speicher zu speichern und sie in kleineren Teilen zusammenzuführen.
  • Verschlüsselte PDFs: Geben Sie Passwörter in den FileInfo‑Objekten an; die Verarbeitung verschlüsselter Dateien verursacht zusätzlichen Aufwand, daher sollten Sie sie nach Möglichkeit nach der Entschlüsselung zusammenführen.

Durch die Anwendung dieser Praktiken können Sie PDF in Node.JS effizient zusammenführen und gleichzeitig den Speicherverbrauch minimieren.

Fragen, die Sie haben könnten

  • Wie kann ich PDF-Dateien in Node.JS mit GroupDocs zusammenführen?
    Verwenden Sie das GroupDocs.Merger Cloud SDK for Node.js, um eine MergeApi-Instanz zu erstellen, MergeOptions mit Ihren Quell‑PDFs zu konfigurieren und mergeDocuments aufzurufen. Das vollständige Codebeispiel in diesem Leitfaden demonstriert den Vorgang.

  • Kann ich verschlüsselte PDF-Dateien in Node.JS zusammenführen?
    Ja, das SDK unterstützt das Zusammenführen verschlüsselter PDFs. Geben Sie die richtigen Passwörter in den FileInfo‑Objekten an, bevor Sie mergeDocuments aufrufen. Siehe die offizielle Dokumentation für Details.

  • Was sind die Lizenzoptionen für GroupDocs.Merger?
    GroupDocs bietet flexible Preispläne. Zum Testen können Sie eine temporäre Lizenz anfordern, um die Bibliothek vor dem Kauf eines Vollabonnements zu evaluieren.

  • Wo finde ich weitere Beispiele und Support?
    Zusätzliche Beispiele sind im GitHub-Repository verfügbar. Für Hilfe besuchen Sie das Support-Forum.

Weiterführende Lektüre