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

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

Folgende Datenfelder werden übermittelt:

• 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

Die Konfiguration erfolgt über die Anwendung „EDP-Konfiguration“ (Anwendungsdatei edpkonfig.exe im Verzeichnis des EDP-Servers) im Bereich „Schnittstellen“. Dort kann nach Hinzufügen der Schnittstelle der folgende Konfigurationsdialog geöffnet werden:

Innerhalb der Konfiguration können Sie über die Protokolltags von EDP die Daten festlegen, die für die Blöcke „Adress“, „Type“ und „Text“ der Divera-API übergeben werden. Zudem können Sie anhaken, ob die Änderung eines Einsatzmittelstatus aus EDP an Divera übergeben werden soll.

Bei der Verwendung der Ansteuerung in einem Alarmvorschlag müssen der Aufgabe unter Umständen (je nach Schnittstelle) spezifische Parameter zugewiesen werden, siehe auch Dokumentation edp:desk.

Bei dieser Ansteuerung kann der Wert für den Parameter „RIC“ innerhalb von Divera 24/7 übergeben werden. Wird der Wert der Aufgabe leer gelassen, so werden alle o.g. Felder mit Ausnahme von „Ric“ übertragen.

Um einen Alarm in Divera auszulösen, legen Sie eine Aufgabe (entweder über den Editor oder ein Einsatzmittel) an. Wählen Sie als Aufgabentyp „Ansteuerung“ und aus der Liste der Ansteuerungen die Divera-Schnittstelle aus:

Im Feld „Wert“ der Aufgabe geben Sie die RIC an, die im Divera-System ausgelöst werden soll.

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.

Um Status- und Positionsmeldungen von Einsatzmitteln über die Divera-Schnittstelle empfangen zu können, muss der entsprechende Haken in der Konfiguration der Schnittstelle gesetzt werden sowie die Angabe einer User-ID aus Divera im Feld „UCR (User-ID)“ erfolgen. Diese User-ID kann in der Koniguration von Divera ermittelt werden, wenn dort in der Verwaltung ein Benutzer mit entsprechenden Zugriffsrechten aufgerufen wird. In der URL-Zeile des Browsers (https://app.divera247.com/user/update.html?id=123&…) ist ein Parameter „id=“ zu finden. Der dortige Zahlenwert ist in EDP einzutragen.

Die Zuordnung von Einsatzmitteln erfolgt über die ID der Einsatzmittel. Diese kann auch über die URL im Divera-Portal ermittelt werden. Beim Aufruf der Konfigurationsseite eines Einsatzmittels ist in der URL-Zeile des Browsers ein Parameter „id“ zu finden. Diese ID muss als Tetra-Funkgerät zu dem Einsatzmittel hinterlegt und der Haken „Statusmeldungen auswerten“ gesetzt sein.

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.

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.

Um Einsatzdaten über die Divera-Schnittstelle empfangen zu können, muss der entsprechende Haken in der Konfiguration der Schnittstelle gesetzt werden sowie die Angabe einer User-ID aus Divera im Feld „UCR (User-ID)“ erfolgen. Diese User-ID kann in der Koniguration von Divera ermittelt werden, wenn dort in der Verwaltung ein Benutzer mit entsprechenden Zugriffsrechten aufgerufen wird. In der URL-Zeile des Browsers (https://app.divera247.com/user/update.html?id=123&…) ist ein Parameter „id=“ zu finden. Der dortige Zahlenwert ist in EDP einzutragen.

Der Einsatz wird in EDP einmalig übernommen und die vorhandenen Felder befüllt. Da in Divera nur ein Feld „Adresse“ vorhanden ist, kann hier keine vollständige Übernahme der Ortsdaten in die einzelnen Felder von EDP erfolgen. Ist im Feld „Adresse“ ein Komma enthalten, so wird der Text bis zum Komma in das Feld „STRASSE“ und der Text dahinter in das Feld „ORT“ in EDP geschrieben. Ist kein Komma enthalten, wird der gesamte Adressblock in das Feld „ORT“ übernommen.

Eine Zuteilung von Einsatzmitteln erfolgt, wenn deren Divera-ID wie im Abschnitt „Empfang von Status- und Positionsmeldungen“ beschrieben als Tetra-Gerät in EDP hinterlegt ist.

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.

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

Anschließend ist im Einsatzmittel eine Aufgabe anzulegen, die als Wert die Vehicle-Ric von Divera enthält und diese so übergibt.

Für die Nutzung eines Proxyservers sind die Zugangsdaten zentral im Editor in den Einstellungen unter „Proxy-Server“ anzugeben.

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.

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.

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:

Mögliche Parameter:

Diese Parameter können auch kombiniert werden, indem sie mit „&“ verknüpft werden.

Beispiel:

ric=1,3,5&key=2324

Wenn Einsatzaktualisierungen oder Einsatzmittelzuteilungen an Divera gesendet werden, muss innerhalb von Divera folgende Konfiguration der API bestehen:

• Aktiv: Einsätze bei mehrfachem Aufruf der API zusammenführen
• Aktiv: Bei übereinstimmender Nummer zusammenführen
• Aktiv: Strikter Modus
• Die Funktion „Nur Alarmierungen des gleichen (API-) Nutzers zusammenführen“ muss zwingend deaktiviert sein!

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

Bei der Anbindung bestehen unter anderem folgende Limitationen.

Würde ein Einsatz von extern über Divera empfangen und zum Beispiel durch Meldung von Einsatzmittelzuteilungen aus edp oder allgemeinen Änderungen der Einsatzkopfdaten in Richtung Divera gesendet, so können zu diesem Einsatz keine weiteren Änderungen der Grunddaten von extern in Richtung edp empfangen werden.

Für das Senden von Änderungen zu Einsatzdaten, wie etwa bei Änderungen der Einsatzgrunddaten oder Fahrzeugzuteilungen, wird die ID des Alarms aus Divera zu diesem Einsatz zunächst ermittelt und mit zurückgesendet. Damit dies aber von Divera korrekt verarbeitet werden kann, ist eine spezielle Konfiguration auf Seiten von Divera erforderlich (siehe Abschnitt „Aktualisierungen an Divera senden“). Sollte diese aus Gründen anderer Abhängigkeiten jedoch bei Ihnen nicht möglich sein, so führt das Senden von Einsatzaktualisierungen und Fahrzeugzuteilungen in Richtung Divera zwangsläufig zu neuen Alarmen.

Innerhalb von Divera werden die Adressdaten (Straße, Hausnummer, PLZ, Ort, Ortsteil) in einem Feld „Adresse“ zusammengefasst. EDP kann hier folgende Formate der Adresse in Einzelteile aufschlüsseln:

• PLZ Ort, Straße Hausnummer
• Straße Hausnummer, PLZ Ort
• Ort, Straße Hausnummer
• Straße Hausnummer, Ort

Sollten die Daten in einem anderen Format oder gar ohne Trennzeichen („Straße Hausnummer Ort Ortsteil“) übertragen werden, ist eine Auflösung in einzelne Felder leider nicht möglich.