Шаблони документів містять параметри, замість яких Бітрікс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}
Створимо документ за шаблоном:
Успіхів у роботі!
