xPlanBox

In diesem Repository ist der Quellcode für die Open Source-Version der Anwendung "xPlanBox" der Firma lat/lon enthalten. Die Anwendung dient der Abbildung der Bauleit- und der Landschaftsplanung auf Basis des Standards XPlanung. Die Anwendung basiert zudem auf den Standards des Open Geospatial Consortium, den technischen Empfehlungen der INSPIRE Richtlinie und insbesondere der Abbildung des deutschen Planungsrechts durch das GML-Anwendungsschema XPlanGML. Die Komponenten der Anwendung wurden u.a. unter der Verwendung der Open Source-Software deegree webservices implementiert.

Lizenz

Dieses Projekt ist unter der GNU Affero General Public License, Version 3 oder jeder späteren Version veröffentlicht. Weitere Informationen zur Lizenz stehen in LICENSE.txt.

Versionierung

Die Versionierung der Software folgt dem Versionierungsschema von SemVer. Eine Übersicht der bisher erstellten Versionen ist unter Releases zu finden. Die Änderungshistorie ist im CHANGELOG.md dokumentiert.

Mitarbeit

Regeln für die Mitarbeit finden Sie in CONTRIBUTING.md.

Autoren

• lat/lon GmbH - Hersteller der xPlanBox - lat/lon

Personen, die an diesem Projekt mitgearbeitet haben, stehen in contributors.

Sponsoren

Initialer Sponsor und Implementierungspartner

Kooperationspartner

Dokumentation

Anwenderdokumentation

Die Dokumentation zur Anwendung liegt im Asciidoc-Format vor und sowohl das Benutzer- als auch Betriebshandbuch mit der Installationsanleitung sind im Quelltext in den Verzeichnissen Benutzerhandbuch und Betriebshandbuch abgelegt. Die Erstellung von PDF- und HTML-Ausgabedateien erfolgt mit dem Bauen der Software wie im folgenden Kapitel dokumentiert.

Entwicklerdokumentation

Für die Erstellung der ausführbaren Binärdateien ist ein JDK 11 und das Werkzeug Apache Maven 3.8 erforderlich.

Installation und Konfiguration von Maven.

Folgen Sie der Installationsanleitung von Maven und legen Sie anschliessend im Benutzerverzeichnis die Datei ${user.home}/.m2/settings.xml mit folgendem Eintrag für einen Spiegelserver (mirror) an:

<settings>
    <mirrors>
        <mirror>
            <id>deegree</id>
            <mirrorOf>latlon</mirrorOf>
            <url>https://repo.deegree.org/repository/public/</url>
        </mirror>
    </mirrors>
</settings>

Weitere Informationen zu Konfiguration von Maven stehen in der Referenzdokumentation zu den Maven Settings.

Hinweis: Diese Konfiguration ist zurzeit noch erforderlich, da die verwendetet Bibliotheken von Dritten noch nicht in einem Repository von GitLab auf der OpenCoDE-Plattform verfügbar sind.

deegree webservices erstellen

Im ersten Schritt muss der Quellcode von deegree mit Java 11 kompiliert werden. Dazu muss die passende Version von deegree ausgewählt werden. Für Version 6.0 der Anwendung muss deegree Version 3.5-PRE1 verwendet werden:

git clone https://github.com/lat-lon/deegree3.git
cd deegree3
git checkout tags/xplanbox-deegree-3.5-PRE1
mvn clean install

Hinweis: Aktuell kann noch nicht eine offizielle Release-Version von deegree verwendet werden, da diese bisher nur unter Java 1.8 ausführbar sind. Der Quellcode für diese Anwendung erfordert aber Java 11! Sobald eine Version von deegree mit Unterstützung von Java 11 verfügbar ist, entfällt dieser Schritt.

Hinweis: Unter dem Betriebssystem Windows kann es bei der Ausführung von Unit-Test zu Fehlern kommen. Es kann dann erforderlich sein, die Tests zu überspringen. Dazu ist die Option -DskipTests beim Aufruf von Maven zu ergänzen.

XPlanung-Validierungsregeln einbinden

Die Anwendung nutzt die öffentlich verfügbaren XPlanung-Validierungsregeln des XPlanung-Standards aus dem OpenCoDE-Repository der XLeitstelle.

Hinweis: Um eine andere Version der XPlanung-Validierungsregeln zu installieren, folgen Sie der Anleitung im Betriebshandbuch.

Anwendung erstellen

Die Erstellung der Binärdateien der Anwendung erfolgt dann im Basisverzeichnis mit folgendem Maven Aufruf:

git clone git@gitlab.opencode.de:diplanung/ozgxplanung.git
cd ozgxplanung
mvn clean install

Installation und Konfiguration

Die Installation und Konfiguration der Anwendung ist im Betriebshandbuch dokumentiert.

© 2022 lat/lon gesellschaft für raumbezogene informationssysteme mbH
Im Ellig 1 53343 Wachtberg
Tel: +49 +228 24333784
info@lat-lon.de
https://www.lat-lon.de
twitter: https://twitter.com/latlon_de
GitHub: https://github.com/lat-lon