Del via

Opplæring: Opprette og aktivere en stoffaktivatorregel

Stoffaktivator i Microsoft Fabric lar deg utføre handlinger når mønstre eller betingelser oppdages i datastrømmer. Hvis du ikke har brukt Fabric Activator før, kan du se Hva er stoffaktivator. I denne opplæringen bruker du eksempeldataene som følger med Fabric Activator, til å fullføre følgende oppgaver:

  • Se gjennom en eksempelaktivator
  • Utforsk dataene
  • Utforske en regel
  • Start regelen
  • Opprette et objekt
  • Opprette en regel

Forutsetning

Før du begynner, trenger du et arbeidsområde med en Fabric-kapasitet. Du kan lære om Fabric-arbeidsområder i arbeidsområder-artikkelen . Hvis du ikke har Fabric, blir du bedt om å starte en prøveversjon.

Opprette en eksempelaktivator

  1. Gå til Stoff-portalen.

  2. I venstre navigasjonspanel, velg ellipsene (...), og velg deretter Lag.

    Skjermbilde som viser venstre navigasjonsrute med Opprett valgt.

  3. På siden Opprett , under seksjonen Real-Time Intelligens, velg Data Activator.

    Skjermbilde som viser Opprett-siden med Data Activator valgt.

  4. Velg Prøv eksempelpå aktiveringssiden.

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

Utforsk dataene

I dette trinnet utforsker vi eventstream-dataene som dette eksemplet er bygget på.

Den nye aktivatoren har en Explorer-inndeling. 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 til å angi hendelsesverdiene du vil overvåke, betingelsene du vil finne, og handlingene du vil at Stoffaktivator skal utføre.

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. Vi bruker denne unike ID-en til å tilordne pakkehendelser til pakkeobjekter.

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

  3. Velg temperaturregelen kalt For varm for medisin. Se definisjonsruten i ruten til høyre 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. Vår regel gjelder bare for pakker som inneholder medisin. 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. Til slutt ruller du ned til Handling. Velg en av følgende handlinger hvis betingelsen er oppfylt:

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

      1. For Select-handling, velg Send e-post.
      2. For Til, skriv inn e-postadresser til mottakere eller bruk nedtrekkslisten for å velge en egenskap hvis verdi er en e-postadresse. Som standard er e-posten din fylt ut 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 emne, overskrift eller notater, kan du referere til egenskaper i dataene ved å @ skrive eller ved å velge knappen ved siden av tekstboksene. Eksempel: @BikepointID.

      6. For kontekst, velg verdiene for 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-melding til deg selv. Du kan tilpasse tittelen og innholdet i meldingen.

      1. For Select-handling, velg Teams –>Send melding til enkeltpersoner eller gruppechatmelding, eller kanalinnlegg.
      2. Følg ett av disse stegene avhengig av valget ditt:
        • Hvis du valgte alternativet Melding til enkeltpersoner , skriver du inn e-postadressene til mottakerne eller bruker rullegardinlisten til å velge en egenskap som har en e-postadresse som verdi. Når betingelsen er oppfylt, sendes en e-post til spesifiserte personer.
        • Hvis du valgte alternativet Gruppechatmelding , velger du en gruppechat fra rullegardinlisten. Når betingelsen er oppfylt, legges det ut en melding i gruppechatten.
        • Hvis du valgte alternativet Kanalinnlegg , velg et lag og en kanal fra nedtrekkslistene. Når betingelsen er oppfylt, sendes 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 emne, overskrift eller notater, kan du referere til egenskaper i dataene ved å @ skrive eller ved å velge knappen ved siden av tekstboksene. Eksempel: @BikepointID.

      5. For kontekst, velg verdiene for 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, Spark-jobb eller notatbok når betingelsen er oppfylt, følg disse stegene:

      1. For Select-handling, velg Kjør Pipeline, Kjør Spark-jobb, Kjør Notebook eller Kjør funksjon (forhåndsvisning).

      2. Når du velger Fabric-element å kjøre, velger du Fabric-elementet (pipeline, notatbok, Spark-jobb eller funksjon) fra listen.

      3. Velg Legg til parameter, og angi 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: @BikepointID.

        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. Som nevnt i handlingsdelen, lag regelen først, og fullfør deretter oppsettet av egendefinerte handlinger ved å følge trinnene fra Trigger custom actions (Power Automate flows).

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

    5. Velg Create for å lagre Activator-regelen din.

Vi opprettet en stoffaktivatorregel. Regelen kjører mot hendelsesbanen for pakkeleveringshendelser . Regelen ser etter pakker som har medisin og sjekker for å se om temperaturen nå er større enn 20 grader Celsius. Når temperaturen blir større enn 20 grader Celsius, sendes en Teams-melding.

Se på de andre reglene for å lære hvordan de fungerer.

Start regelen

Nå er du kjent med hendelsene og objektene som brukes til å opprette en regel. Det neste trinnet er å starte regelen.

  1. Velg for varmt for medisin.

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

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

  3. Du bør motta en melding som ligner på følgende:

    Skjermbilde som viser eksempelvarslingen fra Teams.

  4. Velg Start. Dette fører til at regelen blir aktiv. Du mottar en Teams-melding når en medisinpakke er for varm. Regelen skal utløse flere ganger hver time.

    Skjermbilde som viser Start-knappen uthevet.

  5. Senere kan du deaktivere regelen ved hjelp av Stopp-knappen på båndet.

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

Opprette et objekt

Nå er det på tide å opprette et eget objekt. Slett pakkeobjektet i denne delen. Deretter oppretter du den på nytt for å spore statusen for pakker i transitt der leveringstidene blir større enn 25.

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

Opprett en regel som varsler deg hvis transitttiden i leveringen overskrider en terskel.

  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 tilstand, velg type tilstand og forekomst.

    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 skal se regelen under HoursInTransit i Explorer-ruten. 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 å komme frem.

    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 trinn kan du prøve å konfigurere noen andre regler for Package2-objektet .

    Når du er klar til å prøve å bruke Fabric Activator på dine egne data, følger du fremgangsmåten i artikkelen Hent data for Fabric Activator .

Fjerning av ressurser

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

Relatert innhold

Du kan også lære mer om Microsoft Fabric:

  • Last updated on