Instalação

O pacote é disponível em PyPI e pode ser instalado via pip executando o seguinte comando:

pip install groupdocs-assembly-cloud

Requisitos

• Python 3.4+
• pip gerenciador de pacotes
• GroupDocs Credenciais Cloud — Client ID and Client Secret do Dashboard

Dependências

O SDK instala automaticamente os seguintes pacotes:

Python de automação de documentos Cloud REST API

GroupDocs.Assembly Cloud SDK para Python permite que os desenvolvedores automatizem perfeitamente a criação de documentos complexos, como relatórios, faturas e apresentações. Aproveite modelos, mescle dados de fontes JSON ou XML, aplique formatação avançada e gere códigos de barras e gráficos, tudo em um ambiente de nuvem escalonável e seguro. Este API agiliza fluxos de trabalho de documentos, aumenta a produtividade e fornece compatibilidade entre plataformas para integração fácil em seus aplicativos da web Python, scripts e fluxos de trabalho de automação.

Recursos principais

Geração de documentos baseada em modelos - Crie documentos complexos do Word, Excel, PowerPoint e PDF a partir de modelos.
Mesclagem dinâmica de dados - Preencha modelos com dados JSON ou XML para relatórios personalizados.
Formatação e estilo avançados - Aplique formatação avançada a textos, tabelas e gráficos para obter documentos sofisticados.
Controle de conteúdo condicional – Use lógica condicional para gerar conteúdo dinâmico com base em dados.
Automação de listas e tabelas – Crie listas, tabelas e gráficos dinâmicos que são atualizados automaticamente com base nos dados.

Recursos avançados

Geração de código de barras - Incorpore códigos de barras diretamente nos documentos.
Inserção de hiperlink - Adicione links clicáveis ​​a recursos externos ou dentro do documento.
Criação de Marcadores - Crie marcadores para facilitar a navegação.
Manipulação de caixa de seleção - Defina valores de caixa de seleção dinamicamente com base nos dados.
Funcionalidade de mala direta - Gere e-mails e anexos personalizados em grande escala.
Cálculos de fórmulas - Execute cálculos em planilhas para obter resultados dinâmicos.

Trabalhando com dados

Filtragem de dados – Aplique filtros para selecionar subconjuntos de dados específicos para relatórios.
Classificação de dados - Organize os dados em ordem específica (asc/desc) com base em critérios.
Agrupamento de dados - Organize os dados em grupos para facilitar a análise e a apresentação.
Formatação de dados - Controle a aparência dos dados nos relatórios, por exemplo, número, data, formatação de texto.
Usando variáveis – Armazene e reutilize valores em um modelo para processamento eficiente.
Usando métodos de extensão – Aproveite funções integradas para manipulações complexas em modelos.

Trabalhando com listas, tabelas e gráficos

Geração de lista dinâmica - Gere listas numeradas, com marcadores e em parágrafos com conteúdo dinâmico.
Geração dinâmica de tabelas - Gere tabelas com conteúdo, cálculos e formatação dinâmicos.
Geração de gráficos - Crie gráficos de linhas, colunas, barras, pizza, dispersão e bolhas com dados dinâmicos.
Personalização de gráficos - Personalize títulos de gráficos, séries, títulos de eixos e legendas por meio de expressões.
Série de gráficos condicionais - Inclua/exclua séries de gráficos condicionalmente com base nas condições.

Trabalhando com hiperlinks, marcadores e códigos de barras

Inserir hiperlinks - Insira hiperlinks em documentos do Word, e-mail, planilhas e apresentações.
Inserção dinâmica de marcadores - Adicione marcadores a documentos/e-mails e defina nomes para navegação.
Controle de estado da caixa de seleção - Defina caixas de seleção marcadas/desmarcadas em documentos do Word usando a tag de seleção.
Geração de imagem de código de barras - Gere e insira QR, DataMatrix, UPC, EAN, ISBN, PDF417 e muitos outros tipos de código de barras.

Recursos para desenvolvedores

REST API Arquitetura - Aproveite REST para fácil integração e escalabilidade.
Documentação abrangente - Acesse referências API detalhadas, exemplos de código, tutoriais.
Suporte comunitário ativo - Obtenha ajuda do fórum da comunidade ativa e suporte dedicado.
Flexibilidade baseada em Cloud – Aproveite a escalabilidade e a confiabilidade do processamento baseado em nuvem.
Autenticação JWT - Dados seguros e solicitações API com autenticação JWT.

Licenciamento e Autenticação

Modo de avaliação - Experimente o API com uma conta de teste gratuita.
Autenticação segura – Use o ID do cliente e o segredo do cliente para acesso seguro ao API.
Licença MIT - O Python SDK é licenciado sob MIT License.

Formatos de arquivo suportados

GroupDocs.Assembly Cloud suporta geração e conversão orientadas por modelo em uma ampla variedade de tipos de documentos:

• Processamento de texto: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MD, TXT, MHTML, MHT
• Planilhas: XLS, XLSX, XLSM, XLTX, XLTM, XLSB, ODS
• Apresentações: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
• E-mail: MSG, EML, EMLX
• Web e outros: PDF, EPUB, XPS, OXPS, TIFF, SVG, XAML Os formatos de saída suportados variam de acordo com o tipo de modelo de origem. Para a matriz de formato completa, consulte documentation.

Início rápido

Obtenha suas credenciais API

Para usar GroupDocs.Assembly Cloud, cadastre-se em GroupDocs.Cloud Dashboard e obtenha seu ID do cliente e Segredo do cliente.

Inicialize o API

Use o código a seguir para começar a usar 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"

Montar documento a partir do modelo e dados JSON

Depois de inicializado, use este exemplo básico para gerar um documento a partir de um modelo e da fonte de dados 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)))

Com este guia de início rápido, você está pronto para começar a automatizar a geração de documentos usando GroupDocs.Assembly Cloud em seus aplicativos Python. Para mais detalhes, visite documentation.

Montar documento em PDF

Gere um relatório PDF a partir de um modelo OpenDocument e dados 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)))

Obtenha formatos de arquivo suportados

Recupere a lista completa de formatos de arquivo suportados disponíveis através do 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)

Exemplos de projetos em GitHub

O repositório GroupDocs.Assembly Cloud Python SDK inclui testes de unidade prontos para execução e exemplos que abrangem:

Como executar os exemplos

1. Clone ou baixe o SDK repository
2. Edite Settings/servercreds.json e defina seu AppSid e AppKey
3. Instale dependências: pip install groupdocs-assembly-cloud -U
4. Execute testes da raiz do repositório: python -m unittest discover -s test Para mais detalhes, visite 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