Créer des processus et automatisations Connected Field Service

25 minutes

La solution Connected Field Service de Dynamics 365 vous permet de surveiller à distance les appareils compatibles IoT pour suivre la durée de bon fonctionnement, les statistiques des appareils, les anomalies et plus encore. Dès qu’un appareil IoT communique une anomalie ou une exception, les informations sont transmises à Connected Field Service sous forme d’alerte. Une fois l’alerte capturée, la capacité de Dynamics 365 à créer une automatisation et un processus métier nous permet de développer des processus automatisés pour agir en fonction des problèmes, les acheminer et les résoudre.

L’objectif de ce labo pratique est de vous présenter la création et l’automatisation des processus Connected Field Service et de vous montrer comment ces éléments peuvent être utilisés dans le cadre d’une solution IoT globale.

Scénario

Vous travaillez pour une entreprise de plomberie et de chauffage qui vend et assure la maintenance d’appareils domestiques intelligents. Comme bon nombre des appareils dont vous effectuez la maintenance sont des appareils intelligents, les informations provenant de ceux-ci peuvent être capturées à distance pour faciliter la maintenance de l’équipement. Votre organisation dispose de plusieurs scénarios et processus définis pour la maintenance de l’équipement. Ces processus peuvent varier en fonction de plusieurs facteurs, notamment :

Type d’appareil nécessitant de la maintenance
Gravité du problème détecté
Ancienneté de l’appareil
Emplacement de l’appareil
Disponibilité des ressources pour effectuer la maintenance d’un appareil spécifique

Les éléments ci-dessus représentent seulement une petite partie des facteurs sur lesquels votre organisation s’appuie pour déterminer le processus de maintenance de l’équipement.

Vous avez récemment installé beaucoup de thermostats intelligents. Ces appareils ont été pratiques pour pouvoir suivre les relevés de température et d’humidité dans les zones où il est important de maintenir une température et une humidité constantes. Comme vous avez à présent plus d’informations disponibles, vous devez créer de nouveaux processus pour gérer et résoudre les problèmes signalés par ces appareils. Vous devez en premier lieu vous concentrer sur l’automatisation du processus utilisé pour les problèmes de température.

Votre organisation cherche à implémenter le processus suivant :

Si un appareil relève une température supérieure à 70 degrés, une alerte doit être émise dans votre environnement Connected Field Service.
Si le relevé de température est compris entre 70 et 85 °, une commande doit être envoyée pour réinitialiser l’appareil à distance et voir si le problème se résout de lui-même.
Si le relevé de température est compris entre 86 et 100 °, un conseiller de service doit être en mesure de créer un incident pour tenter de résoudre le problème.
- Si le conseiller de service ne peut pas résoudre le problème, un ordre de travail doit être créé et un technicien sur site doit être planifié pour l’élément.
Si le relevé de température est supérieur à 100 °, il s’agit d’un événement considéré comme potentiellement catastrophique. Un ordre de travail doit être créé et un technicien sur site doit être planifié pour l’élément.

Exercice : automatiser et personnaliser

Avant de commencer : cet exercice suppose que vous avez déjà un déploiement de Connected Field Service connecté avec Azure IoT Hub ou une instance d’IoT Central. Si vous ne disposez pas d’un environnement Connected Field Service, nous vous recommandons de suivre le module Présentation de Connect Field Service. Ce module vous permet d’installer et de configurer un environnement Connected Field Service.

Tâche : créer une solution Processus d’alerte IoT

Dans cette première tâche, nous créons une solution Dynamics 365 qui nous permet de stocker l’ensemble des personnalisations et processus que nous créons dans ce module. Non seulement cela facilite le transport potentiel de ces personnalisations ultérieurement, mais cela nous permet également de nettoyer nos environnements après avoir terminé le cours.

Accédez au site Power Apps et vérifiez que vous êtes dans l’environnement correct.
Cliquez sur Solutions, puis sur Nouvelle solution.
Donnez le nom Processus d’alerte IoT à la solution.
Cliquez sur la liste déroulante Éditeur et sélectionnez Éditeur.
Configurez l’Éditeur comme suit :
- Nom d’affichage : Cours sur Connected Field Service
- Nom : Cours sur Connected Field Service
- Préfixe : cfs
Cliquez sur Enregistrer.
Recliquez sur la liste déroulante Éditeur et sélectionnez l’éditeur que vous avez créé.
Dans le champ Version, saisissez 1.0.0.0. Cliquez sur Créer.
Cliquez sur la solution Processus d’alerte IoT que vous avez créée pour l’ouvrir.
Cliquez sur Ajouter un élément existant, puis sélectionnez Table.
Sélectionnez les tables Incident, Alerte IoT et Ordre de travail, puis cliquez sur Suivant.
Sélectionnez Inclure tous les objets pour les trois tables, puis cliquez sur Ajouter.

Tâche : personnaliser la table Alerte IoT

Pour faciliter l’automatisation des éléments et actions basés sur les alertes IoT, nous devons être en mesure d’extraire des informations spécifiques pour les alertes IoT générées. Nous pouvons interroger et déclencher des éléments basés sur ces données. Comme les données d’alerte ne comportent qu’une chaîne JSON comportant toutes les données, nous devons créer d’autres champs dans la table Alerte IoT. Elle nous permet d’envoyer des données spécifiques et de créer des requêtes à partir de ces champs.

Vérifiez que vous vous trouvez toujours dans la solution Processus d’alerte IoT.
Cliquez sur la table Alerte IoT pour l’ouvrir.
Cliquez sur l’onglet Colonnes, puis sur Nouvelle colonne.
Saisissez Relevé pour Nom d’affichage, sélectionnez Nombre entier pour Type de données, puis cliquez sur Options avancées.
Saisissez 0 pour Valeur minimale et 250 pour Valeur maximale, puis cliquez sur Enregistrer.
Répétez le processus pour ajouter ces colonnes :
- Seuil
  - Nom d’affichage : Seuil
  - Type de données : Nombre entier
  - Valeur minimale : 0
  - Valeur maximale : 250
- Type de relevé
  - Nom d’affichage : Type de relevé
  - Type de données : Oui/Non
  - Remplacez la valeur Non par Température.
  - Remplacez la valeur Oui par Humidité.
  - Choix par défaut : Température
- Sortie de la règle
  - Nom d’affichage : Sortie de la règle
  - Type de données : Une seule ligne de texte
- Client
  - Nom d’affichage : Client
  - Type de données : Recherche
  - Type d’enregistrement cible : Compte
À l’aide des chemins de navigation, cliquez sur Alerte IoT.
Cliquez sur Relations sous Schéma.
Cliquez sur Nouvelle relation et sélectionnez Un-à-plusieurs.
Sélectionnez Incident pour l’Entité associée, saisissez Alerte IoT pour Nom d’affichage de la colonne de recherche, puis cliquez sur Terminé.
Sélectionnez le nom de la solution.
Cliquez sur Publier toutes les personnalisations, puis attendez la fin de la publication.
Cliquez sur le bouton …, puis sélectionnez Basculer vers l’affichage classique.
Développez Entités et l’entité Alerte IoT, puis sélectionnez Relations 1 à N.
Cliquez sur Mappages, puis sur Nouveau.
Configurez le mappage à partir de la liste comme suit, puis cliquez sur OK :
- Champ d’entité source : cfs_customer
- Champ d’entité cible : customerid
Cliquez sur Enregistrer et fermer.
Cliquez sur Publier toutes les personnalisations, puis attendez la fin de la publication.
Fermez l’Explorateur de solutions.

Tâche : créer un flux pour renseigner les valeurs

Maintenant que nous disposons des champs permettant d’enregistrer les données nécessaires, nous devons les renseigner avec les données adéquates. Nous y parvenons à l’aide de certaines des actions de valeur de champ basées sur JSON incluses dans la solution Connected Field Service. Nous créons un flux qui exécute une action de valeur de champ basée sur JSON pour extraire une donnée spécifique du champ de données d’alerte. Ensuite, nous renseignons cette donnée dans l’un des champs que nous avons créés dans la tâche précédente.

Accédez au site Power Apps et vérifiez que vous êtes dans l’environnement correct.
Cliquez sur Solutions, puis sur la solution Processus d’alerte IoT pour l’ouvrir.
Cliquez sur Nouveau, puis sélectionnez Automatisation>Flux de cloud>Automatisé.
Définissez le champ Nom du flux sur Renseigner les champs d’alerte.
Recherchez Microsoft Dataverse et sélectionnez Dataverse. Veillez à sélectionner le connecteur Dataverse vert.
Sélectionnez Lorsqu’un enregistrement est créé, mis à jour ou supprimé, puis cliquez sur le bouton Créer.
Sélectionnez Ajouté pour Condition de déclenchement, Alertes IoT pour Nom de la table et Organisation pour Étendue, puis cliquez sur Nouvelle étape.
Recherchez Parse et sélectionnez Parse JSON.
Cliquez sur le champ Contenu, puis sélectionnez Alert Data dans le volet Contenu dynamique.

Collez ce schéma Json dans le champ Schéma, puis cliquez sur + Nouvelle étape.

{
    "type": "object",
    "properties": {
        "deviceid": {
            "type": "string"
        },
        "readingtype": {
            "type": "string"
        },
        "reading": {
            "type": "integer"
        },
        "eventtoken": {
            "type": "string"
        },
        "threshold": {
            "type": "integer"
        },
        "ruleoutput": {
            "type": "string"
        },
        "time": {
            "type": "string"
        }
    }
}

Recherchez Mettre à jour une ligne et sélectionnez Mettre à jour une ligne. Veillez à sélectionner le connecteur Dataverse vert.
Redéfinissez le nom de l’étape sur Mettre à jour l’alerte.
Sélectionnez Alertes IoT pour Nom de l’entité, cliquez sur le champ ID de ligne et sélectionnez IoT Alert dans le volet Contenu dynamique.
Cliquez sur Afficher les options avancées.
Cliquez sur le champ Relevé et sélectionnez l’option reading de l’étape Parse JSON dans le volet Contenu dynamique.
Cliquez sur le champ Type de relevé et sélectionnez Saisir une valeur personnalisée.
Cliquez sur l’onglet Expression, collez cette expression, puis cliquez sur OK. Assurez-vous que Parse_JSON correspond au nom de l’étape Parse JSON.
```
if(equals(body('Parse_JSON')?['readingtype'], 'Temperature'), false, true)
```
Cliquez sur le champ Sortie de la règle et sélectionnez ruleoutput depuis l’action Parse JSON dans le volet Contenu dynamique.
Cliquez sur le champ Seuil et sélectionnez threshold depuis l’action Parse JSON dans le volet Contenu dynamique.
Votre flux terminé devrait ressembler à cette image :
Cliquez sur Enregistrer.
Ne fermez PAS cette page.

Tâche : ajouter les étapes du flux de réinitialisation à distance

Après avoir extrait les données adéquates et les avoir placées dans les champs adéquats, nous devons ajouter de nouvelles étapes au flux. Ces étapes déterminent la valeur de température dans le champ Relevé. Si elle est comprise entre 71 et 85 °, elle doit entraîner la création automatique d’une commande d’appareil IoT qui effectue une réinitialisation de l’appareil, puis son envoi à l’appareil.

Revenez au flux et cliquez sur Nouvelle étape.
Sélectionnez Condition.
Cliquez sur le champ Choisir une valeur et sélectionnez Reading depuis l’étape Mettre à jour l’alerte dans le volet Contenu dynamique.
Sélectionnez l’option est supérieur ou égal à.
Saisissez 71 pour Valeur, cliquez sur Ajouter, puis sélectionnez Ajouter une ligne.
Cliquez sur le champ Choisir une valeur et sélectionnez Reading depuis l’étape Mettre à jour l’alerte dans le volet Contenu dynamique.
Sélectionnez est inférieur ou égal à.
Saisissez 85 pour Valeur.
Votre condition devrait maintenant ressembler à cette image :
Accédez à la branche Si oui et cliquez sur Ajouter une action.
Recherchez Ajouter une nouvelle ligne, puis sélectionnez Ajouter une nouvelle ligne.
Redéfinissez le nom de l’étape sur Créer une commande de réinitialisation.
Sélectionnez Commandes d’appareil IoT pour Nom de la table, cliquez sur le champ Nom, puis sélectionnez Description depuis l’action Lorsqu’un enregistrement est créé, mis à jour ou supprimé dans le volet Contenu dynamique.
Ajoutez Réinitialisation de l’appareil dans le champ Nom, puis cliquez sur Afficher les options avancées.
Cliquez sur le champ Actif client et tapez msdyn_customerassets().
Placez le curseur entre ( et ) et sélectionnez Customer Assets (Value) depuis l’action Lorsqu’un enregistrement est créé, mis à jour ou supprimé dans le volet Contenu dynamique.
Cliquez sur le champ Appareil et tapez msdyn_iotdevices().
Placez le curseur entre ( et ) et sélectionnez IoT Device (Value) depuis l’action Lorsqu’un enregistrement est créé, mis à jour ou supprimé dans le volet Contenu dynamique.
Cliquez sur le champ Alerte principale et tapez msdyn_iotalerts().
Placez le curseur entre ( et ) et sélectionnez IoT Alert depuis l’action Mettre à jour l’alerte dans le volet Contenu dynamique.

Collez ce code JSON dans le champ Message :

{"CommandName":"Reset Thermostat","Parameters":{}}

Cliquez sur Masquer les options avancées.
Cliquez sur Ajouter une action.
Recherchez Mettre à jour une ligne et sélectionnez Mettre à jour une ligne.
Redéfinissez le nom de l’étape sur Désactiver l’alerte.
Sélectionnez Alertes IoT pour Nom de la table, cliquez sur le champ ID d’enregistrement et sélectionnez IoT Alert depuis l’action Mettre à jour l’alerte dans le volet Contenu dynamique.
Cliquez sur Afficher les options avancées.
Recherchez le champ Statut et définissez-le sur Inactif.
Cliquez sur Masquer les options avancées.
Le nouveau composant du flux devrait maintenant ressembler à cette image :
Cliquez sur Enregistrer.

Tâche : modifier le flux CFS - Processus d’alerte IoT

À l’heure actuelle, un flux de processus métier nommé Flux CFS - Processus d’alerte IoT nous permet de guider les utilisateurs dans la résolution d’une alerte lorsqu’elle est déclenchée. Lorsqu’un relevé de température est compris entre 86 et 100 °, nous devons créer un enregistrement d’incident dans le processus métier. Ensuite, nous devons créer un ordre de travail si nous ne pouvons pas résoudre l’incident. Si le relevé de température est supérieur à 100 °, le processus métier doit ignorer la phase d’incident et passer directement à l’ordre de travail. Dans cette tâche, nous allons modifier le flux CFS - Processus d’alerte IoT pour refléter ces besoins spécifiques.

Accédez au site Power Apps et vérifiez que vous êtes dans l’environnement correct.
Cliquez sur Solutions, puis sur la solution Processus d’alerte IoT pour l’ouvrir.
Cliquez sur Ajouter un élément existant, puis sélectionnez Automatisation>Processus.
Recherchez CFS, sélectionnez Flux CFS - Processus d’alerte IoT, puis cliquez sur Ajouter.
Ouvrez le Flux CFS - Processus d’alerte IoT.
Cliquez sur le bouton Désactiver pour désactiver le processus.
Confirmez la désactivation.
Développez Détails dans la phase Création d’alerte IoT.
Sous Composants, faites glisser Étape de données sous l’étape Heure de l’alerte.
Configurez l’Étape de données comme suit :
- Nom de l’étape : Relevé
- Champ de données : Relevé
Cliquez sur Appliquer pour enregistrer vos modifications.
Répétez les étapes 9 à 11 pour ajouter les Étapes de données suivantes à la phase Création d’alerte IoT :
- Seuil
- Type de relevé
- Sortie de la règle
Cliquez sur l’onglet Composants, puis faites glisser le composant Condition à droite de la phase Création d’alerte IoT.
Dans Nom d’affichage de la condition, saisissez Condition de température.
Configurez la règle 1 comme suit :
- Champ : Relevé
- Opérateur : Est supérieur ou égal à
- Type : Valeur
- Valeur : 86
Cliquez sur le bouton Nouveau pour ajouter une autre règle.
Configurez la règle 2 comme suit :
- Champ : Relevé
- Opérateur : Est inférieur ou égal à
- Type : Valeur
- Valeur : 100
Vérifiez que le champ Logique de la règle est défini sur And.
Cliquez sur Appliquer.
Sélectionnez la phase Condition de température, cliquez sur l’icône Connecteur, puis sélectionnez Reconnecter dans le menu qui s’affiche.
Sélectionnez la phase Créer un ordre de travail comme 2e point.
Votre flux de processus métier devrait maintenant ressembler à cette image :
Cliquez sur Enregistrer, puis sur Activer pour activer le Flux CFS - Processus d’alerte IoT.
Fermez la fenêtre ou l’onglet de navigateur de l’éditeur de processus.
Cliquez sur Terminé dans la fenêtre précédente pour la solution.
Cliquez sur Solutions, puis sur Publier toutes les personnalisations.

Tâche : tester l’automatisation que vous venez de créer

Maintenant que nous pouvons créer les personnalisations, le flux et les flux de processus métier nécessaires, un simulateur nous permet de tout tester afin de nous assurer qu’il exécute les fonctionnalités souhaitées.

Accédez au site Power Apps et vérifiez que vous êtes dans l’environnement correct.
Cliquez sur Actifs client, puis sur le bouton Nouveau.
Saisissez Démarrer le thermostat pour Nom et sélectionnez Adventure Works pour Compte, puis cliquez sur Enregistrer.
Dans le champ ID d’appareil, saisissez smt-9876, puis cliquez sur Enregistrer.
Cliquez sur Enregistrer des appareils.
Cliquez sur OK.
Dans votre navigateur web, cliquez sur un nouvel onglet et accédez au portail Azure. (Connectez-vous à Azure si vous y êtes invité. Vous avez besoin d’un abonnement Azure associé au compte que vous utilisez.)
Cliquez sur Groupes de ressources et ouvrez votre groupe de ressources.
Ouvrez le IoT Hub que vous utilisez avec Connected Field Service et sélectionnez le Simulateur.
Sélectionnez l’URL du simulateur pour ouvrir le simulateur de thermostat. (Le simulateur devrait s’ouvrir dans un nouvel onglet.)
Sur le simulateur, cliquez sur Connexion.
Basculez vers votre abonnement Azure, puis fermez l’écran App Service du simulateur.
Ouvrez le Hub IoT.
Mettez le nom du hub IoT en surbrillance et copiez-le.
Basculez vers l’écran du simulateur et collez le nom du hub IoT dans le champ Hôte.
Basculez vers votre abonnement Azure, puis sélectionnez Stratégies d’accès partagé.
Ouvrez la stratégie iothubowner et copiez la clé primaire.
Basculez vers l’écran du simulateur et collez la clé primaire dans le champ Clé.
Cliquez sur le bouton Connecter.
Cliquez sur le bouton Actualiser pour vous assurer que tous les appareils enregistrés sont disponibles.
Dans la liste déroulante Sélectionner un appareil, sélectionnez l’appareil smt-9876. (Un point vert doit s’afficher en regard du bouton Actualiser et, après quelques secondes, il devrait commencer à transmettre des informations.)
Réglez le Curseur de température sur 75 degrés et attendez que le statut de la température soit enregistré dans la fenêtre Messages envoyés.

Comme la température était comprise entre 71 et 85 °, une commande est envoyée à l’appareil pour le redémarrer. (L’envoi de la commande de redémarrage à l’appareil peut prendre plusieurs minutes, selon la vitesse d’Internet.)
Basculez vers l’onglet de navigateur dans lequel Connected Field Service est chargé.
Cliquez sur Alertes IoT.
Basculez vers la vue Alertes IoT inactives.
Ouvrez l’alerte Relevé de température de 75 supérieur au seuil de 70.
Cliquez sur l’onglet Commandes. (Vous devriez voir qu’une commande a été envoyée à l’appareil.)
Basculez vers l’onglet de navigateur web qui comporte le Simulateur.
Définissez le paramètre Température sur 90 ° et attendez qu’il s’enregistre dans la fenêtre Messages envoyés.
Basculez vers l’onglet de navigateur dans lequel Connected Field Service est chargé.
Cliquez sur Alertes IoT.
Ouvrez l’alerte Relevé de température de 90 supérieur au seuil de 70.
Sélectionnez la phase Créé. (Notez que les informations que nous avons extraites précédemment s’affichent. Comme le relevé est compris entre 86 et 100 °, la phase suivante est la création de l’incident.)
Dans le Menu, sélectionnez Envoyer une commande.
Cliquez sur Basculer en mode JSON.
Saisissez le code ci-dessous pour la commande, puis cliquez sur Envoyer :
```
{"CommandName":"Reset Thermostat","Parameters":{}}
```
Basculez vers votre Simulateur et attendez que l’appareil redémarre.
Réglez le Curseur de température sur 106 degrés et attendez que le statut de la température soit enregistré dans la fenêtre Messages envoyés.
Basculez vers l’onglet de navigateur dans lequel Connected Field Service est chargé.
Cliquez sur Alertes IoT.
Ouvrez l’alerte Relevé de température de 106 supérieur au seuil de 70.
Notez que comme l’alerte était supérieure à 100 degrés, la phase Créer un incident a été complètement ignorée.