Tutorial: Opret og aktiver en Fabric Activator-regel

Fabric Activator i Microsoft Fabric gør det muligt for dig at foretage handlinger, når den opdager mønstre eller betingelser i datastrømme. Hvis du er ny til Fabric Activator, se Hvad er Fabric Activator. I denne vejledning bruger du de eksempeldata, der følger med Fabric Activator, til at udføre følgende opgaver:

  • Gennemgå et eksempel på et Activator-element
  • Udforsk dataene
  • Udforsk en regel
  • Start reglen
  • Opret et objekt
  • Opret en regel

Forudsætninger

Før du begynder, skal du have et arbejdsområde med kapacitet til Fabric. For at lære om Fabric arbejdsområder, se artiklen Workspaces. Hvis du ikke har Fabric, bliver du bedt om at starte en prøveperiode.

Opret en eksempel-aktivator

  1. På Fabric-forsiden, i venstre navigationspanel, vælg ellipsen (...), og vælg derefter Create.

    Skærmbillede, der viser venstre navigationsrude med Opret valgt.

  2. På siden Create , underReal-Time Intelligence, vælg Aktivator.

    Skærmbillede, der viser Create-siden med Activator valgt.

  3. På siden Activator skal du vælge Prøv eksempel.

    Skærmbillede, der viser muligheden for at tilføje data eller bruge eksempeldataene.

Udforsk dataene

I dette trin udforsker du de eventstream-data, som prøven er bygget på.

Den nye Aktivator-genstand har en Explorer-sektion . Rul ned, og vælg streamen Pakkeleveringshændelser .

Skærmbillede af Aktivator, hvor streamen Pakkeleveringshændelser er valgt.

Disse hændelser viser statussen i realtid for pakker, der er ved at blive leveret.

Se på de indgående begivenheder, og hold markøren over hændelsesdataene i livetabellen. Hvert datapunkt indeholder oplysninger om hændelsen. Du skal muligvis rulle for at se det hele.

Udforsk en regel

Brug en regel til at specificere de hændelsesværdier, du vil overvåge, de betingelser du vil opdage, og hvilke handlinger du vil have, at Fabric Activator skal udføre.

Ruden Stifinder viser objekter, f.eks. eventstreams, for denne aktiverer. Leveringshændelser er et af de objekter, der er oprettet ud fra Package delivery-hændelser eventstream.

  1. Vælg objektet Leveringshændelser i ruden Stifinder. Du kan oprette regler om objekter, der bruger data fra hændelsesstrømmen Pakkeleveringshændelser . Det kan f.eks. være en regel, der kontrollerer pakker for temperatur.

    Skærmbillede, der viser tabellen Leveringshændelser og kolonnen Temperatur.

  2. Bemærk, at afsnittet Hændelser efter objekt-id er organiseret efter pakke-id. Pakke-id er det kolonne-id, der entydigt identificerer hver pakke. Brug dette unikke ID til at tildele pakkehændelser til pakkeobjekter.

    Skærmbillede, der viser kolonnen entydigt id på skærmen Hændelser efter objekt-id.

  3. Vælg reglen Temperatur , der kaldes For varm til medicin. I det højre panel kan du se Definition-panelet for at se, hvordan reglen fungerer.

    Skærmbillede, der viser eksempelreglen.

  4. I afsnittet Skærm skal du vælge Temperatur. Temperaturværdierne kommer fra kolonnen Temperatur i tabellen Leveringshændelser . Du kan se kolonnen Temperatur på et tidligere skærmbillede.

    Skærmbillede, der viser afsnittet Overvåg i ruden Definition.

  5. I afsnittet Betingelse kan du se regelbetingelsen for at overvåge temperaturer, der er højere end 20 grader Celsius.

    Skærmbillede, der viser Condition-sektionen i Definition-panelet.

  6. Rul længere ned for at Egenskabsfilter. Reglen gælder kun for pakker, der indeholder medicin. I tabellen Leveringshændelser ser reglen på kolonnen med navnet Indhold af speciel pleje. I kolonnen Special care indhold, nogle af pakkerne har en værdi på Medicine.

    Skærmbillede, der viser sektionen Egenskabsfilter i ruden Definition.

  7. Scroll ned til Action. Vælg en af følgende handlinger, når betingelsen er opfyldt:

    1. Send e-mail-notifikation: Sender en e-mail til dig selv eller til andre i din organisation.

      1. For Vælg handling skal du vælge Send mail.
      2. For Til indtast modtagernes e-mailadresser , eller brug dropdown-listen til at vælge en egenskab, hvis værdi er en e-mailadresse. Din e-mailadresse er som standard udfyldt her.
      3. For Emne indtast emnet for e-mailnotifikationen.
      4. For overskrift, indtast overskriften på e-mailnotifikationen.
      5. For Noter indtast noter til e-mailnotifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du henvise til egenskaber i dataene ved at @ skrive eller vælge knappen ved siden af tekstboksene. F.eks., @PackageId.

      6. For kontekstens skyld vælg de værdier fra dropdown-listen, som du vil inkludere i e-mailnotifikationen.

      Skærmbillede, der viser handlingssektionen i definitionspanelet med valgt e-mailhandling.

    2. Send Microsoft Teams notifikation: Sender en Microsoft Teams notifikation til enkeltpersoner, en gruppechat eller en kanal. Du kan tilpasse titlen og indholdet af beskeden.

      1. For Select-handlingen vælg Teams>Besked til enkeltpersoner, Gruppechatbesked eller Kanal-opslag.
      2. Følg et af disse trin afhængigt af dit valg:
        • Hvis du valgte Besked til enkeltpersoner, indtast modtagernes e-mailadresser , eller brug dropdown-listen til at vælge en egenskab, hvis værdi er en e-mailadresse. Når betingelsen er opfyldt, sender Fabric Activator en Teams-besked til de angivne personer.
        • Hvis du valgte gruppechatbesked, vælg en gruppechat fra rullemenuen. Når betingelsen er opfyldt, poster Fabric Activator en besked i gruppechatten.
        • Hvis du valgte Kanalindlæg, vælg et hold og en kanal fra dropdown-listerne. Når betingelsen er opfyldt, sender Fabric Activator en besked til den valgte kanal.
      3. For Overskrift indtast overskriften i Teams-notifikationen.
      4. For Noter indtaster du noter til Teams-notifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du henvise til egenskaber i dataene ved at @ skrive eller vælge knappen ved siden af tekstboksene. F.eks., @PackageId.

      5. Til kontekst vælger du de værdier fra dropdown-listen, som du vil inkludere i Teams-notifikationen.

      Skærmbillede, der viser afsnittet Handling i ruden Definition.

    3. Kør Fabric-aktiviteter: For at konfigurere alarmen til at starte en Fabric-pipeline, Dataflow, Spark-job, notebook, Function, Copy-job eller Publish business event (preview), når betingelsen er opfyldt, følg disse trin:

      1. For Select-handlingen vælg Kør Pipeline, Kør Dataflow, Kør Spark-job, Kør Notebook, Kør Funktion, Kør Copy-job eller Publicer forretningsbegivenhed (forhåndsvisning).

      2. På Vælg Fabric element at køre vælg det Fabric element (pipeline, dataflow, notesbog, Spark-job, funktion, kopijob eller publicér forretningsbegivenhed (forhåndsvisning)) fra listen.

      3. Vælg Add parameter, og angiv derefter navnet på parameteren for Fabric-elementet og en værdi for det. Du kan tilføje mere end én parameter. Du kan sende parametre fra alarmdataene ved at skrive @ eller vælge knappen ved siden af tekstboksen. F.eks., @PackageId. Kopieringsjobs accepterer ikke parametre, så dette trin gælder ikke for dem.

        Skærmbillede, der viser handlingssektionen i definitionspanelet med pipeline-handling valgt.

    4. Brugerdefinerede handlinger: For at konfigurere alarmen til at kalde en brugerdefineret handling, når betingelsen er opfyldt, følger du disse trin:

      1. For Vælg handling, vælg Opret brugerdefineret handling.

        Skærmbillede, der viser handlingssektionen i definitionspanelet med notesbogshandling valgt.

      2. Først, lav reglen. Derefter fuldfører du opsætningen af brugerdefinerede handlinger ved at følge trinene i Trigger brugerdefinerede handlinger (Power Automate flows).

      3. Efter du har oprettet den brugerdefinerede handling, vælger du i Definition-panelet din brugerdefinerede handling fra rullemenuen Vælg handling.

  8. Når du har konfigureret din valgte handling, vælger du Opret for at gemme din Aktivator-regel.

Du har lavet en Fabric Activator-regel. Reglen kører mod hændelsesstrømmen for pakkeleveringsbegivenheder . Reglen leder efter pakker, der indeholder medicin, og tjekker, om temperaturen er over 20 grader Celsius. Når temperaturen overstiger 20 grader Celsius, sender reglen en Teams-besked.

Dette eksempel på Aktivator-item indeholder andre regler. Udforsk dem i dit eget tempo for at se, hvordan de fungerer.

Start reglen

Nu hvor du er bekendt med de begivenheder og objekter, der bruges til at skabe en regel, så start reglen.

  1. Vælg For varmt til medicin.

  2. Du kan også sende en testmeddelelse ved at vælge Send mig en testhandling. Først, tjek at du er modtageren.

    Skærmbillede, der viser afsnittet Handling i ruden Definition med knappen Send mig en testhandling fremhævet.

  3. Du modtager en besked, der ligner følgende:

    Skærmbillede, der viser Teams-eksempelmeddelelsen.

  4. Vælg Start. Denne handling aktiverer reglen. Du modtager en Teams-meddelelse, når en medicinpakke er for varm. Reglen udløses flere gange i timen.

    Skærmbillede, der viser knappen Start fremhævet.

  5. Senere kan du slå reglen fra ved at bruge Stop-knappen på båndet.

    Skærmbillede, der viser knappen Stop på båndet fremhævet.

Opret et objekt

Skab nu dit eget objekt. I dette afsnit sletter du Package-objektet og genskaber det med de egenskaber, du vil bruge i næste afsnit til at bygge en regel.

  1. Højreklik på Pakke i ruden Stifinder, og vælg Slet. Vælg Slet i vinduet Slet element.

    Skærmbillede, der viser menuen Slet i pakkeobjektet.

  2. Vælg streamen Pakkeleveringshændelser , og vælg derefter Nyt objekt på båndet.

    Skærmbillede, der viser knappen Nyt objekt på båndet.

  3. Følg disse trin i ruden Opret objekt til højre:

    1. Navngiv det nye objekt Package2.

    2. Vælg PackageId som det entydige id.

    3. Vælg HoursInTransit og City som egenskaber for objektet.

    4. Vælg Opret.

      Skærmbillede, der viser ruden Opret objekt.

Opret en regel

Opret en regel, der giver dig besked, når gennemsnitlig transporttid overstiger 25 timer.

  1. Vælg din nye egenskab HoursInTransit . Vælg Ny regel på båndet.

    Skærmbillede, der viser knappen Ny regel på båndet.

  2. I definitionspanelet følger du disse trin:

    1. For Monitor vælger du attributten at overvåge og tilføjer eventuelt filtre.

    2. For Condition skal betingelsen blive aktiveret, når HoursInTransit er større end 25.

    3. For Handling skal du vælge en af mulighederne for at sende en besked i Teams eller e-mail.

    4. Vælg Gem.

      Skærmbillede, der viser definitionspanelet.

  3. Du ser reglen under HoursInTransit i Explorer-panelet. Vælg reglen. Vælg blyantsikonet øverst i den midterste rude, og opdater navnet til Gennemsnitlig transporttid over målet.

    Skærmbillede, der viser blyantikonet for at ændre regelnavnet.

  4. I ruden Definition til højre skal du vælge HoursInTransit. Vælg derefter Tilføj opsummering>Gennemsnit.

    Skærmbillede, der viser ruden Definition med Sammenlægning af gennemsnit valgt.

  5. Angiv en sammenlægningsstørrelse på fem minutter og en trinstørrelse på fem minutter, og vælg derefter Gem.

    Skærmbillede, der viser ruden Definition med vinduet og trinstørrelsen.

  6. Diagrammet Overvåg opdateres for at afspejle opsummering, og diagrammet over regelovervågning ser sådan ud.

    Skærmbillede af diagrammet Gennemsnitlig overførselstid for selvstudium for aktivator.

  7. Test reglen ved at vælge knappen Send mig en testhandling. Sørg for at få en besked. Hvis du bruger e-mail, kan det tage et minut eller to at nå frem.

    Skærmbillede, der viser knappen Test valgt på båndet.

  8. Start reglen ved at vælge Gem og start i ruden Definition eller ved at vælge Start på båndet.

    Skærmbillede, der viser knappen Start på båndet valgt.

    Du har oprettet dit første objekt og din første regel. Som næste skridt kan du prøve at sætte andre regler op på Package2-objektet .

    Når du er klar til at prøve at bruge Fabric Activator på dine egne data, følger du trinene i artiklen Get data for Fabric Activator.

Fjerne ressourcer

Når du er færdig med de regler, du har lavet som en del af tutorialen, så stop dem. Hvis du ikke stopper reglerne, modtager du fortsat regelmeddelelserne. Du kan også pådrage dig gebyrer for baggrundsbehandling. Vælg hver regel ad gangen, og vælg knappen Stop på båndet.

Relateret indhold

For at lære mere om Microsoft Fabric, se:

  • Last updated on