截取屏幕截图

UiPath.UIAutomationNext.Activities.NTakeScreenshot

描述

截取指定用户界面元素或应用程序的屏幕截图，并将其保存为图像文件。

该活动可在“使用应用程序/浏览器”活动内部和外部使用。

如果在“使用应用程序/浏览器”活动中添加，则仅会捕获目标应用程序。如果在应用程序卡外部添加，则由于没有指定目标，系统将捕获整个桌面。

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows 和跨平台配置

• 在作用域内工作 - 选择呈现要自动化的网页应用程序的浏览器选项卡。

• 在屏幕上指明目标

  • 指定要用作目标的用户界面元素。指定目标后，选择加号按钮以访问以下选项：
  • Indicate target on screen - Indicate the target again.
  • “编辑目标” - 打开选择模式以配置目标。

• “屏幕截图容器” - 在“整个页面”和“元素”之间进行选择，以截取整个页面或单个元素的屏幕截图。默认选项为“整个页面” 。

• 输出到(适用于 Windows) - 使用单选按钮选择输出类型：

  • 文件- 在指定位置将屏幕截图保存为文件。默认选项。
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.

• 文件名- 保存指定用户界面元素屏幕截图的文件的名称。

• 自动递增- 定义在文件名冲突时附加到文件名的内容。从下拉菜单中选择一个选项：

  • “无（覆盖）” - 文件将使用指定的名称，如果已存在另一个同名文件，则该文件将被覆盖。这是默认选项。
  • “索引” - 如果已存在一个或多个与模式Filename (XX)匹配的文件，则系统会使用名称Filename (N+1)创建一个新文件，其中 N 是现有文件中的最大索引。
  • YYYY.MM.DD HH.MM.SS - 如果已存在指定名称的文件，则系统会创建名为Filename YYYY.MM.DD at HH.MM.SS新文件。如果已存在文件名为Filename YYYY.MM.DD at HH.MM.SS文件，并且已添加索引（类似于索引情况），会生成名为Filename YYYY.MM.DD at HH.MM.SS (1)的文件。

属性面板

输入/输出

• 屏幕截图文件- 保存为.png文件的屏幕截图。
• “输入元素” - 要在其上执行活动的用户界面元素，存储在“用户界面元素”对象中。该字段仅支持用户界面元素对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。
• 输出元素- 输出目标用户界面元素，并将其存储在用户界面元素对象中，该对象可进一步用于使其他活动定位同一元素。

选项

• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。

  • 已禁用 - 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。

• “出错时继续” - 指定在活动抛出错误时是否应继续自动化操作。此字段仅支持Boolean值（ 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.
• “编辑目标” - 打开选择模式以配置目标。
• 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
• 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。

• “输出位置” - 使用单选按钮选择输出类型：
  • 文件- 在指定位置将屏幕截图保存为文件。默认选项。
  • Image - Saves the screenshot to the indicated image.
  • Clipboard - Saves the screenshot as an image to clipboard for later use.
• 文件名- 保存指定用户界面元素屏幕截图的文件的名称。单击“浏览文件” ，然后浏览到要保存屏幕截图的文件夹，并指定要使用的文件名和扩展名。
• Auto increment - Select what to append to the filename when saving the screenshot in case of filename conflicts. For example, if a file with the same name as the one you save already exists, choosing Index keeps the file name, creating a new file for each screenshot and adding an index number to each, consecutively.
  • None (overwrite) - If a file with the same name already exists, replace it.
  • Index - Add a number to the filename, for example screenshot (1).png.
  • YYYY.MM.DD at HH.MM.SS - Add the date and time when the screenshot is taken to the filename, for example screenshot 2020.06.22 at 10:22:32.

属性面板

常见

• “出错时继续” - 指定在活动抛出错误时是否应继续自动化操作。此字段仅支持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 秒。

• 自动递增- 在“设计器” 面板中查看“自动递增” 。

• “文件名” - 请在“设计器” 面板中查看“文件名” 。

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

  • 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 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见
      • 检查用户界面元素是否可见。
  • 等待页面加载- 在执行操作之前，等待应用程序做好接受输入的准备。您可以从下拉菜单中选择以下三个选项之一：
    • “无”- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器（应用程序实例） - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时可用。

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

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

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

• Saved file path - The full path to the file where to save the screenshot, including the appended suffix, if applicable. This also dictates where the Auto increment property saves the indexed screenshot files.

• “已保存的图像” - 保存为“图像”的屏幕截图；当“输出”设置为image时使用。