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

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
- Webhook-Token in der Anbindung setzen und speichern.
- Die Empfangs-Adresse kopieren und
?token=mit dem Webhook-Token anhängen. - 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.