Plannamenvalidierungsregeln aktualisieren - Versionsgeschichte

Diplanung am 20. April 2026 um 05:50 Uhr

2026-04-20T05:50:04Z

Diplanung am 4. Dezember 2025 um 11:03 Uhr

2025-12-04T11:03:52Z

Diplanung am 4. Dezember 2025 um 10:58 Uhr

2025-12-04T10:58:53Z

Diplanung am 6. Juni 2025 um 11:44 Uhr

2025-06-06T11:44:56Z

Diplanung am 6. Juni 2025 um 11:42 Uhr

2025-06-06T11:42:19Z

Diplanung: Die Seite wurde neu angelegt: „Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und kö…“

2025-06-06T11:41:46Z

Die Seite wurde neu angelegt: „Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und kö…“

Neue Seite

Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und können je Planart vergeben werden:[[Datei:ImagePlannamenvalidierungXML.png|zentriert|rahmenlos|verweis=https://wiki.diplanung.de/index.php%3Ftitle=Datei:ImagePlannamenvalidierungXML.png]]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>

</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|verweis=https://wiki.diplanung.de/index.php%3Ftitle=Datei:ImagePlannamenValidatorSchema.png]]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
*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
*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.

Beispiel:
<code><plannameSyntaxRegel>
<bedingung>
<planart>Baustufenplan</planart>
</bedingung>

<regex>[B]{1}[S]{1}[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+</regex>

<regex>[B]{1}[S]{1}[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[-]{1}[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+</regex>
</plannameSyntaxRegel>
<plannameSyntaxRegel>
<bedingung>
<planart>EinfacherBebauungsplan</planart>
</bedingung>
<bedingung>
<planart>QualifizierterBebauungsplan</planart>
</bedingung>

<regex>[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[0-9]{1,3}</regex>

<regex>[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[-]{1}[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[0-9]{1,3}</regex>

<regex>[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[0-9]{1,3}[-]{1}[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[0-9]{1,3}</regex>

<regex>[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[-]{1}[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[0-9]{1,3}[-]{1}[A-Z]{1}<nowiki>[a-zA-Z&amp;&amp;[^öüäß]</nowiki>]+[0-9]{1,3}</regex>

<regex>[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[A-Z]{1}<nowiki>[a-z&amp;&amp;[^öüäß ]</nowiki>]+[0-9]{1,2}</regex>
</plannameSyntaxRegel></code>

@@ Zeile 1: / Zeile 1: @@
 Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und können je Planart individuell festgelegt werden:
+[[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.)

@@ Zeile 1: / Zeile 1: @@
-Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und können je Planart individuell festgelegt werden:[[Datei:ImagePlannamenvalidierungXML.png|zentriert|rahmenlos|verweis=https://wiki.diplanung.de/index.php%3Ftitle=Datei:ImagePlannamenvalidierungXML.png]]Erläuterung der Regex aus dem Beispiel, die pro Planart vergeben werden können:
+Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und können je Planart individuell festgelegt werden:
 *"[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

@@ Zeile 1: / Zeile 1: @@
-Für die Validierung der Plannamen werden Regex ausgeführt, wenn diese als Validierungsregeln hinterlegt aus. Regex sehen beispielsweise aus wie folgt und können je Planart individuell festgelegt werden:
+Per Default sind im DiPlanCockpit keine Validierungsregeln für Plannamen hinterlegt, so dass keine Überprüfung während des Uploads und Downloads von Planwerken stattfindet. Der Plannamenvalidator ist jedoch per XML konfigurierbar.
-[[Datei:ImagePlannamenvalidierungXML.png|zentriert|rahmenlos]]
-Erläuterung der Regex aus dem Beispiel, die pro Planart vergeben werden können:
+Der folgende Screenshot zeigt einen Auszug aus einer beispielhaften XML-Datei zur Konfiguration:
-*"[A-Z]{1}" = Ein Großbuchstabe (Eckige Klammern enthalten das, worum es geht; geschweifte Klammern geben an, wie viel.)
+[[Datei:ImagePlannamenvalidierungXML2.png|zentriert|mini|742x742px]]
-*"[a-z&&[^öüäß ]]" = direkt anschließend Kleinbuchstaben mit Ausnahme von Umlauten, "ß" und Leerzeichen
+Die Validierungsregeln werden jeweils pro Kombination aus Planart und Verfahrensart definiert und als Regex formuliert.
-*"+" = Kombination mehrerer Vorgaben in eckigen Klammern "[''beliebiger Inhalt'']"
-*"[0-9]{1,3}" = direkt anschließend 1 bis 3 Zahlen
+Bei Regex gilt, dass in eckigen Klammern steht, um welche Zeichen es geht, und in geschweiften Klammern, wie viele dieser Zeichen genutzt werden dürfen.
-*"[-]{1}" = Bindestrich bzw. Minus z.B. zur Verbindung mehrerer ORT-Angaben
 ==Zur Vertiefung==
 ===Generelles===
@@ Zeile 12: / Zeile 16: @@
 *Groß- und Kleinbuchstaben
 *Zahlen
-Zusätzlich Sonderzeichen, die im EfA DiPlanCockpit nun möglich sind:
+Zusätzlich Sonderzeichen, die im EfA DiPlanCockpit möglich sind:
 *Umlaute als Groß- und Kleinbuchstaben wie "Öäß"
 *Weitere Zeichen: ",:§" und Römische Ziffern
@@ Zeile 19: / Zeile 23: @@
 *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.
+Die Default-Konfiguration beinhaltet keine Validatorregeln, d.h. der Planname wird nicht validiert.
   <code><nowiki><?xml version="1.0" encoding="UTF-8"?>
    <plannamenValidatorKonfiguration>
@@ Zeile 26: / Zeile 30: @@
 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|verweis=https://wiki.diplanung.de/index.php%3Ftitle=Datei:ImagePlannamenValidatorSchema.png]]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:
+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
+* planart
-*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
+** Planart des Verfahrens
-*hatBeschlussBuergerschaftLapro ** optionale Zusatzprüfung für LaPro-Verfahren: *** Sitzung "beschlussBuergerschaft" hat stattgefunden UND politisches Sitzungsergebnis ist zugestimmt ** Datentyp: boolean
+** Datentyp: string
 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.
 Beispiel:
-  <code><plannameSyntaxRegel>
+  <plannameSyntaxRegel>
       <bedingung>
-          <planart>Baustufenplan</planart>
+          <planart>6_3_EinfacherBPlan</planart>
       </bedingung>
      <!--BSAltenwerder-->
       <regex>[B]{1}[S]{1}[A-Z]{1}<nowiki>[a-z&amp;amp;&amp;amp;[^öüäß ]</nowiki>]+</regex>
-      <!--BSAltenwerder-Moorburg-->
+     <!--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>