Dataverse 表/实体引用

使用此引用可了解可为特定表执行的可用作、每个表的默认列以及表之间的关系。

此引用仅包含满足以下条件的表:

  • IsPrivate 等于false

    • 这不包括不存在外部用例的表。
  • IsIntersect 等于 falseIsIntersect 等于 true 且该表包含超过 4 列。

    • 大多数交集表仅包含支持多对多关系所需的 4 列。 它们没有实际用途。 超过四列的交集表则更具价值。

若要查看环境中所有表的信息,请参阅 环境中的“浏览表”定义

Dynamics 365 产品表参考

Dynamics 365 产品使用 Dataverse。 为 Dynamics 365 产品创建环境时,环境对所有 Dynamics 365 产品都有一组通用表。 这些表包含在 Dynamics 365 Enabled apps 表/实体引用中。

每个特定的 Dynamics 365 产品都可以添加其他表。 下表显示了特定 Dynamics 365 产品的表引用:

产品文档 产品表参考
销售 销售表/实体引用
现场服务 Field Service 表/实体引用
顾客服务 客户服务表/实体引用

属性

本节仅包含精选实体属性而非全部属性。 仅包含对开发人员最有价值的属性。 部分实体属性值可被修改。

列信息分为两个独立部分:可写列/属性只读列/属性。 此分类旨在突出开发人员在创建或更新表行时可设置的列。 理解这些列有助于开发者掌握除值检索之外的表操作能力。

可写列/属性部分的列在IsValidForCreateIsValidForUpdate 属性(通常两者皆是)返回 true 时生效。 若任一属性返回 false,则会特别标注。

只读列/属性IsValidForCreateIsValidForUpdate 属性始终返回 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 模型驱动应用程序使用的数据,用于控制是否以及如何从主实体在用户界面访问相关实体数据。

多对多关系

每个多对多关系包含 Entity1LogicalNameEntity2LogicalName。 本文档中,关系细节在当前表上下文中提供。 具体是 Entity1 还是 Entity2 并不重要。

每种多对多关系包含以下属性:

资产 Description
IntersectEntityName 支持此多对多关系的相交表的逻辑名称
IsCustomizable 关系属性是否可修改。
SchemaName 关系模式名称。
IntersectAttribute 交叉表中作为此类型记录主键的列名称。
NavigationPropertyName 此关系对应的 Web API 集合值导航属性的名称。
更多信息:Web API 导航属性
AssociatedMenuConfiguration 模型驱动应用程序用于控制是否及如何从当前表在 UI 中访问第二张表数据的参数。

当多对多关系发生自引用(如连接角色 (ConnectionRole) connectionroleassociation_association)的罕见情况时,会在属性名前添加 Entity1Entity2 前缀。

资产 价值
Entity1IntersectAttribute 在交叉表中,作为第一表的此类型记录的主键列名称。
Entity2IntersectAttribute 在交叉表中,作为第二表的此类型记录的主键列名称。
Entity1NavigationPropertyName 作为第一表的此关系对应的 Web API 集合值导航属性名称。
Entity2NavigationPropertyName 作为第二表的此关系对应的 Web API 集合值导航属性名称。
Entity1AssociatedMenuConfiguration 模型驱动应用程序用于控制是否以及如何从本表(作为主表)在 UI 中访问次表数据的参数。
Entity2AssociatedMenuConfiguration 模型驱动应用程序用于控制是否以及如何从本表(作为次表)在 UI 中访问次表数据的参数