使用具有 Dynamics 365 元数据的 Web API
发布日期： 2017年1月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
您可以使用 Web API 执行您使用组织服务时可以执行的任何元数据操作。 本节提供有关如何使用具有Web API Metadata EntityType Reference中包含的实体类型的 Web API 的指南。
使用元数据实体执行操作有四种实体集路径，如下表所述。
实体集路径 |
说明 |
|---|---|
[组织 URI]/api/data/v8.2/实体定义 |
|
[组织 URI]/api/data/v8.2/关系定义 |
包含ManyToManyRelationshipMetadata EntityType和OneToManyRelationshipMetadata EntityType，两者均继承自RelationshipMetadataBase EntityType。 |
[组织 URI]/api/data/v8.2/全局选项集定义 |
包含全局定义的BooleanOptionSetMetadata EntityType和OptionSetMetadata EntityType实体，两者均继承自OptionSetMetadataBase EntityType。 |
[组织 URI]/api/data/v8.2/托管属性定义 |
仅供内部使用。 |
每个元数据实体类型均使用MetadataId作为唯一标识符属性，它继承自MetadataBase EntityType。 由于所有元数据实体都有一个MetadataId，因此您无法直接全部查询。 例如，您仅能在包含属性的EntityMetadata实体的上下文中对此属性进行查询和操作。
这些实体与存储业务和应用程序数据的实体之间有一些重要差别，例如：
元数据实体的属性使用Web API ComplexType Reference和Web API EnumType Reference中定义的许多复杂类型和枚举类型，而不使用继承自crmbaseentity EntityType的实体中的属性使用的原始数据类型。
元数据实体遵循不同的命名约定，保留了组织服务程序集中使用的 Pascal 大小写命名样式。
元数据实体对继承的使用更加广泛，您可能需要执行转换以检索您所需的数据。
本节内容
使用 Web API 查询元数据
您可以使用 Web API 按照与使用RetrieveMetadataChangesRequest时类似的方式查询元数据，以及使用组织服务查询Microsoft.Xrm.Sdk.Metadata.Query命名空间中的对象。按名称或 MetadataId 检索元数据
您的应用程序可通过查询元数据适应配置更改。 当您知道元数据项目的其中一个重要属性时，您可以使用 Web API 检索元数据定义。使用 Web API 创建更新实体定义
您可以使用 Web API 创建和更新实体和属性，达到与组织服务CreateEntityRequest、UpdateEntityRequest、CreateAttributeRequest和UpdateAttributeRequest相同的结果。使用 Web API 创建和更新实体关系
您可以使用 Web API 检查实体是否有资格参与与其他实体之间的关系，再创建或更新这些关系。
另请参阅
Microsoft Dynamics 365 中的元数据和数据模型
浏览组织的元数据
使用含有 Dynamics 365 元数据的组织服务
使用 Microsoft Dynamics 365 Web API
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权