Java-s Nyomtatványkitöltő Program

Átírás

1 Java-s Nyomtatványkitöltő Program Súgó (v1.30)

2 Tartalomjegyzék Telepítési útmutató... 4 Jar állományok futtatása és hozzárendelése a Java futtató környezethez Program telepítése Hálózatos telepítés Windows és Linux operációs rendszereken Hálózatos telepítés menete Gyakorlati példák A nyomtatványkitöltő program könyvtárszerkezete MS Windows rendszereknél A nyomtatványkitöltő program könyvtárszerkezete unix alapú rendszereknél Program indítása Program felület Dinamikus lapok kezelése Billentyű használat Szűrési feltételek Tételes adatrögzítés Számológép Új nyomtatvány Nyomtatvány megnyitása Nyomtatvány mentése Nyomtatvány mentése másként Nyomtatvány bezárása Számított mezők újraszámolása Megjegyzés Nyomtatvány adatainak törlése Csatolmányok kezelése XML állomány megnyitása szerkesztésre XML állomány mentése XML állomány bezárása XML állomány megnyitása megtekintése XML állományok ellenőrzése és átadása elektronikus beküldésre Járulék típusú XML állományok összemásolása Csoportos műveletek Nyomtatvány adatok listázása Üres nyomtatvány kinyomtatása Nyomtatvány kinyomtatása Boríték nyomtatás Kilépés Ellenőrzés Nyomtatvány megjelölése elektronikus beküldésre Nyomtatvány megjelölésének visszavonása Nyomtatvány közvetlen beküldése az Ügyfélkapun keresztül Nyomtatványok csoportos közvetlen beküldése az Ügyfélkapun keresztül Átadás digitális aláírásra Kapcsolat a Cég/Hivatali kapuval menüstruktúra megjelenésének szabályozása Kapcsolat a Cég/Hivatali kapuval menüstruktúra felépítése Nyomtatvány megjelölése elektronikus beküldésre Nyomtatvány megjelölésének visszavonása Nyomtatvány közvetlen beküldése Nyomtatványok csoportos közvetlen beküldése Nyomtatvány hitelesítése AVDH szolgáltatással Nyomtatvány hitelesítésének visszavonása Nyomtatvány mentése külső aláírással történő hitelesítéshez Külső aláírással történő hitelesítés visszavonása Nyomtatvány titkosítása elektronikus beküldésre Nyomtatvány titkosításának visszavonása

3 XCZ készítés fizikai adathordozón való benyújtáshoz XCZ készítés visszavonása Megjelölés, átadás napló Ügyfélkapu dokumentum feltöltéshez belépés Beállítások Törzsadatok Törzsadatok mentése NAV törzsadatok szinkronizálása NAV törzsadatok szinkronizálás beállítása Titkosítás saját tanúsítvánnyal Mező definíciós állomány (.csv) létrehozása Teszt import fájl készítése (.imp) Teszt XML fájl készítése (.xml) Automatikus kitöltés tesztadatokkal Csatolmány paraméterek XML-t és csatolmányt tartalmazó csomag készítése Frissítések Telepítés Telepített nyomtatványok Nyomtatványok archiválása Nyomtatványok visszavétele az archívumból Adatok archiválása és visszatöltése Másolás az import/export könyvtárból (átnevezés, törlés) Másolás a mentés könyvtárból (átnevezés, törlés) Másolás az import/export könyvtárba (átnevezés, törlés) Másolás a mentés könyvtárba (átnevezés, törlés) Egyedi importálás Csoportos importálás Technikai áttöltés új nyomtatványba Törzsadatok átvétele az ABEV-ből Adótanácsadók átvétele az ABEV-ből Üzenetek Kitöltési útmutató Súgó Névjegy Járulék bevallások kezelése a Java-s nyomtatványkitöltőben Példák járulékbevallás létrehozására.dat, xml,.imp formátumú állományokból Kötegelt nyomtatványok kezelése a java-s nyomtatványkitöltő programban (pl.: 1044 kötegelt nyomtatvány - HIPA; 10ELEKAFA - Elekáfa) Speciális kötegelt nyomtatványok kezelése a java-s nyomtatványkitöltő programban XML állomány megjelölése és megtekintése Parancssori import Xml állományok kezelése parancssori funkcióval XCZ állományok ellenőrzése, átadása elektronikus beküldésre és közvetlen beküldése parancssori funkcióval az ÁNYK programban Nagy XML állományok kezelése Memóriakezeléssel kapcsolatos beállítások Különbségek az ABEV és a Java-s nyomtatványkitöltő program között

4 Telepítési útmutató 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 v verziótól legalább 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 á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, Java 9 Windows 8.x Java 8, Java 9 ÁNYK nem fut Metro alkalmazásként Windows 10 Java 8, Java 9 Unix alapú rendszerek Ubuntu Java 8, Java LTS, LTS Mac OS X Java 8 Mac OS High Sierra verzio: A Java 9 csak 64 bit-es operációs rendszereken támogatott! 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) 4

5 Az ÁNYK hibátlan működését csak az általunk tesztelt operációs rendszerek esetében garantáljuk é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.: 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 o Létrehozza a felhasználó által megadott könyvtárba az adatoknak és egyéb állományoknak a megfelelő könyvtárakat. o 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 5

6 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. 6

7 Telepítés Machintos számítógép esetén Machintos számítógépek esetén kérjük, hogy olvassa el a Telepítés unix alapú rendszereknél szekciót. Ennek megfelelően kell a rendszert telepíteni A v á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 1. Kattintson a WebStart telepítőlinkre. Valószínűleg a Safari nem fogja elindítani a.jnlp-t. 2. 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. 3. Keresse meg a futtatni kívánt.jnlp fájlt. Feltehetőleg a lista legfelső eleme lesz. 4. Nyissa meg a Finderben. Ezt a fájl neve melletti nagyítóra kattintva teheti meg. 5. 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. 7

8 6. A megjelenő dialógusablak megkérdezi, hogy biztosan meg kívánja-e nyitni az állományt. Válassza a Megnyitás gombot. 7. 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. 8. 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 1. Kattintson a WebStart telepítőlinkre. A Chrome valószínűleg üzenni fog, hogy a.jnlp fájl nem nyitható meg. 2. 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). 3. Keresse meg a futtatni kívánt.jnlp fájlt. Valószínűleg a lista legfelső eleme lesz. 4. Nyissa meg a Finderben. Ezt a fájl neve alatti Megjelenítés a Finderben szövegre kattintva teheti meg. 5. 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. 6. A megjelenő dialógusablak megkérdezi, hogy biztosan meg kívánja-e nyitni az állományt. Válassza a Megnyitás gombot. 7. 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. 8. 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 1. 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. 2. 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. 3. Válassza ki az Eszközök menü Letöltések menüpontját. 4. Keresse meg a futtatni kívánt fájlt a listában. Valószínűleg a lista legfelső eleme lesz. 5. Nyissa meg a Finderben. Ezt megteheti a fájl neve melletti nagyítóra kattintva. 6. 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. 7. A megjelenő dialógusablak megkérdezi, hogy biztosan meg kívánja-e nyitni az állományt. Válassza a Megnyitás gombot. 8. 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. 9. 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) 8

9 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 az ÁNYK 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. 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= 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 9

10 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. Az -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 Jar állományok futtatása és hozzárendelése a Java futtató környezethez A telepítő csomagok.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 (JRE), mert anélkül a telepítő program nem fog működni! 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. 10

11 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 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 feltehetően nincs hozzárendelve a JAR típusú állományokhoz a java futtató környezet. Az alábbiak szerint járjon el: Telepítse újra a java futtató környezetet (JRE), az elvégzi a hozzárendelést. Ha nem sikerül az ismertetett módokon a hozzárendelés, akkor parancssorban lépjen be abba a könyvtárba, amelyikbe az NAV honlapjáról letöltötte a telepítő programot és írja be a következőt: java -jar "telepítőcsomag neve" pl.: java -jar abevjava_install.jar java -jar APEH_0753.jar java -jar APEH_doc_0753.jar Program telepítése Az abevjava_install.jar indításával telepíthető a nyomtatványkitöltő program. A program elindítása után közvetlenül az alábbi képernyő jelenik meg: Telepítési verziószám A következő képernyőn a telepítéshez szükséges információkat tartalmazó leírás jelenik meg. 11

12 Telepítési információk megjelenítése A telepítési információk elolvasása után a Tovább gombra kattintva az alábbi képernyő töltődik be: Telepítés/Eltávolítás funkcióválasztás Itt kiválaszthatja, hogy telepíteni vagy eltávolítani szeretné a nyomtatványkitöltő programot a számítógépéről. Ha még nem telepítette fel (vagy el távolította egy régebbi alkalommal), akkor a Telepített program eltávolítása funkciót nem tudja választani. (elszürkülve jelenik meg a funkció) 12

13 Telepítési beállítások Itt kétféle beállítás közül lehet választani: Alkalmazás telepítése: a nyomtatványkitöltő programot telepíti fel. Felhasználói beállítások elvégzése: Ha ezt választja, akkor a program telepítés közben bekéri az adat állományok helyét, elektronikus állományok megjelölésének a helyét. Alkalmazás telepítési útvonala Amennyiben nem a felajánlott - alapértelmezett - könyvtárba szeretné telepíteni a nyomtatvány kitöltő programot beírja a megfelelő telepítési útvonalat, vagy a Tallózás gombra kattintva ki tudja választani a telepítés helyét. A kitöltő program a megadott (alapértelmezésben felkínált) könyvtárnév alatt hozza létre a működéséhez szükséges könyvtárstruktúrát. Ezért célszerű egy létező üres, vagy akár nem létező könyvtárnevet megadni. Nem létező könyvtárnév megadása esetén a program rákérdez, hogy létrehozza-e a könyvtárat. A telepítési útvonal üresen hagyása után, ha a Vissza gombot kiválasztja, 13

14 majd újra rákattint a Tovább gombra, akkor az alapértelmezett telepítési útvonal betöltésre kerül. Ha sikerült a program telepítési helyét beállítani, utána a Tovább gombra kattintva meg adhatja először az elkészített nyomtatványok mentési helyét a fent leírt módon. A program telepítési helyét csak az első telepítéskor tudja beállítani! Elkészített nyomtatványok, nyomtatványok mentési helye Az alábbi képernyőn pedig a feladásra kerülő állományok helyét állíthatja be: Feladásra kerülő nyomtatványok mentési helye Ezután a Tovább gombra kattintva az alábbi képernyő jelenik meg: 14

15 Felhasználói beállítások Itt beállítási lehetőség, hogy a nyomtatvány kitöltőre mutató parancsikon megjelenjen-e az asztalon vagy szeretné-e a felhasználó a Start menübe elhelyezni a programot. Alapértelmezésben megjelenik mind a két helyen. A paraméterek megfelelő beállítása után a Tovább gombra kattintva a program telepítésre kerül. A telepítés folyamata bármikor megszakítható a Mégsem gombra kattintva. A program működéséhez szükséges állományok felmásolása az alábbi ablakban látható lesz, és az hogy milyen fájlok kerültek telepítésre. Telepített állományok listája A telepítés után információk jelennek meg a telepítés sikerességéről, valamint milyen további teendők vannak telepítés befejezése után. 15

16 Telepítési információk megjelenítése Amennyiben telepítve van már a nyomtatvány kitöltő a számítógépre, és másik könyvtárba szeretné telepíteni, akkor célszerű először eltávolítani a régit (abevjava_install.jar indítása, majd telepítés helyett a Telepített program eltávolítása funkció választása), majd utána újra telepíteni az új telepítési információkkal. A program csak azokat a fájlokat távolítja el, melyeket a telepítő feltelepített. A nyomtatványkitöltővel elkészített nyomtatványok nem kerülnek törlésre! A program eltávolítása közben a kitöltő program nem futhat! Hálózatos telepítés Windows és Linux operációs rendszereken A program nem használja a Registry-t. A program három könyvtárstruktúrát használ, melyek a következők: (Ettől részletesebb információkat a könyvtárszerkezetről az NAV portálon talál.) 1. Programkönyvtár Ide kerülnek a programot működtető állományok. Helye Windows esetén: <windir környezeti változó>\abevjavapath.cfg közérthetőbben: abban a mappában ahova a Windows telepítve van. (Többnyire C:/WINDOWS) Helye Linux esetén: /etc/abevjavapath.cfg 2. Adatkönyvtár Ide kerülnek a felhasználói beállítások, kitöltött nyomtatványok, törzsadatok, stb. Helye Windows esetén: <felhasználó home könyvtára>\.abevjava\<felhasználónév>.enyk közérthetőbben: a felhasználó személyes mappája. (Többnyire C:\Documents and Settings\felhasználónév\) Helye Linux esetén: /home/felhasználónév/abevjavapath.cfg 16

17 3. Elektronikus feladás könyvtára Ide kerülnek az elektronikus feladásra szánt nyomtatványok. Minden esetben: Az Elektronikus feladás könyvtárát a KRDIR környezeti változó tárolja. Hogy nézheti meg a környezeti változók értékét? Windows-on: Kattintson a Start -> Beállítások -> Vezérlőpult -> Rendszer ikonra. A felugró ablakban válassza a Speciális fület, majd alul a Környezeti változók gombot. A felnyíló ablakban láthatja a felhasználói és rendszerszintű környezeti változókat is. A nyomtatványkitöltő program által használt KRDIR környezeti változót a felhasználói környezeti változók között találja! (Amennyiben a korábbi ABEV is telepítve volt vagy van, akkor a rendszerváltozók közötti is talál egy KRDIR-t, ezt a korábbi ABEV használja.) Linux-on: Egy terminál ablakban adja ki az "env grep KRDIR" parancsot. A három könyvtárstruktúra bármelyike egyedileg állítható, így akár hálózati meghajtóra helyezhető. Néhány lehetséges felhasználási mód: A hálózati meghajtón mind a három könyvtár közös, minden felhasználó számára. A többi felhasználó állományait is megnézheti, módosíthatja. Ha a hálózati meghajtó, ahol a Program könyvtárat elhelyezte nem írásvédett, akkor bármelyik felhasználó frissítheti a programot, nyomtatványokat, dokumentációt. A Program könyvtár közös a hálózati meghajtón, esetleg felhasználó szintű jogosultságokkal védett, vagy a rendszergazda számára írható csak. Az Adatkönyvtár és az Elektronikus feladás könyvtára felhasználó szintű könyvtárakban hálózati meghajtón található. Az is beállítható, hogy az Adatkönyvtár egyedi legyen a hálózaton minden felhasználónak, az Elektronikus feladás könyvtára pedig közös. (Mindenki csak a saját állományait látja, az ügyfélkapun történő konkrét feladást egy arra kijelölt felhasználó végzi.) Ha az Elektronikus feladás könyvtára egyedi (felhasználónként különböző), akkor az Adatkönyvtárnak is egyedinek kell lenni. Ellenkező esetben a programnak az állományok állapotáról (Elküldött) bizonyos esetekben nem lesz információja. A fenti lehetőségek között annyi a különbség, hogy a korábban említett könyvtárak - program, adat és elektronikus feladás - beállítása hogyan történik. Hálózatos telepítés menete Alkalmazás telepítése Csatolja a szükséges hálózati meghajtókat, amelyen vagy amelyeken, a programot, az adatokat és az elektronikus feladásra szánt állományokat tárolni szeretné. (Az UNC Path hivatkozás \\szerver\megosztás\könyvtár nem használható.) A program telepítése történhet az állomány kiszolgálón, vagy egy kliens gépen olyan felhasználóval, amelynek van jogosultsága a hálózati meghajtón állományok 17

18 létrehozásához, és a felhasználói gépen rendszergazdai jogosultságokkal rendelkezik. Ha a szerveren futó operációs rendszer nem azonos típusú (pl. linux-os file szerver, windows-os kliensek), a felhasználói gépek operációs rendszerével, akkor a programtelepítést mindenképpen a kliens gépekről kell kezdeményezni. A program létrehozza a <windir környezeti változó>\abevjavapath.cfg (Linux esetén: /etc/abevjavapath.cfg) állományt. Kliens gépek (új felhasználók) telepítése A többi felhasználói gépen a windir környezeti változó által definiált könyvtárba (Linux esetén a /etc könyvtárba) kell másolni, vagy újonnan létrehozni az abevjavapath.cfg állományt. Az állományban található elérési út arra a könyvtárra (hálózati) mutasson, ahová a program telepítve lett (UNC path hivatkozás \\szerver\megosztás\könyvtár nem használható). Ezt követően felhasználói gépeken le kell futtatni a telepítőt, de csak a felhasználó beállításokat kérve. A felhasználó beállítások során kell megadni az Adat és az Elektronikus feladás könyvtárát. Ezek a könyvtárak kerülhetnek a felhasználó gépére, a hálózatra, a hálózaton egyedi vagy közös könyvtárba. A kliens gépeken a felhasználói beállításokat egyszer kell elvégezni. A későbbi telepítéseknél, - program, nyomtatvány, dokumentáció, - elegendő egy gépen elvégezni a telepítést, a hálózati meghajtón állomány létrehozási/módosítási jogosultsággal rendelkező felhasználóval. A felhasználói beállítások elvégzése ezután már nem szükséges. A későbbiekben csak akkor van szükség rá, ha megváltozik a felhasználói adatok helye. Ekkor a telepítő futtatásával és a felhasználói beállítások elvégzésével beállítható az új könyvtár. Az adatokat nem másolja a program, azt egyedileg kell elvégezni! Ha a felhasználó gépén a Programkönyvtár elérési útját tartalmazó abevjavapath.cfg állomány mellett az Adatkönyvtár elérési útját tartalmazó <felhasználó home könyvtára>\.abevjava\<felhasználói azonosító>.enyk állomány is be van állítva, akkor a program elindításával automatikusan létrejönnek a felhasználói adatok tárolásához szükséges könyvtárak. Ez lehetőséget nyújthat nagyszámú, távoli, felhasználói interakciót nem kívánó telepítésre. Program és nyomtatvány frissítés Ha a Programkönyvtár azonos (hiszen közös hálózati meghajtó mappája) akkor az adott mappára írási jogosultsággal bíró felhasználó frissítheti a programot és a nyomtatványokat is. Elegendő a telepítő állományt futtatnia. Ezt követően már bármelyik felhasználó a friss változatot indíthatja és használhatja. Gyakorlati példák Több, hálózatba kötött gép használata esetén (pl. könyvelő iroda) az a cél, hogy a program és nyomtatványok egyetlen helyre legyenek telepítve, ezáltal csökkentve a telepítés, de főleg a frissítés munkaigényét. Ezért az alább leírt esetek mindegyikében 18

19 abból indulunk ki, hogy a programot egy kiszolgáló, vagy akár egy kijelölt felhasználói gép hálózati megosztására telepítjük. 1. Felhasználók önállóan, egymástól függetlenül dolgoznak Ha olyan munkakörnyezetet kíván kialakítani, ahol a felhasználó csak saját elmentett nyomtatványaikkal, törzsadataikkal dolgozhatnak, saját nyomtatványukat küldhetik csak be, akkor a következők szerint telepítsen: 1. Hozzon létre egy hálózati megosztáson egy mappát ahova a programot majd telepíti. (példánkba ez Z:/APEHprogram) 2. A felhasználó gépén indítsa el a nyomtatványkitöltő program telepítését, a telepítés során a Futtató program célmappájának adja meg a Z:/APEHprogram útvonalat. 3. Felhasználói beállítások és adat könyvtárnak jelöljön ki egy mappát a felhasználó saját könyvtárában (pl.: C:/Documents and Settings/felhasznalo1/abevjava). 4. Az elektronikus feladáshoz jelöljön ki egy mappát a felhasználó saját könyvtárában (pl.: C:/Documents and Settings/felhasznalo1/abevjava/eKuldes). 5. Hajtsa végre a telepítést. 6. Ha újabb felhasználó számára akarja használhatóvá tenni a programot, akkor két lehetősége van (egyiket kell csak végrehajtania): o Ismételje meg az új felhasználó gépén (az ő nevében bejelentkezve) a telepítést a fentiek szerint. o Másolja az új felhasználó gépére a Programkönyvtár elérési útját tartalmazó abevjavapath.cfg állomány mellett az Adatkönyvtár elérési útját tartalmazó <felhasználó home könyvtára>\.abevjava\<felhasználói azonosító>.enyk állományt és állítsa be értelem szerűen e felhasználó home könytárára (prop.usr.root). A program indításával minden egyéb, szükséges könyvtár létrejön automatikusan. 2. Felhasználók közös munkakörnyezetben dolgoznak (mindenki látja/módosíthatja/beküldheti egymás nyomtatványait) Ha olyan munkakörnyezetet akar kialakítani, ahol minden felhasználó egy közös mappába dolgozik, bármelyik felhasználó tudja módosítani a másik felhasználó nyomtatványát és bármelyikük bármelyik nyomtatványt feladhatja elektronikusan. 1. Hozzon létre egy hálózati megosztáson egy mappát, ahova a programot telepíti majd (példánkba ez Z:/APEHprogram). 2. Hozzon létre egy hálózati megosztáson egy mappát, ahol majd a közös felhasználói adatok tárolódnak (példánkban ez legyen H:/APEHkozosFelhasznaloi). 3. A felhasználó gépén indítsa el a nyomtatványkitöltő program telepítését, a telepítés során a Futtató program célmappájának adja meg a Z:/APEHprogram útvonalat. 4. Felhasználói beállítások és adat könyvtárnak jelöljön ki megfelelő hálózati mappát (H:/APEHkozosFelhasznaloi). 5. Az elektronikus feladáshoz jelöljön ki egy mappát a felhasználók közös könyvtárában (pl.: H:/APEHfelhasznaloi/eKuldes). 6. Hajtsa végre a telepítést. 7. Ha újabb felhasználó számára akarja használhatóvá tenni a programot, akkor két lehetősége van (egyiket kell csak végrehajtania): o Ismételje meg az új felhasználó gépén (az ő nevében bejelentkezve) a telepítést a fentiek szerint. o Másolja az új felhasználó gépére a Programkönyvtár elérési útját tartalmazó abevjavapath.cfg állomány mellett az Adatkönyvtár elérési útját tartalmazó 19

20 <felhasználó home könyvtára>\.abevjava\<felhasználói azonosító>.enyk állományt. A program indításával minden egyéb, szükséges könyvtár létrejön automatikusan. 3. Felhasználók egymástól függetlenül dolgoznak, elektronikus feladással egyikük van megbízva Ha olyan munkakörnyezetet kíván kialakítani, ahol a felhasználó csak saját elmentett nyomtatványaikkal, törzsadataikkal dolgozhatnak, saját nyomtatványukat megjelölheti feladásra, de az összes feladást egy felhasználó végzi, akkor a következők szerint telepítsen: 1. Hozzon létre egy hálózati megosztáson egy mappát, ahova a programot majd telepíti (példánkba ez Z:/APEHprogram). 2. Hozzon létre egy hálózati megosztáson egy mappát, ahol feladásra szánt nyomtatványok tárolódnak (példánkban ez legyen H:/eKuldes). 3. Indítsa el a nyomtatványkitöltő program telepítését, a telepítés során a Futtató program célmappájának adja meg a Z:/APEHprogram útvonalat. 4. Felhasználói beállítások és adat könyvtárnak jelöljön ki egy mappát a felhasználó saját könyvtárában (pl.: C:/Documents and Settings/felhasznalo1/abevjava). 5. Az elektronikus feladáshoz jelölje ki a létrehozott hálózati mappát (pl.: H:/eKuldes). 6. Hajtsa végre a telepítést. 7. Ha újabb felhasználó számára akarja használhatóvá tenni a programot, akkor két lehetősége van (egyiket kell csak végrehajtania): o Ismételje meg az új felhasználó gépén (az ő nevében bejelentkezve) a telepítést a fentiek szerint. o Másolja az új felhasználó gépére a Programkönyvtár elérési útját tartalmazó abevjavapath.cfg állomány mellett az Adatkönyvtár elérési útját tartalmazó <felhasználó home könyvtára>\.abevjava\<felhasználói azonosító>.enyk állományt és állítsa be értelem szerűen e felhasználó home könytárára (prop.usr.root). A program indításával minden egyéb, szükséges könyvtár létrejön automatikusan. 4. Nem felhasználónként, hanem könyvelt cégenként külön nyomtatványkitöltő program futtatása Ha olyan munkakörnyezetet kíván kialakítani (pl. egy könyvelő iroda), ahol nem felhasználónként (könyvelőnként) hanem könyvelt cégként (ügyfelenként) szeretne elkülönített munkakörnyezetet kialakítani, akkor a következőképpen kell eljárnia: 1. Hozzon létre egy hálózati megosztáson egy mappát, ahova a programot telepíti majd (példánkba ez Z:/APEHprogram). 2. Hozzon létre egy hálózati megosztáson egy mappát, ahol majd a cégenkénti felhasználói adatok tárolódnak (példánkban ez legyen H:/cegek/ceg1). 3. Egyik felhasználó gépén indítsa el a nyomtatványkitöltő telepítését, a telepítés során a Futtató program célmappájának adja meg a Z:/APEHprogram útvonalat. 4. Felhasználói beállítások és adat könyvtárnak jelöljön ki megfelelő hálózati mappát (H:/cegek/ceg1). 5. Az elektronikus feladáshoz jelöljön ki egy mappát a felhasználók közös könyvtárában (pl.: H:/cegek/ceg1/eKuldes). 6. Hajtsa végre a telepítést, majd indítsa el a programot. (Ezzel létrejön a beállításokat tartalmazó állomány.) Elindulást követően lépjen ki. 20

21 7. A telepítést végrehajtó felhasználó Documents and Settings mappájában lévő.abevjava mappából mozgassa át a létrejött.enyk fájlt a H:/cegek/ceg1/ mappában ceg1.enyk néven, majd módosítsa az alábbi négy sort: prop.usr.naplo=h:/cegek/ceg1/naplo prop.usr.root=h:/cegek/ceg1 prop.usr.frissitesek=h:/cegek/ceg1/frissitesek prop.usr.primaryaccounts=h:/cegek/ceg1/torzsadatok 8. Ezt követően hozzon létre egy új indítofájlt (.bat) a Z:/APEHprogram mappában az alábbi tartalommal, akkor ezzel bármelyik felhasználó indíthatja az adott ügyfél szerepében a nyomtatványkitöltő programot. set KRDIR=H:/cegek/ceg1/eKuldes abevjava_start.bat "useroptionfile=h:/cegek/ceg1/ceg1.enyk" 9. Ha további céget szeretne hozzáadni, akkor elég ha a mappát másolja le és nevez át mindent "ceg1"-ről mondjuk "ceg2"-re (könyvtárnév,.enyk fájlnév és az állomány tartalmában, valamint az indítófájlban). A nyomtatványkitöltő program könyvtárszerkezete MS Windows rendszereknél A program a következő könyvtárakba települ, illetve a következő állományokat használja: Rendszerkönyvtárak Ha a programot rendszergazdai jogosultságokkal rendelkező felhasználó telepíti, akkor a windir környezeti változó által definiált elérési út alatt található abevjavapath.cfg állomány tartalmazza azt az elérési utat, ahová telepítve lett az adott gépen a Java-s nyomtatványkitöltő program. Amennyiben nem rendszergazdai jogosultságokkal indítják a telepítést, akkor a program jelzi, hogy nem tudja a fenti könyvtárban létrehozni az abevjavapath.cfg állományt és a felhasználó home könyvtára alatt a \.abevjava könyvtárba helyezi azt. Felhasználása: Ebből az állományból derül ki, hogy hová lett telepítve a program. A frissítések során a keretprogram, a nyomtatvány és a dokumentumtelepítők innen veszik, hogy az adott gépen hová lett telepítve a keretprogram. Külső programok is innen állapíthatják meg, hogy hol keressék a nyomtatványkitöltő programot. A rendszergazda is létrehozhatja ezt az állományt, beállítva a telepítési könyvtárat is. (Például: abevjava.path=d:\\programok\\ado\\abevjava) Amennyiben már létezik ez az állomány akkor a telepítő az ebben található elérési utat tekinti a programkönyvtárnak és nem engedi módosítani. 21

22 Programkönyvtár Program alatt a java program, a nyomtatvány sablonok, a program dokumentáció és a kitöltési útmutatók értendők. Ezek az állományok egy helyre települnek az adott gépen és az adott gép összes felhasználója ezt használja, futtatja. (Amennyiben rendszergazdai jogosultságokkal indították a telepítőt, vagy beállították a helyét a konfigurációs állományban.) A telepítés során az alapértelmezett programkönyvtár a \Program Files\abevjava. Ez tetszőlegesen módosítható, de csak első telepítéskor. Ezt az elérési utat tartalmazza az abevjavapath.cfg állomány. A program futása során ebbe a könyvtárba nem ír, az állományokat nem módosítja, log-ot nem hoz létre benne. A könyvtár tartalma: abev: Segédállományok eroforrasok: Erőforrás állományok license: Szabadon felhasználható beépített szoftverek információi nyomtatvanyok: Sablonok segitseg: Programdokumentáció és Kitöltési útmutatók upgrade: Munka könyvtár a programfrissítésekhez xsd: XML ellenőrzéshez xsd állományok abevjava_start*: Indító szkriptek abevjava.jar: Főprogram *.enyk: Paraméterek Felhasználói könyvtárak, adatállományok, felhasználói beállítások A felhasználó home könyvtára a különböző Windows verziók esetén Verzió Windows XP, Vista Könyvtár \Documents and Settings\ %Felhasználói azonosító% Windows 7, 8.x, 10 \Users\ %Felhasználói azonosító% A program a felhasználó home könyvtárában létrehoz egy könyvtárat \.abevjava néven. Ebbe a könyvtárba kerül a %Felhasználói azonosító%.enyk állomány. Ebbe mentődik a felhasználó adatkönyvtárának az elérési útja illetve további elérési utak. A nem teljes elérési úttal megadott paraméterek az adatkönyvtárhoz relatívak. A felhasználó home könyvtárában az abevjava könyvtárát ajánlja fel a program adatkönyvtárnak. Ez tetszőlegesen módosítható. (Erre fog mutatni az említett %Felhasználói azonosító%.enyk állomány egy bejegyzése.) Minden felhasználónak a saját home könyvtára lesz felajánlva. A könyvtár tartalma: archivum: Az arhíválás funkció használja beallitasok: A beállítások panel paraméterei csatolmanyok: Felhasználói csatolmányok frissitesek: Munkakönyvtár a frissítésekhez import: Import/Export 22

23 kontroll: Kontroll nyomtatványok kezeléséhez mentesek: A mentett nyomtatványok tmp: Ideiglenes állományok torzsadatok: Törzsadatok naplo: Minden plusz állományba kért információ ide kerül. A program a felhasználó home könyvtárában abevjava.log állományba naplózza tevékenységét. Azért ide és nem az adatkönyvtárba, mert hibás indítás, indulás esetén előfordulhat, hogy még nem ismeri az adatkönyvtárat. Kapcsolat az Ügyfélkapuval, KRDIR környezeti változó A program létrehoz egy környezeti változót KRDIR néven. Erre az Elektronikus feladásnál van szükség. Ez teremti meg a kapcsolatot az Abev és az Ügyfélkapu között. (Mindkettő ugyanazt KRDIR a könyvtárat használja. Ide másolódnak a nyomtatványok a feladáshoz. Az Ügyfélkapu adminisztrálás néven a feladott állományokat áthelyezi a KRDIR alatt található KR/elkuldott mappába. Így szerez tudomást az Abev az állapotváltozásról.) A környezeti változó felhasználó függő. Minden felhasználónak, a saját könyvtára (home) alatti \abevjava\ekuldes könyvtárát ajánlja fel a program. Ezt az Abev és a java-s nyomtatványkitöltő program közösen használja. Ha már létezik, akkor a telepítő az eredetit ajánlja fel és ha nem módosítják akkor meghagyja az eredetit. De ha módosítják, akkor attól kezdve az Abev is az új könyvtárat fogja használni. A nyomtatványkitöltő program könyvtárszerkezete unix alapú rendszereknél A program a következő könyvtárakba települ, illetve a következő állományokat használja: Rendszerkönyvtárak Ha a programot rendszergazdai jogosultságokkal rendelkező felhasználó telepítette, akkor /etc/abevjavapath.cfg állomány tartalmazza azt az elérési utat, ahová telepítve lett az adott gépen a nyomtatványkitöltő program. Amennyiben nem rendszergazdai jogosultságokkal indítják a telepítést, akkor a program jelzi, hogy nem tudja a fenti könyvtárban létrehozni az abevjavapath.cfg állományt és a felhasználó home könyvtára alatt a /.abevjava könyvtárba helyezi azt. Felhasználása: Ebből az állományból derül ki, hogy hová lett telepítve a program. A frissítések során a keretprogram, a nyomtatvány és a dokumentumtelepítők innen veszik, hogy az adott gépen hová lett telepítve a keretprogram. Külső programok is innen állapíthatják meg, hogy hol keressék a programot. A rendszergazda is létrehozhatja ezt az állományt, beállítva a telepítési könyvtárat is. Például: abevjava.path=/usr/share/abevjava 23

24 Amennyiben már létezik ez az állomány, akkor a telepítő az ebben található elérési utat tekinti a programkönyvtárnak és nem engedi módosítani. Programkönyvtár Program alatt a java program, a nyomtatvány sablonok, a program dokumentáció és a kitöltési útmutatók értendők. Ezek az állományok egy helyre települnek az adott gépen és az adott gép összes felhasználója ezt használja, futtatja. (Amennyiben rendszergazdai jogosultságokkal indították a telepítőt, vagy beállították a helyét a konfigurációs állományban.) A telepítés során az alapértelmezett programkönyvtár a /usr/share/abevjava. Ez tetszőlegesen módosítható, de csak első telepítéskor. Ezt az elérési útat tartalmazza az abevjavapath.cfg állomány. A program futása során ebbe a könyvtárba nem ír, az állományokat nem módosítja, log-ot nem hoz létre benne. A könyvtár tartalma: abev: Segédállományok eroforrasok: Erőforrás állományok license: Szabadon felhasználható beépített szoftverek információi nyomtatvanyok: Sablonok segitseg: Programdokumentáció és Kitöltési útmutatók upgrade: Munka könyvtár a programfrissítésekhez xsd: XML ellenőrzéshez xsd állományok abevjava_start*: Indító szkriptek abevjava.jar: Főprogram *.enyk: Paraméterek Felhasználói könyvtárak, adatállományok, felhasználói beállítások A program a felhasználó home könyvtárában létrehoz egy könyvtárat /home/% Felhasználói azonosító %/.abevjava néven. Ebbe a könyvtárba kerül a % Felhasználói azonosító %.enyk állomány. Ebbe mentődik a felhasználó adatkönyvtárának az elérési útja illetve további elérési utakat. A nem teljes elérési úttal megadott paraméterek az adatkönyvtárhoz relatívak. A felhasználó home könyvtárában a /home/% Felhasználói azonosító %/abevjava könyvtárát ajánlja fel a program adatkönyvtárnak. Ez tetszőlegesen módosítható. (Erre fog mutatni az említett % Felhasználói azonosító %.enyk állomány egy bejegyzése.) Minden felhasználónak a saját home könyvtára lesz felajánlva. A könyvtár tartalma: archivum: Az arhíválás funkció használja beallitasok: A beállítások panel paraméterei csatolmanyok: Felhasználói csatolmányok frissitesek: Munkakönyvtár a frissítésekhez import: Import/Export kontroll: Kontroll nyomtatványok kezeléséhez mentesek: A mentett nyomtatványok 24

25 tmp: Ideiglenes állományok torzsadatok: Törzsadatok naplo: Minden plusz állományba kért információ ide kerül. A program a /home/% Felhasználói azonosító %/abevjava.log állományba naplózza tevékenységét. Azért ide és nem az adatkönyvtárba, mert hibás indítás, indulás esetén előfordulhat, hogy még nem ismeri az adatkönyvtárat. Kapcsolat az Ügyfélkapuval, KRDIR környezeti változó A program létrehoz egy környezeti változót KRDIR néven. Erre az Elektronikus feladásnál van szükség. Ez teremti meg a kapcsolatot az Abev és az Ügyfélkapu között. (Mindkettő ugyanazt KRDIR a könyvtárat használja. Ide másolódnak a nyomtatványok a feladáshoz. Az Ügyfélkapu adminisztrálás néven a feladott állományokat áthelyezi a KRDIR alatt található KR/elkuldott mappába. Így szerez tudomást az Abev az állapotváltozásról.) A környezeti változó felhasználó függő. Minden felhasználónak, a saját könyvtárának a /home/% Felhasználói azonosító %/abevjava/ekuldes könyvtárát ajánlja fel a program. A létrehozó szkript a /home/% Felhasználói azonosító %/.profabevjava néven jön létre, amely állomány meghívódik a felhasználói.profileból. Program indítása A programot három féle módon lehet elindítani: 1. Start menü -> Programok -> Nyomtatványkitöltő 2. Asztalon található ikon: Megjegyzés: Asztalon található ikonnal abban az esetben indítható, ha a telepítés során a Parancsikon létrehozása az Asztalon beállításra került, vagy később a felhasználó létrehozott egy parancsikont. 3. A telepítési könyvtárban található abevjava_start parancsállománnyal 25

26 Program felület Kitöltő felület felépítése K A státuszsoron az alábbi funkció található: Nagyítás - kicsinyítés A csúszka mellett található ikonnal alapértelmezett állapotba lehet visszaállítani a kitöltő program méretét. A kitöltő felületen különböző komponensek találhatók: egyszerű beviteli mezők: különböző értékkészlettel rendelkezhetnek pl.: csak szám, betű és számok egyaránt stb. dátum mező: dupla kattintással lenyitható, így a megfelelő dátumot egy naptárból lehet kiválasztani 26

27 jelölőnégyzet: bepipáláskor a jelölőnégyzet melletti szöveg/funkció elfogadását szolgálja. értéklista: duplakattintással, vagy Ctrl+le nyíl hatására lenyitható. Háromféle értéklistát különböztetünk meg: 1. Csak az értéklistában szereplő értékek közül lehet választani (a mező jobb felső sarkában piros háromszög jelöli): 2. Nemcsak az értéklistában szereplő értékek közül lehet választani, hanem tetszőleges érték is rögzíthető a mezőbe (a mező jobb felső sarkában zöld háromszög jelöli) 3. Feltételes értéklista. Az értéklista tartalma valamilyen feltétel teljesüléséhez kötött. Dinamikusan változhat. (a mező jobb felső sarkában kék háromszög jelöli) Dinamikus lapok kezelése Azokat a lapokat, amelyekből több, azonos típusú hozható létre, dinamikus lapnak nevezzük. Dinamikus lapok kezelését az alábbi menüsorral tudja vezérelni: A menüsor funkciógombjai és ikonjai a következőek: : Mező tartalmának szűrésére szolgál. Egy dinamikus lapon lévő mező kiválasztása után megjeleníti az összes, ugyanolyan típusú dinamikus lapon lévő mező tartalmát. Csak akkor használható a funkció, ha több dinamikus lap van létrehozva, és az egyik dinamikus lapon ki lett választva egy mező. (sárga a mező tartalma). A gomb lenyomására egy táblázat jelenik meg, az aktív dinamikus lappal megegyező típusú dinamikus lap kiválasztott mezőjének tartalmával. Ebben a táblázatban rendezheti az oszlop fejlécre való kattintással (növekvő/csökkenő) sorrendbe a kiválasztott oszlop adatait. A szűrési feltételek használatával a megszokott módon kereshet a nyomtatványok között. A kiválasztott sorra duplán kattintva aktívvá válik a mezőértéket tartalmazó dinamikus lap, vagy használhatja a Kiválaszt gombot. : Az aktuális dinamikus lap adattartalmával annyi dinamikus lap hozható létre, mint amennyi az ikon előtti szövegmezőben szereplő érték. Célszerű az ismétlődő értékekkel kitöltött lap másolására használni. Ha csak bizonyos mezők adatát szeretné átmásolni, akkor létre kell hoznia egy olyan lapot, amelyen csak a másolandó mezők ki vannak töltve. Ezután a fent leírt módon tetszőleges 27