Dynamics 365 Customer Service テーブル/エンティティ リファレンス

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

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

ここにリストされているテーブルは、 作成した環境に Dataverse を追加するときに Dynamics 365 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 関数とアクションを見つけることができます。

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

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

1. パラメーターと戻り値の詳細については、 $metadata サービス文書 を調べてください。 詳しくは、 アクション定義 および 関数定義 を参照してください。
2. アクションと関数を呼び出します。 詳細については、「 Web API アクションの使用 」および 「Web API 関数の使用 」を参照してください。

イベント

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

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

プロパティ

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

列

列は、 書き込み可能な列/属性 と 読み取り専用の列/属性の 2 つのセクションに一覧表示されます。 この分離の目的は、開発者がテーブル内の行を作成または更新するときに設定できる列に焦点を当てることです。 これらの列を理解すると、開発者は、値を取得するだけでなく、テーブルで何ができるかを理解するのに役立ちます。

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

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

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

人間関係

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

多対 1 の関係

次の OneToManyRelationship プロパティが含まれます。

1 対多の関係

次の OneToManyRelationship プロパティが含まれます。

多対多の関係

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

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

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