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

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

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

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

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

• IsPrivate が false と等しい

  • 外部のユースケースが存在しないテーブルは除外されます。 非公開テーブルに関する詳細情報

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

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

[メッセージ]

このリストのメッセージはエンティティに適用されます。 たとえば、ユーザー所有のテーブルは、組織所有のテーブルがサポートしていないときに、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 関数とアクションを見つけることができます。

• Web API アクション リファレンス
• Web API 関数リファレンス

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

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

Events

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

• アクションが実行された際のトリガーを使用して、Power Automate Dataverse コネクタを使用します。
• イベントに応答する Dataverse プラグインを登録します。
• Dataverse Azure 統合でイベントデータを Azure または Web フックに送信する

プロパティ​​

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

列

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

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

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

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

顧客間関係

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

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

これらの OneToManyRelationship プロパティを含みます:

一対多関連付け

これらの OneToManyRelationship プロパティを含みます:

多対多関連付け

各多対多関連付けには Entity1LogicalName および Entity2LogicalName が含まれます。 このドキュメントでは、リレーションシップの詳細を現在のテーブルのコンテキストで説明します。 それが Entity1 であるか Entity2であるかは、あまり重要ではありません。

各多対多関連付けには次のプロパティが含まれます。

接続ロール (ConnectionRole) connectionroleassociation_association のように、多対多のリレーションシップが自己参照であるまれなケースでは、Entity1 または Entity2 がプロパティの前に付加されます。