Generar documentos con Ruby SDK
API REST y SDK Ruby Cloud para ensamblar, fusionar y combinar correspondencia de documentos desde plantillas y fuentes de datos.
API REST y SDK Ruby Cloud para ensamblar, fusionar y combinar correspondencia de documentos desde plantillas y fuentes de datos.
GroupDocs.Assembly Cloud es un servicio totalmente gestionado, basado en REST, que permite crear documentos altamente personalizados directamente desde las aplicaciones Ruby. La plataforma funciona con un modelo de plantilla y datos: se diseña un documento de plantilla (Word, Excel, PowerPoint, PDF, HTML, etc.) que contiene campos de marcador de posición especiales y construcciones programables. En tiempo de ejecución, se proporciona una fuente de datos en formato XML o JSON, se vinculan los datos a la plantilla mediante una sintaxis de expresión similar a LINQ y el servicio en la nube ensambla el documento final en el formato necesario.
Este enfoque elimina la necesidad de instalaciones locales de Office, bibliotecas de terceros ni motores de renderizado complejos: todo el trabajo pesado se realiza en el centro de datos seguro de GroupDocs. Se obtiene compatibilidad integrada con combinación de correspondencia, tablas dinámicas, contenido condicional, generación de códigos de barras, inserción de imágenes y gráficos, y un amplio conjunto de opciones de formato. El servicio también proporciona comunicación cifrada con SSL/TLS, claves de acceso personales para la autenticación y permisos basados en roles para mantener sus datos seguros.
Flujo de trabajo de Ruby con el SDK
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid y api_key.UploadFile.AssembleOptions que haga referencia a la plantilla cargada, especifique el formato de salida deseado y proporcione la fuente de datos XML/JSON (o un archivo que la contenga).assemble_document: la API devuelve el documento ensamblado, que puede descargar directamente o almacenar de nuevo en Cloud Storage.Con esta sencilla secuencia, puede generar contratos, facturas, propuestas, informes de envío, cartas personalizadas o cualquier otro documento crucial para el negocio bajo demanda, escalando desde una sola solicitud hasta escenarios de procesamiento por lotes con combinación de correspondencia.
El SDK de Ruby también ofrece clases auxiliares para trabajar con el almacenamiento, gestionar errores y personalizar los tiempos de espera de las solicitudes, facilitando la integración con Rails, Sinatra o cualquier servicio basado en Ruby.
Capacidades principales de la API de Assembly Cloud.
Formatos de documentos compatibles con Assembly Cloud.
Sistemas operativos y entornos de desarrollo compatibles con el SDK de Ruby.
El siguiente fragmento muestra cómo generar un documento con el SDK Ruby de Assembly Cloud. Pasos:
AssembleOptions: plantilla, formato de salida y fuente de datos.assemble_document para obtener el archivo ensamblado.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