Libreria Python per creare report altamente personalizzati utilizzando l’API REST
Inizia la prova gratuitaGroupDocs.Assembly Cloud SDK per Python consente agli sviluppatori di automatizzare la creazione di documenti riccamente formattati come contratti, fatture, report di spedizione, proposte di vendita, inventari e molti altri elementi critici per l’azienda. La soluzione è completamente basata sul cloud e accessibile tramite un’API REST, il che significa che qualsiasi applicazione Python in grado di inviare richieste HTTP può generare documenti on-demand senza installare software lato server o strumenti di terze parti.
Al suo interno, la piattaforma funziona con modelli di documento che contengono campi segnaposto speciali e costrutti di programmazione. Questi segnaposto vengono automaticamente sostituiti con valori tratti da una fonte dati (XML o JSON) utilizzando una sintassi di espressione in stile LINQ. Questo potente approccio consente di incorporare immagini, grafici, codici a barre, impostare colori di sfondo per l’output HTML, creare tabelle ed elenchi dinamici da dati array e applicare la logica condizionale per includere o escludere sezioni del documento. Poiché l’SDK supporta un’ampia gamma di formati di input e output, è possibile generare un PDF da un modello DOCX, produrre report HTML o generare file OpenDocument senza ulteriori passaggi di conversione.
Il flusso di lavoro tipico in Python consiste in tre semplici passaggi:
1️⃣ Creare un modello: progettare un file Word, Excel, PowerPoint o qualsiasi file Office/OpenOffice supportato e inserire campi segnaposto e regole di generazione.
2️⃣ Preparare una fonte dati: fornire i dati in formato XML o JSON, corrispondenti ai segnaposto definiti nel modello.
3️⃣ Scrivere alcune righe di codice Python: utilizzare il pacchetto groupdocsassemblycloud per caricare il modello su GroupDocs Cloud Storage, passare la fonte dati insieme al formato di output desiderato e richiamare l’operazione AssembleDocument. L’API restituisce il documento assemblato direttamente nella risposta o lo memorizza nel Cloud per un successivo recupero.
Tutte le interazioni sono protette dalla crittografia SSL/TLS e l’autenticazione viene eseguita tramite il tuo App SID e App Key personali. Questo garantisce che i tuoi documenti e dati rimangano protetti durante l’elaborazione nel cloud. La natura multipiattaforma dell’SDK consente di integrare la generazione di documenti in servizi web, processi batch, applicazioni desktop o funzioni serverless, fornendo documenti stampabili, pronti per il web o per l’invio tramite e-mail in modo istantaneo e affidabile.
Questo esempio Python mostra come caricare un modello, associare un file di dati e generare un documento di output utilizzando GroupDocs Assembly Cloud SDK.
Passaggi
AssemblyApi con il SID e la chiave dell’app.TemplateFileInfo e AssembleOptions.assemble_document per generare il risultato.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)