Автоматизируйте создание DOCX документов в Ruby, создавайте готовые к печати DOCX отчеты любой сложности с помощью Ruby SDK. Это облачное решение построено на основе шаблонов, источников данных и мощного LINQ синтаксиса, что дает Ruby разработчикам гибкость для точного соответствия техническим и бизнес-требованиям.
Используя эту Ruby библиотеку, вы можете программно создавать настраиваемые DOCX отчеты в любой операционной системе. Красиво отформатированные DOCX документы, такие как контракты, заказы, счета-фактуры, отчеты об отгрузке, коммерческие предложения, накладные, могут быть собраны на лету как часть вашего Ruby ПО.
Важность автоматизации документов и создания отчетов значительно возросла за последние десятилетия. Практически у каждой компании есть потребность формировать документы и вовремя доставлять их партнерам или клиентам. Более того, это обычно является решающим фактором финансового успеха. Внедрение таких технологий может привести к значительной экономии финансовых средств за счет сокращения ручного ввода данных, человеческих ошибок, корректуры и бумажной работы. По этим причинам средства автоматизации документооборота и отчетности являются неотъемлемой частью многих современных программных решений, цель которых — предоставить пользователям расширенные аналитические функции.
Вообще говоря, генерация DOCX отчета — это процесс, который объединяет текст, данные и графику в единое целое и экспортирует результат в формат DOCX файла в наглядном виде. Для получения информации о поддерживаемых форматах ввода/вывода посетите нашу документацию.
GroupDocs Assembly for Ruby — это облачное решение для создания DOCX документов с использованием шаблонов и источников данных. Шаблон документа выступает в роли базового каркаса, который, помимо стандартного содержимого (текст, таблицы, диаграммы и пр.), включает специальные поля-заполнители для вставки значений из источника данных. Вставлять можно не только отдельные значения, но и целые массивы данных в виде таблиц и графиков.
Шаблон также содержит программные конструкции — правила генерации DOCX документов, управляющие выбором данных и обработкой условий. Для привязки данных к шаблону документа используется синтаксис LINQ выражения, который позволяет разработчикам обрабатывать данные универсальным способом, независимо от типа используемого источника данных. Таким образом, наш Ruby Cloud SDK обеспечивает гибкость при создании DOCX контента и мощный набор методов для обработки данных.
Этот продукт также поддерживает функции Mail Merge, если вы хотите создавать и отправлять клиентам пакеты персонализированных писем в DOCX формате. Вам просто нужно вставить поля Mail Merge в шаблон документа и передать его в Cloud API вместе с источником данных.
Независимо от масштаба и типа автоматизации DOCX документов, которую вы собираетесь внедрить, создание отчета на Ruby состоит из трех шагов:
Разработка шаблонов — сложная задача. Помимо четкого понимания требований к итоговому DOCX документу, потребуются аналитические навыки и навыки программирования. Хороший дизайн шаблона должен отражать точку зрения заказчика на тот или иной вопрос. Наиболее эффективным подходом является сочетание табличных данных и графики в правильном соотношении, которое определяется бизнес-требованиями.
Как упоминалось выше, структура шаблона обычно содержит некоторые фиксированные блоки контента (текст, изображения, логотипы и пр.), смешанные со специальными программными конструкциями, управляющими логикой сборки DOCX документа. Эти правила генерации DOCX документов определяются с помощью специального синтаксиса выражений, который позволяет разработчикам делать следующее:
Вы можете узнать больше о синтаксисе шаблонов в нашем Руководстве разработчика.
GroupDocs Assembly for Ruby не требует установки какого-либо внешнего ПО или сторонних инструментов. Это облачное решение для DOCX, где все программные взаимодействия выполняются по сети с использованием REST API.
Все продукты GroupDocs полностью соответствуют отраслевым стандартам безопасности: передача данных осуществляется по протоколу SSL, что исключает возможность перехвата информации третьими лицами. Для подключения к облачным службам GroupDocs вам необходимо использовать личные ключи доступа. Пожалуйста, обратитесь к краткому руководству.
В следующем примере кода показано, как создавать DOCX отчеты с помощью Ruby.
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Установите GroupDocs.Assembly Cloud SDK for Ruby, используя хостинг RubyGems. Выполните команду gem install groupdocs_assembly_cloud, чтобы установить пакет. Как вариант, вы можете вручную клонировать исходный код GroupDocs.Assembly Cloud SDK for Ruby с GitHub и использовать его в своем проекте. Следуйте этим Инструкциям, чтобы быстро получить учетные данные и доступ к нашему REST API.
Ruby 2.6 или новее
Обратитесь к Документации Репозитория, чтобы получить более подробную информацию.
Вы можете создавать отчеты в других форматах файлов: