Aadressiandmete süsteem. Spetsifikatsioon

Väljavõte

1 AS Datel

2 Versioonid Kuupäev Koostaja Selgitus Kadri Ollo Algversioon Kadri Ollo Projekti kontrollversioon Kadri Ollo Sisse viidud parandused ja täpsustused kliendi tagasiside põhjal Kadri Ollo Alustatud 3. etapi täienduste sisseviimist, ADS halduse rakenduste osa viidud teise dokumenti Kadri Ollo Sisse viidud tellija märkused ja kommentaarid Kadri Ollo Koostatud 3. etapi üleandmiseks lõplik versioon Kadri Ollo Täiendatud mitteametlike andmete kontseptsiooniga Kadri Ollo Lisatud järgnevussuhete arvutamise osa Kadri Ollo Täiendatud X-tee teenuste osa Kadri Ollo Täiendatud normaliseerija osa Kadri Ollo Täiendatud ADS kontseptuaalse mudeli muutmise (AKOM) projekti I etapist tulenevate muudatustega Kadri Ollo Lõplik versioon AKOM projeti I etapi kohta Kadri Ollo AKOM II projekti rames tehtud täiendused Kadri Ollo Korrigeeritud kliendi märkuste ja tähelepanekutega Kadri Ollo Täiendatud ADSAR I etapi muudatustega Kadri Ollo Täiendatud ADSAR II etapi muudatustega Kadri Ollo Muudatused ADSAR2 projekti raames Maarja Mahlapuu, Pille Kosk X-tee teenuste väljade nimetuste korrastamine vastavalt tehniliste nimedele. Peatükkidest on eemaldatud järgmised kasutusest mahaläinud teenused: Aadressiobjekti andmete salvestamise teenus - ADSobjsalv.v1 Aadresside otsing komponentide alusel - ADSkompotsing.v1 Aadresside otsing teksti alusel - ADStekstotsing.v1 Teavitusteenus aadressi probleemide kohta - ADSprobleemid.v1 Mitteametlike aadresside päring teksti alusel - ADSmaadrotsing.v1 Mitteametlike objektide ja aadresside muudatuste päring - ADSmamuudatused.v Kadri Ollo Täiendatud teenuse 5.5 Objekti muudatuste päring kirjeldust Kadri Ollo Täiendatud teenuse 5.12 Liidestujate aadresside tagasiside teenuse päringu ja väljundi kirjeldust Kadri Ollo Lepingu 11/2016 REGREL-i läbiviimiseks vajalikud arendused raames tehtud muudatused Keiti Pärn Vea 134 ja 135 kirjelduse täiendamine Keiti Pärn Avalike väljavõtete struktuuride värskendamine seoses oleku veeru eemaldamisega 1. ja 5. väljavõttest Keiti Pärn V6 X-tee teenuste täiendamine (failipõhiste teenuste lisandumine) Keiti Pärn Täpsustus sama aadressitekst, aga erinev ADR_ID kohta Keiti Pärn Teenuste ADSobjotsing ja ADSobjmuudatused kirjelduste parandamine Keiti Pärn Teenuse ADSmenadresit kirjelduse parandamine Kadri Ollo Uus teenus Ajaloolise aadressiobjekti otsing Kadri Ollo Täiendatud HAMI raames arendatud funktsionaalsusega Kadri Ollo X-tee teenused täiendatud sihtnumbrite, mitteametlike piirkondade ja POI andmetega Kadri Ollo Muudetud teenuste tehnilise täitmise juhend AS Datel /226

3 Kadri Ollo RAAS2 projekti muudatused AS Datel /226

4 Sisukord 1. SISSEJUHATUS OTSTARVE MÄÄRATLUSED JA LÜHENDID VIITED Esitusviis ÜLEVAADE SÜSTEEMI ÜLDKIRJELDUS ARHITEKTUUR JA TEHNILINE LAHENDUS Tehniline platvorm PÕHISÜSTEEMI MÕISTED Aadressiobjekti liigid Atribuudid Ärireeglid Aadressiobjekt Atribuudid Ärireeglid Objekti aadressid Aadressikomponent Aadressikomponentide tasandid Komponentide seos aadressiobjektidega Atribuudid Ärireeglid Sünonüümid Koha-aadress Aadressi seisundid Teksti genereerimine Aadressi kood Aadressi koordinaadid Ruumiaadress Mitteametlikud andmed Aadresside sidumine mitteametlike piirkondadega Seotud objektid ja objektiperekonnad Seotud objektid Objektiperekond Objektide seose arvutamise ärireeglid ADS süsteemis Objektiga seotud huvipunktid (POI) Unikaalaadressi nõue UN-alad UN tunnuse omistamise ja eemaldamise põhjused UN-tunnuse automaatne muutmine UN-tunnuse käsitsi muutmine Kohanime tunnus Kohanime tunnuse automaatse omistamise reeglid Kohanime tunnuse kaasnev muutmine komponendi juures Kohanime tunnuse import objektidele Sihtnumbrid SIHN-alad Sihtnumbrite omistamise andmevahetus Sihtnumbri omistamine uuele aadressile Sihtnumbri muutmine aadressil Sihtnumbri probleemide analüüs Aadressiobjektide täiendavad andmed MENETLUSSÜSTEEMI MÕISTED Menetlusprotsess Andmete parandus (P) Andmete muudatus (M) Topoloogia korrastus (T) Automaatne muudatus (A) Menetlejad AS Datel /226

5 Õigused ANDMEMUDEL PÕHISÜSTEEMI PROTSESSID AADRESSIOBJEKTI ESITAMINE Aadressiobjekti lisamine Aadressiobjekti versioonimine Aadressiobjekti versiooniparandus Aadressiobjekti tühistamine Aadressiobjekti taastamine TEGEVUSED AADRESSIGA Esitatud aadressiandmete analüüs Normaliseerimine Aadressi salvestus Normaliseeritud aadressi salvestus Normaliseerimata aadressi salvestus Aadressiteksti genereerimine Kehtetu objektiversiooni aadressi seoste tühistamine Aadressi muutumise sündmuste logi Aadressi esinduspunkti määramine TEGEVUSED AADRESSIKOMPONENTIDEGA Aadressikomponentide initsialiseerimine Komponendi lisamine Komponendi versioonimine Initsialiseerivate seoste tühistamine Komponendi tühistamine Aadressikomponendi muutumise sündmuste logi Järeltegevus komponendi lisamise korral Järeltegevus komponendi versioonimise korral Järeltegevus komponendi kehtetuks muutumise korral Sünonüümide lisamine Aadresskomponendi korrektsuse kontroll Pühendusnimede käsitlus TEGEVUSED RUUMIAADRESSIGA JÄRGNEVUSSUHETE ARVUTAMINE AADRESSIOBJEKTI PROBLEEMID Käsitsi lisatavad probleemid Probleemidega tutvumine registris Probleemidega tutvumine kaardil Liikluspindade ja väikekohtade probleemid ETAK MUUDATUSTE KÄSITLEMINE ADS-S ETAK hooned ja maa-alused hooned ETAK ja ADS kujude võrdlus ETAK muudatuste töötlemine Muudatuste logi ETAK süsteemi jaoks LOGIDE JÄRELTÖÖTLEMINE Täielik järeltöötlus Kiire järeltöötlus ANDMETE AVALIKUSTAMINE MENETLUSSÜSTEEMI KASUTUSLOOD MENETLUSE LOOMINE Menetluse loomine kasutajaliidese kaudu Menetluse loomine X-tee teenuse kaudu Menetluse loomine ADS süsteemi poolt Menetluste kustutamine OBJEKTIDE LISAMINE MENETLUSSE Objektide lisamine otsinguga Seotud objektide kiirlisamine Objektide tõstmine ühest menetlusest teise Objektide lisamine kaardiaknast AS Datel /226

6 4.2.5 Objektide import menetlusse Objektide kuvamine menetluses Objektide grupeerimine automaatsetesse menetlustesse ANDMETE ESITAMINE EHR-ST Hoonete tühistamine Hooneosa samasuse tuvastamine EHR esitatud kuju alusel hoonete automaatne ühendamine ANDMETE MUUTMINE MENETLUSES Muudatuse õiguslik alus Kujude sisestamine Kuju metaandmed Aadresside muutmine menetluses Aadresside sisestus Aadressi lisamine menetluses Aadressi muutmine menetluses Aadressi eemaldamine menetluses Aadressi taastamine menetluses Hooneosa aadressi automaatne muutmine Aadressi lisamine kuju alusel Aadressipunkti muutmine Hoone osade lisamine Hoone osade muutmine Objektide ühendamine KONTROLLID OBJEKTIDE MENETLEMISEL Menetluse ja objektide üldised probleemid Ruumilise paiknemisega seotud probleemid Aadressiga seotud probleemid Komponentidega seotud probleemid ETAK süsteemiga ühildumise probleemid Ainult menetluse sees kontrollitavad probleemid Seotud objektide leidmise reeglid Probleemide lahendamine menetluses Veateadete ajutine mitteaktuaalseks märkimine Menetluse andmete kontroll MENETLUSE JÕUSTAMINE Menetluste saatmine ülevaatuseks Jõustamine kasutajaliidesest Jõustamine X-tee kaudu AADRESSI MUUDATUSVAJADUSTE TUVASTAMINE Asendava aadressi leidmine VOLITUSED Volituse sisestamine TEENUSED AADRESSIKOMPONENTIDE KEHTIVA SEISU PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine AADRESSIKOMPONENTIDE KLASSIFIKAATORI MUUDATUSTE PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine AADRESSIKOMPONENTIDE KLASSIFIKAATORI MUUDATUSTE PÄRING FAILINA Sisend Väljund Funktsionaalsus Tehniline täitmine AADRESSIOBJEKTI OTSING Sisend AS Datel /226

7 5.4.2 Väljund Funktsionaalsus Tehniline täitmine AADRESSIDE OTSING Sisend Väljund Funktsionaalsus Tehniline täitmine OBJEKTI MUUDATUSTE PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine OBJEKTI MUUDATUSTE PÄRING FAILINA Sisend Väljund Funktsionaalsus Tehniline täitmine AADRESSI MUUDATUSTE PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine AADRESSI MUUDATUSTE PÄRING FAILINA Sisend Väljund Funktsionaalsus Tehniline täitmine OBJEKTI AADRESSIDE MUUDATUSTE PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine OBJEKTI AADRESSIDE MUUDATUSTE PÄRING FAILINA Sisend Väljund Funktsionaalsus Tehniline täitmine AADRESSTEKSTI NORMALISEERIMINE Sisend Väljund Funktsionaalsus Tehniline täitmine TÜHISTATUD OBJEKTI JÄRGLASTE PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine TÜHISTATUD AADRESSI JÄRGLASTE PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine RUUMIAADRESSI PÄRING Sisend Väljund Funktsionaalsus Tehniline täitmine LIIDESTUJATE AADRESSIDE TAGASISIDE TEENUS Sisend Väljund Funktsionaalsus AS Datel /226

8 Tehniline täitmine LIIDESTUJATE AADRESSISOOVITUSTE TEENUS Sisend Väljund Funktsionaalsus Tehniline täitmine ADS GAZETTEER OTSING Sisend Väljund LOG-ID VÄÄRTUSTE PÄRINGUTEENUS Sisend Väljund Funktsionaalsus Tehniline täitmine AJALOOLISE AADRESSIOBJEKTI OTSING Sisend Väljund Funktsionaalsus AADRESSIOBJEKTI ESITAMINE Sisend Väljund Funktsionaalsus MITTEAMETLIKE PIIRKONDE ESITAMINE MENETLUSSÜSTEEMI TEENUSED MENETLUSOBJEKTI AADRESSIDE ESITAMINE Sisend Väljund Funktsionaalsus MENETLUSOBJEKTI OTSING Sisend Väljund Funktsionaalsus MENETLUSOBJEKTI TÄPSUSTAMINE Sisend Väljund Funktsionaalsus NORMALISEERIJA REEGLID SOOVITUSED JA PIIRANGUD NORMALISEERIMATA AADRESSITEKSTILE EHAK normaliseerimine Paralleelaadresside töötlemine Ühe aadressi normaliseerimine TÜHISTATUD KOMPONENTIDE, AADRESSIDE JA OBJEKTIDE JÄRGNEVUS NÄITED OBJEKTIDE TÜHISTAMISE KOHTA EHAK objektid EHAK kuuluvuse muutmine Ruumiaadresside tühistamine Väikekoha objektid Väikekoha tühistamine EHAK muudatuse tõttu Väikekoha aadressi ümberkorraldamine Väikekoha aadresside järgnevus Liikluspinna objektid Liikluspinnad on registreeritud topelt Liikluspinna aadresside ümberkorraldamine Tühistatud tänav kolib teise EHAK üksusesse EHAK muudatuse tõttu tühistatud tänav Omavalitsusliku linna vallasiseseks linnaks muutumine Väikekoha muudatuse tõttu tühistatud tänav Tühistatud tänava ruumikuju langeb kokku kehtiva tänavaga Järgnevus seotud objektide aadresside alusel AS Datel /226

9 Ilma järglaseta tänavad Liikluspinna aadresside järgnevus Menetlusobjektide järgnevus Katastriüksuste järgnevus Hoonete järgnevus taseme aadresside järgnevus Aadresside järgnevus objekti tühistamise korral KOMPONENTIDE JA AADRESSIDE TAASTAMINE OBJEKTI JÄRGNEVUSTE ARVUTAMISE PROTSESSI KIRJELDUS AADRESSI JÄRGNEVUSTE ARVUTAMISE PROTSESSI KIRJELDUS MÕÕDISTUSANDMETE IMPORTFAILI KIRJELDUS NÄITED VÄLJAVÕTTED VÄLJAVÕTETE HÄÄLESTAMINE VÄLJAVÕTETE TOOTMINE Tootmine KOV-de lõikes VÄLJAVÕTETE KASUTAMINE VÄLJAVÕTETE NIMEKIRI Kehtivad aadressikomponendid Kehtivad ja endised aadressikomponendid Tühistatud komponendid koos kehtivate järglastega Komponentide sünonüümid Jõusolevad aadressiobjektid Jõusolevad aadressiobjektid koos aadressidega Tühistatud aadressiobjektid Kehtivad komponendid ja neid initsialiseerivad objektid Aadressid koos komponentide ja ajalooga Tühistatud aadressid koos kehtivate järglastega Haldusreformi perioodil muutunud aadressiobjektid Haldusreformi käigus muutunud aadressid RUUMIANDMETE VÄLJAVÕTTED LIIDESTUJATE TAGASISIDE LIIDESTUJA ANDMETE KÄSITLUS ADS SÜSTEEMIS LIIDESTUJA ANDMETE ESITAMINE ADSI Andmete esitamine X-tee teenuse kaudu Andmete esitamine csv-formaadis LIIDESTUJA ANDMETE KONTROLLIMINE JA PROBLEEMIDE TUVASTAMINE HUVIOBJEKTI LISATUNNUSED ADS SÜSTEEMIS Tunnuste äriloogika SPV-tunnus MSL-tunnus Probleemne Parandatud Lisatunnuste import Lisatunnuste käsitlus huviobjekti uuel esitamisel SOOVITUSED LIIDESTUJA OBJEKTIDELE Soovituste automaatne lisamine Soovituste käsitsi lisamine Soovituste eemaldamine LIIDESTUJATELE ADS SÜSTEEMIS TAGASISIDE ANDMINE AS Datel /226

10 1. Sissejuhatus 1.1 Otstarve Käesoleva dokumendi otstarve on spetsifitseerida ADS süsteemi tervikfunktsionaalsust, kõigi arendusetappide lõplikku tulemust. Anda ülevaade süsteemi mõistetest, põhiprotsesside toimimise loogikast, esitleda süsteemi poolt pakutavaid X-tee teenuseid. ADS süsteemiga liidestujatele on 2013 aasta mais koostatud eraldi ADS-iga liidestumise juhend, mis sisaldab endas lihtsustatud ülevaadet ADS süsteemist. Samuti saab ADS-i kohta lugeda ADS-i käsiraamatust ( Ka käsiraamatus on käsitletud ADS-iga liidestumise teemat. Käesolev dokument on orienteeritud eelkõige süsteemi tellijale (Maa-ametile), kuid sobib ka neile liidestujaile, kel on sügavam huvi ADS süsteemi protsesside suhtes. 1.2 Määratlused ja lühendid Mõiste, lühend ETAK LHR ADS KNR Selgitus Eesti topograafiliste objektide andmekogu ADS-i liikluspindade haldamise register Aadress süsteem Kohanimede register 1.3 Viited [1] Leping 97/2007 i täiendused Maa-amet, OÜ e-hange. [2] Leping 18/2008 i täienduste 3. etapp Maa-amet, OÜ e- hange. [3] Leping 112/2009 i tarkvara täiendamine Maa-amet, AS Datel [4] Leping 8/2009 i haldussüsteemi kasutusvõimaluste suurendamine Maa-amet, AS Datel [5] Leping 67/2011 i kontseptuaalse mudeli muutmise (AKOM) I etapp Maa-amet, AS Datel [6] Raamleping 67/2012 i arendustööd (ADSA) Maa-amet, Keskkonnaministeerium, AS Datel [7] Leping 178/2012 i tööprotsesside optimeerimine, menetlusrakenduse ja X-tee teenuste täiendamine (ADSAR) Maa-amet, AS Datel Esitusviis >P viide jooksva alajaotuse punktile P, nt >12.2.3; [D] viide dokumendile, kus D on dokumendi jrk loetelus, nt [1]; ([D] P) viide dokumendi D pealkirjale või alajaotusele P, nt (1.4 Ülevaade) või ([1] 2.7). 1.4 Ülevaade i arendamise I etapis (2007) realiseeriti see Maaregistri juurde. II etapis üldistati käsitlust ning laiendati ADS suuremale hulgale AS Datel /226

11 aadressiobjektidele, mis võivad pärineda erinevatest registritest. III etapis täiendati olemasolevat funktsionaalsust. Alates aastast toimunud ADS arendus pole enam etappideks jagatud. Lepingu [3] raames lisandus ADSi mitteametlike aadresside käsitlus ning sellega kaasnevad täiendused äriloogikas. Lepingu [4] raames töötati välja järgnevussuhete arvutamise põhimõtted, täiendati oluliselt normaliseerija reegleid, et oleks võimalik paralleelaadresside eristamine sisestatud tekstis ning lõdvendati sisendtekstile seatud piiranguid. Lisandus komponentide keelelise korrektsuse kontroll, täiendati aadressivigadest teavitamise süsteemi. Lepingu [5] (2011.a.) raames muutub ADS teiste andmekogude tugisüsteemist iseseisvaks registriks. Kui seni toimus aadressiandmete teke ning muutmine üksnes teiste registrite kaudu, siis nüüd tuginedes Ruumiandmete seadusele hakkab ADS menetlema kõiki katastriüksuste, hoonete ning hooneosade koha-aadresse. Alates jaanuarist peavad aadressandmete muudatused olema registreeritud kõigepealt ADS süsteemis ja alles seejärel saab neid kasutada teistes registrites. Sellega seoses lisandub ADSi menetlussüsteem. Raamlepingu [6] (2012.a.) raames tellitakse täiendavaid arendusi nii ADS põhi- kui ka menetlussüsteemi osas. Menetlussüsteemi realiseerimisel selgus hulk täiendavaid vajadusi nii omavalitsustelt kui ka Maa-ameti töötajatelt menetlusrakenduse kasutajasõbralikumaks ja efektiivsemaks muutmise kohta. Teostatakse muudatusi aadressiandmete kvaliteedi tõstmise tagamiseks. Koha-aadressi esitamine, kontrollimine, registreerimine, muutmine, kehtetuks muutmine, ärireeglid kohaaadresside ja aadressiobjektide muudatuste haldamisel, koha-aadresside õigsuse kontrolli täiendamine. Vastavalt tööde kirjeldustele täiendatakse ADS-i andmebaasi, ärireegleid, X-tee ja avalikke teenuseid, tõstetakse kasutajamugavust nii avalike rakenduste kui suunatud rakenduste osas. Lepingu [7] (2013.a.) puhul on prioriteediks aadressiandmete korrastamine, et tagada kooskõla ja nõuetele vastavus erinevates registrites. Seda massilist andmekorrastust peab toetama kasutajasõbralik ja efektiivne rakendus, mis suudab suure osa rutiinset käsitööd kasutaja eest ära teha. Seda kõike selleks, et andmekorrastus edeneks võimalikult kiiresti ja edukalt. Aruannete mooduli abil tagatakse ka andmete korrastusprotsessidest ülevaade ning toetatakse andmete korrastamise korraldamist (sh rahastamist). ADSga liidestumine muudetakse kasutajatele mugavamaks. Täiendatakse X-tee teenuseid, koostatakse liidestumise juhend koos näidisjuhtumitega, kuidas on võimalik ADS i andmeid teistes infosüsteemides kasutada. Tänu liidestujatele saab ADS reaalselt funktsioneerida, nii nagu ta algselt oli planeeritud (kõigi teiste andmekogude tugisüsteemina). AS Datel /226

12 2. Süsteemi üldkirjeldus 2.1 Arhitektuur ja tehniline lahendus Ärireeglid ADS süsteem jaguneb 2 ossa: põhisüsteem ja menetlussüsteem. AS Datel /226

13 Põhisüsteem ehk tuum sisaldab ADS kehtivaid andmeid koos ajalooga. Teatud objektide kohta (EHAK objektid, kohanimed) esitatakse aadressandmed otse põhisüsteemi. Need objektid määravad aadresside algusosa. Menetlussüsteemi kaudu hakkavad kohalikud omavalitsused haldama ülejäänud objektide (katastriüksused, hooned, hooneosad) aadresse. Menetlussüsteem sisaldab muutmisele võetud objekte ja aadresse, menetlusprotsessi kirjeldavaid andmeid ning ärireegleid menetluse läbiviimiseks ja lõpetamiseks. Menetluse lõppemisel kirjutatakse muudetud andmed ümber põhisüsteemi ja menetlusse jääb viit põhisüsteemis olevale versioonile. Perioodiliselt toimub muudetud andmete ülekanne ADS esitlussüsteemi. Soovituslikult võiks see toimuda kord ööpäevas. Esitlussüsteem sisaldab kõiki Maaameti avalikuks kasutuseks mõeldud andmeid, muuhulgas ka ADS andmeid. Esitlussüsteemi kantakse ainult ADS põhisüsteemi andmed. Menetlussüsteemist lisandub vaid teadmine läbiviidud ja pooleli menetluste kohta. ADS avalikud rakendused: X-GIS kaardiliides, päringumoodul ja avalikud X-tee päringuteenused kasutavad esitlussüsteemis olevaid andmeid. Tuleb arvestada, et võrreldes andmete tootmisega esineb teatav viivitus, enne kui muudetud andmed avalikkusele kättesaadavaks saavad. See viivitus on vastavalt vajadustele häälestatav ning ei tohiks ületada 1 ööpäeva. Esitluskeskkonnas on tagatud andmete pidev kättesaadavus, rakenduste pidev ja katkematu töötamine. Tehniliste tõrgete korral võib edasi lükkuda muudatuste ülekanne esitlusse ning tekib tavapärasest suurem viivitus andmete värskenduse osas, kuid teenused ja rakendused on pidevalt kättesaadavad. Menetlussüsteemi rakendus ning menetlussüsteemiga suhtlevad X-tee teenused töötavad otse tootmissüsteemi andmete peal. Tootmiskeskkond peab üldjuhul samuti pidevalt tõrgeteta töötama, kuid seal on lubatud ajutised kuni 4 tunni pikkused katkestused süsteemi hooldustööde tegemiseks töövälisel ajal Tehniline platvorm ADS andmebaas toimib kahes eraldiseisvas serveris, millest üks on tootmiskeskkond (ADS põhi-ja menetlussüsteem) ning teine esitluskeskkond. Mõlemad keskkonnad kasutavad Oracle 11gR2 andmebaasitarkvara. Replikatsioon toimub Oracle tarkvaraliste vahendite abil automaatselt ning replikatsiooni sagedus on süsteemi administraatorite poolt häälestatav. Menetlussüsteemi kasutajaliides on veebipõhine asp.net ver 3.5 platvormil põhinev rakendus. Kasutamine on tagatud järgmiste internetisirvijate versioonidega: InternetExplorer vers MozillaFirefox vers Google Chrome vers 11 Uuemate internetisirvijate versioonide lisandumisel võib tekkida vajadus kohendada tarkvara AS Datel /226

14 2.2 Põhisüsteemi mõisted Aadressiobjekt maaga seotud objekt, millele on antud aadress. Aadressiobjektil on alati olemas 1 konkreetne ruumikuju ning temaga on alati seotud 1 või mitu aadressi. Initsialiseeriv aadressiobjekt - aadressiobjekt, mille järgi luuakse ja muudetakse aadressikomponente. Aadress - objekti asukohta osutav kirje või tunnus objekti leidmiseks geograafilises ruumis. Koha-aadress objekti asukohta kirjeldav tekst. Normaliseeritud koha-aadress kindlatest komponentidest koosnev ja ärireeglitele vastav tekstiline aadress. Aadressi komponent normaliseeritud aadressi osa, mille väärtus (nimi) tuleneb initsialiseeriva aadressiobjekti nimest või aadressist. Lähiaadress - koha-aadressi haldus- ja asustusüksusest täpsem osa. Lähiaadress koosneb väikekoha olemasolul selle nimest koos liigisõnaga, aadressiobjekti nimest või liikluspinna nimest, liikluspinna liigisõnast ja aadressinumbrist koos vajalike lisanditega. (vt täiendavalt ADS-i käsiraamatust) Koodaadress normaliseeritud aadressi komponentide koodidest moodustatud aadressi üheselt identifitseeriv tunnus. Ruumiaadress - aadressiobjekti arvutuslik (analüütiline) aadress, mis saadakse aadressiobjekti ruumikujude ja haldus- ning asustusüksuste ruumikujude analüüsimisel. Ruumiaadress koosneb haldus- ning asustusüksuste nimedest koos liigisõnadega ning vastavatest ruumilise osakaalu protsentidest 0,01% täpsusega. Aadressipunkt aadressi ruumilist asukohta väljendav punkt. Aadressipunkt peab asuma pindobjekti korral selle sees või joonobjekti korral joone peal, punktobjekti korral vastavas punktis, täpsusaste määratakse ärireeglitega. Koordinaataadress - aadressi ruumilist asukohta ning ulatust väljendav ala, mis esitatakse MBR (minimaalne piirnev ristkülik minimal bounding rectangle) kujul. Paralleelaadress sama aadressiobjektiga seotud erinevad aadressid. Mitteametlikud aadressiandmed - aadressiandmed, mida ei kasutata kohaaadressides ning mis ei osale aadresside normaliseerimises, kuid mida kasutatakse inimeste omavahelises suhtluses objekti asukoha leidmisel. Mitteametlikud aadressiandmed võivad olla seostatud üksikobjektiga (näiteks hoonega) või ka piirkonnaga (näiteks asum, mida ei ole Eesti haldus- ja asustusüksuste klassifikaatorisse kantud). Teeregistris olevate teede adresseerimise loogika ei kandu ADS süsteemi seni teostatud realiseerimisprojektide käigus. Seetõttu ADS ei tegele mõistetega joonaadress, punktaadress ja marsruutaadress teederegistri tähenduses. Samuti jääb ADS-i seni teostatud arendusetappidest välja mõiste postiaadress, mis sisaldab ühe komponendina ka postiindeksit, vajadusel veel ka sidejaoskonna nimetust või numbrit ning postkasti numbrit. AS Datel /226

15 2.2.1 Aadressiobjekti liigid Kood Nimetus Unik Init tase Min Max Orig register tase tase MK maakond TRUE maaregister OV omavalitsus TRUE maaregister AY asustusüksus TRUE maaregister LO linnaosa TRUE maaregister LP liikluspind TRUE LP register VK väikekoht TRUE VK register CU maaüksus FALSE 6, 7, maaregister EE elukondlik hoone TRUE 6, 7, ehitisregister ME mitteelukondlik hoone FALSE 6, 7, ehitisregister ER eluruum TRUE ehitisregister MR mitteeluruum TRUE ehitisregister Rajatisi ja muinsuskaitseobjekte seni ADS-le reaalselt ei esitata aasta alguses on loobutud teeregistri teede (TT) kandmisest ADS-i aastal on kavas loobuda ka kohanime (KN) objektidest Atribuudid KOOD 2 tähega väljendatav liigi kood. Uuele liigile omistab koodi süsteemiadministraator NIMETUS objektiliigi nimetus UNIK tunnus, kas objektiliigi aadress peab olema unikaalne, st 2 samaliigilisel objektil ei tohi esineda sama aadress INIT_TASE komponentide tasandid, mida see objektiliik võib initsialiseerida (uusi komponente luua). MIN_TASE minimaalne tasand, milleni selle objektiliigi aadress normaliseeritud kujul peab ulatuma MAX_TASE maksimaalne tasand, milleni selle objektiliigi aadress normaliseeritud kujul võib ulatuda ORIG_REGISTER andmeid esitava originaalregistri tunnus. Igal objektiliigil saab olla ainult 1 päritoluregister, kus objekti andmeid hallatakse Ärireeglid Aadresside unikaalsuse nõue ei ole alati objekti liigiga määratud. Seepärast kehtestatakse ADS-süsteemis täiendavad ärireeglid aadresside unikaalsuse kontrollimisel nende objektiliikide korral, kus klassifikaatoris ei esine aadressi unikaalsuse nõuet. Kõik elamud, eluruume sisaldavad hooned, juriidiliste isikute asukohahooned, postisüsteemis osalevad hooned peavad omama unikaalaadressi. Ülejäänud (näiteks abihooned) ei pea omama unikaalaadressi Maaüksuste unikaalaadressi nõue sõltub asukohast, mida on võimalik ruumianalüüsiga kindlaks teha kui maaüksus asub tiheasustuses, siis peab aadress olema unikaalne. Kuni tiheasustuse alad puuduvad süsteemist, ei ole võimalik seda rakendada. Seni tuletatakse unikaalsuse tingimus tärkandmete AS Datel /226

16 alusel. Kui normaliseeritud aadress sisaldab liikluspinna nime ning krundi numbrit (5. ja 7. tasandi komponente), siis peab ta olema unikaalne, samuti siis, kui ta sisaldab väikekoha nime ja krundinumbrit (4. ja 7. tasandi komponente). Reeglina võib kõigil objektidel esineda mitu koha-aadressi, st paralleelaadressid on lubatud. Erandina on lubatud ainult 1 aadress EHAK objektidel: maakond, omavalitsus, asustusüksus ja linnaosa (see nõue on alati täidetud). Kuigi ka hoone osadel (eluruumidel ja mitteeluruumidel) peaks olema ainult üks aadress, võib olla ainult üks aadress, ei ole see alati täidetud. Rööpnimede (nt Noarootsi valla külade nimed) olemasolul peab ametlik nimi kajastama mõlemat nime. Normaliseeritud aadress peab olema esitatud vähemalt min-tasandini ja ei tohi olla täpsem kui max-tasand. 1 5 tasandi initsialiseerimisel peab vastav tasand aadressis määratud olema. 1 5 tasandit initsialiseerivad objektid ei tohi omada normaliseerimata aadresse Aadressiobjekt Atribuudid Aadressiobjekti peamised atribuudid on nimi, ruumikuju ja aadressid. Nime objekti juures eraldi ei hoita, vaid ainult objekti aadressi sees (initsialiseerival tasandil). ADS süsteem soovib sisendiks ainult kehtivaid või ootel seisundis aadressiobjektide andmeid. Tühistatud või vananenud andmeid ADS täiendavalt ei registreeri, need tekivad muudatuste puhul ADS süsteemi sees. ADOB_LIIK aadressiobjekti liigi kood. ADS_OID ADS sisene objekti identifikaator, identifitseerib objekti üle kõikide liikide. Kood koosneb 10 sümbolist: 2 esimest on objektiliiki väljendav tähtedest koosnev lühend ning 8 numbrit, mis genereeritakse süsteemi poolt. ADS_VERS - aadressiobjekti versiooni identifikaator, unikaalne võtmeväli ORIG_TUNNUS objekti identifikaator või tunnus originaalregistris. Identifitseerib objekti liigi piires. Unikaalne kehtivate versioonide hulgas koos liigi tunnusega. TAHIS hooneosade tähis. Omistatakse hooneosadele EHR süsteemis ning laekub ADS süsteemi ainult EHRst. ADS seda ei muuda ega kasuta. EHR registriga mitte seotud hoonosadel tähist ei ole. TEKKIMISE_ALUS objekti versiooni tekkimise õiguslik alus KEHTIV_ALATES objekti versiooni jõustumise õiguslik kuupäev SULGEMISE_ALUS versiooni sulgemise õiguslik alus (järgmise versiooni olemasolul selle tekkimise alus) KEHTIV_KUNI - objekti versiooni sulgemise õiguslik kuupäev (järgmise versiooni olemasolul selle tekkimise õiguslik kuupäev) OLEK ehk seisund. K (kehtiv) tegemist on looduses reaalselt eksisteeriva objektiga, mis omab ka päritoluregistris kehtivat staatust, kui tas vastav seos on olemas. O (ootel) tegemist on projekteeritava objektiga, mida looduses valmiskujul veel ei esine, kuid millele on juba projekteeritud aadress. Ootel olekus objekt on ADS süsteemis kehtiv aadressiobjekt. AS Datel /226

17 X (tühistamise ootel) tegemist on hetkel veel kehtiva aadressiobjektiga, mille asukohta on tekkimas teine või teised sama liiki aadressiobjektid T (tühistatud) objekt on registris tühistatud kas seetõttu, et ta on lakanud eksisteerimast looduses, või seetõttu, et tegemist on olnud vigaselt registrisse kantud objektiga ja teda polegi kunagi looduses eksisteerinudki. K, O, X ja T seisundid esinevad ainult objekti viimasel kehtival versioonil. V (vana) tähistab objekti ajaloolist versiooni, samast objektist on alati olemas ka värskem versioon. TAISAADRESS objekti täisaadress optimeeritud tekstilisel kujul. Sisaldab kõiki paralleelaadresse, korduvad elemendid väljenduvad ühekordselt. LAHIAADRESS - objekti lähiaadress optimeeritud tekstilisel kujul. Sisaldab kõiki paralleelaadresse, korduvad elemendid väljenduvad ühekordselt. RUUMIAADRESS objekti ruumiaadress tekstilisel kujul GEOMETRY objekti ruumikuju KEHTIV objekti andmete ADS põhisüsteemi laekumise kuupäev, mis ühtlasi on objekti versiooni ADS jaoks kehtima hakkamise kuupäev. KEHTETU sama objekti järgmise versiooni andmete ADS-i laekumise kuupäev, mis ühtlasi on selle versiooni ADS-is kehtetuks muutumise kuupäev. Samuti objekti versiooni kehtetuks muutmise kuupäev ilma uue versiooni andmeteta. UN-TUNNUS kas aadressiobjekt on unikaalaadressi nõudega või ei. Omab sisulist tähtsust ainult hoonete ja katastriüksuste korral. Kõik ülejäänud aadressiobjektid peavad alati omama unikaalset aadressi Ärireeglid 1. Kui objekt laekub põhisüsteemi otse originaalregistrist, (2013 seisuga EHR, KNR või maakataster), siis on registreerimisel kohustuslikud identifitseeriv tunnus originaalregistris, objektiliik, versiooni tekkimise õiguslik alus ja kuupäev, kuju ning vähemalt 1 seotud aadressi olemasolu. Aadress peab olema esitatud täielikult normaliseeritud kujul Kui objekt laekub põhisüsteemi menetlussüsteemist, siis ei ole tunnus originaalregistris kohustuslik, kuna objekt võib tekkida ADSi enne kui originaalregistrisse. Muud kohustuslikud andmed pannakse paika menetlussüsteemi ärireeglitega. 2. Põhisüsteemis objekti andmete muutmiseks on 2 võimalust: olemasoleva versiooni andmete parandamine ja uue versiooni loomine. Versiooniparandamisega saab täpsustada kuju (topoloogilises ulatuses) ja parandada õiguslikku alust. Aadressi versiooniparandusega muuta ei saa. Aadressi ja kuju suuremaks muutmiseks kui topoloogilises ulatuses tuleb alati objekti versioonida. 3. Objekti versiooni tekkimise õigusliku aluse kuupäev ei saa olla varasem kui talle vahetult eelneva versiooni tekkimise alus. Võib olla sama. Samuti ei saa õiguslikul alusel olla tuleviku kuupäev andmete esitamise hetkel ka mitte ootel objekti korral Menetlussüsteemi kaudu esitatud andmete õiguslikuks aluseks on menetlus ise, juhul kui menetleja ei määra teisti. AS Datel /226

18 4. Objekti versiooni kehtivuse lõpu õiguslik alus on vaikimisi järgmise versiooni tekkimise õiguslik alus. Objekti kui terviku tühistamise õiguslik alus registreeritakse viimase versiooni juurde. 5. Versiooni kehtivuse alguseks loetakse selle versiooni põhisüsteemi kirjutamise ajahetke. See ajahetk salvestub KEHTIV andmeväljas. Versiooni lõpp on kas järgmise versiooni kehtivuse algus või objekti tühistamise ajahetk ja salvestub KEHTETU andmeväljas. Õigusliku aluse kuupäevad väljendavad andmete juriidilise kehtivuse algust ja lõppu. 6. Viimasel aktuaalsel aadressiobjekti versioonil on täidetud KEHTIV ja täitmata KEHTETU kuupäev. Aegunud versioonil on täidetud mõlemad kuupäevad. Tühistatud objekti viimasel aktuaalsel versioonil on täidetud kehtetu kuupäev Objekti aadressid ADS süsteemis käsitletakse objekti aadressidena ADS-is registreeritud, kehtivaid täielikult normaliseeritud koha-aadresse. Need esitatakse sõltuvalt objektiliigist kas andmeid haldava registri (originaalregistri) poolt või menetlussüsteemist. Põhisüsteemi saab esitada aadresse ainult normaliseeritud kujul. ADS süsteem arvutab ise objektidele analüütilise ruumiaadressi Aadressikomponent Aadressikomponendid on normaliseeritud aadressi osad. Aadress koosneb komponentidest. Ruumiandmete seaduses käsitletakse komponente koha-aadressi struktuurielementidena, Aadressikomponendid tekivad süsteemi initsialiseerivate aadressiobjektide kaudu. Komponentide muutumine toimub samuti ainult initsialiseerivate aadressiobjektide nime või aadressi muutumisel Aadressikomponentide tasandid Aadressikomponendid jaotuvad 8 tasandile. Kõik komponendid v.a 1. tasandi komponendid omavad seost mingi teise komponendiga, mille alla ta kuulub. Nii moodustavad komponendid omavahel hierarhilise, puu-kujulise struktuuri. Tase Nimetus Võimalikud ülemtasemed 1 maakond 2 omavalitsus 1 3 asustusüksus 2 4 väikekoht 2, 3 5 liikluspind 2, 3, 4 6 nimetus 2, 3, 4 7 aadressinumber 4, 5, 6 8 korterinumber 6, 7 Tasandite seosed AS Datel /226

19 Komponentide seos aadressiobjektidega Aadressiobjektid initsialiseerivad teatud tasandi aadressikomponente. Initsialiseerivad tasandid määratakse aadressiobjekti liikide klassifikaatoris. 1 5 tasandi komponenti initsialiseerib alati ainult 1 aadressiobjekt. Selle komponendi nimi on tegelikult ka selle objekti nimi. Kui see aadressiobjekti nimi muutub, siis komponent versioonitakse. Ahelreaktsioonina muutuvad kõik aadressid, mis sisaldavad muutunud komponenti. Samuti muutub komponent kehtetuks, kui teda initsialiseeriv objekt muutub kehtetuks. Ahelreaktsioonina muutuvad kehtetuks kõik seda komponenti sisaldavad aadressid. 6 8 tasandi komponentidel saab olla paralleelselt mitu initsialiseerivat objekti, näiteks katastriüksus ja hoone. Komponente ei versioonita, kui muutub üks teda initsialiseeriv objekt, vaid väärtuse (nimi või number) muutumisel luuakse alati uus komponent ja objekt hakkab initsialiseerima seda. Kui vanale komponendile rohkem enam initsialiseerivaid objekte ei jäänud, siis muutub ta kehtetuks. Kui jäi, siis jääb ka vana kehtivaks ning samuti jäävad kehtivaks kõik seda komponenti sisaldavad aadressid. Illustreeriv näide 6. tasandi komponendi muutumise kohta. AS Datel /226

20 6. tasandi komponenti nimega Metsa initsialiseerivad 3 aadressiobjekti: eluhoone, abihoone ja maaüksus. Menetlusrakenduse kaudu muudab omavalitsus maaüksuse nime Metsa asemel on nüüd nimeks Nurme. Luuakse uus 6. tasandi komponent Nurme, mida initsialiseerib maaüksus. Komponenti Metsa jäävad initsialiseerima eluhoone ja abihoone. Maaüksuse jaoks tekib juurde uus aadress. Eluhoone ja abihoone aadressid jäävad esialgu kehtima. Aadresside versioneerimist ei toimu ning hoonetele ei teki aadressi vahetamise kohustust juhul kui hoonetel ei ole ruumikuju ning ADS-is ei ole võimalik kindlaks teha kas need hooned asuvad samal maaüksusel või mitte. Juhul kui hooned ei asu samal maaüksusel siis võivad nimed olla erinevad, kui aga hooned asuvad samal maaüksusel, peab omavalitsus ka hoonete nimed muutma ühesuguseks. Initsialiseeriva objekti olek määrab ka komponendi oleku tasandi komponentide puhul sõltub komponendi olek otseselt initsialiseeriva objekti olekust tasandi puhul, kus komponendil saab olla mitu initsialiseerivat objekti, kehtivad oleku määramisel järgmised reeglid: kui vähemalt 1 komponenti initsialiseeriv objekt on kehtiv, siis on komponent kehtiv; kui kehtivaid pole, aga leidub vähemalt 1 ootel seisus initsialiseeriv objekt, siis on komponent ootel; kui komponenti initsialiseerivad ainult tühistatud objektid või ei initsialiseeri mitte ükski objekt, siis on komponent tühistatud Atribuudid Aadressikomponendi kõige peamiseks atribuudiks on nimi. TASE viit komponendi hierarhilisele tasemele. Kohustuslik. KOOD komponendi kood 32-süsteemis. Koosneb 4 sümbolist. Kehtivate versioonide hulgas unikaalne tasandi piires. Ei muutu komponendi versioonimisel. Kohustuslik. NIMETUS komponendi nimi koos liigisõna lühendiga kui liigisõna on olemas. Kohustuslik. AS Datel /226

21 NIMETUS_LIIGIGA komponendi nimi koos liigisõnaga vastavalt seaduses ettenähtud kujule. Liiginime või selle lühendi puudumisel on võrdne nimetusega. Kohustuslik. YLEMKOMP_TASE viit ülemkomponendi tasemele. YLEMKOMP_KOOD viit ülemkomponendi koodile. PYHENDUSNIMI (1 / null) märgend, kas komponendi puhul on tegemist pühendusnimega. KOHANIMI - (1 / null) märgend, kas komponendi puhul on tegemist kohanimega. OLEK (K, O, T, V) tuleneb initsialiseeriva objekti olekust. KEHTIV versiooni kehtima hakkamise aeg ADS süsteemis. KEHTETU versiooni kehtetuks muutumise aeg. Versioon muutub kehtetuks, kui tekib uus versioon või kui muutub kehtetuks viimane komponendiga seotud initsialiseeriva aadressiobjekti seos Ärireeglid Ülemkomponendi piires peab nii nimetus kui ka nimetus liigiga olema kehtivatel versioonidel unikaalne. Vastasel korral pole võimalik tagada aadressi unikaalsuse nõuet, mis on kehtestatud ADS määrusega 3 lg 5. Liigisõna puudumisel on NIMETUS ja NIMETUS_LIIGIGA võrdsed. Viimasel aktuaalsel komponendi versioonil on täidetud KEHTIV ja täitmata KEHTETU kuupäev. Aegunud versioonil on täidetud mõlemad kuupäevad. Tühistatud komponendi viimasel aktuaalsel versioonil on täidetud kehtetu kuupäev Sünonüümid Aadressikomponendil võib olla registreeritud ka mitteametlikke nimevariante, mida nimetatakse sünonüümideks. Sünonüümid seotakse komponendi kui tervikuga mitte komponendi versiooniga, st ametliku nimekuju muutumine ei pruugi kaasa tuua muudatusi sünonüümides. Sünonüüme ei versioonita. Neid saab komponendi küljest eemaldada ja lisada süsteemi äriloogikaga paikapandud juhtudel. Sünonüüme lisatakse eemaldatakse komponendi juurest aadressiobjekti andmetest sõltumata. Seda tehakse vastava teenuse vahendusel kas normaliseerija poolt või ADS rakenduse kaudu Koha-aadress Aadress koosneb kuni 8 komponendist. Reaalselt ei saa olla aadressi, millel oleks täidetud kõik 8 taset korraga Igal tasandil tohib olla ainult 1 komponent. Mõned tasandid võivad puududa, mõned tasandid võivad olla kohustuslikud. Iga objektiliigi korral on teada, millise tasandini tema aadress tohib määratud olla. Need tingimused pannakse süsteemis paika ärireeglitega. Aadress on kas normaliseeritud või mitte. Normaliseeritud aadress koosneb täielikult ainult komponentidest. Normaliseerimata aadressil võib mingi osa olla väljendatud komponentide kaudu, kuid mingi osa väljendub tekstiliselt. Selline olukord tekib juhul, kui ADS süsteem ei suuda teksti alusel tuvastada komponente. Normaliseerimata aadresse ADS vastu ei võta. AS Datel /226

22 Kehtiv koha-aadress ei tohi eksisteerida normaliseerimata kujul. Normaliseerimata võivad olla ainult ajaloolised andmed Aadressi seisundid Uut aadressi saab luua ainult kehtivatest komponentidest. Uus aadress on kohe kehtivas seisundis. Komponentide muutumisel (versioonimisel) versioonitakse ADS süsteemis automaatselt ka muutunud komponenti sisaldavad aadressid. Vananenud komponendi versiooni sisaldavad aadressid on vananenud seisundis. Aadressi seoseid objektiga automaatselt ei versioonita, seetõttu võivad jääda uued aadressi versioonid alguses ilma objekti seoseta. Objektide seose muutmiseks ootab ADS päritoluregistri kinnitust või seose muutmist menetlussüsteemi kaudu. Aadressi struktuurne koostis muutuda ei saa. Komponente pole võimalik aadressis välja vahetada, sellisel juhul on tegemist uue aadressi tekkimisega, mitte olemasoleva muutmisega. Kui komponent tühistatakse, siis tühistuvad ka komponenti sisaldavad aadressid. Tühistunud aadress võib jääda alguses mõnele objektile veel alles, ADS süsteem seda ise ei eemalda, vaid ootab päritoluregistri poolset muudatust. Kui tühistunud aadress ei esine enam mitte ühelgi jõusoleval objektil, siis lisandub aadressile täiendav tunnus seosed kadunud. See sündmus tekitab aadressile ka täiendava muudatuslogi S seosed kadunud Teksti genereerimine Komponentide nimedest on alati võimalik genereerida ärireeglite alusel korrektne tekstiline koha-aadress. Täisaadress koosneb kõikide lubatud alluvussuhtega tasandite nimedest. Lähiaadress koosneb 4 8 tasandi nimedest. Lähiaadress on kasutatav ainult koos EHAK andmetega Aadressi kood Aadressi kood ehk koodaadress koostatakse aadresside komponentide koodidest. Juhul kui aadressis mõni tase puudub, siis puuduva taseme koodi asemele kirjutatakse nullkood ehk nullidest koosnev kood (näiteks 0000 ). Üle versioonide unikaalsuse tagamiseks lisatakse ka aadressi versiooninumber Tase 1 Tase 2 Tase 3 Tase 4 Tase 5 Tase 6 Tase 7 Tase 8 Versioon AS Datel /226

23 Aadressi kood on 33 kohaline kood, kus igale tasemetele vastab järgnev arv tähemärgi kohti: Tase 1: 2 kohta Tase 2: 3 kohta Tase 3: 4 kohta Tase 4: 4 kohta Tase 5: 4 kohta Tase 6: 4 kohta Tase 7: 4 kohta Tase 8: 4 kohta Versioon: 4 kohta Näide: Normaliseeritud tekstiline koha-aadress ja selle koodaadress Läänemaa, Haapsalu linn, Sireli tn S Aadressmuster 1257 Versioonitunnus annab edasi ka aadressi olekut. Versioonitunnus 0000 on kehtival aadressil. Ajaloolised aadressid saavad versioonitunnuseks versiooni jrknr. Nii on esimesel ajaloolisel versioonil tunnuseks 9999, teisel 9998 jne. See annab võimaluse versioonide mugavaks järjestamiseks päringutes. Normaliseerimata aadressidel moodustatakse kood ainult kuni määratud tasandini. Versioone ei teki Aadressi koordinaadid Aadressipunkt väljendatakse 2-mõõtmelises L-EST koordinaatsüsteemis olevate koordinaatidega täpsusega kuni 2 kohta peale koma. Koordinaataadress väljendatakse 2-mõõtmelises L-EST koordinaatsüsteemis MBR 2 nurgapunktina (4 koordinaati). Lisaks hoitakse aadressi ja objekti seose juures ka aadressipunkti selle objekti kontekstis. Vajalik sel juhul, kui aadress on seotud mitme objektiga. Sel juhul on aadressipunkt erinev iga objekti jaoks. Aadressi juures hoitakse esimese objekti punkti. Kui aadressi juures hoitava punktiga seotud objekt muudetakse kehtetuks siis seotakse aadress sellise objektiga mis on kehtiv. Kui enam kehtivaid objekte selle aadressiga seotud ei ole, muutub ka aadress kehtetuks. Kui objekti ruumikuju muutub, siis muudetakse ka aadressipunkti koordinaate. Kui objektil on mitu aadressi (paralleelaadressi), siis on võimalik neile määrata erinev aadressipunkt Ruumiaadress Ruumiaadress on kõige täpsema EHAK tasandi aadress (enamasti 3. taseand, kuid omavalitsuslikes linnades, kus linnosasid ei ole on see 2. tasand). Ruumiaadress sisaldab lisaks tekstile ka EHAK objekti kuju ehk ruumiaadress see on aadressi tekst koos mõjualaga. Mõjualad moodustavad üle Eesti homogeense katte. Ruumiaadressid moodustatakse süsteemi poolt automaatselt ning neid versioonitakse nii EHAK komponentide EHAK objekti ruumikuju kui ka objekti kuju muutumisel. AS Datel /226

24 Ruumiaadressi kood moodustatakse esimese 3 tasandi põhjal analoogselt kohaaadressiga. Ruumiaadressile moodustatakse tekstiline väljendus samade reeglite alusel nagu ka koha-aadressi teksti moodustamisel komponentide alusel. Kõiki aadressiobjekte (v.a EHAK objekte endid ning ilma ruumikujuta objekte) adresseeritakse ka ruumiaadressiga. Aadressiobjekti seos ruumiaadressiga toodetakse ADS süsteemi poolt aadressiobjekti andmete registreerimisel. Objekti ruumikuju analüüsitakse vastu kehtivaid ruumiaadresse ning igale seosele arvutatakse ka osakaal 0,01% täpsusega. Osakaal leitakse alade puhul ühisosa pindala, joone puhul ühisosa pikkuse ja punkti puhul seotud samaliigiliste objektide arvu suhtena vastavalt objekti pindalasse, pikkusesse või 100% Mitteametlikud andmed Mitteametlike andmetena hoitakse ADS süsteemis mitteametlikke linnaosasid ja asumeid. Nende objektide haldamine toimub tegelikult KNR süsteemis. KNR süsteem esitab kõik objektidega seotud muudatused ADSi automaatselt. Üldistatult nimetatakse neid objekte ADS-s mitteametlikeks piirkondadeks. Mitteametlike piirkondade struktuur on järgmine id ADS süsteemi poolt genereeritav sisemine identifikaator, täisarv tunnus piirkonnale väliselt omistatud unikaalne tunnus, reaalselt objektid ID KNR süsteemis. nimi piirkonna nimi aadress tekstiline aadress, mis iseloomustab asulat, milles piirkond paikneb liik klassifitseeritud väärtus, hetkel kasutusel 2 väärtust: 01- mitteametlikud linnaosad, 02 mitteametlikud asumid. Sõltumata liigist loetakse kõiki tabelis olevaid objekte siiski mitteametlikeks piirkondadeks. stamp_cre kirje lisamise ajatempel, täitub automaatselt stamp_upd kirje muutmise ajatempel, täitub automaatselt geometry ala ruumikuju Aadresside sidumine mitteametlike piirkondadega Kõik kehtivad ADS süsteemi aadressid, mis omavad 3. tasemest täpsemat komponenti, võivad omada seost piirkonnaga. EHAK aadresse (ehk ruumiaadresse) ei seota piirkondadega, sest need on alati EHAK jaotusest väiksemad alad. Aadressi seostamine piirkonnaga ja selle seose muutmine toimub alati automaatselt. Aadress saab endale atribuudiks selle piirkonna nime, mille alal paikneb tema esinduspunkt. Loogiliselt ei tohiks mitte ükski punkt paikneda rohkem kui 1 alal, sest alad ei tohiks olla ülekattes. Siiski süsteem seda ei kontrolli ja ülekattega esitamist ei takista. Punktis võib esineda rohkem kui 1 piirkond ka sel juhul, kui punkt paikneb täpselt 2 ala piiri peal. Kui aadressi esinduspunktis leidus täpselt 1 piirkond, siis omistatakse selle nimi aadressi atribuudiks. Kui leidus mitu piirkonda, siis võtab süsteem neist juhuslikus AS Datel /226

25 järjestuses esimese. Kui aadressi esinduspunkt puudub või kui esinduspunktis ei asu mitte ühtegi piirkonda, siis jääb piirkonna nimi aadressi juures määramata. Piirkonna nime omistamisel või muutmisel registreeritakse ka vastav muudatussündmus aadresside logisse Seotud objektid ja objektiperekonnad Seotud objektid Seotud objektideks loetakse ADS süsteemis katastriüksuseid ja hooneid. Kui hoonel on ruumikuju, siis tuvastatakse seos ADS süsteemis ruumianalüüsiga. Kui hoonel puudub ruumikuju, siis on ta pärit EHR süsteemist ning sel juhul arvestatakse hoonele EHRs lisatud katastriüksuse seost. Need on otsesed seosed objektide vahel, kuid võivad esineda ka kaudsed seosed. Sõltuvalt seose leidmise iseloomust lisandub seosele prioriteet ning need võivad olla alljärgnevad: prioriteet 1 (otsene seos) ruumikuju alusel ADS süsteemis tuvastatud; prioriteet 2 (otsene seos) EHR rakenduses KOV kasutaja poolt hoonele lisatud KÜ seos, kui hoone ruumikuju puudub; prioriteet 3 (kaudne seos) aadressi sarnasuse alusel leitud seos aadressi kasutatakse seose leidmisel ainult siis, kui lähiaadress on olemas; prioriteet 4 (kaudne seos) EHR rakenduses KOV kasutaja poolt hoonele lisatud KÜ seos, kui hoone ruumikuju on olemas Objektiperekond Objektiperekond koosneb alati täpselt 1 katastriüksusest, temaga otseselt seotud hoonetest ja nende hoonete osadest. Kui hoone on otseselt seotud mitme katastriüksusega, siis kuulub ta mitmesse perekonda Objektide seose arvutamise ärireeglid ADS süsteemis Seose leidmise ärireeglites esinevad konstandid on algoritmi sisse kirjutatud, neid ei ole võimalik parameetrite kaudu häälestada. KÜ ja hoone seose leidmise algoritm, kui mõlemad on pindobjektid. Leitakse hoone ja KÜ ruumikujude ühisosa pindala suhe hoone pindalasse. 1) Kui suhe on väiksem, kui 10%, siis need objektid ei ole seotud. 2) Kui suhe on 10-40%, siis vaadatakse ühisosa pindala absoluutväärtust. 2a) Kui ühisosa pindala on alla 16m2, siis loetakse objektid sekundaarselt seotuks. 2b) Kui ühisosa pindala on suurem kui 16 m2, siis on objektid primaarselt seotud. 3) Kui suhe on suurem kui 40%, siis on objektid seotud primaarselt. Kui hoonel ei ole primaarset seost mitte ühegi katastriüksusega, aga on sekundaarsed seosed mitme katastriüksusega, siis loetakse primaarseks suurima kattuvuse protsendiga seos. Kui seos on ainult ühe katastriüksusega ja see seos on sekundaarne, siis hoonele seost ei tekitata. AS Datel /226

26 Objekti juurde salvestatakse ainult primaarsed seosed. KÜ ja hoone on seotud, kui üks nendest on punkt ja teine pind ning punkt asub pinnal. Kui mõlema kuju on punkt, siis on objektid seotud, kui punktid ühtivad koordinaatide täpsusastmega 2 kohta peale koma Objektiga seotud huvipunktid (POI) Huvipunktide (i.k point of interest alias POI) andmeid hallatakse ADS süsteemi väliselt Maa-ameti POI süsteemis. ADS süsteemis käsitletakse POI-sid aadressiobjekti mitteametliku nimetusena. Ühel aadressiobjektil saab olla ka mitu seotud POI-d. Aadressidega POI-sid ei seostata. POI andmed imporditakse ADS süsteemi failidest. POI nimetused imporditakse koos ADS-OID seosega. Kui ühel aadressiobjektil on mitu POI nimetust, siis imporditakse nad alati korraga ühes failis, kuid eraldi kirjetena. POI andmete struktuur ADS-s on järgmine: id kirje sisemine identifikaator ads_oid seotud aadressiobjekti ads_oid adob_id - seotud aadressiobjekti viimase versiooni id (virtuaalne atribuut) poi_nimi POI objekti nimetus ehk huvipunkti nimetus poi_tyyp POI tüübi info, numbriline kood poi_id POI süsteemis olev identifikaator. Vajalik sünkroonsuse kontrolliks ning seda teenuste kaudu välja ei anta. geometry POI esitluspunkti geomeetria (virtuaalne atribuut). Pinnakujulise aadressiobjekti korral on POI ruumikujuks pinna tsentroid. stamp_cre kirje lisamise ajatempel POI-de andmeid saa ADS süsteemis rakenduse kaudu käsitsi redigeerida. POI nimetuste muutumine aadressiobjekti juures uue impordi puhul on eraldi jälgitav. Kõigi impordi käigus muudetud objektide kohta tekib muudatuslogisse sündmus B (huvipunkti muudatus). POI-de ajalugu ADS süsteem ei säilita. Importimise hetkel seob süsteem esitatud nime kohe ka aadressiobjekti kehtiva versiooniga. Selle puudumisel jooksva ads-oid i nimede import ebaõnnestub. See tähendab, et nimesid saab importida ainult kehtivate aadressiobjektide kohta. Kehtiva versiooni andmetest tekib ka POI geomeetria, kui aadressiobjektil on kuju olemas. Aadressiobjekti kehtetuks muutumine temaga seotud POI-sid automaatselt ei kustuta. Menetlusrakenduse kaudu on võimalik vaadelda ka kehtetute objektide huvipunktide nimesid, samuti ilma ruumikujuta objektide nimesid. Kaardikihil aga ilmuvad ainult need POI nimed, mis on seotud kehtiva aadressiobjektiga, millel on ruumikuju Unikaalaadressi nõue Unikaalaadressi nõude tunnuse omistab ADS süsteem objektidele automaatselt ärireeglite alusel. AS Datel /226

27 Menetluse andmete kontrollimisel omistab süsteem selle tunnuse menetluses objektidele. Kui esineb kasvõi 1 UN-tunnuse omistamise põhjus, siis omistatakse tunnuseks jah. Kui mitte ühtegi UN-tunnuse omistamise põhjust ei esine, siis omistatakse tunnuseks ei. Muul juhul tunnust menetluse sees ei muudeta UN-alad Maa-amet valmistab süsteemiväliselt ette ruumialad, millel kehtib unikaalaadressi nõue. Neid alasid nimetatakse kokkuleppeliselt UN-aladeks. ADS menetlusrakenduse kasutajaliidese kaudu on võimalik süsteemi importida UNalade uus seis. Alati imporditakse uus seis tervikuna üle Eesti ja vana seis kustub ära. Kõik imporditavad objektid peavad olema pinnad. Tärkatribuutide olemasolul süsteem ignoreerib neid ja impordib ainult OBJECTID väärtuse, kui see on lähteandmetes olemas. Puudumisel viga ei teki. Õnnestumisel on UN alade seis asendunud. Vigade tekkimisel säilib vana seis. Seejärel käivitub automaatne protess, mis tuvastab ruumianalüüsi abil, millised üksused on UN aladega seotud nõutava pindala kattega. Seotud objektide ID väärtused salvestatakse eraldi ning lisaks salvestub UN alal asumise tunnus ka KÜ juurde. Ülejäänud üksused märgitakse UN-alal mitteasuvaks. Kuniks alade töötlemise protsess ei ole lõpetanud, ei toimu ka un-tunnuse automaatset muutmist objektide juures. Ruumianalüüsiga leitud tulemi salvestamine on vajalik selleks, et perioodilisel un-tunnuse muutmise protsessil ei oleks igaöiselt tarvis teha uut ruumianalüüsi saamaks teada katastriüksuste paiknemist un-alal. UN-alade kiht kuvatakse ADS menetlusrakenduse kaardil. ADS süsteemi haldajail on võimalik UN-alasid kaardil ka redigeerida. Sellisel juhul salvestub UN-ala juurde käsitsi muutmise tunnus ning süsteem eemaldab sellelt alalt analüüsitud tunnuse. Sellistele UN-aladele rakendub uuesti eelkirjeldatud automaatne protsess, mis leiab alaga seotud katastriüksused UN tunnuse omistamise ja eemaldamise põhjused UN-tunnuse omistamise põhjused (Kõik põhjused on võrdsed, ei ole prioriteetide järjekorras) objekti liik on ER või MR kui on tegemist uue objekti tekkimisega ja tema liik on EE objekti liik on CU ja objektil esineb 4+7 tasemega aadress objekti liik on CU ja objektil esineb 5+7 tasemega aadress objekti liik on CU ja tema ruumikuju paikneb vähemalt 50% ulatuses UN-alal objekti liik on CU ja temaga on seotud vähemalt 1 UN-tunnust omav hoone objekti liik on CU, EE või ME ja temaga on seotud vähemalt 1 liidestunud registri RR või ÄR objekt. (Arvesse lähevad nii liidestuja poolt esitatud seosed kui ka menetlusrakenduse kasutajate poolt tekitatud seosed objekti liik on EE või ME ja temaga on seotud vähemalt 1 UN-tunnust põhjustav kasutusotstarve. (Kasutusotstarvete klassifikaator on ADSs sisemiselt ühekordselt paika häälestatud. Selle muutmiseks kasutajaliidest välja ei arendata.) AS Datel /226

28 ETAK hoone liik on ühiskondlik ehk tyyp=10 Hoones (EE või ME objektid) paikneb kehtivaid hooneosasid (ER ja MR objekte). UN-tunnuse eemaldamise põhjus: objektil ei esine ühtegi UN tunnuse omistamise põhjust UN-tunnuse automaatne muutmine UN-tunnuse kontroll ja automaatne muutmine toimub igaõhtuse logide järeltöötluse protsessi käigus. Kontrollitakse lausaliselt kõiki objekte UN-tunnuse lisamise ja eemaldamise vajaduse tuvastamiseks. Kõigepealt tegeletakse hoonetega ja alles seejärel katastriüksustega, sest nende puhul on oluline teada seotud hoonete un-tunnust. Puuduva UN-tunnuse omistamine 1. Leitakse need ilma UN-tunnuseta jõusolevad CU, EE ja ME liiki objektid, millega on seotud RR või ÄR objekt. Neile omistatakse UN-tunnus. 2. Leitakse need ilma UN-tunnuseta jõusolevad EE ja ME liiki objektid, millel esineb kasutusotstarve, mis on UN-tunnust põhjustav. Neile omistatakse UN-tunnus. 3. Leitakse need ilma UN-tunnuseta jõusolevad EE tüüpi objektid, mil puudub ETAKseos, mil puudub EHR-kood või millel küll on olemas EHR-kood, kuid mil pole ühtegi kasutusotarvet. Neile omistatakse UN-tunnus. Hooneosade ja RR / ÄR seoste olemasolu ei kontrollita, sest nende lisandumine peaks juba eelnevalt un-tunnuse põhjustama. ETAK hoone tüübi muutumine põhjustab ADS objekti versioneerimist, see ei saa niisama muutuda. Ei analüüsita. Hooneosade sisaldumine hoones ei saa ka ilma versioneerumata muutuda. Ei analüüsita. Liigse UN-tunnuse eemaldamine hoonetelt 4. Leitakse need UN-tunnusega jõusolevad EE ja ME liiki objektid, mil pole etak-seost tüübiga 10, mil pole RR ega ÄR seoseid, mil pole un tunnust põhjustavat kasutusotstravet, mil pole hooneosi Iga leitud hoone puhul kontrollitakse täiendavalt, kas tal üldse on olemas ETAK seos ja kas tal on olemas ükskõik milline kasutusotstarve. Kui kumbagi pole, siis untunnust ei eemaldata. Kui on emb-kumb, siis eemaldatakse. Puuduva UN-tunnuse omistamine KÜ-tele 5. Leitakse need ilma UN-tunnuseta jõusolevad CU liiki objektid, mis asuvad UN-alal. Neile omistatakse UN-tunnus. 6. Leitakse need ilma UN-tunnuseta jõusolevad CU liiki objektid, millega on seotud vähemalt 1 UN-tunnusega hoone. Neile omistatakse UN-tunnus. Liigse UN-tunnuse eemaldamine KÜ-telt AS Datel /226

29 7. Leitakse need UN-tunnusega jõusolevad CU liiki objektid, mil pole un-tunnuse põhjuseid: mil pole 4. ega 5. tasemega aadressi mis pole UN-alal millega pole seotud UN-tunnusega hoonet mil pole RR ega ÄR seoseid Neilt eemaldatakse UN-tunnus UN-tunnuse käsitsi muutmine Vajaduse korral saab haldaja õigustega kasutaja muuta UN tunnust käsitsi otse põhisüsteemis. See käsitsi muutmine on vajalik fikseerida selleks, et süsteem automaatselt käsitsi omistatud väärtusi üle ei kirjutaks. ADS objektidele lisandub täiendav KUN ehk käsitsi UN tunnuse muutmise tunnus. Kui haldaja õigustega kasutaja tahab eemaldada objektilt UN tunnuse, kuid leidub selle tunnuse omistamise põhjus, siis esitab süsteem kinnitust nõudva küsimuse: Objektil esineb UN-tunnust määrav põhjus, kas oled kindel, et soovid tunnuse eemaldada? Nupud Jah / Ei. Kui kasutaja vastab jaatavalt, siis eemaldab süsteem UNtunnuse ja ühtlasi omistab KUN-tunnuse, milleks on käsitsi muutmise kuupäev. Analoogselt, kui haldaja õigustega kasutaja tahab lisada objektile UN tunnuse, kuid leidub selle tunnuse mitteomistamise põhjus, siis esitab süsteem kinnitust nõudva küsimuse: Objektil esineb UN-tunnust keelav põhjus, kas oled kindel, et soovid tunnuse lisada? Nupud Jah / Ei. Kui kasutaja vastab jaatavalt, siis tunnus lisatakse ja ühtlasi omistab süsteem KUN-tunnuse, milleks on käsitsi muutmise kuupäev. Kui UN tunnuse muutmisel vastuolu automaatsete reeglitega ei teki, siis KUN tunnust ei omistata. Süsteem võib neid objekte automaatselt muuta. KUN tunnust saab kasutaja eemaldada ainult käsitsi. KUN tunnuse eemaldamisel toimub koheselt unikaalaadressi tunnuse määramine automaatse reegli alusel. UN-tunnuse muutumisel peab tekkima objektist uus versioon. Tunnuse muutuse korral tõuseb muudatusvektoris tärkmuudatuse lipp (esimene positsioon). KUN tunnuse eemaldamisel uut versiooni ei tehta. Uus versioon tekib ainult siis, kui kaasneb ka UN tunnuse muutumine Kohanime tunnus Katastriüksus liiki aadressiobjektil on ADSis täiendav tunnus kas on tegemist kohanimeobjektiga. Tunnusel on 3 võimalikku väärtust: jah on kohanimi, ei ole kohanimi, määramata. Sisuliselt tähendab see tunnus, kas objektil on kohanimekohustus või ei ole või see ei ole teada. Samalaadne tunnus on ka 6. taseme komponentidel. Need tunnused on omavahel loogiliselt seotud. KOV kasutajale kuvatakse kohanime tunnus objekti andmetes, kuid KOV kasutaja seda muuta ei saa. Muuta saab ADS haldaja menetlusväliselt. Menetluseväliselt muutmisel ei teki objektist uut versiooni ega logisse objekti muudatussündmust. Tekib AS Datel /226

30 eraldi uus logi KNR süsteemi jaoks, kus logitakse ainult selle tunnuse jah on kohanimi lisandumist ja eemaldumist objektil. Määramata väärtuse muutumist ei-ks ei logita ega vastupidi. Menetluse sees käsitsi seda tunnust muuta ei saa. Menetluse jõustamise hetkel teeb süsteem automaatse omistuse sellele tunnusele. Täpsemalt, kuna tunnuse omistamiseks on vaja ka teadmist seotud hoonetest, siis toimub tunnuse omistus seoste värskendamise ajal. Probleem tekib olukorras, kus katastriüksusel on juba registreeritud seos hoonega ja sellele hoonele lisandub UN-tunnus. UN tunnuse lisamise hetkel ei ole kuigi mugav analüüsida täiendavalt seotud objekte, et muuta nende KN tunnust. Otstarbekam on hakata seda olukorda püüdma õhtuste logide järeltöötluse protsessi raames. Tavapärasesse logide järeltöötluse protsessi luuakse uus samm, mis hakkab kontrollima KN tunnuse omistamise vajadust üksusele temaga seotud hoonete UN tunnust arvestades. Automaat arvutab kohanime tunnust ainult sel juhul, kui see on objekti juures määramata või on väärtustatud ei. Määratud jah väärtusi automaat ei muuda. Jahväärtused võivad olla ka kasutaja poolt käsitsi omistatud. Kasutaja ei-väärtusi käsitsi omistama ei hakka, kuigi süsteemi taoline võimalus siiski luuakse. Ei-väärtuste käsitsi omistamisega saab kasutaja annulleerida ekslikult omistatud jah-väärtuseid. Automaat muudab kohanime tunnuse jah-st ei-ks ainult sel juhul, kui objektilt eemaldatakse 6. taset sisaldav aadress Kohanime tunnuse automaatse omistamise reeglid Tunnuse kohanimi (1-jah/0-ei /määramata) omistamise reeglid katastriüksusel. Reeglid mõjuvad kirjeldatud järjekorras. 1) Kui objektil ei esine 6. tasandit sisaldavat aadressi, siis kohanimi=0. 2) Kui objektil esineb mitu erinevat 6. tasandit sisaldavat aadressi, siis kohanimi=0. 3) kui 6. tasandi komponent sisaldab teatud kokkulepitud välistussõnu, siis kohanimi=0 isegi sel juhul, kui kü on hoonestatud. 4) kui objekti kuju on punkt või orig_tunnus puudub, siis kohanimi=määramata 5) kui KÜ ei ole hoonestatud un-tunnusega hoonega, siis kohanimi=0 6) kui KÜ on hoonestatud (leidub seotud un tunnusega hooneid prioriteediga 1 või 2) ja kui objekti kuju on pind ja selle kompaktsusnäitaja Q jääb väiksemaks etteantud piirväärtusest 0,029, siis kohanimi=0. Q = 4 ππ pppppppppppppp ümmmmmmmmmmõõtt 2 7) ülejäänud juhtudel kohanimi=1 Reeglites mainitud välistussõnad registreeritakse eraldi erandsõnade tabelis. Välistussõnaks on üksik täht, millele ilma tühikuta järgneb 1 või mitu numbrit. Näiteks T1 või T234 jne. Esimeses postsioonis võivad esined tähed Txxx, Lxxx, Pxxx, Vxxx, Jxxx, kus xxx tähistab suvalist hulka numbreid. Esimeses postsioonis olev täht võib olla kas suur või väike. AS Datel /226

31 Välistussõnad võivad esineda nime alguses, keskel või lõpus, kuid kindlasti teistest sõnadest lahku kirjutatult. Sõna eraldajaks on tühik, sidekriips ei ole sõnaeraldaja. Suur- ja väiketähti ei eristata. Kui 6. taseme komponent algab numbriga, siis ei ole tegemist kohanimekohustusega üksusega Kohanime tunnuse kaasnev muutmine komponendi juures Tunnuse muutmisel objekti juures teeb süsteem muudatuse ka objektiga seotud 6. taseme komponendis. Kuna sama komponent võib esineda mitme objekti aadressis, siis toimub see järgmiselt. Automaatne omistamine süsteemi poolt: 1) kui komponendiga on seotud kasvõi 1 KÜ, millel tunnus kohanimi=1, siis ka komponendil kohanimi=1 2) kui komponendiga ei ole seotud mitte ühtegi KÜ-t, millel kohanimi=1, aga on seotud vähemalt 1 KÜ, millel kohanimi=0, siis komponendil kohanimi=0 3) ülejäänud juhtudel kohanimi=määramata Automaatne omistamine tehakse iga kord, kui muudetakse komponendiga seotud katastriüksuseid (seotud KÜ kas lisandub, eemaldub või muutub). 6. taseme komponendiga seotud hoonete muutumise korral tunnust uuesti ei väärtustata. Automaatne omistamine tehakse ka sel juhul, kui kasutaja käsitsi muudab tunnust KÜ andmetes. Lisaks on võimalik kohanime tunnust eraldi muuta komponendi juures ADS haldaja poolt. Komponendi juures muutmine ei too kaasa muudatust objekti juures, kuid ADS haldaja peab arvestama, et järgmise seotud KÜ muudatuse ajal võib süsteem selle tunnuse jälle ära muuta. Tunnuse muutmisel komponendi juures ei teki küll komponendist versiooni, kuid tekib muudatussündmus logisse. Komponendi muudatussündmust ei registreerita juhul, kui määramata muutub jah-ks või vastupidi. Ainult ei tekkimine või kadumine tekitab komponendi muudatussündmuse Kohanime tunnuse import objektidele Haldaja töövahendite hulka lisandub kohanime tunnuse importimise võimalus katastriüksustele. Importfail valmistatakse ette csv-formaadis ning ta sisaldab 2 veergu: katastriüksuse ADS-OID kohanime tunnus ( 1 / 0 / tühi). Maa-ameti haldaja rolliga kasutaja laeb üles importfaili ning käivitab impordi. Süsteem töötleb ükshaaval importfailis olevaid kirjeid. Töötlus toimub online s, st kasutaja jaoks on rakendus nii kaua hõivatud kuni import käib. Soovitav on mitte kasutada korraga liiga mahukaid importfaile. Sobiv faili suurus on ligikaudu kuni 4000 objekti. Süsteem leiab ADS-OID alusel KÜ kehtiva versiooni. Kui kehtivat versiooni ei leidu või kui tegemist pole katastriüksusega, siis veateade. AS Datel /226

32 Edasi kontrollib süsteem, et üksusel leiduks vähemalt 1 aadress, mis sisaldab 6. taseme komponenti. Kui sellist aadressi pole, siis veateade. Edasi toimub KÜ andmetes ja aadressi 6. taseme komponentide juures kohanime tunnuse muutmine vastavalt importfailis sisalduvale väärtusele täpselt samal moel ja sama loogika alusel nagu kasutaja oleks seda teinud käsitsi ekraanivormi kaudu. Muutmine loetakse õnnestunuks kui muudatuse käigus ei tekkinud tehnilisi vigu või kui muudatust polnudki vaja teha, sest tunnus juba oli samamoodi väärtustatud. Õnnestunud muudatuste kohta süsteem tagasisidet ekraanile ei anna. Impordi lõppemisel teatab süsteem õnnestunud objektide arvu. Vea põhjustanud katastriüksused tuuakse koos tunnustega eraldi välja Sihtnumbrid Sihtnumber on aadressi atribuut, mitte aadressiobjekti atribuut. Kui ühel aadressil on mitu objekti, siis omavad nad sama sihtnumbrit. Kui ühel objektil on mitu aadressi, siis võib see objekt omada ka mitut sihtnumbrit. Iga aadress võib omada täpselt ühte sihtnumbrit. Kuigi leidub ka selliseid aadresse, millel praktiliselt on kasutuses mitu erinevat sihtnumbrit, siis aadressi põhjal saab neid alati olla ainult 1. Teised on eriotstarbelised sihtnumbrid, mis tulenevad sellel aadressil paikneva asutuse postiteenuse vajadustest ja mitte aadressist endast. ADS süsteem ei pea andma ülevaadet mitte kõikidest kasutusel olevatest sihtnumbritest, vaid ainult aadressiga seotud sihtnumbritest. Mitte iga aadress ei pea omama sihtnumbrit. Sihtnumbrit peavad omama need aadressid, mis on seotud un-tunnusega hoonete või hooneosadega. Kui näiteks leidub un-tunnusega hoone, mis omab ainult küla tasemeni määratud aadressi, siis peab ka sellel küla tasemega aadressil olema sihtnumber, muidu mitte. Sihtnumber võib olla määratud ka neil aadressidel, mis seda omama ei pea. Üldjuhul püütakse sihtnumber määrata kõigile aadressidele, mil vähegi võimalik. Sihtnumbrite määramise reeglistiku kehtestab Omniva ning tema ülesanne on ka uutele aadressidele sihtnumbrite määramine. ADS süsteemi ülesanne on seda infot talletada ning võimaluste piires korrektsust kontrollida SIHN-alad SIHN alad on sihtnumbri mõjualad, mille ruumikuju on alati polügoon. Need valmistatakse ette väljaspool süsteemi ja laetakse ADS süsteemi sisse impordi teel. Edaspidi on neid võimalik ADS süsteemis ka käsitsi kaardiaknas redigeerida. SIHN alade andmestruktuur on järgmine: id ADS süsteemi poolt genereeritav sisemine identifikaator, täisarv sihtnumber 5-kohaline täisarv kasitsi_muudetud kirje ADS rakenduse kaudu muutmise ajatempel, importimisel jääb tühjaks stamp_cre kirje lisamise ajatempel, täitub automaatselt nii importimisel kui ka rakenduse kaudu kirje lisamisel geometry ala ruumikuju AS Datel /226

33 SIHN alade polügoonid ei pea üksteisega täpselt külgnema. Nende vahed ehk nö valged alad on määramata sihtnumbriga alad. Polügoonid ei tohiks olla ülekattes, kuid reaalselt nad võivad olla. Süsteem arvestab selle võimalusega, kuid ei kontrolli ega takista ülekatete tekkimist Sihtnumbrite omistamise andmevahetus Sihtnumbrite omistamise äriloogika kehtestab Omniva. Tulevikus peab sihtnumbrite omistamise infovahetus toimuma üle teenuste ADS ja Omniva vahel. Hetkel on Maa-ametis loodud eraldiseisev automaatselt käivituv protsess, mis tegeleb Omniva poolt kehtestatud ärireeglite alusel aadressile sihtnumbrite määramisega. See protsess saab sisendiks nende aadresside täistekstid, mis vajavad sihtnumbrit. Tulemuseks on samad aadressid koos sihtnumbriga. Andmevahetuse tarbeks luuakse eraldi ADS süsteemi väline andmevahetustabel. Selles tabelis on järgmised andmeväljad: ADR_ID TAISAADRESS LAHIAADRESS SIHTNUMBER VAJAB_TOOTLUST (1 / 0) - 1 aadress vajab uut sihtnumbri töötlust; 0 või tühi aadress ei vaja sihtnumbri töötlust STAMP_CRE kirje tabelisse lisamise ajatempel STAMP_UPD ajatempel, mis näitab viimast sihtnumbri töötluse aega, omistab triger automaatselt ON_MUUTUNUD - 1-sihtnumber on muutunud ja muudatus on ADSis arvesse võtmata, null - sihtnumber pole muutunud selles tabelis Tabel sisaldab kõiki kehtivaid aadresse, sh ka neid, mis sihtnumbrit ei vaja. ADR_ID on tabelis kirjete võtmeväli, st et iga aadress sisaldub seal täpselt 1 kord. Andmevahetuse lähteseisuks lisatakse tabelisse kõik ADS süsteemis kehtivad aadressid koos tunnusega, et vajab töötlust. Kui aadress muutub kehtetuks, siis võib ta sellest tabelist kustutada. Samahästi võivad kehtetud aadressid ka tabelisse alles jääda, kuna need võivad ka taas kehtivaks muutuda. Kustutamine võib siiski olla vajalik, et vähendada aadresse töötleva protsessi töömahtu. Kustutamisi võib teha ka teatud perioodi tagant süsteemiväliselt Sihtnumbri omistamine uuele aadressile Uued aadressid tekivad tavaliselt menetluse käigus. Menetluse sees ei omistata aadressidele sihtnumbrit ei käsitsi ega automaatselt. Uue aadressi jõustamisel ehk selle kirjutamisel menetlusest põhisüsteemi omistab süsteem sihtnumbri võimaluse korral automaatselt SIHN-ala alusel. Kui uue aadressi esinduspunkt jääb täpselt 1 sihtnumbri mõjualale, siis omistab süsteem automaatselt selle sihtnumbri aadressile. Kui uuel aadressil kas puudub esinduspunkt või kui see punkt ei jää mitte ühelegi või jääb mitmele SIHN-alale, siis jääb uus aadress algseisus ilma sihtnumbrita. Sihtnumbri probleemi talle otsekohe ei lisandu. AS Datel /226

34 Uued aadressid saavad tekkida ka EHAK objektide esitamisel katastrist ADS-i ning väikekohtade ja liikluspindade esitamisel KNR-st ADS-i. Nende objektide puhul jääb uue aadressi sihtnumber alguses määramata. Veel võivad tekkida uued aadressid taseme komponendi versioneerimise käigus. Sellisel juhul saab uus aadressi versioon algseisus sama sihtnumbri nagu tema eelmine versioon. Alati, kui tekib uus aadress, siis logib ADS süsteem selle koheselt välisesse sihtnumbrite andmevahetustabelisse, et väline sihtnumbrite omistamise protsess saaks alustada sellele aadressile sihtnumbri määramisega. ADS süsteemis saab toimuda ka kehtetu aadressi taastamine. Sellise sündmuse korral lisab ADS aadressi andmevahetustabelisse ainult sel juhul, kui seda seal veel ei ole. Kui on, siis muudab aadressi kirjes tunnust, et aadress vajab sihtnumbri töötlust Sihtnumbri muutmine aadressil Aadressi sihtnumbri muutmine toimub ainult Maa-ameti poolt teostatava ADS süsteemi välise analüüsi tulemite alusel. ADS õhtune logide järeltöötlemise protsess loeb andmevahetustabelist aadressi, mida vahepeal on töödeldud. Seejärel kontrollib, kas ADS süsteemis on sellel aadressil sama sihtnumber (puudumine ADSis ja tulemtabelis loetakse võrdseks). Kui ei ole sama sihtnumber ja kui aadress on jätkuvalt kehtiv, siis muudab süsteem sihtnumbri ADSis ära. Seejuures tekib aadressile logisündmus N. Sihtnumbri muutumine ei põhjusta aadressi versioneerimist ning ei põhjusta aadressi muutumise sündmust. Tarbijad, keda uus sündmus sihtnumbri muutumine huvitab, saavad seda muudatust logiteenuses eraldi jälgida. Analoogselt käitub P-tüüpi sündmus, mis tekib aadressi esinduspunkti muutuse korral. Sihtnumbri muudatuseks loetakse kehtival aadressil: puuduva sihtnumbri omistamine olemasoleva sihtnumbri eemaldamine sihtnumbri väärtuse muutumine Sihtnumbri probleemi muutumine N sündmust ei tekita. Kui uuele aadressile tema tekkimise hetkel kohe omistatakse sihtnumber, siis tekib ainult I (lisamine) sündmus ja täiendavat N sündmust ei teki. Kui aadress taastatakse (R sündmus), siis tema sihtnumber taastamise käigus ei muutu ja N-sündmust talle täiendavalt ei teki. Muul viisil ADS sihtnumbrite infot ei muuda. ADS menetlusrakenduse kaudu seda teha ei saa Sihtnumbri probleemide analüüs ADS süsteem ise kontrollib sihtnumbrite sobivust ja kooskõla SIHN-aladega. Tegemist on sekundaarse kontrolliga, mis peaks täiendavalt abistama sihtnumbrite määramise välist analüüsi. AS Datel /226

35 Võimalikud probleemid on järgmised. Probleem 1. Sihtnumber puudub, kuid aadress vajab sihtnumbrit. Probleem 2. Sihtnumber ei jää SIHN alale. Aadressil on sihtnumber olemas, kuid selle esinduspunkt ei jää mitte ühelegi SIHN alale. Probleem 3. Sihtnumber on vastuolus SIHN alaga. Aadressil on sihtnumber olemas, kuid selle väärtus on vastuolus SIHN-alal kehtiva sihtnumbriga, millele aadressi esinduspunkt satub. Kui esinduspunkti all on mitu SIHN-ala ja vähemalt ühega neist sihtnumber sobib, siis seda viga pole. Probleem 4. Sihtnumber on vastuolus Omniva andmetega. Aadressil on sihtnumber olemas, kuid selle väärtus on vastuolus Omniva poolt liidestujate tagasiside teenuse kaudu esitatud sihtnumbriga. Probleeme 1 ja 4 kontrollitakse täies ulatuses üle kõigi andmete. Probleemide 2 ja 3 puhul tehakse lauskontroll ainult siis, kui on toimunud SIHN alade uus import. Optimeerimise eesmärgil kontrollib süsteem probleeme 2 ja 3 järgmiselt: õhtuse logide järeltöötluse protsessi käigus aadresside muutumise (U), taastamise (R), esinduspunkti muutumise (P), sihtnumbri muutuse (N) sündmuste järeltöötluse korras; õhtuse logide järeltöötluse protsessi käigus sihtnumbri probleemide analüüsi etapis käsitsi muudetud SIHN-aladel asuvate aadresside analüüsimiseks. Aadresspunktid, mis enne asusid SIHN-alal, aga pärast kuju käsitsi muutmist jäid alalt välja, ei satu analüüsi. Selle olukorra vähendamiseks võib analüüsida ka kuju muutnud SIHN alade lähiümbruses asuvaid aadresspunkte eeldusel, et käsitsi muudatused on väikesed. Lähiümbruseks loetakse muutunud alaga samas ruumiindeksi harus sisalduvaid punkte (sdo_filter operatsiooniga leitud punktid) Aadressiobjektide täiendavad andmed ADS süsteem loeb teenuste vahendusel objektide päritoluregistritest täiendvaid andmeid nende objektide kohta. Objekti liik CU: sihtotstarbed pindala (otsustati kasutada topokuju pindala ja see on arvutatav ADSs hoitava ruumikuju pealt) kinnistu number Objekti liigid EE ja ME: staatus EHRs nimetus ehitisalune pind kasutusotstarbed Objekti liigid ER ja MR: liik EHRs staatus EHRs ruumi üldpind sissepääsu korrus nimetus (mitteeluruumidel esineb nimetus) AS Datel /226

36 2.3 Menetlussüsteemi mõisted Menetlusprotsess tegevuste jada, mille tulemusena tekivad või muutuvad põhisüsteemis olevad aadressid, aadressiobjektid või objekti ja aadressi vahelised seosed. Üks protsess muudab loogiliselt seotud aadresse. Menetlus ühes menetlusprotsessis osalevate objektide ja nendega seotud andmete kogum Menetleja isik, kes protsessi algatab, läbi viib või jõustab. Menetlejaks saab olla kas registreeritud kasutaja või süsteem ise (automaat). Menetleja organisatsioon kõik süsteemis registreeritud kasutajad on seotud mingi organisatsiooniga KOV, Maa-amet või MKM. Protsessi menetlejaks saab olla korraga täpselt 1 organisatsioon. Füüsiliselt saavad menetlust teha kõik selle organisatsiooni vastavates õigustes kasutajad. Kuju metaandmed objekti kuju tekkimise viisi iseloomustavad andmed: kuidas, millal ja kelle poolt tekkinud ning kuju täpsus Menetlusprotsess Menetlusprotsessi saab algatada kas kasutaja või automaat, vastava arenduse korral on võimalik, et menetlusprotsess algatatakse päritoluregistri kaudu. Protsessis osalevad aadressiobjektid, st menetletakse aadressiobjekte. Kui olemasolev objekt võetakse menetlusse, siis tekib temast uus versioon (v.a topoloogia korrastamise toimingus). Paralleelselt võib objekt osaleda mitmes eri liiki menetluses. Versioonid kirjutatakse põhisüsteemi menetluste jõustamise järjekorras. Objekt saab tekkida korraga ainult 1 menetluses, st põhisüsteemis mitte-eksisteerivat objekti saab korraga menetleda ainult 1 protsess. Menetluses saavad osaleda 5 liiki objektid: katastriüksused, elamud, mitteelamud, eluruumid ja mitteeluruumid. Kõigi teiste objektide muudatused esitatakse otse põhisüsteemi ilma menetlust läbimata, aga eelloetletud liike ilma menetluseta muuta ei saa (erandiks on ehitisregistri hooned ja hooneosad, kuni uue EHR-i valmimiseni esitab EHR andmed otse ADS-i põhisüsteemi ilma menetlusteta). Menetlusprotsessid jagunevad 4 põhitüüpi, igal tüübil võib olla veel alamtüüpe Andmete parandus (P) Protsessi algatajaks ja läbiviijaks on kas kohalik omavalitsus või erimenetleja (ADS osakonna töötaja) õigustes kasutaja sõltuvalt paranduse iseloomust. Protsessis osalevad sellised objektid koos aadressidega, mis on registri põhisüsteemi valesti sisse kantud või mis puuduvad registrist. Looduses ei ole toimunud muudatust, kuid registri seis ei vasta tegelikule seisule looduses. Andmete korrastuse käigus saavad muutuda nii objekti kuju, aadressid kui ka õiguslik alus. Protsessi käigus tekib kõigist protsessis osalevatest andmetest uus versioon. Kui protsessi jõustamise hetkel selgub, et uus versioon on identne sama objekti aktuaalse versiooniga, siis viskab süsteem automaatselt selle objekti menetlusest välja ja protsess seda objekti ei muuda. AS Datel /226

37 Andmete parandamise protsessil võib olla mitmeid alam-protsesse, et parandada ainult teatud tüüpi vigu. Kui üldine andmete parandamise loogika eeldab, et parandatud objektid on menetluse jõustamise hetkel täiesti korras register ei suuda äriloogika alusel tuvastada mitte ühtegi viga, siis ikkagi võib esineda vajadus parandada mingit laadi vead hulgal objektidel ja ülejäänud vead ei tohiks takistada paranduste jõustamist Andmete muudatus (M) ADS andmete muudatus on protsess, mille algatajaks ja läbiviijaks on alati KOV ametnik. Protsessi rakendatakse selliste muudatuste korral, kus andmed muutuvad ka reaalses elus. Tehniliselt sarnaneb protsess täpselt andmete parandamise protsessiga, erinevus on ainult loogilist laadi, et eristada reaalseid muudatusi registriandmete paranduskannetest. Protsessi jõustamisel kontrollitakse alati kõigi protsessis osalevate andmete loogilist terviklikkust ja korrektsust ning sobivust ülejäänud ADS andmetega Topoloogia korrastus (T) Protsessi algatajaks ja läbiviijaks on enamasti Maaregister, kus tehakse katastriüksustele topoloogia korrastamise toimingut. Protsessi saab läbi viia ka ADS halduse rakenduse kaudu, kus seda saab algatada nii KOV kui ka registri volitatud töötleja. Protsessi käigus saab muutuda ainult objekti kuju, kusjuures muudatus ise saab olla ainult topoloogilist laadi objekti pindala oluliselt ei muutu. Protsessi käigus ei saa tekkida puuduv kuju. Protsessi käigus ei teki objektist uut versiooni, vaid asendub registris kehtiva viimase versiooni kuju. Menetlussüsteemi jääb jälg toimunud protsessist küll alles, kuid kuju ei versioneeru Automaatne muudatus (A) Kompleksmuudatuse protsessi algatab alati süsteem automaatselt, kui on tehtud muudatusi haldusüksustes või kui on muudetud väikekoha või liikluspinna nime. Süsteem tühistab või versioneerib järeltegevusena kõiki seotud aadresse ning ühtlasi teeb vajalikud muudatused ka objektide juures. Kasutaja kohustus on muudatused üle vaadata ja jõustada. Kasutaja ei saa objekte oma suva kohaselt toimingusse lisada ega sealt eemaldada. Süsteem hoolitseb, et korraga ei oleks ühes menetluses häirivalt palju objekte ja teeb vajadusel ise mitu samaliigilist menetlust, kui kõik objektid ühte menetlusse ära ei mahu. Üldjuhul kontrollib ja kinnitab muudatused KOV ametnik, kuid KOV saab delegeerida selle ülesande ka ADS osakonna töötajatele. Menetluse jõustamisel on kontrollid nõrgemad, kui tavalise andmete muutmise toimingu korral. Selle toiminguga ei püüta parandada registri vigu ega viia sisse looduses toimunud muudatusi, vaid ainult kiirkorras läbi kanda aadressi ülemtasemetel toimunud muudatuste järelmõju Menetlejad Protsessi menetlejaks on üks konkreetne organisatsioon. Organisatsioonid on kõik kohalikud omavalitsused, Maa-amet ja MKM. Kõik ADS menetlusõigusi omavad kasutajad peavad olema registreeritud Maa-ameti infosüsteemi kasutajate administreerimise süsteemis ja olema seotud nende organisatsioonidega. AS Datel /226

38 Õigusi jagatakse otse kasutajatele, mitte organisatsiooni kaudu ja seetõttu ei pruugi kõik juba varasemast ajast eksisteerivad kasutajad saada ADS menetlemise õigust Õigused ADS menetlussüsteem võtab kasutusele MIS süsteemis juba realiseeritud kasutajate administreerimise süsteemi. ADS kasutajate haldamiseks on 2011 aastal koostatud spetsiaalne kasutusjuhend, kus täpsustatakse, mil viisil peab häälestus olema tehtud. Tuleb arvestada, et ADS kasutajad võivad samaaegselt olla ka teiste MIS rakenduste kasutajad ja seetõttu võib neil olla täiendavaid õigusi, mida ADS ei arvesta. ADS menetlussüsteemi kasutajatel eristatakse järgmisi tasandeid ligipääs ADS menetluse rakendusele ilma andmete muutmise õiguseta ligipääs ADS menetluse rakendusele koos tavamenetlusõigusega. See õigus omistatakse neile kasutajatele, kes saavad süsteemis teha kõiki menetlustoiminguid, jõustada muudatusi, märkida mitteaktuaalseks neid probleeme, mis omavad vastavat tunnust. Valdavalt on need KOV kasutajad. ligipääs ADS menetluse rakendusele koos erimenetlusõigusega. Saab teha tavamenetlustoiminguid oma piirkonnas ja lisaks märkida mitteaktuaalseks eriõigust vajavaid probleeme. Vastav tunnus on probleemi juures. Valdavalt peaks seda õigust omama ADS osakonna töötajad. Igale ADS menetlussüsteemi kasutajale tuleb omistada 1 õigus eelmisest loetelust. Ei ole vaja mitut, kuna iga järgmine sisaldab eelmist. Igale kasutajale omistatakse tema tööpiirkond. Selleks saab olla mingi KOV territoorium või kogu Eesti ala. Ei ole välistatud, et kasutajale omistatakse 2 või enam tööpiirkonda. Kui kasutajale ei ole omistatud mitte ühtegi piirkonda ega ka mitte kogu Eesti ala, siis ta menetlusi jõustada ikkagi ei saa. Haldusjaotuse muudatustega kaasnevad ka vastavate tööpiirkondade muudatused. Kasutajate administreerimisel peab saama Maa-ameti poolne kasutajate administraator tööpiirkondi muuta vastavalt haldusjaotusele. Vähemalt ühele kasutajale igas organisatsioonis (siin peetakse silmas eelkõige KOVe) omistatakse teiste kasutajate administreerimise õigus. Sellel kasutajal on siis võimalus täiendavalt lisada oma organisatsiooni uusi kasutajaid ning anda neile õigusi samade õiguste piires, mida administraator ise omab. Näiteks, kui administreerimise õigusega kasutajal on õigus mingile tööpiirkonnale, siis saab ta edastada sama tööpiirkonna teistele kasutajatele, kuid mitte sellist tööpiirkonda, mis talle ei kuulu. AS Datel /226

39 2.4 Andmemudel ADS põhisüsteemi olemid AS Datel /226

40 Logitabelid AS Datel /226

41 Menetlus AS Datel /226

42 Huviobjektid (liidestujate tagasiside) AS Datel /226

43 3. Põhisüsteemi protsessid 3.1 Aadressiobjekti esitamine Otse põhisüsteemi saab esitada taset initsialiseerivaid aadressiobjekte (maakond, omavalitsus, asustusüksus, linnaosa, väikekoht, liikluspind) ja kohanimesid. Nende objektide jaoks on ADS andmeid koguv, mitte haldav register. ADS ei tee iseseisvalt nende objektide andmetesse muudatusi, vaid ainult ettepanekuid, mida andmed haldavad registrid peavad ise parandustena sisse kandma. Andmete esitamise hetkel kontrollib süsteem, kas tegu on lisamise, muutmise, tühistamise, taastamise või versiooniparandusega Aadressiobjekti lisamine Aadressiobjekti lisamine toimub siis, kui esitatakse sellise aadressiobjekti andmed, mida süsteemis veel ei ole. Genereeritakse uus Id ja ADS_OID. Lisatakse Adob_liik, Orig_id, Tekkimise_alus, Kehtiv_alates, ruumikuju vastavalt esitatud andmetele. Süsteem kontrollib, et atribuudid tekkimise_alus ja kehtivuse_algus oleks kooskõlas versiooni loomise kontseptsiooniga. Andmeväli Kehtiv täidetakse hetke ajatempliga. Olek omistatakse K (kehtiv). Töödeldakse objekti aadressid. >3.2.1; >3.2.2 Initsialiseeritakse komponendid. >3.3 Salvestatakse aadressid >3.2.3 Toodetakse objekti täis- ja lähiaadress tekstina. Arvutatakse ruumiaadress. >3.4 Analüüsitakse soovituslikke aadressimuudatusi ruumiliselt sõltuvatel objektidel. > Aadressiobjekti versioonimine Aadressiobjekt versioonitakse alati kui tema andmed on muutunud ning esitatakse kehtivad andmed. Eelnevalt on süsteemist leitud aadressiobjekti kehtiv versioon (Adob_liik ja Orig_tunnus alusel). Erandiks on muutmine versiooniparandusena, mida käsitletakse süsteemis eraldi. Andmete muutumisel lisatakse uus kirje tabelisse AADRESS_OBJEKTID. Id süsteem genereerib uue versiooninumbri. Adob_liik, ADS_OID, Orig_tunnus peavad olema tingimata samad, mis eelmisel versioonil. Võrreldakse esitatud andmetega ning erinevuse korral antakse viga. Atribuudid tekkimise_alus ja kehtivuse_algus peavad olema sisendandmetes määratud. Süsteem kontrollib, et need oleks kooskõlas versioonimise kontseptsiooniga. Kehtival versioonil täidetakse samade andmetega sulgemise_alus ja kehtiv_kuni andmeväljad. Uuel versioonil täidetakse Kehtiv väli hetke ajatempliga ning sama väärtus kantakse senikehtinud versiooni Kehtetu andmevälja. Kehtiva versiooni olek muudetakse V (vana) ja uuel versioonil K (kehtiv). AS Datel /226

44 Töödeldakse objekti aadressid. >3.2.1; >3.2.2 Initsialiseeritakse komponendid. >3.3 Salvestatakse aadressid >3.2.3 Toodetakse objekti täis- ja lähiaadress tekstina. Arvutatakse ruumiaadress. >3.4 Analüüsitakse soovituslikke aadressimuudatusi ruumiliselt sõltuvatel objektidel. > Aadressiobjekti versiooniparandus Aadressiobjekti versiooniparandus toimub siis, kui esitatavates andmetes viidatakse konkreetsele objekti versioonile ja selline leidub süsteemis. Versiooniparandusega ei tohi muutuda objekti nimi ega aadress. Võivad muutuda objekti kuju ning õiguslik alus ja selle kuupäev. Ei saa muutuda objekti olek. Õigusliku aluse muutmisel ei tohi kuupäev minna vastuollu versiooni kontseptsiooniga. Kui registreeritakse objekti versiooniparandus, siis selle objekti poolt initsialiseeritud komponente ei versioonita ning see ei too kaasa ühelegi objektile aadressi muutmise kohustust. Arvutatakse ruumiaadress. >3.4 Analüüsitakse soovituslikke aadressimuudatusi ruumiliselt sõltuvatel objektidel. > Aadressiobjekti tühistamine Aadressiobjekti tühistamine toimub siis, kui süsteemis leidub kehtiv objekti versioon ning esitatavates andmetes on määratud sulgemise_alus ja kehtiv_kuni kuupäev. Kehtival versioonil omistatakse Sulgemise_alus ja Kehtiv_kuni atribuudid, mis on sulgemise korral kohustuslikud. Õigusliku aluse kuupäev ei tohi minna vastuollu versiooni kontseptsiooniga. Andmeväli Kehtetu täidetakse hetke ajatempliga. Kehtiva versiooni olek muudetakse T (tühistatud). Tühistatakse objekti seosed aadressidega. >3.2.5 Tühistatakse initsialiseerivad seosed komponentidega. >3.3.2 Analüüsitakse soovituslikke aadressimuudatusi ruumiliselt sõltuvatel objektidel. > Aadressiobjekti taastamine Aadressiobjekti taastamine toimub siis, kui esitatakse aadressiobjekti andmed, mille viimane versioon ADS süsteemis on tühistatud (olek T, täidetud kehtiv ja kehtetu kuupäev). AS Datel /226

45 Lisatakse uus versioon tabelisse AADRESS_OBJEKTID. Id süsteem genereerib uue versiooninumbri. Adob_liik, ADS_OID, Orig_tunnus peavad olema tingimata samad, mis tühistatud versioonil. Võrreldakse esitatud andmetega ning erinevuse korral antakse viga. Atribuudid tekkimise_alus ja kehtivuse_algus peavad olema sisendandmetes määratud. Süsteem kontrollib, et need oleks kooskõlas versioonimise kontseptsiooniga. Uuel versioonil täidetakse Kehtiv väli hetke ajatempliga. Tühistatud versiooni Kehtetu kuupäeva ei võrdsustata uue versiooni Kehtiv kuupäevaga. Tühistatud versiooni olek muudetakse V (vana) ja uuel versioonil K (kehtiv). Töödeldakse objekti aadressid. >3.2.1; >3.2.2 Initsialiseeritakse komponendid. >3.3 Salvestatakse aadressid >3.2.3 Toodetakse objekti täis- ja lähiaadress tekstina. Arvutatakse ruumiaadress. >3.4 Analüüsitakse soovituslikke aadressimuudatusi ruumiliselt sõltuvatel objektidel. > Tegevused aadressiga Esitatud aadressiandmete analüüs Aadressiobjekti andmete esitamisel kontrollib süsteem esitatud aadressi andmeid, püüab tuvastada olemasolevaid komponente. 1. Kõigepealt kontrollitakse normaliseeritud osa. Alates tasandist 1 vaadatakse järjest läbi kõik esitatud tasandid ning leitakse komponentide versioonitunnused Kui on esitatud tasandi kood, siis otsitakse selle tasandi ja koodiga komponendi kõik versioonid kehtivuse järjekorras Kui ei leitud ühtegi, siis viga Kui leiti ja ka nimi on esitatud, siis võrreldakse esimese leitud komponendi versiooni nimega (vastavalt lühike nimi vastu lühikest ja pikk nimi vastu komponendi pikka nime). Puuduv nimekuju võrdsustatakse olemasolevaga Kui langeb täpselt kokku, siis on korras, komponent sobib ja loetakse selle versioonitunnus Kui ei lange kokku ja objekt initsialiseerib tasandit ja tasand jääb vahemikku 1-5, siis toimub komponendi muudatus. Fikseerub ainult komponendi kood ja uued nimekujud Kui ei lange kokku ja objekt initsialiseerib tasandit ja tasand jääb vahemikku 6-8, siis on tegemist veaga. 6 8 tasemel komponentide versioonimist ei toimu, vaid nime muudatused registreeritakse alati uue komponendina Kui ei lange kokku ja objekt ei initsialiseeri tasandit, siis on viga, kuid vea täpsustamiseks võrreldakse esitatud nime komponendi kehtetute nimekujudega. Kui leitakse kokkulangevus kehtetu nimekujuga, siis antakse viga kehtetu aadressi esitamisest, kui ei leita ühtegi sarnast nime, siis viga ebakorrektse aadressi esitamisest. AS Datel /226

46 1.2. Kui ei ole esitatud tasandi kood ja on esitatud ainult nimetus, siis otsib süsteem kehtivat komponendi versiooni ülemobjekti ja nime alusel Kui leiti, siis loetakse versioonitunnus ja kasutatakse olemasolevat komponenti Kui ei leitud ja objekt initsialiseerib tasandit, siis lisatakse uus komponent tasandile Kui ei leitud ja objekt ei initsialiseeri tasandit, siis viga. 2. Teksti kujul esitatud osa normaliseerimine tasandit initsialiseerival aadressiobjektil ei tohi normaliseerimata osa olla, vaid kogu aadress peab olema esitatud normaliseeritud kujul, vastasel korral viga Käivitatakse normaliseerija, millele antakse lisaks tekstile kaasa viimase normaliseeritud tasandi number ja komponendi kood. Normaliseerija üritab tekstist olemasolevaid komponente tuvastada ning ka initsialiseerivatele tasanditele uute loomise ettepanekuid teha. 3. Tasandite korrektsuse kontroll 3.1. Kui aadress normaliseerus täielikult, siis kontrollitakse, et komponendid oleks määratud vähemalt objektiliigi juures määratud min tasandini, vastasel korral viga komponendid ei oleks määratud täpsemalt, kui objektiliigi juures määratud max tasandini, vastasel korral viga Kui aadressi jäi alles ka normaliseerimata osa, siis neid kontrolle ei tehta Igal juhul kontrollitakse, et uued ja muutunud komponendid esineksid ainult initsialiseerivatel tasanditel. Sisendandmete analüüsi tulemusel on normaliseeritud osa olemasolevad komponendid varustatud komponentide versioonitunnustega, uued ja muutunud komponendid on ilma versioonitunnusteta, kuid olemas mõlemad nimekujud, muutunud komponentidel on tuvastatud kood, normaliseerimata osa on esitatud tekstina. Komponentide muudatused on lubatud vaid objektiliigist tulenevatel initsialiseerivatel tasanditel. Baasi salvestusi tehtud pole. Järgneb komponentide initsialiseerimine ja aadressi salvestus Normaliseerimine Normaliseerija ülesanne on korrastatud ja kontrollitud sisendandmetest lugeda normaliseerimata teksti ning üritada seda paigutada komponentideks. Kui selline komponent baasis ka tegelikult eksisteerib, siis seostab aadressi komponendiga. Kui mitte, siis lisab teksti vastavale tasandile kui võimaliku uue komponendi (eeldusel, et aadressiobjekt initsialiseerib tasandit) Aadressi salvestus Aadress salvestamine toimub pärast seda, kui objekti initsialiseerivad komponendid on toodetud. Aadressi salvestamiseks peavad normaliseeritud osa kõik komponendid omama teadmist versioonitunnuse ja koodi kohta. AS Datel /226

47 Normaliseeritud aadressi salvestus 1. Esitatud aadressiandmete alusel moodustatakse kood-aadress ning otsitakse baasist, kas leidub sellise koodiga aadressi Kui leiti ja aadressi viimane versioon on kehtiv, siis võrreldakse selle tasemeid Kui kõik komponendi versioonid on samad, siis seostatakse aadressiobjekti versioon leitud aadressi kehtiva versiooniga Kui mõni komponent erineb, siis luuakse samast aadressist uus kehtiv versioon, senikehtinud versioon muudetakse kehtetuks ning seostatakse aadressiobjekti versioon loodud versiooniga. (Ülejäänud seosed, mis äsja kehtetuks muudetud aadressi versioonil olid, jäävad puutumata ja ootavad päritoluregistri initsiatiivi) Logitakse aadressi muutmise sündmus Kui leiti ja aadressi viimane versioon on kehtetu, siis luuakse samast aadressist uus kehtiv versioon (aadressi taastamine) ning seostatakse aadressiobjekti versioon loodud kehtiva aadressi versiooniga Logitakse aadressi muutmise sündmus Kui ei leitud koodi alusel aadressi, siis luuakse täiesti uus kehtiv aadress ning seostatakse objekt sellega Logitakse aadressi lisamise sündmus Normaliseerimata aadressi salvestus Normaliseerimata aadresse ADS-is alates jaanuarist ei salvestata Aadressiteksti genereerimine Iga aadressi puhul moodustatakse komponendi nimedest ka aadressi tekstiline kuju. Eristatakse täisaadressi teksti (sisaldab kõiki tasemeid) ja lähiaadressi teksti (alates 4. tasemest). Kõigi tasemete korral kasutatakse üldjuhul komponendi pikka (liigisõnaga) nimekuju. 4. ja 5. taseme korral kasutatakse lühiduse huvides lühikest nimekuju. Lühike ja pikk nimekuju võivad teoreetiliselt erineda ka teistel tasemetel, praktiliselt on nad siiski enamasti samad. Taseme nimetuste vahele pannakse koma ja tühik. 7. taseme nimetuse ette koma kunagi ei panda. Kui tasemele 7 eelneb taseme 6 nimi, siis pannakse eraldajaks kaldjoon / ilma tühikuteta (näiteks Kassi/6). Kui tasemele 7 eelneb taseme 4 või 5 nimi, siis pannakse eraldajaks tühik. Taseme 8 nime ette pannakse alati sidekriips - ilma tühikuteta. NB! Samaaegselt võib kehtida mitu identset aadressiteksti, millel on erinev ADR_ID. See ei ole viga, vaid tuleneb valdavalt sellest, et liikluspinna ja liikluspinda teenindava katastriüksuse aadressidel on sama aadressitekst. Esimesel juhul lõpeb aadress 5. taseme komponendiga ja teisel juhul 6. taseme komponendiga, mis on ühesugused. Näiteks: AS Datel /226

48 Täisaadress Aadress komponentidena ADR_ID Rapla maakond, Rapla vald, Valtu küla, Pargi põik Rapla maakond, Rapla vald, Valtu küla, Pargi põik 1->71-Rapla maakond; 2->668-Rapla vald; 3->8971-Valtu küla; 6->8J41-Pargi põik 1->71-Rapla maakond; 2->668-Rapla vald; 3->8971-Valtu küla; 5->0M4T-Pargi põik Kehtetu objektiversiooni aadressi seoste tühistamine 1. Aadressiobjekti versiooni kehtetuks muutmisel muudetakse kehtetuks ka selle versiooni seosed aadressiga. Ühtlasi kontrollitakse sama aadressi teisi seoseid Kui tühistatakse seos kehtetu aadressi versiooniga, siis täiendavaid muudatusi pole vaja ja sündmust ei logita Kui tühistatakse seos kehtiva aadressi versiooniga, siis logitakse objektilt aadressi eemaldamise sündmus tuleb uurida, kas sellel aadressi versioonil on veel seoseid Kui ei ole, siis tühistatakse aadress ja logitakse aadressi tühistamise sündmus Aadressi muutumise sündmuste logi ADS süsteem registreerib kõik aadresse puudutavad sündmused ning salvestab logikirje iga sündmuse korral. Aadresse puuduvad sündmuste liigid on järgmised: lisamine (I) süsteemi lisandub uue koodaadressiga (esimesed 29 kohta) aadress muutmine (U) aadressist tekib uus versioon komponendi versioneerumise tõttu. Uuel versioonil on sama koodaadress, eelmise versiooni koodaadresss versiooninumber muutub (viimased 4 kohta). tühistamine (D) aadress muutub tervikuna kehtetuks, sest kehtetuks muutus üks tema komponent. seoste kadumine (S) kui kehtetuks muutunud aadress eemaldatakse viimaselt aktuaalselt objektilt taastamine (R) tühistatud aadress muutub uuesti kehtivaks, sest taastatakse tema tühistamise põhjustanud komponent. Taastamise käigus aadressist versiooni ei teki. punkti koordinaatide muutumine (P) kehtiva aadressi esinduspunkti koordinaadid muutuvad, sest aadress omistati mõnele uuele objektile või eemaldati mõnelt objektilt või muutus mõne aadressiga seotud objekti kuju või tähtsus. Sellisel juhul kehtiva aadressi koordinaadid asendatakse, vana seis ei säili. sihtnumbri muudatus (N) aadressile sihtnumbri lisandumise, muutumise või eemaldamise korral tekkiv sündmus. mittemetliku piirkonna nime muudatus (A) aadressile piirkonna nime lisandumise, muutumise või eemaldamise korral tekkiv sündmus. Aadressi muutumise logikirje struktuur LOG_ID logikirje id ADR_ID muutunud aadressi versioonitunnus AS Datel /226

49 SYNDMUS I(insert) aadress lisandus, U(update) aadress versiooniti, D(delete) aadressi viimane versioon muudeti kehtetuks ADOB_ID aadressiobjekti versioonitunnus, mis muudatuse tingis ADOB_LIIK aadressiobjekti liik, mis muudatuse tingis UUS_ADR_ID aadressi versioneerumise korral uue kehtiva versiooni id LOG_STAMP muudatuse ajatempel Aadressi esinduspunkti määramine Sama aadress võib esineda mitmel erineval aadressiobjektil näiteks katastriüksusel ja hoonel. Iga objekti juures on aadressil erinev asukoht, st aadressipunkti koordinaadid on iga objekti puhul erinevad. Kui vaadelda aadressi iseseisvalt, mitte objektide kontekstis, siis on aadressil vaja ka esinduspunkti. Selle määramine toimub ADS süsteemi poolt automaatselt. Aadressi esinduspunkti arvutamine toimub objektide muudatuste registreerimise järeltegevusena, vahetult pärast seotud objektide arvutust. Kui ADS menetluse jõustamisel menetluses osalenud objekt põhisüsteemis ei muutu sellisel määral, et temast tekiks uus versioon, siis aadressipunkti koordinaadid võisid ikkagi muutuda. Kui see toimus, siis on ikkagi vaja üle arvutada ka aadressi esinduspunkti koordinaadid. Aadressi esinduspunkti ümberarvutamise vajadus logitakse eraldi ning vastav protsess töötleb seda logi. Esinduspunkti määramise ärireeglid: Ainult taset omavate aadresside puhul on esinduspunktiks alati kõige täpsemat komponenti ehk aadressi ennast initsialiseeriva objekti viitepunkt. Kui sellist aadressi omab ka mõni muu objekt (näiteks hoone), siis need objektid aadressi esinduspunkti asukohta ei mõjuta. Ainult taset omavate aadresside ehk EHAK aadresside puhul toimub aadressipunkti määramine kasutaja poolt käsitsi tasemega aadressi esinduspunkti määramisel hakkab rolli mängima aadressi omavate objektide prioriteet. Nii vaadeldavat aadressi kui ka ruumikuju omavad jõusolevad objektid järjestatakse liigi tähtsuse alusel järgmiselt (tähtsuse kahanev järjekord): ER, MR, EE, ME (need liigid loetakse võrdseks) CU Kui mitte ühtegi ruumikujuga objekti sel aadressil pole, siis aadressi esinduspunkt eemaldatakse, kui ta eksisteerib.edasise vaatluse alla võetakse kõige prioriteetsema liigiga objektid (neid võib ka mitu olla). Liikide ER ja MR puhul täiendavaid ärireegleid ei ole ja valitakse esimene võimalik. Liikide EE ja ME puhul rakendub teise reeglina un-tunnuse kontroll. Kui hulgas leidub un-tunnusega objekte, siis jäävad edasisse analüüsi ainult need. Kui mitte ühtegi un-tunnusega objekti pole, siis jäävad kõik objektid edasisse analüüsi. Kolmanda reeglina rakendub seotud hooneosade arvu kontroll. Analüüsi jäänud hoonetest eelistatakse neid, mil seotud hooneosi on rohkem. AS Datel /226

50 Kui ka hooneosade arvuga ei suudeta ühe objektini jõuda, vaid ikka jääb kaalule mitu objekti, siis neljanda reeglina rakendub pindala kontroll. Eelistatakse suurema pindalaga hoonet. Kui ka see ei peaks ühest tulemust tagama, siis valitakse esimene juhuslik hoone sõelale jäänud hulgast. Kui ühe hooneni on jõutud, siis tehakse veel täiendav analüüs. Leitakse sama aadressi omavad katastriüksused, mille ruumikuju on pind (teatavasti võib esineda ka punktikujulisi ADSs loodud KÜ-sid) ning millel leidub ühisosa vaadeldava hoonega. Nendest ühisosadest (kui neid peaks olema mitu) moodustatakse ajutine ühendobjekt. Edasi kontrollitakse, kas valitud prioriteetseima hoone aadressipunkt asub selle ühendobjekti sees. Kui asub, siis on korras ja hoone aadressipunkt on aadressi esinduspunktiks sobiv. Kui ei asu, siis paigutatakse aadressipunkt ajutise ühendobjekti sisse (viitepunkti asukoht arvutatakse ühendobjekti suhtes sama algoritmiga nagu ADSis tavaks). Liigi CU korral rakendub teise reeglina un-tunnuse kontroll. Kui hulgas leidub un-tunnusega objekte, siis jäävad edasisse analüüsi ainult need. Kui mitte ühtegi un-tunnusega objekti pole, siis jäävad kõik objektid edasisse analüüsi. Kolmanda reeglina rakendub pindala kontroll. Eelistatakse suurima pindalaga üksust. Kui ka see ei peaks ühest tulemust tagama, siis valitakse esimene võimalik. Aadressi esinduspunkt muudetakse vaid sel juhul, kui kontrolli tulemusena leitud esinduspunkti koordinaadid erinevad olemasoleva esinduspunkti koordinaatidest täpsusastmega 2 kohta peale koma. Esinduspunkti muudatus tekitab ka aandressile täiendava logi. Logisündmus on P punkti muutumine. 3.3 Tegevused aadressikomponentidega Aadressikomponentide initsialiseerimine Objekti iga aadress võib initsialiseerida 1 või mitu aadressikomponenti. Objekti iga versiooni esitamise korral töödeldakse kõik tema aadressid ning lisatakse või versioonitakse muutunud komponendid initsialiseerivatel tasanditel. Komponent lisatakse, kui objekti aadressis on initsialiseerival tasandil pärast sisendandmete analüüsi väärtustatud ainult nimi ning puudu komponendi kood ja id. Komponent versioonitakse, kui sisendandmete analüüs leidis küll initsialiseerival 1-5 tasandil etteantud koodiga komponendi, kuid sellel on registris teistsugune kehtiv nimekuju kui esitatud. Teise sammuna uuritakse kõiki neid initsialiseerivaid seoseid, mis objektil juba varem olid ning kontrollitakse, kas objekti aadresside hulgas leidub jätkuvalt vastaval tasandil vastav nimi. Kui ei leidu, siis tühistatakse initsialiseeriv seos Komponendi lisamine Enne komponendi lisamist peab olema kontrollitud, et lisatava komponendi ülemkomponent oleks kehtiv ja et süsteemis ei leiduks sellel ülem-komponendil esitatud nimega kehtivat alam-komponenti ükskõik millisel tasemel. (Aadressi analüüs). AS Datel /226

51 1. tasandi komponendil ülem-komponent puudub ja seal kontrollitakse, et 1. tasandil ei leiduks esitatud nimega kehtivat komponenti. Lisatakse kirje tabelisse AADRESS_KOMPONENDID. Genereeritakse uus id (versioonitunnus) ja kood vastavalt komponendi tasandile. Omistatakse tase, ülemkomponendi tase ja kood, sisendis antud lühike ja pikk nimi. Komponendi versiooni KEHTIV kuupäev võrdsustatakse objekti versiooni KEHTIV kuupäevaga. Lisatakse initsialiseeriva seose kirje tabelisse ADKOMP_INIT. Seose kirje KEHTIV kuupäev võrdsustatakse objekti versiooni KEHTIV kuupäevaga. Lisatakse komponendi muudatuste logisse kanne komponendi lisamise kohta Komponendi versioonimine Komponendi versioonimine on võimalik ainult 1 5 tasandi korral. Enne komponendi versioonimist peab olema kontrollitud, et viidatud komponendi ülem-komponent vastab esitatud andmetele, et see omab endiselt kehtivat versiooni ning et süsteemis ei leiduks sellel ülem-komponendil esitatud nimega kehtivat alamkomponenti ükskõik millisel tasemel. (Aadressi analüüs). 1. tasandi komponendil ülem-komponent puudub ja seal kontrollitakse, et 1. tasandil ei leiduks esitatud nimega kehtivat komponenti. Lisatakse kirje tabelisse AADRESS_KOMPONENDID. Genereeritakse uus id (versioonitunnus). Kood, tase ja ülem-komponendi andmed kopeeritakse eelmisest versioonist ning need ei tohi olla muutunud. Komponendi versiooni KEHTIV kuupäev võrdsustatakse objekti versiooni KEHTIV kuupäevaga. Komponendi eelmise kehtiva versiooni KEHTETU kuupäev uue versiooni KEHTIV kuupäevaga. Ainult lühinime muutuse korral versioonitakse komponente 4. ja 5. tasemel. See on vajalik, kuna aadressides esindavad neid tasemeid just komponentide lühinimed. Seetõttu toob 4. ja 5. tasemel komponendi lühinime muudatus kaasa ka seotud aadresside versioonimise. Kontrollitakse kas komponendil eksisteerib kehtiv seos initsialiseeriva aadressiobjektiga. Kui ei, siis lisatakse kirje tabelisse ADKOMP_INIT. Seose kirje KEHTIV kuupäev võrdsustatakse objekti versiooni KEHTIV kuupäevaga. Lisatakse komponendi muudatuste logisse kanne komponendi muutmise kohta Initsialiseerivate seoste tühistamine Uuritakse aadressiobjekti kehtivaid initsialiseerivaid seoseid aadressikomponentidega. Iga komponendi puhul tuvastatakse kas kehtiv komponendi versioon kajastub mõnes objekti aadressis vastaval tasandil. Kui ei kajastu üheski aadressis, tunnistatakse see seos kehtetuks. Täidetakse seose kirjes KEHTETU kuupäev objekti andmete esitamise kuupäevaga. Kui tühistatud seos initsialiseeris 1 5 tasandi komponenti, siis tühistatakse ka komponent. Kui tühistatud seos initsialiseeris 6 8 tasandi komponenti, siis uuritakse, kas komponendil jäi veel kehtivaid initsialiseerivaid seoseid. Kui ei jäänud siis tühistatakse komponent. AS Datel /226

52 Komponendi tühistamine Komponendi tühistamisel täidetakse komponendi kehtival versioonil KEHTETU kuupäev objekti andmete esitamise kuupäevaga ning lisatakse komponendi muudatuste logisse kanne komponendi tühistamise kohta Aadressikomponendi muutumise sündmuste logi ADS süsteem registreerib kõik aadressikomponente puudutavad sündmused ning salvestab logikirje iga sündmuse korral. Komponente puuduvad sündmuste liigid on järgmised: lisamine (I) süsteemi lisandub uue koodiga komponent muutmine (U) taseme komponendist tekib uus versioon nimetuse või ülemobjekti seose muutumise tõttu. Uuel versioonil on sama kood taseme komponent ei saa versioneeruda. tühistamine (D) komponent muutub tervikuna kehtetuks, sest kehtetuks muutus viimane (või ainus) teda initsialiseeriv aadressiobjekt seoste kadumine (S) kui muutub kehtetuks viimane aadress, mis kasutab tühistatud komponenti taastamine (R) tühistatud komponent muutub uuesti kehtivaks, sest tekib sellise andmetega komponendi lisamise vajadus, milline on juba tühistatuna olemas. Taastamise käigus komponendist versiooni ei teki. Logikirje struktuur: LOG_ID logikirje id TASE muutunud komponendi tase KOMP_KOOD muutunud komponendi kood KOMP_ID muutunud komponendi versioonitunnus SYNDMUS I(insert) komponent lisandus, U(update) komponent versiooniti, D(delete) komponendi viimane versioon muudeti kehtetuks ADOB_ID aadressiobjekti versioonitunnus, mis muudatuse tingis ADOB_LIIK aadressiobjekti liik, mis muudatuse tingis UUS_KOMP_ID komponendi versioneerumise korral uue kehtiva versiooni id LOG_STAMP muudatuse ajatempel Sündmuste esinemine võib põhjustada süsteemis järeltegevusi, mida tehakse logi alusel perioodiliselt Järeltegevus komponendi lisamise korral Komponendi lisandumise korral tehakse analüüs, mille alusel leitakse võimalikku aadressimuutust vajavad objektid. Vajadusel logitakse muudatusettepanekud Järeltegevus komponendi versioonimise korral Komponendi versioonimise korral käiakse läbi kõik kehtivad aadressi versioonid, mis sisaldavad viidet muutunud komponendi versioonile. Need aadressi versioonid AS Datel /226

53 muudetakse kehtetuks ning luuakse uued aadressi versioonid, mis sisaldavad juba kehtivat komponendi versiooni. Uued aadressi versioonid jäävad ilma objekti seoseta. Kõigi nende objektide kohta, mis jäid tegevuse tulemusel seotuks kehtetu aadressi versiooniga, logitakse aadressi muutmise kohustus. Uueks aadressiks pakub süsteem uut aadressi versiooni Järeltegevus komponendi kehtetuks muutumise korral Komponendi kehtetuks muutumisel muudetakse kehtetuks kõik need kehtivad aadressi versioonid, mis sisaldavad viidet muutunud komponendile. Uut aadressi versiooni ei teki. Kõigi nende objektide kohta, mis jäid tegevuse tulemusel seotuks kehtetu aadressi versiooniga, logitakse aadressi muutmise kohustus. Uus aadress leitakse vastavate ärireeglite alusel ruumianalüüsi abil. Ärireeglites on tähtsal kohal info, milline objektiliik muudatuse tingis. Sellest sõltuvalt võidakse tuvastada täiendavalt aadressi muutmist vajavaid objekte ning leitakse võimalikud uued aadressid Sünonüümide lisamine Komponentide sünonüüme kasutatakse otsingutes aadressi leidmiseks. Sünonüümid ei osale aadressi alternatiivsete nimekujude moodustamisel. Sünonüümid on aadressiga komponentide kaudu küll seotud, kuid aadressi esitlusfunktsioon neil puudub. Päringute kiirendamise eesmärgil lisatakse sünonüümide hulka automaatselt ka komponendi ametlik lühike ja pikk nimekuju. Sünonüüme saab komponentidele lisada vastavate õigustega kasutaja käsitsi läbi rakenduse. Süsteem lisab sünonüüme automaatselt ärireeglite alusel komponendi lisamise ja muutumise sündmuste korral. Kõik sünonüümid salvestatakse suurtähtedena, et kaotada erinevus suur- ja väiketähtede vahel. Sünonüümide lisamisel (nii käsitsi kui ka automaatselt) kehtib reegel, et sama ülem-komponendi lõikes ei või sünonüümid korduda samal tasemel. Korduva nimega sünonüüm jäetakse lisamata, kehtima jääb ta varem lisatud komponendi juures. Kõik kehtiva komponendi sünonüümid on automaatselt kehtivad. Neid saab kustutada ainult käsitsi läbi rakenduse. Komponendi kehtetuks muutumisel muutuvad automaatselt kehtetuks ka kõik tema sünonüümid ning samu sünonüüme on võimalik omistada teistele komponentidele. Ärireeglid sünonüümide automaatsel lisamisel: Kui 4. taseme komponendi nimi lõpeb tuntud liigisõna või selle lühendiga, siis lisatakse automaatselt sünonüüm, kus liigisõna ja selle lühend esinevad nimetuse ees. Näiteks: Kajakas AÜ sünonüüm AÜ KAJAKAS; Kajakas aiandusühistu sünonüüm AIANDUSÜHISTU KAJAKAS. Tuntud liigisõnad ja lühendid on: aiandusühistu suvilaühistu garaažiühistu AÜ SÜ GÜ AS Datel /226

54 Kui 5. taseme komponendi pikk nimi lõpeb tuntud liigisõnaga, siis lisatakse automaatselt sünonüüm liigisõna lühendiga. Tuntud liigisõnad ja lühendid on: tänav -> TN puiestee -> PST maantee -> MNT väljak -> V väljak -> VL plats -> P plats -> PL tee -> T Aadresskomponendi korrektsuse kontroll Komponentide lisamise, muutmise, tühistamise ja taastamise sündmuse järeltegevusena tehakse süsteemis komponendi sisulise ja loogilise korrektsuse kontroll. Kontrollimisel leitud probleemid salvestatakse süsteemi ning neid kuvatakse ADS suunatud rakenduses. Probleemid klassifitseeritakse. Mõni probleem võib olla selline, mida andmeesitaja peab viivitamatult parandama. Sellised probleemid tekitavad aadressivea, mis suunatakse ka andmeesitajale. Ülejäänud probleemid on ainult informatiivse iseloomuga ning suunatud ADS süsteemi haldajaile. Tulevikus on võimalik hakata teatud kontrolle rakendama ka andmete esitamisel. Mittevastavuse korral ADS andmeid vastu ei võta. Esialgu esitamist ei tõkendata ning ADS registreerib ka probleemseid komponente. Probleemid logitakse informatiivses mõttes. Menetlusrakenduse kaudu on probleemsete andmete registreerimine tõkendatud, kuid EHR-i kaudu esitatavad andmed ei läbi menetlust, seega tekivad probleemsed komponendid EHR-i kaudu ilma tõkestuseta. ADS haldaja saab menetlusrakenduses märkida probleeme mitte-aktuaalseteks ehk kinnitatud eranditeks. Komponente saab menetlusrakenduses probleemide alusel otsida. Süsteem eemaldab probleemi ise, kui selle lisamise põhjus on kõrvaldatud ehk komponent on muudetud reeglitele vastavaks. See saab toimuda aga ainult komponentide muutmise sündmuste käigus. Probleemi liigid ning nende kontrollimise sündmused on kirjeldatud alljärgnevas tabelis. Süsteem kontrollib kirjeldatud sündmuste ajal komponendi vastavust tingimustele. Mittevastavuse korral lisab probleemi (topelt ei lisa), vastavuse korral eemaldab probleemi (kui ei olnudki, siis ei saa ka eemaldada). Probleem Kirjeldus Sündmus 101 Komponendi nimi ei tohi sisaldada numbreid I, U sündmus tasemel 4, Komponendil on vähem kui 3 alamat I sündmus tasemel 4, 5 I, D, R sündmus tasemel 7 (kontrollitakse komponendi ülemat) 103 Komponendi alluvaks on nimetuse komponent I, D; R sündmus tasemel 6 Kontrollitakse komponendi ülemat tasemel 4 ja Komponendi nimes on liigsed tühikud I, U, R sündmus tasemel 4, 5, 6, 7, Nimetuses suurtäht vales kohas I, U, R sündmus tasemel Nimetus ei alga suurtähega I, U, R sündmus tasemel Nimetuses esineb üksik täht I, U, R sündmus tasemel 6 AS Datel /226

55 108 Komponendis sisaldub ebakorrektseid sümboleid I, U, R sündmus tasemel 6, 7, Nimetuses sidekriipsu vale kasutamine I, U, R sündmus tasemel Komponendis sisaldub ebasobivaid tähti I, U, R sündmus tasemel 6, 7, Nimetusel on ebasobiv algustäht I, U, R sündmus tasemel Nimetuses ebakorrektne sõna I, U, R sündmus tasemel Komponendis sisaldub ebakorrektne number I, U, R sündmus tasemel 6, 7, Komponent ei tohi sisaldada suurtähti I, U, R sündmus tasemel 7, Komponendi nimes on mitu tähte järjest I, U, R sündmus tasemel 7, Komponendi nimes on tähed ebasoovitavad I, U, R sündmus tasemel Komponendi nimetuse osa peab algama I, U, R sündmus tasemel 7, 8 numbriga 118 Alamkomponentide numbrivahemikud on liiga suured I, U, R, D sündmus tasemel 7, Komponendi nimi ei tohi sisaldada numbreid (tase 4 ja 5). Süsteem kontrollib, et nimetus ei sisaldaks araabia numbreid. Varasemast ajast on mõningaid tänavaid ka numbritega nimetatud, kuid alates 2004-ndast aastast on see keelatud. 102 Komponendil on vähem kui 3 alamat. Komponendi lisamisel tasemele 4 või 5 lisandub see probleem automaatselt, sest sel hetkel ei saa komponendil olla alamaid. Taseme 7 sündmuste korral kontrollitakse komponendi vahetut ülemat. Kui sel on 3 või enam alluvat tasemel 7, siis loetakse tingimus täidetuks, kui vähem, siis on probleem. 103 Komponendi alluvaks on nimetuse komponent. Kui tasemele 6 lisandub komponent, mille ülemaks on 4 või 5 taseme komponent, siis lisatakse probleem ülemkomponendile. Kui tasemel 6 tühistatakse komponent, mille ülemaks on 4 või 5 taseme komponent, siis ülemalt probleem eemaldatakse. 104 Komponendi nimes on liigsed tühikud. Mitte ühegi komponendi nimi ei tohi alata ega lõppeda tühikuga. Nime sees ei tohi olla 2 tühikut kõrvuti. Tasemel 7 ja 8 ei tohi nimetuses üldse tühikuid olla. 105 Nimetuses suurtäht vales kohas. Taseme 6 komponendi nimes tohib suurtäht esineda vaid sõna alguses. Talle peab vahetult eelnema kas tühik või sidekriips või ta peab olema esimene täht nimetuses. Taseme 6 komponendi nimetuses on 2 järjestikkust suurtähte keelatud. Suurtähele peab järgnema väiketäht või number, ei tohi järgneda suurtäht, tühik, sidekriips ega mingi muu sümbol. 106 Nimetus ei alga suurtähega. Tase 6 nimetuse esimene täht peab olema suurtäht. Kui nimetus algab numbriga, siis peab talle järgnema tühik või sidekriips ning sellele järgnev sõna peab algama suurtähega 107 Nimetuses esineb üksik täht. Tase 6 nimetuses on üksik täht keelatud (näiteks Kaera A või Kuuse b ). Varasemal perioodil on tihti teid teenindavate maade korral nimeks näiteks Pikk tänav L 1 nüüd peab need nimed ümber muutma nii, et L-i ja nr 1 vahele ei jääks tühikut. 108 Komponendis sisaldub ebakorrektseid sümboleid. Tase 6 nimetuses ei või esineda mingeid muid sümboleid peale sidekriipsu. Sellel reeglil on järgmised erandid. Koma võib esineda 2 numbri vahel. Näiteks raudteed teenindava maaüksuse nimi Tartu-Petseri raudtee 37,9-40,9 km. Veel on lubatud erandina punkt, kui sama ülema all leidub 4. või 5. tasemel komponent, mille lühikuju sisaldub täielikult kontrollitavas nimetuses. Lühikuju kontrollitakse ilma liigisõna lühendita. (Näiteks. AS Datel /226

56 Kui Tallinna kesklinnas on "A. Laikmaa tn" (lühikuju), siis on lubatud "A. Laikmaa tänava lõik" nimetusena. Kui Mustamäel on "E. Vilde tee" (lühikuju), siis "E. Vilde tee maaüksus" on lubatud, aga "E. Vilde maaüksus" ei ole lubatud.) Tasemete 7 ja 8 nimetuses ei tohi esineda muid sümboleid kui 1 kaldjoon /. Kaks kaldjoont kõrvuti on keelatud. 109 Nimetuses sidekriipsu vale kasutamine. Tase 6 nimetuses võib sidekriips esineda nii, et kummalgi pool on tühik või ka ilma tühikuteta. Nimetus ei või alata ega lõppeda sidekriipsuga. Sidekriipsule (tühikuid arvestamata) ei või eelneda ega järgneda number. Erandiks on juhud, kus mõlemal pool on number ehk sidekriips on numbrite vahel. Näiteks Tartu-Petseri raudtee 37,9-40,9 km. 110 Komponendis sisaldub ebasobivaid tähti. Tase 6 nimetuses ei tohi üldjuhul esineda muid tähti, kui ainult eesti keele tähed (23 tähte). Süsteemis kehtestatakse erandsõnade loend, mis on lubatud ja mis võivad sisaldada võõrtähti. Tase 7 ja 8 nimes ei tohi esineda 23 eesti tähest veel sellised {i, l, o, õ, ä, ö, ü} aga tohivad esineda tähed {c, f, y, z}. 111 Nimetusel on ebasobiv algustäht. Tase 6 nimetus ei tohi alata G, B või D tähega (esimene sõna nimetuses). Kui sõna sisaldub erandsõnade loendis, siis võib alata. 112 Nimetuses ebakorrektne sõna. Tase 6 nimetuses on keelatud teatud reserveeritud liigisõnade kasutamine. Süsteemis kehtestatakse erandsõnade loend, mis ei tohi esineda nimetuses. (Näiteks: küla, alev, alevik jne) 113 Komponendis sisaldub ebakorrektne number. Tase 6, 7 ja 8 nimetuses ei või esineda üksik number 0 ja numbrite grupp ehk arv ei või alata numbriga 0. Tasemete 7 ja 8 nimetustes käsitletakse sõna ehk grupi eraldajana kaldjoont, kuna tühikud ei või esineda. 114 Komponent ei tohi sisaldada suurtähti. 7. ja 8. taseme komponendi nimes ei tohi esineda suurtähti. Tohivad olla ainult väikesed tähed Komponendi nimes on mitu tähte järjest. Taseme 7 ja 8 nimetuses ei tohi olla 2 (või enam) tähte järjest. 116 Komponendi nimes on tähed ebasoovitavad. 8. taseme komponendi nimes ei tohi esineda tähti. 117 Komponendi nimetuse osa peab algama numbriga. Taseme 7 ja 8 nimetuses käsitletakse kaldjoont sõna eraldajana, kuna tühikud ei või esineda. Sõna peab algama numbriga Alamkomponentide numbrivahemikud on liiga suured. Tasemetel 7 ja 8 ei tohiks olla ülema lõikes numbrite järjepidevuses suuri hüppeid. Üle 10 numbri suurused vahed loetakse vigadeks. Probleem lisandub kontrollitava komponendi ülemale. 119 Komponendi pikk ja lühike nimekuju pole võrdsed. Tasemetel 7 ja 8 ei tohi pikk ja lühike nimekuju erineda. Veateadete selgitused on toodud ka menetlusrakenduse kasutajajuhendis ning lisatud rakendusse kus vea ilmnemisel kasutaja saab lisainfot lugeda. AS Datel /226

57 3.3.6 Pühendusnimede käsitlus Pühendusnimi on isiku järgi määratud kohanimi. Näiteks Amandus Adamsoni tänav, lühendatakse A. Adamsoni tn. Pühendusnimede erikäsitlus puudutab peamiselt 5. (teoreetiliselt ka 4.) taseme komponente. Pühendusnimedega seotud reeglid realiseeritakse ADS väliselt Kohanimeregistris. Kohanimeregistris on võimalik liikluspinna ja väikekoha objektidele märkida tunnus pühendusnimi. Sellise tunnusega objektidele rakendub teistsugune nimekuju kontroll kui ülejäänud objektidele. Kui tavaliselt on komponendi nimes punkt keelatud sümbol, siis pühendusnime lühikujus on punkt lubatud. Punktile peab järgnema tühik. Liigisõnale rakendub samasugune kontroll nagu ülejäänud objektidel, aga liigisõnale eelnev sõna peab olema lühikeses ja pikas nimekujus täpselt võrdne. Kontroll rakendub enne andmete esitamist ADSi. ADS pühendusnimesid täiendavalt ei kontrolli. ADSi ei laeku ka teadmist, et tegemist on pühendusnimega, seetõttu ei käsitle ADS pühendusnimesid erinevalt teistest komponentidest. 3.4 Tegevused ruumiaadressiga Kui muutus objekti kuju, siis arvutatakse ümber objekti ruumiaadress vahetult peale andmete esitamist. Kui muudetav objekt oli EHAK tüüpi (liigid MK, OV, AY, LO), siis arvutatakse ruumiaadress ümber kõigil objektidel, mille ruumiaadress sisaldab objektist tekkinud komponenti pluss nendel, mille aadress ei sisaldanud seda komponenti, kuid mis ruumiliselt jäävad muudetava objekti alasse. Samuti arvutatakse igal juhul üle muutunud objekti enda ruumiaadress. 3.5 Järgnevussuhete arvutamine ADS süsteem püüab järeltegevusena leida tühistatud komponentidele, aadressidele ja objektidele järglasi. Järglased leitakse ainult kehtivate olemite hulgast. Järgnevussuhete analüüs ei tegele võimalike aadressimuudatuste ennustamisega sellega tegeleb aadressivigade leidmise protsess. Järgnevussuhe tuvastatakse, kui järglane on süsteemis juba registreeritud. Järgnevussuhete arvutamine toimub öise järeltegevuste protsessi käigus. Online s kasutamiseks on protsess liiga andmemahukas ja aeganõudev. Järgnevussuhted leitakse komponentidel, aadressidel ja objektidel eraldi. Arvutamise protsessi aluseks on andmete muutmise sündmuste logid. Logid tekivad online s koos muudatuste tekkimisega. Neid logisid töödeldakse nende tekkimise (sündmuste toimumise) järjekorras. Järgnevussuhete protsess kasutab komponentide logi objektide muudatuste logi objekti ja aadressi seoste muudatuste logi Näiteks, kui on toimunud EHAK muudatus, siis järeltegevusena töödeldakse kõigepealt see sündmus ning suure tõenäosusega tuvastatakse kohe ka järgnevused EHAK komponentide osas. Seejärel tühistatakse kõik alam-komponendid, aga järgnevust neile veel ei leita. Järgnevus leitakse neile siis, kui süsteemi tekivad AS Datel /226

58 asendavad komponendid ja aadressid ehk kui tänavatel ja majadel on aadress ära muudetud. Muutmisvajaduste tuvastamise protsess püüab välja pakkuda tühistatud aadressidele asendust. See protsess kasutab ära EHAK järgnevust ja moodustab perspektiivsed aadressid, st tühistatud aadressides vahetab EHAKi välja jättes ülejäänud komponendid samasugusteks. Alamtasemete järgnevussuhted tuvastatakse järk-järgult vastavalt muudatuste laekumisele ADS süsteemi. Pikemalt on järgnevussuhete arvutamist kirjeldatud pt. 8 Tühistatud komponentide, aadresside ja objektide järgnevus. 3.6 Aadressiobjekti probleemid ADS põhissüsteemis kontrollitakse pidevalt aadressiobjektide ja aadresside korrektsust ning vastavust ärireeglitega kehtestatud nõuetele. Iga ärireegel põhjustab teatud koodiga probleemi tekkimise objekti ja/või tema aadressi juurde. Probleemid seotakse objekti kui tervikuga, analüüsis osalevad ainult objekti viimased jõusolevad andmed. Ärireeglid on põhimõtteliselt samad, mida kontrollitakse menetluse jõustamisel. Menetluse jõustamisel on kontrolle natuke rohkem, sest seal võivad esineda ka vead, mida põhisüsteemis olla ei saa (näiteks objekt ei asu andmeid muutva organisatsiooni tööpiirkonnas vms.) Kontrollid on kirjeldatud käesoleva spetsifikatsiooni peatükkides Kui objekti andmed muudeti menetluses ja enne menetluse jõustamist muudeti mõned probleemid mitteaktuaalseks, siis kirjutatakse need jõustamise hetkel menetlusest põhisüsteemi mitteaktuaalsena ümber. Samuti võivad menetluses objektile külge jääda ka aktuaalsed probleemid, sest sõltuvalt menetluse liigist võivad probleemid olla märgitudjõustamist mittetakistavaks. Need kirjutatakse aktuaalsena põhisüsteemi. Edaspidi kontrollib süsteem perioodiliselt probleemide esinemist. Seda tehakse seotud objektide muutumisel automaatselt, sest paljud ärireeglid sätestavad objektide omavahelistest seostest tulenevaid nõudeid (aadressi unikaalsus, sobivus seotud objektidel jne). Kui mõni probleem on objektil kadunud, siis märgitakse see kustutatuks. Kustutamine ja mitteaktuaalseks märkimine on erinevad asjad. Mitteaktuaalseks märkimine tähendab, et probleem küll esineb, kuid seda käsitletakse lubatud erandina. Mitteaktuaalsust saab ka tagasi võtta, jälle aktuaalseks muuta. Mitteaktuaalseks märkimisest on rohkem juttu menetluse kontekstis peatükis Probleem kustutatakse siis, kui ta objektil enam ei esine. Ajaloo säilitamiseks probleeme täielikult ei eemaldata, vaid ainult märgitakse kustutatuks. Kui sama probleem objektile jälle tekib, siis lisatakse uus probleemi kirje. Nii on võimalik hiljem statistilistel eesmärkidel analüüsida probleemide dünaamikat. AS Datel /226

59 3.6.1 Käsitsi lisatavad probleemid ADS haldajal on võimalik süsteemi probleemide klassifikaatorisse sisestada selliseid veateateid, mida süsteem automaatselt ei kontrolli aasta juunis on käsitsi lisatavad probleemid sellised: 301 Nimi ei vasta kohanimele esitatavatele nõuetele taseme komponendis sisaldub araabia number 303 Rooma numbri kasutamine katastriüksuse lähiaadressis ei ole lubatud 305 Katastriüksuse nimi liigselt kirjeldav 306 Eksitavalt sarnane teise katastriüksuse lähiaadressiga 307 Sama kohanime nimetuumade kirjapilt peab olema ühesugune Nimetuum peab olema üldjuhul omastavas käändes, hargtäiendi puhul 308 ühendatud sidekriipsuga 309 Liigisõna peab olema üldjuhul nimetavas käändes ja väikse algustähega Nimi ei vasta eestikeelsuse nõuetele võõrapäraste puhul vajalik kultuuri- või 310 ajalooline põhjendus 311 Katastriüksuse aadressiga seotud kohanimi kehtestamata või probleemne 312 Nimes esineb ebasobiv või eksitav liigisõna 313 Katastriüksuse nimi kordab asustusüksuse nime 314 Katastriüksuse lähiaadress ei ole unikaalne 315 Ebaloogiline numeratsioon 316 Nimes esinevad ebasobivad sümbolid või suurtähed vales kohas Soovitame paralleelaadressist loobuda ja adresseerida üksus liikluspinna järgi, 317 kust on peamine ligipääs 318 Hoonestatud üksus - adresseerida aadressikoha järgi 320 Katastriüksuse lähiaadress ei vasta nõuetele 321 Katastriüksus ei oma juurdepääsu adresseerimiseks kasutatud liikluspinnalt 322 Soovitame katastriüksuse lähiaadressi muuta või selgitada nimevalikut Haldajal on võimalik selliseid probleeme objektidele käsitsi lisada, mitteaktuaalseks märkida ja kustutada otse põhisüsteemis ilma menetluseta. Objekti menetlusse võtmisel võetakse kõik käsitsi lisatud probleemid menetlusse kaasa. Mitteaktuaalseks märgitud probleemid võetakse aktuaalsena menetlusse. Samal ajal automaatselt leitavaid probleeme ei võeta kaasa. Menetluse sees kehtivad käsitsi lisatud veateadetele samad reeglid nagu automaatselt leitutele: sõltuvalt häälestusest võivad nad takistada menetluse jõustamist, neid saab mitteaktuaalseks märkida vastavalt tühistamise tasemele. Lisavõimalusena saab ADS haldaja rolliga kasutaja menetluse sees objektidele käsitsi probleeme lisada ja neid kustutada. Kui menetluse sees on käsitsi lisatav probleem kustutatud, siis menetluse jõustamisel kustub see ka aktuaalsetest andmetest Probleemidega tutvumine registris Jõusoleva objekti detailandmete lehel kuvatakse kõik tema aktuaalsed ja mitteaktuaalsed probleemid. Kustutatud probleeme ei kuvata, neid kasutatakse vaid statistilistel eesmärkidel. Probleemide alusel on võimalik põhiregistris objekte otsida. Leitud objektidega saab koheselt alustada menetlust. AS Datel /226

60 Probleemide arvu ja probleemsete objektide kohta saab süsteemist mitmeid statistilisi aruandeid Probleemidega tutvumine kaardil Kaardiaknas kuvatakse põhisüsteemis leiduvate objektide juurde probleemi ja märkuse tunnused. Mitteaktuaalseks märgitud probleemi käsitletakse märkusena. Probleemil ja märkusel on erinevad ikoonid, mida on kaardiaknas võimalik eraldi sisse-välja lülitada. Probleemi ikoon kuvatakse nende objektide juurde, mil leidub aktuaalseid probleeme. Kui probleeme on mitu, siis kuvatakse ikoon ühekordselt. Märkuse ikoon kuvatakse nende objektide juurde, mil leidub mitteaktuaalseid probleeme või märkuseid. Kui märkusi on mitu, siis kuvatakse ikoon ühekordselt. Probleemide ja märkuste sisu näeb objekti infopäringus loendina. Seda kuvatakse ka siis, kui vastavad ikoonid ei ole kaardiaknasse tellitud. Kuna infoaknas on väga vähe ruumi, siis tõenäoliselt on kasutajal ebamugav neid hallata, kui probleeme on mitu või kui märkuse tekst on pikk. Objekti infoaknast on võimalik 1 hiireklõpsuga avada objekti detailandmete vorm, kus on võimalik probleeme lahendada või märkusi lisada. Märkusi on võimalik objektile lisada ka kaardiaknast lahkumata. Selleks tuleb märgistada kaardil soovitud objektid ja vajutada tegevusnuppu Lisa märkus. Avaneb teksti sisestamise võimalus ja märkus salvestub kõigi märgitud objektide külge Liikluspindade ja väikekohtade probleemid Lisaks ADSs menetluste kaudu hallatavatele objektidele arvutatakse probleeme ka liikluspindadele ja väikekohtadele. Seda tehakse automaatselt objekti andmete esitamisel KNRst ja EHAK muutusest tingitud ruumiaadressi muutumisel. Lisaks on võimalik kasutajal käivitada probleemide kontroll rakenduse kaudu. Probleemide arvutus hakkab asendama teavitusteenust, mille kaudu toimus siiani probleemide vahendamine KNRi. Alates juunist 2013 aga probleeme enam KNRi ei vahendata. Aadressimuudatusi hakkab KNR tegema aadressi muudatuste logi ja järglaste arvutuse põhjal. Probleemidega on võimalik tutvuda ADS süsteemis. Liikluspindadel ja väikekohtadel kontrollitakse järgmisi probleeme. Vea kood Vea kirjeldus 8 Objekti kuju on kohustuslik 89 Objekti kuju ei ole korrektne: [kuju on vale tüüpi] Objektiliigi VK kuju tohib olla vaid pind, objektiliigi LP kuju tohib olla vaid joon 134 Objekti kuju kattub samaliigilise objekti kujuga põhisüsteemis: [ADS-OID loetelu kattuvate objektide kohta] Pindobjekti korral ei tohi tema kuju olla ülekattes teise samaliigilise objekti kujuga põhisüsteemis. Ülekate tohib olla vaid topoloogilises ulatuses, mis on kuni 1% väiksema objekti pindalast Joonobjekti korral ei tohi joon ühtida teise joonega enam kui 1% lühema joone pikkusest 137 Aadressipunkt ei ühti objekti kujuga AS Datel /226

61 Pindobjekti puhul peab aadressipunkt asuma objekti kuju sees. Joonobjekti puhul arvestatakse ühtivuse kontrollimisel parameetritest häälestatava puhvriga 81 Aadress on vananenud See viga tekib, kui objektile on seos vananenud aadressiga 82 Aadress on tühistatud See viga tekib, kui objektil on seos tühistatud aadressiga 80 Aadress ei sobi ruumiliselt objekti juurde See viga tekib, kui objekti aadressi EHAK osa ei ühti objekti ruumiaadressiga 85 Aadress ei ole unikaalne, vaid esineb teistel samaliigilistel objektidel [ads_oid loetelu] 101 Komponendi nimi ei tohi sisaldada numbreid 102 Komponendil on vähem kui 3 alamat 103 Komponendi alluvaks on nimetuse komponent 104 Komponendi nimes on liigsed tühikud 105 Nimetuses suurtäht vales kohas 106 Nimetus ei alga suurtähega 107 Nimetuses esineb üksik täht 108 Komponendis sisaldub ebakorrektseid sümboleid 109 Nimetuses sidekriipsu vale kasutamine 110 Komponendis sisaldub ebasobivaid tähti 111 Nimetusel on ebasobiv algustäht 112 Nimetuses ebakorrektne sõna 113 Komponendis sisaldub ebakorrektne number 114 Komponent ei tohi sisaldada suurtähti 115 Komponendi nimes on mitu tähte järjest 116 Komponendi nimes on tähed ebasoovitavad 117 Komponendi nimetuse osa peab algama numbriga 118 Alamkomponentide numbrivahemikud on liiga suured 119 Komponendi pikk ja lühike nimekuju pole võrdsed Märkus. Probleemid nr on komponendi probleemid. Väikekohale lisanduvad 4. taseme komponendiga seotud probleemid. Liikluspinnale lisanduvad 5. taseme komponendiga seotud probleemid. 3.7 ETAK muudatuste käsitlemine ADS-s ETAK hooned ja maa-alused hooned ADS süsteemis on kasutusel ETAK hoonete kiht. See kiht sisaldab nii maapealseid kui ka maa-aluseid hooneid. ETAK süsteemis on kasutusel järgmine klassifikatsioon: o kood 401 Hoone, sh tüüp 10 - Elu- või ühiskondlik hoone tüüp 20 - Kõrval- või tootmishoone tüüp 30 - Vundament tüüp 40 Vare tüüp 50 Ehitatav hoone o kood 404 Maa-alune hoone, sh tüüp 10 - Kelder tüüp 20 - Garaaž tüüp 999 Muu ADS süsteem käsitleb ETAK hooneid järgmises klassifikatsioonis: tüüp 10 - Elu- või ühiskondlik hoone tüüp 20 - Kõrval- või tootmishoone AS Datel /226

62 tüüp Maa-alune hoone Maa-aluseid hooneid käsitletakse ADSi poolel loogiliselt samaväärsetena nagu kõrvalhooneid. Kasutajale on hoone detailandmete hulgas nähtav ka ETAK hoone tüüp ETAK ja ADS kujude võrdlus ETAK hooned kaardistatakse aerofotodelt katuseräästa ulatuse alusel. Projektidel ja teostusmõõdistusel väljendatakse aga vundamendi või seina nurkade järgi mõõdistatud kuju. Need 2 kuju enamasti ei ühti (erandiks on ilma räästata katusega hooned), kuid vahe ei tohi olla eriti suur. ETAK ja ADS kujude samasus tuvastatakse järgmiste reeglite alusel. Kujud loetakse võrdseteks, kui on täidetud mõlemad järgmised reeglid. 1. ETAK kuju peab asuma üleni ADS kujule ehitatud välispuhvri sees Puhvri ulatus on häälestatav süsteemi parameetrites juuni seisuga on selleks 1 m Olemasolevale ADS kujule lisatakse parameetrites oleva ulatusega välispuhver ETAK hoone kuju peab asuma üleni mainitud ulatusega puhvri sees, tema piir ei tohi lõikuda puhvri piiriga mitte üheski punktis, kuid võib ühtida puhvri piiriga. ETAK ja ADS kujud ühtivad ETAK ja ADS kujud erinevad ETAK hoone kuju ADS hoone kuju ADS hoone puhver 2. Sisepuhvri võrra vähendatud ADS kuju peab asuma üleni ETAK kuju sees Puhvri ulatus on häälestatav süsteemi parameetrites juuni seisuga on selleks 1 m, kuid see võib olla erinev välispuhvri ulatusest Olemasolevast ADS kujust lahutatakse mainitud ulatusega puhver Tulem peab asuma üleni ETAK kuju sees. Piirid ei tohi lõikuda mitte üheski punktis, kuid võivad ühtida. AS Datel /226

63 ETAK ja ADS kujud ühtivad ETAK ja ADS kujud erinevad ETAK hoone kuju ADS hoone kuju ADS hoone puhver ETAK muudatuste töötlemine Perioodiliselt käivituv automaatne protsess kontrollib ETAK andmete logidest sinna lisatud, muudetud ja kustutatud hoonete kujusid. Muudatuste töötlemisel lähtutakse peamiselt ETAK-ID väärtusest. ADS süsteemis eeldatakse, et jõusolevate aadressiobjektide hulgas on ETAK-ID unikaalne. Unikaalsus tagatakse loogiliste kontrollidega. 1. Kui hoone on ETAK süsteemi lisandunud (logis sisaldub lisamise sündmus) ja etak-hoone tüüp on 10 või 20 (elukondlik või mitteelukondlik hoone), siis uuritakse, kas vastav ETAK-ID esineb ADS süsteemis. (Märkus: uus ETAK-ID ei tohiks küll veel esineda, kuid see on siiski võimalik sel juhul, kui ETAK-IDga objekt on ETAK süsteemis kunagi olnud hoone, siis tõstetud üle teise tabelisse näiteks rajatised ja seejärel tõstetud tagasi hoonete juurde. Logis sisaldub kirja lisandumise sündmus hoonete tabelisse.). Muude tüüpidega objekti lisandumise sündmust ADS ignoreerib Kui ETAK-ID ei esine ADS süsteemis, siis vaatab süsteem, kas etak-hoonel on omistatud ka ADS-OID. Kui on, siis otsitakse selle alusel aadressiobjekti Kui leiti aadressiobjekt ADS-OID alusel ja sellel on teistsugune ETAK-ID, siis logib süsteem vea ETAK süsteemi jaoks: etak-objektil on vale ADS- OID. Edasi toimib süsteem nagu uue objekti lisandumise puhul (edasi punkt 2) Kui leiti aadressiobjekt ADS-OID alusel ja sellel puudub ETAK-ID, siis see omistatakse objektile. Edasi toimib süsteem nagu objekti muutumise puhul. (edasi punkt 4) Kui ADS-OID ei olnud määratud etak-objektil, siis toimub uue objekti lisamine. (edasi punkt 2) 1.2. Kui ETAK-ID esineb ADS süsteemis, siis leitakse selle alusel objekt ja võrreldakse ADS-OID väärtusi. Kui need on erinevad, siis logib süsteem vea ETAK süsteemi jaoks: etak-objektil on vale ADS-OID. Edasi toimib süsteem nagu objekti muutumise puhul. (edasi punkt 4) AS Datel /226

64 2. Objekti lisandumine. Eeldus: etak-süsteemis on hoone tüübiga 10 või 20 ja ADS põhisüsteemis sellise ETAK-ID-ga jõusolevat objekti pole Menetlussüsteemi luuakse uus ETAK muutmise menetlus, millesse lisatakse uus objekt koos ETAK kujuga ja hoone tüübist tuletatud liigiga. Tunnus päritoluregistris jääb tühjaks, sest EHR kood ei ole teada. ADS_OID genereeritakse uus. Objektile leitakse aadressid kuju alusel (reeglid on kirjeldatud peatükis ) ja salvestatakse need menetlusse hoone aadressideks. Menetlus suunatakse ruumiaadressiga määratud KOV-le menetlemiseks Kui juba leidus selline pooleliolev ETAK muutmise menetlus, kus sees sama ETAK-ID-ga objekt, siis ei tehta uut menetlust, vaid võetakse kasutusele olemasolev. ETAK-ID-ga objekti andmed muudetakse vajadusel vastavaks etak-süsteeemis olevate andmetega. 3. Kui hoone on ETAK süsteemis muutunud (logis sisaldub muutmise sündmus), siis uuritakse muutunud etak-hoone tüüpi Kui etak-hoone tüüp on 10 või 20, siis uuritakse, kas vastav ETAK-ID esineb ADS süsteemis. (edasi punktid ) 3.2. Kui etak-hoone tüüp ei ole 10 ega 20, siis käsitleb ADS muudatuse logiteadet nagu kustutamise logiteadet. (edasi punkt 5). 4. Objekti muutumine. Eeldus: etak-süsteemis on hoone tüübiga 10 või 20 ja ADS põhisüsteemis leidub ka sellise ETAK-ID-ga jõusolev objekt. ADS süsteemis võrreldakse etak-objekti ja ETAK-ID alusel leitud aadressiobjekti. Võrreldakse kujusid ja objekti tüüpi Kui etak- ja ads-objekti kujud on täpselt identsed ning kui etak-hoone tüüp vastab ads-objekti liigile, siis on objektid täpselt sünkros ja logikirjet ignoreeritakse Tuvastatakse kujude erinevus Kui etak- ja ads-objekti kujud erinevad lubatud puhvri ulatuses (kirjeldatud pt 3.9.2), siis loeb ADS selle topoloogiliseks muudatuseks. Ads-objekti kuju asendatakse etak-objekti kujuga otse põhisüsteemis ilma menetluseta. Ads-objekti kuju moodustusviis märgitakse kaardistatuks, juhul kui ta seda veel ei ole. Ads-objekti muudatuste logisse tekib muudatussündmus, milles vana ja uue versiooni viit on sama. Sellisel moel on tarbijatel siiski võimalik näha, et mingi muudatus selle objektiga on toimunud. Objekti versiooniga seotud muudatusvektoris see topoloogiline muudatus ei kajastu. Järeltegevusena arvutatakse uuesti objekti probleemid Kui etak- ja ads-objekti kujud erinevad enam kui lubatud puhver ja adsobjektil esineb ka EHR-kood, siis peab etak- ja ads-objekti kujude ühisosa pindala suhe ads-kuju pindalasse olema vähemalt 70% või enam. Sellisel juhul on kuju asendus õigustatud Kui etak- ja ads-objekti kujud erinevad enam kui lubatud puhver ja adsobjektil puudub EHR-kood, siis peavad etak- ja ads-objekti kujud olema lihtsalt ruumiliselt seotud ükskõik millisel moel. Sellisel juhul on kuju asendus õigustatud. Muidu tuleb hakata kahtlustama, et ETAK-ID peaks esinema hoopis teisel hoonel Juhul, kui asendus on õigustatud, siis loob süsteem automaatse muutmise menetluse (A-liiki menetlus). Menetlejaks on Maa-amet. Menetluses vahetab ads-objekti kuju etak-objekti kujuga, samuti muudab vajadusel kuju moodustusviisi. Menetluses muudetakse ka objekti aadressipunktid ja AS Datel /226

65 hoone osade punktid vastavaks uue kujuga. Süsteem jõustab menetluse automaatselt, juhul kui ei esine jõustamist takistavaid probleeme. Kui esineb, siis jääb menetlus jõustamata Juhul, kui asendus ei ole õigustatud, siis lisandub ads-objektile põhisüsteemis probleem 133 Objekti kuju ETAK süsteemis erineb ADS kujust lubatust suuremal määral 4.3. Tuvastatakse tüübi erinevus. Kui etak-hoone tüüp on 10 ja ads-objekti liik on EE või kui etak-hoone tüüp on 20 ja ads-objekti liik on ME, siis tüübid vastavuses. Kui see nii ei ole, siis on erinevus Kui on tüübi erinevus ja ads-objektil esineb ka EHR-kood, siis lisandub ads-objektile põhisüsteemis probleem 132 ETAK objektitüüp ei ole vastavuses ADS objektiliigiga Kui on tüübi erinevus ja ads-objektil puudub EHR-kood, siis peavad etakja ads-objekti kujud olema ruumiliselt seotud ükskõik millisel moel. Siis loob süsteem automaatse muutmise menetluse (A-liiki menetlus). Menetlejaks on Maa-amet. Võimaluse korral kasutab sama menetlust, milles tehakse kuju muudatused. Menetluses tühistab olemasoleva objekti ja loob uue ads-objekti õige liigiga ning uue ADS-OID väärtusega. Uue objekti olekuks saab kehtiv, sest tegu on looduses esineva objektiga. Uue objekti kuju loetakse ETAK-süsteemist, aadressid kopeeritakse vana objekti küljest. Süsteem jõustab menetluse automaatselt, juhul kui ei esine jõustamist takistavaid probleeme. Kui esineb, siis jääb menetlus jõustamata Kui on tüübi erinevus ja ads-objektil puudub EHR-kood ja etak- ja adsobjekti kujud ei lange kokku mitte üheski punktis, siis tuleb hakata kahtlustama, et ETAK-ID peaks esinema hoopis teisel hoonel. Sellisel juhul lisandub ads-objektile põhisüsteemis probleem 132 ETAK objektitüüp ei ole vastavuses ADS objektiliigiga. 5. Kui hoone on ETAK süsteemis kustunud (logis sisaldub kustutamise sündmus), siis uuritakse, kas vastava ETAK-ID-ga objekt esineb ADS süsteemis Kui leidub ETAK-ID-ga aadressiobjekt ja sellel objektil puudub orig_tunnus (hoone puhul on selleks EHR-kood), siis lisatakse sellele probleem 130 ETAK-ID väärtusega objekt puudub ETAK süsteemist Süsteem teeb uue A-liiki automaatse muutmise menetluse, mille menetlejaks on Maa-amet, ja võtab hoone sellesse muutmiseks Selles menetluses märgib süsteem objekti automaatselt tühistatuks Süsteem jõustab automaatselt menetluse, jõustamisel tühistuvad kõik objekti probleemid Kui leidub ETAK-ID-ga aadressiobjekt ja sellel objektil esineb ka orig_tunnus (hoone puhul on selleks EHR-kood), siis teeb süsteem järgmist Süsteem teeb uue A-liiki automaatse muutmise menetluse, mille menetlejaks on Maa-amet, ja võtab hoone sellesse muutmiseks Selles menetluses eemaldab süsteem hoonelt ETAK-ID ja lisab uue veateate: 178 ETAK andmetel hoonet looduses ei eksisteeri Süsteem jõustab automaatselt menetluse, jõustamisel kirjutatakse viga objekti juurde põhisüsteemi Kui ei leidu sellist aadressiobjekti, siis ignoreerib ADS logiteadet Need automaatsed menetlused, mis loodi protsessi käigus ja mille jõustamine ebaõnnestus, ühendab süsteem KOVide kaupa. AS Datel /226

66 3.7.4 Muudatuste logi ETAK süsteemi jaoks ETAK süsteem vajab mugavat tagasisidet, et arvesse võtta ADS süsteemis toimunud muudatusi. ADS logi ETAK süsteemi jaoks tekib objekti andmete registreerimisel ADS põhiregistrisse. Logitakse ainult hoonete andmete muudatusi. Muudatused saavad tekkida kas X-tee teenuse kaudu esitamisel või menetluste jõustamisel. Logitakse järgmisi sündmusi: lisandus uus aadressiobjekt koos ETAK-ID-ga (syndmus=i; muudatusvektor=null; etak_id lisatud kirjest, ADS-OID jt andmed lisatud kirjest). lisandus uus aadressiobjekt ilma ETAK-ID-ta aga koos kujuga (syndmus=i; muudatusvektor=null; etak_id=null, ADS-OID jt andmed lisatud kirjest). Ilma kujuta ja ilma ETAK-ID-ta objektide lisandumist ei logita. aadressiobjekt muutus, lisandus etak_id (syndmus=u; muudatusvektor= O ; etak_id uuest versioonist, vana_etak_id=null, ADS-OID jt andmed uuest versioonist). Ülejäänud muudatused A (aadress) S (seisund) K(kasutusotstarbed) G(geomeetria) tuvastatakse vana ja uue versiooni võrdlemisel. aadressiobjekt muutus, etak_id muutus võrreldes eelmise versiooniga (syndmus=u; muudatusvektor= O ; etak_id uuest versioonist, vana_etak_id=eelmisest versioonist, ADS-OID jt andmed uuest versioonist). Ülejäänud muudatused A (aadress) S (seisund) K(kasutusotstarbed) G(geomeetria) tuvastatakse vana ja uue versiooni võrdlemisel. aadressiobjekt muutus, etak_id eemaldati objektilt (syndmus=u; muudatusvektor= O ; etak_id=null, vana_etak_id=eelmisest versioonist, ADS-OID jt andmed uuest versioonist). Ülejäänud muudatused A (aadress) S (seisund) K(kasutusotstarbed) G(geomeetria) tuvastatakse vana ja uue versiooni võrdlemisel. aadressiobjekt muutus, ETAK-ID puudub jätkuvalt, kuid kuju on objektil olemas (syndmus=u; muudatusvektor= ; etak_id=null, vana_etak_id=null, ADS-OID jt andmed uuest versioonist). Ülejäänud muudatused A (aadress) S (seisund) K(kasutusotstarbed) G(geomeetria) tuvastatakse vana ja uue versiooni võrdlemisel. aadressiobjekt tühistati, etak_id oli olemas (syndmus=d; muudatusvektor=null; etak_id=tühistatud versioonist, vana_etak_id=null, ADS-OID=tühistatud versioonist). Tühistamise korral muutub ainult seisund, muud andmed põhiregistris ei muutu. aadressiobjekt tühistati, etak_id puudus, kuid kuju oli olemas (syndmus=d; muudatusvektor=null; etak_id=null, vana_etak_id=null, ADS-OID=tühistatud versioonist). Tühistamise korral muutub ainult seisund, muud andmed põhiregistris ei muutu. ETAK logitabeli struktuur on järgmine: log_id logikirje identifikaator log_stamp logikirje lisamise aeg AS Datel /226

67 syndmus I objekt lisandus ametlikule kihile, U objekt muutus, sh ka oleku muudatus O->K; D objekt tühistati, tema oleks muutus T, muud andmed ei muutu tühistamise ajal ja muudatusvektorit ei logita. muudatusvektor eraldi tähistega kajastatakse, mis tegelikult muutus: O (ADS-OID) A (aadress) S (seisund) K(kasutusotstarbed) G(geomeetria) etak_id alati olemas, puudub vaid kujuga ehitise lisandumisel ametlikule kihile ads_oid olemas, kui esineb ametlikul kihil ehr_kood ametlik_aadress - optimeeritud lähiaadress tekstina olek objekti olek vahetult peale muudatust (O, K, X või T) kasutusotstarbed tekstilisel kujul. Kasutusotstarvete muutusi hakatakse logima siis, kui realiseeritakse automaatne sünkro EHR-ga. geometry ametlik kuju, võib puududa ka tühistamise korral tyhist_pohjus ainult ETAK seosega hoonete tühistamise korral veateate nr 161 mitteaktuaalseks märkimisel menetleja poolt lisatud kommentaar Nimetatud logist ADS süsteem kirjeid ei kustuta. ETAK saab logi kontrollida ajatempli alusel ning vajadusel kustutada töödeldud kirjed. ETAK süsteemi kasutaja saab teha päringuid ADS menetlussüsteemis probleemi liikide kaupa ning töödelda saadud tulemit. Mingit täiendavat teavitamist (näiteks e- kirjaga) ADS süsteem ei tee. Probleemide lisamist ja mitteaktualiseerimist ei logita. 3.8 Logide järeltöötlemine Mõned muudatused ADS süsteemis võivad ahelreaktsioonina kaasa tuua täiendavate muudatuste laine. Näiteks toob EHAK objekti tühistamine kaasa temaga seotud komponendi tühistumise ja kõigi seda komponenti sisaldavate aadresside tühistumise. Edasi juba tühistatud aadresside asendamise objektidel. Vahetult koos lähtemuudatusega ei ole võimalik kõiki järelmuudatusi teostada. Seepärast teostatakse järeltöötlus perioodilise automaatse protsessina. Protsess loeb kõiki salvestatud ja töötlemata muudatused logidest ning teostab vajalikud järeltöötlused. Need järeltöötlused võivad võtta sõltuvalt muudatuste arvust ning iseloomust väga palju aega. EHAK muudatuste aktiivsel perioodil on oluline keskenduda teatud tüüpi järeltegevuste kiirele läbimisele. Täies mahus järeltöötlused võivad oodata rahulikumat aega, kuid kokkuvõttes ei saa nad jääda tegemata. Seepärast on loodud järeltöötlusteks 2 eraldi haru: täielik ja kiire Täielik järeltöötlus Täielik järeltöötluse automaatne protsess käivitub automaatselt igal õhtul kell Kui kiire järeltöötlus parajasti käib, siis täieliku järeltöötluse käivitamine ei õnnestu. Süsteem proovib käivitamist uuesti kuni kl 22:50-ni iga 10 min tagant. Kui selleks ajaks ei ole kiire järeltöötlus lõptanud, siis jääb täielik järeltöötlus sel päeval vahele. Protsess töötab sammhaaval ja teostab järgmised sammud. Samm 1. UN-tunnuse omistamine AS Datel /226

68 Samm 2. Aadressiobjekti muudatuste logi töötlemine Samm 3. Komponentide muudatuste logi töötlemine Samm 4. Aadresside muudatuste logi töötlemine Samm 5. Aadresside muutmisvajaduste leidmine ja töötlemine Samm 6. Eelmises sammus tehtud objektide muudatuste logi töötlemine Samm 7. Ruumiaadresside logi töötlemine Samm 8. Aadresside muudatuste logi töötlemine vahepeal lisandunud logide osas Samm 9. Seotud objektide logi töötlemine Samm 10. Aadressi esinduspunkti logi töötlemine Samm 11. Sihtnumbri muudatuste töötlemine Samm 12. Mitteametlike piirkondade muudatuste töötlemine Samm 13. POI muudatuste töötlemine Samm 14. Uue KÜ tekkimise logi töötlemine Samm 15. Aadresside muutmisvajaduste leidmine Samm 16. Tühjade menetluste kustutamine Samm 17. Sünonüümide logi töötlemine Samm 18. Kohanime tunnuse omistamine katastriüksustele Kiire järeltöötlus Kiire järeltöötlus toimib samuti asünkroonse protsessina, kuid see ei käivitu iseseivalt. Protsessi on võimalik käivitada ADS kasutajaliidese kaudu. Kui täielik järeltöötlus parajasti käib, siis kiire järeltöötluse käivitamine ei õnnestu. Protsess töötab sammhaaval ja teostab järgmised sammud. Samm 1. Komponentide logi töötlemine Protsess loeb taseme komponentide muutumise töötlemata logikirjed nende tekkimise järjekorras. Ülejäänud tasemete logikirjed jäävad vahele. Töötlemise lõpetamisel märgib protsess komponendi logikirje töödelduks kiirkorras. See tähendab, et kiire protsess seda logi uuesti ei töötle, aga tavaprotsess töötleb. Samm 1a. Järgnevused EHAK komponentide lisamise sündmuse korral järeltöötlust ei tehta ja järglasi ei otsita. Põhjus selles, et kui lisamise sündmus tekib enne eellase tühistamise sündmust, siis võib järglaste analüüs anda vale tulemuse. Järglasi otsitakse EHAK komponentide puhul ainult tühistamise sündmuse peale. Lähtuda võib eeldusest, et tühistamise sündmuse töötluse hetkeks on ka kõik vajalikud lisamised juba toimunud. AS Datel /226

69 Maakonna puhul loetakse tühistatud komponendi järglaseks samanimeline kehtiv komponent. Sobiva puudumisel järglust ei tuvastata. Leidumisel registreeritakse järglus nii komponendile, initsialiseerivale aadressiobjektile kui ka aadressile. Omavalitsuste ja asutusüksuste (2. ja 3. tasandi komponendid) tühistamise korral tuvastatakse objektide järglus samal moel nagu täna ruumianalüüsiga. Analüüsis osalevad komponente initsialiseerivad aadressiobjektid. Komponendi järglaseks saab objekti järglase poolt initsialiseeritud komponent. Aadressi järglaseks objekti järglase kehtiv aadress või ruumiaadressi puhul asendav ruumiaadress.. Veel tuleb järgluse puhul vaadelda ka EHAK komponentide muutmise logisid. Asustusüksused ei saa haldusreformi käigus uusi koode. Nad muutuvad, sest saavad uue ülemkoodi. Tavalise järeltöötluse korral tuvastatakse aadresside järglus tühistatud aadressi logi töötlemisel, aga kiire järeltöötluse puhul ei hakka aadresside logi üldse analüüsima. Aadresside järglus tuvastub muutuvat komponenti initsialiseeriva objekti vana ja uue versiooni alusel. Komponentide ega objektide järglust ei teki. Väikekohtade ja liikluspindade järglust komponentide logi põhjal ei tuvastata. Samm 1b. Aadresside versioneerimine Komponendi muutumise sündmuse peale toimub seotud aadresside versioneerimine. Muutuda saavadki ainult taseme komponendid. Samm 1c. Aadresside tühistamine Komponendi tühistamise sündmuse peale toimub seotud aadresside tühistamine. Sama tegevuse käigus lisandub tühistatud aadressi kirjesse kohe ka tühistamise põhjus ning tühistava taseme number. Samm 1d. Alamkomponentide tühistamine Komponendi tühistamise sündmuse peale toimub tühistatud komponendi otseste alamate tühistamine. Samm 2. Objektimuudatuste logi töötlemine Protsess loeb VK ja LP liiki aadressiobjektide muutumise (U sündmuse) logikirjeid nende tekkimise järjekorras. Sündmuse alusel tuvastatakse objekti poolt initsialiseeritud tühistatud komponentide ning aadresside järgnevus. Töötlemise lõpetamisel märgib protsess objekti logikirje töödelduks kiirkorras. See tähendab, et kiire protsess seda logi uuesti ei töötle, aga tavaprotsess töötleb. Samm 3. Muutmisvajadusega objektide leidmine Sammu käigus leiab protsess kõik tühistatud aadressiga objektid, mis pole veel muudatusvajadusena registreeritud, ning registreerib need vajadused ära. Teisi vajadusi ei analüüsi. Samm 4. Tühistatud aadresside asendamine AS Datel /226

70 Selle sammu käigus töötleb protsess tühistatud aadressiga objektide muudatusvajadusi, mis pole veel ühtegi asendust leidnud. Protsess uurib, kas aadress on tühistunud EHAK muudatuse tõttu, kas aadressi tühistava komponendi tase on 1-3. Kui on, siis töötleb seda, kui ei ole siis ignoreerib muudatusvajadust. Protsess uurib, kas kehtetule EHAK aadressile on lisatud täpselt 1 järglane. Kui EHAK aadressil ei ole ühtegi järglast, siis protsess tühistatud aadressile asendust ei paku. Kui EHAK aadressil leidus täpselt 1 järglane, siis kasutab protsess seda asendava aadressi pakkumisel. Kui EHAK aadressil on mitu järglast, siis otsitakse objekti ruumikuju alusel ruumiaadressi. Kui leidus ruumiaadress, mis katab objekti vähemalt 99%, siis kasutab protsess seda asendava aadressi pakkumisel. Muul juhul protsess tühistatud aadressile asendust ei paku. Edasi analüüsib protsess, kas tühistatud aadressis sisalduvad ka 4. ja 5. tase ja püüab leida neile järglased. Kui see ei õnnestu, siis protsess tühistatud aadressile asendust ei paku. 6., 7. ja 8 taseme komponentide nimed kirjutab protsess lihtsalt uude aadressi ümber samal kujul. Selliselt formeeritud aadress salvestub muudatusvajadustesse asendavaks aadressiks koos tunnusega 4 automaatseks muutmiseks valmis. Muudatusvajaduste tabelis on aadresside muudatuste seisu indikeerimiseks järgmised väärtused: 1-asendus leitud, 2-asendus ei sobi, 3-muutmiseks valmis, 4-automaatseks muutmiseks valmis. Samm 5. Vananenud ja tühistatud aadressiga objektide muutmine ilma menetluseta Tühistatud aadresside asendamiseks kasutab kiire protsess sedasama meetodit, mida kasutab tavaprotsess vananenud aadresside vahetamiseks. Protsessi tehakse täiendus, et kui muudetaval on objektil on tühistatud aadress ja sel aadressil on muudatusvajaduste tabelis asendus koos tunnusega 4, siis tehakse muudatus kohe ära. Täna jääb tühistatud aadressi korral muudatus tegemata, aga edaspidi see tehakse. Sama täiendus lisandub ka tavatöötluse protsessi. Mõlemad täidavad sama funktsionaalsust: vananenud aadresside asendust ja tühistatud aadresside asendust kindla asenduse olemasolul. Teiseks registreeritakse sama protsessi käigus kohe ka tühistatud aadressi järglus. Kiire protsessi eduka lõppemise kohta läheb e-kiri kokkulepitud meiliaadressidele. AS Datel /226

71 3.9 Andmete avalikustamine ADS süsteemis muutunud andmed kantakse kord ööpäevas üle tootmissüsteemi andmebaasist esitlussüsteemi andmebaasi. Esitlussüsteemi andmebaasile toetuvad kõik avalikud rakendused ja X-Tee teenused. Logide järeltöötlemise ja andmete avalikustamise protsessid on üksteist välistavad. Kui ükskõik kumb logide töötlemise protsess parajasti käib, siis andmete avalikustamine automaatselt ei käivitu. Süsteem püüab andmeid avalikustada igal õhtul alates kl 23:10-st kuni 4:50-ni iga 10 minuti tagant. Kui selles ajavahemikus ei õnnestu avalikustamist käivitada, siis jääb protsess sel ööl vahele. Tavaolukorras kestab avalikustamine umbes 15 minutit. Andmete konsistentsuse ehk kokkusobivuse tagamiseks avalikes teenustes kasutatakse järgmisi meetmeid. Meede 1. Teenused ei väljasta avalikustamise protsessi käigus lisandunud logikirjeid enne, kui avalikustamise protsess on lõppenud. Selleks logitakse iga teenuse viimane lubatud log_id väärtus ning see väärtus uueneb, kui andmete avalikustamine on edukalt lõppenud. Meede 2. Avalikustamine töötab ajavahemikus, mil inimeste tehtavate muudatuste võimalus on minimaalne ja andmeid muutvad paralleelprotsessid ei tööta. Meede 3. Avalikustamise ajal ei tohiks tootmissüsteemis toimuda andmeid muutvaid tegevusi. Avalikustamise protsess heiskab muudatuste blokeerimiseks lipu käivitumise hetkel. Seejärel ootab enne tegevuse alustamist 60 sekundit, et kõik avalikustamise hetkeks juba käivitunud protsessid jõuaksid oma tegevuse lõpetada. Seejärel alustab protsess andmete ülekannet avalikku serverisse. Töö lõpetamisel, sh ka katkemise korral eemaldatakse muudatusi blokeeriv lipp. Avalikustamise protsessi muudatusi blokeeriva lipu kontroll ja veateade on lisatud järgmistesse ADS süsteemi meetoditesse ja teenustesse: menetluse jõustamisele (menetlusrakendus). Veateade: Jõustamine ei õnnestu, sest toimub andmete ülekanne avalikesse teenustesse. Palun proovige umbes 10 minuti pärast uuesti. andmete põhisüsteemi esitamise teenusele (KNR, EHAK). Veateade: Esitamine ei õnnestu, sest toimub andmete ülekanne avalikesse teenustesse. Palun proovige umbes 10 minuti pärast uuesti.. andmete muutmise menetlusse esitamise teenusele (EHR) Veateade: Esitamine ei õnnestu, sest toimub andmete ülekanne avalikesse teenustesse. Palun proovige umbes 10 minuti pärast uuesti.. andmete täpsustamise menetlusse esitamise teenusele (KATASTER) Veateade: Esitamine ei õnnestu, sest toimub andmete ülekanne avalikesse teenustesse. Palun proovige umbes 10 minuti pärast uuesti.. AS Datel /226

72 4. Menetlussüsteemi kasutuslood 4.1 Menetluse loomine Menetlust saab luua 3 põhimõttelisel viisil: kasutajaliidese kaudu märkides kaardil või otsingutulemuses ära menetlusse võetavad objektid X-tee teenuse kaudu automaatselt ADS süsteemi poolt Süsteem salvestab menetluse looja ja loomise viisi ning sellest sõltuvad objektide lisamise ja jõustamise ärireeglid. Kasutajaliidese kaudu loodud menetlust saab jõustada ainult kasutajaliidese kaudu. X-tee kaudu loodud menetlust saab jõustada nii X-tee kui ka kasutajaliidese kaudu. Automaatselt saab luua ainult automaatse muudatuse tüüpi menetlust. Kui vigu ei esine, siis see ka jõustatakse automaatselt. Kui leidub probleeme, siis tuleb jõustamine teha läbi kasutajaliidese Menetluse loomine kasutajaliidese kaudu Kasutajaliideses saab uue menetluse luua vähemalt tavamenetlusõigustega kasutaja kas tühjalt (st ilma objektideta) või koos eelnevalt valitud objektidega. 1. Kasutaja teeb otsingu põhisüsteemis olevate objektide hulgast. Otsingut saab teha vähemalt järgmiste tingimuste mistahes kombinatsioonide alusel: objekti tunnused (ads_oid, versioonitunnus, originaaltunnus, etak_id), aadressid (ka osalisel kujul), seotud aktuaalsed või mitteaktuaalsed probleemid, märkused jne vastavalt otsinguvormis realiseeritud võimalustele. Kasutaja märgistab otsingutulemuste hulgas 1 või mitu soovitud objekti. Saab märgistada kõik leitud objektid Alternatiiv. Kasutaja on avanud registri kaardiliidese ja märgistab 1 või mitu põhisüsteemis olevat objekti. 2. Kasutaja vajutab rakenduse tärk- või kaardipoolel nuppu Alusta uut menetlust 2.1. Alternatiiv. Ilma objektideta menetluse alustamiseks on sama valik rakenduse menüüs 3. Süsteem toodab uue menetluse ja avab menetluse vormi, milles on juba sees valitud objektid, kui kasutaja alustas menetlust koos objektidega. Menetlus on andmebaasi salvestunud. Objektid on menetluses samade andmetega nagu nad olid põhisüsteemis. Menetlusele on süsteemi poolt automaatselt omistatud number ja menetleja organisatsioon, milleks saab see organisatsioon, mida sisseloginud kasutaja esindab Kui mõni märgitud objekt ei kuulu kasutaja tööpiirkonda, siis seda menetlusse ei võeta ja kasutaja näeb avanenud vormis vastavat veateadet. Menetlus siiski luuakse süsteemi poolt Kui kasutaja mõtleb ümber ja ei soovigi tegelikult menetlust alustada, siis on võimalik tal menetlus kustutada. Kustutamisel eemaldatakse menetlus koos objektidega menetlussüsteemi andmebaasist. Põhisüsteemis objekti andmed sellest ei muutu. Kustutamist saab teha mistahes hetkel enne menetluse jõustamist. AS Datel /226

73 3.3. Objektide menetlusse võtmisel kehtib piirang, et ühes menetluses ei või olla enam kui lubatud arv objekti. Lubatud arv on häälestatav süsteemi parameetrites ja see võiks olla umbes 100, kui arvestada hoonete ja katastriüksustega. Kui lisanduvad ka hooneosad, siis kokku kuni 300 objekti (soovituslik arv, ei ole seadistatav). Need piirangud seatakse registri jõudluse tagamiseks. Liiga paljude objektide korral võib menetluse kuvamine muutuda liiga aeglaseks ja objektid kasutajale haldamatuks. Kui kasutaja soovis menetlust alustada enamate objektidega (hoonete ja katastriüksustega) kui piirang ette näeb, siis teeb süsteem vastavalt mitu menetlust ja avab neist esimese. Kasutaja saab teate, et loodi mitu menetlust. Hooneosade arvuga tuleb esialgu kasutajal endal arvestada. 4. Vaikimisi on uuel menetlusel liik määramata. Kasutaja valib menetluse liigi. Selle salvestamise hetkel kontrollib süsteem menetluse objekte, et sama objekt ei oleks juba muutmisel mõnes teises sama liiki menetluses. Kui on, siis liigi määramine ebaõnnestub, kasutaja saab veateate ja peab need objektid ühest või teisest menetlusest eemaldama või sulgema teise menetluse. Siis saab uuesti liigi määrata. Menetluse liik on kohustuslik nii menetluse üldandmete salvestamise kui ka jõustamise hetkel Menetluse loomine X-tee teenuse kaudu X-tee teenuse kaudu menetluste loomine on vajalik andmeid haldavate väliste registrite jaoks (eelkõige Ehitisregister ja Maaregister). Kasutajal peab olema võimalus muuta andmed originaalregistris ja esitada need siis ADS süsteemi ilma ADS kasutajaliidese vahenduseta. Juriidiliselt peavad objekti muudatused nii kuju kui ka aadressi osas olema registreeritud enne ADS-s kui neid saab registreerida originaalregistris (EHR või Maaregister). Andmete esitamiseks menetlusse luuakse spetsiaalne X-tee teenus loe pt 6.1. X-tee teenuse kaudu esitatakse menetluse objektid muudetud kujul kõik korraga. Ükshaaval menetlusse objektide lisamise või eemaldamise jaoks teenust ei ole. Samuti ei saa teenuse kaudu ükshaaval muuta menetluse objekte. X-tee teenuse kaudu loodud menetluses saab muuta selle loonud registri poolt esitatavaid objekte täies ulatuses: nii kuju, aadressi kui ka olekut. Teise registri objektidel saab muuta aadressi. Näiteks. Ehitisregister saab X-tee kaudu muuta katastriüksuse aadressi, kuid mitte selle kuju ega olekut. Samas hoonete andmeid saab muuta igal viisil. Selline käsitlus on vajalik selleks, et ületada probleem, kus hoone aadress ei sobi katastriüksusega ning mõlemat on vaja korrigeerida. EHR saab katastriüksusele omistada hoone aadressi. Muul viisil EHRs katastriüksusi muuta ei saa. Siiski on võimalus andmeid esitada korduvalt. Kui X-tee kaudu menetluse loomine õnnestub, aga jõustamine ebaõnnestub, siis jääb see menetlus registrisse alles. Kasutaja saab kas ADS kasutajaliidese kaudu andmed parandada ja menetluse jõustada või teha seda X-tee kaudu. Ei saa eeldada, et andmeid esitav register jätaks ebaõnnestumise korral meelde menetluse numbri ja esitaks parandused alati koos viitega menetlusele. Kindlam on eeldada, et andmeid menetlusse esitav register ei tea AS Datel /226

74 menetluse numbrit, kuid soovib sellegipoolest andmeid uuesti esitades olemasolevat menetlust parandada. Teine eeldus on see, et X-tee kaudu esitamisel on alati määratud objekti tunnus originaalregistris. Ei pruugi olla määratud ADS_OID. Nendele eeldustele tuginevad järgmised tegevused. 1. X-tee teenuse väljakutse õnnestub, kui teenuses on märgitud kõik kohustuslikud andmed. Kindlasti on teada andmeid esitav register ja teenust väljakutsuva kasutaja isikukood. Selle kasutaja õigused ADS menetlust teha peavad olema kontrollitud originaalregistris. Vastavat kasutajat automaatselt MIS süsteemis looma ei hakata. Süsteemi logimine toimub andmeid esitava registrina. Sellegipoolest on teenuse sees kohustuslik esitada ka kasutaja organisatsiooni registrikood. Kui sellise registrikoodiga organisatsioon koos ADS õigustega MIS autentimissüsteemis registreeritud pole, siis esitamine ebaõnnestub Menetluse objektide hulgas peab olema vähemalt 1 objekt, vastasel korral menetluse loomine ebaõnnestub. Samuti ei tohi ühes menetluses olla enam objekte kui süsteemis lubatud Loodava menetluse liik on vaikimisi andmete muutmine, juhul kui teenuse sisendis ei ole märgitud, et tegemist on parandamise menetlusega. Sel juhul on loodava menetluse liik andmete parandamine. ADS süsteem otsib menetlusi, mis oleks loodud X-tee kaudu ja mis oleks sama liiki ja kus esitatud objektid on pooleli menetlemisel Kui ühtegi sellist menetlust ei leitud, siis luuakse uus menetlus Kui leiti täpselt 1 selline menetlus, siis muudetakse olemasolevat. Olemasolevast menetlusest eemaldatakse kõik sinna lisatud objektid, sest X-tee kaudu laekub objektide täielik uus seis. NB! X-tee kaudu andmete esitamisel ei kirjutata mitte kunagi üle kasutajaliidese kaudu loodud menetlust Kui leidub enam kui 1 selline menetlus, siis on tegemist veaga ja menetluse loomine X-tee kaudu ebaõnnestub. (Näiteks kui esitatakse mitu objekti ja 1 neist on muutmisel ühes, teine teises menetluses.) Kasutaja peab ADS kasutajaliidese kaudu olukorra parandama. Seejärel saab andmed esitada X-tee kaudu või siis polegi seda enam vaja teha, sest kasutaja on juba ADS liidese kaudu objektid menetlenud Esitatud objektid lisatakse menetlusse. Objekti menetlusse lisamisel kontrollitakse, et objekt poleks muutmisel teises samaliigilises menetluses, mis pole X-tee kaudu loodud. Kui ikkagi on, siis on viga ja menetluse loomine X-tee kaudu ebaõnnestub Menetluse loomine ADS süsteemi poolt ADS süsteem loob automaatselt menetluse, kui toimub taseme komponentide muutmine või tühistamine. Menetlus luuakse automaatselt käivituva järeltegevusena, mitte vahetult peale komponendi muutmist. Selle järeltegevuste protsessi käivitussagedus on vastavalt vajadustele häälestatav, kuid soovituslikult võiks siiski toimuda tihemini, kui 1 kord ööpäevas. AS Datel /226

75 1. Protsess leiab muudetud komponendid tasemel, mis on veel töötlemata. 2. Protsess leiab objektid, mille aadress sisaldab muudetud komponente. Need objektid grupeeritakse vähemalt omavalitsuste kaupa. Kui ühte menetlusse tekib rohkem kui lubatud arv objekte, siis tükeldatakse menetlus asustusüksuste kaupa. Kui ka sel juhul tekib ikka liiga palju objekte ühte menetlusse, siis tükeldatakse see menetlus nii mitmeks osaks kui vaja, et kõik objektid menetletud saaks. 3. Vaikimisi saab nende menetluste menetlejaks Maa-amet Kui mõni KOV ei ole volitanud Maa-ametit oma objektide aadressi korrastama, siis suunab ADS osakonna töötaja hiljem menetluse vastavale KOVile edasi (vahetab menetleja organisatsiooni). See on alati võimalik, sest 1 menetluses pole kunagi erinevate omavalitsuste objekte. 4. Süsteem korrastab automaatselt nendes menetlustes olevate objektide aadressid. Komponentide muutumise korral vahetab aadressis välja komponendi versiooni. Komponentide tühistumise korral leiab komponendile õigusjärglase ja vahetab aadressis komponendi välja Kui süsteem ei suuda leida komponendile õigusjärglast, näiteks kui liikluspinnal puudub korrektne ruumikuju ja süsteem ei suuda tuvastada, millise asutusüksuse alla ta kuulub, siis jätab süsteem aadressi automaatselt korrigeerimata ja kasutaja peab seda tegema käsitsi. Automaatselt loodud menetlusi süsteem ei kontrolli ega jõusta. Seda peab tegema kasutaja Menetluste kustutamine Kasutajatel on võimalik oma loodud menetlusi ka kustutada. KOV menetlejatel ei ole võimalik kustutada menetlust ega eemaldada menetlusest objekte, kui selle menetluse on loonud ADS haldaja või kui menetlus on loodud süsteemi poolt automaatselt. 4.2 Objektide lisamine menetlusse Juba loodud menetlustesse on hiljem võimalik objekte täiendavalt juurde lisada. Seda muidugi juhul, kui menetlus on jõustamata. Ühte menetlusse saab lisada erinevat liiki menetletavaid objekte. ADS menetluse kasutajaliidese kaudu on võimalik ka X-tee kaudu loodud menetlustesse lisada muid objekte, kuid sellise menetluse jõustamine peab siis ka toimuma kasutajaliidese kaudu. Kui sama menetluse andmed esitatakse uuesti X-tee kaudu, siis kirjutatakse menetluse objektid uue seisuga üle. Elu- ja mitteeluruumide (ehk hoone osade) menetlemisel on tarvis menetlusse võtta ka hoone, milles nad asuvad. Süsteem teeb seda võimaluse korral automaatselt. Kui hoone kuju ega aadress menetlemise käigus ei muutu, siis põhisüsteemi sellest objektist versiooni ei teki menetluse jõustamisel. Samuti hoone menetlemisel võetakse automaatselt menetlusse kaasa kõik tema osad. Iga menetluse puhul on teada menetleja organisatsioon. Menetlusse saab lisada ainult selle organisatsiooni tööpiirkonnas olevaid objekte. AS Datel /226

76 Objekt on menetleja tööpiirkonnas ja teda saab menetlusse võtta, kui on täidetud 1 alljärgnevatest tingimustest: objekti kuju langeb kas osaliselt või täielikult kokku tööpiirkonna kujuga (jääb tööpiirkonna alale). See reegel on vajalik nende objektide puhul, mis asuvad tööpiirkonnas, aga mille aadress ei ole tööpiirkonnaga vastavuses. objekti aadress sisaldab tööpiirkonna EHAK-koodi. See reegel on vajalik nende objektide parandamiseks, mis aadressi poolest kuuluvad tööpiirkonda, aga ruumikuju on vale või puudub. Kui menetleja tööpiirkonnaks on kogu Eesti, siis saab menetlusse võtta kõiki objekte. Kui objektil esineb aadress, millel 2. tasandi kood on tühistatud (objekt ise võib olla kehtiv või kehtetu), siis tööpiirkonna kontrolli ei tehta ja objekti menetlusse võtmine õnnestub. Menetluse jõustamise ajal kehtivad juba teised reeglid: siis peab nii kuju kui ka aadress sobima tööpiirkonnaga. Objektid võivad esineda paralleelselt mitmes pooleli menetluses. Selleks, et vältida menetluste pooleli unustamist ja süsteemi risustamist, on siiski vajalik ärireegel, et täpselt sama liiki pooleli menetluses tohib sama objekt esineda ainult 1 kord. Automaatselt ADS süsteemi poolt loodud menetlustesse ei ole võimalik käsitsi objekte lisada, sest need menetlused on loodud spetsiaalselt aadressimuudatuste kiirtöötluseks ja muid parandusi neis teha ei saa Objektide lisamine otsinguga Menetluse vormil asub nupp Vali objektid menetlusse. Sellele vajutamisel avaneb tavapärane objektide otsinguvorm käesoleva menetluse kontekstis. Otsinguvormil saab teha päringut tavapärasel moel ning märgistada soovitud objekte. Erinevus seisneb selles, et otsinguvormil on nupp Võta menetlusse, mis seob valitud objektid käesoleva menetlusega. Tavajuhul saab otsinguvormilt alustada uut menetlust. See funktsionaalsus on asendatud objektide lisamisega juba loodud menetlusse, kui otsinguvorm avati menetluse seest Seotud objektide kiirlisamine Iga menetluses oleva objekti juures on nupp Näita seotud objekte. Selle nupu vajutamisel teeb süsteem ruumianalüüsi objekti kuju alusel ning leiab kujuga kattuvad teist liiki objektid. Kattuvuse protsent on parameetritest häälestatav. Hoonete puhul leitakse ruumiliselt seotud katastriüksused ja vastupidi. Päring tehakse menetlustes pooleli olevate objektide hulgast, sh ka käesolevas menetluses, ja põhisüsteemi objektide hulgast. Seotud objektide hulgast saab soovitud objektid märgistada ja kohe ka menetlusse võtta või teisest menetlusest ümber tõsta. Menetlusse võtmisel või ümbertõstmisel rakenduvad tavapärased tööpiirkonna kontrollid Objektide tõstmine ühest menetlusest teise Kui objekti loomine menetluse kaudu on alles pooleli, siis ei saa seda objekti teises menetluses muuta. Siiski võib olla tarvis menetleda objekti koos mingite teiste objektidega ning seetõttu on tarvis kolida loodav objekt ühest menetlusest teise. AS Datel /226

77 Menetluse sees on võimalik märkida soovitud objektid, sisestada teise menetluse number ning kinnitada soovi. Süsteem kontrollib objektide seostamise võimalikkust ja kolib objekti teise menetlusse, kui see on võimalik. Eelmisest menetlusest objekt eemaldatakse. Analoogset tegevust on võimalik sooritada ka seotud objektide kiirlisamise kaudu Objektide lisamine kaardiaknast Kaardiaknas saab märgistada põhisüsteemis olevaid objekte ning alustada nendega uut menetlust või seostada olemasoleva menetlusega, kui kaardil ollakse mingi konkreetse loodud menetluse kontekstis. Menetlusrakenduse kaardil kuvatakse ka lähteülesannete kiht. Seisundite loetelu, millised lähteülesanded peavad sellel kihil näha olema. KLF_KOO D Selgitus Pikem selgitus Kas ADS-is kasutataks e Väljastamata Maa-ameti poolt alustatud tegevus ja LÜ ei ole veel välja antud ei Mõõdistamisel On väljastatud Maa-ameti poolt maamõõtjale jah Seotud toimikuga On tulnud katastrisse registreerimiseks ja on seotud menetlusega katastris jah Registreeritud On katastris seotud menetlusega ja see menetlus on lõppenud KÜ registreerimisega ei Kehtetu Maa-amet on muutnud LÜ kehtetuks ei vaba maa Maa-amet on välja selgitanud vaba maa (ei aegu) jah Kooskõlastatud Vaba Maa Maa-ameti poolt välja selgitatud vaba maa on kooskõlastatud omavalitsuse poolt Aegunud Maa-ameti poolt väljastatud LÜ (mis ei ole pärit vabade maade hulgast) aegub 6+1 kuu pärast väljastamist Pikendamisel Ajutine (üldjuhul mõni sekund kuni mõni minut) seisund kui hakatakse aegunud LÜ-d pikendama jah jah ei KOV väljastamata KOV-i poolt alustatud tegevus ja LÜ ei ole veel välja antud ei Erastamisele KOV-i poolt väljastatud LÜ täpsem määratul milleks KÜ moodustatakse jah Tagastamisele KOV-i poolt väljastatud LÜ täpsem määratul milleks KÜ moodustatakse jah Taotluseta KOV-i poolt väljastatud LÜ täpsem määratul milleks KÜ moodustatakse jah RMK vaba maa RMK poolt välja selgitatud vaba maa jah KKA vaba maa KKA poolt välja selgitatud vaba maa (seda liiki praegu ei kasutata) jah kooskõlastatud vaba maa (RMK) RMK poolt välja selgitatud vaba maa on kooskõlastatud omavalitsuse poolt jah kooskõlastatud vaba maa (KKA) KKA poolt välja selgitatud vaba maa on kooskõlastatud omavalitsuse poolt (seda liiki praegu ei kasutata) mõõdistamisel (RMK) RMK poolt väljaselgitatud vaba maa mis on mõõdistamisel (võrdne MA poolt mõõdistamisel oleva KÜ-ga) jah jah mõõdistamisel (KKA) seda liiki ei kasutata ei Nende lähteülesannete kujudega saab ka alustada uut menetlust või lisada neid olemasolevasse. Menetluses tekib siis uus katastriüksuse aadressiobjekt LÜ kujuga, millele on automaatselt omistatud ruumiaadress ning võimalusel ka normaliseeritud lähiaadress, kui LÜ juures sisestatud teksti normaliseerimine õnnestub. Kui ei õnnestu, siis paigutatakse kogu tekst 6. tasemele. Kui tekst ei vasta 6. taseme nõuetele, siis peab menetleja aadressi korrigeerima. AS Datel /226

78 Lähteülesannete kihile jääb LÜ nähtavaks muutmata kujul. Juhul kui eelkirjeldatud viisil menetlusse võetud KÜ ruumikuju kattub olemasoleva KÜ ruumikujuga, saab menetleja hoiatuse, et LÜ kuju alusel moodustatud KÜ kattub x% varasema KÜ-ga Objektide import menetlusse Objektide impordi jaoks on realiseeritud kolm võimalust: import tekstifailist, mis on eelkõige mõeldud uute kujude importimiseks. Lisaväärtusena võib see uue objekti korral sisaldada ka aadressi. Olemasoleva objekti aadressi tekstifailiga muuta ei saa. import tabelkujul failist, mis on mõeldud kas uute objektide tärkandmete importimiseks või olemasolevate muutmiseks, kuju andmed jäävad muutmata. import objektide ühendamiseks. Sisendiks on olemasolevate objektide tunnuste paarid, mis impordi käigus ühendatakse. Tabelkujul menetlusse andmete impordi funktsionaalsus eeldab, et uus (lisatav) objekt, millel puudub ADS_OID, ei tohi omada ka päritoluregistri tunnust. Impordi käigus tekib viga, kui päritoluregistri tunnus on määratud, aga ads_oid mitte. Samuti kui muudetakse olemasolevat objekti, siis päritoluregistri tunnust ei omistata ega muudeta. Ei teki vigu ebakõlade puhul. Kui andmeid impordib erihaldaja, siis on hooneosade puhul erikäsitlus. Kui imporditakse uut hooneosa või ADSis oleval hooneosal puudub orig_tunnus, aga importfailis on see olemas, siis toimub omistamine juhul, kui ei käesolevas menetluses ega ka mitte põhisüsteemis ei leidu sellise tunnusega objekti. Kui imporditav tunnus on juba kasutusel mõnel teisel objektil, siis tekib viga. Kui ADSis hooneosal on orig_tunnus olemas, aga importfailis on teistsugune väärtus või tühi, siis tekib viga. Hoonete ja katastriüksuste importimisel ignoreerib süsteem päritoluregistri tunnuse väärtust ka erihaldaja puhul Objektide kuvamine menetluses Menetluse objekte kuvatakse 2 vaates: perekonnavaade (see on vaikimisi) ja tavavaade. Perekonnavaade tekib objektide sorteerimise tõttu. Igal objektil on perekonnanimi, milleks on perekonnapea ADS-OID. Ühesuguse perekonnanimega objektid moodustavad perekonna. Teisest küljest on vajadus tagada, et viimati lisatud objektid oleks nimekirja alguses. Kuna see vajadus on vastuolus perekondade moodustamise põhimõttega, tuleb leida sobiv kompromiss. Perekonnavaates on objektide sorteerimisjärjekord vaikimisi: esimeseks perekonnapea menetluses versiooni id kahanevas järjestuses, teiseks perekonnapea ADS-OID kasvavas järjestuses, kolmandaks aadressiobjekti liigi kasvavas järjestuses, et tagada katastriüksuse esikoht perekonnas neljandaks objekti menetluses versiooni id kahanevas järjestuses. AS Datel /226

79 Tavavaates järjestatakse objektid menetluses versiooni id kahanevas järjekorras. See tagab automaatselt, et viimati menetlusse lisatud objektid on nimekirjas kõige ees Objektide grupeerimine automaatsetesse menetlustesse ADS süsteemis toimuvad taustprotsessid loovad automaatseid menetlusi KOV töölauale. Süsteem peab tagama, et need menetlused ei sisaldaks liiga palju objekte ja et ühe menetluse objektid oleksid ruumiliselt lähestikku asetsevad. Ühe perekonna objektid peavad kuuluma samasse menetlusse. Menetluste automaatse ühendamise reegel Nõuded menetluste automaatsel ühendamisel: 1) Kui ühe KOV piires esineb kuni 10 menetletavat objekti, siis tekib 1 menetlus KOV jaoks 2) Kui ühe KOV piires on enam kui 10 menetletavat objekti, siis toimub grupeerimine asustusüksuste (3. taseme) kaupa. 3) Kui ühe asustusüksuse piires tekib enam kui 10 menetletavat objekti, siis toimub grupeerimine mitteametliku piirkonna nime kaupa. Ilma MA piirkonnata aadressid moodustavad omaette grupi. 4) Protsess ühendab menetlused nende gruppide piires, kusjuures ühte menetlusse ei paiguta ta rohkem kui 10 objekti. Kõik algses menetluses olevad objektid liiguvad ühendatavase menetlusse koos. Iga protsess tekitab erinevat liiki ja erineva lühikirjeldusega menetlusi, seepärast ei ole mõistlik neid kokku koondada. Alljärgnevalt käsitleme iga protsessi eraldi. HOONETE AUTOMAATNE ÜHENDAMINE Süsteem teeb A-liiki menetluse, kui ühendatavate hoonete kujud ühtivad ETAK puhvri ulatuses, menetlejaks Maa-amet. Kui sellise menetluse jõustamine ebaõnnestub, siis muudab süsteem menetluse liigiks E ja määrab menetlejaks KOV-i. Kui 2 ühendatava hoone kujud ühtivad 50% või enam, siis teeb süsteem kohe E-liiki menetluse ja menetlejaks KOV. Iga ühendatava paari jaoks teeb süsteem eraldi menetluse. Protsessi lõppedes ühendab süsteem protsessi poolt loodud E-liiki menetlused automaatselt vastavalt ühendamise reeglitele. ETAK ANDMETE IMPORT Süsteem teeb A-liiki menetlusi, kui on võimalik objekti automaatselt muuta. Kui menetluse jõustamine ebaõnnestub, siis muudab süsteem menetluse liigiks E ja menetlejaks KOV-i. Kui ETAK objekt on lisandunud, siis teeb süsteem E-liiki menetluse iga objekti jaoks eraldi. Protsessi lõppedes ühendab süsteem protsessi poolt loodud E-liiki menetlused automaatselt vastavalt ühendamise reeglitele. HOONE JA KÜ AADRESSI KOOSKÕLLA VIIMINE AS Datel /226

80 Süsteem teeb O-liiki menetlusi iga perekonna jaoks oma menetluse. Protsessi lõppedes ühendab süsteem protsessi poolt loodud O-liiki menetlused automaatselt vastavalt ühendamise reeglitele. 4.3 Andmete esitamine EHR-st EHR rakenduses on vajadus menetleda ainult teatud muutuvaid hooneosi ning nende jaoks on oluline, et mittemuutuvate hooneosade vead ei takistaks menetluste jõustamist ei EHR ega ADS poolel. ADS menetlusrakenduse üldine loogika eeldab aga, et kui hoone võetakse menetlusse, siis ka kõik temaga seotud hooneosad. Sellele asjaolule tuginevad kõik kontrollid. EHR poolsetele vajadustele saab ADS vastu tulla ainult osaliselt, selleks, et üldine andmekvaliteet ei kannataks. Kui muutub hoone aadress või kui oluliselt muutub hoone ruumikuju, siis on EHR siiski sunnitud menetlema ka kõiki selle hoone osi. ADS peab jätkuvalt vajalikuks tagada, et kõigi hooneosade aadress oleks hoonega vastavuses. Möönduse võib teha vaid üksikut hooneosa puudutavatele vigadele, näiteks 8. taseme komponendis sisalduvad ebasoovitavad sümbolid vms. Kui EHR esitab andmed X-tee kaudu, siis ei võeta koos hoonega menetlusse automaatselt ka tema osi. Võetakse ainult need osad, mis sisalduvad esitatavas hulgas. Menetlusrakenduse kaudu hoone menetlusse võtmisel võetakse automaatselt kaasa ka kõik osad see funktsionaalsus säilib. Kontrollide pakett rakendub kõigile menetlustele ühtviisi. Ei ole otstarbekas luua X- tee kaudu loodud menetlustele teistsugust kontrollide paketti. Kontrollimisel tuleb arvestada, et menetluses oleval hoonel võib olla ka selliseid osi, mis pole menetluses. Ka nende andmete kooskõla tuleb kontrollida. Probleemide esinemisel lisanduvad veateated menetuses olevale hoonele Hoonete tühistamine Kui EHR esitab hoone tühistamise, siis võetakse automaatselt menetlusse siiski ka kõik tema osad, sest ka tühistatakse koos hoonega Hooneosa samasuse tuvastamine Kui EHR esitab hooneosa andmed ja ADS süsteemis ei leidu kehtivat hooneosa sama päritoluregistri tunnusega, siis enne uue aadressiobjekti tekitamist otsib süsteem, kas seotud hoones leidub samasuguse 8. taseme komponendiga hooneosa ilma päritolu tunnuseta. Kui leidub, siis kontrollib süsteem, et sellel hooneosal ei leiduks ka ajalooliselt viidet mõnele teistsugusele päritoluregistri tunnusele. Kui leidub (päritoluregistri seos on erihaldaja poolt vahepeal käsitsi eemaldatud), siis teeb süsteem ikka uue objekti, aga kui ei leidu, siis võtab kasutusele sama aadressiobjekti ja omistab sellesse tunnuse päritoluregistris. AS Datel /226

81 4.3.3 EHR esitatud kuju alusel hoonete automaatne ühendamine Kui EHR süsteem esitab objektile ruumikuju, mil see enne puudus, siis tekib enamasti sellele objektile menetluse kontrollimisel probleem, et esineb kattuvus teise, ETAK päritoluga aadressiobjektiga. See viga juhtub nii sel juhul, kui EHR rakenduses on ADSi esitatud EHR objektile kopeeritud teise ADS objekti kuju, kui ka sel juhul, kui kuju on EHR rakenduses muul viisil saadud. Kokkulangevuse tõenäosus on suurem just korrektsete andmete puhul. ADS haldajad saavad neid vigu küll mitteaktuaalseks märkida ning öösel käivituv automaatse ühendamise protsess lahendaks olukorra, kuid see tekitab haldajaile suure töökoormuse ning korrektsed EHR menetlused jäävad pidevalt vigade tühistamise ootele. Sujuv menetlemise protsess on takistatud. Seetõttu tuleb võimalusel ühendada kattuvad objektid automaatselt. Siiski on tarvis enne ühendamist hoolikalt kontrollida, et automaatse ühendamise tõttu ei tekiks menetlusse uusi probleeme, mis muidu ei esineks. Andmete EHRst esitamisel lisandub enne menetluse kontrolli täiendav vahetegevus. See otsib menetlusest kehtiva staatusega hooneid, mil on olemas ehr-kood ja geomeetria ning puudub ETAK-ID. Eeldame, et EHR võib korraga esitada ka mitu hoonet. Kui selliseid hooneid leidub menetluses, siis need on potentsiaalsed ühendamise kandidaadid. Edasi otsib süsteem iga kandidaadi puhul, kas põhisüsteemis leidub teisi kehtivaid hooneid, mille ruumikuju kattuks kasvõi osaliselt menetluses hoonega. Kui selliseid ei leidu või leidub rohkem kui 1, siis ühendamist ei tehta. Kui leidub täpselt 1, siis on see võimalik ühendamise paariline. Edasi uuritakse, kas leitud paarilisel on olemas ETAK-ID ja puudub originaalregistri tunnus ja kas nende paariliste kujud kattuvad piisavas ulatuses. Piisav ulatus leitakse samade reeglite alusel, mis automaatsel ühendamisel A-liiki menetluse puhul. Kui kõik tingimused ei ole täidetud, siis jääb ühendamine ära. Kui on täidetud, siis püütakse objektid ära ühendada. Selleks võetakse leitud paariline menetlusse. Kui paarilise menetlusse võtmine ebaõnnestub näiteks seetõttu, et vastav objekt on kuskil teises menetluses lukus, siis jääb ühendamine ära, aga täiendavat viga menetlusse ka ei teki. Kui paarilise menetlusse võtmine oli edukas, siis ühendatakse objektid ära. Ühendamise käigus kantakse paarilise kuju EHR objektile ning omistatakse talle ka ETAK-ID. Paariline tühistatakse. EHR objekti aadressid ei muutu, vaid jäävad need, mis EHR on esitanud. Paarilise tühistamise tõttu on suurem tõenäosus ka aadresside unikaalsuse tagamiseks. Sellise ühendamise tulemusel ei tohiks menetlusse tekkida mitte ühtegi uut viga. 4.4 Andmete muutmine menetluses Menetlusel endal kohustuslikud sisestatavad andmed puuduvad. Soovi korral on võimalik sisestada menetluse lühikirjeldus, mida kuvatakse menetluse otsingus ja mille abil on võimalik üht menetlust teisest eristada. Menetlusele saab sisestada ka märkusi. Märkused salvestuvad ühte tekstivälja ja on kõigi menetlusõigustega AS Datel /226

82 kasutajate poolt redigeeritavad. Märkused võivad vajalikud olla näiteks menetluse üleandmisel ühelt kasutajalt teisele teatavate suunavate juhiste sisestamiseks vms. Menetluses kuvatakse ka menetleja organisatsiooni kontaktandmeid: telefoni ja e-posti aadressi. Need loetakse vaikimisi organisatsiooni andmetest, kuid menetluse sees saab need üle kirjutada. Menetleja muutmisel asendatakse need väärtused uue organisatsiooni omadega Muudatuse õiguslik alus Menetluse juurde saab kasutaja sisestada õigusakti andmed, mis on selle menetluse loomise aluseks. Menetluse jõustamisel jääb objektide muutumise õiguslikuks aluseks menetlus ise Kujude sisestamine Kujude sisestamine ja muutmine toimub ainult objekthaaval. Iga menetluses oleva objekti detailandmete vormil on kuju sisestamiseks järgmised võimalused. Digimine kaardil. Vastava nupu vajutamisel avaneb kaardiaken, kus vaadeldava objekti kuju on kohe redaktoris ja seda saab muuta. Kui objektil kuju puudub, siis avaneb kaart sellises suurendusastmes, mille määravad teised samas menetluses olevate objektide kujud. Kui ka teistel objektidel puuduvad kujud, siis määravad suurendusastme menetluses olevad aadressid. Eelistatakse vaadeldava objekti aadressi, kui see puudub, siis teisi aadresse. Kaart avaneb aadressi 4. või 3. taset initsialiseeriva objekti suurenduses, sõltuvalt sellest, mis on aadressis määratud. kui menetluses puuduvad ka aadressid, siis avaneb kaart menetluse tööpiirkonna suurenduses. Kasutajal on võimalik kaardi suurendusastet vastavalt vajadusele muuta ning liikuda soovitud asukohale. Seal digida puuduva objekti kuju tuginedes aluskaartidele. Kaardiakna redaktoris on võimalik punktidele koordinaate sisestada ka numbrilisel kujul. Kujude digimine on võimalik ainult sel juhul, kui kuju puudub või kui kuju on kas digitud või kaardistatud moodustamisviisiga. Koordinaatide sisestamine tekstina. Kasutajaliideses on võimalik objekti kuju sisestada tekstina. Vastava nupu vajutamisel avaneb vorm, kus kõigepealt tuleb määrata sisestatava kuju tüüp. Kui kuju oli juba varasemast olemas, siis kuvab süsteem olemasolevad koordinaadid ja kuju tüübi. Võimalikud tüübid on: punkt pind (uue kuju puhul vaikimisi määrang) sisepiiridega pind Seejärel tekstikast, kuhu tuleb sisestada koordinaadid kokkulepitud kujul. Sisestamise asemel on võimalik koordinaadid tekstifailist kopeerida. Kopeerimise asemel on võimalik üleslaadida ka kokkulepitud struktuuriga tekstifail. Nõuded tekstina sisestatud koordinaatidele on täpselt samad nagu importfailile. Need on kirjeldatud peatükis 9. Mõõdistusandmete importfaili kirjeldus AS Datel /226

83 Pärast koordinaatide sisestamist või üleslaaditava faili osundamist vajutab kasutaja nuppu, mille tulemusena süsteem koordinaatide põhjal määratud tüübiga kuju püüab moodustada. Kui see ei õnnestu või tekib vigane kuju, siis antakse kasutajale vastav teade, sisestusaken jääb avatuks ning kasutaja saab koordinaate parandada ja uuesti proovida. Koordinaatide import on võimalik ainult sel juhul, kui kuju puudub või kui kuju on kas digitud või kaardistatud moodustamisviisiga. Aadressipunkti asukohta saab muuta. Hoone osade kujusid saab ka muuta, sest need praegu puuduvad ja EHR-st neid niipea tulema ei hakka. Et kortermaju üldse ADS-s menetleda saaks, selleks on lubatud hoone osade kujude muutmine. EHRst andmete vastuvõtmisel olemasolevat hoone osa kuju tühjaks ei tee Kuju metaandmed Kuju metaandmetest on oluline määrata kuju moodustuse viis. Valikud on järgmised: D digitud K kaardistatud M mõõdistatud Süsteem pakub vaikimisi viisiks mõõdistatud ehk kõige täpsemat viisi, kui kasutaja sisestab koordinaadid käsitsi või impordib failist. Valida saab ka teisi liike. Kõik Maaregistrist (katastrist) laekunud katastriüksuste kujud saavad moodustusviisiks mõõdistatud, ka siis, kui nad on tekkinud kaardi- ja plaanimaterjali alusel. Kaardistatud on ETAK süsteemis tekkinud kujud. Digitud on kasutaja poolt omaalgatuslikult veebikaardil osundatud punkt või pind. Kui kasutaja on kaardiaknas objekti kuju muutnud, siis salvestub objektile automaatselt see moodustamise viis. Moodustamise viisi prioriteedid ei mõjuta kuju muutmise võimalusi. Mõõdistatud kuju on võimalik madalama prioriteediga viisil muuta. Põhjus on selles, et mõõdistus võib olla vananenud või ebatäpsete mõõteriistadega tehtud. Uuemad kaardistusvahendid võimaldavad täpsemat asukoha määramist. Samuti on vaja parandada juhtumeid, kus kujule on ekslikult omistatud vale moodustusviis Aadresside muutmine menetluses Aadresside sisestus Menetluse käigus saab objektidele aadresse lisada, olemasolevaid muuta ja tühistada. Kõigil objektidel, v.a hoone osadel on lubatud paralleelaadressid. Uue aadressi lisamisel objektile tuleb kasutajal taseme komponendid alati valida olemasolevate hulgast. Kui sobivat valida ei ole, siis ei saa aadressi lisada ja tavamenetlejal tuleb pöörduda ADS osakonna töötajate pole, et vastavad komponendid tekiks. Enamasti on põhjuseks siiski liikluspindade ja väikekohtade õigusliku aluse puudumine, mida peab KOV kehtestama ja ADS osakonnale edastama. Aadressi 1. ja 2. taseme komponendid väärtustab süsteem uue aadressi lisamisel tööpiirkonna alusel automaatselt. Kasutaja ei saa neid muuta. Kui tööpiirkonnaks on kogu Eesti, siis tuleb kasutajal valida ka 1. ja 2. taseme väärtused. Kasutaja saab neid AS Datel /226

84 muuta. Süsteem kontrollib aadressi sobivust, s.h objekti asukohaga kaardil, jõustamise hetkel taseme komponendid tuleb kasutajal alati kas valida või sisestada. Aadressi salvestamise hetkel eelistab süsteem sisestatud väärtust, kui kasutaja on ühel tasemel komponendi nii valinud kui ka sisestanud. Olemasoleva aadressi muutmisel toodab süsteem põhisüsteemis registreeritud aadressist uue versiooni, identse olemasolevaga, mida kasutaja saab redigeerida. Ka olemasolev aadress jääb menetluse sees nähtavaks koos tunnusega objektilt eemaldatud ning uus versioon saab tunnuse objektile lisatud. Põhisüsteemi kirjutamisel asendatakse objekti aadress. Menetluse sees põhisüsteemis registreeritud aadress otse redigeeritav ei ole Aadressi lisamine menetluses Kasutaja vajutab menetluses objekti detailandmetes nuppu Lisa aadress. Süsteem kuvab aadressi sisestusvormi eraldi modaalses aknas. Kasutaja sisestab aadressi ja vajutab nuppu Salvesta. Süsteem lisab objektile uue aadressi. Seejärel kontrollib süsteem, kas tegemist on hoonega, kas hoonel on menetluses kehtivaid osi ja mitu aadressi hoonele pärast aadressi lisamise tegevust jääb. Kui hoonele jääb 1 aadress ja leidub kehtivaid osi, siis muudab süsteem automaatselt hoone osade aadressid. Kasutaja käest selle tegevuse jaoks täiendavat kinnitust ei küsita. Süsteem kuvab kasutajale teate: Hoone aadress lisatud. Hooneosade aadress muudetud. Kui hoonele jääb enam kui 1 aadress ja leidub kehtivaid osi, siis küsib süsteem kasutaja käest täiendavalt: Kas omistada uus aadress ka hoone osadele? Nupud Jah / Ei. Kui kasutaja vastab jaatavalt, siis muudab süsteem hooneosade aadressid lisatud aadressiga vastavaks. Kasutajale kuvatav teade tegevuse lõpetamisel on sama. Kui kasutaja vastab eitavalt, siis kuvab süsteem kasutajale teate: Hoone aadress lisatud. Hooneosade aadress ei muutunud.. Kui hoonel ei leidunud kehtivaid osi, siis kuvab süsteem kasutajale teate: Hoone aadress lisatud.. Kui kasutaja lisas aadressi mitte hoonele, vaid katastriüksusele või hooneosale, siis kuvab süsteem kasutajale teate: Katastriüksuse aadress lisatud. või Hooneosa aadress lisatud Aadressi muutmine menetluses Kasutaja avab menetluses objekti detailandmetes olemasoleva aadressi muutmiseks. Süsteem kuvab aadressi muutmisvormi eraldi modaalses aknas. Kasutaja muudab aadressi ja vajutab nuppu Salvesta. Süsteem salvestab muudatused, ei kontrolli, kas aadress ka tegelikult muutus. Kasutaja võis ka lihtsalt Salvesta vajutada ilma midagi muutmata. Seejärel kontrollib süsteem, AS Datel /226

85 kas tegemist on hoonega, kas hoonel on menetluses kehtivaid osi ja mitu aadressi hoonel on. Kui hoonel on 1 aadress ja leidub kehtivaid osi, siis muudab süsteem automaatselt hoone osade aadressid. Kasutaja käest selle tegevuse jaoks täiendavat kinnitust ei küsita. Süsteem kuvab kasutajale teate: Hoone aadress muudetud. Hooneosade aadress muudetud. Kui hoonel on enam kui 1 aadress ja leidub kehtivaid osi, siis küsib süsteem kasutaja käest täiendavalt: Kas omistada uus aadress ka hoone osadele? Nupud Jah / Ei. Kui kasutaja vastab jaatavalt, siis muudab süsteem hooneosade aadressid muudetud aadressiga vastavaks. Kasutajale kuvatav teade tegevuse lõpetamisel on sama. Kui kasutaja vastab eitavalt, siis kuvab süsteem kasutajale teate: Hoone aadress muudetud. Hooneosade aadress ei muutunud.. Kui hoonel ei leidunud kehtivaid osi, siis kuvab süsteem kasutajale teate: Hoone aadress muudetud.. Kui kasutaja muutis aadressi mitte hoonel, vaid katastriüksusele või hooneosal, siis kuvab süsteem kasutajale teate: Katastriüksuse aadress muudetud. või Hooneosa aadress muudetud Aadressi eemaldamine menetluses Kasutaja vajutab menetluses objekti detailandmetes olemasoleva aadressi juures linki Eemalda. Süsteem eemaldab objektilt aadressi. Seejärel kontrollib süsteem, kas tegemist on hoonega, kas hoonel on menetluses kehtivaid osi ja mitu aadressi hoonele pärast aadressi eemaldamist jääb. Kui hoonele jääb 1 aadress ja leidub kehtivaid osi, siis muudab süsteem automaatselt hoone osade aadressid. Kasutaja käest selle tegevuse jaoks täiendavat kinnitust ei küsita. Süsteem kuvab kasutajale teate: Hoonelt aadress eemaldatud. Hooneosade aadress muudetud. Kui hoonele jääb enam kui 1 aadress või kui ei jää mitte ühtegi aadressi või kui hoonel pole kehtivaid osi, siis hooneosade automaatset muutmist ei tehta. Süsteem kuvab kasutajale teate: Hoonelt aadress eemaldatud.. Kui kasutaja eemaldas aadressi mitte hoonelt, vaid katastriüksuselt või hooneosalt, siis kuvab süsteem kasutajale teate: Katastriüksuselt aadress eemaldatud. või Hooneosalt aadress eemaldatud Aadressi taastamine menetluses Aadressi taastamine menetluses toimub juhul, kui objektilt on eemaldatud põhisüsteemis registreeritud aadress. Olemuslikult on tegevus samaväärne aadressi lisamisega. Kasutaja vajutab objekti detailandmetes eemaldatud aadressi juures linki Taasta. Süsteem tühjendab aadressi juures eemaldamise tunnuse. Seejärel jätkub kasutuslugu samal moel nagu kirjeldatud aadressi lisamise juures. AS Datel /226

86 Hooneosa aadressi automaatne muutmine Hooneosa aadressi automaatsel muutmisel jätab süsteem kõigepealt meelde olemasolevate aadresside 8. taseme komponentide unikaalsed nimetused. Kui hooneosal aadressid puudusid, kuid on olemas EHR süsteemist laekunud tähis, siis loeb ADS süsteem selle tähise 8. taseme komponendi nimetuseks. Kui ka tähis puudub, siis jääb 8. taseme komponendi nimi määramata. Edasi eemaldab süsteem hooneosalt kõik olemasolevad aadressid. Uus aadress moodustub viidatud hoone aadressist, millele lisandub 8. taseme komponent. Aadresside automaatsel muutmisel tekib hooneosale niimitu aadressi, kuimitu unikaalset 8. taseme komponenti tal oli. Kui hooneosal ei olnud mitte ühtegi aadressi, siis pärast automaatset muutmist tekib talle 1 aadress Aadressi lisamine kuju alusel Uue aadressi lisamine kuju alusel on võimalik sel juhul, kui objektil on kuju olemas. Vastava nupu vajutamisel saab kasutaja lasta süsteemil sobivad aadressid otsida ja objektile lisada. Nupp Lisa kuju alusel. Süsteem leiab objekti ruumikuju alusel suurima osakaaluga ruumiaadressi ja leiab primaarselt seotud objektid. Süsteem lisab objektile aadressid seotud objektide küljest, mis langevad kokku suurima ruumiaadressiga. Kui selle loogikaga ei leitud objektile ühtegi aadressi, siis lisab süsteem lähimad aadressikohad väikekoha tasandiga. Kui ikka ei lisatud ühtegi aadressi, siis lisandub aadressiks ainult EHAK tasanditega ruumiaadress. Nupp Lisa lähimad aadressikohad. Süsteem leiab objekti ruumikuju alusel suurima osakaaluga ruumiaadressi. Siis leiab lähimad aadressikohad liikluspinna või väikekoha tasandiga ning lisab need aadressid objektile, kui tal veel ei ole sellist aadressi. Ruumianalüüsi alusel aadresside lisamisel kehtib põhimõte, et kui objektil juba leidub sarnase algusega aadress, siis seda ei lisata. Lisamist alustatakse kõige täpsemalt määratud aadressidest. Aadressi sobivuse kontrolle selle lisamise ajal ei tehta. Sobivuse kontrollid toimuvad menetluse jõustamise hetkel ja on realiseeritud kontrollide moodulis Aadressipunkti muutmine Aadressi lisamisel omistab süsteem aadressipunkti koordinaadid vaikimisi objekti kuju tsentroidi alusel. Kui objektil kuju puudub või kui kuju hiljem muudetakse, siis saab aadressi juures punkti koordinaate kuju alusel alati värskendada. Aadressipunkt ei pea aga tegelikult asuma mitte kuju tsentroidis, vaid sissepääsu juures (hoone välisuks või värav piirdega ümbritsetud katastriüksuse korral või ligipääsu tee juures, mille kaudu üksusele tavaliselt käiakse). Seetõttu on kasutajal võimalik kaardiaknas nihutada aadressipunkt sobivamasse asukohta. Soovi korral saab kasutaja aadressipunkti koordinaadid ka sisestada numbritena. Ei pea alati kaardiaknas seda muutma. AS Datel /226

87 Aadressipunkt peab siiski asuma objekti kuju sees. Vastavad kontrollid tehakse menetluse jõustamise hetkel Hoone osade lisamine Hoone osade aadressiobjektid ER ja MR peavad alati olema seotud mingi konkreetse hoonega (liigid EE või ME). Sellepärast toimub nende objektide lisamine alati hoone detailandmete vormi kaudu. Võimalik on lisada üksik osa sel juhul tuleb kõik osa andmed sisestada osa detailandmete vormil. Kortermajade puhul on aga hoonel palju osi ja seepärast on oluline ka hulgakaupa lisamise funktsionaalsus. 1. Kasutaja valib tegevuse, et soovib lisada osi hulgakaupa. 2. Kasutaja valib hoonele omistatud aadresside hulgast täpselt 1, valib objekti liigi (ER või MR) ja sisestab numbrivahemiku alates ja kuni väärtused. Nii alates kui kuni on kaasa arvatud. Seejärel kinnitab lisamise soovi. 3. Süsteem kontrollib, et hoonel poleks vastavas numbrivahemikus oleva tähisega osi Kui on, siis on viga ja osade lisamine ebaõnnestub Kui ei ole, siis lisab süsteem nii mitu osa, kui on numbrivahemikus numbreid. Üle 1000 osa lisada pole võimalik Süsteem omistab osa tähiseks järgmise numbri numbrivahemikust Osa aadressiks omistab hoone aadressi, mille 8. tasemel on objekti tähiseks olev number Osa kujuks saab hoone aadressipunkt. Süsteem arvestab aadressi juurde salvestatud punkti. Vaikimisi on selleks objekti kuju tsentroid Sissepääsu korruseks saab vaikimisi 1. Hiljem on võimalik see muuta grupiviisilise muutmise kaudu. Kui hoonel on osa kortereid kokku ehitatud ja mõned numbrid on seetõttu vahelt puudu, siis on võimalik hoone osi pärast lisamist vahelt eemaldada. Eemaldamine ei ole võimalik ADS põhisüsteemis registreeritud hooneosade korral, neid saab ainult tühistada (määrata oleku väärtuseks tühistatud) Hoone osade muutmine Hoone osade puhul on vajalik ka grupiviisiline andmete muutmine. Tähist (8. taseme komponenti) ei ole võimalik grupiviisiliselt muuta, seda saab teha ainult ükshaaval. Grupiviisiliselt saab muuta järgmisi andmeid: aadressi valida tuleb 1 hoone paralleelaadressidest ja süsteem moodustab hoone osa aadressi sellest koos tähisega. sissepääsu punkti saab värskendada hoone osa koordinaate hoone aadressipunkti koordinaatidega objekti liiki eluruum / mitteeluruum, seda saab teha niikaua, kuni objekt pole veel põhiregistrisse kantud, kuni on tegemist uue objektiga sissepääsu korrust AS Datel /226

88 Kasutaja märgistab loetletud andmerühmade hulgast need, mida ta soovib muuta. Seejärel märgistab hoone osad, millel need andmed muudetakse. Ühe hiireklõpsuga saab märgistada kõik osad. Siis kinnitab oma muutmissoovi vastava nupu vajutamisega. Süsteem esitab kinnitava küsimuse, millest on näha, mitmel objektil ja millised andmed muudetakse ning alles pärast teistkordset kinnitust toimub muutmine. Menetlusrakenduses on võimalik lisada hooneosadele mitu aadressi, kuid neil peab tase täielikult kattuma hoone aadressiga ning erinevus võib olla vaid 8. taseme komponendis. Sellisel juhul ei pea aadressi 8. tase ühtima hooneosa tähisega, vastasel juhul peab. See erisus on vajalik näiteks ühiselamu tubade korral kus ehitisregistris on mitmele toale määratud ühine tähis (nt ) kuid ADS-is on vaja tekitada erinevad hooneosa numbrid 127; 128; 129 ja 130 st paralleelaadressid, sest neid aadresse on vaja kasutada näiteks rahvastikuregistris et eristada erinevad leibkonnad omavahel Objektide ühendamine Võib tekkida olukord, kus üks ja sama objekt on ADS süsteemis registreeritud topelt. Sellisel puhul oleks tarvis üks neist tühistada ja andmed kopeerida teisele objektile. Taolist ühendamist ei saa teha, kui mõlemad objektid on seotud päritoluregistriga, sest siis saab tühistamisi teha ainult päritoluregistri kaudu. Ühendamist saab teha, kui tühistatav objekt ei ole päritoluregistris registreeritud, vaid on näiteks ETAK süsteemist laekunud. Objektide ühendamiseks peavad mõlemad objektid olema ühes ja samas menetluses. Kasutaja peab osundama objekti, mida ta soovib ühendada. Seejärel valima menetluse objektide hulgast teise, millega ta soovib seda ühendada ning kinnitama oma soovi. Ühendamist saab teha kaardiaknas, kui mõlemal objektil on kuju. Sel juhul osundab kasutaja kaardiaknas 2 kuju ja valib ühendamise tegevuse. Kui ühel objektidest kuju puudub, siis saab ühendamist teha ainult menetluse tärkpoolel. Objektide tabelis märgistada 2 objekti ja valida nende ühendamise tegevus. Süsteem tuvastab kumb on tühistatav ja kumb muudetav objekt. Kui see pole selge või kui see pole võimalik, siis tekib viga. Tühistatav objekt peab olema ilma päritoluregistri seoseta. Kui mõlemad ühendatavad on ilma päritoluregistri seoseta, siis tühistatakse ilma ETAK seoseta objekt. Kahe erineva ETAK seosega objekti ühendada ei saa. Seda peab tegema ETAK poolel. 4.5 Kontrollid objektide menetlemisel Kogu ADS menetlusprotsess seisnebki menetluses olevate objektide ADS ärireeglitele vastavuse kontrollimises, nende analüüsimisel vastu ülejäänud põhisüsteemis olevaid objekte. Iga ärireegel põhjustab teatud koodiga probleemi tekkimise objekti ja/või tema aadressi juurde. Probleemid seotakse menetluses objekti versiooniga. Menetluses leitud probleeme objekti aktuaalsete probleemidena ei käsitleta, küll aga menetluses aktuaalsetena. Objektide menetlusse võtmisel tema probleemid arvutatakse uuesti st ei loe kas probleem on põhisüsteemis märgitud mitteaktuaalseks või mitte. Põhjuseks on asjaolu, AS Datel /226

89 et menetluse käigus võivad veateateid tingivad asjaolud muutuda - seega tuleb üle kontrollida kas veateade endiselt esineb. Enne kui süsteem alustab ükshaaval vigade tuvastamist, muudab ta automaatselt kõik tühistatud hoonetega seotud hooneosad kehtetuks Menetluse ja objektide üldised probleemid Vea kood Vea kirjeldus 3 Objekti liik on kohustuslik 0 4 Objekti identifitseeriv tunnus päritoluregistris on kohustuslik 0 Seda kontrollitakse ainult X-tee kaudu loodud menetluste puhul 7 Objektil puudub aadress 0 9 Objekti andmete õiguslik alus on kohustuslik 0 See viga ei tohiks menetluses kunagi tekkida, sest õiguslik alus omistatakse puudumisel vaikimisi 14 Õigusliku aluse kuupäev ei tohi olla varasem eelmise versiooni omast 0 See viga võib tekkida põhiregistris oleva objekti muutmisel. Vajadusel saab kasutaja õigusliku aluse kuupäeva põhiregistris ilma menetluseta muuta 50 Sulgemise aluse kuupäev ei saa olla varasem tekkimise aluse 0 kuupäevast. See viga võib tekkida objekti tühistamisel, kui tühistamise aluse kuupäev on varasem tekkimise aluse kuupäevast Vajadusel saab kasutaja õigusliku aluse kuupäeva põhiregistris ilma menetluseta muuta 177 Objektil on seosed teistes registrites ([1]), tühistamine pole lubatud. See viga antakse hooneosale, mis on menetluses märgitud tühistatuks, kuid mis eksisteerib põhisüsteemis kehtivana sõltumata sellest, kas hoone on menetluses kehtiv või kehtetu. 1 Tühistami se tase Nõutav menetluses Ruumilise paiknemisega seotud probleemid Vea kood Vea kirjeldus 8 Objekti kuju on kohustuslik 0 89 Objekti kuju ei ole korrektne: [kuju on vale tüüpi] 0 Objektiliikide CU, EE ja ME kuju tohib olla vaid punkt või pind, objektiliikide ER ja MR kuju tohib olla vaid punkt 89 Objekti kuju ei ole korrektne: [kuju pindala on vähem kui 5 m2] 1 Pindobjekti puhul ei või ruumikuju pindala olla tavajuhul vähem kui 5m2. 89 Objekti kuju ei ole korrektne: [kuju pindala on rohkem kui m2] 1 Pindobjekti puhul ei või ruumikuju pindala olla tavajuhul rohkem kui m2. 89 Objekti kuju ei ole korrektne: [kuju ulatus on rohkem kui 800 m] 1 Pindobjekti läbimõõt ei tohi tavajuhul ületada 800 m 89 Objekti kuju ei ole korrektne: [punkt ei ole lubatud] 1 CU, EE ja ME puhul, kui kuju on esitatud punktina. 134 Objekti kuju kattub samaliigilise objekti kujuga põhisüsteemis: [ADS- OID loetelu kattuvate objektide kohta] Pindobjekti korral ei tohi tema kuju olla ülekattes teise samaliigilise objekti kujuga põhisüsteemis. Ülekate tohib olla vaid topoloogilises ulatuses, mis on X cm objekti piirist seespool. (X on parameetritest 1 Tühistami se tase Nõutav menetluses AS Datel /226

90 häälestatav, juunis 2013 on see 1,4m) Punktobjekt ei tohi langeda pinnale. Punkte omavahel ei võrrelda. Võrdlemisel loetakse objektiliigid EE ja ME samaliigilisteks, neid võrreldakse omavahel. Lisaks võrreldakse CU liiki. Ootel objektid vea arvutuses ei osale. 137 Aadressipunkt ei ühti objekti kujuga 0 Kontroll toimub kõigi objektide korral. Aadressipunkt peab asuma objekti kuju sees. Kui objekti kuju on punkt, siis peab aadressipunkt sellega võrduma. Süsteem omistab vaikimisi aadressipunktiks kuju tsentroidi, kuid kasutaja saab seda muuta. Seetõttu on vaja kontrolli. 175 Menetluses mitteosaleva hooneosa kuju ei ole hoonega kooskõlas [1] Aadressiga seotud probleemid Vea kood Vea kirjeldus 81 Aadress on vananenud See viga tekib, kui objektile on lisatud aadress, mis põhisüsteemis vahepeal vananenud või kui vananenud aadress on objektil menetluses asendamata jäänud 82 Aadress on tühistatud See viga tekib, kui objektile on lisatud aadress, mis põhisüsteemis vahepeal tühistatud või kui tühistatud aadress on objektil menetluses asendamata jäänud 80 Aadress ei sobi ruumiliselt objekti juurde See viga tekib, kui objekti aadressi EHAK osa ei ühti objekti ruumiaadressiga Kui mitteelukondliku hoone aadress ei lähe kokku tema ruumiaadressiga aga asub KÜ-l, millel on hoonega sama ruumiaadress olemas, siis seda veateadet ei teki. 85 Aadress ei ole unikaalne, vaid esineb teistel samaliigilistel objektidel [ads_oid loetelu] 138 Unikaalsusnõudega aadressis puudub lähiaadressi osa See veateade antakse nii menetluses kui põhisüsteemis objekti kontrollimisel, kui objektil on UN tunnus ja tema aadress on ainult EHAK täpsusega. Täiendavalt lisandub see veateade ka sellistele hoonetele, millel on ruumikuju ja ei ole UN-tunnust, aga mis asuvad UN alal vähemalt 50% ulatuses. 86 Aadressis puudub aadressinumber See viga tekib, kui aadressis on määratud 4. või 5. tase ja puudub 7. tase 79 Aadressis esitatud [1] tasand ei saa kuuluda määratud ülemtasandi [2] alla See viga tekib, kui esitatud aadress on ebakorrektse struktuuriga tasandite poolest. Veateates tuuakse välja konkreetsed tasandid, mis üksteisele järgneda ei tohi. Keelatud järgnevused on näiteks: 2 -> 7; 3 -> 7; 4 -> 6; 5 -> 6; 5 -> 8; 4 -> 8; 3 -> 8; 2 -> 8 88 Ehitise aadress ei sobi katastriüksusega [1] Ehitise aadressi algusosa peab ühtima katastriüksuse aadressiga. Ehitise aadress võib olla täpsem kui katastriüksuse aadress. Esimese 6 taseme komponendid peavad täpselt ühtima. Täiendus võib lisanduda hoone aadressile alates 7. tasemest ning see peab olema KÜ aadressist eraldatud sümboliga "/". Kui hoone aadressis lisandub 7. taseme komponent ja KÜ aadressis see puudub, siis lisab eraldaja "/" ADS süsteem täisaadressi genereerimisel automaatselt ja 7. taseme Tühistami se tase Nõutav menetluses AS Datel /226

91 komponent seda ei sisalda (analoogselt on see ka hooneosa numbri eraldajaga milleks on sidekriips - ). Paralleelaadresside korral peab hoone iga aadress sobima temaga ruumiliselt seotud KÜ ühe aadressiga. Menetlussüsteemis kontrollimisel arvestatakse menetluses olevat aadressi, juhul kui seotud objekt on ka samas menetluses, või põhisüsteemis olevat aadressi, kui seotud objekt samas menetluses ei ole. Selle probleemi saavad nii hoone kui ka katastriüksus. Katastriüksuse puhul kontrollitakse kõiki temaga seotud hooneid. Viga tekib katastriüksusele ka sel juhul, kui konflikt esineb seotud hoonega, mis pole menetluses. Hoone ja KÜ seose arvestamise ärireeglid on kirjeldatud pt Hoone osa aadress ei ole vastavuses hoone aadressiga Hoone osa aadressi esimesed 7 taset peavad täpselt võrduma ühega seotud hoone paralleelaadressidest. Viga tekib, kui see nii ei ole. 140 Objekti aadressis ei ole 8. tase lubatud Viga tekib, kui CU, EE või ME objektidel esineb 8. taset sisaldav aadress. 142 Hoone osa aadressis ei tohi esineda erinevad hoone paralleelaadressid See viga tekib, kui hooneosal on 2 või enam aadressi ja neil aadressidel tasemed 1-7 ei ole võrdsed 143 Objektil peab esinema väikekoha aadress [väikekoha nimi] Kui enam kui 1% objekti pindalast kattub väikekoha pinnaga, siis peab väikekoht olema ühes objekti aadressis mainitud. Objektil võivad olla paralleelaadressid, mis ei sisalda väikekoha nime. 144 Objektil ei või esineda väikekoha aadressi [väikekoha nimi]. Kui objekt asub vähem kui 1% ulatuses selles väikekohas. 145 Objektil ei tohiks esineda liikluspinna aadress [liikluspinna nimi] Kontrollitakse ainult siis, kui objekti aadress sisaldab 5. taset. Objektile ehitatakse puhver ulatusega x meetrit (häälestatav parameetritest, juunis 2013 on see 100m). Hoone puhul leitakse seotud katastriüksused ja tehakse puhver ka neile. Kui puhvri alasse ei jää selle liikluspinna kuju, mille järgi aadress on määratud, siis objektil ei tohiks leiduda aadress selle liikluspinna järgi. Hoone ja KÜ seose arvestamise ärireeglid on kirjeldatud pt Objektil ei või esineda liikluspinna aadress [liikluspinna nimi] Sama kontroll nagu eelmises punktis ainult teise puhvri ulatusega y meetrit (häälestatav parameetritest, juuni s2013 on see 999m) Hoone ja KÜ seose arvestamise ärireeglid on kirjeldatud pt Hoone osa aadress peab lõppema osa tähisega See viga tekib, kui hooneosal on 1 aadress ja selle 8. taseme komponendi nimi ei ühti osa tähisega. 158 Hooneosade tähiste numbrivahemikud on liiga suured. Viga antakse neile hoonetele, millega seotud hooneosade aadressi korterinumbrites esineb suuremaid numbrivahemikke kui Nimi kattub asustusüksuse nimega Probleem tekib aadressile, kus 6. tasemel esineb 3.taseme komponendi nimetuum ilma mingite lisanditeta või kus 6. taseme nimi algab 3. taseme komponendi nimega koos liigisõnaga. 168 Tiheasustuses peab hoonetel ja hoonestatud üksustel olema 4+7 või 5+7 aadress. Tiheasustuses paiknemise reegel: kui objektil on ruumikuju ja ta paikneb vähemalt 50% ulatuses UNalal, siis loetakse paiknemine tiheasustuseks AS Datel /226

92 kui objektil ei ole ruumikuju, siis kontrollitakse liigisõnade linn, linnaosa, alev, alevik sisaldumist aadressi 3. tasemel, selle taseme puudumisel 2. tasemel. Liigisõnade olemasolul loetakse paiknemine tiheasustuseks. Üksuse hoonestatuks lugemise ehk hoone ja KÜ seose arvestamise ärireeglid on kirjeldatud pt Hoonel on paralleelaadressid ebasoovitavad Menetluses mitteosaleva hooneosa aadress ei ole hoonega kooskõlas 1 [1] 179 Kui maaüksusel on paralleelaadress, siis tuleb hoone adresseerida tänava järgse aadressiga Aadressikoha järgseks aadressiks loetakse selline aadress, mis sisaldab kas 4+7 või 5+7 või tasemetega aadressi. Veateade lisandub ainult hoonetele järgmise reegli alusel: kui hoonel ei leidu aadressikoha järgset aadressi, aga leidub 6. tasemega aadress, siis tuleb kontrollida temaga otseselt seotud katastriüksuste aadresse. Kui kasvõi ühel otseselt seotud üksusel leidub aadressikoha järgne aadress, siis lisandub hoonele uus veateade. Hoone ja KÜ seose arvestamise ärireeglid on kirjeldatud pt Komponentidega seotud probleemid Vea kood Komponentide korrektsuse kontrolli reeglid on täpsemalt kirjeldatud peatükis Menetluse sees kontrollitakse järgmisi reegleid. Vea kirjeldus 104 Komponendi nimes on liigsed tühikud Nimetuses suurtäht vales kohas Nimetus ei alga suurtähega Nimetuses esineb üksik täht Komponendis sisaldub ebakorrektseid sümboleid Nimetuses sidekriipsu vale kasutamine Komponendis sisaldub ebasobivaid tähti Nimetusel on ebasobiv algustäht Nimetuses ebakorrektne sõna Komponendis sisaldub ebakorrektne number 1 6., 7. ja 8. tasemel ei või esineda üksik number 0 ja arv ei või alata numbriga ja 8. taseme komponentide puhul süsteem analüüsib, kas komponendi nimetuses sisaldub täht. Täheks loetakse sellist sümbolit, millel esineb suur ja väike esitluskuju. Kui tähele järgneb number, siis lisandub komponendile viga 113. Näiteks komponendid 5a2, S8, 111BMW6 saavad selle vea 113. Kui muule sümbolile järgneb number, siis viga 113 ei lisandu. Näiteks komponendid 7-1, 8/2, 5a 2, 5a.2 ei saa külge veateadet 113. Nad võivad saada mingi muu vea. Teiseks kontrollib süsteem, et kui komponendi nimetuse viimane sümbol on kaldjoon /, siis samuti lisandub veateade 113. Näiteks komponendid: 5a/ ja 16/ saavad selle vea 113. Kui kaldjoon ei ole viimane sümbol nimetuses, siis viga 113 ei lisandu. Näiteks komponendid 5a/ ja 16/. ei saa külge veateadet 113. Nad võivad saada mingi muu vea. 6. taseme komponentide puhul veateate 113 reeglistik ei muutu. 114 Komponent ei tohi sisaldada suurtähti Komponendi nimes on mitu tähte järjest Komponendi nimes on tähed ebasoovitavad 1 Tühistami se tase Nõutav menetluses AS Datel /226

93 117 Komponendi nimetuse osa peab algama numbriga Alamkomponentide numbrivahemikud on liiga suured Kontrollitakse ainult 8. tasandi numbrivahemikke hoone osadel. Probleem tekib hoonele ETAK süsteemiga ühildumise probleemid Vea kood Need probleemid ei takista menetluse jõustamist. Jõustamise hetkel tehakse need kontrollid ja lisatakse objektile probleemid. Probleemide alusel saavad ETAK registri haldajad teavet vastuolus olevate objektide kohta. ADS registris ETAK seoseid käsitsi muuta ei saa. Kõik seostamised tehakse ETAK poolel ning muudatussündmuste peale kontrollitakse ADS objekte uuesti. Vea kirjeldus 131 ETAK_ID ei ole vastavuses ADS_OIDiga 0 See probleem tekib objektile, mille identifikaatorid ei ole vastavuses ETAK süsteemiga 132 ETAK objektitüüp ei ole vastavuses ADS objektiliigiga Objekti kuju ETAK süsteemis erineb ADS kujust lubatust suuremal 2 määral 130 ETAK-ID väärtusega objekt puudub ETAK süsteemist ETAK andmetel hoonet looduses ei eksisteeri 1 Tühistami se tase Nõutav menetluses Ainult menetluse sees kontrollitavad probleemid Vea kood Neid probleeme ei kontrollita põhiregistrisse salvestatud objektidel. Kontrollitakse ainult menetluse sees. Vea kirjeldus 135 Objekti kuju kattub samaliigilise objekti kujuga menetlussüsteemis: 1 [menetluse numbrite loetelu] Kontrolli reeglid on samad, kui põhisüsteemi objektidega võrdlemisel. Võrdlemisel kasutatakse objekte jõustamata menetlustes. Ootel objektid arvutamisel ei osale. 136 Sissepääsu punkt ei ühti hoone kujuga. 1 Kontroll toimub ainult objektiliikide ER ja MR korral. Nende objektide punkt peab asuma seotud hoone pinnal. Kui hoone kuju on väljendatud punktina, siis peab hoone osa punkt olema sellega võrdne. 149 Objekt ei asu organisatsiooni tööpiirkonnas 151 Objekti aadress ei ole organisatsiooni tööpiirkonnaga kooskõlas 154 EHR-st pärit objekti aadresse ei saa ADS-i kaudu muuta 155 Objekti aadress sisaldab 6. taseme komponenti, vajab ADS haldaja kontrolli 156 EHR-st pärit objekti kuju tohib muuta ainult kaardistatuks ehk asendada ETAK kujuga 157 ETAK id [1] esineb enam kui ühel erineval ADS objektil taseme komponendis sisalduvad 4. või 5. taseme komponendi tunnused 161 Menetluses on tühistatud ETAK objekt Kui menetluses tühistatakse ilma EHR-koodita ja ainult ETAK seosega objekt ja vastav ETAK objekt on jätkuvalt kehtiv. 162 Objekti on pärast menetlusse võtmist põhisüsteemis muudetud. 2 Tühistami se tase Nõutav menetluses AS Datel /226

94 See viga tekib menetluse sees kui objekti menetlusse võtmise ja menetluse jõustamise vahel on põhisüsteemis objekti andmed muutunud. 165 Aadress (5+7) esineb esmakordselt ja vajab ADS haldaja kontrolli Kui süsteem tuvastab, et objektile on lisatud aadress, milles esineb uus 7. tasandi komponent 5. tasandi alluvuses (uus 5+7 tasemetega aadress), siis ei lisa süsteem mitte kohe probleemi 165, vaid analüüsib veel enne, kas 7. tasandi komponent sisaldab kaldjoont / ehk teisisõnu komponent omab erilisandit. Kui ei sisalda, siis lisab probleemi ära. Kui sisaldab, siis analüüsib edasi. Kui järgneb enam kui 1 sümbol või ei järgne midagi, siis lisab probleemi ära (erilisand sisuliselt puudub või on liiga pikk). Kui kaldjoonele järgneb 1 sümbol (normaalne erilisand), siis analüüsib edasi. Süsteem võtab kaldjoonele eelneva osa (põhiosa) ja kontrollib, kas põhisüsteemis leidub sama ülema alluvuses sellise nimega komponent. Kui jah leidub, siis probleemi ei lisa. Kui ei leidu, siis lisab probleemi. Reeglist tulenevalt lisandub probleem ka sel juhul, kui põhiosa komponent on just lisatud samas menetluses. 173 Lisatav objekt päritoluregistri tunnusega [1] on ADS süsteemis juba 0 registreeritud Kontroll takistab EHRst pärit objektide topelt rgistreerimist 177 Objektil on seosed teistes registrites ([1]), tühistamine pole lubatud. 1 See viga antakse hooneosale, mis on menetluses märgitud tühistatuks, kuid mis eksisteerib põhisüsteemis kehtivana sõltumata sellest, kas hoone on menetluses kehtiv või kehtetu. 180 Ainus hooneosa hoones vajab haldaja kontrolli Juhul, kui hooneosal oli või on pärast muutmist mitu erineva 8. taseme 1 tekstiga aadressi, siis antakse viga sel juhul, kui kasvõi ühe uue aadressi 8. taseme komponendi nimi ei sisaldunud vanade aadresside hulgas. 183 See veateade lisandub menetluses olevale hooneosale juhul, kui 1 hooneosa aadressi 8. taseme komponendi nimi sisaldab kaldjoont, kaldjoonele järgneb number ja selle numbri väärtus on suurem kui 2. Kui kaldjoonele järgnev tekst ei teisendu numbriks, siis veateadet hooneosale ei lisandu 184 Tühistatud hooneosa on EHR päritoluga - palun lisa selgitusse 1 tühistamise põhjus See veateade lisandub menetluses tühistatud hooneosale juhul, kui tal on olemas ka päritoluregistri tunnus (EHR kood) ja menetluse algatamine ei ole toimunud X-tee vahendusel (algataja liik ei ole X-tee) ja kui põhisüsteemis eksisteerib seesama hooneosa kehtivana ja hoone menetluses kehtib See veateade lisatakse kõigile objektidele menetluses, mille menetleja kood ühtib MKM organisatsiooni registrikoodiga Seotud objektide leidmise reeglid Mitmed andmekontrollid menetluses (näiteks 88, 168, 179, 145, 146) eeldavad teadmist seotud objektide kohta. Seotud objektid leitakse menetluse sees järgmiselt. Hoone puhul Kui hoonel on kuju või on kuju lisatud antud menetluses, siis leitakse seotud KÜ-d hoone ruumikuju alusel. Leitud seoste prioriteet on 1. Antud hoonel olevaid prioriteet 2 seoseid ei arvestata. AS Datel /226

95 Kui hoone kuju asub reformimata riigimaal või on kuju reformimata riigimaale lisatud antud menetluses, siis selle tulemusena ei teki prioriteet 1 seost. Antud hoonel olevaid prioriteet 2 seoseid ei arvestata, st sel juhul hoonele seoseid ei teki. Juhul, kui hoonel puudub kuju, siis arvestatakse prioriteet 2 seoseid. Prioriteet 1 seosed puuduvad. Katastriüksuste puhul KÜ-l on alati kuju ja selle alusel leitakse prioriteet 1 seosega hooned ruumianalüüsiga. KÜ puhul arvestatakse prioriteet 2 seost hoonega ainult juhul, kui hoone ei ole menetluses või kui hoone on menetluses ilma kujuta. Mõlema prioriteediga seoseid arvestatakse andmekontrollides tavaliselt võrdselt. On võimalik ka prioriteedi alusel neid eristada. Seose tuvastamine ruumianalüüsiga 1. Leitakse hoone ja KÜ ühisosa Kui hoone ja KÜ ühisosa pindala suhe hoone pindalasse on vähem kui 10%, siis seost ei arvestata Kui hoone ja KÜ ühisosa pindala suhe hoone pindalasse on %, siis vaadatakse ühisosa pindala absoluutväärtust Kui see on vähem kui 16 m 2, siis loetakse seose prioriteediks Kui see on 16 m 2 või rohkem, siis loetakse seose prioriteediks Kui hoone ja KÜ ühisosa pindala suhe hoone pindalasse on rohkem kui 40%, siis seos arvestatakse prioriteediga 1. Kui pärast ruumianalüüsi lõppu tekkis objektile nii prioriteet 1 kui ka 2 seoseid, siis prioriteet 2 seosed kustutatakse (ei arvestata). Kui prioriteet 1 seoseid ei tekkinud, aga prioriteet 2 seoseid tekkis, siis muudetakse suurima osakaaluga seose prioriteet 1-ks, ülejäänud kustutatakse (ei arvestata) Probleemide lahendamine menetluses Menetluse kontrollimisel tuvastatud probleemid on eelkõige mõeldud menetleja informeerimiseks, et ta andmed ADS nõuetega vastavusse viiks. Sellegipoolest võib mõnikord olla objektiivseid põhjusi, miks kõiki nõudeid kohe rahuldada pole võimalik. Selliste olukordade ületamiseks on võimalik probleeme menetluse sees mitteaktuaalseks märkida. Probleemide klassifikaatoris on võimalik häälestada, kas ja kes saavad antud probleemi mitteaktuaalseks märkida. Seda näitab probleemi tühistamise tase. Probleemide administreerimine toimub menetlussüsteemi kasutajaliidese kaudu erimenetleja õigusega kasutajate poolt. Tühistamise tase: 0 probleemi ei saa mitteaktuaalseks märkida 1 probleemi saab mitteaktuaalseks märkida ainult haldaja 2 - probleemi saab mitteaktuaalseks märkida tavamenetleja AS Datel /226

96 Teatud probleeme ei ole üldse võimalik mitteaktuaalseks märkida. Näiteks: objektil puudub ruumikuju. Kuju tuleb kindlasti lisada, kasvõi punktina kaardil osutades. Kasutaja peab objektile kuju lisama ja uuesti kontrollimisel seda probleemi enam ei leita. Teatud probleeme saab mitteaktuaalseks märkida tavamenetleja (KOV ametnik). Näiteks 2 samaliigilise objekti ruumikujud on ülekattes. Ülekate võib tekkida ebatäpse mõõdistuse korral või mõõdistatud ja kaardistatud andmete kokkupuutel. Sel juhul peab KOV ametnik sisestama põhjenduse, miks selline olukord on antud juhul lubatud ja märgistama probleemi mitteaktuaalseks. Järgmisel kontrollimisel ignoreerib süsteem seda probleemi, kuid probleem hoitakse süsteemis koos selgitusega alles. Teatud probleeme saab mitteaktuaalseks märkida vaid ADS haldaja õigustega kasutaja. Näiteks pühendusnimedest tingitud eripärad või võõrtähed kohanimes vms. Sellisel juhul, kui tavamenetleja on veendunud, et selliste probleemidega aadress on ikkagi tarvis ADS süsteemi sisse kanda, siis jõustab tavamenetleja (KOV ametnik) omalt poolt menetluse. Süsteemis jõustub see menetlus aga alles sel hetkel, kui erimenetleja on viimase aktuaalse probleemi objekti juures mitteaktuaalseks märkinud. Jõustumise ajaks loetakse viimase probleemi mitteaktuaalseks muutmise aeg, jõustajaks aga tavamenetleja rollis KOV ametnik. Tühistamise tase on muudetav menetlusrakenduse kasutajaliidese kaudu ning seetõttu on käesolevas dokumendis olevas veateadete tabelis märgitud tühistamise tase vaid informatiivse iseloomuga Veateadete ajutine mitteaktuaalseks märkimine Menetluse sees tuvastatud probleemidel on 3 olekut: aktuaalne mitteaktuaalne menetluses mitteaktuaalne Aktuaalsed vead tuleb parandada menetluse sees. Mitteaktuaalseks märkimise korral liigub vastav tunnus koos veateatega põhisüsteemi, juhul kui on tegemist ka põhisüsteemis kontrollitava probleemiga. Menetluses mitteaktuaalseks märgitud viga jõuab põhisüsteemi aktuaalsena, st mitteaktuaalsus kehtib ainult selles konkreetses menetluses Menetluse andmete kontroll 1. Menetluse objektide kontrollimisel leiab süsteem kõik probleemid, mis objektidega seotud. Kui mõni neist on leitud juba varasemal kontrollimisel ja kasutaja poolt märgitud mitteaktuaalseks, siis süsteem säilitab mitteaktuaalsuse tunnuse. Kõik need probleemid, mis objektil enam ei esine, kustutab süsteem menetluse sees lõplikult Kui objektil on põhisüsteemis sama probleem ja sellel probleemil esineb selgitus, siis kopeerib süsteem selgituse menetluses leitud probleemi juurde Kui sama probleem on põhisüsteemis märgitud mitteaktuaalseks, siis menetluses ta automaatselt mitteaktuaalseks ei muutu. AS Datel /226

97 2. Kõik probleemid kuvatakse menetluse vormil tabelina, kus iga rea juures on nupp detailandmete avamiseks. Tabelis on koos kõigi objektide probleemid. 3. Kui kasutaja leiab, et mõnda probleemi ei peaks objekti juures arvestama ja tal on õigus seda muuta, siis avab kasutaja probleemi detailandmete vormi, märgib probleemi mitteaktuaalseks ja lisab selgituse, miks ta nii arvab. Seejärel salvestab. Saab lisada ka ainult selgituse sõltumata sellest kas tal on õigus muuta probleemi mitteaktuaalseks. Probleemi juurde salvestub selle muutja nimi ja muutmise aeg Alternatiivne variant. Kasutaja saab menetluse vormil avada ka konkreetse objekti detailandmete vormi. Sellel kuvatakse ainult vaadeldava objekti probleemid. Lahendamine toimub samal viisil. Kui menetlusse on võetud objekt, millel on põhisüsteemis mitteaktuaalseks märgitud probleem ja see probleem on menetluse jõustamist mittetakistav, siis jääb ta menetluse sees tavaliselt aktuaalseks, sest kasutaja ei pööra tähelepanu jõustamist mittetakistavatele vigadele. Kui nüüd menetlus jõustatakse, siis peab taoline viga säilitama oma mitteaktuaalse oleku põhisüsteemis ja ka märkuse. Kui menetluse sees on viga samuti mitteaktuaalseks märgitud ja märkust on muudetud, siis jõustub menetluse sees omistatud märkus. 4.6 Menetluse jõustamine Menetluse jõustamine toimub alati kasutaja initsiatiivil, ka siis kui see on automaatselt loodud. X-tee kaudu menetluse loomisele järgneb samuti jõustamise katse. Ka seda loetakse kasutaja initsiatiiviks, sest menetluse loonud reaalne füüsiline isik on ka X- tee kaudu esitamisel alati teada. Menetluse jõustamisel teeb süsteem alati menetluse objektide kontrolli, kuigi seda kontrolli on võimalik ka eraldi välja kutsuda. Menetluse jõustamine õnnestub, kui ei leitud mitte ühtegi sellist aktuaalset probleemi, mida vastav menetlusliik jõustamisel oluliseks peab. Kontrollimisel leitakse alati kõik probleemid, aga sõltuvalt menetlusliigist ei pea olema kõik lahendatud. Mõni menetlusliik on loodud teatud tüüpi probleemide kiireks lahendamiseks ja seetõttu saab jõustada menetluse, mil leidub muid, menetlusliigi poolt mittenõutavaid aktuaalseid probleeme. Kasutajaliideses on probleemide loendis haldajal võimalik lisada menetlusliikidele teave, millised probleemid on seda liiki menetlust takistavad. Menetluse jõustamisel eristab süsteem kujunduse abil kasutajale need probleemid, mis takistavad selle konkreetse menetluse jõustamist kõigist ülejäänud probleemidest. Menetluses leitud aktuaalsed, kuid jõustamist mittetakistavad ning samuti ka mitteaktuaalseks märgitud probleemid kirjutatakse menetluse jõustamisel põhisüsteemi ümber (juhul kui antud veateade esineb ka põhisüsteemis). Kui põhisüsteemis on sama probleem mitteaktuaalsena, siis menetlusest põhisüsteemi ümberkirjutamisel säilitab süsteem selle probleemi mitteaktuaalsuse tunnuse ja AS Datel /226

98 uuendab märkuse teksti menetluses lisatuga, välja arvatud juhul kui probleem oli jõustamist mittetakistav ja märkust menetluses ei lisatud. Menetluse esitamisel/jõustamisel kontrollitakse, kas käimas on avalikustamine (e. laadimine avalike teenuste serverisse). Kui on, siis menetluse esitamine/jõustamine ei õnnestu. Kontroll on vajalik, kuna avalikustamise ajal andmete muutmise tagajärjeks on see, et teenuste tarbijad saavad vale info (e. ADS poolne andmete ebakonsistentsus). Üldjuhul toimub avalikustamine õhtul kell ja sel ajal võib esineda ca 15 minutilisi katkestusi ADS-i andmete esitamisel/jõustamisel Menetluste saatmine ülevaatuseks KOV menetlejatel on võimalik suunata menetlusi ADS haldajatele ülevaatamiseks. See on mõeldud erinevate veasituatsioonide lahendamise jaoks. KOV kasutaja vajutab nuppu Saada ülevaatamiseks. Süsteem kontrollib kõigepealt menetlust. Kontrolli tulemused salvestuvad menetluse juurde samamoodi nagu nupu Kontrolli menetlus vajutamisel. Kasutaja jaoks värskendub ekraanipilt, nii et kasutaja näeb kohe uut vigade seisu. Kui pärast kontrollimist leidub menetlusel jõustamist takistavaid vigu, siis suunatakse menetlus kohe ka haldaja töölauale. KOV kasutaja käest lisakinnitust ei küsita. Kui pärast kontrollimist menetlusel jõustamist takistavaid vigu ei leidu, siis küsib süsteem kasutajalt kinnitust nõudva küsimuse: Menetluse jõustamist takistavad vead puuduvad. Kas oled kindel, et soovid saata menetluse haldajale ülevaatamiseks?. Nupud Jah / Ei. Kui kasutaja vastab jaatavalt, siis menetlus suunatakse haldajale, kui ei, siis mitte. Menetluse jõustamine tuleb kasutajal siiski täiendavalt käivitada Jõustamine kasutajaliidesest 1. Menetluse jõustamiseks vajutab kasutaja menetluse vormil vastavat nuppu Jõusta menetlus. 2. Süsteem teeb kontrollid nagu menetluse kontrollimise ajal. 3. Süsteem uurib, kas leidub selliseid aktuaalseid probleeme, mida vastav menetlusliik läbi ei lase Kui ei leidu, siis toimub jõustamine 3.2. Kui leidub, siis tuvastab süsteem kas kasutajal on õigus neid probleeme mitteaktuaalseks teha Kui leidub kindlaid probleeme, siis on jõustamine ebaõnnestunud Kui leidub probleeme, mida saab vajadusel ka mitteaktuaalseks märkida ja kasutajal on õigus seda teha, siis on jõustamine ebaõnnestunud Kui leidub probleeme, mida saab vajadusel ka mitteaktuaalseks märkida, aga selleks peab omama erimenetleja rolli, mida kasutajal ei ole (näiteks mõningad komponendi õigekirja probleemid), siis märgib süsteem menetlusele jõustamisvalmiduse, aga jõustamist otseselt ei tee. Jõustamisvalmidus tähendab, et menetlusse salvestub jõustaja nimi, kuid mitte jõustamise aeg. Süsteem ootab erimenetleja poolset probleemide lahendamist. Kuni seda pole, siis menetlus tegelikult ei ole jõustunud Kui probleeme ei leidu, siis salvestub menetluse andmetesse jõustaja nimi ja jõustamise aeg ning toimub jõustamine AS Datel /226

99 4. Jõustamisel kirjutatakse menetluses olevad objektid põhisüsteemi. Objektide muutmise korral tekivad põhisüsteemis uued versioonid. Tühistamise korral muudetakse objekt põhisüsteemis kehtetuks Jõustamisvalmidusega menetlused jõustuvad sel hetkel, kui muudetakse mitteaktuaalseks viimane jõustamist takistav probleem. Sel hetkel lisandub menetlusele jõustamise aeg ja toimub jõustamise tegevus. Menetluse jõustajaks loetakse jätkuvalt see kasutaja, kes jõustamise otsuse tegi, mitte see, kes viimase probleemi tühistas Jõustamine X-tee kaudu X-tee teenuse kaudu loodud menetlused jäävad süsteemi alles, kui nende loomine lõpuni õnnestus. Loomisele järgneb kontroll ja jõustamine täpselt samal moel nagu eespool kirjeldatud. Jõustamine võib lõppeda kolmel viisil: õnnestumine mitte ühtegi takistavat probleemi ei olnud jõustamisvalmidus leidub probleeme, mida tavamenetleja tühistada ei saa. X- tee kaudu esitaja õigused loetakse võrdseks tavamenetleja õigustega. ebaõnnestumine leidub jõustamist takistavaid probleeme. Teenus tagastab loetelu nendest probleemidest. 4.7 Aadressi muudatusvajaduste tuvastamine EHAK, VK ja LP muudatustest tingitud aadresside tühistamised toovad kaasa vajaduse asendada aadress seotud objektidel. Seda püüab ADS süsteem teha automaatselt. Automaatsed aadressimuudatused töödeldakse ADS-s 2 etapiliselt. Esimene etapp. Automaatse järeltegevuste protsessi raames (mis käivitub vastavalt häälestusele, aga praegu 1 kord ööpäevas öösiti) tuvastatakse objektid ja aadressid, millel esinevad järgmist liiki probleemid: veateade nr 81, aadress on vananenud veateade nr 82, aadress on tühistatud veateade nr 88, hoonete puhul, ehitise aadress ei sobi katastriüksusega veateade nr 104, komponendi nimes on liigsed tühikud. veateade nr 80, aadress ei lange kokku objekti ruumiaadressiga. Süsteem püüab leida probleemsetele aadressidele asenduse ning logib nii muutmisvajadusega aadressi kui ka asenduse. Kasutajaliidese kaudu saab selle logitabeliga tutvuda. Saab uuesti käivitada asendavate aadresside leidmise protsessi. Teine etapp. Kasutajaliidese kaudu saab inimene - haldusõigusi omav Maa-ameti töötaja - käivitada automaatsete menetluste loomise protsessi. Protsess töötab asünkroonselt, kuid käivitus toimub kasutajaliidesest. Protsess võtab töötlust vajavad objektid, paigutab nad menetlustesse, muudab nende aadressid vastavalt ärireeglitele, ei jõusta. Menetluste loomise loogika on spetsifikatsioonis kirjeldatud Asendava aadressi leidmine Asendavat aadressi pakub aadressivigade protsess välja järgmistel juhtudel: AS Datel /226

100 Kui objekti aadress ei sobi põhjusel, et aadressi versioon on vananenud (sisaldab kehtetuid komponendi versioone), siis pakub süsteem objektile sama aadressi kehtiva versiooni. Logikirjes on määratud vana aadress ja uus aadress. Kui objekti aadress ei sobi põhjusel, et ta on tühistatud, siis leitakse uued tõenäolised aadressid järglaste hulgast. Peab arvestama, et tühistatud aadressile võidakse leida mitu tõenäolist järglast. Logikirjetes ilmub asendav aadress vaid sel juhul, kui süsteem suudab seda üheselt määrata. Kui hoone aadress ei sobi põhjusel, et ta erineb lubamatult katastriüksuse aadressist, siis pakutakse asenduseks katastriüksuse aadressi. Asendusel arvestatakse hoone võimaliku unikaalse tunnusega 7. tasemel kaldjoone järel. Asendust ei pakuta, kui katastriüksusel esinevad paralleelaadressid. Kui aadressi 6. taseme komponendis esinevad lubamatud tühikud, siis eemaldatakse need asendavas aadressis. Kui aadress ei lange kokku objekti ruumiaadressiga, siis leitakse asendav aadress suurima osakaaluga ruumiaadressi alusel. 4.8 Volitused ADS menetlusrakenduses saab hallata volitusi. Volitajaks on alati KOV organisatsioon (aadressimääraja) ja volitatavaks organisatsiooniks on alati Maa-amet (ADS volitatud töötleja). Volitused sisestatakse ADS menetlusrakenduse kaudu. Volitusi saavad sisestada: tavamenetlejad ainult oma organisatsiooni kohta, erimenetleja (ehk haldaja) mistahes organisatsiooni kohta. Volitused saavad olla kas täielikud või tingimuslikud. Volituse täielikkus on tinglik, KOV saab Maa-ametit volitada üksnes Ruumiandmete seaduses ettenähtud tegevuste piires. Nn. täieliku volituse korral ei saa Maa-amet teha mitte kõiki tegevusi vaid ikkagi piiratult vastavalt ruumiandmete seaduse regulatsioonile. Täielik volitus tähendab, et Maa-ametil on õigus selle KOV-i tööpiirkonnas teha kõiki tegevusi mida lubab Ruumiandmete seadus. Kui seadusest tulenevaid tegevusi omakorda on KOV-i volikirjas piiratud, siis on tegu piiratud volitusega. Volitus võib olla tähtajaline. Volitusi võib ühel organisatsioonil olla mitu. Täieliku volituse korral saab Maa-amet soovi korral teha kõiki aadressi muutmisega seotud toiminguid KOV-i eest. Reaalselt teeb Maa-amet siiski ainult neid toiminguid mida lubab teha Ruumiandmete seadus. Tingimusliku volituse korral saab ainult täpsustatud tegevusi teha. Süsteem kontrollib objekti Maa-ameti teatud liiki menetlusse võtmisel, et kas volitus on olemas. Kui ei ole, siis ei saa selle organisatsiooni tööpiirkonna objekti menetlusse võtta. Kui on täielik volitus, siis saab võtta. Kui tingimuslik volitus, siis saab ka võtta, aga kasutaja saab menetlusse võtmisel hoiatuse, et volitus on tingimuslik ja kontrolligu tingimusi. Osa menetlusliikide korral volitust ei kontrollita. Näiteks tühistatud aadresside automaatsel asendamisel teeb menetluse süsteem ning seal pole võimalik hoiatust kuvada. Seetõttu muudab süsteem automaatselt ka tingimusliku volitusega KOVide aadressid. AS Datel /226

101 4.8.1 Volituse sisestamine Volituse sisestamisel kasutatakse järgmist sõnastust. Volitaja: <KOV organisatsiooni nimi> ADS infosüsteemi vastutav töötleja : Maa-amet Volitan ADS infosüsteemi vastutavat töötlejat muutma volitaja organisatsiooni tööpiirkonnas olevaid koha-aadresse järgmistel juhtudel: kui koha-aadressi muutmise kohustus tuleneb õigusaktist, sealhulgas muutub haldus- või asustusjaotus või muutuvad koha-aadressis kasutusel olevad kohanimed kui kehtestatud koha-aadress ei ole vastavuses õigusaktides sätestatud nõuetega. Volitus kehtib ainult järgmistel tingimustel: tingimuste kirjeldus. Täieliku volituse korral, mida süsteem pakub vaikimisi, on mõlemad märkeruudud tähistatud ja lisatingimusi sisestatud ei ole. Tingimusliku volituse korral on üks või teine märkeruut tähistamata või on sisestatud lisatingimusi. Volituste juurde saab soovi korral üles laadida ka dokumenti. 5. Teenused Kõik teenused loovad connectioni Oracle andmebaasi ADS skeemi. Kõik teenused peaksid kontrollima sisendparameetrite vastavust andmetüübi ja pikkuse osas, samuti kohustuslikke elemente, st sisendiks oleva xml-i vastavust xsd-le. Vigade esinemisel peaksid teenused tagastama väljakutsujale kohe korrektse veateate ja baasi poole mitte pöörduma. Kohustuslikel elementidel on andmetüüp sisendi kirjeldustabelis punast värvi. X-tee teenuste shemad on kättesaadavad: Maa-ameti X-tee teenustes kasutatavad klassifikaatorid on kättesaadavad: Kõigi teenuste täitmisel väljastatakse esimesed 100 vastust, järgmiste vastuste saamiseks tuleb päringut korrata täiendades sisendit nt viimasena saadud loginumbriga, st loginumber toimib järjehoidjana Erinevates teenustes võib järjehoidja rollis olla erinev infoväli. X-tee kaudu ei ole soovitav teha masspäringuid. Suurema koguse andmete laadimiseks on loodud ADS avalikku rakendusse väljavõtete leht. Vt: Aadressikomponentide kehtiva seisu päring Teenuse vana versioon: ADSkomponendid.v1 Teenuse viimane versioon ADSkomponendid.v2 Teenuse vahendusel saavad teised süsteemid pärida kehtivate aadressikomponentide klassifikaatori seisu. Teenus on vajalik nendele aadresside töötlejatele, kelle andmekogu vajab kehtivat aadressikomponentide klassifikaatorit kindlate funktsionaalsete nõuete täitmiseks. AS Datel /226

102 Teenus on mõeldud eelkõige klassifikaatori kehtiva seisu osaliseks laadimiseks välistesse süsteemidesse. Täielikuks laadimiseks on soovitav laadida andmed ADS avalikku rakendusse väljavõtete lehelt. Vt: Lehelt on kättesaadav ka komponentide kehtiva seisu väljavõte. Väljavõtte tootmise järgsed muudatused on soovitav laadida liidestuvasse süsteemi komponentide muudatuste teenusega. Teenus sobib kasutamiseks ka siis, kui väline süsteem ei salvesta klassifikaatorit enda keskkonnas, vaid soovib saada määratud ülem-komponendi kõiki alluvaid aadressi normaliseeritud kujul esitamiseks Sisend nimi andmetüüp kirjeldus ylemtase number (min 1 max 8) Aadressikomponendi tase, millega seotud ja millest täpsemaid komponente päritakse ylemkood string (4) Aadressikomponendi kood, millega seotud ja millest täpsemaid komponente päritakse mintase integer (min 1 max 8) maxtase integer (min 1 max 8) Tagastuse juhtimine Päringu tulemusena väljastatavate komponentide miinimum tase järjestatuna üldisemast täpsema suunas Päringu tulemusena väljastatavate komponentide maksimum tase järjestatuna üldisemast täpsema suunas alateskirjest integer Mitmendast päringuga leitud komponendist alates tagastatakse vastuste hulk Vaikimisi 1 maxarv integer Maksimaalne tagastavate kirjete arv. Vaikimisi süsteemi poolt kehtestatud limiit. initobjektid boolean True Tagasta komponenti initsialiseerivad ADS-OID'id False ei tagasta loetelu Vaikimisi false kompsynonyymid boolean True tagastab komponenti sünonüümid False ei tagasta sünonüüme Vaikimisi false kompeellased boolean True tagastab komponenti eellased False ei tagasta komponentide järgnevuse infot Vaikimisi false Ükski sisendparameeter ei ole kohustuslik. Kui sisend puudub, siis peaks teoreetiliselt väljastatama kogu klassifikaator 100 kirje kaupa (sellise vajaduse korral on soovitav kasutada väljavõtteid) Väljund nimi andmetüüp kirjeldus tase number Aadressikomponendi tase kood string Aadressikomponendi kood nimetus string Aadressikomponendi nimi ilma liigisõnata nimiliigiga string Aadressikomponendi nimi koos liigisõnaga ylemtase number Aadressikomponendi ülem-komponendi tase AS Datel /226

103 nimi andmetüüp kirjeldus ylemkood string Aadressikomponendi ülem-komponendi kood tehniline boolean Tõene, kui on tegemist tehnilise komponendiga. Tehnilised on sellised 6. taseme komponendid, millega seotud katastriüksused ei ole kohanimekohustusega ads_oid string Initsialiseerivate objektide ADS_OID väärtused. Loetelu elemendid eraldatud semikoolonitega synonoyymid string Komponendi sünonüümid, mis ei lange kokku komponendi ametlike nimekujudega. Loetelu eraldatud semikoolonitega. eellased string Komponendi võimalikeks eellasteks olevate sama taseme tühistatud komponentide loetelu. Loetelu eraldatud semikoolonitega Funktsionaalsus Sisendis antud tingimustele vastavad komponendid tagastatakse taseme ja koodi järjekorras Tehniline täitmine Päring tehakse vaatest XT_ADKOMP_KEHTIV Where-tingimusse lisatakse kasutaja poolt esitatud parameetrid: AND ylemkomp_tase=[ YlemkomponendiTase] AND ylemkomp_kood=[ YlemkomponendiKood] AND tase >= [MinTase] AND tase <= [MaxTase] Tulemust loetakse lisatingimusega pärast order by-d WHERE rownum< [AlatesKirjest + MaxArv] Vaikimisi päring SELECT tase, kood, nimetus, nimetus_liigiga, ylemkomp_tase, ylemkomp_kood, tehniline FROM xt_adkomp_kehtiv ORDER BY tase, kood. Kui tehniline=1, siis Tehniline = true. Kui tehniline=null, siis Tehniline = false. Kui sooviti ka InitObjekte, siis lisada päringu select-osasse INIT_OBJEKT. Kui sooviti ka sünonüüme, siis lisada päringu select-osasse SYNONYYMID. Kui sooviti ka järglaste infot, siis lisada päringu select-osasse EELLASED. 5.2 Aadressikomponentide klassifikaatori muudatuste päring Teenuse vana versioon ADSkompklassif.v1 Teenuse viimane versioon ADSkompklassif.v2 Selle teenuse vahendusel saavad need aadressitöötlejad, kes eelistavad kogu klassifikaatorit hoida dubleerituna oma keskkonnas, uuendada muutunud komponente. Samuti on võimalik saada teavet, milliseid muudatusi on aadresside klassifikaatoris toimunud. AS Datel /226

104 5.2.1 Sisend Nimi andmetüüp kirjeldus Otsingu tingimused muudetudalates date Kuupäev alates millest (k.a) registreeritud muudatusi soovitakse leida muudetudpaevad integer Number vahemikust 1 10 mitme päeva muudatusi vastusesse soovitakse. Vaikimisi 1 päev. objektiliik string (2) Aadressiobjekti liigi kood klassifikaatorist. Muudatuse põhjustanud aadressiobjekti liik mintase integer (min 1 max 8) maxtase integer (min 1 max 8) Minimaalne tase (üldisemast täpsema suunas), mille muudatused vastusesse tulevad Maksimaalne tase (üldisemast täpsema suunas), mille muudatused vastusesse tulevad logid integer Millisest LogId väärtusest suuremaid kirjeid otsitakse Vaikimisi 0 maxarv integer Maksimaalne tagastavate kirjete arv Vaikimisi süsteemi poolt kehtestatud limiit. ssyndmused boolean True tagastab ka S sündmuse False S sündmusi ei arvesta Vaikimisi false Tagastuse juhtimine initobjektid boolean True tagastab komponenti initsialiseerivate ADS-OIDide loetelu False ei tagasta loetelu Vaikimisi false kompsynonyymid boolean True tagastab komponentide sünonüümid False ei tagasta sünonüüme Vaikimisi false kompjarglased boolean True tagastab komponentide eellased / järglased False ei tagasta komponentide järgnevuse infot Vaikimisi false Ükski sisendparameeter ei ole kohustuslik Väljund nimi andmetüüp kirjeldus logid integer Logikirje ID logstamp datetime Logikirje tekkimise aeg, muudatuse tegemise aeg syndmus string I(insert) komponent lisandus, U(update) komponent versiooniti, D(delete) komponendi viimane versioon muudeti kehtetuks tase number Aadressikomponendi tase kood string Aadressikomponendi kood nimetus string Aadressikomponendi nimi ilma liigisõnata nimetusliigiga string Aadressikomponendi nimi koos liigisõnaga ylemtase number Aadressikomponendi ülem-komponendi tase ylemkood string Aadressikomponendi ülem-komponendi kood AS Datel /226

105 nimi andmetüüp kirjeldus vananimetus string Aadressikomponendi vana nimi ilma liigisõnata komponendi muutmise korral vananimetusliigiga string Aadressikomponendi vana nimi koos liigisõnaga komponendi muutmise korral MuutjaAdsOID string Muudatuse põhjustanud objekti ADS_OID oiguslikalus string Muudatuse põhjustanud objekti õiguslik alus alusekuup date Muudatuse põhjustanud objekti õigusliku aluse kuupäev tehniline boolean Tõene, kui on tegemist tehnilise komponendiga. Tehnilised on sellised 6. taseme komponendid, millega seotud katastriüksused ei ole kohanimekohustusega poleseotud boolean Tõene, kui komponent on kehtetu ja ta pole kasutusel mitte üheski kehtivas aadressis adsoid string Initsialiseerivate objektide ADS_OID väärtused. Loetelu elemendid eraldatud semikoolonitega synonyymid string Komponendi sünonüümid, mis ei lange kokku komponendi ametlike nimekujudega. Loetelu eraldatud semikoolonitega. eellased string Komponendi võimalikeks eellasteks olevate sama taseme tühistatud komponentide loetelu. Loetelu eraldatud semikoolonitega. jarglased string Komponendi võimalikeks järglasteks olevate sama taseme komponentide loetelu. Loetelu eraldatud semikoolonitega. Järglased on võimalikud ainult tühistatud komponentide korral Eelaste ja järglaste loetelu tagastatakse päringu sooritamise hetke seisuga Funktsionaalsus Logi tagastatakse Log_id järjestuses ning seda on võimalik küsida viimati saadud log_id-st alates Tehniline täitmine Päring tehakse vaatest XT_ADKOMP_LOG Kiiruse huvides tuleb sellest vaatest küsida andmeid ainult log_id vahemiku alusel. Kõigepealt tuleb teada saada log_id vahemik. Selleks kutsuda välja baasiprotseduur TEENUSED.get_komp_log_ids. Teenuse sisendid: ialates=>[muudetudalates] ikuni=>[muudetudkuni] (leitakse MuudetudAlates + MitmePaevaMuudatused) iadobliik=>[objektiliik] imintase=>[mintase] imaxtase=>[maxtase] ilogid=>[logid] issyndmus=>kui [Ssyndmused = false] siis 0, kui [Ssyndmused = true] siis 1 imaxarv=> korraga tagastatavate kirjete max arv, kas kasutaja poolt tellitud või süsteemi vaikimisi limiit Sama teenuse väljundparameetrid: oalateslogid log_id vahemiku algus okunilogid log_id vahemiku lõpp Kui emb-kumb väljundparameetritest on null (kontrollida võib ainult esimest) siis järelikult sisendis olevatele tingimustele vastavad logikirjed puuduvad ja võib AS Datel /226

106 tagastada kohe tühja tulemi, vaate poole pole üldse vaja pöörduda. Kui sisend oli vigane või ebapiisav, siis tekib tehniline viga. Kui log_id vahemik tagastati, siis teha päring vaatest ning where tingimuseks on log_id between oalateslogid and okunilogid. Kui tarbija ei soovinud S-sündmusi [Ssyndmused = false], siis lisandub tingimus AND l.syndmus <> S. Kui tarbija soovis ainult 1 objektiliiki, siis lisandub tingimus AND l.adob_liik = [ObjektiLiik]. Kui tarbija määras sisendis tasemeid, siis AND l.tase >=[MinTase] AND l.tase <= [MaxTase] Tulemus järjestada log_id alusel. Andmevälja syndmus tõlgendatakse järgmiselt: I lisamine U - muutmine D tühistamine R taastamine S seoste kadumine Teenus tagastab sündmuse kas sõnaliselt või kui tagastab sümboli, siis peab vastuse kirjelduses sisalduma sümbolite tõlgendus. Vaikimisi SELECT log_id, log_stamp, syndmus, tase, komp_kood, nimetus, nimetus_liigiga, ylemkomp_tase, ylemkomp_kood, vana_nimetus, vana_nimetus_liigiga, muutja_oid, oiguslik_alus, oiguslik_kp, tehniline, surnud. Kui tehniline=1, siis Tehniline = true. Kui tehniline=null, siis Tehniline = false. Kui surnud sisaldab kuupäeva, siis PoleSeotud=true. Kui surnud on tühi, siis PoleSeotud=false Kui sooviti ka InitObjekte, siis lisada päringu select-osasse INIT_OBJEKT. Kui sooviti ka sünonüüme, siis lisada päringu select-osasse SYNONYYMID. Kui sooviti ka järglaste infot, siis lisada päringu select-osasse EELLASED, JARGLASED. 5.3 Aadressikomponentide klassifikaatori muudatuste päring failina Teenuse nimi: ADSkompklassifManus.v Sisend Nimi andmetüüp kirjeldus logid integer Millisest LogId väärtusest suuremaid logikirjeid otsitakse Sisendparameeter on kohustuslik. Tühja sisendi korral tehniline viga. AS Datel /226

107 5.3.2 Väljund Nimi andmetüüp kirjeldus kirjetearv integer Tagastatavas logifailis sisalduvate kirjete arv. 0 kui faili ei tagastata puudumisepohjus text Tekstiline põhjendus faili puudumise kohta Teenus tagastab leitud logifaili teenuse manusena. Logifail sisaldab teenuse ADSkompklassif tagastust maksimaalses ulatuses. Fail sisaldab: kõik sündmused, ka S sündmused. komponenti initsialiseerivate objektide ADS_OID väärtused loeteluna komponendi sünonüümid komponendi eellaseks olevate komponentide loetelu komponendi järglaseks olevate komponentide loetelu (võimalik ainult tühistatud komponentide korral) Faili struktuur ehk XSD vastab teenuse ADSkomppklassif vastuse struktuurile, vt täpsemalt Aadressikomponentide klassifikaatori muudatuste päring (ADSkompklassif.v2) Väljund Funktsionaalsus Teenus tagastab eelnevalt ettevalmistatud logifaili, mis sisaldab sisendiks olevale logid väärtusele vahetult järgnevaid logikirjeid. Logifail toodetakse vahetult pärast logide avalikustamist, seega reeglina on 1 logifail 1 päeva muudatuste kohta, aga logifailis võib olla ka varasemaid ja/või hilisemaid muudatusi. Kui vastava logi kohta pole väljundit toodetud, siis on tagastus tühi. Kui tarbija küsib liiga varaseid logikirjeid, mille kohta pole veel faile tootma hakatud, siis on tagastus samuti tühi. Kui teenus faili ei tagasta, siis esineb tekstiline põhjendus nende puudumise kohta Tehniline täitmine Teenus teeb järgmise päringu SELECT id, file_content FROM xtee.xtee_logfiles WHERE log_table='komp_log' AND file_date IS NOT NULL AND [logid + 1] BETWEEN log_id1 AND log_id2 AS Datel /226

108 Sellise päringuga saadakse alati 1 või 0 kirjet. Kui päring peaks tagastama rohkem kirjeid, siis tehniline viga, sel juhul on tegemist vigaste andmetega. Faili sisu tuleb andmeväljast file_content. Kui leitud kirjete arv on 0, siis tuleb leida põhjus, miks faili ei leitud. Faili puudumist ei käsitle teenus tehnilise veana. Teha täiendav päring SELECT min(log_id1) min_log_id, max(log_id2) max_log_id FROM xtee.xtee_logfiles WHERE log_table='komp_log' AND file_date IS NOT NULL Parameeter puudumisepohjus väärtustada klassifitseeritud tekstiliste väärtustega, mille sisu peab olema vajadusel häälestatav. Vaikimisi luua klassifikaator alltoodud tekstidega. Parameetri puudumisepohjus väärtustamine järgmiselt: kui täiendava päringuga leitud min_log_id on tühi, siis tekst: Logifailide tootmist pole veel alustatud kui logid < min_log_id, siis tekst: Liiga väike logid, selle tekkimise ajal faile veel ei toodetud kui logid > max_log_id, siis tekst: Liiga suur logid, selle kohta pole veel faili toodetud muul juhul tekst: Tundmatu põhjus Tundmatu põhjus ei tohiks kunagi tekkida, sel juhul tuleb uurida mis juhtus. 5.4 Aadressiobjekti otsing Teenuse viimane versioon: ADSobjotsing.v6 Teenus võimaldab süsteemist otsida tingimustele vastavaid aadressiobjekte. Eraldi parameetritega saab juhtida tagastatavat andmestikku. Teenus tagastab leitud objekti(de) kehtiva seisu Sisend nimi andmetüüp kirjeldus Objekti otsingu tingimused origregister string (10) Objekti liigi päritoluregistri tunnus AS Datel /226

109 nimi andmetüüp kirjeldus objektiliik string (2) Aadressiobjekti liigi tunnus adsoid string (10) Objekti tunnus ADS süsteemis. origid string (20) Objekti tunnus päritoluregistris. xkoord double (min Aadressipunkti x-koordinaat L-Est süsteemis max ) ykoord double (min Aadressipunkti y-koordinaat L-Est süsteemis max ulatus double Päringutingimuseks oleva ala ruudu pool külje pikkust meetrites. Vaikimisi 0. Väärtusega arvestatakse ainult koordinaatide olemasolu korral. lahiaadress string (1000) Lähiaadressi osa tekstilisel kujul. Teatud juhtudel võib olla tarvis täpsustada lähiaadress, kui lähiaadressis sisalduv sõna ühtib EHAK objekti nimega. aadresstekst string (1000) Aadress või selle osa tekstilisel kujul. Aadressiosad eralda komaga, samuti on soovitav kasutada kohanime täpsustavaid tunnuseid (linn, linnaosa, tänav, tn, vald, v, maakond, mk, alev jn.) nt: Harju maakond, Tallinna linn, Kristiine linnaosa, Vindi tn või Tartu maakond, Vana-Kuuste küla otsingumeetod integer min 1 max 2 Otsingu meetod: Võimalikud väärtused;1,2 1- JA - otsi aadresse, milles esinevad kõik sisestatud aadressteksti sõnad 2 - VÕI - Otsi aadresse, milles esineb vähemalt üks sisestatud aadressteksti sõnadest vaikimisi JA huvipunktinimi string Objektiga seotud huvipunkti nime alusel otsing. Atribuudile rakendub otsingu täpsuse määrang, kuid ei rakendu otsingu meetod. Otsing toimub suur- väiketähtedest sõltumatult. otsingutapsus integer min 1 max 2 Otsingu täpsus: Võimalikud väärtused:1,2 1 TÄPNE otsitakse aadresse, mis sisaldab aadresstekstis esitatud sõnu 2 ALGUSEST otsitakse aadresse, mis sisaldab aadresstekstis esitatud algusega sõnu vaikimisi TÄPNE Meetodi väärtused KESKELT ja LÕPUST on kasutusest maas, sest ei toiminud ootuspäraselt. syno boolean Otsi ka sünonüümide hulgast True - otsitakse ka sünonüümide hulgast False otsitakse ainult ametlike tekstide hulgast Vaikimisi false Sünonüümidest otsimine toimub ainult otsingumeetod=tapne korral, sest ALGUSEST väärtuse korral ei sisalda aadresstekst terviksõnu, millele sünonüüme otsida. seotudadsoid string (10) Seotud aadressiobjekti ADS-OID. Selle alusel saab otsida ainult neid objekte, mis ADSs seotud on. NB! Kui sisendis on seotud OID ehk otsitakse seotud objekte, siis arvestatakse ainult seda ja ignoreeritakse aadressi ning x-y sisendit. Täiendavalt mõjub ObjektiLiik, kui see on väärtustatud. Seotud on: CU - > EE, ME EE, ME -> CU EE, ME -> ER, MR ER, MR -> EE, ME Tagastuse juhtimine AS Datel /226

110 nimi andmetüüp kirjeldus hulk boolean Tagasta ainult aadressiobjektide arv Vaikimisi false True vastuseks tagastatakse leitud objektide arv ning ülejäänud tagastusparameetrite määranguid ignoreeritakse False tagastatakse leitud objektid ning arvestatakse järgnevaid tagastusparameetreid andmevektor string (3) Vaikimisi 000 Andmevektor on kolmest sümbolist koosnev string. Eraldi positsioonis sümbolitega tähistatakse, millised andmed teenus tagastab. Esimene positsioon tähistab objekti tärk-, teine ruumija kolmas aadressiandmeid. Pos 1 = 0 tärkandmeid ei tagasta Pos 1 = 1 tärkandmed Pos 2 = 0 ruumiandmeid ei tagasta Pos 2 = 1 ruumiandmed Pos 3 = 0 aadressiandmeid eraldi ei tagasta Pos 3 = 1 tagastab aadressid eraldi kirjetena aadresskomp boolean Parameetrit arvestatakse ainult siis, kui andmevektori 3. positsioonis on 1 True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false probleemid boolean True tagastab ka objekti probleemid ja märkused False ei tagasta probleeme Vaikimisi false. objjarglased boolean True tagastab objekti eellased / järglased False ei tagasta objekti järgnevuse infot Vaikimisi false seotudobjektid boolean Parameeter omab tähtsust vaid hoonete ja katastriüksuste korral, sest teistel objektidel ei ole seoseid. True tagastab otseselt seotud objektid False ei tagasta seotud objekte Vaikimisi false huvipunktid boolean True tagastab objektiga seotud huvipunktide (POI) nimed False ei tagasta objektiga seotud huvipunktide (POI) nimesid Vaikimisi false alatesoid string (10) ADS_OID, millisest alates tulemus tagastatakse. Vajalik portsu alguse fikseerimiseks ning saadakse eelmisest päringust, kui see ei tagastanud kõike. Vaikimisi tühi, siis tagastatakse esimesest leitud objektist alates maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit Väljund nimi andmetüüp kirjeldus tulem objektidearv integer Päringutingimustele vastavate objektide arv (tagastatakse ainult siis kui sooviti saada objektide hulka) jargmineoid string Järgmise objekti ADS_OID, millest alates järgmist portsu küsida. Tagastatakse siis, kui päring oli suurem kui võimalik korraga tagastada ja kasutaja ei piiranud ise kirjete arvu Objekt (kordub vastavalt leitud objektide arvule, kui sooviti objekte eraldi, tagastatakse alati) adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris aadress string Objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul AS Datel /226

111 nimi andmetüüp kirjeldus lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse objektiurl string Link andmete kaardil vaatamiseks aadrprobleeme integer Objekti aadressi kehtivate probleemide arv eellased string Objekti võimalikeks eellasteks olevate objektide ADS_OID väärtuste loetelu. Loetelu eraldatud semikoolonitega. jarglased string Objekti võimalikeks järglasteks olevate objektide ADS_OID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Järglased on võimalikud ainult tühistatud objektide korral. unikaalne boolean Objekt on unikaalaadressi tunnusega Objekti tärkandmed (tagastatakse siis, kui andmevektori 1.pos = 1) tekkimisealus string Versiooni tekkimise õiguslik alus kehtivalates date Versiooni andmete ADS süsteemis jõustumise kuupäev esitatud datetime Versiooni andmete ADS süsteemis jõustumise kuupäev hoonekujupindala double Hoone 2D kuju alusel arvutatud pindala m2 täpsusega 1 koht peale koma hoonekorgusr double Hoone räästa kõrgus m sellise täpsusega nagu on ETAK andmetes hoonekorgusm double Hoone maksimaalne (harja) kõrgus m sellise täpsusega nagu on ETAK andmetes hooneosakorrus double Hooneosa sissepääsu korrus EHR andmetest, kui see on teada Objekti ruumiandmed (tagastatakse siis, kui andmevektori 2.pos = 1) ruumikuju GML Objekti Ruumikuju GML formaadis kujumoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud tsentroidx double Tsentroidi x-koordinaat L-Est süsteemis (northing) tsentroidy double Tsentroidi y-koordinaat L-Est süsteemis (easting) etakid integer Objektiga seotud ETAK_ID Aadress. Paralleelaadresside korral on mitu elementi. (Tagastatakse ainult siis, kui päringutingimuses andmevektori 3. pos=1) adrid Int Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub AS Datel /226

112 nimi andmetüüp kirjeldus punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega Objekti probleemid ja märkused (objektiga seotud element) Mitme probleemi korral mitu elementi aadress string See aadress, millega on probleeme. Võib puududa, kui probleem ei käi otseselt aadressi kohta staatus char(1) P - aktuaalne probleem; M - mitteaktuaalne probleem või märkus veakood integer Vea kood klassifikaatori veatekst string Probleemi tekstiline kirjeldus markus string Probleemi selgitus või mitteaktualiseerimise põhjendus. Lihtsalt märkus, kui probleemi polegi Seotud objektid (objektiga seotud element) Sisaldab seotud objektide hulka adsoid string Seotud objekti ADS süsteemi kood adobid integer Seotud objekti versioonitunnus ADS süsteemis objektiliik string (2) Seotud aadressiobjekti liik origtunnus string Seotud objekti tunnus originaalregistris aadress string Seotud objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul unikaalne boolean Seotud objekt on unikaalaadressi tunnusega AS Datel /226

113 nimi andmetüüp kirjeldus Huvipunktid (objektiga seotud element) Sisaldab seotud huvipunktide nimede hulka huvipunktinimi string Objektiga seotud huvipunkti (POI) nimetus Komponendid tagastatakse ainult siis, kui sisendparameetrites AadressKomp=true Funktsionaalsus Otsitakse sisendis määratud tingimustele vastavaid aadressiobjekte ning tagastatakse need ADS_OID järjestuses. Kõik sisendis olevad parameetrid saab omistada baasiprotseduuri TEENUSED.ADOB_OTSING sisendiks. Kasutaja poolt määramata parameetrid edastatakse vaikimisi väärtustega v.a MaxArv. Kui see on määramata, siis protseduurile edastada null. Boolean väärtused edastada protseduurile kujul 1-true/ 0-false. Punkti x ja y tuleb pöördumise hetkel ümber pöörata Tehniline täitmine Protseduur TEENUSED.ADOB_OTSING tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral tühi, vea korral veateade oobjarv => kui küsiti hulka, siis leitud objektide arv ojargmineoid => kui tulemus oli suurem kui lubatud, siis järgmise objekti ADS_OID Kui protseduur lõpetas positiivselt, siis tuleb ülejäänud andmed küsida järgmiste päringutega. Objektide andmed: SELECT t.ads_oid, t.adob_id, orig_tunnus, taisaadress,lahiaadress, kaardi_url, probleem_arv, unik FROM temp_adob t, adob_kuju k WHERE t.adob_id=k.adob_id ORDER BY ads_oid Kui sooviti ka järglaste infot, siis lisada päringu select-osasse teenused.getobjeellist (t.ads_oid) eelased, teenused.getobjjarglist(t.ads_oid) jarglased Kui sooviti ka tärkandmeid (kui andmevektori 1.pos = 1), siis lisada päringu selectosasse tekkimise_alus, kehtiv_alates, kehtiv, k.hoone_pind, t.hoone_korgus_r, t.hoone_korgus_m, t.hooneosa_korrus. Kui sooviti ka ruumiandmeid (kui andmevektori 2.pos = 1), siis lisada päringu selectosasse k.kuju_gml, k.kuju_moodustusviis, k.viitepunkt_x, k.viitepunkt_y, k.etak_id. Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. Moordustusviiside klassifikaator on sama mis menetlusrakenduses (4 väärtust). Kui sooviti ka aadresse (kui andmevektori 3.pos = 1), siis teha eraldi päring aadresside kohta. Aadresse võib iga objekti kohta olla rohkem kui 1. Seos tekib adob_id kaudu. SELECT adob_id, adr_id, koodaadress, taisaadress, lahiaadress, viitepunkt_x, viitepunkt_y, sihtnumber, asumi_nimi FROM temp_adobaadr. Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. AS Datel /226

114 Kui sooviti aadressi koos komponentidega, siis lisada aadressi päringu select-osasse tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk Kui sooviti ka objekti probleeme, siis teha eraldi täiendav päring. Probleeme võib iga objekti kohta olla rohkem kui 1. Seos tekib ADS_OID kaudu. SELECT ads_oid, taisaadress, staatus, vea_kood, vea_tekst, markus FROM adob_prob WHERE ads_oid IN (select ads_oid from temp_adob). Kui sooviti ka seotud objekte, siis teha eraldi täiendav päring. Seotud objekte võib iga objekti kohta olla rohkem kui 1. Seos tekib ADS_OID kaudu. SELECT adob_id, adob_liik, ads_oid, orig_tunnus, taisaadress, unik, seotud_oid FROM xt_adob_seotudobj WHERE seotud_oid IN (select ads_oid from temp_adob) Kui sooviti ka huvipunkte, siis teha eraldi täiendav päring. Huvipunkte võib iga objekti kohta olla rohkem kui 1. Seos tekib ADS_OID kaudu. SELECT ads_oid, poi_nimi FROM adob_poi WHERE ads_oid IN (select ads_oid from temp_adob) 5.5 Aadresside otsing Teenuse viimane versioon: ADSaadrotsing.v3 Tegemist on uue otsinguteenusega, mis ühendab endas nii komponentide kui ka teksti alusel otsingu teenust. Teenuse sisendiks on aadressis esinevad sõnad, mis on paigutatud kas konkreetsetele tasanditele, kui need on teada, või siis mitte. Viimasel juhul otsitakse sõnu kogu aadressitekstist. Teenus on mõeldud sisendis olevatele tingimustele vastavate aadresside otsimiseks ADS süsteemist. Otsida saab ka kehtetuid aadresse Sisend Nimi andmetüüp kirjeldus Otsingu tingimused adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta AS Datel /226

115 Nimi andmetüüp kirjeldus adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta lahiaadress string (1000) Lähiaadressi osa (4. 8. tasand) tekstilisel kujul aadresstekst string (1000) Koha-aadress tekstilisel kujul Sobilik kasutada juhul, kui kogu otsingu sisend edastaksegi ainult ühe pika tekstina. sihtnumber integer Otsitava aadressi sihtnumber mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub punktx double (min Punkti x-koordinaat max ) punkty double (min Punkti y-koordinaat max ulatus double Päringutingimuseks oleva ala raadius meetrites esitatud punkti asukohast lähtuvalt. Vaikimisi 0. Väärtusega arvestatakse ainult koordinaatide olemasolu korral. objektiliik string (2) Aadressiobjekti liigi kood Vaikimisi kõik liigid koodaadress string Koodaadress või selle algus. Kui koodaadress pole esitatud täielikult, siis toimub alati like otsing, metamärke lisada pole vaja. adrid integer Otsitava aadressi versiooni id, kui see on väljakutsujal teada. Kui versioon pole kehtiv, siis ta tagastatakse ainult siis, kui parameeter KaKehtetud on true Tagastuse juhtimine objekt boolean True tagastatakse ka seotud aadressiobjekti andmed. Kui aadress on seotud mitme objektiga, siis sisaldub vastuses objekti andmeblokk mitu korda. False seotud objekti andmeid ei lisata vastusesse. Vaikimisi False aadresskomp boolean True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false alateskoodist string Koodaadress, millisest alates tulemus tagastatakse. Vajalik portsu alguse fikseerimiseks ning saadakse eelmisest päringust, kui see ei tagastanud kõike. Vaikimisi tühi, siis tagastatakse esimesest leitud kirjest alates maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit. kakehtetud boolean Kas päring tagastab ka tühistatud ja vananenud aadressiversioonid Vaikimisi false ehk ainult kehtivad kasnormaliseerida boolean True AadressTekst sisendist üritab süsteem eraldada EHAK tasandeid määravad sõnad ning ülejäänu alusel sooritab otsingu lähiaadressist. See variant sobib juhul, kui tarbijal ei ole EHAK tasandid täpselt teada ja kogu sisend esitatakse ainult ühtse tekstina. False - AadressTekst sisendis olevaid sõnu otsitakse täisaadressist. Vaikimisi false. aadrjarglased boolean True tagastab aadresside eellased / järglased False ei tagasta aadresside järgnevuse infot Vaikimisi false Kui sisend esitatakse komponentidena, siis otsitakse aadresse, kus vastavate tasandite komponentide nimetuses esinevad sisestatud sõnad. Suur- ja väiketähti ei eristata. Näiteks, kui 2. tasandi nimetuseks on sisestatud tartu, siis otsib süsteem aadresse, kus 2. tasandil on kas nimetus Tartu vald või Tartu linn. AS Datel /226

116 Näiteks, kui 5. tasandi nimetuseks on sisestatud jaama, siis otsitakse aadresse, kus 5. tasandil on nimetuseks Jaama tee või Jaama tänav või Jaama tn või Jaama põik, kuid ei otsita aadresse, kus 5. taseme nimetuses on näiteks Jaamaküla tee. Sisestatud sõna peab nimetuses alati täpselt esinema. 4. ja 5. tasandi komponentide puhul otsitakse alati ka sünonüümide hulgast. See suurendab tõenäosust, et leitakse õige aadress ka pühendusnimede puhul. Näiteks võib otsida tänavat kas L. Koidula või Lydia Koidula, ikka leitakse komponent sellise nimekujuga, nagu ta parajasti ADS süsteemis ametlikuna on. 7. ja 8. taseme nimetuse olemasolul tehakse täpne otsing. Näiteks kui tasemele 7 sisestada nimetus 2, siis otsitakse aadresse, kus 7. tasemel esineb number 2. Ei leita numbreid 22, 2a ega 2/1 Samade reeglite alusel toimub otsing ka siis, kui otsingusõnad sisestatakse mitte tasanditele, vaid ühe stringina. Ka sel juhul otsitakse aadresse, milles sisalduvad esitatud sõnad täpselt sellisel kujul ja käändes. Sõnade järjekord ei ole oluline. Sünonüüme sellisel juhul ei hõlmata, nii et leitakse vaid need aadressid, kus ametlikus aadressitekstis esinevad kõik sisestatud sõnad. Metamärgid. Kui ikkagi soovitakse kas komponendi nimetuses või siis aadressiteksti otsingusõnades kasutada mitte täpseid sõnu, vaid sõnaalgusi, siis on võimalik tähistada puuduvat sõnaosa märgiga *. Näiteks, kui otsida nii jaama*, siis leitakse lisaks komponendile Jaama tee ka veel Jaamaküla tee. Saab ka otsida nii *aia*. Sel juhul leitakse sõnad õunaaia ja aiamaa, kuid leitakse ka sõna saialille, mis võibolla ei olnud otsingu eesmärk. Metamärkide kasutamisel peab sõnast olema määratud vähemalt 3 tähte, muidu loetakse päring liiga üldiseks ja tekib viga. Lisaks on võimalik kasutada tasandi määramisel metamärke * ja -. * tähistab, et vastav tasand peab aadressis olema määratud; - tähistab, et vastav tasand peab aadressis puuduma. Metamärgid peavad esinema komponendi nimetuse lahtris, komponendi koodis metamärke ei arvestata Väljund Nimi andmetüüp kirjeldus Tulem jargminekood string Järgmine koodaadress, millest alates järgmist portsu küsida. Tagastatakse siis, kui päring oli suurem kui võimalik korraga tagastada ja kasutaja ei piiranud ise kirjete arvu Aadress adrid Int Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadressitekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub AS Datel /226

117 Nimi andmetüüp kirjeldus punktx double (min Aadressi esinduspunkti x-koordinaat max ) punkty double (min Aadressi esinduspunkti y-koordinaat max adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega objarv integer Aadressiga seotud objektide arv olek string K- kehtiv V vananenud versioon T - tühistatud eellased string Aadressi võimalikeks eellasteks olevate aadresside ADR_ID väärtuste loetelu. Loetelu eraldatud semikoolonitega. jarglased string Aadressi võimalikeks järglasteks olevate aadresside ADR_ID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Järglased on võimalikud ainult tühistatud aadressi (olek=t) korral. Vananenud aadressil (olek=v) on alati täpselt 1 järglane, kuid kui see on juba tühistatud olekuga, siis teda e tagastata. Objekt (kui telliti ka objekti andmed), kui on mitu objekti, siis esineb mitu korda objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris objektiurl string Link andmete kaardil vaatamiseks ruumikuju GML Objekti ja aadressi seospunkti andmed gml-kujul unikaalne boolean Objekt on unikaalaadressi tunnusega Komponendid tagastatakse ainult siis, kui sisendparameetrites AadressKomp=true AS Datel /226

118 5.5.3 Funktsionaalsus Tagastatakse tingimustele vastavad aadressid koodaadressi järjestuses. Teenus ei tee ruumianalüüsi ja kui sisendis oli etteantud punkti koordinaadid ning ulatus, siis otsitakse aadressipunkti koordinaatide numbrilise väärtuse vahemiku alusel. Kui aadress on seotud mitme objektiga, siis tuleb ta vastusesse üks kord koos mitme objekti seosega. Vastusesse tulevad ainult kehtivad objektid. Kui päringu tulemusena sooviti ka kehtetuid aadresse ja objekti andmeid, siis lisatakse ainult kehtivate objektide seosed. Kui vananenud või tühistatud aadress pole enam seotud mitte ühegi kehtiva objektiga, siis tuleb ta tagastusse ilma objekti seoseta Tehniline täitmine Kõik sisendis olevad parameetrid saab omistada baasiprotseduuri TEENUSED.AADR_OTSING sisendiks. Kasutaja poolt määramata parameetrid edastatakse vaikimisi väärtustega v.a MaxArv. Kui see on määramata, siis protseduurile edastada null. Boolean väärtused edastada protseduurile kujul 1-true/ 0-false. Punkti x ja y tuleb pöördumise hetkel ümber pöörata. Metamärgid * ja - esitada komponendi nimetuse kohal kui neid on sisendis kasutatud. Protseduur TEENUSED. AADR_OTSING tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral tühi, vea korral veateade ojargminekood => kui tulemus oli suurem kui lubatud, siis järgmine koodaadress Kui protseduur lõpetas positiivselt, siis tulemus küsida järgmise päringuga: SELECT adr_id, koodaadress, taisaadress, lahiaadress, viitepunkt_x, viitepunkt_y, olek, sihtnumber, asumi_nimi (select count(*) from temp_adobaadr where adr_id=a.adr_id) objarv FROM temp_aadress a ORDER BY koodaadress Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. Kui sooviti ka komponendid, siis lisada päringu select osasse tase1_kood, tase1_nimi, tase1_nimi_pikk... tase8_kood, tase8_nimi, tase8_nimi_pikk. Kui sooviti ka järglaste andmeid, siis lisada päringu select osasse teenused.getaadreellist(a.adr_id) eelased, teenused.getaadrjarglist(a.adr_id) jarglased Kui telliti ka aadressi seosobjektid, siis teha täiendav päring SELECT temp_adobaadr.adr_id, temp_adob.adob_id, temp_adob.adob_liik, temp_adob.ads_oid, temp_adob.orig_tunnus, temp_adob.kaardi_url, temp_adob.geom_gml, temp_adob.unik FROM temp_adob, temp_adobaadr WHERE temp_adob.adob_id=temp_adobaadr.adob_id Päringu tulem ühendada vastusega adr_id alusel. Ühe adr_id kohta võib tekkida 0 n seosobjekti. AS Datel /226

119 5.6 Objekti muudatuste päring Teenuse viimane versioon: ADSobjmuudatused.v5 Teenuse kaudu saab väline infosüsteem teada, milliseid muudatusi on tehtud aadressiobjektide andmetes. Objekti aadressimuudatuste kohta on eraldi teenus. Teenus väljastab ka objekti eellaste ning järglaste info. Logitavad sündmused lähtuvad otseselt objekti andmete muudatustest: Lisamine (I) vastava ADS-OID-ga objekt lisati süsteemi Muutmine (U) vastava ADS-OID-ga objekti andmed muutusid. Objektist tekkis uus versioon (uue adob_id väärtusega). NB! Kui logikirjes adobid ja vanaadobid väärtused on võrdsed, siis on tegemist objekti versiooni parandamisega. Objektist ei ole tekkinud uut versiooni, vaid viidatud versioonil on muutunud kuju või õiguslik alus. Väikesed topoloogilised kujumuudatused ning õigusliku aluse tekstimuudatused ei põhjusta aadressiobjektist uue versiooni tekkimist, vaid muudatused tehakse olemasoleva versiooni andmete ülekirjutamisega. Objekti aadress ja un-tunnus versiooniparanduse käigus muutuda ei saa. Tühistamine (D) objekti viimane versioon tühistati. Vastava ADS-OID-ga objekt on tühistatud. Taastamine (R) Tühistatud objekt taastatakse. Objektist tekib ka uus versioon. Seotud objektide muudatus (H) hoonestatuse muutumise sündmus. Omavahel seotud objektideks loetakse katastriüksusi ja nendel paiknevaid hooneid. Antud sündmus antakse juhul kui objektile tekib esimene seotud objekt või kaob viimane. H sündmuse korral on väljundis Seotud objektid jaotuses oleva info alusel on võimalik tuvastada, kas objektil on seotud objekte või mitte. Kui see jaotus Seotud objektid on tühi, siis objektil pole enam seotud objekte ja vastupidi. ADS-s võib erandjuhul esineda olukord, kus seostuse info muutub päeva jooksul mitu korda, seega võidakse logida mitu H-sündmust. Väljundi jaotus Seotud objektid aga täidetakse päringu tegemise hetkel oleva seisuga - seega viitavad mõlemad sündmused ühesugusele hoonestatuse seisule. Huvipunktide nimede muudatus (B) objektiga seotud huvipunktide lisandumise, muutumise või eemaldamise korral tekkiv sündmus. Ei ole seotud objekti muudatussündmusega. Huvipunktide seosed muutuvad objekti juures sõltumatult objektiga toimuvatest muudatustest Sisend nimi andmetüüp kirjeldus Otsingu tingimused muudetudalates date Kuupäev alates millest (k.a) registreeritud muudatusi soovitakse leida muudatudpaevad integer Number vahemikust 1 10 mitme päeva muudatusi vastusesse soovitakse. Vaikimisi 1 päev. objektiliik string (2) Aadressiobjekti liigi kood klassifikaatorist, millega seotud muudatusi soovitakse. Vaikimisi kõik liigid logid integer Millisest LogId väärtusest suuremaid kirjeid otsitakse Vaikimisi 0 AS Datel /226

120 nimi andmetüüp kirjeldus maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit. hsyndmused boolean True tagastab ka H sündmuse False H sündmusi ei arvesta, ainult I, U, D, R sündmused Vaikimisi false bsyndmused boolean True tagastab ka B (huvipunkti nime muudatuse) sündmuse False B sündmusi ei arvesta Vaikimisi false Tagastuse juhtimine andmevektor string (3) Vaikimisi 000 Andmevektor on kolmest sümbolist koosnev string. Eraldi positsioonis sümbolitega tähistatakse, millised andmed teenus tagastab. Esimene positsioon tähistab objekti tärk-, teine ruumija kolmas aadressiandmeid. Pos 1 = 0 tärkandmeid ei tagasta Pos 1 = 1 tärkandmed Pos 2 = 0 ruumiandmeid ei tagasta Pos 2 = 1 ruumiandmed Pos 3 = 0 aadresse eraldi ei tagasta Pos 3 = 1 tagastab aadressid eraldi kirjetena aadresskomp boolean Parameetrit arvestatakse ainult siis, kui andmevektori 3. positsioonis on 1 True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false objjarglased boolean True tagastab objekti eellased / järglased False ei tagasta objekti järgnevuse infot Vaikimisi false probleemid boolean True tagastab ka objekti probleemid ja märkused False ei tagasta probleeme Vaikimisi false. seotudobjektid boolean Parameeter omab tähtsust vaid hoonete ja katastriüksuste korral, sest teistel objektidel ei ole seoseid. True tagastab otseselt seotud objektid False ei tagasta seotud objekte Vaikimisi false huvipunktid boolean True tagastab objektiga seotud huvipunktide (POI) nimed False ei tagasta objektiga seotud huvipunktide (POI) nimesid Vaikimisi false Väljund Nimi andmetüüp kirjeldus logid integer Logikirje ID logstamp datetime Logikirje tekkimise aeg, muudatuse tegemise aeg, koos kellaajaga syndmus string I(insert) objekt lisati, U(update) objekt muudeti, D(delete) objekt tühistati, R(restore) objekt taastati H seotud objektide muudatus B huvipunkti nime muudatus muutvektor string (3) Muudatusvektor on kolmest 0/1 sümbolist koosnev string. Eraldi positsioonidega tähistatakse, mis andmed on muutunud võrreldes eelmise versiooniga. Muudatusvektor omab väärtust ainult muutuse sündmuse korral. Pos 1 objekti õiguslik alus Pos 2 objekti kuju Pos 3 - objekti aadressid objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood (objekti identifikaator ADS süsteemis) AS Datel /226

121 Nimi andmetüüp kirjeldus adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris taisaadress string Objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse olek string Sündmuse põhjustanud objektiversiooni olek päringu sooritamise hetkel: K versioon on viimane, objekt tervikuna on kehtiv, V- vananenud, versioon ei ole viimane, objekti on pärast käesolevat logiteadet veel muudetud, (varsti järgneb veel üks muudatuse logiteade) T versioon on viimane, objekt tervikuna on tühistatud (kui muudatuse või lisamise logi puhul olek=t, siis see näitab, et varsti järgneb ka tühistamise logi) vanaadobid Integer Objekti eelmise versiooni id muutmise korral vanataisaadress string Objekti eelmise versiooni täisaadress vanalahiaadress string Objekti eelmise versiooni lähiaadress unikaalne boolean Objekt on unikaalaadressi tunnusega eellased string Objekti võimalikeks eellasteks olevate objektide ADS_OID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Järglased tagastatakse päringu hetke seisuga, mitte logikirje tekkimise hetke seisuga. jarglased string Objekti võimalikeks järglasteks olevate objektide ADS_OID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Järglased on võimalikud ainult tühistatud objektide korral. Järglased tagastatakse päringu hetke seisuga, mitte logikirje tekkimise hetke seisuga. Objekti tärkandmed (tagastatakse siis, kui andmevektori 1.pos = 1) tekkimisealus string Versiooni tekkimise õiguslik alus kehtivalates date Versiooni andmete ADS süsteemis jõustumise kuupäev esitatud datetime Versiooni andmete ADS süsteemis jõustumise kuupäev sulgemisealus string Versiooni sulgemise õiguslik alus kehtivkuni date Kuupäev, millest alates see objekt ADS-s kehtetu on hooneoid string Täidetud ainult hoone osa korral, viitab seotud hoonele hoonekujupindala double Hoone 2D kuju alusel arvutatud pindala m2 täpsusega 1 koht peale koma hoonekorgusr double Hoone räästa kõrgus m sellise täpsusega nagu on ETAK andmetes hoonekorgusm double Hoone maksimaalne (harja) kõrgus m sellise täpsusega nagu on ETAK andmetes hooneosakorrus double Hooneosa sissepääsu korrus EHR andmetest, kui see on teada muudatusealgataja string Täidetud ainult hooneosade korral: X- X-tee teenus, K ADS kasutaja või süsteem Objekti ruumiandmed (tagastatakse siis, kui andmevektori 2.pos = 1) AS Datel /226

122 Nimi andmetüüp kirjeldus ruumikuju GML Objekti Ruumikuju GML formaadis kujumoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud tsentroidx double Tsentroidi x-koordinaat L-Est süsteemis (northing) tsentroidy double Tsentroidi y-koordinaat L-Est süsteemis (easting) etakid integer Objektiga seotud ETAK_ID Aadress. Paralleelaadresside korral on mitu elementi. (Tagastatakse ainult siis, kui päringutingimuses andmevektori 3. pos=1) adrid Int Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega Objekti probleemid ja märkused (objektiga seotud element) Mitme probleemi korral mitu elementi AS Datel /226

123 Nimi andmetüüp kirjeldus aadress string See aadress, millega on probleeme. Võib puududa, kui probleem ei käi otseselt aadressi kohta staatus char(1) P - aktuaalne probleem; M - mitteaktuaalne probleem või märkus veakood integer Vea kood klassifikaatori veatekst string Probleemi tekstiline kirjeldus markus string Probleemi selgitus või mitteaktualiseerimise põhjendus. Lihtsalt märkus, kui probleemi polegi Seotud objektid (objektiga seotud element) Sisaldab seotud objektide hulka adsoid string Seotud objekti ADS süsteemi kood adobid integer Seotud objekti versioonitunnus ADS süsteemis objektiliik string (2) Seotud aadressiobjekti liik origtunnus string Seotud objekti tunnus originaalregistris aadress string Seotud objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul unikaalne boolean Seotud objekt on unikaalaadressi tunnusega Huvipunktid (objektiga seotud element) Sisaldab seotud huvipunktide nimede hulka huvipunktinimi huvipunktinimi huvipunktinimi Funktsionaalsus Tulem tagastatakse log_id järjestuses. Kui etteantud ajavahemikus on rohkem muudatusi kui korraga tagastada võimalik, siis tuleb sama päringut korrata andes sisendisse kaasa viimase log_id väärtuse eelmise päringu tulemist. Kõik logikirjed on edastatud kui päringu vastus on tühi Tehniline täitmine Päring tehakse andmebaasi vaatest XT_ADOB_LOG_V5. Kiiruse huvides tuleb sellest vaatest küsida andmeid ainult log_id vahemiku alusel. Kõigepealt tuleb teada saada log_id vahemik. Selleks kutsuda välja baasiprotseduur TEENUSED.get_adob_log_ids. Teenuse sisendid: ialates=>[muudetudalates] ikuni=>[muudetudkuni] (leitakse MuudetudAlates + MitmePaevaMuudatused) iadobliik=>[objektiliik] ilogid=>[logid] ihsyndmus=>kui [Hsyndmused = false] siis 0, kui [Hsyndmused = true] siis 1 imaxarv=> korraga tagastatavate kirjete max arv, kas kasutaja poolt tellitud või süsteemi vaikimisi limiit ibsyndmus=>kui [Bsyndmused = false] siis 0, kui [Bsyndmused = true] siis 1 AS Datel /226

124 Sama teenuse väljundparameetrid: oalateslogid log_id vahemiku algus okunilogid log_id vahemiku lõpp Kui emb-kumb väljundparameetritest on null (kontrollida võib ainult esimest) siis järelikult sisendis olevatele tingimustele vastavad logikirjed puuduvad ja võib tagastada kohe tühja tulemi, vaate poole pole üldse vaja pöörduda. Kui sisend oli vigane või ebapiisav, siis tekib tehniline viga. Kui log_id vahemik tagastati, siis teha päring vaatest ning where tingimuseks on log_id between oalateslogid and okunilogid Kui tarbija ei soovinud H-sündmusi [Hsyndmused = false], siis lisandub tingimus AND l.syndmus <> H. Kui tarbija ei soovinud B-sündmusi [Bsyndmused = false], siis lisandub tingimus AND l.syndmus <> B. Tulemus järjestada log_id alusel. Andmevälja syndmus tõlgendatakse järgmiselt: I lisamine U - muutmine D tühistamine R taastamine H hoonestatuse ehk seotud objektide muutus B huvipunkti nime muudatus Vaikimisi SELECT log_id, log_stamp, syndmus, muudatusvektor, adob_liik, ads_oid, adob_id, orig_tunnus, taisaadress, lahiaadress, olek, vana_adob_id, vana_taisaadress, vana_lahiaadress, unik. Kui sooviti ka järglaste infot, siis lisada päringu select-osasse teenused.getobjeellist (ads_oid) eelased, teenused.getobjjarglist(ads_oid) jarglased Kui sooviti ka tärkandmeid (kui andmevektori 1.pos = 1), siis lisada päringu selectosasse tekkimise_alus, kehtiv_alates, kehtiv, sulgemise_alus, kehtiv_kuni, hoone_oid, hoone_pind, hoone_korgus_r, hoone_korgus_m, hooneosa_korrus, muudat_algataja. Kui sooviti ka ruumiandmeid (kui andmevektori 2.pos = 1), siis teha eraldi päring, seos tekib adob_id kaudu: SELECT adob_id, kuju_gml, kuju_moodustusviis, viitepunkt_x, viitepunkt_y, etak_id FROM adob_kuju WHERE adob_id in (<vaikimisi päringu tagastuses sisalduv adob_id hulk>) Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. Moordustusviiside klassifikaator on sama mis menetlusrakenduses (4 väärtust). Kui sooviti ka aadresse (kui andmevektori 3.pos = 1), siis teha eraldi päring aadresside kohta. Aadresse võib iga objekti kohta olla rohkem kui 1. Seos tekib adob_id kaudu. SELECT adob_id, adr_id, koodaadress, taisaadress, lahiaadress, seose_x, seose_y, sihtnumber, asumi_nimi FROM adob_aadr WHERE adob_id in (<vaikimisi päringu tagastuses sisalduv adob_id hulk>) Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. AS Datel /226

125 Kui sooviti aadressi koos komponentidega, siis lisada aadressi päringu select-osasse tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk Kui sooviti ka objekti probleeme, siis teha eraldi täiendav päring. Probleeme võib iga objekti kohta olla rohkem kui 1. Seos tekib ADS_OID kaudu. SELECT ads_oid, taisaadress, staatus, vea_kood, vea_tekst, markus FROM adob_prob WHERE ads_oid IN (<vaikimisi päringu tagastuses sisalduv ADS_OID hulk>). Kui sooviti ka seotud objekte, siis teha eraldi täiendav päring. Seotud objekte võib iga objekti kohta olla rohkem kui 1. Seos tekib ADS_OID kaudu. SELECT adob_id, adob_liik, ads_oid, orig_tunnus, taisaadress, unik, seotud_oid FROM xt_adob_seotudobj WHERE seotud_oid IN (vaikimisi päringu tagastuses sisalduv ADS_OID hulk) Kui sooviti ka huvipunkte [huvipunktid=true], siis teha eraldi täiendav päring. Huvipunkte võib iga objekti kohta olla rohkem kui 1. Seos tekib ADS_OID kaudu. SELECT ads_oid, poi_nimi FROM adob_poi WHERE ads_oid IN (vaikimisi päringu tagastuses sisalduv ADS_OID hulk) 5.7 Objekti muudatuste päring failina Teenuse nimi: ADSobjmuudatusedManus.v Sisend Nimi andmetüüp kirjeldus logid integer Millisest LogId väärtusest suuremaid logikirjeid otsitakse Sisendparameeter on kohustuslik. Tühja sisendi korral tehniline viga Väljund Nimi andmetüüp kirjeldus kirjetearv integer Tagastatavas logifailis sisalduvate kirjete arv. 0 kui faili ei tagastata puudumisepohjus text Tekstiline põhjendus faili puudumise kohta Teenus tagastab leitud logifaili teenuse manusena. Logifail sisaldab teenuse ADSobjmuudatused tagastust maksimaalses ulatuses. AS Datel /226

126 Fail sisaldab: kõik sündmused (I, U, D, R, H, B). objekti tärkandmed objekti ruumiandmed objekti aadressid koos komponentidega objekti probleemid ja märkused seotud objektid objekti eellaseks olevate objektide ADS_OID väärtused loeteluna objekti järglaseks olevate objektide ADS_OID väärtused loeteluna (võimalik ainult tühistatud objekti korral) Faili struktuur ehk XSD vastab teenuse ADSobjmuudatused vastuse struktuurile, vt täpsemalt Objekti muudatuste päring (ADSobjmuudatused.v4) Väljund Funktsionaalsus Teenus tagastab eelnevalt ettevalmistatud logifaili, mis sisaldab sisendiks olevale logid väärtusele vahetult järgnevaid logikirjeid. Logifail toodetakse vahetult pärast logide avalikustamist, seega reeglina on 1 logifail 1 päeva muudatuste kohta, aga logifailis võib olla ka varasemaid ja/või hilisemaid muudatusi. Kui vastava logi kohta pole väljundit toodetud, siis on tagastus tühi. Kui tarbija küsib liiga varaseid logikirjeid, mille kohta pole veel faile tootma hakatud, siis on tagastus samuti tühi. Kui teenus faili ei tagasta, siis esineb tekstiline põhjendus nende puudumise kohta Tehniline täitmine Teenus teeb järgmise päringu SELECT id, file_content FROM xtee.xtee_logfiles WHERE log_table='adob_log' AND file_date IS NOT NULL AND [logid + 1] BETWEEN log_id1 AND log_id2 Sellise päringuga saadakse alati 1 või 0 kirjet. Kui päring peaks tagastama rohkem kirjeid, siis tehniline viga, sel juhul on tegemist vigaste andmetega. Faili sisu tuleb andmeväljast file_content. Kui leitud kirjete arv on 0, siis tuleb leida põhjus, miks faili ei leitud. Faili puudumist ei käsitle teenus tehnilise veana. Teha täiendav päring SELECT min(log_id1) min_log_id, max(log_id2) max_log_id AS Datel /226

127 FROM xtee.xtee_logfiles WHERE log_table='adob_log' AND file_date IS NOT NULL Parameeter puudumisepohjus väärtustada klassifitseeritud tekstiliste väärtustega, mille sisu peab olema vajadusel häälestatav. Vaikimisi luua klassifikaator alltoodud tekstidega. Parameetri puudumisepohjus väärtustamine järgmiselt: kui täiendava päringuga leitud min_log_id on tühi, siis tekst: Logifailide tootmist pole veel alustatud kui logid < min_log_id, siis tekst: Liiga väike logid, selle tekkimise ajal faile veel ei toodetud kui logid > max_log_id, siis tekst: Liiga suur logid, selle kohta pole veel faili toodetud muul juhul tekst: Tundmatu põhjus Tundmatu põhjus ei tohiks kunagi tekkida, sel juhul tuleb uurida mis juhtus. 5.8 Aadressi muudatuste päring Teenuse viimane versioon: ADSaadrmuudatused.v5 Teenuse kaudu saab väline infosüsteem teavet aadresside lisandumisest, muutumistest ja tühistamistest ADS süsteemis etteantud ajavahemikus. Logitavad sündmused lähtuvad otseselt aadressidest: Lisamine (I) vastava koodaadressiga aadress lisati süsteemi Muutmine (U) vastava koodaadressiga aadress muudeti. Tekkis uus aadressi kirje (uue adr_id väärtusega), kuid see koosneb täpselt samadest komponentidest. Muutunud on mõne komponendi nimi ja seega ka tekstiline aadress. Tühistamine (D) aadressi viimane versioon tühistati. Taastamine (R) aadressi tühistatud versioon muudeti uuesti kehtivaks. Punkti koordinaatide muutumine (P) aadressi esinduspunkti koordinaadid võivad muutuda, kui aadress omistatakse mõnele uuele objektile või kui eemaldatakse mõnelt objektilt või kui muutub mõne aadressiga seotud objekti kuju või tähtsus. Sellises olukorras kehtiva aadressi kirjes koordinaatide väärtused lihtsalt asendatakse, vana seis alles ei jää. Sündmus tähistabki sellise muudatuse toimumist. Seoste kadumine (S) see sündmus on võimalik ainult tühistatud aadresside korral. Tühistatud aadress võib jääda külge veel mõnele kehtivale objektile. See sündmus tekib, kui viimane seos aadressi ja kehtiva objekti vahel eemaldatakse ehk teisisõnu kui see aadress ei jää enam mitte ühegi kehtiva objekti aadressiks. Sihtnumbri muudatus (N) aadressile sihtnumbri lisandumise, muutumise või eemaldamise korral tekkiv sündmus. Ei ole seotud aadressi muudatussündmusega. Sihtnumber muutub aadressi juures sõltumatult teistest sündmustest. AS Datel /226

128 Mittemetliku piirkonna nime muudatus (A) aadressile piirkonna nime lisandumise, muutumise või eemaldamise korral tekkiv sündmus. Ei ole seotud aadressi muudatussündmusega. Piirkonna nimi muutub aadressi juures sõltumatult teistest sündmustest. Muudatuse põhjustanud objekt võib olla selline, mis ise pole kunagi seda aadressi omanud. Näiteks asustusüksuse kehtetuks muutumine põhjustab tagajärjena kõigi nende aadresside kehtetuks muutumise, mis sisaldavad selle asustusüksuse poolt initsialiseeritud komponenti. Aadressi lisamise sündmus saab aga toimuda ainult sellise objekti poolt, mis ise seda aadressi omab. Muutumise sündmus saab samuti olla põhjustatud objekti poolt, mis ise ei oma seda aadressi. Näiteks tänava nime muutumise tulemusena muutuvad kõik aadressid, mis sisaldavad selle liikluspinna objekti poolt initsialiseeritud komponenti. Aadressi eellased ja järglased edastatakse päringu tegemise hetke seisuga. Järgnevussuhted on ajas muutuvad, need lisanduvad seoses uute aadresside tekkimisega süsteemi Sisend nimi andmetüüp kirjeldus Otsingu tingimused muudetudalates date Kuupäev alates millest (k.a) registreeritud muudatusi soovitakse leida muudatudpaevad integer Number vahemikust 1 10 mitme päeva muudatusi vastusesse soovitakse. Vaikimisi 1 päev. logid integer Millisest LogId väärtusest suuremaid kirjeid otsitakse Vaikimisi 0 maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit. psyndmused boolean True tagastab ka P sündmuse False P sündmusi ei arvesta Vaikimisi false ssyndmused boolean True tagastab ka S sündmuse False S sündmusi ei arvesta Vaikimisi false nsyndmused boolean True tagastab ka N sündmuse False N sündmusi ei arvesta Vaikimisi false asyndmused boolean True tagastab ka A sündmuse False A sündmusi ei arvesta Vaikimisi false Tagastuse juhtimine objekt boolean True tagastatakse ka muudatuse põhjustanud aadressiobjekti andmed. False muudatuse põhjustanud objekti andmeid ei lisata vastusesse. Vaikimisi False seosed boolean True tagastatakse ka muudatuse hetkel aadressiga seotud kehtivad objektid False seotud objektide andmeid ei lisata vastusesse Vaikimisi false aadresskomp boolean True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false aadressjarglased boolean True tagastab aadresside eellased / järglased False ei tagasta aadresside järgnevuse infot Vaikimisi false AS Datel /226

129 5.8.2 Väljund Nimi andmetüüp kirjeldus logid integer Logikirje ID logstamp datetime Logikirje tekkimise aeg, muudatuse tegemise aeg, koos kellaajaga syndmus string I(insert) aadress lisati süsteemi, U(update) samade komponentidega aadressi tekst muutus, aadress versiooniti, D(delete) aadress tühistati, R(restore) aadress taastati koodaadress string Koodaadress adrid Int Aadressi unikaalne võti taisaadress string Normaliseeritud aadressitekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub vanaadrid Int Aadressi eelmise versiooni number muutmise korral vanataisaadress string Aadressi eelmine täielik nimekuju muutmise korral vanalahiaadress string Eelmine lähiaadress muutmise korral esinduspunktx double Aadressi esinduspunkti x-koordinaat esinduspunkty double Aadressi esinduspunkti y-koordinaat eellased string Aadressi võimalikeks eellasteks olevate aadresside ADR_ID väärtuste loetelu. Loetelu eraldatud semikoolonitega. jarglased string Aadressi võimalikeks järglasteks olevate aadresside ADR_ID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Järglased on võimalikud ainult tühistatud aadresside korral poleseotud boolean Tõene, kui aadress on kehtetu ja ta pole seotud ühegi kehtiva objektiga Muudatuse põhjustanud objekt (kui telliti ka objekti andmed) objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris punktx double Objekti tsentroidipunkti x-koordinaat punkty double Objekti tsentroidipunkti y-koordinaat Aadressi seosobjektid (kui telliti), kui on mitu objekti, siis esineb mitu korda objektiliik string Objekti liigi nimi klassifikaatorist AS Datel /226

130 Nimi andmetüüp kirjeldus adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris unikaalne boolean Objekt on unikaalaadressi tunnusega Aadress koos komponentidega, kui telliti komponendid (logis adr_id aadressi komponendid, ka D sündmuse korral) adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega muudetudtase integer U ja D sündmuse korral selle taseme number vahemikust {1-8}, mis põhjustas aadressi muudatuse või tühistumise Funktsionaalsus Tulem tagastatakse log_id järjestuses. Kui etteantud ajavahemikus on rohkem muudatusi kui korraga tagastada võimalik, siis tuleb sama päringut korrata andes sisendisse kaasa viimase log_id väärtuse eelmise päringu tulemist. Kõik logikirjed on edastatud kui päringu vastus on tühi Tehniline täitmine Päring tehakse andmebaasi vaatest XT_AADR_LOG_V5. Kiiruse huvides tuleb sellest vaatest küsida andmeid ainult log_id vahemiku alusel. Kõigepealt tuleb teada saada log_id vahemik. Selleks kutsuda välja baasiprotseduur TEENUSED.get_aadr_log_ids. Teenuse sisendid: ialates=>[muudetudalates] AS Datel /226

131 ikuni=>[muudetudkuni] (leitakse MuudetudAlates + MitmePaevaMuudatused) ilogid=>[logid] ipsyndmus=>kui [Psyndmused = false] siis 0, kui [Psyndmused = true] siis 1 issyndmus=>kui [Ssyndmused = false] siis 0, kui [Ssyndmused = true] siis 1 insyndmus=>kui [Nsyndmused = false] siis 0, kui [Nsyndmused = true] siis 1 iasyndmus=>kui [Asyndmused = false] siis 0, kui [Asyndmused = true] siis 1 imaxarv=> korraga tagastatavate kirjete max arv, kas kasutaja poolt tellitud või süsteemi vaikimisi limiit Sama teenuse väljundparameetrid: oalateslogid log_id vahemiku algus okunilogid log_id vahemiku lõpp Kui emb-kumb väljundparameetritest on null (kontrollida võib ainult esimest) siis järelikult sisendis olevatele tingimustele vastavad logikirjed puuduvad ja võib tagastada kohe tühja tulemi, vaate poole pole üldse vaja pöörduda. Kui sisend oli vigane või ebapiisav, siis tekib tehniline viga. Kui log_id vahemik tagastati, siis teha päring vaatest ning where tingimuseks on log_id between oalateslogid and okunilogid Kui tarbija ei soovinud P-sündmusi [Psyndmused = false], siis lisandub tingimus AND l.syndmus <> P. Kui tarbija ei soovinud S-sündmusi [Ssyndmused = false], siis lisandub tingimus AND l.syndmus <> S. Kui tarbija ei soovinud N-sündmusi [Nsyndmused = false], siis lisandub tingimus AND l.syndmus <> N. Kui tarbija ei soovinud A-sündmusi [Asyndmused = false], siis lisandub tingimus AND l.syndmus <> A. Tulemus järjestada log_id alusel. Andmevälja syndmus tõlgendatakse järgmiselt: I lisamine U - muutmine D tühistamine R taastamine P punkti muudatus S seoste kadumine N sihtnumbri muudatus A MA piirkonna nime muudatus Teenus tagastab sündmuse kas sõnaliselt või kui tagastab sümboli, siis peab vastuse kirjelduses sisalduma sümbolite tõlgendus. Vaikimisi SELECT log_id, log_stamp, syndmus, koodaadress, adr_id, taisaadress, lahiaadress, sihtnumber, asumi_nimi, vana_adr_id, vana_taisaadress, vana_lahiaadress, aadr_x, aadr_y, surnud Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. Kui surnud sisaldab kuupäeva, siis PoleSeotud=true. Kui surnud on tühi, siis PoleSeotud=false. Kui telliti muudatuse põhjustanud objekti andmed, siis päringu select osasse lisada adob_liik, ads_oid, adob_id, orig_tunnus, viitepunkt_x, viitepunkt_y. AS Datel /226

132 Kui telliti aadress koos komponentidega, siis päringu select osasse lisada tase1_kood, tase1_nimi, tase1_nimi_pikk,., tase8_kood, tase8_nimi, tase8_nimi_pikk, muudetud_tase. Kui telliti objekti järgluse info, siis päringu select osasse lisada eelased, jarglased. Kui telliti ka aadressi seosobjektid, siis teha täiendav päring SELECT adr_id, adob_liik, ads_oid, adob_id, orig_tunnus, unik FROM adob_aadr WHERE olek in ( K, O, X ) and adr_id IN (<päringu tagastusse minev adr_id list>) Päringu tulem ühendada vastusega adr_id alusel. Ühe adr_id kohta võib tekkida 0 n seosobjekti. 5.9 Aadressi muudatuste päring failina Teenuse nimi: ADSaadrmuudatusedManus.v Sisend Nimi andmetüüp kirjeldus logid integer Millisest LogId väärtusest suuremaid logikirjeid otsitakse Sisendparameeter on kohustuslik. Tühja sisendi korral tehniline viga Väljund Nimi andmetüüp kirjeldus kirjetearv integer Tagastatavas logifailis sisalduvate kirjete arv. 0 kui faili ei tagastata puudumisepohjus text Tekstiline põhjendus faili puudumise kohta Teenus tagastab leitud logifaili teenuse manusena. Logifail sisaldab teenuse ADSaadrmuudatused tagastust maksimaalses ulatuses. Fail sisaldab: kõik sündmused (I, U, D, R, P, S, N, A) aadressi muudatust põhjustanud objekti andmed aadressi seosobjektid aadress koos komponentidega aadressi eellaseks olevate aadresside ADR_ID väärtused loeteluna aadressi järglaseks olevate aadresside ADR_ID väärtused loeteluna (võimalik ainult tühistatud aadressi korral) AS Datel /226

133 Faili struktuur ehk XSD vastab teenuse ADSaadrmuudatused vastuse struktuurile, vt täpsemalt Aadressi muudatuste päring (ADSaadrmuudatused.v4) Väljund Funktsionaalsus Teenus tagastab eelnevalt ettevalmistatud logifaili, mis sisaldab sisendiks olevale logid väärtusele vahetult järgnevaid logikirjeid. Logifail toodetakse vahetult pärast logide avalikustamist, seega reeglina on 1 logifail 1 päeva muudatuste kohta, aga logifailis võib olla ka varasemaid ja/või hilisemaid muudatusi. Kui vastava logi kohta pole väljundit toodetud, siis on tagastus tühi. Kui tarbija küsib liiga varaseid logikirjeid, mille kohta pole veel faile tootma hakatud, siis on tagastus samuti tühi. Kui teenus faili ei tagasta, siis esineb tekstiline põhjendus nende puudumise kohta Tehniline täitmine Teenus teeb järgmise päringu SELECT id, file_content FROM xtee.xtee_logfiles WHERE log_table='aadr_log' AND file_date IS NOT NULL AND [logid + 1] BETWEEN log_id1 AND log_id2 Sellise päringuga saadakse alati 1 või 0 kirjet. Kui päring peaks tagastama rohkem kirjeid, siis tehniline viga, sel juhul on tegemist vigaste andmetega. Faili sisu tuleb andmeväljast file_content. Kui leitud kirjete arv on 0, siis tuleb leida põhjus, miks faili ei leitud. Faili puudumist ei käsitle teenus tehnilise veana. Teha täiendav päring SELECT min(log_id1) min_log_id, max(log_id2) max_log_id FROM xtee.xtee_logfiles WHERE log_table='aadr_log' AND file_date IS NOT NULL Parameeter puudumisepohjus väärtustada klassifitseeritud tekstiliste väärtustega, mille sisu peab olema vajadusel häälestatav. Vaikimisi luua klassifikaator alltoodud tekstidega. Parameetri puudumisepohjus väärtustamine järgmiselt: kui täiendava päringuga leitud min_log_id on tühi, siis tekst: Logifailide tootmist pole veel alustatud kui logid < min_log_id, siis tekst: Liiga väike logid, selle tekkimise ajal faile veel ei toodetud AS Datel /226

134 kui logid > max_log_id, siis tekst: Liiga suur logid, selle kohta pole veel faili toodetud muul juhul tekst: Tundmatu põhjus 5.10 Objekti aadresside muudatuste päring Teenuse viimane versioon: ADSobjaadrmuudatused.v3 Teenuse kaudu saab väline infosüsteem teada, milliseid muudatusi on objekti aadressides tehtud etteantud ajavahemikus.. Eelkõige jälgitakse objekti ja aadressi seose teket, muutumist ja kadumist. Selliste objekti-aadressi seoste sündmuste lisaandmetena väljastatakse ka objekti enda sündmused samuti objekti järgnevusinfo, aadressi komponendid ning teised sama aadressiga seoses olevate objektide andmed. Teenuse kaudu ei tehta ettepanekuid aadressi muutmiseks. Väline infosüsteem, kes oma objekte ADS-le ei esita, kuid kes kasutab oma süsteemis koha-aadresse, saab selle teenuse kaudu teavet, millised aadressi muudatused on toimunud Sisend nimi andmetüüp kirjeldus Otsingu tingimused muudetudalates date Kuupäev alates millest (k.a) registreeritud muudatusi soovitakse leida muudetudpaevad integer Number vahemikust 1 10 mitme päeva muudatusi vastusesse soovitakse. Vaikimisi 1 päev. objektiliik string (2) Aadressiobjekti liigi kood klassifikaatorist, millega seotud muudatusi soovitakse. Vaikimisi kõik liigid logid integer Millisest LogId väärtusest suuremaid kirjeid otsitakse Vaikimisi 0 maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit. Tagastuse juhtimine objjarglased boolean True tagastab objekti eellased / järglased False ei tagasta objekti järgnevuse infot Vaikimisi false aadresskomp boolean True tagastab uue aadressi koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodaadressi ja ADR_ID-ga Vaikimisi false aadressiseosobjektid boolean True tagastab päringu hetkel kehtivad aadressiga seotud objektid False ei tagasta seosobjekte Vaikimisi false Väljund nimi andmetüüp kirjeldus logid integer Logikirje ID logstamp datetime Logikirje tekkimise aeg, muudatuse tegemise aeg, koos kellaajaga AS Datel /226

135 nimi andmetüüp kirjeldus syndmus string I(insert) objektile lisandus seos aadressiga (eelmisel objekti versioonil ei olnud seda aadressi), U(update) objekt muutis temaga seotud aadressi (eelmisel objekti versioonil oli sama koodiga kuid erineva ID-ga aadress), D(delete) objekti seos aadressiga kustus (eelmisel objekti versioonil oli seos, uuel ei ole enam) Objekti andmed objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris punktx double Objekti tsentroidipunkti x-koordinaat punkty double Objekti tsentroidipunkti y-koordinaat objektisyndmus string I(insert) aadress lisandus uuele objektile, ka objekt tekkis selle aadressi lisamise sündmuse ajal (võimalik ainult logikirje sündmuse I korral) D(delete) aadress eemaldati objektilt selle objekti tühistumise tõttu (võimalik ainult logikirje sündmuse D korral) U(update) objekt muutus või taastati aadressi lisamise või eemaldamise sündmuse käigus (võimalik logikirje sündmuste I, U ja D korral) eellased string Objekti võimalikeks eellasteks olevate objektide ADS_OID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Eelased tagastatakse päringu hetke seisuga, mitte logikirje tekkimise hetke seisuga. jarglased string Objekti võimalikeks järglasteks olevate objektide ADS_OID väärtuste loetelu. Loetelu eraldatud semikoolonitega. Järglased on võimalikud ainult tühistatud objektide korral. Järglased tagastatakse päringu hetke seisuga, mitte logikirje tekkimise hetke seisuga. unikaalne boolean Objekt on unikaalaadressi tunnusega Aadressi andmed koodaadress string Koodaadress adrid Int Aadressi unikaalne võti taisaadress string Normaliseeritud aadressitekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub vanaadrid Int Aadressi eelmise versiooni number muutmise korral vanataisaadress string Aadressi eelmine täielik nimekuju muutmise korral vanalahiaadress string Eelmine lähiaadress muutmise korral AS Datel /226

136 nimi andmetüüp kirjeldus Aadress koos komponentidega, kui telliti komponendid (logis adr_id aadressi komponendid, ka D sündmuse korral) adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega muudetudtase integer U ja D sündmuse korral selle taseme number vahemikust {1-8}, mis põhjustas aadressi muudatuse või tühistumise Aadressi seosobjektid (kui telliti), kui on mitu objekti, siis esineb mitu korda objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris unikaalne boolean Objekt on unikaalaadressi tunnusega Märkus: ühe objekti muudatuse käigus toimunud aadressi muudatused omavad sama LogStamp väärtust Funktsionaalsus Tulem tagastatakse log_id järjestuses. Kui etteantud ajavahemikus on rohkem muudatusi kui korraga tagastada võimalik, siis tuleb sama päringut korrata andes sisendisse kaasa viimase log_id väärtuse eelmise päringu tulemist. Kõik logikirjed on edastatud kui päringu vastus on tühi Tehniline täitmine Päring tehakse andmebaasi vaatest XT_ADOBAADR_LOG. AS Datel /226

137 Kiiruse huvides tuleb sellest vaatest küsida andmeid ainult log_id vahemiku alusel. Kõigepealt tuleb teada saada log_id vahemik. Selleks kutsuda välja baasiprotseduur TEENUSED.get_adobaadr_log_ids. Teenuse sisendid: ialates=>[muudetudalates] ikuni=>[muudetudkuni] (leitakse MuudetudAlates + MitmePaevaMuudatused) iadobliik=>[objektiliik] ilogid=>[logid] imaxarv=> korraga tagastatavate kirjete max arv, kas kasutaja poolt tellitud või süsteemi vaikimisi limiit Sama teenuse väljundparameetrid: oalateslogid log_id vahemiku algus okunilogid log_id vahemiku lõpp Kui emb-kumb väljundparameetritest on null (kontrollida võib ainult esimest) siis järelikult sisendis olevatele tingimustele vastavad logikirjed puuduvad ja võib tagastada kohe tühja tulemi, vaate poole pole üldse vaja pöörduda. Kui sisend oli vigane või ebapiisav, siis tekib tehniline viga. Kui log_id vahemik tagastati, siis teha päring vaatest ning where tingimuseks on log_id between oalateslogid and okunilogid. Kui tarbija soovis ainult 1 objektiliiki, siis lisandub tingimus AND l.adob_liik = [ObjektiLiik]. Tulemus järjestada log_id alusel. Andmevälja syndmus ja ObjektiSyndmus tõlgendatakse järgmiselt: I lisamine U - muutmine D - eemaldamine Teenus tagastab sündmuse kas sõnaliselt või kui tagastab sümboli, siis peab vastuse kirjelduses sisalduma sümbolite tõlgendus. Vaikimisi SELECT log_id, log_stamp, syndmus, adob_liik, ads_oid, adob_id, orig_tunnus, viitepunkt_x, viitepunkt_y, vers, olek, unik, objsyndmus, koodaadress, adr_id, taisaadress, lahiaadress, sihtnumber, asumi_nimi, vana_adr_id, vana_taisaadress, vana_lahiaadress Kui telliti aadress koos komponentidega, siis päringu select osasse lisada tase1_kood, tase1_nimi, tase1_nimi_pikk,., tase8_kood, tase8_nimi, tase8_nimi_pikk, muudetud_tase. Kui telliti objekti järgluse info, siis päringu select osasse lisada eelased, jarglased. Kui telliti ka aadressi seosobjektid, siis teha täiendav päring SELECT adr_id, adob_liik, ads_oid, adob_id, orig_tunnus, unik FROM adob_aadr WHERE olek in ( K, O, X ) and adr_id IN (<päringu tagastusse minev adr_id list>) Päringu tulem ühendada vastusega adr_id alusel. Ühe adr_id kohta võib tekkida 0 n seosobjekti. AS Datel /226

138 5.11 Objekti aadresside muudatuste päring failina Teenuse nimi: ADSobjaadrmuudatusedManus.v Sisend Nimi andmetüüp kirjeldus logid integer Millisest LogId väärtusest suuremaid logikirjeid otsitakse Sisendparameeter on kohustuslik. Tühja sisendi korral tehniline viga Väljund Nimi andmetüüp kirjeldus kirjetearv integer Tagastatavas logifailis sisalduvate kirjete arv. 0 kui faili ei tagastata puudumisepohjus text Tekstiline põhjendus faili puudumise kohta Teenus tagastab leitud logifaili teenuse manusena. Logifail sisaldab teenuse ADSobjaadrmuudatused tagastust maksimaalses ulatuses. Fail sisaldab: aadressi koos komponentidega aadressi seosobjektid objekti eellaseks olevate objektide ADS_OID väärtused loeteluna objekti järglaseks olevate objektide ADS_OID väärtused loeteluna (võimalik ainult tühistatud objekti korral) Faili struktuur ehk XSD vastab teenuse ADSobjaadrmuudatused vastuse struktuurile, vt täpsemalt Objekti aadresside muudatuste päring (ADSobjaadrmuudatused.v2) Väljund Funktsionaalsus Teenus tagastab eelnevalt ettevalmistatud logifaili, mis sisaldab sisendiks olevale logid väärtusele vahetult järgnevaid logikirjeid. Logifail toodetakse vahetult pärast logide avalikustamist, seega reeglina on 1 logifail 1 päeva muudatuste kohta, aga logifailis võib olla ka varasemaid ja/või hilisemaid muudatusi. Kui vastava logi kohta pole väljundit toodetud, siis on tagastus tühi. Kui tarbija küsib liiga varaseid logikirjeid, mille kohta pole veel faile tootma hakatud, siis on tagastus samuti tühi. AS Datel /226

139 Kui teenus faili ei tagasta, siis esineb tekstiline põhjendus nende puudumise kohta Tehniline täitmine Teenus teeb järgmise päringu SELECT id, file_content FROM xtee.xtee_logfiles WHERE log_table='adobaadr_log' AND file_date IS NOT NULL AND [logid + 1] BETWEEN log_id1 AND log_id2 Sellise päringuga saadakse alati 1 või 0 kirjet. Kui päring peaks tagastama rohkem kirjeid, siis tehniline viga, sel juhul on tegemist vigaste andmetega. Faili sisu tuleb andmeväljast file_content. Kui leitud kirjete arv on 0, siis tuleb leida põhjus, miks faili ei leitud. Faili puudumist ei käsitle teenus tehnilise veana. Teha täiendav päring SELECT min(log_id1) min_log_id, max(log_id2) max_log_id FROM xtee.xtee_logfiles WHERE log_table='adobaadr_log' AND file_date IS NOT NULL Parameeter puudumisepohjus väärtustada klassifitseeritud tekstiliste väärtustega, mille sisu peab olema vajadusel häälestatav. Vaikimisi luua klassifikaator alltoodud tekstidega. Parameetri puudumisepohjus väärtustamine järgmiselt: kui täiendava päringuga leitud min_log_id on tühi, siis tekst: Logifailide tootmist pole veel alustatud kui logid < min_log_id, siis tekst: Liiga väike logid, selle tekkimise ajal faile veel ei toodetud kui logid > max_log_id, siis tekst: Liiga suur logid, selle kohta pole veel faili toodetud muul juhul tekst: Tundmatu põhjus Tundmatu põhjus ei tohiks kunagi tekkida, sel juhul tuleb uurida mis juhtus Aadressteksti normaliseerimine Teenuse vana versioon ADSnormal.v1, ei sisalda aadressi koordinaate. Teenuse viimane versioon: ADSnormal.v2 Teenuse sisendiks on normaliseerimata või osaliselt normaliseeritud aadress. Teenus püüab normaliseerimata osa jagada komponentideks. Uusi komponente ei tekita, vaid AS Datel /226

140 kasutab olemasolevaid. Teeb ettepanekuid uute komponentide lisamiseks, kui teenuse kasutaja on ühtlasi ka ADS andmete esitajaks. Tagastab aadressi maksimaalselt normaliseeritud kujul. Kui normaliseerimine lõpuni ei õnnestunud, siis tagastab ka normaliseerimata jäänud osa tekstina Sisend Nimi andmetüüp kirjeldus Aadress adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega tekst string Aadressi normaliseerimata osa tekstilisel kujul objektiliik string Objekti liik, mille aadressi üritatakse normaliseerida. Vajalik initsialiseerivate tasandite tuvastamiseks. Eeldatakse, et sisendiks on 1 objekti aadressid. Teenuse sisendiks peab olema normaliseerimata aadressitekst. Selle teksti põhjal võib teenus toota ka rohkem kui 1 aadressi. Sel juhul on objektil paralleelaadressid. Aadressi algusosa võib olla esitatud ka osaliselt normaliseeritud kujul (näiteks EHAK tasemed normaliseeritud kujul, lähiaadressi osa normaliseerimata). Sellisel juhul arvestab teenus, et normaliseeritud osa kehtib ühtemoodi kõigile paralleelaadressidele, kui neid tekib. Kui soovitakse normaliseerida aadressi, mis pole konkreetse aadressiobjektiga seotud (näiteks isiku kontaktaadress), siis jäetakse objektiliik sisendis määramata. Samuti jäetakse objektiliik määramata, kui teenuse kasutaja ei soovi andmeid ADS-le esitama hakata. Objektiliigi määramine toob kaasa selle, et normaliseerija lubab lisada komponente ja ei tagasta viga, kui need süsteemist puuduvad. Täpsemalt loe nõuete kohta normaliseeritavale aadressitekstile pt 7.1Soovitused ja piirangud normaliseerimata aadressitekstile AS Datel /226

141 Väljund nimi andmetüüp kirjeldus Objekt taisaadress string Objekti normaliseeritud täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeerimata kujul optiaadress string Objekti normaliseeritud ja optimeeritud täisaadress, mis sisaldab kõiki paralleelaadresse, kus korduvad komponendid on ühekordselt lahiaadress string Objekti normaliseeritud lähiaadress stringina Aadress (paralleelaadresside korral mitu elementi) adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega tekst string Aadressi normaliseerimata osa tekstilisel kujul adrid integer Kui normaliseerimine õnnestus täielikult ja tegemist on olemasoleva (süsteemis registreeritud) aadressiga, siis selle aadressi id koodaadress string Kui normaliseerimine õnnestus täielikult ja tegemist on olemasoleva (süsteemis registreeritud) aadressiga, siis see koodaadress punktx punkty Funktsionaalsus double (min max ) double (min max Kui normaliseerimine õnnestus täielikult ja tegemist on olemasoleva (süsteemis registreeritud) aadressiga, siis selle aadressi esinduspunkti x-koordinaat Kui normaliseerimine õnnestus täielikult ja tegemist on olemasoleva (süsteemis registreeritud) aadressiga, siis selle aadressi esinduspunkti y-koordinaat Sisend ja väljund on ühesuguse struktuuriga. Olemasolevatele komponentidele tuleks sisendis viidata kas ainult koodiga (sel juhul leiab süsteem ise kehtiva nimekuju) või koodi ja nimega (sel juhul kontrollib süsteem, et nimi oleks komponendi juures kehtiv) või ainult nimega (sel juhul tuvastab süsteem ise kehtiva komponendi). Kui kehtivate komponentide tuvastamine ei õnnestu, siis tagastab teenus vea. AS Datel /226

142 Normaliseerimata osast toodetakse uusi komponente alates viimasest normaliseeritud kujul esitatud tasemest. Kui normaliseerija leiab, et nimetus võiks tasandile lisanduda, siis on tagastuses täidetud vastava tasandi nimi ilma koodita. Kui leiti klassifikaatorist olemasolev kehtiv komponent, siis on täidetud nii kood kui ka nimi. NB! Normaliseerida ei saa nende objektide aadresse, mis initsialiseerivad 1-5 tasandit (EHAK, väikekoht, liikluspind) Tehniline täitmine Sisendi põhjal lisada 1 kirje tabelisse temp_aadress. Objekti liik läheb protseduuri sisendiks. Kutsuda välja protseduur TEENUSED.normaliseerimine_xtee, mis tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral lisateade, vea korral veateade PikkAadress => pikk aadress optimeerimata kujul OptiAadress => objekti optimeeritud täisaadress Lahiaadress => objekti lähiaadress Vea korral on objekti andmed väärtustamata. Õnnestumise korral lugeda aadressid päringuga SELECT tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk, aadr_tekst, adr_id, koodaadress, viitepunkt_x, viitepunkt_y FROM temp_aadress. Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta Tühistatud objekti järglaste päring Teenuse nimi: ADSobjjarglased.v2 Teenuse kaudu on ADS süsteemiga liidestujatel võimalik pärida tühistatud aadressiobjekti loogiliseks järglaseks olevaid objekte. Asendavad objektid võivad tekkida ajaliselt hiljem ja seetõttu ei pruugi viited järglastele sisalduda objekti muudatuse logiteenuses. Teenuse sisendiks on tühistatud objekti ADOB_ID või ADS_OID. Teenuse tagastuseks on ADS süsteemis tuvastatud kehtivad järglased-objektid. Vaikimisi tagastatakse ainult objekti üldandmed. Tarbija saab tellida tagastusse objekti andmestiku. Lisaks saab juhtida, kas objekti aadressid tagastatakse koos komponentidega või ilma Sisend nimi andmetüüp kirjeldus Otsingu tingimused adobid integer Tühistatud objekti versiooni ID. Kui liidestuja seostab oma objekti adob_id-ga, siis saab selle alusel järglust küsida. Ei pea esitama, kui seos loodi ADS_OID alusel. AS Datel /226

143 nimi andmetüüp kirjeldus adsoid string (10) Objekti tunnus ADS süsteemis. Ignoreeritakse, kui adob_id on väärtustatud. Tagastuse juhtimine andmevektor string (3) Juhib objekti järglaste tagastust. Aadressi järglaste puhul ei oma tähtsust. Vaikimisi 000 Andmevektor on kolmest sümbolist koosnev string. Eraldi positsioonis sümbolitega tähistatakse, millised andmed teenus tagastab. Esimene positsioon tähistab objekti tärk-, teine ruumija kolmas aadressiandmeid. Pos 1 = 0 tärkandmeid ei tagasta Pos 1 = 1 tärkandmed Pos 2 = 0 ruumiandmeid ei tagasta Pos 2 = 1 ruumiandmed Pos 3 = 0 aadressiandmeid eraldi ei tagasta Pos 3 = 1 tagastab aadressid eraldi kirjetena aadresskomp boolean Parameetrit arvestatakse ainult siis, kui andmevektori 3. positsioonis on 1 True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodaadressi ja adr_id-ga Vaikimisi false Väljund Nimi andmetüüp kirjeldus Objekt - sisendis viidatud objekti järglane (mitme järglase korral on mitu elementi) objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris taisaadress string Objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse unikaalne boolean Objekt on unikaalaadressi tunnusega Objekti tärkandmed (tagastatakse siis, kui andmevektori 1.pos = 1) oiguslikalus string Versiooni tekkimise õiguslik alus kehtivusealgus date Versiooni andmete ADS süsteemis jõustumise kuupäev esitatud datetime Versiooni andmete ADS süsteemis jõustumise kuupäev Objekti ruumiandmed (tagastatakse siis, kui andmevektori 2.pos = 1) ruumikuju GML Aadressiobjekti kuju gml-na punktx double Tsentroidi x-koordinaat L-Est süsteemis (northing) AS Datel /226

144 Nimi andmetüüp kirjeldus punkty double Tsentroidi y-koordinaat L-Est süsteemis (easting) Objekti aadress. Paralleelaadresside korral on mitu elementi. (Tagastatakse ainult siis, kui päringutingimuses andmevektori 3. pos=1) adrid integer Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega Komponendid tagastatakse ainult siis, kui sisendparameetrites AadressKomp=true Funktsionaalsus Kui sisendiks on objekti versioonitunnus, aga see konkreetne versioon ei ole viimane, siis päring tagastab andmed viimase versiooni olekust lähtuvalt. Kui viimane versioon on tühistatud, siis võib talle leiduda järglasi, kui ADS on neid ärireeglitega tuvastanud. Kui ADS ei ole järglasi leidnud või kui objekti viimane versioon ei ole tühistatud, siis on tagastus tühi. AS Datel /226

145 Tehniline täitmine Päring tehakse andmebaasi vaatest XT_ADOB_JARGNEVUS. Kui sisendis on esitatud ads_oid ja ei ole esitatud adob_id, siis lisada where tingimus WHERE vana_ads_oid=<sisendis olev oid> Kui sisendis on esitatud adob_id, siis lisada where tingimus WHERE vana_ads_oid=(select ads_oid from aadress_objektid where adob_id=<sisendis olev adob_id>) Vaikimisi SELECT vana_adob_id, vana_ads_oid, adob_liik, ads_oid, adob_id, orig_tunnus, taisaadress, lahiaadress, unik. Kui on tellitud objekti tärkandmed, siis lisada päringu select osasse tekkimise_alus, kehtiv_alates, kehtiv. Kui on tellitud objekti ruumiandmed, siis lisada päringu select osasse ruumikuju, viitepunkt_x, viitepunkt_y. X ja Y pöörata väljundis ümber,st TsentroidiX=viitepunkt_y ja TsentroidiY=viitepunkt_x. Kui on tellitud järglaste aadressid, siis teha täiendav päring SELECT adob_id, adr_id, koodaadress, taisaadress, lahiaadress, seose_x,seose_y, tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi,tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk,tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi,tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk,tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi,tase8_nimi_pikk, sihtnumber, asumi_nimi FROM adob_aadr WHERE adob_id IN (<päringu tagastusse minev adob_id list>) Päringu tulem ühendada vastusega adob_id alusel. Ühe adob_id kohta võib tekkida 0 n aadressi. Komponendid lugeda sisse ainult sel juhul, kui nad on tellitud Tühistatud aadressi järglaste päring Teenuse nimi: ADSaadrjarglased.v2 Teenuse kaudu on ADS süsteemiga liidestujatel võimalik pärida tühistatud aadressi loogiliseks järglaseks olevaid aadresse. Asendavad aadressid võivad tekkida ajaliselt hiljem ja seetõttu ei pruugi viited järglastele sisalduda aadressi muudatuse logiteenuses. Teenuse sisendiks on tühistatud aadressi ADR_ID. Teenuse tagastuseks on ADS süsteemis tuvastatud kehtivad järglased aadressid. Aadressile lisaks saab tarbija tellida ka aadressiga seotud objektide andmed Sisend Nimi andmetüüp kirjeldus Otsingu tingimused adrid integer Tühistatud aadressi ID Tagastuse juhtimine AS Datel /226

146 Nimi andmetüüp kirjeldus objekt boolean True tagastatakse ka aadressiga seotud aadressiobjektide andmed.. False seotud objektide andmeid ei lisata vastusesse Vaikimisi False aadresskomp boolean True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodaadressi ja adr_id-ga Vaikimisi false Väljund nimi andmetüüp kirjeldus Aadress (mitme järglase korral on mitu elementi) adrid integer Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadressitekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega Aadressiga seotud objekt (kui telliti ka objekti andmed) Kui aadressiga on seotud mitu objekti, siis on mitu elementi. AS Datel /226

147 nimi andmetüüp kirjeldus objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris unikaalne boolean Objekt on unikaalaadressi tunnusega Komponendid tagastatakse ainult siis, kui sisendparameetrites AadressKomp=true Funktsionaalsus Tehniline täitmine Päring tehakse andmebaasi vaatest XT_AADR_JARGNEVUS. Päringule lisada where tingimus WHERE vana_adr_id= <sisendis olev adr_id> Vaikimisi SELECT vana_adr_id, vana_koodaadress, adr_id, koodaadress, taisaadress, lahiaadress, sihtnumber, asumi_nimi, viitepunkt_x, viitepunkt_y. X ja Y pöörata väljundis ümber: Punkt_x= viitepunkt_y ja Punkt_y= viitepunkt_x Kui telliti aadress koos komponentidega, siis päringu select osasse lisada tase1_kood, tase1_nimi, tase1_nimi_pikk,., tase8_kood, tase8_nimi, tase8_nimi_pikk. Kui telliti ka aadressi seosobjektid, siis teha täiendav päring SELECT adr_id, adob_liik, ads_oid, adob_id, orig_tunnus, unik FROM adob_aadr WHERE olek in ( K, O, X ) and adr_id IN (<päringu tagastusse minev adr_id list>) Päringu tulem ühendada vastusega adr_id alusel. Ühe adr_id kohta võib tekkida 0 n seosobjekti Ruumiaadressi päring Teenuse nimi: ADSruumiaadress.v1 Teenuse kaudu on võimalik ADS süsteemist küsida kujule vastavaid ruumiaadresse. Sisendiks on kas ruumikuju gml-formaadis või punkti koordinaadid numbritena. Tagastuses on ruumiaadressid koos osakaaludega Sisend Nimi andmetüüp kirjeldus Otsingu tingimused ruumikuju GML Ruumikuju GML formaadis punktx punkty double (min max ) double (min max Punkti x-koordinaat Punkti y-koordinaat AS Datel /226

148 Nimi andmetüüp kirjeldus ainultsuurim boolean True tagastab ainult suurima osakaaluga ruumiaadressi False tagastab kõik ruumiaadressid, kus osakaal > 0 Vaikimisi false Ruumikuju olemasolul numbrilisi x ja y koordinaate ei arvestata Väljund nimi andmetüüp kirjeldus Ruumiaadressid aadress string Ruumiaadress tekstilisel kujul adstase1 kood string Olemasoleva komponendi kood nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus_liigiga string Komponendi nimi koos liiginimega osakaal decimal Ruumiaadressi osakaalu % täpsusega 2 kohta peale koma Funktsionaalsus Tehniline täitmine Ruumikuju gml-st moodustada eelnevalt geometry objekt. Näiteks kasutada funktsiooni interop.jgeom_utils.gml_to_geometry(gml). Kutsuda välja protseduur TEENUSED.leia_ruumiaadressid_xtee. Teenuse sisendis olevad X ja Y pöörata väljakutsumisel ümber. Kui protseduur lõpetab, siis lugeda aadressid päringuga SELECT taisaadress, tase1_kood, tase1_nimi_pikk, tase2_kood, tase2_nimi_pikk, tase3_kood, tase3_nimi_pikk, jrknr AS osakaal FROM temp_aadress Pärast lugemist teha alati rollback temp-tabeli tühjendamiseks Liidestujate aadresside tagasiside teenus Teenuse nimi: ADSadrTagasiside.v2 Teenuse kaudu saavad ADS süsteemiga liidestunud registrid, kes ise ei ole aadressimäärajad, vaid ainult tarbijad, anda tagasidet enda süsteemis registreeritud aadresside kohta, mis võivad olla ADS aadressiga seotud või sidumata. Tagasiside saamine on oluline ADS-i andmekvaliteedi tõstmiseks. Teenuse kaudu laekuva info alusel saavad omavalitsused teada milliste aadressidega on nt seotud elanike elukohad rahvastikuregistris ja millised probleemid on aadresse tarbivatel registritel ADS andmetega. Seotud aadressi korral antakse tagasisidena teada adr_id. Sidumata aadressi korral tekst, mis võib olla ka osaliselt normaliseeritud. Normaliseeritud osad võivad olla esitatud ADS komponendi koodidena (näiteks EHAK koodid on paljudel tarbijatel teada) või siis tekstina. Näiteks kui tarbijal on aadress, milles sisaldub kindlasti tänava AS Datel /226

149 nimi, kuid ADSis pole sellenimelist tänavat, siis võib selle tänava esitada 5. taseme komponendi nimetusena ja majanumber 7. tasemel, selle asemel, et esitada tänav ja majanumber normaliseerimata tekstina. Kuid kui tarbija ei hoia oma süsteemis aadresse struktureeritud kujul, vaid tavalise tekstina, siis võib ta need ka niiviisi esitada. Omavalitsuse ülesanne on tagada vastava aadressi määramine või andmete esitajale tagasiside andmine, et sellist aadressi ei ole ning ei ole ka võimalik määrata, seega tuleb tarbivas registris see aadress viia vastavusse ADSis olevate andmetga Sisend Nimi andmetüüp kirjeldus Objekt / aadress (mitme aadressi korral mitu elementi) register string (10) Registri liik klassifikaatorist. Igale teenust kasutavale registrile eraldatakse oma kood, mille ta esitamisel kaasa annab. Klassifikaator on järgmine: RR Rahvastikuregister; AR äriregister; KR kinnistusraamat, EP Eesti Post. Kohustuslik idregistris string (50) Aadressi omava objekti identifikaator. Peab olema andmeid esitava registri piires unikaalne. Kohustuslik tyhistatud boolean True esitatav objekt on andmeid esitavas registris tühistatud või kustutatud False esitatav objekt on kehtiv (vaikimisi false) SeostPoleVaja boolean True esitatav liidestuja objekt ei eelda seost ADS süsteemiga ei aadressi ega objekti osas False esitatav objekt peaks ühilduma ADS andmetega (vaikimis false) markus string(1000) Selgitav kirjeldus liidestuja objekti kohta adrid integer ADS süsteemiga seotud aadressi unikaalne identifikaator ADS süsteemis. Seotud aadressidel on see identifikaator teada. adstase1 kood string ADS komponendi kood nimetus string Komponendi nimi koos liiginimega adstase2 kood string ADS komponendi kood nimetus string Komponendi nimi koos liiginimega adstase3 kood string ADS komponendi kood nimetus string Komponendi nimi koos liiginimega adstase4 kood string ADS komponendi kood nimetus string Komponendi nimi koos liiginimega või lühendiga adstase5 kood string ADS komponendi kood nimetus string Komponendi nimi koos liiginimega või lühendiga adstase6 kood string ADS komponendi kood nimetus string Komponendi nimi adstase7 kood string ADS komponendi kood nimetus string Komponendi nimi adstase8 kood string ADS komponendi kood nimetus string Komponendi nimi punktx double (min Objekti asukohta väljendava punkti x-koordinaat L-Est süsteemis max ) punkty double (min Objekti asukohta väljendava punkti y-koordinaat L-Est süsteemis max aadrtekst string (1000) Aadressi normaliseerimata osa tekstina sihtnumber string Aadressi juurde kuuluv Eesti Posti sihtnumber AS Datel /226

150 Nimi andmetüüp kirjeldus Seotud aadressiobjektid ( võib olla mitu seost) adobid integer Objekti versioonitunnus ADS süsteemis Ei pea esitama, võib ka esitada ainult ads_oid-i. Oleneb kumb on liidestujal olemas. adsoid string Objekti ADS süsteemi kood Kui liidestuja kasutab ainult adob_id väärtust ja esitab tagasisidena selle, siis ei pea ads_oid-i esitama. Ignoreeritakse, kui adob_id on olemas. Sisendis tuleb esitada 1 pöördumises korraga 1 objekti andmed. Kui liidestuja on oma objekti sidunud mitme aadressiga, siis esineb sisendis andmerühm Objekt/aadress mitu korda. Kui esitatakse ADSga seotud aadress, siis piisab ainult adr_id väärtusest, ülejäänu jääb tühjaks. Kui esitatakse ADSga seostamata aadress, mille algus on normaliseeritud kujul, siis esitada kas komponendi kood või nimetus mõlemat pole vaja. Koodi olemasolul on eelistatum see. Kui esitatakse kood, siis peab see kood esinema ADS süsteemis, muidu viga esitamisel. Kood võib olla ka tühistatud, sel juhul viga pole. Kui esitatakse komponendi nimetus, siis ei pea see esinema ADS süsteemis. Esitamine õnnestub ka siis, kui ADSis ei ole vastaval tasemel sellenimelist komponenti. Tekstina tuleb esitada see osa aadressist, mis ei ole tasemetele jagatud. Näiteks kui EHAK osa on esitatud tasemete kaupa, siis need EHAK tasemete nimetused ei tohiks sisalduda normaliseerimata tekstis. Liidestuja objektiga seotud aadressiobjektid tuleb esitada eraldi elemendina. Ka neid võib esineda mitu. Kui logi esitav register on RR ja logis on täidetud märkuse väli väärtusega ADS_ADR_ID või ADS_OID (ilma muude sümbolite ja tühikutetea, suurtähtedega), siis toimub erikäsitlus: 1) kui logis antud ID-registris väärtusega RR objekt esineb ADS andmetes (st on kehtiv, kuna tühistatud seoseid ADS ei säilita), siis antud logi töödeldakse tavapäraselt. 2) kui logis antud ID-registris väärtusega RR objekti ADS andmetes ei esine, siis antud logi ignoreeritakse ja ei töödelda üldse Väljund nimi andmetüüp kirjeldus tulem tulem string 1 - õnnestumise korral ; 0 vea korral teade string Positiivse vastuse korral puudub, negatiivse vastuse korral veateade Tagasiside esitatud aadressi kohta - kuna esitada võib mitu aadressi, siis võib ka seda elementi olla mitu (vastavalt esitamise järjekorrale) idregistris string Liidestuja objekti ID AS Datel /226

151 nimi andmetüüp kirjeldus adrid integer Sisendis edastatud adr_id. Tühi, kui edastati normaliseerimata aadress. probleem string Tühi, kui esitatud aadressiga probleeme ei olnud. Näiteid võimalikest probleemidest: Ei normaliseeru (kui esitati normaliseerimata aadress) Vananenud (esitati ADS aadress, mille olek on vananenud) Tühistatud (esitati ADS aadress, mille olek on tühistatud) Esitatud aadressitekst normaliseerub. (kui normaliseerimine õnnestub) asendavadrid integer Kui esitati normaliseerimata aadress ja selle normaliseerimine õnnestus, siis selle normaliseeritud aadressi adr_id Tühi, kui esitati normaliseeritud aadress või kui ADS ei oska asendust pakkuda. asendavkoodaadress string Kui esitati normaliseerimata aadress ja selle normaliseerimine õnnestus, siis selle normaliseeritud aadressi koodaadress asendavtaisaadress string Kui esitati normaliseerimata aadress ja selle normaliseerimine õnnestus, siis selle normaliseeritud aadressi täisaadress Asendava aadressiga seotud aadressiobjektid siin tuuakse ära kõik vastava aadressiga (ADR_ID-ga) seotud objektid - st element võib esineda mitu korda objektiliik string Objekti liigi nimi klassifikaatorist adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris unikaalne boolean Objekt on unikaalaadressi tunnusega Tagasiside esitatud aadressiobjekti kohta - kuna esitada võib mitu aadressiobjekti, siis võib ka seda elementi olla mitu (vastavalt esitamise järjekorrale) adobid integer Sisendis edastatud adob_id adsoid string Sisendis edastatud ADS_OID probleem string Tühi, kui esitatud seosega probleeme ei olnud Näiteid võimalikest probleemidest: Vananenud (esitati adob_id, milline versioon on vananenud) Tühistatud (esitati adob_id või ads_oid, mis viitab tühistatud objektile) Ei sobi aadressiga (esitati adob_id või ads_oid, mis ei sobi mitte ühegagi esitatud aadressidest, kui näiteks normaliseerimise tulemusena leiti aadress) asendavadobid integer ADS süsteemi poolt seoseks väljapakutava objekti adob_id Ei tagastata kunagi, jääb alati tühjaks asendavadsoid string ADS süsteemi poolt seoseks väljapakutava objekti ads_oid Ei tagastata kunagi, jääb alati tühjaks Teenuse X-tee ver 6-le üleviimisel eemaldati väljundist 2 andmevälja: asendavadobid ja asendavadsoid. Need pole kunagi andmeid tagastanud, sest lisati algselt teenuse struktuuri igaks juhuks tuleviku jaoks. Asenduste tagastamiseks on tehtud eraldi aadressisoovituste teenus. Kui ADS süsteem tuvastab liidestuja poolt esitatud andmetes probleeme, siis see ei tähenda, et esitamine oleks ebaõnnestunud. ADS süsteem salvestab need andmed, AS Datel /226

152 mida liidestuja esitas, täpselt sellisel kujul nagu ta esitas. Kogu lisandunud info on ainult ADS poolne ettepanek liidestujale tema andmekvaliteedi parandamiseks. Kui liidestuja selle ettepaneku arvesse võtab ja oma andmetes muudatuse teeb, siis tuleks muudetud seis liidestuja poolt uuesti ADSi esitada. Nii saab ADS teada, et liidestuja on ka tegelikkuses ettepanekud arvesse võtnud Funktsionaalsus Tehniline täitmine Teenus ühendub tootmissüsteemi andmebaasiga (prod-rac). Rakendus kirjutab esitatud andmed ümber andmebaasi temp-tabelitesse. Objekt / aadress kirjed tabelisse TEMP_AADRESS: adr_id, tase1_kood, tase1_nimi... tase8_kood, tase8_nimi, aadr_tekst, viitepunkt_x, viitepunkt_y, sihtnumber, jrknr täita aadressi järjekorranumbriga sisendis, et oleks võimalik tagastus anda samas järjestuses. Seotud aadressiobjektid kirjutada tabelisse TEMP_ADOB. adob_id, ads_oid. Kui sisendis tyhistatud=true, siis ei pea seotud aadresse ega aadressiobjekte olema. Kutsuda välja protseduur TEENUSED.huviobjekti_esitamine_v2. Sisendiks olevad andmed lugeda esimesest objekt/aadress kirjest, kui neid on mitu: iregister iregid ityhistatud (true=1, false=0) ispvtunnus (true=1, false=0) imarkus Protseduur tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral tühi, vea korral veateade Õnnestumise korral lugeda tagastus järgmiselt. Objekt / aadress kirjed päringuga SELECT id_registris, adr_id, asendav_adr_id, asendav_koodaadress, asendav_taisaadress, asendus_ok FROM huvi_objaadr WHERE register=<register sisendist> AND id_registris=<id registris sisendist> ORDER BY huviadr_id. Probleem küsida baasifunktsioonist huviobj_meetodid.kontrolli_vead_a(huvi_objaadr.huviobj_id). Asendava aadressi andmed (asendavadrid, asendavkoodaadress, asendavtaisaadress) edastada teenuse tagastusse ainult sel juhul, kui asendus_ok = 1. Muul juhul jäävad teenuse tagastuses tühjaks. Kui teenuse tagastusse lähevad asendava aadressi andmed (asendus_ok = 1), siis küsida selle aadressiga seotud objektid rubriiki Asendava aadressiga seotud aadressiobjektid järgmise päringuga: SELECT adob_liik,ads_oid,adob_id,orig_tunnus,unik FROM adob_aadr WHERE adr_id=[ asendavadrid] AND kehtetu IS NULL Rubriiki Tagasiside esitatud aadressiobjekti kohta küsida andmed päringuga SELECT huvi_adob.adob_id, huvi_adob.ads_oid FROM huvi_objektid, huvi_adob WHERE huvi_objektid.huviobj_id=huvi_adob.huviobj_id AND register=<register sisendist> AND id_registris=<id registris sisendist> ORDER BY huviadob_id. AS Datel /226

153 Probleem küsida baasifunktsioonist huviobj_meetodid.kontrolli_vead_o(huvi_objaadr.huviobj_id) Liidestujate aadressisoovituste teenus Teenuse nimi: ADSadrTagasisideSoovitused.v2 Teenuse kaudu saavad need ADS süsteemiga liidestunud registrid, kes ise ei ole aadressimäärajad, kuid kes on andnud tagasidet ADSi oma registris kasutuselevõetud aadresside kohta, soovitusi aadresside parandamiseks. Näiteks kui liidestuja süsteemis on liidestuja objektil normaliseerimata aadress ning ta on sellest ADS süsteemile teada andnud, siis on aadressimäärajail võimalik soovitada, millist aadressi selle normaliseerimata aadressi asemel tuleks kasutada. Vastavate soovituste andmise võimalus on välja arendatud ADS menetlusrakenduses. Nende soovituste edastamiseks ongi mõeldud käesolev x-tee teenus Sisend nimi andmetüüp kirjeldus Otsingu tingimused muudetudalates date Kuupäev alates millest (k.a) registreeritud muudatusi soovitakse leida muudetudpaevad integer Number vahemikust 1 10 mitme päeva muudatusi vastusesse soovitakse. Vaikimisi 1 päev. logid integer Millisest LogId väärtusest suuremaid kirjeid otsitakse Vaikimisi 0 maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit. register string (10) Registri liik klassifikaatorist. Igale teenust kasutavale registrile eraldatakse oma kood, mille ta esitamisel kaasa annab. Näiteks RR Rahvastikuregister; AR äriregister; KR kinnistusraamat vms. Kohustuslik aadresskomp boolean True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false Väljund Nimi andmetüüp kirjeldus logid integer Logikirje ID logstamp datetime Logikirje tekkimise aeg, muudatuse tegemise aeg, koos kellaajaga syndmus string I(insert) objekti või aadressi soovitus lisati, D(delete) soovitatud objekt või aadress eemaldati register string Registri liik klassifikaatorist. idregistris string Liidestuja objekti ID Objekt (vastuses 0-1 element) andmed on täidetud, kui logikirje puudutab objekti soovitamise sündmust. Soovituse eemaldamisel on täidetud ainult ADS-OID AS Datel /226

154 Nimi andmetüüp kirjeldus adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis objektiliik string Aadressiobjekti liigi tunnus. origtunnus string Objekti identifikaator andmeid esitavas registris. aadress string Objekti optimeeritud täisaadress, mis sisaldab kõiki paralleelaadresse unikaalne boolean Objekt on unikaalaadressi tunnusega olek char(1) K kehtiv; T tühistatud Aadress (vastuses 0 1 element). andmed on täidetud, kui logikirje puudutab aadressi soovitamise sündmust. Soovituse eemaldamisel on täidetud ainult ADR_ID adrid Int Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega AS Datel /226

155 Funktsionaalsus Tulem tagastatakse log_id järjestuses. Kui etteantud ajavahemikus on rohkem muudatusi kui korraga tagastada võimalik, siis tuleb sama päringut korrata andes sisendisse kaasa viimase log_id väärtuse eelmise päringu tulemist. Kõik logikirjed on edastatud kui päringu vastus on tühi Tehniline täitmine Teenus ühendub tootmissüsteemi andmebaasiga (prod-rac). Päring tehakse andmebaasi vaatest XT_HUVISOOV_LOG. Where-tingimusse lisatakse kasutaja poolt esitatud parameetrid: AND l.log_stamp >= [MuudetudAlates] AND l.log_stamp < [MuudetudKuni] (leitakse MuudetudAlates + MitmePaevaMuudatused) AND l.log_id > [LogId] AND l.register = [Register] Andmevälja syndmus tõlgendatakse järgmiselt: I lisamine D tühistamine Vaikimisi päring SELECT log_id, log_stamp, syndmus, register, id_registris, ads_oid, adob_id, adob_liik, orig_tunnus, obj_taisaadress, unik, olek, adr_id, koodaadress, taisaadress, lahiaadress, sihtnumber, asumi_nimi FROM xt_huvisoov_log. Kui sooviti aadressi koos komponentidega, siis lisada aadressi päringu select-osasse tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk 5.18 ADS gazetteer otsing Teenuse nimi: ADSgazetteerotsing.v1 Selle teenuse vahendusel on võimalik kasutada IN-ADS aadresside päringuid üle X- tee. Teenuse sisendiks on aadresstekst. Väljundiks kuni 50 aadressi koos viitega seotud objektile. Tulemused on objektipõhised (ehak, ehitised-hooned, katastriüksused). Tagastatakse korter, kui sisendaadress oli korter Sisend Nimi andmetüüp kirjeldus aadresstekst string Aadressitekst AS Datel /226

156 Väljund Nimi andmetüüp kirjeldus Leitud aadressid (0 kuni 10) ads_oid string Aadressiobjekti identifikaatori väärtus (versiooniülene) adob_id string Aadressiobjekti identifikaatori väärtus tunnus string Aadressiobjekti tunnus unik string (väärtus 0 või 1) Tegemist on unikaalaadressinõudega objektiga liikval string Aadressobjekti gazetteer liigi nimetus (EHAK, TANAV, VAIKEKOHT, KATASTRIYKSUS, EHITISHOONE) liik string Aadressiobjekti gazetteer liik (1, 2, B, 4, E) adr_id string Aadressi tehniline identifikaator ADS's koodaadress string Aadressi moodustavate klassifikaatorite koodidest moodustatud kood pikkaadress string Aadressiobjekti täisaadress aadresstekst string Aadressiobjekti aadress ehakmk string Maakonna kood ehakov string Omavalitsuse kood ehak string Asustusüksuse kood boundingbox string Aadressiobjekti BoundingBox ehk aadressiobjekti mahutav ristküliku kujuline kast viitepunkt_x string Aadressiobjekti viitepunkti x koordinaat viitepunkt_y string Aadressiobjekti viitepunkti y koordinaat onkort string Kas aadressiobjektil on kortereid kort_nr string Korteri number kort_ads_oid string Korteri aadressiobjekti identifikaatori väärtus (versiooniülene) kort_adob_id string Korteri adob_id kort_orig_tunnus string Korteri tunnus kort_unik string (väärtus 0 või 1) Tegemist on unikaalaadressinõudega korteriga kort_adr_id string Aadressi tehniline identifikaator ADS's tehn_id2 string Tehniline id AS Datel /226

157 Nimi andmetüüp kirjeldus old_aadresstekst string Aadressiobjekti kehtetu lühiaadress 5.19 Log-Id väärtuste päringuteenus Teenuse nimi: logiinfo.v1 Uued manusepõhised logiteenused nõuavad sisendiks alati log_id väärtust ehk järjehoidjat, millest edasi logi lugeda. Neil tarbijail, kes täna enda juures vastavat järjehoidjat ei oma, peab olema võimalus see algväärtustada. Selle jaoks luuakse veel üks päringuteenus, mille kaudu on võimalik järjehoidjat kuupäeva alusel leida. Uus teenus luuakse ADS andmekogusse Sisend Nimi andmetüüp kirjeldus muudetudalates date Kuupäev alates millest (k.a) registreeritud muudatusi soovitakse leida Sisendparameeter on kohustuslik. Tühja sisendi korral tehniline viga Väljund nimi andmetüüp kirjeldus Logiteenuste hulk teenusenimi string X-tee logiteenuse nimetus logid integer Millisest LogId väärtusest suuremaid logisid on vaja lugeda ehk see logid väärtus, mis vastava teenuse sisendiks tuleks anda. Sama logid väärtus sobib ka manusepõhistele logiteenustele. Teenus tagastab infot järgmiste logiteenuste kohta: ADSkompklassif ADSobjmuudatused ADSaadrmuudatused ADSobjaadrmuudatused kylogi AS Datel /226

158 Funktsionaalsus Teenus tagastab loetletud X-tee teenuste sisendiks sobivad logid väärtused. Samad väärtused sobivad ka *Manus lõpuga teenuste sisendiks Tehniline täitmine Iga teenuse kohta tuleb teha eraldi päring Teenus ADSkompklassif SELECT MIN(log_id) log_id FROM ( SELECT min(log_id)-1 log_id FROM ads.adkomp_log WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT komp_log_id FROM public_logid) UNION ALL SELECT min(log_id)-1 log_id FROM ads.adkomp_log2 WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT komp_log_id FROM public_logid) UNION ALL SELECT komp_log_id FROM public_logid ); Teenus ADSobjmuudatused SELECT MIN(log_id) log_id FROM ( SELECT min(log_id)-1 log_id FROM ads.adob_log WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT adob_log_id FROM public_logid) UNION ALL SELECT min(log_id)-1 log_id FROM ads.adob_log2 WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT adob_log_id FROM public_logid) UNION ALL SELECT adob_log_id FROM public_logid ); Teenus ADSaadrmuudatused SELECT MIN(log_id) log_id FROM ( SELECT min(log_id)-1 log_id FROM ads.aadr_log WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT aadr_log_id FROM public_logid) UNION ALL SELECT min(log_id)-1 log_id FROM ads.aadr_log2 WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT aadr_log_id FROM public_logid) UNION ALL SELECT aadr_log_id FROM public_logid ); Teenus ADSobjaadrmuudatused SELECT MIN(log_id) log_id FROM ( AS Datel /226

159 SELECT min(log_id)-1 log_id FROM ads.adobaadr_log WHERE log_stamp >= [muudetudalates] AND log_id <= (SELECT adobaadr_log_id FROM public_logid) UNION ALL SELECT adobaadr_log_id log_id FROM public_logid ); Teenus kylogi SELECT MIN(log_id) log_id FROM ( SELECT min(log_id)-1 log_id FROM ateenus.ky_muutus WHERE log_stamp >= [muudetudalates] UNION ALL SELECT MAX(log_id) log_id FROM ateenus.ky_muutus ); 5.20 Ajaloolise aadressiobjekti otsing Teenuse nimi: ADSobjajalooline.v2 Teenus võimaldab otsida aadressiobjekte ka ajalooliste andmete alusel. Kui sisendiks olevatele tingimustele vastab objekti ajalooline versioon, siis tagastab teenus selle ning lisaks ka objekti kehtiva versiooni, kui kasutaja on nii tellinud. Kui objektil puudub kehtiv versioon, siis viimast tühistatud versiooni tagastusse ei lisandu. Kui tingimustele vastab sama objekti mitu ajaloolist versiooni, siis tagastab teenus nad kõik eraldi kirjetena. Teenus ei ole mõeldud mitte kõigi tingimustele vastavate objektide leidmiseks, vaid ainult kuni 100 esimese vaste saamiseks. Kui tingimustele vastab rohkem kui 100 versiooni, siis tuleks päringut täpsustada Sisend nimi andmetüüp Kirjeldus Objekti otsingu tingimused origregister string (10) Objekti liigi päritoluregistri tunnus objektiliik string (2) Aadressiobjekti liigi tunnus adsoid string (10) Objekti tunnus ADS süsteemis. origtunnus string (20) Objekti tunnus päritoluregistris. adobid integer Objekti versioonitunnus lahiaadress string (1000) Lähiaadressi või selle osa tekstilisel kujul. AS Datel /226

160 nimi andmetüüp Kirjeldus lahiaadresstapne boolean True otsitakse täpset vastet sisestatud lähiaadressile. Otsing on tõstutundlik. False toimub tekstiotsing sisestatud sõnade alusel. Leitakse objektiversioonid, mille lähiaadressis sisalduvad kõik sisendis olevad sõnad. Vaikimisi false. aadresstekst string (1000) Täisaadress või selle osa tekstilisel kujul. Toimub tekstiotsing sisestatud sõnade alusel. Leitakse objektiversioonid, mille täisaadressis sisalduvad kõik sisendis olevad sõnad. aadressteksttapne boolean True otsitakse täpset vastet sisestatud täisaadressile. Otsing on tõstutundlik. False toimub tekstiotsing sisestatud sõnade alusel. Leitakse objektiversioonid, mille täisaadressis sisalduvad kõik sisendis olevad sõnad. Vaikimisi false. Tagastuse juhtimine andmevektor string (3) Vaikimisi 000 Andmevektor on kolmest sümbolist koosnev string. Eraldi positsioonis sümbolitega tähistatakse, millised andmed teenus tagastab. Esimene positsioon tähistab objekti tärk-, teine ruumija kolmas aadressiandmeid. Pos 1 = 0 tärkandmeid ei tagasta Pos 1 = 1 tärkandmed Pos 2 = 0 ruumiandmeid ei tagasta Pos 2 = 1 ruumiandmed Pos 3 = 0 aadressiandmeid eraldi ei tagasta Pos 3 = 1 tagastab aadressid eraldi kirjetena Kehtib ainult päringutingimustele vastava versiooni kohta. aadresskomp boolean Parameetrit arvestatakse ainult siis, kui andmevektori 3. positsioonis on 1 True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false Kehtib ainult päringutingimustele vastava versiooni kohta. kakehtivvers boolean True tagastab ajaloolise versiooni puhul ka kehtiva versiooni False kehtiv versioon tagastusse ei lisandu Vaikimisi false maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit Väljund nimi andmetüüp kirjeldus Objektiversioon (kordub vastavalt leitud vastete arvule) adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis origtunnus string Objekti tunnus originaalregistris aadress string Objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul AS Datel /226

161 nimi andmetüüp kirjeldus lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse unikaalne boolean Objekt on unikaalaadressi tunnusega kehtiv datetime Versiooni andmete ADS süsteemis jõustumise kuupäev ja kellaaeg kehtetu datetime Versiooni andmete ADS süsteemis kehtetuks muutumise kuupäev ja kellaaeg versstaatus string kehtiv tegemist on päringu hetkel kehtiva versiooniga, andmeväli kehtetu on sel juhul tühi tühistatud tegemist on päringu hetkel tühistatud versiooniga, andmeväli kehtetu on täidetud, objektist ei leidu värskemat versiooni ajalooline tegemist on ajaloolise versiooniga, millest leidub ka värskemaid versioone. Objekt tervikuna on kehtiv, kui päringu hetkel leidub tema kohta kehtiv versioon. Objekt tervikuna on tühistatud, kui päringu hetkel tema kohta kehtivat versiooni ei leidu. Objekti tärkandmed (tagastatakse siis, kui andmevektori 1.pos = 1) tekkimisealus string Versiooni tekkimise õiguslik alus sulgemisealates string Versiooni lõppemise õiguslik alus Objekti ruumiandmed (tagastatakse siis, kui andmevektori 2.pos = 1) ruumikuju GML, geojson, wkt Objekti geomeetria tellitud formaadis Aadress. Paralleelaadresside korral on mitu elementi. (Tagastatakse ainult siis, kui päringutingimuses andmevektori 3. pos=1) adrid Int Aadressi unikaalne võti koodaadress string(33) Koodaadress. NB! Koodaadressi viimased 4 kohta (pos 30-33) on ajas muutuvad. Ajalooliste aadresside puhul võib väärtus olla midagi muud kui 0000 Tarbijatel on soovitav koodaadressi viimast 4 kohta mitte arvestada koodaadresside võrdlemisel. taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub aadresskehtiv boolean True aadress (aadressiversioon) on päringu hetkel kehtiv. False aadress (aadressiversioon) on päringu hetkel kehtetu. punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 kood string Olemasoleva komponendi kood AS Datel /226

162 nimi andmetüüp kirjeldus nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega Kehtiv versioon sama objekti kohta. (Tagastatakse ainult siis, kui tagastuses on ajalooline versioon ja sisendis on tellitud kehtiva versiooni lisamine ja kehtiv versioon leidub ) adobid integer Objekti versioonitunnus ADS süsteemis aadress string Objekti täielik tekstiline aadress, mis sisaldab kõiki paralleelaadresse pikal optimeeritud kujul lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse unikaalne boolean Objekt on unikaalaadressi tunnusega kehtiv datetime Versiooni andmete ADS süsteemis jõustumise kuupäev ja kellaaeg Kehtiva versiooni aadressid. Paralleelaadresside korral on mitu elementi. (Tagastatakse ainult siis, kui päringutingimuses andmevektori 3. pos=1) adrid Int Aadressi unikaalne võti koodaadress string(33) Koodaadress. NB! Koodaadressi viimased 4 kohta (pos 30-33) on ajas muutuvad. Ajalooliste aadresside puhul võib väärtus olla midagi muud kui 0000 Tarbijatel on soovitav koodaadressi viimast 4 kohta mitte arvestada koodaadresside võrdlemisel. taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress sihtnumber integer Aadressile omistatud sihtnumber (postiindeks) mapiirkond string Mitteametliku piirkonna nimetus, millesse aadress kuulub punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega AS Datel /226

163 nimi andmetüüp kirjeldus adstase3 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 kood string Olemasoleva komponendi kood nimetus string Komponendi nimi ilma liiginimeta nimetus_liigiga string Komponendi nimi koos liiginimega Funktsionaalsus Kõik sisendis olevad parameetrid saab omistada baasiprotseduuri TEENUSED.ADOB_OTSING_AJAL sisendiks. Kasutaja poolt määramata parameetrid edastatakse vaikimisi väärtustega v.a MaxArv. Kui see on määramata, siis protseduurile edastada null. Boolean väärtused edastada protseduurile kujul 1-true/ 0-false. Protseduur TEENUSED.ADOB_OTSING_AJAL tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral tühi, vea korral veateade Kui protseduur lõpetas positiivselt, siis tuleb andmed küsida järgmiste päringutega. Objektide andmed: SELECT ads_oid, adob_id, orig_tunnus, taisaadress, lahiaadress, unik, kehtiv, kehtetu, olek FROM temp_adob Olek tõlkida versstaatuseks järgmiselt: K kehtiv T tühistatud V ajalooline Unik tõlkida järgmiselt: 1 true 0 või null - false Kui sooviti ka tärkandmeid (kui andmevektori 1.pos = 1), siis lisada päringu selectosasse tekkimise_alus, sulgemise_alus. Kui sooviti ka ruumiandmeid (kui andmevektori 2.pos = 1), siis lisada päringu selectosasse geometry. Kui sooviti ka aadresse (kui andmevektori 3.pos = 1), siis teha eraldi päring aadresside kohta. Aadresse võib iga objekti kohta olla rohkem kui 1. Seos tekib adob_id kaudu. AS Datel /226

164 SELECT adob_id, adr_id, koodaadress, taisaadress, lahiaadress, sihtnumber, asumi_nimi, aadr_olek, seose_x, seose_y FROM adob_aadr WHERE adob_id in (SELECT adob_id FROM temp_adob). Punkti x ja y pöörata väljundis ümber, selliselt et X väärtus oleks 7 kohta ja Y väärtus 6 kohta. Aadr_olek tõlkida järgmiselt K true T või V - false Kui sooviti aadressi koos komponentidega, siis lisada aadressi päringu select-osasse tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk Kui sooviti ka objekti kehtivat versiooni (kakehtivvers = true), siis teha eraldi täiendav päring. Igal objektil saab olla kuni 1 kehtiv versioon, see võib ka puududa. Seos tekib ADS_OID kaudu: SELECT adob_id, ads_oid, taisaadress, lahiaadress, unik, kehtiv FROM adob_kehtiv WHERE ads_oid IN (SELECT ads_oid FROM temp_adob WHERE olek='v'). Kui sooviti ka kehtiva versiooni aadresse (kakehtivvers = true ja andmevektori 3.pos = 1), siis teha eraldi päring kehtiva versiooni aadresside kohta. Aadresse võib iga objekti kohta olla rohkem kui 1. Seos tekib adob_id kaudu. SELECT adob_id, adr_id, koodaadress, taisaadress, lahiaadress, sihtnumber, asumi_nimi, seose_x, seose_y FROM adob_aadr WHERE adob_id in (kehtivate versioonide adob_id loetelu). Kui sooviti aadressi koos komponentidega (kakehtivvers = true ja andmevektori 3.pos = 1 ja aadresskomp = true), siis lisada aadressi päringu select-osasse tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk 5.21 Aadressiobjekti esitamine Teenuse kaudu esitavad päritoluregistrid oma objektidega seotud muudatusi ADS põhisüsteemi. Varem oli sellel teenusel ka X-Tee liides. Pärast seda, kui tekkis ADS menetlussüsteem ning EHR hakkas esitama muudatusi menetluse kaudu, kadus vajadus X-Tee kasutamiseks, kuna teised päritoluregistrid KNR ja e-kataster asuvad ADS-ga samas andmebaasis. KNR esitab väikekohtade ja liikluspindade muudatusi. E-Kataster esitab EHAK objektide muudatusi ning katastriüksuste ruumikuju topoloogilisi korrektiive, mis AS Datel /226

165 registreeritakse ADS-is versiooniparandusena ning ei põhjusta objektist uue versiooni tekkimist Sisend nimi andmetüüp kirjeldus Esitaja EsitajaKood string (10) Andmete esitajale ADS poolt väljastatud kood. Vajalik selleks, et ADS saaks kontrollida, kas objekt laekub õigest andmeallikast. Kohustuslik Objekt ObjektiLiik string (2) Aadressiobjekti liigi tunnus klassifikaatorist. Kohustuslik ADS_OID string (10) ADS süsteemis olemasoleva objekti tunnus. Ei ole kohustuslik ja uute objektide korral ei saagi olla. Võidakse esitada kui on tegemist objekti muudatusega ja ADS_OID on päritoluregistril teada. Orig_tunnus string (20) Objekti identifikaator andmeid esitavas registris. Näiteks ehitisregistri kood. Kohustuslik Adob_id number Objekti versioonitunnus ADS süsteemis. Täidetud ainult siis, kui soovitakse esitada aadressiobjekti andmete versiooniparandust. OiguslikAlus string (500) Objekti versiooni tekkimise õiguslik alus. Viit õugusaktile. Kohustuslik KehtivuseAlgus date Objekti andmete versiooni kehtivise alguse kuupäev. Ei saa olla tuleviku kuupäev, sest ADS-i ei huvita tulevikus kehtima hakkavad andmed. Kohustuslik. SulgemiseAlus string (500) Objekti kui terviku kehtetuks muutmise põhjus. Viit õugusaktile. KehtivuseLopp date Objekti andmete kehtivuse lõpu kuupäev. Täidetud ainult siis, kui esitatakse teade objekti kehtetuks muutumisest. Peab olema mineviku või jooksev kuupäev. Ruumikuju GML Objekti Ruumikuju GML formaadis Kohustuslik (erandiks on EHR objektid mis on ADS-i kantud migratsiooniga ja mille andmeid soovitakse muuta, uue EHR objekti korral on kohustuslik) Aadress (paralleel aadresside korral esitatakse kõik tema aadressid) ADSTase1 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase2 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase3 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase4 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase5 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase6 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase7 Kood string (4) Olemasoleva komponendi kood AS Datel /226

166 nimi andmetüüp kirjeldus Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega ADSTase8 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ilma liiginimeta Nimetus_liigiga string (300) Komponendi nimi koos liiginimega Punkt_x double (min Aadresspunkti x-koordinaat L-Est süsteemis max ) Punkt_y double (min Aadresspunkti y-koordinaat L-Est süsteemis max Tekst string (1000) Aadressi normaliseerimata osa tekstilisel kujul Sisendiks saab olla korraga ainult 1 aadressiobjekti andmed Väljund nimi andmetüüp kirjeldus tulem ADSTulem string 1 - õnnestumise korral ; 0 vea korral ADSTeade string Teenuse tekstiline teade. Positiivse vastuse korral lisainfo, negatiivse vastuse korral veateade Objekt (olemas, kui salvestamine õnnestus) ADS_OID string Objekti ADS süsteemi kood Adob_id integer Objekti versioonitunnus ADS süsteemis Aadress string Objekti optimeeritud täisaadress, mis sisaldab kõiki paralleelaadresse Lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse Aadress (olemas, kui salvestamine õnnestus). Paralleelaadresside korral on mitu elementi ADR_ID Int Aadressi unikaalne võti Koodaadress string Koodaadress Taisaadress string Normaliseeritud aadresstekst Lahiaadress string Normaliseeritud lähiaadress Protseduur TEENUSED.esitamine tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral lisateade, vea korral veateade ADS_OID => objekti ADS_OID Adob_id => objekti versioonitunnus Aadress => objekti täisaadress Lahiaadress => objekti lähiaadress Vea korral on objekti andmed väärtustamata. AS Datel /226

167 Õnnestumise korral lugeda aadressid päringuga SELECT adr_id, koodaadress, taisaadress, lahiaadress FROM temp_aadress. Aadressi probleemid lugeda päringuga SELECT vana_adr_id, vea_tekst, taisaadress FROM teavitus_log WHERE ads_oid=[objekti ADS_OID] Funktsionaalsus Kohustuslikud andmed tehakse kindlaks äriloogiliselt meetodi sees ning nende puudumisel tagastab teenus vea. Kui sisendis on esitatud Adob_id, siis eeldab teenus, et soovitakse esitada aadressiobjekti versiooniparandust. Otsitakse aadressiobjekti versiooni. Selle mitteleidmisel tagastab teenus vea. Leidumisel toimub aadressiobjekti versiooniparandus > Kui Adob_id pole esitatud, siis otsitakse objekti liigi ja Orig_tunnus alusel. Kui objekti ei leitud, siis toimub aadressiobjekti lisamine > Kui leiti ja objektist eksisteerib kehtiv versioon, siis toimub aadressiobjekti versioonimine > Kui leiti ja objektist eksisteerib kehtetu versioon, siis toimub aadressiobjekti taastamine > Kui sisendis on esitatud SulgemiseAlus ja KehtivuseLopp, siis eeldab teenus, et soovitakse aadressiobjekti tühistada. Otsitakse objekti kehtivat versiooni objekti liigi ja Orig_tunnus alusel. Kui leiti, siis toimub aadressiobjekti tühistamine > Kui ei leitud, siis viga Mitteametlike piirkonde esitamine Mitteametlike piirkondade haldamine toimub KNR süsteemis. KNR süsteem edastab piirkondade lisamise, muutmise ja kustutamise infot ADSi. Kuna KNR suhtleb ADS-ga andmebaasi tasandil, siis on kõige otstarbekam realiseerida piirkondade esitamine andmebaasi teenusena. Teenuse kaudu edastab KNR kõigi lisatud, muudetud või kustutatud piirkondade andmed ADSi. Analoogselt esitatakse täna väikekohtade ja liikluspindade infot. Teenuse sisendiks on ühe piirkonna andmed. Sisendi struktuur sarnaneb üldjoontes struktuuriga andmebaasis: tunnus nimi aadress liik geometry ala ruumikuju kustutatud 1 jah, null - ei ADS süsteem kontrollib tunnuse alusel, kas vastav objekt on juba registreeritud või mitte. Kui ei ole, siis objekt lisatakse, kui on olemas, siis muudetakse kõik tema andmed. Kui on tegemist piirkonna kustutamisega ehk sisendis on kustutatud=1, siis ei pea teised atribuudid, sh ala ruumikuju, olema täidetud. Kui on, siis ignoreerib süsteem esitatud andmeid. Teenuse väljund: AS Datel /226

168 tunnus, kas esitamine õnnestus õnnestumise korral informatiivne teade, vea korral veateade Viga tekib, kui teenuse sisend ei ole korrektne. Piirkonna ruumikuju peab olema korrektne polügoon, võib koosneda lahustükkidest ja sisaldada auke. Kõik tärkandmed peavad olema määratud. Aadress + nimi peavad kokku moodustama unikaalse kombinatsiooni, st, et samal aadressil ei saa esineda 2 sama nimega piirkonda. Teenus logib piirkonnaga tehtud muudatuse järeltöötluse tarbeks. 6. Menetlussüsteemi teenused Menetlussüsteemi X-tee teenused ei ole mõeldud avalikuks kasutamiseks. Need on orienteeritud andmeid esitavatele originaalregistritele (EHR või Maaregister), kuid samuti ka neile kohalikele omavalitsustele, kes soovivad aadresside halduse realiseerida oma infosüsteemis ning edastada andmed ADS süsteemi. Teenused on suunatud neile andmeesitajaile, kes ei soovi kasutada ADS menetlussüsteemi kasutajaliidest, vaid soovivad selle liidese ise teha ja ADS-ga automaatselt andmeid vahetada. 6.1 Menetlusobjekti aadresside esitamine Teenus: ADSmenadresit.v1. Teenuse kaudu saab väline infosüsteem (EHR või Maaregister) esitada aadressimuudatusi nende objektide kohta, mille muutmine tavapäraselt toimub ainult menetlussüsteemi kaudu. Teenuse kaudu saab esitada korraga 1 või mitme objekti andmed. Esitatakse koos aadressidega, mis on kohustuslikud. Võivad olla ka uued, ADSs varem registreerimata objektid. Selle teenuse kaudu ei ole võimalik lisada ADS süsteemis registreeritud, kuid ilma päritolu registri seoseta objektile tunnust. Tunnus on selle teenuse kaudu esitamisel kohustuslik ning objektide olemasolu kontrollitakse tunnuse kaudu. ADS-OID ei ole kohustuslik Sisend Teenuse sisendis olevad väärtused EsitajaKood ja Menetleja_nimi võib välja lugeda ka teenuse soap-ümbrikust (asutus ja ametnik). Kui aga teenuse väljakutse on realiseeritud selliselt, et ametnik on alati konstant ja mitte reaalne isikukood, siis ei sobi see lahendus (EHR-s on see täna nii). Teiseks ei ole hea rakenduses avalikult eksponeerida isikukoode. Menetleja_nimi salvestub andmete juurde muutja nimena ja näidatakse ADS rakenduses välja. Seetõttu oleks otstarbekam edastada menetleja nimi teenuse andmetes, sest teenust tohib nagunii kasutada ainult päritoluregistris tuvastatud isik. AS Datel /226

169 Nimi andmetüüp kirjeldus Esitaja (esineb teenuses 1 kord) esitajakood string (10) Registrit pidava organisatsiooni registrikood. Organisatsioon peanb olema Maa-ameti admin süsteemis eelnevalt registreeritud. Organisatsioonist saab X-tee kaudu loodava menetluse menetleja. Kohustuslik menetlejanimi string(11) Andmeid menetleva kasutaja täisnimi või isikukood. Kohustuslik menetluseliik integer 1 muutmine (vaikimisi) 2 parandamine Väärtustele vastavad konkreetsed menetluse liigid on häälestatavad süsteemi parameetrites. Vaikimisi 1 ainultkontroll boolean Vaikimisi false True väärtuse korral menetlust ei jõustata, vaid kustutatakse menetlus pärast kontrollide teostamist. menetlusnr integer Kui see parameeter on täidetud, siis eeldatakse olemasoleva menetluse staatuse päringut. Objekti andmeid pole vaja esitada. Teenus tagastab viidatud menetluse andmestiku. Objekt (võib esineda mitu, vähemalt 1 objekt on kohustuslik, maksimaalne hulk on piiratud parameetriga vaikimisi 1000) objektiliik string (2) Aadressiobjekti liigi tunnus klassifikaatorist. Kohustuslik adsoid string (10) ADS süsteemis olemasoleva objekti tunnus. Ei ole kohustuslik ja uute objektide korral ei saagi olla. Võidakse esitada kui on tegemist objekti muudatusega ja ADS_OID on päritoluregistril teada. orig_tunnus string (20) Objekti identifikaator andmeid esitavas registris. Kohustuslik oiguslikalus string (500) Objekti versiooni tekkimise või tühistamise õiguslik alus. alusekuupaev date Õigusliku aluse kuupäev. olek char(1) O ootel; K kehtiv; T tühistatud Kohustuslik tahis string(200) Hoone osa korral tähis, hoone korral üldnimetus Kohustuslik hoone osa korral. korrus integer Hoone osa korral sissepääsu korrus Kohustuslik hoone osa korral ruumikuju GML Objekti Ruumikuju GML formaadis Kohustuslik vähemalt punktina kujumoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud Kohustuslik, kui esitatakse ruumikuju hooneadsoid string (10) Ainult hoone osa korral vajalik atribuut. Viide hoone ADS_OID väärtusele, kui see on teada. Ei ole kohustuslik ja uute objektide korral ei saagi olla. Võidakse esitada kui on tegemist objekti muudatusega ja ADS_OID on päritoluregistril teada. hooneorigtunnus string (20) Ainult hoone osa korral kohustuslik atribuut. Viide hoone tunnusele, mille osaga on tegemist. Aadress (kuulub objekti juurde, võib esineda mitu, kui on paralleelaadressid) adstase1 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi koos liigisõnaga adstase2 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi koos liigisõnaga adstase3 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi koos liigisõnaga adstase4 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi koos liigisõna lühendiga AS Datel /226

170 Nimi andmetüüp kirjeldus Nimetus_liigiga string (300) Komponendi nimi koos pika liigisõnaga adstase5 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi koos liigisõna lühendiga Nimetus_liigiga string (300) Komponendi nimi koos pika liigisõnaga adstase6 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi Pyhendusnimi boolean Vaikimisi false. True, kui tegemist on pühendusnimega Kohanimi boolean Vaikimisi false. True, kui tegemist on kohanimega adstase7 Kood string (4) Olemasoleva komponendi kood Nimetus string (200) Komponendi nimi ehk number adstase8 Kood string (4) Olemasoleva komponendi kood punktx punkty Nimetus string (200) Komponendi nimi ehk number double (min max ) double (min max Aadresspunkti x-koordinaat L-Est süsteemis Aadresspunkti y-koordinaat L-Est süsteemis Väljund Kui ADSTulem näitab õnnestumist, aga Joustatud on tühi, siis tegelikult andmeid ei jõustatud, vaid ainult märgiti jõustamisvalmiks. Sellest räägib ka tagastatav ADSTeade. Sellisel juhul on ka Menetlus_nr tagastuses alati olemas. Sellises olukorras peaks andmeid esitav register jätma meelde menetluse numbri ning arvestama, et jõustamine tegelikult ei ole toimunud. Originaalregister ei tohi oma tegevusega lõpuni minna, sest muudatused ei ole ADS-s registreeritud, vaid peab jätma protsessi ootele. Nüüd peaks originaalregister soovi korral pöörduma uuesti sama teenuse poole koos Menetlus_nr väärtusega. Andmeid uuesti esitada pole vaja. Seda võib teha seni kui ükskord teenuse tagastuses sisaldub ka Joustatud kuupäev. Sel hetkel saab lugeda andmed ADS-s jõustunuks. Kui teenuse poole pöörduti koos Menetlus_nr väärtusega ja see tagastab ebaõnnestumise tunnuse, siis tähendab see, et erimenetleja on selle menetluse tühistanud. Andmed tuleb ikkagi parandada teenuse kasutajal ja esitada uuesti. Kui ADSTulem näitab ebaõnnestumist, siis ei sobi esitatavad andmed ADS süsteemi, need tuleb parandada ja uuesti esitada. Ka negatiivse tulemi korral on vastuses näha menetluse nr, objektid, aadressid ja probleemid, mis teenusel õnnestus tekitada. Kui midagi ei õnnestunud, siis on vastus tühi. Tekkinud viga näitab ADSTeade. Nimi andmetüüp kirjeldus tulem (vastuses 1 kord) tulem string 1 - õnnestumise korral ; 0 vea korral teade string Teenuse tekstiline teade. Positiivse vastuse korral lisainfo, negatiivse vastuse korral veateade menetlusnr biginteger Loodud menetluse number joustatud datetime Menetluse jõustamise aeg koos kellaajaga. Kui puudub, siis pole menetluse jõustamine õnnestunud AS Datel /226

171 Nimi andmetüüp kirjeldus Objekt (vastuses võib esineda mitu, puudub, kui menetluse loomine ebaõnnestus) objektiliik string (2) Aadressiobjekti liigi tunnus. adobid integer Objekti versioonitunnus ADS süsteemis adsoid string Objekti ADS süsteemi kood origtunnus string (20) Objekti identifikaator andmeid esitavas registris. oiguslikalus string (500) Objekti versiooni tekkimise või tühistamise õiguslik alus. alusekuupaev date Õigusliku aluse kuupäev. olek char(1) O ootel; K kehtiv; T tühistatud tahis string(200) Hoone osa korral tähis, hoone korral üldnimetus korrus integer Hoone osa korral sissepääsu korrus ruumikuju GML Objekti Ruumikuju GML formaadis kujumoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud hooneadsoid string (10) Ainult hoone osa korral. Viide hoone ADS_OID väärtusele. taisaadress string Objekti optimeeritud täisaadress, mis sisaldab kõiki paralleelaadresse lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse Aadress (objektiga seotud element). Paralleelaadresside korral on mitu elementi Tagatud on sama aadresside järjekord nagu sisendis adrid Int Aadressi unikaalne võti koodaadress string Koodaadress taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta AS Datel /226

172 Nimi andmetüüp kirjeldus Nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega Objekti probleemid, mis takistavad jõustamist (objektiga seotud ekement) Mitme probleemi korral mitu elementi. Kui jõustamine õnnestus, siis probleemid puuduvad. aadress string See täisaadress, millega on probleeme, võib puududa, kui probleem ei puuduta otseselt aadressi veakood integer Vea kood klassifikaatori veatekst string Probleemi tekstiline kirjeldus markus string Probleemile erimenetleja poolt lisatud selgitus Funktsionaalsus Kui sisendis on määratud Menetlus_nr, siis soovitakse tagasisidet salvestunud menetluse kohta ja ei tehta uut esitamist. Sellisel juhul minnakse kohe väljundi lugemise juurde. Sisendis esitatud objektide andmed kirjutada baasi temporary tabelisse TEMP_ADOB. Ruumikuju gml-st moodustada eelnevalt geometry objekt. Näiteks kasutada salvestamise hetkel funktsiooni interop.jgeom_utils.gml_to_geometry(gml). Iga objekti adob_id väärtuseks kirjutada selle objekti järjekorranumber sisendis, et oleks võimalik seostada esitatud aadressidega. Seejärel kirjutada esitatud aadressid temporary tabelisse TEMP_ADOBAADR. Adob_id väärtuseks panna objekti järjekorranumber sisendis olevate objektide hulgas, adr_id väärtuseks kirjutada selle aadressi järjekorranumber selle objekti juures. Väljundis on tarvis tagada, et tagastatavad aadressid oleks samas järjekorras nagu sisendis esitatud. Seejärel pöörduda baasiprotseduuri MEN_TEENUSED.ESITAMINE poole. Kui see protseduur tagastab oadstulem = +, siis on õnnestumine, muul juhul ebaõnnestumine. Kui teenuse tagastuses sisaldub omenetlusid, siis teha andmebaasi päring enne commiti või rollbacki (commiti võib ka enne teha, aga rollbaci mitte, muidu pole andmeid mida lugeda.) Väljundi lugemine Menetluse andmed tabelist men_menetlus lugeda omenetlusid alusel. AS Datel /226

173 Kui men_menetlus.joustaja on tühi, siis on menetluse jõustamisvalmidus tühistatud. Sel juhul omistada teenuse väljundis: ADSTulem = 0 ADSTeade = ADS menetlus on tühistatud Menetlus_nr = omenetlusid Joustatud = null Kui men_menetlus.joustamise_aeg on täidetud, siis on menelus jõustatud. Sel juhul omistada teenuse väljundis: ADSTulem = 1 ADSTeade = ADS menetlus on jõustatud Menetlus_nr = omenetlusid Joustatud = men_menetlus.joustamise_aeg Kui men_menetlus.joustaja on täidetud ja joustamise_aeg tühi, siis on memetlus jätkuvalt ootel. Omistada teenuse väljundis: ADSTulem = 0 ADSTeade = ADS teade: leidub menetluse jõustamist takistavaid probleeme Menetlus_nr = omenetlusid Joustatud = null Kõigil juhtudel lugeda ka ülejäänud andmed. Objektide andmed (menob_id on sisemiseks seostamiseks, väljundisse pole vaja panna, ülejäänud omistada järjekorras objektide väljundisse, geometry muuta gml-ks) SELECT o.menob_id, o.ads_oid, o.tulem_adob_id, o.adob_liik, o.orig_tunnus, nvl(o.oiguslik_alus,m.oiguslik_alus) oiguslik_alus, nvl(o.oiguslik_kp,m.oiguslik_kp) oiguslik_kp, o.olek,o.tahis, o.sissepaasu_korrus,o.geometry, o.kuju_moodustusviis, (SELECT ads_oid FROM men_objektid WHERE menob_id=o.hoone_menob_id) hoone_oid, o.taisaadress, o.lahiaadress FROM men_objektid o, men_menetlus m WHERE o.menetlus_id=[tagastatatud omenetlusid] AND m.menetlus_id=o.menetlus_id Aadresside andmed (lugeda kas eraldi iga objekti kohta või siis korraga 1 päringuga ja seostada objektiga menob_id alusel ) SELECT menob_id, adr_id, koodaadress, taisaadress, lahiaadress, viitepunkt_x, viitepunkt_y, tase1_kood, tase1_nimi, tase1_nimi_pikk, tase2_kood, tase2_nimi, tase2_nimi_pikk, tase3_kood, tase3_nimi, tase3_nimi_pikk, tase4_kood, tase4_nimi, tase4_nimi_pikk, tase5_kood, tase5_nimi, tase5_nimi_pikk, tase6_kood, tase6_nimi, tase6_nimi_pikk, tase7_kood, tase7_nimi, tase7_nimi_pikk, tase8_kood, tase8_nimi, tase8_nimi_pikk FROM men_aadressid WHERE menetlus_id=[tagastatatud omenetlusid] AND nvl(seos_objektiga,'0')<>'d' ORDER BY menadr_id Probleemid (lugeda kas eraldi iga objekti kohta või siis korraga 1 päringuga ja seostada objektiga menob_id alusel) SELECT p.menob_id, a.taisaadress, p.vea_kood, p.vea_tekst, p.markus FROM men_probleemid p, men_aadressid a WHERE p.menetlus_id=[tagastatatud omenetlusid] AND p.menadr_id=a.menadr_id(+) AND p.staatus='p' AND p.vea_kood IN ( SELECT vea_kood FROM men_liigivead WHERE menliik_kood=(select menliik_kood AS Datel /226

174 FROM men_menetlus WHERE menetlus_id=[tagastatatud omenetlusid])) Pärast väljundi lugemist commit õnnestumisel ja rollback ebaõnnestumisel. 6.2 Menetlusobjekti otsing Teenus: ADSmenobjotsing.v1.xsd Teenus on mõeldud ADS põhiregistris registreeritud menetlusobjektide andmete päringuks. Erinevus aadressiobjekti otsingu teenusega seisneb selles, et käesolev teenus töötab tootmissüsteemi andmestikul, mitte esitlussüsteemi andmestikul nagu kõik ülejäänud teenused töötavad. Põhisüsteemist tagastab ootel, kehtivas ja tühistatud seisundis (eraldi tellimisega) olevate objektide viimaseid versioone. Lisaks on võimalik eraldi tunnusega otsida ka jõustamata menetlustes sisalduvaid objekte. Menetlustest otsimisel tuleb aga silmas pidada, et andmed võivad olla poolikult registreeritud. Näiteks puudub uutel aadressidel koodaadress, sest see omistatakse alles põhiregistrisse kirjutamisel, aadressi tasemetel võivad puududa koodid. Samuti võib puududa objektil kuju või aadress. Teksti alusel aadressi otsing kasutab põhiregistris täistekstindeksit (otsitakse kõigi sisestatud sõnade sisaldumist aadressi tekstis), aga menetluses mitte (otsitakse sisestatud fragmendi sisaldumist aadressis täpsel samal kujul). Teenus ei ole mõeldud analüütiliste päringute sooritamiseks ega väljavõtete tegemiseks, vaid konkreetse hulga, ühe või mitme objekti andmete laadimiseks Sisend nimi andmetüüp kirjeldus Otsingu tingimused objektiliik [string (2)] massiiv Aadressiobjekti liigi tunnus, valik kõigi liikide hulgast adsoid string (10) Objekti tunnus ADS süsteemis. origtunnus string (20) Objekti tunnus päritoluregistris. xkoord double (min Aadressipunkti x-koordinaat L-Est süsteemis max ) ykoord double (min Aadressipunkti y-koordinaat L-Est süsteemis max ) ulatus integer Päringutingimuseks oleva ala ruudu pool külje pikkust meetrites. Vaikimisi 0. Väärtusega arvestatakse ainult koordinaatide olemasolu korral. Sisestust tuleb piirata, et ei tehtaks liiga suurt ruumifiltrit, max lubatud number on 1000 aadresstekst string (1000) Koha-aadress või selle osa tekstilisel kujul etakid bigint Objektile ETAK süsteemis omistatud tunnus otsimenetlusest boolean Vaikimisi false ehk otsitakse põhisüsteemist. Kui true, siis otsitakse jõustamata menetlustest otsityhistatud boolean True - Tagastab ka tühistatud objektide viimase versiooni False tühistatuid ei tagasta Vaikimisi false AS Datel /226

175 nimi andmetüüp kirjeldus Aadress komponentide kaupa - komponentide alusel toimub täpne ja tõstutundlik otsing, st komponendi nimetus peab olema esitatud täpsel kujul adrtase1 string (300) 1. taseme komponendi nimetus adrtase2 string (300) 2. taseme komponendi nimetus adrtase3 string (300) 3. taseme komponendi nimetus adrtase4 string (300) 4. taseme komponendi nimetus adrtase5 string (300) 5. taseme komponendi nimetus adrtase6 string (300) 6. taseme komponendi nimetus adrtase7 string (300) 7. taseme komponendi nimetus adrtase8 string (300) 8. taseme komponendi nimetus adrtase1_kood string (300) 1. taseme komponendi kood adrtase2_kood string (300) 2. taseme komponendi kood adrtase3_kood string (300) 3. taseme komponendi kood adrtase4_kood string (300) 4. taseme komponendi kood adrtase5_kood string (300) 5. taseme komponendi kood adrtase6_kood string (300) 6. taseme komponendi kood adrtase7_kood string (300) 7. taseme komponendi kood adrtase8_kood string (300) 8. taseme komponendi kood koodaadress string(33) Koodaadress või selle algus Tagastuse juhtimine tarkandmed boolean True tagastab tärkandmete osa False ei tagasta Vaikimisi false ruumiandmed boolean True tagastab ruumiandmete osa False ei tagasta Vaikimisi false aadresskomp boolean True tagastab aadressid koos viidetega komponentidele False tagastab aadressid ainult tekstilisel kujul koos koodi ja aadressi identifikaatoriga Vaikimisi false probleemid boolean True tagastab objektiga seotud aktuaalsed (tühistamata) probleemid False probleeme ei tagasta Vaikimisi false markused boolean True tagastab objektiga seotud tühistatud probleemid ja märkused False märkusi ei tagasta Vaikimisi false maxarv integer Tagastatav kirjete max arv. Vaikimisi süsteemi poolt kehtestatud limiit. AS Datel /226

176 Kõik sisendis olevad parameetrid saab omistada baasiprotseduuri MEN_TEENUSED.MENOB_OTSING sisendiks. Kasutaja poolt määramata parameetrid edastatakse vaikimisi väärtustega. Boolean väärtused edastada protseduurile kujul 1-true/ 0-false. Punkti x ja y tuleb pöördumise hetkel ümber pöörata. Objekti liigid edastada komaga eraldatud stringide massiivina, ülakomasid pole tarvis kasutada Väljund nimi andmetüüp kirjeldus Objekt (tulemis sisaldub objektide hulk) adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS põhisüsteemis või menetlussüsteemis, olenevalt kummast päriti objektiliik string (2) Aadressiobjekti liigi tunnus. origtunnus string (20) Objekti identifikaator andmeid esitavas registris. etakid bigint Objektile ETAK süsteemis omistatud tunnus olek char(1) O ootel; K kehtiv; T tühistatud taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress menetlusnr biginteger Menetluse nr, kui päring tehti menetlusüsteemist Objekti tärkandmed (objektiga üheselt seotud andmerühm) tagastatakse, kui vastavad andmed on tellitud oiguslikalus string (500) Objekti versiooni tekkimise või tühistamise õiguslik alus. oiguslikualusekp date Õigusliku aluse kuupäev. tahis string(200) Hoone osa korral tähis, hoone korral üldnimetus korrus integer Hoone osa korral sissepääsu korrus hooneadsoid string (10) Ainult hoone osa korral. Viide hoone ADS_OID väärtusele. Objekti ruumiandmed (objektiga üheselt seotud andmerühm) tagastatakse, kui vastavad andmed on tellitud ruumikuju GML Objekti Ruumikuju GML formaadis kujumoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud Aadress (objektiga mitmeselt seotud element). Paralleelaadresside korral on mitu elementi Tagastatakse alati, aga koos komponentidega ainult siis, kui on tellitud. adrid Int Aadressi versioonitunnus põhiregistris või menetlussüsteemis, olenevalt kummast päring tehti. AS Datel /226

177 nimi andmetüüp kirjeldus koodaadress string Koodaadress Menetlusest otsingul võib puududa taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress punktx double Aadressipunkti x-koordinaat punkty double Aadressipunkti y-koordinaat adstase1 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase2 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase3 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase4 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase5 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase6 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase7 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega adstase8 Kood string Olemasoleva komponendi kood Nimetus string Komponendi nimi ilma liiginimeta Nimetus_liigiga string Komponendi nimi koos liiginimega Objekti probleemid ja märkused (objektiga seotud ekement) Mitme probleemi korral mitu elementi aadress string See aadress, millega on probleeme. Võib puududa, kui probleem ei käi otseselt aadressi kohta staatus char(1) P - aktuaalne probleem; M - mitteaktuaalne probleem või märkus veakood integer Vea kood klassifikaatori veatekst string Probleemi tekstiline kirjeldus markus string Probleemi selgitus või mitteaktualiseerimise põhjendus. Lihtsalt märkus, kui probleemi polegi Funktsionaalsus Protseduur MEN_TEENUSED.MENOB_OTSING tagastab järgmised väljundparameetrid: ADSTulem => + õnnestumine; või null viga ADSTeade => õnnestumise korral tühi, vea korral veateade AS Datel /226

178 Kui tekkis viga, siis tagastada see teade tehnilise veana päring ebaõnnestub. Õnnestumisel lugeda leitud objektid tabelist TEMP_ADOB. Õigusliku aluse osa lugeda nii nvl(sulgemise_alus,tekkimise_alus) oiguslik_alus, nvl(kehtiv_kuni,kehtiv_alates) oiguslik_kp Seotud aadressid lugeda tabelist TEMP_ADOBAADR. X ja Y pöörata tagastamise hetkel ümber. Probleemid ja märkused (lugeda kas eraldi iga objekti kohta või siis korraga 1 päringuga ja seostada objektiga adob_id alusel) Probleemid põhiregistrist (NOT OtsiMenetlusest AND Probleemid) SELECT p.adob_id, a.taisaadress, p.staatus, p.vea_kood, p.vea_tekst, p.markus FROM adob_probleemid p, aadressid a WHERE p.adob_id in (select adob_id from temp_adob) AND p.adr_id=a.adr_id(+) AND p.staatus='p' AND p.menetlus_id is null Märkused põhiregistrist (NOT OtsiMenetlusest AND Markused) SELECT p.adob_id, a.taisaadress, p.staatus, p.vea_kood, p.vea_tekst, p.markus FROM adob_probleemid p, aadressid a WHERE p.adob_id in (select adob_id from temp_adob) AND p.adr_id=a.adr_id(+) AND p.staatus='m' AND p.menetlus_id is null Probleemid menetlusest (OtsiMenetlusest AND Probleemid) SELECT p.menob_id as adob_id, a.taisaadress, p.staatus, p.vea_kood, p.vea_tekst, p.markus FROM men_probleemid p, men_aadressid a WHERE p.menob_id in (select adob_id from temp_adob) AND p.menadr_id=a.menadr_id(+) AND p.staatus='p' Märkused menetlusest (OtsiMenetlusest AND Markused) SELECT p.menob_id as adob_id, a.taisaadress, p.staatus, p.vea_kood, p.vea_tekst, p.markus FROM men_probleemid p, men_aadressid a WHERE p.menob_id in (select adob_id from temp_adob) AND p.menadr_id=a.menadr_id(+) AND p.staatus='m' Probleemid ja märkused ühendada tagastuses samasse andmerühma. Pärast väljundi lugemist võib alati teha rollbacki, et tühjeneks temporary tabelid. 6.3 Menetlusobjekti täpsustamine Selle teenuse kaudu esitatakse ADS süsteemis registreeritud objektide täpsustusi nende andmete osas, mis oma olemuselt tulenevad põhiregistrist, näiteks kuju, tunnus põhiregistris, õiguslik alus jne. Selle teenuse kaudu ei esitata ega muudeta aadresse. Objektile jäävad ADS süsteemis registreeritud aadressid. ADS-OID on teenuse sisendis kohustuslik ning objektide olemasolu tuvastatakse selle alusel Sisend Teenuse sisendis olevad väärtused EsitajaKood ja Menetleja_nimi võib välja lugeda ka teenuse soap-ümbrikust (asutus ja ametnik). Kui aga teenuse väljakutse on AS Datel /226

179 realiseeritud selliselt, et ametnik on alati konstant ja mitte reaalne isikukood, siis ei sobi see lahendus (EHR-s on see täna nii). Teiseks ei ole hea rakenduses avalikult eksponeerida isikukoode. Menetleja_nimi salvestub andmete juurde muutja nimena ja näidatakse ADS rakenduses välja. Seetõttu oleks otstarbekam edastada menetleja nimi teenuse andmetes, sest teenust tohib nagunii kasutada ainult päritoluregistris tuvastatud isik. Nimi andmetüüp kirjeldus Esitaja (esineb teenuses 1 kord) esitajakood string (10) Registrit pidava organisatsiooni registrikood. Organisatsioon peanb olema Maa-ameti admin süsteemis eelnevalt registreeritud. Organisatsioonist saab X-tee kaudu loodava menetluse menetleja. Kohustuslik menetlejanimi string(11) Andmeid menetleva kasutaja täisnimi või isikukood. Kohustuslik menetluseliik integer 1 muutmine (vaikimisi) 2 parandamine Väärtustele vastavad konkreetsed menetluse liigid on häälestatavad süsteemi parameetrites. Vaikimisi 1 ainultkontroll boolean Vaikimisi false True väärtuse korral menetlust ei jõustata, vaid kustutatakse menetlus pärast kontrollide teostamist. menetlusnr integer Kui see parameeter on täidetud, siis eeldatakse olemasoleva menetluse staatuse päringut. Objekti andmeid pole vaja esitada. Teenus tagastab viidatud menetluse andmestiku. Objekt (võib esineda mitu, vähemalt 1 objekt on kohustuslik, kui sisendis menetlus_nr pole määratud, maksimaalne hulk on piiratud parameetriga vaikimisi 1000) objektiliik string (2) Aadressiobjekti liigi tunnus klassifikaatorist. Kohustuslik adsoid string (10) ADS süsteemis olemasoleva objekti tunnus. Kohustuslik. origtunnus string (20) Objekti identifikaator andmeid esitavas registris. Kohustuslik oiguslikalus string (500) Objekti versiooni tekkimise või tühistamise õiguslik alus. alusekuupaev date Õigusliku aluse kuupäev. olek char(1) O ootel; K kehtiv; T tühistatud Kohustuslik tahis string(200) Hoone osa korral tähis, hoone korral üldnimetus Kohustuslik hoone osa korral. korrus integer Hoone osa korral sissepääsu korrus Kohustuslik hoone osa korral ruumikuju GML Objekti Ruumikuju GML formaadis Kohustuslik KujuMoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud Kohustuslik, kui esitatakse ruumikuju hooneadsoid string (10) Ainult hoone osa korral kohustuslik atribuut. Viide hoone ADS_OID väärtusele, mille osaga on tegemist. Hoone peab samuti esinema esitatavate andmete hulgas. AS Datel /226

180 6.3.2 Väljund Kui ADSTulem näitab õnnestumist, aga Joustatud on tühi, siis tegelikult andmeid ei jõustatud, vaid ainult märgiti jõustamisvalmiks. Sellest räägib ka tagastatav ADSTeade. Sellisel juhul on ka Menetlus_nr tagastuses alati olemas. Sellises olukorras peaks andmeid esitav register jätma meelde menetluse numbri ning arvestama, et jõustamine tegelikult ei ole toimunud. Originaalregister ei tohi oma tegevusega lõpuni minna, sest muudatused ei ole ADS-s registreeritud, vaid peab jätma protsessi ootele. Nüüd peaks originaalregister soovi korral pöörduma uuesti sama teenuse poole koos Menetlus_nr väärtusega. Andmeid uuesti esitada pole vaja. Seda võib teha seni kui ükskord teenuse tagastuses sisaldub ka Joustatud kuupäev. Sel hetkel saab lugeda andmed ADS-s jõustunuks. Kui teenuse poole pöörduti koos Menetlus_nr väärtusega ja see tagastab ebaõnnestumise tunnuse, siis tähendab see, et erimenetleja on selle menetluse tühistanud. Andmed tuleb ikkagi parandada teenuse kasutajal ja esitada uuesti. Kui ADSTulem näitab ebaõnnestumist, siis ei sobi esitatavad andmed ADS süsteemi, need tuleb parandada ja uuesti esitada. Ka negatiivse tulemi korral on vastuses näha menetluse nr, objektid, aadressid ja probleemid, mis teenusel õnnestus tekitada. Kui midagi ei õnnestunud, siis on vastus tühi. Tekkinud viga näitab ADSTeade. nimi andmetüüp kirjeldus tulem (vastuses 1 kord) tulem string 1 - õnnestumise korral ; 0 vea korral teade string Teenuse tekstiline teade. Positiivse vastuse korral lisainfo, negatiivse vastuse korral veateade menetlusnr string Loodud menetluse number, kui menetluse loomine õnnestus. joustatud datetime Menetluse jõustamise aeg koos kellaajaga. Kui puudub, siis pole menetluse jõustamine õnnestunud Objekt (vastuses võib esineda mitu, puudub, kui menetluse loomine ebaõnnestus) adsoid string Objekti ADS süsteemi kood adobid integer Objekti versioonitunnus ADS süsteemis objektiliik string (2) Aadressiobjekti liigi tunnus. origtunnus string (20) Objekti identifikaator andmeid esitavas registris. oiguslikalus string (500) Objekti versiooni tekkimise või tühistamise õiguslik alus. alusekuupaev date Õigusliku aluse kuupäev. olek char(1) O ootel; K kehtiv; T tühistatud tahis string(200) Hoone osa korral tähis, hoone korral üldnimetus korrus integer Hoone osa korral sissepääsu korrus ruumikuju GML Objekti Ruumikuju GML formaadis AS Datel /226

181 nimi andmetüüp kirjeldus kujumoodustusviis char(1) D digitud; K kaardistatud; M mõõdistatud hooneadsoid string (10) Ainult hoone osa korral. Viide hoone ADS_OID väärtusele. aadress string Objekti optimeeritud täisaadress, mis sisaldab kõiki paralleelaadresse lahiaadress string Objekti lähiaadress, mis sisaldab kõiki paralleelaadresse Aadress (objektiga seotud element). Paralleelaadresside korral on mitu elementi adrid Int Aadressi unikaalne võti, jõustamata menetluse korral võib puududa koodaadress string Koodaadress, jõustamata menetluse korral võib puududa taisaadress string Normaliseeritud aadresstekst lahiaadress string Normaliseeritud lähiaadress Objekti probleemid, mis takistavad jõustamist (objektiga seotud ekement) Mitme probleemi korral mitu elementi. Kui jõustamine õnnestus, siis probleemid puuduvad. aadress string See täisaadress, millega on probleeme, võib puududa, kui probleem ei puuduta otseselt aadressi veakood integer Vea kood klassifikaatori veatekst string Probleemi tekstiline kirjeldus markus string Probleemile erimenetleja poolt lisatud selgitus Funktsionaalsus Kui sisendis on määratud Menetlus_nr, siis soovitakse tagasisidet salvestunud menetluse kohta ja ei tehta uut esitamist. Sellisel juhul minnakse kohe väljundi lugemise juurde. Sisendis esitatud objektide andmed kirjutada baasi temporary tabelisse TEMP_ADOB. Ruumikuju gml-st moodustada eelnevalt geometry objekt. Näiteks kasutada salvestamise hetkel funktsiooni interop.jgeom_utils.gml_to_geometry(gml). Seejärel pöörduda baasiprotseduuri MEN_TEENUSED. TAPSUSTAMINE poole. Kui see protseduur tagastab oadstulem = +, siis on õnnestumine, muul juhul ebaõnnestumine. Kui teenuse tagastuses sisaldub omenetlusid, siis teha andmebaasi päring enne commiti või rollbacki (commiti võib ka enne teha, aga rollbaci mitte, muidu pole andmeid mida lugeda.) Väljundi lugemine Objektide andmed (menob_id on sisemiseks seostamiseks, väljundisse pole vaja panna, ülejäänud omistada järjekorras objektide väljundisse, geometry muuta gml-ks) SELECT o.menob_id, o.ads_oid, o.tulem_adob_id, o.adob_liik, o.orig_tunnus, nvl(o.oiguslik_alus,m.oiguslik_alus) oiguslik_alus, nvl(o.oiguslik_kp,m.oiguslik_kp) oiguslik_kp, o.olek,o.tahis, o.sissepaasu_korrus,o.geometry, o.kuju_moodustusviis, (SELECT ads_oid FROM AS Datel /226

182 men_objektid WHERE menob_id=o.hoone_menob_id) hoone_oid, o.taisaadress, o.lahiaadress FROM men_objektid o, men_menetlus m WHERE o.menetlus_id=[tagastatatud omenetlusid] AND m.menetlus_id=o.menetlus_id Aadresside andmed (lugeda kas eraldi iga objekti kohta või siis korraga 1 päringuga ja seostada objektiga menob_id alusel ) SELECT menob_id, adr_id, koodaadress, taisaadress, lahiaadress FROM men_aadressid WHERE menetlus_id=[tagastatatud omenetlusid] AND nvl(seos_objektiga,'0')<>'d' Probleemid (lugeda kas eraldi iga objekti kohta või siis korraga 1 päringuga ja seostada objektiga menob_id alusel) SELECT p.menob_id, a.taisaadress, p.vea_kood, p.vea_tekst, p.markus FROM men_probleemid p, men_aadressid a WHERE p.menetlus_id=[tagastatatud omenetlusid] AND p.menadr_id=a.menadr_id(+) AND p.staatus='p' AND p.vea_kood IN ( SELECT vea_kood FROM men_liigivead WHERE menliik_kood=(select menliik_kood FROM men_menetlus WHERE menetlus_id=[tagastatatud omenetlusid])) Pärast väljundi lugemist commit õnnestumisel ja rollback ebaõnnestumisel. 7. Normaliseerija reeglid 7.1 Soovitused ja piirangud normaliseerimata aadressitekstile Et katsetada kuidas normaliseerija töötab, saab seda kasutada avalikus ADS päringurakenduses ( Samuti töötab normaliseerija funktsionaalus samas rakenduses massgeokodeerija ühe osana. Normaliseerimata aadresstekst peaks olema üldjuhul esitatud üldisemast täpsema suunas. Näiteks: Lääne-Virumaa, Sõmeru vald, Sõmeru alevik, Puiestee tn EHAK tasemed võivad olla esitatud ka pärast lähiaadressi osa, sel juhul kindlasti täpsemast üldisema suunas. Näiteks: Puiestee tn 14 18, Sõmeru alevik, Sõmeru vald, Lääne-Virumaa. Lähiaadressi osa ise peab ikka jääma üldisemast täpsema suunas, sellist esitusviisi Puiestee tn normaliseerija ei tunnista. Soovitav on kasutada tasemete eraldajana koma v.a majanumbri ja korterinumbri ees. Majanumbri ees peab alati olema 1 tühik (ei tohi olla kokku kirjutatud eelmise tekstiga, näiteks nii ei tohi Puiestee tn14, sest muidu normaliseerija ei tuvasta majanumbrit). Korterinumbri ees peab alati olema sidekriips. Kui tasemete eraldajana koma ei kasutata, siis võib normaliseerimine sõltuvalt olukorrast ebaõnnestuda või anda vale tulemuse. Suur ja väiketähtede korrektne kasutamine pole oluline, kui vastav komponent on ADS süsteemis olemas. Normaliseerija eeldab, et tasemel ei pea vastav komponent süsteemis varasemalt eksisteerima juhul, kui normaliseerija sisendiks on mõne aadressiobjekti aadressid. (Näiteks katastriüksus, ehitis, korter vms). Kui normaliseerija sisendiks oleva objekti liiki konkreetselt ei määrata, siis eeldab normaliseerija, et kõik komponendid peavad ADS süsteemis eksisteerima. Selliselt saavad normaliseerijat kasutada välised süsteemid, kes ise andmeid ADS-le ei esita. AS Datel /226

183 7.1.1 EHAK normaliseerimine Maakond peab olema esitatud kas lühikujul või pikalt välja kirjutatud: Lääne-Virumaa või Lääne-Viru maakond. Maakond võib normaliseerimata tekstis ka puududa, kui omavalitsus on olemas. Omavalitsuse puhul peab valla nimele alati olema lisatud liigisõna vald. Omavalitsuslike linnade puhul võib liigisõna puududa. Nii tunneb normaliseerija ära linnad Tallinn, Tartu, Pärnu, aga võib ka olla pikal kujul Tallinna linn, Tartu linn, Pärnu linn. Kuna omavalitsuste nimed on üle Eesti unikaalsed, siis võib maakond normaliseeritavast tekstist puududa. Kui on mõlemad olemas, siis kontrollib normaliseerija alluvussuhet ja tagastab vea, kui see ei sobi. Harjumaa, Tartu linn normaliseerimine ebaõnnestub. Asustusüksuste puhul võib liigisõna ka puududa. Kindluse mõttes on soovitav see lisada, et vältida arusaamatusi samanimeliste üksuste puhul. Siiski on olulisem määrata enne asustusüksuse nime ka omavalitsus või maakond. Näiteks aadress Harjumaa, Kiili vald, Luige normaliseerub korrektselt. Aadress Harjumaa, Kiili, Luige normaliseeritakse EHAK osas Harju maakond, Kiili vald, Kiili alevik, sest kuna puudus konkreetne liigisõna vald, siis eeldas normaliseerija, et peetakse silmas samanimelist alevikku. Omavalitsus võib normaliseeritavast tekstist puududa, kui järgmine komponent määrab selle unikaalselt. Näiteks aadress Lääne-Virumaa, Sõmeru normaliseerub Lääne-Viru maakond, Sõmeru vald, Sõmeru alevik, aga aadress Harjumaa, Sõmeru ei normaliseeru, sest Harjumaal esineb Sõmeru küla nii Kiili vallas kui ka Kose vallas. Reegel, et 1 tase võib normaliseeritavas tekstis vahelt puududa, kehtib ka järgnevate tasemete juures. Näiteks Tallinna linna puhul ei pea normaliseeritavas aadressitekstis sisalduma linnaosa, kui järgnev tänav määrab selle üheselt. Kui tänav läbib mitut linnaosa, siis suudab normaliseerija selle üheselt määrata majanumbri alusel eeldusel, et majanumber on unikaalne Paralleelaadresside töötlemine Normaliseerija varasemas versioonis (kasutuses kuni x kuupäevani) oli Maaregistri tarbeks loodud eraldi haru, mille kaudu esitati EHAK kood ning normaliseeritav lähiaadressi tekst, mis võis sisaldada ka paralleelaadresse. Peale selle oli veel lisakülade loetelu, aga see vajadus on nüüd kadunud, sest ühele aadressiobjektile ei või alates 2007 aastast määrata mitme asustusüksuse järgset aadressi. Normaliseerija uuemas versioonis on algselt Maaregistri jaoks tehtud funktsionaalsus üldistatud ja võimalik kasutada kõigi tarbijate poolt. EHAK osa võib olla esitatud kas normaliseeritud kujul või normaliseerimata kujul. Lubatud on esitada ka kõige täpsema EHAK tasandi kood, see peab olema siis paigutatud õigele tasandile (2-omavalitsuslike linnade korral või 3-asustusüksusteks jagunevate omavalitsuste korral). Oluline on nõue, et EHAK osa on kõigil paralleelaadressidel sama ja esitatakse ühekordselt. Lähiaadressi osa esitatakse normaliseerimata tekstina ja see võib sisaldada paralleelaadresse. AS Datel /226

184 Paralleelaadressi eraldajaks on kaldjoon. Kui kaldjoonele järgneb ilma tühikuta number, siis teda ei loeta mitte paralleelaadressi eraldajaks, vaid majanumbri (korterinumbri) osaks. Näiteks Räägu tn 2a/1 - selles tekstis paralleelaadresse ei tuvastata. Viimane sõna tekstis 2a/1 paigutatakse tervikuna tasemele 7. Aadressitekst Jaama tn 8 / 10 (numbri 10 ees on tühik), aga tekitab 2 paralleelaadressi: Jaama tn 8 ja Jaama tn 10. Kindluse mõttes on soovitav kasutada paralleelaadresside eraldajana 2 kaldjoont. Sel juhul ei pea jälgima, kas kaldjoontele järgneb tühik või mitte. Kui paralleelaadressi normaliseerimata teksti jääb ainult majanumber, siis võetakse tänava nimi või väikekoha nimi talle vahetult eelnevast paralleelaadressist. Näiteks normaliseerimata tekst Lille 18 // 20 // Metsa 5 // 7. Siin tekib 4 paralleelaadressi: Lille tn => kuna tänav puudub, siis võetakse eelmisest aadressist, tekib Lille tn 20 Metsa tn 5 7 => kuna tänav puudub, siis võetakse eelmisest aadressist, tekib Metsa tn 7 Kui 1 paralleelaadressidest on hoopis kohanimi, mis paigutub 6. tasemele, siis see tekitab eraldi aadressi ja ei võeta tänava nime eelnevast juurde. Näiteks tekst Jaama tn 8 // 10 // Lõokese tekitab 3 paralleelaadressi: Jaama tn 8 Jaama tn 10 Lõokese Kui paralleelaadressi eraldajat selles normaliseerimata tekstis ei leidu, näiteks on selline tekst Jaama tn 8 Lõokese, siis paigutab normaliseerija kogu teksti 6. tasemele ja tekib tegelikult vigaselt normaliseeritud aadress. Et antud olukorras tekiks 2 paralleelaadressi, selleks peab siiski olema mingi eraldaja. Näiteks selline tekst Jaama tn 8/Lõokese normaliseeritakse 2 paralleelaadressiks. Kui tänav kuulub väikekoha alla, siis peab see olema tänava nime ees kirjas ja tänava nimest komaga eraldatud. Näiteks nii Mesinik AÜ, Taru tn 1 // Mesilase tn 8. Tekib 2 paralleelaadressi: Mesinik AÜ, Taru tn 1 Mesilase tn 8 Kui mõlemad tänavad kuuluvad väikekoha alla, siis peab väikekoha nimi olema korratud ka teise tänava ees. Vastasel korral eeldab normaliseerija, et Mesilase tänav kuulub otse EHAK tasandi alla. Kui väikekoha liigisõna lühend on nime ees, siis loeb normaliseerija väikekoha nimeks kogu teksti komani või 7. tasandi komponendini. Näiteks tekstist AÜ Mesinik, Taru tn 1 loeb normaliseerija väikekoha komponendiks AÜ Mesinik, aga tekstist AÜ Mesinik Taru tn 1 loeb normaliseerija väikekoha komponendiks AÜ Mesinik Taru tn. Koma on sel juhul kindlasti tarvis. Kui liigisõna on nimetuse järel, siis ei ole ilmtingimata koma tarvis. Näiteks tekstist Mesinik AÜ Taru tn 1 loetakse väikekoha nimeks Mesinik AÜ. Ja sellisel juhul paralleelaadresse ei teki Ühe aadressi normaliseerimine Ühe aadressi normaliseerimise sisendiks on aadressi kirje, mille algus võib olla esitatud tasemete kaupa, kuid mille lõpuosa on esitatud normaliseerimata tekstina. AS Datel /226

185 Normaliseerimisse ei lähe tasandit initsialiseerivate objektide aadressid, sest need ei tohi olla normaliseerimata kujul. Normaliseerimata lähiaadressi tekst peab olema esitatud üldisemast täpsema suunas. 1. Aadressi normaliseerimisel eeldatakse, et EHAK osa on normaliseeritavast tekstist juba eraldatud ja et EHAK on tuvastatud tasemel 2 üheselt ja / või tasemel 3 üheselt või mitmeselt. Normaliseeritakse lähiaadressi osa. 2. Normaliseerimata teksti lõpust eemaldatakse numbrid Normaliseerija eraldab teksti lõpust kuni sümbolini - teksti osa ja kontrollib, kas see sobib tasandile 8. See sobib juhul, kui algab numbriga, koosneb ainult 1 sõnast (ei sisalda tühikut), sisaldab ainult numbreid, millele võib olla lisatud tähti või kaldjoon. Kõik teised sümbolid on keelatud. Kui sobib, siis eeldatakse, et tegemist on 8 tasemega ja eraldatakse tekstist, kui mitte, siis jäetakse normaliseerimata teksti osaks. Näiteks on lubatud kombinatsioonid: number -5; number+kaldkriips+number -5/2. Uue ADS määruse järgi ei ole lubatud korteri numbritest tähed, kuid normaliseerija peaks neid siiski varemmääratud aadressides suutma normaliseerida: number+täht 5a; number+kaldkriips+täht 5/a; number+kaldkriips+number+täht 5/2a Normaliseerija eraldab teksti lõpust viimase sõna ja kontrollib, kas see sobib tasandile 7. Sõna eraldajaks loetakse tühikut ja punkti. See sobib juhul, kui algab numbriga, koosneb ainult 1 sõnast (ei sisalda tühikut), sisaldab ainult numbreid, tähti või kaldjoont. Kõik teised sümbolid on keelatud. Kui sobib, siis eeldatakse, et tegemist on 7 tasemega ja eraldatakse tekstist, kui mitte, siis jäetakse normaliseerimata teksti osaks. Näiteks on lubatud kombinatsioonid: number 7, number+täht 7a, number +täht+kaldkriips+number 7a/1. peale kaldkriipsu on tähed küll lubatud kuid ADS määruse järgi ebasoovitavad seega on lubatud variant ka siiski number+kaldkriips+täht 7/a ja number+kaldkriips+number+täht 7/1a samuti on lubatud 7a/a ja 7a/1a Kui tuvastati tase 8 ja ei tuvastatud taset 7, siis eeldab normaliseerija, et tegemist ei ole õige tasemega 8 ning loeb leitud numbri uuesti normaliseerimata aadressiteksti osaks. Näiteks Sepa-2 on uue määruse järgi korteri aadress, kuid normaliseerija seda automaatselt ei tunnista, vaid eeldab, et tegu on KÜ nimega. 3. Taseme 4 tuvastamine Liigisõnade olemasolul Kui tase 4 pole määratud, siis otsitakse teda normaliseerimata tekstist. Kui tekstis sisaldub tuntud liigisõna või selle lühend: aiandusühistu, suvilaühistu, garaažiühistu, aü, sü või gü, siis sellele eelnev tekst loetakse kindlaks väikekoha nimeks. Kui normaliseerimata tekstiosa algab ühega mainitud liigisõnadest, siis loetakse taseme 4 nimeks kogu liigisõnale järgnev tekst või kuni eraldajani, kui see eksisteerib. Eraldajaks võivad olla kas esimene koma või teised jutumärgid või teine ülakoma. Kui eraldajaid ei olnud, siis eemaldatakse tekstist segavad sõnad Kui tase 4 nimi küll leiti, aga tase 7 eelnevalt ei tuvastatud, siis ei loeta leitud nime siiski mitte väikekoha nimeks ja eeldatakse, et tase 4 jääb määramata. AS Datel /226

186 Normaliseerija otsib nime aadressis määratud ülemtasandi otsesest või kaudsest alluvusest 4. tasandilt sünonüümide hulgast. Kui ei leitud ja eelnevalt oli tuvastatud ka tase 7, siis jäetakse aadress normaliseerimata põhjusega, et ei tuvastatud väikekohta Liigisõnade puudumisel Kui tase 4 pole määratud ja tuntud liigisõna ei sisaldunud, siis otsitakse tekstist koma. Komale eelnevat teksti peetakse väikekoha nimeks. Kui koma ei leidunud, siis otsitakse jutumärkide või ülakomade vahel olevat teksti. Kui ka neid ei esinenud, siis peetakse kogu teksti väikekoha nimeks ja eemaldatakse segavad sõnad Kui eelnevalt ei olnud tuvastatud taset 7, siis väikekohta ei otsita ja eeldatakse, et tase 4 jääb määramata Väikekoha nime otsitakse aadressis määratud ülemtasandi otsesest või kaudsest alluvusest 4. tasandilt sünonüümide hulgast. Kui ei leitud, siis eeldatakse, et polnud tegemist väikekohaga ja minnakse edasi Segavad sõnad tasemel 4 ehk sellised sõnad, mis väikekoha nime juurest eemaldatakse on järgmised: krunt, nr., nr, number. Samad sõnad eemaldatakse ka jäägist, kui leiti kindel väikekoha nimi. Näiteks: Mesinik AÜ krunt nr selles tekstis tuvastatakse kindel väikekoha nimi, kuna leidus vastav liigisõna, see on Mesinik AÜ ja jääb jääk krunt nr. Sellest jäägist eemaldatakse segavad sõnad ja jääk kaob. 4. Taseme 5 tuvastamine 4.1. Kui tase 5 pole määratud, siis otsitakse teda normaliseerimata tekstist. Kui tekstis sisaldub tuntud liigisõna või selle lühend: tänav, puiestee, maantee, tee, ringtee, plats, väljak, liin, põik, allee, umbtänav, tn, pst või mnt, siis sellele eelnev tekst loetakse kindlaks liikluspinna nimeks Kui tase 5 nimi küll leiti, aga tase 7 eelnevalt ei tuvastatud, siis ei loeta leitud nime siiski mitte liikluspinna nimeks ja eeldatakse, et tase 5 jääb määramata Kui tase 5 nimi küll leiti, aga peale selle jäi veel normaliseerimata tekstiosa üle, mis saab sattuda ainult 6. tasemele, siis ei loeta leitud nime siiski mitte liikluspinna nimeks ja eeldatakse, et tase 5 jääb määramata Normaliseerija otsib nime aadressis määratud ülemtasandi otsesest või kaudsest alluvusest 5. tasandilt sünonüümide hulgast. Kui eelnevalt tuvastati tase 4, siis eeldatakse tänava kuulumist taseme 4 otsesesse alluvusse. Kui ei leitud, siis jäetakse kogu allesjäänud tekstiosa normaliseerimata põhjusega, et ei tuvastatud liikluspinda Kui tase5 pole määratud ja tuntud liigisõna ei sisaldunud, siis peetakse kogu teksti liikluspinna nimeks Kui eelnevalt ei olnud tuvastatud taset 7, siis liikluspinda ei otsita ja eeldatakse, et tase5 jääb määramata Liikluspinna nime otsitakse aadressis määratud ülemtasandi alluvusest 5. tasandilt sünonüümide hulgast. Kui ei leitud, siis eeldatakse, et polnud tegemist liikluspinnaga ja minnakse edasi. 5. Kui tase 6 pole määratud, siis loetakse kogu allesjäänud tekstiosa nimetuseks Kui eelnevalt oli leitud tase 4 või tase 5 ning esineb ka normaliseerimata tekstiosa, siis liidetakse tase 4 nimi, tase 5 nimi ja allesjäänud tekstiosa kokku, lisatakse sellele ka eelnevalt tuvastatud tase 7 ja 8 ning eeldatakse, et tegemist on nimetusega. AS Datel /226

187 5.2. Nimetust otsitakse määratud ülemtasandi alluvusest 6. tasandilt sünonüümide hulgast. Kui ei leitud, siis lisandub tekst tasandile Kui tase 6 jäi määramata, kui leiti kas tase 4 või tase 5, siis otsitakse tasemele 7 tuvastatud stringi määratud ülemtaseme alluvusest 7. tasandilt. Kui ei leitud, siis lisandub tekst tasandile Tasemele 8 tuvastatud stringi otsitakse 7 taseme alluvusest 8. tasemelt. Kui ei leitud, siis lisandub tekst tasandile 8. AS Datel /226

188 8. Tühistatud komponentide, aadresside ja objektide järgnevus ADS süsteem püüab järeltegevusena leida tühistatud komponentidele, aadressidele ja objektidele asendavaid komponente, aadresse ja objekte. Eeldatavalt võib komponendi tühistamise ja asendava komponendi tekkimise vahel olla märkimisväärne ajavahe. Kõige väiksem on see ajavahe EHAK objektide puhul, sest maaregister töötleb EHAK muudatusi paketina, ühe piirkonna EHAK muudatusi töödeldakse koos. ADSi andmete esitamise loogika aga põhjustab selle, et muudatused esitatakse siiski sõltumatuna: kõigepealt esitatakse tühistamised ja seejärel lisamised ning muutmised. ADSi seisukohast ei ole vahet, kas esitamise ajavahe on 1 minut või 1 päev. Komponentide järgnevuse tekkimiseks peab asendav komponent kindlasti asuma samal tasemel kui tühistatud. Aadresside järgnevuse puhul pole oluline, et asendav aadress koosneks samadest tasemetest, mis olid tühistatud aadressil. Objektide järgnevuse jaoks peab asendav objekt initsialiseerima samu tasemeid kui asendatav objekt, lisaks sõltub ka veel objekti liik: katastriüksuse järglaseks saab olla katastriüksus, hoone järglaseks hoone, kusjuures elukondlik saab asendada mitteelukondlikku ja vastupidi. Näiteks, kui Tapa omavalitsuslik linn muutus aastal 2005 vallasiseseks linnaks, siis järgnevust 2. tasandi komponendi 791 ja 3. tasandi komponendi 8140 vahel ei tekkinud. Samuti ei tekkinud järgnevust nende objektide vahel. Järgnevus tekib 2. tasandi komponentide 791 (Tapa linn) ja 790 (Tapa vald) vahel ning samuti nende objektide vahel. Uus Tapa linn koodiga 8140 ei ole järglaseks mitte ühelegi objektile, sest enne polnud selles asukohas üldse 3. taset initsialiseerivat objekti. Seevastu kõik Tapa linna tühistatud aadressid said küll järglaseks sellise, kus Tapa linn on 3. tasemel. 8.1 Näited objektide tühistamise kohta EHAK objektid EHAK objektide puhul toimub analüüs ainult ruumikuju alusel. Eeldatakse, et suure tõenäosusega on analüüsi toimumise hetkeks kogu üht piirkonda puudutav muudatuste kogum juba ADSi esitatud. Peale selle eeldatakse, et kõigil EHAK objektidel on kuju alati olemas ja kehtivad EHAK objektid on topoloogilises mõttes enam-vähem korras, väikesed vead võivad esineda. Näide omavalitsuse muudatusest Muudatuste tsükli käigus tühistati objektid koodidega 276 (Pärnu maakond, Kaisma vald) ja 930 (Pärnu maakond, Vändra vald) ning tekkis uus objekt 292 (Pärnu maakond, Vändra vald). Et need 3 muudatust moodustavad ühe terviku seda teadmist ADS-s pole. ADS töötleb järeltegevusena sündmust komponendi 292 lisandumist tasemele 2. Kõigepealt leiab protsess lisandunud komponenti initsialiseeriva objekti kehtiva kuju. Kui see puudub, siis on objekt vahepeal juba tühistatud ja sel juhul arvutust ei tehta. Protsess pakub asendamiseks välja ainult analüüsi hetkel kehtivaid komponente. Initsialiseerivaid objekte saab EHAK tasandi komponentidel olla ainult 1. AS Datel /226

189 Edasi leiab protsess selle kehtiva kujuga mistahes ruumisuhtes (v.a väline puude) olevad tühistatud objektide kujud, mis on initsialiseerinud mõnd vaadeldava tasandi (antud näite puhul tasandi 2) objekti. Antud näite puhul leiti kehtiva kujuga seotud olevat 5 tühistatud kuju. Pildil rohelise viirutusega on uus kuju, lillad on ruumisuhtes olevad tühistatud kujud. Kuigi visuaalselt vaadates tunduvad 3 neist olevat välise puutega, siis ruumianalüüs tuvastas siiski väikese ülekatte. Väike ülekate on tingitud topoloogilisest ebakorrektsusest, mis on tühistatud kujude puhul paratamatu. Seetõttu kasutatakse lisaks ruumianalüüsile veel ka pindalade võrdlemise meetodit. Kuni 1% pindala ülekate loetakse topoloogiliseks müraks ja vastavat objekti ignoreeritakse. Allpool on toodud võrdlusandmed tabelina. Kood Nimi Tühistatud Ruumisuhe Ülekate 271 Järva maakond, Kabala vald :11: Pärnu maakond, Kaisma vald :54: Viljandi maakond, Suure Jaani vald 15:50: Järva maakond, Türi vald :11: Pärnu maakond, Vändra vald :54:43 OVERLAPBDYINTERSECT COVEREDBY OVERLAPBDYINTERSECT OVERLAPBDYINTERSECT OVERLAPBDYINTERSECT 174 m2 ehk 0.0% m2 ehk 28.7% m2 ehk 0.0% m2 ehk 0.0% m2 ehk 71.3% Kaalumisel oli ka variant kasutada eellaste leidmisel tühistamise aega. Sellisel juhul oleks eellased need, mille tühistamise aeg on ligilähedane objekti loomise ajaga. Hinnanguliselt pole seda siiski piisavalt usaldusväärne kasutada, sest pole garantiid, et AS Datel /226

190 korraga ei esitata mitut uut objekti. Lähedane tühistamise aeg võib teoreetiliselt tekkida ka muul viisil. Pindalade võrdlemise meetod on piisavalt usaldusväärne, et ainult sellele tugineda. Antud näitest lisanduks komponentide järgnevussuhte tabelisse 2 kirjet: Tase Vana kood Uus kood Samuti objektide järgnevus on selle analüüsiga tuvastatud. Koos komponentide järgnevuse tuvastamisega ei saa siiski tuvastada EHAK objekti aadresside järgnevust, sest need ei ole alati üks-üheses vastavuses. Aadresse on vaja eraldi käsitleda EHAK kuuluvuse muutmine 1. 3 tasandil (EHAK tasanditel) on võimalik komponendi versioneerumine selliselt, et muutub komponendi ülem. Näiteks kolist Lehtse alevik Järvamaa Lehtse vallast Lääne-Virumaa Tapa valda. Sellega seoses objekti kuju ei muutunud, initsialiseeritav komponent ka kehtetuks ei muutunud ja objekti ega komponendi tasandil ei ole võimalik rääkida järgnevusest. Samas aga initsialiseeriva objekti aadress Järva maakond, Lehtse vald, Lehtse alevik muutus kehtetuks ja asendab teda Lääne-Viru maakond, Tapa vald, Lehtse alevik. Aadressi tasandil on siiski vaja tuvastada järgnevus. Aadresside järgnevust on lihtne tuvastada seotud objekti kaudu. Kui objekti aadress vahetus, siis uus on tühistatud aadressi järglane Ruumiaadresside tühistamine Omavalitsuslike linnade vallasisesteks linnadeks muutumine toob kaasa veel täiendava nüansi. Näiteks Tapa linna muutumine vallasiseseks linnaks. Komponentide järgnevuses asendab 2. tasandi komponenti Tapa linn -> Tapa vald. Aadressi mõttes pole see aga otstarbekas. Tapa vallas on palju külasid ja mitte iga küla aadress ei ole potentsiaalne asendus Tapa linna aadressidele. Objekti mõttes ei saa samuti asendusest rääkida, sest Tapa vallasisene linn initsialiseerib 3. taset, aga Tapa omavalitsuslik linn 2. taset. Erineva tasemega objektid ei saa olla järglased. Selliste situatsioonide tuvastamiseks on võimalik läheneda ka hoopis ruumiaadresside vaatest. Ruumiaadressid on kõige madalama taseme EHAK objektid. Lääne-Viru maakond, Tapa linn oli ühtlasi ka ruumiaadress, mis tühistus koos objektiga. Lääne- Viru maakond, Tapa vald ei ole ruumiaadress, sest leidub tema sees asuvaid EHAK objekte. Uus ruumiaadress on Lääne-Viru maakond, Tapa vald, Tapa linn ja see asendab ruumiliselt täpselt endist Tapa linna. Seega on vaja aadressi tühistamise korral uurida, kas tühistunud aadress on ühtlasi ka ruumiaadress. Kui jah, siis saab teda asendada ainult teine ruumiaadress. AS Datel /226

191 Komponentide järgnevuse alusel aadressi järgnevust tuvastada ei ole antud juhul mõtet. See tekitaks aadresside järgnevuses liiasuse, mida pole vaja. Kui tühistunud aadress ei ole ruumiaadress ja seotud objekt on samuti tühistatud, siis tuleb asendav objekt leida ruumianalüüsiga samaliigiliste (sama taset initsialiseerivate) objektide hulgast Väikekoha objektid Väikekoha (ehk 4. taset initsialiseerivate) objektide eripäraks on see, et need võivad tühistuda nii, et asemele teist ei tekigi. Aadresside ümberkorraldamine sellisel moel, et väikekoha tase jäetakse aadressist üldse välja, on igati ootuspärane variant. Väikekohad on kõik pindobjektid. Kõigil kehtivatel väikekohtadel on kuju olemas ning uued ei saa samuti ilma kujuta lisanduda. Eeldame, et 2 kehtivat väikekohta ei tohi loogiliselt olla ruumilises ülekattes. Väikekohtade järgnevus tuvastatakse samuti ainult ruumianalüüsi põhjal analoogselt EHAK objektidega. Tühistatud väikekoha järglane peab vana kujuga kattuma vähemalt 1% ulatuses. Väikekoha lisandumise sündmuse peale leitakse kõik lisandunud kujuga ruumilises suhtes olevad tühistatud väikekohad. Kui nende ruumiline kattuvus on 1% või rohkem, siis loetakse järgnevus tuvastatuks. Väikekohtade puhul analüüsitakse kujusid ka objekti tühistamise sündmuse peale, sest asendav väikekoht võib olla tekkinud varem, enne tühistamist. Sel juhul leitakse tühistatud kujuga ruumilises suhtes olevad kehtivad kujud. Väikekohti analüüsitakse ka väikekoha objekti kuju muutumise sündmuse peale, sest pole välistatud, et mingi kehtiva väikekoha kuju suurendatakse nii palju, et ta hõlmab ka tühistatud väikekoha ala. Leitakse uue kujuga ruumilises suhtes olevad tühistatud väikekohad. Kui nende ruumiline kattuvus on 1% või rohkem, siis loetakse järgnevus tuvastatuks. Kui järgnevus oli juba varasemast ajast kirjas, siis topelt ei lisata. Väikekoha analüüs tuleb käivitada lisaks objekti lisamise ja tühistamise sündmuse peale ka veel komponendi lisamise ja komponendi tühistamise sündmuste peale, sest komponendid võivad tekkida ja kaduda ka objekti muutumise käigus. Näiteks loodi väikekoht aadressiga Harju maakond, Kernu vald, Pohla küla, Tuuliku AÜ muudeti seda väikekohta ja lisati talle veel teine aadress Harju maakond, Nissi vald, Odulemma küla, Tuuliku AÜ. Nii tekkis uus komponent 4. tasemele väikekoha muutmise käigus. Et see sündmus töötlemata ei jääks, tuleb lähtuda komponentide poolt. Kuju muudatusi aga peab jälgima objektide muutmise logist ning analüüsima kõiki objekti poolt initsialiseeritud kehtivaid komponente. Koos komponentide järgnevuse tuvastamisega lisatakse ka initsialiseerivate objektide aadresside järgnevus Väikekoha tühistamine EHAK muudatuse tõttu Kuna väikekohti analüüsitakse ainult ruumikuju põhjal ja järgnevussuhe saab tekkida alles siis, kui uus objekt süsteemi esitatakse, siis ei vaja EHAK muutmise sündmus väikekohtade puhul erikäsitlust. Asendav komponent võib olla teise ülemtasemega igal juhul nii sel juhul kui ülem tühistati, kui ka sel puhul kui ei tühistatud ülemat. AS Datel /226

192 Väikekoha aadressi ümberkorraldamine Väikekoha komponent võib tühistuda ka nii, et seda initsialiseerinud objekt jääb ise kehtivaks. Näiteks Tatraoru väikekoht Tartumaal. Objektil oli aadress Tartu maakond, Kambja vald, Aakaru küla, Tatraoru esitati muudatus, kus muutunud olid nii kuju kui ka aadress Tartu maakond, Kambja vald, Virulase küla, Tatraoru AÜ. Komponent Tatraoru Aakaru küla alluvuses tühistati ja loodi uus Tatraoru AÜ Virulase küla alla. Kuna ülem muutus, siis komponenti ei versioonitud, vaid tühistati ja loodi uus. Selle situatsiooni püüdmiseks tuleb juhul, kui tühistatud komponenti initsialiseeriv objekt ei ole tühistunud uurida, millist kehtivat komponenti seesama objekt initsialiseerib ja lisada järgnevus ehk 2 päeva hiljem tehti sama objektiga järgmine muudatus. Muudeti jällegi aadresse ja lisati Tartu maakond, Kambja vald, Aakaru küla, Tatraoru AÜ aadress juurde. Nüüd objekt initsialiseerib 2 komponenti: Virulase küla, Tatraoru AÜ ja Aakaru küla, Tatraoru AÜ. Kuna nimetus on teine, siis vana komponent ei taastunud, vaid tekkis uus. Kui see aadress oleks kohe tehtud muudatuse ajal objektil küljes olnud, siis poleks komponent üldsegi tühistatud, vaid hoopis muudetud. Selle situatsiooni püüdmiseks tuleb komponendi lisandumise sündmuse peale uurida kas sama objekt on varem initsialiseerinud mõnd tühistatud komponenti. Kui jah, siis lisada järgnevus Väikekoha aadresside järgnevus Väikekoha aadressid võivad tühistuda ka nii, et väikekoha komponent jääb ise kehtivaks. See juhtub siis, kui toimub EHAK muudatus näiteks 2. tasandil, aga komponendi vahetu ülem 3. tasandil jääb kehtivaks. Selline olukord on võimalik EHAK tasandite korral, kuna EHAK koodid esitatakse ADSi andmete esitaja poolt. Samas kui tühistatakse väikekoha komponent 4. tasemel, siis peab kindlasti tühistuma ka seda komponenti sisaldav aadress. Seetõttu töödeldakse aadressi lisamise ja tühistamise sündmusi ning lisaks loetakse aadresside järgnevus tuvastatuks ka komponentide järgnevusest Liikluspinna objektid Liikluspinna (ehk 5. taset initsialiseerivate) objektide eripäraks on see, et nende kuju on parimal juhul joon. Halvemal juhul on see punkt. Enne 2011 aastat võis esineda ka ilma ruumikujuta liiklsupindasid. Andmekvaliteeti on pidevalt tõstetud. Kuid näiteks tühistatud objektidest puudus kuju 2009 aastal 1309 objektil,. Kuigi uued liikluspinnad esitatakse alati kujuga ei ole siiski võimalik kuju põhjal järgnevusi leida. Ka siis mitte, kui joone ümber ehitada puhver. Tänavaga ristuvad teised tänavad ja nii võivad kujud olla ruumiliselt seotud, kuid siiski mitte järglased. AS Datel /226

193 Analüüsides tühistamisi võib välja tuua alljärgnevad tühistamise põhjused Liikluspinnad on registreeritud topelt 2012.aastaks enam ADS-is topelt registreeritud liikluspindasid ei ole. Varasemate probleemide näiteid: Näiteks Lääne maakond, Ridala vald, Paralepa alevik, Tihase tn, kuju on punkt, see tänav on tühistatud ja tema läheduses asub kehtiv joonobjekt, millel 2 aadressi Lääne maakond, Haapsalu linn // Ridala vald, Paralepa alevik, Tihase tn jõustatud Objektide vahekaugus on 0,9 m. Sellest näitest koorub välja järgmine reegel. Komponendi lisamise või taastamise sündmuse peale tasemele 5 uurida kas samal tasemel, sama ülemobjekti all leidub täpselt sama (pika) nimega tühistatud komponent. Kui leidub, siis uus on eelmise järglane. Komponendi tühistamise sündmuse peale seda reeglit rakendada pole vaja, sest ADS ei võimalda 2 sama nimega komponendi registreerimist sama ülemtaseme alla. Märkus. Järgnevussuhete alglaadimisel ehk esmasel arvutamisel vanade andmete pealt tuleb ikkagi analüüsida ka tühistamisi, sest lähteseis võib olla olnud selline, et ikkagi oli sama ülema all 2 samanimelist komponenti, millest 1 on tühistatud, aga lisamise sündmust ei ole. Uurides täiendavalt selle reegli alusel leitud eelasi järglasi selgus, et ruumianalüüsi pole lisaks otstarbekas rakendada. Kui tühistatud objektil oli kuju, siis asus see asendava objekti kuju suhtelises läheduses. Kõige suurem erinevus oli Rakvere linnas Lenduri tänava puhul, kus tühistatud ja uue kuju vahe oli 186 m Liikluspinna aadresside ümberkorraldamine Näide. Liikluspinna objektil oli aadress Ida-Viru maakond, Aseri vald, Aseri alevik, Ranna tn. See tähendab, et Aseri alevikus esines komponent nimega Ranna tänav. Toimus aadresside ümberkorraldamine Aseri alevikus, loodi väikekohti ning sama liikluspinna uueks aadressiks sai Ida-Viru maakond, Aseri vald, Aseri alevik, Keraamiku AÜ, Ranna tn. Selle muudatuse tulemusena tühistati komponent Aseri alevik, Ranna tänav ja loodi uus komponent Keraamiku AÜ, Ranna tänav. Kuna muutus ülem, siis komponenti ei versioonitud, vaid tühistati ja loodi uus. Kuna mõlemat komponenti initsialiseerib sama objekt, siis on see piisav järgnevuse tuvastamiseks. Antud näite puhul liikluspinna nimi ei muutunud, aga selle muudatuse käigus oleks võinud muutuda ka tänava nimi. Ka sel juhul oleks järgnevus ikkagi tuvastatud. Siit koorub järgmine reegel. Komponendi tühistamise sündmuse peale uuritakse kas initsialiseeriv objekt on jätkuvalt kehtiv. Kui on, siis tunnistatakse tema poolt initsialiseeritavad kehtivad komponendid tühistatud komponendi järglasteks. Sama juhtum tekib ka EHAK tasandi ümberkorralduste puhul. Näiteks kui liikluspinna aadress oli määratud otse Tallinna linna alla, aga tegelikult peab aadressis kajastuma ka linnaosa. Liikluspinna objekti aadressi muutmisega on initsialiseeriva objekti kaudu järgnevus tuvastatav. AS Datel /226

194 Tühistatud tänav kolib teise EHAK üksusesse. Näide. On tühistatud tänav Harju maakond, Viimsi vald, Muuga küla, Altmetsa tee. Selle ruumikuju on punkt. Punkti vahetus läheduses asub joonobjekt aadressiga Harju maakond, Maardu linn, Ristikheina tee, natuke eemal teine joon Harju maakond, Maardu linn, Altmetsa tee. Kui uurida aadresse, mis sisaldasid seda tühistatud komponenti, siis on aadressil Altmetsa tee 6 asunud katastriüksuse aadress muudetud Harju maakond, Viimsi vald, Laiaküla küla, Altmetsa tee 6. Kahes naaberasulas võib vabalt esineda samanimeline tänav, mis siiski ei ole sama tänav. Juhul, kui on tegemist piiripealse tänavaga, mis võib omada aadresse nii selles kui ka teises asulas, siis peaks sel tänaval (liikluspinna objektil) olema aadress mõlema asula järgi. Sel juhul initsialiseeriks joonobjekt 2 komponenti: Laiaküla Altmetsa tee ja Muuga küla Altmetsa tee. Kuna see nii ei ole, siis on selgelt viidatud, et Muuga külas on Altmetsa tee kaotatud ja teda ei asenda miski. Kui uurida üksust, mille aadress on muudetud, siis see asub täielikult Laiaküla külas ja Muuga küla isegi ei piirne temaga. Ilmselt on siin tegemist lihtsalt valesti registreeritud üksuse aadressi parandamisega ja selle alusel ei saa teha usaldusväärset järeldust komponentide järjepidevuse kohta. Kuna kehtival liikluspinnal Laiaküla küla, Altmetsa tee kuju puudub, siis ei saa teda ka täiendavalt analüüsida. Sellest juhtumist võib järeldada, et kui tühistatud komponendi ülem on kehtiv, siis ei saa teises EHAK üksuses asuv komponent teda asendada. Seetõttu jääb komponent Muuga küla, Altmetsa tee ilma järeltulijata. Tühistatud aadressi Harju maakond, Viimsi vald, Muuga küla, Altmetsa tee 6 üheks võimalikuks järglaseks pakutakse Harju maakond, Viimsi vald, Laiaküla küla, Altmetsa tee 6. Aadressi tasandil järjepidevus arvutatakse, komponendi tasandil aga mitte. AS Datel /226

195 EHAK muudatuse tõttu tühistatud tänav Kui ADS süsteemis tühistub EHAK objekt ja teda hakkab asendama teine EHAK objekt, siis öise järeltegevuse protsessi ajal on asendav objekt suure tõenäosusega juba registreeritud ja järgnevussuhted tuvastatud. Järeltegevusena tühistatakse kõik tühistatud EHAK objekti alla kuuluvad komponendid, kuid neid asendavad komponendid ei saa olla veel registreeritud. Seetõttu pole komponendi tühistamise sündmuse peale mõtet asendust otsida. Näide tühistati Kiili vallas Kiili alevik. Tema järglaseks sai Kiili vallas Kiili alev. Järeltegevusena tühistati muuhulgas ka Kase tn Kiili alevikus esitati Kiili alevis Kase tn. Järgnevuse arvutamise protsess peab vaatama, kas lisandunud komponendi (Kase tn) ülem (Kiili alev) on järglaseks mõnele komponendile. Antud juhul on järglaseks Kiili alevikule. Nüüd järgnevuse protsess otsib tühistatud komponendi alamate hulgast samanimelist tänavat. Kui leidub, siis loetakse järgnevus tuvastatuks komponendi tasandil Omavalitsusliku linna vallasiseseks linnaks muutumine EHAK muudatused võivad olla ka keerulisemad. Järgmine näide on omavalitsusliku Tapa linna muutumisest vallasiseseks linnaks. Tühistatud 2. taseme komponendi Tapa linn järglaseks saab 2. taseme komponent Tapa vald. Tapa vallale tekib uus alam 3. taseme komponent Tapa linn. See uus komponent ei ole mitte ühegi komponendi järglaseks, sest 3. taseme komponent ei saa olla järglaseks 2. taseme komponendile. Esitatakse liikluspind Lille tn, mille ülemaks on uus Tapa linn (vallasisene linn). Selle sündmuse peale peab järgnevuste arvutamise protsess leidma komponendi ülema eellase. Kuna seda ei ole ja komponendi ülem on 3. tasandilt, siis tuleb otsida ka ülema-ülemat ehk antud juhul Tapa valda ja vaadata, kas ehk see on mõne komponendi järglaseks. Antud juhul on. Edasi tuleb tavapäraselt otsida tühistatud komponendi alamate hulgast samanimelist tänavat. Kui leidub, siis loetakse järgnevus tuvastatuks komponendi tasandil. Ülema-ülema juurde tuleb pöörduda seni kuni lubavad komponentide alluvussuhted. Kuna 5. tasandi komponent ei tohi kunagi kuuluda otse 1. taseme komponendi ehk maakonna alla, siis liikluspindade puhul pole 2. tasemest ülespoole enam pöörduda tarvis. Vastupidine situatsioon, kus vallasisest linnast saab EHAK muudatuse tõttu omavalitsuslik linn on samuti teoreetiliselt võimalik. Siiski pole praktikast ühtki sellekohast näidet võimalik tuua Väikekoha muudatuse tõttu tühistatud tänav Näide. Sindi linnas tühistati väikekoht nimega Viira AÜ. Öise järeltegevuse käigus tühistati ka kõik selle väikekohaga seotud tänavad loodi uued tänavad, mil on tühistatutega täpselt sama nimi, kuid mis kuuluvad otse Sindi linna alla. Sellise situatsiooni püüdmiseks tuleb töödelda nii komponendi tühistamise kui ka lisamise sündmust. Samanimelised tänavad oleks võinud Sindi linna alluvuses olla ka juba varasemast ajast enne väikekoha tühistamist. Süsteem ei välista seda. AS Datel /226

196 Komponendi lisamisel kui lisatud komponendi ülem on tasandilt 2 või 3 tuleb otsida sama ülema või tema eellase alt tühistatud väikekohti ning nende alt tühistatud samanimelisi tänavaid. Kui leidub, siis loetakse järgnevus tuvastatuks. Komponendi tühistamisel uuritakse, kas ka ülem on tühistatud ja kas ülem on 4. tasandilt. Kui jah ja väikekohal puudub asendav komponent, siis vaadatakse ülemaülemat. Kui see on tühistatud, siis tema järglast. Otsitakse selle otseset alluvusest samanimelist tänavat. Teoreetiliselt on võimalik ka olukord, kus tühistatakse otse EHAK alluvuses olev tänav ning asendav tänav on väikekoha alluvuses. Sellist võimalust tuleb arvestada, kuigi praktilist näidet sellise olukorra kohta pole Tühistatud tänava ruumikuju langeb kokku kehtiva tänavaga Tühistatud tänava Lääne-Viru maakond, Rakvere linn, Väike tn ruumikuju on joon ja see langeb kokku kehtiva tänava Lääne-Viru maakond, Rakvere linn, Spordi tn ruumikujuga. Kehtiv ruumikuju on küll pikem, kuid kõik tühistatud tänava ruumipunktid langevad kokku kehtivas kujus olevate punktidega. Tegemist on küllaltki haruldase situatsiooniga. Praktikas võib see juhtuda ainult siis, kui nii tühistatud kui ka uus kuju on seostatud ETAK andmebaasis oleva kujuga. Loogiline on see olukord juhul, kui mõnele korrektselt registris olevale tänavalõigule antakse omavalitsuse poolt uus nimi. Lootuses, et tulevikus hakkab rohkem selliseid olukordi ette tulema, lisame komponendi tühistamise sündmuse järeltegevuseks kontrolli kas leidub mõni kehtiv liikluspinna kuju, mis oleks tühistatuga covers, coveredby või equal ruumisuhtes. Kui leidub, siis on tegemist komponendi järglasega. Samuti komponendi lisandumise või ruumikuju muutumise sündmuse peale leitakse uue kujuga covers, coveredby või equal suhtes olevad tühistatud liikluspinnad. Leidumisel on tegemist komponendi eellastega. Ruumianalüüsi ei tehta, kui kuju on punkt Järgnevus seotud objektide aadresside alusel Näiteks Ida-Viru maakond, Kohtla-Järve linn, Viivikonna linnaosa, Sirgala Nooruse tn osales 150 tühistatud aadressis. Kui uurida neid aadresse omavaid objekte, siis 5 objektil oli tühistatud aadress vahetatud kehtiva vastu. Uues aadressis osales komponent Ida-Viru maakond, Kohtla-Järve linn, Viivikonna linnaosa, Nooruse tn. Nagu näha on ülemad mõlemal komponendil täpselt samad ning järgnevuse võiks tuvastada. Selle järgnevuse tuvastamiseks tuleb töödelda objektil aadressi vahetamise sündmust. Kui eemaldatud aadress oli tühistatud ja aadressis oli 5. tase ja uues aadressis on ka 5. tase ja see kuulub sama ülema alla ja see ülem on kehtiv, siis võib järgnevuse lugeda tuvastatuks. Erinevate ülemate korral ei saa järgnevust tõestatuks lugeda (vt pt ). AS Datel /226

197 Ilma järglaseta tänavad Pärast kõigi eelpoolkirjeldatud juhtumite töötlemist aastal 2010 jäi siiski alles 1236 tühistatud liikluspinna komponenti, mis endale järglast ei leidnud. Kui uurida nende komponentidega seotud aadresse, siis 851 komponendil oli ainult 1 seotud aadress liikluspinna enda oma. Nende komponentide puhul võib mõnel siiski esineda järglasi. Tabelis on näited komponendiga seotud aadressist ja komponenti initsialiseeriva objekti tühistamise põhjustest. Komponendiga seotud aadress Tühistamise põhjus Kommentaar Harju maakond, Tallinna linn, A. Alle tn Ida-Viru maakond, Narva linn, Zeljonaja tn Jõgeva maakond, Jõgeva linn, M. Pilli tn Dubleeriv kirje nimi on muudetud Muraka tänavaks Dubleeriv kirje (vt Jõgeva alevik) Leidub kehtiv aadress Harju maakond, Tallinna linn, Kesklinna linnaosa, August Alle tänav Leidub kehtiv aadress Ida-Viru maakond, Narva linn, Muraka tänav Leidub kehtiv aadress Jõgeva maakond, Jõgeva vald, Jõgeva alevik, M.Pilli tn Kui liikluspinna nime muudatus on tehtud selliselt, et vana liikluspinna objekt tühistatakse, vanal kuju puudub või on punkt, vanaga pole seotud teiste objektide aadresse ja tehakse uus objekt uue nimega, siis pole võimalik automaatselt järgnevust tuvastada. Sellise järgnevuse peab inimene käsitsi süsteemi sisestama. Teine variant on mitte teha liikluspinna muudatusi sellisel moel, et vana objekt suletakse. Tuleb teha olemasoleva objekti muudatus, mitte sulgemine ja uue loomine. Kõigis ülaltoodud näidetes on muutunud tänava nimi. Ka viimases näites oli enne M. Pilli tn nüüd on M.Pilli tn (enne oli punkti järel tühik, uues variandis ei ole tühikut). Kui nimi oleks olnud täpselt sama, siis oleks järgnevus ka tuvastatud Liikluspinna aadresside järgnevus Andmete analüüs näitas, et liikluspinna aadressid võivad tühistuda ka nii, et liikluspinna komponent jääb ise kehtivaks. Samas kui tühistatakse liikluspinna komponent 5. tasemel, siis peab kindlasti tühistuma ka seda komponenti sisaldav aadress. Näiteks liikluspind, mille aadress oli Pärnu maakond, Vändra vald, Allikõnnu küla, Johann Voldemar Jannseni tn, koodaadress R toimus 2. tasandi komponendi 930 tühistamine. Sellega seoses muutus antud aadress tühistatuks. 3. tasandi komponent 1215 jäi aga kehtima, teda versiooniti, ta sai uue ülema 929. Kõik tema alamad komponendid, k.a Allikõnnu küla, Johann Voldemar Jannseni tn jäid samuti kehtima. Komponentide tasandil järgnevusest ei saa rääkida, kuna komponent on kehtiv, ei toimunud isegi muutmise sündmust, aga tühistatud aadressi järglast on siiski võimalik leida. Selliste situatsioonide püüdmiseks on siiski vaja analüüsida eraldi liikluspinna aadresside muutumise sündmusi. Kui samal objektil on tühistatud aadress asendatud kehtivaga, siis need aadressid on järglased. AS Datel /226

198 Sellegipoolest on vaja aadresside järgnevusi lisada ka komponentide järgnevuse alusel, sest komponente analüüsitakse nime alusel, ilma objekti kuju arvestamata Menetlusobjektide järgnevus Komponentidele tasemetel enam eraldi järgnevusi ei otsita, vaid nende järgnevus tuvastatakse aadresside kaudu. Kõigepealt tuvastatakse objektide järgnevus, seejärel aadresside järgnevus ja siis komponentide järgnevus Katastriüksuste järgnevus Katastriüksuste järgnevus tuvastatakse alati ruumianalüüsiga, sest kõigil katastriüksustel on kuju olemas ja see on pind. Punktikujulised katastriüksused, mil pole veel tunnust, järglaste analüüsis ei osale. Objektide järgnevuse arvutamiseks analüüsitakse objekti lisamise, tühistumise ja kuju muutumise sündmuseid. Olenevalt sündmusest leitakse kehtiva kujuga kattuvuses olevad tühistatud objektid või vastupidi. Kehtiv on tühistatud objekti järglane juhul, kui on täidetud üks kahest järgmisest tingimusest: Kattuva pinna absoluutväärtus peab olema suurem juhitavast parameetrist (näiteks 100m2) Kattuva pinna osakaal väiksemasse objekti peab olema suurem juhitavast parameetrist (näiteks 20%) Kui juhitavat parameetrit süsteemis muudetakse, siis rakendub see edaspidi toimuvatele järgnevussuhete arvutustele. Varem leitud järgnevusi ümber ei arvutata, sest need on teenuste kaudu juba tarbijatele väljastatud Hoonete järgnevus Hoonete puhul on erisuseks see, et sugugi mitte kõigil hoonetel ei ole kuju. Kui tühistatud hoonel on kuju, siis järglased kehtivate hulgast samal moel nagu katatstriüksuste korral ruumianalüüsiga pinna kattuvuse meetodil. Kehtiv on tühistatud objekti järglane juhul, kui on täidetud üks kahest järgmisest tingimusest: Kattuva pinna absoluutväärtus peab olema suurem juhitavast parameetrist (näiteks 16m2) Kattuva pinna osakaal väiksemasse objekti peab olema suurem juhitavast parameetrist (näiteks 50%) Kattuva pinna absoluutväärtus ja osakaal on aga teiste parameetrite kaudu juhitavad, st hoonel ja katastriüksusel on selles osas erinevad piirväärtused. Tühistatud hoone järglaseks loetakse ka sama EHR-koodiga kehtiva hoone. Selline järgnevus saab tekkida siis kui ühe liigiga hoone tühistatakse ja tekib teise liigiga hoone. Kui hoonel puudus ruumikuju ja sama EHR-koodiga järglast samuti ei leitud, siis loetakse järglaseks kõik sama aadressiga hooned. Aadressi kaudu leitud järgnevus AS Datel /226

199 lisatakse ainult siis, kui ühel osapooltest puudub ruumikuju. Kui mõlemal osapoolel oli ruumikuju ja need ruumikujud ei kattunud nõutaval määral, kuid 2 hoonel oli sama aadress, siis neid hooneid järglasteks ikkagi ei loeta taseme aadresside järgnevus Objekti ja aadressi seose logist loetakse aadresside objektilt eemaldamise sündmusi. Tähelepanu pööratakse neile aadressidele, mis sisaldavad 6., 7. või 8. taset ja mis on tühistatud. Iga objektilt eemaldamise sündmus ei tähenda automaatselt, et aadress on tühistatud. Tühistatud aadresside puhul uuritakse sama objekti kehtivaid aadresse. Kõik sellised kehtivad aadressid, mis ei esinenud vanal objekti versioonil (millel esines veel see tühistatud aadress), aga esinevad uuel versioonil tunnistatakse tühistatud aadressi järglasteks. Komponentide õigusjärgluse tuvastamiseks uuritakse vastleitud eellast ja järglasi. Kui tuvastatakse komponendi muudatus sama taseme piires tasemel ja vana komponent on kehtetu, siis registreeritakse komponendi järgnevussuhe. Komponendi järgnevussuhet võib ka mitte tuvastada, kui näiteks vana aadress sisaldas nimetust, aga uus tänavat ja majanumbrit. Näiteks. Katastriüksusel tunnusega 89001:002:0244 oli 2 aadressi: Harju maakond, Viimsi vald, Idaotsa küla, Prangli saar ja Harju maakond, Viimsi vald, Idaotsa küla, Loigu-I eemaldati üksuselt need aadressid. Esimene neist jäi pärast eemaldamist ikka kehtima, teine on tühistatud aadress. Uus aadress, mis üksusele omistati, on Harju maakond, Viimsi vald, Idaotsa küla, Loigu 1. See uus aadress saab tühistatud aadressi õigusjärglaseks. Samuti tuvastub 6. taseme komponentide õigusjärglus. Komponendi Loigu-I järglaseks saab Loigu Aadresside järgnevus objekti tühistamise korral Töödeldakse ka aadresside tühistamise sündmusi. Kui tühistatud aadress kuulus tühistatud objektile, siis leitakse kõigepealt tühistatud objekti järglsed ning seejärel järglase objektiga seotud aadressid. Tühistatud aadressi järglasteks loetakse aadressid, mis esinevad uuel, kuid ei esine vanal objektil. Kuna see uus objekt võib tekkida ajaliselt märksa hiljem, kui töödeldakse tühistamise sündmust, siis tuleb täiendavalt analüüsida ka aadresside lisandumise sündmusi. Aadress võib lisanduda nii, et lisandus ka objekt, kuid aadress võib lisanduda ka juba olemasolevale objektile. Seetõttu on otstarbekam töödelda just aadressi lisandumise sündmusi. Tuleb uurida, kas lisandunud aadressiga seotud objekt asendab mõnd samaliigilist tühistatud objekti. Kui jah, siis uuritakse, kas tühistatud objektil on tühistatud aadresse ning leidumisel registreeritakse järgnevus. 8.2 Komponentide ja aadresside taastamine Taastamine ehk tühistatud olekust kehtivasse tagasitoomine on võimalik kõigi tasandite komponentide, aadresside ja objektide puhul. Kõige tõenäolisem on see 6. AS Datel /226

200 8. taseme komponentide juures, kus versioonimist ei toimu. Taastamise korral kustutatakse taastatud komponendi või aadressi järgnevussuhted baasist. 8.3 Objekti järgnevuste arvutamise protsessi kirjeldus Objekti järgnevused arvutatakse sõltuvalt objektiga toimunud muudatusest järgmiselt. Objekti lisandumise ja tühistamise korral leitakse samaliigilised tühistatud objektid, mis on seotud kehtiva objekti ruumikujuga. o Maakonna objekte ei töötle, järglus lisandub komponendi tühistamise sündmuse peale. o Teiste EHAK objektide ning väikekohtade puhul lisandub järglus, kui ühisosa pindala on rohkem kui 1% tühistatud objektist o Liikluspindade puhul analüüsitakse joonte kattuvust rohkem kui 1% ulatuses o KÜ ja hoone puhul lisandub järglus, kui ühisosa pindala suhe tühistatud objekti on suurem süsteemis määratud parameetrist hoonete puhul leitakse sama EHR-koodiga tühistatud hoone. Need loetakse järglasteks hooneosade puhul on eellaseks sama tähisega osa hoone eellases Objekti muutumise korral EHAK objektide kuju muudatusi ei analüüsi, teiste liikide puhul toimitakse nagu objekti lisamise sündmuse puhul. 8.4 Aadressi järgnevuste arvutamise protsessi kirjeldus ADS süsteem vajab aadresside järgnevussuhteid enam kui komponentide järgnevusi. Andmete analüüs näitas, et aadresside järgnevus on informatiivsem kui komponentide oma, samuti, et komponentide ja aadresside elutsükkel võib siiski olla erinev, kuigi esmapilgul tunduvad need olevat üsna sarnased. Komponentide muudatussündmusi käsitletakse ainult taseme korral taseme korral arvutatakse komponentide ja aadresside järgnevust täiesti sõltumatult taseme komponentide järgnevuse tuvastamisel lisatakse ka vastavate aadresside järgnevus. Iga komponendiga on seotud täpselt 1 otsene aadress. Lisaks töödeldakse ka aadressi muutumise sündmusi taseme komponentide järjepidevus tuletatakse aadresside järgnevusest. Analüüsitakse ainult aadresside muutumise sündmusi, lisaks ka seotud objektide muutmise sündmusi, kui neil vahetati aadresse. Aadressi järgnevuste lisamine toimub sõltuvalt aadressis määratud tasemetest, mis on vastavuses ka seotud objektiliikidega: EHAK aadressid määratud on ainult tase AS Datel /226

201 Väikekoha ja liikluspinna aadressid - määratud on tase ja tase puudub Hoonete ja katastriüksuste aadressid - määratud on tase ja 8. tase puudub Hooneosade aadressid määratud on 8. tase Aadresside järgnevusi tuvastatakse ADS süsteemis logide järeltöötlemise käigus. Arvutamist käivitavad komponentide, aadresside ja objektide lisamise, muutumise, tühistamise ja taastamise sündmuste töötlemine. EHAK aadresside ehk ainult taset sisaldavate aadresside järgnevuste arvutamine. EHAK komponendi ehk 1., 2. või 3. taseme komponendi tühistamise sündmuse korral o Kui tühistatud komponent initsialiseeris ruumiaadressi (omavalitsuslik linn, küla), siis saab tema järglaseks ainult pindalaliselt kattuv (rohkem kui 1%) ruumiaadress (meetod KOMP_T:TASE23_RADR). Nii tekib võimalus, et 2. tasandi aadressi järglaseks saab 3. tasandi aadress või vastupidi. Komponentide järglased peavad alati olema samal tasandil. o Kui ei olnud ruumiaadress, siis saab järglaseks tühistatud objekti järglase või järglaste aadressid. Kehtib eeldus, et objektide järglus on juba eelnevalt leitud (meetodid KOMP_T:TASE1 ja KOMP_T:TASE23) 2. või 3. taseme komponendi muutumise sündmuse korral o Muutuda saab komponendi nimi või kuuluvus ülema alla. Süsteem leiab EHAK aadressi, mis sisaldab komponendi vana versiooni. See tühistatud aadress loetakse eellaseks. Seejärel leiab süsteem EHAK aadressi, mis sisaldab komponendi uut versiooni. Sellest kehtivast aadressist saab järglane (meetodid KOMP_M:TASE23). EHAK aadressi tühistamise sündmuse korral o Süsteem töötleb juhtumeid, kus ka EHAK objekt on tühistatud. o Kui tühistatud EHAK aadress oli ühtlasi ruumiaadress, siis saab tema järglaseks ainult pindalaliselt kattuv (rohkem kui 1%) ruumiaadress (meetod AADR_T:RUUMIAADR_ALUSEL). o Kui ei olnud ruumiaadress, siis saab järglaseks tühistatud objekti järglase või järglaste aadressid (meetod AADR_T:EHAK_ALUSEL). Väikekoha ja liikluspinna aadresside ehk 4. või 5. taseme aadresside järgnevuste arvutamine. VK ja LP objektide muutumise sündmuse korral (meetod ADOB_U:VKLP) (Märkus. See meetod rakendub nii kiire kui ka tavalise järeltöötluse raames) o Süsteem leiab tühistatud aadressid, mis olid vanal versioonil ja järglaseks need, mis on lisatud uuele versioonile ja mis ei ole vanal. Need on eellaste järglaste kandidaadid. o Kui nii eellase kui järglase kandidaate on täpselt 1, siis tekib 1:1 järgnevus. AS Datel /226

202 o Kui kandidaate on rohkem, siis kontrollib süsteem kas vanal ja uuel objektiversioonil on identne täisaadressi tekst (koos kõigi paralleelaadressidega). o Kui jah on, siis valib süsteem tühistatud aadressi järglaseks identse täisaadressi tekstiga aadressi (selline peab kindlasti leiduma). o Kui ei ole, siis lisab süsteem iga tühistatud aadressi järglaseks kõik järglase kandidaadid. o Kui selle meetodiga leiti järglasi, siis kustutab süsteem varem salvestatud järglused, mis on leitud meetodiga KOMP_JARGNEVUSEST. 4. või 5. taseme komponendi lisamise sündmuse korral o Kui süsteem registreerib komponentide järgnevuse, siis automaatselt ka nende aadresside järgnevuse, mida komponendid initsialiseerivad (meetod KOMP_JARGNEVUSEST). o Selle meetodiga lisatakse järglasi ainult sellisele aadressile, millel ei ole mitte ühtegi järglast registreeritud meetodiga ADOB_U:VKLP Hoonete ja katastriüksuste aadresside ehk 6. või 7. taset sisaldavate aadresside järgnevuste arvutamine. Aadressi tühistamise sündmuse korral o Süsteem otsib kõik kehtetud objektiversioonid, millel on küljes see tühistatud aadress ning mille kehtetuks muutumise kuupäev ei ole varasem kui 30 päeva aadressi tühistamise kuupäevast. (Märkus. Kui tühistatud aadress on küljes kehtival objektiversioonil, sest seda pole veel jõutud ära vahetada, siis ei osale see objekt analüüsis. Sellisel juhul jääb järgnevuste registreerimine aadressi lisandumise sündmuse järeltöötlemise hooleks.) o Süsteem leiab samade objektide kehtivad versioonid. Tühistatud objekti korral (kui kehtiv versioon puudub) leiab süsteem objekti järglaste kehtivad versioonid. Tühistatud aadressi järglaste kandidaadid on kõik kehtivad aadressid, mis seotud nende objektiversioonidega. o Kandidaatide hulgast toimub valik järgmiselt 1. Järglasteks loetakse sama lähiaadressiga aadressid (meetod AADR_T:LAHIAADRESS). 2. Kui mitte ükski ei omanud sama lähiaadressi, siis prioritiseerib süsteem järglaste objektiversioonid tähtsuse järjekorras ning järglasteks saavad kõige prioriteetsema objekti aadressid (meetod AADR_T:PRIOR_OBJ). 2.1 UN-tunnusega hoone 2.2 ilma UN-tunnuseta hoone 2.3 UN-tunnusega katastriüksus 2.4 ilma UN-tunnuseta katastriüksus. o Kui kandidaate leidus ja valik on tehtud, siis kontrollib süsteem, kas tühistatud aadressil on juba varasemast järgnevusi registreeritud. Kui jah, siis kustutab need järgnevused ning asendab uutega. AS Datel /226

203 Aadressi lisamise sündmuse korral o Süsteem otsib kõik kehtivad objektiversioonid, millel on küljes see lisatud aadress. o Süsteem leiab samade objektide vahetult eelmised versioonid. Kui aadress lisandus objekti esimesele versioonile, siis leiab süsteem objekti eellase tühistatud versiooni. o Süsteem leiab tühistatud aadressid, mis on seotud eelmise reegli alusel leitud kehtetute objektiversioonidega ning mille tühistamise kuupäev ei ole varasem kui 30 päeva objektiversiooni tühistamise kuupäevast. o Igale tühistatud aadressile rakendub järglaste otsimise algoritm samamoodi nagu kirjeldatud aadressi tühistamise sündmuse juures. Ka meetodi nimed registreeritakse samal kujul, kuigi initsiatiiv tulenes aadressi lisamise sündmusest. (Märkus. Lisatud aadress ise ei pruugi saada järglaseks, kui prioriteetsusreeglid seda ei eelda.) Hooneosade aadresside ehk 8. taset sisaldavate aadresside järgnevuste arvutamine. Aadressi tühistamise sündmuse korral o Süsteem otsib kõik kehtetud objektiversioonid, millel on küljes see tühistatud aadress ning mille kehtetuks muutumise kuupäev ei ole varasem kui 30 päeva aadressi tühistamise kuupäevast. (Märkus. Kui tühistatud aadress on küljes kehtival objektiversioonil, sest seda pole veel jõutud ära vahetada, siis ei osale see objekt analüüsis. Sellisel juhul jääb järgnevuste registreerimine aadressi lisandumise sündmuse järeltöötlemise hooleks.) o Süsteem leiab samade objektide kehtivad versioonid. Tühistatud objekti korral (kui kehtiv versioon puudub) leiab süsteem objekti järglaste kehtivad versioonid. Tühistatud aadressi järglaste kandidaadid on kõik kehtivad aadressid, mis seotud nende objektiversioonidega. o Kandidaatide hulgast toimub valik järgmiselt 1. Järglasteks loetakse sama lähiaadressiga aadressid (meetod AADR_T:LAHIAADRESS). 2. Kui mitte ükski ei omanud sama lähiaadressi, siis on järglasteks kõik leitud aadressid, prioritiseerimist reaalselt ei toimu (meetod AADR_T:PRIOR_OBJ). o Kui kandidaate leidus ja valik on tehtud, siis kontrollib süsteem, kas tühistatud aadressil on juba varasemast järgnevusi registreeritud. Kui jah, siis kustutab need järgnevused ning asendab uutega. Aadressi lisamise sündmuse korral o Süsteem otsib kõik kehtivad objektiversioonid, millel on küljes see lisatud aadress. o Süsteem leiab samade objektide vahetult eelmised versioonid. Kui aadress lisandus objekti esimesele versioonile, siis leiab süsteem objekti eellase tühistatud versiooni. AS Datel /226

204 o Süsteem leiab tühistatud aadressid, mis on seotud eelmise reegli alusel leitud kehtetute objektiversioonidega ning mille tühistamise kuupäev ei ole varasem kui 30 päeva objektiversiooni tühistamise kuupäevast. o Kandidaatide hulgast toimub valik järgmiselt 1. Eellaseks loetakse sama lähiaadressiga aadressid (meetod AADR_L:LAHIAADRESS). 2. Kui mitte ükski ei omanud sama lähiaadressi, siis on eellasteks kõik leitud aadressid, prioriseerimist reaalselt ei toimu (meetod AADR_L:PRIOR_OBJ). o Järgnevus registreeritakse sel juhul, kui sellist veel ei ole. Varem registreeritud järgnevusi ei kustutata. Mitmeste järgnevuste leidmine on ebatõenäoline. Mistahes aadressi järgnevuse registreerimine Süsteem otsib, kas tühistatud aadress on järglaseks mõnele veel varem tühistatud aadressile. Kui jah, siis kopeerib äsja lisatud järglased ka sellele, kusjuures varasemaid järglusi selle tegevuse käigus ei kustutata (meetod AADR_JARGNEVUSEST). Aadressi järgnevuse eemaldamine Kui süsteem eemaldab töö käigus mõne varem registreeritud järgnevuse, kuna lisandus parem järglane, siis kontrollib süsteem, kas sama järglane on kopeeritud ka eellase-eellaste külge meetodiga AADR_JARGNEVUSEST. Kui jah, siis eemaldab ka eellase-eellaste juurest. Käsitsi aadressi järgnevuse registreerimine Süsteem registreerib kasutaja poolt etteantud järgnevuse alati, kui eellane on kehtetu ja järglane kehtiv aadress. Mingeid täiendavaid piiranguid süsteem ei sea (meetod KASITSI). AS Datel /226

205 9. Mõõdistusandmete importfaili kirjeldus Alljärgnevalt kirjeldatakse katastriüksuste ja hoonete kujude importimiseks kasutatava tekstifaili kokkuleppelist struktuuri. Struktuur sarnaneb katastrisse esitatava piiriandmete faili struktuuriga, kuid vähendatud mahus. Märkus. ADS süsteemis saab katastriüksuste kujusid importida ka Maaregistri nõuete kohaselt koostatud piiriandmete importfailist. Alljärgnevalt kirjeldatakse lihtsustatud struktuuri, millega saab importida nii hoonete kui ka katastriüksuste kujusid. Faili nimi ja laiend Faili nimi ei ole oluline. Faile töödeldakse ükshaaval ning üleslaadimisel nimetab ADS süsteem faili ümber. Kui faili kasutatakse objektide menetlusse laadimiseks, siis tohib ta sisaldada kooraga mitu objekti. Kui faili kasutatakse ühe objekti kontekstis, siis tohib ta sisaldada korraga ainult ühe objekti kuju. Fail peab olema lihtne txt-laiendiga tekstifail, mille saab toota programmidega Notepad, WordPad, Microsoft Word ja Excel. Viimase kolme puhul tuleb määrata Save as type Text document või MS-DOS text. Fail peab olema ANSI-encoding uga, kui ta sisaldab ka tähti. Nõuded kujule Ühe objekti kuju tohib olla kas punkt või pind. Pind tohib koosneda ainult ühest välispiirist, millel võib esineda üks või mitu sisepiiri. Lahustükid ei ole objektil lubatud. Lahustükid tuleb ADS süsteemis luua erinevate aadressiobjektidena. Punkt tohib koosneda ainult ühest koordinaatpaarist multipunkt ei ole lubatud. Pindobjektil, nii välis- kui ka sisepiiridel, peab esinema vähemalt 3 punkti. Esimest ja viimast punkti, mis piiri sulgeb, ei pea kordama. Kui see siiski kordub, siis süsteem eemaldab selle automaatselt viga ei ole. Koordinaadid tuleb esitada 2-dimensionaalses L-Est koordinaatsüsteemis täpsusega kuni 2 kohta peale koma. Faili struktuur ; siia tuleb kirjutada aadress või ADS_OID X Y X Y X Y X Y X Y X Y X Y X Y X Y X Y Peab järgnema reavahetus ja siis algavad kohe koordinaadid: kõigepealt 7-kohaline x-koordinaat ja siis 6-kohaline y-koordinaat Iga koordinaatpaar uuel real Kümnendkoha eraldajaks punkt või koma tühi rida sisepiiri eraldamiseks, kui selline eksisteerib algab sisepiir Fail peab algama semikooloniga ; Faili alguses võivad esineda tühikud ja reavahetused, neid süsteem ignoreerib. Esimene loetav sümbol failis peab olema semikoolon. Semikoolonile järgneb objekti AS Datel /226

206 aadress uute objektide puhul või ADS_OID olemasolevate objektide puhul. Kui mõlemad puuduvad, siis peab semikoolonile järgnema reavahetus ja siis käsitleb süsteem seda uue ilma aadressita objektina. Pärast reavahetust peavad kohe algama koordinaadid. Tühja rida ei või esineda. Koordinaatide x ja y väärtused peavad olema numbrid, kusjuures komakoha eraldajaks võib olla kas punkt või koma. X-koordinaat on 7-kohaline number, millele võib järgneda kuni 2 komakohta. Y- koordinaat on 6-kohaline number, millele võib järgneda kuni 2 komakohta. Kui komakohti on rohkem, siis süsteem ümardab koordinaadid täpsusega 2 kohta peale koma, viga ei ole. X ja Y väärtuse eraldajaks võib olla tühik, ka mitu tühikut järjest või tab. Koordinaatpaaride eraldajaks on reavahetus. Sisepiir eraldatakse välispiirist tühja reaga. 2 või enam tühja rida ei ole viga. Mitme sisepiiri korral eraldatakse need üksteisest samuti tühja reaga. Faili lõpus võivad esineda tühikud või reavahetused, kuid ei või esineda mingeid muid sümboleid. Kui fail sisaldab mitu objekti, siis algab järgmine objekt taas semikooloniga. Semikoolonit loetakse objekti alguse tähiseks. See peab olema uue rea esimene sümbol. Kahe objekti vahele võib jääda ka mitu reavahetust. 9.1 Näited Näide 1. AS Datel /226

207 Korrektse faili näidis. Sisaldab 2 uut objekti koos aadressiga. Koordinaatide eraldajaks on tühik. Kümnendkoha eraldajaks punkt. Näide 2 Korrektse faili näidis. Sisaldab 1 uue ja 1 olemasoleva katastriüksuse. Uus üksus on ilma aadressita. Koordinaatide eraldajaks on tab-sümbol. Kümnendkoha eraldajaks koma. AS Datel /226

208 Näide 3. Korrektse faili näidis. Sellel pildil on esimene objekt 2 sisepiiriga, teine objekt ainult välispiiriga. Pindobjekti piiridel on esimene ja viimane punkt dubleeritud, mida pole tarvis, kuid see ei sega. Näide 4. Korrektne punkti importfail AS Datel /226

209 Näide 5. Ebakorrektne importfail. Sisaldab järgmisi vigu: enne semikoolonit esineb tekst semikoolonile ei järgne koordinaadid, vaid teine semikoolon kahe piiri vahel esineb tekst pärast sisepiiri esineb veel teksti, mida ei saa käsitleda järgmise sisepiirina ega järgmise objektina 10. Väljavõtted Kõik ADS süsteemi andmed on avalikud ja tasuta kättesaadavad nt ADS-i avalikust päringurakendusest ( ADS süsteem genereerib väljavõtteid automaatselt. ADS süsteemiga liidestujatel on vaja analüüsida oma andmeid vastu ADS andmeid, et teha liidestumiseks vajalikku eeltööd. Väljavõtetega tagatakse X-teel kättesaadavate aadressiandmete allalaadimise võimalus, kuid X-tee teenuste kaudu väljavõtete tegemine on tülikas, ebaoptimaalne ja väga aeganõudev. X-tee teenuste kaudu on soovitav pärida ainult muudatusi. AS Datel /226