编辑网格

“编辑网格”控件用于列出、编辑、分页或搜索表格记录。

常规

• 数据源 - 要在网格内编辑的数据源。您必须引用 Apps 数据源类型的对象，例如 Data Service 实体或 Orchestrator 流程。

  获取数据源后，网格会自动检测数据列。单击每列的“更多”图标可导航至以下属性：

  • “名称”- 列标题的显示名称。

  • 来源 - 被引用实体的字段。

  • 编辑模式视图 - 确定如何与列交互：

    编辑模式视图选项	描述
    文本框	列中单元格的行为类似于文本框控件。
    日期选取器	列中单元格的行为类似于日期选取器控件。
    复选框	列中单元格的行为类似于复选框控件。
    下拉列表	列中单元格的行为类似于下拉控件。
    多选	列中单元格的行为类似于多选控件。

  • 隐藏 - 如果为 True，则在运行时隐藏列。

  • 可编辑 - 如果为 False，则将列的内容标记为只读。

• 添加新列 - 通过单击加号“+”图标向数据添加新列。

• 隐藏 - 如果为 True，则在 Runtime 隐藏该控件。

• 可编辑 - 如果为 False，则将控件标记为只读。

• 添加行 - 如果为 True，则允许应用程序用户在 Runtime 添加新行。如果为 False，则用户无法添加新行。

• 删除行 - 如果为 True，则允许应用程序用户删除行。如果为 False，则用户无法删除行。

• 搜索 - 如果为 True，则公开内置搜索功能。

Events

• 选定的行 - 配置选定行时会发生的情况。

• 添加的文件 - 配置添加文件时会发生的情况。

• 修改的行 - 配置修改行时会发生的情况。

• 删除的行 - 配置删除行时会发生的情况。

备注：

要访问更新、添加或编辑操作中的错误，请使用以下语法：

<PageName>.<ControlName>.<RuleName>.Error.Message

例如 MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message。

样式

• “控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

  注意：对齐方式取决于为父元素选择的布局（垂直与水平）。

• “背景颜色”- 网格标头和网格正文的背景颜色。

• “边框”- 控件的边框。可以配置边框粗细、颜色和半径。

• “字体”- 列标头和列正文文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 设置控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。

• “大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。如果控件的大小小于选项的大小，则系统会显示滚动条。

VB 属性

• 选定的项目 (T) - 引用应用程序用户当前选择的项目

• 数据源（T 的列表来源）- 引用控件上的可用数据。

• 新项目 (T) - 引用“添加行”选项正在创建的项目。在“添加的行”事件中使用。

• 隐藏（布尔值）- 引用控件的隐藏属性。

• 可编辑（布尔值）- 引用控件的可编辑属性。

• 添加行（布尔值）- 引用控件的添加行属性。

• 删除行（布尔值）- 引用控件的删除行属性。

• 搜索（布尔值）- 引用控件的搜索属性。

• 行索引（整数）- 引用列中的项目以进行更新和删除操作。

重要提示：

对于整个数据集位于内存中的流程集成，请使用此属性。

将复杂数据转换为 Apps 数据源

要将数据表或复杂数据类型转换为 Apps 数据源，请执行以下操作：将数据表保存到变量中，然后使用 .ToListSource 方法将数据表中的数据转换为 Apps 数据源。

1. 将数据保存到数据表类型的变量中。例如，将变量命名为“dt”。
2. 在表格控件的“数据源”字段中，使用以下表达式：

   dt.ToListSource()

通常，可以使用以下语法将复杂对象转换为 Apps 数据源：

Processes.ALLDATATYPES.out_datatable.ToListSource()

Using DataTable in Edit Grid controls

Make sure you already have a DataTable object in your app.

数据表对象可以定义为流程的输入、输出或输入/输出参数。 要使用这些数据表对象，您需要引用将它们用作参数的流程。

假设您有一个名为“Process_A”的流程，该流程将数据表对象作为参数：

输入参数	in_dt1
输出参数	out_dt1
输入/输出参数	inout_dt

编辑网格

1. 导航至“ 编辑网格 ”控件的“ 常规 ”选项卡。

2. 在控件的“数据源”字段中，打开表达式编辑器，然后编写以下表达式：

   Processes.<process_name>.<datatable_output_argument>.ToListSource

   例如：

   Processes.Process_A.out_dt1.ToListSource

3. 要对数据表的行执行添加、编辑或删除等操作，请执行以下操作：

   1. 确保将可编辑、添加行和删除行属性设置为true 。

      

   2. 切换到“ 编辑网格 ”控件的“ 事件 ”选项卡，然后配置相应的规则：

      1. 要添加行，请针对 添加 的行单击“ 创建规则 ”，然后使用“ 设置值 ”规则：

         要设置的项目	Processes.<process_name>.<datatable_output_parameter> 例如： Processes.Process_A.out_dt1
         值	Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem) 例如： Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)

      2. 要删除行，请单击“为 已删除 的行 创建规则 ” ，然后使用“ 设置值 ”规则：

         要设置的项目	Processes.<process_name>.<datatable_output_parameter> 例如： Processes.Process_A.out_dt1
         值	Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex) 例如： Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)

      3. 要修改行，请单击“为 修改 的行 创建规则 ”，然后使用“ 设置值 ”规则：

         要设置的项目	Processes.<process_name>.<datatable_output_parameter> 例如： Processes.Process_A.out_dt1
         值	Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem) 例如： Processes.Process_A.out_dt1.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)

将实体与“编辑网格”控件一起使用

以下示例演示了如何将实体绑定到“编辑网格”控件，然后使用控件和特定于实体的规则执行 CRUD 操作。

使用的实体称为“员工”，并包含以下字段：

• 名称

• 年龄

• 出生日期

• 性别

• 团队

• 加入日期

• 是完整时间

• 技能

显示实体记录

1. 新建一个 VB 应用程序，然后将“员工”实体添加到应用程序中。
2. 将“编辑网格”控件添加到应用程序。
3. 在“编辑网格”控件的“数据源”字段中，使用“查询生成器”并选择“员工”实体。控件的列会自动填充实体的字段。
4. 对于每一列，请确保将“编辑模式视图”下拉列表设置为正确的数据类型，如下所示：

   选项	描述
   出生日期	日期选取器
   年龄	文本框
   名称	文本框
   性别	下拉列表
   团队	下拉列表
   加入日期	日期选取器
   是完整时间	复选框
   技能	多选

   “性别”和“团队”是实体选项集。当您在这些列的编辑模式视图中选择“下拉列表”时，将显示两个新属性：“列表来源”和“列”。
5. 要获取选项集中的选项，请执行以下操作：
   1. 在“列表来源”字段中，使用以下语法

      GetChoiceSet("Choiceset Name")

      例如，对于“性别”和“团队”列，“列表来源”字段应包含以下内容：

      • 性别 - GetChoiceSet("Gender")
      • 团队 - GetChoiceSet("Team")
   2. 在“列”字段中写入“"Name"”。
      

   技能是一个允许多选的实体选择集。当您在这些列的编辑模式视图中选择“多选”时，将显示两个新属性：“列表来源”和“列”。

6. 像配置“性别”和“团队”一样配置“技能”列。
7. 转到“编辑网格”控件的“事件”选项卡。
8. 对于“添加的行”事件，创建以下规则：
   1. 添加“创建实体记录”规则。
   2. 在“应在哪个实体中创建记录？”中，选择“员工”实体。
   3. 在“要设置的值”字段中，更新以下内容：
      • 名称属性 - MainPage.EditGrid.NewItem.Name
      • 加入日期属性 - MainPage.EditGrid.NewItem.Dateofjoining
      • 年龄属性 - MainPage.EditGrid.NewItem.Age
      • 性别属性 - MainPage.EditGrid.NewItem.Gender
      • 团队属性 - MainPage.EditGrid.NewItem.Team
      • 是完整时间属性 - MainPage.EditGrid.NewItem.Isfulltime
      • 技能属性 - MainPage.EditGrid.NewItem.Skills
9. 对于“修改的行”事件，创建以下规则：
   1. 添加“更新实体记录”规则。
   2. 在“应更新哪个实体的记录？”中，选择“员工”实体。
   3. 在“实体记录 ID”中，写入以下表达式：

      MainPage.EditGrid.SelectedItem.Id

   4. 在“要设置的值”字段中，更新以下内容：
      • 名称属性 - MainPage.EditGrid.SelectedItem.Name
      • 加入日期属性 - MainPage.EditGrid.SelectedItem.Dateofjoining
      • 年龄属性 - MainPage.EditGrid.SelectedItem.Age
      • 性别属性 - MainPage.EditGrid.SelectedItem.Gender
      • 团队属性 - MainPage.EditGrid.SelectedItem.Team
      • 是完整时间属性 - MainPage.EditGrid.SelectedItem.Isfulltime
      • 技能属性 - MainPage.EditGrid.SelectedItem.Skills
10. 对于“删除的行”事件，创建以下规则：
    1. 添加“删除实体记录”规则。
    2. 在“应删除哪个实体记录？”中，选择“员工”实体。
    3. 在“实体记录 ID”中，写入以下表达式：

       MainPage.EditGrid.SelectedItem.Id

11. 预览您的应用程序并与“编辑网格”的各种功能进行交互，例如分页、搜索、添加新行、更新行或删除行。

在“编辑网格”控件中使用“关系”

要在“编辑网格”控件中使用“关系”类型的实体字段，请执行以下操作：

1. 在“编辑模式视图”字段中，将关系字段设置为“下拉列表”。
2. 在后续的“列表来源”属性中，使用以下表达式：

   Fetch(of <entity_name>)(Nothing, Nothing, Nothing, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

3. 在后续的“列”属性中，写入 "Name"。
4. 在与实体相关的规则（例如“创建”、“更新”或“删除实体记录”）中，传递关系字段的 ID，如下所示：

   MainPage.EditGrid.SelectedItem.<entity_name>.Id

演示

编辑网格：使用实体

简介

此应用程序演示了如何使用“编辑网格”控件处理实体。

演示应用程序 - 自行尝试

从 GitHub 下载演示应用程序

在 Cloud 中预览演示应用程序

演示应用程序 - 使用说明

1. 下载包含演示应用程序的 zip 文件。 它包含：

   • schema.json - 应用程序使用的实体的架构

   • EditGridEntity_DemoApp.uiapp - the UiPath^® Apps file

2. In UiPath^® Data Service, import the Schema.json file. Make sure to import both Entities (Country and Employees) and Choice Sets (Gender and Skills).
3. 使用数据填充实体和选项集。
4. In UiPath^® Apps, create a new app and import the downloaded app.
5. 您可能会注意到一些错误。 要修复这些问题，请将引用的“员工”实体替换为您最近在步骤 2 中导入的实体。
6. 预览应用程序并与编辑网格中的数据进行交互。