Schnellstart: Erstellen von Verbrauchsworkflows in mehrinstanzenfähigen Azure Logic Apps mithilfe von Visual Studio Code

Gilt für: Azure Logic Apps (Verbrauch)

Als Integrationsentwickler müssen Sie häufig Geschäftsprozesse in SaaS-Apps, Unternehmenssystemen und Datenquellen automatisieren, ohne die Infrastruktur zu verwalten. Außerdem benötigen Sie eine Code-first-Methode zum Erstellen von Workflows, damit Sie Versionsdefinitionen erstellen, Aktualisierungen vornehmen und Änderungen effizient überprüfen können.

In dieser Schnellstartanleitung wird gezeigt, wie Sie Verbrauchsworkflows in mehrinstanzenbasierten Azure Logic Apps mithilfe der lokalen Code-first-Tools in Visual Studio Code erstellen und verwalten. Verbrauchsworkflows bieten ein serverloses Integrationsmodell für ereignisgesteuerte und geplante Workflows, sodass Sie Dienste verbinden und Prozesse automatisieren können, während sie nur für die ausgeführten Aktionen bezahlen.

In Visual Studio Code können Sie Workflowdefinitionen in JavaScript Object Notation (JSON) mithilfe des Code-Editors bearbeiten, den visuellen Designer bei Bedarf verwenden und bereitgestellte Workflows in Azure verwalten. Sie können auch an Workflows und Integrationskonten von jeder Entwicklungsplattform arbeiten, auf der Visual Studio Code ausgeführt wird, z. B. Linux, Windows und macOS.

Der folgende Screenshot zeigt, wie eine Beispieldefinition des Verbrauchsworkflows aussehen kann:

Weitere Informationen findest du unter:

• Was ist Azure Logic Apps?
• Einzelmandanten im Vergleich zu multitenant in Azure Logic Apps.

Voraussetzungen

• Ein Azure Konto und ein Abonnement. Erhalten Sie ein kostenloses Azure-Konto.

• Grundlegende Kenntnisse zu Logik-App-Workflowdefinitionen und deren Struktur im JSON-Format.

  Das Beispiel in diesem Artikel erstellt den gleichen Logik-App-Workflow wie in dieser Schnellstartanleitung , die sich mehr auf die grundlegenden Konzepte konzentriert. Sie können auch lernen, Workflows über die Azure CLI zu erstellen und zu verwalten.

• Zugriff auf das Web für die Anmeldung bei Azure und Ihrem Azure-Abonnement.

• Laden Sie die folgenden Tools herunter, und installieren Sie sie, wenn Sie sie noch nicht haben:

  • Visual Studio Code Version 1.25.1 oder höher, die kostenlos ist.

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

    1. Installieren Sie diese Erweiterung aus dem Visual Studio Marketplace oder direkt aus Visual Studio Code.

       

    2. Laden Sie Visual Studio Code nach der Installation erneut.

    Weitere Informationen finden Sie im Marketplace für Erweiterungen. Unter Azure Logic Apps-Erweiterung für Visual Studio Code auf GitHub können Sie Beiträge zur Open-Source-Version dieser Erweiterung einreichen.

• Wenn Ihr Logik-App-Workflow über eine Firewall kommunizieren muss, die den Datenverkehr auf bestimmte IP-Adressen beschränkt, muss die Firewall den Zugriff aufeingehende und ausgehende IP-Adressen zulassen, die von Azure Logic Apps oder der Laufzeit in der Azure-Region verwendet werden, in der Ihr Logik-App-Workflow vorhanden ist.

  Wenn Ihr Logik-App-Workflow auch verwaltete Connectors verwendet, z. B. den Office 365 Outlook-Connector oder SQL-Connector, oder benutzerdefinierte Connectors verwendet, muss die Firewall den Zugriff für alleausgehenden IP-Adressen des verwalteten Connectors in der Azure-Region Ihrer Logik-App zulassen.

Zugreifen auf Azure aus Visual Studio Code

1. Melden Sie sich in Visual Studio Code bei Ihrem Azure-Konto an.

   Wenn die Anmeldung länger als üblich dauert, werden Sie von Visual Studio Code aufgefordert, sich über eine Microsoft-Authentifizierungswebsite anzumelden, indem Sie einen Gerätecode angeben. Führen Sie die folgenden Schritte aus, um sich stattdessen mit dem Code anzumelden:

   1. Wählen Sie "Gerätecode verwenden" und dann "Kopieren & Öffnen" aus.

   2. Wählen Sie "Link öffnen" , um ein neues Browserfenster zu öffnen und mit der Authentifizierungswebsite fortzufahren.

   3. Geben Sie auf der Seite Bei Ihrem Konto anmelden Ihren Authentifizierungscode ein, und wählen Sie Weiter aus.

2. Wählen Sie auf der Aktivitätsleiste das Azure-Symbol aus.

   

   Im Azure-Bereich werden nun in den Abschnitten "Logik-Apps (Verbrauch)" und "Integrationskonten " die Azure-Abonnements angezeigt, die Ihrem Konto zugeordnet sind. Wenn die erwarteten Abonnements nicht angezeigt werden, oder wenn in den Abschnitten zu viele Abonnements angezeigt werden, führen Sie die folgenden Schritte aus:

   1. Wählen Sie im Abschnitt "Logik-Apps (Verbrauch)" die Option "Abonnements auswählen" aus.

      

   2. Wählen Sie in der Abonnementliste die Abonnements aus, die Sie verwenden möchten.

3. Erweitern Sie im Abschnitt "Logik-Apps (Verbrauch)" Ihr Abonnement, um alle bereitgestellten Logik-Apps in diesem Abonnement anzuzeigen.

   

Erstellen einer Logik-App

1. Wählen Sie in Visual Studio Code im Abschnitt "Logik-Apps (Verbrauch)" im Kontextmenü des Abonnements die Option "Logik-App erstellen" aus.

   

   Eine Liste wird angezeigt, in der alle Azure-Ressourcengruppen in Ihrem Abonnement angezeigt werden.

2. Wählen Sie in der Ressourcengruppenliste entweder " Neue Ressourcengruppe erstellen " oder eine vorhandene Ressourcengruppe aus.

   Wählen Sie in diesem Beispiel die Option "Neue Ressourcengruppe erstellen" aus, z. B.:

   

3. Geben Sie einen Namen für Ihre Azure-Ressourcengruppe ein.

   

4. Wählen Sie die Azure-Region aus, in der die Metadaten der Logik-App gespeichert werden sollen.

   

5. Geben Sie einen Namen für Ihre Logik-App ein.

   

   Im Azure-Fenster werden unter Ihrem Azure-Abonnement Ihre neue Logik-App und der leere Workflow angezeigt. Visual Studio Code öffnet auch eine JSON-Datei (.logicapp.json), die eine Skelettworkflowdefinition enthält, z. B.:

   

   Sie können nun mit der manuellen Erstellung Ihrer Workflowdefinition in dieser JSON-Datei beginnen. Eine technische Referenz zur Struktur und Syntax einer Workflowdefinition finden Sie unter Workflowdefinitionssprachenschema für Azure Logic Apps.

   Die folgende Beispiellogik-App-Workflowdefinition beginnt mit einem RSS-Trigger und einer Office 365 Outlook-Aktion. JSON-Elemente werden in der Regel alphabetisch in jedem Abschnitt angezeigt. In diesem Beispiel werden diese Elemente jedoch ungefähr in der Reihenfolge dargestellt, in der die Workflowvorgänge im Designer angezeigt werden.

   {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
         "$connections": {
            "defaultValue": {},
            "type": "Object"
         }
      },
      "triggers": {
         "When_a_feed_item_is_published": {
            "recurrence": {
               "frequency": "Minute",
               "interval": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

   Wichtig

   Um diese Beispielworkflowdefinition wiederzuverwenden, benötigen Sie ein Geschäfts- oder Schulkonto der Organisation, z. B. @fabrikam.com. Stellen Sie sicher, dass Sie die fiktive E-Mail-Adresse durch Ihre eigene E-Mail-Adresse ersetzen.

   Um einen anderen E-Mail-Connector wie Outlook.com oder Gmail zu verwenden, ersetzen Sie die Aktion durch eine ähnliche Aktion, die Send_an_email_action von einem E-Mail-Connector verfügbar ist, den Azure Logic Apps unterstützt.

   Wenn Sie den Gmail-Connector verwenden möchten, können nur G-Suite-Geschäftskonten diesen Connector ohne Einschränkung in Logik-Apps verwenden. Wenn Sie über ein Gmail-Verbraucherkonto verfügen, können Sie diesen Connector nur mit bestimmten von Google genehmigten Diensten verwenden oder eine Google-Client-App für die Authentifizierung mit Ihrem Gmail-Connector erstellen. Weitere Informationen finden Sie unter Datensicherheit und Datenschutzrichtlinien für Google-Connectors in Azure Logic Apps.

6. Wenn Sie fertig sind, speichern Sie die Workflowdefinition. (Datei>Speichern oder drücken Sie STRG+S).

7. Wenn Sie aufgefordert werden, Die Workflowdefinition Ihrer Logik-App in Ihr Azure-Abonnement hochzuladen, wählen Sie "Hochladen" aus.

   In diesem Schritt wird Ihre Logik-App-Workflowdefinition aus Visual Studio Code im Azure-Portal veröffentlicht, wodurch der Workflow in Azure live und ausgeführt wird.

   

Anzeigen des Workflows im Designer

In Visual Studio Code können Sie Ihren Logik-App-Workflow in der schreibgeschützten Entwurfsansicht öffnen. Obwohl Sie Ihre Workflowdefinition im Designer nicht bearbeiten können, können Sie Ihren Workflow mithilfe der Designeransicht visuell überprüfen.

Wählen Sie im Azure-Fenster im Abschnitt "Logik-Apps (Verbrauch)" im Kontextmenü Ihrer Logik-App "In Designer öffnen" aus.

Der schreibgeschützte Designer wird in einem separaten Tab geöffnet und zeigt den Logik-App-Workflow an, zum Beispiel:

Anzeigen des Workflows im Azure-Portal

Führen Sie die folgenden Schritte aus, um die Workflowdefinition Ihrer Logik-App im Azure-Portal zu überprüfen:

1. Melden Sie sich im Azure-Portal mit demselben Azure-Konto und -Abonnement an, das Ihrer Logik-App zugeordnet ist.

2. Geben Sie im Suchfeld des Azure-Portals den Namen der Logik-App ein. Wählen Sie in der Ergebnisliste die Logik-App aus.

   

3. Öffnen Sie auf der Randleiste der Logik-App unter "Entwicklungstools" den Workflow in der Designer- oder Codeansicht.

Bearbeiten der bereitgestellten Logik-App

In Visual Studio Code können Sie die Workflowdefinition für eine bereits bereitgestellte Logik-App-Ressource in Azure öffnen und bearbeiten.

Wichtig

Bevor Sie einen aktiv ausgeführten Logik-App-Workflow in der Produktion bearbeiten, minimieren Sie Unterbrechungen, und vermeiden Sie das Risiko, den Workflow zu unterbrechen, indem Sie zuerst die Logik-App-Ressource deaktivieren.

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

2. Erweitern Sie im Azure-Fenster im Abschnitt "Logik-Apps (Verbrauch) " Ihr Azure-Abonnement, und wählen Sie die gewünschte Logik-App aus.

3. Wählen Sie im Kontextmenü der Logik-App " Im Editor öffnen" aus. Oder wählen Sie neben dem Namen der Logik-App das Bearbeitungssymbol aus.

   

   Visual Studio Code öffnet die .logicapp.json Datei in Ihrem lokalen temporären Ordner, damit Sie die Workflowdefinition anzeigen können.

   

4. Nehmen Sie Ihre Änderungen in der Workflowdefinitionsdatei vor.

5. Wenn Sie fertig sind, speichern Sie Ihre Änderungen (Datei>speichern oder STRG+S drücken).

6. Wenn Sie aufgefordert werden, Ihre Änderungen hochzuladen und Ihren vorhandenen Logik-App-Workflow im Azure-Portal zu überschreiben , wählen Sie "Hochladen" aus.

   In diesem Schritt werden Ihre Updates für Ihre Logik-App-Ressource im Azure-Portal veröffentlicht.

   

Anzeigen oder Höherstufen anderer Versionen

In Visual Studio Code können Sie frühere Versionen für Ihren Logik-App-Workflow öffnen und überprüfen. Sie können auch eine frühere Version auf die aktuelle Version höher stufen.

Wichtig

Bevor Sie einen aktiv ausgeführten Logik-App-Workflow in der Produktion ändern, minimieren Sie Unterbrechungen, und vermeiden Sie das Risiko, dass diese Logik-App unterbrochen wird, indem Sie zuerst die Logik-App-Ressource deaktivieren.

1. Erweitern Sie im Azure-Fenster im Abschnitt "Logik-Apps (Verbrauch) " Ihr Azure-Abonnement, um die zugehörigen Logik-Apps anzuzeigen.

2. Erweitern Sie Ihre Logik-App in Ihrem Abonnement, und erweitern Sie Versionen.

   In der Versionsliste werden die früheren Versionen der Logik-App angezeigt, sofern vorhanden.

   

3. Um eine frühere Version anzuzeigen, wählen Sie einen der folgenden Schritte aus:

   • Um die JSON-Definition anzuzeigen, wählen Sie unter Versionen die Versionsnummer für diese Definition aus. Oder wählen Sie im Kontextmenü der Version die Option "Im Editor öffnen" aus.

     Auf dem lokalen Computer wird eine neue Datei geöffnet und die JSON-Definition dieser Version angezeigt.

   • Um die Version im schreibgeschützten Designer anzuzeigen, wählen Sie im Kontextmenü der Version "In Designer öffnen" aus.

4. Um eine frühere Version auf die aktuelle Version höherzustufen, führen Sie diese Schritte aus:

   1. Wählen Sie unter Versionen im Kontextmenü der früheren Version die Option Höherstufen aus.

      

   2. Um fortzufahren, nachdem Visual Studio Code Sie zur Bestätigung aufgefordert hat, wählen Sie Ja aus.

      Visual Studio Code stuft die ausgewählte Version auf die aktuelle Version herauf und weist der höher gestuften Version eine neue Nummer zu. Die zuvor aktuelle Version wird jetzt unter der höher gestuften Version angezeigt.

Deaktivieren oder Aktivieren von Logik-Apps

Wenn Sie in Visual Studio Code einen veröffentlichten Logic App-Workflow bearbeiten und Ihre Änderungen speichern, überschreiben Sie die bereits bereitgestellte Logic App. Um zu vermeiden, dass Ihr Logic App Workflow in der Produktion fehlerhaft wird und um Störungen zu minimieren, deaktivieren Sie zunächst Ihre Logic App Ressourcen. Nachdem Sie bestätigt haben, dass der Workflow weiterhin wie erwartet funktioniert, können Sie die Logik-App-Ressource reaktivieren.

Das Deaktivieren oder Aktivieren einer Logik-App-Ressource wirkt sich auf folgende Arten auf Workflowinstanzen aus:

• Azure Logic Apps führt laufende und ausstehende Workflows weiter aus, bis sie abgeschlossen sind. Basierend auf dem Volume oder Backlog kann es einige Zeit dauern, bis dieser Prozess abgeschlossen ist.

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

• Der Trigger wird nicht ausgelöst, wenn die Bedingungen das nächste Mal erfüllt sind.

• Der Triggerzustand merkt sich den Punkt, an dem der Workflow beendet wurde. Wenn Sie also die Logik-App reaktivieren, wird der Trigger für alle Elemente ausgelöst, die seit der letzten Ausführung noch nicht verarbeitet wurden.

  Um zu verhindern, dass der Trigger bei diesen nicht verarbeiteten Elementen ausgelöst wird, löschen Sie den Triggerstatus, bevor Sie die Logik-App-Ressource erneut aktivieren.

  1. Bearbeiten Sie im Workflow einen beliebigen Teil des Triggers.
  2. Speichern Sie die Änderungen. Durch diesen Schritt wird der aktuelle Status Ihres Triggers zurückgesetzt.
  3. Reaktivieren Sie Ihre Logik-App-Ressource.

• Wenn die Logik-App-Ressource deaktiviert ist, können Sie weiterhin Workflow-Ausführungen erneut übermitteln.

Führen Sie die folgenden Schritte aus, um eine Logik-App-Ressource in Visual Studio Code zu deaktivieren oder zu aktivieren:

1. Öffnen Sie in Visual Studio Code das Azure-Fenster.

2. Erweitern Sie im Abschnitt "Logik-Apps (Verbrauch) " Ihr Azure-Abonnement, um die zugehörigen Logik-Apps anzuzeigen.

3. Um eine Logik-App-Ressource zu deaktivieren, wählen Sie im Kontextmenü der Logik-App die Option "Deaktivieren" aus.

   

4. Wenn Sie bereit sind, die Logik-App-Ressource zu reaktivieren, wählen Sie im Kontextmenü der Logik-App "Aktivieren" aus.

   

Löschen von Logik-Apps

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

• Azure Logic Apps versucht, alle laufenden und ausstehenden Workflowausführungen abzubrechen.

  Selbst bei einer großen Menge oder einem umfangreichen Backlog werden die meisten Ausführungen abgebrochen, bevor sie abgeschlossen oder gestartet werden. Es kann jedoch einige Zeit dauern, bis der Abbruchvorgang abgeschlossen ist. In der Zwischenzeit kann der Dienst einige Ausführungsläufe aufnehmen, während er durch den Abbruchvorgang funktioniert.

• 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, weist der neu erstellte Workflow unterschiedliche Metadaten auf. Sie müssen alle Workflows, die den gelöschten Workflow aufgerufen haben, erneut speichern. Wenn Sie erneut speichern, erhält der Aufrufer die korrekten Informationen für den neu erstellten Workflow. Andernfalls schlagen Aufrufe des neu erstellten Workflows mit einem Unauthorized-Fehler fehl. Dieses Verhalten gilt auch für Workflows, die Artefakte in Integrationskonten verwenden, sowie Workflows, die Azure-Funktionen aufrufen.

Führen Sie die folgenden Schritte aus, um eine Logik-App-Ressource aus Visual Studio Code zu löschen:

1. Öffnen Sie in Visual Studio Code das Azure-Fenster.

2. Erweitern Sie im Abschnitt "Logic Apps (Consumption) Ihr Azure-Abonnement, um die zugehörigen Logik-App-Ressourcen anzuzeigen. Suchen Sie die Logik-App-Ressource, die Sie löschen möchten.

3. Wählen Sie im Kontextmenü der Logik-App "Löschen" aus.

   

Verwandte Inhalte

• Standard-Workflows in einzelmandantenfähigen Azure Logic Apps mit Visual Studio Code erstellen