Hinweis: Die Schnittstelle ist aktuell noch nicht produktiv
Schnittstelle Alamos V2
Bitte beachten Sie, dass für die Schnittstelle die Exe-Datei mit dem Namen „Schn_alamosV2.exe“ verwendet werden muss.
Die Schnittstelle Alamos in der Version 2 besitzt nun einen technischen geänderten Aufbau. edp: verbindet sich per Websocket zum Alamos-Server. Über diese bestehende Websocket-Verbindung werden die Informationen ausgetauscht. Dadurch ist es im Vergleich zur Version 1 der Schnittstelle nicht länger erforderlich, dass für das edp-System ein eigener Webserver bereitgestellt werden muss, an den Alamos Daten sendet.
Über die Websocket-Verbindung können derzeit folgende Informationen ausgetauscht werden:
| Funktion | Daten senden | Daten empfangen |
|---|---|---|
| Einsatzdaten | ✔ | ✔ |
| Statusmeldungen | ✔ | ✔ |
| Positionsmeldungen | ✔ | ✔ |
✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
Konfiguration
Folgende Konfiguration gilt ab Version 2.37 von Alamos
Übergabe an Alamos
Innerhalb von Alamos ist für den Empfang von Daten die EDP - Alamos Alarmeingang zu verwenden.
Die Schnittstelle wird in EDP über den folgenden Dialog konfiguriert:
| Feld | Beschreibung |
|---|---|
| URL Alamos | Angabe der URL, über die die Alamos FE2-Installation erreichbar ist. |
| Auth.-Alamos | Geben Sie an dieser Stelle das im Alamos-Alarmeingang vorhandene Token für die Authentifizierung an. |
| Statusmeldungen automatisch an Alamos weitergeben | Ist diese Einstellung aktiv, wird ein Status aus EDP heraus automatisch an Alamos übergeben. |
Um spezielle Einheiten aus EDP heraus alarmieren zu können muss im EDP-Editor (Datenversorgung) eine Aufgabe angelegt werden. Als Schnittstelle wird die Alamos-Schnittstelle ausgewählt. In den Ergänzenden Daten der Aufgabe wird die ID der Einheit angegeben, die alarmiert werden soll.
Die passende ID der Einheit in Alamos ist ebenfalls über die EDP Schnittstelle im Alarmeingang von Alamos herauszufinden. Hierfür wechseln wir in der Konfiguration der Schnittstelle in Alamos auf den Reiter „Alarmierung“. Hinter den jeweiligen Einheiten ist in einem leichten Grau dann die Einheiten-ID hinterlegt, welche in die Aufgabe der Datenversorgung hinterlegt werden kann.
Feldzuordnung EDP <> Alamos
Die Feldzuordnung bei einer Einsatzübergabe von EDP an Alamos erfolgt fix über die Zuordnung der Standard-Felder von Alamos.
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.
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:
MELDUNG=payload.message EXTERNAL_ID=payload.externalId ORT=payload.location.city ORTSTEIL=payload.location.city_abbr STRASSE=payload.location.street HAUSNUMMER=payload.location.house OBJEKTNAME=payload.location.building PLZ=payload.location.postalCode KOORDX=payload.location.coordinate.lng KOORDY=payload.location.coordinate.lat MELDENDER=payload.caller.name MELDEWEG_TELEFON=payload.caller.contact STICHWORT_KLARTEXT=payload.keyword SCHLAGWORT=payload.keyword_description
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:
SCHLAGWORT=payload.custom.abek
Statusauswertung
Aufgrund der vielen unterschiedlichen Konfigurationsmöglichkeiten von Alamos, könnten verschiedene Daten zur Statusauswertung von Alamos an EDP übergeben werden. Dabei geht EDP grundsätzlich nach dem folgenden Schema vor:
Ist der übergebene Datenstring eine Issi?
- Falls ja: wird diese zur Statusauswertung herangezogen.
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-Regel für Einsatzmittel
Die Replace-Regel für Einsatzmittel greift nur auf die Rufnamen der Einsatzmittel zu. Die Alamos-Schnittstelle geht davon aus, dass der von Alamos übermittelte Rufname auch so in EDP vorhanden ist. Falls das nicht der Fall ist, kann auf die Replace-Regel zurückgegriffen werden, um die Rufnamen anzupassen:
RufnameAlamos:=RufnameEDP