IoT pakkuja toimingute seadistamine
Pärast IoT (asjade Interneti) pakkuja seadistamist, saate määrata käivitatavate toimingute kogumi teie organisatsiooni IoT-seadmetest jäädvustatud andmete põhjal. Koos viie eelmääratletud toiminguga saate luua kohandatud toiminguid , mis on seotud teie teenusepakkujaga, et automatiseerida teie teenuse Connected Field Service toimingute erinevaid aspekte.
Teenusega Connected Field Service kaasnevad järgmised toimingud.
- Seadme andmete tõmmake
- Registreeri seade
- Seadme koondnäidud
- Päringu seadme näidud
- Hankige seadme sündmused
Too seadme andmed
Toiming Seadmeandmete tõmbamine toob IoT pakkujalt uusimad andmed ühe seadme või seadmete kogumi kohta. See kuvatakse vahekaardil Seadme andmete ajalugu .
Kuna andmed võivad pärineda mitmest seadmest, nõuab toiming Seadmeandmete tõmbamine sisendina üksust EntityCollection. Järgmises tabelis kirjeldatakse atribuudi EntityCollection parameetreid.
| Parameeter | Tüüp | Üksikasjad |
|---|---|---|
| msdyn_iotdeviceid | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
| msdyn_name | string | Seadme nimi |
| @odata.type | string | Olemi OData tüüp |
Proovi sisend:
{
"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"
}
]
}
Toiming Seadme andmete tõmbamine tagastab toodud andmed järjestatud JSON-vormingus. Järgmises tabelis kirjeldatakse väljundi PullDeviceDataResultsJSON parameetreid.
| JSON-i vara | Tüüp | Üksikasjad |
|---|---|---|
| ID | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
| ConnectionState | boolean | Kas seadme ühendus on katkenud (false) või ühendatud (tõene) |
| ConnectionStateUpdatedTime | datetime | IoT-pakkuja viimase ühenduse oleku värskenduse ajatempel |
| DeviceReportedProperties | string | Seadme teatatud atribuudid, mis on vormindatud JSON-stringina |
| LastActivityTime | datetime | Seadme viimase teatatud tegevuse ajatempel |
Näidisväljund:
{
"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"
}
]
}
Registreeri seade
Toiming Registreeri seade loob seose seadme või seadmete kogumi ja IoT pakkuja vahel. Registreerida saab uusi seadmeid ja seadmeid või komponente, mida tehnik välja vahetab. Pärast seadme registreerimist, see kuvatakse IoT-seadme kirje vahekaardil Registreerimisajalugu .
Kuna korraga saab registreerida mitut seadet, nõuab toiming Seadme registrikanne sisendina üksust EntityCollection. Järgmises tabelis kirjeldatakse atribuudi EntityCollection parameetreid.
| Parameeter | Tüüp | Üksikasjad |
|---|---|---|
| msdyn_iotdeviceid | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
| msdyn_name | string | Seadme nimi |
| @odata.type | string | Olemi OData tüüp |
Proovi sisend:
{
"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"
}
]
}
Toiming Registreeri seade tagastab registreerimistulemused järjestatud JSON-vormingus. Järgmises tabelis kirjeldatakse väljundi RegistrationResultsJSON parameetreid.
| JSON-i vara | Tüüp | Üksikasjad |
|---|---|---|
| ID | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
| RegistrationStatus | Suvandikomplekti väärtus | IoT pakkuja registreerimise olek tagasi teenusesse Connected Field Service Väärtused ja sildid: - 192350000: tundmatu - 192350001: pole registreeritud - 192350002: pooleli - 192350003: registreeritud - 192350004: tõrge märkused: Valikukomplekt on siltide väärtusega vastendamine suvandite loend, näiteks ripploendi juhtelement. |
| DeviceId | string | Seadme ID IoT pakkuja süsteemis |
| Saada sõnum | string | Üksikasjalik teade teenuse Connected Field Service kasutajale registreerimise kohta |
Näidisväljund:
{
"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"
}
]
}
Seadme koondnäidud
Toiming Seadme näitude koondamine toob IoT pakkujalt seadme koondandmed. Koondandmed annavad kiire hetktõmmis seadme seisukorrast Connected Field Service’i kokkuvõtlikel paanidel.
Järgmises tabelis kirjeldatakse toimingu Koondatud seadme näidud sisendparameetreid.
| Parameeter | Tüüp | Üksikasjad |
|---|---|---|
| deviceId | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
| measures | string | Mõõtmiste loetelu JSON-vormingus; Vaadake näiteid järgmisest koodilõigend |
Proovi sisend:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Toiming Koondatud seadme näidud tagastab mõõdud järjestatud JSON-vormingus. Järgmises tabelis kuvatakse väljundparameetrid.
| JSON-i vara | Tüüp | Üksikasjad |
|---|---|---|
| measuresOutput | string | Tagastatud mõõtmiste väärtused JSON-vormingus; Vaadake näiteid järgmisest koodilõigend |
Näidisväljund:
[
{
"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"
}
]
Seadme koondnäidud põhinevad seadme andmete ajaloo olemil, kui te ei kasuta toimingut Seadme näitude koondamine.
Päringu seadme näidud
Toiming Päringuseadme lugemine toob IoT pakkujalt seadme ajaloolised andmed (nt temperatuur ja niiskus) ja kuvab need aegridade diagrammina.
Järgmises tabelis kirjeldatakse toimingu Päringuseadme näidud sisendparameetreid.
| Parameeter | Tüüp | Üksikasjad |
|---|---|---|
| Alguskuupäev | datetime | ISO-vormingus lugemise (mõõtmise) algusaeg; näiteks "2020-04-10T13:51:55.781Z" |
| Sihtkoht | datetime | Näidu (mõõtmise) lõpuaeg ISO-vormingus |
| IoTDeviceId | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
| Intervall | string | ISO-8601 kestusvormingus määratud joonestuspunkti intervalli suurus; näiteks 1 minut on "PT1M", 1 millisekund on "PT0.001S" Kõik intervallid on sama suurusega. Üks kuu teisendatakse alati 30 päevaks ja üks aasta on alati 365 päeva. |
Proovi sisend:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Toiming Päringuseadme lugemine tagastab andmed järjestatud JSON-vormingus. Järgmises tabelis kuvatakse väljundparameetrid.
| JSON-i vara | Tüüp | Üksikasjad |
|---|---|---|
| AggregatedDeviceReadings | String | Tagastatud mõõtmiste väärtused JSON-vormingus; Vaadake näiteid järgmisest koodilõigend |
Näidisväljund:
{
"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
}
}
}
}
Hankige seadme sündmused
Toiming Hangi seadme sündmused toob sündmused seadme hooldusajaloost ja kuvab need nööpnõeltena diagrammi allservas, mis on loodud toiminguga Päring seadme lugemiseks. Saate kaasata mis tahes kohandatud olemid, nagu viimane kord, kui uuendasite vara.
Märkus.
Te ei pea uut toimingut looma. Registreerige toimingule kohandatud lisandmoodul, msdyn_IoTGetDeviceEvents näiteks sündmuste loomise lisandmoodulid.
Järgmises tabelis kirjeldatakse toimingu Hangi seadme sündmused sisendparameetreid.
| JSON-i vara | Tüüp | Üksikasjad |
|---|---|---|
| Alguskuupäev | datetime | ISO-vormingus lugemise (mõõtmise) algusaeg; näiteks "2020-04-10T13:51:55.781Z" |
| Sihtkoht | datetime | Näidu (mõõtmise) lõpuaeg ISO-vormingus |
| IoTDeviceId | string | GUID-seadme ID (msdyn_iotdevice) teenuses Connected Field Service, teisendatud stringiks |
Proovi sisend:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Toiming Hangi seadme sündmused tagastab andmed järjestatud JSON-vormingus. Järgmises tabelis kuvatakse väljundparameetrid.
| JSON-i vara | Tüüp | Üksikasjad |
|---|---|---|
| EventsName | string | Ürituse kategooria lühikirjeldus; Kasutage seda kõigi selle kategooria sündmuste kuvamiseks või peitmiseks |
| Üksuse ajatempel | string | ISO-vormingus stringina vormindatud sündmuse ajatempel; Sündmuse PIN-koodi x-telje ajatempel |
| Värv | string | Sündmuse nööpnõela värv, mis on esitatud heks-koodi stringina |
| Kirjeldus | string | Sündmuse lühikirjeldus, mis kuvatakse siis, kui kasutaja hõljutab kursorit nööpnõela kohal või valib üksikasjade vaatamiseks nööpnõela |
| ID | string | Sündmuse ID; võib olla nimi või muu kasutajasõbralik väärtus, näiteks töökäsk number või broneeringu kinnituskood |
| Entity | string | sündmusega Dataverse seotud üksuse nimi; näiteks "msdyn_workorder" |
| URL | string | Sündmuse üksikasjade lehe URL, näiteks töökäsk vormi linkima Kui edastate olemi ja GUID-i, loob süsteem automaatselt hüperlingi. |
| GUID | string | Stringiks teisendatud GUID, mis tähistab olemikirjet Dataverse |
Näidisväljund:
{
"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"
}
}
}
Järgmised toimingud
Tagasiside
Varsti tulekul: 2024. aasta jooksul tühistame GitHubi probleemide funktsiooni sisutagasiside mehhanismina ja asendame selle uue tagasisidesüsteemiga. Lisateabe saamiseks vt https://aka.ms/ContentUserFeedback.
Esita ja vaata tagasisidet