====== Datanodes ====== | Datanode | představuje virtuální zařízení, které zprostředkovává data z různých fyzických zařízení nebo externích služeb. Obsahuje jeden nebo více signálů, proměnných či hodnot, se kterými dále pracuje systém Mervis SCADA | | Datahub | Spravuje váš datanode a zajišťuje jeho komunikaci a ukládání dat. | 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. | Datahub | Spravuje váš datanode a zajišťuje jeho komunikaci a ukládání dat. | {{:cs:mervis-scada:30-portal:portal_datanodes.png?direct|}} **Hlavní akce:** * **Edit Datanode** – umožňuje změnit parametry existujícího datanodu {{:cs:mervis-scada:30-portal:portal_edit_proj_icon.png?20|}} * **Delete Datanode** – umožňuje odstranit vybraný datanodu {{:cs:mervis-scada:30-portal:portal_delete_proj_icon.png?20|}} **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 ===== Create Datanode ===== Modální okno pro vytvoření nového datanodu {{:cs:mervis-scada:30-portal:portal_create_datanode.png?direct|}} 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. ===== Datanode Variables ===== 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. {{:cs:mervis-scada:30-portal:portal_datanode_variables.png?direct|}} ===== Datanode Events ===== 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. {{:cs:mervis-scada:30-portal:portal_datanode_events.png?direct|}} ===== Datanode typy ===== ==== EGD.Distribuce24 (C3601F41-CF30-4F4E-88F3-389FE75FAE76) ==== * 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é) ==== CEZ API (A1B2C3D4-5E6F-7A8B-9C0D-E1F2A3B4C5D6) ==== * 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é) ==== PRE API (B3C4D5E6-7F8A-9B0C-D1E2-F3A4B5C6D7E8) ==== * 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é) ==== VisionQ.REST.API (C330C902-6E5F-46E1-807D-00AA3656F84E) ==== * 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é) ==== IAVE GasNet (3AC8E252-E116-41AE-8EBC-855B1492BC7C) ==== * 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é) ==== Vodarenska Api Smart (AF667576-C22F-40BF-AAA9-0E8DC27EC783) ==== * 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é) ==== EGD.SMARAGD (418E382E-9314-427D-8756-5AB933D322E3) ==== * 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é) ==== Generic SQL (6BDF7851-8625-4C7F-A9A7-62AA13E65FE7) ==== * 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é) ==== DLMS (1582052D-8E77-4EFE-91F1-0BA4A96A98F0) ==== * 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é) ==== . ==== . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .