A BEJELENTÉS FORMAI KÖVETELMÉNYEI

Felsıoktatási Információs Rendszer
Országos Felsıoktatási Információs Központ
A bejelentés formai követelményei Verzió: 1.0; Kiadás dátuma: 2006. október 3.
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
A BEJELENTÉS FORMAI KÖVETELMÉNYEI
KONCEPCIÓ
A rendszerek egymással alapvetıen XML üzeneteken keresztül kommunikálnak. A
kommunikáció típusa szerint adatközlı (ideértve az értesítést és választ is) és lekérdezı üzeneteket
különböztetünk meg. Az adatközlésért és adatszolgáltatásért egyaránt vállalni kell a felelısséget,
ezért bizonyíthatónak kell lenni, hogy az adatközlés kitıl származik, valamint, hogy az adatközlés nem
sérült-e meg. Ennek megfelelıen az adatközlı- és adatszolgáltató XML üzenetek digitálisan
hitelesített változatát elektronikusan alá kell írni.
Erre alkalmas a http://www.w3.org/2000/09/xmldsig# XML névtér. A W3C ajánlása az alábbi
helyen található: http://www.w3.org/TR/xmldsig-core/. Ez a struktúra írja le, hogy az aláírás hogyan
ellenırizhetı, azaz tartalmazza az aláíráshoz használt kivonatképzési algoritmust, aszimmetrikus
aláírás algoritmusát, esetlegesen az aláírás ellenırzéséhez szükséges nyilvános kulcsot. Utóbbival
nem élünk, mert az üzenetküldésre jogosultak teljes körének nyilvános kulcsa rendelkezésre áll
központilag, az üzenetbıl a küldı személye kiolvasható. Ebben a dokumentumban nem az aláírási
technikára, hanem az adatközlés formájára fókuszálunk.
Az üzenetek formai helyességének biztosítására valamennyi üzenettípusra XML-sémát
definiálunk. A séma lehetıséget ad arra, hogy a formailag hiányos, szabálytalan üzenetek
feldolgozása ne történjen meg. A sémák publikációra kerülnek a beküldı rendszerek felé.
Tekintve a hálózati hibák és a megbízhatóság kérdését, a kommunikáció alapjául szolgáló
csomagok maximális mérete korlátozva lesz (a pontos adat a különbözı tesztek futása után kerül
megállapításra).
A TARTALMI RÉSZ FELÉPÍTÉSE
Az üzenet váza egy Konténerbıl áll, mely fej és törzs elemeket tartalmaz. A fej rész az
azonosításhoz szükséges adatokat tartalmazza, míg a konténer törzse egy, vagy több üzenetet. Az
üzenet fej része azonosító jellegő adatot tartalmaz, illetve leírja, hogy milyen típusú üzenetrıl van szó.
– a kommunikáció alapja a kérelem; a FIR központi rendszerében minden beérkezı
XML üzenet kérelmekre bontódik. A kérelmek azonosítására hármas azonosító
rendszer került bevezetésre: Kontener (az ehhez tartozó azonosító képzésérıl
késıbb lesz szó), Uzenet (ez egy Kontener-en belül futó számozással képzıdik) és
Rekord (ez egy Uzenet-en belül futó számozással képzıdik),
– egy üzenetcsomagba („Kontener”) több különbözı üzenet
(/Kontener/KontenerTorzs/Uzenet) is bekerülhet (ez akkor fontos, ha a tranzakció
költsége nem teszi optimálissá az üzenetek egyesével történı küldését),
– az üzenet típusa (/Kontener/KontenerTorzs/Uzenet/UzenetFej/Tipus) egyértelmően
meghatározza, hogy milyen üzenetspecifikus sémaellenırzés hajtandó végre az
üzeneten,
– az üzenettörzs (/Kontener/KontenerTorzs/Uzenet/Uzenet/UzenetTorzs) tartalmazza
az üzenetspecifikus adattartalmat.
Az egyes adatközlések, lekérdezések az üzenetek törzsében térnek el egymástól. A
következı összefoglaló megmutatja az üzenetek típusait.
Adatközlés
Üzenettípus
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
– 1 –

Felsıoktatási Információs Rendszer
Országos Felsıoktatási Információs Központ
A bejelentés formai követelményei Verzió: 1.0; Kiadás dátuma: 2006. október 3.
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
Adatközlés
Hallgatói jogviszony létrehozása
Hallgatói jogviszony megszüntetés
Hallgató személyi és egyéb adatok
módosítása
Hallgatói jogviszony karbantartása
Oktatói jogviszony létrehozása
Oktatói jogviszony megszüntetés
Oktató személyi és egyéb adatok
módosítása
Oktatói jogviszony karbantartása
Stornó kérelem
Válaszüzenet *
Értesítés üzenet *
Üzenettípus
HJVL
HJVM
HSZE
HJVK
OJVL
OJVM
OSZE
OJVK
STRN
FIRV
FIRE
A * –gal jelölt típusok a FIR-bıl érkeznek az intézményekbe.
ADATSZOLGÁLTATÁS – HALLGATÓI JOGVISZONY LÉTREHOZÁSA
Minden esetben, amikor az intézmény új jogviszonyt létesít egy hallgatóval, vagy egy
hallgató új képzésre (ezen belül idıszakra vagy szakirányra), doktori iskolába vagy kollégiumba
iratkozik be, ilyen típusú kérelmet kell küldeni.
A bejelentéshez kötelezı a személyre vonatkozó azonosító adatok kitöltése. Amennyiben
az intézmény nyilvántartásában már szerepel a hallgató, az azonosító adatok között az Oktatási
Azonosító megadása kötelezı.
Egy bejelentéskor egy hallgatóhoz a következı adatok jelenthetık be:
– hallgatói jogviszony, ezen belül több képzés. Egy adott képzéshez maximum 1
idıszak jelenthetı be, egy idıszakhoz pedig bármennyi szakirány.
– vendéghallgatói jogviszony
– doktorjelölti jogviszony
– kollégiumi tagsági jogviszony
ADATSZOLGÁLTATÁS – HALLGATÓI JOGVISZONY MEGSZÜNTETÉS
Minden esetben, amikor az intézmény egy hallgatóval létesített jogviszonyt, vagy egy
hallgató egy képzését (ezen belül idıszakot vagy szakirányt), doktori iskolai vagy kollégiumi tagságát
kívánja lezárni, ilyen típusú kérelmet kell küldeni.
Amennyiben egy jogviszonyhoz tartozó összes képzés, doktori iskolai vagy kollégiumi
tagság megszőnik vagy lezárul, a jogviszony automatikusan lezárul.
A hallgató azonosításához a HallgAzon tag megfelelı információit kell kitölteni. A hallgató
jogviszonyát a szervezet azonosítója, a jogviszony típusa és a jogviszony kezdetének dátuma
azonosítja.
ADATSZOLGÁLTATÁS – HALLGATÓ SZEMÉLYI ÉS EGYÉB ADATOK MÓDOSÍTÁSA
Az adatok módosítása érintheti a hallgató személyes adatait, illetve a kapcsolódó adatokat
(címek, elérhetıségek, okmányadatok, fogyatékosság adatai).
A hallgató azonosításához a HallgAzon tag megfelelı információit kell kitölteni.
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
– 2 –

Felsıoktatási Információs Rendszer
Országos Felsıoktatási Információs Központ
A bejelentés formai követelményei Verzió: 1.0; Kiadás dátuma: 2006. október 3.
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
ADATSZOLGÁLTATÁS – HALLGATÓI JOGVISZONY KARBANTARTÁSA
adatait.
Az adatok módosítása érintheti a jogviszony, képzés, doktori iskolai vagy kollégiumi tagság
A hallgató azonosításához a HallgAzon tag megfelelı információit kell kitölteni. A hallgató
jogviszonyát a szervezet azonosítója, a jogviszony típusa és a jogviszony kezdetének dátuma
azonosítja. A kiválasztott jogviszonyon belül a típustól függıen további azonosítók megadása
szükséges (pl. hallgatói jogviszonynál képzés esetén a képzés kódja és a kezdés dátuma).
ADATSZOLGÁLTATÁS – OKTATÓI JOGVISZONY LÉTREHOZÁSA
Minden esetben, amikor az intézmény új jogviszonyt létesít egy oktatóval, vagy egy oktató új
munkakörbe kerül, ilyen típusú kérelmet kell küldeni.
A bejelentéshez kötelezı a személyre vonatkozó azonosító adatok kitöltése. Amennyiben
az intézmény nyilvántartásában már szerepel az oktató, az azonosító adatok között az Oktatási
Azonosító megadása kötelezı.
Egy bejelentéskor egy oktatóhoz legalább 1 munkakört meg kell adni.
ADATSZOLGÁLTATÁS – OKTATÓI JOGVISZONY MEGSZÜNTETÉS
Minden esetben, amikor az intézmény egy oktatóval létesített jogviszonyt, vagy egy oktató
egy munkakörét kívánja megszüntetni, ilyen típusú kérelmet kell küldeni.
Amennyiben egy jogviszonyhoz tartozó összes munkakör megszőnik vagy lezárul, a
jogviszony is lezárul. Amennyiben egy jogviszony lezárásra kerül, a hozzá kapcsolódó összes
munkakör is lezárul.
Az oktató azonosításához az Azonosito tag megfelelı információit kell kitölteni. Az oktató
jogviszonyát a szervezet azonosítója és a jogviszony kezdetének dátuma azonosítja.
ADATSZOLGÁLTATÁS – OKTATÓ SZEMÉLYI ÉS EGYÉB ADATOK MÓDOSÍTÁSA
Az adatok módosítása érintheti az oktató személyes adatait, illetve a kapcsolódó adatokat
(címek, nyelvtudás, nemzetközi tagság, szakképesítések, tudományos címek).
Az oktató azonosításához az Azonosito tag megfelelı információit kell kitölteni.
ADATSZOLGÁLTATÁS – OKTATÓI JOGVISZONY KARBANTARTÁSA
Az adatok módosítása érintheti a jogviszony vagy a munkakör adatait.
Az oktató azonosításához az Azonosito tag megfelelı információit kell kitölteni. Az oktató
jogviszonyát a szervezet azonosítója és a jogviszony kezdetének dátuma azonosítja.
ADATSZOLGÁLTATÁS – STORNÓ KÉRELEM
A stornó kérelem egy jogviszony létrehozásának (hallgatók esetében hallgatói, doktorjelölti,
kollégiumi jogviszony, képzés, idıszak vagy szakirány; oktatók esetén pedig oktatói jogviszony vagy
munkakör) visszavonására használható üzenet. A visszavonandó jogviszonyra annak egyedi
azonosítójával lehet hivatkozni, emellett a visszavonás indokának kitöltése is kötelezı. A stornó
kérelmek nem kerülnek automatikusan elfogadásra. Fontos különbség a jogviszony lezárásához
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
– 3 –

Felsıoktatási Információs Rendszer
Országos Felsıoktatási Információs Központ
A bejelentés formai követelményei Verzió: 1.0; Kiadás dátuma: 2006. október 3.
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
képest, hogy a stornó kérelem elfogadása esetén a stornózott jogviszony létrehozása törlıdik a
rendszerbıl, míg a jogviszony lezárása esetén a hallgató vagy oktató történeti adataiban megmarad a
lezárt jogviszony.
Stornó kérelem kizárólag a fent említett jogviszony létrehozás visszavonására alkalmazható.
Személyes adat módosítás visszavonására nincsen lehetıség. A személyes adatok változása a
hallgató vagy oktató történeti adatai között mindig megmarad.
ADATSZOLGÁLTATÁS – VÁLASZÜZENET
A beérkezett üzenetek feldolgozásáról státusz jellegő üzenetet kap vissza az üzenet
küldıje. Ez a válasz vonatkozhat a konténerre (pl. érvénytelen aláírás), vonatkozhat az egyes
üzenetre (pl. jogosulatlan üzenettípus beküldés), vagy vonatkozhat az egyes tételre (pl. sikeres
jogviszony létrehozás). A séma lehetıvé teszi, hogy egy válaszüzenetbe különbözı típusú és számú
válaszok kerüljenek.
Amennyiben a válaszüzenet hibát jelez (erre utal a ValaszFej-ben található ValaszKod
mezı is, amely értéke SZÓTÁR-ból kerül ki), a ValaszTorzs-ben megtalálható a hiba leírása, valamint
a hibás paraméterekrıl szóló felsorolás.
ÉRTESÍTÉS ÜZENET
Az értesítés üzenet az OFIK irányából szolgáló adatterítésekre vonatkozik, amely érintheti
az intézménnyel hallgatói vagy oktatói jogviszonyt létesített emberek személyes adatait, valamint a
FIR rendszer Intézménytörzs adatbázisának tábláit is (utóbbiak közé tartozik a már több helyen
említett SZÓTÁR tábla is).
LEKÉRDEZÉS KÉRELEM, VÁLASZ ÜZENET
A késıbbiekben készülni fog egy fıleg statisztikai célokat szolgáló kérelem típus is,
amelyben megfelelı jogosultsággal rendelkezı emberek elıre megadott kérdéseket tehetnek majd fel
a FIR rendszernek.
MAGYARÁZAT AZ XSD DEFINÍCIÓKHOZ
Az XSD minták felépítésérıl, kialakításáról a 2. számú melléklet tartalmaz további
információt, amely az ütemtervben meghatározottak alapján jut el az intézményekhez.
___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________
– 4 –