创建并显示简单标注

本教程说明如何在自动化过程中出现某个用户界面元素时创建并显示 10 秒钟的标注。我们将使用Windows天气应用程序作为示例，其徽标旁边将显示标注。标注中的内容使用已添加到“显示标注”活动的“参数”字典中的In参数。

先决条件

此示例是使用以下活动包和版本创建的：

• UiPath.Callout.Activities 25.2.0
• UiPath.System.Activities 25.2.0
• UiPath.UIAutomation.Activities 25.2.1-preview

步骤

1. 创建标注文件：
   1. 打开 Studio 项目，然后从“新建”下拉列表中选择“表单” ，以创建新表单。

      此处将表单文件用作标注。

   2. 将该标注命名为Basic callout 。
   3. 在“组件”面板中，展开“基本”部分，然后将“标签/标头”组件拖动到标注文件中。
   4. 保存组件和标注文件。
2. 在项目中打开主工作流。
   1. 添加“使用应用程序/浏览器”活动，然后在“浏览器 URL”字段中输入https://www.windy.com/ 。
   2. 添加“运行本地触发器”活动。这将启用所有触发器工作流，并允许它们在触发事件发生时运行。
3. 创建一个名为“显示基本标注”的新工作流，并添加一个“应用程序事件触发器”活动。
   1. 选择在屏幕上指定目标，然后指定 Windows 徽标以便自动化开始监控。

      在此示例中，我们指出要监控的 Windows 徽标。

   2. 从“事件类型”下拉列表中，选择“出现” 。
   3. 添加“显示标注”活动。
      此活动允许您选择一个uiform文件，您可以使用“参数”字典将其显示给特定用户界面元素，以及将数据传递到uiform文件。
      1. 从“选择表单”下拉列表中，选择先前创建的标注文件。
         在此示例中，我们选择了Basic callout 。
      2. 对于“用户界面元素”字段，输入为“应用程序事件触发器”活动指定的用户界面元素，即我们要与标注绑定的“Windy 徽标”。
         要访问该目标元素，请使用TriggerEventArgs.TargetElement表达式。TriggerEventArgs是此处的参数，在将触发器活动添加到工作流时自动生成。在这种情况下， “应用程序事件触发器”活动会生成参数。
      3. 打开“参数”字典，并在所生成键的“值”字段中输入要显示的文本。
         在此示例中，我们显示以下文本： "Welcome to Windy.com!<br>(this callout will close in 10 seconds)" 。
   4. 添加一个“延迟”活动，并将其设置为 10 秒。
   5. 添加“关闭表单”活动，以在 10 秒后关闭标注。从“选择表单”下拉列表中，选择您先前创建的标注文件（例如： Basic callout ）。
   6. 添加“停止本地触发器”活动，以停止所有触发器工作流的执行。

      如果您的项目仅包含触发器工作流，则此活动尤其重要。如果不合并此活动，触发器将在连续循环中持久运行，不会停止。

结果

徽标出现后，自动化将打开 Windy 网站，并触发“显示基本标注”工作流。此工作流显示标注 10 秒钟，然后关闭。以下动画图像在运行时演示了这种场景：

图 1.在 Windows 徽标旁边显示标注的动画图片

工作流示例

要查看本教程中步骤的实施情况，请下载以下示例项目： Windy 的显示标注。