Koda och avkoda flata filer i Azure Logic Apps

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

Innan du skickar XML-innehåll till en affärspartner i ett B2B-scenario (business-to-business) kanske du vill koda innehållet först. Om du får kodat XML-innehåll måste du avkoda innehållet först. När du skapar ett logikapparbetsflöde i Azure Logic Apps kan du koda och avkoda flata filer med hjälp av de inbyggda anslutningsåtgärderna flatfil och ett platt filschema för kodning och avkodning. Du kan använda flata filåtgärder i logikapparbetsflöden för flera klientorganisationer och standardarbetsflöden för standardlogikappar med en klient.

Inga flatfilutlösare är tillgängliga, men du kan använda valfri utlösare eller åtgärd för att mata in XML-källinnehållet i arbetsflödet. Du kan till exempel använda en inbyggd anslutningsutlösare, en hanterad eller Azure-värdbaserad anslutningsutlösare som är tillgänglig för Azure Logic Apps eller till och med en annan app.

Den här artikeln visar hur du lägger till kodnings- och avkodningsåtgärder för flata filer i arbetsflödet.

• Lägg till en flat filkodnings - eller avkodningsåtgärd i arbetsflödet.
• Välj det schema som du vill använda.

Mer information finns i följande dokumentation:

• Förbrukning jämfört med standardlogikappar
• Inbyggda anslutningsappar för integrationskonto
• Översikt över inbyggda anslutningsappar för Azure Logic Apps
• Hanterade eller Azure-värdbaserade anslutningsappar i Azure Logic Apps

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.

• Logikappens arbetsflöde, tomt eller befintligt, där du vill använda åtgärden FlatFil .

  Om du har ett tomt arbetsflöde använder du alla utlösare som du vill starta arbetsflödet. I det här exemplet används utlösaren Förfrågning .

• Logikappens resurs och arbetsflöde. Flata filåtgärder har inga tillgängliga utlösare, så arbetsflödet måste innehålla en utlösare minimalt. Mer information finns i följande dokumentation:

  • Skapa ett exempel på arbetsflöde för förbrukningslogikapp i Azure Logic Apps med flera klientorganisationer

  • Skapa ett exempel på ett standardarbetsflöde för logikappar i Azure Logic Apps med en enda klientorganisation

• Ett platt filschema för kodning och avkodning av XML-innehållet. Mer information finns i Lägga till scheman som ska användas med arbetsflöden i Azure Logic Apps.

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

  • Om du arbetar med ett arbetsflöde för förbrukningslogikappen kräver logikappresursen en länk till ditt integrationskonto.

  • Om du arbetar med ett standardarbetsflöde för logikappar kan du länka logikappresursen till ditt integrationskonto, ladda upp scheman direkt till logikappresursen 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 scheman till varje enskild logikapp. Mer information finns i Länka logikappresursen till ditt integrationskonto.

    • Med den inbyggda anslutningsappen Flat File kan du välja ett schema som du tidigare laddade upp till din logikappresurs eller till ett länkat integrationskonto, men inte båda. Du kan sedan använda den här artefakten i alla underordnade arbetsflöden i samma logikappresurs.

    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 underordnade arbetsflöden i samma logikappresurs.

• Installera eller använd ett verktyg som kan skicka HTTP-begäranden för att testa din lösning, till exempel:

  • Visual Studio Code med ett tillägg från Visual Studio Marketplace
  • PowerShell Invoke-RestMethod
  • Microsoft Edge – verktyg för nätverkskonsol
  • Bruno
  • hårlock

  Varning

  För scenarier där du har känsliga data, till exempel autentiseringsuppgifter, hemligheter, åtkomsttoken, API-nycklar och annan liknande information, bör du använda ett verktyg som skyddar dina data med nödvändiga säkerhetsfunktioner, fungerar offline eller lokalt, inte synkroniserar dina data till molnet och inte kräver att du loggar in på ett onlinekonto. På så sätt minskar du risken för att exponera känsliga data för allmänheten.

Begränsningar

• XML-innehåll som du vill avkoda måste vara kodat i UTF-8-format.

• I ditt flata filschema kontrollerar du att de inneslutna XML-grupperna inte har alltför många av max count egenskapen inställda på ett värde som är större än 1. Undvik att kapsla en XML-grupp med ett max count egenskapsvärde större än 1 i en annan XML-grupp med en max count egenskap större än 1.

• När Azure Logic Apps parsar det platta filschemat, och när schemat tillåter valet av nästa fragment, genererar Azure Logic Apps en symbol och en förutsägelse för fragmentet. Om schemat tillåter för många sådana konstruktioner, till exempel mer än 100 000, blir schemaexpansionen för stor, vilket förbrukar för mycket resurser och tid.

Ladda upp schema

När du har skapat schemat måste du nu ladda upp schemat baserat på följande scenario:

• Om du arbetar med ett arbetsflöde för förbrukningslogikapp lägger du till schemat i ditt integrationskonto.

• Om du arbetar med ett standardarbetsflöde för logikappar kan du lägga till schemat i ditt integrationskonto eller lägga till schemat i logikappresursen.

Lägg till en kodningsåtgärd för flat fil

Lägg till en avkodningsåtgärd för flat fil

Nu är du klar med att konfigurera avkodningsåtgärden för flata filer. I en verklig app kanske du vill lagra de avkodade data i en verksamhetsspecifik app (LOB), till exempel Salesforce. Eller så kan du skicka de avkodade data till en handelspartner. Om du vill skicka utdata från avkodningsåtgärden till Salesforce eller till din handelspartner använder du de andra anslutningsprogrammen som är tillgängliga i Azure Logic Apps:

• Hanterade anslutningsappar för Azure Logic Apps
• Inbyggda anslutningsappar för Azure Logic Apps

Testa arbetsflödet

Följ dessa steg för att utlösa arbetsflödet:

1. I utlösaren Förfrågning letar du reda på egenskapen HTTP POST URL och kopierar URL:en.

2. Öppna http-begärandeverktyget och använd dess instruktioner för att skicka en HTTP-begäran till den kopierade URL:en, inklusive den metod som begärandeutlösaren förväntar sig.

   I det POST här exemplet används metoden med URL:en.

3. Inkludera DET XML-innehåll som du vill koda eller avkoda i begärandetexten.

4. När arbetsflödet är klart går du till arbetsflödets körningshistorik och undersöker flatfil-åtgärdens indata och utdata.

Nästa steg

• Läs mer om Enterprise Integration Pack