Функции шаблонов

Для дополнительного форматирования полей, передаваемых из объекта в формируемый документ, используются функции (на английском языке). Синтаксис задания функции в шаблоне: [Function(Поле объекта)]. Для некоторых из них допускаются вложенные условные операторы. Функции начинающиеся с маленькой буквы дают строковый результат также с маленькой буквы.

Функции преобразуют поля в соответствии с языковой настройкой программы. Для получения результата функции независимо от настройки, к её имени добавляется сокращение нужного языка. Синтаксис задания функции, независимой от языковой настройки: [Function_XX(Поле объекта)], где XX — сокращение одного из поддерживаемых языков:

  • RU — русский;
  • EN — английский;
  • BY — белорусский;
  • UA — украинский;
  • KZ — казахский;
  • UZ — узбекский кириллица;
  • UZL — узбекский латиница;
  • DE — немецкий;
  • FR — французский;
  • ES — испанский;
  • ESL — испанский для Латинской Америки;
  • RO — румынский;
  • LT — литовский;
  • PL — польский;
  • CN — китайский.
Строковое представление числа, даты и денежного формата соответствуют национальным особенностям для выбранного языка.
Если Вам необходимо использование другого языка кроме поддерживаемых, обратитесь к нам через обратную связь и, с Вашей помощью, мы добавим его для использования в функциях.

Функции преобразования числа

  • NumW(Поле) / numW(Поле) — строковое представление целого числа;
  • NumW2(Поле) / numW2(Поле) — строковое представление целого числа в женском роде;
  • NumW3(Поле) / numW3(Поле) — строковое представление числа с дробными значениями до десятых и сотых (в зависимости от заданного числа знаков после запятой);
  • Group(Поле) — число с разбивкой на разряды;
  • Money(Поле) — денежный формат с числовыми значениями валюты и разменной монеты;
  • MoneyW(Поле) / moneyW(Поле) — денежный формат со строковым значением валюты и числовым значением разменной монеты;
  • MoneyW2(Поле) / moneyW2(Поле) — денежный формат со строковыми значениями валюты и разменной монеты;
  • currency(Поле) — валюта прописью;
  • coin(Поле) — разменная монета прописью;
  • Fill(Поле,Длина) — дополняет в левой части число до указанной длины нулями.

Функции преобразования даты и времени

  • Date(Дата) — дата в формате «ДД месяца ГГГГ г.»;
  • DateW(Дата) — строковое представление даты в именительном падеже;
  • DateW2(Дата) — строковое представление даты в родительном падеже;
  • Day(Дата) — день даты;
  • Month(Дата) — месяц даты;
  • Year(Дата) — год даты;
  • MonthW(Дата) / monthW(Дата) — месяц даты прописью в именительном падеже;
  • monthW2(Дата) — месяц даты прописью в родительном падеже;
  • TimeW(Время) — время прописью как момент;
  • TimeW2(Время) — время прописью как интервал;
  • Week(Дата,формат) — день недели по формату: short/"ddd" - кратко, full/"dddd" - полно, number - числом.

Функции работы со строками

  • Upper(Поле) — приведение строки к верхнему регистру;
  • Capital(Поле) — приведение первого символа строки к верхнему регистру;
  • Lower(Поле) — приведение строки к нижнему регистру;
  • String(Поле=значению?Вариант1:Вариант2) — если выполняется условие равенства, то подставляется Вариант1, если не выполняется — Вариант2;
  • Split(Поле, разделитель, НомерПодстроки) — разбитие значения поля на подстроки с указанным разделителем и получение подстроки с указанным номером (разделитель указывается в двойных кавычках, например " ").

Примечание для функции String: в качестве вариантов могут использоваться другие поля объекта или строки. В случае, если требуется вывести строку, значение которой используется в качестве имени поля, то её необходимо заключить в кавычки.

Другие функции

  • File(Поле) — изображение, текстовый файл или документ MS Word из поля файла;
  • Image(Поле) — рисунок из ресурсов, совпадающий по имени со значением поля;
  • Image(Поле=значению?рисунок1:рисунок2) — если выполняется условие равенства, то из ресурсов подставляется рисунок1, если не выполняется — рисунок2;
  • 1(Поле), 2(Поле), … — символ под указанным номером (дата в формате ДДММГГГГ);
  • -1(Поле), -2(Поле), … — символ с конца под указанным номером;
  • Barcode(Поле) — графическое изображение штрих-кода EAN-13;
  • Code25(Поле) — графическое изображение штрих-кода Interleaved 2 of 5 (ITF, EN 801);
  • Code128(Поле) / Code128(Поле,Высота) — графическое изображение штрих-кода Code 128 (с возможностью задания высоты в пикселях);
  • QR(Поле) / QR(Поле,Размер) — графическое изображение QR кода заданного размера в пикселях (по умолчанию - 200px);
  • Del(x) / Del(Поле=значению?x) — удаление x символов (для Word/Writer) или x строк (для Excel/Calc). При положительном значении x удаляются символы справа (строки снизу), а при отрицательном – символы слева (строки сверху). Может использоваться условие для поля на соответствие значению.

Функции File() и Del() не работают в дочерних списках форм связи.