Das freie Anlagen- und Indirekteinleiterkataster (AUI-K) erfasst standortbezogene Informationen zu Anlagen zum Umgang mit wassergefährdenden Stoffen (AwsV) und Indirekteinleitern. Durch die gemeinsame Datenbasis mit geografischen Daten können Sachdaten mit den erfassten Informationen verschnitten werden. Darüber hinaus können automatisch Einträge in Datensätze aufgrund ihrer räumlichen Zugehörigkeit zu beispielsweise Entwässerungsgebieten, Wasserschutzgebieten etc. generiert werden.
Für das Aufsetzen einer Entwicklungsumgebung wird zuerst eine PostgreSQL-Datenbank benötigt. Diese kann über das vorhandene Dockerfile erstellt werden:
docker build -t auik/db -f docker/Dockerfile .
docker run --name auik_db -p15432:5432 -v $PWD/data/db:/opt/auik_db -d auik/db
Die Datenbank ist dann unter Port 15432
mit dem Datenbanknamen fisumwelt
erreichbar. Ein Login ist möglich als Nutzer auikadmin
mit dem Passwort secret
.
Alternativ kann die Datenbank über die Skripte in data/db
manuell erstellt werden.
cd data/db
createdb fisumwelt
createuser -P auikadmin
psql -d fisumwelt -f version1_0_schema.sql
psql -d fisumwelt -f updateTo_1_1_0.sql
Optional können Beispiel-Daten importiert werden. Im Docker-Setup erfolgt das automatisch.
Vor dem Starten der Anwendung muss in der auik.properties
der Eintrag auik.system.dburl
gesetzt werden um die Verbindung mit der Datenbank zu ermöglichen.
Beispielweise mit einer Datenbank erreichbar unter localhost:15432
mit dem Datenbank-Namen fisumwelt
:
auik.system.dburl=jdbc\:postgresql\://localhost\:15432/fisumwelt
Für die Anwendung selbst müssen maven
und ein passendes JDK ab Version 11 (bspw. OpenJDK 11) installiert sein.
Kompilieren und Starten der Anwendung:
mvn clean compile exec:java
Für die Anmeldung kann der Datenbankbenutzer verwendet werden:
auikadmin
, Passwort: secret
Wie für die Entwicklungsumgebung wird eine Datenbank benötigt. Grundsätzlich funktioniert das Aufsetzen wie unter Aufsetzen der Datenbank angegeben, es sollten aber die jeweiligen Anforderungen für den produktiven Betrieb berücksichtigt werden.
Erstellen eines JAR:
mvn clean package
Das JAR ist im Ordner target
zu finden und kann von dort
an sein Ziel bewegt werden.
Die Konfiguration erfolgt wie unter Konfigurieren der Anwendung angegeben. Die Konfigurationsdatei muss sich zum starten der Anwendung im selben Verzeichnis befinden wie das JAR.
Starten der Anwendung:
java -jar auik_prod-*.jar
Für die Anmeldung kann der Datenbankbenutzer verwendet werden.
Das AUI-K Handbuch ist als pdf-Datei unter doc/AUI-K_Handbuch.pdf zu finden.
Mithilfe des mitgelieferten SQL-Skripts können Adressdaten als CSV in die Datenbank importiert werden. Die entsprechende CSV-Datei muss eine Titel-Zeile und folgende Spalten enthalten:
namezus,wirtschaftszweig,name,namebetrbeauf,vornamebetrbeauf,email,telefon,telefax,plz,ort,strasse,hausnr,hausnrzus,bemerkungen
Tatsächlich wird die erste Zeile der CSV-Datei ignoriert, aber der Inhalt der Spalten muss den genannten Spalten im Datenbank-Schema entsprechen.
Die CSV Beispieldatei kann hier als Vorlage dienen.
Der Import selbst lässt sich bspw. über eine Kommandozeile auslösen:
cd data/db
psql -d fisumwelt -f import_csv.sql <import.csv
fisumwelt
ist hier der Datenbankname, je nach Datenbank-Setup müssen ggf. weitere Parameter ergänzt werden.
Manche der importierten Daten werden nur beim Start der Anwendung geladen, so dass ein Neustart der Anwendung nach dem Import erforderlich ist, damit alle Daten korrekt dargestellt werden.
Mithilfe von .properties
Dateien können die Beschriftungen von Feldern angepasst werden. Die verfügbaren Einträge finden sich in der auik_de_DE.properties.
Eine Anpassung kann entweder in der genannten Datei erfolgen oder über eine separate Datei. Letztere kann dann in der auik.properties
ohne Sprachkürzel und Dateiendung angegeben werden.
Bspw. wäre der Eintrag in der auik.properties
für eine Datei exampleFile_de_DE.properties
:
auik.i18n_file=exampleFile