Skapa en regel i Fabric Activator

När du för in strömmande data i en aktivator eller tilldelar händelser till objekt kan du skapa regler för att agera på dina data. Aktiveringen av dessa regler kan vara att skicka ett meddelande, till exempel ett e-postmeddelande eller Ett Teams-meddelande. Aktiveringen av dessa regler kan också utlösa ett arbetsflöde, till exempel att starta ett Power Automate flöde.

Aktiverarregler kan också utlösa åtgärder baserat på Fabric händelser och Azure Blob Storage händelser som tas emot via Eventstream, vilket möjliggör händelsedriven orkestrering. Du kan till exempel starta Spark-jobb eller dataflöden när filer hamnar i en blobcontainer. Mer information om hur du ansluter händelsekällor finns i Lägg till ett Fabric Activator-mål till en händelseström.

Förutsättningar

  • En arbetsyta med en Microsoft Fabric-aktiverad kapacitet.

Öppna aktivator

Tips/Råd

Skapande av aviseringar och regelhantering bäddas också in direkt i Fabric Eventstream. Du kan skapa och hantera Aktivatorregler i kontext när du konfigurerar händelseströmmar, utan att växla till en separat Aktiveringsupplevelse.

Börja med att öppna Fabric i webbläsaren.

I navigeringsfönstret väljer du Skapa>Aktivator. Om du inte ser Skapaväljer du ellipserna (...) för att visa fler alternativ.

Välj Prova ett exempel för att skapa en aktivator som är förifylld med exempelhändelser och -objekt.

Definiera ett regelvillkor och en åtgärd

Använd Regler för att ange de värden som du vill övervaka i dina händelser, de villkor som du vill identifiera och de åtgärder som du vill att Activator ska utföra.

Välj dina regeldata

I Activator Explorer väljer du den egenskap eller händelseström som ska övervakas i regeln. Information om egenskaper finns i avsnittet Skapa egenskaper .

När du har valt en egenskap eller händelseström visas en förhandsgranskning av värdena för ett exempel på objektinstanserna.

Anmärkning

Aktivator kan också övervaka publicerade Power BI rapporter och meddela dig när en ny rad visas i ett visuellt tabellobjekt. Du konfigurerar den här övervakningen från Power BI service. Den resulterande regeln kan utlösa samma åtgärder (e-post, Teams, Fabric objekt eller Power Automate). Mer information finns i Skapa en avisering i Power BI rapport.

Activator har stöd för att skapa regler för Fabric Data Warehouse SQL-frågeresultat (förhandsversion). Dessa regler utvärderar en SQL-fråga enligt ett konfigurerbart schema och utlösaråtgärder när villkoren uppfylls, vilket möjliggör regelbunden övervakning av informationslager.

Skapa en ny aktiveringsregel

Om du vill skapa en ny regel väljer du den ström som du nyss lade till. Du ser fönstret Skapa regel till höger. Avsnittet Övervaka i regeln är ifyllt med dataströmmen som du har valt.

Definiera villkoret som ska identifieras

Välj sedan den typ av villkor som du vill identifiera. Du kan använda villkor som kontrollerar:

  • Utför en åtgärd för varje händelse.
  • Utför en åtgärd för varje händelse när ett värde uppfylls.
  • På varje händelse grupperad efter ett fält utför du en åtgärd (till exempel på varje PackageId-händelse när Temperaturen är större än 30)

Välj slutligen om du vill att åtgärden ska skicka ett e-postmeddelande till dig eller skicka ett Teams-meddelande till dig och välj Skapa. Du kan ändra villkoren och åtgärderna senare.

Diagrammen på fliken Definition uppdateras för att visa ett exempel på de händelser som uppfyller de villkor som du anger.

Skärmbild av ett identifieringskort som visar två diagram.

Om du går till fliken Analys visas två diagram. Det första diagrammet visar det totala antalet gånger regeln utlöstes för alla objekt-ID:t som Activator spårar. Använd det här diagrammet för att förstå mängden meddelanden som utlöstes över alla objekt-ID:n. Det andra diagrammet visar det totala antalet gånger regeln aktiverades för de fem objekt-ID:na. Använd det här diagrammet för att bättre förstå om specifika objekt-ID:n bidrar mest till alla aktiveringar som utlöses.

Definiera den åtgärd som ska vidtas

Använd slutligen avsnittet Åtgärd för att välja vad du ska göra när villkoret identifieras.

Skärmbild av att välja en åtgärd när ett villkor identifieras.

Här är de åtgärdstyper som stöds:

  • E-post – Skicka ett e-postmeddelande till de angivna mottagarna.

  • Teams – Skicka ett Teams-meddelande till angivna mottagare, gruppchatt eller kanal.

  • Fabric objekt – Kör vald Fabric pipeline, Fabric anteckningsbok, Fabric Spark jobbdefinition, Fabric dataflöde eller Fabric användardatafunktion. Använd dessa åtgärder för att implementera händelsestyrda pipelines. Mer information finns i Trigger Fabric element.

  • Anpassad åtgärd – Aktivera ett Power Automate flöde.

Skärmbild av avsnittet Åtgärd i användargränssnittet För aktiveringsanvändare.

Olika åtgärdstyper har olika parametrar. Några av dessa parametrar är den e-postadress som du vill skicka till, Teams-kanalen eller gruppchatten, arbetsflödet som du vill starta, ämnesraden eller ytterligare information (kontext). För Kontext kan du välja de ytterligare egenskaper som ska inkluderas i aviseringsmeddelandet.

Du kan också tagga egenskaper genom att ange @ för att lägga till kontext till de åtgärder du skickar. Till exempel: @bikeId.

Om du sammanfattar en egenskap på Övervaka-kortet, skickar åtgärden det ursprungliga värdet av egenskapen snarare än det sammanfattade värdet.

Välj Redigera åtgärd för att se en redigerare med en förhandsgranskning av meddelandet som åtgärden skickar och alternativ för att lägga till mer information i åtgärden.

Testa din regel

När du har skapat en regel testar du den genom att välja Skicka en testavisering till mig. Om du väljer den här knappen hittar du en tidigare händelse där regelaktiveringen är sann och skickar en avisering så att du kan se hur aviseringen ser ut för den händelsen.

  • Testaviseringen skickas alltid till dig, oavsett mottagarfältet i åtgärdskortet .
  • Alternativet Skicka en testavisering är bara aktiverat om du har minst en tidigare händelse som regelvillkoret är sant för.

Starta och stoppa regeln

Regler skapas i ett stoppat tillstånd. Det här tillståndet innebär att systemet inte utvärderar regeln när data flödar in i systemet, och regeln vidtar inga åtgärder som ett resultat. När du har definierat regeln väljer du Spara och börjar för att göra regeln aktiv. Om du inte är redo att starta regeln sparar du den och kommer tillbaka senare. När du är klar väljer du Starta från verktygsfältet för Aktivering för att börja köra utlösaren och vidta åtgärder.

Skärmbild för att starta en avisering.

När du har startat visas Körning i rubrikområdet på regelkortet. Ikonen i Utforskaren visar också att regeln körs. När du startar regeln börjar nya aktiveringar köras mot nya inmatade data. Regeln aktiveras inte för data som redan har matats in. Om du vill stoppa aviseringen väljer du Stoppa.

Om du gör ändringar i regeln (till exempel ändra det villkor som den söker efter) väljer du Uppdatera i verktygsfältet för att se till att regeln som körs använder de nya värdena.

När du tar bort en regel (eller ett objekt) kan det ta upp till fem minuter innan alla serverdelsbearbetningar av data slutförs. Borttagna regler kan fortsätta att övervaka data och vidta åtgärder i enlighet med detta i några minuter efter att du har tagit bort dem.

Skapa egenskaper

Ibland måste du återanvända regellogik i flera regler. Skapa en egenskap för att definiera ett återanvändbart villkor eller mått och referera sedan till egenskapen från flera regler.

Om du vill skapa en egenskap väljer du den ström som du har lagt till i objektet som du är intresserad av, väljer Ny egenskap i menyfliksområdet och väljer sedan den egenskap som du vill använda i regellogik.

Skärmbild av hur du skapar en egenskap för en avisering.

När du har definierat en egenskap kan du referera till den från en eller flera regler. I det här exemplet refererar du till egenskapen TemperaturFör varmt för medicin.

Skärmbild av en för varm paketegenskap för en avisering.

Rensa resurser

Ta bort exempelhändelseströmmen genom att välja ellipserna (...) till höger om Paketleveranshändelser händelseström och välja Ta bort.

Nästa steg

Handledning för Activator

Relaterat innehåll

  • Last updated on