Sdílet prostřednictvím


Přidání map pro transformace v pracovních postupech pomocí Azure Logic Apps

Platí pro: Azure Logic Apps (Consumption + Standard)

Akce pracovního postupu, jako je transformace XML a Liquid , vyžadují k provádění svých úkolů mapování. Například akce Transformovat XML vyžaduje mapování pro převod XML mezi formáty. Mapa je dokument XML, který popisuje, jak převést data z XML do jiného formátu. Obsah mapování obsahuje zdrojové schéma XML jako vstup a cílové schéma XML jako výstup. Můžete definovat základní transformaci, například zkopírování jména a adresy z jednoho dokumentu do jiného. Nebo můžete vytvořit složitější transformace pomocí standardních operací mapování. Data můžete manipulovat nebo kontrolovat pomocí různých předdefinovaných funkcí, jako jsou manipulace s řetězci, podmíněné přiřazení, aritmetické výrazy, formátování data a času, a dokonce i konstrukce smyček.

Předpokládejme například, že pravidelně dostáváte objednávky B2B nebo faktury od zákazníka, který používá formát data YearMonthDay (RRRRMMDD). Vaše organizace ale používá formát data MonthDayYear (MMDDYYYYYYY). Před uložením podrobností objednávky nebo faktury do databáze aktivit zákazníka můžete definovat a použít mapu, která transformuje formát RRRRMMDD na formát MMDDRRRR.

Tento průvodce ukazuje, jak přidat mapu pro pracovní postup, který se má použít. Mapy můžete přidat buď do propojeného účtu integrace, nebo pokud máte standardní aplikaci logiky, můžete mapy přidat přímo do prostředku aplikace logiky.

Prerequisites

  • Účet a předplatné Azure. Pokud ještě nemáte předplatné, zaregistrujte si bezplatný účet Azure.

  • Mapa, kterou chcete nahrát.

    • Pracovní postupy spotřeby podporují následující typy mapování: Liquid, XSLT, XSLT 2.0, XSLT 3.0 nebo HIDX.

    • Standardní pracovní postupy podporují následující typy mapování: XSLT, XSLT 2.0 a XSLT 3.0.

    • K vytváření map můžete použít některý z následujících nástrojů:

      • Visual Studio Code a rozšíření Mapovač dat Chcete-li volat mapy vytvořené pomocí mapovače dat z pracovního postupu, je nutné použít akci Operace mapování dat s názvem Transformace pomocí mapování dat XSLT, nikoli akci Operace XML s názvem Transformovat XML. Další informace najdete v tématu Vytváření map pro transformaci dat pomocí editoru Visual Studio Code.

      • Visual Studio 2019 a rozšíření Microsoft Azure Logic Apps Enterprise Integration Tools

        Note

        Nenainstalujte rozšíření Microsoft Azure Logic Apps Enterprise Integration Tools spolu s rozšířením BizTalk Server. Při použití obou rozšíření může dojít k neočekávanému chování. Ujistěte se, že máte nainstalovaná jenom jedno z těchto rozšíření.

        Na monitorech s vysokým rozlišením můžete zaznamenat problém se zobrazením návrháře map v sadě Visual Studio. Chcete-li tento problém se zobrazením vyřešit, restartujte sadu Visual Studio v režimu bez rozlišení DPI nebo přidejte hodnotu registru DPIUNAWARE.

        Další informace najdete v části Vytvoření map v tomto článku.

  • Na základě toho, jestli pracujete na pracovním postupu aplikace logiky Consumption nebo Standard, budete potřebovat prostředek účtu integrace. Tento prostředek obvykle potřebujete, když chcete definovat a ukládat artefakty pro použití v podnikových integracích a pracovních postupech B2B.

    Important

    Abyste mohli spolupracovat, musí váš účet integrace i prostředek aplikace logiky existovat ve stejném předplatném Azure a v oblasti Azure.

    • Pro pracovní postup aplikace logiky Consumption budete potřebovat účet integrace, který je propojený s prostředkem aplikace logiky.

    • Pro pracovní postup standardní aplikace logiky můžete propojit svůj účet integrace s prostředkem aplikace logiky, nahrát mapy přímo do prostředku aplikace logiky nebo obojí na základě následujících scénářů:

      • Pokud už máte účet integrace s artefakty, které potřebujete nebo chcete použít, můžete svůj účet integrace propojit s několika prostředky standardní aplikace logiky, ve kterých chcete artefakty používat. Díky tomu nemusíte nahrávat mapy do každé jednotlivé aplikace logiky. Další informace najdete v tématu Propojení prostředku aplikace logiky s účtem integrace.

      • Integrovaný konektor Liquid umožňuje vybrat mapu, kterou jste předtím nahráli do prostředku aplikace logiky nebo do propojeného účtu integrace, ale ne do obou.

      Pokud tedy účet integrace nemáte nebo potřebujete, můžete použít možnost nahrávání. V opačném případě můžete použít možnost propojení. V obou směrech můžete tyto artefakty použít napříč všemi podřízenými pracovními postupy v rámci stejného prostředku aplikace logiky.

  • Pracovní postupy Consumption a Standard podporují mapy, které odkazují na externí sestavení, která umožňují přímé volání vlastního kódu .NET z map. Pro podporu této funkce mají pracovní postupy Consumption také následující požadavky:

    • Potřebujete 64bitové sestavení. Transformační služba spouští 64bitový proces, takže nejsou podporována 32bitová sestavení. Pokud máte zdrojový kód pro 32bitové sestavení, překompilujte kód do 64bitového sestavení. Pokud zdrojový kód nemáte, ale získali jste binární soubor od jiného zprostředkovatele, získejte od daného zprostředkovatele 64bitovou verzi. Někteří dodavatelé například poskytují sestavení v balíčcích, které mají 32bitovou i 64bitovou verzi. Pokud máte možnost, použijte místo toho 64bitovou verzi.

    • Do svého účtu integrace musíte nahrát sestavení i mapu v určitém pořadí. Nejprve se ujistěte, že nahrajete sestavení, a pak nahrajte mapu, která odkazuje na sestavení.

    • Pokud je sestavení nebo mapa 2 MB nebo menší, můžete sestavení přidat a mapovat do svého účtu integrace přímo z webu Azure Portal.

    • Pokud je sestavení větší než 2 MB, ale není větší než limit velikosti sestavení, budete potřebovat účet úložiště Azure a kontejner objektů blob, kde můžete nahrát sestavení. Později můžete umístění kontejneru zadat při přidání sestavení do účtu integrace. Pro tento úkol popisuje následující tabulka položky, které potřebujete:

      Item Description
      Účet služby Azure Storage V tomto účtu vytvořte kontejner objektů blob Azure pro vaše sestavení. Zjistěte , jak vytvořit účet pro úložiště.
      Kontejner blob V tomto kontejneru můžete nahrát sestavení. Když přidáváte sestavení do svého účtu integrace, potřebujete také URI umístění obsahu tohoto kontejneru. Zjistěte, jak vytvořit kontejner objektů blob.
      Průzkumník služby Azure Storage Tento nástroj vám pomůže snadněji spravovat účty úložiště a blob kontejnery. Pokud chcete průzkumníka služby Storage používat, stáhněte si Průzkumníka služby Azure Storage a nainstalujte ho místně. Poté, co postupujete podle kroků v části Začínáme s Průzkumník služby Storage, připojte Průzkumníka služby Storage k vašemu účtu úložiště. Další informace najdete v tématu Rychlý start: Vytvoření objektu blob v úložišti objektů pomocí Průzkumníka služby Azure Storage.

      Pokud chcete přidat větší mapy, můžete použít rozhraní REST API služby Azure Logic Apps – Mapy. U standardních pracovních postupů není rozhraní REST API služby Azure Logic Apps momentálně k dispozici.

Limitations

  • Omezení se vztahují na počet artefaktů, jako jsou mapy, pro integrační účet. Další informace najdete v tématu Omezení a informace o konfiguraci pro Azure Logic Apps.

  • Na základě toho, jestli pracujete na pracovním postupu aplikace logiky Consumption nebo Standard, platí následující omezení:

    • Pracovní postupy spotřeby

      • Azure Logic Apps přiděluje omezenou paměť pro zpracování transformací XML. Pokud vytváříte pracovní postupy Consumption a transformace map nebo datové části mají vysokou spotřebu paměti, tyto transformace můžou selhat, což vede k chybám způsobeným nedostatkem paměti. Pokud se chcete tomuto scénáři vyhnout, zvažte tyto možnosti:

        • Upravte mapy nebo užitečné zatížení, abyste snížili spotřebu paměti.

        • Vytvořte pracovní postupy standardní aplikace logiky, které běží v Azure Logic Apps s jedním tenantem a nabízejí vyhrazené a flexibilní možnosti pro výpočetní a paměťové prostředky.

    • Standardní pracovní postupy podporují méně typů mapování než pracovní postupy Consumption, ale žádné limity se nevztahují na velikosti souborů mapování. Další informace najdete v tématu Požadavky.

Vytvořit mapy

Mapy můžete vytvářet pomocí Visual Studio Code s rozšířením Data Mapper nebo pomocí Visual Studio s rozšířením Microsoft Azure Logic Apps Enterprise Integration Tools.

Visual Studio Code

Když vytváříte mapy pomocí editoru Visual Studio Code a rozšíření mapování dat, můžete tyto mapy volat z pracovního postupu, ale pouze s akcí Operace mapování dat s názvem Transformovat pomocí mapování dat XSLT, nikoli akcí operací XML s názvem Transform XML. Další informace najdete v tématu Vytváření map pro transformaci dat pomocí editoru Visual Studio Code.

Visual Studio

Pokud vytváříte mapy pomocí sady Visual Studio, budete muset vytvořit projekt integrace se sadou Visual Studio 2019 a rozšířením Microsoft Azure Logic Apps Enterprise Integration Tools.

V projektu integrace můžete vytvořit soubor mapy integrace, který umožňuje vizuálně mapovat položky mezi dvěma soubory schématu XML. Tyto nástroje nabízejí následující možnosti mapování:

  • Pracujete s grafickým znázorněním mapy, která zobrazuje všechny relace a odkazy, které vytvoříte.

  • Můžete vytvořit přímou kopii dat mezi schématy XML, které používáte k vytvoření mapy. Sada Enterprise Integration SDK pro Visual Studio obsahuje mapovač, který tuto úlohu usnadňuje tak, že nakreslí čáru, která spojuje prvky ve zdrojovém schématu XML s jejich protějšky v cílovém schématu XML.

  • Operace nebo funkce pro více map jsou k dispozici, včetně řetězcových funkcí, funkcí data a času atd.

  • Pokud chcete přidat ukázkovou zprávu XML, můžete použít funkci testování mapování. Pomocí jediného gesta můžete otestovat mapu, kterou jste vytvořili, a zkontrolovat vygenerovaný výstup.

  • Po sestavení projektu získáte dokument XSLT.

Mapa musí mít následující atributy a CDATA oddíl, který obsahuje volání kódu sestavení:

  • name je název vlastního sestavení.

  • namespace je obor názvů ve vašem sestavení, který obsahuje vlastní kód.

Následující příklad ukazuje mapu, která odkazuje na sestavení s názvem XslUtilitiesLib a volá circumference metodu ze sestavení.

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

Přidat odkazovaná sestavení

Prostředek aplikace logiky Consumption podporuje odkazování na externí sestavení z map, která umožňují přímé volání vlastního kódu .NET z map.

  1. Do vyhledávacího pole webu Azure Portal zadejte účty integrace a vyberte Účty integrace.

  2. Vyberte účet integrace, do kterého chcete přidat sestavení.

  3. V nabídce účtu integrace vyberte Přehled. V části Nastavení vyberte Sestavení.

  4. Na panelu nástrojů stránky Sestavení vyberte Přidat.

Na základě velikosti souboru sestavení postupujte podle kroků pro nahrání sestavení, které má až 2 MB nebo větší než 2 MB, ale maximálně do 8 MB. Omezení množství sestavení v účtech integrace najdete v tématu Limity a konfigurace pro Azure Logic Apps.

Note

Pokud změníte sestavení, musíte také aktualizovat mapu bez ohledu na to, jestli má mapa změny.

Přidejte sestavení až do 2 MB

  1. V části Přidat sestavení zadejte název sestavení. Ponechte malý soubor vybraný. Vedle pole Sestavení vyberte ikonu složky. Vyhledejte a vyberte sestavení, které nahráváte.

    Jakmile vyberete sestavení, vlastnost Název sestavení automaticky zobrazí název souboru sestavení.

  2. Jakmile budete hotovi, vyberte tlačítko OK.

    Po dokončení nahrávání souboru sestavení se sestavení zobrazí v seznamu Sestavení . Na stránce Přehled účtu integrace se v části Artefakty zobrazí také nahrané sestavení.

Přidejte sestavení větší než 2 MB

Pokud chcete přidat větší sestavení, můžete sestavení nahrát do kontejneru objektů blob Azure v účtu úložiště Azure. Postup přidání sestavení se liší podle toho, jestli má kontejner objektů blob veřejný přístup ke čtení. Nejprve zkontrolujte, jestli má váš kontejner objektů blob veřejný přístup ke čtení, a to pomocí následujícího postupu: Nastavení úrovně veřejného přístupu pro kontejner objektů blob

Kontrola úrovně přístupu ke kontejneru
  1. Otevřete Průzkumník služby Azure Storage. V okně Průzkumníka rozbalte své předplatné Azure.

  2. Rozbalte Účty úložiště><kontejnery objektů blob. Vyberte blobový kontejner.

  3. V místní nabídce kontejneru objektů blob vyberte možnost Nastavit úroveň veřejného přístupu.

Nahrání do kontejnerů s veřejným přístupem

Pokud chcete nahrát sestavení do kontejneru objektů blob, postupujte takto:

  1. Otevřete Průzkumníka služby Azure Storage, pokud ještě není otevřený. V okně Průzkumníka rozbalte své předplatné Azure.

  2. Rozbalte Účty úložiště><kontejnery objektů blob. Vyberte kontejner objektů blob, do kterého chcete přidat sestavení.

  3. Na panelu nástrojů kontejneru objektů blob vyberte Nahrát>soubory. V poli Nahrát soubory procházejte a vyberte soubor sestavení. Až budete připraveni, vyberte Nahrát.

  4. Po dokončení nahrávání otevřete kontextovou nabídku pro nahrané sestavení a vyberte Kopírovat adresu URL.

  5. Vraťte se na portál Azure, kde je otevřené podokno Přidat sestavení. Zadejte název sestavení. Vyberte Velký soubor (větší než 2 MB).

    Pole Identifikátor URI obsahu se teď zobrazí místo pole Sestavení .

  6. Do pole Content URI vložte adresu URL sestavení. Dokončete přidání sestavení.

    Po dokončení nahrávání sestavení se sestavení zobrazí v seznamu Sestavení . Na stránce Přehled účtu integrace se v části Artefakty zobrazí také nahrané sestavení.

Nahrání do kontejnerů bez veřejného přístupu

Pokud chcete nahrát sestavení do kontejneru objektů blob, postupujte takto:

  1. Otevřete Průzkumníka služby Azure Storage, pokud ještě není otevřený. V okně Průzkumníka rozbalte své předplatné Azure.

  2. Rozbalte Účty úložiště><kontejnery objektů blob. Vyberte kontejner objektů blob, do kterého chcete přidat sestavení.

  3. Na panelu nástrojů kontejneru objektů blob vyberte Nahrát>soubory. V poli Nahrát soubory vyhledejte a vyberte soubory sady. Až budete připraveni, vyberte Nahrát.

  4. Po dokončení nahrávání vygenerujte sdílený přístupový podpis (SAS) pro sestavení. V místní nabídce sestavení vyberte Získat sdílený přístupový podpis.

  5. V poli Sdílený přístupový podpis zkontrolujte dostupné možnosti. Až budete připraveni, vyberte Vytvořit. Jakmile Průzkumník služby Storage vygeneruje adresu URL SAS, vyberte v poli Adresa URL možnost Kopírovat.

  6. Vraťte se na portál Azure, kde je otevřené podokno Přidat sestavení. Zadejte název sestavení. Vyberte Velký soubor (větší než 2 MB).

    Pole Identifikátor URI obsahu se teď zobrazí místo pole Sestavení .

  7. Do pole Identifikátor URI obsahu vložte identifikátor URI SAS, který jste vytvořili dříve. Dokončete přidání sestavení.

Po dokončení nahrávání sestavení se sestavení zobrazí v seznamu Sestavení . Na stránce Přehled vašeho účtu integrace se zobrazí také nahrané sestavení v části Artefakty.

Přidejte mapy

  • Pokud pracujete s pracovním postupem Consumption, musíte mapu přidat do propojeného účtu integrace.

  • Pokud pracujete se standardním pracovním postupem, máte následující možnosti:

    • Přidejte mapu do propojeného integračního účtu. Účet mapování a integrace můžete sdílet mezi několika prostředky aplikace logiky Standard a jejich podřízenými pracovními postupy.

    • Přidejte mapu přímo do prostředku aplikace logiky. Tuto mapu však můžete sdílet pouze mezi podřízenými workflowy ve stejném zdroji logic app.

Přidání mapy do účtu integrace

  1. Na webu Azure Portal se přihlaste pomocí svých přihlašovacích údajů k účtu Azure.

  2. Do vyhledávacího pole webu Azure Portal zadejte účty integrace a vyberte Účty integrace.

  3. Vyhledejte a vyberte svůj účet integrace.

  4. V nabídce účtu integrace v části Nastavení vyberte Mapy.

  5. Na panelu nástrojů stránky Mapy vyberte Přidat.

Pro pracovní postupy Consumption, které vycházejí z velikosti souboru mapy, nyní postupujte podle kroků pro nahrání mapy, která je do 2 MB nebo větší než 2 MB.

Přidání map až do 2 MB
  1. V podokně Přidat mapu zadejte jedinečný název mapy.

  2. V části Typ mapy vyberte typ, například Liquid, XSLT, XSLT 2.0, XSLT 3.0 nebo HIDX.

  3. Vedle pole Mapa vyberte ikonu složky. Vyberte mapu, která se má nahrát, a pak vyberte Otevřít.

    Pokud jste vlastnost Name nechali prázdnou, název souboru mapy se po výběru souboru mapy automaticky zobrazí v této vlastnosti.

  4. Jakmile budete hotovi, vyberte tlačítko OK.

    Po dokončení nahrávání souboru mapy se mapa zobrazí v seznamu Mapy . Pokud se mapa nezobrazí, vyberte na panelu nástrojů Mapymožnost Aktualizovat. Na stránce Přehled účtu integrace se v části Artefakty zobrazí také nahraná mapa.

Přidejte mapy větší než 2 MB

Pokud chcete přidat větší mapy pro pracovní postupy Consumption, použijte rozhraní REST API služby Azure Logic Apps – Mapy.

Přidejte mapu do standardního prostředku logické aplikace

Následující kroky platí jenom v případě, že chcete přidat mapu přímo do prostředku aplikace logiky Standard. V opačném případě přidejte mapu do svého účtu integrace.

Azure Portal
  1. V nabídce aplikace logiky v části Artefakty vyberte Mapy.

  2. Na panelu nástrojů stránky Mapy vyberte Přidat.

  3. V podokně Přidat mapu zadejte jedinečný název mapy a přidejte příponu souboru, například .xslt, .hidx nebo .liquid.

  4. Vedle pole Mapa vyberte ikonu složky. Vyberte mapu, která se má nahrát.

  5. Jakmile budete hotovi, vyberte tlačítko OK.

    Po dokončení nahrávání souboru mapy se mapa zobrazí v seznamu Mapy . Na stránce Přehled vašeho účtu integrace se v části Artefakty zobrazí také nahraná mapa.

Visual Studio Code
  1. Na počítači přejděte do místní složky projektu a rozbalte následující složky: Artifacts>Maps.

  2. Do složky Mapy přidejte soubor mapy.

  3. Vraťte se do editoru Visual Studio Code.

    Soubor mapy se teď zobrazí v projektu, například:

    Snímek obrazovky znázorňující strukturu projektu editoru Visual Studio Code s rozbalenými složkami Artefakty a Mapy

Úprava mapy

Pokud chcete aktualizovat existující mapu, musíte nahrát nový soubor mapy s požadovanými změnami. Můžete si ale napřed stáhnout existující mapu pro úpravy.

  1. Na webu Azure Portal otevřete svůj účet integrace, pokud ještě není otevřený.

  2. V nabídce účtu integrace v části Nastavení vyberte Mapy.

  3. Po otevření stránky Mapy vyberte mapu. Pokud chcete mapu nejprve stáhnout a upravit, na panelu nástrojů stránky Mapy vyberte Stáhnout a uložte mapu.

  4. Až budete chtít aktualizovanou mapu nahrát, vyberte na stránce Mapy mapu, kterou chcete aktualizovat. Na panelu nástrojů stránky Mapy vyberte Aktualizovat.

  5. Najděte a vyberte aktualizovanou mapu, kterou chcete nahrát.

    Po dokončení nahrávání souboru mapy se aktualizovaná mapa zobrazí v seznamu Mapy .

Odstranění mapy

  1. Na webu Azure Portal otevřete svůj účet integrace, pokud ještě není otevřený.

  2. V nabídce účtu integrace v části Nastavení vyberte Mapy.

  3. Po otevření stránky Mapy vyberte mapu a pak vyberte Odstranit.

  4. Pokud chcete potvrdit, že chcete mapu odstranit, vyberte Ano.