Configurare le azioni del provider IoT
Dopo aver configurato un provider IoT (Internet of Things), puoi specificare un set di azioni da attivare in base ai dati acquisiti dai dispositivi IoT dell'organizzazione. Insieme a cinque azioni predefinite, puoi creare azioni personalizzate associate al tuo provider per automatizzare vari aspetti delle operazioni di Connected Field Service.
Connected Field Service include le azioni seguenti:
- Esegui pull dei dati del dispositivo
- Registra dispositivo
- Letture dispositivo aggregate
- Interroga letture dispositivo
- Recupera eventi dispositivo
Esegui pull dei dati del dispositivo
L'azione Esegui pull dei dati del dispositivo recupera i dati più recenti per un dispositivo o una raccolta di dispositivi dal provider IoT. È visualizzata nella scheda Cronologia dei dati del dispositivo.
Poiché i dati possono provenire da più dispositivi, l'azione Esegui pull dei dati del dispositivo richiede un EntityCollection come input. La tabella seguente descrive i parametri di EntityCollection.
| Parametro | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
| msdyn_name | string | Nome del dispositivo |
| @odata.type | string | Il tipo OData dell'entità |
Input di esempio:
{
"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'azione Esegui pull dei dati del dispositivo restituisce i dati recuperati in formato JSON serializzato. La tabella seguente descrive i parametri dell'output PullDeviceDataResultsJSON.
| Proprietà JSON | Type | Details |
|---|---|---|
| ID | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
| ConnectionState | boolean | Indica se il dispositivo è disconnesso (false) o connesso (true) |
| ConnectionStateUpdatedTime | datetime | Il timestamp dell'ultimo aggiornamento dello stato di connessione del provider IoT |
| DeviceReportedProperties | string | Le proprietà segnalate del dispositivo, formattate come stringa JSON |
| LastActivityTime | datetime | Il timestamp dell'ultima attività segnalata del dispositivo |
Output di esempio:
{
"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"
}
]
}
Registra dispositivo
L'azione Registra dispositivo crea un'associazione tra un dispositivo o una raccolta di dispositivi e il provider IoT. È possibile registrare nuovi dispositivi e dispositivi o componenti sostituiti da un tecnico. Dopo aver registrato un dispositivo, questo viene visualizzato nella scheda Cronologia di registrazione del record Dispositivo IoT.
Poiché è possibile registrare più dispositivi contemporaneamente, l'azione Registra dispositivo richiede un EntityCollection come input. La tabella seguente descrive i parametri di EntityCollection.
| Parametro | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
| msdyn_name | string | Nome del dispositivo |
| @odata.type | string | Il tipo OData dell'entità |
Input di esempio:
{
"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'azione Registra dispositivo restituisce i risultati della registrazione in formato JSON serializzato. La tabella seguente descrive i parametri dell'output RegistrationResultsJSON.
| Proprietà JSON | Type | Details |
|---|---|---|
| ID | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
| RegistrationStatus | OptionSetValue | Lo stato della registrazione dal provider IoT in Connected Field Service Valori ed etichette: - 192350000: Sconosciuto - 192350001: Non registrato - 192350002: In corso - 192350003: Registrato - 192350004: Errore Nota: un OptionSet è un elenco di opzioni con mapping etichetta-valore come un controllo Elenco a discesa. |
| DeviceId | string | L'ID del dispositivo nel sistema del provider IoT |
| Message | string | Un messaggio dettagliato relativo alla registrazione all'utente di Connected Field Service |
Output di esempio:
{
"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"
}
]
}
Letture dispositivo aggregate
L'azione Letture dispositivo aggregate recupera i dati aggregati del dispositivo dal provider IoT. I dati aggregati forniscono una rapida snapshot della condizione del dispositivo in riquadri di riepilogo di Connected Field Service.
La tabella seguente descrive i parametri di input dell'azione Letture dispositivo aggregate.
| Parametro | Type | Details |
|---|---|---|
| deviceId | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
| measures | string | Un elenco di misurazioni in formato JSON; vedi il seguente frammento di codice per esempi |
Input di esempio:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
L'azione Letture dispositivo aggregate restituisce le misurazioni in formato JSON serializzato. La tabella seguente mostra i parametri di output.
| Proprietà JSON | Type | Details |
|---|---|---|
| measuresOutput | string | I valori delle misurazioni restituite in formato JSON; vedi il seguente frammento di codice per esempi |
Output di esempio:
[
{
"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"
}
]
Le letture del dispositivo aggregate sono basate sull'entità Cronologia dei dati del dispositivo se non si usa l'azione Letture dispositivo aggregate.
Interroga letture dispositivo
L'azione Interroga letture dispositivo recupera i dati storici del dispositivo, come temperatura e umidità, dal provider IoT e li visualizza come grafico della serie temporale.
La tabella seguente descrive i parametri di input dell'azione Interroga letture dispositivo.
| Parametro | Type | Details |
|---|---|---|
| From | datetime | L'ora di inizio della lettura (misurazione) in formato ISO; ad esempio, "2020-04-10T13:51:55.781Z" |
| Per | datetime | L'ora di fine della lettura (misurazione) in formato ISO |
| IoTDeviceId | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
| Intervallo | string | La dimensione dell'intervallo del punto di tracciamento specificata nel formato di durata ISO-8601; ad esempio, 1 minuto è "PT1M", 1 millisecondo è "PT0.001S" Tutti gli intervalli hanno la stessa dimensione. Un mese viene sempre convertito in 30 giorni e un anno è sempre 365 giorni. |
Input di esempio:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
L'azione Interroga letture dispositivo restituisce i dati in formato JSON serializzato. La tabella seguente mostra i parametri di output.
| Proprietà JSON | Type | Details |
|---|---|---|
| AggregatedDeviceReadings | String | I valori delle misurazioni restituite in formato JSON; vedi il seguente frammento di codice per esempi |
Output di esempio:
{
"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
}
}
}
}
Recupera eventi dispositivo
L'azione Recupera eventi dispositivo recupera gli eventi dalla cronologia dei servizi del dispositivo e li visualizza come segnaposti nella parte inferiore del grafico creato dall'azione Interroga letture dispositivo. Puoi includere qualsiasi entità personalizzata come l'ultima volta che hai eseguito un aggiornamento dei cespiti.
Nota
Non devi creare una nuova azione. Registra un plug-in personalizzato nell'azione msdyn_IoTGetDeviceEvents, come i plug-in per la creazione di eventi.
La tabella seguente descrive i parametri di input dell'azione Recupera eventi dispositivo.
| Proprietà JSON | Type | Details |
|---|---|---|
| From | datetime | L'ora di inizio della lettura (misurazione) in formato ISO; ad esempio, "2020-04-10T13:51:55.781Z" |
| Per | datetime | L'ora di fine della lettura (misurazione) in formato ISO |
| IoTDeviceId | string | L'ID dispositivo GUID (msdyn_iotdevice) in Connected Field Service convertito in una stringa |
Input di esempio:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
L'azione Recupera eventi dispositivo restituisce i dati in formato JSON serializzato. La tabella seguente mostra i parametri di output.
| Proprietà JSON | Type | Details |
|---|---|---|
| EventsName | string | Breve descrizione della categoria dell'evento; usala per mostrare o nascondere tutti gli eventi in quella categoria |
| Timestamp: | string | Il timestamp dell'evento formattato come stringa in formato ISO; il timestamp dell'asse x per il segnaposto dell'evento |
| Color | string | Il codice del segnaposto dell'evento, fornito come stringa di codice esadecimale |
| Description | string | Una breve descrizione dell'evento visualizzata quando l'utente passa con il mouse sul segnaposto o seleziona il segnaposto per visualizzare i dettagli |
| ID | string | L'ID dell'evento; può essere un nome o un altro valore descrittivo, come il numero dell'ordine di lavoro o il codice di conferma della prenotazione |
| Entity | string | Il nome dell'entità Dataverse correlato all'evento; ad esempio, "msdyn_workorder" |
| URL | string | L'URL della pagina dei dettagli dell'evento, come un collegamento al modulo dell'ordine di lavoro Se passi un'entità e un GUID, il sistema genera automaticamente un collegamento ipertestuale. |
| GUID | string | Il GUID, convertito in una stringa, del record dell'entità in Dataverse |
Output di esempio:
{
"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"
}
}
}