Installation

Das Paket ist verfügbar bei PyPI und kann über pip mit folgendem Befehl installiert werden:

pip install groupdocs-assembly-cloud

Anforderungen

• Python 3.4+
• pip Paketmanager
• GroupDocs Cloud-Anmeldeinformationen — Client ID and Client Secret vom Dashboard

Abhängigkeiten

Das SDK installiert automatisch die folgenden Pakete:

Dokumentautomatisierung Python Cloud REST API

GroupDocs.Assembly Cloud SDK für Python ermöglicht Entwicklern die nahtlose Automatisierung der Erstellung komplexer Dokumente wie Berichte, Rechnungen und Präsentationen. Nutzen Sie Vorlagen, führen Sie Daten aus JSON- oder XML-Quellen zusammen, wenden Sie umfangreiche Formatierungen an und generieren Sie Barcodes und Diagramme – alles in einer skalierbaren und sicheren Cloud-Umgebung. Diese API optimiert Dokument-Workflows, steigert die Produktivität und bietet plattformübergreifende Kompatibilität für eine mühelose Integration in Ihre Python-Web-Apps, Skripte und Automatisierungs-Workflows.

Kernfunktionen

Vorlagengesteuerte Dokumentenerstellung - Erstellen Sie komplexe Word-, Excel-, PowerPoint- und PDF-Dokumente aus Vorlagen.
Dynamische Datenzusammenführung - Füllen Sie Vorlagen mit JSON- oder XML-Daten für benutzerdefinierte Berichte.
Umfassende Formatierung und Stilisierung - Wenden Sie erweiterte Formatierungen auf Texte, Tabellen und Diagramme an.
Bedingte Inhaltskontrolle - Verwenden Sie bedingte Logik, um dynamische Inhalte basierend auf Daten zu generieren.
Listen- und Tabellenautomatisierung - Erstellen Sie dynamische Listen, Tabellen und Diagramme, die basierend auf Daten automatisch aktualisiert werden.

Erweiterte Funktionen

Barcode-Generierung - Betten Sie Barcodes direkt in Dokumente ein.
Hyperlink-Einfügung - Fügen Sie anklickbare Links zu externen Ressourcen oder innerhalb des Dokuments hinzu.
Lesezeichenerstellung - Erstellen Sie Lesezeichen für eine einfache Navigation.
Checkbox-Manipulation - Legen Sie Kontrollkästchenwerte dynamisch basierend auf Daten fest.
Mail-Merge-Funktionalität - Erstellen Sie personalisierte E-Mails und Anhänge in großem Maßstab.
Formelberechnungen - Führen Sie Berechnungen in Tabellenkalkulationen durch, um dynamische Ergebnisse zu erhalten.

Mit Daten arbeiten

Datenfilterung - Wenden Sie Filter an, um bestimmte Datenteilmengen für Berichte auszuwählen.
Datensortierung - Ordnen Sie Daten basierend auf Kriterien in einer bestimmten Reihenfolge (auf/ab) an.
Datengruppierung - Organisieren Sie Daten zur einfacheren Analyse und Präsentation in Gruppen.
Datenformatierung - Steuern Sie das Erscheinungsbild von Daten in Berichten, z. B. Nummer, Datum, Textformatierung.
Verwendung von Variablen - Speichern und wiederverwenden Sie Werte in einer Vorlage für eine effiziente Verarbeitung.
Verwendung von Erweiterungsmethoden - Nutzen Sie integrierte Funktionen für komplexe Manipulationen innerhalb von Vorlagen.

Arbeiten mit Listen, Tabellen und Diagrammen

Dynamische Listenerstellung - Generieren Sie absatzbasierte, nummerierte Listen mit Aufzählungszeichen und dynamischem Inhalt.
Dynamische Tabellengenerierung - Generieren Sie Tabellen mit dynamischen Inhalten, Berechnungen und Formatierungen.
Diagrammerstellung - Erstellen Sie Linien-, Säulen-, Balken-, Kreis-, Streu- und Blasendiagramme mit dynamischen Daten.
Diagrammanpassung - Passen Sie Diagrammtitel, Reihen, Achsentitel und Legenden über Ausdrücke an.
Bedingte Diagrammreihen - Schließen Sie Diagrammreihen basierend auf Bedingungen bedingt ein oder aus.

Arbeiten mit Hyperlinks, Lesezeichen und Barcodes

Hyperlinks einfügen - Fügen Sie Hyperlinks in Word-, E-Mail-, Tabellenkalkulations- und Präsentationsdokumente ein.
Dynamisches Einfügen von Lesezeichen - Fügen Sie Lesezeichen zu Dokumenten/E-Mails hinzu und definieren Sie Namen für die Navigation.
Checkbox-Statuskontrolle - Aktivieren/deaktivieren Sie Kontrollkästchen in Word-Dokumenten mithilfe von Check-Tags.
Barcode-Bildgenerierung - Generieren und fügen Sie QR-, DataMatrix-, UPC-, EAN-, ISBN-, PDF417- und viele andere Barcode-Typen ein.

Entwicklerfreundliche Funktionen

REST API Architecture - Nutzen Sie REST für einfache Integration und Skalierbarkeit.
Umfassende Dokumentation - Greifen Sie auf detaillierte API-Referenzen, Codebeispiele und Tutorials zu.
Aktiver Community-Support - Erhalten Sie Hilfe vom aktiven Community-Forum und engagiertem Support.
Cloud-Based Flexibility - Genießen Sie die Skalierbarkeit und Zuverlässigkeit der cloudbasierten Verarbeitung.
JWT Authentication - Sichern Sie Daten und API-Anfragen mit JWT-Authentifizierung.

Lizenzierung und Authentifizierung

Evaluierungsmodus - Testen Sie die API mit einem kostenlosen Testkonto.
Sichere Authentifizierung - Verwenden Sie Client ID und Client Secret für sicheren API-Zugriff.
MIT License - Das Python SDK ist unter der MIT License lizenziert.

Unterstützte Dateiformate

GroupDocs.Assembly Cloud unterstützt die vorlagengesteuerte Generierung und Konvertierung für eine Vielzahl von Dokumenttypen:

• Textverarbeitung: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MD, TXT, MHTML, MHT
• Tabellenkalkulationen: XLS, XLSX, XLSM, XLTX, XLTM, XLSB, ODS
• Präsentationen: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
• E-Mail: MSG, EML, EMLX
• Web und andere: PDF, EPUB, XPS, OXPS, TIFF, SVG, XAML

Die unterstützten Ausgabeformate variieren je nach Quellvorlagentyp. Die vollständige Formatmatrix finden Sie in der Dokumentation.

Schnellstart

API-Anmeldeinformationen abrufen

Um GroupDocs.Assembly Cloud zu verwenden, registrieren Sie sich im GroupDocs.Cloud Dashboard und holen Sie sich Ihre Client ID und Ihr Client Secret.

API initialisieren

Verwenden Sie den folgenden Code, um mit der Verwendung des GroupDocs.Assembly Cloud SDK für Python zu beginnen:

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"

Dokument aus Vorlage und JSON-Daten zusammenstellen

Verwenden Sie nach der Initialisierung dieses einfache Beispiel, um ein Dokument aus einer Vorlage und einer JSON-Datenquelle zu generieren:

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)))

Mit dieser Kurzanleitung können Sie mit der Automatisierung der Dokumentgenerierung mithilfe von GroupDocs.Assembly Cloud in Ihren Python-Anwendungen beginnen. Weitere Informationen finden Sie in der Dokumentation.

Dokument zu PDF zusammenstellen

Generieren Sie einen PDF-Bericht aus einer OpenDocument-Vorlage und JSON-Daten.

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)))

Unterstützte Dateiformate abrufen

Rufen Sie die vollständige Liste der über die Assembly API verfügbaren unterstützten Dateiformate ab.

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)

Beispielprojekte auf GitHub

Das GroupDocs.Assembly Cloud Python SDK-Repository enthält betriebsbereite Unit-Tests und Beispiele zu folgenden Themen:

So führen Sie die Beispiele aus

1. Klonen oder laden Sie das SDK-Repository herunter
2. Bearbeiten Sie Settings/servercreds.json und setzen Sie Ihre AppSid und AppKey
3. Installieren Sie Abhängigkeiten: pip install groupdocs-assembly-cloud -U
4. Führen Sie Tests im Repository-Stammverzeichnis aus: python -m unittest discover -s test

Weitere Informationen finden Sie unter Erste Schritte.

Tags

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