Шаблони документів містять параметри, замість яких Бітрікс24 підставляє реальні дані. Наприклад, {DocumentCreateTime} стане датою створення документа.
Однак ми не можемо керувати зовнішнім виглядом цих даних. Наприклад, деякі документи вимагають конкретний формат дати або суму прописом.
В цьому випадку налаштуйте формат за допомогою спеціальних модифікаторів.
Як це працює?
Модифікатори розташовані всередині параметра шаблону після знака тільди (~). Наприклад {DocumentCreateTime~d.m.Y h:s}.
Модифікатори доступні для дат, імен, адрес та грошових сум.
Дата та час
За замовчуванням, дата має формат країни поточного шаблону. Задамо довільний формат за допомогою модифікаторів.
{DocumentCreateTime~Y-m-d H:i:s}
Можливі формати дат та часу
d.m.y- 28.08.18d.m.Y- 28.08.2018j, n, Y- 10, 3, 2018H:i:s- 10:24:18Y-m-d H:i:s- 2018-08-28 10:24:18F 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}
Множинні поля
В 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}
Успіхів у роботі!