Dodawanie metadanych w celu znajdowania artefaktów B2B w przepływach pracy dla usługi Azure Logic Apps

Dotyczy: Azure Logic Apps (Consumption + Standard)

Aby ułatwić przepływowi pracy szybkie znajdowanie prawidłowych artefaktów typu business-to-business (B2B) używanych podczas wykonywania, można dodawać niestandardowe metadane jako pary klucz-wartość do artefaktów, takich jak partnerzy handlowi, umowy, schematy i mapy. Niestandardowe metadane artefaktów ułatwiają realizację następujących celów lub zadań:

• Wymuszanie konwencji nazewnictwa.
• Obsługa ponownego użycia i unikanie zduplikowanych definicji.
• Przekazywanie ładunków do właściwych etapów kodowania lub dekodowania.
• Zapewnij większą kontrolę nad przenoszeniem artefaktów za pośrednictwem programowania, testowania i produkcji.
• Zastosuj poprawną walidację lub przekształcenie bez zakodowanej logiki.
• Ułatwia śledzenie, śledzenie, ład i inspekcję.
• Łatwość migracji z programu BizTalk Server do usługi Azure Logic Apps.

Na poniższej liście opisano przykładowe przydatne metadane na podstawie typu artefaktu:

Do celów śledzenia oraz zasilania tabel lub pulpitów nawigacyjnych B2B przydatne metadane obejmują właściwości korelacji, takie jak numer wymiany, numer grupy, identyfikator zestawu transakcji, a także identyfikatory przebiegu przepływu pracy, identyfikatory partnerów i umów, stan oraz znaczniki czasu.

W tym przewodniku pokazano, jak dodać metadane do artefaktu na koncie integracji, znaleźć artefakt przy użyciu wbudowanej akcji konta integracji o nazwie Wyszukiwanie artefaktu konta integracji i odwołać się do metadanych artefaktu w przepływie pracy.

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Uzyskaj bezpłatne konto platformy Azure.

• Zasób aplikacji logicznej i przepływ pracy, w których chcesz uzyskać metadane artefaktu i z nich korzystać.

  Przepływ pracy może rozpoczynać się od dowolnego wyzwalacza i wymaga akcji, która obsługuje metadane po pobraniu. W tym przykładzie użyto wyzwalacza żądania o nazwie Po odebraniu żądania HTTP, który może dynamicznie przekazywać nazwę artefaktu z przychodzącego żądania HTTPS.

  Aby uzyskać więcej informacji, zobacz:

  • Tworzenie przepływu pracy Consumption w usłudze Azure Logic Apps

  • Tworzenie standardowego przepływu pracy w usłudze Azure Logic Apps

• Zasób konta integracji zawierający artefakty, do których chcesz dodać metadane.

  Niestandardowe metadane można dodać do następujących artefaktów:

  • Wspólnik
  • Umowa
  • schemat
  • Mapa

  W przykładzie w tym przewodniku używany jest artefakt partnera o nazwie TradingPartner1.

  • Zarówno konto integracji, jak i zasób aplikacji logiki muszą istnieć w tej samej subskrypcji platformy Azure i regionie świadczenia usługi Azure.

  • Przed rozpoczęciem pracy z akcją wyszukiwania artefaktu konta integracji należy połączyć aplikację Logic Apps Consumption lub połączyć aplikację Logic Apps Standard z kontem integracji. Możesz połączyć konto integracji z wieloma zasobami aplikacji logiki Consumption lub Standard, aby współużytkować te same artefakty.

Dodawanie metadanych do artefaktu

Wykonaj następujące kroki, aby dodać niestandardowe metadane dla artefaktu B2B na koncie integracji.

1. W witrynie Azure Portal przejdź do zasobu konta integracji.

2. Na panelu zasobów w obszarze Ustawienia, wybierz kategorię artefaktu.

   W tym przykładzie dodano metadane do artefaktu partnera handlowego, co w tym scenariuszu powoduje, że przykład wybiera Partners.

3. Na stronie kategorii artefaktów wybierz artefakt, a następnie wybierz pozycję Edytuj.

   Poniższy przykład przedstawia stronę edycji artefaktu partnera o nazwie TradingPartner1.

   

4. W obszarze Metadane w kolumnach Klucz i Wartość wprowadź niestandardowe metadane jako parę klucz-wartość. Po zakończeniu wybierz OK.

   W poniższym przykładzie przedstawiono przykładowe metadane jako pary klucz-wartość:

   

5. Aby wyświetlić te metadane w definicji javaScript Object Notation (JSON) dla artefaktu, obok pozycji Edytuj wybierz pozycję Edytuj jako JSON .

   

Znajdowanie artefaktu

Wykonaj następujące kroki, aby znaleźć artefakt i powiązane metadane na koncie integracji. W przykładzie wyszukiwanie dotyczy konkretnego artefaktu partnera handlowego.

1. W witrynie Azure Portal otwórz zasób aplikacji logiki. Otwórz przepływ pracy w projektancie.

2. W projektancie wykonaj następujące ogólne kroki, aby dodać wbudowaną akcję Konto integracji o nazwie Wyszukiwanie artefaktów konta integracji, która znajduje określony artefakt i metadane.

3. Podaj następujące informacje dotyczące artefaktu na podstawie typu przepływu pracy:

   Parameter	Wymagania	Wartość	Description
   - Zużycie: artifactName — Standardowa: Nazwa artefaktu	Tak	< nazwa artefaktu>	Nazwa artefaktu, którą można wprowadzić jako nazwę zakodowaną na stałe lub jako dynamiczne dane wyjściowe z wyzwalacza lub poprzedniej akcji w przepływie pracy.
   - Zużycie: artifactType — Standardowa: Typ artefaktu	Tak	Umowa, mapa, partner lub schemat	Typ artefaktu.

   1. Aby podać nazwę artefaktu jako dane wyjściowe z wyzwalacza lub poprzedniej akcji, wykonaj następujące kroki:

      1. Wybierz wewnątrz pola artifactName lub Nazwa artefaktu, a następnie wybierz ikonę błyskawicy, aby otworzyć listę zawartości dynamicznej.

      2. Na liście dynamicznej w obszarze nazwy wyzwalacza lub akcji wybierz dane wyjściowe określające nazwę artefaktu.

   2. W polu artifactType lub Artifact type (Typ artefaktu) wybierz typ artefaktu. W tym przykładzie typ to Partner.

      

4. Zapisz przepływ pracy.

Odwołania do metadanych artefaktu w przepływie pracy

Wykonaj następujące kroki, aby użyć pobranych metadanych artefaktu w przepływie pracy. Przykład odwołuje się do metadanych z pobranego artefaktu w poprzedniej sekcji.

1. W projektancie, w obszarze akcji przeszukiwanie artefaktów konta integracyjnego, wykonaj następujące ogólne kroki, aby dodać akcję, którą chcesz.

   W tym przykładzie jest kontynuowana wbudowana akcja HTTP , która wysyła żądanie HTTP z przepływu pracy do określonego miejsca docelowego.

2. W okienku akcji podaj informacje o sposobie używania metadanych artefaktu.

   W tym przykładzie użyto routingUrl metadanych jako miejsca docelowego żądania HTTP. W poniższej tabeli przedstawiono przykładowe wartości akcji HTTP w tym przykładzie:

   Parameter	Wymagania	Wartość	Description	Przykładowa wartość
   URI	Tak	< docelowy adres URL>	Adres URL punktu końcowego, w którym chcesz wysłać żądanie.	Aby odwołać się do metadanych partnera routingUrl , wykonaj następujące kroki: 1. Zaznacz w polu URI. 2. Wybierz ikonę funkcji, aby otworzyć edytor wyrażeń. 3. W edytorze wprowadź wyrażenie podobne do poniższego przykładu na podstawie typu przepływu pracy: Zużycie outputs('Integration_Account_Artifact_Lookup')?['properties']?['metadata']['routingUrl'] Standard outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl'] 4. Po zakończeniu wybierz pozycję Dodaj.
   Metoda	Tak	< Metoda HTTP>	Operacja HTTP do uruchomienia.	W tym przykładzie użyto operacji GET .
   Headers	Nie.	< wartości nagłówka>	Wszystkie dane wyjściowe nagłówka z wyzwalacza przechodzą przez akcję HTTP.	Aby przekazać wartość Content-Type z nagłówka wyzwalacza, w obszarze Nagłówki wykonaj następujące kroki dla pierwszego wiersza: 1. W pierwszej kolumnie wprowadź Content-Type jako nazwę nagłówka. 2. W drugiej kolumnie użyj edytora wyrażeń, aby wprowadzić następujące wyrażenie jako wartość nagłówka: triggeroutputs()?['headers']['Content-Type'] Aby przekazać wartość z nagłówka wyzwalacza w obszarze Nagłówki, wykonaj następujące kroki dla drugiego wiersza: 1. W pierwszej kolumnie wprowadź Host jako nazwę nagłówka. 2. W drugiej kolumnie użyj edytora wyrażeń, aby wprowadzić następujące wyrażenie jako wartość nagłówka: triggeroutputs()?['headers']['Host']
   Treść	Nie.	< body-content>	Dowolna inna zawartość przekazywana przez właściwość akcji body.	Aby przekazać wartości artefaktu properties do akcji HTTP , wykonaj następujące kroki: 1. Wybierz wewnątrz pola Treść , a następnie wybierz ikonę pioruna, aby otworzyć listę zawartości dynamicznej. Jeśli żadne dane wyjściowe nie są wyświetlane, wybierz pozycję Zobacz więcej. 2. Z listy zawartości dynamicznej w obszarze Wyszukiwanie artefaktu konta integracji wybierz pozycję Właściwości.

   W przykładowym scenariuszu akcja HTTP używa następujących przykładowych wartości:

   

3. Aby potwierdzić informacje w akcji HTTP, wyświetl definicję JSON swojego przepływu pracy. Na pasku narzędzi projektanta wybierz pozycję Widok kodu.

   Zostanie wyświetlona podstawowa definicja JSON przepływu pracy, na przykład:

   

4. Wróć do projektanta. Na pasku narzędzi widoku kodu wybierz pozycję Projektant.

   Wszystkie wyrażenia wprowadzone w projektancie zostały teraz rozwiązane, na przykład:

   

Treści powiązane

• Dodawanie umów między partnerami