Dataverse テーブル/エンティティ参照
この参照を使用して、特定のテーブルに対して実行可能な操作、各テーブルの既定の属性、テーブル間の関連付けについて説明します。
この参照には以下の場合のテーブルのみが含まれています:
- IsPrivate が
false
と等しい- 外部のユースケースが存在しないテーブルは除外されます。
- IsIntersect が
false
と等しい- これは、多対多の関連付けを定義するために使用されるテーブルを除外します。
- エンティティは特定の種類の直接データ変更操作をサポートします。
- これには、直接操作できないテーブルは含まれません。
環境内のすべてのテーブルに関する情報を表示するには、ご利用の環境でテーブル定義を参照するを参照してください。
プロパティ
このセクションには、すべてではなく選択されたエンティティ プロパティが含まれています。 開発者にとって最も役に立つと予想されるプロパティのみが含まれます。 一部のエンティティ プロパティ値の場合、これを変更できます。
列
列は次の 2 つのセクションに分かれています: 書き込み可能な列および読み取り専用列/属性。 この分離の目的は、テーブルに行を作成または更新するときに開発者が設定できる列に重点を置くことです。 これらの列を理解することは、単に値を取得するだけでなく、テーブルでできることを理解するのに役立ちます。
書き込み可能な列/属性セクションの列は、IsValidForCreate または IsValidForUpdate プロパティの いずれか に対して true を返します (通常は両方)。 これらのプロパティのいずれかが false を返す場合、これが示されます。
読み取り専用列/属性は IsValidForCreate および IsValidForUpdate プロパティに常に false を返します。
関係
EntityMetadata クラスには、関連付けを表す 3 つのプロパティが含まれます。
プロパティ | タイプ | 説明 |
---|---|---|
OneToManyRelationships | OneToManyRelationshipMetadata[] | エンティティの 1 対多リレーションシップの配列を取得します。 |
EntityMetadata.ManyToOneRelationships | OneToManyRelationshipMetadata[] | エンティティの多対 1 リレーションシップの配列を取得します。 |
EntityMetadata.ManyToManyRelationships | ManyToManyRelationshipMetadata[] | エンティティの多対多リレーションシップの配列を取得します。 |
注意
各テーブルがそれに適用されるそれらの関連付けをリストする一方、各関連付けは両方の関連するテーブルによって共有されることに留意することが重要です。 この関連付けはテーブル間に存在します。 1 対多の関連付けが存在する一方で、多対 1 関連付けは、単に参照元テーブルからの 1 対多の関連付けのビューです。
一対多関連付け
混乱を最小限に抑えて実際の 多対 1 関連付けが存在しないことを表す目的で、各関連付けの詳細は一度しか記録されません。 各 1 対多の関連付けは、参照されたテーブルとともにリストされ、選択された関連付けの詳細と、対応する 多対 1 の関連付けへのリンクを含みます。 リストされた [多対 1] の関連付けには、対応する 1 対多の関連付けへのリンクのみが含まれます。
各一対多関連付けには次のプロパティが含まれます :
プロパティ | 説明 |
---|---|
ReferencingEntity |
関連するテーブルの論理名です。 |
ReferencingAttribute |
プライマリ テーブルのプライマリ キーへの参照を含む、関連テーブルの列の論理名です。 |
IsHierarchical |
関連付けが自己参照の階層的な関連付けを表すかどうか |
IsCustomizable |
関連付けの管理プロパティが変更できるかどうか。 |
ReferencedEntityNavigationPropertyName |
この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。 詳細については次を参照してください: Web API ナビゲーション プロパティ |
AssociatedMenuConfiguration |
モデル駆動型アプリで使用されるデータで、関連するエンティティ データが主エンティティから UI 内でアクセスできるかどうか、およびそのエンティティ データにアクセスする方法をコントロールします。 |
CascadeConfiguration |
親エンティティで実行されたどの操作が、関連するエンティティに伝播するかを説明するデータ。 詳細: 伝播構成 |
多対多関連付け
各多対多関連付けには Entity1LogicalName および Entity2LogicalName が含まれます。 このドキュメントでは、関連付けの詳細は、エンティティ 1 のトピックにのみ含まれています。 エンティティが エンティティ 2 のそれぞれの多対多の関連付けには、エンティティ 2 のトピックの詳細へのリンクのみが含まれています。
各多対多関連付けには次のプロパティが含まれます。
プロパティ | 説明 |
---|---|
IntersectEntityName |
この多対多の関係をサポートする交差テーブルの論理名 |
Entity1LogicalName |
リレーションシップの最初のテーブルの論理名です。 |
Entity1IntersectAttribute |
1 つ目テーブルのプライマリ キーへの参照を含む交差テーブルのカラムの論理名です。 |
Entity1NavigationPropertyName |
この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。 詳細については次を参照してください: Web API ナビゲーション プロパティ |
Entity1AssociatedMenuConfiguration |
モデル駆動型アプリで使用されるデータで、1 つ目のテーブルのデータを 2 つ目のテーブルから UI でアクセスできるかどうか、またどのようにアクセスするかを制御します。 |
Entity2LogicalName |
リレーションシップの 2 つ目のテーブルの論理名です。 |
Entity2IntersectAttribute |
2 つ目テーブルのプライマリ キーへの参照を含む交差テーブルのカラムの論理名です。 |
Entity2NavigationPropertyName |
通常、これは Entity1NavigationPropertyName と同じです |
Entity2AssociatedMenuConfiguration |
モデル駆動型アプリで使用されるデータで、2つ目のテーブルのデータを1つ目のテーブルから UI でアクセスできるかどうか、またどのようにアクセスするかを制御します。 |
IsCustomizable |
関連付けの管理プロパティが変更できるかどうか。 |
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。