Diagrammerstellung und Modellierung

IFS-Logo Diese Seite ist ein Teil der IsyFact-Standards. Alle Inhalte der Seite, insbesondere Texte und Grafiken, sind urheberrechtlich geschützt. Alle urheberrechtlichen Nutzungs- und Verwertungsrechte liegen beim Bundesverwaltungsamt.

Creative Commons Namensnennung Die Nutzung ist unter den Lizenzbedingungen der Creative Commons Namensnennung 4.0 International gestattet.

1. Modellierung und Diagrammerstellung

Schaubilder, Diagramme und grafische Modelle unterstützen das Verständnis von Inhalten. Die Ausprägungen von Diagrammen sind vielfältig: Insbesondere grenzen sich durch Modelle getriebene, stark formalisierte Darstellungen und Diagramme von freieren Schaubildern ab. Abhängig von den Anforderungen an die Diagrammerstellung kommen grundsätzlich unterschiedliche Werkzeugen mit ebenso unterschiedlichen Stärken und Schwächen infrage.

Die IsyFact empfiehlt die Verwendung von diagrams.net und Enterprise Architect.

Tabelle 1. Entscheidungshilfe zur Auswahl eines Werkzeugs zur Diagrammerstellung
Anforderung an die Diagrammerstellung Enterprise Architect diagrams.net

Einheitlichkeit der Diagramme (z.B. über Schablonen)

ja

eingeschränkt¹

Diagramme können in AsciiDoc integriert werden

ja

ja

Quelldateien können einzeln als Teil des Quellcodes abgelegt werden

ja²

ja

Bilder für Diagramme können automatisch gebaut werden

nein³

ja

Unterstützung von UML-Daten-Modellen

ja

nein

Einfachheit der Bedienung

nein

ja

Keine Abhängigkeiten zu Arbeitsplatzumgebungen

nein

ja

¹ Bietet nur Grafikvorlagen - keine echten UML-Profile.
² Möglich, aber widerspricht dem Modellansatz.
³ Automatisches Bauen nur über Frameworks wie docToolchain; bisher kein Plan zur Standardisierung.

2. Einsatzszenarien diagrams.net

diagrams.net eignet sich insbesondere für:

  • Diagramme und Schaubilder, die nicht UML-konform sein müssen,

  • Mockups und andere Diagrammtypen.

Eine wesentliche Stärke des Werkzeugs ist die Speicherung des editierbaren Quellmodells im Zielbild (in den Formaten PNG und SVG). Durch direktes Ablegen der Datei beim Code ist keine getrennte Datenhaltung oder Generierung erforderlich. Die Datei kann direkt eingebunden werden.

Für das Wiki-System Confluence sowie das Ticket-System Jira der Firma Atlassian gibt es das Add-on draw.io, welches das Erstellen und Bearbeiten von Diagrammen erlaubt und im Kern diagrams.net entspricht. Die Erstellung von Diagrammen im Kontext Wiki-getriebener Dokumentation erfolgt somit voll integriert.

Die IsyFact bietet eine Konfiguration sowie vorgefertigte Elemente für die Erstellung von Diagrammen mit diagrams.net.

3. Einsatzszenarien Enterprise Architect

Enterprise Architect wird häufig verwendet, um modellgetriebene Diagramme für Referenzarchitekturen, Systemspezifikationen und Systementwürfe zu erstellen, da diese Dokumentausprägungen:

  • hauptsächlich UML- und ER-Diagramme enthalten,

  • UML-Profil-fähig und konform sein sollen und

  • die Verwendung eines UML-Datenmodells die Wartung und Sicherstellung der Konsistenz der Daten und Diagramme gewährleistet.

Die Herausforderungen dieses Werkzeugs sind:

  • die Trennung von zentralem Modell und i.d.R. manueller Generierung der erforderlichen Diagramme,

  • die steile Lernkurve und komplexe Bedienung,

  • Einschränkungen und längere Bearbeitungszeit bei freien Schaubildern.

Die IsyFact bietet UML-Profile an und unterstützt die Erstellung von Systemspezifikationen mit dem Enterprise Architect.