Kas jāzina par jauno Atvērtā datu portāla versiju

8.jūlijā notiks Latvijas atvērto datu portāla versijas pārslēgšana uz jauno versiju, tāpēc zemāk ir aprakstītas galvenās izmaiņas, kas būs jāņem vērā pēc atvērto datu portāla jaunās versijas uzstādīšanas. Izmaiņas jau tagad ir pieejamas Latvijas atvērto datu portāla testa vidē https://dpptest.vraa.gov.lv/lv

 

Jaunajā versijā ir ieviesta statistikas sadaļa un ir uzlabots datu ielādes process. Ir uzlabota arī datu atrādīšana un datu filtrēšanas funkcionalitāte pašā portālā.

 

Pirmreizējā .csv datu ielādē  manuāli caur portālu notiks datu validācija ievērojot iepriekš noteiktās csv faila vadlīnijas:

Izmantot UTF-8 BOM kodējumu (CKAN sistēmas spraudņi citos kodējumos saglabāto neattēlo korekti);

Datnes 1. rindai ir jāsatur kolonnu nosaukumi;

Kolonnas nosaukums nevar saturēt specsimbolus (pēdiņas, komats, punkts, slīpsvītra u.c.);

Skaitliskajām vērtībām kā decimālās daļas atdalītāju jālieto punkts (piemēram, 1.024);

Kā kolonnu atdalītājsimbols ir jālieto komats;

Kolonnas nosaukums nevar būt garāks par 63 simboliem;

Katrai tabulas rindai ir jāsatur vienāds kolonnu skaits;

Publicējot datni tīmeklī, kā HTTP satura veids ir jānorāda "text/csv" MIME tips.

 

Datu devējiem saistībā ar jaunas versijas ieviešanu ir jāņem vērā divas izmaiņas, ja tika izmantota automatizēta datu atjaunošana – izmantojot API vai CKAN CLI rīku:

  1. Ir jāizmanto jauns API tokens esošā API key vietā – visas integrācijas ar API key pēc jaunās versijas ieviešanas vairs nestrādās. Lai dabūt API token ir nepieciešams ->

Jāizvēlas lietotāja profils:

A screenshot of a computer

Description automatically generated

Atverot lietotāja profilu jāizvēlas sadaļa API Tokens:

A screenshot of a web page

Description automatically generated

Ievadot nosaukumu API tokenam un spiežot “Create API Token” tiek uzģenerēts API Tokens, kurš parādās virs lietotāja profila zaļā logā.

Šo API tokenu ir jāizmanto automatizētajai datu nodošanai izmantojot CKAN API vai CKAN CLI rīku iepriekšējās “API key” vietā.

  1. CKAN CLI rīka gadījumā būtu jāinstalē rīks no jauna, izmantojot aktualizētu instrukciju - https://github.com/datagovlv/ckan_cli/blob/master/README_LV.md
  2. Lauki “Datu izdošanas datums” un “Datu pēdējo izmaiņu datums” tagad ir obligāti, tāpēc visām datu kopām tie būtu jāaizpilda:

 

Var datu atjaunošanas datumu padot gan caur CKAN CLI, gan caur API.

CKAN CLI ->

Package

https://github.com/datagovlv/ckan_cli/blob/master/example_files/package.json

"metadata_modified": "2019-08-06T06:39:18.422714",

Recource atjaunošanā

"last_modified": "2019-05-14T05:12:21.257451",

https://github.com/datagovlv/ckan_cli/blob/master/example_files/resource.json

Pa tiešo caur API te pilnā dokumentācija https://docs.ckan.org/en/2.10/api/

Jautājumu vai neskaidrību gadījumā lūgums rakstīt uz atbalsts@vraa.gov.lv