Delen via


ISE-werkstromen exporteren naar een standaard logische app

Standaardwerkstromen voor logische apps, die worden uitgevoerd in Azure Logic Apps met één tenant, bieden veel nieuwe en verbeterde mogelijkheden. U krijgt bijvoorbeeld rekenisolatie, integratie van virtuele netwerken en privé-eindpunten, samen met het hosten van App Services Environment, lokale ontwikkeling en foutopsporing met Visual Studio Code, lage latentie met staatloze werkstromen en meer.

Als u de voordelen van Standaardwerkstromen wilt, maar uw werkstromen worden uitgevoerd in een ISE (Integration Service Environment), kunt u uw ISE nu vervangen door Azure Logic Apps met één tenant. Deze switch is zinvol voor de meeste scenario's waarvoor sommige ISE-mogelijkheden nodig zijn, zoals isolatie en netwerkintegratie, en kunnen de operationele kosten verlagen.

U kunt nu werkstromen voor logische apps van een ISE exporteren naar een standaard logische app. Met Behulp van Visual Studio Code en de nieuwste Azure Logic Apps-extensie (Standard) exporteert u uw logische apps als stateful werkstromen naar een Standaard-project voor logische apps. Vervolgens kunt u uw werkstromen lokaal bijwerken, testen en fouten opsporen om ze gereed te maken voor opnieuw implementeren. Wanneer u klaar bent, kunt u rechtstreeks vanuit Visual Studio Code of via uw eigen DevOps-proces implementeren.

Notitie

Met de exportfunctie worden uw werkstromen niet gemigreerd. In plaats daarvan worden met dit hulpprogramma artefacten gerepliceerd, zoals werkstroomdefinities, verbindingen, integratieaccountartefacten en andere. Uw bronbronnen voor logische apps, werkstromen, triggergeschiedenis, uitvoeringsgeschiedenis en andere gegevens blijven intact.

U bepaalt het exportproces en uw migratietraject. U kunt uw geëxporteerde werkstromen testen en valideren naar tevredenheid met de doelomgeving. U kiest wanneer u de logische bron-apps wilt uitschakelen of verwijderen.

Dit artikel bevat informatie over het exportproces en laat zien hoe u uw werkstromen voor logische apps vanuit een ISE exporteert naar een lokaal Standaard logische app-project in Visual Studio Code.

Bekende problemen en beperkingen

  • Het exportprogramma exporteert geen infrastructuurgegevens, zoals instellingen voor integratieaccounts.

  • Het exportprogramma kan werkstromen voor logische apps exporteren met triggers met gelijktijdigheidsinstellingen. Azure Logic Apps met één tenant negeert deze instellingen echter.

  • Logische apps moeten zich in dezelfde regio bevinden als u ze wilt exporteren binnen hetzelfde standaard logische app-project.

  • Verbindingsreferenties worden standaard niet gekloond uit werkstromen van logische apps van de bron. Voordat uw werkstromen voor logische apps kunnen worden uitgevoerd, moet u deze verbindingen na het exporteren opnieuw verifiëren.

  • Als een Azure-connector standaard een ingebouwde connectorversie heeft, converteert het exportprogramma de Azure-connector automatisch naar de ingebouwde connector. Er bestaat geen optie om u af te wijzen voor dit gedrag.

  • Als de verbindings-id onjuist is opgemaakt, wordt er een fout gegenereerd. Voordat u uw werkstroom exporteert, moet u ervoor zorgen dat de verbindings-id's voor uw connectors overeenkomen met de volgende indeling:

    subscriptionId/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationServiceEnvironments/{integration-service-environment-name}/managedApis/{managed-api-name}

Exportbare bewerkingstypen

Operation JSON-type
Activator Ingebouwd: Http, HttpWebhook, Recurrence, ( manual aanvraag)

Beheerd: ApiConnection ApiConnectionNotification, ApiConnectionWebhook
Actie Ingebouwd: , , AppendToStringVariable, Compose, DecrementVariable, , Foreach, Http, HttpWebhook, , If, , JavaScriptCodeTerminateScopeSelectResponseSetVariableParseJsonUntilIncrementVariableTableInitializeVariableSwitchJoinAppendToArrayVariableWait

- Beheerd: ApiConnection, ApiConnectionWebhook

Vereisten

  • Een of meer logische apps die u wilt implementeren in hetzelfde abonnement en dezelfde Azure-regio, bijvoorbeeld VS - oost 2.

  • Toegang op abonnementsniveau van Azure Reader tot het abonnement waarin de logische apps momenteel worden geïmplementeerd.

  • Toegang op resourcegroepsniveau van Azure-inzender als de optie Beheerde connectors implementeren is geselecteerd.

  • Bekijk en voldoet aan de vereisten voor het instellen van Visual Studio Code met de Azure Logic Apps-extensie (Standard).

Notitie

Zorg ervoor dat u versie 2.0.16 of hoger installeert voor de Azure Logic Apps-extensie (Standard) voor Visual Studio Code. Voor sommige conversiescenario's is de meest recente werkstroomontwerper vereist, die vanaf deze versie beschikbaar is.

Logische apps groeperen voor export

Met de Azure Logic Apps-extensie (Standard) kunt u meerdere werkstromen voor logische apps die door ISE worden gehost, combineren tot één standaard logische app-project. In Azure Logic Apps met één tenant kan één standaardresource voor logische apps meerdere werkstromen hebben. Met deze aanpak kunt u uw werkstromen vooraf valideren, zodat u geen afhankelijkheden mist wanneer u logische apps selecteert voor export.

Houd rekening met de volgende aanbevelingen wanneer u logische apps selecteert voor export:

ISE-werkstromen exporteren naar een lokaal project

Logische apps selecteren voor export

  1. Meld u in Visual Studio Code aan bij Azure als u dat nog niet hebt gedaan.

  2. Selecteer Azure op de Visual Studio Code-activiteitenbalk om het Azure-venster te openen (Shift + Alt + A).

    Schermopname van de Visual Studio Code-activiteitenbalk met het Azure-pictogram geselecteerd.

  3. Selecteer in het menu Van Azure Logic Apps de optie Logische app exporteren op de werkbalk Werkruimte.

    Schermopname van het Azure-venster, de werkbalk werkruimtesectie en de geselecteerde logische app exporteren.

  4. Nadat het tabblad Exporteren is geopend, selecteert u uw Azure-abonnement en het ISE-exemplaar en selecteert u vervolgens Volgende.

    Schermopname van het tabblad Exporteren met het Azure-abonnement en het ISE-exemplaar geselecteerd.

  5. Selecteer de logische apps die u wilt exporteren. Elke geselecteerde logische app wordt weergegeven in de lijst met geselecteerde logische apps aan de zijkant. Selecteer Volgende als u klaar bent.

    Tip

    U kunt ook zoeken naar logische apps en filteren op resourcegroep.

    Schermopname van de sectie Logische apps selecteren die u wilt exporteren, met logische apps geselecteerd voor export.

    Het exportprogramma begint te valideren of uw geselecteerde logische apps in aanmerking komen voor export.

Exportvalidatieresultaten bekijken

  1. Nadat de exportvalidatie is voltooid, bekijkt u de resultaten door de vermelding voor elke logische app uit te vouwen.

    • Logische apps met fouten kunnen niet worden geëxporteerd. U moet deze logische apps verwijderen uit de exportlijst totdat u ze bij de bron hebt hersteld. Als u een logische app uit de lijst wilt verwijderen, selecteert u Vorige.

      SourceLogicApp2 heeft bijvoorbeeld een fout en kan pas worden geëxporteerd als het probleem is opgelost:

      Schermopname van de sectie Exportstatus controleren en validatiestatus voor de werkstroom van logische apps met een fout.

    • Logische apps die validatie met of zonder waarschuwingen doorgeven, komen nog steeds in aanmerking voor export. Als u wilt doorgaan, selecteert u Exporteren als alle apps zijn gevalideerd of selecteert u Exporteren met waarschuwingen als apps waarschuwingen hebben.

      SourceLogicApp3 heeft bijvoorbeeld een waarschuwing, maar u kunt nog steeds exporteren:

      Schermopname van de sectie Exportstatus controleren en validatiestatus voor de werkstroom van de logische app met waarschuwing.

    De volgende tabel bevat meer informatie over elk validatiepictogram en elke status:

    Validatiepictogram Validatiestatus
    Pictogram Geslaagd Item is gevalideerd, zodat exporteren zonder problemen kan worden opgelost.
    Pictogram Mislukt Validatie van item is mislukt, zodat het exporteren niet kan worden voortgezet.

    De validatievermelding voor het mislukte item wordt automatisch uitgevouwen en bevat informatie over de validatiefout.
    Waarschuwingspictogram Item is gevalideerd met een waarschuwing, maar exporteren kan doorgaan met de vereiste oplossing na het exporteren.

    De validatievermelding voor het item met een waarschuwing wordt automatisch uitgevouwen en bevat informatie over de waarschuwing en het vereiste herstel na de export.
  2. Nadat de sectie Export voltooien wordt weergegeven, bladert u naar de locatie Exporteren en selecteert u een lokale map voor uw nieuwe standaard logische app-project.

    Schermopname van de sectie Export voltooien en de eigenschap Locatie exporteren met de geselecteerde lokale exportprojectmap.

  3. Als uw werkstroom beheerde verbindingen heeft die u wilt implementeren, wat alleen wordt aanbevolen voor niet-productieomgevingen, selecteert u Beheerde verbindingen implementeren, waarin bestaande resourcegroepen in uw Azure-abonnement worden weergegeven. Selecteer de resourcegroep waar u de beheerde verbindingen wilt implementeren.

    Schermopname van de sectie Exporteren voltooien met de geselecteerde lokale exportmap, Beheerde verbindingen implementeren geselecteerd en doelresourcegroep geselecteerd.

  4. Controleer onder Stappen na het exporteren de vereiste stappen na het exporteren, bijvoorbeeld:

    Schermopname van de sectie 'Na exportstappen' en de vereiste stappen na het exporteren, indien van toepassing.

  5. Selecteer op basis van uw scenario Exporteren en voltooien of Exporteren met waarschuwingen en voltooien.

    Het exportprogramma downloadt uw project naar de geselecteerde maplocatie, breidt het project uit in Visual Studio Code en implementeert beheerde verbindingen als u deze optie hebt geselecteerd.

    Schermopname van de sectie Exportstatus met de voortgang van de export.

  6. Nadat dit proces is voltooid, opent Visual Studio Code een nieuwe werkruimte. U kunt nu het exportvenster veilig sluiten.

  7. Open het README.md-bestand vanuit uw standaard logische app-project en bekijk het voor de vereiste stappen na het exporteren.

    Schermopname van een nieuw standaard logische app-project met README.md bestand geopend.

Stappen na export

Herstelstappen

Voor sommige geëxporteerde werkstromen voor logische apps zijn herstelstappen na het exporteren vereist om te worden uitgevoerd op het Standard-platform.

  1. Open vanuit uw standaard logische app-project het README.md-bestand en controleer de herstelstappen voor uw geëxporteerde werkstromen. Het exportprogramma genereert het README.md-bestand, dat alle vereiste stappen na het exporteren bevat.

  2. Voordat u wijzigingen aanbrengt in de werkstroom van de logische bron-app, moet u ervoor zorgen dat u de nieuwe resource en werkstromen van de standaard logische app test.

Acties en instellingen voor integratieaccounts

Als u acties exporteert die afhankelijk zijn van een integratieaccount, moet u uw logische standaard-app handmatig instellen met een verwijzingskoppeling naar het integratieaccount dat de vereiste artefacten bevat. Raadpleeg integratieaccount koppelen aan een standaard logische app voor meer informatie.

Als u een Standard-integratieaccount hebt dat is gemaakt vanuit een ISE, kunt u dat integratieaccount exporteren naar een bestaand Premium-integratieaccount.

Batchacties en -instellingen

Als u acties exporteert die gebruikmaken van Batch-acties met meerdere configuraties die zijn opgeslagen in een integratieaccount, moet u uw Batch-acties handmatig configureren met de juiste waarden na het exporteren. Raadpleeg berichten voor verzenden, ontvangen en batchverwerking in Azure Logic Apps voor meer informatie.

Projectmapstructuur

Nadat het exportproces is voltooid, bevat uw standaard logische app-project nieuwe mappen en bestanden, samen met de meeste andere in een typisch standaard-logische app-project.

In de volgende tabel worden deze nieuwe mappen en bestanden beschreven die zijn toegevoegd door het exportproces:

Map Bestand Beschrijving
.development\deployment LogicAppStandardConnections.parameters.json Azure Resource Manager-sjabloonparametersbestand voor het implementeren van beheerde connectors
LogicAppStandardConnections.template.json Azure Resource Manager-sjabloondefinitie voor het implementeren van beheerde connectors
LogicAppStandardInfrastructure.parameters.json Azure Resource Manager-sjabloonparametersbestand voor het implementeren van een standaardresource voor logische apps
LogicAppStandardInfrastructure.template.json Azure Resource Manager-sjabloondefinitie voor het implementeren van een standaardresource voor logische apps
.logs\export exportReport.json Onbewerkt bestand van rapportsamenvatting exporteren, inclusief alle stappen die nodig zijn voor herstel na export
exportValidation.json Onbewerkt bestand voor validatierapport, inclusief de validatieresultaten voor elke geëxporteerde logische app.
README.md Markdown-bestand met samenvatting van exportresultaten, inclusief de gemaakte logische apps en alle vereiste volgende stappen.

Volgende stappen