Een standaardwerkstroom voor logische apps maken voor Azure Logic Apps met één tenant met behulp van Visual Studio Code
Van toepassing op: Azure Logic Apps (Standard)
Deze handleiding laat zien hoe u een voorbeeld van een integratiewerkstroom maakt die wordt uitgevoerd in Azure Logic Apps met één tenant met behulp van Visual Studio Code met de Azure Logic Apps-extensie (Standard). Voordat u deze werkstroom maakt, maakt u een standaard logische app-resource, die de volgende mogelijkheden biedt:
Uw logische app kan meerdere stateful en stateless werkstromen bevatten.
Werkstromen in dezelfde logische app en tenant worden uitgevoerd in hetzelfde proces als de Azure Logic Apps-runtime, zodat ze dezelfde resources delen en betere prestaties bieden.
U kunt lokaal werkstromen maken, uitvoeren en testen met behulp van de Ontwikkelomgeving van Visual Studio Code.
Wanneer u klaar bent, kunt u uw logische app implementeren in Azure, waar uw werkstroom kan worden uitgevoerd in de Azure Logic Apps-omgeving met één tenant of in een App Service Environment v3 (alleen op Windows gebaseerde App Service-abonnementen). U kunt uw werkstroom ook overal implementeren en uitvoeren die Kubernetes kan uitvoeren, waaronder Azure, Azure Kubernetes Service, on-premises of zelfs andere cloudproviders, vanwege de azure Logic Apps-runtime in containers. Voor meer informatie over Azure Logic Apps met één tenant raadpleegt u Omgeving met één tenant versus meerdere tenants en integratieservice.
Hoewel de voorbeeldwerkstroom is gebaseerd op de cloud en slechts twee stappen heeft, kunt u werkstromen maken op basis van honderden bewerkingen die een breed scala aan apps, gegevens, services en systemen in cloud-, on-premises en hybride omgevingen met elkaar kunnen verbinden. De voorbeeldwerkstroom begint met de ingebouwde aanvraagtrigger en volgt op een Office 365 Outlook-actie. De trigger maakt een aanroepbaar eindpunt voor de werkstroom en wacht op een binnenkomende HTTPS-aanvraag van een aanroeper. Wanneer de trigger een aanvraag ontvangt en wordt geactiveerd, wordt de volgende actie uitgevoerd door een e-mail te verzenden naar het opgegeven e-mailadres, samen met geselecteerde uitvoer van de trigger.
Tip
Als u geen Office 365-account hebt, kunt u een andere beschikbare actie gebruiken waarmee berichten vanuit uw e-mailaccount kunnen worden verzonden, bijvoorbeeld Outlook.com.
Als u in plaats daarvan deze voorbeeldwerkstroom wilt maken met behulp van de Azure Portal, volgt u de stappen in Integratiewerkstromen maken met behulp van Azure Logic Apps met één tenant en de Azure Portal. Beide opties bieden de mogelijkheid om werkstromen voor logische apps te ontwikkelen, uit te voeren en te implementeren in dezelfde soorten omgevingen. Met Visual Studio Code kunt u echter lokaal werkstromen ontwikkelen, testen en uitvoeren in uw ontwikkelomgeving.
Naarmate u verder gaat, voert u de volgende taken op hoog niveau uit:
- Maak een project voor uw logische app en een lege stateful werkstroom.
- Voeg een trigger en een actie toe.
- Voer de uitvoeringsgeschiedenis lokaal uit, test, foutopsporing en controleer de uitvoeringsgeschiedenis.
- Zoek de domeinnaamgegevens voor toegang tot de firewall.
- Implementeren in Azure, waaronder het optioneel inschakelen van Application Insights.
- Beheer uw geïmplementeerde logische app in Visual Studio Code en de Azure Portal.
- Schakel de uitvoeringsgeschiedenis in voor staatloze werkstromen.
- Schakel Application Insights in of open deze na de implementatie.
Vereisten
Toegang en connectiviteit
Toegang tot internet, zodat u de vereisten kunt downloaden, vanuit Visual Studio Code verbinding kunt maken met uw Azure-account en vanuit Visual Studio Code naar Azure kunt publiceren.
Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.
Als u dezelfde voorbeeldwerkstroom in dit artikel wilt maken, hebt u een Office 365 Outlook-e-mailaccount nodig dat een werk- of schoolaccount van Microsoft gebruikt om u aan te melden.
Als u een andere e-mailconnector kiest, zoals Outlook.com, kunt u nog steeds het voorbeeld volgen en zijn de algemene stappen hetzelfde. Uw opties kunnen echter op een aantal manieren verschillen. Als u bijvoorbeeld de connector Outlook.com gebruikt, gebruikt u in plaats daarvan uw persoonlijke Microsoft-account om u aan te melden.
Opslagvereisten
Voor lokale ontwikkeling in Visual Studio Code moet u een lokaal gegevensarchief instellen voor uw logische app-project en werkstromen die kunnen worden gebruikt voor uitvoering in uw lokale ontwikkelomgeving. U kunt de Azurite-opslagemulator gebruiken en uitvoeren als uw lokale gegevensarchief.
Download en installeer Azurite 3.12.0 of hoger voor uw Windows-, macOS- of Linux-besturingssysteem. U kunt installeren vanuit Visual Studio Code of met behulp van npm.
Voordat u de werkstroom van uw logische app uitvoert, moet u de emulator starten.
Raadpleeg de Azurite-documentatie voor meer informatie.
Hulpprogramma's
Installeer de volgende hulpprogramma's en versies voor uw specifieke besturingssysteem: Windows, macOS of Linux.
Visual Studio Code, dat gratis is. Download en installeer ook deze hulpprogramma's voor Visual Studio Code, als u deze nog niet hebt:
Azure-accountextensie, die één algemene azure-aanmeldings- en abonnementsfilteringservaring biedt voor alle andere Azure-extensies in Visual Studio Code.
C# voor Visual Studio Code-extensie, waarmee F5-functionaliteit uw logische app-werkstroom kan uitvoeren.
.NET SDK 6.x.x, die de .NET Runtime 6.x.x bevat, een vereiste voor de Azure Logic Apps -runtime (Standard).
Azure Functions Core Tools - versie 4.x
- Windows: gebruik de versie van Microsoft Installer (MSI), namelijk
func-cli-X.X.XXXX-x*.msi
. - MacOS
- Linux
Deze hulpprogramma's bevatten een versie van dezelfde runtime die de Azure Functions-runtime mogelijk maakt, die door de Azure Logic Apps -extensie (Standard) wordt gebruikt in Visual Studio Code.
Als u een installatie hebt die ouder is dan deze versies, verwijdert u die versie eerst of zorgt u ervoor dat de omgevingsvariabele PATH verwijst naar de versie die u downloadt en installeert.
Azure Functions v3-ondersteuning in Azure Logic Apps eindigt op 31 maart 2023. Vanaf half oktober 2022 gebruiken nieuwe werkstromen voor logische standaard-apps in de Azure Portal automatisch Azure Functions v4. Sinds 31 januari 2023 zijn bestaande Standaardwerkstromen in de Azure Portal automatisch gemigreerd naar Azure Functions v4.
Tenzij u uw logische standaard-apps hebt geïmplementeerd als op NuGet gebaseerde projecten, uw logische apps hebt vastgemaakt aan een specifieke bundelversie of microsoft heeft vastgesteld dat u actie moest ondernemen vóór de automatische migratie, is deze upgrade ontworpen om geen actie van u te vereisen en geen invloed te hebben op de runtime. Als de uitzonderingen echter op u van toepassing zijn of voor meer informatie over Azure Functions v3-ondersteuning, raadpleegt u Azure Logic Apps Standard ondersteunt nu Azure Functions v4.
- Windows: gebruik de versie van Microsoft Installer (MSI), namelijk
Azure Logic Apps -extensie (Standard) voor Visual Studio Code.
Belangrijk
Projecten die zijn gemaakt met eerdere preview-extensies werken niet meer. Als u wilt doorgaan, verwijdert u eventuele eerdere versies en maakt u uw logische app-projecten opnieuw.
Voer de volgende stappen uit om de Azure Logic Apps-extensie (Standard) te installeren:
Selecteer in Visual Studio Code op de linkerwerkbalk extensies.
Voer in het zoekvak voor extensies in
azure logic apps standard
. Selecteer Azure Logic Apps (Standard)>Installeren in de lijst met resultaten.Nadat de installatie is voltooid, wordt de extensie weergegeven in de lijst Extensies: geïnstalleerd .
Tip
Als de extensie niet wordt weergegeven in de geïnstalleerde lijst, start u Visual Studio Code opnieuw.
Op dit moment kunt u zowel verbruiksuitbreidingen (multitenant) als Standard-extensies (één tenant) tegelijkertijd installeren. De ontwikkelervaringen verschillen in sommige opzichten van elkaar, maar uw Azure-abonnement kan zowel het type logische standaard- als het logische app-type Verbruik bevatten. Visual Studio Code toont alle geïmplementeerde logische apps in uw Azure-abonnement, maar organiseert uw apps onder elke extensie, Azure Logic Apps (verbruik) en Azure Logic Apps (Standard).
Als u de actie Inline Code Operations wilt gebruiken waarmee JavaScript wordt uitgevoerd, installeert uNode.js versie 12.x.x of 14.x.x.
Tip
Download voor Windows de MSI-versie. Als u in plaats daarvan de ZIP-versie gebruikt, moet u handmatig Node.js beschikbaar maken met behulp van een PATH-omgevingsvariabele voor uw besturingssysteem.
Als u lokaal op webhook gebaseerde triggers en acties wilt uitvoeren, zoals de ingebouwde HTTP-webhooktrigger, moet u doorsturen instellen voor de callback-URL.
Als u de voorbeeldwerkstroom in dit artikel wilt testen, hebt u een hulpprogramma nodig waarmee aanroepen kunnen worden verzonden naar het eindpunt dat is gemaakt met de aanvraagtrigger. Als u niet over een dergelijk hulpprogramma beschikt, kunt u de Postman-app downloaden, installeren en gebruiken.
Als u uw logische app-resources maakt met instellingen die ondersteuning bieden voor het gebruik van Application Insights, kunt u desgewenst diagnostische logboekregistratie en tracering inschakelen voor uw logische app. U kunt dit doen wanneer u uw logische app maakt of na de implementatie. U moet een Application Insights-exemplaar hebben, maar u kunt deze resource van tevoren maken, wanneer u uw logische app maakt of na de implementatie.
Visual Studio Code instellen
Om ervoor te zorgen dat alle extensies correct zijn geïnstalleerd, laadt u Visual Studio Code opnieuw of start u deze opnieuw.
Controleer of Visual Studio Code automatisch extensie-updates vindt en installeert, zodat al uw extensies de meest recente updates ontvangen. Anders moet u de verouderde versie handmatig verwijderen en de nieuwste versie installeren.
Ga in het menu Bestand naar Voorkeuren>Instellingen.
Ga op het tabblad Gebruiker naarFunctie-extensies>.
Controleer of autocontrole Updates en automatisch bijwerken zijn geselecteerd.
Standaard zijn de volgende instellingen ingeschakeld en ingesteld voor de Azure Logic Apps -extensie (Standard):
Azure Logic Apps Standard: Project Runtime, die is ingesteld op versie ~3
Notitie
Deze versie is vereist voor het gebruik van de acties voor inlinecodebewerkingen.
Azure Logic Apps Standard: Experimental View Manager, waarmee de nieuwste ontwerpfunctie in Visual Studio Code wordt ingeschakeld. Als u problemen ondervindt met de ontwerpfunctie, zoals het slepen en neerzetten van items, schakelt u deze instelling uit.
Voer de volgende stappen uit om deze instellingen te vinden en te bevestigen:
Ga in het menu Bestand naar Instellingen voor voorkeuren>.
Ga op het tabblad Gebruiker naar >Extensies>Azure Logic Apps (Standard).
U kunt bijvoorbeeld hier de instelling Azure Logic Apps Standard: Project Runtime vinden of het zoekvak gebruiken om andere instellingen te zoeken:
Verbinding maken met uw Azure-account
Selecteer op de activiteitenbalk van Visual Studio Code het pictogram Azure.
Selecteer in het deelvenster Azure onder Azure: Logic Apps (Standard) de optie Aanmelden bij Azure. Wanneer de verificatiepagina van Visual Studio Code wordt weergegeven, meldt u zich aan met uw Azure-account.
Nadat u zich hebt aangemeld, worden in het deelvenster Azure de abonnementen in uw Azure-account weergegeven. Als u ook de openbaar uitgebrachte extensie hebt, vindt u alle logische apps die u met die extensie hebt gemaakt in de sectie Logic Apps, niet in de sectie Logic Apps (Standaard).
Als de verwachte abonnementen niet worden weergegeven of als u wilt dat in het deelvenster alleen specifieke abonnementen worden weergegeven, voert u de volgende stappen uit:
Plaats de aanwijzer in de lijst met abonnementen naast het eerste abonnement totdat de knop Abonnementen selecteren (filterpictogram) wordt weergegeven. Selecteer het filterpictogram.
Of selecteer uw Azure-account in de statusbalk van Visual Studio Code.
Wanneer een andere lijst met abonnementen wordt weergegeven, selecteert u de gewenste abonnementen en zorgt u ervoor dat u OK selecteert.
Een lokaal project maken
Voordat u uw logische app kunt maken, moet u een lokaal project maken, zodat u uw logische app kunt beheren, uitvoeren en implementeren vanuit Visual Studio Code. Het onderliggende project is vergelijkbaar met een Azure Functions-project, ook wel een functie-app-project genoemd. Deze projecttypen zijn echter gescheiden van elkaar, zodat logische apps en functie-apps niet in hetzelfde project kunnen bestaan.
Maak op uw computer een lege lokale map om te gebruiken voor het project dat u later maakt in Visual Studio Code.
Sluit in Visual Studio Code alle geopende mappen.
Selecteer in het deelvenster Azure naast Azure: Logic Apps (Standard)de optie Nieuw project maken (pictogram met een map en bliksemschicht).
Als Windows Defender Firewall u vraagt om netwerktoegang te verlenen voor
Code.exe
. Dit is Visual Studio Code en voorfunc.exe
, wat de Azure Functions Core Tools is, selecteert u Privénetwerken, zoals mijn thuis- of werknetwerk>Toegang toestaan.Blader naar de locatie waar u de projectmap hebt gemaakt, selecteer die map en ga door.
Selecteer stateful werkstroom of Stateless Workflow in de lijst met sjablonen die wordt weergegeven. In dit voorbeeld wordt stateful werkstroom geselecteerd.
Geef een naam op voor uw werkstroom en druk op Enter. In dit voorbeeld wordt als naam gebruikt
Fabrikam-Stateful-Workflow
.Notitie
Mogelijk krijgt u een fout met de naam azureLogicAppsStandard.createNewProject met het foutbericht Kan niet schrijven naar werkruimte-instellingen omdat azureFunctions.suppressProject geen geregistreerde configuratie is. Als u dat doet, installeert u de Azure Functions-extensie voor Visual Studio Code, rechtstreeks vanuit Visual Studio Marketplace of vanuit Visual Studio Code.
Visual Studio Code voltooit het maken van uw project en opent het bestand workflow.json voor uw werkstroom in de code-editor.
Notitie
Als u wordt gevraagd om te selecteren hoe u uw project wilt openen, selecteert u Openen in huidig venster als u uw project wilt openen in het huidige Visual Studio Code-venster. Als u een nieuw exemplaar voor Visual Studio Code wilt openen, selecteert u Openen in nieuw venster.
Open op de werkbalk van Visual Studio het deelvenster Verkenner, als dat nog niet is geopend.
In het deelvenster Explorer wordt uw project weergegeven, dat nu automatisch gegenereerde projectbestanden bevat. Het project heeft bijvoorbeeld een map met de naam van uw werkstroom. In deze map bevat het bestand workflow.json de onderliggende JSON-definitie van uw werkstroom.
In Visual Studio Code heeft uw logische app-project een van de volgende typen:
- Uitbreidingsbundel (Node.js), het standaardtype
- Op nuGet-pakketten (.NET) gebaseerd, die u kunt converteren van het standaardtype
Op basis van deze typen bevat uw project enigszins verschillende mappen en bestanden. Een op NuGet gebaseerd project bevat een .bin-map die pakketten en andere bibliotheekbestanden bevat. Een project op basis van een bundel bevat niet de map .bin en andere bestanden. Voor sommige scenario's is een op NuGet gebaseerd project vereist om uw app uit te voeren, bijvoorbeeld wanneer u aangepaste ingebouwde bewerkingen wilt ontwikkelen en uitvoeren. Zie Build-connector authoring inschakelen voor meer informatie over het converteren van uw project voor gebruik van NuGet.
Voor het standaardproject op basis van bundels heeft uw project een map- en bestandsstructuur die vergelijkbaar is met het volgende voorbeeld:
MyBundleBasedLogicAppProjectName | .vscode | Artifacts || Maps ||| MapName1 ||| ... || Schemas ||| SchemaName1 ||| ... | WorkflowName1 || workflow.json || ... | WorkflowName2 || workflow.json || ... | workflow-designtime | .funcignore | connections.json | host.json | local.settings.json
Op het hoofdniveau van uw project vindt u de volgende bestanden en mappen met andere items:
Naam Map of bestand Beschrijving .vscode Map Bevat aan Visual Studio Code gerelateerde instellingenbestanden, zoals extensions.json-, launch.json-, settings.json- en tasks.json-bestanden . Artefacten Map Bevat integratieaccountartefacten die u definieert en gebruikt in werkstromen die ondersteuning bieden voor B2B-scenario's (business-to-business). De voorbeeldstructuur bevat bijvoorbeeld toewijzingen en schema's voor XML-transformatie- en validatiebewerkingen. <WorkflowName> Map Voor elke werkstroom bevat de < map WorkflowName> het bestand workflow.json, dat de onderliggende JSON-definitie van die werkstroom bevat. workflow-designtime Map Bevat instellingenbestanden met betrekking tot de ontwikkelomgeving. .funcignore File Bevat informatie met betrekking tot uw geïnstalleerde Azure Functions Core Tools. connections.json File Bevat de metagegevens, eindpunten en sleutels voor alle beheerde verbindingen en Azure-functies die uw werkstromen gebruiken.
Belangrijk: als u verschillende verbindingen en functies voor elke omgeving wilt gebruiken, moet u dit bestand connections.json parameteriseren en de eindpunten bijwerken.host.json File Bevat runtime-specifieke configuratie-instellingen en -waarden, bijvoorbeeld de standaardlimieten voor het Azure Logic Apps-platform met één tenant, logische apps, werkstromen, triggers en acties. Op het hoofdniveau van uw logische app-project bevat het metagegevensbestand host.json de configuratie-instellingen en standaardwaarden die alle werkstromen in dezelfde logische app gebruiken tijdens het uitvoeren, lokaal of in Azure.
Opmerking: wanneer u uw logische app maakt, maakt Visual Studio Code een back-uphost.snapshot .*.json-bestand in uw opslagcontainer. Als u uw logische app verwijdert, wordt dit back-upbestand niet verwijderd. Als u een andere logische app met dezelfde naam maakt, wordt er nog een momentopnamebestand gemaakt. U kunt maximaal 10 momentopnamen voor dezelfde logische app hebben. Als u deze limiet overschrijdt, krijgt u de volgende fout:Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))
U kunt deze fout oplossen door de extra momentopnamebestanden uit uw opslagcontainer te verwijderen.local.settings.json File Bevat app-instellingen, verbindingsreeksen en andere instellingen die uw werkstromen gebruiken wanneer ze lokaal worden uitgevoerd. Met andere woorden, deze instellingen en waarden zijn alleen van toepassing wanneer u uw projecten uitvoert in uw lokale ontwikkelomgeving. Tijdens de implementatie in Azure worden het bestand en de instellingen genegeerd en worden ze niet opgenomen in uw implementatie.
In dit bestand worden instellingen en waarden opgeslagen als lokale omgevingsvariabelen die door uw lokale ontwikkelhulpprogramma's worden gebruikt als deappSettings
waarden. U kunt deze omgevingsvariabelen zowel tijdens runtime als tijdens de implementatie aanroepen en ernaar verwijzen met behulp van app-instellingen en -parameters.
Belangrijk: het bestand local.settings.json kan geheimen bevatten, dus zorg ervoor dat u dit bestand ook uitsluit van het broncodebeheer van uw project.
Ingebouwde connectorcreatie inschakelen
U kunt uw eigen ingebouwde connectors maken voor elke service die u nodig hebt met behulp van het Azure Logic Apps-uitbreidbaarheidsframework met één tenant. Vergelijkbaar met ingebouwde connectors zoals Azure Service Bus en SQL Server, bieden deze connectors een hogere doorvoer, lage latentie, lokale connectiviteit en worden ze systeemeigen uitgevoerd in hetzelfde proces als de Azure Logic Apps-runtime met één tenant.
De ontwerpfunctie is momenteel alleen beschikbaar in Visual Studio Code, maar is niet standaard ingeschakeld. Als u deze connectors wilt maken, moet u eerst uw project converteren van extensiebundels (Node.js) naar op nuGet-pakketten (.NET).
Belangrijk
Deze actie is een eenrichtingsbewerking die u niet ongedaan kunt maken.
Plaats in het deelvenster Explorer in de hoofdmap van uw project de muisaanwijzer op een leeg gebied onder alle andere bestanden en mappen, open het snelmenu en selecteer Converteren naar op Nuget gebaseerd logic app-project.
Wanneer de prompt wordt weergegeven, bevestigt u de projectconversie.
Als u wilt doorgaan, bekijkt en volgt u de stappen in het artikel Azure Logic Apps Running Anywhere - Ingebouwde connectoruitbreidbaarheid.
Het werkstroomdefinitiebestand openen in de ontwerpfunctie
Vouw de projectmap voor uw werkstroom uit. Open het snelmenu van het bestand workflow.json en selecteer Openen in Designer.
Selecteer in de lijst Connectors inschakelen in Azurede optie Connectors van Azure gebruiken. Dit geldt voor alle beheerde connectors die beschikbaar zijn en zijn geïmplementeerd in Azure, niet alleen connectors voor Azure-services.
Notitie
Stateless werkstromen ondersteunen momenteel alleen acties voor beheerde connectors, die zijn geïmplementeerd in Azure, en geen triggers. Hoewel u de mogelijkheid hebt om connectors in te schakelen in Azure voor uw stateless werkstroom, worden in de ontwerpfunctie geen triggers voor beheerde connectors weergegeven die u kunt selecteren.
Selecteer in de lijst Abonnement selecteren het Azure-abonnement dat u wilt gebruiken voor uw logische app-project.
Selecteer nieuwe resourcegroep maken in de lijst met resourcegroepen.
Geef een naam op voor de resourcegroep en druk op Enter. In dit voorbeeld wordt
Fabrikam-Workflows-RG
gebruikt.Selecteer in de lijst met locaties de Azure-regio die u wilt gebruiken bij het maken van uw resourcegroep en resources. In dit voorbeeld wordt VS - west-centraal gebruikt.
Nadat u deze stap hebt uitgevoerd, opent Visual Studio Code de werkstroomontwerper.
Notitie
Wanneer Visual Studio Code de API voor werkstroomontwerptijd start, krijgt u mogelijk een bericht dat het opstarten enkele seconden kan duren. U kunt dit bericht negeren of OK selecteren.
Als de ontwerper niet kan worden geopend, raadpleegt u de sectie probleemoplossing, Designer kan niet worden geopend.
Nadat de ontwerpfunctie wordt weergegeven, wordt de prompt Een bewerking kiezen weergegeven in de ontwerpfunctie en is standaard geselecteerd, met het deelvenster Een actie toevoegen .
Voeg vervolgens een trigger en acties toe aan uw werkstroom.
Een trigger en acties toevoegen
Nadat u de ontwerpfunctie hebt geopend, wordt de prompt Kies een bewerking weergegeven in de ontwerpfunctie en is deze standaard geselecteerd. U kunt nu beginnen met het maken van uw werkstroom door een trigger en acties toe te voegen.
De werkstroom in dit voorbeeld maakt gebruik van deze trigger en de volgende acties:
De ingebouwde aanvraagtriggerWanneer een HTTP-aanvraag wordt ontvangen, die binnenkomende aanroepen of aanvragen ontvangt en een eindpunt maakt dat andere services of logische apps kunnen aanroepen.
De Office 365 Outlook-actie Een e-mail verzenden.
De ingebouwde reactieactie, die u gebruikt om een antwoord te verzenden en gegevens terug te sturen naar de beller.
De aanvraagtrigger toevoegen
Controleer naast de ontwerpfunctie in het deelvenster Een trigger toevoegen onder het zoekvak Een bewerking kiezen of Ingebouwd is geselecteerd, zodat u een trigger kunt selecteren die systeemeigen wordt uitgevoerd.
Voer
when a http request
in het zoekvak Kies een bewerking in en selecteer de ingebouwde aanvraagtrigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen.Wanneer de trigger wordt weergegeven in de ontwerpfunctie, wordt het detailvenster van de trigger geopend om de eigenschappen, instellingen en andere acties van de trigger weer te geven.
Tip
Als het detailvenster niet wordt weergegeven, controleert u of de trigger is geselecteerd in de ontwerpfunctie.
Als u een item uit de ontwerpfunctie wilt verwijderen, volgt u deze stappen om items uit de ontwerpfunctie te verwijderen.
De Office 365 Outlook-actie toevoegen
Selecteer in de ontwerpfunctie, onder de trigger die u hebt toegevoegd, het plusteken (+) >Een actie toevoegen.
De prompt Een bewerking kiezen wordt weergegeven in de ontwerpfunctie en het deelvenster Een actie toevoegen wordt opnieuw geopend, zodat u de volgende actie kunt selecteren.
Selecteer in het deelvenster Een actie toevoegen onder het zoekvak Kies een bewerking de optie Azure , zodat u een actie kunt selecteren voor een beheerde connector die is geïmplementeerd in Azure.
In dit voorbeeld wordt de Office 365 Outlook-actie Een e-mail verzenden (V2) geselecteerd en gebruikt.
Selecteer aanmelden in het detailvenster van de actie, zodat u een verbinding met uw e-mailaccount kunt maken.
Wanneer Visual Studio Code u om toestemming vraagt voor toegang tot uw e-mailaccount, selecteert u Openen.
Tip
Als u toekomstige prompts wilt voorkomen, selecteert u Vertrouwde domeinen configureren zodat u de verificatiepagina kunt toevoegen als een vertrouwd domein.
Volg de volgende aanwijzingen om u aan te melden, toegang toe te staan en terugkeer naar Visual Studio Code toe te staan.
Notitie
Als er te veel tijd verstrijkt voordat u de prompts voltooit, treedt er een time-out op voor het verificatieproces en mislukt dit. In dit geval gaat u terug naar de ontwerper en probeert u zich opnieuw aan te melden om de verbinding te maken.
Wanneer de Azure Logic Apps -extensie (Standard) u om toestemming vraagt voor toegang tot uw e-mailaccount, selecteert u Openen. Volg de volgende prompt om toegang toe te staan.
Tip
Als u toekomstige prompts wilt voorkomen, selecteert u Niet opnieuw vragen om deze extensie.
Nadat Visual Studio Code uw verbinding heeft gemaakt, wordt in sommige connectors het bericht weergegeven dat
The connection will be valid for {n} days only
. Deze tijdslimiet geldt alleen voor de duur terwijl u uw logische app in Visual Studio Code ontwerpt. Na de implementatie is deze limiet niet meer van toepassing omdat uw logische app tijdens runtime kan worden geverifieerd met behulp van de automatisch ingeschakelde door het systeem toegewezen beheerde identiteit. Deze beheerde identiteit verschilt van de verificatiereferenties of connection string die u gebruikt wanneer u een verbinding maakt. Als u deze door het systeem toegewezen beheerde identiteit uitschakelt, werken verbindingen niet tijdens runtime.Als in de ontwerpfunctie de actie Een e-mail verzenden niet wordt weergegeven, selecteert u die actie.
Geef in het detailvenster van de actie, op het tabblad Parameters , de vereiste informatie voor de actie op, bijvoorbeeld:
Eigenschap Vereist Waarde Beschrijving Aan Ja <uw-e-mailadres> De e-mailontvanger, wat uw e-mailadres kan zijn voor testdoeleinden. In dit voorbeeld wordt het fictieve e-mailadres gebruikt, sophiaowen@fabrikam.com
.Onderwerp Ja An email from your example workflow
Het onderwerp van de e-mail Hoofdtekst Ja Hello from your example workflow!
De hoofdtekst van de e-mail Notitie
Als u wijzigingen wilt aanbrengen in het detailvenster op het tabblad Instellingen, Statisch resultaat of Uitvoeren na , moet u Gereed selecteren om deze wijzigingen door te voeren voordat u overschakelt naar tabbladen of de focus naar de ontwerper wijzigt. Anders worden uw wijzigingen niet bewaard in Visual Studio Code.
Selecteer Opslaan in de ontwerpfunctie.
Belangrijk
Als u lokaal een werkstroom wilt uitvoeren die gebruikmaakt van een trigger of acties op basis van een webhook, zoals de ingebouwde HTTP-webhooktrigger of -actie, moet u deze mogelijkheid inschakelen door doorsturen in te stellen voor de callback-URL van de webhook.
Lokaal uitgevoerde webhooks inschakelen
Wanneer u een trigger of actie op basis van een webhook gebruikt, zoals HTTP Webhook, met een logische app die wordt uitgevoerd in Azure, abonneert de Logic Apps-runtime zich op het service-eindpunt door een callback-URL bij dat eindpunt te genereren en te registreren. De trigger of actie wacht vervolgens tot het service-eindpunt de URL aanroept. Wanneer u echter in Visual Studio Code werkt, begint de gegenereerde callback-URL met http://localhost:7071/...
. Deze URL is voor uw localhost-server, die privé is, zodat het service-eindpunt deze URL niet kan aanroepen.
Als u lokaal triggers en acties op basis van een webhook wilt uitvoeren in Visual Studio Code, moet u een openbare URL instellen die uw localhost-server beschikbaar maakt en veilig aanroepen van het service-eindpunt doorstuurt naar de callback-URL van de webhook. U kunt een doorstuurservice en hulpprogramma zoals ngrok gebruiken, waarmee een HTTP-tunnel naar uw localhost-poort wordt geopend, of u kunt uw eigen equivalente hulpprogramma gebruiken.
Doorschakelen instellen met behulp van ngrok
Meld u aan voor een ngrok-account als u er nog geen hebt. Meld u anders aan bij uw account.
Haal uw persoonlijke verificatietoken op, dat uw ngrok-client nodig heeft om verbinding te maken en de toegang tot uw account te verifiëren.
Als u uw verificatietokenpagina wilt vinden, vouwt u in het dashboardmenu van uw account Verificatie uit en selecteert u Uw verificatietoken.
Kopieer het token in het vak Uw verificatietoken naar een veilige locatie.
Download op de downloadpagina van ngrok of uw accountdashboard de gewenste ngrok-versie en pak het .zip-bestand uit. Zie Stap 1: Uitpakken om te installeren voor meer informatie.
Open het opdrachtpromptprogramma op uw computer. Blader naar de locatie waar u het ngrok.exe-bestand hebt.
Verbind de ngrok-client met uw ngrok-account door de volgende opdracht uit te voeren. Zie Stap 2: Verbinding maken met uw account voor meer informatie.
ngrok authtoken <your_auth_token>
Open de HTTP-tunnel naar localhost-poort 7071 door de volgende opdracht uit te voeren. Zie Stap 3: Start het voor meer informatie.
ngrok http 7071
Zoek in de uitvoer de volgende regel:
http://<domain>.ngrok.io -> http://localhost:7071
Kopieer de URL met deze indeling en sla deze op:
http://<domain>.ngrok.io
De doorstuur-URL instellen in uw app-instellingen
Voeg in Visual Studio Code in de ontwerpfunctie de trigger of actie HTTP + Webhook toe.
Wanneer de prompt wordt weergegeven voor de locatie van het hosteindpunt, voert u de doorstuur-URL (omleiding) in die u eerder hebt gemaakt.
Notitie
Als u de prompt negeert, wordt er een waarschuwing weergegeven dat u de doorstuur-URL moet opgeven. Selecteer daarom Configureren en voer de URL in. Nadat u deze stap hebt voltooid, wordt de prompt niet opnieuw weergegeven voor volgende webhooktriggers of acties die u mogelijk toevoegt.
Als u de prompt opnieuw wilt weergeven, opent u op het hoofdniveau van uw project het snelmenu van het bestand local.settings.json en selecteert u Omleidingseindpunt voor webhook configureren. De prompt wordt nu weergegeven, zodat u de doorstuur-URL kunt opgeven.
Visual Studio Code voegt de doorstuur-URL toe aan het bestand local.settings.json in de hoofdmap van uw project. In het
Values
object wordt de eigenschap met de naamWorkflows.WebhookRedirectHostUri
nu weergegeven en ingesteld op de doorstuur-URL, bijvoorbeeld:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "FUNCTIONS_V2_COMPATIBILITY_MODE": "true", <...> "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io", <...> } }
Notitie
Als uw project is gebaseerd op NuGet-pakketten (.NET), en niet op uitbreidingsbundels (Node.js),
"FUNCTIONS_WORKER_RUNTIME"
is ingesteld op"dotnet"
. Als u echter inlinecodebewerkingen wilt gebruiken, moet u hebben"FUNCTIONS_WORKER_RUNTIME"
ingesteld op"node"
De eerste keer dat u een lokale foutopsporingssessie start of de werkstroom uitvoert zonder foutopsporing, registreert de Logic Apps-runtime de werkstroom bij het service-eindpunt en abonneert u zich op dat eindpunt voor het melden van de webhookbewerkingen. De volgende keer dat uw werkstroom wordt uitgevoerd, wordt de runtime niet geregistreerd of opnieuw aangemeld omdat de abonnementsregistratie al bestaat in de lokale opslag.
Wanneer u de foutopsporingssessie stopt voor een werkstroomuitvoering die gebruikmaakt van lokaal uitgevoerde triggers of acties op basis van webhook, worden de bestaande abonnementsregistraties niet verwijderd. Als u de registratie ongedaan wilt maken, moet u de abonnementsregistraties handmatig verwijderen of verwijderen.
Notitie
Nadat de werkstroom is gestart, worden in het terminalvenster mogelijk fouten weergegeven zoals in dit voorbeeld:
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.'
In dit geval opent u het bestand local.settings.json in de hoofdmap van uw project en controleert u of de eigenschap is ingesteld op true
:
"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"
Onderbrekingspunten voor foutopsporing beheren
Voordat u de werkstroom van uw logische app uitvoert en test door een foutopsporingssessie te starten, kunt u onderbrekingspunten instellen in het bestand workflow.json voor elke werkstroom. Er is geen andere installatie vereist.
Op dit moment worden onderbrekingspunten alleen ondersteund voor acties, niet voor triggers. Elke actiedefinitie heeft de volgende onderbrekingspunten:
Stel het beginonderbrekingspunt in op de regel waarin de naam van de actie wordt weergegeven. Wanneer dit onderbrekingspunt wordt bereikt tijdens de foutopsporingssessie, kunt u de invoer van de actie controleren voordat ze worden geëvalueerd.
Stel het eindonderbrekingspunt in op de regel met de accolade voor het sluiten van de actie (}). Wanneer dit onderbrekingspunt wordt bereikt tijdens de foutopsporingssessie, kunt u de resultaten van de actie bekijken voordat de actie wordt uitgevoerd.
Voer de volgende stappen uit om een onderbrekingspunt toe te voegen:
Open het bestand workflow.json voor de werkstroom waarvoor u fouten wilt opsporen.
Selecteer in de linkerkolom op de regel waar u het onderbrekingspunt wilt instellen, in die kolom. Als u het onderbrekingspunt wilt verwijderen, selecteert u dat onderbrekingspunt.
Wanneer u de foutopsporingssessie start, wordt de weergave Uitvoeren weergegeven aan de linkerkant van het codevenster, terwijl de werkbalk Foutopsporing bovenaan wordt weergegeven.
Notitie
Als de weergave Uitvoeren niet automatisch wordt weergegeven, drukt u op Ctrl+Shift+D.
Als u de beschikbare informatie wilt bekijken wanneer een onderbrekingspunt wordt bereikt, bekijkt u in de weergave Uitvoeren het deelvenster Variabelen.
Als u wilt doorgaan met de uitvoering van de werkstroom, selecteert u doorgaan (knop Afspelen) op de werkbalk Foutopsporing.
U kunt onderbrekingspunten op elk gewenst moment toevoegen en verwijderen tijdens de uitvoering van de werkstroom. Als u echter het bestand workflow.json bijwerkt nadat de uitvoering is gestart, worden onderbrekingspunten niet automatisch bijgewerkt. Start de logische app opnieuw om de onderbrekingspunten bij te werken.
Zie Onderbrekingspunten - Visual Studio Code voor algemene informatie.
Lokaal uitvoeren, testen en fouten opsporen
Als u uw logische app wilt testen, volgt u deze stappen om een foutopsporingssessie te starten en zoekt u de URL voor het eindpunt dat is gemaakt door de aanvraagtrigger. U hebt deze URL nodig, zodat u later een aanvraag naar dat eindpunt kunt verzenden.
Als u eenvoudiger fouten in een staatloze werkstroom wilt opsporen, kunt u de uitvoeringsgeschiedenis voor die werkstroom inschakelen.
Open op de activiteitenbalk van Visual Studio Code het menu Uitvoeren en selecteer Foutopsporing starten (F5).
Het terminalvenster wordt geopend, zodat u de foutopsporingssessie kunt bekijken.
Notitie
Als u de fout 'Fout bestaat na het uitvoeren van preLaunchTask 'generateDebugSymbols' krijgt, raadpleegt u de probleemoplossingssectieFoutopsporingssessie kan niet worden gestart.
Zoek nu de callback-URL voor het eindpunt op de aanvraagtrigger.
Open het deelvenster Explorer opnieuw zodat u uw project kunt bekijken.
Selecteer Overzicht in het snelmenu van het bestand workflow.json.
Zoek de waarde van callback-URL , die er ongeveer uitziet als deze URL voor de voorbeeldaanvraagtrigger:
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>
Als u de callback-URL wilt testen door de werkstroom van de logische app te activeren, opent u Postman of het hulpprogramma van uw voorkeur voor het maken en verzenden van aanvragen.
In dit voorbeeld wordt postman gebruikt. Zie Postman Aan de slag voor meer informatie.
Selecteer Nieuw op de postman-werkbalk.
Selecteer in het deelvenster Nieuw maken onder Bouwstenende optie Aanvraag.
Geef in het venster Aanvraag opslaan onder Aanvraagnaam een naam op voor de aanvraag, bijvoorbeeld
Test workflow trigger
.Selecteer onder Selecteer een verzameling of map om op te slaan de optie Verzameling maken.
Geef onder Alle verzamelingen een naam op voor de verzameling die u wilt maken voor het ordenen van uw aanvragen, druk op Enter en selecteer Opslaan in <verzamelingsnaam>. In dit voorbeeld wordt gebruikt
Logic Apps requests
als de naam van de verzameling.In Postman wordt het aanvraagvenster geopend, zodat u een aanvraag kunt verzenden naar de callback-URL voor de aanvraagtrigger.
Ga terug naar Visual Studio Code. Kopieer op de overzichtspagina van de werkstroom de waarde van de eigenschap Callback-URL .
Ga terug naar Postman. Plak in het aanvraagvenster naast de lijst met methoden, die momenteel GET als de standaardaanvraagmethode weergeeft, de callback-URL die u eerder hebt gekopieerd in het adresvak en selecteer Verzenden.
De voorbeeldwerkstroom van de logische app verzendt een e-mailbericht dat lijkt op dit voorbeeld:
Ga in Visual Studio Code terug naar de overzichtspagina van uw werkstroom.
Als u een stateful werkstroom hebt gemaakt nadat de aanvraag die u hebt verzonden de werkstroom heeft geactiveerd, wordt op de overzichtspagina de uitvoeringsstatus en geschiedenis van de werkstroom weergegeven.
Tip
Als de uitvoeringsstatus niet wordt weergegeven, vernieuwt u de overzichtspagina door Vernieuwen te selecteren. Er vindt geen uitvoering plaats voor een trigger die wordt overgeslagen vanwege niet-voldaan criteria of het vinden van geen gegevens.
In de volgende tabel ziet u de mogelijke definitieve statussen die elke werkstroomuitvoering kan hebben en weergeven in Visual Studio Code:
Uitvoeringsstatus Beschrijving Aborted De uitvoering is gestopt of niet voltooid vanwege externe problemen, bijvoorbeeld een systeemstoring of een verlopen Azure-abonnement. Geannuleerd De uitvoering is geactiveerd en gestart, maar heeft een annuleringsaanvraag ontvangen. Mislukt Ten minste één actie in de uitvoering is mislukt. Er zijn geen volgende acties in de werkstroom ingesteld om de fout af te handelen. Wordt uitgevoerd De uitvoering is geactiveerd en wordt uitgevoerd, maar deze status kan ook worden weergegeven voor een uitvoering die wordt beperkt vanwege actielimieten of het huidige prijsplan. Tip: als u diagnostische logboekregistratie instelt, kunt u informatie krijgen over eventuele vertragingsevenementen die zich voordoen.
Geslaagd De uitvoering is voltooid. Als een actie is mislukt, heeft een volgende actie in de werkstroom die fout verwerkt. Time-out Er is een time-out opgetreden voor de uitvoering omdat de huidige duur de limiet voor de uitvoeringsduur heeft overschreden, die wordt bepaald door de instelling Retentie van uitvoeringsgeschiedenis in dagen. De duur van een uitvoering wordt berekend met behulp van de begintijd van de uitvoering en de limiet voor de uitvoeringsduur op die begintijd. Opmerking: als de duur van de uitvoering ook de huidige retentielimiet voor de uitvoeringsgeschiedenis overschrijdt, die ook wordt bepaald door de instelling Retentie van uitvoeringsgeschiedenis in dagen, wordt de uitvoering gewist uit de uitvoeringsgeschiedenis door een dagelijkse opschoningstaak. Ongeacht of er een time-out optreedt of wordt voltooid, wordt de retentieperiode altijd berekend met behulp van de begintijd en de huidige retentielimiet van de uitvoering. Dus als u de duurlimiet voor een uitvoering tijdens de vlucht verlaagt, treedt er een time-out op voor de uitvoering. De uitvoering blijft echter behouden of wordt gewist uit de uitvoeringsgeschiedenis op basis van het feit of de duur van de uitvoering de retentielimiet heeft overschreden.
Wachten De uitvoering is niet gestart of is onderbroken, bijvoorbeeld vanwege een eerdere werkstroominstantie die nog steeds wordt uitgevoerd. Als u de statussen voor elke stap in een specifieke uitvoering en de invoer en uitvoer van de stap wilt controleren, selecteert u de knop met het beletselteken (...) voor die uitvoering en selecteert u Uitvoeren weergeven.
Visual Studio Code opent de bewakingsweergave en toont de status voor elke stap in de uitvoering.
Notitie
Als een uitvoering is mislukt en een stap in de bewakingsweergave de
400 Bad Request
fout laat zien, kan dit probleem het gevolg zijn van een langere triggernaam of actienaam waardoor de onderliggende URI (Uniform Resource Identifier) de standaardtekenlimiet overschrijdt. Zie '400 Ongeldige aanvraag' voor meer informatie.In de volgende tabel ziet u de mogelijke statussen die elke werkstroomactie kan hebben en weergeven in Visual Studio Code:
Actiestatus Beschrijving Aborted De actie is gestopt of niet voltooid vanwege externe problemen, bijvoorbeeld een systeemstoring of een verlopen Azure-abonnement. Geannuleerd De actie werd uitgevoerd, maar heeft een aanvraag ontvangen om te annuleren. Mislukt De actie is mislukt. Wordt uitgevoerd De actie wordt momenteel uitgevoerd. Overgeslagen De actie is overgeslagen omdat de direct voorafgaande actie is mislukt. Een actie heeft een runAfter
voorwaarde die vereist dat de voorgaande actie wordt voltooid voordat de huidige actie kan worden uitgevoerd.Geslaagd De actie is voltooid. Geslaagd met nieuwe pogingen De actie is geslaagd, maar pas na een of meer nieuwe pogingen. Als u de geschiedenis van nieuwe pogingen wilt bekijken, selecteert u die actie in de weergave Details van uitvoeringsgeschiedenis, zodat u de invoer en uitvoer kunt bekijken. Time-out De actie is gestopt vanwege de time-outlimiet die is opgegeven in de instellingen van die actie. Wachten Is van toepassing op een webhookactie die wacht op een inkomende aanvraag van een beller. Als u de invoer en uitvoer voor elke stap wilt bekijken, selecteert u de stap die u wilt inspecteren.
Als u de onbewerkte invoer en uitvoer voor die stap verder wilt bekijken, selecteert u Onbewerkte invoer weergeven of Onbewerkte uitvoer weergeven.
Als u de foutopsporingssessie wilt stoppen, selecteert u in het menu Uitvoerende optie Foutopsporing stoppen (Shift + F5).
Een antwoord retourneren
Als u een antwoord wilt retourneren aan de aanroeper die een aanvraag naar uw logische app heeft verzonden, kunt u de ingebouwde actie Antwoord gebruiken voor een werkstroom die begint met de aanvraagtrigger.
Selecteer in de werkstroomontwerper onder de actie Een e-mail verzenden het plusteken (+) >Een actie toevoegen.
De prompt Een bewerking kiezen wordt weergegeven in de ontwerpfunctie en het deelvenster Een actie toevoegen wordt opnieuw geopend, zodat u de volgende actie kunt selecteren.
Controleer in het deelvenster Een actie toevoegen onder het zoekvak Een actie kiezen of Ingebouwd is geselecteerd. Typ in
response
het zoekvak en selecteer de actie Antwoord .Wanneer de actie Antwoord wordt weergegeven in de ontwerpfunctie, wordt het detailvenster van de actie automatisch geopend.
Geef op het tabblad Parameters de vereiste informatie op voor de functie die u wilt aanroepen.
In dit voorbeeld wordt de waarde van de eigenschap Body geretourneerd die uitvoer is van de actie Een e-mail verzenden .
Klik in het eigenschappenvak Hoofdtekst , zodat de lijst met dynamische inhoud wordt weergegeven en de beschikbare uitvoerwaarden van de voorgaande trigger en acties in de werkstroom worden weergegeven.
Selecteer in de lijst met dynamische inhoud onder Een e-mail verzendende optie Hoofdtekst.
Wanneer u klaar bent, wordt de eigenschap Hoofdtekst van de reactieactie nu ingesteld op de uitvoerwaarde Hoofdtekst van de actie Een e-mail verzenden.
Selecteer Opslaan in de ontwerpfunctie.
Uw logische app opnieuw testen
Nadat u de logische app hebt bijgewerkt, kunt u nog een test uitvoeren door het foutopsporingsprogramma opnieuw uit te voeren in Visual Studio en een andere aanvraag te verzenden om uw bijgewerkte logische app te activeren, vergelijkbaar met de stappen in Lokaal uitvoeren, testen en fouten opsporen.
Open op de activiteitenbalk van Visual Studio Code het menu Uitvoeren en selecteer Foutopsporing starten (F5).
Verzend in Postman of uw hulpprogramma voor het maken en verzenden van aanvragen een andere aanvraag om uw werkstroom te activeren.
Als u een stateful werkstroom hebt gemaakt, controleert u op de overzichtspagina van de werkstroom de status van de meest recente uitvoering. Als u de status, invoer en uitvoer voor elke stap in die uitvoering wilt weergeven, selecteert u de beletseltekens (...) voor die uitvoering en selecteert u Uitvoering weergeven.
Hier ziet u bijvoorbeeld de stapsgewijze status voor een uitvoering nadat de voorbeeldwerkstroom is bijgewerkt met de actie Antwoord.
Als u de foutopsporingssessie wilt stoppen, selecteert u in het menu Uitvoerende optie Foutopsporing stoppen (Shift + F5).
Domeinnamen zoeken voor toegang tot firewalls
Voordat u de werkstroom van uw logische app implementeert en uitvoert in de Azure Portal, moet u, als uw omgeving strikte netwerkvereisten of firewalls heeft die verkeer beperken, machtigingen instellen voor alle trigger- of actieverbindingen die aanwezig zijn in uw werkstroom.
Voer de volgende stappen uit om de FQDN's (Fully Qualified Domain Names) voor deze verbindingen te vinden:
Open in uw logische app-project het bestand connections.json , dat wordt gemaakt nadat u de eerste op verbinding gebaseerde trigger of actie aan uw werkstroom hebt toegevoegd en het
managedApiConnections
object hebt gevonden.Voor elke verbinding die u hebt gemaakt, kopieert en slaat u de waarde van de
connectionRuntimeUrl
eigenschap op een veilige plaats op, zodat u uw firewall met deze informatie kunt instellen.Dit voorbeeld van het bestand connections.json bevat twee verbindingen, een AS2-verbinding en een Office 365-verbinding met deze
connectionRuntimeUrl
waarden: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" } } } }
Implementeren op Azure
Vanuit Visual Studio Code kunt u uw project rechtstreeks publiceren naar Azure, waarbij uw logische app wordt geïmplementeerd met behulp van het resourcetype Logische app (Standaard). U kunt uw logische app publiceren als een nieuwe resource, waarmee automatisch alle benodigde resources, zoals een Azure Storage-account, worden gemaakt, vergelijkbaar met de vereisten voor functie-apps. U kunt uw logische app ook publiceren naar een eerder geïmplementeerde logische app-resource (Standaard), waardoor die logische app wordt overschreven.
Implementatie voor het resourcetype Logische app (Standard) vereist een hostingabonnement en prijscategorie, die u tijdens de implementatie selecteert. Raadpleeg Hostingabonnementen en prijscategorieën voor meer informatie.
Publiceren naar een nieuwe logische app-resource (Standard)
Selecteer op de activiteitenbalk van Visual Studio Code het pictogram Azure.
Selecteer implementeren in logische app op de werkbalk van het deelvenster Azure: Logic Apps (Standaard).
Als u hierom wordt gevraagd, selecteert u het Azure-abonnement dat u wilt gebruiken voor de implementatie van uw logische app.
Selecteer in de lijst die Visual Studio Code opent de volgende opties:
- Nieuwe logische app (Standard) maken in Azure (snel)
- Nieuwe logische app (Standard) maken in Azure Advanced
- Een eerder geïmplementeerde logische app-resource (Standaard), indien aanwezig
Dit voorbeeld gaat verder met Nieuwe logische app (Standard) maken in Azure Advanced.
Voer de volgende stappen uit om uw nieuwe logische app-resource (Standard) te maken:
Geef een wereldwijd unieke naam op voor uw nieuwe logische app. Dit is de naam die moet worden gebruikt voor de resource Logische app (Standaard). In dit voorbeeld wordt
Fabrikam-Workflows-App
gebruikt.Selecteer een hostingabonnement voor uw nieuwe logische app. Maak een naam voor uw plan of selecteer een bestaand plan (alleen windows-App Service abonnementen). In dit voorbeeld wordt Nieuw App Service-abonnement maken geselecteerd.
Geef een naam op voor uw hostingabonnement en selecteer vervolgens een prijscategorie voor uw geselecteerde abonnement.
Raadpleeg Hostingabonnementen en prijscategorieën voor meer informatie.
Voor optimale prestaties selecteert u dezelfde resourcegroep als uw project voor de implementatie.
Notitie
Hoewel u een andere resourcegroep kunt maken of gebruiken, kan dit van invloed zijn op de prestaties. Als u een andere resourcegroep maakt of kiest, maar annuleert nadat de bevestigingsprompt wordt weergegeven, wordt uw implementatie ook geannuleerd.
Voor stateful werkstromen selecteert u Nieuw opslagaccount of een bestaand opslagaccount maken.
Als de instellingen voor het maken en implementeren van uw logische app ondersteuning bieden voor het gebruik van Application Insights, kunt u desgewenst diagnostische logboekregistratie en tracering inschakelen voor uw logische app. U kunt dit doen wanneer u uw logische app implementeert vanuit Visual Studio Code of na de implementatie. U hebt een Application Insights-exemplaar nodig, maar u kunt deze resource van tevoren maken, wanneer u uw logische app implementeert of na de implementatie.
Voer de volgende stappen uit om logboekregistratie en tracering nu in te schakelen:
Selecteer een bestaande Application Insights-resource of Nieuwe Application Insights-resource maken.
Ga in de Azure Portal naar uw Application Insights-resource.
Selecteer Overzicht in het resourcemenu. Zoek en kopieer de waarde van de instrumentatiesleutel .
Open in Visual Studio Code in de hoofdmap van uw project het bestand local.settings.json .
Voeg in het
Values
object deAPPINSIGHTS_INSTRUMENTATIONKEY
eigenschap toe en stel de waarde in op de instrumentatiesleutel, bijvoorbeeld:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key> } }
Tip
U kunt controleren of de namen van de trigger en de actie correct worden weergegeven in uw Application Insights-exemplaar.
Ga in de Azure Portal naar uw Application Insights-resource.
Selecteer in het resourceresourcemenu onder Onderzoekende optie Toepassingstoewijzing.
Controleer de namen van de bewerkingen die op de kaart worden weergegeven.
Sommige inkomende aanvragen van ingebouwde triggers kunnen als duplicaten worden weergegeven in het toepassingsoverzicht. In plaats van de
WorkflowName.ActionName
indeling te gebruiken, gebruiken deze duplicaten de naam van de werkstroom als de naam van de bewerking en zijn ze afkomstig van de Azure Functions host.Vervolgens kunt u desgewenst het ernstniveau aanpassen voor de traceringsgegevens die uw logische app verzamelt en verzendt naar uw Application Insights-exemplaar.
Telkens wanneer een werkstroomgerelateerde gebeurtenis plaatsvindt, bijvoorbeeld wanneer een werkstroom wordt geactiveerd of wanneer een actie wordt uitgevoerd, verzendt de runtime verschillende traceringen. Deze traceringen hebben betrekking op de levensduur van de werkstroom en omvatten, maar zijn niet beperkt tot, de volgende gebeurtenistypen:
- Serviceactiviteit, zoals starten, stoppen en fouten.
- Taken en dispatcheractiviteit.
- Werkstroomactiviteit, zoals trigger, actie en uitvoeren.
- Activiteit van opslagaanvragen, zoals geslaagd of mislukt.
- HTTP-aanvraagactiviteit, zoals inkomend, uitgaand, geslaagd en mislukt.
- Eventuele ontwikkelingstraceringen, zoals foutopsporingsberichten.
Elk gebeurtenistype wordt toegewezen aan een ernstniveau. Het niveau legt bijvoorbeeld
Trace
de meest gedetailleerde berichten vast, terwijl hetInformation
niveau algemene activiteit in uw werkstroom vastlegt, zoals wanneer uw logische app, werkstroom, trigger en acties starten en stoppen. In deze tabel worden de ernstniveaus en de bijbehorende traceringstypen beschreven:Ernstniveau Traceringstype Kritiek Logboeken waarin een onherstelbare fout in uw logische app wordt beschreven. Fouten opsporen Logboeken die u kunt gebruiken voor onderzoek tijdens de ontwikkeling, bijvoorbeeld inkomende en uitgaande HTTP-aanroepen. Fout Logboeken die duiden op een fout in de uitvoering van de werkstroom, maar niet op een algemene fout in uw logische app. Informatie Logboeken die de algemene activiteit in uw logische app of werkstroom bijhouden, bijvoorbeeld: - Wanneer een trigger, actie of uitvoering wordt gestart en beëindigd.
- Wanneer uw logische app wordt gestart of beëindigd.Tracering Logboeken die de meest gedetailleerde berichten bevatten, bijvoorbeeld opslagaanvragen of dispatcheractiviteit, plus alle berichten die betrekking hebben op de uitvoeringsactiviteit van de werkstroom. Waarschuwing Logboeken die een abnormale status in uw logische app markeren, maar de uitvoering ervan niet verhinderen. Als u het ernstniveau wilt instellen, opent u het bestand host.json op het hoofdniveau van het project en zoekt u het
logging
object. Dit object bepaalt het filteren van logboeken voor alle werkstromen in uw logische app en volgt de indeling ASP.NET Core voor het filteren van logboektypen.{ "version": "2.0", "logging": { "applicationInsights": { "samplingExcludedTypes": "Request", "samplingSettings": { "isEnabled": true } } } }
Als het
logging
object geen object bevatlogLevel
dat deHost.Triggers.Workflow
eigenschap bevat, voegt u deze items toe. Stel de eigenschap in op het ernstniveau voor het gewenste traceringstype, bijvoorbeeld:{ "version": "2.0", "logging": { "applicationInsights": { "samplingExcludedTypes": "Request", "samplingSettings": { "isEnabled": true } }, "logLevel": { "Host.Triggers.Workflow": "Information" } } }
Wanneer u klaar bent met de implementatiestappen, begint Visual Studio Code met het maken en implementeren van de resources die nodig zijn voor het publiceren van uw logische app.
Als u het implementatieproces wilt controleren en bewaken, selecteert u Uitvoer in het menu Beeld. Selecteer Azure Logic Apps in de werkbalklijst van het venster Uitvoer.
Wanneer Visual Studio Code klaar is met het implementeren van uw logische app in Azure, wordt het volgende bericht weergegeven:
Gefeliciteerd, uw logische app is nu live in Azure en standaard ingeschakeld.
Vervolgens leert u hoe u deze taken uitvoert:
Beheer geïmplementeerde logische apps in Visual Studio Code of met behulp van de Azure Portal.
Schakel de uitvoeringsgeschiedenis in voor staatloze werkstromen.
Schakel de bewakingsweergave in de Azure Portal in voor een geïmplementeerde logische app.
Lege werkstroom toevoegen aan project
U kunt meerdere werkstromen in uw logische app-project hebben. Voer de volgende stappen uit om een lege werkstroom toe te voegen aan uw project:
Selecteer op de activiteitenbalk van Visual Studio Code het pictogram Azure.
Selecteer in het deelvenster Azure naast Azure: Logic Apps (Standard) de optie Werkstroom maken (pictogram voor Azure Logic Apps).
Selecteer het werkstroomtype dat u wilt toevoegen: Stateful of Stateless
Geef een naam op voor uw werkstroom.
Wanneer u klaar bent, wordt er een nieuwe werkstroommap weergegeven in uw project, samen met een workflow.json-bestand voor de werkstroomdefinitie.
Geïmplementeerde logische apps beheren in Visual Studio Code
In Visual Studio Code kunt u alle geïmplementeerde logische apps in uw Azure-abonnement bekijken, ongeacht of dit het oorspronkelijke logic apps-resourcetype of het resourcetype Logische app (Standaard) zijn, en taken selecteren waarmee u deze logische apps kunt beheren. Voor toegang tot beide resourcetypen hebt u echter zowel de Azure Logic Apps - als de Azure Logic Apps (Standard) -extensies voor Visual Studio Code nodig.
Selecteer op de linkerwerkbalk het pictogram Azure. Vouw in het deelvenster Azure: Logic Apps (Standard) uw abonnement uit, waarin alle geïmplementeerde logische apps voor dat abonnement worden weergegeven.
Open de logische app die u wilt beheren. Selecteer in het snelmenu van de logische app de taak die u wilt uitvoeren.
U kunt bijvoorbeeld taken selecteren zoals stoppen, starten, opnieuw starten of verwijderen van uw geïmplementeerde logische app. U kunt een werkstroom uitschakelen of inschakelen met behulp van de Azure Portal.
Notitie
De bewerkingen voor het stoppen van de logische app en het verwijderen van logische apps zijn op verschillende manieren van invloed op werkstroomexemplaren. Raadpleeg Overwegingen voor het stoppen van logische apps en Overwegingen voor het verwijderen van logische apps voor meer informatie.
Als u alle werkstromen in de logische app wilt weergeven, vouwt u de logische app uit en vouwt u vervolgens het knooppunt Werkstromen uit.
Als u een specifieke werkstroom wilt weergeven, opent u het snelmenu van de werkstroom en selecteert u Openen in Designer, waarmee de werkstroom in de modus Alleen-lezen wordt geopend.
Als u de werkstroom wilt bewerken, hebt u de volgende opties:
Open in Visual Studio Code het bestand workflow.json van uw project in de werkstroomontwerper, breng uw wijzigingen aan en implementeer uw logische app opnieuw in Azure.
Open uw logische app in de Azure Portal. Vervolgens kunt u uw werkstroom openen, bewerken en opslaan.
Als u de geïmplementeerde logische app in de Azure Portal wilt openen, opent u het snelmenu van de logische app en selecteert u Openen in portal.
De Azure Portal wordt geopend in uw browser, meldt u automatisch aan bij de portal als u bent aangemeld bij Visual Studio Code en toont uw logische app.
U kunt zich ook afzonderlijk aanmelden bij de Azure Portal, het zoekvak van de portal gebruiken om uw logische app te vinden en vervolgens uw logische app selecteren in de lijst met resultaten.
Overwegingen voor het stoppen van logische apps
Het stoppen van een logische app beïnvloedt werkstroomexemplaren op de volgende manieren:
Azure Logic Apps annuleert alle actieve en in behandeling zijnde uitvoeringen onmiddellijk.
Azure Logic Apps maakt of voert geen nieuwe werkstroomexemplaren uit.
Triggers worden niet geactiveerd wanneer de volgende keer aan hun voorwaarden wordt voldaan. Triggerstatussen onthouden echter de punten waarop de logische app is gestopt. Dus als u de logische app opnieuw start, worden de triggers geactiveerd voor alle niet-verwerkte items sinds de laatste uitvoering.
Als u wilt voorkomen dat een trigger wordt geactiveerd op niet-verwerkte items sinds de laatste uitvoering, wist u de triggerstatus voordat u de logische app opnieuw start:
- Selecteer in Visual Studio Code op de linkerwerkbalk het pictogram Azure.
- Vouw in het deelvenster Azure: Logic Apps (Standard) uw abonnement uit, waarin alle geïmplementeerde logische apps voor dat abonnement worden weergegeven.
- Vouw uw logische app uit en vouw vervolgens het knooppunt met de naam Werkstromen uit.
- Open een werkstroom en bewerk een deel van de trigger van die werkstroom.
- Sla uw wijzigingen op. Met deze stap wordt de huidige status van de trigger opnieuw ingesteld.
- Herhaal dit voor elke werkstroom.
- Wanneer u klaar bent, start u de logische app opnieuw op.
Overwegingen voor het verwijderen van logische apps
Het verwijderen van een logische app heeft op de volgende manieren invloed op werkstroomexemplaren:
Azure Logic Apps annuleert actieve en in behandeling zijnde uitvoeringen onmiddellijk, maar voert geen opschoontaken uit in de opslag die door de app wordt gebruikt.
Azure Logic Apps maakt of voert geen nieuwe werkstroomexemplaren uit.
Als u een werkstroom verwijdert en vervolgens dezelfde werkstroom opnieuw maakt, heeft de opnieuw gemaakte werkstroom niet dezelfde metagegevens als de verwijderde werkstroom. Als u de metagegevens wilt vernieuwen, moet u elke werkstroom die de verwijderde werkstroom heeft aangeroepen, opnieuw opslaan. Op die manier krijgt de aanroeper de juiste informatie voor de opnieuw gemaakte werkstroom. Anders mislukken aanroepen naar de opnieuw gemaakte werkstroom met een
Unauthorized
fout. Dit gedrag is ook van toepassing op werkstromen die gebruikmaken van artefacten in integratieaccounts en werkstromen die Azure-functies aanroepen.
Geïmplementeerde logische apps beheren in de portal
Nadat u vanuit Visual Studio Code een logische app hebt geïmplementeerd op de Azure Portal, kunt u alle geïmplementeerde logische apps weergeven die zich in uw Azure-abonnement bevinden, ongeacht of deze het oorspronkelijke Logic Apps-resourcetype of het resourcetype Logische app (Standaard) zijn. Op dit moment wordt elk resourcetype in Azure georganiseerd en beheerd als afzonderlijke categorieën. Voer de volgende stappen uit om logische apps te vinden die het resourcetype Logische app (Standaard) hebben:
Voer in
logic apps
het zoekvak Azure Portal in. Wanneer de lijst met resultaten wordt weergegeven, selecteert u onder Servicesde optie Logische apps.Selecteer in het deelvenster Logische apps de logische app die u hebt geïmplementeerd vanuit Visual Studio Code.
De Azure Portal opent de afzonderlijke resourcepagina voor de geselecteerde logische app.
Als u de werkstromen in deze logische app wilt weergeven, selecteert u Werkstromen in het menu van de logische app.
In het deelvenster Werkstromen worden alle werkstromen in de huidige logische app weergegeven. In dit voorbeeld ziet u de werkstroom die u hebt gemaakt in Visual Studio Code.
Als u een werkstroom wilt weergeven, selecteert u die werkstroom in het deelvenster Werkstromen .
Het werkstroomvenster wordt geopend en bevat meer informatie en taken die u voor die werkstroom kunt uitvoeren.
Als u bijvoorbeeld de stappen in de werkstroom wilt weergeven, selecteert u Designer.
De werkstroomontwerper wordt geopend en toont de werkstroom die u hebt gemaakt in Visual Studio Code. U kunt nu wijzigingen aanbrengen in deze werkstroom in de Azure Portal.
Een andere werkstroom toevoegen in de portal
Via de Azure Portal kunt u lege werkstromen toevoegen aan een resource voor logische apps (Standard) die u hebt geïmplementeerd vanuit Visual Studio Code en deze werkstromen bouwen in de Azure Portal.
Selecteer in de Azure Portal de geïmplementeerde resource logische app (Standaard).
Selecteer In het menu van de logische app de optie Werkstromen. Selecteer Toevoegen in het deelvenster Werkstromen.
Geef in het deelvenster Nieuwe werkstroom een naam op voor de werkstroom. Selecteer Stateful of Stateless>Maken.
Nadat Azure uw nieuwe werkstroom heeft geïmplementeerd, die wordt weergegeven in het deelvenster Werkstromen , selecteert u die werkstroom zodat u andere taken kunt beheren en uitvoeren, zoals het openen van de ontwerp- of codeweergave.
Als u bijvoorbeeld de ontwerpfunctie voor een nieuwe werkstroom opent, wordt er een leeg canvas weergegeven. U kunt deze werkstroom nu bouwen in de Azure Portal.
Uitvoeringsgeschiedenis inschakelen voor stateless werkstromen
Als u eenvoudiger fouten in een staatloze werkstroom wilt opsporen, kunt u de uitvoeringsgeschiedenis voor die werkstroom inschakelen en vervolgens de uitvoeringsgeschiedenis uitschakelen wanneer u klaar bent. Volg deze stappen voor Visual Studio Code. Als u in de Azure Portal werkt, raadpleegt u Werkstromen met één tenant maken in de Azure Portal.
Vouw in uw Visual Studio Code-project de map met de naam workflow-designtime uit en open het bestand local.settings.json .
Voeg de
Workflows.{yourWorkflowName}.operationOptions
eigenschap toe en stel de waarde in opWithStatelessRunHistory
, bijvoorbeeld:Windows
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory" } }
macOS of Linux
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \ AccountKey=<access-key>;EndpointSuffix=core.windows.net", "FUNCTIONS_WORKER_RUNTIME": "node", "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory" } }
Als u de uitvoeringsgeschiedenis wilt uitschakelen wanneer u klaar bent, stelt u de
Workflows.{yourWorkflowName}.OperationOptions
eigenschap in opNone
of verwijdert u de eigenschap en de bijbehorende waarde.
Bewakingsweergave inschakelen in de Azure Portal
Nadat u een logische app-resource (Standard) van Visual Studio Code in Azure hebt geïmplementeerd, kunt u de beschikbare uitvoeringsgeschiedenis en details voor een werkstroom in die resource bekijken met behulp van de Azure Portal en de monitorervaring voor die werkstroom. U moet echter eerst de mogelijkheid Weergave controleren inschakelen voor die logische app-resource.
Selecteer in de Azure Portal de geïmplementeerde resource logische app (Standaard).
Selecteer cors in het menu van die resource onder API.
Voeg in het deelvenster CORS onder Toegestane oorsprongen het jokerteken (*) toe.
Wanneer u klaar bent, selecteert u Opslaan op de CORS-werkbalk.
Application Insights inschakelen of openen na implementatie
Tijdens de uitvoering van de werkstroom verzendt uw logische app telemetrie, samen met andere gebeurtenissen. U kunt deze telemetrie gebruiken om beter inzicht te krijgen in hoe goed uw werkstroom wordt uitgevoerd en hoe de Logic Apps-runtime op verschillende manieren werkt. U kunt uw werkstroom bewaken met behulp van Application Insights, dat bijna realtime telemetrie (live metrische gegevens) biedt. Met deze mogelijkheid kunt u fouten en prestatieproblemen gemakkelijker onderzoeken wanneer u deze gegevens gebruikt om problemen te diagnosticeren, waarschuwingen in te stellen en grafieken te maken.
Als de instellingen voor het maken en implementeren van uw logische app ondersteuning bieden voor het gebruik van Application Insights, kunt u desgewenst diagnostische logboekregistratie en tracering inschakelen voor uw logische app. U kunt dit doen wanneer u uw logische app implementeert vanuit Visual Studio Code of na de implementatie. U hebt een Application Insights-exemplaar nodig, maar u kunt deze resource van tevoren maken, wanneer u uw logische app implementeert of na de implementatie.
Voer de volgende stappen uit om Application Insights in te schakelen voor een geïmplementeerde logische app of om Application Insights-gegevens te controleren wanneer deze al zijn ingeschakeld:
Zoek in de Azure Portal uw geïmplementeerde logische app.
Selecteer in het menu van de logische app onder Instellingende optie Application Insights.
Als Application Insights niet is ingeschakeld, selecteert u Application Insights in het deelvenster Application Insights inschakelen. Nadat het deelvenster is bijgewerkt , selecteert u toepassen onderaan.
Als Application Insights is ingeschakeld, selecteert u Application Insights-gegevens weergeven in het deelvenster Application Insights.
Nadat Application Insights is geopend, kunt u verschillende metrische gegevens voor uw logische app bekijken. Raadpleeg deze onderwerpen voor meer informatie:
- Azure Logic Apps die overal worden uitgevoerd - Bewaken met Application Insights - deel 1
- Azure Logic Apps die overal worden uitgevoerd - Bewaken met Application Insights - deel 2
Items verwijderen uit de ontwerpfunctie
Voer een van de volgende stappen uit om een item in uw werkstroom uit de ontwerpfunctie te verwijderen:
Selecteer het item, open het snelmenu van het item (Shift+F10) en selecteer Verwijderen. Selecteer OK om de opdracht te bevestigen.
Selecteer het item en druk op de delete-toets. Selecteer OK om de opdracht te bevestigen.
Selecteer het item zodat het detailvenster voor dat item wordt geopend. Open in de rechterbovenhoek van het deelvenster het beletselteken (...) en selecteer Verwijderen. Selecteer OK om de opdracht te bevestigen.
Tip
Als het beletseltekenmenu niet zichtbaar is, vouwt u het Visual Studio Code-venster breed genoeg uit zodat in het detailvenster de knop met het beletselteken (...) in de rechterbovenhoek wordt weergegeven.
Fouten en problemen oplossen
Designer kan niet worden geopend
Wanneer u de ontwerpfunctie probeert te openen, krijgt u de volgende fout: 'Ontwerptijd werkstroom kan niet worden gestart'. Als u eerder hebt geprobeerd de ontwerpfunctie te openen en vervolgens uw project hebt stopgezet of verwijderd, wordt de extensiebundel mogelijk niet correct gedownload. Voer de volgende stappen uit om te controleren of deze oorzaak het probleem is:
Open in Visual Studio Code het venster Uitvoer. Selecteer Uitvoer in het menu Weergave.
Selecteer Azure Logic Apps (Standard) in de lijst in de titelbalk van het uitvoervenster, zodat u de uitvoer van de extensie kunt bekijken, bijvoorbeeld:
Controleer de uitvoer en controleer of dit foutbericht wordt weergegeven:
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.
Als u deze fout wilt oplossen, verwijdert u de map ExtensionBundles op deze locatie ...\Users{your-username}\AppData\Local\Temp\Functions\ExtensionBundles en probeert u het bestand workflow.json opnieuw te openen in de ontwerpfunctie.
Nieuwe triggers en acties ontbreken in de ontwerpfunctie voor eerder gemaakte werkstromen
Azure Logic Apps met één tenant ondersteunt ingebouwde acties voor Azure-functiebewerkingen, liquide bewerkingen en XML-bewerkingen, zoals XML-validatie en XML-transformatie. Voor eerder gemaakte logische apps worden deze acties mogelijk niet weergegeven in de ontwerpfunctie om te selecteren of Visual Studio Code gebruikmaakt van een verouderde versie van de extensiebundel, Microsoft.Azure.Functions.ExtensionBundle.Workflows
.
Bovendien worden de Azure Function Operations-connector en -acties niet weergegeven in de ontwerpfunctie, tenzij u Connectors uit Azure gebruiken hebt ingeschakeld of geselecteerd bij het maken van uw logische app. Als u de door Azure geïmplementeerde connectors niet hebt ingeschakeld tijdens het maken van de app, kunt u deze inschakelen vanuit uw project in Visual Studio Code. Open het snelmenu workflow.json en selecteer Connectors van Azure gebruiken.
Als u de verouderde bundel wilt oplossen, volgt u deze stappen om de verouderde bundel te verwijderen, waardoor Visual Studio Code de extensiebundel automatisch bijwerkt naar de nieuwste versie.
Notitie
Deze oplossing is alleen van toepassing op logische apps die u maakt en implementeert met Visual Studio Code met de Azure Logic Apps -extensie (Standard), niet op de logische apps die u hebt gemaakt met behulp van de Azure Portal. Zie Ondersteunde triggers en acties ontbreken in de ontwerpfunctie in de Azure Portal.
Sla werk op dat u niet wilt verliezen en sluit Visual Studio.
Blader op uw computer naar de volgende map, die versieversiemappen voor de bestaande bundel bevat:
...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows
Verwijder de versiemap voor de eerdere bundel, bijvoorbeeld als u een map voor versie 1.1.3 hebt, verwijdert u die map.
Blader nu naar de volgende map, die versieversiemappen bevat voor het vereiste NuGet-pakket:
...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension
Verwijder de versiemap voor het eerdere pakket.
Open Visual Studio Code, uw project en het bestand workflow.json opnieuw in de ontwerpfunctie.
De ontbrekende triggers en acties worden nu weergegeven in de ontwerpfunctie.
'400 Ongeldige aanvraag' wordt weergegeven in een trigger of actie
Wanneer een uitvoering mislukt en u de uitvoering in de bewakingsweergave inspecteert, kan deze fout worden weergegeven op een trigger of actie met een langere naam, waardoor de onderliggende URI (Uniform Resource Identifier) de standaardtekenlimiet overschrijdt.
U kunt dit probleem oplossen en aanpassen voor de langere URI door de UrlSegmentMaxCount
registersleutels en UrlSegmentMaxLength
op uw computer te bewerken door de onderstaande stappen uit te voeren. De standaardwaarden van deze sleutel worden beschreven in dit onderwerp ,Http.sys registerinstellingen voor Windows.
Belangrijk
Voordat u begint, moet u ervoor zorgen dat u uw werk opslaat. Voor deze oplossing moet u de computer opnieuw opstarten nadat u klaar bent, zodat de wijzigingen van kracht kunnen worden.
Open op uw computer het venster Uitvoeren en voer de
regedit
opdracht uit, waarmee de register-editor wordt geopend.Selecteer in het vak Gebruikersaccountbeheerde optie Ja om wijzigingen aan uw computer toe te laten.
Vouw in het linkerdeelvenster onder Computer de knooppunten langs het pad uit,HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parametersen selecteer parameters.
Zoek in het rechterdeelvenster de
UrlSegmentMaxCount
registersleutels enUrlSegmentMaxLength
.Verhoog deze sleutelwaarden voldoende zodat de URI's geschikt zijn voor de namen die u wilt gebruiken. Als deze sleutels niet bestaan, voegt u ze toe aan de map Parameters door de volgende stappen uit te voeren:
Selecteer in het snelmenu Parametersde optie Nieuwe>DWORD-waarde (32-bits).
Voer in
UrlSegmentMaxCount
het invoervak dat wordt weergegeven de naam van de nieuwe sleutel in.Open het snelmenu van de nieuwe toets en selecteer Wijzigen.
Voer in het vak Tekenreeks bewerken dat wordt weergegeven de waarde voor de gegevenssleutel Waarde in die u in hexadecimale of decimale notatie wilt gebruiken.
400
In is bijvoorbeeld hexadecimaal gelijk aan1024
in decimaal.Herhaal deze stappen om de
UrlSegmentMaxLength
sleutelwaarde toe te voegen.
Nadat u deze sleutelwaarden hebt verhoogd of toegevoegd, ziet de register-editor er als volgt uit:
Wanneer u klaar bent, start u de computer opnieuw op zodat de wijzigingen kunnen worden doorgevoerd.
Foutopsporingssessie kan niet worden gestart
Wanneer u probeert een foutopsporingssessie te starten, krijgt u de fout 'Fout bestaat na het uitvoeren van preLaunchTask 'generateDebugSymbols'. U kunt dit probleem oplossen door het bestand tasks.json in uw project te bewerken om het genereren van symbolen over te slaan.
Vouw in uw project de map met de naam .vscode uit en open het bestand tasks.json .
Verwijder in de volgende taak de regel,
"dependsOn: "generateDebugSymbols"
, samen met de komma waarmee de voorgaande regel wordt beëindigd, bijvoorbeeld:Voor:
{ "type": "func", "command": "host start", "problemMatcher": "$func-watch", "isBackground": true, "dependsOn": "generateDebugSymbols" }
Na:
{ "type": "func", "command": "host start", "problemMatcher": "$func-watch", "isBackground": true }
Volgende stappen
We horen graag van u over uw ervaringen met de Azure Logic Apps (Standard)-extensie.
- Voor bugs of problemen maakt u uw problemen in GitHub.
- Gebruik dit feedbackformulier voor vragen, aanvragen, opmerkingen en andere feedback.