Installation et configuration de Connected Field Service pour Azure IoT Hub

Suivez les étapes de cet article pour configurer Connected Field Service à utiliser avec Azure IoT Hub.

• Étape 1 : Déployer Connected Field Service et les ressources Azure depuis un modèle ARM
• Étape 2 : Créer une instance de fournisseur IoT
• Étape 3 : Configurer un point de terminaison IoT
• Étape 4 : autoriser la connexion à l’application Azure
• Étape 5 : Mettre à jour devicerules.json
• Étape 6 : Démarrer des tâches Azure Stream Analytics

Conditions préalables

• Dynamics 365 Field Service est installé.

• Vous disposez des rôles de sécurité Administrateur système et Administrateur IoT.

• Vous disposez d’un abonnement Azure actif avec des privilèges pour créer des ressources et des services.

• Vous avez créé une inscription d’application pour Azure Time Series Insights dans le portail Azure et disposez de l’ID d’application (client) et de l’ID d’objet. Ajoutez une clé client secrète et enregistrez la valeur. Vous avez besoin de ces valeurs plusieurs fois dans cette procédure.

Déployer Connected Field Service et les ressources Azure depuis un modèle ARM

Utilisez un modèle Azure Resource Management (Azure Resource Manager) pour déployer Azure IoT Hub et le connecter à votre environnement Field Service.

1. Sélectionnez Déployer sur Azure sur la page https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

2. Sélectionnez votre abonnement Azure.

3. Sélectionnez un groupe de ressources ou créez-en un.

4. Définissez la région sur la même région que votre environnement Field Service.

   

5. Entrez le nom unique de votre organisation et l’URL de l’organisation de l’environnement Field Service.

6. Sélectionnez les ressources facultatives que vous souhaitez déployer.

   • Sélectionnez Déployer SQL Server pour Power BI (facultatif) et entrez le serveur SQL et les informations d’identification pour créer vos propres rapports dans Power BI.

7. Sélectionnez Réviser + créer.

Assurez-vous que le déploiement est terminé avant de continuer.

Créer une instance de fournisseur IoT

1. Connectez-vous à Dynamics 365 et ouvrez l’application Connected Field Service.

2. Dans Connected Field Service, accédez à la zone Paramètres.

3. Sélectionnez Fournisseurs, puis sur Nouveau.

4. Saisissez les informations suivantes :

   

   • Nom : définissez ce paramètre sur le nom du groupe de ressources dans Azure où vous avez déployé les ressources IoT
   • Fournisseur IoT : choisissez ou créez le fournisseur IoT pour IoT Hub
   • Id d’instance fournisseur : nom de la ressource IoT Hub déployée sur votre groupe de ressources dans Azure
   • URL : URL de la présentation du groupe de ressources dans le portail Azure ; par exemple, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Sélectionnez Enregistrer.

Vous devez maintenant mettre à jour les paramètres de la nouvelle instance de fournisseur.

1. Dans la zone Paramètres, sélectionnez Paramètres IoT>Paramètres du fournisseur IoT.

   

2. Pour Fournisseur IoT par défaut, sélectionnez l’instance de fournisseur IoT que vous avez créée.

3. Cliquez sur Enregistrer et fermer.

4. Pour une étape ultérieure, recherchez la ligne Instance de fournisseur IoT dans la table msdyn_iotproviderinstance et copiez le GUID.

Configurer un point de terminaison IoT

Pour cette étape, vous devez connaître le nom d’hôte pour Espace de noms Service Bus déployé sur votre groupe de ressources.

1. Téléchargez la Power Platform CLI, puis installez-la.

2. Ouvrez la CLI et lancez Plugin Registration Tool (PRT) en utilisant la commande pac tool prt.

3. Dans la fenêtre PRT, sélectionnez Créer une connexion.

4. Dans Afficher la liste des organisations disponibles, sélectionnez Office 365.

5. Sélectionnez Afficher une liste des organisations disponibles, puis Afficher les paramètres avancés.

6. Sélectionnez la région de votre environnement Field Service, entrez vos informations d’identification Field Service, puis sélectionnez Connexion.

   Si vous avez accès à plusieurs organisations Dynamics 365, sélectionnez le nom de l’organisation avec laquelle vous souhaitez travailler.

Vous devez maintenant mettre à jour le point de terminaison de service du message IoT.

1. Une fois connecté à l’organisation, recherchez et sélectionnez le point de terminaison de service Message IoT.

2. Cliquez sur Mettre à jour.

3. Pour Adresse de l’espace de noms, entrez le nom d’hôte de l’espace de noms Service Bus dans l’outil d’enregistrement du plug-in, préfixé par sb:// ; par exemple, sb://myServiceBusNamespace.servicebus.windows.net.

4. Dans la ressource d’espace de noms Service Bus, accédez à Files d’attente et trouvez la file d’attente dont le nom se termine par -crm. Copiez le nom complet et saisissez-le comme Nom de la rubrique dans l’outil d’enregistrement de plug-in.

5. Pour Format de message, choisissez XML.

6. Dans la ressource d’espace de noms Service Bus, accédez à Stratégies d’accès partagé>RootManageSharedAccessKey.

7. Copiez le nom et collez-le dans Nom clé SaS.

8. Copiez la clé primaire et collez-la dans Clé SAS.

9. Sélectionnez Enregistrer.

   

Autoriser la connexion à l’application Azure

1. Connectez-vous à votre compte Azure et accédez au portail Azure.

2. Accédez à Groupes de ressources et recherchez le groupe de ressources que vous avez déployé dans IoTHub.

3. Sélectionnez et modifiez la ressource Connexion d’API commondataservice.

4. Sous Général, sélectionnez Modifier la connexion d’API, puis sélectionnez Autoriser.

5. Connectez-vous avec les informations d’identification Dynamics 365 que vous utilisez pour vous connecter à votre environnement Connected Field Service.

   Ils peuvent être différents des informations d’identification que vous utilisez pour vous connecter au portail Azure.

6. Sélectionnez Enregistrer.

Mettre à jour devicerules.json

La tâche Stream Analytics déployée sur votre groupe de ressources fait référence à un fichier nommé devicerules.json. Ce fichier définit une règle qui crée des alertes IoT.

Pour utiliser la règle, téléchargez le fichier devicerules.json. Vous devez reproduire la structure exacte des répertoires pour que l’exemple d’alerte fonctionne.

1. Téléchargez le fichier devicerules.json à partir du référentiel GitHub.

2. Ouvrez le groupe de ressources dans le portail d’administration Azure et sélectionnez le compte de stockage déployé sur votre groupe de ressources.

3. Cliquez sur Conteneurs, et créez un conteneur nommé devicerules.

4. Ouvrez le nouveau conteneur devicerules et sélectionnez Charger.

5. Naviguez et sélectionnez devicerules.json.

6. Développez la section Options avancées. Dans le champ Charger dans le dossier, saisissez 2016-05-30, puis sélectionnez Charger.

7. Ouvrez le nouveau dossier 2016-05-30 et sélectionnez Charger.

8. Naviguez et sélectionnez devicerules.json.

9. Développez la section Options avancées. Dans le champ Charger dans le dossier, saisissez 22-40, puis sélectionnez Charger.

Démarrer des tâches Azure Stream Analytics

1. Dans le portail Azure, accédez à Groupes de ressources et recherchez le groupe de ressources que vous avez récemment déployé dans IoT Hub.

2. Sélectionnez chaque tâche Stream Analytics et, depuis l’onglet Vue d’ensemble, sélectionnez Démarrer.

Félicitations ! Vous êtes maintenant prêt à transmettre des données entre Azure IoT Hub et Dynamics 365 pour utiliser Connected Field Service.

Étapes suivantes

• Inscrire des appareils
• Extraire les données de l’appareil
• Visualiser des lectures d’appareil