Dataverse テーブル/エンティティ参照
この参照を使用して、特定のテーブルに対して実行可能な操作、各テーブルの既定の属性、テーブル間の関連付けについて説明します。
この参照には以下の場合のテーブルのみが含まれています:
IsPrivate は
false
- 外部のユースケースが存在しないテーブルは除外されます。
IsIntersect equals
false
または IsIntersect equalstrue
であり、テーブルに4つ以上の列が含まれています。- ほとんどの交差テーブルには、多対多の関係をサポートするために必要な4つの列だけが含まれています。 それらは役に立ちません。 4列を超える交差テーブルの方が興味深いです。
位置を合わせる 内のすべてのテーブルに関する情報を表示するには、「 位置を合わせる 内のテーブル定義を参照する」を参照してください。
プロパティ
このセクションには、すべてではなく選択されたエンティティ プロパティが含まれています。 開発者にとって最も役に立つと予想されるプロパティのみが含まれます。 一部のエンティティ プロパティ値の場合、これを変更できます。
列
列は、 書き込み可能な列/属性 と 読み取り専用列/属性の2つの別々のセクションにリストされます。 この分離の目的は、テーブルに行を作成または更新するときに開発者が設定できる列に重点を置くことです。 これらの列を理解することは、単に値を取得するだけでなく、テーブルでできることを理解するのに役立ちます。
書き込み可能な列/属性 セクションの列は、 IsValidForCreate プロパティまたは IsValidForUpdate プロパティのいずれか (通常は両方) に対してtrueを返します。 これらのプロパティのいずれかが false を返す場合、これが示されます。
読み取り専用の列/属性 は、 IsValidForCreateおよびIsValidForUpdate プロパティに対して常にfalseを返します。
このリファレンス ドキュメントの選択列オプションは、英語が基本言語である展開から取得されます。 一部の選択オプションは、環境 の作成時に選択された基本言語によって異なる場合があります。 これらの違いは、言語や文化に最も適したオプションにさらに密接に関連しています。 必要に応じてラベルを変更したり、オプションを追加または削除したりすることで、これらのオプションを自由にカスタマイズできます。
顧客間関係
EntityMetadata クラスには、リレーションシップ を表す3つのプロパティが含まれています。
プロパティ | タイプ | 説明 |
---|---|---|
一対多の関係 | OneToManyリレーションシップメタデータ[] | エンティティの 1 対多リレーションシップの配列を取得します。 |
多対一関係 | OneToManyリレーションシップメタデータ[] | エンティティの多対 1 リレーションシップの配列を取得します。 |
多対多の関係 | 多対多リレーションシップメタデータ[] | エンティティの多対多リレーションシップの配列を取得します。 |
注意
各テーブルがそれに適用されるそれらの関連付けをリストする一方、各関連付けは両方の関連するテーブルによって共有されることに留意することが重要です。 リレーションシップ は テーブル間 に存在します。 1対多の リレーションシップ は存在しますが、 多対1 リレーションシップ は参照テーブルからの1対多の関係の単なるビューです。
多対一 リレーションシップ
以下の OneToManyRelationship
プロパティが含まれます:
Property | プロパティ |
---|---|
ReferencedEntity |
関連するテーブルの論理名です。 |
ReferencedAttribute |
関連テーブルの主キーの論理名。 |
ReferencingEntity |
参照列を持つ関連テーブルの論理名。 |
ReferencingAttribute |
主テーブルの主キーへの参照を含む関連テーブル内の参照列の論理名。 |
IsHierarchical |
関連付けが自己参照の階層的な関連付けを表すかどうか |
CascadeConfiguration |
親エンティティで実行されたどの操作が、関連するエンティティに伝播するかを説明するデータ。 詳細情報: カスケード構成 |
一対多関連付け
以下の OneToManyRelationship
プロパティが含まれます:
Property | プロパティ |
---|---|
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番目のテーブル データにアクセスできるかどうか、およびその方法を制御し、 |
まれに、多対多の関係が自己参照になる場合 (たとえば、 接続ロール (ConnectionRole) connectionroleassociation_association、 Entity1
または Entity2
) があり、プロパティの先頭に付加されます。
Property | 価値 |
---|---|
Entity1IntersectAttribute |
最初のテーブルとしてこのタイプのレコードの主キーとなる交差テーブル内の列の名前。 |
Entity2IntersectAttribute |
2番目のテーブルとしてこのタイプのレコードの主キーとなる交差テーブル内の列の名前。 |
Entity1NavigationPropertyName |
最初のテーブルとしてのこのリレーションシップのWeb APIコレクション値ナビゲーション プロパティの名前。 |
Entity2NavigationPropertyName |
2番目のテーブルとしてのこのリレーションシップのWeb APIコレクション値ナビゲーション プロパティの名前。 |
Entity1AssociatedMenuConfiguration |
モデル駆動型アプリによって使用されるデータ。このテーブルから最初のテーブルとしてUIで2番目のテーブル データにアクセスできるかどうか、およびその方法を制御し、 |
Entity2AssociatedMenuConfiguration |
モデル駆動型アプリによって使用されるデータ。このテーブルからUIで2番目のテーブル データにアクセスできるかどうか、またそのアクセス方法を制御するために使用します。 |