Zelfstudie: Een Fabric Activator-regel maken en activeren

Fabric Activator in Microsoft Fabric maakt het mogelijk voor u om acties te ondernemen wanneer het patronen of condities in gegevensstromen detecteert. Als u nieuw bent met Fabric Activator, zie Wat is Fabric Activator. In deze zelfstudie gebruikt u de voorbeeldgegevens die zijn opgenomen in Fabric Activator om de volgende taken uit te voeren:

  • Bekijk een voorbeeld van een Activator-item
  • De gegevens verkennen
  • Een regel verkennen
  • De regel starten
  • Maak een object
  • Een regel maken

Vereisten

Voordat u begint, hebt u een werkruimte met een Fabric-capaciteit nodig. Zie het artikel Werkruimten voor meer informatie over Fabric werkruimten. Als u geen Fabric hebt, wordt u gevraagd om een proefversie te starten.

Maak een voorbeeld van een Activator

  1. Op de Fabric-startpagina selecteert u in het linker navigatiepaneel de ellips (...), en selecteert u vervolgens Aanmaken.

    Schermopname van het linkernavigatiedeelvenster met Maken geselecteerd.

  2. Op de pagina Aanmaken , onder Real-Time Intelligentie, selecteer Activator.

    Screenshot waarop de Create-pagina staat met Activator geselecteerd.

  3. Op de Activator-pagina, selecteer Probeer voorbeeld.

    Schermopname van de optie om gegevens toe te voegen of de voorbeeldgegevens te gebruiken.

De gegevens verkennen

In deze stap bekijk je de gebeurtenisstroomgegevens waarop de steekproef is gebouwd.

Het nieuwe Activator-item heeft een Explorer-sectie . Scroll naar beneden en selecteer de Package delivery events stream.

Schermopname van Activator met de geselecteerde datastroom Pakketleveringsevenementen.

Deze gebeurtenissen tonen de realtime status van pakketten die worden geleverd.

Bekijk de binnenkomende gebeurtenissen en beweeg de muisaanwijzer over de gebeurtenisgegevens in de livetabel. Elk gegevenspunt bevat informatie over de gebeurtenis. Mogelijk moet u schuiven om alles te zien.

Een regel verkennen

Gebruik een regel om de gebeurteniswaarden op te geven die u wilt bewaken, de voorwaarden die u wilt detecteren en de acties die u wilt uitvoeren Fabric Activator.

In het deelvenster Explorer worden objecten, zoals eventstreams, weergegeven voor deze activator. Delivery events is een van de objecten die zijn gemaakt op basis van de Pakketleveringsevenementen eventstream.

  1. Selecteer in het deelvenster Explorer het object delivery events. U kunt regels maken voor objecten die gebruikmaken van gegevens uit de eventstream voor pakketleveringsevenementen . Bijvoorbeeld een regel waarmee pakketten op temperatuur worden gecontroleerd.

    Schermopname van de tabel Delivery Events en de temperatuurkolom.

  2. U ziet dat de sectie Gebeurtenissen op object-id is ingedeeld op pakket-id. Pakket-id is de kolom-id die elk pakket uniek identificeert. Gebruik deze unieke ID om pakketgebeurtenissen toe te wijzen aan pakketobjecten.

    Schermopname van de kolom Unieke id in het scherm Gebeurtenissen per object-id.

  3. Selecteer de temperatuurregel met de naam Te heet voor medicijnen. Bekijk in het meest rechtse paneel het Definitie-paneel om te zien hoe de regel werkt.

    Schermopname van de voorbeeldregel.

  4. Selecteer Temperatuur in de sectie Monitor. De temperatuurwaarden zijn afkomstig uit de kolom Temperatuur in de tabel Delivery-gebeurtenissen . In een eerdere schermopname ziet u de kolom Temperatuur .

    Schermopname van de sectie Monitor van het deelvenster Definitie.

  5. In de sectie Voorwaarde ziet u de regelvoorwaarde voor het bewaken van temperaturen die hoger zijn dan 20 graden Celsius.

    Schermopname van het gedeelte Voorwaarde van het deelvenster Definitie.

  6. Schuif verder omlaag naar eigenschapsfilter. De regel geldt alleen voor pakketten die medicijnen bevatten. In de tabel Leveringsevenementen bekijkt de regel de kolom met de naam Speciale zorginhoud. In de kolom Speciale zorg hebben sommige pakketten een waarde van Medicijnen.

    Schermopname van de sectie Eigenschapsfilter van het deelvenster Definitie.

  7. Scrol omlaag naar Actie. Kies een van de volgende acties wanneer aan de voorwaarde is voldaan:

    1. E-mailmelding verzenden: Stuurt een e-mailbericht naar uzelf of naar anderen in uw organisatie.

      1. Selecteer voor actie Selecteren de optie E-mail verzenden.
      2. Voor Aan voer je de e-mailadressen van de ontvangers in, of gebruik je de dropdownlijst om een eigenschap te selecteren waarvan de waarde een e-mailadres is. Je e-mailadres wordt hier standaard ingevuld.
      3. Voer voor Onderwerp het onderwerp van de e-mailmelding in.
      4. Voer voor Kop de kop van de e-mailmelding in.
      5. Voer voor Notities notities in voor de e-mailmelding.

        Opmerking

        Wanneer je het onderwerp, de kop of de notities invoert, kun je naar eigenschappen in de data verwijzen door te typen @ of de knop naast de tekstvakken te selecteren. Bijvoorbeeld: @PackageId.

      6. Voor de context: selecteer de waarden uit de dropdownlijst die je in de e-mailmelding wilt opnemen.

      Schermopname van de sectie Actie van het deelvenster Definitie met e-mailactie geselecteerd.

    2. Send Microsoft Teams notification: verzendt een Microsoft Teams melding naar personen, een groepschat of een kanaal. U kunt de titel en berichtinhoud aanpassen.

      1. Voor de actie selecteren kies je Teams>Bericht aan individuen, Groepschatbericht of Kanaalbericht.
      2. Voer een van deze stappen uit, afhankelijk van uw selectie:
        • Als je 'Bericht aan individuen' selecteert, voer dan de e-mailadressen van de ontvangers in, of gebruik de dropdownlijst om een eigendom te selecteren waarvan de waarde een e-mailadres is. Wanneer aan de voorwaarde is voldaan, stuurt Fabric Activator een Teams-bericht naar de gespecificeerde individuen.
        • Als je groepschatbericht hebt geselecteerd, selecteer dan een groepschat uit de dropdownlijst. Wanneer aan de voorwaarde is voldaan, plaatst Fabric Activator een bericht in de groepschat.
        • Als je Kanaalpost hebt geselecteerd, selecteer dan een team en kanaal uit de keuzemenu's. Wanneer aan de voorwaarde is voldaan, plaatst Fabric Activator een bericht op het geselecteerde kanaal.
      3. Voer voor Kop de kop in van de Teams-melding.
      4. Voer voor Notities notities in voor de Teams notificatie.

        Opmerking

        Wanneer je het onderwerp, de kop of de notities invoert, kun je naar eigenschappen in de data verwijzen door te typen @ of de knop naast de tekstvakken te selecteren. Bijvoorbeeld: @PackageId.

      5. Voor de context: selecteer de waarden uit de dropdownlijst die je in de Teams-melding wilt opnemen.

      Schermopname van de sectie Actie van het deelvenster Definitie.

    3. Voer Fabric-activiteiten uit: Om de alert te configureren om een Fabric-pipeline, Dataflow, Spark-job, notebook, Function, Copy-job of Publish business event (preview) te starten wanneer aan de voorwaarde is voldaan, volg deze stappen:

      1. Voor Actie selecteren, selecteer Run Pipeline, Run Dataflow, Run Spark job, Run Notebook, Run Function, Run Copy job of Publish business event (preview).

      2. Selecteer op Selecteer Fabric item dat u wilt uitvoeren het Fabric item (pijplijn, gegevensstroom, notebook, Spark-taak, functie, kopieertaak of publiceer zakelijke gebeurtenis (preview)) in de lijst.

      3. Selecteer de add-parameter en geef vervolgens de naam van de parameter voor het Fabric-item en een waarde daarvoor op. U kunt meer dan één parameter toevoegen. U kunt parameters van de waarschuwingsgegevens doorgeven door te typen @ of door de knop naast het tekstvak te selecteren. Bijvoorbeeld: @PackageId. Kopieeropdrachten accepteren geen parameters, dus deze stap geldt niet voor hen.

        Schermopname van de sectie Actie van het deelvenster Definitie met de pijplijnactie geselecteerd.

    4. Aangepaste acties: Voer de volgende stappen uit om de waarschuwing te configureren om een aangepaste actie aan te roepen wanneer aan de voorwaarde wordt voldaan:

      1. Selecteer voor Actie Selecterende optie Aangepaste actie maken.

        Schermopname van de sectie Actie van het deelvenster Definitie met notebookactie geselecteerd.

      2. Maak eerst de regel. Voltooi vervolgens de aangepaste actie-setup door de stappen te volgen in Trigger custom actions (Power Automate flows).

      3. Nadat je de aangepaste actie hebt aangemaakt, selecteer je in het Definitie-paneel je aangepaste actie uit de keuzelijst met Actie selecteren .

  8. Nadat je je gekozen actie hebt geconfigureerd, selecteer je Create om je Activator-regel op te slaan.

U hebt een Fabric Activator-regel gemaakt. De regel wordt uitgevoerd op de eventstream voor pakketleveringsgebeurtenissen . De regel zoekt naar verpakkingen die medicijnen bevatten en controleert of de temperatuur hoger is dan 20 graden Celsius. Wanneer de temperatuur boven de 20 graden Celsius uitkomt, stuurt de regel een Teams-boodschap.

Dit voorbeeld van Activator bevat andere regels. Verken ze in je eigen tempo om te zien hoe ze werken.

De regel starten

Nu u bekend bent met de gebeurtenissen en objecten die worden gebruikt om een regel te maken, start u de regel.

  1. Selecteer Te heet voor medicijnen.

  2. U kunt desgewenst een testbericht verzenden door Mij een testactie sturente selecteren. Controleer eerst of u de ontvanger bent.

    Schermopname van de Actie-sectie van het Definitie-deelvenster met de gemarkeerde knop Testactie verzenden.

  3. U ontvangt een bericht dat lijkt op de volgende:

    Schermopname van de voorbeeldmelding van Teams.

  4. Selecteer Starten. Met deze actie wordt de regel geactiveerd. U ontvangt een Teams-bericht wanneer een medicijnpakket te heet is. De regel wordt meerdere keren per uur geactiveerd.

    Schermopname met de knop Start gemarkeerd.

  5. Later kunt u de regel uitschakelen met behulp van de knop Stoppen op het lint.

    Schermopname van de knop Stoppen op het lint gemarkeerd.

Maak een object

Maak nu een eigen object. In deze sectie verwijder je het Package-object en maak je het opnieuw aan met de eigenschappen die je in de volgende sectie gebruikt om een regel te bouwen.

  1. Klik in het deelvenster Explorer met de rechtermuisknop op Pakket en selecteer Verwijderen. Selecteer Verwijderen in het venster Item verwijderen.

    Schermopname van het menu Verwijderen in het pakketobject.

  2. Selecteer de stroom pakketbezorgingsevenementen en selecteer vervolgens Nieuw object op de werkbalk.

    Schermopname van de knop Nieuw object op het lint.

  3. Voer in het deelvenster Object bouwen aan de rechterkant de volgende stappen uit:

    1. Geef het nieuwe object Package2 een naam.

    2. Kies PackageId als de unieke id.

    3. Selecteer HoursInTransit en City als eigenschappen van het object.

    4. Selecteer Creëer.

      Schermopname van het deelvenster Build-object.

Een regel maken

Maak een regel die je waarschuwt wanneer de gemiddelde reistijd meer dan 25 uur is.

  1. Selecteer uw nieuwe HoursInTransit eigenschap. Selecteer Nieuwe regel op het lint.

    Schermopname van de knop Nieuwe regel op het lint.

  2. Voer in het deelvenster Definitie de volgende stappen uit:

    1. Kies voor Monitor het kenmerk dat u wilt bewaken en voeg eventueel filters toe.

    2. Voor Voorwaarde zet je de conditie op activatie wanneer UrenInTransit groter is dan 25.

    3. Selecteer voor Actie een van de opties voor het verzenden van een bericht in Teams of e-mail.

    4. Selecteer Opslaan.

      Schermopname van het deelvenster Definitie.

  3. U ziet de regel onder HoursInTransit in het deelvenster Explorer. Selecteer de regel. Selecteer in het middelste deelvenster het potloodpictogram bovenaan en werk de naam bij naar gemiddelde doorvoertijd boven het doel.

    Schermopname van het potloodpictogram om de regelnaam te wijzigen.

  4. Selecteer HoursInTransit in het deelvenster Definitie aan de rechterkant. Selecteer vervolgens Samenvatting toevoegen>Gemiddelde.

    Schermopname van het deelvenster Definitie met Gemiddelde aggregatie geselecteerd.

  5. Stel een aggregatievenstergrootte van vijf minuten en een stapgrootte van vijf minuten in en selecteer Opslaan.

    Schermopname van het deelvenster Definitie met het venster en de stapgrootte.

  6. De grafiek Monitor wordt bijgewerkt om de samenvatting weer te geven en uw regelmonitorgrafiek ziet er als volgt uit.

    Schermopname van het diagram van de gemiddelde transittijd voor de activator-tutorial.

  7. Test uw regel door de knop Stuur mij een testactie te selecteren. Zorg ervoor dat u een waarschuwing krijgt. Als u e-mail gebruikt, kan het een paar minuten duren voordat deze aankomt.

    Schermopname van de knop Testen geselecteerd op het lint.

  8. Start de regel door Opslaan te selecteren en te beginnen in het deelvenster Definitie of door Start op het lint te selecteren.

    Schermopname van de knop Start op het lint geselecteerd.

    U hebt uw eerste object en regel gemaakt. Als volgende stap kun je proberen andere regels op het Package2-object in te stellen.

    Wanneer u klaar bent om Fabric Activator op uw eigen gegevens te gebruiken, volg dan de stappen in het artikel Get data for Fabric Activator.

Resources opschonen

Wanneer u klaar bent met de regels die u hebt gemaakt als onderdeel van de zelfstudie, stopt u deze. Als u de regels niet stopt, blijft u de regelmeldingen ontvangen. Mogelijk worden er ook kosten in rekening gebracht voor achtergrondverwerking. Selecteer elke regel op zijn beurt en selecteer de knop Stoppen op het lint.

Gerelateerde inhoud

Zie voor meer informatie over Microsoft Fabric:

  • Last updated on