# Array ## Шаблон Array Минимальный шаблон ```xml ```
Полный шаблон Array ```xml 0 {Result} + {0} ```
## Описание Array Значение, которое будет передано в команду при выполнении. ```xml ``` В тэге `` указывается любое универсальное значение, с которым выполняются операции указанные после тэга `` *-* Operation1, Operation2. Операций может быть неограниченное количество. При этом **операции будут выполняться последовательно в порядке объявления**: для первой операции (*Operation1*) используется значение из тэга ``, для последующих операций - результат предыдущей операции. Все операции можно разделить на группы: * Изменение * Агрегация * Поиск * Соединение * Выборка из массива * Преобразование * Сортировка ## Изменение ### Add Добавляет элемент или элементы в массив. ```xml ``` При добавлении элементов используются следующие правила: * **Матрица добавляется в Матрицу**\ Строки из матрицы, указанной в тэге ``, добавляются в конец матрицы из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 4 Text 4 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | Text 3 | | 4 | Text 4 | +-----+----------+ ```
* **Массив добавляется в Матрицу**\ В массив из тэга `` добавляются пустые элементы, чтобы длина массива соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученный массив добавляются в конец матрицы.
Пример ```xml 1 True Text 1 2 False Text 2 3 False ``` Результат: ``` +-----+---------+----------+ | 1 | True | Text 1 | | 2 | False | Text 2 | | 3 | False | | +-----+---------+----------+ ```
* **Скаляр добавляется в Матрицу**\ Скаляр из тэга `` преобразуется в массив с длиной соответствующей наибольшей длине строки матрицы, указанной в тэге ``*,* и полученный массив добавляются в конец матрицы.
Пример ```xml 1 True Text 1 2 False Text 2 3 ``` Результат: ``` +-----+---------+----------+ | 1 | True | Text 1 | | 2 | False | Text 2 | | 3 | | | +-----+---------+----------+ ```
* **Матрица добавляется в Массив**\ Первый столбец матрицы, указанной в тэге ``, преобразуется в массив и добавляется в конец массива из тэга ``.
Пример ```xml 1 2 3 Text 3 4 Text 4 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 2 | 3 | 4 | +-----+-----+-----+-----+ ```
* **Массив добавляется в Массив**\ Массив из тэга `` добавляется в конец массива, указанного в тэге ``.
Пример ```xml 1 2 3 4 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 2 | 3 | 4 | +-----+-----+-----+-----+ ```
* **Скаляр добавляется в Массив**\ Скаляр из тэга `` добавляется в конец массива, указанного в тэге ``.
Пример ```xml 1 2 3 ``` Результат: ``` +-----+-----+-----+ | 1 | 2 | 3 | +-----+-----+-----+ ```
* Во всех случаях, когда в качестве значения тэга `` указан **скаляр**, будет генерироваться ошибка **TypeMismatch**. ### InsertAt Добавляет элемент или элементы в массив в указанную позицию. ```xml ``` При добавлении элементов используются следующие правила: * **Матрица добавляется в Матрицу**\ Строки из матрицы, указанной в тэге ``, добавляются в конец матрицы из тэга `` или в позицию с индексом из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 1 3 Text 3 4 Text 4 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 3 | Text 3 | | 4 | Text 4 | | 2 | Text 2 | +-----+----------+ ```
* **Массив добавляется в Матрицу**\ В массив из тэга `` добавляются пустые элементы, чтобы длина массива соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученный массив добавляются в конец матрицы или в позицию с индексом из тэга ``.
Пример ```xml 1 True Text 1 2 False Text 2 1 3 False ``` Результат: ``` +-----+---------+----------+ | 1 | True | Text 1 | | 3 | False | | | 2 | False | Text 2 | +-----+---------+----------+ ```
* **Скаляр добавляется в Матрицу**\ Скаляр из тэга `` преобразуется в массив с длиной соответствующей наибольшей длине строки матрицы, указанной в тэге ``*,* и полученный массив добавляются в конец матрицы или в позицию с индексом из тэга ``.
Пример ```xml 1 True Text 1 2 False Text 2 0 3 ``` Результат: ``` +-----+---------+----------+ | 3 | | | | 1 | True | Text 1 | | 2 | False | Text 2 | +-----+---------+----------+ ```
* **Матрица добавляется в Массив**\ Первый столбец матрицы, указанной в тэге ``, преобразуется в массив и добавляется в конец массива из тэга `` или в позицию с индексом из тэга ``.
Пример ```xml 1 2 1 3 Text 3 4 Text 4 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 3 | 4 | 2 | +-----+-----+-----+-----+ ```
* **Массив добавляется в Массив**\ Массив из тэга `` добавляется в конец массива, указанного в тэге `` или в позицию с индексом из тэга ``.
Пример ```xml 1 2 0 3 4 ``` Результат: ``` +-----+-----+-----+-----+ | 3 | 4 | 1 | 2 | +-----+-----+-----+-----+ ```
* **Скаляр добавляется в Массив**\ Скаляр из тэга `` добавляется в конец массива, указанного в тэге `` или в позицию с индексом из тэга ``.
Пример ```xml 1 2 0 3 ``` Результат: ``` +-----+-----+-----+ | 3 | 1 | 2 | +-----+-----+-----+ ```
* Во всех случаях, когда в качестве значения тэга `` указан **скаляр**, будет генерироваться ошибка **TypeMismatch**. ### Update Обновляет элемент в массиве/матрице в указанной позиции. ```xml ``` При обновлении элементов используются следующие правила: * **Массив добавляется в Матрицу**\ В массив из тэга `` добавляются пустые элементы, чтобы длина массива соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученный массив записывается в элемент с индексом ``.
Пример ```xml 1 True Text 1 2 False Text 2 0 3 False ``` Результат: ``` +-----+---------+----------+ | 3 | False | | | 2 | False | Text 2 | +-----+---------+----------+ ```
* **Скаляр добавляется в Матрицу**\ Скаляр из тэга `` преобразуется в массив с длиной соответствующей наибольшей длине строки матрицы, указанной в тэге ``*,* и полученный массив записывается в элемент с индексом ``.
Пример ```xml 1 True Text 1 2 False Text 2 0 3 ``` Результат: ``` +-----+---------+----------+ | 3 | | | | 2 | False | Text 2 | +-----+---------+----------+ ```
* **Матрица добавляется в Массив**\ Берет первый элемент первой строки матрицы, указанной в тэге ``, и записывается в элемент с индексом `` массива из тэга ``.
Пример ```xml 1 2 0 3 Text 3 4 Text 4 ``` Результат: ``` +-----+-----+ | 3 | 2 | +-----+-----+ ```
* **Массив добавляется в Массив**\ Берется первый элемент массива из тэга `` и записывается в элемент с индексом `` массива, указанном в тэге ``.
Пример ```xml 1 2 0 3 4 ``` Результат: ``` +-----+-----+ | 3 | 2 | +-----+-----+ ```
* **Скаляр добавляется в Массив**\ Скаляр из тэга `` записывается в элемент с индексом `` массива, указанного в тэге ``.
Пример ```xml 1 2 0 3 ``` Результат: ``` +-----+-----+ | 3 | 2 | +-----+-----+ ```
* Во всех случаях, когда в качестве значения тэга `` указан **скаляр**, будет генерироваться ошибка **TypeMismatch**. ### Remove Удаляет элемент(ы) по индексу или индексам. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Удаление элемента из матрицы ```xml 1 Text 1 2 Text 2 3 Text 3 1 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 3 | Text 3 | +-----+----------+ ```
Пример 2. Удаление элемента из массива ```xml 1 2 3 1 ``` Результат: ``` +-----+-----+ | 1 | 3 | +-----+-----+ ```
Пример 3. Удаление элементов из матрицы ```xml < 1 Text 1 2 Text 2 3 Text 3 4 Text 4 0 2 ``` Результат: ``` +-----+----------+ | 2 | Text 2 | | 4 | Text 4 | +-----+----------+ ```
## Агрегация ### Aggregate Вычисляет значения по формулам. ```xml ``` В выражении `` могут использоваться элементы исходного массива (указываются в квадратных скобках `[]`) или дополнительные значения, перечисленные в тэге `` (указываются в фигурных скобках `{}`). Также доступна переменная `{Result}`*,* в которой хранится значение, вычисленное для прошлого элемента. Если элементов Item в Aggregate/Items несколько, то возвращается массив результатов агрегации. Если один, то скалярное значение. {% hint style="info" %} Для вычисления выражений используется **NCalc**. {% endhint %} {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Сумма и произведение всех элементов массива ```xml 1 2 3 4 0 {Result} + [0] 1 {Result} * [0] ``` Результат: ``` +------+------+ | 10 | 24 | +------+------+ ```
Пример 2. Сумма произведения элементов матрицы ```xml 1 65 2 69 0 {Result} + [0] * [1] ``` Результат: ``` 203 ```
### Count Считает количество элементов в массиве. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 Text 1 2 Text 2 ``` Результат: ``` 2 ```
### Max Находит максимальный элемент в массиве или в столбце матрицы. ```xml ``` В атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). В необязательном атрибуте `Index` для матриц указывается индекс столбца, в котором будет происходить поиск максимального элемента. Если атрибут не указан, то используется значение 0. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Максимальный элемент в третьем столбце матрицы ```xml 1 Text 1 45 2 Text 2 61 3 Text 3 22 ``` Результат: ``` 61 ```
Пример 2. Максимальный элемент массива ```xml 7 2 10 5 ``` Результат: ``` 10 ```
### Min Находит минимальный элемент в массиве или в столбце матрицы. ```xml ``` В атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). В необязательном атрибуте `Index` для матриц указывается индекс столбца, в котором будет происходить поиск минимального элемента. Если атрибут не указан, то используется значение 0. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Минимальный элемент в третьем столбце матрицы ```xml 1 Text 1 45 2 Text 2 61 3 Text 3 22 ``` Результат: ``` 22 ```
Пример 2. Минимальный элемент массива ```xml 7 2 10 5 ``` Результат: ``` 2 ```
### Sum Находит сумму элементов в массиве или в столбце матрицы. ```xml ``` В атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). В необязательном атрибуте `Index` для матриц указывается индекс столбца, для которого будет вычисляться сумма элементов. Если атрибут не указан, то используется значение 0. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Сумма элементов в третьем столбце матрицы ```xml 1 Text 1 45 2 Text 2 61 3 Text 3 22 ``` Результат: ``` 128 ```
Пример 2. Сумма элементов массива ```xml 7 2 10 5 ``` Результат: ``` 24 ```
## Поиск ### IndexOf Возвращает индекс первого элемента массива удовлетворяющего условию. ```xml ``` В необязательном атрибуте `Type` тэга `` указывается [тип сравнения значений](#tipy-sravneniya-znachenii). По умолчанию используется фильтр Equal. Тэг `` применяется для выборки из массива словарей. В атрибуте `Name` указывается название поля словаря, по которому будет происходить проверка условия. Тэг `` применяется для выборки из одномерного массива или матрицы. Для матриц в атрибуте `Value` указывается индекс элемента строки, по которому будет проверка условия. Тэг [``](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types) задаёт тип элемента. По умолчанию используется тип **StringDataType**. В зависимости от типа фильтра тэги `` или `` могут отсутствовать. Например, в фильтрах IsNull, IsNotNull. #### Типы сравнения значений
EqualСравнение значений на равенство
NotEqualСравнение значений на неравенство
GreaterСравнение значений на "больше": элемент массива больше указанного значения
GreaterOrEqualСравнение значений на "больше или равно": элемент массива больше или равен указанному значению
LessСравнение значений на "меньше": элемент массива меньше указанного значения
LessOrEqualСравнение значений на "меньше или равно": элемент массива меньше или равен указанному значению
ContainsСравнение значений на "содержит": элемент массива содержит указанное значение, при этом все значения преобразуется в строку
NotContainsСравнение значений на "не содержит": элемент массива не содержит указанное значение, при этом все значения преобразуется в строку
InСравнение значений на "входит": элемент массива входит в указанный массив
NotInСравнение значений на "не входит": элемент массива не входит в указанный массив
OverlapСравнение значений на "пересекается": массив из элемента исходного массива имеет общие элементы с указанным массивом
NotOverlapСравнение значений на "не пересекается": массив из элемента исходного массива не имеет общие элементы с указанным массивом
MatchSearch

Сравнение значений на "удовлетворяет поисковой строке". Поисковая строка может состоять из слов, разделенных пробелами и символами "+", "*" и "?":

  • пробел означает "ИЛИ";
  • "+" означает "И";
  • "*" означает любое количество любых символов;
  • "?" означает ровно один символ.
NotMatchSearch

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

Поисковая строка может состоять из слов, разделенных пробелами и символами "+", "*" и "?":

  • пробел означает "ИЛИ";
  • "+" означает "И";
  • "*" означает любое количество любых символов;
  • "?" означает ровно один символ.
ContainedInСравнение значений на "входит": элемент массива входит в указанное значение, при этом все значения преобразуется в строку
NotContainedInСравнение значений на "не входит": элемент массива не входит в указанное значение, при этом все значения преобразуется в строку
IsNullСравнение на Null
IsNotNullСравнение на "не Null"
NestedСоставной фильтр. Для соединения вложенных фильтров (<Filter>) доступны тэги <And>, <Or>, <Not>
{% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Индекс первого элемента массива, который больше 10 ```xml -1 1 30 5 15 10 ``` Результат: ``` 2 ```
Пример 2. Индекс первого элемента массива, который больше 0 и меньше 20 ```xml -1 1 30 5 15 0 20 ``` Результат: ``` 1 ```
Пример 3. Индекс первого элемента матрицы, где второй столбец меньше 0 ```xml 2 2 3 -1 4 15 6 -5 7 5 0 ``` Результат: ``` 1 ```
Пример 4. Индекс первого элемента матрицы, где первый столбец больше 4 и второй в диапазоне от -10 до 10 ```xml 2 2 3 -1 4 15 6 -5 7 5 4 -10 10 ``` Результат: ``` 3 ```
### Filter Возвращает элементы массива, удовлетворяющие условию. ```xml ``` В необязательном атрибуте `Type` тэга `` указывается [тип фильтра](#tipy-sravneniya-znachenii-1). По умолчанию используется фильтр Equal. Тэг `` применяется для выборки из массива словарей. В атрибуте `Name` указывается название поля словаря, по которому будет происходить проверка условия. Тэг `` применяется для выборки из одномерного массива или матрицы. Для матриц в атрибуте `Value` указывается индекс элемента строки, по которому будет проверка условия. Тэг [``](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types) задаёт тип элемента. По умолчанию используется тип **StringDataType**. В зависимости от типа фильтра тэги `` или `` могут отсутствовать. Например, в фильтрах IsNull, IsNotNull. #### Типы фильтров
EqualСравнение значений на равенство
NotEqualСравнение значений на неравенство
GreaterСравнение значений на "больше": элемент массива больше указанного значения
GreaterOrEqualСравнение значений на "больше или равно": элемент массива больше или равен указанному значению
LessСравнение значений на "меньше": элемент массива меньше указанного значения
LessOrEqualСравнение значений на "меньше или равно": элемент массива меньше или равен указанному значению
ContainsСравнение значений на "содержит": элемент массива содержит указанное значение, при этом все значения преобразуется в строку
NotContainsСравнение значений на "не содержит": элемент массива не содержит указанное значение, при этом все значения преобразуется в строку
InСравнение значений на "входит": элемент массива входит в указанный массив
NotInСравнение значений на "не входит": элемент массива не входит в указанный массив
OverlapСравнение значений на "пересекается": массив из элемента исходного массива имеет общие элементы с указанным массивом
NotOverlapСравнение значений на "не пересекается": массив из элемента исходного массива не имеет общие элементы с указанным массивом
MatchSearch

Сравнение значений на "удовлетворяет поисковой строке". Поисковая строка может состоять из слов, разделенных пробелами и символами "+", "*" и "?":

  • пробел означает "ИЛИ";
  • "+" означает "И";
  • "*" означает любое количество любых символов;
  • "?" означает ровно один символ.
NotMatchSearch

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

Поисковая строка может состоять из слов, разделенных пробелами и символами "+", "*" и "?":

  • пробел означает "ИЛИ";
  • "+" означает "И";
  • "*" означает любое количество любых символов;
  • "?" означает ровно один символ.
ContainedInСравнение значений на "входит": элемент массива входит в указанное значение, при этом все значения преобразуется в строку
NotContainedInСравнение значений на "не входит": элемент массива не входит в указанное значение, при этом все значения преобразуется в строку
IsNullСравнение на Null
IsNotNullСравнение на "не Null"
NestedСоставной фильтр. Для соединения вложенных фильтров доступны тэги <And>, <Or>, <Not>
{% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Все элементы массива больше 10 ```xml -1 1 30 5 15 10 ``` Результат: ``` +------+------+ | 30 | 15 | +------+------+ ```
Пример 2. Все элементы массива больше 0 и меньше 20 ```xml -1 1 30 5 15 0 20 ``` Результат: ``` +-----+-----+------+ | 1 | 5 | 15 | +-----+-----+------+ ```
Пример 3. Все элементы матрицы во втором столбце меньше 0 ```xml 2 2 3 -1 4 15 6 -5 7 5 0 ``` Результат: ``` +-----+------+ | 3 | -1 | | 6 | -5 | +-----+------+ ```
Пример 4. Первый столбец матрицы больше 4 и второй в диапазоне от -10 до 10 ```xml 2 2 3 -1 4 15 6 -5 7 5 4 -10 10 ``` Результат: ``` +-----+------+ | 6 | -5 | | 7 | 5 | +-----+------+ ```
## Соединение ### Join Соединяет исходную матрицу с внешней матрицей по выбранным ключам.\ Аналог `JOIN` из SQL. ```xml ``` В тэге `` указываются индексы элементов, по которым исходная и внешняя матрицы будут соединяться. В атрибуте `Index` указывается положительное целочисленное значение, а в атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). {% hint style="warning" %} Количество `` и `` индексов в тэге ``должно совпадать. Если ключей больше одного, то важен порядок их описания, так как `` и `` индексы сравниваются по парно в порядке описания. {% endhint %} В тэге `` указываются индексы элементов исходной и/или внешней матрицы, которые будут добавлены в результирующую матрицу. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 Text 1 2 Text 2 1 100 3 50 4 95 ``` Результат: ``` +-----+----------+-------+ | 1 | Text 1 | 100 | +-----+----------+-------+ ```
### LeftJoin Соединяет исходную матрицу с внешней матрицей по выбранным ключам, используя все элементы исходной матрицы.\ Аналог `LEFT JOIN` из SQL. ```xml ``` В тэге `` указываются индексы элементов, по которым исходная и внешняя матрицы будут соединяться. В атрибуте `Index` указывается положительное целочисленное значение, а в атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). {% hint style="warning" %} Количество `` и `` индексов в тэге ``должно совпадать. {% endhint %} В тэге `` указываются индексы элементов исходной и/или внешней матрицы, которые будут добавлены в результирующую матрицу. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 Text 1 2 Text 2 1 100 3 50 4 95 ``` Результат: ``` +-----+----------+-------+ | 1 | Text 1 | 100 | | 2 | Text 2 | | +-----+----------+-------+ ```
### RightJoin Соединяет исходную матрицу с внешней матрицей по выбранным ключам, используя все элементы внешней матрицы.\ Аналог `RIGHT JOIN` из SQL. ```xml ``` В тэге `` указываются индексы элементов, по которым исходная и внешняя матрицы будут соединяться. В атрибуте `Index` указывается положительное целочисленное значение, а в атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). {% hint style="warning" %} Количество `` и `` индексов в тэге ``должно совпадать. {% endhint %} В тэге `` указываются индексы элементов исходной и/или внешней матрицы, которые будут добавлены в результирующую матрицу. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 Text 1 2 Text 2 1 100 3 50 4 95 ``` Результат: ``` +-----+----------+-------+ | 1 | Text 1 | 100 | | 3 | | 50 | | 4 | | 95 | +-----+----------+-------+ ```
### FullJoin Соединяет исходную матрицу с внешней матрицей по выбранным ключам, используя все элементы исходной и внешней матриц.\ Аналог `FULL JOIN` из SQL. ```xml ``` В тэге `` указываются индексы элементов, по которым исходная и внешняя матрицы будут соединяться. В атрибуте `Index` указывается положительное целочисленное значение, а в атрибуте `Type` задаётся один из [типов](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). {% hint style="warning" %} Количество `` и `` индексов в тэге ``должно совпадать. {% endhint %} В тэге `` указываются индексы элементов исходной и/или внешней матрицы, которые будут добавлены в результирующую матрицу. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 Text 1 2 Text 2 1 100 3 50 4 95 ``` Результат: ``` +-----+----------+-------+ | 1 | Text 1 | 100 | | 2 | Text 2 | | | | | 50 | | | | 95 | +-----+----------+-------+ ```
### Concat Объединяет два массива с сохранением дубликатов. ```xml ``` При объединении элементов используются следующие правила: * **Матрица объединяется с Матрицей**\ В каждую строку матрицы из тэга `` добавляются пустые элементы, чтобы длина строки соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученная матрица объединяется с матрицей из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 2 Text 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | Text 3 | | 2 | Text 2 | +-----+----------+ ```
* **Массив объединяется с Матрицей**\ Массив из тэга `` преобразуется в матрицу. В каждую строку новой матрицы добавляются пустые элементы, чтобы длина строки соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученная матрица объединяется с матрицей из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | | | 2 | | +-----+----------+ ```
* **Скаляр объединяется с Матрицей**\ Скаляр из тэга `` преобразуется в матрицу. В единственную строку новой матрицы добавляются пустые элементы, чтобы длина строки соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученная матрица объединяется с матрицей из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | | +-----+----------+ ```
* **Матрица объединяется с Массивом**\ Матрица из тэга `` преобразуется в массив, при этом берутся первые элементы каждой строки. Полученный массив объединяется с массивом из тэга ``.
Пример ```xml 1 2 3 Text 3 2 Text 2 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 2 | 3 | 2 | +-----+-----+-----+-----+ ```
* **Массив объединяется с Массивом**\ Массив из тэга `` объединяется с массивом из тэга ``.
Пример ```xml 1 2 3 2 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 2 | 3 | 2 | +-----+-----+-----+-----+ ```
* **Скаляр объединяется с Массивом**\ Скаляр из тэга `` преобразуется в массив и объединяется с массивом из тэга ``.
Пример ```xml 1 2 2 ``` Результат: ``` +-----+-----+-----+ | 1 | 2 | 2 | +-----+-----+-----+ ```
* Во всех случаях, когда в качестве значения тэга `` указан **скаляр**, будет генерироваться ошибка **TypeMismatch**. ### Union Объединяет два массива без сохранения дубликатов. ```xml ``` При объединении элементов используются следующие правила: * **Матрица объединяется с Матрицей**\ В каждую строку матрицы из тэга `` добавляются пустые элементы, чтобы длина строки соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученная матрица объединяется с матрицей из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 2 Text 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | Text 3 | +-----+----------+ ```
* **Массив объединяется с Матрицей**\ Массив из тэга `` преобразуется в матрицу. В каждую строку новой матрицы добавляются пустые элементы, чтобы длина строки соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученная матрица объединяется с матрицей из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | | | 2 | | +-----+----------+ ```
* **Скаляр объединяется с Матрицей**\ Скаляр из тэга `` преобразуется в матрицу. В единственную строку новой матрицы добавляются пустые элементы, чтобы длина строки соответствовала наибольшей длине строки матрицы, указанной в тэге ``, и полученная матрица объединяется с матрицей из тэга ``.
Пример ```xml 1 Text 1 2 Text 2 3 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | | 3 | | +-----+----------+ ```
* **Матрица объединяется с Массивом**\ Матрица из тэга `` преобразуется в массив, при этом берутся первые элементы каждой строки. Полученный массив объединяется с массивом из тэга ``.
Пример ```xml 1 2 3 Text 3 2 Text 2 ``` Результат: ``` +-----+-----+-----+ | 1 | 2 | 3 | +-----+-----+-----+ ```
* **Массив объединяется с Массивом**\ Массив из тэга `` объединяется с массивом из тэга ``.
Пример ```xml 1 2 3 2 ``` Результат: ``` +-----+-----+-----+ | 1 | 2 | 3 | +-----+-----+-----+ ```
* **Скаляр объединяется с Массивом**\ Скаляр из тэга `` преобразуется в массив и объединяется с массивом из тэга ``.
Пример ```xml 1 2 2 ``` Результат: ``` +-----+-----+ | 1 | 2 | +-----+-----+ ```
* Во всех случаях, когда в качестве значения тэга `` указан **скаляр**, будет генерироваться ошибка **TypeMismatch**. ### Group Группирует элементы массива по указанным индексам.\ Если в исходном массиве отсутствует элемент с индексом, то вместо него используется значение **Null**. ```xml ``` Элементов `` может быть неограниченное количество. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 Text 1 1 Text 2 2 Text 3 ``` Результат: ``` +-----+------------------+ | 1 |+-----+----------+| | || 1 | Text 1 || | || 1 | Text 2 || | |+-----+----------+| +-----+-----+------------+ | 2 |+-----+----------+| | || 2 | Text 3 || | |+-----+----------+| +-----+------------------+ ``` Т.е. будет таблица из двух колонок и двух строк. В первой строке в первой колонке будет скалярный элемент со значением 1, а во второй колонке будет храниться таблица с двумя строками из источника. Во второй строке во второй колонке будет храниться таблица с одной строкой.
### Zip Соединяет строки двух массивов таким образом, что первый элемент исходного массива соединяется с первым элементом массива, второй со вторым и т.д. ```xml ``` {% hint style="info" %} Длина нового массива соответствует длине наименьшего из массивов. Так же стоит учитывать момент, когда один из соединяемых массивов возвращает null, то в качестве результат соединения так же будет null. {% endhint %} При объединении элементов используются следующие правила: * **Матрица объединяется с Матрицей**\ В конец каждой строки исходной матрицы добавляются элементы из соответствующей строки матрицы, указанной в тэге ``.
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 4 Text 4 5 Text 5 ``` Результат: ``` +-----+----------+-----+----------+ | 1 | Text 1 | 3 | Text 3 | | 2 | Text 2 | 4 | Text 4 | +-----+----------+-----+----------+ ```
* **Массив объединяется с Матрицей**\ В конец каждой строки исходной матрицы добавляется соответствующий элемент массива, указанного в тэге ``.
Пример ```xml 1 Text 1 2 Text 2 3 4 5 ``` Результат: ``` +-----+----------+-----+ | 1 | Text 1 | 3 | | 2 | Text 2 | 4 | +-----+----------+-----+ ```
* **Скаляр объединяется с Матрицей**\ Скаляр из тэга `` добавляется в конец первой строки исходной матрицы, остальные строки матрицы отбрасываются.
Пример ```xml 1 Text 1 2 Text 2 3 ``` Результат: ``` +-----+----------+-----+ | 1 | Text 1 | 3 | +-----+----------+-----+ ```
* **Матрица объединяется с Массивом**\ Матрица из тэга `` преобразуется в массив, при этом берутся первые элементы каждой строки. Полученный массив объединяется с массивом из тэга ``, при этом элементы массивов образуют строки новой матрицы.
Пример ```xml 1 2 3 Text 3 4 Text 4 5 Text 5 ``` Результат: ``` +-----+-----+ | 1 | 3 | | 2 | 4 | +-----+-----+ ```
* **Массив объединяется с Массивом**\ Элемент массив из тэга `` объединяется с соответствующим элементом массива из тэга `` так, что образуют строку новой матрицы.
Пример ```xml 1 2 3 4 5 ``` Результат: ``` +-----+-----+ | 1 | 3 | | 2 | 4 | +-----+-----+ ```
* **Скаляр объединяется с Массивом**\ Скаляр из тэга `` преобразуется в массив, и элементы полученного массива соединяются с элементами массива из тэга ``.
Пример ```xml 1 2 3 ``` Результат: ``` +-----+-----+ | 1 | 3 | +-----+-----+ ```
* Во всех случаях, когда в качестве значения тэга `` указан **скаляр**, будет генерироваться ошибка **TypeMismatch**. ## Выборка из массива ### ElementAt Возвращает элемент массива по заданному индексу.\ Если индекс элемента отсутствует в массиве, то операция вернёт **Null**. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Поиск в матрице ```xml 1 Text 1 2 Text 2 3 Text 3 1 ``` Результат: ``` +-----+----------+ | 2 | Text 2 | +-----+----------+ ```
Пример 2. Поиск в массиве ```xml 1 2 3 1 ``` Результат: ``` 2 ```
### Field Формирует массив из массива словарей.\ Из каждого словаря достает элемент по ключу, имя которого указано в атрибуте `Name` тэга ``. Если ключ отсутствует в словаре, то возвращается **Null**. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **не массив словарей**, то выбрасывается исключение **TypeMismatch**. {% endhint %}
Пример ```xml Val1 Val2 Val3 ``` Результат: ``` +--------+--------+--------+ | Val1 | Val2 | NULL | +--------+--------+--------+ ```
### First Возвращает первый элемент массива или матрицы.\ Если массив пустой, то возвращается **Null**. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Первый элемент матрицы ```xml 1 Text 1 2 Text 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | +-----+----------+ ```
Пример 2. Первый элемент массива ```xml 1 2 3 4 ``` Результат: ``` 1 ```
### Last Возвращает последний элемент массива или матрицы.\ Если массив пустой, то возвращается **Null**. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Последний элемент матрицы ```xml 1 Text 1 2 Text 2 ``` Результат: ``` +-----+----------+ | 2 | Text 2 | +-----+----------+ ```
Пример 2. Последний элемент массива ```xml 1 2 3 4 ``` Результат: ``` 4 ```
### Skip Пропускает указанное количество элементов и возвращает оставшиеся элементы. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Пропуск первых двух элементов в матрице ```xml 1 Text 1 2 Text 2 3 Text 3 4 Text 4 2 ``` Результат: ``` +-----+----------+ | 3 | Text 3 | | 4 | Text 4 | +-----+----------+ ```
Пример 2. Пропуск первых двух элементов в массиве ```xml 1 2 3 4 2 ``` Результат: ``` +-----+-----+ | 3 | 4 | +-----+-----+ ```
### Take Возвращает указанное количество начальных элементов из исходного массива или матрицы. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Первые два элемента матрицы ```xml 1 Text 1 2 Text 2 3 Text 3 4 Text 4 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 2 | Text 2 | +-----+----------+ ```
Пример 2. Первые два элемента массива ```xml 1 2 3 4 2 ``` Результат: ``` +-----+-----+ | 1 | 2 | +-----+-----+ ```
## Преобразование ### DataTypeFormat Преобразует элементы массива в строку с использованием формата указанного [типа](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). ```xml ``` Если в тэге `` указана матрица, то будут браться первые элементы всех строк, а затем преобразовываться в строку заданного формата.
Пример ```xml 1 2 3 4 ``` Результат: ``` +--------+--------+--------+--------+ | 1,00 | 2,00 | 3,00 | 4,00 | +--------+--------+--------+--------+ ```
### DataTypeConvert Приводит элементы массива к заданному [типу](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/data_types). ```xml ``` Если в тэге `` указана матрица, то все ее элементы будут приводиться к заданному типу.
Пример ```xml 1.0 2 3.7 4 ``` Результат: ``` +-----+-----+-------+-----+ | 1 | 2 | 3,7 | 4 | +-----+-----+-------+-----+ ```
### Distinct Возвращает уникальные элементы массива. ```xml ``` Для выборки строк в матрице можно указать индекс столбца, в котором будет проходить проверка уникальности: ```xml ``` Тэгов `` может быть любое количество. Если тэги `` отсутствуют, то выборка строк происходит по первому столбцу. Если необходимо проверить все столбцы матрицы, то можно использовать необязательный атрибут `AllIndices`: ```xml ``` Если указаны и атрибут `AllIndices` и тэги ``, то преимущество отдается атрибуту. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Уникальные элементы в массиве ```xml 1 2 1 4 ``` Результат: ``` +-----+-----+-----+ | 1 | 2 | 4 | +-----+-----+-----+ ```
Пример 2. Уникальные элементы в матрице по всем столбцам ```xml 1 2 1 1 1 2 2 1 ``` Результат: ``` +-----+-----+ | 1 | 2 | | 1 | 1 | | 2 | 1 | +-----+-----+ ```
Пример 3. Уникальные элементы в матрице по одному столбцу ```xml 1 2 1 1 1 2 2 1 ``` Результат: ``` +-----+-----+ | 1 | 2 | | 1 | 1 | +-----+-----+ ```
### Select Преобразует массив в другой массив с помощью селекторов. ```xml ``` В тэге `` указываются селекторы, которые последовательно применяются к каждому элементу исходного массива (для матриц элементом является строка матрицы). Из значений селекторов формируется новый массив или матрица. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %} {% hint style="info" %} Селекторы можно комбинировать друг с другом. {% endhint %} Поддерживаются селекторы следующих видов: #### **Index** Выбирает элемент из исходного массива или матрицы. ```xml ```
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 ``` Результат: ``` +-----+-----+----------+ | 1 | 1 | Text 1 | | 2 | 2 | Text 2 | | 3 | 3 | Text 3 | +-----+-----+----------+ ```
#### **Field** Выбор элемент из словаря. ```xml ```
Пример ```xml Text 1 Text 2 Text 3 Text 4 ``` Результат: ``` +----------+----------+ | Text 2 | Text 3 | +----------+----------+ ```
#### **Value** Подставляет константное значение. ```xml ```
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 ``` Результат: ``` +-----+----------+-------+ | 1 | Text 1 | 100 | | 2 | Text 2 | 100 | | 3 | Text 3 | 100 | +-----+----------+-------+ ```
#### **Number** Подставляет порядковый номер элемента.\ В необязательном атрибуте `Start` можно задать начальное значение последовательности. По умолчанию используется **0**. ```xml ```
Пример ```xml 1 Text 1 2 Text 2 3 Text 3 ``` Результат: ``` +-----+-----+----------+ | 5 | 1 | Text 1 | | 6 | 2 | Text 2 | | 7 | 3 | Text 3 | +-----+-----+----------+ ```
#### **Expression** Вычисляет выражение на основе данных массива и дополнительных переменных.\ Тэгов `` может быть любое количество. В выражении `` могут использоваться элементы исходного массива (указываются в квадратных скобках `[]`) или дополнительные значения, перечисленные в тэге `` (указываются в фигурных скобках `{}`). ```xml ```
Пример ```xml 1 Text 1 10 2 Text 2 20 3 Text 3 30 ``` Результат: ``` +-----+----------+-------+ | 1 | Text 1 | 0,1 | | 2 | Text 2 | 0,2 | | 3 | Text 3 | 0,3 | +-----+----------+-------+ ```
#### **Format** Форматирует элементы массива в строку.\ В строке формата элементы исходного массива доступны по индексу и указываются в фигурных скобках `{}`. ```xml ```
Пример ```xml 1 200 2 2 400 1 3 300 1 ``` Результат: ``` +-----+----------------+ | 1 | Text 2 (200) | | 2 | Text 1 (400) | | 3 | Text 1 (300) | +-----+----------------+ ```
#### **Action** Элемент на основе вложенного массива.\ В тэге `` указываются операции по работе с массивами аналогично тэгу ``. Исходным массивом для первой операции будет элемент массива с индексом из тэга ``. ```xml ```
Пример 1. Группировка строк по первому столбцу и расчет суммы вторых столбцов для каждой группы ```xml 1 200 2 400 1 300 1 ``` Результат: ``` +-----+-------+ | 1 | 500 | | 2 | 400 | +-----+-------+ ```
Пример 2. Расчет суммы элементов для каждого массива в массиве ```xml 1 200 80 2 400 50 1 300 20 ``` Результат: ``` +-------+-------+-------+ | 281 | 452 | 321 | +-------+-------+-------+ ```
#### **Substitution** Выбор значения из таблицы подстановки.\ В качестве таблицы подстановки должна быть матрица, состоящая из двух столбцов. В первом столбце должен быть ключ, по которому будет идти подстановка, а во втором - значение, которое будет использоваться при подстановке. ```xml ```
Пример ```xml 1 2 2 1 3 1 ``` Результат: ``` +-----+----------+ | 1 | Text 2 | | 2 | Text 1 | | 3 | Text 1 | +-----+----------+ ```
### SelectMany Объединяет строки матрицы в одномерный массив. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1 80 2 50 3 20 ``` Результат: ``` +-----+------+-----+------+-----+------+ | 1 | 80 | 2 | 50 | 3 | 20 | +-----+------+-----+------+-----+------+ ```
### StringJoin Форматирует входящее значение в строку. ```xml ``` Обязательный атрибут `Separator` используется для задания разделителя элементов массива или элементов строки матрицы. Необязательный атрибут `LineSeparator` используется для задания разделителя строк в матрице. По умолчанию используется значение, указанное в атрибуте `Separator`. {% hint style="info" %} Для задания "новой" строки используется сочетание символов: `\r\n`. {% endhint %}
Пример 1. Массив массивов ```xml 1 80 2 50 ``` Результат: ``` 1; 80; 2; 50 ```
Пример 2. Матрица ```xml 1 Text 1 2 Text 2 3 Text 3 ``` Результат: ``` 1; Text 1 2; Text 2 3; Text 3 ```
Пример 3. Массив ```xml Text 1 Text 2 Text 3 ``` Результат: ``` Text 1; Text 2; Text 3 ```
### StringSplit Преобразует входное значение в строку, которую затем разделяет по заданному разделителю. ```xml ``` Обязательный атрибут `Separator` используется для задания разделителя, по которому строка будет разделена. {% hint style="info" %} Для разбиения по "новой" строке используется сочетание символов: `\r\n`. {% endhint %} {% hint style="warning" %} Так как тэг `` всегда возвращает массив, то необходимо использовать тэг `` (или любой другой способ), чтобы получить элемент массива, которой будет преобразовываться в строку и разбиваться по заданному разделителю. {% endhint %} {% hint style="warning" %} Если в качестве значения тэга `` указано **не** **скалярное значение**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 1, 2, 3, 4 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 2 | 3 | 4 | +-----+-----+-----+-----+ ```
### ToDictionary Преобразует массив в массив словарей. ```xml ``` Тэгов `` может быть произвольное количество. В атрибуте `Name` указывается название ключа словаря. В атрибуте `Index` указывается индекс элемента массива, который будет записан в словарь по ключу `Name`. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Массив преобразуется в словарь ```xml 1 2 1 4 ``` Результат: ``` [ { "Id":"1" }, { "Id":"2" }, { "Id":"1" }, { "Id":"4" } ] ```
Пример 2. Матрица преобразуется в словарь ```xml 1 100 2 38 3 26 ``` Результат: ``` [ {"Id":"1","Count":"100"}, {"Id":"2","Count":"38"}, {"Id":"3","Count":"26"} ] ```
### ToTable Преобразует массив или скалярное значение в матрицу. ```xml ``` Преобразование происходит по следующим правилам: * **Массив преобразуется в матрицу**\ Создается матрица с количеством строк равным количеству элементов входного массива, и каждый элемент массива пишется в отдельную строку матрицы.
Пример ```xml 1 2 3 4 ``` Результат: ``` +-----+ | 1 | | 2 | | 3 | | 4 | +-----+ ```
* **Скаляр преобразуется в матрицу**\ Создается матрица из одной строки, в которую пишется входное скалярное значение.
Пример ```xml 2 ``` Результат: ``` +-----+ | 2 | +-----+ ```
### ToArray Преобразует входное значение в массив, если значение скаляр, для массивов возвращает исходное значение. ```xml ```
Пример ```xml 10 ``` Результат: ``` +------+ | 10 | +------+ ```
## Сортировка ### Order Сортирует элементы массива и матрицы по указанным индексам. ```xml ``` Тэгов `` может быть неограниченное количество. В атрибуте `Index` указывается индекс элемента строки матрицы, по которому будет происходить сортировка. Если в исходном матрице отсутствует элемент с указанным индексом, то такое условие сортировки будет игнорироваться. В необязательном атрибуте `Type` указывается тип сортировки: **Asc** для сортировки элементов по возрастанию (значение по умолчанию) или **Desc** для сортировки по убыванию. {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример 1. Сортировка матрицы по одному столбцу ```xml 3 Text 3 1 Text 1 2 Text 2 1 Text 2 ``` Результат: ``` +-----+----------+ | 1 | Text 1 | | 1 | Text 2 | | 2 | Text 2 | | 3 | Text 3 | +-----+----------+ ```
Пример 2. Сортировка матрицы по двум столбцам ```xml 3 Text 3 1 Text 1 2 Text 2 1 Text 2 ``` Результат: ``` +-----+----------+ | 1 | Text 2 | | 1 | Text 1 | | 2 | Text 2 | | 3 | Text 3 | +-----+----------+ ```
Пример 3. Сортировка массива по убыванию ```xml 3 4 1 2 ``` Результат: ``` +-----+-----+-----+-----+ | 4 | 3 | 2 | 1 | +-----+-----+-----+-----+ ```
### Sort Сортирует элементы одномерного массива. ```xml ``` {% hint style="warning" %} Если в качестве значения тэга `` указан **скаляр или матрица**, то будет генерироваться ошибка **TypeMismatch**. {% endhint %}
Пример ```xml 3 4 1 2 ``` Результат: ``` +-----+-----+-----+-----+ | 1 | 2 | 3 | 4 | +-----+-----+-----+-----+ ```
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/values/array.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.