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

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

• 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

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öryezeti 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.

Linux-on: Egy terminál ablakban adja ki az "env | grep KRDIR" parancsot.

A három könyvtárstruktúra bármelyike egyedileg álí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 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 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):
• Ismételje meg az új felhasználó gépén (az ő nevében bejelentkezve) a telepítést a fentiek szerint.
• 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):
• Ismételje meg az új felhasználó gépén (az ő nevében bejelentkezve) a telepítést a fentiek szerint.
• 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. 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):
• Ismételje meg az új felhasználó gépén (az ő nevében bejelentkezve) a telepítést a fentiek szerint.
• 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.
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).