Mohammed Brückner

Enterprise architect and author in Munich: PlantUML and ArchiMate guides, platform economics, MLOps with Databricks, and practical AI adoption — hands-on, no hype.

Mohammed Brückner

PlantUML mit ArchiMate: Die kompakte deutsche Anleitung

Architekturdiagramme gehören ins Git-Repository, nicht in Zeichentools. Diese Anleitung fasst auf Deutsch zusammen, wie Sie mit PlantUML und der ArchiMate-Erweiterung Unternehmensarchitektur als Code erstellen. Die ausführlichen englischen Original-Guides sind unten verlinkt.

ÜBRIGENS: Platform Economies — mein neues Buch — erscheint am 1. September 2026.
Auf Amazon.de vorbestellen — die Kindle-Ausgabe ist jetzt verfügbar, das Taschenbuch folgt am 1. September. Auch erhältlich bei 🇺🇸 Amazon.com, 🇬🇧 UK, 🇯🇵 JP und 🇨🇦 CA.
Buchseite: mohammed-brueckner.com/platform-economies.

Inhaltsverzeichnis

Warum Diagramme als Code?

Wir versionieren Infrastruktur in Terraform und APIs in OpenAPI — aber Architekturdiagramme liegen als Binärdateien auf persönlichen Laufwerken. Nicht diffbar, nicht reviewbar, nach dem Export sofort veraltet. PlantUML löst das: Diagramme entstehen aus Text, leben im Git, und Änderungen werden als Pull Request reviewt. Mit der ArchiMate-Erweiterung entstehen daraus standardkonforme Unternehmensarchitektur-Diagramme.

Installation und Schnellstart

Der schnellste Weg ist die VS-Code-Erweiterung „PlantUML” — Vorschau beim Tippen, ohne weitere Einrichtung. Für die Kommandozeile und CI:

  1. Java installieren (aktuelles JRE genügt)
  2. plantuml.jar von plantuml.com/download laden
  3. Rendern: java -jar plantuml.jar diagramm.puml

Die ArchiMate-Bibliothek ist im Jar bereits enthalten — kein separater Download nötig: !include <archimate/Archimate>. Für sehr große Diagramme oder als Online-Alternative: Kroki.io.

Ein erstes ArchiMate-Beispiel

@startuml
!include <archimate/Archimate>
left to right direction
!theme plain
!global $ARCH_SPECIAL_SHAPES = %true()
skinparam linetype ortho

title Beispiel: Bestellplattform (ArchiMate)

Business_Actor(kunde, "Kunde")
Application_Component(portal, "Bestellportal")
Application_Service(api, "Bestell-API")
Technology_Node(server, "Anwendungsserver")

Rel_Serving(portal, kunde, "Bedient")
Rel_Realization(portal, api, "Realisiert")
Rel_Assignment(server, portal, "Führt aus")

@enduml

Drei Dinge machen dieses Grundgerüst stabil: !theme plain (kein Theme überschreibt die ArchiMate-Formen), $ARCH_SPECIAL_SHAPES = %true() (echte ArchiMate-Symbole statt generischer Kästen) und skinparam linetype ortho (rechtwinklige Linien statt „Spaghetti-Layout”).

Export und Qualität

  • PNG für Dokumente: skinparam dpi 300 vor dem Rendern — sonst wirken die Diagramme in Präsentationen unscharf.
  • SVG für Skalierung: java -jar plantuml.jar -tsvg diagramm.puml — Vektorgrafik, beliebig zoombar.
  • CI-Integration: plantuml -pipe im Build-Job — veraltete Diagramme werden so zum Build-Fehler statt zur peinlichen Entdeckung im Steering Board.

Die häufigsten Fehler

  1. !include <archimate/Archimate> schlägt fehl → PlantUML ist veraltet. Neues Jar laden, fertig. Es gibt keinen separaten Bibliotheks-Download.
  2. „Diagram too large” auf dem Online-Server → lokal rendern oder Kroki nutzen. Oder das Diagramm teilen: eine Sicht pro Fragestellung.
  3. Layout kreuzt sich → left to right direction und skinparam linetype ortho. Richtungshinweise wie Rel_Flow_Right(a, b, "label") sparsam einsetzen.
  4. Falsche Beziehungsrichtung → Serving zeigt vom Anbieter zum Nutzer, Access vom zugreifenden Verhalten zum Datenobjekt. Rückwärts gezeichnete Pfeile sind das Erste, was ein ArchiMate-geschulter Reviewer bemerkt.
  5. skinparam ohne Wirkung → Reihenfolge prüfen: eigene skinparam-Zeilen gehören hinter Includes und Themes.

Die vollständige Fehlersammlung (englisch): PlantUML Troubleshooting.

Vorlagen und Vertiefung

Zuletzt aktualisiert: August 2026