Belge Derleme ve Rapor Oluşturma için Node.js SDK'sı
GroupDocs.Assembly Cloud REST API’sini kullanarak güçlü belge derleme yeteneklerini Node uygulamalarınıza entegre edin.
GroupDocs.Assembly Cloud REST API’sini kullanarak güçlü belge derleme yeteneklerini Node uygulamalarınıza entegre edin.
GroupDocs.Assembly Cloud, geliştiricilerin yeniden kullanılabilir şablonlardan ve harici veri kaynaklarından zengin biçimlendirilmiş, baskıya hazır belgeler oluşturmasını sağlayan, tamamen yönetilen, REST tabanlı bir hizmettir.
Platform, klasik Microsoft Office dosyalarından (DOCX, XLSX, PPTX) PDF, HTML, OpenDocument ve birçok grafik formatına kadar çok çeşitli kaynak ve hedef formatlarını destekleyerek, kendi sunucularınıza herhangi bir üçüncü taraf yazılımı yüklemeden sözleşmeler, faturalar, raporlar, pazarlama broşürleri veya herhangi bir özel belge oluşturmanıza olanak tanır. Ş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 gibi tüm ağır işler bulutta gerçekleştirilir; bu da işletim sistemleri arasında tutarlı sonuçlar sağlar ve altyapı maliyetlerini azaltır.
Neden Node.js SDK kullanmalısınız?
Bir Node.js uygulamasında tipik iş akışı
Yer tutucu alanlar ve koşullu bloklar, döngüler veya barkod etiketleri gibi isteğe bağlı programlama yapıları içeren bir şablon (DOCX, PPTX vb.) hazırlayın.
Şablona birleştirilecek değerleri sağlayan XML veya JSON biçiminde bir veri kaynağı oluşturun.
SDK’nın uploadFile yöntemini kullanarak şablonu GroupDocs Cloud Storage’a yükleyin.
AssembleOptions‘ı yapılandırın: Şablon yolunu, veri kaynağını, istenen çıktı biçimini (PDF, DOCX, HTML, …) ve ek ayarları (örneğin barkod oluşturma, arka plan rengi) belirtin.
assembleDocument‘ı çağırın: SDK, sunucuda derleme işlemini tetikleyen tek bir HTTP isteği gönderir.
Derlenmiş dosyayı bir bayt dizisi olarak alın, yerel olarak kaydedin veya doğrudan istemciye aktarın.
Aşağıdaki örnek (Daha Fazla Özellik bölümünde gösterilmiştir), bu adımların her birini kompakt, üretime hazır bir kod parçacığında göstermektedir.
Assembly Cloud API’nin temel yetenekleri.
Assembly Cloud API için desteklenen belge biçimleri.
Desteklenen işletim sistemleri ve geliştirme ortamları.
Aşağıdaki kod parçası eksiksiz bir akışı göstermektedir: bir şablon yükleyin, bir JSON veri dosyasını okuyun, derleme isteğini yapılandırın ve derlenmiş belgeyi alın.
Adımlar
GroupDocs.AssemblyAssembleOptions‘ı yapılandırın - çıktı biçimini seçin ve verileri bağlayın.assembleDocument‘ı çağırın.// 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);