Ydinpalveluiden (käyttäjä, potilas).NET-asiakassovellus: PatientCoreClientDemo PlugIT-loppuseminaari 31.8.2004 Koulutustyöpaja 1: Avoimet ohjelmistorajapinnat.

Esitys aiheesta: "Ydinpalveluiden (käyttäjä, potilas).NET-asiakassovellus: PatientCoreClientDemo PlugIT-loppuseminaari 31.8.2004 Koulutustyöpaja 1: Avoimet ohjelmistorajapinnat."— Esityksen transkriptio:

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

2 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

3 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

4 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

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

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

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

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

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

10 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

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

12 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

13 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

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

15 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

16 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 193.167.225.57 ja kutsuu CoreServiceConnector-luokan getResponse- metodia parametrina luotu merkkijono

17 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 81935272

18 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;

19 Mistä löytyy? http://www.plugit.fihttp://www.plugit.fi  Rajapinnat  Toteutukset Referenssitoteutukset Käyttäjä-, käyttöoikeus- ja potilas-ydinpalvelut: NETCommonServiceClient –sovellus + dokumentaatio (zip) –sovellus + dokumentaatio + lähdekoodi (zip)