Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:ansteuerungen:alamos [2022/07/11 13:24] – Hendrik Eifert
+++ server:ansteuerungen:alamos [2022/11/09 14:47] (aktuell) – Hendrik Eifert
@@ Zeile 1: / Zeile 1: @@
 ====== Schnittstelle Alamos ======
-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 konzipiert, so dass sich beide Webserver im gleichen Netz befinden sollten.
+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.
 ^ Funktion ^ Daten senden ^ Daten empfangen |
@@ Zeile 8: / Zeile 8: @@
 ✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
+====== Konfiguration ======
+<note important>Folgende Konfiguration gilt ab Version 2.27 von Alamos</note>
+===== Übergabe an Alamos =====
+Innerhalb von Alamos ist für den Empfang von Daten die [[https://alamos-support.atlassian.net/wiki/spaces/documentation/pages/219480370/EDP4|EDP4 - Alamos Alarmeingang]] zu verwenden.
+Die Schnittstelle wird in EDP über den folgenden Dialog konfiguriert:
+{{ :server:schnittstelle:alamos:edp-konfig.png?nolink&600 |}}
+^ Feld  ^ Beschreibung  ^
+|**URL Alamos**   | Angabe der URL, über die die Alamos FE2-Installation erreichbar ist.  |
+|**Sender-ID** | Authentifizierung gegenüber FE2, dieser Wert (Absenderkennung) muss aus der EDP4 Schnittstelle im Alamos Alarmeingang übernommen werden. |
+|**Lokaler Port** | Geben Sie hier den Port an, auf dem die Schnittstelle einen Webserver für Alamos bereitstellen soll. 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.|
+|**Auth.-Alamos**|Authenthifizierung für die Einsatzübergabe von Alamos an EDP. Wird das Feld leer gelassen, wird jeder Request zur Einsatzübergabe an EDP akzeptiert.|
+|**Statusmeldungen automatisch an Alamos weitergeben**|Ist diese Einstellung aktiv, wird ein Status aus EDP heraus automatisch an Alamos übergeben.|
+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:
+{{ :server:schnittstelle:alamos:alamos_alarmeingang_edp4.png?nolink&600 |}}
+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.
+{{ :server:schnittstelle:alamos:datenversorgung_aufgabe_alamos.png?nolink&600 |}}
+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.
+{{ :server:schnittstelle:alamos:alamos_alarmeingang_edp4_alarmierung.png?nolink&600 |}}
+===== Übergabe an EDP4 =====
+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".
+{{ :server:schnittstelle:alamos:edp_einsatzuebergabe.png?nolink&600 |}}
+Eine Beispielkonfiguration für das EDP4 Plugin finden Sie nachfolgend:
+{{ :server:schnittstelle:alamos:alamos_konfig_uebergabe.png?nolink&600 |}}
+^ Feld  ^ Beschreibung  ^
+|**URL**   | Angabe der URL, über die der EDP-Server erreichbar ist. Als Port muss der in der EDP-Konfiguration (Alamos-Schnittstelle) angegebene Lokale Port für den Webserver angegeben werden. |
+|**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>
+<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>
+==== Feldzuordnung EDP <> Alamos ====
+Die Felder aus Alamos werden wie folgt in EDP übernommen:
+^Feldbezeichnung Alamos   ^ Feldname EDP  ^
+| 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.
+===== 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 ====
+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:
+<code>
+RufnameAlamos:=RufnameEDP
+</code>
+===== SSL Verschlüsselung =====
+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:
+{{ :edpweb:erstellen_eines_zertifikats.pdf |Anleitung zum Erstellen eines Zertifikats}}