Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Divera 24/7

Über Divera alarmieren, Fahrzeugstatus austauschen, Rückmeldungen sehen und fremde Alarme als Alarmeingang annehmen.

Die Anbindung vom Typ Divera 24/7 verbindet Lagewerk mit einer Divera-Einheit:

  • Alarmieren: Technische Aufgaben lösen einen Divera-Alarm aus, an die ganze Einheit, an Gruppen oder an einzelne Fahrzeuge. Weitere Auslösungen im selben Einsatz aktualisieren den Alarm, auf Wunsch wird er beendet.
  • Rückmeldungen: Wie viele Empfänger den Alarm gelesen haben und wie viele „Komme“, „Komme nicht“ usw. gemeldet haben, steht an der Alarm-Aufgabe im Einsatz.
  • Fahrzeugstatus: Statuswechsel in Lagewerk gehen an Divera, in Divera gesetzte Status kommen nach Lagewerk. Kann Lagewerk einen abgerufenen Status kurzzeitig nicht speichern, übernimmt es ihn beim nächsten Abruf.
  • Fremde Alarme: Wird in Divera alarmiert, ruft Divera Lagewerk auf; der Alarm erscheint als Alarmeingang in der Einsatzliste.

Einrichten

Unter Verwaltung → Anbindungen eine Anbindung vom Typ Divera 24/7 anlegen. Dafür brauchen Sie das Recht Anbindungen verwalten.

Feld Bedeutung
Server-Adresse Leer lassen für die Divera-Cloud. Ein Divera-Server im eigenen Netz muss in EGRESS_ALLOWED_NETS freigegeben sein (siehe Installation).
Empfangs-Adresse Wird nach dem Anlegen angezeigt (https://<Ihre Domain>/api/v1/webhook/divera/<ID>), mit Knopf Kopieren.
Abruf alle (Sekunden) Wie oft Lagewerk Fahrzeugstatus und Rückmeldungen abholt, 10–600, Standard 30.
Rückmeldungen offener Alarme abrufen Standard eingeschaltet.
Erlaubte Absender des Webhooks Optional: IP-Adressen oder Netze (CIDR), durch Komma getrennt. Leer = jeder mit gültigem Token.
API-Schlüssel Pflicht. Persönlicher Schlüssel eines Benutzers mit Alarmierungsrecht oder Schlüssel eines Systembenutzers.
Webhook-Token Frei wählbares Geheimnis für eingehende Alarme. Leer = keine eingehenden Alarme.
Kennungs-Regel Leitet die Divera-Fahrzeug-ID eines Fahrzeugs ab, wenn am Gerät keine gepflegt ist.
Aktiviert Nur aktivierte Anbindungen alarmieren, senden und rufen ab.

Formular einer Divera-Anbindung mit Empfangs-Adresse, Abruf, Webhook-Absendern und Zugangsdaten

Wird einem Einsatz mit offenem Divera-Alarm ein weiteres Fahrzeug zugeteilt, nimmt Lagewerk es in diesen Alarm auf; Titel, Text und Sonderrechte bleiben. Geht der offene Alarm schon an die ganze Einheit oder an Gruppen, bleibt er unverändert, und die Aufgabe nennt das als Hinweis.

Fahrzeuge zuordnen

Divera kennt Fahrzeuge unter einer Zahl, der Divera-Fahrzeug-ID. Sie steht in Divera unter Verwaltung → Fahrzeuge beim Bearbeiten eines Fahrzeugs in der Adresszeile (…/vehicle/update.html?id=117568). Tragen Sie sie am Einsatzmittel bei einem Gerät vom Typ Alarmierungs-App als Kennung Divera-Fahrzeug-ID ein (siehe Geräte und Kennungen). Ohne diese Kennung kann Lagewerk das Fahrzeug bei Divera weder alarmieren noch seinen Status senden; ein von Divera gemeldeter Status eines unbekannten Fahrzeugs erscheint unter Unbekannte Kennungen.

Fremde Alarme empfangen

  1. Webhook-Token in der Anbindung setzen und speichern.
  2. Die Empfangs-Adresse kopieren und ?token= mit dem Webhook-Token anhängen.
  3. In Divera unter Verwaltung → Schnittstellen → Datenübergabe → Webhooks einen Webhook mit dieser Adresse anlegen, Format POST mit application/json.

Lagewerk muss dafür aus dem Internet erreichbar sein; geben Sie nach außen nur den Pfad /api/v1/webhook/divera/ frei.

Alarme, die Lagewerk selbst ausgelöst hat, erkennt Lagewerk und legt dafür keinen Alarmeingang an. Einen fremden Alarm übernehmen Sie wie jeden Alarmeingang; Titel und Text bilden zusammen das Meldebild („Titel · Text“), Einsatzort und Koordinaten sind vorbelegt. Spätere Meldungen desselben Alarms aktualisieren den Eingang bzw. den übernommenen Einsatz, ein in Divera geschlossener Alarm archiviert den offenen Eingang. Ob ein Alarm geschlossen ist, fragt Lagewerk mit dem API-Schlüssel der Anbindung bei Divera nach; ist Divera dabei nicht erreichbar, bleibt der Eingang offen und lässt sich von Hand archivieren.

Alarmieren aus Aufgaben

In einer technischen Aufgabenvorlage die Funktion Alarmieren wählen. Das Ziel bestimmt, wer alarmiert wird:

Ziel Wer wird alarmiert
Anbindung direkt (die Divera-Anbindung) Die ganze Einheit oder, mit Empfänger gruppen, die gewählte Gruppe.
Gerät des Einsatzmittels (Alarmierungs-App) Nur das Divera-Fahrzeug dieses Einsatzmittels.
Angabe Bedeutung
Text Meldung des Alarms. Leer = Meldebild und Einsatzort.
Sonderrechte Divera-Alarm mit Priorität.
Offenen Alarm beenden Schließt den offenen Alarm dieses Einsatzes, statt zu alarmieren.
Titel Leer = Meldebild. Divera kürzt auf 50 Zeichen.
Empfänger, Gruppe Nur beim Ziel „Anbindung direkt“: alle oder gruppen mit Auswahl der Gruppe.
Push-Benachrichtigung senden Standard eingeschaltet.

Einsatzort, Koordinaten, Objekt und Bemerkung des Einsatzes gehen immer mit. Solange der Alarm offen ist, aktualisiert jede weitere Auslösung im selben Einsatz ihn. Ein Fahrzeug-Alarm nimmt weitere Fahrzeuge dazu, etwa wenn eine Vorlage mit Auslöser Zuteilung für jedes zugeteilte Fahrzeug alarmiert; ein Alarm an Einheit oder Gruppe bleibt dabei unverändert.

Eine Vorlage mit Offenen Alarm beenden und Auslöser Einsatzabschluss schließt den Alarm mit dem Einsatz. Gibt es keinen offenen Alarm, ist die Aufgabe ohne Wirkung erledigt.

Fahrzeugstatus

  • Nach Divera: Jeder Statuswechsel eines Fahrzeugs mit Divera-Fahrzeug-ID geht an Divera, gleich ob er im Statustableau oder über eine andere Anbindung entstand.
  • Von Divera: Lagewerk holt im eingestellten Abstand die Status der Divera-Fahrzeuge und übernimmt neuere wie einen Klick im Statustableau. Beim ersten Abruf merkt sich Lagewerk nur den Stand, damit keine alten Status nachgespielt werden.
  • Meldet Divera den Status, den das Fahrzeug schon hat, etwa nach einem Wechsel aus Lagewerk, ändert sich nichts.
  • Hat Divera zu viele Anfragen gemeldet, wartet Lagewerk mit dem nächsten Abruf länger.