Page History

 

Status
colour Yellow title Luonnos

Table of Contents
exclude LUONNOS

1 Taustaksi

Tällä sivulla kuvataan yhteentoimivuusmenetelmän mukainen tapa määritellä ja kuvata koodistoja Koodistot-työkalulla, kun organisaatio haluaa julkaista koodistojaan myös muiden organisaatioiden tietoon ja hyödynnettäväksi.

...

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:n Yhteentoimivuusalustan tuelta. 

...

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

3 Koodistojen määrittelyosaamisen hankkiminen

Yleensä sisällöntuottajilla on jo valmis koodisto, joka halutaan tuoda Koodistot-työkaluun. Koodistoon voi tehdä myös muokkauksia ja täydennyksiä ennen kuin se julkaistaan Yhteentoimivuusalustalla. Usean organisaation yhteenliittymä voi haluta myös yhdenmukaistaa (harmonisoida) aineistojaan ennen kuin niitä tuodaan Koodistot-työkaluun. Tässä tapauksessa koodistojen sisällön määrittelyyn voidaan tarvita apua ennen kuin koodistot teknisesti viedään ja tallennetaan Koodistot-työkaluun. Tai valmista koodistoa ei ehkä vielä ole, vaan Koodistot-työkalua halutaan käyttää koodiston luonnosten jakelun ja kommentoinnin apuna.

...

Vuonna 2018 VRK järjestää Yhteentoimivuusalustan ja sen työvälineiden käytöstä koulutusta ja tukee käyttäjiä alustan käytössä, erityisesti teknisissä ongelmissa.

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, joissa yhdessä kuvataan koodiston ja siihen kuuluvien koodien ominaisuudet. Määrittelysessioita pidetään tarvittaessa useampikin, eli niin monta kuin tarvitaan koodiston ja siihen sisältyvien koodi(arvoj)en tuottamiseen.

...

Seuraavassa luvussa kuvataan prosessi yksittäisen koodin määrittelemiseksi. Prosessia toistetaan, kunnes kaikki halutut koodit on kuvattu, jolloin ne yhdessä muodostavat koodiston.

5 Yksittäisten koodimäärittelyjen tekeminen

Tässä luvussa kuvataan yksittäisen koodin määrittelyprosessi. Kun kaikki koodien määrittelyt on tehty, ne kootaan yhteen koodistoksi, joka lähetetään ydinkoodistoryhmä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: tarvitaan koodisto, jolla ilmaistaan henkilön äidinkieli. 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.
      Mikäli tämä valmis määritelmä sopii määrittelijöiden käyttötarkoitukseen, siihen voidaan viitata koodin kuvauksessa. 
   2. Mikäli sopivaa aiemmin määriteltyä käsitettä ei löydy, sisällöntuottaja määrittelee koodin itse ilman viittausta sanaston käsitteeseen.
      Esimerkki: halutaan määritellä koodisto eri ajoneuvoille, mutta mopoauto-käsitettä ei löydy sanastoista. Sisällöntuottaja voi 
      • joko ehdottaa lisättäväksi mopoauto-käsitteen (johonkin tieliikenne)sanastoon ja tässä yhteydessä antaa oman ehdotuksensa määritelmästä
      • tai suoraan tekee vain oman määritelmänsä koodille (koodin kuvauksessa ei ole viittausta mihinkään sanastoon)
2. Koodin kuvaukseen lisätään muut tarvittavat metatiedot (voimassaoloaika, viittaukset kansainvälisiin referenssikoodistoihin, mikäli näitä on yms).
3. Kun kaikki koodit/koodiarvot (1 - n kpl) on määritelty tällä tavalla ja koodisto on sisällöntuottajan mielestä valmis, hän merkitsee koodiston tilaksi "Odottaa hyväksyntää".  
4. Yhteentoimivuusalustan tuki saa tiedon koodiston valmistumisesta ja käy läpi sen läpi. Se tarkistaa, onko koodiston kuvaus laadittu ohjeiden ja linjausten mukaisesti.
   1. Mikäli koodisto on muodollisesti oikein laadittu, se siirtyy hyväksymiskäsittelyyn
   2. Mikäli koodiston määrittelyssä on korjattavaa, se lähetetään takaisin laatijalleen korjausohjeiden kera, ja koodiston määrittelyprosessi käynnistyy alusta.
5. Hyväksymiskäsittelyssä Yhteentoimivuusalustan tuki arvioi, voidaanko koodisto hyväksyä sellaisenaan, vai onko se vielä lähetettävä Ydinkoodistoryhmän arvioitavaksi. Yhteentoimivuusalustan tuki 
   
   1. joko hyväksyy koodiston itse (tavallisesti silloin, kun on kyse jo vakiintuneesta ja laajasti käytössä olevasta koodistosta), muuttaa koodiston tilaksi "Voimassa oleva"  ja lähettää tästä hyväksynnästä tiedon sisällöntuottajalle tai 
   2. harkintansa mukaan lähettää sen Ydinkoodistoryhmän käsittelyyn -> katso alla luku 6

6 Ydinkoodistoryhmän (YKR) käsittely

Koko julkishallinnon yhteinen ydinkoodistoryhmä YKR koordinoi kokonaisuutta ja käy läpi sille hyväksyttäväksi toimitetut koodistoehdotukset.

...