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}

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

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


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

Не знайшли відповідь на своє питання?

ПОСТАВТЕ ПИТАННЯ КОМАНДІ ПІДТРИМКИ24
Створювати звернення в техпідтримку можуть тільки користувачі комерційних тарифів. Користувачі безкоштовної версії мають доступ до безлічі навчальних статей та відео, а також записів вебінарів по Бітрікс24. З усіма питаннями по встановленню, впровадженню та доопрацюванню вам допоможуть наші партнери