Редактор формул

В этой статье

Редактор формул

Редактор формул — это полноэкранный текстовый редактор, который появляется при клике на поле Формула или когда требуется ввести формулу вручную, выбрав пункт Настроить. Редактор формул можно использовать при настройке:

Разреза
Меры
Переменной
Цвета
Условия отображения вкладки
Условия отображения меры
Условия отображения разреза
Способа ввода данных при запуске скрипта из дашборда

В формулах доступно использование функций ClickHouse. Ознакомиться с ними можно на официальном сайте ClickHouse.

Особенности работы с формулами

При работе с формулами необходимо учитывать некоторые особенности:

Если в формуле используется функция multiIf, у которой в параметрах указаны колонки из разных таблиц, данные могут отображаться некорректно. Например, когда решено использовать функцию для переключения отображения меры на графике в зависимости от набора условий.
В этом случае рекомендуем вместо функции использовать условие отображения для меры. Для каждой меры задайте отдельное условие отображения в виджете. При таком методе будут получены точные данные без необходимости приводить меры к единому формату, как требует функция
В формулах недопустимо обрамлять знаком грависа названия таблиц и колонок, так как это может приводить к ошибкам в вычислениях. Вместо грависов необходимо использовать двойные " кавычки. Для обрамления строковых значений используются одинарные ' кавычки
Специальный символ !, установленный перед переменной, отменит оборачивание значения переменной в одинарные кавычки
В Proceset допустимо использовать переменные в качестве имени колонки в формулах показателей с помощью переменной Список колонок. Динамически подставляемые колонки в значение такой переменной могут иметь различный тип данных. Это может приводить к ошибкам в формулах. Предупредить возникновение подобных ошибок можно двумя способами:
- Обеспечить неизменяемость типа данных колонок, имена которых используются в переменных (в формулах показателей)
- Установить зависимость типа данных показателя от переменной в YAML-редакторе, как в примере ниже, где в ключ dbDataType передается значение переменной, которая хранит требуемый тип данных

dimensionsAndMeasures:
  - name: Формула
    type: DIMENSION
    value:
      mode: FORMULA
      formula: '!"inputs"."Вводимое значение"."priority"'
    dbDataType: '"inputs"."Вводимое значение 1"'

Переменные

Во вкладке Переменные находятся системные переменные и переменные дашборда.

Чтобы найти необходимую переменную, воспользуйтесь поиском.

Чтобы добавить в формулу переменную, кликните по ней.

Важно

Если в дашборде не было создано ни одной пользовательской переменной, то эта вкладка не отображается.

Системные переменные

Системные переменные используются для получения текущих значений отдельных системных параметров.

Чтобы получить значение системной переменной, у пользователя должна быть привилегия Доступы пользователей с операцией R.

Доступны следующие системные переменные:

currentEmployeeId
currentEmployeeEmail
Login

Переменные currentEmployeeId, currentEmployeeEmail и Login позволяют передавать в скрипт информацию о пользователе при запуске действия из дашборда. Также их можно использовать для фильтрации данных в зависимости от пользователя. Для этого установите фильтр на виджет, используя системную переменную. Каждый пользователь будет видеть только персональные данные.

Переменная currentEmployeeId содержит идентификатор текущего пользователя дашборда. Использование переменной позволяет избежать обращения к таблице «employee» для определения id по логину.

Переменная currentEmployeeEmail содержит email текущего пользователя дашборда.

Переменная Login содержит логин текущего пользователя дашборда.

Важно

Если название переменной, созданной пользователем, совпадает с названием системной переменной, значение системной переменной будет заменено на значение созданной. Чтобы вернуть значение системной переменной, переименуйте созданную переменную.

Таблицы и колонки

Во вкладке Таблицы и колонки можно выбрать таблицы, которые были добавлены в пространство. Для этого нажмите кнопку Показать таблицу и выберите нужную в раскрывающемся списке.

Найти нужную таблицу можно с помощью поиска.

Список из колонок отображается только после выбора таблицы. Возможен показ сразу нескольких таблиц и их колонок.

Чтобы добавить в формулу колонку, кликните по ней. Чтобы найти нужную колонку, выберите таблицу и введите название колонки в поле поиска.

При написании формулы можно использовать автозаполнение для названий таблиц и колонок из списка справа. Чтобы использовать автозаполнение, начните вводить название колонки или таблицы и нажмите Ctrl+Space. Если возможны несколько вариантов заполнения, они появятся под формулой в виде списка. Если доступно только одно совпадение, оно подставится автоматически.

Заметка

Если название таблицы или колонки содержит двойной дефис --, то в редакторе формул строка формулы после этих символов будет отображаться как комментарий.
Если в двух и более пространствах есть таблицы с одинаковым названием, то при открытии таблицы в редакторе первого пространства ее показ сохранится и в редакторе других пространств до закрытия браузера.

После того, как формула готова, нажмите Сохранить.

Поиск и замена значений

В редактор встроен поиск. Чтобы найти значение в тексте, выберите Найти в контекстном меню. Откроется поле поиска.

Для замены найденных значений выберите Найти и заменить в меню и кликните по стрелочкам справа от поля Заменить. Одна стрелочка — заменить выделенное значение, две — заменить все.