终端会话

UiPath.Terminal.Activities.TerminalSession

连接到终端并允许您在其中执行多个操作的容器。 将活动拖入工作流设计器后，系统将打开“ 配置连接 ” 窗口。 如果已关闭，则可以使用活动正文中的“ 配置连接...” 按钮将其重新打开。

建立连接后，可以使用“ 启动记录器 ”按钮连接到终端并记录必要的操作。 该按钮将放置在活动的主体中。

属性

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  注意：如果Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。
• “显示名称”- 活动的显示名称。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

新建会话

• “连接字符串”- 包含连接详细信息的字符串。 此字段仅支持字符串和String变量。
• 输出连接- 已建立的连接，存储在TerminalSession变量中。 如果要重用已建立的连接，则可以将此变量传递给“ 现有连接 ” 属性字段中的其他 终端会话 活动。此字段仅支持TerminalSession变量。

选项

• “延迟MS” - 活动开始执行任何操作之前的延迟时间（以毫秒为单位）。 默认值为 1000 毫秒 (1 秒)。
• “超时 MS” - 指定在引发错误之前等待活动运行的时间（以毫秒为单位）。 默认值为 50000 毫秒 (50 秒)。

SSH 连接属性

• SSH 密码 - 用于连接到指定终端的 SecureShell 密码，存储在 SecureString 变量中。 此字段仅支持 SecureString 变量。
• SSH 用户 名 - 用于连接到指定终端的 SecureShell 用户名，存储在 String 变量中。 此字段仅支持字符串和 String 变量。

使用现有连接

• “关闭连接” - 如果选中该复选框，则在活动停止执行后将关闭现有连接。 默认情况下，该复选框处于选中状态。 请注意，如果已设置“输出连接”属性，则系统会忽略此属性。
• 现有连接- 在此属性字段中提供TerminalSession变量，即可使用变量中存储的连接来连接到终端。 此字段仅支持TerminalSession变量。

“配置连接” 窗口

“配置连接” 窗口包含各种配置选项，这些选项因选择用于连接到终端环境的提供程序类型而异。

独立于所选提供程序的属性:

• “显示客户端应用程序” - 如果选中，则在运行时显示终端屏幕的视图。

直接连接提供程序

直接连接提供程序是 UiPath 内部提供程序，不需要机器人计算机上的任何第三方终端仿真软件。 仿真由机器人在运行时完成。

配置属性:

• 地址- 终端环境系统的 IP 地址或主机名。
• “端口” - 终端环境系统接受连接的端口号。

• “类型” - 所需终端模拟的类型：

  • TN3270 - 通常由 IBM Z 系列系统使用
  • TN5250 - 通常由 IBM I 系列系统 (AS-400) 使用
  • VT - DEC VT 兼容终端
  • HP 系列- HP 特定终端仿真
  • Tandem - Tandem 系统终端模拟
  • Wyse - Wyse 系列终端模拟
  • ANSI - 基于 ANSI 规范的终端仿真
  • Cisco ANSI - SCO Unix 系统使用的 ANSI 规范扩展

• “协议” - 用于连接的通信协议：

  • TELNET - TELNET 协议
  • SSH - 大多数 Unix/Linux 系统使用的 SSH 协议
  • HPVT - 与 HP 系列终端模拟一起使用的 HP 特定协议
• 终端模式- 终端模拟的特定风格。 此处可用的值取决于在“类型” 字段中选择的值。
• “编码” - 终端环境系统使用的代码页。 对于 IBM 系列终端，默认值为 IBM037，对于其他类型的终端，默认值为 ASCII。
• 启用 SSL/TLS - 与远程登录协议一起使用，以指定终端环境系统使用 SSL 或 TLS 加密连接。
• LU 名称- 逻辑单元名称，与 IBM 系列终端类型一起使用。
• “应答” - 终端收到ENQ控制字符时要发送到主机系统的文本消息。 消息可以包含 Enter 控件键，在字符串值中编码为^M 。 仅当所选终端类型为VT时，此配置选项才可用。

IBM EHLLAPI 提供程序

IBM EHLLAPI 提供程序可与任何实现 EHLL API 的第三方终端仿真软件一起使用。 有关 EHLL API 实施的详细信息，请参阅第 3 方终端仿真器软件文档。

注意： 在尝试通过 EHLLAPI 连接之前，需要启动并连接终端仿真软件。

配置属性:

• EHLL dll - 在第三方终端仿真器软件中用于实现 EHLLAPI 的 dll 的路径。
• EHLL 函数- EHLL dll中入口点函数的名称。 通常为“hllapi”。
• EHLL 会话- 终端模拟软件中显示的会话名称。 通常为“A”，但当同时使用多个会话时，该值可能会有所不同。
• “EHLL 编码” - 终端模拟软件对给定连接使用的编码。
• EHLL 增强型- 用于指定第三方终端模拟器实现 EHLL API 的标准版本或增强版本。
• “编码” - 终端环境系统使用的代码页。 对于 IBM 系列终端，默认值为 IBM037，对于其他类型的终端，默认值为 ASCII。
• 基本模式- 此模式可禁用字段级别处理，以提高性能。 请注意，字段级别活动（“获取字段”、“设置字段”等）在此模式下不起作用。
• 在进程中运行- 控制通过 EHLL API 与第三方终端模拟进行通信的方式。 默认情况下，此功能处于禁用状态，在这种情况下，通信是通过代理进程完成的，代理进程是终端活动包中的另一个可执行文件。 在运行时，代理进程将通过 IPC（进程间通信）与 UiPath 执行程序进程通信。 启用后，在 UiPath 执行程序进程内与第三方终端模拟软件进行通信。 仅当防病毒软件或软件安全策略阻止代理进程正常运行时，才应启用此选项。

注意：由于EHLLAPI规范中的限制，增强版 EHLLAPI 不支持在选中“在进程中运行”选项时使用多个 EHLLAPI 会话。 只有 EHLLAPI 的标准实现支持这种场景。 这意味着未选中EHLL 增强选项，并且“ EHLL DLL ”字段中列出的 DLL 文件是实现标准 EHLLAPI 规范的版本。

Attachmate 反射提供程序

Attachmate 反射 提供程序与 Attachmate 反射终端模拟器一起使用。

配置属性:

• “附加到现有会话” - 在此模式下，终端模拟器应已启动并连接。 在这种情况下，不会使用任何配置文件。
• “使用现有配置文件” - 在此模式下，需要提供配置描述文件的路径。 终端模拟器将自动启动。

• “手动指定地址” - 在此模式下，将不使用任何配置文件。 需要手动指定配置属性：

  • 地址 - 终端环境系统的 IP 地址或主机名
  • 端口 - 终端环境系统接受连接的端口号

  • “类型” - 所需终端模拟的类型：

    • TN3270
    • TN5250
    • VT

Attachmate Extra 提供程序

Attachmate Extra 提供程序与 Attachmate Extra 一起使用！终端模拟器。

配置属性:

• “使用现有配置文件”- 需要提供配置描述文件的路径。 终端模拟器将自动启动。

UNIX 提供程序的反射

Reflection for UNIX 提供程序与 Reflection for Unix 终端模拟器一起使用。

配置属性:

• “使用现有配置文件”- 需要提供配置描述文件的路径。 终端模拟器将自动启动。

IBM 提供程序的反射

Reflection for IBM 提供程序与 Reflection for IBM 终端模拟器一起使用。

配置属性:

• “使用现有配置文件” - 在此模式下，需要提供配置描述文件的路径。 终端模拟器将自动启动。

• “手动指定地址” - 在此模式下，将不使用任何配置文件。 需要手动指定配置属性：

  • 地址 - 终端环境系统的 IP 地址或主机名
  • 端口 - 终端环境系统接受连接的端口号

  • “类型” - 所需终端模拟的类型：

    • TN3270
    • TN5250
    • VT

Rocket BlueZone 提供程序

Rocket BlueZone 提供程序与 Rocket BlueZone 终端模拟器一起使用。

配置属性:

• “使用现有配置文件” - 在此模式下，需要提供配置描述文件的路径。 终端模拟器将自动启动。

• “手动指定地址” - 在此模式下，将不使用任何配置文件。 需要手动指定配置属性：

  • 地址 - 终端环境系统的 IP 地址或主机名。
  • “端口” - 终端环境系统接受连接的端口号。

  • “类型” - 所需终端模拟的类型：

    • TN3270
    • TN5250
    • VT

IBM 个人通信提供程序

IBM Personal Communications 提供程序与 IBM Personal Communications 终端模拟器一起使用。

配置属性:

• “使用现有配置文件” - 在此模式下，需要提供配置描述文件的路径。 终端模拟器将自动启动。

终端活动最佳实践

• 使用“输出连接”/“现有连接”属性时，请确保在工作流/流程不再需要终端会话时将其关闭。 让终端会话保持打开状态可能会对性能和其他终端会话的执行产生不利影响。 要正确关闭先前保存的终端会话，请在工作流中添加一个新的终端会话（正文为空），并具有以下属性：
  • 关闭连接: True
  • 现有连接：包含已保存会话的终端会话变量
• 避免将“输出连接”/“现有连接”属性与IBM EHLLAPI提供程序结合使用。 这些选项用于确保工作流之间的连接持久性。 由于连接已在终端模拟器中保留，因此不需要第二层暂留。 此外，这还可以避免如上所述必须执行额外的步骤来关闭连接。
• 避免使用嵌套在其他终端会话中的终端会话。 这也适用于间接嵌套，例如从终端会话主体调用包含具有相同连接的终端会话的工作流，或调用包含具有相同连接的终端会话的库函数。
• 避免使用基于字段的活动，例如获取字段 /设置字段。 屏幕是否或如何拆分为多个字段并不总是很清楚，这可能会导致混淆。 此外，由于使用的 API 不同，不同的提供程序可能会以不同的方式拆分同一屏幕。 更安全的做法是使用与人类使用方法相似的方法，例如组合使用“移动光标” 或“发送控制键 = Tab ” 活动，然后使用“发送键”活动将数据发送到屏幕。 要从屏幕上检索数据，请使用“获取屏幕区域”或“获取指定位置的文本” 。
• 使用“ 等待屏幕文本” 活动确保已加载正确的屏幕，然后再对其执行任何操作
• 要从屏幕中提取数据表格式的表格数据，请对包含表格的屏幕部分使用“ 获取屏幕区域” 活动，并将此活动的输出用作 UiPath.System.Activities 包中“ 生成数据表 ”活动的输入.