Подключение к JSON (JavaScript Object Notation)

Это подключение позволяет передать в качестве источника данных статичный JSON файл или адрес URL, по которому он будет получен перед построением отчёта.

Мастер подключения для JSON

При создании нового подключения в дизайнере FastReport оно имеет следующий вид:

Параметр	Описание
Кодировка	Задаёт кодировку, в которой будет обработан запрос к JSON, если указана ссылка на получение JSON.
JSON или URL	Задаёт статичный JSON или ссылку на получение JSON через API.
JSON Schema	Задаёт схему JSON.
Headers	Задаёт требуемые HTTP заголовки для подключения к JSON через API (необязательно).

Справа от полей расположены кнопки для редактирования поля в отдельном окне.

Если значение JSON Schema пустое, то при нажатии кнопки OK или Test connection, будет автоматически построена схема по JSON.

Если изменить JSON или URL, когда схема уже указана, FastReport предложит обновить схему.

Окно редактирования JSON

Эта форма позволяет редактировать JSON, она имеет следующий вид:

Описание панели инструментов редактора слева направо:

1. Открыть файл — позволяет открыть JSON и вставить содержимое файла в редактор.
2. Сохранить файл — позволяет сохранить содержимое редактора в файл.
3. Кодировка — задаёт кодировку, в которой будет открыт JSON файл.
4. Форматирование — включает форматирование JSON, а также проводит валидацию JSON на соответствие спецификаций.

Далее идёт поле редактора, где можно изменить текст JSON.

Чекбокс "Переносить слова" позволит включить или отключить перенос слов в редакторе.

Как работает подключение

JSON не является таблицей, поэтому FastReport не воспринимает подключение к JSON, как таблицу данных.

Вместо этого FastReport воспринимает каждый массив из JSON, как иерархический источник данных с тремя полями:

Поле	Описание
index	Номер элемента.
item	Элемент.
array	Ссылка на массив элементов.

К DataBand можно подключить любой массив из JSON.

Далее можно использовать поля из JSON в объектах отчёта.