エンティティの図の生成にメタデータを使用する

メタデータの視覚的表示は特に、システムのエンティティ間の関係を示すときに役立ちます。 コード サンプルとして入手できるメタデータ ダイアグラム ツールを使用して、組織の Web サービスのメタデータを読み取り、そのデータからエンティティ関係図を生成できます。

1 つのエンティティの関連付けを示した図を作成することも、カスタム エンティティやシステム エンティティを含めた大量の関連エンティティを含む複雑な図を作成することもできます。

エンティティ図の関係

次の例では、Power Apps で作成した「Safe Deposit Box」という新しいカスタム エンティティと、若干のカスタマイズを施した「Bank Account」 (アカウント) エンティティとの関係を示しています。

次のエンティティ図は、メタデータ ダイアグラム ツールを使用して生成したものです。 システムの account エンティティ、カスタム new_safedepositbox エンティティ、その他のエンティティ間の関係を示します。 表示される名前は、エンティティの論理名です。

注意

同じ 2 つのエンティティ間に複数の関係がある場合、簡素化のため図には 1 行のみが表示されます。

Power Apps のテーブルの リレーションシップに関する情報を検索できます。 Safe Deposit Box との 1 対多の関係に注意してください。

図に表示される銀行アカウント エンティティは銀行顧客を表します。 銀行の顧客は、当座預金や普通預金など複数の銀行口座を開設することができ、それぞれの銀行口座には 0 個以上の貸金庫を設置できます。 これは、銀行口座と貸金庫の間の 1 対多のリレーションシップの例です。

タスク、電子メール、予定など、複数の活動を銀行口座に関連付けることができます。 銀行口座は顧客と関連付けられ、取引先担当者が記録され、サポート依頼のためのチャットログが保存されます。

図について

エンティティの機能を説明するトピックの SDK ドキュメントで、多くのシステム エンティティの図を確認できます。 図の各ボックスでは、最初の行の太字テキストがエンティティの名前です。 これ以降の行には、そのエンティティの関連付けの定義に使用する属性の名前が表示されます。

メタデータ ダイアグラム ツールでは、組織、部署、ユーザー (systemuser) エンティティの関連付けを示す行は生成されません。 これは、図を使用してのみ行えます。 色分けは、各エンティティの所有者関係の表示に使用されます。 次の図で、色分けの内容を説明します。

メタデータ ダイアグラム ツールを使用してエンティティのダイアグラムを生成する

メタデータ ダイアグラム ツールを使用して Microsoft Visio のメタデータ ダイアグラムを生成するには、コード サンプルのプロジェクト フォルダにある提供された Visual Studio ソリューションを使用して、ツール コードをビルドして実行します。

サンプルのソースコード: メタデータ ダイアグラム ツールを使用してエンティティの図を作成する

プロジェクト フォルダーには、サンプルをビルドして実行する手順が記載された Readme ファイルが含まれています。 コード サンプルはエンティティ関係図を作成するスタンドアロン コンソール アプリケーションです。 このプログラムでは、Visio ライブラリ関数を呼び出して図を生成するため、Microsoft Visio がコンピューターにインストールされている必要があります。

コマンド プロンプトでプログラムを実行できます。 コマンド ラインの引数として図に含めることができるエンティティが一覧表示されます。 そのほかのエンティティは、必要に応じて図に含めて、必要な各エンティティの関係をすべて表示することができます。 アカウントおよび new_safedepositbox エンティティの関連付けを示すダイアグラムを生成するには、次のコマンドを使用します:

GenerateEntityDiagram.exe account new_safedepositbox

これが機能するには、カスタム エンティティ new_safedepositbox が環境内に存在する必要があります。 それ以外の場合は、存在するエンティティの任意の組み合わせを試してください - おそらく「アカウントの連絡先」です。 生成された Visio ファイルの名前は account.vsd です。

注意

ツールで、Visio ファイルの名前としてコマンド ラインの最初のエンティティ名を使用します。 次の 2 種類のコマンドを実行する場合は、2 番目のコマンドにより最初に生成された図が上書きされます。 これは Visio ファイルに同じ名前 "account.vsd" が含まれているためです:

GenerateEntityDiagram.exe account

GenerateEntityDiagram.exe account new_safedepositbox

生成された図ファイルを上書きしないようにするには、2 番目のコマンドを実行する前に、最初のファイルの名前を変更する必要があります。

コミュニティ ツール

UML 図ジェネレータ

XrmToolBox 用 UML 図ジェネレータ は、Microsoft Dynamics 365 と Power Platform Dataverse でメタデータから PlantUML ファイルの形でエンティティ関係図 (ERD) を生成するツールです。 結果はテキストベースのファイルなので、手動で編集してソース管理に保持し、長期間の変更を追跡できます。

XrmToolBox 用の**エンティティ関係図作成者** は、Microsoft Dynamics 365 と Power Platform Dataverse でメタデータから視覚的なエンティティ関係図を生成するツールです。

ERD Visio Builder for XrmToolBox は、Microsoft Dynamics 365 と Power Platform Dataverseのメタデータから Visio ダイアグラムを生成するツールです。

コミュニティ開発ツールについては開発者ツールの記事を、UML 図ジェネレーターについては jonasr.app/uml の記事を、ERD Visio Builder については LinkeD365.blog の記事を参照してください。

注意

コミュニティ ツールは Microsoft の製品ではなく、コミュニティ ツールに対するサポートは提供されません。 このツールに関するご質問は、その発行元にお問い合わせください。 詳細: XrmToolBox。

参照

コードを使用した Dataverse テーブルの操作
コードを使ってテーブル定義を操作する

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。