Utbyta EDI-meddelanden i batchar eller grupper mellan affärspartners i Azure Logic Apps

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

I scenarier för företag till företag (B2B) utbyter partner ofta meddelanden i grupper eller batchar. När du skapar en batchlösning med Azure Logic Apps kan du skicka meddelanden till handelspartner och bearbeta dessa meddelanden tillsammans i batchar.

Bearbetning av X12-meddelanden i batchar fungerar på samma sätt som batchbearbetning av andra meddelanden. Du använder en batchtrigger för att samla in meddelanden i en grupp. Du använder en batchåtgärd för att skicka meddelanden till batchen. Innan meddelandena går till handelspartnern eller något annat mål inkluderar du även ett X12-kodningssteg. Mer information finns i Skicka, ta emot och batchprocessmeddelanden.

Den här guiden visar hur du skapar en batchlösning som bearbetar EDI-meddelanden (Electronic Data Interchange) genom att skapa två logikappar, en batch-avsändare och en batchmottagare. Den här lösningen hanterar till exempel X12-meddelanden.

• Batchmottagaren samlar in meddelanden i en batch tills specifika kriterier uppfylls för att släppa och bearbeta dessa meddelanden. Den här batchmottagaren kodar också meddelandena i batchen med hjälp av det angivna X12-avtalet eller partneridentiteterna.

  Du måste först skapa satsmottagaren som satsmål. Du kan sedan senare välja batchmottagaren när du skapar batchsändaren.

• Arbetsflödet för batchsändarlogikappen skickar meddelanden till den tidigare skapade batchmottagaren.

Batchmottagaren och batchsändaren måste använda samma Azure-prenumeration och Azure-region. Om de inte gör det kan du inte välja batchmottagaren när du skapar batch-avsändaren eftersom de inte är synliga för varandra.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har någon prenumeration kan du registrera ett kostnadsfritt Azure-konto.

• Grundläggande kunskaper om hur du skapar arbetsflöden för logikappar. Mer information finns i följande dokumentation:

  • Skapa ett arbetsflöde för förbrukningslogikapp
  • Skapa ett standardarbetsflöde för logikappar

• Ett integrationskonto som använder samma Azure-prenumeration och som är länkat till din logikapp.

• Minst två handelspartner på ditt integrationskonto. Varje partner måste använda X12-beteckningen (Standard Carrier Alpha Code) som företagsidentitet i partnerinställningarna.

• Ett befintligt X12-avtal i ditt integrationskonto.

• 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. Verktyget bör fungera offline eller lokalt och behöver inte logga in på ett onlinekonto eller synkronisera data till molnet. När du använder ett verktyg med dessa egenskaper minskar du risken för att exponera känsliga data för allmänheten.

Skapa X12-batchmottagare

Innan du kan skicka meddelanden till en batch måste batchen först finnas som målbatch. Skapa därför batchmottagaren först och starta arbetsflödet med Batch-utlösaren. På så sätt kan du välja batchmottagaren när du skapar batchsändaren.

Batchmottagaren samlar in meddelanden tills de angivna kriterierna uppfylls för att släppa och bearbeta dessa meddelanden. Batch-mottagare behöver inte känna till batchavsändare, men batchavsändare måste veta var meddelandena ska skickas.

1. I Azure-portalen eller Visual Studio Code skapar du en logikapp med namnet BatchX12Messages.

2. Om du inte tidigare länkade logikappen till ditt integrationskonto länkar du logikappen nu.

3. Följ dessa allmänna steg för att lägga till en Batch Operations-utlösare med namnet Batch-utlösare.

4. I designern väljer du Batch-utlösare för att öppna informationsfönstret för utlösaren.

5. I informationsfönstret väljer du rubriken för Batch-utlösare. Ändra namnet till *Batch-meddelanden.

6. På fliken Parametrar anger du värden för följande parametrar:

   Parameter	Värde	Kommentar
   Läge	Inline eller IntegrationAccount	Endast tillgängligt för förbrukningsarbetsflöden.
   Batchnamn	< batch-name>	Batchnamnet som ska användas. I det här exemplet används TestBatch. – Förbrukningsarbetsflöden: Endast tillgängligt när läge är Inline. I det här exemplet används TestBatch. – Standardarbetsflöden: Alltid tillgängligt.
   Versionskriterier	- Antal meddelanden baserat - Storleksbaserad - Schemabaserat	Den typ av versionskriterier som ska användas. – Förbrukningsarbetsflöden: Endast tillgängligt när läge är Inline. – Standardarbetsflöden: Alltid tillgängligt. I det här exemplet används Meddelandemängdsbaserad och Schemalagd.
   Antal meddelanden	< heltal>	Endast tillgängligt när versionskriterierna baseras på antal meddelanden. Anger antalet meddelanden som ska samlas in och släppas. Det här exemplet används 10 som värde.
   Intervall	< heltal>	Endast tillgängligt när versionskriterierna är schemabaserade. Anger antalet tidsintervall för upprepningen. Det här exemplet används 10 som värde.
   Frekvens	< tidsenhet>	Endast tillgängligt när versionskriterierna är schemabaserade. Anger tidsenheten för upprepningen. I det här exemplet används Minute som värde.

   

   Kommentar

   Det här exemplet konfigurerar inte en partition för batchen. Varje batch använder samma partitionsnyckel. Mer information om partitioner finns i Skapa batch-avsändare.

7. Lägg till en åtgärd som kodar varje batch:

   1. Följ dessa allmänna steg för att lägga till en X12-åtgärd med namnet Batch-koda <valfri version>.

   2. Om du inte tidigare har anslutit till ditt integrationskonto skapar du anslutningen nu.

      1. Ange ett namn på anslutningen.
      2. Ange värden för parameterna Integration Account ID och Integration Account SAS URL.
      3. Välj Skapa ny.

      

   3. I designern väljer du åtgärden batch-encoder för att öppna åtgärdsinformationsfönstret. På fliken Parametrar anger du värden för följande parametrar. Om det behövs väljer du parametrar från Avancerade parametrar.

      Parameter	beskrivning
      Namn på X12-avtal	I den här listan väljer du ditt avtal. Obs! Om listan är tom kontrollerar du att du länkar logikappen till det integrationskonto som har ditt avtal.
      Batchnamn	Välj i den här rutan om du vill visa indataalternativen. Välj belysningsikonen för att öppna listan med dynamiskt innehåll. I listan går du till Batch-meddelanden och väljer utlösarens utdata med namnet Batch-namn.
      Partitionnamn	Välj i den här rutan om du vill visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll. Välj Partitionsnamn under Batch-meddelanden i listan.
      Artiklar	Välj T-ikonen för Växla till indata för hela matrisen. Välj i rutan Objekt för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll. I den här listan går du till Batch-meddelanden och väljer utlösarens utdata med namnet Batched Items.

      

      För rutan Objekt :

      

8. Spara arbetsflödet.

9. Om du använder Visual Studio Code distribuerar du först logikappen för batchmottagare till Azure. Annars kan du inte välja batchmottagaren när du skapar batch-avsändaren.

Testa arbetsflödet

För att se till att batchmottagaren fungerar som förväntat kan du lägga till en HTTP-åtgärd i testsyfte och skicka ett batchmeddelande till tjänsten Förfrågningslager.

1. Följ de här allmänna stegen för att lägga till HTTP-åtgärdenmed namnet HTTP.

2. I designern väljer du HTTP-åtgärden för att öppna åtgärdsinformationsfönstret. På fliken Parametrar anger du värden för följande parametrar:

   Parameter	beskrivning
   Metod	I den här listan väljer du POST.
   URI	Generera en URI för din begärandeplats och ange sedan den URI:n i den här rutan.
   Brödtext	Välj i den här rutan om du vill visa indataalternativen. Välj belysningsikonen för att öppna listan med dynamiskt innehåll. Från den här listan, under Batchkoda efter avtalsnamn, väljer du åtgärdsutdata med namnet Innehåll. Om Innehållet inte visas väljer du Visa mer bredvid Batch-koda efter avtalsnamn.

   

3. Spara arbetsflödet.

   Arbetsflödet för batchmottagaren ser ut som i följande exempel:

   

4. Fortsätt till nästa avsnitt där du skapar en batch-avsändare för att skicka meddelanden till batchmottagaren.

Skapa X12 batch-avsändare

Nu behöver du en eller flera logikappar som skickar meddelanden till batchmottagaren. För varje batch-avsändare anger du batchmottagaren och batchnamnet, meddelandeinnehållet och andra inställningar. Du kan också ange en unik partitionsnyckel för att dela upp batchen i delmängder och samla in meddelanden med den nyckeln.

Kontrollera att du har slutfört följande uppgifter innan du börjar:

• Du har skapat batchmottagaren. Batchmottagaren måste finnas när du skapar batch-avsändaren. Annars kan du inte välja batchmottagaren som destinationsbatch. Batch-mottagare behöver inte känna till batchavsändare, men batchavsändare måste veta var meddelanden ska skickas.

• Kontrollera att både batchmottagaren och batchsändaren använder samma Azure-prenumeration och Azure-region. Om de inte gör det kan du inte välja batchmottagaren när du skapar batch-avsändaren eftersom de inte är synliga för varandra.

1. Skapa en annan logikapp med namnet SendX12MessagesToBatch.

2. Följ de här allmänna stegen för att lägga till utlösaren 'Request' med namnet När en HTTP-förfrågan tas emot.

3. Följ de här allmänna stegen för att lägga till batchåtgärder baserat på din logikappstyp:

   • Förbrukning: Skicka till batchutlösararbetsflöde
   • Standard: Skicka till batch

   1. Följ stegen för typen av logikapp:

      • Förbrukning: Välj din tidigare skapade BatchX12Messages>Batch_messages>Lägg till åtgärd.
      • Standard: Hoppa över det här steget och gå till nästa steg.

4. På fliken Parametrar anger du värden för följande parametrar:

   Parameter	beskrivning
   Batchnamn	Batchnamnet som definierats i batchmottagaren, vilket är TestBatch för det här exemplet. Viktigt: Batchnamnet verifieras vid körning och måste matcha namnet som anges av batchmottagaren. Om batchnamnet ändras misslyckas batchsändaren.
   Meddelandeinnehåll	Det meddelandeinnehåll som ska skickas är Body-utdata från HTTP-triggern. Välj i rutan Meddelandeinnehåll för att visa indataalternativen. Välj blixtikonen för att öppna listan med dynamiskt innehåll. I listan, under HTTP, väljer du Body.
   – Förbrukning: Arbetsflödes-ID – Standard: Arbetsflödesnamn	– Förbrukningsarbetsflöden: Värdet är ifyllt i förväg. – Standard: Ange utlösarnamnet i arbetsflödet för batchmottagaren, vilket är Batch-meddelanden i det här exemplet.
   Utlösarnamn	– Förbrukningsarbetsflöden: Värdet är ifyllt i förväg. – Standard: Ange utlösarnamnet från arbetsflödet för batchmottagaren.

   

5. Spara arbetsflödet.

   Batch-avsändaren ser ut som i följande exempel:

   

Testa dina arbetsflöden

Om du vill testa batchlösningen skickar du HTTP POST-begäranden med X12-meddelanden till batchsändaren från http-begärandeverktyget. Om du använde exempelvärdena börjar du få X12-meddelanden i din begärandeplats, antingen var 10:e minut eller i batchar med 10, alla med samma partitionsnyckel.

Relaterat innehåll

• Bearbeta meddelanden som batchar