NMHH tervazonosító és OAuth token beszerzése

Megjegyzés:  Az ebben a fejezetben bemutatott funkcionalitás ESZTER tervezői programtól független.

A tervezés megkezdéséhez szükséges az NMHH tervazonosító (Terv ID ) és OAuth token páros megléte.

Új tervazonosító igénylése felület
Új tervazonosító igénylése felület

Mindkettő az Adatkapu Új tervazonosító igénylése felületen keresztül szerezhető be (az adatkapu használatához szükséges feltételek megléte mellett).

Új tervazonosító igénylés után a felület "Sikeres igénylés leadás" visszajelzést ad. 

Sikeres igénylés leadás
Sikeres igénylés leadás

A tervazonosító igényléshez kapcsolódó log esemény a felületen megtekinthető.

Tervazonosító igénylés log
Tervazonosító igénylés log
Log esemény részleteinek megtekintése
Log esemény részleteinek megtekintése

Sikeres tervazonosító igénylést követően az Ügyfélkapu tárhelyre üzenet kerül kiküldésre a tervazonosító igénylésről, mely tartalmazza Oauth tokent.

Sikeres tervazonosító igénylés üzenet
Sikeres tervazonosító igénylés üzenet

Belépés a címlekérdező szolgáltatás oldalára

A kapott NMHH tervazonosító és OAuth token páros megadásával lehetséges a belépés https://cim.geoxapi.com oldalon. A bejelentkező képernyőn adhatja meg a felhasználó az azonosításhoz szükséges adatokat (érdemes azokat vágólapról bemásolni), majd a Belépés gombra kell kattintania.

Címlekérdező szolgáltatás bejelentkezés
Címlekérdező szolgáltatás bejelentkezés

Helyesen megadott adatok esetén megjelenik a belépés gomb alatt egy tájékoztató szöveg, hogy sikerült az azonosítás, amelyet követően a felhasználó átirányítódik a lekérdező oldalra.

Címlekérdező szolgáltatás - sikeres azonosítás
Címlekérdező szolgáltatás - sikeres azonosítás

Rossz adatok esetén pedig a sikertelenségről tájékoztató szövegbuborék jelenik meg.

Címlekérdező szolgáltatás - sikertelen azonosítás
Címlekérdező szolgáltatás - sikertelen azonosítás

Lekérdezés menete

Belépést követően egy egyszerű felületen három legördülő menüből lehet választani. Első a megye választó, második a település, harmadikkal pedig szabályozható, hogy milyen formátumban kerüljön letöltésre adat.

A letölteni kívánt települést a megye választóval kell előszűrni.

Megye választó
Megye választó

Megye kiválasztását követően listázódnak az adott megyében található települések.

Település választó
Település választó

Település kiválasztását követően három formátum választható:

  • CSV - pontosvesszővel tagoltan, UTF8 karakterkódolva tárolja az adatokat
  • TXT - Tabulátorral tagoltan, UTF8 karakterkódolva tárolja az adatokat
  • SQLite - Platformfüggetlen adatbázis-kezelő formátum

A lekérdezés indítása gomb segítségével elküldhető minden kitöltött adat. Válaszul pedig a böngésző felajánlja mentésre (vagy megnyitásra) a kiválasztott formátumú fájlt, amely tartalmazza az adott település címeit.

Lekérdezési korlátozások

Adott tervazonosítóval történő települések lekérdezhetősége korlátozva van. A gyakorlatban ez azt jelenti, hogy egy tervazonosítóval egy település és annak egy szomszédos települése kérdezhetőek le. Akár többször is, viszont a korábban lekérdezett település kérdezhető le újra. Másik település nem választható helyette. Első lekérdezésre bármelyik település választható. Másodikra már csak az elsőként választott valamely szomszédos települése. Harmadik és vagy sokadik lekérdezésre az első két alkalommal választott települést ajánlja fel a rendszer.

Naplózás

A rendszer tárolja a sikeres belépések időpontját hozzátartozó IP címmel együtt. Továbbá a sikertelen próbálkozásokat és a sikertelen próbálkozások alkalmával megadott adatokat, hogy a próbálkozások számát korlátozni tudja. A lekérdezések korlátozása érdekében pedig tárolva van, hogy egy adott tervazonosítóval milyen adathozzáférések történtek.

A fentebb felsorolt adatok korlátlan ideig tárolásra és a rendszer helyes működésének érdekében felhasználásra kerülnek. Harmadik fél számára nem kerülnek átadásra.

Kilépés

Lekérdezések végeztével a jobb felső sarokban található tervazonosítóra kattintva jön elő a kijelentkezés gomb, melyre kattintással befejezhető az aktuális munkamenet.

Kijelentkezés gomb
Kijelentkezés gomb