Редактор формул
8 800 555-89-02
Войти
Документация
CTRL+K
Standalone2410
SaaS

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

В этой статье
  • Редактор формул
  • Переменные
  • Системные переменные
  • Таблицы и колонки
  • Поиск и замена значений
  • Цвета
  • Горячие клавиши и сочетания

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

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

Поле формулы

В формулах доступно использование функций 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 — сохранить и закрыть

Была ли статья полезна?

Да
Нет
Предыдущая
Способы ввода
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102024. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.