概述

基于触发器的 Attended 自动化可能涉及以下内容：

表单 – 使用表单生成器创建并使用 Form.Activities 包进行处理。
标注 – 使用表单生成器创建并与 Callout.Activities 包一起显示。
触发器 – 使用 System.Activities 和 UIAutomation.Activities 包。
全局变量 – 通过 Data Manager 创建。

表单和标注是 Attended 自动化的核心功能。使用触发器运行它们可让您构建复杂的场景。这些场景涉及同时发生多个事件。此外，您还可以根据全局变量的值触发操作，有助于您涵盖更多的 Attended 场景。

下图显示了使用表单、表单事件触发器和应用程序事件触发器构建的流程。您也可以基于用户事件触发器和标注构建类似的流程。

先决条件

要设计和运行基于触发器的 Attended 自动化，请执行以下操作：

安装以下活动包：
- Form.Activities 版本 23.4
- System.Activities 23.4
- UIAutomation.Activities 23.4
- Callout.Activities 23.4
如果您在尝试创建“表单”文件时遇到以下错误：无法找到兼容的 Webview2 Runtime 安装来托管 WebViews，请安装 Microsoft Edge WebView2。

表单

Attended 自动化中的表单用于收集和处理用户或应用程序的输入。借助当前的表单功能，您可以：

使用项目中的“表单”（uiform 文件）在活动外部创建表单。您稍后可以独立于使用表单的任何活动来构建或编辑它们。这使您可以将构建表单的流程与在同一自动化中使用它们的流程分开。
使用自定义 HTML 文件创建表单。您可以像使用 uiform 文件一样使用 HTML 表单。
使用“显示表单”活动同时显示多个表单。添加多个“显示表单”活动，并在“实例名称”字段中为每个活动提供唯一名称。“实例名称”属性适用于 Form.Activities 包中的大多数活动，可用于：
- 通过为显示的每个表单提供唯一的实例名称，显示同一表单的多个实例或在其中执行操作。
- 通过将“实例名称”字段留空，对所有实例显示或执行操作。
设置触发器以根据表单事件启动。这些事件可以表示关闭的表单或对其做出更改的某个表单组件。您可以使用“表单事件触发器”活动来实现此目的。
选择仅显示表单或在工作流的其余部分运行时显示表单。您可以通过启用或禁用“继续执行工作流”属性来执行此操作。
使用“设置表单值”和“获取表单值”活动在 Runtime 编辑并获取表单值。
使用“更改表单属性”活动在 Runtime 更改表单属性。
使用“运行表单脚本”活动将自定义 JavaScript 注入表单。

标注

标注在 Attended 自动化中的作用是将用户定向到应用程序、网站、产品中的特定用户界面元素，甚至是表单中的特定用户界面元素。您还可以使用标注为应用程序创建自定义验证，预填充字段并根据用户输入触发多个自动化。

借助标注功能，您可以：

使用“表单”(uiform) 文件创建标注，并使用表单生成器进行设计。
使用“显示标注”活动指定要在标注旁显示的用户界面元素。
将值传递给标注中的元素。

注意：标注是使用“显示标注”活动绑定到用户界面元素并在用户界面元素旁显示的表单。

尽管有一个专用于标注的 Callout.Activities 包，但也可以使用 Form.Activities 包处理标注，因为标注与常规表单同样是 uiform 文件。这意味着，如果您使用的是 Form.Activities 包，则可以像使用常规表单一样使用标注。

触发器

Attended 自动化中触发器的目的是：

根据应用程序或用户事件启动工作流。此外，您可以通过计划模式指定在触发触发器时如何执行操作：

要根据应用程序或用户事件触发工作流，请使用以下活动：

活动	描述
表单事件触发器	根据表单中发生的事件触发工作流。
应用程序事件触发器	根据任何类型元素（顶层窗口或任何其他指定的用户界面元素）的原生事件设置触发器。
重复触发器	此活动允许您将“时间跨度”配置为“输入参数”。当时间跨度过期时，触发器将执行，并且可以根据设置重复执行。
按键事件触发器	在指定的用户界面元素上设置按键事件触发器。
单击事件触发器	在指定的用户界面元素上设置单击事件触发器。
热键触发器	监控指定系统范围内的按键事件。
鼠标触发器*	监控系统范围内指定的鼠标-按键组合事件。
单击图像触发器*	监控由目标用户界面元素为鼠标输入定义的图像。
系统触发器*	监控指定系统范围内的按键和/或鼠标事件。
SAP 会话属性更改触发器*	监控指定 SAP 会话属性的更改。

* - 可以单独使用，也可以在“触发器作用域”活动中使用。

用于自动化多个 Attended 场景，这些场景可以按顺序或同时发生一次。您可以使用以下活动来实现此目的：

活动	描述
运行本地触发器	初始化并启动用户计算机上侦听事件的所有本地触发器。
停止本地触发器	停止在用户计算机上侦听事件的所有本地触发器。
禁用本地触发器	禁用一个或多个活动的本地触发器，这些触发器先前通过“运行本地触发器 ”活动启动。
启用本地触发器	启用一个或多个活动的本地触发器，这些触发器先前通过“运行本地触发器”活动启动。

根据全局变量的行为启动您在 Data Manager 中创建的工作流。您可以使用以下活动来实现此目的：

活动	描述
全局变量更改触发器	当全局变量的值发生更改时，向所有订阅者推送通知。
通知全局变量已更改	在全局变量的值更改时启动的触发器。

运行本地触发器

“运行本地触发器”活动使您可以同时触发多个事件。在后端，它会在运行时或调试期间生成一个名为 Triggereventargs 的单独只读工作流。此工作流包含多个触发器作用域活动，这些活动在项目中并行执行所有触发器。

首次运行项目时，每个触发器工作流都会捕获 Triggereventargs 工作流作为“参数”面板中的参数。每个触发器工作流都有自己的 Triggereventargs 参数，其中包含有关其自身的信息。执行项目时，Triggereventargs 参数会使用最新的运行信息进行更新。

该 Triggereventargs 参数主要提供以下特定于每个触发器工作流的信息：

触发器类型
触发器名称
触发触发器的目标元素
表单组件（面向表单触发器活动）
表单实例名称（面向表单触发器活动）

要访问 Triggereventargs 参数中的信息，可以根据触发器类型应用各种方法。对于用户事件触发器，可以使用以下方法：

TargetElement - 获取有关受监控目标元素的信息
1. Attributes - 获取受监控目标元素的属性
2. DisplayDpiScaleFactor - 确定目标元素的大小（以像素为单位）
3. ImageBase64 - 将目标元素的图像转换为 Base64 图像
4. Selector - 检索有关目标元素上使用的选取器的信息
触发器类型

对于表单触发器，您可以使用以下方法：

FormSourceId - 访问触发触发器的表单的 ID
实例名称 - 检索触发触发器的表单的实例名称

触发器行为

触发器工作流是以触发器开头的工作流。您可以在整个项目的上下文中调试这些活动，也可以单独调试。
如果您认为大量的触发器会影响性能，则可以使用“启用本地触发器”和“禁用本地触发器”活动启用或禁用特定触发器。
“启用本地触发器”和“禁用本地触发器”活动在以下情况下非常有用：您有多个用于监控用户事件的工作流，并且这些事件由用户达到的自动化阶段决定。
- 例如，您可以在用户在表单中输入用户名后，使用“启用本地触发器”活动启用触发器。
- 另一方面，例如，可以利用“禁用本地触发器”活动来禁用计划为在用户达到产品导览中的特定步骤后按顺序执行的触发器。