Construtor de Documentos DOCX para Ruby

Ruby biblioteca para criar relatórios DOCX altamente personalizados usando a API REST

Integre perfeitamente a geração de documentos DOCX com base em modelos e fontes de dados em seu software Ruby.

Automatize a geração de documentos DOCX no Ruby, crie relatórios DOCX 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 DOCX altamente personalizados em qualquer sistema operacional. Documentos DOCX 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.

Simplifique a geração de documentos DOCX usando 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 DOCX é 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 DOCX. Para obter informações sobre os formatos de E/S suportados, visite nossa Documentação.

O que é GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby é uma solução baseada em nuvem para gerar documentos DOCX 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 DOCX - 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 DOCX 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 DOCX 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 DOCX que você implementará, há três etapas para criar um relatório em Ruby:

  • Crie um modelo de documento do Word com campos de espaço reservado e regras de geração de documentos que regularão as variações de estrutura e conteúdo
  • Criar uma fonte de dados no formato DOCX ou JSON
  • Escreva algumas linhas de código Ruby para passar tudo para a API Document Building e obter o resultado montado no formato DOCX de volta

Projetando um modelo de documento e usando regras de geração de documentos DOCX

Projetar modelos é uma tarefa difícil. Além de uma compreensão clara dos requisitos para o documento DOCX 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 DOCX. Essas regras de geração de documentos DOCX são definidas com uma sintaxe de expressão especial, que permite aos desenvolvedores fazer o seguinte:

  • incorporar conteúdo de documentos externos, imagens, gráficos, listas, tabelas, hiperlinks, marcadores, etc.
  • trabalhar com dados usando fórmulas e operações de dados sequenciais
  • especificar o formato de apresentação para elementos numéricos, de texto, gráficos, gráficos e de data e hora
  • inserir blocos de conteúdo dependendo de expressões condicionais
  • definir variáveis especiais para cálculos 'caros' que são calculados apenas uma vez
  • calcular fórmulas ao montar documentos de planilha
  • atribuir atributos de corpo de mensagem de email e criar anexos dinamicamente
  • criar e inserir códigos de barras
  • definir cor de fundo para documentos HTML

Você pode saber mais sobre a sintaxe do modelo em nosso Guia do desenvolvedor.

Requisitos

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 DOCX, onde todas as interações de programação são realizadas pela rede usando a API REST.

Segurança

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.

Gerar documento DOCX em Ruby

O exemplo de código a seguir mostra como gerar relatórios DOCX usando Ruby.

Gerar documento DOCX em Ruby
Arquivos de entrada
Carregar um modelo de documento
Formato de saída
Selecione o formato de destino na lista
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.docx'
data_file= 'Input2.docx'

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 => "docx", 
		    :ReportData => File.open(data_file, 'rb') { |f| f.read })
request = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document request
  
Copie o código Ruby para a área de transferência

Como gerar documento DOCX usando Ruby

  1. Instale 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. Adicione uma referência de biblioteca (importe a biblioteca) ao seu projeto Ruby.
  3. Crie um documento de modelo, adicione construções de programação que controlam a inserção de dados da fonte de dados.
  4. Crie uma fonte de dados.
  5. Carregue o modelo de documento para o GroupDocs Cloud Storage (você precisa fazer login em sua conta pessoal).
  6. Gere um documento passando seu modelo e dados para a API Cloud.

Como instalar DOCX Report Builder para Ruby

Instale 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.

Requisitos de sistema

Ruby 2.6 ou mais recente

Consulte a Repository Documentation para ver os detalhes.

Outros formatos de documentos suportados

Você pode gerar relatórios em outros formatos de arquivo:

5%

Inscreva-se para receber atualizações do produto Aspose

Receba boletins e ofertas mensais diretamente em sua caixa de correio.

© Aspose Pty Ltd 2001-2024. Todos os direitos reservados.