Snabbstart: Skapa och hantera arbetsflödesdefinitioner för logikappar med azure logic apps med flera klienter och Visual Studio Code

Gäller för: Azure Logic Apps (förbrukning)

Den här snabbstarten visar hur du skapar och hanterar arbetsflöden för logikappar som hjälper dig att automatisera uppgifter och processer som integrerar appar, data, system och tjänster i organisationer och företag med hjälp av azure logic apps med flera klienter och Visual Studio Code. Du kan skapa och redigera de underliggande arbetsflödesdefinitionerna, som använder JavaScript Object Notation (JSON), för logikappar via en kodbaserad upplevelse. Du kan också arbeta med befintliga logikappar som redan har distribuerats till Azure. Mer information om modellen för flera klienter jämfört med en enskild klientorganisation finns i Miljö för en klientorganisation jämfört med flera klienter och integrationstjänst.

Även om du kan utföra samma uppgifter i Azure-portalen och i Visual Studio kan du komma igång snabbare i Visual Studio Code när du redan är bekant med logikappdefinitioner och vill arbeta direkt i kod. Du kan till exempel inaktivera, aktivera, ta bort och uppdatera logikappar som redan har skapats. Du kan också arbeta med logikappar och integrationskonton från alla utvecklingsplattformar där Visual Studio Code körs, till exempel Linux, Windows och Mac.

I den här artikeln kan du skapa samma logikapp från den här snabbstarten, som fokuserar mer på de grundläggande begreppen. Du kan också lära dig att skapa exempelappen i Visual Studio och lära dig att skapa och hantera appar via Azure CLI. I Visual Studio Code ser logikappen ut så här:

Förutsättningar

Innan du börjar bör du kontrollera att du har följande:

• Om du inte har något Azure-konto och en prenumeration registrerar du dig för ett kostnadsfritt Azure-konto.

• Grundläggande kunskaper om logikappens arbetsflödesdefinitioner och deras struktur enligt beskrivningen med JSON

  Om du inte har använt Azure Logic Apps tidigare kan du prova den här snabbstarten, som skapar ditt första logikapparbetsflöde i Azure-portalen och fokuserar mer på de grundläggande begreppen.

• Åtkomst till webben för att logga in på Azure och din Azure-prenumeration

• Hämta och installera följande verktyg, om du inte redan har dem:

  • Visual Studio Code version 1.25.1 eller senare, som är kostnadsfri

  • Visual Studio Code-tillägg för Azure Logic Apps

    Du kan ladda ned och installera det här tillägget från Visual Studio Marketplace eller direkt från Visual Studio Code. Kontrollera att du läser in Visual Studio Code igen efter installationen.

    

    Om du vill kontrollera att tillägget har installerats korrekt väljer du Den Azure-ikon som visas i Visual Studio Code-verktygsfältet.

    

    Mer information finns i Marketplace för tillägg. Om du vill bidra till det här tilläggets version med öppen källkod går du till Azure Logic Apps-tillägget för Visual Studio Code på GitHub.

• Om logikappen behöver kommunicera via en brandvägg som begränsar trafik till specifika IP-adresser måste brandväggen tillåta åtkomst för både inkommande och utgående IP-adresser som används av Azure Logic Apps eller körning i Azure-regionen där logikappen finns. Om logikappen också använder hanterade anslutningsappar, till exempel Office 365 Outlook-anslutningsappen eller SQL-anslutningsappen, eller använder anpassade anslutningsappar, måste brandväggen också tillåta åtkomst för allautgående IP-adresser för hanterade anslutningsappar i logikappens Azure-region.

Få åtkomst till Azure från Visual Studio Code

1. Öppna Visual Studio Code. I verktygsfältet Visual Studio Code väljer du Azure-ikonen.

   

2. I Azure-fönstret går du till Logic Apps och väljer Logga in på Azure. När Microsofts inloggningssida uppmanar dig loggar du in med ditt Azure-konto.

   

   1. Om inloggningen tar längre tid än vanligt uppmanar Visual Studio Code dig att logga in via en Microsoft-autentiseringswebbplats genom att ge dig en enhetskod. Om du vill logga in med koden i stället väljer du Använd enhetskod.

      

   2. Kopiera koden genom att välja Kopiera och öppna.

      

   3. Om du vill öppna ett nytt webbläsarfönster och fortsätta till autentiseringswebbplatsen väljer du Öppna länk.

      

   4. På sidan Logga in på ditt konto anger du din autentiseringskod och väljer Nästa.

      

3. Välj ditt Azure-konto. När du har loggat in kan du stänga webbläsaren och återgå till Visual Studio Code.

   I Azure-fönstret visar avsnitten Logic Apps och Integration Accounts nu de Azure-prenumerationer som är associerade med ditt konto. Men om du inte ser de prenumerationer som du förväntar dig, eller om avsnitten visar för många prenumerationer, följer du dessa steg:

   1. Flytta pekaren över logic apps-etiketten. När verktygsfältet visas väljer du Välj prenumerationer (filterikon).

      

   2. I listan som visas väljer du de prenumerationer som du vill ska visas.

4. Under Logic Apps väljer du den prenumeration som du vill använda. Prenumerationsnoden expanderar och visar alla logikappar som finns i den prenumerationen.

   

   Dricks

   Under Integration Accounts (Integreringskonton) visas alla integreringskonton som finns i prenumerationen när du väljer din prenumeration.

Skapa ny logikapp

1. Om du inte har loggat in på ditt Azure-konto och din prenumeration ännu inifrån Visual Studio Code följer du de föregående stegen för att logga in nu.

2. Öppna prenumerationens snabbmeny under Logic Apps i Visual Studio Code och välj Skapa logikapp.

   

   En lista visas och visar alla Azure-resursgrupper i din prenumeration.

3. I resursgruppslistan väljer du antingen Skapa en ny resursgrupp eller en befintlig resursgrupp. I det här exemplet skapar du en ny resursgrupp.

   

4. Ange ett namn för din Azure-resursgrupp och tryck på RETUR.

   

5. Välj den Azure-region där du vill spara logikappens metadata.

   

6. Ange ett namn för logikappen och tryck på Retur.

   

   I Azure-fönstret, under din Azure-prenumeration, visas den nya och tomma logikappen. Visual Studio Code öppnar också en JSON-fil (.logicapp.json) som innehåller en definition av skelettarbetsflödet för logikappen. Nu kan du börja redigera logikappens arbetsflödesdefinition manuellt i den här JSON-filen. Teknisk referens om strukturen och syntaxen för en arbetsflödesdefinition finns i Schemat för arbetsflödesdefinitionsspråk för Azure Logic Apps.

   

   Här är till exempel en exempel på logikappens arbetsflödesdefinition, som börjar med en RSS-utlösare och en Office 365 Outlook-åtgärd. Vanligtvis visas JSON-element alfabetiskt i varje avsnitt. Det här exemplet visar dock dessa element ungefär i den ordning som logikappens steg visas i designern.

   Viktigt!

   Om du vill återanvända den här exempellogikappdefinitionen behöver du ett organisationskonto, till exempel @fabrikam.com. Se till att du ersätter den fiktiva e-postadressen med din egen e-postadress. Om du vill använda en annan e-postanslutning, till exempel Outlook.com eller Gmail, ersätter Send_an_email_action du åtgärden med en liknande åtgärd som är tillgänglig från en e-postanslutning som stöds av Azure Logic Apps.

   Om du vill använda Gmail-anslutningsappen kan endast G-Suite-företagskonton använda den här anslutningsappen utan begränsning i logikappar. Om du har ett Gmail-konsumentkonto kan du använda den här anslutningsappen med endast specifika Google-godkända tjänster, eller så kan du skapa en Google-klientapp som ska användas för autentisering med gmail-anslutningsappen. Mer information finns i Datasäkerhets- och sekretessprinciper för Google-anslutningsappar i 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": 1
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "http://feeds.reuters.com/reuters/topNews"
               }
            }
         }
      },
      "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. När du är klar sparar du logikappens arbetsflödesdefinition. (Arkiv-menyn > Spara eller tryck på Ctrl+S)

8. När du uppmanas att ladda upp logikappen till din Azure-prenumeration väljer du Ladda upp.

   Det här steget publicerar logikappen på Azure-portalen, vilket gör att logiken fungerar och körs i Azure.

   

Visa logikappen i designern

I Visual Studio Code kan du öppna logikappen i skrivskyddad designvy. Även om du inte kan redigera logikappen i designern kan du visuellt kontrollera logikappens arbetsflöde med hjälp av designervyn.

Öppna logikappens snabbmeny under Logic Apps i Azure-fönstret och välj Öppna i Designer.

Den skrivskyddade designern öppnas i ett separat fönster och visar logikappens arbetsflöde, till exempel:

Visa i Azure-portalen

Följ dessa steg för att granska logikappen i Azure-portalen:

1. Logga in på Azure-portalen med samma Azure-konto och prenumeration som är associerad med din logikapp.

2. I sökrutan i Azure-portalen anger du logikapparnas namn. I resultatlistan väljer du din logikapp.

   

Redigera distribuerad logikapp

I Visual Studio Code kan du öppna och redigera arbetsflödesdefinitionen för en redan distribuerad logikapp i Azure.

Viktigt!

Innan du redigerar en logikapp som körs aktivt i produktion bör du undvika risken med att bryta logikappen och minimera störningar genom att först inaktivera logikappen.

1. Om du inte har loggat in på ditt Azure-konto och din prenumeration ännu inifrån Visual Studio Code följer du de föregående stegen för att logga in nu.

2. I Azure-fönstret under Logic Apps expanderar du din Azure-prenumeration och väljer den logikapp du vill använda.

3. Öppna logikappmenyn och välj Öppna i Redigeraren. Eller bredvid logikappens namn väljer du redigeringsikonen.

   

   Visual Studio Code öppnar .logicapp.json-filen i den lokala temporära mappen så att du kan visa logikappens arbetsflödesdefinition.

   

4. Gör dina ändringar i logikappens arbetsflödesdefinition.

5. När du är klar kan du spara ändringarna. (Arkiv-menyn > Spara eller tryck på Ctrl+S)

6. När du uppmanas att ladda upp dina ändringar och skriva över din befintliga logikapp i Azure-portalen väljer du Ladda upp.

   Det här steget publicerar dina uppdateringar till logikappen i Azure-portalen.

   

Visa eller flytta upp andra versioner

I Visual Studio Code kan du öppna och granska de tidigare versionerna för logikappen. Du kan också höja upp en tidigare version till den aktuella versionen.

Viktigt!

Innan du ändrar en logikapp som körs aktivt i produktion bör du undvika risken med att bryta logikappen och minimera störningar genom att först inaktivera logikappen.

1. I Azure-fönstret under Logic Apps expanderar du din Azure-prenumeration så att du kan visa alla logikappar i den prenumerationen.

2. Under din prenumeration expanderar du logikappen och expanderar Versioner.

   Listan Versioner visar logikappens tidigare versioner, om det finns några.

   

3. Om du vill visa en tidigare version väljer du något av stegen:

   • Om du vill visa JSON-definitionen går du till Versioner och väljer versionsnumret för den definitionen. Du kan också öppna den versionens snabbmeny och välja Öppna i Redigeraren.

     En ny fil öppnas på den lokala datorn och visar den versionens JSON-definition.

   • Om du vill visa versionen i den skrivskyddade designervyn öppnar du den versionens snabbmeny och väljer Öppna i Designer.

4. Följ dessa steg om du vill höja upp en tidigare version till den aktuella versionen:

   1. Under Versioner öppnar du den tidigare versionens snabbmeny och väljer Höj upp.

      

   2. Om du vill fortsätta efter att Visual Studio Code har frågat dig om bekräftelse väljer du Ja.

      

      Visual Studio Code höjer upp den valda versionen till den aktuella versionen och tilldelar ett nytt nummer till den upphöjda versionen. Den tidigare aktuella versionen visas nu under den upphöjda versionen.

Inaktivera eller aktivera logikappar

Om du redigerar en publicerad logikapp och sparar ändringarna i Visual Studio Code skriver du över den redan distribuerade appen. Om du vill undvika att bryta logikappen i produktion och minimera störningar inaktiverar du logikappen först. Du kan sedan återaktivera logikappen när du har bekräftat att logikappen fortfarande fungerar.

• Azure Logic Apps fortsätter alla pågående och väntande körningar tills de är klara. Den här processen kan ta tid att slutföra baserat på volymen eller kvarvarande uppgifter.

• Azure Logic Apps skapar eller kör inte nya arbetsflödesinstanser.

• Utlösaren utlöses inte nästa gång dess villkor uppfylls.

• Utlösartillståndet kommer ihåg den punkt då logikappen stoppades. Så om du återaktiverar logikappen utlöses utlösaren för alla obearbetade objekt sedan den senaste körningen.

  Om du vill hindra utlösaren från att utlösa obehandlade objekt sedan den senaste körningen rensar du utlösarens tillstånd innan du återaktiverar logikappen:

  1. I logikappen redigerar du alla delar av arbetsflödets utlösare.
  2. Spara dina ändringar. Det här steget återställer utlösarens aktuella tillstånd.
  3. Återaktivera logikappen.

• När ett arbetsflöde är inaktiverat kan du fortfarande skicka om körningar.

1. Om du inte har loggat in på ditt Azure-konto och din prenumeration ännu inifrån Visual Studio Code följer du de föregående stegen för att logga in nu.

2. I Azure-fönstret under Logic Apps expanderar du din Azure-prenumeration så att du kan visa alla logikappar i den prenumerationen.

   1. Om du vill inaktivera den logikapp som du vill använda öppnar du logikappmenyn och väljer Inaktivera.

      

   2. När du är redo att återaktivera logikappen öppnar du logikappmenyn och väljer Aktivera.

      

Ta bort logikappar

Om du tar bort en logikapp påverkas arbetsflödesinstanser på följande sätt:

• Azure Logic Apps gör sitt bästa för att avbryta pågående och väntande körningar.

  Även med en stor volym eller kvarvarande uppgifter avbryts de flesta körningar innan de slutförs eller startas. Det kan dock ta tid att slutföra annulleringen. Under tiden kan vissa körningar hämtas för körning medan tjänsten fungerar genom annulleringsprocessen.

• Azure Logic Apps skapar eller kör inte nya arbetsflödesinstanser.

• Om du tar bort ett arbetsflöde och sedan återskapar samma arbetsflöde har det återskapade arbetsflödet inte samma metadata som det borttagna arbetsflödet. Du måste återskapa alla arbetsflöden som kallas för det borttagna arbetsflödet. På så sätt får anroparen rätt information för det återskapade arbetsflödet. Annars misslyckas anrop till det återskapade arbetsflödet med ett Unauthorized fel. Det här beteendet gäller även för arbetsflöden som använder artefakter i integrationskonton och arbetsflöden som anropar Azure-funktioner.

1. Om du inte har loggat in på ditt Azure-konto och din prenumeration ännu inifrån Visual Studio Code följer du de föregående stegen för att logga in nu.

2. I Azure-fönstret under Logic Apps expanderar du din Azure-prenumeration så att du kan visa alla logikappar i den prenumerationen.

3. Leta reda på logikappen som du vill ta bort, öppna logikappmenyn och välj Ta bort.

   

Nästa steg

Skapa arbetsflöden för en klientbaserad logikapp i Visual Studio Code