Data Connectors · Umwelt

E+H Floodmonitoring

Der Node ruft für eine Liste konfigurierter Messstellen (Instrumentationen) die aktuellen Werte aus der Netilion-Cloud von Endress+Hauser ab. Aus Wasserstand und Abstand, den eingetragenen Schwellenwerten und optionalen Hochwasserstufen erzeugt er je Messstelle eine FloodMonitoring-Entität und gibt alle Entitäten gesammelt in einer Nachricht aus.

Datenquelle
Triggerbasiert
FloodMonitoring

Node-Typ: eh-floodmonitoring
Paket: @htag/node-red-contrib-hypertegrity-environment
Eingänge / Ausgänge: 1 / 1
Datenquelle: Endress+Hauser Netilion API (api.netilion.endress.com)

Wofür Sie den Node verwenden

Kommunen, die eigene Radar- oder Ultraschallsensoren von Endress+Hauser an Bächen, Durchlässen oder Rückhaltebecken betreiben, erhalten die Messwerte über die Netilion-Cloud. Der E+H-Floodmonitoring-Node holt diese Werte in einen Node-RED-Flow, rechnet sie in Zentimeter um und bewertet sie anhand der von Ihnen gesetzten Schwellenwerte.

Typische Einsatzfälle sind:

Hochwasserüberwachung kleiner Gewässer, die nicht von Landes- oder Bundespegeln abgedeckt sind.
Warn-Dashboards mit Status Normal oder Critical, Bild der Messstelle und Link zu einer Detailseite.
Adaptive Abfrageintervalle, bei denen kritische Messstellen häufiger abgefragt werden als unauffällige.

So funktioniert der Node

Auslösen

Eine eingehende Nachricht startet den Abruf. Optional bringt sie eine eigene Sensorliste oder das Kennzeichen fastInterval mit.

Anmelden

Je nach Methode werden API-Key und Benutzer per Basic Auth gesendet oder ein OAuth-Token angefordert und automatisch erneuert.

Werte abrufen

Für jede Messstelle wird nacheinander der Endpunkt instrumentations/ID/values abgefragt. Fehler einzelner Messstellen werden als Warnung protokolliert.

Bewerten und ausgeben

Wasserstand und Abstand werden von Millimetern in Zentimeter umgerechnet, mit Schwellenwerten verglichen und als Array von FloodMonitoring-Entitäten gesendet.

Ergebnis: Eine Nachricht mit einem Array von FloodMonitoring-Entitäten, je Messstelle mit Wasserstand, Status, Hochwasserstufe, Standort und Links.

Der Node ist triggerbasiert. Kombinieren Sie ihn mit einem oder zwei Inject-Nodes: einem langsamen Intervall für alle Messstellen und optional einem schnellen Intervall mit msg.fastInterval = true, das nur die aktuell kritischen Messstellen abfragt. Welche Messstellen kritisch sind, merkt sich der Node im Node-Kontext.

Konfiguration

Der Bearbeitungsdialog ist in die Registerkarten Allgemein, Sensoren und Authentifizierung gegliedert.

Registerkarte Allgemein

Feld	Typ	Standard	Bedeutung
Name	Text	leer	Anzeigename des Nodes im Flow. Ohne Namen zeigt der Node „E+H Floodmonitoring“.

Registerkarte Sensoren

Die Registerkarte enthält eine bearbeitbare Liste. Jeder Eintrag beschreibt eine Messstelle und wird als Objekt im Array sensors gespeichert.

Feld	Typ	Standard	Bedeutung
Sensor ID	Auswahl mit Aktualisieren-Schaltfläche	leer	ID der Instrumentation in Netilion. Die Schaltfläche lädt bis zu 100 Instrumentationen Ihres Kontos; angezeigt werden Tag und Seriennummer. Gespeichert als `id`.
Name	Text	leer	Anzeigename der Messstelle. Wird in die Entität übernommen. Gespeichert als `name`.
Distanz-Wert	Auswahl	leer (entspricht `distance`)	Schlüssel des Werts, der den gemessenen Abstand liefert. Die Schaltfläche Werte lädt die verfügbaren Schlüssel der gewählten Instrumentation. Gespeichert als `distanceKey`.
Pegel-Wert	Auswahl	leer (entspricht `level`)	Schlüssel des Werts, der den Wasserstand liefert. Gespeichert als `levelKey`.
Breitengrad (Lat), Längengrad (Lon)	Zahl	leer	Koordinaten der Messstelle in Dezimalgrad. Fehlende Werte werden als `0` ausgegeben. Gespeichert als `lat` und `lon`.
Schwellwert Pegel (cm)	Zahl	leer	Wasserstand in Zentimetern, ab dem der Status `Critical` gesetzt wird. `0` oder leer schaltet die Prüfung ab. Gespeichert als `thresholdLevel`.
Schwellwert Abstand (cm)	Zahl	leer	Abstandsschwelle in Zentimetern. Gespeichert als `thresholdDistance`.
HQ Schwellwerte	Kontrollkästchen	aus	Aktiviert die Einstufung in Hochwasserstufen. Gespeichert als `useHQThresholds`.
HQ Schwellwerte (kommagetrennt)	Text	leer	Sechs aufsteigende Grenzwerte in Millimetern, durch Kommas getrennt (Beispiel unten). Gespeichert als `hqThresholds`.
Bild-URL	Text	leer	Adresse eines Bildes der Messstelle. Unterstützt die Platzhalter `{{id}}` und `{{name}}` sowie Umgebungsvariablen in der Form `${NAME}`. Gespeichert als `imageLink`.
Dashboard-URL	Text	leer	Adresse einer Detailseite. Gleiche Platzhalter wie bei der Bild-URL. Gespeichert als `dashboardLink`.

Beispiel für sechs HQ-Schwellwerte:

1412,1686,1891,2100,2300,2500

Registerkarte Authentifizierung

Feld	Typ	Standard	Bedeutung
Authentifizierungsmethode	Auswahl (`basic`, `oauth`)	`basic`	Basic Auth (API Key + Benutzer) sendet API-Key und Benutzerdaten bei jeder Anfrage. OAuth Token (API Key + Secret + Benutzer) fordert mit API-Key und Secret ein kurzlebiges Token an, das automatisch erneuert wird. Gespeichert als `authMethod`.
API Key	Passwort (Credential)	leer	API-Schlüssel Ihrer Netilion-Anwendung. Wird verschlüsselt gespeichert und in jeder Anfrage im Header `Api-Key` gesendet.
API Secret	Passwort (Credential, nur OAuth)	leer	Geheimnis Ihrer Netilion-Anwendung für die Token-Anforderung. Wird verschlüsselt gespeichert.
Benutzername	Text (Credential)	leer	Benutzername Ihres Netilion-Kontos.
Passwort	Passwort (Credential)	leer	Passwort Ihres Netilion-Kontos. Wird verschlüsselt gespeichert.

Registrierung bei Netilion

Für den Zugriff benötigen Sie ein Netilion-Konto von Endress+Hauser, in dem Ihre Geräte als Instrumentationen angelegt sind, sowie API-Key und gegebenenfalls Secret einer dort registrierten Anwendung. Beides erhalten Sie im Netilion-Entwicklerportal. Alle vier Credential-Felder akzeptieren Umgebungsvariablen in der Form ${NAME}, die der Node beim Start auflöst.

Bereits gespeicherte Credentials zeigt der Dialog als Platzhalter; lassen Sie das Feld leer, um den gespeicherten Wert beizubehalten. Die Aktualisieren-Schaltflächen im Dialog greifen über den Node-RED-Server auf die gespeicherten Credentials zurück, sodass Sie sie nicht erneut eingeben müssen.

Eingang

Eigenschaft	Typ	Bedeutung
`msg`	beliebig	Jede Nachricht startet einen Abruf. Alle Eigenschaften der Nachricht bleiben in der Ausgabe erhalten; `payload` wird überschrieben.
`msg.payload`	Array (optional)	Ersetzt die konfigurierte Sensorliste, wenn es ein nicht leeres Array ist, dessen erstes Element ein Feld `id` hat. Je Element werden `id`, `name`, `coordinates.latitude`, `coordinates.longitude`, `thresholds.level`, `thresholds.distance`, `hq_thresholds` (Array, aktiviert die HQ-Einstufung), `imageLink` und `dashboardLink` ausgewertet. Für Distanz- und Pegel-Wert gelten dabei die Schlüssel `distance` und `level`.
`msg.fastInterval = true`	Boolean (optional)	Schnelles Intervall: Es werden nur Messstellen abgefragt, die beim letzten Abruf den Status `Critical` hatten.
`msg.fastInterval = false`	Boolean (optional)	Langsames Intervall: Es werden alle Messstellen außer den aktuell kritischen abgefragt.
`msg.fastInterval` nicht gesetzt	–	Alle konfigurierten oder übergebenen Messstellen werden abgefragt.

Ausgang

Der Node sendet pro Abruf eine Nachricht, sofern mindestens eine Messstelle erfolgreich abgefragt wurde. msg.payload ist ein Array von FloodMonitoring-Entitäten.

{
  "payload": [
    {
      "id": "urn:ngsi-ld:FloodMonitoring:551018",
      "type": "FloodMonitoring",
      "name": "Pegel Musterbach Brücke",
      "alertLevel": 120,
      "location": {
        "value": {"type": "Point", "coordinates": [7.4701, 51.3602]}
      },
      "dateObserved": "2026-10-01T08:12:00.000Z",
      "floodLevelStatus": "Normal",
      "hq": 0,
      "measuredDistance": 245.3,
      "currentLevel": 54.7,
      "picture": "https://bilder.example.org/messstellen/551018.jpg",
      "link": "https://dashboard.example.org/wasserstand551018"
    }
  ]
}

Feld	Bedeutung
`id`	`urn:ngsi-ld:FloodMonitoring:` gefolgt von der Instrumentation-ID.
`type`	Immer `FloodMonitoring`.
`name`	Konfigurierter Name der Messstelle.
`alertLevel`	Konfigurierter Schwellwert Pegel in Zentimetern; `0`, wenn keiner gesetzt ist.
`location`	Standort im NGSI-v2-Stil mit GeoJSON-Punkt unter `value`, Reihenfolge Länge, Breite.
`dateObserved`	Zeitstempel des Pegel-Werts aus Netilion; fehlt der Pegel-Wert, der Abrufzeitpunkt.
`floodLevelStatus`	`Critical`, wenn ein Schwellwert größer `0` gesetzt ist und `currentLevel` ihn erreicht oder überschreitet; sonst `Normal`.
`hq`	Hochwasserstufe `0`, `5`, `10`, `25`, `50`, `100` oder `150` anhand der sechs HQ-Grenzwerte; `0`, wenn die Einstufung deaktiviert ist oder weniger als sechs Grenzwerte vorliegen.
`measuredDistance`	Gemessener Abstand in Zentimetern (Netilion liefert Millimeter). Entfällt, wenn der Distanz-Wert nicht gefunden wurde.
`currentLevel`	Wasserstand in Zentimetern (Netilion liefert Millimeter). Entfällt, wenn der Pegel-Wert nicht gefunden wurde.
`picture`	Bild-URL nach Ersetzung der Platzhalter; entfällt, wenn leer.
`link`	Dashboard-URL nach Ersetzung der Platzhalter; entfällt, wenn leer.

Beispiel-Flow

Das Paket bringt einen Beispiel-Flow mit. Sie importieren ihn in Node-RED über Menü → Importieren → Beispiele → @htag/node-red-contrib-hypertegrity-environment → eh-floodmonitoring. Alternativ laden Sie die Datei eh-floodmonitoring.json herunter und importieren sie über Menü → Importieren.

Schritt 1

Zwei Inject-Nodes

„Go!“ löst stündlich den vollständigen Abruf aus; „fastInterval“ setzt alle 15 Minuten msg.fastInterval auf true und fragt nur kritische Messstellen ab.

Schritt 2