Обзор формул

Формула задаёт правило, по которому Sumvest считает значение. Формулы работают в двух местах:

1. Поле «Формула» в таблице: считается для каждой строки отдельно. Например, «Аренда за год» = [Аренда в месяц] * 12. Подробнее в «Формула».
2. Расчёт значения виджета: сводит много строк к одному числу: сумма платежей, средний чек, доходы минус расходы. Обычно его собирают по шагам в конструкторе показателя, а при желании пишут вручную, см. «Формулы в виджетах».

Синтаксис и встроенные функции у них общие. Разница только в том, по каким строкам идёт расчёт.

Как писать

• Поле пишите в квадратных скобках по названию: [Сумма], [Цена покупки]. В формуле виджета добавляйте таблицу: [Расходы.Сумма].
• Функции можно писать по-английски или по-русски, как в Excel: SUM или СУММ, IF или ЕСЛИ. Регистр не важен.
• Аргументы разделяйте запятой или точкой с запятой.
• В редакторе есть панель «Поля и функции»: клик вставляет поле или функцию в формулу. Под полем видно, корректна ли формула.

Что формула умеет

• Брать значения из других полей строки.
• Считать арифметику и сравнения.
• Вызывать встроенные функции: математика, даты, финансы (ROI, CAGR, NPV, IRR, PMT, доходность аренды), агрегаты, межстрочные. Полный список в разделе «Функции».
• Подтягивать значение из другой таблицы по ключу функцией lookup (ВПР). Так, например, берут цену бумаги из «Биржевых цен».
• Возвращать число, текст, да/нет или пустое значение.

Где виден результат

• В колонке таблицы сразу после сохранения поля.
• В виджетах, как значение любого другого поля.
• В окне «Записи» и в выгрузке CSV, уже посчитанным.

Чего формула не умеет

• Обращаться к полям связанной строки через точку. [Объект].Цена не работает. Используйте «Поле из связанной таблицы». См. «Связи в формулах».
• Вызывать свои функции. Только встроенные; неизвестное имя формула не примет.
• Менять данные. Формула только читает и возвращает значение.

Минимальные примеры

[Сумма] * 12

ЕСЛИ([Категория] == "Зарплата"; [Сумма]; 0)

roi([Цена продажи], [Цена покупки])

date_diff([Дата покупки], today(), 'years')

Когда формула, когда виджет

Задача	Решение
Нужна колонка «Аренда за год» в каждой строке.	Поле-формула в таблице.
Нужно одно число: сумма зарплат за месяц.	Виджет KPI: «Сложить» колонку «Сумма» с условием «Категория = Зарплата».
Нужно «доходы минус расходы» из двух таблиц.	Виджет с двумя шагами в конструкторе показателя.
Нужно сравнение с прошлым месяцем.	Виджет KPI или «Сравнение периодов»: изменение считается само.

Правило. Если значение нужно в строке, пишите поле-формулу. Если нужно на дашборде, настройте расчёт значения виджета.

Что дальше

• Синтаксис формул
• Список встроенных функций
• Конструктор показателя в виджете
• Готовые рецепты