Seminar Archi Berichte, Exporte und Dokumentation

Architekturmodelle werden in kontrollierte Berichte, Austauschdateien und entscheidungsfähige Dokumentationspakete überführt.

Behandelt werden Eigenschaften und Beschreibungen, HTML- und strukturierte Berichte, CSV-Ausgaben, Austauschdateien, Qualitätskontrollen sowie Freigabe- und Ablagekonventionen. Die Ausgabe wird konsequent aus dem Modellstand abgeleitet.

Inhaltsverzeichnis

1. Lernziele
2. Zielgruppe
3. Voraussetzungen
4. Kapitel 1: Eigenschaften, Dokumentation und Spezialisierungen
5. Kapitel 2: HTML- und strukturierte Berichte
6. Kapitel 3: CSV-Import und CSV-Export
7. Kapitel 4: Austauschformat und Modellmigration
8. Kapitel 5: Architekturdokumentation und Ausgabepaket
9. Kapitel 6: Entscheidungsreife Analysen und Managementausgaben
10. Kapitel 7: Modellreview, Audit und Freigabe
11. Praxisübungen

Lernziele

• Architekturmodelle werden in kontrollierte Berichte, Austauschdateien und entscheidungsfähige Dokumentationspakete überführt.
• Die behandelten Funktionen und Modellierungsmuster werden in einem zusammenhängenden Übungsmodell angewendet.
• Qualitäts-, Dokumentations- und Wiederholbarkeitsanforderungen werden in jedem Arbeitsschritt berücksichtigt.

Zielgruppe

Enterprise Architects, Dokumentationsverantwortliche, Modellmanager, Auditoren, Projektleitungen und Empfänger von Architekturberichten.

Voraussetzungen

Grundkenntnisse in Archi und ein kleines Übungsmodell mit mehreren Sichten werden vorausgesetzt.

Seminarinhalte

Kapitel 1: Eigenschaften, Dokumentation und Spezialisierungen

Kapitelübersicht: Strukturierte Zusatzinformationen werden einheitlich gepflegt, damit Modelle filterbar, auswertbar und dokumentierbar werden.

Inhaltsverzeichnis des Kapitels

1. Ein kontrolliertes Eigenschaftsschema mit Namen
2. Beschreibungen und Eigenschaften an mehreren ausgewählten Konzepten konsistent erfassen und...
3. Spezialisierungen nur für fachlich stabile Untertypen anlegen und mit klaren Benennungs- und...
4. Pflichtangaben

Schritt-für-Schritt-Anleitung

1. Schritt 1: Ein kontrolliertes Eigenschaftsschema mit Namen, Datentypen, erlaubten Werten und Verantwortlichkeiten definieren.
2. Schritt 2: Beschreibungen und Eigenschaften an mehreren ausgewählten Konzepten konsistent erfassen und aktualisieren.
3. Schritt 3: Spezialisierungen nur für fachlich stabile Untertypen anlegen und mit klaren Benennungs- und Symbolregeln versehen.
4. Schritt 4: Pflichtangaben, uneinheitliche Werte und unkontrollierte Spezialisierungen anhand einer Prüfliste bereinigen.

Kapitel 2: HTML- und strukturierte Berichte

Kapitelübersicht: Modelldaten werden in prüfbare Berichte überführt, die Navigation, Dokumentation und Entscheidungsunterstützung verbinden.

Inhaltsverzeichnis des Kapitels

1. Zielgruppe
2. HTML-Bericht beziehungsweise strukturierte Berichtsausgabe konfigurieren und in ein separate...
3. Navigation
4. Berichtsstand

Schritt-für-Schritt-Anleitung

1. Schritt 1: Zielgruppe, Berichtszweck, benötigte Sichten und gewünschte Detailtiefe vor der Ausgabe festlegen.
2. Schritt 2: HTML-Bericht beziehungsweise strukturierte Berichtsausgabe konfigurieren und in ein separates Zielverzeichnis erzeugen.
3. Schritt 3: Navigation, Bilder, Beschreibungen, Eigenschaften und Querverweise auf Vollständigkeit und Lesbarkeit prüfen.
4. Schritt 4: Berichtsstand, Modellstand, Freigabestatus und Ablagekonvention so dokumentieren, dass die Ausgabe reproduzierbar bleibt.

Kapitel 3: CSV-Import und CSV-Export

Kapitelübersicht: Tabellarische Daten werden kontrolliert zwischen Archi und externen Arbeitsabläufen ausgetauscht, ohne Modellintegrität zu verlieren.

Inhaltsverzeichnis des Kapitels

1. Spalten
2. Einen kleinen
3. Daten in einer Kopie des Zielmodells importieren
4. Fehlerhafte Zeilen korrigieren

Schritt-für-Schritt-Anleitung

1. Schritt 1: Spalten, Kennungen, Zeichenkodierung, Trennzeichen und erlaubte Werte für Elemente, Beziehungen und Eigenschaften definieren.
2. Schritt 2: Einen kleinen, geprüften Musterbestand exportieren und daraus eine belastbare Importvorlage ableiten.
3. Schritt 3: Daten in einer Kopie des Zielmodells importieren, Protokolle auswerten und Identitäten sowie Beziehungen kontrollieren.
4. Schritt 4: Fehlerhafte Zeilen korrigieren, den Import wiederholen und einen Abgleich zwischen Quelltabelle und Modell durchführen.

Kapitel 4: Austauschformat und Modellmigration

Kapitelübersicht: Modelle werden über standardisierte Austauschdateien zwischen Werkzeugen oder Versionen übertragen und anschließend fachlich verifiziert.

Inhaltsverzeichnis des Kapitels

1. Quell- und Zielumfang
2. Eine Austauschdatei aus einem repräsentativen Teilmodell erzeugen und separat versioniert ab...
3. Die Datei in ein leeres Prüfmodell importieren und Struktur
4. Abweichungen dokumentieren

Schritt-für-Schritt-Anleitung

1. Schritt 1: Quell- und Zielumfang, unterstützte Konzepte, Sichten, Eigenschaften, Spezialisierungen und mögliche Verluste erfassen.
2. Schritt 2: Eine Austauschdatei aus einem repräsentativen Teilmodell erzeugen und separat versioniert ablegen.
3. Schritt 3: Die Datei in ein leeres Prüfmodell importieren und Struktur, Beziehungen, Diagramme sowie Metadaten vergleichen.
4. Schritt 4: Abweichungen dokumentieren, Korrekturregeln festlegen und erst danach die vollständige Migration ausführen.

Kapitel 5: Architekturdokumentation und Ausgabepaket

Kapitelübersicht: Modelle, Beschreibungen, Sichten und Berichte werden zu einer prüfbaren Dokumentation mit eindeutigen Ständen zusammengeführt.

Inhaltsverzeichnis des Kapitels

1. Dokumentationszweck
2. Beschreibungen
3. Ein Ausgabepaket aus freigegebenen Sichten
4. Vollständigkeit

Schritt-für-Schritt-Anleitung

1. Schritt 1: Dokumentationszweck, Empfänger, Pflichtbestandteile, Freigabeweg und Ablagekonvention festlegen.
2. Schritt 2: Beschreibungen, Eigenschaften, Legenden, Titel und Sichtkommentare auf Konsistenz und Verständlichkeit prüfen.
3. Schritt 3: Ein Ausgabepaket aus freigegebenen Sichten, Tabellen und Berichten mit eindeutiger Versionskennzeichnung erzeugen.
4. Schritt 4: Vollständigkeit, Querverweise, Lesbarkeit und Reproduzierbarkeit anhand einer Abnahmecheckliste kontrollieren.

Kapitel 6: Entscheidungsreife Analysen und Managementausgaben

Kapitelübersicht: Komplexe Modellinformationen werden zu nachvollziehbaren Aussagen, Optionen und Entscheidungsvorlagen verdichtet.

Inhaltsverzeichnis des Kapitels

1. Entscheidungsfrage
2. Relevante Modellpfade
3. Optionen anhand gleicher Kriterien gegenüberstellen und Auswirkungen sowie Unsicherheiten tr...
4. Eine kompakte Ausgabe mit Kernaussage

Schritt-für-Schritt-Anleitung

1. Schritt 1: Entscheidungsfrage, Bewertungskriterien, Handlungsoptionen und erforderliche Nachweise präzisieren.
2. Schritt 2: Relevante Modellpfade, Kennzeichnungen, Eigenschaften und Sichten auswählen und auf Widersprüche prüfen.
3. Schritt 3: Optionen anhand gleicher Kriterien gegenüberstellen und Auswirkungen sowie Unsicherheiten transparent machen.
4. Schritt 4: Eine kompakte Ausgabe mit Kernaussage, Begründung, betroffenen Architekturbereichen und nächsten Entscheidungen erstellen.

Kapitel 7: Modellreview, Audit und Freigabe

Kapitelübersicht: Ein strukturiertes Review trennt Sprachrichtigkeit, fachliche Richtigkeit, Lesbarkeit und Governance-Konformität.

Inhaltsverzeichnis des Kapitels

1. Reviewumfang
2. Automatische Prüfungen und manuelle Stichproben vorbereiten und Befunde mit eindeutiger Fund...
3. Befunde nach Kritikalität
4. Nachprüfung durchführen und Freigabe

Schritt-für-Schritt-Anleitung

1. Schritt 1: Reviewumfang, Rollen, Kriterien, Evidenz und zulässige Abweichungen vor der Sitzung festlegen.
2. Schritt 2: Automatische Prüfungen und manuelle Stichproben vorbereiten und Befunde mit eindeutiger Fundstelle erfassen.
3. Schritt 3: Befunde nach Kritikalität, Verantwortlichkeit und Frist bewerten und Korrekturen nachvollziehbar nachhalten.
4. Schritt 4: Nachprüfung durchführen und Freigabe, bedingte Freigabe oder Rückgabe mit Begründung dokumentieren.

Praxisübungen

• Ein Modell für eine vollständige Berichtsausgabe aufbereiten.
• CSV- und Austauschdateien erzeugen und gegen den Modellbestand prüfen.
• Ein versioniertes Dokumentationspaket für Review und Entscheidung zusammenstellen.

Alle Übungen werden an einem konsistenten Arbeitsmodell ausgeführt. Zwischenergebnisse werden geprüft, korrigiert und in einem nachvollziehbaren Modellstand gespeichert.