Hae koostetiedot

Käyttötapaus kuvaa Kanta-palvelujen Potilastietovarantoon 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. [LT1]

Haku rajautuu yhden potilaan tietoihin. Potilas yksilöidään virallisella henkilötunnuksella, eikä tilapäisen yksilöintitunnuksen käyttö ole sallittu. Myös puolesta asioiva yksilöidään puolesta asioinnin tilanteissa virallisella henkilötunnuksella. Haku kohdistuu kaikkien rekisterinpitäjien rekistereihin.

HRP-palvelu päättelee hakutilanteen kyselysanomassa annettujen tietojen perusteella:

1. Henkilön oma asiointi: Hakuparametreissa on annettu omia tietojaan hakevan henkilön henkilötunnus.
2. Puolesta asiointi: Hakuparametreissa on annettu potilaan eli päämiehen henkilötunnuksen lisäksi puolesta asioivan henkilötunnus [LT2]

Kanta-palveluista ei missään hakutilanteessa palauteta:

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

Lisäksi alaikäisen puolesta asioinnissa ei palauteta puolesta asioivalle seuraavia koostetietoja:

• tietoja asiakirjoista, joiden luovuttamisen päätöskykyiseksi arvioitu alaikäinen on kieltänyt tai joissa on merkintä "alaikäisen päätöskyky ei tiedossa", ja
• yli 10-vuotiaan lapsen tietoja, joihin ei ole kirjattu tietoa alaikäisen päätöskyvystä ja tahtoa tietojen luovuttamisesta.

Täysi-ikäisen puolesta asioinnissa palautetaan samat koostetiedot kuin henkilölle itselleenkin.

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 [LT1].

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
5. Hakutilanteessa B. Puolesta asiointi: Puolesta asioivalla on oikeus asioida päämiehen puolesta ja puolesta asioiva on yksilöity henkilötunnuksella [LT2]

Normaali tapahtumankulku

1. Järjestelmä tuottaa hakusanoman REST-rajapinnan Haku -kuvauksen mukaisesti [V1].
   • Pakolliset hakuparametrit koostehaussa: (ks. REST-rajapinta Haku)
     • potilaan henkilötunnus
     • haettavan sisällön tyyppi
     • näkymätunnus
     • merkinnän tekoaika
     • Hakutilanteessa B. Puolesta asiointi: puolesta asioivan henkilötunnus
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.

Lisätiedot

LT1 Keskeisistä terveystiedoista tarkemmin Kanta.fi-sivuilla.

LT2 Puolesta asioinnissa palautuvat tiedot ovat päämiehen tietoja. Päämiehellä viitataan siihen henkilöön, jonka puolesta ollaan asioimassa. Puolesta asioivan oikeus asioida päämiehen puolesta tarkistetaan Suomi.fi-valtuudet palvelusta.