Suomi.fi kehittäjille
Siirry suoraan sisältöön.

Koodistojen laajennukset

Koodistot-työkalu tarjoaa mekanismin, jonka avulla koodistojen ylläpitäjät voivat kontrolloidusti laajentaa koodiston tietosisältöä erilaisia tarpeita varten. Koodistot-työkalu tarjoaa tällä hetkellä vajaat kymmenkunta laajennuskokonaisuutta käytettäväksi.

Laajempi käyttöohje on GitHubissaAvautuu uuteen ikkunaan..

Koodistot-työkalun laajennusmekanismin keskeiset osat ovat laajennustyyppilaajennus ja jäsen.

Laajennustyyppi

  • Laajennustyyppi määrittelee koodistoon liitettävissä olevat lisäominaisuudet sekä niiden semantiikan.
  • Koodistot-työkalu tarjoaa tällä hetkellä vajaat kymmenkunta erilaista laajennustyyppiä käytettäväksi, kukin näistä liittää omanlaisiaan näkymiä ja/tai tietokenttiä osaksi koodistoa.
  • Tuetut laajennustyypit on kuvattu tarkemmin kohdassa Tuetut laajennustyypit.

Laajennus

  • Laajennustyypin tarjoamat ominaisuudet otetaan käyttöön luomalla koodistoon laajennus.
  • Koodistoon luodaan laajennus ja valitaan sille sovelias laajennustyyppi, sen mukaan mitä lisäominaisuuksia koodistossa halutaan hyödyntää.

Jäsen

  • Laajennuksen varsinainen sisältö koostuu jäsenistä.
  • Jäsen sisältää laajennustyypin määrittelemät lisätietokentät sekä viittaukset koodeihin.


Koodistot-työkalun tarjoamat laajennustyypit ovat jaoteltavissa keskeisten ominaisuuksiensa puolesta kahteen kategoriaan: 

  1. hierarkialaajennuksiin ja
  2. koodilaajennuksiin.

Hierarkialaajennusten avulla voidaan muodostaa hierarkkisia koosteita koodeista. Koodilaajennusten avulla puolestaan voidaan lisätä koodeihin uusia tietokenttiä.

Hierarkialaajennukset

  • Mahdollistavat hierarkkisten rakenteiden koostamisen koodeista.
  • Liittävät hierarkian jäseniin ennalta määriteltyjä tietokenttiä, esimerkiksi nimi tai vastaavia tarkenteita.
  • Ovat varsin yleiskäyttöisiä ja niitä voidaan käyttää laajasti erilaisissa käyttötapauksissa jäsentämään olemassa olevia koodeja.
  • Eivät aseta rajoitteita samaa laajennustyyppiä olevien laajennusten määrälle per koodisto.

Koodilaajennukset

  • Laajentavat koodia ennalta määrätyillä tietokentillä.
  • Ovat tyypillisesti räätälöity tiettyyn käyttötarkoitukseen ja rajaavat kenttien sallittuja arvoja.
  • Rajoittavat että tiettyä laajennustyyppiä olevia laajennuksia voi olla enintään yksi per koodisto.


Koodistot-työkalun tukemat laajennustyypit esitellään tässä taulukossa.

Laajennustyyppi

Arkkityyppi

Kuvaus

Määrityshierarkia

Hierarkialaajennus

Mahdollistaa vaihtoehtoisen hierarkian muodostamisen koodeista. Hierarkiaan voidaan sisällyttää koodeja yhdestä tai useammasta koodistosta ja kustakin koodistosta voidaan ottaa joko kaikki tai osajoukko koodeista mukaan. Kullekin hierarkian jäsenelle voidaan antaa tarkentava nimi kuvaamaan jäsenen roolia hierarkiassa.

Laskentahierarkia

Hierarkialaajennus

Perusominaisuuksiltaan vastaava kuin Määrityshierarkia -laajennus, mutta tukee lisäksi summaus- ja vertailuoperaattorien määrittämistä kullekin hierarkian jäsenelle.

Koodiliitos

Hierarkialaajennus

Mahdollistaa yksisuuntaisen linkityksen muodostamisen koodien välille. Linkitettävät koodit voivat olla yhdestä tai useammasta koodistosta.

DPM Metric

Koodilaajennus

Lisää koodin tietosisältöön Data Point Modeling -metodologian mukaisen Metric-käsitteen vaatimat kentät. Mahdollistaa näin DPM Metric -käsitteiden esittämisen Koodistot-työkalun koodeina.

DPM Explicit Domain

Koodilaajennus

Ominaisuuksiltaan vastaava kuin DPM Metric -laajennus, mutta sisältäen DPM Explicit Domain -käsitteen kentät.

DPM Typed Domain

Koodilaajennus

Ominaisuuksiltaan vastaava kuin DPM Metric -laajennus, mutta sisältäen DPM Typed Domain -käsitteen kentät.

DPM Dimension

Koodilaajennus

Ominaisuuksiltaan vastaava kuin DPM Metric -laajennus, mutta sisältäen DPM Dimension -käsitteen kentät.


Päivitetty: 20.11.2025

Oletko tyytyväinen tämän sivun sisältöön?