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 inngangspunktet til venstre Try samples.

    Følg de guidede instruksjonene for å aktivere prøvedataene og utforsk Activator-grensesnittet.

Utforsk dataene

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

Det nye Activator-objektet har en Utforsker-seksjon . Bla ned og velg strømmen Sykkellesninger.

Skjermbilde av Activator UI Explorer-panelet som viser sykkelavlesninger.

Disse arrangementene viser sykkelavlesninger i sanntid.

Se på innkommende hendelser og hold pekeren over hendelsesdataene i den direktesendte tabellen. Hvert datapunkt inneholder informasjon om hendelsen. Du må kanskje bla 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. Stasjonsavlesninger er et av objektene som er laget fra hendelsesstrømmene i Bicycles-lesearrangementene .

  1. I Utforsker-panelet velger du objektet som heter stasjonsavlesninger. Du kan lage regler om objekter som bruker data fra hendelsesstrømmen Sykler som leser hendelser . For eksempel en regel som sjekker stasjoner for sykkeltilgjengelighet.

    Skjermbilde som viser avlesningene fra sykkelstasjonen.

  2. Legg merke til at seksjonen Arrangementer etter 'BikepointID' er organisert etter Bikepoint ID. Bikepoint ID er kolonne-ID-en som unikt identifiserer hver sykkelstasjon. Bruk denne unike ID-en for å tildele sykkelhendelser til sykkelobjekter.

    Skjermbilde som viser stasjonsavlesningene for sykkelpunkt-ID.

  3. Velg No_Empty_Docks-regelen (som står for antall tomme dokker) kalt Ingen tomme dokker (E-post). I det høyre panelet, se på definisjonspanelet for å se hvordan regelen fungerer.

    Skjermbilde som viser Ingen tomme dokker e-postregel Definisjonspanel.

  4. I Monitor-seksjonen, velg No_Empty_Docks. Antall tomme dokkeverdier kommer fra kolonnen No_Empty_Docks i stasjonens lesetabell . Du kan se No_Empty_Docks-kolonnen i et tidligere skjermbilde.

  5. I seksjonen om betingelse ser du regelbetingelsen for å overvåke antall tomme dokker som er mindre enn 1.

    Skjermbilde som viser Monitor Definitions-panelet for antall tomme dokker.

  6. Bla lenger ned til Property-filtre. Regelen gjelder kun for stasjoner på Arlington Street. I tabellen for stasjonslesninger ser regelen på kolonnen kalt Gate. I Street-kolonnen har noen av syklene verdien Arlington Street.

    Skjermbilde som viser eiendomsfiltrene, mer spesifikt Arlington Street.

  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 på e-postvarslingen eller la det være som det er.

      4. For Overskrift, skriv inn overskriften på e-postvarslingen eller la det være som det er.

        1. For Melding, 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: @No_Empty_Docks.

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

        Skjermbilde som viser handlingspanelet med e-posthandlinger 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 Melding, legg 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: @No_Empty_Docks.

      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 handling, Kjør pipeline, Kjør Dataflow, Kjør Spark-jobb, Kjør notatbok,Kjør funksjon, Kjør kopijobb eller Publiser forretningshendelse.
      2. På Select Fabric-elementet å kjøre, velg Fabric-elementet (Action, pipeline, dataflow, notebook, Spark-jobb, funksjon, kopieringsjobb eller publiser forretningshendelse) 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: @BikePointID. Kopieringsjobber godtar ikke parametere, så dette steget gjelder ikke for dem.

      Skjermbilde som viser handlingsdelen i definisjonspanelet med e-posthandling 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 egendefinert handling valgt.

      1. Først, lag regelen. Deretter fullfører du oppsettet av egendefinerte handlinger ved å følge stegene i Trigger custom actions (Power Automate flows).
      2. 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 strider mot Bicycle readings eventstream. Regelen ser etter antall tomme brygger med færre enn én sykkel og sjekker hver gang betingelsen er oppfylt. Når antall sykler er mindre enn 1, 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 No_empty_docks (E-post).

  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 e-post som ligner på følgende:

    Skjermbilde som viser aktivator-e-post.

  4. Velg Start. Denne handlingen aktiverer regelen. Du får en e-post hver gang en brygge har færre enn én sykkel tilgjengelig. Regelen utløses hver gang betingelsen er oppfylt.

    Skjermbilde som viser definisjoner, startknapp for panelet.

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

    Skjermbilde som viser øverste båndstoppknapp valgt for å stoppe regelen.

Opprette et objekt

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

  1. I Utforsker-panelet , høyreklikk på Sykkelstasjon og velg Slett. Velg Slett i vinduet Slett element.

    Skjermbilde som viser slett-knappen for sykkelstasjonen.

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

    Skjermbilde som viser opprettelse av et nytt objekt fra Eventstream.

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

    1. Kall det nye objektet ditt Sykkelstasjon.

    2. Velg BikepointID som unik ID.

    3. Velg No_Bikes, No_Empty_Docks og Street som egenskaper ved objektet.

    4. Velg Opprett.

      Skjermbilde som viser byggeobjektpanel

Opprette en regel

Lag en regel som varsler deg når antall tomme dokker er mindre enn 1.

  1. Velg din nye No_Empty_Docks eiendom. Velg Ny regel fra båndet.

    Skjermbilde som viser ny regel – ingen tomme dokker.

  2. I definisjonspanelet følger du disse trinnene:

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

    2. For Betingelse, sett betingelsen til å utløses når No_Empty_Docks er mindre enn 1.

    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 No_Empty_Docks varsel i Utforsker-panelet. Velg regelen. I midtruten velger du blyantikonet øverst, og oppdater navnet til No_Empty_Docks (E-post).

    Skjermbilde viser ny No_Empty_Docks (e-post) regel.

  4. I definisjonspanelet til høyre, velg No_Empty_Docks. Velg deretter Legg til oppsummering>Maksimalt.

    Skjermbilde som viser definisjonspanelet med nedtrekksmenyen 'Legg til oppsummering' til 'Maksimum'.

  5. Sett en aggregeringsvindusstørrelse på ett minutt og en skrittstørrelse til samme som vindusstørrelse, og velg deretter Lagre.

    Skjermbilde av definisjonspanelet som viser oppsummering satt til Maksimum med 1-minutts vindustørrelse.

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

    Skjermbilde av Monitor-diagram som viser oppsummerte data med 1-minutts vindu og steglengde.

  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 av regeleditor med knappen 'Send meg en testaksjon' markert i rødt.

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

    Skjermbilde av regelpanelet med Start-knappen markert på båndet og definisjonspanelet åpent.

Du opprettet det første objektet og regelen. Som neste steg, prøv å sette opp andre regler på Sykkelstasjon-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:

  • Sist oppdatert