Verwenden von Metadaten zum Generieren von Entitätsdiagrammen

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Visuelle Darstellung der Metadaten kann sehr nützlich sein, insbesondere wenn Sie versuchen, die Beziehung zwischen Entitäten im System zu beschreiben. Sie können den Metadaten-Diagrammbeispielcode verwenden, der für Microsoft Dynamics 365 (online und lokal) bereitgestellt wird, um die Entitätsbeziehungsdiagramme zu generieren. Sie können ein einfaches Diagramm, in dem eine Beziehung für eine Entität angezeigt werden, oder ein komplexes Diagramm erstellen, das Dutzende von verknüpften Entitäten enthält, einschließlich Systementitäten und benutzerdefinierte Entitäten.

In diesem Thema

Beziehungen in Entitätsdiagrammen

Informationen zu Diagrammen

Generieren von Entitätsdiagrammen mit dem Metadatendiagrammtool

Beziehungen in Entitätsdiagrammen

Im folgenden Beispiel werden zwei neue benutzerdefinierte Entitäten gezeigt, die in Microsoft Dynamics 365 erstellt werden. Die erste Entität stellt ein Bankkonto dar, die zweite Entität stellt ein Bankschließfach dar. Das folgende Entitätsdiagramm wurde mithilfe des Metadaten-Diagrammtools generiert. Es zeigt die Beziehung zwischen der new_bankaccount-Entität, der new_safedepositbox-Entität und anderen Entitäten im System an. Die angezeigten Namen sind die logischen Entitätsnamen. Beachten Sie, dass, wenn zwischen den gleichen beiden Entitäten mehrere Beziehungen vorhanden sind, der Einfachheit halber nur eine Zeile im Diagramm gezeichnet wird.

In der folgenden Tabelle werden die 1:n-Beziehungen angezeigt, wobei die primäre Entität ein Bankkonto oder ein Bankschließfach ist.

Beziehungsschemaname	Referenzierende Entität
new_bankaccount_ActivityPointers	activitypointer
new_bankaccount_Appointments	appointment
new_bankaccount_Emails	E-Mail
new_bankaccount_Faxes	fax
new_bankaccount_Letters	letter
new_bankaccount_PhoneCalls	phonecall
new_bankaccount_ServiceAppointments	serviceappointment
new_bankaccount_Tasks	Aufgabe
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	appointment
new_safedepositbox_Emails	E-Mail
new_safedepositbox_Faxes	fax
new_safedepositbox_Letters	letter
new_safedepositbox_PhoneCalls	phonecall
new_safedepositbox_ServiceAppointments	serviceappointment
new_safedepositbox_Tasks	Aufgabe
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

In der folgenden Tabelle werden die n:1-Beziehungen angezeigt, wobei die primäre Entität ein Bankkonto oder ein Bankschließfach ist.

Beziehungsschemaname	Referenzierte Entität
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	Team
owner_new_bankaccount	Besitzer
business_unit_new_bankaccount	businessunit
new_account_new_bankaccount	account
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	Team
owner_new_safedepositbox	Besitzer
business_unit_new_safedepositbox	businessunit
new_new_bankaccount_new_safedepositbox	new_bankaccount

Die Kontoentität, die im Diagramm angezeigt wird, stellt einen Bankkunden dar. Als Bankkunde können Sie mehrere Bankkonten öffnen, zum Beispiel Giro- und Sparkonten sowie Bankschließfächer. Dies ist ein Beispiel eines n:1-Beziehungstyps zwischen einem Bankkonto und einem Kunden sowie einem Bankschließfach und einem Kunden. Sie können mehrere Aktivitäten, wie E-Mails, Aufgaben und Termine, einem Bankkonto zuordnen. Um weitere Informationen über ein Bankkonto oder ein Bankschließfach bereitzustellen, können Sie Notizen und Anlagen verwenden.

Informationen zu Diagrammen

Sie können Diagramme für eine Vielzahl von Systementitäten in der SDK-Dokumentation in den Themen finden, die die Entitätsfunktionen beschreiben. In jedem Feld im Diagramm enthält die erste Zeile im fett formatierten Text den Namen der Entität. Nachfolgende Zeilen enthalten die Namen der Attribute, die verwendet werden, um die Beziehungen für diese Entität zu definieren. Dieses Tool generiert keine Zeilen, die die Beziehungen für die folgenden Entitäten anzeigen: Unternehmenseinheit, Organisation und Benutzer (systemuser). Dies ist notwendig, um das Diagramm zu vereinfachen. Farbkennzeichnung wird verwendet, um die Besitzersbeziehung für jede Entität anzugeben. Im folgenden Diagramm werden die Farbkennzeichnungen beschrieben:

Generieren von Entitätsdiagrammen mit dem Metadatendiagrammtool

Um den Beispielcode zu verwenden, der Microsoft Office Visio-Metadatendiagramme programmgesteuert generiert, müssen Sie eine dieser Lösungen aus dem SDK-Paket erstellen und ausführen: SDK\SampleCode\CS\Metadata\Diagram. Der Ordner enthält eine Readme-Datei mit Anweisungen für ihre Verwendung. Die Codebeispiel ist eine eigenständige Konsolenanwendung, die ein Entitätsbeziehungsdiagramm erstellt. Das Programm erfordert Microsoft Office Visio.

Das Programm an der Eingabeaufforderung ausgeführt werden. Listen Sie einfach die Entitäten auf, die Sie im Diagramms als Befehlszeilenargumente einschließen möchten. Andere Entitäten können in das Diagramm bei Bedarf eingeschlossen werden, um alle Beziehungen für jede Entität anzuzeigen, die Sie angefordert haben. Um ein Diagramm zu generieren, das Beziehungen für die Entitäten new_bankaccount und new_safedepositbox angezeigt, verwenden Sie den folgenden Befehl:

MetadataDiagramConsole.exe new_bankaccount new_safedepositbox

Der Name der generierten Visio-Datei lautet new_bankaccount.vsd.

Hinweis

Das Tool verwendet den Namen der ersten Entität in der Befehlszeile als Name der Visio-Datei. Wenn Sie die beiden folgenden Befehle ausführen, überschreibt der zweite Befehl das Diagramm, das vom ersten Befehl generiert wurde. Dies liegt daran, dass die Visio-Dateien den gleichen Namen besitzen – "new_bankaccount.vsd:

MetadataDiagramConsole.exe new_bankaccount

MetadataDiagramConsole.exe new_bankaccount new_safedepositbox

Um das Überschreiben einer generierten Diagrammdatei zu vermeiden, müssen Sie die erste Datei umbenennen, bevor Sie den zweiten Befehl ausführen.

Siehe auch

Einführung in Entitäten in Microsoft Dynamics 365
Verwenden des Organisationsdienstes mit Dynamics 365-Metadaten
Schlüssel für Entitätsdiagramme
CRM 2015-Entitätsbeziehungsdiagramme

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright