STEIN-Integration
Die STEIN-Integration verbindet HERA mit dem externen STEIN-System und ermöglicht den Austausch von Fahrzeug-, Anhänger- und Einheitendaten. Administratoren von Ortsverbänden konfigurieren und überwachen die Verbindung über die Seite /ov/admin/stein.
Berechtigung: OV-Administration
Übersicht
Die STEIN-Integration besteht aus vier Bereichen, die über Tabs bzw. Links erreicht werden:
| Bereich | Pfad | Beschreibung |
|---|---|---|
| STEIN Setup | /ov/admin/stein |
Zugangsdaten, API-Endpunkte und Webhook-Einstellungen |
| Status | /ov/admin/stein/status |
Cache, Warteschlange und Historie |
| Fahrzeuge | /ov/admin/stein/vehicles |
Fahrzeuge und Anhänger aus STEIN übernehmen |
| Einheiten | /ov/admin/stein/units |
HERA-Einheiten mit STEIN-Assets verknüpfen |
STEIN Setup
Hier konfigurieren Sie die Zugangsdaten für die Kommunikation mit STEIN.
Zugangsdaten
| Feld | Bedeutung |
|---|---|
| BU-ID | Eindeutige Betriebsstellen-ID Ihres Ortsverbands (z. B. 21) |
| API-Key | Schlüssel zur Authentifizierung gegenüber der STEIN-API. Wird verschlüsselt gespeichert und nie im Klartext angezeigt. |
| Webhook-Secret | Wird zur Prüfung eingehender Webhooks von STEIN benötigt. |
| Webhook-Token (URL) | Teil der Webhook-URL, schützt vor Missbrauch. Über „Neuer Webhook-Token“ kann ein neuer Token erzeugt werden. |
Aktionen:
- API-Key testen – Überprüft, ob der API-Key gültig ist.
- Speichern – Speichert die Zugangsdaten.
API-Endpunkte
Die Seite zeigt die konfigurierte STEIN-API-Basis-URL und die Webhook-URL, die Sie in STEIN hinterlegen müssen. Mit „Kopieren“ können Sie die Webhook-URL in die Zwischenablage übernehmen und im STEIN-System eintragen.
Schnelllinks:
- Fahrzeuge importieren – Führt zur Fahrzeuge-Seite.
- Einheiten verknüpfen – Führt zur Einheiten-Seite.
- Status & Queue – Zeigt den Status-Bereich.
STEIN-Settings löschen
Der rote Button „STEIN-Settings löschen“ entfernt alle STEIN-Einstellungen des Ortsverbands. Die Aktion ist endgültig und sollte nur mit Vorsicht ausgeführt werden.
Status
Der Status-Bereich gibt Einblick in den aktuellen Stand der Integration.
Cache
- Letzter Abruf – Zeitpunkt des letzten Datenabrufs von STEIN.
- Letzte Cache-Aktualisierung – Zeitpunkt der letzten lokalen Aktualisierung.
- STEIN-Daten abrufen – Startet einen manuellen Abruf der STEIN-Daten.
Warteschlange
Zeigt ausstehende Übertragungen von HERA an STEIN (z. B. Statusänderungen an Fahrzeugen oder Einheiten). Bei Bedarf kann mit „Jetzt senden“ ein Eintrag sofort übertragen werden.
Webhook-Historie
Protokoll eingehender Webhook-Aufrufe von STEIN: Zeitpunkt, Event-ID, IP, ob die Authentifizierung erfolgreich war (ok/blocked). Über „Details“ wird die Nutzlast angezeigt.
Übertragungs-Historie
Protokoll der an STEIN gesendeten Daten mit Asset-ID, Status, State und Zeitpunkt. Über „Details“ werden weitere Informationen angezeigt.
Fahrzeuge
Hier werden Fahrzeuge, Anhänger und Geräte aus STEIN verwaltet und mit HERA verknüpft.
Tabelle „Assets aus STEIN“
Die Tabelle listet alle aus STEIN erkannten Objekte mit:
| Spalte | Beschreibung |
|---|---|
| Bezeichnung | Name bzw. Bezeichnung des Assets |
| Status | Statuswert aus STEIN (z. B. ready) |
| Funkrufname | Funkrufname aus STEIN |
| ISSI | ISSI-Nummer (falls vorhanden) |
| Typ | Kategorie: Fahrzeuge, Anhänger oder Geräte |
Status „Bereits erfasst“ – Das Asset ist bereits einem HERA-Fahrzeug zugeordnet.
Aktionen
- Übernehmen – Öffnet ein Dialogfeld, um das Asset in HERA zu integrieren.
- Auflösen – Entfernt die Zuordnung zwischen HERA-Fahrzeug und STEIN-Asset.
STEIN Asset übernehmen
Beim Klick auf „Übernehmen“ haben Sie zwei Möglichkeiten:
Option 1: Vorhandenes Fahrzeug wählen
- Wählen Sie ein bestehendes HERA-Fahrzeug aus der Dropdown-Liste.
- Mit STEIN-Daten übernehmen werden die STEIN-Daten (z. B. Funkrufname, Status, ISSI) in das ausgewählte Fahrzeug übernommen.
Option 2: Als neues Fahrzeug erfassen
- Mit Als neues Fahrzeug erfassen öffnet sich ein Formular.
- Die Bezeichnung und der Funkrufname werden aus STEIN vorbelegt.
- Pflichtfelder: Fahrzeugbezeichnung, Kennzeichen. Optional: Langbezeichnung, Status, Führerscheinklasse, Sitzplätze, Nutzlast, Fahrzeugtyp, Einheit, Kommentar.
- Mit Fahrzeug anlegen wird das Fahrzeug in HERA angelegt und mit dem STEIN-Asset verknüpft.
Einheiten
Hier werden HERA-Einheiten mit STEIN-Assets verknüpft. Status- und Metadaten aus STEIN werden an die jeweilige Einheit angelegt.
Einheitenzuordnung
Für jede HERA-Einheit kann ein STEIN-Asset ausgewählt werden:
- Asset wählen – Dropdown mit verfügbaren STEIN-Einheiten-Assets.
- STEIN Asset ID / Status – Zeigt die aktuelle Zuordnung und den Status an.
- Alle Änderungen speichern – Schreibt alle Zuordnungen in einem Vorgang.
Die Zuordnung ist nötig, damit Statusänderungen (z. B. Einsatzbereitschaft) aus STEIN in HERA übernommen werden können – etwa für die STEIN-Status-Anzeige bei Einheiten.