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

Когда возник вопрос, как использовать данные 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 стал полезен для адептов этой технологии хранения данных.