В этой статье мы Вам расскажем об обновлениях, которые затронули конструктор документов в Битрикс24. Ранее в статьях про генерацию договоров и создание актов мы рассказывали, как нужно создавать документы на основе шаблонов в Битрикс24.
Конструктор документов Битрикс24 использует в шаблонах параметры, через которые данные передаются из Битрикс24 в готовый документ. Например, вместо {FormattedName} в документ подставится имя.
Раньше эти данные подставлялись как есть, то есть, например, ФИО директора подставлялось в именительном падеже, что было весьма неудобно, каждый раз руками править автоматически созданный договор. Теперь разработчики Битрикс24 внедрили специальные модификаторы, которые могут изменять эти данные.
Рассмотрим, как ими пользоваться. Модификаторы прописываются внутри параметра после знака тильды (~), например {FormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#,Case=0} применит к имени родительный падеж.
Модификаторы можно применять к параметрам, которые содержат даты, имена, адреса и денежные суммы.
Даты
По умолчанию, дата имеет формат страны текущего шаблона. Применим модификатор, чтобы задать свой произвольный формат даты.
{DocumentCreateTime~d.m.Y}. В итоге будет - 06.09.2018
Возможные форматы даты и времени:
- d.m.y - 06.09.18
- d.m.Y - 06.09.2018
- j, n, Y - 10, 3, 2018
- H:i:s - 13:55:10
- Y-m-d H:i:s - 2018-09-06 13:55:10
- F j, Y, G:i -September 06, 2018, 13:55 pm
Про все возможные варианты можно почитать в документации PHP.
Имя
Для имен в первую очередь можно поменять порядок следования элементов, например выстроить в нужном порядке имя, фамилию и отчество. Например, {RequisiteRqDirector~Format=#LAST_NAME# #NAME# #SECOND_NAME#} выведет сначала фамилию, затем имя и отчество.
Параметры имён:
- #TITLE# - обращение
- #NAME# - имя
- #LAST_NAME# - фамилия
- #SECOND_NAME# - отчество
- #NAME_SHORT# - первая буква имени с точкой
- #LAST_NAME_SHORT# - первая буква фамилии с точкой
- #SECOND_NAME_SHORT# - первая буква отчества с точкой
Также можно у имени изменить падеж, например, {RequisiteRqDirector~Case=0} выведет ФИО директора клиента в родительном падеже.
Значения для падежей:
- -1 – именительный
- 0 – родительный
- 1 – дательный
- 2 – винительный
- 3 – творительный
- 4 - предложный
Модификаторы можно задавать через запятую, например, сначала формат вывода имени, затем падеж {~Format=#LAST_NAME# #NAME# #SECOND_NAME#,Case=0}.
Адрес
По умолчанию, в Битрикс24 используется формат адреса страны текущего шаблона. Мы можем изменить тип формата адреса и задать свой разделитель строк. Например, {Address~Format=5,Separator=3}.
Форматы адресов и разделители:
Format:
- 1 – Европа
- 2 – Великобритания
- 3 - Северная Америка
- 4 - Россия (улица -> страна)
- 5 - Россия (страна -> улица)
Separator:
- 1 – запятая
- 2 - без разделителя
- 3 - перевод строки.
Деньги
Наконец-то появилась возможность выводить сумму прописью, также можно теперь показать незначащие нули и валюту.
Доступные параметры:
- WZ (With zeros) - при значении Y сумма будет содержать незначащие нули. Например, 12.00 рублей
- NS (No sign) - при значении Y сумма будет без знака валюты, при значении N - со знаком
- W (Words) - при значении Y, сумма будет написана прописью (Сумма прописью доступна только для рублей, белорусских рублей, гривн и тенге).
Например, выведем сумму прописью: {TotalSum~W=Y} – сто тысяч рублей 00 копеек.
В итоге конструктор документов в Битрикс24 стал ещё более удобным и гибким, тем самым ещё больше упростит жизнь сотрудникам компаний, уменьшим количество действий, которые они совершают вручную.
