次の方法で共有


Dynamics 365 Sales テーブル/エンティティ参照

Dataverse テーブル は、すべての環境データベースが持つテーブルの共通セットを提供します。

Dynamics 365 Enabled アプリテーブル/エンティティ リファレンスには、Sales などの Dynamics 365 アプリをインストールする前に必要な追加テーブルが含まれています。

ここに記載されているテーブルは、作成した環境に Dataverse を追加する際に、Dynamics 365 Salesのインストールを選択したタイミングで追加または変更されます。

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

  • IsPrivatefalse と等しい

  • IsIntersectfalse に等しい、または IsIntersecttrue に等しく、テーブルに 4 つ以上の列が含まれる場合。

    • ほとんどの交差テーブルには、多対多の関連付けをサポートするために必要な 4 つの列のみが含まれています。 これらは利便性に優れているわけではありません。 4 つ以上の列を持つ交差テーブルの方が興味深いです。

[メッセージ]

このリストのメッセージはエンティティに適用されます。 たとえば、ユーザー所有のテーブルは、組織所有のテーブルがサポートしていないときに、AssignGrantAccessModifyAccessRevokeAccess をサポートします。

.NET 用 SDK

SDK for .NET を使用する場合は通常、Microsoft.Crm.Sdk.Messages または Microsoft.Xrm.Sdk.Messages 名前空間に属する対応する要求クラスを呼び出すことができます。 これらのクラスは、メッセージ名に追加された Request プレフィックスを含む名前を持っています。

いくつかのメッセージは、サポートするソリューションのカスタム アクションとして追加されます。 これらのメッセージは SDK アセンブリ内では定義されていませんが、使用する方法はいくつかあります

Web API

Web API を使用する場合、これらのリファレンスで定義されている一般的な Dataverse OData 関数とアクションを見つけることができます。

これらの関数とアクション、および追加された関数とアクションについては、次の方法でこれらを使用する方法を確認できます。

  1. パラメーターと返り値の詳細については、$metadata サービス ドキュメントを参照してください。 詳細については、アクションの定義関数の定義 を参照してください。
  2. アクションや関数を呼び出します。 詳細については、Web API アクションを使用するWeb API 関数を使用する を参照してください。

Events

イベントは、サブスクライブできるように存在するメッセージです。 イベントを追加しない限り、メッセージを呼び出すのではなく、サブスクライブだけすべきです。 イベントをサブスクライブするには、次のようないくつかの方法があります。

プロパティ​​

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

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

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

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

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

顧客間関係

EntityMetadata クラスには、関連付けを表す 3 つのプロパティが含まれます。

プロパティ タイプ 説明
OneToManyRelationships OneToManyRelationshipMetadata[] エンティティの 1 対多リレーションシップの配列を取得します。
ManyToOneRelationships OneToManyRelationshipMetadata[] エンティティの多対 1 リレーションシップの配列を取得します。
ManyToManyRelationships ManyToManyRelationshipMetadata[] エンティティの多対多リレーションシップの配列を取得します。

注意

各テーブルがそれに適用されるそれらの関連付けをリストする一方、各関連付けは両方の関連するテーブルによって共有されることに留意することが重要です。 この関連付けはテーブルに存在します。 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 この多対多のリレーションシップをサポートする交差テーブルの論理名。
この値は、FetchXml を使用してテーブル列を結合するときに使用できます
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 モデル駆動型アプリで使用されるデータで、2 番目のテーブルのデータを 1 番目のテーブルとして、このテーブルから UI でアクセスできるかどうか、またどのようにアクセスできるかを制御します。
Entity2AssociatedMenuConfiguration モデル駆動型アプリが使用するデータで、2 番目のテーブルとしてこのテーブルから UI で 2 番目のテーブル データにアクセスできるかどうか、またどのようにアクセスできるかを制御します