Datanodes

Typ datanodu určuje způsob, jakým jsou data získávána:

• IoT LoRa typy (např. uh30, prolora, elliot…) – přijímají data z ČRA a obvykle odpovídají jednomu konkrétnímu fyzickému zařízení, například elektroměru či vodoměru.
• HTTP typy (např. gasnet, spotrebapodpalcem, distribuce24…) – aktivně načítají data z externích API. Ne vždy jde o jedno zařízení – data mohou být agregovaná, zpracovaná službou, nebo může jeden datanode obsluhovat i stovky fyzických zařízení najednou.

V uživatelském rozhraní lze pro datanode nastavit základní konfigurační parametry a specifické vlastnosti daného typu. Také je možné přiřadit datanode k datahubu, pokud je jich v doméně dostupných více.

Hlavní akce:

• Edit Datanode – umožňuje změnit parametry existujícího datanodu
• Delete Datanode – umožňuje odstranit vybraný datanodu

Tlačítka:

• Create Datanode – otevře modální okno pro vytvoření nového datanodu
• Datanode variables – otevře modální okno zobrazující proměnné datanodu
• Datanode events – otevře modální okno zobrazující události datanodu

Modální okno pro vytvoření nového datanodu

V tomto okně lze nastavit parametry datanodu:

• Name – název datanodu
• Datahub – výběr datahubu. Pokud je v doméně dostupné pouze jeden datahub, toto pole se nezobrazuje. V opačném případě vyberte to, které odpovídá nastavení daného datanodu a jeho typu.
• Database profile – databázový profil datanodu
• Type – typ datanodu, který určuje, jaké vlastnosti lze datanodu nastavit
• Datanode type properties – vlastnosti datanodu závislé na jeho typu. Pokud je řádek označen červeně, jedná se o povinnou vlastnost, kterou je nutné vyplnit. Pokud označen není, jde o nepovinnou vlastnost a její hodnota může zůstat prázdná. U některých vlastností může být předvyplněna výchozí hodnota.

Modální okno zobrazující seznam dostupných proměnných datanodu a jejich poslední známou hodnotu v systému Mervis, společně s časovou známkou této hodnoty.

Modální okno zobrazující události datanodu. Jedná se o aktuální stav daného datanodu, sloužící mimo jiné pro hledání chyb datanodu.

• Popis
  • Stahuje 15min naměřená data (profily ICC1, ISC1, IKC1, IMC1, ICCS) z EGD Distribuce24 OpenAPI.
• Návod na získání client_id a client_secret
  • Přihlaste se na portal.distribuce24.cz pomocí svých stávajících zákaznických údajů (e-mail z registrace + heslo — pozor, nejedná se o API údaje).
  • Přejděte do sekce Správa účtů.
  • Otevřete záložku Vzdálený přístup - OpenAPI.
  • Klikněte na tlačítko Vygenerovat client_id a client_secret.
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: client_id (povinné)
  • Password: client_secret (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • Ean: EAN odběrného místa, 18 číslic (povinné)
  • AuthUrlTemplate: URL tokenového (OAuth2) endpointu pro získání access tokenu (povinné)

• Popis
  • Stahuje export naměřených dat ze zákaznického portálu ČEZ Distribuce.
• Návod
  • UserName a Password jsou přihlašovací údaje k zákaznickému portálu ČEZ Distribuce.
  • Ean = EAN odběrného místa (parametr opmId).
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: uživatelské jméno k portálu ČEZ Distribuce (povinné)
  • Password: heslo k portálu ČEZ Distribuce (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • Ean: EAN odběrného místa, 18 číslic (povinné)

• Popis
  • Stahuje profily spotřeby z portálu PREdistribuce.
• Návod
  • UserName a Password jsou přihlašovací údaje k portálu Můj účet PREdistribuce.
  • Ean = EAN odběrného místa, pro které se stahují profily spotřeby.
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: uživatelské jméno k portálu PREdistribuce (povinné)
  • Password: heslo k portálu PREdistribuce (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • Ean: EAN odběrného místa, 18 číslic (povinné)

• Popis
  • Stahuje JSON data jednoho LoRaWAN zařízení z VisionQ REST API.
• Poznámky k URL
  • ServerUrlTemplate obsahuje zástupný znak {eui}, který je nahrazen hodnotou DevEui.
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: uživatelské jméno pro přihlášení k API (povinné)
  • Password: heslo k API (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • DevEui: EUI LoRaWAN zařízení dosazené do {eui} v ServerUrlTemplate (povinné)

• Popis
  • Stahuje data o spotřebě plynu z portálu iave.gasnet.cz.
• Návod
  • UserName a Password jsou přihlašovací údaje k portálu iave.gasnet.cz.
  • Eic najdete v detailu odběrného/předávacího místa na portálu.
  • PmId / UpId slouží k volitelnému zúžení výběru míst.
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: uživatelské jméno k portálu iave.gasnet.cz (povinné)
  • Password: heslo k portálu iave.gasnet.cz (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • Eic: EIC plynového odběrného místa, 16 znaků - velká písmena a číslice (povinné)
  • PmId: číslo PM (předávacího místa) pro filtraci - nepovinné (volitelné)
  • UpId: číslo UP (umístění/odběrné místo) pro filtraci - nepovinné (volitelné)

• Popis
  • Stahuje data vodoměrů z API Smart (endpointy /api/SmartData/…).
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: uživatelské jméno pro OAuth2 password grant (povinné)
  • Password: heslo pro OAuth2 password grant (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • ClientId: OAuth2 client_id aplikace (povinné)
  • ClientSecret: OAuth2 client_secret aplikace (povinné)
  • CpId: identifikátor odběrného místa / měřidla (povinné)

• Popis
  • Stahuje 15min i denní data z EGD SMARAGD API (sdílí infrastrukturu Distribuce24).
• Návod na získání client_id a client_secret
  • Přihlaste se na portal.distribuce24.cz svými zákaznickými údaji (e-mail z registrace + heslo).
  • Přejděte do sekce Správa účtů.
  • Otevřete záložku Vzdálený přístup - OpenAPI.
  • Klikněte na tlačítko Vygenerovat client_id a client_secret.
• Properties
  • ServerUrlTemplate: šablona základní URL REST API (povinné)
  • UserName: client_id (povinné)
  • Password: client_secret (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • Ean: EAN odběrného místa, 18 číslic (povinné)
  • AuthUrlTemplate: URL tokenového (OAuth2) endpointu pro získání access tokenu (povinné)

• Popis
  • Univerzální čtení dat z relační databáze pomocí vlastních SQL dotazů.
  • Podporované databáze (DatabaseType): PostgreSQL, MySQL.
• Poznámky k dotazům
  • VariableListSelect musí vrátit sloupce:
    • Variable_Id - jednoznačný identifikátor proměnné
    • Variable_Name - zobrazovaný název
    • sloupce s prefixem MervisKey_* a MervisNonKey_* - klíčová a doplňková metadata (např. jednotka)
  • DataRetrievalSelect používá zástupné parametry a musí vrátit sloupce:
    • parametry @utcfrom, @utcto, @id (id proměnné)
    • návratové sloupce UtcTimeStamp (datum a čas) a DoubleValue (číselná hodnota)
• Properties
  • ConnectionString: připojovací řetězec dle zvolené databáze; driver doplní Pooling/Keepalive (povinné)
  • DatabaseType: typ databáze: PostgreSQL nebo MySQL, bez mezer (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • VariableListSelect: SQL dotaz vracející seznam proměnných (viz Poznámky k dotazům) (povinné)
  • DataRetrievalSelect: SQL dotaz pro stažení hodnot s parametry @utcfrom/@utcto/@id (viz Poznámky) (povinné)
  • ReadFrom: počátek historie (DateTimeOffset); výchozí = první den aktuálního měsíce v UTC (volitelné)
  • DataRetrievalDelay: prodleva mezi dotazy na jednotlivé proměnné (TimeSpan HH:MM:SS nebo ms) (volitelné)

• Popis
  • Čte registry elektroměru protokolem DLMS/COSEM přes TCP.
• Properties
  • Host: IP adresa nebo hostname zařízení (povinné)
  • Port: TCP port zařízení, pouze číslice, např. 4059 (povinné)
  • CommInterval: interval pravidelného stahování dat ve formátu TimeSpan, např. 01:00:00 (povinné)
  • CommTaskCron: volitelný cron výraz pro plánování stahování; má přednost před CommInterval (volitelné)
  • Password: heslo pro autentizaci k DLMS zařízení (povinné)
  • ObisCode: OBIS kód ve tvaru X.X.X.X.X.X, např. 1.0.99.3.0.255; více kódů oddělených čárkou (povinné)
  • DeviceTimeZone: časové pásmo zařízení (Windows TZ id) použité pro DLMS asociaci (povinné)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.