Samouczek: Tworzenie i aktywacja reguły Fabric Activator

Fabric Aktywator w Microsoft Fabric umożliwia wykonywanie akcji podczas wykrywania wzorców lub warunków w strumieniach danych. Jeśli dopiero zaczynasz z Fabric Activator, zobacz Czym jest Fabric Activator. W tym samouczku korzystasz z przykładowych danych zawartych w Fabric Activator, aby wykonać następujące zadania:

  • Przegląd przykładowego aktywatora
  • Eksplorowanie danych
  • Zbadaj regułę
  • Uruchom regułę
  • Utworzenie obiektu
  • Tworzenie reguły

Wymagania wstępne

Przed rozpoczęciem potrzebny jest obszar roboczy z pojemnością Fabric. Aby dowiedzieć się więcej o obszarach roboczych Fabric, zobacz artykuł Workspaces. Jeśli nie masz Fabric, zostanie wyświetlony monit o uruchomienie wersji próbnej.

Tworzenie przykładowego aktywatora

  1. Przejdź do portalu Fabric.

  2. W okienku nawigacji po lewej stronie wybierz wielokropek (...), a następnie wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający okienko nawigacji po lewej stronie z wybraną pozycją Utwórz.

  3. W obszarze Tworzenie, w sekcji Inteligencja czasu rzeczywistego, wybierz pozycję Aktywacja danych.

    Zrzut ekranu przedstawiający stronę tworzenia z wybraną pozycją Data Activator.

  4. Na Aktywatorze wybierz Wypróbuj próbkę.

    Zrzut ekranu przedstawiający opcję dodawania danych lub używania przykładowych danych.

Eksplorowanie danych

W tym kroku zapoznasz się z danymi strumienia zdarzeń utworzonymi na podstawie tego przykładu.

Nowy aktywator zawiera sekcję Eksplorator . Przewiń w dół i wybierz strumień zdarzeń dostarczania paczek.

Zrzut ekranu Activatora z wybranym strumieniem zdarzeń Dostarczania Pakietu.

Te zdarzenia pokazują stan pakietów w czasie rzeczywistym, które są w trakcie dostarczania.

Spójrz na przychodzące zdarzenia i umieść kursor na danych zdarzeń w tabeli na żywo. Każdy punkt danych zawiera informacje o zdarzeniu. Może być konieczne przewinięcie, aby zobaczyć to wszystko.

Zbadaj regułę

Użyj reguły, aby określić wartości zdarzeń, które chcesz monitorować, warunki, które chcesz wykryć, oraz akcje, które mają zostać wykonane Fabric Aktywator.

W okienku Eksploratora są wyświetlane obiekty dla tego aktywatora, takie jak strumienie zdarzeń. Zdarzenia dostawy są jednym z obiektów utworzonych z strumienia zdarzeń dostarczania paczek.

  1. W okienku Eksplorator wybierz obiekt o nazwie Zdarzenia dostarczania. Reguły dotyczące obiektów korzystających z danych można tworzyć ze strumienia zdarzeń dostarczania pakietów. Na przykład reguła, która sprawdza pakiety pod kątem temperatury.

    Zrzut ekranu przedstawiający tabelę zdarzeń dostarczania i kolumnę temperatury.

  2. Zwróć uwagę, że sekcja Zdarzenia według identyfikatora obiektu jest zorganizowana według identyfikatora pakietu. Identyfikator pakietu to identyfikator kolumny, który jednoznacznie identyfikuje każdy pakiet. Użyj tego unikatowego identyfikatora, aby przypisać zdarzenia pakietu do obiektów pakietu.

    Zrzut ekranu przedstawiający unikatową kolumnę ID na ekranie Zdarzenia według identyfikatora obiektu.

  3. Wybierz regułę Temperatura o nazwie Zbyt gorąco dla medycyny. W okienku po prawej stronie zobacz okienko Definicja , aby zobaczyć, jak działa reguła.

    Zrzut ekranu przedstawiający przykładową regułę.

  4. W sekcji Monitorowanie wybierz pozycję Temperatura. Wartości temperatury pochodzą z kolumny Temperatury w tabeli Zdarzeń Dostarczania. Można zobaczyć kolumnę Temperatura na wcześniejszym zrzucie ekranu.

    Zrzut ekranu przedstawiający sekcję Monitor okienka Definicja.

  5. W sekcji Warunek zostanie wyświetlony warunek reguły do monitorowania temperatur, które są wyższe niż 20 stopni Celsjusza.

    Zrzut ekranu przedstawiający sekcję Warunek w okienku Definicja.

  6. Przewiń dalej w dół do filtru właściwości . Reguła dotyczy tylko pakietów zawierających lek. W tabeli zdarzeń dostarczania reguła analizuje kolumnę o nazwie Zawartość specjalnej opieki. W kolumnie zawartość specjalnej opieki niektóre pakiety mają wartość Medycyna.

    Zrzut ekranu przedstawiający sekcję Filtr właściwości okienka Definicja.

  7. Na koniec przewiń w dół do pozycji Akcja. Wybierz jedną z następujących akcji, jeśli warunek jest spełniony:

    1. Wyślij powiadomienie e-mail: Wysyła wiadomość e-mail do siebie lub do innych osób w organizacji.

      1. W obszarze Wybierz akcję wybierz pozycję Wyślij wiadomość e-mail.
      2. W polu Do wprowadź adresy e-mail odbiorców lub użyj listy rozwijanej, aby wybrać właściwość, której wartością jest adres e-mail. Domyślnie adres e-mail jest wypełniany tutaj.
      3. W polu Temat wprowadź temat powiadomienia e-mail.
      4. W polu Nagłówek wprowadź nagłówek powiadomienia e-mail.
      5. W obszarze Uwagi wprowadź notatki dotyczące powiadomienia e-mail.

        Uwaga / Notatka

        Podczas wprowadzania tematu, nagłówka lub notatek można odwoływać się do właściwości w danych, wpisując @ lub wybierając przycisk obok pól tekstowych. Na przykład @BikepointID.

      6. W polu Kontekst wybierz wartości listy rozwijanej, którą chcesz uwzględnić w powiadomieniu e-mail.

      Zrzut ekranu przedstawiający sekcję Akcja okienka Definicja z wybraną akcją wiadomości e-mail.

    2. Wyślij powiadomienie Microsoft Teams: Wysyła powiadomienie Microsoft Teams do osób, czatu grupowego lub kanału. Możesz dostosować tytuł i zawartość wiadomości.

      1. W obszarze Wybierz akcję wybierz pozycję Teams —>wiadomość do osób fizycznych lub wiadomość czatu grupowego lub wpis w kanale.
      2. Wykonaj jedną z następujących czynności w zależności od wybranego wyboru:
        • W przypadku wybrania opcji Wiadomość do osób wprowadź adresy e-mail odbiorników lub użyj listy rozwijanej, aby wybrać właściwość, której wartość jest adresem e-mail. Po spełnieniu warunku do określonych osób jest wysyłany komunikat usługi Teams.
        • Jeśli wybierzesz opcję Wiadomość na czacie grupowym, wybierz czat grupowy z listy rozwijanej. Po spełnieniu warunku zostanie wysłana wiadomość do czatu grupowego.
        • W przypadku wybrania opcji Wpis w kanale wybierz zespół i kanał z list rozwijanych. Po spełnieniu warunku zostanie wysłana wiadomość do wybranego kanału.
      3. W polu Nagłówek wprowadź nagłówek powiadomienia usługi Teams.
      4. W obszarze Uwagi wprowadź notatki dla powiadomienia Teams.

        Uwaga / Notatka

        Podczas wprowadzania tematu, nagłówka lub notatek można odwoływać się do właściwości w danych, wpisując @ lub wybierając przycisk obok pól tekstowych. Na przykład @BikepointID.

      5. W polu Kontekst wybierz wartości listy rozwijanej, którą chcesz uwzględnić w powiadomieniu usługi Teams.

      Zrzut ekranu przedstawiający sekcję Akcja okienka Definicja.

    3. Uruchom działania Fabric: Aby skonfigurować alert w celu uruchomienia potoku Fabric, przepływu danych, zadania platformy Spark, notesu lub funkcji danych użytkownika po spełnieniu warunku, wykonaj następujące kroki:

      1. W obszarze Wybierz akcję wybierz pozycję Uruchom potok, Uruchom przepływ danych, Uruchom zadanie Spark, Uruchom notebook lub Uruchom funkcję danych użytkownika (wersja zapoznawcza).

      2. Na Wybierz element Fabric do uruchomienia wybierz element Fabric (potok, przepływ danych, notes, zadanie platformy Spark lub funkcja) z listy.

      3. Wybierz Dodaj parametr i określ nazwę parametru dla elementu Fabric i jego wartość. Można dodać więcej niż jeden parametr. Parametry można przekazać z danych alertu, wpisując znak @ lub wybierając przycisk obok pola tekstowego. Na przykład @BikepointID.

        Zrzut ekranu przedstawiający sekcję Akcji okienka Definicji z wybraną akcją potoku.

    4. Akcje niestandardowe: Aby skonfigurować alert w celu wywołania akcji niestandardowej po spełnieniu warunku, wykonaj następujące kroki:

      1. W obszarze Wybierz akcję wybierz pozycję Utwórz akcję niestandardową.

        Zrzut ekranu pokazujący sekcję Akcji okienka Definicja z wybraną akcją notatnika.

      2. Jak wspomniano w sekcji Działanie, najpierw utwórz regułę, a następnie dokończ konfigurację akcji niestandardowej, wykonując kroki z Uruchamianie akcji niestandardowych (przepływy Power Automate).

      3. Po utworzeniu akcji niestandardowej w okienku Definicja wybierz akcję niestandardową z listy rozwijanej Wybierz akcję .

    5. Wybierz pozycję Utwórz , aby zapisać regułę aktywatora.

Utworzono regułę aktywatora Fabric. Reguła jest uruchamiana względem strumienia zdarzeń dostarczania pakietów . Reguła szuka pakietów, które mają lek i sprawdza, czy temperatura jest teraz większa niż 20 stopni Celsjusza. Gdy temperatura będzie większa niż 20 stopni Celsjusza, zostanie wysłany komunikat usługi Teams.

Zapoznaj się z innymi regułami, aby dowiedzieć się, jak działają.

Uruchom regułę

Teraz, gdy znasz zdarzenia i obiekty używane do tworzenia reguły, uruchom regułę.

  1. Wybierz pozycję Zbyt gorąco dla medycyny.

  2. Opcjonalnie wyślij komunikat testowy, wybierając pozycję Wyślij mi akcję testową. Najpierw sprawdź, czy jesteś adresatem.

    Zrzut ekranu przedstawiający sekcję Akcja okienka Definicja z wyróżnionym przyciskiem Wyślij mi akcję testową.

  3. Zostanie wyświetlony komunikat podobny do następującego:

    Zrzut ekranu przedstawiający przykładowe powiadomienie usługi Teams.

  4. Wybierz Start. Ta akcja aktywuje regułę. Otrzymasz wiadomość usługi Teams za każdym razem, gdy pakiet leków jest zbyt gorący. Reguła jest uruchamiana wiele razy w ciągu każdej godziny.

    Zrzut ekranu przedstawiający wyróżniony przycisk Start.

  5. Później możesz wyłączyć regułę przy użyciu przycisku Zatrzymaj na wstążce.

    Zrzut ekranu przedstawiający wyróżniony przycisk Zatrzymaj na wstążce.

Utworzenie obiektu

Teraz nadszedł czas, aby utworzyć własny obiekt. W tej sekcji usuń obiekt Package . Następnie utwórz go ponownie, aby śledzić stan pakietów przesyłanych, w których godziny dostawy stają się większe niż 25.

  1. W okienku Eksplorator kliknij prawym przyciskiem myszy pozycję Pakiet, a następnie wybierz polecenie Usuń. W oknie Usuwanie elementu wybierz pozycję Usuń.

    Zrzut ekranu przedstawiający menu Usuń w obiekcie Pakiet.

  2. Wybierz strumień Zdarzenia dostarczania pakietów, a następnie na wstążce wybierz pozycję Nowy obiekt.

    Zrzut ekranu przedstawiający przycisk Nowy obiekt na wstążce.

  3. W okienku Obiekt kompilacji po prawej stronie wykonaj następujące kroki:

    1. Nadaj nowemu obiektowi nazwę Package2.

    2. Wybierz pozycję PackageId jako unikatowy identyfikator.

    3. Wybierz HoursInTransit i City jako właściwości obiektu.

    4. Wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający panel obiektu Build.

Tworzenie nowej reguły

Utwórz regułę, która ostrzega Użytkownika, jeśli czas tranzytowy w dostawie przekracza próg.

  1. Wybierz swoją nową właściwość HoursInTransit. Na wstążce wybierz pozycję Nowa reguła.

    Zrzut ekranu przedstawiający przycisk Nowa reguła na wstążce.

  2. W okienku Definicja wykonaj następujące kroki:

    1. W obszarze Monitor wybierz atrybut do monitorowania i opcjonalnie dodaj filtry.

    2. W polu Warunek wybierz typ warunku i wystąpienia.

    3. W polu Akcja wybierz jedną z opcji wysyłania wiadomości w usłudze Teams lub wiadomości e-mail.

    4. Wybierz Zapisz.

      Zrzut ekranu przedstawiający okienko Definicja.

  3. Reguła jest widoczna w obszarze HoursInTransit w okienku Eksplorator. Wybierz regułę. W środkowym okienku wybierz ikonę ołówka u góry i zaktualizuj nazwę na Średni czas tranzytowy powyżej miejsca docelowego.

    Zrzut ekranu przedstawiający ikonę ołówka, aby zmienić nazwę reguły.

  4. W okienku Definicja po prawej stronie wybierz pozycję HoursInTransit. Następnie wybierz opcję Dodaj podsumowanie>Średnia.

    Zrzut ekranu przedstawiający okienko Definicja z wybraną agregacją Średnia.

  5. Ustaw rozmiar okna agregacji na pięć minut i rozmiar kroku pięć minut, a następnie wybierz pozycję Zapisz.

    Zrzut ekranu przedstawiający okienko Definicja z oknem i rozmiarem kroku.

  6. Wykres monitora jest aktualizowany, aby odzwierciedlić podsumowanie, a wykres monitora Twojej reguły wygląda następująco.

    Zrzut ekranu przedstawiający wykres średniego czasu przejazdu dla samouczka aktywatora.

  7. Przetestuj regułę, wybierając przycisk Wyślij mi akcję testową. Upewnij się, że otrzymasz alert. Jeśli używasz poczty e-mail, może minąć minuta lub dwie, zanim dotrze.

    Zrzut ekranu przedstawiający przycisk Testuj wybrany na wstążce.

  8. Rozpocznij regułę, wybierając pozycję Zapisz i rozpocznij w okienku Definicja lub wybierając pozycję Rozpocznij na wstążce.

    Zrzut ekranu przedstawiający przycisk Start na wybranej wstążce.

    Utworzono pierwszy obiekt i regułę. W następnych krokach możesz spróbować skonfigurować inne reguły w obiekcie Package2 .

    Gdy będziesz gotowy do wypróbowania używania Fabric Activator na własnych danych, wykonaj kroki opisane w artykule Pobierz dane dla Fabric Activator.

Czyszczenie zasobów

Po zakończeniu pracy z regułami utworzonymi w ramach samouczka zatrzymaj je. Jeśli nie wstrzymasz działania reguł, nadal będziesz otrzymywać powiadomienia o regułach. W przypadku przetwarzania w tle mogą być również naliczane opłaty. Wybierz każdą regułę po kolei i naciśnij przycisk Stop na wstążce.

Aby dowiedzieć się więcej na temat Microsoft Fabric, zobacz: