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 einen technisch geänderten Aufbau. edp: verbindet sich per Websocket zum FE2-Server (Alamos). Über diese bestehende Websocket-Verbindung werden die Informationen ausgetauscht. Dadurch ist es im Vergleich zur Version 1 nicht länger erforderlich, dass für das EDP-System ein eigener Webserver bereitgestellt werden muss, der vom FE2-Server (Alamos) erreichbar ist um Daten zu senden.
Ü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.
Konfiguration
Folgende Konfiguration gilt ab FE2-Version 2.37 von Alamos
Übergabe an Alamos
Innerhalb von Alamos ist für den Empfang von Daten der EDPv2 - Alarmeingang zu verwenden. Bei der Einrichtung wird ihnen innerhalb FE2 eine Absenderkennung generiert. Diese wird zur Einrichtung der Schnittstelle in EDP benötigt.
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 die im FE2-Alarmeingang generierte Absenderkennung an. |
| Statusmeldungen automatisch an Alamos weitergeben | Ist diese Einstellung aktiv, wird ein Status aus EDP heraus automatisch an Alamos übergeben. |
| Positionemeldungen automatisch an Alamos weitergeben | Ist diese Einstellung aktiv, werden Positionsmeldungen aus EDP heraus automatisch an Alamos übergeben. |
Aus EDP heraus im FE2-Server (Alamos) alarmieren
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 der Einheitencode der Einheit (aus dem FE2-Server) angegeben, die alarmiert werden soll. Was sind Einheiten-Codes (FE2-Server /Alamos)
Möchten sie grundsätzlich immer die gleiche Einheit in FE2 alarmieren. Können sie diese im Alarmeingang des FE2-Server markieren. Die genaue Funktionalität des EDPv2-Alarmeingang wir hier beschreiben
Feldzuordnung EDP <> Alamos
Übergabe von EDP an Alamos
Die Feldzuordnung bei einer Einsatzübergabe von EDP an Alamos erfolgt fix über die Standard-Felder von Alamos. Eine manuelle Anpassung ist hier nicht möglich.
Übernahme von Alamos in EDP
Bei der Datenübernahme von Alamos in EDP kann die Feldzuordnung flexibel per JSON-Path in EDP konfiguriert werden.
Stichwort-Rückwärtssuche: Bei der Einsatzanlage über die Schnittstelle gleicht EDP den von Alamos übermittelten Stichwort-Klartext automatisch mit den Stammdaten ab. Wird eine Übereinstimmung gefunden, werden Einsatzart und Stichwort direkt aus den Stammdaten übernommen. Eine separate Zuordnung ist dann nicht erforderlich.
Standardmäßige Feldzuordnungen:
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
Feldzuordnung anpassen
Die Standardzuordnung kann jederzeit flexibel angepasst oder um eigene Felder erweitert werden.
Beispiel: Das Feld abek aus dem Custom-Block soll in das EDP-Feld SCHLAGWORT (Meldebild) übernommen werden:
SCHLAGWORT=payload.custom.abek
Statusauswertung
Aufgrund der vielen unterschiedlichen Konfigurationsmöglichkeiten von Alamos können verschiedene Daten zur Statusauswertung an EDP übergeben werden. EDP wertet diese nach folgendem Schema aus:
| Schritt | Prüfung | Ergebnis |
|---|---|---|
| 1 | Ist der übergebene Datenstring eine ISSI? | ✔ Ja → wird direkt zur Statusauswertung herangezogen. ✘ Nein → weiter mit Schritt 2. |
| 2 | Ist der Funkrufname deckungsgleich mit einem Einsatzmittel in der EDP-Datenbank? (gilt auch bei mehreren ISSIs mit Trennzeichen) | ✔ Ja → weiter mit Schritt 3. ✘ Nein → Status wird nicht ausgewertet. |
| 3 | Ist dem Einsatzmittel eine ISSI zugeordnet und sind die Haken „Statusmeldungen auswerten„ und „primäres Fahrzeugfunkgerät“ gesetzt? | ✔ Ja → Status wird ausgewertet. ✘ Nein → Status wird nicht ausgewertet. |
Replace-Regel für Einsatzmittel
Die Replace-Regel greift ausschließlich auf die Rufnamen der Einsatzmittel zu. Die Alamos-Schnittstelle geht davon aus, dass der von Alamos übermittelte Rufname identisch in EDP vorhanden ist.
Falls die Rufnamen abweichen, kann die Replace-Regel zur Anpassung genutzt werden:
RufnameAlamos:=RufnameEDP
Zusätzliches Ziel (FE2-Server (Alamos) → EDP)
Damit Fahrzeugpositionen und Lagemeldungen an EDP übertragen werden können, muss in Alamos innerhalb der jeweiligen Organisation ein zusätzliches Ziel mit dem angelegten„EDP v2 Alarmeingang„ eingerichtet sein.