テーブル定義で Web API を使用する

SDK for .NET を使用して実行できる Web API を使用して、任意のテーブルと列の定義 (メタデータ) 操作を実行できます。 このセクションでは、 Web API Metadata Entity Type Referenceに含まれるエンティティ型で Web API を使用する方法に関するガイダンスを提供します。

Web API では、次の表に示すように、定義エンティティで操作を実行するための 4 つのエンティティ セット パスが公開されています。

各定義エンティティ型は、一意識別子プロパティとして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 HTTP テーブル スキーマ操作のサンプル
Web API C# テーブル スキーマ操作のサンプル
Web API PowerShell テーブル スキーマ操作のサンプル