Postavljanje radnji davatelja usluga IoT-a
Nakon što postavite davatelja IoT (Internet stvari), možete odrediti skup akcija koje će se pokrenuti na temelju snimljenih podataka s IoT uređaja vaše tvrtke ili ustanove. Uz pet unaprijed definiranih radnji, možete stvoriti prilagođene akcije koje su povezane s vašim davateljem usluga za automatizaciju različitih aspekata vaših operacija Connected Field Service.
Sljedeće radnje dolaze s Connected Field Service:
- Povlačenje podataka uređaja
- Registrirajte uređaj
- Agregirana očitanja uređaja
- Upitajte očitanja uređaja
- Dohvaćanje događaja uređaja
Povuci podatke o uređaju
Akcija Povući podatke uređaja dohvaća najnovije podatke za jedan uređaj ili zbirku uređaja od davatelja usluga IoT. Pojavljuje se na kartici Povijest podataka uređaja.
Budući da podaci mogu dolaziti s više uređaja, akcija Povlačenje podataka uređaja zahtijeva EntityCollection kao ulaz. U sljedećoj tablici opisani su parametri EntityCollection.
| Parametar | Tip | Pojedinosti |
|---|---|---|
| msdyn_iotdeviceid | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
| msdyn_name | string | Naziv uređaja |
| @odata.type | string | Vrsta OData entiteta |
Uzorak unosa:
{
"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"
}
]
}
Akcija Povući podatke uređaja vraća dohvaćene podatke u serijaliziranom JSON formatu. U sljedećoj tablici opisani su parametri izlaza PullDeviceDataResultsJSON.
| Svojstvo JSON | Tip | Pojedinosti |
|---|---|---|
| ID | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
| ConnectionState | boolean | Je li uređaj isključen (netočno) ili spojen (true) |
| ConnectionStateUpdatedTime | datetime | Vremenska oznaka posljednjeg ažuriranja stanja veze davatelja IoT usluga |
| DeviceReportedProperties | string | Prijavljena svojstva uređaja, oblikovana kao JSON niz |
| LastActivityTime | datetime | Vremenska oznaka posljednje prijavljene aktivnosti uređaja |
Primjer rezultata:
{
"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"
}
]
}
Registriraj uređaj
Akcija Registriraj uređaj stvara vezu između uređaja ili zbirke uređaja i davatelja usluga IoT. Mogu se registrirati novi uređaji i uređaji ili komponente koje tehničar zamijeni. Nakon što registrirate uređaj, on se pojavljuje na kartici Povijest registracije zapisa IoT uređaja.
Budući da se istovremeno može registrirati više uređaja, akcija Registriraj uređaj zahtijeva EntityCollection kao ulaz. U sljedećoj tablici opisani su parametri EntityCollection.
| Parametar | Tip | Pojedinosti |
|---|---|---|
| msdyn_iotdeviceid | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
| msdyn_name | string | Naziv uređaja |
| @odata.type | string | Vrsta OData entiteta |
Uzorak unosa:
{
"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"
}
]
}
Akcija Registriraj uređaj vraća rezultate registracije u serijaliziranom JSON formatu. U sljedećoj tablici opisani su parametri izlaza RegistrationResultsJSON.
| Svojstvo JSON | Tip | Pojedinosti |
|---|---|---|
| ID | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
| RegistrationStatus | OptionSetValue | Status registracije od davatelja usluga IoT-a natrag na Connected Field Service Vrijednosti i oznake: - 192350000: Nepoznato - 192350001: Neregistrirano - 192350002: U tijeku - 192350003: Registrirano - 192350004: Pogreška Napomena: Skup mogućnosti popis je mogućnosti s mapiranjem oznaka i vrijednosti, poput kontrole padajućeg popisa. |
| DeviceId | string | ID uređaja u sustavu davatelja usluga IoT-a |
| Poruka | string | Detaljna poruka korisniku usluge Connected Field Service u vezi s registracijom |
Primjer rezultata:
{
"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"
}
]
}
Agregirana očitanja uređaja
Akcija Agregirana očitanja uređaja dohvaća agregirane podatke o uređaju od davatelja usluga IoT-a. Agregirani podaci pružaju brzu snimku stanja uređaja na pločicama sažetka u Connected Field Service.
U sljedećoj tablici opisani su ulazni parametri radnje Agregirana očitanja uređaja.
| Parametar | Tip | Pojedinosti |
|---|---|---|
| deviceId | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
| mjerila | string | Popis mjerenja u JSON formatu; Za primjere pogledajte sljedeći isječak koda |
Uzorak unosa:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Radnja Agregirana očitanja uređaja vraća mjerenja u serijaliziranom JSON formatu. U sljedećoj tablici prikazani su izlazni parametri.
| Svojstvo JSON | Tip | Pojedinosti |
|---|---|---|
| measuresOutput | string | Vrijednosti vraćenih mjerenja u JSON formatu; Za primjere pogledajte sljedeći isječak koda |
Primjer rezultata:
[
{
"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"
}
]
Agregirana očitanja uređaja temelje se na entitetu Povijest podataka uređaja ako ne koristite radnju Skupna očitanja uređaja.
Upitajte očitanja uređaja
Akcija Upit očitavanja uređaja dohvaća povijesne podatke uređaja, kao što su temperatura i vlažnost, od davatelja IoT usluga i prikazuje ih kao grafikon vremenskih serija.
U sljedećoj su tablici opisani ulazni parametri akcije Upit očitavanja uređaja.
| Parametar | Tip | Pojedinosti |
|---|---|---|
| Šalje: | datetime | Vrijeme početka očitavanja (mjerenja) u ISO formatu; na primjer, "2020-04-10T13:51:55.781Z" |
| Za: | datetime | Vrijeme završetka očitavanja (mjerenja) u ISO formatu |
| IoTDeviceId | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
| Interval | string | Veličina intervala točke crtanja navedena u formatu trajanja ISO-8601; na primjer, 1 minuta je "PT1M", 1 milisekunda je "PT0.001S" Svi intervali su iste veličine. Jedan mjesec se uvijek pretvara u 30 dana, a jedna godina je uvijek 365 dana. |
Uzorak unosa:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Akcija Upit očitavanja uređaja vraća podatke u serijaliziranom JSON formatu. U sljedećoj tablici prikazani su izlazni parametri.
| Svojstvo JSON | Tip | Pojedinosti |
|---|---|---|
| AggregatedDeviceReadings | String | Vrijednosti vraćenih mjerenja u JSON formatu; Za primjere pogledajte sljedeći isječak koda |
Primjer rezultata:
{
"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
}
}
}
}
Dohvaćanje događaja uređaja
Akcija Dohvati događaje uređaja dohvaća događaje iz povijesti servisa uređaja i prikazuje ih kao pribadače pri dnu grafikona koji je stvoren radnjom Upitaj očitanja uređaja. Možete uključiti bilo koji prilagođeni entitet, primjerice zadnji put kada ste izvršili nadogradnju imovine.
Napomena
Ne morate stvarati novu akciju. Registrirajte prilagođeni dodatak za radnju, msdyn_IoTGetDeviceEvents kao što su dodaci za događaje izrade.
U sljedećoj su tablici opisani ulazni parametri radnje Dohvati događaje uređaja.
| Svojstvo JSON | Tip | Pojedinosti |
|---|---|---|
| Šalje: | datetime | Vrijeme početka očitavanja (mjerenja) u ISO formatu; na primjer, "2020-04-10T13:51:55.781Z" |
| Za: | datetime | Vrijeme završetka očitavanja (mjerenja) u ISO formatu |
| IoTDeviceId | string | ID GUID uređaja (msdyn_iotdevice) u usluzi Connected Field Service, pretvoren u niz |
Uzorak unosa:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Akcija Dohvati događaje uređaja vraća podatke u serijaliziranom JSON formatu. U sljedećoj tablici prikazani su izlazni parametri.
| Svojstvo JSON | Tip | Pojedinosti |
|---|---|---|
| EventsName | string | Kratak opis kategorije događaja; upotrijebite ga za prikaz ili skrivanje svih događaja u toj kategoriji |
| Podaci vremenske oznake | string | Vremenska oznaka događaja oblikovana kao niz u ISO formatu; Vremenska oznaka osi X za pin događaja |
| Boja | string | Boja PIN događaja, navedena kao niz heksadecimalnog koda |
| Opis | string | Kratak opis događaja koji se prikazuje kada korisnik prijeđe mišem iznad pribadače ili odabere pribadaču za prikaz pojedinosti |
| ID | string | ID događaja; može biti ime ili druga vrijednost prilagođena korisniku, kao što je broj radnog naloga ili kôd za potvrdu rezervacije |
| Entity | string | Naziv Dataverse entiteta povezan s događajem, na primjer, "msdyn_workorder" |
| URL | string | URL stranice s pojedinostima za događaj, kao što je veza na obrazac radnog naloga Ako proslijedite entitet i GUID, sustav automatski generira hipervezu. |
| GUID | string | GUID, pretvoren u niz, zapisa entiteta u Dataverse |
Primjer rezultata:
{
"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"
}
}
}