15.2.11.6 Правила записи значений в элементы шаблона бланка |
|
Перед записью значения в элемент шаблона бланка необходимо данный элемент сделать именованной областью (см. раздел 15.2.13). Иначе значение в элементе бланка будет интерпретироваться как простой текст. Исключение - Произвольное текстовое значение (см. описание ниже). Исключение - элементы шаблонов строк внутри основной именованной области «ЗаполнениеСоставаКарты» и служебные поля шаблонов строк (см. раздел 15.2.11.2.3). |
В зависимости от типа значения используются следующие правила записи значений в элементы бланка:
· Произвольное текстовое значение. Текст передается как есть. Текст не может начинаться с символов %, #, ? , $, &, *, @, ^, ! , ~ (если символ необходим в начале текста, то его необходимо удвоить). Текст передается как есть, но может быть обработан в зависимости от описания использования.
· Основной источник данных - текст должен начинаться со знака «%». Далее вводится номер или имя/псевдоним поля основного источника данных (см. раздел 15.2.6.4.2). Вместо текста будет возвращено значение поля текущей записи основного источника данных. Нумерация полей источника данных начинается с нуля.
· Дополнительный источник данных - текст должен начинаться со знака «#». Далее вводится номер или имя/псевдоним поля дополнительного источника данных (см. раздел 15.2.6.4.2). Вместо значения параметра будет возвращено значение поля текущей записи дополнительного источника данных. На момент обращения дополнительный источник данных должен существовать и быть открытым. Нумерация полей источника данных начинается с нуля.
· Именованный объект - текст должен начинаться со знака «?». Далее вводится имя именованного объекта (см. раздел 15.2.6.4). Далее через точку можно указать номер поля или имя/псевдоним поля которые необходимо вернуть. В квадратных скобках можно указать номер записи которую необходимо вернуть. Если именованный объект возвращает массив данных, то в квадратных скобках указываются координаты массива. В обычных скобках можно указать параметры, которые следует передать этому именованному объекту.
· Служебное слово - текст должен начинаться со знака «$». Далее вводится служебное слово. Возможные служебные слова описаны (см. раздел 15.2.11.4).
· Агрегирующая функция - текст должен начинаться со знака «*». Далее вводится имя агрегирующей функции, которую необходимо вызвать (см. раздел 15.2.11.5).
· Признак - любой текст может содержать признаки. Признаки записываются в начале текста в фигурных скобках «{ }». Если признаков несколько, то они перечисляются через запятую. Если необходимо использовать фигурную скобку в тексте, то ее необходимо удвоить. Возможно указание следующих признаков в тексте:
· «-» - перенос строки не будет выполняться.
· «+» - если шаблон строки при формировании занимает несколько строк (в результате переноса в ячейках без признака «+»), то значения ячеек этого шаблона с признаком «+» будет записано в каждую строку (например, можно пронумеровать строки переноса).
· «~» - если необходимо исключить влияние значения ячейки на определение является ли вся строка пустой или нет. Т.е. если в ячейке с данным признаком будет значение, а остальные ячейки строки будут пустыми, либо все ячейки будут содержать данных признак, то вся строка будет считаться пустой.
· *ИмяСчетчика - если значение, сформированное в данной строке необходимо сохранить в счетчике с именем «ИмяСчетчика». Данное значение можно использовать для работы агрегирующих функций (см. раздел 15.2.11.5).
|
Допускается использовать вложенные параметры (параметры содержащие значение из параметров), но не более 20 раз. |
См. также: