Lägga till kartor för omvandlingar i arbetsflöden med Azure Logic Apps

Gäller för: Azure Logic Apps (Förbrukning + Standard)

Arbetsflödesåtgärder som Transformera XML och Liquid kräver en karta för att utföra sina uppgifter. Till exempel kräver åtgärden Transformera XML en mappning för att konvertera XML mellan format. En karta är ett XML-dokument som beskriver hur du konverterar data från XML till ett annat format. Kartinnehållet innehåller XML-källschemat som indata och ett XML-målschema som utdata. Du kan definiera en grundläggande transformering, till exempel att kopiera ett namn och en adress från ett dokument till ett annat. Eller så kan du skapa mer komplexa transformeringar med hjälp av de färdiga kartåtgärderna. Du kan manipulera eller styra data med hjälp av olika inbyggda funktioner, till exempel strängmanipuleringar, villkorliga tilldelningar, aritmetiska uttryck, datumtidsformaterare och till och med loopkonstruktioner.

Anta till exempel att du regelbundet får B2B-beställningar eller fakturor från en kund som använder datumformatet YearMonthDay (ÅÅÅÅÅMMDD). Din organisation använder dock datumformatet MonthDayYear (MMDDYYYYY). Du kan definiera och använda en karta som omvandlar YYYYMMDD-formatet till FORMATET MMDDYYYY innan du lagrar beställnings- eller fakturainformationen i kundaktivitetsdatabasen.

Den här guiden visar hur du lägger till en karta som arbetsflödet ska använda. Du kan lägga till kartor antingen till ditt länkade integrationskonto eller om du har en standardlogikapp kan du lägga till kartor direkt till logikappresursen.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har någon prenumeration än registrerar du dig för ett kostnadsfritt Azure-konto.

• Den karta som du vill ladda upp.

  • Förbrukningsarbetsflöden stöder följande karttyper: Liquid, XSLT, XSLT 2.0, XSLT 3.0 eller HIDX.

  • Standardarbetsflöden stöder följande karttyper: XSLT, XSLT 2.0 och XSLT 3.0.

  • Om du vill skapa kartor kan du använda något av följande verktyg:

    • Visual Studio Code och datamappningstillägget. Om du vill anropa kartorna som skapats med Data Mapper från arbetsflödet måste du använda åtgärden DataMapper Operations med namnet Transformera med hjälp av Data Mapper XSLT, inte XML-åtgärd med namnet Transformera XML. Mer information finns i Skapa kartor för datatransformering med Visual Studio Code.

    • Visual Studio 2019 och tillägget Microsoft Azure Logic Apps Enterprise Integration Tools.

      Kommentar

      Installera inte tillägget Microsoft Azure Logic Apps Enterprise Integration Tools tillsammans med BizTalk Server-tillägget. Att ha båda tilläggen kan orsaka oväntade beteenden. Kontrollera att du bara har ett av dessa tillägg installerat.

      På bildskärmar med hög upplösning kan det uppstå ett visningsproblem med kartdesignern i Visual Studio. Lös det här visningsproblemet genom att antingen starta om Visual Studio i DPI-omedvetet läge eller lägga till registervärdet DPIUNAWARE.

      Mer information finns i avsnittet Skapa kartor i den här artikeln.

• Baserat på om du arbetar med ett arbetsflöde för förbrukning eller standardlogikapp behöver du en integrationskontoresurs. Vanligtvis behöver du den här resursen när du vill definiera och lagra artefakter för användning i företagsintegrering och B2B-arbetsflöden.

  Viktigt!

  För att fungera tillsammans måste både ditt integrationskonto och logikappresurs finnas i samma Azure-prenumeration och Azure-region.

  • För ett arbetsflöde för förbrukningslogikapp behöver du ett integrationskonto som är länkat till logikappresursen.

  • För ett standardarbetsflöde för logikappar kan du länka ditt integrationskonto till din logikappresurs, ladda upp kartor direkt till logikappens resurs eller båda, baserat på följande scenarier:

    • Om du redan har ett integrationskonto med artefakterna som du behöver eller vill använda kan du länka ditt integrationskonto till flera standardlogikappresurser där du vill använda artefakterna. På så sätt behöver du inte ladda upp kartor till varje enskild logikapp. För mer information, se Länka logikappresursen till ditt integrationskonto.

    • Med den inbyggda liquid-anslutningsappen kan du välja en karta som du tidigare laddade upp till din logikappresurs eller till ett länkat integrationskonto, men inte båda.

    Så om du inte har eller behöver ett integrationskonto kan du använda uppladdningsalternativet. Annars kan du använda länkningsalternativet. Hur som helst kan du använda dessa artefakter i alla underliggande arbetsflöden inom samma logikappresurs.

• Förbruknings- och standardarbetsflöden stöder kartor som refererar till externa sammansättningar, vilket gör det möjligt att direkt anropa anpassad .NET-kod från kartor. För att stödja den här funktionen har förbrukningsarbetsflöden också följande krav:

  • Du behöver en 64-bitars assembler. Transformeringstjänsten kör en 64-bitarsprocess, så 32-bitars sammansättningar stöds inte. Om du har källkoden för en 32-bitars sammansättning kan du kompilera om koden till en 64-bitars sammansättning. Om du inte har källkoden, men du fick binärfilen från en annan provider, hämtar du 64-bitarsversionen från providern. Vissa leverantörer tillhandahåller till exempel sammansättningar i paket som har både 32- och 64-bitarsversioner. Om du har alternativet använder du 64-bitarsversionen i stället.

  • Du måste ladda upp både sammansättningen och kartan i en specifik ordning till ditt integrationskonto. Se till att du laddar upp sammansättningen först och ladda sedan upp kartan som refererar till sammansättningen.

  • Om din sammansättning eller karta är 2 MB eller mindre kan du lägga till din sammansättning och mappa till ditt integrationskonto direkt från Azure Portal.

  • Om din sammansättning är större än 2 MB men inte större än storleksgränsen för sammansättningar behöver du ett Azure Storage-konto och en blobcontainer där du kan ladda upp sammansättningen. Senare kan du ange containerns plats när du lägger till sammansättningen i ditt integrationskonto. För den här uppgiften beskriver följande tabell de objekt du behöver:

    Objekt	beskrivning
    Azure Storage-konto	I det här kontot skapar du en Azure-blobcontainer för din sammansättning. Lär dig hur du skapar ett lagringskonto.
    Blob-behållare	I den här containern kan du ladda upp sammansättningen. Du behöver också containerns innehålls-URI-plats när du lägger till sammansättningen i ditt integrationskonto. Lär dig hur du skapar en blobcontainer.
    Azure Storage Explorer	Det här verktyget hjälper dig att enklare hantera lagringskonton och blobcontainrar. Om du vill använda Storage Explorer laddar du antingen ned och installerar Azure Storage Explorer lokalt. Anslut sedan Storage Explorer till ditt lagringskonto genom att följa stegen i Kom igång med Storage Explorer. Mer information finns i Snabbstart: Skapa en blob i objektlagring med Azure Storage Explorer.

    Om du vill lägga till större kartor kan du använda REST-API:et för Azure Logic Apps – Maps. För Standard-arbetsflöden är REST-API:et för Azure Logic Apps för närvarande inte tillgängligt.

Begränsningar

• Begränsningar gäller för antalet artefakter, till exempel kartor, per integrationskonto. Mer information finns i Begränsningar och konfigurationsinformation för Azure Logic Apps.

• Beroende på om du arbetar med ett förbruknings- eller standardarbetsflöde för logikappar gäller följande begränsningar:

  • Förbrukningsarbetsflöden

    • Azure Logic Apps allokerar begränsat minne för bearbetning av XML-transformeringar. Om du skapar arbetsflöden för förbrukning och dina kart- eller nyttolasttransformeringar har hög minnesförbrukning kan sådana transformeringar misslyckas, vilket resulterar i minnesfel. Tänk på följande alternativ för att undvika det här scenariot:

      • Redigera dina kartor eller nyttolaster för att minska minnesförbrukningen.

      • Skapa standardarbetsflöden för logikappar som körs i Azure Logic Apps med en enda klientorganisation och erbjuder dedikerade och flexibla alternativ för beräknings- och minnesresurser.

  • Standardarbetsflöden har stöd för färre karttyper än konsumtionsarbetsflöden, men det finns inga begränsningar för kartfilers storlek. Mer information finns i Krav.

Skapa kartor

Du kan skapa kartor med antingen Visual Studio Code med datamappningstillägget eller Visual Studio med tillägget Microsoft Azure Logic Apps Enterprise Integration Tools.

Visual Studio-koden

När du skapar kartor med Visual Studio Code och datamappningstillägget kan du anropa dessa kartor från arbetsflödet, men bara med åtgärden Data Mapper Operations med namnet Transformera med hjälp av Data Mapper XSLT, inte XML-åtgärdsåtgärden Transform XML. Mer information finns i Skapa kartor för datatransformering med Visual Studio Code.

Visual Studio

Om du skapar kartor med Visual Studio måste du skapa ett integrationsprojekt med Visual Studio 2019 och tillägget Microsoft Azure Logic Apps Enterprise Integration Tools.

I integrationsprojektet kan du skapa en integrationsmappningsfil som gör att du visuellt kan mappa objekt mellan två XML-schemafiler. Dessa verktyg erbjuder följande kartfunktioner:

• Du arbetar med en grafisk representation av kartan, som visar alla relationer och länkar som du skapar.

• Du kan skapa en direkt datakopia mellan de XML-scheman som du använder för att skapa kartan. Enterprise Integration SDK för Visual Studio innehåller en mappare som gör den här uppgiften så enkel som att rita en linje som ansluter elementen i XML-källschemat till deras motsvarigheter i XML-målschemat.

• Åtgärder eller funktioner för flera kartor är tillgängliga, inklusive strängfunktioner, datumtidsfunktioner och så vidare.

• Om du vill lägga till ett XML-exempelmeddelande kan du använda karttestningsfunktionen. Med bara en gest kan du testa kartan som du skapade och granska de genererade utdata.

• När du har skapat projektet får du ett XSLT-dokument.

Kartan måste ha följande attribut och ett CDATA avsnitt som innehåller anropet till sammansättningskoden:

• name är det anpassade sammansättningsnamnet.

• namespace är namnområdet i sammansättningen som innehåller den anpassade koden.

I följande exempel visas en karta som refererar till en sammansättning med namnet XslUtilitiesLib och anropar circumference metoden från sammansättningen.

<?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>

Lägga till refererade sammansättningar

Lägg till kartor

• Om du arbetar med ett förbrukningsarbetsflöde måste du lägga till kartan i ett länkat integrationskonto.

• Om du arbetar med ett Standard-arbetsflöde har du följande alternativ:

  • Lägg till din karta i ett länkat integrationskonto. Du kan dela kart- och integrationskontot mellan flera standardlogik-appar och deras underordnade arbetsflöden.

  • Lägg till kartan direkt i logikappresursen. Du kan dock bara dela kartan över arbetsflöden för underordnade i samma logikapp-resurs.

Lägga till karta i integrationskontot

1. Logga in med dina autentiseringsuppgifter för Azure-kontot i Azure Portal.

2. I sökrutan Azure Portal anger du integrationskonton och väljer Integreringskonton.

3. Leta upp och välj ditt integrationskonto.

4. På menyn integrationskonto går du till Inställningar och väljer Kartor.

5. I verktygsfältet på sidan Kartor väljer du Lägg till.

För förbrukningsarbetsflöden, baserat på kartans filstorlek, följer du nu stegen för att ladda upp en karta som antingen är upp till 2 MB eller mer än 2 MB.

Lägga till kartor upp till 2 MB

1. I fönstret Lägg till karta anger du ett unikt namn för kartan.

2. Under Karttyp väljer du typen, till exempel: Liquid, XSLT, XSLT 2.0, XSLT 3.0 eller HIDX.

3. Bredvid rutan Karta väljer du mappikonen. Välj den karta som ska laddas upp och välj sedan Öppna.

   Om du lämnade egenskapen Namn tom visas kartans filnamn automatiskt i den egenskapen när du har valt mappningsfilen.

4. När du är klar väljer du OK.

   När kartfilen har laddats upp visas kartan i listan Kartor . Om kartan inte visas väljer du Uppdatera i verktygsfältet Kartor. På sidan Översikt för integrationskontot visas även den uppladdade kartan under Artefakter.

Lägga till kartor mer än 2 MB

Om du vill lägga till större kartor för arbetsflöden för förbrukning använder du REST-API:et för Azure Logic Apps – Maps.

Lägg till karta till standard-logikappresursen

Följande steg gäller endast om du vill lägga till en karta direkt till din Standard-logikappresurs. Annars lägger du till kartan i ditt integrationskonto.

Azure Portal

1. På logikappmenyn går du till Artefakter och väljer Kartor.

2. I verktygsfältet på sidan Kartor väljer du Lägg till.

3. I fönstret Lägg till karta anger du ett unikt namn för kartan och inkluderar filnamnstillägget, till exempel .xslt, .hidx eller .liquid.

4. Bredvid rutan Karta väljer du mappikonen. Välj den karta som ska laddas upp.

5. När du är klar väljer du OK.

   När kartfilen har laddats upp visas kartan i listan Kartor . På integrationskontots översiktssida, under Artefakter, visas även den uppladdade kartan.

Visual Studio-koden

1. På datorn går du till projektets lokala mapp och expanderar följande mappar: Artifacts>Maps.

2. Lägg till kartfilen i mappen Maps .

3. Gå tillbaka till Visual Studio Code.

   Kartfilen visas nu i projektet, till exempel:

   

Redigera en karta

Om du vill uppdatera en befintlig karta måste du ladda upp en ny mappningsfil som innehåller de ändringar du vill ha. Du kan dock först ladda ned den befintliga kartan för redigering.

Ta bort en karta

Relaterat innehåll

• Transformera XML för arbetsflöden i Azure Logic Apps
• Validera XML för arbetsflöden i Azure Logic Apps