Блок "Табличная область данных"

Назначение

Блок позволяет сформировать таблицу из нескольких срезов данных.

Для работы с блоком его необходимо выбрать из библиотеки блоков и перенести в область графа.

Настройки блока

Доступ к настройкам блока осуществляется через контекстное меню блока (пункт Настройки):

Группа "Табличная область данных"

Наименование	Тип	Обязательное	Описание	Пример
Привязки	JSON	Да	Массив с параметрами привязок срезов к их расположению в визуализаторе. Настройки параметров: - id - идентификатор входа. - row - номер "строки" для размещения среза. Номера могут идти не по порядку, в таком случае пропущенные номера будут игнорироваться. - col - номер "столбца" для размещения среза. Номера могут идти не по порядку. Номера "столбцов" должны быть уникальны только в рамках одной "строки. В данном случае "строки" и "столбцы" - это не строки и столбцы одной таблицы, а условное расположение одного среза данных в общем массиве срезов. (В одном срезе может быть больше одной строки/столбца с данными)

Пример настроек

[
    {"id": "1", "row": 2, "col": 1},
    {"id": "2", "row": 2, "col": 2},
    {"id": "3", "row": 3, "col": 1},
    {"id": "4", "row": 3, "col": 2},
    {"id": "5", "row": 4, "col": 1},
    {"id": "6", "row": 4, "col": 1}
]

Общие настройки блоков описаны в отдельном разделе.

Входы

Каждый новый срез добавляется в отдельный вход. Параметры "Обязательный" и "Массив" должны быть включены. Параметр "Идентификатор" необходимо указать в поле id в настройках "Привязки".

Для создания входа необходимо нажать на знак в разделе входов блока. Для каждого из входов задается следующий перечень полей:

Название входа	Тип	Обязательный	Описание
Идентификатор	Строка	Да	Идентификатор входа - используется внутри блока для получения доступа к данным входа
Имя	Строка	Да	Имя входа для отображения в списке входов блока
Описание	Строка	Нет	Дополнительная информация с описанием входа
Тип	Выпадающий список	Да	Тип данных, которые будут приходить на вход. Нужен для построения корректных связей с другими блоками.По умолчанию установлен тип "JSON".
Обязательный	Флаг	Да	Обязательность входа. Если вход обязательный и на него не пришло данных - блок не будет рассчитан с ошибкой
Массив	Флаг	Да	Является ли вход массивом данных

Выходы

У блока нет выходов.

События блока

У блока нет событий.

Описание работы блока

Блок формирует визуализатор таблицы на основе привязок и всех срезов, пришедших на вход.

Порядок формирования визуализатора:

• Группировка срезов по строкам

Срезы группируются по строкам в соответствии с заданными привязками.

• Формирование общего среза по строке

Для каждой строки формируется общий срез на основе привязок по столбцам.

• Выравнивание строк по высоте

  • Определяется срез с максимальным количеством строк.
  • Остальные срезы подгоняются по высоте до этого значения.
  • Если строка является первой в общем списке, в ней выполняется поиск настроек шапки. При их наличии настройки добавляются к визуализатору.

• Выравнивание таблицы по ширине

После формирования всех строк выполняется выравнивание таблицы по ширине: - Определяется строка с максимальным количеством столбцов, остальные строки подгоняются до этого значения. - Параметр columns (описание заголовков столбцов) - также подгоняется по ширине: если данных больше, чем заголовков, справа добавляются пустые заголовки. - Параметр colWidths (ширина столбцов) - также подгоняется по ширине: для недостающих значений справа проставляется значение 120.

Настройки визуализатора

Визуализатор не имеет специфических настроек. Общий список доступен на странице Настройки визуализаторов

Версия блока

Документация на версию блока

Актуально для версии блока 6

Примеры

Конструирование таблиц сложной структуры

Постановки

VISMIND-8288 Конструктор отчетов. Конструирование таблиц сложной структуры

VISMIND-8304 Конструктор отчетов. Табличный срез

VISMIND-12033: Блоки. Тип вход/выхода по умолчанию

Дополнительно

Блок "Срез"

Блок "Табличный срез"

Ссылки