Del via

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:

  • Gennemse en eksempelaktivator
  • 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 eksempelaktivator

  1. Gå til Fabric portalen.

  2. I venstre navigationspanel skal du vælge ellipserne (...), og derefter vælge Opret dem.

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

  3. Under Create, under afsnittet Real-Time Intelligence, vælg Data Activator.

    Skærmbillede, der viser siden Opret med Data Activator valgt.

  4. På Activator skal du vælge Try sample.

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

Udforsk dataene

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

Den nye aktivator har en Stifinder-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 Package-begivenhederne til Package-objekter.

    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 ruden til højre skal du se ruden Definition 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. Til sidst skal du rulle ned til Handling. Vælg en af følgende handlinger, hvis betingelsen er opfyldt:

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

      1. For Select-handlingen vælg Send e-mail.
      2. For Til indtast modtagernes e-mailadresser eller brug rullemenuen til at vælge en egenskab, hvis værdi er en e-mailadresse. Som standard er din e-mail 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 ved at vælge knappen ved siden af tekstfelterne. F.eks., @BikepointID.

      6. For kontekstens skyld vælg værdierne til den dropdown-liste, 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 –>Send besked til enkeltpersoner eller Gruppechat-besked, eller Kanal-opslag.
      2. Følg et af disse trin afhængigt af dit valg:
        • Hvis du har valgt indstillingen Besked til enkeltpersoner , skal du angive modtagernes mailadresser eller bruge rullelisten til at vælge en egenskab, hvis værdi er en mailadresse. Når betingelsen er opfyldt, sendes en Teams-besked til de angivne personer.
        • Hvis du har valgt indstillingen Gruppechatbesked , skal du vælge en gruppechat på rullelisten. Når betingelsen er opfyldt, sendes der en besked til gruppechatten.
        • Hvis du har valgt muligheden Kanalpost, vælg et hold og en kanal fra dropdown-listerne. Når betingelsen er opfyldt, postes en besked på 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 ved at vælge knappen ved siden af tekstfelterne. F.eks., @BikepointID.

      5. For kontekst vælger du værdierne til den dropdown-liste, 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, notesbog eller User Data Function, når betingelsen er opfyldt, følger du disse trin:

      1. For Select-handling, vælg Kør Pipeline, Kør Dataflow, Kør Spark-job, Kør Notebook eller Kør User Data Function (forhåndsvisning).

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

      3. Vælg Tilføj parameter og angiv navnet på parameteren for det Fabric element samt en værdi for det. Du kan tilføje mere end én parameter. Du kan sende parametre fra alarmdataene ved at skrive @ eller ved at vælge knappen ved siden af tekstboksen. F.eks., @BikepointID.

        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. Som nævnt i Handling-afsnittet, opret først reglen, og fuldfør derefter opsætningen af brugerdefinerede handlinger ved at følge trinene fra Trigger brugerdefinerede handlinger (Power Automate flows).

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

    5. Vælg Opret for at gemme din Activator-regel.

Du har lavet en Fabric Activator-regel. Reglen kører mod hændelsesstrømmen for pakkeleveringsbegivenheder . Reglen søger efter pakker, der har medicin og kontrollerer, om temperaturen nu er større end 20 grader Celsius. Når temperaturen bliver større end 20 grader Celsius, sendes der en Teams-meddelelse.

Se de andre regler for at få mere at vide om, 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

Nu er det tid til at oprette dit eget objekt. I dette afsnit skal du slette Package-objektet. Opret den derefter igen for at spore status for pakker under overførsel, hvor timerne i leveringen bliver større end 25.

  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 ny regel

Opret en regel, der giver dig besked, hvis forsendelsestiden i leveringen overskrider en grænse.

  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 vælg typen af condition og forekomst.

    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 trin kan du prøve at konfigurere nogle andre regler for 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