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

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

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

  • RU — русский;
  • UA — украинский;
  • EN — английский.
Строковое представление числа, даты и денежного формата соответствуют национальным особенностям для выбранного языка.

Если Вам необходимо использование другого языка кроме поддерживаемых, обратитесь к нам через обратную связь и, с Вашей помощью, мы добавим его для использования в функциях.

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

  • 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(Поле) — время прописью как интервал.

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

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

Примечание для функции 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 (с возможностью задания высоты в пикселях);
  • Del(x) / Del(Поле=значению?x) — удаление x символов (для Word/Writer) или x строк (для Excel/Calc). При положительном значении x удаляются символы справа (строки снизу), а при отрицательном – символы слева (строки сверху). Может использоваться условие для поля на соответствие значению.