Перейти к содержанию

Блок "Показатели"

Блок доступен начиная с версии 0.20

Назначение блока

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

Так же доступен write-back для поля со значением.

Данная страница содержит описание настроек блока. Описание мастера настройки блока см. Мастер настройки показателей.

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

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

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

Модальное окно выглядит следующим образом:

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

Раздел "Показатели"

Название параметра Тип параметра Обязательный Описание Пример
Привязка дополнительных параметров JSON Нет Привязки формируют раздел условий при расчете блока.
Необходимы для параметризации запроса на извлечение данных из справочника

Пример привязок

[
    {"<Идентификатор поля в таблице>": "{{ '{{' }} <Jinja шаблон с выбранным полем> }}"}, <Единичный элемент>
    {"<Идентификатор поля в таблице>": "{{ '{{' }} <Jinja шаблон с выбранным массивом полей>|join(', ') }}" <Массив>
]

Для массива требуется, чтобы в параметре была структура со значениями через запятую (пример: 0,1,2,3).

Используемый в примере вариант, где:

<массив с данными>|join(', ', attribute='<атрибуты элементов массива, которые необходимо добавить в массив, опционально>')

[
    {"id": "{{ '{{' }} input[0].pkey.id }}"},
    {"region_id": "{{ '{{' }} input|join(', ', attribute='pkey.region_id') }}"
]

Входы блока

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

Название входа Тип Обязательный Описание
БД Соединение с БД Да Соединение с базой данных, из которой необходимо извлекать данные
Дополнительные параметры Ряд данных Нет Массив объектов или временных рядов, атрибуты которых могут быть использованы для параметризации запроса по извлечению данных (при расчете блока)

Поддерживаются разные диалекты баз, а именно:

  • PostgreSQL
  • MSSQL
  • Oracle

ClickHouse не поддерживается данным типом блока.

Выходы блока

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

Название выхода Тип Описание
Данные Ряд данных Массив рядов данных
Шаблон элемента ряда, выходящего из блока 
{       
    "pkey": [<Набор первичных ключей>],     
    "vl": [<Массив значений ряда>],     
    "attrs": [<Набор атрибутов - полей, не попавших ни в первичный ключ, ни в значение>],       
    "_params": {
        <Опциональные параметры объекта>,           
        "vl": <Ключ поля, отвечающего за значение>,         
        "fkey": [<Ключ поля, по которому собран ряд>]       
        },      
    "_source": <Идентификатор блока-источника, поле заполняется калькулятором автоматически>    
}

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

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

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

После настройки блока (и, при необходимости, создания таблицы) с помощью мастера показателей, дальнейший расчет блока выполняется аналогично блоку SQL-запрос для рядов.

Полезные ссылки