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 eines Beispiel-Activators

1. Wechseln Sie zum portal Fabric.

2. Wählen Sie im linken Navigationsbereich die Auslassungspunkte (...) und dann "Erstellen" aus.

   

3. Wählen Sie unter " Erstellen" im Abschnitt "Real-Time Intelligenz" die Option "Datenaktivator" aus.

   

4. Wählen Sie auf "Aktivator" die Option "Beispiel testen" aus.

   

Untersuchen der Daten

In diesem Schritt untersuchen Sie die Ereignisstreamdaten, auf denen dieses Beispiel basiert.

Der neue Activator verfügt über einen Explorer-Abschnitt. 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.

Untersuchen einer Regel

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 die Package-Ereignisse Package-Objekten zuzuweisen.

   

3. Wählen Sie die Temperaturregel namens Zu heiß für Arzneimittelaus. Sehen Sie sich im rechten Bereich den Bereich "Definition" 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 abschließend nach unten zu Aktion. Wählen Sie eine der folgenden Aktionen aus, 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. Wählen Sie für die Aktion E-Mail senden aus.
      2. Geben Sie für ToE-Mail-Adressen von Empfängern ein, oder verwenden Sie die Dropdownliste, um eine Eigenschaft auszuwählen, deren Wert eine E-Mail-Adresse ist. Standardmäßig wird Ihre E-Mail hier ausgefüllt.
      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

         Beim Eingeben des Betreffs, der Überschrift oder der Notizen können Sie auf Eigenschaften in den Daten verweisen, indem Sie @ eingeben oder die Schaltfläche neben den Textfeldern auswählen. Beispiel: @BikepointID.

      6. Wählen Sie für "Kontext" die Werte für die Dropdownliste 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. Wählen Sie für "Auswählen"-Aktion "Teams -->Nachricht an Einzelpersonen " oder "Gruppenchatnachricht" oder "Kanalbeitrag" aus.
      2. Führen Sie je nach Auswahl eine der folgenden Schritte aus:
         • Wenn Sie die Option "Nachricht an Einzelpersonen " ausgewählt haben, geben Sie E-Mail-Adressen von Empfängern ein, oder verwenden Sie die Dropdownliste, um eine Eigenschaft auszuwählen, deren Wert eine E-Mail-Adresse ist. Wenn die Bedingung erfüllt ist, wird eine Teams-Nachricht an die angegebenen Personen gesendet.
         • Wenn Sie die Option " Gruppenchatnachricht " ausgewählt haben, wählen Sie in der Dropdownliste einen Gruppenchat aus. Wenn die Bedingung erfüllt ist, wird eine Nachricht in den Gruppenchat gepostet.
         • Wenn Sie die Option "Kanalbeitrag " ausgewählt haben, wählen Sie in den Dropdownlisten ein Team und einen Kanal aus. Wenn die Bedingung erfüllt ist, wird eine Nachricht in den ausgewählten Kanal gepostet.
      3. Geben Sie für Überschrift die Überschrift der Teams-Benachrichtigung ein.
      4. Geben Sie unter Notizen Hinweise zur Teams-Benachrichtigung ein.

         Hinweis

         Beim Eingeben des Betreffs, der Überschrift oder der Notizen können Sie auf Eigenschaften in den Daten verweisen, indem Sie @ eingeben oder die Schaltfläche neben den Textfeldern auswählen. Beispiel: @BikepointID.

      5. Wählen Sie für "Kontext" die Werte für die Dropdownliste aus, die Sie in die Teams-Benachrichtigung aufnehmen möchten.

      

   3. Run Fabric activities: Gehen Sie folgendermaßen vor, um die Warnung so zu konfigurieren, dass eine Fabric-Pipeline, ein Datenfluss, ein Spark-Auftrag, ein Notizbuch oder eine Benutzerdatenfunktion gestartet wird, wenn die Bedingung erfüllt ist:

      1. Wählen Sie für "Auswählen"-Aktion "Pipeline ausführen", "Datenfluss ausführen", "Spark-Auftrag ausführen", "Notizbuch ausführen" oder "Benutzerdatenfunktion ausführen" (Vorschau) aus.

      2. Wählen Sie unter Auswählen eines auszuführenden Fabric-Elements das Fabric-Objekt (Pipeline, Dataflow, Notebook, Spark Job oder Funktion) aus der Liste aus.

      3. Wählen Sie Parameter hinzufügen aus, und geben Sie den Namen des Parameters für das Fabric-Element und einen Wert dafür an. Sie können mehrere Parameter hinzufügen. Sie können Parameter aus den Warnungsdaten übergeben, indem Sie @eingeben oder die Schaltfläche neben dem Textfeld auswählen. Beispiel: @BikepointID.

         

   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. Wie im Abschnitt "Aktionsabschnitt" erwähnt, erstellen Sie zuerst die Regel und führen Sie dann die Einrichtung benutzerdefinierter Aktionen durch, indem Sie die Schritte im Abschnitt Trigger custom actions (Power Automate flows) befolgen.

      3. Nachdem Sie die benutzerdefinierte Aktion erstellt haben, wählen Sie im Definitionsbereich Ihre benutzerdefinierte Aktion aus der Dropdownliste " Aktion auswählen " aus.

   5. Wählen Sie "Erstellen" aus, um Ihre Aktivatorregel zu speichern.

Sie haben eine Fabric-Aktivator-Regel erstellt. Die Regel wird gegen den Ereignisstrom der Paketzustellungsereignisse ausgeführt. Die Regel sucht nach Paketen mit Medikamenten und überprüft, ob die Temperatur inzwischen größer als 20 Grad geworden ist. Wenn die Temperatur über 20 Grad Celsius steigt, wird eine Teams-Nachricht gesendet.

Sehen Sie sich die anderen Regeln an, um zu verstehen, 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

Jetzt wollen wir ein eigenes Objekt erstellen. Löschen Sie in diesem Abschnitt das Package-Objekt. Erneuern Sie sie dann, um während des Transports den Status von Paketen nachzuverfolgen, bei denen die Lieferzeiten mehr als 25 Stunden betragen.

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.

      

Neue Regel erstellen

Erstellen Sie eine Regel, die Sie benachrichtigt, wenn die Lieferzeit einen Schwellenwert ü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. Wählen Sie für "Bedingung" den Typ der Bedingung und des Vorkommens aus.

   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ächste Schritte können Sie versuchen, einige andere Regeln für das 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

• Was ist Fabric Activator?

Weitere Informationen zu Microsoft Fabric finden Sie unter:

• What is Microsoft Fabric?