Biblioteca Java para criar relatórios altamente personalizados usando REST API
Iniciar teste gratuitoGroupDocs.Assembly Cloud é um serviço totalmente gerenciado, 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 que você armazene arquivos de modelo em GroupDocs Cloud Storage, os vincule a fontes de dados XML ou JSON, e receba 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 nenhum software ou biblioteca de terceiros na máquina cliente; o único requisito é um runtime Java e o Assembly Cloud SDK, que fornece wrappers leves em torno dos endpoints API.
Um fluxo de trabalho típico Java consiste em três etapas simples. Primeiro, adicione a dependência Assembly Cloud SDK ao seu projeto Maven ou Gradle e inicialize o ApiClient com seu App SID e App Key pessoais. Segundo, faça upload do arquivo de modelo para 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 devolve o documento montado como um stream que pode ser salvo localmente ou processado posteriormente. O SDK também expõe métodos auxiliares para pré‑visualizar modelos, recuperar formatos suportados e tratar erros. Essa abordagem direta permite que você integre a geração de documentos em aplicações web, trabalhos de processamento em lote ou microsserviços com código mínimo.
Todas as comunicações são criptografadas com SSL/TLS e o acesso é controlado por chaves pessoais. A plataforma escala automaticamente para lidar com grandes volumes de solicitações e suporta operações de mala‑direta em lote, onde uma única chamada API pode gerar milhares de cartas personalizadas. Além disso, o SDK suporta a inserçã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, proporcionando a você controle total sobre o layout final do documento.
O trecho abaixo demonstra como carregar um modelo, definir a fonte de dados e gerar um relatório DOCX usando o Assembly Cloud API. 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);