Gerador de relatórios para Swift
Biblioteca Swift para criar relatórios altamente personalizados usando API REST
Biblioteca Swift para criar relatórios altamente personalizados usando API REST
O GroupDocs.AssemblyCloud é um serviço de montagem de documentos totalmente gerenciado e baseado em REST que permite aos desenvolvedores criar relatórios, contratos, faturas, propostas e qualquer outro tipo de documento com formatação avançada diretamente de aplicativos Swift. O serviço funciona sobre o GroupDocs Cloud Storage – modelos e dados são carregados na nuvem, o mecanismo de montagem os processa e o documento finalizado é devolvido ao cliente sem a necessidade de instalações locais do Office. Isso elimina a sobrecarga de manutenção de bibliotecas de terceiros, reduz a carga de processamento do lado do servidor e garante que o suporte aos formatos mais recentes (DOCX, PDF, PPTX, XLSX, HTML, etc.) esteja sempre disponível.
Com o Swift SDK, todo o fluxo de trabalho se encaixa naturalmente no ciclo típico de desenvolvimento para iOS/macOS:
Preparar um modelo – um arquivo Word, Excel, PowerPoint ou qualquer formato compatível que contenha espaços reservados (por exemplo, {{Customer.Name}}) e regras de geração opcionais escritas em sintaxe estilo LINQ.
Crie uma fonte de dados – um arquivo JSON ou XML que fornece os valores para os espaços reservados. Estruturas complexas, como matrizes, podem ser usadas para gerar tabelas, gráficos ou seções repetidas.
Carregue o modelo para o GroupDocs Cloud Storage usando uma única chamada de API (o SDK lida com a solicitação multipartes).
Chame o endpoint Assemble – passe o caminho da nuvem do modelo, o conteúdo da fonte de dados e o formato de saída desejado (o formato de saída pode ser diferente do formato do modelo, por exemplo, gere um PDF a partir de um modelo DOCX).
Receba o documento montado – o serviço transmite o resultado de volta; o SDK pode salvá-lo localmente, enviá-lo por e-mail ou armazená-lo novamente no Cloud Storage.
O SDK abstrai todos os detalhes HTTP – você só precisa fornecer seu App SID e App Key (tokens de acesso pessoais). Toda a comunicação é criptografada com SSL/TLS, o tratamento de erros segue os códigos de status HTTP padrão e o serviço está em conformidade com os padrões de segurança de nível industrial. Como o processamento é realizado na nuvem, o mesmo código Swift funciona no iPhone, iPad, Mac ou qualquer outra plataforma que possa executar código Swift e realizar solicitações de rede.
As guias a seguir fornecem uma visão geral concisa dos recursos suportados pelo AssemblyCloud para Swift, a lista completa de formatos de documentos e os sistemas operacionais/ferramentas de desenvolvimento compatíveis com o SDK.
Principais recursos da API Assembly Cloud para Swift.
Formatos de documentos suportados pela API Assembly Cloud.
Sistemas operacionais e estruturas de desenvolvimento suportados.
O snippet abaixo demonstra como gerar um relatório usando o Assembly Cloud SDK para Swift. Ele carrega um modelo, lê um arquivo de dados, configura opções de montagem e invoca a API.
Etapas
AssemblyApi com seu App SID e App Key.TemplateFileInfo apontando para o modelo carregado.AssembleOptions com modelo, dados e formato.assembleDocument e obtenha o arquivo montado.import GroupDocsAssemblyCloud
let assemblyApi = AssemblyApi(appSid: "......##", appKey: "......##")
let fileName = "Input1.docx"
let dataFile = "Input2.docx"
// Upload template
let requestFileContent = InputStream(url: URL(string: fileName)!)!
let uploadDocumentRequest = UploadFileRequest(fileContent: requestFileContent, path: fileName)
_ = try assemblyApi.uploadFile(request: uploadDocumentRequest)
// Prepare template info
let templateFileInfo = TemplateFileInfo()
templateFileInfo.setFilePath(filePath: fileName)
// Load data
let reportData = try String(contentsOfFile: dataFile, encoding: .utf8)
// Assemble options
let assembleOptions = AssembleOptions()
assembleOptions.setTemplateFileInfo(templateFileInfo: templateFileInfo)
assembleOptions.setSaveFormat(saveFormat: "docx")
assembleOptions.setReportData(reportData: reportData)
// Execute assembly
let request = AssembleDocumentRequest(assembleOptions: assembleOptions)
let result = try assemblyApi.assembleDocument(request: request)