Helsinki Region Infoshare -palvelun metatietokanta CKAN:in kirjautumislinkki löytyy hri.fi-sivuston kaikilta sivuilta alabannerin oikeasta laidasta. “Dataportaali”-linkki johtaa CKAN:in sisäänkirjautumislomakkeeseen.

HUOM: CKAN:issa ylläpidetään vain datan meta- eli kuvailutiedot. Jos data on tiedostomuodossa, tulee se julkaista ennen metatietojen lisäämistä tai muokkaamista jollain palvelimella. HRI auttaa tarvittaessa palvelimiin liittyvissä kysymyksissä.

Uuden datan lisääminen

Uusi data lisätään CKAN:iin kahdessa vaiheessa. Ensin lisätään datan meta- eli kuvailutiedot ja sen jälkeen dataan liittyvät resurssit (yksi tai useampia), eli joko tiedoston latauslinkki tai linkki rajapinnan kuvaukseen.

Tee kaikki vaiheet kerralla, älä jätä prosessia kesken. Jos sinulla ei ole kaikkia tarvittavia tietoja heti saatavilla, voi ei-pakollisia kenttiä jättää tyhjiksi ja datan tallentaa Luonnos-tilassa.

1. Mene hri.fi-sivustolla Data-osioon ja kirjaudu sisään CKAN:iin.
2. Varmista vielä haulla, ettei kyseistä dataa ole jo avattu.
   • Jos jokin toinen kaupunki on jo avannut saman(tapaisen) datan, kirjaa datan metatiedot mahdollisimman samalla tavalla. Näin molemmat datat löytyvät samoilla hakukriteereillä.
3. Paina Data-sivun yläosassa olevaa “Lisää tietoaineisto” -painiketta.
4. Täytä lomakkeelle datan metatiedot Metatietokentät-ohjeen mukaisesti. Täytä kentät mahdollisimman kattavasti.
5. Paina lomakkeen alla olevaa “Seuraavaksi: Lisää dataa” -painiketta.
6. Täytä lomakkeelle tiedoston tai rajapinnan tiedot Metatietokentät-ohjeen mukaisesti. Täytä kentät mahdollisimman kattavasti.
   • Tiedosto-kohdassa paina Linkki-painiketta ja syötä siitä avautuvaan kenttään linkki tiedostoon tai rajapinnan kuvaukseen. Älä käytä “Lataa”-painiketta.
7. Jos dataan liittyy useampia tiedostoja, paina lomakkeen alla olevaa “Tallenna ja lisää toinen” -painiketta. Kun olet syöttänyt kaikkien resurssien tiedot, paina “Valmis”-painiketta.
   • Jos data on “Julkinen”-tilassa, se näkyy heti hri.fi-sivustolla. Jos data on “Luonnos”-tilassa, luonnos tallentuu ja on sisäänkirjautuneiden käyttäjien nähtävissä.
8. Mene vielä kuvaustekstin yläpuolella olevalle “Datakokoelmat”-välilehdelle ja lisää data sopiviin datakokoelmiin.
   • Jos data on rajapinnan kautta saatavissa, lisää se “Rajapinnat”-datakokoelmaan.

Jo avatun datan metatietojen kopioiminen uuden pohjaksi

Jos organisaatiosi on jo avannut samantapaisen datan kuin se, jota olet avaamassa, voit kopioida olemassa olevan datan metatiedot uuden datan metatietojen pohjaksi. Kaikkia kopioituja kenttiä pystyy vapaasti muokkaamaan.

1. Mene hri.fi-sivustolla Data-osioon ja kirjaudu sisään CKAN:iin.
2. Etsi datahaulla data, jonka metatiedot haluat kopioida uuden datan metatietojen pohjaksi.
3. Paina otsikon alla olevaa “Muokkaa”-painiketta.
4. Paina lomakkeen alla olevaa “Kopioi”-painiketta.
5. Kirjoita uuden datan suomenkielinen otsikko “Nimi”-kenttään ja kopioi se. Paina kentän alla olevan “URL”-rivin lopussa olevaa “Muokkaa”-painiketta ja liitä otsikko siitä avautuvaan kenttään (aukeaa “Nimi”-osion jälkeen). Kun poistut kentästä, kentän sisältö muokkautuu automaattisesti URL-osoitteeseen sopivaan muotoon.
6. Jatka lomakkeen muokkaamista ja täydentämistä Uuden datan lisääminen -ohjeen mukaisesti kohdasta 4 eteenpäin.

Jo avatun datan metatietojen päivittäminen

1. Mene hri.fi-sivustolla Data-osioon ja kirjaudu sisään CKAN:iin.
2. Etsi datahaulla data, jonka metatietoja haluat päivittää.
3. Paina otsikon alla olevaa “Muokkaa”-painiketta.
4. Muokkaa datan metatietoja Metatietokentät-ohjeen mukaisesti. Täytä kentät mahdollisimman kattavasti.
5. Tarkista, että muissakin kentissä olevat tiedot ovat ajan tasalla ja linkit yhä toimivia.
6. Paina lopuksi lomakkeen alla olevaa “Päivitä tietoaineisto” -painiketta.

Jo avatun datan resurssien päivittäminen

1. Mene hri.fi-sivustolla Data-osioon ja kirjaudu sisään CKAN:iin.
2. Etsi datahaulla data, jonka resurssin haluat päivittää.
3. Klikkaa “Data ja resurssit” -otsikon alla olevaa päivitettävän resurssin nimeä.
4. Paina otsikon alla olevaa “Muokkaa”-painiketta.
5. Muokkaa resurssin metatietoja Metatietokentät-ohjeen mukaisesti. Täytä kentät mahdollisimman kattavasti.
   • Jos päivität URL:ia, älä paina “Poista”-painiketta, vaan kirjoita uusi URL kenttään. ”Poista”-painikkeen painaminen johtaa virhetilanteeseen.
6. Tarkista, että muissakin kentissä olevat tiedot ovat ajan tasalla ja linkit yhä toimivia.
7. Paina lopuksi lomakkeen alla olevaa “Päivitä resurssi” -painiketta.

Uuden resurssin lisääminen jo avattuun dataan

1. Mene hri.fi-sivustolla Data-osioon ja kirjaudu sisään CKAN:iin.
2. Etsi datahaulla data, johon haluat lisätä resurssin.
3. Paina otsikon alla olevaa “Muokkaa”-painiketta.
4. Siirry lomakkeen yläpuolella olevalle “Data ja resurssit” -välilehdelle.
5. Paina “Lisää uusi resurssi” -painiketta.
   • Täytä lomakkeelle tiedoston tai rajapinnan tiedot Metatietokentät-ohjeen mukaisesti. Täytä kentät mahdollisimman kattavasti.
6. Tiedosto-kohdassa paina Linkki-painiketta ja syötä siitä avautuvaan kenttään linkki tiedostoon tai rajapinnan kuvaukseen. Älä käytä “Lataa”-painiketta.
7. Paina “Lisää”-painiketta.
8. Voit vaihtaa resurssien järjestystä menemällä “Muokkaa” -> “Data ja resurssit” -> “Uudelleenjärjestä resurssit”. Resurssien järjestystä pystyy muokkaamaan hiirellä raahaamalla. Paina lopuksi “Tallenna järjestys” -painiketta.

Datojen tai resurssien poisto

Jos sinulla on tarve poistaa joko yksittäinen resurssi tai koko data HRI:n datakatalogista, ole yhteydessä HRI-tiimiin. Kaikki “Poista”-painikkeet eivät toimi ja osa voi johtaa virhetilanteeseen ja sivuston kaatumiseen, joten HRI-tiimi tekee kaikki poistot.

Ylläpidolta (HRI-tiimi) pyydettäviä asioita

• datojen tai resurssien poistaminen
• käyttäjähallinta:
  • uuden käyttäjän lisääminen
  • käyttäjän poistaminen
• uuden datakokoelman luominen
• organisaatioiden lisääminen ja muokkaaminen
  • älä lisää tai muokkaa organisaatioiden tietoja itse, se saattaa rikkoa datojen automaattisen kopioitumisen avoindata.fi-palveluun
• datojen massamuokkaus
  • jos sinulla on tarve muokata useammasta datasta samaa kenttää (esim. organisaation sähköpostiosoitteen vaihtaminen), voi HRI-tiimi tehdä sen massamuokkaustyökalulla

Mahdolliset virhetilanteet

Mahdollisissa virhe- tai ongelmatilanteissa sekä metadataan liittyvissä kysymyksissä saa apua HRI-tiimiltä (hri@hel.fi).

HRI:n (CKAN) metatietokentät ja ohjeet metatietojen päivittämiseen

Täytä mahdollisimman monta kentää, jotta data löytyy paremmin ja käyttäjä ymmärtää paremmin, mistä datassa on kyse.

Pakolliset kentät on merkitty kahdella tähdellä (**). Kentät, jotka olisi hyvä lisäksi täyttää jokaisesta datasta, on merkitty yhdellä tähdellä (*).

HRI-palvelu auttaa tarvittaessa metatietojen laatimisessa.

HRI:n metatietomalli noudattelee DCAT-AP-metatietomallia.

Data

Datan erilliset metatiedot (välilehdillä)

Resurssi

Resursseiksi laitetaan vain avoimena datana julkaistava(t) tiedosto(t) tai linkki rajapintakuvaukseen. Lisätietoa datasta sisältävät dokumentit (esim. doc tai pdf) laitetaan linkkeinä datan metatietokuvaukseen Lisätietoja-kohtaan.

Tiedostojen nimiin ja hakemistopolkuihin ei saa laittaa skandeja tai muita erikoismerkkejä eikä välilyöntejä.

HRI:n (CKAN) markdown-muotoiluohjeet

Hyvät perusohjeet:
https://github.com/akx/markdown-cheatsheet-fi/blob/master/Markdown-Ohje.md

Valtaosa tuon ohjeen muotoiluista toimii HRI:ssa, alla on poikkeuksia ja käytäntöjä.

Otsikot

• ensimmäinen käyttäjän syöttämä otsikkotaso on ##Otsikko (h2)

Listat

• • ennen ja jälkeen listan tulee olla rivinvaihto (muuten lista taittuu yhdeksi kappaleeksi)
    alilistan syntaksi:

– ylempi taso

• • – alemman tason

• • – viivan

• • – eteen

• • – neljä välilyöntiä

– ylempi taso jatkuu

1. numeroiduissa listoissa
2. piste tai kaarisulku
3) numeron perään
4. ja välilyönnit ennen ja jälkeen listan

Linkit

• syntaksi: [linkin teksti](https://linkki.fi)
• linkin tulee olla http- tai (mieluummin) https-alkuinen
• hakasulun ja sulun välissä ei saa olla välilyöntiä

Taulukot

• eivät toimi HRI:ssa (tai oikeaa syntaksia ei ole löytynyt)

Rivinvaihdot

• kappaleiden välissä tulee olla yksi tyhjä rivi, muuten kappaleet taittuvat peräkkäin

Kuvat

• syntaksi: 
• kuvat täytyy laittaa jollekin ulkoiselle palvelimelle, HRI ei tarjoa tähän palvelintilaa