Wymiana komunikatów EDI w partiach lub grupach między partnerami handlowymi w usłudze Azure Logic Apps

Dotyczy: Azure Logic Apps (Consumption + Standard)

W scenariuszach biznesowych (B2B) partnerzy często wymieniają komunikaty w grupach lub partiach. Podczas tworzenia rozwiązania przetwarzania wsadowego za pomocą usługi Azure Logic Apps można wysyłać komunikaty do partnerów handlowych i przetwarzać te komunikaty razem w partiach.

Przetwarzanie komunikatów X12 w wsadach działa tak samo jak przetwarzanie innych komunikatów w wsadach. Wyzwalacz wsadowy służy do zbierania komunikatów w partii. Akcja wsadowa służy do wysyłania komunikatów do partii. Zanim komunikaty trafią do partnera handlowego lub innego miejsca docelowego, dołącz również krok kodowania X12. Aby uzyskać więcej informacji, zobacz Wysyłanie, odbieranie i przetwarzanie zbiorcze komunikatów.

W tym przewodniku pokazano, jak zbudować rozwiązanie do przetwarzania wsadowego komunikatów elektronicznej wymiany danych (EDI), tworząc dwie aplikacje logiczne: nadawcę wsadowego i odbiornik wsadowy. Na przykład to rozwiązanie obsługuje komunikaty X12.

• Odbiornik wsadowy zbiera komunikaty do partii, dopóki nie zostaną spełnione określone kryteria przetworzenia i zwolnienia tych komunikatów. Ten odbiornik partii również koduje komunikaty w pakiecie przy użyciu określonej umowy X12 lub identyfikacji partnerów.

  Najpierw należy utworzyć odbiornik wsadowy jako miejsce docelowe partii. Następnie można wybrać odbiornik wsadowy podczas tworzenia nadawcy wsadowego.

• Przepływ pracy logicznej usługi nadawcy wsadowego wysyła komunikaty do uprzednio utworzonego odbiornika wsadowego.

Odbiorca wsadowy i nadawca wsadowy muszą używać tej samej subskrypcji Azure i regionu Azure. Jeśli tak nie jest, nie możesz wybrać odbiornika wsadowego podczas tworzenia nadawcy wsadowego, ponieważ nie są one widoczne dla siebie.

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji, utwórz bezpłatne konto platformy Azure.

• Podstawowa wiedza na temat tworzenia przepływów pracy aplikacji logiki. Więcej informacji można znaleźć w następującej dokumentacji:

  • Utwórz przepływ pracy aplikacji logiki typu Consumption
  • Tworzenie standardowego przepływu pracy aplikacji logiki

• Konto integracji korzystające z tej samej subskrypcji platformy Azure i powiązane z Twoją aplikacją logiczną.

• Co najmniej dwóch partnerów handlowych w koncie integracyjnym. Każdy partner musi używać kwalifikatora X12 (Standard Carrier Alpha Code) jako tożsamości biznesowej w ustawieniach partnera.

• Istniejąca umowa X12 na koncie integracji.

• Zainstaluj lub użyj narzędzia, które może wysyłać żądania HTTP w celu przetestowania rozwiązania, na przykład:

  • Program Visual Studio Code z rozszerzeniem z witryny Visual Studio Marketplace
  • Invoke-RestMethod w programie PowerShell
  • Microsoft Edge — narzędzie konsoli sieciowej
  • Bruno
  • lok

  Uwaga

  W przypadku scenariuszy, w których masz poufne dane, takie jak poświadczenia, wpisy tajne, tokeny dostępu, klucze interfejsu API i inne podobne informacje, upewnij się, że używasz narzędzia chroniącego dane przy użyciu niezbędnych funkcji zabezpieczeń. Narzędzie powinno działać w trybie offline lub lokalnie, a nie wymagać logowania się do konta online lub synchronizowania danych z chmurą. W przypadku używania narzędzia z tymi cechami można zmniejszyć ryzyko ujawnienia poufnych danych publicznie.

Tworzenie odbiornika partii X12

Przed wysłaniem komunikatów do partii, ta partia musi najpierw istnieć jako partia docelowa. Najpierw utwórz odbiornik wsadowy i uruchom przepływ pracy za pomocą wyzwalacza Batch. W ten sposób podczas tworzenia nadawcy wsadowego można wybrać odbiornik wsadowy.

Odbiornik wsadowy zbiera komunikaty, aż zostaną spełnione określone warunki umożliwiające ich wydanie i przetworzenie. Odbiorcy usługi Batch nie muszą wiedzieć o nadawcach wsadowych, ale nadawcy wsadowi muszą wiedzieć, gdzie wysyłać komunikaty.

1. W witrynie Azure Portal lub programie Visual Studio Code utwórz aplikację logiki o nazwie BatchX12Messages.

2. Jeśli wcześniej nie połączysz aplikacji logiki z kontem integracji, połącz teraz aplikację logiki.

3. Wykonaj następujące ogólne kroki, aby dodać wyzwalacz operacji wsadowych o nazwie wyzwalacz wsadowy.

4. W projektancie wybierz pozycję Wyzwalacz usługi Batch , aby otworzyć okienko informacji o wyzwalaczu.

5. W okienku informacji wybierz tytuł wyzwalacza usługi Batch. Zmień nazwę na *Komunikaty Batch.

6. Na karcie Parametry podaj wartości następujących parametrów:

   Parameter	Wartość	Uwagi
   Tryb	Inline lub IntegrationAccount	Dostępne tylko dla przepływów pracy konsumpcyjnych.
   Nazwa partii	< batch-name>	Nazwa partii do użycia. W tym przykładzie użyto TestBatch. — Przepływy pracy użycia: dostępne tylko wtedy, gdy tryb jest wbudowany. W tym przykładzie użyto TestBatch. — Standardowe przepływy pracy: zawsze dostępne.
   Kryteria wydania	- Na podstawie liczby komunikatów - Na podstawie rozmiaru - Na podstawie harmonogramu	Typ kryteriów wersji wydania do stosowania. — Przepływy pracy użycia: dostępne tylko wtedy, gdy tryb jest wbudowany. — Standardowe przepływy pracy: zawsze dostępne. W tym przykładzie użyto podejścia opartego na liczbie komunikatów i harmonogramie.
   Liczba komunikatów	< liczba całkowita>	Dostępne tylko wtedy, gdy kryteria wydania są oparte na liczbie komunikatów. Określa liczbę komunikatów do zbierania i wydawania. W tym przykładzie użyto 10 jako wartości.
   Interwał	< liczba całkowita>	Dostępne tylko wtedy, gdy kryteria wydania są oparte na harmonogramie. Określa liczbę interwałów czasowych dla cyklu powtarzania. W tym przykładzie użyto 10 jako wartości.
   Częstotliwość	< jednostka czasowa>	Dostępne tylko wtedy, gdy kryteria wydania są oparte na harmonogramie. Określa jednostkę czasu dla powtarzania. W tym przykładzie użyto wartości Minute .

   

   Uwaga

   W tym przykładzie nie skonfigurowaliśmy partycji dla partii. Każda partia używa tego samego klucza partycji. Aby uzyskać więcej informacji na temat partycji, zobacz Utwórz nadawcę partii.

7. Dodaj akcję, która koduje każdą partię:

   1. Wykonaj następujące ogólne kroki , aby dodać akcję X12 o nazwie Batch koduj <dowolną wersję>.

   2. Jeśli wcześniej nie nawiązaliśmy połączenia z kontem integracji, utwórz połączenie teraz.

      1. Podaj nazwę połączenia.
      2. Należy podać wartości dla parametrów identyfikatora konta integracji i SAS URL konta integracji.
      3. Wybierz pozycjęUtwórz nowy.

      

   3. W projektancie wybierz akcję kodera wsadowego, aby otworzyć okno informacji o akcji. Na karcie Parametry podaj wartości dla następujących parametrów. W razie potrzeby wybierz parametry z pozycji Parametry zaawansowane.

      Parameter	opis
      Nazwa umowy X12	Z tej listy wybierz umowę. Uwaga: jeśli lista jest pusta, upewnij się, że połączysz aplikację logiczną z kontem integracji, które ma Twoją umowę.
      BatchName (Nazwa wsadu)	Wybierz to pole, aby wyświetlić opcje wejściowe. Wybierz ikonę oświetlenia, aby otworzyć listę zawartości dynamicznej. Z listy w obszarze Komunikaty usługi Batch wybierz dane wyjściowe wyzwalacza o nazwie Nazwa usługi Batch.
      PartitionName (Nazwa partycji)	Wybierz to pole, aby wyświetlić opcje wejściowe. Wybierz ikonę błyskawicy, aby otworzyć listę zawartości dynamicznej. Z listy w obszarze Komunikaty usługi Batch wybierz pozycję Nazwa partycji.
      Elementy	Wybierz ikonę T, aby przełączyć na wprowadzanie całej tablicy. Wybierz wewnątrz pola Elementy , aby wyświetlić opcje wejściowe. Wybierz ikonę błyskawicy, aby otworzyć listę zawartości dynamicznej. Z tej listy w obszarze Komunikaty usługi Batch wybierz dane wyjściowe wyzwalacza o nazwie Elementy wsadowe.

      

      W polu Elementy :

      

8. Zapisz przepływ pracy.

9. Jeśli używasz programu Visual Studio Code, najpierw wdróż aplikację logiczną odbiornika wsadowego na platformie Azure. W przeciwnym razie nie można wybrać odbiornika wsadowego podczas tworzenia nadawcy wsadowego.

Testowanie przepływu pracy

Aby upewnić się, że odbiornik wsadowy działa zgodnie z oczekiwaniami, możesz dodać akcję HTTP do celów testowych i wysłać komunikat wsadowy do usługi Żądania bin.

1. Wykonaj następujące ogólne kroki , aby dodać akcję HTTP o nazwie HTTP.

2. W projektancie wybierz akcję HTTP, aby otworzyć panel informacji o akcji. Na karcie Parametry podaj wartości następujących parametrów:

   Parameter	opis
   Metoda	Z tej listy wybierz pozycję POST.
   URI	Wygeneruj identyfikator URI dla pojemnika żądania, a następnie wprowadź ten identyfikator URI w tym polu.
   Treść	Wybierz to pole, aby wyświetlić opcje wejściowe. Wybierz ikonę oświetlenia, aby otworzyć listę zawartości dynamicznej. Z tej listy w obszarze Kodowanie w usłudze Batch według nazwy umowy wybierz dane wyjściowe akcji o nazwie Zawartość. Jeśli zawartość nie jest wyświetlana, obok pozycji Kodowanie usługi Batch według nazwy umowy wybierz pozycję Zobacz więcej.

   

3. Zapisz przepływ pracy.

   Przepływ pracy odbiornika wsadowego wygląda następująco:

   

4. Przejdź do następnej sekcji, w której utworzysz nadawcę wsadowego w celu wysyłania komunikatów do odbiorcy wsadowego.

Tworzenie nadawcy wsadowego X12

Teraz potrzebujesz co najmniej jednej aplikacji logicznej, wysyłającej wiadomości do odbiornika wsadowego. Dla każdego nadawcy wsadowego określ odbiornik partii i nazwę partii, zawartość komunikatu i inne ustawienia. Opcjonalnie możesz podać unikatowy klucz partycji, aby podzielić partię na podzestawy i zebrać komunikaty przy użyciu tego klucza.

Przed rozpoczęciem upewnij się, że zostały wykonane następujące zadania:

• Utworzyłeś swój odbiornik wsadowy. Odbiorca wsadowy musi istnieć, gdy tworzysz nadawcę wsadowego. W przeciwnym razie nie można wybrać odbiornika wsadowego jako partii docelowej. Odbiorcy usługi Batch nie muszą wiedzieć o nadawcach wsadowych, ale nadawcy wsadowi muszą wiedzieć, gdzie wysyłać komunikaty.

• Upewnij się, że zarówno odbiornik wsadowy, jak i nadawca wsadowy używają tej samej subskrypcji platformy Azure i regionu platformy Azure. Jeśli tak nie jest, nie możesz wybrać odbiornika wsadowego podczas tworzenia nadawcy wsadowego, ponieważ nie są one widoczne dla siebie.

1. Utwórz kolejną aplikację logiki o nazwie SendX12MessagesToBatch.

2. Wykonaj następujące ogólne kroki , aby dodać wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

3. Wykonaj następujące kroki, aby dodać akcję Operacje wsadowe w zależności od typu aplikacji logiki:

   • Użycie: Wyślij do przepływu pracy uruchamianego przez wyzwalacz wsadowy
   • Standardowa: Wyślij do zbioru

   1. Wykonaj kroki dotyczące typu aplikacji logiki:

      • Użycie: wybierz wcześniej utworzoną akcję BatchX12Messages>Batch_messages>Dodaj.
      • Standardowa: Pomiń ten krok i przejdź do następnego kroku.

4. Na karcie Parametry podaj wartości następujących parametrów:

   Parameter	opis
   Nazwa partii	Nazwa partii zdefiniowana w odbiorniku wsadowym, który jest TestBatch na potrzeby tego przykładu. Ważne: nazwa partii jest weryfikowana w czasie wykonywania i musi być zgodna z nazwą określoną przez odbiornik partii. Zmiana nazwy partii powoduje niepowodzenie nadawcy partii.
   Zawartość wiadomości	Zawartość komunikatu do wysłania, która jest danymi wyjściowymi Treści z wyzwalacza HTTP . Wybierz wewnątrz pola Zawartość wiadomości , aby wyświetlić opcje wprowadzania. Wybierz ikonę błyskawicy, aby otworzyć listę zawartości dynamicznej. Z listy w obszarze HTTP wybierz pozycję Ciało.
   — Użycie: Identyfikator Przepływu Pracy - Standardowa: Nazwa przepływu pracy	— Przepływy pracy związane z konsumpcją: wartość jest wstępnie ustawiona. — Standardowa: Wpisz nazwę wyzwalacza w przepływie pracy odbiornika wsadowego, którym są wiadomości wsadowe w tym przykładzie.
   Nazwa wyzwalacza	— Przepływy pracy związane z konsumpcją: wartość jest wstępnie ustawiona. — Standardowa: wprowadź nazwę wyzwalacza z przepływu pracy odbiornika wsadowego.

   

5. Zapisz przepływ pracy.

   Nadawca wsadowy wygląda jak w poniższym przykładzie:

   

Testowanie przepływów pracy

Aby przetestować swoje rozwiązanie przetwarzania wsadowego, użyj narzędzia do wysyłania żądań HTTP, aby wysłać żądania HTTP POST z komunikatami X12 do nadawcy wsadowego. Jeśli używasz przykładowych wartości, zaczniesz otrzymywać komunikaty X12 w skrzynce żądań, co 10 minut lub w partiach po 10, wszystkie z tym samym kluczem partycji.

Treści powiązane

• Przetwarzanie komunikatów jako partii