fraport/fradrive-old
fraport/fradrive-old
Archived
3
1
Fork 0
Code Issues 65 Pull Requests 5 Actions Packages Projects Releases 197 Wiki Activity

Create FRADrive Übersicht/Schnittstellenbeschreibungen/AVS VSM/Fahrlizenz Synchronisierung

Steffen Jost 2024-09-02 15:50:04 +00:00
parent c5d9a20e2e
commit 8a0cf7e338
1 changed files with 33 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
FRADrive-Übersicht/Schnittstellenbeschreibungen/AVS-VSM/Fahrlizenz-Synchronisierung.md Normal file

@ -0,0 +1,33 @@
Ab Version 27.4.77 kann die Synchronisierung der Fahrlizenzen zwischen AVS und FRADrive automatisiert werden. Konflikte werden immer zugunsten von FRADrive aufgelöst, d.h. es werden nur die AVS gespeicherten Fahrlizenzen angepasst. Die Automatik betätigt also prinzipiell die Knöpfe auf `/admin/problems/avs`.
## Einstellungen
Es gibt vier Einstellmöglichkeiten:
```
avs-licence-synch:
times: [6,16]
level: 2
reason-filter: 'firm'
max-changes: 50
```
1. `times`: Eine Listen mit Stundenwerten, zu denen der Synch ausgeführt werden soll. Der Synch beginnt dann immer um x:02:27 Uhr. Eine automatische Synchronisation wird nur Montag-Freitag durchgeführt; aber auch an Feiertagen (TODO).
2. `level`: Level des Synchs, das höhere Level schließt immer das niedrigere Level mit ein:
- **Level 0**: Kein Synch
- **Level 1** Nur Entzug der Vorfeld Lizenzen, entspricht der untersten Tabelle auf `/admin/problems/avs`, ausgenommen Inhaber von R Lizenzen im AVS, d.h. es wird kein R komplett entzogen
- **Level 2** Vorfeld Lizenzen werden automatisch gewährt, entspricht der zweit untersten Tabelle der Admin-AVS-Synch-Seite.
- **Level 3** R-Lizenzen werden komplett entzogen oder zu F-Lizenzen herabgestuft (2. Tabelle von oben)
- **Level 4** R-Lizenzen werden gewährt. (1. Tabelle)
- **Level 5** Alles wird synchronisiert, Filterung wird ignoriert (siehe nächsten Punkt)
3. `reason-filter`: Ein regulärer Ausdruck zur Filterung der Block-Gründe in der Datenbank.
*Beispiel:* `'firm'` setzt die Automatik für alle Lizenzänderungen durch Block/Unblock außer Kraft,
deren Begrüdung die Buchtsabenfolge `firm` enthält. Groß-/Kleinschreibung wird ignoriert. Komplexe
reguläre Ausdrücke sind möglich, es muss aber sichergestellt sein, dass die regulären Ausdrücke korrekt
formuliert sind, z.B. eine fehlende schließende Klammer im regulären Ausdruck verhindert den kompletten
Synch aller Lizenzen.
4. `max-changes`: Der Synch von Lizenzen wird nur dann ausgeführt, wenn es weniger Änderungen sind. *Achtung:* Diese Zahl gilt pro Level, d.h. bei einem Limit von 50 können 50 Vorfeld Lizenzen automatisch gewährt werden, während der Entzug von 51 Vorfeld Lizenzen nicht automatisch durchgeführt wird.
Die Angabe von `reason-filter` und `max-changes` ist optional. Ohne Angabe gibt es keine Filterung und die Änderungen sind unbegrenzt.
Fehler werden nur in den Azure Logs verzeichnet. Admins sehen aber auf der Problemübersichtsseite, dass Synchs notwendig sind, da Konflikte zwischen AVS und FRADrive nicht aufgelöst werden.
Falls das AVS nicht erreichbar/verfügbar ist, passiert einfach nichts und der Synch wird übersprungen. Erst zur nächsten festgelegten Zeit wird erneut ein Synch versucht.