SNAPARC Stahování archivů z řídicích stanic Uživatelská příručka Verze 2.1 Aplikace Mikroprocesorové Techniky 4.06
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. AMiRiS je registrovaná ochranná známka. DB-Net je registrovaná ochranná známka. AMAP je registrovaná ochranná známka. Copyright (c)2006 AMiT spol. s r. o. AMiT spol. s r. o. Chlumova 17, 130 00 Praha 3, Česká republika tel./fax: +420 222 780 100, 222 781 516, 222 782 297 Kollárova 6a, 612 00 Brno, Česká republika tel./fax: +420 541 217 220, 549 210 403 Starobělská 13, 700 30 Ostrava, Česká republika tel./fax: +420 596 708 300 File:, ManualSnapArc Created: 28.1.02 Autor: Tomáš Holec Rev.: 2.03, Doc.ver.:1.00 Snaparc stahování archivů z řídicích stanic 2
Obsah Obsah 3 1. Úvod 4 2. Obecný popis programu 5 3. Instalace 6 3.1. Spuštění instalace 6 3.2. Odinstalování 6 4. Spuštění programu 7 4.1. Nastavení parametrů komunikační linky 7 4.1.1. Sériová komunikační linka 7 4.1.2. Ethernet 8 4.2. Nastavení parametrů stahovaného archivu 8 4.2.1. Název archivu 8 4.2.2. Adresa stanice 8 4.2.3. Typ souborů 8 4.2.4. Cesta 9 4.2.5. Typ archivu 9 4.2.6. WID Index, Cas, Data 9 4.2.7. Názvy sloupců 10 4.2.8. Formáty čísel 11 5. Vytváření názvů archivních souborů 12 6. Průběh stahování 13 7. Formáty archivních souborů 14 7.1. Formát Access 14 7.2. Formát Excel 14 7.3. Formát Text 15 7.4. Automatické spouštění 15 7.5. Vypnutí ověřování proměnných 16 Snaparc stahování archivů z řídicích stanic 3
1. Úvod Program slouží pro stahování archivů z řídicích stanic firmy AMiT spol. s r.o. na pevný disk počítače. Program je určen pro počítače PC s operačním systémem Windows 98/NT/2000/XP. Pro ukládání dat využívá formáty kancelářských programů Office2000 a také univerzální textový formát. U čtenáře předpokládáme znalost základních pojmů ohledně parametrizace řídicích systémů firmy AMiT (databázová proměnná, archiv, ) a dále základní znalost ovládání Windows. Snaparc stahování archivů z řídicích stanic 4
2. Obecný popis programu Program SnapArc umožňuje jednoduché stahování archivů z řídicích stanic firmy AMiT s.r.o. a jejich ukládání na pevný disk počítače. Najednou lze stahovat více archivů z vícero stanic. U každého archivu lze definovat formát v jakém se budou ukládat stažená data: Databáze Microsoft Access2000 (soubory s příponou *.MDB) Sešit Excel2000 (soubory s příponou *.XLS) Textové soubory (soubory s příponou *.TXT) Dále lze u každého archivu nastavit typ archivu : Denní Týdenní Měsíční Roční Podporované typy připojení k řídicím stanicím : Sériová linka Ethernet Není podporováno připojení typu modem a DOKOPO. Program lze spouštět jak v dialogovém režimu, tak i v automatickém režimu jako naplánovaná úloha v systému Windows. Programe nepodporuje práci s provozním deníkem. Snaparc stahování archivů z řídicích stanic 5
3. Instalace 3.1. Spuštění instalace Instalace se provádí spuštěním programu SNARCxxx0.EXE z instalačního CD. Instalace je jednoduchá a probíhá formou průvodce. Při instalaci doporučujeme neměnit přednastavené parametry. 3.2. Odinstalování 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. Při instalaci nové verze doporučujeme napřed odinstalovat starou verzi. Snaparc stahování archivů z řídicích stanic 6
4. Spuštění programu Po spuštění programu se na obrazovce objeví dialogové okno s tabulkou archivů. Parametry komunikace Start stahování Tabulka archivů pro stahování Konfiguraci program ukládá do souboru SNAPARC.INI, který je umístěn v adresáři odkud se spouští vlastní program SNAPARC.EXE. Ve stejném adresáři je umístěn i logovací soubor SNAPARC.LOG. 4.1. Nastavení parametrů komunikační linky V dialogovém okně Nastavení parametrů je nutné nastavit parametry komunikace, kterou používáme pro spojení s řídicí stanicí. 4.1.1. Sériová komunikační linka Nastavuje se komunikační rychlost a číslo sériového portu. Snaparc stahování archivů z řídicích stanic 7
4.1.2. Ethernet Nastavit se musí správně IP adresa, port (standardně 59) a offset pro adresu stanice. Samozřejmě musí být správně parametrizována i stanice. Bližší informace nalezne zájemce v manuálu PSP3. 4.2. Nastavení parametrů stahovaného archivu 4.2.1. Název archivu Každý archiv musí mít zadané své jednoznačné jméno. Toto jméno se objevuje i v názvu zakládaných archivních souborů. 4.2.2. Adresa stanice Zadává se adresa stanice v síti DB-Net. 4.2.3. Typ souborů Je možné si vybrat ze tří typů formátů Access Snaparc stahování archivů z řídicích stanic 8
Excel Textový soubor 4.2.4. Cesta Lze zadat cestu, kam se budou ukládat archivní soubory. Každý archiv může mít zadanou odlišnou cestu. 4.2.5. Typ archivu Zadává se období, které určuje hloubku archivu uloženou v jednom souboru. Lze vybrat z následujících typů: Den Týden Měsíc Rok Při stahování vzorků se postupuje takto. Z řídicí stanice se vyčte archivní vzorek. Z času údaje archivního vzorku a jména archivu se vytvoří jméno archivního souboru. Pokud tento soubor existuje uloží se archivní vzorek do aktuálního souboru, pokud soubor neexistuje založí se nový archivní soubor. 4.2.6. WID Index, Cas, Data Zadávají se parametry proměnných v řídicí stanici. Pro zadávání databázových proměnných na řídicí stanici slouží dialogové okno: Snaparc stahování archivů z řídicích stanic 9
4.2.7. Názvy sloupců 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é. Uživatel na záložce Názvy sloupců může předdefinovaná jména sloupců přepsat. K těmto sloupcům je vždy ještě přiřazen sloupec s časem, který má název Cas a který přejmenovat nelze.. Snaparc stahování archivů z řídicích stanic 10
4.2.8. Formáty čísel Při ukládání do textového souboru lze pro každou hodnotu nastavit formát čísla. Příklady různých formátů jsou shrnuty v následující tabulce. Formát Příklad čísla Zobrazí se jako General Numer 12345.123456 12345.123456 Scientific 12345.123456 1,23E+04 Fixed 12345.123456 12345.12 0 12345.123456 12345 0,0 12345.123456 12345.1 0,00 12345.123456 12345.12 0,000 12345.123456 12345.123 000,0 1.234 001.2 ###,# 1.234 1.2 Snaparc stahování archivů z řídicích stanic 11
5. 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 archivu vypadají takto: Období Rok Měsíc Týden Den Jméno souboru Ryyyy_JmenoArchivu.přípona Myyyy_mm_JmenoArchivu.přípona Tyyyy_tt_JmenoArchivu.přípona Dyyyy_mm_dd_JmenoArchivu.přípona Použité zkratky: yyyy - rok mm měsíc dd den tt - týden JmenoArchivu jméno archivu zadané uživatelem Přípona přípona vytvářená podle formátu souboru (MDB,XLS,TXT) Příklad pojmenování souboru: D2002_01_15_Archiv1.XLS Jedná se o denní archiv z 15. ledna 2002. Jméno archivu je Archiv1. Snaparc stahování archivů z řídicích stanic 12
6. Průběh stahování Stahování se odstartuje tlačítkem Začít stahovat. Po úspěšné inicializaci se objeví okno zobrazující průběh stahování. V tomto okně se vypisují informace o právě stahovaných vzorcích. Stahování lze předčasně ukončit tlačítkem Zastavit. Pokud při inicializaci nějakého archivu dojde k chybě, nezačnou se archivy vůbec stahovat. Tedy ani ty správně zadané. Pokud se vyskytne chyba při stahování archivu a ukládání archivního vzorku do databáze, je číslo chyby a popis chyby zobrazen u příslušného archivu v položce Archivní soubor. Stanice musí mít přepnutý SW DIP 9 (označený jako APLIC) do polohy ON. Tedy musí běžet aplikace. Snaparc stahování archivů z řídicích stanic 13
7. Formáty archivních souborů Program podporuje formáty kancelářských programů Office2000. Podporuje také ale univerzální textový formát. 7.1. Formát Access Pro vytváření souborů Access je použit formát Access. Archivní vzorky se ukládají do tabulky, jejíž název se shoduje s názvem archivu. Při zakládání nového archivu se zakládá vždy nový soubor *.MDB (nikoli tedy další tabulka). 7.2. Formát Excel Při použití tohoto formátu je nutné mít nainstalovaný program Excel na počítači, kde probíhá stahování vzorků. Archivní vzorky se ukládají do listu, který se shoduje s názvem archivu. Při zakládání nového archivu se zakládá vždy nový soubor *.XLS (nikoli tedy další list). Poznámka:. Doporučujeme před stahováním v tomto formátu zavřít všechny aplikace Excel a během stahování program Excel nepoužívat. Snaparc stahování archivů z řídicích stanic 14
7.3. Formát Text V tomto případě jsou data formátována do pevných sloupců. Jedná se o univerzální formát, který lze použít i pro následný import do Excelu případně Accessu (pokud používáme starší verze těchto programů). Jak vypadá struktura textového formátu je vidět z přiloženého obrázku.. 7.4. Automatické spouštění Program SnapArc umožňuje zadáním parametru /RUN 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, jakmile jsou všechny zadané archivy stažené. Automatické spouštění (a ukončení) lze s výhodou použít ve spojení s Naplá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. V režimu automatického spouštění stahování archivů dojde při výskytu jakékoli chyby k ukončení programu. Program tak nezůstane viset a nečeká na potvrzení uživatele. Chyba je zapsána do logovacího souboru SNAPARC.LOG. Zadání parametru v dialogu naplánované úlohy bude vypadat potom takto: Snaparc stahování archivů z řídicích stanic 15
Spouštíme s parametrem Program si parametry archivu ukládá do souboru SNAPARC.INI. Pokud si chceme vytvořit více různých archivů, lze soubor SNAPARC.INI přejmenovat a program snaparc.exe spouštět se jménem souboru jako parametrem. Program zahájí automaticky stahování příslušného archivu. V tomto případě je nutné si dát pozor na správné nastavené cesty pro ukládání archivních souborů nesmí být shodné!. Upozornění: Současně může běžet pouze jeden program Snaparc. 7.5. Vypnutí ověřování proměnných Před spuštěním stahování archivu se provádí ověření platnosti proměnných ve stanici. Ověření probíhá tak, že se vyčítají všechny proměnné a porovnávají se za zadanými proměnnými. Tento proces může při velkém množství proměnných ve stanici zdržovat, proto může být přeskočen zadání parametru /F. Příkazová řádka by potom může vypadat takto: Snaparc.exe /F Snaparc.exe /Run /F Snaparc.exe můjarchiv.ini /F Standardně je ověření proměnných zapnuto. Poté co odladíme stahování archivu, můžeme ověření parametrem /F vypnout. Snaparc stahování archivů z řídicích stanic 16