Pakkuja voo komponentmudel
Leheküljel kuvatakse RIA vahendusplatvormi kõrgvaatelisi komponente ja andmete liikumist nende vahel. Komponendid ei vasta 1:1 implementatsiooni komponentidele. Reaalne süsteem võib olla granulaarsem. Näiteks "preview area FE" võib olla komplekt ühest või mitmest rakendusest, mis kokku moodustavad ühe äriloogilise terviku.
Andmestiku pakkumise voo komponendid ja andmete liikumine
Sammude kirjeldused
Sammu(de) number | Kirjeldus | Märkused |
---|---|---|
1 - 3 | eDelivery päringu vastuvõtmine teise liikmesriigi menetlusportaalist (MS Procedural Portal) | Päring edastatakse eDelivery protokollistiku järgi. Edelivery päringu sõnumivahetus on asünkroonne. Igale päringule oodatakse vastuvõtu või sellest keeldumise kinnitust. Vastus saadetakse tagasi eraldi päringuga, millele samuti oodatakse kinnitust. (Joonisel markeeritud asünkroonsed päringud topelt noolega). |
4-5 | Päringu töötlemine. Vahendusplatvormis paiknev edelivery-connector võtab päringu vastu, valideerib selle sisu, edastab töötlemiseks incoming-request-coordinatorile. Edelivery coordinator registreerib sisse tulnud päringu, koostab selle kohta unikaalse identifikaatori, ning unikaalse eelvaate URLi. | |
6-11 | Eelvaate URL tagastatakse esimesele eDelivery päringule ErrorResponse sõnumi koosseisus. Saades ErrorResponse sõnumi, millele on lisatud eelvaate URL kordab menetlusportaal algset päringut lisades päringu kehasse ka eelvaate URLi. | Ülejäänud päringu andmed jäävad samaks. Päringu eesmärk on "aktiveerida" eelvaate URL. Enne kui teine päring (evReq2) pole saabunud sipelgasse, ei ole kohustust eelvaate alas varem genereeritud URLile vastata. |
12 | Menetlusportaal saab kinnituse, et eelvaate ala on valmis kasutaja vastuvõtmiseks. Kasutaja sirvik suunatakse eelvaate URLile. | |
13 | Kasutaja autentimine. Kasutaja peab andmestiku eelvaate alas turvalise seansi algatamiseks autentima eIDAS autentimisvahendiga. | Eelvaate alas autentimiseks peaks isik kasutama sama autentimise meetodit, mida ta kasutas menetlusportaalis menetluse algatamisel. Vastasel korral võib andmestiku väljastaja (või vahendusplatvorm) keelduda päringu töötlemisest, sest eelvaate alas ei suudeta erinevate eIDAS autentimismeetodite tulemusi kokku viia. |
14-15 | Eelvaate ala verifitseerib, et eelvaate URL on valiidne. Selleks peab eksisteerima varem salvestatud andmestiku taotluse info (evReq) ning andmestikuga seotud eelvaate URL peab olema aktiivne. Andmestikku pakub incoming-request-coordinator. | |
16-20 | Andmestiku pärimine üle X-Tee. Andmestiku päring sisaldab subjekti andmeid (kelle kohta andmestikku küsitakse), andmestiku tüübi tunnust ja täiendavaid andmestiku päringu atribuute (nt. küsitud andmetüüp - struktureeritud andmed või struktureerimata andmed; andmestikku küsiva asutuse info jms) | Andmestiku küsimine registrist toimub asünkroonselt. Esimene päring suunal RIA→register edastab taotluse andmed registrile. Register vastab positiivselt, et päring on vastu võetud. POST päring, et vältida isikuandmete edastamist päringu URLis. X-Tee api kirjeldus RIA confluences asub X-tee liides lehel (piiratud ligipääs), avalik API spetsifikatsioon koodivaramus https://koodivaramu.eesti.ee/riigi-infos-steemi-amet/sdg |
21-24 | Andmestike laekumine RIA süsteemi | Register on andmestike koostamisega lõpule jõudnud ja edastab andmestikud RIAle. Eelvaate alas pollitakse perioodiliselt andmestike saabumist registrist. Andmestiku all peetakse silmas mistahes struktuuriga andme Kui mõne andmestiku küsimiseks on tarvis tasuda riigilõivu, siis lisab register selle tarbeks unikaalse makselingi iga tasulise andmestiku kirje juurde. |
25 | Andmestiku sisu tehakse kasutajale nähtavaks eelvaate alas. Kasutaja võib aga ei pea eelvaatealas andmestiku sisu vaatama. | |
26a | Andmestiku kasutamise lubamine / keelamine. Kasutaja saab iga nimekirjas oleva andmestiku kohta valida, kas ta soovib antud andmestikku raames menetlusportaaliga jagada. Kasutaja valikust sõltuvalt tagastatakse andmestik koordinaatorile info kasutaja valiku kohta. | Kui kasutaja otsustab SDG menetlusse lisada tasulisi andmestikke, siis riigilõivu tasumiseks suunatakse kasutaja vastava andmestikuga seotud makse-URLile (joonisel märgitud hallide nooltega). Makse URLile suunamisel lisab vahendusplatvorm URLi atribuudina kaasa oma tagasisuunamise URLi. Peale riigilõivu tasumist suunatakse kasutaja tagasi RIA vahendusplatvormi tagasisuunamise URLile. |
26b | Peale evidence coordinatorile valiku edastamist suunatakse kasutaja sirvik tagasi menetlusportaali | Menetlusportaal saab omalt poolt kasutajale kuvada andmestiku taotlemise õnnestumise/ebaõnnestumise vaate. |
27-30 | Kasutaja valikule vastavalt koostatakse andmestiku taotluse vastus. Vastus edastatakse üle eDelivery (positiivse valiku korral koos andmestiku sisuga) menetlusportaalile. |
X-Tee APIde tehniliste spetsifikatsioonide eskiis (OpenAPI)
Registri API pakkuja rollis - pakub evidenceRequest teenust RIA vahendusplatvormile: sdg-evidence-provider-api.yaml
RIA vahendusplatvorm pakkuja rollis - pakub evidenceResponse teenust Registrile: sdg-intermediate-platform-evidence-provider-api.yaml