Блок "Диаграмма"
Блок доступен начиная с версии 0.1
Назначение
Блок формирует диаграмму на основе массива рядов, полученного от другого блока. Для начала работы с блоком его необходимо выбрать в библиотеке блоков и перенести в область графа.
Настройки блока
Группа "Основные свойства"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Наименование блока | Строка | Да | Поле позволяет задать наименование блоку | "Диаграмма OLAP градиент" |
Группа "Настройки визуализатора"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Заголовок визуализатора | Строка | Да | Поле позволяет задать заголовок диаграмме, который будет отображаться на пресете. Заголовок можно задавать с помощью Jinja-шаблона | "Диаграмма OLAP" |
Группа "Диаграмма"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Тип диаграммы | Выпадающий список | Да | Выбор типа диаграммы. Возможные варианты: - Линейная - Столбчатая - С областями - Смешанная - Круговая - Радар - Горизонтальная - Кольцевая - Каскадная |
По умолчанию используется "Линейная" |
| Накопление | Флаг | Нет | Отображать диаграмму с накоплением | |
| Сортировка | Выпадающий список | Да | Выбор способа сортировки рядов данных. Возможные варианты: - Без сортировки - По дате/алфавиту (убывание) - По дате/алфавиту (возрастание) - По значению (убывание) - По значению (возрастание) |
По умолчанию используется "По дате/алфавиту (возрастание)" |
| Количество знаков после запятой | Целое число | Да | Настройка количества знаков после запятой у данных, которые отобразятся на диаграмме | |
| Масштабирование данных | Флаг | Нет | Включить масштабирование данных | |
| Количество отображаемых точек | Целое число | Нет | Отображается, если включена настройка "Масштабирование данных". Количество отображаемых точек при включенном масштабировании данных | |
| Отображать легенду | Флаг | Нет | Включение или отключение отображения легенды | |
| Размещение легенды | Выпадающий список | Нет | Выбор расположения легенды на диаграмме. Возможные варианты: - Вверху - Слева - Внизу - Справа |
По умолчанию используется "Внизу" |
| Размер шрифта | Целое число | Нет | Размер шрифта легенды диаграммы |
Группа "Привязки"
Настройка осуществляет привязку наименований рядов и точек данных к отдельным атрибутам ряда.
Приложение позволяет задавать привязки как в рукописной форме (через поле ввода JSON), так и через выбор элементов из выпадающего
списка. Переключение осуществляется с помощью кнопки 
.
Настройки, указанные в рукописной форме и в выпадающем списке, независимы друг от друга — изменения в одном месте не применяются в другом. Для того чтобы выпадающие списки отображали актуальные настройки, на вход блока должны передаваться данные из уже рассчитанного блока.
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Наименование ряда данных | Выпадающий список | Нет | Ключ атрибута, отвечающего за наименование ряда. Можно выбрать несколько значений. В таком случае, они будут отображаться через разделитель "-" | |
| Наименование точек данных | Выпадающий список | Нет | Ключ атрибута, отвечающий за наименование точек. Для временных рядов, в качестве точек используется дата, формат которой определяется маской времени (см. выше). В случае, если поле не задано, то по умолчанию проставляются ключи точек. | |
| Описание привязок | JSON | Нет | Используются для отображения корректных наименований точек и рядов с данными. Возможные параметры: - name - Ключ атрибута, отвечающего за наименование ряда. Возможно указать, как строковое значение, так и массив из нескольких строк. В таком случае, они будут отображаться через разделитель "-". - label - Ключ атрибута, отвечающий за наименование точек. Строковое значение. Для временных рядов, в качестве точек используется дата, формат которой определяется маской времени (см. выше). В случае, если поле не задано, то по умолчанию проставляются ключи точек. |
Группа "Оси данных"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Маска оси времени | Строка | Нет | Настройка отображения даты в диаграмме, используется только для временных рядов |
Для применения маски, переданной с настройками временных рядов, поле требуется оставить пустым. Маска используется только для отображения временной шкалы в формате, удобном пользователю.
Для корректной работы совместно с блоком "Анимация" дата должна быть указана в формате** "%d.%m.%Y".
Дату для маски необходимо указывать в формате Python.
Список всех доступных форматов для маски представлен ниже:
Доступные форматы для маски
%a Weekday as locale’s abbreviated name. Mon
%A Weekday as locale’s full name. Monday
%w Weekday as a decimal number, where 0 is Sunday and 6 is Saturday. 1
%d Day of the month as a zero-padded decimal number. 30
%-d Day of the month as a decimal number. (Platform specific) 30
%b Month as locale’s abbreviated name. Sep
%B Month as locale’s full name. September
%m Month as a zero-padded decimal number. 09
%-m Month as a decimal number. (Platform specific) 9
%y Year without century as a zero-padded decimal number. 13
%Y Year with century as a decimal number. 2013
%H Hour (24-hour clock) as a zero-padded decimal number. 07
%-H Hour (24-hour clock) as a decimal number. (Platform specific) 7
%I Hour (12-hour clock) as a zero-padded decimal number. 07
%-I Hour (12-hour clock) as a decimal number. (Platform specific) 7
%p Locale’s equivalent of either AM or PM. AM
%M Minute as a zero-padded decimal number. 06
%-M Minute as a decimal number. (Platform specific) 6
%S Second as a zero-padded decimal number. 05
%-S Second as a decimal number. (Platform specific) 5
%f Microsecond as a decimal number, zero-padded on the left. 000000
%z UTC offset in the form +HHMM or -HHMM (empty string if the the object is naive).
%Z Time zone name (empty string if the object is naive).
%j Day of the year as a zero-padded decimal number. 273
%-j Day of the year as a decimal number. (Platform specific) 273
%U Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0. 39
%W Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0. 39
%c Locale’s appropriate date and time representation. Mon Sep 30 07:06:05 2013
%x Locale’s appropriate date representation. 09/30/13
%X Locale’s appropriate time representation. 07:06:05
%% A literal '%' character. %
Пример настройки маски даты
Группа "Общие настройки стилей рядов"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Вид линии | Выпадающий список | Нет | Выбор вида линии на диаграмме. Возможные варианты: - Прямая - линия не скругляется в точках - Сглаженная - линия скругляется в точках |
По умолчанию используется "Прямая" |
| Вид раскраски | Выпадающий список | Нет | Выбор вида раскраски ряда диаграммы. Возможные варианты: - Отсутствует - Цветовой градиент - Градиент прозрачности |
По умолчанию используется "Отсутствует" |
| Начальный цвет | Настройка цвета | Нет | Отображается, если выбран вид раскраски "Цветовой градиент". Выбор начального цвета для градиента. |
|
| Конечный цвет | Настройка цвета | Нет | Отображается, если выбран вид раскраски "Цветовой градиент". Выбор конечного цвета для градиента. |
|
| Каскадная диаграмма - начальный цвет | Настройка цвета | Нет | Отображается, если выбран тип диаграммы "Каскадная". Начальный цвет каскадной диаграммы. |
|
| Каскадная диаграмма - убывающий цвет | Настройка цвета | Нет | Отображается, если выбран тип диаграммы "Каскадная". Убывающий цвет каскадной диаграммы. |
|
| Каскадная диаграмма - растущий цвет | Настройка цвета | Нет | Отображается, если выбран тип диаграммы "Каскадная". Растущий цвет каскадной диаграммы. |
|
| Выводить линию | Флаг | Нет | Отображать или нет линию на диаграмме | |
| Тип линии или границы | Выпадающий список | Нет | Выбор типа отображения линии на диаграмме. Возможные варианты: - Сплошная линия - Штриховая линия - Линия из точек - Штрихпунктирная линия - Штрихпунктирная линия с двумя точками |
По умолчанию используется "Сплошная линия" |
| Толщина линии, пт | Целое число | Нет | Толщина линии на диаграмме. Минимальное значение - 1, максимальное - 10. | |
| Тип маркера | Выпадающий список | Нет | Тип маркера на диаграмме Возможные варианты: - Круг - Треугольник - Квадрат - Квадрат с закругленными углами - Ромб - Крестик - Перекрестие - Звездочка - Линия - Черта |
По умолчанию используется "Круг" |
| Размер маркера | Целое число | Нет | Размер маркера на диаграмме | |
| Показывать подписи данных | Флаг | Нет | Показывать или нет подписи данных | |
| Подписи данных - положение | Выпадающий список | Нет | Местоположение подписей данных. Возможные значения: - В центре - Слева - Сверху - Справа - Снизу |
По умолчанию используется "В центре" |
| Подписи данных - размер шрифта | Целое число | Нет | Размер шрифта подписей данных | |
| Подписи данных - цвет шрифта | Настройка цвета | Нет | Цвет шрифта подписей данных |
Группа "Цвета точек для круговой диаграммы"
В группе задаются цвета точек для круговой и кольцевой диаграмм. Если цвет для точки не задан или количество точек превышает число выбранных цветов, применяются цвета по умолчанию.
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Название точки | Строка | Нет | Название точки с выбранным цветом. Используется только в настройках блока | |
| Цвет | Настройка цвета | Нет | Выбор цвета для точки |
Группа "Ряды данных"
В группе задаются настройки для отдельных рядов данных. Номер настройки определяет номер ряда, к которому будут применены данные настройки. Для рядов, у которых не указаны настройки, будут применены "Общие настройки стилей рядов".
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Название ряда | Строка | Нет | Название ряда данных |
Для использования названия из привязок необходимо оставить значение данного атрибута пустым.
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Отображать ряд | Флаг | Нет | Отобразить или скрыть ряд в настройках диаграммы |
Для передачи данных в рамках условного форматирования необходимо задать атрибут style.showRow.
Условное форматирование задается для отдельной точки ряда, в то время как отображение ряда является общим.
Поэтому возможно применить форматирование только для одной точки. Если будет передано несколько значений, будет использовано последнее из них.
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Тип ряда | Выпадающий список | Нет | Тип ряда данных. Используется только для диаграммы с типом "Смешанная". Возможные значения: - По умолчанию - Линия - Столбец |
По умолчанию используется "По умолчанию" |
| Отображение выделения | Флаг | Нет | Отображается, если выбран тип ряда "Столбец". Выделение столбца при клике на нем. | |
| Горизонтальное смещение | Флаг | Нет | Отображается, если выбран тип ряда "Столбец". Отображение столбцов со смещением. | |
| Вид линии | Выпадающий список | Нет | Выбор вида линии на диаграмме. Возможные варианты: - Прямая - линия не скругляется в точках - Сглаженная - линия скругляется в точках |
По умолчанию используется "Прямая" |
| Цвет | Настройка цвета | Нет | Цвет конкретного ряда данных | |
| На дополнительную ось | Флаг | Нет | Отображение ряда данных на дополнительной оси | |
| Выводить линию | Флаг | Нет | Отображение линии ряда для линейной диаграммы | |
| Тип линии или границы | Выпадающий список | Нет | Выбор типа отображения ряда данных на диаграмме. Возможные варианты: - По умолчанию - использовать "Общие настройки стилей рядов" - Сплошная линия - Штриховая линия - Линия из точек - Штрихпунктирная линия - Штрихпунктирная линия с двумя точками |
По умолчанию используется "По умолчанию" |
| Толщина линии, пт | Целое число | Нет | Толщина линии на диаграмме. Минимальное значение - 1, максимальное - 10. | |
| Тип маркера | Выпадающий список | Нет | Тип маркера на диаграмме Возможные варианты: - По умолчанию - использовать "Общие настройки стилей рядов" - Круг - Треугольник - Квадрат - Квадрат с закругленными углами - Ромб - Крестик - Перекрестие - Звездочка - Линия - Черта |
По умолчанию используется "По умолчанию" |
| Размер маркера | Целое число | Нет | Размер маркера на диаграмме | |
| Показывать подписи данных | Флаг | Нет | Показывать подписи данных | |
| Подписи данных - положение | Выпадающий список | Нет | Местоположение подписей данных. Возможные значения: - По умолчанию - использовать "Общие настройки стилей рядов" - В центре - Слева - Сверху - Справа - Снизу |
По умолчанию используется "По умолчанию" |
| Подписи данных - размер шрифта | Целое число | Нет | Размер шрифта подписей данных | |
| Подписи данных - цвет шрифта | Настройка цвета | Нет | Цвет шрифта подписей данных |
Группа "Коридоры"
Коридоры диаграммы позволяют отображать на графике допустимые границы значений. Могут быть заданы:
- фиксированными значениями (верхняя и нижняя границы);
- динамически. на основе данных из других блоков.
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Название коридора | Строка | Нет | Название коридора. Используется только в настройках блока | |
| Индекс ряда 1 | Целое число | Нет | Индекс ряда для первой границы коридора | |
| Индекс ряда 2 | Целое число | Нет | Индекс ряда для второй границы коридора | |
| Цвет | Настройка цвета | Нет | Цвет коридора |
Индексы рядов начинаются с 1
Группа "Ось X"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Размер шрифта | Целое число | Нет | Размер шрифта надписей на оси | |
| Начертание | Выпадающий список | Нет | Начертание шрифта надписей. Возможные варианты: - Обычный - Курсив - Полужирный |
По умолчанию используется "Обычный" |
| Перенос по словам | Флаг | Нет | Включить перенос надписей по словам | |
| Поворот надписи | Выпадающий список | Нет | Настройки поворота надписей. Возможные варианты: - Автоматически (по умолчанию) - Отображать горизонтально |
По умолчанию используется "Автоматически (по умолчанию)" |
Подгруппа "Сетка"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Отображать линии | Флаг | Нет | Отображать линии сетки | |
| Цвет линии | Настройки цвета | Нет | Цвет линии сетки | |
| Толщина линии | Вещественное число | Нет | Толщина линии сетки | |
| Тип штриха | Выпадающий список | Нет | Выбор типа штриха линии. Возможные варианты: - Сплошная линия - Штриховая линия - Линия из точек - Штрихпунктирная линия - Штрихпунктирная линия с двумя точками |
По умолчанию используется "Сплошная линия" |
Подгруппа "Деления"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Количество | Целое число | Нет | Количество делений. При отметке 0 - деления не указываются | |
| Пропускать подписи оси | Флаг | Нет | В случае включения - оси диаграмм выводятся подряд | |
| Отступ | Целое число | Нет | Отступ делений |
Группа "Ось Y"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Размер шрифта | Целое число | Нет | Размер шрифта надписей на оси |
Подгруппа "Сетка"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Отображать линии | Флаг | Нет | Отображать линии сетки | |
| Цвет линии | Настройки цвета | Нет | Цвет линии сетки | |
| Толщина линии | Вещественное число | Нет | Толщина линии сетки | |
| Тип штриха | Выпадающий список | Нет | Выбор типа штриха линии. Возможные варианты: - Сплошная линия - Штриховая линия - Линия из точек - Штрихпунктирная линия - Штрихпунктирная линия с двумя точками |
По умолчанию используется "Сплошная линия" |
Подгруппа "Деления"
| Наименование | Тип | Обязательное | Описание | Пример |
|---|---|---|---|---|
| Количество | Целое число | Нет | Количество делений. При отметке 0 - деления не указываются | |
| Пропускать подписи оси | Флаг | Нет | В случае включения - оси диаграмм выводятся подряд | |
| Отступ | Целое число | Нет | Отступ делений |
Настройки связи
| Наименование | Тип | Обязательный | Описание |
|---|---|---|---|
| Управляемый блок | флаг | Нет | определяет критичность блока для выполнения графа: если флаг установлен, ошибка в блоке приводит к остановке всего расчета; если флаг снят, ошибка в блоке игнорируется, и расчет продолжается |
| Наименование | Строка | Нет | Наименование связи |
Общие настройки блоков описаны в отдельном разделе.
Входы
| Название входа | Тип | Обязательный | Описание |
|---|---|---|---|
| Данные | Ряд данных | Да | Массив данных с типом "Ряд данных" |
| Привязки | Строка | Нет | Привязки которые приходят на вход блока используются вместо параметра настроек "Привязки". |
Вход "Привязки" имеет наивысший приоритет среди всех вариантов настройки привязок
При динамической перестройке (например, когда таблица является частью OLAP-структуры) использование статичных привязок может привести к некорректному отображению данных. В таких случаях в таблицу необходимо передавать привязки динамически. Формат передаваемых привязок соответствует описанию, приведенному в настройке "Описание привязок".
Выходы
Блок «Диаграмма» не предоставляет стандартных выходов для передачи данных. Однако у него есть событийные выходы, которые могут использоваться для обработки действий пользователя (например, нажатие на ряд диаграммы).
События блока
| Название выхода | Тип | Описание |
|---|---|---|
| Событие нажатия на точку - Временные ряды | Ряд данных | Данные ряда, на который было осуществЛено нажатие |
Описание работы визуализатора
Чтобы отредактировать данные, необходимо нажать на кнопку "Редактировать данные" в локальном меню:
Особенность работы диаграммы, стоящей после события
-
Если блок-визуализатор диаграммы находится после события (например, изменение отметки в таблице), то после обновления по отметке диаграмма будет отображать ряд, который был выбран пользователем в момент нажатия.
-
При отсутствии выбранного ряда после обновления — эмулируется нажатие на первый ряд.
- Если рядов нет — событие не происходит.
Настройки визуализатора
Визуализатор не имеет специфических настроек. Общий список доступен на странице Настройки визуализаторов