Seminar Archi Automatisierung mit jArchi

Modellabfragen, Qualitätssicherung, Massenänderungen und Ausgaben werden mit jArchi reproduzierbar automatisiert.

Das Seminar führt von der sicheren Einrichtung der Skriptumgebung über das Lesen und Filtern des Modells bis zu kontrollierten Schreiboperationen. Protokollierung, Testmodelle, CSV-Verarbeitung, automatisierte Berichte und Rücksetzstrategien stehen im Mittelpunkt.

Inhaltsverzeichnis

1. Lernziele
2. Zielgruppe
3. Voraussetzungen
4. Kapitel 1: Plug-in-Management und Kompatibilitätskontrolle
5. Kapitel 2: jArchi-Grundlagen und Skriptausführung
6. Kapitel 3: Abfragen und Modellanalysen mit jArchi
7. Kapitel 4: Massenänderungen und Qualitätssicherung mit jArchi
8. Kapitel 5: Automatisierte Ausgaben und wiederholbare Verarbeitung
9. Kapitel 6: CSV-Import und CSV-Export
10. Kapitel 7: Validator und systematische Qualitätsprüfung
11. Kapitel 8: Betriebssicherheit, Sicherung und Wiederanlauf
12. Kapitel 9: Architekturdokumentation und Ausgabepaket
13. Praxisübungen

Lernziele

• Modellabfragen, Qualitätssicherung, Massenänderungen und Ausgaben werden mit jArchi reproduzierbar automatisiert.
• Die behandelten Funktionen und Modellierungsmuster werden in einem zusammenhängenden Übungsmodell angewendet.
• Qualitäts-, Dokumentations- und Wiederholbarkeitsanforderungen werden in jedem Arbeitsschritt berücksichtigt.

Zielgruppe

Archi-Power-User, Enterprise Architects mit Automatisierungsbedarf, Entwickler, Tool-Verantwortliche und Qualitätssicherer.

Voraussetzungen

Sichere Bedienung von Archi sowie Grundkenntnisse in JavaScript oder einer vergleichbaren Skriptsprache werden vorausgesetzt.

Seminarinhalte

Kapitel 1: Plug-in-Management und Kompatibilitätskontrolle

Kapitelübersicht: Erweiterungen werden kontrolliert installiert, aktualisiert und entfernt, ohne den stabilen Archi-Betrieb zu gefährden.

Inhaltsverzeichnis des Kapitels

1. Geschäftlichen Nutzen
2. Plug-in über den Plug-in-Manager in einer Testinstallation einspielen und erforderlichen Neu...
3. Funktion
4. Freigabe

Schritt-für-Schritt-Anleitung

1. Schritt 1: Geschäftlichen Nutzen, Herkunft, Lizenzrahmen, Archi-Kompatibilität und Betriebsrisiko einer Erweiterung bewerten.
2. Schritt 2: Plug-in über den Plug-in-Manager in einer Testinstallation einspielen und erforderlichen Neustart durchführen.
3. Schritt 3: Funktion, Modellkompatibilität, Einstellungen, Speicherorte und Verhalten nach Programmaktualisierung testen.
4. Schritt 4: Freigabe, Version, Verantwortlichkeit, Rückbau und Abhängigkeiten in einem Erweiterungsverzeichnis dokumentieren.

Kapitel 2: jArchi-Grundlagen und Skriptausführung

Kapitelübersicht: Die Skriptumgebung wird eingerichtet und für sichere, nachvollziehbare Automatisierungen im Modell genutzt.

Inhaltsverzeichnis des Kapitels

1. Plug-in-Verfügbarkeit
2. Ein erstes Skript ausführen
3. Elemente
4. Fehlerbehandlung

Schritt-für-Schritt-Anleitung

1. Schritt 1: Plug-in-Verfügbarkeit, Skriptordner, Berechtigungen und eine getrennte Testkopie des Modells vorbereiten.
2. Schritt 2: Ein erstes Skript ausführen, Konsolenausgabe lesen und Zugriff auf aktuelles Modell sowie Auswahl nachvollziehen.
3. Schritt 3: Elemente, Beziehungen, Sichten und Eigenschaften per API lesen und in einer strukturierten Ausgabe zusammenfassen.
4. Schritt 4: Fehlerbehandlung, Protokollierung und Schutz vor unbeabsichtigten Massenänderungen als Grundgerüst einbauen.

Kapitel 3: Abfragen und Modellanalysen mit jArchi

Kapitelübersicht: Skripte durchsuchen Modelle nach fachlichen und technischen Kriterien und liefern reproduzierbare Analysen.

Inhaltsverzeichnis des Kapitels

1. Eine fachliche Fragestellung in Filterkriterien für Typ
2. Passende Konzepte selektieren
3. Beziehungspfade und Abhängigkeiten traversieren
4. Abfrageergebnis mit einer manuellen Stichprobe verifizieren und als wiederverwendbaren Analy...

Schritt-für-Schritt-Anleitung

1. Schritt 1: Eine fachliche Fragestellung in Filterkriterien für Typ, Name, Eigenschaft, Beziehung und Sichtverwendung übersetzen.
2. Schritt 2: Passende Konzepte selektieren, Ergebnisse sortieren und mit eindeutigen Kennungen sowie Kontextinformationen ausgeben.
3. Schritt 3: Beziehungspfade und Abhängigkeiten traversieren, Zyklen oder isolierte Konzepte erkennen und markieren.
4. Schritt 4: Abfrageergebnis mit einer manuellen Stichprobe verifizieren und als wiederverwendbaren Analysebaustein dokumentieren.

Kapitel 4: Massenänderungen und Qualitätssicherung mit jArchi

Kapitelübersicht: Kontrollierte Skripte standardisieren Eigenschaften, Benennungen und Modellstrukturen in größeren Beständen.

Inhaltsverzeichnis des Kapitels

1. Änderungsregel
2. Zunächst einen reinen Prüfmodus implementieren
3. Änderungen auf einer Modellkopie ausführen und Anzahl
4. Sicherung

Schritt-für-Schritt-Anleitung

1. Schritt 1: Änderungsregel, betroffene Objektmenge, Ausschlüsse und erwarteten Zielzustand vor der Ausführung festlegen.
2. Schritt 2: Zunächst einen reinen Prüfmodus implementieren, der geplante Änderungen ohne Schreibzugriff protokolliert.
3. Schritt 3: Änderungen auf einer Modellkopie ausführen und Anzahl, Inhalt sowie Nebenwirkungen gegen das Protokoll abgleichen.
4. Schritt 4: Sicherung, Rücksetzstrategie und Freigabe dokumentieren, bevor das Skript auf den Arbeitsbestand angewendet wird.

Kapitel 5: Automatisierte Ausgaben und wiederholbare Verarbeitung

Kapitelübersicht: Skripte erzeugen strukturierte Ausgaben und verbinden Modellpflege, Analyse und Berichterstellung zu einem reproduzierbaren Ablauf.

Inhaltsverzeichnis des Kapitels

1. Ausgabeformat
2. Analyse- und Transformationsschritte in kleine Funktionen zerlegen und über klar definierte...
3. Tabellarische oder textuelle Ergebnisse erzeugen und Sonderzeichen
4. Den gesamten Ablauf mit Testmodell

Schritt-für-Schritt-Anleitung

1. Schritt 1: Ausgabeformat, Dateinamensschema, Ablagepfad und benötigte Modellinformationen festlegen.
2. Schritt 2: Analyse- und Transformationsschritte in kleine Funktionen zerlegen und über klar definierte Parameter steuern.
3. Schritt 3: Tabellarische oder textuelle Ergebnisse erzeugen und Sonderzeichen, leere Werte sowie große Datenmengen behandeln.
4. Schritt 4: Den gesamten Ablauf mit Testmodell, Sollwerten und Ausführungsprotokoll als wiederholbaren Prozess absichern.

Kapitel 6: 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 7: Validator und systematische Qualitätsprüfung

Kapitelübersicht: Automatische Prüfungen und fachliche Reviews werden zu einem belastbaren Qualitätssicherungsverfahren verbunden.

Inhaltsverzeichnis des Kapitels

1. Prüfumfang
2. Den Validator ausführen
3. Fehler schrittweise beheben
4. Eine Review-Checkliste für Benennung

Schritt-für-Schritt-Anleitung

1. Schritt 1: Prüfumfang, Qualitätskriterien und zulässige Ausnahmen für Modell, Sichten, Beziehungen und Eigenschaften festlegen.
2. Schritt 2: Den Validator ausführen, Meldungen nach Ursache und Auswirkung klassifizieren und Fehlalarme von echten Defekten trennen.
3. Schritt 3: Fehler schrittweise beheben, danach erneut validieren und die Veränderung der Befundlage nachvollziehen.
4. Schritt 4: Eine Review-Checkliste für Benennung, Semantik, Lesbarkeit, Vollständigkeit und Freigabestatus anwenden.

Kapitel 8: Betriebssicherheit, Sicherung und Wiederanlauf

Kapitelübersicht: Modelldateien, Erweiterungen und Arbeitsstände werden gegen Verlust, Fehlbedienung und unkontrollierte Veränderung abgesichert.

Inhaltsverzeichnis des Kapitels

1. Speicherorte
2. Manuelle und automatisierte Sicherungen für lokale Dateien beziehungsweise Repository-Arbeit...
3. Wiederherstellung einer Modellkopie testen und Integrität
4. Störungsablauf

Schritt-für-Schritt-Anleitung

1. Schritt 1: Speicherorte, Zugriffsrechte, Schutzbedarf, Sicherungsintervall und Aufbewahrungsdauer festlegen.
2. Schritt 2: Manuelle und automatisierte Sicherungen für lokale Dateien beziehungsweise Repository-Arbeitsstände einrichten.
3. Schritt 3: Wiederherstellung einer Modellkopie testen und Integrität, Dateiversion sowie letzte freigegebene Änderung kontrollieren.
4. Schritt 4: Störungsablauf, Verantwortlichkeiten und Nachweis der Wiederanlaufprobe kompakt dokumentieren.

Kapitel 9: 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.

Praxisübungen

• Ein Skript zur Inventarisierung von Elementen, Beziehungen und Eigenschaften erstellen.
• Eine prüfbare Benennungs- und Eigenschaftskorrektur mit Vorschau und Protokoll umsetzen.
• Eine wiederholbare Analyse mit strukturierter Ausgabe und Fehlerbehandlung entwickeln.

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