Biblioteca Python para criar relatórios altamente personalizados usando API REST
Iniciar teste gratuitoO GroupDocs.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 essenciais para os negócios. A solução é totalmente baseada em nuvem e acessada por meio de uma API REST, o que significa que qualquer aplicativo Python capaz de enviar solicitações HTTP pode gerar documentos sob demanda sem a necessidade de instalar software no servidor ou ferramentas de terceiros.
Em sua essência, a plataforma trabalha com modelos de documentos 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 obtidos de uma fonte de dados (XML ou JSON) usando uma sintaxe de expressão no estilo LINQ. Essa abordagem poderosa permite incorporar imagens, gráficos, códigos de barras, definir cores de fundo para saída HTML, criar tabelas e listas dinâmicas a partir de dados de matriz e aplicar lógica condicional para incluir ou excluir seções do documento. Como o SDK suporta uma ampla gama de formatos de entrada e saída, você pode gerar um PDF a partir de um modelo DOCX, produzir relatórios em 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 – criar um arquivo do Word, Excel, PowerPoint ou qualquer arquivo compatível do Office/OpenOffice e inserir campos de espaço reservado e regras de geração.
2️⃣ Preparar uma fonte de dados – fornecer seus dados em formato XML ou JSON, correspondendo aos espaços reservados definidos no modelo.
3️⃣ Escrever algumas linhas de código Python – usar o pacote groupdocsassemblycloud para enviar o modelo para o GroupDocs Cloud Storage, passar a fonte de dados juntamente com o formato de saída desejado e invocar a operação AssembleDocument. A API retorna 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 por meio do seu App SID e App Key pessoais. Isso garante que seus documentos e dados permaneçam protegidos durante o processamento na nuvem. A natureza multiplataforma do SDK permite integrar a geração de documentos a serviços web, trabalhos em lote, aplicativos desktop ou funções sem servidor, entregando documentos imprimíveis, prontos para web ou para e-mail de forma instantânea e confiável.
Este exemplo em Python demonstra como carregar um modelo, vincular um arquivo de dados e gerar um documento de saída usando o GroupDocs Assembly 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)