终端会话

UiPath.Terminal.Activities.TerminalSession

描述

A container that connects to a terminal and enables you to perform multiple actions within it.

项目兼容性

Windows - 旧版 | Windows

配置

设计器面板

• 配置连接... - 用于设置连接。将活动拖动到工作流设计器后，将打开“配置连接”窗口。如果已关闭，则可以使用此选项将其重新打开。
• 启动录制器 - 设置连接后，可使用“启动录制器”按钮连接到终端并录制必要的操作。

属性面板

常见

• 出错时继续 - 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(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 规范的终端仿真。
  • Sco 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时，此配置选项才可用。
• 代理类型 - 代理服务器使用的协议类型：
  • 无（默认）- 无代理
  • 隧道 - HTTPS 代理。
  • SOCKS4
  • SOCKS5
  • SOCKS4A
• 代理主机 - 代理服务器的 IP 地址或主机名。
• 代理端口 - 代理服务器使用的端口号。
• 代理用户 - 用于在代理服务器上进行身份验证的用户名。
• 代理密码 - 用于在代理服务器上进行身份验证的密码。

注意：直接连接提供程序使用未经 UiPath 签名的原生 DLL 库。该库名为 ttermdotnet.dll。如果使用此提供程序，则需要允许加载和执行此库。

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 执行程序的进程内与第三方终端模拟软件进行通信。仅当杀毒软件或软件安全策略阻止代理进程正常运行时，才应启用此选项。
  注意：将“在流程中运行”参数更改为 True 可能会导致终端会话无法正常工作，原因是第三方模拟器和 UiPath Studio/执行程序进程之间的架构差异（32 位与 64 位）。32 位 EHLL 库仅在“Windows - 旧版”项目中正常运行，而 64 位 EHLL 库仅在“Windows”项目中正常运行。

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

Attachmate 反射提供程序

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

仅适用于“Windows - 旧版”项目。

连接设置

• 附加到现有会话 - 在此模式下，终端模拟器应已启动并连接。在这种情况下，不使用配置文件。
• 使用现有配置文件 - 在此模式下，需要提供配置描述文件的路径。终端模拟器会自动启动。
• 手动指定地址 - 在此模式下，不使用配置文件。需要手动指定配置属性：
  • 地址 - 终端环境系统的 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 终端模拟器一起使用。

连接设置

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