Mit dieser Schnittstelle können Einsatzdaten sowie Statusmeldungen von Einsatzmitteln von EDP an Alamos FE2 und von Alamos FE2 an EDP übergeben werden. Für die Nutzung der Schnittstelle stellt jeweils jedes System einen Webserver bereit, an den das jeweils andere System die Daten sendet. Die Schnittstelle ist für den Betrieb in einem lokalen Netzwerk, sowie mit einem externen Netzwerke konzipiert.

✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.

Folgende Konfiguration gilt ab Version 2.27 von Alamos

Innerhalb von Alamos ist für den Empfang von Daten die EDP4 - Alamos Alarmeingang zu verwenden.

Die Schnittstelle wird in EDP über den folgenden Dialog konfiguriert:

Die Konfiguration der EDP4 Schnittstelle in Alamos hätte wie folgt auszusehen. Die Absenderkennung ist im EDP-Server als Sender-ID zu hinterlegen. Soll Alamos nur Alarme aus dem eigenen Netzwerk empfangen muss das Häkchen bei „ Nur lokale Verbindungen zulassen“ gesetzt werden. Auf der Seite Alarmierung kann eine Standard-Einheit ausgewählt werden.

Eine mögliche Konfiguration sieht folgt aus:

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 EDP4 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.

Um einen Einsatz der in Alamos angelegt/verarbeitet wurde an EDP übergeben zu können, muss in der jeweiligen Einheit einen Alarmablauf erstellt werden. Dafür muss auf in der Ansicht der Einheiten bei der jeweiligen Einheit auf „Bearbeiten“ geklickt werden. Es öffnet sich nun das Fenster für die Alarmabläufe. Auf der rechten Seite suchen wir nun das Plugin „EDP4“.

Eine Beispielkonfiguration für das EDP4 Plugin finden Sie nachfolgend:

Der in der Alamos Schnittstelle (EDP-Server) eingestellte lokale Port muss in der Firewall des EDP-Servers freigegeben werden!

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.

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=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

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=data.custom.abek

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:

• 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.

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

Damit dieser Webserver eine SSL-Verschlüsselung nutzt, müssen die Zertifikatsdateien alamos.cer und alamos.key im Verzeichnis der Schnittstelle abgelegt sein. Dann muss der Webserver über https angesprochen werden.

Eine Anleitung zum erstellen eines SSL-Zertifikats finden Sie im nachfolgenden Link: Anleitung zum Erstellen eines Zertifikats

Innerhalb des von Alamos an EDP übergebenen Datensatzes ist auch ein authorization-Block enthalten, in dem von Alamos ein Token mitgesendet wird.

..."authorization":"sdmd89sud89d",...

Dieses Token muss in der Konfiguration der Schnittstelle unter „Auth Alamos“ angegeben sein. Alternativ kann dieses Feld in der Konfiguration auch komplett geleert werden, so dass dann jedes Request akzeptiert wird. Der o.g. Fehler entsteht dann, wenn von Alamos ein anderes Token übermittelt wird, als in EDP hinterlegt ist. Hierbei handelt es sich um ein bewusstes Verhalten der Schnittstelle.