Instalación

El paquete es available en PyPI y se puede instalar a través de pip ejecutando el siguiente comando:

pip install groupdocs-assembly-cloud

Requisitos

• Python 3.4+
• administrador de paquetes pip
• Credenciales de nube de GroupDocs — Client ID and Client Secret desde el tablero

Dependencias

El SDK instala automáticamente los siguientes paquetes:

API REST de Python Cloud de automatización de documentos

GroupDocs.Assembly Cloud SDK para Python permite a los desarrolladores automatizar sin problemas la creación de documentos complejos como informes, facturas y presentaciones. Aproveche las plantillas, combine datos de fuentes JSON o XML, aplique formato enriquecido y genere códigos de barras y gráficos, todo dentro de un entorno de nube escalable y seguro. Esta API agiliza los flujos de trabajo de documentos, mejora la productividad y proporciona compatibilidad multiplataforma para una integración sencilla en sus aplicaciones web, scripts y flujos de trabajo de automatización de Python.

Funciones principales

Generación de documentos basada en plantillas: cree documentos complejos de Word, Excel, PowerPoint y PDF a partir de plantillas.
Fusión dinámica de datos: complete las plantillas con datos JSON o XML para obtener informes personalizados.
Formato y estilo enriquecidos: aplique formato avanzado a texto, tablas y gráficos para obtener documentos pulidos.
Control de contenido condicional: utilice lógica condicional para generar contenido dinámico basado en datos.
Automatización de listas y tablas: cree listas, tablas y gráficos dinámicos que se actualizan automáticamente en función de los datos.

Funciones avanzadas

Generación de códigos de barras: incruste códigos de barras directamente en los documentos.
Inserción de hipervínculo: agregue enlaces en los que se puede hacer clic a recursos externos o dentro del documento.
Creación de marcadores: cree marcadores para facilitar la navegación.
Manipulación de casillas de verificación: establece dinámicamente valores de casillas de verificación según los datos.
Funcionalidad de combinación de correspondencia: genere correos electrónicos y archivos adjuntos personalizados a escala.
Cálculos de fórmulas: realice cálculos dentro de hojas de cálculo para obtener resultados dinámicos.

Trabajar con datos

Filtrado de datos: aplique filtros para seleccionar subconjuntos de datos específicos para los informes.
Clasificación de datos: organiza los datos en un orden específico (asc/desc) según los criterios.
Agrupación de datos: organice los datos en grupos para facilitar el análisis y la presentación.
Formato de datos: controle la apariencia de los datos en los informes, por ejemplo, número, fecha, formato de texto.
Uso de variables: almacene y reutilice valores en toda una plantilla para un procesamiento eficiente.
Uso de métodos de extensión: aproveche las funciones integradas para manipulaciones complejas dentro de las plantillas.

Trabajar con listas, tablas y gráficos

Generación dinámica de listas: genere listas numeradas, con viñetas y dentro de párrafos con contenido dinámico.
Generación dinámica de tablas: genere tablas con contenido, cálculos y formato dinámicos.
Generación de gráficos: cree gráficos de líneas, columnas, barras, circulares, de dispersión y de burbujas con datos dinámicos.
Personalización de gráficos: personalice títulos de gráficos, series, títulos de ejes y leyendas mediante expresiones.
Serie de gráficos condicional: incluye/excluye series de gráficos condicionalmente según las condiciones.

Trabajar con hipervínculos, marcadores y códigos de barras

Insertar hipervínculos: inserte hipervínculos en documentos de Word, correo electrónico, hojas de cálculo y presentaciones.
Inserción dinámica de marcadores: agregue marcadores a documentos/correos electrónicos y defina nombres para la navegación.
Control de estado de casilla de verificación: establezca casillas de verificación marcadas o desmarcadas en documentos de Word usando una etiqueta de verificación.
Generación de imágenes de códigos de barras: genere e inserte QR, DataMatrix, UPC, EAN, ISBN, PDF417 y muchos otros tipos de códigos de barras.

Funciones fáciles de usar para desarrolladores

Arquitectura API REST: aproveche REST para una fácil integración y escalabilidad.
Documentación completa: acceda a referencias API detalladas, ejemplos de código y tutoriales.
Soporte comunitario activo: obtenga ayuda del foro de la comunidad activa y soporte dedicado.
Flexibilidad basada en la nube: disfrute de la escalabilidad y confiabilidad del procesamiento basado en la nube.
Autenticación JWT: datos seguros y solicitudes de API con autenticación JWT.

Licencias y autenticación

Modo de evaluación: prueba la API con una cuenta de prueba gratuita.
Autenticación segura: utilice el ID de cliente y el secreto de cliente para obtener acceso seguro a la API.
Licencia MIT: el SDK para Python tiene la licencia de MIT License.

Formatos de archivo admitidos

GroupDocs.Assembly Cloud admite la generación y conversión basada en plantillas en una amplia gama de tipos de documentos:

• Procesamiento de textos: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MD, TXT, MHTML, MHT
• Hojas de cálculo: XLS, XLSX, XLSM, XLTX, XLTM, XLSB, ODS
• Presentaciones: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
• Correo electrónico: MSG, EML, EMLX
• Web y otros: PDF, EPUB, XPS, OXPS, TIFF, SVG, XAML

Los formatos de salida admitidos varían según el tipo de plantilla de origen. Para obtener la matriz de formato completa, consulte la documentation.

Inicio rápido

Obtenga sus credenciales API

Para utilizar GroupDocs.Assembly Cloud, regístrese en GroupDocs.Cloud Dashboard y obtenga su ID de cliente y su Secreto de cliente.

Inicializar la API

Utilice el siguiente código para comenzar a utilizar GroupDocs.Assembly Cloud SDK para 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"

Ensamblar documento a partir de plantilla y datos JSON

Una vez inicializado, utilice este ejemplo básico para generar un documento a partir de una plantilla y una fuente de datos 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)))

Con esta guía de inicio rápido, estará listo para comenzar a automatizar la generación de documentos usando GroupDocs.Assembly Cloud en sus aplicaciones Python. Para más detalles, visite el documentation.

Ensamblar documento en PDF

Genere un informe en PDF a partir de una plantilla de OpenDocument y datos 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)))

Obtenga formatos de archivo compatibles

Obtenga la lista completa de formatos de archivo compatibles disponibles a través de la API de ensamblaje.

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)

Proyectos de muestra en GitHub

El GroupDocs.Assembly Cloud Python SDK El repositorio incluye pruebas unitarias listas para ejecutar y ejemplos que cubren:

Cómo ejecutar los ejemplos

1. Clona o descarga el SDK repository2. EditarSettings/servercreds.jsony configura tuAppSidyAppKey3. Instalar dependencias:pip install groupdocs-assembly-cloud -U4. Ejecute pruebas desde la raíz del repositorio:python -m unittest discover -s test

Para más detalles, visite Getting Started.

Etiquetas

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