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

Dataverse は単なるデータベースではありません。 また、開発者が データを操作できるようにする Web サービスも提供します。

ADO.NET Entity Framework に慣れている場合、データ指向アプリケーションのアーキテクトと開発者は、多くの場合、2 つの異なる目標を達成するために苦労していることがわかります。

  • 解決するビジネス上の問題のエンティティ、リレーションシップ、ロジックをモデル化する必要があります。
  • また、データを格納および取得するデータ サービスと連携する必要があります。

Entity Framework を使用すると、開発者は、顧客や顧客アドレスなどのドメイン固有のオブジェクトやプロパティとしてデータを操作できます。 このデータが格納されている基になるデータベース テーブルと列について心配する必要はありません。

Power Appsと Dataverse では、ユーザー インターフェイスでテーブルを使用します。 これらの用語は、Dataverse データベースにデータを格納する方法の一般的な概念を指します。 ただし、 エンティティ や属性などの特定 用語は、基になるデータ モデルとインターフェイスを指します。 開発者は、データの操作に使用されるプロトコルまたはテクノロジに応じて、この用語を使用します。

開発者が操作するデータ構造は、エンティティとして公開されます。 この用語は、開発者が使用するものの名前に組み込まれます。 例えば次が挙げられます。

対象... 使用... 開発者は...
Dataverse テーブルを作成する ウェブAPI EntityMetadata EntityType のインスタンスを /EntityDefinitions リソースに POST する
Dataverse テーブルを作成する .NET SDK EntityMetadata クラスのインスタンスを作成し、SDK for .NET を使用するときに CreateEntityRequest クラスを使用します。
Dataverse テーブルに行またはレコードを作成する ウェブAPI 特定の EntityType として定義された POST データ。 EntityTypes の一覧については、Web API EntityType リファレンスをご覧ください
Dataverse テーブルに行またはレコードを作成する .NET SDK エンティティ クラスのインスタンスまたはエンティティ クラスを継承するクラス (Account、Contact など) を作成し、SDK for .NET を使用する場合は CreateRequest クラスを使用します。 開発者は、 エンティティ参照で Entity クラスを使用するために必要な情報を見つけることができます。

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

開発者向けドキュメントでは、開発者が使用するプロトコルまたはクラス ライブラリに依存する用語を使用します。

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

  • .NET SDK を使用する場合は、Entity クラスがあるため、Entity を使用します。 Entity クラスには、AttributeMetadata クラス内のデータと、そこから派生した他の多くのクラスで定義された属性のコレクションを含む Attributes プロパティがあります。

適切な用語を使用して、SDK と Web API テクノロジについて説明します。 開発者向けドキュメントでは、Power Appsユーザー インターフェイスとは異なる用語を使用する場合があります。 次の表は、開発者向けドキュメントとPower Appsドキュメントの残りの部分の用語の違いについて説明します。

Power Apps UI Dataverse SDK Dataverse Web API
エンティティ EntityType
コラム 特性 プロパティ
Row 記録 記録
Choices OptionSet(オプションセット)/Picklist(選択リスト) OptionSet
はい/いいえ ブール値 ブール値