- 入门指南
- 在开始之前
- 如何
- 通知
- 使用 VB 表达式
- 设计应用程序
- 事件和规则
- 在应用程序中利用 RPA
- 在应用程序中利用实体
- 在应用程序中利用队列
- 应用程序生命周期管理 (ALM)
- 基本故障排除指南
编辑网格
“编辑网格”控件用于列出、编辑、分页或搜索表格记录。
-
数据源 - 要在网格内编辑的数据源。您必须引用 Apps 数据源类型的对象,例如 Data Service 实体或 Orchestrator 流程。
获取数据源后,网格会自动检测数据列。单击每列的“更多”图标可导航至以下属性:
-
“名称”- 列标题的显示名称。
-
来源 - 被引用实体的字段。
-
编辑模式视图 - 确定如何与列交互:
编辑模式视图选项
描述
文本框
列中单元格的行为类似于文本框控件。
日期选取器
列中单元格的行为类似于日期选取器控件。
复选框
列中单元格的行为类似于复选框控件。
下拉列表
列中单元格的行为类似于下拉控件。
多选
列中单元格的行为类似于多选控件。
-
隐藏 - 如果为 True,则在运行时隐藏列。
-
可编辑 - 如果为 False,则将列的内容标记为只读。
-
-
添加新列 - 通过单击加号“+”图标向数据添加新列。
-
隐藏 - 如果为 True,则在 Runtime 隐藏该控件。
-
可编辑 - 如果为 False,则将控件标记为只读。
-
添加行 - 如果为 True,则允许应用程序用户在 Runtime 添加新行。如果为 False,则用户无法添加新行。
-
删除行 - 如果为 True,则允许应用程序用户删除行。如果为 False,则用户无法删除行。
-
搜索 - 如果为 True,则公开内置搜索功能。
-
选定的行 - 配置选定行时会发生的情况。
-
添加的文件 - 配置添加文件时会发生的情况。
-
修改的行 - 配置修改行时会发生的情况。
-
删除的行 - 配置删除行时会发生的情况。
要访问更新、添加或编辑操作中的错误,请使用以下语法:
<PageName>.<ControlName>.<RuleName>.Error.Message
<PageName>.<ControlName>.<RuleName>.Error.Message
MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message
。
-
“控件对齐”- 默认情况下,继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式,请取消选择覆盖的选项。
注意:对齐方式取决于为父元素选择的布局(垂直与水平)。 -
“背景颜色”- 网格标头和网格正文的背景颜色。
-
“边框”- 控件的边框。可以配置边框粗细、颜色和半径。
-
“字体”- 列标头和列正文文本的字体属性,例如字体系列、大小、颜色或样式(粗体、斜体和下划线)。默认情况下,控件会继承直属父容器的字体系列,这由关键字“已继承”指示。
-
“边距”- 设置控件的边距。默认情况下,边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
-
“大小”- 控件的宽度和高度。默认情况下,大小设置为
auto
。要设置最小值或最大值,请单击三点图标 (...)。如果控件的大小小于选项的大小,则系统会显示滚动条。
VB 属性 |
数据类型 |
描述 |
---|---|---|
SelectedItem |
|
引用控件中当前选定的项目。 |
数据源 |
|
引用“表格” 控件内值的数据源。 |
新项目 |
|
引用“添加行” 选项正在创建的项目。 “添加的行”事件引用此属性。 |
可编辑 |
布尔值 | 确定“编辑网格”是否可编辑。 |
添加行 |
布尔值 |
确定是否可以将行添加到编辑网格。 |
删除行 |
布尔值 |
确定是否可以从“编辑网格”中删除行。 |
行索引 |
整数 |
引用行的索引以进行更新和删除操作。 应用于整个数据集位于内存中的流程集成。 |
搜索 |
布尔值 |
启用或禁用搜索功能。 如果为 true,则启用搜索。 |
值 |
| 控件的当前选定值。
|
隐藏 |
布尔值 | 如果为 True,则在 Runtime 隐藏该控件。 |
已禁用 |
布尔值 | 如果为 True,则在 Runtime 禁用该控件。 |
.ToListSource
方法将数据表中的数据转换为 Apps 数据源。
通常,可以使用以下语法将复杂对象转换为 Apps 数据源:
Processes.ALLDATATYPES.out_datatable.ToListSource()
Processes.ALLDATATYPES.out_datatable.ToListSource()
确保应用程序中已有数据表对象。
数据表对象可以定义为流程的输入、输出或输入/输出参数。 要使用这些数据表对象,您需要引用将它们用作参数的流程。
数据表仅支持列中的基元。 列中的复杂类型参数在数据表中不起作用。
假设您有一个名为“Process_A”的流程,该流程将数据表对象作为参数:
输入参数 |
in_dt1 |
输出参数 |
out_dt1 |
输入/输出参数 |
inout_dt |
-
导航至“ 编辑网格 ”控件的“ 常规 ”选项卡。
-
在控件的“数据源”字段中,打开表达式编辑器,然后编写以下表达式:
Processes.<process_name>.<datatable_output_argument>.ToListSource
Processes.<process_name>.<datatable_output_argument>.ToListSource例如:
Processes.Process_A.out_dt1.ToListSource
Processes.Process_A.out_dt1.ToListSource -
要对数据表的行执行添加、编辑或删除等操作,请执行以下操作:
-
确保将可编辑、添加行和删除行属性设置为true 。
-
切换到“ 编辑网格 ”控件的“ 事件 ”选项卡,然后配置相应的规则:
-
要添加行,请针对 添加 的行单击“ 创建规则 ”,然后使用“ 设置值 ”规则:
要设置的项目
Processes.<process_name>.<datatable_output_parameter>
Processes.<process_name>.<datatable_output_parameter>例如:
Processes.Process_A.out_dt1
Processes.Process_A.out_dt1值
Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem)
Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem)例如:
Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)
Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem) -
要删除行,请单击“为 已删除 的行 创建规则 ” ,然后使用“ 设置值 ”规则:
要设置的项目
Processes.<process_name>.<datatable_output_parameter>
Processes.<process_name>.<datatable_output_parameter>例如:
Processes.Process_A.out_dt1
Processes.Process_A.out_dt1值
Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex)
Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex)例如:
Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)
Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex) -
要修改行,请单击“为 修改 的行 创建规则 ”,然后使用“ 设置值 ”规则:
要设置的项目
Processes.<process_name>.<datatable_output_parameter>
Processes.<process_name>.<datatable_output_parameter>例如:
Processes.Process_A.out_dt1
Processes.Process_A.out_dt1值
Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)
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)
Processes.Process_A.out_dt1.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)
-
-
以下示例演示了如何将实体绑定到“编辑网格”控件,然后使用控件和特定于实体的规则执行 CRUD 操作。
使用的实体称为“员工”,并包含以下字段:
-
名称
-
年龄
-
出生日期
-
性别
-
团队
-
加入日期
-
是完整时间
-
技能
简介
此应用程序演示了如何使用“编辑网格”控件处理实体。