Teamcamp-Resultat #1: INTERLIS-Modelldokumentationen automatisiert aus ili-Dateien generieren

Unsere treuen Leserinnen und Leser erinnern sich: Am 20. Juni haben wir über das erste GeoWerkstatt-Teamcamp und unsere dortigen Projekte berichtet. Höchste Zeit also für eine kurze Vorstellung der Resultate – den Anfang macht in dieser Folge der Proof of Concept zur Automatisierung von INTERLIS-Modelldokumentationen.

INTERLIS-Veteranen wissen: Auch ein nach allen Regeln der Kunst formuliertes Modell macht keine Freude, wenn es nicht sauber dokumentiert ist. Aus diesem Grund erstellen Autor:innen von Fachmodellen bei Bund, Kantonen und Verbänden umfangreiche Modelldokumentationen und nehmen dafür erhebliche Arbeitsaufwände in Kauf. Die Dokumentation eines einzelnen Fachmodells kann mit UML-Diagrammen, Objektkatalogen und ergänzenden Informationen durchaus dutzende Seiten umfassen und muss bei jeder Weiterentwicklung des Modells sorgfältig überarbeitet werden. Automatisierungsansätze für das Modellieren gibt es zwar schon lange (z.B. den UML/INTERLIS-Editor), ebenso wie Richtlinien für die Erarbeitung von Modelldokumentationen. Dennoch erfolgt die Umsetzung bis heute grösstenteils manuell.

Ein Blick auf aktuelle Technologien genügt, um zu erkennen, dass das Verfassen und Pflegen von Modelldokumentationen prinzipiell kaum mehr mit mühseliger Handarbeit verbunden sein müsste. Ganz im Sinne von documentation as code haben wir deshalb einen neuen Lösungsansatz entwickelt, der mit Hilfe von Markdown und dem freien Open Source-Tool Mermaid sowohl eine einheitliche Textformatierung und -strukturierung für Fliesstext, Überschriften und Objektkatalog-Tabellen als auch die das Modell beschreibenden UML-Diagramme in Echtzeit direkt aus der ili-Datei generiert. Zusätzliche Eigenschaften, die nicht explizit aus dem INTERLIS-Modell hervorgehen (z.B. die Anzeigefarbe einer Klasse im UML-Diagramm, können dabei mittels Metaattributen umgesetzt werden.

ili2doc

Das Resultat des Hackathons ist vielversprechend, und dennoch möchten wir vor dem Launch eines Produkts die Ergebnisse der Standardisierungsbemühungen in diesem Bereich berücksichtigen. Wir werden das Thema eng begleiten und freuen uns schon jetzt, dass mit diesem Ansatz, kombiniert mit dem Syntax-Highlighting-Plugin für Visual Studio Code die Grundlage für eine mächtige integrierte Entwicklungs- und Editierumgebung für INTERLIS-Modelle geschaffen ist.

Zurück
Zurück

STAC-Implementierungen in Geodateninfrastrukturen

Weiter
Weiter

Kreativ-Auszeit à la geowerkstatt: Das Teamcamp 2024