Прочитайте готовые ответы
Новые статьи
Поддержка Битрикс24
Регистрация и вход
Тарифы и оплата
Задачи и проекты
Чат и звонки
Группы
Календарь
CRM + Интернет-магазин
Диск
Сайты
База знаний
Интернет-магазин (beta)
Складской учет
Почта
CRM
CoPilot — AI в Битрикс24
Маркетинг
Сквозная аналитика
Центр продаж (beta)
CRM-аналитика (beta)
BI Конструктор
Автоматизация
CRM.Оплата и Доставка
Интеграция 1С и Битрикс24
Компания
Бизнес-процессы
Приложения
Контакт-центр
Моя страница
Телефония
Настройки
Мой тариф
Энтерпрайз
Enterprise HRM
Мобильное приложение
Десктоп-приложение
Общие вопросы
Готовые решения для бизнеса
Битрикс24 в коробке
1С-Битрикс24: Интернет-магазин + CRM
Изменения в статьях (архив)

Поддержка24

Модификаторы в шаблонах документов: меняем формат вывода дат, имен и сумм

Модификатор — это специальный код, который меняет формат поля. Например, значение поля Ф.И.О. по умолчанию выводится в именительном падеже — Сергей Терехов. Чтобы CRM вывела поле в дательном падеже — Сергею Терехову, к символьному коду надо добавить специальный модификатор.

Модификаторы расположены внутри символьного кода после знака тильды (~). В коде {DocumentCreateTime~d.m.Y h:i:s} DocumentCreateTime — это код поля, а d.m.Y h:i:s — модификатор.

Чтобы научиться работать с модификаторами, сначала прочитайте статью про символьные коды, так как без кодов модификаторы не будут работать.
Символьные коды: что это и зачем они нужны

Модификаторы работают только с полями, у которых указан тип.

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

Модификаторы доступны для дат, имён, адресов, денежных сумм и регистра текста. Рассмотрим модификаторы для каждого типа.

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

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

  • d.m.y — 28.08.23
  • d.m.Y — 28.08.2023
  • j, n, Y — 28, 08, 2023
  • j F, Y — 28 Августа, 2023

Модификаторы времени:

  • H:i:s — 10:24:18

Модификаторы даты и времени можно комбинировать:

  • Y-m-d H:i:s — 2023-08-28 10:24:18

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

Возьмем код для поля «Дата создания документа» и преобразуем его в нужный формат. Для этого к коду {DocumentCreateTime} добавим модификатор ~d.m.Y h:i:s. Получим такой код {DocumentCreateTime~d.m.Y h:i:s}.

Модификаторы имени. С помощью модификаторов можно задать падеж, порядок следования фамилии, имени, отчества и обращения. Для изменения порядка следования используйте параметр ~format=.

Список возможных модификаторов:

  • #TITLE# — обращение
  • #NAME# — имя
  • #LAST_NAME# — фамилия
  • #SECOND_NAME# — отчество
  • #NAME_SHORT# — первая буква имени с точкой
  • #LAST_NAME_SHORT# — первая буква фамилии с точкой
  • #SECOND_NAME_SHORT# — первая буква отчества с точкой

Выведем имя в такой последовательности: обращение, имя, фамилия, отчество. Возьмем символьный код, который обозначает полное имя контакта {ContactFormattedName} и добавим к нему модификаторы в том порядке, который описан выше. Код будет иметь такой вид: {ContactFormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#}.

Для изменения падежа используем параметр ~Case=. Склонение по падежам работает только для имён на русском языке, в которых указано отчество.

Модификаторы падежа:

  • -1 — именительный
  • 0 — родительный
  • 1 — дательный
  • 2 — винительный
  • 3 — творительный
  • 4 — предложный

Создадим код для имени в родительном падеже. Возьмем код с модификаторами последовательности, который мы создали раньше, и добавим модификатор родительного падежа {ContactFormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#, Case=0}.

Если надо вывести имя главного бухгалтера или директора компании в родительном падеже, используем {CompanyRequisiteRqDirector~Case=0} для директора, {CompanyRequisiteRqAccountant~Case=0} для бухгалтера.

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

Формат адреса можно изменить, а также добавить разделитель строк. Для изменения формата будем использовать параметр ~Format=, а для разделения строк ~Separator=.

Модификаторы формата и разделителя:

Для параметра Format:

  • 1 — Европа
  • 2 — Великобритания
  • 3 — Северная Америка
  • 4 — Россия (улица > страна)
  • 5 — Россия (страна > улица)

Для параметра Separator:

  • 1 — запятая
  • 2 — без разделителя
  • 3 — перевод строки

Зададим тип адреса — Россия (страна > улица) с переводом строки между частями адреса, к коду поля адрес контакта добавим нужные модификаторы и получим {ContactAddress~Format=5,Separator=3}.

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

Доступные параметры:

  • WZ (With zeros). По умолчанию Битрикс24 показывает незначащие нули для денежных сумм в полях. При значении WZ=N сумма будет без незначащих нулей. Например, 12.00 рублей превратятся в 12 рублей. По умолчанию нули выводятся в полях {TotalRaw} — сумма исходных цен, {TaxesTaxRate} — налоговая ставка, {TotalSum} — общая сумма. В полях, которые находятся в табличной части, например {ProductsProductPriceRawNetto} — Исходная цена без скидки, {ProductsProductPriceRawSum} — Сумма исходной цены без скидки, нули выводятся только при добавлении модификатора WZ=Y.
  • NS (No sign). При значении NS=Y сумма будет без знака валюты, при значении NS=N — со знаком.
  • W (Words). При значении W=Y сумма будет написана прописью.

Выведем сумму сделки прописью и с обозначением валюты, для этого используем код суммы и модификаторы {TotalSum~W=Y,NS=N}.

Модификаторы для телефона. Изменить формат номера телефона можно с помощью модификатора ~format=.

Доступные форматы:

  • E.164 — +7900xxxxxxx
  • International — +7 900 xxx-xx-xx
  • National — 8 (900) xxx-xx-xx

Выведем номер контакта в привычном нам формате +7 и без пробелов, Используем код {ContactPhone~format=E.164}, где {ContactPhone} — это код для поля «Телефон контакта».

Модификаторы регистра текста. С помощью модификатора ~letterCase= можно изменить регистр текста.

Модификатор может принимать следующие значения:

  • upper — ВЕРХНИЙ РЕГИСТР
  • lower — нижний регистр
  • title — Верхний Регистр Для Первой Буквы Каждого Слова

Теперь {DocumentCreateTime~format=d F Y, letterCase=lower} выведет «25 апреля 2022» вместо «25 Апреля 2022».

С помощью модификаторов вы можете изменить исходное значение поля CRM. Используйте модификаторы, чтобы изменить формат даты и времени, изменить падеж в имени, а также сменить формат адреса.

Как с помощью модификаторов вывести значения из множественного поля

В CRM поля могут быть множественными, то есть иметь несколько значений. В стандартные поля «Телефон», «Почта», «Мессенджер» можно добавить несколько телефонных номеров и адресов.

С помощью параметра ~mfirst= можно управлять выводом множественных полей:

  • mfirst=y — выведет только первое значение множественного поля
  • mfirst=n — выведет все значения

Например, у нас есть поле «Телефон», оно множественное, и нам надо вывести все значения из поля. Будем использовать код {ContactPhone~mfirst=n}. По умолчанию значения будут разделены запятой. Модификатор ~mseparator= позволяет выбрать разделитель: запятая (1) или перенос строки (2) — {ContactPhone~mseparator=2}. Чтобы вывести все значения из поля «Телефон» и разделить их переносом строки, используем код {ContactPhone~mfirst=n,mseparator=2}.

Если нужно вывести в документ определенные элементы списка, используем параметр ~index=. Нумерация элементов списка начинается с нуля. Так, товар с индексом 1 — это второй товар в списке. Например, код {ProductsProductName~index=2} выведет третий элемент из списка товаров.

    Коротко

  • Модификатор — это специальный код, который меняет формат поля.
  • Модификаторы расположены внутри символьного кода после знака тильды (~). Например, в коде {DocumentCreateTime~d.m.Y h:i:s} DocumentCreateTime — это код поля, а d.m.Y h:i:s — модификатор.
  • Существуют разные типы модификаторов: времени и даты, адреса, имени, денежных сумм, телефона, регистра текста.
  • С помощью модификаторов можно вывести все значения из множественного поля или одно конкретное, например третье в списке.

Полезные ссылки:

Спасибо, помогло!
Спасибо :)
Не помогло
Очень жаль :(
Помощь интегратора
Это не то, что я ищу
Написано очень сложно и непонятно
Есть устаревшая информация
Слишком коротко, мне не хватает информации
Мне не нравится, как это работает