Nastavenie akcií poskytovateľa internetu vecí

Článok
11/08/2023

Po nastavení poskytovateľa internetu vecí (IoT) môžete určiť množinu akcií, ktoré sa majú spustiť na základe údajov zachytených zo zariadení IoT vašej organizácie. Spolu s piatimi preddefinovanými akciami môžete vytvoriť vlastné akcie , ktoré sú priradené k vášmu poskytovateľovi na automatizáciu rôznych aspektov vašich operácií Connected Field Service.

So službou Connected Field Service sa dodávajú nasledujúce akcie:

Načítanie údajov zariadenia
Registrácia zariadenia
Agregované hodnoty zo zariadenia
Dotazovanie údajov zo zariadenia
Získanie udalostí v zariadení

Zhromaždiť údaje zariadení

Akcia Pull device data načíta najnovšie údaje pre jedno zariadenie alebo kolekciu zariadení od poskytovateľa internetu vecí. Zobrazí sa na karte História údajov zariadenia.

Keďže údaje môžu pochádzať z viacerých zariadení, akcia Pull device data vyžaduje ako vstup EntityCollection. Nasledujúca tabuľka popisuje parametre EntityCollection.

Parameter	Type	Details
msdyn_iotdeviceid	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec
msdyn_name	string	Názov zariadenia
@odata.type	string	Typ OData entity

Vstup vzorky:

{
  "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"
      }
  ]
}

Akcia Stiahnuť údaje zariadenia vráti načítané údaje v serializovanom formáte JSON. Nasledujúca tabuľka popisuje parametre výstupu PullDeviceDataResultsJSON.

Vlastnosť JSON	Type	Details
Identifikátor	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec
ConnectionState	boolean	Či je zariadenie odpojené (false) alebo pripojené (true)
ConnectionStateUpdatedTime	datetime	Časová pečiatka poslednej aktualizácie stavu pripojenia od poskytovateľa internetu vecí
DeviceReportedProperties	string	Hlásené vlastnosti zariadenia formátované ako reťazec JSON
LastActivityTime	datetime	Časová pečiatka poslednej zaznamenanej aktivity zariadenia

Vzor výstupu:

{
  "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"
     }
  ]
}

Registrovať zariadenie

Akcia Registrovať zariadenie vytvorí priradenie medzi zariadením alebo kolekciou zariadení a poskytovateľom internetu vecí. Je možné zaregistrovať nové zariadenia a zariadenia alebo komponenty, ktoré technik vymení. Po zaregistrovaní sa zariadenie zobrazí na karte História registrácie záznamu zariadenia IoT.

Keďže naraz je možné zaregistrovať viacero zariadení, akcia Registrovať zariadenie vyžaduje ako vstup EntityCollection. Nasledujúca tabuľka popisuje parametre EntityCollection.

Parameter	Type	Details
msdyn_iotdeviceid	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec
msdyn_name	string	Názov zariadenia
@odata.type	string	Typ OData entity

Vstup vzorky:

{
  "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"
    }
  ]
}

Akcia Zaregistrovať zariadenie vráti výsledky registrácie v serializovanom formáte JSON. Nasledujúca tabuľka popisuje parametre výstupu RegistrationResultsJSON.

Vlastnosť JSON	Type	Details
Identifikátor	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec
RegistrationStatus	HodnotaMnožinyMožností	Stav registrácie od poskytovateľa internetu vecí späť do Connected Field Service Hodnoty a štítky: - 192350000: Neznáme - 192350001: Neregistrované - 192350002: Prebieha - 192350003: Registrované - 192350004: Chyba Poznámka : OptionSet je zoznam možností s priradením hodnoty označenia, napríklad ovládací prvok rozbaľovacieho zoznamu.
DeviceId	string	ID zariadenia v systéme poskytovateľa internetu vecí
Správa	string	Podrobná správa pre používateľa Connected Field Service týkajúca sa registrácie

Vzor výstupu:

{
   "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"   
      }   
  ]
}

Agregované hodnoty zo zariadenia

Akcia Agregované hodnoty zariadenia načíta agregované údaje o zariadení od poskytovateľa internetu vecí. Agregované údaje poskytujú rýchly prehľad o stave zariadenia na súhrnných dlaždiciach v Connected Field Service.

Snímka obrazovky zariadenia IoT v Field Service zobrazujúca súhrnné hodnoty.

Nasledujúca tabuľka popisuje vstupné parametre akcie Agregované hodnoty zariadenia.

Parameter	Type	Details
deviceId	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec
miery	string	Zoznam meraní vo formáte JSON; Pozrite si nasledujúce príklady úryvok kódu

Vstup vzorky:

[
    {
        "Measure":"Humidity",
        "Aggregate":"Min",
        "TimeRangeType":"Days",
        "TimeRangeValue":7
    },
    {
        "Measure":"Temperature",
        "Aggregate":"Avg",
        "TimeRangeType":"Days",
        "TimeRangeValue":14
    }
]

Akcia Agregované hodnoty zariadenia vráti merania v sériovom formáte JSON. Nasledujúca tabuľka zobrazuje výstupné parametre.

Vlastnosť JSON	Type	Details
measuresOutput	string	Hodnoty vrátených meraní vo formáte JSON; Pozrite si nasledujúce príklady úryvok kódu

Vzor výstupu:

[
    {
        "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"
    }
]

Agregované hodnoty zariadení sú založené na entite histórie údajov zariadenia, ak nepoužívate akciu Agregované hodnoty zariadení.

Dotazovanie údajov zo zariadenia

Akcia Údaje zo zariadenia dotazu načíta historické údaje zariadenia, napríklad teplotu a vlhkosť, od poskytovateľa internetu vecí a zobrazí ich ako graf časových radov.

Snímka obrazovky s teplotou a vlhkosťou zariadenia v priebehu času.

Nasledujúca tabuľka popisuje vstupné parametre akcie Dotazovať hodnoty zariadenia.

Parameter	Type	Details
From	datetime	Čas začiatku odčítania (merania) vo formáte ISO; Napríklad 2020-04-10T13:51:55.781Z
To	datetime	Čas ukončenia odčítania (merania) vo formáte ISO
IoTDeviceId	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec
Interval	string	Veľkosť intervalu bodu vykreslenia zadaná vo formáte trvania ISO-8601; napríklad 1 minúta je PT1M, 1 milisekunda je PT0,001S Všetky intervaly majú rovnakú veľkosť. Jeden mesiac sa vždy prevedie na 30 dní a jeden rok je vždy 365 dní.

Vstup vzorky:

{
    "From":"2023-04-01T18:05:37.661Z", 

    "To":"2023-05-31T18:05:37.661Z", 

    "IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 

    "Interval":"P1D"
}

Akcia Query device readings vráti údaje v sériovom formáte JSON. Nasledujúca tabuľka zobrazuje výstupné parametre.

Vlastnosť JSON	Type	Details
AggregatedDeviceReadings	String	Hodnoty vrátených meraní vo formáte JSON; Pozrite si nasledujúce príklady úryvok kódu

Vzor výstupu:

{
  "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
      }
    }
  }
}

Získanie udalostí v zariadení

Akcia Získať udalosti zariadenia načíta udalosti zo servisnej histórie zariadenia a zobrazí ich ako špendlíky v dolnej časti grafu vytvoreného akciou Dotaz na hodnoty zariadenia . Môžete zahrnúť akékoľvek vlastné entity, napríklad poslednýkrát, kedy ste vykonali aktualizáciu zariadenia.

Snímka obrazovky s udalosťami zobrazenými ako špendlíky pod grafom teploty a vlhkosti zariadenia v priebehu času.

Poznámka

Nemusíte vytvárať novú akciu. Zaregistrujte si pri akcii vlastný doplnok msdyn_IoTGetDeviceEvents , napríklad doplnky na vytváranie udalostí.

Nasledujúca tabuľka popisuje vstupné parametre akcie Získať udalosti zariadenia.

Vlastnosť JSON	Type	Details
From	datetime	Čas začiatku odčítania (merania) vo formáte ISO; Napríklad 2020-04-10T13:51:55.781Z
To	datetime	Čas ukončenia odčítania (merania) vo formáte ISO
IoTDeviceId	string	ID zariadenia GUID (msdyn_iotdevice) v Connected Field Service, skonvertované na reťazec

Vstup vzorky:

{ 
    "IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 
    "From": "2023-06-12T18:57:54.864Z", 
    "To": "2023-06-12T19:57:54.864Z" 
}

Akcia Získať udalosti zariadenia vráti údaje v sériovom formáte JSON. Nasledujúca tabuľka zobrazuje výstupné parametre.

Vlastnosť JSON	Type	Details
EventsName	string	Stručný opis kategórie podujatia Použite ho na zobrazenie alebo skrytie všetkých udalostí v danej kategórii
Časová pečiatka	string	Časová pečiatka udalosti formátovaná ako reťazec vo formáte ISO; časová pečiatka osi x pre špendlík udalosti
Color	string	Farba špendlíka udalosti poskytnutá ako reťazec šestnástkového kódu
Description	string	Krátky popis udalosti, ktorý sa zobrazí, keď používateľ umiestni kurzor myši na špendlík alebo ho vyberie a zobrazí sa jeho podrobnosti.
Identifikátor	string	ID udalosti; Môže to byť meno alebo iná užívateľsky prívetivá hodnota, napríklad číslo objednávky prác alebo potvrdzovací kód rezervácie
Entity	string	Názov Dataverse entity súvisiaci s udalosťou, napríklad "msdyn_workorder"
URL	string	URL adresa stránky s podrobnosťami o udalosti, napríklad prepojenie na formulár objednávky prác Ak odovzdáte entitu a identifikátor GUID, systém automaticky vygeneruje hypertextové prepojenie.
GUID	string	Identifikátor GUID skonvertovaný na reťazec záznamu entity v Dataverse

Vzor výstupu:

{
  "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"
    }
  }
}

Zdieľať cez

Nastavenie akcií poskytovateľa internetu vecí

Zhromaždiť údaje zariadení

Registrovať zariadenie

Agregované hodnoty zo zariadenia

Dotazovanie údajov zo zariadenia

Získanie udalostí v zariadení

Ďalšie kroky

Ďalšie zdroje informácií