Schnittstelle Alamos ARIX v3
Bitte beachten Sie, dass für die Schnittstelle die Exe-Datei mit dem Namen Schn_Alamos_V3.exe verwendet werden muss.
Download
Die Schnittstelle kann hier heruntergeladen werden: Schnittstelle Alamos V3
Die Schnittstelle verbindet sich per Websocket zum FE2-Server (Alamos). Über diese bestehende Websocket-Verbindung werden die Informationen ausgetauscht.
Über die Websocket-Verbindung können derzeit folgende Informationen ausgetauscht werden:
| Funktion | Daten senden | Daten empfangen |
|---|---|---|
| Einsatzdaten | ✔ | ✔ |
| Statusmeldungen | ✔ | ✔ |
| Positionsmeldungen | ✔ | ✔ |
| ETB-Einträge / Fotos | ✔ | ✔ |
| Lagekartenelemente | ✘ | ✔ |
| Patientendaten | ✔ | ✔ |
| Besatzungsstärke | ✔ | ✔ |
| Stammdaten (Stichwörter, Fahrzeuge, Helfer, Kontakte, Alarmobjekte) | ✘ | ✔ |
✔ = Die Schnittstelle unterstützt diese Funktion.
✘ = Wird derzeit nicht unterstützt.
Konfiguration
Folgende Konfiguration gilt ab FE2-Version 2.41 von Alamos
Die Konfiguration der Schnittstelle in EDPerfolgt über einen zentralen Dialog mit mehreren Reitern:
- Grundkonfiguration
- Datenaustausch
- Einsatzmittel
- Suchen-und-Ersetzen
- Stammdaten-Sync
- Feldzuordnung JSON-Path
Ü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. Wichtig ist zudem dass ihr EDP System den FE2 Server per Websocketverbindung erreichen kann.
Reiter: Grundkonfiguration
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. Websocket müssen erlaubt sein. |
| Auth.-Alamos | Geben Sie an dieser Stelle die im FE2-Alarmeingang generierte Absenderkennung an. |
| Zusätzliche in „custom“ in Richtung Alamos zu sendende Felder (Tabelle EINSAETZE) | Hier können weitere EDP-Felder aus der Tabelle EINSAETZE angegeben werden, die zusätzlich im Block custom an Alamos übermittelt werden sollen. Syntax: Feldname edp=Bezeichnung in der Übermittlung,Feld2=… |
| Statusmeldungen automatisch an Alamos weitergeben | Ist diese Einstellung aktiv, werden Statusmeldungen aus EDP heraus automatisch an Alamos übergeben. |
| Positionsmeldungen automatisch an Alamos weitergeben | Ist diese Einstellung aktiv, werden Positionsmeldungen von Einsatzmitteln aus EDP heraus automatisch an Alamos übergeben. |
| Erweitertes Logging (Debug) | Aktiviert eine ausführlichere Protokollierung der Schnittstelle zu Diagnosezwecken. Sollten sie ein Fehler in der Schnittstelle melden, aktivieren sie bitte dieses Feld und reproduzieren sie den Fehler damit er vollständig dokumentiert werden kann. |
Reiter: Einsatzmittel (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ätzlich steht auf diesem Reiter folgende neue Option zur Verfügung:
| Option | Beschreibung |
|---|---|
| Unbekannte EM als Fremdfahrzeug anlegen | Ist diese Option aktiv, werden Einsatzmittel, die von Alamos übermittelt werden, aber nicht in EDP vorhanden sind, automatisch als Fremdfahrzeug angelegt, anstatt ignoriert zu werden. |
Reiter: Suchen-und-Ersetzen
Dieser Reiter ist neu und ermöglicht eine generelle Suchen-und-Ersetzen (Replace)-Funktion, die auf das gesamte JSON-Struct von Alamos angewendet wird – unabhängig von der feldbezogenen Zuordnung im Reiter „Feldzuordnung JSON-Path„ oder der einsatzmittelbezogenen Regel im Reiter „Einsatzmittel“.
Aufbau der Replace-Regel:
Alter Text:=Neuer Text
Damit lassen sich z. B. abweichende Schreibweisen oder unerwünschte Zeichenketten im kompletten von Alamos übermittelten JSON-Datensatz vor der Weiterverarbeitung durch EDP korrigieren.
Reiter: Stammdaten-Sync
Neu in dieser Version ist die Möglichkeit, Stammdaten direkt aus Alamos FE2 in die EDP-Datenbank zu synchronisieren.
Folgende Stammdaten können synchronisiert werden:
- Stichwörter
- Fahrzeuge
- Helfer
- Kontakte
- Alarmobjekte
Jede Kategorie kann einzeln über die entsprechende Schaltfläche synchronisiert werden. Über die Schaltfläche „Alle synchronisieren„ werden alle Kategorien in einem Schritt aktualisiert. Neben jeder Kategorie wird die aktuell in EDP hinterlegte Version der jeweiligen Stammdaten angezeigt (z. B. „Stichwörter: Version 0“).
Die Stammdaten-Synchronisation ersetzt nicht die Feldzuordnung für einzelne Einsätze, sondern hält die EDP-Stammdaten (z. B. Fahrzeuge, Kontakte, Alarmobjekte) im Hintergrund mit Alamos FE2 aktuell. Um Einsatzmittel synchronisieren zu können, dürfen zum Zeitpunkt der Synchronisation keine Einsatzmittel in Einsätzen gebucht sein.
Reiter: Datenaustausch
Über diesem Reiter wird gesteuert, welche Daten im Detail zwischen EDP und Alamos ausgetauscht werden.
Einsatz
| Option | Beschreibung |
|---|---|
| Einsätze von Alamos empfangen und verarbeiten | Neue bzw. geänderte Einsätze aus Alamos werden von EDP übernommen und verarbeitet. |
| Einsätze aus edp: automatisch an Alamos senden + aktualisieren (inkl. EM Zuteilung) | In EDP angelegte oder geänderte Einsätze werden automatisch inklusive der zugeteilten Einsatzmittel an Alamos übergeben. Unabhängig davon ob es für den Einsatz eine entsprechende Aktion gibt oder nicht. |
| Einsätze automatisch in edp schließen, wenn Alarm in Alamos geschlossen wird | Wird ein Alarm in Alamos geschlossen, wird der zugehörige Einsatz in EDP ebenfalls automatisch geschlossen. |
| Einsatzabschluss aus edp: an Alamos senden | Der Abschluss eines Einsatzes in EDP wird an Alamos übergeben. |
Einsatzdokumentation
| Option | Beschreibung |
|---|---|
| ETB Einträge von Alamos abrufen (via Modul Lagekarte / aMobile) * | ETB-Einträge, die z. B. über die Lagekarte im aMobilePro erfasst wurden, werden von Alamos abgerufen. |
| Auch vertrauliche ETB-Einträge von Alamos auslesen | Zusätzlich werden auch als vertraulich markierte ETB-Einträge aus Alamos übernommen. |
| ETB Einträge automatisch an Alamos weitergeben | In EDP erfasste ETB-Einträge werden automatisch an Alamos übergeben und dort in die Lagekarte des Einsatzes geschrieben. |
| Lagekartenelemente von Alamos empfangen | Von Alamos übermittelte Lagekartenelemente werden in EDP übernommen. Hierüber können Taktische Zeichen und Zeichnungen übernommen werden. |
Patientendaten
| Option | Beschreibung |
|---|---|
| Patientendaten aus Alamos auslesen | Von Alamos übermittelte Patientendaten werden in EDP übernommen. |
| Patientendaten an Alamos senden |
Wichtig: Sie müssen zwingend *eindeutige Patientennummern* verwenden. Eine Änderung von Patientennummern führt bei aktiver Schnittstelle zu Fehlern.
Besatzungsstärke
| Option | Beschreibung |
|---|---|
| Besatzungsstärke von Alamos auslesen | Die in Alamos gesetzte Besatzungsstärke wird zu EDP übertgragen. |
| Besatzungsstärke an Alamos senden | Die in EDP hinterlegte Besatzungsstärke wird an Alamos übertragen. |
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 (Reiter: Feldzuordnung JSON-Path)
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. Wenn sie die Stichworte über die Stammdatensynchronisation übernehmen sind hier keine Änderungen notwendig.
Standardmäßige Feldzuordnungen (Stand aktuelle Version):
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
JSON-Path für EINSATZ_FREIGABE
Zusätzlich kann auf diesem Reiter ein eigener JSON-Path für das Feld EINSATZ_FREIGABE hinterlegt werden. Darüber wird angegeben, unter welcher Benutzerrolle ein über die Schnittstelle angelegter Einsatz in EDP freigegeben werden soll.
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. |
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
Zusätzliches Ziel (FE2-Server (Alamos) → EDP)
Damit Fahrzeugpositionen, Statusmeldungen 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.