Zum Hauptinhalt springen

Flow aus Vorlage erstellen

Nutze eine Vorlage als Ausgangspunkt für einen neuen Flow. Die Vorlagen-Gallerie enthält sowohl die privaten Vorlagen deines Tenants als auch die öffentlichen, kuratierten Vorlagen von mse Software und ausgewählten Partnern – alles, was in deiner Liste sichtbar ist, kannst du verwenden.

Die Liste​

Öffne AutoFlow Vorlagen-Gallerie über die BC-Suche. Jede Zeile zeigt:

  • Publisher – der Firmenname des Tenants, der die Vorlage hochgeladen hat. Bei deinen eigenen privaten Vorlagen wird stattdessen dein registrierter Firmenname angezeigt.
  • Mit mir geteilt – eine Vorlage, die eine andere Organisation (meist dein Partner) gezielt für deine Organisation freigegeben hat. Sie ist nicht öffentlich: nur die ausgewählten Organisationen sehen sie. Du nutzt sie wie jede andere Vorlage; der Herausgeber behält die Kontrolle und kann die Freigabe widerrufen – dann verschwindet die Vorlage wieder aus deiner Gallerie. Bereits daraus erstellte Flows bleiben davon unberührt.
  • Name und Tagline – ein Kurzbezeichner und eine einzeilige Beschreibung.
  • Sprache – die Sprache, für die die Vorlage erstellt wurde (z. B. de-de, en-us).
  • Version – die aktuelle Version der Vorlage in der Gallerie.

Wählst du eine Zeile aus, erscheinen zwei Factboxen:

  • Vorlagen-Details – die gerenderte Verwendungsanleitung sowie der Voraussetzungs-Status.
  • Änderungsprotokoll – die Versionshistorie, neueste oben.

Flow erzeugen​

Klicke auf der gewünschten Zeile auf Flow aus Vorlage erstellen.

  1. Die Voraussetzungen werden erneut geprüft. Fehlt eine App oder ist sie zu alt, wirst du darauf hingewiesen und die Aktion bleibt deaktiviert, bis du das Problem behoben hast.
  2. Bei öffentlichen Vorlagen öffnet sich ein Schritt-Vorschau-Dialog. Er listet jede Aktion im Flow sowie die externen Endpunkte, die sie ansprechen (HTTP-Request-URLs, Mail-Empfänger, …). Hier kannst du prüfen, was eine Vorlage eines fremden Publishers tatsächlich macht, bevor sie auf deinem Tenant landet.
  3. Es wird ein neuer Flow mit der Definition und dem Code der Vorlage angelegt. Die Beschreibung des Flows entspricht zunächst dem Vorlagen-Namen; existiert bereits ein Flow mit diesem Namen, wird ein Zähler-Suffix angehängt, bis er eindeutig ist.
  4. Die Flow-Karte öffnet sich, sodass du die Beschreibung anpassen, fehlende Anmeldedaten ergänzen und veröffentlichen kannst.

Der neue Flow wird nie automatisch aktiviert. AutoFlow hebt die Vorlagenversion als schreibgeschützte Vorlagenreferenz auf (zum Beispiel 1.3.0) und legt dir einen Entwurf mit der nächsten Patch-Nummer an (1.3.1), mit dem du arbeitest. Sieh dir den Entwurf an und veröffentliche ihn selbst, wenn er passt. Wie die Nummern zustande kommen, steht unter Flow-Code und Versionen.

Wenn es schon einen Flow mit demselben Code gibt​

Trägt in dieser Company bereits ein Flow den Code der Vorlage, fragt AutoFlow, ob er überschrieben werden soll. Ist dieser Flow mit einer Vorlage verknüpft, nennt die Rückfrage auch deren Namen.

  • Ja – es entsteht kein neuer Flow. Der vorhandene Flow bekommt die Vorlage als neue Entwurfsversion und ist ab jetzt mit ihr verknüpft. Seine aktive Version läuft weiter, bis du den Entwurf veröffentlichst.
  • Nein – es wird nichts installiert.

Wurde der vorhandene Flow aus genau dieser Vorlage erstellt, behandelt AutoFlow die Installation stattdessen als Update.

Aus der Gallerie aktualisieren​

Der neue Flow ist mit der Vorlage verknüpft. Die Flow-Karte zeigt die Vorlagen-Version an, aus der er erstellt wurde, und du erhältst zwei Folge-Aktionen:

  • Aus Vorlage aktualisieren – bringt den Flow auf den aktuellen Stand der Vorlage in der Gallerie, wie unten beschrieben. Ist die Gallerie nicht weiter als die Version, die du schon hast, meldet die Aktion das und lässt den Flow, wie er ist.
  • Verknüpfung zu Vorlage trennen – löst die Verknüpfung. Sinnvoll, wenn du den Flow stark angepasst hast und keine Updates aus der Gallerie mehr verfolgen möchtest. Danach kannst du auch den Code des Flows wieder ändern.

Egal, was beim Update passiert: Am Ende steht immer ein neuer Entwurf. Die aktive Version läuft weiter, bis du ihn veröffentlichst, und alle älteren Versionen bleiben in der Versionshistorie.

Ohne eigene Änderungen​

Hast du den Flow seit der Installation nicht verändert, wird die neue Vorlagenversion einfach zur neuen Vorlagenreferenz und zu einem neuen Entwurf – zum Beispiel Referenz 1.3.0 und Entwurf 1.3.1.

Deine Änderungen und die der Vorlage werden zusammengeführt​

Hast du den Flow verändert, vergleicht AutoFlow drei Stände miteinander: die Vorlagenreferenz, von der du ausgegangen bist, deinen Flow und die neue Vorlagenversion. Solange beide Seiten nicht dasselbe anfassen, landen beide Änderungen im Entwurf – du hast einen Schritt geändert, die Vorlage einen anderen; du hast eine Notiz ergänzt, die Vorlage einen Zweig. Wenn du nur Schritte auf der Zeichenfläche verschoben hast, zählt das nicht als Änderung. AutoFlow sagt dir, dass zusammengeführt wurde – prüf den Entwurf, bevor du ihn veröffentlichst.

Konflikte​

Haben du und die Vorlage dieselbe Stelle geändert, öffnet sich der Dialog Vorlagen-Update – Konflikte. Jede Zeile nennt den Schritt, die Einstellung, deinen Wert, den Wert der Vorlage und den Grund. Ein Konflikt liegt zum Beispiel vor, wenn

  • beide Seiten dieselbe Einstellung desselben Schritts geändert haben,
  • du einen Schritt geändert hast, den die Vorlage gelöscht hat – oder umgekehrt,
  • beide Seiten einen Schritt an unterschiedliche Stellen im Flow verschoben haben,
  • beide Seiten einen neuen Schritt mit demselben Slug angelegt haben,
  • ein Schritt auf einen anderen verweist, den es nicht mehr gibt.

Mit Lokale Änderungen überschreiben wird der Entwurf genau zur Vorlagenversion, deine lokalen Änderungen sind darin nicht mehr enthalten. Mit Abbrechen bleibt der Flow, wie er ist.

Flows, die vor den Versionsnummern aus einer Vorlage erstellt wurden

Solche Flows haben noch keine Vorlagenreferenz. Beim ersten Update kann AutoFlow deine Änderungen deshalb nicht mit denen der Vorlage zusammenführen und bietet nur an, die lokalen Änderungen mit der Vorlage zu überschreiben (oder abzubrechen). Ab dann werden Updates dieses Flows wie oben beschrieben zusammengeführt.

Anmeldedaten​

Eine Vorlage enthält keine Anmeldedaten. Der Flow kennt nur die Namen der Anmeldedaten, die er braucht; die eigentlichen Passwörter, Tokens oder API-Keys liegen pro Tenant getrennt und werden niemals in die Gallerie hochgeladen. Nach dem Erzeugen des Flows öffnest du die Seite AutoFlow-Anmeldedaten und trägst die Werte für die Namen ein, die der Flow erwartet. Schritte, denen ein passender Eintrag fehlt, laufen nicht – sie melden dir beim Versuch, welche Anmeldedaten ihnen fehlen.

Verwendungs- und Änderungsprotokoll-Text formatieren​

Die beiden Factboxen nehmen ein kleines Markdown-Set für die Verwendungs-Notizen und das Änderungsprotokoll an:

  • Überschriften mit ## … (groß) und ### … (kleiner).
  • Absätze, getrennt durch eine Leerzeile.
  • Aufzählungen mit -, * oder +.
  • Fett, kursiv, Inline-Code.
  • Links wie [Hier klicken](https://example.com).
  • Horizontale Linien mit --- auf einer eigenen Zeile – praktisch zwischen Versionen im Änderungsprotokoll.

Alles andere erscheint als reiner Text. Das gilt auch für Bilder und eingebettetes HTML, die in den Factboxen nicht gerendert werden – gut zu wissen, wenn du eigene Vorlagen schreibst.