Share via

Didacticiel : Connecter Logic App à la solution préconfigurée de surveillance à distance IoT Suite

  • Article

La solution préconfigurée de surveillance à distance Microsoft Azure IoT Suite est un excellent moyen de commencer rapidement avec un ensemble de fonctionnalités de bout en bout illustrant une solution IoT. Ce didacticiel vous familiarise avec l’ajout de Logic App à votre solution préconfigurée de surveillance à distance Microsoft Azure IoT Suite. Ces étapes montrent comment tirer davantage parti de votre solution IoT en la connectant à un processus d’entreprise.

Si vous recherchez une procédure d’approvisionnement d’une solution préconfigurée de surveillance à distance, consultez Didacticiel : prise en main des solutions préconfigurées IoT.

Avant de commencer ce didacticiel, vous devez :

  • Configurer la solution préconfigurée de surveillance à distance dans votre abonnement Azure.
  • Créez un compte SendGrid pour pouvoir envoyer un courrier électronique qui déclenche le processus d’entreprise. Vous pouvez vous inscrire à un compte d’évaluation gratuit sur SendGrid en cliquant sur Essai gratuit. Une fois que vous avez enregistré votre compte d’évaluation gratuite, vous devez créer une clé d’API dans SendGrid qui accorde les autorisations d’envoi de courrier. Cette clé d’API vous sera nécessaire ultérieurement dans le didacticiel.

Pour suivre ce didacticiel, vous avez besoin de Visual Studio 2015 ou Visual Studio 2017 pour modifier les actions dans le serveur principal de la solution préconfigurée.

En supposant que vous avez déjà approvisionné votre solution préconfigurée de surveillance à distance, accédez au groupe de ressources de cette solution dans le portail Azure. Le groupe de ressources a le même nom que celui de la solution choisi lorsque vous avez configuré votre solution de supervision à distance. Dans le groupe de ressources, vous pouvez voir toutes les ressources Azure approvisionnées pour votre solution. La capture d’écran suivante montre un exemple de panneau Groupe de ressources pour une solution préconfigurée de surveillance à distance :

Pour commencer, configurez l’application logique à utiliser avec la solution préconfigurée.

Configurer l’application logique

  1. Cliquez sur Ajouter en haut du panneau de votre groupe de ressources dans le portail Azure.

  2. Recherchez l’application logique, sélectionnez-la, puis cliquez sur Créer.

  3. Indiquez le nom et utilisez les mêmes abonnement et groupe de ressources que ceux utilisés lorsque vous avez approvisionné votre solution de supervision à distance. Cliquez sur Créer.

  4. Une fois le déploiement terminé, vous verrez que l’application logique est répertoriée en tant que ressource dans votre groupe de ressources.

  5. Cliquez sur l’application logique pour accéder au panneau Application logique, puis sélectionnez le modèle Application logique vide pour ouvrir le concepteur d’applications logiques.

  6. Sélectionnez Requête. Cette action indique qu’une demande HTTP entrante avec une charge utile au format JSON spécifique agit comme un déclencheur.

  7. Collez le code suivant dans le schéma JSON de corps de requête :

    {
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "/",
  "properties": {
    "DeviceId": {
      "id": "DeviceId",
      "type": "string"
    },
    "measuredValue": {
      "id": "measuredValue",
      "type": "integer"
    },
    "measurementName": {
      "id": "measurementName",
      "type": "string"
    }
  },
  "required": [
    "DeviceId",
    "measurementName",
    "measuredValue"
  ],
  "type": "object"
}

    Notes

    Avant de pouvoir copier l’URL de la requête HTTP POST après avoir enregistré l’application logique, vous devez ajouter une action.

  8. Cliquez sur + Nouvelle étape sous votre déclencheur manuel. Cliquez ensuite sur Ajouter une action.

  9. Recherchez SendGrid - Send email (SendGrid - Envoyer un e-mail) et cliquez dessus.

  10. Entrez un nom pour la connexion, tel que SendGridConnection, entrez la clé d’API SendGrid créée lorsque vous configurez votre compte SendGrid, puis cliquez sur Créer.

  11. Ajoutez les adresses de messagerie que vous possédez aux champs De et À. Ajoutez Remote monitoring alert [DeviceId] (Alerte de surveillance à distance [DeviceId]) au champ Objet. Dans le champ Corps de l’e-mail, l’ajout d’appareil [DeviceId] a signalé [measureName] avec la valeur [measuredValue]. Vous pouvez ajouter [DeviceId], [measureName] et [measuredValue] en cliquant dans la section Vous pouvez insérer des données à partir de la section étapes précédentes.

  12. Cliquez sur Enregistrer dans le menu supérieur.

  13. Cliquez sur le déclencheur Requête et copiez la valeur POST HTTP pour cette URL. Vous aurez besoin de cette URL plus tard dans ce didacticiel.

Notes

Logic Apps vous permet d’exécuter de nombreux types d’actions différents, notamment des actions dans Office 365.

Configurer la tâche webEventProcessor

Dans cette section, vous connectez votre solution préconfigurée à l’application logique que vous avez créée. Pour effectuer cette tâche, vous ajoutez l’URL permettant de déclencher l’application logique à l’action qui se déclenche lorsqu’une valeur de capteur d’appareil dépasse un certain seuil.

  1. Utilisez votre client git pour cloner la dernière version du référentiel github azure-iot-remote-monitoring. Par exemple :

    git clone https://github.com/Azure/azure-iot-remote-monitoring.git

  2. Dans Visual Studio, ouvrez RemoteMonitoring.sln à partir de la copie locale du référentiel.

  3. Ouvrez le fichier ActionRepository.cs dans le dossier Infrastructure\Repository .

  4. Mettez à jour le dictionnaire actionIds avec la valeur POST HTTP pour cette URL notée à partir de votre application logique comme indiqué ci-dessous :

    private Dictionary<string,string> actionIds = new Dictionary<string, string>()
{
    { "Send Message", "<Http Post to this URL>" },
    { "Raise Alarm", "<Http Post to this URL>" }
};

  5. Enregistrez les modifications dans la solution et quittez Visual Studio.

Déployer depuis la ligne de commande

Dans cette section, vous déployez votre version mise à jour de la solution de supervision à distance pour remplacer la version en cours d’exécution dans Azure.

  1. Suivez les instructions de configuration du développement pour configurer votre environnement en vue du déploiement.

  2. Pour déployer en local, suivez les instructions de déploiement local.

  3. Pour effectuer un déploiement sur le cloud et mettre à jour votre déploiement cloud existant, suivez les instructions relatives au déploiement cloud. Utilisez le nom de votre déploiement d’origine comme nom de déploiement. Par exemple, si le déploiement d’origine s’appelle demologicapp, utilisez la commande suivante :

    build.cmd cloud release demologicapp

    Lors de l’exécution du script de création, veillez à utiliser les mêmes compte Azure, abonnement, région et instance Active Directory, que ceux utilisés lorsque vous avez approvisionné la solution.

Voir votre application logique en action

La solution préconfigurée de surveillance à distance comporte deux règles définies par défaut lors de l’approvisionnement d’une solution. Ces deux règles se trouvent sur l’appareil SampleDevice001 :

  • Température > 38.00
  • > Humidité 48.00

La règle de température déclenche l’action Raise Alarm (Déclencher l’alarme), tandis que la règle d’humidité déclenche l’action SendMessage. En supposant que vous avez utilisé la même URL pour les actions de la classe ActionRepository , votre application logique se déclenche pour chacune de ces règles. Les deux règles utilisent SendGrid pour envoyer à l’adresse À un courrier électronique contenant les détails de l’alerte.

Notes

L’application logique continue de se déclencher chaque fois que le seuil est atteint. Pour éviter les e-mails inutiles, vous pouvez désactiver les règles dans le portail de votre solution ou désactiver l’application logique dans le portail Azure.

En plus de recevoir des e-mails, vous pouvez également voir l’exécution de l’application logique dans le portail :

Étapes suivantes

Maintenant que vous avez utilisé une application logique pour connecter la solution préconfigurée à un processus d’entreprise, vous pouvez en apprendre plus sur les options de personnalisation de solutions préconfigurées :