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

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 Single-tenant kontra multitenant i Azure Logic Apps.

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

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 Portal.
• 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.
   • Ladda ned och installera varje beroende separat.

   Installera alla beroenden automatiskt

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

      

   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å menyn Arkiv väljer du 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. I resultatlistan väljer du Installera Azure Logic Apps (Standard). >

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

      

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

7. Installera eller använd ett verktyg som kan skicka HTTP-begäranden för att testa din lösning, till exempel:

   • Visual Studio Code med ett tillägg från Visual Studio Marketplace
   • PowerShell Invoke-RestMethod
   • Microsoft Edge – verktyg för nätverkskonsol
   • Bruno
   • hårlock

   Varning

   För scenarier där du har känsliga data, till exempel autentiseringsuppgifter, hemligheter, åtkomsttoken, API-nycklar och annan liknande information, bör du använda ett verktyg som skyddar dina data med nödvändiga säkerhetsfunktioner, fungerar offline eller lokalt, inte synkroniserar dina data till molnet och inte kräver att du loggar in på ett onlinekonto. På så sätt minskar du risken för att exponera känsliga data för allmänheten.

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. På menyn Arkiv går du till Inställningar > .

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

   3. Bekräfta att Uppdateringar för automatisk kontroll ä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. På menyn Arkiv går du till 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:

      

Anslut till ditt Azure-konto

1. I aktivitetsfältet i Visual Studio Code väljer du 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.

   

   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.

      

      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.

   

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.

   

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.

   

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

   

   Kommentar

   Du kan få ett fel med namnet azureLogicAppsStandard.createNewProject med felmeddelandet Det går inte att skriva till Arbetsyteinstä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.

   

   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.

   Kommentar

   Den FUNCTIONS_WORKER_RUNTIME appinställningen krävs för standardlogikappen och värdet har tidigare angetts till nod. Det nödvändiga värdet är dock nu dotnet för alla nya och befintliga distribuerade standardlogikappar. Den här värdeändringen bör inte påverka arbetsflödets körning, så allt bör fungera på samma sätt som tidigare. Mer information finns i inställningen FUNCTIONS_WORKER_RUNTIME app.

   Den APP_KIND appinställningen krävs för standardlogikappen och värdet måste vara workflowApp. I vissa scenarier kanske den här appinställningen saknas, till exempel på grund av automatisering med hjälp av Azure Resource Manager-mallar eller andra scenarier där inställningen inte ingår. Om vissa åtgärder inte fungerar, till exempel åtgärden Kör JavaScript Code , eller om arbetsflödet slutar fungera kontrollerar du att inställningen APP_KIND app finns och är inställd på workflowApp. Mer information finns i inställningen APP_KIND app.

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

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.

   

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 Portal via logikappens resursmeny under Artefakter, till exempel:

Lägga till kartor i projektet

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

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.

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:

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

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

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>

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

   

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.

   

   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.

   

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

   

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

   

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.

   

   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.

   

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.

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

• Utlösaren För inbyggd anslutningsapp med namnet När en HTTP-begäran tas emot, som kan ta emot inkommande anrop eller begäranden och skapar en slutpunkt som andra tjänster eller arbetsflöden för logikappar kan anropa.

• Åtgärden Office 365 Outlook-hanterad anslutningsapp med namnet Skicka ett e-postmeddelande. Om du vill följa den här guiden behöver du ett Office 365 Outlook-e-postkonto. Om du har ett e-postkonto som stöds av en annan anslutningsapp kan du använda anslutningsappen, men den anslutningsappens användarupplevelse skiljer sig från stegen i det här exemplet.

• Åtgärden Begär inbyggd anslutningsapp med namnet Svar, som du använder för att skicka ett svar och returnera data tillbaka till anroparen.

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.

   

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

   

   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.

   

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

   

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.

      

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

      

   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:

   

   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": "dotnet",
         "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
         <...>
         "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
         <...>
      }
   }
   

   Kommentar

   Tidigare var nodestandardvärdet för den FUNCTIONS_WORKER_RUNTIME inställningen . dotnet Nu är standardvärdet för alla nya och befintliga distribuerade standardlogikappar, även för appar som har ett annat värde. Den här ändringen bör inte påverka arbetsflödets körning och allt bör fungera på samma sätt som tidigare. Mer information finns i inställningen FUNCTIONS_WORKER_RUNTIME app.

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.

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.

      

   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>

      

   4. Kopiera och spara egenskapsvärdet för återanrops-URL.

5. Om du vill testa motringnings-URL:en och utlösa arbetsflödet skickar du en HTTP-begäran till URL:en, inklusive den metod som begärandeutlösaren förväntar sig, med hjälp av http-begärandeverktyget och dess instruktioner.

   I det här exemplet används GET-metoden med den kopierade URL:en, som ser ut som följande exempel:

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

   När utlösaren utlöses körs exempelarbetsflödet och skickar ett e-postmeddelande som liknar det här 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.

   

   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.

   

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

   

   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.

   

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.

   

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.

      

      När du är klar har egenskapen Svarsåtgärdens brödtext nu angetts till utdatavärdet 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.

   

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

   

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.

   

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.

      

   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.

      

   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.

      

   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 Portal 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": "dotnet",
               "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
            }
         }
         

         Dricks

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

         1. I Azure Portal 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.

   

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

   

   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ägg till ett tomt arbetsflöde i projektet.

• Hantera distribuerade logikappar i Visual Studio Code eller med hjälp av Azure Portal.

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

• Aktivera övervakningsvyn i Azure Portal för en distribuerad logikapp.

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

   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.

   

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 Portal. Du kan sedan öppna, redigera och spara arbetsflödet.

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

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

   

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

   

Ö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 Portal 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 Azure Portal anger du logikappar. När resultatlistan visas går du till Tjänster och väljer Logikappar.

   

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

   

   Azure Portal öppnar den enskilda resurssidan för den valda 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.

   

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.

   

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

   

Lägga till ytterligare ett arbetsflöde i portalen

Via Azure Portal 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 Portal.

1. I Azure Portal väljer du din distribuerade standardlogikappresurs.

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

   

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.

   

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

   

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 Portal, se Skapa arbetsflöden med en enda klientorganisation i Azure Portal.

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": "dotnet",
         "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": "dotnet",
         "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 Portal

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 för ett arbetsflöde i resursen med hjälp av Azure Portal och övervakningsmiljön för arbetsflödet. Du måste dock först aktivera funktionen Övervaka vy på den logikappresursen.

1. Öppna standardlogikappresursen i Azure Portal.

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.

   

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

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:

• Azure Logic Apps körs var som helst – Övervaka med Application Insights – del 1
• Azure Logic Apps körs var som helst – Övervaka med Application Insights – del 2

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.

  

  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:

   

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

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.

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:

   

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

• För buggar eller problem skapar du dina problem i GitHub.
• För frågor, begäranden, kommentarer och annan feedback använder du det här feedbackformuläret.