Когда возник вопрос, как использовать данные 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) Регистрация с помощью дизайнера отчетов:
2) Зарегистрируйтесь вручную в файле конфигурации FastReport:
<?xml version="1.0" encoding="utf-8"?>
<Config>
...
<Plugins>
<Plugin Name="c:\.....\FastReport.Json.dll"/>
</Plugins>
</Config>
3) Зарегистрируйте библиотеку в коде программы:
Зарегистрировав плагин, можете приступить к созданию источника данных в отчете. В дизайнере отчетов необходимо открыть меню: Data->Adddatasource. Запускается мастер создания источника данных:
Нажмите кнопку «New connection».
Для создания строки подключения выберите тип подключения JSONdatabase.
Далее, выберите файл с данными с расширением JSON. Необходимо уточнить, что база данных может располагаться на другом веб-ресурсе. В этом случае в качестве пути к базе данных нужно указать url. Нажмите «Ок».
В мастере создания источника данных нажмите кнопку «Next».
Отметьте нужные таблицы. Например, Products. Нажмите «Finish».
В окне «Данные» появится выбранная таблица. Добавьте на бэнд данные поля: ProductName, UnitsInStock, UnitPrice и запустите отчет.
Очевидно, что работать с данными из базы JSON также удобно, как и с любым другим источником. Теперь FastReport.Net стал полезен для адептов этой технологии хранения данных.