Lisa 1
Hanke tehniline kirjeldus
on koostatud Hankija parima oskusteabe põhiselt.
Täpsustavad küsimused, märkused ja ettepanekud tehnilise kirjelduse/lähteülesande kohta
palume kindlasti esitada enne pakkumuse esitamist!
Projekti taust ja eesmärk
Käesolev projekt on suunatud Statistikaameti eesmärkide täitmise toetamisele registripõhise
rahva ja eluruumide loenduse (edaspidi REGREL) läbiviimisel. Selleks on vajalik lõpule viia
STAR aadressiandmete süsteemi (ADS) liidestus (tagada piisava detailsusega, aadressi
objekti ID sisaldav aadressandmete olemasolu süsteemis) ning luua andmeedastuslahendus
Statistikaametile andmete edastamiseks.
Taustaks: Sotsiaalteenuste ja -toetuste andmeregistri (STAR) andmeid kasutatakse REGRELis
põhiliselt isikute alalise elukoha tuvastamisel ja leibkonna määratlemisel.
STAR on täna liidestatud ADSiga vaid osaliselt, aadresside sisestamisel kasutatakse
INADS (ADSi teenuse nimetus) teenust vaid teenuseosutajate moodulis
tegevuskohaandmete fikseerimisel.
o Puudub vastav liidestus klientide (subjektide) ja haldusasutuste
aadressandmete sisestamise osas.
o Puudub lahendus aadressimuudatuste sünkroniseerimiseks ADS muudatuste
vastu.
2017. a seisuga esitatakse Statistikaametile kokkulepitud mahus ja koosseisus andmeid
kord aastas ftp serveri kaudu, mis on tülikas lahendus nii andmete esitajale kui saajale.
Projekti tulemusel on kõik STARi lisanduvad aadressandmed vastavuses aadressandmete
süsteemi andmetega (ajaloolisi andmeid ei muudeta).
STAR teenus suudab üle X-tee andmevahetuskihi saata andmed Statistikaameti eSTAT
teenusele.
Arendusega seotud välised osapooled:
Maa- amet Muudatuste tegemise vajadus puudub,
kasutatakse olemasolevaid teenuseid (ADS)
Aadressiandmed, ning ADS X-tee teenuste
kirjeldused:
http://geoportaal.maaamet.ee/est/Andmed-ja-
kaardid/Aadressiandmed-p112.html
Rahvastikuregister (SMIT) Muudatuste tegemise vajadus puudub.
Statistikaamet (SA) Muudatuste tegemise vajadus puudub.
Kontaktisik andmehõive teenuse tehnilise poole
osas Statistikaametis on
[email protected]
Märkus:
2014.aasta lõpus realiseeris Tieto Estonia INADS lahenduse KOV moodulis menetlusel
kliendi tegeliku elukoha sisestamiseks (ekraanivorm koos INADS integratsiooniga), et oleks
võimalik piloteerida Maa-ameti poolt loodud INADS teenuse kasutatavust. ADSi poolel
tuvastatud probleemide tõttu LIVE selle lahendusega ei mindud.
Nõuded:
1 Andmehõivelahenduse loomine, millega edastatakse perioodiliselt (kord aastas) üle
x-tee Statistikaametile kokkulepitud andmestik
1.1 Sotsiaalteenuste ja - toetuste andmeregistris tuleb realiseerida Statistikaameti poolse
andmehõiveteenuse eSTAT (statistikaameti teenuse nimetus) kasutuselevõtt, edastades
kokkulepitud koosseisus REGRELi läbi viimiseks vajalikud andmed lisandunud
menetluste ja asenduskoduteenusel viibivate laste kohta.
1.2 Andmete edastamise protsess realiseerida viisil, et see ei halvaks töökeskkonna toimimist
tööajal.
1.3 Sotsiaalministeeriumi poolt edastatav sotsiaalteenuste ja -toetuste andmeregistri andmete
andmekoosseis on kirjeldatud hanke lisas 3.
1.4 Statistikaameti teenuse kirjeldus on esitatud hanke lisas 4.
2 Süsteemi lisatavate aadressiandmete vastavusse viimine aadressandmete süsteemiga
ning edasise muudatuste sünkroniseerimise tagamine
2.1 Uue menetluse algatamisel normaliseeritakse kõigi menetluse subjektide süsteemis
sisalduvad aadressandmed (Rahvastikuregister ja tegelik), tagades aadressobjekti
identifikaatori olemasolu andmebaasis (nt Maa- ameti teenus ADSobjotsing.v4)
2.2 Kui süsteemis sisalduvale rahvastikuregistri (RR) aadressile (ühest) vastet ei leita, siis
päritakse uue menetluse algatamisel RR ADS andmeid sisaldava teenuse vahendusel
andmed Rahvastikuregistrist.
2.2.1 Analüüsida täna kasutusel oleva RR96 teenuse asemel mõne väiksema
andmekoosseisuga RR teenuse kasutuselevõtu võimalust, mis annaks menetluse
algatamiseks vajaliku andmestiku. (RR96 kasutust on andmejälgija rakendumise
järgselt väga keeruline andmesubjektidele põhjendada)
2.3 Kui süsteemis sisalduvale käsitsi sisestatud tegeliku elukoha aadressile vastet ei leita,
siis suunatakse kasutaja INADS teenust kasutades andmeid sisestama.
2.3.1 Kui kliendi tegeliku elukoha andmetele vastet ADSis ei ole, peab saama
kasutaja märkida aadressi/asukoha eraldi tekstiväljale. Vastavat infot peab
kuvama ekraanivaadetes ja väljatrükkides, kus tegeliku elukoha andmeid
kuvatakse.
2.4 Haldusasutuste aadressiandmetele automaatset normaliseerimist rakendada ei ole
vajalik (Omavalitsuste liitumisel 2017.aasta lõpus tuleb sisestada palju uusi asutusi ja
aadressid peab saama lisada INADS teenust kasutades)
2.5 ADS aadressimuudatuste (nt muutub tänava või valla nimi) sünkroniseerimine igaöiselt
Maa-ameti andmeteenuse abil (nt ADSobjmuudatused.v4)
2.5.1 RR aadressiandmed uuendada automaatselt (nende ajalugu süsteemis ei hoita)
2.5.2 Tegeliku elukoha andmed – andmeid uuendatakse automaatselt ainult nendel
juhtudel, kui menetlus on muudatuse hetkel kehtiv (olekus algatatud, aktiivne,
passiivne).
Lisad:
Lisa 3 STAR_andmekoosseis_REGREL
Lisa 4 Statistikaameti liidese spetsifikatsioon
Tööde üleandmise tähtaeg:
Tellitud tööd tuleb tellijale üle anda hiljemalt 30.novembriks 2017.a.
Dokumenteerimisnõuded:
- Muuta ja täiendada muudatusega seotud kasutuslood.
- Täiendada STAR andmemudelit.
- Uuendada kood ja tarnemärkmed hiljemalt 2 tööpäeva jooksul pärast muudatuste live
keskkonda kandmist.
Tehnilist kirjeldust täpsustavad lisad
1. Muu informatsioon leitav süsteemi (STAR) dokumentatsioonist versioon 1.3 ja uuem
(Trac/svn).
2. Projekti kommunikatsioonikeskkonnana loodud Skype töögrupp, millele lisatakse
liikmeid vajadusel Hankija ettepanekul.
3. Lähtekood kättesaadav koodi repositooriumist Tieto Estonia AS tagatud keskkonnas.
4. STAR testbaas on raamlepingupartneritel olemas
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
Sotsiaalministeerium
Sotsiaalteenuste ja -toetuste andmeregistri (STAR)
arendused REGREL läbiviimiseks
STAR raamleping nr 1.8-2/ 7326 pakkumus nr 9
AS Medisoft
Tallinn 2017
1
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
Sisukord
1 KINNITUSED ................................................................................................................................................3
2 TÖÖ LÄBIVIIMISEKS KAVANDATAVAD TEGEVUSED ....................................................................4
3 PAKKUJA SISENDVAJADUSED ...............................................................................................................6
4 MAKSUMUSVORM .....................................................................................................................................7
2
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
1 Kinnitused
1. Käesolevaga kinnitame, et oleme nõus pakkumuse tingimustega.
2. Käesolevaga kinnitame, et oleme ülesande püstitusest aru saanud.
Kuupäev: 28.06.2017
Pakkuja nimi ja andmed: Medisoft AS, registrikood 10047646, Räägu 35A, 13417 Tallinn,
tel 659 5760, faks 659 5761, e-mail
[email protected]
Esindaja: Jako Heinmets, juhatuse liige
3
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
2 Töö läbiviimiseks kavandatavad tegevused
Töö eesmärk:
Käesolev projekt on suunatud Statistikaameti eesmärkide täitmise toetamisele registripõhise
rahva ja eluruumide loenduse (edaspidi REGREL) läbiviimisel. Selleks on vajalik lõpule viia
STAR aadressiandmete süsteemi (ADS) liidestus (tagada piisava detailsusega, aadressi objekti
ID sisaldav aadressandmete olemasolu süsteemis) ning luua andmeedastuslahendus
Statistikaametile andmete edastamiseks. Taustaks: Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) andmeid kasutatakse REGRELis põhiliselt isikute alalise elukoha tuvastamisel ja
leibkonna määratlemisel.
STAR on täna liidestatud ADSiga vaid osaliselt, aadresside sisestamisel kasutatakse
INADS (ADSi teenuse nimetus) teenust vaid teenuseosutajate moodulis
tegevuskohaandmete fikseerimisel.
o Puudub vastav liidestus klientide (subjektide) ja haldusasutuste
aadressandmete sisestamise osas.
o Puudub lahendus aadressimuudatuste sünkroniseerimiseks ADS muudatuste
vastu.
2017. a seisuga esitatakse Statistikaametile kokkulepitud mahus ja koosseisus andmeid
kord aastas ftp serveri kaudu, mis on tülikas lahendus nii andmete esitajale kui saajale.
Projekti tulemusel on kõik STARi lisanduvad aadressandmed vastavuses aadressandmete
süsteemi andmetega (ajaloolisi andmeid ei muudeta). STAR teenus suudab üle X-tee
andmevahetuskihi saata andmed Statistikaameti eSTAT teenusele.
Märkus: 2014.aasta lõpus realiseeris Tieto Estonia INADS lahenduse KOV moodulis
menetlusel kliendi tegeliku elukoha sisestamiseks (ekraanivorm koos INADS integratsiooniga),
et oleks võimalik piloteerida Maa-ameti poolt loodud INADS teenuse kasutatavust. ADSi
poolel tuvastatud probleemide tõttu LIVE selle lahendusega ei mindud.
4
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
Nõuded:
1 Andmehõivelahenduse loomine, millega edastatakse perioodiliselt (kord aastas) üle x-tee
Statistikaametile kokkulepitud andmestik
1.1 Sotsiaalteenuste ja - toetuste andmeregistris tuleb realiseerida Statistikaameti poolse
andmehõiveteenuse eSTAT (statistikaameti teenuse nimetus) kasutuselevõtt, edastades
kokkulepitud koosseisus REGRELi läbi viimiseks vajalikud andmed lisandunud
menetluste ja asenduskoduteenusel viibivate laste kohta.
1.2 Andmete edastamise protsess realiseerida viisil, et see ei halvaks töökeskkonna
toimimist tööajal.
1.3 Sotsiaalministeeriumi poolt edastatav sotsiaalteenuste ja -toetuste andmeregistri
andmete andmekoosseis on kirjeldatud hanke lisas 3.
1.4 Statistikaameti teenuse kirjeldus on esitatud hanke lisas 4.
2 Süsteemi lisatavate aadressiandmete vastavusse viimine aadressandmete süsteemiga ning
edasise muudatuste sünkroniseerimise tagamine
2.1 Uue menetluse algatamisel normaliseeritakse kõigi menetluse subjektide süsteemis
sisalduvad aadressandmed (Rahvastikuregister ja tegelik), tagades aadressobjekti
identifikaatori olemasolu andmebaasis (nt Maa- ameti teenus ADSobjotsing.v4)
2.2 Kui süsteemis sisalduvale rahvastikuregistri (RR) aadressile (ühest) vastet ei leita,
siis päritakse uue menetluse algatamisel RR ADS andmeid sisaldava teenuse
vahendusel andmed Rahvastikuregistrist.
2.2.1 Analüüsida täna kasutusel oleva RR96 teenuse asemel mõne väiksema
andmekoosseisuga RR teenuse kasutuselevõtu võimalust, mis annaks menetluse
algatamiseks vajaliku andmestiku. (RR96 kasutust on andmejälgija rakendumise
järgselt väga keeruline andmesubjektidele põhjendada)
2.3 Kui süsteemis sisalduvale käsitsi sisestatud tegeliku elukoha aadressile vastet ei
leita, siis suunatakse kasutaja INADS teenust kasutades andmeid sisestama.
2.3.1 Kui kliendi tegeliku elukoha andmetele vastet ADSis ei ole, peab saama
kasutaja märkida aadressi/asukoha eraldi tekstiväljale. Vastavat infot peab
kuvama ekraanivaadetes ja väljatrükkides, kus tegeliku elukoha andmeid
kuvatakse.
2.4 Haldusasutuste aadressiandmetele automaatset normaliseerimist rakendada ei ole
vajalik (Omavalitsuste liitumisel 2017.aasta lõpus tuleb sisestada palju uusi asutusi ja
aadressid peab saama lisada INADS teenust kasutades)
2.5 ADS aadressimuudatuste (nt muutub tänava või valla nimi) sünkroniseerimine
igaöiselt Maa-ameti andmeteenuse abil (nt ADSobjmuudatused.v4)
2.5.1 RR aadressiandmed uuendada automaatselt (nende ajalugu süsteemis ei
hoita)
2.5.2 Tegeliku elukoha andmed – andmeid uuendatakse automaatselt ainult
nendel juhtudel, kui menetlus on muudatuse hetkel kehtiv (olekus algatatud,
aktiivne, passiivne).
Tööde üleandmise tähtaeg: Tellitud tööd tuleb tellijale üle anda hiljemalt 30.novembriks
2017.a.
5
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
Dokumenteerimisnõuded:
Muuta ja täiendada muudatusega seotud kasutuslood.
Täiendada STAR andmemudelit.
Uuendada kood ja tarnemärkmed hiljemalt 2 tööpäeva jooksul pärast muudatuste live
keskkonda kandmist.
3 Pakkuja sisendvajadused
Ligipääs informatsioonile, mis puudutab olemasolevat infosüsteemi ning selle tehnilist
lahendust;
Ligipääs STAR infosüsteemi dokumentatsioonile;
Kontakt STAR infosüsteemi teemadel kompetentsete isikutega (nii kontseptuaalsel
tasemel kui ka tehnilise lahenduse tasemel).
6
STAR raamleping pakkumus nr 9 „Sotsiaalteenuste ja -toetuste andmeregistri
(STAR) arendused REGREL läbiviimiseks“
___________________________________________________________________________________________________
4 Maksumusvorm
Ühe töötunni
Kogus Kogumaksumus
Töö nimetus hind
(tunnid) (eurot, käibemaksuta)
(eurot)
Andmehõivelahenduse loomine, millega 140 55 7 700.00
edastatakse perioodiliselt üle x-tee
Statistikaametile kokkulepitud andmestik
(estat teenuse vahendusel)
Süsteemi lisatavate aadressiandmete
vastavusse viimine aadressandmete 240 55 13 200.00
süsteemiga ning edasise muudatuste
sünkroniseerimise tagamine
(aadressandmete kvaliteedi tõstmine,
ruumiandmete seaduse nõuete
täitmine).
7
1. Sotsiaalministeerium edastab andmed Statistikaametile 1. veebruariks.
2. Sotsiaalministeeriumi poolt edastatav sotsiaalteenuste ja -toetuste andmeregistri andmete
andmekoosseis on järgmine:
2.1 Andmete koosseis menetlusaluse isiku (subjekti) kohta eelmise aasta kohta (01.01. – 31.12):
tunnus Definitsioon
Kliendi üldandmed Isik, kelle osas on algatatud menetlus
Isikukood STARis menetletud isiku (subjekti) isikukood
Eesnimi STARis menetletud isiku eesnimi (ei pea tingimata olema
täidetud, kui on RRs olev isik)
Perekonnanimi STARis menetletud isiku perekonnanimi (ei pea tingimata olema
täidetud, kui on RRs olev isik)
Sünniaeg STARis menetletud isiku sünniaeg (ei pea tingimata olema
täidetud, kui on RRs olev isik)
Sugu STARis menetletud isiku sugu (ei pea tingimata olema täidetud,
kui on RRs olev isik)
Menetluse viitenumber Menetluse unikaalne identifikaator
Menetluse alguskuupäev Menetluse alguskuupäev
Menetluse lõppkuupäev Menetluse lõppkuupäev
Subjekti haridustase STARis menetletud isiku haridustase
Sotsiaalne seisund Subjekti sotsiaalne seisund. Klassifikaator: sotsiaalne seisund
Sotsiaalne seisund2 Subjekti täiendav sotsiaalne seisund (olemasolu korral).
Klassifikaator: sotsiaalne seisund
Subjekti tegeliku elukoha Tegeliku elukoha andmed (täidetud, kui erineb RR
andmed aadressist)
Tegelik elukoht Isiku tegeliku elukoha aadressi vaste ADSis (ADS_OID)
Toimetulekutoetuse andmed
Toimetulekutoetuse menetlus Indikaator, kas tegemist toimetulekutoetuse menetlusega
Leibkonnakood Info ühte leibkonda kuulumise kohta (täidetud ainult
toimetulekutoetuse menetluse korral)
Eluruumi kasutamise alus Info eluaseme kasutamise aluse kohta, klassifikaator (täidetud
ainult toimetulekutoetuse menetluse korral)
Toimetulekutoetuse summa Menetluse raames makstud toimetulekutoetuse summa (perele)
1
(täidetud, kui taotlusele järgnes otsus toetust maksta)
Toimetulekutoetuse kuupäev Menetluse raames kinnitatud toimetulekutoetuse kuupäev
(täidetud, kui taotlusele järgnes otsus toetust maksta)
2.2. Andmete koosseis 31.12. seisuga asenduskoduteenusel viibiva lapse kohta:
Asenduskoduteenuse
andmed
Isikukood Asenduskoduteenusel viibiva lapse isikukood
Eesnimi Asenduskoduteenusel viibiva lapse eesnimi (ei pea tingimata
olema täidetud, kui on RRs olev isik)
Perekonnanimi Asenduskoduteenusel viibiva lapse perekonnanimi (ei pea
tingimata olema täidetud, kui on RRs olev isik)
Sünniaeg Asenduskoduteenusel viibiva lapse sünniaeg (ei pea tingimata
olema täidetud, kui on RRs olev isik)
Sugu Asenduskoduteenusel viibiva lapse sugu (ei pea tingimata olema
täidetud, kui on RRs olev isik)
Asenduskoduteenuse saamise Teenusel viibimise asukoht (ADS- OID)
asukoht
Asenduskodu nimetus Asenduskoduteenuse osutaja nimetus
Asenduskodu registrikood Asenduskoduteenuse osutaja registrikood
Asenduskoduteenusel viibimise Asenduskoduteenuse rakendamise alguskuupäev
algus
Asenduskoduteenusel viibimise Asenduskoduteenuse rakendamise lõpukuupäev
lõpp
2
SA x-tee liidestamise spetsifikatsioon
Sisukord
1. Sissejuhatus ..................................................................................................................................... 2
2. X-tee teenus .................................................................................................................................... 2
2.1 X-tee sõnum ............................................................................................................................ 2
2.2 Päringu päis ............................................................................................................................. 2
2.3 SubmitData päringu keha ........................................................................................................ 2
2.4 SubmitData vastuse keha ........................................................................................................ 3
2.5 ReturnData päringu keha ........................................................................................................ 3
2.6 ReturnData vastuse keha ........................................................................................................ 3
2.7 ReturnError päringu keha........................................................................................................ 3
2.8 ReturnError vastuse keha ........................................................................................................ 3
3. SA poolt loodava XSD osad .............................................................................................................. 3
3.1. XSD päis: .................................................................................................................................. 3
3.2. Versiooni atribuutide grupp: ................................................................................................... 3
3.3. reaID element: ......................................................................................................................... 4
3.4. elemendiTyyp element: ........................................................................................................... 4
3.5. elemendiMuutus element: ...................................................................................................... 4
3.6. MUUT_KPV element:............................................................................................................... 5
3.7. SISESTAMISE_KPV element: .................................................................................................... 5
4. Loodava XSD näidis .......................................................................................................................... 6
5. SubmitData kasutamise näide ......................................................................................................... 8
1. Sissejuhatus
Käesolev dokument kirjeldab üldist protokolli sõnumite vahetamiseks Statistikaameti X-tee
vahendusel. See spetsifikatsioon on ühine kõigi pakutavate teenuste jaoks ning kirjeldab suhtluse
tehnilisi aspekte.
Andmete edastamiseks SA estat andmekogule kasutatakse standardset X-tee infrastruktuuri.
Teenuste kasutamine eeldab, et ettevõte on liitunud X-teega.
Käesolevas dokumendis käsitletakse liidestumist estat andmekoguga, mis on SA universaalteenus
andmete vastu võtmiseks.
2. X-tee teenus
Kõik SA andmeedastus teenused on kättesaadavad ühe ühise X-tee andmekogu kaudu. Kasutatava
teenuse valik toimub selle teenuse väljakutsel ettevõtte poolt ette antud parameetrite (teenuse nimi
ja XSD viide) alusel.
Selline lahendus muudab uute teenuste väljatöötamise ning juurutamise kiiremaks.
SA ühise X-tee andmekogu nimi on estat. Estati all asub kolm teenust. SubmitData - andmete
edastamiseks, ReturnData - edastatud andmete pärimiseks ja ReturnError - vastusfaili pärimiseks.
2.1 X-tee sõnum
X-tee sõnum ja vastus koosnevad päisest, kehast ja manusest. Päises oleva info koosseis ja vorming
on määratud X-tee spetsifikatsiooni poolt https://www.ria.ee/26436. Kehas oleva info koosseis ja
vorming on määratud käesoleva dokumendi poolt. Manuse kooseis ja vorming on määratud vastavalt
SA-ga sõlmitud kokkuleppele.
2.2 Päringu päis
X-tee päringu päises on järgmised elemendid:
asutus päringut tegeva ettevõtte registrikood
andmekogu andmekogu nimi. SA teenuste korral alati „estat“
isikukood teenuse kasutaja isikukood, millele eelneb kahekohaline maa kood.
Kui SA X-tee teenust kasutatakse konkreetse kasutaja poolt käivitatud
protsessi raames (vs süsteemi poolt automaatselt käivitatud protsessi
poolt), siis peab see väli sisaldama konkreetse kasutaja isikukoodi.
id teenuse väljakutse unikaalne identifikaator. Ettevõtte infosüsteem
peab iga X-tee teenuse väljakutse jaoks genereerima kordumatu
identifikaatori.
nimi kasutatava teenuse nimi. SA andmeedastuse korral
„estat.SubmitData.v1“.
2.3 SubmitData päringu keha
SA X-tee päringu kehas on järgmised elemendid:
DataFile manusena kaasa pandud fail.
XSDValidationOnly võimalikud väärtused 0 - andmed edastatakse SA-le või 1 - andmeid
ei edastatakse, vaid saadakse vastus kas manus valideerub.
2.4 SubmitData vastuse keha
SA X-tee vastuse kehas on järgmised elemendid:
SubmitId ID, mille alusel on edaspidi võimalik küsida vearaportit, täidetud kui
üleslaadimine õnnestus.
XSDValidationErrorMessage Veateade, kui manuse struktuur osutus tundmatuks või tekkis muu
tehniline viga.
2.5 ReturnData päringu keha
SA X-tee päringu kehas on järgmised elemendid:
SubmitId Õnnestunult "XML üleslaadimise teenuse" kaudu üleslaetud XML
kirje ID.
2.6 ReturnData vastuse keha
SA X-tee vastuse kehas on järgmised elemendid:
DataFile Aruande andmete XML fail.
2.7 ReturnError päringu keha
SA X-tee päringu kehas on järgmised elemendid:
SubmitId Õnnestunult "XML üleslaadimise teenuse" kaudu üleslaetud XML
kirje ID.
2.8 ReturnError vastuse keha
SA X-tee vastuse kehas on järgmised elemendid:
ProcessingStatus Kas saabunud fail on juba töödeldud, võimalikud variandid 0 -
töötlemata või 1 - töödeldud. Kõikidele saadetul failidele ei koostata
vastusfaili.
ValidationResult Töödeldud faili vigaderaport, võimalikud variandid 0 - korras, 1 -
mittekriitilised vead või 2 - kriitilised vead.
ValidationReport XML kujul detailne vigade raport.
3. SA poolt loodava XSD osad
3.1. XSD päis:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
version="3001_2015" id="stat.ee_questionnaire_3001_2015" targetNamespace="3001.xsd"
xmlns="3001.xsd">
Kohustuslikud elemendid:
<report xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="3001.xsd"
xsi:noNamespaceSchemaLocation="3001.xsd">
3.2. Versiooni atribuutide grupp:
<xs:attributeGroup name="XSD-version">
<xs:attribute name="xsdversioon" use="required">
<xs:simpleType>
<xs:restriction base="xs:gYear">
<xs:minInclusive value="2014"/>
<xs:maxInclusive value="2100"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="xsdjark" use="required">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="24"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:attributeGroup>
Pole kohustuslik andmehõive jaoks registritest
3.3. reaID element:
<xs:element name="reaID" type="xs:IDREF" minOccurs="0" maxOccurs="1">
Pole kohustuslik, kui edastatakse läbilõiget registrist.
3.4. elemendiTyyp element:
<xs:element name="elemendiTyyp" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">Andmeelemendi tüüp
väärtuse päritolu järgi
1 - originaal (täidetakse andmekogus)
2 - koopia (kopeeritakse mõnest muust andmekogust,
andmekogus ei muudeta)
3 - koopia (kopeeritakse mõnest muust andmekogust,
andmekogus on muudetud)
4 - tuletatud (arvutatakse andmekogus)
</xs:documentation>
Element on kohustuslik, kuna SA-l on vaja teada kas tegemist on algandmetega.
3.5. elemendiMuutus element:
<xs:element name="elemendiMuutus" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">Andme-elemendi
muutmise kuupäev</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:dateTime">
<xs:minInclusive value="2014-01-01T00:00:00"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Millal sai vastav muutuja oma väärtuse, ehk kogumise hetk. Vajalik tunnus andmete võrdlemisel, kui
samu andmeid kogub rohkem kui üks register.
3.6. MUUT_KPV element:
<xs:element name="MUUT_KPV" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">viimase muutuse tegemise
aeg</xs:documentation>
<xs:documentation xml:lang="ET">Käitumine puudumisel:
Andmerida võetakse vastu
Käitumine ebakorrektsusel: Andmerida ei võeta vastu,
tagastatakse ebakorrektse andmeelemendi kood ning veateade "incorrect"</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:dateTime">
<xs:minInclusive value="2014-01-01T00:00:00"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Vajalik element juhul, kui register edastab ainult toimunud muudatusi, ja neid võib ühe perioodi
kohta olla rohkem kui üks päring. Vajalik andmetöötluse järjekorra otsustamisel. Element omab
väärtust koos teise elemendi SISESTAMISE_KPV-ga.
Registri korraga saatmisel võib siia kirjutada hetke aja.
3.7. SISESTAMISE_KPV element:
<xs:element name="SISESTAMISE_KPV" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">kande tegemise
aeg</xs:documentation>
<xs:documentation xml:lang="ET">Käitumine puudumisel:
Andmerida ei võeta vastu, tagastatakse puuduva andmeelemendi kood ning veateade "missing"
Käitumine ebakorrektsusel: Andmerida ei võeta vastu,
tagastatakse ebakorrektse andmeelemendi kood ning veateade "incorrect"</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:dateTime">
<xs:minExclusive value="2014-01-01T00:00:00"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Vajalik element et aru saada millise päeva kohta edastatud sõnum täpselt käib, muutuja muutmise
kuupäev ja sõnumi kuupäev võib erineda, kui andmekogumine toimub asünkroonselt.
Registri korraga saatmisel võib siia kirjutada hetke aja.
4. Loodava XSD näidis
<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
version="3001_2015" id="stat.ee_questionnaire_3001_2015" targetNamespace="3001.xsd"
xmlns="3001.xsd">
<xs:attributeGroup name="XSD-version">
<xs:attribute name="xsdversioon" use="required">
<xs:simpleType>
<xs:restriction base="xs:gYear">
<xs:minInclusive value="2014"/>
<xs:maxInclusive value="2100"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="xsdjark" use="required">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="24"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:attributeGroup>
<xs:group name="AndmeRead">
<xs:sequence>
<xs:element name="AndmeRida" type="andmeRida" minOccurs="1"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:group>
<xs:complexType name="andmeRida">
<xs:sequence>
<xs:element name="reaID" type="xs:IDREF" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">Andmerea
järjekorranumber konkreetses sõnumis
Käitumine puudumisel: Andmerida ei võeta vastu,
tagastatakse puuduva andmeelemendi kood ning veateade "missing"
Käitumine ebakorrektsusel: Andmerida ei võeta
vastu, tagastatakse ebakorrektse andmeelemendi kood ning veateade "incorrect"
Kasutusel järgnevates statistikatöödes:
N/A</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="elementEESNIMI" type="typeEESNIMI" minOccurs="1"
maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">Õpilase eesnimi
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="MUUT_KPV" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">viimase muutuse tegemise
aeg</xs:documentation>
<xs:documentation xml:lang="ET">Käitumine puudumisel:
Andmerida võetakse vastu
Käitumine ebakorrektsusel: Andmerida ei võeta vastu,
tagastatakse ebakorrektse andmeelemendi kood ning veateade "incorrect"</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:dateTime">
<xs:minInclusive value="2014-01-01T00:00:00"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="SISESTAMISE_KPV" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">kande tegemise
aeg</xs:documentation>
<xs:documentation xml:lang="ET">Käitumine puudumisel:
Andmerida ei võeta vastu, tagastatakse puuduva andmeelemendi kood ning veateade "missing"
Käitumine ebakorrektsusel: Andmerida ei võeta vastu,
tagastatakse ebakorrektse andmeelemendi kood ning veateade "incorrect"</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:dateTime">
<xs:minExclusive value="2014-01-01T00:00:00"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="elemendiKirjeldus">
<xs:sequence>
<xs:element name="elemendiTyyp" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">Andmeelemendi tüüp
väärtuse päritolu järgi
1 - originaal (täidetakse andmekogus)
2 - koopia (kopeeritakse mõnest muust andmekogust,
andmekogus ei muudeta)
3 - koopia (kopeeritakse mõnest muust andmekogust,
andmekogus on muudetud)
4 - tuletatud (arvutatakse andmekogus)
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:totalDigits value="1"/>
<xs:minInclusive value="1"/>
<xs:maxInclusive value="4"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="elemendiMuutus" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation xml:lang="ET">Andme-elemendi
muutmise kuupäev</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:dateTime">
<xs:minInclusive value="2014-01-01T00:00:00"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="typeEESNIMI">
<xs:sequence>
<xs:element name="EESNIMI" type="xs:string">
<xs:annotation>
<xs:documentation xml:lang="ET">Õpilase
eesnimi</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="AMET-Meta" type="elemendiKirjeldus" minOccurs="1"
maxOccurs="1" />
</xs:sequence>
</xs:complexType>
<xs:element name="report" type="reportType"/>
<xs:complexType name="reportType">
<xs:group ref="AndmeRead"/>
</xs:complexType>
</xs:schema>
5. SubmitData kasutamise näide
POST http://192.168.0.41/xgate/xtee/ HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: multipart/related; type="text/xml"; start="<
[email protected]>"; boundary="----
=_Part_34_10538737.1448455117234"
SOAPAction: ""
MIME-Version: 1.0
Content-Length: 3805
Host: 192.168.0.41
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
------=_Part_34_10538737.1448455117234
Content-Type: text/xml; charset=UTF-8
Content-Transfer-Encoding: 8bit
Content-ID: <
[email protected]>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xtee="http://x-tee.riik.ee/xsd/xtee.xsd"
xmlns:est="http://producers.estat.xtee.riik.ee/producer/estat">
<soapenv:Header>
<xtee:nimi>estat.SubmitData.v1</xtee:nimi>
<xtee:id>56546542</xtee:id>
<xtee:isikukood>3711110268</xtee:isikukood>
<xtee:andmekogu>estat</xtee:andmekogu>
<xtee:asutus>70000332</xtee:asutus>
</soapenv:Header>
<soapenv:Body>
<est:SubmitData>
<keha>
<DataFile>cid:3001.xml</DataFile>
<XSDValidationOnly>1</XSDValidationOnly>
</keha>
</est:SubmitData>
</soapenv:Body>
</soapenv:Envelope>
------=_Part_34_10538737.1448455117234
Content-Type: text/xml; charset=Cp1257; name=3001.xml
Content-Transfer-Encoding: quoted-printable
Content-ID: <3001.xml>
Content-Disposition: attachment; name="3001.xml"; filename="3001.xml"
<?xml version=3D"1.0" encoding=3D"utf-8"?>
<report xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="3001.xsd"
xsi:noNamespaceSchemaLocation="3001.xsd">
<AndmeRida>
<elementEESNIMI>
<EESNIMI_OPL>str1234</EESNIMI_OPL>
<AMET-Meta>
<elemendiTyyp>1</elemendiTyyp>
<elemendiMuutus>2014-12-13T12:12:12</elemendiMuutus>
</AMET-Meta>
</elementEESNIMI>
<MUUT_KPV>2014-12-13T12:12:12</MUUT_KPV>
<SISESTAMISE_KPV>2014-12-13T12:12:12</SISESTAMISE_KPV>
</AndmeRida>
</report>
------=_Part_34_10538737.1448455117234--
HANKELEPING nr 3-9/338-1
Tervise ja Heaolu Infosüsteemide Keskus, (registrikoodiga 70009770) asukohaga Uus Tatari
25/Veerenni 13, 10134 Tallinn, keda põhimääruse alusel esindab direktor Katrin Reinhold (edaspidi
tellija), ja
Medisoft AS, registrikood 10047646, aadressiga Räägu 35A, keda esindab esindusõiguse alusel Jako
Heinmets (edaspidi töövõtja),
edaspidi eraldi pool või koos pooled, sõlmisid raamlepingu nr 1.8-2/ 7326 alusel käesoleva
hankelepingu (edaspidi leping) alljärgnevas.
Hankega tellitavaid töid rahastatakse Euroopa Regionaalarengu Fondist, Ühtekuuluvuspoliitika
fondide rakenduskava 2014–2020 prioriteetsete suuna „Haldusvõimekus” meetme „Avalike teenuste
pakkumise arendamine” tegevuse „Olemasolevate ja uute infosüsteemide nutikas arendamine (sh
analüüs)”, majandus- ja taristuministri 20. aprilli 2015. a määruse nr 31 „Avalike teenuste pakkumise
arendamiseks toetuse andmise tingimused ja kord“ alusel.
Täitja on kohustatud lepingu eseme tarnimisel järgima Vabariigi Valitsuse 12.09.2014 määruses nr
146 „Perioodi 2014–2020 struktuuritoetuse andmisest avalikkuse teavitamise, toetusest rahastatud
objektide tähistamise ning Euroopa Liidu osalusele viitamise nõuded ja kord” sätestatud
teavitusreegleid ning esemete märgistamise ja dokumentide tähistamise nõudeid ning kasutama
selleks ettenähtud sümboolikat.
Üleantav lepingu ese, sh kõik selle komponendid, peavad olema täitja poolt tähistatud ja märgistatud
vastavalt Vabariigi Valitsuse 12.09.2014 määruses nr 146 „Perioodi 2014–2020 struktuuritoetuse
andmisest avalikkuse teavitamise, toetusest rahastatud objektide tähistamise ning Euroopa Liidu
osalusele viitamise nõuded ja kord” toodud esemete märgistamise ja dokumentide tähistamise
nõuetele kasutades selleks ettenähtud sümboolikat (vt määruse Lisa, joonis 2 Euroopa
Regionaalarengu Fond, kujundusfailid).
1. Lepingu ese
1.1 Lepingu esemeks on Lisas 1 nimetatud tööd koos garantiiteenustega (edaspidi töö).
2. Lepingu hind
2.1 Tellija kohustub tasuma Töö/Tarkvara eest kokku 25 080 eurot koos käibemaksuga 30
(kolmekümne) tööpäeva jooksul arvates arve saamisest.
2.2 Töövõtja esitab Tellijale arve pärast töö/ Tarkvara üleandmise-vastuvõtmise akti
allkirjastamist.
3. Töö üleandmise ja vastuvõtmise tingimused
3.1 Töövõtja annab töö/Tarkvara üle 30.11.2017.
3.2 Tellija vaatab töö/Tarkvara üle vastavalt raamlepingu punktile 2.6 ja 8.1.
4. Autoriõigused
4.1 Vastavalt pakkumusele võõrandab Töövõtja Tellijale tööga tekkivad autoriõigused.
4.2 Vastavalt pakkumusele annab Töövõtja Tellijale litsentsi järgmistele Tarkvara komponentidele:
4.2.1 Andmehõivelahenduse loomine, millega edastatakse perioodiliselt (kord aastas) üle x-
tee Statistikaametile kokkulepitud andmestik.
4.2.2 Süsteemi lisatavate aadressiandmete vastavusse viimine aadressandmete süsteemiga
ning edasise muudatuste sünkroniseerimise tagamine.
5. Poolte vastutus
5.1 Juhul kui Tellija ei tasu üleantud töö/Tarkvara eest tähtaegselt, on Töövõtjal õigus nõuda
Tellijalt viivise tasumist suuruses 0,15% iga tasumisega viivitatud päeva eest tähtajaks
tasumata summalt.
5.2 Juhul kui Töövõtja ei anna tööd/Tarkvara Tellijale üle punktis sätestatud tähtajaks või viivitab
puuduste kõrvaldamisega, kohustub Töövõtja maksma Tellijale leppetrahvi 0,15% Lepingu
hinnast (lepingu punkt ) iga üleandmise või puuduste kõrvaldamisega viivitatud päeva eest.
5.3 Garantiitingimuste rikkumise korral on Tellijal õigus nõuda Töövõtjalt leppetrahvi kuni 30%
lepingu hinnast iga juhtumi korral.
5.4 Lepingust tulenevate viiviste ja leppetrahvide maksmine, samuti tekitatud kahju hüvitamine ei
vabasta lepingut rikkunud poolt mistahes Lepingujärgsete kohustuste täitmisest.
6. Poolte vahelised teated ja kontaktisikud
6.1 Teadete edastamine toimub üldjuhul telefoni, e-posti, faksi või posti teel. Juhul, kui teate
edastamisel on olulised õiguslikud tagajärjed, peavad teisele poolele edastatavad teated
olema edastatud taasesitamist võimaldavas vormis (s.o kirjalikus vormis, faksi või e-posti
teel). Informatiivset teadet võib edastada ka telefoni teel.
6.2 Teate edastamise hetkeks loetakse faksi või elektronkirja tehniliselt tõendatud saatmise hetk
või kirjaliku teate allkirjaga tõendatud vastuvõtmise hetk.
6.3 Tellija kontaktisikuks Lepingu täitmisel on Evelin Kuusik tel 5138136 , e-post:
[email protected]
6.4 Töövõtja kontaktisikuks Lepingu täitmisel on Thea Tramberg, tel 6595764 e-post:
[email protected]
7. Lepingu kehtivus
7.1 Leping on koostatud eesti keeles ja allkirjastatud digitaalselt.
7.2 Leping jõustub sellele poolte poolt allakirjutamise hetkest ja kehtib kuni Poolte poolt oma
Lepinguliste kohustuste täitmiseni.
8. Lõppsätted
8.1 Lepingu täitmisel tekkinud vaidlused ja lahkarvamused lahendavad Pooled läbirääkimiste teel.
Kokkuleppe mittesaavutamisel lahendatakse vaidlused Harju Maakohtus.
8.2 Lepingu täitmisel ja Lepingust tulenevate vaidluste lahendamisel lähtutakse Eesti Vabariigi
õigusaktidest.
8.3 Pooled ei tohi Lepingust tulenevaid õigusi ja kohustusi üle anda kolmandatele isikutele ilma
teise Poole kirjaliku nõusolekuta.
8.4 Lepingu dokumendid koosnevad käesolevast Lepingust, Lepingu Lisadest ning Lepingu
muudatustest, milles Pooled võivad kokku leppida Lepingu allakirjutamise järgselt.
8.5 Lepingu lahutamatuteks osadeks Lepingu sõlmimise hetkel on järgmised dokumendid:
8.5.1 Lisa 1 Hankelepingu eseme tehniline kirjeldus;
8.5.2 Lisa 2 Pakkumus;
8.5.3 Lisa 3 STAR andmekoosseis;
8.5.4 Lisa 4 SA liidese spetsifikatsioon.
9. Poolte allkirjad:
Tellija: Töövõtja:
(allkirjastatud digitaalselt) (allkirjastatud digitaalselt)