Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:ansteuerungen:alamos [2023/06/20 18:05] – admin
+++ server:ansteuerungen:alamos [2024/11/05 14:42] (aktuell) – [Statusauswertung] admin
@@ Zeile 19: / Zeile 19: @@
 Die Schnittstelle wird in EDP über den folgenden Dialog konfiguriert:
-{{ :server:schnittstelle:alamos:edp-konfig.png?nolink&600 |}}
+{{ :server:ansteuerungen:alamos_konfig.jpg |}}
@@ Zeile 57: / Zeile 57: @@
 |**Authentifizierung** | Authentifizierung gegenüber EDP4, dieser Wert muss mit der Eingabe im Feld "Auth.-Alamos" in der Konfiguration der Alamos Schnittstelle im EDP-Server übereinstimmen. |
-<note important>Der in der Alamos Schnittstelle (EDP-Server) eingestellte lokale Port muss in der Firewall des EDP-Servers freigegeben werden!</note>
+Der in der Alamos Schnittstelle (EDP-Server) eingestellte lokale Port muss in der Firewall des EDP-Servers freigegeben werden!
-<note>Die Einsatzdatenübergabe von Alamos an EDP4 kann auch von einem externen Netzwerk geschehen. Hierfür benötigt man eine feste IP-Adresse vom Internetanbieter, oder eine Domain mit DynDNS. Im Router muss dann eine Portweiterleitung des eingestellten Lokalen-Ports in der Alamos-Schnittstelle auf den EDP-Server erfolgen.</note>
+Die Einsatzdatenübergabe von Alamos an EDP4 kann auch von einem externen Netzwerk geschehen. Hierfür benötigt man eine feste IP-Adresse vom Internetanbieter, oder eine Domain mit DynDNS. Im Router muss dann eine Portweiterleitung des eingestellten Lokalen-Ports in der Alamos-Schnittstelle auf den EDP-Server erfolgen.
 ==== Feldzuordnung EDP <> Alamos ====
-Die Felder aus Alamos werden wie folgt in EDP übernommen:
+**Die Feldzuordnung bei einer Einsatzübergabe von EDP an Alamos erfolgt fix über die Zuordnung der Standard-Felder von Alamos.**
-^Feldbezeichnung Alamos   ^ Feldname EDP  ^
+Bei der Datenübernahme von Alamos in EDP kann für das JSON-Struct, das von Alamos an EDP gesendet wird, per JSON-Path eine Feldzuordnung flexibel in EDP konfiguriert werden.
-| data.message  | Meldung  |
-| data.externalId | EXTERNAL_ID |
-| data.location.city | Ort |
-| data.location.city_abbr | Ortsteil |
-| data.location.street | Straße |
-| data.location.house | Hausnummer |
-| data.location.building | Objektname |
-| data.location.postalCode | PLZ |
-| data.location.coordinate | Koordx / Koordy |
-| data.caller.name | Meldender |
-| data.caller.contact | Telefonnummer Meldender |
-| data.custom.remark | Bemerkung |
-| data.keyword_description | Feldzuordnung entsprechend der Konfig |
-| data.keyword | Feldzuordnung entsprechend der Konfig |
-Da aus Alamos keine explizite Übergabe von Einsatzart und Stichwort in Kurzform erfolgt, wie sie in EDP verwendet wird, sollte das Stichwort aus Alamos in das Feld STICHWORT_KLARTEXT von EDP übernommen werden. Bei Einsatzanlage über die Schnittstelle erfolgt hier eine Rückwärtssuche. D.h. wenn mit dem von Alamos übermittelten Stichwort-Klartext ein Datensatz in den Stammdaten von EDP vorhanden ist, werden Einsatzart und Stichwort von dort in den Einsatz übernommen.
+Bei Einsatzanlage über die Schnittstelle erfolgt hinsichtlich des Stichwort-Klartexts eine Rückwärtssuche. D.h. wenn mit dem von Alamos übermittelten Stichwort-Klartext ein Datensatz in den Stammdaten von EDP vorhanden ist, werden Einsatzart und Stichwort von dort in den Einsatz übernommen. Daher ist die Zuordnung eines Stichwort-Klartexts ausreichend, wenn die von Alamos übermittelten Daten deckungsgleich mit den Stammdaten in EDP sind.
+Die folgenden Feldzuordnungen erfolgen standardmäßig:
+<code>
+MELDUNG=data.message
+EXTERNAL_ID=data.externalId
+ORT=data.location.city
+ORTSTEIL=data.location.city_abbr
+STRASSE=data.location.street
+HAUSNUMMER=data.location.house
+OBJEKTNAME=data.location.building
+PLZ=data.location.postalCode
+KOORDX=data.location.coordinate[0]
+KOORDY=data.location.coordinate[1]
+MELDENDER=data.caller.name
+MELDEWEG_TELEFON=data.caller.contact
+STICHWORT_KLARTEXT=data.keyword
+SCHLAGWORT=data.keyword_description
+</code>
+Die o.g. Konfiguration kann flexibel angepasst oder erweitert werden. Soll beispielsweise das Feld "abek" aus dem Custom-Block in das Feld "SCHLAGWORT" (Meldebild) von EDP übernommen werden, müsste folgender Eintrag ergänzt bzw. angepasst werden:
+<code>
+SCHLAGWORT=data.custom.abek
+</code>
 ==== Statusauswertung ====
@@ Zeile 89: / Zeile 99: @@
   * Falls ja: wird diese zur Statusauswertung herangezogen.
-Ist der übergebene Datenstring keine Issi:
+Ist der übergebene Datenstring keine ISSI (das gilt auch dann, wenn mehrere ISSIs hintereinander inkl. Trennzeichen übermittelt werden):
   * Ist der übergebene Funkrufname deckungsgleich zu einem Funkrufnamen eines Einsatzmittels in der EDP-Datenbank?
   * Falls ja: Ist dem Einsatzmittel eine Issi zugeordnet und dort die Haken "Statusmeldungen auswerten" und "primäres Fahrzeugfunkgerät" gesetzt? Sollte das nicht der Fall sein, würde ein Status nicht ausgewertet werden.
-===== Replace-Regeln =====
-Im Rahmen der Konfiguration können zusätzlich noch Replace-Regeln für die Einsatzdaten sowie für die Einsatzmittel genutzt werden. Der Aufbau einer Replace-Regel folgt immer folgendem Schema:
-<code>
-Alter Wert:=Neuer Wert
-</code>
-Die Replace-Regel für die Einsatzdaten wird auf das gesamte Datenkonstrukt, das von Alamos übermittelt wird, angewendet. D.h. es ist hierüber auch möglich Feldzuordnungen zu ändern. Wenn beispielsweise von Alamos im Feld data.test ein Wert übermittelt wird, den EDP als Stichwort nutzen soll, kann die folgende Regel genutzt werden, um das eigentliche für das Stichwort genutzte Feld umzubenennen und das Feld data.test entsprechend dem Keyword zuzuweisen:
-<code>
-keyword:=ohneVerwendung
-test:=keyword
-</code>
-Ebenso greift die Regel natürlich auch für die Inhalte der Felder. Soll aus "Musterberg-1" nur der Text "Musterberg" genutzt werden, kann folgende Regel ergänzt werden:
-<code>
-Musterberg-1:=Musterberg
-</code>
 ==== Replace-Regel für Einsatzmittel ====
@@ Zeile 130: / Zeile 122: @@
 ====== Häufige Probleme / Fehler ======
-====== Request abgelehnt - Authentifizierung fehlgeschlagen =====
+==== Request abgelehnt - Authentifizierung fehlgeschlagen ====
 Innerhalb des von Alamos an EDP übergebenen Datensatzes ist auch ein authorization-Block enthalten, in dem von Alamos ein Token mitgesendet wird.