Workflows
Free & PremiumWorkflows sind lokale Abläufe aus Knoten: Ein Auslöser startet sie, die Schritte laufen auf diesem Mac. Ein Workflow prüft zum Beispiel alle 15 Minuten eine Site und meldet sich, wenn sie nicht antwortet, oder baut dein Projekt, sobald sich eine Datei ändert. Nichts läuft in der Cloud. Workflows sind eine Beta-Funktion, in der Seitenleiste trägt der Eintrag das Abzeichen Beta.
Was du hier machst
- Workflows anlegen, aus Vorlagen starten, importieren, exportieren und ein- oder ausschalten: Die Liste
- Knoten auf der Zeichenfläche setzen, verbinden und ausfüllen: Der Editor
- Nachschlagen, was jeder Knoten kann: Die Knoten
- Werte zwischen Knoten weitergeben, Variablen und Geheimnisse nutzen: Daten, Ausdrücke und Variablen
- Wiederholungen, Zeitlimits und das Verhalten bei Fehlern festlegen: Einstellungen und Fehlerverhalten
- Nachsehen, was ein Lauf getan hat, Schritt für Schritt: Läufe
- Sehen und zurücksetzen, was sich ein Workflow zwischen den Läufen merkt: Gedächtnis
Aufbau der Seite
| Teil | Inhalt |
|---|---|
| Liste | alle Workflows als Tabelle mit Importieren und Neuer Workflow. Sie erscheint, wenn du Werkzeuge › Workflows öffnest |
| Editor | die Zeichenfläche eines Workflows mit Kopfzeile, Werkzeugleiste und dem Formular des gewählten Knotens. Er öffnet sich mit einem Klick auf einen Workflow |
| Läufe | das Feld unter dem Editor mit den Reitern Verlauf und Gedächtnis |
So fängst du an
- Öffne Werkzeuge › Workflows und klicke auf Neuer Workflow.
- Wähle eine Vorlage, zum Beispiel Site prüfen und melden, oder Leerer Workflow.
- Wähle im Editor einen Auslöser und häng mit Nächster Schritt weitere Knoten an.
- Füll die Felder jedes Knotens aus. Die Notiz in einer Vorlage sagt, was du eintragen musst.
- Klicke auf Ausführen und prüf im Feld Läufe, was jeder Schritt bekommen und geliefert hat.
- Schalte den Workflow mit dem Schalter An ein. Ab dann starten ihn seine Auslöser.
Über ⌘K findest du jeden Workflow mit Workflow ausführen: … und startest ihn von dort.
Was im Hintergrund passiert
- Die Schritte laufen in der App. Zeitplan, Webhook und Dateiänderung lösen nur aus, solange WebDonkey geöffnet ist. Ein Termin, der bei geschlossener App verstrichen ist, wird beim nächsten Start einmal nachgeholt.
- Ein Webhook-Auslöser lauscht nur auf
127.0.0.1, also nur für Programme auf diesem Mac. - Workflows, die gemeinsamen Variablen und das Gedächtnis reisen im App-Backup in der Kategorie Workflows mit. Der Verlauf der Läufe bleibt auf diesem Mac.
- Mit
wd workflowslistest, startest und schaltest du Workflows auch aus dem Terminal, siehe Weitere Werkzeuge.
Free und Premium
| Free | Premium | |
|---|---|---|
| Workflows | 3 | beliebig viele |
| Läufe im Verlauf je Workflow | die letzten 20 | bis zu 200 |
| Auslöser | Start von Hand, Zeitplan, Webhook | dazu App-Ereignis und Dateiänderung |
| Knoten | Anfragen, Befehle, Dateien, Benachrichtigungen, Logik und Daten | dazu Nur neue, Wert merken, Code ausführen, Mail senden, Datenbank-Abfrage, Dienst steuern, Site steuern, Remote-Befehl und KI-Prompt |
Ansehen, bearbeiten, speichern, exportieren und löschen kannst du jeden Workflow immer. Einschalten und ausführen lässt er sich nur, wenn er innerhalb der Free-Grenze liegt und keine Premium-Knoten enthält. Preise findest du unter webdonkey.io/pricing.
Die Liste Free & Premium
Auf Werkzeuge › Workflows siehst du alle Workflows in einer Tabelle: wodurch sie starten, wann sie zuletzt liefen, wann sie das nächste Mal dran sind und ob sie an sind. Von hier legst du neue an, auch aus Vorlagen, importierst und exportierst sie.
So findest du es
Seitenleiste Werkzeuge › Workflows. Aus dem Editor kommst du mit Alle Workflows zurück.
So gehst du vor
Einen Workflow anlegen
- Klicke auf Neuer Workflow. Der Dialog Neuer Workflow öffnet sich.
- Wähle Leerer Workflow (leere Fläche, dann einen Auslöser wählen) oder eine Vorlage.
- Der Editor öffnet sich mit dem neuen Workflow. Er ist ausgeschaltet.
Gibt es noch keinen Workflow, zeigt die Seite Bau deinen ersten Workflow mit denselben Möglichkeiten.
Die Vorlagen
| Vorlage | Tut | Braucht |
|---|---|---|
| Site prüfen und melden | ruft alle 15 Minuten eine Site auf und meldet sich, wenn sie nicht antwortet | Free |
| Deploy per Webhook | ein lokaler Webhook nimmt das Deploy-Signal an und führt deine Befehle im Ordner der Site aus | Free |
| Nächtlicher Datenbank-Dump | schreibt jede Nacht um 3 einen Dump einer Datenbank und meldet sich | Free |
| Eingehende Test-Mail zusammenfassen | fasst eine eintreffende Test-Mail mit der lokalen KI in zwei Sätzen zusammen | Premium |
| Build bei Dateiänderung | beobachtet einen Ordner und startet deinen Build, sobald sich eine Datei ändert | Premium |
Jede Vorlage enthält eine Notiz, was du eintragen musst, meist unter Variablen (etwa site_url oder site_dir). Im Free-Tarif öffnet eine Premium-Vorlage stattdessen den Dialog Die Vorlage „…“ braucht Premium mit den betroffenen Knoten.
Ausführen, einschalten, duplizieren, exportieren, löschen
- Ausführen (Play-Knopf in der Zeile, wenn Platz ist, oder Menü der Zeile): startet den Workflow über seinen Start von Hand, sonst über den ersten Auslöser. Hat der Start von Hand Eingabefelder, öffnet sich der Editor und fragt sie ab. Ohne Auslöser meldet die Liste „…“ hat keinen Auslöser, der ihn starten könnte.
- Status: Der Schalter An oder Aus schaltet die Auslöser ein oder aus.
- Duplizieren: legt eine ausgeschaltete Kopie „… (Kopie)“ an.
- Exportieren: speichert den Workflow als JSON-Datei. Variablen dieses Workflows reisen mit, Geheimnisse nie.
- Importieren (oben): liest eine solche Datei ein. Der Workflow kommt ausgeschaltet an.
- Löschen: fragt Workflow löschen? und entfernt den Workflow samt seinen Läufen und seinem Gedächtnis. Das lässt sich nicht rückgängig machen.
Das Menü einer Zeile hat Öffnen, Ausführen, Duplizieren, Exportieren und Löschen. Ein Klick auf den Namen öffnet den Workflow im Editor.
Felder und Optionen
| Spalte | Zeigt |
|---|---|
| Workflow | Name, darunter die Beschreibung, ein Sperrhinweis oder die Marke Importiert |
| Auslöser | die Auslöser, bei wenig Platz als Symbole. Kein Auslöser, wenn es keinen gibt |
| Letzter Lauf | Status des letzten Laufs (Läuft, Erfolgreich, Fehlgeschlagen, Abgebrochen) und wann, oder Noch nie gelaufen |
| Nächster Termin | Uhrzeit und Abstand des nächsten geplanten Laufs, sonst ein Strich |
| Status | Schalter An oder Aus |
Bei schmalem Fenster blendet die Liste Auslöser und Nächster Termin aus. Oben stehen die Zähler Gesamt, An und, falls nötig, Gesperrt. Im Free-Tarif zeigt ein Zähler, wie viele der 3 freien Workflows du nutzt.
Sperrhinweise unter dem Namen
| Hinweis | Bedeutung |
|---|---|
| Braucht Premium: … | der Workflow enthält Premium-Knoten, die genannt werden |
| Über dem Free-Limit | der Workflow liegt über der Grenze von 3 Workflows |
Importierte Workflows prüfen
Ein importierter Workflow läuft mit deinen Rechten. Deshalb trägt er die Marke Importiert, bis du ihn zum ersten Mal einschaltest oder ausführst. Davor zeigt der Dialog Importierten Workflow prüfen, was er auf diesem Mac tut:
- Führt Befehle aus
- Schreibt Dateien
- Geht ins Netz
Tut er nichts davon, steht dort Er führt keine Befehle aus, schreibt keine Dateien und geht nicht ins Netz. Mit Ansehen öffnest du ihn im Editor, mit Einschalten oder Ausführen bestätigst du. Schau dir fremde Workflows an, bevor du sie einschaltest.
Free und Premium
- Im Free-Tarif hast du 3 Workflows. Ist die Grenze erreicht, öffnet Neuer Workflow den Dialog Free-Grenze erreicht.
- Hast du mehr Workflows als erlaubt, etwa nach einem Downgrade, bleiben die 3 ältesten aktiv. Die anderen tragen Über dem Free-Limit: Ansehen, bearbeiten, exportieren und löschen geht weiter, einschalten und ausführen erst wieder mit Premium.
- Ein Workflow mit Premium-Knoten lässt sich auf Free speichern, aber nicht einschalten oder ausführen.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Das ist keine Workflow-Datei. | Die gewählte Datei ist kein Export eines Workflows | Eine Datei aus Exportieren wählen |
| Der Workflow in dieser Datei lässt sich nicht verwenden. | Der Workflow ist fehlerhaft oder stammt aus einer neueren Version | Die Details unter der Meldung lesen, WebDonkey aktualisieren |
| Der Schalter lässt sich nicht einschalten, ein Dialog zu Premium öffnet sich | Free-Grenze oder Premium-Knoten | Den Dialog lesen: Er nennt die Grenze oder die Knoten |
| Ein Workflow startet nicht nach Zeitplan | Er ist aus, oder WebDonkey war zum Termin geschlossen | Einschalten. Ein verpasster Termin wird beim nächsten Start einmal nachgeholt |
Siehe auch
Der Editor Free & Premium
Im Editor baust du einen Workflow auf einer Zeichenfläche: Knoten setzen, mit Linien verbinden, ihre Felder ausfüllen. Oben steuerst du Speichern, Einschalten und Ausführen, unten im Feld Läufe siehst du, was passiert ist.
So findest du es
Seitenleiste Werkzeuge › Workflows, dann einen Workflow anklicken oder im Menü der Zeile Öffnen. Ein neuer Workflow öffnet sich direkt im Editor.
So gehst du vor
- Wähle bei einem leeren Workflow unter Auslöser wählen einen Auslöser, etwa Zeitplan.
- Klicke unter dem Knoten auf Nächster Schritt und wähle den nächsten Knoten, etwa HTTP-Anfrage. Er hängt sich an und ist schon verbunden.
- Klicke den Knoten an. Rechts öffnet sich sein Formular, füll die Felder aus.
- Wiederhol das für weitere Schritte.
- Klicke auf Ausführen. Der Editor speichert vorher, wenn nötig, und startet einen Lauf.
- Prüf im Feld Läufe, was jeder Schritt geliefert hat, und schalte den Workflow mit An ein.
Felder und Optionen
Die Kopfzeile
| Element | Bedeutung |
|---|---|
| Alle Workflows | zurück zur Liste. Bei ungespeicherten Änderungen fragt der Editor mit Speichern, Änderungen verwerfen und Zurück dorthin |
| Name des Workflows | der Name. Ohne Namen lässt sich nicht speichern |
| Ungespeicherte Änderungen | Marke, solange etwas nicht gespeichert ist |
| Schalter An / Aus | an: Die Auslöser starten den Workflow. aus: Er läuft nur über Ausführen. Der Schalter wirkt sofort |
| Speichern | speichert den Workflow (⌘S) |
| Ausführen | startet jetzt einen Lauf über den Start von Hand, sonst über den ersten Auslöser, und speichert vorher, wenn nötig. Während der Lauf läuft, steht dort Stopp |
| Einstellungen | öffnet Einstellungen des Workflows |
| Mehr | Duplizieren, Exportieren … und Workflow löschen |
Hat der Start von Hand Eingabefelder, fragt Ausführen sie im Dialog Workflow ausführen ab.
Die Zeichenfläche
| Element | Bedeutung |
|---|---|
| Schritt hinzufügen | öffnet die Auswahl der Knoten mit Knoten suchen. Der neue Knoten kommt hinter den gewählten |
| Nächster Schritt | unter jedem Knoten, hängt direkt dahinter an |
| Notiz hinzufügen | legt eine Notiz auf die Fläche, Doppelklick zum Schreiben. Sie wird nicht ausgeführt und lässt sich nicht verbinden |
| Rückgängig (⌘Z), Wiederholen (⇧⌘Z) | nimmt Änderungen an der Fläche zurück oder stellt sie wieder her |
| Variablen | öffnet Variablen und Geheimnisse |
| Verkleinern, Vergrößern, Einpassen | Zoom. Einpassen zeigt den ganzen Ablauf |
| Übersicht | die Minikarte des ganzen Ablaufs, wenn das Fenster breit genug ist |
Die Auswahl der Knoten ist nach Auslöser, Logik, Daten, Ein-/Ausgabe, WebDonkey, KI und Fläche sortiert. Premium-Knoten tragen im Free-Tarif ein Schloss. Wählst du einen, erklärt ein Dialog, was Premium umfasst, statt den Knoten zu setzen. Ist Premium-Funktionen ausblenden eingeschaltet (Einstellungen › Navigation), fehlen sie in der Auswahl.
Verbinden, verschieben, löschen
- Verbinden: Zieh von einem Ausgang eines Knotens zum Eingang eines anderen. Lässt du die Linie über leerer Fläche los, fragt die Auswahl, was dort folgen soll.
- Mehrere Ausgänge: Wenn hat „wahr“ und „falsch“, Verteiler hat einen Ausgang je Regel und „sonst“. Mit Fehler-Ausgang nehmen in den Einstellungen eines Knotens kommt ein Ausgang Fehler dazu.
- Verschieben: Knoten mit der Maus ziehen.
- Duplizieren: ⌘D dupliziert die ausgewählten Knoten. Im Formular geht das mit Knoten duplizieren.
- Löschen: Knoten oder Linie anklicken, dann Rücktaste oder Entf. Im Formular geht das mit Knoten löschen.
Solange du nichts verschoben oder gezoomt hast, passt sich die Fläche der Fenstergröße selbst an. Danach bleibt dein Zoom, bis du Einpassen klickst.
Das Formular eines Knotens
Ein Klick auf einen Knoten öffnet rechts sein Formular. Oben stehen Knoten duplizieren, Knoten löschen und Schließen, darunter seine Felder und unten die Einstellungen des Knotens. Lange Hinweise klappst du mit Mehr anzeigen auf. In Feldern, die Ausdrücke annehmen, hilft Feld einsetzen. Die Breite des Formulars ziehst du am linken Rand, ein Doppelklick dort stellt die Standardbreite her.
Am Knoten selbst zeigen Marken, ob er ausgeschaltet ist, wie sein letzter Lauf ausging und ob er Premium braucht.
Was im Hintergrund passiert
Beim Speichern prüft WebDonkey den Ablauf und markiert, was nicht stimmt:
- Der Workflow braucht einen Namen.
- Dieser Knoten braucht einen Namen. oder ein doppelter Knotenname
- ein leeres Pflichtfeld („…“ ist ein Pflichtfeld.). Ausgeschaltete Knoten prüft WebDonkey dabei nicht
- eine Verbindung zu einem Knoten, den es nicht mehr gibt, eine doppelte Verbindung oder eine Verbindung von einem Ausgang, den der Knoten nicht hat
- In einen Auslöser führt keine Verbindung. und Eine Notiz lässt sich nicht verbinden.
- Die Verbindungen bilden einen Kreis.
Der Schalter An und Ausführen prüfen vorher die Free-Grenze und Premium-Knoten.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Zuerst einen Auslöser hinzufügen: Dort beginnt ein Lauf. | Der Workflow hat keinen Auslöser | Einen Auslöser wählen |
| Dieser Knoten braucht Premium. Der Workflow lässt sich speichern, aber nicht einschalten oder ausführen. | Ein Premium-Knoten im Free-Tarif | Den Knoten ersetzen oder Premium aktivieren |
| Diese Version von WebDonkey kennt diese Knotenart nicht. | Der Workflow stammt aus einer neueren Version | WebDonkey aktualisieren |
| Beim Öffnen eines anderen Workflows eine Rückfrage | Der aktuelle hat ungespeicherte Änderungen | Speichern oder Änderungen verwerfen |
Siehe auch
Die Knoten Free & Premium
Jeder Knoten ist ein Schritt. Er bekommt Datensätze vom Knoten davor, bearbeitet sie und gibt Datensätze weiter. In der Auswahl sind die Knoten nach Auslöser, Logik, Daten, Ein-/Ausgabe, WebDonkey, KI und Fläche sortiert. Ein Schritt darf höchstens 10.000 Datensätze weitergeben.
So findest du es
Im Editor über Schritt hinzufügen oder Nächster Schritt. Die Suche Knoten suchen findet Knoten über ihren Namen. Jedes Feld eines Knotens hat im Formular einen kurzen Hinweis, lange Hinweise klappst du mit Mehr anzeigen auf.
So gehst du vor
Eine Site alle 15 Minuten prüfen und bei einem Fehler melden:
- Auslöser Zeitplan mit
*/15 * * * *. - HTTP-Anfrage mit der URL der Site, etwa
{{ vars.site_url }}, Bei HTTP-Fehlerstatus scheitern aus. - Wenn mit der Bedingung
{{ json.status }}kleiner als400. - Am Ausgang „falsch“ eine Benachrichtigung mit dem Titel „Site nicht erreichbar“.
Die Vorlage Site prüfen und melden ist genau dieser Ablauf.
Auslöser
Ein Workflow beginnt bei einem Auslöser. In einen Auslöser führt keine Verbindung.
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| Start von Hand | startet über Ausführen in der App, über ⌘K oder mit wd workflows run |
Eingabefelder (Typ Text, Zahl oder Ja / Nein, mit Vorgabe). Sie werden beim Start abgefragt und kommen als Felder des ersten Datensatzes an |
| Zeitplan | startet nach einem Cron-Ausdruck in Ortszeit: Minute, Stunde, Tag, Monat, Wochentag | Zeitplan, Vorgabe 0 * * * * (jede volle Stunde). Läuft nur, solange WebDonkey geöffnet ist. Ein verpasster Termin wird beim nächsten Start einmal nachgeholt |
| Webhook | startet per Anfrage an eine Adresse, die nur von diesem Mac aus erreichbar ist, für Git-Hooks, eigene Skripte, lokale Programme und Container | Methode (Vorgabe POST, auch Jede Methode), Antwort: Sofort (202 mit der Lauf-ID) oder Nach Laufende (mit dem Ergebnis), dazu Höchstens warten (Sekunden), Vorgabe 30 |
| App-Ereignis (Premium) | startet bei einer Meldung von WebDonkey | Meldung: Jede Meldung oder eine Art wie Backup erstellt, Prozess abgebrochen, Mail in Mailpit, Abo fällig, Claude wartet |
| Dateiänderung (Premium) | startet, wenn sich eine Datei oder ein Ordner ändert | Datei oder Ordner, Mit Unterordnern (an), Nur diese Dateien (Muster mit * und ?, durch Komma getrennt), Ruhe abwarten (ms), Vorgabe 1000 |
Mehr zum Webhook
- Am Auslöser steht die Adresse in der Form
http://127.0.0.1:<port>/hook/<token>, mit Adresse kopieren und curl-Befehl kopieren. Sie bleibt auch nach einem Neustart gleich. Nur wenn der gemerkte Port belegt ist, wählt WebDonkey einen neuen. Ein neuer Workflow zeigt die Adresse erst nach dem Speichern. - Daneben steht, ob sie empfangsbereit ist. Sie antwortet nur, solange der Workflow an ist.
- Der Lauf beginnt mit einem Datensatz aus Methode, Pfad, Query, Header und Body. JSON wird gelesen, alles andere ist Text, höchstens 1 MB.
- Andere Methoden als die gewählte bekommen
405. Aus einem Docker-Container nimmst duhost.docker.internalstatt127.0.0.1.
Mehr zum App-Ereignis
Der Lauf beginnt mit einem Datensatz aus Art, Titel, Text und Sprungziel der Meldung. Arten, die du in den Einstellungen abgeschaltet hast, kommen nicht an. Meldungen von Workflows starten nie einen Workflow. Zur Auswahl stehen Paket installiert, Update verfügbar, Backup erstellt, Geplante Aufgabe gelaufen, Prozess abgebrochen, KI-Modell fertig, ISO heruntergeladen, Mail in Mailpit, Monitoring, Abo fällig, Claude wartet, WebDonkey Editor gefunden und Übertragung beendet.
Mehr zur Dateiänderung
Der Lauf beginnt mit einem Datensatz aus den geänderten Pfaden und der Art der Änderung (created, modified, removed, renamed). Änderungen in node_modules, .git, target und vendor zählen nie. Änderungen kurz hintereinander starten gemeinsam einen Lauf.
Logik
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| Wenn | schickt jeden Datensatz je nach Bedingung zum Ausgang „wahr“ oder „falsch“ | Bedingungen, „Wahr“, wenn: alle Bedingungen zutreffen oder mindestens eine zutrifft |
| Verteiler | schickt jeden Datensatz zum Ausgang der ersten passenden Regel, sonst zu „sonst“ | Regeln: Die erste Zeile führt zu Ausgang 0, die zweite zu Ausgang 1 und so weiter |
| Warten | hält den Lauf an und reicht die Datensätze dann weiter, einmal für alle zusammen | Dauer (Vorgabe 5), Einheit: Sekunden oder Minuten. Das Zeitlimit des Laufs läuft weiter |
| Beenden | beendet den Lauf hier | Lauf beenden als: Erfolg oder Fehler, dazu Meldung. Bei Erfolg erscheint die Meldung am Lauf als Hinweis, bei Fehler als Fehlermeldung |
Eine Bedingung besteht aus Wert, Vergleich und Vergleichen mit. Vergleiche: ist gleich, ist ungleich, größer als, größer oder gleich, kleiner als, kleiner oder gleich, enthält, enthält nicht, beginnt mit, endet mit, passt auf das Muster, ist leer, ist nicht leer, ist wahr, ist falsch. Zahlen vergleicht WebDonkey als Zahlen, alles andere als Text. Groß- und Kleinschreibung zählt.
Daten
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| Felder setzen | ergänzt oder ändert Felder jedes Datensatzes | Felder (Name und Wert, ein Punkt im Namen greift in ein Objekt wie adresse.ort), Übrige Felder behalten (an) |
| Filtern | lässt nur Datensätze durch, die die Bedingungen erfüllen. Der Rest endet hier | Bedingungen, Ein Datensatz kommt durch, wenn |
| Liste teilen | macht aus einer Liste in einem Datensatz je Eintrag einen eigenen Datensatz | Listenfeld, ohne geschweifte Klammern, etwa positionen. Übrige Felder behalten (aus) |
| Zusammenfassen | fasst alle Datensätze zu einem zusammen: Liste und Anzahl, auf Wunsch Summe, Minimum, Maximum und Durchschnitt | Name der Liste (Vorgabe items), Nur dieses Feld sammeln, Feld mit Zahlen |
| Zusammenführen | führt die Datensätze mehrerer Zweige zu einer Liste zusammen | Nur dieses Feld weitergeben |
| Nur neue (Premium) | lässt nur Datensätze durch, deren Schlüssel der Workflow noch nicht gesehen hat, auch über Läufe hinweg. Er merkt sich die letzten 10.000 Schlüssel | Schlüssel, ein Ausdruck wie {{ json.id }} |
| Wert merken (Premium) | legt einen Wert im Gedächtnis ab. Spätere Knoten und Läufe lesen ihn als state.<name> |
Name, Wert. Leer lassen vergisst den Namen |
| Code ausführen (Premium) | führt ein eigenes Skript einmal mit allen Datensätzen aus: JSON hinein über stdin, JSON heraus über stdout | Sprache: JavaScript (Node.js), PHP, Python 3 oder Shell (sh), Skript, Site, Arbeitsordner |
Ein-/Ausgabe
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| HTTP-Anfrage | sendet je Datensatz eine Anfrage und reicht status, headers, body und duration_ms weiter |
Methode, URL, Query-Parameter, Header, Inhalt (Keiner, JSON, Text, Formularfelder), Anmeldung (Keine, Bearer-Token, Benutzername und Passwort (Basic)), Zeitlimit (Sekunden) (30), Bei HTTP-Fehlerstatus scheitern (an), Ungültige Zertifikate erlauben (aus) |
| Shell-Befehl | führt je Datensatz einen Befehl über sh -c aus, mit den in WebDonkey gewählten PHP- und Node-Versionen. Reicht exit_code, stdout, stderr und duration_ms weiter |
Befehl, Site (der Befehl läuft dann in ihrem Ordner mit ihrer PHP-Version), Arbeitsordner, Bei Exit-Code ungleich 0 scheitern (an) |
| Datei lesen | liest eine Datei bis 10 MB, als Text im Feld content oder als JSON im Feld data |
Datei, Inhalt ist: Text oder JSON, Ein Datensatz je Zeile |
| Datei schreiben | schreibt je Datensatz Text in eine Datei und reicht den Datensatz unverändert weiter | Datei, Inhalt (nur {{ json }} schreibt den ganzen Datensatz), Wenn die Datei existiert: Ersetzen, Anhängen, Nur anlegen (scheitern, wenn sie existiert), Ordner anlegen (an) |
| Benachrichtigung | legt je Datensatz eine Meldung in der Glocke von WebDonkey ab. Ist WebDonkey im Hintergrund, zeigt macOS sie als Banner. Ein Klick öffnet den Workflow | Titel, Text |
| Mail senden (Premium) | sendet je Datensatz eine Mail, als Vorgabe an das lokale Mailpit (nichts wird zugestellt) oder über deinen eigenen SMTP-Server | An, Betreff, Format (Text oder HTML), Nachricht, Von, Senden über, dazu für SMTP SMTP-Server, Verschlüsselung (STARTTLS, TLS, Keine (unverschlüsselt)), Port, Benutzername, Passwort (Name des Geheimnisses) |
Pfade in Datei, Datei oder Ordner und Arbeitsordner sind vollständig oder beginnen mit ~/.
WebDonkey
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| Dienst steuern (Premium) | startet, stoppt oder startet einen Dienst neu und reicht den Zustand danach weiter | Dienst wie mysql oder php@8.3, Aktion: Starten, Stoppen, Neu starten |
| Site steuern (Premium) | startet, stoppt oder startet eine Site neu | Site (auch über ihre Domain wie shop.test), Aktion |
| Datenbank-Abfrage (Premium) | führt SQL gegen eine lokale Datenbank aus und reicht jede Zeile als Datensatz weiter | Datenbank: MySQL, MariaDB, PostgreSQL oder SQLite-Datei, Datenbankname oder Datei, SQL, Schreiben erlauben (aus), Zeilenlimit (500, von einem Datenbankdienst höchstens 1000) |
| Remote-Befehl (Premium) | führt einen Befehl über eine deiner gespeicherten SSH-Verbindungen aus und reicht exit_code, stdout und stderr weiter |
Verbindung, Befehl, Bei Exit-Code scheitern (an). Braucht zusätzlich die Remote-Funktionen von Premium |
KI
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| KI-Prompt (Premium) | schickt einen Prompt je Datensatz an ein lokales Ollama-Modell und reicht die Antwort im Feld text weiter. Nichts verlässt deinen Mac, Cloud-Modelle lehnt der Knoten ab |
Modell (Ollama muss laufen), Prompt, System-Text, Temperatur, JSON-Antwort (die gelesene Antwort steht dann zusätzlich im Feld json) |
Fläche
| Knoten | Tut | Wichtige Felder |
|---|---|---|
| Notiz | eine Notiz auf der Fläche, wird nicht ausgeführt | Text, Farbe (Gelb, Blau, Grün, Rosa, Grau), Breite, Höhe |
Was im Hintergrund passiert
- Knoten wie HTTP-Anfrage oder Shell-Befehl arbeiten je Datensatz, also einmal für jeden ankommenden Datensatz. Code ausführen, Zusammenfassen, Zusammenführen, Nur neue, Warten und Beenden arbeiten einmal mit allen zusammen.
- Einige Knoten haben ein eigenes Zeitlimit: 60 Sekunden für HTTP-Anfrage, Mail senden und Datenbank-Abfrage, 120 Sekunden für Dienst steuern und Site steuern, 300 Sekunden für Shell-Befehl, Code ausführen, Remote-Befehl und KI-Prompt. Du kannst es je Knoten ändern.
- Bei SQL und Befehlen wird mit
{{ … }}eingesetzter Text Teil der Anweisung. Werte von außen, etwa aus einem Webhook, setzt du in Anführungszeichen. In Shell-Befehl und Code ausführen stehen Variablen und Geheimnisse zusätzlich als Umgebungsvariablen bereit ($name), dann wird ihr Text nicht Teil des Befehls.
Free und Premium
Knoten mit dem Zusatz (Premium) laufen nur mit Premium. Ein Workflow mit einem solchen Knoten lässt sich im Free-Tarif speichern und bearbeiten, aber nicht einschalten oder ausführen. Am Knoten zeigt ein Schloss, dass er Premium braucht.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Ollama läuft nicht. … | Der Dienst Ollama ist aus | Den Dienst Ollama starten und erneut ausführen |
| Das Modell „…“ ist in Ollama nicht installiert. … | Das Modell fehlt | Es auf der Seite KI installieren oder ein anderes wählen |
| Meldung, der Schritt habe mehr Datensätze geliefert, als ein Schritt weitergeben darf | Mehr als 10.000 Datensätze | Vorher filtern oder zusammenfassen |
| Mehrere Sites heißen „…“. … oder Mehrere Verbindungen heißen „…“. … | Der Name ist nicht eindeutig, der Lauf stoppt | Im Knoten die Site oder Verbindung direkt wählen, bei Sites geht auch die Domain |
| Die Site „…“ gibt es nicht (mehr). | Die Site wurde gelöscht oder umbenannt | Im Knoten eine vorhandene Site wählen |
Siehe auch
Daten, Ausdrücke und Variablen Free
Zwischen den Knoten fließen Datensätze: kleine Pakete aus Feldern, etwa { "status": 200, "body": "…" }. In den Feldern eines Knotens greifst du mit Ausdrücken auf diese Daten zu, zum Beispiel {{ json.status }}. Für Werte, die du in mehreren Knoten brauchst, und für Passwörter gibt es Variablen und Geheimnisse.
So findest du es
- Ausdrücke schreibst du in die Felder im Formular eines Knotens. Der Knopf Feld einsetzen an jedem passenden Feld hilft dabei.
- Variablen und Geheimnisse öffnest du im Editor über Variablen in der Werkzeugleiste der Zeichenfläche.
So gehst du vor
Einen Wert des vorherigen Knotens einsetzen
- Führ den Workflow einmal aus. Erst danach kennt der Editor die Felder der vorherigen Knoten.
- Öffne das Formular des Knotens, in dem du den Wert brauchst.
- Klicke an einem Feld auf Feld einsetzen und wähle das Feld aus der Liste, etwa unter Aktueller Datensatz. Mit Felder suchen filterst du die Liste.
- Der Ausdruck steht im Feld, etwa
{{ json.status }}.
Vor dem ersten Lauf steht dort Einmal ausführen, dann stehen hier die Felder der vorherigen Knoten zur Auswahl.
Eine Variable anlegen
- Klicke im Editor auf Variablen. Der Dialog Variablen und Geheimnisse öffnet sich.
- Trag unter Dieser Workflow Name und Wert ein, etwa
site_urlundhttps://shop.test. - Speichere den Workflow. Ab jetzt steht der Wert als
{{ vars.site_url }}bereit.
Ein Geheimnis anlegen
- Öffne Variablen und geh zu Alle Workflows.
- Trag Name und Wert ein und schalte Geheimnis ein.
- Klicke auf Hinzufügen. Das Geheimnis ist sofort gespeichert und steht in jedem Workflow als
{{ secrets.name }}bereit.
Felder und Optionen
Was ein Ausdruck sieht
| Name | Inhalt |
|---|---|
json |
der aktuelle Datensatz, zum Beispiel json.total |
item.index |
seine Position, die Zählung beginnt bei 0 |
nodes["Name"].json |
die Ausgabe eines anderen Knotens über seinen Namen, .items für alle seine Datensätze |
trigger |
die Daten des Auslösers |
vars |
deine Variablen, zum Beispiel vars.site_url |
secrets |
deine Geheimnisse, zum Beispiel secrets.api_token |
state |
das Gedächtnis des Workflows, zum Beispiel state.last_id |
workflow.id, workflow.name |
Kennung und Name des Workflows |
run.id, run.started_at |
Kennung und Startzeit des Laufs |
now |
die aktuelle Zeit |
Feld einsetzen gruppiert diese Werte unter Aktueller Datensatz, den Namen der vorherigen Knoten, Auslöser, Variablen, Geheimnisse, Gedächtnis und Allgemein (mit aktuelle Zeit und Position des Datensatzes).
Regeln für Ausdrücke
- Streng: Ein Feld, das es nicht gibt, ist ein Fehler, kein leerer Text. So fällt ein Tippfehler im Feldnamen sofort auf. Für ein Feld, das fehlen darf, schreibst du
{{ json.notiz | default('') }}. - Typ bleibt erhalten: Besteht ein Feld aus genau einem Ausdruck, etwa
{{ json.total * 2 }}, behält das Ergebnis seinen Typ: Zahl, Liste, Objekt oder Wahrheitswert. Steht mehr drumherum, etwaSumme: {{ json.total }}, wird es Text. - Filter hängst du mit
|an:default,upper,join,tojson,urlencodeund weitere, dazufromjson,date(format),regex_replace(muster, ersatz),basename,dirname,sha256,b64encodeundb64decode.datenimmt ein Format wie'%d.%m.%Y', ohne Format gilt%Y-%m-%d %H:%M. - Namen der Knoten: Über
nodes["Name"]sprichst du einen Knoten an. Sein Name muss eindeutig sein, du änderst ihn in den Einstellungen des Knotens.
Variablen und Geheimnisse
| Bereich | Bedeutung |
|---|---|
| Dieser Workflow | Variablen, die mit dem Workflow gespeichert und exportiert werden. Sie haben Vorrang vor einer gemeinsamen Variablen gleichen Namens |
| Alle Workflows | Variablen und Geheimnisse für jeden Workflow. Sie werden sofort gespeichert. Ein Geheimnis wird verschlüsselt abgelegt, nie wieder angezeigt und nie exportiert. Zum Ersetzen tippst du es neu ein (Gespeichert. Zum Ersetzen neu eintippen.) |
Namen bestehen aus Buchstaben, Ziffern und _ und beginnen nicht mit einer Ziffer. Ein Name, den es schon gibt, meldet Dieser Name ist schon vergeben.
Was im Hintergrund passiert
- In Shell-Befehl und Code ausführen stehen Variablen und Geheimnisse zusätzlich als Umgebungsvariablen unter ihrem Namen bereit,
$namein der Shell,process.env.namein JavaScript. So wird ihr Text nicht Teil des Befehls. - Im Verlauf der Läufe zeigt WebDonkey Geheimnisse nicht im Klartext.
- Ein Ausdruck darf nicht beliebig lange rechnen. Eine Schleife über Milliarden Einträge bricht WebDonkey vorher ab.
- Im App-Backup reisen die gemeinsamen Variablen mit, Geheimnisse verschlüsselt.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Fehler, ein Feld sei nicht definiert | Ein Tippfehler im Namen oder das Feld fehlt in diesem Datensatz | Den Namen im Verlauf unter Ausgabe prüfen, für optionale Felder default('') |
| Eine Zahl kommt als Text an | Um den Ausdruck steht weiterer Text | Das Feld auf genau einen Ausdruck kürzen |
nodes["…"] findet den Knoten nicht |
Der Knoten heißt anders oder wurde umbenannt | Den Namen in den Einstellungen des Knotens nachsehen |
| Nur Buchstaben, Ziffern und _, nicht mit einer Ziffer beginnen. | Der Name einer Variablen ist ungültig | Den Namen anpassen |
Siehe auch
Einstellungen und Fehlerverhalten Free & Premium
Was passiert, wenn ein Schritt scheitert? Wie lange darf ein Lauf dauern? Das legst du auf zwei Ebenen fest: in den Einstellungen eines Knotens und in den Einstellungen des Workflows.
So findest du es
- Knoten: Knoten anklicken, im Formular rechts unten der Abschnitt Einstellungen.
- Workflow: im Kopf des Editors der Knopf Einstellungen. Er öffnet den Dialog Einstellungen des Workflows.
So gehst du vor
Einen Fehlerzweig bauen, der dich bei einem Fehlschlag benachrichtigt:
- Klicke den Knoten an, der scheitern kann, etwa eine HTTP-Anfrage.
- Stell unten in Einstellungen bei Bei Fehler auf Fehler-Ausgang nehmen. Am Knoten erscheint ein Ausgang Fehler.
- Zieh vom Ausgang Fehler eine Linie zu einer neuen Benachrichtigung.
- Speichere den Workflow.
Scheitert der Schritt, läuft der Fehler als Datensatz in den neuen Zweig, und der Lauf gilt nicht als fehlgeschlagen.
Felder und Optionen
Einstellungen eines Knotens
| Feld | Bedeutung | Vorgabe |
|---|---|---|
| Name | Ausdrücke erreichen den Knoten über nodes["Name"]. Er muss eindeutig sein |
der Name der Knotenart |
| Ausgeschaltet | ein ausgeschalteter Knoten reicht seine Eingabe unverändert weiter | aus |
| Versuche | wie oft der Schritt insgesamt versucht wird, bevor er als gescheitert gilt. 1 heißt kein Wiederholen |
1 |
| Pause dazwischen (ms) | Wartezeit zwischen zwei Versuchen | 0 |
| Zeitlimit (Sekunden) | wie lange ein Versuch dauern darf. Leer: das übliche Limit dieser Knotenart | leer |
| Bei Fehler | siehe unten | Lauf beenden |
| Notiz | eine Gedächtnisstütze zum Knoten | leer |
Bei Fehler
| Wahl | Was passiert |
|---|---|
| Lauf beenden | Der Lauf endet als fehlgeschlagen. |
| Weitermachen | Der Fehler steht am Schritt, der Lauf geht mit der Eingabe weiter. |
| Fehler-Ausgang nehmen | Der Fehler verlässt den Knoten als Datensatz über den Ausgang Fehler. |
Einstellungen des Workflows
| Feld | Bedeutung | Vorgabe |
|---|---|---|
| Beschreibung | steht in der Liste unter dem Namen | leer |
| Zeitlimit eines Laufs (Sekunden) | ein Lauf, der länger dauert, endet als fehlgeschlagen | 600 (10 Minuten) |
| Bei Fehler melden | ein fehlgeschlagener Lauf legt eine Benachrichtigung in der Glocke ab | an |
| Läufe im Verlauf | wie viele Läufe der Verlauf behält, bis zu 200. Ältere gehen, wenn ein neuer startet | 200 |
Was im Hintergrund passiert
- Das Zeitlimit eines Knotens gilt je Versuch. Läuft es ab, versucht WebDonkey den Schritt erneut, solange Versuche übrig sind.
- Das Zeitlimit des Laufs läuft über alles, auch über Warten. Ist es erreicht, endet der Lauf, egal was Bei Fehler sagt.
- Die Benachrichtigung von Bei Fehler melden nennt den Knoten und den Fehler.
Free und Premium
Im Free-Tarif behält der Verlauf die letzten 20 Läufe, auch wenn bei Läufe im Verlauf mehr steht. Der Dialog sagt dazu Free behält die letzten 20 Läufe, Premium bis zu 200. Alle anderen Einstellungen sind frei.
Wenn es nicht klappt
Ein fehlgeschlagener Lauf nennt den Grund in klaren Worten, etwa:
| Meldung | Was du tust |
|---|---|
| Dieser Schritt hat länger gebraucht als sein Zeitlimit von … s. | Das Zeitlimit (Sekunden) des Knotens erhöhen |
| Der Lauf hat länger gedauert als das Zeitlimit des Workflows von … s. | Das Zeitlimit eines Laufs erhöhen |
| WebDonkey wurde beendet, während dieser Lauf lief. | Erneut ausführen |
| Dieser Workflow läuft bereits. Warte, bis der Lauf zu Ende ist, oder brich ihn ab. | Warten oder im Feld Läufe auf Abbrechen klicken |
| WebDonkey kennt keinen Dienst namens „…“. | Den Namen im Knoten Dienst steuern prüfen |
| Die Verbindung „…“ gibt es nicht (mehr). | Im Knoten eine vorhandene Verbindung wählen |
Ein Knoten Beenden mit Erfolg zeigt seine Meldung am Lauf als Hinweis (Bewusst beendet mit diesem Hinweis:), nicht als Fehler.
Siehe auch
Läufe Free & Premium
Unter dem Editor liegt das Feld Läufe. Im Reiter Verlauf siehst du jeden Lauf eines Workflows Schritt für Schritt: welcher Knoten wie viele Datensätze bekam und lieferte, wie oft er es versucht hat, wie lange er brauchte und was genau er ausgegeben hat. Daneben liegt der Reiter Gedächtnis.
So findest du es
Im Editor eines Workflows, unten das Feld Läufe, Reiter Verlauf. Mit Läufe einklappen und Läufe ausklappen machst du Platz, die Höhe ziehst du am oberen Rand.
So gehst du vor
- Starte den Workflow mit Ausführen. Der neue Lauf erscheint oben im Verlauf mit Läuft.
- Klicke den Lauf an. Rechts steht die Tabelle Schritte, auf der Zeichenfläche markiert der Editor, wie jeder Knoten ausging.
- Klicke einen Schritt an. Unter Ausgabe siehst du seine Datensätze, einen nach dem anderen.
- Nutze die Feldnamen aus der Ausgabe für die Ausdrücke im nächsten Knoten, etwa
{{ json.status }}.
Felder und Optionen
Verlauf
Der neueste Lauf steht oben. Jeder Lauf trägt einen Status:
| Status | Bedeutung |
|---|---|
| Läuft | der Lauf ist noch nicht fertig |
| Erfolgreich | alle Schritte sind durchgelaufen |
| Fehlgeschlagen | ein Schritt ist gescheitert oder ein Zeitlimit lief ab, der Grund steht am Lauf |
| Abgebrochen | du hast den Lauf mit Abbrechen beendet |
| Übersprungen | bei einem Schritt: Er kam in diesem Lauf nicht dran |
Ohne Lauf steht dort Noch keine Läufe.
Schritte
| Spalte | Zeigt |
|---|---|
| Schritt | der Knoten |
| Datensätze | wie viele hinein- und herausgingen |
| Versuche | wie oft der Schritt lief |
| Dauer | wie lange er brauchte |
Ausgabe
Ausgabe zeigt die Datensätze des gewählten Schritts als aufklappbares JSON, Als JSON kopieren legt sie in die Zwischenablage. Bei großen Ausgaben steht dort Zeigt … von … Datensätzen: Die gespeicherte Ausgabe ist gekappt. Die Zähler stimmen genau.
Knöpfe am Lauf
- Abbrechen beendet einen laufenden Lauf.
- Erneut ausführen startet einen neuen Lauf mit den Auslöser-Daten dieses Laufs, etwa demselben Webhook-Body.
Was im Hintergrund passiert
- Wie viele Läufe der Verlauf behält, stellst du in den Einstellungen des Workflows ein. Wird es mehr, geht der älteste, wenn ein neuer startet.
- Der Verlauf bleibt auf diesem Mac und reist nicht im App-Backup mit.
- Mit
wd workflows runs <workflow>liest du den Verlauf auch im Terminal.
Free und Premium
Im Free-Tarif behält der Verlauf die letzten 20 Läufe je Workflow, mit Premium bis zu 200.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Die Läufe ließen sich nicht laden. | Die Daten des Verlaufs sind gerade nicht lesbar | Den Workflow neu öffnen |
| Der Lauf ließ sich nicht starten. | Ein Auslöser fehlt, die Free-Grenze ist erreicht oder ein Premium-Knoten steckt darin | Die Meldung lesen, sie nennt den Grund |
| Dieser Schritt wurde übersprungen. | Der Zweig mit diesem Knoten kam nicht dran, etwa der Ausgang „falsch“ eines Wenn | Nichts, das ist gewollt |
Siehe auch
Gedächtnis Premium
Ein Workflow kann sich Dinge zwischen zwei Läufen merken: die höchste ID, die er schon verarbeitet hat, oder welche Mails er schon gesehen hat. Der Reiter Gedächtnis im Feld Läufe zeigt, was das ist, und räumt es auf. Das Gedächtnis ist eine Premium-Funktion.
So findest du es
Im Editor eines Workflows, unten das Feld Läufe, Reiter Gedächtnis. Oben steht Was sich dieser Workflow zwischen den Läufen merkt.
So gehst du vor
Nur neue Bestellungen verarbeiten:
- Hol die Bestellungen mit einer HTTP-Anfrage und mach mit Liste teilen aus jeder Bestellung einen Datensatz.
- Setz einen Knoten Nur neue mit dem Schlüssel
{{ json.id }}dahinter. - Führ den Workflow aus. Beim ersten Lauf kommen alle Bestellungen durch, beim nächsten nur die neuen.
- Im Reiter Gedächtnis steht jetzt, wie viele Schlüssel sich der Knoten gemerkt hat.
Felder und Optionen
| Eintrag | Herkunft |
|---|---|
| ein Name mit seinem Wert | abgelegt vom Knoten Wert merken. Spätere Knoten und Läufe lesen ihn als {{ state.name }} |
| Name des Knotens mit … gemerkte Schlüssel | wie viele Schlüssel ein Knoten Nur neue schon gesehen hat, höchstens die letzten 10.000. Gibt es den Knoten nicht mehr, steht statt seines Namens Entfernter Knoten |
- … vergessen an einem Eintrag entfernt nur ihn.
- Gedächtnis zurücksetzen löscht alles. Die Rückfrage Gedächtnis zurücksetzen? erklärt: Der Workflow vergisst alles, auch was Nur neue schon gesehen hat, und der nächste Lauf beginnt von vorn. Bestätige mit Zurücksetzen.
Ist noch nichts abgelegt, steht dort Dieser Workflow merkt sich noch nichts.
Was im Hintergrund passiert
- Ein Knoten sieht in
stateden Stand zu Beginn seines Schritts. Solange noch kein Lauf einen Wert abgelegt hat, vermeidest du mit{{ state.last_id | default(0) }}einen Fehler. - Namen, die mit zwei Unterstrichen beginnen, gehören WebDonkey selbst. Wert merken nimmt sie nicht an.
- Löschst du einen Workflow, ist sein Gedächtnis mit weg.
- Das Gedächtnis reist im App-Backup in der Kategorie Workflows mit.
Free und Premium
Wert merken und Nur neue sind Premium-Knoten. Im Free-Tarif lässt sich ein Workflow mit ihnen speichern, aber nicht einschalten oder ausführen.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Nur neue lässt nichts mehr durch | Alle Schlüssel sind schon bekannt | Prüfen, ob der Schlüssel jeden Datensatz unterscheidet, zum Testen Gedächtnis zurücksetzen |
Fehler bei state.name im ersten Lauf |
Der Wert ist noch nicht abgelegt | ` |