Installation

Le package est disponible sur PyPI et peut être installé via pip en exécutant la commande suivante :

pip install groupdocs-assembly-cloud

Prérequis

• Python 3.4+
• Gestionnaire de packages pip
• Identifiants GroupDocs Cloud — Client ID et Client Secret depuis le Dashboard

Dépendances

Le SDK installe automatiquement les packages suivants :

API REST Cloud Python d’automatisation de documents

GroupDocs.Assembly Cloud SDK pour Python permet aux développeurs d’automatiser en toute simplicité la création de documents complexes tels que des rapports, des factures et des présentations. Exploitez des modèles, fusionnez des données provenant de sources JSON ou XML, appliquez une mise en forme avancée et générez des codes-barres et des graphiques, le tout dans un environnement cloud évolutif et sécurisé. Cette API simplifie les flux de travail documentaires, améliore la productivité et offre une compatibilité multiplateforme pour une intégration aisée dans vos applications web Python, scripts et flux d’automatisation.

Fonctionnalités principales

Génération de documents basée sur des modèles - Créez des documents Word, Excel, PowerPoint et PDF complexes à partir de modèles.
Fusion dynamique de données - Remplissez des modèles avec des données JSON ou XML pour des rapports personnalisés.
Mise en forme et style avancés - Appliquez une mise en forme avancée au texte, aux tableaux et aux graphiques pour des documents soignés.
Contrôle conditionnel du contenu - Utilisez une logique conditionnelle pour générer du contenu dynamique basé sur les données.
Automatisation des listes et des tableaux - Créez des listes, tableaux et graphiques dynamiques qui se mettent à jour automatiquement en fonction des données.

Fonctionnalités avancées

Génération de codes-barres - Intégrez des codes-barres directement dans les documents.
Insertion d’hyperliens - Ajoutez des liens cliquables vers des ressources externes ou au sein du document.
Création de signets - Créez des signets pour une navigation facile.
Manipulation des cases à cocher - Définissez dynamiquement les valeurs des cases à cocher en fonction des données.
Fonctionnalité de publipostage - Générez des e-mails et des pièces jointes personnalisés à grande échelle.
Calculs de formules - Effectuez des calculs dans les feuilles de calcul pour des résultats dynamiques.

Travail avec les données

Filtrage des données - Appliquez des filtres pour sélectionner des sous-ensembles de données spécifiques pour les rapports.
Tri des données - Organisez les données dans un ordre spécifique (asc/desc) selon des critères.
Regroupement des données - Organisez les données en groupes pour faciliter l’analyse et la présentation.
Formatage des données - Contrôlez l’apparence des données dans les rapports, par ex. formatage des nombres, dates et textes.
Utilisation de variables - Stockez et réutilisez des valeurs dans un modèle pour un traitement efficace.
Utilisation de méthodes d’extension - Exploitez les fonctions intégrées pour des manipulations complexes au sein des modèles.

Travail avec les listes, tableaux et graphiques

Génération dynamique de listes - Générez des listes dans le paragraphe, à puces ou numérotées avec du contenu dynamique.
Génération dynamique de tableaux - Générez des tableaux avec du contenu dynamique, des calculs et une mise en forme.
Génération de graphiques - Créez des graphiques linéaires, en colonnes, en barres, circulaires, en nuage de points et en bulles avec des données dynamiques.
Personnalisation des graphiques - Personnalisez les titres, séries, titres d’axes et légendes des graphiques via des expressions.
Séries de graphiques conditionnelles - Incluez ou excluez conditionnellement des séries de graphiques selon des conditions.

Travail avec les hyperliens, signets et codes-barres

Insertion d’hyperliens - Insérez des hyperliens dans des documents Word, e-mail, feuilles de calcul et présentations.
Insertion dynamique de signets - Ajoutez des signets aux documents/e-mails et définissez des noms pour la navigation.
Contrôle de l’état des cases à cocher - Cochez ou décochez des cases à cocher dans les documents Word à l’aide de la balise check.
Génération d’images de codes-barres - Générez et insérez des QR, DataMatrix, UPC, EAN, ISBN, PDF417 et de nombreux autres types de codes-barres.

Fonctionnalités adaptées aux développeurs

Architecture REST API - Exploitez REST pour une intégration et une évolutivité faciles.
Documentation complète - Accédez à des références API détaillées, des exemples de code et des tutoriels.
Support communautaire actif - Obtenez de l’aide auprès du forum communautaire actif et du support dédié.
Flexibilité basée sur le cloud - Profitez de l’évolutivité et de la fiabilité du traitement cloud.
Authentification JWT - Sécurisez les données et les requêtes API avec l’authentification JWT.

Licence et authentification

Mode d’évaluation - Essayez l’API avec un compte d’essai gratuit.
Authentification sécurisée - Utilisez Client ID et Client Secret pour un accès API sécurisé.
Licence MIT - Le SDK Python est sous licence MIT License.

Formats de fichiers pris en charge

GroupDocs.Assembly Cloud prend en charge la génération et la conversion basées sur des modèles pour une large gamme de types de documents :

• Traitement de texte : DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MD, TXT, MHTML, MHT
• Feuilles de calcul : XLS, XLSX, XLSM, XLTX, XLTM, XLSB, ODS
• Présentations : PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
• E-mail : MSG, EML, EMLX
• Web et autres : PDF, EPUB, XPS, OXPS, TIFF, SVG, XAML

Les formats de sortie pris en charge varient selon le type de modèle source. Pour la matrice complète des formats, consultez la documentation.

Démarrage rapide

Obtenez vos identifiants API

Pour utiliser GroupDocs.Assembly Cloud, inscrivez-vous sur le GroupDocs.Cloud Dashboard et obtenez votre Client ID et votre Client Secret.

Initialiser l’API

Utilisez le code suivant pour commencer à utiliser GroupDocs.Assembly Cloud SDK pour 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"

Assembler un document à partir d’un modèle et de données JSON

Une fois initialisé, utilisez cet exemple de base pour générer un document à partir d’un modèle et d’une source de données 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)))

Avec ce guide de démarrage rapide, vous êtes prêt à commencer l’automatisation de la génération de documents avec GroupDocs.Assembly Cloud dans vos applications Python. Pour plus de détails, consultez la documentation.

Assembler un document en PDF

Générez un rapport PDF à partir d’un modèle OpenDocument et de données 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)))

Obtenir les formats de fichiers pris en charge

Récupérez la liste complète des formats de fichiers pris en charge via l’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)

Projets d’exemple sur GitHub

Le dépôt GroupDocs.Assembly Cloud Python SDK inclut des tests unitaires et des exemples prêts à l’emploi couvrant :

Comment exécuter les exemples

1. Clonez ou téléchargez le dépôt SDK
2. Modifiez Settings/servercreds.json et définissez votre AppSid et AppKey
3. Installez les dépendances : pip install groupdocs-assembly-cloud -U
4. Exécutez les tests depuis la racine du dépôt : python -m unittest discover -s test

Pour plus de détails, consultez Getting Started.

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