Dataverse テーブル/エンティティ参照

この参照を使用して、特定のテーブルに対して実行可能な操作、各テーブルの既定の属性、テーブル間の関連付けについて説明します。

この参照には以下の場合のテーブルのみが含まれています:

  • IsPrivate は false

    • 外部のユースケースが存在しないテーブルは除外されます。
  • IsIntersect equals false または IsIntersect equals true であり、テーブルに4つ以上の列が含まれています。

    • ほとんどの交差テーブルには、多対多の関係をサポートするために必要な4つの列だけが含まれています。 それらは役に立ちません。 4列を超える交差テーブルの方が興味深いです。

位置を合わせる 内のすべてのテーブルに関する情報を表示するには、「 位置を合わせる 内のテーブル定義を参照する」を参照してください。

Dynamics 365 製品テーブル リファレンス

Dynamics 365 製品では Dataverse が使用されます。 Dynamics 365 製品の環境を作成する場合、その環境にはすべての Dynamics 365 製品に共通のテーブル セットがあります。 これらのテーブルは、 Dynamics 365 Enabled apps のテーブル/エンティティリファレンスに含まれています。

特定の Dynamics 365 製品ごとに、追加のテーブルを追加できます。 次の表は、特定の Dynamics 365 製品のテーブル リファレンスを示しています。

製品ドキュメント 製品テーブルリファレンス
セールス 販売テーブル/エンティティ参照
フィールドサービス Field Service テーブル/エンティティ参照
顧客サービス Customer Service テーブル/エンティティ参照

プロパティ

このセクションには、すべてではなく選択されたエンティティ プロパティが含まれています。 開発者にとって最も役に立つと予想されるプロパティのみが含まれます。 一部のエンティティ プロパティ値の場合、これを変更できます。

列

列は、 書き込み可能な列/属性 と 読み取り専用列/属性の2つの別々のセクションにリストされます。 この分離の目的は、テーブルに行を作成または更新するときに開発者が設定できる列に重点を置くことです。 これらの列を理解することは、単に値を取得するだけでなく、テーブルでできることを理解するのに役立ちます。

書き込み可能な列/属性 セクションの列は、 IsValidForCreate プロパティまたは IsValidForUpdate プロパティのいずれか (通常は両方) に対してtrueを返します。 これらのプロパティのいずれかが false を返す場合、これが示されます。

読み取り専用の列/属性 は、 IsValidForCreateおよびIsValidForUpdate プロパティに対して常にfalseを返します。

このリファレンス ドキュメントの選択列オプションは、英語が基本言語である展開から取得されます。 一部の選択オプションは、環境 の作成時に選択された基本言語によって異なる場合があります。 これらの違いは、言語や文化に最も適したオプションにさらに密接に関連しています。 必要に応じてラベルを変更したり、オプションを追加または削除したりすることで、これらのオプションを自由にカスタマイズできます。

顧客間関係

EntityMetadata クラスには、リレーションシップ を表す3つのプロパティが含まれています。

プロパティ タイプ 説明
一対多の関係 OneToManyリレーションシップメタデータ[] エンティティの 1 対多リレーションシップの配列を取得します。
多対一関係 OneToManyリレーションシップメタデータ[] エンティティの多対 1 リレーションシップの配列を取得します。
多対多の関係 多対多関係メタデータ[] エンティティの多対多リレーションシップの配列を取得します。

ヒント

各テーブルがそれに適用されるそれらの関連付けをリストする一方、各関連付けは両方の関連するテーブルによって共有されることに留意することが重要です。 リレーションシップ は テーブル間 に存在します。 1対多の リレーションシップ は存在しますが、 多対1 リレーションシップ は参照テーブルからの1対多の関係の単なるビューです。

多対一のリレーションシップ

以下の OneToManyRelationship プロパティが含まれます:

プロパティ 説明
ReferencedEntity 関連するテーブルの論理名です。
ReferencedAttribute 関連テーブルの主キーの論理名。
ReferencingEntity 参照列を持つ関連テーブルの論理名。
ReferencingAttribute 主テーブルの主キーへの参照を含む関連テーブル内の参照列の論理名。
IsHierarchical 関連付けが自己参照の階層的な関連付けを表すかどうか
CascadeConfiguration 親エンティティで実行されたどの操作が、関連するエンティティに伝播するかを説明するデータ。
詳細情報: カスケード構成

一対多関連付け

以下の OneToManyRelationship プロパティが含まれます:

プロパティ 説明
ReferencingEntity 関連するテーブルの論理名です。
ReferencingAttribute プライマリ テーブルのプライマリ キーへの参照を含む、関連テーブルの列の論理名です。
IsCustomizable 関連付けの管理プロパティが変更できるかどうか。
ReferencedEntityNavigationPropertyName この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。
詳細情報: Web APIナビゲーション プロパティ
AssociatedMenuConfiguration モデル駆動型アプリで使用されるデータで、関連するエンティティ データが主エンティティから UI 内でアクセスできるかどうか、およびそのエンティティ データにアクセスする方法をコントロールします。

多対多関連付け

各多対多リレーションシップには、 Entity1LogicalName と Entity2LogicalName が含まれます。 このドキュメントでは、関係の詳細は現在のテーブルのコンテキストで提供されます。 それが Entity1 そうであるかどうか Entity2 は、実際には重要ではありません。

各多対多関連付けには次のプロパティが含まれます。

プロパティ 説明
IntersectEntityName この多対多の関係をサポートする交差テーブルの論理名
IsCustomizable 関連付けの管理プロパティが変更できるかどうか。
SchemaName 関係のスキーマ名。
IntersectAttribute このタイプのレコードの主キーとなる交差テーブル内の列の名前。
NavigationPropertyName この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。
詳細情報: Web APIナビゲーション プロパティ
AssociatedMenuConfiguration モデル駆動型アプリによって使用されるデータ。このテーブルからUIで2番目のテーブル データにアクセスできるかどうか、およびその方法を制御し、

まれに、多対多の関係が自己参照になる場合 (例: for Connection Role (ConnectionRole) connectionroleassociation_association, Entity1 or Entity2 ) があり、プロパティの先頭に付加されます。

プロパティ 価値
Entity1IntersectAttribute 最初のテーブルとしてこのタイプのレコードの主キーとなる交差テーブル内の列の名前。
Entity2IntersectAttribute 2番目のテーブルとしてこのタイプのレコードの主キーとなる交差テーブル内の列の名前。
Entity1NavigationPropertyName 最初のテーブルとしてのこのリレーションシップのWeb APIコレクション値ナビゲーション プロパティの名前。
Entity2NavigationPropertyName 2番目のテーブルとしてのこのリレーションシップのWeb APIコレクション値ナビゲーション プロパティの名前。
Entity1AssociatedMenuConfiguration モデル駆動型アプリによって使用されるデータ。このテーブルからUIで最初のテーブルとして2番目のテーブル データにアクセスできるかどうか、およびその方法を制御し、
Entity2AssociatedMenuConfiguration モデル駆動型アプリによって使用されるデータ。このテーブルからUIで2番目のテーブル データにアクセスできるかどうか、またそのアクセス方法を制御するために使用します。