IA-Connect динамический код (предварительная версия)

IA-Connect — это платформа автоматизации роботизированных процессов RPA, которая добавляет функции RPA из облака в локальные виртуальные машины или через подключения Citrix или Microsoft Remote Desktop RDS. Это модуль для разработки модулей динамического кода.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	Ultima Labs
URL	https://www.ultima.com/ultima-labs
Адрес электронной почты	IAConnect@ultima.com

Метаданные соединителя
Publisher	Ultima Business
Website	https://www.ultima.com/ultima-labs
Политика конфиденциальности	https://www.ultima.com/privacy-policy
Категории	ИТ-операции; Продуктивность

IA-Connect — это платформа автоматизации роботизированных процессов (RPA), которая добавляет функции RPA из Облачных потоков Power Automate в локальные виртуальные машины или через подключения Citrix или Microsoft Remote Desktop (RDS). Соединители IA-Connect предоставляют более 800 действий, что позволяет автоматизировать каждый тип локального приложения непосредственно из Power Automate Cloud Flow. Все действия IA-Connect доступны непосредственно из Power Automate Cloud Flow, обеспечивая простую интеграцию между облачными и локальными приложениями, возможность использовать существующие условия Power Automate, циклы, динамическое содержимое, выражения и обработку исключений в процессах RPA. Использование соединителей IA-Connect также обеспечивает полную историю выполнения и возможность аудита из журнала выполнения потока, а также удаление необходимости в отдельном приложении, консоли или студии для разработки процессов RPA.

Предпосылки

Чтобы использовать любой из соединителей IA-Connect, необходимо установить программное обеспечение IA-Connect. Это бесплатно для тестирования в течение 30 дней, после чего вам потребуется лицензия IA-Connect.

Программное обеспечение IA-Connect состоит из двух основных компонентов:

• IA-Connect Orchestrator, который является Azure WebApp, который будет размещаться в собственном клиенте Azure. Это обрабатывает маршрутизацию и безопасность потоков RPA на одну или несколько локальных или облачных виртуальных машин.

• Агент IA-Connect и директор, установленный на виртуальных машинах, где программное обеспечение, которое требуется автоматизировать, доступно. Кроме того, агент IA-Connect может выполняться в сеансе Citrix или Microsoft Remote Desktop Services (RDS), где команды RPA передаются по виртуальному каналу в удаленный сеанс для выполнения. Агент IA-Connect можно запустить из общей сетевой папки и не требует установки.

Доступные соединители IA-Connect

Доступные соединители IA-Connect:

• динамический код IA-Connect
• IA-Connect Java
• JML IA-Connect
• IA-Connect Мейнфрейм
• IA-Connect Microsoft Office
• IA-Connect SAP GUI
• сеанс IA-Connect
• Пользовательский интерфейс IA-Connect
• веб-браузер IA-Connect

Получение учетных данных

Чтобы получить лицензию и начать 30-дневную бесплатную пробную версию, отправьте запрос на наш веб-сайт (https://www.ultima.com/IA-Connect/Power-Automate).

После получения пробного запроса мы свяжемся с вами по адресу электронной почты, предоставленному для настройки IA-Connect программного обеспечения и предоставления пробной лицензии. Это полностью многофункциональная пробная версия и позволит протестировать любые из 800 действий во всех 9 IA-Connect соединителях в пределах собственной среды в течение пробного периода.

Начало работы с соединителем

После отправки пробного запроса на IA-Connect вы сможете скачать ZIP-файл, содержащий IA-Connect программное обеспечение и документацию по установке и настройке. Мы также обратитесь к вам, чтобы предложить поддержку и рекомендации по процессу установки по мере необходимости.

Support

В течение пробного периода вы можете обратиться в Ultima Labs (IAConnect@ultima.com) за поддержкой и помощью.

При покупке IA-Connect лицензии вы получите маркеры поддержки, которые можно активировать для обучения или поддержки в Центре технической службы на основе Великобритании (TSC).

Известные проблемы, распространенные ошибки и часто задаваемые вопросы

Наша база знаний содержит ряд статей, охватывающих все известные проблемы, распространенные ошибки, которые могут возникать при использовании соединителей IA-Connect и часто задаваемых вопросов. Это доступно https://support.ultima.com/ultimalabs и учетная запись для доступа к этим ресурсам предоставляется во время IA-Connect пробной версии и при приобретении лицензии IA-Connect.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

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

Имя	Тип	Description	Обязательно
Ключ API	securestring	Ключ API для этого API	True
адрес оркестратора IA-Connect	струна	Укажите адрес оркестратора IA-Connect без компонента HTTP(S)	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Вставка строки в массив строк	Принимает входной массив строковых элементов, вставляет строку в указанное положение и возвращает новый массив. Если вы хотите вставить строку в таблицу, используйте действие "Вставка строки в таблицу". Если вы хотите вставить строку в таблицу в формате JSON, используйте действие "Вставка строки в таблицу JSON".
Вставка строки в таблицу	Принимает входную таблицу, вставляет строку по заданной позиции и возвращает новую таблицу. Если вы хотите вставить строку в массив строк, используйте действие "Вставка строки в массив строк". Если вы хотите вставить строку в таблицу в формате JSON, используйте действие "Вставка строки в таблицу JSON".
Вставка строки в таблицу JSON	Принимает входную таблицу в формате JSON, вставляет строку в указанное положение и возвращает новую таблицу в формате JSON. Если вы хотите вставить строку в фактическую таблицу (т. е. не в формате JSON), используйте действие "Вставка строки в таблицу". Если вы хотите вставить строку в массив строк, используйте действие "Вставка строки в массив строк".
Вставка строки входных переменных в таблицу JSON	Принимает входную таблицу в формате JSON, вставляет строку, созданную из входных переменных в указанной позиции, и возвращает новую таблицу в формате JSON. Схема входной строки должна соответствовать входной таблице (т. е. использовать те же имена свойств и типы данных). Если вы хотите вставить строку в фактическую таблицу (т. е. не в формате JSON), используйте действие "Вставка строки в таблицу". Если вы хотите вставить строку в массив строк, используйте действие "Вставка строки в массив строк".
Добавление папки поиска сборок	Добавляет путь к папке (на компьютере, на котором запущен агент IA-Connect) в список папок для агента IA-Connect для проверки при попытке загрузить внешнюю ссылку.
Загрузка таблицы подстановки IA-Connect	Загружает таблицу подстановки IA-Connect с компьютера, на котором запущен агент IA-Connect. Эти таблицы подстановки можно использовать с помощью дополнительных IA-Connect действий для выполнения поиска данных.
Запуск скрипта PowerShell	Запускает скрипт PowerShell в сеансе, где выполняется агент IA-Connect, где содержимое скрипта передается агенту IA-Connect в входных данных "Содержимое скрипта PowerShell" (PowerShellScriptContents). Это рекомендуемое действие для запуска собственного пользовательского кода PowerShell. Это действие также можно использовать для получения результатов из предыдущего выполнения скрипта PowerShell, запускаемого в качестве потока агента. Агент выполняет PowerShell с помощью Microsoft PowerShell версии 3.x до версии 5.x (независимо от установленной версии), а не Ядра PowerShell (6.x далее).
Значение подстановки из таблицы подстановки IA-Connect	Извлекает значение из таблицы подстановки Orchestrator (для автоматизации с помощью Orchestrator) или таблицы подстановки, загруженной в агент IA-Connect, из первой строки, соответствующей входным данным. Если в Оркестраторе есть таблица подстановки с тем же именем, что и одна загруженная в агент IA-Connect, используется таблица подстановки Orchestrator (если автоматизация проходит через Orchestrator).
Импорт сборки из локального файла	Отправляет сборку DotNet с компьютера, на котором выполняется директор IA-Connect, в агент IA-Connect, где он загружается в память, и будет использоваться при ссылке на динамический код DotNet.
Массив строк фильтра	Принимает входной массив строковых элементов, фильтрует массив (с помощью синтаксиса строк .NET DataView) и возвращает новый массив. Если вы хотите отфильтровать таблицу, используйте действие "Фильтровать таблицу". Чтобы отфильтровать таблицу в формате JSON, используйте действие "Фильтр таблицы JSON".
Отправка CSV-файла в список оркестратора IA-Connect	Передайте данные CSV-файла в список оркестратора IA-Connect, заменив существующее содержимое.
Отправка CSV-файла в таблицу подстановки Оркестратора IA-Connect	Отправка замены CSV-данных в таблицу подстановки оркестратора IA-Connect, заменив существующее содержимое. Это действие не будет взаимодействовать с таблицей подстановки, обрабатываемой агентом IA-Connect (CSV-файл, удерживаемый на диске).
Очистка папок поиска сборок	Сбросите дополнительный список папок для агента IA-Connect для проверки при попытке загрузить внешнюю ссылку.
Переименование столбца в таблице	Принимает входную таблицу, переименовывает указанный столбец и возвращает новую таблицу. Если вы хотите переименовать столбец из таблицы в формате JSON, используйте действие "Переименовать столбец в таблице JSON".
Переименование столбца в таблице JSON	Принимает входную таблицу в формате JSON, переименовывает указанный столбец и возвращает новую таблицу в формате JSON. Если вы хотите переименовать столбец из фактической таблицы (т. е. не в формате JSON), используйте действие "Переименовать столбец в таблице".
Получение версии PowerShell	Возвращает версию PowerShell в сеансе, где запущен агент IA-Connect. Это обнаруживает Microsoft PowerShell версии 3.x до версии 5.x, а не ядро PowerShell (6.x далее).
Получение массива строк из столбца таблицы	Принимает входную таблицу и возвращает указанный столбец в виде строкового массива. Если вы хотите получить массив строк из таблицы в формате JSON, используйте действие "Получить массив из таблицы JSON".
Получение массива строк из столбца таблицы JSON	Принимает входную таблицу в формате JSON и возвращает указанный столбец в виде строкового массива. Если вы хотите получить массив строк из фактической таблицы (т. е. не в формате JSON), используйте действие "Получить массив из таблицы".
Получение сводки по таблице подстановки IA-Connect	Извлекает сводку таблиц подстановки, загруженных в агент IA-Connect.
Получение совпадений группы регулярных выражений	Выполняет совпадение регулярного выражения (regex) во входной строке и возвращает список сопоставленных имен и значений групп.
Получение совпадений регулярного выражения	Выполняет совпадение регулярного выражения (regex) во входной строке и возвращает все совпадения в массиве строк. Массив будет пустым, если совпадений не было.
Получение содержимого списка IA-Connect	Извлекает все данные из списка оркестратора IA-Connect.
Получение содержимого таблицы IA-Connect Orchestrator	Извлекает все данные из таблицы подстановки оркестратора IA-Connect, удерживаемой на оркестраторе. Это не будет извлекать таблицу подстановки, обработанную агентом IA-Connect (CSV-файл, удерживаемый на диске).
Получение сопоставления регулярных выражений	Выполняет совпадение регулярного выражения (regex) во входной строке и возвращает, соответствует ли строка выражению и сведениям о совпадении.
Получение столбца из списка IA-Connect	Извлекает столбец из списка оркестратора IA-Connect.
Получение строки из ячейки таблицы JSON	Принимает входную таблицу в формате JSON и возвращает указанную ячейку в виде строки.
Получение строки между	Принимает входную строку и возвращает первый экземпляр строки, расположенной между двумя указанными строками или между строкой и концом строки.
Получение таблицы JSON из массива строк	Принимает входной массив строковых элементов и возвращается в виде таблицы JSON.
Получение таблицы из JSON	Принимает входную таблицу в формате JSON и возвращается в качестве таблицы. Это называется десериализацией.
Получение таблицы из массива строк	Принимает входной массив строковых элементов и возвращается в виде таблицы.
Преобразование массива в JSON	Принимает входной массив и сериализуется в строку JSON.
Разделение строки с помощью регулярного выражения	Разбивает входную строку с помощью сопоставления регулярных выражений (regex) и возвращает отдельные компоненты разбиения строки в виде массива строк.
Создание JSON из входных переменных	Принимает массив входных переменных и возвращается в формате JSON и при необходимости в виде таблицы JSON.
Сортировка массива строк	Принимает входной массив строковых элементов, сортирует массив и возвращает новый массив. Если вы хотите сортировать таблицу, используйте действие "Сортировка таблицы". Если вы хотите сортировать таблицу в формате JSON, используйте действие "Сортировка таблицы JSON".
Сортировка таблицы	Принимает входную таблицу, сортирует одну или несколько строк и возвращает новую таблицу. Если вы хотите сортировать таблицу в формате JSON, используйте действие "Сортировка таблицы JSON". Если вы хотите сортировать массив строк, используйте действие "Сортировка строкового массива".
Сортировка таблицы JSON	Принимает входную таблицу JSON, сортирует таблицу и возвращает новую таблицу JSON. Если вы хотите сортировать фактическую таблицу (т. е. не в формате JSON), используйте действие "Сортировка таблицы". Если вы хотите сортировать массив строк, используйте действие "Сортировка строкового массива".
Столбцы подстановки из таблицы подстановки IA-Connect	Извлекает один или несколько идентичных именованных столбцов из таблицы подстановки Orchestrator (для автоматизации с помощью Orchestrator) или таблицы подстановки, загруженной в агент IA-Connect, из первой строки, соответствующей входным данным, и возвращается в виде таблицы. Например, таблица подстановки может содержать несколько выходных столбцов с именем AD group для представления нескольких групп AD, и они будут возвращены в виде отдельных строк в выходной таблице. Если в Оркестраторе есть таблица подстановки с тем же именем, что и одна загруженная в агент IA-Connect, используется таблица подстановки Orchestrator (если автоматизация проходит через Orchestrator).
Таблица фильтров	Принимает входную таблицу, фильтрует таблицу (с помощью синтаксиса строк .NET DataView) и возвращает новую таблицу. Чтобы отфильтровать таблицу в формате JSON, используйте действие "Фильтр таблицы JSON". Если вы хотите отфильтровать массив строк, используйте действие "Фильтровать строковый массив".
Удаление всех таблиц подстановки IA-Connect	Удаляет все таблицы подстановки, загруженные в агент IA-Connect.
Удаление символов из строки	Принимает входную строку и возвращает ее с указанными символами, удаленными. Если указанные символы не расположены, будет возвращена исходная строка.
Удаление столбцов из таблицы	Принимает входную таблицу, удаляет столбец или столбцы и возвращает новую таблицу. Если вы хотите удалить столбцы из таблицы в формате JSON, используйте действие "Удалить столбцы из таблицы JSON".
Удаление столбцов из таблицы JSON	Принимает входную таблицу в формате JSON, удаляет столбец или столбцы и возвращает новую таблицу в формате JSON. Если вы хотите удалить столбцы из фактической таблицы (т. е. не в формате JSON), используйте действие "Удалить столбцы из таблицы".
Удаление строк из таблицы	Принимает входную таблицу, удаляет строку или строки в указанной позиции и возвращает новую таблицу. Если вы хотите удалить строку или строки из массива строк, используйте действие "Удалить строку из массива строк". Если вы хотите удалить строку или строки из таблицы в формате JSON, используйте действие "Удалить строку из таблицы JSON".
Удаление строк из таблицы JSON	Принимает входную таблицу в формате JSON, удаляет строку или строки в указанной позиции и возвращает новую таблицу в формате JSON. Если вы хотите удалить строку или строки из фактической таблицы (т. е. не в формате JSON), используйте действие "Удалить строку из таблицы". Если вы хотите удалить строку или строки из массива строк, используйте действие "Удалить строку из массива строк".
Удаление таблицы подстановки IA-Connect	Удаляет таблицу подстановки, загруженную в агент IA-Connect.
Удаление элементов из массива строк	Принимает входной массив строковых элементов, удаляет элемент или элементы в указанной позиции и возвращает новый массив. Если вы хотите удалить строку или строки из таблицы, используйте действие "Удалить строку из таблицы". Если вы хотите удалить строку или строки из таблицы в формате JSON, используйте действие "Удалить строку из таблицы JSON".
Установлен модуль PowerShell	Выполняет поиск указанного модуля PowerShell на компьютере, где выполняется агент IA-Connect, и возвращает, установлен ли он.
Установлена служба автоматизации PowerShell	Сообщает, доступна ли автоматизация PowerShell на компьютере, на котором запущен агент IA-Connect. Если автоматизация PowerShell недоступна, действия службы автоматизации PowerShell не будут работать.
Фильтрация таблицы JSON	Принимает входную таблицу JSON, фильтрует таблицу (используя синтаксис строк .NET DataView) и возвращает новую таблицу JSON. Если вы хотите отфильтровать фактическую таблицу (т. е. не в формате JSON), используйте действие "Фильтровать таблицу". Если вы хотите отфильтровать массив строк, используйте действие "Фильтровать строковый массив".
Ячейки данных подстановки из таблицы подстановки IA-Connect	Извлекает все ячейки данных из таблицы подстановки Orchestrator (для автоматизации с помощью Orchestrator), из первой строки, соответствующей входным данным, и возвращается в виде таблицы. Это действие не поддерживает таблицы подстановки, загруженные в агент IA-Connect.

Вставка строки в массив строк

Идентификатор операции:

InsertRowInStringArray

Принимает входной массив строковых элементов, вставляет строку в указанное положение и возвращает новый массив. Если вы хотите вставить строку в таблицу, используйте действие "Вставка строки в таблицу". Если вы хотите вставить строку в таблицу в формате JSON, используйте действие "Вставка строки в таблицу JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной массив	InputArray	True	array of string	Входной массив строк.
Индекс строки	RowIndex	True	integer	Индекс строки для вставки. Используйте 0, чтобы вставить в начале массива 1, чтобы вставить после строки 1, N, чтобы вставить после строки N. -1 или любое число, равное или более высокому числу элементов в массиве, чтобы вставить в конце массива (полезно, если вы не знаете, сколько времени массива).
Значение для вставки	ValueToInsert		string	Строковое значение для вставки в новую строку. Оставьте пустым, если вы хотите вставить пустую строку.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходной массив	OutputArray	array of string	Выходной массив строк.
Количество предметов	NumberOfItems	integer	Количество элементов в выходном массиве.

Вставка строки в таблицу

Идентификатор операции:

InsertRowInTable

Принимает входную таблицу, вставляет строку по заданной позиции и возвращает новую таблицу. Если вы хотите вставить строку в массив строк, используйте действие "Вставка строки в массив строк". Если вы хотите вставить строку в таблицу в формате JSON, используйте действие "Вставка строки в таблицу JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Индекс строки	RowIndex	True	integer	Индекс строки для вставки. Используйте 0, чтобы вставить в начале таблицы 1, чтобы вставить после строки 1, N, чтобы вставить после строки N. -1 или любое число, равное или более высокому числу элементов в таблице, чтобы вставить в конце таблицы (полезно, если вы не знаете, как долго таблица).
Строка JSON для вставки	RowToInsertJSON		string	Содержимое строки для вставки в формате JSON. Оставьте пустым, если вы хотите вставить пустую строку. Например, чтобы вставить "Simon" в столбец "Имя" используйте {"Name":"Simon"} и вставьте "Англия" в столбец "Страна" используйте {"Name":"Simon","Country":"England"}.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Вставка строки в таблицу JSON

Идентификатор операции:

InsertRowInJSONTable

Принимает входную таблицу в формате JSON, вставляет строку в указанное положение и возвращает новую таблицу в формате JSON. Если вы хотите вставить строку в фактическую таблицу (т. е. не в формате JSON), используйте действие "Вставка строки в таблицу". Если вы хотите вставить строку в массив строк, используйте действие "Вставка строки в массив строк".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Индекс строки	RowIndex	True	integer	Индекс строки для вставки. Используйте 0, чтобы вставить в начале таблицы 1, чтобы вставить после строки 1, N, чтобы вставить после строки N. -1 или любое число, равное или более высокому числу элементов в таблице, чтобы вставить в конце таблицы (полезно, если вы не знаете, как долго таблица).
Строка JSON для вставки	RowToInsertJSON		string	Содержимое строки для вставки в формате JSON. Оставьте пустым, если вы хотите вставить пустую строку. Например, чтобы вставить "Simon" в столбец "Имя" используйте {"Name":"Simon"} и вставьте "Англия" в столбец "Страна" используйте {"Name":"Simon","Country":"England"}.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Вставка строки входных переменных в таблицу JSON

Идентификатор операции:

InsertRowInJSONTableFromInputVariables

Принимает входную таблицу в формате JSON, вставляет строку, созданную из входных переменных в указанной позиции, и возвращает новую таблицу в формате JSON. Схема входной строки должна соответствовать входной таблице (т. е. использовать те же имена свойств и типы данных). Если вы хотите вставить строку в фактическую таблицу (т. е. не в формате JSON), используйте действие "Вставка строки в таблицу". Если вы хотите вставить строку в массив строк, используйте действие "Вставка строки в массив строк".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Индекс строки	RowIndex	True	integer	Индекс строки для вставки. Используйте 0, чтобы вставить в начале таблицы 1, чтобы вставить после строки 1, N, чтобы вставить после строки N. -1 или любое число, равное или более высокому числу элементов в таблице, чтобы вставить в конце таблицы (полезно, если вы не знаете, как долго таблица).
Название свойства	PropertyName		string
Тип данных свойства	DataType		string
Значение свойства	Value		string

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Добавление папки поиска сборок

Идентификатор операции:

AddAssemblySearchFolder

Добавляет путь к папке (на компьютере, на котором запущен агент IA-Connect) в список папок для агента IA-Connect для проверки при попытке загрузить внешнюю ссылку.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к папке	FolderPath	True	string	Путь к папке, добавляемой в список папок для агента IA-Connect для проверки при попытке загрузить внешнюю ссылку.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Загрузка таблицы подстановки IA-Connect

Идентификатор операции:

LoadIAConnectLookupTable

Загружает таблицу подстановки IA-Connect с компьютера, на котором запущен агент IA-Connect. Эти таблицы подстановки можно использовать с помощью дополнительных IA-Connect действий для выполнения поиска данных.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь таблицы подстановки	Path	True	string	Полный путь к таблице подстановки. Это должно быть доступно из сеанса, в котором запущен агент IA-Connect. Если указана папка, все файлы под этой папкой обрабатываются.
Вызов исключения, если любая таблица не загружается	RaiseExceptionIfAnyTableFailsToLoad	True	boolean	Если задано значение true и любая IA-Connect таблица подстановки не загружается (например, если в таблице возникла проблема), то будет вызвано исключение. Это значение по умолчанию, так как если любая таблица не загружается, обычно это приведет к исключению позже в процессе. Если задано значение false, то таблицы подстановки проблемы будут игнорироваться, и будут загружены только используемые таблицы подстановки.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Количество загруженных таблиц подстановки	NumberOfLookupTablesLoaded	integer	Количество таблиц подстановки, которые были успешно загружены.
Количество таблиц подстановки не удалось загрузить	NumberOfLookupTablesFailedToLoad	integer	Количество таблиц подстановки, которые не удалось загрузить. Это значение будет задано только в том случае, если для любой таблицы не удается загрузить значение false, так как в противном случае будет исключение.

Запуск скрипта PowerShell

Идентификатор операции:

RunPowerShellAutomationScript

Запускает скрипт PowerShell в сеансе, где выполняется агент IA-Connect, где содержимое скрипта передается агенту IA-Connect в входных данных "Содержимое скрипта PowerShell" (PowerShellScriptContents). Это рекомендуемое действие для запуска собственного пользовательского кода PowerShell. Это действие также можно использовать для получения результатов из предыдущего выполнения скрипта PowerShell, запускаемого в качестве потока агента. Агент выполняет PowerShell с помощью Microsoft PowerShell версии 3.x до версии 5.x (независимо от установленной версии), а не Ядра PowerShell (6.x далее).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Содержимое скрипта PowerShell	PowerShellScriptContents		string	Содержимое выполняемого скрипта PowerShell. IA-Connect будет выполнять этот скрипт as-is путем передачи непосредственно в подсистему автоматизации PowerShell. Скрипт PowerShell фактически не создается на диске. Кроме того, можно запустить существующий сценарий PowerShell на диске, введя следующий код: return и scriptpath. Например: return &c:\scripts\TestScript.ps1'.
Имя компьютера	ComputerName		string	Имя компьютера для запуска скрипта PowerShell. Если осталось пустым, скрипт будет выполняться на компьютере, на котором запущен агент IA-Connect.
Не приводит к ошибке	IsNoResultAnError		boolean	Если данные не возвращаются командой PowerShell, это означает ошибку?
Возвращать сложные типы	ReturnComplexTypes		boolean	Если возвращаемые данные PowerShell содержат сложные свойства (например, коллекции значений, массивов, таблиц или классов), эти свойства по умолчанию не возвращаются в ответе PowerShell IA-Connect. Входные данные "Свойства, возвращаемые в качестве коллекции", "Имена свойств для сериализации" и "Типы свойств для сериализации", позволяют указать, какие сложные свойства должны быть возвращены, и метод, используемый для форматирования данных (на основе свойств, выберите наиболее подходящий вариант). Этот вход позволяет указать, что следует сделать с любыми остальными свойствами (т. е. свойствами, которые являются сложными и не имеют явного имени). Если задано значение true, IA-Connect попытается вернуть строковое представление данных с помощью ToString(). Если задано значение false (по умолчанию), IA-Connect не вернет это свойство.
Возвращать логическое значение как логическое значение	ReturnBooleanAsBoolean		boolean	Следует ли возвращать логические свойства как логические? Если значение false, они возвращаются в виде строк.
Возвращать числовое значение как десятичное	ReturnNumericAsDecimal		boolean	Следует ли возвращать числовые свойства как числовые? Если значение false, они возвращаются в виде строк.
Дата возврата в качестве даты	ReturnDateAsDate		boolean	Следует ли возвращать свойства Date как даты? Если значение false, они возвращаются в виде строк.
Свойства, возвращаемые как коллекция	PropertiesToReturnAsCollectionJSON		string	Если возвращаемые данные PowerShell содержат сложные свойства (например, коллекции значений, массивов, таблиц или классов), эти свойства по умолчанию не возвращаются в ответе PowerShell IA-Connect. Этот параметр позволяет указать, какие свойства сложного (по имени) IA-Connect должны пытаться вернуться в виде коллекции. В зависимости от свойства, его типа и значений следует также рассмотреть возможность использования альтернативных входных данных "Имена свойств для сериализации" и "типы свойств для сериализации" (выберите один). Эти входные данные можно ввести в формате JSON или CSV. Например, чтобы вернуть свойства массива EmailAddresses и MemberOf, введите [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (формат таблицы JSON), ["EmailAddresses", "MemberOf"] (формат массива JSON) или EmailAddresses,MemberOf (формат CSV).
Механизм аутентификации	AuthenticationMechanism		string	Механизм проверки подлинности, используемый при подключении к удаленному компьютеру или выполнении скрипта в качестве альтернативного пользователя. Поддерживаемые значения: "Basic", "Credssp", "Default", "Digest", "Kerberos" и "Согласование".
Попытки подключения	ConnectionAttempts		integer	Количество подключений для попытки подключения к удаленному компьютеру.
Имя пользователя	Username		string	Имя пользователя, используемое при запуске скрипта в качестве альтернативного пользователя.
Пароль	Password		password	Пароль, используемый при выполнении скрипта в качестве альтернативного пользователя.
Запуск скрипта в виде потока	RunScriptAsThread		boolean	Если задано значение false (по умолчанию), агент IA-Connect запустит скрипт PowerShell немедленно и возвращает результаты директору после завершения скрипта. Если выполняется длительный или сложный скрипт PowerShell, это действие может истекать. Если задано значение true, агент IA-Connect будет запускать скрипт PowerShell в качестве потока агента, а директор IA-Connect (или оркестратор, модуль PowerShell, Blue Prism) может отслеживать состояние этого потока агента, ожидая завершения. Это позволяет выполнять длительные или сложные скрипты PowerShell без времени ожидания. IA-Connect агенты 9.3 и более ранних версий не могут запускать скрипты PowerShell в качестве потока агента.
Получение выходных данных для идентификатора потока	RetrieveOutputDataFromThreadId		integer	Если вы ранее выполнили скрипт PowerShell в качестве потока агента и задайте значение "Секунды ожидания потока" значение 0, укажите идентификатор потока агента для получения результатов. Этот идентификатор потока агента будет предоставлен предыдущим вызовом этого действия. Установите значение 0 (по умолчанию), если вы просто выполняете скрипт PowerShell (и поэтому не извлекаете результаты предыдущего скрипта PowerShell в качестве потока агента).
Секунды ожидания потока	SecondsToWaitForThread		integer	Если для параметра "Выполнить скрипт от имени потока" задано значение true, сколько секунд ожидает завершения потока агента. Если поток агента, выполняющий скрипт PowerShell, не завершен в это время, будет вызвано исключение. Установите значение 0, чтобы обойти ожидание: агент будет продолжать запускать скрипт PowerShell, но также доступен для следующего действия. Затем вы можете получить результаты скрипта позже с помощью действия "Ожидание успешного завершения потока агента", чтобы дождаться завершения потока агента, а затем повторно запустить это действие "Выполнить скрипт PowerShell" с входным значением "Получение выходных данных для идентификатора потока" в качестве идентификатора потока агента.
Скрипт содержит сохраненный пароль	ScriptContainsStoredPassword		boolean	Установите значение true, если скрипт содержит IA-Connect хранимый идентификатор пароля в формате {IAConnectPassword:StoredPasswordIdentifier} или универсальные учетные данные оркестратора IA-Connect в формате {OrchestratorCredential:FriendlyName}. Фраза { } будет заменена указанным паролем, экранирована и помещена в одинарные кавычки (если она еще не находится в кавычках в скрипте).
Подробные выходные данные журнала	LogVerboseOutput		boolean	Задайте значение true, чтобы регистрировать все подробные выходные данные PowerShell в журналы IA-Connect. Это может быть полезно для отладки. Чтобы подробно выполнить журнал в скрипте, используйте следующую команду PowerShell: Write-Verbose "Мое сообщение" -Verbose.
Возврат безопасных строк	ReturnSecureStrings		boolean	Задайте значение true, чтобы вернуть все свойства безопасной строки в выходных данных скрипта PowerShell. Установите значение false (по умолчанию), чтобы не возвращать какие-либо свойства, которые хранятся в виде безопасной строки. Если вы знаете, что делаете, задано значение true, так как это может привести к передаче паролей (если в выходных данных скрипта PowerShell есть пароли).
Имена свойств для сериализации	PropertyNamesToSerializeJSON		string	Если возвращаемые данные PowerShell содержат сложные свойства (например, коллекции значений, массивов, таблиц или классов), эти свойства по умолчанию не возвращаются в ответе PowerShell IA-Connect. Этот параметр позволяет указать, какие свойства сложного (по имени) IA-Connect должны сериализоваться в формате JSON, поэтому они возвращаются как строковый тип (который можно десериализировать после получения). В зависимости от свойства, его типа и значений следует также рассмотреть возможность использования альтернативных входных данных "Свойства для возврата в виде коллекции" и "типы свойств для сериализации" (выберите один). Например, чтобы сериализовать свойства EmailAddresses и MemberOf, введите [{"PropertyName": EmailAddresses"}, {"PropertyName": "MemberOf"}] (формат таблицы JSON), ["EmailAddresses", "MemberOf"] (формат массива JSON) или EmailAddresses,MemberOf (формат CSV).
Типы свойств для сериализации	PropertyTypesToSerializeJSON		string	Если возвращаемые данные PowerShell содержат сложные свойства (например, коллекции значений, массивов, таблиц или классов), эти свойства по умолчанию не возвращаются в ответе PowerShell IA-Connect. Этот параметр позволяет указать, какие свойства сложного типа (по типу IA-Connect) должны сериализоваться в формате JSON, поэтому они возвращаются как строковый тип (который можно десериализировать после получения). В зависимости от свойства, его типа и значений следует также рассмотреть возможность использования альтернативных входных данных "Свойства для возврата в виде коллекции" и "Имена свойств для сериализации" (выберите один). Это коллекция с одним полем PropertyType. Например: сериализация любого свойства типа Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], введите [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (формат таблицы JSON), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (формат массива JSON) или "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (формат CSV).
Имя	Name		string	Имя входного параметра PowerShell. Это должно соответствовать форматам именования переменных PowerShell (т. е. рекомендуется избегать пробелов или специальных символов). Имена переменных PowerShell не учитывает регистр. Например: MyVariable приведет к созданию переменной $MyVariable.
Строковое значение	StringValue		string	Строковое значение для назначения входного параметра PowerShell. Кроме того, при вводе логического или числового значения можно использовать другие входные данные.
Целочисленное значение	IntValue		integer	Целое значение (целое число), которое необходимо назначить входной параметру PowerShell. Кроме того, при вводе строки, логического или числового значения можно использовать другие входные данные.
Логическое значение	BooleanValue		boolean	Логическое значение (true или false), назначаемое входным параметру PowerShell. Кроме того, можно использовать другие входные данные значений, если вы вводите строку или числовое значение.
Десятичное значение	DecimalValue		double	Десятичное значение, которое необходимо назначить входной параметру PowerShell. Кроме того, при вводе строки, логического или целочисленного значения можно использовать другие входные данные.
Значение объекта	ObjectValue		object	Значение объекта, назначаемое входным параметру PowerShell. Это станет сериализованной строковой переменной JSON в скрипте PowerShell, поэтому десериализация в объект с помощью ConvertFrom-Json. Кроме того, при вводе строки, логического или числового значения можно использовать другие входные данные.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходные данные PowerShell JSON	PowerShellJSONOutput	string	Выходные данные скрипта PowerShell, отформатированного в формате JSON.
Идентификатор потока	ThreadId	integer	Если скрипт PowerShell выполняется в качестве потока агента, этот вывод будет содержать идентификатор потока агента, который можно использовать для мониторинга выполнения скрипта PowerShell и получения результатов скрипта PowerShell при завершении скрипта.

Значение подстановки из таблицы подстановки IA-Connect

Идентификатор операции:

LookupValueFromIAConnectLookupTable

Извлекает значение из таблицы подстановки Orchestrator (для автоматизации с помощью Orchestrator) или таблицы подстановки, загруженной в агент IA-Connect, из первой строки, соответствующей входным данным. Если в Оркестраторе есть таблица подстановки с тем же именем, что и одна загруженная в агент IA-Connect, используется таблица подстановки Orchestrator (если автоматизация проходит через Orchestrator).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы подстановки	LookupTableName	True	string	Имя таблицы подстановки Orchestrator или таблицы подстановки, загруженной в агент IA-Connect.
Входные данные JSON	InputDataJSON		string	Входные данные для подстановки в формате JSON. Например, если в таблице подстановки есть столбцы свойств JobTitle и Country, можно отправить следующий код JSON: { JobTitle: "Консультант", "Страна": "Англия" }.
Имя столбца значения результата поиска	SearchResultValueColumnName	True	string	Столбец в таблице подстановки, в которой содержится возвращаемое значение для чтения.
Индекс столбца значения результата поиска	SearchResultValueColumnIndex		integer	Если задано значение 1 (значение по умолчанию), возвращается значение из первого столбца результатов, соответствующего запрошенное имя. Задайте значение более высокого значения (N), чтобы вернуть соответствующий столбец Nth.
Вызов исключения, если совпадение не соответствует	RaiseExceptionIfNoMatch		boolean	Задайте значение true (по умолчанию), чтобы вызвать исключение, если подстановка не соответствует данным. Задайте значение false, чтобы вернуть пустую строку, если подстановка не соответствует данным.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Значение подстановки выходных данных	OutputLookupValue	string	Выходное значение из указанного столбца таблицы подстановки, полученное путем поиска входных данных в таблице IA-Connect подстановки.

Импорт сборки из локального файла

Идентификатор операции:

ImportAssemblyFromLocalFile

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к файлу локальной сборки	LocalAssemblyFilePath	True	string	Путь к файлу локальной сборки в локальном сеансе (где выполняется директор IA-Connect).
Имя сборки	AssemblyName	True	string	Имя импортируемой сборки.
Сжимать	Compress		boolean	Следует ли сжать сборку перед отправкой?
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Массив строк фильтра

Идентификатор операции:

FilterStringArray

Принимает входной массив строковых элементов, фильтрует массив (с помощью синтаксиса строк .NET DataView) и возвращает новый массив. Если вы хотите отфильтровать таблицу, используйте действие "Фильтровать таблицу". Чтобы отфильтровать таблицу в формате JSON, используйте действие "Фильтр таблицы JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной массив	InputArray	True	array of string	Входной массив строк.
Имя столбца	ColumnName	True	string	Имя, используемое для столбца таблицы, в который содержится массив во время операции фильтра. Затем это имя можно использовать в качестве имени столбца в синтаксисе строк .NET DataView. Например MyColumn, который затем можно называть [MyColumn].
Filter	Filter	True	string	Фильтр в синтаксисе строк .NET DataView. Например: [Имя], например "*Элемент".

Возвращаемое значение

Имя	Путь	Тип	Описание
Отфильтрованный выходной массив	OutputArray	array of string	Отфильтрованный выходной массив строк.
Количество предметов	NumberOfItems	integer	Количество элементов в выходном массиве.

Отправка CSV-файла в список оркестратора IA-Connect

Идентификатор операции:

UploadCSVToIAConnectList

Передайте данные CSV-файла в список оркестратора IA-Connect, заменив существующее содержимое.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя списка	ListName	True	string	Имя списка Orchestrator.
CSV-данные	CSVData	True	string	Замена данных CSV для хранения в списке Orchestrator. Если список уже существует, содержимое списка будет заменено данными CSV. Невозможно предоставить пустые входные данные CSV, но можно предоставить строку заголовка CSV без строк данных.
Создание списка, если оно не существует	CreateListIfNotExist		boolean	Если задано значение false (значение по умолчанию), а именованный список еще не существует, создается исключение. Если задано значение true, создается именованный список, если он не существует.

Возвращаемое значение

Имя	Путь	Тип	Описание
Результат команды	UploadCSVToIAConnectListResult	boolean	Результат команды (успешное выполнение или сбой).
Сообщение об ошибке	ErrorMessage	string	Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке.

Отправка CSV-файла в таблицу подстановки Оркестратора IA-Connect

Идентификатор операции:

UploadCSVToIAConnectLookupTable

Отправка замены CSV-данных в таблицу подстановки оркестратора IA-Connect, заменив существующее содержимое. Это действие не будет взаимодействовать с таблицей подстановки, обрабатываемой агентом IA-Connect (CSV-файл, удерживаемый на диске).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы подстановки	LookupTableName	True	string	Имя таблицы подстановки Orchestrator.
CSV-данные	CSVData	True	string	Замена данных CSV для хранения в таблице подстановки Orchestrator. Если таблица подстановки уже существует, содержимое таблицы будет заменено данными CSV. Невозможно предоставить пустые входные данные CSV, но можно предоставить строку заголовка CSV без строк данных.
Создание таблицы подстановки, если она не существует	CreateLookupTableIfNotExist		boolean	Если задано значение false (значение по умолчанию), а именованной таблицей подстановки еще не существует, создается исключение. Если задано значение true, создается именованной таблицы подстановки, если она не существует.

Возвращаемое значение

Имя	Путь	Тип	Описание
Результат команды	UploadCSVToIAConnectLookupTableResult	boolean	Результат команды (успешное выполнение или сбой).
Сообщение об ошибке	ErrorMessage	string	Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке.

Очистка папок поиска сборок

Идентификатор операции:

ClearAssemblySearchFolders

Сбросите дополнительный список папок для агента IA-Connect для проверки при попытке загрузить внешнюю ссылку.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Переименование столбца в таблице

Идентификатор операции:

RenameColumnInTable

Принимает входную таблицу, переименовывает указанный столбец и возвращает новую таблицу. Если вы хотите переименовать столбец из таблицы в формате JSON, используйте действие "Переименовать столбец в таблице JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Имя исходного столбца	SourceColumnName	True	string	Имя столбца, который нужно переименовать.
Имя нового столбца	NewColumnName	True	string	Новое имя столбца.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Переименование столбца в таблице JSON

Идентификатор операции:

RenameColumnInJSONTable

Принимает входную таблицу в формате JSON, переименовывает указанный столбец и возвращает новую таблицу в формате JSON. Если вы хотите переименовать столбец из фактической таблицы (т. е. не в формате JSON), используйте действие "Переименовать столбец в таблице".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Имя исходного столбца	SourceColumnName	True	string	Имя столбца, который нужно переименовать.
Имя нового столбца	NewColumnName	True	string	Новое имя столбца.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Получение версии PowerShell

Идентификатор операции:

GetPowerShellVersion

Возвращает версию PowerShell в сеансе, где запущен агент IA-Connect. Это обнаруживает Microsoft PowerShell версии 3.x до версии 5.x, а не ядро PowerShell (6.x далее).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя компьютера	ComputerName		string	Имя компьютера для проверки версии PowerShell. Если осталось пустым, будет использоваться компьютер, на котором запущен агент IA-Connect.
Механизм аутентификации	AuthenticationMechanism		string	Механизм проверки подлинности, используемый при подключении к удаленному компьютеру или выполнении скрипта в качестве альтернативного пользователя. Поддерживаемые значения: "Basic", "Credssp", "Default", "Digest", "Kerberos" и "Согласование".
Попытки подключения	ConnectionAttempts		integer	Количество подключений для попытки подключения к удаленному компьютеру.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Основная версия PowerShell	PowerShellMajorVersion	integer	Основная (целочисленная) версия PowerShell. Например, PowerShell 5.1 вернет 5.
Дополнительная версия PowerShell	PowerShellMinorVersion	integer	Дополнительная версия PowerShell (после десятичного разряда). Например, PowerShell 5.1 возвращает 1.

Получение массива строк из столбца таблицы

Идентификатор операции:

GetStringArrayFromTableColumn

Принимает входную таблицу и возвращает указанный столбец в виде строкового массива. Если вы хотите получить массив строк из таблицы в формате JSON, используйте действие "Получить массив из таблицы JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Индекс столбца	ColumnIndex		integer	Индекс столбца, возвращаемого в виде массива. Используйте 1 для первого столбца N для столбца Nth. Если вы хотите получить столбец по имени, оставьте его пустым и используйте входные значения "Имя столбца".
Имя столбца	ColumnName		string	Необязательное имя столбца, возвращаемого в виде массива. Если вы хотите получить столбец по индексу, оставьте его пустым и используйте входной индекс столбца.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходной массив	OutputArray	array of string	Выходной массив строк.
Количество предметов	NumberOfItems	integer	Количество элементов в выходном массиве.

Получение массива строк из столбца таблицы JSON

Идентификатор операции:

GetStringArrayFromJSONTableColumn

Принимает входную таблицу в формате JSON и возвращает указанный столбец в виде строкового массива. Если вы хотите получить массив строк из фактической таблицы (т. е. не в формате JSON), используйте действие "Получить массив из таблицы".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Индекс столбца	ColumnIndex		integer	Индекс столбца, возвращаемого в виде массива. Используйте 1 для первого столбца N для столбца Nth. Если вы хотите получить столбец по имени, оставьте его пустым и используйте входные значения "Имя столбца".
Имя столбца	ColumnName		string	Необязательное имя столбца, возвращаемого в виде массива. Если вы хотите получить столбец по индексу, оставьте его пустым и используйте входной индекс столбца.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходной массив	OutputArray	array of string	Выходной массив строк.
Количество предметов	NumberOfItems	integer	Количество элементов в выходном массиве.

Получение сводки по таблице подстановки IA-Connect

Идентификатор операции:

GetIAConnectLookupTableSummary

Извлекает сводку таблиц подстановки, загруженных в агент IA-Connect.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Таблицы подстановки JSON	LookupTablesJSON	array of object	Таблицы подстановки, загруженные в агент IA-Connect.
Имя	LookupTablesJSON.Name	string
ThenColumnIndex	LookupTablesJSON.ThenColumnIndex	integer
NumberOfRows	LookupTablesJSON.NumberOfRows	integer
NumberOfColumns	LookupTablesJSON.NumberOfColumns	integer
NumberOfUniqueHeaderProperTies	LookupTablesJSON.NumberOfUniqueHeaderProperties	integer
Количество таблиц подстановки	NumberOfLookupTables	integer	Количество таблиц подстановки, загруженных в агент IA-Connect.

Получение совпадений группы регулярных выражений

Идентификатор операции:

GetRegexGroupMatches

Выполняет совпадение регулярного выражения (regex) во входной строке и возвращает список сопоставленных имен и значений групп.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Вводимый текст для сопоставления	TextToMatch	True	string	Входной текст, соответствующий регулярному выражению.
Регулярное выражение	Regex	True	string	Регулярное выражение, соответствующее входной тексту.
Группы для получения	GroupsToRetrieve		array of string	Массив строк, содержащий имена групп регулярных выражений для извлечения. Если указан пустой массив, извлекаются все группы. Например, если регулярное выражение содержит (?<NeedsUpdating>(Да|Нет)) и вы указываете, что нужно получить группу "NeedsUpdating", а затем будет возвращено соответствующее значение именованной группы.
Индекс поиска	SearchIndex		integer	Индекс результата сопоставления, который требуется получить, начиная с 1. Если вы хотите сопоставить первый результат (поведение по умолчанию), введите 1. Например, если входная строка, как ожидается, соответствует регулярному выражению в 5 местах, и вы заинтересованы в 4-м совпадении, введите 4.
Соответствие с учетом регистра	CaseSensitive		boolean	Задайте значение true (по умолчанию) для совпадения с учетом регистра (например, А не является) или имеет значение false для нечувствительного регистра (например, A и a рассматриваются как идентичные).
Время ожидания регулярных выражений в секундах	RegexTimeoutInSeconds		integer	Максимальное количество секунд регулярного выражения можно обрабатывать до истечения времени ожидания. Это останавливает бесконечные циклы, вызванные определенными регулярными выражениями.

Возвращаемое значение

Имя	Путь	Тип	Описание
Группы регулярных выражений	RegexGroups	array of object	Массив, содержащий имена и значения групп регулярных выражений, сопоставленных с входной строкой.
Недвижимость	RegexGroups.Property	string
Ценность	RegexGroups.Value	string
Количество групп	NumberOfRegexGroups	integer	Количество групп регулярных выражений.

Получение совпадений регулярного выражения

Идентификатор операции:

GetRegexMatches

Выполняет совпадение регулярного выражения (regex) во входной строке и возвращает все совпадения в массиве строк. Массив будет пустым, если совпадений не было.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Вводимый текст для сопоставления	TextToMatch	True	string	Входной текст, соответствующий регулярному выражению.
Регулярное выражение	Regex	True	string	Регулярное выражение, соответствующее входной тексту.
Максимальное количество совпадений для выполнения	MaximumMatches		integer	Максимальное количество совпадений регулярных выражений для выполнения. Для неограниченного количества совпадений (т. е. сохраняйте соответствие до тех пор, пока не будет больше совпадений) не введите значение или значение 0 (значение по умолчанию). Эти входные данные предназначены для предотвращения бесконечных циклов регулярных выражений путем ограничения количества совпадений.
Соответствие с учетом регистра	CaseSensitive		boolean	Задайте значение true (по умолчанию) для совпадения с учетом регистра (например, А не является) или имеет значение false для нечувствительного регистра (например, A и a рассматриваются как идентичные).
Обрезка результатов	TrimResults		boolean	Установите значение true (по умолчанию), если каждый отдельный элемент массива выходных данных должен быть обрезано.
Удаление пустых результатов	RemoveEmptyResults		boolean	Задайте значение true, если пустые элементы массива выходных данных должны быть удалены из выходного массива (т. е. не нужны пустые результаты).
Время ожидания регулярных выражений в секундах	RegexTimeoutInSeconds		integer	Максимальное количество секунд регулярного выражения можно обрабатывать до истечения времени ожидания. Это останавливает бесконечные циклы, вызванные определенными регулярными выражениями.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходной массив	OutputArray	array of object	Выходной массив строк, содержащий совпадения отдельных регулярных выражений.
items	OutputArray	object
Количество элементов в выходных данных	NumberOfElementsInOutput	integer	Количество элементов в выходном массиве.

Получение содержимого списка IA-Connect

Идентификатор операции:

GetIAConnectListContents

Извлекает все данные из списка оркестратора IA-Connect.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя списка	ListName	True	string	Имя списка Orchestrator.
Формат возврата	ReturnFormat		string	Формат, используемый при возврате результатов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Список выходных данных JSON	OutputListJSON	string	Выходные данные из списка в формате JSON.
Список выходных данных	OutputList	array of object	Выходные данные из списка в формате данных.
items	OutputList	object
Csv-файл списка выходных данных	OutputListCSV	string	Выходные данные из списка в формате CSV.
Количество строк в выходных данных	NumberOfRowsInOutput	integer	Количество строк в выходных данных.
Количество столбцов в выходных данных	NumberOfColumnsInOutput	integer	Количество столбцов в выходных данных.

Получение содержимого таблицы IA-Connect Orchestrator

Идентификатор операции:

GetIAConnectLookupTableContents

Извлекает все данные из таблицы подстановки оркестратора IA-Connect, удерживаемой на оркестраторе. Это не будет извлекать таблицу подстановки, обработанную агентом IA-Connect (CSV-файл, удерживаемый на диске).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы подстановки	LookupTableName	True	string	Имя таблицы подстановки Orchestrator.
Формат возврата	ReturnFormat		string	Формат, используемый при возврате результатов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Таблица подстановки выходных данных JSON	OutputLookupTableJSON	string	Выходные данные из таблицы подстановки в формате JSON.
Таблица подстановки выходных данных	OutputLookupTable	array of object	Выходные данные из таблицы подстановки в формате данных.
items	OutputLookupTable	object
Таблица подстановки выходных данных CSV	OutputLookupTableCSV	string	Выходные данные из таблицы подстановки в формате CSV.
Количество строк в выходных данных	NumberOfRowsInOutput	integer	Количество строк в выходных данных.
Количество столбцов в выходных данных	NumberOfColumnsInOutput	integer	Количество столбцов в выходных данных.

Получение сопоставления регулярных выражений

Идентификатор операции:

GetRegexMatch

Выполняет совпадение регулярного выражения (regex) во входной строке и возвращает, соответствует ли строка выражению и сведениям о совпадении.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Вводимый текст для сопоставления	TextToMatch	True	string	Входной текст, соответствующий регулярному выражению.
Регулярное выражение	Regex	True	string	Регулярное выражение, соответствующее входной тексту.
Индекс поиска	SearchIndex		integer	Индекс результата сопоставления, который требуется получить, начиная с 1. Если вы хотите сопоставить первый результат (поведение по умолчанию), введите 1. Например, если входная строка, как ожидается, соответствует регулярному выражению в 5 местах, и вы заинтересованы в 4-м совпадении, введите 4.
Соответствие с учетом регистра	CaseSensitive		boolean	Задайте значение true (по умолчанию) для совпадения с учетом регистра (например, А не является) или имеет значение false для нечувствительного регистра (например, A и a рассматриваются как идентичные).
Время ожидания регулярных выражений в секундах	RegexTimeoutInSeconds		integer	Максимальное количество секунд регулярного выражения можно обрабатывать до истечения времени ожидания. Это останавливает бесконечные циклы, вызванные определенными регулярными выражениями.

Возвращаемое значение

Имя	Путь	Тип	Описание
Успешное совпадение	SuccessfulMatch	boolean	Значение True, если было успешное совпадение (по указанному индексу поиска) или значение false, если не было.
Сопоставление строкового значения	MatchStringValue	string	Если произошло успешное совпадение, это строковое значение содержит текст из входного текста, соответствующего регулярному выражению.
Индекс позиции сопоставления	MatchIndex	integer	Если произошло успешное совпадение, это значение содержит позицию в входном тексте, чтобы соответствовать расположению совпадения. Это значение начинается с 0, которое представляет самую начало входной текстовой строки.
Длина строки сопоставления	MatchStringLength	integer	Если произошло успешное совпадение, это значение содержит длину текста из входного текста, соответствующего регулярному выражению (т. е. длину выходного значения "Соответствие строковому значению").

Получение столбца из списка IA-Connect

Идентификатор операции:

GetColumnFromIAConnectList

Извлекает столбец из списка оркестратора IA-Connect.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя списка	ListName	True	string	Имя списка Orchestrator.
Индекс столбца поиска	SearchColumnIndex		integer	Индекс столбца в списке для возврата. Значение по умолчанию — 1, которое возвращает первый столбец. Если вы хотите получить столбец по имени, задайте для него значение 0 и укажите вместо него имя столбца.
Имя столбца поиска	SearchColumnName		string	Имя столбца в списке, возвращаемого, если вы хотите получить столбец из списка по имени. Задайте для параметра "Индекс столбца поиска" значение 0, если вы хотите использовать эти входные данные.
Возврат пустых ячеек	ReturnBlankCells		boolean	Задайте значение true, если вы хотите включить пустые ячейки в возвращаемые данные. Установите значение false (по умолчанию), чтобы включать только ячейки со значениями.
Резервный список, если список не существует	FallBackIfListDoesNotExist		boolean	Этот вход управляет результатом, если указанный список не существует. Если для этого входного значения задано значение false (значение по умолчанию), будет исключение. Если для этих входных данных задано значение true, то для параметра "Выходной список" (отформатированный в запрошенном формате возврата) будет задано резервное значение, которое может быть пустым или значением выбранного значения.
Резервное значение	FallbackValue		string	Если указанный список не существует, а входной параметр "Резервный список, если список не существует", имеет значение true, это резервное значение будет использоваться для выходных данных, отформатированных в запрошенном формате возврата. Это полезно при чтении данных из таблиц подстановки, а некоторые элементы данных представляют список, в то время как некоторые элементы являются фактическими данными.
Формат возврата	ReturnFormat		string	Формат, используемый при возврате результатов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Список выходных данных JSON	OutputListJSON	string	Выходной столбец из списка в формате JSON.
Список выходных данных	OutputList	array of object	Выходной столбец из списка в формате таблицы данных.
items	OutputList	object
Массив списка выходных данных	OutputListArray	array of object	Выходной столбец из списка в формате массива.
items	OutputListArray	object
Количество строк в выходных данных	NumberOfRowsInOutput	integer	Количество строк в выходных данных.

Получение строки из ячейки таблицы JSON

Идентификатор операции:

GetStringFromJSONTableCell

Принимает входную таблицу в формате JSON и возвращает указанную ячейку в виде строки.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Индекс строки	RowIndex		integer	Индекс строки, содержащей ячейку для извлечения. Используйте 1 для первой строки N для N-й строки.
Индекс столбца	ColumnIndex		integer	Индекс столбца, содержащего ячейку для извлечения. Используйте 1 для первого столбца N для столбца Nth. Если вы хотите получить столбец по имени, оставьте его пустым и используйте входные значения "Имя столбца".
Имя столбца	ColumnName		string	Необязательное имя столбца, содержащего ячейку для извлечения. Если вы хотите получить столбец по индексу, оставьте его пустым и используйте входной индекс столбца.
Резервный вариант, если ячейка не существует	FallBackIfCellDoesNotExist		boolean	Этот вход управляет результатом, если указанный индекс строки, индекс столбца или имя не существует. Если для этого входного значения задано значение false (значение по умолчанию), будет исключение. Если для этого входного значения задано значение true, для строки вывода будет задано резервное значение, которое может быть пустым или значением выбранного значения.
Резервное значение	FallbackValue		string	Если указанный индекс строки, индекс столбца или имя не существует, а входное значение "Fallback, если ячейка не существует" имеет значение true, это резервное значение будет использоваться для выходной строки.

Возвращаемое значение

Имя	Путь	Тип	Описание
Строка вывода	OutputString	string	Содержимое выходной ячейки в виде строки.

Получение строки между

Идентификатор операции:

GetStringBetween

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная строка	InputString		string	Входная строка, на которой выполняется поиск.
Запуск строки поиска	StartSearchString		string	Строка начального поиска.
Строка завершения поиска	EndSearchString		string	Строка конечного поиска или оставить пустой при поиске до конца строки.
Поиск по строке	SearchLineByLine		boolean	Задайте значение true, если требуется выполнить поиск по строке входной строки, а результат содержит только соответствующую строку в текущей строке. Задайте значение false для обработки входной строки как одного элемента.
Создание исключения, если не найдено	ThrowExceptionIfNotFound		boolean	Задайте значение true, если требуется исключение, возникающее, если строка поиска не найдена, или задайте значение false, если действие должно возвращать значение String между найденной"=false, если строка поиска не найдена.
Результат обрезки	TrimResult		boolean	Задайте значение true, если требуется, чтобы пробелы или вкладки до или после результата были обрезаны.
Поиск — регулярное выражение	SearchIsRegularExpression		boolean	Задайте значение true, если строки поиска являются регулярными выражениями. Установите значение false, если строки поиска являются обычным текстом.
Поиск с учетом регистра	CaseSensitiveSearch		boolean	Задайте значение true, если поиск должен быть чувствительным к регистру. Задайте значение false для нечувствительных запросов регистра.

Возвращаемое значение

Имя	Путь	Тип	Описание
Найденная строка поиска	SearchStringFound	boolean	Если значение "Исключение создания, если не найдено", имеет значение false, то этот результат имеет значение true, если строка поиска найдена, значение false, если нет.
Строка между	StringBetween	string	Строка, найденная между указанными строками.

Получение таблицы JSON из массива строк

Идентификатор операции:

GetJSONTableFromStringArray

Принимает входной массив строковых элементов и возвращается в виде таблицы JSON.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной массив	InputArray	True	array of string	Входной массив строк.
Имя столбца	ColumnName	True	string	Имя, используемое для столбца таблицы.
Удаление пустых элементов	DropEmptyItems		boolean	Задайте значение true, чтобы игнорировать пустые элементы (удалить) в массиве. Установите значение false, чтобы включить все элементы.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Число столбцов в выходной таблице (всегда должно быть 1).

Получение таблицы из JSON

Идентификатор операции:

GetTableFromJSON

Принимает входную таблицу в формате JSON и возвращается в качестве таблицы. Это называется десериализацией.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Запуск индекса строки	StartRowIndex	True	integer	Индекс первой строки, извлекаемой. Используйте 1, чтобы начать с первой строки, N, чтобы начать с N-й строки.
Количество строк для извлечения	NumberOfRowsToRetrieve		integer	Количество извлекаемых строк. Используйте 0 (или оставьте пустым) для получения всех строк.
Начальный индекс столбца	StartColumnIndex		integer	Индекс извлекаемого первого столбца. Используйте 1, чтобы начать с первого столбца, N, чтобы начать с столбца Nth. Если вы хотите указать первый столбец для получения по имени, оставьте его пустым и используйте вместо него входное имя столбца "Пуск".
Имя начального столбца	StartColumnName		string	Необязательное имя первого столбца для получения. Если вы хотите получить столбцы по индексу, оставьте его пустым и используйте входной индекс столбца "Пуск".
Количество столбцов для извлечения	NumberOfColumnsToRetrieve		integer	Количество извлекаемых столбцов. Используйте 0 (или оставьте пустым) для извлечения всех столбцов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Число столбцов в выходной таблице (всегда должно быть 1).

Получение таблицы из массива строк

Идентификатор операции:

GetTableFromStringArray

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной массив	InputArray	True	array of string	Входной массив строк.
Имя столбца	ColumnName	True	string	Имя, используемое для столбца таблицы.
Удаление пустых элементов	DropEmptyItems		boolean	Задайте значение true, чтобы игнорировать пустые элементы (удалить) в массиве. Установите значение false, чтобы включить все элементы.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Число столбцов в выходной таблице (всегда должно быть 1).

Преобразование массива в JSON

Идентификатор операции:

ConvertArrayToJSON

Принимает входной массив и сериализуется в строку JSON.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной объект	Input object		object

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходные данные JSON	OutputJSON	string	Выходная строка JSON.

Разделение строки с помощью регулярного выражения

Идентификатор операции:

GetRegexSplit

Разбивает входную строку с помощью сопоставления регулярных выражений (regex) и возвращает отдельные компоненты разбиения строки в виде массива строк.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Вводимый текст для разделения	TextToSplit	True	string	Входной текст, разделенный на регулярное выражение.
Регулярное выражение	Regex	True	string	Регулярное выражение для разделения входного текста на.
Разделение регистра с учетом регистра	CaseSensitive		boolean	Установите значение true (значение по умолчанию) для разделения с учетом регистра (например, A не является) или имеет значение false для нечувствительного регистра (например, A и a обрабатываются как идентичные).
Обрезка результатов	TrimResults		boolean	Установите значение true (по умолчанию), если каждый отдельный элемент массива выходных данных должен быть обрезано.
Удаление пустых результатов	RemoveEmptyResults		boolean	Задайте значение true, если пустые элементы массива выходных данных должны быть удалены из выходного массива (т. е. не нужны пустые результаты).
Время ожидания регулярных выражений в секундах	RegexTimeoutInSeconds		integer	Максимальное количество секунд регулярного выражения можно обрабатывать до истечения времени ожидания. Это останавливает бесконечные циклы, вызванные определенными регулярными выражениями.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходной массив	OutputArray	array of object	Выходной массив строк, содержащий отдельные компоненты строки, разделенный по регулярному выражению.
items	OutputArray	object
Количество элементов в выходных данных	NumberOfElementsInOutput	integer	Количество элементов в выходном массиве.

Создание JSON из входных переменных

Идентификатор операции:

CreateJSONFromInputVariables

Принимает массив входных переменных и возвращается в формате JSON и при необходимости в виде таблицы JSON.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Название свойства	PropertyName		string
Тип данных свойства	DataType		string
Значение свойства	Value		string
Возвращается в виде таблицы JSON	ReturnAsJSONTable	True	boolean	Если задано значение true, json будет возвращен в формате таблицы или таблицы или таблицы данных (т. е. в формате [{}]). Если задано значение false, json будет возвращен в виде одной сущности (т. е. в формате {}). Какой формат следует использовать, зависит от того, что вы делаете с помощью JSON. Большинство IA-Connect действий ожидают формат таблицы данных.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходные данные JSON	OutputJSON	string	Переменные и их значения, закодированные в формате JSON.

Сортировка массива строк

Идентификатор операции:

SortStringArray

Принимает входной массив строковых элементов, сортирует массив и возвращает новый массив. Если вы хотите сортировать таблицу, используйте действие "Сортировка таблицы". Если вы хотите сортировать таблицу в формате JSON, используйте действие "Сортировка таблицы JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной массив	InputArray	True	array of string	Входной массив строк.
Сортировка по возрастанию	Ascending		boolean	Задайте значение true для сортировки в порядке возрастания. Установите значение false для сортировки в порядке убывания.
С учетом регистра	CaseSensitive		boolean	Установите значение true для сортировки с учетом регистра (например, верхний и нижний регистр отсортированы по отдельности). Задайте значение false для нечувствительной сортировки регистра.

Возвращаемое значение

Имя	Путь	Тип	Описание
Отсортированный выходной массив	OutputArray	array of string	Отсортированный выходной массив строк.
Количество предметов	NumberOfItems	integer	Количество элементов в выходном массиве.

Сортировка таблицы

Идентификатор операции:

SortTable

Принимает входную таблицу, сортирует одну или несколько строк и возвращает новую таблицу. Если вы хотите сортировать таблицу в формате JSON, используйте действие "Сортировка таблицы JSON". Если вы хотите сортировать массив строк, используйте действие "Сортировка строкового массива".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Сортировка имени столбца	SortColumnName	True	string	Имя столбца для сортировки по. Если вы хотите сортировать по нескольким столбцам, перечислите разделенные запятыми столбцы.
Сортировка по возрастанию	Ascending	True	boolean	Задайте значение true для сортировки в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 2	SortColumnName2		string	Необязательное имя второго столбца для сортировки (после сортировки по первому столбцу).
Сортировка по возрастанию 2	Ascending2		boolean	Задайте значение true, чтобы отсортировать второе имя столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 3	SortColumnName3		string	Необязательное имя третьего столбца для сортировки (после сортировки по первым и вторым столбцам).
Сортировка по возрастанию 3	Ascending3		boolean	Задайте значение true, чтобы отсортировать имя третьего столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Сортировка таблицы JSON

Идентификатор операции:

SortJSONTable

Принимает входную таблицу JSON, сортирует таблицу и возвращает новую таблицу JSON. Если вы хотите сортировать фактическую таблицу (т. е. не в формате JSON), используйте действие "Сортировка таблицы". Если вы хотите сортировать массив строк, используйте действие "Сортировка строкового массива".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Сортировка имени столбца	SortColumnName	True	string	Имя столбца для сортировки по.
Сортировка по возрастанию	Ascending		boolean	Задайте значение true для сортировки в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 2	SortColumnName2		string	Необязательное имя второго столбца для сортировки (после сортировки по первому столбцу).
Сортировка по возрастанию 2	Ascending2		boolean	Задайте значение true, чтобы отсортировать второе имя столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 3	SortColumnName3		string	Необязательное имя третьего столбца для сортировки (после сортировки по первым и вторым столбцам).
Сортировка по возрастанию 3	Ascending3		boolean	Задайте значение true, чтобы отсортировать имя третьего столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Столбцы подстановки из таблицы подстановки IA-Connect

Идентификатор операции:

LookupColumnsFromIAConnectLookupTable

Извлекает один или несколько идентичных именованных столбцов из таблицы подстановки Orchestrator (для автоматизации с помощью Orchestrator) или таблицы подстановки, загруженной в агент IA-Connect, из первой строки, соответствующей входным данным, и возвращается в виде таблицы. Например, таблица подстановки может содержать несколько выходных столбцов с именем AD group для представления нескольких групп AD, и они будут возвращены в виде отдельных строк в выходной таблице. Если в Оркестраторе есть таблица подстановки с тем же именем, что и одна загруженная в агент IA-Connect, используется таблица подстановки Orchestrator (если автоматизация проходит через Orchestrator).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы подстановки	LookupTableName	True	string	Имя таблицы подстановки Orchestrator или таблицы подстановки, загруженной в агент IA-Connect.
Входные данные JSON	InputDataJSON		string	Входные данные для подстановки в формате JSON. Например, если в таблице подстановки есть столбцы свойств JobTitle и Country, можно отправить следующий код JSON: { JobTitle: "Консультант", "Страна": "Англия" }.
Имя столбца таблицы результатов поиска	SearchResultTableColumnName	True	string	Имя выходного столбца в таблице подстановки, содержащей значение, возвращаемое в выходной таблице. Если только один выходной столбец в таблице подстановки имеет это имя, выходная таблица будет иметь одну строку. Если несколько выходных столбцов в таблице подстановки имеют общее имя, в выходной таблице будет несколько строк.
Вызов исключения, если совпадение не соответствует	RaiseExceptionIfNoMatch		boolean	Задайте значение true (по умолчанию), чтобы вызвать исключение, если подстановка не соответствует данным. Задайте значение false, чтобы вернуть пустую строку, если подстановка не соответствует данным.
Возврат пустых ячеек	ReturnBlankCells		boolean	Задайте значение true, если вы хотите включить пустые ячейки в возвращаемую таблицу. Установите значение false (по умолчанию), чтобы включать только ячейки со значениями.
Формат возврата	ReturnFormat		string	Формат, используемый при возврате результатов.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Таблица подстановки выходных данных JSON	OutputLookupTableJSON	string	Выходная таблица считывается из одной или нескольких столбцов таблицы подстановки с указанным именем, полученной путем поиска входных данных в таблице IA-Connect подстановки. В выходной таблице будет один столбец (соответствующий запрошенному имени столбца таблицы результатов) и одна или несколько строк в формате JSON.
Таблица подстановки выходных данных	OutputLookupTable	array of object	Выходная таблица считывается из одной или нескольких столбцов таблицы подстановки с указанным именем, полученной путем поиска входных данных в таблице IA-Connect подстановки. В выходной таблице будет один столбец (соответствующий запрошенному имени столбца таблицы результатов) и одна или несколько строк.
items	OutputLookupTable	object
Массив подстановки выходных данных	OutputLookupArray	array of object	Выходной массив считывается из одной или нескольких столбцов таблицы подстановки с указанным именем, полученным путем поиска входных данных в таблицу подстановки IA-Connect. Выходной массив — это один столбец с одной или несколькими строками.
items	OutputLookupArray	object
Количество строк в выходных данных	NumberOfRowsInOutput	integer	Количество строк в выходных данных.

Таблица фильтров

Идентификатор операции:

FilterTable

Принимает входную таблицу, фильтрует таблицу (с помощью синтаксиса строк .NET DataView) и возвращает новую таблицу. Чтобы отфильтровать таблицу в формате JSON, используйте действие "Фильтр таблицы JSON". Если вы хотите отфильтровать массив строк, используйте действие "Фильтровать строковый массив".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Filter	Filter	True	string	Фильтр в синтаксисе строк .NET DataView. Например: [Имя], например "*Элемент".
Сортировка имени столбца	SortColumnName		string	Необязательное имя столбца для сортировки после применения фильтра. Если вы хотите сортировать по нескольким столбцам, перечислите разделенные запятыми столбцы.
Сортировка по возрастанию	Ascending		boolean	Задайте значение true для сортировки в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 2	SortColumnName2		string	Необязательное имя второго столбца для сортировки (после сортировки по первому столбцу).
Сортировка по возрастанию 2	Ascending2		boolean	Задайте значение true, чтобы отсортировать второе имя столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 3	SortColumnName3		string	Необязательное имя третьего столбца для сортировки (после сортировки по первым и вторым столбцам).
Сортировка по возрастанию 3	Ascending3		boolean	Задайте значение true, чтобы отсортировать имя третьего столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Удаление всех таблиц подстановки IA-Connect

Идентификатор операции:

RemoveAllIAConnectLookupTables

Удаляет все таблицы подстановки, загруженные в агент IA-Connect.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Результат команды	RemoveAllIAConnectLookupTablesResult	boolean	Результат команды (успешное выполнение или сбой).
Сообщение об ошибке	ErrorMessage	string	Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке.

Удаление символов из строки

Идентификатор операции:

RemoveCharactersFromString

Принимает входную строку и возвращает ее с указанными символами, удаленными. Если указанные символы не расположены, будет возвращена исходная строка.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная строка	InputString		string	Входная строка, при которой выполняется удаление символов.
Символы для удаления из входной строки	CharactersToRemoveFromInputString		string	Строка, содержащая все символы, которые вы хотите удалить из входных данных. Например: !@&?^*.
Удаление диакритических значений из входной строки	RemoveDiacriticsFromInputString		boolean	Если задано значение true, IA-Connect попытается удалить все диакритические элементы из входной строки, заменив символы диакритической с тем же символом минус диакритический. Например, замена "остро акцентированного" на "a". В сценариях, когда нет прямого сопоставления с простым символом, этот символ удаляется. Например: немецкий острый S удаляется.
Удаление не буквенно-цифровой строки из входной строки	RemoveNonAlphaNumericFromInputString		boolean	Если задано значение true, IA-Connect удалит все не буквенно-цифровые символы из входной строки.
Удаление числовых символов из входной строки	RemoveNumericFromInputString		boolean	Если задано значение true, IA-Connect удалите все числовые символы из входной строки.
Удаление строчных символов из входной строки	RemoveLowercaseCharactersFromInputString		boolean	Если задано значение true, IA-Connect удалите все строчные буквы из входной строки.
Удаление символов верхнего регистра из входной строки	RemoveUppercaseCharactersFromInputString		boolean	Если задано значение true, IA-Connect удалите все прописные буквы из входной строки.

Возвращаемое значение

Имя	Путь	Тип	Описание
Строка вывода	OutputString	string	Строка с удаленными символами. Это будет исходная строка, если не найдены указанные символы.

Удаление столбцов из таблицы

Идентификатор операции:

DeleteColumnsInTable

Принимает входную таблицу, удаляет столбец или столбцы и возвращает новую таблицу. Если вы хотите удалить столбцы из таблицы в формате JSON, используйте действие "Удалить столбцы из таблицы JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Начальный индекс столбца	StartColumnIndex		integer	Индекс столбца, с который начинается удаление. Используйте 1 для удаления первого столбца N, чтобы удалить столбец Nth. Если вы хотите удалить столбец по имени, оставьте этот вход пустым и используйте входное имя столбца для удаления.
Имя столбца для удаления	ColumnNameToDelete		string	Необязательное имя столбца для удаления. Если вы хотите удалить столбец по индексу, оставьте этот вход пустым и используйте входной индекс "Пуск индекса столбца".
Число столбцов для удаления	NumberOfColumnsToDelete	True	integer	Число столбцов для удаления, начиная с указанного индекса или имени.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Удаление столбцов из таблицы JSON

Идентификатор операции:

DeleteColumnsInJSONTable

Принимает входную таблицу в формате JSON, удаляет столбец или столбцы и возвращает новую таблицу в формате JSON. Если вы хотите удалить столбцы из фактической таблицы (т. е. не в формате JSON), используйте действие "Удалить столбцы из таблицы".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Начальный индекс столбца	StartColumnIndex		integer	Индекс столбца, с который начинается удаление. Используйте 1 для удаления первого столбца N, чтобы удалить столбец Nth. Если вы хотите удалить столбец по имени, оставьте этот вход пустым и используйте входное имя столбца для удаления.
Имя столбца для удаления	ColumnNameToDelete		string	Необязательное имя столбца для удаления. Если вы хотите удалить столбец по индексу, оставьте этот вход пустым и используйте входной индекс "Пуск индекса столбца".
Число столбцов для удаления	NumberOfColumnsToDelete	True	integer	Число столбцов для удаления, начиная с указанного индекса или имени.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Удаление строк из таблицы

Идентификатор операции:

DeleteRowsInTable

Принимает входную таблицу, удаляет строку или строки в указанной позиции и возвращает новую таблицу. Если вы хотите удалить строку или строки из массива строк, используйте действие "Удалить строку из массива строк". Если вы хотите удалить строку или строки из таблицы в формате JSON, используйте действие "Удалить строку из таблицы JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица	Input table		object
Запуск индекса строки	StartRowIndex	True	integer	Индекс строки для начала удаления. Используйте 1, чтобы удалить первую строку, N, чтобы удалить строку Nth.
Количество строк для удаления	NumberOfRowsToDelete	True	integer	Количество удаляемых строк.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходная таблица	OutputTable	array of object	Выходная таблица.
items	OutputTable	object
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Удаление строк из таблицы JSON

Идентификатор операции:

DeleteRowsInJSONTable

Принимает входную таблицу в формате JSON, удаляет строку или строки в указанной позиции и возвращает новую таблицу в формате JSON. Если вы хотите удалить строку или строки из фактической таблицы (т. е. не в формате JSON), используйте действие "Удалить строку из таблицы". Если вы хотите удалить строку или строки из массива строк, используйте действие "Удалить строку из массива строк".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Запуск индекса строки	StartRowIndex	True	integer	Индекс строки для начала удаления. Используйте 1, чтобы удалить первую строку, N, чтобы удалить строку Nth.
Количество строк для удаления	NumberOfRowsToDelete	True	integer	Количество удаляемых строк.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Удаление таблицы подстановки IA-Connect

Идентификатор операции:

RemoveIAConnectLookupTable

Удаляет таблицу подстановки, загруженную в агент IA-Connect.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы подстановки	LookupTableName	True	string	Имя таблицы подстановки, загруженной в агент IA-Connect.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Результат команды	RemoveIAConnectLookupTableResult	boolean	Результат команды (успешное выполнение или сбой).
Сообщение об ошибке	ErrorMessage	string	Если команда не выполнена успешно, это будет содержать возвращенное сообщение об ошибке.

Удаление элементов из массива строк

Идентификатор операции:

DeleteItemsInStringArray

Принимает входной массив строковых элементов, удаляет элемент или элементы в указанной позиции и возвращает новый массив. Если вы хотите удалить строку или строки из таблицы, используйте действие "Удалить строку из таблицы". Если вы хотите удалить строку или строки из таблицы в формате JSON, используйте действие "Удалить строку из таблицы JSON".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входной массив	InputArray	True	array of string	Входной массив строк.
Начальный индекс элемента	StartItemIndex	True	integer	Индекс элемента, на который начинается удаление. Используйте 1 для удаления первого элемента, N для удаления элемента Nth.
Количество элементов для удаления	NumberOfItemsToDelete	True	integer	Количество удаленных элементов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Выходной массив	OutputArray	array of string	Выходной массив строк.
Количество предметов	NumberOfItems	integer	Количество элементов в выходном массиве.

Установлен модуль PowerShell

Идентификатор операции:

IsPowerShellModuleInstalled

Выполняет поиск указанного модуля PowerShell на компьютере, где выполняется агент IA-Connect, и возвращает, установлен ли он.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Модуль PowerShell	PowerShellModuleName	True	string	Имя модуля PowerShell для поиска.
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Установлен модуль PowerShell	PowerShellModuleIsInstalled	boolean	Возвращает значение true, если установлен указанный модуль PowerShell или значение false, если нет.

Установлена служба автоматизации PowerShell

Идентификатор операции:

IsPowerShellAutomationInstalled

Сообщает, доступна ли автоматизация PowerShell на компьютере, на котором запущен агент IA-Connect. Если автоматизация PowerShell недоступна, действия службы автоматизации PowerShell не будут работать.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Рабочий процесс	Workflow	True	string	Добавьте следующее выражение здесь: workflow()

Возвращаемое значение

Имя	Путь	Тип	Описание
Установлена служба автоматизации PowerShell	PowerShellAutomationIsInstalled	boolean	Возвращает значение true, если служба автоматизации PowerShell доступна или значение false, если нет.

Фильтрация таблицы JSON

Идентификатор операции:

FilterJSONTable

Принимает входную таблицу JSON, фильтрует таблицу (используя синтаксис строк .NET DataView) и возвращает новую таблицу JSON. Если вы хотите отфильтровать фактическую таблицу (т. е. не в формате JSON), используйте действие "Фильтровать таблицу". Если вы хотите отфильтровать массив строк, используйте действие "Фильтровать строковый массив".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Входная таблица JSON	JSONTable	True	string	Входная таблица в формате JSON.
Filter	Filter	True	string	Фильтр в синтаксисе строк .NET DataView. Например: [Имя], например "*Элемент".
Сортировка имени столбца	SortColumnName		string	Необязательное имя столбца для сортировки после применения фильтра. Если вы хотите сортировать по нескольким столбцам, перечислите разделенные запятыми столбцы.
Сортировка по возрастанию	Ascending		boolean	Задайте значение true для сортировки в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 2	SortColumnName2		string	Необязательное имя второго столбца для сортировки (после сортировки по первому столбцу).
Сортировка по возрастанию 2	Ascending2		boolean	Задайте значение true, чтобы отсортировать второе имя столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.
Сортировка имени столбца 3	SortColumnName3		string	Необязательное имя третьего столбца для сортировки (после сортировки по первым и вторым столбцам).
Сортировка по возрастанию 3	Ascending3		boolean	Задайте значение true, чтобы отсортировать имя третьего столбца в порядке возрастания. Установите значение false для сортировки в порядке убывания.

Возвращаемое значение

Имя	Путь	Тип	Описание
Вывод таблицы JSON	OutputJSONTable	string	Выходная таблица в формате JSON.
Количество строк	NumberOfRows	integer	Количество строк в выходной таблице.
Число столбцов	NumberOfColumns	integer	Количество столбцов в выходной таблице.

Ячейки данных подстановки из таблицы подстановки IA-Connect

Идентификатор операции:

LookupDataCellsFromIAConnectLookupTable

Извлекает все ячейки данных из таблицы подстановки Orchestrator (для автоматизации с помощью Orchestrator), из первой строки, соответствующей входным данным, и возвращается в виде таблицы. Это действие не поддерживает таблицы подстановки, загруженные в агент IA-Connect.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы подстановки	LookupTableName	True	string	Имя таблицы подстановки Orchestrator.
Входные данные JSON	InputDataJSON		string	Входные данные для подстановки в формате JSON. Например, если в таблице подстановки есть столбцы свойств JobTitle и Country, можно отправить следующий код JSON: { JobTitle: "Консультант", "Страна": "Англия" }.
Вызов исключения, если совпадение не соответствует	RaiseExceptionIfNoMatch		boolean	Задайте значение true (по умолчанию), чтобы вызвать исключение, если подстановка не соответствует данным. Задайте значение false, чтобы вернуть пустую строку, если подстановка не соответствует данным.
Возврат пустых ячеек	ReturnBlankCells		boolean	Задайте значение true, если вы хотите включить пустые ячейки в возвращаемую таблицу. Установите значение false (по умолчанию), чтобы включить только ячейки данных со значениями.
Формат возврата	ReturnFormat		string	Формат, используемый при возврате результатов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Таблица подстановки выходных данных JSON	OutputLookupTableJSON	string	Выходная таблица, содержащая ячейки данных из строки, соответствующей входным данным, полученной путем поиска входных данных в таблице IA-Connect подстановки. В выходной таблице будет одна строка и один или несколько столбцов данных в формате JSON.
Таблица подстановки выходных данных	OutputLookupTable	array of object	Выходная таблица, содержащая ячейки данных из строки, соответствующей входным данным, полученной путем поиска входных данных в таблице IA-Connect подстановки. В выходной таблице будет одна строка и один или несколько столбцов данных.
items	OutputLookupTable	object
Количество ячеек в выходных данных	NumberOfCellsInOutput	integer	Количество ячеек в выходных данных.