终端仿真操作
Power Automate 通过终端仿真操作提供与终端仿真器的集成。 这些操作使您能够处理终端和大型机并执行操作，例如移动光标、设置和获取文本以及发送密钥。
在部署任何终端操作之前，请使用打开终端会话操作打开与已安装提供程序的新连接。
重要提示
在尝试连接到终端会话之前，请确保已在您的计算机上打开了实际终端会话。
如果您在计算机上安装了 Micro Focus Reflection，请在操作的提供程序参数中选择相应的选项并填充所需的配置。
如果您已安装其他提供程序，请选择适用于大多数终端仿真提供程序的 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 | 不适用 | 微焦点反射、HLLAPI | 微焦点反射 | 要使用的终端仿真 |
| HLLAPI DLL path | 否 | 文件 | 提供程序的 HLLAPI DLL。 RocketSoftware BlueZone 默认名称：“ehlapi64.dll”。 IBM Personal Communications 默认名称：“EHLAPI32.dll”。 MicroFocus Rumba 默认路径：“System/ehlapi32.Dll”。 Cybelesoft zScope 默认名称：“zHllap32.dll”。 在安装文件夹中提供 HLLAPI DLL 的任何其他提供程序。 | |
| Installation path | 否 | 文件夹 | 提供程序的应用程序在用户文件系统上的安装路径 | |
| Configuration | 不适用 | 现有配置文件、指定连接 | 现有配置文件 | 选择“现有配置文件”以选择包含预配置终端仿真连接的文件。 选择“指定连接”以指定连接类型、主机地址和端口。 |
| Session name | 否 | 文本值 | 要连接到的会话名称。 HLLAPI 短名称，它是主机会话的唯一标识符。 可以在终端仿真器的配置设置中找到它。 | |
| Host type | 不适用 | IBM 3270、IBM 5250 | IBM 3270 | 连接的主机类型 |
| Profile | 否 | 文件 | 包含预配置连接的文件 | |
| Host address | 否 | 文本值 | 要连接到的主机的地址 | |
| Port | 否 | 数值 | 要用于此连接的端口 | |
| Attach to running session | 不适用 | 布尔值 | 假 | 指定是否附加到当前打开/运行的终端会话 |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| TerminalSession | 终端会话 | 与稍后的终端仿真命令一起使用的特定终端会话 |
异常
| 例外 | 描述 |
|---|---|
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
| 配置文件错误 | 配置文件错误 |
关闭终端会话
关闭打开的终端会话。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Terminal session to close | 否 | 终端会话 | 先前打开的终端会话 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
移动终端会话上的光标
将终端的光标移至指定位置。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Terminal session | 否 | 终端会话 | 要处理的终端会话 | |
| Row | 否 | 数值 | 屏幕上光标的垂直位置 | |
| Column | 否 | 数值 | 屏幕上光标的水平位置 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 屏幕位置超出界限 | 指示屏幕位置超出界限 |
| 仿真器不支持位置命令 | 指示仿真器不支持使用的位置命令 |
| 操作不适用于此会话类型 | 指示该操作不适用于此会话类型 |
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
从终端会话获取文本
从终端会话获取文本。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Terminal session | 否 | 终端会话 | 要处理的终端会话 | |
| Get text from | 不适用 | 字段、整个屏幕、光标位置、特定位置 | 字段 | 要从中获取文本的位置 |
| Get field by | 不适用 | 标签、索引、位置 | Label | 指定如何查找字段 |
| Label | 否 | 文本值 | 要查找的字段的标签 | |
| Index | 否 | 数值 | 要查找的字段的索引 | |
| Text length | 否 | 数值 | 要接收的文本的长度 | |
| Row | 否 | 数值 | 屏幕上字段的垂直位置 | |
| Column | 否 | 数值 | 屏幕上字段的水平位置 |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| TerminalText | 文本值 | 从终端会话检索到的文本 |
异常
| 例外 | 描述 |
|---|---|
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
| 字段索引超出界限 | 指示字段索引超出界限 |
| 找不到字段标签 | 指示字段标签不存在 |
| 屏幕位置超出界限 | 指示屏幕位置超出界限 |
| 在给定位置找不到字段 | 指示在给定位置不存在任何字段 |
| 终端屏幕未格式化 | 指示终端屏幕未格式化 |
| 仿真器不支持位置命令 | 指示仿真器不支持使用的位置命令 |
| 操作不适用于此会话类型 | 指示该操作不适用于此会话类型 |
在终端会话上设置文本
在终端会话上设置文本。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Terminal session | 否 | 终端会话 | 要处理的终端会话 | |
| 文本 | 否 | 直接加密的输入或文本值 | 要在指定位置设置的文本 | |
| 设置文本 | 不适用 | 光标位置、字段 | 字段 | 要将文本设置到的位置 |
| Get field by | 不适用 | 标签、索引、位置 | Label | 指定查找字段的方式 |
| Label | 否 | 文本值 | 要查找的字段的标签 | |
| Index | 否 | 数值 | 屏幕上字段的索引 | |
| Row | 否 | 数值 | 屏幕上字段的垂直位置 | |
| Column | 否 | 数值 | 屏幕上字段的水平位置 | |
| Treat @ character as literal | 不可用 | 布尔值 | 错误 | 选中此框可将“@”字符作为文本发送。 将此选项保留禁用状态可将其作为特殊字符发送 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
| 字段索引超出界限 | 指示字段索引超出界限 |
| 找不到字段标签 | 指示字段标签不存在 |
| 屏幕位置超出界限 | 指示屏幕位置超出界限 |
| 在给定位置找不到字段 | 指示在给定位置不存在任何字段 |
| 终端屏幕未格式化 | 指示终端屏幕未格式化 |
| 仿真器不支持位置命令 | 指示仿真器不支持使用的位置命令 |
| 操作不适用于此会话类型 | 指示该操作不适用于此会话类型 |
| 输入文本被拒绝 | 表示输入文本已被拒绝 |
将密钥发送到终端会话
将控制密钥发送到终端会话。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| 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、光标闪烁、光标选择、小数、删除、删除字符、删除行、删除字词、破坏性退格、断开连接、执行、向下箭头键、下双线、Dup、复制、编辑脚本、键结束、字段末尾、清除 EOF、清除 EOL、清除 EOP、清除输入、Esc 键、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、保留、保留项清除、保留项设置、主页、主页向下、主页向上、插入、插入字符、在此处插入、插入行、插入模式、无效键、小键盘 0、小键盘 1、小键盘 2、小键盘 3、小键盘 4、小键盘 5、小键盘 6、小键盘 7、小键盘 8、小键盘 9、向左箭头键、左方双线、换行、减、显示器切换、新行、下一页、下一屏幕、下一字词、Nul、NumLock、PA1、PA2、PA3、页、向下翻页、向上翻页、向左平移、向右平移、分区跳转、PF1、PF2、PF3、PF4、Plus Cr、上一字词、PrevPage、PrevScreen、打印、打印行、打印消息、打印屏幕、移除、替换、重置、返回、保留字段、向右箭头键、右方双线、向下滚动、向上滚动、基准线、运行脚本、向下滚动、向左滚动、向右滚动、向上滚动、选择、发送、发回答案、发送删除、发送行、发送消息、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、软重置、系统请求、制表符、Tek 缩放、下一页术语、上一页术语、测试、文本辅助开始加粗、文本辅助行首、文本辅助开始下划线、文本辅助页面底部、文本辅助载体返回、文本辅助居中、文本辅助结束加粗、文本辅助行尾、文本辅助一半索引向下、文本辅助一半索引向上、文本辅助插入符号、文本辅助下一停止、文本辅助下一文本列、文本辅助页面结束、文本辅助所需空间、文本辅助所需选项卡、文本辅助停止、文本辅助文本选项卡高级、文本辅助页面顶部、文本辅助文字下划线、跟踪切换、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 | 否 | 数值 | 屏幕上字段的水平位置 | |
| Timeout | 是 | 数值 | 12 | 最长等待时间 |
备注
Power Automate 的正则表达式引擎是 .NET。 要查找有关正则表达式的详细信息，请转到正则表达式语言 - 快速参考。
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
| 字段索引超出界限 | 指示字段索引超出界限 |
| 找不到字段标签 | 指示字段标签不存在 |
| 屏幕位置超出界限 | 指示屏幕位置超出界限 |
| 在给定位置找不到字段 | 指示在给定位置不存在任何字段 |
| 终端屏幕未格式化 | 指示终端屏幕未格式化 |
| 仿真器不支持位置命令 | 指示仿真器不支持使用的位置命令 |
| 操作不适用于此会话类型 | 指示该操作不适用于此会话类型 |
| 已超时 | 指示已超时 |
在终端会话中搜索文本
在终端会话中搜索所有出现的特定文本
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Terminal session | 否 | 终端会话 | 先前打开的终端会话 | |
| 要搜索的文本 | 否 | 文本值 | 要在终端屏幕上搜索的文本或正则表达式 | |
| Regular expression | 不可用 | 布尔值 | 错误 | 指定是否搜索正则表达式而不是纯文本 |
| 列大小 | 否 | 数值 | 80 | 终端屏幕上的列数 |
备注
Power Automate 的正则表达式引擎是 .NET。 要查找有关正则表达式的详细信息，请转到正则表达式语言 - 快速参考。
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| FindResults | 数据表 | 从终端会话屏幕检索的搜索结果 |
异常
| 例外 | 说明 |
|---|---|
| 与仿真器通信时出错 | 指示连接到仿真器时出现问题 |
| 找不到文本 | 指示未找到要搜索的文本 |
| 正则表达式无效 | 指示所使用的正则表达式无效 |