Schnittstelle Divera 24/7

Mit dieser Schnittstelle übergibt der EDP-Server Einsatzdaten an das System Divera 24/7 (www.divera247.com) und empfängt auch Daten von dort. Diese Seite beschreibt die Konfiguration, die Alarmierung über Aufgaben, den Datenempfang sowie die technischen Grenzen der Anbindung.

Hinweis: Dieser Artikel behandelt die Konfiguration der Schnittstelle ab EDP-Version 2025. Die Dokumentation zu Vorgängerversionen finden Sie unter Schnittstelle Divera 24/7 (ältere Versionen).

Die Schnittstelle verwendet die Übergabe über die Web-API bzw. die Auslösung per HTTP GET (siehe https://www.divera247.com/downloads/divera247_webschnittstelle_zur_alarmierung.pdf).

Mit der neuen Schnittstellenversion können Sie Einsätze aus Divera empfangen und trotzdem Aktualisierungen in Richtung Divera senden, beispielsweise Fahrzeugzuteilungen oder den Objektnamen.

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

Die Konfiguration erfolgt in der Anwendung „EDP-Konfiguration“ (Anwendungsdatei edpkonfig.exe im Verzeichnis des EDP-Servers) im Bereich „Schnittstellen“. Nachdem Sie dort die Schnittstelle hinzugefügt haben, können Sie den folgenden Konfigurationsdialog öffnen:

In der Konfiguration legen Sie über die Protokolltags von EDP fest, welche Daten für die Blöcke „Adress“, „Type“ und „Text“ der Divera-API übergeben werden. Außerdem können Sie anhaken, ob die Änderung eines Einsatzmittelstatus aus EDP an Divera übergeben werden soll.

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

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

Folgende Datenfelder werden übermittelt:

• type - standardmäßig Stichwort Klartext
• priority - Sondersignal
• text - standardmäßig Meldung
• address - standardmäßig Ort Ortsteil Straße Hausnummer Objektname
• vehicle - Rufnamen der derzeit im Einsatz aktiven Fahrzeuge
• ric - zur Aufgabe erfasster Wert (ist er leer, wird das Feld nicht übermittelt)
• lat + lon - Koordinate der Einsatzstelle, falls vorhanden

Die Rufnamen aller dem Einsatz zugeteilten Einsatzmittel werden automatisch als vehicle an Divera übergeben, damit sie auch über die vehicle-RIC ausgewertet werden können. Dass die Zuordnung richtig erfolgt, muss in der Konfiguration von Divera sichergestellt werden.

Um Status- und Positionsmeldungen von Einsatzmitteln über die Divera-Schnittstelle zu empfangen, setzen Sie den entsprechenden Haken in der Konfiguration der Schnittstelle und tragen im Feld „UCR (User-ID)“ eine User-ID aus Divera ein. Diese User-ID finden Sie in der Konfiguration von Divera, wenn Sie dort in der Verwaltung einen Benutzer mit entsprechenden Zugriffsrechten aufrufen. In der URL-Zeile des Browsers (https://app.divera247.com/user/update.html?id=123&…) steht ein Parameter id=. Diesen Zahlenwert tragen Sie in EDP ein.

Die Einsatzmittel werden über ihre ID zugeordnet. Auch diese ermitteln Sie über die URL im Divera-Portal. Wenn Sie die Konfigurationsseite eines Einsatzmittels aufrufen, steht in der URL-Zeile des Browsers ein Parameter id. Diese ID hinterlegen Sie in EDP als Tetra-Funkgerät zu dem Einsatzmittel und setzen den Haken „Statusmeldungen auswerten“.

Hinweis: Alle Statusmeldungen, die edp: an Divera sendet, laufen auch wieder an edp: zurück. Um eine Endlosschleife zu vermeiden, versucht edp:, selbst gesendete Statusmeldungen herauszufiltern. Das kann in Einzelfällen zu Problemen führen. Prüfen Sie deshalb kritisch, ob Sie Statusmeldungen parallel an Divera senden und von dort empfangen wollen.

Um Einsatzdaten über die Divera-Schnittstelle zu empfangen, setzen Sie den entsprechenden Haken in der Konfiguration der Schnittstelle und tragen im Feld „UCR (User-ID)“ die User-ID aus Divera ein. Wie Sie die User-ID ermitteln, ist im Abschnitt „Empfang von Status- und Positionsmeldungen“ beschrieben: In der Verwaltung von Divera rufen Sie einen Benutzer mit entsprechenden Zugriffsrechten auf und übernehmen den Zahlenwert des Parameters id= aus der URL-Zeile des Browsers (https://app.divera247.com/user/update.html?id=123&…).

Der Einsatz wird einmalig in EDP übernommen, dabei werden die vorhandenen Felder befüllt. Da Divera nur ein Feld „Adresse“ hat, lassen sich die Ortsdaten nicht vollständig auf die einzelnen Felder von EDP aufteilen. Enthält das Feld „Adresse“ ein Komma, wird der Text bis zum Komma in das Feld STRASSE und der Text dahinter in das Feld ORT geschrieben. Ohne Komma wird der gesamte Adressblock in das Feld ORT übernommen.

Einsatzmittel werden zugeteilt, wenn ihre Divera-ID wie im Abschnitt „Empfang von Status- und Positionsmeldungen“ beschrieben als Tetra-Gerät in EDP hinterlegt ist.

Hinweis: Der Empfang von Einsatzdaten ist nur sinnvoll, wenn die Alarme von einer externen Stelle an Divera übergeben werden. Werden die Einsätze von EDP an Divera gesendet, laufen die Einsatzdaten bei aktivem Einsatzdatenempfang erneut in EDP ein und erzeugen einen neuen Einsatz.

Für die Nutzung eines Proxy-Servers geben Sie die Zugangsdaten zentral im Editor in den Einstellungen unter „Proxy-Server“ an.

Mit der Version 2025 wurde die Divera-Schnittstelle um neue Funktionen erweitert. In der Aufgabe können jetzt zusätzliche Parameter zur Alarmierung angegeben werden.

Die Parameter lassen sich kombinieren, indem Sie sie mit & verknüpfen, zum Beispiel so:

ric=1,3,5&key=2324

Wenn Einsatzaktualisierungen oder Einsatzmittelzuteilungen an Divera gesendet werden, muss die API in Divera so konfiguriert sein:

• „Einsätze bei mehrfachem Aufruf der API zusammenführen“ ist aktiv.
• „Bei übereinstimmender Nummer zusammenführen“ ist aktiv.
• „Strikter Modus“ ist aktiv.
• „Nur Alarmierungen des gleichen (API-) Nutzers zusammenführen“ muss zwingend deaktiviert sein.

Bei der Anbindung von Divera gibt es aus technischen Gründen folgende Einschränkungen.

Wird ein Einsatz von extern über Divera empfangen und anschließend in Richtung Divera gesendet, zum Beispiel durch Einsatzmittelzuteilungen aus edp: oder allgemeine Änderungen der Einsatzkopfdaten, kann EDP zu diesem Einsatz keine weiteren Änderungen der Grunddaten mehr von extern empfangen.

Für das Senden von Änderungen an Einsatzdaten, etwa an den Einsatzgrunddaten oder bei Fahrzeugzuteilungen, ermittelt EDP zunächst die ID des Alarms aus Divera zu diesem Einsatz und sendet sie mit. Damit Divera das korrekt verarbeitet, ist dort eine spezielle Konfiguration nötig (siehe Abschnitt „Aktualisierungen an Divera senden“). Ist diese Konfiguration bei Ihnen wegen anderer Abhängigkeiten nicht möglich, erzeugt jedes Senden von Einsatzaktualisierungen und Fahrzeugzuteilungen in Richtung Divera zwangsläufig einen neuen Alarm.

Divera fasst die Adressdaten (Straße, Hausnummer, PLZ, Ort, Ortsteil) in einem Feld „Adresse“ zusammen. EDP kann folgende Adressformate in Einzelteile aufschlüsseln:

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

Werden die Daten in einem anderen Format oder ganz ohne Trennzeichen übertragen („Straße Hausnummer Ort Ortsteil“), ist eine Aufteilung in einzelne Felder nicht möglich.

Einsatzdaten dürfen immer nur von höchstens einem EDP-System zur selben Zeit gesendet und bearbeitet werden. Arbeiten mehrere EDP-Systeme über denselben Account, funktioniert die Zuordnung der Einsätze zu eindeutigen IDs nicht mehr.

Folgende Endpoints von Divera werden 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

EDP zeigt die Systemmeldung „Die Schnittstelle Divera wird wegen einer gestörten Websocket-Verbindung neu gestartet“ an.

Ursache

Für den Empfang von Status, GPS-Positionen und Einsatzdaten baut die Divera-Schnittstelle eine dauerhafte Websocket-Verbindung zum Server von Divera auf und überwacht diese. Stellt die Überwachung fest, dass die Verbindung nicht mehr korrekt besteht, gibt die Schnittstelle diese Systemmeldung aus. Das kann u.U. bei einer instabilen Internetverbindung, bei der nächtlichen Zwangstrennung im Router o.ä. passieren.

Lösung

Es ist kein Eingriff nötig. Der Neustart der Schnittstelle und der neue Verbindungsaufbau sind gewünschtes Verhalten. Die Meldung ist kein kritischer Fehler, sondern ein Hinweis auf den Neustart.

Bei einer Alarmierung aus EDP werden in Divera alle hinterlegten Gruppen bzw. RICs alarmiert.

Ursache

Divera hat eine „Catch-All“-Einstellung, die alle hinterlegten Gruppen / RICs alarmiert, wenn eine eingehende Alarmierung nicht sinnvoll zugeordnet werden kann. Das passiert zum Beispiel, wenn die RIC, die EDP übergibt, einen Tippfehler enthält.

Lösung

Damit nicht alle in Divera hinterlegten Geräte alarmiert werden, können Sie die „Catch-All“-Funktion in Divera deaktivieren.