Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

      • id - наименование ключевого слова

      • default - значение по умолчанию, используемое в случае, если вычисленное значение пустое

      • separator - используется для указания разделителя значений, в случае если ключевое слово отвечает за коллекцию значений

      • pattern - шаблон, для форматирования вычисленного значения, например, если ключевое слово отвечает за дату или число

      • locale - используется для указания языка, на котором отображать локализуемое значение


Из всех указанных атрибутов, обязательным к указанию является лишь атрибут id. Остальные атрибуты являются опциональными. В качестве значения, указываемого для атрибута default можно использовать любой набор блоков. Если в блоке нужно указать несколько атрибутов, они должны быть отделены друг от друга символом | (вертикальная черта). При этом, последовательность, в которой выстраиваются атрибуты, не имеет значения. Предположим, что нужно задать формат наименования для продукта, содержащего его номер. Формат, при этом, будет выглядеть так:

...

В этом примере, было определено что дата будет отображаться в виде четырех цифр года и двух цифр для месяца и дня, отделенные между собой символом . (точка). Итоговый результат может выглядеть, например, так:

Авиабилет

...

1234567890

...

-

...

2018.05.17

Для того, чтобы отобразить локализуемое значение на языке, отличном от языка инсталляции, нужно у элемента указать атрибут locale. Например, для отображения наименования номенклатуры на английском языке нужно использовать следующий формат:

{id=billing_item:nomenclature|locale=en}

При этом, если атрибут locale указать у элемента, значение которого является не локализуемым, то такое значение будет транслитерировано с кириллицы на латиницу.  

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

...