Tutoriel : Créer et activer une règle d’activateur Fabric

Fabric Activateur dans Microsoft Fabric vous permet d’effectuer des actions lorsqu’il détecte des modèles ou des conditions dans des flux de données. Si vous découvrez Fabric Activator, consultez Qu'est-ce que Fabric Activator. Dans ce tutoriel, vous utilisez les exemples de données inclus avec Fabric Activateur pour effectuer les tâches suivantes :

  • Examinez un exemple d’objet Activator
  • Exploration des données
  • Explorer une règle
  • Démarrer la règle
  • Créer un objet
  • Créer une règle

Prérequis

Avant de commencer, vous avez besoin d’un espace de travail doté d'une capacité Fabric. Pour en savoir plus sur les espaces de travail Fabric, consultez l’article Workspaces. Si vous n'avez pas Fabric, vous êtes invité à démarrer une version d'évaluation.

Créer un exemple d’Activateur

  1. Sur la page d’accueil de Fabric, dans le panneau de navigation de gauche, sélectionnez les ellipsis (...), puis sélectionnez Créer.

    Capture d’écran montrant le volet de navigation gauche avec Créer sélectionné.

  2. Sur la page Créer , sous Real-Time Intelligence, sélectionnez Activateur.

    Capture d’écran montrant la page Créer avec Activateur activé.

  3. Dans la page Activateur , sélectionnez Essayer l’exemple.

    Capture d’écran montrant le point d’entrée des échantillons Try à gauche.

    Suivez les consignes guidées pour activer les données d’échantillon et explorez l’interface Activator.

Exploration des données

À cette étape, vous explorez les données du flux d’événements sur lesquelles l’échantillon est construit.

Le nouvel objet Activateur possède une section Explorateur . Faites défiler vers le bas et sélectionnez le Bicycle readings stream.

Capture d’écran du panneau Activator UI Explorer montrant les relevés de vélo.

Ces événements montrent des données du vélo en temps réel.

Examinez les événements entrants et pointez sur les données d’événement dans la table dynamique. Chaque point de données contient des informations sur l’événement. Vous devrez peut-être faire défiler pour tout voir.

Explorer une règle

Utilisez une règle pour spécifier les valeurs d’événement que vous souhaitez surveiller, les conditions que vous souhaitez détecter et les actions que vous souhaitez Fabric Activateur prendre.

Le volet Explorateur affiche des objets, comme les flux d’événements, pour cet activateur. Les lectures de station sont l’un des objets créés à partir du flux d’événements Bicycles reading events.

  1. Dans le volet Explorateur, sélectionnez l’objet appelé Station readings. Vous pouvez créer des règles pour les objets qui utilisent les données de l’eventstream événements de lecture Bicycle. Par exemple, une règle qui vérifie, pour les stations, la disponibilité des vélos.

    Capture d’écran montrant les relevés de la station à vélo.

  2. Remarquez que la section Événements par 'BikepointID' est organisée par ID Bikepoint. L’identifiant Bikepoint est l’identifiant de colonne qui identifie de manière unique chaque station de vélos. Utilisez cet identifiant unique pour assigner des épreuves vélo aux objets vélo.

    Capture d’écran montrant les relevés de la station pour l’ID du point vélo.

  3. Sélectionnez la règle No_Empty_Docks (qui signifie nombre de quais vides) appelée Pas de quais vides (Email). Dans le panneau le plus à droite, consultez le panneau Définition pour voir comment fonctionne la règle.

    Capture d’écran montrant le volet Définitions de la règle de messagerie « No empty docks ».

  4. Dans la section Monitor, sélectionnez No_Empty_Docks. Le nombre de valeurs de quais vides provient de la colonne No_Empty_Docks dans le tableau Station readings. Vous pouvez voir la colonne No_Empty_Docks dans une capture d’écran précédente.

  5. Dans la section Condition, vous pouvez voir la condition de règle pour surveiller le nombre de quais vides dont le nombre est inférieur à 1.

    Capture d’écran montrant le volet Définitions du moniteur pour le nombre de stations d’accueil vides.

  6. Faites défiler jusqu’à la section Filtres de propriété. La règle ne s’applique qu’aux stations d’Arlington Street. Dans le tableau Station Readings, la règle examine la colonne nommée Street. Dans la colonne Street, la valeur de certains vélos est « Arlington Street ».

    Capture d’écran montrant les filtres du bien, plus précisément Arlington Street.

  7. Faites défiler jusqu’à Action. Choisissez l’une des actions suivantes à entreprendre lorsque la condition est remplie :

    1. Envoyer une notification par e-mail : Envoie un e-mail à vous-même ou à d’autres membres de votre organisation.

      1. Pour sélectionner une action, sélectionnez Envoyer un e-mail.

      2. Pour To, saisissez les adresses e-mail des destinataires, ou utilisez la liste déroulante pour sélectionner une propriété dont la valeur est une adresse e-mail. Votre adresse e-mail est remplie ici par défaut.

      3. Pour Objet, saisissez l’objet de la notification par e-mail ou laissez tel quel.

      4. Pour Titre, entrez le titre de la notification par email ou laissez tel quel.

        1. Pour Message, saisissez des notes pour la notification par e-mail.

        Note

        Lorsque vous entrez le sujet, le titre ou les notes, vous pouvez vous référer aux propriétés des données en tapant @ ou en sélectionnant le bouton à côté des boîtes de texte. Par exemple : @No_Empty_Docks.

      5. Pour contexte, sélectionnez les valeurs dans la liste déroulante que vous souhaitez inclure dans la notification par e-mail.

        Capture d’écran montrant le volet Actions avec les actions Email sélectionnées.

    2. Send Microsoft Teams notification : envoie une notification de Microsoft Teams aux individus, à une conversation de groupe ou à un canal. Vous pouvez personnaliser le titre et le contenu du message.

      1. Pour sélectionner une action, sélectionnez Message Teams>aux individus, Message de groupe dans le chat ou publication sur le canal.

      2. Suivez l’une de ces étapes selon votre choix :

        • Si vous avez sélectionné Message aux particuliers, saisissez les adresses e-mail des destinataires, ou utilisez la liste déroulante pour sélectionner une propriété dont la valeur est une adresse e-mail. Lorsque la condition est remplie, Fabric Activator envoie un message Teams aux individus spécifiés.
        • Si vous avez sélectionné un message de groupe de discussion, sélectionnez un groupe de discussion dans la liste déroulante. Lorsque la condition est remplie, Fabric Activator publie un message dans le groupe de discussion.
        • Si vous avez sélectionné Publication de chaîne, sélectionnez une équipe et une chaîne dans les listes déroulantes. Lorsque la condition est remplie, Fabric Activator publie un message sur le canal sélectionné.

      3. Pour Titre, entrez le titre de la notification dans Teams.

      4. Pour Message, saisissez des notes pour la notification Teams.

        Note

        Lorsque vous entrez le sujet, le titre ou les notes, vous pouvez vous référer aux propriétés des données en tapant @ ou en sélectionnant le bouton à côté des boîtes de texte. Par exemple : @No_Empty_Docks.

      5. Pour contexte, sélectionnez les valeurs dans la liste déroulante que vous souhaitez inclure dans la notification Teams.

        Capture d’écran montrant la section Action du volet Définition.

    3. Exécuter des activités Fabric : Pour configurer l’alerte afin de lancer un pipeline Fabric, un flux de données, un travail Spark, un notebook, une fonction, un travail de copie ou de publier un événement métier (préversion) lorsque la condition est satisfaite, suivez ces étapes :

      1. Pour Sélectionner une action, sélectionnez Exécuter action, Exécuter Pipeline, Exécuter Dataflow, Exécuter la tâche Spark, Exécuter le carnet, Exécuter la fonction, Exécuter la tâche de copie, ou Publier l’événement métier.
      2. Dans Sélectionner l’élément Fabric à exécuter, sélectionnez l’élément Fabric (Action, pipeline, dataflow, notebook, job Spark, fonction, tâche de copie ou publier un événement métier) dans la liste.
      3. Sélectionnez Ajouter un paramètre, puis spécifiez le nom du paramètre pour l’élément Fabric et une valeur pour celui-ci. Vous pouvez ajouter plusieurs paramètres. Vous pouvez transmettre des paramètres à partir des données d’alerte en tapant @ ou en sélectionnant le bouton en regard de la zone de texte. Par exemple : @BikePointID. Les jobs de copie n’acceptent pas de paramètres, donc cette étape ne s’applique pas à eux.

      Capture d’écran montrant la section Action du volet Définition avec l’action d’e-mail sélectionnée.

    4. Actions personnalisées : Pour configurer l’alerte pour appeler une action personnalisée lorsque la condition est remplie, procédez comme suit :

      1. Pour Sélectionner une action, sélectionnez Créer une action personnalisée.

      Capture d’écran montrant la section Action du panneau Définition avec une action personnalisée sélectionnée.

      1. D’abord, créez la règle. Ensuite, complétez la configuration des actions personnalisées en suivant les étapes de Déclencher des actions personnalisées (flux Power Automate).
      2. Après avoir créé l’action personnalisée, dans le panneau Définition , sélectionnez votre action personnalisée dans la liste déroulante Sélectionner une action .

  8. Après avoir configuré l’action sélectionnée, sélectionnez Créer pour enregistrer votre règle d’Activateur.

Vous avez créé une règle d'activation Fabric. La règle s’applique à l’eventstream Lectures de bicyclette. La règle évalue le nombre de quais vides et vérifie à chaque fois que la condition est remplie. Lorsque le nombre de vélos est inférieur à 1, la règle envoie un message Teams.

Cet exemple d’objet Activateur comprend d’autres règles. Explorez-les à votre rythme pour voir comment ils fonctionnent.

Démarrer la règle

Maintenant que vous connaissez les événements et les objets utilisés pour créer une règle, démarrez la règle.

  1. Sélectionnez No_empty_docks (Email).

  2. Si vous le souhaitez, envoyez un message de test en sélectionnant Envoyer une action de test. Tout d’abord, vérifiez que vous êtes le destinataire.

    Capture d’écran montrant la section Action du volet Définition avec le bouton Envoyer une action de test mise en surbrillance.

  3. Vous recevez un e-mail similaire au suivant :

    Capture d’écran montrant l’e-mail d’activation.

  4. Sélectionnez Démarrer. Cette action active la règle. Vous recevez un e-mail chaque fois qu’une station dispose de moins d’un vélo disponible. La règle se déclenche à chaque fois que la condition est remplie.

    Capture d’écran montrant le bouton Démarrer du volet Définitions.

  5. Plus tard, vous pouvez désactiver la règle à l’aide du bouton Arrêter sur le ruban.

    Capture d’écran montrant le bouton d’arrêt du ruban supérieur sélectionné pour arrêter la règle.

Créer un objet

Maintenant, créez un objet. Dans cette section, vous supprimez l’objet Station de vélo et le recréez avec les propriétés que vous utiliserez dans la section suivante pour créer une règle.

  1. Dans le volet Explorateur, cliquez avec le bouton droit sur Station vélo, puis sélectionnez Supprimer. Dans la fenêtre Supprimer un élément , sélectionnez Supprimer.

    Capture d’écran montrant le bouton Supprimer pour Bike Station.

  2. Sélectionnez le flux Relevés de vélo, puis sélectionnez Nouvel objet sur le ruban.

    Capture d’écran montrant la création d’un nouvel objet depuis Eventstream.

  3. Dans le volet Générer un objet à droite, procédez comme suit :

    1. Nommez votre nouvel objet Station vélo.

    2. Choisissez BikepointID comme identifiant unique.

    3. Sélectionnez No_Bikes, No_Empty_Docks et Street comme propriétés de l’objet.

    4. Sélectionnez Créer.

      Capture d’écran montrant le volet de l’objet de génération

Créer une règle

Créez une règle qui vous alerte lorsque le nombre de docks vides est inférieur à 1.

  1. Sélectionnez votre nouvelle propriété No_Empty_Docks. Dans le ruban, sélectionnez Nouvelle colonne.

    Capture d’écran montrant une nouvelle règle - pas de stations d’accueil vides.

  2. Dans le volet Définition , procédez comme suit :

    1. Pour Monitor, choisissez l’attribut à surveiller et ajoutez éventuellement des filtres.

    2. Pour la condition, réglez la condition pour qu’elle se déclenche lorsque No_Empty_Docks est inférieure à 1.

    3. Pour action, sélectionnez l’une des options permettant d’envoyer un message dans Teams ou par e-mail.

    4. Cliquez sur Enregistrer.

      Capture d’écran montrant le panneau des définitions.

  3. Vous voyez la règle sous No_Empty_Docks alert dans le panneau Explorateur. Sélectionnez la règle. Dans le panneau du milieu, sélectionnez l’icône du crayon en haut, puis mettez à jour le nom en No_Empty_Docks (Email).

    Capture d’écran montrant la nouvelle règle No_Empty_Docks (Email).

  4. Dans le panneau Définition à droite, sélectionnez No_Empty_Docks. Ensuite, sélectionnez Ajouter une synthèse>Maximum.

    Capture d’écran montrant le panneau Définitions avec le menu déroulant « Ajouter une synthèse » défini sur « Maximum ».

  5. Fixez une taille de fenêtre d’agrégation d’une minute et une taille de pas égale à la taille de la fenêtre, puis sélectionnez Sauvegarder.

    Capture d’écran du panneau de définition montrant la synthèse réglée sur Maximale avec une taille de fenêtre d’une minute.

  6. Le graphique Monitor est mis à jour pour refléter le résumé, et votre graphique Moniteur de règles ressemble à ceci.

    Capture d’écran du graphique Monitor montrant les données résumées avec une fenêtre d’une minute et une taille de pas appliquées.

  7. Testez votre règle en sélectionnant le bouton Envoyez-moi une action de test. Assurez-vous d’obtenir une alerte. Si vous utilisez l’e-mail, l’arrivée peut prendre une minute ou deux.

    Capture d’écran de l’éditeur de règles avec le bouton « Send me a test action » surligné en rouge.

  8. Démarrez votre règle en sélectionnant Enregistrer et démarrer dans le volet Définition ou en sélectionnant Démarrer dans le ruban.

    Capture d’écran du volet Règles avec le bouton Démarrer mis en surbrillance sur le ruban et le panneau Définition ouvert.

Vous avez créé votre premier objet et règle. Comme étape suivante, essayez de configurer d’autres règles sur l’objet Bike station.

Lorsque vous êtes prêt à essayer d'utiliser Fabric Activator sur vos propres données, suivez les étapes décrites dans l'article Get data for Fabric Activator.

Nettoyer les ressources

Lorsque vous avez terminé avec les règles que vous avez créées dans le cadre du didacticiel, arrêtez-les. Si vous ne désactivez pas les règles, vous continuez à recevoir les notifications associées aux règles. Il est possible que vous engagiez également des frais pour le traitement en arrière-plan. Sélectionnez chaque règle à son tour, puis sélectionnez le bouton Arrêter dans le ruban.

Contenu connexe

Pour en savoir plus sur Microsoft Fabric, consultez :

  • Dernière mise à jour :