键盘快捷方式

UiPath.UIAutomationNext.Activities.NKeyboardShortcuts

描述

向用户界面元素发送一个或多个键盘快捷方式。

此活动必须添加到“使用应用程序/浏览器”活动中。

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

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

备注：

Due to the nature of this activity, it cannot be used in background mode.

要了解如何使用此活动，请参阅教程：使用来自 Excel 的数据在 Acrobat Reader 中填充 PDF 表单。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows 和跨平台配置

• 在作用域内工作 - 选择呈现要自动化的网页应用程序的浏览器选项卡。
• 键盘快捷方式容器- 发送整个页面或元素的键盘快捷方式。默认选项为“整个页面” 。
• “添加按键组合- 添加一个或多个修饰键，以与活动的操作结合使用。可用的选项如下： Alt 、 Ctrl和Shift 。
• 键- 从下拉菜单中选择一个键，或输入一个键，然后选择“添加快捷键” ，以填充“发送按键组合”字段。
• 发送按键组合- 要发送的键盘快捷方式。
• 验证- 定义活动执行验证步骤。
  • 无- 表示未对目标元素执行验证。
  • 元素已出现- 检查元素是否出现。
  • 元素消失- 检查元素是否消失。
  • 元素文本已更改- 检查元素文本是否有任何更改。

属性面板

输入/输出

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

选项

• 输入前单击- 选择是否在输入文本之前单击指定的用户界面元素，以及要执行的单击类型。选项包括无（不单击）、单击（执行单击）或双击（执行双击）。默认选项为无。
• 激活- 将用户界面元素移至前台，并在发送快捷方式之前激活该元素。该字段仅支持“布尔值”（ True 、 False ）。默认值为True 。
• 键之间的延迟- 连续击键之间的延迟（以秒为单位）。默认值为 0.02 秒。延迟时间上限为 1 秒。
• Delay between shortcuts - Delay (in seconds) between consecutive keyboard shortcuts. The default value is 0.5 seconds.
• Input mode - Select which method the Robot should use to interact with the target application:
  • 与应用程序/浏览器相同- 使用与使用应用程序/浏览器活动相同的输入模式。
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • “ChromiumAPI” - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请参阅Chromium API 。
  • 窗口消息（仅适用于 Windows）- 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比“硬件事件”更可靠。在单个操作中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
  • 已禁用 - 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 FALSE。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为 True，则无论出现何种错误，系统都将继续执行项目。

计时

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。

Windows - 旧版配置

• 选择“在应用程序/浏览器中指明” ，以指定用作目标的用户界面元素。如果未指定目标元素，则快捷方式将发送到父应用程序/浏览器。

指定目标后，选择“菜单”按钮访问以下选项：

• Indicate target on screen - Indicate the target again.
• “编辑目标” - 打开选择模式以配置目标。
• 添加验证/删除验证- 在活动卡中添加或删除“在屏幕上指定验证目标”功能。默认情况下会启用验证执行。
• 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
• 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。

• 记录快捷方式- 单击此选项，然后按组合键以发送到键盘上的目标元素。录制的快捷方式将显示在活动主体中。录制快捷方式后：
  • To add more shortcuts, click Record shortcut again and press the desired key or keys on your keyboard. The shortcuts are sent in the order in which they appear in the body of the activity.
  • 要更改录制的快捷方式的发送顺序，请拖放录制的键以更改其在活动正文中的位置。
  • 要删除已添加的快捷方式，请单击“删除” 。
• “发送按键组合” - 要发送的键盘快捷方式。
• 在屏幕上指定验证目标- 指定要用作目标的用户界面元素，以及在执行操作后应显示或消失的用户界面元素。当您要确保在运行时正确执行活动所执行的特定操作时，请使用此功能。这在自动化流程中特别有用，因为您需要确认特定用户界面元素由于操作而显示或消失。它增加了额外的验证层，以确保流程按预期运行。因此，如果您的自动化流程取决于某些步骤的正确执行，您可能需要验证执行情况。可以从“项目设置”或从活动主体中选择“添加验证”来启用此功能。

属性面板

常见

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

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• 显示名称 -“设计器”面板中活动的显示名称。 指定目标时，系统会自动生成显示名称。

• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。

• 快捷方式 - 要发送的键盘快捷方式。此字段支持字符串和 String 变量。

• “目标” - 目标元素。必须设置目标元素。在屏幕上指示之前，此字段设置为(null) 。指定目标后，将显示与指定元素相关的所有属性。

  • 单击偏移量- 指定单击活动的偏移量，您可以进一步配置该偏移量。
    • “锚点” - 描述光标从“偏移 X”和“偏移 Y”属性添加的偏移量的起点。提供以下选项：左上、右上、左下、右下和中间。默认情况下，选择“中心” 。
    • 偏移 X - 根据“锚点”字段中选择的选项对光标位置进行的水平位移。此字段仅支持Int32变量。
    • 偏移 Y - 光标位置根据“锚点”字段中选择的选项而进行的垂直位移。此字段仅支持Int32变量。
  • CV 控件类型- 表示使用 Computer Vision 识别的控件的类型。
  • CV 文本- 表示使用 Computer Vision 识别的文本。
  • Fuzzy selector - The parameters for the fuzzy selector.
  • 原生文本- 用于标识用户界面元素的文本。
  • 响应式网站- 启用响应式网站布局。
  • 精确选取器- 为用户界面元素生成的精确选取器。
  • 定位方式- 要用于识别元素的选取器类型。从下拉菜单中选择此属性后，可将其设置为任意组合：
    • 无
    • 精确选取器
    • 模糊选取器
    • 图像
    • 原生文本
    • Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置” > “Computer Vision” ，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为True 。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
    • 语义选取器- 利用大型语言模型 (LLM) 生成功能性、拟人化的用户界面元素描述。这些描述可靠性极高，既能适应用户界面的变更，又能在传统选取器失效时显着增强自动化弹性。
  • 可见性检查- 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不检查可见性。
    • 交互式（用于模糊选取器）- 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或者应用程序已最小化的情况。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见
      • 检查用户界面元素是否可见。
  • 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一：
    • “无”- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器（应用程序实例） - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。

• 验证执行 - 在运行时，验证活动执行的操作是否正确。这是通过指定应在执行操作后出现或消失的元素来完成的，该元素在活动执行后受到监控和验证。通过从上下文菜单中选择添加验证，可以从项目设置或每个活动的主体中启用此功能。

  • “显示名称” - 验证操作的显示名称。系统会根据您选择的验证操作和元素自动填充此字段。设置“验证执行”后，此显示名称将在活动卡中可见。
  • “重试” - 选择后，如果系统未获得预期结果，则将在活动超时的持续时间内再次执行此操作。默认情况下，该复选框处于选中状态。
  • “目标” - 此目标用于指示要在运行时验证的元素。有关可在此属性下展开的属性字段的更多信息，请参阅上面的“目标”属性，因为属性的功能是相同的。
  • “超时” - 等待验证元素出现、消失或更改的时间（以秒为单位）。如果选择“重试”复选框，则系统将在活动的“超时”属性中指定的持续时间内再次执行此操作，然后实施验证。默认值为 10 秒。
  • 验证元素
    • 定义要检查验证目标的更改。可用选项包括：
    • “已出现” - 检查元素是否出现。
    • “已消失” - 检查元素是否已消失。
    • 文本已更改- 检查元素文本是否有任何更改。
    • 视觉上已更改- 检查元素的图像是否发生任何更改。

• “输入元素” - 要在其上执行活动的用户界面元素，存储在UIElement对象中。此字段仅支持UIElement对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。

• “输出元素” - 输出目标用户界面元素，并将其存储在UIElement对象中，该对象可进一步用于与其他活动针对同一元素。

• “私有” - 选中后将不再以“Verbose”级别记录变量和参数的值。此字段仅支持Boolean （ True ， False ）值。默认值为False 。

• 激活- 将用户界面元素移至前台，并在发送快捷方式之前激活该元素。该字段仅支持“布尔值”（ True 、 False ）。默认值为True 。

• 输入前单击- 选择是否在输入文本之前单击指定的用户界面元素，以及要执行的单击类型。选项包括无（不单击）、单击（执行单击）或双击（执行双击）。默认选项为无。

• 键之间的延迟- 连续击键之间的延迟（以秒为单位）。默认值为 0.02 秒。延迟时间上限为 1 秒。

• 快捷方式之间延迟- 连续键盘快捷方式之间的延迟（以秒为单位）。您可以从下拉菜单中选择一个预定值： 0.2（秒） 、 0.5（秒）或0.8（秒） 。默认值为 0.5 秒。

• Input mode - Select which method the Robot should use to interact with the target application:

  • 与应用程序/浏览器相同- 使用与使用应用程序/浏览器活动相同的输入模式。
  • 硬件事件- 使用硬件驱动程序执行操作。该方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。这是默认选择。
  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
  • Window 消息- 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比“硬件事件”更可靠。在单个操作中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此方法。