Ajanvarausrajapinnat. Tekninen liittymämäärittely

Transkriptio

1 Ajanvarausrajapinnat Tekninen liittymämäärittely SerAPI projekti Yhteyshenkilö Mika Tuomainen Dokumentin tila Dokumentin versio 1 Päiväys

2 Sisällysluettelo 1 Johdanto Ajanvaraussovellusalueen yleiskuvaus Yleistä (overview) Ajanvaraus rajapintana palveluille Keskeisimmät HL7v3 Scheduling käsitteet Sovellusroolit Interaktiotyypit Käsitteiden order, appointment, encounter ja service väliset suhteet Ajanvaraus tilakoodien mappaus HL7v3 Act Status koodeihin Mitä kattaa (scope) Edellytykset, oletukset, käytännöt Edellytykset Oletukset Käytännöt Ajanvaraus sovellusalueen tietomalli (DMIM) Appointment / Slot topic Appointment topic Käyttötapauskuvaukset (Storyboards) Ajanvarausilmoitukset, Appointment Notification (PRSC_ST000002) Sovellusroolit (Application roles) Käynnistävät liipaisintapahtumat (Trigger Events) RMIM kuvaukset Appointment RMIM Full (PRSC_RM010000) Appointment Minimum RMIM (PRSC_RM020000) Hierarkkiset sanomankuvaukset (HMD:t) New Appointment (PRSC_HD010100) Revise Appointment (PRSC_HD010200) Cancel Appointment (PRSC_ HD020100UV01) Reschedule Appointment (PRSC_HD020200) Appointment NoShow (PRSC_HD020300) Interaktiot New Appointment Notification (PRSC_IN010101) Revise Appointment Notification (PRSC_IN010201) Reschedule Appointment Notification (PRSC_IN020201) Cancel Appointment Notification (PRSC_IN020101) Appointment Cancellation Request (PRSC_IN010601) Appointment Cancellation Confirmation (PRSC_IN010602) Appointment Cancellation Rejection (PRSC_IN010603) Appointment Noshow Notification (PRSC_IN010501) Slot topic Käyttötapauskuvaukset (Storyboards) Slot kohtainen ajanvarauspyyntö, Slot Booking (PRSC_ST000003) Sovellusroolit (Application roles) Käynnistävät liipaisintapahtumat (Trigger Events) RMIM kuvaukset Slot Request RMIM (PRSC_RM050000FI01) SerAPI projekti

3 4.4.2 Slot RMIM Full (PRSC_RM030000FI01) Slot RMIM Minimum (PRSC_RM040000FI01) Hierarkkiset sanomankuvaukset (HMD:t) Appointment Request by Slot (PRSC_HD050100FI01) New Appointment by Slot (PRSC_HD030200FI01) Slot Status Revision (PRSC_HD040100FI01) Cancel Appointment by Slot (PRSC_HD030300FI01) Reschedule Appointment by Slot (PRSC_HD030400FI01) Revise Appointment by Slot (PRSC_HD030500FI01) Interaktiot New Appointment Slot Request (PRSC_IN030101FI01) New Appointment Slot Confirmation (PRSC_IN030102) New Appointment Slot Rejection (PRSC_IN030103) Slot Status Revise Notification (PRSC_IN020400) Slot Status Revise Request (PRSC_IN020301) Slot Status Revise Confirmation (PRSC_IN020302) Slot Status Revise Rejection (PRSC_IN020303) Appointment Cancel Request by Slot (PRSC_IN040201FI01) Appointment Cancel Confirmation by Slot (PRSC_IN FI01) Appointment Cancel Rejection by Slot (PRSC_IN040203FI01) Appointment Reschedule Request by Slot (PRSC_IN040301FI01) Appointment Reschedule Confirmation by Slot (PRSC_IN040302FI01) Appointment Reschedule Rejection by Slot (PRSC_IN040303FI01) Appointment Revise Request by Slot (PRSC_IN040401FI01) Appointment Revise Confirmation by Slot (PRSC_IN040402FI01) Appointment Revise Rejection by Slot (PRSC_IN040403FI01) Appointment Status Revise Notification by Slot (PRSC_IN40404FI01) Ajanvaraussovellusalueen Slot kohtaiset kyselyt Kyselyn rakenne HL7v3:ssa Aikojen kyselyn siirtokehys (Send Message Payload) Aikojen kyselyn kontrollikehys (Query Control Act Request : ParameterList As Stub, QUQI_HD020000FI01) Kyselyn vastauksen rakenne HL7v3:ssa Aikojen kyselyn vastauksen siirtokehys (Application Level Acknowledgement) Aikojen kyselyn vastauksen kontrollikehys (Query Control Act Response / Acknowledgement, QUQI_HD120000UV01) Aikojen lisävastauksien kysely/aloitetun kyselyn lopettaminen HL7v3:ssa Aikojen lisävastauksien kyselyn/aloitetun kyselyn lopettamisen siirtokehys (Send Message Payload) Aikojen lisävastausten kyselyn/aloitetun kyselyn lopettamisen kontrollikehys (Query Control Act Request Continuation / Cancellation, QUQI_HD000001UV01) Kyselyjen sovellusroolit Kyselyjen käynnistävät liipaisintapahtumat (Trigger Events) Parametrilistojen hierarkkiset sanomankuvaukset (HMD:t) Query Available Slots by Resource ParameterList (QUSC_MT040101FI01) Query Appointments by Slot ParameterList, QUSC_MT040103FI Kyselyihin liittyvä interaktiot Query Available Slots by Resource, QUSC_IN040101FI Response Available Slots by Resource, QUSC_IN040102FI Query Appointments by Slot, QUSC_IN040103FI SerAPI projekti 3

4 5.7.4 Response Appointments by Slot, QUSC_IN040104FI Query Control Act Request Continuation / Cancellation, QUQI_ IN040105FI Epäonnistuneen kyselyn vastaus Domainissa käytetyt yleiset viestielementit (CMET) R_Patient identified/confirmable COCT_HD050002UV R_AssignedPerson universal (COCT_MT090100UV01) R_AssignedOrganization identified (COCT_MT090201UV01) R_AssignedOrganization contact (COCT_HD090203UV01) E_OrganizationUniversal (COCT_MT150000UV02) R_ServiceDeliveryLocation universal (COCT_MT240000UV01) Soveltamisohje alueellisen ajanvarauksen toteuttamiseen Sovellusroolit Toiminnallisuus, toimintojen suhde ja järjestys Ajan varaaminen, profiili: vapaat ajat selvitetään kyselyllä Ajan varaaminen, profiili: ajat replikoitu Ajanvarauksen peruminen Ajanvarauksen siirtäminen, profiili: vapaat ajat selvitetään kyselyllä Ajanvarauksen siirtäminen, profiili: vapaat ajat replikoitu Ajanvaraustietojen muokkaaminen Ilmoitus vapaan ajan muuttumisesta ei vapaaksi/varatun ajan muuttuminen vapaaksi Ajanvarauksen sovellustason virheet Pakolliset toiminnot ja tiedot Ajanvarauspalvelun ja järjestelmän toteuttamat toiminnallisuudet Pakolliset tiedot eri interaktioissa Tietoturvaratkaisut Tietoliikenteen tietoturva HL7 WS Security profiili Tunnistaminen ja oikeudet Ajanvarausviestien ulkopuolisia huomioitavia seikkoja Palvelutuotteiden ja palvelutuoteluokkien käyttäminen Ajanvaraussovellusalueen toteuttaminen HL7v3 WS profiililla Sanomien tekninen kuljetustapa WS Addressing Vuorovaikutusten esittäminen WSDL kuvauksilla Jatkokehitys Käsitteet Versiohistoria Versio: Pvm: Laatijat: Selitys: Versio Mika Tuomainen Juha Mykkänen Marko Sormunen Heli Luostarinen Assi Pöyhölä Jari Porrasmaa Julkinen versio. 4 SerAPI projekti

5 Esipuhe Tämä työ liittyy SerAPI hankkeeseen (Palveluarkkitehtuuri ja Web sovelluspalvelut Terveydenhuollon Ohjelmistotuotannossa ja integraatiossa), jossa tutkitaan ja kehitetään websovelluspalvelujen ja palvelupohjaisen arkkitehtuurin hyödyntämistä terveydenhuollon tietojärjestelmätarpeisiin ja sovellusintegraatioon ja uusiin sekä olemassa oleviin ohjelmistotuotteisiin. Hanketta rahoittavat Tekes (päätös numerot 40251/06, 40353/05, 40437/04) sekä joukko yrityksiä ja sairaanhoitopiirejä. Tämä dokumentti sisältää avointen ajanvarausrajapintojen teknisen liittymämäärittelyn. SerAPI projekti 5

6 1 Johdanto Tämä dokumentti sisältää ajanvarausrajapintojen teknisen liittymämäärittelyn. Teknisenä ratkaisuna esitetään HL7v3 Scheduling domainin (ajanvaraussovellusalue) toteuttaminen HL7v3 Web Services profiilin avulla. Dokumentin tavoitteena on antaa kuvaa siitä, mitä ajanvarausrajapintojen toteuttaminen HL7v3 määrityksillä tarkoittaa, mitä osia HL7v3 Scheduling sovellusalueesta voidaan hyödyntää ja mitä osia on jouduttu työstämään itse. Dokumentin luvuissa 2 4 ja 6 kuvataan HL7v3 January 2006 ballotista (HL7 2006) löytyvän Scheduling sovellusalueen sisältö. Lukujen yhteydessä on korostettu, mitä sovellusalueesta voidaan hyödyntää Suomeen lokalisoidussa/alueellisessa ajanvarauksessa (SAV) suoraan sekä mitä ballotista ei löydy ja on jouduttu näin itse lisäämään/määrittelemään ajanvaraussovellusalueeseen. Luvussa 5 on erikseen kuvattu ajanvaraukseen SAVissa määritellyt ajanvarauskyselyt. Ongelmana HL7v3 Scheduling sovellusalueen hyödyntämisessä on sen keskeneräisyys. Sovellusalueesta puuttuu mm. ajanvarauskyselyt, siirtämis ja muokkaamispyynnöt sekä slot kohtainen perumispyyntö. Nämä on jouduttu määrittelemään itse. Kaikissa itse määrittelyissä lisäyksissä on noudatettu mahdollisimman pitkälle HL7v3 Scheduling sovellusalueelle määriteltyä tietomallia. Lisäksi itse määriteltävät sanomat rakennetaan yleisten HL7v3 sanomarakenteiden mukaisesti. Puuttuviin ajanvarauskyselyihin käytetään HL7v3 Query Infrastructurea ja siihen määriteltyä kyselyrakennetta. Lukujen 2 4 ja 6 lähteenä on HL7v3 January 2006 ballot (HL7 2006) ja sen Scheduling domain. Scheduling domain löytyy ballot paketin polusta "HL7 Version 3 Standard Domains Administrative Management Domains Scheduling". Luvun 5 kyselyissä on käytetty HL7v3 Query Infrastructurea, joka löytyy ballot paketista polusta"hl7 Version 3 Standard Specification Infrastructure Messaging Query Infrastructure". Jos tämän dokumentin lukijalla ei ole January 2006 ballot pakettia, voi sen pyytää erikseen SerAPIlta / HL7 Finlandilta (jatkossa on sovittava erikseen, mistä sekä ballot että normatiiviset HL7v3 paketit ovat saatavilla). Sovellusalueen kuvauksen jälkeen luvussa 7 "Soveltamisohje alueellisen ajanvarauksen toteuttamiseen" kuvataan, kuinka SAV määrittelyjen kohteena oleva alueellinen ajanvaraus toteutetaan hyödyntämällä HL7v3:n ajanvaraussovellusaluetta sekä HL7v3 Web Services profiilia. Luvun 7 Web Services kohtien lähteenä on käytetty HL7v3 January 2006 ballot paketin Specification Infrastructure. Se löytyy ballot paketin polusta "HL7 Version 3 Standard Specification Infrastructure Transport Specifications Web Services Profiles". Ajanvaraussovellusalueeseen yhdistettävät käyttötapaukset, vaatimukset, toiminnallisuus ja tietosisällöt ovat määritelty aiemmin SerAPI hankkeessa ja dokumentoitu seuraaviin dokumentteihin: Ajanvarausrajapinnat vaatimukset ja rajaukset, v1.6 (Tuomainen ym. 2006a). Ajanvarausrajapinnat tekniikkariippumaton määrittely, v1 (Tuomainen ym. 2006b). Jos HL7v3 ei ole lähestymistapana tuttu, kannattaa lukea Open CDA 2006 dokumentti "HL7 Finlandin suositus V3 viestien käyttöönottoon" (Open CDA 2006). Dokumentin luku 4 "Semanttisen sisällön implementointi" auttaa tämän dokumentin lukujen 2 6 läpikäymisessä. Siinä on selitetty tässä dokumentissa käytettäviä HL7v3 artefakteja (mm. sovellusroolit, liipaisimet, interaktiot, tietomallit) sekä niiden merkitystä ja käyttöä. Muut osat Open CDA suositusdokumentissa helpottavat tämän dokumentin luvun 7 lukemista. 6 SerAPI projekti

7 2 Ajanvaraussovellusalueen yleiskuvaus Tässä luvussa käydään läpi ajanvaraussovellusalueen yleiskuvaus. Tavoitteena on hahmottaa ballotpaketista löytyvää HL7v3 Scheduling sovellusaluetta. Samoin tässä luvussa kuvataan kuhunkin osaan Suomessa (SAV) tarvittavia lisäyksiä tai muutoksia. HUOM. Vaikka HL7v3 Scheduling sovellusalueen yleiskuvauksessa puhutaan jo kyselyistä ja useista erilaisista pyynnöistä, ei näitä käytännössä ole vielä määritelty sovellusalueeseen ja ne on määriteltävä SAVissa. 2.1 Yleistä (overview) HL7v3:ssa ajanvarausta käsitellään sekä sovellusalueena (domain) että prosessina. Ajanvaraussovellusalue tarjoaa yleisen joukon viestejä ja toimintoja, joilla eri ajanvarausskenaarioita voidaan toteuttaa. Prosessina ajanvaraus määrittelee abstraktin tietomallin ja joukon operaatioita, joita mikä tahansa muukin HL7v3 sovellusalue voi hyödyntää. HL7 käsittää ajanvarauksen palveluna ja palvelun käytön rajapintana. HL7v3 January 2006 ballot paketin ajanvaraussovellusalue sisältää yleiset ajanvarausviestit, jotka voidaan toteuttaa sellaisenaan tai sitten niitä voidaan käyttää sovellusaluekohtaisten ajanvarausviestien pohjana. Ajanvarausviestit on suunniteltu terveydenhuollon palvelujen yleisten ajanvarauksien ja/tai resurssien aikavälien (slot) käytön varaamiseen. Ajanvaraussovellusalueessa käytetään kolmea perusinteraktiotyyppiä: Pyyntöviestit ja niiden vastaukset. Kyselyviestit ja niiden vastaukset (näitä ei ole vielä mukana January 2006 ballot paketissa). Ilmoitukset ulkopuolisille kiinnostuneille tahoille. Ajanvarauspyyntötapahtumissa tehdään pyyntöjä, joilla varataan tiettyjä palveluiden tai resurssien aikavälejä. Nämä transaktiot tapahtuvat tilaajan (placer) ja toimittajan (fulfiller) välillä. Kyselyjen avulla voidaan kysellä sekä varattuja että vapaita aikoja. Ilmoituksilla ulkopuolisille kiinnostuneille tahoille voidaan jakaa ajanvaraustietoja eri osapuolten välillä Ajanvaraus rajapintana palveluille Alussa mainittiin, että sovellusalue käsittää ajanvarauksen palveluna ja palvelun käytön rajapintana. Kuvassa 1 on esitetty tällainen lähestymistapa. Rajapinta esitetään joukkona operaatioita/toimintoja, joita käytetään palveluluokan tai komponentin määrittelemiseen. Kuvan esimerkin ActAppointment luokka keskittyy ajanvarausilmoitusviesteihin (Appointment Notifications). ActAppointmentluokan tarjoamat toiminnot ovat perusilmoituksia ulkopuolisille kiinnostuneille tahoille. Sovellusalueluokat, jotka ovat kuvan 1 oikeassa reunassa, voivat olla vuorovaikutuksessa ajanvaraukseen. SerAPI projekti 7

8 Kuva 1. Ajanvaraus yleisen ActAppointment luokan tarjoamana palveluna (HL7 2006a) Keskeisimmät HL7v3 Scheduling käsitteet Seuraavilla termeillä ja käsitteillä on erityismerkitys HL7v3 ajanvarauskontekstissa: Ajanvaraustaulut (Schedules) kontrolloivat tiettyjä palveluita ja tiettyjen resurssien käyttöä. Ajanvaraustaulut koostuvat joukosta avoimia (open), varattuja (booked), ennakkoon varattuja (reserved) ja lukittuja (blocked) aikoja tietylle palvelulle ja resurssille. Aikavälit (Slots) ovat tunnistettavissa olevia ajanjaksoja, joita voidaan varata. Vapaat ajat (Open slots) ovat ajanjaksoja (aikavälejä), joiden aikana palvelu voi tapahtua ja/tai resurssi on vapaa käytettäväksi. Varatut ajat (Booked slot) ovat ajanjaksoja, jotka on jo varattu jollekin palvelulle tai resurssille. Ennakkoon varatut (Reserved slot) ajat ovat ajanjaksoja, jotka on varattu alustavasti tai yleisesti (esim. ajat, jotka on laitettu sivuun uusien potilaiden varalle). Lukitut ajat (Blocked slot) ovat ajanjaksoja, jolloin palvelu tai resurssi ei ole käytettävissä muusta syystä kuin ollessaan varattuna (esim. jokin laite voi olla poissa käytöstä huollon aikana). Ajanvaraukset (Appointments) ovat ajanvaraustaulun varattuja aikoja, jotka vievät ajanvaraustaulusta yhden tai useamman aikavälin. Toistuvat ajanvaraukset / sarja ajanvaraukset (Repeating Appointments) ovat ajanvarauksia, joissa ensimmäisenä varattu ajanvaraus toistuu myöhempänä ajankohtana sisältäen saman 8 SerAPI projekti

9 potilaan, palvelun ja siihen liittyvät resurssit muodostaen näin sarjan samanlaisista ajanvarauksista. Palvelut (Services) ovat reaalimaailman tapahtumia, kuten klinikan ajanvaraukset, joita kontrolloidaan ajanvaraustaulun avulla. Resurssit (Resources) Resurssit ovat konkreettisia kohteita, joiden käyttöä kontrolloidaan ajanvaraustaulun avulla. Näitä resursseja ovat henkilöt, paikat ja laitteet/tarvikkeet/esineet. SAVissa määritellyt keskeiset käsitteet löytyvät tämä dokumentin luvusta Sovellusroolit Ajanvarausprosesseja varten on tunnistettu useita sovellusrooleja. Alla on kuvattu näiden sovellusroolien määritelmät. Yksi ajanvaraussovellus voi toteuttaa useampia sovellusrooleja. Esimerkiksi sovellus voi olla sekä ajanvarauksesta ilmoittaja (appointment informer) että myös ajanvarauspyyntöjen tekijä (appointment requestor) toiselle sovellukselle. Kaikkia alla lueteltuja sovellusrooleja ei tueta vielä tässä ajanvaraussovellusalueen January 2006 ballot versiossa. Appointment Informer Tässä roolissa sovellus ilmoittaa vastaanottavalle sovellukselle uusista ajanvarauksista sekä ajanvarauksiin tapahtuneista muutoksista. Appointment Tracker Tässä roolissa sovellus on ainoastaan ajanvaraustietojen vastaanottajana. Toisin sanoen sovellus ei itse generoi ajanvarausviestejä, mutta saa ilmoituksia. Appointment Requestor Tässä roolissa sovellus tekee uusien ajanvarausten varauspyyntöjä sekä perumis, siirtämis ja muokkauspyyntöjä olemassa oleviin ajanvarauksiin. Pyyntöjen kohteena on tavallisesti ajanvaraustaulun omistaja. Appointment Confirmer Ajanvaraustaulun omistaja, joka vastaa toisen sovelluksen pyyntöihin. Esimerkiksi toinen sovellus lähettää ajanvarauspyynnön ja pyyntöön vastaaja joko vahvistaa tai hylkää ajanvarauspyynnön. Slot Requester Ympäristössä, jossa sovellukset ovat ajanvaraustietojen osalta tiukasti yhteen kytkettyjä ja jakavat tietonsa näin aikaväleistä (slots), sovellukset voivat tehdä ajanvarauspyyntöjä, jotka kohdistuvat suoraan tiettyyn aikaväliin. Tässä roolissa sovellus voi tehdä uuden ajanvarauksen varauspyynnön, muokata olemassa olevaa ajanvarausta sekä tehdä pyyntöjä, joilla se muokkaa tietyn aikavälin tilaa. Slot Request Confirmer Tässä roolissa ajanvaraustaulun omistaja vastaa tiettyjen aikavälien varauspyyntöihin. Slot Informer Tässä roolissa ajanvaraustaulun omistaja lähettää ilmoituksia ulkopuoliselle kiinnostuneelle taholle aikavälien tilan muutoksista. Slot Tracker Tässä roolissa sovellus on ulkopuolinen kiinnostunut taho, jolle lähetetään ilmoituksia aikavälien tilan muutoksista. Seuraavat sovellusroolit eivät ole vielä mukana, vaan ovat suunniteltu toteutettavaksi seuraavissa ajanvaraussovellusalueen ballot versioissa: SerAPI projekti 9

10 Appointment Inquirer Tässä sovellusroolissa sovellus tekee kyselyitä ajanvaraustaulun omistajalle. Esimerkiksi se voi kysellä listaa kaikista potilaista, joille on varattu aika kuulotutkimuksiin tietylle päivälle klo 8:sta klo 17:sta. Appointment Query Responder Tässä roolissa ajanvaraustaulun omistaja vastaa ajanvaraustauluun kohdistuneihin kyselyihin. Esimerkiksi vastaus kyselyyn, jossa kysellään tietyn lääkärin kaikkia varattuja aikavälejä. Lisäksi SAV ajanvarausmäärittelyissä tarvitaan HL7v3 Scheduling sovellusalueesta puuttuvat Slotkohtaisten kyselyjen sovellusroolit Slot Inquirer Tässä sovellusroolissa sovellus tekee kyselyitä vapaista ja varatuista ajoista Slot kohtaisesti. Slot Query Responder Tässä sovellusroolissa sovellus vastaa vapaiden ja varattujen aikojen kyselyihin. HL7v3 sovellusroolien mappaus aiempiin SAV määrittelyihin kuvataan luvussa 7.1 Sovellusroolit Interaktiotyypit Ajanvarausviesteissä on kolme perusinteraktiotyyppiä: Ilmoitukset (notifications) ovat viestejä, joilla ilmoittava sovellus ilmoittaa aikataulussaan tapahtuneista muutoksista vastaanottavalle järjestelmälle. Vastaanottava sovellus voi ainoastaan kuitata saaneensa ilmoituksen. Pyynnöt/vastaukset (requests/responses) ovat viestejä ja liipaisintapahtumia (trigger events), joita käytetään pyyntöjä tekevän sovelluksen ja ajanvaraustaulun omistavan järjestelmän välillä. Pyynnön tekevä sovellus lähettää ajanvaraustaulun omistajalle viestin, jolla se pyytää ajanvaraustaulun omistajaa muokkaamaan ajanvaraustaulua. Ajanvaraustaulun omistaja muokkaa ajanvaraustaulua viestistä saamiensa tietojen ja liipaisintapahtumien perusteella ja vastaa ajanvarauspyyntöön joko hyväksymällä pyynnön tai hylkäämällä sen.. Kyselyt/vastaukset (queries/responses) ovat kyselevän sovelluksen ja ajanvaraustaulun omistajan välisiä viestejä ja liipaisintapahtumia. Kyselevä sovellus tekee ajanvarauskyselyn, johon ajanvaraustaulun omistaja vastaa Käsitteiden order, appointment, encounter ja service väliset suhteet Tilaus (order) käynnistää ajanvaraamisprosessin. Tilaus voi johtaa yhteen tai useampaan resurssien varaamispyyntöön. Kun ajanvaraustaulun omistava sovellus saa pyynnön, se luo ajanvarauksen (appointment) varaamalla tietyn resurssin ajanvaraustauluun aikavälin/ välejä. Näin aika on varattu. Jos kyseessä on avohoidon potilas (outpatient) ja potilas saapuu vastaanotolle, palvelutapahtuma (encounter) alkaa ja ajanvaraus on valmis (complete). Jos potilas ei saavu paikalle, ajanvaraukseen merkitään, että potilas ei saapunut (no show). Kun potilaan käynti vastaanotolla on valmis, myös palvelutapahtuma on valmis. 10 SerAPI projekti

11 Jos kyseessä on laitoshoidon potilas (inpatient), tarvitaan yleensä kerralla useita palveluita (service). Laitospalvelun palvelutapahtuma alkaa, kun potilas saapuu sairaalaan ja palvelutapahtuma ei ole valmis ennen kuin kaikki tarvittavat palvelut suoritettu ja potilas on päästetty pois sairaalasta. Tutkimuksia sekä muita kliinisiä ja ei kliinisiä tapahtumia kontrolloidaan ajanvaraustaulun avulla. Jos ajanvarauksen kohteena on kliininen tapahtuma, ajanvarausta voi edeltää tilaus tai se voi olla osa isompaa tilattavaa palvelua. Molemmissa tapauksissa tilauksen pitäisi edeltää ajanvarauspyyntöä ja vastaavasti ajanvarauspyynnön pitäisi edeltää varsinaista ajanvarausta. Kun palvelu alkaa, on ajanvaraus valmis Ajanvaraus tilakoodien mappaus HL7v3 Act Status koodeihin RIM mallin Act.status_cd tilakoodit tulkitaan alla olevien taulukoiden mukaan. Varsinaisessa viestissä käytetään RIM Status Coden mukaisia arvoja. Ajanvarauksen Status Codet ovat mukana lähinnä siksi, että ajanvarauksessa on käytäntöjä, jotka poikkeavat selvästi muista sovellusalueista. Taulukko 1. Ajanvarauksen Appointment ja HL7v3 yleisten status koodien vastaavuus. Appointment Status Code Complete Delete Discontinue Cancelled Booked To Be Rescheduled No Show RIM Status Code Complete Nullify Abort Abort Active Hold Complete Taulukko 2. Ajanvarauksen Slot ja HL7v3 yleisten status koodien vastaavuus. Slot Status Code Available Booked Blocked Reserved SAV lisäys Cancelled RIM Status Code Active Complete Held Suspended SAV lisäys Aborted HL7v2:ssa (HL7 2003) on olemassa vielä kaksi muutakin tilakoodia: Pending ja Waitlist. Näitä vastaavat HL7v3 viestit eivät vielä ole mukana tässä ballot versiossa mutta ne tullaan liittämään myöhemmin mukaan. HL7v2:n Pending tilakoodin vastine HL7v3:ssa on Appointment Request tilakoodi Active. HL7v2:n Waitlist tilakoodin vastine HL7v3:ssa on Appointment Request tilakoodi Suspend. SAVissa tarvittavat puuttuvat tilakoodit HL7v3 January 2006 ballot paketissa ei ole määritelty ajanvarauksen Slot kohtaista ajanvarauksen perumispyyntöä. Perumispyynnön yhteyteen on määritelty SAVissa Slot Status Code cancelled, sillä peruminen voi johtaa myös tilanteeseen, jossa varattu aika ei välttämättä muutu suoraan vapaaksi. Cancelled Slot Status Codea vastaava RIM Status Code on Aborted. SerAPI projekti 11

12 2.2 Mitä kattaa (scope) HL7v3 ajanvarausviestien kehitys on tapahtunut vaiheittain. January 2006 HL7v3 ballot paketin Scheduling versio tukee kahta skenaariota: 1. yksinkertainen skenaario, jossa ajanvarausjärjestelmä lähettää perusilmoituksia ulkopuoliselle kiinnostuneelle taholle 2. skenaario, jossa järjestelmät ovat ajanvarauksen osalta niin tiukasti toisiinsa kytkettyjä, että ne voivat näin synkronoida slotien (yksilöityjen aikavälien) tietoja. Ensimmäisen julkaisun tavoitteena oli perustaa standardi minimitason toiminnallisuutta varten. Tämä minimitason toiminnallisuus piti sisällään ilmoitukset uusista ajanvarauksista, ajanvarauksen muutoksista, perutuista ajanvarauksista ja siirretyistä ajoista. (Huom. tämä on edelleen HL7v3 Edition 2006:n Scheduling osan normatiivinen sisältö, eli normatiivinen HL7v3 ajanvaraus kattaa vain ilmoituksia, muita osia kyseisessä Editiossa ei ole!) Toinen julkaisu tuki suoraan Slotiin kohdistuvia ajanvarauspyyntöjä, ilmoituksia Slotin tilan muutoksista ja pyyntöjä Slotin tilan muutoksiin, ajanvarauksen perumispyynnön sekä ajanvarausilmoituksen siitä, että potilas ei saapunut paikalle. Myöhemmät julkaisut pohjautuvat näihin interaktioihin ja tulevat sisältämään mm. resurssikohtaisia ajanvarauspyyntöjä, ajanvarauspyyntöjä ilman resurssia sekä kyselyitä. Näitä interaktioita ei siis ole vielä olemassa HL7v3 January 2006 ballot paketissa. Uusia interaktioita ja skenaarioita otettavaksi mukaan ballotiin voi esittää tekniselle komitealle. SAVissa tarvittavat toiminnallisuudet Suomeen määriteltävässä alueellisessa ajanvarauksessa tarvitaan heti myös seuraavat toiminnallisuudet: ajanvarauskyselyt perumispyyntö siirtämispyyntö muokkaamispyyntö ajanvarauksen tiedot sisältävä ilmoitus ajanvarauksen tilasta (ilmoitus vapaan ajan muuttumisesta ei vapaaksi ja varatun ajan muuttuminen vapaaksi). 2.3 Edellytykset, oletukset, käytännöt Edellytykset Ajanvarausviestit voivat yksilöidä yksittäisiä resursseja, jotka liittyvät ajanvaraukseen. Edellytyksenä tällaisten viestien lähettämiseen on, että palveluista, sijainneista, laitteista, henkilöstöstä jne. on olemassa synkronoidut listat. Näitä resurssit voidaan yksilöidä tunnisteella (id), nimellä tai tyypillä. SAVissa 12 SerAPI projekti

13 SAVissa tehtyjen rajausten ja vaatimusten perusteella alueellisen ajanvarauspalvelun näkökulmasta varattavat resurssit ovat palvelutuotteita. Ks. Ajanvarausrajapinnat tekniikkariippumaton liittymämäärittely dokumentti luku 6 (Tuomainen, ym. 2006b) Oletukset Ajanvarausviestit ovat geneerisiä ja niitä voidaan käyttää minkä tahansa aktiviteetin varaamiseen. Perusoletus ajanvarausviestien taustalla on, että näitä viestejä voidaan muuttaa tarpeiden mukaan. Tämän vuoksi Appointment luokan class codea eikä Act.codea ole rajoitettu (constrained). Oletus on, että ne määritellään toteutuksen tai ajon aikana riippuen siitä, minkä tyyppistä aktiviteettia ollaan varaamassa Käytännöt Ajanvaraussovellusalueessa on muutamia käytäntöjä, jotka poikkeavat muista sovellusalueista. Koska ajanvaraus on aktiivinen ennen varsinaista palvelun toteutumista, joidenkin tilojen (state) ja siirtymien (transition) nimet ovat harhaanjohtavia ajanvarauskontekstissa. Tämä vuoksi ajanvaraus noudattaa käytäntöä, jossa käytetään termiä "New" termin "Active" sijasta osoittamaan, että uusi ajanvaraus on varattu. Samalla tavoin ajanvaraus käyttää termiä "Cancel" termin "Abort" sijasta osoittamaan, että ajanvaraus ei ole enää varattuna. Nimeämiskäytäntöjen lisäksi ajanvarauksen ajan siirtäminen on yleinen ja erityistapaus ajanvarauksen muokkaamisessa. Tästä syystä ajan siirtämiselle on omat liipaisintapahtumat ja interaktiot erillisinä ajanvarauksen muokkaamisesta (Huom. tässä ballot paketissa on interaktio ja triggeri vain ilmoittamiselle ajan siirtämisestä, ei pyynnölle). Ajanvarauskäytännöissä on huomioitava myös ajan ilmaiseminen. Ajanvarauksen ajat ilmoitetaan käyttämällä ajan muotoa effective time, sillä resurssi voidaan tarvita joko ennen varsinaista ajanvarauksen aikaa tai vasta sen jälkeen. Muiden sovellusalueiden viesteissä käytetään ajan muotoa activity time. Ajanvarauksessa käytettävä effective time on oletusarvo ja usein sillä tarkoitetaan potilaan aikaa. SerAPI projekti 13

14 2.4 Ajanvaraus sovellusalueen tietomalli (DMIM) Kuva 2. Scheduling sovellusalueen DMIM malli (HL7 2006). HUOM. kuvan 2 DMIM ei ole normatiivisen HL7v editioinin DMIM, vaan löytyy HL7v January ballot paketista. Normatiivisesta DMIM mallista puuttuvat resourceslot ja Resourceluokat. Ajanvaraussovellusalueen DMIM tietomalli keskittyy ActAppointment luokan ympärille. Tämä luokka esittää aktiviteettia, jolle on varattu aika. Sen moodcode on APT (appointment), jolla ilmaistaan, että kyseessä on ajanvaraus. Luokan classcode on ACT, jolla ilmaistaan, että voi liittyä mihin tahansa Actiin. Tämä on siis geneerinen ajanvaraus ja sitä voidaan käyttää minkä tahansa Actin aliluokkana (esim. Encounter, Procedure, Observation). Ajanvaraus voi olla myös joukko (battery), jossa useita palveluita varataan ryhmänä. Tämä toteutetaan ActAppointment luokan rekursiivisella act relationship suhteella (component). Ajanvarauksen geneerinen malli esittää ajanvarauspalveluun liittyvät muuttujat. Toisin sanoen, jos jossakin toisessa sovellusalueessa halutaan toteuttaa ajanvarauspalvelua, kuvaa tämä abstrakti tie 14 SerAPI projekti

15 tomalli ne tiedot, joita tarvitaan ajanvarausoperaatioiden suorittamiseen. Toisessa sovellusalueessa tähän malliin voidaan liittää sovellusaluekohtaista tietoa. Tämä voidaan toteuttaa jatkokehittämällä jotakin ajanvaraussovellusalueen RMIM mallia ja julkaisemalla nuo muutokset/lisäykset toisessa sovellusalueessa. ActAppointment luokka kuvaa varattua ajanvarausta. Ajanvaraus on voitu pyytää aiemmin tilaajasovelluksen toimesta ajanvarauspyynnöllä (ActAppointmentRequest luokka). Lisäksi varatusta ajanvarauksesta voidaan viitata myös alkuperäiseen tilaukseen. ActOrder luokan ja ActAppointmentRequest luokan erona on, että tilauksessa (order) tekijänä/vastuussa on terveydenhuollon ammattilainen, joka kantaa siitä ammatillisen "vastuun", kun taas pyynnössä lähinnä vain varataan resursseja. Kaikki ajanvaraukset eivät välttämättä edellytä tilausta, esim. jos kyseessä on potilaan itsensä tekemä varauspyyntö. Tämä viittausten ketju on lähinnä tunnistamisen helpottamiseksi, eikä ajanvaraukseen tarvitse välttämättä liittää pyyntöä tai tilausta. Potilas luokka subject (tyyppiä participation) liittyy ajanvaraukseen joko suoraan tai epäsuorasti. Lukumääräsuhde (kardinaaliteetti) on yhden suhde moneen 1..*, jolloin ryhmäajanvaraukset ovat mahdollisia, lisäksi subject luokan modecode sallii sellaisten ajanvarausten esittämisen, joissa potilas ei ole fyysisesti mukana. Luokan time muuttuja mahdollistaa potilaan ajanvarauksen alkamisajan ja keston esittämisen koko ajanvarauksen alun ja keston sisällä. Sekä subject luokka että performer luokka (ajanvaraukseen liittyvä henkilöresurssi) sisältävät moodcode arvon, jolla voidaan ilmaista fyysinen tai ei fyysinen ajanvarauksessa mukanaolo. Luokat performer, location ja resusabledevice (tyyppiä participation) viittaavat resursseihin, joita on varattu tähän ajanvaraukseen. Ajanvaraustaulut kontrolloivat tyypillisesti näitä resursseja. Jokaisella resurssilla voi olla oma aika tai sitten niillä on oletusarvona koko ajanvarauksen aika. Näiden luokkien performind muuttujalla on tyyppinä boolean osoittamassa, onko näiden luokkien liittymistä (participation) ajanvaraukseen kontrolloimassa ajanvaraustaulu ja tällöin ne pitää varata ennen käyttöä. Luokat, joilla ei ole asetettu tätä muuttujaa, eivät ole aktiivisesti varattuja, eli ovat tällöin vain tiedoksi. Myös ajanvarauksen tarvittaviin tuotteisiin / tavaroihin / kulutustavaroihin (consumables) voidaan viitata SupplyOrder luokalla. SupplyOrder luokkaa mahdollistaa eri tuotteiden ja niiden tarvittavien määrien liittämisen ajanvaraukseen. Tuotteen määritellään joko nimen, tunnisteen (id) tai valmistajan avulla. Luokalla author (tyyppiä participation) ilmaistaan henkilö, joka on luonut ajanvarauksen ja jonka täytyy vahvistaa muutokset tai korvaamiset. Luokka author on vapaaehtoinen. Jos sitä käytetään, pitää sen olla ajanvarauksen muutoksissa sama kuin ajanvarauspyynnön ControlActWrapper:issa (kontrolliskehys, ks. Open CDA 2006) ollut author. Kaikissa muissa interaktioissa Control Act Wrapperin author voi olla eri kuin ajanvarauksen author. SAVissa ei ole erikseen määritelty, että authorilla ilmaistavan henkilön on oltava ajanvarauksen muutoksissa ja korvaamisissa sama kuin ajanvarauspyynnössäkin, vaan tilanne on päinvastainen. Muidenkin kuin vain ajanvarauspyynnön suorittajan on saatava perua, siirtää ja muokata ajanvarausta. Schedule luokka on joukko sloteja, jotka liittyvät puolestaan resurssiin ja joiden avulla voidaan nimetä ajanvaraustaulu ( taulut), jota ajanvaraus käyttää. Schedule luokkaa voidaan käyttää myös tietyn aikablokin jakamiseksi edelleen sloteihin. SAVissa Schedule luokan avulla ilmaistaan palvelutuote. ResourceSlot luokka liittyy Appointment luokkaan act relationshipilla. Aikaväli (slot) liittyy niihin tiettyihin resursseihin, joiden status mahdollistaa niiden varaamisen. Annetun aikavälin koko voi olla joko vakio tai muuttuva. Ajanvaraus käyttää yhtä tai useampaa peräkkäistä aikaväliä ja nämä aikavälit voidaan tunnistaa itsenään sen sijaan, että ne tunnistettaisiin tiettyjen resurssien aikavä SerAPI projekti 15

16 leiksi. Aikavälejä voidaan myös kysellä ennen varsinaista ajanvarauspyyntöä. Yleensä vain tiukasti yhteen ajanvarauksen osalta kytketyt järjestelmät voivat synkronoida slot kohtaisia tietoja. ResourceSlot luokkaan liitetyt participation luokat ovat tunnistettuja resursseja (Resource luokka). SA Vissa ResourceSlot luokalla ilmaistaan palvelutuotteen alkamis ja loppumisaika. Resource luokan choice box sallii neljän tyyppisiä resursseja: ResurceGroup (resurssiryhmä), Person (henkilö), Manufactured Material (tuotteet, valmisteet) ja Place (paikka). Nämä resurssit liitetään kullekin kuuluvaan aikaväliin (slot) IndentifiedEntity roolilla ja directtargetparticipationilla. Resurssi voi olla mikä tahansa henkilö, paikka, asia tai ihmisten, paikkojen ja laiteiden yhdistelmä. SAVissa Resource luokan avulla voidaan ilmaista palvelutuotteeseen liittyviä attribuutteja, jos niitä ei ole kiinnitetty jo palvelutuotteeseen (lähinnä henkilö ja paikka). Scheduling DMIM tietomalliin tarvittavat lisäykset SAVissa Alla on listattu DMIM tietomallin olemassa oleviin luokkiin tehdyt lisäykset ja itse määritellyt uudet luokat tietosisältöineen sekä uudet hyödynnettävät CMETit. Näitä ei ole mukana kuvassa 3 esitetyssä DMIM mallissa. ActAppointment luokkaan liittyvän author participationin laajennus. Ajanvaraussovellusalueessa author participationissa vain suorittajan tiedot ja R_AssignedPerson universal CMET näitä tietoja varten. SAVissa tarvitaan tieto myös rekisterinpitäjästä ja tilaavasta palveluyksiköstä. Näitä varten on otettu käyttöön uusi CMET R_AssignedOrganization identified, jonka avulla on mahdollista tunnistaa rekisterinpitäjä/tilaava palveluyksikkö. Nämä tiedot on lisätty kyseiseen author participationiin authorchoice rakenteella eli author voi saada arvokseen joko suorittajan ja/tai rekisterinpitäjän ja/tai tilaavan palveluyksikön tiedot. ActOrder luokkaan lisätty code elementti, jossa määritellään lähetteen tyyppi. Schedule luokkaan lisätty title ja text elementit. Title elementissä voidaan ilmaista palvelutuotteen nimi. Text elementissä voidaan palauttaa ajanvarauspyynnön vastauksessa potilasohje tai linkki potilasohjeeseen. Määritelty ActAppointment luokkaan (käytännössä käytetään ActAppointmentRequest luokan yhteydessä ajanvarauspyynnössä ja ActAppointment luokan yhteydessä muokkaamispyynnössä) liittyvä oma participation rakenne remindercontact, jossa käytetään CMETiä R_AssignedPerson universal. remindercontext participationin avulla voidaan ilmaista ajanvarauspyynnön yhteydessä muistutuspyynnön kohde sekä muistutuspyyntöön liittyviä attribuutteja. Määritelty ActAppointment luokkaan (käytännössä käytetään ActAppointmentRequest luokan yhteydessä) liittyvä oma Act luokka FinancialContract, jolla ilmaistaan maksusitoumus ja maksusitoumuksen tietoja. FinancialContract luokka on liitetty ActAppointment luokkaan act Relationshipillä referencedfinancialcontract. Määritelty ActAppointment luokkaan (käytännössä käytetään ActAppointmentRequest luokan yhteydessä) liittyvä oma Act luokka Episode, jolla ilmaistaan ajanvarauksen liittyminen johonkin tiettyyn kokonaisuuteen (palvelukokonaisuus, hoitokokonaisuus, hoitojakso). Episodeluokka on liitetty ActAppointment luokkaan actrelationshipillä referencedepisode. 16 SerAPI projekti

17 Määritelty ActAppointment luokkaan liittyvä oma participation rakenne responsibleparty, jossa käytetään CMETiä R_AssignedOrganization contact. responsibleparty participationin avulla voidaan ilmaista ajanvarauspyynnön vastauksen yhteydessä toimittajan yhteystiedot. Lisätty ActAppointent luokkaan attribuutti independentind. Attribuutti ilmaiseen saako palautettua ajanvarausta perua, siirtää tai muokata vai ei. Tätä tietoa tarvitaan varattujen aikojen kyselyn vastauksessa. Tämä ei kuitenkaan ole riittävä ratkaisu sillä perumiselle, siirtämiselle ja muokkaamiselle on voitava antaa jokaiselle luvat erikseen. Eli on esim. tilanteita, joissa voidaan antaa lupa siirtää aikaa mutta peruminen on kielletty. Tätä ominaisuutta ei ole vielä määritelty tässä dokumentin versiossa. Tämä vaatinee oman rakenteen (act luokan), joka määritellään seuraaviin versioihin. Tässä teknisen liittymämäärittelyn versiossa voidaan siis antaa ainoastaan yleinen lupa, joka koskee sekä perumista, siirtämistä että muokkaamista. lisätty uudet SAVissa käytettävät CMETit o R_AssignedOrganization identified (COCT_MT090201UV01) o R_AssignedOrganization contact (COCT_HD090203UV01) o Nämä on kuvattu tarkemmin luvussa 6 Domainissa käytetyt yleiset viestielementit (CMET). 2.5 Appointment / Slot topic Ajanvaraussovellusalue on jaettu Appointment ja Slot topiceihin. Nämä ovat eräänlaisia ajanvaraussovellusalueen alisovellusalueita. Jako eri topiceihin perustuu siihen, mihin ajanvarausinteraktio kohdistuu: onko kyseessä Appointment kohtainen interaktio vai kohdistuuko interaktio tiettyyn Slotiin. Jos sovellukset ovat ajanvaraustietojen osalta tiukasti toisiinsa kytkettyjä, ne voivat synkronoida ajanvaraustauluja Slot kohtaisesti. Slot kohtaisia tietoja ylläpidetään eri järjestelmissä lähes reaaliaikaisesti ja niitä synkronoidaan tiheästi. Ajanvarauspyynnöt kohdistuvat Sloteihin (aikaväleihin) ja vastausten on oltava oikea aikaisia. Löyhemmin toisiinsa kytketyt järjestelmät käsittelevät ajanvaraustietoja Appointment kohtaisesti. Tällöin resursseihin viitataan niiden nimellä, tunnisteella (id) tai tyypillä ilman viittausta tiettyyn Slotiin. Slot kohtaiset tiedot ovat tällöin toisen järjestelmän sisäistä rakennetta, eivätkä ole näin viestinnän kohteena. Ajanvarausinteraktiot olettavat, että on olemassa sovellus, joka toimii ajanvaraustaulun omistajana tai hallintaohjelmana. Tämän sovelluksen on tiedettävä ajanvarauksien (Appointment) sen hetkinen tilanne tai resurssien aikavälien (Slot) saatavuus. Ilmoitusviesteissä sovelluksella on tällöin sovellusroolina joko Appointment Informer, jos ilmoitukset ovat Appointment kohtaisia, tai Slot Informer, jos ilmoitukset ovat Slot kohtaisia. Ajanvarauspyyntö ja kyselyinteraktioissa ajanvaraustaulunomistaja tai hallintaohjelma toimii Request Confirmer (pyynnön hyväksyjä/hylkääjä) tai Query Responder (kyselyyn vastaaja) sovellusroolissa. Ilmoitusviestien sovellusrooleissa toimivat sovellukset ovat usein samoja sovelluksia kuin sovellukset, jotka toimivat pyyntöjen hyväksyjinä/hylkääjinä tai kyselyihin vastaajina. Appointment/Slot topicit SAV määrittelyissä SAVissa kaikki viestit ja toiminnot ovat määritelty siten, että ne kuuluvat Slot topicin alle. SerAPI projekti 17

18 3 Appointment topic Tähän kappaleeseen on kasattu HL7v3 January 2006 ballot paketista löytyvät Appointment topicin artefaktit. SAVissa ei hyödynnetä Appointment topicin artefakteja, joten Appointment topicia ei ole lokalisoitu kuin suuntaa antavasti. 3.1 Käyttötapauskuvaukset (Storyboards) HL7 standardissa varsinaiseen ongelmaan pureudutaan käyttötapauskuvauksissa (storyboard) kuvattujen käyttötapauksien (use case) kautta. Käyttötapauksien pohjalta on määritelty käyttötapauksen integraatiotarpeiden toteuttamiseksi tarvittavat interaktiot (Open CDA 2006) Ajanvarausilmoitukset, Appointment Notification (PRSC_ST000002) Tämä storyboard kuvaa tilanteita, joissa ajanvarausjärjestelmä (Appointment Informer) ilmoittaa ulkopuolisille kiinnostuneille tahoille (Appointment Trackers) tehdyistä ajanvarauksista, ilman Slot kohtaista tietoa. Ajanvarausjärjestelmä on sovellus, joka ylläpitää resurssien ajanvaraustauluja (schedule) ja hoitaa ajanvarausprosesseja. HL7v3 Storyboardeissa on mukana yleensä jo varsinaisen käytettävän interaktionkin nimi, nämä on listattu ennen varsinaisia storyboard kuvauksia. Lista interaktioista Ilmoitus uudesta ajanvarauksesta: New Appointment Notification (PRSC_IN010101) Ilmoitus ajanvarauksen muokkaamisesta: Revise Appointment Notification (PRSC_IN ) Ilmoitus ajanvarauksen perumisesta: Cancel Appointment Notification (PRSC_IN020101) Ilmoitus ajanvarauksen ajan siirtämisestä: Reschedule Appointment Notification (PRSC_IN020201) Ilmoitus, ettei potilas saapunut paikalle: Appointment Noshow Notification (PRSC_IN010501) Seuraavatkin on listattu ballot paketissa ajanvarausilmoituksiin kuuluviksi vaikkeivät sinne oikeastaan kuuluisi. Ajanvarauksen perumispyyntö: Appointment Cancellation Request (PRSC_IN010601) Ajanvarauksen perumispyynnön hyväksyvä vastaus: Appointment Cancellation Confirmation (PRSC_IN010602) Ajanvarauksen perumispyynnön hylkäävä vastaus: Appointment Cancellation Rejection (PRSC_IN010603) Listassa on interaktion nimi ja virallinen nimi on sulkeissa, ks. Open CDA 2006 HL7 Finlandin suositus V3 viestien käyttöönottoon dokumentista luku 4.5 Artefaktien nimeäminen (Open CDA 2006). Ajanvarausilmoitusten käyttötapaukset Näitä ei ole kuvattu tähän dokumenttiin, sillä näitä ei hyödynnetä SAV määrittelyissä. Patient Makes Outpatient Appointment (PRSC_SN010101) 18 SerAPI projekti

19 Tässä käyttötapauksessa käytetään interaktiota New Appointment Notification. Physician Cancels Inpatient Stay for Patient (PRSC_SN010005) Tässä käyttötapauksessa hyödynnetään interaktiota Cancel Appoinment Notification. Patient Reschedules Outpatient Appointment (PRSC_SN010003) Tässä käyttötapauksessa käytetään interaktiota Reshedule Appoinment Notification. Patient Revises Outpatient Appointment (PRSC_SN010004) Tässä käyttötapauksessa käytetään interaktiota Revise Appointment Notification. Physician Arranges For An Inpatient Stay (PRSC_SN010002) Samansuuntainen käyttötapaus kuin ensimmäinen, käytetään New Appointment Notification interaktiota eri kontekstissa. Edellä kuvatut käyttötapaukset ovat siis tarkoitettu lähinnä ajanvarausilmoituksille ulkopuoliselle kiinnostuneelle taholle. Seuraaville Appointment topicista löytyville interaktioille ei ole ballot paketissa käyttötapauskuvauksia: Appointment Noshow Notification Appointment Cancellation Request Appointment Cancellation Confirmation Appointment Cancellation Rejection 3.2 Sovellusroolit (Application roles) Ballot paketista löytyvät seuraavat Appointment topicin sovellusroolit: Appointment Requester (PRSC_AR010200): Tässä roolissa sovellus tekee ajanvaraussovellukselle pyynnön ajanvarauksen suorittamisesta tai muokkaamisesta. SAVissa tässä roolissa alueellinen ajanvaraus tekee varsinaiselle ajanvarausjärjestelmälle pyynnön perua koko olemassa olevan ajanvarauksen. Appointment Confirmer (PRSC_AR010300): Tässä roolissa ajanvaraussovellus ilmoittaa kutsuvalle sovellukselle, että pyyntö on vahvistettu tai hylätty. SAVissa tässä roolissa varsinainen ajanvarausjärjestelmä ilmoittaa sitä kutsuneelle alueelliselle ajanvaraukselle, että perumispyyntö on vahvistettu tai hylätty Appointment Informer (PRSC_AR010100UV01): Tässä roolissa sovellus ilmoittaa ulkopuoliselle kiinnostuneelle taholle (Tracker) ajanvarauksen suorittamisesta tai muokkaamisesta. SerAPI projekti 19

20 Appointment Tracker (PRSC_AR020000UV01): Tässä roolissa sovellus on ainoastaan ajanvaraustietojen vastaanottaja. Toisin sanoen sovellus ei luo viestejä, mutta vastaanottaa ilmoituksia. Seuraavat Appointment topicin sovellusroolit on mainittu ballotissa ja ne ovat tulossa mukaan ballot paketteihin tulevaisuudessa. Näille on nimetty alustavasti alla olevat sovellusroolit, muttei annettu virallista nimeä: Appointment Inquirer: Rooli yleisten ajanvaraustietojen kyselyä varten. Appointment Query Responder: Rooli edellisen kyselyn vastaajalle. 3.3 Käynnistävät liipaisintapahtumat (Trigger Events) Interaktioon liittyy aina sen käynnistävä liipaisintapahtuma. Yksi liipaisintapahtuma voi käynnistää yhden tai useamman interaktion (Open CDA 2006). Seuraavassa on listattuna ballot paketista löytyvät Appointment topicin liipaisintapahtumat. New Appointment Notification (PRSC_TE010100) Tilamuutokseen perustuva Käynnistää interaktion New Appointment Notification (PRSC_IN010101) Uusi ajanvaraus on tehty ja kaikki tarvittavat resurssit on varattu. Tämä liipaisin vastaa V2:n S12 liipaisinta Notification of New Appointment Booking. Appointment Cancel Notification (PRSC_TE020100) Tilamuutokseen perustuva Käynnistää interaktion Cancel Appointment Notification (PRSC_IN020101) Potilas tai palveluntarjoaja on peruuttanut olemassa olevan ajanvarauksen. Tämä liipaisin vastaa V2:n S15 liipaisinta Notification of Appointment Cancellation. Appointment Cancellation Request (PRSC_TE020400) Käyttäjän toimintaan perustuva Käynnistää interaktion Appointment Cancellation Request (PRSC_IN010601) Potilas tai palveluntarjoaja haluaa peruuttaa aikaisemmin tehdyn ajanvarauksen. Appointment Cancellation Confirmation (PRSC_TE020500) Interaktioon Appointment Cancellation Request (PRSC_IN010601) perustuva Käynnistää interaktion Appointment Cancellation Confirmation (PRSC_IN010602) Ajanvarauksen perumispyyntö on vastaanotettu ja vahvistettu. Appointment Cancellation Rejection (PRSC_TE020600) Interaktioon Appointment Cancellation Request (PRSC_IN010601) perustuva Käynnistää interaktion Appointment Cancellation Rejection (PRSC_IN010603) Ajanvarauksen perumispyyntö on vastaanotettu, mutta peruutusta ei voitu suorittaa. 20 SerAPI projekti

21 Appointment Reschedule Notification (PRSC_TE020200) Tilamuutokseen perustuva Käynnistää interaktion Reschedule Appointment Notification (PRSC_IN020201) Potilas tai palveluntarjoaja on muuttanut olemassa olevan ajanvarauksen aikaa. Tämä liipaisin vastaa V2:n S13 liipaisinta Notification of Appointment Rescheduling. Appointment Revise Notification (PRSC_TE010200) Tilamuutokseen perustuva Käynnistää interaktion Revise Appointment Notification (PRSC_IN010201) Potilas tai palveluntarjoaja on muuttanut olemassa olevaa ajanvarausta. Tämä liipaisin vastaa V2:n S14 liipaisinta Notification of Appointment Modification. Appointment No Show (PRSC_TE020300) Tilamuutokseen perustuva Käynnistää interaktion Appointment Noshow Notification (PRSC_IN010501) Potilas ei saapunut varattuun tapaamiseen. 3.4 RMIM kuvaukset Interaktion sanomamalli on kuvattu graafisesti RMIM mallissa (refined message information model). Appointment topicissa on kaksi RMIM mallia: Appointment RMIM Full (PRSC_RM010000) Minimum Appointment RMIM (PRSC_RM020000) Appointment RMIM Full (PRSC_RM010000) Appointment RMIM Full periytyy Scheduling DMIM mallista (ks. kappale 2.4). SerAPI projekti 21

22 Kuva 3. Appointment RMIM Full (HL7 2006). Appointment RMIM Full on täydellinen Appointment malli, mutta ilman aikavälejä (slots, siis ilman ResourceSlot luokkaa). Se sisältää kaikki attribuutit ja assosiaatiot, jotka on määritelty uutta ajanvarausta tehdessä. Samoin olemassa olevaa ajanvarausta muokattaessa kaikkia kenttiä voidaan muuttaa. Siksi sama RMIM tuottaa sekä New Appointment että Revise Appointment HMD:t. Tätä RMIMiä käytetään myös ajanvarauksen ajan muuttamiseen, mutta silloin ainoat sallitut kentät ovat aika attribuutteja ActAppointmentissa sekä yksittäisiä resurssiosia (individual resource participations). Appointment RMIM Full mallista muodostetut HMD:t New Appointment (PRSC_HD010100) Käytetään ballotissa ainoastaan interaktiossa New Appointment Notification (PRSC_IN010101) Revise Appointment (PRSC_HD010200) Käytetään ballotissa ainoastaan interaktiossa Revise Appointment Notification (PRSC_IN010201) Reschedule Appointment (PRSC_HD020200) Tässä kohdin on virhe Scheduling sovellusalueessa January 2006 ballot paketissa. Tämä sanomankuvaus ei kuulu tänne, sillä pohjautuu Minimum Appointment RMIM malliin. Tätä sanomankuvausta ei ole September 2006 ballot paketissa enää tässä kohdin, vaan se on siirretty oikeaan paikkaan Appointment Minimum RMIMin alle. Samalla käytettävä RMIM on siis vaihtunut ja näin myös tietosisältö on typistynyt. 22 SerAPI projekti

23 3.4.2 Appointment Minimum RMIM (PRSC_RM020000) Appointment Minimum RMIM periytyy Scheduling DMIM mallista (ks. kappale 2.4). Kuva 4. Appointment Minimum RMIM (HL7 2006). Appointment Minimum RMIMiä käytetään luotaessa erittäin yksinkertaisia tilamuutosviestejä, joissa tarvitaan ainoastaan tunnistetta (id) ja tilaa (status). Tällä hetkellä tätä RMIMiä käyttäviä yksinkertaisia viestejä ovat perumispyynnöt, vahvistukset ja ilmoitukset sekä noshow ilmoitukset. Control Act wrapper sisältää syyhuomautuksen (Control Act Wrapperin reasoncode elementti ja koodisto SchedulingActReason), jota käytetään tila tai aikamuutoksen syyn lähettämiseen. Appointment Minimum RMIM mallista muodostetut HMD:t Cancel Appointment (PRSC_HD020100UV01) Käytetään interaktioissa Appointment Cancellation Confirmation (PRSC_IN010602) Appointment Cancellation Rejection (PRSC_IN010603) Appointment Cancellation Request (PRSC_IN010601) Cancel Appointment Notification (PRSC_IN020101) Reschedule Appointment (PRSC_HD020200) Tämä lisätty tänne September 2006 ballotissa. Käytetään ballotissa ainoastaan interaktiossa Reschedule Appointment Notification (PRSC_IN020201) Appointment NoShow (PRSC_HD020300) Käytetään ballotissa ainoastaan interaktiossa Appointment Noshow Notification (PRSC_IN010501) SerAPI projekti 23

24 3.5 Hierarkkiset sanomankuvaukset (HMD:t) RMIM malli serialisoidaan siirtoa varten hierarkkiseksi sanomakuvaukseksi HMD (hierarchical message description). Hierarkkinen sanomakuvaus ei sisällä vielä mitään siirtotekniikkaan liittyvää. Hierarkkisesta sanomankuvauksesta muodostetaan varsinaiset interaktioissa käytettävät sanomat (Message Type List) Tässä kappaleessa on listattuna nimeltä kaikki ballot paketista löytyvät Appointment topicin hierarkkiset sanomankuvaukset (ilman varsinaisia sanomankuvausten tietoja) New Appointment (PRSC_HD010100) Tämä HMD sisältää kaikki attribuutit uuden ajanvarauksen tekemiseen, mukaan lukien varattava keskeinen toiminto (act), potilas, henkilökunta, sijainnit, laitteet ja varusteet. Ballot paketissa tätä sanomankuvausta käytetään uudesta ajanvarauksesta ilmoittamiseen. Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Appointment Intent New Notification (PRSC_MT010101), (New Appointment) Revise Appointment (PRSC_HD010200) Tämä HMD on lähes sama kuin New Appointment HMD, paitsi ajanvarauksen tunniste (appointment id) on pakollinen. Se sisältää kaikki ajanvarauksen muokkausilmoituksen (modified appointment notification) sisältämät attribuutit. Ballot paketissa tätä sanomankuvausta käytetään ajanvarauksen muokkaamisesta ilmoittamiseen. Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Appointment Intent Revise Full (PRSC_MT010201), (Revise Appointment) Cancel Appointment (PRSC_ HD020100UV01) Tämä HMD sisältää ajanvarauksen peruutusilmoituksen, pyynnön, vahvistuksen tai hylkäyksen sisältämät attribuutit. Ainoat tarvittavat attribuutit ovat tunniste (id) ja tila (status). Aika on saatavilla verifiointiin. Ballot paketissa tätä sanomankuvausta käytetään ajanvarauksen peruuttamisen ilmoittamiseen, peruuttamispyyntöön ja sen vahvistamiseen tai hylkäämiseen. Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Appointment Intent Abort (PRSC_MT020101UV01), (Cancel Appointment) Reschedule Appointment (PRSC_HD020200) Tämä HMD sisältää attribuutit ajanvarauksen ajan muuttamiseen. Ne ovat ajanvarauksen tunniste (Appointment id) ja aika. September 2006 ballot paketissa on edelleen virheellisesti tämän tekstin yhteydessä, että myös seuraavat tiedot ilmaistaan: kaikkien ajanvarauksen osien (participation) ajat. Näitä ei ole enää uudessa sanomankuvauksessa mukana. Ballot paketissa tätä sanomankuvausta käytetään ajanvarauksen ajan siirtämisestä ilmoittamiseen. 24 SerAPI projekti

25 Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Appointment Intent Revise Notification (PRSC_MT020201), (Reschedule Appointment) Appointment NoShow (PRSC_HD020300) Tämä HMD sisältää attribuutit, jotka sisältyvät valmiiseen (completed) ajanvaraukseen, kun potilas ei saavu paikalle. Tämä sisältää tunnisteen (id) ja tilan (status). Ilmaistaessa, että tämä on noshow, syykoodiksi Control actissa asetetaan NoShow. Ballot paketissa tätä sanomankuvausta käytetään ilmoitukseen, ettei potilas saapunut paikalle. Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Appointment Intent Complete NoShow (PRSC_MT020300) 3.6 Interaktiot Interaktioon liittyy aina sen käynnistävä liipaisintapahtuma (trigger event). Interaktion yhteydessä on määritelty myös lähettäjän ja vastaanottajan roolit (application roles). Sovellusalueen yleismallin (DMIM) tutkimisen, yleiskuvauksen ja käyttötapauskuvauksien tutkimisen jälkeen seuraavaksi kannattaa tutkia interaktioiden luetteloa (Open CDA 2006). HL7 standardissa kunkin interaktion kohdalla on määritelty seuraavat seikat: liipaisintapahtuma (trigger event) siirtokehys (transmission wrapper) kontrollikehys (control act wapper) sanomatyyppi (message type) lähettäjän ja vastaanottajan roolit. Sanomatyyppi on muodostettu hierarkkisen sanomankuvauksen perusteella. Triggerit, viestien hierarkkiset sanomankuvaukset ja RMIM mallit sekä sovellusroolit on käyty läpi aiemmin tämän luvun kappaleissa Ajanvaraussovellusalueessa käytettävien siirtokehyksien ja kontrollikehyksien sanomankuvaukset ovat liitteissä 1, 2 ja 3. Näiden merkitys ja sisältö on selvitetty yleisellä tasolla Open CDA 2006 HL7 V3 Messaging implementointi dokumentissa (Open CDA 2006) New Appointment Notification (PRSC_IN010101) Ilmoitus ajanvaraussovellukselta, joka sisältää uuden ajanvarauksen yksityiskohtaiset tiedot. Trigger Event New Appointment Notification PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type New Appointment Notification PRSC_MT Sending and Receiving Roles Sender Appointment Informer PRSC_AR010100UV01 SerAPI projekti 25

26 Receiver Appointment Tracker PRSC_AR020000UV Revise Appointment Notification (PRSC_IN010201) Ilmoitus ajanvaraussovellukselta muokatun ajanvarauksen uusista tiedoista. Trigger Event Appointment Revise Notification PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Revise Appointment Notification PRSC_MT Sending and Receiving Roles Sender Appointment Informer PRSC_AR010100UV01 Receiver Appointment Tracker PRSC_AR020000UV Reschedule Appointment Notification (PRSC_IN020201) Ilmoitus ajanvaraussovellukselta ajanvarauksen tai sen resurssien ajan muuttamisesta. Trigger Event Appointment Reschedule Notification PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Reschedule Appointment Notification PRSC_MT Sending and Receiving Roles Sender Appointment Informer PRSC_AR010100UV01 Receiver Appointment Tracker PRSC_AR020000UV Cancel Appointment Notification (PRSC_IN020101) Ilmoitus ajanvaraussovellukselta, joka sisältää perutun ajanvarauksen tiedot. Trigger Event Appointment Cancel Notification PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment PRSC_MT020101UV01 Sending and Receiving Roles Sender Appointment Informer PRSC_AR010100UV01 Receiver Appointment Tracker PRSC_AR020000UV Appointment Cancellation Request (PRSC_IN010601) Ajanvarauksen perumispyyntö. Trigger Event Appointment Cancellation Request PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment PRSC_MT020101UV01 26 SerAPI projekti

27 Receiver Responsibilities Reason Trigger Event Interaction PRSC_TE PRSC_IN PRSC_TE PRSC_IN Sending and Receiving Roles Sender Appointment Requester PRSC_AR Receiver Appointment Confirmer PRSC_AR Appointment Cancellation Confirmation (PRSC_IN010602) Vastaus ajanvarauksen perumispyyntöön, kun pyyntö hyväksytään. Trigger Event Appointment Cancellation Confirmation PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment PRSC_MT020101UV01 Sending and Receiving Roles Sender Appointment Confirmer PRSC_AR Receiver Appointment Requester PRSC_AR Appointment Cancellation Rejection (PRSC_IN010603) Vastaus ajanvarauksen perumispyyntöön, kun pyyntöä ei hyväksytä. Trigger Event Appointment Cancellation Rejection PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment PRSC_MT020101UV01 Sending and Receiving Roles Sender Appointment Confirmer PRSC_AR Receiver Appointment Requester PRSC_AR Appointment Noshow Notification (PRSC_IN010501) Ilmoitus ajanvaraussovellukselta, että potilas ei saapunut varattuun tapaamiseen. Trigger Event Appointment No Show PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Appointment NoShow PRSC_MT Sending and Receiving Roles Sender Appointment Informer PRSC_AR010100UV01 Receiver Appointment Tracker PRSC_AR020000UV01 SerAPI projekti 27

28 4 Slot topic Tässä kappaleessa ovat kaikki HL7v3 January 2006 ballot paketista löytyvät Slot topicin artefaktit. Lisäksi mukana on SAVissa määritellyt toiminnot, jotka sisältyvät kaikki Slot topicin alle ja ovat lisäyksiä HL7v3 Scheduling sovellusalueeseen. 4.1 Käyttötapauskuvaukset (Storyboards) HL7 standardissa varsinaiseen ongelmaan pureudutaan käyttötapauskuvauksissa (storyboard) kuvattujen käyttötapauksien (use case) kautta. Käyttötapauksien pohjalta on määritelty käyttötapauksen integraatiotarpeiden toteuttamiseksi tarvittavat interaktiot (Open CDA 2006) Slot kohtainen ajanvarauspyyntö, Slot Booking (PRSC_ST000003) Tämä storyboard kuvaa tilanteita, joissa tiukasti kytketyt järjestelmät tekevät ajanvarauspyyntöjä slot kohtaisesti ja vaihtavat tietoa Sloteista. Keskitetty ajanvaraus varaa aikoja spesialisteille synkronisoimalla ajanvaraustaulunsa spesialistien ajanvaraussovelluksen kanssa ja tekemällä ajanvarauksia yleislääkäreille, jotka pääsevät keskitettyyn ajanvaraukseen omista toimistoistaan. HL7v3 Storyboardeissa on mukana yleensä jo varsinaisen käytettävän interaktionkin nimi, nämä ovat listattu ennen varsinaisia storyboard kuvauksia. Lista interaktioista: New Appointment Slot Request (PRSC_IN030101) New Appointment Slot Confirmation (PRSC_IN030102) New Appointment Slot Rejection (PRSC_IN030103) Slot Status Revise Request (PRSC_IN020301) Slot Status Revise Confirmation (PRSC_IN020302) Slot Status Revise Rejection (PRSC_IN020303) Slot Status Revise Notification (PRSC_IN020400) Listassa on interaktion nimi ja virallinen nimi on sulkeissa, ks. Open CDA 2006 HL7 Finlandin suositus V3 viestien käyttöönottoon dokumentista luku 4.5 Artefaktien nimeäminen (Open CDA 2006). Tiukasti kytkettyjen sovellusten välinen Slotiin kohdistuva ajanvaraus Tightly coupled Slot Booking (PRSC_SN020001) Tässä käyttötapauksessa on hieman erilainen lähestymistapa kuin SAV käyttötapauksissa. Käyttötapaus sisältää kyllä ajanvarauspyyntöinteraktion (New Appointment Slot Request) mutta aikojen selvittäminen tapahtuu interaktiolla Slot Status Revise Request, eli esim. ajanvarauspalvelu pyytää vapaat ajat itselleen ajanvarausjärjestelmältä. SAV vaatimusten mukaan vapaat ajat selvitetään joko kyselyllä tai replikoimalla ilmoituksilla. SAVista puuttuvat käyttötapaukset (storyboards) 28 SerAPI projekti

29 SAVissa tarvitaan uusia Slot kohtaisia interaktioita (kyselyt, siirtämis, perumis ja muokkauspyyntö). Näille ei luonnollisestikaan ole olemassa valmiita käyttötapauskuvauksia. 4.2 Sovellusroolit (Application roles) Ballot paketista löytyvät seuraavat Slot topicin sovellusroolit: Slot Requester (PRSC_AR030200): Tiukasti sidotussa ympäristössä sovellukset jakavat tietämyksen aikaväleistä (slots). Kutsuva sovellus voi pyytää varaamaan uuden ajan (ajanvarausta) pyytämällä varaamaan aikavälejä. Slot Request Confirmer (PRSC_AR030101): Tässä roolissa ajanvaraustaulun omistaja tai välittäjä vastaa pyyntöön varata aika aikavälien perusteella tai muuttaa aikavälien tilaa. Useimmiten Slot Request Confirmer on sama kuin Slot Informer. Slot Informer (PRSC_AR030100): Tässä roolissa ajanvaraustaulun omistaja tai välittäjä lähettää ilmoituksia aikavälien tilamuutoksista. Slot Tracker (PRSC_AR030300): Tässä roolissa sovellus vastaanottaa ilmoituksia aikaväleistä, pääasiassa aikavälien tilasta. Slot Trackerilla on todennäköisesti ajanvaraussovelluksen (Scheduler) aikaväleistä kopio, jonka täytyy pysyä ajan tasalla. Seuraavia sovellusrooleja ei löydy ballot paketista. Nämä on määritelty SAVissa erikseen. SAVissa näitä sovellusrooleja tarvitaan Slot topicin ajanvarauskyselyihin: Slot Inquirer (QUSC_AR040101FI) Tässä sovellusroolissa sovellus tekee kyselyitä vapaista ja varatuista ajoista ajanvaraussovellukselle Slot kohtaisesti. Slot Query Responder (QUSC_AR040102FI) Tässä sovellusroolissa ajanvaraussovellus vastaa kyselyn tehneen sovelluksen vapaiden ja varattujen aikojen kyselyihin. 4.3 Käynnistävät liipaisintapahtumat (Trigger Events) Interaktioon liittyy aina sen käynnistävä liipaisintapahtuma. Yksi liipaisintapahtuma voi käynnistää yhden tai useamman interaktion (Open CDA 2006). Käytännössä ajanvaraussovellusalueessa kaikki liipaisintapahtumat käynnistävät samannimisen interaktion. Näin jo interaktion nimi paljastaa interaktion käyttötarkoituksen. Liipaisintapahtumien ilmaisemista vielä erikseen on tarpeetonta. Lisäksi liipaisintapahtuman ilmoittaminen interaktion kontrollikehyksessä ei ole pakollinen tieto. Seuraavassa on kuitenkin listattuna ballot paketista löytyvät Slot topicin liipaisintapahtumat. Liipaisintapahtuminen yhteyteen on erikseen mainittu, jos sitä on mahdollista hyödyntää SAVissa. New Appointment Request by Slot (PRSC_TE030100) Käyttäjän toimintaan perustuva Käynnistää interaktion New Appointment Slot Request (PRSC_IN030101) Sovellus haluaa varata ajan määrittelemällä ajanvaraussovelluksen käyttämät tietyt aikavälit. SerAPI projekti 29

30 Hyödynnetään SAVissa uuden ajanvarauksen varauspyyntöön. New Appointment Request by Slot Confirmation (PRSC_TE030200) Interaktioon New Appointment Slot Request (PRSC_IN030101) perustuva Käynnistää interaktion New Appointment Slot Confirmation (PRSC_IN030102) Ajanvaraussovellus on saanut pyynnön varata ajan määrittämällä yksilölliset aikavälit ja ajanvaraussovellus hyväksyy ajanvarauksen. Hyödynnetään SAVissa uuden ajanvarauksen varauspyynnön hyväksyvässä vastauksessa. New Appointment Request by Slot Rejection (PRSC_TE030300) Interaktioon New Appointment Slot Request (PRSC_IN030101) perustuva Käynnistää interaktion New Appointment Slot Rejection (PRSC_IN030103) Ajanvaraussovellus on saanut pyynnön varata ajan määrittämällä yksilölliset aikavälit, mutta ajanvaraussovellus hylkää ajanvarauspyynnön. Hyödynnetään SAVissa uuden ajanvarauksen varauspyynnön hylkäävässä vastauksessa. Slot Revision Notification (PRSC_TE040100) Tilamuutokseen perustuva Käynnistää interaktion Slot Status Revise Notification (PRSC_IN020400) Tunnistettuihin aikaväleihin (slots) on ilmennyt muutoksia. SAVissa Slot Status Revise Notification interaktiota käytetään vapaiden aikojen replikointiin. lisäksi tätä interaktiota (ja siten myös triggeriä) voidaan käyttää ilmoitukseen vapaan ajan muuttumisesta ei vapaaksi ja ilmoitukseen varatun ajan muuttumisesta vapaaksi, jos mukana ei tarvitse välittää ajanvarauksen tietoja. Jos kahden ilmoituksen mukana tarvitsee välittää myös ajanvarauksen tiedot, on tälle tilanteelle määritelty oma interaktio ja oma triggeri (ks. alempana Appointment Status Revision Notification by Slot (PRSC_TE40500FI01) Slot Revision Request (PRSC_TE040200) Käyttäjän toimintaan perustuva Käynnistää interaktion Slot Status Revise Request (PRSC_IN020301) Sovellus haluaa muuttaa aikavälien tilaa ajanvaraussovelluksessa. Yleensä tämä on pyyntö ennalta varata aikavälit tulevaa ajan varaamista varten. Em. Tightly coupled Slot Booking (PRSC_SN020001) käyttötapauksessa ajanvarauspalvelu pyysi vapaita aikoja varattavaksi itselleen, tämä tarkoitettu lähinnä siihen tilanteeseen. SAVissa ei käytetä SAVissa. Ajanvarauksen muokkaamista varten on määriteltävä uudet artefaktit (sanomankuvaus, triggeri, interaktio), sillä tämän triggerin laukaiseman interaktion sanomankuvaus ei sisällä ajanvarauksen tietoja, joita SAVissa tarvitaan. Tällaista tilannetta varten on määritelty uusi triggeri (Appointment Revision Request by Slot), uudet interaktiot (Appointment Revise Request by Slot/ Appointment Revise Confirmation by Slot/ Appointment Revise Rejection by Slot) sekä uusi sanomankuvaus (Revise Appointment by Slot). Slot Revision Confirmation (PRSC_TE040300) 30 SerAPI projekti

31 Interaktioon Slot Status Revise Request (PRSC_IN020301) perustuva Käynnistää interaktion Slot Status Revise Confirmation (PRSC_IN020302) Ajanvaraussovellus on saanut pyynnön muuttaa aikavälien tilaa tietyn aika alueen (range) sisällä. Jos jotakin aikaväleistä on muutettu, ajanvaraussovelluksen täytyy antaa vastauksena kaikkien tunnistettujen (identified) aikavälien tilat. Ei käytetä SAVissa. Slot Revision Rejection (PRSC_TE040400) Interaktioon Slot Status Revise Request (PRSC_IN020301) perustuva Käynnistää interaktion Slot Status Revise Rejection (PRSC_IN020303) Ajanvaraussovellus on saanut pyynnön muuttaa aikavälin tilaa tietyn aika alueen (range) sisällä, mutta ajanvaraussovellus ei voi tehdä pyydettyjä muutoksia. Ei käytetä SAVissa. SAVissa määriteltävät puuttuvat Slot topicin liipaisintapahtumat Edellä listattujen liipaisintapahtumien lisäksi on määritelty omia SAV vaatimuksiin vastaavia Slotkohtaisia liipaisintapahtumia, jotka puuttuvat HL7v3 Scheduling sovellusalueesta: Appointment Cancellation Request by Slot (PRSC_TE050100FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Appointment Cancel Request by Slot (PRSC_IN040201FI01). Sovellus haluaa tehdä Slot kohtaisen ajan perumispyynnön ajanvaraussovellukselle. Appointment Cancellation Confirmation by Slot (PRSC_TE050200FI01) Interaktioon Appointment Cancel Request by Slot (PRSC_IN040201FI01) perustuva. Käynnistää interaktion Appointment Cancel Confirmation by Slot (PRSC_IN040202FI01) Ajanvaraussovellus on saanut ajanvarauksen (tai tietyn ajanvarauksen osan) perumispyynnön ajanvaraussovellus ilmoittaa hyväksyvänsä perumispyynnön. Appointment Cancellation Rejection by Slot (PRSC_TE50300FI01) Interaktioon Appointment Cancel Request by Slot (PRSC_IN040201FI01) perustuva. Käynnistään interaktion Appointment Cancellation Rejection by Slot (PRSC_IN040203FI01). Ajanvaraussovellus on saanut ajanvarauksen (tai tietyn ajanvarauksen osan) perumispyynnön mutta ajanvaraussovellus hylkää siirtämispyynnön. Appointment Reschedule Request by Slot (PRSC_TE050400FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Appointment Reschedule Request by Slot (PRSC_IN040301FI01). Sovellus haluaa tehdä Slot kohtaisen ajan siirtämispyynnön ajanvaraussovellukselle. Appointment Reschedule Confirmation by Slot (PRSC_TE050500FI01) Interaktioon Appointment Reschedule Request by Slot (PRSC_IN040301FI01) perustuva. Käynnistää interaktion Appointment Reschedule Confirmation by Slot (PRSC_IN040302FI01) Ajanvaraussovellus on saanut pyynnön siirtää ajanvarausta tai tiettyä osaa ajanvarauksesta (palvelutuote) ja ajanvaraussovellus ilmoittaa hyväksyvänsä siirtämispyynnön. SerAPI projekti 31

32 Appointment Reschedule Rejection by Slot (PRSC_TE50600FI01) Interaktioon Appointment Reschedule Request by Slot (PRSC_IN040301FI01) perustuva. Käynnistään interaktion Appointment Reschedule Rejection by Slot (PRSC_IN040303FI01). Ajanvaraussovellus on saanut pyynnön siirtää ajanvarausta tai tiettyä osaa ajanvarauksesta mutta ajanvaraussovellus hylkää siirtämispyynnön. Appointment Revision Request by Slot (PRSC_TE050700FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Appointment Revise Request by Slot (PRSC_IN040401FI01). Sovellus haluaa tehdä Slot kohtaisen ajan muokkaamispyynnön ajanvaraussovellukselle. Appointment Revision Confirmation by Slot (PRSC_TE050800FI01) Interaktioon Appointment Revise Request by Slot (PRSC_IN040401FI01) perustuva. Käynnistää interaktion Appointment Revise Confirmation by Slot (PRSC_IN040402FI01) Ajanvaraussovellus on saanut pyynnön muokata ajanvarauksen tietoja ajanvaraussovellus ilmoittaa hyväksyvänsä muokkaamispyynnön. Appointment Revision Rejection by Slot (PRSC_TE50900FI01) Interaktioon Appointment Revise Request by Slot (PRSC_IN040401FI01) perustuva. Käynnistään interaktion Appointment Revise Rejection by Slot (PRSC_IN040403FI01). Ajanvaraussovellus on saanut pyynnön muokata ajanvarauksen tietoja mutta ajanvaraussovellus hylkää muokkaamispyynnön. Appointment Status Revision Notification by Slot (PRSC_TE40500FI01) Tilamuutokseen perustuva. Käynnistään interaktion Appointment Status Revise Notification by Slot (PRSC_IN040404FI01). Ajanvaraussovellus ilmoittaa sovellukselle, että vapaa aika on muuttunut ei vapaaksi tai että varattu aika on muuttunut vapaaksi, mukana kulkee myös tieto ilmoitukseen liittyvästä ajanvarauksesta. Ilman ajanvarauksen tietoja tapahtuvaa ilmoitukseen on käytettävä triggeriä Slot Revision Notification (PRSC_TE040100). Query Available Slots by Resource (QUSC_TE040101FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Query Available Slots by Resource (QUSC_IN040101FI01) Sovellus kyselee ajanvaraussovellukselta vapaita aikoja. Response Available Slots by Resource (QUSC_TE040102FI01) Interaktioon Query Available Slots by Resource (QUSC_TE040101FI01) perustuva. Käynnistää interaktion Response Available Slots by Resource (QUSC_IN040102FI01) Ajanvaraussovellus vastaa vapaiden aikojen kyselyyn. Query Appointments by Slot (QUSC_TE040103FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Query Appointments by Slot (QUSC_IN040103FI01) Sovellus kyselee ajanvaraussovellukselta varattuja aikoja. Response Appointments by Slot (QUSC_TE040104FI01) Interaktioon Query Appointments by Slots (QUSC_TE040104FI01) perustuva. 32 SerAPI projekti

33 Käynnistää interaktion Response Appointments by Slot (QUSC_IN040104FI01) Ajanvaraussovellus vastaa varattujen aikojen kyselyyn. Request Continuation/Cancellation (QUSC_TE040105FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Request Continuation/Cancellation (QUSC_IN040105FI01) Sovellus kyselee ajanvaraukselta lisävastauksia tilanteessa, jossa vain tietty osa vastauksista palautettu varsinaisen kyselyn vastauksessa. Tällä interaktiolla voidaan tarvittaessa myös perua tehty kysely. 4.4 RMIM kuvaukset Interaktion sanomamalli on kuvattu graafisesti RMIM mallissa (refined message information model). Slot topicissa on kolme RMIM mallia: Slot Request RMIM (PRSC_RM050000) Slot RMIM Full (PRSC_RM030000) Slot RMIM Minimum (PRSC_RM040000) Slot Request RMIM (PRSC_RM050000FI01) Slot Request RMIM periytyy Scheduling DMIM mallista (ks. kappale 2.4). Kuva 5. Slot Request RMIM (HL7 2006). SerAPI projekti 33

34 Tämä RMIM tietomalli on sisällöltään lähes samanlainen kuin seuraava Slot RMIM Full tietomalli. Erona on se, että keskeinen luokka on AppointmentRequest Appointment luokan sijaan. Tietomalli sisältää pyydetyn keskeisen toiminnon (act), ajanvaraustaulun tunnisteen (Schedule id), kunkin aikavälin tunnisteen (ResourceSlot.id), varusteet (supply items) ja potilaan. Lisäksi voidaan identifioida resurssit, joita aikavälit (slot) kontrolloivat. Slot Request RMIM mallista muodostetut sanomankuvaukset (HMD): Appointment Request by Slot (PRSC_HD050100FI01), käytetään interaktioissa New Appointment Slot Request (PRSC_IN030101FI01) ja New Appointment Slot Rejection (PRSC_IN030103FI01) (ajanvarauspyynnön hylkäys) sanomankuvausta käytetään SAVissa ballotia vastaavalla tavalla, eli uuden ajanvarauksen varauspyynnön vastauksessa (New Appointment Slot Request (PRSC_IN030101FI01)) ja uuden ajanvarauksen varauspyynnön hylkäävässä vastauksessa (tarvittaessa, jos halutaan palauttaa hylkäävässä vastauksessa myös alkuperäinen kysely) (New Appointment Slot Rejection (PRSC_IN030103FI01)). SAVissa vaadittavat lisäykset Slot Request RMIM malliin SAVissa vaadittavia lisäyksiä ei ole mukana kuvassa 6. Lisäykset ja muutokset, jotka kohdistuvat tähän RMIM malliin, ovat listattuna DMIM tietomallin yhteydessä ja nämä on eritelty Slot Request RMIM mallista johdetuissa sanomankuvauksissa Slot RMIM Full (PRSC_RM030000FI01) Slot RMIM Full periytyy Scheduling DMIM mallista, ks. kappale SerAPI projekti

35 Kuva 6. Slot RMIM Full (HL7 2006). Slot RMIM Full sisältää kaikki aikavälien (slots) ja ajanvarauksien (appointments) väliset assosiaatiot. Tätä mallia käytetään sellaisten uusien ajanvarauksien vahvistamiseen, perumis, siirtämis ja muokkauspyyntöihin, jotka ovat yksilöity slot kohtaisesti. Se periytyy Scheduling DMIMistä, mutta se ei sisällä suoraan ActAppointment luokkaan liitettävien resurssiluokkien (participation tyyppisten) yksityiskohtia eikä kaikkia resursseja (participation tyyppisiä). Slot RMIM Full mallista muodostetut sanomankuvaukset (HMD): New Appointment by Slot (PRSC_HD030200FI01) Käytetään interaktiossa New Appointment Slot Confirmation (PRSC_IN030102FI01) sanomankuvausta hyödynnetään SAVissa ballotia vastaavalla tavalla, eli uuden ajanvarauspyynnön hyväksyvässä vastauksessa (Appointment Slot Confirmation (PRSC_IN030102FI01)) lisäksi tätä sanomankuvausta hyödynnetään SAVissa suoraan varattujen aikojen kyselyn vastausinteraktiossa Response Appointments by Slot (QUSC_IN040104FI), kun kyselyn vastauksessa palautetaan varattuja aikoja, ks. kappale Response Appointments by Slot, QUSC_IN040104FI01 SAV lisäys: HMD ajan perumiseen, Cancel Appointment by Slot (PRSC_HD030300FI01), käytetään interaktioissa ajan perumispyyntö, Appointment Cancel Request by Slot PRSC_IN040201FI01 perumispyynnön hyväksyvä vastaus, Appointment Cancel Confirmation by Slot PRSC_IN040202FI01 SerAPI projekti 35

36 perumispyynnön hylkäävä vastaus, Appointment Cancel Rejection by Slot PRSC_IN040203FI01 SAV lisäys: HMD ajan siirtämiseen, Reschedule Appointment by Slot (PRSC_HD030400FI01), käytetään interaktioissa ajan siirtämispyyntö, Appointment Reschedule Request by Slot PRSC_IN040301FI01 siirtämispyynnön hyväksyvä vastaus, Appointment Reschedule Confirmation by Slot PRSC_IN040302FI01 siirtämispyynnön hylkäävä vastaus, Appointment Reschedule Rejection by Slot PRSC_IN040303FI01 SAV lisäys: HMD ajanvarauksen muokkaamiseen, Revise Appointment by Slot (PRSC_HD030500FI01), käytetään interaktioissa ajanvarauksen muokkaamispyyntö, Appointment Revise Request by Slot PRSC_IN040401FI01 muokkaamispyynnön hyväksyvä vastaus, Appointment Revise Confirmation by Slot PRSC_IN040402FI01 muokkaamispyynnön hylkäävä vastaus, Appointment Revise Rejection by Slot PRSC_IN040403FI01 ilmoitukseen vapaan ajan muuttumisesta ei vapaaksi sekä ilmoitukseen varatun ajan muuttumisesta vapaaksi, jos ilmoituksessa tarve kuljettaa myös ajanvarauksen tietoja, Appointment Status Revise Notification by Slot (PRSC_IN40404FI01) SAVissa vaadittavat lisäykset Full Slot RMIM malliin SAVissa vaadittavia lisäyksiä ei ole mukana kuvassa 7. Lisäykset ja muutokset, jotka kohdistuvat tähän RMIM malliin, ovat listattuna DMIM tietomallin yhteydessä ja nämä on eritelty Slot Request RMIM mallista johdetuissa sanomankuvauksissa Slot RMIM Minimum (PRSC_RM040000FI01) Slot RMIM Minimum periytyy Scheduling DMIM mallista, ks. kappale SerAPI projekti

37 Kuva 7. Slot RMIM Minimum (HL7 2006). Slot RMIM Minimumia käytetään viesteissä, joilla ilmaistaan aikavälien yksinkertaisia tilatietoja. Slot RMIM Minimum mallista muodostetut sanomankuvaukset (HMD): Slot Status Revision (PRSC_HD040100) Käytetään interaktioissa Slot Status Revise Notification (PRSC_IN020400) Slot Status Revise Request (PRSC_IN020301) Slot Status Revise Confirmation (PRSC_IN020302) Slot Status Revise Rejection (PRSC_IN020303) sanomankuvausta hyödynnetään SAVissa ilmoitukseen vapaista ajoista ilmoitukseen vapaan ajan muuttumisesta ei vapaaksi, jos ilmoituksessa ei tarvitse välittää ajanvarauksen tietoja ilmoitukseen varatun ajan muuttumisesta vapaaksi, jos ilmoituksessa ei tarvitse välittää ajanvarauksen tietoja em. ilmoitukset käyttävät interaktiota Slot Status Revise Notification (PRSC_IN02400) lisäksi tätä sanomankuvausta hyödynnetään SAVissa suoraan vapaiden aikojen kyselen vastausinteraktiossa Response Available Slots by Resource (QUSC_IN040102FI01), kun kyselyn vastauksessa palautetaan vapaita aikoja, ks. kappale Response Available Slots by Resource, QUSC_IN040102FI01 SerAPI projekti 37

38 SAVissa vaadittavat lisäykset Slot Minimum RMIM malliin SAVissa vaadittavia lisäyksiä ei ole mukana kuvassa 7. Lisäykset ja muutokset, jotka kohdistuvat tähän RMIM malliin on listattuna DMIM tietomallin yhteydessä ja nämä on eritelty Slot Request RMIM mallista johdetuissa sanomankuvauksissa. 4.5 Hierarkkiset sanomankuvaukset (HMD:t) RMIM malli serialisoidaan siirtoa varten hierarkkiseksi sanomakuvaukseksi HMD (hierarchical message description). Hierarkkinen sanomakuvaus ei sisällä vielä mitään siirtotekniikkaan liittyvää. Hierarkkisesta sanomankuvauksesta muodostetaan varsinaiset interaktioissa käytettävät sanomat (Message Type List). Sanomankuvauksiin on liitetty alueelliselle ajanvaraukselle/suomalaiselle ajanvaraukselle määritellyt tietosisällöt (SAV tiedot). Nämä SAV tiedot on merkitty sanomankuvausten oikeanpuoleiseen sarakkeeseen lihavoituna ja niihin on liitetty tietojen selitteet. Alkuperäisiin HL7v3 sanomankuvauksiin tehdyt muutokset ja lisäykset on myös korostettu erikseen SAV maininnoilla. Sanomankuvauksissa on mukana runsaasti tietoja, jotka eivät ole pakollisia tai tarpeen alueellisessa ajanvarauksessa, eikä näitä ole lokalisoitu. Ne ovat mukana alkuperäisissä HL7 Scheduling tiedoissa ja niitä voidaan käyttää tarvittaessa. SAV tietosisällöt on mapattu näihin hierarkkisiin sanomankuvauksiin. Tietosisällöt, joita ei mahdollisesti ole ballotissa olevissa sanomankuvauksissa, on lisätty kyseisiin sanomankuvauksiin (lisäykset lueteltu myös DMIM mallin yhteydessä koostetusti (ks. kappale 2.4 Ajanvaraus sovellusalueen tietomalli (DMIM)). Jos tiedoissa käytetään sanastoja (Vocabulary) tai koodistoja, liitetään ne tähän dokumenttiin tai viitataan koodistoon, josta ne ovat saatavilla. Kaikki käytettävä koodistot on listattu myös liitteeseen 4. Sanomankuvausten yhteydessä on viittaus niistä johdettuihin sanomatyyppien (Message Type) XML skeemoihin ja SOAP esimerkkeihin, jotka löytyvät zip paketista HL7v3SchdelulingFIv04.zip. Zip paketti on saatavilla osoitteesta: Appointment Request by Slot (PRSC_HD050100FI01) Tätä sanomakuvausta (HMD) käytetään uuteen Slot kohtaisen ajanvarauspyyntöön ajanvarauspyynnön hylkäävään vastaukseen, jos halutaan palauttaa takaisin pyynnön sisältämät tiedot. Sanomankuvaus sisältää attribuutit Slot kohtaisesti tehtävään ajanvarauspyyntöön, mukaan lukien pyydetty keskeinen toiminto (act), ajanvaraustaulun tunniste (Schedule id), kunkin aikavälin tunniste (ResourceSlot.id), varusteet ja potilas. Lisäksi resurssit, joita aikavälit (slot) kontrolloivat, voidaan myös identifioida. SAVissa tätä sanomankuvausta voidaan käyttää edellä kuvattuihin käyttötarkoituksiin. 38 SerAPI projekti

39 Alla olevaan sanomankuvaukseen on liitetty SAV vaatimuksissa ajanvarauspyynnölle esitetyt tiedot. Uuden ajan ajanvarauspyynnön tietosisältö on määritelty dokumentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymämäärittely, v1" kappaleessa Uuden ajanvarauksen varauspyyntö. Alkuperäiseen HL7v3 sanomankuvaukseen on tehty SAV lisäyksiä ja muutoksia. Näistä on jokaisen kohdalla maininta erikseen. Sanomankuvauksessa on mukana myös tiedot, jotka on määritelty HL7v3 Scheduling sovellusalueessa tähän sanomankuvaukseen ja joita ei ole määritelty SAVissa. Taulukko 3. Appointment Request by Slot Kentän numero HL7v3 elementti Pakollisuus SAV tiedot (lihavoitu taulukkoon) Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Appointment Request by Slot PRSC_HD050100FI01 1 ActAppointmentRequest classcode 1..1 moodcode 1..1 id code text statuscode effectivetime prioritycode 0..* 10 confidentialitycode 0..* HL7v3 tieto, osoittaa että kyseessä on actluokka. Vakioarvo "ACT" HL7v3 tieto, osoittaa että kyseessä on ajanvarauspyyntö. Vakioarvo "ARQ". Tilaajan ajanvaraustunniste Tilaajan ajanvaraukselle antama tunniste. Toimittaja voi tarvittaessa palauttaa tämän tunnisteen ajanvarauspyynnön vastauksessa. SAV tietosisällöissä tämä tieto on vapaaehtoinen > muutettu sanomankuvaukseen (1..1 > 0..1) Huomautus/lisäkenttä Ajanvaraukseen liittyvää vapaata tekstiä. Asiakas (participation) subject 1..* typecode 1..1 patient 1..1 Ajanvaraukseen liittyvä asiakas. SAV tietosisällöissä tämä pakollinen, asiakkaasta annettava aina jokin tunnistetieto > tehty muutos sanomankuvaukseen (0..* > 1..*) HL7v3 tieto, osoittaa että kyseessä on subject participation. Vakioarvo "SBJ". CMET asiakkaan tiedoille R_Patient identified/confirmable, COCT_MT050002UV CMET kuvattu kappaleessa author 0..* Ajanvarauksen suorittaja, rekisterinpitäjä SerAPI projekti 39

40 15 typecode 1..1 authorchoice ja tilaava palveluyksikkö (participation) SAV muutos, tässä sanomankuvauksessa ei ole valmiina rekisterinpitäjän / tilaavan palveluyksikön tietoja vaan ainoastaan suorittajan tiedot. SAVissa lisätään myös organisaatiota kuvaava CMET. HL7v3 tieto, osoittaa että kyseessä on author participation. Vakioarvo "AUT" typtällä rakenteella voidaan ilmaista useita author participation:eita: ajanvarauksen suorittaja, rekisterinpitäjä ja tilaava palveluyksikkö choice types in authorchoice assignedperson 1..1 SAV lisäys, tätä ei ole valmiina tässä sanomankuvauksessa. Ajanvarauksen suorittaja Henkilö, joka on tehnyt ajanvarauksen. Henkilö voi olla Ammattilainen/tilaaja, Ammattilainen/suorittaja, Asiakas, Asiakkaan edustaja. CMET ajanvarauksen suorittajan tiedoille: R_AssignedPerson universal COCT_MT090100UV Tämä on kuvattu kappaleessa 6.2 Rekisterinpitäjä ja/tai tilaava palveluyksikkö CMET organisaation tiedoille: R_AssignedOrganization identified COCT_MT090201UV01 Tämä on kuvattu kappaleessa 6.3 assignedorganization 1..2 Jos tilaavan palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään author participationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganization. Nämä erotetaan assignedorganization roolissa olevalla code elementillä. Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan yksilöidä, kumpi on kyseessä end contents of authorchoice referencedorder typecode SAV lisäys, ei ole valmiina tässä sanomankuvauksessa ActRelationship lähetteeseen, jos tämä viittaus olemassa, on myös lähete olemassa. SAV tietosisällöissä tämä rajattu siten, että lähetteitä voi olla vain yksi per ajanvaraus tai sitten ei lainkaan. Tehty muutos sanomankuvaukseen (0..* > 0..1) HL7v3 tieto, osoittaa että kyseessä on viittaus (actrelationship) ActAppointmentRequest actista Order actiin (tässä 40 SerAPI projekti

41 tapauksessa ActOrder luokkaan. Vakioarvo "OREF" 23 actorder 1..1 Lähete 24 classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä on Act luokka. Vakioarvo "ACT" 25 moodcode 1..1 HL7v3 tieto. Vakioarvo "RQO" Lähetteen OID tunniste. 26 id 0..1 Jos lähetteen tunniste tiedetään, se annetaan. Jos id on tyhjä, on lähete olemassa mutta sen tunnistetta ei tiedetä. SAV tietosisällöissä lähetteen OIDin ilmoittaminen vapaaehtoinen > tehty muutos sanomankuvauksen pakollisuuksiin (1..1 > 0..1) Lähetteen tyyppi Tässä käytetään HL7 koodistoa Lähetteen tyyppi 1997: OID: code 0..1 Koodiston sisältö: Kotihoito Laboratorio Lääketieteellinen Psykiatrinen Radiologia Erikoissairaanhoito HOM LAB MED PSY RAD SKN trigger 0..* 29 typecode supplyorder classcode moodcode consumable 0..* 34 typecode manufacturedproduct classcode id code manufacturedmaterialkind classcode determinercode code quantity name 0..* 45 manufacturerorganization 0..1 SAV lisäys, code elementti ei ole valmiina tässä sanomankuvauksessa. (actrelationship) reference 1..* typecode 1..1 schedule 1..1 Palvelutuotteen tiedot SAV tietosisällöissä pakolliset > muutettu sanomankuvaukseen (0..* > 1..*) HL7v3 tieto, osoittaa että kyseessä on viittaus (actrelationship) ActAppointmentRequest actista toiseen actiin (tässä tapauksessa Schedule luokkaan, joka on Act. Vakioarvo "REFR" Palvelutuotteen "aikataulu", jossa yksilöidään myös palvelutuote. SerAPI projekti 41

42 (act) 49 classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä on Act luokka. Vakioarvo "ACT" 50 moodcode 1..1 HL7v3 tieto. Vakioarvo "SLOT" Palvelutuotteen tunniste. Tunniste, joka yksilöi palvelutuotteen. id code 0..1 Tunniste SAV tietosisällöissä pakollinen > muutettu sanomankuvaukseen (0..1 > 1..1) Jos kansallisesti yhteisesti sovittua koodistoa palvelutuotteille ei olemassa, on ajanvarausjärjestelmän ja ajanvarauspalvelun välillä sovittava erikseen palvelutuotteille käytettävistä koodeista ja koodistoista. SAVissa määritellyissä SOAPviestiesimerkeissä käytetään kuviteltua itse määriteltyä koodistoa. Palvelutuotteen nimi 53 title 0..1 text 0..1 Palvelutuotteen selkokielinen nimi. SAV lisäys, title elementti ei ole valmiina Schedule luokassa tässä sanomankuvauksessa.. Potilasohje tai linkki potilasohjeeseen Ei välitetä ajanvarauspyynnössä, on tässä mukana, koska samaa Schedulerakennetta käytetään muissakin sanomankuvauksissa effectivetime repeatnumber 0..1 SAV lisäys, text elementti ei ole valmiina Schedule luokassa tässä sanomankuvauksessa.. (actrelationship) Palvelutuotteen tiedot SAV tietosisällöissä component 1..* pakolliset > muutettu sanomankuvaukseen (0..* > *) HL7v3 tieto, osoittaa että Schedule actilla typecode 1..1 on komponentti (tässä tapauksessa act RelationShip ResourceSlot actiin). Vakioarvo 58 "COMP". 59 resourceslot 1..1 (act) 60 classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä on Act luokka. Vakioarvo "ACT" 61 moodcode 1..1 HL7v3 tieto. Vakioarvo "SLOT" Varatttavan slotin id id code statuscode 1..1 Jos varattavan slotin id on tiedossa, on tämä annettava ajanvarauspyynnössä. ResourceSlot actin status, pakollinen tieto tässä sanomankuvauksessa, tietoa ei ole määritelty SAV 42 SerAPI projekti

43 tietosisältöihin tekniikkariippumattomassa määrittelyssä. Tässä ilmoitetaan mikä ajanvarauksen tila on. statuscode elementille on olemassa koodisto ActStatus. Ajanvaraussovellusalueen johdannossa nämä tilakoodit on mapattu ajanvarausta paremmin kuvaaviin tilakoodeihin (Slot Status Code, ks. kappale Viesteissä käytetään RIMin mukaisia Act Status koodeja. Ajanvarauspyynnössä tässä actstatusarvona: active (RIM status code) Ajanvarausmappaus available (slot status code) Palvelutuotteen alkamisaika ja loppumisaika, jos resourceslot.id:tä ei annettu, eli aika ilmaistaan ilman sloteja. effectivetime 1..1 Jos resourceslot.id annettu, on tässä ilmoitettu aika yhden yksilöidyn slotin alkamisaika ja loppumisaika effectivetime:sta käytetään arvoja low / high Aika annetaan aina tässä kentässä oli se sitten yksilöity slot id:llä tai ei > muutettu sanomankuvaukseen (0..1 > ) 66 prioritycode 0..* 67 repeatnumber directtarget 0..* (participation) HL7v3 tieto. Direct target = Target that is substantially present in the service and typecode 1..1 which is directly affected by the service 69 action. Vakioarvo "DIR". 70 identifiedentity 1..1 HL7v3 tieto, joka osoittaa että kyseessä 71 classcode 1..1 on tunnistettu entiteetti. Vakioarvo "IDENT" 72 id 0..* 73 identifiedresource 0..1 Resursseilla voidaan ilmaista palvelutuotteeseen liittyviä muuttuvia tietoja 74 choice types in identifiedresource 75 Place.. Paikka 76 classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä on entiteetti paikka. Vakioarvo "PLC" HL7v3 tieto, joka osoittaa että kyseessä 77 determinercode 1..1 identifioitavissa oleva entiteetti. Vakioarvo "INSTANCE" 78 id 0..* 79 code name 0..* 81 ResourceGroup.. 82 classcode determinercode id 0..* SerAPI projekti 43

44 85 code name 0..* 87 Person.. Henkilö classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä determinercode id 0..* 91 name 0..* 92 ManufacturedMaterial.. 93 classcode determinercode id 0..* 96 code name 0..* 98 end contents of identifiedresource on entiteetti henkilö. Vakioarvo "PSN" HL7v3 tieto, joka osoittaa että kyseessä identifioitavissa oleva entiteetti. Vakioarvo "INSTANCE" Muistutuspyyntö (participation) Jos tämä participation olemassa, on myös muistutuspyyntö olemassa remindercontact 0..* typecode 1..1 functioncode 1..1 notetext 0..1 time.0.1 assignedperson 1..1 Tieto on mahdollista esittää toistuvana, jos halutaan esittää eri muistutuspyynnön tapoja. SAV lisäys, remindercontactparticipationia ei ole mukana tässä sanomankuvauksessa.. HL7v3 tieto, joka osoittaa että kyseessä on tiedon vastaanottaja (= Information Recipient) Vakioarvo "IRCP" Muistutuspyynnön tapa Koodisto muistutuspyynnön tavasta. Tässä käytetään HL7 Finland koodistoa HL7 Ajanvarauksesta ilmoittaminen: OID: : Koodiston sisältö: Kirjeitse KIR Puhelimitse PUH Tästä puuttuvat SMS + sähköposti, jotka on lisättävä koodistoon. Huomautusteksti Vapaamuotoista tekstiä liittyen muistutuspyyntöön. Muistutuspyynnön aika Tämä tieto ei ole pakollinen, sillä järjestelmät saattava generoida muistutuspyynnön ajan myös automaattisesti Muistutuspyynnön kohde Muistutuspyynnön kohteen tiedot ilmaistaan CMETillä R_AssignedPerson universal, COCT_MT090100UV01 CMET kuvattu kappaleessa SerAPI projekti

45 CMETistä käytetään attribuuttia Address jos lähetetään postitse, Tel jos käytetään puhelinta, Tel jos käytetään sähköpostia, Tel jos käytetään SMS:ää. TEL:issä ei tarvita formaattimääritystä vaan remindercontact.functioncode sanoo millä tavalla esim. puhelinnumeroa käytetään (SMS vai puhelu). ActRelationship maksusitoumus Actiin Jos tämä actrelationship olemassa, on myös maksusitoumus olemassa. referencedfinancialcontract 0..1 SAV lisäys, referencedfinancialcontractactrelationshipia ja financialcontract actio ei ole mukana tässä sanomankuvauksessa 105 HL7v3 tieto, osoittaa että kyseessä on viittaus (actrelationship) ActAppointmentRequest actista typecode 1..1 toiseen actiin (tässä tapauksessa FinancialContract luokkaan, 106 joka on Act. Vakioarvo "REFR" Maksusitoumus 107 financialcontract 1..1 (act) 108 classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä on Act luokka. Vakioarvo "ACT" 109 moodcode 1..1 HL7v3 tieto. Vakioarvo "EVN" Tunniste 110 id 0..1 Mahdollinen maksusitoumuksen tunniste. 111 code 0..1 Vapaamuotoinen teksti 112 text 0..1 Vapaamuotoista tekstiä liittyen maksusitoumukseen. ActRelationship Actiin, jolla ilmaistaan ajanvarauksen liittyminen tiettyyn kokonaisuuteen referencedepisode 0..*. Tässä tiedossa on mukana toistuvuus, jotta voidaan tarvittaessa ilmaista tunnuksien hierarkia. SAV lisäys, referencedepisodenactrelationshipia ja episode actia ei ole 113 mukana tässä sanomankuvauksessa HL7v3 tieto, osoittaa että kyseessä on viittaus (actrelationship) ActAppointmentRequest actista typecode 1..1 toiseen actiin (tässä tapauksessa Episode luokkaan, joka on 114 Act. Vakioarvo "REFR" Kokonaisuus,johon ajanvaraus liittyy 115 episode 1..1 (act) 116 classcode 1..1 HL7v3 tieto, joka osoittaa että kyseessä on Act luokka. Vakioarvo "ACT" 117 moodcode 1..1 HL7v3 tieto. Vakioarvo "EVN" 118 id 0..1 Kokonaisuuden tunniste, johon ajanvaraus liittyy Ajanvaraukseen liittyvän kokonaisuuden tyyppi 119 code 0..1 Tässä käytetään SAVissa määriteltyä ajanvarausspesifiä koodistoa Ajanvaraukseen liittyvän kokonaisuuden tyyppi: OID: SerAPI projekti 45

46 Koodiston sisältö: Palvelukokonaisuus 1 Hoitokokonaisuus 2 Hoitojakso 3 Koodiston tyyppi CV. Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Slot Intent Create Request (PRSC_MT050101), (eli Appointment Request by Slot) Sanomatyypin (Message Type) XML skeema PRSC_MT050101FI01 löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_MT050101FI01.xsd. Samasta zip paketista löytyy esimerkki sanomatyypin käytöstä uuden ajanvarauksen varauspyyntö interaktio esimerkistä examplexml/prsc_in030101fiexample.xml Appointment Request by Slot sanomankuvauksessa käytetyt CMET:it (Common Message Element Types) R_Patient identified/confirmable (COCT_MT050002UV04), ks. kpl 6.1. R_AssignedPerson universal (COCT_MT090100UV01), ks. kpl 6.2. R_AssignedOrganization identified (COCT_MT090201UV01), ks. kpl 6.3, lisätty käytettäväksi SAVissa. E_OrganizationUniversal (COCT_MT150000UV02), ks. kpl 6.5, ei käytetä SAVissa New Appointment by Slot (PRSC_HD030200FI01) Tätä sanomakuvausta (HMD) käytetään uuden Slot kohtaisen ajanvarauspyynnön hyväksymisvastaukseen. Sanomankuvaus sisältää attribuutit Slot kohtaisesti määriteltyyn ajanvaraukseen, mukaan lukien ajanvaraustaulu, aikavälit, varusteet ja potilas. Lisäksi se voi yksilöidä aikaväleihin liitetyt resurssit. Tämä sanomankuvaus on lähes samanlainen kuin Slot kohtaisessa ajanvarauspyynnössä, mutta keskeinen luokka on AppointmentRequest luokan sijasta Appointment luokka. SAVissa tätä sanomankuvausta käytetään kuvattuun ajanvarauspyynnön hyväksymisvastaukseen. Lisäksi sanomankuvausta käytetään SAVissa: varattujen aikojen kyselyn vastauksessa Alla olevaan sanomankuvaukseen on liitetty SAV vaatimuksissa ajanvarauspyynnön/varattujen aikojen kyselyn vastaukselle esitetyt tiedot. Uuden ajan ajanvarauspyynnön vastauksen tietosisältö on määritelty dokumentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymämäärittely, v1" kappaleessa Uuden ajanvarauksen varauspyyntö ja varattujen aikojen kyselyn vastauksen tietosisältö kappaleessa Varattujen aikojen kysely. Alkuperäiseen HL7v3 sanomankuvaukseen on tehty SAV lisäyksiä ja muutoksia. Näistä on jokaisen kohdalla maininta erikseen. Sanomankuvauksessa on mukana myös tiedot, jotka on määritelty HL7v3 Scheduling sovellusalueessa tähän sanomankuvaukseen ja joita ei ole määritelty SAVissa. Taulukko 4. New Appointment by Slot. 46 SerAPI projekti

47 Kentän numero HL7v3 elementti Pakollisuus SAV tiedot (lihavoitu taulukkoon) + selitteet Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Slot Appt Confirm 1 ActAppointment 0..1 Ajanvaraus 2 classcode 1..1 "ACT" 3 moodcode 1..1 "APT" Toimittajan ajanvaraustunniste id code text statuscode effectivetime prioritycode 0..* 10 confidentialitycode 0..* independentind 0..1 Toimittajan ajanvaraukselle antama varsinainen ajanvarauksen tunniste. Tämä tieto SAV tietosisällöissä vapaaehtoinen > muutettu sanomankuvaukseen (1..1 > 0..1) Tieto siitä, saako ajanvarausta perua, siirtää tai muokata vai ei. Tätä tietoa tarvitaan varattujen aikojen kyselyn vastauksessa, ei uuden ajanvarauksen varauspyynnön vastauksessa Saa arvon true, jos peruminen, siirtäminen 11 tai muokkaaminen sallittua. Asiakas (participation) 12 subject 0..* 13 typecode 1..1 "SBJ" CMET asiakkaan tiedoille patient 1..1 R_Patient identified/confirmable, COCT_MT050002UV CMET kuvattu kappaleessa 6.1. Ajanvarauksen suorittaja, rekisterinpitäjä ja tilaava palveluyksikkö (participation) author 0..* SAV muutos, tässä sanomankuvauksessa ei ole valmiina rekisterinpitäjän / tilaavan palveluyksikön tietoja vaan ainoastaan suorittajan tiedot. SAVissa lisätään myös organisaatiota kuvaava CMET. 15 SAVissa tässä sanomankuvauksessa tarvitaan ainoastaan tilaavan palveluyksikön tietoja. HL7v3 Scheduling sovellusalueessa tässä sanomankuvauksessa myös suorittajan tiedot. Näin tähän on määritelty sama rakenne kuin ajanva SerAPI projekti 47

48 rauspyyntöönkin. 16 typecode 1..1 "AUT" Tällä rakenteella voidaan ilmaista useita author participation:eita: ajanvarauksen suorittaja, rekisterinpitäjä authorchoice ja tilaava palveluyksikkö choice types in authorchoice assignedperson 0..1 SAV lisäys, tätä ei ole valmiina tässä sanomankuvauksessa. Ajanvarauksen suorittaja Henkilö, joka on tehnyt ajanvarauksen. Henkilö voi olla Ammattilainen/tilaaja, Ammattilainen/suorittaja, Asiakas, Asiakkaan edustaja. CMET ajanvarauksen suorittajan tiedoille: R_AssignedPerson universal COCT_MT090100UV Tämä on kuvattu kappaleessa 6.2 Rekisterinpitäjä ja/tai tilaava palveluyksikkö CMET organisaation tiedoille: R_AssignedOrganization identified COCT_MT090201UV01 Tämä on kuvattu kappaleessa 6.3 assignedorganization 0..* Jos tilaavan palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään author participationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganisation. Nämä erotetaan assignedorganisation roolissa olevalla code elementillä end contents of authorchoice 22 referencedorder 0..* 23 typecode actorder classcode moodcode id 1..1 schedulerequest 0..* Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan yksilöidä, kumpi on kyseessä. SAV lisäys, ei ole valmiina tässä sanomankuvauksessa Jos tämä actrelationship on olemassa, voidaan actappointmentrequest luokassa (act) palauttaa Tilaajan ajanvaraustunnus typecode 1..1 "SCH" 30 actappointmentrequest 1..1 Viittaus ajanvarauspyyntöön 31 classcode 1..1 "ACT" 32 moodcode 1..1 "ARQ" 33 id 1..1 Tilaajan ajanvaraustunnus Tilaajan ajanvarauksessa antama ajanva 48 SerAPI projekti

49 34 trigger 0..* 35 typecode supplyorder classcode moodcode consumable 0..* 40 typecode manufacturedproduct classcode id code manufacturedmaterialkind classcode determinercode code quantity name 0..* 51 manufacturerorganization 0..1 raustunnus. Toimittaja voi palauttaa kyseisen tunnuksen tässä elementissä. (actrelationship) reference 1..* Palvelutuotteen tiedot SAV tietosisällöissä pakolliset > 52 muutettu sanomankuvaukseen (0..* > 1..*) 53 typecode 1..1 "REFR" Palvelutuotteen aikataulu, jossa yksilöidään schedule 1..1 myös palvelutuote. 54 (act) 55 classcode 1..1 "ACT" 56 moodcode 1..1 "SLOT" Palvelutuotteen tunniste. Tunniste, joka yksilöi palvelutuotteen. id code 0..1 title Tunniste SAV tietosisällöissä pakollinen > muutettu sanomankuvaukseen (0..1 > 1..1) Jos kansallisesti yhteisesti sovittua koodistoa palvelutuotteille ei olemassa, on ajanvarausjärjestelmän ja ajanvarauspalvelun välillä sovittava erikseen palvelutuotteille käytettävistä koodeista ja koodistoista. SAVissa määritellyissä SOAPviestiesimerkeissä käytetään kuviteltua itse määriteltyä koodistoa. Palvelutuotteen nimi Palvelutuotteen selkokielinen nimi. SAV lisäys schedule luokkaan. Potilasohje tai linkki potilasohjeeseen 60 text 0..1 Tässä elementissä voidaan välittää tekstimuodossa potilasohje tai linkki potilasohjeeseen. SerAPI projekti 49

50 61 effectivetime repeatnumber 0..1 SAV lisäys schedule luokkaan. (actrelationship) component 1..* Jos reference viittaus palvelutuotteeseen on annettu. Palvelutuotteen tiedot SAV tietosisällöissä pakolliset > 63 muutettu sanomankuvaukseen (0..* > 1..*) 64 typecode 1..1 "COMP" 65 resourceslot 1..1 (act) 66 classcode 1..1 "ACT" 67 moodcode 1..1 "SLOT" 68 id 0..1 Slotin id 69 code 0..1 Actin status, pakollinen tieto tässä sanomankuvauksessa, tietoa ei ole määritelty SAVtietosisältöihin. Tässä ilmoitetaan mikä ajanvarauksen tila on. statuscode attribuutille on olemassa koodisto ActStatus. statuscode 1..1 Ajanvaraussovellusalueen johdannossa nämä tilakoodit on mapattu ajanvarausta paremmin kuvaaviin tilakoodeihin (Slot Status Code, ks. kappale Viesteissä käytetään RIMin mukaisia Act Status koodeja. Ajanvarauspyynnön vastauksessa/varattujen aikojen kyselyn vastauksessa tässä actstatus arvona: complete (RIM status code) 70 Ajanvarausmappaus booked (slot status code) Palvelutuotteen alkamisaika ja loppumisaika, jos resourceslot.id:tä ei annettu, eli aika ilmaistaan ilman sloteja. effectivetime 1..1 Jos resourceslot.id annettu, ilmoitetaan tässä yksilöidyn slotin alkamisaika ja loppumisaika effectivetime:sta käytetään arvoja low / high Aika annetaan aina tässä kentässä oli se sitten yksilöity slot id:llä tai ei > muutettu sanomankuvaukseen (0..1 > ) 72 prioritycode 0..* 73 repeatnumber directtarget 0..* (participation) 75 typecode 1..1 "DIR" 76 identifiedentity classcode 1..1 "IDENT" 50 SerAPI projekti

51 78 id 0..* 79 identifiedresource 0..1 Resursseilla voidaan ilmaista palvelutuotteeseen liittyviä muuttuvia tietoja 80 choice types in identifiedresource 81 Place.. Paikka 82 classcode 1..1 "PLC" 83 determinercode 1..1 "INSTANCE" 84 id 0..* 85 code name 0..* 87 ResourceGroup.. 88 classcode determinercode id 0..* 91 code name 0..* 93 Person.. Henkilö 94 classcode 1..1 "PSN" 95 determinercode 1..1 "INSTANCE" 96 id 0..* 97 name 0..* 98 ManufacturedMaterial.. 99 classcode determinercode id 0..* 102 code name 0..* 104 end contents of identifiedresource Toimittajan yhteystieto (participation) responsibleparty 0..1 Jos tämä participation olemassa, on myös toimittajan yhteystieto olemassa. SAV lisäys, responsiblepartyparticipationia ei ole valmiina tässä sanomankuvauksessa typecode 1..1 "RESP" CMET toimittajan tiedoille: assignedorganization 1..1 R_AssignedOrganization contact COCT_HD090203UV CMET kuvattu erikseen kappaleessa 6.4. Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Slot Intent Create Appointment (PRSC_MT030201FI01), (New Appointment by Slot) Sanomatyypin (Message Type) XML skeema PRSC_MT030201FI01 löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_MT030201FI01.xsd. Samasta zip paketista löytyy esimerkki sanomatyypin käytöstä ajanvarauspyynnön vastausinteraktio esimerkistä examplexml/prsc_in030102fiexample.xml. New Appointment by Slot sanomankuvauksessa käytetyt CMET:it (Common Message Element Types) SerAPI projekti 51

52 R_Patient identified/confirmable (COCT_MT050002UV04), ks. kpl 6.1. R_AssignedPerson universal (COCT_MT090100UV01), ks. kpl 6.2. R_AssignedOrganization identified (COCT_MT090201UV01), ks. kpl 6.3, lisätty käytettäväksi SAVissa R_AssignedOrganization contact (COCT_HD090203UV01), ks. kpl 6.4, lisätty käytettäväksi SAVissa E_OrganizationUniversal (COCT_MT150000UV02), ks. kpl 6.5, ei käytetä SAVissa Slot Status Revision (PRSC_HD040100FI01) Tätä sanomankuvausta (HMD) käytetään Slotin tilatiedon muutospyyntöön Slotin tilatiedon muutospyynnön hyväksyvään vastaukseen Slotin tilatiedon muutospyynnön hylkäävään vastauksen, jos halutaan palauttaa takaisin pyynnön sisältämät tiedot. ilmoitukseen Slotin tilamuutoksesta. Sanomankuvaus sisältää attribuutit Slotin tilan muutospyyntöön, muutospyynnön vastaukseen (hyväksyminen/hylkäys) tai ilmoitukseen Slotin tilamuutoksesta. Se sisältää tiedon ajanvaraustaulusta (Schedule), kyseisen ajanvaraustaulun resurssien aikavälit (Slots) sekä valinnaisesti resurssien yksilöintitiedot. Sanomankuvaus ei sisällä ajanvarauksen (Appointment) tietoja lainkaan SAVissa tätä sanomankuvausta käytetään ilmoituksiin vapaista ajoista ilmoitukseen varatun ajan muuttumisesta vapaaksi, jos ilmoituksessa ei tarvitse välittää ajanvarauksen tietoja, ilman ajanvarauksen tietoja siis käytännössä sama kuin ilmoitus vapaista ajoista ilmoitukseen vapaan ajan muuttumisesta ei vapaaksi, jos ilmoituksessa ei tarvitse välittää ajanvarauksen tietoja. ResourceSlot.statusCode on tällöin ilmoituksessa vapaan ajan muuttumisesta ei vapaaksi complete. lisäksi tätä käytetään vapaiden aikojen kyselyn vastaukseen. Jos vapaiden aikojen ilmoituksessa/vapaiden aikojen kyselyn vastauksessa palautuu useita aikoja yhdelle palvelutuotteelle, on ResourceSlot luokka toistuva. Jos ilmoitetaan useita palvelutuotteita/vapaiden aikojen kysely on tehty palvelutuoteluokkakohtaisesti, voi myös Schedule luokka olla toistuva (palautuu useita palvelutuoteluokan mukaisia palvelutuotteita). Alla olevaan sanomankuvaukseen on liitetty SAV vaatimuksissa vapaiden aikojen ilmoitukselle/vapaiden aikojen kyselyn vastaukselle esitetyt tiedot. Uuden ajan ajanvarauspyynnön vastauksen tietosisältö on määritelty dokumentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymämäärittely, v1" kappaleessa Ilmoitus vapaista ajoista ja vapaiden aikojen kyselyn vastauksen tietosisältö kappaleessa Vapaiden aikojen kysely. Alkuperäiseen HL7v3 sanomankuvaukseen on tehty SAV lisäyksiä ja muutoksia. Näistä on jokaisen kohdalla maininta erikseen. Sanomankuvauksessa on mukana myös tiedot, jotka on määritelty HL7v3 Scheduling sovellusalueessa tähän sanomankuvaukseen ja joita ei ole määritelty SAVissa. Taulukko 5. Slot Status Revision. Kentän numero HL7v3 elementti Pakollisuus SAV tiedot (lihavoitu taulukkoon) Taulukossa olevat classcode, moodcode, 52 SerAPI projekti

53 typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Slot Status Revision, PRSC_HD040100FI01 schedule 1..1 Palvelutuotteen aikataulu, jossa yksilöidään myös palvelutuote. 1 (act) 2 classcode 1..1 "ACT" 3 moodcode 1..1 "SLOT" Palvelutuotteen tunniste. Tunniste, joka yksilöi palvelutuotteen. id code title 0..1 text effectivetime repeatnumber 0..1 Tämä tieto SAV tietosisällöissä pakollinen > muutettu sanomankuvaukseen (0..1 > 1..1) Jos kansallisesti yhteisesti sovittua koodistoa palvelutuotteille ei olemassa, on ajanvarausjärjestelmän ja ajanvarauspalvelun välillä sovittava erikseen palvelutuotteille käytettävistä koodeista ja koodistoista. SAVissa määritellyissä SOAPviestiesimerkeissä käytetään kuviteltua itse määriteltyä koodistoa. Palvelutuotteen nimi Palvelutuotteen selkokielinen nimi. SAV lisäys schedule luokkaan. Potilasohje tai linkki potilasohjeeseen Tässä elementissä voidaan palauttaa tekstimuodossa potilasohje tai linkki potilasohjeeseen. SAV lisäys schedule luokkaan. (actrelationship) Palvelutuotteen tiedot SAV tietosisällöissä component 1..* pakolliset > muutettu sanomankuvaukseen (0..* > *) 11 typecode 1..1 "COMP" 12 resourceslot 1..1 (act) 13 classcode 1..1 "ACT" 14 moodcode 1..1 "SLOT" 15 id 0..1 Slotin id 16 code 0..1 statuscode 1..1 Actin status, pakollinen tieto tässä sanomankuvauksessa, tietoa ei ole määritelty SAVtietosisältöihin. 17 Tässä ilmoitetaan mikä ajanvarauksen tila on. statuscode attribuutille on olemassa SerAPI projekti 53

54 koodisto ActStatus. Ajanvaraussovellusalueen johdannossa nämä tilakoodit on mapattu ajanvarausta paremmin kuvaaviin tilakoodeihin (Slot Status Code, ks. kappale Viesteissä käytetään RIMin mukaisia Act Status koodeja. Ilmoituksessa vapaista ajoista/vapaiden aikojen kyselyn vastauksessa tässä act Status arvona: active (RIM status code) Ajanvarausmappaus: available (slot status code) Ilmoitus vapaan ajan muuttumisessa eivapaaksi, on tässä actstatus arvona: complete (RIM status code) Ajanvarausmappaus booked (slot status code) Ilmoituksessa varatun ajan muuttumisesta vapaaksi tässä actstatus arvona: active (RIM status code) Ajanvarausmappaus available (slot status code) Palvelutuotteen alkamisaika ja loppumisaika, jos resourceslot.id:tä ei annettu, eli aika ilmaistaan ilman sloteja. effectivetime 1..1 Jos resourceslot.id annettu, ilmoitetaan tässä yksilöidyn slotin alkamisaika ja loppumisaika effectivetime:sta käytetään arvoja low / high Aika annetaan aina tässä kentässä oli se sitten yksilöity slot id:llä tai ei > muutettu sanomankuvaukseen (0..1 > ) 19 prioritycode 0..* 20 repeatnumber directtarget 0..* (participation) 22 typecode 1..1 "DIR" 23 identifiedentity classcode 1..1 "IDENT" 25 id 0..* 26 identifiedresource 0..1 Resursseilla voidaan ilmaista palvelutuotteeseen liittyviä muuttuvia tietoja 27 choice types in identifiedresource 28 Place.. Paikka 29 classcode 1..1 "PLC" 30 determinercode 1..1 "INSTANCE" 31 id 0..* 32 code name 0..* 34 ResourceGroup.. 54 SerAPI projekti

55 35 classcode determinercode id 0..* 38 code name 0..* 40 Person.. Henkilö 41 classcode 1..1 "PSN" 42 determinercode 1..1 "INSTANCE" 43 id 0..* 44 name 0..* 45 ManufacturedMaterial.. 46 classcode determinercode id 0..* 49 code name 0..* 51 end contents of identifiedresource Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Slot Intent Revise (PRSC_MT040101FI01), (Slot Status Revision) Sanomatyypin (Message Type) XML skeema PRSC_MT040101FI01 löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_MT040101FI01.xsd. Samasta zip paketista löytyy esimerkki sanomatyypin käytöstä vapaiden aikojen kyselyn vastausinteraktio esimerkistä examplexml/qusc_in040102fiexample.xml Cancel Appointment by Slot (PRSC_HD030300FI01) Tämä sanomankuvaus määritelty SAVissa, tätä ei löydy HL7v3 Scheduling sovellusalueesta. SAVissa tätä sanomankuvausta käytetään Slot kohtaiseen ajanvarauksen perumispyyntöön Slot kohtaisen perumispyynnön hyväksyvään vastaukseen Slot kohtaiseen perumispyynnön hylkäävään vastaukseen, jos halutaan palauttaa takaisin pyynnön sisältämät tiedot. Tällä sanomankuvauksella on mahdollista perua yksittäisiä palvelutuotteita ajanvarauskokonaisuudesta, jonka toimittajan ajanvaraustunnus yksilöi. Cancel Appointment by Slot sanomankuvaus pohjautuu samaan Full Slot RMIM tietomalliin kuin ajanvarauspyynnön vastaus (New Appointment by Slot). Tälle voitaisiin määritellä myös oma tiiviimpi RMIM malli ja siitä muodostettava tiiviimpi sanomankuvaus. Alla olevaan sanomankuvaukseen on liitetty SAV vaatimuksissa ajanvarauksen perumispyynnölle esitetyt tiedot. Ajanvarauksen perumispyynnön ja vastauksen tietosisältö on määritelty dokumentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymämäärittely, v1" kappaleessa Ajanvarauksen perumispyyntö. Taulukko 6. Cancel Appointment by Slot. SerAPI projekti 55

56 Kentän numero HL7v3 elementti Pakollisuus SAV tiedot (lihavoitu taulukkoon) + selitteet Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Cancel Appointment by Slot, (PRSC_HD030300FI01) 1 ActAppointment 0..1 Ajanvaraus 2 classcode 1..1 "ACT" 3 moodcode 1..1 "APT" Toimittajan ajanvaraustunniste id 1..1 Toimittajan ajanvaraukselle antama tunniste. 4 5 code text statuscode effectivetime prioritycode 0..* 10 confidentialitycode 0..* Asiakas (participation) 11 subject 0..* 12 typecode 1..1 "SBJ" CMET asiakkaan tiedoille patient 1..1 R_Patient identified/confirmable, COCT_MT050002UV CMET kuvattu erikseen kappaleessa 6.1. Perumisen suorittaja, rekisterinpitäjä ja tilaava palveluyksikkö (participation) author 0..* SAV muutos, ajanvaraussovellusalueessa ja RMIM mallissa Full Slot RMIM ei ole valmiina rekisterinpitäjän / tilaavan palveluyksikön tietoja vaan ainoastaan suorittajan tiedot. SAVissa lisätään myös organisaatiota kuvaava CMET. SAVissa tähän sanomankuvaukseen on määritelty suorittajan ja rekisterinpitäjän tietoja. Tässä käytetään samaa rakennetta kuin ajanvarauspyynnön hyväksyvässä 14 vastauksessakin. 15 typecode 1..1 "AUT" Tällä rakenteella voidaan ilmaista useita author participation:eita: perumisen suorittaja, rekisterinpitäjä authorchoice ja tilaava palveluyksikkö choice types in authorchoice SAV lisäys, tätä ei ole valmiina Full Slot RMIM tietomallissa. Perumisen suorittaja 18 assignedperson 0..1 Henkilö, joka peruu ajanvarauksen. Henkilö voi olla Ammattilainen/tilaaja, Ammattilainen/suorittaja, Asiakas, Asiakkaan 56 SerAPI projekti

57 edustaja. CMET ajanvarauksen suorittajan tiedoille: R_AssignedPerson universal COCT_MT090100UV01. CMET kuvattu erikseen kappaleessa 6.2. Rekisterinpitäjä ja/tai tilaava palveluyksikkö CMET organisaation tiedoille: R_AssignedOrganization identified COCT_MT090201UV01 Tämä on kuvattu kappaleessa 6.3 assignedorganization 0..* Jos tilaavan palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään author participationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganisation. Nämä erotetaan assignedorganisation roolissa olevalla code elementillä end contents of authorchoice 21 referencedorder 0..* 22 typecode actorder classcode moodcode id 1..1 schedulerequest 0..* Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan yksilöidä, kumpi on kyseessä. Ajanvarauksen perumispyynnössä tässä ainoastaan rekisterinpitäjän tiedot.. Jos tämä actrelationship on olemassa, voidaan actappointmentrequest luokassa (act) ilmaista Tilaajan ajanvaraustunnus typecode 1..1 "SCH" 29 actappointmentrequest 1..1 Viittaus ajanvarauspyyntöön 30 classcode 1..1 "ACT" 31 moodcode 1..1 "ARQ" 32 id 1..1 Tilaajan ajanvaraustunnus 33 trigger 0..* 34 typecode supplyorder classcode moodcode consumable 0..* 39 typecode manufacturedproduct classcode id code manufacturedmaterialkind classcode determinercode 1..1 SerAPI projekti 57

58 47 code quantity name 0..* 50 manufacturerorganization 0..1 reference 0..* (actrelationship) Tämä kenttä on annettava, jos halutaan perua yksi osa ajanvaraustunnuksen yksilöimästä kokonaisuudesta (esim. yksi palvelutuote). Jos tätä viittausta ei anneta, perutaan koko ajanvaraus, vaikka se koostuisi useammastakin osasta. Yhdellä perumispyynnöllä mahdollista perua tarvittaessa useita palvelutuotteita 51 sillä kardinaliteetti 0..* 52 typecode 1..1 "REFR" Peruttavan palvelutuotteen aikataulu, jossa schedule 1..1 yksilöidään myös palvelutuote. 53 (act) 54 classcode 1..1 "ACT" 55 moodcode 1..1 "SLOT" Peruttavan palvelutuotteen tunniste. Tunniste, joka yksilöi palvelutuotteen. id 1..1 Jos kansallisesti yhteisesti sovittua koodistoa palvelutuotteille ei olemassa, on ajanvarausjärjestelmän ja ajanvarauspalvelun välillä sovittava erikseen palvelutuotteille käytettävistä koodeista ja koodistoista. SAVissa määritellyissä SOAPviestiesimerkeissä käytetään kuviteltua 56 itse määriteltyä koodistoa. 57 code title 0..1 Palvelutuotteen nimi 59 text 0..1 Potilasohje tai linkki potilasohjeeseen 60 effectivetime repeatnumber 0..1 (actrelationship) component 0..* Tätä käytettävä, jos on yksilöitävä myös peruttava aika eli pelkkä ajanvaraustunnuksen ja palvelutuotteen tunnistaminen ei 62 riitä 63 typecode 1..1 "COMP" 64 resourceslot 1..1 (act) 65 classcode 1..1 "ACT" 66 moodcode 1..1 "SLOT" 67 id 0..1 Peruttavan slotin id 68 code 0..1 Actin status, 69 statuscode 1..1 Tässä ilmoitetaan mikä ajanvarauksen tila on. statuscode attribuutille on olemassa koodisto ActStatus. Ajanvaraussovellusalueen johdannossa nämä tilakoodit on mapattu ajanvarausta paremmin kuvaaviin tilakoodeihin (Slot Status Code, ks. kappale SerAPI projekti

59 Viesteissä käytetään RIMin mukaisia Act Status koodeja. Perumispyynnössä tässä actstatusarvona: complete (RIM status code) Ajanvarausmappaus: booked (slot status code) Hyväksyvässä perumispyynnön vastauksessa tässä actstatus arvona: aborted (RIM status code) Ajanvarausmappaus: cancelled (slot status code) Peruttavan palvelutuotteen alkamisaika ja loppumisaika, jos resourceslot.id:tä ei annettu, eli aika ilmaistaan ilman sloteja. effectivetime 1..1 Jos resourceslot.id annettu, ilmoitetaan tässä yksilöidyn slotin alkamisaika ja loppumisaika effectivetime:sta käytetään arvoja low / high Aika annetaan aina tässä kentässä oli se sitten yksilöity slot id:llä tai ei > muutos Full Slot RMIM tietomalliin (0..1 > ) 71 prioritycode 0..* 72 repeatnumber directtarget 0..* (participation) 74 typecode 1..1 "DIR" 75 identifiedentity classcode 1..1 "IDENT" 77 id 0..* 78 identifiedresource 0..1 Resursseilla voidaan ilmaista palvelutuotteeseen liittyviä muuttuvia tietoja 79 choice types in identifiedresource 80 Place.. Paikka 81 classcode 1..1 "PLC" 82 determinercode 1..1 "INSTANCE" 83 id 0..* 84 code name 0..* 86 ResourceGroup.. 87 classcode determinercode id 0..* 90 code name 0..* 92 Person.. Henkilö 93 classcode 1..1 "PSN" 94 determinercode 1..1 "INSTANCE" 95 id 0..* 96 name 0..* 97 ManufacturedMaterial.. SerAPI projekti 59

60 98 classcode determinercode id 0..* 101 code name 0..* 103 end contents of identifiedresource responsibleparty 0..1 Toimittajan yhteystieto (participation) Jos tämä participation olemassa, on myös toimittajan yhteystieto olemassa. SAV lisäys, responsiblepartyparticipationia ei ole valmiina ajanvaraussovellusalueen 104 tietomallissa. 105 typecode 1..1 "RESP" CMET toimittajan tiedoille: assignedorganization 1..1 R_AssignedOrganization contact COCT_HD090203UV CMET kuvattu erikseen kappaleessa 6.4. Huomioitavaa perumisen syy voidaan ilmoittaa Control Act Wrapperin reasoncode kentässä (ks. liite 3), tälle on olemassa oma koodisto SchedulingActReason (ks. liite 4). Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Cancel Appointment by Slot (PRSC_MT030301FI01) Sanomatyypin (Message Type) XML skeema PRSC_MT030301FI01 löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_MT030301FI01.xsd Samasta zip paketista löytyy esimerkki sanomatyypin käytöstä ajanvarauksen perumispyyntö interaktio esimerkistä examplexml/prsc_in040201fiexample.xml Cancel Appointment by Slot sanomankuvauksessa käytetyt CMET:it (Common Message Element Types) R_Patient identified/confirmable, (COCT_MT050002UV04), ks. kpl 6.1. R_AssignedPerson universal (COCT_MT090100UV01), ks. kpl 6.2. R_AssignedOrganization identified (COCT_MT090201UV01), ks. kpl 6.3, lisätty käytettäväksi SAVissa R_AssignedOrganization contact (COCT_HD090203UV01), ks. kpl 6.4, lisätty käytettäväksi SAVissa E_OrganizationUniversal (COCT_MT150000UV02), ks. kpl 6.5, ei käytetä SAVissa Reschedule Appointment by Slot (PRSC_HD030400FI01) Tämä sanomankuvaus määritelty SAVissa, tätä ei löydy HL7v3 Scheduling sovellusalueesta. SAVissa tätä sanomankuvausta käytetään Slot kohtaiseen ajanvarauksen siirtämispyyntöön 60 SerAPI projekti

61 Slot kohtaisen siirtämispyynnön hyväksyvään vastaukseen Slot kohtaiseen siirtämispyynnön hylkäävään vastaukseen, jos halutaan palauttaa takaisin pyynnön sisältämät tiedot. Käyttökohteena ovat yksinkertaiset tapaukset, ei moniajanvaraukset. Reschedule Appointment by Slot sanomankuvaus pohjautuu samaan Full Slot RMIM tietomalliin kuin ajanvarauspyynnön vastaus (New Appointment by Slot). Siirrettäessä aikaa on ilmoitettava sekä vanha (siirrettävä) aika että uusi aika. Nämä annetaan siirtämispyynnössä siten, että ResourceSlot luokka toistuu kaksi kertaa per siirrettävä aika. Ensimmäisessä annetaan vanha (siirrettävä) aika ja toisessa annetaan uusi aika. Nämä erotaan toisistaan ResourceSlot luokan elementillä statuscode. Vanhan ajan statuscode on complete siirrettävässä ajassa ja active siinä, mihin siirretään. Molemmissa voidaan antaa resourceslot.id ja/tai resourceslot.effectivetime. Jos siirrettäviä aikoja on useita, muodostavat peräkkäiset booked ja available ResourceSlot parit yhden siirrettävän ajan. Jos ajan siirron seurauksena myös palvelutuote vaihtuu, on käytettävä sanomankuvausta Revise Appointment ja interaktiota Appointment Revise Request by Slot. Alla olevaan sanomankuvaukseen on liitetty SAV vaatimuksissa ajanvarauksen siirtämispyynnölle esitetyt tiedot. Ajanvarauksen perumispyynnön ja vastauksen tietosisältö on määritelty dokumentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymämäärittely, v1" kappaleessa Ajanvarauksen perumispyyntö. Käytännössä ajanvarauksen siirtämistä varten voitaisiin määritellä tiiviimpi sanomankuvaus, jossa välitettäisiin vain ajanvarauksen tunnistamiseen tarvittavat tiedot (tiedot joilla voidaan määritellä mihin ajan siirtäminen kohdistuu) sekä vanha ja uusi aika. Taulukko 7. Reschedule Appointment by Slot. Kentän numero HL7v3 elementti Pakollisuus SAV tiedot (lihavoitu taulukkoon) + selitteet Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Reschedule Appointment by Slot, (PRSC_HD030400FI01) 1 ActAppointment 0..1 Ajanvaraus 2 classcode 1..1 "ACT" 3 moodcode 1..1 "APT" Toimittajan ajanvaraustunniste id code text statuscode effectivetime prioritycode 0..* 10 confidentialitycode 0..* 11 subject 0..* Toimittajan ajanvaraukselle antama tunniste. Asiakas (participation) SerAPI projekti 61

62 12 typecode 1..1 "SBJ" CMET asiakkaan tiedoille patient 1..1 R_Patient identified/confirmable, COCT_MT050002UV CMET kuvattu erikseen kappaleessa 6.1. Siirtämispyynnön suorittaja, rekisterinpitäjä ja tilaava palveluyksikkö (participation) author 0..* SAV muutos, ajanvaraussovellusalueessa ja RMIM mallissa Full Slot RMIM ei ole valmiina rekisterinpitäjän / tilaavan palveluyksikön tietoja vaan ainoastaan suorittajan tiedot. SAVissa lisätään myös organisaatiota kuvaava CMET. SAVissa tähän sanomankuvaukseen on määritelty suorittajan ja rekisterinpitäjän tietoja. Tässä käytetään samaa rakennetta kuin ajanvarauspyynnön hyväksyvässä 14 vastauksessakin. 15 typecode 1..1 "AUT" Tällä rakenteella voidaan ilmaista useita author participation:eita: siirtämisen suorittaja, rekisterinpitäjä authorchoice ja tilaava palveluyksikkö choice types in authorchoice assignedperson 0..1 SAV lisäys, tätä ei ole valmiina Full Slot RMIM tietomallissa. Siirtämispyynnön suorittaja Henkilö, joka siirtää ajanvarauksen. Henkilö voi olla Ammattilainen/tilaaja, Ammattilainen/suorittaja, Asiakas, Asiakkaan edustaja. CMET ajanvarauksen suorittajan tiedoille: R_AssignedPerson universal COCT_MT090100UV CMET kuvattu erikseen kappaleessa 6.2. Rekisterinpitäjä ja/tai tilaava palveluyksikkö CMET organisaation tiedoille: R_AssignedOrganization identified COCT_MT090201UV01 assignedorganization 0..* CMET kuvattu erikseen kappaleessa 6.3. Jos tilaavan palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään author participationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganisation. Nämä erotetaan assignedorganisation roolissa olevalla code elementillä. 19 Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan 62 SerAPI projekti

63 20 end contents of authorchoice 21 referencedorder 0..* 22 typecode actorder classcode moodcode id 1..1 schedulerequest 0..* yksilöidä, kumpi on kyseessä. Jos tämä actrelationship on olemassa, voidaan actappointmentrequest luokassa (act) ilmoittaa Tilaajan ajanvaraustunnus typecode 1..1 "SCH" 29 actappointmentrequest 1..1 Viittaus ajanvarauspyyntöön 30 classcode 1..1 "ACT" 31 moodcode 1..1 "ARQ" 32 id 1..1 Tilaajan ajanvaraustunnus 33 trigger 0..* 34 typecode supplyorder classcode moodcode consumable 0..* 39 typecode manufacturedproduct classcode id code manufacturedmaterialkind classcode determinercode code quantity name 0..* 50 manufacturerorganization 0..1 (actrelationship) Tämä kenttä pakollinen, koska on yksilöitävä siirrettävä palvelutuote. reference 1..* Yhdellä siirtämispyynnöllä on mahdollista siirtää useita samaan ajanvarauskokonaisuuteen liittyviä palvelutuotteita, sillä suhteet 1..* > muutos pakollisuuksiin Full Slot RMIMtietomalliin typecode 1..1 "REFR" Siirrettävän palvelutuotteen aikataulu, jossa schedule 1..1 yksilöidään myös palvelutuote. 53 (act) 54 classcode 1..1 "ACT" 55 moodcode 1..1 "SLOT" Siirrettävän palvelutuotteen tunniste 56 id 1..1 Tunniste, joka yksilöi palvelutuotteen. Jos kansallisesti yhteisesti sovittua koodistoa palvelutuotteille ei olemassa, on ajan SerAPI projekti 63

64 varausjärjestelmän ja ajanvarauspalvelun välillä sovittava erikseen palvelutuotteille käytettävistä koodeista ja koodistoista. SAVissa määritellyissä SOAPviestiesimerkeissä käytetään kuviteltua itse määriteltyä koodistoa. 57 code title 0..1 Palvelutuotteen nimi 59 text 0..1 Potilasohje tai linkki potilasohjeeseen 60 effectivetime repeatnumber 0..1 (actrelationship) component 1..* ResourceSlot luokka toistuu kaksi kertaa per siirrettävä aika. Ensin annetaan vanha (siirrettävä) aika ja toisessa annetaan uusi aika. Pakollinen tieto Full Slot RMIM tietomallissa tämä tieto on 62 vapaaehtoinen > muutos RMIM malliin 63 typecode 1..1 "COMP" 64 resourceslot 1..1 (act) 65 classcode 1..1 "ACT" 66 moodcode 1..1 "SLOT" 67 id 0..1 Siirrettävän slotin id 68 code 0..1 Actin status, Tässä ilmoitetaan mikä ajanvarauksen tila on. statuscode attribuutille on olemassa koodisto ActStatus. Ajanvaraussovellusalueen johdannossa nämä tilakoodit on mapattu ajanvarausta paremmin kuvaaviin tilakoodeihin (Slot Status Code, ks. kappale statuscode 1..1 Viesteissä käytetään RIMin mukaisia Act Status koodeja. Siirtämispyynnössä tässä actstatusarvona siirrettävällä ajalla: complete (RIM status code) uudella ajalla: active (RIM status code) effectivetime 1..1 Ajanvarausmappaus uudelle ajalle: booked (slot status code) Ajanvarausmappaus uudelle ajalle: available (slot status code) Siirrettävän palvelutuotteen alkamisaika ja loppumisaika / uusi alkamisaika ja loppumisaika, jos resourceslot.id:tä ei annettu, eli aika ilmaistaan ilman sloteja. Jos resourceslot.id annettu, ilmoitetaan tässä yksilöidyn siirrettävän slotin alkamisaika ja loppumisaika / uuden slotin alkamisaika ja loppumisaika 64 SerAPI projekti

65 effectivetime:sta käytetään arvoja low / high Pakollinen tieto. Muutos Full Slot RMIM tietomalliin (0..1 > 1..1), sillä Full Slot RMIM tietomallissa tämä tieto on vapaaehtoinen. 71 prioritycode 0..* 72 repeatnumber directtarget 0..* (participation) 74 typecode 1..1 "DIR" 75 identifiedentity classcode 1..1 "IDENT" 77 id 0..* 78 identifiedresource 0..1 Resursseilla voidaan ilmaista palvelutuotteeseen liittyviä muuttuvia tietoja 79 choice types in identifiedresource 80 Place.. Paikka 81 classcode 1..1 "PLC" 82 determinercode 1..1 "INSTANCE" 83 id 0..* 84 code name 0..* 86 ResourceGroup.. 87 classcode determinercode id 0..* 90 code name 0..* 92 Person.. Henkilö 93 classcode 1..1 "PSN" 94 determinercode 1..1 "INSTANCE" 95 id 0..* 96 name 0..* 97 ManufacturedMaterial.. 98 classcode determinercode id 0..* 101 code name 0..* 103 end contents of identifiedresource Toimittajan yhteystieto (participation) responsibleparty 0..1 Jos tämä participation olemassa, on myös toimittajan yhteystieto olemassa. SAV lisäys, responsiblepartyparticipationia ei ole valmiina ajanvaraussovellusalueen 104 tietomallissa. 105 typecode 1..1 "RESP" CMET toimittajan tiedoille: assignedorganization 1..1 R_AssignedOrganization contact COCT_HD090203UV CMET kuvattu erikseen kappaleessa 6.4. SerAPI projekti 65

66 Huomioitavaa siirtämisen syy voidaan ilmoittaa Control Act Wrapperin reasoncode kentässä (ks. liite 3), tälle on olemassa oma koodisto SchedulingActReason (ks. liite 4). Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Reschedule Appointment by Slot (PRSC_MT030401FI01) Sanomatyypin (Message Type) XML skeema PRSC_MT030401FI01 löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_MT030401FI01.xsd Samasta zip paketista löytyy esimerkki sanomatyypin käytöstä ajanvarauksen perumispyyntö interaktio esimerkistä examplexml/prsc_in040301fiexample.xml Reschedule Appointment by Slot sanomankuvauksessa käytetyt CMET:it (Common Message Element Types) R_Patient identified/confirmable, (COCT_MT050002UV04), ks. kpl 6.1. R_AssignedPerson universal (COCT_MT090100UV01), ks. kpl 6.2. R_AssignedOrganization identified (COCT_MT090201UV01), ks. kpl 6.3, lisätty käytettäväksi SAVissa R_AssignedOrganization contact (COCT_HD090203UV01), ks. kpl 6.4, lisätty käytettäväksi SAVissa E_OrganizationUniversal (COCT_MT150000UV02), ks. kpl 6.5, ei käytetä SAVissa Revise Appointment by Slot (PRSC_HD030500FI01) Tämä sanomankuvaus määritelty SAVissa, tätä ei löydy HL7v3 Scheduling sovellusalueesta. SAVissa tätä sanomankuvausta käytetään Slot kohtaiseen ajanvarauksen muokkaamispyyntöön Slot kohtaisen muokkaamispyynnön hyväksyvään vastaukseen Slot kohtaiseen muokkaamispyynnön hylkäävään vastaukseen, jos halutaan palauttaa takaisin pyynnön sisältämät tiedot. Ilmoitukseen vapaan ajan muuttumisesta ei vapaaksi, jos ilmoituksessa tarve kuljettaa myös ajanvarauksen tietoja. Ilmoitukseen varatun ajan muuttuminen vapaaksi, jos ilmoituksessa tarve kuljettaa myös ajanvarauksen tietoja. Sanomankuvauksen ResourceSlot luokan statuscode elementin arvo on oltava ilmoituksessa varatun ajan muuttumisesta vapaaksi active. Revise Appointment by Slot sanomankuvaus pohjautuu Full Slot RMIM tietomalliin. Mukana myös SAVissa määritellyt lisäykset, joita käytetään ajanvarauspyynnössä. Näitä lisäyksiä ovat: participation rakenne remindercontext. Tätä tarvitaan, jos halutaan muokata muistutuspyynnön tietoja. Act luokka FinancialContract, jolla voidaan ilmaista maksusitoumuksen tietoja. Act luokka Episode, jolla ilmaistaan palveluketjun tietoja. Alla olevaan sanomankuvaukseen on liitetty SAV vaatimuksissa ajanvarauksen muokkauspyynnölle esitetyt tiedot. Ajanvarauksen muokkauspyynnön ja vastauksen tietosisältö on määritelty doku 66 SerAPI projekti

67 mentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymämäärittely, v1" kappaleessa Ajanvarauksen muokkauspyyntö. Ajanvarauksen muokkauspyynnössä lähetetään ne tiedot, joita ajanvarauksessa on tarkoitus muokata. Tällä hetkellä muokkauspyyntöön ei ole määritelty siten, että mukana pitäisi mennä sekä uusi että vanha tieto. Näin muokkauspyynnön vastaanottavan järjestelmän on vertailtava sekä olemassa olevaa ajanvarausta että uutta ajanvarausta keskenään, jotta se voisi erottaa mitkä tiedot ovat muokkauksen kohteena. Käytännössä muokkauspyynnössä kannattaakin lähettää vain ajanvarauksen tunnistamiseen tarvittavat tiedot sekä uusi muokattu tieto. Muokkauspyynnön mukana voidaan periaatteessa lähettää myös kaikki muut ajanvarauksen tiedot (jos kaikki saatu varattujen aikojen kyselyllä). Näin jos vastaanottava järjestelmä luottaa lähettävän järjestelmän muokkauspyyntöön, voi se ajaa muokkauspyynnössä tulevan ajanvarauksen olemassa olevan ajanvarauksen yli? Yksi vaihtoehto on ajanvarauksen ajan siirtämisen yhteydessä esitetty tapa välittää sekä vanha tieto, jota muokataan että uusi tieto, joka tulee vanha tilalle. Taulukko 8. Revise Appointment by Slot Kentän numero HL7v3 elementti Pakollisuus SAV tiedot (lihavoitu taulukkoon) + selitteet Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Revise Appointment by Slot, PRSC_HD030500FI01 1 ActAppointment 0..1 Ajanvaraus 2 classcode 1..1 "ACT" 3 moodcode 1..1 "APT" Toimittajan ajanvaraustunniste id code 0..1 Toimittajan ajanvaraukselle antama tunniste. Huomautus/lisäkenttä text 0..1 Ajanvaraukseen liittyvän vapaan tekstin 6 muokkaaminen. 7 statuscode effectivetime prioritycode 0..* 10 confidentialitycode 0..* Asiakas (participation) 11 subject 0..* 12 typecode 1..1 "SBJ" CMET asiakkaan tiedoille patient 1..1 R_Patient identified/confirmable, COCT_MT050002UV CMET kuvattu erikseen kappaleessa 6.1. Muokkaamispyynnön suorittaja, rekisterinpitäjä ja tilaava palveluyksikkö author 0..* (participation) 14 SAV muutos, ajanvaraussovellusalueessa ja RMIM mallissa Full Slot RMIM ei ole SerAPI projekti 67

68 valmiina rekisterinpitäjän / tilaavan palveluyksikön tietoja vaan ainoastaan suorittajan tiedot. SAVissa lisätään myös organisaatiota kuvaava CMET. SAVissa tässä sanomankuvauksessa tarvitaan ainoastaan suorittajan ja rekisterinpitäjän tietoja. HL7v3 Scheduling sovellusalueessa tässä sanomankuvauksessa myös suorittajan tiedot. Näin tähän on määritelty sama rakenne kuin ajanvarauspyyntöönkin. 15 typecode 1..1 "AUT" Tällä rakenteella voidaan ilmaista useita author participation:eita: muokkaamispyynnön suorittaja, rekisterinpitäjä authorchoice ja tilaava palveluyksikkö choice types in authorchoice assignedperson 0..1 SAV lisäys, tätä ei ole valmiina Full Slot RMIM tietomallissa Muokkaamispyynnön suorittaja Henkilö, joka muokkaa ajanvarauksen. Henkilö voi olla Ammattilainen/tilaaja, Ammattilainen/suorittaja, Asiakas, Asiakkaan edustaja. CMET ajanvarauksen suorittajan tiedoille: R_AssignedPerson universal COCT_MT090100UV CMET kuvattu erikseen kappaleessa 6.2. Rekisterinpitäjä ja/tai tilaava palveluyksikkö CMET organisaation tiedoille: R_AssignedOrganization identified COCT_MT090201UV01 CMET kuvattu erikseen kappaleessa 6.3. assignedorganization 0..* end contents of authorchoice 21 referencedorder 0..* 22 typecode actorder classcode moodcode id schedulerequest 0..* Jos tilaavan palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään author participationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganisation. Nämä erotetaan assignedorganisation roolissa olevalla code elementillä. Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan yksilöidä, kumpi on kyseessä. Jos tämä actrelationship on olemassa, voidaan actappointmentrequest luokassa (act) palauttaa Tilaajan ajanvaraustunnus. 68 SerAPI projekti

69 28 typecode 1..1 "SCH" 29 actappointmentrequest 1..1 Viittaus ajanvarauspyyntöön 30 classcode 1..1 "ACT" 31 moodcode 1..1 "ARQ" 32 id 1..1 Tilaajan ajanvaraustunnus 33 trigger 0..* 34 typecode supplyorder classcode moodcode consumable 0..* 39 typecode manufacturedproduct classcode id code manufacturedmaterialkind classcode determinercode code quantity name 0..* 50 manufacturerorganization 0..1 (actrelationship) Palvelutuotteen tiedot SAV tietosisällöissä reference 1..* pakolliset > muutos Full Slot RMIM tietomallin (0..* > *) 52 typecode 1..1 "REFR" Muokattavan palvelutuotteen aikataulu, schedule 1..1 jossa yksilöidään myös palvelutuote. 53 (act) 54 classcode 1..1 "ACT" 55 moodcode 1..1 "SLOT" Muokattavan palvelutuotteen tunniste. Tunniste, joka yksilöi palvelutuotteen. id 1..1 Jos kansallisesti yhteisesti sovittua koodistoa palvelutuotteille ei olemassa, on ajanvarausjärjestelmän ja ajanvarauspalvelun välillä sovittava erikseen palvelutuotteille käytettävistä koodeista ja koodistoista. SAVissa määritellyissä SOAPviestiesimerkeissä käytetään kuviteltua 56 itse määriteltyä koodistoa. 57 code title 0..1 Palvelutuotteen nimi 59 text 0..1 Potilasohje tai linkki potilasohjeeseen 60 effectivetime repeatnumber 0..1 (actrelationship) 62 component 1..* Jos reference viittaus palvelutuotteeseen on annettu. SerAPI projekti 69

70 Palvelutuotteen tiedot SAV tietosisällöissä pakolliset > muutos Full Slot RMIMtietomallin (0..* > 1..*) 63 typecode 1..1 "COMP" 64 resourceslot 1..1 (act) 65 classcode 1..1 "ACT" 66 moodcode 1..1 "SLOT" 67 id 0..1 Slotin id 68 code 0..1 Actin status, Tässä ilmoitetaan mikä ajanvarauksen tila on. statuscode attribuutille on olemassa koodisto ActStatus. Ajanvaraussovellusalueen johdannossa nämä tilakoodit on mapattu ajanvarausta paremmin kuvaaviin tilakoodeihin (Slot Status Code, ks. kappale Viesteissä käytetään RIMin mukaisia Act Status koodeja. Muokkauspyynnöissä ja niiden vastauksissa, jotka eivät kohdistu ajanvarauksen tilaan actstatus arvona: complete (RIM status code) statuscode 1..1 Ajanvarausmappaus booked (slot status code) Ilmoituksessa varatun ajan muuttumisesta vapaaksi tässä actstatus arvona: active (RIM status code) Ajanvarausmappaus available (slot status code) Ilmoituksessa vapaan ajan muuttumisesta ei vapaaksi. Huom. ei vapaaksi ilmoitus voi olla seurausta muustakin kuin uudesta ajanvarauksesta, tällöin on käytettävä näihin tilanteisiin sopivia statuscodeja, ks. Slot Status Code kappaleessa Jos muokkauspyynnössä vaihdetaan ajanvaraukseen liittyvä palvelutuote, on actstatuscodeksi annettava active. Palvelutuotteen alkamisaika ja loppumisaika, jos resourceslot.id:tä ei annettu, eli aika ilmaistaan ilman sloteja. effectivetime 1..1 Jos resourceslot.id annettu, ilmoitetaan tässä yksilöidyn slotin alkamisaika ja loppumisaika effectivetime:sta käytetään arvoja low / high 70 Aika annetaan aina tässä kentässä oli se sitten yksilöity slot id:llä tai ei > muutos Full Slot RMIM tietomalliin (0..1 > 1..1) 70 SerAPI projekti

71 71 prioritycode 0..* 72 repeatnumber directtarget 0..* (participation) 74 typecode 1..1 "DIR" 75 identifiedentity classcode 1..1 "IDENT" 77 id 0..* identifiedresource choice types in identifiedresource 80 Place.. Paikka 81 classcode 1..1 "PLC" 82 determinercode 1..1 "INSTANCE" 83 id 0..* 84 code name 0..* 86 ResourceGroup.. 87 classcode determinercode id 0..* 90 code name 0..* 92 Person.. Henkilö 93 classcode 1..1 "PSN" 94 determinercode 1..1 "INSTANCE" 95 id 0..* 96 name 0..* 97 ManufacturedMaterial.. 98 classcode determinercode id 0..* 101 code name 0..* 103 end contents of identifiedresource responsibleparty 0..1 Resursseilla voidaan ilmaista palvelutuotteeseen liittyviä muuttuvia tietoja Toimittajan yhteystieto (participation) 104 Jos tätä tietoa on tarve muokata. 105 typecode 1..1 "RESP" CMET toimittajan tiedoille: assignedorganization 1..1 R_AssignedOrganization contact COCT_HD090203UV CMET kuvattu erikseen kappaleessa 6.4. Muistutuspyyntö (participation) remindercontact 0..* typecode 1..1 functioncode 1..1 Jos muistutuspyynnön tietoja tarve muokata. Participation luokan lisäys Full Slot RMIMmalliin (+ DMIM) "IRCP" = Information Recipient typecode:n arvon sopivuus tähän varmistettava Muistutuspyynnön tapa Koodisto muistutuspyynnön tavasta. SerAPI projekti 71

72 notetext 0..1 time.0.1 assignedperson 1..1 Tässä käytetään HL7 Finland koodistoa HL7 Ajanvarauksesta ilmoittaminen: OID: : Koodiston sisältö: Kirjeitse KIR Puhelimitse PUH Tästä puuttuvat SMS + sähköposti, jotka on lisättävä koodistoon. Huomautusteksti Vapaamuotoista tekstiä liittyen muistutuspyyntöön. Muistutuspyynnön aika Tämä tieto ei ole pakollinen, sillä järjestelmät saattava generoida muistutuspyynnön ajan myös automaattisesti Muistutuspyynnön kohde Muistutuspyynnön kohteen tiedot ilmaistaan CMETillä R_AssignedPerson universal, COCT_MT090100UV01 CMET kuvattu kappaleessa 6.2 CMETistä käytetään attribuuttia Address jos lähetetään postitse, Tel jos käytetään puhelinta, Tel jos käytetään sähköpostia, Tel jos käytetään SMS:ää. TEL:issä ei tarvita formaattimääritystä vaan remindercontact.functioncode sanoo millä tavalla esim. puhelinnumeroa käytetään (SMS vai puhelu). ActRelationship maksusitoumus Actiin referencedfinancialcontract 0..1 Jos tämä actrelationship olemassa, on myös maksusitoumus olemassa. SAV määrittely, referencedfinancialcontract ja FinancialContract luokkien lisäys 113 Full Slot RMIM malliin (+ DMIM) 114 typecode 1..1 "REFR" Maksusitoumus 115 financialcontract 1..1 (act) 116 classcode 1..1 "ACT" 117 moodcode 1..1 "EVN" 118 id 0..1 Tunniste 119 code text 0..1 Vapaamuotoinen teksti ActRelationship Actiin, jolla ilmaistaan ajanvarauksen liittyminen tiettyyn kokonaisuuteen referencedepisode 0..*. SAV määrittely, referencedepisodeactrelationshipin ja episode actin lisäys 121 Full Slot RMIM malliin (+ DMIM) 122 typecode 1..1 "REFR" Kokonaisuus, johon ajanvaraus liittyy 123 episode 1..1 (act) 124 classcode 1..1 "ACT" 72 SerAPI projekti

73 125 moodcode 1..1 "EVN" 126 id 0..1 Kokonaisuuden tunniste, johon ajanvaraus liittyy Ajanvaraukseen liittyvän kokonaisuuden tyyppi code 0..1 Tässä käytetään SAVissa määriteltyä ajanvaraus spesifiä koodistoa Ajanvaraukseen liittyvän kokonaisuuden tyyppi: OID: Koodiston sisältö: Palvelukokonaisuus 1 Hoitokokonaisuus 2 Hoitojakso 3 Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) Revise Appointment by Slot (PRSC_MT030501FI01) Sanomatyypin (Message Type) XML skeema PRSC_MT030501FI01 löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_MT030501FI01.xsd Samasta zip paketista löytyy esimerkki sanomatyypin käytöstä ajanvarauksen perumispyyntö interaktio esimerkistä examplexml/prsc_in040401fiexample.xml. New Appointment sanomankuvauksessa käytetyt CMET:it (Common Message Element Types) R_Patient identified/confirmable, (COCT_MT050002UV04), ks. kpl 6.1. R_AssignedPerson universal (COCT_MT090100UV01), ks. kpl 6.2. R_AssignedOrganization identified (COCT_MT090201UV01), ks. kpl 6.3, lisätty käytettäväksi SAVissa R_AssignedOrganization contact (COCT_HD090203UV01), ks. kpl 6.4, lisätty käytettäväksi SAVissa E_OrganizationUniversal (COCT_MT150000UV02), ks. kpl 6.5, ei käytetä SAVissa 4.6 Interaktiot Interaktioon liittyy aina sen käynnistävä liipaisintapahtuma (trigger event). Interaktion yhteydessä on määritelty myös lähettäjän ja vastaanottajan roolit (application roles). Sovellusalueen yleismallin (DMIM) tutkimisen, yleiskuvauksen ja käyttötapauskuvauksien tutkimisen jälkeen kannattaa tutkia interaktioiden luetteloa (Open CDA 2006). HL7 standardissa kunkin interaktion kohdalla on määritelty seuraavat seikat: liipaisintapahtuma (trigger event), Slot topicin liipaisimet on määritelty tämän dokumentin kappaleessa 4.3. siirtokehys (transmission wrapper), siirtokehykset ovat tämän dokumentin liitteissä 1 ja 2. kontrollikehys (control act wapper), kontrollikehys on tämän dokumentin liitteessä 3 sanomatyyppi (message type) lähettäjän ja vastaanottajan roolit, eri sovellusroolit kuvattu tämän dokumentin kappaleessa 4.2. SerAPI projekti 73

74 Sanomatyyppi on muodostettu hierarkkisen sanomankuvauksen perusteella. Hierarkkiset sanomankuvaukset (ks. kpl 4.5) sekä näiden RMIM mallit (ks. kpl 4.4) on käyty läpi aiemmin tässä dokumentissa. Ajanvaraussovellusalueessa käytettävien siirtokehyksien ja kontrollikehyksen sanomankuvaukset ovat liitteissä 1, 2 ja 3. Näiden merkitys ja sisältö on selvitetty yleisellä tasolla Open CDA 2006 HL7 V3 Messaging implementointi dokumentissa (Open CDA 2006). HL7v3 sanomien yleinen rakenne (HL7 composite message) on kuvan 8 mukainen. HL7v3 sanoma rakentuu siirtokehyksestä (transmission wrapper), kontrollikehyksestä (control act wrapper) ja varsinaisesta sanomasta (payload). Siirtokehys on aina pakollinen HL7v3 sanomissa, kontrollikehys ja varsinainen sanoma ovat tilanteesta riippuen vapaaehtoisia. Siirtokehys (transmission wrapper) Kontrollikehys (control act wrapper) Varsinainen sanoma (payload) Kuva 8. HL7v3 sanoman rakenne. Ajanvarauksen pyynnöissä ja ilmoituksissa käytetään Send Message Payload siirtokehystä, joka on kuvattu liitteessä 1. Ajanvarauksessa käytettävät pyyntöjen vastaukset ovat samalla sovellustason kuittauksia pyyntöihin. Näin ne käyttävät siirtokehystä Application Level Acknowledgement, joka on kuvattu liitteessä New Appointment Slot Request (PRSC_IN030101FI01) Pyyntö muuttaa yhden tai useamman aikavälin (Slotin) tilaa määritellyllä aikajaksolla. Tätä voidaan käyttää kaikkien aikavälien lukitsemiseen jollakin aikajaksolla. SAVissa uuden ajanvarauksen varauspyyntö. Interaktion PRSC_IN030101FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN030101FI01.xsd. Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN030101FIExample ajanvarauksen varauspyynnöstä tiedostosta examplexml\prsc_in030101fiexample.xml Trigger Event New Appointment Request by Slot PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Appointment by Slot Request PRSC_MT050101FI01 Receiver Responsibilities Reason Trigger Event Interaction PRSC_TE PRSC_IN PRSC_TE PRSC_IN SerAPI projekti

75 Sending and Receiving Roles Sender Slot Requester PRSC_AR Receiver Slot Request Confirmer PRSC_AR New Appointment Slot Confirmation (PRSC_IN030102) Vastaus Slot kohtaisesti tehtyyn ajanvarauspyyntöön, kun pyyntö hyväksytään. SAVissa uuden ajanvarauksen varauspyynnön hyväksyvä vastaus. Interaktion PRSC_IN030102FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN030102FI01.xsd. Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN030102FIExample ajanvarauksen varauspyynnön hyväksyvästä vastauksesta tiedostosta examplexml\prsc_in030102fiexample.xml Trigger Event New Appointment Request by Slot PRSC_TE Confirmation Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type New Appointment by Slot PRSC_MT030201FI01 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR New Appointment Slot Rejection (PRSC_IN030103) Vastaus Slot kohtaisesti tehtyyn ajanvarauspyyntöön, kun pyyntöä ei hyväksytä. SAVissa uuden ajanvarauksen varauspyynnön hyväksyvä vastaus. Interaktion PRSC_IN030103FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN030103FI01.xsd. Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN030103FIExample ajanvarauksen varauspyynnön hylkäävästä vastauksesta tiedostosta examplexml\prsc_in030103fiexample.xml Hylkäävässä vastauksessa syy ilmoitetaan ControlAct wrapperin reasonof elementissä (ks. liite 3 ja kpl 7.3). Lisäksi voidaan liittää mukaan koko tehty ajanvarauspyyntö. Tietosisältö on tällöin sama kuin ajanvarauspyynnössäkin (Appointment by Slot Request, PRSC_MT050101FI01). Trigger Event New Appointment Request by Slot PRSC_TE Rejection Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Appointment by Slot Request PRSC_MT050101FI01 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR SerAPI projekti 75

76 4.6.4 Slot Status Revise Notification (PRSC_IN020400) Slot kohtainen ilmoitus yhden tai useamman Slotin tilan muutoksista määritellyllä aikajaksolla. SAVissa ilmoitus vapaista ajoista. Lisäksi tätä sanomankuvausta voidaan hyödyntää SAVissa ilmoitukseen vapaan ajan muuttumisesta ei vapaaksi ja varatun ajan muuttuminen vapaaksi (= tässä tapauksessa ilmoitus vapaasta ajasta), jos mukana ei tarvitse välittää ajanvarauksen tietoja.. ResourceSlot.statusCode olisi tällöin ilmoituksessa vapaan ajan muuttumisesta ei vapaaksi complete. Jos näihin ilmoituksiin kuitenkin tarvitaan mukaan myös tietoja ajanvarauksesta, ei tässä interaktiossa käytettävän sanomankuvauksen tietosisältö ole riittävä ja näin ilmoituksille on määriteltävä uusi interaktio. Interaktion PRSC_IN020400FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN020400FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN020400FIExample vapaiden aikojen ilmoituksesta tiedostosta examplexml\ PRSC_IN020400FIExample.xml. Trigger Event Slot Revision Notification PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Slot Status Revision PRSC_MT040101FI01 Sending and Receiving Roles Sender Slot Informer PRSC_AR Receiver Slot Tracker PRSC_AR Slot Status Revise Request (PRSC_IN020301) Pyyntö muuttaa yhden tai useamman aikavälin (Slotin) tilaa määritellyllä aikajaksolla. Tätä voidaan käyttää kaikkien aikavälien lukitsemiseen jollakin aikajaksolla. Ei käytetä SAVissa. Trigger Event Slot Revision Request PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Slot Status Revision PRSC_MT Receiver Responsibilities Reason Trigger Event Interaction PRSC_TE PRSC_IN PRSC_TE PRSC_IN Sending and Receiving Roles Sender Slot Requester PRSC_AR Receiver Slot Request Confirmer PRSC_AR Slot Status Revise Confirmation (PRSC_IN020302) Vastaus pyyntöön muuttaa yhden tai useamman aikavälin (Slotin) tilaa, kun pyyntö vahvistetaan ja pyydetyn aikajakson sisältämien aikavälien tilat palautetaan. Ei käytetä SAVissa. 76 SerAPI projekti

77 Huom. Jos tätä halutaan hyödyntää, kannattanee muuttaa Transmission Wrapper Send Message Payload wrapperiksi Application Level Acknowledgement (MCCI_MT00300UV01). Näin tämä interaktio toimisi sovellustason kuittauksena ja siis myös kuittauksena pyyntöön. Trigger Event Slot Revision Confirmation PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Slot Status Revision PRSC_MT Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Slot Status Revise Rejection (PRSC_IN020303) Vastaus pyyntöön muuttaa yhden tai useamman aikavälin (Slotin) tilaa, kun pyyntö hylätään ja yhdenkään pyydetyn aikajakson sisältämän aikavälin tilaa ei ole muutettu. Ei käytetä SAVissa. Huom. Jos tätä halutaan hyödyntää, kannattanee muuttaa Transmission Wrapper Send Message Payload wrapperiksi Application Level Acknowledgement (MCCI_MT00300UV01). Näin tämä interaktio toimisi sovellustason kuittauksena ja siis myös kuittauksena pyyntöön. Trigger Event Slot Revision Rejection PRSC_TE Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT700201UV01 Message Type Slot Status Revision PRSC_MT Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Appointment Cancel Request by Slot (PRSC_IN040201FI01) Tämä interaktio on määritelty SAVissa. Pyyntö perua ajanvaraus Slot kohtaisesti. Peruminen voi kohdistua yksittäiseen palvelutuotteeseen, joka on osa toimittajan ajanvaraustunnuksella yksilöitävää ajanvarauskokonaisuutta. Interaktion PRSC_IN040201FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040201FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040201FIExample perumispyynnöstä tiedostosta examplexml\ PRSC_IN040201FIExample.xml. Trigger Event Appointment Cancellation Request by PRSC_TE050100FI01 Slot Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment by Slot PRSC_MT030301FI01 Receiver Responsibilities SerAPI projekti 77

78 Reason Trigger Event Interaction PRSC_TE050200FI01 PRSC_IN040202FI01 PRSC_TE050300FI01 PRSC_IN040203FI01 Sending and Receiving Roles Sender Slot Requester PRSC_AR Receiver Slot Request Confirmer PRSC_AR Appointment Cancel Confirmation by Slot (PRSC_IN FI01) Tämä interaktio on määritelty SAVissa. Hyväksyvä vastaus Slot kohtaiseen perumispyyntöön. Interaktion PRSC_IN040202FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040202FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040202FIExample perumispyynnön hyväksyvästä vastauksesta tiedostosta examplexml\ PRSC_IN040202FIExample.xml. Trigger Event Appointment Cancellation Confirmation PRSC_TE050200FI01 by Slot Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment by Slot PRSC_MT030301FI01 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Appointment Cancel Rejection by Slot (PRSC_IN040203FI01) Tämä interaktio on määritelty SAVissa. Hylkäävä vastaus Slot kohtaiseen perumispyyntöön. Interaktion PRSC_IN040203FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040203FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040203FIExample perumispyynnön hylkäävästä vastauksesta tiedostosta examplexml\ PRSC_IN040203FIExample.xml. Hylkäävässä vastauksessa syy ilmoitetaan ControlAct wrapperin reasonof elementissä (ks. liite 3 ja kpl 7.3). Lisäksi voidaan liittää mukaan koko tehty perumispyyntö. Trigger Event Appointment Cancellation Rejection by PRSC_TE050300FI01 Slot Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Cancel Appointment by Slot PRSC_MT030301FI01 78 SerAPI projekti

79 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Appointment Reschedule Request by Slot (PRSC_IN040301FI01) Tämä interaktio on määritelty SAVissa. Slot kohtainen ajanvarauksen siirtämispyyntö. Tällä interaktiolla voidaan ainoastaan siirtää aikaa. Jos ajan siirtäminen vaatii myös palvelutuotteen vaihtamisen, on käytettävä Appointment Revise Request by Slot interaktiota (ks. kappale ). Interaktion PRSC_IN040301FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040301FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040301FIExample siirtämispyynnöstä tiedostosta examplexml\ PRSC_IN040301FIExample.xml. Trigger Event Appointment Reschedule Request by Slot PRSC_TE050400FI01 Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Reschedule Appoinment by Slot PRSC_MT030401FI01 Receiver Responsibilities Reason Trigger Event Interaction PRSC_TE050500FI01 PRSC_IN040302FI01 PRSC_TE050600FI01 PRSC_IN040303FI01 Sending and Receiving Roles Sender Slot Requester PRSC_AR Receiver Slot Request Confirmer PRSC_AR Appointment Reschedule Confirmation by Slot (PRSC_IN040302FI01) Tämä interaktio on määritelty SAVissa. Hyväksyvä vastaus Slot kohtaiseen ajanvarauksen siirtämispyyntöön. Interaktion PRSC_IN040302FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040302FI01.xsd. Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040302FIExample siirtämispyynnön hyväksyvästä vastauksesta tiedostosta examplexml\ PRSC_IN040302FIExample.xml. Trigger Event Appointment Reschedule Confirmation by PRSC_TE050500FI01 Slot Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Reschedule Appoinment by Slot PRSC_MT030401FI01 Sending and Receiving Roles SerAPI projekti 79

80 Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Appointment Reschedule Rejection by Slot (PRSC_IN040303FI01) Tämä interaktio on määritelty SAVissa. Hyväksyvä vastaus Slot kohtaiseen ajanvarauksen siirtämispyyntöön. Interaktion PRSC_IN040303FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040303FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040303FIExample siirtämispyynnön hylkäävästä vastauksesta tiedostosta examplexml\ PRSC_IN040303FIExample.xml. Hylkäävässä vastauksessa syy ilmoitetaan ControlAct wrapperin reasonof elementissä (ks. liite 3 ja kpl 7.3). Lisäksi voidaan liittää mukaan koko tehty siirtämispyyntö. Tietosisältö on tällöin sama kuin siirtämispyynnössäkin (Reschedule Appointment by Slot, PRSC_MT030401FI01). Trigger Event Appointment Reschedule Rejection by PRSC_TE050600FI01 Slot Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Reschedule Appoinment by Slot PRSC_MT030401FI01 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Appointment Revise Request by Slot (PRSC_IN040401FI01) Tämä interaktio on määritelty SAVissa. Slot kohtainen ajanvarauksen muokkaamispyyntö. Interaktion PRSC_IN040401FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040401FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040401FIExample muokkaamispyynnöstä tiedostosta examplexml\ PRSC_IN040401FIExample.xml. Trigger Event Appointment Revision Request by Slot PRSC_TE050700FI01 Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Revise Appointment by Slot PRSC_MT030501FI01 Receiver Responsibilities Reason Trigger Event Interaction PRSC_TE050800FI01 PRSC_IN040402FI01 PRSC_TE050900FI01 PRSC_IN040403FI01 80 SerAPI projekti

81 Sending and Receiving Roles Sender Slot Requester PRSC_AR Receiver Slot Request Confirmer PRSC_AR Appointment Revise Confirmation by Slot (PRSC_IN040402FI01) Tämä interaktio on määritelty SAVissa. Hyväksyvä vastaus Slot kohtaiseen ajanvarauksen muokkaamispyyntöön. Interaktion PRSC_IN040402FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040402FI01.xsd. Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040402FIExample muokkaamispyynnön hyväksyvästä vastauksesta tiedostosta examplexml\ PRSC_IN040402FIExample.xml. Trigger Event Appointment Revision Confirmation by PRSC_TE050800FI01 Slot Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Revise Appointment by Slot PRSC_MT030501FI01 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR Appointment Revise Rejection by Slot (PRSC_IN040403FI01) Tämä interaktio on määritelty SAVissa. Hylkäävä vastaus Slot kohtaiseen ajanvarauksen muokkaamispyyntöön. Interaktion PRSC_IN040403FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040403FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040403FIExample muokkaamispyynnön hyväksyvästä vastauksesta tiedostosta examplexml\ PRSC_IN040403FIExample.xml. Hylkäävässä vastauksessa syy ilmoitetaan ControlAct wrapperin reasonof elementissä (ks. liite 3 ja kpl 7.3). Lisäksi voidaan liittää mukaan koko tehty muokkauspyyntö. Tietosisältö on tällöin sama kuin muokkauspyynnössäkin (Reschedule Appointment by Slot, PRSC_MT030501FI01). Trigger Event Appointment Revision Rejection by Slot PRSC_TE050900FI01 Transmission Wrapper Application Level Acknowledgement MCCI_MT000300UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Revise Appointment by Slot PRSC_MT030501FI01 Sending and Receiving Roles Sender Slot Request Confirmer PRSC_AR Receiver Slot Requester PRSC_AR SerAPI projekti 81

82 Appointment Status Revise Notification by Slot (PRSC_IN40404FI01) Jos ilmoituksessa ajanvarauksen tilan muutoksista on oltava mukana myös ajanvarauksen tiedot, tällöin Slot Status Revision Notification ei ole riittävä. Interaktion PRSC_IN040404FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ PRSC_IN040404FI01.xsd Samasta zip paketista löytyy SOAP viestiesimerkki PRSC_IN040404FIExample ilmoituksesta ajanvarauksen tilan muutoksista tiedostosta examplexml\ PRSC_IN040404FIExample.xml. Trigger Event Appointment Status Revision Notification PRSC_TE40500FI01 by Slot Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Trigger Event Control Act MCAI_MT705201UV01 Message Type Revise Appointment by Slot PRSC_MT030501FI01 Sending and Receiving Roles Sender Slot Informer PRSC_AR Receiver Slot Tracker PRSC_AR SerAPI projekti

83 5 Ajanvaraussovellusalueen Slot kohtaiset kyselyt Tässä luvussa kuvataan aikojen kyselyjen (vapaat/varatut) ja niiden vastausten sanomankuvaukset (HMD) ja interaktiot. Kyselyjä ei ole mukana HL7v3 Scheduling sovellusalueessa, joten kyselyt ovat määritelty SAVissa. Kyselyt on muodostettu käyttämällä HL7v3 kyselyrakenteita, joten ne ovat HL7v3 mukaisia. Poiketen edellisestä luvusta, kyselyistä kuvataan tarkemmin myös kyselyjen kontrollikehyksien sanomankuvaukset, sillä kontrollikehys sisältää SAVissa määriteltyjä tietoja. Lisäksi kyselyissä ei käytetä payloadia vaan sen tilalla on kyselyn parametrilista. Kyselyviesteissä ajanvarauskyselyn suorittajan, kyselevän palveluyksikön ja rekisterinpitäjän tiedot ovat kontrollikehyksessä, sillä ne eivät ole mukana kyselyjen parametrilistassa (eivätkä näin ole kyselyn sisältöön vaikuttavaa tietoa). Aikojen kyselyihin liittyvät tietosisällöt on määritelty dokumentin "Ajanvarausrajapinnat Tekniikkariippumaton liittymä määrittely, v1" kappaleissa Vapaiden aikojen kysely ja Varattujen aikojen kysely. 5.1 Kyselyn rakenne HL7v3:ssa HL7v3 kyselyä ja sen kontrollikehystä on kuvattu "Open CDA 2006 HL7 V3 Messaging implementointi v " dokumentissa (OpenCDA 2006). HL7v3 kyselyt muodostuvat kuten normaalitkin sanomat siirtokehyksestä ja kontrollikehyksestä. Vapaiden ja varattujen aikojen kyselyssä käytetään parametri tyyppisen kyselyn kontrollikehystä (Query Specification Control Act: ParameterList as Stub) ja kyselyparametrit ilmaistaan parametrilistassa (ParameterList) (kuva 8). Siirtokehys (Send Message Payload) Kontrollikehys (Query Specification Control Act: ParameterList as Stub) Parametrilista (ParameterList) Kuva 8. Kyselyn sanomarakenne Aikojen kyselyn siirtokehys (Send Message Payload) Aikojen kyselyissä käytetään samaa Send Message Payload siirtokehystä kuin ajanvarauksen pyynnöissäkin. Siirtokehys on kuvattu liitteessä 1. SerAPI projekti 83

84 5.1.2 Aikojen kyselyn kontrollikehys (Query Control Act Request : ParameterList As Stub, QUQI_HD020000FI01) Aikojen kyselyt tapahtuvat parametrilistan avulla. Näin kyselyissä käytetään kontrollikehystä Query Control Act Request: ParameterList. Alla olevassa kuvassa (kuva 9) on RMIM malli kontrollikehyksestä, jossa käytetään parametrilistaa. Kuva 9. Kyselyn kontrollikehyksen RMIM tietomalli. Alla on kuvattu RMIM mallista johdettu kontrollikehyksen sanomankuvaus. Sanomankuvaukseen on liitetty SAV tiedot. OpenCDA implementointiohjeessa (OpenCDA 2006) on kuvattu muutkin sanomankuvauksesta löytyvät kentät, joita SAVissa ei hyödynnetä. Tätä kontrollikehystä käytetään sekä vapaiden että varattujen aikojen kyselyssä. Taulukko 9. Aikojen kyselyn kontrollikehyksen sanomankuvaus. SAV tiedot (lihavoitu taulukkoon) Nro HL7v3 elementi Pakollisuus Taulukossa olevat classcode, moodcode, typecodeja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Query Control Act Request: ParameterList QUQI_HD020000FI01 1 ControlActProcess classcode 1..1 "CACT" 3 moodcode 1..1 "EVN" 4 id 0..* 5 code text effectivetime prioritycode 0..* 9 reasoncode 0..* 10 languagecode overseer 0..* 84 SerAPI projekti

85 12 typecode contextcontrolcode notetext time modecode signaturecode signaturetext assignedperson authororperformer 0..* Kyselyn suorittaja, rekisterinpitäjä ja kyselevä palveluyksikkö (participation) 21 typecode 1..1 "AUT" 22 contextcontrolcode notetext time modecode signaturecode signaturetext 0..1 Tällä rakenteella voidaan ilmaista useita authorparticipation:eita: Kyselyn suorittaja, rekisterinpitäjä ja kyselevä palveluyksikkö 28 participationchoice choice types in participationchoice SAV muutos, tässä sanomankuvauksessa ei ole valmiina rekisterinpitäjän / kyselevän palveluyksikön tietoja vaan ainoastaan suorittajan tiedot (ja laitteen) tiedot. SAVissa tähän lisätään myös organisaatiota kuvaava CMET. Rekisterinpitäjä ja/tai kyselevä palveluyksikkö SAV lisäys, ei ole valmiina tässä sanomankuvauksessa CMET organisaation tiedoille: R_AssignedOrganization identified COCT_MT090201UV01 29 assignedorganization.. Tämä CMET on kuvattu erikseen kappaleessa 6.3. Jos kyselevän palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään authoror Performer participationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganisation. Nämä erotetaan assignedorganisation roolissa olevalla code elementillä. Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan yksilöidä, kumpi on kyseessä. Kyselyn suorittaja CMET kyselyn suorittajan tiedoille: 30 assignedperson.. assigneddevice R_AssignedPerson universal COCT_MT090100UV01. Tämä CMET on kuvattu erikseen kappaleessa 6.2. R_AssignedDeviceUniversal Ei määritelty SAV tietosisältöihin. SerAPI projekti 85

86 31 end contents of participationchoice 31 dataenterer 0..* 32 typecode contextcontrolcode time assignedperson informationrecipient 0..* 37 typecode contextcontrolcode time assignedperson reasonof 0..* 42 typecode contextconductionind detectedissueevent querybyparameter 0..1 Kysellään parametrilistan avulla 46 queryid 0..1 Kyselyn tunniste, jolla jatkokyselyjen tulokset yhdistetään alkuperäiseen kyselyyn voidaan. Jos tätä käytetään jo kyselyssä, antaa kyselyn lähettäjä tähän tunnisteen. "NEW" 47 statuscode modifycode responseelementgroupid 0..* 50 responsemodalitycode responseprioritycode initialquantity initialquantitycode executionanddeliverytime parameterlist 1..* 56 sortcontrol 0..* 57 sequencenumber elementname directioncode referencedconsent 0..1 Tälle ballotissa koodisto QueryStatusCode, arvoilla: aborted, deliveredresponse, executing, new, waitcontinuedqueryresponse Kyselyssä palautettavien vastausten enimmäismäärä Parametrilista Parametrilista kuvattu tämän taulukon alla olevassa taulukossa. Tänne voidaan ilmoittaa, millä tavoin lajiteltuna ajat pitää palauttaa. SortControl rakenteen tärkeysjärjestys, ts. missä järjestyksessä SortControl rakenteita tulisi soveltaa vastausta koostettaessa jos rakenteita on määritelty useampi yhdelle kyselylle RIM elementin tunniste, jonka mukaan vastaus lajitellaan. Esim. jos haetaan palvelutuotteen perusteella, niin tähän palvelutuotteen tunnus (Schedule.id) Lajittelujärjestys Oletusarvona nouseva järjestys, eli koodi A Tälle ballotissa koodisto Sequencing, arvoilla: A = Ascending, Ascending sequence order D = Descending, Descending sequence order. N = None, No enforced sequence order. ActRelationship suostumus Actiin SAV lisäys, ei ole valmiina tässä sanomankuvauksessa. Jos tämä actrelationship olemassa, on myös 86 SerAPI projekti

87 suostumus olemassa. Lisäksi suostumusta voidaan tarkentaa text elementissä tai antamalla suostumuksen tunniste id elementissä. ActRelationShip ja Act luokkien lisäys kyselyjen kontrollikehyksen RMIM malliin. 60 typecode 1..1 "REFR" Suostumus 61 consent 1..1 (act) 62 classcode 1..1 "ACT" 63 moodcode 1..1 "EVN" 64 id 0..1 Suostumuksen tunniste 65 text 0..1 Vapaamuotoista tekstiä Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) QUQI_MT020001UV01 Sanomatyypin (Message Type) XML skeema QUQI_MT020001UV01.xsd löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\quqi_mt020001uv01.xsd. Huom. skeema on ballotin skeema, tästä puuttuu SAV lisäykset organisaatiolle. Samasta zip paketista löytyy SOAP esimerkki sanomatyypin käytöstä vapaiden aikojen kyselyinteraktio esimerkistä examplexml/qusc_in040101fiexample.xml 5.2 Kyselyn vastauksen rakenne HL7v3:ssa HL7v3 kyselyn vastausta ja sen kontrollikehystä on kuvattu "Open CDA 2006 HL7 V3 Messaging implementointi v " dokumentissa (OpenCDA 2006). HL7v3 kyselyjen vastaukset muodostuvat kuten normaalitkin sanomat siirtokehyksestä, kontrollikehyksestä ja domain kohtaisesti määriteltävästä sanomasta (payload) (kuva 10). Siirtokehys (Application Level Acknowledgement) Kontrollikehys (Query Control Act Response) Vastaussanoma (Payload) Kuva 10. Kyselyn vastauksen sanomarakenne Aikojen kyselyn vastauksen siirtokehys (Application Level Acknowledgement) Aikojen kyselyn vastauksissa käytetään samaa Application Level Acknowledgement siirtokehystä kuin ajanvarauksen pyyntöjen vastauksissa. Kyselyn vastaus on näin myös sovellustason kuittaus varsinaiseen kyselyyn. Siirtokehys on kuvattu liitteessä 2. SerAPI projekti 87

88 5.2.2 Aikojen kyselyn vastauksen kontrollikehys (Query Control Act Response / Acknowledgement, QUQI_HD120000UV01) Aikojen kyselyn vastaukset käyttävät kontrollikehystä Query Control Act Response / Acknowledgement. Alla olevassa kuvassa 11 on RMIM malli kyselyn vastauksen kontrollikehyksestä. Query Response/Acknowledgement kontrollikehyksen avulla kyselyyn vastaaja välittää vastaukset ja siihen liittyvät metatiedot. Kuva 11. Kyselyn vastauksen kontrollikehyksen RMIM malli. Alla on kuvattu RMIM mallista johdettu kontrollikehyksen sanomankuvaus. Sanomankuvaukseen on liitetty SAV tiedot. OpenCDA implementointiohjeessa (OpenCDA 2006) on kuvattu muutkin sanomankuvauksesta löytyvät kentät, joita SAVissa ei hyödynnetä. Tätä kyselyn vastauksen kontrollikehystä käytetään sekä vapaiden että varattujen aikojen kyselyn vastaukseen. Taulukko 10. Aikojen kyselyn vastauksen kontrollikehyksen sanomankuvaus. SAV tiedot (lihavoitu taulukkoon) Nro HL7v3 elementti Pakollisuus Taulukossa olevat classcode, moodcode, typecodeja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Query Control Act Response/Acknowledgement QUQI_HD120000UV01 1 ControlActProcess classcode 1..1 "CACT" 3 moodcode 1..1 "EVN" 4 id 0..* 5 code SerAPI projekti

89 6 text effectivetime prioritycode 0..* 9 reasoncode 0..* 10 languagecode overseer 0..* 12 typecode contextcontrolcode notetext time modecode signaturecode signaturetext assignedperson authororperformer 0..* 21 typecode contextcontrolcode notetext time modecode signaturecode signaturetext participationchoice choice types in participationchoice 29 R_AssignedDeviceUniversal.. 30 R_AssignedPersonUniversal.. 31 end contents of participationchoice 31 dataenterer 0..* 32 typecode contextcontrolcode time assignedperson informationrecipient 0..* 37 typecode contextcontrolcode time assignedperson subject 0..* Subject suhde (actrelationship) linkittää domain kohtaisesti määriteltävän varsinaisen vastauksen kontrollikehykseen. Vapaiden ja varattujen aikojen kyselyn osalta nämä on kuvattu alla omissa alikappaleissaan. 42 typecode 1..1 "SUBJ" 43 contextconductionind 1..1 "false" 44 act 1..1 Tähän tulee itse domain kohtainen vastaus. 45 reasonof 0..* 46 typecode contextconductionind detectedissueevent 1..1 Kyselyvastaukseen liittyviä kuvailutietoja 49 queryack queryid 0..1 Näitä ei ole määritelty SAV tiedoissa, nämä ovat sovellustason vastauskoodeja. Kyselyn lähettäjän kyselylle antama tunniste (jos annettu jo kyselyssä) tai kyselyyn vastaajan kyselylle antama tunniste (vastauksen yhteydes SerAPI projekti 89

90 sä). 51 statuscode 0..1 Kyselyyn vastaajan annettava/palautettava tämä tunniste, jos kyselyyn on mahdollista pyytää lisävastauksia. Kyselyn vastauskoodi 52 queryresponsecode 1..1 AE sovellusvirhe NF yhtään vastausta ei löytynyt kyselyyn OK yksi tai useampi vastaus löytyi kyselyyn QE kyselyn parametreissa oli virhe 53 resulttotalquantity 0..1 Kyselyyn löytyneiden vastausten kokonaislukumäärä 54 resultcurrentquantity 0..1 Tässä vastaussanomassa ilmoitettujen vastausten lukumäärä 55 resultremainingquantity 0..1 Vielä palauttamattomien vastausten lukumäärä 56 querybyparameter 0..1 Tällä luokalla voidaan tarvittaessa ilmaista myös vastauksessa alkuperäinen kysely Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) QUQI_MT120001UV01 Sanomatyypin (Message Type) XML skeema QUQI_MT120001UV01.xsd löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\quqi_mt120001uv01.xsd. Samasta zip paketista löytyy SOAP esimerkki sanomatyypin käytöstä vapaiden aikojen kyselyn vastausinteraktio esimerkistä examplexml/qusc_in040102fiexample.xml. 5.3 Aikojen lisävastauksien kysely/aloitetun kyselyn lopettaminen HL7v3:ssa HL7v3:ssa on kuvattu mahdollisuus liittää kyselyihin lisävastausten kysely. Tätä käytetään esim. tilanteessa, jossa on määritelty palautettavien vastaus määrä ja halutaan kuitenkin selvittää myös jäljelle jääneitä vastauksia. Lisäksi tällä samalla rakenteelle voidaan lopettaa tehty kysely. Aikojen lisävastausten kyselyä/aloitetun kyselyn lopettamista ja tässä tilanteessa käytettävää kontrollikehystä on kuvattu "Open CDA 2006 HL7 V3 Messaging implementointi v " dokumentissa (OpenCDA 2006). HL7v3 aikojen lisävastauksien kysely/aloitetun kyselyn lopettaminen muodostuu kuten normaalitkin sanomat siirtokehyksestä ja kontrollikehyksestä mutta sanoman payload osaa ei ole eikä myöskään kyselyitä vastaavaa parametrilistaa. Käytettävä kontrollikehys on Query Control Act Request Continuation / Cancellation (kuva 12). Kuva 12. Lisävastausten kysely/kyselyn lopettamisen sanomarakenne. Siirtokehys (Send Message Payload) Kontrollikehys (Query Specification Control Act: ParameterList as Stub) 90 SerAPI projekti

91 5.3.1 Aikojen lisävastauksien kyselyn/aloitetun kyselyn lopettamisen siirtokehys (Send Message Payload) Aikojen lisävastauksien kyselyssä/aloitetun kyselyn lopettamisessa käytetään samaa Send Message Payload siirtokehystä kuin ajanvarauksen pyynnöissäkin. Siirtokehys on kuvattu liitteessä Aikojen lisävastausten kyselyn/aloitetun kyselyn lopettamisen kontrollikehys (Query Control Act Request Continuation / Cancellation, QU QI_HD000001UV01) Alla olevassa kuvassa 13 on RMIM malli aikojen lisävastausten kyselyn/aloitetun kyselyn lopettamisen kontrollikehyksestä. Query Continuation/Cancel kontrollikehyksen avulla kyselyn alkuperäinen tekijä voi joko ilmoittaa haluavansa vielä palauttamattomia lisävastauksia tai lopettaa aloitetun kyselyn, jolloin palauttamattomat lisävastaukset hylätään. Kuva 13. Aikojen kyselyn lisävastausten pyytämisen/aloitetun kyselyn lopettamisen kontrollikehyksen RMIM malli. Alla on kuvattu RMIM mallista johdettu kontrollikehyksen sanomankuvaus. Tätä sanomankuvausta käytetään aikojen kyselyn lisävastausten pyytämiseen/aloitetun kyselyn lopettamiseen Taulukko 11. Aikojen kyselyn lisävastausten/aloitetun kyselyn lopettamisen sanomankuvaus. SAV tiedot (lihavoitu taulukkoon) Nro HL7v3 elementti Pakollisuus Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAVtietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista Query Control Act Request Continuation / Cancellation Control Act QUQI_HD000001UV01 1 ControlActProcess classcode 1..1 "CACT" SerAPI projekti 91

92 3 moodcode 1..1 "EVN" 4 id 0..* 5 code text effectivetime prioritycode 0..* 9 reasoncode 0..* 10 languagecode overseer 0..* 12 typecode contextcontrolcode notetext time modecode signaturecode signaturetext assignedperson authororperformer 0..* 21 typecode contextcontrolcode notetext time modecode signaturecode signaturetext participationchoice choice types in participationchoice 29 R_AssignedDeviceUniversal.. 30 R_AssignedPersonUniversal.. 31 end contents of participationchoice 31 dataenterer 0..* 32 typecode contextcontrolcode time assignedperson informationrecipient 0..* 37 typecode contextcontrolcode time assignedperson reasonof 0..* 42 typecode contextconductionind detectedissueevent querycontinuation 1..1 Kyselysanoman tunniste 46 queryid 0..1 Kyselyyn vastaaja voi yhdistää tunnisteen perusteella vastauksen alkuperäiseen kyselyyn Mistä lähtien palautetaan 47 startresultnumber continuationquantity 0..1 Lisävastausten koostamisessa mahdollisesti tarvittava metatieto, mistä lähtien vastauksia palautetaan Montako vastausta palautetaan Lisävastausten koostamisessa mahdollisesti 92 SerAPI projekti

93 tarvittava metatieto, montako vastausta palautetaan seuraavaksi. Jos arvona on 0, niin pyydetään kyselyn keskeyttämistä. Perutaanko/kysytäänkö lisää 49 statuscode 1..1 aborted kysely on peruutettu waitcontinuedqueryresponse lisävastauksia odotetaan Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) QUQI_MT000001UV01 Sanomatyypin (Message Type) XML skeema QUQI_MT000001UV01.xsd löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\quqi_mt000001uv01.xsd. Samasta zip paketista löytyy SOAP esimerkki sanomatyypin käytöstä vapaiden aikojen kyselyn vastausinteraktio esimerkistä examplexml/ QUSC_IN040105FIExample2.xml. Tähän liittyvä kysely ja vastaus ovat esimerkeissä QUSC_IN040101FIExample2.xml ja QUSC_IN040102FIExample2.xml 5.4 Kyselyjen sovellusroolit Seuraavia sovellusrooleja ei löydy ballot paketista, nämä on määritelty SAVissa: Slot Inquirer (QUSC_AR040101FI) Tässä sovellusroolissa sovellus tekee kyselyitä vapaista ja varatuista ajoista ajanvaraussovellukselle Slot kohtaisesti. Slot Query Responder (QUSC_AR040102FI) Tässä sovellusroolissa ajanvaraussovellus vastaa kyselyn tehneen sovelluksen vapaiden ja varattujen aikojen kyselyihin. 5.5 Kyselyjen käynnistävät liipaisintapahtumat (Trigger Events) SAVissa määriteltävät puuttuvat kyselyiden liipaisintapahtumat: Query Available Slots by Resource (QUSC_TE040101FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Query Available Slots by Resource (QUSC_IN040101FI01) Sovellus kyselee ajanvaraussovellukselta vapaita aikoja. Response Available Slots by Resource (QUSC_TE040102FI01) Interaktioon Query Available Slots by Resource (QUSC_TE040101FI01) perustuva. Käynnistää interaktion Response Available Slots by Resource (QUSC_IN040102FI01) Ajanvaraussovellus vastaa vapaiden aikojen kyselyyn. Query Appointments by Slot (QUSC_TE040103FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Query Appointments by Slot (QUSC_IN040103FI01) Sovellus kyselee ajanvaraussovellukselta varattuja aikoja. SerAPI projekti 93

94 Response Appointments by Slot (QUSC_TE040104FI01) Interaktioon Query Appointments by Slots (QUSC_TE040104FI01) perustuva. Käynnistää interaktion Response Appointments by Slot (QUSC_IN040104FI01) Ajanvaraussovellus vastaa varattujen aikojen kyselyyn. Request Continuation/Cancellation (QUSC_TE040105FI01) Käyttäjän toimeen perustuva. Käynnistää interaktion Request Continuation/Cancellation (QUSC_IN040105FI01) Sovellus kyselee ajanvaraukselta lisävastauksia tilanteessa, jossa vain tietty osa vastauksista palautettu varsinaisen kyselyn vastauksessa. Tällä interaktiolla voidaan tarvittaessa myös perua tehty kysely. 5.6 Parametrilistojen hierarkkiset sanomankuvaukset (HMD:t) Tässä kappaleessa on kuvattu kyselyiden parametrilistojen hierarkkiset sanomankuvaukset. Sekä vapaiden aikojen että varattujen aikojen kyselyille on määritelty omat sanomankuvauksensa, tämä sen vuoksi, että tulevaisuudessa näiden parametrilistat saattava poiketa toisistaan. Parametrilistojen sanomankuvauksissa on pyritty käyttämään RIM attribuutteja mutta muutamia poikkeuksia on kuitenkin jouduttu tekemään Query Available Slots by Resource ParameterList (QUSC_MT040101FI01) Alla olevaa SAVissa määriteltyä parametrilistan sanomankuvausta käytetään vapaiden aikojen kyselyssä. Vapaiden aikojen kyselyssä järjestelmälle, joka hallinnoi useita palvelutuotteita, on yleensä yksilöitävä ainakin palvelutuote tai tuoteluokka. Taulukko 12. Vapaiden aikojen kyselyjen parametrilistan sanomankuvaus. Nro Elementti Pakollisuus Query Available Slots by Resource ParameterList, QUSC_MT040101FI01 1 ParameterList Schedule.id 1..* Kyseltävän palvelutuoteluokan/palvelutuotteen tunnus Vapaiden aikojen kyselyssä Id on pakollinen. Mahdollisuus kysyä yhdellä kyselyllä useampien palvelutuotteiden aikoja. Kyseltävän resurssin tyyppi Onko kyseessä palvelutuoteluokka vai palvelutuote. 3 Schedule.code slotduration 0..* SAVissa määritelty koodisto Kyseltävä kohde ajanvarauskyselyssä: OID: Koodiston sisältö: Palvelutuote 1 Palvelutuoteluokka 2 Kesto minuutteina 94 SerAPI projekti

95 Tämä ei ole RIM attribuutti vaan itse määritelty. 5 ResourceSlot.effectiveTime 0..* Päivämääräväli Aikaväli, johon haku kohdistuu 6 timeperiod 0..* Ilmaistaan merkkijonona HHMM HHMM Tämä ei ole RIM attribuutti vaan itse määritelty. Asiakkaan tunniste (hetu) 7 Patient.id Place.id Person.id 0..1 Saatetaan tarvita parametrina myös vapaiden aikojen kyselyssä, jos halutaan rajata mitä palveluita tietylle asiakkaalle tarjotaan Paikkaa yksilöivä tunniste Esim. toimipiste/yksikkö. Voidaan käyttää tarvittaessa palvelutuotteen/palvelutuoteluokan lisärajauksena. Henkilön yksilöivä tunniste Ajanvaraukseen liittyvä henkilö. Käytetään tarvittaessa palvelutuotteen/palvelutuoteluokan lisärajauksena. Henkilön sukupuoli 10 Person. administrativegendercode 0..1 Ajanvaraukseen liittyvän henkilön sukupuoli. Käytetään tarvittaessa palvelutuoteluokan tai palvelutuotteen lisärajauksena, esim. jos halutaan vain aikoja tiettyä sukupuolta olevalle ammattilaiselle. Tässä käytetään HL7 koodistoa Henkilön sukupuoli : OID: Koodiston sisältö: mies 1 nainen 2 ei tiedossa/määriteltävissä 3 Rooli organisaatiossa Ajanvaraukseen liittyvän henkilön rooli organisaatiossa (esim. hoitaja. lääkäri jne.). Käytetään tarvittaessa palvelutuotteen/palvelutuoteluokan lisärajauksena. Tietotyypiksi CV. Tässä voidaan käyttää esim. koodistoa Hoitoon pääsy PTH ammattiryhmät: OID: AssignedPerson.code 0..1 Koodiston sisältö: Lääkärit A1 Lääkäri A10 Erikoislääkäri A12 Hoitajat A2 Sairaanhoitaja A20 Terveydenhoitaja A21 Perushoitaja, lähihoitaja A22 Terveyskeskusavustaja A23 Lääkintävahtimestari A24 Kodinhoitaja, kotipalvelutyöntekijä A25 laboratoriohoitaja A26 röntgenhoitaja A27 Erityistyöntekijät A3 Psykologi A30 Puheterapeutti A31 Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) SerAPI projekti 95

96 QUSC_MT040101FI01 Sanomatyypin (Message Type) QUSC_MT040101FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ QUSC_MT040101FI01.xsd. Samasta zip paketista löytyy SOAP esimerkki sanomatyypin käytöstä vapaiden aikojen kyselyinteraktio esimerkistä examplexml\ QUSC_IN040101FIExample.xml Query Appointments by Slot ParameterList, QUSC_MT040103FI01 Alla olevaa SAVissa määriteltyä parametrilistan sanomankuvausta käytetään varattujen aikojen kyselyssä. Varattujen aikojen kyselyssä asiakkaan tunnisteen (hetu) esittäminen on pakollista (se voi olla myös ainoa parametri, jos muita rajauksia ei tehdä), jos kysytään asiakkaan varattuja aikoja. Kenttä ei ole kuitenkaan merkitty pakolliseksi, sillä tätä kyselyä voidaan käyttää tulevaisuudessa muuhunkin tarkoitukseen. Tämän vuoksi myös muita parametreja on jätetty myös tähän listaan. Taulukko 13. Varattujen aikojen kyselyjen parametrilistan sanomankuvaus. Nro Elementti Pakollisuus Query Appointments by Slot ParameterList, QUSC_MT040103FI01 1 ParameterList Schedule.id 0..* Kyseltävän palvelutuoteluokan/palvelutuotteen tunnus Varattujen aikojen kyselyssä Id:tä voidaan käyttää rajaamaan hakua. Kyseltävän resurssin tyyppi Onko kyseessä palvelutuoteluokka vai palvelutuote. 3 Schedule.code ResourceSlot.effectiveTime 0..* 5 Patient.id Place.id Person.id 0..1 SAVissa määritelty koodisto Kyseltävä kohde ajanvarauskyselyssä:oid: Koodiston sisältö: Palvelutuote 1 Palvelutuoteluokka 2 Päivämääräväli Voidaan käyttää rajaamaan tietyn aikavälin ajanvaraukset, joihin haku kohdistuu. Asiakkaan tunniste (hetu) Pakollinen, jos kysellään tietyn asiakkaan varattuja aikoja. Paikkaa yksilöivä tunniste Esim. toimipiste/yksikkö. Käytetään tarvittaessa palvelutuotteen/palvelutuoteluokan lisärajauksena. Henkilön yksilöivä tunniste Ajanvaraukseen liittyvä henkilö. Käytetään tarvittaessa palvelutuotteen/palvelutuoteluokan lisärajauksena. (Tämän parametrin avulla mahdollisuus hakea tietylle ammattilaiselle varatut ajat.) Sanomankuvauksesta johdettu interaktioissa käytettävä viesti (Message Type List) QUSC_MT040103FI01 96 SerAPI projekti

97 Sanomatyypin (Message Type) QUSC_MT040103FI01 XML skeema löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ QUSC_MT040103FI01.xsd. Samasta zip paketista löytyy SOAP esimerkki sanomatyypin käytöstä vapaiden aikojen kyselyn vastaus interaktio esimerkistä examplexml\ QUSC_IN040102FIExample.xml. 5.7 Kyselyihin liittyvä interaktiot Query Available Slots by Resource, QUSC_IN040101FI01 Vapaiden aikojen kysely. Interaktion XML skeema QUSC_IN040101FI.xsd löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ QUSC_IN040101FI.xsd Samasta paketista löytyy SOAP viestiesimerkki vapaiden aikojen kyselystä QUSC_IN040101FIExample.xml tiedostosta examplexml\ QUSC_IN040101FIExample.xml Trigger Event Query Available Slots by Resource QUSC_TE040101FI01 Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Query Control Act Request: Parameter List QUQI_MT020000FI01 ks. kappale Message Type Query Available Slots by Resource ParameterList QUSC_MT040101FI01 ks. kappale Receiver Responsibilities Reason Trigger Event Interaction QUSC_TE040102FI01 QUSC_IN040102FI01 Sending and Receiving Roles Sender Slot Inquirer QUSC_AR040101FI Receiver Slot Query Responder QUSC_AR040102FI Response Available Slots by Resource, QUSC_IN040102FI01 Vapaiden aikojen kyselyn vastaus Interaktion XML skeema QUSC_IN040102FI.xsd löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ QUSC_IN040102FI.xsd Samasta paketista löytyy SOAP viestiesimerkki vapaiden aikojen kyselystä QUSC_IN040102FIExample.xml tiedostosta examplexml\ QUSC_IN040102FIExample.xml Trigger Event Response Available Slots by Resource QUSC_TE040102FI01 Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Query Control Act Response / Acknowledgement QUQI_HD120000UV01 ks. kappale Message Type Slot Status Revision PRSC_HD040100FI01 ks. kappale SerAPI projekti 97

98 Sending and Receiving Roles Sender Slot Query Responder QUSC_AR040102FI Receiver Slot Inquirer QUSC_AR040101FI Query Appointments by Slot, QUSC_IN040103FI01 Varattujen aikojen kysely Interaktion XML skeema QUSC_IN040103FI.xsd löytyy HL7v3SchdelulingFIv04.zip paketin tiedostosta xsd\ QUSC_IN040103FI.xsd Trigger Event Query Appointments by Slot QUSC_TE040103FI01 Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Query Control Act Request: Parameter List QUQI_MT020000FI01 ks. kappale Message Type Query Appointments by Slot Parameter List QUSC_MT040103FI01 ks. kappale Receiver Responsibilities Reason Trigger Event Interaction QUSC_TE040104FI01 QUSC_IN040104FI01 Sending and Receiving Roles Sender Slot Inquirer QUSC_AR040101FI Receiver Slot Query Responder QUSC_AR040102FI Response Appointments by Slot, QUSC_IN040104FI01 Vapaiden aikojen kyselyn vastaus Trigger Event Response Appointments by Slot QUSC_TE040104FI01 Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Query Control Act Response / Acknowledgement QUQI_HD120000UV01 ks. kappale Message Type New Appointment by Slot PRSC_HD030200FI01 ks. kappale Sending and Receiving Roles Sender Slot Query Responder QUSC_AR040102FI Receiver Slot Inquirer QUSC_AR040101FI Query Control Act Request Continuation / Cancellation, QUQI_ IN040105FI01 Aikojen kyselyn lisävastausten pyytäminen/aloitetun kyselyn lopettaminen Trigger Event Query Control Act Request Continuation / QUSC_TE040105FI01 Cancellation Transmission Wrapper Send Message Payload MCCI_MT000100UV01 Control Act Wrapper Query Control Act Request Continuation / QUQI_MT000001UV01 98 SerAPI projekti

99 Message Type Cancellation Control Act ks. kappale Receiver Responsibilities Reason Trigger Event Interaction QUSC_TE040102FI01 QUSC_IN040102FI01 QUSC_TE040104FI01 QUSC_IN040104FI01 Sending and Receiving Roles Sender Slot Inquirer QUSC_AR040101FI Receiver Slot Query Responder QUSC_AR040102FI Epäonnistuneen kyselyn vastaus Kyselyn vastausten yhteydessä voi palautua virhetietoja, kun kontrollikehyksen query Ack.queryResponseCode on AE (sovellusvirhe) tai QE (kyselyn parametreissa oli virhe). Jos kyselyyn ei löytynyt yhtään vastausta (NF), virheilmoitusta ei palauteta. Ajanvarausten yleisiä virhetilanteita on käsitelty tämän dokumentin luvussa 7.3. SerAPI projekti 99

100 6 Domainissa käytetyt yleiset viestielementit (CMET) Tässä luvussa on kuvattu ajanvarauksen sanomankuvauksissa käytettävien CMET:ien sanomankuvaukset (Common Message Element). R_Patient identified/confirmable (COCT_MT050002UV04) R_AssignedPersonUniversal (COCT_MT090100UV01). R_AssignedOrganization identified (COCT_MT090201UV01), lisätty käytettäväksi SAVissa R_AssignedOrganization contact (COCT_HD090203UV01), lisätty käytettäväksi SAVissa E_OrganizationUniversal (COCT_MT150000UV02), ei käytetä SAVissa R_ServiceDeliveryLocationUniversal (COCT_MT240000UV01), ei käytetä SAVissa. Tämän luvun sanomankuvauksiin on liitetty SAV vaatimuksissa esitetyt näihin CMETien sanomankuvauksiin liittyvät tiedot. Nämä tiedot ovat esitetty taulukossa lihavoituna. Sanomankuvauksissa on mukana myös tiedot, jotka on määritelty HL7v3:ssa kyseisten CMETien sanomankuvauksin ja joita ei ole määritelty SAVissa. 6.1 R_Patient identified/confirmable COCT_HD050002UV04 SAVissa asiakkaan tiedot. Huom. Tästä sanomankuvauksesta puuttuu riskitieto. Tämä CMET tullaan korvaamaan CMETillä R_Patient universal. Tätä ei ole kuitenkaan vielä otettu mukaan tähän dokumentin versioon, sillä XML skeemat ja SOAP esimerkit käyttävät vielä CMETiä R_Patient identified/confirmable. Taulukko 3. Asiakkaan tietojen CMETin sanomankuvaus. SAV tiedot (lihavoitu taulukkoon) Kentän numero HL7v3 elementti Pakollisuus Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista R_Patient identified/confirmable COCT_HD050002UV04 1 Patient 0..1 Asiakas 2 classcode 1..1 HL7v3 tieto, osoittaa että kyseessä on patient tietoja. Vakioarvo "PAT" Potilas tunniste 3 id 1..* Annettava jokin tunniste, vaikka henkilötunnusta ei ole tiedossa. Yhteystiedot 4 addr 0..* 5 patientchoice choice types in patientchoice 6 Person.. 7 classcode 1..1 Tästä CMET:istä puuttuu puhelinnumerotieto, sillä tämä CMET tarkoitettu lähinnä identifioimaan asiakasta (potilasta) HL7v3 tieto, osoittaa että kyseessä on person tietoja. Vakioarvo "PSN" 100 SerAPI projekti

101 8 determinercode 1..1 HL7v3 tieto, osoittaa että kyseessä on identifioitavissa oleva henkilö. Vakioarvo "INSTANCE" Henkilön tunniste 9 id 0..1 Annettava, jokin tunniste, vaikka henkilötunnusta ei ole tiedossa. 10 name 0..* Nimet 11 administrativegendercode birthtime NonPersonLivingSubject.. 14 classcode determinercode id 0..* 17 name 0..* 18 administrativegendercode birthtime end contents of patientchoice 20 providerorganization 0..1 Riskitiedon esittäminen asiakkaan tiedoissa Ajanvaraussovellusalueessa käytetään CMETiä R_Patient identified/confirmable asiakkaan (potilaan) tunnistamiseen. R_Patient identified/confirmable CMET ei pidä sisällään paikkaa riskitiedolle. HL7v3 ajanvaraussovellusalueen tietomallissa on ollut tavoitteena, että välitetään vain ajanvaraukseen suoraan liittyviä tietoja ja muut tiedot pyritään pitämään tunnistetiedon tasolla. Tämän vuoksi käytettävässä R_Patient identified/confirmable CMETissä ei ole suunniteltu välitettävän kuin asiakkaan/potilaan tunnistamiseen liittyvää tietoa. Riskitieto on kuitenkin esitetty yhdeksi vaatimukseksi ajanvarauspyynnön tietosisältöön. Riskitieto saadaan esitettyä vaihtamalla ajanvaraussovellusalueessa nyt käytettävä CMET R_Patient identified/confirmable CMETiksi R_Patient universal. R_Patient universal viittaa puolestaan CMETiin E_LivingSubject, josta löytyy Person luokka ja sieltä desc attribuutti, jossa riskitieto voidaan ilmaista tekstimuodossa. Tämän vaihtoehdon huonona puolena on sen tietosisällön laajuus, jossa tulee jo liikaakin tietoja sekä viittauksia toisiin CMETeihin. Ylipäätään voidaan miettiä, onko ajanvarausviesti oikea paikka esim. riskitiedon välittämiselle vai pitäisikö se saada samaa kautta kuin muutkin kertomustiedot. 6.2 R_AssignedPerson universal (COCT_MT090100UV01) SAVissa suorittaja/muistutuspyynnön kohde. Taulukko 4. Suorittajan/muistutuspyynnön kohteen tietojen sanomankuvaus SAV tiedot (lihavoitu taulukkoon) Kentän numero HL7v3 elementti Pakollisuus Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista R_AssignedPerson universal SerAPI projekti 101

102 1 AssignedPerson 0..1 Ajanvarauksen suorittaja 2 classcode 1..1 "ASSIGNED" 3 id 0..* Tunniste Rooli SAVissa määritelty ajanvarausspesifi koodisto Ajanvaraukseen osallistuvan suorittajan rooli code 0..1 Koodiston sisältö: Ammattilainen/tilaaja 1 Ammattilainen/suorittaja 2 Asiakas 3 Asiakkaan edustaja 4 Jos ammattilainen on sekä tilaaja että suorittaja, käytetään tilaajaa 5 addr 0..* Yhteystiedot: osoitteet 6 telecom 0..* Yhteystiedot: puhelinnumerot, sähköpostiosoitteet 7 effectivetime certificatetext assignedprincipalchoicelist shared by each type in assignedprincipalchoice List 10 asroleother 0..* 11 classcode id 1..* 13 scopingorganization aslicensedentity 0..* 15 classcode id 0..* 17 code effectivetime issuingorganization asmember 0..* 21 classcode id 0..* 23 code addr 0..* 25 telecom 0..* 26 statuscode 0..* 27 effectivetime group classcode determinercode id 0..* 32 code name 0..* 34 desc aslocatedentity languagecommunication 0..* Kielen määrittely 37 languagecode 0..1 Ballotissa tätä varten tyhjä HumanLanguage koodisto. Tähän voidaan käyttää koodistoa 102 SerAPI projekti

103 , TK Kielikoodi Koodiston sisältö: Ks. liite 4. esim. Suomi FI Ruotsi SV Englanti EN Kielen ilmaisun muodot 38 modecode 0..1 HL7v3ssa koodisto LanguageAbilityCode: Expressed signed ESGN Expressed spoken ESP Expressed written EWR Received signed RSGN Received spoken RSP Received written RWR Kommunikointitaito HL7v3ssa koodisto LanguageAbilityProficiency 39 proficiencylevelcode 0..1 Excellent E Fair F Good G Poor P Etusija tietylle kielelle 40 preferenceind 0..1 true/false 41 choice types in assignedprincipalchoicelist 41 Person.. 42 classcode 1..1 "PSN" 43 determinercode 1..1 "INSTANCE" 44 name 1..* Nimet 45 end contents of assignedprincipalchoicelist 45 representedorganization 0..1 Huomioitavaa Ajanvaraustyöpajassa 7.9. nostettiin esiin tarve määritellä kieli, jolla ajanvaraussovelluksen pitäisi palauttaa vastauksia. Kieli voidaan ilmoittaa R_AssignedPerson universal CMETissä. Tämä on hyvä paikka tälle tiedolle, sillä siinä välitetään tieto ajanvarauksen suorittajasta, joka todennäköisesti ottaa myös vastaan vastaukset. Suorittaja voi olla asiakas itse tai sitten ammattilainen. RIMissä voidaan entiteettiin (tässä tapauksessa AssignedPerson CMETiin liittyvään Person elementtiin) liittää LanguageCommunication luokka. Esimerkki: Henkilöllä, joka on tullut alun perin Meksikosta, voi sujuva taito puhua, lukea ja kirjoittaa espanjaa mutta vain perustaidot englannista. LanuageCommunication luokka määrittelee kielet, joilla entiteetti voi kommunikoida, kielen ilmaisun muodon (puhe, luku, kirjoitus), kommunikointitaidon, entiteetin asettama etusija tietylle kielelle. LanguageCommunication luokkaan liittyy seuraavat attribuutit: languagecode: määrittelee kielen o ballotissa tyhjä HumanLanguage koodisto o Person Topicin esimerkkejä: Spanish, Italian, German, English, American sign modecode: kielen ilmaisun muodot, ballotissa koodisto LanguageAbilityCode: o ESGN Expressed signed (viittomakielellä?) o ESP Expressed spoken o EWR Expressed written SerAPI projekti 103

104 o RSGN Received signed (viittomakielellä?) o RSP Received spoken o RWR Received written o expressed/received ero, ei eritelty/selitetty tarkemmin ballotissa proficiencylevelcode: kommunikointitaito, ballotissa koodisto LanguageAbilityProficiency o E Excellent o F Fair o G Good o P Poor preferenceind: etusija tietylle kielelle. o true/false Tätä hyödynnetään seuraavasti: annetaan languagecode attribuutissa kieli, käytetään koodistoa TK kielikoodi preferenceind elementissä arvo true merkiksi siitä, että vastaanottaja haluaa kommunikoitavan annetulla kiellellä. 6.3 R_AssignedOrganization identified (COCT_MT090201UV01) SAVissa rekisterinpitäjä/tilaava palveluyksikkö. Taulukko 5. Rekisterinpitäjän/tilaavan palveluyksikön tietojen sanomankuvaus. SAV tiedot (lihavoitu taulukkoon) Kentän numero HL7v3 elementit Pakollisuus Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista R_AssignedOrganization identified 1 AssignedOrganization 0..1 Tilaava palveluyksikkö 2 classcode 1..1 "ASSIGNED" 3 id 1..* Tunniste Organisaation rooli 4 code 0..1 SAVissa määritelty ajanvarausspesifi koodisto Ajanvaraukseen osallistuvan organisaation rooli Rekisterinpitäjä 1 Tilaava palveluyksikkö 2. Huomioitavaa Jos tilaavan palveluyksikön lisäksi oltava myös rekisterinpitäjä tieto, käytetään authorparticipationia organisaation osalta kahteen kertaan, joissa kummassakin assignedorganization. Nämä erotetaan assignedorganization.code elementillä. Jos molemmat em. ovat sama yksikkö niin, tulee 2 kertaa author, ja codella voidaan yksilöidä, kumpi on kyseessä. 104 SerAPI projekti

105 6.4 R_AssignedOrganization contact (COCT_HD090203UV01) SAVissa toimittajan yhteystieto. Taulukko 6. Toimittajan yhteystietojen sanomankuvaus. SAV tiedot (lihavoitu taulukkoon) Kentän numero HL7v3 elementti Pakollisuus Taulukossa olevat classcode, moodcode, typecode ja determinercode arvot eivät ole SAV tietosisällöistä, ellei erikseen mainittu, vaan ovat otettu mukaan sovellusalueessa niihin käytettävistä arvoista R_AssignedOrganization contact 1 AssignedOrganization classcode 1..1 "ASSIGNED" 3 id 1..* Tunniste 4 code addr 0..* Osoite 6 telecom 0..* Puhelinnro 7 assignedprincipalchoicelist choice types in assignedprincipal ChoiceList 8 Organization.. 9 classcode 1..1 "ORG" 10 determinercode 1..1 "INSTANCE" 11 name 1..* Selkokielinen nimi 12 end contents of assignedprincipal ChoiceList 13 representedorganization 0..1 Käytettävä tätä rakennetta, jos annetaan organisaation selkokielinen nimi 6.5 E_OrganizationUniversal (COCT_MT150000UV02) Ei käytetä SAVissa. HUOM. entiteetin CMET, aiemmat olleet roolien CMETejä. Taulukko 15. E_OrganizationUniversal (COCT_HD150000UV02) Kentän numero HL7v3 elementti E_Organization universal COCT_HD150000UV02 Pakollisuus 1 Organization classcode determinercode id 1..* 5 code name 0..* 7 desc statuscode telecom 0..* 10 addr 0..* 11 standardindustryclasscode 0..1 SerAPI projekti 105

106 12 asorganizationpartof 0..* 13 classcode id 0..* 15 code statuscode 0..* 17 effectivetime wholeorganization contactparty 0..* 20 classcode id 0..* 22 code addr 0..* 24 telecom 0..* 25 contactperson classcode determinercode name 0..* 29 aslocatedentity organizationcontains 0..* 31 classcode id 0..* 33 code statuscode 0..* 35 effectivetime partorganization R_ServiceDeliveryLocation universal (COCT_MT240000UV01) Ei käytetä SAVissa. Taulukko 16. R_ServiceDeliveryLocation universal (COCT_MT240000UV01) Kentän numero HL7v3 elementti R_ServiceDeliveryLocation universal, COCT_HD240000UV01 Pakollisuus 1 ServiceDeliveryLocation classcode id 0..* 4 code addr 0..* 6 telecom 0..* 7 statuscode 0..* 8 effectivetime location serviceproviderorganization SerAPI projekti

107 7 Soveltamisohje alueellisen ajanvarauksen toteuttamiseen Tässä luvussa kuvataan, kuinka SAVin määrittelyn kohteena oleva alueellinen ajanvaraus toteutetaan hyödyntämällä HL7v3:n ajanvaraussovellusaluetta sekä mitä asioita on huomioitava toteutettaessa HL7v3 Web Services profiilia. Luvuissa 2 6 esitetty HL7v3 ajanvaraussovellusalueen lokalisointi on geneerinen ajanvaraussovellusalueen kuvaus. Myös sovellusalueessa olevat lokalisoidut sanomankuvaukset sisältävät sekä luku 5, joka sisältää kyselyrakenteet, sisältävä jo paljon yleisiä soveltamisohjeita. Toiminnallisuus ja tietosisällöt ovat määritelty aiemmin SerAPIssa sekä dokumentoitu seuraaviin dokumentteihin: Ajanvarausrajapinnat vaatimukset ja rajaukset, v1.6 (Tuomainen ym. 2006a). Ajanvarausrajapinnat tekniikkariippumaton määrittely, v1 (Tuomainen ym. 2006b). 7.1 Sovellusroolit Alla olevassa kuvassa (kuva 14) on esitetty HL7v3 ajanvarauksen sovellusroolien vastaavuus ajanvarausrajapintojen tekniikkariippumattomassa määrittelyssä (Tuomainen, ym. 2006b) käytettyihin HL7v2:n suomenkielisiin sovellusrooleihin. Ajanvarauksen tilaaja Appointment Requester (PRSC_AR010200) Ajanvarauksen toimittaja Appointment Confirmer (PRSC_AR010300) Slot Requester (PRSC_AR030200) Slot Request Confirmer (PRSC_AR030101) Ulkopuolinen kiinnostunut taho Appointment Tracker (PRSC_AR020000UV01) Appointment Informer (PRSC_AR010100UV01) Slot Tracker (PRSC_AR030300) Slot Informer (PRSC_AR030100) Kyselijä Appointment Inquirer (?) Appointment Query Responder (?) Slot Inquirer (QUSC_AR040101FI) Slot Query Responder (QUSC_AR040102FI) Kuva 14. HL7v3 ajanvarauksen sovellusroolien vastaavuus tekniikkariippumattomassa määrittelyssä käytettyihin HL7v2:n suomenkielisiin sovellusrooleihin SerAPI projekti 107

108 HL7v3 sovellusroolit sopivat SerAPI dokumenteissa kuvattuihin rooleihin ajanvarausjärjestelmä ja ajanvarauspalvelu alla listatulla tavalla. SAVissa hyödynnetään vain Slot topicia, tämän vuoksi Slot topicin sovellusroolit, joita SAVissa käytetään, ovat lihavoitu. Alueellisen ajanvarauspalvelun roolit: Appointment Requester Slot Requester: alueellinen ajanvaraus suorittaa tässä roolissa uuden ajanvarauksen varauspyyntöjä, perumis, siirtämis ja muokkaamispyyntöjä varsinaiselle ajanvarausjärjestelmälle. Appointment Tracker Slot Tracker: alueellinen ajanvaraus vastaanottaa tässä roolissa ilmoituksia ajanvarausjärjestelmän ilmoittamista vapaista ajoista sekä vapaiden aikojen muuttumisesta ei vapaaksi tai varatun ajan muuttumisesta vapaaksi. Periaatteena SAV määrittelyissä on aluksi että ajanvarauspalvelu ei tallenna varattuja aikoja, vaan ainoastaan vapaita aikoja (näin varatun ajan muuttuminen vapaaksi on käytännössä ilmoitus vapaasta ajasta ajanvarauspalvelun kannalta). Appointment Inquirer Slot Inquirer: alueellinen ajanvaraus kyselee tässä roolissa varsinaiselta ajanvarausjärjestelmältä vapaita ja varattuja aikoja. Ajanvarausjärjestelmän roolit: Appointment Confirmer Slot Request Confirmer: varsinainen ajanvarausjärjestelmä vastaa tässä roolissa alueellisen ajanvarauksen pyyntöihin joko hylkäämällä tai hyväksymällä pyynnöt Appointment Informer Slot Informer: varsinainen ajanvarausjärjestelmä lähettää tässä roolissa ilmoituksia alueelliselle ajanvaraukselle vapaista ajoista (vapaiden aikojen replikointi), vapaan ajan muuttumisesta ei vapaaksi ja varatun ajan muuttumisesta vapaaksi. Appointment Query Responder Slot Query Responder: varsinainen ajanvarausjärjestelmä vastaa tässä roolissa ajanvarauspalvelun lähettämiin kyselyihin 7.2 Toiminnallisuus, toimintojen suhde ja järjestys Tässä kappaleessa yhdistetään ajanvaraussovellusalueessa esitetyt interaktiot eri toimintokokonaisuuksiin ja esitetään toimintojen suhde ja järjestys toisiinsa erilaisissa skenaarioissa. Jokaisesta alla esitettävästä interaktiosta on viittaus kyseisestä interaktiota käsittelevään tämän dokumentin kappaleeseen. Näistä kappaleista (4.6ja 5.7) löytyvät puolestaan tarkemmat tiedot interaktion koostumisesta sekä viittaukset interaktioiden skeemoihin ja SOAP esimerkkeihin Ajan varaaminen, profiili: vapaat ajat selvitetään kyselyllä Kuvassa 15 on esitetty sekvenssikaaviolla ajanvaraamis toiminnallisuus siten, että vapaat ajat selvitetään kyselyllä. Ennen vapaan ajan selvittämistä ja varaamista kysellään mahdolliset varatut ajat. 108 SerAPI projekti

109 Ajanvarauspalvelu Slot Inquirer (QUSC_AR040101FI) Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmä Slot Query Responder (QUSC_AR040102FI) Slot Request Confirmer (PRSC_AR030101) Varattujen aikojen selvittäminen Query Appointments by Slot (QUSC_IN040103FI01) Response Appointments by Slot (QUSC_IN040104FI01)... Vapaiden aikojen selvittäminen Query Available Slots by Resource (QUSC_IN040101FI01) Response Available Slots by Resource (QUSC_IN040102FI01) Ajan varaaminen New Appointment Slot Request (PRSC_IN030101FI01) New Appointment Slot Confirmation (PRSC_IN030102) / New Appointment Slot Rejection (PRSC_IN030103) Kuva 15. Ajan varaaminen, profiili: vapaat ajat selvitetään kyselyllä. Ajanvarauspalvelun roolit: Kyselijä: Slot Inquirer (QUSC_AR040101FI) Tilaaja: Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmän roolit: Kyselyyn vastaaja: Slot Query Responder (QUSC_AR040102FI) Toimittaja: Slot Request Confirmer (PRSC_AR030101) Tässä profiilissa ajanvarauspalveluun ei tallenneta tietoja vapaista ajoista. Näin kun aikaa varataan, pitää ajanvarauspalvelun selvittää ensin vapaita aikoja kyselemällä niitä varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä. Ennen uuden ajan varaamista/selvittämistä ajanvarauspalvelu on voinut selvittää asiakkaalle jo varatut ajat kyselemällä varattuja aikoja varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä interaktiolla Query Appointments by Slot (QUSC_IN040103FI01, ks. kappale 5.7.3). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset asiakkaan varatut ajat vastausinteraktiolla Response Appointments by Slot (QUSC_IN040104FI01, ks. kpl 5.7.4). Näin aikaa varatessa/hoitoa suunniteltaessa voidaan huomioida asiakkaalle aiemmin varatut ajat. Ajanvarauspalvelu kyselee vapaita aikoja ajanvarausjärjestelmältä/ järjestelmiltä vapaiden aikojen kyselyn interaktiolla Query Available Slots by Resource (QUSC_IN040101FI01, ks. kpl 5.7.1). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset vapaat ajat vastausinteraktiolla Response Available Slots by Resource (QUSC_IN040102FI01, ks. kpl 5.7.2). SerAPI projekti 109

110 Kun sopiva aika asiakkaalle on selvitetty, varaa ajanvarauspalvelu kyseisen ajan varsinaiseen ajanvarausjärjestelmään uuden ajan ajanvarauspyyntöinteraktiolla New Appointment Slot Request (PRSC_IN030101FI01, ks. kpl 4.6.1). Varsinainen ajanvarausjärjestelmä palauttaa ajanvarauspalvelulle joko hyväksyvän vastausinteraktion New Appointment Slot Confirmation (PRSC_IN030102, ks. kpl 4.6.2) tai hylkäävän vastausinteraktion New Appointment Slot Rejection (PRSC_IN030103, ks. kpl 4.6.3). Jos ajanvarauspyyntö on hyväksyvä, tallentuu tieto ajanvarauksesta varsinaiseen ajanvarausjärjestelmään Ajan varaaminen, profiili: ajat replikoitu Kuvassa 16 on esitetty sekvenssikaaviolla ajanvaraamis toiminnallisuus siten, että vapaat ajat on replikoitu. Ennen ajan varaamista kysellään mahdolliset varatut ajat. Ajanvarauspalvelu Slot Tracker (PRSC_AR030300) Slot Inquirer (QUSC_AR040101FI) Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmä Slot Informer (PRSC_AR03100) Slot Query Responder (QUSC_AR040102FI) Slot Request Confirmer (PRSC_AR030101) Slot Status Revise Notification (PRSC_IN020400) Vapaiden aikojen ilmoittaminen... Varattujen aikojen selvittäminen Query Appointments by Slot (QUSC_IN040103FI01) Response Appointments by Slot (QUSC_IN040104FI01)... Ajan varaaminen New Appointment Slot Request (PRSC_IN030101FI01) New Appointment Slot Confirmation (PRSC_IN030102) / New Appointment Slot Rejection (PRSC_IN030103) Kuva 16. Ajan varaaminen, profiili: ajat replikoitu. Ajanvarauspalvelun roolit: Ulkopuolinen kiinnostunut taho/ilmoitusten vastaanottaja: Slot Tracker (PRSC_AR030300) Kyselijä: Slot Inquirer (QUSC_AR040101FI) Tilaaja: Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmän roolit: Toimittaja/ilmoituksien lähettäjä: Slot Informer (PRSC_AR03100) Kyselyyn vastaaja: Slot Query Responder(QUSC_AR040102FI) Toimittaja: Slot Request Confirmer (PRSC_AR030101) Tässä profiilissa ajanvarauspalveluun on tallennettu etukäteen tiedot vapaista ajoista. Ajanvarausjärjestelmä/ järjestelmät ilmoittavat ajanvarauspalvelulle vapaita aikoja interaktiolla Slot Status Revise Notification (PRSC_IN020400, ks. kpl 4.6.4). 110 SerAPI projekti

111 Ennen uuden ajan varaamista ajanvarauspalvelu on voinut selvittää asiakkaalle jo varatut ajat kyselemällä varattuja aikoja varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä interaktiolla Query Appointments by Slot (QUSC_IN040103FI01, ks. kappale5.7.3). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset asiakkaan varatut ajat vastausinteraktiolla Response Appointments by Slot (QUSC_IN040104FI01, ks. kpl 5.7.4). Näin aikaa varatessa/hoitoa suunniteltaessa voidaan huomioida asiakkaalle aiemmin varatut ajat. Kun sopiva aika asiakkaalle on selvitetty, varaa ajanvarauspalvelu kyseisen ajan varsinaiseen ajanvarausjärjestelmään uuden ajan ajanvarauspyyntöinteraktiolla New Appointment Slot Request (PRSC_IN030101FI01, ks. kpl 4.6.1). Varsinainen ajanvarausjärjestelmä palauttaa ajanvarauspalvelulle joko hyväksyvän vastausinteraktion New Appointment Slot Confirmation (PRSC_IN030102, ks. kpl 4.6.2) tai hylkäävän vastausinteraktion New Appointment Slot Rejection (PRSC_IN030103, ks. kpl 4.6.3). Jos ajanvarauspyyntö on hyväksyvä, tallentuu tieto ajanvarauksesta varsinaiseen ajanvarausjärjestelmään Ajanvarauksen peruminen Kuvassa 17 on esitetty sekvenssikaaviolla toiminnallisuus ajanvarauksen peruminen. Ajanvarauspalvelu Slot Inquirer (QUSC_AR040101FI) Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmä Slot Query Responder (QUSC_AR040102FI) Slot Request Confirmer (PRSC_AR030101) Varattujen aikojen selvittäminen Query Appointments by Slot (QUSC_IN040103FI01) Response Appointments by Slot (QUSC_IN040104FI01) Ajanvarauksen peruminen Appointment Cancel Request by Slot (PRSC_IN040201FI01) Appointment Cancel Confirmation by Slot (PRSC_IN FI01) / Appointment Cancel Rejection by Slot (PRSC_IN FI01) Ajanvarauspalvelun roolit: Kyselijä: Slot Inquirer (QUSC_AR040101FI) Tilaaja: Slot Requester (PRSC_AR030200) Kuva 17. Ajanvarauksen peruminen. Ajanvarausjärjestelmän roolit: Kyselyyn vastaaja: Slot Query Responder(QUSC_AR040102FI) Toimittaja: Slot Request Confirmer (PRSC_AR030101) SerAPI projekti 111

112 Ajanvarauspalvelu selvittää asiakkaalle varattuja aikoja kyselemällä niitä varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä interaktiolla Query Appointments by Slot (QUSC_IN040103FI01, ks. kappale 5.7.3). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset asiakkaan varatut ajat vastausinteraktiolla Response Appointments by Slot (QUSC_IN040104FI01, ks. kpl 5.7.4). Kun peruttava ajanvaraus on selvitetty, peruu ajanvarauspalvelu kyseisen ajanvarauksen lähettämällä varsinaiselle ajanvarausjärjestelmälle perumisinteraktion Appointment Cancel Request by Slot (PRSC_IN040201FI01, ks. kpl 4.6.8). Varsinainen ajanvarausjärjestelmä palauttaa ajanvarauspalvelulle joko hyväksyvän vastausinteraktion Appointment Cancel Confirmation by Slot (PRSC_IN FI01, ks. kpl 4.6.9) tai hylkäävän vastausinteraktion Appointment Cancel Rejection by Slot (PRSC_IN040203, ks. kpl ). Jos perumispyyntö on hyväksyvä, on ajanvaraus peruttu varsinaisesta ajanvarausjärjestelmästä Ajanvarauksen siirtäminen, profiili: vapaat ajat selvitetään kyselyllä Kuvassa 18 on esitetty sekvenssikaaviolla toiminnallisuus ajanvarauksen siirtäminen. Vapaa aika (aika johon ajanvarausta ollaan siirtämässä) selvitetään kyselyllä. Ajanvarauksen siirtämisellä voi siirtää vain aikaa. Jos myös palvelutuote vaihtuu, on käytettävää ajanvarauksen muokkauspyyntöä. Ajanvarauspalvelu Slot Inquirer (QUSC_AR040101FI) Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmä Slot Query Responder (QUSC_AR040102FI) Slot Request Confirmer (PRSC_AR030101) Varattujen aikojen selvittäminen Query Appointments by Slot (QUSC_IN040103FI01) Response Appointments by Slot (QUSC_IN040104FI01) Vapaiden aikojen selvittäminen Query Available Slots by Resource (QUSC_IN040101FI01) Response Available Slots by Resource (QUSC_IN040102FI01) Ajan siirtäminen Appointment Reschedule Request by Slot (PRSC_IN040301FI01) Appointment Reschedule Confirmation by Slot (PRSC_IN FI01) / Appointment Reschedule Rejection by Slot (PRSC_IN FI01) Kuva 18. Ajanvarauksen siirtäminen, vapaat ajat kysellään. Ajanvarauspalvelun roolit: Kyselijä: Slot Inquirer (QUSC_AR040101FI) Tilaaja: Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmän roolit: Kyselyyn vastaaja: Slot Query Responder(QUSC_AR040102FI) Toimittaja: Slot Request Confirmer (PRSC_AR030101) 112 SerAPI projekti

113 Ajanvarauspalvelu selvittää asiakkaalle varattuja aikoja kyselemällä niitä varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä interaktiolla Query Appointments by Slot (QUSC_IN040103FI01, ks. kappale 5.7.3). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset asiakkaan varatut ajat vastausinteraktiolla Response Appointments by Slot (QUSC_IN040104FI01, ks. kpl 5.7.4). Ajanvarauspalvelu kyselee vapaita aikoja (aikoja joihin siirrettävä ajanvaraus on mahdollista siirtää) ajanvarausjärjestelmältä/ järjestelmiltä vapaiden aikojen kyselyn interaktiolla Query Available Slots by Resource (QUSC_IN040101FI01, ks. kpl 5.7.1). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset vapaat ajat vastausinteraktiolla Response Available Slots by Resource (QUSC_IN040102FI01, ks. kpl 5.7.2). Kun peruttava aika on selvitetty ja uusi aika valittu, siirtää ajanvarauspalvelu kyseisen ajanvarauksen lähettämällä varsinaiselle ajanvarausjärjestelmälle siirtämispyyntöinteraktion Appointment Reschedule Request by Slot (PRSC_IN040301FI01, ks. kpl ). Varsinainen ajanvarausjärjestelmä palauttaa ajanvarauspalvelulle joko hyväksyvän vastausinteraktion Appointment Reschedule Confirmation by Slot (PRSC_IN FI01, ks. kpl ) tai hylkäävän vastausinteraktion Appointment Reschedul Rejection by Slot (PRSC_IN040303, ks. kpl ). Jos siirtämispyyntö on hyväksyvä, on ajanvaraus siirretty varsinaisessa ajanvarausjärjestelmässä Ajanvarauksen siirtäminen, profiili: vapaat ajat replikoitu Kuvassa 19 on esitetty sekvenssikaaviolla toiminnallisuus ajanvarauksen siirtäminen. Vapaa aika (aika johon ajanvarausta ollaan siirtämässä) on replikoitu. Ajanvarauksen siirtämisellä voi siirtää vain aikaa. Jos myös palvelutuote vaihtuu, on käytettävää ajanvarauksen muokkauspyyntöä. Ajanvarauspalvelu Slot Tracker (PRSC_AR030300) Slot Inquirer (QUSC_AR040101FI) Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmä Slot Informer (PRSC_AR03100) Slot Query Responder (QUSC_AR040102FI) Slot Request Confirmer (PRSC_AR030101) Slot Status Revise Notification (PRSC_IN020400) Vapaiden aikojen ilmoittaminen... Varattujen aikojen selvittäminen Query Appointments by Slot (QUSC_IN040103FI01) Response Appointments by Slot (QUSC_IN040104FI01) Ajan siirtäminen Appointment Reschedule Request by Slot (PRSC_IN040301FI01) Appointment Reschedule Confirmation by Slot (PRSC_IN FI01) / Appointment Reschedule Rejection by Slot (PRSC_IN FI01) Kuva 19. Ajanvarauksen siirtäminen, vapaat ajat replikoitu. SerAPI projekti 113

114 Ajanvarauspalvelun roolit: Ulkopuolinen kiinnostunut taho/ilmoitusten vastaanottaja: Slot Tracker (PRSC_AR030300) Kyselijä: Slot Inquirer (QUSC_AR040101FI) Tilaaja: Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmän roolit: Toimittaja/ilmoituksien lähettäjä: Slot Informer (PRSC_AR03100) Kyselyyn vastaaja: Slot Query Responder(QUSC_AR040102FI) Toimittaja: Slot Request Confirmer (PRSC_AR030101) Tässä profiilissa ajanvarauspalveluun on tallennettu etukäteen tiedot vapaista ajoista. Ajanvarausjärjestelmä/ järjestelmät ilmoittavat ajanvarauspalvelulle vapaita aikoja interaktiolla Slot Status Revise Notification (PRSC_IN020400, ks. kpl 4.6.4). Ajanvarauspalvelu selvittää asiakkaalle varattuja aikoja kyselemällä niitä varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä interaktiolla Query Appointments by Slot (QUSC_IN040103FI01, ks. kappale 5.7.3). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset asiakkaan varatut ajat vastausinteraktiolla Response Appointments by Slot (QUSC_IN040104FI01, ks. kpl 5.7.4). Kun peruttava aika on selvitetty ja uusi aika valittu, siirtää ajanvarauspalvelu kyseisen ajanvarauksen lähettämällä varsinaiselle ajanvarausjärjestelmälle siirtämispyyntöinteraktion Appointment Reschedule Request by Slot (PRSC_IN040301FI01, ks. kpl ). Varsinainen ajanvarausjärjestelmä palauttaa ajanvarauspalvelulle joko hyväksyvän vastausinteraktion Appointment Reschedule Confirmation by Slot (PRSC_IN FI01, ks. kpl ) tai hylkäävän vastausinteraktion Appointment Reschedul Rejection by Slot (PRSC_IN040303, ks. kpl ). Jos siirtämispyyntö on hyväksyvä, on ajanvaraus siirretty varsinaisessa ajanvarausjärjestelmässä Ajanvaraustietojen muokkaaminen Kuvassa 20 on esitetty sekvenssikaaviolla toiminnallisuus ajanvarauksen muokkaus. Ajanvarauspalvelu Slot Inquirer (QUSC_AR040101FI) Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmä Slot Query Responder (QUSC_AR040102FI) Slot Request Confirmer (PRSC_AR030101) Varattujen aikojen selvittäminen Query Appointments by Slot (QUSC_IN040103FI01) Response Appointments by Slot (QUSC_IN040104FI01) Ajanvarauksen muokkaaminen Appointment Revise Request by Slot (PRSC_IN040401FI01) Appointment Revise Confirmation by Slot (PRSC_IN FI01) / Appointment Revise Rejection by Slot (PRSC_IN FI01) Kuva 20. Ajanvarauksen muokkaus. 114 SerAPI projekti

115 Ajanvarauspalvelun roolit: Kyselijä: Slot Inquirer (QUSC_AR040101FI) Tilaaja: Slot Requester (PRSC_AR030200) Ajanvarausjärjestelmän roolit: Kyselyyn vastaaja: Slot Query Responder(QUSC_AR040102FI) Toimittaja: Slot Request Confirmer (PRSC_AR030101) Ajanvarauspalvelu selvittää asiakkaalle varattuja aikoja kyselemällä niitä varsinaiselta ajanvarausjärjestelmältä/ järjestelmiltä interaktiolla Query Appointments by Slot (QUSC_IN040103FI01, ks. kappale 5.7.3). Ajanvarausjärjestelmä/ järjestelmät palauttavat mahdolliset asiakkaan varatut ajat vastausinteraktiolla Response Appointments by Slot (QUSC_IN040104FI01, ks. kpl 5.7.4). Kun muokattava aika on selvitetty, muokkaa ajanvarauspalvelu kyseisen ajanvarauksen tietoja lähettämällä varsinaiselle ajanvarausjärjestelmälle muokkaamispyyntöinteraktion Appointment Revise Request by Slot (PRSC_IN040401FI01, ks. kpl ). Varsinainen ajanvarausjärjestelmä palauttaa ajanvarauspalvelulle joko hyväksyvän vastausinteraktion Appointment Revise Confirmation by Slot (PRSC_IN FI01, ks. kpl ) tai hylkäävän vastausinteraktion Appointment Revise Rejection by Slot (PRSC_IN040403, ks. kpl ). Jos muokkaamispyyntö on hyväksyvä, on ajanvarauksen tiedot muokattu varsinaisessa ajanvarausjärjestelmässä Ilmoitus vapaan ajan muuttumisesta ei vapaaksi/varatun ajan muuttuminen vapaaksi Ajanvarauspalvelun rooli: Ulkopuolinen kiinnostunut taho/ilmoitusten vastaanottaja: Slot Tracker (PRSC_AR030300) Ajanvarausjärjestelmän rooli: Toimittaja/ilmoituksien lähettäjä: Slot Informer (PRSC_AR03100) Ajanvarausjärjestelmä ilmoittaa ajanvarauspalvelulle, että sen ajanvarauspalvelulle ilmoittama vapaa aika on muuttunut ei vapaaksi tai että varattu aika on muuttunut vapaaksi. Ilmoittamiseen käytetään interaktiota Appointment Status Revise Notification by Slot (PRSC_IN040404FI01, ks. kpl ), jonka käyttämässä sanomankuvauksessa kulkee mukana myös tieto ilmoitukseen liittyvästä ajanvarauksesta. Ilman ajanvarauksen tietoja tapahtuvaa ilmoitukseen on käytettävä interaktiota Slot Status Revise Notification (PRSC_IN020400, ks. kpl 4.6.4). Tällä samalla interaktiolla ilmoitetaan vapaista ajoista. 7.3 Ajanvarauksen sovellustason virheet Tässä dokumentissa kuvataan ainoastaan ajanvaraussanomien sovellustasolla (prosessiin liittyvät) tapahtuvat virheet. Muilla tasoilla tapahtuvien virheiden käytön ohjeistus on annettu tarkemmin HL7 Finlandin V3 implementointioppaassa (Open CDA 2006). Ajanvarausviesteissä sovellustason virheitä voi palautua ajanvarauspyyntöjen (ajanvarauspyyntö, perumis, siirtämis ja muutospyynnöt) vastauksissa sekä kyselyiden vastauksissa. Sovellustason SerAPI projekti 115

116 virheitä ei palauteta enää vastauksena pyyntöjen ja kyselyjen vastausten lähettäjille tai ilmoitusten lähettäjille. Pyyntöjen vastauksien yhteydessä sovellustason virheet palautuvat rejection viesteillä. Rejectionviestin siirtokehyksen (Application Level Acknowledgement, MCCI_MT000300UV01) Acknowledgement luokan typecode saa tällöin arvon AE (Application Acknowledgement Error = sovellustason virhe). Confirmation viesteissä vastaava Acknowledgement luokan typecode on AA (Application Acknowledgement Accept = sovellustason OK kuittaus). Näitä koodeja on kuvattu HL7 Finlandin V3 implementointioppaassa (Open CDaA 2006). Varsinainen virhe ilmoitetaan rejectionviestin kontrollikehyksen reasonof luokassa. Kyselyille ei ole määritelty erillistä rejection viestiä vaan mahdollinen virhe palautuu normaalina kyselyn vastauksena. Vastausten yhteydessä virheestä ilmoitetaan siirtokehyksen lisäksi myös kyselyiden vastauksen kontrollikehyksen queryack.queryresponsecode elementillä, joka on pakollinen. Virheisiin queryresponsecode koodeista liittyvät AE (sovellusvirhe) ja QE (kyselyn parametreissa oli virhe). Jos kyselyyn ei löytynyt yhtään vastausta (NF), kyseessä ei ole virhe. Ilman virheitä menneen kyselyn koodi on OK. Varsinainen virhe ilmoitetaan kyselyn vastauksen kontrollikehyksen reasonof luokassa. Varsinaiset virheet (sovellustason) ilmoitetaan siis sekä pyyntöjen että kyselyjen vastausten kontrollikehyksen reasonof luokassa (kuva 21). Attribuutti reasonof.typecode on vakio RSON ja attribuutti reasonof.contextconductionindicator on arvossa false. reasonof sisältää toistuvan elementin DetectedIssueEvent (act), jolla esitetään varsinaiset virhetiedot. Kuva 21. reasonof ja detectedissueevent luokat Kuvassa 22 on kuvattu CMET A_DetectedIssueEvent (MCAI_MT ), jossa määritellään virheeseen liittyvä tiedot tarkemmin. Kuva 22. A_DetectedIssueEvent CMET. 116 SerAPI projekti