Zum Hauptinhalt springen

Erste Schritte mit Flow (Node-RED)

🎬 Build a data flow · 33초 · 2026.09 기준 화면

Über das Menü /ui/flow können Sie auf die im Gateway integrierte Node-RED-Umgebung zugreifen. Node-RED ist ein Low-Code-Tool, mit dem Datenflüsse durch Drag-and-Drop von Blöcken (Knoten) erstellt werden. Sie können Tag-Werte des Gateways lesen und schreiben, Verbindungen zu externen Systemen über MQTT/HTTP herstellen und Automatisierungen wie Alarme, Logging und Berechnungen erstellen.

Node-RED im Containermodus (ab 2026.05)

Node-RED 4.1.10 + Node.js 20 (beide global im Image installiert). Beim ersten Booten des Containers werden userDir.seed (node_modules + PlantPulse Edge / node-red-contrib-opcua Knoten) automatisch nach /data1/pp-data/node-userdir/ kopiert (ab dem zweiten Bootvorgang bleiben Benutzer-Flows erhalten). Benutzer-Flows bleiben auch nach einem Image-Upgrade bestehen. Der Flow-Tab ist leer — Beispiel-Flows werden nicht im Image hinterlegt, sondern aus der Dokumentation importiert (Beispiel-Flows zum Importieren).

Die PlantPulse-spezifischen Knoten (pp-tag-value-read / pp-tag-value-write / pp-opc-* / pp-tag-list) sind über absolute Pfad-Symlinks mit node/conf/plantpulse-edge-nodes/ des Images verbunden — der Entrypoint garantiert dies bei jedem Bootvorgang (verhindert das Problem, dass Symlinks alter nativer Versionen mit relativen Pfaden in Containern brechen).

Bevor Sie dieses Dokument lesen

Schließen Sie die Schritte bis 자주 하는 작업 → 새 PLC 연결 추가 / 태그 등록 ab und beginnen Sie in einem Zustand, in dem mindestens ein Tag in Echtzeit erfasst wird. Node-RED verwendet diese Tag-Werte als Eingabe.

1. Zugriff​

Greifen Sie über den Browser auf das Gateway zu und navigieren Sie über das linke Menü zu Flow (Node-RED) oder direkt zu http://<gateway>/ui/flow.

2. Bildschirmaufbau​

Flow-Editor-Bildschirm — Nummern in Lesereihenfolge

NummerBereichBeschreibung
①Linke PaletteListe der verfügbaren Knoten. Diese sind nach Kategorien gruppiert; in der Kategorie PlantPulse Edge befinden sich die Gateway-spezifischen Knoten(pp-tag-value-read · pp-tag-value-write · pp-opc-* · pp-tag-list)
②Flow-TabsErmöglicht die Aufteilung von Flows auf mehrere Seiten. Erstellen Sie neue Tabs mit +
③Mittlerer WorkspaceHier werden Knoten platziert und mit Drähten verbunden
④Rechte Seitenleisteinfo zeigt die Hilfe zum ausgewählten Knoten, debug zeigt die Ausgangslogs von debug-Knoten
⑤Oben rechts DeployMuss geklickt werden, damit das Gateway die Änderungen übernimmt

3. Grundlegende Bedienung — Nützliche Tastenkürzel​

AktionMethode
Knoten hinzufügenAus der Palette in den Workspace ziehen
Knoten konfigurierenDoppelklick auf Knoten → Bearbeiten im rechten Panel → Done
Knoten verbinden (Draht)Ausgabepunkt (rechts) eines Knotens ziehen und auf den Eingangspunkt (links) eines anderen Knotens legen
Draht trennenDraht anklicken und auswählen, dann Delete
MehrfachauswahlBereich mit Shift ziehen oder mit Ctrl/Cmd + 클릭 weitere Elemente auswählen
Kopieren / EinfügenCtrl/Cmd + C / Ctrl/Cmd + V
SucheCtrl/Cmd + F — Suche nach Knotenname in der Palette
Flow importierenMenü → Importieren → JSON einfügen (Beispiel-Flows aus Beispiel-Flows zum Importieren können direkt importiert werden)
Änderungen werden erst nach dem Deploy aktiv

Auch wenn Knoten hinzugefügt, gelöscht oder geändert werden, erkennt das Gateway diese Änderungen erst, wenn Deploy geklickt wird. Ein roter Punkt (●) an einem Knoten bedeutet „nicht gespeicherte Änderungen vorhanden“.

4. Grundstruktur der Nachricht (msg)​

Daten, die zwischen Knoten fließen, sind immer JavaScript-Objekte namens msg. Die am häufigsten verwendeten Felder sind:

FeldBedeutung
msg.payloadPayload (Hauptdaten). Kann Zahlen, Zeichen, Objekte oder Buffer sein
msg.topicTopic (Klassifizierungslabel). Wird häufig in MQTT, Switch, Join etc. verwendet
msg.timestampZeitstempel (bei Bedarf manuell befüllt)
msg._msgidVon Node-RED automatisch zugewiesene eindeutige ID zur Nachverfolgung

Die meisten Knoten arbeiten nur mit msg.payload.

5. Edge-Knoten — Überblick (Gateway-spezifisch)​

In der Palette unter der Kategorie PlantPulse Edge finden Sie die vom Gateway registrierten Knoten (insgesamt 7). Zunächst betrachten wir die zwei wichtigsten für Ein- und Ausgänge, da sie die Basis fast aller IIoT-Flows bilden.

IconKnotenEnglischer NameFunktionAufgerufenes REST
⬇Tag-Wert lesen (pp-tag-read)read tag valueAktuellen Wert eines Tags abrufen (Cache oder direkter PLC-Read)GET /api/v1/tag/{tagId}/value
⬆Tag-Wert schreiben (pp-tag-write)write tag valueWert in ein Tag schreiben (sofortige Spiegelung in der PLC)POST /api/v1/tag/{tagId}/value
inject (1s) ──▶ 태그값 읽기 ──▶ 처리 (function/switch/...) ──▶ 태그값 쓰기 / mqtt out / debug / file ...

So finden Sie die Knoten — Geben Sie read tag oder PlantPulse in das Suchfeld der Palette ein, um nur diese Knoten zu filtern. Sie sind in einem blassen Pastellblau gefärbt.

Häufig leer gelassene Felder in den KnoteneinstellungenMethode zur dynamischen Befüllung
Tag IDDynamische Zuweisung über msg.tag_id = 'TAG_...' im Flow (ein Knoten kann für mehrere Tags wiederverwendet werden)
Value (Schreibknoten)Befüllung im Flow über msg.value oder msg.payload
Schreiben ist riskant — Erst mit Test-Tags validieren

Bevor Sie Schreibvorgänge an realen Anlagen anwenden, validieren Sie diese ausreichend mit einem externen Simulator oder Test-Tags. Schreibrechte sollten nur für Tags vergeben werden, die mit dem Betriebsteam abgestimmt wurden.

Weitere Details zu Feldern / Ein- und Ausgängen / Protokollunterstützung → Edge-Kategorie (Tag lesen/schreiben)

6. Der erste Flow — Hello World​

Ziel: Alle 5 Sekunden einen Tag lesen und im Debug-Seitenbereich ausgeben.

  1. Knoten inject aus der Palette ziehen → Doppelklick → Repeat: interval every 5 seconds → Done
  2. Knoten PlantPulse Edge → Tag-Wert lesen ziehen → Tatsächliche Tag-ID (z. B. TAG_TEST_00042) eingeben → Done
  3. Knoten debug aus der Palette ziehen
  4. Die drei Knoten in der Reihenfolge inject → 태그값 읽기 → debug mit Drähten verbinden
  5. Oben rechts auf Deploy klicken
  6. Den Reiter debug in der rechten Seitenleiste öffnen und prüfen, ob alle 5 Sekunden ein Wert erscheint

Dieses Muster (periodischer Trigger → Lesen → Verarbeitung) ist die Grundform aller IIoT-Flows.

7. Nächste Schritte​

In der Reihenfolge des linken Menüs:

  1. Grundlegende Knotenbedienung — Funktionen von 14 häufig genutzten IIoT-Knoten
  2. Edge-Knoten (Tag lesen/schreiben) — Gateway-spezifische Knoten (Detailversion des Überblicks in Abschnitt 5)
  3. MQTT-Knoten im Detail — Broker-Konfiguration / Pub / Sub / LWT / Birth
  4. OPC-UA-Knoten im Detail — Endpoint / Item / Client / Subscribe / Browse
  5. Sparkplug B-Knoten im Detail — Group / Edge / Birth-Death / Senden und Empfangen
  6. IIoT-Beispielsammlung — 12 häufige Muster für den Vor-Ort-Einsatz
  7. Beispiel-Flows zum Importieren — 6 fertige Flows zum direkten Import und Start
  8. Fehlerbehebung bei Flows — Häufige Fallstricke

8. Weiterführende Informationen​

  • Im OPC UA Server (/ui/opcua) können Sie alle aktuell vom Gateway verwalteten Tags, Werte und Knoten-IDs auf einen Blick sehen. → OPC UA Server verwenden
  • Die REST API selbst wird im Kapitel 고급 / 통합 파트너용 → REST API behandelt. Die Node-RED-Knoten pp-tag-read / pp-tag-write sind dünne Wrapper für diese API.
  • Offizielles Node-RED Handbuch: <https://nodered.org/docs/>