Koodistopalvelun ohjeet – Jakelualustat

Kaikki halukkaat voivat käyttää koodistopalvelinta vapaasti.

Selailukäyttäjiä ovat kaikki käyttäjät, jotka eivät kirjaudu sisään järjestelmään. He voivat selailla kokonaisia tietomäärityksiä tai yksittäisiä koodeja sekä ladata julkaistuja tietomäärityksiä ja luokituksia Excel-, teksti- tai XML-muodossa omalle laitteelle.

Koodistopalvelimen etusivu listaa kaikki voimassa olevat koodistopalvelimelta löytyvät tietomääritykset. Tarkempi esim. yksittäisen tietomäärityksen haku onnistuu käyttäen koodistopalvelimen hakutoiminnallisuuksia.

• Ohjeita koodistojen selaamiseen löydät koodistopalvelimella Ohjeet-painikkeen alta.
  Koodistopalvelin (Kanta)
• Yksittäisen tietomäärityksen koodeja voi hakea kyseisen version kohdalla painamalla Tarkennettu haku -painiketta. Tässäkin yhteydessä lisää ohjeistusta hakuihin löytyy Ohjeet-painikkeen alta.

Tietojärjestelmät päivittävät tietomäärityksensä käyttäen koodistopalvelimen REST- tai Web Services –rajapintoja tai hakemalla tiedostojulkaisut.

Tietomääritysten hakutavat:

• Web-käyttöliittymä, Kysely
• REST, Kysely/Päivitys
• Web Services, Kysely
• Tiedostot (julkaisut), Kysely.

Koodistopalvelimen teknisestä ylläpidosta vastaa Kela.

Kansallisen koodistopalvelun tekniseen ylläpitoon liittyvät vastuutahot ja yhteystiedot, palveluajat ja muut palvelun tarjoamiseen liittyvät asiat on kuvattu seuraavassa dokumentissa:
Kanta-palvelut. Kansallinen koodistopalvelu – palvelukuvaus versio 1.15 (KELA pdf, 393 kt)

Tietojärjestelmäkehittäjille tarkoitetut ohjeet kansalliseen koodistopalveluun liittymisen perusperiaatteista, liittymistehtävistä sekä palvelun tuesta testaus- ja ongelmatilanteissa löytyvät seuraavasta ohjeesta:
Kansallisen koodistopalvelun rajapinnat ja liittymisohje (Kanta)

HL 7 Finlandin julkaisema määrittely sisältää koodistopalvelun tiedonsiirron teknisen ohjeen sekä koodistojen siirron ja kyselyn xml-rajapintamäärittelyn:
Koodistopalvelun tiedonsiirron tekninen ohje v. 2.2 (HL7 Finland)

Uusi tietomääritys

Uuden tietomäärityksen rakenteen pohjana voi käyttää jonkin rakenteeltaan mahdollisimman hyvin omaa tarvetta vastaavan tietomäärityksen Excel-julkaisua. Hae tietomäärityksen rakenteen pohjaksi Excel-rakenne koodistopalvelimelta Julkaisut-välilehdeltä sopivan tietomäärityksen kohdalta.

Tietomäärityksen rakennetta valmistellessa pakollisia tietokenttiä ovat koodin tunniste (CodeId), lyhenne (Abbreviation), pitkä nimi (LongName) ja sen ruotsinnos (LångtNamn), lyhyt nimi (ShortName), voimassaolo alkaa (BeginningDate) ja voimassaolo päättyy (ExpiringDate).

Tarpeen mukaan lisätään seuraavat tietokentät: koodin määritelmä (Description) ja sen ruotsinnos (Beskrivning) ja hierarkkisissa luokituksissa kunkin koodin ylempi koodi (ParentId). Vapaaehtoisia lisätietokenttiä voidaan lisätä tarpeen mukaan.

Päivitettävä tietomääritys

Päivitettävän tietomäärityksen pohjaksi tulee hakea koodistopalvelimelta juuri kyseisen tietomäärityksen viimeisin Excel-julkaisu.

Päivitettävän tietomäärityksen rakenteen valmistelussa tärkeintä on merkitä selkeästi esimerkiksi värillä korostaen muutettavat solut.

Tee Excel-tiedostoon kolme välilehteä:

• Uudet: koodit, jotka tuodaan uutena
• Muuttuneet: koodit, joiden jotain tietoa muutetaan
• Päättyvät: koodit, joiden voimassaolo päätetään

Tietomäärityksen rakenne riippuu tietomäärityksen tyypistä. Esimerkiksi seuraavilla on toisistaan osittain eroavat rakenteet:

• Luokitus ja tekninen koodisto
• Organisaatiotyyppinen luokitus
• Tietosisältömääritys
• Lomakemääritys
• Testi- ja mittarimääritys
• Arvojoukko

Lisätietoa tietomäärityksen rakenteen laadintaperiaatteista:
Koodistojen tekniset laadintaperiaatteet sosiaali- ja terveydenhuollon Koodistopalvelussa – Tekninen ohje valmistelijalle (Julkari)

Kysy lisätietoa Koodistopalvelun asiantuntijoilta sähköpostilla koodistopalvelu(at)thl.fi.

Koodistopalvelun lakisääteiseen toimintaan kuuluu myös terminologinen työ, jonka avulla varmistetaan eri tietomääritysten oikeakielisyys, sisällön yhdenmukaisuus ja yhtenäisten käsitteiden ja termien käyttö.

Kun valmistelet uutta tai päivitettävää tietomääritystä, tutustu myös Tietomääritysten kielelliset ja terminologiset laadintaperiaatteet -ohjeeseen.

THL on julkaissut tietomäärityksistä vastuussa oleville valmistelijoille ja asiantuntijaryhmille kielelliseen ja terminologiseen laadunvarmistukseen liittyvän ohjeen, jota voivat hyödyntää myös Koodistopalvelussa toimivat asiantuntijat sekä muut tietomääritysten käsittelyprosesseissa mukana olevat asiantuntijat omassa työssään.

Tietomääritysten hyödyntäjät ja soveltajat saavat ohjeesta sellaista perustietoa, joka auttaa tulkitsemaan tietomääritysten käyttötarkoituksia ja yksittäisten koodien käyttöä.

Tietomääritysten kielelliset ja terminologiset laadintaperiaatteet sosiaali- ja terveydenhuollon Koodistopalvelussa.

Ohjeita valmistelijoille ja asiantuntijaryhmille 11/2025 (Yhteistyötilat)

Tietosisällöt julkaistaan Termetassa asiakirjarakenteina ja tietokomponentteina.

Koodistopalvelimella aiemmin julkaistut terveydenhuollon tietosisältömääritykset siirretään asteittain Termetaan. Siirto tehdään mahdollisuuksien mukaan kunkin tietosisällön seuraavan päivityksen yhteydessä. Luokitukset ja tekniset koodistot säilyvät jatkossakin koodistopalvelimella.
 

Termetassa voit tutustua asiakirjarakenteisiin ja tietokomponentteihin sekä antaa niistä palautetta. Voit etsiä asiakirjarakenteita ja tietokomponentteja erilaisten hakuryhmittelyjen mukaisesti tai rakenteen nimen perusteella. Voit ladata rakenteet myös Excel-tiedostoina tai koneluettavina JSON-muotoisina tiedostoina.

Kela tuottaa Termetan tietojen pohjalta Kanta-palveluun tallentamisessa käytettävät tekniset määrittelyt (CDA/FHIR) ja julkaisee ne Kanta.fi -verkkosivustolla.

Tarkemmat ohjeet Termetan käyttöön löydät oheisista koulutusmateriaaleista.

Termeta-koulutus tietorakenteiden hyödyntäjille (Julkari)

Termeta-koulutus tietorakenteiden hyödyntäjille -videotallenne 30.1.2023 (Youtube)

Yhteystiedot: sotetiedonhallinta(at)thl.fi

Sosmeta-palvelussa näytetään kaikkien niiden asiakasasiakirjojen rakenteet, joita on tarkoitus käyttää valtakunnallisesti sitten, kun organisaatiot liittyvät Kanta-palvelujen käyttäjiksi ja alkavat tallentaa rakenteisia asiakasasiakirjoja Sosiaalihuollon asiakastietovarantoon.

Sosmeta-palvelussa esitetään asiakasasiakirjarakenteet, niiden kontekstitiedot sekä tietokomponentit, joita hyödynnetään rakenteilla. Sosmeta-palvelu sisältää myös asiakasasiakirjarakenteiden ja kontekstitietojen muutoshistoriatiedot sekä tietoja tulevista muutoksista.

Sosmeta-palvelusta pääsee tarkastelemaan myös Sosiaalialan tiedonhallinnan sanastoa.

Sosmetan etusivulta pääset tarkastelemaan asiakirjarakenteita, yksittäisiä tietokomponentteja sekä Sosiaalialan tiedonhallinnan sanastoa. Etusivulta pääset myös antamaan tietorakenteisiin liittyvää palautetta.

Ohjeet Sosmeta-palvelun käyttöön ja asiakasasiakirjojen tulkintaan löydät Kanta-palvelujen käsikirjasta sosiaalihuollon toimijoille (luku 10).

Kanta-palvelujen käsikirja sosiaalihuollon toimijoille (Yhteistyötilat)

Yhteystiedot: sotetiedonhallinta(at)thl.fi