Как использовать данные в формате JSON в отчётах

15.02.2017

Когда возник вопрос, как использовать данные JSON в своих веб-отчетах, реализовать это в FastReport.Net было проблематично. Это стало возможным с появлением новой  версия 2016.2.

Необходимо уточнить, что JSON (JavaScriptObjectNotation) –  текстовый формат обмена данными основанный на JavaScript. Активно применяется в web-программировании при обмене данными между браузером и сервером или между серверами. По сравнению с XML этот формат более лаконичен и его удобнее использовать с JavaScript.

В данной  статье я будет подробно описан алгоритм использования данных в формате JSON в отчете FastReport.Net. Такая возможность появилась в FastReport.Net2016.2.

Во-первых, необходимо собрать плагин коннекшена к json данным. Расположен он тут: C:\ProgramFiles (x86)\FastReports\FastReport.Net\Extras\Connections\FastReport.Json.

Рассмотрим действия пошагово:

1)      Откройте солюшен FastReport.Json.sln. Для удачного билда потребуется исправить ссылку на библиотеку System.Data.Json.dll, которая размещается тут: C:\ProgramFiles (x86)\FastReports\FastReport.Net\Demo.

2)      Для получения библиотеки FastReport.Json.dll необходимо компилировать проект.

 Есть три способа регистрации плагина в дизайнере отчетов:

 1)      Регистрация с помощью дизайнера отчетов:

  • Откройте дизайнер отчетов. Он может быть как в составе проекта VisualStudio, так и  отдельное приложение;
  • Добавьте плагин.  Сделать это можно в меню: View->Options…, вкладка Plugins. Добавьте новый плагин, с помощью кнопки Add. Выберите скомпилированную ранее библиотеку FastReport.Json.dll;

 

  • Перезапустите редактор отчетов.

2)      Зарегистрируйтесь вручную в файле конфигурации FastReport:

  • По умолчанию этот файл располагается в директории:"C:\Documents and Settings\user_name\Local Settings\Application Data\FastReport";
  • Закройте все запущенные экземпляры FastReport.Net;
  • Откройте файл конфигурации любым текстовым редактором и исправьте следующие строки:

<?xml version="1.0" encoding="utf-8"?>

<Config>

...

<Plugins>

<Plugin Name="c:\.....\FastReport.Json.dll"/>

</Plugins>

</Config>

3)      Зарегистрируйте библиотеку в коде программы:

  • Добавьте ссылку на библиотеку FastReport.Json.dll в проект;
  • Выполните следующий код единожды при запуске программы: FastReport.Utils.RegisteredObjects.AddConnection(typeof(JsonDataConnection)).

Зарегистрировав плагин, можете приступить к созданию источника данных в отчете. В дизайнере отчетов необходимо открыть меню: Data->Adddatasource. Запускается мастер создания источника данных:

 

Нажмите кнопку «New connection».

 

Для создания строки подключения выберите тип подключения  JSONdatabase.

 

Далее, выберите файл с данными с расширением JSON. Необходимо уточнить, что база данных может располагаться на другом веб-ресурсе. В этом случае в качестве пути к базе данных нужно указать url. Нажмите «Ок».

 

В мастере создания источника данных нажмите кнопку «Next».

 

Отметьте нужные таблицы. Например, Products. Нажмите «Finish».

 

В окне «Данные» появится выбранная таблица. Добавьте на бэнд  данные поля: ProductName, UnitsInStock, UnitPrice и запустите отчет.

 

Очевидно, что работать с данными из базы JSON также удобно, как и с любым другим источником. Теперь FastReport.Net стал полезен для адептов этой технологии хранения данных.

1 ноября 2024

Новые возможности редактора отчетов FastReport VCL

Рассматриваем новые возможности редактора отчетов: выносные линии, подсветка пересекающихся объектов, обновлённые деревья отчетов и данных.
30 октября 2024

Использование стилей при создании отчетов в FastReport VCL

В статье подробно рассматривается одна из новых возможностей FastReport VCL – применение стилей и страниц стилей.
28 октября 2024

Как настроить WSL 2 для работы с FastReport и FastCube

В этой статье попробуем вместе разобраться, как настроить WSL 2 для работы с компонентами FastReport и FastCube в Lazarus для Linux.