Flow-Code und Versionen
Jeder Flow hat einen Code, an dem er überall wiedererkannt wird – in anderen Companies, in anderen Umgebungen und in der Vorlagen-Gallerie. Und jede Änderung, die du veröffentlichst, bleibt als nummerierte Version erhalten. Hier erfährst du, wie beides funktioniert und wo du es siehst.
Der Flow-Code
Bevor du einen Flow veröffentlichen (aktivieren) oder in die Vorlagen-Gallerie hochladen kannst, braucht er einen Code. Den legst du selbst auf der Flow-Karte fest.
- Stell deinen eigenen Namensraum mit einem Punkt voran, zum Beispiel
MEINEFIRMA.RECHNUNGSFREIGABE. So kommen sich deine Codes nicht mit denen aus Vorlagen anderer Herausgeber in die Quere. - Erlaubt sind die Buchstaben A–Z, Ziffern,
_und-sowie höchstens ein.zwischen Namensraum und Code. Ein Code darf bis zu 60 Zeichen lang sein. - Innerhalb einer Company kann jeden Code nur ein Flow tragen.
Flows, die es schon gab, bevor der Code Pflicht wurde, laufen ganz normal weiter. Wenn du einen solchen Flow das nächste Mal veröffentlichst oder in die Gallerie hochlädst, weist AutoFlow dich darauf hin, dass ein Code fehlt – trag ihn auf der Flow-Karte ein und versuch es noch einmal.
Wann du den Code ändern kannst
Solange der Flow mit keiner Vorlage verknüpft ist, kannst du den Code jederzeit ändern – ebenso, solange er mit einer eigenen Vorlage verknüpft ist, die noch nicht öffentlich ist. Gesperrt ist der Code:
- sobald deine Vorlage öffentlich ist und
- bei Flows, die aus der Vorlage eines anderen Herausgebers stammen.
Willst du ihn trotzdem ändern, wähle auf der Flow-Karte Verknüpfung zu Vorlage trennen – danach ist der Code wieder bearbeitbar. Denk daran: Andere Flows, die diesen Flow als SubFlow aufrufen, und Vorlagen, die ihn enthalten, finden ihn über seinen Code.
Versionsnummern
Jede Version eines Flows hat eine Nummer nach dem Muster Major.Minor.Patch, zum Beispiel 1.2.4. Lokal und in der Vorlagen-Gallerie gelten dieselben Nummern – 1.2.0 ist also überall derselbe Stand.
- Ein neuer Flow beginnt als Entwurf 0.0.1.
- Klickst du bei einem veröffentlichten Flow auf Flow bearbeiten, entsteht ein neuer Entwurf mit der nächsten Patch-Nummer: Ist 0.0.3 aktiv, heißt der Entwurf 0.0.4.
- Beim Veröffentlichen bleibt die Nummer gleich – aus dem Entwurf 0.0.4 wird die aktive Version 0.0.4.
- Minor- und Major-Nummer steigen nur, wenn du den Flow in die Vorlagen-Gallerie hochlädst oder eine Vorlagenversion installierst (siehe Flows als Vorlage speichern).
Wo du die Versionen siehst
- Die Flow-Karte zeigt die Aktive Version, also die Version, die läuft, und – solange du an einem Entwurf arbeitest – die Entwurfsversion.
- Im Flow-Arbeitsbereich steht die aktive Version neben jedem Flow in der Liste (zum Beispiel
v1.2.3) und in der Vorschau des ausgewählten Flows. - Die Liste AutoFlow Flows (Legacy) zeigt zu jedem Flow die Aktive Version.
- Über Alle Versionen anzeigen auf der Flow-Karte öffnest du die Liste Flowversionen. Die neueste Version steht oben, die Spalten sind:
| Spalte | Inhalt |
|---|---|
| Version | Die Versionsnummer. Bei Versionen aus der Zeit vor den Versionsnummern steht –. |
| Status | Aktiv – diese Version läuft. Entwurf – an dieser Version arbeitest du gerade. Vorlagenreferenz – der Stand aus der Gallerie, auf dem dein Flow aufbaut (siehe unten). Ältere Versionen haben keinen Status. |
| Erstellt aus | Die Version, aus der diese Version entstanden ist. |
| Erstellt am | Wann die Version angelegt wurde. |
Zu einer älteren Version zurück
Öffne in der Liste Flowversionen die ältere Version und klicke auf Entwurf erstellen. Der Entwurf bekommt die nächste Nummer der aktuellen Versionsreihe des Flows, nicht die der alten Version: Ist 1.2.4 aktiv und du erstellst einen Entwurf aus 0.0.2, heißt er 1.2.5. Veröffentliche ihn, damit wieder dieser Stand läuft.
Vorlagenreferenzen
Stammt ein Flow aus der Vorlagen-Gallerie, hebt AutoFlow die installierte Vorlagenversion als eigene Version mit dem Status Vorlagenreferenz auf (zum Beispiel 1.3.0). Auf dieser Grundlage bringt AutoFlow beim nächsten Vorlagen-Update deine eigenen Änderungen mit denen der Vorlage zusammen – mehr dazu unter Flow aus Vorlage erstellen.
Eine Vorlagenreferenz ist schreibgeschützt: Du kannst sie nicht veröffentlichen, ihre SmartFields nicht bearbeiten und sie nicht löschen, solange der Flow sie braucht. Willst du mit ihr arbeiten, klicke auf ihr Entwurf erstellen.
Flows exportieren und importieren
Mit Aktuelle Version exportieren auf der Flow-Karte (oder Exportieren auf einer beliebigen Version in der Liste Flowversionen) lädst du den Flow als Datei herunter. Die Datei enthält Code und Version des Flows, ihr Name folgt dem Muster AutoFlow_<Code>_<Version>.json, zum Beispiel AutoFlow_MEINEFIRMA.RECHNUNGSFREIGABE_1.2.0.json.
Importieren kannst du die Datei über Aus Datei erstellen in der Liste AutoFlow Flows (Legacy).
- Nutzt in dieser Company noch kein Flow den Code aus der Datei, entsteht ein neuer Flow.
- Gibt es schon einen Flow mit diesem Code, legt AutoFlow keinen zweiten an. Stattdessen fragt es, ob die Datei als neue Entwurfsversion dieses Flows importiert werden soll. Der Entwurf bekommt die nächste Versionsnummer dieses Flows, und Erstellt aus in der Liste Flowversionen zeigt die Version, die in der Datei steht. Enthält die Datei eine ältere Version, als der Flow schon hat, weist dich die Frage darauf hin – antworte mit Nein, wenn du die falsche Datei erwischt hast.
- Hat der Flow schon einen offenen Entwurf, weist AutoFlow dich darauf hin. Der neue Entwurf tritt an seine Stelle, der bisherige bleibt in der Versionshistorie erhalten.
Wie bei jedem Entwurf läuft die aktive Version weiter, bis du den importierten Stand veröffentlichst.