Оформление
Формат вычисления функций
Функциональное описание
Пользователям приходится часто использовать функции для выполнения вычислений, поэтому важно писать функции правильно и эффективно.
Эта статья знакомит с составом функций FineBI и правильным форматом написания.
функциональный состав
Расчет функции FineBI состоит из четырех элементов:
| элемент | инструкции |
|---|---|
| функция (математика.) | Операции, используемые для преобразования значений или членов в поле |
| поле | Размеры или метрики в таблице пользовательских данных |
| оператор (вычисления) | Укажите знак операции |
| текстовое выражение | Постоянное значение, как написано |
Например, выполните следующий расчет:
IF(сумма контракта>2000, "крупный заказ", "мелкий заказ")
Соответствующие расчеты приведены ниже:
| элемент | инструкции |
|---|---|
| функция (математика.) | ЕСЛИ |
| поле | Сумма контрактаПримечание: Поля должны быть выбраны в левом поле и не могут быть введены вручную. |
| оператор (вычисления) | Дополнительную информацию см. в разделе: Вычислительные операторы и расстановка приоритетов |
| текстовое выражение | Строчный текст: "большой заказ", "малый заказ"Цифровой текст: 2000 |
Примечание: Не все вычисления должны содержать все четыре компонента. Например, расчет может не содержать текстового выражения, как, например, расчет SUM_AGG(Сумма контракта)/SUM_AGG(Количество закупок) , который содержит только функцию SUM_AGG, оператор деления (/) и поля "Сумма контракта" и "Количество закупок".
Дополнительно могут быть включены расчеты:
- Компоненты фильтра связывают параметры компонента для участия в вычислениях - переменные-заполнители, которые можно вставлять в вычисления вместо постоянных значений. Подробности см. в разделе: Динамическое отображение данных о дне/неделе/месяце/годе
Подробнее о том, как использовать каждый компонент в расчете и задавать его формат, читайте в разделе ниже.
вычислительная грамматика
Подробные сведения о синтаксисе общих функций см. в разделе: FAQ по синтаксису общих функций.
просмотреть
| ингредиент | Место использования | словарь | типичный пример |
|---|---|---|---|
| функция (математика.) | Добавляйте новые столбцы, фильтруйте, добавляйте вычисляемые поля | Значение компонента фильтра становится значением параметра, а имя компонента фильтра - именем параметраТо же самое, что и "поле". | IF(Сумма контракта > Числовой компонент выпадающего фильтра, "Крупный заказ", "Мелкий заказ") |
синтаксис функции
В FineBI функции являются основным компонентом вычислений.
1) В вычислениях FineBI функции отображаются синим цветом, и каждая из них имеет определенный синтаксис.
Например, если создать в FineBI приборную панель, добавить вычисляемое поле и в открывшемся редакторе вычислений нажать на иконку "Расположение функции", появится "Список функций". Сразу после "Места выбора полей" при выборе функции из списка функций в крайнем правом разделе появится информация о требуемом синтаксисе (1) и описание (2) функции с одним или несколькими примерами (3), как показано на следующем рисунке:
2) В расчете можно использовать несколько функций. Например:ЕСЛИ(ИСТИНА(прибыль)=1,прибыль,0)
В этом вычислении есть две функции: ЕСЛИ, ЗНАЧЕНИЕ.
Функции включаются в другую функцию (т. е. вложены), как в примере выше. В этом случае функция SIGN для "прибыли" будет вычислена до функции IF, которая находится внутри круглых скобок.
Синтаксис поля
Поля могут быть вставлены в расчет. Синтаксис функции обычно указывает, в какое место вычисления следует вставить поле. Например, SUM_AGG(array).
Например: если вы хотите рассчитать среднюю цену единицы товара по контракту, для расчета будут использоваться поля "Сумма контракта" и "Количество закупок" в источнике данных, введите формулу: SUM_AGG (Сумма контракта)/SUM_AGG (Количество закупок) и нажмите на область выбора полей слева, чтобы выбрать нужное поле, как показано ниже:
Примечание: В расчетах FineBI поля отображаются на светло-голубом фоне.
синтаксис оператора
Чтобы создать вычисление, необходимо знать, какие операторы поддерживает FineBI. Операторы отображаются в расчетах FineBI черным цветом.
Дополнительную информацию см. в разделе: Вычислительные операторы и расстановка приоритетов
Синтаксис текстовых выражений
В этом разделе описывается правильный синтаксис для использования текстовых выражений в вычислениях FineBI.
Текстовые выражения представляют постоянные значения "как есть". При использовании функций иногда необходимо использовать текстовые выражения для представления чисел, строк, дат и так далее. Текстовые выражения отображаются черным и серым цветом в вычислениях FineBI.
Соображения по поводу нелегитимности функций
Дополнительные сведения см. в разделе: Операторы и сообщение о нелегальных ошибках, FAQ по общему синтаксису функций.