数据网格

本教程分步指导您如何创建和使用数据网格组件。 您将学习如何将数据传递到数据网格，如何实时更新数据，以及如何提取信息。 本教程使用 CSV 文件将数据输入到数据网格。

此自动化使用学生及其考试结果的 CSV 记录，并将其显示在表单中，您可以在表单中实时更新考试结果及其相应状态（“通过”或“失败”）。 此外，自动化允许您在控制台中触发记录和输出的提取。

1. 新建表单。 在此示例中，将其命名为 DataGrid。
   1. 在表单中添加数据网格组件。
   2. 在 CSV 文件中为要传递到表单的每一列添加相应的组件。
      对于此示例，添加一个 文本字段 (fullName)、一个 复选框 (seniorYear) 和一个 下拉列表 (examResults)。
      
      

      

      
      
      注意： 组件的 属性名称 区分大小写，并且应与 CSV 文件中的列名称以及数据表的列名称精确匹配。
   3. 此外，在名为 “ 状态”的数据网格中添加一个额外的文本字段。 这将用于表单更新。
   4. 在数据网格外部添加一个 按钮 。 此按钮将触发 数据网格的提取。
   
   

   

   
   
2. 在 主 工作流中，添加并配置以下活动：
   1. 读取 CSV - 为数据网格输入包含数据的 CSV 文件。 创建一个数据表变量以存储输出的 CSV 文件。
      在此示例中，将其命名为 dataGridDataTable。
   2. 返回到表单，将“数据网格”组件的“ 属性名称 ”设置为在子步骤 a 创建的“数据表”变量，用于存储输出 CSV 文件。 在此示例中，将“ 属性名称 ”设置为 dataGridDataTable。
   3. 显示表单 - 选择“数据网 格 ”表单，然后将数据从数据表传递到数据网格。
   4. 在“ 参数 ”字典中，为 dataGrid 参数添加一个类型为 System.Data.DataTable 、方向为 In 的条目，并将值设置为 dataGridDataTable。

      密钥	类型	方向	值
      dataGrid （ 数据网格 的 属性名称）	System.Data.DataTable	In	dataGridTable

   5. 运行本地触发器 - 启用项目中的所有触发器。
3. 创建一个名为 “fieldChangedTrigger”的触发器工作流，负责根据学生的考试结果将其状态设置为“失败”或“通过”。
   1. 添加 表单触发器活动，并设置 examResults 字段更改时的事件。
   2. 添加“ 构建数据表” 活动，以创建在触发触发器时将存储数据网格值的数据表。
      将输出变量命名为 editedDataTable。
   3. 添加 “ 获取表单值” 活动，以将数据网格检索到您在子步骤 b（editedDataTable）中创建的数据表中。
   4. 添加“遍历 行” 活动，以遍历每个检查结果并相应地设置 Status 字段。 在“数据表” 字段中输入您在子步骤 b (editedDataTable) 中创建的 数据表 。
   5. 在“ 遍历行” 活动的主体中， 添加一个 If 活动，并将条件设置为 CurrentRow("examResults").ToString="f"。
      请注意， 值 区分大小写。 这就是我们在条件中使用小写“f”而不是大写“F”的原因。

      
      

      

      
      
   6. 在“ Then ” 正文中，添加一个“ 分配 ” 活动，以便当学生的考试结果为“F”时，将其状态分配为“失败”。

      保存位置	要保存的值
      CurrentRow("status")	"failed"

   7. 在“ Else ”正文中，再次添加“ 分配 ”活动，这次是针对学生的状态为“通过”的情况，因为他们的考试结果不是 F。

      保存位置	要保存的值
      CurrentRow("status")	"passed"

   8. 在“遍历 行 ”活动之外，添加 “ 设置表单值” 活动，以将更新的数据网格传递回表单。 在 键 字段中，将 dataGrid 与 类型 System.Data.DataTable 结合使用，并将值设置为 editedDataTable。

      密钥	类型	值
      dataGrid	System.Data.DataTable	editedDataTable

4. 创建一个名为“ Extract Clicked”的触发器工作流，负责提取数据网格并将其输出为 CSV 格式的字符串。
   1. 添加 表单触发器活动 ，并设置单击 extract 按钮时的事件。
   2. 添加 “ 获取表单值” 活动，以将数据网格提取到数据表中。 在 参数 字典中为 dataGrid 添加一个 类型 为 System.Data.DataTable 的条目，并将 值 设置为 output。

      dataGrid	System.Data.DataTable	output

   3. 添加“ 输出数据表 ” 活动，以将提取的数据网格输出为 CSV 格式的字符串。 在 数据表 字段中，输入在子步骤 b (output) 中用于提取数据网格的变量。 在“ 文本 ”字段中，输入您将在输出控制台中记录的字符串变量
   4. 添加“ 日志消息” 活动以输出提取的数据网格。
   5. 添加 “停止本地触发器” 活动以关闭表单并停止执行（假设您在提取表单后不想与表单交互）。

下图显示了在表单仍显示时更新数据的结果。

工作流示例

要按照这些步骤自行尝试本教程，请参阅 示例工作流。