Używanie działania przełącznika do warunkowego wykonywania gałęzi w potoku

Działanie przełącznika w usłudze Microsoft Fabric działa jak instrukcja switch w języku programowania. Oblicza wyrażenie, dopasuje wynik do przypadku i uruchamia działania w tym przypadku.

Warunki wstępne

Przed rozpoczęciem wykonaj następujące wymagania wstępne:

Dodawanie działania przełącznika do potoku w interfejsie użytkownika

Aby dodać działanie przełącznika, wykonaj następujące kroki:

  1. Utwórz działanie przełącznika
  2. Ustaw wyrażenie oceny i przypadki dla aktywności przełącznika
  3. Konfigurowanie działań sprawy

Utwórz aktywność przełącznika

  1. Utwórz nowy potok w obszarze roboczym.

  2. Na pasku narzędzi potoku Działania wyszukaj pozycję Przełącz, a następnie wybierz ją, aby dodać do kanwy. Jeśli go nie widzisz, wybierz, + aby rozwinąć listę działań.

    Zrzut ekranu interfejsu użytkownika Fabric UI z wyróżnionym okienkiem Działania oraz przełącznikiem działania.

  3. Wybierz nowe działanie przełącznika na kanwie, jeśli nie zostało jeszcze wybrane.

    Zrzut ekranu przedstawiający kartę Ustawienia ogólne działania przełącznika.

Aby uzyskać szczegółowe informacje na karcie Ogólne, zobacz Ustawienia ogólne.

Ustaw wyrażenie oceny i przypadki dla aktywności przełącznika

Wybierz kartę Działania . Przypadek domyślny znajduje się już na liście przypadków.

W polu Wyrażenie wprowadź wartość, którą ma ocenić działanie przełącznika. Możesz użyć zawartości dynamicznej, takiej jak parametry, zmienne systemowe, funkcje i zmienne lokalne.

Aby uzyskać informacje na temat naszego języka wyrażeń i obsługiwanych funkcji, zobacz omówienie języka wyrażeń.

Aby skonfigurować przebieg każdego przypadku:

  1. Na karcie Działania wybierz ikonę ołówka obok sprawy.
  2. Dodaj działania, które powinny być uruchamiane, gdy ten przypadek jest zgodny z wyrażeniem.
  3. Aby dodać więcej przypadków, wybierz pozycję + Dodaj przypadek.

Możesz również dodawać przypadki i konfigurować działania z karty działania przełącznika na kanwie potoku, wybierając + lub ikonę ołówka obok każdego przypadku.

Zrzut ekranu pokazujący zakładkę ustawień aktywności przełącznika, z wyróżnieniem zakładki i miejscem do wyboru nowego połączenia.

Skonfiguruj działania przypadku

Po wybraniu ikony ołówka dla sprawy, Fabric otworzy edytor aktywności sprawy. Ten edytor wygląda jak edytor potoków, ale dotyczy tylko wybranego przypadku.

Dodaj działania, które chcesz uruchomić dla tego przypadku. W tym przykładzie przypadek domyślny zawiera działanie Kopiowania. Sieć szkieletowa uruchamia działanie kopiowania, gdy żaden inny przypadek nie pasuje do wyniku wyrażenia .

Zrzut ekranu przedstawiający okienko edytora działań przypadków dla domyślnego przypadku z dodanym do niego przykładowym działaniem Kopiowania.

W lewym górnym rogu edytora działań sprawy można zobaczyć bieżący pipeline i sprawę. Po zakończeniu wybierz nazwę rurociągu, aby powrócić do głównego edytora rurociągu.

Zapisz i uruchom lub zaplanuj potok

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ę główną w edytorze potoków, z wyróżnioną nazwą karty oraz 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 podstawowy

Ten przykład kieruje przetwarzanie danych na podstawie parametru potoku o nazwie v_string_input.

Nasza operacja przełącznika ROYGBIV switch ocenia wartość v_string_input i uruchamia działania, jeśli pasuje do tej wartości. Jeśli nie ma dopasowania, nie uruchamia żadnych działań, ponieważ przypadek domyślny jest pusty.

W tym przykładzie istnieje siedem przypadków, po jednym dla każdego koloru (czerwony, pomarańczowy, żółty, zielony, niebieski, indigo, fioletowy). Każdy przypadek zawiera jedno działanie Ustaw zmienną, które ustawia wartość v_output na nazwę koloru dla danego przypadku. Wyrażenie jest prostym przyjęciem parametru wejściowegov_string_input, w tym przypadku @pipeline().parameters.v_string_input, ale może to być dowolne wyrażenie, które daje w wyniku wartość.

Zrzut ekranu przedstawiający przykładowe działania ustawiania zmiennych używanych do przygotowania wartości przed oceną przełącznika.

Po uruchomieniu potoku wprowadzamy wartość elementu v_string_input. Jeśli wprowadzimy "niebieski", działanie przełącznika ocenia to wyrażenie, dopasowuje je do przypadku "Niebieski" i uruchamia działanie w tym przypadku, który ustawia v_output na "Niebieski". Jeśli wprowadzimy wartość "lime", nie ma odpowiadającego przypadku, więc działanie przełącznika uruchamia przypadek domyślny, co niczego nie zmienia.

Zrzut ekranu przedstawiający dane wejściowe uruchomienia potoku z wartościami parametrów używanymi przez wyrażenie przełącznika. Dane wejściowe są

Po pomyślnym uruchomieniu potoku z "niebieskim" jako danymi wejściowymi możemy zobaczyć w danych wyjściowych działania Ustaw zmienną w przypadku v_output "Niebieski", który został ustawiony na "Niebieski", potwierdzając, że działanie przełącznika oceniło wyrażenie i uruchomiło prawidłowy przypadek.

Zrzut ekranu przedstawiający przykład pomyślnego uruchomienia potoku po ocenie instrukcji 'switch', pokazujący, że poprawna (niebieska) aktywność została uruchomiona po wprowadzeniu koloru niebieskiego.