Проверенные сервисы и эксперты с промокодами для наших клиентов
Коротко о нас и нашей команде , а также сертификаты, рейтинги и галерея
Компания
Видео о компании
Другие ресурсы
Свежие материалы и события
Обучающие материалы, обзоры новинок, новости компании в видеоформате
Анонс грядущих и записи прошедших вебинаров и конференций
Экспертные статьи, новости компании, публикации в СМИ
Медиацентр
28 апреля 2025, квест
Зарегистрироваться
14 мая 2025, вебинар
Зарегистрироваться
Контакты
В том числе для связи с разными отделами: СМИ, партнерство, маркетинг
Контакты
Контакты
мессенджеры
Москва. Работаем удаленно по всей России
Соц. сети
Модификаторы в Битрикс24: что это и как использовать
Валентина Шохова
Руководитель контент-отдела
Дата публикации:
Время прочтения:
Автор статьи
04.04.2025
6 минут
Электронный документооборот хорош тем, что позволяет не только сократить расход бумаги, но также и упростить ввод важной информации, обеспечить оперативную передачу в нужные отделы и сократить вероятность ошибок. Система Битрикс24 позволяет в полной мере реализовать все эти преимущества. Встроенные в нее модификаторы упрощают вставку и форматирование повторяющихся и типовых данных, например, имен, фамилий, дат и сумм.
Что такое модификаторы в Битрикс24?
Модификаторы данных Битрикс24 – это специальные коды, которые употребляются вместе с символьными заполнителями и меняют их содержимое. Благодаря этим элементам можно просклонять ФИО клиента, начальника или контрагента, а также вставить дату или денежную сумму в удобном формате внутрь шаблона документов.
Для чего нужны модификаторы в CRM-системе?
Модификаторы шаблонов Битрикс24 позволяют быстро решать такие задачи, как:
•
вставка адреса в общепринятом формате с возможностью выбора разделителя;
•
склонение ФИО во всех косвенных падежах (если имя прописано в карточке клиента с указанием отчества);
•
возможность вставить обращение («г-н», товарищ), а также первую букву имени и отчества с точкой;
•
указание денежных сумм числами и прописью с незначащими нулями и без них;
изменение регистра букв;
изменение регистра букв;
•
выбор формата телефонного номера.
Виды модификаторов в Битрикс24
В Битрикс24 модификаторы шаблонов документов делятся на 3 основных типа:
•
Автоматические. Сразу меняют содержимое совместимых символьных полей.
•
Ручные. Могут принимать разные значения, задаваемые вручную.
•
Интеграционные. Позволяют создавать связи с другими сервисами.
Модификаторы прописываются после знака «тильда» (~) сразу за подходящим символьным кодом Битрикс24 без пробелов. Например, в конструкции {DocumentCreateTime~Y-m-d h:i:s}, DocumentCreateTime – это символьное поле, означающее дату создания документа, а ~Y-m-d h:i:s – это модификатор, который преобразует значение поля к виду: «2025-03-04 21:18:19». В этом случае допускается использование точек, дефисов и двоеточий в качестве разделителей отдельных значений (минут, секунд и т. д.). Некоторые модификаторы могут настраиваться более тонко с помощью параметров, которые прописываются после знака «равно».
Автоматические модификаторы
Они используются для тонкой настройки формата отображения даты, времени, имен и т. д. Для разных групп символьных полей существуют совместимые модификаторы, которые могут использоваться только с определенными кодами. Рассмотрим более подробно категории автоматических модификаторов.
14 мая 2025
Дата и время
Могут использоваться с символьными кодами, содержащими слова date и time. Эти модификаторы состоят из нескольких параметров с такими значениями, как:
•
y – последние две цифры года (25);
•
Y – год полностью (2025);
•
m – месяц от 01 до 12;
•
n – месяц от 1 до 12;
•
F – название месяца в родительном падеже (января, февраля и т. д.);
•
j – номер дня без незначащего нуля (1, 2,… 28/30/31);
•
d – то же самое, но с незначащим нулем (01, 02,... 28/30/31);
•
D – сокращенное название дня недели;
•
H – час в 24-часовой системе;
•
h – то же самое в 12-часовой системе;
•
i – минуты.
Внутри модификаторов допускается вставлять свои строки, например, слово «года» после параметра Y. Их не требуется заключать в кавычки, что является важным преимуществом.
Модификаторы имен и их склонения
Они позволяют вставить обращение, имя, отчество и фамилию в нужном порядке и падеже. Отличие этого модификатора от предыдущего заключается в способе настройки формата. Для этого используется параметр ~format=. После знака равенства можно вставить в любом порядке и сочетании нужные модификаторы ФИО, разделяя их пробелами. Вот, их список (по умолчанию - в именительном падеже):
•
#NAME# и #NAME_SHORT# – полное имя и его первая буква с точкой (А., Б., Вл., Д., Дм. и т. д.) соответственно;
•
#SECOND_NAME# и #SECOND_NAME_SHORT# – это отчество и его первая буква с точкой соотв-но;
•
#LAST_NAME# и #LAST_NAME_SHORT# – фамилия и ее первая буква с точкой (например, Дмитрий П.) соотв-но;
•
#TITLE# – обращение или титул.
Битрикс24 также позволяет склонять ФИО и обращения, что может быть полезно во многих ситуациях. Для этого используется конфигурируемый модификатор Case=, который прописывается через запятую после модификаторов имен. После знака «равно» можно поставить следующие числовые значения:
•
именительный падеж: -1;
•
родительный: 0;
•
дательный: 1;
•
винительный: 2;
•
творительный: 3;
•
предложный: 4.
Пример употребления описанных модификаторов в официальном обращении: {ContactFormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#, Case=1}. Результат применения: «Директору Сидорову Никандру Диомидовичу». Код ContactFormattedName в этом случае означает полное имя контакта (директора, клиента и т. д.).
Ручные модификаторы
К этой группе относится модификатор ~format=, который позволяет получить разный результат в зависимости от того, с каким символьным полем употребляется. В сочетании с кодом {ContactPhone} он позволяет привести вид номера контактного телефона к национальному или международному виду. Примеры доступных форматов (параметр ставится после знака ‘=’):
•
E.164 – +79012345678;
•
National – 8 (901) 234-56-78;
•
International – +7 901 234-56-78.
Если ставить модификатор ~format= после символьных полей, относящихся к почтовым адресам, то можно выбрать один из форматов адресов в зависимости от страны:
•
1 – формат адреса, принятый в Европе (перед индексом указывается код страны заглавными буквами);
•
2 – то же самое, принятое в Великобритании (сначала номер дома, затем – улица, также указывается район, индекс состоит из сочетания букв и цифр);
•
3 – формат адреса в Северной Америке (номер дома, улица, город, код штата, ZIP-код);
•
4 – формат адреса в России в виде «улица, затем страна»;
•
5 – то же самое в виде «страна, затем улица».
Также в этом случае после модификатора ~format= можно использовать модификатор ~separator=, определяющий вид сепаратора (разделителя строк) или его отсутствие. Допустимые значения:
•
запятая – 1;
•
без разделителя – 2;
•
перевод строки (аналогично нажатию на Enter) – 3.
Пример использования модификатора для адреса: {ContactAddress~Format=5,Separator=1}. Результат должен получиться наподобие: 009007, Малокузнецкая область, город Реченск, улица Пограничная, дом 94.
Еще один пример ручного модификатора – это WZ. Он используется с денежными символьными полями и определяет, нужно ли отображать незначащие нули (With Zeros – с нулями). Выбор режима осуществляется с помощью значения N (не показывать) или Y (показывать), которое прописывается через знак ‘=’. Еще два настраиваемых модификатора задают вид денежных сумм:
Еще один пример ручного модификатора – это WZ. Он используется с денежными символьными полями и определяет, нужно ли отображать незначащие нули (With Zeros – с нулями). Выбор режима осуществляется с помощью значения N (не показывать) или Y (показывать), которое прописывается через знак ‘=’. Еще два настраиваемых модификатора задают вид денежных сумм:
•
NS=Y убирает знак валюты после суммы (No sign так и переводится), а NS=N – добавляет;
•
W=Y включает отображение суммы прописью (например, триста тридцать три рубля), модификатор доступен также и для белорусских рублей, казахского тенге и украинской гривны.
Еще один полезный модификатор – ~LetterCase= – позволяет изменить регистр символьных полей, содержащих текст. Для этого доступны следующие значения:
•
upper – БОЛЬШИЕ БУКВЫ;
•
lower – строчные буквы;
•
title – Каждое Слово Начинается С Прописной Буквы.
~LetterCase= отделяется от предшествующих модификаторов запятой и пробелом.
Интеграционные модификаторы
По крайней мере в текущей версии Битрикса в «коробке» и «облаке» не существует модификаторов для связывания символьных полей с другими сервисами. Действующие модификаторы работают в пределах одного шаблона, на основе которого можно создать документ, доступный для прикрепления к сделке и другим сущностям. Более подробно об этом речь пойдет ниже.
Настройка модификаторов в Битрикс24
Можно добавить модификаторы как в имеющийся шаблон, так и в пользовательский. В первом случае надо скачать желаемый файл из раздела «CRM – Сделка – Документ – нужный документ».
Чтобы создать свой шаблон с символьными полями и модификаторами, потребуется:
Чтобы создать свой шаблон с символьными полями и модификаторами, потребуется:
•
Открыть редактор MS Office или Libre Office.
•
Найти и скопировать требуемое символьное поле из соответствующего справочника.
•
Вставить поле в офисный редактор.
•
Добавить информацию, относящуюся к шаблону документа.
•
Перед закрывающей фигурной скобкой набрать знак ‘~’, а затем ввести нужный специальный модификатор. Например, в случае с полем для даты создания документа можно задать порядок следования даты и времени
•
Сохранить документ в формате DOCX.
•
Добавить новый шаблон в Битрикс24. Для этого выбрать карточку сделки и в ней нажать на «Документ – Добавить новый шаблон – Загрузить». Потом перетащить файл в дроп-зону. Выбрать привязку к нужным разделам.
•
Проверить, правильно ли отображается шаблон с модификатором. Для этого закрыть окно сделки, снова открыть и в меню «Документ» выбрать ранее добавленный шаблон. Через несколько секунд в окне появится текст
Если выяснится, что информация отображается с ошибками, то нужно удалить шаблон из списка, исправить ошибочные модификаторы в DOCX-файле и заново загрузить его в Битрикс24.
Подводим итоги
Таким образом, модификаторы в Битрикс24 помогают подстраивать свои и существующие шаблоны документов под потребности бизнеса. А для недопущения ошибок важно знать, с какими символьными полями сочетаются те или иные модификаторы. Кроме того, регистр некоторых параметров напрямую влияет на результат.
Анонсы полезных вебинаров
+1 счастливый SMMщик
Кейсы внедрения из разных ниш
Лайв из жизни компании
Экспертные материалы по CRM
Весёлые и полезные ролики
Нужна бесплатная консультация по материалу статьи?
Чтобы наш разговор был более предметным, напишите чем занимается ваша компания и кратко опишите задачу, которую хотите решить.