Kódování a dekódování plochých souborů v Azure Logic Apps

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

Před odesláním obsahu XML obchodnímu partnerovi ve scénáři B2B (business-to-business) možná budete chtít tento obsah nejdřív zakódovat. Pokud obdržíte kódovaný obsah XML, budete muset nejprve tento obsah dekódovat. Při vytváření pracovního postupu aplikace logiky v Azure Logic Apps můžete zakódovat a dekódovat ploché soubory pomocí akcí integrovaného konektoru Flat File a schématu plochých souborů pro kódování a dekódování. Akce plochého souboru můžete použít v pracovních postupech víceklientských aplikací logiky Consumption a pracovních postupech standardní aplikace logiky s jedním tenantem.

I když nejsou k dispozici žádné aktivační události plochého souboru , můžete k podávání zdrojového obsahu XML do pracovního postupu použít libovolnou aktivační událost nebo akci. Můžete například použít integrovaný trigger konektoru, spravovaný trigger konektoru hostovaný v Azure, který je k dispozici pro Azure Logic Apps nebo dokonce jinou aplikaci.

Tento článek ukazuje, jak do pracovního postupu přidat akce kódování a dekódování plochých souborů .

  • Přidejte do pracovního postupu akci kódování plochých souborů nebo dekódování.
  • Vyberte schéma, které chcete použít.

Další informace najdete v následující dokumentaci:

Požadavky

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

  • Pracovní postup aplikace logiky, prázdný nebo existující, ve kterém chcete použít akci Plochý soubor .

    Pokud máte prázdný pracovní postup, použijte libovolný trigger, který chcete spustit. V tomto příkladu se používá trigger požadavku .

  • Prostředek a pracovní postup aplikace logiky Ploché operace se soubory nemají k dispozici žádné triggery, takže váš pracovní postup musí obsahovat trigger minimálně. Další informace najdete v následující dokumentaci:

  • Schéma plochých souborů pro kódování a dekódování obsahu XML. Další informace najdete v tématu Přidání schémat pro použití s pracovními postupy v Azure Logic Apps.

  • 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.

    Důležité

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

    • Pokud pracujete na pracovním postupu aplikace logiky Consumption, prostředek aplikace logiky vyžaduje odkaz na váš účet integrace.

    • Pokud pracujete na pracovním postupu standardní aplikace logiky, můžete propojit prostředek aplikace logiky s účtem integrace, nahrát schémata 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. Tímto způsobem nemusíte nahrávat schémata do každé jednotlivé aplikace logiky. Další informace najdete v tématu Propojení prostředku aplikace logiky s účtem integrace.

      • Integrovaný konektor Flat File umožňuje vybrat schéma, které jste předtím nahráli do prostředku aplikace logiky nebo do propojeného účtu integrace, ale ne do obou. Tento artefakt pak můžete použít ve všech podřízených pracovních postupech v rámci stejného prostředku aplikace logiky.

      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.

  • Nainstalujte nebo použijte nástroj, který může odesílat požadavky HTTP k otestování vašeho řešení, například:

    Upozornění

    V situacích, kdy máte citlivá data, jako jsou přihlašovací údaje, tajné kódy, přístupové tokeny, klíče rozhraní API a další podobné informace, nezapomeňte použít nástroj, který chrání vaše data pomocí potřebných funkcí zabezpečení, funguje offline nebo místně, nesynchronizuje vaše data do cloudu a nevyžaduje, abyste se přihlásili k online účtu. Tímto způsobem snížíte riziko zveřejnění citlivých dat veřejnosti.

Omezení

  • Obsah XML, který chcete dekódovat, musí být kódován ve formátu UTF-8.

  • Ve schématu plochého souboru se ujistěte, že obsažené skupiny XML nemají příliš velký počet max count vlastnosti nastaven na hodnotu větší než 1. Vyhněte se vnoření skupiny XML s max count hodnotou vlastnosti větší než 1 v jiné skupině XML s max count vlastností větší než 1.

  • Když Azure Logic Apps parsuje schéma plochých souborů a kdykoli schéma umožňuje výběr dalšího fragmentu, Azure Logic Apps vygeneruje symbol a předpověď pro tento fragment. Pokud schéma umožňuje příliš mnoho takových konstruktorů, například více než 100 000, rozšíření schématu se stává příliš velkým, což spotřebovává příliš mnoho prostředků a času.

Nahrání schématu

Po vytvoření schématu teď musíte nahrát schéma na základě následujícího scénáře:

Přidání akce kódování plochých souborů

  1. Na webu Azure Portal otevřete pracovní postup aplikace logiky v návrháři, pokud ještě není otevřený.

  2. Pokud váš pracovní postup nemá aktivační událost nebo žádné jiné akce, které váš pracovní postup potřebuje, přidejte nejprve tyto operace. Operace s plochým souborem nemají k dispozici žádné aktivační události.

    Tento příklad pokračuje triggerem požadavku s názvem Při přijetí požadavku HTTP.

  3. V návrháři pracovního postupu v kroku, do kterého chcete přidat akci Plochý soubor, vyberte Nový krok.

  4. V části Zvolit vyhledávací pole operace vyberte Předdefinované. Do vyhledávacího pole zadejte plochý soubor.

  5. V seznamu akcí vyberte akci s názvem Kódování plochých souborů.

    Snímek obrazovky znázorňující návrháře pracovního postupu Azure Portal a Consumption s vybranou akcí

  6. Ve vlastnosti Obsah akce zadejte výstup z triggeru nebo předchozí akce, kterou chcete kódovat pomocí následujícího postupu:

    1. Klikněte do pole Obsah , aby se zobrazil seznam dynamického obsahu.

    2. V seznamu dynamického obsahu vyberte plochý obsah souboru, který chcete zakódovat.

      V tomto příkladu v seznamu dynamického obsahu v části Při přijetí požadavku HTTP vyberte token Body , který představuje výstup základního obsahu z triggeru.

    Snímek obrazovky zobrazující návrháře pracovního postupu Consumption a vlastnost Obsah se seznamem dynamického obsahu a vybraným obsahem pro kódování

    Poznámka:

    Pokud se vlastnost Text nezobrazí v seznamu dynamického obsahu, vyberte Zobrazit více vedle popisku oddílu Při přijetí požadavku HTTP. Do pole Obsah můžete také přímo zadat obsah, který chcete kódovat.

  7. V seznamu Název schématu vyberte schéma.

    Snímek obrazovky znázorňující návrháře pracovního postupu Consumption a otevření seznamu Název schématu s vybraným schématem pro kódování

    Poznámka:

    Pokud je seznam schémat prázdný, prostředek aplikace logiky není propojený s vaším účtem integrace nebo váš účet integrace neobsahuje žádné soubory schématu.

    Po dokončení bude vaše akce vypadat nějak takto:

    Snímek obrazovky znázorňující pracovní postup Consumption s dokončenou akcí Kódování plochých souborů

  8. Pokud chcete do akce přidat další volitelné parametry, vyberte tyto parametry ze seznamu Přidat nový parametr .

    Parametr Hodnota Popis
    Režim generování prázdných uzlů ForcedDisabled nebo HonorSchemaNodeProperty nebo ForcedEnabled Režim, který se má použít pro generování prázdných uzlů s kódováním plochého souboru.

    Pro BizTalk má schéma plochého souboru vlastnost, která řídí generování prázdných uzlů. U schématu plochého souboru můžete použít chování vlastnosti generování prázdných uzlů nebo můžete toto nastavení použít k vygenerování nebo vynechání prázdných uzlů Azure Logic Apps. Další informace naleznete v tématu Značky pro prázdné prvky.
    Normalizace XML Ano nebo Ne Nastavení pro povolení nebo zakázání normalizace XML v kódování plochého souboru. Další informace naleznete v tématu XmlTextReader.Normalization.
  9. Uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Přidání akce dekódování plochého souboru

  1. Na webu Azure Portal otevřete pracovní postup aplikace logiky v návrháři, pokud ještě není otevřený.

  2. Pokud váš pracovní postup nemá aktivační událost nebo žádné jiné akce, které váš pracovní postup potřebuje, přidejte nejprve tyto operace. Operace s plochým souborem nemají k dispozici žádné aktivační události.

    Tento příklad pokračuje triggerem požadavku s názvem Při přijetí požadavku HTTP.

  3. V návrháři pracovního postupu v kroku, do kterého chcete přidat akci Plochý soubor, vyberte Nový krok.

  4. V části Zvolit vyhledávací pole operace vyberte Předdefinované. Do vyhledávacího pole zadejte plochý soubor.

  5. V seznamu akcí vyberte akci s názvem Dekódování plochého souboru.

    Snímek obrazovky znázorňující návrháře pracovního postupu Azure Portal a Consumption s vybranou akcí

  6. Ve vlastnosti Obsah akce zadejte výstup z triggeru nebo předchozí akce, kterou chcete dekódovat pomocí následujícího postupu:

    1. Klikněte do pole Obsah , aby se zobrazil seznam dynamického obsahu.

    2. V seznamu dynamického obsahu vyberte plochý obsah souboru, který chcete zakódovat.

      V tomto příkladu v seznamu dynamického obsahu v části Při přijetí požadavku HTTP vyberte token Body , který představuje výstup základního obsahu z triggeru.

    Snímek obrazovky znázorňující návrháře pracovního postupu Consumption a vlastnost Obsah se seznamem dynamického obsahu a vybraným obsahem pro dekódování

    Poznámka:

    Pokud se vlastnost Text nezobrazí v seznamu dynamického obsahu, vyberte Zobrazit více vedle popisku oddílu Při přijetí požadavku HTTP. Do pole Obsah můžete také přímo zadat obsah, který chcete kódovat.

  7. V seznamu Název schématu vyberte schéma.

    Snímek obrazovky znázorňující návrháře pracovního postupu Consumption a otevření seznamu Název schématu s vybraným schématem pro dekódování

    Poznámka:

    Pokud je seznam schémat prázdný, prostředek aplikace logiky není propojený s vaším účtem integrace nebo váš účet integrace neobsahuje žádné soubory schématu.

    Po dokončení bude vaše akce vypadat nějak takto:

    Snímek obrazovky znázorňující pracovní postup Consumption s dokončenou akcí Dekódování plochého souboru

  8. Uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Teď jste hotovi s nastavením akce dekódování plochého souboru. V reálné aplikaci můžete chtít dekódovaná data ukládat do obchodní aplikace, jako je Salesforce. Nebo můžete dekódovaná data odeslat obchodnímu partnerovi. Pokud chcete odeslat výstup akce dekódování do Salesforce nebo obchodnímu partnerovi, použijte ostatní konektory dostupné v Azure Logic Apps:

Otestování pracovního postupu

Pokud chcete aktivovat pracovní postup, postupujte takto:

  1. V triggeru požadavku vyhledejte vlastnost ADRESY URL HTTP POST a zkopírujte adresu URL.

  2. Otevřete nástroj požadavku HTTP a pomocí jeho pokynů odešlete požadavek HTTP na zkopírovanou adresu URL, včetně metody, kterou trigger požadavku očekává.

    Tento příklad používá metodu POST s adresou URL.

  3. Do textu požadavku zahrňte obsah XML, který chcete kódovat nebo dekódovat.

  4. Po dokončení spuštění pracovního postupu přejděte do historie spuštění pracovního postupu a prozkoumejte vstupy a výstupy akce Plochý soubor.

Další kroky