Erstellen von Workflows für Standardlogik-Apps mit Visual Studio Code

Gilt für: Azure Logic Apps (Standard)

In diesem Handbuch wird gezeigt, wie Sie lokal einen Beispiel-Workflow für eine Standard-Logik-App erstellen, den Sie in Einzelmandant-Azure-Logic-Apps ausführen können, wenn Sie Visual Studio Code mit der Azure Logic Apps (Standard)-Erweiterung verwenden.

In diesem Leitfaden erstellen Sie einen Standardlogik-App-Arbeitsbereich und ein Projekt, erstellen Ihren Workflow und stellen Ihr Projekt als Standardlogik-App-Ressource in Azure bereit, in der Ihr Workflow in Azure Logic Apps mit einem Mandanten oder in App Service Environment v3 (nur Windows-basierte App Service-Pläne) ausgeführt werden kann. Sie können Ihren Workflow auch überall bereitstellen und ausführen, wo Kubernetes ausgeführt werden kann, z. B. Azure, Azure Kubernetes Service, lokal oder sogar andere Cloudanbieter, aufgrund der containerisierten Laufzeit für Azure Logic Apps (Standard).

Hier sind nur einige Vorteile, die Standardlogik-Apps bereitstellen:

• Sie können Workflows in der lokalen Visual Studio Code-Entwicklungsumgebung lokal erstellen, debuggen, ausführen und testen. Sowohl das Azure-Portal als auch Visual Studio Code bieten die Möglichkeit zum Erstellen, Ausführen und Bereitstellen von Standardlogik-App-Ressourcen und -Workflows. Mit Visual Studio Code können Sie diese Aufgaben jedoch lokal ausführen.

• Ihr Standardlogik-App-Projekt kann sowohl zustandsfreie als auch zustandslose Workflows enthalten.

• Workflows in derselben Standardlogik-App-Ressource und -Mandant werden im gleichen Prozess wie die Azure Logic Apps (Standard)-Laufzeit ausgeführt, sodass sie dieselben Ressourcen gemeinsam nutzen und eine bessere Leistung bieten.

Der Beispielworkflow dieses Leitfadens beginnt zunächst mit einem Anforderungstrigger , gefolgt von einer Office 365 Outlook-Aktion . Der Anforderungstrigger erstellt einen aufrufbaren Endpunkt für den Workflow und wartet auf eine eingehende HTTPS-Anforderung von jedem Aufrufer. Wenn der Trigger eine Anforderung empfängt und ausgelöst wird, wird die nächste Aktion ausgeführt, indem eine E-Mail an den angegebenen Empfänger gesendet wird, zusammen mit allen von Ihnen ausgewählten Triggerausgängen. Später können Sie dem Aufrufer eine Antwortaktion hinzufügen, die eine Antwort und verarbeitete Daten zurückgibt.

Während das Beispiel dieses Handbuchs cloudbasiert ist und nur einige Schritte umfasst, können Sie Workflows mithilfe von Vorgängen aus 1.400 Connectors erstellen, die Ihnen dabei helfen, eine große Palette von Diensten, Systemen, Apps und Daten in der Cloud, lokal und hybriden Umgebungen zu integrieren.

In diesem Leitfaden führen Sie die folgenden allgemeinen Aufgaben aus:

• Erstellen Sie einen Standardlogik-App-Arbeitsbereich und ein Projekt mit einem leeren Zustandsworkflow.
• Fügen Sie Ihrem Workflow einen Trigger und Aktionen hinzu.
• Lokal ausführen, debuggen und testen.
• Überprüfen des Ausführungsverlaufs des Workflows
• Suchen von Domänennamensdetails für den Firewallzugriff.
• Aktivieren des Ausführungsverlaufs für zustandslose Workflows.
• Bereitstellen in Azure, was die optionale Aktivierung von Application Insights beinhaltet.
• Aktivieren oder Öffnen von Application Insights nach der Bereitstellung.
• Verwalten Sie Ihre bereitgestellte Logik-App-Ressource in Visual Studio Code und im Azure-Portal.

Voraussetzungen

Zugriffs- und Konnektivitätsanforderungen

Wenn Sie beabsichtigen, Workflows lokal mit nur integrierten Vorgängen zu erstellen und auszuführen, die nativ auf der Azure Logic Apps (Standard)-Laufzeit ausgeführt werden, benötigen Sie die Zugriffs- und Konnektivitätsanforderungen in diesem Abschnitt nicht. Für die folgenden Szenarien müssen Sie diese Anforderungen jedoch erfüllen:

• Stellen Sie Ihre Logik-App über Visual Studio Code in Azure bereit.
• Erstellen Sie einen Workflow, der verwaltete Connectorvorgänge verwendet, die in globalen Azure ausgeführt werden.
• Greifen Sie auf vorhandene Standardlogik-App-Ressourcen und -Workflows in Azure oder anderen bereitgestellten Azure-Ressourcen zu.

Zu diesen Anforderungen gehören die folgenden Elemente:

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

• Zugriff auf das Internet, sodass Sie die erforderliche Erweiterung herunterladen, eine Verbindung von Visual Studio Code mit Ihrem Azure-Konto herstellen, Workflows testen, die verwaltete Connectorvorgänge enthalten und über Visual Studio Code in Azure bereitstellen können.

• Zum Erstellen desselben Beispielworkflows in diesem Leitfaden benötigen Sie ein Office 365 Outlook-E-Mail-Konto, das ein Microsoft-Geschäfts-, Schul- oder Unikonto zum Anmelden verwendet.

  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. 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 Erfahrung und Optionen können sich jedoch auf verschiedene Arten unterscheiden. Verwenden Sie beispielsweise mit dem Outlook.com Connector Ihr persönliches Microsoft-Konto, um sich anzumelden.

Werkzeuge

1. Laden Sie Visual Studio Code herunter, und installieren Sie es, das kostenlos ist.

2. Laden Sie die Azure Logic Apps (Standard)-Erweiterung für Visual Studio Code herunter, und installieren Sie sie, indem Sie die folgenden Schritte ausführen:

   1. Wählen Sie in Visual Studio Code auf der Aktivitätsleiste Erweiterungen aus. (Tastatur: Drücken Sie STRG+UMSCHALT+X)

   2. Geben Sie im Erweiterungssuchfeld azure logic apps standard ein. Wählen Sie in der Ergebnisliste Azure Logic Apps (Standard)>Installieren aus.

      Die Erweiterung lädt alle erforderlichen Abhängigkeiten herunter und installiert die richtigen Versionen für die folgenden Frameworks:

      • Azure Funktionen Kernwerkzeuge
      • .NET SDK
      • Node.js

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

      

   3. Laden Sie Visual Studio Code neu, oder starten Sie sie neu, um sicherzustellen, dass die Erweiterung und alle Abhängigkeiten ordnungsgemäß installiert werden.

   4. Informationen zum Bestätigen, dass die Erweiterung und alle Abhängigkeiten ordnungsgemäß installiert wurden, finden Sie unter "Überprüfen der Erweiterungsinstallation".

   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 sowohl die Ressourcentypen "Standard" als auch "Verbrauchs-Logik-App" enthalten. In Visual Studio Code zeigt der Azure-Bereich alle von Azure bereitgestellten und gehosteten Logik-Apps in Ihrem Azure-Abonnement an, organisiert Ihre Apps jedoch wie folgt:

   • Abschnitt Ressourcen: Alle Standard-Logik-Apps in Ihrem Abonnement.
   • Abschnitt Logic Apps (Verbrauch): Alle verbrauchsbasierten Logik-Apps in Ihrem Abonnement.

3. Um webhook-basierte Trigger und Aktionen wie den integrierten HTTP-Webhook-Trigger lokal auszuführen, müssen Sie die Weiterleitung für die Rückruf-URL in Visual Studio Code einrichten.

4. Um die Diagnoseprotokollierung und -ablaufverfolgung mit Application Insights für Ihre Standardlogik-App zu aktivieren, können Sie diese Aufgabe entweder während der Logik-App-Bereitstellung oder nach der Bereitstellung ausführen. Sie müssen über eine Application Insights-Ressource verfügen, aber Sie können diese Ressource im Voraus, während der Bereitstellung oder nach der Bereitstellung erstellen.

5. Installieren oder verwenden Sie ein Tool, das HTTP-Anforderungen senden kann, um den Beispielworkflow zu testen, z. B.:

   • Visual Studio Code mit einer Erweiterung von Visual Studio Marketplace
   • PowerShell Invoke-RestMethod
   • Microsoft Edge – Netzwerkkonsolentool
   • Bruno
   • Locke

   Vorsicht

   Für Szenarien, in denen Sie vertrauliche Daten haben, z. B. Anmeldeinformationen, Geheime Schlüssel, Zugriffstoken, API-Schlüssel und andere ähnliche Informationen, stellen Sie sicher, dass Sie ein Tool verwenden, das Ihre Daten mit den erforderlichen Sicherheitsfeatures schützt. Das Tool sollte offline oder lokal arbeiten und muss sich nicht bei einem Onlinekonto anmelden oder Daten mit der Cloud synchronisieren. Wenn Sie ein Tool mit diesen Merkmalen verwenden, verringern Sie das Risiko, vertrauliche Daten für die Öffentlichkeit verfügbar zu machen.

Überprüfen der Erweiterungsinstallation

1. Um sicherzustellen, dass die Erweiterung und alle Abhängigkeiten ordnungsgemäß installiert sind, laden Sie Visual Studio Code neu, oder starten Sie sie neu.

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. Stellen Sie sicher, dass "Updates automatisch überprüfen" aktiviert ist und dass " Automatische Aktualisierung " auf "Alle Erweiterungen" festgelegt ist.

3. Vergewissern Sie sich, dass die Azure Logic Apps Standard: Project-Runtime-Einstellung auf die richtige Version festgelegt ist:

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

   2. Stellen Sie sicher, dass die Project-Runtime auf Version ~4 festgelegt ist, z. B.:

      

      Hinweis

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

Herstellen einer Verbindung mit Ihrem Azure-Konto

Wenn Sie noch nicht mit Ihrem Azure-Konto verbunden sind, führen Sie die folgenden Schritte aus, um eine Verbindung herzustellen:

1. Wählen Sie in Visual Studio Code auf der Aktivitätsleiste das Azure-Symbol aus, um den Azure-Bereich zu öffnen.

   

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

   

   Nachdem Sie sich angemeldet haben, zeigt der Azure-Bereich die Azure-Abonnements an, die Ihrem Azure-Konto zugeordnet sind. 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.

      

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

   2. Wenn die Liste der aktualisierten Abonnements angezeigt wird, wählen Sie die gewünschten Abonnements aus, und stellen Sie sicher, dass Sie "OK" auswählen.

Erstellen eines lokalen Arbeitsbereichs

Für ein Logik-App-Projekt ist immer ein Arbeitsbereich erforderlich. Bevor Sie Ihre Logik-App erstellen können, müssen Sie also einen Arbeitsbereich erstellen, in dem Sie ihr Logik-App-Projekt beibehalten. Sie verwenden diesen Arbeitsbereich und dieses Projekt später, um Ihre Logik-App aus Visual Studio Code in Ihrer Bereitstellungsumgebung zu verwalten, auszuführen und bereitzustellen. Das zugrunde liegende Projekt ähnelt stark einem Azure Functions-Projekt, das auch als Funktions-App-Projekt bezeichnet wird.

1. Erstellen Sie auf Ihrem Computer einen leeren lokalen Ordner, der später für den Arbeitsbereich und das Projekt verwendet werden soll.

   In diesem Beispiel wird ein Ordner mit dem Namen fabrikam-workflows erstellt.

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

3. Wählen Sie im Azure-Fenster in der Symbolleiste des Arbeitsbereichs im Menü Azure Logic Apps die Option Neue Logik-App-Arbeitsbereich erstellen aus.

   

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

4. Wechseln Sie im Fenster "Ordner auswählen" zu dem Speicherort, an dem Sie Ihren Ordner erstellt haben, wählen Sie den Ordner aus, und wählen Sie "Auswählen" aus (wählen Sie den Ordner nicht doppelt aus).

   

   Auf der Visual Studio Code-Symbolleiste wird eine Eingabeaufforderung angezeigt, mit der Sie Ihren Arbeitsbereich benennen können.

5. Geben Sie für die Angabe eines Arbeitsbereichsnamens den zu verwendenden Arbeitsbereichsnamen ein.

   In diesem Beispiel werden Fabrikam-Workflows verwendet.

   

Erstellen Sie als Nächstes Ihr Logik-App-Projekt.

Erstellen Ihres Logik-App-Projekts

Nachdem Sie den erforderlichen Arbeitsbereich erstellt haben, folgen Sie den Anweisungen zum Erstellen Ihres Projekts.

1. Wählen Sie für Ihre Projektvorlage die Logik-App aus. Geben Sie einen zu verwendenden Projektnamen ein.

   In diesem Beispiel werden Fabrikam-Workflows verwendet.

   

2. Wählen Sie für Ihre Workflowvorlage basierend auf Ihrem Szenario entweder "Zustandsbehafteter Workflow " oder " Statusloser Workflow" aus. Geben Sie einen zu verwendenden Workflownamen ein.

   In diesem Beispiel wird zustandsbehafteter Workflow ausgewählt, der Workflowverlauf, Eingaben und Ausgaben speichert und "Stateful-Workflow" als Namen verwendet.

   Zustandslose Workflows speichern diese Daten nicht und unterstützen derzeit nur verwaltete Connectoraktionen und keine 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.

   Hinweis

   Wenn Sie einen Fehler namens "azureLogicAppsStandard.createNewProject " mit der Fehlermeldung erhalten, können Sie nicht in die Arbeitsbereichseinstellungen schreiben, da azureFunctions.suppressProject keine registrierte Konfiguration ist, versuchen Sie, die Azure Functions-Erweiterung für Visual Studio Code entweder direkt aus dem Visual Studio Marketplace oder aus Visual Studio Code neu zu installieren.

3. Wählen Sie nun aus, ob Sie Ihr Projekt im aktuellen Visual Studio Code-Fenster oder in einem neuen Fenster öffnen möchten. Wählen Sie "Im aktuellen Fenster öffnen" oder "In neuem Fenster öffnen" aus, basierend auf Ihrer Einstellung.

   Der Explorer-Bereich wird geöffnet, um Ihren Arbeitsbereich, Ihr Projekt und die automatisch geöffnete workflow.json Datei anzuzeigen. Diese Datei ist im Ordner "Stateful-Workflow " vorhanden und speichert die zugrunde liegende JSON-Definition für den Workflow, den Sie im Designer erstellen. Informationen zur Projektstruktur finden Sie unter Standardlogik-App-Projektstruktur.

   Außerdem erhalten Sie die Aufforderung, „freigegebene“, mehrinstanzenfähige, in Azure gehostete Connectors zu aktivieren, z. B.:

   

4. Um alle verwalteten „freigegebenen“ Connectors zu aktivieren, die in mehrinstanzenfähigem Azure ausgeführt werden, damit Sie diese in Ihrem Workflow anzeigen und verwenden können, wählen Sie Connectors aus Azure verwenden aus.

   Hinweis

   Wenn Sie diese Option nicht auswählen und später versuchen, einen verwalteten Connectorvorgang hinzuzufügen, wenn Sie Ihren Workflow erstellen, können Sie den Vorgang nicht fortsetzen, da im Bereich "Vorgangsinformationen" ein sich drehender Kreis angezeigt wird, der nicht beendet wird.

5. Wählen Sie für die Azure-Ressourcengruppe " Neue Ressourcengruppe erstellen" aus. Geben Sie den zu verwendenden Ressourcengruppennamen ein.

   In diesem Beispiel wird Fabrikam-Workflows-RG verwendet.

6. Wählen Sie für das Abonnement das Azure-Abonnement aus, das mit Ihrem Logik-App-Projekt verwendet werden soll.

7. Wählen Sie für den Speicherort, an dem Ihre Gruppe und Ressourcen erstellt werden sollen, die Azure-Region aus.

   In diesem Beispiel wird USA, Westen-Mitte verwendet.

8. Wenn Ihr Projekt ein anderes Setup für die Entwicklung benötigt oder Unterstützende Artefakte benötigt, um Ihren Workflow zu erstellen, lesen Sie die folgenden Szenarien und verwandten Aufgaben:

   Szenario	Aufgabe
   Lokales Ausführen von webhook-basierten Triggern oder Aktionen.	Richten Sie die Weiterleitung für Webhook-Rückruf-URLs ein.
   Einrichten des Ausführungsverlauf statusfreier Workflows	Aktivieren des Ausführungsverlaufs für statuslose Workflows.
   Fügen Sie Artefakte und Abhängigkeiten hinzu, z. B. Karten, Schemas und Assemblys.	Fügen Sie Artefakte und Abhängigkeiten hinzu.
   Arbeiten mit einem NuGet-basierten (.NET)-Projekt	Verwandeln Sie ein projekt mit Erweiterungen (Node.js) in ein NuGet-Paket-basiertes (.NET)-Projekt. Hinweis: Informationen zum Konvertieren eines Erweiterungsbündel-basierten Projekts (Node.js), das Sie erstellt haben, bevor Assemblys unterstützt wurden, finden Sie unter "Migrieren von NuGet-paketbasierten Projekten zur Verwendung von Assemblys im Lib-Ordner".
   Erstellen von eigenen integrierten Connectors	1. Konvertieren Sie ein Erweiterungspaket-basiertes (Node.js)-Projekt in ein NuGet-paketbasiertes (.NET)-Projekt . 2. Aktivieren der Erstellung integrierter Connectors

Öffnen Sie nun den Workflow-Designer.

Öffnen des Workflow-Designers

Nachdem Ihr Projekt im Explorer-Bereich geöffnet wurde, öffnen Sie den Designer, damit Sie Ihren Workflow erstellen können.

Wählen Sie im Kontextmenü der Datei workflow.json die Option Designer öffnen aus.

Hinweis

Nachdem Sie diese Option ausgewählt haben, erhalten Sie möglicherweise die Meldung, dass der Start ein paar Sekunden dauert, da die Workflowentwurfszeit-API gestartet wurde. Sie können diese Meldung ignorieren oder OK auswählen.

Visual Studio Code öffnet den Workflow-Designer und zeigt die Eingabeaufforderung zum Hinzufügen einer Triggeraufforderung an, z. B.:

Hinweis

Falls der Designer nicht geöffnet wird, nutzen Sie die Informationen im Abschnitt Designer wird nicht geöffnet zur Problembehandlung.

Fügen Sie als Nächstes einen Trigger und Aktionen hinzu, um Ihren Workflow zu erstellen.

Hinzufügen eines Triggers und einer Aktion

Um Ihren Workflow zu erstellen, starten Sie Den Workflow mit einem Trigger, und fügen Sie zunächst eine einzelne Aktion hinzu. Auf diese Weise können Sie Ihren Workflow testen, bevor Sie die nächste Aktion hinzufügen. Der Beispielworkflow verwendet die folgenden Trigger und Aktionen, die gemeinsam als Vorgänge bezeichnet werden:

Connector oder Vorgangsgruppe	Vorgangsname	Vorgangsart	BESCHREIBUNG
Anforderung	Bei Eingang einer HTTP-Anforderung	Trigger (integriert)	Erstellt eine Endpunkt-URL für den Workflow, um eingehende Anrufe oder Anforderungen von anderen Diensten oder Logik-App-Workflows zu empfangen. Weitere Informationen finden Sie unter Empfangen und Beantworten eingehender HTTPs-Aufrufe an Workflows.
Office 365 Outlook	E-Mail senden	Aktion (verwaltet)	Senden Sie eine E-Mail mit einem Office 365 Outlook-Konto. Um die Schritte in diesem Leitfaden auszuführen, benötigen Sie ein Office 365 Outlook-E-Mail-Konto. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Office 365 Outlook aus Azure Logic Apps. Hinweis: Wenn Sie über ein E-Mail-Konto verfügen, das von einem anderen Connector unterstützt wird, können Sie diesen Connector verwenden, die Benutzererfahrung dieses Connectors unterscheidet sich jedoch von den Schritten in diesem Beispiel.
Anforderung	Antwort	Aktion (integriert)	Senden Sie eine Antwort und geben Sie die Daten an den Anrufer zurück. Weitere Informationen finden Sie unter Hinzufügen einer Antwortaktion.

Hinzufügen des Anforderungstriggers

1. Wählen Sie im Workflow-Designer " Trigger hinzufügen" aus, falls noch nicht ausgewählt.

   Der Bereich Trigger hinzufügen wird geöffnet und zeigt einen Katalog an, in dem Sie aus verfügbaren Connectors und Vorgangsgruppen auswählen können, z. B.:

   

2. Führen Sie im Bereich "Trigger hinzufügen" die folgenden allgemeinen Schritte aus, um den Anforderungstrigger namens "Wenn eine HTTP-Anforderung empfangen wird" hinzuzufügen.

   Im folgenden Beispiel wird die integrierte Option ausgewählt, sodass nur die integrierten Trigger angezeigt werden:

   

   Wenn der Trigger im Designer angezeigt wird, wird der Triggerinformationsbereich geöffnet und zeigt die Parameter, Einstellungen und andere verwandte Aufgaben des Triggers an.

   

   Hinweis

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

3. Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.

Hinzufügen der Office 365 Outlook-Aktion

1. Führen Sie im Designer unter dem Anforderungstriggerdie folgenden allgemeinen Schritte aus, um die Office 365Outlook-Aktion namens "E-Mail senden" (V2) hinzuzufügen.

   Wenn die Aktion nicht in den ersten Ergebnissen angezeigt wird, wählen Sie neben dem Connectornamen " Weitere Informationen anzeigen" aus, z. B.:

   

2. Wenn der Authentifizierungsbereich der Aktion angezeigt wird, wählen Sie "Anmelden " aus, um eine Verbindung mit Ihrem E-Mail-Konto zu erstellen.

   

3. Folgen Sie den nachfolgenden Eingabeaufforderungen, um Ihre Anmeldeinformationen zu authentifizieren, 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.

   1. Wenn die Microsoft-Authentifizierungsaufforderung angezeigt wird, wählen Sie Ihr Benutzerkonto für Office 365 Outlook aus. Wählen Sie auf der daraufhin geöffneten Bestätigungsseite " Zugriff zulassen" aus.

   2. Wenn Sie von Azure Logic Apps aufgefordert werden, einen Visual Studio Code-Link zu öffnen, wählen Sie Öffnen aus.

      

   3. Wenn Visual Studio Code Sie auffordert, die Erweiterung für die Microsoft Azure Tools zu öffnen, wählen Sie "Öffnen" aus.

      

   Nachdem Visual Studio Code Ihre Verbindung erstellt hat, zeigen einige Connectors die Meldung an, dass die Verbindung für <n> Tage gültig sein wird. Dieses Zeitlimit gilt nur für die Dauer der Erstellung des Logik-App-Workflows in Visual Studio Code. Nach der Bereitstellung gilt das Limit nicht mehr, da sich Ihre Logik-App zur Runtime 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.

4. Geben Sie im Daraufhin geöffneten Bereich " E-Mail-Informationen senden " auf der Registerkarte "Parameter " die erforderlichen Informationen für die Aktion an.

   Hinweis

   Wenn der Aktionsinformationsbereich nicht automatisch geöffnet wurde, wählen Sie die Aktion "E-Mail senden " im Designer aus.

   Eigentum	Erforderlich	Wert	BESCHREIBUNG
   bis	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 sophia.owen@fabrikam.com verwendet.
   Betreff	Ja	Eine E-Mail aus Ihrem Beispielworkflow	der E-Mail-Betreff
   Körper	Ja	Grüße aus Ihrem Beispiel-Workflow!	Der Textinhalt der E-Mail

   Beispiel:

   

5. Speichern Sie den Workflow. Wählen Sie im Designer Speichern aus.

Standardlogik-App-Projektstruktur

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 kann Ihr Projekt geringfügig unterschiedliche Ordner oder Dateien enthalten. Beispielsweise verfügt ein paketbasiertes Nuget-Projekt über einen .bin Ordner, der Pakete und andere Bibliotheksdateien enthält. Ein paketbasiertes Erweiterungsprojekt enthält diesen .bin Ordner nicht.

Für einige Szenarien ist ein paketbasiertes NuGet-Projekt erforderlich, 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.

Das standardmäßige paketbasierte Erweiterungsprojekt verfügt über eine Ordner- und Dateistruktur, die dem folgenden Beispiel ähnelt:

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

Auf der Stammebene Ihres Projekts finden Sie die folgenden Ordner und Dateien zusammen 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 die folgenden Ordner: - Karten: Enthält Karten, die für XML-Transformationsvorgänge verwendet werden sollen. - Schemas: Enthält Schemas , die für XML-Überprüfungsvorgänge verwendet werden sollen. - Regeln: Artefakte für Geschäftsregeln in regelbasierten Modulprojekten.
befreien	Ordner	Enthält unterstützte Assemblys, die ihre Logik-App verwenden oder referenzieren kann. Sie können diese Assemblys in Visual Studio Code in Ihr Projekt hochladen, müssen sie jedoch bestimmten Ordnern in Ihrem Projekt hinzufügen. Dieser Ordner enthält beispielsweise die folgenden Ordner: - builtinOperationSdks: Enthält die Ordner JAR für Java-Assemblys und net472 für .NET Framework-Assemblys. - custom: Enthält benutzerdefinierte .NET Framework-Assemblys. Weitere Informationen zu unterstützten Assemblytypen und deren Speicherort in Ihrem Projekt finden Sie unter Hinzufügen von Assemblys zu Ihrem Projekt.
< 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-Gestaltungszeit	Ordner	Enthält Entwicklungsumgebungsbezogene Einstellungsdateien.
.funcignore	Datei	Enthält Informationen zu Ihren installierten Azure Functions Core Tools.
connections.json	Datei	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	Datei	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. Referenzinformationen finden Sie unter Bearbeiten von App-Einstellungen und Hosteinstellungen. 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	Datei	Enthält App-Einstellungen, Verbindungszeichenfolgen und andere Einstellungen, die Ihre Workflows bei der lokalen Ausführung verwenden. Diese Einstellungen und Werte gelten 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 ihre lokalen Entwicklungstools für die appSettings Werte verwenden. 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. Diese Datei enthält auch App-Einstellungen, die Ihre Logik-App benötigt, damit sie richtig funktionieren kann. Referenzinformationen finden Sie unter Bearbeiten von App-Einstellungen und Hosteinstellungen.

Weitere Setupaufgaben für die Einrichtung

Nachdem Sie Ihr Projekt erstellt haben, verfügen Sie möglicherweise noch über weitere Setupaufgaben, um bestimmte lokale Entwicklungsszenarien beim Erstellen, Ausführen und Bereitstellen von Standardlogik-Apps mit Visual Studio Code zu unterstützen. In den folgenden Abschnitten werden die Aufgaben für diese Szenarien beschrieben.

Aktivieren von lokal ausgeführten Webhooks

Ein Webhook-Vorgang ist ein Workflowtrigger oder eine Aktion, die wartet, bis ein Ereignis ausgeführt wird, bevor der Vorgang ausgeführt werden kann. Insbesondere wartet der Webhook-Vorgang, bis eine HTTPS-Anforderung von einem Aufruferdienst oder -workflow empfangen wird, bevor der Vorgang fortgesetzt werden kann. Webhooks umfassen z. B. Vorgänge wie den Anforderungstrigger und den HTTP + Webhook-Trigger .

Im Azure-Portal abonniert Azure Logic Apps Runtime automatisch den Webhook für den Dienst oder Workflow, von dem der Anruf ausgeht. Die Runtime registriert eine Rückruf-URL für den Webhook mit dem Aufruferdienst oder -workflow. Der Webhook wartet dann, bis der Aufrufer die Anforderung mithilfe der Rückruf-URL sendet.

In Visual Studio Code müssen Sie jedoch einige Setupaufgaben ausführen, damit Webhook-Vorgänge ordnungsgemäß funktionieren. In diesem Szenario verwendet die Rückruf-URL Ihren localhost-Server (http://localhost:7071/...), der privat ist, sodass der Aufrufer keine direkte Anforderung über das Internet an diese URL senden kann.

Für Webhook-Vorgänge in lokal ausgeführten Workflows müssen Sie eine öffentliche URL einrichten, die Ihren localhost-Server verfügbar macht und Aufrufe vom Aufrufer sicher an die Rü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 Anrufweiterleitung mit ngrok

1. Wechseln Sie zur Website ngrok. Registrieren Sie sich für ein neues Konto, oder melden Sie sich bei Ihrem Konto an, wenn Sie bereits über ein Konto verfügen.

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. Verbinden Sie den ngrok-Client mit Ihrem ngrok-Konto , indem Sie den folgenden Befehl ausführen:

   ngrok authtoken <your-authentication-token>

   Weitere Informationen finden Sie unter Schritt 2: Connect your account (Stellen Sie eine Verbindung mit Ihrem Konto her).

6. Öffnen Sie den HTTP-Tunnel zum localhost-Port 7071, indem Sie den folgenden Befehl ausführen:

   ngrok http 7071

   Weitere Informationen finden Sie unter Schritt 3: Fire it up (Starten Sie es).

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 den Webhook-Vorgang hinzu, den Sie in Ihrem Workflow verwenden möchten.

   Dieses Beispiel wird mit dem HTTP + Webhook-Trigger fortgesetzt.

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 abgeschlossen haben, wird die Eingabeaufforderung nicht mehr für nachfolgende Webhook-Vorgänge angezeigt, die Sie möglicherweise hinzufügen.

   Damit die Eingabeaufforderung auf der Stammebene Ihres Projekts angezeigt wird, öffnen Sie das Kontextmenü der Datei local.settings.json, und wählen Sie 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. Values Im Objekt wird die Eigenschaft namens Workflows.WebhookRedirectHostUri jetzt angezeigt und auf die Weiterleitungs-URL festgelegt, z. B.:

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

   Weitere Informationen zu diesen App-Einstellungen finden Sie unter Bearbeiten von App-Einstellungen und Hosteinstellungen für Standardlogik-Apps.

Wenn Sie zum ersten Mal eine lokale Debugsitzung starten oder den Workflow ohne Debugging ausführen, registriert die Azure Logic Apps-Laufzeit den Workflow beim Aufrufer und abonniert den Aufruferendpunkt, der Webhook-Vorgänge benachrichtigt. 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 einen Workflow beenden, der lokal Webhook-Vorgänge 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"

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. Öffnen Sie in Ihrem Visual Studio Code-Projekt auf Stammordnerebene die Datei local.settings.json.

2. Fügen Sie die Eigenschaft Workflows.<workflow-name>.operationOptions hinzu, und legen Sie deren Wert auf WithStatelessRunHistory fest, z. B.:

   Fenster

   {
      "IsEncrypted": false,
      "Values": {
         "AzureWebJobsStorage": "UseDevelopmentStorage=true",
         "FUNCTIONS_WORKER_RUNTIME": "dotnet",
         "Workflows.<workflow-name>.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.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
      }
   }
   

3. Öffnen Sie im Projektordner workflow-designtime die Datei local.settings.json, und nehmen Sie die gleiche Änderung vor.

4. Um den Ausführungsverlauf zu deaktivieren, wenn Sie fertig sind, legen Sie entweder die Eigenschaft Workflows.<workflow-name>.OperationOptions auf None fest oder löschen die Eigenschaft und ihren Wert.

Hinzufügen von Artefakten und Abhängigkeiten zu Ihrem Projekt

In bestimmten Szenarien kann Ihr Workflow Vorgänge enthalten, die Abhängigkeiten wie Assemblys oder Artefakte wie Karten, Schemas oder Regeln erfordern. In Visual Studio Code können Sie diese Elemente den entsprechenden Ordnern in Ihrem Projekt hinzufügen, z. B.:

Gegenstand	Dateityp	BESCHREIBUNG
Landkarten	XSLT	Weitere Informationen finden Sie unter Hinzufügen von Karten für Transformationen in Workflows.
Schemata	XSD	Weitere Informationen finden Sie unter Hinzufügen von Schemas zur Überprüfung.
Regeln	.xml	Weitere Informationen finden Sie unter Erstellen eines Azure Logic Apps Rules Engine-Projekts.
Assemblys	- .dll (.NET Framework oder .NET 8) - .jar (Java)	Eine Standardlogik-App-Ressource kann bestimmte Assemblytypen verwenden oder referenzieren, die Sie in Visual Studio Code in Ihr Projekt hochladen können. Sie müssen sie jedoch bestimmten Projektordnern hinzufügen. Weitere Informationen finden Sie unter Hinzufügen von referenzierten Assemblys. Hinweis: Wenn Sie ein NuGet-Paket-basiertes (.NET) Logik-App-Projekt haben, das vor der Verfügbarkeit der Unterstützung für Assemblys erstellt wurde, lesen Sie Migrieren Sie NuGet-Paket-basierte Projekte, um Assemblys im lib-Ordner zu verwenden.

Konvertieren Ihres Projekts in NuGet-paketbasierte (.NET)

Standardmäßig erstellt Visual Studio Code Ihr Logik-App-Projekt als erweiterungsbasiertes Bündel (Node.js)-Projekt. Wenn Sie ein Projekt benötigen, das nuGet-paketbasiert (.NET) ist, um beispielsweise eigene integrierte Connectors zu erstellen, müssen Sie Ihr Standardprojekt in ein NuGet-paketbasiertes (.NET)-Projekt konvertieren.

Von Bedeutung

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

1. Bewegen Sie im Explorer-Bereich den Mauszeiger über einen beliebigen leeren Bereich unter den Ordnern und Dateien des Projekts, öffnen Sie das Kontextmenü, und wählen Sie "In NuGet-basierte Logik-App-Projekt konvertieren" aus.

   

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

Migrieren von paketbasierten NuGet-Projekten zur Verwendung von Assemblys im Ordner "lib"

Von Bedeutung

Diese Aufgabe ist nur für NuGet-paketbasierte (.NET)-Logik-App-Projekte erforderlich, die erstellt wurden, bevor die Assemblyunterstützung verfügbar wurde.

Wenn Sie Ihr Logik-App-Projekt erstellt haben, als die Unterstützung für Assemblys für Logik-App-Standardworkflows nicht verfügbar war, können Sie die folgenden Zeilen zu Ihrer Datei <project-name>.csproj hinzufügen, um mit Projekten zu arbeiten, die Assemblys verwenden:

  <ItemGroup>
    <LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
  </ItemGroup>
  <Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
    <Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
  </Target>

Von Bedeutung

Aktualisieren Sie für ein Projekt, das unter Linux oder macOS ausgeführt wird, die Verzeichnistrennlinie. Überprüfen Sie beispielsweise die folgende Abbildung, die den vorherigen Code zeigt, der der <Datei "project-name.csproj>" hinzugefügt wurde:

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. Führen Sie die folgenden Schritte aus, um diese Connectors zu erstellen:

1. Falls noch nicht geschehen, konvertieren Sie Ihr Erweiterungspaket-basiertes Projekt (Node.js) in ein NuGet-paketbasiertes (.NET)-Projekt.

2. Überprüfen und befolgen Sie die Schritte im Artikel Azure Logic Apps läuft überall: Erweiterbarkeit integrierter Connectors.

Lokales Ausführen, Debuggen und Testen von Workflows

In den folgenden Abschnitten wird gezeigt, wie Sie Haltepunkte festlegen und eine Debugsitzung starten können, um Den Workflow lokal auszuführen und zu testen.

Festlegen von Haltepunkten für das 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 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).

Debuggen und Testen des Workflows

Führen Sie zum Testen Ihres Workflows die folgenden Schritte aus, um eine Debugsitzung zu starten und die URL für den Endpunkt zu finden, der durch den Anforderung-Trigger erstellt wird. Sie benötigen diese URL, damit Sie später eine Anforderung an diesen Endpunkt senden können.

1. Wenn Sie über einen zustandslosen Workflow verfügen, aktivieren Sie den Ausführungsverlauf für den Workflow , um das Debuggen zu vereinfachen.

2. Wählen Sie im Menü "Ausführen " die Option " 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, der vom Anforderungstrigger erstellt wurde.

   1. Öffnen Sie den Explorer-Bereich erneut, um Ihr Projekt anzuzeigen.

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

      

   3. Kopieren Und speichern Sie die Rückruf-URL, die ähnlich der folgenden URL für den Trigger für den Empfang einer HTTP-Anforderung in diesem Beispiel aussieht:

      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>

      

4. Um die Rückruf-URL zu testen und den Workflow auszulösen, senden Sie eine HTTP-Anforderung an die URL, einschließlich der Methode, die der Trigger erwartet, mithilfe Ihres HTTP-Anforderungstools und der zugehörigen Anweisungen.

   In diesem Beispiel wird die GET-Methode mit der kopierten URL verwendet, die wie im folgenden Beispiel aussieht:

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

   Wenn der Trigger ausgelöst wird, wird der Beispielworkflow ausgeführt und sendet eine E-Mail, die in etwa dem folgenden Beispiel entspricht:

   

5. Kehren Sie in Visual Studio Code zur Übersichtsseite Ihres Workflows zurück. Überprüfen Sie unter "Ausführungsverlauf" den Status der Workflowausführung.

   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 übersprungen werden, erfolgt keine Ausführung.

   

   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
   Abgebrochen	Die Ausführung wurde aufgrund externer Probleme beendet oder nicht abgeschlossen (beispielsweise wegen eines Systemausfalls oder abgelaufenen Azure-Abonnements).
   abgebrochene	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.
   Ausführen von	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.
   Zeitlimit überschritten	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. Anmerkung: 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. Wenn Sie den Status, eingaben und Ausgaben für einen bestimmten Workflow anzeigen möchten, wählen Sie einen der folgenden Schritte aus:

   • Wählen Sie die Workflowausführungs-ID in der Spalte Bezeichner aus.

   • Öffnen Sie neben der Spalte Dauer das Menü mit den Auslassungspunkten (...) für eine Workflowausführung, und wählen Sie Ausführung anzeigen aus, z. B.:

     

   Visual Studio Code öffnet die Ansicht "Ausführungsdetails" und zeigt den Status für jeden Schritt im Workflow-Ablauf an.

   

   Hinweis

   Wenn bei einer Ausführung ein Fehler aufgetreten ist und ein Schritt in der Ansicht der Ausführungsdetails die Fehlermeldung "400 Ungültige Anforderung" anzeigt, kann dieses Problem durch einen längeren Triggernamen oder Aktionsnamen verursacht werden, der dazu führt, dass der zugrunde liegende Uniform Resource Identifier (URI) den Standardzeichengrenzwert ü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
   Abgebrochen	Die Aktion wurde aufgrund externer Probleme beendet oder nicht fertig gestellt, z. B. wegen eines Systemausfalls oder abgelaufenen Azure-Abonnements.
   abgebrochene	Die Aktion wurde ausgeführt, aber es wurde eine Abbruchanforderung empfangen.
   Fehler	Die Aktion ist fehlgeschlagen.
   Ausführen von	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.
   Zeitlimit überschritten	Die Aktion wurde aufgrund des Timeoutgrenzwerts beendet, der durch die Einstellungen dieser Aktion gesteuert wird.
   Wartet	Gilt für eine Webhookaktion, die auf eine eingehende Anforderung eines Aufrufers wartet.

7. Um die Eingaben und Ausgaben für jeden Schritt anzuzeigen, wählen Sie den gewünschten Schritt aus, z. B.:

   

   Um die rohen Eingaben und Ausgaben anzuzeigen, wählen Sie " Roheingaben anzeigen " oder "Rohausgabe anzeigen" aus.

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

Zurückgeben einer Antwort

Wenn Sie einen Workflow haben, der mit dem Auslösen einer HTTP-Anforderung beginnt, kann Ihr Workflow eine Antwort an den Aufrufer zurückgeben, der die ursprüngliche Anforderung mithilfe der Anforderungsaktion namens "Antwort" gesendet hat.

1. Führen Sie im Workflow-Designer unter der Aktion "E-Mail senden" die folgenden allgemeinen Schritte aus, um die Anforderungsaktion namens "Antwort" hinzuzufügen.

   

2. Geben Sie im Infobereich der Antwortaktion auf der Registerkarte "Parameter " die erforderlichen Informationen für die Antwort auf den Aufrufer an.

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

   1. Klicken Sie für den Parameter Text in das Bearbeitungsfeld, und wählen Sie das Blitzsymbol aus, wodurch die Liste mit dynamischen Inhalten geöffnet wird. Diese Liste enthält die verfügbaren Ausgabewerte aus den vorhergehenden Triggern und Aktionen im Workflow.

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

      

      Wenn Sie fertig sind, wird die Eigenschaft Text der Aktion Antwort auf den Ausgabewert Text für die Aktion E-Mail senden festgelegt, zum Beispiel:

      Der Screenshot zeigt den Workflow-Designer, den Antwortbereich und den Body-Parameter, der auf die Body-Ausgabe der Aktion 'Senden einer E-Mail' festgelegt ist.

3. Speichern Sie den Workflow.

Testen Sie Ihren Workflow erneut

Um Ihre Updates zu testen, können Sie den Debugger erneut ausführen und eine weitere Anforderung senden, die Ihren Workflow auslöst, ähnlich wie die Schritte in "Ausführen", "Debuggen" und "Testworkflows lokal".

1. Wählen Sie auf der Visual Studio Code-Symbolleiste im Menü "Ausführen " die Option "Debuggen starten " (F5) aus.

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

3. Überprüfen Sie auf der Übersichtsseite des Workflows unter "Ausführungsverlauf" den Status für die letzte Ausführung, und öffnen Sie die Ansicht "Ausführungsdetails".

   Hier sehen Sie beispielsweise den Schritt-für-Schritt-Status für eine Ausführung, nachdem der Beispielworkflow mit der Antwortaktion aktualisiert wurde.

   

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

Vorbereiten der Bereitstellung

Bevor Sie Ihre Standardlogik-App im Azure-Portal bereitstellen, lesen Sie diesen Abschnitt für alle Vorbereitungen, die Sie möglicherweise vornehmen müssen.

Einrichten des Firewallzugriffs

Wenn Ihre Umgebung strenge Netzwerkanforderungen oder Firewalls aufweist, die den Datenverkehr einschränken, müssen Sie Berechtigungen für alle Verbindungen einrichten, die von Azure verwalteten, gehosteten und freigegebenen Connectors erstellt und in Ihrem Workflow verwendet werden.

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 local.settings.json Datei.

2. Suchen Sie für jede von Ihnen erstellte Verbindung die Eigenschaft namens <connection-name>-ConnectionRuntimeUrl, die die folgende Syntax verwendet:

   "<connection-name>-ConnectionRuntimeUrl": <connection-runtime-URL>

   Angenommen, Sie haben eine Beispieldatei local.settings.json , die diese Verbindungen enthält: eine Office 365-Verbindung und eine AS2-Verbindung. Diese Verbindungen verwenden die folgenden jeweiligen Beispielwerte für die <connection-name>-ConnectionRuntimeUrl Eigenschaften:

   • Office 365: "office365-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"

   • AS2: "as2-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

   Das Beispiel local.settings.json Datei ähnelt der folgenden Version:

   {
      "IsEncrypted": false,
      "Values": {
         "AzureWebJobsStorage": "UseDevelopmentStorage=true",
         "FUNCTIONS_WORKER_RUNTIME": "node",
         "APP_KIND": "workflowapp",
         "ProjectDirectoryPath": "c:\\Users\\<local-username>\\Desktop\\Visual Studio Code projects\\Azure Logic Apps\fabrikam-workflows\\Fabrikam-Workflows\\Fabrikam-Workflows",
         "WORKFLOWS_TENANT_ID": "<Microsoft-Entra-tenant-ID>",
         "WORKFLOWS_SUBSCRIPTION_ID": "<Azure-subscription-ID>",
         "WORKFLOWS_RESOURCE_GROUP_NAME": "Fabrikam-Workflows-RG",
         "WORKFLOWS_LOCATION_NAME": "westcentralus",
         "WORKFLOWS_MANAGEMENT_BASE_URI": "https://management.azure.com/",
         "as2-connectionKey": "<connection-key>",
         "as2-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
         "office365-connectionKey": "<connection-key>",
         "office365-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
      }
   }
   

3. Kopieren Und speichern Sie diese Verbindungslaufzeit-URLs an einem sicheren Ort, damit Sie Ihre Firewall mit diesen Informationen einrichten können.

4. Wenn Sie fertig sind, richten Sie Ihre Firewall mithilfe der gespeicherten URLs ein. Weitere Informationen finden Sie in der folgenden Dokumentation:

   • Übersicht über die Azure Firewall Manager-Richtlinie
   • Bereitstellen und Konfigurieren von Azure Firewall mithilfe des Azure-Portals – klassisch.

In Azure bereitstellen

Um Ihre Standardlogik-App aus Visual Studio Code bereitzustellen, können Sie Ihr Projekt direkt in Azure veröffentlichen. Sie können Ihre Logik-App als neue Ressource veröffentlichen, wodurch automatisch alle erforderlichen Ressourcen erstellt werden, z. B. ein Azure-Speicherkonto, ähnlich den Funktions-App-Anforderungen. Alternativ können Sie Ihre Logik-App in einer zuvor bereitgestellten Standard-Logik-App-Ressource veröffentlichen, die die bereitgestellte Version außer Kraft setzt.

Eine Bereitstellung für die Standard-Logik-App-Ressource erfordert einen Hostingplan und einen Tarif, die Sie während der Bereitstellung auswählen. Weitere Informationen finden Sie unter Hostingpläne und Tarife.

Veröffentlichen in einer neuen Standard-Logik-App-Ressource

1. Bewegen Sie im Explorer-Bereich den Mauszeiger über einen beliebigen leeren Bereich unter den Ordnern und Dateien des Projekts, öffnen Sie das Kontextmenü, und wählen Sie "In Logik-App bereitstellen" aus.

   Sie müssen zwar keine Dateien für die Bereitstellung geöffnet haben, aber stellen Sie sicher, dass Sie alles gespeichert haben, was Sie bereitstellen möchten.

   

   Sie werden aufgefordert, die folgenden Optionen für die Zielressource der Standard-Logik-App anzugeben. Sie können eine neue Standardlogik-App erstellen oder eine vorhandene bereitgestellte Standardlogik-App in Azure auswählen:

   • Neue Logik-App (Standard) in Azure erstellen (schnell)
   • Neue Logik-App (Standard) in Azure Advanced erstellen
   • Wählen Sie aus zuvor bereitgestellten Standardlogik-App-Ressourcen aus, falls vorhanden.

2. Wählen Sie für die Bereitstellungsoptionen aus, ob eine vorhandene Ziellogik-App-Ressource erstellt oder verwendet werden soll.

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

   

3. Führen Sie die folgenden Schritte aus, um die neue Ziellogik-App-Ressource zu erstellen:

   1. Geben Sie einen global eindeutigen Namen für die Ziellogik-App ein.

      In diesem Beispiel wird Fabrikam-Workflows-App verwendet.

      

   2. Wählen Sie für den Speicherort, an dem Sie die Bereitstellung bereitstellen möchten, die Azure-Region aus.

      In diesem Beispiel wird USA, Westen-Mitte verwendet.

   3. Wählen Sie für den Hostingplan die folgenden Optionen aus:

      Hostingplan	BESCHREIBUNG
      Workflowstandard	Führen Sie die Bereitstellung als neue Standard-Logik-App-Ressource durch, die in Azure Logic Apps mit einem Mandanten gehostet wird.
      Hybrid	Stellen Sie eine Standard-Logik-App bereit, die auf Ihrer eigenen Infrastruktur gehostet wird. Hinweis: Bevor Sie diese Option auswählen, stellen Sie sicher, dass Sie die erforderliche Infrastruktur eingerichtet haben. Weitere Informationen finden Sie unter Einrichten Ihrer eigenen Infrastruktur für Standardlogik-Apps mithilfe der Hybridbereitstellung.

   4. Wählen Sie für den Windows App Service-Plan eine der folgenden Optionen aus:

      • Neuen App Service-Plan erstellen
      • Wählen Sie aus vorhandenen App Service-Plänen in der ausgewählten Azure-Region (nur windowsbasierte Pläne) aus, sofern vorhanden.

      In diesem Beispiel wird " Neuen App Service-Plan erstellen" ausgewählt.

   5. Geben Sie für den neuen Plan einen global eindeutigen Namen an, und wählen Sie ein Preisniveau aus.

      In diesem Beispiel wird Fabrikam-Workflows-App-Service-Plan verwendet und die WS1-Workflowstandardebene ausgewählt.

      Weitere Informationen finden Sie unter Hostingpläne und Tarife.

   6. Wählen Sie für die Zielressourcengruppe Azure dieselbe Ressourcengruppe wie Ihr Projekt aus, um optimale Leistung zu erzielen.

      In diesem Beispiel wird die zuvor erstellte Gruppe "Fabrikam-Workflows-RG" verwendet.

      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.

   7. Wenn das Azure-Speicherkonto mit Workflows verwendet werden soll, die das Speichern von Verlaufsinformationen für die Ausführung ermöglichen, wählen Sie aus den folgenden Optionen aus:

      • Neues Speicherkonto erstellen
      • Wählen Sie ggf. aus vorhandenen Azure-Speicherkonten aus.

      In diesem Beispiel wird " Neues Speicherkonto erstellen" ausgewählt.

   8. Geben Sie einen global eindeutigen Namen für das Speicherkonto ein. Sie können nur Kleinbuchstaben und Zahlen verwenden.

      In diesem Beispiel wird fabrikamstorageaccount<Nummer> verwendet.

   9. Wählen Sie für die Option zum Verwenden des SQL-Speichers in diesem Beispiel "Nein" aus.

      Wenn Sie bereits eine SQL-Datenbank für die Speicherung einrichten, indem Sie den SQL-Datenbankspeicher für Standardlogik-App-Workflows einrichten, können Sie "Ja" auswählen.

   10. Wählen Sie für die Ressource "Application Insights", die die Diagnoseprotokollierung und -ablaufverfolgung für Ihre Logik-App ermöglicht, aus den folgenden Optionen aus:

       • Neue Application Insights-Ressource erstellen
       • Jetzt überspringen. Sie können Application Insights nach der Bereitstellung einrichten.
       • Wählen Sie eine vorhandene Application Insights-Ressource aus, falls vorhanden.

       In diesem Beispiel wird "Jetzt überspringen" ausgewählt.

       Hinweis

       • Wenn Sie über eine Application Insights-Ressource verfügen, die Sie verwenden möchten, können Sie diese Ressource auswählen.

       • Wenn Sie momentan eine neue Application Insights-Ressource erstellen möchten, um die Diagnoseprotokollierung und -ablaufverfolgung zu aktivieren, lesen Sie "Application Insights während der Bereitstellung aktivieren".

       Weitere Informationen zu Application Insights finden Sie in der folgenden Dokumentation:

       • Application Insights-Übersicht
       • Erstellen und Konfigurieren von Application Insights-Ressourcen

       Nachdem Sie "Jetzt überspringen" oder eine vorhandene Application Insights-Ressource ausgewählt haben, zeigt Visual Studio Code eine Bestätigungsmeldung an, um die Bereitstellung zu starten. Außerdem empfiehlt die Meldung, dass Verbindungsressourcen für verwaltete Vorgänge in derselben Ressourcengruppe wie Ihre Logik-App-Ressource und -Workflows für die beste Leistung platziert werden. In Azure Logic Apps sind verwaltete Vorgangsverbindungen als einzelne Azure-Ressourcen vorhanden.

       

4. Wenn Sie bereit sind, wählen Sie in der Bestätigungsmeldung Bereitstellen aus.

   Visual Studio Code beginnt mit dem Erstellen und Bereitstellen der erforderlichen Ressourcen, um Ihre Logik-App in Azure zu veröffentlichen.

5. Um den Bereitstellungsprozess anzuzeigen und zu überwachen, wählen Sie im Menü "Ansicht " die Option "Ausgabe" aus.

6. Wählen Sie in der Symbolleiste des Ausgabefensters in der Bereichsliste Azure Logic Apps (Standard) aus.

   

   Wenn Visual Studio Code die Bereitstellung Ihrer Logik-App in Azure abgeschlossen hat, wird eine Meldung angezeigt, dass die Erstellung der Logik-App erfolgreich abgeschlossen wurde, z. B.:

   

   Ihre Logik-App-Ressource und Ihr Workflow sind jetzt live, aktiviert und werden in Azure ausgeführt.

Aktivieren von Application Insights während der Bereitstellung

Führen Sie die folgenden Schritte aus, um die Diagnoseprotokollierung und -ablaufverfolgung mit Application Insights während der Bereitstellung für Ihre Logik-App 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.

   1. 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>
         }
      }
      

   2. Überprüfen Sie, ob die Workflowtrigger- und Aktionsnamen in Ihrer Application Insights-Instanz korrekt angezeigt werden.

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

      2. Wählen Sie im Menü 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.

   3. Optional können Sie den Schweregrad der Ablaufverfolgungsdaten anpassen, die ihre Logik-App sammelt und an Ihre Application Insights-Instanz sendet.

      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 der folgenden Tabelle werden die Schweregrade und deren Ablaufverfolgungstypen beschrieben:

      Schweregrad	Ablaufverfolgungstyp
      Kritisch	Protokolle, die einen nicht behebbaren Fehler in Ihrem Logik-App-Workflow beschreiben.
      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.
      Informationen	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.
      Spur	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"
            }
         }
      }
      

Aufgaben nach der Bereitstellung

In den folgenden Abschnitten werden Aufgaben beschrieben, die ausgeführt werden müssen, nachdem die Logik-App die Bereitstellung abgeschlossen hat.

Bestätigen der Bereitstellung im Azure-Portal

Nachdem Sie Ihre Logik-App aus Visual Studio Code im Azure-Portal bereitgestellt haben, vergewissern Sie sich, dass Ihre Logik-App im Portal angezeigt wird. Azure-Ressourcen werden basierend auf ihrem Ressourcentyp im Portal organisiert und gruppiert. Führen Sie die folgenden Schritte aus, um nach Standard-Logik-Apps zu suchen:

1. Melden Sie sich mit Ihrem Azure-Konto beim Azure-Portal an.

2. Geben Sie im Azure-Titelsuchfeld Ihren Logik-App-Namen ein, der als Ergebnis im Abschnitt "Ressourcen " angezeigt werden soll. Wählen Sie Ihre Logik-App aus, um die Ressource zu öffnen.

   

3. Wählen Sie im Menü der Logik-App unter Workflows die Option Workflows aus.

4. Wählen Sie auf der Seite "Workflows " Ihren Workflow aus.

5. Wählen Sie im Workflowmenü unter Tools die Option Designer aus. Vergewissern Sie sich, dass der Workflow erwartungsgemäß angezeigt wird.

   

   Sie können jetzt Änderungen an diesem Workflow im Azure-Portal vornehmen.

6. Stellen Sie sicher, dass Sie die Überwachungsumgebung für Ihre bereitgestellte Logik-App aktivieren , damit Sie den Verlauf der Workflowausführung, Eingaben, Ausgaben und andere verwandte Informationen anzeigen können.

Aktivieren Sie die Überwachungsfunktionalität für die bereitgestellte Logik-App

Bevor Sie jeden Workflowausführungsverlauf, Eingaben, Ausgaben und zugehörige Informationen für eine bereitgestellte Standardlogik-App-Ressource mit der Überwachungsoberfläche im Azure-Portal überprüfen können, müssen Sie diese Erfahrung zuerst für die Logik-App-Ressource aktivieren.

1. Öffnen Sie im Azure-Portal die bereitgestellte Standardlogik-App-Ressource.

2. Wählen Sie im Ressourcenmenü unter APICORS 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.

   

Aktivieren oder Öffnen von Application Insights nach der Bereitstellung

Während der Workflowausführung sendet Ihr Logik-App-Workflow Telemetrie zusammen mit anderen Ereignissen. Sie können diese Telemetrie verwenden, um einen besseren Überblick darüber zu erhalten, wie gut Ihr Workflow ausgeführt wird und wie die Azure Logic Apps-Laufzeit funktioniert. Application Insights bietet Ihnen die Möglichkeit, Diagnoseprotokollierung, Ablaufverfolgung und Überwachung für Ihre Logik-App mithilfe von Echtzeit-Telemetrie (Livemetriken) zu aktivieren. Diese Funktion hilft Ihnen, Fehler und Leistungsprobleme einfacher zu untersuchen, wenn Sie die Telemetriedaten verwenden, um Probleme zu diagnostizieren, Warnungen einzurichten und Diagramme zu erstellen.

• Wenn Sie Application Insights noch nicht eingerichtet haben, können Sie diese Funktion im Azure-Portal nach der Logik-App-Bereitstellung aus Visual Studio Code aktivieren. Sie müssen über eine Application Insights-Ressource in Azure verfügen, aber Sie können diese Ressource vorab separat erstellen oder wenn Sie diese Funktion nach der Bereitstellung aktivieren.

• Wenn Sie Application Insights während der Bereitstellung über Visual Studio Code zuvor eingerichtet haben, können Sie ihre Application Insights-Ressource einfach über Ihre Logik-App im Azure-Portal öffnen.

Aktivieren von Application Insights für eine bereitgestellte Logik-App

1. Suchen und öffnen Sie ihre bereitgestellte Logik-App im Azure-Portal.

2. Wählen Sie im Menü "Logik-App" unter "Überwachung" die Option "Application Insights" aus.

3. Wählen Sie auf der Seite Application Insights die Option Application Insights aktivieren aus.

4. Nachdem die Seite "Application Insights " aktualisiert wurde, wählen Sie im Abschnitt " Ressource ändern " die folgenden Optionen aus:

   • Neue Ressource erstellen

     Azure erstellt Ressourcen für Application Insights und einen Log Analytics-Arbeitsbereich mithilfe der aktuellen Abonnement- und Ressourcengruppe. Wenn Sie ein anderes Abonnement und eine andere Ressourcengruppe verwenden möchten, lesen Sie "Erstellen einer neuen Application Insights"-Ressource, und kehren Sie dann zu dieser Seite zurück.

     Eigentum	BESCHREIBUNG
     Name der neuen Ressource	Akzeptieren Sie entweder den generierten Namen, oder geben Sie einen anderen Namen an.
     Ort	Wählen Sie eine Azure-Region aus.
     Log Analytics-Arbeitsbereich	Wählen Sie ggf. einen vorhandenen Arbeitsbereich aus. Andernfalls wird ein Standardarbeitsbereich für Sie erstellt. Weitere Informationen finden Sie unter Übersicht über Log Analytics-Arbeitsbereiche.

   • Vorhandene Ressource auswählen:

     1. Wählen Sie das Azure-Abonnement für Ihre Application Insights-Ressource aus.

     2. Wählen Sie Ihre Application Insights-Ressource aus.

5. Wenn Sie fertig sind, wählen Sie unten auf der Seite Übernehmen aus.

Öffnen von Application Insights aus Ihrer Logik-App

1. Suchen und öffnen Sie ihre bereitgestellte Logik-App im Azure-Portal.

2. Wählen Sie im Menü "Logik-App" unter "Überwachung" die Option "Application Insights" aus.

3. Wählen Sie auf der Seite "Application Insights " den Link für Ihre Application Insights-Ressource aus.

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

• Azure Logic Apps ohne Grenzen ausführen: Überwachung mit Application Insights (Teil 1)
• Azure Logic Apps ohne Grenzen ausführen: Überwachung mit Application Insights (Teil 2)

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. Wenn Sie zuvor versucht haben, den Designer zu öffnen, Aber Sie haben Ihr Projekt eingestellt oder gelöscht, das Erweiterungspaket wird möglicherweise nicht ordnungsgemäß heruntergeladen. Führen Sie die folgenden Schritte aus, um zu überprüfen, ob dieser Grund die Ursache 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.:

   

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

   A host error has occurred during startup operation '<operation-ID>'.
   System.Private.CoreLib: The file 'C:\Users\<user-name>\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 ...\Users\<benutzername>\AppData\Local\Temp\Functions\ExtensionBundles, und versuchen Sie erneut, die workflow.json Datei 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 mithilfe von Visual Studio Code mit der Erweiterung Azure Logic Apps (Standard) erstellen und bereitstellen, nicht auf die Logik-Apps, die Sie mit dem Azure-Portal erstellen. 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 Code.

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

   ...\Users\<user-name>\.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\<user-name>\.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 den längeren URI anzupassen, bearbeiten Sie die UrlSegmentMaxCount und UrlSegmentMaxLength Registryschlüssel auf Ihrem Computer, indem Sie die folgenden Schritte ausführen. Die Standardwerte dieses Schlüssels werden in diesem Artikel beschrieben, Http.sys Registrierungseinstellungen für Windows.

Von Bedeutung

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:

   

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 dateitasks.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"
    }
   

   Danach:

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

Verwandte Inhalte

• Einzelmandant im Vergleich zu mehreren Mandanten in Azure Logic Apps
• Verwalten von Logik-Apps in Visual Studio Code