==== EDPServer – Ansteuerung 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). ^ Funktion ^ Daten senden ^ Daten empfangen | | Einsatzdaten | ✔ | ✔ | | Statusmeldungen von Einsatzmitteln | ✔ | ✔ | | Positionen von Einsatzmitteln | ✘ | ✔ | ✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt. --- === Übertragene Datenfelder === * **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 (leer = Feld wird nicht übermittelt) * **lat** + **lon** – Koordinaten der Einsatzstelle (falls vorhanden) --- === Konfiguration der Schnittstelle === Die Konfiguration erfolgt in der Anwendung **EDP-Konfiguration** (`edpkonfig.exe`) unter *Schnittstellen*. Nach Hinzufügen der Schnittstelle kann der Konfigurationsdialog geöffnet werden: {{ :server:ansteuerungen:server_schnittstelle_divera_konfig2025.png?nolink |}} Einstellmöglichkeiten: * Zuordnung der EDP-Protokolltags für die Blöcke **Address**, **Type** und **Text** der Divera-API * Aktivieren der Übermittlung von Einsatzmittelstatus-Änderungen aus EDP an Divera --- == Nutzung eines Proxy-Servers == Für den Betrieb hinter einem Proxy müssen die Zugangsdaten zentral im Editor unter *Einstellungen → Proxy-Server* hinterlegt werden. --- === Alarmierung und Datenübermittlung === ==== Auslösen eines Alarms in Divera ==== 1. Aufgabe anlegen (über Editor oder Einsatzmittel) 2. Aufgabentyp **Ansteuerung** wählen 3. Divera-Schnittstelle auswählen 4. Im Feld *Wert* die RIC angeben, die im Divera-System ausgelöst werden soll Zusätzlich werden automatisch die Rufnamen aller zugeteilten Einsatzmittel als **vehicle** an Divera übergeben. Optional kann die Übertragung nur per Vehicle-RIC erfolgen: Haken „Wert der Aufgabe als RIC und vehicle-RIC übertragen“ setzen. ==== Alarmieren via Divera Vehicle-RIC ==== {{ :server:ansteuerungen:server_schnittstelle_divera_vehicle_ric.png |}} Im Einsatzmittel eine Aufgabe mit der Vehicle-RIC hinterlegen: {{ :server:ansteuerungen:server_schnittstelle_divera_vehicle_ric_aufgabe.png |}} Achtung: Dann werden die zugeteilten Einsatzmittel nicht zusätzlich übergeben. ==== Spezifische Parameter (ab Version 2025) ==== ^ Parameter ^ Beschreibung ^ | **group** | Kommagetrennte IDs von Gruppen (nicht mit *ric* kombinierbar) | | **ric** | Kommagetrennte RICs (nicht mit *group* kombinierbar) | | **key** | Abweichender API-Key | | **adress** | Einsatzadresse überschreiben | | **title** | Stichwort überschreiben | | **text** | Meldung überschreiben | Beispiel: ric=1,3,5&key=2324 {{ :server:ansteuerungen:aufgabe_divera2025.png?600 |}} --- === Empfang von Daten === ==== Einsatzdaten empfangen ==== * Aktivieren des Hakens in der Schnittstellenkonfiguration * Eintragen der Divera-User-ID ins Feld **UCR (User-ID)** (in Divera-URL unter `id=` ersichtlich) Adressübernahme: * Enthält „Adresse“ ein Komma → vor Komma = Straße, nach Komma = Ort * Kein Komma → gesamte Adresse = Feld „ORT“ Achtung: Empfang von Einsatzdaten ist nur sinnvoll, wenn Alarme **nicht** aus EDP an Divera gesendet werden (Vermeidung von Dopplungen). ==== Status- und Positionsmeldungen empfangen ==== * Haken in der Konfiguration setzen * Divera-User-ID eintragen * Einsatzmittel-ID (aus Divera) in EDP als Tetra-Funkgerät hinterlegen + Haken „Statusmeldungen auswerten“ aktivieren {{ :server:ansteuerungen:divera_url.jpg |}} {{ :server:ansteuerungen:divera_issi.jpg |}} ⚠ **Nicht gleichzeitig Status senden und empfangen!** Dies führt zu Endlosschleifen. --- === Technische Hinweise === ==== Websocket-Verbindung ==== Die Schnittstelle nutzt Websocket für Status-, GPS- und Einsatzdaten. Bei Verbindungsstörungen erfolgt ein automatischer Neustart mit Hinweis auf fehlende Lebenszeichen. Dies ist beabsichtigt und kein kritischer Fehler. --- === Häufige Probleme === * **Systemmeldung „Schnittstelle wird wegen gestörter Websocket-Verbindung neu gestartet“** – gewolltes Verhalten bei Verbindungsverlust. * **Alle Einheiten werden alarmiert** – In Divera die „Catch-All“-Einstellung deaktivieren, um Fehlauslösungen bei Tippfehlern in RICs zu vermeiden. --- === Aktualisierungen an Divera senden === Erforderliche Divera-API-Konfiguration: * Einsätze bei mehrfachem Aufruf zusammenführen (aktiv) * Bei übereinstimmender Nummer zusammenführen (aktiv) * Strikter Modus (aktiv) * „Nur Alarmierungen des gleichen API-Nutzers zusammenführen“ → **deaktiviert** --- === Verwendete Endpoints === * 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 ====== ^ Bereich ^ Einschränkung ^ Beschreibung ^ | **Einsatzdaten-Synchronisation** | Kein zeitgleiches Ändern in beide Richtungen | Änderungen, die aus EDP an Divera gesendet werden, verhindern weitere externe Änderungen zu diesem Einsatz in Richtung EDP. | | **Einsatzdaten-Synchronisation** | Bidirektionale Anbindung nur für ein EDP-System | Mehrere EDP-Systeme mit gleichem Account stören die eindeutige Zuordnung von Einsätzen. | | **Datenübertragung an Divera** | Senden von Änderungen | Ohne spezielle Divera-Konfiguration erzeugen Aktualisierungen und Fahrzeugzuteilungen neue Alarme. | | **Adressdaten** | Unvollständige Übernahme möglich | Divera führt Adressfelder zusammen; nur bestimmte Formate können korrekt aufgeteilt werden. |