Configurer les actions du fournisseur IoT
Après avoir configuré un fournisseur IoT (Internet des objets), vous pouvez spécifier un ensemble d’actions à déclencher en fonction des données capturées à partir des appareils IoT de votre organisation. Outre cinq actions prédéfinies, vous pouvez créer des actions personnalisées associées à votre fournisseur pour automatiser divers aspects de vos opérations Connected Field Service.
Les actions suivantes sont possibles avec Connected Field Service :
- Extraire les données de l’appareil
- Inscrire l'appareil
- Lectures regroupées de l’appareil
- Interroger les lectures d’appareil
- Obtenir les événements d’appareil
Extraire les données de l’appareil
L’action Extraire les données de l’appareil récupère les dernières données d’un appareil ou d’un ensemble d’appareils auprès du fournisseur IoT. Il s’affiche dans l’onglet Historique des données de l’appareil.
Puisque les données peuvent provenir de plusieurs appareils, l’action Extraire les données de l’appareil nécessite une EntityCollection comme entrée. Le tableau suivant décrit les paramètres dans l’expression EntityCollection.
| Paramètre | Type | Informations |
|---|---|---|
| msdyn_iotdeviceid | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
| msdyn_name | string | Nom de l’appareil |
| @odata.type | string | Type OData de l’entité |
Échantillon de saisie :
{
"EntityCollection":[
{
"msdyn_iotdeviceid":"B25B5E21-326E-4C36-9296-C195286DGEC9",
"msdyn_name":" HVAC 32443",
"@odata.type":"Microsoft.Dynamics.CRM.msdyn_iotdevice"
},
{
"msdyn_iotdeviceid":"B25B5E21-326E-4C36-9296-C195286DGEE9",
"msdyn_name":" HVAC 92232",
"@odata.type":"Microsoft.Dynamics.CRM.msdyn_iotdevice"
}
]
}
L’action Extraire les données de l’appareil renvoie les données récupérées au format JSON sérialisé. Le tableau suivant décrit les paramètres de la sortie PullDeviceDataResultsJSON.
| Propriété JSON | Type | Informations |
|---|---|---|
| ID | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
| ConnectionState | Booléen | Indique si l’appareil est déconnecté (false) ou connecté (true) |
| ConnectionStateUpdatedTime | DateHeure | Horodatage de la dernière mise à jour de l’état de la connexion du fournisseur IoT |
| DeviceReportedProperties | string | Diverses propriétés signalées de l’appareil formatées dans une chaîne JSON |
| LastActivityTime | DateHeure | Horodatage de la dernière activité signalée par l’appareil |
Exemple de sortie :
{
"PullDeviceDataResultsJSON":[
{
"Id":"B25B5E21-326E-4C36-9296-C195286DGEC9",
"ConnectionState":true,
"ConnectionStateUpdatedTime":"2019-08-2911:00:00",
"DeviceReportedProperties":{
"temperature":65.6366305680316,
"humidity":21.3333366666
},
"LastActivityTime": "2019-08-2011:00:00"
},
{
"Id":"B25B5E21-326E-4C36-9296-C195286DGEE9",
"ConnectionState":true,
"ConnectionStateUpdatedTime":"2019-08-2911:00:00",
"DeviceReportedProperties":{
"temperature":62.8366305680316,
"humidity":19.5333366666
},
"LastActivityTime": "2019-08-2011:00:00"
}
]
}
Inscrire l’appareil
L’action Enregistrer l’appareil crée une association entre un appareil ou un ensemble d’appareils et le fournisseur IoT. Les nouveaux appareils et appareils ou composants remplacés par un technicien peuvent être enregistrés. Une fois que vous avez enregistré un appareil, il s’affiche dans l’onglet Historique d’enregistrement de l’enregistrement de l’appareil IoT.
Puisque plusieurs appareils peuvent être enregistrés en même temps, l’action Enregistrer l’appareil nécessite une EntityCollection comme entrée. Le tableau suivant décrit les paramètres dans l’expression EntityCollection.
| Paramètre | Type | Informations |
|---|---|---|
| msdyn_iotdeviceid | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
| msdyn_name | string | Nom de l’appareil |
| @odata.type | string | Type OData de l’entité |
Échantillon de saisie :
{
"EntityCollection": [
{
"msdyn_iotdeviceid": "5754578D-1F9A-4720-BC21-3C3042C05B2F",
"msdyn_name": "Coffee maker 1",
"@odata.type": "Microsoft.Dynamics.CRM.msdyn_iotdevice"
},
{
"msdyn_iotdeviceid": "5754578D-1F9A-4720-BC21-3C3042C06C5F",
"msdyn_name": "Coffee maker 2",
"@odata.type": "Microsoft.Dynamics.CRM.msdyn_iotdevice"
}
]
}
L’action Enregistrer l’appareil renvoie les résultats de l’enregistrement au format JSON sérialisé. Le tableau suivant décrit les paramètres de la sortie RegistrationResultsJSON.
| Propriété JSON | Type | Informations |
|---|---|---|
| ID | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
| RegistrationStatus | OptionSetValue | La valeur identifie le statut de l’enregistrement du fournisseur IoT vers Connected Field Service Valeurs et étiquettes : - 192350000 : Inconnu - 192350001 : Non enregistré - 192350002 : En cours - 192350003 : Enregistré - 192350004 : Erreur Remarque : OptionSet est une liste d’options avec un mappage étiquette-valeur similaire à un contrôle de liste déroulante. |
| DeviceId | string | Identificateur de l’appareil dans le système du fournisseur IoT |
| Message | string | Tout message détaillé concernant l’enregistrement auprès de l’utilisateur Connected Field Service |
Exemple de sortie :
{
"RegistrationResultsJSON":[
{
"Id":"5754578D-1F9A-4720-BC21-3C3042C05B2F",
"RegistrationStatus":{"Value":192350003},
"DeviceId":"DeviceIdFromThirdPartyOrUserDefined",
"Message":"Registration info/warning/error message"
},
{
"Id":"5754578D-1F9A-4720-BC21-3C3042C06C5F",
"RegistrationStatus":{"Value":192350003},
"DeviceId":"DeviceIdFromThirdPartyOrUserDefined",
"Message":"Registration info/warning/error message"
}
]
}
Lectures regroupées de l’appareil
L’action Lectures regroupées de l’appareil récupère les données regroupées de l’appareil auprès du fournisseur IoT. Regrouper les données offre un aperçu rapide de l’état de l’appareil dans Connected Field Service sur les vignettes récapitulatives.
Le tableau suivant décrit les paramètres d’entrée requis par l’action Lectures regroupées de l’appareil.
| Paramètre | Type | Informations |
|---|---|---|
| deviceId | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
| measures | string | Une liste de mesures au format JSON ; voir l’extrait de code suivant pour des exemples |
Échantillon de saisie :
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
L’action Lectures regroupées de l’appareil renvoie les mesures au format JSON sérialisé. Le tableau suivant affiche les paramètres de sortie.
| Propriété JSON | Type | Informations |
|---|---|---|
| measuresOutput | string | Les valeurs des mesures renvoyées au format JSON ; voir l’extrait de code suivant pour des exemples |
Exemple de sortie :
[
{
"Name":"Humidity",
"Aggregate":"Min",
"Unit":"F",
"TimeRangeValue":7,
"TimeRangeType":"Days",
"Position":1,
"Value":"39.13334"
},
{
"Name":"Temperature",
"Aggregate":"Avg",
"Unit":"F",
"TimeRangeValue":14,
"TimeRangeType":"Days",
"Position":2,
"Value":"65.13334"
}
]
Les lectures regroupées d’appareils reposent sur l’entité d’historique de données d’appareil si vous n’utilisez pas l’action de lectures regroupées d’appareil.
Interroger les lectures d’appareil
L’action Interroger les lectures d’appareil récupère les données historiques de l’appareil, telles que la température et l’humidité, depuis le fournisseur IoT et les affiche comme graphique de série chronologique.
Le tableau suivant décrit les paramètres d’entrée requis par l’action Interroger les lectures d’appareil.
| Paramètre | Type | Informations |
|---|---|---|
| From | DateHeure | Heure de début du point de lecture (mesure) dans le diagramme au format ISO, par exemple, « 2020-04-10T13:51:55.781Z » |
| To | DateHeure | Heure de fin du point de lecture (mesure) au format ISO |
| IoTDeviceId | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
| Intervalle | string | La taille de l’intervalle du point de traçage spécifié au format de durée ISO-8601 ; par exemple, 1 minute correspond à « PT1M », 1 milliseconde correspond à « PT0.001S » Tous les intervalles sont de la même taille. Un mois est toujours converti en 30 jours et un an équivaut toujours à 365 jours. |
Échantillon de saisie :
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
L’action Interroger les lectures d’appareil renvoie les données au format JSON sérialisé. Le tableau suivant affiche les paramètres de sortie.
| Propriété JSON | Type | Informations |
|---|---|---|
| AggregatedDeviceReadings | String | Les valeurs des mesures renvoyées au format JSON ; voir l’extrait de code suivant pour des exemples |
Exemple de sortie :
{
"HVAC Unit 123": {
"Temperature": {
"2017-04-01T06:00:00Z": {
"min": -29,
"max": 62.59,
"avg": 16.89,
"sum": 4054.14,
"count": 240
},
"2017-04-01T08:00:00Z": {
"min": -29,
"max": 62.59,
"avg": 16.89,
"sum": 4054.14,
"count": 480
}
},
"Humidity": {
"2017-04-01T06:00:00Z": {
"min": 10,
"max": 48.3,
"avg": 29.25,
"sum": 7020.62,
"count": 240
},
"2017-04-01T08:00:00Z": {
"min": 10,
"max": 48.3,
"avg": 29.25,
"sum": 7020.62,
"count": 480
}
}
}
}
Obtenir les événements d’appareil
L’action Obtenir les événements d’appareil récupère les événements de l’historique des services et les affiche sous forme d’épingles au bas du graphique créé par l’action Interroger les lectures d’appareil. Vous pouvez inclure toutes les entités personnalisées, telles que la dernière fois que vous avez effectué une mise à niveau d’actif.
Note
Vous n’êtes pas autorisé à créer une nouvelle action. Enregistrez un plug-in personnalisé sur l’action msdyn_IoTGetDeviceEvents, comme des plug-ins pour créer des événements.
Le tableau suivant décrit les paramètres d’entrée requis par l’action Obtenir les événements d’appareil.
| Propriété JSON | Type | Informations |
|---|---|---|
| From | DateHeure | Heure de début du point de lecture (mesure) dans le diagramme au format ISO, par exemple, « 2020-04-10T13:51:55.781Z » |
| To | DateHeure | Heure de fin du point de lecture (mesure) au format ISO |
| IoTDeviceId | string | Identifiant de l’appareil GUID (msdyn_iotdevice) dans Connected Field Service, converti en une chaîne |
Échantillon de saisie :
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
L’action Obtenir les événements d’appareil renvoie les données au format JSON sérialisé. Le tableau suivant affiche les paramètres de sortie.
| Propriété JSON | Type | Informations |
|---|---|---|
| EventsName | string | Brève description de la catégorie de l’événement ; utilisez-le pour afficher ou masquer tous les événements de cette catégorie |
| Horodateur | string | L’horodatage de l’événement formaté sous forme de chaîne au format ISO ; l’horodatage de l’axe X pour la broche d’événement |
| Color | string | Le code couleur de l’événement sous forme de chaîne de code hexadécimal |
| Description | string | Brève description de l’événement, affichée lorsque l’utilisateur survole l’épingle ou sélectionne l’épingle pour afficher les détails |
| ID | string | Identifiant de l’événement ; peut être un nom ou une autre valeur conviviale, comme le numéro de l’ordre de travail ou le code de confirmation de réservation |
| Entity | string | Nom de l’entité Dataverse associé à l’événement ; par exemple, « msdyn_workorder » |
| URL | string | URL de la page de détails de l’événement, comme un lien vers le formulaire de l’ordre de travail Si vous transmettez une entité et un GUID, le système génère automatiquement un lien hypertexte. |
| GUID | string | GUID, converti en chaîne, de l’enregistrement d’entité dans Dataverse |
Exemple de sortie :
{
"Service History": {
"2019-08-07T19:14:53Z": {
"color": "#FF6300",
"description": "Work Order Created",
"id": "00001",
"entity": "msdyn_workorder",
"url": "",
"guid": "952a7592-8818-ea11-a811-000d3a5466d7"
},
"2019-08-08T19:14:53Z": {
"color": "#ECC5AC",
"description": "Work Order Created",
"id": "00002",
"entity": "msdyn_workorder",
"url": "",
"guid": "952a7592-8818-ea11-a811-000d3a5466d9"
},
"2019-09-21T09:34:53Z": {
"color": "#ECC5AC",
"description": "Case Created",
"id": "000121",
"entity": "msdyn_incident",
"url": "",
"guid": "952a7592-8818-ea11-a811-000d3a5466d0"
}
},
"Asset History": {
"2019-08-07T19:14:53Z": {
"color": "#FF6400",
"description": "Asset Model Upgraded",
"id": "001223",
"entity": "new_assetupgraded",
"url": "",
"guid": "952a7592-8818-ea11-a811-000d3a5466d7"
}
}
}