使用此引用可了解可为特定表执行的可用作、每个表的默认列以及表之间的关系。
此引用仅包含满足以下条件的表:
IsPrivate 等于
false- 这不包括不存在外部用例的表。
IsIntersect 等于
false或 IsIntersect 等于true且该表包含超过 4 列。- 大多数交集表仅包含支持多对多关系所需的 4 列。 它们没有实际用途。 超过四列的交集表则更具价值。
若要查看环境中所有表的信息,请参阅 环境中的“浏览表”定义。
Dynamics 365 产品表参考
Dynamics 365 产品使用 Dataverse。 为 Dynamics 365 产品创建环境时,环境对所有 Dynamics 365 产品都有一组通用表。 这些表包含在 Dynamics 365 Enabled apps 表/实体引用中。
每个特定的 Dynamics 365 产品都可以添加其他表。 下表显示了特定 Dynamics 365 产品的表引用:
| 产品文档 | 产品表参考 |
|---|---|
| 销售 | 销售表/实体引用 |
| 现场服务 | Field Service 表/实体引用 |
| 顾客服务 | 客户服务表/实体引用 |
属性
本节仅包含精选实体属性而非全部属性。 仅包含对开发人员最有价值的属性。 部分实体属性值可被修改。
列
列信息分为两个独立部分:可写列/属性与只读列/属性。 此分类旨在突出开发人员在创建或更新表行时可设置的列。 理解这些列有助于开发者掌握除值检索之外的表操作能力。
可写列/属性部分的列在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 |
支持此多对多关系的相交表的逻辑名称 |
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 中访问次表数据的参数 |