使用 Web API 搭配 Dynamics 365 中繼資料
發行︰ 2017年1月
適用於: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
只要是能夠使用組織服務執行的中繼資料作業,都可以使用 Web API 執行。 本節提供如何使用 Web API 搭配 Web API Metadata EntityType Reference中包含的實體類型的指引。
有四個公開的實體集路徑可對中繼資料實體執行作業,如下表中所述。
實體集路徑 |
描述 |
---|---|
[組織 URI]/api/data/v8.2/EntityDefinitions |
包含 EntityMetadata EntityType 實體。 |
[組織 URI]/api/data/v8.2/RelationshipDefinitions |
包含 ManyToManyRelationshipMetadata EntityType 和 OneToManyRelationshipMetadata EntityType,兩者都是從 RelationshipMetadataBase EntityType 繼承。 |
[組織 URI]/api/data/v8.2/GlobalOptionSetDefinitions |
包含全域定義的 BooleanOptionSetMetadata EntityType 和 OptionSetMetadata EntityType 實體,兩者都是從 OptionSetMetadataBase EntityType 繼承。 |
[組織 URI]/api/data/v8.2/ManagedPropertyDefinitions |
僅供內部使用。 |
每個中繼資料實體類型都是使用 MetadataId 做為唯一識別碼屬性,它是從 MetadataBase EntityType 繼承。 雖然所有中繼資料實體都有 MetadataId,但您無法直接查詢全部。 例如,您只能在包含屬性的 EntityMetadata 實體中,對屬性查詢和執行作業。
這些實體與儲存商務和應用程式資料的實體有些實質的差異,例如:
中繼資料實體的屬性使用較多 Web API ComplexType Reference和 Web API EnumType Reference中定義的複雜和列舉類型,而非基本值資料類型,用於繼承自 crmbaseentity EntityType 的實體中的屬性。
中繼資料實體遵循不同的命名慣例,並採用組織服務的組件中所使用的駝峰式大小寫命名樣式。
中繼資料實體對於繼承的用途較廣,表示您可能需要執行轉換以擷取想要的資料。
本節內容
使用 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. 著作權所有,並保留一切權利。 著作權