Birçok geliştirici, birleştirilmiş raporlar veya paketler oluşturmak için Node.JS’te birden fazla Word belgesini birleştirmesi gerekir. GroupDocs.Merger Cloud SDK for Node.js sunucu tarafında karmaşık dosya işleme kodu olmadan Word birleştirmeyi yöneten güçlü bir API sağlar. Bu rehberde, tam bir uygulama, eşdeğer cURL çağrıları, kurulum adımları ve belgelerinizin hızlı bir şekilde birleştirilmesi için en iyi uygulama ipuçlarını göreceksiniz.

Node.JS’te Birden Çok Word Belgesini Birleştirme - Tam Kod Örneği

Bu örnek, üç DOCX dosyasını tek bir belgeye birleştirmek için GroupDocs.Merger Cloud SDK for Node.js kullanarak nasıl yapılacağını gösterir.

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

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını (input1.docx, combined_output.docx, vb.) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile Word Belgelerini Birleştirme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı birleştirme işlemi cURL komutlarıyla gerçekleştirilebilir. Aşağıda kimlik doğrulaması yapan, kaynak dosyaları yükleyen, birleştirmeyi çalıştıran ve sonucu indiren kısa bir iş akışı bulunmaktadır.

1. Kimlik Doğrulama ve Erişim Token’ı Al

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

Yanıt, sonraki çağrılarda kullanılan bir access_token içerir.

2. Kaynak Dosyaları Yükleyin

Bu adımı birleştirmek istediğiniz her DOCX dosyası için tekrarlayın.

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. Birleştirme İşlemini Gerçekleştir

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, birleştirilmiş dosyanın yolunu döndürür.

4. Birleştirilmiş Belgeyi İndir

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

İstek yükleri ve seçenekler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Node.JS’te Birden Çok Word Belgesini Birleştirme Nasıl Çalışır

SDK, birleştirme sürecini birkaç mantıksal adıma soyutlar:

  1. Yapılandırma Oluşturma - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) kimlik doğrulama bağlamını oluşturur. Sınıf referansına API Reference içinde bakın.
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

  1. API Örneği - new GroupDocsMergerCloud.MergeApi(config) birleştirme işlemlerine erişim sağlar.

    const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

  2. Belge Girişleri - Her kaynak dosya, dosya yolunu içeren bir FileInfo içeren bir DocumentEntry içinde paketlenir.

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

  3. Birleştirme İsteği - MergeDocumentsRequest girdileri ve istenen çıktı yolunu paketler.

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

  4. Yürütme - mergeApi.mergeDocuments(mergeRequest) isteği bulut hizmetine gönderir. Promise, çıktı dosyası yolunu içeren bir sonuç nesnesiyle çözülür.

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

Bu adımlar, düşük seviyeli dosya akışlarıyla uğraşmadan birden fazla Word belgesini verimli bir şekilde birleştirmenizi sağlar.

GroupDocs.Merger için Ortamı Hazırlama

  1. SDK’yı kurun
npm install groupdocs-merger-cloud

Paket, resmi indirme sayfasından temin edilebilir.

  1. Node.js Version - Node.js 12 veya daha yeni bir sürüm çalıştırdığınızdan emin olun.

  2. Kimlik Bilgilerini Yapılandır - Kodda YOUR_CLIENT_ID ve YOUR_CLIENT_SECRET değerlerini GroupDocs Cloud hesabınızdaki değerlerle değiştirin.

  3. Proje Klasörü Oluşturun - Örnekte gösterildiği gibi kaynak DOCX dosyalarını documents/ alt klasörüne yerleştirin.

Bu adımları tamamladıktan sonra, birleştirme betiğini çalıştırmaya veya REST uç noktalarını çağırmaya hazırsınız.

Sonuç

Node.JS’te birden fazla Word belgesini birleştirmek, GroupDocs.Merger Cloud SDK for Node.js ile oldukça basit hale gelir. SDK, dosya yüklemelerini, birleştirme mantığını ve çıktı oluşturmayı yönetir, böylece düşük seviyeli dosya manipülasyonu yerine iş mantığına odaklanabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; ihtiyaçlarınız büyüdükçe bir geçici lisans ile başlayabilir ve tam bir aboneliğe yükseltebilirsiniz. Bugün birleştirmeye başlayın ve belge iş akışlarınızı sadeleştirin.

FAQs

  • Node.JS SDK kullanarak birden fazla Word belgesini nasıl birleştiririm?
    MergeApi sınıfını kullanarak her DOCX dosyasını bir DocumentEntry olarak listeleyen bir MergeDocumentsRequest oluşturun. SDK, sağlanan sıraya göre belgeleri birleştirir ve sonucu belirtilen çıkış yoluna kaydeder.

  • Aynı SDK ile PDF’leri birleştirmek mümkün mü?
    Evet, Merger SDK, PDF, DOCX, ODT ve birkaç başka formatı destekler. inputFiles dizisindeki dosya uzantılarını değiştirmeniz yeterlidir; SDK dönüşümü otomatik olarak gerçekleştirir. Format detayları için resmi belgeleri inceleyin.

  • Tek bir istekte birleştirebileceğim belge sayısıyla ilgili sınırlamalar nelerdir?
    Bulut hizmeti, kesin bir sayı yerine boyut sınırlaması uygular. Birleştirilen dosyaların toplam boyutu hesabınızın kotası içinde kaldığı sürece, onlarca dosyayı birleştirebilirsiniz. Çok büyük toplu işlemler için, dosyaları önce GroupDocs depolamasına yüklemeyi ve ID’leriyle referans vermeyi düşünün.

  • Geliştirme ve üretim için lisans konusunda endişelenmem gerekiyor mu?
    Geliştirme ve test aşamaları, geçici lisans sayfası üzerinden alınan geçici bir lisansla kullanılabilir. Üretim dağıtımları için, sınırsız birleştirmeleri ve öncelikli desteği açmak amacıyla tam bir lisans satın alın.

Daha Fazla Oku