HL7 äänestyksen kommentointipyyntö: HL7 Finlandin FHIR-ajanvarauksen soveltamisopas ja IPA-profiilit SMART-soveltamisoppaaseen DL 24.3.2025
HL7 Finlandin pyytää osallistumaan seuraavaan kahteen kommentointiin.
*** Ajanvarauksen FHIR-soveltamisopas ***
HL7 Finlandin ajanvarauksen FHIR-soveltamisoppaan julkaisu on vihdoin lähestymässä. Oppaasta on julkaistu versio 2.0.0-rc1 äänestysmenettelyn lausuntovaihetta varten.
Soveltamisopas yhdistää kaksi aiemmin julkaistua ajanvaraukseen liittyvää soveltamisopasta.
- Vuonna 2020 julkaistu FinnishScheduling R4 mallinsi silloisen ajanvarauksen kansallisen tietosisällön FHIR-muotoon. Tuo opas on kuitenkin pahasti vanhentunut.
- Vuonna 2021 julkaistu FinnishAppointment keskittyi enemmän itse ajan varaamisen toiminnallisuuteen. Sekin on jäänyt päivittämättä, eikä opas täysin noudata FHIR-standardin vaatimuksia.
Nyt julkaistava soveltamisopas siis päivittää nuo aiemmin julkaistut oppaat ja yhdistää ne yhdeksi kokonaisuudeksi. Oppaaseen on myös lisätty esimerkkejä kuten useita esimerkki-instansseja käsittävä kuvaus Appointment-resurssin päivittymisestä ajanvarausprosessin edetessä.
Muutoksia on kuvattu oppaan sivulla https://hl7.fi/fhir/finnish-scheduling/2.0.0-rc1/versions.html#notable-changes. Tekniset muutokset näkyvät myös versionhallinnan kautta, ks. https://github.com/fhir-fi/finnish-scheduling/releases/tag/untagged-836d5701454b7594f99f.
Soveltamisopas ei tällaisena sovellu esimerkiksi määrittelyksi ajanvaraustoiminnallisuuden toteuttamiseen. Siinä ei esimerkiksi ole kuvattu järjestelmien välisiä kutsuja.
Soveltamisopas sisältää useita laajennoksia, mutta kaikille niistä ei ole esimerkkejä. Jotkin laajennoksista on siirretty FHIR-perusprofiilien määrittelyyn, jotta ne olisivat käytettävissä ajanvarausta laajemmin eri tarkoituksiin. Soveltamisoppaan julkaisu edellyttäisi siis myös perusprofiileihin tehtyjen lisäysten hyväksymistä.
Huomattavaa on, että vanhat soveltamisoppaat on julkaistu Simplifier-palvelussa erillisillä tileillä, jotka eivät ole HL7 Finlandin hallinnoimia. Kun soveltamisoppaiden profiilit, laajennokset ja muut resurssit on nyt tuotu tähän uuteen soveltamisoppaaseen, niiden kanoniset osoitteet on päivitetty vastaamaan uuden oppaan julkaisuosoitetta. Tämä muutos ei ole taaksepäin yhteensopiva! Joidenkin laajennosten osalta tämä on ainoa merkittävä muutos. Toisaalta osa muista resursseista on muuttunut niin, että taaksepäin yhteensopivuus menetetään joka tapauksessa ja olemassa olevien toteutusten olisi joka tapauksessa viitattava resurssin uuteen versioon. Selvennyksenä mainittakoon, että aiempien soveltamisoppaiden resursseja voi siis edelleen käyttää sellaisenaan. Eli mitään pakollisia muutoksia tästä ei aiheudu millekään järjestelmälle.
Toinen huomattava asia on, että ajanvarausopas on jossain määrin päällekkäinen Kanta-palveluiden soveltamisoppaan kanssa. Alun perin toive oli, että HL7 Finlandin soveltamisopas päivitettäisiin yhteistyössä ja samassa hankkeessa kuin Kanta-soveltamisopas, mutta yhteistyökuviota ei kuitenkaan saatu sellaisenaan järjestymään. Kela, THL ja jotkin järjestelmätoimittajat ovat tehneet paljon työtä etenkin ajanvarauksen kansallisten käsitteiden ja määrittelyiden parissa ja noilta osin Kanta-soveltamisopas on varmasti paljon kattavampi ja parempi. HL7 Finlandin oppaaasta varmasti löytyy vielä korjattavaa noilta osin. Toisaalta Kanta-soveltamisopas keskittyy vain ajanvarausasiakirjan tallentamiseen Kanta-palveluihin ja sen profiilit saattavat olla liian rajoittavia muihin käyttötapauksiin. Ne esimerkiksi tyypillisesti estävät muiden kuin kansallisten koodistojen käyttämisen.
Kolmas huomattava asia on, että osa laajennoksista on siirretty kansallisiin FHIR-perusprofiileihin, jotta ne olisivat käytettävissä laajemminkin kuin vain ajanvarauksen yhteydessä. Tämän vuoksi myös perusprofiileista on julkaistu versio 2.0.0-rc1. Samassa yhteydessä oppaaseen on tehty pieniä hienosäätöjä kuten kirjoitusvirheiden korjauksia, aiemman palautteen perusteella. Katso muutosten kuvaus ja tekniset muutokset.
*** SMART App Launch -soveltamisoppaan päivitys ***
Ajanvarauksen soveltamisoppaan päivityksen yhteydessä on toteutettu myös toinen, täysin ajanvarauksesta irrallinen muutos. Yhteydet International Patient Access (IPA) -määrittelyyn on poistettu perusprofiileista ja IPA-liitännäiset profiilit on siirretty SMART App Launch-soveltamisoppaaseen. IPA koskee erityisesti kansalaisten käyttämiä sovelluksia ja täten SMART-soveltamisopas tuntuu luontevammalta paikalta näiden profiilien julkaisuun.
Muutokset näkyvät IPA-sidonnaisten profiilien poistona perusprofiileista (ks. v2.0.0-rc1) ja niiden lisäyksenä SMART-soveltamisoppaaseen (v2.0.0-rc1).
Toivomme yhteisöltä kommentteja tästä muutoksesta.
*** Aikataulu ja kommenttien toimitustapa ***
Molempien määrittelyjen osalta lausuntovaihe alkaa 3.3.2025 ja päättyy 24.3.2025 klo 24. Lausuntovaihe on avoin kaikille.
Kommentit pyydetään ensisijaisesti versionhallintajärjestelmän kautta. Luo issue tai vielä paremmin pull request. GitHub edellyttää tunnuksen luomista, mutta tunnuksen luominen on ilmaista. Toissijaisesti kommentit voi toimittaa sähköpostitse osoitteisiin timo.kaskinen(at)nhg.fi ja mikael(at)sensotrend.com. Samoihin osoitteisiin voi osoittaa mahdolliset sisältöön kohdistuvat lisätietokysymykset.
Varsinainen äänestysvaihe alkaa erillisellä ilmoituksella kommenttien käsittelyn ja niiden pohjalta tehtävien tarkennusten jälkeen. Äänestykseen voivat osallistua HL7 Finland ry:n jäsenet. Äänestyksen tarkoituksena on tuottaa HL7-yhdistyksen virallisesti hyväksymiä määrityksiä. Äänestyskierroksella noudatetaan HL7-yhdistyksen teknisen komitean lausunto- ja äänestyskierrosten nykyisiä voimassaolevia sääntöjä, jotka löydät yhdistyksen sivuilta.
Toimeksi saaneena
Timo Kaskinen, HL7 Finland TC co-chair
