Bibliothèque Python pour créer des rapports hautement personnalisés à l’aide de l’API REST
Commencer l'essai gratuitLe SDK Cloud GroupDocs.Assembly pour Python permet aux développeurs d’automatiser la création de documents riches en format, tels que des contrats, des factures, des rapports d’expédition, des propositions commerciales, des inventaires et bien d’autres documents stratégiques. Entièrement basée sur le cloud, la solution est accessible via une API REST. Ainsi, toute application Python capable d’envoyer des requêtes HTTP peut générer des documents à la demande sans installer de logiciel côté serveur ni d’outils tiers.
La plateforme fonctionne essentiellement avec des modèles de documents contenant des champs d’espace réservé et des constructions de programmation spécifiques. Ces espaces réservés sont automatiquement remplacés par des valeurs issues d’une source de données (XML ou JSON) à l’aide d’une syntaxe d’expression de type LINQ. Cette approche puissante permet d’intégrer des images, des graphiques et des codes-barres, de définir des couleurs d’arrière-plan pour la sortie HTML, de créer des tableaux et des listes dynamiques à partir de données de tableau, et d’appliquer une logique conditionnelle pour inclure ou exclure des sections du document. Le SDK prenant en charge un large éventail de formats d’entrée et de sortie, vous pouvez générer un PDF à partir d’un modèle DOCX, produire des rapports HTML ou générer des fichiers OpenDocument sans conversion supplémentaire.
Le workflow Python classique se compose de trois étapes simples :
1️⃣ Créer un modèle : concevoir un fichier Word, Excel, PowerPoint ou tout autre fichier Office/OpenOffice pris en charge, puis insérer des champs d’espace réservé et des règles de génération.
2️⃣ Préparer une source de données : fournir vos données au format XML ou JSON, en respectant les espaces réservés définis dans le modèle.
3️⃣ Écrire quelques lignes de code Python : utiliser le package groupdocsassemblycloud
pour importer le modèle dans GroupDocs Cloud Storage, transmettre la source de données avec le format de sortie souhaité et invoquer l’opération AssembleDocument
. L’API renvoie le document assemblé directement dans la réponse ou le stocke dans le Cloud pour une récupération ultérieure.
Toutes les interactions sont sécurisées par chiffrement SSL/TLS, et l’authentification s’effectue via votre SID et votre clé d’application personnels. Vos documents et données restent ainsi protégés pendant leur traitement dans le cloud. La multiplateforme du SDK vous permet d’intégrer la génération de documents à des services web, des traitements par lots, des applications de bureau ou des fonctions sans serveur, pour une production instantanée et fiable de documents imprimables, prêts pour le web ou l’e-mail.
Cet exemple Python montre comment importer un modèle, lier un fichier de données et générer un document de sortie à l’aide du SDK GroupDocs Assembly Cloud.
Étapes :
import groupdocsassemblycloud
# Initialize API client (replace with your credentials)
assembly_api = groupdocsassemblycloud.AssemblyApi('......##', '......##')
# 1️⃣ Upload the template
file_name = 'Input1.docx'
with open(file_name, 'rb') as request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ Load data source (could be XML, JSON or DOCX)
data_file = 'Input2.docx'
with open(data_file, 'rb') as data:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(file_name)
# 3️⃣ Set assemble options (output format: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ Assemble the document
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("Document generated successfully:", result.path)