ELEKTRA Fejlesztő ű ő ű ő - ksh.hu

1 ELEKTRA Fejleszt i t j koztat Jelen dokumentum a KSH ELEKTRA rendszer hez adatszolg ltat st fejleszteni sz nd koz k sz m ra ny jt technikai magyar zatot az adatszolg ltat sokat tartalmaz import llom nyok szakszer el ll t s hoz. Az ELEKTRA rendszer haszn lata egyedi k rd vek kit lt s re p l. Egy k rd v p ld ny az egyes adatgy jt sek (OSAP-ok) adott t rgyid szak szerinti, meghat rozott adatszolg ltat j l beazonos that besz mol si egys g re s r szegys g re vonatkoz inform ci k sszess g t tartalmazza. A k rd vek kit lt beli megjelen s t, az sszegy jtend adatok le r s t (t pus, rt kk szket, kit lthet s g, stb.), az elv gzend ellen rz seket, illetve a k rd vhez kapcsol d s g /kit lt si tmutat hivatkoz sokat OSAP-onk nt egyetlen llom ny foglalja ssze, amit a rendszerben "k rd vsablon"-nak h vunk. A k rd vsablonok XML form tumban tartalmazz k a kit lt program vez rl s hez sz ks ges inform ci kat. A kit lt program ezek alapj n ll tja el a felhaszn l k sz m ra az adatok bevitel re szolg l fel letet, de a rendszerhez kapcsol d fejleszt k is ennek az rtelmez s vel tudj k a helyes import llom nyokat el ll tani.

2 A sablonok rtelemszer en az egyes adatgy jt sek eset ben elt r ek, viszont a k rd vsablont le r XML llom nyok sturkt r ja szabv nyos XSD-nek megfelel en p l fel (l sd a mell kelt " " llom nyt), gy az egyes sablonok b rki ltal logikusan rtelmezhet ek, felhaszn lhat ak az implement ci eszk zeit l s nyelv t l f ggetlen l. A k rd vsablon eset ben ir nyelv, hogy azok a tulajdons gok ker lnek bele, amik az alap rtelmezett jellemz kh z k pest elt r en vannak be ll tva. Az ELEKTRA rendszerbe egy b informatikai rendszerekb l XML llom nyok felhaszn l s val lehet adatot beimport lni. Ezeket az llom nyokat a tov bbiakban "adat XML" n ven hivatkozzuk. A k rd v kit lt program is ilyen adat XML-eleket ll t el az egyes k rd vek kit lt sekor. Az adat XML kezel s t az egyes adatgy jt sekn l haszn lt k rd vsablonok vez rlik. Az adat XML-ek strukt r ja egys ges logik j (a mell kletk nt csatolt XSD szerint, l sd a mell kelt " " llom nyt), ugyanakkor OSAP-onk nt v ltoz konkr t strukt r j.

3 Az adat XML-ek bels fel p t se a a k rd vsablon elemz s vel ll that el . Az adat XML-ek k telez en utf-8 k dol ssal kell k sz ljenek. A k rd vek fel p t s nek alapelvei A kit lt st t mogat grafikai elemekt l eltekintve minden k rd v tetsz leges sz m fejezetb l s azon bel l tetsz leges sz m s bonyolults g egyedi beviteli mez b l, vagy t bl zatnak l tsz komponensstrukt r b l ( s azok ism tl d seib l (~t bl zat soraib l)) ll. A rendszer t bl zatokat csak az adat XML-eken bel l kezel, val j ban az sszetartoz adatokat csoportos tja, s ezek ism tl d se eset n az sszetartoz mez kb l sorokat k pez, amiket t bl zatokban fog ssze. Az ism tl d sek eset ben egyedileg szab lyozott viselked s k rd se, hogy a KSH ltal el zetesen megszem lyes t ssel l trehozott ism tl d sek (sorok) mellett van-e az adatszolg ltat nak joga j sorokat hozz adni, vagy a megszem lyes tettekb l kit r lni. Azokban az esetekben, ahol nem foglalhat ssze egyetlen t bl zatban az ism tl d adatok k re, a rendszer lehet s get ad eg sz fejezetek t bb p ld nyban val ism tl d s re.

4 Ez logikailag a t bl zat soraival anal g tervez si minta, csak egy magasabb szinten. A fejezetek ism tl d s nek viselked se a t bl zat sorok ism telhet s g vel azonos m don szab lyozhat egyedileg. Az adat XML-ben az egyes strukt r k a k vetkez szab lyok szerint k pz dnek le a k rd vsablon alapj n: 11) A k rd v p ld ny fejezeteinek megfelel en az adat XML-ben pontosan megegyez sz m <fejezet> p ld ny tal lhat . 2) Minden egyes kit ltend komponens vagy sorsz m (att l f ggetlen l, hogy rejtett-e) mez <adat> tagk nt ker l le r sra. Ezen bel l mindig 3 elem tal lhat : -azonosito: megmutatja hogy a k rd vsablon melyik konkr t komponens b l sz rmazik az adat -oszlop: megmutatja a KSH h tt rrendszereiben az adatt rol s azonos t j t -ertek: a konkr t beviteli mez ben r gz tett adattartalom. Az adat elem tartalmaz egy attrib tumot is "f" n ven mely az adatok forr s t mutatja. A KSH ltal el k sz tett adatok eset n rt ke "M", ezt az adat XML-ben k telez megtartani.

5 Adatszolg ltat k ltal kit lt tt adatok eset n az "f" attrib tumot nem szabad megadni. 3) Az <adat> tag-ek t bl zatokba, s azokon bel l sorokba szervez dnek az al bbi esetekben: -ism tl d st tartalmaz panelekn l: minden panel ism tl d s p ld ny egy-egy sort hoz l tre a t bl zatban -rekordmutat s panelek: az ugyanolyan rekordmutat rt kkel rendelkez kit lthet komponensek k peznek egy-egy sort a t bl zatban -adat sszevon s t bb panelb l: az sszevon sra megjel lt panelen bel li tov bbi gyerekpanelekb l nem k l n-k l n t bl zat k pz dik, hanem a k z s sz l re hivatkoz ssal egyetlen nagy t bl zatt llnak ssze az egyes gyerekek ism tl d sei (esetleg rekordmutat alapj n sz rmaztathat sorai). Ut bbi kett r l r szletesen: itt . (Adat XML strukt r ja) 4) A fenti t bl zatos t s egym sba gyazott strukt r kn l is lehets ges. Az gy l trej v adat XML-ek megfelel s ge tekintet ben j kiindul si alapot jelent a rendszerb l az egyes k rd vekhez kapcsol d adat XML-ek kiexport l s val kinyerhet llom ny.

6 Az adat XML-ben a kit lt sb l sz rmaz adatokon k v l el fordulhatnak olyan mez k s adatok amiket a KSH megszem lyes t ssel t lt fel az egyes k rd vp ld nyokba. Ezek a rendszerb l kiexport lt adat XML-ekben az <adat> tagben f="M" attrib tummal ker lnek megjel l sre. Ezeket importb l nem lehet m dos tani, viszont aki a k rd vsablonban defini lt ellen rz sek/sz mol sok futtat s t tervezn k ls rendszerben, annak sz molnia kell azzal, hogy ezek az adatok is sz ks gesek lehetnek. K l n sen fontos megeml teni, hogy a k rd vek sszep ros t s ra szolg l mez k szint n megszem lyes t ssel ker lnek az egyes k rd vp ld nyok adat XML-j be. Ezeket felt tlen l reproduk lni kell a k ls rendszerekb l sz rmaz adat XML-ek eset ben is annak rdek ben, hogy az import l s sor n a rendszer befogadja az llom nyokat. Ezek a mez k k telez en az el lap fejezetben tal lhat ak az al bbi "oszlop" tulajdons ggal (a mez azonos t ja elt rhet, de jellemz en az is megegyez az oszlop tulajdons ggal): Mez oszlopneve Mez le r sa MC01 OSAP sz m MEV T rgy v MHO T rgyh M003G Adatszolg ltat KSH t rzssz ma M003 Besz mol si egys g azonos t ja (t rzssz m) MV42 Besz mol si r szegys g azonos t ja 2 Bizonyos adatgy jt sekn l el fordulhat, hogy az MV42 rt ke res, a t bbi esetben kell rt ket tartalmaznia az el lapnak.

7 Az el ll tand adat XML f jlok elnevez s t a k vetkez konvenci k szerint kell megtenni: OSAP megjelen s n lk l: "adat_[OSAP k d 4 karakteren]_[t rgy v 2 karakteren]_[f jl egyedi gyf loldali azonos t ja, mely nem tartalmazhat al h z s karaktert].xml" pl: Enn l az elnevez si konvenci n l alap rtelmezetten 0-s OSAP megjelen st felt telez nk. OSAP megjelen ssel: "adat_[OSAP k d 4 karakteren]_[t rgy v 2 karakteren]_[OSAP megjelen s]_[f jl egyedi gyf loldali azonos t ja, mely nem tartalmazhat al h z s karaktert].xml" A rendszer az adatszolg ltat oldali f jln v r szlettel nem foglalkozik, korl tokat nem ll t, de a felhaszn l i oper ci s rendszer megk t seit figyelembe kell venni. Az eddig le rt ltal nos elveken s specifik ci kon k v l a fejleszt i t j koztat egyedi ig nyek szerint tartalmazza m g a k vetkez ket: Az ig nyelt adatgy jt sekhez egy-egy k rd vsablon llom ny, f jlok neve: <osapsz m>_<t rgy v>_<v ltozat>.xml Az ig nyelt adatgy jt sekhez egy-egy technikai pdf llom ny, ami vizu lisan szeml lteti a k rd v strukt r j t, s az egyes beviteli mez kh z tartoz oszlop tulajdons got.

8 Term szetesen ez a sablon XSD alapj n a k rd vsablonb l kinyerhet inform ci . Javaslatok adat XML gener l shoz Mindig gyelj nk az UTF-8-as akarkter k dol sra. C lszer nem a teljes adat XML gener lni, hanem az ELEKTRA -b l let lteni a KSH ltal el k sz tett adat XML-t s azt minta sablonk nt haszn lva kit lteni. Az elk sz lt adat XML-en a alapj n c lszer s ma ellen rz st v gezni. Az adat XML ELEKTRA rendszerbe import l sakor c lszer a k rd vet az ELEKTRA -ban megnyitva a "Felt lt s adat XML-b l" funkci val import lni, majd a k perny n ellen rizni a k rd v kit lt tts g t. 3 Mell kletek Adat XML strukt r ja Ellen rz sek s sz mol sok Adat komponensek fizikai le r sa Adat XML s ma K rd vsablon komponensek fizikai le r sa K rd vsablon XML s ma f jl f jl 4