Microsoft Dataverse为管理员提供了创建可供所有用户使用的系统视图的方法。 单个用户可以保存高级查找查询,以便在应用程序中重复使用。 这两个都表示可以使用 Web API 检索和执行的预定义查询。
Note
与使用 OData 语法的查询不同,从预定义查询或 fetchXml 返回的数据不会返回具有 null 值的属性。 当值为 null 时,该属性将不会包含在结果中。
当使用 OData 语法返回查询结果时,记录将包含一个 null 值的属性,如下所示:
{
"@odata.etag": "W/\"46849433\"",
"name": "Contoso, Ltd. (sample)",
"accountnumber": null,
"accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89"
}
使用预定义查询或 FetchXml 检索时,同一记录将不包含 accountnumber 该属性,因为它是 null,如下所示:
{
"@odata.etag": "W/\"46849433\"",
"name": "Contoso, Ltd. (sample)",
"accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89"
}
预定义查询
Dataverse 允许定义、保存和执行两种类型的查询,如下所示。
| 查询类型 | Description |
|---|---|
| 保存的查询 | 表(实体)的系统定义视图。 这些视图存储在 savedquery 实体类型 中。 详细信息: 自定义表视图 |
| 用户查询 | 高级查找功能用于搜索用户针对某张表(实体)保存的记录。 这些视图保存在 userquery EntityType 中。 详细信息: UserQuery(已保存视图)表 |
这两种类型的实体的记录都包含要返回的数据的 FetchXML 定义。 可以查询相应的实体类型以检索主键值。 使用主键值,可以通过传递主键值来执行查询。 例如,若要执行 活动帐户 保存的查询,必须先使用如下所示的查询获取主键。
GET [Organization URI]/api/data/v9.2/savedqueries?$select=name,savedqueryid&$filter=name eq 'Active Accounts'
然后,可以使用 savedqueryid 值,并将其作为传递给帐户实体集的 savedQuery 参数值。
GET [Organization URI]/api/data/v9.2/accounts?savedQuery=00000000-0000-0000-00aa-000010001002
使用同一方法获取 userqueryid,并将其作为 userQuery 参数的值传递给与保存的查询对应的 returnedtypecode 的实体集。
GET [Organization URI]/api/data/v9.2/accounts?userQuery=121c6fd8-1975-e511-80d4-00155d2a68d1
将查询应用于适当类型的任何集合
除了仅将保存的查询应用于主实体集集合之外,还可以使用保存的查询或用户查询对适当类型实体的任何集合应用相同的筛选。 例如,如果要仅对与特定实体相关的实体应用查询,则可以应用相同的模式。 例如,以下 URL 将通过 集合值导航属性,针对与特定帐户相关的机会应用 opportunity_parent_account 查询。
GET [Organization URI]/api/data/v9.2/accounts(8f390c24-9c72-e511-80d4-00155d2a68d1)/opportunity_parent_account/?savedQuery=00000000-0000-0000-00aa-000010003001
另请参阅
Web API 查询数据示例 (C#)
Web API 查询数据示例 (客户端 JavaScript)
使用 Web API 执行操作
撰写 Http 请求并处理错误
使用 Web API 查询数据
使用 Web API 创建表行
使用 Web API 检索表行
使用 Web API 更新和删除表行
使用 Web API 关联和取消关联表行
使用 Web API 函数
使用 Web API 操作
使用 Web API 执行批处理作
使用 Web API 模拟其他用户
使用 Web API 进行条件操作