Exportieren von Verbrauchsworkflows in eine Standard-Logik-App

  • Artikel

Standard-Logik-App-Workflows, die in Azure Logic Apps mit nur einem Mandanten ausgeführt werden, bieten viele neue und verbesserte Funktionen. Beispielsweise erhalten Sie isoliertes Compute, Integration virtueller Netzwerke und private Endpunkte zusammen mit dem Hosting von App Services-Umgebung, lokaler Entwicklung und Debuggen mithilfe von Visual Studio Code, niedrigen Wartezeiten mit zustandslosen Workflows und mehr.

Wenn Sie die Vorteile von Standardworkflows nutzen möchten, Ihre Workflows aber in Azure Logic Apps mit mehreren Mandanten ausgeführt werden, können Sie Ihre Verbrauchsworkflows jetzt zu Azure Logic Apps mit einem einzelnen Mandanten verschieben. Dieser Wechsel ist in Szenarien sinnvoll, die einige der Standardfunktionen erfordern, z. B. Isolation und Netzwerkintegration, geringere Wartezeit oder bessere Vorhersagbarkeit der Kosten.

Sie können jetzt Verbrauchs-Logik-Apps in eine Standard-Logik-App exportieren. Mithilfe von Visual Studio Code und der neuesten Azure Logic Apps (Standard)-Erweiterung exportieren Sie Ihre Logik-Apps als zustandsbehaftete Workflows in ein Standard-Logik-App-Projekt. Anschließend können Sie Ihre Workflows lokal aktualisieren, testen und debuggen, um sie für die erneute Bereitstellung vorzubereiten. Wenn Sie bereit sind, können Sie entweder direkt aus Visual Studio Code oder über Ihren eigenen DevOps-Prozess bereitstellen.

Hinweis

Die Exportfunktion führt keine Migration Ihrer Workflows durch. Stattdessen repliziert dieses Tool Artefakte, z. B. Workflowdefinitionen, Verbindungen, Integrationskontoartefakte und andere. Ihre Quell-Logik-App-Ressourcen, Workflows, der Triggerverlauf, der Ausführungsverlauf und andere Daten bleiben intakt.

Sie steuern den Exportprozess und Ihre Migrations-Journey. Sie können Ihre exportierten Workflows nach Ihren Wünschen mit der Zielumgebung testen und überprüfen. Sie entscheiden, wann Sie Ihre Quell-Logik-Apps deaktivieren oder löschen möchten.

In diesem Artikel erhalten Sie Informationen zum Exportprozess und erfahren, wie Sie Ihre Logik-App-Workflows aus einer ISE in ein lokales Standard-Logik-App-Projekt in Visual Studio Code exportieren.

Einschränkungen und bekannte Probleme

  • Das Exporttool exportiert keine Infrastrukturinformationen wie z. B. Integrationskontoeinstellungen.

  • Das Exporttool kann Logik-App-Workflows mit Triggern exportieren, die über Parallelitätseinstellungen verfügen. Azure Logic Apps ignoriert diese Einstellungen allerdings.

  • Logik-Apps müssen in derselben Region vorhanden sein, wenn Sie sie innerhalb desselben Standard-Logik-App-Projekts exportieren möchten.

  • Standardmäßig werden Verbindungsanmeldeinformationen aus Quell-Logik-App-Workflows nicht geklont. Bevor Ihre Logik-App-Workflows ausgeführt werden können, müssen Sie diese Verbindungen nach dem Export erneut authentifizieren.

  • Wenn ein Azure-Connector über eine integrierte Connectorversion verfügt, konvertiert das Exporttool den Azure-Connector standardmäßig automatisch in den integrierten Connector. Es gibt keine Möglichkeit, dieses Verhalten zu deaktivieren.

Exportierbare Vorgangstypen

Vorgang JSON-Typ
Trigger Integriert: Http, HttpWebhook, Recurrence, manual (Anforderung)

Verwaltet: ApiConnectionApiConnectionNotification, ApiConnectionWebhook
Aktion Integriert: AppendToArrayVariable, AppendToStringVariable, Compose, DecrementVariable, Foreach, Http, HttpWebhook, If, IncrementVariable, InitializeVariable, JavaScriptCode, Join, ParseJson, Response, Scope, Select, SetVariable, Switch, Table, Terminate, Until, Wait

- Verwaltet: ApiConnection, ApiConnectionWebhook

Voraussetzungen

  • Eine oder mehrere Logik-Apps, die in demselben Abonnement und derselben Azure-Region bereitgestellt werden sollen, z. B. USA, Osten 2.

  • Azure-Leserzugriff auf Abonnementebene auf das Abonnement, in dem die Logik-Apps derzeit bereitgestellt sind.

  • Azure-Mitwirkenderzugriff auf Ressourcengruppenebene, wenn Sie die Option zum Bereitstellen von verwalteten Connectors auswählen.

  • Überprüfen und erfüllen Sie die Anforderungen für das Einrichten von Visual Studio Code mit der Azure Logic Apps (Standard)-Erweiterung.

Hinweis

Stellen Sie sicher, dass Sie Version 2.0.16 oder höher für die Azure Logic Apps-Erweiterung (Standard) für Visual Studio Code installieren. Für einige Konvertierungsszenarien ist der neueste Workflow-Designer erforderlich, der ab dieser Version verfügbar ist.

Gruppieren von Logik-Apps für den Export

Mit der Azure Logic Apps (Standard)-Erweiterung können Sie mehrere Verbrauchs-Logik-App-Workflows in einem einzigen Standard-Logik-App-Projekt kombinieren. In Azure Logic Apps mit nur einem Mandanten kann eine Standard-Logik-App-Ressource über mehrere Workflows verfügen. Mit diesem Ansatz können Sie Ihre Workflows vorab überprüfen, damit Sie keine Abhängigkeiten übersehen, wenn Sie Logik-Apps für den Export auswählen.

Berücksichtigen Sie die folgenden Empfehlungen, wenn Sie Logik-Apps für den Export auswählen:

  • Gruppieren Sie Logik-Apps, bei denen Workflows dieselben Ressourcen nutzen, z. B. Integrationskontoartefakte, Zuordnungen und Schemas, oder die Ressourcen in einer Kette von Prozessen verwenden.

  • Überprüfen Sie für die Organisation und Anzahl von Workflows pro Logik-App bewährte Methoden und Empfehlungen.

Exportieren von Verbrauchsworkflows in ein lokales Projekt

Auswählen von Logik-Apps für den Export

  1. Melden Sie sich in Visual Studio Code bei Azure an, wenn dies noch nicht geschehen ist.

  2. Wählen Sie in der Aktivitätsleiste von Visual Studio Code Azure aus, um das Fenster Azure zu öffnen (UMSCHALT+ALT+A).

    Screenshot der Visual Studio Code-Aktivitätsleiste mit ausgewähltem Azure-Symbol.

  3. Wählen Sie auf der Symbolleiste des Abschnitts Arbeitsbereich im Menü Azure Logic Apps die Option Logik-App exportieren aus.

    Screenshot des Azure-Fensters, der Symbolleiste des Abschnitts „Arbeitsbereich“ und der ausgewählten Option „Logik-App exportieren“.

  4. Nachdem die Registerkarte Exportieren geöffnet wurde, wählen Sie Ihr Azure-Abonnement und die Region aus und klicken dann auf Weiter.

    Screenshot der Registerkarte „Exportieren“ mit ausgewähltem Azure-Abonnement und ausgewählter Region.

  5. Wählen Sie die Logik-Apps aus, die exportiert werden sollen. Jede ausgewählte Logik-App wird in der Liste Ausgewählte Logik-Apps angezeigt. Klicken Sie auf Weiter, wenn Sie fertig sind.

    Tipp

    Sie können auch nach Logik-Apps suchen und nach Ressourcengruppe filtern.

    Screenshot des Abschnitts „Zu exportierende Logik-Apps auswählen“ mit für den Export ausgewählten Logik-Apps.

    Das Exporttool beginnt mit der Überprüfung, ob Ihre ausgewählten Logik-Apps für den Export berechtigt sind.

Überprüfen der Exportvalidierungsergebnisse

  1. Nach Abschluss der Exportvalidierung überprüfen Sie die Ergebnisse, indem Sie den jeweiligen Eintrag für jede Logik-App erweitern.

    • Logik-Apps mit Fehlern sind nicht für den Export berechtigt. Sie müssen diese Logik-Apps aus der Exportliste entfernen, bis Sie sie an der Quelle korrigiert haben. Um eine Logik-App aus der Liste zu entfernen, wählen Sie Zurück aus.

      Beispielsweise weist SourceLogicApp2 einen Fehler auf und kann erst exportiert werden, nachdem dieser behoben wurde:

      Screenshot des Abschnitts „Exportstatus überprüfen“ mit einem Validierungsstatus für einen Logik-App-Workflow mit einem Fehler.

    • Logik-Apps, die die Validierung mit oder ohne Warnungen bestehen, sind weiterhin für den Export berechtigt. Um fortzufahren, wählen Sie Exportieren aus, wenn alle Apps erfolgreich validiert wurden, oder wählen Sie Mit Warnungen exportieren aus, wenn Apps Warnungen aufweisen.

      Beispielsweise weist SourceLogicApp3 eine Warnung auf, aber Sie können den Export weiterhin fortsetzen:

      Screenshot des Abschnitts „Exportstatus überprüfen“ mit einem Validierungsstatus für einen Logik-App-Workflow mit einer Warnung.

    In der folgenden Tabelle finden Sie weitere Informationen zu jedem Validierungssymbol und -status:

    Validierungssymbol Validierungsstatus
    Symbol „Erfolgreich“ Das Element hat die Validierung bestanden, sodass der Export ohne zu behebende Probleme fortgesetzt werden kann.
    Symbol „Fehler“ Das Element hat die Validierung nicht bestanden, sodass der Export nicht fortgesetzt werden kann.

    Der Validierungseintrag für das fehlgeschlagene Element wird automatisch erweitert angezeigt und stellt Informationen zum Validierungsfehler bereit.
    Warnungssymbol Das Element hat die Validierung mit einer Warnung bestanden, aber der Export kann mit der nach dem Export erforderlichen Auflösung fortgesetzt werden.

    Der Validierungseintrag für das Element mit einer Warnung wird automatisch erweitert angezeigt und stellt Informationen zu der Warnung und der nach dem Export erforderlichen Korrektur bereit.

  2. Nachdem der Abschnitt Export fertig stellen angezeigt wurde, navigieren Sie zum Exportspeicherort, und wählen Sie einen lokalen Ordner für Ihr neues Standard-Logik-App-Projekt aus.

    Screenshot des Abschnitts „Export fertig stellen“ und der Eigenschaft „Exportspeicherort“ mit ausgewähltem lokalen Exportprojektordner.

  3. Wenn Ihr Workflow verwaltete Verbindungen enthält, die Sie bereitstellen möchten, was nur für Nicht-Produktionsumgebungen empfohlen wird, wählen Sie Verwaltete Verbindungen bereitstellen aus, wodurch vorhandene Ressourcengruppen in Ihrem Azure-Abonnement angezeigt werden. Wählen Sie die Ressourcengruppe aus, in der Sie die verwalteten Verbindungen bereitstellen möchten.

    Screenshot des Abschnitts „Export fertig stellen“ mit ausgewähltem lokalem Exportordner, ausgewählter Option „Verwaltete Verbindungen bereitstellen“ und ausgewählter Zielressourcengruppe.

  4. Überprüfen Sie unter Schritte nach dem Export alle erforderlichen Schritte, die nach dem Export auszuführen sind, z. B.:

    Screenshot des Abschnitts „Schritte nach dem Export“ und der nach dem Export auszuführenden erforderlichen Schritte, falls vorhanden

  5. Wählen Sie basierend auf Ihrem Szenario Exportieren und fertig stellen oder Mit Warnungen exportieren und fertig stellen aus.

    Das Exporttool lädt Ihr Projekt in Ihren ausgewählten Ordnerspeicherort herunter, erweitert das Projekt in Visual Studio Code und stellt alle verwalteten Verbindungen bereit, wenn Sie diese Option ausgewählt haben.

    Screenshot: Abschnitt „Exportstatus“ mit dem Exportfortschritt

  6. Nachdem dieser Vorgang abgeschlossen wurde, öffnet Visual Studio Code einen neuen Arbeitsbereich. Sie können das Exportfenster jetzt gefahrlos schließen.

  7. Öffnen Sie in Ihrem Standard-Logik-App-Projekt die Datei „README.md“, um sich die nach dem Export durchzuführenden erforderlichen Schritte anzusehen.

    Screenshot eines neuen Standard-Logik-App-Projekts mit geöffneter Datei „README.md“.

Nach dem Export auszuführende Schritte

Schritte zur Bereinigung

Einige exportierte Logik-App-Workflows erfordern die Durchführung von Korrekturschritten nach dem Export, damit sie auf der Standardplattform ausgeführt werden können.

  1. Öffnen Sie in Ihrem Standard-Logik-App-Projekt die Datei „README.md“, und überprüfen Sie die Korrekturschritte für Ihre exportierten Workflows. Das Exporttool generiert die Datei „README.md“, die alle nach dem Export auszuführenden erforderlichen Schritte enthält.

  2. Bevor Sie Änderungen an Ihrem Quell-Logik-App-Workflow vornehmen, stellen Sie sicher, dass Sie Ihre neue Standard-Logik-App-Ressource und deren Workflows testen.

Aktionen und Einstellungen des Integrationskontos

Wenn Sie Aktionen exportieren, die von einem Integrationskonto abhängig sind, müssen Sie Ihre Standard-Logik-App manuell mit einem Verweislink auf das Integrationskonto einrichten, das die erforderlichen Artefakte enthält. Weitere Informationen hierzu finden Sie unter Verknüpfen eines Integrationskontos mit einer Standard-Logik-App.

Batch-Aktionen und -Einstellungen

Wenn Sie Aktionen exportieren, die Batch-Aktionen mit mehreren in einem Integrationskonto gespeicherten Konfigurationen verwenden, müssen Sie Ihre Batch-Aktionen nach dem Export manuell mit den richtigen Werten konfigurieren. Weitere Informationen finden Sie unter Versand, Empfang und Batchverarbeitung von Nachrichten in Azure Logic Apps.

Ordnerstruktur des Projekts

Nach Abschluss des Exportvorgangs enthält Ihr Standard-Logik-App-Projekt neue Ordner und Dateien zusammen mit den meisten anderen in einem typischen Standard-Logik-App-Projekt vorhandenen.

In der folgenden Tabelle werden diese neuen Ordner und Dateien beschrieben, die durch den Exportvorgang hinzugefügt wurden:

Ordner Datei BESCHREIBUNG
.development\deployment LogicAppStandardConnections.parameters.json Azure Resource Manager-Vorlagenparameterdatei für die Bereitstellung verwalteter Connectors
LogicAppStandardConnections.template.json Azure Resource Manager-Vorlagendefinition für die Bereitstellung verwalteter Connectors
LogicAppStandardInfrastructure.parameters.json Azure Resource Manager-Vorlagenparameterdatei für die Bereitstellung der Standard-Logik-App-Ressource
LogicAppStandardInfrastructure.template.json Azure Resource Manager-Vorlagendefinition für die Bereitstellung der Standard-Logik-App-Ressource
.logs\export exportReport.json Unformatierte Zusammenfassungsdatei des Exportberichts, die alle Schritte enthält, deren Ausführung für die Korrektur nach dem Export erforderlich ist.
exportValidation.json Unformatierte Validierungsberichtsdatei, die die Validierungsergebnisse für jede exportierte Logik-App enthält.
README.md Markdowndatei mit Zusammenfassung der Exportergebnisse, einschließlich der erstellten Logik-Apps und aller erforderlichen weiteren Schritte.

Nächste Schritte