Genera documentos con Ruby SDK
REST API y Ruby Cloud SDK para ensamblar, combinar y hacer combinación de correspondencia de documentos a partir de plantillas y fuentes de datos.
REST API y Ruby Cloud SDK para ensamblar, combinar y hacer combinación de correspondencia de documentos a partir de plantillas y fuentes de datos.
GroupDocs.Assembly Cloud es un servicio totalmente gestionado, basado en REST, que te permite crear documentos altamente personalizados directamente desde tus aplicaciones Ruby. La plataforma funciona con un modelo de plantilla y datos: diseñas un documento plantilla (Word, Excel, PowerPoint, PDF, HTML, etc.) que contiene campos de marcador de posición especiales y construcciones programables. En tiempo de ejecución, proporcionas una fuente de datos en formato XML o JSON, enlazas los datos a la plantilla usando una sintaxis de expresiones al estilo LINQ, y el servicio en la nube ensambla el documento final en el formato que necesitas.
Este enfoque elimina la necesidad de instalaciones locales de Office, bibliotecas de terceros o motores de renderizado complejos; todo el trabajo pesado se realiza en el seguro centro de datos GroupDocs. Obtienes soporte incorporado para mail‑merge, 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 ofrece comunicación cifrada SSL/TLS, claves de acceso personales para la autenticación y permisos basados en roles para mantener tus datos seguros.
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 – el API devuelve el documento ensamblado, que puedes descargar directamente o almacenar de nuevo en Cloud Storage.Con esta secuencia sencilla puedes generar contratos, facturas, propuestas, informes de envío, cartas personalizadas o cualquier otro documento crítico para el negocio bajo demanda, escalando desde una única solicitud hasta escenarios de procesamiento por lotes con mail‑merge.
El Ruby SDK también ofrece clases auxiliares para trabajar con almacenamiento, manejar errores y personalizar los tiempos de espera de las solicitudes, facilitando la integración con Rails, Sinatra o cualquier servicio basado en Ruby de forma fluida.
Capacidades principales del Assembly Cloud API.
Formatos de documento compatibles con Assembly Cloud.
Sistemas operativos y entornos de desarrollo compatibles con el Ruby SDK.
El fragmento siguiente muestra cómo generar un documento usando el Assembly Cloud Ruby SDK. Pasos realizados:
AssembleOptions – plantilla, formato de salida y origen 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