開発者: Microsoft Dataverse の用語を理解する

Dataverse は単なるデータベースではなく、開発者がデータと対話することがでできるようにする Web サービスでもあります。

ADO.NET Entity Framework に精通している場合、データ指向アプリケーションのアーキテクトと開発者は、2 つの異なる目的を達成する必要性に苦しんでいることをご存じでしょう。

• エンティティ、リレーションシップ、および解決しようとしているビジネス上の問題のロジックをモデル化する必要があります。
• また、データの保存と取得に使用されるデータ サービスとも連携する必要があります。

Entity Framework を使用すると、開発者は、このデータが格納されている基になるデータベース テーブルや列を気にすることなく、顧客や顧客の住所など、ドメイン固有のオブジェクトやプロパティの形式でデータを操作できます。

Power Apps と Dataverse では、テーブル と 列はユーザー インターフェイスで使用され、データが Dataverse データベースにどのように保存されるかに関する一般的な考え方を参照します。特定の用語 (など エンティティ や 属性 など) は、データの操作に使用されるプロトコルまたはテクノロジに応じて、開発者が使用する基になるデータモデルとインターフェイスを表すために使用されます。

開発者が使用するデータ構造はエンティティとして公開され、この用語は開発者が使用するものの名前に焼き付けられています。 例:

対象...	使用...	開発者は...
Dataverse テーブルの作成	Web API	EntityMetadata EntityType のインスタンスを /EntityDefinitions リソースに投稿します
Dataverse テーブルの作成	.NET SDK	EntityMetadata クラスののインスタンスを作成して、CreateEntityRequest クラスを使って、これを組織サービスに送信します
Dataverse テーブルで行またはレコードを作成する	Web API	特定の EntityType として定義された POST データ。 これらの EntityType のリストは、次の場所にあります:Web API EntityType 参照
Dataverse テーブルで行またはレコードを作成する	.NET SDK	エンティティ クラスまたはそれ (アカウント、連絡先など) から継承したクラスのインスタンスを作成して、CreateRequest クラスを使用して、これを組織サービスに送信します。 開発者が、Entity クラスを使用するために必要な情報はエンティティ参照にあります。

プロトコルまたはテクノロジに応じた用語の使用

開発者向けドキュメントで使用されている用語は、開発者が使用しているプロトコルまたはクラスライブラリによって異なります。

• Web API で作業する際、OData プロトコルで定義された用語を使用します。 データ構造は EntityTypes として定義され、プロパティとナビゲーション プロパティがあります。

• .NET SDK で作業する際、Entity クラスがあるために Entity を使用します。 エンティティ クラスには属性プロパティがあり、これにはAttributeMetadata クラス およびそれから派生する他の多くのクラスのデータによって定義される属性のコレクションを含みます。

SDK および Web API テクノロジを説明するために、適切な用語を使用します。 開発者向けドキュメントでは、場合によって、Power Appsユーザーインターフェイスとは異なる用語を使用します。 以下の表は、開発者向けドキュメントとその他の Power Apps ドキュメントの用語の違いを説明するのに役立ちます。

Power Apps UI	Dataverse SDK	Dataverse Web API
テーブル	Entity	EntityType
Column	属性	プロパティ
行	レコード	レコード
選択肢(複数)	OptionSet/候補リスト	OptionSet
はい/いいえ	Boolean	Boolean