Automatize a geração de documentos PDF no Ruby, crie relatórios PDF prontos para impressão de qualquer complexidade com o SDK do Ruby. Esta solução baseada em nuvem é construída em torno de modelos, fontes de dados e uma poderosa sintaxe LINQ, dando aos desenvolvedores Ruby a flexibilidade para atender a requisitos técnicos e de negócios precisos.
Usando essa biblioteca Ruby, você pode criar de forma programática relatórios PDF altamente personalizados em qualquer sistema operacional. Documentos PDF formatados como contratos, pedidos, faturas, relatórios de remessa, propostas de vendas, inventários podem ser montados em tempo real como parte de seu software Ruby.
A importância da Automação de Documentos e Geração de Relatórios cresceu imensamente nas últimas décadas. Quase toda empresa tem a necessidade de gerar documentos e entregá-los aos parceiros ou clientes no prazo. Além disso, costuma ser um fator decisivo para o sucesso financeiro. A implementação dessas tecnologias pode resultar em economias financeiras significativas, reduzindo a entrada manual de dados, o erro humano, a revisão e a papelada. Por esses motivos, as ferramentas de automação de documentos e relatórios são parte integrante de muitas soluções de software modernas que visam fornecer recursos analíticos avançados aos usuários.
De um modo geral, a geração de relatórios PDF é um processo que combina texto, dados e gráficos em uma única entidade e exporta o resultado em um formato visual conveniente para o formato de arquivo PDF. Para obter informações sobre os formatos de E/S suportados, visite nossa Documentação.
GroupDocs Assembly for Ruby é uma solução baseada em nuvem para gerar documentos PDF usando modelos e fontes de dados. O modelo de documento funciona como um quadro base que, além do conteúdo padrão (texto, tabelas, gráficos, etc.), inclui campos especiais de espaço reservado para inserção de valores da fonte de dados. Não apenas valores individuais podem ser inseridos, mas também matrizes inteiras de dados na forma de tabelas e gráficos.
O modelo também contém construções de programação - regras de geração de documentos PDF - que controlam a seleção de dados e o processamento de condições. A associação de dados a um modelo de documento usa a sintaxe de expressão LINQ, que permite que os desenvolvedores processem dados de maneira genérica, independentemente do tipo de fonte de dados usada. Dessa forma, nosso Ruby Cloud SDK oferece flexibilidade na geração de conteúdo PDF e um poderoso conjunto de métodos para processamento de dados.
Este produto também oferece suporte à funcionalidade Mail Merge caso você queira criar e enviar lotes de cartas personalizadas em formato PDF aos clientes. Você só precisa inserir campos Mail Merge no modelo de documento e passá-lo para a API do Cloud junto com uma fonte de dados.
Independentemente da escala e do tipo de automação de documento PDF que você implementará, há três etapas para criar um relatório em Ruby:
Projetar modelos é uma tarefa difícil. Além de uma compreensão clara dos requisitos para o documento PDF final, são necessárias habilidades analíticas e de programação. Um bom design de modelo deve refletir a visão do cliente sobre um problema específico. A abordagem mais eficaz é combinar dados tabulares e gráficos no equilíbrio certo, determinado pelos requisitos de negócios.
Como mencionado acima, a estrutura do modelo geralmente contém alguns blocos fixos de conteúdo (texto, imagens, logotipos, etc.) misturados com construções de programação especiais que controlam a lógica de montagem do documento PDF. Essas regras de geração de documentos PDF são definidas com uma sintaxe de expressão especial, que permite aos desenvolvedores fazer o seguinte:
Você pode saber mais sobre a sintaxe do modelo em nosso Guia do desenvolvedor.
GroupDocs Assembly for Ruby não requer a instalação de nenhum software externo ou ferramentas de terceiros. Esta é uma solução baseada em nuvem para PDF, onde todas as interações de programação são realizadas pela rede usando a API REST.
Todos os produtos GroupDocs estão em total conformidade com os padrões de segurança da indústria: a transferência de dados é realizada usando o protocolo SSL, o que elimina a possibilidade de as informações serem interceptadas por terceiros. Para se conectar aos Serviços em Nuvem do GroupDocs, você precisa usar chaves de acesso pessoais. Consulte o guia de início rápido.
O exemplo de código a seguir mostra como gerar relatórios PDF usando Ruby.
require_relative '../lib/groupdocs_assembly_cloud'
GroupDocsAssemblyCloud.configure do |config|
config.client_data['app_sid'] = '####-####-####-####-####'
config.client_data['api_key'] = '##################'
end
@assembly_api = AssemblyApi.new
file_name= 'Input1.pdf'
data_file= 'Input2.pdf'
request_file_content = File.open(file_name)
upload_document_request = UploadFileRequest.new(
file_content: request_file_content, path: file_name)
@assembly_api.upload_file(upload_document_request)
template_file_info = TemplateFileInfo.new(:FilePath => file_name)
assemble_options = AssembleOptions.new(
:TemplateFileInfo => template_file_info,
:SaveFormat => "pdf",
:ReportData => File.open(data_file, 'rb') { |f| f.read })
request = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document requestInstale GroupDocs.Assembly Cloud SDK for Ruby usando o serviço de hospedagem RubyGems. Execute gem install groupdocs_assembly_cloud para instalar o pacote. Como alternativa, você pode clonar manualmente o código-fonte do GroupDocs.Assembly Cloud SDK for Ruby do GitHub e usá-lo em seu projeto. Siga estas Instructions para obter rapidamente as credenciais de segurança necessárias e acessar nossa REST API.
Ruby 2.6 ou mais recente
Consulte a Repository Documentation para ver os detalhes.
Você pode gerar relatórios em outros formatos de arquivo: