Użyj aktywności Niepowodzenie, aby doprowadzić do niepowodzenia działania potoku z dostosowanym komunikatem o błędzie i kodem błędu.

Czasami możesz chcieć wygenerować błąd w potoku celowo. Działanie wyszukiwania może nie zwrócić pasujących danych, lub działanie skryptu może zakończyć się błędem wewnętrznym. Niezależnie od przyczyny, możesz teraz użyć działania Niepowodzenie w potoku i dostosować zarówno komunikat o błędzie, jak i kod błędu.

Kiedy należy używać działania Niepowodzenie

Działanie Niepowodzenie jest często używane w scenariuszach warunkowych, w których potok ma zakończyć się niepowodzeniem na podstawie określonych warunków:

  • Niepowodzenia walidacji danych: gdy dane nie spełniają standardów jakości
  • Naruszenia logiki biznesowej: gdy reguły biznesowe nie są spełnione
  • Sprawdzanie zależności: gdy wymagane zasoby lub źródła danych są niedostępne
  • Niestandardowa obsługa błędów: jeśli chcesz podać określone informacje o błędach zamiast ogólnych błędów systemowych

Działanie Niepowodzenie jest zwykle połączone z innymi działaniami przy użyciu logiki warunkowej (działanie If Condition) lub umieszczone po działaniach, które mogą powodować warunki błędu.

Warunki wstępne

Aby rozpocząć pracę, należy spełnić następujące wymagania wstępne:

Dodaj aktywność 'Niepowodzenie' do potoku za pomocą interfejsu użytkownika

Aby użyć aktywności Niepowodzenia w Pipeline, wykonaj następujące kroki:

  1. Utwórz nowy potok w obszarze roboczym.

  2. Wyszukaj działanie 'Niepowodzenie' w okienku Aktywności potoku i wybierz je, aby dodać je do obszaru roboczego potoku. Może być konieczne rozwinięcie listy działań po prawej stronie okienka lub skompresowanie ikony programu Outlook bez oznaczania tekstu pod nim, jak pokazano na tej ilustracji, w zależności od szerokości okna przeglądarki.

    Zrzut ekranu przedstawiający interfejs użytkownika Fabric z wyróżnionym panelem Aktywności i aktywnością Niepowodzenie.

  3. Wybierz nową aktywność 'Niepowodzenie' na płótnie, jeśli nie została jeszcze wybrana.

    Zrzut ekranu przedstawiający kartę Ustawienia ogólne aktywności Niepowodzenie.

    Zapoznaj się z wskazówkami dotyczącymi ustawień ogólnych, aby skonfigurować kartę ustawień ogólnych.

  4. Wybierz kartę Ustawienia i podaj niestandardowy komunikat o błędzie oraz kod błędu, które chcesz, aby potok zgłaszał podczas wywołania działania. Te wartości będą wyświetlane w historii uruchamiania potoku i dziennikach po wykonaniu aktywności Niepowodzenie, pomagając zidentyfikować określony warunek błędu, który spowodował niepowodzenie potoku.

    Zrzut ekranu przedstawiający kartę ustawień działania nieudanego i wyróżnioną kartę.

Zapisz i uruchom lub zaplanuj potok

Działanie Niepowodzenie jest zwykle używane z innymi działaniami, więc po skonfigurowaniu innych działań wymaganych dla potoku wykonaj następujące czynności:

Przejdź do karty Narzędzia główne w górnej części edytora potoków i wybierz przycisk zapisz, aby zapisać potok. Wybierz pozycję Uruchom , aby uruchomić ją bezpośrednio, lub Zaplanuj , aby zaplanować przebiegi w określonych godzinach lub interwałach. Aby uzyskać więcej informacji na temat przebiegów potoków, zobacz: Planowanie przebiegów potoków.

Zrzut ekranu przedstawiający kartę Strona główna w edytorze potoków z wyróżnionymi przyciskami Zapisz, Uruchom i Zaplanuj.

Po uruchomieniu możesz monitorować wykonywanie potoku i wyświetlać historię uruchamiania na karcie Dane wyjściowe poniżej kanwy.

Przykład: Awaria rurociągu warunkowego

Oto typowy wzorzec niepowodzenia potoku na podstawie warunków niestandardowych:

  1. Użyj działania If Condition , aby ocenić niestandardowy warunek błędu
  2. W gałęzi True warunku If dodaj działanie Niepowodzenie
  3. Skonfiguruj czynność 'Niepowodzenie' przy użyciu niestandardowego komunikatu o błędzie opisującego określony spełniony warunek.
  4. W gałęzi False kontynuuj normalne wykonywanie procesu

Ten schemat pozwala, aby potok łagodnie uległ awarii z jasnymi komunikatami o błędach w przypadku napotkania określonych warunków biznesowych lub dotyczących danych.

Jak monitorować przebiegi potoków