Java-s Nyomtatványkitöltő Program Súgó

Telepítési útmutató

Hardver és szoftver követelmények

A java-s nyomtatványkitöltő program az alábbi hardverigényt támasztja a számítógéppel szemben:

A program minden olyan operációs rendszeren működik, amire telepíthető a Java futtatási környezet, (JRE), 1.6 verziója.

A program tesztelése a következő operációs rendszereken történt:

Microsoft Windows:

Unix alapú rendszerek:

A program futtatásához a Java futtatási környezet (JRE) 1.6 verziója szükséges. A java.sun.com helyről letölthető.

Telepítés

Háromféle telepítő csomag létezik

  1. A keretrendszer/program telepítését végző csomag. A neve abevjava_install.jar
  2. A nyomtatványok telepítését végző csomagok. A csomag nevében szerepel a nyomtatvány azonosítója és .jar kiterjesztésű az állomány.
  3. A kitöltési útmutatók telepítését végző csomagok. A csomag nevében szerepel a nyomtatvány azonosítója és .jar kiterjesztésű az állomány.

A telepítő csomagok mind JAR kiterjesztésű állományok. Ezek a java rendszer számára futtatható programok. Már a telepítés megkezdése előtt fel kell telepíteni a Java futtató környezetet, mert enélkül a telepítő program nem fog működni.

A keretrendszer telepítését kell először elvégezni, utána lehet telepíteni a nyomtatványokat és a kitöltési útmutatókat.

A keretrendszer telepítő programja a következőket végzi:

  1. Feltelepíti a programot a felhasználó által megadott könyvtárba.
  2. Elvégzi a felhasználói beállításokat

Telepítés Microsoft Windows operációs rendszer esetén

A JAR kiterjesztésű telepítő csomagra duplán kattintva az egérrel elindul a telepítés. Amennyiben nem jelenik meg a telepítő program, akkor a JAR állományok futtatása és hozzárendelése a java futtatási környezethez című dokumentáció nyújthat segítséget. (Segítségképpen még letöltheti az abevjava_install.bat állományt. Erre duplán kattintva elindul a telepítő. Ez a segédállomány a közeljövőben meg lesz szüntetve, ezért tanulmányozza az említett dokumentációban foglaltakat)

Ha nem rendszergazdai jogosultságokkal történt a telepítést indítása akkor jelezni fogja a program, hogy az abevjavapath.cfg konfigurációs állományt jogosultságok hiányában nem az alapértelmezett helyen hozza létre. Ettől a telepítés le fog futni és a program működni fog. De csak azzal a felhasználói azonosítóval bejelentkezve lehet használni, amivel telepítve lett a program. Ebben az esetben a frissítéseket is ugyanazzal a felhasználói azonosítóval bejelentkezve kell elvégezni.

Az abevjava_start.bat állományt a telepítés felülírja. Ez az indító program tartalmaz egy hivatkozást az ABEV_JAVA_HOME környezeti változóra. Ha a program hiba nélkül indul akkor ezzel nincs teendő. De ha nem sikerül elindítani, mert nem találja a rendszer a megfelelő verziójú java programot akkor ezt a környezeti változót létre lehet hozni. Ettől kezdve az ABEV_JAVA_HOME helyről fogja indítani a program a java-t.

Windows alatt telepítésre kerül a gen_abevjava_start.vbs program. A telepítési könyvtárban található. Ha nem indul el a java-s nyomtatványkitöltő program akkor ezt le kell lefuttatni (dupla kattintás). Ez egy diagnosztikai program, ami ellenőrzi, hogy van-e megfelelő verziójú java-t a gépen. Ha nem talál akkor kiírja a hibát, ha talál akkor újra generálja az abevjava_start.bat indító programot. Ezután az asztali ikonnal indíthatja a programot. Hálózatos telepítés esetén ezt ne, vagy nagyon körül tekintően használja, mert különböző gépeken különböző helyeken lehet a java.

Telepítés Windows Vista, Windows 7 operációs rendszereknél

A telepítőprogram a v2.8.0-ás verziótól kezdődően a Program Files (illetve általános jogú felhasználó esetén annak virtuális megfelelője) helyett a \Felhasználók\Nyilvános\abevjava (Users\Public\abevjava) könyvtárat ajánlja fel telepítési könyvtárnak. Ezt a könyvtárat minden felhasználó használhatja (létrehozás, módosítás).

A v2.8.0-ás verziótól kezdődően az .xkr kiterjesztés a programhoz történő rendelése is felhasználói szinten történik.

Amennyiben az adott gépen más felhasználói bejelentkezéssel is használni kívánja a programot, akkor futtassa a telepítőt és telepítse ugyanabba a könyvtárba, mint a többi felhasználónál, valamint kérje a felhasználói beállítások elvégzését. Így minden letöltött frissítést minden felhasználó használni tudja.

Technikai információ: A korábbi verziókban az abevjavapath.cfg állomány vagy a \Windows vagy a \Felhasználók\felhasználónév\.abevjava (\Users\felhasználónév\.abevjava) vagy a Felhasználói fiókok felügyeletének bekapcsolása esetén a \Users\felhasználónév\AppData\Local\VirtualStore\Windows könyvtárban jött létre. A v2.8.0-ás verziótól kezdődően a program indulásakor a \Users\felhasználónév\AppData\Local\VirtualStore\Windows könyvtárból az abevjavapath.cfg áthelyezésre kerül a \Users\felhasználónév\.abevjava könyvtárba.

Telepítés unix alapú rendszereknél

A jar kiterjesztésű állományokat a legtöbb unix alapú rendszer archívumnak tekinti, mivel ezek ZIP formátumú állományok. Rákattintva kibontja és megmutatja az archívum tartalmát. A java futtató környezet a bennük található kódot tudja futtatni. A telepítő indítását a Megnyitás mással funkció segítségével kezdeményezheti, a parancssorban a java -jar utasítást megadva.

Ha nem rendszergazdai jogosultságokkal történt a telepítést indítása akkor jelezni fogja a program, hogy az abevjavapath.cfg konfigurációs állományt jogosultságok hiányában nem az alapértelmezett /etc könyvtárban hozza létre. Ettől a telepítés le fog futni és a program működni fog. De csak azzal a felhasználói azonosítóval bejelentkezve lehet használni, amivel telepítve lett a program. Ebben az esetben a frissítéseket is ugyanazzal a felhasználói azonosítóval bejelentkezve kell elvégezni.

Az abevjava_start állományt a telepítés felülírja. Ez az indító program tartalmaz egy hivatkozást az JAVA_HOME_ABEV környezeti változóra. Ha a program hiba nélkül indul akkor ezzel nincs teendő. De ha nem sikerül elindítani, mert nem találja a rendszer a megfelelő verziójú java programot akkor ezt a környezeti változót létre lehet hozni. Ettől kezdve az JAVA_HOME_ABEV helyről fogja indítani a program a java-t.

Telepítés Machintos számítógép esetén

Machintos számítógépek esetén kérjük olvassa el a Telepítés unix alapú rendszereknél szekciót. Ennek megfelelően kell a rendszert telepíteni. A különbség az, hogy a program nem hoz létre indító ikont az Asztalon/Munkasztalon/Desktop-on.

A következőképpen készíthet indító ikont:

A telepítés menete:

    1, Ellenőrizze az Applications-->Utilities-->Java-->Java preferences fülön a következőt

        A Java Applet Plugin és a Java Applications részen is CSAK a Java SE 6 legyen kiválasztva

    2, Ezt követően indítson el egy Terminált (Applications --> Utilities --> Terminal)

        A Terminál ablakba írja be a következőt    " java  -version " majd futtassa a parancsot.
        Ekkor megjeleníti az alapértelmezett Java verziót, ennek az 1, pont után 1.6 nak kell lennie.

    3, Az ÁNYK telepítését megelőzően hozzon létre egy szabadon választott mappát a felhasználóneve alá (Pl.: felhasználonev/abev). Majd az ÁNYK                 telepítése során ezt a könyvtárat tallózza ki.
        (Az ÁNYK telepítője a könyvtárakat alapértelmezetten a  /usr/share útvonalra akarja létrehozni, ilyen útvonal nem szerepel a machintos rendszerben           alapértelmezetten!)
             
    4, A telepítés befejeztével az ÁNYK programot az abevjava.app vagy az abevjava_start állománnyal lehet indítani.
       

Telepítés másolással

Lehetőség van a telepítő futtatása nélkül is telepíteni a programot.

  1. A kiadott .jar kiterjesztésű állományok tömörített ZIP archívumok. Bármilyen program, amelyik ZIP archívumokat ki tud csomagolni, a JAR-t is kezelni tudja.
  2. Mindhárom típusú telepítő csomag – program, nyomtatvány, kitöltési útmutató – tartalmazza az application könyvtárat.
  3. Az application könyvtár tartalmát kell kicsomagolni mindig ugyanarra a helyre. Ebben a könyvtárban nem csak állományok, hanem további könyvtárak is találhatóak. Ezek struktúráját meg kell őrizni.
  4. Létre kell hozni egy parancs állományt a telepítési könyvtárba – ahol az abevjava.jar található - az alábbi tartalommal: java -Xms128M -Xmx256M -jar -DentityExpansionLimit=128000 abevjava.jar cfg=cfg.enyk A program indítását ezzel a parancsállománnyal kell kezdeményezni. E nélkül is elindul a program, de a hiányzó paraméterek bizonyos esetekben hibát okozhatnak.
  5. A telepítési könyvtárban létrejött ico és png állományokat felhasználhatja Képernyő ikon létrehozásához.
  6. A program első indításakor a felhasználó (home) könyvtárában létrehozza a szükséges felhasználó függő könyvtárrendszert és paraméter állományokat. A felhasználó (home) könyvtára az operációs rendszerenként más és más, Microsoft Windows-on belül is vannak különbségek. Kérjük, olvassa el a program könyvtárszerkezetéről szóló leírásokat.
  7. Ha másolással történt a program telepítése és a későbbiekben mégis futtatja a telepítő programot, az nem fogja felismerni, hogy már van telepítve egy példány. A későbbiekben is másolással kell telepíteni, illetve kézzel kell eltávolítani a programot, ha ez szükséges.

Több felhasználó egy gépen

Amennyiben, több felhasználó is használja - más felhasználói azonosítóval – ugyanazt a gépet akkor minden felhasználó esetén le kell futtatni a keretprogram telepítőjét. Az első telepítést rendszergazdai jogosultságokkal kell végezni, a többihez nem szükséges rendszergazdai jogosultság. Az elsőt kivéve a programot nem kell telepíteni, csak a felhasználói beállítások elvégzését kell kérni a telepítőtől, a megfelelő jelölőnégyzetek bejelölésével. Minden felhasználónak külön adatkönyvtár adható meg, és az elektronikus feladás könyvtára is egyedi lehet felhasználónként.

A nyomtatványok és kitöltési útmutatók telepítése, vagy a program frissítése bármelyik rendszergazdai jogosultságokkal rendelkező felhasználói bejelentkezéssel elvégezhető. A többi felhasználó számára is frissülnek az állományok.

Amennyiben módosítani kellene az adat vagy az elektronikus feladás könyvtárát, akkor újra futtatni kell a telepítőt. A felhasználói beállítások elvégzését kérve – a program telepítését nem – módosíthatóak a korábbi beállításokat. A már létrehozott adatállományokat a program nem mozgatja! Azt a felhasználónak egyedileg kell megoldania!

Silent módú telepítés

Lehetőség van a grafikus felület nélküli, parancssoros telepítésre. A program, dokumentáció és nyomtatványtelepítő csomagok, egyaránt futtathatók ezen a módon.


Teendők:

  1. A telepítés előtt létre lehet hozni a felhasználói gépeken a windir környezeti változó által definiált könyvtárban egy abevjavapath.cfg nevű állományt. Az abevjavapath.cfg állománynak tartalmaznia kell az elérési utat ahová a programot telepítésre kerül.
  2. Az állomány tartalma abevjava.path=elérési út pl.: abevjava.path = C:\\Program Files\\APEH\\abevjava
  3. A keretprogramot kell először telepíteni. A ,,-s" kapcsolóval indítható a parancssoros telepítés.
  4. Amennyiben az abevjavapath.cfg állományt nincs létrehozva a telepítés előtt akkor a program az alapértelmezett értékekkel, létrehozza azt.
  5. A program készít egy log file-t az utolsó telepítés eredményéről. Az állományt futtató user home könyvtárában - MS Windows esetén a TMP környezeti változó által mutatott helyen - abevjava_silent_install.log néven jön létre.
  6. A program, a nyomtatványok és a kitöltési útmutatók az abevjavapath.cfg állományban definiált helyre másolódnak. A felhasználói beállítások és az adat könyvtár struktúrája - ha nem létezik - a program indításakor a felhasználó home könyvtárában létrejön.
Kapcsoló Felhasználás Információk Példa
-s Silent módú
futtatás
A telepítő csomagok
parancssorban futnak
grafikus felület nélkül.
java –jar <telepíto.jar> -s

java –jar abevjava_install.jar -s
java –jar APEH_O753.jar -s
java –jar APEH_doc_O753.jar -s