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