:Orchestration de scénarios cloud

Prérequis

Une instance Edge est créée.

Configurer les environnements

.

Créer une règle de scénario

1. Connectez-vous à la console IoT Platform.

2. Dans le volet de navigation de gauche, choisissez Message Forwarding > Scene Orchestration.

3. Cliquez sur Create Rule.

4. Configurez les paramètres suivants et cliquez sur OK.

   Parameter	Description
   Rule Name	Nom de la règle. Il doit comporter entre 1 et 30 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des tirets (-).
   Rule Description	Facultatif. Description de la règle.

5. Cliquez sur Edit dans la boîte de dialogue pour configurer la règle.

   Vous pouvez également cliquer sur

   View

   à côté du nom de la règle pour la configurer.

   Exemple : Une règle de scénario automatise un climatiseur. Lorsque le capteur de température signale une valeur inférieure à 16 °C entre 12 h 00 et 23 h 59, le climatiseur augmente la température à 26 °C.

   Configuration des paramètres :

   Cliquez sur Edit dans le coin supérieur droit pour renommer la règle. Le tableau suivant décrit les autres paramètres.

   Parameter	Description
   Triggers	Options : Device Trigger et Timed Trigger. Plusieurs déclencheurs sont reliés par une logique OU. Device Trigger : Sélectionnez un produit, un ou tous les appareils, ainsi qu'une ou toutes les propriétés ou événements. Timed Trigger : Spécifiez une heure à l'aide d'une expression CRON composée de cinq champs : minute, heure, jour, mois et jour de la semaine (0 ou 7 = dimanche, 1–6 = lundi à samedi). Exemples : 0 18 * * * (tous les jours à 18 h 00), 0 18 * * 5 (tous les vendredis à 18 h 00). Les astérisques (*) sont des caractères génériques. CRONTAB. Dans l'exemple, le Device Trigger se déclenche lorsque le capteur de température signale une valeur inférieure à 16 °C.
   Condition	La règle s'exécute uniquement lorsque toutes les conditions sont remplies. Options : Device Status et Time Range. Plusieurs conditions sont reliées par une logique ET. Device Status : Sélectionnez un produit, un appareil et une propriété ou un événement. Time Range : Spécifiez l'heure de début et l'heure de fin au format yyyy-mm-dd hh24:mi:ss. Dans l'exemple, la plage Time Range est définie de 12 h 00 à 23 h 59.
   Action	Actions à effectuer lorsque la règle se déclenche. Configurez une ou plusieurs actions. L'échec d'une action n'affecte pas les autres actions. Device Output : Sélectionnez un produit, un appareil et une propriété accessible en écriture ou un service. IoT Platform définit la propriété ou appelle le service lorsque les conditions de la règle sont remplies. Rule Output : Sélectionnez une autre règle à appeler. La règle appelée ignore ses propres déclencheurs et évalue uniquement ses conditions. Si toutes les conditions sont validées, les actions de la règle appelée s'exécutent. Exemple : Lorsque la règle A est appelée, ses déclencheurs sont ignorés. Si toutes les conditions ET sont validées, IoT Platform exécute les actions de la règle A. Dans l'exemple, Device Output règle la température du climatiseur à 26 °C.
   Delayed Execution	Affiché dans les options avancées. Retarde l'exécution de l'action pendant la durée spécifiée. Valeurs valides : 0 à 86400. Unité : secondes.

Démarrer une règle de scénario

Démarrez les règles de scénario sur la page Scene Orchestration.

Pour démarrer une règle de scénario :

1. Connectez-vous à la console IoT Platform. Dans le volet de navigation de gauche, choisissez Message Forwarding > Scene Orchestration.

2. Recherchez la règle de scénario et cliquez sur Start. Le statut de la règle passe à Running.

Après le démarrage de la règle :

• Si la règle s'exécute dans le cloud, configurez le routage des messages afin que les propriétés et les événements des appareils soient envoyés à IoT Hub.Configurer le routage des messages.

• Si la règle s'exécute en périphérie (edge), stop running d'abord son exécution dans le cloud, puis assignez-la à l'instance Edge.Autres opérations pour l'orchestration de scénarios.

Consulter les journaux

Consultez les journaux des règles de scénario et les résultats d'exécution sur la page des détails.

1. Dans le volet de navigation de gauche de la console IoT Platform, choisissez Message Forwarding > Scene Orchestration.

2. Recherchez la règle cible et cliquez sur Log.

3. Cliquez sur Details pour afficher les détails du journal.

   Sur la page des journaux d'exécution, vous pouvez filtrer les journaux par Status et Time Range. La liste des journaux contient les colonnes Execution Time, Execution Status et Actions.

   Remarque

   Si un journal est dans l'état

   Failed

   , cliquez sur

   Details

   dans la colonne Actions pour afficher les détails de l'échec.

Autres opérations pour l'orchestration de scénarios

• Supprimer des règles de scénario :

  1. Sur la page Scene Orchestration, recherchez la règle cible.

  2. Cliquez sur Delete à côté du nom de la règle, puis cliquez sur OK.

• Déclencher des règles de scénario :

  Après avoir démarré une règle de scénario, vous pouvez la déclencher manuellement.

  1. Sur la page Scene Orchestration, recherchez la règle cible.

  2. Cliquez sur Trigger à côté du nom de la règle. La règle s'exécute une fois, en lançant toutes les actions indépendamment des conditions de déclenchement.

• Exécuter une règle de scénario sur une instance Edge :

  Pour déployer une règle de scénario sur une instance Edge :

  Important

  Assurez-vous d'avoir arrêté l'exécution de la règle de scénario dans le cloud.

  1. Connectez-vous à la console Link IoT Edge. Dans le volet de navigation de gauche, cliquez sur Edge Instances. Recherchez l'instance Edge que vous avez créée et cliquez sur View.

  2. Sur la page Instance Details, cliquez sur l'onglet Scenes, puis cliquez sur Assign Scene.

  3. Dans le panneau Assign Scene, cliquez sur Assign à côté du nom de la règle, puis cliquez sur Close.

  4. Redéployez l'instance Edge.