工作流活动

上次更新日期 2025年4月30日

创建并显示倒计时标注

本教程说明如何创建并显示 10 秒的标注，同时在自动化过程中出现某个用户界面元素时显示倒计时。我们将使用Windows天气应用程序作为示例，其徽标旁边将显示标注。

先决条件

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

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

步骤

创建标注文件：
1. 打开 Studio 项目，然后从“新建”下拉列表中选择“表单” ，以创建新表单。
  此处将表单文件用作标注。
2. 将该标注命名为Basic callout 。
3. 在“组件”面板中，展开“基本”部分，然后将三个“标签/标头”组件拖动到标注文件中。
  - 对于第一个组件，输入默认文本，例如： Welcome to Windy.com!
  - 对于第二个组件，输入默认文本，例如： This pop-up will close in 10 seconds 。
  - 对于第三个组件，保持不变。这是倒计时，将在运行时更改。
4. 保存组件和标注文件。
在项目中打开主工作流。
1. 添加“使用应用程序/浏览器”活动，然后在“浏览器 URL”字段中输入"https://www.windy.com/" 。
2. 添加“运行本地触发器”活动。这将启用所有触发器工作流，并允许它们在触发事件发生时运行。
在项目中打开主工作流。
1. 添加“使用应用程序/浏览器”活动，然后在“浏览器 URL”字段中输入"https://www.windy.com/" 。
2. 添加“运行本地触发器”活动。这将启用所有触发器工作流，并允许它们在触发事件发生时运行。
创建一个名为“显示基本标注”的新工作流，并添加一个“应用程序事件触发器”活动。
1. 选择在屏幕上指定目标，然后指定 Windows 徽标以便自动化开始监控。
  在此示例中，我们指出要监控的 Windows 徽标。
2. 从“事件类型”下拉列表中，选择“出现” 。
3. 添加“显示标注”活动。
  此活动允许您选择一个uiform文件，您可以使用“参数”字典将其显示给特定用户界面元素，以及将数据传递到uiform文件。
  1. 从“选择表单”下拉列表中，选择先前创建的标注文件。
    在此示例中，我们选择了Basic callout 。
  2. 对于“用户界面元素”字段，输入为“应用程序事件触发器”活动指定的用户界面元素，即我们要与标注绑定的“Windy 徽标”。
    要访问该目标元素，请使用TriggerEventArgs.TargetElement表达式。TriggerEventArgs是此处的参数，在将触发器活动添加到工作流时自动生成。在这种情况下， “应用程序事件触发器”活动会生成参数。
4. 导航至数据管理器，然后创建一个名为secondsLeft的全局变量。
  此变量用于跟踪显示标注的剩余时间。
5. 添加“分配”活动，为标注分配显示持续时间。在“保存位置”字段中，输入新创建的全局变量（ secondsLeft ），然后在“要保存的值”字段中输入10 。
创建另一个名为更新计数器的触发器工作流，该工作流会触发标注中剩余秒数的更新。
1. 添加“全局变量更改触发器”活动，以便在全局变量secondsLeft更改时执行此工作流。
  从“选择全局变量”下拉列表中，选择secondsLeft ，然后将“计划模式”设置为“顺序” 。
2. 添加“ Do While 循环”活动，以更新在secondsLeft变量变为 0 之前标注显示的剩余秒数。
  1. 在“后条件循环”活动的主体中，添加“设置表单值”活动。从“选择表单”下拉列表中，选择Basic Callout文件。打开“参数”字典，在secondsValue键的“值”字段中输入以下表达式： "secondsLeft.ToString+" second(s) left."
  2. 添加一个“延迟”活动并将其设置为一秒。
  3. 添加一个“分配”活动，以从secondsLeft全局变量中减去 1 秒。
  4. 将 Do While 循环的 条件设置为secondsLeft <> 0 。
3. 添加一个“关闭表单”活动，然后选择Basic Callout文件。
4. 添加“停止本地触发器”活动，以停止所有触发器工作流的执行。
  如果您的项目仅包含触发器工作流，则此活动尤其重要。如果不合并此活动，触发器将在连续循环中持久运行，不会停止。