Generieren von Entitätsdiagrammen mithilfe von Metadaten

Eine visuelle Darstellung von Metadaten kann nützlich sein, insbesondere wenn Sie versuchen, die Beziehung zwischen Entitäten im System zu beschreiben. Sie können das Metadatendiagrammtool verwenden, das als Codebeispiel verfügbar ist, um die Metadaten des Organisationswebdiensts zu lesen und Entitätsbeziehungsdiagramme aus diesen Daten zu generieren.

Sie können ein Diagramm erstellen, das eine Beziehung für nur eine Entität oder ein komplexes Diagramm zeigt, das Dutzende verwandter Entitäten enthält, einschließlich benutzerdefinierter und Systementitäten.

Beziehungen in Entitätsdiagrammen

Das folgende Beispiel zeigt eine neue benutzerdefinierte Entität namens "Safe Deposit Box", die in Power Apps erstellt wurde, und deren Beziehung zu einer leicht angepassten Entität "Bankkonto" (Konto).

Das folgende Entitätsdiagramm wurde mithilfe des Metadatendiagrammtools generiert. Es zeigt die Beziehung zwischen der account Entität, der benutzerdefinierten new_safedepositbox Entität und anderen Entitäten im System. Die angezeigten Namen sind die logischen Entitätsnamen.

Hinweis

Wenn es mehrere Beziehungen zwischen denselben beiden Entitäten gibt, zeigt das Diagramm nur eine Zeile aus Gründen der Einfachheit.

Entitätsbeziehungsdiagramm für eine benutzerdefinierte Entität.

Sie können Informationen zu Beziehungen für eine Tabelle in Power Apps nachschlagen. Beachten Sie die 1:n-Beziehung mit dem Bankschließfach.

Bankkontobeziehungen.

Die Bankkontoentität, die im Diagramm dargestellt wird, stellt ein Bankkonto für einen Kunden dar. Als Bankkunde können Sie mehrere Bankkonten öffnen, z. B. Check- und Sparkonten, bei denen jedes Bankkonto null oder mehr Safe Deposit Boxes haben kann. Diese Beziehung ist ein Beispiel für einen 1:n-Beziehungstyp zwischen einem Bankkonto und Schließfächern.

Sie können mehrere Aktivitäten, z. B. Aufgaben, E-Mails und Termine, einem Bankkonto zuordnen. Das Bankkonto ist einem Kunden zugeordnet, es gibt Kontaktinformationen in der Datei, und ein Chatprotokoll für Supportanfragen wird aufbewahrt.

Informationen zu den Diagrammen

Die SDK-Dokumentation enthält Diagramme für viele Systementitäten. Diese Diagramme finden Sie in den Themen, in denen die Entitätsfunktionen beschrieben werden. Jedes Feld im Diagramm enthält in der ersten Zeile den fettgedruckten Entitätsnamen. In den folgenden Zeilen werden die Attribute aufgeführt, die die Beziehungen für diese Entität definieren.

Das Metadatendiagrammtool generiert keine Zeilen, die die Beziehungen zu den Organisations-, Geschäftseinheits- und Benutzerentitäten (Systembenutzer) anzeigen. Diese Auswahl vereinfacht das Diagramm. Farbcodierung gibt die Besitzerbeziehung für jede Entität an. Das folgende Diagramm beschreibt die Farbcodierung:

Diagrammschlüssel für Entitätsbeziehungsdiagramme.

Generieren von Entitätsdiagrammen mit dem Metadatendiagrammtool

Um das Metadatendiagrammtool zum Generieren von Microsoft Visio-Metadatendiagrammen zu verwenden, erstellen und führen Sie den Toolcode mithilfe der bereitgestellten Visual Studio-Lösung im Projektordner des Codebeispiels aus.

Beispielquellcode: Generieren von Entitätsdiagrammen mit dem Metadatendiagrammtool

Der Projektordner enthält eine Infodatei mit Anweisungen zum Erstellen und Ausführen des Beispiels. Das Codebeispiel ist eine eigenständige Konsolenanwendung, die ein Entitätsbeziehungsdiagramm erstellt. Das Programm erfordert, dass Microsoft Visio auf Ihrem Computer installiert wird, da es Visio-Bibliotheksfunktionen aufruft, um das Diagramm zu generieren.

Sie können das Programm an der Befehlszeile ausführen. Listen Sie die Entitäten auf, die Sie im Diagramm als Befehlszeilenargumente einschließen möchten. Sie können nach Bedarf andere Entitäten in Ihr Diagramm einschließen, um alle Beziehungen für jede von Ihnen angeforderte Entität anzuzeigen. Verwenden Sie den folgenden Befehl, um ein Diagramm zu generieren, das die Beziehungen für das Konto und new_safedepositbox Entitäten zeigt:

GenerateEntityDiagram.exe account new_safedepositbox

Die benutzerdefinierte Entität new_safedepositbox muss in Ihrer Umgebung vorhanden sein, damit dieser Befehl funktioniert. Versuchen Sie andernfalls eine beliebige Kombination vorhandener Entitäten – vielleicht „Kontokontakt“. Der Name der generierten Visio-Datei ist account.vsd.

Hinweis

Das Tool verwendet den Namen der ersten Entität in der Befehlszeile als Namen der Visio-Datei. Wenn Sie die folgenden beiden Befehle ausführen, überschreibt der zweite Befehl das vom ersten generierte Diagramm. Dieses Verhalten tritt auf, da die Visio-Dateien denselben Namen haben : "account.vsd":

GenerateEntityDiagram.exe account

GenerateEntityDiagram.exe account new_safedepositbox

Um zu vermeiden, dass eine generierte Diagrammdatei überschrieben wird, benennen Sie die erste Datei um, bevor Sie den zweiten Befehl ausführen.

Communitytools

Die folgenden von der Community entwickelten Tools bieten alternative Möglichkeiten zum Generieren von Entitätsbeziehungsdiagrammen aus Dataverse-Metadaten.

UML-Diagrammgenerator

UML-Diagrammgenerator für XrmToolBox ist ein Tool, das Entitätsbeziehungsdiagramme (ERD) als PlantUML-Dateien aus Metadaten in Microsoft Dynamics 365 und power Platform Dataverse generiert. Da es sich bei dem Ergebnis um textbasierte Dateien handelt, können Sie sie manuell bearbeiten und in der Versionsverwaltung verwalten, um Änderungen im Laufe der Zeit nachzuverfolgen.

Entitätsbeziehungsdiagrammersteller

Diese Tools generieren visuelle Entitätsbeziehungsdiagramme aus Metadaten in Microsoft Dynamics 365 und power Platform Dataverse.

ERD Visio-Generator

ERD Visio Builder für XrmToolBox ist ein Tool, das Visio-Diagramme aus Metadaten in Microsoft Dynamics 365 und power Platform Dataverse generiert.

Weitere Communitytools

Weitere Informationen finden Sie im Artikel " Entwicklertools ". Weitere Informationen zum UML-Diagrammgenerator finden Sie unter jonasr.app/uml. Weitere Informationen zum ERD Visio Builder finden Sie unter LinkeD365.blog.

Hinweis

Die Communitytools sind kein Produkt von Microsoft, und Microsoft bietet keinen Support für sie. Wenn Sie Fragen zum Tool haben, wenden Sie sich an den Herausgeber. Weitere Informationen finden Sie unter XrmToolBox.

Siehe auch

Arbeiten mit Dataverse-Tabellen mithilfe von Code
Arbeiten mit Tabellendefinitionen mithilfe von Code