开发人员:了解Microsoft Dataverse中的术语

Dataverse 不仅仅是一个数据库。 它还提供 Web 服务,使开发人员能够 与数据进行交互。

如果你熟悉 ADO.NET Entity Framework,则你知道面向数据的应用程序的架构师和开发人员往往难以实现两个不同的目标。

  • 它们必须对要解决的业务问题的实体、关系和逻辑建模。
  • 它们还必须使用存储和检索数据的数据服务。

Entity Framework 使开发人员能够将数据作为特定于域的对象和属性来处理,例如客户和客户地址。 他们无需担心存储这些数据的底层数据库表和列。

在 Power Apps 和 Dataverse 中,可以在用户界面中使用表和列。 这些术语是指如何在 Dataverse 数据库中存储数据的一般概念。 但是,特定术语(如 实体 和 属性) 是指基础数据模型和接口。 开发人员使用此术语,具体取决于用于与数据交互的协议或技术。

开发人员使用的数据结构以实体的形式公开。 术语将融入开发人员使用的内容名称中。 例如:

到…… 使用... 开发人员将...
创建 Dataverse 数据表 Web API 将 EntityMetadata EntityType/EntityDefinitions 的实例发布到资源
创建 Dataverse 数据表 .NET SDK 使用 SDK for .NET 时,创建 EntityMetadata 类的实例并使用 CreateEntityRequest 类。
在 Dataverse 表中创建行或记录 Web API 定义为特定实体类型的 POST 数据。 可在此处找到这些 EntityType 的列表:Web API EntityType 参考文档
在 Dataverse 表中创建行或记录 .NET SDK 创建 Entity 类 或从其继承的类(如账户、联系人等)的实例,并在使用 .NET SDK 时使用 CreateRequest 类。 开发人员可以在 实体引用中找到使用 Entity 类所需的信息。

根据协议或技术使用术语

开发人员文档使用依赖于开发人员使用的协议或类库的术语。

  • 使用 Web API 时,请使用 OData 协议定义的术语。 称为 EntityTypes 的数据结构具有属性和导航属性。

  • 使用 .NET SDK 时,使用 Entity 是因为存在 Entity 类。 Entity 类具有 Attributes 属性,该属性包含 AttributeMetadata 类 中的数据所定义的属性集合以及派生自该属性的许多其他类。

使用适当的术语来描述 SDK 和 Web API 技术。 开发人员文档有时使用不同于Power Apps用户界面的术语。 下表帮助你了解开发人员文档和Power Apps文档的其余部分之间的一些术语差异。

Power Apps 用户界面 Dataverse SDK Dataverse Web API
Table Entity EntityType
列 Attribute 财产
行 记录 记录
选择 选项集/选项列表 OptionSet
Yes/No 布尔 布尔