SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 1 OID-kohde OID- generointi (ja -kyselyt?)

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 2 OID-kohde Tavoite: Rajapintamäärittely OID-tunnusten (Object Identifiers) generoinnille Selvitys: Onko tarvetta OID-kysely-toiminnallisuudelle, jos on =>määrittely Tausta: Tarve keskitetylle potilasasiakirjojen yksilöintitunnisteiden luomiselle Stakesin OID-hyödyntämisohje (Ensio, A. Sosiaali- ja terveydenhuollon OID-tunnuksen käyttö, versio 1.0. Stakes, 2004) Tehty tähän mennessä Kohdekuvaus OID-generaattori demosovellus rajapintamäärittelytyön pohjaksi

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 3 OID-tunnuksen määrittely Sosiaali- ja terveydenhuollon palvelujen tuottajaorganisaatio tai yhteistyökumppani: yhteisötunnus Toimipaikka (esim. vuodeosasto tai poliklinikka): yhteisötunnus.10.toimipaikan_tunnus Yhteisötunnuksen tai toimipaikan juureen liitetään muut OID- tunnukset (asiakirjat, paikalliset koodistot, laitteet, hoitoketjut, tilapäiset henkilötunnukset, henkilö-numerot ym.) Esim. Pohjois-Savon sairaanhoitopiirin potilasasiakirja 1/2002:n OID-tunnus: missä asiakirjan solmuluokka 11 Pohjois-Savon sairaanhoitopiirin yhteisötunnus

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 4 OID-rajapinta OID-generointi generoidaan (palautetaan sovellukselle) Stakesin OID-hyödyntämisohjeen mukainen OID-tunnus asiakirjalle tai muulle yksilöitävälle asialle. palvelun on sisällettävä tieto seuraavasta vapaasta OID-tunnuksesta kussakin kategoriassa.

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 5 OID-rajapinta OID-kyselyt palvelun avulla voitava selvittää, mitä OID- tunnuksia palvelu on generoinut. palvelun sisällettävä tarvittavat tiedot annetuista OID-tunnuksista. kyselyt, jotka liittyvät toisessa organisaatiossa luotuihin OID-tunnuksiin => palvelun osattava kysyä tietoja toiselta OID-palvelulta

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 6 OID ja muut rajapinnat HL7 Finland ”Terveydenhuollon avoimet sovellusrajapinnat – koodistorajapinnat”: OID-kysely: mahdollisesti vastaava toiminnallisuus SerAPI: Resurssi-kohde mahdollinen resurssirekisteri, jossa myös resurssien OID-tunnisteet

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 7 OID-demo: toiminnallisuus pohjana/apuna rajapintamäärittelytyölle WSDL:n kehityksen tukena operaatio: getOID parametrit in: root (String), node (String) paluuarvo OID (String)

8 OID-generointi sekvenssikaaaviona: Onnistunut OID-generointi

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 9 OID-demo: toteutus toteutus Tomcat 5.5, Apache Axis ajoympäristö Resin 2.1.x + Axis-paketit demon esittely

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 10 OID-demo rajaus: oletus: sovellus huolehtii, että käyttäjällä oikeus OID-generointiin. => OID-rajapinta ei ota kantaa käyttöoikeuksiin. => pitäisikö palvelun tunnistaa kutsuva sovellus? generoitavien OID-tunnusten solmuluokat:11- Asiakirja, 12-ohjelmisto, 13-Laite. Toiminnallisuus sama myös useille muille (esim. 14- hoito-ja palveluketju) ei kuitenkaan esim Asiakkaan, potilaan ja työntekijän yksilöinti

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 11 OID-demo Virhetilanteiden käsittely Virhetilanne, jossa tallennus ei onnistu Jos tallennetun OID:n lähetys asiakassovellukselle ei onnistu =>pitäisikö tallennus peruuttaa? Pitäisikö käsitellä virhetilanne, jossa parametrit (root, node) virheellisiä tai puuttuvat?

12 OID-generointi sekvenssikaaviona: Epäonnistunut OID-generointi

SerAPI Saara Savolainen Esa Paakkanen Marko Suhonen 13 Jatkotyöskentely Generointirajapinta: toiminnallinen määrittely mille asioille tarvitaan generointipalvelua? käyttöoikeustarkistukset? virhetilanteet? yksi in-parametri (root ja node yhdistettynä)? tarvitaanko operaatio, joka palauttaa palvelun sisältämät juuret/solmuluokat (kaavio)?kaavio CDA-dokumentin sisällä olevien objektien yksilöinti sovelluksessa, ei palvelun kautta? kyselyrajapinta? Onko keskitetyille OID-varastoille tarvetta Mitä tietoja tarvitaan? Tarvitaanko luoduista oid-tunnuksista metatietoa (esim. luontiaika)

14 Generaattori hallinnoi juuria ja solmuluokkia