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

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

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

Редактор формул можно использовать при настройке:

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

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

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

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

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

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

Вкладки в редакторе формул

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

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

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

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

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

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

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

Переменные

Во вкладке Переменные находятся системные переменные, переменные дашборда и входящие значения. Чтобы развернуть список с переменными, нажмите на иконку стрелки слева от названия категории.

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

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

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

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

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

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

• currentEmployeeId
• currentEmployeeEmail
• Login (скрыта при отображении списка переменных)

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

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

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

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

Разрезы

Во вкладке Разрезы отображаются группы глобальных показателей пространства и разрезы дашборда. На первом месте в списке групп всегда отображается группа глобальных показателей пространства Общее. Чтобы развернуть список разрезов, нажмите на иконку стрелки слева от названия группы.

Чтобы добавить разрез, кликните по его названию. Разрез добавляется в формате link: "Название_группы"."Название_разреза".

Меры

Во вкладке Меры отображаются группы глобальных показателей пространства и меры дашборда. На первом месте в списке групп всегда отображается группа глобальных показателей пространства Общее. Чтобы развернуть список мер, нажмите на иконку стрелки слева от названия группы.

Мера добавляется в формате link: "Название_группы"."Название_меры".

Цвета

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

Дополнительные функции

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

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

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

Горячие клавиши и сочетания

В редакторе формул можно использовать горячие клавиши и сочетания:

• 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 — сохранить и закрыть