IoT-szolgáltatói műveletek beállítása

Cikk
10/05/2023

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éssel rendelkeznek, 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épet nyújtanak az eszköz állapotáról a Connected Field Service összegző csempéin.

Képernyőkép egy IoT-eszközről a Field Service-ben, amely összesített értékeket mutat.

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.

Képernyőkép az eszköz hőmérsékletéről és páratartalmáról az idő múlásával.

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.

Képernyőkép az eszköz hőmérséklet- és páratartalom-diagramja alatt gombostűként megjelenített eseményekről.

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 űrlapra mutató hivatkozá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"
    }
  }
}

Megosztás a következőn keresztül:

IoT-szolgáltatói műveletek beállítása

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

További lépések

Visszajelzés

Visszajelzés

További források