Zum Hauptinhalt springen
Best Practice · Node-RED

Gemeinsame Node-RED-Nodes nutzen

Die HYPERTEGRITY-Bibliothek bündelt wiederverwendbare Nodes für NGSI-LD, Stellio und ausgewählte urbane Datenquellen. Sie reduziert individuelle Function-Logik und sorgt dafür, dass gleiche Integrationsaufgaben projektübergreifend ähnlich gelöst werden.

Wann die Bibliothek verwendet wird

Prüfen Sie bei einem neuen Flow zuerst, ob ein vorhandener Node den benötigten Datenzugang oder Plattformschritt bereits abbildet. Eigener JavaScript-Code in einem Function Node bleibt sinnvoll für fachliche Berechnungen, projektspezifische Prüfungen und Transformationen, die nicht wiederverwendbar sind. Technische Standardlogik für Stellio, NGSI-LD oder eine unterstützte Quelle sollte dagegen nicht in jedem Projekt neu entstehen.

Aufgabe

Passenden Node suchen

Quelle, Datenmodell und Zielsystem mit den vorhandenen Bausteinen abgleichen.

Konfiguration

Plattformkontext setzen

Datenraum, Kontext-URL, Zielendpunkt und technische Identität kontrolliert hinterlegen.

Qualität

Erfolg und Fehler testen

Beispieldaten, Dubletten, ungültige Payloads und nicht erreichbare Ziele gezielt prüfen.

Bereitstellung

Erweiterung anfordern

Benötigten Node und betroffene Instanz an die Administration übergeben.

Enthaltene Bausteine

Stellio

Subscriptions verwalten

Subscriptions abrufen, mit Dublettenprüfung erstellen und gezielt wieder löschen.

Stellio

Kontextdaten schreiben

NGSI-LD-Entitäten und Änderungen mit post-to-stellio an den Context Broker übergeben.

DataOps

NGSI-LD aufbauen

Eingangsdaten mit ngsi-builder in eine wiederverwendbare, Smart-Data-Model-nahe Struktur überführen.

Datenquellen

DWD abrufen

Wetterbeobachtungen, Vorhersagen und Wetterwarnungen des Deutschen Wetterdienstes verarbeiten.

Datenquellen

Pegelstände abrufen

Messwerte aus PEGELONLINE als strukturierte Nachrichten in einen Flow übernehmen.

Datenquellen

RSS-Feeds lesen

Einträge aus RSS-Quellen abrufen, normalisieren und fachlich weiterverarbeiten.

MQTT

Nachrichten untersuchen

MQTT-Verbindungen und eingehende Nachrichten während Entwicklung und Fehlersuche sichtbar machen.

Die veröffentlichten Node-Typen heißen stellio-get-subscriptions, stellio-create-subscription, stellio-delete-subscription, post-to-stellio, ngsi-builder, dwd-weather, dwd-weatherwarnings, pegelonline, rss-feed und mqtt-debug-in.

Paket für ein UDSP-Projekt bereitstellen lassen

Prüfen Sie zuerst in der Node-RED-Palette, ob der benötigte Bibliotheks-Node bereits verfügbar ist. Fehlt er, teilen Sie der Administration den vollständigen Paketnamen, den benötigten Node, den vorgesehenen Datenfluss und die betroffene Node-RED-Instanz mit. Installieren oder aktualisieren Sie das Paket nicht selbst in einer produktiven Instanz.

Die Administration kann den geprüften Paketstand über Manage palette in einer vorgesehenen Instanz erproben. Für den produktiven Einsatz versioniert sie die freigegebene Abhängigkeit gemeinsam mit dem Flow-Projekt und rollt sie über den bestehenden Bereitstellungsweg aus. Das vollständige Vorgehen steht unter Node-RED-Erweiterungen bereitstellen.

Veröffentlichten Paketstatus vor einem Neueinsatz prüfen

Die Flow Library führt derzeit Version 0.1.2. Das npm-Register kennzeichnet dieselbe Veröffentlichung aktuell als veraltet. Klären Sie deshalb vor einer neuen produktiven Abhängigkeit, ob Version 0.1.2 weiterhin der freigegebene Stand ist oder ein Nachfolgepaket verwendet werden soll. Bestehende Projekte pinnen ihre geprüfte Version und aktualisieren nicht ungeprüft.

Qualitätsregeln für gemeinsame Flows

  • Verwenden Sie einen Bibliotheks-Node nur für die Aufgabe, die er tatsächlich kapselt; fachliche Sonderlogik bleibt im eigenen Flow.
  • Machen Sie Datenraum, Entitätstyp und Kontext-URL in der Konfiguration eindeutig sichtbar.
  • Legen Sie technische Zugangsdaten in Credential-Feldern ab und niemals in Function Nodes, Change Nodes oder Git-Dateien.
  • Prüfen Sie die erzeugte NGSI-LD-Struktur gegen das vereinbarte Datenmodell, nicht nur gegen einen erfolgreichen HTTP-Status.
  • Führen Sie Fehlermeldungen in einen sichtbaren Catch-, Retry- oder Benachrichtigungspfad.
  • Dokumentieren Sie im Projekt-README Quelle, Zeitplan, Zielsystem, verantwortliche Stelle und Wiederanlaufverhalten.

Damit weiterarbeiten

Praxisanleitung

Daten verarbeiten

Geladene Rohdaten prüfen, vereinheitlichen und ein optionales Mapping im Flow umsetzen.

Anleitung öffnen
Administration

Node-RED-Erweiterungen bereitstellen

Zusätzliche Nodes kontrolliert erproben, freigeben und exakt versioniert ausrollen.

Admin-Anleitung öffnen
Praxisanleitung

Node-RED-Flows mit Git sichern

Projekt, Abhängigkeiten und Änderungen nachvollziehbar versionieren.

Anleitung öffnen
Praxisanleitung

Stellio mit QuantumLeap verbinden

Eine Historisierungs-Subscription mit dem Bibliotheks-Node einrichten.

Anleitung öffnen

Externe Referenzen