Дії емуляції терміналу
Power Automate забезпечує інтеграцію з емуляторами терміналів за допомогою дій емуляції терміналу. За допомогою цих дій ви можете працювати з терміналами та мейнфреймами, а також виконувати такі операції, як переміщення курсора, встановлення та отримання тексту, а також надсилання ключів.
Перш ніж розгортати будь-які дії термінала, скористайтеся дією Відкрити сеанс термінала, щоб відкрити нове з’єднання з встановленим провайдером.
Важливо
Перш ніж намагатися підключитися до термінального сеансу, переконайтеся, що фактичний сеанс термінала вже відкрито на вашому комп’ютері.
Якщо ви встановили Micro Focus Reflection на своєму комп’ютері, виберіть відповідну опцію в параметрі Постачальник дії та заповніть необхідну конфігурацію.
Якщо ви встановили іншого провайдера, виберіть HLAPI , який працює з більшістю постачальників емуляції терміналів.
Залежно від провайдера, яким ви користуєтеся, виберіть відповідний файл HLLAPI DLL, розташований у папці інсталяції. У наведеному нижче списку можна побачити імена файлів HLLAPI DLL деяких популярних постачальників емуляції терміналів:
- RocketSoftware BlueZone: ehlapi64.dll
- Особисті комунікації IBM: EHLAPI32.dll
- MicroFocus Rumba: System/ehlapi32. Длл
- Cybelesoft zScope: zHllap32.dll
Нотатка
Бібліотека Windows HLLAPI DLL (WinHLLAPI) наразі не підтримується.
Після відкриття термінального сеансу та виконання всіх потрібних операцій завершіть з’єднання за допомогою дії Закрити сеанс термінала. Якщо не закрити з’єднання, деякі провайдери не дозволять вам знову підключитися до вже відкритого сеансу без перезапуску програмного забезпечення або підключення.
Відкрити сеанс термінала
Відкриття нового сеансу термінала.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Постачальник | Немає | Мікрофокусне відображення, HLLAPI | Мікрофокусне відбиття | Емуляція термінала, яку необхідно використовувати |
| Шлях до HLLAPI DLL | No | Файл | HLLAPI DLL провайдера. RocketSoftware BlueZone Назва за замовчуванням: ’ehlapi64.dll’. Ім’я IBM Personal Communications за замовчуванням: ’EHLAPI32.dll’. Шлях MicroFocus Rumba за замовчуванням: ’System/ehlapi32. Длл’. Ім’я за замовчуванням Cybelesoft zScope: ’zHllap32.dll’. Будь-який інший провайдер, який пропонує бібліотеку HLLAPI DLL у своїй папці встановлення. | |
| Шлях для інсталяції | No | Папку | Шлях для інсталяції програми постачальника у файловій системі користувача | |
| Конфігурація | Немає | Існуючий профіль, Вкажіть підключення | Наявний профіль | Виберіть «Існуючий профіль», щоб вибрати файл, що містить попередньо налаштоване з’єднання емуляції терміналу. Виберіть «Вказати підключення», щоб вказати тип з’єднання, адресу хоста та порт. |
| Ім’я сеансу | No | Текстове значення | Назва сеансу, до якого потрібно підключитися. Коротка назва HLLAPI і це унікальний ідентифікатор хост-сесії. Його можна знайти в налаштуваннях конфігурації емулятора терміналу. | |
| Тип хоста | Немає | IBM 3270, IBM 5250 | IBM 3270 | Тип хоста підключення |
| Профіль | No | Файл | Файл, який містить попередньо налаштоване підключення | |
| Адреса хоста | No | Текстове значення | Адреса хоста, до якого необхідно підключитися | |
| Порт | No | Числове значення | Порт, який буде використано для цього з’єднання | |
| Підключитися до запущеного сеансу | Немає | Логічне значення | Ні | Указує, чи слід підключатися до сеансу термінала, який наразі відкритий або виконується |
Змінні, які створюються
| Аргумент | Ввести | Опис |
|---|---|---|
| TerminalSession (Терміналальна сесія) | Термінальна сесія | Певний сеанс термінала для використання з наступними командами емуляції термінала |
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
| Помилка профілю | Помилка профілю |
Закрити сеанс термінала
Закриття відкритого сеансу термінала.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала для закриття | No | Термінальна сесія | Раніше відкритий сеанс термінала |
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
Перемістити курсор до сеансу термінала
Перемістити курсор термінала до вказаного розташування.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала | No | Термінальна сесія | Сеанс термінала для роботи | |
| Рядок | No | Числове значення | Вертикальне розташування курсору на екрані | |
| Column | No | Числове значення | Горизонтальне розташування курсору на екрані |
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
| Виняток | Опис |
|---|---|
| Розташування екрана поза межами | Указує, що розташування екрана виходить за межі |
| Емулятор не підтримує команди розташування | Вказує на те, що використовувані команди позицій не підтримуються емулятором |
| Операція недоступна для цього типу сеансу | Указує, що операція недоступна для цього типу сеансу |
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
Отримати текст із сеансу термінала
Отримати текст із сеансу термінала.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала | No | Термінальна сесія | Сеанс термінала для роботи | |
| Отримати текст із | Немає | Поле, Увесь екран, Положення курсора, Певне положення | Поле | Розташування для отримання тексту з |
| Отримати поле за | Немає | Мітка, індекс, позиція | Надпис | Указує, як шукати поле |
| Надпис | No | Текстове значення | Підпис поля, яке необхідно знайти | |
| Індекс | No | Числове значення | Індекс поля, яке необхідно знайти | |
| Довжина тексту | No | Числове значення | Довжина тексту, який необхідно отримати | |
| Рядок | No | Числове значення | Вертикальне розташування поля на екрані | |
| Column | No | Числове значення | Горизонтальне розташування поля на екрані |
Змінні, які створюються
| Аргумент | Ввести | Опис |
|---|---|---|
| TerminalText (Текст терміналу) | Текстове значення | Текст, отриманий із сеансу термінала |
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
| Індекс поля поза межами | Указує, що індекс поля виходить за межі |
| Підпис поля не знайдено | Указує, що підпис поля не існує |
| Розташування екрана поза межами | Указує, що розташування екрана виходить за межі |
| В указаному розташуванні не знайдено поле | Указує, що в зазначеному розташуванні відсутнє поле |
| Екран термінала невідформатовано | Указує, що екран термінала невідформатовано |
| Емулятор не підтримує команди розташування | Вказує на те, що використовувані команди позицій не підтримуються емулятором |
| Операція недоступна для цього типу сеансу | Указує, що операція недоступна для цього типу сеансу |
Вставити текст у сеансі термінала
Вставити текст у сеансі термінала.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала | No | Термінальна сесія | Сеанс термінала для роботи | |
| SMS | No | Пряме зашифроване введення або текстове значення | Текст, який необхідно вставити у визначене розташування | |
| Вставити текст | Немає | Позиція курсора, поле | Поле | Розташування, у яке необхідно вставити текст |
| Отримати поле за | Немає | Мітка, індекс, позиція | Надпис | Указує спосіб пошуку поля |
| Надпис | No | Текстове значення | Підпис поля, яке необхідно знайти | |
| Індекс | No | Числове значення | Індекс поля на екрані | |
| Рядок | No | Числове значення | Вертикальне розташування поля на екрані | |
| Column | No | Числове значення | Горизонтальне розташування поля на екрані | |
| Розглядати символ @ як буквальний | Немає | Логічне значення | Ні | Позначте цей прапорець, щоб надіслати символ «@» буквально. Залиште цю опцію вимкненою, щоб надіслати її як спеціальний символ |
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
| Індекс поля поза межами | Указує, що індекс поля виходить за межі |
| Підпис поля не знайдено | Указує, що підпис поля не існує |
| Розташування екрана поза межами | Указує, що розташування екрана виходить за межі |
| В указаному розташуванні не знайдено поле | Указує, що в зазначеному розташуванні відсутнє поле |
| Екран термінала невідформатовано | Указує, що екран термінала невідформатовано |
| Емулятор не підтримує команди розташування | Вказує на те, що використовувані команди позицій не підтримуються емулятором |
| Операція недоступна для цього типу сеансу | Указує, що операція недоступна для цього типу сеансу |
| Вхідний текст відхилено | Указує, що вхідний текст відхилено |
Надіслати клавішу до сеансу термінала
Надсилання клавіші керування до сеансу термінала.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала | No | Термінальна сесія | Сеанс термінала для роботи | |
| Клавіша керування | Немає | Передавання, Курсор 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, Курсор блимає, Виділення курсора, Десятковий рядок, Видалити, Видалити символ, Видалити рядок, Видалити слово, Деструктивний пробіл, Від’єднати, Зробити, Вниз, Вниз подвійний, Дублювати, Дублювати, Редагувати сценарій, Кінець поля, Кінець поля, Стерти EOF, Стерти 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, Шестигранник 0А, Шестигранник 0В, Шестигранник 0С, Шестигранник 0D, Шестигранник 0E, Шестигранник 0Ф, Шестигранник 10, Шестигранник 11, шестигранник 12, шестигранник 13, шестигранник 14, шестигранник 15, шестигранник 16, шестигранник 17, шестигранник 18, шестигранник 19, шестигранник 1A, шестигранник 1B, шестигранник 1C, шестигранник 1D, шестигранник 1E, шестигранник 1F, шестигранник 7F, утримання, утримання, набір, дім, дім, дім, вставити, вставити, вставити char, вставити тут, вставити рядок, режим вставки, недійсний ключ, keyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, Ліворуч, Лівий подвійний, Переведення рядка, Мінус, Перемикач монітора, Новий рядок, Наступна сторінка, Наступний екран, Наступне слово, Nul, NumLock, PA1, PA2, PA3, Сторінка, Сторінка вниз, Сторінка вгору, Панорамування ліворуч, Панорамування праворуч, Перехід між розділами, PF1, PF2, PF3, PF4, Плюс Cr, Попереднє слово, Попередня сторінка, Попередній екран, Друк, Рядок друку, Друк тексту, Екран Prent, Видалити, Замінити, Скинути, Повернути, Резервне поле, Правий, Подвійний, Згорнути вниз, Згорнути, Рядок Rile, Виконати сценарій, Прокрутити вниз, Прокрутити вліво, Прокрутити вправо, Прокрутити вгору, Вибрати, Надіслати, Надіслати відповідь назад, Надіслати видалення, Надіслати рядок, Надіслати повідомлення, 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+Left, Shift+Print screen, Shift+Right, Shift+Up, М’яке скидання, Системний запит, Tab, Tek zoom, Термін наступної сторінки, Попередня сторінка терміну, Тест, Текстова допомога починається жирним шрифтом, Текстовий допоміжний початок рядка, Текстовий помічник на початку підкреслення, Текстовий помічник внизу сторінки, Текстовий допоміжний носій повернення, Текстовий допоміжний центр, Текстовий допоміжний кінець виділено жирним шрифтом, Текстовий допоміжний кінець рядка, Текстовий помічник половина індексу вниз, Текстовий помічник половина індексу вгору, Текстовий помічник вставити символи, Текстова допомога наступна зупинка, Текстовий допоміжний наступний текстовий стовпець, Текстовий допоміжний кінець сторінки, Текстовий помічник потрібне місце, Текстова допоміжна вкладка, Текстова допоміжна зупинка, Текстова допоміжна текстова вкладка вперед, Текстовий помічник на початку сторінки, Підкреслення текстового слова, Перемикач трасування, Удк 10, Удк 6, Удк 7, Удк 8, Удк 9, Удк 11, Удк 12, Удк 13, Удк 14, Удк 15, Удк 16, Удк 17, Удк 18, Удк 19, Удк 20, Вгору, вгору подвійно | Передати | Клавіша для надсилання до сеансу |
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
| Ключ не підтримується | Указує, що ключ не підтримується |
Очікувати текст у сеансі термінала
Очікування відображення певного тексту в сеансі термінала.
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала | No | Термінальна сесія | Раніше відкритий сеанс термінала | |
| Очікуваний текст | No | Текстове значення | Текст або регулярний вираз, відображення якого необхідно очікувати на екрані термінала або в указаному полі. | |
| Регулярний вираз | Немає | Логічне значення | Ні | Указує, чи очікувати на регулярний вираз замість звичайного тексту |
| Розташування очікуваного тексту | Немає | Екран, поле | Екран | Розташування, у якому очікується відображення тексту |
| Отримати поле за | Немає | Мітка, індекс, позиція | Надпис | Указує спосіб пошуку поля |
| Надпис | No | Текстове значення | Підпис поля, яке необхідно знайти | |
| Індекс | No | Числове значення | Індекс поля, яке необхідно знайти | |
| Рядок | No | Числове значення | Вертикальне розташування поля на екрані | |
| Column | No | Числове значення | Горизонтальне розташування поля на екрані | |
| Час очікування | Так | Числове значення | 0 | Максимальний час очікування |
Нотатка
Power AutomateРушієм регулярних виразів є .NET. Щоб дізнатися більше про регулярні вирази, перейдіть до розділу Мова регулярних виразів - Короткий довідник.
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
| Індекс поля поза межами | Указує, що індекс поля виходить за межі |
| Підпис поля не знайдено | Указує, що підпис поля не існує |
| Розташування екрана поза межами | Указує, що розташування екрана виходить за межі |
| В указаному розташуванні не знайдено поле | Указує, що в зазначеному розташуванні відсутнє поле |
| Екран термінала невідформатовано | Указує, що екран термінала невідформатовано |
| Емулятор не підтримує команди розташування | Вказує на те, що використовувані команди позицій не підтримуються емулятором |
| Операція недоступна для цього типу сеансу | Указує, що операція недоступна для цього типу сеансу |
| Час очікування вичерпано | Указує, що час очікування вичерпано |
Шукати текст у сеансі термінала
Пошук усіх випадків певного тексту в сеансі термінала
Вхідні параметри
| Аргумент | Необов'язково | Приймає | Значення за замовчуванням | Опис |
|---|---|---|---|---|
| Сеанс термінала | No | Термінальна сесія | Раніше відкритий сеанс термінала | |
| Текст для пошуку | No | Текстове значення | Текст або регулярний вираз, який потрібно шукати на екрані термінала | |
| Регулярний вираз | Немає | Логічне значення | Ні | Указує, чи шукати регулярний вираз замість звичайного тексту |
| Розмір стовпця | No | Числове значення | 80 | Кількість стовпців на екрані термінала |
Нотатка
Power AutomateРушієм регулярних виразів є .NET. Щоб дізнатися більше про регулярні вирази, перейдіть до розділу Мова регулярних виразів - Короткий довідник.
Змінні, які створюються
| Аргумент | Ввести | Опис |
|---|---|---|
| Знайти результати | Таблиця даних | Результати пошуку, отримані з екрана сеансу термінала |
Винятки
| Виняток | Опис |
|---|---|
| Помилка зв’язку з емулятором | Указує на проблему під час підключення до емулятора |
| Текст не знайдено | Вказує на те, що текст для пошуку не знайдено |
| Неприпустимий регулярний вираз | Вказує на те, що використаний формальний вираз недійсний |