Workflows

Arbeitsabläufe

Verketten Sie die Werkzeuge Ihrer Etrebil-Produkte und Ihre externen Dienste: ein Auslöser, gezeichnete Schritte, reine Skripte, jede Ausführung Schritt für Schritt verfolgt.

In Vorbereitung Konto erstellen

Workflows verkettet Schritte zwischen Etrebil-Produkten und externen Diensten. Ein Workflow beginnt mit einem Auslöser, von Hand, bei einem Ereignis eines Produkts, zu einer festen Zeit oder über einen Webhook-Aufruf, und spielt dann seine Schritte der Reihe nach: Werkzeug eines Etrebil-Produkts über dessen MCP-Zugangspunkt, HTTP-Aufruf, Skript, Variablen, Bedingung mit zwei Zweigen, Warten bis zu 30 Tage, Abbruch mit Fehler. Der Editor zeichnet das Diagramm und schreibt dieselbe JSON-Definition wie der Reiter JSON. Die Daten gelangen über Vorlagen von einem Schritt zum nächsten, eine einfache Suche in den Variablen, nie ausgewerteter Code.

Die Ausführung ist dauerhaft: Jede Ausführung behält die Version, mit der sie gestartet wurde, schreibt ihre Position nach jedem Schritt und setzt nach einem Neustart oder einer langen Wartezeit fort. Vorübergehende Störungen werden mit wachsender Verzögerung wiederholt, und jeder gespielte Schritt lässt sich mit Eingabe, Ausgabe und Dauer nachlesen. Es gibt keine Schleife: Eine Ausführung endet immer, und eine Kette von Aufrufen zwischen Produkten startet ab dem dritten Glied keine Workflows mehr.

Eine Verbindung zu einem Produkt verwendet ein im Etrebil-Portal erstelltes Agenten-Token: Das Produkt wendet die Rechte der Person an, die es erstellt hat, Workflows umgeht nichts. Geheimnisse sind verschlüsselt und werden nie wieder gelesen, und jeder Aufruf durchläuft einen Netzwerkschutz: https, erlaubte Hosts, keine interne Adresse. Skripte sind reine Funktionen, ohne Netzwerk und ohne Festplatte, in Dauer und Speicher begrenzt, und laufen in der Produktion außerhalb des Servers.

Workflows gibt es nur im Web, und es ist noch nicht online. Erst wenige Produkte senden Ereignisse (Field Service, Planning, Manufacturing und das Marketing-Modul von CRM), und der grafische Editor wurde noch nicht im Browser ausprobiert.

Workflows ist in Vorbereitung. Sie wird mit ihrer Veröffentlichung in den Katalog des Etrebil-Abonnements aufgenommen.

Alle Funktionen von Workflows

64 Funktionen in 10 Bereichen

Workflows und grafischer Editor

Beschreibt einen Workflow als geordnete Folge von Schritten, mit Wenn- und Sonst-Zweigen, als JSON gespeichert und bei jeder Änderung der Definition versioniert.
Zeichnet das Diagramm von oben nach unten: der Auslöser oben, die verbundenen Schritte, die beiden Zweige einer Bedingung nebeneinander, das Formular des gewählten Schritts rechts.
Fügt einen Schritt über ein « + » zwischen zwei Karten ein; verschiebt den gewählten Schritt nach oben oder unten, dupliziert oder löscht ihn per Schaltfläche.
Prüft die Definition fortlaufend und listet die zu korrigierenden Punkte mit Nennung des Schritts; ein unbekanntes Feld ist ein Fehler, kein ignorierter Schritt.
Reiter JSON: dieselbe Definition als Text, bearbeitbar, um einen ganzen Workflow zu prüfen, zu kopieren oder einzufügen.
Zeigt im Schrittbereich die an dieser Stelle verfügbaren Daten; sie werden über eine Vorlage in doppelten geschweiften Klammern in ein Feld eingesetzt, eine einfache Suche in den Variablen, nie ausgewerteter Code.
Legt einen leeren, inaktiven Workflow an; er lässt sich nur aktivieren, wenn seine Definition gültig ist und die genannten Verbindungen existieren.
Jede Ausführung behält die Version, mit der sie gestartet wurde: Eine Änderung am Workflow berührt laufende Ausführungen nicht.
Protokoll jedes Workflows: Anlage, Änderungen mit Versionsnummer, Aktivierung, Deaktivierung, erneuerte Webhook-Adresse, jeweils mit Urheber.

Sieben Schrittarten

Werkzeug eines Produkts: ruft ein MCP-Werkzeug eines anderen Etrebil-Produkts über dessen Verbindung auf, mit Argumenten in JSON.
HTTP-Aufruf: GET, POST, PUT, PATCH oder DELETE an einen externen Dienst, mit Pfad, Parametern, Inhalt und Kopfzeilen; das Geheimnis der Verbindung wird automatisch gesetzt.
Skript: JavaScript, das eine JSON-Eingabe erhält und eine JSON-Ausgabe liefert, ohne Netzwerk und ohne Festplatte, höchstens eine Sekunde; was es mit console.log schreibt, füllt das Schrittprotokoll.
Variablen aus den Daten der vorherigen Schritte festlegen.
Bedingung: zwei Zweige, dann und sonst, nach einem Vergleich (gleich, verschieden, größer, kleiner, mindestens, höchstens) oder danach, ob ein Wert einen Text enthält, existiert, leer ist oder nicht.
Warten von 1 Minute bis 30 Tage: Die Ausführung wird zurückgestellt und setzt von selbst fort, auch nach einem Neustart des Servers.
Mit Fehler abbrechen, mit einer Meldung, die Daten der Ausführung aufnehmen kann.
Für jeden Werkzeug-, HTTP- oder Skriptschritt: die Variable, die das Ergebnis aufnimmt, Abbruch oder Fortsetzung bei Fehler und 1 bis 5 Versuche.
Ein Workflow hat höchstens 60 Schritte, und seine Bedingungen lassen sich höchstens 4 Ebenen tief verschachteln.

Auslöser

Von Hand, aus der Liste oder der Seite des Workflows, mit optionaler JSON-Eingabe; auch ein inaktiver Workflow lässt sich von Hand starten.
Ereignis eines Etrebil-Produkts: die sendende Anwendung und ein genauer Name oder ein Präfix mit abschließendem Sternchen; die Daten des Ereignisses kommen im Workflow an.
Empfängt die von jedem Produkt signierten Ereignisse (HMAC-SHA256), geprüft in einem Zeitfenster von 5 Minuten; ein zweimal empfangenes Ereignis startet nur eine Ausführung.
Geplant: alle N Minuten, von 5 bis 10.080, oder jeden Tag zu einer UTC-Uhrzeit; nur eine Serverinstanz löst den Termin aus, und ein verpasster Termin wird nicht nachgeholt.
Webhook: eine geheime Adresse, nur einmal angezeigt, nur als Prüfsumme gespeichert, erneuerbar; die Kopfzeile Idempotency-Key verhindert einen doppelten Start.
Unterbricht Schleifen zwischen Produkten: Ein Ereignis aus einer Kette von drei oder mehr Aufrufen wird gespeichert, startet aber nichts mehr.

Verbindungen zu Produkten und Diensten

Etrebil-Produkt: der MCP-Zugangspunkt des Produkts und ein im Etrebil-Portal erstelltes Agenten-Token; das Produkt wendet die Rechte der Person an, die das Token erstellt hat, Workflows umgeht nichts.
HTTP-Dienst: eine Basisadresse, die erlaubten Hosts, die Kopfzeile und das Präfix des Geheimnisses.
Verschlüsselt Geheimnisse mit einem Schlüssel außerhalb der Datenbank; ein Geheimnis wird nie wieder gelesen, weder am Bildschirm noch über ein MCP-Werkzeug noch im Schrittprotokoll.
Schaltfläche Testen: listet die Werkzeuge des Produkts oder sendet ein GET an den Dienst und gibt dessen Status zurück.
Netzwerkschutz bei jedem Aufruf: https auf Port 443, gelistete Hosts, keine private oder interne Adresse, jede Adresse beim Verbindungsaufbau geprüft, keine Weiterleitung verfolgt.
Begrenzt jede Antwort auf 1 MB und jeden Aufruf auf 15 Sekunden, 30 für ein Werkzeug.
Verweigert das Umbenennen oder Löschen einer Verbindung, die ein Workflow noch nennt.

Ausführungen und Verbrauch

Liste der Ausführungen, filterbar nach Status: wartend, laufend, erfolgreich, fehlgeschlagen, abgebrochen.
Seite einer Ausführung: das Diagramm der gestarteten Version, jede Karte mit ihrem Ergebnis markiert, dann jeder gespielte Schritt mit Eingabe, Ausgabe, Dauer und Versuchsnummer.
Aktualisiert sich von selbst, solange die Ausführung läuft oder wartet.
Wiederholt vorübergehende Störungen (Netzwerk, 5xx-Fehler, 429) nach 5 s, 20 s, 1 min, 3 min und dann 10 min; andere Fehler beenden die Ausführung oder werden in einer Variable festgehalten, wenn der Schritt es verlangt.
Bricht eine wartende oder laufende Ausführung ab; startet eine beendete Ausführung mit derselben Definition und derselben Eingabe erneut.
Setzt eine Ausführung dort fort, wo sie stand, wenn die Serverinstanz, die sie spielte, ausfällt; zwei Instanzen spielen nie gleichzeitig dieselbe Ausführung.
Zählt pro Monat die Ausführungen, die gespielten Schritte, die Werkzeugaufrufe, die HTTP-Aufrufe, die Skriptzeit und die abgelehnten Starts.
Monatliches Ausführungskontingent, standardmäßig 10.000, 0 für keine Grenze; darüber hinaus werden Starts bis zum Folgemonat abgelehnt.
Bewahrt beendete Ausführungen standardmäßig 30 Tage auf, einstellbar von 1 bis 365, und löscht sie dann mit ihrem Schrittprotokoll.

Rollen und Zugriff

Einmalanmeldung mit Ihrem Etrebil-Konto; jede Organisation sieht nur ihre eigenen Daten.
Mitglied: sieht die Workflows, startet einen von Hand und sieht nur die eigenen Ausführungen.
Autor: schreibt, ändert und aktiviert Workflows, sieht alle Ausführungen, bricht sie ab und startet sie neu.
Administrator: Verbindungen und Geheimnisse, Grenzen, Rollen sowie das Löschen eines Workflows mit seiner Historie.
Die Mitglieder der Etrebil-Organisation erscheinen bei ihrem ersten Besuch; ihre Eigentümer und Administratoren sind automatisch Administratoren; ein Administrator sperrt oder reaktiviert Mitarbeitende, und einer bleibt immer aktiv.
Ohne Lizenz nur Lesen; die Rechte prüft der Server, sie werden nicht nur am Bildschirm ausgeblendet.

KI-Agenten über MCP

MCP-Zugangspunkt mit einem Etrebil-Agenten-Token: Workflows auflisten, einen Workflow und seine Definition lesen, Ausführungen auflisten und lesen, den Verbrauch des Monats lesen.
Einen Workflow starten und eine Ausführung abbrechen sind Schreibwerkzeuge, Tokens mit Lese- und Schreibrecht vorbehalten.
Der Agent sieht, was die Person des Tokens sieht; Verbindungen und ihre Geheimnisse werden nicht offengelegt.

Tutorials

Einen Workflow anlegen: Name, Anlage, erster Schritt, Diagramm, Speichern.
Ein anderes Produkt anbinden: eine Verbindung mit einem Agenten-Token, dann die Schaltfläche Testen.

Auf Ihren Geräten

Web: die vollständige Anwendung, mit Einmalanmeldung, Lizenz und Daten auf dem Server.
Die Ausführungen laufen auf dem Server, auch bei geschlossenem Browser.
Vorerst keine Desktop-Anwendung und keine Android-Anwendung.

Wissenswertes

Keine Schleife, kein « für jedes » und keine Zusammenführung von Zweigen: Eine Liste wird von einem Skript oder einem Werkzeug verarbeitet, das Stapel annimmt.
Ein Schreibvorgang in einem anderen Produkt, dessen Antwort ausbleibt, kann durch einen neuen Versuch wiederholt werden: Für einen Schreibvorgang, der sich nicht wiederholen darf, stellen Sie den Schritt auf einen einzigen Versuch.
In der Produktion laufen Skripte in einem getrennten Ausführungsdienst ohne Netzwerk; ohne diesen Dienst schlagen Skriptschritte fehl.
Erst wenige Produkte senden Ereignisse: Field Service, Planning, Manufacturing und das Marketing-Modul von CRM. Die anderen lösen keine Workflows aus; wer MCP-Werkzeuge veröffentlicht, lässt sich trotzdem über einen Werkzeugschritt steuern.
Jedes zu steuernde Produkt erfordert ein Agenten-Token mit Lese- und Schreibrecht, im Etrebil-Portal erstellt, und dann eine Verbindung: ein manueller Schritt pro Produkt.
In einem Werkzeugschritt wird der Werkzeugname von Hand eingegeben; die Schaltfläche Testen auf der Seite Verbindungen liefert die Liste.
Eine Workflow-Vorlage für DataVirt, prüfen und dann eine Staging-Datenbank unter Schutzvorkehrungen übertragen, ist geschrieben, wird aber noch nicht am Bildschirm angeboten.
Der Schlüssel für die Verschlüsselung der Geheimnisse ist gesondert zu sichern: Geht er verloren, müssen die Geheimnisse neu eingegeben werden, und er lässt sich noch nicht wechseln.
Kein Export und kein Import der Organisation: Eine Definition wird über den Reiter JSON kopiert.
Der Editor wurde noch nicht im Browser ausprobiert und der Dienst nicht bereitgestellt; echte Agenten-Tokens und Last wurden nicht erprobt.