Biblioteca Python para criar relatórios altamente personalizados usando REST API
Iniciar teste gratuitoGroupDocs.Assembly Cloud SDK para Python permite que desenvolvedores automatizem a criação de documentos ricamente formatados, como contratos, faturas, relatórios de remessa, propostas de vendas, inventários e muitos outros artefatos críticos para os negócios. A solução é totalmente baseada na nuvem e acessada por meio de um REST API, o que significa que qualquer aplicação Python capaz de enviar solicitações HTTP pode gerar documentos sob demanda sem instalar software no servidor ou ferramentas de terceiros.
No seu núcleo, a plataforma trabalha com modelos de documento que contêm campos de espaço reservado especiais e construções de programação. Esses espaços reservados são substituídos automaticamente por valores extraídos de uma fonte de dados (XML ou JSON) usando uma sintaxe de expressão no estilo LINQ. Essa abordagem poderosa permite que você incorpore imagens, gráficos, códigos de barras, defina cores de fundo para a saída HTML, crie tabelas e listas dinâmicas a partir de dados em array e aplique lógica condicional para incluir ou excluir seções do documento. Como o SDK suporta uma ampla variedade de formatos de entrada e saída, você pode gerar um PDF a partir de um modelo DOCX, produzir relatórios HTML ou gerar arquivos OpenDocument sem etapas adicionais de conversão.
O fluxo de trabalho típico em Python consiste em três etapas simples:
1️⃣ Criar um modelo – desenhe um arquivo Word, Excel, PowerPoint ou qualquer arquivo Office/OpenOffice suportado e insira campos de espaço reservado e regras de geração.
2️⃣ Preparar uma fonte de dados – forneça seus dados nos formatos XML ou JSON, correspondendo aos espaços reservados definidos no modelo.
3️⃣ Escrever algumas linhas de código Python – use o pacote groupdocsassemblycloud para enviar o modelo para GroupDocs Cloud Storage, passe a fonte de dados junto com o formato de saída desejado e invoque a operação AssembleDocument. O API devolve o documento montado diretamente na resposta ou o armazena na nuvem para recuperação posterior.
Todas as interações são protegidas com criptografia SSL/TLS, e a autenticação é realizada via seu App SID pessoal e App Key. Isso garante que seus documentos e dados permaneçam protegidos enquanto são processados na nuvem. A natureza multiplataforma do SDK permite que você integre a geração de documentos em serviços web, trabalhos em lote, aplicativos de desktop ou funções serverless, entregando documentos imprimíveis, prontos para a web ou para e‑mail instantaneamente e de forma confiável.
Este exemplo Python demonstra como fazer upload de um modelo, vincular um arquivo de dados e gerar um documento de saída usando o Assembly GroupDocs Cloud SDK.
Etapas
AssemblyApi com seu App SID e App Key.TemplateFileInfo e AssembleOptions.assemble_document para gerar o 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)