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
• Étape 7 : Configurer la connexion Azure Time Series Insights
• Étape 8 : (Facultatif) Configurer le simulateur

Note

Time Series Insights sera obsolète après mars 2025. Connected Field Service devient Azure Data Explorer. Plus d’informations sur la transition seront bientôt disponibles.

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.

Astuce

Les images qui incluent une icône qui ressemble à ceci : peuvent être développées pour afficher plus de détails. Sélectionnez l’image pour la développer. Pour la fermer, appuyez sur la touche Échap.

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 le simulateur (facultatif) pour tester et valider des scénarios IoT avec des exemples de données.
   • Sélectionnez Azure Time Series Insights (facultatif) pour permettre la visualisation des lectures de l’appareil et des vignettes récapitulatives.
   • 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’APIcommondataservice.

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 lorsque vous utilisez le simulateur d’appareil facultatif.

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.

Configurer la connexion Azure Time Series Insights

Utilisez Azure Time Series Insights pour créer des visualisations. Pour cette étape, vous devez connaître votre ID de locataire Azure.

1. Dans Dynamics 365, ouvrez l’application Connected Field Service.

2. Lancez les outils de développement du navigateur et accédez à la console.

3. Tapez ou collez le script suivant dans la console et exécutez-le. Remplacez le paramètre Value par votre ID de locataire Azure.

var req = {};

req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"Key": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Value": {
"typeName": "Edm.String",
"structuralProperty": 1
},
},
operationType: 0,
operationName: "msdyn_IoTSetConfiguration"
};
};

req["Key"]="TSI_PLUGIN_AZURE_TENANT_ID";
req["Value"]="REPLACE";

Xrm.WebApi.online.execute(req).then( 
function (data) { 
console.log("Success Response Status: " + data.status);
}, 
function (error) { 
console.log("Error: " + error.message);
}
);

1. Exécutez à nouveau le script. Cette fois, remplacez Key par TSI_PLUGIN_CLIENT_APPLICATION_ID et Value par l’ID client d’application issu de l’enregistrement de l’application Time Series Insights que vous avez créé en tant que condition préalable requise.

2. Exécutez le script une fois de plus. Cette fois, remplacez Key par TSI_PLUGIN_CLIENT_SECRET et Value par la clé secrète client issue de l’enregistrement de l’application Time Series Insights que vous avez créé en tant que condition préalable requise.

3. Exécutez le script suivant, à l’aide de votre URL Time Series Insights et du GUID de la ligne de l’instance du fournisseur IoT dans la table msdyn_iotproviderinstance pour l’instance du fournisseur IoT que vous avez créée précédemment.

var data = {"msdyn_timeseriesinsightsurl": "Enter Data Access FQDN found on Time Series Insights environment overview"};
Xrm.WebApi.updateRecord("msdyn_iotproviderinstance", "Copy the value for msdyn_iotproviderinstanceid from the json object returned with the API call https://[your-environment-name].crm.dynamics.com/api/data/v9.2/msdyn_iotproviderinstances", data);

(Facultatif) Configurer le simulateur

Le simulateur vous permet de tester Connected Field Service sans avoir besoin de connecter du matériel physique. En simulant des appareils et des données IoT, vous pouvez comprendre toutes les différentes parties qui contribuent à transformer les données IoT en ordres de travail.

Pour cette étape, vous avez besoin de l’URL du simulateur et de la clé primaire de la stratégie iothubowner.

Obtenir la clé d’accès

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 l’IoT Hub.

4. Sélectionnez Stratégies d’accès partagé, puis copiez la clé primaire pour iothubowner.

   

Obtenir l’URL du simulateur

1. Dans le groupe de ressources du portail Azure dans lequel vous avez déployé IoT Hub, sélectionnez le type de ressource App Service qui commence par Simulator et copiez l’URL dans la partie supérieure droite.

2. Collez l’URL dans la barre d’adresse de votre navigateur et chargez la page.

3. Sélectionnez Connexion.

4. Entrez le nom d’hôte de la ressource IoT Hub et iothubowner comme nom de stratégie. Dans le champ Clé, collez la clé primaire que vous avez copiée précédemment.

   

5. Assurez-vous que État de la connexion est marqué comme Connecté, puis fermez la fenêtre de connexion.

Envoyez une commande de test à l’aide du simulateur. Par exemple, sélectionnez la température et augmentez-la au-dessus de 70 degrés. Le simulateur est préprogrammé pour créer une alerte IoT si la température est supérieure à 70 degrés.

Étapes suivantes

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