Dateien nach "/" hochladen

readme.md

@@ -0,0 +1,63 @@
+#########################################################################
+# 																		#
+# BNV - Formular (Benutzerverwaltung) Justiz - README					#
+#																		#
+# (c) ZenIT - Zentraler IT-Dienstleister der Justiz d. Landes Brandenb. #
+#																		#
+# Autor: 	P. Seidel (ZenIT)											#
+# Code:		P. Seidel (ZenIT)											#
+# Test:		M. Schöne (ZenIT)											#
+#																		#
+# Bug-Report:		to P. Seidel (ZenIT)								#
+# Feature Request:	to P. Seidel (ZenIT)								#
+#																		#
+# Release-Notes:	release.md											#
+#																		#
+#########################################################################
+
+I. neue Anwendung
+Wenn eine neue Anwendung (z.B. "Fachverfahren XY") hinzufügt werden soll, müssen immer diese drei Orte angepasst werden:
+
+	1.	### HTML - Die Checkbox: ###
+		Im Bereich row_anwendungen eine neue Checkbox hinzufügen.
+		Wichtig: data-areas setzen, damit nur die richtigen Mandanten sie sehen. (siehe 2. Mandanten-Logik)
+
+			Beispiel: <input type="checkbox" id="cbFachXY" data-areas="OLG,SDJ">
+
+    2.	### HTML - Die Gruppe: ###
+		Einen neuen Container <div class="form-grouping hidden" id="gruppeFachXY"> erstellen, der die speziellen Felder für diese Software enthält.
+
+    3.	### JavaScript - Die Logik: ###
+		In der Funktion refreshForm() zwei Dinge tun:
+			Die Checkbox abfragen: const boxXY = document.getElementById('cbFachXY');
+			Die Sichtbarkeit steuern: if (boxXY && boxXY.checked) { showList.push('gruppeFachXY'); }
+
+
+II.	 Mandanten-Logik (data-areas)
+Jedes Element mit dem Attribut data-areas="OLG,SDJ" wird nur angezeigt, wenn in window.MANDANT = '###' der entsprechende Mandant gewählt wurde.
+
+Wichtig: Wenn ein übergeordneter Container (z.B. eine Zeile oder eine Gruppe) ein data-areas Attribut hat, sind alle Felder darin automatisch mit gesperrt, auch wenn sie selbst kein Attribut haben.
+Der "DEBUG"-Mandant: Dieser sollte in jedem data-areas stehen, damit beim Testen immer alles angezeigt wird.
+
+
+III. wichtige technische Hinweise
+Hinweise die aus der Erstellung des Codes ergeben haben und zum Fehlverfahlten des Formulars führen können:
+	
+	1. Case Sensitivity: JavaScript unterscheidet streng zwischen Groß- und Kleinschreibung. cbDragon ist nicht das gleiche wie cbdragon.
+	2. ID vs. Name:
+			- id wird für das Styling und JavaScript (Sichtbarkeit) genutzt.
+			- name wird für die PDF-Ausgabe genutzt (das ist das Label im PDF).
+	3. Checkboxen im PDF: Einzelne Checkboxen (wie das Headset) werden immer automatisch mit "Ja" übersetzt, wenn kein fester value im HTML steht.
+	4. Datum: Datumsfelder werden beim Auslesen für das PDF automatisch von YYYY-MM-DD in DD.MM.YYYY umgewandelt.
+
+
+IV. Version-Check
+Das Formular prüft beim Start automatisch ob es eine neuere Version von sich gibt. Sollte festgestellt werden, dass:
+	1. die Version -1 alt ist, erscheint am Anfang eine rote Box mit dem Hinweis, dass es eine neuere Version gibt mit entsprechenden Download-Link. Ein Arbeiten ist weiterhin möglich.
+	2. die Version -2 oder älter, erscheint am Anfang eine rote Box mit eindringlichen Hinweis, dass es eine neuere Version gibt mit entsprechenden Download-Link. Ein Arbeiten ist NICHT mehr möglich.
+
+Die Versionssteuerung erfolgt an 2 Stellen. Im Formular muss die Version gepflegt werden. Auf der Intranet-Seite justiz-info muss version_check.js angepasst werden.
+	1. Im Formular APP_VERSION_ID entsprechend anpassen (es werden nur ganze Zahlen akzeptiert [Version 1.7 = 17])
+	2. in version_check.js nur die Versionsnummer eintragen, z.B. 17
+	3. version_check.js auf die Intranet-Seite als Media hochladen, vorhandene Datei ersetzen (Hr. Seidel Ansprechpartner)
+