Terminologia

Tältä sivulta löytyvät Kanta-palvelujen FHIR rajapinnoissa ja resursseissa käytettävien termilogioiden yleisesti huomioitavat asiat sekä yhteisesti käytettävät ValueSet-instanssit (arvojoukot) ja Kansallisen koodistopalvelun ulkopuoliset CodeSystem-instanssit (koodistot).

Yleisesti huomioitavat asiat

ValueSet ja Import all codes from CodeSystem

FHIR koodatuissa tiedoissa käytettävät koodistot sidotaan tietoelementtiin FHIR ValueSet resurssin avulla. ValueSet voi sisältää varsinaisen arvojoukon, johon on poimittu tietyt koodit koodistosta/koodistoista. Myös ulkoiset Kansallisen koodistonpalvelun koodistot sidotaan FHIR koodattuihin tietoihin ValueSet resurssin avulla. Usein ulkoiset koodistot tuodaan kokonaisuudessaan ilman tiettyjen koodien poimintaa arvojoukoksi. Tämä on ilmaistu ValueSet resurssissa seuraavasti:

This value set includes codes from the following code systems: Import all codes from CodeSystem urn:oid:.

Esim. Import all codes from CodeSystem urn:oid:1.2.246.537.5.40128.2006

Tällöin tuodaan koodistopalvelun koodistosta kaikki koodit, ei vain voimassaolevat. Koodien voimassaolot tarkastetaan erikseen Kanta-palvelujen sisäisissä koodistotarkastuksissa.

Coding tietotyypin tietoelementtien käyttö

Kanta FHIR rajapinnoissa Kansallisen koodistopalvelun koodistot esitetään vastaavalla tavalla kuin muissakin Kanta rajapinnoissa, FHIR käyttöönotto ei tuo tähän muutosta. FHIR Coding tietotyypillä Kansallisen koodistopalvelun koodisto ja koodin tiedot esitetään seuraavasti (huom. tietotyyppi voi olla myös CodeableConcept mutta CodeableConcept lopulta sisältää Coding tietotyypin ja alla olevat tiedot):

  • system: koodistopalvelun version tunniste (pakollinen)
  • code: koodin tunniste (pakollinen)
  • display: koodin pitkä nimi (pakollinen)

Kanta yhteisesti käytettävät ValueSet-instassit (arvojoukot)

Nimi Status url Käyttökohde
figen-vs-provenancerolecategory active http://gen.kanta.fi/ValueSet/figen-vs-provenancerolecategory Value set, jota käytetään Kanta-palvelujen Provenance-profiileissa toimijan roolin ilmoittamisessa. Value set sisältää kaikki koodiston Kanta Provenance Role Category arvot.
figen-vs-practitionerauthenticationmethod active http://gen.kanta.fi/ValueSet/figen-vs-practitionerauthenticationmethod Value set, jota käytetään Kanta-palvelujen Practitioner-profiilissa käytettävässä AuthenticationMethod-laajennoksessa, jolla ilmoitetaan ammattihenkilön tunnistautumistapa. Value set sisältää kaikki koodiston Kanta-palvelut - Tunnistautumistapa arvot.
figen-vs-relatedpersonrole draft https://gen.kanta.fi/ValueSet/figen-vs-relatedpersonrole Value set, jota käytetään puolesta-asioijan/laillisen edustajan roolin ilmoittamiseen. Value set sisältää käytettävät arvot koodistosta Sosiaalihuolto - Asiakkuuteen liittyvä rooli.

Kanta yhteisesti käytettävät CodeSystem-instanssit (koodistot)

Nimi Status url Käyttökohde
figen-cs-provenancerolecategory active http://gen.kanta.fi/figen-cs-provenancerolecategory Code system, jota käytetään Kanta-palvelujen Provenance-profiileissa toimijan roolin ilmoittamisessa.
Kanta OAuth Scopes active http://gen.kanta.fi/CodeSystem/figen-cs-kantaoauthscopes Koodisto sisältää kaikki Kanta auktorisointipalvelun hyväksymät OAuth scopet, sekä käännökset suomeksi, ruotsiksi ja englanniksi.