Node.js SDK για Συναρμολόγηση Εγγράφων και Δημιουργία Αναφορών
Ενσωματώστε ισχυρές δυνατότητες συναρμολόγησης εγγράφων στις εφαρμογές Node χρησιμοποιώντας το GroupDocs.Assembly Cloud REST API.
Ενσωματώστε ισχυρές δυνατότητες συναρμολόγησης εγγράφων στις εφαρμογές Node χρησιμοποιώντας το GroupDocs.Assembly Cloud REST API.
Το GroupDocs.Assembly Cloud είναι μια πλήρως διαχειριζόμενη υπηρεσία βασισμένη σε REST που επιτρέπει στους προγραμματιστές να δημιουργούν πλούσια μορφοποιημένα, έτοιμα για εκτύπωση έγγραφα από επαναχρησιμοποιήσιμα πρότυπα και εξωτερικές πηγές δεδομένων.
Η πλατφόρμα υποστηρίζει μια μεγάλη ποικιλία μορφών πηγής και προορισμού – από κλασικά αρχεία του Microsoft Office (DOCX, XLSX, PPTX) έως PDF, HTML, OpenDocument και πολλές γραφικές μορφές – επιτρέποντάς σας να δημιουργείτε συμβόλαια, τιμολόγια, αναφορές, φυλλάδια μάρκετινγκ ή οποιοδήποτε προσαρμοσμένο έγγραφο χωρίς να εγκαταστήσετε λογισμικό τρίτων στους δικούς σας διακομιστές. Όλη η βαριά δουλειά – ανάλυση προτύπων, σύνδεση δεδομένων, απόδοση εικόνων, δημιουργία γραμμωτού κώδικα, αξιολόγηση τύπων και μετατροπή αρχείων – εκτελείται στο cloud, γεγονός που διασφαλίζει συνεπή αποτελέσματα σε όλα τα λειτουργικά συστήματα και μειώνει το κόστος υποδομής.
Γιατί να χρησιμοποιήσετε το Node.js SDK;
Τυπική ροή εργασίας σε μια εφαρμογή Node.js
Προετοιμάστε ένα πρότυπο (DOCX, PPTX, κ.λπ.) που περιέχει πεδία κράτησης θέσης και προαιρετικές δομές προγραμματισμού, όπως μπλοκ υπό όρους, βρόχους ή ετικέτες γραμμωτού κώδικα.
Δημιουργήστε μια πηγή δεδομένων σε XML ή JSON που παρέχει τις τιμές που θα συγχωνευθούν στο πρότυπο.
Μεταφορτώστε το πρότυπο στο GroupDocs Cloud Storage χρησιμοποιώντας τη μέθοδο uploadFile του SDK.
Ρύθμιση παραμέτρων του AssembleOptions – καθορίστε τη διαδρομή του προτύπου, την πηγή δεδομένων, την επιθυμητή μορφή εξόδου (PDF, DOCX, HTML, …) και τυχόν πρόσθετες ρυθμίσεις (π.χ., δημιουργία γραμμωτού κώδικα, χρώμα φόντου).
Κλήση του assembleDocument – το SDK στέλνει ένα μόνο αίτημα HTTP που ενεργοποιεί τη διαδικασία συναρμολόγησης στον διακομιστή.
Λάβετε το συναρμολογημένο αρχείο ως πίνακα byte, αποθηκεύστε το τοπικά ή μεταδώστε το απευθείας στον πελάτη.
Το ακόλουθο παράδειγμα (εμφανίζεται στην ενότητα Περισσότερα χαρακτηριστικά) δείχνει καθένα από αυτά τα βήματα σε ένα συμπαγές, έτοιμο για παραγωγή απόσπασμα κώδικα.
Βασικές δυνατότητες του Assembly Cloud API.
Υποστηριζόμενες μορφές εγγράφων για το Assembly Cloud API.
Υποστηριζόμενα λειτουργικά συστήματα και περιβάλλοντα ανάπτυξης.
Το παρακάτω απόσπασμα παρουσιάζει μια πλήρη ροή: μεταφόρτωση ενός προτύπου, ανάγνωση ενός αρχείου δεδομένων JSON, διαμόρφωση του αιτήματος συναρμολόγησης και λήψη του συναρμολογημένου εγγράφου.
Βήματα
Μεταφόρτωση του προτύπου DOCX στο GroupDocs Cloud Storage.
Διαβάστε το αρχείο δεδομένων JSON που περιέχει τις τιμές που θα συγχωνευθούν.
Διαμόρφωση του AssembleOptions – επιλέξτε τη μορφή εξόδου και συνδέστε τα δεδομένα.
Καλέστε το assembleDocument για να δημιουργήσετε την αναφορά.
Αποθήκευση του επιστρεφόμενου πίνακα byte ως PDF (ή οποιαδήποτε υποστηριζόμενη μορφή).
``node // Αντικαταστήστε με το App SID και το App Key σας const { AssemblyApi, AssembleDocumentRequest, AssembleOptions, TemplateFileInfo, model } = require(“groupdocs-assembly-cloud”); const fs = require(“fs”); const path = require(“path”);
// Θέση εξουσιοδότησης const assemblyApi = new AssemblyApi(".#-.#-.#-.#-.#", “……”);
// 1️⃣ Μεταφόρτωση του αρχείου προτύπου const templatePath = “Input1.docx”; const uploadRequest = new model.UploadFileRequest({ fileContent: fs.createReadStream(templatePath), path: templatePath }); αναμονή assemblyApi.uploadFile(uploadRequest);
// 2️⃣ Ανάγνωση της πηγής δεδομένων (JSON) const dataPath = “Input2.docx”; const reportData = fs.readFileSync(dataPath, “utf8”);
// 3️⃣ Ορισμός επιλογών συναρμολόγησης const assembleOptions = new AssembleOptions({ saveFormat: “pdf”, reportData: reportData, templateFileInfo: new TemplateFileInfo({ filePath: templatePath }) });
// 4️⃣ Δημιουργία και αποστολή του αιτήματος συναρμολόγησης const request = new AssembleDocumentRequest({ assembleOptions });
const result = await assemblyApi.assembleDocument(request);
// 5️⃣ Αποθήκευση του εγγράφου που προκύπτει const outputPath = path.join(__dirname, “GeneratedReport.pdf”); fs.writeFileSync(outputPath, result.body);
console.log(“Η αναφορά δημιουργήθηκε με επιτυχία:”, outputPath);
GroupDocs.Assembly