                   EDIREX v.4.xx                     TELEDIN  14.1.2015 - 2020
--------------------------------------------------------------------------------

EDIREX je komunikační klient, umožňující přenos zpráv z a do schránky systému
TELEDIN CCF pomocí šifrovaného protokolu SSL, v automatickém dávkovém provozu.

Program využívá interpret jazyka PERL, obsažený v instalaci.

Pro zprovoznění komunikace je potřeba mít:
------------------------------------------
Zřízenu komunikační schránku v systému TELEDIN CCF na dohodnuté jméno.
Příslušné autorizační klíče vygenerované pracovníky TELEDINu.
Instalační balík EDIREXu  - EDIREX_WIN_XXX.zip.  (XXX-cislo verze)
PC stanici s dnes běžným HW, se systémem Windows. EDIREX je možno instalovat na 
   libovolné, dnes běžné verzi Windows.
 - Při větším předpokládaném provozu je třeba pamatovat na dostatečný prostor na
   disku pro ukládání archivu zpráv, což při dnešních kapacitách disků nebývá
   problém.
 - Ideální je vyhrazený stroj, ale program může dobře pracovat i na běžné
   pracovní stanici společně např. s běžnými kancelářskými aplikacemi. Problémy
   mohou nastat při provozování EDIREXu na stroji, kde již běží jiné komunikační
   aplikace, databáze, nebo systém obsahuje složité prostředí vývojových, 
   komunikačních, případně dalších aplikací.
Program nevyžaduje vytvoření speciálního uživatele pro provozování, ale je
   potřeba zajistit, aby každý uživatel systému, pod kterým bude EDIREX
   spouštěn, měl zajištěné potřebné správné systémové prostředí spolu s 
   dostatečnými právy čtení a zápisu dat do požadovaných míst jak na lokálním
   disku, tak případně v lokální síti uživatele, pokud bude tato funkce
   vyžadována.
   Toto nastavení je na zodpovědnosti uživatele programu EDIREX, při jeho
   nesplnění nemůže firma TELEDIN ručit za spolehlivé doručování zpráv do místa
   určení.
Připojení na Internet s povoleným odchozím portem 22 - konzultujte se správci
   Vaší sítě případné otevření firewallu, nastavení proxy serveru a podobně.
   V některých případech bude nutné i nastavení "Osobního firewallu" na stanici,
   kde poběží EDIREX, tak, aby umožnil EDIREXu odchozí komunikaci na portu 22.
   (IP adresa primárního EDIREX serveru je 212.31.80.228, sekundárního 212.80.77.74)
 UPOZORNĚNÍ - S nástupem modernějších firewallů se začíná objevovat chyba autorizace
   při přístupu na schránku - pokud se Vám objevuje chyba "Spojeni s bisvan.teledin.cz
   bylo navazano, ale autorizace byla neuspesna" a tato chyba přetrvává delší dobu 
   (přes 20 minut) může být problém v nastavení Vašeho firewallu - některé firewally
   kontrolují ceritifikáty a zasahují do nich, a pak se autorizace nezdaří - 
   je potřeba tuto kontrolu pro toto spojení vypnout.

INSTALACE:
----------
Instalace vyžaduje alespoň základní znalosti systému Windows a řádkových
příkazů.
Program se standardně instaluje do direktoráře C:\EDIREX, a dále v textu budeme
jako příklad používat tuto cestu.
Instalace do jiného místa je možná, oproti dřívějším verzím již ani není třeba
upravovat nastavení pro jinou instalační cestu.
Neměla by vadit ani cesta obsahující mezery, ale lepší je se takovýmto názvům
cest vyhnout.

Na disku C: vytvoříme direktorář \EDIREX (případně jiný, podle potřeby), buď
řádkovými příkazy DOSu, nebo např. pomocí EXPLORERu či TOTAL COMMANDERu:
c:\>c:
c:\>mkdir \EDIREX
c:\>cd \EDIREX

Instalační balík EDIREX_WIN_XXX.zip rozbalíme do direktoráře C:\EDIREX.

Po rozbalení by měl direktorář C:\EDIREX obsahovat direktoráře 
INARCHIV,OUTARCHIV,ERROR,Inbound,log,OUTBOUND,Perl,tmp, a soubory
EDIREX1.pm a další.

Nyní již můžeme provést první zkušební spuštění programu EDIREX a otestování
funkčnosti připojení spuštěním příkazu "test.bat", nacházejícím se v adresáři
C:\EDIREX:

Program se připojí na testovací schránku systému TELEDIN CCF, použije jméno 
uživatele TESTUSER a příslušný autorizační klíč testuser_rsa, který je součástí
instalace EDIREXu.

Při úspěšném připojení se musí objevit výpis v černém DOSovém okně:

*********************************************
*     EDIREX       ver.V.4.01 12.5.2008 FN
*     TELEDIN      tel: ++420 221015250
*********************************************
* 20080512-09:19:33 ! TEST: Program EDIREX se pripoji na testovaci schranku !!!
* 20080512-09:19:33 - Start akce PRIJEM SOUBORU ZE SCHRANKY CCF.
* 20080512-09:19:33 - Oteviram spojeni pro testuser@svediptelcomm02.editel.cz ...
* 20080512-09:19:34 -- Spojeni je uspesne navazano.
* 20080512-09:19:34 --- Prohlizim schranku ...
* 20080512-09:19:34 ---- No Data on VANCCFS
* 20080512-09:19:34 - Start akce ODESLANI SOUBORU DO SCHRANKY CCF.
* 20080512-09:19:35 - Zadna data k odeslani.
* 20080512-09:19:35 -- Uzaviram spojeni.
* 20080512-09:19:35 **** End of session *****
Pokračujte stisknutím libovolné klávesy...


Pokud po řádku "Oteviram spojeni..." program delší dobu "visí" a následně
vypíše:

* 20070816-11:10:43 ! Nepodarilo se pripojit na server, proverte funkcnost site.

je problém v nefunkčnosti komunikace - nejpravděpodobněji bývá problém v
nastavení podnikového firewallu. Požádejte Vašeho spráce sítě o prověření 
funkčnosti sítě a o dostupnosti Internetu ze stanice, na které je EDIREX
spouštěn, na portu 22.

Po instalaci EDIREXu je možno spuštěním scriptu ikony.bat vytvořit na ploše ikony
pro manuální spouštění EDIREXu. (Není zaručeno, že se podaří na všech systémech a
jazykových verzích)

ZÁKLADNÍ NUTNÉ NASTAVENÍ:
-------------------------
Po úspěšném testu připojení na testovací schránku CCF je ještě potřeba nastavit
EDIREX pro přístup do Vaší provozní schránky systému TELEDIN CCF:

Do adresáře C:\EDIREX je potřeba vložit autorizační klíč (soubor id_rsa),
který obdržíte od TELEDINu. 
POZOR!: Jméno souboru klíče MUSÍ být ve zde uvedeném tvaru, při zaslání souboru
se jménem "id_rsa" (bez přípony) některé e-mailové servery jméno bez přípony mohou
změnit např na id_rsa.dat. Zkontrolujte prosím, zda nedošlo k tomuto problému.
Přístupová práva klíčů nesmí obsahovat žádná práva pro uživatele "everyone"!

V souboru C:\EDIREX\EDIREX.cfg je potřeba nastavit položku "edirex_user" na
jméno příslušející k Vaší schránce v systému TELEDIN CCF, například:

edirex_user=uzivatel25

V případě potřeby je možno pomocí parametrů v EDIREX.cfg také nastavit komunikaci
prostřednictvím proxy serveru - zapnout parametrem proxy=y, význam dalších
parametrů je zřejmý.

V této chvíli by již mělo být možné připojení na Vaši provozní schránku,
komunikaci prověřte spuštěním příkazu edirexio.bat, který se připojí k
Vaší schránce:

C:\edirex>edirexio.bat

Pokud se objeví hlášení "! Serveru bylo dosazeno, ale autorizace byla
neuspesna." máte pravděpodobně nesprávné autorizační klíče, nebo jste špatně
zapsali jméno uživatele schránky.
Pokud je jméno zadáno správně, kontaktujte firmu TELEDIN pro sjednání nápravy.
NOVĚ!: Problém s autorizací může způsobovat novější firewall - některé firewally
zasahují do přenášených klíčů a pak se autorizace nezdaří, je potřeba na firewallu
tuto kontrolu pro toto spojení vypnout.
Případné další problémy v činnosti programu EDIREX by měly být zřejmé z
vypisovaných hlášení, pokud se Vám nedaří chyby odstranit, kontaktujte firmu
TELEDIN.

Vstup a výstup dat:
-------------------
Cílový adresář, kam mají být přijatá data umístěna je možno nastavit podle
potřeby v konfiguračním souboru EDIREX.cfg, položce edirex_inbound=
(Defaultně C:\EDIREX\INBOUND)
např.:
edirex_inbound=J:\SAP\vstup

Jak bylo uvedeno výše, v tomto adresáři funguje možnost "zamykání" souborů při
kopírování do cíle, pomocí vloženého adresáře "temp".
! Za dostupnost cílového adresáře odpovídá uživatel EDIREXu.!
! EDIREX indikuje úspěšnost zapsání dat do cílové složky ve svém logu audit.log.
! Při neúspěšném pokusu o přenos dat do cílového adresáře data zůstávají v
! adresáři c:\EDIREX\tmp\in a při každém spuštění se je EDIREX snaží přenést do
! adresáře uvedeného v parametru edirex_inbound, dokud se akce nezdaří.
Přijatá data EDIREX archivuje v C:\EDIREX\INARCHIV.

Adresář, odkud se odebírají data k odeslání, je možno změnit pomocí položky 
edirex_outbound= (Defaultně C:\edirex\outbound)
např.:
edirex_outbound=J:\SAP\vystup
!POZOR!: Z toho adresáře se defaultně odešlou pouze soubory podle wilcard "*.*"
! - tedy jméno MUSÍ obsahovat tečku. Pokud chceme, aby se odeslaly i soubory
! bez tečky, musíme nastavit parametr: Wildcards=*

! Za dostupnost zdrojového adresáře dat odpovídá uživatel EDIREXu. EDIREX
! oznamuje nenalezení zdrojové složky v logu, ale nemůže zdetekovat, zda jsou
! například data díky závadě v síti zdrojovou aplikací dat kopírována do jiného
! místa než kde je očekává, případně zda například kvůli nedostatečným právům
! nemohl načíst seznam odesílaných souborů ve zdrojové složce.

DIAGNOSTIKA:
------------
Veškerá činnost programu EDIREX se zaznamenává včetně času do souboru
C:\EDIREX\log\audit.log.
V případě chyby se vytváří soubor C:\EDIREX\log\error.log - lze použít pro
automatickou detekci chyby z nadřazeného programu.
Pro získání podrobnějších výpisů činnosti programu je možno v souboru EDIREX.cfg
nastavit položku edirex_biolit=0 na hodnoty 1 nebo 2.
! Pro zajištění spolehlivého doručování zpráv je velmi vhodné občas prohlédnout
! konec souboru C:\EDIREX\log\audit.log, zda se zde vyskytují výpisy o úspěšném
! navázání spojení, případně se objevuje nějaký problém.
Poznámka: Ojedinělé hlášení problému s navázáním spojení není fatální chybou,
pokud je následný pokus např. po 10 minutách již úspěšný. Krátký výpadek může
nastat kvůli údržbě komunikačního serveru.
Pokud neúspěšnost přihlášení přetrvává delší dobu - např. hodinu, zkontrolujte
funkčnost vaší sítě, případně kontaktujte firmu TELEDIN.

Dále jsou v direktoráři c:\EDIREX\log vytvářeny soubory inmsg.log a outmsg.log,
do nichž se zapisuje přehled přijatých a odeslaných souborů i s uvedením
času jejich přijetí nebo odeslání.

AUTOMATICKÉ SLEDOVÁNÍ ČINNOSTI:
-------------------------------
Pro automatické sledování správné činnosti EDIREXu je možno využít příznak
EdirexLastConn.txt, který EDIREX obnoví po každém úspěšném přihlášení na schránku.
Adresář, kam je tento příznak zapisován je možno nastavit v konfiguraci EDIREX.cfg
Pokud používáte software pro sledování činnosti provozních systémů, můžete kontrolou
stáří tohoto příznaku detekovat, zda EDIREX "žije", případně že došlo k nějakému
problému ve správné funkci EDIREXu, ať již z jakéhokoliv důvodu.
Dalším užitečným příznakem činnosti EDIREXu je příznak EdirexLastDownload.txt,
který je EDIREXem obnoven po každém úspěšném stažení souboru ze schránky, jehož
sledováním opět můžeme vyvolat poplach v případě, že v daném termínu nedorazila
očekávaná data. Podrobněji lze tato data sledovat pomocí listingu stažených souborů,
pokud například potřebujeme zjistit, zda přišla data určitého jména.
Tyto výpisy jsou zapisovány do souborů C:\EDIREX\log\inmsg.log a outmsg.log.

Provozní informace:
-------------------
Z důvodu potřeby zajištění stálé bezchybné funkčnosti služby EDIREX se provádí
na našem serveru jednou denně restart této služby v čase 23:17 hod.
Restart trvá asi 20 sekund a při pokusu o přihlášení v okamžiku restartu EDIREX
nahlásí nezdařený pokus o přihlášení - toto není zásadní chyba - viz DIAGNOSTIKA.
Pokud spouštíte EDIREX automaticky, zamezte, pokud je to možné přihlašování v
této době, aby EDIREX negeneroval zbytečně hlášení o chybě připojení.

PROVOZ:
-------
Program je potřeba spouštět pomocí dávkových příkazů:

edirexin.bat - pouze stáhne data z příslušné schránky
edirexout.bat - pouze odešle data do příslušné schránky.
edirexio.bat - stáhne i odešle data z a do schránky, během jednoho přihlášení.

Při volání dávkových souborů nemusí být aktuální adresář nastaven na domovský
adresář EDIREXu. 

Program se po spuštění přihlásí do Vaší příslušné schránky v systému TELEDIN CCF
a stáhne z ní na lokální počítač defaultně do direktoráře C:\EDIREX\INBOUND
soubory čekající ve schránce. Úspěšnost či neúspěšnost vložení dat do INBOUND je
zaznamenána v logu audit.log.
(Data jsou ve skutečnosti nejprve stahována do složky C:\EDIREX\tmp\in a teprve po
stažení přesunuta do adresáře zadaného v položce "edirex_inbound="
v konfiguračním souboru EDIREX.cfg.)

!POZOR!:
! Není zde použita funkce MOVE ale COPY, protože může být požadováno, aby data
! byla ukládána na síťový disk, kde se pak MOVE chová stejně jako COPY. Pro
! zajištění bezproblémového předávání dat do následující aplikace je zvolena
! tato funkce: pokud je v cílovém adresáři (edirex_inbound=) nalezena složka
! "temp", je datový soubor nejprve zkopírován sem a následně se provede MOVE do
! cílového adresáře. Takto se funkce MOVE chová požadovaným způsobem i na
! síťovém disku. (Pak se již aplikace odebírající data od EDIREXu nemusí
! obávat, že otevře soubor, který ještě není kompletní. - vhodné pro automatické
! předávání dat)
! Pokud zde složka "temp" není, je provedeno pouze COPY do cílové složky. - Pak
! musí kompletnost dat ohlídat obsluha - např. ručním spuštěním následné
! aplikace až ve chvíli, kdy má jistotu, že data jsou již kompletní - týká se
! datových souborů větší velikosti - od desítek, či spíše stovek KB a více.
! Závisí také na rychlosti přesunu dat na lokální síti.
! Pozn.: Informaci o tom, zda byl soubor přesunut pomocí funkce MOVE nebo COPY 
! je možno zjistit v logu.

Pokud EDIREX nalezne ve složce C:\EDIREX\OUTBOUND nějaká data k odeslání, odešle
je do schránky.
Všechny přijaté soubory EDIREX současně archivuje ve složce C:\EDIREX\INARCHIV.
Všechny odeslané soubory EDIREX archivuje ve složce C:\EDIREX\OUTARCHIV.

Způsob provozování komunikátoru EDIREX závisí na předpokládané četnosti
přicházejících a odcházejících zpráv a době, za jakou musí daná zpráva dorazit
do cíle.

Pokud počítáme pouze s několika zprávami denně, u nichž současně není kritická
rychlost doručení, stačí, když EDIREX spustíme několikrát za den ručně.

Pokud předpokládáme větší provoz zpráv, u nichž je důležitá i doba doručení, je
nejlepší nechat program EDIREX spouštět automaticky v zadaných intervalech
pomocí časovače - např. WINCRON, AT a podobně. Za nejkratší rozumný interval
považujeme asi 15 minut, kratší intervaly způsobují kromně neúměrného zvyšování
zátěže serveru také narůstání objemů log souborů jak na straně našeho serveru,
tak na straně zákazníka, ve kterých se pak obtížněji hledají potřebné informace.
Pouze pokud je pro Vás při doručení zprávy důležitá "každá minuta", můžete
použít i kratší interval.

! Je ovšem NADÁLE NUTNÉ kontrolovat činnost EDIREXu, čím je doručení zpráv
! časově kritičtější, tím častěji!
Pokud zprávy skutečně přicházejí v očekávaných dobách, máme potvrzenu správnou
činnost EDIREXu, ovšem jestliže například nepřišla data v očekávanou dobu,
případně máme podezření na jiné okolnosti, které by mohly způsobit nefunkčnost
komunikace nebo stanice, na které běží EDIREX, je dobré správnou funkci EDIREXu
zkontrolovat prohlédnutím souboru C:\EDIREX\log\audit.log
Zdržení dat může být samozřejmně zapřičiněno mnoha dalšími faktory po celé cestě
zprávy.

ÚDRŽBA:
-------
Je vhodné - zvláště při intenzívním provozu kontrolovat obsah archivních
direktorářů INARCHIV a OUTARCHIV a případně odmazávat starší soubory, pokud máme
jistotu, že je již nepotřebujeme a zabíraly by místo na disku.
Dále je dobré kontrolovat délku logového souboru, neměla by přesahovat velikost
několika MB, pokud máme jistotu, že log nebudeme potřebovat (komunikace chodí,
nebudeme např. dohledávat nějaký starší soubor), můžeme soubor audit.log smazat,
automaticky se založí nový. Pokud bychom chtěli log odmazávat postupně, je možno
to provést tak, že současný audit.log přejmenujeme na audit01.log, následně
vzniklý audit.log po dosažení určité velikosti na audit02.log atd. a tyto
soubory pak můžeme postupně od nejstarších odmazávat.

DALŠÍ NASTAVENÍ:
----------------
Pomocí parametrů v souboru C:\EDIREX\EDIREX.cfg je možno přizpůsobit některé
vlastnosti EDIREXu vašemu prostředí a požadavkům.

Pozn.: Řádky v souboru EDIREX.cfg, začínající # jsou komentáře a jsou
ignorovány. Můžeme je využít například při dočasné změně některého parametru
tak, že celý řádek zkopírujeme, původní zakomentujeme pomocí # a úpravu
provedeme v novém řádku. Návrat k původnímu nastavení provedeme opět změnou
zakomentování nepotřebného řádku.

Jedinečnost jmen:
-----------------
U odesílaných souborů je NUTNÉ z hlediska dohledání konkrétního souboru, aby
již systém, který vytváří soubory s daty k odeslání dbal na JEDINEČNOST JMEN
ODESÍLANÝCH SOUBORŮ, alespoň v rámci jednoho dne, ale raději déle.
Pokud nemůžete tuto jednoznačnost zajistit, je možno použít parametru
UnikatniJmena=1, kdy sám EDIREX doplněním časového údaje ke jménu
souboru zajistí jedinečnost jmen. Časový údaj je doplněn za první část jména
souboru před první tečkou ve jméně. Příklad:

jmeno.bbb.edi -> jmeno071031142458468.bbb.edi

Pokud je jednoznačnost jmen souborů zajištěna, je vhodnější nastavením
UnikatniJmena=0 vypnout úpravu jmen souborů.
!POZOR! - zapnutí této funkce konzultujte prosím s pracovníky firmy TELEDIN,
zpracování zpráv od některých zákazníků používá k identifikaci zpráv právě
jméno souboru, zapnutí funkce  "UnikatniJmena" by mohlo toto zpracování
narušit.
! Tato funkce může zajistit jedinečnost jmen pouze u souborů, které již EDIREX
! převzal od Vašeho systému, neřeší všechny problémy, které by mohly nastat
! v případě použití stejných jmen odesílaných souborů, např. při předávání
! dat EDIREXu (možnost přepsání předchozích dat)
! Proto opět apelujeme na ZAJIŠTĚNÍ JEDINEČNOSTI JMEN ODESÍLANÝCH SOUBORŮ
! Vaším systémem ! - jinak může hrozit ZTRÁTA DAT !

Ve jménech souborů nejsou povoleny MEZERY z důvodu zamezení následných problémů
při zpracování dat na straně zákazníka i providera. EDIREX v případě výskytu
mezery ve jméně dat vydá chybové hlášení a soubor není přenesen. Proto je dobré
mít nastavené zasílání upozornění na chyby - viz následující odstavec.
 
Zasílání upozornění na chyby:
-----------------------------
EDIREX umožňuje zasílat upozornění na chyby jak pomocí e-mailu, tak pomocí
windows messaging systému (vyskakovací pop-up okno se zprávou). Zaslání zprávy
pomocí windows messaging vyžaduje, aby na cílovém počítači běžela služba
"Messenger" ( V českých Windows pod názvem "Kurýrní služba" ).


Parametry pro zasílání info a chyb e-mailem v EDIREX.cfg (Od verze 3.3):
-------------------------------------------------------------------------
SendErrorEmail=1 - povolení zasílání e-mailu o chybách (0=neposílat)
SMTP_server=adresa[:port]  - e-mailový server, přes který jsou zprávy zasílány
                             napr: 10.1.1.5  nebo s uvedením portu:  212.78.14.6:77
                           - MUSÍ být nastaveno, jinak nelze zprávy odeslat.
                           - Pomocí dalších parametrů (viz cfg soubor) lze nastavit
                             i autorizaci u severů, které to požadují.
                           - při použití šifrované komunikace (např port 465) musí
                              být nastaveny i autorizační údaje pro přihlášení na 
                              SMTP server - Email_authid= a Email_authpwd=  !!
Email_FROM=EDIREX@teledin.cz  - adresa odesílatele, lze změnit. Nastavte ji prosím
                                na adresu správce Vaší sítě a pod. Dostává odpovědi
                                v pripadě nedoručitelnosti na Email_ERROR_TO...
Email_ERROR_TO=admin@firma.cz  - adresa primárního příjemce zpráv.Je možno zadat
                                 více adres, oddělených čárkami.

Email_auth=LOGIN    - Způsob autorizace na SMTP serveru, povolit, pokud to vyžaduje.
                      Je potřeba zjistit, jaký způsob autorizace Váš server používá.
Email_authid=       - jméno uživatele na SMTP serveru
Email_authpwd=      - heslo uživatele na SMTP serveru

---- Windows messaging: ------------------------------------------
SendErrorPopup=1 - povolení zasílání zpráv pomocí windows messaging (0=neposílat)
PopupComp1=pocitac1 - windowsové jméno počítače, na který je zpráva zaslána
PopupComp2=  - jméno druhého počítače
PopupComp3=  - jméno třetího počítače
-------------------------------------------------------

Zasílání zpráv je možno ověřit pomocí parametru "testmsg" při spuštění programu
EDIREX - např.:
C:\edirex>edirexin.bat testmsg

Program zašle testovací chybovou zprávu podle nastavení v EDIREX.cfg a skončí.

Zasílání informací o přijetí dat:
---------------------------------
Pokud je nastavena e-mailová adresa v parametru:
Email_INFO_TO=
EDIREX zašle na tuto adresu zprávu o přijetí každého nového souboru. Je možno zadat
více adres, oddělených čárkami.
Opět MUSÍ být nastaveno SMTP_server= a případná autorizace na SMTP serveru.

Odesílání jen určitých typů souborů:
------------------------------------
Pomocí parametru "Wildcards" je možno nadefinovat, které typy souborů se mají vybírat
a odesílat z adresáře "edirex_outbound". Definice se provádí zapsáním "wildcardu",
tak jak je běžné ve Windows. Je možno definovat více typů oddělených čárkou.
Nezáleží na velikosti písma. Prázdný parametr znamená "*.*" - tedy že ve jméně musí být
tečka. Pro odeslání úplně všech souborů nastavíme "Wildcards=*".
Příklad:
Wildcards=*.txt,invoic*.*,*.edi

Stahování jen určitých souborů ze schránky:
--------------------------------------------
Při spuštění EDIREXu s parametrem "type" je možno jako další parametr zadat seznam řetězců
oddělených čárkou. Ze schránky pak budou staženy jen ty soubory, jejichž jména obsahují
některý z řetězců v seznamu, s ROZLIŠENÍM VELIKOSTI ZNAKŮ!. Lze použít pro stahování jen
určitých typů zpráv - například stahovat často jeden typ malých souborů a nechat někdy na 
později stažení velkých souborů, nebo například vybírat z jedné schránky data určená pro
různé pobočky - po dohodě s TELEDINEM.
Příklad spuštění:  edirexio type .xml,.edi,ahoj,BEROUN
Pak budou staženy soubory : "zprava.xml" "2ahojte.txt" "dokument.edi.neco" "BEROUN123.xml"
NEbudou staženy soubory: "zprava.doc" "edizprava.txt" "beroun123.xml" "JIHLAVA837.xml"

!POZOR! - Použití této funkce může při nepozornosti vést k "záhadnému" nestahování souborů,
          na které čekáte. Proto ji vždy využijte s rozmyslem a vědomím co děláte!

Mazání Temp adresáře schránky:
------------------------------
Data se do schránky odesílají tak, že se napřed přenášejí do adresáře Temp ve schránce,
a po dokončení přenosu souboru se soubor přesune z Temp do vstupu schránky. Někdy se může
stát, že během přenosu dat dojde k pádu spojení a v Temp zůstane částečně přenesený soubor.
EDIREX se při příštím spojení pokouší nekompletně přenesený soubor přenést znovu, ovšem
pokud v Temp leží soubor stejného jména, EDIREX jej napřed smaže (oznámí v logu "mazu tmp")
a pak začne opětovný přenos. Pokud se jedná o stejná data, není problém, ten by ovšem mohl
nastat, pokud by jste odesílali jiná data v souboru se stejným jménem.
 - proto je NUTNÉ ZAJISTIT JEDINEČNOST JMEN odesílaných souborů, i zdůvodu nebezpečí
   přepsání předchozích dat například v archivech a jinde (viz výše). 
Mazání předchozího souboru stejného jména v Temp lze zakázat pomocí parametru:
Zakaz_mazani_in_temp=1
Pak se ovšem někdy může stát že přenos souboru kvůli kolizi nelze provést a objeví se chyba:
 "ERROR 200 -- Chyba pri SSH presunu souboru na server, mozna kolize se souborem v in/temp.". 
Zprovoznit přenos lze nastavením "Zakaz_mazani_in_temp=0", pokud víte, že předchozí soubor
opravdu chcete smazat, nebo kontaktováním pracovníků firmy TELEDIN a dohodnutím se na
dalším postupu.

DALŠÍ PARAMETRY:
----------------
EDIREX.cfg obsahuje i některé další parametry, jejich použití je ovšem speciálnější,
jejich nastavení je potřeba konzultovat s pracovníky firmy TELEDIN.

TESTOVÁNÍ:
----------
Pro testování připojení a přenosů dat je možno využít již výše zmíněný testovací
režim, který se spustí pomocí parametru "test". V testovacím režimu se EDIREX
připojí na testovací schránku TESTUSER, ze které nejsou data odebírána k dalšímu
zpracování, takže do ní můžete zaslat libovolný soubor, například pro otestování
rychlosti a spolehlivosti přenosové linky a podobně. Jinak je činnost EDIREXu
shodná s provozním režimem.
Schránka funguje tak, že každý soubor, zaslaný do této schránky je do 5 minut od
zaslání přesunut na výstup této schránky, odkud jej můžete stáhnout zpět a díky
tomu můžete otestovat i opačný směr přenosu souborů.
POZOR! Testovací schránka je společná pro všechny uživatele, takže se může stát,
že Vámi zaslaný soubor bude stažen jiným uživatelem a naopak.

PŘECHOD na verzi 2.1 a novější:
-------------------------------
Pro přechod na nové verze stačí rozbalit novou instalaci v původním direktoráři
C:\EDIREX (Pro jistotu je dobré vytvořit si záložní kopii složky C:\EDIREX)
a převést parametry z původního konfiguračního souboru EDIREX2.cfg do EDIREX.cfg.
POZOR!: Jména některých parametrů (hlavně u zasílání e-mailem) byla změněna na
logičtější, proto je potřeba je převést pozorně ručně, pokud je používáme.

Můžeme také smazat celou složku C:\PERL, která již nyní není použita.
EDIREX 2.1 je potřeba volat pomocí nových scriptů edirexin.bat, edirexout.bat
nebo edirexio.bat - !! změnit v software, který volal původní scripty !!
Dále je možno využít nový mechanizmus pro předávání souborů pomocí složky temp -
popsáno výše, pouhým vytvořením složky temp v cílovém adresáři.

Provedení upgrade z verzí 3.XX a 4.XX na vyšší:
-----------------------------------------------
Nejjednodušší a nejspolehlivější postup je:
Přejmenovat stávající adresář EDIREXu c:\EDIREX např. na c:\EDIREX.old.
Ručně vytvořit nový adresář c:\EDIREX. V něm rozbalit zip s novou verzí EDIREXu.
Z původní instalace EDIREXu přenést klíč id_rsa z adresáře c:\EDIREX.old\.ssh
(z verze 4.XX) nebo adresáře c:\EDIREX.old\bin\.ssh (verze 3.XX) do adresáře
c:\EDIREX . 
V souboru c:\EDIREX\EDIREX.cfg upravit položku edirex_user=NOBODY podle nastavení
ve Vašem původním konfiguračním souboru.
Pokud používáte EDIREX ve standardním nastavení, mělo by to být vše a můžete začít
používat novou verzi EDIREXu. Pokud jste měli v původním EDIREXu některá
nestandardní nastavení, nastavte odpovídající položky v novém konfiguračním
souboru c:\EDIREX\EDIREX.cfg podle staré konfigurace v C:\EDIREX.old\EDIREX.cfg.
Dále je možné, že bude potřeba ze staré verze EDIREXU přenést některé přídavné
moduly a adresáře, pokud je používáte. To poznáte podle nastavení ve staré
konfiguraci.

Přesun EDIREXu na jiný počítač:
-------------------------------
Od verze 4.xx stačí zkopírovat adresář c:\EDIREX na nový počítač a EDIREX bude
funkční. Proto doporučujeme když používáte předchozí verze, stáhnout si novou z:
http://download.teledin.cz/edirex/ soubor EDIREX_WIN_XXX.zip, rozbalit na novém
počítači a provést přechod podle předchzího odstavce.
Zamezte prosím současnému spouštění EDIREXu na více počítačích, může to vést k
potížím v komunikaci, zmatku v ukládání zpráv, případně ke ztrátě dat.

HISTORIE VERZÍ:

ZMĚNY v EDIREXu 2.1 oproti starším verzím:
------------------------------------------
- Je kompletně přepracován pro zvýšení spolehlivosti funkce, pohodlnější
  instalaci a zlepšení diagnostiky činnosti programu.
- Není již nutno pro spouštění EDIREXu vytvářet a používat speciálního uživatele.
- Používá pouze jeden konfigurační soubor EDIREX.cfg místo
  EDIREX1.cfg a EDIREX2.cfg.
- Používá místo jednoho společného archivu ARCHIV dva archivy -
  INARCHIV a OUTARCHIV pro oddělené ukládání příchozích a odchozích zpráv.
- Je zmenšena instalační velikost programu odstraněním nepotřebných knihoven
  v interpretu Perlu.
- Umožňuje testovací připojení na schránku TESTUSER pomocí parametru test
- zajišťuje integritu předávaných dat díky pomocnému direktoráři temp
- Umožňuje zajistit jedinečnost jmen odesílaných souborů

EDIREX v. 3.3:
-----------------
- ! Změna názvu parametrů zasílání zpráv v EDIREX.cfg ! viz výše.
- Kromě audit.log vytváří speciální logy inmsg.log a outmsg.log se seznamy
  přijatých a odeslaných souborů. Vypisované informace se budou v budoucnu
  rozšiřovat - příprava pro předávání dat do budoucí GUI aplikace umožňující
  komfortně zobrazovat přehled přijatých a odeslaných souborů.
- Zasílá e-mailem informaci o přijetí dat.
- Upravena funkce "unikátní jména" tak, aby časový údaj nebyl přidáván na
  začátek jména ale na konec první části jména.
- Balík EDIREXu již obsahuje soubor "known_hosts", takže nevyžaduje při
  prvním spuštění zadat "yes".
- Další drobná vylepšení funkce.

EDIREX v. 3.32:
-----------------
- Opraveno přesunutí vstupního souboru do outarchiv v EDI režimu
- Změněn název parametru edirex_out na edirex_out_dir - pozor při přenosu cfg souboru do vyšší verze!

EDIREX v. 3.34:
-----------------
- V módu IO se EDIREX nepokouší připojit dvakrát, pokud se první připojení nezdařilo,
  posílá také jen jeden chybový e-mail.

EDIREX v. 3.35:
-----------------
- Vnitřní úpravy
- Opraveno - pokud se ve vstupním souboru objevily některé řídící znaky (např. \1A),
  kopírování souboru se na tomto znaku zastavilo. Nyní speciální znaky nedělají problém.
- Opravena chyba při zasílání popup zpráv.

EDIREX v. 3.36, 3.37:
-----------------
- Upravena práce s přídavným modulem ZpracujIn
- Přizpůsobení pro přenositelnost na UNIX

EDIREX v. 3.38:
---------------
- Je možno pomocí wildcards nastavit, které soubory budou z "edirex_outbound" vybrány a odeslány.

EDIREX v. 3.39:
---------------
- Změněn způsob chování EDIREXu při zápisu do vstupního adresáře "edirex_inbound":
  Doposud byla v případě neúspěšného pokusu o zápis přijatých dat do adresáře "edirex_outbound" data
  přesunuta do "Inarchiv" a dále se EDIREX nepokoušel data na vstup zapsat, pouze provedl záznam o 
  neúspěšnosti zápisu do auditlogu.
  Nyní data po neúspěšném pokusu o zápis do "edirex_outbound" zůstávají v adresáři "edirex_in_dir" a při
  každém spuštění se EDIREX pokusí data přesunout znovu. Opět je v případě neúspěšnosti proveden zápis do
  auditlogu a vysláno e-mail a pop-up varování. Až teprve v případě úspěšného přesunu dat jsou data také
  uložena do "Inarchiv" a je proveden zápis o úspěšném přesunu dat do "edirex_outbound".
  (Jedná se o situaci, že cílový adresář sice existuje, ale stejně do něj není možno zapsat, např. z důvodu
  zaplnění filesystému, špatných práv a pod.
  Pokud vstupní a výstupní adresáře ("edirex_inbound" a "edirex_outbound") neexistují (např. nepřipojený
  síťový disk), EDIREX kontroluje tuto skutečnost hned na začátku spuštění a vydá o ní zprávu (pop-up a
  e-mail, pokud jsou nastaveny) a skončí bez provádění jakékoliv další činnosti.)
- Otočen význam návratového kódu pro CONTRL - 0=OK, ne0=kód chyby

EDIREX v. 4.01:
---------------
- Pro SSL komunikaci použity jiné knihovny, již není potřeba prostředí CYGWIN, pracuje i na WIN2008 server.
- Zjednodušena instalace - stačí jen rozbalit instalaci, vložit přístupový klíč, nastavit jméno uživatele
  v konfiguraci a program je funkční.

EDIREX v. 4.02:
---------------
- Vylepšena spolupráce s SFTP procesem.
- Menší úpravy výpisu logu během stahování dat.(Výpis OK)

EDIREX v. 4.03:
---------------
- Upraven zápis do společného souboru v módu E - při nezdařeném pokusu o otevření společného souboru
  zůstanou zprávy v edirex_in.
- Doladěn binmode v NactiCtrlHlavicku.
- Odchozí i příchozí soubory testuje na EDIFACT, získané údaje zapisuje do inmsg.log a outmsg.log
- Malé úpravy u zpracování Wildcards (umožní odeslat i *)

EDIREX v. 4.04:
---------------
- Úprava generování služebních dat.

EDIREX v. 4.05:
---------------
- V případě, že je při odesílání ve schránce v in/Temp adresáři soubor stejného jména, je smazán a přepsán
  novým souborem. (Lze zakázat parametrem "Zakaz_mazani_in_temp=1" v EDIREX.cfg)
- V případě, že je při stahování v out/Archiv soubor stejného jména, je ke jménu nového souboru přidán čas,
  a takto přesunut do archivu. V logu je tato událost zaznamenána hláškou:
  "V remote archivu je soubor stejneho jmena, archivuji jako ..."

EDIREX v. 4.06:
---------------
- Upraveno chování EDIREXu při odesílání - v BINARY módu jsou odesílané soubory smazány z OUTBOUND až v případě
  úspěšného odeslání, jinak zde zůstávají.
  - Funguje POUZE v BINARY módu a při nepoužívání funkce "unikátní jména"!

EDIREX v. 4.07:
---------------
- Upraven příjem souborů vyžadujících odeslání potvrzení. Pokud by došlo k pádu programu před odesláním potvrzení,
  soubor i s hlavičkou je uchován v tmp a při příštím spuštění zpracován.
- Je umožněno přepsání souboru v inbound příchozím souborem stejného jména, lze zakázat parametrem Zakaz_prepis_inbound=1

EDIREX v. 4.08:
---------------
- Přidána možnost volání externího modulu před odesláním dat - parametr PreSendCall.

EDIREX v. 4.09:
---------------
- Přidána možnost autorizace na SMTP serveru pro odesílání chybových a info zpráv, pokud je vyžadována.
- POZOR! - v EDIREX.cfg změněn název některých parametrů, při upgrade je potřeba ručně nastavit v novém .cfg:
    SendInfoEmail -> Email_INFO_TO
    Email_TO -> Email_ERROR_TO
- Byly vypuštěny parametry Email_CC a Email_BCC , zprávy na více příjemců lze zaslat zadáním více adres
  oddělených čárkami.

EDIREX v. 4.10:
---------------
- Úpravy související s problémovými jmény souborů (je zakázána mezera ve jméně odesílaných i přijímaných souborů
  z důvodu zamezení vzniku následných problémů při zpracování dat na straně klienta i providera)
  V případě výskytu mezery ve jméně přijímaného nebo odesílaného souboru je odesláno chybové hlášení a soubor
  je ignorován.
  - Výskyt takovéhoto souboru nezablokuje přenos ostatních souborů se správnými jmény.

EDIREX v. 4.11:
---------------
- Přidána možnost zadání stažení jen určitých souborů ze schránky pomocí parametru "type".

EDIREX v. 4.12:
---------------
- Přidána možnost připojení na alternativní adresu serveru, pokud selže připojení na primární adresu.
- Přístupový privátní klíč id_rsa se nově ukládá přímo do kořenového adresáře EDIREXu, tedy obvykle do
  c:\EDIREX. Je zachována kompatibilita i s původním umístěním v c:\EDIREX/.ssh.

EDIREX v. 4.13:
---------------
- opravena chyba odesílání doručenek v edirex_edi_type=E modu.

EDIREX v. 4.14:
---------------
- Doplněno vytváření error.log.

EDIREX v. 4.15:
---------------
- Upraveno chování při odesílání .ctr souborů.

EDIREX v. 4.16:
---------------
- (Windows) Přidána kontrola duplicity běhu EDIREXu pomocí mutex.

EDIREX v. 4.17:
---------------
- Vnitřní úpravy

EDIREX v. 4.18:
---------------
- (Windows) Kontrola volného místa na disku - EDIREX se nespustí, pokud nemá alespoň 2MB volného místa na disku, kde je nainstalován.
- (Windows) Umí ukončit případné předcházející neukončené běhy programu, lze zakázat - parametr Kill_old
  - Kill_old=1 - killne předchozí běh EDIREXu a pokračuje.  Kill_old=0 - nechá předchozí běh a ukončí se.

EDIREX v. 4.19:
---------------
- Pomocné adresáře in a out přesunuty pod tmp, aby nemátly uživatele.
- Přidána možnost nastavení portu pro komunikaci se SMTP serverem.

EDIREX v. 4.20:
---------------
- Upraveno chování - vyhodnocení chyb, logy a varovné e-maily, při připojení na druhý server.

EDIREX v. 4.21:
---------------
- Upravena kontrola duplicitních jmen souborů při stahování. ZakazPrepis=1

EDIREX v. 4.22:
---------------
- Opravena chyba při zjišťování volného místa na disku

EDIREX v. 4.23:
---------------
- Zamezení přenesení potenciálně nekompletního souboru při chybě spojení ve specifické situaci.

EDIREX v. 4.24:
---------------
- Pokud ve služebním adresáři out čekají potvrzenky doručení, jsou odeslány i při spuštění EDIREXu v in režimu.
- Přidáno vypisování do logu informace o módu spuštění.
- Přidáno vypisování do logu čísla průvodky při vytváření doručenky.

EDIREX v. 4.25:
---------------
- Přidána možnost komunikace přes proxy server.
  - zapnout v EDIREX.cfg parametrem proxy=y
  - nastavit další potřebné parametry pro proxy - zřejmé z konfigurace.

EDIREX v. 4.26:
---------------
- Změna chování - EDIREX pokračuje v příjmu i odesílání zpráv i v případě výskytu chyb, původně ukončil činnost
  při výskytu první chyby.
  - Lze ovlivnit nastavením parametrů StopOnInError a StopOnOutError.

EDIREX v. 4.27:
---------------
- Přidáno opakování pokusu o připojení na server - parametry:
  NumRetryConn=4  - defaultně 4 opakování pokusu o připojení.  (0=při neúspěšném pokusu spojení neopakuje)
  DelayRetryConn=3  - defaultně 3 minuty mezi pokusy o připojení.
  Při nastavování těchto parametrů dejte pozor, aby maximální doba opakování připojení nekolidovala 
  s příštím spuštěním Edirexu pomocí časovače.
- EDIREX po úšpěšném připojení zapíše příznak - soubor EdirexLastConn.txt
  do adresáře určeného parametrem EdirexLastConn=
- EDIREX po úšpěšném stažení souboru zapíše příznak - soubor EdirexLastDownload.txt
  do stejného adresáře jako minulý příznak. (EdirexLastConn=)
  - lze použít pro sledování, kdy naposledy přišla nějaká data.
  - Pro podobný účel lze použít i čas souboru inmsg.log v c:\Edirex\log. (Pro odchozí data - outmsg.log)

EDIREX v. 4.28:
---------------
- Změna zjištění volného místa pomocí příkazu dir.
  - Přidáno C:\WINDOWS\system32 do path= v .bat souborech

EDIREX v. 4.29:
---------------
- Změna možností konfigurace pracovních adresářů Edirexu.
  - Při instalaci do jiného než standardního adresáře c:\EDIREX je nyní potřeba nastavit domovský adresář Edirexu
    již jen změnou jediného parametru EDIREX_HOME v souboru EDIREX_HOME.bat
  - V EDIREX.cfg v definicích cest k adresářům je možno použít parametr $EDIREX_HOME
- Při vymazání adresářů tmp a archivů si Edirex sám zkusí vytvořit nové.
- Při nenalezení předefinovaných cest k tmp a archivům Edirex použije standardní adresáře, pokud to jde.

EDIREX v. 4.30:
---------------
- Odstraněna potřeba nastavovat domovský adresář EDIREXu.
  - Parametr EDIREX_HOME se nastaví automaticky podle umístění příslušného spuštěného .bat souboru
     (test.bat, edirexio.bat ... atd.)

EDIREX v. 4.30_2:
-----------------
- Úprava zjišťování volného místa na disku (CZ + EN)
- Oprava hlášení chyby v exec_send.

EDIREX v. 4.30_3:
-----------------
- Přidáno hlášení o nezdařeném mazání odeslaného souboru z tmp\out (kvůli duplicitním .ctr) v exec_send.

EDIREX v. 4.30_4:
-----------------
- Přidán parametr TestovatMisto= v EDIREX.cfg, umožňující vypnout testování místa (=0)

EDIREX v. 4.31:
---------------
- Pokud se Edirexu nezdaří vzdáleně přesunout stažený soubor na serveru z OUT do OUT/Archive, smaže i příslušný stažený soubor v tmp/in
   - například při pádu spojení - kvůli zamezení duplicit dat, soubor bude stažen při dalším připojení

EDIREX v. 4.32:
---------------
- Přidáno přesunutí odeslaného souboru do tmp/out/sent, pokud se nepodaří kopie do Archivu. (Kvůli zamezení duplicitního zasílání zpráv a potvrzenek.)
  Zprávy jsou ze sent přesunuty do Archivu ve chvíli, kdy je to opět možné.

EDIREX v. 4.33:
---------------
- umožňuje i odesílání e-mailů šifrovanou komunikací (např nastavením portu 465 pro SMTP server)
  Při použití šifrované komunikace musí být nastaveny autorizační parametry Email_authid= a Email_authpwd=

EDIREX v. 4.33:
---------------
- Přidána hláška do logu o kopírování souboru z Outbound do Out

EDIREX v. 5.0:
--------------
- Použit nový Bitvise client 9.33, kvůli použití nových šifer pro komunikaci.

EDIREX v. 5.1:
--------------
- Použita nová verze programu mailsend-go pro odesílání emailů.
