Gerar documentos com o Ruby SDK
API REST e Ruby Cloud SDK para montar, mesclar e enviar documentos por correio a partir de modelos e fontes de dados.
API REST e Ruby Cloud SDK para montar, mesclar e enviar documentos por correio a partir de modelos e fontes de dados.
O GroupDocs.Assembly Cloud é um serviço totalmente gerenciado e baseado em REST que permite criar documentos altamente personalizados diretamente de seus aplicativos Ruby. A plataforma funciona com base em um modelo de modelo e dados: você cria 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 em formato XML ou JSON, vincula os dados ao modelo usando uma sintaxe de expressão no 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 do Office, bibliotecas de terceiros ou mecanismos de renderização complexos – todo o trabalho pesado é realizado no data center seguro do GroupDocs. Você obtém suporte integrado para mala direta, tabelas dinâmicas, conteúdo condicional, geração de código de barras, inserção de imagens e gráficos e um amplo conjunto de opções de formatação. O serviço também oferece comunicação criptografada por SSL/TLS, chaves de acesso pessoais para autenticação e permissões baseadas em funções para manter seus dados seguros.
. Fluxo de trabalho Ruby com o SDK
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid e api_key.UploadFile.AssembleOptions que faça referência ao modelo carregado, especifique o formato de saída desejado e forneça a fonte de dados XML/JSON (ou um arquivo que o contenha).assemble_document – a API retorna o documento montado, que você pode baixar diretamente ou armazenar de volta no Cloud Storage.Usando esta sequência simples, você pode gerar contratos, faturas, propostas, relatórios de remessa, cartas personalizadas ou qualquer outro documento crítico para os negócios sob demanda, escalando desde uma única solicitação até grandes cenários de processamento em lote com mala direta.
O Ruby SDK também oferece classes auxiliares para trabalhar com armazenamento, lidar com erros e personalizar tempos limite de solicitação, facilitando a integração com Rails, Sinatra ou qualquer serviço baseado em Ruby.
Principais recursos da API Assembly Cloud.
Formatos de documentos suportados pelo Assembly Cloud.
Sistemas operacionais e ambientes de desenvolvimento suportados pelo Ruby SDK.
O snippet abaixo mostra como gerar um documento usando o SDK do Assembly Cloud Ruby. Etapas executadas:
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