Biblioteca Python para crear informes altamente personalizados usando REST API
Empiza la prueba gratuitaGroupDocs.Assembly Cloud SDK para Python permite a los desarrolladores automatizar la creación de documentos con formato rico, como contratos, facturas, informes de envíos, propuestas de ventas, inventarios y muchos otros artefactos críticos para el negocio. La solución es completamente basada en la nube y se accede a través de un REST API, lo que significa que cualquier aplicación Python capaz de enviar solicitudes HTTP puede generar documentos bajo demanda sin instalar software del lado del servidor ni herramientas de terceros.
En su núcleo, la plataforma trabaja con plantillas de documentos que contienen campos de marcador de posición especiales y construcciones de programación. Estos marcadores se reemplazan automáticamente con valores extraídos de una fuente de datos (XML o JSON) mediante una sintaxis de expresiones al estilo LINQ. Este enfoque potente te permite incrustar imágenes, gráficos, códigos de barras, establecer colores de fondo para la salida HTML, crear tablas y listas dinámicas a partir de datos en forma de matriz, y aplicar lógica condicional para incluir o excluir secciones del documento. Debido a que SDK admite una amplia gama de formatos de entrada y salida, puedes generar un PDF a partir de una plantilla DOCX, producir informes HTML o generar archivos OpenDocument sin pasos de conversión adicionales.
El flujo de trabajo típico en Python consta de tres pasos sencillos:
1️⃣ Crear una plantilla – diseña un archivo Word, Excel, PowerPoint o cualquier archivo Office/OpenOffice compatible e inserta campos de marcador y reglas de generación.
2️⃣ Preparar una fuente de datos – proporciona tus datos en formato XML o JSON, coincidiendo con los marcadores definidos en la plantilla.
3️⃣ Escribir unas pocas líneas de código Python – usa el paquete groupdocsassemblycloud para subir la plantilla a GroupDocs Cloud Storage, pasa la fuente de datos junto con el formato de salida deseado e invoca la operación AssembleDocument. El API devuelve el documento ensamblado directamente en la respuesta o lo almacena en la Nube para su posterior recuperación.
Todas las interacciones están aseguradas con cifrado SSL/TLS, y la autenticación se realiza mediante tu SID de aplicación personal y App Key. Esto garantiza que tus documentos y datos permanezcan protegidos mientras se procesan en la nube. La naturaleza multiplataforma de SDK te permite integrar la generación de documentos en servicios web, trabajos por lotes, aplicaciones de escritorio o funciones sin servidor, entregando documentos imprimibles, listos para la web o para correo electrónico de forma instantánea y fiable.
Este ejemplo de Python muestra cómo subir una plantilla, enlazar un archivo de datos y generar un documento de salida usando el Assembly GroupDocs Cloud SDK.
Pasos
AssemblyApi con tu App SID y App Key.TemplateFileInfo y AssembleOptions.assemble_document para generar el resultado.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)