Andmete teabevärava üldjuhend
Teabevärava päis
Teabevärava päises vasakul asub andmete teabevärava logo, mille kaudu saab igast vaatest liikuda teabevärava avalehele. Sinisel ribal asuvad valikud lubavad kasutajal liikuda teabevärava alamlehtedele: Avaleht, Andmestikud, Teabevaldajad, Kasutuslood, Sõnastikud.
Paremal saab kasutaja valida eesti ja inglise keele vahel ning sisse logida. Sisse logituna saab kasutaja vahetada eraisiku ja seotud asutuse vaadet ning pääseda ligi töölauale.
Teabevärava jalus
Teabevärava jaluses korratakse andmete teabevärava logo, mille kaudu saab igast vaatest liikuda teabevärava avalehele. Selle kõrval asuvad viited teabevärava juhistele ja kasutajatoe e-posti aadressile. Järgmises plokis saab kasutaja anda teabeväravale tagasisidet, lugeda ja osaleda aruteludes ning tutvuda teabevärava statistikaga.
Tagasiside: kasutaja saab tagasisidet anda 5-palli süsteemis, antud hinnangut tuleb ka kommenteerida. Tagasiside kajastub teabevärava statistikas.
Arutelusid saavad lugeda kõik kasutajad, lisada ja kommenteerida vaid sisse logitud kasutajad. Arutelude alla on koondatud 3 teemat:
andmestike detailvaates andmestikele lisatud kommentaarid - arutelude vaates uusi kommentaare lisada ei saa;
teabevaldajate vaates lisatud uute andmestike soovid ja vastused neile - uue andmestiku soovi saab esitada ka arutelude vaates, kasutaja saab anda oma hääle juba esitatud soovile;
vaba teema - uut andmeteemalist arutelu saab algatada vaid arutelude vaates, klikkides nupule "Loo uus arutelu".
Statistika alla koondatakse statistika teabevärava andmestike ja nende kasutamise kohta.
Avaleht
Avalehe taustapildil kuvatakse teabeväravas avaldatud andmestike ja andmeteenuste, aktiivsete teabevaldajate ja kirjeldatud kasutuslugude arv ning nende arvu muutus 30 päeva jooksul.
Kiirotsingu all on kuvatud teabevärava kirjeldus, selle all ikoonidena "Väärtuslikud andmestikud (HVD)" ning Euroopa Andmeportaalist üle võetud valdkonnad. Iga andmestiku liigi ikoonil kuvatakse ka avaldatud andmestike arv. Ikoonile klikkides suunatakse kasutaja andmestike lehele, kus kuvatakse valitud valdkonna andmestikud. Vajutades valdkondade all valikule "Vaata kõiki andmestikke", suunatakse kasutaja samuti andmestike lehele, kus kuvatakse kõik andmestikud.
Andmestikud
Andmestike leht on mõeldud andmestike, andmestike sarjade ja andmeteenuste kuvamiseks. Kui andmeteenus on seotud konkreetse andmestikuga, siis kuvatakse seda pigem andmestiku all.
Alamlehe kirjelduse all asub kiirotsing, kus andmestikke saab otsida vabateksti, teabevaldaja ja levituse vormingu järgi. Otsingu all asuvad nupud "Väärtuslikud andmestikud (HVD)" ja "ITS-NAP andmestikud", mis avavad uuel lehel vastavalt väärtuslike andmestike või ITS määrustega reguleeritud liikuvusandmestike nimekirja.
Kasutaja võib avada ka detailotsingu, kus lisaks saab andmestikke otsida täpsema valdkonna, märksõnade, piirkonna ja lisamise aasta alusel.
Otsingu all kuvatakse otsinguga leitud tulemused - eraldi saab vaadata kõiki tulemusi, leitud andmestikke, andmestike sarju ja andmeteenuseid. Juhul kui midagi ei ole otsitud, kuvatakse kõik teabeväravas avaldatud andmestikud, sarjad ja andmeteenused. Leitud tulemuste kohta näidatakse lühikirjeldust, iga tulemuse pealkirjale vajutades avaneb andmestiku, sarja või andmeteenuse detailinfo.
Teabevaldajad
Teabevaldajad on reeglina avaliku sektori, seahulgas kohalike omavalitsuste asutused ning kolmanda sektori asutused, kelle kogutud andmed pakuvad kasutajatele teavet ja võimalusi juba kogutud andmeid taaskasutada. Teabevaldajate nimekiri on esitatud tähestiku järjekorras ja neid saab ka otsida lehel asuva lihttekstiotsinguga.
Nimekirjas teabevaldaja nimele klikkides avaneb teabevaldaja alamleht, kus on kuvatud asutuse kirjeldus, kontaktinfo ning teabevaldaja poolt avaldatud andmestike nimekiri koos iga andmestiku lühikirjeldusega. Nimekirjast pääseb edasi andmestiku alamlehele.
Teabevaldaja alamlehelt saab sisselogitud kasutaja esitada ka uue andmestiku soovi teabevaldajale.
Kasutuslood
Kasutuslugude lehele on koondatud asutuste ja eraisikute poolt loodud rakendused, mis lubavad kasutajatel avaandmeid mugavamalt tarbida. Kasutuslugusid saab valida nimekirjast või otsida vabatekstina, autori ja kasutusloo piirkonna järgi. Kasutusloo ikoonile klikkides avaneb kasutusloo kirjeldus ning läbi veebiviite saab ligipääsu rakendusele.
Sõnastikud
Sõnastike leht koondab asutuse äri- ja andmesõnastikke.
Ärisõnastik esitab organisatsioonis kasutatavaid mõisteid, mida kasutatakse asutuses igapäevaselt rääkides või mis on kasutusel õigusaktides või tehnoloogias.
Andmesõnastik on seotud konkreetse andmestikuga ja selle eesmärk on andmeelementide tähendust kasutajatele selgitada. Selleks esitatakse andmestiku andmeelementide tähised arusaadavate terminitena.
Töölauas vaates kasutaja seadete haldamine
Sisse logitud kasutajale kuvatakse päises paremal nuppu "Töölaud", millele klikkides saab ligipääsu töölauale.
Eraisikuna sisse logituna saab kasutaja sisestada oma e-maili ja hallata e-posti teavitusi, määrata oma kasutajatüübi, näha endaga seotud asutusi ja lisada end uue asutuse esindajaks.
"Minu toimingud" annab kasutajale ülevaate tema juurdepääsutaotlustest andmestikele, tema esitatud andmesoovidest ja privaatsuse rikkumise teatistest ning kasutaja osalemisest aruteludes.
"Minu kasutuslood" kuvab kasutaja poolt teabeväravas avaldatud kasutuslugude teabe. Uue kasutusloo lisamiseks
Kasutaja saab töölaua vaatest teavitada ka oma privaatsuse rikkumisest mõne andmestikuga seoses, näha oma juurdepääsu tokeneid ja luua uut masinliidestuse võtit (NB! masinliidestuse võtme loomine liigub peagi eraisiku vaatest asutuse töölaua vaatesse, kuna seda kasutab asutus).
Asutusega seotud kasutaja näeb asutuse alt sisse logituna asutuse töölauda. Asutuse töölaua vaates on rohkem võimalusi kasutajatel, kellel on asutuse esindajana kõik õigused.
Kõik asutuse kasutajad näevad asutuse kontaktisikut, tema e-maili, asutuse kirjeldust ja profiilipilti.
"Asutuse andmestikud" annab ülevaate asutuse avaldatud andmestikest ("Asutuse andmestikud"), avaldamata andmestikest, mille staatus on "pooleli" või "mustand" ("Avaldamata andmestikud”), avaldatud andmestikest, mille URL on vigane ja sellele ei pääse ligi ("Vigased andmestikud") ning kõigist andmestikest kokku ("Kõik andmestikud"). Selles vaates saavad kasutajad lisada ka käsitsi uusi andmestikke.
"Asutuse toimingud" annab ülevaate asutuse andmestikele esitatud juurdepääsutaotlustest, andmesoovidest asutusele, asutuse andmestike all esitatud privaatsuse rikkumise teatistest ja asutusega seotud aruteludest.
"Asutuse kasutuslood" kuvab asutuse poolt lisatud kasutuslugude info. Siit vaatest saab lisada ka asutuse uue kasutusloo.
Asutuse kõigi õigustega kasutajad saavad ka lisada asutuse kontaktisikut ja tema e-maili (need võiksid olla pigem üldised ja seotud rolliga, mitte konkreetse isikuga), hallata sisestatud e-posti aadressile saadetavaid e-posti teavitusi ning lisada asutuse kirjeldust ja profiilipilti (kuni 2MB fail, 200x200px).
"Volitatud isikud" annab ülevaate asutusega seotud kasutajate andmetest. Kõigi õigustega asutuse esindaja saab seotud isikute volitusi muuta ning kustutada ja lisada uusi volitatud isikuid.
"Ligipääsu avaldused" sisaldab kasutajate taotlusi asutusega sidumiseks. Kõigi õigustega asutuse esindaja saab avalduse heaks kiita ja määrata kasutaja volitused või avalduse tagasi lükata.
Uue andmestiku ja seotud elemendi lisamine
Andmestikku on kõige lihtsam lisada läbi rakendusliidese, genereerides kõigepealt API võtme, vt https://abi.ria.ee/teabevarav/organisatsiooni-autentimine-api-kaudu-andmete-edas ja https://abi.ria.ee/teabevarav/atv-mirroring-jobs-api-v2
Andmeteenuseid, andmestike sarju, sõnastikke koos terminitega ja andmestiku andmeelemente saab lisada vaid läbi rakendusliidese. Kui on soov lisada andmestikule hulgaliselt levitusi failidena, saab seda samuti teha läbi rakendusliidese. Kõiki nimetatud elemente saab läbi rakendusliidese ka muuta ja kustutada.
Andmestikku saab lisada ja muuta ka läbi kasutajaliidese. Selleks peab kasutaja olema teabeväravasse sisse logitud andmestikku omava teabevaldaja esindajana.
Uut andmestikku saab lisada töölaua "Minu andmestikud" vaates või andmestike alamlehe vaates, kus klikkides nupule "Lisa uus andmestik" avaneb andmestiku vorm. Vormil on kuus sammu Selleks, et andmestik avaldada, tuleb täita vähemalt kohustuslikud väljad, mis on tähistatud tärniga.
Iga sammu lõpus saab kasutaja valida, kas jätkab andmestiku kirjeldamisega või jätab senise töö mustandiks. Kui valida viimase sammu lõpus "Salvesta andmestik", siis andmestik salvestatakse ja avaldatakse.
Väli | Selgitus |
|---|---|
Vormi samm 1. Üldkirjeldus | |
Pealkiri* | Andmekogu korral selle pidamist reguleerivas õigusaktis toodud ametlik pealkiri. Muu andmestiku puhul võimalusel õigusaktis toodud täielik nimetus või praktikas kasutatav täielik nimetus. |
Pealkiri (inglise keeles)* | Andmekogu korral selle pidamist reguleerivas õigusaktis toodud ametlik pealkiri. Muu andmestiku puhul võimalusel õigusaktis toodud täielik nimetus või praktikas kasutatav täielik nimetus inglise keeles. |
Lühinimetus | Andmestiku lühinimetus. |
Kirjeldus* | Andmestiku pidamise eesmärgi ja andmete sisuline lühikirjeldus. Andmekogu korral selle asutamise õigusaktis toodud eesmärk koos sisu kirjeldusega; muude andmestike korral loomise kirjeldus. |
Kirjeldus (inglise keeles)* | Andmestiku pidamise eesmärgi ja andmete sisuline lühikirjeldus inglise keeles. |
Tüüp | Kirjeldatava andmestiku tüüp loendist, vaikimisi "andmestik" |
Valdkonnad* | Andmestiku valdkond Eesti märksõnastikust. Märksõna lisamisel tekivad valdkonnad automaatselt. |
Märksõnad | Valdkondadega seotud märksõnad. Kui lisada märksõna, siis RIHAKE lisab selle märksõnaga seotud valdkonnad väljale "Valdkond" automaatselt juhul, kui see valdkond juba väljal olemas ei ole. |
Kasutusele võtmise kuupäev* | Andmestiku elektroonilise pidamise algusaeg (andmestiku haldamiseks loodud infosüsteemi kasutusele võtmise kuupäev) |
Avalikustamise kuupäev | Kasutatakse avaandmete puhul, andmestiku ametliku avalikustamise kuupäev. |
Kontaktpunkt | Organisatsioon või üksikisik, kelle poole andmestiku ja taaskasutamise küsimustes pöörduda. Kontakte saab lisada mitu. |
Kontaktpunkt: kontakti nimi* | Organisatsiooni või üksikisiku täisnimi. |
Kontaktpunkt: kontakti e-posti aadress* | Nimele vastav e-posti aadress. Kohustuslik on lisada kas e-post või telefoninumber. |
Kontaktpunkt: kontakti telefoninumber* | Nimele vastav telefoninumber. Kohustuslik on lisada kas e-post või telefoninumber. |
Andmestiku seos teise andmestikuga | Alljärgnevalt saab valida 4 liiki seoseid muude andmestikega |
On osa andmestikust | Valida loetelust andmestik, mille osa on kirjeldatav andmestik. |
Sisaldab alamandmestikke | Valida loetelust andmestik(ud), mis on osa kirjeldatavast andmestikust. |
Asendab eelneva andmestiku | Kui kirjeldatav andmestik asendab teist andmestikku (osaliselt või täielikult), siis valida asendatav andmestik. |
Asendatakse järgneva andmestikuga | Kui kirjeldatav andmestik asendatakse teise andmestikuga (osaliselt või täielikult), siis valida asendav andmestik. |
Teabevaldaja* | Asutuse täielik nimi - täidetud juba asutuse nimega, kelle kontolt vormi täidetakse. |
Vormi samm 2. Andmekorje alused |
|
Õiguslik alus | Andmestiku loomise ja haldamise aluseks olev õigusakt, saab lisada mitu. |
Õiguslik alus: Õigusakti nimetus | Aluseks oleva õigusakti ametlik pealkiri. |
Õiguslik alus: Õigusakti link | Viide andmestiku loomise ja haldamise aluseks olevale õigusaktile, eelistatud Riigi Teatajasse. |
Andmete päritolu: päritoluandmestiku pealkiri | Teise andmekogu nimetus, millest andmestiku andmed on päritud. Saab valida loendist või lisada vabatekstina. Võib valida mitu. |
Seotud tegevus | Loetelu organisatsiooni tegevustest, mille käigus andmestik tekib ja täieneb. Andmekogu korral tuleks sisestada selle asutamise õigusaktis toodud tegevused. Saab lisada mitu. |
Seotud tegevus (inglise keeles) | Loetelu organisatsiooni tegevustest, mille käigus andmestik tekib ja täieneb inglise keeles. |
Vormi samm 3. Andmestiku sisu |
|
Keel | Andmestikus kasutatud keel(ed). Vaikimisi on valitud "eesti". Saab valida mitu. Otsida saab keele nimetuse tekstiosa järgi. |
Ruumiline kaetus | Andmetega kaetud piirkond või asukoht, maksimaalselt "kogu Eesti", võimalik kuni valla/linna tasemeni. Vaikimisi on valitud "Kogu Eesti". |
Andmete piirdaatumid: algusaeg | Andmestiku kohta käiva ajaperioodi algusaeg. Piirdaatumid näitavad, millist ajaperioodi andmed katavad. Andmete piirdaatumeid ei tohi segi ajada andmekogumise või -sisestamise piirdaatumitega. |
Andmete piirdaatumid: lõppaeg | Andmestiku kohta käiva ajaperioodi lõppaeg. Piirdaatumid näitavad, millist ajaperioodi andmed katavad. Andmete piirdaatumeid ei tohi segi ajada andmekogumise või -sisestamise piirdaatumitega. |
Andmete uuendamise regulaarsus | Andmestiku andmete uuendamise regulaarsus. Vaikimisi on valitud "Ebaregulaarne". |
Veebisait | Viide veebisaidile, mis annab ligipääsu andmestikule või lisateabele andmestiku taaskasutusest. Mitte segi ajada levituse juurdepääsupunktiga. |
Vormi samm 4. Eritingimused |
|
Kohalduvad õigusaktid | Andmestikule kohalduvad EL õigusaktid. Täitmine on kohustuslik ODD (avaandmed), HVD (väärtuslikud andmestikud) ja DGA (piiratud andmestikud) puhul ja valdkondlike õigusaktide puhul, kus EL õigusaktidega on eraldi kohustused ette nähtud. |
Vastab standardile | Tehniline vorming või standard, mis kehtestab andmetele põhjalikumad nõuded või struktuuri. HVD andmestiku puhul soovituslik. Saab lisada mitu. |
Juurdepääsutase | Valida andmestiku juurdepääsutaseme kirjeldus, kohustuslik DGA andmestike kirjeldamisel. Vaikimisi väärtus "Avalik". |
HVD kategooria | Väärtusliku andmestiku kategooria, mis on kohustuslik HVD andmestiku kirjeldamisel. Saab valida mitu väärtust. |
Muu identifikaator: tüüp | Muu identifikaator on teisene viit andmestikule, näiteks DOI, valdkonnapõhine andmestiku identifikaator vms. Sisestada identifikaatori tüüp vabatekstina. HVD andmestike puhul soovituslik. |
Muu identifikaator: väärtus | Sisestatakse eelmisel real kirjeldatud identifikaatori tüübile vastav identifikaatori väärtus. |
Vormi samm 5. Levitus | Levitus on andmestiku või selle osa esitus konkreetses vormingus - näiteks fail või veebikeskkond, kus saab andmeid kasutada. Levituse kirjelduse lisamine on kohustuslik, kui vormi 4. sammus on "Kohalduvad õigusaktid" väärtus kas HVD ja/või DGA. |
Levituse kohalduv õigusakt | Levitusele kohalduvad EL õigusaktid, mis reguleerivad levituse avaldamist. Kohustuslik ODD (avaandmed), HVD (väärtuslikud andmestikud) ja DGA (piiratud andmestikud) levituste puhul. |
Levituse HVD kategooria | Väärtusliku andmestiku kategooria, mis on kohustuslik, kui “Levitusele kohalduv õigusakt” on HVD (väärtuslik andmestik). |
Levituse juurdepääsutingimused | Viide (URL) levituse juurdepääsutingimustele või tekstiline juurdepääsuõiguste kirjeldus. Kohustuslik, kui “Levitusele kohalduv õigusakt” on DGA. |
Levituse ajaline täpsus | Levituses sisalduvate andmete minimaalne eristatav ajaperiood. |
Levituse avalikustamise kestus | Ajaliselt piiratud levituse puhul kuupäev, millal levitus on viimast päeva kättesaadav. |
Levituse andmete staatus | Valida levituse andmete kvaliteediseisund. |
Kasutuslitsents | Andmetele kohalduv kasutuslitsents, kui see on määratud. |
Levituse juurdepääsupunkt | Veebileht, mis annab ligipääsu levitusele või teavet andmestiku juurdepääsukoha kohta. Mitte segi ajada elemendiga "Veebisait". Võimalik lisada kuni 20 välja. |
..või laadi levitus üles | Laadida levituse fail arvutist, lubatud mitte üle 1 faili levituse kohta. Paljude failide korraga edastamiseks tuleb kasutada APIt. |
Andmeallikaga ühenduse loomine kasutades API-t | API kaudu juurdepääsupunkti täitmine - saab hiljem juurde lisada juurdepääsupunkte API kaudu. |
Levituse vorming | Valida levituse andmete failivorming, kohustuslik DGA levituse kirjeldamisel. Üleslaetud faili puhul määrab süsteem väärtuse ise. |
Levituse suurus | Levituse faili suurus baitides, dünaamiliste teenuste kirjeldamisel märkida väärtuseks kogu andmestiku suurus. Kohustuslik DGA levituse kirjeldamisel. |
Levituse pealkiri* | Võiks sisaldada andmestiku nimetust koos levituse lühiselgitusega. |
Levituse pealkiri (inglise keeles)* | Eelmine väli inglise keeles. |
Vormi samm 6. Geoandmed | Geoandmete lisamine ei ole kohustuslik. Kui välja "Lisa geoandmeid" ette on tehtud linnuke, tuleb täita sealsed kohustuslikud väljad. |
Allika liik* | Valida rippmenüüst üks kolmest väärtusest |
Ruumiandmeteenuse liik* | Kuvatakse ainult juhul, kui "Allika liik" väärtuseks valida "Ruumiandmeteenus" - sellisel juhul on välja täitmine kohustuslik. |
Kategooria* | Väli on nähtav vaid juhul, kui allika liik = ruumiandmekogumite sari VÕI ruumiandmekogum - sel juhul on täitmine kohustuslik. Saab valida 1 või mitu väärtust. |
Koordinaatsüsteem* | Valida rippmenüüst 1 kuni mitu väärtust. |
Piksli suurus | Vabatekstiväli, väljendada meetrites. |
Ruumilise esituse tüüp* | Rippmenüüst saab valida ühe väärtuse. |
Geograafiline piirdekate: Põhja laiuskraad* | Laiuskraad tuleb ümardada kahe kohani peale koma ning eraldada punktiga |
Geograafiline piirdekate: Lõuna laiuskraad* | Laiuskraad tuleb ümardada kahe kohani peale koma ning eraldada punktiga |
Geograafiline piirdekate: Ida pikkuskraad* | Pikkuskraad tuleb ümardada kahe kohani peale koma ning eraldada punktiga |
Geograafiline piirdekate: Lääne pikkuskraad* | Pikkuskraad tuleb ümardada kahe kohani peale koma ning eraldada punktiga |
Ruumiline lahutusvõime | Vabatekstiväli, väljendada meetrites. |
Olemasoleva andmestiku muutmiseks tuleb valida "Asutuse andmestikud" vaatest andmestik ja avananud andmestiku detailandmete lehel valida "Muuda". Avanenud andmestiku vormil saab teha soovitud muutused ja vastavalt vajadusele avaldada andmestik või jätta mustandiks.
Uue kasutusloo lisamine
Uut kasutuslugu saab nii eraisik kui asutus lisada ainult käsitsi kasutajaliidesest. Selleks tuleb valida sobiv konto (kas asutus või eraisik) ja valida töölaua vaates "Minu kasutuslood" või vajutada kasutuslugude vaates nupule "Lisa uus kasutuslugu". Kasutusloo lisamiseks avaneb nupust "Lisa uus kasutuslugu" vorm, kus tuleb täita vähemalt kohustuslikud väljad.
Kasutusloo nimi - vabatekstiväljad kasutusloo nime lisamiseks eesti ja inglise keeles
Veeblilink - viide kasutusloo asukohale.
Kirjeldus - vabatekstiline kirjeldus eesti ja inglise keeles.
Kasutusloo pilt - kasutuslugu iseloomustab pilt, mida kuvatakse kasutuslugude lehel kasutusloo nime taustana.
Kasutusloo autor - kasutusloo loonud asutuse või isiku(te) nimi.
Mittekohustuslikud väljad on kasutusloo autori e-mail ja telefon, seotud andmestikud, kasutusloo ruumiline ja ajaline kaetus (piirdaatumid) ning kasutusloo loomise aeg. Kirjeldaja võib märkida, kas kasutuslugu uueneb ajas automaatselt.
Nupust "Kasutusloo lisamine" avaldatakse loodud kasutuslugu.