IoT nodrošinātāja darbību iestatīšana
Pēc IoT (lietiskā interneta) nodrošinātāja iestatīšanas varat norādīt darbību kopu, kas jāaktivizē, pamatojoties uz datiem, kas tverti no jūsu organizācijas IoT ierīcēm. Kopā ar piecām iepriekš definētām darbībām varat izveidot pielāgotas darbības , kas ir saistītas ar jūsu pakalpojumu sniedzēju, lai automatizētu dažādus connected Field Service darbību aspektus.
Tālāk norādītās darbības ir iekļautas pakalpojumā Connected Field Service.
- Ierīces datu izvilkšana
- Reģistrēt ierīci
- Apkopotie ierīces rādījumi
- Vaicājuma ierīces rādījumi
- Ierīces notikumu iegūšana
Atgādāt ierīces datus
Veicot izvilkšanas ierīces datu darbību , tiek iegūti jaunākie dati par vienu ierīci vai ierīču kolekciju no IoT nodrošinātāja. Tas tiek parādīts cilnē Ierīces datu vēsture .
Tā kā dati var būt no vairākām ierīcēm, izvilkšanas ierīces datu darbībai ir nepieciešama EntityCollection ievade. Nākamajā tabulā ir aprakstīti EntityCollection parametri.
| Parametrs | Tipi | Detalizēta informācija |
|---|---|---|
| msdyn_iotdeviceid | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
| msdyn_name | string | Ierīces nosaukums |
| @odata.type | string | Entītijas OData tips |
Ievades paraugs:
{
"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"
}
]
}
Veicot izvilkšanas ierīces datu darbību, tiek atgriezti ienestie dati serializētā JSON formātā. Nākamajā tabulā ir aprakstīti PullDeviceDataResultsJSON izvades parametri.
| JSON īpašums | Tipi | Detalizēta informācija |
|---|---|---|
| ID | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
| ConnectionState | boolean | Vai ierīce ir atvienota (aplams) vai savienota (patiess) |
| ConnectionStateUpdatedTime | datetime | Pēdējā savienojuma stāvokļa atjauninājuma laikspiedols no IoT nodrošinātāja |
| DeviceReportedProperties | string | Ierīces ziņotie rekvizīti, formatēti kā JSON virkne |
| LastActivityTime | datetime | Ierīces pēdējās ziņotās darbības laikspiedols |
Parauga izvade.
{
"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"
}
]
}
Reģistrēt ierīci
Darbība Reģistrēt ierīci izveido saistību starp ierīci vai ierīču kolekciju un IoT nodrošinātāju. Var reģistrēt jaunas ierīces un ierīces vai komponentus, kurus tehniķis nomaina. Pēc ierīces reģistrēšanas tā tiek parādīta IoT ierīces ieraksta cilnē Reģistrācijas vēsture .
Tā kā vienlaikus var reģistrēt vairākas ierīces, darbībai Reģistrēt ierīci ir nepieciešama EntityCollection ievade. Nākamajā tabulā ir aprakstīti EntityCollection parametri.
| Parametrs | Tipi | Detalizēta informācija |
|---|---|---|
| msdyn_iotdeviceid | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
| msdyn_name | string | Ierīces nosaukums |
| @odata.type | string | Entītijas OData tips |
Ievades paraugs:
{
"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"
}
]
}
Darbība Reģistrēt ierīci atgriež reģistrācijas rezultātus serializētā JSON formātā. Nākamajā tabulā ir aprakstīti RegistrationResultsJSON izvades parametri.
| JSON īpašums | Tipi | Detalizēta informācija |
|---|---|---|
| ID | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
| RegistrationStatus | OptionSetValue | IoT nodrošinātāja reģistrācijas statuss atpakaļ uz pakalpojumu Connected Field Service Vērtības un etiķetes: - 192350000: nezināms - 192350001: nereǵistrēts - 192350002: notiek izpilde - 192350003: reǵistrēts - 192350004: kļūda Piezīmes: Opciju kopa ir opciju saraksts ar etiķetes vērtības kartēšana, piemēram, nolaižamā saraksta vadīkla. |
| DeviceId | string | Ierīces ID IoT nodrošinātāja sistēmā |
| Ziņojums | string | Detalizēts ziņojums Connected Field Service lietotājam par reģistrāciju |
Parauga izvade.
{
"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"
}
]
}
Apkopotie ierīces rādījumi
Darbība Apkopotie ierīču rādījumi iegūst apkopotus ierīces datus no IoT nodrošinātāja. Apkopotie dati sniedz ātru ierīces stāvokļa momentuzņēmums kopsavilkuma elementos pakalpojumā Connected Field Service.
Tālāk esošajā tabulā ir aprakstīti darbības Aggregated device readings ievades parametri.
| Parametrs | Tipi | Detalizēta informācija |
|---|---|---|
| deviceId | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
| mēri | string | Mērījumu saraksts JSON formātā; piemērus skatiet tālāk norādītajā koda fragments |
Ievades paraugs:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Darbība Apkopotie ierīču rādījumi atgriež mērījumus sērijveida JSON formātā. Šajā tabulā ir parādīti izvades parametri.
| JSON īpašums | Tipi | Detalizēta informācija |
|---|---|---|
| measuresOutput | string | Atgriezto mērījumu vērtības JSON formātā; piemērus skatiet tālāk norādītajā koda fragments |
Parauga izvade.
[
{
"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"
}
]
Apkopoto ierīču rādījumu pamatā ir ierīces datu vēstures entītija, ja neizmantojat darbību Apkopotie ierīces rādījumi.
Vaicājuma ierīces rādījumi
Darbība Vaicājuma ierīces rādījumi iegūst vēsturiskos ierīces datus, piemēram, temperatūru un mitrumu, no IoT nodrošinātāja un parāda tos kā laikrindu diagrammu.
Nākamajā tabulā ir aprakstīti darbības Query ierīces rādījumi ievades parametri.
| Parametrs | Tipi | Detalizēta informācija |
|---|---|---|
| No | datetime | Nolasījuma (mērījuma) sākuma laiks ISO formātā; piemēram, "2020-04-10T13:51:55.781Z" |
| Kam: | datetime | Nolasīšanas (mērījuma) beigu laiks ISO formātā |
| IoTDeviceId | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
| Intervāls | string | ISO-8601 ilguma formātā norādītā parauglaukuma intervāla lielums; piemēram, 1 minūte ir "PT1M", 1 milisekunde ir "PT0.001S" Visi intervāli ir vienāda izmēra. Viens mēnesis vienmēr tiek pārvērsts par 30 dienām, un viens gads vienmēr ir 365 dienas. |
Ievades paraugs:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Darbība Vaicājuma ierīces rādījumi atgriež datus serializētā JSON formātā. Šajā tabulā ir parādīti izvades parametri.
| JSON īpašums | Tipi | Detalizēta informācija |
|---|---|---|
| AggregatedDeviceReadings | String | Atgriezto mērījumu vērtības JSON formātā; piemērus skatiet tālāk norādītajā koda fragments |
Parauga izvade.
{
"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
}
}
}
}
Ierīces notikumu iegūšana
Darbība Iegūt ierīces notikumus izgūst notikumus no ierīces pakalpojumu vēstures un parāda tos kā piespraudes diagrammas apakšdaļā, kas izveidota ar darbību Vaicājuma ierīces rādījumi. Varat iekļaut jebkādas pielāgotas entītijas, piemēram, pēdējo reizi, kad veicāt līdzekļa atjaunināšanu.
Piezīmes
Jums nav jāizveido jauna darbība. Reģistrējiet darbībai pielāgotu spraudni msdyn_IoTGetDeviceEvents , piemēram, spraudņus notikumu izveidei.
Nākamajā tabulā ir aprakstīti darbības Iegūt ierīces notikumus ievades parametri.
| JSON īpašums | Tipi | Detalizēta informācija |
|---|---|---|
| No | datetime | Nolasījuma (mērījuma) sākuma laiks ISO formātā; piemēram, "2020-04-10T13:51:55.781Z" |
| Kam: | datetime | Nolasīšanas (mērījuma) beigu laiks ISO formātā |
| IoTDeviceId | string | GUID ierīces ID (msdyn_iotdevice) pakalpojumā Connected Field Service, kas pārvērsts par virkni |
Ievades paraugs:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Darbība Iegūt ierīces notikumus atgriež datus serializētā JSON formātā. Šajā tabulā ir parādīti izvades parametri.
| JSON īpašums | Tipi | Detalizēta informācija |
|---|---|---|
| EventsName | string | Īss pasākuma kategorijas apraksts; izmantojiet to, lai rādītu vai paslēptu visus šīs kategorijas notikumus |
| Laikspiedols | string | Notikuma laikspiedols, kas formatēts kā virkne ISO formātā; Notikuma tapas laikspiedols uz X ass |
| Krāsa | string | Notikuma tapas krāsa, kas tiek nodrošināta kā sešstūra koda virkne |
| Apraksts | string | Īss notikuma apraksts, kas tiek parādīts, kad lietotājs novieto kursoru virs piespraudes vai atlasa piespraudi, lai skatītu detalizētu informāciju |
| ID | string | Notikuma ID; var būt vārds vai cita lietotājam draudzīga vērtība, piemēram, darba pasūtījums numurs vai rezervācijas apstiprinājuma kods |
| Tabula | string | Ar notikumu saistītais Dataverse entītijas nosaukums; piemēram, "msdyn_workorder" |
| Vietrādis URL | string | Notikuma detalizētās informācijas lapas vietrādis URL, piemēram, saistīt uz darba pasūtījums veidlapu Ja nododat entītiju un GUID, sistēma automātiski ģenerē hipersaiti. |
| GUID | string | Entītijas ieraksta GUID, kas pārvērsts virknē Dataverse |
Parauga izvade.
{
"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"
}
}
}
Nākamās darbības
Atsauksmes
Drīzumā: 2024. gada laikā mēs pakāpeniski pārtrauksim izmantot “GitHub problēmas” kā atsauksmju par saturu mehānismu un aizstāsim to ar jaunu atsauksmju sistēmu. Papildinformāciju skatiet: https://aka.ms/ContentUserFeedback.
Iesniegt un skatīt atsauksmes par