终端会话

UiPath.Terminal.Activities.TerminalSession

描述

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

项目兼容性

Windows - Legacy | Windows

配置

设计器面板

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

属性面板

常见

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

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

• “显示名称”- 活动的显示名称。

其他

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

新建会话

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

选项

• DelayMS - Delay time (in milliseconds) before the activity begins performing any operations. The default value is 1000 milliseconds (1 second).
• TimeoutMS - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 50000 milliseconds (50 seconds).

SSH 连接属性

• SSH Password - The SecureShell password used to connect to the specified terminal, stored in a SecureString variable. This field supports only SecureString variables.
• SSH Username - The SecureShell username used to connect to the specified terminal, stored in a String variable. This field supports only strings and String variables.

使用现有连接

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

“配置连接” 窗口

“配置连接”窗口包含各种配置选项，这些选项根据为连接到终端环境而选择的提供程序类型而有所不同。

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

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

直接连接提供程序

直接连接提供程序是 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 协议。
  • HPSV - 与 HP 系列终端模拟结合使用的 HP 特定协议。
• 终端模式- 终端模拟的特定风格。此处可用的值取决于您在“类型”字段中选择的值。
• 编码 - 终端环境系统使用的代码页。对于 IBM 系列终端，默认值为 IBM037，对于其他类型的终端，默认值为 ASCII。
• 启用 SSL/TLS - 与 Te lnet 协议一起使用，以指定终端环境系统使用 SSL 或 TLS 加密连接。
• LU 名称- 逻辑单元名称，与 IBM 系列终端类型一起使用。
• 基本模式- 此模式可禁用字段级别处理，以提高性能。字段级别活动（例如“获取字段”、“设置字段”）不支持此模式。
• “应答” - 在终端收到ENQ控制字符时，要向主机系统发送的文本消息。该消息可以包含 Enter 控制键，在字符串值中编码为^M 。仅当所选终端类型为VT时，此配置选项才可用。
• 代理类型 - 代理服务器使用的协议类型：
  • 无（默认）- 无代理
  • 隧道 - HTTPS 代理。
  • SOCKS4
  • SOCKS5
  • SOCKS4A
• 代理主机 - 代理服务器的 IP 地址或主机名。
• 代理端口 - 代理服务器使用的端口号。
• 代理用户 - 用于在代理服务器上进行身份验证的用户名。
• 代理密码 - 用于在代理服务器上进行身份验证的密码。
  备注：

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

IBM EHLLAPI 提供程序

The IBM EHLLAPI provider works with any 3rd party terminal emulation software that implements the EHLL API. The details for the implementation of the EHLL API should be found in the 3rd party terminal emulator software documentation.

备注：

The terminal emulation software needs to be started and connected before attempting to connect to it via EHLLAPI.

连接设置

• “EHLL dll” - 在第三方终端模拟器软件中用于实现 EHLLAPI 的 dll 的路径。
• EHLL 函数- EHLL 动态链接库中的入口点函数的名称。通常为“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 反射提供程序

The Attachmate Reflection provider works with the Attachmate Reflection terminal emulator.

仅适用于“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 终端模拟器一起使用。

连接设置

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