Шаблоны документов в Битрикс24: работа с модификаторами

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

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

На портале представлено большое количество инструментов для работы с документами, позволяющих автоматизировать операции с ними, используя роботов, Битрикс24 КЭДО и «Госключ», автозаполнение реквизитов по ИНН из базы ФНС России, другие опции и шаблоны.

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

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

Как пользоваться

Время и дата

Штатно дата представлена в формате страны текущего шаблона. Чтобы уточнить, какая страна выставлена в шаблоне, необходимо зайти в его настройки и посмотреть. От выставленной страны зависит не только формат даты, — для России это ДД.ММ.ГГГГ, а например, для USA ММ.ДД.ГГГГ, — но и имени. Адреса тоже отличаются, если в России адрес, как правило, начинается с Россия, Московская область, такой-то район, город, улица, дом, квартира, получатель, то в Англии или США все наоборот: получатель, квартира, улица, город / штат и так далее, по нарастающей.

Некоторые варианты:

  • d.m.y — 06.07.24;
  • d.m.Y — 06.07.2024;
  • j, n, Y — 10, 7, 2024;
  • H:i:s - 13:55:10;
  • Y-m-d H:i:s — 2018-09-06 13:55:10.

Про другие варианты можно узнать в документации PHP.

Имена

Для имен можно изменять падежи и последовательность элементов, чтобы указать в требуемом порядке имя, фамилию и отчество. Например, {RequisiteRqDirector~Format=#LAST_NAME# #NAME# #SECOND_NAME#} приведет к результату, в котором сначала будет идти фамилия, а затем имя и отчество.

Значения:

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

При необходимости в документе можно изменить падеж: {RequisiteRqDirector~Case=-1} выведет ФИО в именительном падеже, 0 в родительном, 1 в дательном, 2 в винительном, 4 в предложном, а 3 — в творительном.

Задавать значения можно через запятую: сначала формат вывода имени, а после падеж {~Format=#LAST_NAME# #NAME# #SECOND_NAME#,Case=4}.

Адреса

Штатно в шаблонах установлен формат адреса указанной в нем страны. При этом есть возможность изменить тип адреса и разделителя строк. Например, {Address~Format=4,Separator=1}.

Значения Format:

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

Значения Separator:

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

Таким образом можно быстро менять формат адреса, даже внутри России, задавая Format 4 или 5 и нужный разделитель.

Суммы

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

К примеру, может потребоваться указать сумму прописью — это можно сделать с помощью модификатора, но не для любых валют: поддерживаются российские и белорусские рубли, гривны и тенге. Есть возможность управлять показом незначащих нулей — нулей, которые не влияют на сумму: 23.00 рубля или 23 рубля.

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

Существующие параметры:

  • WZ (With zeros) — при условии Y поля будут содержать незначащие нули, например, 23.00 рубля;
  • NS (No sign) — при условии Y значение в поле будет выводиться без знака валюты, а при условии N со знаком;
  • W (Words) — при условии Y, сумма выводится прописью.

Сделаем сумму прописью: {TotalSum~W=Y} – сто тысяч рублей 00 копеек.

Телефоны

В зависимости от ситуации, содержащиеся в документах номера телефонов можно приводить в соответствие с нужным форматом, для этого используется модификатор ~format=.

Чтобы вывести в стандартном для России формате номер, начинающийся с +7 и не содержащий пробелы, используется модификатор E.164. Дополнительно есть еще 2 модификатора:

  • International — номера формата +7 800 ХХХ-ХХ-ХХ;
  • National — номера формата 8 (800) ХХХ-ХХ-ХХ.

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

Регистр

Изменить регистр для вносимых в поле данных поможет модификатор ~letterCase=. Это простой модификатор, позволяющий установить 3 значения:

  • title — Первая Буква Каждого Слова Будет Заглавной;
  • upper — ВСЕ ЗАГЛАВНЫМИ БУКВАМИ;
  • lower — все строчными буквами.

{DocumentCreateTime~format=d F Y, letterCase=lower} выведет «17 мая 2024» вместо «17 Мая 2024».

Что еще можно сделать

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

Для управления несколькими значениями, можно использовать модификатор ~mfirst=:

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

Штатно выводимые элементы разделяются запятой, это можно изменить, воспользовавшись модификатором ~mseparator=:

  • 1 — запятая;
  • 2 — перенос строки.

Также можно выводить выбранные значения — поможет ~index=. При этом важно помнить, что счет начинается с нуля, а не с единицы. Чтобы вывести 4 элемент, нужно указать в модификаторе параметр 5 (~index=5).

Краткие итоги

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

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


У вас остались какие-то вопросы?

Задайте их в форме ниже и мы обязательно с вами свяжемся!

Другие материалы по теме:

  • 12.01.2025

    Как поставить статус отпуска в Битрикс24

    Узнайте, какие штатные инструменты Битрикс24 позволяют управлять отпусками и контролировать отсутств...

    Подробнее
  • 06.01.2025

    Отдел контроля качества (ОКК) в продажах: экспертное мнение от Integrator.Digital

    Какие проблемы решает отдел контроля качества (ОКК) в продажах и нужен ли он небольшим компа...

    Подробнее
  • 17.11.2022

    Складской учет: Как навести порядок в продажах / часть 2

    В прошлой публикации мы начали разбирать возможности ведения складского учета, представленные в Битр...

    Подробнее
Оперативно и совершенно бесплатно ответим на Ваши вопросы!

Нажимая кнопку "Заказать", я даю свое согласие на обработку моих персональных данных, в соответствии с Федеральным законом от 27.07.2006 года №152-Ф3 "О персональных данных", на условиях и для целей, определенных в Согласии на обработку персональных данных.