Редактор формул
Редактор формул — это полноэкранный текстовый редактор, который появляется при клике на поле Формула или когда требуется ввести формулу вручную, выбрав пункт Настроить. Редактор формул можно использовать при настройке:
- Разреза
- Меры
- Переменной
- Цвета
- Условия отображения виджета
- Условия отображения меры
- Условия отображения разреза
- Способа ввода данных при запуске скрипта из дашборда
В формулах доступно использование функций ClickHouse. Ознакомьтесь с ними на официальном сайте.
Особенности работы с формулами:
- Если в формуле используется функция
multiIf
, у которой в параметрах указаны колонки из разных таблиц, данные могут отображаться некорректно. Например, когда решено использовать функцию для переключения отображения меры на графике в зависимости от набора условий.
В этом случае рекомендуем вместо функции использовать условие отображения для меры. Для каждой меры задайте отдельное условие отображения в виджете. При таком методе будут получены точные данные без необходимости приводить меры к единому формату, как требует функция. - В формулах недопустимо обрамлять знаком грависа названия таблиц и колонок, так как это может приводить к ошибкам в вычислениях. Вместо грависов необходимо использовать двойные
"
кавычки. Для обрамления строковых значений используются одинарные'
кавычки.
Переменные
Во вкладке Переменные располагаются системные переменные и переменные, созданные в дашборде.
Чтобы найти необходимую переменную, воспользуйтесь поиском.
Чтобы добавить в формулу переменную, кликните по ней.
Если в дашборде не было создано ни одной пользовательской переменной, то эта вкладка не отображается.
Системные переменные
Системные переменные используются для получения текущих значений отдельных системных параметров.
Чтобы получить значение системной переменной, у пользователя должна быть привилегия «Доступы пользователей» с операцией R.
Доступны следующие системные переменные:
- currentEmployeeId
- currentEmployeeEmail
- Login
Переменные currentEmployeeId, currentEmployeeEmail и Login позволяют передавать в скрипт информацию о пользователе при запуске действия из дашборда. Также их можно использовать для фильтрации данных в зависимости от пользователя. Для этого установите фильтр на виджет, используя системную переменную. Каждый пользователь будет видеть только персональные данные.
Переменная currentEmployeeId содержит идентификатор текущего пользователя дашборда. Использование переменной позволяет избежать обращения к таблице «employees» для определения id по логину.
Переменная currentEmployeeEmail содержит email текущего пользователя дашборда.
Переменная Login содержит логин текущего пользователя дашборда.
Если название переменной, созданной пользователем, совпадает с названием системной переменной, значение системной переменной будет заменено на значение созданной. Чтобы вернуть значение системной переменной, переименуйте созданную переменную.
Таблицы и колонки
Во вкладке Таблицы и колонки можно выбрать таблицы, которые были добавлены в пространство.
Чтобы найти нужную таблицу, воспользуйтесь поиском.
Список колонок отображается только после выбора таблицы. Возможен показ сразу нескольких таблиц и их колонок.
Чтобы добавить в формулу колонку, кликните по ней. Чтобы найти нужную колонку, выберите таблицу и введите название колонки в поле поиска.
При написании формулы можно использовать автозаполнение для названий таблиц и колонок из списка справа. Чтобы использовать автозаполнение, начните вводить название колонки или таблицы и нажмите Ctrl+Space. Если возможны несколько вариантов заполнения, они появятся под формулой в виде списка. Если доступно только одно совпадение, оно подставится автоматически.
- Если название таблицы или колонки содержит двойной дефис
--
, то в редакторе формул строка формулы после этих символов будет отображаться как комментарий. - Если в двух и более пространствах есть таблицы с одинаковым названием, то при открытии таблицы в редакторе первого пространства ее показ сохранится и в редакторе других пространств до закрытия браузера.
После того, как формула готова, нажмите Сохранить.
Поиск и замена значений
В редактор встроен поиск. Чтобы найти значение в тексте, выберите Найти в контекстном меню. Откроется поле поиска.
Для замены найденных значений выберите Найти и заменить в меню и кликните по стрелочкам справа от поля Заменить. Одна стрелочка — заменить выделенное значение, две — заменить все.
Цвета
Вкладка Цвета появляется только при настройке цвета элементов в виджете.
Горячие клавиши и сочетания
В редакторе формул можно использовать горячие клавиши и сочетания:
- Ctrl+A — выбрать все
- Ctrl+X — вырезать
- Ctrl+С — копировать
- Ctrl+V — вставить
- Ctrl+Z — отменить ввод
- Ctrl+Shift+Z — вернуть ввод
- Tab — отступ вправо
- Shift+Tab — отступ влево
- Ctrl+Shift+X — верхний регистр
- Ctrl+Shift+Y — нижний регистр
- Ctrl+/ — однострочный комментарий
- Ctrl+Shift+/ — многострочный комментарий
- Ctrl+D — дублировать строки
- Ctrl+Shift+D — удалить строку
- Ctrl+F — найти
- Ctrl+H — найти и заменить
- Ctrl+Shift+F — форматировать
- Ctrl+Space — автозаполнение
- Ctrl+S — сохранить и закрыть
Была ли статья полезна?