Действия эмуляции терминала
Power Automate обеспечивает интеграцию с эмуляторами терминала через действия Эмуляция терминала. Эти действия позволяют управлять терминалами и мэйнфреймами и выполнять с ними различные операции, такие как перемещение курсора, задание и получение текста, а также отправка ключей.
Перед развертыванием любых действий терминала используйте действие Открыть сеанс терминала, чтобы открыть новое соединение с установленным поставщиком.
Внимание
Прежде чем пытаться подключиться к сеансу терминала, убедитесь, что фактический сеанс терминала уже открыт на вашем компьютере.
Если вы установили Micro Focus Reflection на свой компьютер, выберите соответствующий вариант в параметре Provider действия и заполните требуемую конфигурацию.
Если вы установили другого поставщика, выберите HLLAPI, который работает с большинством поставщиков эмуляции терминала.
В зависимости от поставщика, которого вы используете, выберите соответствующий файл HLLAPI DLL, расположенный в папке установки. В следующем списке вы можете увидеть имена файлов HLLAPI DLL некоторых популярных поставщиков эмуляции терминала:
- RocketSoftware BlueZone: ehlapi64.dll
- IBM Personal Communications: EHLAPI32.dll
- MicroFocus Rumba: System/ehlapi32.Dll
- Cybelesoft zScope: zHllap32.dll
Заметка
Windows HLLAPI DLL (WinHLLAPI) в настоящее время не поддерживается.
После открытия сеанса терминала и выполнения всех необходимых операций разорвите соединение, используя действие Закрыть сеанс терминала. Если вы не закроете соединение, некоторые поставщики не позволят вам снова подключиться к уже открытому сеансу без перезапуска программного обеспечения или соединения.
Открыть сеанс терминала
Открывает новый сеанс терминала.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Provider | Н/Д | Micro Focus Reflection, HLLAPI | Micro Focus Reflection | Эмуляция терминала, которую требуется использовать. |
| HLLAPI DLL path | Нет | Файл | DLL HLLAPI поставщика. Имя по умолчанию RocketSoftware BlueZone: 'ehlapi64.dll'. Имя IBM Personal Communications по умолчанию: 'EHLAPI32.dll'. Путь по умолчанию для MicroFocus Rumba: 'System/ehlapi32.Dll'. Имя по умолчанию Cybelesoft zScope: zHllap32.dll. Любой другой поставщик, который предоставляет HLLAPI DLL в своей папке установки. | |
| Installation path | Нет | Папка | Путь установки приложения поставщика в файловой системе пользователя. | |
| Конфигурация | Н/Д | Существующий профиль, Указать подключение | Существующий профиль | Выберите "Существующий профиль", чтобы выбрать файл, содержащий предварительно настроенное соединение эмуляции терминала. Выберите "Указать подключение", чтобы указать тип подключения, адрес узла и порт. |
| Session name | Нет | Текстовое значение | Имя сеанса, к которому требуется подключиться. Краткое имя HLLAPI; это уникальный идентификатор для сеанса узла. Его можно найти в настройках конфигурации эмулятора терминала. | |
| Host type | Н/Д | IBM 3270, IBM 5250 | IBM 3270 | Тип узла подключения. |
| Profile | Нет | Файл | Файл, содержащий предварительно настроенное подключение. | |
| Host address | Нет | Текстовое значение | Адрес узла, к которому требуется подключиться. | |
| Port | Нет | Числовое значение | Порт, который требуется использовать для этого подключения | |
| Attach to running session | Н/Д | Логическое значение | Ложь | Указывает, следует ли подключиться к сеансу терминала, который открыт/выполняется в настоящее время. |
Создаваемые переменные
| Аргумент | Type | Описание: |
|---|---|---|
| TerminalSession | Сеанс терминала | Определенный сеанс терминала для использования с последующими командами эмуляции терминала. |
Исключения
| Исключение | Описание |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
| Ошибка профиля. | Ошибка профиля. |
Закрыть сеанс терминала
Закрывает открытый сеанс терминала.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session to close | Нет | Сеанс терминала | Ранее открытый сеанс терминала. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Описание: |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
Переместить курсор в сеанс терминала
Перемещает курсор терминала в указанное положение.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session | Нет | Сеанс терминала | Сеанс терминала для работы. | |
| Row | Нет | Числовое значение | Вертикальное положение курсора на экране. | |
| Column | Нет | Числовое значение | Горизонтальное положение курсора на экране. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Описание: |
|---|---|
| Положение экрана выходит за границы. | Указывает, что положение экрана выходит за границы. |
| Эмулятор не поддерживает команды положений. | Указывает, что эмулятор не поддерживает использованные команды положений |
| Операция недоступна для этого типа сеанса. | Указывает, что операция недоступна для этого типа сеанса. |
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
Получить текст из сеанса терминала
Получает текст из сеанса терминала.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session | Нет | Сеанс терминала | Сеанс терминала для работы. | |
| Get text from | Н/Д | Поле, Весь экран, Положение курсора, Конкретное положение | Поле | Положение, из которого требуется получить текст. |
| Get field by | Н/Д | Метка, Индекс, Положение | Label | Указывает, как искать поле. |
| Label | Нет | Текстовое значение | Подпись поля, которое требуется найти. | |
| Index | Нет | Числовое значение | Индекс поля, которое требуется найти. | |
| Text length | Нет | Числовое значение | Длина текста, который требуется получить. | |
| Row | Нет | Числовое значение | Вертикальное положение поля на экране. | |
| Column | Нет | Числовое значение | Горизонтальное положение поля на экране. |
Создаваемые переменные
| Аргумент | Type | Описание: |
|---|---|---|
| TerminalText | Текстовое значение | Текст, извлеченный из сеанса терминала. |
Исключения
| Исключение | Описание |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
| Индекс поля выходит за границы. | Указывает, что индекс поля выходит за границы. |
| Подпись поля не найдена. | Указывает, что подпись поля не существует. |
| Положение экрана выходит за границы. | Указывает, что положение экрана выходит за границы. |
| Поле не найдено в данном положении. | Указывает, что поле не существует в данном положении. |
| Экран терминала неотформатирован. | Указывает, что экран терминала неотформатирован. |
| Эмулятор не поддерживает команды положений. | Указывает, что эмулятор не поддерживает использованные команды положений |
| Операция недоступна для этого типа сеанса. | Указывает, что операция недоступна для этого типа сеанса. |
Вставить текст в сеансе терминала
Задает текст в сеансе терминала.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session | Нет | Сеанс терминала | Сеанс терминала для работы | |
| Текст | Нет | Прямой ввод зашифрованного текста или Текстовое значение | Текст, который требуется вставить в указанное положение | |
| Set text | Неприменимо | Положение курсора, Поле | Поле | Положение, в которое требуется вставить текст. |
| Get field by | Н/Д | Метка, Индекс, Положение | Label | Указывает способ поиска поля. |
| Label | Нет | Текстовое значение | Подпись поля, которое требуется найти. | |
| Index | Нет | Числовое значение | Индекс поля на экране. | |
| Row | Нет | Числовое значение | Вертикальное положение поля на экране. | |
| Column | Нет | Числовое значение | Горизонтальное положение поля на экране. | |
| Treat @ character as literal | Неприменимо | Логическое значение | False | Установите этот флажок, чтобы отправить символ "@" буквально. Оставьте этот параметр отключенным, чтобы отправить его как специальный символ |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Описание: |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
| Индекс поля выходит за границы. | Указывает, что индекс поля выходит за границы. |
| Подпись поля не найдена. | Указывает, что подпись поля не существует. |
| Положение экрана выходит за границы. | Указывает, что положение экрана выходит за границы. |
| Поле не найдено в данном положении. | Указывает, что поле не существует в данном положении. |
| Экран терминала неотформатирован. | Указывает, что экран терминала неотформатирован. |
| Эмулятор не поддерживает команды положений. | Указывает, что эмулятор не поддерживает использованные команды положений |
| Операция недоступна для этого типа сеанса. | Указывает, что операция недоступна для этого типа сеанса. |
| Входной текст отклонен. | Указывает, что входной текст отклонен. |
Отправить клавишу в сеанс терминала
Отправляет нажатие клавиши управления в сеанс терминала.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session | Нет | Сеанс терминала | Сеанс терминала для работы. | |
| Control key | Н/Д | Передать, Курсор ALT, Внимание, Backspace, Вкладка "Назад", Переключатель блокировки, Прервать, Отмена, Центр, Сброс, Очистить связь, Очистить дисплей, Очистить строку, Очистить страницу, Очистить раздел, Запятая, Командная строка, Командное окно, Создать, Ctrl+F1, Ctrl+F2, Ctrl+F3, Ctrl+F4, Ctrl+F5, Ctrl+F6, Ctrl+F7, Ctrl+F8, Ctrl+F9, Ctrl+F10, Ctrl+F11, Ctrl+F12, Ctrl+Shift+F1, Ctrl+Shift+F2, Ctrl+Shift+F3, Ctrl+Shift+F4, Ctrl+Shift+F5, Ctrl+Shift+F6, Ctrl+Shift+F7, Ctrl+Shift+F8, Ctrl+Shift+F9, Ctrl+Shift+F10, Ctrl+Shift+F11, Ctrl+Shift+F12, Мигание курсора, Выбор курсора, Десятичное число, Удалить, Удалить символ, Удалить строку, Удалить слово, Необратимый возврат на один символ, Отсоединить, Выполнить, Вниз, Двойная вниз, Повтор, Дублировать, Изменить скрипт, Конец ключа, Конец поля, Удалить конец файла, Удалить EOL, Удалить EOP, Удалить входные данные, Escape, ExtGr, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F26, F27, F28, F29, F30, F31, F32, F33, F34, F35, F36, F37, F38, F39, F40, F41, F42, F43, F44, F45, F46, F47, F48, Разделитель полей, Выход поля, Пометка поля, Поле минус, Поле плюс, Найти, Аппаратный сброс, Справка, Шестнадцатеричное значение, Шестнадцатеричное значение 00, Шестнадцатеричное значение 01, Шестнадцатеричное значение 02, Шестнадцатеричное значение 03, Шестнадцатеричное значение 04, Шестнадцатеричное значение 05, Шестнадцатеричное значение 06, Шестнадцатеричное значение 07, Шестнадцатеричное значение 08, Шестнадцатеричное значение 09, Шестнадцатеричное значение 0A, Шестнадцатеричное значение 0B, Шестнадцатеричное значение 0C, Шестнадцатеричное значение 0D, Шестнадцатеричное значение 0E, Шестнадцатеричное значение 0F, Шестнадцатеричное значение 10, Шестнадцатеричное значение 11, Шестнадцатеричное значение 12, Шестнадцатеричное значение 13, Шестнадцатеричное значение 14, Шестнадцатеричное значение 15, Шестнадцатеричное значение 16, Шестнадцатеричное значение 17, Шестнадцатеричное значение 18, Шестнадцатеричное значение 19, Шестнадцатеричное значение 1A, Шестнадцатеричное значение 1B, Шестнадцатеричное значение 1C, Шестнадцатеричное значение 1D, Шестнадцатеричное значение 1E, Шестнадцатеричное значение 1F, Шестнадцатеричное значение 7F, Блокировать, Снять блокировку, Задать блокировку, Home, Home down, Home up, Вставить, Вставить символ, Вставить здесь, Вставить строку, Режим вставки, Недопустимый ключ, KeyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, Влево, Двойная влево, Перевод строки, Минус, Переключатель монитора, Новая строка, Следующая страница, Следующий экран, Следующее слово, Nul, NumLock, PA1, PA2, PA3, Страница, Page down, Page up, Сдвиг влево, Сдвиг вправо, Переход раздела, PF1, PF2, PF3, PF4, Plus Cr, Предыдущее слово, PrevPage, PrevScreen, Печать, Печать строки, Печать сообщения, Prent screen, Удалить, Заменить, Сброс, Возврат, Зарезервировать поле, Вправо, Двойная вправо, Свернуть вниз, Свернуть вверх, Строка правила, Выполнить скрипт, Прокрутить вниз, Прокрутить влево, Прокрутить вправо, Прокрутить вверх, Выбрать, Отправить, Отправить ответ обратно, Отправить удаление, Отправить строку, Отправить сообщение, Shift+Backspace, Shift+Delete, Shift+Down, Shift+F1, Shift+F2, Shift+F3, Shift+F4, Shift+F5, Shift+F6, Shift+F7, Shift+F8, Shift+F9, Shift+F10, Shift+F11, Shift+F12, Shift+F13, Shift+F14, Shift+F15, Shift F16, Shift+F17, Shift+F18, Shift+F19, Shift+F20, Shift+Home, Shift+Insert, Shift+Left, Shift+Print screen, Shift+Right, Shift+Up, Программный сброс, System request, Tab, Tek zoom, Завершить следующую страницу, Завершить предыдущую страницу, Тест, Текстовый помощник (начало, полужирный шрифт), Текстовый помощник (начало строки), Текстовый помощник (начало, подчеркивание), Текстовый помощник (нижняя часть страницы), Текстовый помощник (возврат каретки), Текстовый помощник (по центру), Текстовый помощник (конец, полужирный шрифт), Текстовый помощник (конец строки), Текстовый помощник (полиндекса вниз), Текстовый помощник (полиндекса вверх), Текстовый помощник (вставить символы), Текстовый помощник (следующая остановка), Текстовый помощник (следующий текстовый столбец), Текстовый помощник (конец страницы), Текстовый помощник (обязательный пробел), Текстовый помощник (обязательная вкладка), Текстовый помощник (остановка), Текстовый помощник (переход на следующую вкладку), Текстовый помощник (верхняя часть страницы), Текстовый помощник (подчеркивание слова), Переключатель трассировки, Udk 10, Udk 6, Udk 7, Udk 8, Udk 9, Udk 11, Udk 12, Udk 13, Udk 14, Udk 15, Udk 16, Udk 17, Udk 18, Udk 19, Udk 20, Вверх, Двойная вверх | Передать | Клавиша для отправки в сеанс. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Описание: |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
| Клавиша не поддерживается. | Указывает, что клавиша не поддерживается. |
Ожидать текст в сеансе терминала
Ожидает появления определенного текста в сеансе терминала.
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session | Нет | Сеанс терминала | Ранее открытый сеанс терминала. | |
| Text to wait for | Нет | Текстовое значение | Текст или регулярное выражение, отображения которого требуется ожидать на экране терминала или в указанном поле. | |
| Regular expression | Н/Д | Логическое значение | Ложь | Указывает, следует ли ждать регулярного выражения, а не обычного текста. |
| Wait for text location | Н/Д | Экран, Поле | Экран | Положение, в котором ожидается отображение текста. |
| Get field by | Н/Д | Метка, Индекс, Положение | Label | Указывает способ поиска поля. |
| Label | Нет | Текстовое значение | Подпись поля, которое требуется найти. | |
| Index | Нет | Числовое значение | Индекс поля, которое требуется найти. | |
| Row | Нет | Числовое значение | Вертикальное положение поля на экране. | |
| Column | Нет | Числовое значение | Горизонтальное положение поля на экране. | |
| Время ожидания | Да | Числовое значение | 0 | Максимальное время ожидания. |
Заметка
Механизм регулярных выражений Power Automate — .NET. Дополнительную информацию о регулярных выражениях см. в статье Язык регулярных выражений — краткий справочник.
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
| Исключение | Описание: |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
| Индекс поля выходит за границы. | Указывает, что индекс поля выходит за границы. |
| Подпись поля не найдена. | Указывает, что подпись поля не существует. |
| Положение экрана выходит за границы. | Указывает, что положение экрана выходит за границы. |
| Поле не найдено в данном положении. | Указывает, что поле не существует в данном положении. |
| Экран терминала неотформатирован. | Указывает, что экран терминала неотформатирован. |
| Эмулятор не поддерживает команды положений. | Указывает, что эмулятор не поддерживает использованные команды положений |
| Операция недоступна для этого типа сеанса. | Указывает, что операция недоступна для этого типа сеанса. |
| Время ожидания истекло. | Указывает, что время ожидания истекло. |
Поиск текста в сеансе терминала
Поиск всех повторов определенного текста в сеансе терминала
Входные параметры
| Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание: |
|---|---|---|---|---|
| Terminal session | Нет | Сеанс терминала | Ранее открытый сеанс терминала. | |
| Текст, который необходимо найти | Нет | Текстовое значение | Текст или регулярное выражение, поиск которых нужно выполнять на экране терминала | |
| Regular expression | Неприменимо | Логическое значение | False | Указывает, следует ли выполнять поиск регулярного выражения, а не обычного текста |
| Размер столбца | Нет | Числовое значение | 80 | Число столбцов на экране терминала |
Заметка
Механизм регулярных выражений Power Automate — .NET. Дополнительную информацию о регулярных выражениях см. в статье Язык регулярных выражений — краткий справочник.
Создаваемые переменные
| Аргумент | Type | Описание: |
|---|---|---|
| FindResults | Таблица данных | Результаты поиска, полученные с экрана сеанса терминала |
Исключения
| Исключение | Описание: |
|---|---|
| Ошибка связи с эмулятором. | Указывает на проблему при подключении к эмулятору. |
| Текст не найден | Указывает, что искомый текст не найден |
| Недопустимое регулярное выражение | Указывает, что использованное регулярное выражение недопустимо |