Systém pro sběr a distribuci meteorologických údajů
(Systém Meteoris)

Aplikace zobrazující meteorologické údaje
(Metoris - Údaje)

autor: Ing. Dominik Mervart
únor 2018, verze 1.1

Uživatelská příručka



1. Úvod

Tato uživatelská příručka je určena uživatelům aplikace Meteoris - Údaje a obsahuje rady a postupy pro její ovládání.

Aplikace smí být volně šířena.

2. Popis aplikace

Aplikace je součástí systému Meteoris, který se zabývá sběrem a distribucí meteorologických údajů přijatých z klientských měřících stanic a také poskytováním údajů převzatých z externích stanic. Tato aplikace primárně slouží pro čtení a zobrazování meteorologických údajů vlastních nebo převzatých stanic ze serveru Meteoris.

Funkce aplikace:
Vlastnosti aplikace:
Požadavky na systém:
3. Práce s aplikací

3.1. Spuštění aplikace

Aplikace je distribuována v archivu RAR. Rozbalte ji nejdříve do libovolné složky některým z běžných archivačních programů (WinRAR, WinZip, Unrar).

Aplikace vyžaduje pro svůj běh nainstalované Java Runtime Environment (JRE). Pokud je JRE správně nainstalováno, stačí spustit aplikaci poklepáním na spouštěcí soubor MeteorisUdaje.jar v hlavním adresáři aplikace. Pokud se nepodaří aplikaci takto spustit, je třeba otevřít příkazový řádek, (ve Windows: Start - Spustit - cmd.exe) a spustit aplikaci příkazem:

java -jar cesta/MeteorisUdaje.jar

případně

cesta_k_JRE/java -jar cesta/MeteorisUdaje.jar

Aplikace nevyžaduje instalaci ani jinou konfiguraci v systému. V případě vzniku chyby nebo varování je podrobnější informace zapsána do logovacího souboru cesta/log.txt.

3.2. Čtení údajů ze serveru

Po prvním spuštění aplikace je nutné nastavit parametry "místa", pro které se budou číst údaje. Nastavení čtení ze serveru je v menu Nastavení -> Nastavení čtení a ukládání.

Jako server lze použít libovolný server, formát adresy je možné změnit. U serveru Meteoris je adresa včetně parametrů předvyplněna a stačí vyplnit ID místa (viz seznam mých míst na serveru Meteoris) a uživatelské heslo. U serveru Meteoris je heslo odesíláno zašifrované jako otisk SHA-1.

Interval čtení ze serveru je doporučen alespoň 5 minut.

3.3. Ukládání do souboru

V menu Nastavení -> Nastavení ukládání je možné zvolit název souboru, do kterého chcete načtené údaje ukládat. Lze také zvolit interval ukládání a to, zda se má pro každý den použít nový soubor.

3.4. Alarmy

V menu Nastavení -> Nastavení upozornění lze nastavit až 3 typy alarmů. Lze definovat teplotu při jejímž překročení se alarm spustí a také zda jde o překročení přes nebo pod nastavenou teplotu (vzestup či pokles teploty). Při spuštění alarmu lze přehrát zvuk (každý alarm má jiný) a tento zvuk je možné nechat nekonečně opakovat.

3.5. Odeslání emailu při alarmu

Tato funkčnost zatím není implementována, ale je plánována v budoucnu. K odeslání emailu bude možné využít externí poštovní SMTP server (např. G-mail). Bude podporován také šifrovaný režim pomocí SSL.

3.6. Minimalizace aplikace

Aplikace se standardně minimalizuje do systémové lišty. Při měření je teplota zobrazena při najetí myší na ikonu v systémové liště (není nutné okno otevírat). Minimalizaci do systémové lišty je možné změnit v menu Nastavení -> Nastavení aplikace.

3.7. Zobrazení nápovědy

Tuto uživatelskou příručku je v programu možné zobrazit v menu Nápověda -> Uživatelská příručka nebo stisknutím klávesy F1.

4. Chybová hlášení

Pokud dojde v aplikaci k závažné chybě a nelze pokračovat v běhu programu, je zobrazeno okno o tom, že se stala chyba, podrobnější informace je zapsána do logovacího souboru cesta/log.txt a aplikace je ukončena. Pokud není chyba závažná, je pouze zobrazena informace o chybě a je zapsána do logu jako varování, ale program není ukončen.

Pokud vznikne neočekávaná běhová (run-time) výjimka způsobená chybou v programu, není zalogována a je na uživateli, aby o ní a okolnostech jejího vzniku dal vědět tvůrci aplikace, aby mohla být opravena.

Možné chybové zprávy a jejich řešení:

Došlo k chybě při čtení údajů ze serveru.
Údaje nemohly být ze serveru přečteny, chyba je blíže specifikována. Je možné, že jde o dočasný výpadek serveru nebo byla chybně uvedena adresa serveru.

Nelze přidat ikonu do systémové lišty.
Váš systém nemá systémovou lištu, nemůžete tudíž tuto funkčnost využívat.

Nelze nastavit Look & Feel.
Požadovaný vzhled není v této verzi Java Runtime Environment podporován, nainstalujte si prosím aktuální verzi JRE.

Nelze nastavit Look & Feel.
Požadovaný vzhled není v této verzi Java Runtime Environment podporován, nainstalujte si prosím aktuální verzi JRE.

Nelze číst/zapisovat z nebo do souboru.
Nemáte přístupová práva ke čtení nebo zápisu do tohoto souboru nebo je název souboru neplatný. Změňte cestu nebo název souboru.

Nelze načíst dokument z JAR archivu.
Spouštěcí soubor aplikace byl poškozen, nahraďte ho prosím originálním souborem.

Nelze spočítat otisk řetězce hešovací funkcí SHA-1.
Hešovací funkce SHA-1 není v této verzi Java Runtime Environment podporována, nainstalujte si prosím aktuální verzi JRE. Bez této funkce nebude aplikace fungovat.