Självstudie: Skapa och aktivera en Fabric Activator-regel

Fabric Activator i Microsoft Fabric gör att du kan vidta åtgärder när den identifierar mönster eller villkor i dataströmmar. Om du är nybörjare på Fabric Activator kan du läsa Vad är Fabric Activator. I den här självstudien använder du exempeldata som ingår i Fabric Activator för att utföra följande uppgifter:

  • Granska ett exempel på ett Activator-objekt
  • Utforska data
  • Utforska en regel
  • Starta regeln
  • Skapa ett -objekt
  • Skapa en regel

Förutsättningar

Innan du börjar behöver du en arbetsyta med Fabric-kapacitet. Mer information om Fabric arbetsytor finns i artikeln Workspaces. Om du inte har Fabric uppmanas du att starta en utvärderingsversion.

Skapa en exempelaktivator

  1. På Fabric-startsidan, i vänstra navigationspanelen, välj ellipsen (...), och välj sedan Skapa.

    Skärmbild som visar det vänstra navigeringsfönstret med Skapa markerat.

  2. På sidan Skapa , under Real-Time Intelligens, välj Aktiverare.

    Skärmdump som visar Skapa-sidan med Aktivator vald.

  3. På sidan Aktiverare väljer du Prova exempel.

    Skärmbild som visar alternativet att lägga till data eller använda exempeldata.

Utforska data

I detta steg utforskar du händelseströmsdata som provet bygger på.

Det nya Activator-föremålet har en Explorer-sektion . Scrolla ned och välj dataströmmen Paketleveranshändelser.

Skärmbild av Activator med strömmen Paketleverans-händelser vald.

Dessa händelser visar realtidsstatusen för paket som håller på att levereras.

Titta på inkommande händelser och hovra över händelsedata i livetabellen. Varje datapunkt innehåller information om händelsen. Du kan behöva skrolla för att se allt.

Utforska en regel

Använd en regel för att ange de händelsevärden som du vill övervaka, de villkor som du vill identifiera och de åtgärder som du vill Fabric Activator ska utföra.

Explorer-fönstret visar objekt, till exempel eventstreams, för den här aktivatorn. Leveranshändelser är ett av objekten som skapas från händelseströmmen 'Paketleveranshändelser' .

  1. I fönstret Utforskaren väljer du objektet Leveranshändelser. Du kan skapa regler för objekt som använder data från Paketleveranshändelser händelseströmmen. Till exempel en regel som kontrollerar paketens temperatur.

    Skärmbild som visar tabellen Leveranshändelser och kolumnen temperatur.

  2. Observera att avsnittet Händelser efter objekt-ID ordnas efter paket-ID. Paket-ID är det kolumn-ID som unikt identifierar varje paket. Använd detta unika ID för att tilldela pakethändelser till paketobjekt.

    Skärmbild som visar den unika ID-kolumnen på skärmen Händelser efter objekt-ID.

  3. Välj temperaturregeln Temperature som heter För varmt för medicin. I den högra rutan, titta på Definitionspanelen för att se hur regeln fungerar.

    Skärmbild som visar exempelregeln.

  4. I avsnittet Övervaka väljer du Temperatur. Temperaturvärdena kommer från kolumnen Temperatur i tabellen Leveranshändelser . Du kan se kolumnen Temperatur i en tidigare skärmbild.

    Skärmbild som visar avsnittet Övervaka i fönstret Definition.

  5. I avsnittet Villkor ser du regelvillkoret för att övervaka temperaturer som är högre än 20 grader Celsius.

    Skärmbild som visar avsnittet Villkor i fönstret Definition.

  6. Rulla längre ned till egenskapsfiltret . Regeln gäller endast för paket som innehåller medicin. I tabellen Leveranshändelser tittar regeln på kolumnen med namnet Specialvårdsinnehåll. I kolumnen särskild vård innehåll har vissa paket värdet Medicin.

    Skärmbild som visar avsnittet Egenskapsfilter i fönstret Definition.

  7. Scrolla ner till Action. Välj en av följande åtgärder att vidta när villkoret är uppfyllt:

    1. Skicka e-postavisering: Skickar ett e-postmeddelande till dig själv eller till andra i din organisation.

      1. För Välj åtgärd väljer du Skicka e-post.
      2. För Till, ange mottagarnas e-postadresser eller använd rullgardinsmenyn för att välja en egenskap vars värde är en e-postadress. Din e-postadress fylls i här som standard.
      3. För Ämne anger du ämnet för e-postmeddelandet.
      4. För Rubrik anger du rubriken för e-postmeddelandet.
      5. För Anteckningar anger du anteckningar för e-postmeddelandet.

        Anmärkning

        När du anger ämne, rubrik eller anteckningar kan du hänvisa till egenskaper i datan genom att @ skriva eller genom att välja knappen bredvid textrutorna. Till exempel @PackageId.

      6. För kontext, välj de värden från rullgardinsmenyn som du vill inkludera i e-postnotisen.

      Skärmbild som visar avsnittet Åtgärd i fönstret Definition med e-poståtgärd markerad.

    2. Send Microsoft Teams notification: Skickar ett Microsoft Teams meddelande till enskilda användare, en gruppchatt eller en kanal. Du kan anpassa rubrik- och meddelandeinnehållet.

      1. För Select-åtgärden, välj Teams>Meddelande till individer, Gruppchattmeddelande eller Kanalinlägg.
      2. Följ något av följande steg beroende på ditt val:
        • Om du valde Meddelande till individer, ange mottagarnas e-postadresser eller använd rullgardinsmenyn för att välja en egenskap vars värde är en e-postadress. När villkoret är uppfyllt skickar Fabric Activator ett Teams-meddelande till de angivna individerna.
        • Om du valde Gruppchattmeddelande, välj en gruppchatt från rullgardinsmenyn. När villkoret är uppfyllt postar Fabric Activator ett meddelande i gruppchatten.
        • Om du valde Kanalinlägg, välj ett lag och en kanal från rullgardinsmenyerna. När villkoret är uppfyllt postar Fabric Activator ett meddelande till den valda kanalen.
      3. För Rubrik anger du rubriken för Teams-meddelandet.
      4. För Anteckningar anger du anteckningar för Teams-meddelandet.

        Anmärkning

        När du anger ämne, rubrik eller anteckningar kan du hänvisa till egenskaper i datan genom att @ skriva eller genom att välja knappen bredvid textrutorna. Till exempel @PackageId.

      5. För kontext, välj de värden från rullgardinsmenyn som du vill inkludera i Teams-notisen.

      Skärmbild som visar avsnittet Åtgärd i fönstret Definition.

    3. Kör Fabric-aktiviteter: Om du vill konfigurera varningen så att den utlöser en Fabric-pipeline, ett dataflöde, ett Spark-jobb, en anteckningsbok, en funktion, ett kopieringsjobb eller Publicera affärshändelse (förhandsversion) när villkoret uppfylls följer du dessa steg:

      1. För Select-åtgärden, välj Kör Pipeline, Kör Dataflow, Kör Spark-jobb, Kör Notebook, Kör Funktion, Kör kopieringsjobb eller Publicera affärshändelse (förhandsvisning).

      2. Välj Fabric-objekt som ska köras väljer du det Fabric-objekt (pipeline, dataflöde, anteckningsbok, Spark-jobb, funktion, kopieringsjobb eller publicering av affärshändelse (förhandsversion)) från listan.

      3. Välj Add parameter, och ange sedan namnet på parametern för Fabric-objektet och ett värde för det. Du kan lägga till mer än en parameter. Du kan skicka parametrar från aviseringsdata genom att @ skriva eller genom att välja knappen bredvid textrutan. Till exempel @PackageId. Kopieringsjobb accepterar inte parametrar, så detta steg gäller inte för dem.

        Skärmbild som visar avsnittet Åtgärd i fönstret Definition med pipelineåtgärden markerad.

    4. Anpassade åtgärder: Följ dessa steg för att konfigurera aviseringen så att den anropar en anpassad åtgärd när villkoret uppfylls:

      1. För Välj åtgärd väljer du Skapa anpassad åtgärd.

        Skärmbild som visar avsnittet Åtgärd i fönstret Definition med notebook-åtgärden markerad.

      2. Först, skapa regeln. Slutför sedan konfigurationen av den anpassade åtgärden genom att följa stegen i Utlösa anpassade åtgärder (Power Automate-flöden).

      3. Efter att du skapat den anpassade åtgärden, välj din anpassade åtgärd i Definitionspanelen från rullgardinsmenyn Välj åtgärd.

  8. Efter att du konfigurerat din valda åtgärd, välj Create för att spara din Activator-regel.

Du har skapat en Fabric Activator-regel. Regeln körs mot händelseströmmen Paketleveranshändelser . Regeln letar efter förpackningar som innehåller medicin och kontrollerar om temperaturen är över 20 grader Celsius. När temperaturen överstiger 20 grader Celsius skickar regeln ett Teams-meddelande.

Detta exempel på Aktivator-objekt innehåller andra regler. Utforska dem i din egen takt för att se hur de fungerar.

Starta regeln

Nu när du är bekant med de händelser och objekt som används för att skapa en regel startar du regeln.

  1. Välj För varmt för medicin.

  2. Du kan också skicka ett testmeddelande genom att välja Skicka en teståtgärd. Kontrollera först att du är mottagare.

    Skärmbild som visar avsnittet Åtgärd i fönstret Definition med knappen Skicka en teståtgärd markerad.

  3. Du får ett meddelande som liknar följande:

    Skärmbild som visar Teams-exempelmeddelandet.

  4. Välj start. Den här åtgärden aktiverar regeln. Du får ett Teams-meddelande när ett medicinpaket är för varmt. Regeln utlöses flera gånger i timmen.

    Skärmbild som visar startknappen markerad.

  5. Senare kan du inaktivera regeln med hjälp av knappen Stoppa i menyfliksområdet.

    Skärmbild som visar knappen Stoppa i menyfliksområdet markerat.

Skapa ett -objekt

Skapa nu ett eget objekt. I detta avsnitt tar du bort Package-objektet och återskapar det med de egenskaper du ska använda i nästa avsnitt för att bygga en regel.

  1. I fönstret Utforskaren högerklickar du på Paket och väljer Ta bort. I fönstret Ta bort objekt väljer du Ta bort.

    Skärmbild som visar menyn Ta bort i paketobjektet.

  2. Välj dataströmmen Paketleveranshändelser och välj sedan Nytt objekt i menyfliksområdet.

    Skärmbild som visar knappen Nytt objekt i menyfliksområdet.

  3. Följ dessa steg i fönstret Skapa objekt till höger:

    1. Ge det nya objektet namnet Package2.

    2. Välj PackageId som unikt ID.

    3. Välj HoursInTransit och City som egenskaper för objektet.

    4. Välj Skapa.

      Skärmbild som visar fönstret Skapa objekt.

Skapa en regel

Skapa en regel som varnar dig när genomsnittlig transporttid överstiger 25 timmar.

  1. Välj din nya egenskap HoursInTransit. Välj Ny regel i menyfliksområdet.

    Skärmbild som visar knappen Ny regel i menyfliksområdet.

  2. Följ dessa steg i fönstret Definition :

    1. För Övervaka väljer du det attribut som ska övervakas och du kan också lägga till filter.

    2. För Condition, ställ in villkoret att triggas när HoursInTransit är större än 25.

    3. För Åtgärd väljer du ett av alternativen för att skicka ett meddelande i Teams eller e-post.

    4. Välj Spara.

      Skärmbild som visar fönstret Definition.

  3. Du ser regeln under HoursInTransit i utforskarfönstret. Välj regeln. I mittenfönstret väljer du pennikonen längst upp och uppdaterar namnet till Genomsnittlig överföringstid över målet.

    Skärmbild som visar pennikonen för att ändra regelnamnet.

  4. I fönstret Definition till höger väljer du HoursInTransit. Välj sedan Lägg till sammanfattning>Genomsnittlig.

    Skärmbild som visar fönstret Definition med Genomsnittlig aggregering vald.

  5. Ange en aggregeringsfönsterstorlek på fem minuter och en stegstorlek på fem minuter och välj sedan Spara.

    Skärmbild som visar Definitionspanelen med fönstret och stegstorleken.

  6. Övervakningsdiagrammet uppdateras för att återspegla sammanfattningen och ditt regelövervakardiagram ser ut så här.

    Skärmbild av diagrammet över genomsnittlig transittid för aktiveringshandledningen.

  7. Testa regeln genom att välja knappen Skicka mig en teståtgärd. Se till att du får en avisering. Om du använder e-post kan det ta en minut eller två att komma fram.

    Skärmbild som visar knappen Test vald i menyfliksområdet.

  8. Starta regeln genom att välja Spara och starta i fönstret Definition eller genom att välja Starta i menyfliksområdet.

    Skärmbild som visar startknappen i det markerade menyfliksområdet.

    Du skapade ditt första objekt och din första regel. Som nästa steg, försök att sätta upp andra regler på Package2-objektet .

    När du är redo att prova att använda Fabric Activator på dina egna data följer du stegen i artikeln Hämta data för Fabric Activator.

Rensa resurser

När du är klar med de regler som du skapade som en del av självstudien stoppar du dem. Om du inte stoppar reglerna fortsätter du att få regelaviseringar. Du kan också debiteras för bakgrundsbearbetning. Välj varje regel i tur och ordning och välj knappen Stoppa i menyfliksområdet.

Mer information om Microsoft Fabric finns i: