Senden von Daten von Node-RED zu Tulip mit Tulip-Knoten

Übersicht

Es gibt drei Hauptmethoden, um Daten von Node-RED (z.B. Geräte- oder externe Systemdaten) an Tulip zu senden:

1. über die Tulip Machine API
2. über die Tulip Tables API
3. über eine Connector-Antwort *Hinweis: Erfordert zuerst einen Connector, der von Tulip stammt.

Um die Kommunikation über die Methoden 1 und 2 zu rationalisieren, hat Tulip drei First-Party Nodes geschaffen:

1. tulip-tag: Senden von Daten an Machine Attributes API mit erweiterten Funktionen - nur Tulip Edge Device2. machine-attribute: Senden von Daten an Machine Attributes API von jedem Gerät aus 3. tables: Senden und Empfangen von Daten an/von der Tables API von jedem Gerät aus

Alle drei oben aufgeführten Knoten sind auf Tulip Edge-Geräten vorinstalliert. Zusätzlich sind die oben genannten Knoten 2 und 3 in der Node-RED Library zum Download auf jedes Gerät veröffentlicht. Sie können gefunden werden unter here{target=_blank}.

Daten an ein Tulip Machine-Attribut senden

Anmerkung: Dieser Abschnitt geht davon aus, dass ein Tulip Maschinenattribut erstellt wurde. Weitere Informationen finden Sie in diesem Leitfaden.

Von einem Tulip Edge-Gerät: der tulip-tag Node

Der tulip-tag Node ist kompatibel mit Tulip Edge Devices, die mit Software-Version 51 oder höher laufen.

1. Um den tulip-tag Knoten zu verwenden, ziehen Sie ihn zunächst aus der Palette in das Editor-Fenster. Doppelklicken Sie auf den Knoten, um sein Konfigurationsfenster zu öffnen.
2. Klicken Sie auf den Bleistift, um eine neue Tag-Liste hinzuzufügen:
   :::(Warning) (Achtung! Tag-Listen) Es wird nur eine aktive Tag-Liste pro Edge Device unterstützt. Stellen Sie sicher, dass alle Flows, die andere Tag-Listen ausführen, deaktiviert sind, bevor Sie beginnen. ::: <Tragen Sie hierdas Foto aus dem vorhandenen Artikel ein>
3. Klicken Sie auf +Hinzufügen, um ein neues Tag hinzuzufügen. Jedes Tag besteht aus drei Teilen: einer ID, einem Label und einem Typ.
4. Tag-ID: ein eindeutiger, codeähnlicher Bezeichner für das Tag. Einmal erstellt, sollte sie sich nicht mehr ändern. Gültige Zeichen sind Buchstaben, Ziffern (dürfen nicht mit einer Ziffer beginnen) und Unterstriche. Beispiele: part_count, myState1.
5. Tag-Bezeichnung: die von Menschen lesbare Bezeichnung für das Tag. Um die Markierung umzubenennen, aktualisieren Sie einfach die Bezeichnung, nicht die ID. Beispiel: "Teilezählung".
6. Typ: Der Datentyp - String, Integer, Float oder Boolean. Muss mit dem Typ des zugeordneten Maschinenattributs übereinstimmen.

Eine Beispielkonfiguration der Tag-Liste finden Sie unten:

1. Sobald alle Tags hinzugefügt sind, klicken Sie auf Hinzufügen, um alle Änderungen zu speichern.
   Beachten Sie, dass alle Tags als nicht zugeordnet angezeigt werden - dies ist zu erwarten, da die Tags noch kein zugehöriges Tulip-Maschinenattribut haben.
2. Sobald die Tag-Liste erstellt ist, gibt es zwei Methoden, um Flussinhalte mit Listeneinträgen zu verknüpfen. Beide hängen von der Tag Config Checkbox im tulip-tag Knoten ab:
3. Wenn Tag Config aktiviert ist (true), wird ein Tag-Knoten für jedes Maschinen-Attribut benötigt. Verbinden Sie den Knoten mit dem tulip-tag Knoten und wählen Sie das relevante Maschinen-Attribut mit dem Tag Node's Select Tag drop-down. Beachten Sie, dass der Tag-Knoten alles, was in msg.payload gefunden wird, als beabsichtigte Eingabe nimmt.

Der folgende Ablauf verwendet zum Beispiel zwei Inject-Knoten, um entweder Hallo oder Welt einzugeben. Jeder hat seinen eigenen Tulip-Tag-Knoten, wobei das Feld Select Tag entsprechend zugeordnet ist:
{height="" width=""}
4. Wenn Tag Config nicht angekreuzt ist (false), wird ein Tag-Knoten für alle Maschinenattribute benötigt. Der Knoten nimmt ein vollständiges Objekt aller Tag-Werte auf und ordnet sie automatisch dem jeweiligen Maschinenattribut zu. Beachten Sie, dass das Eingabeobjekt genau mit der Tag-Liste übereinstimmen muss, sonst gibt der Knoten einen Fehler aus.
Der folgende Ablauf verwendet zum Beispiel einen Inject-Knoten. Der Knoten übergibt das gezeigte Objekt an den Tag-Knoten, der dann helloworld1 auf die Tag-Liste itemhello und helloworld2 auf die Tag-Liste item world zuordnet:
{height="" width=""}

Die Daten werden nun erfolgreich an Tulip gesendet. Tags können als Maschinendatenquellen gefunden werden - um sie mit einem Maschinenattribut zu verknüpfen, finden Sie jedes einzelne unter dem Edge Device als Maschinendatenquelle.
Das Bild unten zeigt drei Tags, die auf einem Edge Device vorhanden sind:

Von jedem Gerät mit Node-RED: der machine-attr Node

1. Um den machine-attr-Knoten zu verwenden, navigieren Sie zuerst zum Attribut Maschine in Tulip.
2. Klicken Sie auf , um mögliche Datenquellen zu öffnen, und wählen Sie "Tulip API". Kopieren Sie die angezeigten Informationen:
3. Fügen Siein Node-RED einen Tulip machine-attr Knoten hinzu. Falls noch nicht konfiguriert, konfigurieren Sie eine neue Tulip-Authentifizierung (Link erforderlich - kopieren Sie von hier: https://support.tulip.co/docs/using-node-red-with-the-tulip-api).
4. Fügen Sie die Maschinenattribut-Daten von Tulip in das Feld Geräte-Info ein.

Der Maschinenattribut-Knoten ist jetzt konfiguriert. Alle Daten (vom gleichen Typ wie das Maschinenattribut), die in msg.payload vorhanden sind, sobald sie in den Knoten eingegeben werden, erscheinen im Maschinenattribut in Tulip.