Viele Entwickler müssen mehrere Word‑Dokumente in Node.JS kombinieren, um konsolidierte Berichte oder Pakete zu erstellen. GroupDocs.Merger Cloud SDK for Node.js bietet eine leistungsstarke API, die das Zusammenführen von Word‑Dokumenten serverseitig ohne komplexen Datei‑Handling‑Code ermöglicht. In diesem Leitfaden sehen Sie eine vollständige Implementierung, äquivalente cURL‑Aufrufe, Installationsschritte und bewährte Tipps, um Ihre Dokumente schnell zusammenzuführen.

Mehrere Word-Dokumente in Node.JS kombinieren – Vollständiges Codebeispiel

Dieses Beispiel demonstriert, wie man drei DOCX Dateien zu einem einzigen Dokument zusammenführt, indem man das GroupDocs.Merger Cloud SDK für Node.js verwendet.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input1.docx, combined_output.docx usw.) an Ihre tatsächlichen Speicherorte 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 Word-Dokumenten über die REST-API mit cURL

Wenn Sie einen reinen REST‑Ansatz bevorzugen, kann dieselbe Merge‑Operation mit cURL‑Befehlen durchgeführt werden. Im Folgenden finden Sie einen kurzen Workflow, der authentifiziert, Quell‑Dateien hochlädt, den Merge ausführt und das Ergebnis herunterlädt.

1. Authentifizieren und Zugriffstoken erhalten

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

Die Antwort enthält ein access_token, das in nachfolgenden Aufrufen verwendet wird.

2. Laden Sie die Quelldateien hoch

Wiederholen Sie diesen Schritt für jede DOCX-Datei, die Sie zusammenführen möchten.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. Merge-Vorgang ausführen

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

Die API gibt den Pfad der zusammengeführten Datei zurück.

4. Herunterladen des zusammengeführten Dokuments

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

Weitere Details zu den Anforderungs‑Payloads und Optionen finden Sie in der offiziellen API‑Dokumentation.

Wie das Zusammenführen mehrerer Word-Dokumente in Node.JS funktioniert

Das SDK abstrahiert den Merge‑Vorgang in einige logische Schritte:

  1. Konfigurationserstellung - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) erstellt den Authentifizierungskontext. Siehe die Klassenreferenz in der API-Referenz.
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
  1. API-Instanz - new GroupDocsMergerCloud.MergeApi(config) bietet Zugriff auf Merge-Operationen.
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

  1. Document Entries - Jede Quelldatei wird in ein DocumentEntry eingeschlossen, das ein FileInfo mit dem Dateipfad enthält.

    const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
    });
});

  2. Merge Request - MergeDocumentsRequest fasst die Einträge und den gewünschten Ausgabepfad zusammen.

    const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

  3. Ausführung - mergeApi.mergeDocuments(mergeRequest) sendet die Anfrage an den Cloud‑Dienst. Das Promise wird mit einem Ergebnisobjekt aufgelöst, das den Pfad der Ausgabedatei enthält.

    const result = await mergeApi.mergeDocuments(mergeRequest);
console.log(`Merge completed successfully. Output file: ${result.path}`);

Diese Schritte ermöglichen es Ihnen, mehrere Word‑Dokumente effizient zu kombinieren, ohne Low‑Level‑Dateistreams zu handhaben.

Umgebung für GroupDocs.Merger einrichten

  1. Installieren Sie das SDK
npm install groupdocs-merger-cloud

Das Paket ist über die offizielle Download-Seite verfügbar.

  1. Node.js Version - Stellen Sie sicher, dass Sie Node.js 12 oder höher ausführen.

  2. Anmeldeinformationen konfigurieren - Ersetzen Sie YOUR_CLIENT_ID und YOUR_CLIENT_SECRET im Code durch die Werte aus Ihrem GroupDocs Cloud‑Konto.

  3. Projektordner erstellen - Platzieren Sie die Quell‑DOCX‑Dateien in einem Unterordner documents/, wie im Beispiel gezeigt.

Nachdem diese Schritte abgeschlossen sind, können Sie das Merge‑Skript ausführen oder die REST‑Endpunkte aufrufen.

Fazit

Das Kombinieren mehrerer Word‑Dokumente in Node.JS wird mit dem GroupDocs.Merger Cloud SDK for Node.js unkompliziert. Das SDK übernimmt das Hochladen von Dateien, die Zusammenführungslogik und die Ausgabeerstellung, sodass Sie sich auf die Geschäftslogik statt auf die Low‑Level‑Dateimanipulation konzentrieren können. Denken Sie daran, für die Produktion eine gültige Lizenz zu sichern; Sie können mit einer temporären Lizenz beginnen und bei wachsendem Bedarf auf ein Vollabo upgraden. Beginnen Sie noch heute mit dem Zusammenführen und optimieren Sie Ihre Dokumenten‑Workflows.

FAQs

  • Wie kombiniere ich mehrere Word-Dokumente in Node.JS mit dem SDK?
    Verwenden Sie die Klasse MergeApi, um ein MergeDocumentsRequest zu erstellen, das jede DOCX-Datei als DocumentEntry auflistet. Das SDK führt die Zusammenführung in der angegebenen Reihenfolge durch und speichert das Ergebnis im angegebenen Ausgabepfad.

  • Ist es möglich, PDFs mit demselben SDK zusammenzuführen?
    Ja, das Merger SDK unterstützt PDF, DOCX, ODT und mehrere weitere Formate. Ändern Sie einfach die Dateierweiterungen im inputFiles‑Array und das SDK führt die Konvertierung automatisch durch. Siehe die offizielle Dokumentation für Details zu den Formaten.

  • Was sind die Grenzen für die Anzahl der Dokumente, die ich in einer einzigen Anfrage zusammenführen kann?
    Der Cloud-Dienst legt ein Größenlimit fest, anstatt einer strikten Stückzahl. Solange die kombinierte Größe innerhalb des Kontingents Ihres Kontos bleibt, können Sie Dutzende von Dateien zusammenführen. Für sehr große Stapel sollten Sie in Erwägung ziehen, die Dateien zuerst in den GroupDocs-Speicher hochzuladen und sie per ID zu referenzieren.

  • Muss ich mir wegen Lizenzierung für Entwicklung gegenüber Produktion Sorgen machen?
    Entwicklung und Tests können eine temporäre Lizenz verwenden, die von der temporäre Lizenzseite erhalten wird. Für Produktionsbereitstellungen kaufen Sie eine Voll‑Lizenz, um unbegrenzte Zusammenführungen und vorrangigen Support freizuschalten.

Read More