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

Атрибуты тега extvar

НаименованиеТип данныхВозможные значенияОписаниеПримечания
nameстроковый
Наименование параметра
widthцелочисленный
Максимальная длина подстроки в символах
splitстроковый
  • bychar
  • byword

Способ разбиения на подстроки:

  • bychar – по символам;
  • byword – по словам.

delimiterстроковый
Строка-разделитель текста на подстрокиВ тексте для клиента используется "##"
quotedстроковый
  • true
  • false
Добавление двойных кавычек до и после текста
formatстроковый
Правило форматирования выходных данныхИспользуются правила форматирования макросов
startxцелочисленный
Начальное значение атрибута posX
startyцелочисленный
Начальное значение атрибута posY
incxцелочисленный
Величина инкрементального изменения атрибута posX
incyцелочисленный
Величина инкрементального изменения атрибута posY

В строке форматирования используется специальный объект token, который содержит три атрибута:

  • data – (строковый) выделенная из текста подстрока;
  • posX – (целочисленный) атрибут, который соответствует выделенной подстроке;
  • posY – (целочисленный) атрибут, который соответствует выделенной подстроке.

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

Пример использования тега extvar
<select query="select rtext from document where documentid = $document.id$">
<extvar name="rtext" width="36" split="byword" format="%(token.posX[02d]),%(token.data[s])" delimiter="##" startx="1" incx="1" />
</select>
  • No labels