ÖREB-Kataster: Handbuch

Code-Repository:
https://github.com/sogis/oereb-db

Docker-Image:
https://hub.docker.com/r/sogis/oereb-db

In der ÖREB-Datenbank werden in zwei Schemen (live und stage) jeweils sämtliche für den Betrieb des ÖREB-Katasters notwendigen Daten gespeichert. Dazu gehören die eigentlichen ÖREB-Daten (inkl. kantonaler Gesetze und Verordnungen und Bundesgesetze und -verordnungen) sowie die amtliche Vermessung (im Bundesmodell), das amtliche Ortschaftsverzeichnis und die Konfigurationsdaten.

Die Datenstruktur entspricht einem mit ili2pg angelegten Schema und Tabellen und sind entsprechend normalisiert. Für die Bereitstellung via WMS werden zusätzlich denormalisierte, «flachgewalzte» Tabellen eingesetzt. Dazu wurde ein sehr einfache Datenmodell (SO_AGI_OeREB_WMS_20220222) geschrieben. Die Dokumente, welche in der Tabelle als JSON-Array gespeichert werden, wurden nicht als Strukturen ausmodelliert, da dies in der Datebank zu JSON-Spalten führen würde, die wiederum mittels View zu Text gecastet werden müssen, weil QGIS-Server nicht damit umgehen kann. Somit wird das JSON-Array als einfacher Text modelliert und gespeichert.

Das stage-Schema dient der Validierung der Daten durch die zuständigen Stellen.

Die Kernfunktionalität des Respositories ist das (aus den Datenmodellen) automatische Herstellen der DDL-Queries zum Aufsetzen der Datenbank. Dieser Prozess wird mit einem einem jBang-Java-Skript durchgeführt.

Für Test- und Entwicklungszwecken wird mit Github Action ein Docker-Image der ÖREB-Datenbank erzeugt.

Im produktiven Betrieb wird nicht das Docker-Image verwendet, sondern die DDL-Queries werden mit Ansible auf dem bereits in der GDI vorhandenen Datenbankserver und -cluster deployed. Es ist die einzige Softwarekomponente, die nicht mittels Docker betrieben wird.

Benutzernamen und Passwörter der DB-Benutzer werden durch Setzen der Umgebungsvariablen PG_USER, PG_PASSWORD, PG_WRITE_USER, PG_WRITE_PASSWORD, PG_READ_USER und PG_READ_PASSWORD definiert. Das Passwort für den DB-Benutzer postgres wird durch die Umgebungsvariable PG_ROOT_PASSWORD gesetzt.

Code-Repository:
https://github.com/sogis/oereb-wms

Docker-Image:
https://hub.docker.com/r/sogis/oereb-wms

Der ÖREB-WMS dient dazu die «flachgewalzten» Tabellen (siehe ÖREB-Datenbank) aus der ÖREB-Datenbank als WMS-Layer zu publizieren. Es werden nur die kantonalen Daten publiziert. Für die Bundes-ÖREB-Daten wird der WMS-Dienst des Bundes (GetMap-Request gespeichert in den Daten) direkt verwendet.

Der WMS-Server exponiert zwei Endpunkte:

Sämtliche Konfiguration, insbesondere die QGIS-Projektdateien und die GeoPackage-Datei für den Dummy-Layer werden in das Docker-Image gebrannt. Die PostgreSQL-Verbindungsparameter inklusive Benutzername und Passwort und einer Option, die den search_path (default-Schemaname) definiert, werden in einem PostgreSQL Service File vorgehalten. Es wird in einem Secret platziert und unter /etc/postgresql-common in den Docker-Container gemountet.

Für den produktiven Einsatz wird somit nicht der bereits in der GDI vorhandene WMS-Server verwendet, sondern es wird bewusst ein zusätzlicher WMS-Server in Betrieb genommen.

Nach jedem Commit wird mit einer Github Action das Image neu gebuildet und innerhalb von 15 Minuten auf der Test- und Integrationsumgebung von OpenShift deployed.

Es wird QGIS 3.16 LTR eingesetzt. Das Dockerimage für die ARM64-Architektur verwendet QGIS 3.10 LTR aus dem offiziellen Ubuntu-Repository.

Code-Repository:
https://github.com/claeis/oereb-web-service
https://github.com/sogis/oereb-web-service-docker

Docker-Image:
https://hub.docker.com/r/sogis/oereb-web-service

Der ÖREB-Webservice ist die M2M-Schnittstelle des ÖREB-Katasters und dient dem Bezug des ÖREB-Katasterauszuges (XML und PDF) als Downloaddienst. Das Bundesamt für Landestopografie hat dazu zwei Weisungen («ÖREB-Webservice (Aufruf eines Auszugs)» und «ÖREB-Kataster - DATA-Extract») erlassen.

Die Umwandlung des XML nach PDF übernimmt die im Webservice integrierte Bibliothek pdf4oereb.

Der ÖREB Web Service des Kantons Solothurn unterstützt nur das Ausgabeformat XML.

Alle benötigten Daten müssen in einem einzigen Schema in einer PostgreSQL-Datenbank vorliegen. Die Konfiguration (inkl. der Datenbank-Verbindungsparameter) wird mittels ENV-Variablen gesteuert.

Jeder Commit im Code-Repository stösst einen Build-Prozess des Docker-Image-Repositories an. Das Docker-Image wird anschliessend automatisch in der Test- und Integrationsumgebung von OpenShift deployed.

Code-Repository:
https://github.com/sogis/oereb-iconizer

Der ÖREB-Iconizer ist ein Java-Programm, das zum Herstellen der einzelnen ÖREB-Symbole (als Bestandteil der Transferstruktur), verwendet wird. Die Symbole werden in einem manuellen Prozess hergestellt und als INTERLIS-Transferdatei zu den jeweiligen ÖREB-Gretl-Jobs kopiert. Während des Datenumbaus «kantonale Daten - ÖREB-Rahmenmodell» wird diese INTERLIS-Transferdatei importiert und das Symbol wird dem jeweiligen Symbol-Record des Rahmenmodells in der Datenbanktabelle zugewiesen. Da die Symbole nicht häufig ändern, ist dieser manuelle Herstellungsprozess der Symbole vertretbar.

Die Befehle für die Herstellung der INTERLIS-Transferdatei sind im Github-Repository beschrieben.

Code-Repository:
https://github.com/sogis/oereb-gretljobs

Die ÖREB-GRETL-Jobs werden für den Datenfluss eingesetzt. Dazu gehören der Umbau der Daten in der Edit-DB, der Export in das Rahmenmodell, die Prüfung der INTERLIS-Transferdatei und der Import in die ÖREB-Datenbank. Daten, die bereits im Rahmenmodell vorliegen, müssen nur noch geprüft und in die ÖREB-Datenbank importiert werden.

Service:
https://github.com/qwc-services/

Frontend:
https://github.com/sourcepole/qwc2-extra

Das Werkzeug ist ein Bestandteil des Web GIS Client und hat eigene Konfigurationensparameter. Diese Werkzeug ruft den ÖREB-Auszug (XML oder PDF) für das betroffene Grundstück auf und stellt den WMS zum passenden ÖREB-Katasterthema im Kartenfenster dar.

Dokumentenablage:
https://geo.so.ch/docs/ch.so.arp.zonenplaene/Zonenplaene_pdf/

Für die Ablage und das Bereitstellen sämtlicher Dokumente wird die bestehende Lösung des AGI verwendet: Sie besteht aus einem klassischen Filesystem, das in die verschiedenen Desktop- und Serverumgebungen eingebunden werden kann und von den berechtigten Benutzern verwendet werden kann. Dieses Filesystem wird mittels API-Gateway (nginx Webserver) als HTTP-Ressource exponiert.

Die Servicezeit ist der Zeitraum, während dem die vertraglich vereinbarte Verfügbarkeit der Leistung sichergestellt und ausgewiesen wird. Sie ist Basis für die Verfügbarkeitsmessung. Die Systeme stehen grundsätzlich auch ausserhalb der definierten Servicezeiten zur Verfügung (Betriebszeit 7 x 24 Stunden), jedoch ohne Gewährleistung der Verfügbarkeiten (vgl. unten).

Servicezeit: Montag bis Freitag, 07:00 – 12:00 und 13:00 – 17:30 Uhr, allgemeine Feiertage werden wie Sonntage behandelt.

Die Verfügbarkeit entspricht dem Prozentsatz, zu dem die vereinbarten Leistungen während der definierten Servicezeit (vgl. oben) erbracht werden.

Verfügbarkeit: 98% von Montag bis Freitag, 07:00 – 12:00 und 13:00 – 17:30 Uhr.

Die Störungsbehebungszeit bezeichnet die Zeitdauer während der Servicezeit zwischen dem Eingang der Störungsmeldung bei der Supportorganisation und der Wiederherstellung der Anwendung beziehungsweise Dienstes, inklusive der Information des Leistungsbezügers.

Störungsbehebungszeit: 16 Stunden

Die Überwachung des Betriebs des ÖREB-Katasters erfolgt auf unterschiedlichen Stufen:

Das AIO überwacht den Betrieb des OpenShift-Clusters in dem sämtliche vom AGI betriebenen ÖREB-Kataster-Komponenten (mit Ausnahme der Datenbank) deployed sind. Die ÖREB-Kataster-Komponenten werden vom AGI mit OpenShift-Bordmitteln überwacht (Live- und Readynesstests, Selfhealing, etc.). Zusätzlich wird mit Statuscake ein Uptime- und Performancemonitoring betrieben. Fehler werden per E-Mail an die entsprechenden Personen mitgeteilt.

Die ÖREB-Datenbank wird nicht in OpenShift betrieben, sondern im bestehenden Datenbankcluster des AGI auf virtuellen Servern. Die Überwachung wird mit NAGIOS sichergestellt.

Störungsmeldungen bei den Daten-Integrationsprozessen werden der zuständigen Stellen und dem AGI per E-Mail mitgeteilt.

Die Geobasisdaten der kantonalen ÖREB-Themen sind in der kantonalen GDI abgelegt und werden entsprechend durch bereits vorhandene Prozesse jeden Tag gesichert. Die Dokumente auf dem Filesystem werden durch übergeordnete Backupprozesse des AIO gesichert.

Jede Datenintegration in den ÖREB-Kataster geschieht mittels Rahmenmodell. Diese INTERLIS-Transferdatei wird archiviert.

Die Geobasisdaten der ÖREB-Katasterthemen enthalten ausschliesslich nicht-sensitive Sachdaten und unterliegen deshalb nicht dem Datenschutz.

Die Rechtsvorschriften werden ohne sensible Daten publiziert. Die entsprechende Bearbeitung der Rechtsvorschriften liegt in der Verantwortung der zuständigen Stelle.

Die Katasterabfragen (dynamischer Auszug) und die PDF-Katasterauszüge über den Web GIS Client werden mit Matomo protokolliert und können ausgewertet werden. Die Logdateien des API-Gateway werden zudem mittels logit.io ausgewertet. Diese Auswertungen (Matomo und logit.io) dienen als Grundlage für die Berichterstattung zuhanden der Katasteraufsicht und für die Tätigkeitsberichte der kantonalen Verwaltung.

Fehler in den Geobasisdaten und Rechtsvorschriften, welche der KVS gemeldet werden, werden der zuständigen Stelle zur Korrektur gemeldet. Die Fehler sind je nach Art so schnell wie möglich zu beheben.

GRETL-Jobs:
oerebv2_bundesdaten: ÖREB-Daten im Transfermodell. Werden jede Nacht importiert.
oerebv2_bundesgesetze: Gesetzlichen Grundlagen (Gesetz und Verordnungen) des Bundes. Werden manuell, «on demand» importiert.
oerebv2_bundeskonfiguration: Themen, Logos und Texte des Bundes. Werden manuell, «on demand» importiert.

Bundesdaten werden durch das zuständige Bundesamt nachgeführt und auf der Webseite https://data.geo.admin.ch/ im entsprechenden Unterordner bereitgestellt. Aus nicht nachvollziehbaren Gründen sind die ÖREB-Unterordner jedoch nicht direkt aufgelistet, sondern die Unterordner-Url muss mühsam selber zusammengestöpselt werden (aus Basis-Url und Themennamen).

Die Bundeskonfiguration und die Bundesgesetze und -verordnungen sind auf der INTERLIS-Modell- und Datenablage zu finden (http://models.geo.admin.ch/V_D/OeREB/).