Eine gut gestaltete Use-Case-Erz\u00e4hlung wandelt abstrakte Systemziele in handlungsorientierte, schrittweise Spezifikationen um. Durch die Dokumentation pr\u00e4ziser Interaktionen, Entscheidungspunkte und Fehlerbehandlungswege schaffen Teams eine eindeutige Quelle der Wahrheit, die Produktbesitzer, Entwickler, Tester und Business Analysten ausrichtet. Diese Fallstudie untersucht die Struktur effektiver Use-Case-Dokumentation und zeigt, wie strukturierte Erz\u00e4hlungen, standardisierte Vorlagen und erg\u00e4nzende visuelle Modelle zusammenwirken, um eindeutige funktionale Spezifikationen zu erzeugen. Anhand eines praktischen Szenarios zur Geldabhebung am ATM werden wir untersuchen, wie Gesch\u00e4ftslogik erfasst, Abweichungen verwaltet und die R\u00fcckverfolgbarkeit von der Idee bis zur Umsetzung gew\u00e4hrleistet wird.<\/p>\n
![\"Mastering](\"https:\/\/blog.visual-paradigm.com\/wp-content\/uploads\/2026\/05\/img_6a0ff6c455a21.png\")
<\/p>\n
\n
1. Grundlegende Konzepte<\/h2>\n
Bevor detaillierte Spezifikationen verfasst werden, ist es unerl\u00e4sslich, die zentralen Komponenten zu verstehen, die einer Use-Case-Struktur ihre Stabilit\u00e4t verleihen:<\/p>\n
- \n
- \n
Akteur:<\/strong>\u00a0Jede Entit\u00e4t (Mensch, externes System oder Hardware), die mit dem System interagiert, um ein Ziel zu erreichen.<\/p>\n
- \n
- \n
Prim\u00e4rer Akteur:<\/em>\u00a0Initiiert die Interaktion, um ein bestimmtes Ziel zu erreichen (z.\u202fB. ein Bankkunde).<\/p>\n<\/li>\n
- \n
Sekund\u00e4rer\/Unterst\u00fctzender Akteur:<\/em>\u00a0Stellt w\u00e4hrend der Ausf\u00fchrung notwendige Dienstleistungen oder Daten f\u00fcr das System bereit (z.\u202fB. eine Core-Banking-API oder Zahlungsgateway).<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Voraussetzungen:<\/strong>\u00a0Der Zustand des Systems oder der Umgebung, der bereits vor Beginn des Use Cases bestehen muss. Diese werden als wahr vorausgesetzt und innerhalb des Ablaufs nicht \u00fcberpr\u00fcft.<\/p>\n<\/li>\n
- \n
Ausl\u00f6ser:<\/strong>\u00a0Das spezifische Ereignis oder die Benutzeraktion, die den Use Case ausl\u00f6st.<\/p>\n<\/li>\n
- \n
Haupterfolgsszenario (Grundablauf):<\/strong>\u00a0Die optimale, fehlerfreie Abfolge von Schritten, die zum erfolgreichen Abschluss des Ziels des Akteurs f\u00fchrt. H\u00e4ufig als \u201ehappy path\u201c bezeichnet.<\/p>\n<\/li>\n
- \n
Erweiterungen \/ Alternative und Ausnahmefl\u00fcsse:<\/strong>\u00a0Dokumentierte Abweichungen vom Hauptablauf.<\/p>\n
- \n
- \n
Alternative Fl\u00fcsse:<\/em>\u00a0Verschiedene g\u00fcltige Wege, um dasselbe Ziel zu erreichen (z.\u202fB. Verwendung einer anderen Zahlungsmethode).<\/p>\n<\/li>\n
- \n
Ausnahmefl\u00fcsse:<\/em>\u00a0Fehlerzust\u00e4nde, Validierungsfehler oder Systembeschr\u00e4nkungen, die das Ziel unterbrechen und eine spezifische Behandlung erfordern.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Nachbedingungen:<\/strong>\u00a0Der garantierte Zustand des Systems, der Daten oder der Umgebung nach erfolgreichem Abschluss des Use Cases.<\/p>\n<\/li>\n<\/ul>\n
\n2. Das Standard-Spezifikations-Template<\/h2>\n
Konsistenz ist entscheidend f\u00fcr die Wartbarkeit. Das folgende Template bietet eine weit verbreitete Struktur, die Vollst\u00e4ndigkeit gew\u00e4hrleistet, ohne unn\u00f6tige Ausf\u00fchrlichkeit zu erzeugen:<\/p>\n
\n\n
\n \nFeld<\/th>\n Beschreibung<\/th>\n<\/tr>\n<\/thead>\n \n Use-Case-ID & Name<\/strong><\/td>\n Eine eindeutige Kennung und ein Verb-Substantiv-Titel (z.\u202fB.\u00a0 UC-201: Bargeld abheben<\/code>).<\/td>\n<\/tr>\n\n Aktionspartner<\/strong><\/td>\n Listet alle prim\u00e4ren und sekund\u00e4ren Teilnehmer auf.<\/td>\n<\/tr>\n \n Beschreibung<\/strong><\/td>\n Eine pr\u00e4zise Zusammenfassung des Zwecks und des gesch\u00e4ftlichen Nutzens des Use-Cases.<\/td>\n<\/tr>\n \n Voraussetzungen<\/strong><\/td>\n System- oder Umgebungsbedingungen, die vor der Initiierung erforderlich sind.<\/td>\n<\/tr>\n \n Ausl\u00f6ser<\/strong><\/td>\n Das genaue Ereignis, das die Interaktion ausl\u00f6st.<\/td>\n<\/tr>\n \n Haupterfolgsszenario<\/strong><\/td>\n Nummerierte, sequenzielle Schritte, die den standardm\u00e4\u00dfigen erfolgreichen Ablauf detaillieren.<\/td>\n<\/tr>\n \n Erweiterungen \/ Ausnahmen<\/strong><\/td>\n Verzweigte Abl\u00e4ufe, die spezifischen Hauptszenario-Schritten zugeordnet sind (z.\u202fB.\u00a0 3a<\/code>,\u00a08b<\/code>).<\/td>\n<\/tr>\n\n Nachbedingungen<\/strong><\/td>\n Der endg\u00fcltige Systemzustand nach erfolgreicher Abschluss.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n3. Fallstudie: UC-201 Bargeld abheben<\/h2>\n
Die folgende Spezifikation zeigt, wie die Vorlage und die grundlegenden Konzepte auf eine realweltbasierte Bankenszene angewendet werden.<\/p>\n
Use-Case-ID & Name:<\/strong>\u00a0
UC-201 - Bargeld abheben<\/code>
\nPrim\u00e4rer Aktionspartner:<\/strong>\u00a0Bankkunde
\nSekund\u00e4rer Akteur:<\/strong>\u00a0Kernbankensystem \/ ATM-Netzwerk
\nBeschreibung:<\/strong>\u00a0Beschreibt, wie ein authentifizierter Bankkunde Bargeld von seinem Giro- oder Sparbuchkonto \u00fcber einen Geldautomaten (ATM) abhebt.
\nVoraussetzungen:<\/strong>\u00a0Der ATM unterh\u00e4lt eine aktive Netzwerkverbindung und verf\u00fcgt \u00fcber ausreichend physisches Geld.
\nAusl\u00f6ser:<\/strong>\u00a0Der Kunde steckt seine Bankkarte in den Kartenleser des ATM.<\/p>\nHaupterfolgsszenario (Grundablauf)<\/h3>\n
- \n
- \n
Das System liest die Bankkarte und fordert eine pers\u00f6nliche Identifikationsnummer (PIN) an.<\/p>\n<\/li>\n
- \n
Der Kunde gibt seine PIN ein.<\/p>\n<\/li>\n
- \n
Das System \u00fcberpr\u00fcft die PIN mit dem Kernbankensystem.<\/p>\n<\/li>\n
- \n
Das System zeigt verf\u00fcgbare Transaktionsm\u00f6glichkeiten an.<\/p>\n<\/li>\n
- \n
Der Kunde w\u00e4hlt \u201eBargeld abheben\u201c aus.<\/p>\n<\/li>\n
- \n
Das System fordert den Kontotyp (Giro\/Spar) und den Abhebembetrag an.<\/p>\n<\/li>\n
- \n
Der Kunde w\u00e4hlt das Zielkonto aus und gibt einen verf\u00fcgbaren Betrag ein.<\/p>\n<\/li>\n
- \n
Das System \u00fcberpr\u00fcft mit dem Kernbankensystem, ob ausreichend Mittel vorhanden sind.<\/p>\n<\/li>\n
- \n
Das System belastet das Konto und befiehlt dem Bargeldausgabemechanismus, den angeforderten Betrag auszugeben.<\/p>\n<\/li>\n
- \n
Das System gibt Bargeld aus, wirft die Karte aus und druckt eine Transaktionsbest\u00e4tigung aus.<\/p>\n<\/li>\n
- \n
Der Kunde nimmt Bargeld, Karte und Best\u00e4tigung entgegen.<\/p>\n<\/li>\n<\/ol>\n
Erweiterungen (Alternative und Ausnahmefl\u00fcsse)<\/h3>\n
- \n
- \n
3a. Ung\u00fcltige PIN:<\/strong><\/p>\n
- \n
- \n
Das System informiert den Kunden \u00fcber die falsche PIN und bittet um erneute Eingabe.<\/p>\n<\/li>\n
- \n
Der Kunde gibt eine neue PIN ein.<\/p>\n<\/li>\n
- \n
Fortsetzung ab Schritt 3.<\/em><\/p>\n<\/li>\n
- \n
Ausnahme:<\/em>\u00a0Wenn der Kunde dreimal hintereinander eine ung\u00fcltige PIN eingibt, beh\u00e4lt das System die Karte und beendet die Sitzung.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n
- \n
8a. Unzureichende Mittel:<\/strong><\/p>\n
- \n
- \n
Das System zeigt einen \u201eUnzureichende Mittel\u201c-Fehler an und bittet den Kunden, einen geringeren Betrag einzugeben oder abzubrechen.<\/p>\n<\/li>\n
- \n
Der Kunde w\u00e4hlt \u201eAbbrechen\u201c aus.<\/p>\n<\/li>\n
- \n
Das System gibt die Karte aus und beendet die Sitzung.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n
Nachbedingungen<\/h3>\n
Die Transaktion wird sicher protokolliert, das Kontoguthaben wird genau aktualisiert, das physische Bargeldvolumen des ATM wird entsprechend reduziert, und das Terminal setzt sich auf den ruhenden Willkommensbildschirm zur\u00fcck.<\/p>\n
\n4. Best Practices f\u00fcr die Erstellung<\/h2>\n
Um sicherzustellen, dass Use-Case-Beschreibungen handlungsorientiert, skalierbar und f\u00fcr Entwickler geeignet bleiben, halten Sie sich an diese etablierten Richtlinien:<\/p>\n
- \n
- \n
Behalten Sie eine Black-Box-Perspektive bei:<\/strong>\u00a0Dokumentieren\u00a0was<\/em>\u00a0das System vom Nutzer aus tut, nicht\u00a0wie<\/em>\u00a0es intern erreicht. Vermeiden Sie Verweise auf Datenbank-Schemata, API-Endpunkte oder UI-Pixel-Platzierungen.<\/p>\n<\/li>\n
- \n
Verwenden Sie aktive Stimme und klare Syntax:<\/strong>\u00a0Verwenden Sie direkte Subjekt-Verb-Konstruktionen, um Mehrdeutigkeiten zu vermeiden.<\/p>\n
- \n
- \n
Vermeiden Sie:<\/em>\u00a0\u201eDie PIN wird vom System bewertet.\u201c<\/p>\n<\/li>\n
- \n
Bevorzugt:<\/em>\u00a0\u201eDas System validiert die PIN.\u201c<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Erweitern Sie explizit:<\/strong>\u00a0Koppeln Sie alternative und Ausnahmefl\u00fcsse immer direkt an die Schrittnummer, von der sie abweichen (z.\u202fB.\u00a0
5a<\/code>\u00a0geht von Schritt 5 aus). Dies gew\u00e4hrleistet die R\u00fcckverfolgbarkeit und vereinfacht die Erstellung von Testf\u00e4llen.<\/p>\n<\/li>\n- \n
Ziel: Elementare Gesch\u00e4ftsvorg\u00e4nge (EBP):<\/strong>\u00a0Jeder Use Case sollte eine vollst\u00e4ndige, wertvolle Aufgabe darstellen, die von einem Akteur im Rahmen eines einzelnen Gesch\u00e4ftsvorfalles ausgef\u00fchrt wird. Vermeiden Sie die Dokumentation feinster UI-Klicks oder systeminterner Mikro-Interaktionen.<\/p>\n<\/li>\n
- \n
Trennen Sie Vorbedingungen von Ausl\u00f6sern:<\/strong>\u00a0Eine Vorbedingung ist ein statischer Zustand (z.\u202fB. \u201eDer Benutzer hat eine aktive Sitzung\u201c), w\u00e4hrend ein Ausl\u00f6ser eine dynamische Aktion ist (z.\u202fB. \u201eDer Benutzer klickt auf \u201aBestellung absenden\u2018\u201c). Die Trennung verhindert logische \u00dcberlappungen und Zweifel bez\u00fcglich des Umfangs.<\/p>\n<\/li>\n<\/ol>\n
\n5. Visualisierung von Systemwechselwirkungen<\/h2>\n
W\u00e4hrend textuelle Erz\u00e4hlungen Tiefe bieten, liefern visuelle Modelle sofortige strukturelle Klarheit. Die Integration von Use-Case-Diagrammen und Sequenzdiagrammen neben Spezifikationen stellt sicher, dass alle Stakeholder ein einheitliches Verst\u00e4ndnis der Systemgrenzen und der zeitlichen Ablaufstruktur teilen.<\/p>\n
A. Use-Case-Beziehungsdiagramm<\/h3>\n
Dieses Diagramm zeigt die Interaktionen zwischen Akteuren, definiert die Systemgrenzen und veranschaulicht Einbeziehungszusammenh\u00e4nge zwischen wiederverwendbaren Verhaltensweisen.<\/p>\n
![\"\"](\"https:\/\/blog.visual-paradigm.com\/wp-content\/uploads\/2026\/05\/img_6a0ff6731cd78.png\")
<\/p>\n\n\nPlantUML<\/span>
\n
\n - \n
- \n
- \n
- \n
- \n
- \n
- \n
- \n
- \n