Konfiguration DiPlanCockpit Basis: Unterschied zwischen den Versionen

Aus DiPlanung

 
(9 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
'''> Zurück zur Hauptseite [[DiPlan Cockpit Basis für Mandanten-Administratoren (M-A)]]'''
 
'''> Zurück zur Hauptseite [[DiPlan Cockpit Basis für Mandanten-Administratoren (M-A)]]'''
==Hinzufügen von Verfahren==
+
 
 +
Im Reiter Konfiguration können '''Verfahren hinzugefügt''', die '''Kontakteliste''', die '''Plannamenvalidierungsregeln''', das '''CSW-Template''' sowie das '''DCAT-AP.PLU Template aktualisiert''' werden.
 +
==Verfahren importieren (XPlanverfahren)==
 
Verfahren lassen sich hier hochladen. Für den Upload muss das Verfahren in einer XML-Datei vorliegen und dem XÖV-Standard xPlanverfahren entsprechen. Es ist sowohl das Hochladen eines einzelnen Verfahrens als auch mehrerer Verfahren gleichzeitig möglich. Die maximale Anzahl an Verfahren, die gleichzeitig hochgeladen werden können, wird mittels des Systemparameters XPLANVERFAHREN_IMPORT_VERFAHRENSANZAHL festgelegt und kann darüber bei Bedarf angepasst werden. Dabei ist zu beachten, dass der Upload sehr vieler und großer Verfahren einige Zeit beansprucht. Außerdem werden die Verfahren vor dem Import automatisch auf Konformität mit dem XÖV-Standard validiert. Werden dabei Fehler festgestellt, bricht der gesamte Import ab. Detaillierte Informationen finden sich auf der Seite zum Thema "[[Verfahren hinzufügen (XPlanverfahren)|Verfahren hinzufügen]]".
 
Verfahren lassen sich hier hochladen. Für den Upload muss das Verfahren in einer XML-Datei vorliegen und dem XÖV-Standard xPlanverfahren entsprechen. Es ist sowohl das Hochladen eines einzelnen Verfahrens als auch mehrerer Verfahren gleichzeitig möglich. Die maximale Anzahl an Verfahren, die gleichzeitig hochgeladen werden können, wird mittels des Systemparameters XPLANVERFAHREN_IMPORT_VERFAHRENSANZAHL festgelegt und kann darüber bei Bedarf angepasst werden. Dabei ist zu beachten, dass der Upload sehr vieler und großer Verfahren einige Zeit beansprucht. Außerdem werden die Verfahren vor dem Import automatisch auf Konformität mit dem XÖV-Standard validiert. Werden dabei Fehler festgestellt, bricht der gesamte Import ab. Detaillierte Informationen finden sich auf der Seite zum Thema "[[Verfahren hinzufügen (XPlanverfahren)|Verfahren hinzufügen]]".
  
Zeile 9: Zeile 11:
 
Das DiPlanCockpit wird beim Anlegen bzw. Verändern des Plannamens Validierungsprüfungen ausführen, um eine einheiltiche Qualität sicherzustellen, sofern entsprechende Validierungsregeln hinterlegt sind. Per Default sind keine Regeln vorgegeben, das heißt, es müssen Regeln hinzugefügt werden, wenn eine Validierung gewünscht ist. Hinterlegte Regeln können herunter- und hochgeladen werden. Sie greifen jeweils sofort nachdem sie in die Anwendung hochgeladen wurden. Der Download liefert eine XML-Datei, die angepasst und anschließend wieder hochgeladen werden kann. Bei der XML-Datei ist darauf zu achten, dass sie dem Schema plannameValidatorkonfiguration.xsd entspricht.
 
Das DiPlanCockpit wird beim Anlegen bzw. Verändern des Plannamens Validierungsprüfungen ausführen, um eine einheiltiche Qualität sicherzustellen, sofern entsprechende Validierungsregeln hinterlegt sind. Per Default sind keine Regeln vorgegeben, das heißt, es müssen Regeln hinzugefügt werden, wenn eine Validierung gewünscht ist. Hinterlegte Regeln können herunter- und hochgeladen werden. Sie greifen jeweils sofort nachdem sie in die Anwendung hochgeladen wurden. Der Download liefert eine XML-Datei, die angepasst und anschließend wieder hochgeladen werden kann. Bei der XML-Datei ist darauf zu achten, dass sie dem Schema plannameValidatorkonfiguration.xsd entspricht.
  
Für die Validierung werden Regex ausgeführt. Diese sehen beispielsweise aus wie folgt und können je Planart vergeben werden:
+
Weitere Informationen befinden sich auf der separaten Seite zum Thema [[Plannamenvalidierungsregeln aktualisieren]].
[[Datei:ImagePlannamenvalidierungXML.png|zentriert|rahmenlos]]
 
 
 
Erläuterung der Regex aus dem Beispiel, die pro Planart vergeben werden können:
 
 
 
* "[A-Z]{1}" = Ein Großbuchstabe (Eckige Klammern enthalten das, worum es geht; geschweifte Klammern geben an, wie viel.)
 
* "[a-z&&[^öüäß ]]" = direkt anschließend Kleinbuchstaben mit Ausnahme von Umlauten, "ß" und Leerzeichen
 
* "+" = Kombination mehrerer Vorgaben in eckigen Klammern "[''beliebiger Inhalt'']"
 
* "[0-9]{1,3}" = direkt anschließend 1 bis 3 Zahlen
 
* "[-]{1}" = Bindestrich bzw. Minus z.B. zur Verbindung mehrerer ORT-Angaben
 
 
 
=== Zur Vertiefung ===
 
 
 
==== Generelles ====
 
Folgende Zeichen sind unkritisch und im Plannamen verwendbar:
 
 
 
* Groß- und Kleinbuchstaben
 
* Zahlen
 
 
 
Zusätzlich Sonderzeichen, die im EfA DiPlanCockpit nun möglich sind:
 
 
 
* Umlaute als Groß- und Kleinbuchstaben wie "Öäß"
 
* Weitere Zeichen: ",:§" und Römische Ziffern
 
 
 
Zeichen mit besonderer Bedeutung in Regex:
 
 
 
* .()^*/
 
* Diese Zeichen müssen mit einen vorangestellten \ maskiert werden, um sie von ihrer Sonderrolle zu entbinden.
 
 
 
==== Details zur Konfiguration des Plannamenvalidators ====
 
Die Default-Konfiguration beinhaltet keine Validatorregeln, d.h. der Planname wird in diesem Fall nicht validiert.
 
<code><nowiki><?xml version="1.0" encoding="UTF-8"?>
 
<plannamenValidatorKonfiguration>
 
<!--Definition der plannameSyntaxRegel(n)-->
 
</plannamenValidatorKonfiguration></nowiki></code>
 
Enthält die XML-Konfigurationsdatei Validatorregeln, muss das zu prüfende Verfahren mindestens einer Validatorregel entsprechen, andernfalls wird der Planname als ungültig abgelehnt.
 
 
 
Die Validatorkonfiguration wird in XML beschrieben und basiert auf einem XML-Schema:
 
[[Datei:ImagePlannamenValidatorSchema.png|zentriert|rahmenlos|623x623px]]
 
Innerhalb der XML-Datei können mehrere Validatoren konfiguriert werden. Ein Validator wird durch eine Planname-Syntax-Regel beschrieben. Dieses Element besteht aus 1-n Bedingungen und 1-n regulären Ausdrücken (Regex). Die Bedingungen beziehen sich auf Verfahrenseigenschaften und dienen dazu, den gültigen Validator für den Plannamen eines Verfahrens zu ermitteln. Folgende Verfahrenseigenschaften lassen sich in den Bedingungen abbilden:
 
  
* planart ** Planart des Verfahrens ** Datentyp: string
+
== Metadaten-Templates aktualisieren ==
* hatBeschlussBuergerschaftSenatssitzungFnp ** optionale Zusatzprüfung für FNP-Verfahren: *** Sitzung "senatssitzung" hat stattgefunden UND politisches Sitzungsergebnis ist zugestimmt *** Sitzung "beschlussBuergerschaft" hat stattgefunden UND politisches Sitzungsergebnis ist zugestimmt ** Datentyp: boolean
+
Die Templates liegen im XML-Format vor und lassen sich anpassen. In den XML werden URI zur eindeutigen Identifizierung verwendet. Darüber lassen sich teilweise außerhalb des Wikis weitere Informationen finden, aber nicht zwingend. Die URI wird üblicherweise in Form einer Webadresse angegeben, und muss lediglich eindeutig sein aber nicht zwingend auf eine real existierende Webseite zeigen. In <code><dcat:Distribution rdf:about="<nowiki>https://bauleitplanung.hamburg.de/planzeichnung</nowiki>"></code> ist <nowiki>https://bauleitplanung.hamburg.de/planzeichnung</nowiki> die URI, es gibt jedoch keine Webseite, zu der man mit dem Link gelangt. Die URI kann angepasst werden, solange sie eindeutig bleibt. Statt bauleitplanung.hamburg kann bspw. diplanung.berlin verwendet werden.
* hatBeschlussBuergerschaftLapro ** optionale Zusatzprüfung für LaPro-Verfahren: *** Sitzung "beschlussBuergerschaft" hat stattgefunden UND politisches Sitzungsergebnis ist zugestimmt ** Datentyp: boolean
 
  
Die einzelnen Bedingungen einer Planname-Syntax-Regel sind ODER-verknüpft, d.h. bezogen auf das Verfahren muss mindestens eine Bedingung erfüllt sein, um den entsprechenden Validator anzuwenden. Der Planname wird dann anhand der regulären Ausdrücke geprüft. Diese regulären Ausdrücke sind ebenfalls ODER-verknüpft, d.h. der Planname ist valide, wenn seine Syntax mindestens einem regulären Ausdruck entspricht.
+
=== IGC Template hochladen ===
 +
'''Bitte beachten:''' IGC ist nicht mehr relevant, stattdessen wird CSW verwendet.
  
Beispiel:
+
Hier kann das Template für die Bereitstellung von Planmetadaten im IGC (InGrid®Catalog) Format aktualisiert werden. Das Template kann im XML-Format herunter- und hochgeladen werden.
<code><plannameSyntaxRegel>
 
    <bedingung>
 
        <planart>Baustufenplan</planart>
 
    </bedingung>
 
    <!--BSAltenwerder-->
 
    <regex>[B]{1}[S]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+</regex>
 
    <!--BSAltenwerder-Moorburg-->
 
    <regex>[B]{1}[S]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[-]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+</regex>
 
</plannameSyntaxRegel>
 
<plannameSyntaxRegel>
 
    <bedingung>
 
        <planart>EinfacherBebauungsplan</planart>
 
    </bedingung>
 
    <bedingung>
 
        <planart>QualifizierterBebauungsplan</planart>
 
    </bedingung>
 
    <!--Hummelsbuettel7-->
 
    <regex>[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[0-9]{1,3}</regex>
 
    <!--Hamburg-Altstadt26-->
 
    <regex>[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[-]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[0-9]{1,3}</regex>
 
    <!--Hamburg-Altstadt34-HafenCity2-->
 
    <regex>[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[0-9]{1,3}[-]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[0-9]{1,3}</regex>
 
    <!--Sonderfall Ort-minus-Ort-zahl-minus-Ort-zahl-->
 
    <regex>[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[-]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[0-9]{1,3}[-]{1}[A-Z]{1}<nowiki>[a-zA-Z&amp;amp;&amp;amp;[^öüäß]</nowiki>]+[0-9]{1,3}</regex>
 
    <!--Sonderfall „HafenCity“, „HafenCity11“-->
 
    <regex>[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+[0-9]{1,2}</regex>
 
</plannameSyntaxRegel></code>
 
  
== CSW-Template aktualisieren ==
+
=== CSW-Template hochladen ===
Hier lässt sich das CSW-Template im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden.
+
Hier lässt sich das CSW-Template im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden. Details zum Template finden sich auf einer eigenen [[CSW Export|Seite]].  
  
== DCATAP PLU Template aktualisieren ==
+
=== DCAT-AP.PLU Template hochladen ===
Hier lässt sich das DCATAP PLU Template im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden.
+
Hier lässt sich das DCAT-AP.PLU Template im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden. Details zum Template finden sich auf einer eigenen [[DCAT-AP.PLU Export DiPlanCockpit Basis|Seite]].
 
  Für die Anzeige und Überarbeitung der Templates sollte kein Browser sondern eine professionelle XML-Anwendung verwendet werden. Wenn eine solche nicht vorhanden ist, können Sie behelfsweise einen Texteditor wie Notepad++ nutzen.
 
  Für die Anzeige und Überarbeitung der Templates sollte kein Browser sondern eine professionelle XML-Anwendung verwendet werden. Wenn eine solche nicht vorhanden ist, können Sie behelfsweise einen Texteditor wie Notepad++ nutzen.

Aktuelle Version vom 11. Dezember 2025, 07:30 Uhr

> Zurück zur Hauptseite DiPlan Cockpit Basis für Mandanten-Administratoren (M-A)

Im Reiter Konfiguration können Verfahren hinzugefügt, die Kontakteliste, die Plannamenvalidierungsregeln, das CSW-Template sowie das DCAT-AP.PLU Template aktualisiert werden.

Verfahren importieren (XPlanverfahren)[Bearbeiten | Quelltext bearbeiten]

Verfahren lassen sich hier hochladen. Für den Upload muss das Verfahren in einer XML-Datei vorliegen und dem XÖV-Standard xPlanverfahren entsprechen. Es ist sowohl das Hochladen eines einzelnen Verfahrens als auch mehrerer Verfahren gleichzeitig möglich. Die maximale Anzahl an Verfahren, die gleichzeitig hochgeladen werden können, wird mittels des Systemparameters XPLANVERFAHREN_IMPORT_VERFAHRENSANZAHL festgelegt und kann darüber bei Bedarf angepasst werden. Dabei ist zu beachten, dass der Upload sehr vieler und großer Verfahren einige Zeit beansprucht. Außerdem werden die Verfahren vor dem Import automatisch auf Konformität mit dem XÖV-Standard validiert. Werden dabei Fehler festgestellt, bricht der gesamte Import ab. Detaillierte Informationen finden sich auf der Seite zum Thema "Verfahren hinzufügen".

Kontakteliste aktualisieren[Bearbeiten | Quelltext bearbeiten]

Hier lässt sich die Kontakteliste im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden. Details zur Anpassung finden sich auf der Seite zur Kontakteliste.

Plannamenvalidierungsregeln aktualisieren[Bearbeiten | Quelltext bearbeiten]

Das DiPlanCockpit wird beim Anlegen bzw. Verändern des Plannamens Validierungsprüfungen ausführen, um eine einheiltiche Qualität sicherzustellen, sofern entsprechende Validierungsregeln hinterlegt sind. Per Default sind keine Regeln vorgegeben, das heißt, es müssen Regeln hinzugefügt werden, wenn eine Validierung gewünscht ist. Hinterlegte Regeln können herunter- und hochgeladen werden. Sie greifen jeweils sofort nachdem sie in die Anwendung hochgeladen wurden. Der Download liefert eine XML-Datei, die angepasst und anschließend wieder hochgeladen werden kann. Bei der XML-Datei ist darauf zu achten, dass sie dem Schema plannameValidatorkonfiguration.xsd entspricht.

Weitere Informationen befinden sich auf der separaten Seite zum Thema Plannamenvalidierungsregeln aktualisieren.

Metadaten-Templates aktualisieren[Bearbeiten | Quelltext bearbeiten]

Die Templates liegen im XML-Format vor und lassen sich anpassen. In den XML werden URI zur eindeutigen Identifizierung verwendet. Darüber lassen sich teilweise außerhalb des Wikis weitere Informationen finden, aber nicht zwingend. Die URI wird üblicherweise in Form einer Webadresse angegeben, und muss lediglich eindeutig sein aber nicht zwingend auf eine real existierende Webseite zeigen. In <dcat:Distribution rdf:about="https://bauleitplanung.hamburg.de/planzeichnung"> ist https://bauleitplanung.hamburg.de/planzeichnung die URI, es gibt jedoch keine Webseite, zu der man mit dem Link gelangt. Die URI kann angepasst werden, solange sie eindeutig bleibt. Statt bauleitplanung.hamburg kann bspw. diplanung.berlin verwendet werden.

IGC Template hochladen[Bearbeiten | Quelltext bearbeiten]

Bitte beachten: IGC ist nicht mehr relevant, stattdessen wird CSW verwendet.

Hier kann das Template für die Bereitstellung von Planmetadaten im IGC (InGrid®Catalog) Format aktualisiert werden. Das Template kann im XML-Format herunter- und hochgeladen werden.

CSW-Template hochladen[Bearbeiten | Quelltext bearbeiten]

Hier lässt sich das CSW-Template im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden. Details zum Template finden sich auf einer eigenen Seite.

DCAT-AP.PLU Template hochladen[Bearbeiten | Quelltext bearbeiten]

Hier lässt sich das DCAT-AP.PLU Template im XML-Format herunterladen, sodass Anpassungen daran vorgenommen werden können. Anschließend kann die angepasste Datei wieder hochgeladen werden. Details zum Template finden sich auf einer eigenen Seite.

Für die Anzeige und Überarbeitung der Templates sollte kein Browser sondern eine professionelle XML-Anwendung verwendet werden. Wenn eine solche nicht vorhanden ist, können Sie behelfsweise einen Texteditor wie Notepad++ nutzen.