Der Flow-Editor ist der Ort, an dem Sie Flows erstellen und ändern. Sie platzieren Blöcke auf einer Arbeitsfläche, verbinden deren Ausgänge mit den Eingängen anderer Blöcke, füllen ihre Einstellungen aus und veröffentlichen den Flow. Der Entwurf wird während der Arbeit gespeichert; bis zur Veröffentlichung läuft nichts.
Flow erstellen
- Öffnen Sie Automatisierung. Die Liste zeigt jeden Flow jedes Hosts, zuerst die Root-Flows.
- Wählen Sie Neuer Flow.
- Füllen Sie den Dialog aus:
| Feld | Bedeutung |
|---|---|
| Host | IoT oder Allgemein. „Wo der Flow läuft und welche Blöcke er verwenden kann. Dies lässt sich später nicht mehr ändern.“ |
| Name | Der Name des Flows |
| Slug | Seine kurze ID: Kleinbuchstaben, Ziffern, - und _, bis zu 32 Zeichen. Sie lässt sich später nicht mehr ändern. |
| Starten mit | Ein leerer Flow oder eine Vorlage des Hosts. Siehe Flow-Vorlagen. |
- Wählen Sie Erstellen. Der Editor öffnet sich.
Jeder Flow beginnt mit einem Block Flow-Eingang. Er ist der Eingang für Nachrichten, die ein anderer Flow übergibt, und bei einem Root-Flow der Eingang für seine Gerätenachrichten. Er kann nicht gelöscht werden; lassen Sie ihn unverbunden, wenn kein anderer Flow Nachrichten an diesen Flow übergibt.
Der Editor auf einen Blick
| Bereich | Inhalt |
|---|---|
| Kopfleiste | Name und Status des Flows, der Speicherstatus (Wird gespeichert…, Gespeichert, Noch nicht gespeichert), Live-Kennzahlen (Live oder Alle 5 s, Nachrichten pro Sekunde, wartende Nachrichten, Fehler in 24 h) sowie die Schaltflächen Aktivität, Webhooks, Test, Versionen, Fehlgeschlagene Nachrichten, Entwurf verwerfen und Veröffentlichen |
| Palette | Blocktypen: alle Blöcke des Hosts, alphabetisch, mit Suchfeld |
| Arbeitsfläche | Die Blöcke und ihre Verbindungen |
| Seitenleiste | Die Einstellungen des ausgewählten Blocks oder das Panel Aktivität |
Webhooks erscheint, sobald ein veröffentlichter Flow einen Auslöser Webhook hat. Versionen erscheint nach der ersten Veröffentlichung. Entwurf verwerfen erscheint, solange der Entwurf von der veröffentlichten Version abweicht.
Blöcke hinzufügen
- Ziehen Sie einen Block aus der Palette auf die Arbeitsfläche oder klicken Sie darauf.
- Oder klicken Sie mit der rechten Maustaste auf die Arbeitsfläche und wählen Sie Block hier hinzufügen…, oder klicken Sie mit der rechten Maustaste auf eine Verbindung und wählen Sie Block dazwischen hinzufügen…. Die Auswahl Block hinzufügen sucht nach Name, Beschreibung oder Typ.
- Ein nicht verwendbarer Block wird ausgegraut angezeigt, mit dem Grund: „Ihr Tarif enthält diesen Block nicht.“, „Dieser Block benötigt eine Konfiguration, die noch nicht eingerichtet ist.“, „Das Modul, zu dem dieser Block gehört, ist nicht installiert.“, „Dieser Block läuft nicht auf dem Host dieses Flows.“ oder „Sie benötigen die Berechtigung … zur Verwendung dieses Blocks.“
Blöcke verbinden
- Ziehen Sie von einem Ausgangsport (rechte Seite eines Blocks) zu einem Eingangsport (linke Seite eines anderen Blocks).
- Ein Block kann mehrere Ausgänge haben, zum Beispiel ja und nein, oder einen pro Regel eines Switch. Beim Überfahren eines Ports wird sein Name angezeigt.
- Die meisten Blöcke haben außerdem einen Ausgang error. Verbinden Sie ihn, um die Fehler dieses Blocks selbst zu behandeln; andernfalls gehen Fehler an die Catch-Auslöser des Flows. Siehe Auslöserblöcke.
- Um das Ende einer Verbindung zu verschieben, ziehen Sie ihren Griff auf einen anderen Port. Um zu ändern, welchem Ausgang eine Verbindung entspringt, klicken Sie sie mit der rechten Maustaste an und wählen Port ändern….
- Wählen Sie eine Verbindung aus und drücken Sie Entf, oder klicken Sie sie mit der rechten Maustaste an und wählen Verbindung löschen.
Sobald der Flow läuft, zeigen Verbindungen eine Anzahl von Nachrichten an („12 Nachrichten“).
Einen Block bearbeiten
Klicken Sie auf einen Block. Die Seitenleiste öffnet sich mit drei Registerkarten:
| Registerkarte | Zeigt |
|---|---|
| Einstellungen | Bezeichnung, Beschreibung (eine Notiz für Menschen, ohne Funktion) und die eigenen Einstellungen des Blocks. „Änderungen wirken sofort beim Tippen. Rückgängig mit Strg+Z.“ |
| Nachrichten | Die letzten Nachrichten, die den Block passiert haben, Ein und Aus, mit Mit dieser Eingabe testen. Nachrichteninhalte werden nur Personen angezeigt, die debuggen dürfen. |
| Hilfe | Die Referenz des Blocks: was er tut, seine Ports und Einstellungen |
Einstellungen mit einem Wert lassen Sie deren Art wählen: Zahl, Text, Ja / Nein, JSON, Variable (ein Pfad wie msg.payload.level oder flow.limit), Ausdruck, Umgebungsvariable oder Aktuelle Zeit. Einstellungen, die eine Verbindung wählen (ein MQTT-Broker, ein HTTP-Endpunkt), listen Ihre Verbindungen dieses Typs auf, mit Verbindungen verwalten. Siehe Verbindungen und Geheimnisse.
Der Block Script öffnet einen Code-Editor mit Suchen und Ersetzen, Formatierung, Vollbild und Script testen. Siehe Der Script-Block.
Mit mehreren Blöcken arbeiten
| Aktion | So geht’s |
|---|---|
| Mehrere auswählen | Umschalt- oder Strg-Klick, oder Umschalt halten und einen Rahmen ziehen (Blöcke mit einem Rahmen auswählen) |
| Kopieren, ausschneiden, einfügen, duplizieren | Das Kontextmenü per rechter Maustaste oder die üblichen Tastenkürzel |
| Gruppieren | Auswählen, rechte Maustaste, Gruppieren…; der Gruppe einen Namen und eine Farbe geben |
| Kommentieren | Rechte Maustaste auf die Arbeitsfläche, Kommentar hier hinzufügen. Kommentare haben beim Ausführen des Flows keine Wirkung. |
| Block überspringen | Rechte Maustaste, Überspringen: der Block bleibt, wird aber nicht ausgeführt |
| Aufräumen | Blöcke anordnen in der Werkzeugleiste |
| Suchen | Block suchen durchsucht Namen, Typen, Beschreibungen und IDs |
| Navigieren | Hinein- und herauszoomen, An Bildschirm anpassen, Minikarte, Vollbild |
Drücken Sie ? auf der Arbeitsfläche für die Tastenkürzel.
Probleme
Der Editor prüft den Flow während des Aufbaus. Probleme werden an den Blöcken markiert und unter Probleme aufgelistet:
| Problem | Bedeutung |
|---|---|
| „Einstellung ist erforderlich.“ | Füllen Sie die Einstellung aus. |
| „Dieser Block ist mit nichts verbunden.“ / „Mit diesem Block ist nichts verbunden.“ | Verbinden Sie ihn oder entfernen Sie ihn. |
| „Ein Flow kann nur einen Block Flow-Eingang haben.“ | Entfernen Sie den überzähligen. |
| „Diese Blöcke senden Nachrichten in einer Schleife, die nie wartet…“ | Fügen Sie in die Schleife einen wartenden Block (eine Verzögerung, einen Timer, einen Aufruf) ein oder unterbrechen Sie die Schleife. |
| „Ein Block Flow ausführen kann seinen eigenen Flow nicht ausführen.“ | Wählen Sie einen anderen Flow. |
| „Dieser Block ist hier nicht verfügbar. Er behält seine Verbindungen, kann aber nicht ausgeführt werden.“ | Der Block stammt aus einem Import und existiert auf diesem Host nicht. |
Ein Flow mit Fehlern kann nicht veröffentlicht werden: „Beheben Sie zuerst die auf der Arbeitsfläche markierten Probleme.“
Speichern
Der Entwurf wird während der Bearbeitung automatisch auf dem Server gespeichert. Der Speicherstatus zeigt Wird gespeichert…, Gespeichert oder „Nicht gespeichert. Erneut versuchen“. Ungespeicherte Änderungen werden außerdem in Ihrem Browser aufbewahrt: Wenn Sie den Editor verlassen und zurückkehren, bietet er an, sie wiederherzustellen.
Hat jemand anders denselben Flow inzwischen gespeichert, zeigt der Editor „Dieser Flow wurde von jemand anderem gespeichert“ mit:
- Zusammenführen: behält, was nur eine Seite geändert hat, und speichert das Ergebnis als Entwurf. Prüfen Sie es vor dem Veröffentlichen; Rückgängig führt zu Ihrer Version zurück.
- Mit meiner überschreiben: behält Ihre Version.
Veröffentlichen
- Wählen Sie Veröffentlichen. Der Dialog „Name veröffentlichen“ sagt: „Dies wird Version n des Flows und startet die Ausführung.“
- Lesen Sie die Warnungen und gegebenenfalls die Liste der Änderungen.
- Wählen Sie unter Was neu startet: Nur die geänderten Blöcke (Standard), Jeder Block der geänderten Flows oder Jeder Flow dieses Hosts. Blöcke, die nicht neu starten, behalten ihren Speicher.
- Lassen Sie Flow nach dem Veröffentlichen ausführen angekreuzt, um ihn zu starten, oder deaktivieren Sie es, um ihn ausgeschaltet zu veröffentlichen.
- Optional können Sie eine Notiz („Was geändert wurde“) schreiben. Sie wird in der Versionsliste angezeigt.
- Hat der Flow Blöcke, die außerhalb davon wirken (Risiko Code, Steuerung, Extern oder System), listet der Dialog sie auf: Kreuzen Sie Ich verstehe, was diese Blöcke tun an und geben Sie den Namen des Flows ein.
- Wählen Sie Deploy (oder Confirm and deploy).
Ein Deploy kann abgelehnt werden: wegen eines Problems, wegen eines Tariflimits („Your plan allows n flows: …“), wegen fehlender Berechtigung oder weil zwischenzeitlich jemand deployt hat. Der Dialog zeigt an, welcher Grund zutrifft. Siehe Flow limits.
Ein Flow, der ein Root ist, muss eingeschaltet und freigegeben bleiben: „This flow is a root, so it must stay switched on and approved: device data would not be stored otherwise.“
Schreibgeschützte Flows
Sie sehen „You can view this flow but not change it.“, wenn Ihnen die Berechtigung zur Verwaltung der Automatisierung fehlt, wenn der Flow gelöscht wurde (stellen Sie ihn zuerst wieder her) oder wenn ein Modul ihn erstellt hat (eine Regel in der Rules-Karte mit dem Badge Built by). Siehe Hosts, the root flow and profile root flows und Versions, testing and rollback.