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

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

メタデータの視覚的表示は特に、システムのエンティティ間の関係を示すときに非常に役立ちます。Microsoft Dynamics 365 (オンラインおよび設置型) 用に用意されたメタデータ ダイアグラムのサンプル コードを使用して、エンティティ関係図を生成することができます。 1 つのエンティティの関連付けを示した簡単な図を作成することも、カスタム エンティティやシステム エンティティを含めた大量の関連エンティティを含む複雑な図を作成することもできます。

このトピックの内容

エンティティ図の関係

図について

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

エンティティ図の関係

次の例は Microsoft Dynamics 365 で作成した 2 種類の新しいユーザー定義エンティティを示します。 最初のエンティティは銀行口座を表し、2 つ目は貸金庫を表します。 次のエンティティ図は、メタデータ ダイアグラム ツールを使用して生成されました。 システムの new_bankaccount エンティティ、new_safedepositbox エンティティ、その他のエンティティ間の関係を示します。 表示される名前は、エンティティの論理名です。 同じ 2 つのエンティティ間に複数の関係がある場合、簡素化のため図には 1 行のみが表示されます。

主エンティティが銀行口座または貸金庫である場合の 1 対多の関連付けを次の表に示しています。

関連付けのスキーマ名	エンティティ参照
new_bankaccount_ActivityPointers	activitypointer
new_bankaccount_Appointments	予定
new_bankaccount_Emails	電子メール
new_bankaccount_Faxes	fax
new_bankaccount_Letters	letter
new_bankaccount_PhoneCalls	phonecall
new_bankaccount_ServiceAppointments	serviceappointment
new_bankaccount_Tasks	タスク
new_bankaccount_RecurringAppointmentMasters	recurringappointmentmaster
new_bankaccount_DuplicateMatchingRecord	duplicaterecord
new_bankaccount_DuplicateBaseRecord	duplicaterecord
new_bankaccount_Annotations	annotation
new_bankaccount_AsyncOperations	asyncoperation
new_bankaccount_UserEntityInstanceDatas	userentityinstancedata
new_bankaccount_ProcessSession	processsession
new_bankaccount_BulkDeleteFailures	bulkdeletefailure
new_bankaccount_PrincipalObjectAttributeAccesses	principalobjectattributeaccess
new_new_bankaccount_new_safedepositbox	new_safedepositbox
new_safedepositbox_ActivityPointers	activitypointer
new_safedepositbox_Appointments	予定
new_safedepositbox_Emails	電子メール
new_safedepositbox_Faxes	fax
new_safedepositbox_Letters	letter
new_safedepositbox_PhoneCalls	phonecall
new_safedepositbox_ServiceAppointments	serviceappointment
new_safedepositbox_Tasks	タスク
new_safedepositbox_RecurringAppointmentMasters	recurringappointmentmaster
new_safedepositbox_DuplicateMatchingRecord	duplicaterecord
new_safedepositbox_DuplicateBaseRecord	duplicaterecord
new_safedepositbox_Annotations	annotation
new_safedepositbox_AsyncOperations	asyncoperation
new_safedepositbox_UserEntityInstanceDatas	userentityinstancedata
new_safedepositbox_ProcessSession	processsession
new_safedepositbox_BulkDeleteFailures	bulkdeletefailure
new_safedepositbox_PrincipalObjectAttributeAccesses	principalobjectattributeaccess

主エンティティが銀行口座または貸金庫である場合の多対 1 の関連付けを次の表に示しています。

関連付けのスキーマ名	参照エンティティ
lk_new_bankaccount_createdby	systemuser
lk_new_bankaccount_createdonbehalfby	systemuser
lk_new_bankaccount_modifiedby	systemuser
lk_new_bankaccount_modifiedonbehalfby	systemuser
user_new_bankaccount	systemuser
team_new_bankaccount	チーム
owner_new_bankaccount	owner
business_unit_new_bankaccount	businessunit
new_account_new_bankaccount	取引先企業
lk_new_safedepositbox_createdby	systemuser
lk_new_safedepositbox_createdonbehalfby	systemuser
lk_new_safedepositbox_modifiedby	systemuser
lk_new_safedepositbox_modifiedonbehalfby	systemuser
user_new_safedepositbox	systemuser
team_new_safedepositbox	チーム
owner_new_safedepositbox	owner
business_unit_new_safedepositbox	businessunit
new_new_bankaccount_new_safedepositbox	new_bankaccount

図に表示される取引先企業エンティティは銀行顧客を表します。 銀行顧客として、当座預金口座や普通預金口座などの複数の銀行口座や、複数の貸金庫を開くことができます。 これは、銀行口座と顧客との間、および貸金庫と顧客との間の多対 1 の関係の例です。 タスク、電子メール、予定など、複数の活動を銀行口座に関連付けることができます。 銀行口座または貸金庫に関する詳細情報を提供するため、メモと添付ファイルを使用できます。

図について

エンティティの機能を説明するトピックの SDK ドキュメントで、多くのシステム エンティティの図を確認できます。 図の各ボックスでは、最初の行の太字テキストがエンティティの名前です。 これ以降の行には、そのエンティティの関連付けの定義に使用する属性の名前が表示されます。 ツールでは、組織、部署、ユーザー (systemuser) エンティティの関連付けを示す行は生成されません。 これは、図を使用してのみ行えます。 色分けは、各エンティティの所有者関係の表示に使用されます。 次の図で、色分けの内容を説明します。

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

Microsoft Office Visio のメタデータ図をプログラムで生成するサンプル コードを使用するには、SDK パッケージSDK\SampleCode\CS\Metadata\Diagramにあるこれらのソリューションの 1 つを作成して実装します。 フォルダーには、使用方法を示す Readme ファイルがあります。 コード サンプルはエンティティ関係図を作成するスタンドアロン コンソール アプリケーションです。 プログラムで Microsoft Office Visio が必要です。

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

    MetadataDiagramConsole.exe new_bankaccount new_safedepositbox

生成された Visio ファイルの名前は new_bankaccount.vsd です。

注意

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

MetadataDiagramConsole.exe new_bankaccount

MetadataDiagramConsole.exe new_bankaccount new_safedepositbox

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

関連項目

Microsoft Dynamics 365 のエンティティの概要
Dynamics 365 メタデータと共に組織サービスを使用する
エンティティ図の要点
CRM 2015 エンティティ関係図

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権