2 - Configurer des règles et des actions pour votre appareil dans Azure IoT Central2 - Configure rules and actions for your device in Azure IoT Central

Ce didacticiel vous montre, en tant que générateur, comment configurer des règles et des actions basées sur la télémétrie dans votre application Microsoft Azure IoT Central.This tutorial shows you, as a builder, how to configure telemetry-based rules and actions in your Microsoft Azure IoT Central application.

Dans ce didacticiel, vous créez une règle qui envoie un courrier électronique lorsque la température d’un climatiseur raccordé dépasse 90° F.In this tutorial, you create a rule that sends an email when the temperature in a connected air conditioner device exceeds 90° F.

Ce tutoriel vous montre comment effectuer les opérations suivantes :In this tutorial, you learn how to:

  • Créer une règle basée sur la télémétrieCreate a telemetry-based rule
  • Ajouter une actionAdd an action

Prérequis

Prerequisites

Avant de commencer, vous devez effectuer le tutoriel Définir un nouveau type d’appareil dans votre application pour créer le modèle d’appareil Climatiseur raccordé à utiliser.Before you begin, you should complete the Define a new device type in your application tutorial to create the Connected Air Conditioner device template to work with.

Créer une règle basée sur la télémétrieCreate a telemetry-based rule

  1. Pour ajouter une nouvelle règle basée sur la télémétrie pour votre application, dans le menu de navigation de gauche, choisissez Device Explorer :To add a new telemetry-based rule to your application, in the left navigation menu, choose Device Explorer:

    Page Device Explorer

    Vous voyez le modèle d’appareil Climatiseur raccordé (1.0.0) et l’appareil Climatiseur raccordé-1 que vous avez créé dans le didacticiel précédent.You see the Connected Air Conditioner (1.0.0) device template and the Connected Air Conditioner-1 device you created in the previous tutorial.

  2. Pour commencer à personnaliser votre climatiseur raccordé, choisissez l’appareil que vous avez créé dans le didacticiel précédent :To start customizing your connected air conditioner device, choose the device you created in the previous tutorial:

    Page du climatiseur raccordé

  3. Pour commencer à ajouter une règle dans la vue Règles, choisissez Règles :To start adding a rule in the Rules view, choose Rules:

    Vue Règles

  4. Dans ce didacticiel, vous ajoutez une règle de télémétrie basée sur un seuil.In this tutorial, you add a threshold-based telemetry rule. Pour commencer à créer une règle basée sur un seuil, choisissez Nouvelle règle, puis Télémétrie.To start creating a threshold-based rule, choose New Rule, then Telemetry.

  5. Pour définir votre règle, utilisez les informations du tableau suivant :To define your rule, use the information in the following table:

    ParamètreSetting ValeurValue
    NOMName Température du climatiseurAir conditioner temperature
    Activer la règleEnable rule Il en vaOn
    ConditionCondition Température supérieure à 90Temperature is greater than 90

    Condition de règle de température

Ajouter une actionAdd an action

Lorsque vous définissez une règle, vous définissez également une action à exécuter lorsque les conditions de la règle sont remplies.When you define a rule, you also define an action to run when the rule conditions are met. Dans ce didacticiel, vous ajoutez une action pour envoyer un courrier électronique sous forme de notification indiquant que la règle est déclenchée.In this tutorial, you add an action to send an email as a notification that the rule triggered.

  1. Pour ajouter une Action, faites défiler vers le bas le panneau Configure Telemetry Rule (Configurer une règle de télémétrie) et choisissez + en regard de Actions, puis Courrier électronique :To add an Action, scroll down on the Configure Telemetry Rule panel and choose the + next to Actions, then choose Email:

    Action de règle de température

  2. Pour définir votre action, utilisez les informations du tableau suivant :To define your action, use the information in the following table:

    ParamètreSetting ValeurValue
    ÀTo Votre adresse e-mailYour email address
    NotesNotes La température dans le climatiseur dépasse le seuil.Temperature in air conditioner exceeded threshold.

    Note

    Pour recevoir une notification par courrier électronique, l’adresse e-mail doit être un ID d’utilisateur dans l’application, et l’utilisateur doit s’être connecté au moins une fois à l’application.To receive an email notification, the email address must be a user ID in the application, and that user must have signed in to the application at least once.

    Action de température du Générateur d’applications

  3. Choisissez Enregistrer.Choose Save. Votre règle est répertoriée dans la page Règles :Your rule is listed on the Rules page:

    Règles du Générateur d’applications

Tester la règleTest the rule

Peu après l’enregistrement de la règle, elle devient active.Shortly after you save the rule, it becomes live. Lorsque les conditions définies dans la règle sont remplies, votre application envoie un message à l’adresse e-mail que vous avez spécifiée dans l’action.When the conditions defined in the rule are met, your application sends a message to the email address you specified in the action.

Action Courrier électronique

Étapes suivantesNext steps

Dans ce didacticiel, vous avez appris à :In this tutorial, you learned how to:

  • Créer une règle basée sur la télémétrieCreate a telemetry-based rule
  • Ajouter une actionAdd an action

Maintenant que vous avez défini une règle basée sur un seuil, l’étape suivante suggérée consiste à Personnaliser les vues de l’opérateur.Now that you have defined a threshold-based rule the suggested next step is to Customize the operator's views.

Pour en savoir plus sur les différents types de règles dans Azure IoT Central et comment paramétrer la définition de règle, consultez :To learn more about different types of rules in Azure IoT Central and how to parameterize the rule definition, see: