Hae koostetiedot

Käyttötapaus kuvaa Kanta-palvelujen Potilastiedon tietovarantoon arkistoitujen keskeisten terveystietojen hakutilanteet HRP-palvelusta.

Haku kohdistuu koostetietoihin ja sitä voidaan rajata kyselyparametrien avulla. Koostetietoja ovat diagnoosit, riskit, toimenpiteet, rokotukset, fysiologiset mittaukset, laboratoriotutkimukset ja kuvantamistutkimukset. Koostetiedot haetaan Tiedonhallintapalvelun koostekannasta, ja kunkin koostetyypin osalta palautuu yksi koosteasiakirja, jos potilaalla on kyseisiä tietoja.

Haku rajautuu yhden potilaan tietoihin. Potilas yksilöidään virallisella henkilötunnuksella, tilapäisen yksilöintitunnuksen käyttö ei ole sallittu. Haku kohdistuu kaikkien rekisterinpitäjien rekistereihin.

Kanta-palveluista ei palauteta seuraavia koostetietoja:

• tietoja asiakirjoista, joita koskee voimassa oleva viivästys
• käyttäytymiseen liittyviä riskitietoja
• alaikäisen henkilön tietoja, jotka ovat syntyneet ennen 1.8.2016
• toista henkilöä koskevia tietoja ja
• palautettavista koostetiedoista poistetaan henkilöiden tunnistetiedot

Käyttötapauksen lopputuloksena hakeva järjestelmä on vastaanottanut HRP-palvelun palauttaman hakuparametrien mukaisesti rajatun haun tuloksen Tiedonhallintapalvelun koostetiedoista. Koosteasiakirja sisältää kunkin keskeisen terveystiedon tiedot ja sen syntykontekstin tiedot (Kanta.fi).

Käyttäjäroolit

1. Hakeva järjestelmä, esimerkiksi Hyvinvointisovellus, jatkossa Järjestelmä
2. Kanta-palveluiden HRP-palvelu, jatkossa Palvelu

Esiehdot

1. Hakevalla järjestelmällä on auktorisointiprosessin seurauksena saatu access token, mikä oikeuttaa pääsyn potilaan tietoihin
2. Potilas on yksilöity henkilötunnuksella
3. Hakevassa järjestelmässä on tiedossa joko käyttäjän antamana tai järjestelmän päättelemänä tarvittavat hakuparametrit
4. Jos kyseessä on sivutetun hakutuloksen jatkohaku, järjestelmällä on tiedossa Palvelun palauttamat tiedot jatkohakua varten

Normaali tapahtumankulku

1. Järjestelmä tuottaa hakusanoman REST-rajapinnan Haku -kuvauksen mukaisesti [V1]
   • Hakuparametrit, kaikki pakollisia koostehaussa: (ks. REST-rajapinta Haku)
     • henkilötunnus
     • haettavan sisällön tyyppi
     • näkymätunnus
     • merkinnän tekoaika
2. Järjestelmä lähettää hakusanoman Palvelulle [V2]
3. Järjestelmä vastaanottaa hakutuloksen [V3]
4. Järjestelmä käsittelee haettuja tietoja oman säännöstönsä mukaisesti. Käyttötapaus päättyy.

Virhetilanteet

V1 Hakusanoman tarvitsemien tietojen tuottaminen ei onnistu. Järjestelmä toimii oman logiikkansa mukaisesti. Käyttötapaus päättyy.

V2 Hakusanoman muodostaminen ei onnistu. Järjestelmä toimii oman logiikkansa mukaisesti. Käyttötapaus päättyy.

V3 Haun tuloksen vastaanottaminen ei onnistu. Järjestelmä toimii oman logiikkansa mukaisesti. Käyttötapaus päättyy.