Dataverse 表提供 所有环境数据库具有的通用表集。
已启用 Dynamics 365 的应用表/实体引用 包含安装 Dynamics 365 应用(如 Customer Service)之前所需的其他表。
当您选择在将 Dataverse 添加到您创建的环境时安装 Dynamics 365 Customer Service 时,将添加或修改此处列出的表。
此参考仅包括以下表:
IsPrivate 等于
false- 这不包括不存在外部用例的表。 了解有关私有表的更多信息
IsIntersect 等于
false或 IsIntersect 等于,true并且表包含 4 列以上。- 大多数相交表仅包含支持多对多关系所需的 4 列。 它们没有用。 具有四列以上的相交表更有趣。
Messages
此列表中的消息适用于实体。 例如,用户拥有的表支持 、 Assign、 GrantAccess和 ModifyAccess messages ,而组织拥有的表则不支持RevokeAccess。
适用于 .NET 的 SDK
使用 SDK for .NET 时,通常可以调用属于 Microsoft.Crm.Sdk.Messages 或 Microsoft.Xrm.Sdk.Messages 命名空间的相应请求类。 这些类的名称 Request 包含添加到消息名称的前缀。
某些消息将添加为其支持的解决方案的 自定义作 。 这些消息未在 SDK 程序集中定义,但可以通过 多种方式使用它们。
网络应用程序接口
使用 Web API 时,您可以找到以下参考中定义的常见 Dataverse OData 函数和作:
对于这些功能和作,以及添加的任何其他功能和作,您可以通过以下方式了解如何使用它们:
- 检查 $metadata服务文档 ,了解有关参数和返回值的详细信息。 有关详细信息,请参阅 作定义 和 函数定义 。
- 调用作和函数。 有关详细信息,请参阅 使用 Web API作 和 使用 Web API 函数 。
事件
事件是存在的消息,以便您可以订阅它们。 除非您添加了事件,否则不应调用消息,而应订阅它。 您可以通过多种不同的方式订阅事件,例如:
- 使用 Power Automate Dataverse 连接器,使用执行 作时 触发器。
- 注册 Dataverse 插件以响应事件。
- 使用 Dataverse Azure 集成将事件数据发送到 Azure 或 Web 挂钩
属性
此部分包括选定的实体属性,而不是所有实体属性。 仅包括那些预计对开发人员最有用的属性。 可以更改某些实体属性值。
列
列列在两个单独的部分中: 可写列/属性 和只 读列/属性。 这种分离的目的是关注开发人员在创建或更新表中的行时可以设置的列。 了解这些列有助于开发人员了解除了检索值之外,还可以对表执行哪些作。
“可写列/属性”部分中的列为 IsValidForCreate 或 IsValidForUpdate 属性(通常两者)返回 true。 如果这些属性中的任何一个返回 false,则指示这一点。
只读列/属性始终为 IsValidForCreate和IsValidForUpdate 属性返回 false。
本参考文档中的选择列选项来自以英语为基本语言的部署。 某些选择选项可能会有所不同,具体取决于创建环境时选择的基本语言。 这些差异更接近最适合语言或文化的选项。 您可以根据需要通过更改标签或添加和删除选项来自由自定义这些选项。
Relationships
EntityMetadata 类包括三个属性来表示关系:
| 资产 | 类型 | Description |
|---|---|---|
| OneToMany关系 | OneToManyRelationship元数据[] | 获取实体的一对多关系数组。 |
| 多对一关系 | OneToManyRelationship元数据[] | 获取实体的多对一关系数组。 |
| 多对多关系 | ManyToManyRelationship元数据[] | 获取实体的多对多关系数组。 |
注释
请务必记住,虽然每个表都列出了适用于它的关系,但每个关系都由两个表共享。 表 之间 存在关系。 虽然存在一To-Many 关系,但 多对一 关系只是引用表中一To-Many 关系的视图。
多对一关系
包括以下 OneToManyRelationship 属性:
| 资产 | Description |
|---|---|
ReferencedEntity |
相关表的逻辑名称。 |
ReferencedAttribute |
相关表的主键的逻辑名称。 |
ReferencingEntity |
具有查找列的相关表的逻辑名称。 |
ReferencingAttribute |
相关表中查找列的逻辑名称,其中包含对主表主键的引用。 |
IsHierarchical |
关系是否代表自指层次关系 |
CascadeConfiguration |
描述对父实体执行的作的数据将级联到相关实体。 详细信息: 级联配置 |
一对多关系
包括以下 OneToManyRelationship 属性:
| 资产 | Description |
|---|---|
ReferencingEntity |
相关表的逻辑名称。 |
ReferencingAttribute |
相关表中包含对主表主键的引用的列的逻辑名称。 |
IsCustomizable |
是否可以更改关系的属性。 |
ReferencedEntityNavigationPropertyName |
此关系的 Web API 集合值导航属性的名称。 详细信息: Web API 导航属性 |
AssociatedMenuConfiguration |
模型驱动应用用于控制是否以及如何从主实体在 UI 中访问相关实体数据的数据。 |
多对多关系
每个多对多关系都包括 Entity1LogicalName 和 Entity2LogicalName。 对于本文档,在当前表的上下文中提供了关系详细信息。 它是否Entity1Entity2真正重要。
对于每个多对多关系,包括以下属性:
| 资产 | Description |
|---|---|
IntersectEntityName |
支持此多对多关系的相交表的逻辑名称。 使用 FetchXml 连接表列时,可以使用此值 |
IsCustomizable |
是否可以更改关系的属性。 |
SchemaName |
关系的架构名称。 |
IntersectAttribute |
相交表中作为此类型记录的主键的列的名称。 |
NavigationPropertyName |
此关系的 Web API 集合值导航属性的名称。 详细信息: Web API 导航属性 |
AssociatedMenuConfiguration |
模型驱动应用用于控制是否以及如何从此表在 UI 中访问第二个表数据的数据。 |
在极少数情况下,多对多关系是自引用的,例如连接角色 (ConnectionRole) connectionroleassociation_associationEntity1,或Entity2附加到属性前面。
| 资产 | 价值 |
|---|---|
Entity1IntersectAttribute |
相交表中列的名称,该列是作为第一个表的此类型记录的主键。 |
Entity2IntersectAttribute |
相交表中列的名称,该列是此类型作为第二个表的记录的主键。 |
Entity1NavigationPropertyName |
此关系的 Web API 集合值导航属性的名称,作为第一个表。 |
Entity2NavigationPropertyName |
此关系的 Web API 集合值导航属性的名称,作为第二个表。 |
Entity1AssociatedMenuConfiguration |
模型驱动应用使用的数据来控制是否以及如何从此表作为第一个表在 UI 中访问第二个表数据。 |
Entity2AssociatedMenuConfiguration |
模型驱动应用用于控制是否以及如何从此表作为第二个表在 UI 中访问第二个表数据的数据 |