Node.js SDK για Συναρμολόγηση Εγγράφων και Δημιουργία Αναφορών

Ενσωματώστε ισχυρές δυνατότητες συναρμολόγησης εγγράφων στις εφαρμογές Node χρησιμοποιώντας GroupDocs.Assembly Cloud REST API.

  • GroupDocs.Assembly Cloud SDK για cURL
  • GroupDocs.Assembly Cloud SDK για .NET
  • GroupDocs.Assembly Cloud SDK για Java
  • GroupDocs.Assembly Cloud SDK για PHP
  • GroupDocs.Assembly Cloud SDK για Python
  • GroupDocs.Assembly Cloud SDK για Ruby
  • GroupDocs.Assembly Cloud SDK για Go
  • GroupDocs.Assembly Cloud SDK για C++
  • GroupDocs.Assembly Cloud SDK για Swift
Ξεκινήστε τη δωρεάν δοκιμή

GroupDocs.Assembly Cloud είναι μια πλήρως διαχειριζόμενη, υπηρεσία βασισμένη σε REST‑ που επιτρέπει στους προγραμματιστές να δημιουργούν πλούσια μορφοποιημένα, έτοιμα για εκτύπωση έγγραφα από επαναχρησιμοποιήσιμα πρότυπα και εξωτερικές πηγές δεδομένων.

Η πλατφόρμα υποστηρίζει μια μεγάλη ποικιλία μορφών προέλευσης και προορισμού – από κλασικά αρχεία Microsoft Office (DOCX, XLSX, PPTX) έως PDF, HTML, OpenDocument και πολλές γραφικές μορφές – επιτρέποντάς σας να δημιουργείτε συμβόλαια, τιμολόγια, αναφορές, φυλλάδια μάρκετινγκ ή οποιοδήποτε προσαρμοσμένο έγγραφο χωρίς την εγκατάσταση λογισμικού τρίτων στους δικούς σας διακομιστές. Όλη η βαριά δουλειά – ανάλυση προτύπων, σύνδεση δεδομένων, απόδοση εικόνων, δημιουργία barcode, αξιολόγηση τύπων και μετατροπή αρχείων – εκτελείται στο σύννεφο, εξασφαλίζοντας συνεπή αποτελέσματα σε όλα τα λειτουργικά συστήματα και μειώνοντας το κόστος υποδομής.

Γιατί να χρησιμοποιήσετε το Node.js SDK?

  • Zero‑install runtime – το SDK είναι μια ελαφριά επικάλυψη γύρω από το Assembly Cloud REST API, έτσι χρειάζεστε μόνο Node 12+ και ένα πακέτο npm.
  • Cross‑platform – λειτουργεί το ίδιο σε Windows, macOS, Linux ή μέσα σε containers.
  • Secure – όλη η επικοινωνία κρυπτογραφείται μέσω TLS, και η ταυτοποίηση γίνεται με το προσωπικό σας App SID και App Key.
  • Scalable – η υπηρεσία cloud μπορεί να διαχειριστεί αιτήματα ενός εγγράφου καθώς και εργασίες υψηλού όγκου batch Mail‑Merge.
  • Extensible – το ίδιο API μπορεί να χρησιμοποιηθεί από οποιαδήποτε γλώσσα που μπορεί να καλέσει endpoints REST· το Node.js SDK απλώς απλοποιεί τη δημιουργία αιτημάτων και τη διαχείριση απαντήσεων.

Τυπική ροή εργασίας σε μια εφαρμογή Node.js

  1. Προετοιμάστε ένα πρότυπο (DOCX, PPTX, κλπ.) που περιέχει πεδία placeholder και προαιρετικές δομές προγραμματισμού όπως conditional blocks, loops ή ετικέτες barcode.
  2. Δημιουργήστε μια πηγή δεδομένων σε XML ή JSON που παρέχει τις τιμές που θα συγχωνευτούν στο πρότυπο.
  3. Ανεβάστε το πρότυπο στο GroupDocs Cloud Storage χρησιμοποιώντας τη μέθοδο uploadFile του SDK.
  4. Ρυθμίστε το AssembleOptions – καθορίστε τη διαδρομή του προτύπου, την πηγή δεδομένων, τη μορφή εξόδου που επιθυμείτε (PDF, DOCX, HTML, …) και τυχόν πρόσθετες ρυθμίσεις (π.χ., δημιουργία barcode, χρώμα φόντου).
  5. Κλήση του assembleDocument – το SDK στέλνει ένα ενιαίο αίτημα HTTP που ενεργοποιεί τη διαδικασία συναρμολόγησης στον διακομιστή.
  6. Λάβετε το συναρμολογημένο αρχείο ως byte array, αποθηκεύστε το τοπικά ή ροήστε το απευθείας στον πελάτη.

Το παρακάτω παράδειγμα (παρουσιασμένο στην ενότητα More Feature) δείχνει καθένα από αυτά τα βήματα σε ένα σύντομο, έτοιμο για παραγωγή απόσπασμα κώδικα.

GroupDocs.Assembly Cloud API Λειτουργίες

Δημιουργήστε έγγραφα από πρότυπα χρησιμοποιώντας το cloud REST API

Δεσμεύσεις δεδομένων τύπου LINQ για πηγές XML και JSON

Εισαγάγετε εικόνες, διαγράμματα και εξωτερικό περιεχόμενο εγγράφου

Δυναμικοί πίνακες και λίστες από δεδομένα πίνακα

Προσθέστε υπερσυνδέσμους, σελιδοδείκτες και συνημμένα email

Εφαρμόστε τύπους και διαδοχικές λειτουργίες δεδομένων

Μπλοκ περιεχομένου με συνθήκες (IF‑ELSE) στα πρότυπα

Δημιουργήστε γραμμωτούς κώδικες (QR, Code128 κ.ά.)

Ορίστε χρώματα φόντου για την έξοδο HTML

Mail‑Merge για μαζικές προσωποποιημένες επιστολές

Δημιουργήστε μια αναφορά σε Node.js

Το παρακάτω απόσπασμα δείχνει μια πλήρη ροή: ανεβάστε ένα πρότυπο, διαβάστε ένα αρχείο δεδομένων JSON, διαμορφώστε το αίτημα συναρμολόγησης και λάβετε το συναρμολογημένο έγγραφο.

Βήματα

  1. Ανεβάστε το πρότυπο DOCX στο GroupDocs Cloud Storage.
  2. Διαβάστε το αρχείο δεδομένων JSON που περιέχει τις τιμές προς συγχώνευση.
  3. Διαμορφώστε το AssembleOptions – επιλέξτε τη μορφή εξόδου και συνδέστε τα δεδομένα.
  4. Καλέστε το assembleDocument για να δημιουργήσετε την αναφορά.
  5. Αποθηκεύστε τον επιστρεφόμενο πίνακα byte ως PDF (ή οποιαδήποτε υποστηριζόμενη μορφή).
// 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);

Πόροι υποστήριξης και μάθησης

GroupDocs.Assembly Cloud προσφέρει επίσης SDKs για άλλες γλώσσες:

  Ελληνικά
a5f9e0ced