IoT - implementace v IS FLORES

Konfigurace IoT číselníků

Dále je třeba si nakonfigurovat IoT číselníky:

Odesílání dat do IS FLORES

Do byla doplněna možnost příjmu IoT dat pomocí http požadavků zaslaných na adresu {webapi server}/IoTData. Data se posílají standardně v JSON formátu pomocí http požadavku typu PUT.

V případě velkého množství vstupních dat je vhodnější vstupní IoT data uložit v RT (real time) a následně je pouze v omezeném množství např. filtrovaná resp. agregovaná zasílat do IS FLORES.

Zasílaná vstupní data musí obsahovat hodnoty:

SensorCode – řetězcová identifikace senzoru, který data zaznamenal např.: "F3799"
SensorQuantity – řetězcové pojmenování veličiny, kterou senzor zaznamenal např.: "Temperature"
RecordedAt – datum a čas zaznamenání hodnoty senzorem např. "2016-03-4T17:55:00.000"
Jako další je třeba předat hodnotu pomocí pole, které určuje i typ dat:
- NumericValue - pro číselnou hodnotu např: 10.5
- DateTimeValue - pro hodnotu typu datu a čas např.: "2016-03-4T17:55:00.000"
- ShortStringValue - pro hodnotu krátký text (do 500znaků) např.: "krátký text"
- BinaryBlobValue - pro hodnotu s binárními daty zadané pomocí Base64 např.: "FDSA="
- TextBlobValue - pro hodnotu s dlouhým řetězcem např.: "dlouhý text"
- BooleanValue - pro logickou hodnotu např.: true resp. false

Nepovinná vstupní data:

UNID – univerzální identifikátor např.: "T0BX5PNTY03O3IRDGNVQVACJGW“ nebo "{F3799000-0000-0000-0000-000000000154}"

Zvolíme metodu PUT. Budeme ji směřovat na kolekci data IoT, čili URL adresa bude následující:

http://localhost/data/IoTData

Předvedeme si přidání záznamu teploty a stavu baterie. V datech stačí uvést jen to, co chceme na Business objektu změnit. Data v JSON reprezentaci:

{
	"SensorCode": "F3799",
	"SensorQuantity": "Temperature",
	"RecordedAt": "2017-05-15T16:31:00.000",
	"NumericValue": 22.5
}

Data zadáme a odešleme. Po úspěšné modifikaci Web API opět vrátí status 200 OK a rovnou opět kompletní reprezentaci zmodifikovaného objektu.

{
	"SensorCode": "F3799",
	"SensorQuantity": "Battery",
	"RecordedAt": "2017-05-15T16:32:00.000",
	"ShortStringValue": "low",
	"UNID": "S5Q15UOPWSMOXCGQFHTOBNXHDW"
}

Po příjmu vstupních dat FLORES WebAPI IoT ověří, jestli zaslaná data nejsou již v systému zapsána (zaslané UNID se shoduje s uloženým UNID v FLORES), pokud ano, potvrdí přijetí dat (status 200 OK) a data již dále nezpracovává.

Pokud data nejsou doposud v systému, dochází dle pravidel nadefinovaných v číselníku Pravidel přiřazení dat IoT k vyhodnocení, jestli vstupní IoT data budou přijata a k jakému záznamu v IS FLORES budou přiřazena. Pokud vstupní data IoT nevyhoví žádnému pravidlu, je požadavek zamítnut (status 406 Not Acceptable).

Data, která vyhoví podmínkám, jsou uložena do tabulky IoT dat. Pokud by data vyhověla více pravidlům, založí se více záznamů IoT dat se stejným UNID.

Zobrazení IoT dat v IS FLORES

K dispozici jsou následující možnosti: