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. 3.2.
Spuštění instalace Odinstalování
6 6
4.
Spuštění programu
7
4.1. 4.1.1. 4.1.2. 4.2. 4.2.1. 4.2.2. 4.2.3. 4.2.4. 4.2.5. 4.2.6. 4.2.7. 4.2.8.
Nastavení parametrů komunikační linky Sériová komunikační linka Ethernet Nastavení parametrů stahovaného archivu Název archivu Adresa stanice Typ souborů Cesta Typ archivu WID – Index, Cas, Data Názvy sloupců Formáty čísel
7 7 8 8 8 8 8 9 9 9 10 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. 7.2. 7.3. 7.4. 7.5.
Formát „Access“ Formát „Excel“ Formát „Text“ Automatické spouštění Vypnutí ověřování proměnných
14 14 15 15 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.
3.1.
Instalace
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. 4.2.1.
Nastavení parametrů stahovaného archivu 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í
Jméno souboru
Rok
Ryyyy_JmenoArchivu.přípona
Měsíc
Myyyy_mm_JmenoArchivu.přípona
Týden
Tyyyy_tt_JmenoArchivu.přípona
Den
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