Verfahrenskonfiguration

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

Mit einer Verfahrenskonfiguration wird festgelegt, wie ein Verfahren aufgebaut ist. Anhand eines Beispiels wird im Folgenden die Struktur einer Verfahrenskonfiguration beschrieben.

Gesamtansicht des Beispiels

Hinweis: Neben dem Code der Verfahrenssteuerung (Zeile 3) ist die Fachdomäne anzugeben, hier "KommunaleBauleitplanung" (fehlt im Screenshot). Die Zeile muss lauten <verfahrenssteuerung code="999999" fachdomaene="KommunaleBauleitplanung">

Erläuterung der einzelnen Abschnitte

Im Folgenden sind die einzelnen Abschnitte des Screenshots beschrieben. Die Zeilenangabe bezieht sich auf die im Screenshot sichtbare Zeilennummerierung auf der linken Seite.

Headerbereich (Zeile 1-2)

Abschnitt mit Metadaten zur VK

Verfahrenssteuerung (Zeile 3)

Es können beliebig viele Verfahrenssteuerungstypen angelegt werden, eine je Verfahrenskonfiguration. Im DiPlanCockpit Basis sind zur Konfiguration nur Plan- und Verfahrensarten anzugeben bzw. relevant.

Jeder Verfahrenssteuerungstyp wird selbst unter einer eigenständigen Bezeichnung mit einem Code definiert. Der Code referenziert auf einen Eintrag der Codeliste Code.Verfahrenssteuerung. Wenn man einen neuen Verfahrenssteuerungstyp verwenden möchte, dann benötigt man dafür eine neue Verfahrenskonfiguration und die Codeliste Code.Verfahrenssteuerung muss um den Code erweitert werden.

Zuständigkeit (Zeilen 4-5)

Die Angabe einer oder mehrerer Zuständigkeiten schränkt die Verfügbarkeit der VK ein. Sie steht dann nur für die aufgeführten Zuständigkeiten zur Auswahl. Wenn keine Zuständigkeit in der VK genannt ist, dann ist sie für alle verfügbar.

Planarten (Zeilen 6-11)

Hier erfolgt die Angabe der gültigen Planarten für diesen Verfahrenssteuerungstyp. Dafür werden beliebig viele Einträge aus der Codeliste Code.Planart referenziert. Die angegebenen Planarten sollten fachlich zum Verfahrenssteuerungstyp passen. Zulässige Kombinationen sind im XRepository in der Codeliste Planart aufgeführt. Der Eintrag in der Spalte "Übergeordneter Wert" der Codeliste bezeichnet den passenden Verfahrenssteuerungstyp.

Verfahrensarten (Zeilen 12-15)

Hier sind die gültigen Verfahrensarten für diesen Verfahrenssteuerungstyp angegeben. Dafür werden beliebig viele Einträge aus der Codeliste Code.Verfahrensart referenziert. Auch hier gilt, soll eine neue Verfahrensart verwendet werden, so ist sie hier in der Verfahrenskonfiguration anzugeben und die Codeliste Code.Verfahrensart um den Code zu erweitern.

Optional: Fachdomänenspezifische Ordnerstruktur

Eine konfigurierbare fachdomänenspezifische Ordnerstruktur zum Hochladen der Dokumente kann durch den Mandanten-Administrator über den Abschnitt <dokumentbibliothek> ergänzt werden. Zurzeit ist diese Ordnerstruktur nur für die Fachdomäne Planfeststellung konfiguriert.

Erklärung der Felder:

Name	Zweck
name	Name bzw. Bezeichnung des Ordners (im Frontend für Nutzende sichtbar), darf nicht leer sein und darf pro Ebene nicht doppelt auftauchen.
upload	Gibt an, ob ein Dokumentenupload über den Ordner möglich ist (true) oder nicht (false).
verfahrensunterlagentyp	Der standardmäßig automatisch zugeordnete Verfahrensunterlagentyp für alle Dokumente / Dateien im Ordner.
pflicht	"ja" bedeutet, dass sich mindestens eine Datei im Ordner befinden muss, was im Rahmen der Vollzähligkeitsprüfung für Vorhabens- und Antragsdokumente der Fachdomäne Planfeststellung überprüft wird. "nein" bedeutet, dass der Ordner leer sein darf und keine Auswirkung auf die Vollzähligkeitsprüfung hat.
beschreibung	Textliche Beschreibung der fachlichen Inhalte der Dokumente im Ordner, die für die KI-Prüfung genutzt wird.

Die folgenden Regeln und Einschränkungen müssen beachtet werden:

• Die Ordnerstruktur entspricht einer Baumstruktur (ähnlich wie Windows-Explorer) mit den Ebenen 0 (Wurzel) bis n.
• Die Codeliste der Verfahrensunterlagentypen muss um die für die Ordnerstruktur vorgesehenen Verfahrensunterlagentypen ergänzt und hochgeladen sein, anschließend kann die VK hochgeladen werden.
• Das Attribut verfahrensunterlagentyp darf nicht leer sein und nicht doppelt über die ganze Ordnerstruktur vorkommen.
• Wenn Dokumente innerhalb dieser Ordnerstruktur von einem DiPlan-System (z. B. Vorhaben-Cockpit - Antragsstellung) zu einem andern DiPlan-System (z. B. Behörden-Cockpit - Verfahrens-Verwaltung) übertragen werden, dann muss die Ordnerstruktur in beiden Systemen exakt identisch sein. Dabei muss beachtet werden, dass in den Codelisten die Codewerte für Verfahrensunterlagentypen in beiden Systemen eindeutig sind und keine Widersprüche vorhanden sind.

Optional: Mandanten spezifische Stammdaten

Optional können oberhalb der Verfahrensschritte zusätzliche Mandanten spezifische Stammdaten angegeben werden. Diese ermöglichen die Gestaltung individueller Eingabefelder für die Stammdatenseite. Sie erscheinen auf der Stammdatenseite oberhalb des Abschnitts zu Parallelverfahren in der Reihenfolge, mit der sie in der Verfahrenskonfiguration aufgeführt sind. Ihre Definition erfolgt beispielsweise in der Form <eigenschaft label="Beispiel eines Mandanten spezifischen Feldes zur Eingabe von Text" name="Beispiel6200Text" typ="TEXT" subtyp="SINGLE" pflicht="nein"/>.

Erklärung der Felder:

Name	Zweck
label	Wird als Beschriftung des Feldes angezeigt, kann frei gewählt werden.
name	Technischer Name, muss eindeutig sein, sprich darf nur einmal verwendet werden.
typ	Gibt den Datentyp an. Zulässige Werte sind: TEXT (Freitextfeld mit max. 255 Zeichen), FLOAT (Zahlenfeld für Gleitkommazahlen), INTEGER (Zahlenfeld für ganze Zahlen), BOOLEAN (Checkbox), DATE (Datumsfeld), URL (Link), CODELIST (Dropdown-Auswahl, Inhalte kommen aus einer Codeliste)
subtyp	Muss aktuell immer den Wert SINGLE haben.
pflicht	Gibt an, ob das Feld verpflichtend ist (ja oder nein).
codelistName	Nur erforderlich bei Typ CODELIST. Der Wert muss dann lauten: "Code." + Name der Codeliste, z.B. "Code.Zustaendigkeit".

Verfahrensschritt (Zeile 17-32)

Für das DiPlanCockpit Basis ist aus Kompatibilitätsgründen zum DiPlanCockpit Pro lediglich der der VS „9998“ obligatorisch anzugeben, insbesondere um Termine der Stammdatenseite eintragen und speichern zu können. Die mit der Stammdatenseite verknüpften Termine sind für die kommunale Bauleitplanung 0100 (Beschlussdatum), 0200 (Vorweggenehmigung bzw. Planreife gemäß §33 BauGB) und 9300 (Aufhebungsdatum). Der Termin 9300 muss zudem die beiden Eigenschaften "linkPlanzeichnung" und "linkBegruendung" des Typs URL haben (fehlt im Screenshot). Die Angabe erfolgt als <eigenschaft name="linkPlanzeichnung" typ="URL"/>, analog für "linkBegruendung".

Für die Fachdomäne Raumordnung sind es die Termine pflicht_9400 (Tag des Inkrafttretens) und pflicht_9450 (Tag des Außerkrafttretens).

Weitere Verfahrensschritte können angegeben werden. Sie stehen dann auf der Stammdatenseite zur Angabe des aktuellen Verfahrensschritts zur Auswahl.

Mandanten spezifische Anpassung als Schritt-Anleitung

1. Schritt: Konzeption

Sichten der 3 vorhandenen Codelisten

• Verfahrenssteuerung (entspricht dem Verfahrenstyp)
• Planart
• Verfahrensart

Auswahl und Dokumentation der individuell passenden Optionen.

Wenn keine Anpassung der änderbaren Codelisten (Verfahrenssteuerung und Verfahrensart) anliegt, geht es mit dem 2. Schritt weiter. Wenn Codelisten angepasst werden sollen, erfolgt dies zuerst nach der Schritt-Anleitung für Codelisten. Erst danach steht der 2. Schritt dieser Anleitung an.

2. Schritt: Anpassen der Verfahrenskonfiguration

Das Beispiel im obigen Screenshot dient als Kopiervorlage, die 1..n-fach vervielfältigt und angepasst werden kann. Im Code finden sich Kommentare, die die Dokumentation ergänzen.

Hinweis: Es ist sinnvoll, für die Anpassung ein IDE Tool zu verwenden wie Visual Studio Code oder IntelliJ, um den Code im Hintergrund laufend validieren zu lassen. (IDE = Integrierte Entwicklungsumgebung). Die Prüfung der Formatierung lässt sich per „Shift + Alt + L“ anstoßen.

Die Verfahrenssteuerung wird über ihren Code angegeben und bildet das Element auf der obersten Ebene. Darin werden die zugehörigen Planarten und Verfahrensarten aufgeführt. Es können beliebig viele verschiedene Plan- und Verfahrensarten sein. Sie werden jeweils einzeln ebenfalls über ihren Code angegeben. Die Codes müssen in der jeweiligen Codeliste vorhanden sein.

Auf die Verfahrensart folgt der Abschnitt zur Zeitplanung. Im DiPlanCockpit BASIS steht die Zeitplanung nicht zur Verfügung. Deswegen entfällt dieser Abschnitt inklusive des Monitoring für BASIS und ist entsprechend nicht in der dargestellten VK enthalten.

Es folgt in BASIS direkt auf die Verfahrensart eine Auflistung der Verfahrensschritte (VS) für den definierten Verfahrenstyp. Jeder VS wird dabei wieder einzeln über seinen Code aufgeführt, der in der Codeliste Code.Verfahrensschritt enthalten sein muss. Im Cockpit Basis stehen keine Aufgaben zur Verfügung. Durchgänge von VS sind nur in Zusammenhang mit Aufgaben zu bearbeiten, deswegen erfolgt im DiPlanCockpit BASIS für jeden Verfahrensschritt die Angabe durchgaenge=“nein“: Das heißt, es sind keine Durchgänge vorgesehen.

Der VS „9998“ ist verpflichtend, um Termine auf der Stammdatenseite hinterlegen zu können. Dies trifft auch auf den darunter stehenden Verfahrensteilschritt (VTS) „9998“ mitsamt darunter liegenden Termine zu.

Das vorliegende Element zur Verfahrenssteuerung kann beliebig häufig kopiert und angepasst werden, so dass sich pro Verfahrenstyp individuelle Konfigurationen vornehmen lassen.

3. Schritt: Hochladen ins DiPlanCockpit

Das Hochladen der angepassten Verfahrenskonfiguration erfolgt im Admin-Bereich im Reiter Konfiguration, den Nutzer mit der Rolle M-A-Basis aufrufen können.

Ergänzung

Für die änderbaren Codelisten

• Code.Verfahrensschritt
• Code.Verfahrensteilschritt

sind die Codes „9998“ Pflicht-Einträge, um Termine auf der Stammdatenseite eintragen und speichern zu können. Daher müssen sie auch bei einer Mandanten spezifischen Anpassung erhalten bleiben. Hier der passende Code-Schnipsel aus Code.Verfahrensschritt:

Weitere Infos finden sich in der Schritt-Anleitung zur Anpassung von änderbaren Codelisten.