 |
Zusammenfassung | Discourse Workflows ermöglicht es Administratoren, über einen visuellen Builder fortgeschrittene Automatisierungen zu erstellen, um nahezu alles in Ihrer Community zu automatisieren. |
 |
Installationsanleitung | Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich. |
Workflows ist ein visueller Automatisierungs-Builder, der es Administratoren ermöglicht, komplexe, mehrstufige Automatisierungen mit einer Drag-and-Drop-Oberfläche zu erstellen – indem Trigger, Bedingungen, Aktionen und Flusssteuerungsknoten verbunden werden, um nahezu alles auf Ihrer Discourse-Site zu automatisieren.
Discourse Workflows ist in den Business- oder Enterprise-Plänen verfügbar.
Wichtige Konzepte
Wenn Sie mit anderen Automatisierungstools vertraut sind, werden Sie die meisten Begriffe, die in Workflows verwendet werden, wahrscheinlich wiedererkennen:
- Workflow: Eine gespeicherte Automatisierung, die aus verbundenen Knoten besteht.
- Knoten: Ein einzelner Schritt in einem Workflow: Trigger, Bedingungen, Aktionen und Flusssteuerung / Hilfsprogramme.
- Trigger: Der Startpunkt eines Workflows. Ein Trigger kann manuell ausgelöst werden oder durch ein bestimmtes Ereignis – z. B. das Erstellen eines Themas, das Auslösen eines Zeitplans oder ein eingehendes Webhook.
- Bedingung: Ein Routing-Knoten, der eine Regel auswertet und den Fluss in Zweige aufteilt. Zum Beispiel leitet ein If-Knoten den Fluss basierend auf einer wahren oder falschen Auswertung weiter.
- Aktion: Ein Knoten, der eine bestimmte Aufgabe ausführt – z. B. das Erstellen eines Beitrags, das Verleihen eines Abzeichens, das Aufrufen einer externen API usw.
- Element: Die Daten, die zwischen den Knoten fließen. Elemente sind JSON-Objekte, die Sie in Ausführungsprotokollen inspizieren und mit Ausdrücken referenzieren können.
- Ausdruck: Ein dynamischer Wert, der als
{{ ... }}geschrieben wird, zur Laufzeit aufgelöst wird und verwendet wird, um auf Daten aus früheren Knoten, Workflow-Variablen oder Site-Einstellungen zu verweisen.
Erstellen eines Workflows
So erstellen Sie einen Workflow:
- Gehen Sie zu Admin > Plugins > Workflows und klicken Sie auf Neuer Workflow.
- Benennen Sie Ihren Workflow.
- Klicken Sie auf Ersten Schritt hinzufügen und wählen Sie Ihren Trigger.
- Verwenden Sie die +-Schaltfläche, um weitere Knoten hinzuzufügen.
- Doppelklicken Sie auf einen Knoten, um ihn zu konfigurieren. Im Konfigurationsfeld werden auf der linken Seite Details zu den Eingaben des Knotens und auf der rechten Seite des Bildschirms Details zu den Ausgaben des Knotens angezeigt. Möglicherweise müssen Sie den Workflow einmal ausführen, bevor alle verschiedenen Details angezeigt werden.
- Wenn Sie bereit sind, den Workflow live zu schalten, klicken Sie auf Veröffentlichen.
Tipps:
- Verwenden Sie Sticky Notes (Haftnotizen), die sich im Menü mit den drei Punkten oben rechts im Builder befinden, um zu dokumentieren, was Ihr Workflow tut. Haftnotizen haben keinen Einfluss auf den Workflow, machen Vorlagen und freigegebene Workflows jedoch leichter verständlich.
- Verwenden Sie während der Entwicklung den Log-Knoten (Protokollknoten), um Debug-Werte in das Ausführungsprotokoll zu senden, ohne das Verhalten des Workflows zu beeinträchtigen.
- Sie können Workflows als JSON exportieren und importieren, um sie mit Teammitgliedern zu teilen oder Workflows von anderen Sites zu rekonstruieren.
Ausdrücke und dynamische Daten
Felder, die Ausdrücke akzeptieren, zeigen im Editor eine {/}-Schaltfläche. Klicken Sie darauf, um in den verfügbaren Daten des Triggers und früherer Knoten zu suchen und eine Referenz einzufügen.
Häufig verwendete Ausdrücke
| Ausdruck | Was es zurückgibt |
|---|---|
{{ $json.topic.title }} |
Der Titel des Themas aus dem aktuellen Element |
{{ $json.post.url }} |
Die URL des Beitrags aus dem aktuellen Element |
{{ $json.user.username }} |
Der Benutzername des Benutzers, der mit dem aktuellen Element verknüpft ist |
{{ $vars.my_variable }} |
Der Wert einer Workflow-Variable mit dem Namen my_variable |
{{ $site_settings.title }} |
Der Titel Ihrer Site |
{{ $execution.id }} |
Die eindeutige ID der aktuellen Ausführung |
{{ $('Node Name').item.json.property }} |
Ausgabe eines bestimmten upstream-Knotens, referenziert über seinen Namen auf der Leinwand |
Statische und dynamische Werte
Felder, die mit = beginnen, werden als Ausdrücke behandelt. Felder ohne führendes = werden als Klartext behandelt. Der Ausdrucksauswahl-Assistent übernimmt dies automatisch für Sie.
Workflows verwalten
Es gibt eine Reihe von Funktionen, die Ihnen beim Verwalten Ihrer vorhandenen Workflows helfen.
Ausführungen
Jedes Mal, wenn ein Workflow ausgeführt wird, protokolliert Discourse eine Ausführung. Gehen Sie zu Workflows → Ausführungen, um die Historie anzuzeigen.
Jede Ausführung zeigt Datum und Uhrzeit des Abschlusses sowie den Status:
- Abgeschlossen: Wurde ohne Fehler bis zum Ende ausgeführt.
- Fehler: Ist an einem bestimmten Knoten fehlgeschlagen; klicken Sie auf die Ausführung, um den Fehler und die Daten, die ihn verursacht haben, anzuzeigen.
- Läuft: Wird derzeit verarbeitet.
- Wartet: Wurde aufgrund eines Wait-Knotens (Warten-Knotens) pausiert; wartet auf eine Antwort in einem Formular, Modal, Chat-Freigabe; oder ein Call-Workflow-Knoten, der darauf wartet, dass ein Unter-Workflow abgeschlossen wird.
- Rate limitiert: Der Workflow wurde aufgrund von Ratenbegrenzung übersprungen.
- Übersprungen: Der Trigger wurde ausgelöst, aber der Workflow war nicht veröffentlicht.
Sie können auf die Anzeigen-Schaltfläche klicken, um einen detaillierteren Blick auf die Ausführung des Workflows zu werfen. Dies zeigt jeden Schritt des Workflows, den Sie erweitern können, um die genauen Details und die Dauer dieses Schritts anzuzeigen.
Unten auf der Seite können Sie die Gesamtdauer des Workflows sehen. Sie können das Protokoll bei Bedarf auch Exportieren, um es zu teilen oder zur Fehlerbehebung zu verwenden.
Einstellungen
Auf der Registerkarte Workflows → Einstellungen können Sie:
- Einen Fehler-Workflow konfigurieren, der ausgelöst werden soll, wenn bei der Ausführung dieses Workflows Fehler auftreten. Wenn der Workflow einen Fehler-Trigger hat, werden Fehler gemäß der Definition dieses Triggers behandelt.
- Die Zeitzone für Zeitplan-Trigger festlegen. Wenn dies nicht gesetzt ist, wird standardmäßig die Zeitzone der Site verwendet.
- Den Workflow löschen.
Dies ist endgültig, daher sollten Sie Ihren Workflow exportieren (zugänglich über das Menü mit den drei Punkten in der oberen rechten Ecke des Workflow-Builders), bevor Sie fortfahren.
Versionen
Jedes Mal, wenn Sie eine Aktualisierung am Workflow vornehmen, speichern wir die vorherige(n) Version(en). Dies macht es einfach, Änderungen, die nicht wie erwartet funktioniert haben, mit Zurücksetzen rückgängig zu machen.
Variablen
Variablen sind Schlüssel-Wert-Paare, die auf einen einzelnen Workflow beschränkt sind. Definieren Sie sie im Variablen-Panel des Workflows und referenzieren Sie sie überall mit {{ $vars.key_name }}. Verwenden Sie Variablen, um Konfigurationswerte (wie eine Kategorie-ID oder einen Empfänger-Benutzernamen) zu speichern, die Sie ändern möchten, ohne den Workflow-Graphen bearbeiten zu müssen.
Anmeldeinformationen
Einige Knoten – wie HTTP-Anforderung oder AI-Agent – müssen sich bei externen Diensten authentifizieren. Speichern Sie API-Schlüssel und Geheimnisse in Workflows → Anmeldeinformationen, anstatt sie direkt in Knotenfelder einzufügen. Anmeldeinformationen werden verschlüsselt gespeichert und können über Workflows hinweg wiederverwendet werden.
Unterstützte Anmeldeinformationstypen:
- Basic Auth (Benutzername + Passwort)
- Bearer-Token
- Header-Auth (benutzerdefinierter Header-Name und -Wert)
Datentabellen
Datentabellen sind persistente, strukturierte Tabellen, die intern im Workflows-Plugin verwaltet werden. Verwenden Sie den Datentabelle-Knoten, um darauf zu lesen oder zu schreiben. Sie unterstützen die Spaltentypen string, number, boolean und date.
Datentabellen sind nützlich für:
- Entduplizierung – protokollieren, welche Benutzer oder Themen ein Workflow bereits verarbeitet hat
- Status – verfolgen, ob sich ein Thema in einer bestimmten Phase eines Prozesses befindet
- Nachschlagen – speichern Zuordnungen (wie Thema-ID → zugewiesenes Staff-Mitglied), die Ihre Workflows abfragen können
Ausführungen
Sie können alle Ausführungen aller Workflows auf der Registerkarte Ausführungen anzeigen. Das Format und die Funktion sind den workflowspezifischen Ausführungen sehr ähnlich, zeigen aber alle Workflows an, was die Überwachung erleichtert.
Vorlagen
Wenn Sie einen neuen Workflow erstellen, können Sie anstelle einer leeren Leinwand mit einer Vorlage beginnen. Vorlagen sind vorgefertigte Workflows für häufige Anwendungsfälle – sie sind mit Haftnotizen versehen, die erklären, wie sie funktionieren, und sind ein guter Weg, das System kennenzulernen.
Interessiert daran, mehr Vorlagen zu sehen? Wir werden die Bibliothek der verfügbaren Vorlagen im Laufe der Zeit erweitern, aber lassen Sie uns bitte wissen, wenn es eine Vorlage gibt, die Sie hier sehen möchten, um Ihre Nutzung von Workflows zu erleichtern.
Sie können auch jeden Workflow als JSON-Datei exportieren, um ihn mit anderen zu teilen oder als eigenen Ausgangspunkt zu verwenden.
