概述

基于触发器的 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 自动化中触发器的目的是：

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

   • 顺序 - 依次执行操作。
   • 并发 - 操作执行可以重叠。
   • 一次性 - 执行一项操作并退出监控。
   • 按顺序折叠 - 忽略所有即将发生的事件（最新事件除外），直到当前事件完成执行。
   • 顺序中止 - 停止执行上一个事件，并开始下一个事件。要触发基于应用程序或用户事件的工作流，请使用以下活动：

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

***** - 既可以单独使用，也可以在触发器作用域活动中使用。 2. 用于自动化多个 Attended 场景，这些场景可以按顺序或同时发生一次。您可以使用以下活动来实现此目的：

活动	描述
运行本地触发器	初始化并启动用户计算机上侦听事件的所有本地触发器。
停止本地触发器	终止执行本地触发器。执行时，它将取消所有正在进行的操作，包括由事件触发的工作流。执行“停止本地触发器”时，正在进行的事件触发工作流将取消，但主工作流中的活动将照常继续。
禁用本地触发器	禁用一个或多个活动的本地触发器，这些触发器先前通过运行本地触发器活动启动。
启用本地触发器	启用一个或多个活动的本地触发器，这些触发器先前通过“运行本地触发器”活动启动。

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

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

运行本地触发器

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

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

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

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

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

1. TargetElement - 获取有关受监控目标元素的信息

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

   

2. 触发器类型

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

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

触发器行为

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

全局变量

Attended 自动化中的全局变量用于记录有关用户或应用程序事件的信息，然后将其存储在变量中，之后可以将其用作其他活动的输入或触发器。这使德您可以轻松地在多个工作流之间共享数据。借助全局变量功能，您可以：

• 使用“通知全局变量已更改”活动在全局变量的值更改时发出通知
• 使用“全局变量更改触发器”活动在全局变量的值更改时触发工作流或活动。