构建实时计算器

概述

要观察 UiPath Apps 和 UiPath Robot 之间的即时通信，您需要：

• 在 UiPath Studio 中构建包含以下内容的项目：

  • Main.Xaml - 用于执行触发器的主工作流

  • 多个应用程序触发的工作流 - 用于基本算术运算。 这些工作流将配置为入口点。

    算术运算	Studio 工作流
    添加	Sum.xaml
    减法	Subtract.xaml
    乘法	Multiply.xaml
    除法	Divide.xaml

  • 触发器工作流 - 此工作流可作为模板提供，但您也可以创建它并根据业务需求对其进行自定义

• 在 UiPath Apps 中构建包含以下内容的应用程序：

  • 两个输入控件 - 用于输入数字

  • 四按钮控件 - 配置有 触发器工作流 规则，用于将按钮绑定到特定的算术运算，该运算由 Studio 工作流表示

  • 四个文本框控件 - 发送算术运算结果的地方

构建 UiPath Studio 项目

注意： 确保您使用的是 2023.4 及更高版本的 UiPath Studio 和 2023.4 及更高版本的 UiPath 机器人。

如有可能，我们建议将 Studio 项目配置 为以后台流程启动。 这有助于在多个浏览器窗口中同时运行同一个应用程序，而不会引发错误。

构建触发器工作流（模板）

1. 打开 UiPath Studio 并创建一个新流程。
   1. 选择 语言。
   2. 选择“ Windows ” 作为“ 兼容性”。
2. 确保您具有以下活动包版本:

   • UiPath.WorkflowEvents.Activities 2.0

   • UiPath.System.Activities 23.4+

3. 从名为“ Apps-Workflow 通信”的模板开始/在“项目” 面板中，添加一个新的工作流。 这将包含启用 UiPath Apps 和 UiPath Robot 之间通信通道的活动： Apps 请求触发器 和 处理 Apps 请求 活动。

   如果您使用Apps- 工作流通信模板，请跳到构建计算器工作流。

4. 添加 Apps 请求触发器 活动。 这必须是工作流中的第一个活动。

   将“ Apps 请求触发器 ”活动添加到工作流时，系统会自动创建 TriggerEventArgs 参数。 在“ 处理应用程序请求 ”活动中使用它，以访问执行工作流后收到的响应有效负载中的数据。

5. 添加一个 If 活动，以捕获与 Apps 客户端失去连接的情况。 当用户关闭 Apps 客户端时，应停止所有触发器。
   1. 在“ 条件” 字段中，写入以下表达式： ConditionTriggerEventArgs.ConnectionWithAppLost = true
   2. 在 Then 部分中，添加 停止本地触发器 活动。
   3. 在 Else 部分中，添加 处理应用程序请求 活动。
   4. 在 处理应用程序请求 活动的参数字段中，使用由 应用程序请求触发器 活动自动创建的 TriggerEventArgs 参数。此参数包含从“ Apps 请求触发器 ”活动接收的工作流有效负载，并将其传递给“ 处理 Apps 请求 ”活动。 在执行工作流时，“ 处理应用程序请求 ” 活动使用有效负载中的信息来调用工作流，然后在工作流完成时发回工作流输出结果。
      备注：

      必须在连接丢失条件的 Else 部分中使用 处理应用程序请求 活动。 这可确保在 UiPath Apps 和 UiPath 机器人之间的活动连接期间调用活动。 因此，当连接丢失时，流程执行将终止。

构建计算器工作流

1. 在项目中创建一个文件夹，并将其命名为“计算器”。 这是您存储计算器工作流的位置。
2. 在该文件夹中，为每个算术运算创建一个工作流：

   算术运算	Studio 工作流
   添加	Sum.xaml
   减法	Subtract.xaml
   乘法	Multiply.xaml
   除法	Divide.xaml

3. 在先前创建的所有工作流中，定义以下参数：

   参数名称	方向	参数类型
   number1	输入	Int32
   number2	输入	Int32
   结果	输出	Int32 Double - 用于除法

   参数“number1”和“number2”是 Apps 用户输入的数据。

   参数“result”是执行工作流后收到的输出。

4. 在先前创建的所有工作流中，添加“ 分配 ”活动。 按如下方式对其进行配置：

   工作流	保存到 字段	“要保存的值” 字段
   Sum.xaml	结果	number1 + number2
   Subtract.xaml	结果	number1 - number2
   Multiply.xaml	结果	number1 * number2
   Divide.xaml	结果	Cint(Math.Truncate(Decimal.Divide(number1,number2)))

5. 保存工作流。
6. 将计算器工作流标记为入口点：右键单击每个工作流，然后选择“启用入口点” 选项。 这样做可确保 XAML 显示在应用程序中。

构建主工作流

备注：

如果您使用Apps- 工作流通信模板，请跳过此步骤。

在 Main.xaml 文件中，只需添加“ 运行本地触发器” 活动，然后保存文件。

在 Orchestrator 中管理项目

1. 在 Studio 中，将项目包发布到 Orchestrator 文件夹。
   备注：

   如果您将项目发布到个人工作区，则系统会自动创建相应的流程。 跳至 构建 Apps 项目。

2. 在 Orchestrator 租户中，转到已发布 Studio 包的文件夹。
3. 导航到“ 自动化” >“流程”，然后单击“ 添加流程”。
4. 从“ 包来源名称” 下拉列表中，选择 Studio 项目。
5. 从“ 入口点 ”下拉列表中，选择“Main.xaml”。
6. 在后续页面中，根据需要配置流程，然后单击“ 创建”。 您的 Studio 项目现在可用作 Orchestrator 流程。

构建 Apps 项目

注意： 确保您使用的 UiPath Apps 已启用“VB 表达式”选项。

添加控件

1. 在“UiPath Apps 主页”>“ 构建 ”选项卡上，单击“ 新建应用程序”。
2. 输入应用程序的 名称 。 例如，“实时计算器”。
3. 对于“ 表达式语言”，选择 VB。
4. 在 MainPage上，添加具有以下 常规 属性的以下控件：

   控制	常规属性：值	描述
   1. 标签	文本：“实时计算器”	为应用程序添加标题。
   2. 文本框（数字）- 将其重命名为“number1”	标签：“第一个数字” 提示文本：“输入第一个整数”	允许用户输入其数据。
   3. 文本框（数字）- 将其重命名为“number2”	标签：“第二个数字” 提示文本：“输入第二个整数”	允许用户输入其数据。
   4. 按钮 - 将其重命名为“sum”	文本：“Sum”	触发 Sum.xaml 文件的执行。
   5. Texbox - 将其重命名为“sum_result”	不适用	输出 Sum.xaml 文件的响应。
   6. 按钮 - 将其重命名为“减”	文本：“减去”	触发 Subtract.xaml 文件的执行。
   7. Texbox - 将其重命名为“subtract_result”	不适用	输出 Subtract.xaml 文件的响应。
   8. 按钮 - 将其重命名为“乘以”	文本：“乘”	触发 Multiply.xaml 文件的执行。
   9. Texbox - 将其重命名为“multiply_result”	不适用	输出 Multiply.xaml 文件的响应。
   10. 按钮 - 将其重命名为“除法”	文本：“除以”	触发 Divide.xaml 文件的执行。
   11. Texbox - 将其重命名为“divid_result”	不适用	输出 Divide.xaml 文件的响应。

添加流程

将流程添加为资源，以将 Studio 工作流绑定到 Apps 控件。

1. 在您的应用程序中，展开“ 添加控件 ”下拉列表，然后选择“ 流程”。
2. 系统将显示当前帐户的租户列表。 选择托管所需流程的实例，然后单击 “下一步”。
3. 在左侧面板中，展开创建流程的 Orchestrator 文件夹，选择流程，然后单击“ 添加”。 例如，选择“计算器”流程。

   在应用程序中添加流程后，它将显示主工作流和标记为入口点的工作流，及其输入和输出参数，如 Studio 项目中所定义。

向“按钮”控件添加规则

通过向每个“ 按钮 ”控件添加“ 触发器 工作流”规则，您可以指示应用程序在 Apps 用户单击按钮时执行特定的工作流。

对每个按钮控件重复以下步骤：

1. 选择按钮控件。
2. 在右侧的“事件” 面板中，单击“创建规则” 。 系统将打开“配置规则”向导。
3. 搜索“ 触发器工作流 ” 规则并将其选中。
4. 在“ 工作流文件 ” 字段中，展开先前添加的流程（“计算器”），然后选择相应的工作流（.xaml 文件）。 例如，“ 求和 ”按钮必须引用“calculator_Sum_xaml”文件。
5. 单击“ 输入覆盖 ” 字段，然后展开先前选择的工作流。
   1. 双击“number1”以将其选择为第一个输入参数。
   2. 对于“ 输入值 ”字段，单击“调整”图标以 打开表达式编辑器，然后编写以下 VB 表达式：
      MainPage.number1.Value
   3. 双击“number2”以选择第二个输入参数。
   4. 对于“ 输入值 ”字段，单击“调整”图标以 打开表达式编辑器，然后编写以下 VB 表达式：
      MainPage.number2.Value
   注意： 表达式中的“number1”和“number2”引用 Textbox(number) 控件，这些控件已分别重命名为“number1”和“number2”。 通过将这些控件的值设置为输入参数的值，您可以将用户输入从 Apps 传递到 Studio 工作流。

   
6. 展开“ 完成时 ”字段，然后添加“ 设置值 ”规则。
   1. 对于“ 要设置的项目” 字段，单击“调整”图标以 打开表达式编辑器，然后引用结果控件。 例如，对于求和结果，请编写以下 VB 表达式：
      MainPage.sum_result.Value
   2. 对于“ 值 ” 字段，单击“调整”图标以 打开表达式编辑器，然后引用工作流结果。 例如，对于求和运算，请编写以下 VB 表达式：
      Processes.Calculator.calculator_Sum_xaml.result.ToString
   注意： 在“ 完成时间 ”字段中添加“ 设置值 ”规则可确保用于将工作流结果绑定到相应结果控件的值正确无误，因为它使用工作流执行完成后返回的值作为输出。

   
7. 对其余按钮重复上述步骤：

   按钮控件	工作流文件
   减去	calculator_Subtract_xaml
   乘以	calculator_Multiply_xaml
   除以	calculator_Divide_xaml

在 Orchestrator 中发布和部署应用程序

要准备执行应用程序，您需要将其发布到 Orchestrator 租户订阅源，然后进行部署。

1. 在 Apps 中，单击顶部导航栏上的“ 发布 ”。
2. 切换到 Orchestrator 并导航到所需的文件夹。
3. 转到“ 自动化”>“Apps ”，然后单击“ 部署应用程序”。 “ 部署应用程序 ”向导将打开。
4. 从“ 应用程序 ” 下拉列表中，选择以前发布的应用程序。
5. 单击 “部署”。 现在，您可以在 Orchestrator 文件夹中运行您的应用程序。

运行应用程序

您已准备好运行应用程序。

1. 在 UiPath Assistant 的“ 主页” 面板上，在“ Apps ” 类别下搜索您的应用程序。
2. 单击 “运行”。 系统会提示您授予 UiPath Robot Assistant 访问权限。
3. 输入两个数字。
4. 单击按钮以执行所需的算术运算。

第一次计算需要更长时间，因为它是作业的第一个实例化。 之后，作业将继续运行并立即返回结果。 当您关闭 Apps 会话时，作业将终止。