Синтаксис

Язык формул предоставляет удобные средства для работы с данными: числами, строками, логикой, полями, функциями и операциями. Он используется для построения выражений, вычислений и условий внутри шаблонов.

Константы

Константы — это фиксированные значения, которые можно использовать напрямую в формулах:

• Целые числа: 10, -5, 0.

• Десятичные числа: 10.1, 3.14, 0.01.

• Строки:

  • Двойные кавычки ("текст") — такая строка интерпретируется как обычный текст.

  • Одинарные кавычки ('текст') — имеют два ключевых применения:

    • Для задания строковых значений: 'Привет'

    • Для привязки к данным из внешних источников, когда идентификатор содержит пробелы, спецсимволы или нестандартный формат: $'Ответственный сотрудник'

    Здесь $'...' используется для корректной ссылки на поле или параметр, имя которого содержит пробел или спецсимволы.

  📌 Важно: оба типа кавычек можно использовать для строк, но для привязки полей допустимы только одинарные кавычки в конструкции с $.

• Логические значения: Истина,Ложь.

• Нет значения: пусто.

Идентификаторы

Идентификаторы используются для обращения к полям и функциям.

• Должны начинаться с буквы или подчёркивания,

• Могут содержать буквы, цифры и подчёркивания.

Например:

• имяПоля

• _вложенноеПоле

• стоимость1

При работе с внешними источниками (например, из Битрикс24), где названия полей могут содержать пробелы, тире и другие нестандартные символы. Нужно обернуть идентификатор в $'...'.

Пример:

• $'Ответственный сотрудник'

• $'сумма-оплаты'

Функции

Функции выполняют определённые операции над переданными аргументами. Они записываются в виде:

функция(аргумент1, аргумент2)

• Имя функции указывается без кавычек.

• Аргументы передаются через запятую в строго определённом порядке.

• Аргументом может быть число, строка, логическое значение, выражение, идентификатор поля, другая функция и т.д.

Примеры:

• если(сумма > 100000, "Да", "Нет")

• длина("Привет")

• макс(товар из список, товар.стоимость)

Функции можно вкладывать друг в друга (вложенные вызовы), например:

• прописн(пстр(текст, 1, 1))

Свойства и вложенные поля

Для доступа к вложенным значениям используется точка (.). Это позволяет обращаться к полям внутри составных полей или элементов списка.

Пример: товар.цена — обращение к полю цена внутри переменной товар.

Математические операторы

+: Сложение.

-: Вычитание.

*: Умножение.

/: Деление.

остаток: Остаток от деления.

^: Возведение в степень.

Операторы сравнения

<: Меньше.

<=: Меньше или равно.

>: Больше.

>=: Больше или равно.

=: Равно.

!=: Не равно.

Логические операторы

и: Логическое И.

или: Логическое ИЛИ.

не: Логическое НЕ.

Операторы для работы со строками

&: Конкатенация (слияние) строк.