.NET 用 SDK を使用して実行できる Web API を使用して、任意のテーブルと列の定義 (メタデータ) 操作を実行できます。 このセクションでは、 Web API Metadata Entity Type Referenceに含まれるエンティティ型で Web API を使用する方法に関するガイダンスを提供します。
次の表に示すように、定義エンティティで操作を実行するために公開される 4 つのエンティティ セット パスがあります。
| エンティティ セット パス | Description |
|---|---|
| [組織 URI]/api/data/v9.2/EntityDefinitions | EntityMetadata EntityType のコレクションを格納します。 |
| [Organization URI]/api/data/v9.2/RelationshipDefinitions | ManyToManyRelationshipMetadata EntityType と OneToManyRelationshipMetadata EntityType が含まれます。どちらも RelationshipMetadataBase EntityType から継承されます。 |
| [Organization URI]/api/data/v9.2/GlobalOptionSetDefinitions | グローバルに定義されたBooleanOptionSetMetadata EntityTypeとOptionSetMetadata EntityTypeからなるコレクションを格納しており、どちらもOptionSetMetadata EntityTypeから継承されています。 |
| [Organization URI]/api/data/v9.2/ManagedPropertyDefinitions | 内部使用のみ |
各定義エンティティ型は、一意識別子プロパティとしてMetadataIdを使用し、これをMetadataBase EntityTypeから継承します。 すべての定義エンティティには MetadataIdが含まれますが、すべてのエンティティに直接クエリを実行することはできません。 たとえば、属性 (テーブル列) に対するクエリと操作は、それらを含む EntityMetadata エンティティのコンテキストでのみ実行できます。
これらの定義エンティティには、ビジネス データとアプリケーション データを格納するテーブルとは大きな違いがあります。次に例を示します。
定義エンティティのプロパティでは、Web API Complex Type Reference から継承するエンティティのプロパティに使用されるプリミティブ データ型ではなく、Web API Enum Type Referenceおよびで定義されている複合型と列挙型の多くが使用されます。
定義エンティティは、別の名前付け規則に従い、SDK for .NET のアセンブリで使用されるパスカル ケースの名前付けスタイルを維持します。
定義エンティティは継承をより広範に使用するため、必要なデータを取得するためにキャストを実行する必要がある場合があります。
このセクションにて
Web API を使用してテーブル定義をクエリ
Web API を使用して、RESTful クエリ スタイルを使用してテーブルまたは列の定義にクエリを実行できます。
名前または MetadataId を使用してテーブル定義を取得する
アプリケーションでは、テーブルと列の定義に対してクエリを実行することで、構成の変更に適応できます。 定義項目のいずれかのキー プロパティがわかっている場合は、Web API を使用して定義を取得できます。
Web API を使用したテーブル定義の作成および更新
Web API を使用してテーブルを作成および更新して、SDK for .NET CreateEntityRequest と UpdateEntityRequestで得られるのと同じ結果を得ることができます。
Web API を使用して列定義を作成および更新する
Web API を使用して列を作成および更新すると、SDK for .NET CreateAttributeRequestと UpdateAttributeRequestで得られるのと同じ結果を得ることができます。
Web API を使用したテーブルの関連付けの作成および更新
テーブルが他のテーブルとのリレーションシップに参加する資格があるかどうかを確認し、Web API を使用してそれらのリレーションシップを作成または更新できます。
複数テーブルの参照
マルチテーブル検索タイプの列を使用すると、ユーザーは、環境内の他のテーブルに対して複数の一対多 (1:N) の関連付けを持つ特定のテーブルを使用できます。 単一の検索タイプの列は、他の複数のテーブルを参照できます。 複数テーブル型の列に送信された参照値は、関連するテーブルのレコードと照合されます。 マルチテーブル検索は、ローカル テーブルと仮想テーブルの両方を参照テーブルとして作成できます。
Web API による選択肢 (オプション セット) の作成と更新
グローバル選択列とローカル選択列を操作する方法について説明します。 オプション値の取得、オプションの追加、更新、削除、並べ替えの方法。
こちらも参照ください
環境のテーブル定義を参照する
Microsoft Dataverse Web API Web APIテーブル スキーマ操作のサンプルを使用する
Web API テーブル スキーマ操作サンプル (C#)