Εγκατάσταση

Το πακέτο είναι available στο PyPI και μπορεί να εγκατασταθεί μέσω pip εκτελώντας την παρακάτω εντολή:

pip install groupdocs-assembly-cloud

Απαιτήσεις

• Python 3.4+
• pip διαχειριστής πακέτων
• Διαπιστευτήρια GroupDocs Cloud —Client ID and Client Secret από τον πίνακα ελέγχου

Εξαρτήσεις

Το SDK εγκαθιστά αυτόματα τα ακόλουθα πακέτα:

Document Automation Python Cloud REST API

GroupDocs.Assembly Cloud SDK for Python δίνει τη δυνατότητα στους προγραμματιστές να αυτοματοποιούν απρόσκοπτα τη δημιουργία πολύπλοκων εγγράφων όπως αναφορές, τιμολόγια και παρουσιάσεις. Αξιοποιήστε πρότυπα, συγχωνεύστε δεδομένα από πηγές JSON ή XML, εφαρμόστε εμπλουτισμένη μορφοποίηση και δημιουργήστε γραμμωτούς κώδικες και γραφήματα, όλα σε ένα επεκτάσιμο και ασφαλές περιβάλλον cloud. Αυτό το API απλοποιεί τις ροές εργασιών εγγράφων, ενισχύει την παραγωγικότητα και παρέχει συμβατότητα μεταξύ πλατφορμών για εύκολη ενσωμάτωση στις εφαρμογές Ιστού Python, τα σενάρια και τις ροές εργασίας αυτοματισμού.

Βασικά χαρακτηριστικά

Δημιουργία εγγράφων βάσει προτύπων - Δημιουργήστε σύνθετα έγγραφα Word, Excel, PowerPoint, PDF από πρότυπα.
Δυναμική συγχώνευση δεδομένων - Συμπληρώστε πρότυπα με δεδομένα JSON ή XML για προσαρμοσμένες αναφορές.
Πλούσια μορφοποίηση και στυλ - Εφαρμόστε προηγμένη μορφοποίηση σε κείμενο, πίνακες, γραφήματα για γυαλισμένα έγγραφα.
Έλεγχος περιεχομένου υπό όρους - Χρησιμοποιήστε λογική υπό όρους για να δημιουργήσετε δυναμικό περιεχόμενο με βάση δεδομένα.
Λίστα και Αυτοματισμός Πίνακα - Δημιουργήστε δυναμικές λίστες, πίνακες, γραφήματα που ενημερώνονται αυτόματα βάσει δεδομένων.

Προηγμένες δυνατότητες

Δημιουργία γραμμωτού κώδικα - Ενσωματώστε γραμμικούς κώδικες απευθείας σε έγγραφα.
Εισαγωγή υπερσυνδέσμου - Προσθέστε συνδέσμους με δυνατότητα κλικ σε εξωτερικούς πόρους ή εντός εγγράφου.
Δημιουργία σελιδοδεικτών - Δημιουργήστε σελιδοδείκτες για εύκολη πλοήγηση.
Χειρισμός πλαισίου ελέγχου - Ρυθμίστε δυναμικά τις τιμές πλαισίου ελέγχου βάσει δεδομένων.
Λειτουργικότητα συγχώνευσης αλληλογραφίας - Δημιουργήστε εξατομικευμένα email και συνημμένα σε κλίμακα.
Υπολογισμοί τύπου - Εκτελέστε υπολογισμούς σε υπολογιστικά φύλλα για δυναμικά αποτελέσματα.

Εργασία με δεδομένα

Φιλτράρισμα δεδομένων - Εφαρμόστε φίλτρα για να επιλέξετε συγκεκριμένα υποσύνολα δεδομένων για αναφορές.
Ταξινόμηση Δεδομένων - Τακτοποιήστε τα δεδομένα με συγκεκριμένη σειρά (αύξουσα/καθοδική) βάσει κριτηρίων.
Ομαδοποίηση δεδομένων - Οργανώστε τα δεδομένα σε ομάδες για ευκολότερη ανάλυση και παρουσίαση.
Μορφοποίηση δεδομένων - Έλεγχος εμφάνισης δεδομένων σε αναφορές, π.χ. αριθμός, ημερομηνία, μορφοποίηση κειμένου.
Χρήση μεταβλητών - Αποθηκεύστε και επαναχρησιμοποιήστε τις τιμές σε ένα πρότυπο για αποτελεσματική επεξεργασία.
Χρήση μεθόδων επέκτασης - Αξιοποιήστε τις ενσωματωμένες συναρτήσεις για πολύπλοκους χειρισμούς εντός προτύπων.

Εργασία με λίστες, πίνακες και γραφήματα

Δυναμική δημιουργία λιστών - Δημιουργήστε λίστες εντός παραγράφου, με κουκκίδες, αριθμημένες λίστες με δυναμικό περιεχόμενο.
Δυναμική Δημιουργία Πίνακα - Δημιουργήστε πίνακες με δυναμικό περιεχόμενο, υπολογισμούς και μορφοποίηση.
Δημιουργία γραφήματος - Δημιουργήστε γραφήματα γραμμής, στήλης, ράβδου, πίτας, scatter, συννεφάκι με δυναμικά δεδομένα.
Προσαρμογή γραφήματος - Προσαρμόστε τίτλους γραφημάτων, σειρές, τίτλους αξόνων, μύθους μέσω εκφράσεων.
Σειρά γραφημάτων υπό όρους - Συμπεριλάβετε/εξαιρέστε υπό όρους σειρές γραφημάτων βάσει συνθηκών.

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

Εισαγωγή υπερσυνδέσμων - Εισαγάγετε υπερσυνδέσμους σε έγγραφα Word, email, υπολογιστικού φύλλου και παρουσίασης.
Δυναμική εισαγωγή σελιδοδεικτών - Προσθέστε σελιδοδείκτες σε έγγραφα/email και ορίστε ονόματα για πλοήγηση.
Έλεγχος κατάστασης πλαισίου ελέγχου - Ορίστε τα πλαίσια ελέγχου επιλεγμένα/αποεπιλεγμένα στα έγγραφα του Word χρησιμοποιώντας ετικέτα ελέγχου.
Δημιουργία εικόνας γραμμικού κώδικα - Δημιουργήστε και εισαγάγετε QR, DataMatrix, UPC, EAN, ISBN, PDF417 και πολλούς άλλους τύπους γραμμωτού κώδικα.

Λειτουργίες φιλικές προς τους προγραμματιστές

Αρχιτεκτονική REST API - Αξιοποιήστε το REST για εύκολη ενσωμάτωση και επεκτασιμότητα.
Ολοκληρωμένη τεκμηρίωση - Πρόσβαση σε λεπτομερείς αναφορές API, παραδείγματα κώδικα, σεμινάρια.
Ενεργή υποστήριξη κοινότητας - Λάβετε βοήθεια από το ενεργό φόρουμ κοινότητας και την αποκλειστική υποστήριξη.
Ευελιξία με βάση το cloud - Απολαύστε επεκτασιμότητα και αξιοπιστία της επεξεργασίας που βασίζεται σε σύννεφο.
JWT Authentication - Ασφαλίστε δεδομένα και αιτήματα API με έλεγχο ταυτότητας JWT.

Αδειοδότηση και έλεγχος ταυτότητας

Λειτουργία αξιολόγησης - Δοκιμάστε το API με έναν δωρεάν δοκιμαστικό λογαριασμό.
Ασφαλής έλεγχος ταυτότητας - Χρησιμοποιήστε το Client ID και το Client Secret για ασφαλή πρόσβαση στο API.
Άδεια MIT - Το Python SDK έχει άδεια χρήσης σύμφωνα με το MIT License.

Υποστηριζόμενες μορφές αρχείων

Το GroupDocs.Assembly Cloud υποστηρίζει τη δημιουργία και τη μετατροπή βάσει προτύπων σε ένα ευρύ φάσμα τύπων εγγράφων:

• Επεξεργασία κειμένου: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MD, TXT, MHTML, MHT
• Υπολογιστικά φύλλα: XLS, XLSX, XLSM, XLTX, XLTM, XLSB, ODS
• Παρουσιάσεις: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
• Email: MSG, EML, EMLX
• Ιστός και άλλα: PDF, EPUB, XPS, OXPS, TIFF, SVG, XAML

Οι υποστηριζόμενες μορφές εξόδου διαφέρουν ανάλογα με τον τύπο προτύπου πηγής. Για την πλήρη μήτρα μορφής, δείτε το documentation.

Γρήγορη εκκίνηση

Λάβετε τα διαπιστευτήρια API σας

Για να χρησιμοποιήσετε το GroupDocs.Assembly Cloud, εγγραφείτε στο GroupDocs.Cloud Dashboard και λάβετε το Client ID και το Client Secret.

Εκκινήστε το API

Χρησιμοποιήστε τον ακόλουθο κώδικα για να ξεκινήσετε να χρησιμοποιείτε το GroupDocs.Assembly Cloud SDK για Python:

import groupdocsassemblycloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instance of the Assembly API
assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

Συναρμολόγηση εγγράφου από πρότυπο και δεδομένα JSON

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

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

# Upload the template file to cloud storage
with open("template.docx", "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, path="template.docx")
    assembly_api.upload_file(upload_request)

# Read JSON data source
with open("data.json") as f:
    data = f.read()

template_file_info = groupdocsassemblycloud.TemplateFileInfo("template.docx")
options = groupdocsassemblycloud.AssembleOptions(template_file_info, save_format="docx", report_data=data)
request = requests.AssembleDocumentRequest(options)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

Με αυτόν τον οδηγό γρήγορης εκκίνησης, είστε έτοιμοι να ξεκινήσετε την αυτοματοποίηση της δημιουργίας εγγράφων χρησιμοποιώντας το GroupDocs.Assembly Cloud στις εφαρμογές Python σας. Για περισσότερες λεπτομέρειες, επισκεφθείτε το documentation.

Συναρμολόγηση εγγράφου σε PDF

Δημιουργήστε μια αναφορά PDF από ένα πρότυπο OpenDocument και δεδομένα JSON.

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

filename = "TableFeatures.odt"
remote_name = "GroupDocs.Assembly/TableFeatures.odt"

with open("TableData.json") as f:
    data = f.read()

with open(filename, "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, remote_name)
    assembly_api.upload_file(upload_request)

template_file_info = groupdocsassemblycloud.TemplateFileInfo(remote_name)
assemble_data = groupdocsassemblycloud.AssembleOptions(template_file_info, "pdf", data)
request = requests.AssembleDocumentRequest(assemble_data)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

Λάβετε υποστηριζόμενες μορφές αρχείων

Ανακτήστε την πλήρη λίστα των υποστηριζόμενων μορφών αρχείων που είναι διαθέσιμες μέσω του Assembly API.

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

result = assembly_api.get_supported_file_formats(requests.GetSupportedFileFormatsRequest())

for fmt in result.formats:
    print(fmt.file_format)

Δείγματα έργων στο GitHub

Ο GroupDocs.Assembly Cloud Python SDK Το αποθετήριο περιλαμβάνει έτοιμες προς εκτέλεση δοκιμές μονάδων και παραδείγματα που καλύπτουν:

Πώς να εκτελέσετε τα παραδείγματα

1. Κλωνοποιήστε ή κατεβάστε το SDK repository2. Επεξεργασία Settings/servercreds.json και ρυθμίστε το δικό σας AppSid και AppKey3. Εγκαταστήστε εξαρτήσεις:pip install groupdocs-assembly-cloud -U4. Εκτελέστε δοκιμές από τη ρίζα του αποθετηρίου:python -m unittest discover -s test

Για περισσότερες λεπτομέρειες, επισκεφθείτε Getting Started.

Ετικέτες

Document Automation | Python Cloud API | GroupDocs.Assembly Cloud | REST API | Document Generation | Template-Driven | Dynamic Data Merging | Rich Formatting | Conditional Content Control | List Automation | Table Automation | Barcode Generation | Hyperlink Insertion | Bookmark Creation | Checkbox Manipulation | Mail Merge | Formula Calculations | Chart Generation | Data Filtering | Data Sorting | Data Grouping | JWT Authentication | Microsoft Word | Microsoft Excel | Microsoft PowerPoint | Report Generation | Cloud-Based Flexibility | Secure API Access | Cross-platform API