Konfiguration
Die Konfiguration von TetraControl2Connect erfolgt vollständig über die webbasierte Admin-Oberfläche unter http://localhost:5050. Die Einstellungen werden in einer SQLite-Datenbank (settings.db) gespeichert.
TetraControl-Verbindung
Unter /settings/tetracontrol werden die Verbindungsparameter zur TetraControl-Instanz konfiguriert.
| Einstellung | Beschreibung |
|---|---|
TetraControlHost | Hostname oder IP-Adresse der TetraControl-Instanz |
TetraControlPort | Port des TetraControl-Webservers |
TetraControlUsername | Benutzername für den Zugriff auf den Webserver |
TetraControlPassword | Passwort für den Zugriff auf den Webserver |
Programmoptionen
Unter /settings/program werden allgemeine Betriebseinstellungen festgelegt.
Zu übertragende Daten
| Einstellung | Standard | Beschreibung |
|---|---|---|
SendVehicleStatus | true | Fahrzeugstatus an Connect übertragen |
SendVehiclePositions | true | Fahrzeugpositionen an Connect übertragen |
SendUserOperationStatus | true | Einsatzrückmeldungen von Benutzern übertragen |
SendUserAvailability | true | Verfügbarkeiten von Benutzern übertragen |
SendAlarms | true | Alarmierungen auswerten und übertragen |
UpdateExistingOperations | true | Vorhandene Einsätze in Connect aktualisieren |
Verbindungseinstellungen
| Einstellung | Standard | Beschreibung |
|---|---|---|
WebSocketReconnectTimeoutMinutes | – | Zeitfenster für automatische WebSocket-Wiederverbindungen (Minuten) |
HeartbeatEndpointUrl | – | URL für externe Heartbeat-Überwachung (z. B. UptimeRobot) |
HeartbeatInterval | – | Intervall für Heartbeat-Aufrufe im Format HH:mm:ss |
UserAvailabilityLifetimeDays | – | Anzahl der Tage, nach denen Verfügbarkeiten zurückgesetzt werden |
Status-Unterdrückung
| Einstellung | Standard | Beschreibung |
|---|---|---|
IgnoreStatus0 | false | Status 0 (priorisierter Sprechwunsch) ignorieren |
IgnoreStatus5 | false | Status 5 (Sprechwunsch) ignorieren |
IgnoreStatus9 | false | Status 9 (Fremdquittung) ignorieren |
Alarmierungsoptionen
| Einstellung | Standard | Beschreibung |
|---|---|---|
AcceptCalloutsForSirens | false | Sirenenalarmierungen verarbeiten |
AcceptSDSAsCalloutsWithPattern | false | SDS-Nachrichten anhand von Mustern als Alarmierungen auswerten |
AddPropertyForAlarmTexts | – | Alarmtexte als Zusatzfeld „Alarmtext TC" zum Einsatz hinzufügen |
IgnoreAlarmWithoutSubnetAddresses | false | Alarmierungen ohne passende Subnetzadressen ignorieren |
UseFullyQualifiedSubnetAddressForConnect | false | Subnetzadressen im vollständig qualifizierten Format verwenden |
PollForActiveOperationBeforeFallbackMaxRetryCount | 4 | Maximale Abfragen für aktiven Einsatz vor Fallback |
PollForActiveOperationBeforeFallbackDelay | 00:00:10 | Wartezeit zwischen Abfragen im Format HH:mm:ss |
Connect-Standorte
Unter /settings/connect werden die Connect-Standorte mit ihren API-Schlüsseln, Subnetzadressen und Sirenen verwaltet.
Jeder Standort benötigt:
- einen eindeutigen Namen
- einen Standort-API-Schlüssel (kein Organisations-Schlüssel)
Für jeden Standort können außerdem Subnetzadressen (Schleifen) und Sirenen konfiguriert werden.
Subnetzadressen (Schleifen)
| Feld | Beschreibung |
|---|---|
Name | Anzeigename der Schleife |
GSSI | Gruppen-ISSI der Schleife |
SNA | Subnetzadresse (z. B. &01) |
AlarmDirectly | Bei true: direkte Alarmierung ohne Fallback-Logik |
Sirenen
| Feld | Beschreibung |
|---|---|
Issi | ISSI des in der Sirene verbauten Digitalfunkgeräts |
Name | Anzeigename der Sirene (erscheint in Mängelmeldungen) |
ExpectedHeartbeatInterval | Erwartetes Heartbeat-Intervall im Format HH:mm:ss (optional) |
Status-Zuordnungen
Unter /settings/status werden die TETRA-Statuscodes den Connect-Verfügbarkeitsstatus zugeordnet. Mehrere Werte können mit Semikolon getrennt werden (z. B. 123;456). Nicht verwendete Einträge sollten auf -1 gesetzt werden.
| Einstellung | Beschreibung |
|---|---|
AvailableStatus | Verfügbar |
LimitedAvailableStatus | Bedingt verfügbar |
NotAvailableStatus | Nicht verfügbar |
ComingStatus | Komme |
NotComingStatus | Komme nicht |
ComingLaterStatus | Komme später |
Schweregrade
Unter /settings/severity werden numerische Schweregrade aus TetraControl auf Einsatzstichwörter in Connect abgebildet.
| Einstellung | Standard | Beschreibung |
|---|---|---|
UseServerityTranslationAsKeyword | true | Übersetzten Schweregrad als Einsatzstichwort verwenden |
SeverityTranslations | Hessen-Standard | Zuordnung von numerischen Schweregraden zu Stichwörtern |
Muster (SDS-Alarmauswertung)
Unter /settings/pattern werden reguläre Ausdrücke (Regex) für die Extraktion von Einsatzinformationen aus SDS-Nachrichten konfiguriert. Dieser Bereich ist nur relevant, wenn AcceptSDSAsCalloutsWithPattern in den Programmoptionen aktiviert ist.
Die Oberfläche enthält einen integrierten Regex-Tester, mit dem Muster direkt getestet werden können.
| Muster | Extrahiert |
|---|---|
NumberPattern | Einsatznummer |
KeywordPattern | Einsatzstichwort |
FactsPattern | Sachverhalt |
StreetPattern | Straße |
HouseNumberPattern | Hausnummer |
CityPattern | Stadt/Gemeinde |
DistrictPattern | Stadt-/Ortsteil |
ZipCodePattern | Postleitzahl |
RicPattern | Schleifen (RIC) |
ReporterNamePattern | Name des Meldenden |
ReporterPhoneNumberPattern | Telefonnummer des Meldenden |
LatitudePattern | Breitengrad |
LongitudePattern | Längengrad |
Unter AdditionalProperties können beliebig viele benutzerdefinierte Felder angegeben werden, die aus der SDS extrahiert und als Zusatzeigenschaften an den Einsatz in Connect übergeben werden.
- regex101.com – Testen und Entwickeln
- MDN RegEx Cheatsheet – Allgemeine Informationen
Sirenen-Alarmierung
Unter /settings/siren-callout werden Sirenencodes auf Einsatzstichwörter abgebildet. Dieser Bereich ist nur relevant, wenn AcceptCalloutsForSirens aktiviert ist.
| Einstellung | Standard | Beschreibung |
|---|---|---|
UseSirenCodeTranslationAsKeyword | false | Übersetzten Sirenencode als Stichwort verwenden (statt Schweregrad-Zuordnung) |
SirenCodeTranslations | Hessen-Standard | Zuordnung von Sirenencodes (z. B. $2000) zu Stichwörtern |
Sirenen-Status
Unter /settings/siren-status werden Fehlercodes und Statusmeldungen von Sirenen auf lesbare Beschreibungen abgebildet, die in Mängelmeldungen angezeigt werden.
| Einstellung | Beschreibung |
|---|---|
FailureTranslations | Wörterbuch von Fehlercode/-text zu lesbarer Beschreibung |
Der Schlüssel kann ein Statuscode (z. B. E001) oder ein im SDS-Text enthaltener Begriff sein (Suche mit Contains, Groß-/Kleinschreibung wird ignoriert). Der Wert ist der Text, der in der Mängelmeldung erscheint.
Live-Ansicht
Unter /live können eingehende Nachrichten von TetraControl in Echtzeit beobachtet werden (über SignalR). Dies ist besonders hilfreich bei der Fehlersuche und beim Testen der Konfiguration.
Backup-Verwaltung
Unter /backups können Sicherungen der Einstellungsdatenbank verwaltet werden:
- Manuelle Sicherung erstellen
- Vorhandene Sicherungen wiederherstellen
- Alte Sicherungen löschen
Die Anwendung erstellt außerdem täglich automatisch eine Sicherung.
REST-API
Alle Einstellungen sind auch über die REST-API unter http://localhost:5050/api abrufbar und änderbar. Eine interaktive Dokumentation steht unter /swagger bereit.
| Methode | Pfad | Zweck |
|---|---|---|
GET | /api/settings | Übersicht aller Konfigurationsbereiche |
GET/PUT | /api/settings/program | Programmoptionen |
GET/PUT | /api/settings/tetracontrol | TetraControl-Verbindung |
GET/PUT | /api/settings/connect | Standorte, Subnetzadressen und Sirenen |
GET/PUT | /api/settings/status | Status-Zuordnungen |
GET/PUT | /api/settings/pattern | SDS-Muster |
GET/PUT | /api/settings/severity | Schweregrade |
GET/PUT | /api/settings/siren-callout | Sirenen-Alarmierung |
GET/PUT | /api/settings/siren-status | Sirenen-Status |
POST | /api/settings/import | Einstellungen aus appsettings.json importieren |
GET | /api/backups | Sicherungen auflisten |
POST | /api/backups | Manuelle Sicherung erstellen |
POST | /api/backups/{id}/restore | Sicherung wiederherstellen |
DELETE | /api/backups/{id} | Sicherung löschen |