Einwohnerkontrollsystem (einwohnerkontrollsystem)

Autoren der Dokumentation: Björn Scheppler

Dokumentation letztmals aktualisiert: 6.10.2019

Dieses Projekt simuliert ein Einwohnerkontrollsystem einer Gemeinde, welches von der Umzugsplattform benötigt wird.

Beschreibung der Funktionalität

Bezüglich technischer Implementation folgt dieses Projekt 1:1 dem async-messaging-external-system in https://github.com/zhaw-gpi/async-rest-messaging. Daher hier nur eine inhaltliche Beschreibung, was geschieht:

1. Sobald der REST-Endpoint http://localhost:8065/eksapi/v1/platformmove/ mit einem POST-Request, enthaltend eine eCH-194 PlatformMoveOut-Nachricht, aufgerufen wird...
2. Gibt dieser den Status 200 zurück und führt asynchron eine Methode aus,
3. die einen Mitarbeiter beim Einwohnerkontrollsystem simuliert über folgende Tätigkeiten:
   1. Zwischen 3 bis 30 Sekunden warten
   2. Den Anfangsbuchstaben des Vornamens auswerten: Falls er zwischen A-M liegt, dann wird das Gesuch für den Umzug angenommen (responseCode 1), ansonsten abgelehnt (responseCode 0)
4. Nun wird über die beim POST-Request mitgegebene callbackURL die Umzugsplattform (http://localhost:8081/umzugapi/v1/technicalreceipt/) ebenfalls über einen POST-Request aufgerufen, welchem eine eCH-0058 Technical Receipt-Nachricht mit folgendem Inhalt übermittelt wird:
   1. BusinessKey (aus eCH-194 PlatformMoveOut-Nachricht)
   2. responseCode

Erforderliche Schritte für das Testen der Applikation

Voraussetzungen

Laufende eUmzugsplattform: Denn sonst kann keine Antwort gesendet werden.

Deployment

1. Erstmalig oder bei Problemen ein mvn clean install durchführen
2. Bei Änderungen am POM-File oder bei (Neu)kompilierungsbedarf genügt ein mvn install
3. Für den Start ist ein java -jar .\target\NAME DES JAR-FILES.jar erforderlich. Dabei wird Tomcat gestartet mit den Eigenschaften (application.properties) und die verschiedenen Beans erstellt und konfiguriert.
4. Das Beenden geschieht mit CTRL+C

Nutzung (Testing) der Applikation

In der Umzugsplattform muss ein UmzugMelden-Prozess gestartet werden und bis zum Schritt "Mit EK-Systemen kommunizieren" gelangen. Dann sollte der Rest automatisch laufen.