Присваивание значения элементу дерева выходного сообщения#

Описание#

Для присваивания значения элементу дерева выходного сообщения используется знак присваивания «=», который разделяет назначение (слева) и источник (справа) присваивания значения. Назначением присваивания является элемент дерева выходного сообщения.

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

Начинается перечисление с зарезервированных слов:

1. IN, In, in — для адресации элемента из входящего сообщения;

2. OUT, Out, out — для адресации элемента из выходящего сообщения.

Или

1. INPUT, Input, input — для адресации элемента из входящего сообщения;

2. OUTPUT, Output, output — для адресации элемента из выходящего сообщения.

При использовании INPUT и OUTPUT после (возможно, после индекса) обязательно должен быть указан тип узла.

Типы узлов:

1. headers — заголовки сообщения

2. key — ключ сообщения Kafka

3. body — тело сообщения

4. sourceTopic — topic источника

5. targetTopic — topic назначения

6. branch — имя ветки для маршрутизации

Пример правила трансформации с указанием типа узла:

Пример правил трансформации с заполнением атрибутов CloudEvents (применимо только к компоненту EVPC):

OUTPUT.attributes.subject = INPUT.attributes.subject
OUTPUT.attributes.datacontenttype = "application/xml"

В правой части знака присваивания («=») допускается использование:

• адреса элемента входящего сообщения;

• адреса элемента исходящего сообщения;

• констант;

• переменной;

• переменной окружения;

• вызова функции;

• логических операций.

Для формата XML в адресе элемента можно ссылаться на атрибут, для этого перед именем атрибута необходимо указать знак «@» в конце последовательности. Также для формата XML возможно указывать префиксы элементов и задавать пространства имен. Префикс элемента указывается перед именем и разделяется знаком «:». Перед использованием префикса в адресе его необходимо привязать к пространству имен: namespace ns = namespaceUrlOrName, где:

• namespace — зарезервированное слово, можно писать как в верхнем, так и в нижнем регистре;

• ns — имя префикса;

• namespaceUrlOrName — имя пространства имен XML.

Константы представляют собой:

1. Строковые значения, заключенные в одинарные или двойные кавычки.

2. Числовые значения в десятичной форме или формате с плавающей точкой.

3. Булевые значения true или false.

Индекс последовательности элементов:

Допускается после имени элемента в адресе в квадратных скобках указывать индекс последовательности элементов.

Индекс может принимать значение:

1. Неотрицательное целое число — порядковый номер элемента последовательности, начиная с 0.

2. Знак «>» — ссылка на последний элемент последовательности.

3. Знак «+>» — используется при указании элемента в выходном сообщении, при этом сначала в конец последовательности добавляется новый элемент и возвращается ссылка на него.

4. Знак «<» — ссылка на первый элемент последовательности.

5. Знак «+<» — используется при указании элемента в выходном сообщении, при этом сначала в начало последовательности добавляется новый элемент и возвращается ссылка на него.

Для вложенных последовательностей элементов допускается обращаться по индексу подряд (In.array[1][2][3]).

Поведение индекса для разных форматов сообщений:

1. JSON — индекс применяется к значению поля, указанным до индекса, с типом последовательность элементов.

2. XML — индекс применяется к последовательности элементов с именем, указанным перед индексом.

Примеры использования присваивания значения элементу#