Deli z drugimi prek

Nastavitev dejanj ponudnika interneta stvari

  • Članek

Ko nastavite ponudnika interneta stvari (IoT), lahko določite nabor dejanj, ki jih želite sprožiti na podlagi podatkov, zajetih iz naprav interneta stvari v vaši organizaciji. Skupaj s petimi vnaprej določenimi dejanji lahko ustvarite dejanja po meri, ki so povezana z vašim ponudnikom, da avtomatizirate različne vidike postopkov povezane rešitve Field Service.

Storitev Connected Field Service vključuje ta dejanja:

Vlečno pridobivanje podatkov naprave

Dejanje Pull device data act pridobi najnovejše podatke za eno napravo ali zbirko naprav od ponudnika interneta stvari. Prikaže se na zavihku Zgodovina podatkov o napravi.

Ker lahko podatki prihajajo iz več naprav, dejanje Pull device data act zahteva EntityCollection kot vhod. V spodnji tabeli so opisani parametri zbirke EntityCollection.

Parameter Vnesi Details
msdyn_iotdeviceid string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz
msdyn_name string Ime naprave
@odata.type string Vrsta OData entitete

Vnos vzorca:

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

Dejanje Pull device data vrne pridobljene podatke v serijski obliki zapisa JSON. V spodnji tabeli so opisani parametri izhoda PullDeviceDataResultsJSON.

Lastnost JSON Vnesi Details
ID string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz
ConnectionState boolean Ali je naprava odklopljena (false) ali povezana (true)
ConnectionStateUpdatedTime datetime Časovni žig zadnje posodobitve stanja povezave ponudnika interneta stvari
DeviceReportedProperties string Lastnosti, o katerih poroča naprava, oblikovane kot niz JSON
LastActivityTime datetime Časovni žig zadnje prijavljene dejavnosti naprave

Vzorčni rezultati:

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

Registracija naprave

Dejanje Registriraj napravo ustvari povezavo med napravo ali zbirko naprav in ponudnikom interneta stvari. Registrirati je mogoče nove naprave in naprave ali komponente, ki jih tehnik zamenja. Ko registrirate napravo, se prikaže na zavihku Zgodovina registracije zapisa naprave IoT.

Ker je hkrati mogoče registrirati več naprav, dejanje Registracija naprave zahteva kot vnos EntityCollection. V spodnji tabeli so opisani parametri zbirke EntityCollection.

Parameter Vnesi Details
msdyn_iotdeviceid string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz
msdyn_name string Ime naprave
@odata.type string Vrsta OData entitete

Vnos vzorca:

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

Dejanje Registracija naprave vrne rezultate registracije v serijski obliki zapisa JSON. V spodnji tabeli so opisani parametri izhoda RegistrationResultsJSON.

Lastnost JSON Vnesi Details
ID string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz
RegistrationStatus OptionSetValue Stanje registracije ponudnika interneta stvari nazaj na Connected Field Service
Vrednote in oznake:
- 192350000: Neznano
- 192350001: Ni registrirano
- 192350002: Se izvaja
- 192350003: Registrirano
- 192350004: Napaka
Opomba: Nabor možnosti je seznam možnosti s preslikavo vrednosti oznake, kot je kontrolnik spustnega seznama.
DeviceId string ID naprave v sistemu ponudnikov interneta stvari
Sporočilo string Podrobno sporočilo uporabniku rešitve Connected Field Service glede registracije

Vzorčni rezultati:

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

Združeni odčitki naprav

Dejanje odčitkov združenih naprav pridobi združene podatke o napravi od ponudnika interneta stvari. Združeni podatki omogočajo hiter posnetek stanja naprave na ploščicah s povzetki v storitvi Connected Field Service.

Posnetek zaslona naprave IoT v rešitvi Field Service, ki prikazuje združene odčitke.

V spodnji tabeli so opisani vhodni parametri dejanja Odčitki združenih naprav.

Parameter Vnesi Details
deviceId string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz
mere string Seznam meritev v formatu JSON; Za primere glejte naslednji izrezek kode

Vnos vzorca:

[
    {
        "Measure":"Humidity",
        "Aggregate":"Min",
        "TimeRangeType":"Days",
        "TimeRangeValue":7
    },
    {
        "Measure":"Temperature",
        "Aggregate":"Avg",
        "TimeRangeType":"Days",
        "TimeRangeValue":14
    }
]

Dejanje Združeni odčitki naprav vrne meritve v serijski obliki zapisa JSON. V spodnji tabeli so prikazani izhodni parametri.

Lastnost JSON Vnesi Details
measuresOutput string Vrednosti vrnjenih meritev v formatu JSON; Za primere glejte naslednji izrezek kode

Vzorčni rezultati:

[
    {
        "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"
    }
]

Združeni odčitki naprav temeljijo na entiteti zgodovine podatkov o napravi, če ne uporabljate dejanja Združeni odčitki naprav.

Odčitki naprave za poizvedbo

Dejanje odčitkov naprave poizvedbe pridobi zgodovinske podatke o napravi, kot sta temperatura in vlažnost, od ponudnika interneta stvari in jih prikaže kot grafikon časovnih vrst.

Posnetek zaslona temperature in vlažnosti naprave skozi čas.

V spodnji tabeli so opisani vhodni parametri dejanja Odčitki naprave poizvedbe.

Parameter Vnesi Details
Od: datetime Začetni čas odčitavanja (merjenja) v formatu ISO; Na primer »2020-04-10T13:51:55.781Z«
Do: datetime Končni čas odčitavanja (merjenja) v formatu ISO
IoTDeviceId string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz
Interval string Velikost intervala točke risbe, določena v obliki trajanja ISO-8601; na primer, 1 minuta je "PT1M", 1 milisekunda je "PT0.001S"
Vsi intervali so enake velikosti. En mesec se vedno pretvori v 30 dni, eno leto pa je vedno 365 dni.

Vnos vzorca:

{
    "From":"2023-04-01T18:05:37.661Z", 

    "To":"2023-05-31T18:05:37.661Z", 

    "IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 

    "Interval":"P1D"
}

Dejanje Odčitki naprave poizvedbe vrne podatke v serijski obliki zapisa JSON. V spodnji tabeli so prikazani izhodni parametri.

Lastnost JSON Vnesi Details
AggregatedDeviceReadings String Vrednosti vrnjenih meritev v formatu JSON; Za primere glejte naslednji izrezek kode

Vzorčni rezultati:

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

Pridobivanje dogodkov v napravi

Dejanje Pridobi dogodke v napravi pridobi dogodke iz zgodovine storitev naprave in jih prikaže kot žebljičke na dnu grafikona, ustvarjenega z dejanjem Odčitki naprave poizvedbe. Vključite lahko poljubne entitete, na primer zadnje obdobje, ko ste izvedli nadgradnjo sredstva.

Posnetek zaslona dogodkov, prikazanih kot žebljički pod grafikonom temperature in vlažnosti naprave v časovnem grafikonu.

opomba,

Ni vam treba ustvariti novega dejanja. Registrirajte vtičnik po meri za dejanje msdyn_IoTGetDeviceEvents , na primer vtičnike za ustvarjanje dogodkov.

V spodnji tabeli so opisani vhodni parametri dejanja Pridobi dogodke naprave.

Lastnost JSON Vnesi Details
Od: datetime Začetni čas odčitavanja (merjenja) v formatu ISO; Na primer »2020-04-10T13:51:55.781Z«
Do: datetime Končni čas odčitavanja (merjenja) v formatu ISO
IoTDeviceId string ID naprave GUID (msdyn_iotdevice) v rešitvi Connected Field Service, pretvorjen v niz

Vnos vzorca:

{ 
    "IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 
    "From": "2023-06-12T18:57:54.864Z", 
    "To": "2023-06-12T19:57:54.864Z" 
}

Dejanje Pridobi dogodke v napravi vrne podatke v serijski obliki zapisa JSON. V spodnji tabeli so prikazani izhodni parametri.

Lastnost JSON Vnesi Details
EventsName string Kratek opis kategorije dogodka; Uporabite ga za prikaz ali skrivanje vseh dogodkov v tej kategoriji
Časovni žig string časovni žig dogodka, oblikovan kot niz v formatu ISO; Časovni žig osi X za žebljiček dogodka
Barva string Barva žebljička dogodka, ki je na voljo kot niz šestnajstiške kode
Description string Kratek opis dogodka, ki se prikaže, ko uporabnik premakne kazalec nad žebljiček ali izbere žebljiček za ogled podrobnosti
ID string ID dogodka; je lahko ime ali druga uporabniku prijazna vrednost, na primer številka delovnega naloga ali potrditvena koda rezervacije
Entity string Ime Dataverse entitete, povezano z dogodkom; na primer »msdyn_workorder«
URL string URL strani s podrobnostmi za dogodek, na primer povezava do obrazca za delovni nalog;
Če posredujete entiteto in GUID, sistem samodejno ustvari hiperpovezavo.
GUID string GUID, pretvorjen v niz, zapisa entitete v Dataverse

Vzorčni rezultati:

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

Naslednji koraki