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ärmdump som visar den vänstra startpunkten för Prova exempel.

    Följ de guidade instruktionerna för att aktivera exempeldata och utforska Activator-gränssnittet.

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 ner och välj dataströmmen för cykelavläsningar.

Skärmdump av Activator UI Explorer-panelen som visar cykelavläsningar.

Dessa händelser visar cykeldata i realtid.

Titta på inkommande händelser och hovra över händelsedata i livetabellen. Varje datapunkt innehåller information om händelsen. Du kanske behöver scrolla 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. Stationsavläsningar är ett av de objekt som skapas från händelseströmmarna för cykelavläsningar.

  1. I Utforskaren, välj objektet som heter Station readings. Du kan skapa regler om objekt som använder data från händelseströmmen "Bicycles reading events". Till exempel en regel som kontrollerar stationer för tillgång på cyklar.

    Skärmdump som visar cykelstationens avläsningar.

  2. Observera att avsnittet Events by 'BikepointID' är organiserat efter Bikepoint ID. Bikepoint ID är kolumn-ID:t som unikt identifierar varje cykelstation. Använd detta unika ID för att tilldela cykelhändelser till cykelobjekt.

    Skärmdump som visar stationsavläsningarna för bike point-ID.

  3. Välj regeln No_Empty_Docks (som står för antal tomma dockningsplatser) som heter No empty docks (Email). I den högra rutan, titta på Definitionspanelen för att se hur regeln fungerar.

    Skärmdump som visar definitionspanelen för e-postregeln Inga tomma dockningsplatser.

  4. I avsnittet Övervaka, välj No_Empty_Docks. Värdena för antalet tomma dockor kommer från kolumnen No_Empty_Docks i Station readings-tabellen. Du kan se kolumnen No_Empty_Docks i en tidigare skärmdump.

  5. I avsnittet Villkor ser du regelvillkoret för att övervaka antalet tomma lastkajer som är mindre än 1.

    Skärmdump som visar panelen Monitordefinitioner för antal tomma dockningsplatser.

  6. Bläddra längre ner till Egenskapsfilter. Regeln gäller endast stationer på Arlington Street. I tabellen Station Readings tittar regeln på kolumnen som heter Street. I Gata-kolumnen har några av cyklarna värdet Arlington Street.

    Skärmdump som visar fastighetsfiltren, mer specifikt Arlington Street.

  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. I Ämne anger du ämnet för e-postnotisen eller lämnar det som det är.

      4. För Headline, skriv in rubriken på e-postnotisen eller låt det vara som det är.

        1. För Meddelande, ange anteckningar för e-postnotisen.

        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 @No_Empty_Docks.

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

        Skärmdump som visar åtgärdsfönstret med e-poståtgärder valda.

    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 ett av dessa 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 Meddelande, ange anteckningar för Teams-notisen.

        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 @No_Empty_Docks.

      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 Välj åtgärd, välj Kör Åtgärd, Kör Pipeline, Kör Dataflow, Kör Spark-jobb, Kör notebook, Kör funktion, Kör kopieringsjobb eller Publicera affärshändelse.
      2. På Välj Fabric-objekt att köra väljer du Fabric-objektet (Action, pipeline, dataflow, notebook, Spark-jobb, funktion, kopieringsjobb eller publicera affärshändelse) 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 @BikePointID. 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 e-poståtgärd 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ärmdump som visar Åtgärdssektionen i Definitionspanelen med anpassad åtgärd vald.

      1. 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).
      2. 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 Bicycle readings eventstream. Regeln letar efter antalet tomma dockningsplatser som har färre än en cykel och kontrollerar varje gång villkoret uppfylls. När antalet cyklar är mindre än 1 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 No_empty_docks (E-post).

  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 mejl liknande följande:

    Skärmdump som visar aktiveringsmail.

  4. Välj start. Den här åtgärden aktiverar regeln. Du får ett mejl när en dockningsplats har mindre än 1 cykel tillgänglig. Regeln utlöses varje gång villkoret uppfylls.

    Skärmbild som visar startknappen i definitionspanelen.

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

    Skärmdump som visar stoppknappen i det övre menyfliksområdet vald för att stoppa regeln.

Skapa ett -objekt

Skapa nu ett objekt. I denna sektion tar du bort Bike station-objektet och återskapar det med de egenskaper du kommer att använda i nästa avsnitt för att bygga en regel.

  1. I fönstret Explorer, högerklicka på Cykelstation och välj Ta bort. I fönstret Ta bort objekt väljer du Ta bort.

    Skärmdump som visar raderaknappen för cykelstation.

  2. Välj strömmen Cykelläsningar och välj sedan Nytt objekt i menyfliksområdet.

    Skärmdump som visar att man skapar ett nytt objekt från Eventstream.

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

    1. Ge ditt nya objekt namnet Cykelstation.

    2. Välj BikepointID som unikt ID.

    3. Välj No_Bikes, No_Empty_Docks och Street som objektets egenskaper.

    4. Välj Skapa.

      Skärmdump som visar byggobjektspanelen

Skapa en regel

Skapa en regel som varnar dig när antalet tomma dockningsplatser är mindre än 1.

  1. Välj din nya No_Empty_Docks fastighet. Välj Ny regel i menyfliksområdet.

    Skärmdump som visar ny regel – inga tomma dockningspaneler.

  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 Villkor, sätt villkoret att triggas när No_Empty_Docks är mindre än 1.

    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ärmdump som visar definitionspanelen.

  3. Du ser regeln under No_Empty_Docks alert i Utforskaren. Välj regeln. I mittenpanelen, välj pennikonen högst upp och uppdatera namnet till No_Empty_Docks (E-post).

    Skärmdump som visar den nya regeln No_Empty_Docks (e-post).

  4. I definitionspanelen till höger, välj No_Empty_Docks. Välj sedan Lägg till sammanfattning>Maximum.

    Skärmdump som visar panelen Definitioner med rullgardinsmenyn ”Lägg till sammanfattning” inställd på ”Maximum”.

  5. Sätt en aggregeringsfönsterstorlek på en minut och en steglängd på samma som fönsterstorleken, och välj sedan Spara.

    Skärmdump av definitionspanelen som visar sammanfattning satt till Maximal med 1-minuts fönsterstorlek.

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

    Skärmdump av Monitor-diagram som visar sammanfattad data med 1-minutersfönster och steglängd tillämpad.

  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ärmdump av regelredigeraren med knappen 'Send me a test action' markerad i rött.

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

    Skärmdump av regelpanelen med Startknappen markerad på bandet och definitionspanelen öppen.

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å Bike station-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.

Relaterat innehåll

Mer information om Microsoft Fabric finns i:

  • Uppdaterades senast