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

Esitys aiheesta: "SerAPI 19.8.2005 Saara Savolainen Esa Paakkanen Marko Suhonen 1 OID-kohde OID- generointi (ja -kyselyt?)"— Esityksen transkriptio:

1 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) Esa Paakkanen Marko Suhonen 1 OID-kohde OID- generointi (ja -kyselyt?)

2 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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

3 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) Esa Paakkanen Marko Suhonen 3 OID-tunnuksen määrittely Sosiaali- ja terveydenhuollon palvelujen tuottajaorganisaatio tai yhteistyökumppani: 1.2.246.537.10.yhteisötunnus Toimipaikka (esim. vuodeosasto tai poliklinikka): 1.2.246.537.10.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: 1.2.246.537.10.1714953.11.2002.1 missä asiakirjan solmuluokka 11 Pohjois-Savon sairaanhoitopiirin yhteisötunnus 1714953.

4 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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.

5 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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

6 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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

7 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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 8 OID-generointi sekvenssikaaaviona: Onnistunut OID-generointi

9 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) Esa Paakkanen Marko Suhonen 9 OID-demo: toteutus toteutus Tomcat 5.5, Apache Axis ajoympäristö Resin 2.1.x + Axis-paketit demon esittely http://kettinki.uku.fi/OIDGeneratorClient/

10 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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. 21-29 Asiakkaan, potilaan ja työntekijän yksilöinti

11 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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 12 OID-generointi sekvenssikaaviona: Epäonnistunut OID-generointi

13 SerAPI 19.8.2005 Saara Savolainen (Saara.Savolainen@uku.fi) 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 14 Generaattori hallinnoi juuria ja solmuluokkia