Minimal-Dokumentation für Power-Automate-Flows: Wissen sichern statt an eine Person binden
Ein Minimal-Dokumentationsstandard für Power-Automate-Flows: Beschreibung, Namenskonventionen und Notizen, damit Wissen nicht an einer Person hängt.
Wie Sie Power-Automate-Flows über Lösungsexport zuverlässig sichern und wiederherstellen, laut Microsoft-Dokumentation.
Ein Flow, der über Monate gewachsen ist, verschwindet schneller als gedacht. Eine gelöschte Umgebung, ein geänderter Lizenzstatus oder ein versehentliches Überschreiben genügen. Power Automate bietet dafür keinen klassischen Sichern-Knopf.
Jede belastbare Sicherung läuft über denselben Mechanismus, der Flows zwischen Umgebungen verschiebt: den Export einer Lösung. Dieser Beitrag zeigt anhand der offiziellen Microsoft-Dokumentation, wie Sie das im Portal und per Kommandozeile tun und daraus eine wiederholbare Routine bauen.
Power Automate kennt kein eingebautes Backup, weil ein Flow ohne Lösung nur als einzelnes Objekt in einer Umgebung existiert, ohne versionierte Kopie an anderer Stelle. Genau deshalb empfiehlt die Dokumentation zum Exportieren von Lösungen, regelmäßig eine nicht verwaltete Lösung zu exportieren, um eine Sicherungskopie zu haben.
Eine Sicherung ist also kein Hintergrundprozess. Sie ist ein bewusster Exportschritt, den Sie auslösen oder automatisieren.
Als Backup eignet sich ausschließlich die nicht verwaltete Lösung, denn verwaltete Lösungen lassen sich laut Dokumentation überhaupt nicht exportieren. Die Lösungskonzepte im ALM-Leitfaden unterscheiden beide Typen so:
Eigenschaft | Nicht verwaltete Lösung | Verwaltete Lösung
Eigenschaft: Rolle · Nicht verwaltete Lösung: Entwicklungsstand und Quelle · Verwaltete Lösung: Fertiges Build-Artefakt
Eigenschaft: Bearbeitbar · Nicht verwaltete Lösung: Ja · Verwaltete Lösung: Nein
Eigenschaft: Exportierbar · Nicht verwaltete Lösung: Ja, verwaltet oder nicht verwaltet · Verwaltete Lösung: Nein
Eigenschaft: Zielumgebung · Nicht verwaltete Lösung: Entwicklung · Verwaltete Lösung: Test und Produktion
Eigenschaft: Als Sicherung geeignet · Nicht verwaltete Lösung: Ja · Verwaltete Lösung: Nein
Für Ihre Sicherung heißt das: Der Flow muss in einer nicht verwalteten Lösung liegen. Liegt er bislang nur in der Standardlösung, fügen Sie ihn zuerst einer eigenen, benannten Lösung hinzu.
Sie exportieren eine Lösung in fünf Schritten über den Bereich Lösungen in Power Automate. Die Anleitung zum Exportieren einer Lösung beschreibt den Ablauf so:
Im Archiv liegen die Flows im Ordner Workflows, je Flow eine JSON-Datei. Seit Februar 2022 gibt Microsoft dieses Format mehrzeilig aus, damit es sich in einer Versionsverwaltung sauber vergleichen lässt.
Entfernen Sie vor dem Export die Werte von Umgebungsvariablen. Sonst landen Testserver-URLs in der Sicherung und tauchen beim Wiederherstellen in der falschen Umgebung wieder auf.
Sie automatisieren den Export mit der Power Platform CLI, die den Portal-Export als Befehl pac solution export abbildet. Das folgende Skript legt einmalig ein Authentifizierungsprofil an, exportiert die Lösung und zerlegt das Archiv in Einzeldateien.
1# Einmalig: Authentifizierungsprofil für die Zielumgebung anlegen2pac auth create --name Prod --environment "https://contoso.crm4.dynamics.com"3
4# Alle ausstehenden Anpassungen veröffentlichen5pac solution publish6
7# Lösung als nicht verwaltete ZIP-Datei exportieren8pac solution export \9 --name FlowsBuchhaltung \10 --path ./backup/FlowsBuchhaltung.zip \11 --overwrite12
13# Archiv entpacken, damit Git einzelne Änderungen sichtbar macht14pac solution unpack \15 --zipfile ./backup/FlowsBuchhaltung.zip \16 --folder ./src/FlowsBuchhaltung \17 --packagetype Unmanaged \18 --allowDeleteZwei Details sind wichtig. --managed ist ein Schalter ohne Wert. Lassen Sie ihn weg, entsteht der nicht verwaltete Export, den Sie für ein Backup brauchen. Alle Parameter stehen in der Referenz zu pac solution.
Ohne CLI geht derselbe Export auch über die Dataverse-Web-API. Die Dokumentation zu Cloud-Flows im Code beschreibt die Aktion ExportSolution:
1{2 "SolutionName": "FlowsBuchhaltung",3 "Managed": false4}Die Antwort enthält das Feld ExportSolutionFile als Base64-Zeichenkette. Sie dekodieren den Wert und legen die ZIP-Datei in Ihrer Versionsverwaltung ab.
Es gibt drei praktikable Wege, und die Wahl hängt davon ab, ob der Flow in einer Lösung liegt und ob Sie automatisieren wollen.
Weg | Passend für | Automatisierbar | Voraussetzung
Weg: Export im Portal · Passend für: Einzelne Sicherung vor einer Änderung · Automatisierbar: Nein · Voraussetzung: Nicht verwaltete Lösung
Weg: pac solution export · Passend für: Regelmäßige Sicherung, Git-Anbindung · Automatisierbar: Ja · Voraussetzung: CLI und Authentifizierungsprofil
Weg: Paketexport (.zip) · Passend für: Einzelner Flow ohne Lösung · Automatisierbar: Nein · Voraussetzung: Besitzer oder Mitbesitzer
Der Paketexport läuft über Meine Flows und den Menüpunkt Exportieren > Paket (.zip). Die Dokumentation zu Nichtlösungs-Flows nennt drei Einschränkungen: Nur Besitzer exportieren, für den Import braucht es die Rolle Umgebungsersteller, und Flow-Pakete sind mit Dataverse-Lösungspaketen nicht kompatibel.
Microsoft empfiehlt an derselben Stelle ausdrücklich Dataverse und Lösungen für echtes Application Lifecycle Management. Der Paketexport bleibt die Übergangslösung für einzelne Flows.
Sie stellen einen Flow wieder her, indem Sie die exportierte Lösung in eine Umgebung importieren, in der diese Lösung noch nicht existiert. Die Dokumentation zum Importieren einer Lösung hält vier Punkte fest, die im Ernstfall zählen:
Halten Sie Lösungen deshalb klein und thematisch geschnitten. Sonst legt ein einzelner Restore kurzzeitig sämtliche Automatisierungen still.
Eine tragfähige Routine besteht aus fünf festen Schritten, die Sie wöchentlich und zusätzlich nach jeder Änderung ausführen.
Der letzte Punkt ist erfahrungsgemäß die größte Lücke. Es existiert eine ZIP-Datei, aber niemand hat den Import je geprüft. Bei NordFlux richten wir diese Routine im Rahmen der Power-Automate-Beratung mit ein, inklusive Versionsverwaltung und dokumentiertem Restore-Test.
Fünf Fehler treten bei der Sicherung über Lösungen besonders häufig auf, und alle haben eine dokumentierte Ursache.
1. Der Export enthält die letzte Änderung nicht. Ursache: Beim Export einer nicht verwalteten Lösung werden ausschließlich veröffentlichte Komponenten mitgenommen. Lösung: Aktivieren Sie Alle Änderungen veröffentlichen oder rufen Sie vorher pac solution publish auf. Quelle: Exportieren einer Lösung.
2. Die Schaltfläche Exportieren fehlt. Ursache: Die Lösung ist verwaltet, und verwaltete Lösungen lassen sich nicht exportieren. Lösung: Sichern Sie die zugrunde liegende nicht verwaltete Lösung in der Entwicklungsumgebung. Quelle: Verwaltete und nicht verwaltete Lösungen.
3. Der Import bricht ab, weil die Lösung bereits existiert. Ursache: In eine Umgebung mit derselben Lösung kann nicht importiert werden. Lösung: Nutzen Sie für den Restore-Test eine separate Umgebung. Quelle: Importieren einer Lösung.
4. Der wiederhergestellte Flow bleibt ausgeschaltet. Ursache: Der importierende Benutzer hat keine Rechte auf alle Verbindungen der Verbindungsreferenzen. Lösung: Teilen Sie die Verbindungen mit diesem Benutzer oder legen Sie sie im Zielsystem neu an. Quelle: Importieren einer Lösung, FAQ.
5. Nach dem Import zeigt der Flow auf das falsche System. Ursache: Die Werte der Umgebungsvariablen lagen im Export und wurden mit importiert. Lösung: Entfernen Sie die Werte vor dem Export und setzen Sie sie je Zielumgebung neu. Quelle: Exportieren einer Lösung.
Nein. Eine Kopie bleibt an dieselbe Umgebung gebunden und ist keine externe Sicherung. Nur der Export erzeugt eine Datei außerhalb der Umgebung, die sich versionieren und andernorts importieren lässt.
Nein. Verwaltete Lösungen lassen sich laut Dokumentation nicht exportieren. Sichern Sie immer die nicht verwaltete Lösung, aus der die verwaltete Version erzeugt wurde.
Verbindungsreferenzen kommen mit, die Verbindungen selbst nicht. Sie legen sie im Zielsystem neu an oder teilen sie mit dem importierenden Benutzer. Ohne gültige Verbindung lässt sich der Flow nicht aktivieren.
Die Dokumentation nennt keine feste Frequenz, empfiehlt aber regelmäßige Exporte. Bewährt hat sich ein Export nach jeder inhaltlichen Änderung plus ein festes Intervall als Sicherheitsnetz, etwa wöchentlich per Skript.
Nein, das wäre unnötig kleinteilig. Bündeln Sie fachlich zusammengehörige Flows. Achten Sie nur darauf, dass eine Lösung nicht so groß wird, dass ein Restore alle Automatisierungen gleichzeitig kurz deaktiviert.
Gründer von NordFlux. Sieben Jahre Erfahrung von Web und SEO bis zur Automatisierung im Konzern-Maßstab, heute pragmatisch für den Mittelstand und mit deutscher Datenhoheit.
Zertifizierungen
Ein Minimal-Dokumentationsstandard für Power-Automate-Flows: Beschreibung, Namenskonventionen und Notizen, damit Wissen nicht an einer Person hängt.
Drei Hebel für schnellere Power-Automate-Flows: gezielte Parallelität, weniger Aktionen und die richtige Connector-Wahl, laut Microsoft-Doku.
Geschäftsprozessflows, klassische Workflows und Cloud Flows in Dataverse: der Unterschied laut Microsoft-Doku und wann Sie welches Werkzeug brauchen.
Ein Lösungsexport ist schnell gemacht, ein funktionierender Restore-Test aber selten. NordFlux richtet für Ihre Power-Automate-Umgebung eine Backup-Routine ein, die regelmäßig läuft und nachweislich wiederherstellbar ist, statt nur im Ordner zu liegen.