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 に含まれているエンティティの種類と一緒に使用する方法に関するガイダンスを提供しています。
次の表に示すように、メタデータ エンティティを使用して操作を実行するための、4 つの公開エンティティ セット パスがあります。
エンティティ セット パス |
説明 |
---|---|
[組織 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 |
内部のみで使用 |
各メタデータ エンティティの種類は、MetadataBase EntityType から継承した MetadataId を一意の識別子プロパティとして使用します。 すべてのメタデータ エンティティには MetadataId がありますが、それらすべてを直接クエリすることはできません。 たとえば、属性を含む EntityMetadata エンティティのコンテキストでのみ、属性に対してクエリや操作を実行できます。
これらのエンティティは、ビジネスおよびアプリケーション データを格納しているエンティティとは本質的に異なります。例えば:
メタデータ エンティティのプロパティは、 crmbaseentity EntityType から継承されたエンティティのプロパティに対して使用されるプリミティブ データの種類ではなく、Web API ComplexType Reference および Web API EnumType Reference で定義された多くの複雑な enum 型を使用します。
メタデータ エンティティは異なる命名規則に従い、組織サービスのアセンブリで使用される Pascal 形式の命名スタイルを維持します。
メタデータ エンティティは、継承した内容をより幅広く使用するため、必要なデータを取得するためにキャストの実行が必要な場合があります。
このセクションの内容
Web API を使用したクエリ メタデータ
RetrieveMetadataChangesRequest および組織サービスを使用した Microsoft.Xrm.Sdk.Metadata.Query 名前空間のオブジェクトを使用した場合と同じように Web API を使用してメタデータをクエリすることができます。名前または MetadataId でのメタデータの取得
メタデータのクエリを実行して構成の変更をお使いのアプリケーションに適用することができます。 メタデータ アイテムの主要プロパティの 1 つが判明している場合は、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. All rights reserved. 著作権