Erstellen von Integrationsworkflows mit der Azure Logic Apps-Einzelmandanteninstanz (Standard) in Visual Studio Code

In diesem Artikel wird anhand eines Beispiels gezeigt, wie Sie in Visual Studio Code mit der Erweiterung Azure Logik-App (Standard) einen automatisierten Integrationsworkflow erstellen, der in der Azure Logic Apps-Umgebung mit Einzelmandanteninstanz ausgeführt wird. Die Logik-App, die Sie mit dieser Erweiterung erstellen, basiert auf dem Logik-App-Ressourcentyp (Standard) , der die folgenden Funktionen bietet:

  • Sie können Ihre Logik-App-Workflows in der Visual Studio Code-Entwicklungsumgebung lokal ausführen und testen.

  • Ihre Logik-App kann über mehrere zustandsbehaftete und zustandslose Workflows verfügen.

  • Workflows in derselben Logik-App und demselben Mandanten werden im gleichen Prozess wie die Azure Logic Apps-Runtime ausgeführt, sodass sie dieselben Ressourcen gemeinsam nutzen und eine bessere Leistung bieten.

  • Sie können die Bereitstellung des Ressourcentyps Logik-App (Standard) in der Azure Logic Apps-Umgebung mit Einzelmandanteninstanz oder an einer beliebigen Stelle (darunter Container) ausführen, die Azure Functions aufgrund der containerisierten Runtime von Azure Logic Apps ausführen kann.

Weitere Informationen zum Einzelmandantenangebot von Azure Logic Apps finden Sie unter Vergleich zwischen Umgebungen mit einem Mandanten und mehreren Mandanten bzw. Integrationsdienstumgebung für Azure Logic Apps.

Obwohl der Beispielworkflow cloudbasiert ist und nur zwei Schritte umfasst, können Sie Workflows aus Hunderten von Vorgängen erstellen, die eine Vielzahl von Apps, Daten, Diensten und Systemen über Cloud-, lokale und Hybridumgebungen hinweg verbinden können. Der Beispielworkflow beginnt mit dem integrierten Anforderungstrigger und folgt mit einer Office 365 Outlook-Aktion. Der Trigger erstellt einen aufrufbaren Endpunkt für den Workflow und wartet auf eine eingehende HTTPS-Anforderung einer beliebigen aufrufenden Funktion. Wenn der Trigger eine Anforderung erhält und auslöst, wird die nächste Aktion ausgeführt, indem eine E-Mail an die angegebene E-Mail-Adresse zusammen mit den ausgewählten Ausgaben des Triggers gesendet wird.

Tipp

Wenn Sie nicht über ein Office 365-Konto verfügen, können Sie jede andere verfügbare Aktion verwenden, die Nachrichten von Ihrem E-Mail-Konto senden kann, z. B. Outlook.com.

Führen Sie die Schritte unter Erstellen von Integrationsworkflows mithilfe von Azure Logic Apps mit einzelnem Mandanten und dem Azure-Portal aus, um diesen Beispielworkflow stattdessen mithilfe des Azure-Portals zu erstellen. Beide Optionen bieten die Möglichkeit, Logik-App-Workflows in denselben Arten von Umgebungen zu entwickeln, auszuführen und bereitzustellen. Mit Visual Studio Code können Sie Workflows jedoch lokal in Ihrer Entwicklungsumgebung entwickeln, testen und ausführen.

Screenshot that shows Visual Studio Code, logic app project, and workflow.

Im Weiteren führen Sie diese allgemeinen Aufgaben aus:

  • Erstellen Sie ein Projekt für Ihre Logik-App und einen leeren zustandsbehafteten Workflow.
  • Hinzufügen eines Triggers und einer Aktion.
  • Lokales Ausführen, Testen, Debuggen und Überprüfen des Ausführungsverlaufs.
  • Suchen von Domänennamensdetails für den Firewallzugriff.
  • Bereitstellen in Azure, was die optionale Aktivierung von Application Insights beinhaltet.
  • Verwalten Ihrer bereitgestellten Logik-App in Visual Studio Code und im Azure-Portal.
  • Aktivieren des Ausführungsverlaufs für zustandslose Workflows.
  • Aktivieren oder Öffnen von Application Insights nach der Bereitstellung.

Voraussetzungen

Zugriff und Konnektivität

  • Zugriff auf das Internet, damit Sie die Anforderungen herunterladen, von Visual Studio Code aus eine Verbindung mit Ihrem Azure-Konto herstellen und aus Visual Studio Code in Azure veröffentlichen können.

  • Ein Azure-Konto und ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

  • Um denselben Beispielworkflow in diesem Artikel zu erstellen, benötigen Sie ein Office 365 Outlook-E-Mail-Konto, das ein Geschäfts-, Schul- oder Unikonto von Microsoft für die Anmeldung verwendet.

    Wenn Sie einen anderen E-Mail-Connector wählen, z. B. Outlook.com, können Sie dem Beispiel trotzdem folgen, und die allgemeinen Schritte sind dieselben. Ihre Optionen können sich jedoch in einigen Punkten unterscheiden. Wenn Sie beispielsweise den Outlook.com-Connector verwenden, verwenden Sie stattdessen Ihr persönliches Microsoft-Konto, um sich anzumelden.

Speicheranforderungen

Für die lokale Entwicklung in Visual Studio Code müssen Sie einen lokalen Datenspeicher für Ihr Logik-App-Projekt und Ihre Workflows einrichten, die für die Ausführung in Ihrer lokalen Entwicklungsumgebung verwendet werden. Sie können den Azurite-Speicheremulator als lokalen Datenspeicher verwenden und ausführen.

  1. Laden Sie Azurite 3.12.0 oder höher herunter, und installieren Sie es.
  2. Bevor Sie Ihre Logik-App ausführen, müssen Sie den Emulator starten.

Weitere Informationen finden Sie in der Azurite-Dokumentation.

Tools

  • Visual Studio Code (kostenlos). Laden Sie darüber hinaus diese Tools für Visual Studio Code herunter, und installieren Sie sie, falls sie noch nicht vorhanden sind:

    • Azure-Kontoerweiterung, die eine einzelne allgemeine Azure-Anmeldungs- und -Abonnementfilterungserfahrung für alle anderen Azure-Erweiterungen in Visual Studio Code bereitstellt.

    • C# für Visual Studio Code-Erweiterung, mit der die F5-Funktionalität in die Lage versetzt wird, Ihre Logik-App auszuführen.

    • Azure Functions Core Tools – Version 3.x über die MSI-Version (Microsoft Installer), die func-cli-X.X.XXXX-x*.msi lautet. Installieren Sie nicht die Version 4.x, die nicht unterstützt wird und nicht funktioniert.

      Diese Tools enthalten eine Version derselben Runtime, auf der die Azure Functions-Runtime basiert, die die Erweiterung „Azure Logic Apps (Standard)“ in Visual Studio Code verwendet.

      Wichtig

      Wenn Sie über eine Installation verfügen, die älter als diese Versionen ist, deinstallieren Sie diese Version zuerst, oder stellen Sie sicher, dass die PATH-Umgebungsvariable auf die Version verweist, die Sie herunterladen und installieren.

    • Azure Logic Apps (Standard)-Erweiterung für Visual Studio Code.

      Wichtig

      Projekte, die mit früheren Vorschauerweiterungen erstellt wurden, funktionieren nicht mehr. Deinstallieren Sie zum Fortfahren alle früheren Versionen, und erstellen Sie Ihre Logik-App-Projekte neu.

      Führen Sie zum Installieren der Erweiterung Azure Logic Apps (Standard) die folgenden Schritte aus:

      1. Wählen Sie in Visual Studio Code in der linken Symbolleiste Erweiterungen aus.

      2. Geben Sie in das Suchfeld für Erweiterungen azure logic apps standard ein. Wählen Sie in der Ergebnisliste Azure Logic Apps (Standard)>Installieren aus.

        Nach Abschluss der Installation wird die Erweiterung in der Liste Erweiterungen: Installiert angezeigt.

        Screenshot showing Visual Studio Code with the Azure Logic Apps (Standard) extension installed

        Tipp

        Versuchen Sie, Visual Studio Code neu zu starten, falls die Erweiterung nicht in der Installationsliste angezeigt wird.

      Derzeit können Sie sowohl die Erweiterungen „Verbrauch“ (mehrere Mandanten) als auch „Standard“ (einzelner Mandant) gleichzeitig installieren. Die Entwicklungserfahrungen unterscheiden sich in mancher Hinsicht voneinander, aber Ihr Azure-Abonnement kann die Logik-App-Typen „Standard“ und „Verbrauch“ enthalten. Visual Studio Code zeigt alle bereitgestellten Logik-Apps in Ihrem Azure-Abonnement an, organisiert Ihre Apps jedoch unter jeder Erweiterung, Azure Logic Apps (Verbrauch) und Azure Logic Apps (Standard) .

  • Installieren Sie die Node.js-Versionen 10.x.x, 11.x.x oder 12.x.x, um die „Inlinecodevorgänge“-Aktion mit Ausführung von JavaScript zu verwenden.

    Tipp

    Laden Sie für Windows die MSI-Version herunter. Falls Sie stattdessen die ZIP-Version nutzen, müssen Sie Node.js manuell verfügbar machen, indem Sie eine PATH-Umgebungsvariable für Ihr Betriebssystem verwenden.

  • Zum lokalen Ausführen von webhookbasierten Triggern und Aktionen wie des integrierten HTTP-Webhook-Triggers in Visual Studio Code müssen Sie die Weiterleitung für die Rückruf-URL einrichten.

  • Um den Beispielworkflow in diesem Artikel zu testen, benötigen Sie ein Tool, das Aufrufe an den vom Anforderungstrigger erstellten Endpunkt senden kann. Falls Sie nicht über ein solches Tool verfügen, können Sie die Postman-App herunterladen, installieren und verwenden.

  • Wenn Sie Ihre Logik-App-Ressourcen mit Einstellungen erstellen, die die Verwendung von Application Insights unterstützen, können Sie optional die Diagnoseprotokollierung und Ablaufverfolgung für Ihre Logik-App aktivieren. Dies ist entweder beim Erstellen der Logik-App oder nach der Bereitstellung möglich. Sie benötigen eine Application Insights-Instanz, können aber diese Ressource entweder im Voraus, beim Erstellen Ihrer Logik-App oder nach der Bereitstellung erstellen.

Einrichten von Visual Studio Code

  1. Um sicherzustellen, dass alle Erweiterungen ordnungsgemäß installiert sind, laden Sie Visual Studio Code neu, oder starten Sie es erneut.

  2. Vergewissern Sie sich, dass Visual Studio Code Erweiterungsupdates automatisch sucht und installiert, damit Ihre Erweiterungen die neuesten Updates erhalten. Andernfalls müssen Sie die veraltete Version manuell deinstallieren und die neueste Version installieren.

    1. Navigieren Sie im Menü Datei zu Voreinstellungen>Einstellungen.

    2. Wechseln Sie auf der Registerkarte Benutzer zu Features>Erweiterungen.

    3. Vergewissern Sie sich, dass Updates automatisch suchen und Automatische Aktualisierung ausgewählt sind.

Standardmäßig sind die folgenden Einstellungen für die Erweiterung „Azure Logic Apps (Standard)“ aktiviert und festgelegt:

  • Azure Logic Apps Standard: Projektlaufzeit, festgelegt auf Version ~3

    Hinweis

    Diese Version ist erforderlich, um die Aktionen in Inlinecodevorgängen verwenden zu können.

  • Azure Logic Apps Standard: Experimental View Manager: Hiermit wird der aktuelle Designer in Visual Studio Code aktiviert. Deaktivieren Sie diese Einstellung, falls für den Designer Probleme auftreten, z. B. beim Ziehen und Ablegen von Elementen.

Führen Sie die folgenden Schritte aus, um nach diesen Einstellungen zu suchen und sie zu bestätigen:

  1. Navigieren Sie im Menü Datei zu Voreinstellungen>Einstellungen.

  2. Wechseln Sie auf der Registerkarte Benutzer zu >Erweiterungen>Azure Logic Apps (Standard).

    Beispielsweise finden Sie hier die Einstellung Azure Logic Apps Standard: Projektlaufzeit und können über das Suchfeld nach anderen Einstellungen suchen:

    Screenshot that shows Visual Studio Code settings for

Herstellen einer Verbindung mit Ihrem Azure-Konto

  1. Wählen Sie auf der Aktivitätsleiste von Visual Studio Code das Azure-Symbol aus.

    Screenshot that shows Visual Studio Code Activity Bar and selected Azure icon.

  2. Wählen Sie im Azure-Bereich unter Azure: Logic Apps (Standard) die Option Bei Azure anmelden aus. Wenn die Authentifizierungsseite für Visual Studio Code angezeigt wird, melden Sie sich mit Ihrem Azure-Konto an.

    Screenshot that shows Azure pane and selected link for Azure sign in.

    Nachdem Sie sich angemeldet haben, werden im Azure-Bereich die Abonnements in Ihrem Azure-Konto angezeigt. Wenn Sie auch über die öffentlich herausgegebene Erweiterung verfügen, finden Sie alle Logik-Apps, die Sie mit dieser Erweiterung erstellt haben, im Abschnitt Logic Apps und nicht im Abschnitt Logic Apps (Standard) .

    Wenn die erwarteten Abonnements nicht angezeigt werden oder der Bereich nur bestimmte Abonnements anzeigen soll, führen Sie die folgenden Schritte aus:

    1. Bewegen Sie in der Liste „Abonnements“ den Zeiger neben das erste Abonnement, bis die Schaltfläche (Filtersymbol) Abonnements auswählen angezeigt wird. Wählen Sie das Filtersymbol aus.

      Screenshot that shows Azure pane and selected filter icon.

      Oder wählen Sie in der Statusleiste von Visual Studio Code Ihr Azure-Konto aus.

    2. Wenn eine weitere Abonnement liste angezeigt wird, wählen Sie die gewünschten Abonnements aus, und stellen Sie dann sicher, dass Sie OK auswählen.

Erstellen eines lokalen Projekts

Bevor Sie Ihre Logik-App erstellen können, erstellen Sie ein lokales Projekt, damit Sie Ihre Logik-App über Visual Studio Code verwalten, ausführen und bereitstellen können. Das zugrunde liegende Projekt ähnelt stark einem Azure Functions-Projekt, das auch als Funktions-App-Projekt bezeichnet wird. Diese Projekttypen sind jedoch voneinander getrennt, sodass Logik-Apps und Funktions-App nicht im selben Projekt vorhanden sein können.

  1. Erstellen Sie auf Ihrem Computer einen leeren lokalen Ordner, der für das Projekt verwendet werden soll, das Sie später in Visual Studio Code erstellen werden.

  2. Schließen Sie in Visual Studio Code alle offenen Ordner.

  3. Wählen Sie im Azure-Bereich neben Azure: Logic Apps (Standard) die Option Neues Projekt erstellen (Symbol mit Ordner und Blitz) aus.

    Screenshot that shows Azure pane toolbar with

  4. Wenn Sie von der Windows Defender Firewall aufgefordert werden, für Code.exe, wobei es sich um Visual Studio Code handelt, und für func.exe, wobei es sich um Azure Functions Core Tools handelt, Netzwerkzugriff zu gewähren, wählen Sie Private Netzwerke, z. B. Heim- oder Firmennetzwerk>Zugriff zulassen aus.

  5. Navigieren Sie zu dem Speicherort, an dem Sie Ihren Projektordner erstellt haben, wählen Sie diesen Ordner aus, und fahren Sie fort.

    Screenshot that shows

  6. Wählen Sie in der angezeigten Vorlagenliste entweder Zustandsbehafteter Workflow oder Zustandsloser Workflow aus. In diesem Beispiel wird Zustandsbehafteter Workflow ausgewählt.

    Screenshot that shows the workflow templates list with

  7. Geben Sie einen Namen für Ihren Workflow ein, und drücken Sie die EINGABETASTE. In diesem Beispiel wird Fabrikam-Stateful-Workflow als Name verwendet.

    Screenshot that shows the

    Hinweis

    Möglicherweise tritt ein Fehler namens azureLogicAppsStandard.createNewProject mit der Fehlermeldung Schreiben in die Arbeitsbereichseinstellungen nicht möglich, weil azureFunctions.suppressProject keine registrierte Konfiguration ist auf. Wenn Sie dies tun, versuchen Sie, die Azure Functions-Erweiterung für Visual Studio Code zu installieren, entweder direkt aus dem Visual Studio Marketplace oder aus Visual Studio Code.

    Visual Studio Code schließt die Erstellung des Projekts ab und öffnet die Datei workflow.json für Ihren Workflow im Code-Editor.

    Hinweis

    Wählen Sie in der Eingabeaufforderung zum Öffnen des Projekts die Option In aktuellem Fenster öffnen aus, wenn Sie Ihr Projekt im aktuellen Visual Studio Code-Fenster öffnen möchten. Wählen Sie In neuem Fenster öffnen aus, um eine neue Instanz für Visual Studio Code zu öffnen.

  8. Öffnen Sie in der Visual Studio-Symbolleiste den Explorer-Bereich, falls er nicht bereits geöffnet ist.

    Im Explorer-Bereich wird Ihr Projekt angezeigt, das nun automatisch generierte Projektdateien enthält. Beispielsweise verfügt das Projekt über einen Ordner, der den Namen Ihres Workflows trägt. In diesem Ordner enthält die workflow.json-Datei die zugrunde liegende JSON-Definition Ihres Workflows.

    Screenshot that shows the Explorer pane with project folder, workflow folder, and

    In Visual Studio Code verfügt Ihr Logik-App-Projekt über einen der folgenden Typen:

    • Erweiterungs-Bundle-basiert (Node.js), was der Standardtyp ist
    • NuGet-paketbasiertes (.NET), das Sie vom Standardtyp konvertieren können

    Basierend auf diesen Typen enthält Ihr Projekt leicht unterschiedliche Ordner und Dateien. Ein NuGet-basiertes Projekt enthält einen .bin-Ordner, der Pakete und andere Bibliotheksdateien enthält. Ein Bundle-basiertes Projekt enthält nicht den .bin Ordner und andere Dateien. Einige Szenarien erfordern ein NuGet-basiertes Projekt, damit Ihre App ausgeführt werden kann, z. B. wenn Sie benutzerdefinierte integrierte Vorgänge entwickeln und ausführen möchten. Weitere Informationen zum Konvertieren Ihres Projekts zur Verwendung von NuGet finden Sie unter Aktivieren der Erstellung Connector-Entwicklung.

    Für das standardmäßige Bundle-basierte Projekt verfügt Ihr Projekt über eine Ordner- und Dateistruktur, die dem folgenden Beispiel ähnelt:

    MyBundleBasedLogicAppProjectName
    | .vscode
    | Artifacts
      || Maps 
         ||| MapName1
         ||| ...
      || Schemas
         ||| SchemaName1
         ||| ...
    | WorkflowName1
      || workflow.json
      || ...
    | WorkflowName2
      || workflow.json
      || ...
    | workflow-designtime
    | .funcignore
    | connections.json
    | host.json
    | local.settings.json
    

    Auf der Stammebene Ihres Projekts finden Sie die folgenden Dateien und Ordner mit anderen Elementen:

    Name Ordner oder Datei Beschreibung
    .vscode Ordner Enthält auf Visual Studio Code-bezogene Einstellungsdateien, z. B. extensions.json, launch.json, settings.json und tasks.json.
    Artefakte Ordner Enthält Integrationskontoartefakte, die Sie definieren und in Workflows verwenden, die Business-to-Business-Szenarien (B2B-Szenarien) unterstützen. Die Beispielstruktur enthält beispielsweise Zuordnungen und Schemas für XML-Transformations- und -Validierungsvorgänge.
    <WorkflowName> Ordner Für jeden Workflow enthält der <WorkflowName>-Ordner eine workflow.json-Datei, die die zugrunde liegende JSON-Definition dieses Workflows enthält.
    workflow-designtime Ordner Enthält Entwicklungsumgebungsbezogene Einstellungsdateien.
    .funcignore File Enthält Informationen zu Ihren installierten Azure Functions Core Tools.
    connections.json File Enthält die Metadaten, Endpunkte und Schlüssel für alle verwalteten Verbindungen und Azure-Funktionen, die von Ihren Workflows verwendet werden.

    Wichtiger Hinweis: Um unterschiedliche Verbindungen und Funktionen in jeder Umgebung zu verwenden, stellen Sie sicher, dass Sie die Datei connections.json parametrisieren und die Endpunkte aktualisieren.

    host.json File Enthält laufzeitspezifische Konfigurationseinstellungen und -werte, z. B. die Standardgrenzwerte für die Azure Logic Apps-Einzelmandanten-Plattform, Logik-Apps, Workflows, Auslöser und Aktionen. Auf der Stammebene Ihres Logik-App-Projekts enthält die host.json Metadatendatei die Konfigurationseinstellungen und Standardwerte, die alle Workflows in derselben Logik-App während der Ausführung verwenden, ob lokal oder in Azure.

    Hinweis: Wenn Sie Ihre Logik-App erstellen, erstellt Visual Studio Code eine host.snapshot.*.json-Sicherungsdatei in Ihrem Speichercontainer. Wenn Sie Ihre Logik-App löschen, wird diese Sicherungsdatei nicht gelöscht. Wenn Sie eine weitere Logik-App mit dem gleichen Namen erstellen, wird eine weitere Momentaufnahmedatei erstellt. Sie können nur bis zu 10 Momentaufnahmen für dieselbe Logik-App erstellen. Wenn Sie diesen Grenzwert überschreiten, erhalten Sie den folgenden Fehler:

    Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))

    Um diesen Fehler zu beheben, löschen Sie die zusätzlichen Momentaufnahmedateien aus Ihrem Speichercontainer.

    local.settings.json File Enthält App-Einstellungen, Verbindungszeichenfolgen und andere Einstellungen, die Ihre Workflows bei der lokalen Ausführung verwenden. Anders ausgedrückt, geltend diese Einstellungen und Werte nur, wenn Sie Ihre Projekte in Ihrer lokalen Entwicklungsumgebung ausführen. Während der Bereitstellung in Azure werden die Datei und die Einstellungen ignoriert und nicht in Ihre Bereitstellung einbezogen.

    Diese Datei speichert Einstellungen und Werte als lokale Umgebungsvariablen, die von Ihren lokalen Bereitstellungstools als appSettings-Werte verwendet werden. Sie können diese Umgebungsvariablen sowohl zur Laufzeit als auch zur Bereitstellungszeit aufrufen und beziehen, indem Sie App-Einstellungen und Parameter verwenden.

    Wichtiger Hinweis: Die Datei local.settings.json kann Geheimnisse enthalten. Stellen Sie daher sicher, dass Sie diese Datei auch aus der Quellcodeverwaltung Ihres Projekts ausschließen.

Aktivieren der Erstellung integrierter Connectors

Sie können Ihre eigenen integrierten Connectors für jeden benötigten Dienst erstellen, indem Sie das Erweiterbarkeitsframework für Azure Logic Apps-Instanzen mit einem Mandanten verwenden. Ähnlich wie integrierte Connectors wie Azure Service Bus und SQL Server bieten diese Connectors einen höheren Durchsatz, niedrige Wartezeiten, lokale Konnektivität und werden nativ im selben Prozess wie die Azure Logic Apps-Runtime mit einzelnem Mandanten ausgeführt.

Die Erstellungsfunktion ist derzeit nur in Visual Studio Code verfügbar, aber nicht standardmäßig aktiviert. Um diese Connectors zu erstellen, müssen Sie zuerst Ihr Projekt von erweiterungspaketbasiert (Node.js) in NuGet-Paketbasiert (.NET) konvertieren.

Wichtig

Diese Aktion ist ein unidirektionaler Vorgang, der nicht rückgängig gemacht werden kann.

  1. Bewegen Sie im Bereich „Explorer“ im Stammverzeichnis Ihres Projekts den Mauszeiger über einen beliebigen leeren Bereich unterhalb aller anderen Dateien und Ordner, öffnen Sie das Kontextmenü, und wählen Sie In Nuget-basiertes Logik-App-Projekt konvertieren aus.

    Screenshot that shows that shows Explorer pane with the project's shortcut menu opened from a blank area in the project window.

  2. Wenn die Eingabeaufforderung angezeigt wird, bestätigen Sie die Projektkonvertierung.

  3. Um den Vorgang fortzusetzen, überprüfen und befolgen Sie die Schritte im Artikel Azure Logic Apps läuft überall: Erweiterbarkeit integrierter Connectors.

Öffnen der Workflowdefinitionsdatei im Designer

  1. Überprüfen Sie die auf Ihrem Computer installierten Versionen mit folgendem Befehl:

    ..\Users\{yourUserName}\dotnet --list-sdks

    Wenn Sie über .NET Core SDK 5.x verfügen, kann diese Version Sie möglicherweise daran hindern, die zugrunde liegende Workflowdefinition der Logik-App im Designer zu öffnen. Anstatt diese Version zu deinstallieren, erstellen Sie im Stammordner Ihres Projekts die Datei global.json, mit der auf Ihre .NET Core Runtime 3.x-Version verwiesen wird, die höher als 3.1.201 ist. Beispiel:

    {
       "sdk": {
          "version": "3.1.8",
          "rollForward": "disable"
       }
    }
    

    Wichtig

    Stellen Sie sicher, dass Sie die Datei global.json in Visual Studio Code im Stammordner Ihres Projekts explizit hinzufügen. Andernfalls wird der Designer nicht geöffnet.

  2. Erweitern Sie den Projektordner für Ihren Workflow. Öffnen Sie das Kontextmenü der Datei workflow.json, und wählen Sie Im Designer öffnen aus.

    Screenshot that shows Explorer pane and shortcut window for the workflow.json file with

  3. Wählen Sie in der Liste Enable connectors in Azure (Connectors in Azure aktivieren) die Option Use connectors from Azure (Connectors aus Azure verwenden) aus, die für alle verwalteten Connectors gilt, die im Azure-Portal verfügbar sind, nicht nur für Connectors für Azure-Dienste.

    Screenshot that shows Explorer pane with

    Hinweis

    Zustandslose Workflows unterstützen derzeit nur Aktionen für in Azure bereitgestellte verwaltete Connectors, keine Aktionen für Trigger. Obwohl Sie die Möglichkeit haben, Connectors in Azure für zustandslose Workflows zu aktivieren, zeigt der Designer keine verwalteten Connectortrigger an, die Sie auswählen können.

  4. Wählen Sie in der Liste Abonnement auswählen das Azure-Abonnement aus, das für Ihr Logik-App-Projekt verwendet werden soll.

    Screenshot that shows Explorer pane with the

  5. Wählen Sie in der Liste der Ressourcengruppen Neue Ressourcengruppe erstellen aus.

    Screenshot that shows Explorer pane with resource groups list and

  6. Geben Sie einen Namen für die Ressourcengruppe an, und drücken Sie die EINGABETASTE. In diesem Beispiel wird Fabrikam-Workflows-RG verwendet.

    Screenshot that shows Explorer pane and resource group name box.

  7. Wählen Sie in der Liste der Speicherorte die Azure-Region aus, die für die Erstellung Ihrer Ressourcengruppe und Ressourcen verwendet werden soll. In diesem Beispiel wird USA, Westen-Mitte verwendet.

    Screenshot that shows Explorer pane with locations list and

    Nachdem Sie diesen Schritt ausgeführt haben, öffnet Visual Studio Code den Workflow-Designer.

    Hinweis

    Wenn Visual Studio Code die Workflow-Entwurfszeit-API startet, wird ggf. eine Meldung angezeigt, dass der Startvorgang einige Sekunden dauern kann. Sie können diese Meldung ignorieren oder OK auswählen.

    Falls der Designer nicht geöffnet wird, helfen Ihnen die Informationen im Abschnitt Designer wird nicht geöffnet bei der Problembehandlung weiter.

    Sobald der Designer angezeigt wird, wird die Eingabeaufforderung Vorgang auswählen im Designer standardmäßig ausgewählt angezeigt, wodurch der Bereich Aktion hinzufügen angezeigt wird.

    Screenshot that shows the workflow designer.

  8. Als Nächstes fügen Sie Ihrem Workflow einen Trigger und Aktionen hinzu.

Hinzufügen eines Triggers und von Aktionen

Nachdem Sie den Designer geöffnet haben, wird die Eingabeaufforderung Vorgang auswählen im Designer standardmäßig ausgewählt angezeigt. Sie können nun mit dem Erstellen Ihres Workflows beginnen, indem Sie einen Trigger und Aktionen hinzufügen.

Der Workflow in diesem Beispiel verwendet diesen Triggern und die folgenden Aktionen:

  • Den integrierten Anforderungstrigger, Beim Empfang einer HTTP-Anforderung, der eingehende Aufrufe oder Anforderungen empfängt und einen Endpunkt erstellt, der von anderen Diensten oder Logik-Apps aufgerufen werden kann.

  • Die Office 365 Outlook-Aktion: E-Mail senden.

  • Die integrierte Antwortaktion, mit der Sie eine Antwort gesendet und Daten an den Aufrufer zurückgegeben haben.

Hinzufügen des Anforderungstriggers

  1. Vergewissern Sie sich neben dem Designer im Bereich Trigger hinzufügen unter dem Suchfeld Vorgang auswählen, dass Integriert ausgewählt ist, damit Sie einen Trigger auswählen können, der nativ ausgeführt wird.

  2. Geben Sie in das Suchfeld Vorgang auswählen die Zeichenfolge when a http request ein, und wählen Sie den integrierten Anforderungstrigger namens Beim Empfang einer HTTP-Anforderung aus.

    Screenshot that shows the workflow designer and Add a trigger pane with

    Wenn der Trigger im Designer angezeigt wird, wird der Detailbereich des Triggers geöffnet, um die Eigenschaften, Einstellungen und anderen Aktionen des Triggers anzuzeigen.

    Screenshot that shows the workflow designer with the

    Tipp

    Wenn der Detailbereich nicht angezeigt wird, stellen Sie sicher, dass der Trigger im Designer ausgewählt ist.

  3. Wenn Sie ein Element aus dem Designer löschen müssen, führen Sie diese Schritte aus.

Hinzufügen der Office 365 Outlook-Aktion

  1. Wählen Sie im Designer unter dem hinzugefügten Trigger das Pluszeichen (+) > Aktion hinzufügen aus.

    Die Eingabeaufforderung Vorgang auswählen wird im Designer angezeigt, und der Bereich Aktion hinzufügen wird erneut geöffnet, sodass Sie die nächste Aktion auswählen können.

  2. Wählen Sie im Bereich Aktion hinzufügen unter dem Suchfeld Vorgang auswählen die Zeichenfolge Azure aus, damit Sie eine Aktion für einen verwalteten Connector auswählen können, der in Azure bereitgestellt ist.

    In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden (V2) ausgewählt und verwendet.

    Screenshot that shows the workflow designer and Add an action pane with Office 365 Outlook

  3. Wählen Sie im Detailbereich der Aktion Anmelden aus, damit Sie eine Verbindung mit Ihrem E-Mail-Konto herstellen können.

    Screenshot that shows the workflow designer and Send an email (V2) pane with

  4. Wenn Visual Studio Code Sie zur Zustimmung für den Zugriff auf Ihr E-Mail-Konto auffordert, wählen Sie Öffnen aus.

    Screenshot that shows the Visual Studio Code prompt to permit access.

    Tipp

    Um zukünftige Aufforderungen zu vermeiden, wählen Sie Vertrauenswürdige Domänen konfigurieren aus, damit Sie die Authentifizierungsseite als vertrauenswürdige Domäne hinzufügen können.

  5. Befolgen Sie die nachfolgenden Aufforderungen, um sich anzumelden, den Zugriff zuzulassen und die Rückkehr zu Visual Studio Code zuzulassen.

    Hinweis

    Wenn zu viel Zeit verstrichen ist, bevor Sie die Eingabeaufforderungen erfüllt haben, kommt es beim Authentifizierungsprozess zum Timeout, und er schlägt fehl. Kehren Sie in diesem Fall zum Designer zurück, und wiederholen Sie die Anmeldung, um die Verbindung zu erstellen.

  6. Wenn die Erweiterung „Azure Logic Apps (Standard)“ Sie zur Zustimmung für den Zugriff auf Ihr E-Mail-Konto auffordert, wählen Sie Öffnen aus. Befolgen Sie die nachfolgende Aufforderung, um den Zugriff zuzulassen.

    Screenshot that shows the extension prompt to permit access.

    Tipp

    Um zukünftige Eingabeaufforderungen zu vermeiden, wählen Sie Für diese Erweiterung nicht mehr nachfragen aus.

    Nachdem Visual Studio Code die Verbindung erstellt hat, zeigen einige Connectors die Meldung The connection will be valid for {n} days only an. Dieses Zeitlimit gilt nur für die Dauer der Erstellung Ihrer Logik-App in Visual Studio Code. Nach der Bereitstellung gilt dieses Limit nicht mehr, da sich Ihre Logik-App zur Laufzeit mittels der automatisch aktivierten vom System zugewiesenen verwalteten Identität authentifizieren kann. Diese verwaltete Identität unterscheidet sich von den Anmeldeinformationen für die Authentifizierung oder der Verbindungszeichenfolge, die Sie verwenden, wenn Sie eine Verbindung herstellen. Wenn Sie diese vom System zugewiesene verwaltete Identität deaktivieren, funktionieren Verbindungen zur Laufzeit nicht.

  7. Wenn die Aktion E-Mail senden im Designer nicht ausgewählt angezeigt wird, wählen Sie diese Aktion aus.

  8. Geben Sie im Detailbereich der Aktion auf der Registerkarte Parameter die erforderlichen Informationen für die Aktion an, z. B.:

    Screenshot that shows the workflow designer with details for Office 365 Outlook

    Eigenschaft Erforderlich Wert BESCHREIBUNG
    An Ja <Ihre E-Mail-Adresse> Der E-Mail-Empfänger, bei dem es sich um Ihre E-Mail-Adresse zu Testzwecken handeln kann. In diesem Beispiel wird die fiktive E-Mail-Adresse sophiaowen@fabrikam.com verwendet.
    Subject Ja An email from your example workflow der E-Mail-Betreff
    Text Ja Hello from your example workflow! Der Textinhalt der E-Mail

    Hinweis

    Wenn Sie Änderungen im Detailbereich auf der Registerkarte Einstellungen, Statisches Ergebnis oder Ausführen nach vornehmen möchten, stellen Sie sicher, dass Sie Fertig ausgewählt haben, um die Änderungen zu übernehmen, bevor Sie zwischen Registerkarten wechseln oder den Fokus innerhalb des Designers verschieben. Andernfalls behält Visual Studio Code Ihre Änderungen nicht.

  9. Wählen Sie im Designer Speichern aus.

Wichtig

Zum lokalen Ausführen eines Workflows, der einen webhookbasierten Trigger oder Aktionen verwendet, wie z. B. den integrierten Trigger oder eine Aktion des HTTP-Webhooks, müssen Sie diese Funktion aktivieren, indem Sie die Weiterleitung für die Rückruf-URL des Webhooks einrichten.

Aktivieren von lokal ausgeführten Webhooks

Wenn Sie einen webhookbasierten Trigger oder eine Aktion wie z. B. HTTP-Webhook verwenden und eine Logik-App in Azure ausgeführt wird, abonniert die Logic Apps-Runtime den Dienstendpunkt, indem eine Rückruf-URL mit diesem Endpunkt erzeugt und registriert wird. Der Trigger oder die Aktion wartet dann darauf, dass der Dienstendpunkt die URL aufruft. Wenn Sie jedoch in Visual Studio Code arbeiten, beginnt die generierte Rückruf-URL mit http://localhost:7071/.... Diese URL gilt für den Localhost-Server, der privat ist, sodass der Dienstendpunkt diese URL nicht aufrufen kann.

Zum lokalen Ausführen von webhookbasierten Triggern und Aktionen in Visual Studio Code müssen Sie eine öffentliche URL einrichten, die den Localhost-Server verfügbar macht und Aufrufe vom Dienstendpunkt sicher an die Webhookrückruf-URL weiterleitet. Sie können einen Weiterleitungsdienst und ein Tool wie ngrok verwenden, mit dem ein HTTP-Tunnel für den Localhost-Port geöffnet wird, oder Ihr eigenes äquivalentes Tool verwenden.

Einrichten der Aufrufweiterleitung mit ngrok

  1. Registrieren Sie sich für ein ngrok-Konto, wenn Sie keines besitzen. Andernfalls melden Sie sich bei Ihrem Konto an.

  2. Rufen Sie Ihr persönliches Authentifizierungstoken ab, das Ihr ngrok-Client benötigt, um eine Verbindung mit Ihrem Konto herzustellen und den Zugriff zu authentifizieren.

    1. Um Ihre Authentifizierungstokenseite zu finden, erweitern Sie in Ihrem Kontodashboardmenü die Option Authentifizierung, und wählen Sie Ihr Authentifizierungstoken aus.

    2. Kopieren Sie das Token aus dem Feld Ihr Authentifizierungstoken an einen sicheren Speicherort.

  3. Laden Sie von der ngrok-Downloadseite oder Ihrem Kontodashboard die gewünschte ngrok-Version herunter, und extrahieren Sie die ZIP-Datei. Weitere Informationen finden Sie unter Schritt 1: Unzip to install (Zum Installieren entzippen).

  4. Öffnen Sie auf Ihrem Computer das Eingabeaufforderungstool. Wechseln Sie zu dem Speicherort, wo sich die Datei ngrok.exe befindet.

  5. Stellen Sie eine Verbindung des ngrok-Clients mit Ihrem ngrok-Konto her, indem Sie den folgenden Befehl ausführen. Weitere Informationen finden Sie unter Schritt 2: Connect your account (Stellen Sie eine Verbindung mit Ihrem Konto her).

    ngrok authtoken <your_auth_token>

  6. Öffnen Sie den HTTP-Tunnel zum Localhost-Port 7071, indem Sie den folgenden Befehl ausführen. Weitere Informationen finden Sie unter Schritt 3: Fire it up (Starten Sie es).

    ngrok http 7071

  7. In der Ausgabe finden Sie folgende Zeile:

    http://<domain>.ngrok.io -> http://localhost:7071

  8. Kopieren und speichern Sie die URL mit dem folgenden Format: http://<domain>.ngrok.io

Einrichten der Weiterleitungs-URL in ihren App-Einstellungen

  1. Fügen Sie in Visual Studio Code im Designer als Trigger bzw. Aktion HTTP + Webhook hinzu.

  2. Geben Sie die zuvor erstellte Weiterleitungs-URL (Umleitung) ein, wenn die Eingabeaufforderung für den Hostendpunkt-Speicherort angezeigt wird.

    Hinweis

    Wenn Sie die Eingabeaufforderung ignorieren, wird eine Warnung mit dem Hinweis angezeigt, dass Sie die Weiterleitungs-URL angeben müssen. Wählen Sie daher die Option Konfigurieren aus, und geben Sie die URL ein. Nachdem Sie diesen Schritt ausgeführt haben, wird die Eingabeaufforderung für nachfolgende Webhook-Trigger oder -Aktionen, die Sie ggf. hinzufügen, nicht mehr angezeigt.

    Gehen Sie wie folgt vor, wenn die Eingabeaufforderung auf der Stammebene Ihres Projekts wieder angezeigt werden soll: Öffnen Sie das Kontextmenü der Datei local.settings.json, und wählen Sie die Option Configure Webhook Redirect Endpoint (Endpunkt für Webhookumleitung konfigurieren) aus. Die Eingabeaufforderung wird angezeigt, damit Sie die Weiterleitungs-URL angeben können.

    In Visual Studio Code wird die Weiterleitungs-URL im Stammordner Ihres Projekts der Datei local.settings.json hinzugefügt. Im Objekt Values wird jetzt die Eigenschaft mit dem Namen Workflows.WebhookRedirectHostUri angezeigt und auf die Weiterleitungs-URL festgelegt. Beispiel:

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
          <...>
          "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
          <...>
       }
    }
    

Wenn Sie zum ersten Mal eine lokale Debugsitzung starten oder den Workflow ohne Debuggen ausführen, registriert die Logic Apps-Runtime den Workflow beim Dienstendpunkt und abonniert diesen Endpunkt, um die Benachrichtigung über Webhookvorgänge zu ermöglichen. Wenn Sie den Workflow das nächste Mal ausführen, wird die Runtime nicht registriert oder erneut abonniert, weil die Abonnementregistrierung bereits im lokalen Speicher vorhanden ist.

Wenn Sie die Debugsitzung für eine Workflowausführung beenden, die lokal ausgeführte webhookbasierte Trigger oder Aktionen verwendet, werden die vorhandenen Abonnementregistrierungen nicht gelöscht. Wenn Sie die Registrierung aufheben möchten, müssen Sie die Abonnementregistrierungen manuell entfernen oder löschen.

Hinweis

Nachdem der Workflow gestartet wurde, werden im Terminalfenster möglicherweise Fehler wie in diesem Beispiel angezeigt:

message='Http request failed with unhandled exception of type 'InvalidOperationException' and message: 'System.InvalidOperationException: Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.

Öffnen Sie in diesem Fall die Datei local.settings.json im Stammordner des Projekts, und stellen Sie sicher, dass die Eigenschaft auf true festgelegt ist:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Verwalten von Haltepunkten zum Debuggen

Bevor Sie Ihren Logik-App-Workflow ausführen und testen, indem Sie eine Debugsitzung starten, können Sie in der Datei workflow.json für jeden Workflow Haltepunkte festlegen. Es ist kein anderes Setup erforderlich.

Haltepunkte werden derzeit jedoch nur für Aktionen unterstützt, nicht für Trigger. Jede Aktionsdefinition enthält diese Haltepunktpositionen:

  • Legen Sie den Starthaltepunkt in der Zeile fest, die den Namen der Aktion enthält. Wenn dieser Haltepunkt während der Debugsitzung erreicht wird, können Sie die Eingaben der Aktion überprüfen, bevor sie ausgewertet werden.

  • Legen Sie den Endhaltepunkt in der Zeile fest, die die schließende geschweifte Klammer ( } ) der Aktion enthält. Wenn dieser Haltepunkt während der Debugsitzung erreicht wird, können Sie die Ergebnisse der Aktion überprüfen, bevor die Ausführung der Aktion endet.

Um einen Haltepunkt hinzuzufügen, führen Sie diese Schritte aus:

  1. Öffnen Sie die Datei workflow.json für den Workflow, den Sie debuggen möchten.

  2. Wählen Sie in der Zeile, in der Sie den Haltepunkt festlegen möchten, das Innere der linken Spalte aus. Um den Haltepunkt zu entfernen, wählen Sie den Haltepunkt aus.

    Wenn Sie die Debugsitzung starten, wird die Ausführungsansicht auf der linken Seite des Codefensters angezeigt, während die Debugsymbolleiste im oberen Bereich angezeigt wird.

    Hinweis

    Wenn die Ausführungsansicht nicht automatisch angezeigt wird, drücken Sie STRG+UMSCHALT+D.

  3. Um die verfügbaren Informationen zu überprüfen, wenn ein Haltepunkt erreicht wird, untersuchen Sie in der Ausführungsansicht den Bereich Variablen.

  4. Um die Workflowausführung fortzusetzen, wählen Sie auf der Symbolleiste „Debuggen“ Fortsetzen (Wiedergabeschaltfläche) aus.

Während der Workflowausführung können Sie jederzeit Haltepunkte hinzufügen und entfernen. Wenn Sie jedoch die workflow.json-Datei nach dem Start der Ausführung aktualisieren, werden Haltepunkte nicht automatisch aktualisiert. Um die Haltepunkte zu aktualisieren, starten Sie die Logik-App neu.

Allgemeine Informationen finden Sie unter Breakpoints – Visual Studio Code (Haltepunkte – Visual Studio Code).

Lokales Ausführen, Testen und Debuggen

Um Ihre Logik-App zu testen, führen Sie die folgenden Schritte aus, um eine Debugsitzung zu starten und die URL für den Endpunkt zu finden, der durch den Anforderungstrigger erstellt wird. Sie benötigen diese URL, damit Sie später eine Anforderung an diesen Endpunkt senden können.

  1. Damit Sie einen zustandslosen Workflow leichter debuggen können, können Sie den Ausführungsverlauf für diesen Workflow aktivieren.

  2. Öffnen Sie auf der Aktivitätsleiste von Visual Studio Code das Menü Ausführen, und wählen Sie Debuggen starten (F5) aus.

    Das Terminalfenster wird geöffnet, sodass Sie die Debugsitzung überprüfen können.

    Hinweis

    Wenn Sie einen Fehler wie Fehler nach der Ausführung von preLaunchTask „generateDebugSymbols“ erhalten, helfen Ihnen die Informationen im Abschnitt Debugsitzung wird nicht gestartet bei der Problembehandlung weiter.

  3. Suchen Sie nun die Rückruf-URL für den Endpunkt im Anforderungstrigger.

    1. Öffnen Sie den Explorer-Bereich erneut, damit Sie Ihr Projekt anzeigen können.

    2. Wählen Sie im Kontextmenü der Datei workflow.json die Option Übersicht aus.

      Screenshot that shows the Explorer pane and shortcut window for the workflow.json file with

    3. Suchen Sie den Wert Rückruf-URL, der dieser URL für den Anforderungsbeispieltrigger ähnelt:

      http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>

      Screenshot that shows your workflow's overview page with callback URL

  4. Um die Rückruf-URL zu testen, indem Sie den Logik-App-Workflow auslösen, öffnen Sie Postman oder Ihr bevorzugtes Tool zum Erstellen und Senden von Anforderungen.

    Dieses Beispiel wird mit Postman fortgesetzt. Weitere Informationen finden Sie unter Erste Schritte mit Postman.

    1. Wählen Sie auf der Postman-Symbolleiste Neu aus.

      Screenshot that shows Postman with New button selected

    2. Wählen Sie im Bereich Neu erstellen unter Bausteine die Option Anforderung aus.

    3. Geben Sie im Fenster Anforderung speichern unter Anforderungsname einen Namen für die Anforderung an, z. B. Test workflow trigger.

    4. Wählen Sie unter Sammlung oder Ordner als Speicherziel auswählen den Eintrag Sammlung erstellen aus.

    5. Geben Sie unter Alle Sammlungen einen Namen für die zu erstellende Sammlung an, um Ihre Anforderungen zu organisieren, und wählen Sie Speichern< unter Sammlungs-Name> aus. In diesem Beispiel wird Logic Apps requests als Name der Sammlung verwendet.

      In Postman wird der Anforderungsbereich geöffnet, sodass Sie eine Anforderung an die Rückruf-URL für den Anforderungstrigger senden können.

      Screenshot that shows Postman with the opened request pane

    6. Kehren Sie zu Visual Studio Code zurück. Kopieren Sie von der Übersichtsseite des Workflows den Eigenschaftswert Rückruf-URL.

    7. Kehren Sie zu Postman zurück. Fügen Sie im Anforderungsbereich neben der Liste der Methoden, in der derzeit GET als Standardanforderungsmethode angezeigt wird, die zuvor kopierte Rückruf-URL in das Feld „Adresse“ ein, und wählen Sie Senden aus.

      Screenshot that shows Postman and callback URL in the address box with Send button selected

      Der Logik-App-Beispielworkflow sendet eine E-Mail, die in etwa wie im folgenden Beispiel aussieht:

      Screenshot that shows Outlook email as described in the example

  5. Kehren Sie in Visual Studio Code zur Übersichtsseite Ihres Workflows zurück.

    Wenn Sie einen zustandsbehafteten Workflow erstellt haben, werden auf der Übersichtsseite der Ausführungsstatus und -verlauf des Workflows angezeigt, nachdem die von Ihnen gesendete Anforderung den Workflow ausgelöst hat.

    Tipp

    Wenn der Ausführungsstatus nicht angezeigt wird, aktualisieren Sie die Übersichtsseite, indem Sie Aktualisieren auswählen. Für Trigger, die aufgrund von nicht erfüllten Kriterien oder nicht gefundenen Daten ausgelassen werden, erfolgt keine Ausführung.

    Screenshot that shows the workflow's overview page with run status and history

    In der folgenden Tabelle sind die möglichen endgültigen Status dargestellt, die jede Workflowausführung in Visual Studio Code annehmen und anzeigen kann:

    Ausführungsstatus Beschreibung
    Aborted Die Ausführung wurde aufgrund externer Probleme beendet oder nicht abgeschlossen (beispielsweise wegen eines Systemausfalls oder abgelaufenen Azure-Abonnements).
    Abgebrochen Die Ausführung wurde ausgelöst und gestartet, es wurde jedoch eine Abbruchanforderung empfangen.
    Fehler Mindestens eine Aktion in der Ausführung war nicht erfolgreich. Es wurden keine nachfolgenden Aktionen im Workflow eingerichtet, um den Fehler zu behandeln.
    Wird ausgeführt Die Ausführung wurde ausgelöst und wird gerade ausgeführt. Dieser Status kann jedoch auch für eine Ausführung angezeigt werden, die aufgrund von Aktionslimits oder aufgrund des aktuellen Tarifs gedrosselt wird.

    Tipp: Wenn Sie die Diagnoseprotokollierung einrichten, erhalten Sie Informationen zu ggf. aufgetretenen Drosselungsereignissen.

    Erfolgreich Die Ausführung war erfolgreich. Sollte bei einer Aktion ein Fehler aufgetreten sein, wurde dieser Fehler von einer nachfolgenden Aktion im Workflow behandelt.
    Timeout Bei der Ausführung ist ein Timeout aufgetreten, da die aktuelle Dauer die maximal zulässige Ausführungsdauer überschritten hat, die durch die Einstellung Aufbewahrung des Ausführungsverlaufs in Tagen gesteuert wird. Die Dauer einer Ausführung wird anhand der Startzeit der Ausführung und der maximalen Ausführungsdauer zu dieser Startzeit berechnet.

    Hinweis: Wenn die Ausführungsdauer auch das aktuelle Aufbewahrungslimit im Ausführungsverlauf übersteigt, das ebenfalls durch die Einstellung Aufbewahrung des Ausführungsverlaufs in Tagen gesteuert wird, wird die Ausführung durch einen täglichen Bereinigungsauftrag aus dem Ausführungsverlauf gelöscht. Der Aufbewahrungszeitraum wird immer auf der Grundlage der Startzeit der Ausführung und des aktuellen Aufbewahrungslimits berechnet – unabhängig davon, ob bei der Ausführung ein Timeout auftritt oder ob die Ausführung abgeschlossen wird. Wenn Sie also die maximale Dauer einer aktiven Ausführung verringern, tritt ein Timeout für die Ausführung auf. Ob die Ausführung im Ausführungsverlauf verbleibt oder daraus entfernt wird, hängt davon ab, ob die Ausführungsdauer das Aufbewahrungslimit übersteigt.

    Wartet Die Ausführung wurde nicht gestartet oder wurde angehalten, z. B. aufgrund einer früheren Workflowinstanz, die noch ausgeführt wird.
  6. Wählen Sie zum Überprüfen der Statuswerte für jeden Schritt in einer bestimmten Ausführung sowie der Eingaben und Ausgaben des Schritts die Schaltfläche mit den Auslassungspunkten ( ... ) für diese Ausführung aus, und wählen Sie Ausführung anzeigen aus.

    Screenshot that shows your workflow's run history row with ellipses button and

    Visual Studio Code öffnet die Überwachungsansicht und zeigt den Status der einzelnen Ausführungsschritte an.

    Screenshot that shows each step in the workflow run and their status

    Hinweis

    Wenn bei einer Ausführung ein Schritt in der Überwachungsansicht den Fehler 400 Bad Request anzeigt, wird das Problem möglicherweise durch einen längeren Trigger- oder Aktionsnamen verursacht, der dazu führt, dass der zugrunde liegende URI (Uniform Resource Identifier) das Standardzeichenlimit überschreitet. Weitere Informationen finden Sie unter „400 – Ungültige Anforderung“.

    In der folgenden Tabelle sind die möglichen Status dargestellt, die jede Workflowaktion in Visual Studio Code annehmen und anzeigen kann:

    Status einer Aktion Beschreibung
    Aborted Die Aktion wurde aufgrund externer Probleme beendet oder nicht fertig gestellt, z. B. wegen eines Systemausfalls oder abgelaufenen Azure-Abonnements.
    Abgebrochen Die Aktion wurde ausgeführt, aber es wurde eine Abbruchanforderung empfangen.
    Fehlgeschlagen Die Aktion ist fehlgeschlagen.
    Wird ausgeführt Die Aktion wird zurzeit ausgeführt.
    Übersprungen Die Aktion wurde übersprungen, weil die unmittelbar vorhergehende Aktion fehlgeschlagen ist. Eine Aktion weist eine runAfter-Bedingung auf, die erfordert, dass die vorherige Aktion erfolgreich abgeschlossen wurde, bevor die aktuelle Aktion ausgeführt werden kann.
    Erfolgreich Die Aktion war erfolgreich.
    Erfolgreich mit Wiederholungen Die Aktion war erfolgreich, jedoch erst nach mindestens einem Wiederholungsversuch. Wählen Sie diese Aktion zum Überprüfen des Wiederholungsverlaufs in der Detailansicht des Ausführungsverlaufs aus, damit Sie die Ein- und Ausgaben anzeigen können.
    Timeout Die Aktion wurde aufgrund des Timeoutlimits beendet, das durch die Einstellungen dieser Aktion gesteuert wird.
    Wartet Gilt für eine Webhookaktion, die auf eine eingehende Anforderung eines Aufrufers wartet.
  7. Wählen Sie zum Überprüfen der Ein- und Ausgaben für die einzelnen Schritte den Schritt aus, den Sie untersuchen möchten.

    Screenshot that shows the status for each step in the workflow plus the inputs and outputs in the expanded

  8. Um die unformatierten Ein- und Ausgaben für diesen Schritt weiter zu überprüfen, wählen Sie Unformatierte Eingaben anzeigen oder Unformatierte Ausgaben anzeigen aus.

  9. Um die Debugsitzung zu beenden, wählen Sie im menü Ausführen den Eintrag Debuggen beenden (UMSCHALT+F5) aus.

Zurückgeben einer Antwort

Um eine Antwort an den Aufrufer zurückzugeben, der eine Anforderung an Ihre Logik-App gesendet hat, können Sie die integrierte Antwortaktion für einen Workflow verwenden, der mit dem Anforderungstrigger gestartet wird.

  1. Wählen Sie im Workflow-Designer unter der Aktion E-Mail senden das Pluszeichen (+)>Aktion hinzufügen aus.

    Die Eingabeaufforderung Vorgang auswählen wird im Designer angezeigt, und der Bereich Aktion hinzufügen wird erneut geöffnet, sodass Sie die nächste Aktion auswählen können.

  2. Vergewissern Sie sich, dass im Bereich Aktion hinzufügen unter dem Suchfeld Aktion auswählen die Option Integriert ausgewählt ist. Geben Sie response in das Suchfeld ein, und wählen Sie die Aktion Antwort aus.

    Screenshot that shows the workflow designer with the Response action selected.

    Wenn die Aktion Antwort im Designer angezeigt wird, wird automatisch der Detailbereich der Aktion geöffnet.

    Screenshot that shows the workflow designer with the

  3. Geben Sie auf der Registerkarte Parameter die erforderlichen Informationen für die Funktion an, die Sie aufrufen möchten.

    In diesem Beispiel wird der Wert der Eigenschaft Text zurückgegeben, der von der Aktion E-Mail senden ausgegeben wird.

    1. Klicken Sie in das Eigenschaftsfeld Text, damit die Liste dynamischer Inhalte und die verfügbaren Ausgabewerte des vorherigen Auslösers und der Aktionen im Workflow angezeigt werden.

      Screenshot that shows the

    2. Wählen Sie in der Liste dynamischer Inhalte unter E-Mail senden die Option Text aus.

      Screenshot that shows the open dynamic content list. In the list, under the

      Wenn Sie fertig sind, wird die Eigenschaft Text der Antwortaktion auf den Ausgabewert von Text für die Aktion E-Mail senden festgelegt.

      Screenshot that shows the status for each step in the workflow plus the inputs and outputs in the expanded

  4. Wählen Sie im Designer Speichern aus.

Erneutes Testen Ihrer Logik-App

Nachdem Sie Aktualisierungen an Ihrer Logik-App vorgenommen haben, können Sie einen weiteren Test ausführen, indem Sie den Debugger in Visual Studio erneut ausführen und eine weitere Anforderung senden, um Ihre aktualisierte Logik-App auszulösen, ähnlich wie die Schritte unter Lokales Ausführen, Testen und Debuggen.

  1. Öffnen Sie auf der Aktivitätsleiste von Visual Studio Code das Menü Ausführen, und wählen Sie Debuggen starten (F5) aus.

  2. Senden Sie in Postman oder Ihrem Tool zum Erstellen und Senden von Anforderungen eine weitere Anforderung, um Ihren Workflow auszulösen.

  3. Wenn Sie einen zustandsbehafteten Workflow erstellt haben, überprüfen Sie auf der Übersichtsseite des Workflows den Status der letzten Ausführung. Wählen Sie zum Anzeigen des Status, der Ein- und Ausgaben für jeden Schritt in dieser Ausführung die Schaltfläche mit den Auslassungspunkten ( ... ) für diese Ausführung aus, und wählen Sie Ausführung anzeigen aus.

    Hier ist beispielsweise der schrittweise Status einer Ausführung, nachdem der Beispielworkflow mit der Antwortaktion aktualisiert wurde.

    Screenshot that shows the status for each step in the updated workflow plus the inputs and outputs in the expanded

  4. Um die Debugsitzung zu beenden, wählen Sie im menü Ausführen den Eintrag Debuggen beenden (UMSCHALT+F5) aus.

Suchen von Domänennamen für den Firewallzugriff

Bevor Sie Ihren Logik-App-Workflow im Azure-Portal bereitstellen und ausführen, müssen Sie, wenn in Ihrer Umgebung strenge Netzwerkanforderungen gelten oder Firewalls vorhanden sind, die den Datenverkehr einschränken, Berechtigungen für alle Trigger- oder Aktionsverbindungen, die in Ihrem Workflow vorhanden sind, einrichten.

Führen Sie die folgenden Schritte aus, um die vollqualifizierten Domänennamen (FQDNs) für diese Verbindungen zu ermitteln:

  1. Öffnen Sie in Ihrem Logik-App-Projekt die Datei connections.json, die erstellt wird, nachdem Sie Ihrem Workflow den ersten verbindungsbasierten Trigger oder eine Aktion hinzugefügt haben, und suchen Sie das managedApiConnections-Objekt.

  2. Für jede von Ihnen erstellte Verbindung kopieren und speichern Sie den connectionRuntimeUrl-Eigenschaftswert an einem sicheren Ort, damit Sie Ihre Firewall mit diesen Informationen einrichten können.

    Diese Beispieldatei connections.json enthält zwei Verbindungen, eine AS2-Verbindung und eine Office 365-Verbindung mit diesen connectionRuntimeUrl-Werten:

    • AS2: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba

    • Office 365: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f

    {
       "managedApiConnections": {
          "as2": {
             "api": {
                "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/as2"
             },
             "connection": {
                "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
             },
             "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba,
             "authentication": {
                "type":"ManagedServiceIdentity"
             }
          },
          "office365": {
             "api": {
                "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/office365"
             },
             "connection": {
                "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
             },
             "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f,
             "authentication": {
                "type":"ManagedServiceIdentity"
             }
          }
       }
    }
    

Bereitstellen in Azure

In Visual Studio Code können Sie Ihr Projekt direkt in Azure veröffentlichen, wo Ihre Logik-App mit dem Ressourcentyp Logik-App (Standard) bereitgestellt wird. Sie können Ihre Logik-App als neue Ressource veröffentlichen. Hierbei werden automatisch alle erforderlichen Ressourcen erstellt, z. B. ein Azure-Speicherkonto (ähnlich wie bei Funktions-App-Anforderungen). Alternativ können Sie Ihre Logik-App in einer zuvor bereitgestellten Logik-App-Ressource (Standard) veröffentlichen, die diese Logik-App überschreibt.

Für die Bereitstellung für den Ressourcentyp Logik-App (Standard) sind ein Hostingplan und ein Tarif erforderlich, den Sie während der Bereitstellung auswählen. Weitere Informationen finden Sie unter Hostingpläne und Tarife.

Veröffentlichen als neue Ressource „Logik-App (Standard)“

  1. Wählen Sie auf der Aktivitätsleiste von Visual Studio Code das Azure-Symbol aus.

  2. Wählen Sie auf der Symbolleiste des Bereichs Azure: Logic Apps (Standard) die Option In Logik-App bereitstellen aus.

    Screenshot that shows the

  3. Wählen Sie bei entsprechender Aufforderung das Azure-Abonnement aus, das für Ihre Logik-App-Bereitstellung verwendet werden soll.

  4. Wählen Sie in der Liste, die Visual Studio Code öffnet, aus den folgenden Optionen aus:

    • Neue Logik-App (Standard) in Azure erstellen (schnell)
    • Neue Logik-App (Standard) in Azure Advanced erstellen
    • Eine zuvor bereitgestellte Logik-App (Standard) -Ressource, falls vorhanden

    Dieses Beispiel wird mit Neue Logik-App (Standard) in Azure Advanced erstellen fortgesetzt.

    Screenshot that shows the

  5. Um Ihre neue Logik-App (Standard) -Ressource zu erstellen, gehen Sie wie folgt vor:

    1. Geben Sie einen global eindeutigen Namen für Ihre neue Logik-App an, wobei es sich um den Namen handelt, der für die Logik-App (Standard) -Ressource verwendet werden soll. In diesem Beispiel wird Fabrikam-Workflows-App verwendet.

      Screenshot that shows the

    2. Wählen Sie einen Hostingplan für Ihre neue Logik-App aus. Erstellen Sie entweder einen Namen für Ihren Plan, oder wählen Sie einen vorhandenen Plan aus. In diesem Beispiel wird Neuen App Service-Plan erstellen ausgewählt.

      Screenshot that shows the

    3. Geben Sie einen Namen für Ihren Hostingplan an, und wählen Sie dann einen Tarif für Ihren ausgewählten Plan aus.

      Weitere Informationen finden Sie unter Hostingpläne und Tarife.

    4. Wählen Sie dieselbe Ressourcengruppe wie die für die Bereitstellung des Projekts verwendete aus, um eine optimale Leistung zu erzielen.

      Hinweis

      Obwohl Sie eine andere Ressourcengruppe erstellen oder verwenden können, könnte sich dies negativ auf die Leistung auswirken. Wenn Sie eine andere Ressourcengruppe erstellen oder auswählen, nach der Anzeige der Bestätigungsaufforderung aber abbrechen, wird Ihre Bereitstellung ebenfalls abgebrochen.

    5. Wählen Sie für zustandsbehaftete Workflows Neues Speicherkonto erstellen oder ein vorhandenes Speicherkonto aus.

      Screenshot that shows the

    6. Wenn die Erstellungs- und Bereitstellungseinstellungen Ihrer Logik-App die Verwendung von Application Insights unterstützen, können Sie optional die Diagnoseprotokollierung und Ablaufverfolgung für Ihre Logik-App aktivieren. Dies können Sie entweder tun, wenn Sie Ihre Logik-App über Visual Studio Code bereitstellen, oder nach der Bereitstellung. Sie benötigen eine Application Insights-Instanz, können aber diese Ressource entweder im Voraus, beim Bereitstellen Ihrer Logik-App oder nach der Bereitstellung erstellen.

      Gehen Sie folgendermaßen vor, um die Protokollierung und Ablaufverfolgung jetzt zu aktivieren:

      1. Wählen Sie entweder eine vorhandene Application Insights-Ressource, oder erstellen Sie eine neue Application Insights-Ressource.

      2. Navigieren Sie im Azure-Portal zu Ihrer Application Insights-Ressource.

      3. Wählen Sie im Ressourcenmenü Übersicht aus. Suchen Sie den Instrumentierungsschlüssel, und kopieren Sie ihn.

      4. Öffnen Sie in Visual Studio Code im Stammordner Ihres Projekts die Datei local.settings.json.

      5. Fügen Sie im Values-Objekt die APPINSIGHTS_INSTRUMENTATIONKEY-Eigenschaft hinzu, und legen Sie den Wert auf den Instrumentierungsschlüssel fest, z. B.:

        {
           "IsEncrypted": false,
           "Values": {
              "AzureWebJobsStorage": "UseDevelopmentStorage=true",
              "FUNCTIONS_WORKER_RUNTIME": "dotnet",
              "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
           }
        }
        

        Tipp

        Sie können überprüfen, ob die Trigger- und Aktionsnamen in der Application Insights-Instanz ordnungsgemäß angezeigt werden.

        1. Navigieren Sie im Azure-Portal zu Ihrer Application Insights-Ressource.

        2. Wählen Sie im Ressourcenmenü unter Untersuchen die Option Anwendungszuordnung aus.

        3. Überprüfen Sie die Vorgangsnamen, die in der Zuordnung angezeigt werden.

        Einige eingehende Anforderungen von integrierten Triggern werden in der Anwendungszuordnung möglicherweise als Duplikate angezeigt. Anstatt das WorkflowName.ActionName-Format zu verwenden, verwenden diese Duplikate den Workflownamen als Vorgangsnamen und haben ihren Ursprung auf dem Azure Functions-Host.

      6. Anschließend können Sie den Schweregrad der Ablaufverfolgungsdaten, die ihre Logik-App sammelt und an Ihre Application Insights-Instanz sendet, optional anpassen.

        Bei jedem workflowbezogenen Ereignis, wenn z. B. ein Workflow ausgelöst oder eine Aktion ausgeführt wird, gibt die Runtime verschiedene Ablaufverfolgungen aus. Diese Ablaufverfolgungen decken die Lebensdauer des Workflows ab und umfassen die folgenden Ereignistypen, sind aber nicht darauf beschränkt:

        • Dienstaktivität, z. B. Starten, Beenden und Fehler.
        • Aufträge und Verteileraktivität.
        • Workflowaktivität, z. B. Trigger, Aktion und Ausführen.
        • Speicheranforderungsaktivität, z. B. Erfolg oder Fehler.
        • HTTP-Anforderungsaktivität, z. B. eingehend, ausgehend, Erfolg und Fehler.
        • Alle Entwicklungsablaufverfolgungen, z. B. Debugmeldungen.

        Jeder Ereignistyp wird einem Schweregrad zugewiesen. Beispielsweise erfasst die Trace-Ebene die detailliertesten Nachrichten, während die Information-Ebene allgemeine Aktivitäten in Ihrem Workflow erfasst, z. B. wann Logik-App, Workflow, Trigger und Aktionen gestartet und beendet werden. In dieser Tabelle werden die Schweregrade und deren Ablaufverfolgungstypen beschrieben:

        Schweregrad Ablaufverfolgungstyp
        Kritisch Protokolle, in denen ein nicht behebbarer Fehler in Ihrer Logik-App beschrieben wird.
        Debuggen Protokolle, die Sie für die Untersuchung während der Entwicklung verwenden können, z. B. eingehende und ausgehende HTTP-Aufrufe.
        Fehler Protokolle, die auf einen Fehler bei der Workflowausführung hindeuten, aber nicht auf einen allgemeinen Fehler in Ihrer Logik-App.
        Information Protokolle, die die allgemeine Aktivität in ihrer Logik-App oder im Workflow nachverfolgen, z. B.:

        – Wann ein Trigger, eine Aktion oder eine Ausführung gestartet und beendet wird.
        – Wann Ihre Logik-App gestartet oder beendet wird.

        Trace Protokolle, die die detailliertesten Meldungen enthalten, z. B. Speicheranforderungen oder Verteileraktivität, sowie alle Meldungen, die sich auf die Workflowausführungsaktivität beziehen.
        Warnung Protokolle, die einen ungewöhnlichen Status in Ihrer Logik-App hervorheben, jedoch nicht verhindern, dass sie ausgeführt wird.

        Um den Schweregrad festzulegen, öffnen Sie auf der Stammebene des Projekts die Datei host.json, und suchen Sie nach dem logging-Objekt. Dieses Objekt steuert die Protokollfilterung für alle Workflows in Ihrer Logik-App und folgt dem ASP.NET Core-Layout für die Protokolltypfilterung.

        {
           "version": "2.0",
           "logging": {
              "applicationInsights": {
                 "samplingExcludedTypes": "Request",
                 "samplingSettings": {
                    "isEnabled": true
                 }
              }
           }
        }
        

        Wenn das logging-Objekt kein logLevel-Objekt enthält, das die Host.Triggers.Workflow-Eigenschaft enthält, fügen Sie diese Elemente hinzu. Legen Sie die Eigenschaft auf den Schweregrad für den gewünschten Ablaufverfolgungstyp fest, z. B.:

        {
           "version": "2.0",
           "logging": {
              "applicationInsights": {
                 "samplingExcludedTypes": "Request",
                 "samplingSettings": {
                    "isEnabled": true
                 }
              },
              "logLevel": {
                 "Host.Triggers.Workflow": "Information"
              }
           }
        }
        

    Wenn Sie die Bereitstellungsschritte abgeschlossen haben, beginnt Visual Studio Code mit der Erstellung und Bereitstellung der Ressourcen, die für das Veröffentlichen Ihrer Logik-App erforderlich sind.

  6. Um den Bereitstellungsprozess zu überwachen und zu überprüfen, wählen Sie im Menü Ansicht die Option Ausgabe aus. Wählen Sie in der Liste der Symbolleiste des Ausgabefensters Azure Logic Apps aus.

    Screenshot that shows the Output window with the

    Wenn Visual Studio Code die Bereitstellung Ihrer Logik-App in Azure abschließt, wird diese Meldung angezeigt:

    Screenshot that shows a message that deployment to Azure successfully completed.

    Herzlichen Glückwunsch, ihre Logik-App ist jetzt live in Azure und standardmäßig aktiviert.

Als Nächstes erfahren Sie, wie Sie diese Aufgaben ausführen:

Hinzufügen eines leeren Workflows zum Projekt

Ihr Logik-App-Projekt kann mehrere Workflows enthalten. Um dem Projekt einen leeren Workflow hinzuzufügen, führen Sie die folgenden Schritte aus:

  1. Wählen Sie auf der Aktivitätsleiste von Visual Studio Code das Azure-Symbol aus.

  2. Wählen Sie im Azure-Bereich neben Azure: Logic Apps (Standard) die Option Workflow erstellen (Symbol für Azure Logic Apps) aus.

  3. Wählen Sie den Workflowtyp aus, den Sie hinzufügen möchten: Zustandsbehaftet oder Zustandslos.

  4. Geben Sie einen Namen für den Workflow ein.

Wenn Sie fertig sind, wird in Ihrem Projekt ein neuer Workflowordner zusammen mit einer workflow.json-Datei für die Workflowdefinition angezeigt.

Verwalten bereitgestellter Logik-Apps in Visual Studio Code

In Visual Studio Code können Sie alle bereitgestellten Logik-Apps in Ihrem Azure-Abonnement anzeigen, unabhängig davon, ob es sich um den ursprünglichen Logic Apps- oder den Logik-App (Standard) -Ressourcentyp handelt, und Aufgaben auswählen, die Ihnen bei der Verwaltung dieser Logik-Apps helfen. Für den Zugriff auf beide Ressourcentypen benötigen Sie aber beide Erweiterungen für Visual Studio Code: Azure Logic Apps und Azure Logic Apps (Standard) .

  1. Wählen Sie auf der linken Symbolleiste das Azure-Symbol aus. Wählen Sie im Bereich Azure: Logic Apps (Standard) Ihr Abonnement, in dem alle bereitgestellten Logik-Apps für dieses Abonnement angezeigt werden.

  2. Öffnen Sie die Logik-App, die Sie verwalten möchten. Wählen Sie im Kontextmenü der Logik-App die Aufgabe aus, die Sie durchführen möchten.

    Beispielsweise können Sie Aufgaben wie das Beenden, Starten, Neustarten oder Löschen Ihrer bereitgestellten Logik-App auswählen. Sie können einen Workflow mithilfe des Azure-Portals deaktivieren oder aktivieren.

    Hinweis

    Die Vorgänge „Logik-App beenden“ und „Logik-App löschen“ wirken sich auf unterschiedliche Weise auf Workflow-Instanzen aus. Weitere Informationen hierzu sind unter Überlegungen zum Beenden von Logik-Apps und Überlegungen zum Löschen von Logik-Apps zu lesen.

    Screenshot that shows Visual Studio Code with the opened

  3. Um alle Workflows in der Logik-App anzuzeigen, erweitern Sie Ihre Logik-App und dann den Knoten Workflows.

  4. Um einen bestimmten Workflow anzuzeigen, öffnen Sie das Kontextmenü des Workflows, und wählen Sie Im Designer öffnen aus. Dadurch wird der Workflow im schreibgeschützten Modus geöffnet.

    Um den Workflow zu bearbeiten, haben Sie folgende Optionen:

    • Öffnen Sie in Visual Studio Code die workflow.json-Datei des Projekts im Workflow-Designer, nehmen Sie Ihre Änderungen vor, und stellen Sie Ihre Logik-App erneut in Azure bereit.

    • Öffnen Sie Ihre Logik-App im Azure-Portal. Anschließend können Sie Ihren Workflow öffnen, bearbeiten und speichern.

  5. Um die bereitgestellte Logik-App im Azure-Portal zu öffnen, öffnen Sie das Kontextmenü der Logik-App, und wählen Sie Im Portal öffnen aus.

    Das Azure-Portal wird in Ihrem Browser geöffnet, Sie werden automatisch beim Portal angemeldet, wenn Sie bei Visual Studio Code angemeldet sind, und Ihre Logik-App wird angezeigt.

    Screenshot that shows the Azure portal page for your logic app in Visual Studio Code.

    Sie können sich auch gesondert beim Azure-Portal anmelden, Ihre Logik-App über das Suchfeld des Portals suchen und dann Ihre Logik-App aus der Ergebnisliste auswählen.

    Screenshot that shows the Azure portal and the search bar with search results for deployed logic app, which appears selected.

Überlegungen zum Beenden von Logik-Apps

Das Beenden einer Logik-App wirkt sich wie folgt auf Workflow-Instanzen aus:

  • Azure Logic Apps bricht alle laufenden und ausstehenden Ausführungen sofort ab.

  • Azure Logic Apps erstellt keine neuen Workflowinstanzen und führt keine neuen Workflowinstanzen aus.

  • Trigger werden nicht ausgelöst, wenn die definierten Bedingungen beim nächsten Mal erfüllt werden. Triggerzustände merken sich jedoch die Punkte, an denen die Logik-App beendet wurde. Wenn Sie die Logik-App erneut starten, wird der Trigger für alle nicht verarbeiteten Elemente seit der letzten Ausführung ausgelöst.

    Um das Auslösen eines Triggers für nicht verarbeitete Elemente seit der letzten Ausführung zu verhindern, löschen Sie den Triggerstatus, bevor Sie die Logik-App erneut starten:

    1. Wählen Sie in Visual Studio Code in der linken Symbolleiste das Symbol Azure aus.
    2. Wählen Sie im Bereich Azure: Logic Apps (Standard) Ihr Abonnement, in dem alle bereitgestellten Logik-Apps für dieses Abonnement angezeigt werden.
    3. Erweitern Sie Ihre Logik-App, und erweitern Sie dann den Knoten mit der Bezeichnung Workflows.
    4. Öffnen Sie einen Workflow, und bearbeiten Sie einen beliebigen Teil des Triggers dieses Workflows.
    5. Speichern Sie die Änderungen. Durch diesen Schritt wird der aktuelle Status des Triggers zurückgesetzt.
    6. Wiederholen Sie dies für jeden Workflow.
    7. Wenn Sie fertig sind, speichern Sie Ihre Logik-App neu.

Überlegungen zum Beenden von Logik-Apps

Das Löschen einer Logik-App wirkt sich wie folgt auf Workflow-Instanzen aus:

  • Azure Logic Apps bricht in Bearbeitung befindliche und ausstehende Ausführungen sofort ab, führt jedoch keine Bereinigungsaufgaben für den von der App verwendeten Speicher aus.

  • Azure Logic Apps erstellt keine neuen Workflowinstanzen und führt keine neuen Workflowinstanzen aus.

  • Wenn Sie einen Workflow löschen und dann denselben Workflow neu erstellen, hat der neu erstellte Workflow nicht die gleichen Metadaten wie der gelöschte Workflow. Zum Aktualisieren der Metadaten müssen Sie jeden Workflow, der den gelöschten Workflow aufgerufen hat, neu speichern. Auf diese Weise ruft der Aufrufer die richtigen Informationen für den neu erstellten Workflow ab. Andernfalls schlagen Aufrufe des neu erstellten Workflows mit einem Unauthorized-Fehler fehl. Dieses Verhalten gilt auch für Workflows, die Artefakte in Integrationskonten und Workflows verwenden, welche Azure-Funktionen aufrufen.

Verwalten bereitgestellter Logik-Apps im Portal

Wenn Sie eine Logik-App im Azure-Portal von Visual Studio Code einsetzen, können Sie alle bereitgestellten Logik-Apps anzeigen, die in Ihrem Azure-Abonnement enthalten sind, unabhängig davon, ob es sich um den ursprünglichen Logik-App-Ressourcentyp oder den Logik-App (Standard) -Ressourcentyp handelt. Zurzeit wird jeder Ressourcentyp in Azure als separate Kategorien organisiert und verwaltet. Um Logik-Apps zu finden, die vom Ressourcentyp Logik-App (Standard) sind, gehen Sie wie folgt vor:

  1. Geben Sie in das Suchfeld des Azure-Portals logic apps ein. Wenn die Ergebnisliste angezeigt wird, wählen Sie unter Dienste die Option Logik-Apps aus.

    Screenshot that shows the Azure portal search box with the

  2. Wählen Sie im Bereich Logik-App (Standard) die Logik-App aus, die Sie aus Visual Studio Code bereitgestellt haben.

    Screenshot that shows the Azure portal and the Logic App (Standard) resources deployed in Azure.

    Das Azure-Portal öffnet die Seite der einzelnen Ressource für die ausgewählte Logik-App.

    Screenshot that shows your logic app workflow's resource page in the Azure portal.

  3. Um die Workflows in dieser Logik-App auszuwählen, wählen im Menü der Logik-App Workflows aus.

    Im Bereich Workflows werden alle in der aktuellen Logik-App vorhandenen Workflows angezeigt. Dieses Beispiel zeigt den Workflow, den Sie in Visual Studio Code erstellt haben.

    Screenshot that shows a

  4. Um einen Workflow anzuzeigen, wählen Sie im Bereich Workflows diesen Workflow aus.

    Der Workflowbereich wird geöffnet und zeigt weitere Informationen und Aufgaben an, die Sie für diesen Workflow ausführen können.

    Um beispielsweise die Schritte in dem Workflow anzuzeigen, wählen Sie Designer aus.

    Screenshot that shows the selected workflow's

    Der Workflow-Designer wird geöffnet und zeigt den Workflow an, den Sie in Visual Studio Code erstellt haben. Sie können jetzt Änderungen an diesem Workflow im Azure-Portal vornehmen.

    Screenshot that shows the workflow designer and workflow deployed from Visual Studio Code.

Hinzufügen eines weiteren Workflows im Portal

Über das Azure-Portal können Sie einer Logik-App-Ressource (Standard), die Sie aus Visual Studio Code bereitgestellt haben, leere Workflows hinzufügen und diese Workflows im Azure-Portal erstellen.

  1. Wählen Sie im Azure-Portal Ihre bereitgestellte Logik-App (Standard) -Ressource aus.

  2. Wählen Sie im Menü der Logik-App Workflows aus. Wählen Sie im Bereich Workflows den Befehl Hinzufügen aus.

    Screenshot that shows the selected logic app's

  3. Geben Sie im Bereich Neuer Workflow einen Namen für den Workflow an. Wählen Sie entweder Zustandsbehaftet oder Zustandslos> Erstellen aus.

    Nachdem Azure Ihren neuen Workflow bereitgestellt hat, der im Bereich Workflows angezeigt wird, wählen Sie diesen Workflow aus, um die Verwaltung und andere Aufgaben auszuführen, z. B. das Öffnen des Designers oder der Codeansicht.

    Screenshot that shows the selected workflow with management and review options.

    Wenn Sie z. B. den Designer für einen neuen Workflow öffnen, wird ein leerer Zeichenbereich angezeigt. Sie können diesen Workflow jetzt im Azure-Portal erstellen.

    Screenshot that shows the workflow designer and a blank workflow.

Aktivieren des Ausführungsverlaufs für zustandslose Workflows

Damit Sie einen zustandslosen Workflow debuggen können, können Sie den Ausführungsverlauf für diesen Workflow aktivieren und wieder deaktivieren, wenn Sie fertig sind. Führen Sie diese Schritte für Visual Studio Code aus. Wenn Sie im Azure-Portal arbeiten, lesen Sie Erstellen von Workflows für Instanzen mit einem Mandanten im Azure-Portal.

  1. Erweitern Sie in Ihrem Visual Studio Code-Projekt den Ordner workflow-designtime, und öffnen Sie die Datei local.settings.json.

  2. Fügen Sie die Eigenschaft Workflows.{yourWorkflowName}.operationOptions hinzu, und legen Sie deren Wert auf WithStatelessRunHistory fest, z. B.:

    Windows

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    

    macOS oder Linux

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
              AccountKey=<access-key>;EndpointSuffix=core.windows.net",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    
  3. Um den Ausführungsverlauf zu deaktivieren, wenn Sie fertig sind, legen Sie entweder die Eigenschaft Workflows.{yourWorkflowName}.OperationOptions auf None fest oder löschen die Eigenschaft und ihren Wert.

Aktivieren der Überwachungsansicht im Azure-Portal

Nachdem Sie eine Ressource von Logic Apps (Standard) aus Visual Studio Code in Azure bereitgestellt haben, können Sie jeden verfügbaren Ausführungsverlauf und die Details für einen Workflow in dieser Ressource überprüfen, indem Sie das Azure-Portal und die Monitor-Umgebung für diesen Workflow verwenden. Sie müssen jedoch zunächst die Monitor-Ansichtsfunktion für diese Logik-App-Ressource aktivieren.

  1. Wählen Sie im Azure-Portal die bereitgestellte Logik-App (Standard) -Ressource aus.

  2. Wählen Sie im Menü dieser Ressource unter API die Option CORS aus.

  3. Fügen Sie im Bereich CORS unter Zulässige Ursprünge das Platzhalterzeichen (*) hinzu.

  4. Wenn Sie fertig sind, wählen Sie auf der CORS-Symbolleiste Speichern aus.

    Screenshot that shows the Azure portal with a deployed Logic App (Standard) resource. On the resource menu,

Aktivieren oder Öffnen von Application Insights nach der Bereitstellung

Während der Workflowausführung gibt Ihre Logik-App Telemetriedaten zusammen mit anderen Ereignissen aus. Sie können diese Telemetrie verwenden, um auf verschiedene Weise einen besseren Einblick in die Qualität der Workflowausführung und die Arbeitsweise der Logic Apps-Runtime zu bekommen. Sie können den Workflow überwachen, indem Sie Application Insights verwenden, wodurch nahezu in Echtzeit Telemetriedaten (Livemetriken) bereitgestellt werden. Mithilfe dieser Funktion können Sie Fehler und Leistungsprobleme leichter untersuchen, wenn Sie diese Daten zum Diagnostizieren von Problemen, Einrichten von Warnungen und Erstellen von Diagrammen verwenden.

Wenn die Erstellungs- und Bereitstellungseinstellungen Ihrer Logik-App die Verwendung von Application Insights unterstützen, können Sie optional die Diagnoseprotokollierung und Ablaufverfolgung für Ihre Logik-App aktivieren. Dies können Sie entweder tun, wenn Sie Ihre Logik-App über Visual Studio Code bereitstellen, oder nach der Bereitstellung. Sie benötigen eine Application Insights-Instanz, können aber diese Ressource entweder im Voraus, beim Bereitstellen Ihrer Logik-App oder nach der Bereitstellung erstellen.

Gehen Sie folgendermaßen vor, um Application Insights auf einer bereitgestellten Logik-App zu aktivieren oder Application Insights-Daten zu überprüfen, wenn sie bereits aktiviert sind:

  1. Suchen Sie im Azure-Portal nach Ihrer bereitgestellten Logik-App.

  2. Wählen Sie im Menü der Logik-App unter Einstellungen die Option Application Insights aus.

  3. Wenn Application Insights nicht aktiviert ist, wählen Sie im Bereich Application Insights die Option Application Insights aktivieren aus. Nachdem der Bereich aktualisiert wurde, wählen Sie unten Anwenden aus.

    Wenn Application Insights aktiviert ist, wählen Sie im Bereich Application Insights die Option Application Insights-Daten anzeigen aus.

Nachdem Application Insights geöffnet wurde, können Sie verschiedene Metriken für Ihre Logik-App überprüfen. Weitere Informationen finden Sie in diesen Themen:

Löschen von Elementen aus dem Designer

Führen Sie einen der folgenden Schritte aus, um ein Element in Ihrem Workflow aus dem Designer zu löschen:

  • Wählen Sie das Element aus, öffnen Sie das Kontextmenü des Elements (UMSCHALT+F10), und wählen Sie Löschen aus. Klicken Sie auf OK, um dies zu bestätigen.

  • Wählen Sie das Element aus, und drücken Sie dann die ENTF-Taste. Klicken Sie auf OK, um dies zu bestätigen.

  • Wählen Sie das Element aus, sodass der Detailbereich für dieses Element geöffnet wird. Öffnen Sie in der oberen rechten Ecke des Bereichs das Menü mit den Auslassungspunkten ( ... ), und wählen Sie Löschen aus. Klicken Sie auf OK, um dies zu bestätigen.

    Screenshot that shows a selected item on designer with the opened details pane plus the selected ellipses button and

    Tipp

    Wenn das Menü mit den Auslassungspunkten nicht sichtbar ist, erweitern Sie das Visual Studio Code-Fenster, sodass im Detailbereich die Schaltfläche mit den Auslassungspunkten ( ... ) in der oberen rechten Ecke angezeigt wird.

Beheben von Fehlern und Problemen

Designer wird nicht geöffnet

Beim Versuch, den Designer zu öffnen, erhalten Sie einen Fehler wie Workflowentwurfszeit konnte nicht gestartet werden. Falls Sie schon einmal versucht haben, den Designer zu öffnen, und Ihr Projekt anschließend nicht weiter verfolgt oder gelöscht haben, wird das Erweiterungspaket ggf. nicht richtig heruntergeladen. Führen Sie die folgenden Schritte aus, um zu überprüfen, ob dies die Ursache des Problems ist:

  1. Öffnen Sie in Visual Studio Code das Fenster „Ausgabe“. Wählen Sie im Menü Ansicht die Option Ausgabe aus.

  2. Wählen Sie in der Liste auf der Titelleiste des Fensters „Ausgabe“ Azure Logic Apps (Standard) aus, damit Sie die Ausgabe für die Erweiterung überprüfen können, z. B.:

    Screenshot that shows the Output window with

  3. Überprüfen Sie die Ausgabe, und prüfen Sie, ob diese Fehlermeldung angezeigt wird:

    A host error has occurred during startup operation '{operationID}'.
    System.Private.CoreLib: The file 'C:\Users\{userName}\AppData\Local\Temp\Functions\
    ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\
    DurableTask.AzureStorage.dll' already exists.
    Value cannot be null. (Parameter 'provider')
    Application is shutting down...
    Initialization cancellation requested by runtime.
    Stopping host...
    Host shutdown completed.
    

Um diesen Fehler zu beheben, löschen Sie den Ordner ExtensionBundles an diesem Speicherort ...\Benutzer{Ihr-Benutzername}\AppData\Local\Temp\Functions\ExtensionBundles, und versuchen Sie erneut, die Datei workflow.json im Designer zu öffnen.

In der Designerauswahl für zuvor erstellte Workflows fehlen neue Trigger und Aktionen

Azure Logic Apps mit einzelnem Mandanten unterstützt integrierte Aktionen für Azure-Funktionsvorgänge, Liquid-Vorgänge und XML-Vorgänge wie XML-Validierung und Transformieren von XML. Allerdings werden diese Aktionen für zuvor erstellte Logik-Apps möglicherweise nicht für Sie zur Auswahl in der Designerauswahl angezeigt, wenn Visual Studio Code eine veraltete Version des Erweiterungspakets Microsoft.Azure.Functions.ExtensionBundle.Workflows verwendet.

Außerdem werden der Connector für Azure-Funktionsvorgänge und Aktionen nicht in der Designerauswahl angezeigt, es sei denn, Sie haben Connectors von Azure verwenden beim Erstellen Ihrer Logik-App aktiviert oder ausgewählt. Wenn Sie die von Azure bereitgestellten Connectors zum Zeitpunkt der Erstellung der App nicht aktiviert haben, können Sie sie in Visual Studio Code von Ihrem Projekt aus aktivieren. Öffnen Sie das workflow.json-Kontextmenü, und wählen Sie Connectors von Azure verwenden aus.

Führen Sie zur Korrektur des Problems mit dem veralteten Paket die folgenden Schritte zum Löschen des veralteten Pakets aus. Dann aktualisiert Visual Studio Code das Erweiterungspaket automatisch auf die neueste Version.

Hinweis

Diese Lösung gilt nur für Logik-Apps, die Sie mit Visual Studio Code mit der Erweiterung „Azure Logic Apps (Standard)“ erstellen und bereitstellen, nicht die Logik-Apps, die Sie mit dem Azure-Portal erstellt haben. Siehe Neue Trigger und Aktionen fehlen in der Designerauswahl für früher erstellte Workflows.

  1. Speichern Sie sämtliche Arbeit, die Sie nicht verlieren möchten, und schließen Sie Visual Studio.

  2. Navigieren Sie auf Ihrem Computer zum folgenden Ordner, der Ordner mit Versionsangaben für das vorhandene Paket enthält:

    ...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

  3. Löschen Sie den Versionsordner für das frühere Paket. Wenn Sie z. B. einen Ordner für Version 1.1.3 haben, löschen Sie diesen Ordner.

  4. Navigieren Sie nun zum folgenden Ordner, der Ordner mit Versionsangaben für das erforderliche NuGet-Paket enthält:

    ...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension

  5. Löschen Sie den Versionsordner für das vorherige Paket.

  6. Öffnen Sie Visual Studio Code, Ihr Projekt und die workflow.json-Datei im Designer erneut.

Die fehlenden Trigger und Aktionen werden nun im Designer angezeigt.

„400 – Ungültige Anforderung“ wird für einen Trigger oder eine Aktion angezeigt

Wenn Sie nach einem Fehler in einer Ausführung diese Ausführung in der Überwachungsansicht untersuchen, kann dieser Fehler bei einem Trigger oder einer Aktion mit einem längeren Namen angezeigt werden. Ein solcher Name kann dazu führen, dass der zugrunde liegende URI (Uniform Resource Identifier) das Standardzeichenlimit überschreitet.

Um dieses Problem zu beheben und längere URIs zuzulassen, bearbeiten Sie die Registrierungsschlüssel UrlSegmentMaxCount und UrlSegmentMaxLength auf Ihrem Computer. Führen Sie dazu die folgenden Schritte aus. Die Standardwerte dieser Schlüssel werden in diesem Thema beschrieben: Http.sys-Registrierungseinstellungen für Windows.

Wichtig

Speichern Sie Ihre bisherige Arbeit, bevor Sie beginnen. Diese Lösung erfordert nach Abschluss der Änderungen einen Neustart Ihres Computers, damit die Änderungen wirksam werden.

  1. Öffnen Sie auf Ihrem Computer das Fenster Ausführen, und führen Sie den Befehl regedit aus. Dieser öffnet den Registrierungs-Editor.

  2. Klicken Sie im Feld Benutzerkontensteuerung auf Ja, um Änderungen am Computer zuzulassen.

  3. Erweitern Sie im linken Bereich unter Computer die Knoten im Pfad HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters, und wählen Sie dann Parameters aus.

  4. Suchen Sie im rechten Bereich nach den Registrierungsschlüsseln UrlSegmentMaxCount und UrlSegmentMaxLength.

  5. Erhöhen Sie die Werte dieser Schlüssel so, dass die URIs die von Ihnen gewünschten Namen aufnehmen können. Wenn diese Schlüssel nicht vorhanden sind, fügen Sie sie mithilfe der folgenden Schritte zum Ordner Parameters hinzu:

    1. Wählen Sie im Kontextmenü für Parameters die Option Neu>DWORD-Wert (32-Bit) aus.

    2. Geben Sie im daraufhin angezeigten Bearbeitungsfeld UrlSegmentMaxCount als neuen Schlüsselnamen ein.

    3. Öffnen Sie das Kontextmenü des neuen Schlüssels, und wählen Sie Ändern aus.

    4. Geben Sie im angezeigten Feld DWORD-Wert (32-Bit) bearbeiten unter Wertdaten den gewünschten Schlüsselwert im Hexadezimal- oder Dezimalformat ein. Der Wert 400 im Hexadezimalformat entspricht beispielsweise dem Wert 1024 im Dezimalformat.

    5. Zum Hinzufügen des Schlüsselwerts UrlSegmentMaxLength wiederholen Sie diese Schritte.

    Nachdem Sie die Schlüsselwerte erhöht oder hinzugefügt haben, sieht der Registrierungs-Editor wie folgt aus:

    Screenshot that shows the registry editor.

  6. Wenn Sie fertig sind, starten Sie Ihren Computer neu, damit die Änderungen wirksam werden.

Debugsitzung wird nicht gestartet

Beim Versuch, eine Debugsitzung zu starten, erhalten Sie einen Fehler wie Fehler nach der Ausführung von preLaunchTask „generateDebugSymbols“ . Bearbeiten Sie die Datei tasks.json in Ihrem Projekt so, dass die Symbolgenerierung übersprungen wird, um dieses Problem zu beheben.

  1. Erweitern Sie in Ihrem Projekt den Ordner .vscode, und öffnen Sie die Datei tasks.json.

  2. Löschen Sie in der folgenden Aufgabe die Zeile "dependsOn: "generateDebugSymbols" (einschließlich des Kommas, mit dem die vorherige Zeile abgeschlossen wird). Beispiel:

    Vorher:

     {
       "type": "func",
       "command": "host start",
       "problemMatcher": "$func-watch",
       "isBackground": true,
       "dependsOn": "generateDebugSymbols"
     }
    

    Nachher:

     {
       "type": "func",
       "command": "host start",
       "problemMatcher": "$func-watch",
       "isBackground": true
     }
    

Nächste Schritte

Teilen Sie uns bitte Ihre Erfahrungen mit der Erweiterung „Azure Logic Apps (Standard)“ mit!