Nastavení akcí poskytovatele IoT
Po nastavení poskytovatele IoT (Internet věcí) můžete zadat sadu akcí, které se mají aktivovat na základě zachycených dat ze zařízení IoT vaší organizace. Spolu s pěti předdefinovanými akcemi můžete vytvořit vlastní akce, které jsou přidruženy k vašemu poskytovateli za účelem automatizace různých aspektů vašich operací Connected Field Service.
Connected Field Service obsahuje následující akce:
- Stáhnout data zařízení
- Zaregistrovat zařízení
- Agregované odečty zařízení
- Dotazy na odečty zařízení
- Získat události zařízení
Stáhnout data zařízení
Akce Stáhnout data zařízení načte nejnovější data pro jedno zařízení nebo kolekci zařízení od poskytovatele internetu věcí. Zobrazí se na kartě Historie dat zařízení.
Protože data mohou pocházet z více zařízení, akce Stáhnout data zařízení vyžaduje jako vstup EntityCollection. Následující tabulka popisuje parametry EntityCollection.
| Parametr | Type | Detaily |
|---|---|---|
| msdyn_iotdeviceid | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
| msdyn_name | string | Název zařízení |
| @odata.type | string | Datový typ OData entity |
Ukázkové zadání:
{
"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"
}
]
}
Akce Stáhnout data zařízení vrátí načtená data v serializovaném formátu JSON. Následující tabulka popisuje parametry výstupu PullDeviceDataResultsJSON.
| Vlastnost JSON | Type | Detaily |
|---|---|---|
| ID | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
| ConnectionState | boolean | Zda je zařízení odpojeno (false) nebo připojeno (true) |
| ConnectionStateUpdatedTime | datetime | Časové razítko poslední aktualizace stavu připojení od poskytovatele IoT. |
| DeviceReportedProperties | string | Hlášené vlastnosti zařízení formátované v řetězci JSON. |
| LastActivityTime | datetime | Časové razítko poslední hlášené aktivity zařízení |
Ukázkový výstup:
{
"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"
}
]
}
Zaregistrovat zařízení
Akce Registrovat zařízení vytvoří přidružení mezi zařízením nebo kolekcí zařízení a poskytovatelem internetu věcí. Lze registrovat nová zařízení a zařízení nebo komponenty, které technik vymění. Jakmile zařízení zaregistrujete, zobrazí se na kartě Historie registrace záznamu zařízení IoT.
Protože lze najednou zaregistrovat více zařízení, vyžaduje akce Registrace zařízení jako vstup EntityCollection. Následující tabulka popisuje parametry EntityCollection.
| Parametr | Type | Detaily |
|---|---|---|
| msdyn_iotdeviceid | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
| msdyn_name | string | Název zařízení |
| @odata.type | string | Datový typ OData entity |
Ukázkové zadání:
{
"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"
}
]
}
Akce Registrovat zařízení vrátí výsledky registrace v serializovaném formátu JSON. Následující tabulka popisuje parametry výstupu RegistrationResultsJSON.
| Vlastnost JSON | Type | Detaily |
|---|---|---|
| ID | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
| RegistrationStatus | OptionSetValue | Stav registrace od poskytovatele IoT zpět do Connected Field Service Hodnoty a štítky: - 192350000: Neznámé - 192350001: Neregistrováno - 192350002 : Probíhající - 192350003: Zaregistrováno - 192350004: Chyba Poznámka: OptionSet je seznam možností s mapováním hodnot popisků jako ovládací prvek rozevíracího seznamu. |
| DeviceId | string | ID zařízení v systému poskytovatele IoT. |
| Message | string | Podrobná zpráva uživateli služby Connected Field Service týkající se registrace |
Ukázkový výstup:
{
"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é odečty zařízení
Akce Agregované hodnoty zařízení načítá agregovaná data zařízení od poskytovatele IoT. Agregace dat poskytuje rychlý přehled stavu zařízení v souhrnných dlaždicích v Connected Field Service.
Následující tabulka popisuje vstupní parametry akce Agregované hodnoty zařízení.
| Parametr | Type | Detaily |
|---|---|---|
| deviceId | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
| opatření | string | Seznam měření ve formátu JSON; příklady naleznete v následujícím fragmentu kódu |
Ukázkové zadání:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Akce Agregované odečty zařízení vrátí měření v serializovaném formátu JSON. V následující tabulce jsou uvedeny výstupní parametry.
| Vlastnost JSON | Type | Detaily |
|---|---|---|
| measuresOutput | string | Hodnoty vrácených měření ve formátu JSON; příklady naleznete v následujícím fragmentu kódu |
Ukázkový výstup:
[
{
"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é odečty jsou založeny na entitě historie dat zařízení, pokud nepoužíváte akci Agregované odečty zařízení.
Dotazy na odečty zařízení
Akce Dotaz na odečty zařízení načte historická data zařízení, jako je teplota a vlhkost, od poskytovatele IoT a zobrazí je jako graf časové řady.
Následující tabulka popisuje vstupní parametry akce Dotazy na odečty zařízení.
| Parametr | Type | Detaily |
|---|---|---|
| From | datetime | Počáteční čas odečtu (měření) ve formátu ISO, např. "2020-04-10T13:51:55.781Z" |
| To | datetime | Koncový čas odečtu (měření) ve formátu ISO |
| IoTDeviceId | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
| Interval | string | Velikost intervalu vykreslovacího bodu zadaná ve formátu trvání ISO-8601; například 1 minuta je „PT1M“, 1 milisekunda je „PT0.001S“ Všechny intervaly mají stejnou velikost. Jeden měsíc je vždy převeden na 30 dní a jeden rok je vždy 365 dní. |
Ukázkové zadání:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Akce Dotaz na odečty zařízení vrátí data v serializovaném formátu JSON. V následující tabulce jsou uvedeny výstupní parametry.
| Vlastnost JSON | Type | Detaily |
|---|---|---|
| AggregatedDeviceReadings | Řetězcové | Hodnoty vrácených měření ve formátu JSON; příklady naleznete v následujícím fragmentu kódu |
Ukázkový výstup:
{
"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ískat události zařízení
Akce Získat události zařízení načte události ze servisní historie zařízení a zobrazí je jako špendlíky ve spodní části grafu vytvořeného akcí Dotaz na hodnoty zařízení. Můžete zahrnout libovolné vlastní entity, jako například při posledním upgradu prostředku.
Poznámka:
Nemusíte vytvořit novou akci. Zaregistrujte vlastní modul plug-in v akci msdyn_IoTGetDeviceEvents, například moduly plug-in pro vytváření událostí.
Následující tabulka popisuje vstupní parametry akce Získat události zařízení.
| Vlastnost JSON | Type | Detaily |
|---|---|---|
| From | datetime | Počáteční čas odečtu (měření) ve formátu ISO, např. "2020-04-10T13:51:55.781Z" |
| To | datetime | Koncový čas odečtu (měření) ve formátu ISO |
| IoTDeviceId | string | ID zařízení GUID (msdyn_iotdevice) v Connected Field Service převedeno na řetězec. |
Ukázkové zadání:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Akce Získat události zařízení vrátí data v serializovaném formátu JSON. V následující tabulce jsou uvedeny výstupní parametry.
| Vlastnost JSON | Type | Detaily |
|---|---|---|
| EventsName | string | Krátký popis kategorie události; použijte jej k zobrazení nebo skrytí všech událostí v dané kategorii |
| Časové razítko | string | Časové razítko události formátované jako řetězec ve formátu ISO; časové razítko osy x pro špendlík události |
| Color | string | Barevný kód špendlíku události jako řetězec hexadecimálního kódu |
| Description | string | Krátký popis události zobrazený, když uživatel umístí ukazatel myši na špendlík, nebo když vybere špendlík pro zobrazení podrobností |
| ID | string | ID události; může být název nebo jiná uživatelsky přívětivá hodnota, jako je číslo objednávky nebo kód potvrzení rezervace |
| Entity | string | Název entity Dataverse související s událostí; například "msdyn_workorder" |
| URL | string | Adresa URL stránky s podrobnostmi o události, například odkaz na formulář objednávky Pokud předáte entitu a GUID, systém automaticky vygeneruje hypertextový odkaz. |
| Identifikátor GUID | string | GUID převedený na řetězec záznamu entity v Dataverse |
Ukázkový výstup:
{
"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"
}
}
}