使用数据源和值绑定

背景信息

控件的“数据源”和“值绑定”字段是双向绑定的，这意味着它们都可以更新绑定到该控件的根数据。

为了更好地理解这一点，我们可以举一个简单的例子。您可以尝试向应用程序添加标签和文本框，然后创建应用程序变量。将文本框控件的“值绑定”属性和标签控件的“文本”属性分配给变量。预览应用程序时，请注意，当您更改文本框的值时，应用程序变量也会随之更新。另一方面，“文本”属性是单向绑定字段，显示的数据无法更新。

示例

在此示例中，我们将构建一个应用程序，用户可以在其中从来自流程的自定义列表中选择多个项目。

对于此示例，我们将构建以下内容：

• 自动化流程
• 使用“UiPath Apps”的应用程序

构建工作流

此示例的第一步是在 UiPath Studio 中构建工作流。这是一个简单的工作流，包含一些参数。

1. 打开 Studio ，创建一个新“流程”。

2. 创建以下参数:

   参数名称	方向	参数类型	默认值
   out_DataTable	输出	数据表	-
   in_SelectedItems	输入	数据表	new DataDable
   filtered_SelectedItems	输出	数据表	-

3. 将“序列”活动拖动至“工作流设计器”。

4. 在“序列”容器中添加“构建数据表”活动。

   • 在“数据表”字段中添加“out_DataTable”参数。
   • 添加名为 Selected 的列。

   • 如下图所示配置规则。

     
     

     

     
     

5. 在“构建数据表”活动下方添加“If”活动，并按照以下步骤对其进行配置。

   • 在“条件”字段中添加in_SelectedItems.Rows.Count > 0 。

   • 配置 Then 和 Else ，如下所示。

     Then

     1. 将“序列”拖动至“Then”容器内。

     2. 在“序列”容器中添加“分配”活动。

     - 在“ 收件人” 字段中添加“ filtered_SelectedItems ”。

     - 添加 (from r In in_SelectedItems.Select() Where r("Selected").Equals(true) 在“ 值 ” 字段中选择 r).CopyToDataTable 。

     3. 在“分配”活动下方添加“日志消息”活动。
     - 将日志级别设置为 Info。
     - 在“ 消息” 字段中添加filtered_SelectedItems.ToString 。

     Else

     1. 将“序列”拖动至“Else”容器内。

     2. 在“分配”活动下方添加“日志消息”活动。

     - 将日志级别设置为 Info。
     - 在“ 消息” 字段中添加"First run or empty" 。

结果

最后，工作流应如下图所示。

重要提示：

如果流程在其输入或输出中使用复杂的 .NET 对象（例如数据表），则 App Studio 在默认情况下不知道该对象的字段是什么。您可以通过以下两种方法指定字段：

• 在将流程添加到应用程序之前，运行该流程。 如果流程使用对象，则 Apps 将检查其作业历史记录，以自动检测该对象的架构/字段。
• 手动指定流程输入/输出的对象字段。如果流程没有作业历史记录，那么在将其添加到应用程序后，您必须手动指定其字段，以便在应用程序中使用这些字段。

如果刷新流程，则会删除手动添加到流程的参数。

生成您的应用程序

在“构建工作流”过程中将工作流内部版本发布到 Orchestrator 后，就可以构建应用程序本身了。

1. 创建新应用程序
2. 参考上面构建的流程。
3. 将一个自定义列表控件和一个表格控件并排添加到应用程序中。
4. 在表格的“数据源”字段中，添加流程中的 Out: out_DataTable。
   
   

   

   
   
5. 将“复选框”控件和“文本框”控件添加到自定义列表中，并进行如下配置：
   • 在复选框控件的“标签”字段中添加流程的 Out: out_DataTable 部分中的 Out: Item 项目。
   • 在复选框控件的“值”绑定字段中添加流程的 Out: out_DataTable 部分中的 Out: Selected 项目。
   • 在文本框控件的“值”绑定字段中添加流程的 Out: out_DataTable 部分中的 Out: Quantity 项目。
6. 添加 Button 控件并将其命名为 Run。按如下方式配置“单击”规则：
   • 添加“启动流程”规则。
   • 在“作业名称”字段中添加名称，并将其标记为有人值守。
   • 在“输入覆盖”字段中添加 in_SelectedItems 和 Out.out_DataTable。
     
     

     

     
     
7. 在按钮下方添加一个容器。
8. 相邻添加两个标签控件。
   • 在第一个标签的“文本”字段中添加流程的 Out: filtered_SelectedItems 部分中的 filtered_SelectedItems.Item 项目。
     • 在第一个标签的“文本”字段中添加流程的 Out: filtered_SelectedItems 部分中的 filtered_SelectedItems.Quantity 项目。

结论

预览应用程序时，您将能够在来自流程的自定义列表中选择项目。

此示例的关键是更好地了解数据源、值绑定和输入之间的区别：

• 数据源和值绑定是双向绑定的。这意味着它们都可以更新绑定到控件的根数据。
• 输入覆盖允许您传入来自其他来源的对象，例如来自流程的数据表或来自 Data Service 的实体。