Kaarten toevoegen voor transformaties in werkstromen met Azure Logic Apps

2025-04-11

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Werkstroomacties zoals XML transformeren en Liquid vereisen een kaart om hun taken uit te voeren. Voor de XML-transformeren-actie is bijvoorbeeld een toewijzing vereist om XML van het ene formaat naar het andere te converteren. Een map is een XML-document waarin wordt beschreven hoe gegevens worden geconverteerd van XML naar een ander formaat. De inhoud van de toewijzing bevat het XML-bronschema als invoer en een doel-XML-schema als uitvoer. U kunt een eenvoudige transformatie definiëren, zoals het kopiëren van een naam en adres van het ene document naar het andere. U kunt ook complexere transformaties maken met behulp van de out-of-the-box kaartbewerkingen. U kunt gegevens bewerken of beheren met behulp van verschillende ingebouwde functies, zoals tekenreeksbewerkingen, voorwaardelijke toewijzingen, rekenkundige expressies, datum/tijd formatters en zelfs lusconstructies.

Stel dat u regelmatig B2B-orders of facturen ontvangt van een klant die de datumnotatie YearMonthDay (JJJJMMDD) gebruikt. Uw organisatie gebruikt echter de datumnotatie MonthDayYear (MMDDYJJJJ). U kunt een kaart definiëren en gebruiken waarmee de JJJJMMDD-indeling wordt getransformeerd naar de MMDDYJJ-indeling voordat u de order- of factuurgegevens opslaat in de database van uw klantactiviteit.

In deze handleiding ziet u hoe u een kaart toevoegt voor uw werkstroom die u kunt gebruiken. U kunt kaarten toevoegen aan uw gekoppelde integratieaccount of als u een standaard logische app hebt, kunt u kaarten rechtstreeks toevoegen aan de resource van uw logische app.

Vereisten

Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis Azure-account.
De kaart die u wilt uploaden.
- Verbruikswerkstromen ondersteunen de volgende kaarttypen: Liquid, XSLT, XSLT 2.0, XSLT 3.0 of HIDX.
- Standaardwerkstromen ondersteunen de volgende kaarttypen: XSLT, XSLT 2.0 en XSLT 3.0.
- Als u kaarten wilt maken, kunt u een van de volgende hulpprogramma's gebruiken:
  - Visual Studio Code en de Data Mapper-extensie. Als u de kaarten wilt aanroepen die zijn gemaakt met Data Mapper vanuit uw werkstroom, moet u de Data Mapper Operations actie met de naam Transformeren met Data Mapper XSLT gebruiken, niet de XML-bewerkingen actie met de naam XML transformeren. Zie Kaarten maken voor gegevenstransformatie met Visual Studio Code voor meer informatie.
  - Visual Studio 2019 en de Microsoft Azure Logic Apps Enterprise Integration Tools extensie.
    
    Notitie
    
    Installeer de extensie Microsoft Azure Logic Apps Enterprise Integration Tools niet naast de BizTalk Server-extensie. Het hebben van beide extensies kan onverwacht gedrag opleveren. Zorg ervoor dat er slechts één van deze extensies is geïnstalleerd.
    
    Op beeldschermen met hoge resolutie ondervindt u mogelijk een weergaveprobleem met de kaartontwerper in Visual Studio. U kunt dit probleem oplossen door Visual Studio opnieuw op te starten in de DPI-onbewuste modus, of de registerwaarde DPIUNAWARE toe te voegen.
    
    Raadpleeg de sectie Kaarten maken in dit artikel voor meer informatie.
Op basis van of u werkt aan een werkstroom voor een verbruiks- of standaarde logische app, hebt u een integratieaccount-resource nodig. Normaal gesproken hebt u deze resource nodig wanneer u artefacten wilt definiëren en opslaan voor gebruik in bedrijfsintegratie en B2B-werkstromen.

Belangrijk

Als u wilt samenwerken, moeten zowel uw integratieaccount als de resource van de logische app zich in hetzelfde Azure-abonnement en dezelfde Azure-regio bevinden.
- Voor een verbruikslogica-app werkstroom hebt u een integratieaccount nodig dat is gekoppeld aan uw logica-appresource.
- Voor een werkstroom voor een standaard logische app kunt u uw integratieaccount koppelen aan uw resource voor logische apps, kaarten rechtstreeks uploaden naar uw resource voor logische apps of beide, op basis van de volgende scenario's:
  - Als u al een integratieaccount hebt met de artefacten die u nodig hebt of wilt gebruiken, kunt u uw integratieaccount koppelen aan meerdere resources van de logische standaard-app waar u de artefacten wilt gebruiken. Op die manier hoeft u geen kaarten te uploaden naar elke afzonderlijke logische app. Zie Uw logische app-resource koppelen aan uw integratieaccount voor meer informatie.
  - Met de ingebouwde Liquid-connector kunt u een kaart selecteren die u eerder hebt geüpload naar uw logische app-resource of naar een gekoppeld integratieaccount, maar niet beide.
  Als u dus geen integratieaccount hebt of nodig hebt, kunt u de optie uploaden gebruiken. Anders kunt u de koppelingsoptie gebruiken. In beide gevallen kunt u deze artefacten gebruiken voor alle onderliggende werkstromen binnen dezelfde logische app-resource.

Verbruiks- en Standaardwerkstromen ondersteunen kaarten die verwijzen naar externe assembly's, waardoor aangepaste .NET-code rechtstreeks vanuit kaarten kan worden aangeroepen. Ter ondersteuning van deze mogelijkheid hebben verbruikswerkstromen ook de volgende vereisten:

U heeft een 64-bit samenstelling nodig. De transformatieservice voert een 64-bits proces uit, zodat 32-bits assembly's niet worden ondersteund. Als u de broncode voor een 32-bits assembly hebt, moet u de code opnieuw compileren in een 64-bits assembly. Als u de broncode niet hebt, maar u het binaire bestand van een andere provider hebt verkregen, haalt u de 64-bits versie van die provider op. Sommige leveranciers bieden bijvoorbeeld assembly's in pakketten met zowel 32-bits als 64-bits versies. Als u de optie hebt, gebruikt u in plaats daarvan de 64-bits versie.
U moet zowel de assembly als de kaart in een specifieke volgorde uploaden naar uw integratieaccount. Zorg ervoor dat u eerst uw assembly uploadt en vervolgens de kaart uploadt die verwijst naar de assembly.
Als uw assembly of kaart 2 MB of kleiner is, kunt u uw assembly en kaart rechtstreeks vanuit de Azure-portal aan uw integratieaccount toevoegen.

Als uw assembly groter is dan 2 MB, maar niet groter is dan de limiet voor assembly's, hebt u een Azure-opslagaccount en blobcontainer nodig waar u uw assembly kunt uploaden. Later kunt u de locatie van die container opgeven wanneer u de assembly toevoegt aan uw integratieaccount. Voor deze taak beschrijft de volgende tabel de items die u nodig hebt:

Artikel	Beschrijving
Azure Storage-account	Maak in dit account een Azure Blob-container voor uw assembly. Meer informatie over het maken van een opslagaccount.
Blobcontainer	In deze container kunt u uw assembly uploaden. U hebt ook de locatie van de inhouds-URI van deze container nodig wanneer u de assembly toevoegt aan uw integratieaccount. Meer informatie over het maken van een blobcontainer.
Azure-opslagverkenner	Met dit hulpprogramma kunt u eenvoudiger opslagaccounts en blobcontainers beheren. Als u Storage Explorer wilt gebruiken, downloadt en installeert u Azure Storage Explorer lokaal. Verbind Vervolgens Storage Explorer met uw opslagaccount door de stappen in Aan de slag met Storage Explorer te volgen. Zie quickstart: Een blob maken in objectopslag met Azure Storage Explorer voor meer informatie.

Als u grotere kaarten wilt toevoegen, kunt u de Rest API van Azure Logic Apps - Maps gebruiken. Voor Standaardwerkstromen is de Rest API van Azure Logic Apps momenteel niet beschikbaar.

Beperkingen

Limieten zijn van toepassing op het aantal artefacten, zoals kaarten, per integratieaccount. Raadpleeg limieten en configuratie-informatie voor Azure Logic Apps voor meer informatie.
Afhankelijk van of u werkt aan een werkstroom voor verbruik of standaard logische apps, gelden de volgende beperkingen:
- Werkstromen voor verbruik
  - Azure Logic Apps wijst eindig geheugen toe voor het verwerken van XML-transformaties. Als u consumptiewerkstromen maakt en uw kaart- of gegevensladingstransformaties een hoog geheugenverbruik hebben, kunnen dergelijke transformaties mislukken, met geheugenproblemen als gevolg. Overweeg deze opties om dit scenario te voorkomen:
    - Bewerk uw kaarten of nettoladingen om het geheugenverbruik te verminderen.
    - Maak standaardwerkstromen voor logische apps, die worden uitgevoerd in Azure Logic Apps met één tenant en bieden toegewezen en flexibele opties voor reken- en geheugenresources.
- Standaardwerkstromen ondersteunen minder kaarttypen dan werkstromen voor gebruik, maar er zijn geen beperkingen voor de bestandsgrootte van kaarten. Zie Vereisten voor meer informatie.

Kaarten maken

U kunt kaarten maken met Visual Studio Code met de Data Mapper-extensie of Visual Studio met de extensie Microsoft Azure Logic Apps Enterprise Integration Tools.

Visual Studio Code

Wanneer u kaarten maakt met behulp van Visual Studio Code en de Data Mapper-extensie, kunt u deze kaarten aanroepen vanuit uw werkstroom, maar alleen met de actie Data Mapper Operations genaamd Transform using Data Mapper XSLT, niet met de actie XML-bewerkingen genaamd XML transformeren. Zie Kaarten maken voor gegevenstransformatie met Visual Studio Code voor meer informatie.

Visual Studio

Als u kaarten maakt met Visual Studio, moet u een integratieproject maken met Visual Studio 2019 en de extensie Microsoft Azure Logic Apps Enterprise Integration Tools.

In het integratieproject kunt u een integratieoverzichtsbestand maken, waarmee u items visueel kunt toewijzen tussen twee XML-schemabestanden. Deze hulpprogramma's bieden de volgende kaartmogelijkheden:

U werkt met een grafische weergave van de kaart, waarin alle relaties en koppelingen worden weergegeven die u maakt.
U kunt een directe gegevenskopie maken tussen de XML-schema's die u gebruikt om de kaart te maken. De Enterprise Integration SDK voor Visual Studio bevat een mapper waarmee deze taak net zo eenvoudig is als het tekenen van een lijn die de elementen in het XML-bronschema verbindt met hun tegenhangers in het XML-doelschema.
Bewerkingen of functies voor meerdere kaarten zijn beschikbaar, waaronder tekenreeksfuncties, datum/tijd-functies, enzovoort.
Als u een voorbeeld van een XML-bericht wilt toevoegen, kunt u de maptestmogelijkheid gebruiken. Met slechts één beweging kunt u de kaart testen die u hebt gemaakt en de gegenereerde uitvoer controleren.
Nadat u het project hebt gebouwd, krijgt u een XSLT-document.

De kaartlaag moet de volgende kenmerken hebben en een CDATA sectie bevatten die de oproep naar de assemblycode bevat:

name is de naam van de aangepaste assembly.
namespace is de naamruimte in uw assembly die de aangepaste code bevat.

In het volgende voorbeeld ziet u een kaart die verwijst naar een assembly met de naam XslUtilitiesLib en de circumference methode aanroept vanuit de assembly.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

Assemblies toevoegen waarnaar wordt verwezen

Verbruik
Standaard

Een logische app-resource voor verbruik (Consumption) ondersteunt het verwijzen naar externe assemblages vanuit mappings, waardoor aangepaste .NET-code rechtstreeks vanuit mappings kan worden aangeroepen.

Voer in het zoekvak van Azure Portal integratieaccounts in en selecteer Integratieaccounts.
Selecteer het integratieaccount waaraan u uw assembly wilt toevoegen.
Selecteer Overzicht in het menu van het integratieaccount. Onder Instellingen selecteer Assemblies.
Selecteer Toevoegen op de paginawerkbalk Assemblies.

Op basis van de grootte van uw assemblybestand volgt u de stappen voor het uploaden van een assembly die maximaal 2 MB groot is of meer dan 2 MB, maar maximaal 8 MB. Raadpleeg limieten en configuratie voor Azure Logic Apps voor limieten voor assemblyhoeveelheden in integratieaccounts.

Notitie

Als u de assembly wijzigt, moet u ook uw kaart bijwerken, ongeacht of de kaart wijzigingen heeft.

Assembly's toevoegen tot 2 MB

Voer onder Assembly toevoegen een naam in voor uw assembly. Klein bestand behouden geselecteerd. Selecteer het mapicoon naast het vak Assembly. Zoek en selecteer de assembly die u uploadt.

Nadat u de assembly hebt geselecteerd, wordt in de eigenschap Assemblynaam automatisch de bestandsnaam van de assembly weergegeven.
Als u gereed bent, selecteert u OK.

Nadat het assemblybestand is geüpload, wordt de assembly weergegeven in de lijst Assembly's . Op de overzichtspagina van uw integratieaccount, onder Artefacten, wordt de geüploade assembly ook weergegeven.

Assemblages van meer dan 2 MB toevoegen

Als u grotere assembly's wilt toevoegen, kunt u uw assembly uploaden naar een Azure-blobcontainer in uw Azure-opslagaccount. Uw stappen voor het toevoegen van assembly's verschillen op basis van of uw blobcontainer openbare leestoegang heeft. Controleer dus eerst of uw blobcontainer openbare leestoegang heeft door de volgende stappen uit te voeren: Openbaar toegangsniveau instellen voor blobcontainer

Toegangsniveau van container controleren

Open Azure Storage Explorer. Vouw uw Azure-abonnement uit in het Verkenner-venster .
Vouw Opslagaccounts><opslagaccountnaam>>BlobContainers uit. Selecteer uw blobcontainer.
Selecteer In het snelmenu van uw blobcontainer de optie Openbaar toegangsniveau instellen.
- Als uw blobcontainer ten minste openbare toegang heeft, selecteert u Annuleren en volgt u deze stappen verderop op deze pagina: Uploaden naar containers met openbare toegang
- Als uw blobcontainer geen openbare toegang heeft, selecteert u Annuleren en volgt u deze stappen verderop op deze pagina: Uploaden naar containers zonder openbare toegang

Uploaden naar containers met openbare toegang

Voer de volgende stappen uit om een assembly te uploaden naar uw blobcontainer:

Open Azure Storage Explorer als dat nog niet is gebeurd. Vouw uw Azure-abonnement uit in het Verkenner-venster .
Vouw Opslagaccounts><opslagaccountnaam>>BlobContainers uit. Selecteer de blobcontainer waaraan u de assembly wilt toevoegen.
Selecteer UploadFiles uploaden> op de werkbalk van de blobcontainer. Blader in het vak Bestanden uploaden naar het assemblybestand en selecteer het. Wanneer u klaar bent, selecteert u Uploaden.
Nadat u klaar bent met uploaden, opent u het snelmenu voor de geüploade assembly en selecteert u De URL kopiëren.
Ga terug naar Azure Portal waar het deelvenster Assembly toevoegen is geopend. ** Voer een naam in voor uw samenstelling. Selecteer Groot bestand (groter dan 2 MB).

Het vak Inhouds-URI wordt nu weergegeven in plaats van het vak Assembly .
Plak de URL van uw assembly in het vak Inhouds-URI . Maak het toevoegen van uw assembly af.

Nadat de assembly is geüpload, wordt de assembly weergegeven in de assemblagelijst. Op de overzichtspagina van uw integratieaccount, onder Artefacten, wordt de geüploade assembly ook weergegeven.

Uploaden naar containers zonder openbare toegang

Voer de volgende stappen uit om een assembly te uploaden naar uw blobcontainer:

Open Azure Storage Explorer als dat nog niet is gebeurd. Vouw uw Azure-abonnement uit in het Verkenner-venster .
Uitvouwen Opslagaccounts><opslagaccountnaam>>Blobcontainers. Selecteer de blobcontainer waaraan u de assembly wilt toevoegen.
Selecteer UploadFiles uploaden> op de werkbalk van de blobcontainer. Blader in het vak Bestanden uploaden naar uw assemblybestanden en selecteer deze. Wanneer u klaar bent, selecteert u Uploaden.
Nadat u klaar bent met uploaden, genereert u een SAS (Shared Access Signature) voor uw assembly. Selecteer Verkrijg gedeelde toegangshandtekening in het snelmenu van uw assembly.
Controleer in het vak Shared Access Signature de beschikbare opties. Wanneer u klaar bent, selecteert u Maken. Nadat Storage Explorer de SAS-URL heeft gegenereerd, selecteert u Kopiëren in het vak URL.
Ga terug naar Azure Portal waar het deelvenster Assembly toevoegen is geopend. Voer een naam in voor de assembly. Selecteer Groot bestand (groter dan 2 MB).

Het vak Inhouds-URI wordt nu weergegeven in plaats van het vak Assembly .
Plak in het vak Inhouds-URI de SAS-URI die u eerder hebt gemaakt. Rond het toevoegen van uw samenstelling af.

Nadat de assembly is geüpload, wordt de assembly weergegeven in de Assemblies-lijst. Op de overzichtspagina van uw integratieaccount, onder Artefacten, wordt de geüploade assembly ook weergegeven.

Een resource van een standaard logische app biedt ondersteuning voor het verwijzen naar externe assembly's vanuit kaarten. Met deze mogelijkheid kan uw werkstroom bijvoorbeeld aangepaste .NET Framework-code aanroepen vanuit kaarten. Zie .NET Framework-code maken en uitvoeren vanuit Standard-werkstromen voor meer informatie.

In de volgende tabel worden de ondersteunde assemblytypen beschreven:

Assemblagetype	Beschrijving
Client of SDK Assembly (.NET Framework)	Dit assemblytype biedt opslag en implementatie van client en aangepaste SDK voor .NET Framework. De ingebouwde SAP-connector gebruikt deze assembly's bijvoorbeeld om de NIET-herdistribueerbare DLL-bestanden van SAP NCo te laden.
Client- of SDK-assembly (Java)	Dit assemblytype biedt opslag en implementatie van aangepaste SDK voor Java. De ingebouwde JDBC-connector gebruikt bijvoorbeeld deze JAR-bestanden om JDBC-stuurprogramma's te vinden voor aangepaste relationele databases (RDBs).
Aangepaste assembly (.NET Framework of .NET 8)	Deze assemblytypen bieden opslag en implementatie van aangepaste DLL's. De transformatie-XML-bewerking maakt bijvoorbeeld gebruik van deze assembly's voor de aangepaste transformatiefuncties die vereist zijn tijdens de XML-transformatie.

Azure Portal

Zoek en open uw logische app-resource in het zoekvak van Azure Portal .
Selecteer Assembly's in het menu van de logische app onder Artefacten.
Selecteer Toevoegen op de Assemblies-paginawerkbalk. Selecteer in het deelvenster Assembly toevoegen onder Assemblytype het overeenkomende assemblytype.
Sleep nu uw assemblies naar het vak Bestanden uploaden, of zoek en selecteer uw assemblies.
Wanneer u klaar bent, selecteert u Bestanden uploaden.

Uw geselecteerde assembly's worden nu weergegeven op de Assembly's-pagina van uw logische app.

Visual Studio Code

Ga op uw computer naar de lokale map van uw project en vouw de lib-map uit.

Kies uit de volgende opties op basis van het assemblytype:

Type assemblage	Bestandsextensie	Locatie van de map
Client en SDK Assembly (.NET Framework)	.dll	builtinOperationSdks>net472
Client of SDK-samenstelling (Java)	.jar	builtinOperationSdks>JAR
Aangepaste assembly (.NET Framework of .NET 8)	.dll	gewoonte>net472

Ga terug naar Visual Studio Code.

Uw assemblybestand wordt nu weergegeven in uw project, bijvoorbeeld: