Page History

 

Status
colour Yellow title Luonnos

Table of Contents
exclude LUONNOS

1 Taustaksi

Tällä sivulla kuvataan yhteentoimivuusmenetelmän mukainen tapa toteuttaa koodistojen määrittelyjä ja kuvauksia Koodistot-työkalulla, kun organisaatiolla on tarve hyödyntää tai julkaista tietosisältöjään yli organisaatiorajojen.

...

Huom. Selkeyden vuoksi tässä vuokaaviokuvauksessa ei ole mukana koodiston hylkäämistä eikä prosessin keskeytymistä tai päättymistä. (Sisällöntuottaja voi tarvittaessa keskeyttää prosessin missä vaiheessa tahansa.)

2 Käyttöoikeudet

Mikäli organisaatio haluaa tuoda koodistonsa Yhteentoimivuusalustalle, mutta ei vielä ole rekisteröitynyt sisällöntuottajaksi eli Yhteentoimivuusalustan käyttäjäksi, on sen ensimmäiseksi haettava alustan käyttöoikeutta VRK:lta. 

...

Käyttöoikeudet saatuaan sisällöntuottajaorganisaatio pääsee tuottamaan sisältöjä Koodistot-työkalulla, mutta myös muilla Yhteentoimivuusalustan työkaluilla (Tietomallit ja Sanastot).

3 Koodistojen määrittelyosaamisen hankkiminen

Mikäli sisällöntuottajaorganisaatiolla ei ole kokemusta Koodistot-työkalun käytöstä, sen kannattaa ottaa yhteyttä VRK:n YTI-tiimiin ja pyytää tukea koodistojen määrittelyyn.

...

• YTI-tiimin keskeisiä tehtäviä on eri tietoalueiden tekemän työn koordinointi, jotta koodistojen määrittely eri tietoalueilla tehdään yhdenmukaisten periaatteiden mukaisesti ja vältetään päällekkäistä työtä.

4 Koodistomäärittelyjen käynnistäminen

Kun sisällöntuottajaorganisaatiolla on koodistojen määrittelyn asiantuntija käytettävissään, varsinainen määrittelytyö alkaa aihealueen eli substanssin asiantuntijoiden nimeämisellä. Nämä asiantuntijat kootaan yhteiseen määrittelysessioon. Määrittelysessioita pidetään tarvittaessa useampikin, eli niin monta kuin tarvitaan koodiston ja siihen sisältyvien koodi(arvoj)en tuottamiseen.

...

Kun halutut koodit(koodiarvot on määritelty seuraavassa luvussa kuvatulla tavalla, määritellyt koodit (1 - n kpl) kootaan yhteen koodistoksi, joka lähetetään tietoalueen koodistotyöryhmän käsittelyyn -> katso alla luku 6

5 Yksittäisten koodimäärittelyjen tekeminen

Yksittäisenkin koodin muuttaminen valmiista koodistosta merkitsee, että koodistosta syntyy uusi variantti. Tässä luvussa kuvataan yksittäisen koodin määrittelyprosessi. Kun kaikki koodien määrittelyt on tehty, ne kootaan yhteen koodistoksi, joka lähetetään oman tietoalueen koodistoryhmän käsittelyyn (luku 6). 

...

1. Löytyykö koodin tietosisällön kuvaamiseen sopiva käsite jossain Sanastot-työkalun sanastossa?
   1. Mikäli sopiva käsite löytyy, se voidaan ottaa koodin määrittelyn pohjaksi. 
      Esimerkki: Julkisen hallinnon yhteisestä sanastosta löytyy käsite Äidinkieli, jonka määritelmä on seuraava: kieli, joka on merkitty väestötietojärjestelmään henkilön kieleksi. Lisäksi määritelmässä on huomautus: Yleiskielessä äidinkielellä tarkoitetaan kieltä, jonka henkilö on oppinut ensimmäisenä ja johon hän samaistaa itsensä.
      Mikäli tämä Julkisen hallinnon yhteisen sanaston määritelmä sopii määrittelijöiden käyttötarkoitukseen, koodin kuvauksessa voidaan viitata tämän käsitteen määritelmään. 
   2. Mikäli sopivaa aiemmin määriteltyä käsitettä ei löydy, sisällöntuottaja määrittelee koodin itse ilman käsiteviittausta
2. Täydennetään koodin kuvaus muilla tarvittavilla metatiedoilla (esimerkiksi viittaukset kansainvälisiin referenssikoodistoihin ym.).
3. Kun kaikki koodimäärittelyt ovat valmiina, lähetetään niistä koostuva koodisto oman tietoalueen koodistotyöryhmän käsittelyyn (luku 6). 

6 Tietoalueen koodistotyöryhmän (TA-KTR) käsittely

Kunkin tietoalueen koodistotyöryhmän vastuulla on tarkastaa sille hyväksyttäväksi toimitetut koodistot.

1. Ensimmäiseksi tarkistetaan, onko koodistoehdotus laadittu ohjeiden ja linjausten mukaisesti.
   1. Mikäli koodisto on muodollisesti oikein laadittu -> siirry kohtaan TA-KTR-2
   2. Mikäli koodistossa on korjattavaa, se lähetetään takaisin laatijalleen korjausohjeiden kera, ja koodistotyöprosessi käynnistyy alusta - tosin sen läpivienti on nopeampaa kuin jos aloitettaisiin täysin alusta.
2. Seuraavaksi koodistotyöryhmä arvioi, onko käsittelyyn toimitetun koodiston tietosisältö määritelty siten, että se on yhdenmukainen tietoalueen muiden määrittelyjen kanssa ja onko tarjotulla koodistolla laajempaakin käyttöä - vai onko se sellainen, jota vain sen oma sisällöntuottajaorganisaatio tarvitsee?
   1. Mikäli koodistomääriykset tietosisältönsä puolesta kelpaavat sellaisinaan, eikä niille todeta tarvetta sisällöntuottajaorganisaationsa ulkopuolella, ne voidaan hyväksyä organisaation sisäiseksi koodistoksi -> siirry kohtaan TA-KTR-6
   2. Mikäli koodistolla arvioidaan olevan käyttöä koko julkishallinnossa tai se vaikuttaa soveltuvan paremmin toiselle tietoalueelle, nämä määrittelyt lähetetään julkishallinnon KTR:n käsittelyyn -> siirry lukuun 7
3. Kun koodistoehdotuksen käsittely jatkuu omalla tietoalueella, TA-KTR arvioi, soveltuuko se tietoalueen käyttöön sellaisenaan vai onko sitä muokattava.
   1. Tarvittaessa TA-KTR muokkaa koodistoa niin, että koodisto soveltuu paremmin koko tietoalueen käyttöön. 
4. Muokattu koodistoehdotus lähetetään kommenttikierrokselle.
   Saatujen kommenttien perusteella tietoalueen koodistotyöryhmä tekee tarvittavat muutokset. (Mikäli muutokset ovat merkittäviä, TA-KTR voi halutessaan lähettää koodistoehdotuksen uudelle kommenttikierrokselle.)
5. Lopuksi tietoalueen koodistotyöryhmä hyväksyy koodiston ja muuttaa sen tilaksi ”Voimassa oleva”.
   (Mikäli koodistoa ei hyväksytä, se palautuu takaisin koodistoprosessiin.)
   Tietoalue (eli koodistotyöryhmä) vastaa tässä yleistämisprosessissa muokattujen tai sellaisinaan hyväksyttyjen, yleistettyjen koodistojen ylläpidosta. Ne koodistot, joita TA-KTR ei katso tarpeellisiksi yleistää, jäävät sellaisinaan edelleen sisällöntuottajaorganisaationsa käyttöön ja vastuulle.
6. Tietoalueen koodistotyöryhmä ilmoittaa sisällöntuottajaorganisaatiolle läpikäytyjen koodistojen hyväksymisestä.
   
   

7 Julkishallinnon koodistotyöryhmän (KTR) käsittely 

Koko julkishallinnon koodistotyöryhmä KTR koordinoi kokonaisuutta ja käy läpi sille hyväksyttäväksi toimitetut koodistoehdotukset.

...