Tutorial: Erstellen und Aktivieren einer Fabric-Activator-Regel

Fabric Aktivator in Microsoft Fabric ermöglicht es Ihnen, Aktionen zu ergreifen, wenn sie Muster oder Bedingungen in Datenströmen erkennt. Wenn Sie mit Fabric Activator noch nicht vertraut sind, lesen Sie Was ist Fabric Activator. In diesem Lernprogramm verwenden Sie die Beispieldaten, die in Fabric Aktivator enthalten sind, um die folgenden Aufgaben auszuführen:

Voraussetzungen

Bevor Sie beginnen, benötigen Sie einen Arbeitsbereich mit einer Fabric-Kapazität. Weitere Informationen zu Fabric Arbeitsbereichen finden Sie im Artikel Workspaces. Wenn Sie nicht über Fabric verfügen, werden Sie aufgefordert, eine Testversion zu starten.

Erstellen Sie einen Beispiel-Aktivator

1. Auf der Fabric-Startseite wählen Sie im linken Navigationsfeld die Ellipse (...) und wählen Sie dann Erstellen.

   

2. Wählen Sie auf der Seite Erstellen unter Real-Time IntelligenceActivator aus.

   

3. Wählen Sie auf der Seite "Aktivator " die Option "Beispiel testen" aus.

   

Untersuchen der Daten

In diesem Schritt untersuchen Sie die Eventstream-Daten, auf denen die Probe basiert.

Der neue Aktivator-Gegenstand hat einen Explorer-Bereich . Scrollen Sie nach unten, und wählen Sie den Stream der Paketzustellungsereignisse aus.

Diese Ereignisse zeigen den Echtzeitstatus von Paketen, die von einem Logistikunternehmen geliefert werden.

Sehen Sie sich die eingehenden Ereignisse an, und fahren Sie mit der Maus über die Ereignisdaten in der Live-Tabelle. Jeder Datenpunkt enthält Informationen zum Ereignis. Möglicherweise müssen Sie scrollen, um alles anzuzeigen.

Eine Regel untersuchen

Verwenden Sie eine Regel, um die Ereigniswerte anzugeben, die Sie überwachen möchten, die Bedingungen, die Sie erkennen möchten, und die Aktionen, die Fabric Aktivator ausführen soll.

Im Explorer-Bereich werden Objekte wie Eventstreams für diesen Activator angezeigt. Zustellungsereignisse ist eines der Objekte, die aus dem Eventstream Paketzustellungsereignis erstellt wurden.

1. Wählen Sie im Explorer-Bereich das Objekt namens Zustellungsereignisseaus. Sie können Regeln zu Objekten erstellen, die Daten aus dem Eventstream für Paketzustellungsereignisse verwenden. Beispielsweise eine Regel, die Pakete auf Temperatur überprüft.

   

2. Beachten Sie, dass der Abschnitt Ereignisse nach Objekt-ID nach Paket-IDorganisiert ist. Die Paket-ID ist die Spalten-ID, die jedes Paket eindeutig identifiziert. Verwenden Sie diese eindeutige ID, um Paket-Events Paketobjekten zuzuweisen.

   

3. Wählen Sie die Temperaturregel namens Zu heiß für Arzneimittelaus. Im rechten Bereich sehen Sie sich den Definitionsbereich an, um zu sehen, wie die Regel funktioniert.

   

4. Wählen Sie im Abschnitt Monitor die Option Temperatur aus. Die Temperaturwerte kommen aus der Temperatur-Spalte in der Zustellungsereignisse-Tabelle. Sie können die Spalte Temperatur in einem früheren Screenshot sehen.

   

5. Im Abschnitt "Bedingung " wird die Regelbedingung zum Überwachen der Temperaturen angezeigt, die höher als 20 Grad Celsius sind.

   

6. Scrollen Sie weiter nach unten zu Eigenschaftsfilter. Die Regel gilt nur für Verpackungen, die Arzneimittel enthalten. In der Tabelle Zustellungsereignisse wird in der Regel die Spalte Betreuungsinhalte angezeigt. In der Spalte Betreuungsinhalte haben einige der Pakete einen Wert für Medizin.

   

7. Scrollen Sie nach unten zu Aktion. Wählen Sie eine der folgenden Maßnahmen, wenn die Bedingung erfüllt ist:

   1. E-Mail-Benachrichtigung senden: Sendet eine E-Mail an sich selbst oder an andere Personen in Ihrer Organisation.

      1. Um die Aktion auswählen, wählen Sie E-Mail senden aus.
      2. Für An geben Sie die E-Mail-Adressen der Empfänger ein oder wählen Sie in der Dropdown-Liste eine Eigenschaft aus, deren Wert eine E-Mail-Adresse ist. Deine E-Mail-Adresse wird standardmäßig hier angegeben.
      3. Geben Sie für "Betreff" den Betreff der E-Mail-Benachrichtigung ein.
      4. Geben Sie für Überschrift die Überschrift der E-Mail-Benachrichtigung ein.
      5. Geben Sie Notizen für die E-Mail-Benachrichtigung ein.

         Hinweis

         Wenn Sie den Betreff, die Überschrift oder die Notizen eingeben, können Sie auf Eigenschaften in den Daten verweisen, indem Sie tippen @ oder den Button neben den Textfeldern auswählen. Beispiel: @PackageId.

      6. Zum Kontext wählen Sie die Werte aus der Dropdown-Liste aus, die Sie in die E-Mail-Benachrichtigung aufnehmen möchten.

      

   2. Send Microsoft Teams notification: Sendet eine Microsoft Teams Benachrichtigung an Einzelpersonen, einen Gruppenchat oder einen Kanal. Sie können den Titel und den Nachrichteninhalt anpassen.

      1. Für die Aktion auswählen wählen Sie Teams>Nachricht an Einzelpersonen, Gruppenchat-Nachricht oder Kanal-Beitrag.
      2. Führen Sie je nach Auswahl eine der folgenden Schritte aus:
         • Wenn Sie 'Nachricht an Einzelpersonen' ausgewählt haben, geben Sie die E-Mail-Adressen der Empfänger ein oder wählen Sie in der Dropdown-Liste eine Eigenschaft aus, deren Wert eine E-Mail-Adresse ist. Wenn die Bedingung erfüllt ist, sendet Fabric Activator eine Teams-Nachricht an die angegebenen Personen.
         • Wenn Sie Gruppenchat-Nachricht gewählt haben, wählen Sie einen Gruppenchat aus der Dropdown-Liste. Wenn die Bedingung erfüllt ist, postet Fabric Activator eine Nachricht im Gruppenchat.
         • Wenn du Kanal-Beitrag gewählt hast, wähle ein Team und einen Kanal aus den Dropdown-Menüs aus. Wenn die Bedingung erfüllt ist, postet Fabric Activator eine Nachricht an den ausgewählten Kanal.
      3. Geben Sie für Überschrift die Überschrift der Teams-Benachrichtigung ein.
      4. Geben Sie unter Notizen Hinweise zur Teams-Benachrichtigung ein.

         Hinweis

         Wenn Sie den Betreff, die Überschrift oder die Notizen eingeben, können Sie auf Eigenschaften in den Daten verweisen, indem Sie tippen @ oder den Button neben den Textfeldern auswählen. Beispiel: @PackageId.

      5. Zum Kontext wählen Sie die Werte aus der Dropdown-Liste aus, die Sie in die Teams-Benachrichtigung aufnehmen möchten.

      

   3. Fabric-Aktivitäten ausführen: Um die Warnung so zu konfigurieren, dass bei erfüllter Bedingung eine Fabric-Pipeline, ein Dataflow, ein Spark-Job, ein Notebook, eine Funktion, ein Copy-Job gestartet oder ein Geschäftsereignis veröffentlicht (Vorschau) wird, gehen Sie wie folgt vor:

      1. Für die Aktion auswählen wählen Sie Pipeline ausführen, Dataflow ausführen, Spark-Job ausführen, Notebook ausführen, Funktion ausführen, Copy Job ausführen oder Business Event veröffentlichen (Vorschau).

      2. Wählen Sie auf Select Fabric Element aus, das ausgeführt werden soll das Fabric Element (Pipeline, Datenfluss, Notizbuch, Spark-Auftrag, Funktion, Kopierauftrag oder Geschäftsereignis veröffentlichen (Vorschau)) aus der Liste aus.

      3. Wählen Sie den Parameter Add und geben Sie dann den Namen des Parameters für das Fabric-Element sowie einen Wert dafür an. Sie können mehrere Parameter hinzufügen. Sie können Parameter aus den Alarmdaten übergeben, indem Sie @ eingeben oder die Schaltfläche neben dem Textfeld auswählen. Beispiel: @PackageId. Kopieraufträge akzeptieren keine Parameter, daher gilt dieser Schritt nicht für sie.

         

   4. Benutzerdefinierte Aktionen: Führen Sie die folgenden Schritte aus, um die Warnung so zu konfigurieren, dass eine benutzerdefinierte Aktion aufgerufen wird, wenn die Bedingung erfüllt ist:

      1. Für "Aktion auswählen" wählen Sie "Benutzerdefinierte Aktion erstellen" aus.

         

      2. Erstens: Erstelle die Regel. Vervollständigen Sie dann die Einrichtung der benutzerdefinierten Aktion, indem Sie die Schritte unter Trigger custom actions (Power Automate flows) ausführen.

      3. Nachdem Sie die benutzerdefinierte Aktion erstellt haben, wählen Sie im Definitionsfeld Ihre benutzerdefinierte Aktion aus dem Dropdown-Menü für Aktionen auswählen .

8. Nachdem du deine ausgewählte Aktion konfiguriert hast, wähle Create aus, um deine Aktivator-Regel zu speichern.

Sie haben eine Fabric-Aktivator-Regel erstellt. Die Regel wird gegen den Ereignisstrom der Paketzustellungsereignisse ausgeführt. Die Regel sucht nach Verpackungen, die Medikamente enthalten, und prüft, ob die Temperatur über 20 Grad Celsius liegt. Wenn die Temperatur 20 Grad Celsius überschreitet, sendet die Regel eine Teams-Nachricht.

Dieses Beispiel-Aktivator-Element enthält weitere Regeln. Erkunde sie in deinem eigenen Tempo, um zu sehen, wie sie funktionieren.

Regel starten

Nachdem Sie nun mit den Ereignissen und Objekten vertraut sind, die zum Erstellen einer Regel verwendet wurden, starten Sie die Regel.

1. Wählen Sie zu heiß für Arzneimittel.

2. Senden Sie optional eine Testnachricht, indem Sie Testbenachrichtigung senden auswählen. Überprüfen Sie zunächst, ob Sie der Empfänger sind.

   

3. Sie erhalten eine Nachricht ähnlich der folgenden:

   

4. Wählen Sie Starten aus. Diese Aktion aktiviert die Regel. Sie erhalten eine Teams-Nachricht, wenn ein Medizinpaket zu heiß ist. Die Regel löst mehrmals pro Stunde aus.

   

5. Später können Sie die Regel mithilfe der Schaltfläche " Beenden " im Menüband deaktivieren.

   

Erstellen eines -Objekts

Erschaffe jetzt ein eigenes Objekt. In diesem Abschnitt löschst du das Package-Objekt und erstellst es mit den Eigenschaften, die du im nächsten Abschnitt zum Erstellen einer Regel verwenden wirst, neu.

1. Klicken Sie im Explorer-Bereich mit der rechten Maustaste auf "Paket", und wählen Sie "Löschen" aus. Wählen Sie im Fenster " Element löschen " die Option "Löschen" aus.

   

2. Wählen Sie den Datenstrom für Paketzustellungsereignisse aus, und wählen Sie dann im Menüband " Neues Objekt" aus.

   

3. Führen Sie im Bereich "Objekt erstellen" rechts die folgenden Schritte aus:

   1. Benennen Sie das neue Objekt Package2.

   2. Wählen Sie PackageId als eindeutige ID aus.

   3. Wählen Sie HoursInTransit und City als Eigenschaften des Objekts aus.

   4. Klicken Sie auf Erstellen.

      

Erstellen einer Regel

Erstellen Sie eine Regel, die Sie benachrichtigt, wenn die durchschnittliche Transitzeit 25 Stunden überschreitet.

1. Wählen Sie die neue HoursInTransit-Eigenschaft aus. Wählen Sie im Menüband Neue Regel aus.

   

2. Führen Sie im Bereich "Definition " die folgenden Schritte aus:

   1. Wählen Sie für Monitor das Zu überwachende Attribut aus, und fügen Sie optional Filter hinzu.

   2. Für Condition setzen Sie die Bedingung so, dass sie ausgelöst wird, wenn HoursInTransit größer als 25 ist.

   3. Wählen Sie für "Aktion" eine der Optionen aus, um eine Nachricht in Teams oder E-Mails zu senden.

   4. Wählen Sie Speichern aus.

      

3. Die Regel wird unter "HoursInTransit " im Explorer-Bereich angezeigt. Wählen Sie die Regel aus. Wählen Sie im mittleren Bereich oben das Bleistiftsymbol aus, und aktualisieren Sie den Namen auf die durchschnittliche Transitzeit oberhalb des Ziels.

   

4. Wählen Sie im Bereich "Definition " rechts " HoursInTransit" aus. Wählen Sie dann Zusammenfassung hinzufügen>Mittelwert aus.

   

5. Legen Sie eine Aggregationsfenstergröße von fünf Minuten und eine Schrittgröße von fünf Minuten fest, und wählen Sie dann " Speichern" aus.

   

6. Das Überwachungsdiagramm wird aktualisiert, um die Zusammenfassung widerzuspiegeln, und das Überwachungsdiagramm Ihrer Regel sieht wie folgt aus.

   

7. Testen Sie Ihre Regel, indem Sie die Schaltfläche Testbenachrichtigung senden auswählen. Stellen Sie sicher, dass Sie eine Benachrichtigung erhalten. Wenn Sie E-Mails verwenden, kann es eine oder zwei Minuten dauern, bis Sie ankommen.

   

8. Starten Sie Ihre Regel, indem Sie Speichern und starten im Definitionsbereich auswählen oder Start im Menüband auswählen.

   

   Sie haben das erste Objekt und die erste Regel erstellt. Als nächsten Schritt versuchen Sie, andere Regeln auf dem Package2-Objekt einzurichten.

   Wenn Sie bereit sind, Fabric Aktivator für Ihre eigenen Daten zu verwenden, führen Sie die Schritte im Artikel Get data for Fabric Activator aus.

Bereinigen von Ressourcen

Wenn Sie mit den Regeln fertig sind, die Sie als Teil des Lernprogramms erstellt haben, beenden Sie sie. Wenn Sie die Regeln nicht beenden, erhalten Sie weiterhin die Regelbenachrichtigungen. Möglicherweise fallen auch Gebühren für die Hintergrundverarbeitung an. Wählen Sie jede Regel wiederum aus, und wählen Sie im Menüband die Schaltfläche Beenden aus.

Zugehöriger Inhalt

• Lernprogramm: Erstellen einer End-to-End-Aktivatorregel mithilfe agentischer KI
• Was ist Fabric Activator?

Weitere Informationen zu Microsoft Fabric finden Sie unter:

• Was ist Microsoft Fabric?