¶ Veicamie soļi
| Nr. | Darbība | Apraksts |
|---|---|---|
| 1 | Aizpildīt un iesniegt DAGR pieteikuma veidlapu. | Lai iegūtu piekļuvi DAGR pašapkalpošanās portālām un DAGR REST API saskarnei, ir jāaizpilda pieteikuma veidlapa. |
| 2 | Aizpildīt un iesniegt VIRSIS pieteikuma veidlapu. | Lai iegūtu piekļuvi VIRSIS sistēmai, kas ļauj pārvaldīt piekļuvi datu devēja DAGR publicētajām datu kopām, ir jāaizpilda pieteikuma veidlapa. |
| 3 | Reģistrēt DAGR pašapkalpošanās portālā savienojumu. | DAGR pašapkalpošanās portālā ir jāreģistrē viens vai vairāki tehniskie pieslēgumi jeb savienojumi. |
| 4 | Datu kopas definēšana DAGR portālā. | DAGR pašapkalpošanās portālā ir jāreģistrē izplatāmās datu kopas datu struktūra. |
| 5 | Datu nodošana uz DAGR | Datu devējs uzstāda un nokonfigurē datu devēja savienotāju vai alternatīvi realizē datu nodošanu uz DAGR, izmantojot DAGR REST API. |
| 6 | Informācijas pakalpojuma reģistrēšana VIRSIS. | Datu devējs VIRSIS reģistrē jaunu informācijas pakalpojumu, sasaistot to ar DAGR izveidoto datu kopu. |
| 7 | Pieteikumu apstiprināšana VIRSIS. | Datu devējs apstiprina datu ņēmēju pieteikumus uz VIRSIS reģistrēto informācijas pakalpojumu. |
¶ 1. DAGR pieteikuma veidlapa
Lai iegūtu piekļuvi DAGR, ir jāaizpilda DAGR pieteikuma veidlapa. Vairāk informācijas: https://www.vraa.gov.lv/lv/datu-izplatisanas-un-parvaldibas-platforma
Kad ir saņemta atbilde par pieteikuma apstrādi, iesniegumā norādītās personas varēs pieslēgties DAGR pašapkalpošanās portālam.
¶ 2. VIRSIS pieteikuma veidlapa
Lai iegūtu piekļuvi VIRSIS, ir jāaizpilda veidlapa VIRSIS sistēmas iestādes lietotāja administratora izveidei un jānosūta uz VDAA e-adresi. Vairāk informācijas: https://www.vraa.gov.lv/lv/valsts-informacijas-resursu-sistemu-un-sadarbspejas-informacijas-sistema
Kad piekļuve saņemta, VIRSIS sistēmas iestādes lietotājs var izveidot lietotāju kontus pārējiem iestādes darbiniekiem, kam tas nepieciešams.
¶ 3. Savienojuma reģistrēšana DAGR portālā
Pēc tam, kad ir apstiprināts datu devēja pieteikums, ir jāreģistrē datu devēja savienojums. Ja datu devējam ir vairākas informācijas sistēmas, kas nodod datus uz DAGR, katrai rekomendējams reģistrēt savu savienojumu.
Datu devēja savienojumus iespējams reģistrēt pašapkalpošanās portāla sadaļas “Piekļuve DAGR” apakš sadaļā “Savienotāji”. Šajā sadaļā ir pieejams saraksts ar visiem savienotājiem / savienojumiem:
Lai reģistrētu jaunu savienotāju, jāaizpilda forma:
Šajā formā jānorāda portālā savienotāja nosaukums (informatīva nozīme), identifikators (tiek izmantots REST API), pazīme, vai savienojums aktīvs, drošības talona dzīves cikla ilgums sekundēs un opcionāls apraksts.
Kad savienojums ir saglabāts, tam iespējams pievienot X.509 standarta drošības sertifikātu:
¶ Informācija par sertifikātu
DAGR pievienotos sertifikātus izmanto, lai validētu drošības talonu pieprasījums. DAGR pievienojamais x509 sertifikāts var būt arī pašparakstīts. Pastāv vairāki varianti, kā iegūt pašparakstītu X.509 sertifikātu. MS Windows vidē to var izdarīt, uzinstalējot OpenSSL komandrīku un izpildot komandas:
openssl genrsa -out c:\temp\nosaukums.key 2048
Šī komanda ģenerē privāto atslēgu, kas pēc tam būs nepieciešama, lai parakstītu drošības talona pieprasījumu (LINKSLINKSLINKS). Privātā atslēga paliek pie datu patērētāja un tās aizsargāšana ir datu patērētāja pienākums.
openssl req -key c:\temp\nosaukums.key -new -x509 -subj "/C=LV/ST=Riga/L=Riga/O=Iestades_nosaukums/OU=IT/CN=nosaukums" -days 365 -out c:\temp\nosaukums.crt
Šī komanda ģenerē pašparakstītu X.509 sertifikātu, kuru jāpievieno DAGR reģistrētajam datu patērētāja savienotājam.
¶ 4. Datu kopas definēšana
Caur DAGR izplatāmie dati ir grupēti datu kopās. Pirms uzsākt izplatīt jauna veida datus, ir jādefinē jaunu datu kopu. Datu kopas definēšana sastāv no diviem soļiem:
- Vispirms datu devējs reģistrē datu kopu priekšlikumu vidē (sandbox). Priekšlikumu vide ir izmantojama datu nodošanas testēšanai un atkļūdošanai. Priekšlikumu vidē reģistrētu datu kopu datiem var piekļūt pats datu devējs un DAGR administrators.
- Pēc tam DAGR administrators pārceļ datu kopu uz pamata vidi (dataset). Informācija par pamata vidē esošajām datu kopām tiek nodota uz VIRSIS un šajās kopās esošie dati pieejami datu patērētājiem izmantojot VIRSIS piešķirtās datu piekļuves atļaujas.
¶ Datu kopas pievienošana priekšlikumu videi (sandbox)
Caur DAGR izplatāmās datu kopas definīciju priekšlikumu vidē veido:
- Nosaukums. Unikāls datu kopas nosaukums. Stingra rekomendācija ir datu kopas nosaukumu rakstīt angliski ar mazajiem burtiem, vārdus atdalīt ar apakšstrīpu un prefiksā norādīt iestādes nosaukumu. Daži piemēri:
- ur_legal_entity (Uzņēmumu reģistra tiesību subjekti);
- vzd_address (Valsts zemes dienesta adreses);
- vbtai_orphan_certificate (Valsts bērnu tiesību aizsardzības inspekcijas bāriņu apliecības).
- Datu devējs. Datu devēja reģistrācijas numurs un nosaukums;
- Struktūra. Datu struktūras definīcija YAML formātā. Datu struktūras definīcija apraksta datu kopas datu laukus, to formātus un savstarpējo sasaisti. DAGR atbalsta daudzlīmeņu datu struktūras.
- Komentārs. Brīvā formā norādīts komentārs, kas apraksta datu kopu;
Caur DAGR dati tiek izplatīti, tos formējot key-value paradigmā, kur key ir ieraksta atslēga un value ir jebkuras sarežģītības datu struktūra. DAGR kodolā ieraksta value jeb vērtības daļa tiek uzglabāta JSON formātā.
Definēt jaunas datu kopas vai pieteikt izmaiņas eksistējošai datu kopai var DAGR pašapkalpošanās portāla sadaļā “Datu izplatīšana” -> “Datu kopas”.
Datu struktūras definīcijas veidojama atbilstoši šādai sintaksei:
name: {nosaukums}
DAGR datu kopas definīcijai jāsākas ar datu kopas nosaukumu. Nosaukumam datu struktūras definīcijā jāsakrīt ar datu kopas nosaukumu, kurš norādīts datu kopas ievades kartiņā.
key: {atslēgas lauks nr.1}, {atslēgas lauks nr.2}, {utt.}
Tālāk jānorāda datu lauki, kas veido ieraksta atslēgu. Atslēga var sastāvēt no viena vai vairākiem datu laukiem. Ņemot vērā, ka ieraksta atslēga pēc tam būs izmantojama ierakstu meklēšanai, par atslēgu jāizvēlas lauki ar biznesa nozīmi, piemēram, personas kods, reģistrācijas numurs, adreses kods, dokumenta numurs, u.c. Gadījumā, ja ieraksta unikalitātes nodrošināšanai nepieciešams izmantot kādu lauku, kuram nav biznesa nozīmes, tad tas liekams atslēgas beigās un iekļaujams iekavās. Iekavās iekļautie lauki netiks izmantoti meklēšanā. Atslēgā norādītajiem laukiem tālāk jāparādās datu lauku sarakstā.
data_description: {datu kopas apraksts}
Apraksta elementā norādāms datu kopas īss apraksts. Šim aprakstam ir informatīva nozīme.
fields:
- {lauka_nosaukums} {lauka_formāts} : {lauka apraksts}
- {salikta elementa nosaukums} * :
comments : {salikta elementa komentārs}
fields:
- {lauka_nosaukums} {lauka_formāts} : {lauka apraksts}
Datu kopas definīcijai jānoslēdzas ar hierarhisku datu lauku sarakstu. Šajā struktūrā var norādīt:
- datu laukus, kur katram laukam ir nosaukums, tips, apraksts. Ja nenorāda datu tipu, tad tiek pieņemts, ka tas ir burtciparu kombinācija (string);
- saliktus elementus, kas sastāv no datu laukiem un citiem saliktiem elementiem. Ja ieraksti varēs saturēt vairāk kā vienu saliktā elementa vērtību (array), tad saliktā elementa definīcijā tas jāatzīmē ar reizinājuma zīmi “*”.
¶ Datu kopas pievienošana pamata videi
Pēc datu kopas definīcijas reģistrēšanas datu kopa ir pieejama priekšlikumu vidē smilškastes režīmā. Respektīvi, servisi datu nodošanai un apskatei pieejami DAGR REST API (https://test.dagr.gov.lv/api) sadaļā “sandbox”. Smilškastes režīms izmantojams datu nodošanas pārbaudei un atkļūdošanai. Kad tas paveikts, tad jālūdz DAGR pārvaldniekam pārcelt datu kopu no smilškastes uz pamata sadaļu.
¶ 5. Datu nodošana uz DAGR
Datus nodot uz DAGR iespējams vairākos veidos – ar servisiem, ar failiem un ar datu bāzes pieslēgumu. Pilna datu nodošanas instrukcija pieejama DAGR programmatūras integrācijas instrukcijā.
Papildus ir pieejami labās prakses piemēri, kas parāda, kā datu nodošana organizējama:
- no datu bāzes, CSV faila vai JSON faila, izmantojot datu devēja savienotāju,
- vai izmantojot DAGR REST API.
¶ 6. Informācijas pakalpojuma reģistrēšana VIRSIS sistēmā
Pēc tam, kad DAGR ir pievienota izplatāmās datu kopas definīcija, datu kopa jāapraksta VIRSIS sistēmā un jāizveido ar to sasistīts informācijas pakalpojums. Plašāka instrukcija ar ekrānšāviņiem atrodama VIRSIS sistēmas dokumentācijā, bet kopumā process sastāv no šādiem soļiem:
- DAGR datu kopas reģistrēšana VIRSIS sistēmā. Sadaļā "Vienotais reģistrs-DAGR datu kopas" ir jāizvēlas darbība "Pievienot ierakstu" un no saraksta jāizvēlas DAGR definētā datu kopa. Piebilde: Sarakstā parādās tikai tās datu kopas, kuras no DAGR priekšlikumu vides (sandbox) ir pārceltas uz pamata vidi (dataset);
- Informācijas resursa izveide. VIRSIS sistēmā ir jāizveido jauns informācijas resurss, jāpārliecinās, ka tas ir statusā kopija/melnraksts, resursam jādefinē datu lauki un tie jāsasaista ar iepriekšējā solī pievienotās DAGR datu kopas datu laukiem;
- Informācijas resursa publicēšana. Pēc datu lauku sasaistes izveides, informācijas resurss ir jāpublicē;
- Pakalpojuma izveide. Pēc informācijas resursa publicēšanas ir jāizveido jauns pakalpojums un tam jāpiesaista publicētais informācijas resurss.
Pēc augstākminēto soļu izpildes datu saņēmēji varēs pieteikties uz informācijas pakalpojumu un pieteikuma saskaņošanas rezultātā iegūt piekļuvi sasitītajām DAGR datu kopām.
¶ 7. Pieteikuma apstiprināšana VIRSIS sistēmā
Pēc informācijas pakalpojuma reģistrēšanas, ja kāds datu ņēmējs uz šo pakalpojumu pieteiksies, pakalpojuma kartiņā norādītās personas saņems paziņojumu par pieteikumu e-pastā.
Saņemtie pieteikumi ir jāizskata un jāapstiprina vai jānorāda. Apstiprinātie pieteikumi ir jāparaksta ar drošu elektronisko parakstu.