Ansteuerung Divera 24/7 (EDP-Server)

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 fasst Konfiguration, Alarmierung, Datenempfang und technische Grenzen der Anbindung kompakt zusammen.

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

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

• 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 (ist er leer, wird das Feld nicht übermittelt)
• lat + lon - Koordinaten der Einsatzstelle (falls vorhanden)

Die Konfiguration erfolgt in der Anwendung „EDP-Konfiguration“ (edpkonfig.exe) unter „Schnittstellen“. Nachdem Sie die Schnittstelle hinzugefügt haben, können Sie den Konfigurationsdialog öffnen:

Dort stellen Sie Folgendes ein:

• die Zuordnung der EDP-Protokolltags für die Blöcke „Address“, „Type“ und „Text“ der Divera-API
• ob Änderungen des Einsatzmittelstatus aus EDP an Divera übermittelt werden

Für den Betrieb hinter einem Proxy-Server hinterlegen Sie die Zugangsdaten zentral im Editor unter „Einstellungen“ > „Proxy-Server“.

Alarme in Divera lösen Sie über Aufgaben vom Typ „Ansteuerung“ aus.

1. Legen Sie eine Aufgabe an (über den Editor oder über ein Einsatzmittel).
2. Wählen Sie den Aufgabentyp „Ansteuerung“.
3. Wählen Sie die Divera-Schnittstelle aus.
4. Geben Sie im Feld „Wert“ die RIC an, die im Divera-System ausgelöst werden soll.

Zusätzlich werden die Rufnamen aller zugeteilten Einsatzmittel automatisch als vehicle an Divera übergeben.

Optional kann die Übertragung nur per Vehicle-RIC erfolgen. Setzen Sie dafür den Haken „Wert der Aufgabe als RIC und vehicle-RIC übertragen“.

Hinterlegen Sie im Einsatzmittel eine Aufgabe mit der Vehicle-RIC:

Hinweis: In diesem Fall werden die zugeteilten Einsatzmittel nicht zusätzlich übergeben.

Ein Beispiel für kombinierte Parameter:

ric=1,3,5&key=2324

Für den Empfang von Einsatzdaten sowie Status- und Positionsmeldungen sind jeweils Einstellungen in der Schnittstellenkonfiguration nötig.

• Setzen Sie den entsprechenden Haken in der Schnittstellenkonfiguration.
• Tragen Sie die Divera-User-ID in das Feld „UCR (User-ID)“ ein. Sie steht in der Divera-URL hinter id=.

Die Adresse wird so übernommen:

• Enthält das Feld „Adresse“ ein Komma, landet der Text vor dem Komma in „Straße“, der Text danach in „Ort“.
• Ohne Komma wird die gesamte Adresse in das Feld ORT übernommen.

Hinweis: Der Empfang von Einsatzdaten ist nur sinnvoll, wenn Alarme nicht aus EDP an Divera gesendet werden. Sonst entstehen Dopplungen.

• Setzen Sie den Haken in der Konfiguration.
• Tragen Sie die Divera-User-ID ein.
• Hinterlegen Sie die Einsatzmittel-ID (aus Divera) in EDP als Tetra-Funkgerät und aktivieren Sie den Haken „Statusmeldungen auswerten“.

Hinweis: Senden und empfangen Sie Status nicht parallel. Das führt zu Endlosschleifen.

Die folgenden Abschnitte beschreiben die Websocket-Verbindung, die nötige Divera-Konfiguration für Aktualisierungen und die verwendeten Endpoints.

Die Schnittstelle nutzt eine Websocket-Verbindung für Status-, GPS- und Einsatzdaten. Bei Verbindungsstörungen startet sie automatisch neu und gibt einen Hinweis auf fehlende Lebenszeichen aus. Das ist beabsichtigt und kein kritischer Fehler.

Die API muss in Divera so konfiguriert sein:

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

• 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 meldet, dass die Schnittstelle wegen einer gestörten Websocket-Verbindung neu gestartet wird.

Ursache

Die Websocket-Verbindung zu Divera ist abgerissen.

Lösung

Kein Eingriff nötig. Der Neustart ist gewolltes Verhalten bei Verbindungsverlust.

Bei einer Alarmierung werden in Divera alle Einheiten alarmiert.

Ursache

Die „Catch-All“-Einstellung in Divera alarmiert alle Einheiten, z.B. bei Tippfehlern in RICs.

Lösung

Deaktivieren Sie in Divera die „Catch-All“-Einstellung, um solche Fehlauslösungen zu vermeiden.