Flows und Automatisierung

Ein Flow ist ein gerichteter Graph: Knoten mit Drähten dazwischen, abgelaufen von einem einzigen Startpunkt aus. Er ist bewusst kein Skript mit einer Schleife. Vier Regeln legen die Form fest, und der Editor verweigert die Veröffentlichung einer Zeichnung, die eine davon bricht, und nennt dabei den Knoten, der nicht stimmt.

• Genau ein Auslöser. Der Auslöserknoten ist der einzige Eingang, und er entscheidet, welche Variablen im Rest der Zeichnung existieren.
• Keine Zyklen. Ein Draht, der zu einem Knoten zurückführt, aus dem er kam, wird abgelehnt, denn ein Flow kann nicht warten: eine Schleife würde schlicht nie enden.
• Jeder Knoten muss vom Auslöser aus erreichbar sein. Ein Knoten, der lose hängt, ist ein Fehler, den man auf einem Bildschirmfoto nicht sieht, also ist es ein Fehler beim Veröffentlichen.
• Zweige werden nacheinander abgelaufen, nie nebeneinander. Zwei Zweige gleichzeitig würden gleichzeitig in state schreiben, und das Ergebnis hinge am zeitlichen Zufall.

Der Editor ist eine Arbeitsfläche, und einen zweiten gibt es nicht. Ein neuer Flow öffnet sich sofort darauf, und ein Flow, der eine gerade Liste von Schritten war, öffnet sich als gerade Kette von Knoten.

• Die Palette enthält die zwölf Knotenarten. Klicken Sie eine an, um sie auf die Fläche zu setzen, oder ziehen Sie sie an die gewünschte Stelle.
• Ziehen Sie einen Knoten an seiner Kopfzeile, um ihn zu verschieben. Alles andere auf dem Knoten ist ein Bedienelement und beginnt deshalb keine Ziehbewegung.
• Ein Draht läuft von einem Ausgangspunkt zu einem Eingangspunkt. Ziehen Sie vom einen zum anderen, oder klicken Sie erst den Ausgang und dann den Eingang an. Beides tut dasselbe, und das Zweite ist der Weg über die Tastatur.
• Lassen Sie einen Draht im Leeren los, passiert nichts. Zum Entfernen wählen Sie ihn aus und drücken Entfernen, oder Sie nehmen das Kreuz, das darauf sitzt.
• Zoomen Sie zwischen 50 und 200 Prozent, sehen Sie mit Einpassen die ganze Zeichnung, und ziehen Sie den Hintergrund, um zu schwenken. Eine Übersichtskarte gibt es nicht.

Zwölf Arten, und diese Liste ist mit Absicht kurz. Jede Art ist ein Bedienbereich, neun Übersetzungen, ein Zweig im Ausführer und eine Zeile in der Wahrheitstabelle, also ist eine Art, die ihr Gewicht trägt, mehr wert als eine, die es fast tut.

Fünf Momente, und welchen Sie wählen, ist nicht nur, wann der Flow läuft. Es ist auch, welche Variablen existieren, welche die Auswahl Ihnen anbietet und welche die Plattform zu speichern verweigert. Ein Pfad, der in diesem Moment nicht existieren kann, ist ein Fehler beim Speichern und kein leerer Text mitten in einer Ausführung.

Jeder Wert, den ein Flow lesen kann, stammt aus einer dieser Gruppen. Die Auswahl im Editor zeigt die Gruppen, die bei Ihrem Auslöser existieren, und sonst nichts. Einen unbekannten Pfad zu lesen ist ein Fehler und nie ein Leerwert: eine falsche Annahme gehört laut.

Ein set-Knoten schreibt in state. Sein Wert ist wörtlicher Text, es sei denn, Sie setzen den Haken für Ausdrücke; dann wird er als Vorlage gelesen, mit den Variablen dieser Ausführung eingesetzt.

• Dieser Haken ist eine bewusste Entscheidung. Ein Wert, der zufällig zwei geschweifte Klammern enthält, ein Stück Ansible oder ein Helm-Fragment, bedeutet weiterhin, was dort stand. Nichts ändert seine Bedeutung durch eine Änderung, um die niemand gebeten hat.
• Die Sprache ist reine Ausgabe. Zwei Klammern und ein Pfad, sonst nichts: kein assign, kein capture, keine Schleife, kein include. Was auf der Fläche steht, ist das, was herauskommt, mit eingesetzten Werten.
• Es gibt 46 Filter: Text, Zahlen, Datumsangaben, die wenigen Listenfilter, die Text ergeben, und die eigenen quote, ini und ipoctet. Die Auswahl im Editor zählt sie auf. Zwei Familien fehlen mit Absicht, jene die würfeln und jene die ein Objekt zurückgeben, wo Sie ein Wort wollten.
• Geheimnisse stehen hier nicht zur Verfügung, Bausteine ebenso wenig. Was ein set-Knoten schreibt, landet im Protokoll der Ausführung, und dort hat ein Geheimnis nichts verloren.

Ein Ablauf kann anhalten und auf eine Person warten, und er kann dieselben Knoten mehrfach durchlaufen. Beides ging nicht, solange ein Lauf nicht angehalten und später geweckt werden konnte. Diese Warteschlange gibt es jetzt.

• Ein Genehmigungsknoten hält den Lauf an, schreibt eine Anfrage und meldet sie dem Konto. Das Beantworten erfordert ein eigenes Recht, damit wer den Ablauf geschrieben hat nicht automatisch derjenige ist, der ihn abzeichnet.
• Jede Anfrage trägt eine Frist und das, was ohne Antwort geschieht: als genehmigt fortfahren, als abgelehnt fortfahren oder den Lauf als nicht zutreffend beenden. Eine vierte Wahl gibt es nicht, denn ein Lauf, der ewig wartet, ist ein Lauf, von dem niemand je wieder hört.
• Für jedes durchläuft seinen Schleifenausgang einmal je Element einer Liste. In der Schleife enthält state.loop das aktuelle Element, seine Position und die Gesamtzahl.
• An den Knoten innerhalb einer Schleife darf nichts von außen hängen. Diese Knoten laufen in jeder Runde erneut, und eine Meldung, die an beiden hängt, würde pro Runde eine Nachricht schreiben.
• Ein Genehmigungsschritt kann auch E-Mail senden. Diese geht nur an die Mitglieder, die über Genehmigungen entscheiden dürfen, und nicht an alle, die Flows sehen können; die Panel-Benachrichtigung wird ohnehin geschrieben.

Ein Lauf, der stillsteht, ist kein fehlgeschlagener Lauf. Drei Dinge können ihn zurückstellen, und alle drei nutzen dieselbe Warteschlange: eine Genehmigung, eine lange Pause und ein Subflow, dessen Kind selbst wartet.

• Eine Pause von einer halben Minute oder weniger wartet einfach innerhalb der Anfrage, die sie gestartet hat, und genau das möchten Sie, wenn Sie einem Agenten kurz Zeit geben. Alles Längere stellt den Lauf zurück, sodass die auslösende Bestellung sofort fertig ist und der Rest des Flows später folgt.
• Ein Subflow führt einen anderen Flow dieses Kontos als einen Schritt aus. Sein Ergebnis bestimmt den Ausgang: Ein Kind, das erfolgreich war oder nichts zu tun fand, geht über OK weiter, ein fehlgeschlagenes über Fehler. Status, Lauf und Flow-Name stehen in state.subflow.
• Ein Flow darf sich nie selbst erreichen, weder direkt noch über einen anderen Flow. Das wird beim Deployen geprüft, und die Meldung nennt die gefundene Kette.
• Flows dürfen sich höchstens drei Ebenen tief aufrufen. Da Flows unabhängig voneinander bearbeitet werden, wird diese Grenze zweimal geprüft: einmal beim Deployen und einmal, während der Lauf tatsächlich läuft.

Ein Webhook-Endpunkt gibt einem System von außen eine eigene URL. Es sendet JSON, der Flow hinter der URL läuft, und die Antwort ist ein nackter Statuscode. Endpunkte stehen unter Skripte auf dem Reiter Webhooks und sind eigene Objekte: derselbe Endpunkt kann auf einen anderen Flow zeigen, ohne dass der Absender etwas merkt.

1. 01Legen Sie den Endpunkt an und geben Sie ihm einen Namen, den Sie später wiedererkennen. Die URL wird für Sie erzeugt und ist nicht wählbar: 32 zufällige Zeichen, also 160 Bit, damit ist Raten keine Strategie.
2. 02Wählen Sie, wie der Absender sich ausweist, und kopieren Sie das Geheimnis. Es wird einmal gezeigt und danach nie wieder; ist es verloren, erzeugen Sie es neu, und dann bekommen Sie auch eine neue URL.
3. 03Richten Sie den Endpunkt auf einen Flow, dessen Auslöser ein Webhook ist. Der Endpunkt darf früher existieren als der Flow, und bis dahin wird eine Anfrage angenommen und mit einer 202 beantwortet, die nichts startet. So bauen Menschen das tatsächlich, deshalb gilt es nicht als Fehler.

Die Signatur ist das Wort sha256, ein Gleichheitszeichen und der HMAC-SHA256 über genau die Bytes aus Zeitstempel, Punkt und Rumpf, in kleinen Hexadezimalziffern. Sie gehört in X-Provibr-Signature, und der Zeitstempel selbst gehört in X-Provibr-Timestamp, als ganze Sekunden seit der Epoche.

Eine Anfrage, deren Zeitstempel mehr als 300 Sekunden alt ist oder in der Zukunft liegt, wird mit einer 401 abgelehnt. Dieses Fenster ist eine echte Regel und keine Zierde, denn der Zeitstempel steckt im signierten Material: eine abgefangene Anfrage lässt sich morgen nicht erneut senden, indem man einen frischen Zeitstempel darüberklebt.

Eine Anfrage zu signieren ist eine Zeile openssl. Dieses Beispiel sendet ein kleines Objekt; der Text für die Kommandozeile bleibt absichtlich englisch, damit er dem entspricht, was Ihr Terminal zeigt.

# Sign the raw body together with the timestamp, then post it.
SECRET="$PROVIBR_WEBHOOK_SECRET"
BODY='{"reason":"maintenance","attempt":1}'
TS=$(date +%s)
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -r | cut -d' ' -f1)

curl -sS -X POST 'https://app.provibr.com/api/hooks/flows/<your-slug>' \
  -H 'Content-Type: application/json' \
  -H "X-Provibr-Timestamp: $TS" \
  -H "X-Provibr-Signature: sha256=$SIG" \
  --data "$BODY"

Jede Anfrage hinterlässt einen Beleg, angenommen oder nicht: das Ergebnis, den zurückgegebenen Status, die Quelladresse vollständig und wie viele Bytes wirklich gelesen wurden. Der Rumpf wird nie aufbewahrt. Belege verschwinden nach 90 Tagen, früher als die Ausführungen selbst, denn eine Quelladresse ist ein personenbezogenes Datum von jemandem, der nicht unser Kunde ist.

Zwei Fragen, die einander ähneln, haben hier zwei verschiedene Antworten. Wer wann was geändert hat, ist eine Fassung. Was diese eine Ausführung tatsächlich abgelaufen ist, ist eine Kopie, die an der Ausführung selbst hängt. Eine Momentaufnahme kann die erste Frage nicht beantworten und eine Fassung die zweite nicht, deshalb gibt es beide.

• Jede Veröffentlichung schreibt eine Fassung, auch eine, die nichts geändert hat. Die Nummer zählt pro Flow hoch und wird nie wiederverwendet.
• Der Unterschied zwischen zwei Fassungen ist eine lesbare Liste und kein rohes JSON: ein Knoten hinzugefügt, entfernt oder geändert mit den genannten Feldern, ein Draht hinzugefügt oder entfernt. Wo ein Knoten auf der Fläche liegt, ist keine Änderung.
• Wiederherstellen dreht nichts zurück. Es schreibt die alte Zeichnung als neue Fassung obenauf, mit einer Notiz, woher sie stammt.
• Jede Ausführung bewahrt die Zeichnung, die sie abgelaufen ist. Ein Flow, der sich danach ändert, schreibt nie um, was eine ältere Ausführung getan hat.
• Eine Ausführung enthält eine Zeile pro besuchtem Knoten, mit dem Ergebnis und dem Ausgang, über den sie ihn verließ, und eine Zeile pro nicht besuchtem Knoten mit dem Grund. Nicht besucht ist eine Tatsache, die des Aufschreibens wert ist, und keine Leerstelle.
• Die Ausführungsliste filtert nach Auslöser, Status und Fassung und lässt sich als CSV ausgeben. Die Ausgabe endet bei 5000 Zeilen und sagt das in der Datei, statt still aufzuhören.

Skriptvorlagen führen daneben eine eigene Geschichte: jede gespeicherte Fassung des Inhalts und einen zeilenweisen Unterschied zwischen zweien davon.