Workflow
Erstellen, testen, bereitstellen und überprüfen Sie wiederverwendbare Projekt-Workflows, wenn der Builder verfügbar ist.
Workflow wandelt einen wiederholbaren Prozess in verbundene Schritte um, die Runner mit denselben Eingaben und Regeln erneut ausführen kann.
Bedingt: Die Workflow-Oberfläche existiert, aber die aktuelle Standard-Projektnavigation zeigt keinen Workflow-Eintrag an. Verwenden Sie sie nur, wenn Runner einen genehmigten Workflow-Eintrag für Ihren Workspace anzeigt oder Runner-Support einen genehmigten Pfad bereitstellt. Raten Sie nicht und bearbeiten Sie keine URL, um darauf zuzugreifen. Wenn Ihr Plan nur eine Vorschau erlaubt, kann Runner die Seite anzeigen, während ihre Steuerelemente blockiert bleiben.
Eingabepfad
Öffnen Sie den Workflow-Eintrag nur, wenn Runner ihn in Ihrem Workspace anzeigt. Die Seite listet Workflows für das aktuelle Projekt auf. Wenn kein Eintrag vorhanden ist, verwenden Sie Feature-Verfügbarkeit oder kontaktieren Sie den Support, anstatt eine direkte URL zu versuchen.
Bevor Sie beginnen
- Der Workflow-Zugriff hängt vom aktuellen Feature-Rollout und Plan ab.
- Bestätigen Sie das Projekt und die verbundenen Dienste vor dem Testen oder Bereitstellen eines Workflows.
- Eine Vorschau oder ein gespeicherter Entwurf ist nicht aktiv; Bereitstellung und Aktivierung sind separate folgenreiche Aktionen.
Workflow-Liste
Wenn es keine Workflows gibt, wählen Sie Workflow erstellen. Wenn die Liste bereits Elemente enthält, verwenden Sie Neuer Workflow.
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
|---|---|
| Workflow erstellen oder Neuer Workflow | Öffnet Workflow erstellen. |
| Leer | Erstellt einen Unbenannten Workflow und öffnet seinen Builder. |
| Vorlagenkarte | Erstellt einen Workflow aus dieser Vorlage und öffnet seinen Builder. Wenn Vorlagen nicht geladen werden, fordert Erneut versuchen sie erneut an. |
| Workflow-Name | Öffnet diesen Workflow im Builder. |
| Umbenennen | Macht den Namen bearbeitbar. Eingabe oder Wegklicken speichert ihn; Escape bricht die Bearbeitung ab. |
| An Anfang anheften / Loslösen | Verschiebt den Workflow in oder aus der angehefteten Gruppe. Der Workflow wird nicht ausgeführt. |
| Duplizieren | Erstellt eine Kopie und öffnet die Kopie im Builder. |
| Exportieren | Lädt den Workflow als JSON-Datei herunter. Es wird nichts bereitgestellt oder ausgeführt. |
| Löschen | Öffnet eine Bestätigung. Das Bestätigen entfernt diesen Workflow dauerhaft und kann nicht rückgängig gemacht werden. |
Verwenden Sie das Menü „Mehr" jeder Zeile, um Umbenennen, An Anfang anheften oder Loslösen, Duplizieren, Exportieren und Löschen zu finden.
Zeilenbeschriftungen können auch anzeigen, ob eine Version Live ist, einen Entwurf voraus hat, einen Endpoint verfügbar macht oder an einen Schedule oder Event gebunden ist. Eine pausierte oder Plan-blockierte Beschriftung bedeutet, dass automatisches Auslösen derzeit nicht aktiv ist.
Mit mehreren Workflows arbeiten
Wählen Sie das Kontrollkästchen neben einer oder mehreren Zeilen aus. Die Auswahlleiste zeigt, wie viele ausgewählt sind, und bietet:
- Exportieren, um die ausgewählten Workflows herunterzuladen.
- Löschen, um eine Massenbestätigung zu öffnen. Das Bestätigen entfernt jeden ausgewählten Workflow dauerhaft.
- Löschen, um die Auswahl zu entfernen, ohne Workflows zu ändern.
Alle auswählen wählt die in der aktuellen Liste angezeigten Workflows aus. Überprüfen Sie immer die Anzahl vor dem Massenlöschen erneut.
Erstellen und speichern
Die Builder-Canvas ist der Ort, an dem Sie Schritte hinzufügen, verbinden und konfigurieren, was jeder Schritt empfängt und tut. Komponente hinzufügen öffnet die durchsuchbare Komponentenbibliothek. Canvas-Steuerelemente zoomen ein, zoomen aus, passen den Workflow auf den Bildschirm an und ordnen verbundene Schritte automatisch an.
Änderungen werden automatisch gespeichert; es gibt keine separate Schaltfläche „Speichern". Der Zurück-Pfeil beendet einen ausstehenden Speichervorgang, bevor er zur Workflow-Liste zurückkehrt.
| Speicherstatus | Was zu tun ist |
|---|---|
| Speichern… | Warten Sie, bevor Sie die Seite schließen oder bereitstellen. |
| Gespeichert | Die neueste Canvas-Änderung ist gespeichert. |
| Speichern fehlgeschlagen | Wählen Sie Erneut versuchen, nachdem Sie die Verbindung überprüft haben. |
| Konflikt — Ihre Änderungen wurden nicht gespeichert | Eine andere gespeicherte Version ist neuer. Neu laden verwirft die in Konflikt stehenden lokalen Bearbeitungen und lädt die gespeicherte Version. |
Das untere Panel enthält Playground und Verlauf. Im Playground füllen Sie die erforderlichen Text-, Produkt- oder Medieneingaben aus, bevor Sie ausführen. Das Ausführungssteuerelement bleibt nicht verfügbar, während erforderliche Eingaben fehlen. Ergebnisse werden im Ausgabebereich angezeigt.
Das Menü „Mehr" des Builders bietet auch JSON exportieren und JSON importieren…. Export lädt die aktuelle Canvas herunter. Import ersetzt sofort die aktuelle Canvas und löst automatisches Speichern ohne Bestätigung aus. Exportieren Sie daher eine Sicherung und überprüfen Sie die ausgewählte Datei vor dem Importieren.
Wählen Sie den richtigen Test
Testing kann sehr unterschiedliche Konsequenzen haben.
| Steuerelement | Was passiert, nachdem Sie es ausgewählt haben |
|---|---|
| Simulieren ohne API-Aufrufe | Öffnet einen Simulationsdialog. Verwenden Sie generierte Beispieldaten oder fügen Sie JSON ein, wählen Sie dann Simulation ausführen. Schreibseitige Aktionen wie E-Mails, Slack-Beiträge und Store-Änderungen werden gestubbt. |
| Live-Test — echte Nebenwirkungen, markiert als isTest | Öffnet einen Live-Test-Dialog. Verwenden Sie generierte Daten, eingefügtes JSON oder ein aktuelles Event, falls verfügbar. Live-Test ausführen führt echte API-Aufrufe durch und kann Nachrichten senden oder verbundene Dienste ändern. Der Durchlauf wird im Verlauf als Test markiert. |
| Wartezeiten überspringen | Während eines Live-Tests werden konfigurierte Wartezeiten übersprungen, damit der Test schneller fortgesetzt werden kann. Es werden keine anderen echten Effekte entfernt. |
| Workflow ausführen | Startet den konfigurierten Workflow sofort und öffnet den Verlauf. Seine Schritte können echte Effekte haben; überprüfen Sie jeden Schritt und jede Eingabe zuerst. |
| Ausführung stoppen | Fordert an, dass der aktuelle Durchlauf stoppt. Bereits abgeschlossene Arbeiten werden nicht rückgängig gemacht. |
| Cache | Bei einer erneuten Ausführung werden berechtigte Knoten übersprungen, deren Eingaben sich nicht geändert haben, damit Sie sich auf geänderte nachgelagerte Arbeiten konzentrieren können. |
Verwenden Sie Simulation, um Verzweigungen und Datenfluss zu überprüfen. Verwenden Sie Live-Test nur, wenn echte Nebenwirkungen in den verbundenen Konten akzeptabel sind.
Überprüfen Sie den Ausführungsverlauf
Öffnen Sie Verlauf im unteren Panel, um vorherige Durchläufe anzuzeigen. Filtern Sie die Liste mit Live, Test oder Alle, wählen Sie dann einen Durchlauf aus, um seine Knotenergebnisse, Ausgabe, Timing und Fehler zu überprüfen. Die Status umfassen Abgeschlossen, Fehlgeschlagen, Wird ausgeführt und Abgebrochen.
Wenn die Liste Noch keine Durchläufe anzeigt, hat der aktuelle Workflow keine aufgezeichnete Ausführung. Das Starten eines weiteren Durchlaufs ist keine Lösung für einen fehlgeschlagenen; öffnen Sie zuerst den fehlgeschlagenen Durchlauf und lesen Sie seinen Fehler.
Einige berechtigte fehlgeschlagene Knoten bieten Erneut versuchen von "Knoten". Dies startet sofort einen neuen Versuch, ohne eine weitere Bestätigung. Nachgelagerte Aktionen können erneut ausgeführt werden. Überprüfen Sie daher zuerst auf Nachrichten oder Store-Änderungen, die bereits vom fehlgeschlagenen Durchlauf erzeugt wurden.
Bereitstellen und aktivieren
Wählen Sie Bereitstellen, um Workflow bereitstellen zu öffnen. Überprüfen Sie die Änderungszusammenfassung, API-Vertragskompatibilität, Validierungsergebnisse und optionales Änderungsprotokoll, bevor Sie fortfahren.
Sie können den bereitgestellten Workflow optional an einen Schedule oder ein Event binden. Es kann jeweils nur ein Auslösetyp ausgewählt werden.
- Bereitstellen veröffentlicht eine Version mit den ausgewählten Einstellungen.
- Aktivieren und bereitstellen wird angezeigt, wenn eine neue Schedule- oder Event-Bindung die Automatisierung aktiv machen würde. Das Bestätigen veröffentlicht die Version und ermöglicht zukünftige Auslöser, automatisch mit echten Effekten ausgeführt zu werden.
Ein Speicherfehler, ein ungelöster Konflikt oder ein Validierungsproblem kann die Bereitstellung blockieren. Beheben Sie es, anstatt wiederholt „Bereitstellen" auszuwählen.
Nach der Bereitstellung kann der Produktionsstatus Nicht bereitgestellt, Entwurf voraus oder Live anzeigen, plus Kein Auslöser, Live oder Pausiert für die Bindung. Das Öffnen einer vorhandenen Bindung bietet folgenreiche Steuerelemente:
- Pausieren stoppt automatische Auslöser, behält aber den Workflow und die Bindung bei.
- Fortsetzen ermöglicht der beibehaltenen Bindung, erneut ausgelöst zu werden.
- Entfernen löscht die Bindung dauerhaft, löscht aber nicht den Workflow.
Jede Aktion öffnet eine Bestätigung und kann einen Grund enthalten. Das Entfernen des Häkchens aus einer vorhandenen Bindung während der Bereitstellung pausiert diese Bindung, anstatt sie dauerhaft zu entfernen.
Versionsverlauf und Rollback
Wählen Sie Versionsverlauf, um das Panel Versionsverlauf zu öffnen.
| Aktion | Ergebnis |
|---|---|
| Rollback | Öffnet Zu dieser Version zurückrollen?. Bestätigen macht die ausgewählte bereitgestellte Version zur aktuellen bereitgestellten Version. Dies kann ändern, was zukünftige Durchläufe tun, ersetzt aber nicht die aktuelle Draft-Canvas. |
| Wiederherstellen im Draft-Verlauf | Ersetzt die aktuelle Canvas nach Bestätigung mit dem ausgewählten gespeicherten Entwurf. Nicht gespeicherte oder neuere Canvas-Änderungen können verloren gehen. |
Fügen Sie einen optionalen Rollback-Grund hinzu, damit andere Workspace-Mitglieder die Änderung verstehen. Überprüfen Sie die wiederhergestellte Canvas und den Bereitstellungsstatus, bevor Sie einen weiteren Durchlauf starten.
Checkliste für sicheren Betrieb
- Bestätigen Sie, dass Sie sich im richtigen Projekt und Workflow befinden.
- Warten Sie auf Gespeichert, bevor Sie testen oder bereitstellen.
- Füllen Sie jede erforderliche Eingabe aus und überprüfen Sie sie.
- Beginnen Sie mit Simulation ausführen, wenn möglich.
- Verwenden Sie Live-Test oder Workflow ausführen nur, wenn ihre Effekte auf verbundene Dienste akzeptabel sind.
- Überprüfen Sie Verlauf und Ausgaben vor der Bereitstellung.
- Behandeln Sie Aktivieren und bereitstellen, Rollback, Wiederherstellen und Löschen als folgenreiche Aktionen, die eine abschließende Überprüfung erfordern.
Fehlerbehebung
| Problem | Nächster Schritt |
|---|---|
| Kein Workflow-Eintrag ist sichtbar | Dies ist in der Standard-Navigation zu erwarten. Raten Sie nicht zu einer URL; siehe Feature-Verfügbarkeit oder fragen Sie Runner-Support, ob Ihr Workspace einen genehmigten Eintrag hat. |
| Steuerelemente werden durch eine Plan-Vorschau blockiert | Folgen Sie der Plan-Nachricht auf dem Bildschirm oder fragen Sie einen Workspace-Besitzer nach Zugriff. |
| Vorlagenliste schlägt fehl | Wählen Sie Erneut versuchen, oder erstellen Sie einen Leeren Workflow. |
| Schaltfläche „Ausführen" ist nicht verfügbar | Füllen Sie jede erforderliche Eingabe aus und beheben Sie jeden ungültigen Wert. |
| Speicherkonflikt wird angezeigt | Entscheiden Sie, ob die gespeicherte Version gewinnen sollte, bevor Sie Neu laden auswählen, da lokale in Konflikt stehende Bearbeitungen verworfen werden. |
| Durchlauf schlägt fehl | Öffnen Sie ihn im Verlauf, behalten Sie den sichtbaren Fehler und die Eingaben bei und vermeiden Sie das wiederholte Starten identischer Durchläufe. |
| Bereitstellung ist blockiert | Beheben Sie Speicher-, Konflikt-, Vertrags- oder Validierungsmeldungen, die im Bereitstellungsdialog angezeigt werden. |