提供用于处理网格和视图上的数据的属性和方法。
适用于
模型驱动和画布应用。
属性
columns
此数据集中可用的列集。 在模型驱动和画布应用中都受支持。
类型： Column[]
错误
数据检索中是否发生错误。 在模型驱动和画布应用中都受支持。
类型：boolean
错误代码
与上次遇到的错误关联的错误代码（如果适用）。
errorMessage
与上次遇到的错误关联的错误消息（如果适用）。
类型：number | string
滤波
当前查询的列筛选。 在模型驱动和画布应用中都受支持。 可以通过设置 context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>)为数据集配置筛选。 设置筛选器后，调用 context.parameters.[dataset_property_name].refresh() 将从数据源检索筛选的数据。
| 价值 | 条件运算符 | 模型驱动应用 | 画布应用 |
|---|---|---|---|
| -1 | None | 是的 | 是的 |
| 0 | Equal | 是的 | 是的 |
| 1 | NotEqual | 是的 | 是的 |
| 2 | GreaterThan | 是的 | 是的 |
| 3 | LessThan | 是的 | 是的 |
| 4 | GreaterEqual | 是的 | 是的 |
| 5 | LessEqual | 是的 | 是的 |
| 6 | 喜欢 | 是的 | 是的 |
| 7 | NotLike | 否 | 是的 |
| 8 | In | 是的 | 是的 |
| 12 | Null | 是的 | 是的 |
| 13 | NotNull | 否 | 是的 |
| 14 | 昨天 | 是的 | 否 |
| 15 | 今天 | 是的 | 否 |
| 16 | 明天 | 是的 | 否 |
| 17 | Last7Days | 是的 | 否 |
| 18 | Next7Days | 是的 | 否 |
| 19 | LastWeek | 是的 | 否 |
| 20 | ThisWeek | 是的 | 否 |
| 22 | LastMonth | 是的 | 否 |
| 23 | ThisMonth | 是的 | 否 |
| 二十五 | 启用 | 是的 | 否 |
| 26 | OnOrBefore | 是的 | 否 |
| 二十七 | OnOrAfter | 是的 | 否 |
| 28 | LastYear | 是的 | 否 |
| 二十九 | ThisYear | 是的 | 否 |
| 33 | LastXDays | 是的 | 否 |
| 34 | NextXDays | 是的 | 否 |
| 37 | LastXMonths | 是的 | 否 |
| 38 | NextXMonths | 是的 | 否 |
| 49 | 包含 | 是的 | 是的 |
| 54 | BeginWith | 否 | 是的 |
| 55 | DoesNotBeginWidth | 否 | 是的 |
| 56 | EndsWidth | 否 | 是的 |
| 57 | DesNotEndWith | 否 | 是的 |
| 70 | InFiscalPeriodAndYear | 是的 | 否 |
| 75 | 上方 | 是的 | 是的 |
| 76 | 低于 | 是的 | 是的 |
| 77 | NotUnder | 是的 | 是的 |
| 78 | AboveOrEqual | 是的 | 是的 |
| 79 | UnderOrEqual | 是的 | 是的 |
| 87 | ContainValues | 是的 | 是的 |
| 88 | DoesNotContainValues | 否 | 是的 |
注释
筛选功能仅适用于 Dataverse 数据源。
类型： 筛选
连接
定义链接表信息。 仅在模型驱动应用中受支持。
类型： 链接
装载
指示数据集是否正在加载。 在模型驱动和画布应用中都受支持。
类型：boolean
寻呼
分页状态和作。 在模型驱动和画布应用中都受支持。 可以使用
注释
Dataverse 数据源不会返回 totalRecordCount 画布应用的分页对象。 相反，它使用 hasNextPage 并 hasPreviousPage 检查是否要提取更多记录。
数据集组件可用于 context.parameters.[dataset_property_name].paging.setPageSize(pageSize) 更改每页检索的记录数。
类型： 分页
记录
ID 映射到完整记录对象。 在模型驱动和画布应用中都受支持。
类型： EntityRecord
sortedRecordIds
数据集中记录的 ID，按查询响应结果排序。 在模型驱动和画布应用中都受支持。
类型：string[]
排序
当前查询的排序状态。 在模型驱动和画布应用中都受支持。 可以通过设置 context.parameters.[dataset_property_name].sorting = [SortStatus]为数据集配置排序。 配置排序后，调用 context.parameters.[dataset_property_name].refresh() 将检索数据源中的已排序数据。
注释
排序功能仅适用于 Dataverse 数据源。
此外，如果重新配置排序，它将重置筛选器 context.parameters.[dataset_property_name].filtering
类型： SortStatus[]
Methods
| 方法 | Description | 适用于 |
|---|---|---|
| addColumn | 将列添加到列集。 | 模型驱动应用 |
| clearSelectedRecordIds | 清除所选记录 ID 列表。 | 模型驱动和画布应用 |
| delete | 从数据源中删除记录。 | 画布应用 |
| getCommands | 数据集的命令。 | 画布应用 |
| getDataSetCapabilities | 数据集的功能。 | 画布应用 |
| getSelectedRecordIds | 检索所有所选记录 ID。 | 模型驱动和画布应用 |
| getTargetEntityType | 返回目标表类型名称。 | 模型驱动和画布应用 |
| getTitle | 检索数据集属性使用的视图显示名称。 | 模型驱动和画布应用 |
| getViewId | 返回数据集参数使用的视图的 ID。 | 模型驱动和画布应用 |
| newRecord | 初始化用于控件的本地记录对象以设置值。 控件需要对新创建的记录调用 save() 该方法来保留更改。 |
画布应用 |
| openDatasetItem | 打开给定 EntityReference 的数据集项。 它检查是否有命令按钮 ID Mscrm.OpenRecordItem的命令。 如果存在，它将执行该命令，否则它只导航到 EntityReference 的关联形式。 |
模型驱动和画布应用 |
| 刷新 | 基于筛选器、排序、链接、新列刷新数据集。 此外，刷新会将分页重置为第 1 页。 | 模型驱动和画布应用 |
| retrieveRecordCommand | 检索记录的关联命令。 如果清单中有多个数据集，则 retrieveRecordCommand 返回第一个数据集的命令。 | 模型驱动 |
| setSelectedRecordIds | 设置所选记录的 ID。 | 模型驱动和画布应用 |
查阅列
现在可以检索 Dataverse 表的查阅列。 对于画布应用，如果数据集中包含查阅列，则会检索引用记录中的所有列。
GetFormattedValue 返回此列的 JSON 字符串。
GetValue 方法直接返回 JSON 对象。
Example
若要详细了解如何实现数据集方法，请参阅 数据集网格组件