Операции с данными: структуры, массивы, преобразования, regex

Этот раздел содержит описание функций, предназначенных для работы с различными типами данных: объектами, структурами, массивами и строками.

Функции позволяют выполнять операции преобразования, объединения, поиска, разбиения и итерации, а также работать с регулярными выражениями.

---

Функции для работы с объектами

BreakDynamic

Описание: Функция позволяет разложить произвольный объект на составные элементы.

1. На вход всегда принимается произвольный объект типа Dynamic. Для выхода пользователь создает пины, задает их типы и указывает, какие предполагаемые поля войдут в его состав.
2. В случае если для данного объекта существует такое поле, то его значение передается на выход.

Inputs

Название	Тип	Описание
Object	Wildcard:Dynamic single	Принимает любой объект

Outputs

Название	Тип	Описание
Настраиваемый	Настраиваемый	Пользователь может добавить и настроить Пины в инспекторе. Пины могут быть массивом

BreakStruct

Описание: Функция автоматически раскладывает структуру на ее свойства при установлении входящей связи. Свойства первого уровня вложенности отражаются в виде исходящих пинов.

Inputs

Название	Тип	Описание
Value	Wildcard:Struct single	Принимает любую структуру

Outputs

Название	Тип	Описание
-	Тип и количество пинов зависят от состава входящей структуры	Пины добавляются автоматически, при установке входящей связи

ConvertToDynamic

Описание: Преобразует объекты типа Struct, а так же массив Dynamic в Dynamic single (JSON)

Inputs

Название	Тип	Описание
Value	Wildcard: Any Struct single/array, Dynamic Array	Исходное значение. Структура или массив структур.

Outputs

Название	Тип	Описание
Result	Dynamic	Возвращает преобразованное значение

DynamicMerge

Описание: Функция принимает на вход два объекта типа Dynamic и выполняет объединение их содержимого.

• Объединение происходит путем слияния второго объекта с первым.
• При слиянии осуществляется проверка на уникальность полей. В случае если в объединяемых объектах существуют одинаковые поля, значение исходного поля заменяется значением второго объекта.
• Слияние строк происходит в порядке расположения пинов сверху вниз.

Inputs

Название	Тип	Описание
Object	Dynamic	Исходный объект
Value	Dynamic	Объект, который планируется слить с исходным объектом

Outputs

Название	Тип	Описание
Result	Dynamic	Результат объединения двух объектов

DynamicContains

Описание: Функция осуществляет проверку на наличие заданного поля в объекте и активирует последовательность Contains, если поле найдено, или NotContains если не найдено.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Object	Dynamic	Объект, в котором будет выполнена проверка наличия поля FieldName
Value	String	Название проверяемого поля

Outputs

Название	Тип	Описание
Contains	Exec	Последовательность активна, если поле найдено
NotContains	Exec	Последовательность активна, если поле НЕ найдено

MakeStruct

Описание: Функция устанавливает исходящую связь со структурой и позволяет задать значения ее свойств. Свойства первого уровня вложенности отражаются в виде входящих пинов.

Inputs

Название	Тип	Описание
*	Типы и количество пинов зависят от состава конкретной структуры	Пины добавляются автоматически, при установке исходящей связи.

Outputs

Название	Тип	Описание
Result	Wildcard: Any struct (single)	Устанавливает связь с пинами типа "Struct"

ReturnNull

Описание: Функция возвращает Null для пинов, с которым будет установлена связь.

В случае с блоками автоматизации, если для входящих пинов не указано значение, то будет передано значение по умолчанию для указанного типа: "", "0" и т.д.
Однако некоторые запросы к API ожидают получить в модели именно Null, для этого понадобится данная функция.

Outputs

Название	Тип	Описание
Null	Wildcard: any array, Dynamic:Single, String:Single, Struct:Single	Возвращает Null в качестве значений пина

SetMembersInStruct

Описание: Функция позволяет внести изменение в значение конкретных свойств структуры.

• Блок создается с доступным для выбора типом структуры
• На вход функции принимается вся структура. В инспекторе пользователь может указать, для каких свойств структуры нужно задать собственное значение
• Выбранные пользователем свойства отображаются, как входящие пины функции, с которыми можно установить связь или задать контрол
• На выходе функции будет представлена структура с измененными значениями

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Value	Wildcard: Struct single	Принимает на вход структуру
-	-	По умолчанию, пины свойств структуры будут отсутствовать. Их нужно указать в настройках конфигурации в инспекторе.

Outputs

Название	Тип	Описание
Out	Exec	Пин вызова функции
Result	Struct	На выходе будет указанный тип структуры с обновленными значениями указанных свойств

---

Функции для работы с массивами

ArrayAddElement

Описание: Функция добавляет элемент к входящему массиву и возвращает обновленный массив.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Array	Wildcard: Any array	Принимает и изменяет массив. Тип пина для wildcard устанавливается на все пины.
Element	Wildcard: Any single	Принимает на вход элемент, который будет добавлен в массив. Тип пина для wildcard устанавливается на все пины.

Outputs

Название	Тип	Описание
Out	Exec	Пин вызова функции
Result	Wildcard: Any array	Возвращает измененный массив. Тип пина для wildcard устанавливается на все пины.

ArrayAny

Описание: Функция принимает на вход массив и возвращает true, если массив содержит хотя бы один элемент.

Inputs

Название	Тип	Описание
Array	Wildcard: Any array	Принимает на вход массив для проверки на наличие в нем элементов

Outputs

Название	Тип	Описание
Result	Bool	Возвращает значение по результатам проверки

ArrayContains

Описание: Функция принимает массив любого типа и одно значение того же типа, проверяет наличие этого значения среди элементов массива и возвращает булево значение true/false.

Inputs

Название	Тип	Описание
Array	Wildcard: Any array	Принимает на вход массив для проверки на наличие в нем элементов
Element	Wildcard: Single	Искомый элемент массива с тем же типом

Outputs

Название	Тип	Описание
Result	Bool	Возвращает значение по результатам проверки

ArrayCreate

Описание: Функция инициализации и наполнения массива

Inputs

Название	Тип	Описание
a	Wildcard: Single	Элемент, который будет добавлен в состав массива

Outputs

Название	Тип	Описание
Result	Wildcard: Array	Возвращает созданный массив

ArrayExcept

Описание: Функция принимает на вход два Wildcard массива, возвращает массив, содержащий все элементы первого массива, которых нет во втором массиве.

Тип наследуется для всех 3-х пинов при установке/снятии связи.

Inputs

Название	Тип	Описание
First	Wildcard: Any array	Принимает любой массив, тип устанавливается на все пины блока, если еще не был установлен.
Second	Wildcard: Any array	Принимает любой массив, тип устанавливается на все пины блока, если еще не был установлен.

Outputs

Название	Тип	Описание
Result	Wildcard: Any array	Возвращает массив элементов первого массива, которых нет во втором массиве.

ArrayIntersect

Описание: Функция принимает на вход два Wildcard массива, вычисляет пересечение массивов и возвращает массив элементов, присутствующих во всех переданных в функцию массивах.

Тип наследуется для всех 3-х пинов при установке/снятии связи.

Inputs

Название	Тип	Описание
First	Wildcard: Any array	Принимает любой массив, тип устанавливается на все пины блока, если еще не был установлен.
Second	Wildcard: Any array	Принимает любой массив, тип устанавливается на все пины блока, если еще не был установлен.

Outputs

Название	Тип	Описание
Result	Wildcard: Any array	Возвращает массив элементов первого массива, которых нет во втором массиве.

ArrayFirst

Описание: Функция принимает на вход массив и возвращает первый по счету элемент.

Inputs

Название	Тип	Описание
Array	Wildcard: Any array	Принимает на вход массив. Значение wildcard устанавливается парно на входящий и исходящий пин.

Outputs

Название	Тип	Описание
Result	Wildcard	Возвращает первый по счету элемент. Значение wildcard устанавливается парно на входящий и исходящий пин.

ArrayGetValue

Описание: Функция принимает на вход массив и возвращает элемента массива по указанному индексу.

Inputs

Название	Тип	Описание
Array	Wildcard: Any array	Принимает на вход массив. Значение wildcard устанавливается парно на входящий и исходящий пин.
ElementNumber	Integer	Индекс элемента массива

Outputs

Название	Тип	Описание
Result	Wildcard	Возвращает элемент массива по указанному индексу. Значение wildcard устанавливается парно на входящий и исходящий пин.

ArrayTryGetValue

Описание: Функция принимает на вход массив и возвращает элемента массива по указанному индексу с возможностью обработать исключение, если элемент по указанному индексу не найден.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Array	Wildcard: Any array	Принимает на вход массив. Значение wildcard устанавливается парно на входящий и исходящий пин.
ElementNumber	Integer	Индекс элемента массива

Outputs

Название	Тип	Описание
Ok, Failed		Общие параметры для функций
Result	Wildcard	Найденный элемент массива
IsSuccess	Boolean	Результат исполнения функции в виде логического значения

ArrayLength

Описание: Принимает на вход любой массив и возвращает количество элементов в массиве.

Inputs

Название	Тип	Описание
Value	Wildcard: Any array	Принимает на вход любой массив

Outputs

Название	Тип	Описание
Result	Int	Возвращает количество элементов в массиве

ArraySelect

Описание: Функция принимает на вход массив структур и создает массивы элементов данных структур

Inputs

Название	Тип	Описание
Value	Wildcard:Struct: Any array	Исходная структура

Outputs

Название	Тип	Описание
Названия пинов берутся из исходной структуры	Тип и количество пинов зависят от свойств исходной структуры	Пины создаются автоматически, в зависимости от свойств исходной структуры

ArraySplit

Описание: Функция принимает на вход любой массив и размер массивов для деления. Затем в цикле проходит по исходному массиву и итеративно возвращает новые массивы с указанным кол-вом элементов.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Array	Wildcard: Any array	Исходный массив, который необходимо разбить на подмассивы
Size	Integer	Количество элементов в подмассивах

Outputs

Название	Тип	Описание
Loop	Exec	Пин вызова, который активируется каждую итерацию цикла
SubArray	Wildcard: Any array	Новые массивы с заданным кол-вом элементов, создаваемые итеративно в результате выполнения функции
Completed	Wildcard: Any array	Пин вызова, который активируется по завершению работы цикла

ArrayUnion

Описание: Возвращает массив элементов в объединении данных двух и более массивов, без дубликатов

Inputs

Название	Тип	Описание
a	Wildcard: Any array	Массив
b	Wildcard: Any array	Массив

Outputs

Название	Тип	Описание
Result	Wildcard: Any array	Итоговый объединенный массив

---

Функции итераций

ForEach

Описание: Принимает на вход массив данных, перебирая каждый из них в цикле.

• При каждой итерации отдает элемент массива и его индекс ElementIndex.
• При каждой итерации цикла вызывается последовательность Loop.
• После прерывания цикла вызывается последовательность Completed.

Тип пина обоюдно наследуется между Array и ArrayElement. Массив/сингл закреплен, наследуется именно тип.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Array	Wildcard: Any array	Принимает на вход любой массив для дальнейшей работы с ним. Тип данного пина связан с типом пина Array Element.

Outputs

Название	Тип	Описание
Loop	Exec	Последовательность, вызываемая каждую итерацию
ArrayElement	Wildcard: Any single	Принимает тип данных от входящего массива или от установки связи. Тип данного пина связан с типом пина Array. При выполнении итерации отдает на выход элемент массива.
Element Index	Integer	Индекс элемента для данной итерации
Completed	Exec	Последовательность вызываемая по завершению цикла

ForEachWithBreak

Описание: Принимает на вход массив данных, перебирая каждый из них в цикле. Отличается от ForEach возможностью прервать выполнение в определенный условиями момент.

• При каждой итерации отдает элемент массива и его индекс ElementIndex.
• При каждой итерации цикла вызывается последовательность Loop.
• После прерывания цикла вызывается последовательность Completed.
• Если Condition == True вызывается последовательность Completed.

Тип пина обоюдно наследуется между Array и ArrayElement. Массив/сингл закреплен, наследуется именно тип.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Array	Wildcard: Any array	Принимает на вход любой массив для дальнейшей работы с ним. Тип данного пина связан с типом пина Array Element.
Condition	Boolean	Значение переменной для остановки цикла

Outputs

Название	Тип	Описание
Loop	Exec	Последовательность, вызываемая каждую итерацию
ArrayElement	Wildcard: Any single	Принимает тип данных от входящего массива или от установки связи. Тип данного пина связан с типом пина Array. При выполнении итерации отдает на выход элемент массива.
Element Index	Integer	Индекс элемента для данной итерации
Completed	Exec	Последовательность вызываемая по завершению цикла

DoWhile

Описание: Цикл, гарантированно вызывающий последовательность хотя бы один раз.

• При каждой последующей итерации проверяется значение входящего boolean условия. Если оно истинно - цикл продолжается. Если нет - прекращается.
• После прерывания цикла вызывается последовательность Complete.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Condition	Boolean	Значение, определяющее, зацикливается последовательность или нет.

Outputs

Название	Тип	Описание
Loop	Exec	Вызывает последовательность, пока условие Condition == True.
Completed	Exec	Вызывает последовательность, если условие Condition == False

WhileDo

Описание: Цикл, вызывающий последовательность

• Функция циклично вызывает последовательность до тех пор, пока условие, принимаемое на вход - истинно.
• После прерывания цикла вызывается последовательность Complete.

Отличается от DoWhile тем, что проверяет принимаемое на вход значение ДО первой итерации. И если входящее значение было false - не выполняется ни разу.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Condition	Boolean	Значение, определяющее, зацикливается последовательность или нет.

Outputs

Название	Тип	Описание
Loop	Exec	Вызывает последовательность, пока условие Condition == True.
Completed	Exec	Вызывает последовательность, если условие Condition == False

---

Функции для работы со строками

ConvertToString

Описание: Функция принимает на вход любой тип данных, преобразует и отдает на выходе строку.

Inputs

Название	Тип	Описание
Value	Wildcard: Any single	Принимает на вход любое значение

Outputs

Название	Тип	Описание
Result	String	Приведенное к строке входящее значение

StringConcat

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

• Пользователь может добавить и удалить дополнительные входящие пины через карточку функции
• Слияние строк происходит в порядке расположения пинов сверху вниз

Inputs

Название	Тип	Описание
Value	String	Строка

Outputs

Название	Тип	Описание
Result	String	Результат конкатенации

StringContains

Описание: Функция позволяет определить, встречается ли указанная подстрока внутри заданной строки.

Функция осуществляет проверку, и активирует последовательность Contains, если подстрока найдена, или NotContains если не найдена.

Inputs

Название	Тип	Описание
In		Общие параметры для функций
String	String	Исходная строка
Substring	String	Подстрока

Outputs

Название	Тип	Описание
Contains	Exec	Последовательность активна, если подстрока найдена
NotContains	Exec	Последовательность активна, если подстрока НЕ найдена

Parse

Описание: Преобразует строковое значение в эквивалентное ему значение другого базового типа

Если преобразование невозможно - в качестве результата будет возвращено значение по умолчанию для данного типа.

Inputs

Название	Тип	Описание
Value	String	Строка, подлежащая преобразованию

Outputs

Название	Тип	Описание
Result	Wildcard: Single	Преобразованное значение

TryParse

Описание: Преобразует строковое значение в эквивалентное ему значение другого базового типа

• Возвращает boolean значение, указывающее, успешно ли выполнено преобразование, и активирует последовательность в зависимости от результата парсинга
• Если преобразование невозможно - в качестве результата будет возвращено значение по умолчанию для данного типа

Inputs

Название	Тип	Описание
In		Общие параметры для функций
Value	String	Строка, подлежащая преобразованию

Outputs

Название	Тип	Описание
Ok, Failed		Общие параметры для функций
Result	Wildcard: Single	Преобразованное значение
IsSuccess	Boolean	Возвращает значение, указывающее, успешно ли выполнено преобразование

ToLower

Описание: Преобразует строковое значение в эквивалентное ему значение в нижнем регистре символов

Inputs

Название	Тип	Описание
Source	String	Строка, подлежащая преобразованию

Outputs

Название	Тип	Описание
Result	Source	Преобразованное значение в нижнем регистре символов

ToUpper

Описание: Преобразует строковое значение в эквивалентное ему значение в верхнем регистре символов

Inputs

Название	Тип	Описание
Source	String	Строка, подлежащая преобразованию

Outputs

Название	Тип	Описание
Result	Source	Преобразованное значение в верхнем регистре символов

Trim

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

Inputs

Название	Тип	Описание
Source	String	Строка, подлежащая преобразованию

Outputs

Название	Тип	Описание
Result	Source	Преобразованное значение

RegexReplace

Описание: Заменяет все совпадения регулярного выражения в строке на указанный текст

Inputs

Название	Тип	Описание
Value	String	Строка для поиска соответствия в ней
Pattern	String	Шаблон регулярного выражения (справка по регулярным выражениям .NET (C#))
Replacement	String	Строка, которой будет заменено совпадение
Options	String	Параметры для регулярных выражений. Если требуется несколько, то параметры перечисляются через запятую.

Outputs

Название	Тип	Описание
Result	String	Результат замены значения в строке

RegexEscape

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

Inputs

Название	Тип	Описание
Value	String	Строка для экранирования

Outputs

Название	Тип	Описание
Result	String	Результат экранирования

RegexUnescape

Описание: Используется для отмены экранирования, выполненного функцией RegexEscape. Принимает строку с экранированными специальными символами, восстанавливая их оригинальное значение. Метод возвращает строку, в которой экранированные символы возвращаются к их исходному виду, что удобно при работе с регулярными выражениями.

Inputs

Название	Тип	Описание
Value	String	Строка для отмены экранирования функцией

Outputs

Название	Тип	Описание
Result	String	Результат восстановления

RegexIsMatch

Описание: Функция принимает на вход строку для проверки, шаблон и опции шаблона, чтобы проверить на совпадение строки с шаблоном.

Inputs

Название	Тип	Описание
Value	String	Строка для поиска соответствия в ней
Pattern	String	Шаблон регулярного выражения (справка по регулярным выражениям .NET (C#))
Options	String	Параметры для регулярных выражений. Если требуется несколько, то перечисляются через запятую.

Outputs

Название	Тип	Описание
Result	Boolean	Значение true, если регулярное выражение обнаруживает хотя бы одно соответствие. В противном случае - значение false.

RegexMatch

Описание: Ищет первое вхождение регулярного выражения в указанной строке и возвращает структуру, содержащую информацию о найденном совпадении

Inputs

Название	Тип	Описание
Value	String	Строка для поиска соответствия в ней
Pattern	String	Шаблон регулярного выражения (справка по регулярным выражениям .NET (C#))
Options	String	Параметры для регулярных выражений. Если требуется несколько, то перечисляются через запятую.

Outputs

Название	Тип	Описание
Match	Struct:RegexMatch	Результат поиска

Struct - RegexMatch

Описание структуры Struct:RegexMatch:

Параметры	Тип	Описание
Name	String	Имя группы совпадения в регулярном выражении. Оно используется в случае, если в регулярном выражении используются именованные группы для определения совпадений
Groups	Struct (array)	Коллекция объектов, представляющих группы совпадений в регулярном выражении, включая всё совпадение в целом и каждую отдельную группу.
		Структура Groups
		- Дублирует структуру RegexMatch за исключением параметра Groups
		- Все пины в ней являются массивом
		- Все параметры относятся к каждой конкретной группе
Captures	Struct (array)	Коллекция объектов, представляющая все захваченные под-совпадения внутри найденного совпадения.
		Параметры
		- Index (Integer): Функционал поименно совпадает с описанным в родительской структуре, но все параметры относятся к под-совпадениям
		- Length (Integer)
		- Value (String)
Success	Boolean	Поле, показывающее, было ли найдено хотя бы одно совпадение с регулярным выражением в строке.
Value	String	Найденное совпадение с регулярным выражением
Index	Integer	Индекс первого символа совпадения в исходной строке
Length	Integer	Длинна найденного совпадения в символах

RegexMatches

Описание: Дублирует функционал RegexMatch, но возвращает все совпадения регулярного выражения в указанной строке и возвращает коллекцию из объектов.

RegexSplit

Описание: Разбивает входную строку на подстроки, используя регулярное выражение как разделитель.

Inputs

Название	Тип	Описание
Value	String	Строка для поиска соответствия в ней
Pattern	String	Шаблон регулярного выражения (справка по регулярным выражениям .NET (C#))
Options	String	Параметры для регулярных выражений. Если требуется несколько, то перечисляются через запятую.

Outputs

Название	Тип	Описание
Result	String (array)	Результат разбиения строки

Список опций функций Regex

Параметр	Описание
Compiled	Оптимизирует регулярное выражение для повышения производительности. При использовании этой опции регулярное выражение будет скомпилировано во время создания экземпляра Regex.
CultureInvariant	Указывает игнорирование региональных языковых различий (инвариантного языка и региональных параметров).
ECMAScript	Включает синтаксис ECMAScript. Данный синтаксис более строгий и соответствует стандарту ECMAScript.
ExplicitCapture	По умолчанию каждая скобочная группа в регулярном выражении создает захватывающую группу в результате. Эта опция позволяет создавать только захватывающие группы, обозначенные знаком вопроса ?.
IgnoreCase	Игнорировать регистр символов при сопоставлении.
IgnorePatternWhitespace	Игнорировать пробелы и знаки табуляции в регулярном выражении, позволяя форматировать его более удобным образом.
Multiline	Мультилайновый режим, в котором символы начала и конца строки ^ и $ соответствуют началу и концу каждой строки, а не всего ввода.
NonBacktracking	Включает сопоставление с использованием подхода, который избегает возврата к предыдущим шагам и гарантирует линейную обработку относительно длины ввода. Некоторые возможности недоступны при установке этой опции, включая балансирующие группы, обратные ссылки, положительные и отрицательные опережающие и ретроспективные проверки, атомарные группы. Группы захвата также игнорируются, таким образом, доступен только захват для верхне-уровневого сопоставления.
RightToLeft	Использовать поиск справа налево, а не слева направо.
SingleLine	Однострочный режим, в котором символ новой строки игнорируется и точка . соответствует любому символу, включая символ новой строки.

---

Функции генерации данных

NewGuid

Описание: Функция генерации уникального GUID

Outputs

Название	Тип	Описание
Guid	Guid	При выполнении генерируется уникальный идентификатор типа GUID

---