Селекторы

Field

Селектор поля соединения с данными.

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

Значение тэга <Field> не ожидается.

<Field Name="FieldName" Field="SourceFieldName"/>

Необязательный атрибут Field - название поля исходного соединения с данными. Если атрибут Field указан, то значение из атрибута Name используется как псевдоним для поля преобразованного соединения с данными. Если атрибут Field отсутствует, то будет использоваться значение из атрибута Name для получения данных из исходного соединения с данными.

Object

Селектор полей объекта.

В результирующую таблицу будут добавлены поля вложенных селекторов.

Значение тэга <Field>: список тэгов <Field>.

<Field Field="FieldName" Type="Object">
  <Field Name="SubFieldName" />
</Field>

Поле исходного соединения должно быть словарём.

Обязательный атрибут Field - название поля исходного соединения с данными, из которого будут выбираться данные.

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Object.

SubField

Селектор вложенного поля.

В результат добавится значение поля вложенного объекта. Является короткой версий селектора полей объекта.

Значение тэга <Field>: не ожидается.

<Field Name="FieldName"
       Type="SubField"
       Field="FieldName"
       SubField="SubFieldName"/>

Поле исходного соединения должно быть словарём.

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение SubField.

Необязательный атрибут Field - название поля исходного соединения с данными. Если атрибут Field указан, то значение из атрибута Name используется как псевдоним для поля преобразованного соединения с данными. Если атрибут Field отсутствует, то будет использоваться значение из атрибута Name для получения данных из исходного соединения с данными.

Обязательный атрибут SubField - название поля вложенного объекта. Ожидается название одного из полей объекта в поле, имя которого указано в атрибуте Field или Name, если атрибут Field отсутствует.

Array

Селектор соединения массива объектов.

Может содержать любые селекторы. В результирующую таблицу будут добавлены поля вложенных селекторов.

Значение тэга <Field>: список тэгов <Field>.

<Field Name="FieldName" Type="Array" Field="FieldName">
  <Field Name="FieldName" />
</Field>

Поле исходного соединения должно быть словарём.

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Array.

Необязательный атрибут Field - название поля исходного соединения с данными. Если атрибут Field указан, то значение из атрибута Name используется как псевдоним для поля преобразованного соединения с данными. Если атрибут Field отсутствует, то будет использоваться значение из атрибута Name для получения данных из исходного соединения с данными.

Value

Селектор значения.

Добавляет в результат колонку с именем из атрибута Name и типом данных из атрибута DataType. Для каждой строки в ячейку новой колонки ставиться значение, указанное в качестве значения тэга.

Значение тэга <Field>: любое значение.

<Field Name="FieldName" Type="Value" DataType="StringDataType">Value</Field>

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Value.

Необязательный атрибут DataType - тип данных, в который будет преобразовано значение. Атрибут ожидает один из доступных типов данных. По умолчанию используется значение StringDataType.

Format

Селектор форматирования строки.

Добавляет в результат колонку с именем из атрибута Name и результатом построения строки по шаблону со значениями полей исходного соединения с данными.

ЗВ качестве значения тэга ожидается строка-шаблон, с указанием в фигурных скобках {} имен полей исходного соединения с данными, которые будут источниками значений.

<Field Name="FieldName"
       Type="Format"
       DataType="DecimalDataType">{FieldName}</Field>

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Format.

Необязательный атрибут DataType - тип данных, в который будет преобразовано значение. Атрибут ожидает один из доступных типов данных. По умолчанию используется значение StringDataType.

Substitution

Селектор подстановки значений.

Добавляет в результат колонку с именем из атрибута Name, а значение для нее берет из матрицы подстановки по ключу из поля, указанному в атрибуте Field.

В качестве значения тэга ожидается матрица из 2-х столбцов. В первом столбце должен быть ключ, по которому будет идти подстановка, а во втором - значение, которое будет использоваться при подстановке.

<Field Name="FieldName"
       Type="Substitution"
       Field="FieldName"></Field>

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Substitution.

Необязательный атрибут Field - название поля исходного соединения с данными. Если атрибут Field указан, то значение из атрибута Name используется как псевдоним для поля преобразованного соединения с данными. Если атрибут Field отсутствует, то будет использоваться значение из атрибута Name для получения данных из исходного соединения с данными.

Replace

Селектор замены значений.

Добавляет в результат колонку с именем из атрибута Name и значением исходного соединения с данными с заменой в нём подстрок с использованием таблицы замены.

В качестве значения тэга ожидается матрица из 2-х столбцов. В первом столбце должен быть ключ, по которому будет идти замена, а во втором - значение, которое будет использоваться при замене.

<Field Name="FieldName"
       Type="Replace"
       Field="FieldName"></Field>

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Replace.

Необязательный атрибут Field - название поля исходного соединения с данными. Если атрибут Field указан, то значение из атрибута Name используется как псевдоним для поля преобразованного соединения с данными. Если атрибут Field отсутствует, то будет использоваться значение из атрибута Name для получения данных из исходного соединения с данными.

Замена происходит следующим образом: исходное значение преобразуется в текстовое, затем в строке последовательно заменяется значение из первого столбца таблицы замены на значение второго столбца таблицы замены.

Action

Селектор работы с массивами.

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

Ожидается описание операций по работе с массивами.

<Field Name="FieldName"
       Type="Action"
       Field="FieldName">Array Operations</Field>

Поле исходного соединения должно быть массивом.

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение Action.

Необязательный атрибут Field - название поля исходного соединения с данными. Если атрибут Field указан, то значение из атрибута Name используется как псевдоним для поля преобразованного соединения с данными. Если атрибут Field отсутствует, то будет использоваться значение из атрибута Name для получения данных из исходного соединения с данными.

TemplateFormat

Селектор форматирования строки по шаблону.

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

В качестве шаблонизатора используется Scriban. Подробнее по ссылке.

Ожидается строка с шаблоном.

<Field Name="FieldName"
       Type="TemplateFormat"
       DataType="DecimalDataType"
       Evaluate="True">Template</Field>

Обязательный атрибут Type - тип селектора. Имеет фиксированное значение TemplateFormat.

Необязательный атрибут DataType - тип данных, в который будет преобразовано значение. Атрибут ожидает один из доступных типов данных. По умолчанию используется значение StringDataType.

Необязательный атрибут Evaluate - признак, определяющий что нужно вычислить выражение. Ожидается логическое значение.