用户界面自动化活动

上次更新日期 2024年12月20日

键入

UiPath.UIAutomationNext.Activities.NTypeInto

描述

在指定用户界面元素中输入文本，比如文本框。

您还可以向用户界面元素发送特殊键（例如 Tab 或 Enter）。

还支持粘滞键。例如，如果要键入 Shift+End 以仅选择控件的部分文本，则需要从特殊键列表中选择 Shift 和 End，建议的文本为 [k(Shift)][k(End)]。这将模拟按顺序按下 Shift 和 End 键。正确的文本为 [d(Shift)][k(End)][u(Shift)]，其中 d 表示按键按下，k 表示按住按键，u 表示按键松开。

如果要安全地输入敏感信息，请在此活动之前添加“获取用户名/密码”活动，然后选择该活动中保存以备后用的用户名和密码值作为要键入的文本。

无法在使用应用程序/浏览器活动内添加此活动。

如要在“使用应用程序/浏览器”活动之外使用此活动，您需要提供一个 “输入”元素。

此活动可与对象存储库兼容。

要了解如何使用此活动，请参阅：

安全输入登录信息的先决条件

在使用此活动安全输入用户名/密码信息之前，您必须先执行以下操作：

向项目添加 “ 获取用户名/密码 ”活动。
在“ 获取用户名/密码 ”活动中，选择先前保存到 Windows 凭据管理器的凭据。如果您要使用的凭据尚未保存在 Windows 凭据管理器中，则可以使用此活动添加凭据。
保存凭据以供以后在项目中使用。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

单击 “在应用程序/浏览器 中指定”，以指定要用作目标的用户界面元素。

如果元素已在目标应用程序中成为焦点，则无需执行此步骤。

指定目标后，选择“ 菜单” 按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 添加自动验证/删除验证- 添加或删除对活动执行的操作的验证。默认情况下，验证执行处于启用状态。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
输入此项 - 要输入的文本。您可以使用下拉菜单选择要发送到文本字段的特殊键，也可以从文本生成器添加特殊键。您也可以使用“ 加号”中的选项，菜单，以添加保存以备后用的值，或添加来自“项目笔记本”或父级“ 使用 Excel 文件 ”或 “使用 Outlook 帐户” 活动的数据。支持文本、Excel 或 Outlook 数据以及特殊键的任意组合。
“输入前清空字段 ” - 选择是否在输入文本之前删除字段中的现有内容，以及如何清空字段。通过发送击键组合来清空字段，击键组合在单行字段和多行字段之间有所不同。请务必根据指定的字段选择正确的选项。选项包括：
- “无 ” - 不删除现有内容。
- 单行 (End、Shift+Home、Del) - 使用单行从文本字段中删除内容。这是默认选项。
- 多行 (Ctrl+A、Del) - 从具有多行的文本字段中删除内容。
要使用该活动清除指定的文本字段，请配置此属性以删除现有内容，将“ 键入此 字段”留空，并将“ 输入模式” 属性设置为“ 硬件事件”。
键入前单击 - 选择是否在键入文本之前单击指定的用户界面元素，以及要执行的单击类型。选项包括“ 无 ”（不单击）、 “单击 ”（执行单击）或“ 双击 ”（执行双击）。

默认选项为“ 单个”。
验证文本是否为空 - 如果选择了“ 添加自动验证 ”，则会显示此选项。您可以在当前应用程序或任何应用程序中指定。

属性面板

常见

“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。

输入

安全文本 - 要输入的安全文本。该字段仅支持安全字符串变量。如果配置了此字段，则清除“ 文本 ”字段。此字段的最大字符串长度为 65536 个字符。
“目标 ” - 目标元素。必须设置目标元素。在屏幕上指定之前，此字段设置为 (null)。指定目标后，将显示与指定元素相关的所有属性。
- 单击偏移量 - 指定单击活动的偏移量，可以进一步配置该偏移量。
  - 锚点 - 描述光标相对于“ 偏移 X ”和“ 偏移 Y ”属性的偏移量的起点。提供以下选项： “左上”、 “右上”、“ 左下”、“ 右下”和“ 居中”。默认情况下，选择“ 居中 ”。
  - X 轴偏移 - 光标位置根据“ 锚点 ”字段中所选选项而进行的水平位移。此字段仅支持 Int32 变量。
  - “Y 偏移 ” - 光标位置根据“ 锚点 ” 字段中所选选项而进行的垂直位移。此字段仅支持 Int32 变量。
- CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
- 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
- “模糊选取器 ” - 模糊选取器的参数。
- 原生文本 - 用于标识用户界面元素的文本。
- 响应式网站 - 启用响应式网站布局。
- “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
- 定位方法 - 要用于标识元素的选取器类型。可以将此属性设置为下拉菜单中的任意组合：
  - 无
  - 精确选取器
  - 模糊选取器
  - 图像
  - 原生文本
  - Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。
    将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
- 可见性检查 - 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  - “无 ”- 不检查可见性。
  - 交互式（用于模糊选取器） - 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  - 完全可见 - 检查用户界面元素是否可见。
- 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。您可以从下拉菜单中选择以下三个选项之一：
  - 无- 不等待目标变为就绪状态。
  - “交互式”– 等待直到加载了应用程序的一部分。
  - “完整”– 等待整个应用程序被加载。
- 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时适用。
“文本 ” - 要输入的文本。您可以从活动正文的下拉列表中向文本添加特殊键。如果配置了此字段，则清除“ 安全文本 ”字段。此字段的最大字符串长度为 65536 个字符。
验证执行 - 在 Runtime，验证活动执行的 Actions 是否正确。为此，可以验证在执行活动后指定的用户界面元素中是否找到 预期文本 属性中指定的文本，或者指定应在执行 Actions 后出现或消失的元素，执行该活动。通过从上下文菜单中选择“ 添加自动验证 ”，可以从“ 项目设置”或活动的主体中启用此功能。
- “显示名称 ”- 验证 Actions的显示名称。此字段会根据您选择的验证 Actions 和元素自动填充。设置“ 验证执行 ”后，此显示名称将在活动卡中可见。
- 预期文本 - 应在指定文本字段中键入的文本。此字段为可选字段。此字段仅支持字符串和 String 变量。
- “重试 ” - 选中后，如果系统未获得预期结果，则将在活动超时的持续时间内重试 Actions 。默认情况下，该复选框处于选中状态。
- “目标 ”- 此目标用于指示要在 Runtime验证的元素。有关可在此属性下展开的属性字段的更多信息，请参阅上面的目标属性，因为属性的功能是相同的。
- “超时 ”- 等待验证元素出现、消失或更改的时间 (以秒为单位)。如果选中“ 重试 ”复选框，则会在活动的“ 超时 ”属性中指定的持续时间内再次执行 Actions ，然后进行验证。默认值为 10 秒。
- 验证元素 - 定义要检查验证目标的更改。可用选项包括：
  - “出现 ” - 检查元素是否出现。
  - “消失” - 检查元素是否消失。
  - “已更改文本” - 检查元素文本是否有任何更改。
  - 已更改外观 - 检查元素的图像是否发生更改。

输入/输出元素

输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。此字段仅支持 UIElement 对象。可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。

其他

“私有” - 如果选中，则不再以“Verbose”级别记录变量和参数的值。此字段仅支持 Boolean (True和 False) 值。默认值为 False。

选项

“更改禁用的元素 ” - 如果选中，即使禁用了指定的用户界面元素，活动也会执行 Actions 。此字段仅支持 Boolean 值（True、 False）。默认值为 False。

如果输入模式属性设置为硬件事件，则此属性不适用。
输入模式 - 选择机器人与目标应用程序交互时应使用的方法：
- 与应用程序/浏览器 相同 - 使用与 使用应用程序/浏览器 活动相同的输入模式。
  
  这是默认选择。
- “硬件事件 ” - 使用硬件驱动程序执行操作。这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。
- 模拟 - 使用辅助功能 API 进行模拟。推荐用于浏览器、基于 Java 的应用程序、SAP。通常比 硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。
  
  在“属性”面板中， “输入模式”属性字段旁边的按钮会自动测试并为您正在执行的 Actions 选择正确的输入模式。借助此功能，您可以使用所有可用的输入方法在目标字段中输入文本，并自动选择效果最佳的文本。
  
  属性“ 激活” 、“ 键入前单击” 、“ 按键之间的延迟” 和“ 空字段 ” 不能与“模拟”输入模式一起使用。
- Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
- 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比 硬件事件更可靠。在单个 Actions中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此功能。

选项 - 硬件事件/Chromium API

激活 - 将用户界面元素置于前台，并在单击前将其激活。如果未选择，则活动类型将输入当前的活动窗口。该字段仅支持“布尔值”（“True”、“ False”）。默认值为 True。
“键入前单击 ” - 请参阅“设计器”面板中的“键入前单击 ”。
“按键之间 的延迟”- 连续击键之间的延迟（以秒为单位）。默认值为 0.02 秒。最大值为 1 秒。
空字段 - 在“设计器”面板中 输入内容前请参阅“空字段 ”。

选项 - 模拟

“结束时取消选择” - 仅当“ 输入模式” 属性设置为“ 模拟 ”并且默认情况下处于选中状态时，才能使用此复选框。某些目标应用程序不会注册类型操作，除非在操作的同时还发送了“完成”事件。选中此复选框会在文本输入后添加一个“完成”事件，以便正确注册操作。如果清除此复选框，则不会将“完成”事件发送到目标应用程序。默认情况下，此复选框处于选中状态。

跨平台配置

在屏幕上指定目标 - 指定要用作目标的用户界面元素。

指定目标后，选择加号按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
输入此项 - 要输入的文本。您可以从文本生成器中添加特殊键。

其他选项

计时

“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。
“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

选项

空字段 - 选择是否在键入文本之前删除字段中的现有内容，以及如何清空字段。通过发送击键组合来清空字段，击键组合在单行字段和多行字段之间有所不同。请确保根据指定的字段选择正确的选项。选项包括：
- “无 ” - 不删除现有内容。
- 单行 (End、Shift+Home、Del) - 使用单行从文本字段中删除内容。这是默认选项。
- 多行 (Ctrl+A、Del) - 从具有多行的文本字段中删除内容。
键入前单击 - 选择是否在键入文本之前单击指定的用户界面元素，以及要执行的单击类型。选项包括“ 无 ”（不单击）、 “单击 ”（执行单击）或“ 双击 ”（执行双击）。默认选项为“ 单个”。
激活 - 选中后，系统会将指定的用户界面元素置于前台，并在输入文本之前将其激活。如果未选择，则活动类型将输入当前的活动窗口。该字段仅支持“布尔值”（“True”、“ False”）。默认值为 True。
“末尾取消选择” - 在文本输入后添加“完成” 事件，以触发网页浏览器中的某些用户界面响应。
输入模式 - 选择机器人与目标应用程序交互时应使用的方法：
- 与浏览器相同 - 用户使用父级 使用浏览器 活动中的 输入模式设置。 这是默认选项。
- Chromium API - 使用调试器 API 执行操作。仅适用于 Chrome 和 Edge 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。
- 模拟 - 使用辅助功能 API 模拟单击。适用于浏览器。一次性发送所有文本。此输入方法在后台工作 (即使目标应用程序不在焦点中)。

输入/输出

输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。此字段仅支持 UIElement 对象。可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。