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