Модификаторы переменных Битрикс24 в 2025: инструкция по работе с денежными полями и преобразованию данных

Работа с пользовательскими полями и переменными в Битрикс24 часто требует их преобразования и форматирования. Особенно это актуально при работе с денежными значениями, которые необходимо преобразовать в числовой формат для расчетов и автоматизации бизнес-процессов. В этой статье рассмотрим все доступные модификаторы переменных в Битрикс24 и подробно разберем способы преобразования денежных полей.

Что такое модификаторы переменных в Битрикс24

Модификаторы переменных — это специальные функции, которые позволяют изменять формат и представление данных в полях Битрикс24. Они применяются в бизнес-процессах, шаблонах документов, уведомлениях и других элементах системы для преобразования исходных значений в нужный формат.

Модификаторы записываются после имени переменной через символ вертикальной черты (|) и могут быть объединены в цепочки для последовательного применения нескольких преобразований.

Основные типы модификаторов

• Числовые модификаторы — для работы с числами и денежными значениями
• Текстовые модификаторы — для обработки строк
• Модификаторы дат — для форматирования временных значений
• Логические модификаторы — для условных преобразований

Преобразование денежных полей в число

Одной из наиболее частых задач является преобразование денежных полей в числовой формат. Денежные поля в Битрикс24 хранятся в специальном формате, который включает валюту и форматирование, что может мешать при выполнении математических операций.

Модификатор floatval для денежных полей

Основной способ преобразования денежного поля в число — использование модификатора floatval:

{=Document:UF_CRM_DEAL_AMOUNT|floatval}

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

Практические примеры преобразования

Пример 1: Преобразование суммы сделки для расчетов

{=Document:OPPORTUNITY|floatval}

Пример 2: Расчет комиссии от суммы сделки

{=math({=Document:OPPORTUNITY|floatval} * 0.1)}

Пример 3: Сравнение денежных значений

{=if({=Document:UF_CRM_DEAL_BUDGET|floatval} > 100000, "Крупная сделка", "Обычная сделка")}

Полный список модификаторов переменных

Числовые модификаторы

• floatval — преобразует значение в число с плавающей точкой
• intval — преобразует значение в целое число
• round — округляет число до ближайшего целого
• ceil — округляет число вверх
• floor — округляет число вниз
• abs — возвращает абсолютное значение числа
• number_format — форматирует число с разделителями тысяч

Текстовые модификаторы

• upper — преобразует текст в верхний регистр
• lower — преобразует текст в нижний регистр
• ucfirst — делает первую букву заглавной
• ucwords — делает заглавной первую букву каждого слова
• trim — удаляет пробелы в начале и конце строки
• substr — извлекает подстроку
• strlen — возвращает длину строки
• strip_tags — удаляет HTML-теги
• nl2br — преобразует переносы строк в HTML-теги

Модификаторы дат

• date — форматирует дату в заданном формате
• strtotime — преобразует строку в временную метку
• format_date — форматирует дату по локальным настройкам

Работа с денежными полями в бизнес-процессах

При создании автоматизированных бизнес-процессов часто требуется выполнять расчеты с денежными полями. Рассмотрим наиболее типичные сценарии использования.

Расчет скидки и итоговой суммы

Для расчета скидки в процентах от суммы сделки:

{=math({=Document:OPPORTUNITY|floatval} * {=Document:UF_CRM_DISCOUNT_PERCENT|floatval} / 100)}

Итоговая сумма со скидкой:

{=math({=Document:OPPORTUNITY|floatval} - ({=Document:OPPORTUNITY|floatval} * {=Document:UF_CRM_DISCOUNT_PERCENT|floatval} / 100))}

Установка лимитов и проверка условий

Проверка превышения лимита по сделке:

{=if({=Document:OPPORTUNITY|floatval} > 500000, "Требуется согласование руководства", "Сделка в пределах лимита")}

Категоризация сделок по сумме

Автоматическое присвоение категории сделке на основе суммы:

{=if({=Document:OPPORTUNITY|floatval} < 50000, "Малая", if({=Document:OPPORTUNITY|floatval} < 200000, "Средняя", "Крупная"))}

Сложные преобразования денежных полей

Работа с множественными валютами

При работе с международными сделками может потребоваться преобразование валют. Битрикс24 позволяет получить базовую валюту и курс обмена:

{=Document:OPPORTUNITY|floatval} * {=Document:CURRENCY_RATE|floatval}

Форматирование результатов расчетов

После выполнения математических операций результат можно отформатировать для удобного отображения:

{=math({=Document:OPPORTUNITY|floatval} * 1.2)|round|number_format}

Практические примеры в шаблонах документов

Создание коммерческого предложения

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

Стоимость без НДС:
{=Document:OPPORTUNITY|floatval|number_format} руб.

НДС (20%):
{=math({=Document:OPPORTUNITY|floatval} * 0.2)|round|number_format} руб.

Итого с НДС:
{=math({=Document:OPPORTUNITY|floatval} * 1.2)|round|number_format} руб.

Формирование отчетов

Для создания автоматических отчетов по продажам:

План продаж: {=Document:UF_CRM_PLAN|floatval|number_format} руб.
Факт продаж: {=Document:UF_CRM_FACT|floatval|number_format} руб.
Выполнение плана: {=math(({=Document:UF_CRM_FACT|floatval} / {=Document:UF_CRM_PLAN|floatval}) * 100)|round}%

Отладка и устранение ошибок

Частые ошибки при работе с модификаторами

• Деление на ноль — всегда проверяйте знаменатель перед делением
• Неправильный формат данных — убедитесь, что поле содержит числовые данные
• Пустые значения — используйте проверки на существование значения

Безопасные конструкции

Проверка на пустое значение перед преобразованием:

{=if({=Document:OPPORTUNITY}, {=Document:OPPORTUNITY|floatval}, 0)}

Защита от деления на ноль:

{=if({=Document:UF_CRM_PLAN|floatval} > 0, math({=Document:UF_CRM_FACT|floatval} / {=Document:UF_CRM_PLAN|floatval}), 0)}

Интеграция с внешними системами

При интеграции Битрикс24 с внешними системами модификаторы помогают подготовить данные в нужном формате.

Экспорт данных в 1С

Для корректного экспорта денежных полей в 1С:

{=Document:OPPORTUNITY|floatval|number_format:2:".":",":""}

Передача данных в аналитические системы

Подготовка данных для Google Analytics или Яндекс.Метрики:

{=Document:OPPORTUNITY|floatval|round:2}

Автоматизация с помощью модификаторов

Создание триггеров на основе суммы

Автоматическое назначение ответственного на основе суммы сделки:

{=if({=Document:OPPORTUNITY|floatval} > 1000000, "Директор по продажам", "Менеджер")}

Настройка уведомлений

Отправка уведомлений при превышении определенных сумм:

Сделка на сумму {=Document:OPPORTUNITY|floatval|number_format} руб. {=if({=Document:OPPORTUNITY|floatval} > 500000, "требует особого внимания", "в пределах нормы")}

Оптимизация производительности

Кэширование результатов

Для сложных вычислений рекомендуется сохранять результаты в отдельные поля:

• Используйте бизнес-процессы для предварительных расчетов
• Сохраняйте результаты в пользовательские поля
• Избегайте сложных вычислений в шаблонах документов

Минимизация обращений к базе данных

Группируйте связанные операции и используйте промежуточные переменные для сложных вычислений.

Расширенные возможности

Создание пользовательских модификаторов

Для специфических задач можно создавать собственные модификаторы через разработку модулей или использование REST API.

Использование в REST API

Модификаторы также работают при получении данных через REST API, что позволяет получать уже обработанные значения.

Заключение

Модификаторы переменных в Битрикс24 — это мощный инструмент для преобразования и форматирования данных. Особенно важно правильно работать с денежными полями, используя модификатор floatval для преобразования их в числовой формат. Это открывает широкие возможности для автоматизации бизнес-процессов, создания отчетов и интеграции с внешними системами.

Правильное использование модификаторов позволяет создавать гибкие и эффективные решения для управления данными в CRM-системе. При работе с денежными полями всегда помните о необходимости проверки на пустые значения и корректность данных.

Наша команда предоставляет полный спектр услуг по настройке и внедрению Битрикс24, включая создание сложных бизнес-процессов с использованием модификаторов переменных, настройку автоматизации работы с денежными полями и интеграцию с внешними системами. Мы поможем оптимизировать ваши бизнес-процессы и максимально эффективно использовать возможности платформы Битрикс24.