Модификаторы Битрикс24
В этой статье мы про обновления для конструктора документов в Битрикс24.
Шаблоны документов содержат параметры, вместо которых Битрикс24 подставит реальные данные. Например, {DocumentCreateTime} станет датой создания документа, а вместо {FormattedName} – подставится имя.
Раньше эти данные формировались в неизменном виде, как есть. Например, фамилия, имя и отчество руководителя раньше подставлялось в именительном падеже.
В итоге сотруднику приходилось вручную исправлять документ.
Для удобства пользователей разработчики внедрили модификатора документов Битрикс24, которые позволяют менять данные.
Какой принцип работы модификаторов шаблонов Битрикс24?
Модификаторы “зашиты” в параметрах шаблона после знака тильды (~). Например, {DocumentCreateTime~d.m.Y h:s}.
Модификаторы Битрикс24 доступны для даты, имени, адреса и денежной суммы.
Дата и время
Дата имеет формат страны текущего шаблона. Можно задать свой формат с помощью модификаторов для даты: {DocumentCreateTime~Y-m-d H:i:s}. Таким образом, получается 17.08.2019.
Возможные форматы даты и времени:
d.m.y – 28.08.18
d.m.Y – 28.08.2018
j, n, Y – 10, 3, 2018
H:i:s – 10:24:18
Y-m-d H:i:s – 2018-08-28 10:24:18
j F, Y – 28 Августа, 2018
Имя
Для имён мы прежде всего можем задать формат – порядок следования фамилии, имени, отчества.
К примеру, {FormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#} выведет обращение, а затем фамилию, имя и отчество.
Для контакта в сделке можно использовать параметр {ContactFormattedName}, а для имени ответственного – {AssignedFormattedName}
Параметры имен:
#TITLE# – обращение;
#NAME# – имя;
#LAST_NAME# – фамилия;
#SECOND_NAME# – отчество;
#NAME_SHORT# – первая буква имени с точкой;
#LAST_NAME_SHORT# – первая буква фамилии с точкой;
#SECOND_NAME_SHORT# – первая буква отчества с точкой.
Также можно у имени изменить падеж, например, {RequisiteRqDirector~Case=0} выведет фамилию, имя и отчество директора клиента в родительном падеже.
Значения для падежей в модификаторах шаблонов в Битрикс24:
1 – именительный;
0 – родительный;
1 – дательный;
2 – винительный;
3 – творительный;
4 – предложный.
Адрес
По умолчанию, Битрикс24 использует формат адреса страны текущего шаблона. Мы можем видоизменить отображение с помощью модификатора Битрикс24 {Address~Format=3,Separator=3}
Часть модификатора Format отвечает за тип формата:
1 – Европа;
2 – Великобритания;
3 – Северная Америка;
4 – Россия (улица -> страна);
5 – Россия (страна -> улица).
Часть Separator отвечает за разделитель строк:
1 – запятая;
2 – без разделителя;
3 – перевод строки.
Получается следующим образом:
Деньги
С помощью специального модификатора документов в Битрикс24 можно отображать сумму прописью.
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 сумма будет написана прописью.
Вот так получается создать документ по шаблону:
Телефон
Изменить формат номера телефона можно с помощью модификатора Битрикс24 format. Например: {ClientPhone~format=E.164}
Доступные форматы:
E.164 – +79062191234
International – +7 906 219-12-34
National – 8 (906) 219-12-34
Таким образом, Битрикс24 постоянно совершенствуется, и его разработчики внедряют новые инструменты для оптимизации работы в CRM.
Благодаря модификаторам шаблонов Битрикс24 стал удобным и гибким. Инструмент значительно упрощает выполнение задач пользователями и сокращает количество рутинных действий.
(1 оценок, среднее: 5,00 из 5)
Загрузка...
