SerAPI-työpajaseminaari Työpaja 1: Ajanvarausrajapinnat ja niiden soveltaminen

1. SerAPI-työpajaseminaariTyöpaja 1: Ajanvarausrajapinnat ja niiden soveltaminen Mika Tuomainen SerAPI-projekti, HIS-tutkimus Kuopion yliopisto,Tietotekniikkakeskus 6.2.2007

2. Ohjelma • Aamupäivä (8:45 - 11:15) • tekninen liittymämäärittely • skeema/wsdl/soap-esimerkit -paketti • käytännön xml-esimerkkejä "tarinan" avulla • muut aiheet.. • Lounas (11:15 - 12:15) Kuopion yliopisto / SerAPI-hanke

3. Ohjelma • Iltapäivä (12:15 - 14:45) • osallistujien puheenvuoroja • yhteisesti sovittavat asiat alueellisissa ratkaisuissa • muut asiat • määrittelyjen tarkennukset, käyttöönoton tuki, kansallinen ajanvaraus, HL7 lausuntokierros, kansainvälinen yhteistyö • jatkotyö Kuopion yliopisto / SerAPI-hanke

4. Tähän asti tehty työ • Tarpeiden ja vaatimusten kartoitus • Valmiiden toimintamallien ja standardien kartoitus • Ajanvarausrajapinnat - vaatimukset ja rajaukset -dokumentti • Ajanvarausrajapinnat - tekniikkariippumaton määrittely (perusratkaisumalli) • Ajanvarausrajapinnat - tekninen liittymämäärittely (HL7 versio 3) Kuopion yliopisto / SerAPI-hanke

5. Julkistetut määrittelyt • Vapaasti hyödynnettävissä • Ajanvarausrajapinnat - tekniikkariippumaton määrittely, v1 http://www.uku.fi/tike/his/serapi/mater/AjanV_Tekniikkariippumaton_v1.pdf • Ajanvarausrajapinnat - tekninen liittymämäärittely, v1 http://www.uku.fi/tike/his/serapi/mater/AjanV_Tekninen_v1.pdf • Lisäksi teknisiin määrittelyihin liittyviä viestiesimerkkejä on saatavilla osoitteessa: http://www.uku.fi/tike/his/serapi/mater/HL7v3SchedulingFI04.zip Kuopion yliopisto / SerAPI-hanke

6. Tekninen liittymämäärittely • "Lukuohje": • miten kannattaa lukea yleensä HL7v3 sovellusalueita • ensin sovellusalueen yleiskuvaus -> interaktiolistaukset -> sanomankuvaus (+ kontrollikehys + siirtokehys + triggerit), jne.. • mikä "nice-to-know" -tietoa ajanvarausmäärittelyssä (appointment-topic, triggerit) • Sisältö • Mitä määritelty itse Kuopion yliopisto / SerAPI-hanke

7. Mitä määritelty itse • Lisäyksiä sovellusalueen tietomalliin (DMIM) • Ajanvarauskyselyt • Perumispyyntö • Siirtämispyyntö • Muokkaamispyyntö • Ajanvarauksen tiedot sisältävä ilmoitus ajanvarauksen tilasta • ilmoitus vapaan ajan muuttumisesta ei-vapaaksi ja • varatun ajan muuttuminen vapaaksi. • edellisiin HMD:t, interaktiot, koodistot, triggerit (tarvitaanko triggereitä?) Kuopion yliopisto / SerAPI-hanke

8. Mitä hyödynnetty suoraan • Sovellusalueen tietomalli • Sovellusroolit • Soveltuvat koodistot (HL7v3 koodistoilla ei vielä FI-koodeja, käytännöt tämän suhteen?) • Uuden ajanvarauksen varauspyyntö (+ vastaukset) • Ilmoitus vapaista ajoista • ilman ajanvarauksen tietoja • Appointment topicia ei hyödynnetä! • yleisiä ilmoituksia olemassa olevista ajanvarauksista • koko ajanvarauksen peruminen Kuopion yliopisto / SerAPI-hanke

9. Itse määritellyt kohdat • Noudattavat sovellusalueen tietomallia • Interaktiot muodostettu HL7v3 rakenteiden mukaisesti • Kyselyt muodostettu HL7v3 kyselyrakenteiden mukaisesti • Lisäykset tietomalliin noudattaa RIM-tietotyyppejä ja HL7v3 "määrittelysääntöjä" Kuopion yliopisto / SerAPI-hanke

10. skeema/wsdl/soap-esimerkki -paketti • HL7v3SchedulingFI04 • zip-paketti • ajanvarausviestien XML-skeemat (interaktiot, sanomankuvaukset, kehykset, CMETit) • ajanvarausviestien SOAP-esimerkit • viestejä käyttävien sovellusroolien WSDL:t. • mukana myös muut tarvittavat HL7v3-skeemat Kuopion yliopisto / SerAPI-hanke

11. Käytännön esimerkkejä.. • Tarina -> • Viestissä tarvittavat tiedot -> • Sijoitettu tiedot xml-esimerkkeihin • Keskustelua läpikäynnin aikana/jälkeen • muutamia kysymyksiä jo valmiina esimerkin seassa Kuopion yliopisto / SerAPI-hanke

12. Muita asioita.. • Tarkennukset • palvelutuoteluokan ja palvelutuotteen ilmaiseminen ja määrittely • CMET, jossa paikka riskitiedolle • lupa siirtämiseen, perumiseen ja muokkaamiseen tarkemmin • varattujen aikojen kyselyn vastaus (muistutuspyyntö) • tietosisältöjen laajuus eri sanomissa • avaimen välittäminen ja käyttö • pää- ja aliajanvaraukset Kuopion yliopisto / SerAPI-hanke

13. Muita asioita.. • Käyttöönoton tuki • koulutus • esimerkit • lisää "tarinoita" esimerkkisisällöillä? • esimerkkitoteutukset • eri tekniikoilla "av-järjestelmiä" + "av-palvelu" • integrointialustan mukaan ottaminen • osapuolikohtainen tuki • Määrittelyjen "kypsyys" Kuopion yliopisto / SerAPI-hanke

14. Ohjelma • Iltapäivä • osallistujien puheenvuoroja • yhteisesti sovittavat asiat alueellisissa ratkaisuissa • muut asiat • määrittelyjen tarkennukset, käyttöönoton tuki, kansallinen ajanvaraus, HL7 lausuntokierros, kansainvälinen yhteistyö • jatkotyö Kuopion yliopisto / SerAPI-hanke

15. Kansallinen ajanvaraushanke • SerAPI osallistunut esiselvitysprojektiryhmän palavereihin ja tuotettuun materiaaliin • Linkitetty SerAPIssa tehtyä valmista työtä esiselvitykseen • Mahdollisuus osallistua kehitys- / koordinaatio-projektin toteutusvaiheeseen • etenkin rajapinnat / standardit / järjestelmät-näkökulmasta • SerAPIn loputtua työ jatkuu Kansallisessa ajanvaraushankkeessa? Kuopion yliopisto / SerAPI-hanke

16. SerAPI-käsitemallin suhde kansallisen ajanvarauksen käsitemalliin Kuopion yliopisto / SerAPI-hanke

17. [kansallinen ajanvarauspalvelu - käsitemalli (yleinen)] Kuopion yliopisto / SerAPI-hanke

18. Kansallinen ajanvaraushanke • Esiselvityshanke 1.10.2006–28.2.2007 • Toteutusten koordinaatiohanke 1.3.2007- 30.4.2008 • 2.2. Seminaari: Kansalliset ajanvarauksen mallit ja määrittelyt • ohjelma ja materiaalit osoitteessa http://www.uku.fi/tike/his/serapi/av070202.html Kuopion yliopisto / SerAPI-hanke

19. Yhteisesti sovittavat asiat alueellisissa ratkaisuissa • Teknisen liittymämäärittelyn luku 7 "Soveltamisohje alueellisen ajanvarauksen toteuttamiseen" Kuopion yliopisto / SerAPI-hanke

20. Soveltamisohjeen sisältö • Sovellusten roolit ja vastuut (ajanvarauspalvelu ja -järjestelmä) • Toiminnallisuus, toimintojen suhde ja järjestys (eri skenaariot: uusi ajanvaraus, peruminen siirtäminen, muokkaaminen, kyselyt, ilmoitukset) • Ajanvarauksen sovellustason virheiden ilmoittaminen • Pakollisesti toteutettavat toiminnot ja tiedot ("minimitietosisällöt") • Tietoturvaratkaisut (liikenne, tunnistaminen ja oikeudet) • Palvelutuotteiden ja palvelutuoteluokkien käyttäminen • Ajanvaraussovellusalueen toteuttaminen HL7v3 Web Services profiililla Kuopion yliopisto / SerAPI-hanke

21. Kommentit soveltamisohjeen sisältöön • Mitä puuttuu? • Mikä turhaa? • Mitä pitäisi tarkentaa? • ??? Kuopion yliopisto / SerAPI-hanke

22. Palvelujen sopiminen • Miten varattavat palvelut sovitaan ? • määrittely • yksilöinti • selville saaminen • Yhteisen palvelutuoteluokituksen määrittely ainakin alueellisesti? • Kokoaako ajanvarauspalvelu yhteiset "luokat" vai löytyykö yhteinen luokittelu ajanvarausjärjestelmistä? • Mille tarkkuustasolle palvelut määritellään? • Miten määritellään, mitä palveluja kukin käyttäjä näkee? • asiakkaan/ammattilaisen näkökulma eroaminen toisistaan (esim. mitä kellekin näytetään) Kuopion yliopisto / SerAPI-hanke

23. Määritysten "liikkumavara" • Tuetaanko sekä vapaiden aikojen replikointia että vapaiden kyselyä • molemmat yhdessä järjestelmässä / yhdenmukaistus alueellisesti tai kansallisesti • Yhteisesti määritellyt minimitietosisällöt, jotka toteutettava ja joita tuettava? • palvelun tiedettävä, mitä tietoja kunkin järjestelmän kanssa käsitellään • sovitaanko "aina tuettavat" tiedot alueellisesti vai yhteisesti Kuopion yliopisto / SerAPI-hanke

24. HL7 Finland lausuntokierros • Tammikuun HL7 Finland uutiskirjeessä tiedote • http://virtual.vtt.fi/virtual/hl7/0702serapi_av_tiedote.doc • Kevään aikana HL7 lausuntokierrokselle • Ennen sitä kommenteille • yhteyshenkilö mika.tuomainen@uku.fi Kuopion yliopisto / SerAPI-hanke

25. Käyttöönoton tuki • Koulutus (HL7v3, ajanvaraussovellusalue) • Esimerkit • lisää "esimerkkitarinoita" • Esimerkkitoteutukset • eri tekniikoilla "av-järjestelmiä" + "av-palvelu" • integrointialustan mukaan ottaminen • Osapuolikohtainen tuki Kuopion yliopisto / SerAPI-hanke

26. Kansainvälinen yhteistyö • Vaatimusten vienti kansainväliseen HL7v3 Schedulingiin • Osallistuminen varsinaiseen määrittelytyöhön • HL7 WG Saksassa 05/07 Kuopion yliopisto / SerAPI-hanke

27. Jatkotyö • Tarkennukset • Käyttöönoton tuki • HL7 Finland lausuntokierros • Vaatimusten vienti kansainväliseen HL7v3 Schedulingiin, osallistuminen varsinaiseen määrittelytyöhön • Osallistuminen Kansallisen ajanvaraushankkeen teknisen puolen määrittelytyöhön Kuopion yliopisto / SerAPI-hanke