Dataverse 列表提供所有环境数据库共有的基础表集。
Dynamics 365 启用应用程序表/实体引用包含安装 Sales 等 Dynamics 365应用程序所需的附加表。
当你选择安装 Dynamics 365 Sales 时,将添加或修改此处列出的表,同时向 所创建的环境添加 Dataverse。
此引用仅包含满足以下条件的表:
IsPrivate 等于
false- 这不包括不存在外部用例的表。 了解私有表
IsIntersect 等于
false或 IsIntersect 等于true且该表包含超过 4 列。- 大多数交集表仅包含支持多对多关系所需的 4 列。 它们没有实际用途。 超过四列的交集表则更具价值。
Messages
此列表中的消息适用于实体本身。 例如:用户拥有的表支持 Assign、GrantAccess、ModifyAccess和 RevokeAccess 消息,而组织拥有的表则不支持。
SDK for .NET
使用 .NET SDK 时,通常可调用对应请求类,该类属于 Microsoft.Crm.Sdk.Messages 或 Microsoft.Xrm.Sdk.Messages 命名空间。 此类消息名称均带有 Request 前缀。
部分消息作为自定义操作添加至其支持的解决方案中。 这些消息未在 SDK 程序集内定义,但存在多种使用方式。
网络应用程序接口
使用 Web API 时,可在以下参考文档中查找常见 Dataverse OData 函数和操作:
对于这些函数、操作及后续新增项,可通过以下方式了解使用方法:
- 查阅 $metadata 服务文档以获取参数和返回值的详细说明。 参见操作定义和函数定义以获取详细信息。
- 调用操作和函数。 参见使用 Web API 操作和使用 Web API 函数以获取详细信息。
事件
事件是可供订阅的消息。 除非您添加了该事件,否则不应调用该消息,仅可订阅它。 订阅事件有多种方式,例如:
- 使用 Power Automate Dataverse 连接器,通过执行操作时触发器实现。
- 注册 Dataverse 插件以响应事件。
- 通过 Dataverse Azur e集成将事件数据发送到 Azure 或 web hook
属性
本节仅包含精选实体属性而非全部属性。 仅包含对开发人员最有价值的属性。 部分实体属性值可被修改。
列
列信息分为两个独立部分:可写列/属性与只读列/属性。 此分类旨在突出开发人员在创建或更新表行时可设置的列。 理解这些列有助于开发者掌握除值检索之外的表操作能力。
可写列/属性部分的列在IsValidForCreate 或 IsValidForUpdate 属性(通常两者皆是)返回 true 时生效。 若任一属性返回 false,则会特别标注。
只读列/属性对 IsValidForCreate和 IsValidForUpdate 属性始终返回 false。
本参考文档中的选择列选项基于以英语为基础语言的部署环境。 某些选项可能因创建环境时选择的基础语言而有所不同。 这些差异旨在更贴合特定语言或文化背景的最佳选项。 您可自由定制这些选项,通过修改标签或按需增删选项进行调整。
Relationships
EntityMetadata 类包含三个表示关系属性的字段:
| 资产 | 类型 | Description |
|---|---|---|
| OneToManyRelationships | OneToManyRelationshipMetadata[] | 获取实体的一对多关系数组。 |
| ManyToOneRelationships | OneToManyRelationshipMetadata[] | 获取实体的多对一关系数组。 |
| ManyToManyRelationships | ManyToManyRelationshipMetadata[] | 获取实体的多对多关系数组。 |
注释
需注意:虽然每张表列出其适用的关系,但每种关系均由两张表共享。 表之间存在关系。 虽然存在一对多关系,但多对一关系仅是从引用表视角呈现的一对多关系。
多对一关系
包含以下 OneToManyRelationship 属性:
| 资产 | Description |
|---|---|
ReferencedEntity |
关联表的逻辑名称。 |
ReferencedAttribute |
关联表主键的逻辑名称。 |
ReferencingEntity |
包含查找列的关联表逻辑名称。 |
ReferencingAttribute |
关联表中存储主表主键引用值的查找列逻辑名称。 |
IsHierarchical |
该关系是否表示自引用层次结构关系 |
CascadeConfiguration |
描述父实体操作将级联至关联实体的数据。 更多信息:级联配置 |
一对多关系
包含以下 OneToManyRelationship 属性:
| 资产 | Description |
|---|---|
ReferencingEntity |
关联表的逻辑名称。 |
ReferencingAttribute |
关联表中包含主表主键引用列的逻辑名称。 |
IsCustomizable |
关系属性是否可修改。 |
ReferencedEntityNavigationPropertyName |
此关系对应的 Web API 集合值导航属性的名称。 更多信息:Web API 导航属性 |
AssociatedMenuConfiguration |
模型驱动应用程序使用的数据,用于控制是否以及如何从主实体在用户界面访问相关实体数据。 |
多对多关系
每个多对多关系包含 Entity1LogicalName 和 Entity2LogicalName。 本文档中,关系细节在当前表上下文中提供。 具体是 Entity1 还是 Entity2 并不重要。
每种多对多关系包含以下属性:
| 资产 | Description |
|---|---|
IntersectEntityName |
支持该多对多关系的交叉表逻辑名称。 通过 FetchXml 连接表列时可使用此值 |
IsCustomizable |
关系属性是否可修改。 |
SchemaName |
关系模式名称。 |
IntersectAttribute |
交叉表中作为此类型记录主键的列名称。 |
NavigationPropertyName |
此关系对应的 Web API 集合值导航属性的名称。 更多信息:Web API 导航属性 |
AssociatedMenuConfiguration |
模型驱动应用程序用于控制是否及如何从当前表在 UI 中访问第二张表数据的参数。 |
当多对多关系发生自引用(如连接角色 (ConnectionRole) connectionroleassociation_association)的罕见情况时,会在属性名前添加 Entity1 或 Entity2 前缀。
| 资产 | 价值 |
|---|---|
Entity1IntersectAttribute |
在交叉表中,作为第一表的此类型记录的主键列名称。 |
Entity2IntersectAttribute |
在交叉表中,作为第二表的此类型记录的主键列名称。 |
Entity1NavigationPropertyName |
作为第一表的此关系对应的 Web API 集合值导航属性名称。 |
Entity2NavigationPropertyName |
作为第二表的此关系对应的 Web API 集合值导航属性名称。 |
Entity1AssociatedMenuConfiguration |
模型驱动应用程序用于控制是否以及如何从本表(作为主表)在 UI 中访问次表数据的参数。 |
Entity2AssociatedMenuConfiguration |
模型驱动应用程序用于控制是否以及如何从本表(作为次表)在 UI 中访问次表数据的参数 |