Node.js SDK belge birleştirme ve rapor oluşturma için

Güçlü belge birleştirme yeteneklerini Node uygulamalarınıza GroupDocs.Assembly Cloud REST API kullanarak entegre edin.

  • GroupDocs.Assembly Cloud SDK için cURL
  • GroupDocs.Assembly Cloud SDK için .NET
  • Java için GroupDocs.Assembly Cloud SDK
  • PHP için GroupDocs.Assembly Cloud SDK
  • Python için GroupDocs.Assembly Cloud SDK
  • Ruby için GroupDocs.Assembly Cloud SDK
  • Go için GroupDocs.Assembly Cloud SDK
  • C++ için GroupDocs.Assembly Cloud SDK
  • Swift için GroupDocs.Assembly Cloud SDK
Ücretsiz Denemeye Başlayın

GroupDocs.Assembly Cloud, tam yönetilen, REST‑tabanlı bir hizmettir ve geliştiricilerin yeniden kullanılabilir şablonlar ve dış veri kaynaklarından zengin biçimlendirilmiş, baskıya hazır belgeler oluşturmasını sağlar.

Platform, klasik Microsoft Office dosyalarından (DOCX, XLSX, PPTX) PDF, HTML, OpenDocument ve birçok grafik formatına kadar geniş bir kaynak ve hedef format yelpazesini destekler – böylece kendi sunucularınıza üçüncü taraf bir yazılım kurmadan sözleşmeler, faturalar, raporlar, pazarlama broşürleri veya herhangi bir özel belge oluşturabilirsiniz. Tüm ağır işleri – şablon ayrıştırma, veri bağlama, görüntü işleme, barkod oluşturma, formül değerlendirme ve dosya dönüştürme – bulutta gerçekleştirir, bu da işletim sistemleri arasında tutarlı sonuçlar sağlar ve altyapı maliyetlerini azaltır.

Node.js SDK neden kullanılmalı?

  • Sıfır‑kurulum çalışma zamanı – SDK, Assembly Cloud REST API üzerine ince bir sarmalayıcıdır, bu yüzden yalnızca Node 12+ ve bir npm paketi gerekir.
  • Çapraz‑platform – Windows, macOS, Linux veya konteyner içinde aynı şekilde çalışır.
  • Güvenli – tüm iletişim TLS ile şifrelenir ve kimlik doğrulama kişisel App SID’niz ve App Key ile gerçekleştirilir.
  • Ölçeklenebilir – bulut hizmeti tek belge isteklerini ve yüksek hacimli toplu Mail‑Merge işlerini yönetebilir.
  • Genişletilebilir – aynı API REST uç noktalarını çağırabilen herhangi bir dilden kullanılabilir; Node.js SDK yalnızca istek oluşturmayı ve yanıt işlemesini basitleştirir.

Node.js uygulamasında tipik iş akışı

  1. Bir şablon hazırlayın (DOCX, PPTX vb.) – yer tutucu alanlar ve koşullu bloklar, döngüler veya barkod etiketleri gibi isteğe bağlı programlama yapıları içerir.
  2. XML veya JSON içinde bir veri kaynağı oluşturun – şablona birleştirilecek değerleri sağlar.
  3. Şablonu GroupDocs Cloud Storage’a yükleyin – SDK’nin uploadFile yöntemiyle.
  4. AssembleOptions yapılandırın – şablon yolunu, veri kaynağını, istenen çıktı formatını (PDF, DOCX, HTML, …) ve ek ayarları (ör. barkod oluşturma, arka plan rengi) belirtin.
  5. assembleDocument çağırın – SDK, sunucuda birleştirme sürecini tetikleyen tek bir HTTP isteği gönderir.
  6. Birleştirilmiş dosyayı bir bayt dizisi olarak alın, yerel olarak kaydedin veya doğrudan istemciye akıtın.

Aşağıdaki örnek (More Feature bölümünde gösterildiği gibi) bu adımların her birini kompakt ve üretim‑hazır bir kod parçacığında gösterir.

GroupDocs.Assembly Cloud API Özellikleri

Bulut REST API kullanarak şablonlardan belgeler oluşturun

LINQ‑stil veri bağlama, XML ve JSON kaynakları için

Görselleri, grafikler ve harici belge içeriğini ekleyin

Dizi verilerinden dinamik tablolar ve listeler

Köprüleri, yer imlerini ve e-posta eklerini ekleyin

Formülleri ve sıralı veri işlemlerini uygulayın

Şablonlarda koşullu içerik blokları (IF‑ELSE)

Barkodları (QR, Code128 vb.) oluşturun

HTML çıktısı için arka plan renklerini ayarlayın

Toplu kişiselleştirilmiş mektuplar için Mail‑Merge

Node.js formatında rapor oluşturun

Aşağıdaki kod parçacığı tam bir akışı gösterir: bir şablon yükleyin, bir JSON veri dosyasını okuyun, montaj isteğini yapılandırın ve birleştirilmiş belgeyi alın.

Adımlar

  1. Yükleyin DOCX şablonunu GroupDocs Cloud Storage’a.
  2. Okuyun birleştirilecek değerleri içeren JSON veri dosyasını.
  3. Yapılandırın AssembleOptions – çıktı formatını seçin ve verileri bağlayın.
  4. Çağırın assembleDocument raporu oluşturmak için.
  5. Kaydedin döndürülen bayt dizisini PDF (veya desteklenen herhangi bir format) olarak.
// Replace with your App SID and App Key
const { AssemblyApi, AssembleDocumentRequest, AssembleOptions, TemplateFileInfo, model } = require("groupdocs-assembly-cloud");
const fs = require("fs");
const path = require("path");

// Authorization placeholder
const assemblyApi = new AssemblyApi("####-####-####-####-####", "##################");

// 1️⃣ Upload the template file
const templatePath = "Input1.docx";
const uploadRequest = new model.UploadFileRequest({
    fileContent: fs.createReadStream(templatePath),
    path: templatePath
});
await assemblyApi.uploadFile(uploadRequest);

// 2️⃣ Read the data source (JSON)
const dataPath = "Input2.docx";
const reportData = fs.readFileSync(dataPath, "utf8");

// 3️⃣ Set assembly options
const assembleOptions = new AssembleOptions({
    saveFormat: "pdf",
    reportData: reportData,
    templateFileInfo: new TemplateFileInfo({ filePath: templatePath })
});

// 4️⃣ Create and send the assemble request
const request = new AssembleDocumentRequest({ assembleOptions });
const result = await assemblyApi.assembleDocument(request);

// 5️⃣ Save the resulting document
const outputPath = path.join(__dirname, "GeneratedReport.pdf");
fs.writeFileSync(outputPath, result.body);

console.log("Report generated successfully:", outputPath);

Support and Learning Resources

GroupDocs.Assembly Cloud ayrıca diğer diller için SDKs sunar:

  Türkçe
517a8fa32