Datanodes

Poznámka: Stránka Datanodes je viditelná pouze uživatelům s oprávněním manage datanodes. Viz Oprávnění.

Typ datanodu určuje, jakým způsobem se získávají data:

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

V uživatelském rozhraní můžete nastavit základní parametry datanodu a vlastnosti specifické pro jeho typ. Datanode lze také přiřadit k datahubu, zejména pokud je v doméně dostupných více datahubů.

Tabulka obsahuje všechny datanody v doméně:

Hlavní akce:

• Edit Datanode – umožňuje upravit parametry existujícího datanodu
• Delete Datanode – umožňuje smazat vybraný datanode

Tlačítka:

• Create Datanode – otevře modální okno pro vytvoření nového datanodu
• Datanode Variables – otevře modální okno s proměnnými datanodu
• Datanode Events – otevře modální okno s událostmi datanodu

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

V tomto okně můžete nastavit parametry datanodu:

• Name – název datanodu
• Datahub – výběr datahubu. Pokud je v doméně dostupný jen jeden, pole je skryté. Jinak vyberte ten, který odpovídá konfiguraci a typu datanodu.
• Database profile – databázový profil datanodu
• Type – typ datanodu, který určuje, jaké vlastnosti lze nastavit
• Datanode type properties – vlastnosti specifické pro vybraný typ datanodu.

Řádek zvýrazněný červeně je povinné pole a musí být vyplněn. Pokud řádek zvýrazněný není, vlastnost je volitelná a může zůstat prázdná. Některá pole mohou mít předvyplněné výchozí hodnoty.

Modální okno se seznamem dostupných proměnných datanodu a jejich poslední známou hodnotou v systému Mervis včetně časové značky.

Modální okno s událostmi datanodu. Zobrazuje aktuální stav daného datanodu a pomáhá při diagnostice chyb datanodu.

• Popis
  • Stahuje 15minutová naměřená data (profily ICC1, ISC1, IKC1, IMC1, ICCS) z EGD Distribuce24 OpenAPI.
• Postup získání client_id a client_secret
  • Přihlaste se na portal.distribuce24.cz svými stávajícími zákaznickými údaji (e-mail z registrace + heslo – nejde o přihlašovací údaje k API).
  • Přejděte do sekce Správa účtu.
  • Otevřete záložku Vzdálený přístup - OpenAPI.
  • Klikněte na tlačítko pro vygenerování client_id a client_secret.
• Vlastnosti
  • 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 token (OAuth2) endpointu pro získání přístupového tokenu (povinné)

• Popis
  • Stahuje export naměřených dat ze zákaznického portálu ČEZ Distribuce.
• Pokyny
  • 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).
• Vlastnosti
  • 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.
• Pokyny
  • 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.
• Vlastnosti
  • 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ý symbol {eui}, který se nahradí hodnotou DevEui.
• Vlastnosti
  • 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í dosazované za {eui} v ServerUrlTemplate (povinné)

• Popis
  • Stahuje data o spotřebě plynu z portálu iave.gasnet.cz.
• Pokyny
  • 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.
• Vlastnosti
  • 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 odběrného místa plynu, 16 znaků – velká písmena a číslice (povinné)
  • PmId: číslo PM (předávacího místa) pro filtrování (volitelné)
  • UpId: číslo UP (umístění/odběrného místa) pro filtrování (volitelné)

• Popis
  • Stahuje data vodoměrů ze Smart API (endpointy /api/SmartData/…).
• Vlastnosti
  • 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 / vodoměru (povinné)

• Popis
  • Stahuje 15minutová i denní data z EGD SMARAGD API (sdílí infrastrukturu Distribuce24).
• Postup 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 účtu.
  • Otevřete záložku Vzdálený přístup - OpenAPI.
  • Klikněte na tlačítko pro vygenerování client_id a client_secret.
• Vlastnosti
  • 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 token (OAuth2) endpointu pro získání přístupového 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í vracet sloupce:
    • Variable_Id - jedineč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í vracet sloupce:
    • parametry @utcfrom, @utcto, @id (id proměnné)
    • návratové sloupce UtcTimeStamp (datum a čas) a DoubleValue (číselná hodnota)
• Vlastnosti
  • ConnectionString: připojovací řetězec podle zvolené databáze; driver přidává 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: začá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ěrů protokolem DLMS/COSEM přes TCP.
• Vlastnosti
  • 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ělte čárkami (povinné)
  • DeviceTimeZone: časové pásmo zařízení (Windows TZ id) použité pro DLMS asociaci (povinné)