Erste Schritte
Diese Seite erklärt die Grundbegriffe, die Sie für die Arbeit mit den Nodes brauchen, und zeigt, wie Sie die mitgelieferten Beispielflows nutzen.
Grundbegriffe aus Node-RED
Wenn Sie Node-RED bereits kennen, können Sie diesen Abschnitt überspringen.
| Begriff | Bedeutung |
|---|---|
| Flow | Eine Registerkarte im Editor mit verbundenen Nodes. Flows werden mit Deploy aktiviert. |
| Node | Ein Baustein mit einer Aufgabe. Nodes haben bis zu einen Eingang (links) und einen oder mehrere Ausgänge (rechts). |
Nachricht (msg) | Das Objekt, das zwischen Nodes fließt. Die Nutzdaten liegen in msg.payload, weitere Eigenschaften wie msg.topic können hinzukommen. |
| Inject-Node | Löst einen Flow manuell oder zeitgesteuert aus. Die meisten Data Connectors werden auf diese Weise angestoßen. |
| Debug-Node | Zeigt Nachrichten in der Seitenleiste Debug an. Ideal, um Ausgaben eines Nodes zu prüfen. |
| Typed Input | Ein Eingabefeld, dessen Typ Sie wählen: fester Wert, msg-Eigenschaft, Flow- oder Global-Kontext oder Umgebungsvariable (env). |
| Kontext | Zwischenspeicher für Werte über mehrere Nachrichten hinweg. Flow-Kontext gilt pro Flow, globaler Kontext für die gesamte Instanz. |
| Zugangsdaten (Credentials) | Felder, die verschlüsselt gespeichert und nicht in Flow-Exporten ausgegeben werden, zum Beispiel Passwörter und API-Schlüssel. |
Einen Node benutzen
Platzieren
Ziehen Sie den Node aus der Palette auf den Arbeitsbereich.
Konfigurieren
Doppelklicken Sie den Node und füllen Sie die Felder aus. Die Hilfe in der Seitenleiste erklärt jedes Feld.
Verdrahten
Verbinden Sie einen Inject-Node mit dem Eingang und einen Debug-Node mit dem Ausgang.
Deployen und testen
Klicken Sie auf Deploy und lösen Sie den Inject-Node aus. Prüfen Sie die Ausgabe in der Debug-Seitenleiste.
Viele Nodes zeigen unter ihrem Symbol einen Status an, zum Beispiel einen grünen Punkt mit der Anzahl geladener Datensätze oder einen roten Ring mit einer Fehlermeldung. Die Node-Seiten dieser Dokumentation beschreiben vorhandene Statusanzeigen.
Beispielflows importieren
Jedes Paket liefert Beispielflows mit, die zeigen, wie der Node verdrahtet wird.
- Öffnen Sie das Menü oben rechts und wählen Sie Importieren.
- Wechseln Sie auf die Registerkarte Beispiele.
- Öffnen Sie den Eintrag des Pakets, zum Beispiel
@htag/node-red-contrib-hypertegrity-weather, und wählen Sie den gewünschten Flow. - Bestätigen Sie mit Importieren. Der Flow erscheint als neue Registerkarte.
Alternativ bietet jede Node-Seite dieser Dokumentation einen Link zum Herunterladen der JSON-Datei des Beispielflows an. Laden Sie die Datei herunter und importieren Sie sie anschließend über Importieren → Datei auswählen.
Beispielflows enthalten keine Passwörter oder API-Schlüssel. Öffnen Sie nach dem Import die Nodes mit Zugangsdaten und tragen Sie Ihre eigenen Werte ein.
Sprache des Editors
Die Nodes sind in Deutsch und Englisch übersetzt. Node-RED verwendet die Sprache des Browsers oder die Einstellung unter Benutzereinstellungen → Ansicht → Sprache. Die Feldbezeichnungen in dieser Dokumentation entsprechen der deutschen Oberfläche; in der englischen Version dieser Dokumentation finden Sie die englischen Bezeichnungen.
Umgebungsvariablen verwenden
Felder vom Typ Typed Input akzeptieren den Typ env. So halten Sie URLs, Tenant-Namen oder Schlüssel aus den Flows heraus und pflegen sie zentral. In Node-RED setzen Sie Umgebungsvariablen beim Start des Prozesses oder über die Flow-Einstellungen unter Umgebungsvariablen.
Wie es weitergeht
Typischer Datenfluss
Von der Quelle bis in den Context Broker: wie die Nodes zusammenspielen.
Seite öffnen