Delen via


Quickstart: Integratiewerkstromen maken in multitenant Azure Logic Apps met behulp van Visual Studio Code

Van toepassing op: Azure Logic Apps (verbruik)

Deze quickstart laat zien hoe u werkstromen voor logische apps maakt in multitenant Azure Logic Apps waarmee taken worden geautomatiseerd en processen worden geïntegreerd in services, systemen, apps en gegevens in organisaties en ondernemingen met behulp van Visual Studio Code. U kunt de onderliggende werkstroomdefinities maken en bewerken, die gebruikmaken van JavaScript Object Notation (JSON) voor werkstromen via een op code gebaseerde ervaring. U kunt ook werken aan bestaande werkstromen voor logische apps die al zijn geïmplementeerd in Azure. Zie Single-tenant versus Multitenant in Azure Logic Apps voor meer informatie over het verschil tussen het single-tenant model en het multitenant model.

Hoewel u dezelfde taken in Azure Portal kunt uitvoeren, kunt u sneller aan de slag in Visual Studio Code wanneer u al bekend bent met definities van logische apps en rechtstreeks in code wilt werken. U kunt bijvoorbeeld werkstromen voor logische apps uitschakelen, inschakelen, verwijderen en vernieuwen. Ook kunt u werken met logische apps en integratieaccounts vanaf elk ontwikkelingsplatform waarop Visual Studio Code wordt uitgevoerd, zoals Linux, Windows en Mac.

Voor dit artikel kunt u dezelfde werkstroom voor logische apps maken vanuit deze quickstart, die meer is gericht op de basisconcepten. U kunt ook leren hoe u apps maakt en beheert via de Azure CLI. In Visual Studio Code ziet de werkstroom van de logische app eruit als in het volgende voorbeeld:

Voorbeeld van de werkstroomdefinitie voor logische apps

Vereisten

Zorg ervoor dat u deze items hebt voordat u begint:

Toegang tot Azure vanuit Visual Studio Code

  1. Open Visual Studio Code. Selecteer het Azure-pictogram op de werkbalk van Visual Studio Code.

    Het Azure-pictogram selecteren op de werkbalk van Visual Studio Code

  2. Selecteer in het Azure-venster onder Logic Apps de optie Aanmelden bij Azure. Wanneer hierom wordt gevraagd op de Microsoft-aanmeldpagina, meldt u zich aan met uw Azure-account.

    Selecteer Aanmelden bij Azure

    1. Als aanmelden langer duurt dan gebruikelijk, wordt u door Visual Studio Code gevraagd u aan te melden via een Microsoft-verificatiewebsite door u een apparaatcode te geven. Selecteer Apparaatcode gebruiken als u zich in plaats daarvan met de code wilt aanmelden.

      In plaats daarvan doorgaan met apparaatcode

    2. Selecteer Kopiëren en openen om de code te kopiëren.

      De code kopiëren voor aanmelden bij Azure

    3. Als u een nieuw browservenster wilt openen en door wilt gaan naar de verificatiewebsite, selecteert u Koppeling openen.

      Bevestigen dat u een browser hebt geopend en doorgaan naar de verificatiewebsite

    4. Voer op de pagina Aanmelden bij uw account uw verificatiecode in en selecteer Volgende.

      Verificatiecode invoeren voor aanmelden bij Azure

  3. Selecteer uw Azure-account. Nadat u zich hebt aangemeld, kunt u uw browser sluiten en terugkeren naar Visual Studio Code.

    In het Azure-deelvenster worden nu in de secties Logic Apps en Integratieaccounts de Azure-abonnementen weergegeven die aan uw account zijn gekoppeld. Als u echter niet de verwachte abonnementen ziet, of als er te veel abonnementen in de secties worden weergegeven, volgt u deze stappen:

    1. Beweeg de cursor boven het Logic Apps-label. Wanneer de werkbalk wordt weergegeven, selecteert u Abonnementen selecteren (filterpictogram).

      Azure-abonnementen zoeken of filteren

    2. Selecteer in de lijst die wordt weergegeven de abonnementen die u wilt weergeven.

  4. Selecteer onder Logic Apps het gewenste abonnement. Wanneer het abonnementsknooppunt wordt uitgevouwen, worden alle logische apps die in dat abonnement bestaan weergegeven.

    Selecteer uw Azure-abonnement

    Tip

    Wanneer u onder Integratieaccounts uw abonnement selecteert, worden alle integratieaccounts weergegeven die in dat abonnement bestaan.

Een nieuwe logische app maken

  1. Als u zich nog niet bij uw Azure-account en -abonnement hebt aangemeld vanuit Visual Studio Code, volgt u de vorige stappen om zich nu aan te melden.

  2. Open onder Logic Apps in Visual Studio Code het contextmenu van uw abonnement en selecteer Logische app maken.

    De optie Logische app maken selecteren in het abonnementsmenu

    Er wordt een lijst weergegeven met daarin alle Azure-resourcegroepen in uw abonnement.

  3. Selecteer vanuit de lijst met resourcegroepen de optie Een nieuwe resourcegroep maken of selecteer een bestaande resourcegroep. Maak voor dit voorbeeld een nieuwe resourcegroep.

    Een nieuwe Azure-resourcegroep maken

  4. Geef een naam op voor uw Azure-resourcegroep en druk op Enter.

    Een naam opgeven voor uw Azure-resourcegroep

  5. Selecteer de Azure-regio waarin u de metagegevens van uw logische app wilt opslaan.

    De Azure-locatie selecteren voor het opslaan van metagegevens van een logische app

  6. Geef een naam op voor uw logische app en druk op Enter.

    Een naam voor uw logische app opgeven

    In het Azure-venster, onder uw Azure-abonnement, wordt uw nieuwe en lege werkstroom voor logische apps weergegeven. In Visual Studio Code wordt ook een JSON-bestand (.logicapp.json) geopend, met daarin de basis van een werkstroomdefinitie voor uw logische app. Nu kunt u handmatig beginnen met het schrijven van de werkstroomdefinitie van uw logische app in dit JSON-bestand. Zie het taalschema voor werkstroomdefinities voor Azure Logic Apps voor technisch referentiemateriaal over de structuur en syntaxis voor een werkstroomdefinitie.

    Leeg JSON-bestand voor de werkstroomdefinitie van een logische app

    Hier ziet u bijvoorbeeld een voorbeeld van een werkstroomdefinitie van een logische app. Deze begint met een RSS-trigger en een Office 365 Outlook-actie. Doorgaans worden JSON-elementen alfabetisch weergegeven in elke sectie. In dit voorbeeld ziet u echter dat deze elementen grofweg in de volgorde staan van de stappen van de logische app in het ontwerpprogramma.

    Belangrijk

    Als u deze voorbeeldwerkstroomdefinitie voor logische apps opnieuw wilt gebruiken, hebt u bijvoorbeeld @fabrikam.comeen organisatieaccount nodig. Vergeet niet het fictieve e-mailadres te vervangen door uw eigen e-mailadres. Als u een ander e-mailprogramma wilt gebruiken, zoals Outlook.com of Gmail, vervangt u de Send_an_email_action-actie door een vergelijkbare actie uit een e-mailprogramma dat wordt ondersteund door Azure Logic Apps.

    Als u de Gmail-connector wilt gebruiken, kunnen alleen bedrijfsaccounts van G Suite deze connector zonder beperking in logische apps gebruiken. Als u een Gmail-consumentenaccount hebt, kunt u deze connector alleen gebruiken met specifieke door Google goedgekeurde services, of u kunt een Google-client-app maken voor verificatie bij uw Gmail-connector. Zie Beleid voor gegevensbeveiliging en privacybeleid voor Google-connectors in Azure Logic Apps voor meer informatie.

    {
       "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
          "$connections": {
             "defaultValue": {},
             "type": "Object"
          }
       },
       "triggers": {
          "When_a_feed_item_is_published": {
             "recurrence": {
                "frequency": "Minute",
                "interval": 30
             },
             "splitOn": "@triggerBody()?['value']",
             "type": "ApiConnection",
             "inputs": {
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['rss']['connectionId']"
                   }
                },
                "method": "get",
                "path": "/OnNewFeed",
                "queries": {
                   "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                   "sinceProperty": "PublishDate"
                }
             }
          }
       },
       "actions": {
          "Send_an_email_(V2)": {
             "runAfter": {},
             "type": "ApiConnection",
             "inputs": {
                "body": {
                   "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                   "Subject": "RSS item: @{triggerBody()?['title']}",
                   "To": "sophia-owen@fabrikam.com"
                },
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['office365']['connectionId']"
                   }
                },
                "method": "post",
                "path": "/v2/Mail"
             }
          }
       },
       "outputs": {}
    }
    
  7. Wanneer u klaar bent, slaat u de workflowdefinitie van uw Logic App op. (Bestand-menu > Opslaan, of druk op Ctrl+S)

  8. Wanneer u wordt gevraagd de werkstroomdefinitie van uw logische app te uploaden naar uw Azure-abonnement, selecteert u Uploaden.

    Met deze stap publiceert u de werkstroomdefinitie van uw logische app naar Azure Portal, waardoor de werkstroom live en wordt uitgevoerd in Azure.

    Nieuwe werkstroomdefinitie voor logische apps uploaden naar uw Azure-abonnement

Werkstroomdefinitie voor logische apps weergeven in designer

In Visual Studio Code kunt u de definitie van uw logische app-werkstroom openen in de ontwerpweergave voor alleen-lezen. Hoewel u de werkstroomdefinitie van uw logische app niet kunt bewerken in de ontwerpfunctie, kunt u de werkstroom van uw logische app visueel controleren met behulp van de ontwerpweergave.

Openen in het Azure-venster, onder Logic Apps, het contextmenu van uw logische app en selecteer Openen in Designer.

De ontwerpfunctie in alleen-lezenmodus gaat open in een apart venster en toont bijvoorbeeld de werkstroom van je logica-app.

De werkstroomdefinitie van een logische app weergeven in de alleen-lezen ontwerper

Bekijken in de Azure portal

Volg deze stappen om de werkstroomdefinitie van uw logische app te controleren in Azure Portal:

  1. Meld u aan bij Azure Portal met hetzelfde Azure-account en abonnement dat aan uw logische app is gekoppeld.

  2. Voer in het zoekvak van Azure Portal de naam van de werkstroomdefinitie van de logische app in. Selecteer de logische app in de lijst met resultaten.

    Uw nieuwe werkstroomdefinitie voor logische apps in Azure Portal

Een geïmplementeerde logische app bewerken

In Visual Studio Code kunt u de werkstroomdefinitie openen en bewerken voor een al geïmplementeerde logische app-resource in Azure.

Belangrijk

Voordat u een actieve logic app-werkstroom in productie bewerkt, voorkomt u het risico van storing in die logic app en minimaliseert u de onderbreking door eerst de resource van uw logic app uit te schakelen.

  1. Als u zich nog niet bij uw Azure-account en -abonnement hebt aangemeld vanuit Visual Studio Code, volgt u de vorige stappen om zich nu aan te melden.

  2. Vouw in het Azure-venster onder Logic Apps uw Azure-abonnement uit en selecteer de gewenste logische app-resource.

  3. Open het contextmenu van de logische app en selecteer Openen in Editor. Of selecteer het bewerkingspictogram naast de naam van uw logische app.

    De editor openen voor een bestaande logische app

    In Visual Studio Code wordt het bestand .logicapp.json in uw lokale tijdelijke map geopend zodat u de werkstroomdefinitie van uw logische app kunt bekijken.

    De werkstroomdefinitie voor gepubliceerde logische apps weergeven

  4. Breng uw wijzigingen aan in de werkstroomdefinitie van de logische app.

  5. Sla de wijzigingen op als u klaar bent. (Bestand-menu > Opslaan, of druk op Ctrl+S)

  6. Wanneer u wordt gevraagd om uw wijzigingen te uploaden en uw bestaande logische app in Azure Portal te overschrijven, selecteert u Uploaden.

    Met deze stap publiceert u uw updates voor uw logische app-resource in Azure Portal.

    Bewerkingen uploaden naar een logische app-resource in Azure

Andere versies weergeven of promoveren

In Visual Studio Code kunt u de eerdere versies voor uw logische app openen en controleren. U kunt ook een eerdere versie naar de huidige versie promoveren.

Belangrijk

Voordat u een actieve logische app-werkstroom in productie wijzigt, schakelt u eerst de resource van uw logische app uit om te voorkomen dat u het risico loopt de werkstroom van de logische app te breken en om verstoringen te minimaliseren.

  1. Vouw in het Azure-venster, onder Logic Apps, uw Azure-abonnement uit zodat u alle logische apps in dat abonnement kunt zien.

  2. Vouw onder uw abonnement uw logica-app uit en vouw Versies uit.

    In de lijst Versies ziet u de eerdere versies van uw logische app, als deze bestaan.

    Eerdere versies van uw logische app

  3. Als u een eerdere versie wilt weergeven selecteert u een van deze stappen:

    • Als u de JSON-definitie wilt weergeven, selecteert u onder Versies het versienummer voor die definitie. Of open het contextmenu van die versie en selecteer Openen in Editor.

      Op uw lokale computer wordt een nieuw bestand geopend en u ziet de JSON-definitie van die versie.

    • Als u de versie in de alleen-lezen ontwerperweergave wilt weergeven, opent u het contextmenu van die versie en selecteert u Openen in Designer.

  4. Als u een eerdere versie naar de huidige versie wilt promoveren, volgt u deze stappen:

    1. Onder Versies opent u het contextmenu van de eerdere versie en selecteert u Promoveren.

      Een eerdere versie promoveren

    2. Selecteer Ja nadat u om bevestiging bent gevraagd in Visual Studio Code.

      Bevestig het promoten van een eerdere versie

      Visual Studio Code promoveert de geselecteerde versie naar de huidige versie en wijst een nieuw nummer toe aan de gepromoveerde versie. De vorige huidige versie wordt nu onder de gepromoveerde versie weergegeven.

Logische apps uitschakelen of inschakelen

Als u in Visual Studio Code een gepubliceerde werkstroom voor logische apps bewerkt en uw wijzigingen opslaat, overschrijft u de al geïmplementeerde app. Als u wilt voorkomen dat uw Logic App-werkstroom in productie wordt onderbroken en de verstoring wilt minimaliseren, schakelt u eerst de Logic App-resource uit. U kunt uw logische app vervolgens opnieuw activeren nadat u hebt bevestigd dat uw logische app nog steeds werkt.

  • Azure Logic Apps gaat door met alle actieve uitvoeringen en wachtende uitvoeringen totdat ze zijn voltooid. Op basis van het volume of de achterstand kan dit proces enige tijd in beslag nemen.

  • Azure Logic Apps maakt of voert geen nieuwe workflow-instanties uit.

  • De trigger wordt niet geactiveerd de volgende keer dat aan de voorwaarden wordt voldaan.

  • De triggerstatus onthoudt het punt waarop de logische app is gestopt. Dus als u de logische app opnieuw activeert, wordt de trigger geactiveerd voor alle niet-verwerkte items sinds de laatste uitvoering.

    Om te voorkomen dat de trigger wordt geactiveerd voor niet-verwerkte items sinds de laatste uitvoering, moet u de status van de trigger wissen voordat u de logische app opnieuw activeert.

    1. Bewerk in de Logic-app elk onderdeel van de trigger van de werkstroom.
    2. Sla uw wijzigingen op. Met deze stap wordt de huidige status van uw trigger opnieuw ingesteld.
    3. Uw logische app opnieuw activeren.
  • Wanneer een werkstroom is uitgeschakeld, kunt u nog steeds uitvoeringen opnieuw indienen.

  1. Als u zich nog niet bij uw Azure-account en -abonnement hebt aangemeld vanuit Visual Studio Code, volgt u de vorige stappen om zich nu aan te melden.

  2. Vouw in het Azure-venster, onder Logic Apps, uw Azure-abonnement uit zodat u alle logische apps in dat abonnement kunt zien.

    1. Als u de gewenste logische app wilt uitschakelen, opent u het menu van de logische app en selecteert u Uitschakelen.

      Uw logische app uitschakelen

    2. Wanneer u klaar bent om uw logische app opnieuw te activeren, opent u het menu van de logische app en selecteert u Inschakelen.

      Logic-app inschakelen

Logische apps verwijderen

Het verwijderen van een logic-app is van invloed op workflow-instances op de volgende manieren:

  • Azure Logic Apps doet er alles aan om eventuele actieve en in behandeling zijnde uitvoeringen te annuleren.

    Zelfs met een groot volume of achterstand worden de meeste processen geannuleerd voordat ze beginnen of eindigen. Het kan echter even duren voordat het annuleringsproces is voltooid. Ondertussen kunnen sommige uitvoeringen worden opgehaald voor uitvoering terwijl de service het annuleringsproces doorloopt.

  • Azure Logic Apps maakt of voert geen nieuwe workflow-instanties uit.

  • Als u een werkstroom verwijdert en vervolgens dezelfde werkstroom opnieuw maakt, heeft de opnieuw gemaakte werkstroom niet dezelfde metagegevens als de verwijderde werkstroom. U moet elke werkstroom die de verwijderde werkstroom aanriep, 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.

  1. Als u zich nog niet bij uw Azure-account en -abonnement hebt aangemeld vanuit Visual Studio Code, volgt u de vorige stappen om zich nu aan te melden.

  2. Vouw in het Azure-venster, onder Logic Apps, uw Azure-abonnement uit zodat u alle logische apps in dat abonnement kunt zien.

  3. Zoek de logische app die u wilt verwijderen, open het menu van de logische app en selecteer Verwijderen.

    Je logische app verwijderen

Volgende stappen