FHIR hyödyntäminen

Tämän soveltamisoppaan lukijalla oletetaan olevan perustietämys HL7® FHIR-standardista. Sama koskee myös muita Kanta-palvelujen FHIR soveltamisoppaita. Etenkin FHIR-standardin RESTful API (HTTP) osuus on oleellinen mutta myös muiden osuuksien ymmärtäminen auttaa ymmärtämään FHIR-rajapintoja (FHIR resurssien käyttö, resurssien profilointi).

FHIR-standardi ja sen RESTful API määrittelyt mahdollistavat useita eri tapoja toteuttaa FHIR-rajapintoja. Tässä soveltamisoppaassa ja palvelukohtaisissa soveltamisoppaissa lähinnä rajataan mitä kaikkia ominaisuuksia FHIR-standardista ja FHIR RESTful API:sta on käytössä.

Kanta-palvelut pohjautuvat pääsosin FHIR:n R4-versioon. Omatietovarannossa on ollut käytössä myös STU3-versio. Tulevaisuudessa FHIR R5 versio tultaneen hyppäämään yli ja arvioidaan tarve uudemmalle FHIR version käyttöönotolle myöhemmin (esim. R6). FHIR versio on tärkeää huomioida, kun toteutetaan FHIR rajapintoja.

Kanta-palveluisa käytetään FHIR-standardissa tuetuista formaateista vain JSON formaattia, muita formaatteja ei tueta.

Profilointitavasta

Kanta-palveluiden resurssien profiloinnissa käytetään tarkkaa profilointia. Tämä johtuu siitä, että Kanta-palvelut ovat vastuussa palveluihin tallennettavan tiedon kansallisten tietosisältömäärittelyjen mukaisuudesta (teknisesti). Tämän seurauksena resurssien profiileissa on mukana vain tietosisältömäärittelyjen mukaiset resurssien elementit ja tarvittavat laajennukset. Tietojen pakollisuudet ja toistuvuudet noudattavat kansallisten tietosisältöjen toistuvuuksia ja pakollisuuksia. Koodistojen osalta noudatetaan kansallisissa tietosisällöissä määriteltyjä ja sallittuja koodistoja. Kannattaa huomioida, että mahdolliset väljennykset tietosisältöihin on tehtävä myös kansallisiin tietosisältömäärittelyihin ja niistä vastaavan tahon kanssa yhteistyössä ennen profilointia.