Skapa ett standardarbetsflöde för logikappar i Azure Logic Apps med en enda klientorganisation med Hjälp av Visual Studio Code

  • Artikel

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

Den här instruktionsguiden visar hur du skapar ett exempel på ett integreringsarbetsflöde som körs i Azure Logic Apps med en enda klientorganisation med hjälp av Visual Studio Code med Tillägget Azure Logic Apps (Standard). Innan du skapar det här arbetsflödet skapar du en standardlogikappresurs som innehåller följande funktioner:

  • Logikappen kan innehålla flera tillståndskänsliga och tillståndslösa arbetsflöden.

  • Arbetsflöden i samma logikapp och klientorganisation körs i samma process som Azure Logic Apps-körningen, så att de delar samma resurser och ger bättre prestanda.

  • Du kan skapa, köra och testa arbetsflöden lokalt med hjälp av Visual Studio Code-utvecklingsmiljön.

    När du är redo kan du distribuera logikappen till Azure där arbetsflödet kan köras i Azure Logic Apps-miljön med en enda klientorganisation eller i en App Service-miljön v3 (endast Windows-baserade App Service-planer). Du kan också distribuera och köra arbetsflödet var som helst där Kubernetes kan köras, inklusive Azure, Azure Kubernetes Service, lokalt eller till och med andra molnleverantörer, på grund av den containerbaserade körningen i Azure Logic Apps.

    Kommentar

    Distributionen av logikappen till ett Kubernetes-kluster är för närvarande i offentlig förhandsversion.

    Mer information om Azure Logic Apps för en klientorganisation finns i Miljö för en klientorganisation jämfört med flera klienter och integrationstjänst.

Även om exempelarbetsflödet är molnbaserat och bara har två steg kan du skapa arbetsflöden från hundratals åtgärder som kan ansluta en mängd olika appar, data, tjänster och system i molnmiljöer, lokalt och hybridmiljöer. Exempelarbetsflödet börjar med den inbyggda utlösaren för begäran och följer med en Office 365 Outlook-åtgärd. Utlösaren skapar en anropsbar slutpunkt för arbetsflödet och väntar på en inkommande HTTPS-begäran från alla anropare. När utlösaren tar emot en begäran och utlöses körs nästa åtgärd genom att skicka e-post till den angivna e-postadressen tillsammans med valda utdata från utlösaren.

Dricks

Om du inte har något Office 365-konto kan du använda andra tillgängliga åtgärder som kan skicka meddelanden från ditt e-postkonto, till exempel Outlook.com.

Om du vill skapa det här exempelarbetsflödet med Hjälp av Azure-portalen i stället följer du stegen i Skapa integreringsarbetsflöden med hjälp av azure logic apps för en enda klientorganisation och Azure-portalen. Båda alternativen ger möjlighet att utveckla, köra och distribuera logikapparbetsflöden i samma typer av miljöer. Med Visual Studio Code kan du dock utveckla, testa och köra arbetsflöden lokalt i utvecklingsmiljön.

Skärmbild som visar Visual Studio Code, logikappsprojekt och arbetsflöde.

När du fortsätter slutför du dessa uppgifter på hög nivå:

  • Skapa ett projekt för logikappen och ett tomt tillståndskänsligt arbetsflöde.
  • Lägg till en utlösare och en åtgärd.
  • Köra, testa, felsöka och granska körningshistorik lokalt.
  • Hitta domännamnsinformation för brandväggsåtkomst.
  • Distribuera till Azure, vilket inkluderar att aktivera Application Insights.
  • Hantera din distribuerade logikapp i Visual Studio Code och Azure-portalen.
  • Aktivera körningshistorik för tillståndslösa arbetsflöden.
  • Aktivera eller öppna Application Insights efter distributionen.

Förutsättningar

Åtkomst och anslutning

  • Om du planerar att lokalt skapa standardlogikappprojekt och köra arbetsflöden med endast inbyggda anslutningsappar som körs internt på Azure Logic Apps-körningen behöver du inte följande krav. Kontrollera dock att du har följande anslutningsuppgifter och autentiseringsuppgifter för Azure-kontot för att publicera eller distribuera projektet från Visual Studio Code till Azure, använda de hanterade anslutningsappar som körs i globala Azure eller få åtkomst till standardlogikappresurser och arbetsflöden som redan har distribuerats i Azure:

    • Åtkomst till Internet så att du kan ladda ned kraven, ansluta från Visual Studio Code till ditt Azure-konto och publicera från Visual Studio Code till Azure.

    • Ett Azure-konto och prenumeration. Om du inte har någon prenumeration kan du registrera ett kostnadsfritt Azure-konto.

  • Om du vill skapa samma exempelarbetsflöde i den här artikeln behöver du ett Office 365 Outlook-e-postkonto som använder ett Microsoft-arbets- eller skolkonto för att logga in.

    Om du väljer en annan e-postanslutning, till exempel Outlook.com, kan du fortfarande följa exemplet och de allmänna övergripande stegen är desamma. Alternativen kan dock skilja sig åt på vissa sätt. Om du till exempel använder Outlook.com-anslutningsappen använder du ditt personliga Microsoft-konto i stället för att logga in.

Verktyg

  1. Ladda ned och installera Visual Studio Code, som är kostnadsfritt.

  2. Ladda ned och installera Azure-kontotillägget för Visual Studio Code så att du har en enda gemensam upplevelse för Azure-inloggning och prenumerationsfiltrering för alla Azure-tillägg i Visual Studio Code. Den här instruktionsguiden innehåller steg som använder den här upplevelsen.

  3. Ladda ned och installera följande Visual Studio Code-beroenden för ditt specifika operativsystem med någon av metoderna:

    Installera alla beroenden automatiskt (förhandsversion)

    Viktigt!

    Den här funktionen är i förhandsversion och omfattas av kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.

    Från och med version 2.81.5 innehåller Tillägget Azure Logic Apps (Standard) för Visual Studio Code ett beroendeinstallationsprogram som automatiskt installerar alla nödvändiga beroenden i en ny binär mapp och lämnar befintliga beroenden oförändrade. Mer information finns i Kom igång enklare med Tillägget Azure Logic Apps (Standard) för Visual Studio Code.

    Det här tillägget innehåller följande beroenden:

    Dependency beskrivning
    C# för Visual Studio Code Aktiverar F5-funktioner för att köra arbetsflödet.
    Azurite för Visual Studio Code Tillhandahåller ett lokalt datalager och en emulator som du kan använda med Visual Studio Code så att du kan arbeta med ditt logikappsprojekt och köra dina arbetsflöden i din lokala utvecklingsmiljö. Om du inte vill att Azurite ska starta automatiskt kan du inaktivera det här alternativet:

    1. Välj Inställningar> på arkivmenyn Inställningar.

    2. Välj Tillägg>Azure Logic Apps (Standard) på fliken Användare.

    3. Hitta inställningen med namnet Azure Logic Apps Standard: Starta Azurite automatiskt och avmarkera den markerade kryssrutan.
    .NET SDK 6.x.x Innehåller .NET Runtime 6.x.x, en förutsättning för Körning av Azure Logic Apps (Standard).
    Azure Functions Core Tools – 4.x-version Installerar versionen baserat på ditt operativsystem (Windows, macOS eller Linux).

    Dessa verktyg innehåller en version av samma körning som driver Azure Functions-körningen, som Tillägget Azure Logic Apps (Standard) använder i Visual Studio Code.
    Node.js version 16.x.x om inte en nyare version redan är installerad Krävs för att aktivera åtgärden Infogade kodåtgärder som kör JavaScript.

    Installationsprogrammet utför inte följande uppgifter:

    • Kontrollera om de nödvändiga beroendena redan finns.
    • Installera endast de beroenden som saknas.
    • Uppdatera äldre versioner av befintliga beroenden.

    1. Ladda ned och installera Tillägget Azure Logic Apps (Standard) för Visual Studio Code, från och med version 2.81.5).

    2. I Visual Studio Code går du till aktivitetsfältet och väljer Tillägg. (Tangentbord: Tryck på Ctrl+Skift+X)

    3. Öppna ellipsmenyn (...) i fönstret Tillägg och välj Installera från VSIX.

    4. Leta upp och välj den nedladdade VSIX-filen.

      När installationen är klar aktiveras tillägget automatiskt och kör kommandot Verifiera och installera binärfiler för beroenden. Om du vill visa processloggarna öppnar du fönstret Utdata .

    5. När följande fråga visas väljer du Ja (rekommenderas) för att bekräfta att du vill installera de nödvändiga beroendena automatiskt:

      Skärmbild som visar uppmaningen att automatiskt installera beroenden.

    6. Läs in Visual Studio Code igen om det behövs.

    7. Kontrollera att beroendena visas korrekt i följande mapp:

      C:\Users\<your-user-name>\.azurelogicapps\dependencies\<dependency-name>

    8. Bekräfta följande tilläggsinställningar i Visual Studio Code:

      1. På Arkiv-menyn väljer du Inställningar> Inställningar.

      2. Välj Tillägg>Azure Logic Apps (Standard) på fliken Användare.

      3. Granska följande inställningar:

        Tilläggsinställning Värde
        Sökväg för beroenden C:\Users\<your-user-name>\.azurelogicapps\dependencies
        Tidsgräns för beroende 60 sekunder
        Binär sökväg för Dotnet C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK\dotnet.exe
        Func Core Tools Binär sökväg C:\Users\<your-user-name>\.azurelogicapps\dependencies\FuncCoreTools\func
        Binär sökväg för Node JS C:\Users\<your-user-name>\.azurelogicapps\dependencies\NodeJs\node
        Starta azurite automatiskt Aktiverat
        Designtid för automatisk start Aktiverat

    9. Om du har ett befintligt logikappsprojekt med anpassade definierade uppgifter som lagras i filen .vscode/tasks.json måste du spara filen tasks.json någon annanstans innan du öppnar projektet.

      När du öppnar projektet uppmanas du att uppdatera tasks.json fil för att använda nödvändiga beroenden. Om du väljer att fortsätta skriver tillägget över den tasks.json filen.

    10. När du öppnar logikappprojektet visas följande meddelanden:

      Meddelande Åtgärd
      Startar du alltid processen för bakgrundsdesign vid start? Om du vill öppna arbetsflödesdesignern snabbare väljer du Ja (rekommenderas).
      Konfigurera Azurite för automatisk start vid projektstart? Om du vill att Azurite Storage ska starta automatiskt när projektet öppnas väljer du Aktivera autostart. Längst upp i Visual Studio Code i kommandofönstret som visas trycker du på Retur för att acceptera standardsökvägen:

      C\Users\<your-user-name>\.azurelogicapps\.azurite

    Kända problem med förhandsversion

    • Om du har valt att automatiskt installera alla beroenden på en dator som inte har någon version av .NET Core SDK visas följande meddelande:

      ".NET Core SDK kan inte hittas: Fel vid körning av dotnet – info: Fel: Kommandot misslyckades: dotnet --info 'dotnet känns inte igen som ett internt eller externt kommando, ett fungerande program eller en batchfil. "dotnet" identifieras inte som ett internt eller externt kommando, ett fungerande program eller en batchfil. . .NET Core-felsökning aktiveras inte. Kontrollera att .NET Core SDK är installerat och är på sökvägen."

      Du får det här meddelandet eftersom .NET Core-ramverket fortfarande installeras när tillägget aktiveras. Du kan välja att inaktivera det här meddelandet på ett säkert sätt.

      Om du har problem med att öppna ett befintligt logikappsprojekt eller starta felsökningsaktiviteten (tasks.json) för func-värdstart, och det här meddelandet visas, följer du dessa steg för att lösa problemet:

      1. Lägg till den binära sökvägen för dotnet i path-variabeln för miljön.

        1. I sökrutan i Aktivitetsfältet i Windows anger du miljövariabler och väljer Redigera systemmiljövariablerna.

        2. I rutan Systemegenskaper går du till fliken Avancerat och väljer Miljövariabler.

        3. I rutan Miljövariabler går du till listan Användarvariabler för <ditt användarnamn> och väljer SÖKVÄG och sedan Redigera.

        4. Om följande värde inte visas i listan väljer du Nytt för att lägga till följande värde:

          C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK

        5. När du är klar väljer du OK.

      2. Stäng alla Visual Studio Code-fönster och öppna projektet igen.

    • Om du har problem med att installera och verifiera binära beroenden, till exempel:

      • Problem med Linux-behörigheter
      • Du får följande fel: <Filen eller sökvägen> finns inte
      • Verifieringen fastnar på beroendenamnet>.<

      Följ de här stegen för att köra kommandot Verifiera och installera binära beroenden igen:

      1. På menyn Visa väljer du Kommandopalett.

      2. När kommandofönstret visas anger du och kör kommandot Verifiera och installera binära beroenden .

    • Om du inte har installerat .NET Core 7 eller en senare version och öppnar en Azure Logic Apps-arbetsyta som innehåller ett Azure Functions-projekt får du följande meddelande:

      Det uppstod problem med att läsa in projektet [function-name].csproj. Mer information finns i loggen.

      Den saknade komponenten påverkar inte Azure Functions-projektet, så du kan ignorera det här meddelandet på ett säkert sätt.

    Installera varje beroende separat

    Dependency beskrivning
    .NET SDK 6.x.x Innehåller .NET Runtime 6.x.x, en förutsättning för Körning av Azure Logic Apps (Standard).
    Azure Functions Core Tools – 4.x-version - Windows: Använd Microsoft Installer-versionen (MSI), som är func-cli-X.X.XXXX-x*.msi.
    - macOS
    - Linux

    Dessa verktyg innehåller en version av samma körning som driver Azure Functions-körningen, som Tillägget Azure Logic Apps (Standard) använder i Visual Studio Code.

    Om du har en installation som är tidigare än dessa versioner avinstallerar du den versionen först eller kontrollerar att PATH-miljövariabeln pekar på den version som du laddar ned och installerar.
    Node.js version 16.x.x om inte en nyare version redan är installerad Krävs för att aktivera åtgärden Infogade kodåtgärder som kör JavaScript.

    Obs! Ladda ned MSI-versionen för Windows. Om du använder ZIP-versionen i stället måste du manuellt göra Node.js tillgängliga med hjälp av en PATH-miljövariabel för operativsystemet.

  4. Om du redan har installerat versionen av Tillägget Azure Logic Apps (Standard) som automatiskt installerar alla beroenden (förhandsversion) hoppar du över det här steget. Annars laddar du ned och installerar Tillägget Azure Logic Apps (Standard) för Visual Studio Code.

    1. Välj Tillägg i det vänstra verktygsfältet i Visual Studio Code.

    2. I sökrutan tillägg anger du azure logic apps standard. Välj Installera Azure Logic Apps (Standard)> i resultatlistan.

      När installationen är klar visas tillägget i listan Tillägg: Installerad .

      Skärmbild som visar Visual Studio Code med Tillägget Azure Logic Apps (Standard) installerat.

      Dricks

      Om tillägget inte visas i den installerade listan kan du prova att starta om Visual Studio Code.

    För närvarande kan du ha både förbrukningstillägg (flera klienter) och standardtillägg (en klientorganisation) installerade samtidigt. Utvecklingsupplevelserna skiljer sig från varandra på vissa sätt, men din Azure-prenumeration kan innehålla både standard- och förbrukningslogikapptyper. I Visual Studio Code visar Azure-fönstret alla Azure-distribuerade och värdbaserade logikappar i din Azure-prenumeration, men organiserar dina appar på följande sätt:

    • Avsnittet Logic Apps (Förbrukning): Alla förbrukningslogikappar i din prenumeration.

    • Avsnittet Resurser : Alla standardlogikappar i din prenumeration. Tidigare visades dessa logikappar i avsnittet Logic Apps (Standard), som nu har flyttats till avsnittet Resurser .

  5. Om du vill köra webhook-baserade utlösare och åtgärder lokalt, till exempel den inbyggda HTTP Webhook-utlösaren, måste du konfigurera vidarebefordran för återanrops-URL:en i Visual Studio Code.

  6. För att testa exempelarbetsflödet i den här artikeln behöver du ett verktyg som kan skicka anrop till slutpunkten som skapats av utlösaren Förfrågning. Om du inte har något sådant verktyg kan du ladda ned, installera och använda Postman-appen .

  7. Om du skapar dina logikappresurser med inställningar som stöder användning av Application Insights kan du aktivera diagnostikloggning och spårning för logikappresursen. Du kan göra det antingen när du skapar logikappen eller efter distributionen. Du måste ha en Application Insights-instans, men du kan skapa den här resursen i förväg, när du skapar logikappen eller efter distributionen.

Konfigurera Visual Studio Code

  1. För att se till att alla tillägg är korrekt installerade läser du in eller startar om Visual Studio Code.

  2. Bekräfta att Visual Studio Code automatiskt hittar och installerar tilläggsuppdateringar så att alla tillägg får de senaste uppdateringarna. Annars måste du avinstallera den inaktuella versionen manuellt och installera den senaste versionen.

    1. Gå till Inställningar> på arkivmenyn Inställningar.

    2. Gå till Funktionstillägg> på fliken Användare.

    3. Bekräfta att Automatisk kontroll Uppdateringar är markerat och att Automatisk uppdatering är inställt på Alla tillägg.

  3. Bekräfta att inställningen Azure Logic Apps Standard: Project Runtime för Tillägget Azure Logic Apps (Standard) är inställd på version ~4:

    Kommentar

    Den här versionen krävs för att använda åtgärderna infogad kod.

    1. Gå till Inställningar> på arkivmenyn Inställningar.

    2. Gå till >Tillägg>Azure Logic Apps (Standard) på fliken Användare.

      Du kan till exempel hitta inställningen Azure Logic Apps Standard: Project Runtime här eller använda sökrutan för att hitta andra inställningar:

      Skärmbild som visar Visual Studio Code-inställningar för Tillägget Azure Logic Apps (Standard).

Anslut till ditt Azure-konto

  1. I aktivitetsfältet i Visual Studio Code väljer du Azure-ikonen.

    Skärmbild som visar Aktivitetsfältet i Visual Studio Code och den valda Azure-ikonen.

  2. I Azure-fönstret under Resurser väljer du Logga in på Azure. När autentiseringssidan för Visual Studio Code visas loggar du in med ditt Azure-konto.

    Skärmbild som visar Azure-fönstret och den valda länken för Azure-inloggning.

    När du har loggat in visar Azure-fönstret de Azure-prenumerationer som är associerade med ditt Azure-konto. Om de förväntade prenumerationerna inte visas eller om du vill att fönstret endast ska visa specifika prenumerationer följer du dessa steg:

    1. I prenumerationslistan flyttar du pekaren bredvid den första prenumerationen tills knappen Välj prenumerationer (filterikonen) visas. Välj filterikon.

      Skärmbild som visar Azure-fönstret med prenumerationer och den valda filterikonen.

      I statusfältet i Visual Studio Code väljer du ditt Azure-konto.

    2. När en annan prenumerationslista visas väljer du de prenumerationer som du vill använda och kontrollerar sedan att du väljer OK.

Skapa ett lokalt projekt

Innan du kan skapa logikappen skapar du ett lokalt projekt så att du kan hantera, köra och distribuera logikappen från Visual Studio Code. Det underliggande projektet liknar ett Azure Functions-projekt, även kallat ett funktionsappsprojekt. Dessa projekttyper är dock separata från varandra, så logikappar och funktionsappar kan inte finnas i samma projekt.

  1. På datorn skapar du en tom lokal mapp som ska användas för projektet som du senare skapar i Visual Studio Code.

  2. Stäng alla öppna mappar i Visual Studio Code.

  3. I Azure-fönstret går du till verktygsfältet Arbetsyta i menyn Azure Logic Apps och väljer Skapa nytt projekt.

    Skärmbild som visar Azure-fönstret, verktygsfältet Arbetsyta och Azure Logic Apps-menyn med Skapa nytt projekt valt.

  4. Om Windows Defender-brandväggen uppmanar dig att bevilja nätverksåtkomst för Code.exe, vilket är Visual Studio Code, och för func.exe, som är Azure Functions Core Tools, väljer du Privata nätverk, till exempel mitt hem- eller arbetsnätverk>Tillåt åtkomst.

  5. Bläddra till platsen där du skapade projektmappen, välj den mappen och fortsätt.

    Skärmbild som visar rutan Välj mapp och ny projektmapp med knappen Välj markerad.

  6. I malllistan som visas väljer du antingen Tillståndskänsligt arbetsflöde eller Tillståndslöst arbetsflöde. I det här exemplet väljs Tillståndskänsligt arbetsflöde.

    Skärmbild som visar listan över arbetsflödesmallar med tillståndskänsligt arbetsflöde valt.

  7. Ange ett namn för arbetsflödet och tryck på Retur. I det här exemplet används Stateful-Workflow som namn.

    Skärmbild som visar rutan Skapa nytt tillståndskänsligt arbetsflöde (3/4) och arbetsflödesnamnet Tillståndskänsligt arbetsflöde.

    Kommentar

    Du kan få ett fel med namnet azureLogicAppsStandard.createNewProject med felmeddelandet, Det går inte att skriva till arbetsytan Inställningar eftersom azureFunctions.suppressProject inte är en registrerad konfiguration. Om du gör det kan du prova att installera Azure Functions-tillägget för Visual Studio Code, antingen direkt från Visual Studio Marketplace eller inifrån Visual Studio Code.

  8. Om Visual Studio Code uppmanar dig att öppna projektet i den aktuella Visual Studio Code eller i ett nytt Visual Studio Code-fönster väljer du Öppna i det aktuella fönstret. Annars väljer du Öppna i nytt fönster.

    Visual Studio Code har skapat projektet.

  9. Från Aktivitetsfältet i Visual Studio öppnar du fönstret Utforskaren, om den inte redan är öppen.

    Fönstret Utforskaren visar projektet, som nu innehåller automatiskt genererade projektfiler. Projektet har till exempel en mapp som visar arbetsflödets namn. I den här mappen innehåller workflow.json-filen arbetsflödets underliggande JSON-definition.

    Skärmbild som visar utforskarfönstret med projektmapp, arbetsflödesmapp och workflow.json fil.

    I Visual Studio Code har logikappprojektet någon av följande typer:

    • Tilläggspaketbaserad (Node.js), som är standardtypen
    • NuGet-paketbaserad (.NET), som du kan konvertera från standardtypen

    Baserat på dessa typer innehåller projektet lite olika mappar och filer. Ett NuGet-baserat projekt innehåller en .bin mapp som innehåller paket och andra biblioteksfiler. Ett paketbaserat projekt innehåller inte mappen .bin och andra filer. Vissa scenarier kräver ett NuGet-baserat projekt för att appen ska kunna köras, till exempel när du vill utveckla och köra anpassade inbyggda åtgärder. Mer information om hur du konverterar projektet till att använda NuGet finns i Aktivera redigering av inbyggd anslutningsapp.

    För det standardpaketbaserade projektet har projektet en mapp och filstruktur som liknar följande exempel:

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

    På projektets rotnivå hittar du följande filer och mappar med andra objekt:

    Name Mapp eller fil beskrivning
    .vscode Mapp Innehåller Visual Studio Code-relaterade inställningsfiler, till exempel extensions.json, launch.json, settings.json och tasks.json filer.
    Artefakter Mapp Innehåller artefakter för integrationskonto som du definierar och använder i arbetsflöden som stöder B2B-scenarier (business-to-business). Exempelstrukturen innehåller till exempel kartor och scheman för XML-transformerings- och valideringsåtgärder.
    <WorkflowName> Mapp För varje arbetsflöde <innehåller mappen WorkflowName> en workflow.json fil som innehåller arbetsflödets underliggande JSON-definition.
    workflow-designtime Mapp Innehåller filer för miljörelaterade inställningar för utveckling.
    .funcignore Fil Innehåller information om dina installerade Azure Functions Core Tools.
    connections.json Fil Innehåller metadata, slutpunkter och nycklar för alla hanterade anslutningar och Azure-funktioner som dina arbetsflöden använder.

    Viktigt: Om du vill använda olika anslutningar och funktioner för varje miljö måste du parametrisera den här connections.json filen och uppdatera slutpunkterna.
    host.json Fil Innehåller körningsspecifika konfigurationsinställningar och värden, till exempel standardgränserna för Azure Logic Apps-plattformen med en enda klient, logikappar, arbetsflöden, utlösare och åtgärder. På rotnivån för logikappsprojektet innehåller den host.json metadatafilen de konfigurationsinställningar och standardvärden som alla arbetsflöden i samma logikapp använder när de körs, oavsett om de körs lokalt eller i Azure.

    Obs! När du skapar logikappen skapar Visual Studio Code en säkerhetskopieringsvärd.ögonblicksbild .*.json fil i lagringscontainern. Om du tar bort logikappen tas inte den här säkerhetskopieringsfilen bort. Om du skapar en annan logikapp med samma namn skapas en annan ögonblicksbildsfil. Du kan bara ha upp till 10 ögonblicksbilder för samma logikapp. Om du överskrider den här gränsen får du följande fel:

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

    Lös det här felet genom att ta bort de extra ögonblicksbildfilerna från lagringscontainern.
    local.settings.json Fil Innehåller appinställningar, anslutningssträng och andra inställningar som dina arbetsflöden använder när de körs lokalt. Med andra ord gäller dessa inställningar och värden endast när du kör dina projekt i din lokala utvecklingsmiljö. Under distributionen till Azure ignoreras filen och inställningarna och ingår inte i distributionen.

    Den här filen lagrar inställningar och värden som lokala miljövariabler som används av dina lokala utvecklingsverktyg som appSettings värden. Du kan anropa och referera till dessa miljövariabler både vid körning och distributionstid med hjälp av appinställningar och parametrar.

    Viktigt: Den local.settings.json filen kan innehålla hemligheter, så se till att du även exkluderar den här filen från projektkällans kontroll.

Konvertera projektet till NuGet-paketbaserat (.NET)

Visual Studio Code skapar som standard ett logikappsprojekt som är tilläggspaketbaserat (Node.js), inte NuGet-paketbaserat (.NET). Om du behöver ett logikappsprojekt som är NuGet-paketbaserat (.NET), till exempel för att aktivera inbyggd anslutningsredigering, måste du konvertera projektet från tilläggspaketbaserad (Node.js) till NuGet-paketbaserad (.NET).

Viktigt!

Den här åtgärden är en enkelriktad åtgärd som du inte kan ångra.

  1. I utforskarfönstret går du till projektets rot och flyttar muspekaren över ett tomt område under alla andra filer och mappar, öppnar snabbmenyn och väljer Konvertera till NuGet-baserat Logic App-projekt.

    Skärmbild som visar Explorer-fönstret med snabbmenyn projekt öppen från ett tomt område i projektfönstret.

  2. När prompten visas bekräftar du projektkonverteringen.

Aktivera inbyggd anslutningsredigering

Du kan skapa egna inbyggda anslutningsappar för alla tjänster du behöver med hjälp av utökningsramverket för Azure Logic Apps med en enda klientorganisation. På samma sätt som inbyggda anslutningsappar som Azure Service Bus och SQL Server ger dessa anslutningsappar högre dataflöde, låg svarstid, lokal anslutning och körs internt i samma process som Azure Logic Apps-körningen med en klientorganisation.

Redigeringsfunktionen är för närvarande endast tillgänglig i Visual Studio Code, men är inte aktiverad som standard. Följ dessa steg för att skapa dessa anslutningsappar:

  1. Om du inte redan har gjort det konverterar du projektet från tilläggspaketbaserat (Node.js) till NuGet-paketbaserat (.NET).

  2. Granska och följ stegen i artikeln Azure Logic Apps Running Anywhere – Inbyggd utökningsbarhet för anslutningsprogram.

Lägga till anpassade artefakter i projektet

I ett logikapparbetsflöde har vissa anslutningsappar beroenden av artefakter som kartor, scheman eller sammansättningar. I Visual Studio Code kan du ladda upp dessa artefakter till ditt logikappsprojekt, ungefär som du kan ladda upp dessa artefakter i Azure-portalen via logikappens resursmeny under Artefakter, till exempel:

Skärmbild som visar resursmenyn för Azure-portalen och standardlogiken med avsnittet Artefakter markerat.

Lägga till kartor i projektet

Om du vill lägga till kartor i projektet expanderar >du Artefakter i projekthierarkin Kartor, som är mappen där du kan placera dina kartor.

Skärmbild som visar Visual Studio Code-projekthierarki med artefakter och Kartor mappar expanderade.

Lägga till scheman i projektet

Om du vill lägga till scheman i projektet expanderar >du Artefakter scheman i projekthierarkin, som är den mapp där du kan placera dina scheman.

Skärmbild som visar Visual Studio Code-projekthierarki med mappar för artefakter och scheman expanderade.

Lägga till sammansättningar i projektet

En standardlogikapp kan använda eller referera till specifika typer av sammansättningar, som du kan ladda upp till ditt projekt i Visual Studio Code. Du måste dock lägga till dem i specifika mappar i projektet. I följande tabell finns mer information om varje sammansättningstyp och exakt var de ska placeras i projektet.

Sammansättningstyp beskrivning
Klient-/SDK-sammansättning (.NET Framework) Den här sammansättningstypen tillhandahåller lagring och distribution av klient- och anpassad SDK för .NET Framework. Den inbyggda SAP-anslutningsappen använder till exempel dessa sammansättningar för att läsa in SAP NCo:s icke-omdistribuerbara DLL-filer.

Se till att du lägger till dessa sammansättningar i följande mapp: \lib\builtinOperationSdks\net472
Klient-/SDK-sammansättning (Java) Den här sammansättningstypen tillhandahåller lagring och distribution av anpassad SDK för Java. Den inbyggda JDBC-anslutningsappen använder till exempel dessa JAR-filer för att hitta JDBC-drivrutiner för anpassade relationsdatabaser (RDB).

Lägg till dessa sammansättningar i följande mapp: \lib\builtinOperationSdks\JAR
Anpassad sammansättning (.NET Framework) Den här sammansättningstypen tillhandahåller lagring och distribution av anpassade DLL:er. Till exempel använder XML-transformeringsåtgärden dessa sammansättningar för de anpassade transformeringsfunktioner som krävs under XML-omvandlingen.

Lägg till dessa sammansättningar i följande mapp: \lib\custom\net472

Följande bild visar var varje sammansättningstyp ska placeras i projektet:

Skärmbild som visar Visual Studio Code, logikappsprojekt och var sammansättningar ska laddas upp.

Mer information om hur du laddar upp sammansättningar till din logikappresurs i Azure-portalen finns i Lägga till refererade sammansättningar.

Migrera NuGet-baserade projekt för att använda "lib\*"-sammansättningar

Viktigt!

Den här uppgiften krävs endast för NuGet-baserade logikappsprojekt.

Om du skapade logikappprojektet när sammansättningsstöd inte var tillgängligt för standardarbetsflöden för logikappar kan du lägga till följande rader i <filen project-name.csproj> för att arbeta med projekt som använder sammansättningar:

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

Viktigt!

För ett projekt som körs på Linux eller MacOS måste du uppdatera katalogavgränsaren. Granska till exempel följande bild som visar den tidigare koden som lades till i <filen project-name.csproj>.

Skärmbild som visar migrerade sammansättningar och tillagd kod i CSPROJ-filen.

Öppna arbetsflödesdefinitionsfilen i designern

  1. Expandera arbetsflödets projektmapp, som heter Stateful-Workflow i det här exemplet, och öppna filen workflow.json .

  2. Öppna snabbmenyn för workflow.json-filen och välj Öppna designer.

    Skärmbild som visar utforskarfönstret, workflow.json snabbmeny och Open Designer valt.

  3. När listan Aktivera anslutningsappar i Azure öppnas väljer du Använd anslutningsappar från Azure, som gäller för alla hanterade eller "delade" anslutningsappar, som finns och körs i Azure jämfört med de inbyggda, inbyggda eller "in-app"-anslutningsprogram som körs direkt med Azure Logic Apps-körningen.

    Skärmbild som visar Explorer-fönstret, en öppen lista med namnet Aktivera anslutningsappar i Azure och valt alternativ för Att använda anslutningsappar från Azure.

    Kommentar

    Tillståndslösa arbetsflöden stöder för närvarande endast åtgärder från hanterade anslutningsappar, inte utlösare. Även om du har möjlighet att aktivera anslutningsappar i Azure för ditt tillståndslösa arbetsflöde, visar designern inga utlösare för hanterade anslutningsappar som du kan välja.

  4. När listan Välj prenumeration har öppnats väljer du den Azure-prenumeration som ska användas för ditt logikappsprojekt.

    Skärmbild som visar Explorer-fönstret med listan Välj prenumeration och en vald prenumeration.

  5. När listan med resursgrupper har öppnats väljer du Skapa ny resursgrupp.

    Skärmbild som visar fönstret Utforskaren med resursgrupper och valt alternativ för att skapa en ny resursgrupp.

  6. Ange ett namn för resursgruppen och tryck på Retur. I det här exemplet används Fabrikam-Workflows-RG.

    Skärmbild som visar fönstret Utforskaren och namnrutan för resursgrupper.

  7. I listan platser väljer du den Azure-region som ska användas när du skapar resursgruppen och resurserna. I det här exemplet används USA, västra centrala.

    Skärmbild som visar Explorer-fönstret med platslistan och

    När du har slutfört det här steget öppnar Visual Studio Code arbetsflödesdesignern.

    Kommentar

    När Visual Studio Code startar arbetsflödets designtids-API kan du få ett meddelande om att det kan ta några sekunder att starta. Du kan ignorera det här meddelandet eller välja OK.

    Om designern inte öppnas går du igenom felsökningsavsnittet. Designern kan inte öppnas.

    När designern visas visas kommandotolken Lägg till en utlösare i designern.

  8. I designern väljer du Lägg till en utlösare, som öppnar fönstret Lägg till en utlösare och ett galleri som visar alla anslutningsappar som har utlösare som du kan välja.

    Skärmbild som visar arbetsflödesdesignern, den valda prompten med namnet Lägg till en utlösare och galleriet för anslutningsappar med utlösare.

  9. Lägg sedan till en utlösare och åtgärder i arbetsflödet.

Lägga till en utlösare och åtgärder

När du har öppnat ett tomt arbetsflöde i designern visas kommandotolken Lägg till en utlösare i designern. Nu kan du börja skapa arbetsflödet genom att lägga till en utlösare och åtgärder.

Viktigt!

Om du vill köra ett arbetsflöde lokalt som använder en webhook-baserad utlösare eller åtgärder, till exempel den inbyggda HTTP Webhook-utlösaren eller åtgärden, måste du aktivera den här funktionen genom att konfigurera vidarebefordran för webhookens återanrops-URL.

Arbetsflödet i det här exemplet använder följande utlösare och åtgärder:

Lägg till utlösaren Förfrågning

  1. I arbetsflödesdesignern går du till fönstret Lägg till en utlösare , öppnar listan Runtime och väljer In-App så att du bara visar de tillgängliga inbyggda anslutningsutlösarna.

  2. Leta reda på utlösaren Förfrågning med namnet När en HTTP-begäran tas emot med hjälp av sökrutan och lägg till utlösaren i arbetsflödet. Mer information finns i Skapa ett arbetsflöde med en utlösare och åtgärder.

    Skärmbild som visar arbetsflödesdesignern, fönstret Lägg till en utlösare och den valda utlösaren med namnet När en HTTP-begäran tas emot.

    När utlösaren visas i designern öppnas utlösarens informationsfönster och visar utlösarens parametrar, inställningar och andra relaterade uppgifter.

    Skärmbild som visar informationsfönstret för utlösaren med namnet När en HTTP-begäran tas emot.

    Dricks

    Om informationsfönstret inte visas kontrollerar du att utlösaren är markerad i designern.

  3. Spara arbetsflödet. I verktygsfältet för designern väljer du Spara.

Om du behöver ta bort ett objekt från designern följer du de här stegen för att ta bort objekt från designern.

Lägg till office 365 Outlook-åtgärden

  1. Välj plustecknet (+) >Lägg till en åtgärd under utlösaren Begäran i designern.

  2. I fönstret Lägg till en åtgärd som öppnas går du till listan Runtime och väljer Delat så att du endast visar tillgängliga åtgärder för hanterade anslutningsappar.

  3. Leta upp åtgärden för office 365 Outlook-hanterad anslutningsapp med namnet Skicka ett e-postmeddelande (V2) med hjälp av sökrutan och lägg till den åtgärden i arbetsflödet. Mer information finns i Skapa ett arbetsflöde med en utlösare och åtgärder.

    Skärmbild som visar arbetsflödesdesignern och Lägg till ett åtgärdsfönster med den valda Office 365 Outlook-åtgärden med namnet Skicka ett e-postmeddelande.

  4. När åtgärdens autentiseringsfönster öppnas väljer du Logga in för att skapa en anslutning till ditt e-postkonto.

    Skärmbild som visar åtgärden Skicka ett e-postmeddelande (V2) med den valda inloggningsknappen.

  5. Följ de efterföljande anvisningarna för att välja ditt konto, tillåta åtkomst och tillåta att du återgår till Visual Studio Code.

    Kommentar

    Om för mycket tid går innan du slutför anvisningarna överskrider autentiseringsprocessen tidsgränsen och misslyckas. I det här fallet går du tillbaka till designern och försöker logga in igen för att skapa anslutningen.

    1. När Microsoft-prompten visas väljer du användarkontot för Office 365 Outlook och väljer sedan Tillåt åtkomst.

    2. När Azure Logic Apps uppmanas att öppna en Visual Studio Code-länk väljer du Öppna.

      Skärmbild som visar uppmaningen att öppna länken för Visual Studio Code.

    3. När Visual Studio Code uppmanas att öppna Microsoft Azure Tools väljer du Öppna.

      Skärmbild som visar uppmaningen att öppna Microsoft Azure-verktyg.

    Dricks

    Om du vill hoppa över sådana framtida frågor väljer du följande alternativ när de associerade prompterna visas:

    • Behörighet att öppna länken för Visual Studio Code: Välj Tillåt alltid logic-apis-westcentralus.consent.azure-apim.net att öppna länkar av den här typen i den associerade appen. Den här domänen ändras baserat på den Azure-region som du valde för din logikappresurs.

    • Behörighet att öppna Microsoft Azure Tools: Välj Fråga inte igen om det här tillägget.

    När Visual Studio Code har skapat anslutningen visar vissa anslutningsappar meddelandet att Anslutningen endast är giltig i {n} dagar. Den här tidsgränsen gäller endast för varaktigheten när du skapar logikappens arbetsflöde i Visual Studio Code. Efter distributionen gäller inte längre den här gränsen eftersom arbetsflödet kan autentisera vid körning med hjälp av den automatiskt aktiverade systemtilldelade hanterade identiteten. Den här hanterade identiteten skiljer sig från autentiseringsuppgifterna eller anslutningssträng som du använder när du skapar en anslutning. Om du inaktiverar den här systemtilldelade hanterade identiteten fungerar inte anslutningar vid körning.

  6. Om åtgärden Skicka ett e-postmeddelande inte visas markerad i designern väljer du den åtgärden.

  7. På fliken Parametrar i åtgärdsinformationsfönstret anger du nödvändig information för åtgärden, till exempel:

    Skärmbild som visar information om Office 365 Outlook-åtgärden med namnet Skicka ett e-postmeddelande.

    Property Obligatoriskt Värde beskrivning
    To Ja <your-email-address> E-postmottagaren, som kan vara din e-postadress i testsyfte. I det här exemplet används det fiktiva e-postmeddelandet, sophia.owen@fabrikam.com.
    Ämne Ja Ett e-postmeddelande från ditt exempelarbetsflöde E-postämnet
    Brödtext Ja Hej från ditt exempelarbetsflöde! Innehållet i e-postmeddelandets brödtext

    Kommentar

    Om du gör några ändringar på fliken Testning kontrollerar du att du väljer Spara för att genomföra ändringarna innan du växlar flikar eller ändrar fokus till designern. Annars behåller Inte Visual Studio Code dina ändringar.

  8. Spara arbetsflödet. I designern väljer du Spara.

Aktivera webhooks som körs lokalt

När du använder en webhook-baserad utlösare eller åtgärd, till exempel HTTP Webhook, med ett logikapparbetsflöde som körs i Azure, prenumererar Azure Logic Apps-körningen på tjänstslutpunkten genom att generera och registrera en motringnings-URL med slutpunkten. Utlösaren eller åtgärden väntar sedan på att tjänstslutpunkten ska anropa URL:en. Men när du arbetar i Visual Studio Code börjar den genererade återanrops-URL:en med http://localhost:7071/.... Den här URL:en är för din localhost-server, som är privat så att tjänstslutpunkten inte kan anropa den här URL:en.

Om du vill köra webhook-baserade utlösare och åtgärder lokalt i Visual Studio Code måste du konfigurera en offentlig URL som exponerar din localhost-server och vidarebefordrar anrop från tjänstslutpunkten på ett säkert sätt till url:en för webhook-återanrop. Du kan använda en vidarebefordringstjänst och ett verktyg som ngrok, som öppnar en HTTP-tunnel till din localhost-port, eller så kan du använda ditt eget motsvarande verktyg.

Konfigurera vidarekoppling av samtal med ngrok

  1. Gå till ngrok-webbplatsen. Registrera dig för ett nytt konto eller logga in på ditt konto, om du redan har ett.

  2. Hämta din personliga autentiseringstoken, som din ngrok-klient behöver för att ansluta och autentisera åtkomsten till ditt konto.

    1. Om du vill hitta sidan med autentiseringstoken går du till instrumentpanelens meny för kontot, expanderar Autentisering och väljer Din authtoken.

    2. Från rutan Din authtoken kopierar du token till en säker plats.

  3. Från nedladdningssidan för ngrok eller instrumentpanelen för ditt konto laddar du ned den ngrokversion som du vill använda och extraherar .zip-filen. Mer information finns i Steg 1: Packa upp för att installera.

  4. Öppna kommandotolken på datorn. Bläddra till den plats där du har filen ngrok.exe .

  5. Anslut ngrok-klienten till ditt ngrok-konto genom att köra följande kommando. Mer information finns i Steg 2: Anslut ditt konto.

    ngrok authtoken <your_auth_token>

  6. Öppna HTTP-tunneln till localhost-port 7071 genom att köra följande kommando. Mer information finns i Steg 3: Starta den.

    ngrok http 7071

  7. Leta upp följande rad i utdata:

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

  8. Kopiera och spara den URL som har det här formatet: http://<domain>.ngrok.io

Konfigurera vidarebefordran-URL:en i dina appinställningar

  1. I Visual Studio Code i designern lägger du till den webhook-baserade utlösare eller åtgärd som du vill använda.

    Det här exemplet fortsätter med HTTP + Webhook-utlösaren .

  2. När uppmaningen visas för platsen för värdslutpunkten anger du den vidarebefordrans-URL (omdirigering) som du skapade tidigare.

    Kommentar

    Om du ignorerar uppmaningen visas en varning om att du måste ange vidarebefordran-URL:en, så välj Konfigurera och ange URL:en. När du har slutfört det här steget visas inte uppmaningen för efterföljande webhooksutlösare eller åtgärder som du kan lägga till.

    Om du vill att prompten ska visas öppnar du snabbmenyn för local.settings.json-filen på projektets rotnivå och väljer Konfigurera Webhook-omdirigeringsslutpunkt. Uppmaningen visas nu så att du kan ange vidarebefordran-URL:en.

    Visual Studio Code lägger till vidarebefordrans-URL:en till local.settings.json-filen i projektets rotmapp. Values I -objektet visas egenskapen som heter Workflows.WebhookRedirectHostUri nu och är inställd på vidarebefordran-URL:en, till exempel:

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

Första gången du startar en lokal felsökningssession eller kör arbetsflödet utan felsökning registrerar Azure Logic Apps-körningen arbetsflödet med tjänstslutpunkten och prenumererar på slutpunkten för att meddela webhook-åtgärderna. Nästa gång arbetsflödet körs registreras inte körningen eller prenumerationen på nytt eftersom prenumerationsregistreringen redan finns i lokal lagring.

När du stoppar felsökningssessionen för en arbetsflödeskörning som använder lokalt kör webhook-baserade utlösare eller åtgärder tas inte de befintliga prenumerationsregistreringarna bort. Om du vill avregistrera måste du ta bort eller ta bort prenumerationsregistreringarna manuellt.

Kommentar

När arbetsflödet har börjat köras kan terminalfönstret visa fel som det här exemplet:

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.'

I det här fallet öppnar du filen local.settings.json i projektets rotmapp och kontrollerar att egenskapen är inställd på true:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Hantera brytpunkter för felsökning

Innan du kör och testar logikappens arbetsflöde genom att starta en felsökningssession kan du ange brytpunkter i workflow.json-filen för varje arbetsflöde. Ingen annan konfiguration krävs.

För närvarande stöds brytpunkter endast för åtgärder, inte utlösare. Varje åtgärdsdefinition har följande brytpunktsplatser:

  • Ange start brytpunkten på raden som visar åtgärdens namn. När den här brytpunkten når under felsökningssessionen kan du granska åtgärdens indata innan de utvärderas.

  • Ange den avslutande brytpunkten på raden som visar åtgärdens avslutande klammerparentes (}). När den här brytpunkten träffar under felsökningssessionen kan du granska åtgärdens resultat innan åtgärden är klar.

Följ dessa steg för att lägga till en brytpunkt:

  1. Öppna filen workflow.json för arbetsflödet som du vill felsöka.

  2. På den rad där du vill ange brytpunkten väljer du i den vänstra kolumnen inuti den kolumnen. Om du vill ta bort brytpunkten väljer du den brytpunkten.

    När du startar felsökningssessionen visas körningsvyn till vänster i kodfönstret, medan verktygsfältet Felsökning visas längst upp.

    Kommentar

    Om vyn Kör inte visas automatiskt trycker du på Ctrl+Skift+D.

  3. Granska den tillgängliga informationen när en brytpunkt visas i vyn Kör i fönstret Variabler .

  4. Om du vill fortsätta arbetsflödeskörningen går du till verktygsfältet Felsökning och väljer Fortsätt (uppspelningsknapp).

Du kan lägga till och ta bort brytpunkter när som helst under arbetsflödeskörningen. Men om du uppdaterar workflow.json-filen när körningen startar uppdateras inte brytpunkterna automatiskt. Om du vill uppdatera brytpunkterna startar du om logikappen.

Allmän information finns i Brytpunkter – Visual Studio Code.

Köra, testa och felsöka lokalt

Om du vill testa logikappens arbetsflöde följer du de här stegen för att starta en felsökningssession och letar reda på URL:en för slutpunkten som skapas av utlösaren Förfrågning. Du behöver den här URL:en så att du senare kan skicka en begäran till slutpunkten.

  1. Om du vill felsöka ett tillståndslöst arbetsflöde enklare kan du aktivera körningshistoriken för arbetsflödet.

  2. Om Azurite-emulatorn redan körs fortsätter du till nästa steg. Annars bör du starta emulatorn innan du kör arbetsflödet:

    1. I Visual Studio Code går du till menyn Visa och väljer Kommandopalett.

    2. När kommandopaletten visas anger du Azurite: Start.

    Mer information om Azurite-kommandon finns i dokumentationen för Azurite-tillägget i Visual Studio Code.

  3. Öppna menyn Kör i Aktivitetsfältet i Visual Studio Code och välj Starta felsökning (F5).

    Terminalfönstret öppnas så att du kan granska felsökningssessionen.

    Kommentar

    Om du får felet "Felet finns efter att du har kört preLaunchTask 'generateDebugSymbols'", se felsökningsavsnittet, felsökningssessionen kan inte starta.

  4. Leta nu upp motringnings-URL:en för slutpunkten i utlösaren Förfrågning.

    1. Öppna fönstret Utforskaren igen så att du kan visa projektet.

    2. På snabbmenyn för workflow.json-filen väljer du Översikt.

      Skärmbild som visar utforskarfönstret, workflow.json filens snabbmeny med det valda alternativet Översikt.

    3. Leta reda på värdet för motringnings-URL som liknar den här URL:en för exempelutlösaren Förfrågning:

      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>

      Skärmbild som visar arbetsflödesöversiktssidan med motringnings-URL.

  5. Om du vill testa återanrops-URL:en genom att utlösa arbetsflödet för logikappen öppnar du Postman eller önskat verktyg för att skapa och skicka begäranden.

    Det här exemplet fortsätter med Postman. Mer information finns i Komma igång med Postman.

    1. I verktygsfältet Postman väljer du Nytt.

      Skärmbild som visar Postman med knappen Ny markerad

    2. I fönstret Skapa ny går du till Byggblock och väljer Begär.

    3. I fönstret Spara begäran under Begäransnamn anger du ett namn för begäran, till exempel testarbetsflödesutlösare.

    4. Under Välj en samling eller mapp att spara till väljer du Skapa samling.

    5. Under Alla samlingar anger du ett namn för samlingen som ska skapas för att organisera dina begäranden, trycker på Retur och väljer Spara till <samlingsnamn>. I det här exemplet används Logic Apps-begäranden som samlingsnamn.

      I Postman öppnas fönstret Förfrågning så att du kan skicka en begäran till motringnings-URL:en för utlösaren Förfrågning.

      Skärmbild som visar Postman med det öppnade fönstret för begäran.

    6. Gå tillbaka till Visual Studio Code. Från arbetsflödets översiktssida kopierar du egenskapsvärdet för återanrops-URL.

    7. Gå tillbaka till Postman. I fönstret för begäran, bredvid metodlistan, som för närvarande visar GET som standardmetod för begäran, klistrar du in motringnings-URL:en som du tidigare kopierade i adressrutan och väljer Skicka.

      Skärmbild som visar Postman- och motringnings-URL i adressrutan med knappen Skicka markerad.

      Exempelarbetsflödet för logikappen skickar ett e-postmeddelande som liknar det här exemplet:

      Skärmbild som visar Outlook-e-post enligt beskrivningen i exemplet.

  6. Gå tillbaka till arbetsflödets översiktssida i Visual Studio Code.

    Om du har skapat ett tillståndskänsligt arbetsflöde efter den begäran som du skickade utlöser arbetsflödet visar översiktssidan arbetsflödets körningsstatus och historik.

    Dricks

    Om körningsstatusen inte visas kan du prova att uppdatera översiktssidan genom att välja Uppdatera. Ingen körning sker för en utlösare som hoppas över på grund av ouppfyllda kriterier eller att inga data hittas.

    Skärmbild som visar arbetsflödets översiktssida med körningsstatus och historik

    I följande tabell visas möjliga slutgiltiga statusar som varje arbetsflödeskörning kan ha och visas i Visual Studio Code:

    Körningsstatus beskrivning
    Avbröts Körningen stoppades eller avslutades inte på grund av externa problem, till exempel ett systemavbrott eller en förfallen Azure-prenumeration.
    Avbröts Körningen utlöstes och startades men fick en annulleringsbegäran.
    Misslyckades Minst en åtgärd i körningen misslyckades. Inga efterföljande åtgärder i arbetsflödet har konfigurerats för att hantera felet.
    Körs Körningen utlöstes och pågår, men den här statusen kan också visas för en körning som begränsas på grund av åtgärdsbegränsningar eller den aktuella prisplanen.

    Tips: Om du konfigurerar diagnostikloggning kan du få information om eventuella begränsningshändelser som inträffar.
    Lyckades Körningen lyckades. Om någon åtgärd misslyckades hanterade en efterföljande åtgärd i arbetsflödet det felet.
    Tidsgränsen överskrids Tidsgränsen för körningen överskreds eftersom den aktuella varaktigheten överskred gränsen för körningens varaktighet, vilket styrs av inställningen Kvarhållning av körningshistorik i dagar. En körnings varaktighet beräknas med hjälp av körningens starttid och körningens varaktighetsgräns vid den starttiden.

    Obs! Om körningens varaktighet också överskrider den aktuella kvarhållningsgränsen för körningshistorik, som också styrs av inställningen Körningshistorik i dagar, rensas körningen från körningshistoriken av ett dagligt rensningsjobb. Oavsett om körningen överskrider tidsgränsen eller slutförs beräknas kvarhållningsperioden alltid med hjälp av körningens starttid och aktuella kvarhållningsgräns. Så om du minskar varaktighetsgränsen för en körning under flygning överskrider körningen tidsgränsen. Körningen förblir dock eller rensas från körningshistoriken baserat på om körningens varaktighet överskred kvarhållningsgränsen.
    Väntar Körningen har inte startats eller pausats, till exempel på grund av en tidigare arbetsflödesinstans som fortfarande körs.

  7. Om du vill granska status för varje steg i en specifik körning och stegets indata och utdata väljer du knappen ellipser (...) för den körningen och väljer Visa körning.

    Skärmbild som visar arbetsflödets körningshistorikrad med den valda ellipsknappen och Visa körning.

    Visual Studio Code öppnar övervakningsvyn och visar status för varje steg i körningen.

    Skärmbild som visar varje steg i arbetsflödeskörningen och deras status.

    Kommentar

    Om en körning misslyckades och ett steg i övervakningsvyn visar felet 400 Felaktig begäran kan det här problemet bero på ett längre utlösarnamn eller åtgärdsnamn som gör att den underliggande URI:n (Uniform Resource Identifier) överskrider standardteckengränsen. Mer information finns i "400 Felaktig begäran".

    I följande tabell visas de möjliga statusar som varje arbetsflödesåtgärd kan ha och visa i Visual Studio Code:

    Åtgärdsstatus beskrivning
    Avbröts Åtgärden stoppades eller avslutades inte på grund av externa problem, till exempel ett systemavbrott eller en förfallen Azure-prenumeration.
    Avbröts Åtgärden kördes men fick en begäran om att avbryta.
    Misslyckades Åtgärden misslyckades.
    Körs Åtgärden körs för närvarande.
    Överhoppad Åtgärden hoppades över eftersom den omedelbart föregående åtgärden misslyckades. En åtgärd har ett runAfter villkor som kräver att föregående åtgärd slutförs innan den aktuella åtgärden kan köras.
    Lyckades Åtgärden lyckades.
    Lyckades med återförsök Åtgärden lyckades men bara efter en eller flera återförsök. Om du vill granska återförsökshistoriken väljer du den åtgärden i vyn körningshistorikinformation så att du kan visa indata och utdata.
    Tidsgränsen överskrids Åtgärden stoppades på grund av den tidsgräns som anges i inställningarna för åtgärden.
    Väntar Gäller för en webhook-åtgärd som väntar på en inkommande begäran från en anropare.

  8. Om du vill granska indata och utdata för varje steg väljer du det steg som du vill inspektera. Om du vill granska råa indata och utdata ytterligare för det steget väljer du Visa råa indata eller Visa råa utdata.

    Skärmbild som visar status för varje steg i arbetsflödet plus indata och utdata i expanderad åtgärd med namnet Skicka ett e-postmeddelande.

  9. Om du vill stoppa felsökningssessionen går du till menyn Kör och väljer Stoppa felsökning (Skift + F5).

Returnera ett svar

När du har ett arbetsflöde som börjar med utlösaren Begäran kan du returnera ett svar till anroparen som skickade en begäran till arbetsflödet med hjälp av den inbyggda åtgärden Begäran med namnet Svar.

  1. I arbetsflödesdesignern går du till åtgärden Skicka ett e-postmeddelande och väljer plustecknet (+) >Lägg till en åtgärd.

    Fönstret Lägg till en åtgärd öppnas så att du kan välja nästa åtgärd.

  2. I fönstret Lägg till en åtgärd går du till listan Runtime och väljer I-App. Leta upp och lägg till åtgärden Svar .

    När åtgärden Svar visas i designern öppnas åtgärdens informationsfönster automatiskt.

    Skärmbild som visar fönstret arbetsflödesdesigner och svarsinformation.

  3. På fliken Parametrar anger du nödvändig information för den funktion som du vill anropa.

    Det här exemplet returnerar parametervärdet Brödtext , vilket är utdata från åtgärden Skicka ett e-postmeddelande .

    1. För parametern Brödtext väljer du i redigeringsrutan och väljer blixtikonen, som öppnar listan med dynamiskt innehåll. Den här listan visar tillgängliga utdatavärden från föregående utlösare och åtgärder i arbetsflödet.

    2. I listan med dynamiskt innehåll går du till Skicka ett e-postmeddelande och väljer Brödtext.

      Skärmbild som visar en lista med dynamiskt innehåll där värdet För brödtextutdata är markerat under Skicka ett e-postmeddelande.

      När du är klar har egenskapen Svarsåtgärdens brödtext nu angetts till utdatavärdet Skicka ett e-postmeddelande.

      Skärmbild som visar arbetsflödesdesignern, fönstret Svarsinformation och brödtextparametern inställd på Brödtextvärde för åtgärden Skicka ett e-postmeddelande.

  4. I designern väljer du Spara.

Testa logikappen igen

När du har uppdaterat logikappen kan du köra ett nytt test genom att köra felsökaren igen i Visual Studio och skicka en annan begäran för att utlösa den uppdaterade logikappen, ungefär som stegen i Kör, testa och felsöka lokalt.

  1. Öppna menyn Kör i Aktivitetsfältet i Visual Studio Code och välj Starta felsökning (F5).

  2. I Postman eller ditt verktyg för att skapa och skicka begäranden skickar du en annan begäran för att utlösa arbetsflödet.

  3. Om du har skapat ett tillståndskänsligt arbetsflöde kontrollerar du statusen för den senaste körningen på arbetsflödets översiktssida. Om du vill visa status, indata och utdata för varje steg i den körningen väljer du knappen ellipser (...) för den körningen och väljer Visa körning.

    Här är till exempel steg för steg-status för en körning efter att exempelarbetsflödet uppdaterades med åtgärden Svar.

    Skärmbild som visar status för varje steg i uppdaterat arbetsflöde plus indata och utdata i den expanderade svarsåtgärden.

  4. Om du vill stoppa felsökningssessionen går du till menyn Kör och väljer Stoppa felsökning (Skift + F5).

Hitta domännamn för brandväggsåtkomst

Innan du distribuerar och kör logikappens arbetsflöde i Azure-portalen måste du konfigurera behörigheter för utlösare eller åtgärdsanslutningar som finns i arbetsflödet om din miljö har strikta nätverkskrav eller brandväggar som begränsar trafiken.

Följ dessa steg för att hitta de fullständigt kvalificerade domännamnen (FQDN) för dessa anslutningar:

  1. I ditt logikappsprojekt öppnar du filen connections.json som skapas när du har lagt till den första anslutningsbaserade utlösaren eller åtgärden i arbetsflödet och letar reda på managedApiConnections objektet.

  2. För varje anslutning som du skapade kopierar och sparar du egenskapsvärdet connectionRuntimeUrl någonstans säkert så att du kan konfigurera brandväggen med den här informationen.

    Det här exemplet connections.json fil innehåller två anslutningar, en AS2-anslutning och en Office 365-anslutning med följande connectionRuntimeUrl värden:

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

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

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

Distribuera till Azure

Från Visual Studio Code kan du publicera projektet direkt till Azure för att distribuera standardlogikappresursen. Du kan publicera logikappen som en ny resurs, vilket automatiskt skapar alla nödvändiga resurser, till exempel ett Azure Storage-konto, som liknar funktionsappens krav. Eller så kan du publicera logikappen till en tidigare distribuerad standardlogikappresurs som skriver över logikappen.

Distribution för standardlogikappresursen kräver en värdplan och prisnivå som du väljer under distributionen. Mer information finns i Värdplaner och prisnivåer.

Publicera till en ny standardlogikappresurs

  1. I aktivitetsfältet i Visual Studio Code väljer du Azure-ikonen för att öppna Azure-fönstret.

  2. I Azure-fönstret går du till verktygsfältet Arbetsyta i menyn Azure Logic Apps och väljer Distribuera till logikapp.

    Skärmbild som visar Azure-fönstret med verktygsfältet Arbetsyta och snabbmenyn i Azure Logic Apps med Distribuera till logikapp valt.

  3. Om du uppmanas att göra det väljer du den Azure-prenumeration som ska användas för distributionen av logikappen.

  4. I listan som Visual Studio Code öppnas väljer du bland följande alternativ:

    • Skapa ny logikapp (standard) i Azure (snabb)
    • Skapa ny logikapp (standard) i Azure Advanced
    • En tidigare distribuerad Logic App-resurs (Standard), om det finns någon

    Det här exemplet fortsätter med Skapa ny logikapp (Standard) i Azure Advanced.

    Skärmbild som visar listan med distributionsalternativ och det valda alternativet Skapa ny logikapp (standard) i Azure Advanced.

  5. Följ dessa steg för att skapa din nya standardlogikappresurs:

    1. Ange ett globalt unikt namn för den nya logikappen, som är namnet som ska användas för logikappresursen (Standard). I det här exemplet används Fabrikam-Workflows-App.

      Skärmbild som visar uppmaningen att ange ett namn för den nya logikappen som ska skapas.

    2. Välj en värdplan för den nya logikappen. Skapa antingen ett namn för din plan eller välj en befintlig plan (endast Windows-baserade App Service-planer). Det här exemplet väljer Skapa ny App Service-plan.

      Skärmbild som visar fönstret

    3. Ange ett namn för din värdplan och välj sedan en prisnivå för den valda planen.

      Mer information finns i Värdplaner och prisnivåer.

    4. För optimala prestanda väljer du samma resursgrupp som projektet för distributionen.

      Kommentar

      Även om du kan skapa eller använda en annan resursgrupp kan det påverka prestandan. Om du skapar eller väljer en annan resursgrupp, men avbryter när bekräftelsemeddelandet visas, avbryts även distributionen.

    5. För tillståndskänsliga arbetsflöden väljer du Skapa ett nytt lagringskonto eller ett befintligt lagringskonto.

      Skärmbild som visar fönstret

    6. Om logikappens inställningar för att skapa och distribuera stöder användning av Application Insights kan du aktivera diagnostikloggning och spårning för logikappen. Du kan göra det antingen när du distribuerar logikappen från Visual Studio Code eller efter distributionen. Du måste ha en Application Insights-instans, men du kan skapa den här resursen i förväg, när du distribuerar logikappen eller efter distributionen.

      Följ dessa steg för att aktivera loggning och spårning nu:

      1. Välj antingen en befintlig Application Insights-resurs eller Skapa en ny Application Insights-resurs.

      2. I Azure-portalen går du till din Application Insights-resurs.

      3. På resursmenyn väljer du Översikt. Leta upp och kopiera värdet instrumenteringsnyckel .

      4. Öppna local.settings.json-filen i projektets rotmapp i Visual Studio Code.

      5. Values I -objektet lägger du till APPINSIGHTS_INSTRUMENTATIONKEY egenskapen och anger värdet till instrumentationsnyckeln, till exempel:

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

        Dricks

        Du kan kontrollera om utlösar- och åtgärdsnamnen visas korrekt i Application Insights-instansen.

        1. I Azure-portalen går du till din Application Insights-resurs.

        2. På resursmenyn under Undersök väljer du Programkarta.

        3. Granska de åtgärdsnamn som visas på kartan.

        Vissa inkommande begäranden från inbyggda utlösare kan visas som dubbletter i programkartan. I stället för att WorkflowName.ActionName använda formatet använder dessa dubbletter arbetsflödesnamnet som åtgärdsnamn och kommer från Azure Functions-värden.

      6. Därefter kan du också justera allvarlighetsgraden för spårningsdata som logikappen samlar in och skickar till Application Insights-instansen.

        Varje gång en arbetsflödesrelaterad händelse inträffar, till exempel när ett arbetsflöde utlöses eller när en åtgärd körs, genererar körningen olika spårningar. Dessa spårningar täcker arbetsflödets livslängd och omfattar, men är inte begränsade till, följande händelsetyper:

        • Tjänstaktivitet, till exempel start, stopp och fel.
        • Jobb och sändningsaktivitet.
        • Arbetsflödesaktivitet, till exempel utlösare, åtgärd och körning.
        • Aktivitet för lagringsbegäran, till exempel lyckade eller misslyckade.
        • HTTP-begärandeaktivitet, till exempel inkommande, utgående, lyckad och misslyckad.
        • Eventuella utvecklingsspårningar, till exempel felsökningsmeddelanden.

        Varje händelsetyp tilldelas en allvarlighetsgrad. Nivån samlar till exempel Trace in de mest detaljerade meddelandena, medan Information nivån samlar in allmän aktivitet i arbetsflödet, till exempel när logikappen, arbetsflödet, utlösaren och åtgärderna startar och stoppar. Den här tabellen beskriver allvarlighetsgraderna och deras spårningstyper:

        Allvarlighetsnivå Spårningstyp
        Kritiskt Loggar som beskriver ett oåterkalleligt fel i logikappen.
        Felsöka Loggar som du kan använda för undersökning under utvecklingen, till exempel inkommande och utgående HTTP-anrop.
        Fel Loggar som indikerar ett fel i arbetsflödeskörningen, men inte ett allmänt fel i logikappen.
        Information Loggar som spårar den allmänna aktiviteten i logikappen eller arbetsflödet, till exempel:

        – När en utlösare, åtgärd eller körning startar och slutar.
        – När logikappen startar eller slutar.
        Spårning Loggar som innehåller de mest detaljerade meddelandena, till exempel lagringsbegäranden eller sändningsaktivitet, plus alla meddelanden som är relaterade till arbetsflödeskörningsaktivitet.
        Varning Loggar som markerar ett onormalt tillstånd i logikappen men inte förhindrar att det körs.

        Om du vill ange allvarlighetsgrad på projektets rotnivå öppnar du filen host.json och letar reda på objektet logging . Det här objektet styr loggfiltreringen för alla arbetsflöden i logikappen och följer ASP.NET Core-layouten för loggtypsfiltrering.

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

        Om objektet logging inte innehåller ett logLevel objekt som innehåller Host.Triggers.Workflow egenskapen lägger du till dessa objekt. Ange egenskapen till allvarlighetsgraden för den spårningstyp som du vill använda, till exempel:

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

    När du är klar med distributionsstegen börjar Visual Studio Code skapa och distribuera de resurser som krävs för att publicera logikappen.

  6. Om du vill granska och övervaka distributionsprocessen går du till menyn Visa och väljer Utdata. I verktygsfältslistan utdatafönster väljer du Azure Logic Apps.

    Skärmbild som visar utdatafönstret med Azure Logic Apps markerat i verktygsfältslistan tillsammans med distributionens förlopp och status.

    När Visual Studio Code har distribuerat logikappen till Azure visas följande meddelande:

    Skärmbild som visar ett meddelande om att distributionen till Azure har slutförts.

    Grattis, logikappen är nu live i Azure och aktiverad som standard.

Härnäst kan du lära dig hur du utför dessa uppgifter:

Lägga till ett tomt arbetsflöde i projektet

Du kan ha flera arbetsflöden i ditt logikappsprojekt. Följ dessa steg om du vill lägga till ett tomt arbetsflöde i projektet:

  1. I aktivitetsfältet i Visual Studio Code väljer du Azure-ikonen.

  2. I Azure-fönstret går du till verktygsfältet Arbetsyta i menyn Azure Logic Apps och väljer Skapa arbetsflöde.

  3. Välj den arbetsflödestyp som du vill lägga till: Tillståndskänslig eller Tillståndslös

  4. Ange ett namn för arbetsflödet.

När du är klar visas en ny arbetsflödesmapp i projektet tillsammans med en workflow.json fil för arbetsflödesdefinitionen.

Hantera distribuerade logikappar i Visual Studio Code

I Visual Studio Code kan du visa alla distribuerade logikappar i din Azure-prenumeration, oavsett om de är förbruknings- eller standardlogikappresurser, och välja uppgifter som hjälper dig att hantera dessa logikappar. Men för att få åtkomst till båda resurstyperna behöver du både Tilläggen Azure Logic Apps (Förbrukning) och Azure Logic Apps (Standard) för Visual Studio Code.

  1. I aktivitetsfältet i Visual Studio Code väljer du Azure-ikonen. I Resurs expanderar du din prenumeration och expanderar sedan Logikapp, som visar alla logikappar som distribuerats i Azure för den prenumerationen.

  2. Öppna logikappen som du vill hantera. I logikappens snabbmeny väljer du den uppgift som du vill utföra.

    Du kan till exempel välja aktiviteter som att stoppa, starta, starta om eller ta bort den distribuerade logikappen. Du kan inaktivera eller aktivera ett arbetsflöde med hjälp av Azure-portalen.

    Kommentar

    Stoppa logikappen och ta bort logikappsåtgärder påverkar arbetsflödesinstanser på olika sätt. Mer information finns i Överväganden för att stoppa logikappar och överväganden för att ta bort logikappar.

    Skärmbild som visar avsnittet Visual Studio Code med resurser och distribuerad logikappresurs.

  3. Om du vill visa alla arbetsflöden i logikappen expanderar du logikappen och expanderar sedan noden Arbetsflöden.

  4. Om du vill visa ett specifikt arbetsflöde öppnar du arbetsflödets snabbmeny och väljer Öppna i Designer, vilket öppnar arbetsflödet i skrivskyddat läge.

    Om du vill redigera arbetsflödet har du följande alternativ:

    • I Visual Studio Code öppnar du projektets workflow.json-fil i arbetsflödesdesignern, gör dina ändringar och distribuerar om logikappen till Azure.

    • Öppna logikappen i Azure-portalen. Du kan sedan öppna, redigera och spara arbetsflödet.

  5. Öppna den distribuerade logikappen i Azure-portalen genom att öppna logikappens snabbmeny och välja Öppna i portalen.

    Azure-portalen öppnas i webbläsaren, loggar in dig automatiskt på portalen om du är inloggad i Visual Studio Code och visar logikappen.

    Skärmbild som visar Azure-portalsidan för logikappen i Visual Studio Code.

    Du kan också logga in separat på Azure-portalen, använda sökrutan för portalen för att hitta logikappen och sedan välja logikappen i resultatlistan.

    Skärmbild som visar Azure-portalen och sökfältet med sökresultat för distribuerad logikapp, som visas markerad.

Överväganden för att stoppa logikappar

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

  • Azure Logic Apps avbryter alla pågående och väntande körningar omedelbart.

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

  • Utlösare utlöses inte nästa gång deras villkor uppfylls. Utlösartillstånden kommer dock ihåg de punkter där logikappen stoppades. Om du startar om logikappen utlöses därför för alla obearbetade objekt sedan den senaste körningen.

    Om du vill hindra en utlösare från att utlösa obehandlade objekt sedan den senaste körningen rensar du utlösartillståndet innan du startar om logikappen:

    1. I aktivitetsfältet i Visual Studio Code väljer du Azure-ikonen för att öppna Azure-fönstret.

    2. I avsnittet Resurser expanderar du din prenumeration, som visar alla distribuerade logikappar för den prenumerationen.

    3. Expandera logikappen och expandera sedan noden med namnet Arbetsflöden.

    4. Öppna ett arbetsflöde och redigera alla delar av arbetsflödets utlösare.

    5. Spara dina ändringar. Det här steget återställer utlösarens aktuella tillstånd.

    6. Upprepa för varje arbetsflöde.

    7. Starta om logikappen när du är klar.

Överväganden för att ta bort logikappar

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

  • Azure Logic Apps avbryter pågående och väntande körningar omedelbart, men kör inte rensningsuppgifter på lagringen som används av appen.

  • 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. Om du vill uppdatera metadata måste du å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.

Hantera distribuerade logikappar i portalen

När du har distribuerat en logikapp till Azure-portalen från Visual Studio Code kan du visa alla distribuerade logikappar som finns i din Azure-prenumeration, oavsett om de är förbruknings- eller standardlogikappresurser. För närvarande organiseras och hanteras varje resurstyp som separata kategorier i Azure. Följ dessa steg för att hitta standardlogikappar:

  1. I sökrutan i Azure-portalen anger du logikappar. När resultatlistan visas går du till Tjänster och väljer Logikappar.

    Skärmbild som visar sökrutan i Azure-portalen med logikappar som söktext.

  2. I fönstret Logikappar väljer du den logikapp som du distribuerade från Visual Studio Code.

    Skärmbild som visar azure-portalen och standardlogikappresurser som distribuerats i Azure.

    Azure-portalen öppnar den enskilda resurssidan för den valda logikappen.

    Skärmbild som visar Azure-portalen och resurssidan för logikappen.

  3. Om du vill visa arbetsflödena i den här logikappen går du till logikappens meny och väljer Arbetsflöden.

    Fönstret Arbetsflöden visar alla arbetsflöden i den aktuella logikappen. Det här exemplet visar arbetsflödet som du skapade i Visual Studio Code.

    Skärmbild som visar resurssidan för logikappen med det öppnade fönstret Arbetsflöden och arbetsflöden.

  4. Om du vill visa ett arbetsflöde går du till fönstret Arbetsflöden och väljer det arbetsflödet.

    Arbetsflödesfönstret öppnas och visar mer information och uppgifter som du kan utföra i arbetsflödet.

    Om du till exempel vill visa stegen i arbetsflödet väljer du Designer.

    Skärmbild som visar det valda arbetsflödets översiktsfönster, medan arbetsflödesmenyn visar det valda kommandot

    Arbetsflödesdesignern öppnas och visar arbetsflödet som du skapade i Visual Studio Code. Nu kan du göra ändringar i det här arbetsflödet i Azure-portalen.

    Skärmbild som visar arbetsflödesdesignern och arbetsflödet som distribuerats från Visual Studio Code.

Lägga till ytterligare ett arbetsflöde i portalen

Via Azure-portalen kan du lägga till tomma arbetsflöden i en standardlogikappresurs som du distribuerade från Visual Studio Code och skapa dessa arbetsflöden i Azure-portalen.

  1. I Azure-portalen väljer du din distribuerade standardlogikappresurs.

  2. På resursmenyn för logikappen väljer du Arbetsflöden. I fönstret Arbetsflödenväljer du Lägg till.

    Skärmbild som visar den valda logikappens arbetsflödesfönster och verktygsfält med kommandot Lägg till markerat.

  3. I fönstret Nytt arbetsflöde anger du namnet på arbetsflödet. Välj Antingen Tillståndskänslig eller Tillståndslös>Skapa.

    När Azure har distribuerat det nya arbetsflödet, som visas i fönstret Arbetsflöden , väljer du det arbetsflödet så att du kan hantera och utföra andra uppgifter, till exempel att öppna designer- eller kodvyn.

    Skärmbild som visar valt arbetsflöde med hanterings- och granskningsalternativ.

    Om du till exempel öppnar designern för ett nytt arbetsflöde visas en tom arbetsyta. Nu kan du skapa det här arbetsflödet i Azure-portalen.

    Skärmbild som visar arbetsflödesdesigner och tomt arbetsflöde.

Aktivera körningshistorik för tillståndslösa arbetsflöden

Om du vill felsöka ett tillståndslöst arbetsflöde enklare kan du aktivera körningshistoriken för arbetsflödet och sedan inaktivera körningshistoriken när du är klar. Följ de här stegen för Visual Studio Code, eller om du arbetar i Azure-portalen kan du läsa Skapa arbetsflöden med en enda klientorganisation i Azure-portalen.

  1. Öppna local.settings.json-filen på rotmappsnivå i Visual Studio Code-projektet.

  2. Lägg till egenskapen Workflows.{yourWorkflowName}.operationOptions och ange värdet till , till WithStatelessRunHistoryexempel:

    Windows

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

    macOS eller Linux

    {
   "IsEncrypted": false,
   "Values": {
      "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
          AccountKey=<access-key>;EndpointSuffix=core.windows.net",
      "FUNCTIONS_WORKER_RUNTIME": "node",
      "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
   }
}

  3. I projektmappen med namnet workflow-designtime öppnar du filen local.settings.json och gör samma ändring.

  4. Om du vill inaktivera körningshistoriken när du är klar anger Workflows.{yourWorkflowName}.OperationOptionsdu antingen egenskapen till Noneeller tar bort egenskapen och dess värde.

Aktivera övervakningsvyn i Azure-portalen

När du har distribuerat en Logic App-resurs (Standard) från Visual Studio Code till Azure kan du granska all tillgänglig körningshistorik och information om ett arbetsflöde i resursen med hjälp av Azure-portalen och övervakningsmiljön för arbetsflödet. Du måste dock först aktivera funktionen Övervaka vy på den logikappresursen.

  1. Öppna resursen standardlogikapp i Azure-portalen.

  2. På resursmenyn för logikappen går du till API:et och väljer CORS.

  3. Lägg till jokertecknet (*) under Tillåtna ursprung i CORS-fönstret.

  4. När du är klar väljer du Spara i CORS-verktygsfältet.

    Skärmbild som visar Azure-portalen med distribuerad standardlogikappresurs. På resursmenyn är CORS valt med en ny post för Tillåtna ursprung inställt på jokertecknet * .

Aktivera eller öppna Application Insights efter distributionen

Under arbetsflödeskörningen genererar logikappen telemetri tillsammans med andra händelser. Du kan använda den här telemetrin för att få bättre insyn i hur bra arbetsflödet körs och hur Logic Apps-körningen fungerar på olika sätt. Du kan övervaka arbetsflödet med hjälp av Application Insights, som ger telemetri i nära realtid (livemått). Den här funktionen kan hjälpa dig att undersöka fel och prestandaproblem enklare när du använder dessa data för att diagnostisera problem, konfigurera aviseringar och skapa diagram.

Om logikappens inställningar för att skapa och distribuera stöder användning av Application Insights kan du aktivera diagnostikloggning och spårning för logikappen. Du kan göra det antingen när du distribuerar logikappen från Visual Studio Code eller efter distributionen. Du måste ha en Application Insights-instans, men du kan skapa den här resursen i förväg, när du distribuerar logikappen eller efter distributionen.

Följ dessa steg för att aktivera Application Insights i en distribuerad logikapp eller granska Application Insights-data när de redan är aktiverade:

  1. Leta reda på din distribuerade logikapp i Azure-portalen.

  2. På logikappmenyn går du till Inställningar och väljer Application Insights.

  3. Om Application Insights inte är aktiverat går du till fönstret Application Insights och väljer Aktivera Application Insights. När fönstret har uppdaterats väljer du Använd längst ned.

    Om Application Insights är aktiverat går du till fönstret Application Insights och väljer Visa Application Insights-data.

När Application Insights har öppnats kan du granska olika mått för din logikapp. Mer information finns i följande avsnitt:

Ta bort objekt från designern

Om du vill ta bort ett objekt i arbetsflödet från designern följer du något av följande steg:

  • Välj objektet, öppna objektets snabbmeny (Skift+F10) och välj Ta bort. Bekräfta genom att välja OK.

  • Välj objektet och tryck på borttagningsnyckeln. Bekräfta genom att välja OK.

  • Välj objektet så att informationsfönstret öppnas för objektet. Öppna ellipsmenyn (...) i fönstrets övre högra hörn och välj Ta bort. Bekräfta genom att välja OK.

    Skärmbild som visar ett markerat objekt i designern med det öppnade informationsfönstret plus den markerade ellipsknappen och kommandot

    Dricks

    Om ellipsmenyn inte visas expanderar du Visual Studio Code-fönstret tillräckligt brett så att informationsfönstret visar knappen ellipser (...) i det övre högra hörnet.

Felsöka fel och problem

Designern kan inte öppnas

När du försöker öppna designern får du det här felet "Det gick inte att starta arbetsflödets designtid". Om du tidigare försökte öppna designern och sedan avbröt eller tog bort projektet kanske tilläggspaketet inte laddas ned korrekt. Följ dessa steg för att kontrollera om den här orsaken är problemet:

  1. Öppna fönstret Utdata i Visual Studio Code. På menyn Visa väljer du Utdata.

  2. I listan i namnlisten för utdatafönstret väljer du Azure Logic Apps (Standard) så att du kan granska utdata från tillägget, till exempel:

    Skärmbild som visar utdatafönstret med

  3. Granska utdata och kontrollera om det här felmeddelandet visas:

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

Lös det här felet genom att ta bort mappen ExtensionBundles på den här platsen ...\Users{your-username}\AppData\Local\Temp\Functions\ExtensionBundles och försöka öppna filen workflow.json igen i designern.

Nya utlösare och åtgärder saknas i designerväljaren för tidigare skapade arbetsflöden

Azure Logic Apps med en klientorganisation stöder inbyggda åtgärder för Azure Function Operations, Liquid Operations och XML-åtgärder, till exempel XML-validering och transformering av XML. Men för tidigare skapade logikappar kanske dessa åtgärder inte visas i designerväljaren för att du ska kunna välja om Visual Studio Code använder en inaktuell version av tilläggspaketet. Microsoft.Azure.Functions.ExtensionBundle.Workflows

Azure Function Operations-anslutningsappen och åtgärderna visas inte heller i designerväljaren om du inte har aktiverat eller valt Använd anslutningsappar från Azure när du skapade logikappen. Om du inte aktiverade azure-distribuerade anslutningsappar när appen skapades kan du aktivera dem från projektet i Visual Studio Code. Öppna snabbmenyn workflow.json och välj Använd Anslut orer från Azure.

Följ dessa steg för att åtgärda det inaktuella paketet genom att ta bort det inaktuella paketet, vilket gör att Visual Studio Code automatiskt uppdaterar tilläggspaketet till den senaste versionen.

Kommentar

Den här lösningen gäller endast för logikappar som du skapar och distribuerar med Visual Studio Code med Tillägget Azure Logic Apps (Standard), inte de logikappar som du skapade med hjälp av Azure-portalen. Se Utlösare och åtgärder som stöds saknas i designern i Azure-portalen.

  1. Spara allt arbete som du inte vill förlora och stäng Visual Studio.

  2. På datorn bläddrar du till följande mapp, som innehåller versionsmappar för det befintliga paketet:

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

  3. Ta bort versionsmappen för det tidigare paketet, till exempel om du har en mapp för version 1.1.3, ta bort den mappen.

  4. Bläddra nu till följande mapp, som innehåller versionsmappar för det nödvändiga NuGet-paketet:

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

  5. Ta bort versionsmappen för det tidigare paketet.

  6. Öppna Visual Studio Code igen, ditt projekt och filen workflow.json i designern.

De utlösare och åtgärder som saknas visas nu i designern.

"400 Felaktig begäran" visas på en utlösare eller åtgärd

När en körning misslyckas och du inspekterar körningen i övervakningsvyn kan det här felet visas på en utlösare eller åtgärd som har ett längre namn, vilket gör att den underliggande URI:n (Uniform Resource Identifier) överskrider standardteckengränsen.

Lös problemet och justera för den längre URI:n genom att redigera registernycklarna UrlSegmentMaxCount och UrlSegmentMaxLength på datorn genom att följa stegen nedan. Den här nyckelns standardvärden beskrivs i det här avsnittet Http.sys registerinställningar för Windows.

Viktigt!

Se till att spara ditt arbete innan du börjar. Den här lösningen kräver att du startar om datorn när du är klar så att ändringarna kan börja gälla.

  1. Öppna fönstret Kör på datorn och kör regedit kommandot som öppnar registereditorn.

  2. I rutan Användarkontokontroll väljer du Ja för att tillåta dina ändringar på datorn.

  3. I den vänstra rutan under Dator expanderar du noderna längs sökvägen, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters och väljer sedan Parametrar.

  4. Leta reda på registernycklarna UrlSegmentMaxCount och UrlSegmentMaxLength i den högra rutan.

  5. Öka dessa nyckelvärden tillräckligt så att URI:erna kan hantera de namn som du vill använda. Om dessa nycklar inte finns lägger du till dem i mappen Parametrar genom att följa dessa steg:

    1. På snabbmenyn Parametrar väljer du Nytt>DWORD-värde (32-bitars).

    2. I redigeringsrutan som visas anger du UrlSegmentMaxCount som det nya nyckelnamnet.

    3. Öppna den nya nyckelns snabbmeny och välj Ändra.

    4. I rutan Redigera sträng som visas anger du värdet Värdedatanyckel som du vill använda i hexadecimalt eller decimalformat. I hexadecimalt motsvarar till 1024 exempel 400 decimaltecken.

    5. Upprepa de UrlSegmentMaxLength här stegen om du vill lägga till nyckelvärdet.

    När du har ökat eller lagt till dessa nyckelvärden ser registerredigeraren ut så här:

    Skärmbild som visar registereditorn.

  6. När du är klar startar du om datorn så att ändringarna kan börja gälla.

Det går inte att starta felsökningssessionen

När du försöker starta en felsökningssession får du felet "Felet finns efter att du har kört preLaunchTask 'generateDebugSymbols'". Lös problemet genom att redigera filen tasks.json i projektet för att hoppa över symbolgenereringen.

  1. I projektet expanderar du mappen med namnet .vscode och öppnar filen tasks.json .

  2. I följande uppgift tar du bort raden , "dependsOn: "generateDebugSymbols"tillsammans med kommatecknet som avslutar föregående rad, till exempel:

    Innan:

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

    Efter:

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

Nästa steg

Vi vill gärna höra från dig om dina erfarenheter av Tillägget Azure Logic Apps (Standard).