Veiledning: Lag og aktiver en Fabric Activator-regel

Fabric Activator i Microsoft Fabric gjør det mulig å utføre handlinger når den oppdager mønstre eller tilstander i datastrømmer. Hvis du er ny til Fabric Activator, se Hva er Fabric Activator. I denne veiledningen bruker du eksempeldataene som følger med Fabric Activator for å fullføre følgende oppgaver:

  • Gå gjennom et eksempel på et Aktivator-element
  • Utforsk dataene
  • Utforske en regel
  • Start regelen
  • Opprette et objekt
  • Opprette en regel

Forutsetning

Før du begynner, trenger du et arbeidsområde med Fabric-kapasitet. For å lære om Fabric arbeidsområder, se artikkelen Workspaces. Hvis du ikke har Fabric, blir du bedt om å starte en prøveperiode.

Lag en eksempelaktivator

  1. På Fabric-hjemmesiden, i venstre navigasjonspanel, velg ellipsen (...), og velg deretter Opprett.

    Skjermbilde som viser venstre navigasjonsrute med Opprett valgt.

  2. På siden Opprett , under Real-Time Intelligens, velg Aktivator.

    Skjermbilde som viser Opprett-siden med Aktivator valgt.

  3. Velg Prøv eksempelpå aktiveringssiden.

    Skjermbilde som viser alternativet for å legge til data eller bruke eksempeldataene.

Utforsk dataene

I dette steget utforsker du hendelsesstrømsdataene som utvalget er bygget på.

Det nye Activator-objektet har en Utforsker-seksjon . Rull ned og velg pakkeleveringshendelsesstrømmen.

Skjermbilde av Activator med pakken levering hendelser stream valgt.

Disse hendelsene viser sanntidsstatusen for pakker som er i ferd med å bli levert.

Se på innkommende hendelser og hold pekeren over hendelsesdataene i den direktesendte tabellen. Hvert datapunkt inneholder informasjon om hendelsen. Det kan hende du må rulle for å se alt.

Utforske en regel

Bruk en regel for å spesifisere hendelsesverdiene du vil overvåke, betingelsene du vil oppdage, og handlingene du vil at Fabric Activator skal ta.

Explorer-ruten viser objekter, for eksempel hendelsesstrømmer, for denne aktivatoren. Leveringshendelser er ett av objektene som er opprettet fra Pakkeleveringshendelser eventstream.

  1. Velg objektet kalt Leveringshendelser i Explorer-ruten. Du kan opprette regler om objekter som bruker data fra hendelsesbanen for pakkelevering. En regel som for eksempel kontrollerer pakker for temperatur.

    Skjermbilde som viser tabellen Leveringshendelser og temperaturkolonnen.

  2. Legg merke til at delen Hendelser etter objekt-ID er organisert etter pakke-ID. Pakke-ID er kolonne-ID-en som unikt identifiserer hver pakke. Bruk denne unike ID-en for å tildele pakkehendelser til pakkeobjekter.

    Skjermbilde som viser den unike ID-kolonnen i skjermbildet Hendelser etter objekt-ID.

  3. Velg temperaturregelen kalt For varm for medisin. I det høyre panelet, se på definisjonspanelet for å se hvordan regelen fungerer.

    Skjermbilde som viser eksempelregelen.

  4. Velg Temperatur i Monitor-delen. Temperaturverdiene kommer fra Temperatur-kolonnen i tabellen Leveringshendelser . Du kan se Temperatur-kolonnen i et tidligere skjermbilde.

    Skjermbilde som viser Skjerm-delen i Definisjon-ruten.

  5. I betingelsesdelen ser du regelbetingelsen for å overvåke temperaturer som er høyere enn 20 grader Celsius.

    Skjermbilde som viser Tilstandsdelen i definisjonspanelet.

  6. Rull lenger ned for å egenskapsfilter. Regelen gjelder kun for pakker som inneholder medisiner. I tabellen Leveringshendelser ser regelen på kolonnen med navnet innhold. Noen av pakkene har en verdi av Medisini kolonnen spesialpleie kolonne.

    Skjermbilde som viser egenskapsfilterinndelingen i definisjonsruten.

  7. Bla ned til Action. Velg en av følgende handlinger når betingelsen er oppfylt:

    1. Send e-postvarsling: Sender en e-post til deg selv eller til andre i organisasjonen din.

      1. For Velg handling velger du Send e-post.
      2. For Til, skriv inn mottakernes e-postadresser , eller bruk nedtrekkslisten for å velge en egenskap hvis verdi er en e-postadresse. E-postadressen din er som standard utfylt her.
      3. For Emne, skriv inn emnet for e-postvarslingen.
      4. For Overskrift, skriv inn overskriften på e-postvarslingen.
      5. For Notater, legg inn notater for e-postvarslingen.

        Note

        Når du skriver inn emnet, overskriften eller notatene, kan du referere til egenskaper i dataene ved å skrive @ eller ved å velge knappen ved siden av tekstboksene. Eksempel: @PackageId.

      6. For kontekst, velg verdiene fra nedtrekkslisten du vil inkludere i e-postvarslingen.

      Skjermbilde som viser handlingsdelen i definisjonspanelet med e-posthandling valgt.

    2. Send Microsoft Teams varsling: Sender en Microsoft Teams varsel til enkeltpersoner, en gruppechat eller en kanal. Du kan tilpasse tittelen og innholdet i meldingen.

      1. For Select-handling, velg Teams>Message to individuals, Gruppechat-melding eller Kanal-innlegg.
      2. Følg ett av disse stegene avhengig av valget ditt:
        • Hvis du valgte Melding til enkeltpersoner, skriv inn mottakernes e-postadresser , eller bruk nedtrekkslisten for å velge en egenskap som har verdien som en e-postadresse. Når betingelsen er oppfylt, sender Fabric Activator en Teams-melding til de spesifiserte personene.
        • Hvis du valgte gruppechatmelding, velg en gruppechat fra nedtrekkslisten. Når betingelsen er oppfylt, legger Fabric Activator ut en melding i gruppechatten.
        • Hvis du valgte Kanalinnlegg, velg et lag og en kanal fra nedtrekkslistene. Når betingelsen er oppfylt, sender Fabric Activator en melding til den valgte kanalen.
      3. For Overskrift, skriv inn overskriften i Teams-varslingen.
      4. For Notater, skriv inn notater for Teams-varslingen.

        Note

        Når du skriver inn emnet, overskriften eller notatene, kan du referere til egenskaper i dataene ved å skrive @ eller ved å velge knappen ved siden av tekstboksene. Eksempel: @PackageId.

      5. For kontekst, velg verdiene fra nedtrekkslisten du vil inkludere i Teams-varslingen.

      Skjermbilde som viser Handling-delen i Definisjon-ruten.

    3. Kjør Fabric-aktiviteter: For å konfigurere varslingen til å starte en Fabric-pipeline, Dataflow, Spark-jobb, notatbok, Funksjon, kopijobb eller Publiser forretningshendelse (forhåndsvisning) når betingelsen er oppfylt, følg disse stegene:

      1. For Velg handling, velg Kjør Pipeline, Kjør Dataflow, Kjør Spark-jobb, Kjør notatbok,Kjør funksjon, Kjør kopijobb, eller Publiser forretningshendelse (forhåndsvisning).

      2. På Velg Fabric element som skal kjøres, velg Fabric element (pipeline, dataflow, notatbok, Spark-jobb, funksjon, kopijobb eller publiser forretningshendelse (forhåndsvisning)) fra listen.

      3. Velg Add parameter, og spesifiser deretter navnet på parameteren for Fabric-elementet og en verdi for det. Du kan legge til mer enn én parameter. Du kan sende parametere fra varslingsdataene ved å @ skrive eller ved å velge knappen ved siden av tekstboksen. Eksempel: @PackageId. Kopieringsjobber godtar ikke parametere, så dette steget gjelder ikke for dem.

        Skjermbilde som viser handlingsdelen i definisjonspanelet med pipeline-handling valgt.

    4. Egendefinerte handlinger: For å konfigurere varslingen til å kalle en egendefinert handling når betingelsen er oppfylt, følg disse stegene:

      1. For Velg handling, velg Lag egendefinert handling.

        Skjermbilde som viser handlingsdelen i definisjonspanelet med notatblokkhandling valgt.

      2. Først, lag regelen. Deretter fullfører du oppsettet av egendefinerte handlinger ved å følge stegene i Trigger custom actions (Power Automate flows).

      3. Etter at du har opprettet den egendefinerte handlingen, velger du i definisjonspanelet din egendefinerte handling fra nedtrekksmenyen for Velg handling .

  8. Etter at du har konfigurert den valgte handlingen, velg Create for å lagre Activator-regelen din.

Du har laget en Fabric Activator-regel. Regelen kjører mot hendelsesstrømmen for pakkeleveringshendelser . Regelen ser etter pakker som inneholder medisin og sjekker om temperaturen er over 20 grader Celsius. Når temperaturen overstiger 20 grader Celsius, sender regelen en Teams-melding.

Dette eksempelet på Activator-elementet inkluderer andre regler. Utforsk dem i ditt eget tempo for å se hvordan de fungerer.

Start regelen

Nå som du er kjent med hendelsene og objektene som brukes for å lage en regel, start regelen.

  1. Velg for varmt for medisin.

  2. Du kan også sende en testmelding ved å velge Send meg en testhandling. Først, sjekk at du er mottakeren.

    Skjermbilde som viser handlingsdelen i definisjonsruten med Knappen Send meg en testhandling uthevet.

  3. Du mottar en melding som ligner på følgende:

    Skjermbilde som viser eksempelvarslingen fra Teams.

  4. Velg Start. Denne handlingen aktiverer regelen. Du mottar en Teams-melding når en medisinpakke er for varm. Regelen utløses flere ganger i timen.

    Skjermbilde som viser Start-knappen uthevet.

  5. Senere kan du slå av regelen ved å bruke Stopp-knappen på båndet.

    Skjermbilde som viser Stopp-knappen på båndet uthevet.

Opprette et objekt

Nå lager du et eget objekt. I denne seksjonen sletter du Package-objektet og gjenskaper det med egenskapene du skal bruke i neste seksjon for å lage en regel.

  1. Høyreklikk Pakke i Explorer-ruten, og velg Slett. Velg Slett i vinduet Slett element.

    Skjermbilde som viser Slett-menyen på pakkeobjektet.

  2. Velg strømmen for pakkeleveringshendelser , og velg deretter Nytt objekt på båndet.

    Skjermbilde som viser Nytt objekt-knappen på båndet.

  3. Følg disse trinnene i ruten Bygg objekt til høyre:

    1. Gi navn til det nye objektet Package2.

    2. Velg PackageId som den unike ID-en.

    3. Velg HoursInTransit og City som egenskaper for objektet.

    4. Velg Opprett.

      Skjermbilde som viser Bygg objekt-ruten.

Opprette en regel

Lag en regel som varsler deg når gjennomsnittlig transporttid overstiger 25 timer.

  1. Velg den nye Egenskapen HoursInTransit . Velg Ny regel fra båndet.

    Skjermbilde som viser Ny regel-knappen på båndet.

  2. I definisjonspanelet følger du disse trinnene:

    1. For Monitor, velg attributtet å overvåke og legg eventuelt til filtre.

    2. For Condition, sett betingelsen til å utløses når HoursInTransit er større enn 25.

    3. For Handling, velg ett av alternativene for å sende en melding i Teams eller e-post.

    4. Velg Lagre.

      Skjermbilde som viser definisjonspanelet.

  3. Du ser regelen under HoursInTransit i Utforsker-panelet. Velg regelen. Velg blyantikonet øverst i den midterste ruten, og oppdater navnet til Gjennomsnittlig transitttid over målet.

    Skjermbilde som viser blyantikonet for å endre regelnavnet.

  4. Velg HoursInTransit i Definisjon-ruten til høyre. Velg deretter Legg til sammendrag>Gjennomsnitt.

    Skjermbilde som viser Definisjon-ruten med Gjennomsnittlig aggregasjon valgt.

  5. Angi en aggregasjonsvindustørrelse på fem minutter og en trinnstørrelse på fem minutter, og velg deretter Lagre.

    Skjermbilde som viser Definisjon-ruten med vinduet og trinnstørrelse.

  6. Overvåkingsdiagrammet oppdateres for å gjenspeile sammendraget, og regelovervåkingsdiagrammet ser slik ut.

    Skjermbilde av gjennomsnittlig transitttidsdiagram for aktivatoropplæring.

  7. Test regelen ved å velge Send meg en testhandling-knappen. Kontroller at du får et varsel. Hvis du bruker e-post, kan det ta et minutt eller to før det kommer.

    Skjermbilde som viser Test-knappen som er valgt på båndet.

  8. Start regelen ved å velge Lagre og start i Definisjon-ruten eller ved å velge Start på båndet.

    Skjermbilde som viser Start-knappen på båndet som er valgt.

    Du opprettet det første objektet og regelen. Som neste steg, prøv å sette opp andre regler på Package2-objektet .

    Når du er klar til å prøve å bruke Fabric Activator på dine egne data, følg stegene i artikkelen Get data for Fabric Activator.

Fjerning av ressurser

Når du er ferdig med reglene du har laget som en del av opplæringen, stopp dem. Hvis du ikke stopper reglene, fortsetter du å motta regelvarslene. Du kan også pådra deg gebyrer for bakgrunnsbehandling. Velg hver regel i sin tur, og velg Stopp-knappen fra båndet.

Relatert innhold

For å lære mer om Microsoft Fabric, se:

  • Last updated on