Condividi tramite


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

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.

Screenshot di un dispositivo IoT in Field Service che mostra le letture aggregate.

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.

Screenshot della temperatura e dell'umidità del dispositivo nel tempo.

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.

Screenshot degli eventi mostrati come segnaposti sotto il grafico della temperatura e dell'umidità del dispositivo nel tempo.

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"
    }
  }
}

Passaggi successivi