IoT-szolgáltatói műveletek beállítása
Miután beállított egy IoT- (eszközök internetes hálózata) szolgáltatót, megadhatja a szervezet IoT-eszközeiről rögzített adatok alapján aktiválni kívánt műveletek készletét. Az öt előre definiált művelet mellett létrehozhat egyéni műveleteket , amelyek a szolgáltatóhoz vannak társítva a Connected Field Service műveletek különböző aspektusainak automatizálásához.
A Connected Field Service a következő műveleteket tartalmazza:
- Eszközadatok lekérése
- Eszköz regisztrálása
- Összesített eszközértékek
- Eszközolvasások lekérdezése
- Eszközesemények lekérése
Eszközadatok lekérése
Az Eszközadatok lekérése művelet lekéri egy eszköz vagy eszközgyűjtemény legfrissebb adatait az IoT-szolgáltatótól. Ez megjelenik az Eszközadat-előzmények lapon.
Mivel az adatok több eszközről is származhatnak, az Eszközadatok lekérése művelethez bemenetként EntityCollection szükséges. Az alábbi táblázat az EntityCollection paramétereit ismerteti.
Paraméter | Type | Details |
---|---|---|
msdyn_iotdeviceid | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
msdyn_name | sztring | Az eszköz neve |
@odata.type | sztring | Az entitás OData-típusa |
Minta bemenet:
{
"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"
}
]
}
Az Eszközadatok lekérése művelet szerializált JSON formátumban adja vissza a lekért adatokat. Az alábbi táblázat a PullDeviceDataResultsJSON-kimenet paramétereit ismerteti.
JSON-tulajdonság | Type | Details |
---|---|---|
Azonosító | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
ConnectionState | boolean | Az eszköz leválasztása (hamis) vagy csatlakoztatva (igaz) van-e |
ConnectionStateUpdatedTime | datetime | Az IoT-szolgáltató utolsó kapcsolatállapot-frissítésének időbélyege |
DeviceReportedProperties | sztring | Az eszköz jelentett tulajdonságai JSON-sztringként formázva |
LastActivityTime | datetime | Az eszköz utoljára jelentett tevékenységének időbélyege |
Kimenetminta:
{
"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"
}
]
}
Eszköz regisztrálása
Az Eszköz regisztrálása művelet társítást hoz létre egy eszköz vagy eszközgyűjtemény és az IoT-szolgáltató között. Új eszközök és eszközök vagy alkatrészek, amelyeket a technikus kicserél, regisztrálhatók. Miután regisztrált egy eszközt, az megjelenik az IoT-eszközrekord Regisztrációs előzmények lapján.
Mivel egyszerre több eszköz is regisztrálható, az Eszköz regisztrálása művelethez bemenetként EntityCollection szükséges. Az alábbi táblázat az EntityCollection paramétereit ismerteti.
Paraméter | Type | Details |
---|---|---|
msdyn_iotdeviceid | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
msdyn_name | sztring | Az eszköz neve |
@odata.type | sztring | Az entitás OData-típusa |
Minta bemenet:
{
"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"
}
]
}
Az Eszköz regisztrálása művelet szerializált JSON formátumban adja vissza a regisztrációs eredményeket. Az alábbi táblázat a kimenet RegistrationResultsJSON paramétereit ismerteti.
JSON-tulajdonság | Type | Details |
---|---|---|
Azonosító | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
RegistrationStatus | OptionSetValue | Az IoT-szolgáltatótól a Connected Field Service szolgáltatásba történő regisztráció állapota Értékek és címkék: - 192350000: Ismeretlen - 192350001: Nem regisztrált - 192350002: Folyamatban - 192350003: Regisztrálva - 192350004: Hiba. Megjegyzés: Az OptionSet olyan lehetőségek listája, amelyek címkeérték leképezés tartalmaznak, mint egy legördülő lista vezérlőelem. |
DeviceId | sztring | Az eszköz azonosítója az IoT-szolgáltató rendszerében |
Üzenet | sztring | Részletes üzenet a Connected Field Service felhasználójának a regisztrációval kapcsolatban |
Kimenetminta:
{
"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"
}
]
}
Összesített eszközértékek
Az Összesített eszközolvasások művelet összesített eszközadatokat kér le az IoT-szolgáltatótól. Az összesített adatok gyors pillanatkép biztosítanak az eszköz állapotáról a Connected Field Service összegző csempéin.
Az alábbi táblázat az Összesített eszközolvasások művelet bemeneti paramétereit ismerteti.
Paraméter | Type | Details |
---|---|---|
deviceId | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
mérések | sztring | A mérések listája JSON formátumban; Példákért tekintse meg az alábbi kód kódrészlet |
Minta bemenet:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Az Összesített eszközolvasások művelet szerializált JSON formátumban adja vissza a méréseket. Az alábbi táblázat a kimeneti paramétereket jeleníti meg.
JSON-tulajdonság | Type | Details |
---|---|---|
measuresOutput | sztring | A visszaadott mérések értékei JSON formátumban; Példákért tekintse meg az alábbi kód kódrészlet |
Kimenetminta:
[
{
"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"
}
]
Az összesített eszközértékek az eszközadatelőzmények entitáson alapulnak, ha nem használja az Összesített eszközértékek műveletet.
Eszközolvasások lekérdezése
Az Eszközolvasás lekérdezése művelet lekéri az eszközelőzményadatokat, például a hőmérsékletet és a páratartalmat az IoT-szolgáltatótól, és idősorozat-diagramként jeleníti meg őket.
Az alábbi táblázat az Eszközolvasások lekérdezése művelet bemeneti paramétereit ismerteti.
Paraméter | Type | Details |
---|---|---|
From | datetime | A leolvasás (mérés) kezdő időpontja ISO formátumban; Például: "2020-04-10T13:51:55.781Z" |
Fogadó | datetime | A leolvasás (mérés) befejezési ideje ISO formátumban |
IoTDeviceId | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
Intervallum | sztring | A nyomtatási pont ISO-8601 időtartamformátumban megadott intervallummérete; például 1 perc "PT1M", 1 ezredmásodperc "PT0.001S" Minden intervallum azonos méretű. Egy hónap mindig 30 nappá alakul, egy év pedig mindig 365 nap. |
Minta bemenet:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Az Eszközolvasások lekérdezése művelet szerializált JSON formátumban adja vissza az adatokat. Az alábbi táblázat a kimeneti paramétereket jeleníti meg.
JSON-tulajdonság | Type | Details |
---|---|---|
AggregatedDeviceReadings | Sztring | A visszaadott mérések értékei JSON formátumban; Példákért tekintse meg az alábbi kód kódrészlet |
Kimenetminta:
{
"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
}
}
}
}
Eszközesemények lekérése
Az Eszközesemények beolvasása művelet eseményeket kér le az eszközszolgáltatás előzményeiből , és gombostűkként jeleníti meg őket az Eszközolvasások lekérdezése művelet által létrehozott diagram alján. Bármilyen egyéni entitást, például az eszköz frissítésének utolsó műveletét is megadhatja.
Feljegyzés
Nem kell új műveletet létrehoznia. Regisztráljon egy egyéni beépülő modult a művelethez, például beépülő modulokat a msdyn_IoTGetDeviceEvents
létrehozási eseményekhez.
Az alábbi táblázat az Eszközesemények beolvasása művelet bemeneti paramétereit ismerteti.
JSON-tulajdonság | Type | Details |
---|---|---|
From | datetime | A leolvasás (mérés) kezdő időpontja ISO formátumban; Például: "2020-04-10T13:51:55.781Z" |
Fogadó | datetime | A leolvasás (mérés) befejezési ideje ISO formátumban |
IoTDeviceId | sztring | A GUID eszközazonosító (msdyn_iotdevice) a Connected Field Service szolgáltatásban, karakterlánccá alakítva |
Minta bemenet:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Az Eszközesemények beolvasása művelet szerializált JSON formátumban adja vissza az adatokat. Az alábbi táblázat a kimeneti paramétereket jeleníti meg.
JSON-tulajdonság | Type | Details |
---|---|---|
EventsName | sztring | Az esemény kategóriájának rövid leírása; Segítségével megjelenítheti vagy elrejtheti az adott kategória összes eseményét |
Időbélyegző | sztring | Az esemény időbélyege ISO formátumú karakterláncként formázva; Az eseménytű X tengelyének időbélyege |
Color | sztring | Az eseménytű színe, hexadecimális kódú karakterláncként megadva |
Description | sztring | Az esemény rövid leírása, amely akkor jelenik meg, amikor a felhasználó a gombostű fölé viszi az egérmutatót, vagy kiválasztja a gombostűt a részletek megtekintéséhez |
Azonosító | sztring | Az esemény azonosítója; Lehet név vagy más felhasználóbarát érték, például a munkarendelés száma vagy a foglalást megerősítő kód |
Entity | sztring | Az Dataverse eseményhez kapcsolódó entitásnév; például "msdyn_workorder" |
URL-cím | sztring | Az esemény részletes oldalának URL-címe, például a munkarendelés űrlap csatolás Ha átad egy entitást és egy GUID azonosítót, a rendszer automatikusan létrehoz egy hivatkozást. |
GUID-azonosító | sztring | Az entitásrekord karakterlánccá alakított GUID azonosítója Dataverse |
Kimenetminta:
{
"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"
}
}
}
További lépések
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: