Wielu programistów potrzebuje łączyć wiele dokumentów Word w Node.JS, aby generować skonsolidowane raporty lub pakiety. GroupDocs.Merger Cloud SDK for Node.js zapewnia potężne API, które obsługuje scalanie Worda po stronie serwera bez skomplikowanego kodu obsługi plików. W tym przewodniku zobaczysz pełną implementację, równoważne wywołania cURL, kroki instalacji oraz wskazówki najlepszych praktyk, aby szybko scalić swoje dokumenty.

Scalanie wielu dokumentów Word w Node.JS - kompletny przykład kodu

Ten przykład pokazuje, jak połączyć trzy pliki DOCX w jeden dokument przy użyciu GroupDocs.Merger Cloud SDK for Node.js.

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

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (input1.docx, combined_output.docx itp.), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, i dokładnie przetestuj w środowisku programistycznym. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Łączenie dokumentów Word za pomocą REST API przy użyciu cURL

Jeśli wolisz czyste podejście REST, tę samą operację scalania można wykonać przy użyciu poleceń cURL. Poniżej znajduje się zwięzły przepływ pracy, który uwierzytelnia, przesyła pliki źródłowe, uruchamia scalanie i pobiera wynik.

1. Uwierzytelnianie i uzyskanie tokenu dostępu

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"}'

Odpowiedź zawiera access_token używany w kolejnych wywołaniach.

2. Prześlij pliki źródłowe

Powtórz ten krok dla każdego pliku DOCX, który chcesz scalić.

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. Wykonaj operację scalania

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"
}'

API zwraca ścieżkę do połączonego pliku.

4. Pobierz połączony dokument

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

Aby uzyskać więcej informacji o ładunkach żądań i opcjach, zobacz oficjalną dokumentację API.

Jak działa scalanie wielu dokumentów Word w Node.JS

SDK abstrahuje proces scalania w kilka logicznych kroków:

  1. Tworzenie konfiguracji - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) tworzy kontekst uwierzytelniania. Zobacz odniesienie do klasy w Referencja API.
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

  1. Instancja API - new GroupDocsMergerCloud.MergeApi(config) zapewnia dostęp do operacji scalania.

    const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

  2. Wpisy dokumentu – każdy plik źródłowy jest opakowany w DocumentEntry, który zawiera FileInfo z ścieżką pliku.

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

  1. Merge Request - MergeDocumentsRequest pakietuje wpisy i żądaną ścieżkę wyjściową.

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

  2. Wykonanie - mergeApi.mergeDocuments(mergeRequest) wysyła żądanie do usługi w chmurze. Obietnica zwraca obiekt wyniku zawierający ścieżkę do pliku wyjściowego.

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

Te kroki razem umożliwiają łączenie wielu dokumentów Word w sposób efektywny, bez obsługi strumieni plików niskiego poziomu.

Przygotowanie środowiska dla GroupDocs.Merger

  1. Zainstaluj SDK
npm install groupdocs-merger-cloud

Pakiet jest dostępny na oficjalnej stronie pobierania.

  1. Node.js Version - Upewnij się, że używasz Node.js 12 lub nowszego.

  2. Skonfiguruj poświadczenia - Zastąp YOUR_CLIENT_ID i YOUR_CLIENT_SECRET w kodzie wartościami z konta GroupDocs Cloud.

  3. Utwórz folder projektu - Umieść pliki źródłowe DOCX w podfolderze documents/, jak pokazano w przykładzie.

Po wykonaniu tych kroków jesteś gotowy uruchomić skrypt scalania lub wywołać endpointy REST.

Podsumowanie

Łączenie wielu dokumentów Word w Node.JS staje się proste dzięki GroupDocs.Merger Cloud SDK for Node.js. SDK obsługuje przesyłanie plików, logikę scalania i generowanie wyników, pozwalając skupić się na logice biznesowej, a nie na niskopoziomowej manipulacji plikami. Pamiętaj, aby zabezpieczyć odpowiednią licencję do użytku produkcyjnego; możesz rozpocząć od tymczasowej licencji i przejść na pełną subskrypcję w miarę rosnących potrzeb. Rozpocznij scalanie już dziś i usprawnij przepływy pracy dokumentów.

Najczęściej zadawane pytania

  • Jak połączyć wiele dokumentów Word w Node.JS przy użyciu SDK?
    Użyj klasy MergeApi, aby utworzyć MergeDocumentsRequest, który wymienia każdy plik DOCX jako DocumentEntry. SDK łączy je w podanej kolejności i zapisuje wynik w określonej ścieżce wyjściowej.

  • Czy można łączyć pliki PDF razem przy użyciu tego samego SDK?
    Tak, Merger SDK obsługuje PDF, DOCX, ODT oraz kilka innych formatów. Wystarczy zmienić rozszerzenia plików w tablicy inputFiles, a SDK automatycznie zajmie się konwersją. Zobacz oficjalną dokumentację po szczegóły dotyczące formatów.

  • Jakie są limity liczby dokumentów, które mogę scalić w jednym żądaniu?
    Usługa w chmurze narzuca limit rozmiaru, a nie sztywną liczbę. O ile łączny rozmiar mieści się w przydziale Twojego konta, możesz scalić dziesiątki plików. W przypadku bardzo dużych partii rozważ najpierw przesłanie plików do magazynu GroupDocs i odwoływanie się do nich za pomocą identyfikatora.

  • Czy muszę martwić się o licencjonowanie w środowisku deweloperskim a produkcyjnym?
    Rozwój i testowanie mogą korzystać z tymczasowej licencji uzyskanej ze strony tymczasowej licencji. Dla wdrożeń produkcyjnych zakup pełnej licencji, aby odblokować nieograniczone łączenia i priorytetowe wsparcie.

Czytaj dalej