Модификаторы Битрикс24 в документах: инструкция по настройке форматирования данных

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

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

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

Базовый синтаксис:

{=Document:FIELD_NAME|modifier}

Модификаторы работают с различными типами данных:

• Даты и время
• Числовые значения
• Текстовые поля
• Адреса
• Суммы

Модификаторы для форматирования дат

Форматирование дат — одна из самых востребованных функций модификаторов в Битрикс24. Система поддерживает множество вариантов отображения даты и времени.

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

DATE_FORMAT — базовый модификатор для форматирования даты:

• {=Document:DATE_CREATE|date_format:'d.m.Y'} — 15.03.2024
• {=Document:DATE_CREATE|date_format:'d F Y'} — 15 марта 2024
• {=Document:DATE_CREATE|date_format:'j F Y г.'} — 15 марта 2024 г.

Популярные форматы дат:

• d.m.Y — 15.03.2024
• d/m/Y — 15/03/2024
• Y-m-d — 2024-03-15
• d F Y — 15 марта 2024
• j F Y г. — 15 марта 2024 г.

Специальные модификаторы времени

Для работы с текущей датой и временем используется переменная DOCUMENT_CREATE_TIME:

• {=Document:DOCUMENT_CREATE_TIME|date_format:'d.m.Y H:i'} — 15.03.2024 14:30
• {=Document:DOCUMENT_CREATE_TIME|date_format:'d F Y, H:i'} — 15 марта 2024, 14:30

Модификаторы для работы с числами и суммами

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

Сумма прописью

Модификатор SPELLING преобразует числовое значение в текстовый формат:

• {=Document:OPPORTUNITY|spelling} — пятьсот тысяч рублей
• {=Document:OPPORTUNITY|spelling:'RUB'} — пятьсот тысяч рублей 00 копеек
• {=Document:OPPORTUNITY|spelling:'USD'} — пятьсот тысяч долларов США

Поддерживаемые валюты:

• RUB — российские рубли
• USD — доллары США
• EUR — евро
• UAH — украинские гривны

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

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

• {=Document:OPPORTUNITY|number_format:'0':' ':','} — 500 000,00
• {=Document:OPPORTUNITY|number_format:'2':' ':','} — 500 000,00

Модификаторы для адресов

Битрикс24 включает специальные модификаторы для форматирования адресной информации.

Форматирование адреса

Модификатор ADDRESS_FORMAT позволяет настроить отображение адреса:

• {=Contact:ADDRESS|address_format} — полный адрес
• {=Contact:ADDRESS|address_format:'short'} — краткий адрес
• {=Contact:ADDRESS|address_format:'city_street'} — город и улица

Компоненты адреса:

• Страна
• Регион
• Город
• Улица
• Дом
• Почтовый индекс

Модификаторы для текстовых полей

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

Изменение регистра

• {=Contact:NAME|upper} — ВЕРХНИЙ РЕГИСТР
• {=Contact:NAME|lower} — нижний регистр
• {=Contact:NAME|capitalize} — Первая Буква Заглавная

Обработка текста

• {=Contact:COMMENTS|truncate:100} — обрезка до 100 символов
• {=Contact:COMMENTS|strip_tags} — удаление HTML-тегов
• {=Contact:COMMENTS|nl2br} — замена переносов строк на <br>

Комбинирование модификаторов

Модификаторы можно комбинировать для достижения нужного результата. Они применяются последовательно слева направо.

Примеры комбинирования:

• {=Contact:NAME|upper|truncate:20} — сначала верхний регистр, затем обрезка
• {=Document:OPPORTUNITY|number_format:'2':' ':','|spelling:'RUB'} — форматирование числа и преобразование в текст

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

Договор с форматированием даты

Пример оформления шапки договора:

Договор № {=Document:ID}
от {=Document:DATE_CREATE|date_format:'d F Y г.'}
Сумма договора: {=Document:OPPORTUNITY|number_format:'2':' ':','} руб.
({=Document:OPPORTUNITY|spelling:'RUB'})

Счет с адресом

Пример оформления счета:

Плательщик: {=Contact:NAME|upper}
Адрес: {=Contact:ADDRESS|address_format}
Сумма к оплате: {=Document:OPPORTUNITY|number_format:'2':' ':','} руб.
Выставлен: {=Document:DOCUMENT_CREATE_TIME|date_format:'d.m.Y в H:i'}

Расширенные возможности генератора документов

Генератор документов Битрикс24 поддерживает условные конструкции и циклы, которые можно комбинировать с модификаторами.

Условные конструкции

{if Document:OPPORTUNITY}
Сумма: {=Document:OPPORTUNITY|number_format:'2':' ':','} руб.
{else}
Сумма не указана
{/if}

Работа с коллекциями

{foreach Document:PRODUCT_ROWS as PRODUCT}
{=PRODUCT:NAME} - {=PRODUCT:PRICE|number_format:'2':' ':','} руб.
{/foreach}

Пользовательские модификаторы

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

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

Для создания пользовательского модификатора необходимо:

1. Определить логику обработки данных
2. Зарегистрировать модификатор в системе
3. Указать параметры и описание

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

При работе с модификаторами важно правильно тестировать их работу.

Часто встречающиеся ошибки

• Неправильный синтаксис модификатора
• Несоответствие типа данных
• Отсутствие значения в поле
• Некорректные параметры модификатора

Способы отладки

• Проверка значений переменных
• Пошаговое тестирование модификаторов
• Использование режима предварительного просмотра

Лучшие практики использования модификаторов

Для эффективного использования модификаторов в Битрикс24 рекомендуется следовать определенным принципам:

Стандартизация форматов

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

Документирование

• Ведите документацию используемых модификаторов
• Указывайте назначение каждого модификатора
• Сохраняйте примеры использования

Интеграция с другими функциями Битрикс24

Модификаторы эффективно работают совместно с другими возможностями платформы:

Автоматизация и роботы

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

Отчетность

• Применение модификаторов в отчетах
• Форматирование данных для экспорта
• Создание аналитических документов

Заключение

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

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