Udostępnij przez


Poradnik: Tworzenie i aktywowanie reguły Aktywatora Fabric

Fabric Activator w usłudze Microsoft Fabric umożliwia podejmowanie działań w przypadku wykrycia wzorców lub warunków w strumieniach danych. Jeśli dopiero zaczynasz pracować z Fabric Activator, zobacz Co to jest Fabric Activator. W tym samouczku użyjesz przykładowych danych dołączonych do Fabric Activator, aby wykonać następujące zadania:

  • Przeglądanie przykładowego aktywatora
  • Eksplorowanie danych
  • Eksplorowanie reguły
  • Uruchamianie reguły
  • Utworzenie obiektu
  • Tworzenie reguły

Wymagania wstępne

Przed rozpoczęciem potrzebny jest obszar roboczy z pojemnością sieć szkieletowa. Więcej informacji na temat obszarów roboczych usługi Fabric można uzyskać w artykule Obszary robocze . Jeśli nie masz usługi Fabric, zostanie wyświetlony monit o uruchomienie wersji próbnej.

Tworzenie przykładowego aktywatora

  1. Przejdź do portalu sieci szkieletowej.

  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. Na stronie Tworzenie, w sekcji Inteligencja w czasie rzeczywistym, wybierz Aktywator Danych.

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

  4. Na stronie Aktywacja wybierz pozycję Wypróbuj przykład.

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

Eksplorowanie danych

W tym kroku eksplorujemy dane strumienia zdarzeń, na których jest oparty ten przykład.

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

Zrzut ekranu Activatora z wybranym strumieniem zdarzeń Dostarczania Pakietu.

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

Przyjrzyj się zdarzeniu przychodzącym i umieść kursor na danych zdarzenia w tabeli na żywo. Każdy punkt danych zawiera informacje o zdarzeniu. Może być konieczne przewinięcie, aby zobaczyć to wszystko.

Eksplorowanie reguły

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

W okienku Eksplorator są wyświetlane obiekty, takie jak strumienie zdarzeń, dla tego aktywatora. 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. Ten unikatowy identyfikator służy do przypisywania zdarzeń 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 Temperature w tabeli Zdarzeń dostarczania. Kolumnę Temperature (Temperatura ) można zobaczyć 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 . Nasza zasada ma zastosowanie tylko do 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 usługi Microsoft Teams: Wysyła do siebie wiadomość usługi Microsoft Teams. 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 wiadomość e-mail jest wysyłana do określonych osób.
        • 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. Uruchamianie działań Fabric: Aby skonfigurować alert w celu uruchomienia potoku Fabric, zadania platformy Spark lub notatnika po spełnieniu warunku, wykonaj następujące kroki:

      1. W obszarze Wybierz akcję wybierz pozycję Uruchom potok, Uruchom zadanie Spark, Uruchom notatnik lub Uruchom funkcję (wersja preview).

      2. Na ekranie "Wybierz element Fabric do uruchomienia", wybierz element Fabric (potok, notatnik, zadanie Spark lub funkcja) z listy.

      3. Wybierz Dodaj parametr i określ nazwę parametru dla elementu Fabric oraz 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łania, najpierw utwórz regułę, a następnie wykonaj konfigurację akcji niestandardowej, wykonując kroki z sekcji Wyzwalanie akcji niestandardowych (przepływy usługi 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.

Utworzyliśmy regułę aktywatora sieci szkieletowej. 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ą.

Uruchamianie reguły

Teraz znasz zdarzenia i obiekty używane do tworzenia reguły. Następnym krokiem jest uruchomienie reguły.

  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. Powinien zostać wyświetlony komunikat podobny do następującego:

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

  4. Wybierz Start. Powoduje to, że reguła stanie się aktywna. Otrzymasz wiadomość usługi Teams za każdym razem, gdy pakiet leków jest zbyt gorący. Reguła powinna być wyzwalana kilka razy co godzinę.

    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 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 powinna być 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. W przypadku korzystania z poczty e-mail może upłynąć minuta lub dwie.

    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 .

    Kiedy jesteś gotowy do wypróbowania użycia Fabric Activator na własnych danych, wykonaj kroki opisane w artykule Pobieranie danych dla Fabric Activator.

Czyszczenie zasobów

Po zakończeniu pracy z regułami utworzonymi w ramach samouczka pamiętaj, aby je zatrzymać. Jeśli nie wstrzymasz działania reguł, nadal będziesz otrzymywać powiadomienia o regułach. Mogą również zostać naliczone opłaty za przetwarzanie w tle. Wybierz każdą regułę z kolei i wybierz przycisk Zatrzymaj na wstążce.

Możesz również dowiedzieć się więcej o usłudze Microsoft Fabric: