4. Teenused | RIA andmevahetuse abikeskus

Teenuste kirjelduste nimekiri

Teenuste kirjelduste vaatamiseks valida vasakmenüüst "Teenused", misjärel avatakse kaks nimekirja: Teenuste kirjelduste nimekiri (ülemine) ja Teenuste nimekiri (alumine).

Teenuste kirjeldusi ja teenuseid saavad kõik kasutajad kuvatud väljade järgi filtreerida. Skaneerimise algust, ATVsse saatmise aega ja viimase muutmise aega saab filtreerida kuupäeva alusel, skaneerimise sagedust rippmenüü valikute alusel, kõiki muid välju vabatekstiliselt.

Andmehalduritel on võimalik lisada uus teenuse kirjeldus kasutades selleks nuppu "+ Lisa teenuse kirjeldus” (vt ptk Teenuste lisamine ja muutmine).

Kõikidel kasutajatel on võimalik vaadata teenuste kirjelduse detailandmeid vajutades teenuste kirjelduse nimetuse lingile (vt ptk Teenuste kirjelduse detailandmed).

Teenuste kirjelduse detailandmed

Teenuste kirjelduse detailsemate andmete vaatamiseks vajutada teenuste kirjelduste nimekirjas (vt ptk Teenuste kirjelduste nimekiri) tema nimetuse lingile.

Andmehalduritel on võimalik:

muuta teenuste kirjelduse andmeid, tehes vajalikud muudatused ja vajutada nupule "Salvesta" (vt ptk Teenuste lisamine ja muutmine).
eemaldada teenuste kirjelduse andmed (sh teenused), vajutades nupule "Eemalda" (vt ptk Teenuste kirjelduste eemaldamine RIHAKEsest ja ATVst).

Teenused tekivad automaatselt - RIHAKE skaneerib andmehalduri poolt määratud ajal teenuste kirjeldusse lisatud teenuste kirjelduse urli ning pärib teenuste info, mida kasutaja näeb teenuste nimekirjas.

Kõikidel kasutajatel on võimalik vaadata teenuste detailandmeid vajutades teenuse nimetuse lingile (vt ptk Teenuse detailandmed).

Teenuste nimekiri

Teenuste vaatamiseks valida vasakmenüüst "Teenused", misjärel avatakse kaks nimekirja: Teenuste kirjelduste nimekiri (ülemine) ja Teenuste nimekiri (alumine).

Teenuste nimekirja näeb ka teenuste kirjelduse detailvaates (vt ptk Teenuste kirjelduse detailandmed).

Kõikidel kasutajatel on võimalik vaadata teenuste detailandmeid vajutades teenuse nimetuse lingile (vt ptk Teenuse detailandmed).

Teenuse detailandmed

Teenuse detailsemate andmete vaatamiseks vajutada teenuste nimekirjas (vt ptk Teenuste nimekiri) tema nimetuse lingile.

Kui andmeteenuse skaneerimine ei ole võimalik, siis saab lisada käsitsi otspunkti URLi.

Kõikidel kasutajatel on võimalik vaadata teenuste detailandmeid, vajutades teenuse nimetuse lingile (vt ptk Teenuste nimekiri).

Teenuste lisamine ja muutmine

Teenuste lisamiseks tuleb lisada teenuste kirjeldus. Andmehaldurid saavad lisada uue teenuse kirjelduse, kasutades selleks nuppu "+ Lisa teenuse kirjeldus" (vt ptk Teenuste kirjelduste nimekiri).

Täita teenuste kirjelduse andmed.

Väli	Selgitus
Teenuse nimetus ATVs	Juhul kui kasutaja tahab pärida juba ATVs avaldatud teenuse andmed, saab siia valida rippmenüüst teenuse nimetuse ATV-s. Seejärel täidetakse ülejäänud kirjelduse väljad kirjeldusega ATV-s.
Pealkiri	Teenuste kirjelduse täielik nimetus.
Viide andmestikule	Võimalik siduda teenus konkreetse andmestikuga. Informatiivne väli.
Viide levitusele	Otsing-valikkast võimaldab siduda teenusega mitu levituse kirjeldust. Valikusse kuvatakse kõik olemasolevate mittekustutatud levituste kirjelduste nimed.
Viide AK dokumentatsioonile	Teenuse dokumentatsiooni viide (url), mis on nähtav asutuse kasutajatele. ATVsse ei saadeta
Kohalduvad õigusaktid	Rippmenüü teenusele kohalduvate õigusaktide valimiseks. Kohustuslik HVD, ODD ja DGA kohaldamisalasse kuuluvate teenuste puhul. Väärtuse “HVD” lisamisel lisatakse automaatselt ka väärtus “ODD”, sest väärtuslike andmestikega seotud teenused on alati seotud ka avaandmestikega. Väärtuse “ODD” eemaldamiseks tuleb kõigepealt eemaldada väärtus “HVD”. NB! Kui kasutaja on sisestanud väljale “HVD kategooria” väärtuse ja väljal “Kohalduvad õigusaktid” on väärtus HVD valimata, siis lisatakse see automaatselt. Kui kasutaja on HVD kategooria lisanud ekslikult, siis saab väljalt “Kohalduvad õigusaktid” väärtuse “HVD” eemaldada ainult peale HVD kategooria eemaldamist.
HVD kategooria	Rippmenüü väärtusliku andmestiku kategooria valmiseks. Saab valida mitu väärtust. Kohustuslik väärtuslike andmestike (HVD) kirjeldamisel. NB! Kui kasutaja on sisestanud väljale “HVD kategooria” väärtuse ja väljal “Kohalduvad õigusaktid” on väärtus HVD valimata, siis lisatakse see automaatselt. Kui kasutaja on HVD kategooria lisanud ekslikult, siis saab väljalt “Kohalduvad õigusaktid” väärtuse “HVD” eemaldada ainult peale HVD kategooria eemaldamist.
Viide teenuse dokumentatsioonile	Viide veebilehele, kus asub teenuse tervikdokumentatsioon. Kohustuslik HVD andmestikega seotud andmeteenuste puhul.
Juurdepääsutingimused	Juhul, kui andmeteenust kasutatakse levituse pakkumiseks, võimaldab lisada viite juurdepääsutingimusi põhjalikumalt kirjeldavale veebilehele või vabatekstilise juurdepääsuõiguste kirjelduse.
Kasutuslitsents	Rippmenüü andmeteenusele kohalduv kasutuslitsentsi valimiseks.
Viide otspunktile	Viide API peamisele otspunktile või pöördumistele. Kasutama peaks püsivat viidet. Kohustuslik juhul, kui “Teenuste kirjelduse URL” on sisestamata. Täita juhul, kui ei ole võimalik teenuse kirjeldust skaneerida (vormil jaotis “Skaneerimise seadistamine”), et otspunkti viiteid ja kirjeldusi automaatselt pärida.
Otspunkti kirjeldus	Viide või selle puudumisel vabatekstina lisatud kirjeldus otspunkti kaudu kättesaadavate teenuste kirjeldusele. Otspunkti kirjeldusi saab lisada mitu. Otspunkti kirjelduse andmevälja suurust on kasutajal võimalik muuta.
Kontaktpunkt	Rippmenüü asutuse üldkontaktidest kontakti valimiseks, mida saab kasutada andmestiku kohta kommentaaride edastamiseks. Kontakti nime valimisel kuvatakse kontakti nimi, e-posti aadress ja/või telefoninumber.
Skaneerimise seadistamine
Teenuste kirjelduse URL	Teenuste kirjelduse url - skaneeritav url, millega saab otspunktide kirjeldused kätte. Kohustuslik juhul, kui “Viide otspunktile” on sisestamata. Kui teenuseid ei saa skaneerida, siis lisada otspunkti viide/viited käsitsi väljale “Viide otspunktile”.
Kuupäev ja kellaaeg	Esimese skaneerimise (otspunktide info pärimise) kuupäev ja kellaaeg. Skaneerimise aja muutmine: Muuta skaneerimise algust ja skaneerimise kordust ning vajutada nupule "Salvesta". Aja saabudes süsteem käivitab skaneerimise ja skaneerimise lõppedes saadab e-kirjaga teavituse andmehalduritele ja neile andmeomanikele, kes on andmestikule omanikuks määratud.
Skaneerimise sagedus	API teenuste skaneerimise korduvus.

Andmete salvestamiseks vajutada nupule "Salvesta". Kui salvestamine õnnestub, siis suunatakse tagasi teenuste kirjelduste nimekirja lehele (vt ptk Teenuste kirjelduste nimekiri), kus on võimalik näha ka lisandunud teenused (vt ptk Teenuste nimekiri).

Teenuste kirjelduste pärimine ja salvestamine ATV-st RIHAKE-sse

Teenuse kirjeldust saab ATVst pärida teenuse lisamise etapis (vt ptk Teenuste lisamine ja muutmine ). Lisades uue teenuse, tuleb lisamise-muutmise vormis väljale “Teenuse nimetus ATVs” valida rippmenüüst soovitud nimetus. Nimetuse järgi päritakse teenuse kirjeldus ATV-st ja täidetakse vormi väljad metaandmetega. Lisatud teenust saab salvestada siis, kui on täidetud kõik kohustuslikud väljad.

Kui teenus on ATV-s seotud andmestikuga, mis puudub RIHAKEsest, tuleb sidumiseks pärida või lisada andmestik ka RIHAKEsse. Seejärel saab väljal “Viide andmestikule” rippmenüüst valida õige andmestiku. Tulekul: Sama kehtib seotud levituste kohta - seose saab luua RIHAKEses olevate levitustega. Teenuse sidumiseks RIHAKEsest puuduva levitustega tuleb lisada või pärida vastav andmestik ja levitus RIHAKEsse.

Teenuste kirjelduste eemaldamine RIHAKE-sest ja ATV-st

Teenuse/teenuste eemaldamiseks tuleb eemaldada teenuste kirjeldus. Andmehaldurid saavad eemaldada teenuste kirjelduse, sellega seotud teenused ning skaneerimise taimeri, kasutades selleks nuppu "Eemalda" (vt ptk Teenuste kirjelduse detailandmed). Kui eemaldamine õnnestub, siis suunatakse tagasi teenuste kirjelduste nimekirja lehele (vt ptk Teenuste kirjelduste nimekiri). Koos teenusega märgitakse kustutatuks teenuse seosed andmestikega, levitustega, kohalduvate õigusaktidega ja HVD kategooriatega ning kasutajale kuvatakse teenuste kirjelduste nimekiri, kus enam kustutatuks märgitud teenuse kirjeldust ei kuvata.

Kui eemadatav teenuse kirjeldus on ATV-sse saadetud, kuvatakse kasutajale teadet, et teenuse kirjelduse kustutamisel RIHAKEses kustutatakse teenuse kirjeldus ka teabeväravas. Kui kasutaja kinnitab teenuse kirjelduse eemaldamise, käivitatakse ATVs teenuse kirjelduse kustutamise protsess, mida saab jälgida taustatoimingute sahtlist. NB! Protsessi jälgimine taustatöödes tuleb järgmises versioonis. Kui ATV-s kustutamine ebaõnnestub, ei kustutata teenuse kirjeldust ka RIHAKEsest.

Teenuste kirjelduste saatmine ATV-sse

Teenuste kirjeldusi saab ATVsse saata andmehaldur ja teenuse kirjeldusega seotud andmestike omanik. Andmeteenuse ATVsse saatmiseks valida teenuste kirjelduste nimekirjast soovitud üks või mitu teenust ja vajutada nupule "Saada teenused ATVsse".