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: (de legalább
annyit amennyit az operációs rendszer megkövetel)
- 400 MHz órajelű vagy gyorsabb processzor
- 128 MB vagy több RAM memória (256 MB javasolt)
- 20 MB szabad merevlemez-kapacitás (A
nyomtatványok
és dokumentációk további
merevlemez-kapacitást igényelnek)
A program minden olyan operációs
rendszeren
működik, amire telepíthető az Oracle által kiadott
Java
futtatási
környezet, (JRE), 1.8 verziója. A java
futtatási környezet aktuális verziója a
java.com helyről letölthető.
Figyelem!
Az ÁNYK a v2.67.0 verziótól csak a Java 1.8 verziójával működik!
A program tesztelése a következő
operációs rendszereken
történt:
Operációs
rendszer |
Tesztelt Java verzió |
Megjegyzés |
Windows |
|
|
Windows XP |
Java 8 |
Microsoft kivezeti a Win XP támogatását 2014. április elejétől.
A Java 8 hivatalosan nem támogatott Win XP-n, de a 1.8.0_60 verzió telepíthető. |
Windows Vista |
Java 8 |
|
Windows 7 |
Java 8 |
|
Windows 8.x |
Java 8 |
ÁNYK nem fut Metro alkalmazásként |
Windows 10 |
Java 8 |
|
Unix alapú rendszerek |
|
|
Ubuntu |
Java 8 |
12.04 LTS |
Mac OS X |
Java 8 |
OS X 10.11 (El Capitan) |
Amennyiben a táblázatban nem szereplő
operációs rendszert használ, ellenőrizze, hogy az
alábbi linken található listában
szerepel-e. (angol nyelvű honlap)
http://www.oracle.com/technetwork/java/javase/certconfig-2095354.html
Az
ÁNYK hibátlan működését csak az
általunk tesztelt operációs rendszerek
esetében garantáljuk.
2013 évtől kiadásra kerültek
olyan
nyomtatványok, amelyeknél a program
futtatásához nem elegendő az
512 MB fizikai memória. Ilyen pl.: 1365.
Telepítés
Háromféle telepítő csomag
létezik
- A keretrendszer/program
telepítését végző csomag. A
neve abevjava_install.jar
- 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.
- 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:
- Feltelepíti a programot a
felhasználó által megadott
könyvtárba.
- Elvégzi a felhasználói
beállításokat
- Létrehozza a felhasználó
által
megadott könyvtárba az adatoknak és
egyéb
állományoknak a megfelelő
könyvtárakat.
- Beállítja az elektronikus
küldéshez
szükséges KRDIR környezeti
változót.
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.
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 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és 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 v2.50.0-ás
verziótól kezdődően az Asztali ikon is
létrejön, ha a felhasználói
beállításokat kérve
futtatja a
telepítést.
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 8 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 minimum 1.8 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 Asztalon létrejött
ikonnal vagy az abevjava_start
állománnyal lehet indítani.
Telepítés Java
WebStart használatával az OS X 10.8 (Mountain
Lion)
és újabb verzióin:
Az OS X 10.8 és újabb
verziójú
operációs rendszereinél szoftverek
beszerzésére az Apple
alkalmazásboltjának
(App Store) használatát preferálja,
illetve az
Apple által hitelesített fejlesztőktől
származó, előírt
formátumú OS X
telepítő csomagokat tekinti hitelesnek. Ez az Apple
termékeire specifikus, platformfüggő szoftver
terjesztési technológia. A NAV
nyomtatványkitöltőjének, illetve a
nyomtatványoknak és segédleteiknek
telepítője a platformfüggetlen java web start
technológiát használja. Ettől a NAV a
támogatott platformok egységes
kezelése
érdekében nem kíván
eltérni.
Amennyiben a Web Startos telepítők
indítása
sikertelen lenne, próbálkozzon a
következőkkel
(telepített java futtatókörnyezetet
feltételezve):
Safari
- Kattintson a WebStart telepítőlinkre.
Valószínűleg a
Safari nem fogja elindítani a .jnlp-t.
- Nyissa meg a Letöltések panelt. Ezt a
Safari URL
címek beviteli mezője mellett megjelenő lefelé
mutató nyílra kattintva teheti meg.
- Keresse meg a futtatni kívánt .jnlp
fájlt. Feltehetőleg a lista legfelső eleme lesz.
- Nyissa meg a Finderben. Ezt a fájl neve melletti
nagyítóra kattintva teheti meg.
- Nyissa meg a fájlt a Java Web Start
használatával. Ezt megteheti a
CTRL+kattintás
megnyíló panelen a 'Megnyitás ezzel'
almenüben.
- A megjelenő dialógusablak megkérdezi,
hogy biztosan
meg kívánja-e nyitni az
állományt.
Válassza a Megnyitás gombot.
- Ha minden rendben ment, akkor a Java Web Start elindul
és
érvényesíti a telepítendő
alkalmazást. Sikeres
érvényesítés
után a telepítő elindul.
- Sikeres telepítés után
távolítsa el a .jnlp fájlt a
letöltési listából illetve a
Finderben a .jnlp
fájlt is kidobhatja a Kukába.
Google Chrome
- Kattintson a WebStart telepítőlinkre. A Chrome
valószínűleg üzenni fog, hogy a .jnlp
fájl nem
nyitható meg.
- Nyissa meg a Chrome Letöltés
kezelőjét. Ezt
megteheti a legegyszerűbben egy új lap
megnyitásával, és a chrome://downloads
beírásával a címsorba. A
Letöltési lista elérhető a Chrome
menüből is (az URL címsor melletti gombra
kattintva).
- Keresse meg a futtatni kívánt .jnlp
fájlt. Valószínűleg a lista legfelső
eleme lesz.
- Nyissa meg a Finderben. Ezt a fájl neve alatti
'Megjelenítés a Finderben' szövegre
kattintva teheti
meg.
- Nyissa meg a fájlt a Java Web Start
használatával. Ezt megteheti a CTRL+Klikk
megnyíló panelen a 'Megnyitás ezzel'
almenüben.
- A megjelenő dialógusablak megkérdezi,
hogy biztosan
meg kívánja-e nyitni az
állományt.
Válassza a Megnyitás gombot.
- Ha minden rendben ment, akkor a Java Web Start elindul
és érvényesíti a
telepítendő
alkalmazást.
Sikeres érvényesítés
után a
telepítő elindul.
- Sikeres telepítés után
távolítsa el a .jnlp fájlt a
letöltési listából illetve a
Finderben a .jnlp
fájlt is kidobhatja a Kukába.
Firefox
- Kattintson a WebStart telepítőlinkre. A Firefox
valószínűleg fel fog dobni egy panelt, amin
sikeresen
telepített java esetén a Megnyitás
rádiógomb melletti listában a Java Web
Start fog
megjelenni. Ha mégsem lenne már eleve
kiválasztva,
akkor válassza ki a listából.
- A rendszer valószínűleg
üzenni fog, hogy nem
lehet megnyiti a .jnlp fájlt, mert nem
azonosított
fejlesztőtől származik.
- Válassza ki az Eszközök
menü Letöltések
menüpontját.
- Keresse meg a
futtatni kívánt fájlt a
listában. Valószínűleg a lista
legfelső eleme
lesz.
- Nyissa meg a Finderben. Ezt megteheti a fájl
neve melletti nagyítóra kattintva.
- Nyissa meg a fájlt a Java Web Start
használatával. Ezt megteheti a
CTRL+kattintás
megnyíló panelen a 'Megnyitás ezzel'
almenüben.
- A megjelenő dialógusablak megkérdezi,
hogy biztosan
meg kívánja-e nyitni az
állományt.
Válassza a Megnyitás gombot.
- Ha minden rendben ment, akkor a Java Web Start elindul
és érvényesíti a
telepítendő
alkalmazást.
Sikeres érvényesítés
után a
telepítő elindul.
- Sikeres telepítés után
távolítsa el a .jnlp fájlt a
letöltési listából illetve a
Finderben a .jnlp
fájlt is kidobhatja a Kukába.
FONTOS: a
NAV
nyomtatványkitöltő, a nyomtatványok
és
segédleteik elektronikusan aláírt,
megbízható forrásból
származó
szoftverek. Az ellenőrzést a Java végzi el.
Javasolt telepítési mód
(telepített java futtatókörnyezetet
feltételezve)
Ha még nincsen kitöltőprogramja, töltse le
a
kitöltő telepítendő program .jar
kiterjesztésű
telepítő csomagját.
A Finderben dupla kattintással indítsa el.
A nyomtatványok és segédleteik
beszerzésére javasoljuk, hogy
használja a
kitöltőprogram Frissítések
funkcióját.
Telepítés
másolással
Lehetőség van a telepítő
futtatása nélkül is
telepíteni a programot.
- 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.
- Mindhárom típusú
telepítő csomag
– program, nyomtatvány,
kitöltési
útmutató – tartalmazza az application
könyvtárat.
- 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.
- 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.
- A telepítési
könyvtárban
létrejött ico és png
állományokat
felhasználhatja Képernyő ikon
létrehozásához.
- 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.
- 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:
- 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.
- Az állomány tartalma
abevjava.path=elérési út pl.:
abevjava.path = C:\\Program Files\\APEH\\abevjava
- A keretprogramot kell először
telepíteni. A ,,-s" kapcsolóval
indítható a parancssoros
telepítés.
- 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.
- 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.
- 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 |