Формулы и вычисляемые поля

Вычисляемое поле считается по формуле из других полей датасета: средний чек, маржа, «крупная сделка — да/нет», месяц из даты. В виджетах оно выглядит как обычное поле.

Кто может

Администратор и сотрудники с уровнем «Полные»

Где

Датасет → вкладка «Данные» → «Поле»

Заранее

Есть сохранённый датасет — см. «Создать датасет»

Создать поле

На вкладке «Данные» датасета нажмите «Поле» над таблицей полей. В окне «Новое вычисляемое поле» три части:

Часть	Что в ней
AI — слева или сверху	«Ассистент Антима»: опишите поле словами, и AI составит формулу — см. ниже
Формула — в центре	«Отображаемое имя», «Тип данных», «SQL Формула», проверка и результат на ваших данных, под ними — «Доступные поля». «Системное имя (Алиас)» заполняется само
Подсказки — справа	Вкладки «Функции» и «Шаблоны»: нажмите на элемент, чтобы вставить его в формулу

1. Задайте «Отображаемое имя» — так поле будет называться в виджетах — и «Тип данных».

2. Напишите формулу. Поля пишутся в квадратных скобках: [Сумма] / [Количество]. Поле можно вставить щелчком в «Доступных полях» или перетащить в формулу — над формулой появится «Отпустите для вставки».

3. Нажмите «Проверить» — формула выполнится на пяти строках ваших данных, ниже появится «Результат».

4. Нажмите «Создать поле».

«Проверить» появляется, когда в формуле что-то написано. Сначала сохраните датасет: у несохранённого проверка не сработает. Не пропускайте её: «Создать поле» проверяет только, правильно ли записана формула, а ошибки в самих данных — например, текст там, где нужно число, — видны лишь в «Проверить» и потом в виджете.

Отметка «Есть Агрегация» появляется сама, если в формуле есть подсчёт по многим строкам, — например, SUM([Сумма]) / COUNT([Номер заказа]). Такое поле уже посчитано, повторно суммировать его в виджете не нужно: в колонке «Агрегация» у него стоит «Есть агрегация», и выбрать другую нельзя.

Профиль данных поля

Прежде чем писать формулу, полезно посмотреть, что лежит в поле. Наведите на обычное поле в «Доступных полях» — справа на плашке появится значок графика. Нажмите его — откроется «Профиль данных»:

Что в профиле	Что значит
Всего строк	Сколько строк в датасете
Уникальных	Сколько разных значений в поле
NULL	Доля пустых значений. Больше 10 % — янтарным, больше 50 % — красным
Диапазон	Самое маленькое и самое большое значение
Топ значений	Пять самых частых значений и сколько раз каждое встречается

Профиль есть у сохранённого датасета и считается по базе данных. Для Excel и Google Таблиц цифры в профиле неверны — не опирайтесь на них.

Подсказки редактора

Редактор формулы помогает писать без ошибок:

• Автодополнение. Начните набирать имя поля или функции — появится список. Выберите строку стрелками и Enter или Tab. Если курсор стоит внутри функции, поля подходящего ей типа отмечены зелёной «✓».
• Подсказка функции. Внутри скобок функции под формулой видно, как её записать: имя функции и аргумент, который вы сейчас пишете, — жирным и подчёркнут. Ниже — что делает функция.
• Номера строк появляются, когда в формуле больше двух строк.
• «Обернуть в:». Выделите часть формулы — над ней появится панель: SUM, COUNT, AVG, MIN, MAX, ROUND, ABS, CEIL, FLOOR, CONCAT, UPPER, LOWER, LENGTH, IF, COALESCE, CAST. Нажмите функцию — выделенное окажется внутри неё: ROUND([Сумма]). CAST так не работает — для смены типа возьмите функцию из группы «Типы».
• «Форматировать SQL». Значок появляется справа над формулой, когда она длиннее 30 знаков. Он расставляет строки: WHEN, ELSE, END, AND, OR — каждое с новой строки.

Клавиши

Клавиша	Что делает
(, ', "	Сразу ставит закрывающую пару. Если было выделение, оно окажется внутри
) перед готовой скобкой	Перескакивает через неё, не добавляя лишнюю
Backspace между пустой парой	Удаляет обе скобки или кавычки
Enter	Выбирает строку в списке подсказок. Новую строку не начинает
Shift + Enter	Новая строка в формуле
Tab	Выбирает строку в списке подсказок

Esc закрывает окно поля

Esc закрывает всё окно поля, и несохранённая формула пропадёт. Чтобы убрать список подсказок, щёлкните мышью в формулу.

Цвета в формуле

Что видно	Что значит
Поле на цветном фоне	Антима узнала поле. Цвет — тип поля, как в колонке «Тип» датасета: строка — зелёный, число — синий, дата — янтарный. Все цвета — в статье «Создать датасет»
Индиго-фон у слов CASE, WHEN, AND, IN, NULL и других	Служебные слова формулы
Синий фон у слов field, value, date, x, n	Заготовка из подсказки функции — замените её своим полем или значением
Янтарная рамка у скобки	Пара к скобке, у которой стоит курсор
Красная рамка у скобки	У скобки нет пары
Красное волнистое подчёркивание, красный текст под формулой	Ошибка — что она значит, см. «Ошибки и что делать»

Под формулой

Что видно	Что значит
Красная плашка «✕»	Ошибка: например, не закрыта скобка или кавычка. Кнопка создания превратится в «Исправьте ошибку», рядом — «Исправить через AI»
Янтарная плашка «⚠»	Предупреждение: например, «Неизвестные поля» — Антима не нашла поле с таким именем. Создать поле можно, но проверьте написание
«SQL (резолв)»	Формула так, как её увидит база: отображаемые имена полей заменены системными. Появляется, если в формуле есть поле, у которого отображаемое имя отличается от системного. Менять здесь ничего не нужно
Зелёная таблица «Результат (N строк)»	«Проверить» посчитала формулу — видны первые строки. Пустое значение — NULL. Крестик в углу закрывает таблицу
Красный блок с текстом	«Проверить» не смогла посчитать формулу — в тексте причина
Янтарная «Нет данных для превью»	Формула верна, но в первых строках нет значений

Имя поля из нескольких слов пишите в квадратных скобках: без них редактор посчитает каждое слово отдельным полем и покажет «Неизвестные поля».

Функции и шаблоны

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

Вкладка «Шаблоны» — готовые формулы: конверсия, доли, прирост, день недели, светофор, средний чек и другие. Нажмите шаблон и замените в нём поля на свои.

Все функции с описанием и все шаблоны — в статье «Справочник функций». Там же отмечено, какие функции работают для Excel и Google Таблиц.

Условие «если — то»: CASE

Условие вида «если сумма больше 100 000 — «Крупная», иначе — «Обычная»» собирается без ручной записи — в конструкторе.

1. В окне поля нажмите «CASE» над формулой. Откроется «Визуальный CASE Builder».

2. Выберите «Тип результата»: «Строка» — вернуть текст, «Число» — вернуть число.

3. В строке условия нажмите «Поле» и выберите поле — в списке только видимые поля датасета. Выберите оператор и введите «Значение».

4. После стрелки «→» введите «Результат» — что вернуть, если условие выполнено.

5. Нужно ещё условие — нажмите «+ Условие». Условия проверяются сверху вниз, срабатывает первое подходящее.

6. В поле «ELSE:» — что вернуть во всех остальных случаях. Если оставить пустым, такие строки останутся без значения.

7. Проверьте готовую формулу в «Превью SQL» и нажмите «Вставить CASE» — она встанет в формулу там, где стоял курсор.

Оператор	Что проверяет
=, ≠	Равно или не равно значению
>, <, ≥, ≤	Больше или меньше значения
Содержит	В тексте поля есть значение — например, «Москва» в «г. Москва, ул. Ленина»
Пусто, Не пусто	В поле нет значения или есть. Значение вводить не нужно
В списке	Поле равно одному из значений: перечислите их через запятую, текст — в одинарных кавычках: 'Москва', 'Казань'

Проверьте формулу после вставки

• Значение конструктор всегда берёт в кавычки, даже число. Для чисел кавычки уберите: [Сумма] > 100000.
• Поле вставляется без квадратных скобок. Если в имени поля несколько слов, возьмите его в скобки: [Сумма сделки].
• Не используйте апостроф ' в тексте результата — формула сломается.

Готовая формула из примера:

CASE
  WHEN [Сумма] > 100000 THEN 'Крупная'
  ELSE 'Обычная'
END

Для одного условия то же самое короче записывается функцией IF: IF([Сумма] > 100000, 'Крупная', 'Обычная'). Для нескольких — MULTIIF, см. «Справочник функций».

Помощь AI

В окне поля — «Ассистент Антима»: на широком экране слева, на узком — сверху.

Что умеет	Как
Составить формулу по описанию	Опишите поле своими словами — например, «сумма продаж минус возвраты, если статус заказа — завершён, округлить до 2 знаков» — и нажмите «Создать» или Enter. Shift + Enter — новая строка. Имена полей подсказываются при наборе
Принять задачу голосом	Кнопка микрофона «Продиктовать промпт»: распознанный текст добавится в конец описания. Если браузер не умеет записывать звук, кнопки нет
Повторить прошлую задачу	«История (N)» — последние 20 описаний. Нажмите на описание, чтобы подставить его снова
Исправить ошибку	Под формулой с ошибкой — «Исправить через AI»: AI получит формулу и текст ошибки и предложит исправление

AI заполняет формулу, тип данных и отметку агрегации, а для нового поля — и системное имя. Рядом с «SQL Формула» появляется метка «AI агент редактора формул»: наведите на неё — будет видно «Сгенерировано AI-агентом» и описание, по которому AI составил формулу. Затем Антима выполняет формулу на данных датасета:

• зелёная плашка «Формула проверена на данных датасета» — всё посчиталось, «Результат» появится сразу, без «Проверить»;
• янтарная «Формулу не удалось выполнить — исправьте вручную или уточните описание» — поправьте формулу сами или опишите поле точнее.

Если формула не выполнилась, AI сам исправляет её — ещё до двух раз; рядом с плашкой видно, сколько попыток понадобилось. У датасета, который ещё не сохранён, формула на данных не проверяется.

Кому доступно и сколько стоит

AI в окне формулы доступен администраторам компании. Другой сотрудник увидит «Нет доступа к AI Аналитику» — формулу для него составит администратор, или её можно написать вручную.

Каждая попытка AI оплачивается с баланса компании — см. «Как устроена оплата». Если денег на балансе нет, Антима скажет «Недостаточно средств на балансе компании»; формулы вручную при этом работают как обычно.

Изменить, переименовать, удалить

Кнопки появляются при наведении на строку поля в таблице:

Кнопка	Что делает
Редактировать	Открывает окно «Редактировать поле» — то же окно, что при создании. Системное имя при правке не меняется. Сохранить — «Сохранить изменения». Есть только у вычисляемых полей
Переименовать	Окно «Переименовать поле» — см. ниже. Есть у всех полей
Копировать поле	Копия с именем «… Копия» сразу под полем. Копия обычного поля станет вычисляемым полем
Зависимости	Из каких полей считается поле — «Использует», и какие поля опираются на него — «Используется в». Есть только у вычисляемых
Удалить	Только у вычисляемых: спросит «Удалить поле?» — нажмите «Да, удалить». Обычное поле удалить нельзя — его можно скрыть значком глаза слева

Переименовать поле

1. Наведите на строку поля и нажмите «Переименовать». Откроется «Переименовать поле» — в нём «Текущее имя».

2. Введите «Новое имя».

3. Посмотрите, что изменится. Если на поле ссылаются формулы, окно покажет «Будет обновлено ссылок в N формулах», список этих полей и замену ««старое» → «новое» во всех выражениях». Если нет — «Ни одна формула не ссылается на это поле».

4. Нажмите «Переименовать и обновить (N)» или «Переименовать» — или Enter.

Переименовывайте кнопкой «Переименовать»

Имя можно поправить и прямо в таблице или в окне «Редактировать поле», но тогда формулы, где стоит [Старое имя], не обновятся и перестанут считаться. Перед удалением поля откройте «Зависимости»: формулы, которые на него опираются, тоже сломаются.

Не делайте поля, которые ссылаются друг на друга по кругу: «А» считается из «Б», а «Б» — из «А». Антима такой круг не отмечает, а посчитать его нельзя.

Одна формула для многих полей: «Пакетное»

Когда нужно одно и то же вычисление для нескольких полей — например, перевести в тысячи все суммы, — не делайте поля по одному.

1. Нажмите «Пакетное» над таблицей полей. Откроется «Пакетное создание вычисляемых полей».

2. Слева, в «Доступные поля (N)», отметьте поля — есть «Поиск полей…» и «Выбрать все». В списке только обычные поля, вычисляемых нет.

3. В «Шаблон формулы» напишите формулу, где вместо поля стоит {field}. Возьмите {field} в квадратные скобки: [{field}] / 1000.

4. В «Шаблон названия» задайте, как назвать новые поля: {field} (тыс.) превратит «Выручка» в «Выручка (тыс.)».

5. Выберите «Тип данных результата» — сразу стоит «Дробное число».

6. Проверьте «Превью результата (N)»: название, системное имя и формула каждого нового поля. Видны первые пять, остальные — «Показать все».

7. Нажмите «Создать N полей». Кнопка доступна, когда выбраны поля и в шаблоне формулы есть {field}.

Пакетные поля не проверяются

Антима создаёт поля сразу, без проверки формулы. Если в шаблоне ошибка, все новые поля покраснеют в таблице. Проверьте одно из них: «Редактировать» → «Проверить».

Без квадратных скобок вокруг {field} — например, в шаблоне по умолчанию AVG({field})/2 — формула сломается у полей, в имени которых несколько слов.

Кликабельная ссылка

Поле со ссылкой нужно, чтобы в таблице щелчком открывать карточку клиента, заказ или профиль. Нажмите значок ссылки над таблицей полей — «Создать кликабельную ссылку». В окне «Создание кликабельной ссылки» три шага.

1. Откуда брать ссылку?

Вариант	Когда выбирать
«Поле содержит готовую ссылку»	В поле уже лежит полный адрес, например https://t.me/username. Выберите это поле
«Собрать из домена и ключа»	В поле только окончание адреса — номер заказа или имя пользователя. В «Домен / Хост» введите начало адреса, например t.me/, в «Поле с окончанием (ID)» — поле с окончанием. https:// и / в конце Антима допишет сама

2. Какой длины текст показывать в таблице?

• «Длинная: Показывать саму ссылку (или ID)» — в ячейке будет адрес или номер;
• «Подставить текст из другого поля (например: название)» — в ячейке будет, например, название заказа;
• «Задать короткий текст вручную» — один текст для всех строк, сразу стоит «Открыть ссылку».

3. Название нового поля — например, «Ссылка на профиль».

Нажмите «Создать и сохранить». Появится вычисляемое поле типа «Строка»; в таблице ссылка откроется в новой вкладке браузера.

Поля из нескольких слов

Окно вставляет поля в формулу без квадратных скобок. Если в имени выбранного поля несколько слов, формула не посчитается — откройте поле кнопкой «Редактировать» и возьмите имя в скобки: [Номер заказа].

Готовые формулы ссылок есть и в справочнике — см. «Шаблоны ссылок».

Группа полей

Кнопка «Группа» над таблицей собирает поля в папку, например «Клиенты», — так их проще найти в длинном списке. Подробно — в статье «Создать датасет».