用户界面自动化活动

上次更新日期 2025年6月18日

浏览器对话框作用域

UiPath.UIAutomationNext.Activities.NBrowserDialogScope

捕获并处理 JavaScript 对话框，例如：警示、确认、提示。此活动应该用作可能生成浏览器对话框的活动的作用域，因此必须将可能触发对话框的活动放置在“浏览器对话框作用域”活动的主体中。

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

Windows |跨平台

从“对话框类型”下拉菜单中，选择“浏览器对话框作用域”活动处理的 JavaScript 浏览器对话框的类型：
- 警示
- 确认
- Prompt
对话框响应- 对 JavaScript 确认对话框的响应：取消或确定。仅适用于“确认”或“提示”对话框类型。
提示响应文本- JavaScript 提示对话框的文本响应。它仅适用于“提示对话框”类型。
对话框消息- 用于存储由对话框作用域处理的对话框消息的字符串输出变量。

计时

选项

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

在业务流程自动化中，用户会遇到浏览器对话框阻止执行当前浏览器页面的情况。通常，用户需要关闭浏览器对话框，并获取对话框消息，以供以后在业务场景中使用。

对于 Windows 项目， 可以通过将“使用应用程序/浏览器” 容器活动的“窗口附加模式” 设置为“应用程序”实例 ，并使用主动式辅助 (AA) 用户界面框架生成浏览器对话框选取器，来处理这种类型的场景。

但是，对于跨平台项目（包括 Studio Web），我们没有任何解决方案来处理这种类型的场景。

JavaScript 具有三种弹出框：警示、确认和提示。“浏览器对话框作用域”活动可以处理这种类型的对话框，应该将其用作可能生成浏览器对话框的活动的作用域。

必须在“使用应用程序/浏览器” 活动中添加“浏览器对话框作用域” 活动，并且可能触发对话框的活动必须放置在“浏览器对话框作用域” 活动的主体中。

“警示”对话框用于确保用户能够接收到信息。当它弹出时，用户必须单击“确定”按钮才能继续，否则执行将被阻止。

通过这种方式，可以配置“浏览器对话框作用域” 活动，以处理单击“提交” 按钮时触发的“警示” 对话框。

当用户需要验证或接受某些内容时，会使用“确认”对话框。当它弹出时，用户必须单击确定或取消按钮才能继续。

通过这种方式，可以配置“浏览器对话框作用域” 活动，以处理单击“提交” 按钮时触发的“确认” 对话框。

当用户需要为操作提供文本输入时，将使用“提示”对话框。当它弹出时，用户必须在输入值后单击“确定”或“取消”才能继续。

当用户单击按钮时，页面会逐个打开多个对话框，但在极少数情况下会打开另一个对话框。让我们考虑以下场景:

可使用“浏览器对话框作用域”活动，通过嵌套多个对话框作用域来处理这种情况。它们的排列顺序必须与其处理的对话框在页面中的显示顺序相同。在处理完所有对话框后，工作流将继续进行。对于上述场景：

除了“浏览器对话框作用域”活动之外，我们还向“使用应用程序/浏览器”活动添加了浏览器对话框处理选项。

应用程序卡中新的“对话框处理” 设置允许用户描述如何自动关闭浏览器对话框（要关闭哪些类型的对话框以及对确认和提示对话框提供什么响应）。

已为“对话框处理”添加类似的项目设置，这些设置将作为“使用应用程序/浏览器对话框处理”选项的默认值。

当嵌套多个“浏览器对话框作用域”活动和具有对话框处理的应用程序卡时，务必牢记以下几点，以确定如何处理对话框：

“浏览器对话框作用域”活动的优先级高于“应用程序卡对话框处理”选项。
嵌套浏览器“对话框作用域”活动按多个对话框的出现顺序处理多个对话框：第一个“对话框作用域”处理第一个对话框，第二个“对话框作用域”处理第二个对话框，依此类推。
带对话框处理功能的嵌套式应用程序卡会相互覆盖：内部应用程序卡将覆盖外部应用程序卡的设置。例如，可以将顶层应用程序卡配置为在整个工作流中使用“取消”关闭所有对话框，但对于工作流的一小部分，可以在顶层应用程序卡中使用短期应用程序卡以接受点击“确定”确认对话框，仅为工作流的该部分更改对话处理。警示和提示仍将根据顶层应用程序卡的结果关闭。