63 lines
3.7 KiB
Markdown
63 lines
3.7 KiB
Markdown
#########################################################################
|
|
# #
|
|
# 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)
|
|
|