Partager via

Tutoriel : Créer et activer une règle de Fabric Activator

L’activateur fabric dans Microsoft Fabric vous permet d’effectuer des actions lorsque des modèles ou des conditions sont détectés dans les flux de données. Si vous débutez avec Fabric Activator, consultez Qu'est-ce que Fabric Activator ?. Dans ce tutoriel, vous utilisez les exemples de données inclus dans Fabric Activateor pour effectuer les tâches suivantes :

  • Passer en revue un exemple d’activateur
  • 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 avec la capacité Fabric. Vous pouvez en savoir plus sur les espaces de travail Fabric dans l’article Espaces de travail. Si vous n’avez pas Fabric, vous êtes invité à démarrer une version d’évaluation.

Créer un exemple d’activateur

  1. Accédez au portail Microsoft Fabric.

  2. Dans le volet de navigation gauche, sélectionnez Créer, puis activez l’activateur dans la section Real-Time Intelligence . Si vous ne voyez pas Créer, cliquez sur les trois points (...), puis sélectionnez Créer.

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

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

    Capture d’écran montrant l’option permettant d’ajouter des données ou d’utiliser les exemples de données.

Exploration des données

Dans cette étape, nous explorons les données d’eventstreams sur lesquelles cet exemple est basé.

Le nouvel activateur comporte une section Explorateur. Faites défiler vers le bas et sélectionnez le flux d’événements de livraison de package.

Capture d’écran de l’activateur avec le flux d’événements de remise de colis sélectionné.

Ces évènements montrent l’état en temps réel des packages qui sont en cours de livraison.

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 que Fabric Activateor prenne.

Le volet Explorateur affiche des objets, comme les flux d’événements, pour cet activateur. Événements de remise sont l’un des objets créés à partir du flux d'événements de livraison de colis .

  1. Dans le volet Explorateur, sélectionnez l’objet appelé Événements de livraison. Vous pouvez créer des règles sur les objets qui utilisent les données d’eventstream Événements de livraison de packages. Par exemple, une règle qui vérifie les packages pour la température.

    Capture d’écran montrant la table des événements de remise et la colonne de température.

  2. Notez que la section Événements par ID d’objet est organisée par ID de package. L’ID de package est l’ID de la colonne qui identifie chaque package de manière unique. Nous utilisons cet ID unique pour affecter les événements de package aux objets Package.

    Capture d’écran montrant la colonne ID unique dans l’écran Événements par ID d’objet.

  3. Sélectionnez la règle Température appelée Trop chaud pour les médicaments.

    Capture d’écran montrant l’exemple de règle.

  4. Dans le volet le plus à droite, consultez le volet Définition pour voir comment fonctionne la règle. Dans la section Surveiller, sélectionnez Température. Les valeurs de température proviennent de la colonne Température de la table Événements de livraison. La colonne Température est visible dans une capture d’écran précédente.

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

  5. Dans la section Summarization, vous voyez la taille de la fenêtre, la taille de l’étape et l’opération d’agrégation (moyenne) utilisée. Il recherche essentiellement la moyenne des lectures de température sur une fenêtre de 10 minutes.

  6. Dans la section Condition , vous voyez la condition de règle pour surveiller les températures supérieures à 20 degrés Celsius.

  7. Faites défiler vers le bas jusqu’à Filtre de propriété. Notre règle s’applique uniquement aux packages contenant des médicaments. Dans la table Événements de livraison, la règle examine la colonne nommée Contenus de soins spéciaux. Dans la colonne de Contenu de soins spéciaux, certains des paquets ont une valeur de Médecine.

    Capture d’écran montrant la section Filtre de propriétés du volet Définition.

  8. Enfin, faites défiler vers le bas jusqu’à Action. Notre règle envoie un message Teams si la condition est remplie.

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

Nous avons créé une règle d’activateur de Fabric. La règle s’exécute sur l’eventstream des événements de livraison de package. La règle recherche les packages qui ont des médicaments et vérifie si la température est maintenant supérieure à 20 degrés Celsius. Lorsque la température devient supérieure à 20 degrés Celsius, un message Teams est envoyé.

Examinez les autres règles pour comprendre comment ils fonctionnent.

Démarrer la règle

Vous connaissez maintenant les événements et les objets utilisés pour créer une règle. L’étape suivante consiste à démarrer la règle.

  1. Sélectionnez Trop chaud pour les médicaments.

  2. Si vous le souhaitez, envoyez un message de test en sélectionnant Envoyer une action de test. Vérifiez d’abord 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 devez recevoir un message similaire à celui suivant :

    Capture d’écran montrant l’exemple de notification Teams.

  4. Sélectionnez Démarrer. La règle devient alors active. Vous recevez un message Teams chaque fois qu’un package de médicaments est trop chaud. La règle doit se déclencher plusieurs fois toutes les heures.

    Capture d’écran montrant le bouton Démarrer mis en surbrillance.

  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 Arrêter sur le ruban mis en surbrillance.

Créer un objet

Maintenant, il est temps de créer un objet par vous-même. Dans cette section, supprimez l’objet Package. Ensuite, recréez-le pour suivre l’état des packages en transit où les heures de livraison deviennent supérieures à 25.

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

    Capture d’écran montrant le menu Supprimer sur l’objet Package.

  2. Sélectionnez le flux des événements de remise de package , puis sélectionnez Nouvel objet dans le ruban.

    Capture d’écran montrant le bouton Nouvel objet sur le ruban.

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

    1. Nommez votre nouvel objet Package2.

    2. Choisissez PackageId comme ID unique.

    3. Sélectionnez HoursInTransit et City comme propriétés de l’objet.

    4. Sélectionnez Créer.

      Capture d’écran montrant le volet Générer un objet.

Créer une règle

Créez une règle qui vous alerte si le temps de transit de la livraison dépasse un seuil.

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

    Capture d’écran montrant le bouton Nouvelle règle sur le ruban.

  2. Dans le volet Créer une règle , procédez comme suit :

    1. Pour Condition, sélectionnez Augmentations ci-dessus.

    2. Pour Valeur, sélectionnez 25.

    3. Pour Occurrence, sélectionnez Chaque fois que la condition est remplie.

    4. Pour Action, sélectionnez l'une des options pour envoyer un e-mail à un message dans Teams.

    5. Sélectionnez Créer.

      Capture d’écran montrant le volet Créer une règle.

  3. Vous devez voir la règle sous HoursInTransit dans le volet Explorateur. Sélectionnez la règle. Dans le volet central, sélectionnez l’icône de crayon en haut et mettez à jour le nom en temps de transit moyen au-dessus de la cible.

    Capture d’écran montrant l’icône de crayon pour modifier le nom de la règle.

  4. Dans le volet Définition à droite, sélectionnez HoursInTransit. Sélectionnez ensuite Ajouter une synthèse>Moyenne.

    Capture d’écran montrant le volet Définition avec l’agrégation moyenne sélectionnée.

  5. Définissez une taille de fenêtre d’agrégation de cinq minutes et une taille d’étape de cinq minutes, puis sélectionnez Enregistrer.

    Capture d’écran montrant le volet Définition avec la fenêtre et la taille de l’étape.

  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 de temps de transit moyen pour le didacticiel sur l’activateur.

  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 un e-mail, l’arrivée peut prendre une minute ou deux.

    Capture d’écran montrant le bouton Test sélectionné sur le ruban.

  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 montrant le bouton Démarrer du ruban sélectionné.

    Vous avez créé votre premier objet et règle. À l’étape suivante, vous pouvez essayer de configurer d’autres règles sur l’objet Package2.

    Lorsque vous êtes prêt à essayer d’utiliser Fabric Activateor sur vos propres données, suivez les étapes décrites dans l’article Obtenir des données pour Fabric Activateor .

Nettoyer les ressources

Une fois que vous avez terminé avec les règles que vous avez créées dans le cadre du didacticiel, veillez à les arrêter. Si vous ne désactivez pas les règles, vous continuez à recevoir les notifications associées aux règles. Vous pouvez également entraîner 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

Vous pouvez également en apprendre davantage sur Microsoft Fabric :

  • Last updated on