Créer une règle dans Fabric Activateor

Une fois que vous avez apporté des données de diffusion en continu dans un activateur ou affecter des événements à des objets, vous pouvez créer des règles pour agir sur vos données. L’activation de ces règles peut être l’envoi d’une notification, telle qu’un e-mail ou un message Teams. Et l’activation de ces règles peut déclencher un flux de travail, par exemple démarrer un flux Power Automate.

Conditions préalables

• Pour effectuer correctement cette procédure, vous avez besoin d’un espace de travail avec une capacité avec Microsoft Fabric.

Ouvrir l’activateur

Commencez par ouvrir Fabric dans votre navigateur.

Dans le volet de navigation, sélectionnez Créer>Activateur. Si vous ne voyez pas Créer, sélectionnez l'icône à trois points (...) pour afficher d’autres options.

Sélectionnez Essayez l’exemple de pour créer un activateur prérempli avec des exemples d’événements et d’objets.

Définir une condition de règle et une action

Utilisez Règles pour spécifier les valeurs que vous souhaitez surveiller parmi les événements, les conditions que vous souhaitez détecter et les actions que vous souhaitez que Activator effectue.

Sélectionner vos données de règle

Dans l’explorateur Activator, sélectionnez la propriété ou le flux d’événements à surveiller dans votre règle. Pour plus d’informations sur les propriétés, consultez la section Créer des propriétés .

Une fois que vous avez sélectionné une propriété ou un flux d’événements, vous voyez un aperçu des valeurs d’un exemple d’instances de l’objet.

Créer une nouvelle règle d’activateur

Pour créer une règle, sélectionnez le flux que vous venez d’ajouter et vous devez voir un volet « Créer une règle » sur le côté droit. La section Surveiller de la règle est préremplies avec le flux de données que vous avez sélectionné.

Définir la condition à détecter

Ensuite, choisissez le type de condition que vous souhaitez détecter. Vous pouvez utiliser des conditions qui vérifient :

• sur chaque événement, effectuez une action
• sur chaque événement lorsqu’une valeur est remplie, effectuez une action
• sur chaque événement regroupé par un champ, effectuez une action (par exemple, sur chaque événement PackageId lorsque la température est supérieure à 30)

Enfin, indiquez si vous souhaitez que l’action effectuée vous envoie un e-mail ou vous envoie un message Teams, puis sélectionnez Créer. Les conditions et les actions sélectionnées peuvent être modifiées ultérieurement.

Les graphiques de l’onglet Définition sont mis à jour pour afficher un exemple des événements qui répondent aux conditions que vous définissez.

Si vous accédez à l’onglet Analytique, il existe deux graphiques. Le premier montre le nombre total de fois où la règle s’est déclenchée, pour tous les ID d’objet suivis par Activator. Utilisez ce graphique pour comprendre le volume des notifications déclenchées sur tous les ID d’objet. Le deuxième graphique affiche le nombre total de fois où la règle s’est activée, pour les cinq ID d’objet. Utilisez ce graphique pour mieux comprendre s’il existe des ID d’objet particuliers qui contribuent le plus aux activations.

Définir l’action à entreprendre

Enfin, utilisez la section Action pour choisir ce qu’il faut faire lorsque la condition est détectée.

Voici les types d’actions pris en charge :

• E-mail : un e-mail est envoyé aux destinataires spécifiés.

• Teams : un message Teams est envoyé aux destinataires, aux conversations de groupe ou au canal spécifiés.

• Élément Fabric - exécute le pipeline Fabric sélectionné, le bloc-notes Fabric, la définition de travail Fabric Spark, la fonction Fabric.

• Action personnalisée : active un flux Power Automate.

Différents types d’actions ont des paramètres différents. Certains de ces paramètres sont : l’adresse e-mail à laquelle vous souhaitez envoyer, le canal Teams ou la conversation de groupe, le flux de travail à démarrer, la ligne d’objet ou des informations supplémentaires (contexte). Pour Le contexte, vous pouvez sélectionner les propriétés supplémentaires à inclure dans le message d’alerte.

Vous pouvez également baliser des propriétés en entrant @ pour ajouter du contexte aux actions que vous envoyez. Par exemple : @bikeId.

Notez que si vous effectuez un résumé de la propriété sur la carte Moniteur, la valeur d’origine de la propriété est envoyée dans l’action et non la valeur résumée.

Vous pouvez également sélectionner Modifier l’action pour afficher un éditeur avec un aperçu du message que l’action envoie et des options pour ajouter plus d’informations à l’action.

Tester votre règle

Après avoir créé une règle, testez-la en sélectionnant M’envoyer une alerte de test. Ce bouton permet de rechercher un événement passé pour lequel l’activation de la règle est vraie et d’envoyer une alerte afin que vous puissiez voir à quoi ressemble l’alerte pour cet événement.

• L’alerte de test vous parvient toujours, quel que soit le champ du destinataire de la carte Action
• L’option M’envoyer une alerte de test n’est activée que si vous avez au moins un événement passé pour lequel la condition de la règle est vraie.

Démarrer et arrêter votre règle

Les règles sont créés dans un état Arrêté. Cela signifie qu’elles ne sont pas évaluées en tant que flux de données dans le système, et n’effectuent aucune action en conséquence. Après avoir défini la règle, sélectionnez Enregistrer et commencer pour activer la règle. Si vous n’êtes pas prêt à démarrer votre règle, enregistrez-la et revenez-y ultérieurement. Lorsque vous êtes prêt, sélectionnez Démarrer dans la barre d’outils pour que Activator commence à exécuter la règle et à prendre des mesures.

Une fois démarrée, vous voyez En cours d’exécution dans la zone de titre de la carte de règle. En outre, l’icône dans l’Explorateur montre que la règle est en cours d’exécution. Lorsque vous démarrez la règle, les nouvelles activations commencent à s’exécuter sur de nouvelles données ingérées. Votre règle n’est pas activée sur les données qui ont déjà été ingérées. Pour arrêter l’alerte, sélectionnez Arrêter.

Si vous apportez des modifications à la règle (par exemple, vous modifiez la condition qu’elle recherche), sélectionnez Mettre à jour dans la barre d’outils pour vous assurer que la règle en cours d’exécution utilise les nouvelles valeurs.

Lorsque vous supprimez une règle (ou un objet), le traitement principal des données peut prendre jusqu’à cinq minutes. Les règles supprimées peuvent continuer à surveiller les données et à effectuer des actions pendant quelques minutes après leur suppression.

Créer des propriétés

Parfois, vous devez réutiliser la logique de règle sur plusieurs règles. Créez une propriété pour définir une condition ou une mesure réutilisable, puis référencez cette propriété à partir de plusieurs règles.

Pour créer une propriété, sélectionnez le flux ajouté à l’objet qui vous intéresse et sélectionnez Nouvelle propriété dans le ruban, puis sélectionnez la propriété que vous souhaitez utiliser dans la logique de règle.

Une fois que vous avez défini une propriété, vous pouvez la référencer à partir d’une ou plusieurs règles. Ici, nous faisons référence à la propriété TempératureTrop chaud pour le médicament.

Nettoyer les ressources

Supprimez l’exemple de flux d’événements en sélectionnant les points de suspension (...) à droite du flux d’événements de livraison de colis , puis en sélectionnant Supprimer.

Étape suivante

Contenu connexe

• Vue d’ensemble des règles d’activateur
• Didacticiel sur l’activateur