Biblioteca Java para criar relatórios altamente personalizados usando API REST
Iniciar teste gratuitoO GroupDocs.Assembly Cloud é um serviço totalmente gerenciado e baseado em REST que permite que desenvolvedores Java criem documentos, relatórios, contratos, faturas e cartas de mala direta altamente personalizados diretamente da nuvem. A solução funciona com um amplo conjunto de formatos de entrada e saída, permitindo armazenar arquivos de modelo no GroupDocs Cloud Storage, vinculá-los a fontes de dados XML ou JSON e receber o documento montado no formato de sua escolha – DOCX, PDF, HTML, PPTX, XLSX, etc. Como todo o processamento ocorre no lado do servidor, não há necessidade de instalar softwares ou bibliotecas de terceiros na máquina cliente; o único requisito é um Java Runtime e o Assembly Cloud SDK, que fornece wrappers finos em torno dos endpoints da API.
Um fluxo de trabalho Java típico consiste em três etapas simples. Primeiro, adicione a dependência do Assembly Cloud SDK ao seu projeto Maven ou Gradle e inicialize o ApiClient com seu AppSID e AppKey pessoais. Segundo, carregue o arquivo de modelo no GroupDocs Cloud Storage usando o método uploadFile. Terceiro, crie um objeto AssembleOptions, especifique o caminho do modelo, o arquivo de dados (XML ou JSON), o formato de saída desejado e invoque assembleDocument. O serviço retorna o documento montado como um fluxo que pode ser salvo localmente ou processado posteriormente. O SDK também expõe métodos auxiliares para visualizar modelos, recuperar formatos suportados e lidar com erros. Essa abordagem direta permite integrar a geração de documentos em aplicativos web, trabalhos de processamento em lote ou microsserviços com o mínimo de código.
Todas as comunicações são criptografadas com SSL/TLS e o acesso é controlado por chaves pessoais. A plataforma é dimensionada automaticamente para lidar com grandes volumes de solicitações e suporta operações de mala direta em lote, onde uma única chamada de API pode gerar milhares de cartas personalizadas. Além disso, o SDK suporta a incorporação de imagens, gráficos, códigos de barras e a aplicação de lógica condicional diretamente no modelo usando expressões no estilo LINQ, dando a você controle total sobre o layout final do documento.
O snippet abaixo demonstra como carregar um modelo, definir a fonte de dados e gerar um relatório DOCX usando a API Assembly Cloud. Etapas
AssembleOptions – caminho do modelo, formato de saída e arquivo de dados.assembleDocument para produzir o resultado.import com.groupdocs.assembly.*;
AssemblyApi assemblyApi = new AssemblyApi(new ApiClient());
ApiClient client = assemblyApi.getApiClient();
client.setAppKey("......##").setAppSid(".#-.#-.#-.#-.#");
String fileName = "Input1.docx";
String dataFile = "Input2.docx";
File requestFileContent = new File(fileName);
UploadFileRequest uploadDocumentRequest =
new UploadFileRequest(requestFileContent, fileName, null);
assemblyApi.uploadFile(uploadDocumentRequest);
AssembleOptions assembleOptions = new AssembleOptions();
assembleOptions.setTemplateFileInfo(new TemplateFileInfo().filePath(fileName));
assembleOptions.setSaveFormat("docx");
assembleOptions.setReportData(Paths.get(dataFile).toString());
AssembleDocumentRequest request = new AssembleDocumentRequest(assembleOptions);
assemblyApi.assembleDocument(request);