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

この参照を使用して、特定のテーブルで使用できる操作、各テーブルの既定の列、およびテーブル間のリレーションシップを理解します。 テーブル定義では EntityMetadata クラスを使用します。

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

  • EntityMetadata.IsPrivate 等しい false

    この条件では、外部のユース ケースがないテーブルは除外されます。

  • EntityMetadata.IsIntersectはfalse等しいか、IsIntersect がtrue等しく、テーブルに 4 つ以上の列が含まれています。

    ほとんどの交差テーブルには、多対多リレーションシップをサポートするために必要な 4 つの列だけが含まれます。 これらは役に立ちません。 4 つ以上の列を持つ交差テーブルは一般的ではなく、より興味深いものです。

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

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

Dynamics 365 製品では Dataverse が使用されます。 Dynamics 365 製品の環境を作成する場合、その環境にはすべての Dynamics 365 製品に共通のテーブル セットがあります。 Dynamics 365有効なアプリのテーブル/エンティティのリファレンスを参照してください。

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

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

プロパティ

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

列

列は、次の 2 つのセクションに示されています。

セクション 説明
書き込み可能な列/属性 テーブル内の行を作成または更新するときに設定できる列。 これらの列は、AttributeMetadata.IsValidForCreateプロパティまたはAttributeMetadata.IsValidForUpdateプロパティ (通常は両方) のtrueを返します。 いずれかのプロパティが falseを返す場合、この条件が示されます。
読み取り専用の列/属性 テーブル内の行を作成または更新するときに、取得できるが設定できない列。 これらの列は、常にAttributeMetadata.IsValidForCreateプロパティとAttributeMetadata.IsValidForUpdate プロパティの両方のfalseを返します。

選択肢列のオプション

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

顧客間関係

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

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

ヒント

各テーブルには適用されるリレーションシップが一覧表示されますが、各リレーションシップは両方のテーブルで共有されます。 リレーションシップ は テーブル間 に存在します。 一対多リレーションシップは存在しますが、 多対一 リレーションシップは、参照元テーブルからの一対多リレーションシップの単なるビューです。

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

次のOneToManyRelationshipMetadataクラスのプロパティが含まれます。

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

一対多関連付け

次のOneToManyRelationshipMetadataクラスのプロパティが含まれます。

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

多対多関連付け

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

多対多リレーションシップごとに、次の ManyToManyRelationshipMetadata クラス プロパティが含まれます。

プロパティ 説明
IntersectEntityName この多対多のリレーションシップをサポートする交差テーブルの論理名。
IsCustomizable リレーションシップのプロパティを変更できるかどうか。
SchemaName 関係のスキーマ名。
IntersectAttribute (Entity1IntersectAttribute または Entity2IntersectAttribute) このタイプのレコードの主キーとなる交差テーブル内の列の名前。
NavigationPropertyName (Entity1NavigationPropertyName または Entity2NavigationPropertyName) この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。
詳細情報: Web APIナビゲーション プロパティ
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration または Entity2AssociatedMenuConfiguration) モデル駆動型アプリによって使用されるデータ。このテーブルから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 番目のテーブル データに 2 番目のテーブル としてアクセスできるかどうかを制御するために使用されるデータ。