Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
server:ansteuerungen:divera [2025/08/11 20:22] – dominikserver:ansteuerungen:divera [2025/08/21 21:51] (aktuell) – [Nutzung eines Proxy-Servers] dominik
Zeile 1: Zeile 1:
-===== EDPServer -- Ansteuerung Divera 24/7 =====+===== Schnittstelle Divera 24/7 =====
  
 Mit dieser Schnittstelle kann der EDP-Server Einsatzdaten an das System Divera 24/7 (www.divera247.com) übergeben und auch empfangen. Die Schnittstelle verwendet die Übergabe über die Web-API / Auslösung per HTTP Get (siehe https://www.divera247.com/downloads/divera247_webschnittstelle_zur_alarmierung.pdf). Mit dieser Schnittstelle kann der EDP-Server Einsatzdaten an das System Divera 24/7 (www.divera247.com) übergeben und auch empfangen. Die Schnittstelle verwendet die Übergabe über die Web-API / Auslösung per HTTP Get (siehe https://www.divera247.com/downloads/divera247_webschnittstelle_zur_alarmierung.pdf).
  
-Dieser Artikel behandelt die Konfiguration der Schnittstelle ab EDP-Version 2025. +Dieser Artikel behandelt die Konfiguration der Schnittstelle ab EDP-Version 2025 - die Dokumentation zu Vorgängerversionen finden Sie [[divera_alt|hier]].  
 + 
 +Mit der neuen Schnittstellenversion ist es nun möglich, Einsätze aus Divera zu empfangen und gleichzeitig auch Aktualisierungen - beispielsweise Fahrzeugzuteilungen oder den Objektnamen - in Richtung Divera zu senden. 
  
 ^ Funktion ^ Daten senden ^ Daten empfangen | ^ Funktion ^ Daten senden ^ Daten empfangen |
Zeile 13: Zeile 15:
 ✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.   ✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.  
  
-Folgende Datenfelder werden übermittelt: +==== Grundkonfiguration ====
-  * **type** - Stichwort Klartext +
-  * **priority** - Sondersignal +
-  * **text** - Meldung +
-  * **address** - Ort Ortsteil Straße Hausnummer Objektname +
-  * **vehicle** - Rufnamen der derzeit im Einsatz aktiven Fahrzeuge +
-  * **ric** - Zur Aufgabe erfasster Wert (wenn leer wird das Feld nicht übermittelt) +
-  * **lat** + **lon** - Koordinate der Einsatzstelle - falls vorhanden +
  
  
Zeile 37: Zeile 32:
  
 Im Feld "Wert" der Aufgabe geben Sie die RIC an, die im Divera-System ausgelöst werden soll. Im Feld "Wert" der Aufgabe geben Sie die RIC an, die im Divera-System ausgelöst werden soll.
 +
 +Folgende Datenfelder werden übermittelt:
 +  * **type** - Per Default Stichwort Klartext
 +  * **priority** - Sondersignal
 +  * **text** - Per Default Meldung
 +  * **address** - Per Default Ort Ortsteil Straße Hausnummer Objektname
 +  * **vehicle** - Rufnamen der derzeit im Einsatz aktiven Fahrzeuge
 +  * **ric** - Zur Aufgabe erfasster Wert (wenn leer wird das Feld nicht übermittelt)
 +  * **lat** + **lon** - Koordinate der Einsatzstelle - falls vorhanden 
  
 Weiterhin werden automatisch die Rufnamen aller dem Einsatz zugeteilten Einsatzmittel als vehicle an Divera übergeben, so dass diese auch über die vehicle-RIC ausgewertet werden können. Hier muss auf Ebene der Konfiguration von Divera sichergestellt werden, dass die Zuordnung richtig erfolgt. Weiterhin werden automatisch die Rufnamen aller dem Einsatz zugeteilten Einsatzmittel als vehicle an Divera übergeben, so dass diese auch über die vehicle-RIC ausgewertet werden können. Hier muss auf Ebene der Konfiguration von Divera sichergestellt werden, dass die Zuordnung richtig erfolgt.
  
-Sollen über EDP ausschließlich vehicle-RICs ausgelöst werden, kann in der Konfiguration der Schnittstelle der Haken "Wert der Aufgabe als RIC und vehicle-RIC übertragen" aktiviert werden. Dann wird der Wert der Aufgabe auch im Parameter "vehicle" übergeben. Eine Übergabe der in EDP zugeteilten Einsatzmittel erfolgt dann grundsätzlich nicht mehr, ist aber möglich.  
 === Empfang von Status- und Positionsmeldungen === === Empfang von Status- und Positionsmeldungen ===
  
Zeile 51: Zeile 54:
  
 **Bitte beachten Sie, dass ein Empfang von Statusmeldungen nicht mit einem parallelen Senden von Statusmeldungen aus EDP an Divera kombiniert werden kann. In diesem Fall werden die Meldungen in einer Endlosschleife zwischen beiden Systeme ausgetauscht.** **Bitte beachten Sie, dass ein Empfang von Statusmeldungen nicht mit einem parallelen Senden von Statusmeldungen aus EDP an Divera kombiniert werden kann. In diesem Fall werden die Meldungen in einer Endlosschleife zwischen beiden Systeme ausgetauscht.**
- 
-=== Neustart wegen Websocket-Verbindung === 
- 
-Die Divera-Schnittstelle baut zum Empfang von Status- und Positionsmeldungen sowie Einsatzdaten eine Websocket-Verbindung zum Divera-Server auf und überwacht die Verbindung. Kommt es im Betrieb zu einer Störung der Verbindung wird die Divera-Schnittstelle neu gestartet mit dem Hinweis, dass die Lebenszeichentelegramme auf der Websocket-Verbindung ausgeblieben sind. Das ist ein bewusst so gewünschtes Verhalten und sollte zu keinen Problemen führen. Im 24/7-Betrieb sollte es immer wieder deshalb zu einem Neustart kommen. 
- 
  
 === Empfang von Einsatzdaten === === Empfang von Einsatzdaten ===
Zeile 67: Zeile 65:
 **Bitte beachten Sie, dass ein Empfang von Einsatzdaten nur sinnvoll erfolgen kann, wenn die Alarme von einer externen Stelle an Divera übergeben werden. Wenn die Einsätze von EDP an Divera gesendet werden, führt die aktive Funktion des Einsatzdatenempfangs zu einem erneuten Einlaufen der Einsatzdaten in EDP, was wiederum einen neuen Einsatz erzeugt.** **Bitte beachten Sie, dass ein Empfang von Einsatzdaten nur sinnvoll erfolgen kann, wenn die Alarme von einer externen Stelle an Divera übergeben werden. Wenn die Einsätze von EDP an Divera gesendet werden, führt die aktive Funktion des Einsatzdatenempfangs zu einem erneuten Einlaufen der Einsatzdaten in EDP, was wiederum einen neuen Einsatz erzeugt.**
  
- +=== Nutzung eines Proxy-Servers ===
-=== Alarmieren von Einsatzmitteln via Divera Vehicle RIC === +
- +
-Sollten Einsatzmittel via Ihrer Vehicle-RIC in Divera alarmiert werden, so muss hierfür der entsprechende Haken in der Konfiguration der Schnittstelle gesetzt werden. Bitte beachten Sie, dass dadurch nicht mehr die zugeteilten Einsatzmittel aus dem Einsatz an Divera übergeben werden können (um hier Dopplungen zu vermeiden).  +
- +
-{{ :server:ansteuerungen:server_schnittstelle_divera_vehicle_ric.png |}} +
- +
-Anschließend ist im Einsatzmittel eine Aufgabe anzulegen, die als Wert die Vehicle-Ric von Divera enthält und diese so übergibt.  +
- +
-{{ :server:ansteuerungen:server_schnittstelle_divera_vehicle_ric_aufgabe.png |}} +
- +
-==== Nutzung eines Proxy-Servers ====+
  
 Für die Nutzung eines Proxyservers sind die Zugangsdaten zentral im Editor in den Einstellungen unter "Proxy-Server" anzugeben. Für die Nutzung eines Proxyservers sind die Zugangsdaten zentral im Editor in den Einstellungen unter "Proxy-Server" anzugeben.
  
-==== Häufige Probleme ==== +==== Parameter ====
- +
-=== Systemmeldung "Die Schnittstelle Divera wird wegen einer gestörten Websocket-Verbindung neu gestartet" === +
- +
-Die Schnittstelle Divera baut für die Funktionen des Status-, GPS- und Einsatzdatenempfangs eine dauerhafte Websocket-Verbindung zum Server von Divera auf und überwacht diese Verbindung. Die o.g. Systemmeldung wird von der Divera-Schnittstelle ausgegeben, wenn die Überwachung der Websocket-Verbindung feststellt, dass die Verbindung nicht mehr korrekt besteht. Dies kann u.U. bei einer instabilen Internetverbindung, bei nächtlicher Zwangstrennung im Router o.ä. der Fall sein. Prinzipiell handelt es sich hierbei um ein gewünschtes Verhalten, dass sich die Schnittstelle neu startet und die Verbindung neu initiiert. D.h. die Meldung ist nicht als kritischer Fehler sondern als Hinweis auf einen Neustart zu sehen. +
- +
-=== Alle Einheiten werden in Divera alarmiert === +
-Innerhalb von Divera gibt es eine Einstellung, die als "Catch-All" alle hinterlegten Gruppen / RIC alarmiert, wenn eine eingehende Alarmierung nicht sinnvoll zugeordnet werden kann. Das kann immer dann der Fall sein, wenn sich in der RIC, die durch EDP übergeben wird, ein Tippfehler befindet. Um eine Alarmierung aller in Divera hinterlegten Geräte zu vermeiden, kann diese Funktion in Divera deaktiviert werden.  +
- +
-===== Ab edp: Version 2025 =====+
  
 Mit der Version 2025 wurde die DIVERA-Schnittstelle um neue Funktionen erweitert. Es können nun zusätzliche Parameter zur Alarmierung in der Aufgabe angegeben werden: Mit der Version 2025 wurde die DIVERA-Schnittstelle um neue Funktionen erweitert. Es können nun zusätzliche Parameter zur Alarmierung in der Aufgabe angegeben werden:
Zeile 122: Zeile 100:
   * Die Funktion "Nur Alarmierungen des gleichen (API-) Nutzers zusammenführen" muss zwingend **deaktiviert** sein!    * Die Funktion "Nur Alarmierungen des gleichen (API-) Nutzers zusammenführen" muss zwingend **deaktiviert** sein! 
  
-==== Verwendete Endpoints ==== 
- 
-Folgende Endpoints werden von Divera verwendet: 
- 
-  * https://app.divera247.com/api/v2/pull/vehicle-status 
-  * https://www.divera247.com/api/v2/auth/jwt 
-  * https://www.divera247.com/api/fms 
-  * https://www.divera247.com/api/v2/alarms/{id} 
-  * https://app.divera247.com/api/alarm 
-  * https://app.divera247.com/api/v2/alarms 
  
 ====== Technische Limitationen ====== ====== Technische Limitationen ======
  
-Bei der Anbindung bestehen unter anderem folgende Limitationen.+Bei der Anbindung von Divera bestehen aus technischen Gründen folgende Limitationen:
  
 === Kein zeitgleiches Ändern von Einsatzdaten in beide Richtungen === === Kein zeitgleiches Ändern von Einsatzdaten in beide Richtungen ===
Zeile 154: Zeile 122:
 === Bidirektionale Anbindung nur für ein EDP-System === === Bidirektionale Anbindung nur für ein EDP-System ===
 Ein zeitgleiches Senden und Bearbeiten von Einsatzdaten darf immer nur durch maximal ein EDP-System erfolgen. Wenn mehrere EDP-Systeme über den gleichen Account arbeiten, funktioniert die Zuordnung der Einsätze zu eindeutigen IDs nicht mehr. Ein zeitgleiches Senden und Bearbeiten von Einsatzdaten darf immer nur durch maximal ein EDP-System erfolgen. Wenn mehrere EDP-Systeme über den gleichen Account arbeiten, funktioniert die Zuordnung der Einsätze zu eindeutigen IDs nicht mehr.
 +
 +
 +==== Verwendete Endpoints ====
 +
 +Folgende Endpoints werden von Divera verwendet:
 +
 +  * https://app.divera247.com/api/v2/pull/vehicle-status
 +  * https://www.divera247.com/api/v2/auth/jwt
 +  * https://www.divera247.com/api/fms
 +  * https://www.divera247.com/api/v2/alarms/{id}
 +  * https://app.divera247.com/api/alarm
 +  * https://app.divera247.com/api/v2/alarms
 +
 +==== Häufige Probleme ====
 +
 +=== Systemmeldung "Die Schnittstelle Divera wird wegen einer gestörten Websocket-Verbindung neu gestartet" ===
 +
 +Die Schnittstelle Divera baut für die Funktionen des Status-, GPS- und Einsatzdatenempfangs eine dauerhafte Websocket-Verbindung zum Server von Divera auf und überwacht diese Verbindung. Die o.g. Systemmeldung wird von der Divera-Schnittstelle ausgegeben, wenn die Überwachung der Websocket-Verbindung feststellt, dass die Verbindung nicht mehr korrekt besteht. Dies kann u.U. bei einer instabilen Internetverbindung, bei nächtlicher Zwangstrennung im Router o.ä. der Fall sein. Prinzipiell handelt es sich hierbei um ein gewünschtes Verhalten, dass sich die Schnittstelle neu startet und die Verbindung neu initiiert. D.h. die Meldung ist nicht als kritischer Fehler sondern als Hinweis auf einen Neustart zu sehen.
 +
 +=== Alle Einheiten werden in Divera alarmiert ===
 +Innerhalb von Divera gibt es eine Einstellung, die als "Catch-All" alle hinterlegten Gruppen / RIC alarmiert, wenn eine eingehende Alarmierung nicht sinnvoll zugeordnet werden kann. Das kann immer dann der Fall sein, wenn sich in der RIC, die durch EDP übergeben wird, ein Tippfehler befindet. Um eine Alarmierung aller in Divera hinterlegten Geräte zu vermeiden, kann diese Funktion in Divera deaktiviert werden. 
server/ansteuerungen/divera.1754936550.txt.gz · Zuletzt geändert: von dominik


  • Seite anzeigen
  • Ältere Versionen
  • Links hierher
  • Letzte Änderungen
  • Medien-Manager
  • Übersicht