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ä Osaamiskeskukseen ja pyytää tukea koodistojen määrittelyyn.

...

• Osaamiskeskuksen 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.

...

Yhteentoimivuusmenetelmän mukaisessa määrittelytyössä pyritään hyödyntämään (uudelleenkäyttämään) aiemmin määriteltyjä koodistoja mahdollisimman paljon. Näin samoja tietomäärityksiä ei tarvitse tehdä moneen kertaan, vaan voidaan tehdä viittauksia jo aiemmin tehtyihin koodistoihin. Ensimmäinen vaihe siis on tarkistaa, onko jossain jo aiemmin tehty omaan käyttötarpeeseen sopiva koodisto ja hyödyntää sitä sellaisenaan. Mikäli täsmälleen omaan tarpeeseen sopivaa koodistoa ei löydy, tarkistetaan, voidaanko jo olemassa olevasta koodistosta hyödyntää jotain osuutta, jolloin tarvitsee määritellä vain siitä puuttuvat osuudet. Tällöin siis tuotetaan olemassaolevasta koodistosta uusi variantti. Koodistojen osalta on muistettava, että yksikin muutos tekee koodistosta variantin, jotta eri koodistojen eheys voidaan varmistaa. Vaikka jokin koodisto poistettaisiin aktiivisesta käytöstä - esimerkiksi koska tästä samasta koodistosta on tuotettu uusi versio - jätetään myös koodiston vanha versio referenssisyistä saataville. (Joskin sen tilakoodi muutetaan

Mikäli mikään aiempi koodisto ei sovellu sisällöntuottajan tarpeisiin, Mikäli aiemman koodiston pohjalta tuotetaan uusi koodisto, tätä uutta koodistoa sanotaan var

.

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

5 Yksittäisten

...

koodimäärittelyjen tekeminen

Jokaisen käsitteen koodin määrittelyssä toistuvat seuraavat vaiheet:

1. Käsitteen määrittely alkaa tarkistamalla, onko Onko käsitteelle jo olemassa valmis, sopiva määrittely jossain Sanastot-työkalun sanastossa.
   1. Mikäli sopiva käsite löytyy ja sen määritelmä vastaa täysin omaa tarvetta, riittää, että omaan sanastoon lisätään vain viittaus kyseiseen käsitemääritelmään (vrt. linkitetyssä datassa määritelmää ei kopioida, vaan siihen viitataan) koodin määritelmässä viitataan kyseiseen käsitemääritelmään -> siirry kohtaan 3
      Esimerkki: Julkisen hallinnon yhteisestä sanastosta löytyy käsite Henkilö, jonka määritelmä on seuraava: toimija, joka on ihminen. Mikäli tämä Julkisen hallinnon yhteisen sanaston määritelmä sopii määrittelijöiden käyttötarkoitukseen, voidaan viitata suoraan kyseisen sanaston käsitteeseen. 
   2. Mikäli käsitteen määritelmä ei suoraan sellaisenaan sovellu, voidaan sen pohjalta laatia oma, tarkennettu määritelmä. Lisätään määritelmään viittaus lähdekäsitteeseen -> siirry kohtaan 3
      Esimerkki: Halutaan määritellä käsite palvelunantaja. Se on Julkisen hallinnon yhteisen sanastossa on määritelty seuraavasti: toimija, joka järjestää, tuottaa tai toteuttaa palveluja. Mikäli tämä käsite sosiaalihuollossa halutaan tarkentaa, se voidaan sosiaalihuollon näkökulmasta määritellä tarkemmin (toimija, joka järjestää, tuottaa tai toteuttaa sosiaalipalveluja, terveyspalveluja tai sosiaali- ja terveydenhuollon yhteisiä palveluja) ja viitataan käsitteen kuvauksessa, että se on tarkennettu Julkisen hallinnon yhteisen sanaston palvelunantaja-käsitteestä.
2. Mikäli sopivaa aiemmin määriteltyä käsitettä ei löydy, sisällöntuottaja tekee käsitteelle tarvitsemansa määritelmän itse. 
   
   1. Esimerkki: Sisällöntuottaja toteaa, ettei mopoautolle löydy yleistä määritelmää, ja tekee määritelmän itse (esim. kevyt nelipyöräinen moottorikäyttöinen ajoneuvo). 
3. Lisätään näin saatu määritelmä työn alla olevaan sanastoon.
4. Kun kaikki käsitemäärittelyt ovat valmiina, lähetetään niistä koostuva sanasto oman tietoalueen sanastotyöryhmän käsittelyyn (luku 6). 

6

...

Tietoalueen koodistotyöryhmän (

...

TA-KTR) käsittely

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

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

7 Ydinsanastoryhmän (YSR) käsittely 

YSR koordinoi kokonaisuutta ja käy läpi sille hyväksyttäväksi toimitetut sanastoehdotukset.

...