top_ua
Вхід

Підтримка24

Модифікатори в шаблонах документів

Рейтинг:

Шаблони документів містять параметри, замість яких Бітрікс24 підставляє реальні дані. Наприклад, {DocumentCreateTime} стане датою створення документа.

Однак ми не можемо керувати зовнішнім виглядом цих даних. Наприклад, деякі документи вимагають конкретний формат дати або суму прописом.

В цьому випадку налаштуйте формат за допомогою спеціальних модифікаторів.

Як це працює?

Модифікатори розташовані всередині параметра шаблону після знака тільди (~). Наприклад {DocumentCreateTime~d.m.Y h:s}.

Як працювати з параметрами та редагувати шаблони документів читайте в статті Шаблони документів

Модифікатори доступні для дат, імен, адрес та грошових сум.

Дата та час

За замовчуванням, дата має формат країни поточного шаблону. Задамо довільний формат за допомогою модифікаторів.

{DocumentCreateTime~Y-m-d H:i:s}


Можливі формати дат та часу

  • 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
  • F j, Y, G:i - August 28, 2018, 10:24 am

Про всі доступні формати дат та часу можна почитати в документації.

Створимо документ за шаблоном:

Ім'я

Для імен ми перш за все можемо задати формат - порядок слідування прізвища, імені та інших елементів.

Наприклад, {FormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#} виведе звернення, а потім прізвище, ім'я та по батькові.

Для контакту в угоді можна використовувати параметр {ContactFormattedName}, а для імені відповідального - {AssignedFormattedName}



Параметри імен

  • #TITLE# - звернення;
  • #NAME# - ім'я;
  • #LAST_NAME# - прізвище;
  • #SECOND_NAME# - по батькові;
  • #NAME_SHORT# - перша буква імені з крапкою;
  • #LAST_NAME_SHORT# - перша буква прізвища з крапкою;
  • #SECOND_NAME_SHORT# - перша буква по батькові з крапкою.

Також ми можемо змінити відмінок імені. Наприклад, {FormattedName~Case=0} виведе ім'я в родовому відмінку.

Можливість налаштування відмінків працює тільки для імен на російській мові із вказаним полем По батькові.


Значення для відмінків

  • -1 - називний;
  • 0 - родовий;
  • 1 - давальний;
  • 2 - знахіднийй;
  • 3 - орудний;
  • 4 - місцевий.

Для прикладу, задамо формат повного імені контакту в родовому відмінку.

{FormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#,Case=0}

Створимо документ за шаблоном:

Ще один частий приклад - вивести в угоді ім'я бухгалтера або директора компанії в родовому відмінку. В цьому випадку для директора використовуйте:

{CompanyRequisiteRqDirector~Case=0}

А для бухгалтера:

{CompanyRequisiteRqAccountant~Case=0}

Адреса

За замовчуванням, Бітрікс24 використовує формат адреси країни поточного шаблону.

Ми можемо змінити тип формату дати та роздільник рядків. Задамо тип адреси Північної Америки з переведенням рядка між частинами адреси.

{Address~Format=3,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,NS=N}

Створимо документ за шаблоном:

Телефон

Змінити формат номера телефону можна за допомогою модифікатора format. Наприклад

{ClientPhone~format=E.164}

Доступні формати:

  • E.164 - +380960840804
  • International - +380 96 084-08-04
  • National - 0 96 0840804

Вибір товару, податку чи контакту із списку

Деякі дані передаються в документи у вигляді списку - наприклад, товари, податки або контакти угоди.

Як вивести в шаблоні такий список читайте в статті Шаблони документів.

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

{ProductsProductName}

Використовуйте модифікатор index, щоб отримати будь-який інший елемент. Наприклад, цей код виведе третій елемент зі списку товарів.

{ProductsProductName~index=2}
Нумерація елементів списку починається з нуля. Наприклад, товар з індексом 1 - це другий товар.

Множинні поля

В CRM поля можуть бути множинними - тобто мати кілька значень. Наприклад, стандартні поля Телефон, Пошта, Месенджер або будь-яке призначене для користувача поле з властивістю Множинне.

Шаблони документів не підтримують множинні поля з типом Файл і Прив'язка до елементів CRM.

За допомогою модифікатора mfirst ви можете керувати виведенням множинних полів:

  • mfirst=y - виводити тільки перше значення
  • mfirst=n - виводити всі значення

Наприклад:

{TestField~mfirst=n}

За замовчуванням, значення будуть розділені комою. Модифікатор mseparator дозволяє вибрати роздільник - кома (1) або перенесення рядка (2):

{TestField~mseparator=2}

Перерахування всіх товарів, податків або контактів зі списку

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

{ProductsProductName~all=y}

Цей модифікатор аналогічно працює і з будь-яким іншим списком - наприклад, списком податків або контактів в угоді.

Замість коми можна використовувати перенесення рядка - для цього додайте модифікатор mseparator=2:

{ProductsProductName~mseparator=2,all=y}

Розглянемо приклад - у нас є угода, в якій бере участь 10 контактів. У кожного контакту є 10 номерів в полі Телефон.

Ми хочемо вивести номера кожного з контактів з нового рядка - для цього потрібен наступний код:

{ContactsContactPhone~mseparator=2,all=y,mfirst=n}

Успіхів у роботі!

Дякую, допомогло! Дякуємо :) Не допомогло Дуже шкода :(
Дізнайтесь, чому:
Це не те, що я шукаю
Дуже складно і незрозуміло