SnapArc 3 Stahování archivů z řídicích systémů a regulátorů

SnapArc 3 Stahování archivů z řídicích systémů a regulátorů Návod na obsluhu Verze 1.00 snaparc_g_cz_100

AMiT, spol. s r. o. nepřejímá žádné záruky, pokud se týče obsahu této publikace a vyhrazuje si právo měnit obsah dokumentace bez závazku tyto změny oznámit jakékoli osobě či organizaci. Tento dokument může být kopírován a rozšiřován za následujících podmínek: 1. Celý text musí být kopírován bez úprav a se zahrnutím všech stránek. 2. Všechny kopie musí obsahovat označení autorského práva společnosti AMiT, spol. s r. o. a veškerá další upozornění v dokumentu uvedená. 3. Tento dokument nesmí být distribuován za účelem dosažení zisku. V publikaci použité názvy produktů, firem apod. mohou být ochrannými známkami nebo registrovanými ochrannými známkami příslušných vlastníků. AMiT je registrovaná ochranná známka. Copyright (c) 2016, AMiT, spol. s r. o. Výrobce: AMiT, spol. s r. o. Naskové 1100/3, 150 00 Praha www.amit.cz Technická podpora: support@amit.cz snaparc_g_cz_100 2/20

Obsah Historie revizí... 4 Související dokumentace... 4 1 Úvod... 5 2 Instalace... 7 2.1 Doporučená konfigurace PC... 7 2.2 Instalace... 7 2.3 Odinstalace... 7 3 Stahovací nástroj SnapArc... 8 4 Grafické uživatelské rozhraní... 9 4.1 Kontrola uživatelských vstupů... 9 4.2 Nabídkové menu... 10 4.2.1 Soubor... 10 4.2.2 Nastavení... 10 PC se připojuje jako stanice... 11 4.2.3 Nápověda... 11 4.3 Konfigurace... 11 4.3.1 Přidání/změna konfigurace připojení... 11 Sériová linka... 11 Ethernet... 12 Servisní mód... 13 4.3.2 Přidání/změna konfigurace archivu... 13 Obecné... 14 Názvy záhlaví... 15 4.4 Stavový řádek... 16 4.5 Stahování... 16 4.5.1 Průběh stahování... 17 4.5.2 Vytváření názvů archivních souborů... 18 5 Automatické spouštění... 19 Vypnutí ověřování proměnných... 20 3/20 snaparc_g_cz_100

Historie revizí Jméno dokumentu: snaparc_g_cz_100.pdf Verze Datum Autor změny Změny 100 01. 09. 2016 Kuklík Jan Nový dokument Související dokumentace 1. AtouchX Manuál komunikačního ovladače AtouchX soubor: atouchx.chm 2. Nápověda k části PseDet vývojového prostředí DetStudio soubor: Psedet_cs.chm snaparc_g_cz_100 4/20

1 Definice použitých pojmů Stanice Řídicí systém nebo programovatelný regulátor firmy AMiT spol. s r. o. Symbolická adresa Symbolická adresa začíná otazníkem, který následuje přiděleným jménem (např.?mojestanice). Validace Vyčtení všech zadaných proměnných v konfiguraci ze stanice a porovnání jejich typů a dimenzí s definicí těchto proměnných v konfiguraci. 5/20 snaparc_g_cz_100

2 Úvod SnapArc je nástroj pro stahování archivů ze stanic firmy AMiT spol. s r. o. na pevný disk počítače. Základní vlastnosti Možnost vytváření, načítaní a ukládání konfigurací Možnost ukládat archivy do souboru typu *.txt, *.csv nebo *.mdb Podpora ukládání archivů podle nastaveného typu archivu Podpora stahování více archivů z více stanic najednou Možnost spouštění programu v Plánovaných úlohách snaparc_g_cz_100 6/20

3 Instalace 3.1 Doporučená konfigurace PC Pro úspěšný chod programu se předpokládá použití počítače se systémem Windows XP SP3 (a vyšším) s nainstalovaným.net Framework 4.0 (a vyšším) a nainstalovanou knihovnou AtouchX. Knihovna AtouchX je dostupná na stránkách www.amit.cz v sekci Automation a prostředí.net na stránkách www.microsoft.com. 3.2 Instalace 3.3 Odinstalace Pro instalaci je nutné mít na počítači administrátorská práva. Pro vlastní chod programu postačí běžná uživatelská práva. Program SnapArc se instaluje pomocí instalátoru SnapArcSetupxxx.exe, který je dostupný na stránkách www.amit.cz v sekci Automation. Při instalaci probíhá kontrola existence potřebných knihoven. Pokud na počítači nebudou naistalovány, pokusí se instalátor tyto knihovny doinstalovat. Pro instalaci knihovny.net je potřebné internetové připojení. Program lze odinstalovat následujícím postupem. V ovládacích panelech vyberte položku Přidat nebo odebrat programy, Vyberte program SnapArc a zvolte funkci Odebrat. Nebo v nabídce Start AMiT SnapArc Odinstalovat aplikaci SnapArc. 7/20 snaparc_g_cz_100

4 Stahovací nástroj SnapArc Program SnapArc umožňuje stahování archivů ze stanic firmy AMiT spol. s r. o. a jejich ukládání na pevný disk počítače. Najednou lze stahovat více archivů z více stanic. U každého archivu lze definovat formát, v jakém se budou ukládat stažená data: Databáze Microsoft Access soubory typu *.mdb Databáze ViewDet soubory typu *.mdb Textový soubor soubory typu *.txt Comma-separated values (oddělovač středník) soubory typu *.csv Každému archivu je možné nastavit typ archivu: denní, týdenní, měsíční, roční. Podporované typy připojení ke stanicím: sériová linka, ethernet (UDP, TCP), servisní mód. Program pracuje ve dvou režimech: Automatický režim za pomoci naplánovaných úloh, provádí se pouze stahování (žádná konfigurace), Dialogový režim možnost plné konfigurace. Program ukládá logovací informace do souboru SNAPARC.LOG do složky C:\Users\<jméno uživatelského profilu>\documents\snaparc. Program nepodporuje práci s provozním deníkem. snaparc_g_cz_100 8/20

5 Grafické uživatelské rozhraní Grafické rozhraní je rozděleno na tři základní části. V horní liště je nabídkové menu, které umožňuje pracovat s danou konfigurací a nastavením programu. Uprostřed okna jsou tabulky pro nastavení stahování. Na dolním okraji okna je stavový řádek. Obr. 1 Okno programu 5.1 Kontrola uživatelských vstupů Každá hodnota, která je uživatelem zadána, je kontrolována zda splňuje podmínky očekávané hodnoty. Pokud uživatel zadá neplatnou hodnotu (místo čísla text, zápornou hodnotu místo kladné, ), je vstupní box ohraničen červeným rámečkem a po najetí kurzoru na tento box je zobrazena chyba. V tabulce se chyba označuje vykřičníkem vedle řádku s chybou. Chyba se zobrazuje po umístění kurzoru na vykřičník. Kontrola chyby u samostatného text boxu probíhá ihned po zadání znaku. U tabulky probíhá kontrola poté, co je hodnota v tabulce potvrzena, to je vstoupením kurzoru na jiný prvek v otevřeném okně. 9/20 snaparc_g_cz_100

Obr. 2 Chybný uživatelský vstup Obr. 3 Chybný uživatelský vstup v tabulce Pokud uživatel nezadá všechny vstupy správně, je mu znemožněno potvrzení dialogového okna. Doporučuje se, aby uživatel chybu vstupu ihned po vzniku opravil. Pokud tak neudělá, je možné, že program při dalším vyhodnocování vstupu nebude vyhodnocovat hodnotu správně (předchozí chybná hodnota nemůže být použita pro kontrolu vstupů). 5.2 Nabídkové menu 5.2.1 Soubor 5.2.2 Nastavení Menu Soubor umožňuje vytvoření nové konfigurace, načtení a uložení konfigurace a také ukončení programu. Menu Nastavení umožňuje nastavit jazyk programu a nastavit parametry PC pro komunikaci se stanicemi. Obr. 4 Nastavení adresy PC snaparc_g_cz_100 10/20

5.2.3 Nápověda 5.3 Konfigurace PC se připojuje jako stanice číslo (0 až 31), pod kterým se PC připojuje do sítě. Více informací o adresaci PC, lze nalézt v nápovědě komunikačního ovladače AtouchX (viz Související dokumentace). Menu Nápověda umožňuje zobrazit nápovědu k programu a obecné informace o programu. Konfigurace označuje seznam všech připojení a jejich definic archivů. Toto se definuje v prostřední části programu SnapArc, které je dále děleno na dvě tabulky. Horní tabulka obsahuje seznamem připojení. Spodní tabulka obsahuje seznam archivů pro vybrané připojení. Každá tato tabulka umožňuje přidávat, upravovat i odstraňovat jednotlivé položky ze seznamu. Pod tabulkami je tlačítko Začít stahovat pro spuštění stahování archivů. 5.3.1 Přidání / změna konfigurace připojení Pro každé připojení je nutné provést správné nastavení parametrů připojení. Je-li to nutné, musí uživatel pracovat i s ofsetem. Více informací o komunikačním ovladači AtouchX se dočtete v nápovědě tohoto ovladače (viz Související dokumentace). Poznámka Práce s ofsetem a adresou stanice je rozdílná v programu SnapArc oproti standardní práci s komunikačním ovladačem AtouchX. V případě SnapArc se adresa stanice nedefinuje jako přečíslovaná adresa, tedy součet adresy nastavené např. přes DIP přepínače + ofset, ale pouze jako skutečně nastavená adresa. Přečíslovanou adresu pro ovladač AtouchX dopočítává program SnapArc sám. Je však stále nutné zajistit jedinečnost všech přečíslovaných adres v rámci definice celé sítě. Sériová linka Obr. 5 Nastavení komunikace COM 11/20 snaparc_g_cz_100

COM číslo sériového portu (1 až 256), prostřednictvím kterého komunikuje PC se stanicí. Rychlost komunikační rychlost, pomocí které se komunikuje se stanicí. Tato rychlost musí být nastavena na sériovém rozhraní připojené stanice. Ofset posun čísla stanice oproti číslu DIP přepínače. Parametr může nabývat pouze hodnot 0, 32, 64, 96, 128, 160, 192 a 224. Ethernet Komunikace pomocí ethernetu může probíhat pomocí protokolu UDP nebo TCP (protokol TCP podporují pouze W systémy s NOS v3.59 a vyšším). Obr. 6 Nastavení komunikace Ethernet IP adresa IP adresa, na které je dostupná stanice. Jde zadat v číselném tvaru (např. 192.168.35.1) nebo symbolicky. Port UDP / TCP port (0 až 65535, implicitně 59), prostřednictvím kterého stanice komunikuje na přidělené IP adrese. Heslo bezpečnostní heslo (0 až 2 32-1), které je nadefinováno v IP konfiguraci stanice. Znalost hesla je nutná pro přístup na stanici. Timeout maximální čas v milisekundách (0 až 3600000, implicitně 3000), který čeká PC na odpověď na každý zaslaný paket stanici. Ofset (0 až 65504) posun čísla stanice oproti číslu DIP přepínače. Protokol typ protokolu, který se má použít. snaparc_g_cz_100 12/20

Servisní mód Pro komunikaci v servisním módu musí být ve stanici nahrán NOS verze minimálně 3.39. Obr. 7 Nastavení komunikace Servisní mód COM číslo sériového portu (1 až 256), prostřednictvím kterého komunikuje PC se stanicí. Timeout maximální čas v milisekundách (0 až 3600000, implicitně 1000), který čeká PC na odpověď na každý zaslaný paket stanici. Ofset (0 až 65504) posun čísla stanice oproti číslu DIP přepínače. 5.3.2 Přidání / změna konfigurace archivu Při jakékoli změně v konfiguraci archivu je doporučeno odstranit soubory, do kterých by se mělo znovu zapisovat. Pokud se program pokusí zapisovat do souboru s chybnou nebo rozdílnou strukturou, skončí zápis chybou nebo nekonzistencí dat v souboru. Při ukládání konfigurace archivu do seznamu konfigurací (potvrzení dialogového okna Nastavení archivů) je provedena kontrola na existenci potenciálně shodných souborů ve složce pro ukládání archivů. Může-li dojít k přepisu je uživatel varován dialogovým oknem. Obr. 8 Varování na možný přepis Uložení konfigurace archivu je uživateli povolena pouze pokud všechna vstupní pole jsou správně vyplněna a tabulka WID Data obsahuje alespoň jeden platný řádek s datovou maticí archivu. 13/20 snaparc_g_cz_100

Obecné Obr. 9 Nastavení archivu obecné Jméno archivu unikátní jméno archivu. Toto jméno se objevuje i v názvu vytvářených archivních souborů. Pokud nebude zadáno unikátní jméno, dochází k pokusu o přepis již vytvořených souborů nebo zápisu do souboru s chybnou strukturou. Adresa stanice adresa (číslo) stanice (0 až 31). Typ souboru typ souboru, do kterého se budou data ukládat. Cesta k souboru umístění, kam se budou ukládat archivní soubory se staženými daty. Umístění musí v době vytváření konfigurace již existovat. Typ archivu časové období, které určuje počet dat uložených v jednom souboru. Hloubka archivu hloubka archivu ve stanici. WID Index číselný identifikátor proměnné indexu archivu. WID Čas číselný identifikátor proměnné obsahující časovou osu archivu. WID Data tabulka obsahující seznam datových matic archivu: WID číselný identifikátor datové proměnné v archivu, Typ typ datové proměnné v archivu (více informací o datových typech v nápovědě k části PseDet prostředí DetStudio), Počet řádků počet řádků datové proměnné. snaparc_g_cz_100 14/20

Odebrat umožňuje odebrání datové matice. Tlačítko je přístupné pouze pokud uživatel má vybrán řádek a v tabulce je definována více než jedna datová proměnná. Upozornění Hodnoty zadané v WID Index, WID Čas a v tabulce WID Data (WID, Typ a Počet řádků) musí přesně odpovídat hodnotám nastaveným ve stanici. Stejně tak musí přesně odpovídat hodnota Hloubka archivu s počty sloupců archivních matic. Pokud všechny tyto hodnoty nebudou souhlasit, neproběhne Validace archivu úspěšně. Není tedy možné stahovat jen výřez archivní matice. Názvy záhlaví Při definování archivu je automaticky vytvořeno jméno pro jednotlivé datové sloupce (resp. řádky) archivní matice odvozené od čísla WIDu databázové proměnné. Obr. 10 Nastavení archivu názvy záhlaví Jméno jméno datového sloupce, které bude uloženo na první řádce v souboru. WID číselný identifikátor datové proměnné (pouze pro čtení). Řádek řádek datové proměnné (pouze pro čtení). Formát formát ukládané hodnoty. Podle tohoto formátu bude hodnota upravena a zapsána do souboru (pouze pro *.csv a *.txt soubory). 15/20 snaparc_g_cz_100

Formát ukládané hodnoty Formát Příklad čísla Zobrazí se General number 12345,123456 12345,123456 Scientific 12345,123456 1,23E+04 0 12345,123456 12345 0,0 12345,123456 12345,1 0,00 12345,123456 12345,12 0,000 12345,123456 12345,123 000,0 12,345 012,3 ###,# 12,345 12,3 5.4 Stavový řádek 5.5 Stahování Ve stavovém řádku se v pravé části zobrazuje cesta k právě otevřenému souboru konfigurace. Pokud není konfigurace doposud načtena nebo uložena, není nic zobrazeno. Po stisku tlačítka Začít stahovat se provede základní kontrola definic konfigurací. Po úspěšné kontrole se objeví okno zobrazující průběh stahování. V tomto okně se vypisují informace o právě stahovaných vzorcích. Upozornění Před spuštěním stahování dat archivů se provádí validace. Toto může probíhat delší dobu (v závislosti na počtu archivů a nastavení sítě). Obr. 11 Ukázka stahování snaparc_g_cz_100 16/20

Obr. 12 Ukázka stahování validace s chybou Stahování lze předčasně ukončit tlačítkem Ukonči stahování a zavři okno. Pokud při validaci některého archivu dojde k chybě, nezačne se tento archiv vůbec stahovat. Pokud se vyskytne chyba při stahování archivu a ukládání archivního vzorku do databáze je stahování ukončeno a ve statusu se zobrazí, v které části nastala chyba. Jsou-li dostupné další informace o chybě, tak jsou zobrazeny ve sloupci poznámka. Pro korektní stahování archivů musí ve stanici běžet aplikace. Více informací o nastavení stanic naleznete na webových stránkách www.amit.cz v sekci Automation viz nápověda k části PseDet prostředí DetStudio. 5.5.1 Průběh stahování Vytvoření konfiguračních souborů pro ovladač AtouchX. Konfigurační soubory jsou uloženy do složky C:\Users\<jméno uživatelského profilu>\documents\snaparc. Vytvoření instance komunikačního ovladače AtouchX. Ověření připojení stanice, validace archivů. Spuštění stahování archivů. Příjem dat (ze všech archivů současně). Pokud nejsou přijata data v časovém úseku, je archiv prohlášen za nedostupný a stahování tohoto archivu je ukončeno. Stahuje se, dokud všechny archivy nejsou stažené nebo jejich stahování není chybové. 17/20 snaparc_g_cz_100

5.5.2 Vytváření názvů archivních souborů Názvy archivních souborů se vytvářejí automaticky v závislosti na typu archivu (den, týden, měsíc, rok) a na pojmenování archivu. Názvy archivních souborů pro jednotlivé typy archivů vypadají takto: Období Rok Měsíc Týden Den Jméno souboru Yyyyy_JménoArchivu.přípona Myyyy_mm_JménoArchivu.přípona Wyyyy_ww_JménoArchivu.přípona Dyyyy_mm_dd_JménoArchivu.přípona Použité zkratky: yyyy rok, mm měsíc, dd den, ww týden, JménoArchivu jméno archivu zadané uživatelem, Přípona přípona vytvářená podle formátu souboru (mdb, csv, txt). Příklad pojmenování souboru: D2002_01_15_Archiv1.csv Jedná se o denní archiv z 15. ledna 2002. Jméno archivu je Archiv1. snaparc_g_cz_100 18/20

6 Automatické spouštění Program SnapArc umožňuje zadáním parametrů /RUN soubor_konfigurace automatické odstartování stahování archivů při spuštění programu. Pokud je program takto spuštěn, tak dojde i k automatickému ukončení programu. Ukončení nastane, pokud zadané archivy jsou v koncovém stavu. Koncový stav je dokončení stahování všech dostupných dat archivu nebo chyba při stahování (zařízení není dostupné, chybný formát souboru pro ukládání). Automatické spouštění (a ukončení) lze s výhodou použít ve spojení s Plánovanými úlohami v operačním systému Windows. Potom lze například nakonfigurovat automatické stahování archivu vždy v pátek ve 23:00. Tato funkce samozřejmě předpokládá, že jsou již všechny archivy správně nadefinovány. Při výskytu jakékoli chyby při vytváření komunikačního objektu AtouchX v režimu automatického spouštění stahování archivů dojde k ukončení programu. Při nenalezení konfiguračního souboru nebo jeho chybné struktuře je zobrazeno varovné hlášení a program je ukončen. Pokud nastane chyba při stahování archivu, je tento archiv při stahování přeskakován a stahují se ostatní archivy. Chyba je zapsána do logovacího souboru SNAPARC.LOG ve složce C:\Users\<jméno uživatelského profilu>\documents\snaparc. V režimu automatického spuštění je zobrazena notifikační ikona v oznamovací oblasti. Pomocí této ikony jde zobrazit okno se stahováním nebo ukončit stahování. Obr. 13 Notifikační ikona v oznamovací oblasti Příklad spuštění: SnapArc.exe /RUN C:\Users\user\Documents\SnapArc\testConf.xml Upozornění Doporučuje se, aby běžel pouze jeden program SnapArc pracující se složkou s archivy. Jinak by mohlo docházet k nežádoucím přepisům souborů a chybám. 19/20 snaparc_g_cz_100

Vypnutí validace Před spuštěním stahování dat archivů se provádí validace. Toto může probíhat delší dobu (v závislosti na počtu archivů a nastavení sítě), proto může být přeskočen zadání parametru /F. Příklad spuštění: SnapArc.exe /RUN C:\Users\user\Documents\SnapArc\testConf.xml /F Standardně je validace zapnuta. V grafickém uživatelském rozhraní není možné validaci vypnout. Upozornění Pořadí parametrů při automatickém spouštění nelze měnit. Parametr /RUN musí být první, cesta k souboru druhý a na posledním místě může být přepínač vypnutí validace. snaparc_g_cz_100 20/20