Ydinpalveluiden (käyttäjä, potilas).NET-asiakassovellus: PatientCoreClientDemo PlugIT-loppuseminaari Koulutustyöpaja 1: Avoimet ohjelmistorajapinnat Heli Mäki, HIS-tutkimusyksikkö / Kuopion yliopisto

Yleistä Ydinpalveluiden (käyttäjä, potilas) asiakassovellus Asetukset: –Käytettävien käyttäjä- ja potilasrajapintojen ydinpalveluiden valinta asetetaan Setup.xml-tiedostoon Toiminnot: –Käyttäjän kirjautuminen sisään ja ulos –Potilaiden haku + (potilaan) valinta –Potilaan tietojen katselu ja muokkaus –Potilaan lisäys ja poisto

Käytettävät rajapinnat ja operaatiot Käyttäjärajapinta: AuthenticateUser –GetCoupon –CheckAuthentication –Login –GetSubject –Logout User:ProfileAccess –GetProfile Potilasrajapinta: Patient:identifyProfile FindCandidates GetMoreCandidates DropRemainingCandidates Patient:ProfileAccess GetProfile CreateProfile * UpdateProfile * DeleteProfile * * Ei kuulu minimitoteutukseen

Käytettävät ominaisuudet Käyttäjä: –kayttajatunnus Potilas: –hetu –sukunimi –etunimet –sukupuoli –syntymaaika –kotikunta –yksikko –H.katuosoite H = pysyvä kotiosoite O = työosoite C = tilapäinen kotiosoite N = syntymäpaikka –H.postinumero –H.postitoimipaikka –H.maa –H.puhelinnumero –O.katuosoite –O.postinumero –O.postitoimipaikka –O.maa –O.puhelinnumero –C.katuosoite –C.postinumero –C.postitoimipaikka –C.maa –C.puhelinnumero –N.postitoimipaikka –N.maa

Toteutuksesta Sovelluskehitin:MS Visual Studio.NET 2003 Sovellustyyppi:Windows Application Ohjelmointikieli:C# Rajapinta  luokka Operaatio  metodi

Luokat PatientCoreClientDemo Login Haku AuthenticateUser UserProfileAccess PatientIdentifyProfile PatientProfileAccess CoreServiceConnector Converter lomakeluokat apuluokat

PatientCoreClientDemo-luokka Toteuttaa päälomakkeen Käyttää kaikkia muita luokkia

Login-luokka Toteuttaa kirjautumislomakkeen Käyttää AuthenticateUser- luokkaa

Haku-luokka Toteuttaa hakulomakkeen Käyttää PatientIdentifyProfile- luokkaa

AuthenticateUser-luokka getCoupon –hakee kupongin ydinpalvelulta checkAuthentication –tarkistaa, onko kuponki varmennettu login –kirjaa käyttäjän ydinpalveluun getSubject –hakee kuponkiin liitetyn käyttäjän profiilin tunnisteen logout –kirjaa käyttäjän ulos ydinpalvelusta Käyttää CoreServiceConnector- ja Converter-luokkia

UserProfileAccess-luokka getProfile –hakee käyttäjän käyttäjätunnuksen ja palauttaa sen Käyttää CoreServiceConnector- ja Converter-luokkia

PatientIdentifyProfile-luokka findCandidates –hakee potilaskandidaatteja ydinpalvelulta –ominaisuudet: hetu, sukunimi, etunimet, yksikko ja syntymaaika getMoreCandidates –hakee edellisestä hausta jäljelle jääneitä potilaskandidaatteja dropRemainingCandidates –poistaa jäljellä olevat potilaskandidaatit Käyttää CoreServiceConnector- ja Converter-luokkia

PatientProfileAccess-luokka getProfile –hakee potilaan tiedot ydinpalvelusta createProfile –lisää uuden potilaan ydinpalveluun updateProfile –päivittää potilaan tiedot ydinpalveluun deleteProfile –poistaa potilaan ydinpalvelusta Käyttää CoreServiceConnector- ja Converter-luokkia Eivät kuulu minimitoteutukseen

CoreServiceConnector-luokka getResponse –suorittaa palvelupyynnön ydinpalveluun ja palauttaa vastauksen Käyttää Converter-luokkaa

Converter-luokka streamToString –muuntaa parametrina annetun Stream:n merkkijonoksi ja palauttaa sen stringToXmlDocument –muuntaa parametrina annetun merkkijonon XML-dokumentiksi ja palauttaa sen xmlDocumentToString –muuntaa parametrina annetun XML-dokumentin merkkijonoksi ja palauttaa sen stringToInt –muuntaa parametrina annetun merkkijonon kokonaisluvuksi ja palauttaa sen

Palvelupyyntö ja vastaus – esimerkkinä kupongin hakeminen (1/3) Kuponki haetaan kutsumalla AuthenticateUser-luokan getCoupon-metodia parametrina manifest-arvo getCoupon-metodi koostaa XML-muotoisen merkkijonon AuthenticateUser GetCoupon ja kutsuu CoreServiceConnector-luokan getResponse- metodia parametrina luotu merkkijono

Palvelupyyntö ja vastaus – esimerkkinä kupongin hakeminen (2/3) getResponse-metodi lähettää käyttäjärajapinnan ydinpalvelulle HTTP POST –viestin, jonka sisältönä on parametrina saatu merkkijono seuraavaksi getResponse-metodi lukee vastauksen, muuntaa sen merkkijonoksi kutsumalla Converter-luokan streamToString-metodia ja palauttaa merkkijonon

Palvelupyyntö ja vastaus – esimerkkinä kupongin hakeminen (3/3) getCoupon-metodi muuntaa merkkijonon (XmlDocument- tyyppiseksi) XML-dokumentiksi kutsumalla Converter-luokan stringToXmlDocument-metodia lopuksi getCoupon-metodi lukee XML-dokumentista coupon- elementin sisällön ja palauttaa sen –lukeminen XmlDocument-luokan (W3C:n DOM-rajapinta) avulla responseXmlDocument.SelectSingleNode("response/coupon").InnerText;

Mistä löytyy?  Rajapinnat  Toteutukset Referenssitoteutukset Käyttäjä-, käyttöoikeus- ja potilas-ydinpalvelut: NETCommonServiceClient –sovellus + dokumentaatio (zip) –sovellus + dokumentaatio + lähdekoodi (zip)