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

Gilt für: Azure Logic Apps (Verbrauch)

In dieser Schnellstartanleitung wird gezeigt, wie Logik-App-Workflows in mehrinstanzenfähigen Azure Logic Apps erstellt werden, die Aufgaben automatisieren und Prozesse in Diensten, Systemen, Apps und Daten in Organisationen und Unternehmen mithilfe von Visual Studio Code integrieren. Sie können die zugrunde liegenden Workflowdefinitionen erstellen und bearbeiten, die JavaScript Object Notation (JSON) für Workflows über eine codebasierte Oberfläche verwenden. Sie können auch an vorhandenen Logik-App-Workflows arbeiten, die bereits in Azure bereitgestellt wurden. Weitere Informationen zum Unterschied zwischen einem Einzelmandanten- und einem Mehrinstanzenmodell finden Sie unter "Single-tenant versus Multitenant in Azure Logic Apps".

Obwohl Sie dieselben Aufgaben im Azure-Portal ausführen können, können Sie in Visual Studio Code schneller loslegen, wenn Sie bereits mit Logik-App-Definitionen vertraut sind und direkt im Code arbeiten möchten. Sie können beispielsweise bereits erstellte Logik-App-Workflows deaktivieren, aktivieren, löschen und aktualisieren. Sie können zudem auf jeder Entwicklungsplattform, auf der Visual Studio Code ausgeführt wird – z.B. Linux, Windows und Mach, an Logik-Apps und Integrationskonten arbeiten.

In diesem Artikel können Sie in dieser Schnellstartanleitung denselben Logik-App-Workflow erstellen, der sich auf die grundlegenden Konzepte konzentriert. Sie können auch erfahren, wie Sie Apps über die Azure CLI erstellen und verwalten. In Visual Studio Code sieht der Logik-App-Workflow wie im folgenden Beispiel aus:

Voraussetzungen

Stellen Sie zunächst sicher, dass Sie über die folgenden Elemente verfügen:

• Wenn Sie nicht über ein Azure-Konto und ein Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Sie benötigen Grundkenntnisse über die Workflowdefinitionen von Logik-Apps und deren JSON-basierte Struktur.

  Wenn Sie noch nicht mit Azure Logic Apps vertraut sind, probieren Sie diesen Schnellstart aus, mit dem Sie Ihren ersten Logic-App-Workflow im Azure-Portal erstellen und sich dabei stärker auf die grundlegenden Konzepte konzentrieren können.

• Sie benötigen Zugriff auf das Web zum Anmelden bei Azure und in Ihrem Azure-Abonnement.

• Laden Sie diese Tools herunter, und installieren Sie sie, falls sie noch nicht vorhanden sind:

  • Visual Studio Code, Version 1.25.1 oder höher (kostenlos)

  • Visual Studio Code-Erweiterung für Azure Logic Apps

    Sie können diese Erweiterung im Visual Studio Marketplace oder direkt in Visual Studio Code herunterladen und installieren. Laden Sie Visual Studio Code nach der Installation unbedingt neu.

    

    Wählen Sie das Azure-Symbol auf der Visual Studio Code-Symbolleiste aus, um zu überprüfen, ob die Erweiterung ordnungsgemäß installiert wurde.

    

    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 diese Firewall den Zugriff sowohl füreingehende alsauch für ausgehende IP-Adressen zulassen, die von Azure Logic Apps oder 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 auch 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. Öffnen Sie Visual Studio Code. Wählen Sie in der Visual Studio Code-Symbolleiste das Azure-Symbol aus.

   

2. Wählen Sie im Azure-Fenster unter Logik-Apps die Option Bei Azure anmelden aus. Wenn Sie von der Microsoft-Anmeldeseite dazu aufgefordert werden, melden Sie sich mit Ihrem Azure-Konto an.

   

   1. 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. Wählen Sie Gerätecode verwenden aus, um sich stattdessen mit dem Code anzumelden.

      

   2. Um den Code zu kopieren, wählen Sie Kopieren und öffnen aus.

      

   3. Um ein neues Browserfenster zu öffnen und auf der Authentifizierungswebsite fortzufahren, wählen Sie Link öffnen aus.

      

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

      

3. Wählen Sie Ihr Azure-Konto aus. Nach dem Anmelden können Sie den Browser schließen und zu Visual Studio Code zurückkehren.

   Im Azure-Bereich werden in den Abschnitten Logik-Apps und Integrationskonten nun die mit Ihrem Konto verknüpften Azure-Abonnements angezeigt. Wenn die erwarteten Abonnements jedoch nicht angezeigt werden, oder wenn in den Abschnitten zu viele Abonnements angezeigt werden, führen Sie die folgenden Schritte aus:

   1. Bewegen Sie den Mauszeiger über die Bezeichnung Logik-Apps. Wenn die Symbolleiste angezeigt wird, wählen Sie Abonnements auswählen (Filtersymbol) aus.

      

   2. Wählen Sie in der angezeigten Liste die Abonnements aus, die angezeigt werden sollen.

4. Wählen Sie unter Logik-Apps das gewünschte Abonnement aus. Der Abonnementknoten wird erweitert und zeigt alle Logik-Apps an, die in diesem Abonnement vorhanden sind.

   

   Tipp

   Unter Integrationskonten werden bei der Auswahl Ihres Abonnements alle Integrationskonten angezeigt, die in diesem Abonnement vorhanden sind.

Erstellen einer neuen Logik-App

1. Wenn Sie sich noch nicht über Visual Studio Code bei Ihrem Azure-Konto und -Abonnement angemeldet haben, befolgen Sie die vorherigen Schritte, um sich jetzt anzumelden.

2. Öffnen Sie in Visual Studio Code unter Logik-Apps das Kontextmenü Ihres Abonnements, und wählen Sie Logik-App erstellen aus.

   

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

3. Wählen Sie in der Ressourcengruppenliste entweder Neue Ressourcengruppe erstellen oder eine vorhandene Ressourcengruppe aus. Erstellen Sie für dieses Beispiel eine neue Ressourcengruppe.

   

4. Geben Sie einen Namen für Ihre Azure-Ressourcengruppe ein, und drücken Sie die EINGABETASTE.

   

5. Wählen Sie die Azure-Region aus, in der Sie die Metadaten Ihrer Logik-App speichern möchten.

   

6. Geben Sie einen Namen für Ihre Logik-App ein, und drücken Sie die EINGABETASTE.

   

   Im Azure-Fenster wird unter Ihrem Azure-Abonnement Ihr neuer und leerer Logik-App-Workflow angezeigt. Visual Studio Code öffnet auch eine JSON-Datei (.logicapp.json), die eine Skelettworkflowdefinition für Ihre Logik-App enthält. Nun können Sie die Erstellung der Workflowdefinition ihrer Logik-App in dieser JSON-Datei manuell starten. Eine technische Referenz zu Struktur und Syntax einer Workflowdefinition finden Sie im Schemareferenzleitfaden für die Workflowdefinitionssprache in Azure Logic Apps.

   

   Im Folgenden sehen Sie eine Beispieldefinition für einen Logik-App-Workflow, der mit einem RSS-Trigger und einer Office 365 Outlook-Aktion beginnt. JSON-Elemente werden in der Regel alphabetisch in jedem Abschnitt angezeigt. In diesem Beispiel werden diese Elemente jedoch ungefähr in der Reihenfolge angezeigt, in dem die Schritte der Logik-App im Designer aufgeführt sind.

   Wichtig

   Wenn Sie die Definitionsvorlage dieses Logik-App-Workflows wiederverwenden möchten, benötigen Sie ein Organisationskonto, beispielsweise @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 z. B. Outlook.com oder Gmail zu verwenden, ersetzen Sie die Send_an_email_action-Aktion durch eine ähnliche Aktion, die bei einem von Azure Logic Apps unterstützten E-Mail-Connector verfügbar ist.

   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-Consumerkonto verfügen, können Sie diesen Connector nur mit bestimmten von Google genehmigten Diensten verwenden, oder Sie können eine Google-Client-App erstellen, die für die Authentifizierung mit Ihrem Gmail-Connector verwendet werden soll. Weitere Informationen finden Sie unter Datensicherheit und Datenschutzrichtlinien für Google-Connectors in Azure Logic Apps.

   {
      "$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": {}
   }
   

7. Wenn Sie fertig sind, speichern Sie die Workflowdefinition Ihrer Logik-App. (Menü „Datei“ > „Speichern“, oder drücken Sie STRG+S)

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

   In diesem Schritt wird Die Workflowdefinition Ihrer Logik-App im Azure-Portal veröffentlicht, wodurch der Workflow in Azure live und ausgeführt wird.

   

Anzeigen der Workflowdefinition einer Logik-App im Designer

In Visual Studio Code können Sie die Workflowdefinition ihrer Logik-App in der schreibgeschützten Entwurfsansicht öffnen. Sie können die Workflowdefinition ihrer Logik-App zwar nicht im Designer bearbeiten, aber Sie können den Workflow Ihrer Logik-App mithilfe der Designeransicht visuell überprüfen.

Öffnen Sie im Azure-Fenster unter Logik-Apps das Kontextmenü ihrer Logik-App, und wählen Sie Im Designer öffnen aus.

Der schreibgeschützte Designer wird in einem separaten Fenster geöffnet und zeigt den Workflow ihrer Logik-App an, z. B.:

Ansicht 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 mit demselben Azure-Konto und -Abonnement, die Ihrer Logik-App zugeordnet sind, beim Azure-Portal an.

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

   

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.

1. Wenn Sie sich noch nicht über Visual Studio Code bei Ihrem Azure-Konto und -Abonnement angemeldet haben, befolgen Sie die vorherigen Schritte, um sich jetzt anzumelden.

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

3. Öffnen Sie das Kontextmenü der Logik-App, und wählen Sie "Im Editor öffnen" aus. Alternativ können Sie neben dem Namen Ihrer Logik-App das Bearbeitungssymbol auswählen.

   

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

   

4. Nehmen Sie die gewünschten Änderungen an der Workflowdefinition Ihrer Logik-App vor.

5. Speichern Sie Ihre Änderungen, wenn Sie fertig sind. (Menü „Datei“ > „Speichern“, oder drücken Sie STRG+S)

6. Wenn Sie aufgefordert werden, die Änderungen hochzuladen und Ihre vorhandene Logik-App 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 die früheren Versionen der Logik-App öffnen und überprüfen. Sie können auch eine frühere Version auf die aktuelle Version höher stufen.

1. Erweitern Sie im Azure-Fenster unter Logik-Apps Ihr Azure-Abonnement, sodass Sie alle Logik-Apps in diesem Abonnement sehen können.

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

   In der Liste Versionen werden – sofern vorhanden – die früheren Versionen ihrer Logik-App angezeigt.

   

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. Öffnen Sie alternativ das Kontextmenü der Version, und wählen Sie Im Editor öffnen aus.

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

   • Um die Version in der schreibgeschützten Designeransicht anzuzeigen, öffnen Sie das Kontextmenü dieser Version, und wählen Sie Im Designer öffnen aus.

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

   1. Öffnen Sie unter Versionen das Kontextmenü der früheren Version, und wählen Sie Höher stufen 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 Logik-App-Workflow bearbeiten und Ihre Änderungen speichern, überschreiben Sie Ihre bereits bereitgestellte App. Um zu vermeiden, dass Ihr Logik-App-Workflow in der Produktion unterbrochen wird und Störungen minimiert werden, deaktivieren Sie zuerst die Logik-App-Ressource. Anschließend können Sie Ihre Logik-App wieder aktivieren, nachdem Sie sich vergewissert haben, dass sie weiterhin funktioniert.

• Azure Logic Apps setzt alle ausgeführten und ausstehenden Ausführungen fort, 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 definierten Bedingungen beim nächsten Mal erfüllt werden.

• Der Triggerstatus merkt sich den Punkt, an dem die Logik-App angehalten wurde. Wenn Sie die Logik-App erneut aktivieren, wird der Trigger für alle nicht verarbeiteten Elemente seit der letzten Ausführung ausgelöst.

  Wenn Sie die Auslösung eines Triggers für nicht verarbeitete Elemente seit der letzten Ausführung verhindern möchten, löschen Sie den Triggerstatus, bevor Sie die Logik-App wieder aktivieren:

  1. Bearbeiten Sie in der Logik-App einen beliebigen Teil des Workflowtriggers.
  2. Speichern Sie die Änderungen. Durch diesen Schritt wird der aktuelle Status Ihres Triggers zurückgesetzt.
  3. Aktivieren Sie Ihre Logik-App wieder.

• Wenn ein Workflow deaktiviert ist, können Sie trotzdem Ausführungen erneut übermitteln.

1. Wenn Sie sich noch nicht über Visual Studio Code bei Ihrem Azure-Konto und -Abonnement angemeldet haben, befolgen Sie die vorherigen Schritte, um sich jetzt anzumelden.

2. Erweitern Sie im Azure-Fenster unter Logik-Apps Ihr Azure-Abonnement, sodass Sie alle Logik-Apps in diesem Abonnement sehen können.

   1. Um die gewünschte Logik-App zu deaktivieren, öffnen Sie das Menü der Logik-App, und wählen Sie Deaktivieren aus.

      

   2. Wenn Sie bereit sind, Ihre Logik-App wieder zu aktivieren, öffnen Sie das Logik-App-Menü, und wählen Sie Aktivieren aus.

      

Löschen von Logik-Apps

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

• Azure Logic Apps unterbricht alle aktiven und ausstehenden Ausführungen so gut wie möglich.

  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 werden möglicherweise einige Ausführungen gestartet, während der Dienst den Abbruchprozess durchläuft.

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

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

1. Wenn Sie sich noch nicht über Visual Studio Code bei Ihrem Azure-Konto und -Abonnement angemeldet haben, befolgen Sie die vorherigen Schritte, um sich jetzt anzumelden.

2. Erweitern Sie im Azure-Fenster unter Logik-Apps Ihr Azure-Abonnement, sodass Sie alle Logik-Apps in diesem Abonnement sehen können.

3. Navigieren Sie zu der Logik-App, die Sie löschen möchten, öffnen Sie das Menü der Logik-App, und wählen Sie Löschen aus.

   

Nächste Schritte