Dataverse テーブル は、すべての環境データベースが持つテーブルの共通セットを提供します。 ここにリストされているテーブルは、作成した環境に Dataverse を追加するときに、Dynamics 365 アプリを有効にする を選択すると追加または変更されます。
必要なライセンスがある場合は、さらにテーブルを追加したり、既存の Dynamics 365 または Dataverse テーブルをカスタマイズしたりできる Dynamics 365 製品をインストールできます。
次の表は、この参照に依存する他の Dynamics 365 製品の一覧です。
| 製品ドキュメント | 製品テーブルリファレンス |
|---|---|
| セールス | 販売テーブル/エンティティ参照 |
| フィールドサービス | Field Service テーブル/エンティティ参照 |
| 顧客サービス | Customer Service テーブル/エンティティ参照 |
この参照には以下の場合のテーブルのみが含まれています:
IsPrivate が
falseと等しい- 外部のユースケースが存在しないテーブルは除外されます。 非公開テーブルに関する詳細情報
IsIntersect が
falseに等しい、または IsIntersect がtrueに等しく、テーブルに 4 つ以上の列が含まれる場合。- ほとんどの交差テーブルには、多対多の関連付けをサポートするために必要な 4 つの列のみが含まれています。 これらは利便性に優れているわけではありません。 4 つ以上の列を持つ交差テーブルの方が興味深いです。
Messages
このリストのメッセージはエンティティに適用されます。 たとえば、ユーザー所有のテーブルは、組織所有のテーブルがサポートしていないときに、Assign、GrantAccess、ModifyAccess、RevokeAccess をサポートします。
.NET 用 SDK
SDK for .NET を使用する場合は通常、Microsoft.Crm.Sdk.Messages または Microsoft.Xrm.Sdk.Messages 名前空間に属する対応する要求クラスを呼び出すことができます。 これらのクラスは、メッセージ名に追加された Request プレフィックスを含む名前を持っています。
いくつかのメッセージは、サポートするソリューションのカスタム アクションとして追加されます。 これらのメッセージは SDK アセンブリ内では定義されていませんが、使用する方法はいくつかあります。
Web API
Web API を使用する場合、これらのリファレンスで定義されている一般的な Dataverse OData 関数とアクションを見つけることができます。
これらの関数とアクション、および追加された関数とアクションについては、次の方法でこれらを使用する方法を確認できます。
- パラメーターと返り値の詳細については、$metadata サービス ドキュメントを参照してください。 詳細については、アクションの定義 と 関数の定義 を参照してください。
- アクションや関数を呼び出します。 詳細については、Web API アクションを使用する と Web API 関数を使用する を参照してください。
イベント
イベントは、サブスクライブできるように存在するメッセージです。 イベントを追加しない限り、メッセージを呼び出すのではなく、サブスクライブするだけです。 イベントをサブスクライブするには、次のようないくつかの方法があります。
- アクションが実行された際のトリガーを使用して、Power Automate Dataverse コネクタを使用します。
- イベントに応答する Dataverse プラグインを登録します。
- Dataverse Azure 統合でイベントデータを Azure または Web フックに送信する
プロパティ
このセクションには、すべてではなく選択されたエンティティ プロパティが含まれています。 開発者にとって最も役に立つと予想されるプロパティのみが含まれます。 一部のエンティティ プロパティ値の場合、これを変更できます。
列
列は次の 2 つのセクションに分かれています: 書き込み可能な列および読み取り専用列/属性。 この分離の目的は、テーブルに行を作成または更新するときに開発者が設定できる列に重点を置くことです。 これらの列を理解することは、単に値を取得するだけでなく、テーブルでできることを理解するのに役立ちます。
書き込み可能な列/属性セクションの列は、IsValidForCreate または IsValidForUpdate プロパティの いずれか に対して true を返します (通常は両方)。 これらのプロパティのいずれかが false を返す場合、これが示されます。
読み取り専用の列/属性は、IsValidForCreate および IsValidForUpdate プロパティに対して常に false を返します。
このリファレンス ドキュメントに記載されている選択肢の列は、英語が基本言語である展開に由来しています。 一部の選択肢は、環境の作成時に選択した基本言語によって異なる場合があります。 これらの違いは、言語やカルチャーに最も適したオプションにより密接に一致します。 必要に応じて、ラベルを変更したり、オプションを追加および削除したりして、これらのオプションを自由にカスタマイズできます。
人間関係
EntityMetadata クラスには、関連付けを表す 3 つのプロパティが含まれます。
| プロパティ | タイプ | Description |
|---|---|---|
| OneToManyRelationships | OneToManyRelationshipMetadata[] | エンティティの 1 対多リレーションシップの配列を取得します。 |
| ManyToOneRelationships | OneToManyRelationshipMetadata[] | エンティティの多対 1 リレーションシップの配列を取得します。 |
| ManyToManyRelationships | ManyToManyRelationshipMetadata[] | エンティティの多対多リレーションシップの配列を取得します。 |
注
各テーブルがそれに適用されるそれらの関連付けをリストする一方、各関連付けは両方の関連するテーブルによって共有されることに留意することが重要です。 この関連付けはテーブル間に存在します。 1 対多の関連付けが存在する一方で、多対 1 関連付けは、単に参照元テーブルからの 1 対多の関連付けのビューです。
多対 1 の関係
これらの OneToManyRelationship プロパティを含みます:
| プロパティ | Description |
|---|---|
ReferencedEntity |
関連するテーブルの論理名です。 |
ReferencedAttribute |
関連テーブルの 主キー の論理名。 |
ReferencingEntity |
ルックアップ列を持つ関連テーブルの論理名。 |
ReferencingAttribute |
主テーブルの主キーへの参照を含む、関連テーブルのルックアップ列の論理名。 |
IsHierarchical |
関連付けが自己参照の階層的な関連付けを表すかどうか |
CascadeConfiguration |
親エンティティで実行されたどの操作が、関連するエンティティに伝播するかを説明するデータ。 詳細: 伝播構成 |
一対多関連付け
これらの OneToManyRelationship プロパティを含みます:
| プロパティ | Description |
|---|---|
ReferencingEntity |
関連するテーブルの論理名です。 |
ReferencingAttribute |
プライマリ テーブルのプライマリ キーへの参照を含む、関連テーブルの列の論理名です。 |
IsCustomizable |
関連付けの管理プロパティが変更できるかどうか。 |
ReferencedEntityNavigationPropertyName |
この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。 詳細については次を参照してください: Web API ナビゲーション プロパティ |
AssociatedMenuConfiguration |
モデル駆動型アプリで使用されるデータで、関連するエンティティ データが主エンティティから UI 内でアクセスできるかどうか、およびそのエンティティ データにアクセスする方法をコントロールします。 |
多対多関連付け
各多対多関連付けには Entity1LogicalName および Entity2LogicalName が含まれます。 このドキュメントでは、リレーションシップの詳細を現在のテーブルのコンテキストで説明します。 それが Entity1 であるか Entity2であるかは、あまり重要ではありません。
各多対多関連付けには次のプロパティが含まれます。
| プロパティ | Description |
|---|---|
IntersectEntityName |
この多対多のリレーションシップをサポートする交差テーブルの論理名。 この値は、FetchXml を使用してテーブル列を結合するときに使用できます |
IsCustomizable |
関連付けの管理プロパティが変更できるかどうか。 |
SchemaName |
リレーションシップのスキーマ名。 |
IntersectAttribute |
この型のレコードの主キーとなる交差テーブルの列名。 |
NavigationPropertyName |
この関連付けの Web API コレクション値を持つナビゲーション プロパティの名前。 詳細については次を参照してください: Web API ナビゲーション プロパティ |
AssociatedMenuConfiguration |
モデル駆動型アプリが使用するデータで、このテーブルから UI で 2 番目のテーブルデータにアクセスできるかどうか、またどのようにアクセスできるかを制御します。 |
接続ロール (ConnectionRole) connectionroleassociation_association のように、多対多のリレーションシップが自己参照であるまれなケースでは、Entity1 または Entity2 がプロパティの前に付加されます。
| プロパティ | 価値 |
|---|---|
Entity1IntersectAttribute |
最初のテーブルとしてこのタイプのレコードの主キーとなる、交差テーブルの列の名前。 |
Entity2IntersectAttribute |
2 番目のテーブルとして、このタイプのレコードの主キーとなる交差テーブルの列の名前。 |
Entity1NavigationPropertyName |
このリレーションシップの最初のテーブルとしての Web API コレクション値ナビゲーション プロパティの名前。 |
Entity2NavigationPropertyName |
このリレーションシップの、2 番目のテーブルとしての Web API コレクション値ナビゲーション プロパティの名前。 |
Entity1AssociatedMenuConfiguration |
モデル駆動型アプリで使用されるデータで、2 番目のテーブルのデータを 1 番目のテーブルとして、このテーブルから UI でアクセスできるかどうか、またどのようにアクセスできるかを制御します。 |
Entity2AssociatedMenuConfiguration |
モデル駆動型アプリが使用するデータで、2 番目のテーブルとしてこのテーブルから UI で 2 番目のテーブル データにアクセスできるかどうか、またどのようにアクセスできるかを制御します |