Gere documentos com Ruby SDK
REST API e Ruby Cloud SDK para montar, mesclar e fazer mesclagem de correspondência de documentos a partir de modelos e fontes de dados.
REST API e Ruby Cloud SDK para montar, mesclar e fazer mesclagem de correspondência de documentos a partir de modelos e fontes de dados.
GroupDocs.Assembly Cloud é um serviço totalmente gerenciado, baseado em REST, que permite que você crie documentos altamente personalizados diretamente das suas aplicações Ruby. A plataforma funciona com um modelo de modelo‑e‑dados: você projeta um documento‑modelo (Word, Excel, PowerPoint, PDF, HTML, etc.) que contém campos de espaço reservado especiais e construções programáveis. Em tempo de execução, você fornece uma fonte de dados nos formatos XML ou JSON, vincula os dados ao modelo usando uma sintaxe de expressão ao estilo LINQ, e o serviço em nuvem monta o documento final no formato que você precisa.
Essa abordagem elimina a necessidade de instalações locais de Office, bibliotecas de terceiros ou motores de renderização complexos – todo o processamento pesado é realizado no seguro data centre GroupDocs. Você obtém suporte nativo para mail‑merge, tabelas dinâmicas, conteúdo condicional, geração de códigos de barras, inserção de imagens e gráficos, e um conjunto rico de opções de formatação. O serviço também oferece comunicação criptografada SSL/TLS, chaves de acesso pessoais para autenticação e permissões baseadas em funções para manter seus dados seguros.
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid e api_key.UploadFile.AssembleOptions que referencia o modelo enviado, especifica o formato de saída desejado e fornece a fonte de dados XML/JSON (ou um arquivo que a contenha).assemble_document – o API devolve o documento montado, que você pode baixar diretamente ou armazenar novamente no Cloud Storage.Usando essa sequência simples, você pode gerar contratos, faturas, propostas, relatórios de envio, cartas personalizadas ou qualquer outro documento crítico para o negócio sob demanda, escalando de uma única solicitação para grandes cenários de processamento em lote com mail‑merge.
O Ruby SDK também oferece classes auxiliares para trabalhar com armazenamento, tratar erros e personalizar tempos de espera de solicitações, facilitando a integração ao Rails, Sinatra ou qualquer serviço baseado em Ruby de forma fluida.
Principais recursos do Assembly Cloud API.
Formatos de documento suportados pelo Assembly Cloud.
Sistemas operacionais e ambientes de desenvolvimento suportados pelo Ruby SDK.
O trecho abaixo mostra como gerar um documento usando o Assembly Cloud Ruby SDK. Etapas realizadas:
AssembleOptions – modelo, formato de saída e fonte de dados.assemble_document para obter o arquivo montado.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