60 lines
3.9 KiB
Markdown
60 lines
3.9 KiB
Markdown
# BNV - Formular (Benutzerverwaltung) Justiz - README
|
|
**_(c) ZenIT - Zentraler IT-Dienstleister der Justiz d. Landes Brandenburg_**
|
|
|
|
**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.
|
|
Ggf. `data-areas` setzen falls die Sichtbarkeit zusätzlich eingeschränkt werden soll.
|
|
3. **JavaScript - Die Logik:**
|
|
In der Funktion `refreshForm()` zwei Dinge tun:
|
|
1. _Die Checkbox abfragen:_ `const boxXY = document.getElementById('cbFachXY');`
|
|
2. _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 eingetragen 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 sich 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
|
|
### Version-Logik
|
|
Die Versionen zum Vergleichen sind **immer** ganze Zahlen.
|
|
Das bedeutet eine Version 1.2 ist 12 bei der Prüfung (1.2 = 12). Wenn im folgenden von -2 Versionen gesprochen wird, ist somit die Versionsnummer hinter dem **.** gemeint!
|
|
### 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_.
|
|
### Version-Dokumentation
|
|
Die Versionssteuerung erfolgt an **2 Stellen**.
|
|
1. Im Formular muss die Version gepflegt werden.
|
|
2. Auf der Intranet-Seite **justiz-info muss** `version_check.js` angepasst werden.
|
|
#### Version hinterlegen
|
|
1. Im Formular `APP_VERSION_ID` entsprechend anpassen (es werden nur ganze Zahlen akzeptiert [Version 1.7 = 17])
|
|
2. in `version_check.js` `window.REMOTE_VERSION_ID = 16;` eintragen & die Zahl mit der entsprechenden Versionsnummer ersetzen z.B. `17`
|
|
3. `version_check.js` auf die Intranet-Seite (justiz-info) als Media hochladen, vorhandene Datei ersetzen (_Hr. Seidel Ansprechpartner_)
|
|
|