A Migrációs folyamat bemutatása az ASP Adó szakrendszerben

A Migrációs folyamat bemutatása az ASP Adó szakrendszerben 2018.07.23.

Tartalomjegyzék Tartalomjegyzék... 2 Általános bemutatás... 3 Migrációs segédeszköz letöltése... 3 Az alkalmazás futtatásának lépései... 4 Kitömörítés... 4 Futtatás... 5 ONKADO rendszer adatfájljainak helye... 6 OnkadoValtozoMegfeleltetes.xlsx információs tábla... 9 Migrációs adatcsomag célkönyvtárának meghatározása... 11 Konvertálás, tömörítés... 12 Migrációs állomány feltöltése, migráció indítása... 13 Migrációs fájlok feltöltése, kitömörítése és konzisztencia ellenőrzése... 13 A migráció indítása... 14 Bejelentkezés az ASP Adó rendszer migrált adatbázisába, migrációs listák letöltése... 15 Bejelentkezés az ASP Adó rendszer migrált adatbázisába... 15 Migrációs listák letöltése... 15 Migrációs log... 16 Migrációs adathibák... 17 Ellenőrző lista ONKADO... 17 Ellenőrző lista ASP.Adó... 18 Összehasonlító lista... 18 Adattisztítási jelentés... 18 Jegyzői elfogadó nyilatkozat... 19 2 / 19

Általános bemutatás Az ASP Adó szakrendszer használatának megkezdése előtt az egyik legnagyobb körültekintést igénylő feladatot a forrásrendszerből (ONKADO) az ASP Adó szakrendszerbe történő adatáttöltés (a továbbiakban: migráció) és az áttöltött adatok ellenőrzése jelenti a csatlakozó önkormányzatok számára. A dokumentum célja annak bemutatása, hogy milyen feladatok jelentkeznek a migrációs folyamat során, illetve milyen módon lehetséges ellenőrizni az áttöltött adatokat. Fontos, hogy a migrációs felület a Keretrendszerbe történő belépést követően az Adó migráció gombra kattintva érhető el: A programot a legfrissebb Mozilla Firefox böngészőben javasolt elindítani. Migrációs segédeszköz letöltése Az egyik legjelentősebb eltérés az ONKADO és az ASP Adó szakrendszer között az eltérő fájlformátumban történő adattárolás. Míg az ONKADO dbf adatbázisfájlokban tárolja az adatokat, addig az ASP Adó szakrendszer migrációs folyamata megfelelve a mai elvárásoknak az internetes szabványokon alapuló XML formátumot alkalmazza, így szükséges a korábban használt állományok átkonvertálása. Annak érdekében, hogy az önkormányzatok egyszerűen és áttekinthető módon megvalósíthassák a konvertálást, és fel tudják tölteni saját adatbázisukat az ASP Adó szakrendszerbe, készült egy ONKADO adatfájlokból migrációs adatcsomagot előállító alkalmazás. A migrációs segédeszköz letöltése az ASP Adó szakrendszeren belül a Környezet/Adóhatóság/Migráció menüpontban kezdeményezhető a Migrációs segédeszköz alkalmazáscsomag hivatkozásra kattintva: 3 / 19

FONTOS: A fájlfeltöltés csak az alkalmazással betömörített állománnyal működik a webes oldalon, mivel az alkalmazás ellenőrző-összegképzést is tartalmaz! Az alkalmazás futtatásának lépései Kitömörítés A migrációs segédeszköz (OnkadoXMLCompress.zip) letöltését és megnyitását követően egy tömörített mappa jelenik meg, melyben szerepel az összes olyan állomány, amely szükséges a migrálható adatbázis elkészítéséhez. 4 / 19

Az alkalmazás indítása az említett mappából az állományok tömörített állapota miatt nem kivitelezhető, így használat előtt szükséges az összes állomány kicsomagolása egy tetszőleges munkamappába. FONTOS: A tömörített állomány egész tartalmára szükség van a program helyes működésének érdekében! Futtatás A kitömörítést követően az alkalmazás megnyitásához, az OnkadoXMLCompress.exe fájlt szükséges kiválasztani a munkamappából, és a felugró biztonsági figyelmeztetés során a futtatás opcióra kattintani. A gyakori (ciklikus) használat miatt célszerű az Asztalon indító parancsikont létrehozni. A program futtatásához a Microsoft.NET komponens 4-es verziója szükséges, mely alapvetően a Windows operációs rendszer részeként már telepítve van. Amennyiben mégsem lenne, a következő hibaüzenet jelenik meg: 5 / 19

Ez esetben az alábbi linken keresztül letölthető és telepíthető a komponens: https://www.microsoft.com/hu-hu/download/details.aspx?id=17851 A program megnyílását követően megkezdődhet a különböző állományok és mappák elérésének megadása, melyeket a következő lépések mutatnak be. ONKADO rendszer adatfájljainak helye A Mappa kiválasztása nyomógombra kattintva a képernyőn megjelenő könyvtárstruktúrából kiválasztható az adatállományokat tartalmazó könyvtár (pl.: Onkado munkakönyvtár). 6 / 19

A mappa meghatározása után a program automatikusan ellenőrzi a migrációhoz szükséges adatfájlok meglétét, valamint hozzáférhetőségét a kiválasztott könyvtárban. A migrációhoz, és így az adatcsomag létrehozásához feltétlenül szükséges ONKADO adatfájlok: "ADOERO.dbf" "ADAT_36.dbf" "ADAT_87.dbf" "EGYEN.dbf" "MHELY.dbf" "THELY.dbf" "ADAT_21.dbf" "ADAT_37.dbf" "ADOHAT_A.dbf" "ERTEKMUT.dbf" "PENZF.dbf" "TMAGAN.dbf" "ADAT_22.dbf" "ADAT_42.dbf" "ADONEM.dbf" "FOLDANAL.dbf" "SZABS_ID.dbf" "TSZEM.dbf" "ADAT_23.dbf" "ADAT_41.dbf" "AKODOK.dbf" "GIROSZLA.dbf" "SZAMLAK.dbf" "UTAL.dbf" "ADAT_31.dbf" "ADAT_47.dbf" "ARCTSZEM.dbf" "KIMUTAT.dbf" "SZLAK.dbf" "UTAL_KOD.dbf" "ADAT_32.dbf" "ADAT_50.dbf" "ATFUT.dbf" "KIVKOD.dbf" "SZORZO.dbf" "ADAT_33.dbf" "ADAT_57.dbf" "BEHAJT.dbf" "KONYV.dbf" "SZSZAMOK.dbf" "ADAT_34.dbf" "ADAT_70.dbf" "BM_70.dbf" "KT_KOD.dbf" "TBEV.dbf" "ADAT_35.dbf" "ADAT_71.dbf" "CSBESZED.dbf" "MEGJEGYZ.dbf" "TELEPH.dbf" Fontos! Az alkalmazásnak hozzá kell férnie az Onkado rendszer adatfájljaihoz. Ehhez vagy ki kell lépni az Onkado programból a konvertálás idejére, vagy az Onkado rendszer adatfájljainak másolatát tartalmazó könyvtárat kell beállítani a konvertáláshoz. Hiba esetén figyelmeztető üzenet jelenik meg a nem elérhető adatbázisokról. Ebben az esetben célszerű a kijelölt mappába újra betölteni az önkormányzat napi mentését, vagy az ONKADO mappából újra átmásolni az ott található fájlokat. A következő képeken a fájlok hiányára, vagy hozzáférhetetlenségére felhívó hibaüzenet és a felületen megjelenő figyelmeztető ikonok láthatóak: 7 / 19

Az érvényes ONKADO adatokat tartalmazó könyvtár kiválasztása esetén nincs hibaüzenet, valamint az adatfájlok mellett az adott adatfájl utolsó módosításának dátuma is megjelenésre kerül. Az alkalmazással lehetőség van egyszerre több adóhatóság különböző beállításait is kezelni. 8 / 19

Az Adóhatóság nevéhez alapértelmezetten az utoljára betöltött települést hozza a program. Az alapértelmezetten betöltött település beállítása a OnkadoValtozoMegfeleltetes.xlsx információs tábla ikonra kattintva törölhető. Az adatmigráció során néhány önkormányzat specifikus adat nem kerül át automatikusan az ASP Adó rendszerbe, ugyanis azok nyilvántartására az ONKADO rendszer nem használ külön adatbázist. Ilyen adat például a polgármester neve, az önkormányzat járáskódja, költségvetési fizetési számlaszáma, a területérzékenységi szorzó, az idegenforgalmi adó adómegállapítás módja, stb. Annak érdekében, hogy a migráció során ezek az adatok is átkerülhessenek, készült egy OnkadoValtozoMegfeleleltetes.xlsx elnevezésű táblázat, ahol az említett adatok manuálisan rögzíthetőek. Az információs táblázat része a migrációs segédeszköznek, így a többi fájllal egy időben az is letöltődik. 9 / 19

Az önkormányzatoknak csak a táblázat Változó értéke oszlopát van lehetőségük kitölteni, a többi rekord védett állapotban található, nem módosítható! Fontos! A polgármester nevét és a járáskódot értelemszerűen kell kitölteni. Mindkét adat később az ASP Adó rendszerben is módosítható. A bankszámlaszámnak 2x8 vagy 3x8 számjegyből kell állnia, minden egyéb írásjeltől (pl. gondolatjel, szóköz) mentesen. A Felettes szervhez annak nevét kell beírni (pl. Pest Megyei Kormányhivatal). Amennyiben az önkormányzatnál nincs bevezetve idegenforgalmi adó, a változó értékénél akkor is 3 szerepeljen. A területérzékenységi szorzó értékét akkor is ki kell tölteni, ha az önkormányzatnál nincs talajterhelési díj fizetésére kötelezett adózó. A szorzó értéke 1, 1,5 vagy 3 lehet. A FORCE_MIGRATION változó értéke 0 legyen. Fontos! Ez az adatállomány változó értékét tekintve csak minta adatokat tartalmaz, nem önkormányzati adatokat! Aktualizálása, önkormányzati adatokkal történő feltöltése mindenképp szükséges! Az adatok megadását és azok mentését követően, hasonlóan az első lépéshez, nincs más teendő, mint a Fájl kiválasztása gomb használatával megadni a változó megfeleltetés táblázat elérési útvonalát. 10 / 19

Fontos! A migrációhoz szükséges OnkadoValtozoMegfeleleltetes.xlsx táblázat átnevezése meghiúsítja a folyamat sikeres lefutását, ezen kívül a táblázatot az adatok kitöltését követően csak bezárt állapotban lehetséges a tömörítő alkalmazásba betallózni! Migrációs adatcsomag célkönyvtárának meghatározása A konvertálás és tömörítés előtt, az utolsó elvégzendő feladat a célkönyvtár kijelölése. 11 / 19

A Cél kiválasztása gomb megnyomására megjelenő felületen kiválasztható a migrációs adatcsomag tömörített állományának helyéül szolgáló mappa. Az ikonnal új mappa hozható létre, amennyiben korábban nem került erre a célra létrehozásra külön mappa: A célmappát (pl. onkado\xml) a legelső alkalommal az ügyintézőnek szükséges létrehozni és kijelölni. A többkörös migráció során az alkalmazást ajánlott azonos, változatlan környezeti paraméterekkel (forrás- és célmappa meghatározás) futtatni, a paraméterek egy konfigurációs fájlban megőrzésre kerülnek. Konvertálás, tömörítés A Konvertálás, tömörítés nyomógomb megnyomásával indítható a migrációhoz szükséges adatállományok konvertálása és tömörítése. Az elkészült állomány megnevezése tartalmazza az 12 / 19

adóhatóság nevét, valamint a tömörítés időpontját. A sikeres műveletről az alkalmazás információt küld: Migrációs állomány feltöltése, migráció indítása Az elkészített csomag feltöltését és az azt követő adatmigrációt, az ASP Adó migráció rendszerbe történő bejelentkezés után a Környezet/Adóhatóság/Migráció menüpontban van lehetőség megkezdeni. Migrációs fájlok feltöltése, kitömörítése és konzisztencia ellenőrzése Az XML-eket tartalmazó fájl kiválasztását a Fájl kiválasztás, feltöltés blokkban található Tallózás gomb segítségével lehetséges megtenni. Miután kiválasztásra került a migrációs adatcsomag, a Fájl feltöltése gombra kattintva a program feltölti, majd kitömöríti a ZIP állományt és megvizsgálja, az XML fájlok teljes körűségét is. 13 / 19

A migráció indítása Az XML fájlokat tartalmazó mappa kitömörítését követően, a Migráció indítása gomb megnyomásával megkezdődik az állományok betöltése az ASP Adó rendszerbe: Fontos! A Migráció véglegesítése bizonyos feltételekhez kötött, melyek teljesülésekor aktívvá, megnyomhatóvá válik a gomb. A migráció alatt a rendszer folyamatos státuszjelentést biztosít az ügyintéző számára: 14 / 19

A migráció lefutását követően a rendszer tájékoztatást nyújt a folyamat kimenetelére, illetve a betöltés időtartamára vonatkozóan. Sikeres betöltés esetén a státusznál a Success felirat, sikertelen lefutás esetében pedig a hiba részletezése kerül megjelenítésre a migrációs felület Státusz blokkjában. A betöltés sikerességéről a rendszer elektronikus üzenetet is küld a bejelentkezett felhasználó által megadott e-mail címre. Bejelentkezés az ASP Adó rendszer migrált adatbázisába, migrációs listák letöltése Bejelentkezés az ASP Adó rendszer migrált adatbázisába A betöltött adatok az ASP Adó program migrációs felületén csak akkor érhetők el, ha a migráció során nem volt Adattisztítás és adathiba szűrés oldali kritikus hiba (azaz futtatásra került az Adattranszformációs rész is). A sikeres migráció után javasolt kilépni, majd néhány percet követően visszalépés után megtekinthetők lesznek a betöltött adatok. Fontos, hogy a betöltés a próbamigrációk során a 2. pontban megjelölt Adó migráció felületen érhető el. Az Adó gomb az éles adatbázisba navigál, ahol csak az éles migrációt (azaz a migráció véglegesítését) követően lesznek elérhetők az adatok, a véglegesítést követő napon. Az éles migráció csak az illetékes megyei igazgatóság jóváhagyását követően végezhető el, a zárási, évváltási, évnyitási munkák elvégzése után (beleértve a gépjárműadó nyitó állomány feldolgozását is). Migrációs listák letöltése A migráció során a program minden esetben riportokat készít az átadott és átvett adatokra vonatkozóan, hogy az ügyintézőknek lehetőségük legyen átvizsgálni az adatáttöltés teljes körűségét, valamint javíthassák az adathibákat. Ezek a riportok a folyamat lefutását követően a migrációs felületen válnak elérhetővé Excel formátumba exportálható módon. A riportokon felül letölthető még 15 / 19

a migráció elvégzéséről szóló Migrációs jegyzőkönyv is. Lehetőség van továbbá az összes riport letöltésére tömörített állományként (Migrációs riportok letöltése). A fájlok letöltése/megnyitása megegyezik. A linkre kattintva a felugró ablakban választható ki a táblázatok megnyitásának módja. Migrációs log A migráció futási folyamatának részletes státuszolását tartalmazza. Célja, hogy a migráció futásának megszakadása esetén információkat nyújtson a fejlesztők részére. 16 / 19

Migrációs adathibák A Migrációs adathibák riport (TELEPÜLÉSNÉV_Migrációs adathibák_dátum_idő.xlsx) a migrációs folyamat során jelentkezett adathibákat, adathiányokat tartalmazza. A Címlapon összegző kimutatás készül adattáblánként az előforduló típushibákról, a hiba- és figyelmeztetéstípusokról, az előfordulások számának feltüntetésével. (Munkafázis, Hibás adattábla, Hiba típusa, Hiba leírása, Hibasorok száma) A többi munkalapon (Adat ellenőrzés; Adattisztítás, adathiba szűrés munkalap; Adattranszformáció, áttöltés munkalap) részletes kimutatás található a hibás vagy figyelmeztetéssel érintett rekordokról. A részletes kimutatás adathibái könnyen megfeleltethetők a migrációs állomány megfelelő tételeivel. A jelre kattintva tételesen kibonthatók, a gombokkal csoportosan lenyithatók, illetve összecsukhatók a sorok. Ajánlott a következő kijelölt cellák - Hibás adattábla, Hiba típusa, Hiba leírása, Hibás adatmező, Mutató, Eredeti rekord azonosító - szűrését engedélyezni. A szűrő engedélyezése után pl. a Hibás adattábla oszlopfejléc nyílgombjára kattintva egyetlen adattáblára vonatkozó szűrőt pl. Vállalkozói adatok (TBEV) táblát választhatunk az oszlophoz. A hibajelentés alapján elkezdhető, illetve folytatható a migráció szempontjából kritikus, a forrásrendszerben javítható adathibák felszámolása. Fontos! A hibák osztályozása súlyosság és fontosság szerint: Kritikus hiba (esetében a migrációs folyamat kritikus hibára futott, javítása feltétlenül szükséges) Adathiba figyelmeztetés (Az ilyen jellegű hibák esetenként hibás működést eredményezhetnek, de javításuk időben nem sürgető, az elvégezhető a célrendszeri migrációt követően, az éles üzemi működés keretében is.) Információ (tájékoztatást nyújt pl. bizonyos adatok betöltésének sikerességéről) Ellenőrző lista ONKADO Az ellenőrző riport (TELEPÜLÉSNÉV_Összehasonlítás ellenőrző lista.xlsx) az ONKADO programból konvertálásra került fontosabb adatok összegzését tartalmazza (pl. törzsadatok, adónem adatok, pénzügyi adatok összegzése). 17 / 19

Ellenőrző lista ASP.Adó ASP ellenőrző lista (TELEPÜLÉSNÉV_ASP.Adó összehasonlítás ellenőrző lista_dátum_idő.xlsx) a transzformáció után a célrendszerbe betöltött adatok összegzését tartalmazza (felépítése alapvetően megegyezik az Ellenőrző lista ONKADO riportéval). Összehasonlító lista Az Ellenőrző lista Onkado és az Ellenőrző lista ASP.Adó eredményeit veti össze, és megjeleníti az esetleges eltéréseket, megkönnyítve ezzel az adatok ellenőrzését az éles migráció előtt. Adattisztítási jelentés Az adattisztítási jelentés (TELEPÜLÉSNÉV_ Adattisztítási jelentés _DÁTUM_IDŐ.xlsx) összefoglalóan tartalmazza az önkormányzat, a migrációt végző felhasználó nevét, a futtatás időpontját, valamint a felmerült hibákat. A jelentés a pályázati forrással támogatott migrációs feladat elvégzését alátámasztó dokumentum. 18 / 19

Adattisztítás oldali kritikus hibák: A migrációs adathibák riportból az adattisztítás és adathiba szűrés munkafázison belül a kritikus hibák és azok száma soronként felsorolva. Adattranszformáció oldali kritikus hibák: A migrációs adathibák riportból az adattranszformációs, áttöltés munkafázison belül a kritikus hibák és azok száma soronként felsorolva. Adatellenőrzés oldali kritikus hibák: A migrációs adathibák riportból az Adat ellenőrzés munkafázison belül a kritikus hibák és azok száma soronként felsorolva. Amennyiben az ellenőrzések során az adatáttöltés megfelelőnek bizonyult, a migrációs felületen található Migráció véglegesítése gombbal véglegesíthető az adatmigrációs folyamat. Fontos! A gomb lenyomását követően már nem lesz lehetőség újabb adatcsomag betöltésére és migrálására. A megnyomás után beütemezésre kerül az adatok áttöltése a migrációs linkről az éles adatbázisba. (Ez rendszerint éjjel történik meg, azaz a megnyomás utáni napon már a sima linken is látható lesz a migrált adatbázis.) A migráció véglegesítése csak akkor lehetséges, ha a zárás, és a kivetéses adónemek terhelése megtörtént. A gomb megnyomása a próbamigrációk során az éles indulásig, a jegyzői jóváhagyásig TILOS! Jegyzői elfogadó nyilatkozat A jegyzői elfogadó nyilatkozat aláírásával a jegyző nyilatkozik arról, hogy az Önkormányzat az Adó szakrendszer vonatkozásában eleget tett a kötelezettségeinek. 19 / 19