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

В этой статье

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

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

разреза
меры
переменной
цвета
условия отображения виджета
условия отображения меры
условия отображения разреза
способа ввода данных при запуске скрипта из дашборда

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

Важно

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

Если в формуле используется функция multiIf, у которой в параметрах указаны колонки из разных таблиц, данные могут отображаться некорректно. Например, когда решено использовать функцию для переключения отображения меры на графике в зависимости от набора условий.
В этом случае рекомендуем вместо функции использовать условие отображения для меры. Для каждой меры задайте отдельное условие отображения в виджете. При таком методе будут получены точные данные без необходимости приводить меры к единому формату, как требует функция.
В формулах недопустимо обрамлять знаком грависа названия таблиц и колонок, так как это может приводить к ошибкам в вычислениях. Вместо грависов необходимо использовать двойные " кавычки. Для обрамления строковых значений используются одинарные ' кавычки.

Переменные

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

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

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

Важно

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

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

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

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

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

currentEmployeeId
currentEmployeeEmail
Login

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

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

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

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

Важно

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

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

Во вкладке Таблицы и колонки можно выбрать таблицы, которые были добавлены в пространство.

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

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

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

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

Заметка

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

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

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

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

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