Delen via


Werkstromen voor standaard logische apps maken met Visual Studio Code

Van toepassing op: Azure Logic Apps (Standard)

In deze handleiding ziet u hoe u lokaal een standaardwerkstroom voor logische apps maakt die u kunt uitvoeren in Azure Logic Apps met één tenant wanneer u Visual Studio Code gebruikt met de Extensie Azure Logic Apps (Standard).

In deze handleiding maakt u een werkruimte en project voor een standaard logische app, bouwt u uw werkstroom en implementeert u uw project als een standaardresource voor logische apps in Azure, waar uw werkstroom kan worden uitgevoerd in Azure Logic Apps met één tenant of in App Service Environment v3 (alleen Voor Windows gebaseerde App Service-plannen). U kunt uw werkstroom ook overal implementeren en uitvoeren die Kubernetes kan uitvoeren, zoals Azure, Azure Kubernetes Service, on-premises of zelfs andere cloudproviders, vanwege de containerruntime voor Azure Logic Apps (Standard).

Hier volgen slechts enkele voordelen die Standaard logische apps bieden:

  • U kunt lokaal werkstromen maken, fouten opsporen, uitvoeren en testen in de lokale Ontwikkelomgeving van Visual Studio Code. Zowel De Azure-portal als Visual Studio Code bieden de mogelijkheid om resources en werkstromen voor de standaard logische app te bouwen, uit te voeren en te implementeren. Met Visual Studio Code kunt u deze taken echter lokaal uitvoeren.

  • Uw standaardproject voor logische apps kan zowel stateful als stateless workflows bevatten.

  • Werkstromen in dezelfde standard-resource voor logische apps en tenants worden uitgevoerd in hetzelfde proces als de Azure Logic Apps -runtime (Standard), zodat ze dezelfde resources delen en betere prestaties bieden.

De voorbeeldwerkstroom van deze handleiding begint in eerste instantie met een aanvraagtrigger, gevolgd door een Office 365 Outlook-actie. De aanvraagtrigger maakt een aanroepbaar eindpunt voor de werkstroom en wacht op een binnenkomende HTTPS-aanvraag van een beller. Wanneer de trigger een aanvraag ontvangt en wordt geactiveerd, wordt de volgende actie uitgevoerd door e-mail te verzenden naar de opgegeven ontvanger, samen met eventuele triggeruitvoer die u selecteert. Later kunt u een antwoordactie toevoegen die een antwoord en verwerkte gegevens retourneert aan de beller.

Schermopname van Visual Studio Code, werkruimte van logische app, project en werkstroom.

Hoewel het voorbeeld van deze handleiding cloudgebaseerde is en slechts een paar stappen heeft, kunt u werkstromen maken met behulp van bewerkingen van meer dan 1400 connectors waarmee u een groot aantal services, systemen, apps en gegevens in de cloud, on-premises en hybride omgevingen kunt integreren.

Tijdens het doorlopen van de handleiding voert u de volgende taken op hoog niveau uit:

  • Maak een standaardwerkruimte en -project voor Logic Apps met een lege stateful workflow.
  • Voeg een trigger en acties toe aan uw werkstroom.
  • Lokaal uitvoeren, fouten opsporen en testen.
  • Bekijk de uitvoeringsgeschiedenis van de werkstroom.
  • Zoek domeinnaamdetails voor firewalltoegang.
  • Schakel het uitvoeringsoverzicht in voor staatloze werkstromen.
  • Implementeren in Azure, inclusief optioneel het inschakelen van Application Insights.
  • Schakel Application Insights in of open deze na de uitrol.
  • Beheer uw geïmplementeerde logische app-resource in Visual Studio Code en Azure Portal.

Vereiste voorwaarden

Vereisten voor toegang en connectiviteit

Als u van plan bent om werkstromen lokaal te maken en uit te voeren met behulp van alleen ingebouwde bewerkingen, die systeemeigen worden uitgevoerd op de Runtime van Azure Logic Apps (Standard), hebt u de toegangs- en connectiviteitsvereisten in deze sectie niet nodig. Voor de volgende scenario's moet u echter aan deze vereisten voldoen:

  • Implementeer uw logische app in Azure vanuit Visual Studio Code.
  • Bouw een werkstroom die gebruikmaakt van beheerde connectorbewerkingen die worden uitgevoerd in globale Azure.
  • Toegang krijgen tot bestaande resources en werkstromen voor logische apps van Standard in Azure of andere geïmplementeerde Azure-resources.

Deze vereisten omvatten de volgende items:

  • Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.

  • Toegang tot internet, zodat u de vereiste extensie kunt downloaden, verbinding kunt maken vanuit Visual Studio Code met uw Azure-account, werkstromen kunt testen die beheerde connectorbewerkingen bevatten en implementeren in Azure vanuit Visual Studio Code.

  • Als u dezelfde voorbeeldwerkstroom in deze handleiding wilt maken, hebt u een Office 365 Outlook-e-mailaccount nodig dat gebruikmaakt van een Werk- of schoolaccount van Microsoft om u aan te melden.

    Als u geen Office 365-account hebt, kunt u ook andere beschikbare acties gebruiken waarmee berichten kunnen worden verzonden vanuit uw e-mailaccount, bijvoorbeeld Outlook.com. Als u een andere e-mailconnector kiest, zoals Outlook.com, kunt u het voorbeeld nog steeds volgen en zijn de algemene algemene stappen hetzelfde. Uw ervaring en opties kunnen echter op een aantal manieren verschillen. Gebruik bijvoorbeeld met de Outlook.com-connector uw persoonlijke Microsoft-account om u aan te melden.

Gereedschappen

  1. Download en installeer Visual Studio Code, gratis.

  2. Download en installeer de Azure Logic Apps-extensie (Standard) voor Visual Studio Code door de volgende stappen uit te voeren:

    1. Selecteer Extensies in Visual Studio Code op de activiteitsbalk. (Toetsenbord: Druk op Ctrl+Shift+X)

    2. In het zoekvak voor extensies voert u Azure Logic Apps Standard in. Selecteer Azure Logic Apps (Standard) > Installeren in de lijst met resultaten.

      De extensie downloadt en installeert alle vereiste afhankelijkheden en de juiste versies voor de volgende frameworks:

      • Azure Functions Core Tools
      • .NET SDK
      • Node.js

      Nadat de installatie is voltooid, wordt de extensie weergegeven in de lijst Extensies: Geïnstalleerd .

      Schermopname van Visual Studio Code waarop de Azure Logic Apps-extensie (Standard) is geïnstalleerd.

    3. Laad Visual Studio Code opnieuw of start deze opnieuw om ervoor te zorgen dat de extensie en alle afhankelijkheden correct worden geïnstalleerd.

    4. Als u wilt controleren of de extensie en alle afhankelijkheden correct zijn geïnstalleerd, raadpleegt u De installatie van de extensie controleren.

    Op dit moment kunt u zowel verbruiksuitbreidingen (multitenant) als standaarduitbreidingen (één tenant) tegelijkertijd installeren. De ontwikkelervaringen verschillen op een aantal manieren van elkaar, maar uw Azure-abonnement kan zowel resourcetypen Standard als Consumption Logic App bevatten. In Visual Studio Code worden in het Deelvenster Azure alle door Azure geïmplementeerde en gehoste logische apps in uw Azure-abonnement weergegeven, maar worden uw apps op de volgende manieren georganiseerd:

    • Sectie Resources : Alle logische standaard-apps in uw abonnement.
    • Sectie Logic Apps (Verbruik): Alle verbruik logische apps in uw abonnement.
  3. Als u op webhook gebaseerde triggers en acties lokaal wilt uitvoeren, zoals de ingebouwde HTTP Webhook-trigger, moet u doorsturen instellen voor de callback-URL in Visual Studio Code.

  4. Als u diagnostische logboekregistratie en tracering wilt inschakelen met Application Insights voor uw standaard logische app, kunt u deze taak voltooien tijdens de implementatie van logische apps of na de implementatie. U moet een Application Insights-resource hebben, maar u kunt deze resource vooraf, tijdens de implementatie of na de implementatie maken.

  5. Installeer of gebruik een hulpprogramma waarmee HTTP-aanvragen kunnen worden verzonden om de voorbeeldwerkstroom te testen, bijvoorbeeld:

    Waarschuwing

    Voor scenario's waarin u gevoelige gegevens hebt, zoals referenties, geheimen, toegangstokens, API-sleutels en andere vergelijkbare informatie, moet u een hulpprogramma gebruiken waarmee uw gegevens worden beveiligd met de benodigde beveiligingsfuncties. Het hulpprogramma moet offline of lokaal werken en u hoeft zich niet aan te melden bij een onlineaccount of gegevens naar de cloud te synchroniseren. Wanneer u een hulpprogramma met deze kenmerken gebruikt, vermindert u het risico dat gevoelige gegevens openbaar worden gemaakt voor het publiek.

Installatie van extensies controleren

  1. Als u ervoor wilt zorgen dat de extensie en alle afhankelijkheden correct zijn geïnstalleerd, laadt of start u Visual Studio Code opnieuw.

  2. Controleer of Visual Studio Code automatisch extensie-updates vindt en installeert, zodat al uw extensies de meest recente updates krijgen. Anders moet u de verouderde versie handmatig verwijderen en de nieuwste versie installeren.

    1. Ga in het menu Bestand naar Voorkeureninstellingen>.

    2. Ga op het tabblad Gebruiker naar Functies>Extensies.

    3. Zorg ervoor dat Updates automatisch controleren is geselecteerd en dat Automatisch bijwerken is ingesteld op Alle extensies.

  3. Controleer of de Standaardinstelling van Azure Logic Apps: Project Runtime is ingesteld op de juiste versie:

    1. Ga op het tabblad Gebruiker naar >Extensies>Azure Logic Apps (Standaard).

    2. Zorg ervoor dat Project Runtime is ingesteld op versie ~4, bijvoorbeeld:

      Schermopname van Visual Studio Code-instellingen voor de Azure Logic Apps-extensie (Standard).

      Opmerking

      Deze versie is vereist voor het gebruik van de inlinecodebewerkingen.

Verbinding maken met uw Azure-account

Als u nog niet bent verbonden met uw Azure-account, volgt u deze stappen om verbinding te maken:

  1. Selecteer in Visual Studio Code op de activiteitenbalk het Azure-pictogram om het Deelvenster Azure te openen.

    Schermopname van de Visual Studio Code-activiteitenbalk en het geselecteerde Azure-pictogram.

  2. Selecteer In het deelvenster Azure onder Resources de optie Aanmelden bij Azure. Wanneer de visual Studio Code-verificatiepagina wordt weergegeven, meldt u zich aan met uw Azure-account.

    Schermopname van het deelvenster Azure met de geselecteerde koppeling voor aanmelden bij Azure.

    Nadat u zich hebt aangemeld, worden in het deelvenster Azure de Azure-abonnementen weergegeven die zijn gekoppeld aan uw Azure-account. 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:

    1. Verplaats de aanwijzer in de lijst met abonnementen naast het eerste abonnement totdat de knop Abonnementen selecteren (filterpictogram) wordt weergegeven. Selecteer het filterpictogram.

      Schermopname van het Deelvenster Azure met abonnementen en het geselecteerde filterpictogram.

      Of selecteer uw Azure-account in de statusbalk van Visual Studio Code.

    2. Wanneer de lijst met bijgewerkte abonnementen wordt weergegeven, selecteert u de gewenste abonnementen en zorgt u ervoor dat u OK selecteert.

Een lokale werkruimte maken

Voor een logic app-project is altijd een werkruimte vereist. Dus voordat u uw logische app kunt maken, moet u een werkruimte maken waarin u uw logische app-project behoudt. U gebruikt deze werkruimte en dit project later om uw logische app vanuit Visual Studio Code te beheren, uit te voeren en te implementeren in uw implementatieomgeving. Het onderliggende project is vergelijkbaar met een Azure Functions-project, ook wel een functie-app-project genoemd.

  1. Maak op uw computer een lege lokale map die u later kunt gebruiken voor de werkruimte en het project.

    In dit voorbeeld wordt een map gemaakt met de naam fabrikam-workflows.

  2. Sluit in Visual Studio Code alle geopende mappen.

  3. Selecteer in het Azure-venster op de werkbalk werkruimte , in het menu Azure Logic Apps , de optie Nieuwe werkruimte voor logische apps maken.

    Schermopname van het deelvenster Azure, de werkbalk Werkruimte, het menu Azure Logic Apps en het geselecteerde item, Een nieuwe werkruimte voor logische apps maken.

    Als Windows Defender Firewall u vraagt om netwerktoegang te verlenen voor Code.exe, wat Visual Studio Code is, en voor func.exe, de Azure Functions Core Tools, selecteert u >.

  4. In het venster Selecteer Map gaat u naar de locatie waar u uw map hebt gemaakt, selecteer de map en kies Selecteren (dubbelklik niet op de map).

    Schermopname van het venster Map selecteren en de nieuwe werkruimte- en projectmap, waarbij de knop Selecteren is geselecteerd.

    Op de werkbalk van Visual Studio Code wordt een prompt weergegeven om uw werkruimte een naam te geven.

  5. Als u een werkruimtenaam wilt opgeven, voert u de naam van de werkruimte in die u wilt gebruiken.

    In dit voorbeeld wordt Fabrikam-Workflows gebruikt.

    Schermopname met de prompt om een werkruimtenaam op te geven.

Maak vervolgens uw logische app-project.

Maak uw Logic App-project aan

Nadat u de vereiste werkruimte hebt gemaakt, volgt u de aanwijzingen om uw project te maken.

  1. Selecteer logische app voor uw projectsjabloon. Voer een projectnaam in die u wilt gebruiken.

    In dit voorbeeld wordt Fabrikam-Workflows gebruikt.

    Schermopname met de prompt om een projectsjabloon te selecteren met de geselecteerde optie voor een logische app.

  2. Voor uw werkstroomsjabloon selecteert u Stateful Workflow of Stateless Workflow op basis van uw scenario. Voer een werkstroomnaam in die u wilt gebruiken.

    In dit voorbeeld selecteert u Stateful Workflow, waarin de werkstroomgeschiedenis, invoer en uitvoer worden opgeslagen en Stateful Workflow wordt gebruikt als de naam.

    Staatloze werkstromen slaan deze gegevens niet op en ondersteunen momenteel alleen acties voor beheerde connectors, maar geen triggers. Hoewel u de mogelijkheid hebt om connectors in Azure in te schakelen voor uw staatloze werkstroom, toont de ontwerper geen triggers voor beheerde connectors die u kunt selecteren.

    Opmerking

    Als u een fout krijgt met de naam azureLogicAppsStandard.createNewProject met het foutbericht, Kan niet schrijven naar werkruimte-instellingen omdat azureFunctions.suppressProject geen geregistreerde configuratie is, installeert u de Azure Functions-extensie voor Visual Studio Code opnieuw, hetzij rechtstreeks vanuit Visual Studio Marketplace of vanuit Visual Studio Code.

  3. Kies nu of u uw project wilt openen in het huidige Visual Studio Code-venster of een nieuw venster. Selecteer Openen in huidig venster of Openen in een nieuw venster op basis van uw voorkeur.

    Het deelvenster Explorer wordt geopend om uw werkruimte, project en het automatisch geopendeworkflow.json bestand weer te geven. Dit bestand bevindt zich in de map Stateful-Workflow en slaat de onderliggende JSON-definitie op voor de werkstroom die u in de ontwerpfunctie bouwt. Zie de projectstructuur Standard logic app voor informatie over uw projectstructuur.

    U krijgt ook een prompt om door Azure gehoste 'gedeelde' connectors met meerdere tenants in te schakelen, bijvoorbeeld:

    Schermopname van het geopende logische app-project met de prompt om door Azure gehoste connectors in te schakelen.

  4. Als u alle beheerde 'gedeelde' connectors wilt inschakelen die worden uitgevoerd in multitenant Azure, zodat u deze in uw werkstroom kunt bekijken en gebruiken, selecteert u Connectors gebruiken in Azure.

    Opmerking

    Als u deze optie niet selecteert en u later probeert een beheerde connectorbewerking toe te voegen wanneer u uw werkstroom maakt, kunt u niet doorgaan omdat in het bewerkingsinformatievenster een draaiende cirkel wordt weergegeven die niet stopt.

  5. Selecteer Voor de Azure-resourcegroep de optie Nieuwe resourcegroep maken. Voer de naam van de resourcegroep in die u wilt gebruiken.

    In dit voorbeeld wordt Fabrikam-Workflows-RG gebruikt.

  6. Selecteer voor het abonnement het Azure-abonnement dat u wilt gebruiken met uw logische app-project.

  7. Selecteer de Azure-regio voor de locatie waar u uw groep en resources wilt maken.

    In dit voorbeeld wordt West Central US gebruikt.

  8. Zie de volgende scenario's en gerelateerde taken als uw project andere instellingen nodig heeft voor ontwikkeling of ondersteuning nodig heeft voor het bouwen van uw werkstroom:

    Scenariobeschrijving Opdracht
    Op webhook gebaseerde triggers of acties lokaal uitvoeren. Doorsturen instellen voor webhook callback-URL's.
    Statusloze uitvoeringsgeschiedenis van werkstroom instellen. Schakel de uitvoerhistorie in voor stateloze werkstromen.
    Artefacten en afhankelijkheden toevoegen, zoals kaarten, schema's en assembly's. Artefacten en afhankelijkheden toevoegen.
    Werken met een op NuGet gebaseerd (.NET)-project Converteer een op extensies gebaseerd bundelproject (Node.js) naar een NuGet-project op basis van een pakket (.NET).

    Opmerking: Als u een uitbreidingsbundelproject (Node.js) wilt converteren dat u hebt gemaakt voordat assembly-ondersteuning bestond, raadpleegt u ook NuGet-pakketgebaseerde projecten migreren om gebruik te maken van assembly's in de lib-map.
    Maak je eigen ingebouwde verbindingselementen. 1. Converteer een uitbreidingsbundelproject (Node.js) naar een NuGet-project op basis van pakketten (.NET).

    2. Ingebouwde connectorcreatie inschakelen.

Open nu de werkstroomontwerper.

De werkstroomontwerper openen

Nadat het project is geopend in het deelvenster Explorer, opent u de ontwerpfunctie zodat u uw werkstroom kunt bouwen.

Selecteer Open Designer in het snelmenu van het bestand workflow.json.

Schermopname van het deelvenster Explorer, workflow.json snelmenu voor bestanden en Open Designer geselecteerd.

Opmerking

Nadat u deze optie hebt geselecteerd, krijgt u mogelijk het bericht dat het opstarten enkele seconden kan duren vanwege het starten van de API voor het ontwerpen van werkstromen. U kunt dit bericht negeren of OK selecteren.

Visual Studio Code opent de werkstroomontwerper en toont de prompt Een trigger toevoegen , bijvoorbeeld:

Schermopname van de ontwerper met een lege werkstroom.

Opmerking

Als de ontwerpfunctie niet wordt geopend, raadpleegt u de sectie probleemoplossing, kan Designer niet worden geopend.

Voeg vervolgens een trigger en acties toe om uw werkstroom te maken.

Een trigger en een actie toevoegen

Als u uw werkstroom wilt maken, start u uw werkstroom met een trigger en voegt u vervolgens eerst één actie toe. Op die manier kunt u uw werkstroom testen voordat u de volgende actie toevoegt. De voorbeeldwerkstroom maakt gebruik van de volgende trigger en acties, gezamenlijk bekend als bewerkingen:

Connector of bewerkingsgroep Operatienaam Het type bewerking Beschrijving
Verzoek Wanneer een HTTP-aanvraag wordt ontvangen Trigger (ingebouwd) Hiermee maakt u een eindpunt-URL in de werkstroom voor het ontvangen van binnenkomende oproepen of aanvragen van andere services of werkstromen voor logische apps.

Zie Ontvangen en reageren op inkomende HTTPs-aanroepen naar werkstromen voor meer informatie.
Office 365 Outlook Een e-mailbericht te verzenden Actie (beheerd) Een e-mailbericht verzenden met een Office 365 Outlook-account. Als u de stappen in deze handleiding wilt volgen, hebt u een Office 365 Outlook-e-mailaccount nodig. Zie Verbinding maken met Office 365 Outlook vanuit Azure Logic Apps voor meer informatie.

Opmerking: Als u een e-mailaccount hebt dat wordt ondersteund door een andere connector, kunt u die connector gebruiken, maar de gebruikerservaring van die connector verschilt van de stappen in dit voorbeeld.
Verzoek antwoord Actie (ingebouwd) Stuur een antwoord en retourneer gegevens terug naar de beller.

Zie Een antwoordactie toevoegen voor meer informatie.

De aanvraagtrigger toevoegen

  1. Selecteer een trigger toevoegen in de werkstroomontwerper als deze nog niet is geselecteerd.

    Het deelvenster Een trigger toevoegen wordt geopend en toont een galerie waarin u kunt selecteren uit beschikbare connectors en bewerkingsgroepen, bijvoorbeeld:

    Schermopname van de werkstroomontwerper, de geselecteerde prompt met de naam Een trigger toevoegen en de galerie voor connectors en bewerkingsgroepen met triggers.

  2. Volg deze algemene stappen in het deelvenster Een trigger toevoegenom de aanvraagtrigger toe te voegen met de naam Wanneer een HTTP-aanvraag wordt ontvangen.

    In het volgende voorbeeld wordt de ingebouwde optie geselecteerd, zodat alleen de ingebouwde triggers worden weergegeven:

    Schermopname van werkstroomontwerper, deelvenster Trigger toevoegen en geselecteerde trigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen.

    Wanneer de trigger in de ontwerper verschijnt, wordt het deelvenster met triggerinformatie geopend en worden de parameters, instellingen en andere gerelateerde taken van de trigger getoond.

    Schermopname van het informatievenster voor de trigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen.

    Opmerking

    Als het deelvenster met triggerinformatie niet wordt weergegeven, controleert u of de trigger is geselecteerd in de ontwerpfunctie.

  3. Sla uw werkstroom op. Selecteer in de werkbalk van de ontwerper Opslaan.

De actie Office 365 Outlook toevoegen

  1. Volg deze algemene stappen in de ontwerpfunctie onder de aanvraagtrigger om de Office 365 Outlook-actie met de naam Een e-mail verzenden (V2) toe te voegen.

    Als de actie niet wordt weergegeven in de eerste resultaten, selecteert u naast de naam van de connector Meer weergeven, bijvoorbeeld:

    Schermopname van de werkstroomontwerper en een actiedeelvenster met zoekresultaten voor acties toevoegen en de optie Meer opties weergeven geselecteerd.

  2. Wanneer het verificatievenster van de actie wordt weergegeven, selecteert u Aanmelden om een verbinding met uw e-mailaccount te maken.

    Schermopname van acties met de naam Een e-mail verzenden (V2) met de geselecteerde aanmeldingsknop.

  3. Volg de volgende stappen om uw inloggegevens te verifiëren, toegang toe te staan, en terug te keren naar Visual Studio Code.

    Opmerking

    Als er te veel tijd is verstreken voordat u de prompts voltooit, treedt er een time-out op en mislukt het verificatieproces. In dit geval keert u terug naar de ontwerper en probeert u opnieuw in te loggen om de verbinding tot stand te brengen.

    1. Wanneer de Microsoft-verificatieprompt wordt weergegeven, selecteert u uw gebruikersaccount voor Office 365 Outlook. Op de bevestigingspagina die wordt geopend, selecteer Toegang toestaan.

    2. Wanneer Azure Logic Apps vraagt om een Visual Studio Code-koppeling te openen, selecteert u Openen.

      Schermopname met de prompt om de koppeling voor Visual Studio Code te openen.

    3. Wanneer Visual Studio Code u vraagt om de extensie te gebruiken om de Microsoft Azure Tools te openen, selecteert u Openen.

      Schermopname met de prompt om de extensie te openen voor het openen van Microsoft Azure-hulpprogramma's.

    Nadat Visual Studio Code uw verbinding heeft gemaakt, geven sommige connectors het bericht weer dat de verbinding alleen n< dagen geldig >is. Deze tijdslimiet geldt alleen voor de duur terwijl u uw werkstroom voor logische apps in Visual Studio Code ontwerpt. Na de implementatie is deze limiet niet meer van toepassing omdat uw werkstroom 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 verbindingsreeks die u gebruikt wanneer u een verbinding maakt. Als u deze door het systeem toegewezen beheerde identiteit uitschakelt, werken verbindingen niet tijdens runtime.

  4. Geef in het deelvenster Een e-mailinformatie verzenden dat wordt geopend op het tabblad Parameters de vereiste informatie voor de actie op.

    Opmerking

    Als het actie-informatievenster niet automatisch is geopend, selecteert u de actie Een e-mail verzenden in de ontwerper.

    Vastgoed Verplicht Waarde Beschrijving
    Van tot Ja < uw-e-mailadres> De e-mailontvanger, die uw e-mailadres kan zijn voor testdoeleinden. In dit voorbeeld wordt gebruikgemaakt van de fictieve e-mail. sophia.owen@fabrikam.com
    Onderwerp Ja Een e-mailbericht uit uw voorbeeldwerkstroom Het e-mailonderwerp
    Lichaam Ja Hallo vanuit uw voorbeeldwerkstroom. De inhoud van de hoofdtekst van het e-mailbericht

    Voorbeeld:

    Schermopname met informatie over de office 365 Outlook-actie met de naam Een e-mailbericht verzenden.

  5. Sla uw werkstroom op. Selecteer Opslaan in de ontwerpfunctie.

Standaardstructuur voor logische apps

In Visual Studio Code heeft uw logische app-project een van de volgende typen:

  • Uitbreidingsbundel (Node.js), het standaardtype
  • NuGet-pakketgebaseerd (.NET), dat u kunt converteren van het standaardtype

Op basis van deze typen kan uw project enigszins verschillende mappen of bestanden bevatten. Een Nuget-pakketproject heeft bijvoorbeeld een .bin map die pakketten en andere bibliotheekbestanden bevat. Een op uitbreidingsbundel gebaseerd project bevat deze .bin map niet.

Voor sommige scenario's is een op NuGet-packages gebaseerd project vereist om uw app te laten draaien, bijvoorbeeld wanneer u aangepaste ingebouwde functies wilt ontwikkelen en uitvoeren. Zie Ingebouwde connector-ontwikkeling inschakelen voor meer informatie over het omzetten van uw project naar NuGet.

Het standaardproject op basis van de extensiebundel heeft een map- en bestandsstructuur die vergelijkbaar is met het volgende voorbeeld:

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

Op het hoofdniveau van uw project vindt u de volgende mappen en bestanden, samen met andere items:

Naam Map of bestand Beschrijving
.vscode Map Bevat bestanden met betrekking tot Visual Studio Code-instellingen, zoals extensions.json, launch.json, settings.json en tasks.json bestanden.
Artefacten Map Bevat integratieaccountartefacten die u definieert en gebruikt in werkstromen die B2B (business-to-business) scenario's ondersteunen.

De voorbeeldstructuur bevat bijvoorbeeld de volgende mappen:

- Kaarten: bevat kaarten voor gebruik bij XML-transformatiebewerkingen.

- Schema's: bevat schema's die moeten worden gebruikt voor XML-validatiebewerkingen.

- Regels: Artifacten voor bedrijfsregels in regelgebaseerde engineprojecten.
Lib Map Bevat ondersteunde assembly's die door uw logische app kunnen worden gebruikt of waarnaar kan worden verwezen. U kunt deze assembly's uploaden naar uw project in Visual Studio Code, maar u moet ze toevoegen aan specifieke mappen in uw project.

Deze map bevat bijvoorbeeld de volgende mappen:

- builtinOperationSdks: bevat respectievelijk de JAR - en net472-mappen voor Java- en .NET Framework-assembly's.

- aangepast: bevat aangepaste .NET Framework-assembly's.

Zie Assembly's toevoegen aan uw project voor meer informatie over ondersteunde assemblytypen en waar u ze in uw project kunt plaatsen.
< WorkflowName> Map Voor elke werkstroom bevat de <map WorkflowName> een workflow.json-bestand , dat de onderliggende JSON-definitie van die werkstroom bevat.
workflow-designtime Map Bevat bestanden met betrekking tot de ontwikkelomgeving.
.funcignore Bestand Bevat informatie met betrekking tot uw geïnstalleerde Azure Functions Core Tools.
connections.json Bestand Bevat de metagegevens, eindpunten en sleutels voor beheerde verbindingen en Azure-functies die door uw werkstromen worden gebruikt.

Belangrijk: Als u voor elke omgeving verschillende verbindingen en functies wilt gebruiken, moet u ervoor zorgen dat u dit connections.json bestand parameteriseert en de eindpunten bijwerkt.
host.json Bestand 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 host.json metagegevensbestand de configuratie-instellingen en standaardwaarden die alle werkstromen in dezelfde logische app gebruiken tijdens het uitvoeren, lokaal of in Azure. Zie App-instellingen en hostinstellingen bewerken voor naslaginformatie.

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 een ander 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))

Verwijder de extra momentopnamebestanden uit uw opslagcontainer om deze fout op te lossen.
local.settings.json Bestand Bevat app-instellingen, verbindingsreeksen en andere instellingen die uw werkstromen gebruiken wanneer ze lokaal worden uitgevoerd. 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 deze niet opgenomen in uw implementatie.

In dit bestand worden instellingen en waarden opgeslagen als lokale omgevingsvariabelen die uw lokale ontwikkelhulpprogramma's gebruiken voor de appSettings waarden. U kunt deze omgevingsvariabelen zowel tijdens runtime als 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. Dit bestand bevat ook app-instellingen die uw logische app nodig heeft om correct te werken. Zie App-instellingen en hostinstellingen bewerken voor naslaginformatie.

Andere taken voor het opzetten van ontwikkeling

Nadat u uw project hebt gemaakt, hebt u mogelijk nog andere installatietaken ter ondersteuning van specifieke lokale ontwikkelingsscenario's voor het bouwen, uitvoeren en implementeren van Standaard logische apps met Visual Studio Code. In de volgende secties worden de taken voor deze scenario's beschreven.

Lokaal uitgevoerde webhooks inschakelen

Een webhookbewerking is een werkstroomtrigger of -actie die wacht tot een gebeurtenis plaatsvindt voordat de bewerking kan worden uitgevoerd. De webhookbewerking wacht met name tot een HTTPS-aanvraag afkomstig is van een aanroepservice of werkstroom voordat de bewerking kan worden voortgezet. Webhooks bevatten bijvoorbeeld bewerkingen zoals de aanvraagtrigger en de HTTP + Webhook-trigger .

In het Azure-portaal abonneert de Azure Logic Apps-runtime automatisch de webhook op de aanroepservice of werkstroom. De runtime registreert een callback-URL voor de webhook met de oproepdienst of werkstroom. De webhook wacht vervolgens totdat de beller de aanvraag verzendt met behulp van de callback-URL.

In Visual Studio Code moet u echter enkele installatietaken uitvoeren om webhookbewerkingen correct te laten werken. In dit scenario maakt de callback-URL gebruik van uw localhost-server (http://localhost:7071/...privé), zodat de beller geen aanvraag rechtstreeks via internet naar deze URL kan verzenden.

Voor webhookbewerkingen in lokaal actieve werkstromen moet u een openbare URL instellen waarmee uw localhost-server wordt weergegeven en die oproepen van de beller veilig doorstuurt naar de callback-URL. 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.

Stel doorschakelen in met behulp van ngrok
  1. Ga naar de website van ngrok. Meld u aan voor een nieuw account of meld u aan bij uw account, als u er al een hebt.

  2. Haal uw persoonlijke verificatietoken op, waarmee uw ngrok-client verbinding moet maken en toegang tot uw account moet verifiëren.

    1. Om uw authenticatietokenpagina te vinden, vouwt u uw authenticatie uit in het dashboardmenu van uw account en selecteert u Uw authtoken.

    2. Kopieer het token in het vak Uw verificatietoken naar een veilige locatie.

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

  4. Open uw opdrachtpromptprogramma op uw computer. Blader naar de locatie waar u het ngrok.exe-bestand hebt.

  5. Verbind de ngrok-client met uw ngrok-account door de volgende opdracht uit te voeren:

    ngrok authtoken <your-authentication-token>

    Zie stap 2 voor meer informatie: Uw account verbinden.

  6. Open de HTTP-tunnel naar localhost-poort 7071 door de volgende opdracht uit te voeren:

    ngrok http 7071

    Zie Stap 3: Start het op voor meer informatie.

  7. Zoek in de uitvoer de volgende regel:

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

  8. Kopieer en sla de URL met deze indeling op: http://<domain>.ngrok.io

De doorstuur-URL instellen in uw app-instellingen
  1. Voeg in Visual Studio Code in de ontwerpfunctie de webhookbewerking toe die u in uw werkstroom wilt gebruiken.

    In dit voorbeeld wordt de HTTP + Webhook-trigger voortgezet.

  2. Wanneer de prompt wordt weergegeven voor de locatie van het hosteindpunt, voert u de doorstuur-URL (omleiding) in die u eerder hebt gemaakt.

    Opmerking

    Als u de prompt negeert, wordt er een waarschuwing weergegeven dat u de doorstuur-URL moet opgeven, dus selecteer Configureren en voer de URL in. Nadat u deze stap hebt voltooid, wordt de prompt niet weergegeven voor volgende webhookbewerkingen die u mogelijk toevoegt.

    Als u de prompt wilt weergeven, opent u op het hoofdniveau van uw project het snelmenu van het local.settings.json bestand 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 local.settings.json-bestand in de hoofdmap van uw project. In het Values object wordt de eigenschap met de naam Workflows.WebhookRedirectHostUri nu weergegeven en is deze ingesteld op de doorstuur-URL, bijvoorbeeld:

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

    Zie voor meer informatie over deze app-instellingen App-instellingen en hostinstellingen bewerken voor Standaard logische apps.

De eerste keer dat u een lokale foutopsporingssessie start of de werkstroom uitvoert zonder foutopsporing, registreert de Azure Logic Apps-runtime de werkstroom bij de aanroeper en abonneert u zich op het aanroeper-eindpunt dat webhookbewerkingen op de hoogte stelt. De volgende keer dat uw werkstroom wordt uitgevoerd, wordt de runtime niet geregistreerd of opnieuw ingeschreven omdat de abonnementsregistratie al bestaat in de lokale opslag.

Wanneer u de foutopsporingssessie stopt voor een werkstroom die gebruikmaakt van lokaal uitgevoerde webhookbewerkingen, worden de bestaande abonnementsregistraties niet verwijderd. Als u de registratie ongedaan wilt maken, moet u de abonnementsregistraties handmatig verwijderen of verwijderen.

Opmerking

Nadat de werkstroom wordt uitgevoerd, kan in het terminalvenster fouten worden 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.'

Open in dit geval het local.settings.json bestand in de hoofdmap van uw project en zorg ervoor dat de eigenschap is ingesteld trueop:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Uitvoeringsgeschiedenis inschakelen voor staatloze 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 of als u in Azure Portal werkt, zie Werkstromen met één tenant maken in Azure Portal.

  1. Open in uw Visual Studio Code-project op het niveau van de hoofdmap het local.settings.json-bestand .

  2. Voeg de eigenschap toe en stel de Workflows.<workflow-name>.operationOptions waarde in op WithStatelessRunHistory, bijvoorbeeld:

    Ramen

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
       }
    }
    

    macOS of Linux

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
              AccountKey=<access-key>;EndpointSuffix=core.windows.net",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet",
          "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
       }
    }
    
  3. Open in de projectmap met de naam workflow-designtime het local.settings.json-bestand en breng dezelfde wijziging aan.

  4. Als u de uitvoeringsgeschiedenis wilt uitschakelen wanneer u klaar bent, stelt u de Workflows.<workflow-name>.OperationOptions eigenschap Nonein op of verwijdert u de eigenschap en de bijbehorende waarde.

Artefacten en afhankelijkheden toevoegen aan uw project

In specifieke scenario's kan uw werkstroom bewerkingen bevatten waarvoor afhankelijkheden zijn vereist, zoals assemblies, of artefacten zoals kaarten, schema's of regels. In Visual Studio Code kunt u deze items toevoegen aan de bijbehorende mappen in uw project, bijvoorbeeld:

Onderdeel Bestandstype Beschrijving
Kaarten .xslt Zie Kaarten toevoegen voor transformaties in werkstromen voor meer informatie.
schemas .xsd Zie Schema's toevoegen voor validatie voor meer informatie.
Reglement .xml Zie Een Azure Logic Apps Rules Engine-project maken voor meer informatie.
Assemblages - , .dll (.NET Framework of .NET 8)

- .jar (Java)
Een resource voor een logische standaard-app kan specifieke soorten assembly's gebruiken of ernaar verwijzen, die u kunt uploaden naar uw project in Visual Studio Code. U moet ze echter toevoegen aan specifieke projectmappen. Zie Referentieassembly's toevoegen voor meer informatie.

Opmerking: Als u een logic app-project op basis van een NuGet-pakket (.NET) hebt voordat de ondersteuning voor assembly's beschikbaar werd, raadpleegt u NuGet-pakketprojecten migreren om assembly's te gebruiken in de lib-map.

Uw project converteren naar NuGet-pakket (.NET)

Visual Studio Code maakt uw logic app-project standaard als een uitbreidingsbundel (Node.js) project. Als u bijvoorbeeld een project nodig hebt dat is gebaseerd op nuGet-pakketten (.NET), om uw eigen ingebouwde connectors te maken, moet u uw standaardproject converteren naar een NuGet-project op basis van pakketten (.NET).

Belangrijk

Deze actie is een bewerking in één richting die u niet ongedaan kunt maken.

  1. Verplaats in het deelvenster Explorer de muisaanwijzer over een leeg gebied onder de mappen en bestanden van uw project, open het snelmenu en selecteer Converteren naar op NuGet gebaseerd logische app-project.

    Schermopname van het Explorer-deelvenster met het snelmenu van het project geopend vanuit een leeg gebied onder het project.

  2. Wanneer de prompt wordt weergegeven, bevestigt u de projectconversie.

NuGet-projecten op basis van pakketten migreren om assembly's te gebruiken in de map 'lib'

Belangrijk

Deze taak is alleen vereist voor op NuGet pakketten gebaseerde logische app-projecten (.NET) die zijn gemaakt voordat ondersteuning voor assembly's beschikbaar werd.

Als u uw logische app-project hebt gemaakt wanneer ondersteuning voor assembly's niet beschikbaar was voor standaardwerkstromen voor logische apps, kunt u de volgende regels toevoegen aan het <bestand project-name.csproj> om te werken met projecten die assembly's gebruiken:

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

Belangrijk

Voor een project dat op Linux of macOS wordt uitgevoerd, zorg ervoor dat u het mapscheidingsteken bijwerkt. Bekijk bijvoorbeeld de volgende afbeelding met de vorige code die is toegevoegd aan het < bestand project-name.csproj>:

Schermopname van gemigreerde assembly's en toegevoegde code in het CSPROJ-bestand.

Ontwerp van ingebouwde connector 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. Net als bij 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. Voer de volgende stappen uit om deze connectors te maken:

  1. Als u dat nog niet hebt gedaan, converteert u uw extensiebundelproject (Node.js) naar een NuGet-project op basis van pakketten (.NET).

  2. Volg de stappen in het artikel Azure Logic Apps Running Anywhere - Extensibiliteit van ingebouwde connectoren.

Werkstromen lokaal uitvoeren, fouten opsporen en testen

In de volgende secties ziet u hoe u onderbrekingspunten kunt instellen en een foutopsporingssessie kunt starten om uw werkstroom lokaal uit te voeren en te testen.

Onderbrekingspunten instellen voor foutopsporing

Voordat u de werkstroom van uw logische app uitvoert en test door een foutopsporingssessie te starten, kunt u onderbrekingspunten instellen in het workflow.json-bestand voor elke werkstroom. Er is geen andere installatie vereist.

Onderbrekingspunten worden momenteel alleen ondersteund voor acties, niet voor triggers. Elke actiedefinitie heeft deze onderbrekingspuntlocaties:

  • Stel het beginonderpunt in op de regel waarin de naam van de actie wordt weergegeven. Wanneer dit onderbrekingspunt wordt bereikt tijdens de foutopsporingssessie, kunt u de invoergegevens van de actie controleren voordat ze worden geëvalueerd.

  • Stel het eindpunt in op de regel waar de sluitaccolade (}) van de actie verschijnt. Wanneer dit onderbrekingspunt wordt bereikt tijdens de foutopsporingssessie, kunt u de resultaten van de actie controleren voordat de actie is uitgevoerd.

Voer de volgende stappen uit om een onderbrekingspunt toe te voegen:

  1. Open het workflow.json-bestand voor de werkstroom die u wilt opsporen.

  2. Selecteer op de regel waar u het onderbrekingspunt wilt instellen, binnen de linkerkolom. 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.

    Opmerking

    Als de weergave Uitvoeren niet automatisch wordt weergegeven, drukt u op Ctrl+Shift+D.

  3. Als u de beschikbare informatie wilt bekijken wanneer een onderbrekingspunt wordt bereikt, bekijkt u in de weergave Uitvoeren het deelvenster Variabelen .

  4. Als u wilt doorgaan met de uitvoering van de werkstroom, selecteert u Doorgaan (afspeelknop) op de werkbalk Debuggen.

U kunt op elk gewenst moment onderbrekingspunten toevoegen en verwijderen tijdens de uitvoering van de werkstroom. Als u het workflow.json bestand echter 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.

Fouten opsporen en uw werkstroom testen

Volg deze stappen om een foutopsporingssessie uit te voeren en de URL te vinden voor het eindpunt dat door de aanvraagtrigger is gemaakt, om uw werkstroom te testen. U hebt deze URL nodig, zodat u later een aanvraag naar dat eindpunt kunt verzenden.

  1. Als u een staatloze werkstroom hebt, schakelt u de uitvoeringsgeschiedenis voor de werkstroom in om foutopsporing eenvoudiger te maken.

  2. Selecteer in het Uitvoeren menu Debuggen starten (F5).

    Het terminalvenster wordt geopend, zodat u de foutopsporingssessie kunt bekijken.

    Opmerking

    Als u de fout 'Fout optreedt na het uitvoeren van preLaunchTask 'generateDebugSymbols' tegenkomt, raadpleeg de sectie probleemoplossing, Debuggingsessie kan niet worden gestart.

  3. Zoek nu de callback-URL voor het eindpunt dat is gemaakt door de aanvraagtrigger.

    1. Open het deelvenster Explorer opnieuw om uw project weer te geven.

    2. In het snelmenu van het bestand workflow.json, selecteer Overzicht.

      Schermopname van het deelvenster Explorer, workflow.json snelmenu met de geselecteerde optie Overzicht.

    3. Kopieer en sla de Callback-URL op, die lijkt op de volgende URL voor de trigger Wanneer een HTTP-aanvraag wordt ontvangen in dit voorbeeld:

      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>

      Schermopname van de overzichtspagina van de werkstroom met de callback-URL.

  4. Als u de callback-URL wilt testen en de werkstroom wilt activeren, verzendt u een HTTP-aanvraag naar de URL, inclusief de methode die de trigger verwacht, met behulp van uw HTTP-aanvraagprogramma en de bijbehorende instructies.

    In dit voorbeeld wordt de GET-methode gebruikt met de gekopieerde URL, die eruitziet als in het volgende voorbeeld:

    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>

    Wanneer de trigger wordt geactiveerd, wordt de voorbeeldwerkstroom uitgevoerd en wordt er een e-mailbericht verzonden dat lijkt op dit voorbeeld:

    Schermopname van Outlook-e-mail zoals beschreven in het voorbeeld.

  5. Ga in Visual Studio Code terug naar de overzichtspagina van uw werkstroom. Controleer onder Uitvoeringsgeschiedenis de status van de werkstroomuitvoering.

    Hint

    Als de uitvoeringsstatus niet wordt weergegeven, vernieuwt u de overzichtspagina door Vernieuwen te selecteren. Een uitvoering vindt niet plaats voor een trigger die wordt overgeslagen vanwege niet voldane criteria of het ontbreken van gegevens.

    Schermopname van de overzichtspagina van de werkstroom met de uitvoeringsstatus en geschiedenis.

    In de volgende tabel ziet u de mogelijke uiteindelijke statussen die elke werkstroomuitvoering kan hebben en weergeven in Visual Studio Code:

    Uitvoeringsstatus Beschrijving
    afgebroken De uitvoering is gestopt of niet voltooid vanwege externe problemen, bijvoorbeeld een systeemstoring of een verlopen Azure-abonnement.
    geannuleerde De run is geactiveerd en gestart, maar heeft een verzoek tot annulering ontvangen.
    mislukte Ten minste één actie in de uitvoering is mislukt. Er zijn geen volgende acties in de werkstroom ingesteld om de fout af te handelen.
    Bezig met De uitvoering is gestart en is bezig, maar deze status kan ook optreden voor een uitvoering die wordt beperkt door actielimieten of het huidige prijspakket.

    Tip: Als u diagnostische logboekregistratie instelt, kunt u informatie krijgen over eventuele vertragingsevenementen die plaatsvinden.
    geslaagde De run is geslaagd. Als een actie is mislukt, heeft een volgende actie in de werkstroom die fout verwerkt.
    Time-out verlopen Er is een time-out opgetreden voor de uitvoering omdat de huidige duur de limiet voor de uitvoeringsduur heeft overschreden. Dit wordt bepaald door de instelling met de naam Retentie van uitvoeringsgeschiedenis in dagen. De duur van een uitvoering wordt berekend met behulp van de begintijd van de uitvoering en de uitvoeringsduurlimiet op die begintijd.

    Opmerking: Als de duur van de uitvoering ook de huidige bewaarlimiet voor de uitvoeringsgeschiedenis overschrijdt, die ook wordt beheerd door de instelling voor het bewaren van de uitvoeringsgeschiedenis in dagen, wordt de uitvoering gewist vanuit de uitvoeringsgeschiedenis door een dagelijkse opschoontaak. Of de uitvoering nu een time-out heeft of voltooid is, de retentieperiode wordt altijd berekend met behulp van de begintijd van de uitvoering en de huidige bewaarlimiet. Dus als u de duur voor een in-flight-uitvoering verlaagt, treedt er een time-out op voor de uitvoering. De uitvoering blijft echter behouden of wordt gewist uit de uitvoeringsgeschiedenis op basis van of de duur van de uitvoering de bewaarlimiet heeft overschreden.

    Wachtend De uitvoering is niet gestart of onderbroken, bijvoorbeeld vanwege een eerdere werkstroominstantie die nog steeds wordt uitgevoerd.
  6. Als u de status, invoer en uitvoer van elke stap voor een specifieke werkstroomuitvoering wilt bekijken, kiest u een van de volgende stappen:

    • Selecteer in de kolom Identifier de ID van de werkstroomuitvoering.

    • Open het menu met puntjes (...) naast de kolom Duur van een werkstroomuitvoering en selecteer Run weergeven, bijvoorbeeld:

      Schermopname toont de rij uitvoeringsgeschiedenis van de werkstroom met de knop met weglatingstekens geselecteerd en 'Run weergeven'.

    Visual Studio Code opent de weergave met uitvoeringsdetails en toont de status voor elke stap in de uitvoering van de werkstroom.

    Schermopname van elke stap in de uitvoering van de werkstroom en de bijbehorende status.

    Opmerking

    Als een uitvoering is mislukt en een stap in de uitvoeringsdetailsweergave de fout 400 Ongeldige aanvraag weergeeft, 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
    afgebroken De actie is gestopt of niet voltooid vanwege externe problemen, bijvoorbeeld een systeemstoring of een verlopen Azure-abonnement.
    geannuleerde De actie was bezig, maar ontving een verzoek om te annuleren.
    mislukte De actie is mislukt.
    Bezig met 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 is voltooid voordat de huidige actie kan worden uitgevoerd.
    geslaagde 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 uitvoeringsgeschiedenisgegevens, zodat u de invoer en uitvoer kunt bekijken.
    Time-out verlopen De actie is gestopt vanwege de time-outlimiet die is opgegeven door de instellingen van die actie.
    Wachtend Is van toepassing op een webhookactie die wacht op een binnenkomende aanvraag van een beller.
  7. Als u de invoer en uitvoer voor elke stap wilt weergeven, selecteert u de gewenste stap, bijvoorbeeld:

    Schermopname toont de status voor elke stap in de werkstroom plus invoer en uitvoer in een uitgevouwen actie met de naam Een e-mail verzenden.

    Als u de onbewerkte invoer en uitvoer wilt weergeven, selecteert u Onbewerkte invoer weergeven of Onbewerkte uitvoer weergeven.

  8. Als u de foutopsporingssessie wilt stoppen, selecteert u In het menu Uitvoeren de foutopsporing stoppen (Shift + F5).

Een antwoord retourneren

Wanneer u een werkstroom hebt die begint met de trigger Wanneer een HTTP-aanvraag wordt ontvangen , kan uw werkstroom een antwoord retourneren naar de beller die de eerste aanvraag heeft verzonden met behulp van de actie Aanvraag met de naam Antwoord.

  1. Volg in de werkstroomontwerper onder de actie Een e-mail verzendendeze algemene stappen om de actie Aanvraag met de naam Antwoord toe te voegen.

    Schermopname toont de werkstroomontwerper en het paneel Antwoordinformatie.

  2. Geef in het informatievenster van de antwoordactie op het tabblad Parameters de vereiste informatie op voor reactie op de beller.

    In dit voorbeeld wordt de parameterwaarde Body geretourneerd. Dit is de uitvoer van de actie Een e-mail verzenden.

    1. Voor de parameter Hoofdtekst selecteert u in het invoervak en selecteert u het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Deze lijst bevat de beschikbare uitvoerwaarden van de voorgaande trigger en acties in de werkstroom.

    2. Selecteer Hoofdtekst in de lijst met dynamische inhoud onder Een e-mailbericht verzenden.

      Schermopname van de lijst met geopende dynamische inhoud, waar onder Een e-mailkoptekst verzenden de uitvoerwaarde van de hoofdtekst is geselecteerd.

      Wanneer u klaar bent, wordt de eigenschap Hoofdtekst van de antwoordactie nu ingesteld op de uitvoerwaarde Hoofdtekst van een e-mailactie verzenden, bijvoorbeeld:

      Schermopname toont het werkstroomontwerpgedeelte, het deelvenster Antwoordinformatie en de Body-parameter ingesteld op Body-uitvoer van de actie met de naam Een e-mail verzenden.

  3. Sla uw werkstroom op.

Uw werkstroom opnieuw testen

Als u uw updates wilt testen, kunt u het foutopsporingsprogramma opnieuw uitvoeren en een andere aanvraag verzenden die uw werkstroom activeert, vergelijkbaar met de stappen in De werkstromen uitvoeren, fouten opsporen en testen.

  1. Selecteer op de werkbalk van Visual Studio Code in het menu Uitvoeren de foutopsporing starten (F5).

  2. Verzend in uw hulpprogramma voor het maken en verzenden van aanvragen een andere aanvraag om uw werkstroom te activeren.

  3. Controleer op de overzichtspagina van de werkstroom onder Uitvoeringsgeschiedenis de status van de meest recente uitvoering en open de weergave details van de uitvoering.

    Hier ziet u bijvoorbeeld de stapsgewijze status voor een uitvoering nadat de voorbeeldwerkstroom is bijgewerkt met de actie Antwoord .

    Schermopname van de status voor elke stap in de bijgewerkte werkstroom plus invoer en uitvoer in de uitgevouwen antwoordactie.

  4. Als u de foutopsporingssessie wilt stoppen, selecteert u In het menu Uitvoeren de foutopsporing stoppen (Shift + F5).

Implementatie voorbereiden

Raadpleeg deze sectie voor alle voorbereidingen die u mogelijk moet maken voordat u uw logische standaard-app implementeert in Azure Portal.

Firewalltoegang instellen

Als uw omgeving strikte netwerkvereisten of firewalls heeft die het verkeer beperken, moet u machtigingen instellen voor verbindingen die zijn gemaakt door door Azure beheerde, gehoste en gedeelde connectors en die in uw werkstroom worden gebruikt.

Volg deze stappen om de FQDN's (Fully Qualified Domain Names) voor deze verbindingen te vinden:

  1. Open het local.settings.json-bestand in uw logische app-project.

  2. Zoek voor elke verbinding die u hebt gemaakt de eigenschap met de naam <connection-name>-ConnectionRuntimeUrl, die de volgende syntaxis gebruikt:

    "<connection-name>-ConnectionRuntimeUrl": <connection-runtime-URL>

    Stel dat u een voorbeeldbestand hebtlocal.settings.json dat deze verbindingen bevat: een Office 365-verbinding en een AS2-verbinding. Deze verbindingen gebruiken de volgende voorbeeldwaarden voor de <connection-name>-ConnectionRuntimeUrl eigenschappen:

    • Office 365: "office365-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"

    • AS2: "as2-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

    Het voorbeeldbestand local.settings.json ziet er ongeveer als volgt uit:

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "APP_KIND": "workflowapp",
          "ProjectDirectoryPath": "c:\\Users\\<local-username>\\Desktop\\Visual Studio Code projects\\Azure Logic Apps\fabrikam-workflows\\Fabrikam-Workflows\\Fabrikam-Workflows",
          "WORKFLOWS_TENANT_ID": "<Microsoft-Entra-tenant-ID>",
          "WORKFLOWS_SUBSCRIPTION_ID": "<Azure-subscription-ID>",
          "WORKFLOWS_RESOURCE_GROUP_NAME": "Fabrikam-Workflows-RG",
          "WORKFLOWS_LOCATION_NAME": "westcentralus",
          "WORKFLOWS_MANAGEMENT_BASE_URI": "https://management.azure.com/",
          "as2-connectionKey": "<connection-key>",
          "as2-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
          "office365-connectionKey": "<connection-key>",
          "office365-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
       }
    }
    
  3. Kopieer en sla deze verbindingsruntime-URL's ergens veilig op, zodat u uw firewall kunt instellen met deze informatie.

  4. Wanneer u klaar bent, stelt u uw firewall in met behulp van de opgeslagen URL's. Voor meer informatie raadpleegt u de volgende documentatie:

Implementeren in Azure

Als u uw standaard logische app vanuit Visual Studio Code wilt implementeren, kunt u uw project rechtstreeks publiceren naar Azure. U kunt uw logische app publiceren als een nieuwe resource, waarmee automatisch vereiste resources worden gemaakt, zoals een Azure-opslagaccount, vergelijkbaar met de vereisten van de functie-app. U kunt uw logische app ook publiceren naar een standaardbron voor logische apps die al eerder is geïmplementeerd, waarbij de geïmplementeerde versie wordt overschreven.

Voor implementatie van de standaard-logische app-resource is een hostingplan en prijsniveau vereist, die u tijdens de implementatie selecteert. Zie Hostingabonnementen en prijscategorieën voor meer informatie.

Publiceren naar een nieuwe resource voor een standaard logic-app

  1. Verplaats in het deelvenster Explorer de muiswijzer over een leeg gebied onder de mappen en bestanden van uw project, open het snelmenu en selecteer Implementeren in logische app.

    Hoewel u geen bestanden hoeft te hebben geopend om te implementeren, moet u ervoor zorgen dat u alles hebt opgeslagen dat u wilt implementeren.

    Schermopname toont het Explorer-deelvenster, het snelmenu dat is geopend onder het project vanuit een leeg gebied, en de geselecteerde optie voor Implementeren naar Logic App.

    U wordt gevraagd om de volgende opties voor de doelresource van de logische app Standard. U kunt een nieuwe logische standaard-app maken of een bestaande geïmplementeerde logische standaard-app selecteren in Azure:

    • Nieuwe logische app (standaard) maken in Azure (snel)
    • Nieuwe logische app maken (standaard) in Azure Advanced
    • Selecteer een van de eerder geïmplementeerde resources voor logische apps van Standard, indien aanwezig.
  2. Selecteer voor de implementatieopties of u een bestaande logische doel-app-resource wilt maken of gebruiken.

    In dit voorbeeld gaat het verder met het aanmaken van een nieuwe Logic App (Standard) in Azure Advanced.

    Schermopname van de lijst met implementatieopties en de geselecteerde optie voor het maken van een nieuwe standaardresource voor logische apps met aangepaste stappen.

  3. Volg deze stappen om de nieuwe resource voor de logische doel-app te maken:

    1. Voer een wereldwijd unieke naam in voor de bestemmingslogica-app.

      In dit voorbeeld wordt Fabrikam-Workflows-App gebruikt.

      Schermopname met de prompt om een unieke naam in te voeren voor de logische doel-app.

    2. Selecteer de Azure-regio voor de locatie waar u wilt implementeren.

      In dit voorbeeld wordt West Central US gebruikt.

    3. Kies een van de volgende opties voor het hostingabonnement:

      Hostingabonnement Beschrijving
      Werkstroomstandaard Implementeren als een nieuwe resource voor een standaard logische app die wordt gehost in Azure Logic Apps met één tenant.
      Hybride Implementeren als een standaard logische app die wordt gehost op uw eigen infrastructuur.

      Opmerking: Voordat u deze optie selecteert, moet u ervoor zorgen dat u de benodigde infrastructuur hebt ingesteld. Zie Uw eigen infrastructuur instellen voor Standaard logische apps met behulp van hybride implementatie voor meer informatie.
    4. Kies een van de volgende opties voor het Windows App Service-plan:

      • Een nieuw App Service-plan maken
      • Selecteer uit bestaande App Service-plannen in de geselecteerde Azure-regio (alleen windows-abonnementen), indien aanwezig.

      In dit voorbeeld selecteert u Nieuw App Service-plan maken.

    5. Geef voor het nieuwe abonnement een wereldwijd unieke naam op en selecteer een prijscategorie.

      In dit voorbeeld wordt gebruikgemaakt van Fabrikam-Workflows-App-Service-Plan en wordt de WS1 Workflow Standard-laag geselecteerd.

      Zie Hostingabonnementen en prijscategorieën voor meer informatie.

    6. Selecteer voor de azure-doelresourcegroep dezelfde resourcegroep als uw project voor optimale prestaties.

      In dit voorbeeld wordt dezelfde eerder gemaakte groep met de naam Fabrikam-Workflows-RG gebruikt.

      Opmerking

      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.

    7. Als u het Azure-opslagaccount wilt gebruiken met werkstromen waarmee uitvoeringsgeschiedenisgegevens kunnen worden opgeslagen, kiest u uit de volgende opties:

      • Nieuw opslagaccount maken
      • Selecteer een van de bestaande Azure-opslagaccounts, indien van toepassing.

      In dit voorbeeld selecteert u Nieuw opslagaccount maken.

    8. Voer een wereldwijd unieke naam in voor het opslagaccount. U kunt alleen kleine letters en cijfers gebruiken.

      In dit voorbeeld wordt het nummer fabrikamstorageaccount<gebruikt>.

    9. Selecteer Nee voor de optie voor het gebruik van SQL-opslag in dit voorbeeld.

      Als u al een SQL-database hebt ingesteld om te gebruiken voor opslag door SQL Database Storage in te stellen voor werkstromen van standard logische apps, kunt u Ja selecteren.

    10. Voor de Application Insights-resource, waarmee diagnostische logboekregistratie en tracering voor uw logische app mogelijk is, kiest u uit de volgende opties:

      • Nieuwe Application Insights-resource maken
      • Sla nu over. U kunt Application Insights instellen na de implementatie.
      • Selecteer een bestaande Application Insights-resource, indien aanwezig.

      In dit voorbeeld wordt Nu overslaan geselecteerd.

      Opmerking

      • Als u een Application Insights-resource hebt die u wilt gebruiken, kunt u die resource selecteren.

      • Als u op dit moment een nieuwe Application Insights-resource wilt maken, zodat u diagnostische logboekregistratie en tracering kunt inschakelen, raadpleegt u Application Insights inschakelen tijdens de implementatie.

      Raadpleeg de volgende documentatie voor meer informatie over Application Insights:

      Nadat u Nu overslaan of een bestaande Application Insights-resource hebt geselecteerd, wordt in Visual Studio Code een bevestigingsbericht weergegeven om de implementatie te starten. Het bericht raadt ook aan om voor de beste prestaties verbindingsresources te plaatsen voor beheerde bewerkingen in dezelfde resourcegroep als uw logische app-resource en -werkstromen. In Azure Logic Apps bestaan beheerde bewerkingsverbindingen als afzonderlijke Azure-resources.

      Schermopname met bevestigingsbericht met de opties Implementeren en Annuleren.

  4. Wanneer u klaar bent om te implementeren, selecteert u Implementeren in het bevestigingsbericht.

    Visual Studio Code begint met het maken en implementeren van de benodigde resources om uw logische app naar Azure te publiceren.

  5. Als u het implementatieproces wilt weergeven en bewaken, selecteert u Uitvoer in het menu Beeld.

  6. Selecteer in de werkbalk van het Uitvoer-venster de optie Azure Logic Apps (Standard) uit de scopelijst.

    Schermopname van het uitvoervenster en de lijst met bereiken waarin Azure Logic Apps Standard is geselecteerd, samen met de voortgang en status van de implementatie.

    Wanneer Visual Studio Code klaar is met het implementeren van uw logische app in Azure, wordt er een bericht weergegeven dat het maken van een logische app is voltooid, bijvoorbeeld:

    Schermopname toont een bericht dat het maken van een logische app succesvol is voltooid.

    Uw logische app-resource en -werkstroom zijn nu live, ingeschakeld en uitgevoerd in Azure.

Application Insights inschakelen tijdens de implementatie

Voer de volgende stappen uit om logboekregistratie en tracering van diagnostische gegevens in te schakelen met Application Insights tijdens de implementatie voor uw logische app:

  1. Selecteer een bestaande Application Insights-resource of maak een nieuwe Application Insights-resource.

  2. Ga in Azure Portal naar uw Application Insights-resource.

  3. Selecteer Overzicht in het resourcemenu. Zoek en kopieer de waarde van de Instrumentatiesleutel.

  4. Open in Visual Studio Code in de hoofdmap van uw project het local.settings.json bestand.

    1. Voeg in het Values object de APPINSIGHTS_INSTRUMENTATIONKEY eigenschap toe en stel de waarde in op de instrumentatiesleutel, bijvoorbeeld:

      {
         "IsEncrypted": false,
         "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "dotnet",
            "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
         }
      }
      
    2. Controleer of de namen van de werkstroomtrigger en actie correct worden weergegeven in uw Application Insights-exemplaar.

      1. Ga in Azure Portal naar uw Application Insights-resource.

      2. Selecteer toepassingsoverzicht in het resourcemenu onder Onderzoeken.

      3. Controleer de namen van de bewerkingen die worden weergegeven op de kaart.

        Sommige binnenkomende aanvragen van ingebouwde triggers kunnen worden weergegeven als duplicaten in de applicatiekaart. 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.

    3. U kunt eventueel het ernstniveau aanpassen voor de traceringsgegevens die door uw logische app worden verzameld en verzonden naar uw Application Insights-exemplaar.

      Telkens wanneer een werkstroomgebeurtenis 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 activering, actie en uitvoering.
      • Activiteit van opslagaanvraag, zoals geslaagd of mislukt.
      • HTTP-aanvraagactiviteit, zoals inkomend, uitgaand, geslaagd en mislukt.
      • Ontwikkelingssporen, zoals foutopsporingsberichten.

      Elk gebeurtenistype wordt toegewezen aan een ernstniveau. Het Trace niveau legt bijvoorbeeld de meest gedetailleerde berichten vast, terwijl het Information niveau algemene activiteit in jouw werkstroom vastlegt, zoals wanneer jouw logische app, werkstroom, trigger en acties worden gestart en gestopt.

      In de volgende tabel worden de ernstniveaus en de bijbehorende traceringstypen beschreven:

      Ernstniveau Traceringstype
      Kritiek Logboeken waarin een onherstelbare fout in de werkstroom van 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 bij het uitvoeren van werkstromen, maar niet op een algemene fout in uw logische app.
      Informatie Logboeken waarmee de algemene activiteit in uw logische app of werkstroom wordt bijgehouden, bijvoorbeeld:

      - Wanneer een trigger, actie of proces begint en eindigt.
      - Wanneer uw logische app start of eindigt.
      Spoor Logboeken die de meest gedetailleerde berichten bevatten, bijvoorbeeld opslagaanvragen of dispatcheractiviteit, plus alle berichten die betrekking hebben op de activiteit van de werkstroomuitvoering.
      Waarschuwing Logboeken die een abnormale status markeren in uw logische app, maar niet verhinderen dat de app wordt uitgevoerd.

      Als u het ernstniveau wilt instellen, opent u het host.json-bestand op het hoofdniveau van uw project en zoekt u het logging object. Dit object bepaalt het filteren van logboeken voor alle werkstromen in uw logische app en volgt de ASP.NET Core-indeling voor het filteren van logboektypen.

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

      Als het logging object geen object bevat logLevel dat de Host.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"
            }
         }
      }
      

Taken na uitrol

In de volgende secties worden taken beschreven die moeten worden uitgevoerd nadat de implementatie van uw logische app is voltooid.

Implementatie bevestigen in Azure Portal

Nadat u uw logische app vanuit Visual Studio Code hebt geïmplementeerd in Azure Portal, controleert u of uw logische app wordt weergegeven in de portal. Azure-resources worden ingedeeld en gegroepeerd in de portal op basis van hun resourcetype. Voer de volgende stappen uit om logische standaard-apps te vinden:

  1. Meld u met uw Azure-account aan bij Azure Portal.

  2. Voer in het zoekvak van de Azure-titel de naam van uw logische app in, die moet worden weergegeven als resultaat in de sectie Resources . Selecteer uw Logica-app om de resource te openen.

    Schermopname van het zoekvak van Azure met de naam van de logische app ingevoerd.

  3. Selecteer Werkstromen in het menu van de logische app onder Werkstromen.

  4. Selecteer uw werkstroom op de pagina Werkstromen .

  5. Selecteer Designer in het werkstroommenu onder Extra. Controleer of de werkstroom wordt weergegeven zoals verwacht.

    Schermopname van een logica-app die is geïmplementeerd met Visual Studio Code en de ontwerper met een reeds gemaakte werkstroom.

    U kunt nu wijzigingen aanbrengen in deze werkstroom in Azure Portal.

  6. Zorg ervoor dat u de bewakingservaring voor uw geïmplementeerde logische app inschakelt , zodat u de uitvoeringsgeschiedenis van de werkstroom, invoer, uitvoer en andere gerelateerde informatie kunt bekijken.

Bewakingservaring inschakelen voor geïmplementeerde logische app

Voordat u de uitvoeringsgeschiedenis, invoer, uitvoer en gerelateerde informatie voor een geïmplementeerde standaard logische app-resource met de monitoringervaring in de Azure Portal kunt bekijken, moet u eerst die ervaring voor de logische app-resource inschakelen.

  1. Open in de Azure portal de geïmplementeerde resource van de standaard logische app.

  2. Selecteer CORS in het resourcemenu onder API.

  3. Voeg in het deelvenster CORS onder Toegestane oorsprong het jokerteken (*) toe.

  4. Wanneer u klaar bent, selecteert u Opslaan op de CORS-werkbalk.

    Schermopname van de Azure-portal met geïmplementeerde Standard logische app resource. Op het resourcemenu wordt CORS geselecteerd met een nieuwe vermelding voor toegestane origins ingesteld op het jokerteken *.

Application Insights inschakelen of openen na implementatie

Tijdens de uitvoering van de werkstroom verzendt de werkstroom van 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 Azure Logic Apps-runtime werkt. Application Insights biedt u de mogelijkheid om diagnostische logboekregistratie, tracering en bewaking in te schakelen voor uw logische app met behulp van bijna realtime telemetrie (live metrische gegevens). Met deze mogelijkheid kunt u fouten en prestatieproblemen gemakkelijker onderzoeken wanneer u de telemetriegegevens gebruikt om problemen te diagnosticeren, waarschuwingen in te stellen en grafieken te maken.

  • Als u Application Insights nog niet eerder hebt ingesteld, kunt u deze mogelijkheid inschakelen in Azure Portal na de implementatie van logische apps vanuit Visual Studio Code. U moet een Application Insights-resource in Azure hebben, maar u kunt deze resource afzonderlijk van tevoren maken of wanneer u deze mogelijkheid inschakelt na de implementatie.

  • Als u Application Insights eerder hebt ingesteld tijdens de implementatie vanuit Visual Studio Code, kunt u gewoon uw Application Insights-resource openen vanuit uw logische app in Azure Portal.

Application Insights inschakelen voor een geïmplementeerde logische app

  1. Zoek en open uw geïmplementeerde logische app in Azure Portal.

  2. Selecteer Application Insights in het menu van de logische app onder Bewaking.

  3. Op de pagina Application Insights, selecteer Application Insights inschakelen.

  4. Nadat de Application Insights-pagina is bijgewerkt, selecteert u in de sectie Resource wijzigen de volgende opties:

    • Nieuwe resource maken

      Azure maakt resources voor Application Insights en een Log Analytics-werkruimte met behulp van het huidige abonnement en de resourcegroep. Als u een ander abonnement en een andere resourcegroep wilt gebruiken, raadpleegt u Een nieuwe Application Insights-resource maken en gaat u terug naar deze pagina.

      Vastgoed Beschrijving
      Nieuwe resourcenaam Accepteer de gegenereerde naam of geef een andere naam op.
      Plaats Selecteer een Azure-regio.
      Log Analytics-werkruimte Selecteer een bestaande werkruimte, indien van toepassing. Anders wordt er een standaardwerkruimte voor u gemaakt. Zie het overzicht van Log Analytics-werkruimten voor meer informatie.
    • Bestaande resource selecteren:

      1. Selecteer het Azure-abonnement voor uw Application Insights-resource.

      2. Selecteer uw Application Insights-resource.

  5. Wanneer u klaar bent, selecteert u Toepassen onderaan de pagina.

Application Insights openen vanuit uw logische app

  1. Zoek en open uw geïmplementeerde logische app in Azure Portal.

  2. Selecteer Application Insights in het menu van de logische app onder Bewaking.

  3. Selecteer op de Application Insights-pagina de koppeling voor uw Application Insights-resource.

Nadat Application Insights is geopend, kunt u verschillende metrische gegevens voor uw logische app bekijken. Lees deze artikelen voor meer informatie:

Fouten en problemen oplossen

Designer kan niet worden geopend

Wanneer u de ontwerper probeert te openen, wordt deze fout weergegeven: "Ontwerptijd van werkstroom kan niet worden gestart". Als u eerder hebt geprobeerd de ontwerpfunctie te openen, maar u het project hebt stopgezet of verwijderd, wordt de extensiebundel mogelijk niet correct gedownload. Volg deze stappen om te controleren of dit de oorzaak is:

  1. Open in Visual Studio Code het venster Uitvoer. Selecteer Uitvoer in het menu Beeld.

  2. Selecteer in de lijst in de titelbalk van het uitvoervenster Azure Logic Apps (Standard), zodat u de uitvoer van de extensie kunt bekijken, bijvoorbeeld:

    Schermopname van het venster Uitvoer met een bereiklijst en Azure Logic Apps (Standard) geselecteerd.

  3. Controleer de uitvoer en controleer of dit foutbericht wordt weergegeven:

    A host error has occurred during startup operation '<operation-ID>'.
    System.Private.CoreLib: The file 'C:\Users\<user-name>\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\<user-name>\AppData\Local\Temp\Functions\ExtensionBundles en probeert u het bestandworkflow.json opnieuw te openen in de ontwerpfunctie.

Nieuwe triggers en acties ontbreken in de ontwerpkiezer voor eerder gemaakte werkstromen

Azure Logic Apps met één tenant ondersteunt ingebouwde acties voor Azure Function Operations, Liquid Operations en XML-bewerkingen, zoals XML-validatie en transformatie-XML. Voor eerder gemaakte logische apps worden deze acties mogelijk niet weergegeven in de ontwerpfunctiekiezer om te selecteren of Visual Studio Code een verouderde versie van de extensiebundel gebruikt. Microsoft.Azure.Functions.ExtensionBundle.Workflows

De Azure Function Operations-connector en acties worden ook niet weergegeven in de ontwerperkiezer, tenzij u Use connectors from Azure 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 apps, kunt u deze inschakelen vanuit uw project in Visual Studio Code. Open het snelmenu workflow.json en selecteer Connectors gebruiken in Azure.

Als u de verouderde bundel wilt herstellen, volgt u deze stappen om de verouderde bundel te verwijderen, waardoor Visual Studio Code de extensiebundel automatisch bijwerkt naar de nieuwste versie.

Opmerking

Deze oplossing is alleen van toepassing op logische apps die u maakt en implementeert met behulp van Visual Studio Code met de Azure Logic Apps-extensie (Standard), niet op de logische apps die u maakt met behulp van Azure Portal. Zie Ondersteunde triggers en acties ontbreken in de ontwerpfunctie in Azure Portal.

  1. Sla werk op dat u niet wilt verliezen en sluit Visual Studio Code.

  2. Blader op uw computer naar de volgende map, die versiemappen voor de bestaande bundel bevat:

    ...\Users\<user-name>\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

  3. Verwijder de versiemap voor de eerdere bundel, bijvoorbeeld als u een map voor versie 1.1.3 hebt, verwijder die map.

  4. Blader nu naar de volgende map, die versiemappen voor het vereiste NuGet-pakket bevat:

    ...\Users\<user-name>\.nuget\packages\microsoft.azure.workflows.webjobs.extension

  5. Verwijder de versiemap voor het eerdere pakket.

  6. Open Visual Studio Code, uw project en het workflow.json-bestand opnieuw in de ontwerpfunctie.

De ontbrekende triggers en acties worden nu weergegeven in de ontwerpfunctie.

'400 Ongeldige aanvraag' wordt weergegeven op een trigger of actie

Wanneer een uitvoering mislukt en u de uitvoering in de bewakingsweergave inspecteert, kan deze fout worden weergegeven bij een trigger of actie met een langere naam, waardoor de onderliggende URI (Uniform Resource Identifier) de standaardtekenlimiet overschrijdt.

Als u dit probleem wilt oplossen en de langere URI wilt aanpassen, bewerkt u de UrlSegmentMaxCount en UrlSegmentMaxLength registersleutels op uw computer door deze stappen te volgen. De standaardwaarden van deze sleutel worden beschreven in dit artikel ,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.

  1. Open het venster Uitvoeren op uw computer en voer de regedit-opdracht uit, waarmee de registereditor wordt geopend.

  2. Selecteer Ja in het vak Gebruikersaccountbeheer om uw wijzigingen aan uw computer toe te laten.

  3. Vouw in het linkerdeelvenster onder Computer de knooppunten uit langs het pad, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters en selecteer vervolgens Parameters.

  4. Zoek de UrlSegmentMaxCount en UrlSegmentMaxLength registersleutels in het rechterdeelvenster.

  5. Verhoog deze sleutelwaarden voldoende zodat de URI's de namen kunnen bevatten die u wilt gebruiken. Als deze sleutels niet bestaan, voegt u deze toe aan de map Parameters door de volgende stappen uit te voeren:

    1. Selecteer in het snelmenu Parameters de optie >.

    2. Voer UrlSegmentMaxCount in het invoervak dat wordt weergegeven de naam van de nieuwe sleutel in.

    3. Open het snelmenu van de nieuwe sleutel en selecteer Wijzigen.

    4. Voer in het vak Tekenreeks bewerken dat wordt weergegeven de waarde van de gegevenssleutelwaarde in die u wilt gebruiken in hexadecimale of decimale notatie. In hexadecimaal is bijvoorbeeld 400 gelijk aan 1024 decimaal.

    5. Herhaal deze stappen om de UrlSegmentMaxLength sleutelwaarde toe te voegen.

    Nadat u deze sleutelwaarden hebt verhoogd of toegevoegd, ziet de registereditor eruit zoals in het volgende voorbeeld:

    Schermopname van de register-editor.

  6. Wanneer u klaar bent, start u de computer opnieuw op, zodat de wijzigingen van kracht kunnen worden.

Foutopsporingssessie kan niet worden gestart

Wanneer u probeert een foutopsporingssessie te starten, krijgt u de foutmelding ' Fout bestaat nadat preLaunchTask 'generateDebugSymbols' is uitgevoerd. U kunt dit probleem oplossen door het tasks.json-bestand in uw project te bewerken om het genereren van symbolen over te slaan.

  1. Vouw in uw project de map .vscode** uit en open het bestandtasks.json .

  2. Verwijder in de volgende taak de regel, "dependsOn: "generateDebugSymbols"samen met de komma die de voorgaande regel beëindigt, 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
     }