Создавайте документы с помощью Ruby SDK
REST API и Ruby Cloud SDK для сборки, слияния и выполнения mail‑merge документов из шаблонов и источников данных.
REST API и Ruby Cloud SDK для сборки, слияния и выполнения mail‑merge документов из шаблонов и источников данных.
GroupDocs.Assembly Cloud - полностью управляемый сервис на основе REST, который позволяет вам создавать высококастомизированные документы напрямую из ваших приложений Ruby. Платформа работает по модели «шаблон‑данные»: вы разрабатываете шаблон документа (Word, Excel, PowerPoint, PDF, HTML и др.), содержащий специальные поля‑заполнители и программируемые конструкции. Во время выполнения вы предоставляете источник данных в формате XML или JSON, связываете данные с шаблоном с помощью синтаксиса выражений в стиле LINQ, и облачный сервис собирает окончательный документ в нужном вам формате.
Такой подход устраняет необходимость в локальных установках Office, сторонних библиотеках или сложных движках рендеринга - вся тяжёлая работа выполняется в защищённом дата‑центре GroupDocs. Вы получаете встроенную поддержку mail‑merge, динамических таблиц, условного контента, генерации штрих‑кодов, вставки изображений и диаграмм, а также широкий набор параметров форматирования. Сервис также обеспечивает SSL/TLS зашифрованную связь, персональные ключи доступа для аутентификации и ролевые разрешения для защиты ваших данных.
GroupDocs.Assemblygem install groupdocs_assembly_cloud).app_sid и api_key.UploadFile.AssembleOptions, который ссылается на загруженный шаблон, указывает требуемый формат вывода и предоставляет источник данных XML/JSON (или файл, содержащий его).assemble_document - API возвращает собранный документ, который вы можете скачать напрямую или сохранить обратно в Cloud Storage.Используя эту простую последовательность, вы можете генерировать контракты, счета‑фактуры, предложения, отчёты по отгрузкам, персонализированные письма или любые другие бизнес‑критичные документы по запросу, масштабируя от одиночного запроса до крупных сценариев пакетной обработки с mail‑merge.
Ruby SDK также предоставляет вспомогательные классы для работы с хранилищем, обработки ошибок и настройки тайм‑аутов запросов, обеспечивая бесшовную интеграцию с Rails, Sinatra или любым сервисом на основе Ruby.
Основные возможности Assembly Cloud API.
Поддерживаемые форматы документов для Assembly Cloud.
Операционные системы и среды разработки, поддерживаемые Ruby SDK.
Ниже приведён фрагмент кода, показывающий, как создать документ с помощью Assembly Cloud Ruby SDK. Выполненные шаги:
AssembleOptions - шаблон, формат вывода и источник данных.assemble_document, чтобы получить собранный файл.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