SADe Sote
Rajapinnat
HL7 Finland Personal Health
24.3.2014
24.3.2014
Heikki Virintie/Marketvisio
1
24.3.2014
Esityksen nimi / Tekijä
2
Rajapintamäärittelyt SADe sote -hankkeessa
•
Palvelukokonaisuuden viitearkkitehtuurissa on kuvattu alustavasti
kehitettävien palvelujen ja määrittelyjen rajapintoja; tässä esityksessä
esimerkkinä ote viitearkkitehtuurin standardisalkusta.
– Viitearkkitehtuurin viimeisin versio 0.95 3/2013, päivitys 2014 aikana
– Tarkemmat rajapintamäärittelyt tehdään kansallisia palveluja tai määrittelyjä
tekevissä projekteissa, mistä ne siirretään soveltuvin osin osaksi
viitearkkitehtuuria
– SADe sote sähköisen asioinnin viitearkkitehtuuri siirtynee SADeohjelmakauden jälkeen osaksi sosiaali- ja terveydenhuollon valtakunnallista
kokonaisarkkitehtuuria
•
SADe sote –rajapintoja voi yrittää hahmottaa myös projektien välisten
riippuvuuksien kautta, joita olemme kuvanneet yleisellä tasolla
kokonaiskuvan saamiseksi (esimerkkeinä palveluhakemisto sekä
yleinen sote-tieto ja avuntarpeen itsearviointi)
24.3.2014
Esityksen nimi / Tekijä
3
Kansalliset järjestelmät/palvelut/hankkeet
Valtakunnalliset tietovarannot
SADe sote -riippuvuudet – Kokonaiskuva
Riippuvuudet on kuvattu
SADe sote –hankkeiden
tavoitetilan näkökulmasta
Valvira
Valveri
Suomi.fi/
Thl.fi
Kela
Palveluntuottajarekisteri
KanTa
THL
TOPI2
Asiointitili
Sote-org.
rekisteri
Avoin
terveystaltio
(esim.Taltioni)
RAI-tilastot
Tilaajavastuu/
YTJ
Koodistot
Kirjautumispalvelu
Paikkatiedot/
kartat
Omakanta
Suostumusten
hallinta
Valtuutusten ja
puolestaasioinnin hallinta
Tunnistaminen
Palveluväylä (kansallinen/sote)
Alueelliset kuntien palvelut / alueellisesti toteutettavat hankkeet
Kuntalaisportaali /
asiointipalvelu
Alueellinen
kytketty
terveystaltio
Kansalaisen
kalenteri
SADe sote –palvelut /-hankkeet
Yksit. & 3.sektori
Duodecim ja
muut sotetietolähteet
Yleinen sote-tieto
ja avuntarpeen
itsearviointi
Pilotit
Spontaani palaute
SADe
Hyvis
Kansalaisen
verkkopalvelu
(Palveluvaaka)
SADe
Mielenterveystalo
Palveluhakemistokokonaisuus
SADe
PSOP
Palveluhakemisto
Palveluntuottajarekisteri
Strukturoitu
palaute
Sähköinen
ajanvaraus
Turvallinen
viestinvälitys
Hyvis
Mielenterveystalo
PSOP
SADe viestinvälityspilotit 1&2
= määrittely-/integraatio-/toteutus-/pilotointiriippuvuus (SADe sote sisäinen)
= integraatio-/toteutusriippuvuus (SADe sote kansallinen/alueellinen)
24.3.2014
Esityksen nimi / Tekijä
4
Kansalliset järjestelmät/palvelut/hankkeet
Valtakunnalliset tietovarannot
SADe sote –riippuvuudet - Palveluhakemisto
Riippuvuudet on kuvattu
SADe sote –hankkeiden
tavoitetilan näkökulmasta
Valvira
Kela
Valveri
Palveluntuottajarekisteri
Suomi.fi
KanTa
THL
TOPI2
Asiointitili
Sote-org.
rekisteri
Avoin
terveystaltio
(esim.Taltioni)
RAI-tilastot
Tilaajavastuu/
YTJ
Koodistot
Kirjautumispalvelu
Paikkatiedot/
kartat
Omakanta
Suostumusten
hallinta
Valtuutusten ja
puolestaasioinnin hallinta
Tunnistaminen
Palveluväylä (kansallinen/sote)
Alueelliset kuntien palvelut / alueellisesti toteutettavat hankkeet
Kuntalaisportaali /
asiointipalvelu
Alueellinen
kytketty
terveystaltio
Kansalaisen
kalenteri
SADe sote –palvelut /-hankkeet
Yksit. & 3.sektori
Pilotit
Duodecim ja
muut sotetietolähteet
Spontaani palaute
SADe
Hyvis
Kansalaisen
verkkopalvelu
(Palveluvaaka)
SADe
Mielenterveystalo
Palveluhakemistokokonaisuus
SADe
PSOP
Palveluhakemisto
Hyvis
Mielenterveystalo
PSOP
Palveluntuottajarekisteri
Strukturoitu
palaute
= määrittely-/toteutus-/pilotointiriippuvuus (SADe sote sisäinen)
= toteutusriippuvuus (SADe sote kansallinen/alueellinen)
24.3.2014
Esityksen nimi / Tekijä
5
Riippuvuudet – SADe sote kansalliset toteutukset
• Palveluhakemistokokonaisuus:
– Lähderekisterit/-tiedot: Valveri, Topi2, Sote-organisaatiorekisteri,
PSOP-palveluntuottajarekisteri, RAI-tilastot, koodistot,
palveluntuottajien ylläpitokäyttöliittymä ja –rajapinta (ei kuvassa)
– Hyödynnettävät palvelut: THL:n kirjautumispalvelu,
Tilaajavastuu.fi/YTJ, paikkatieto-/karttapalvelut
– Hyödyntävät palvelut/rekisterit: Kelan palveluntuottajarekisteri,
palvelut palveluhakemiston kyselyrajapinnan kautta (ei kuvassa)
– Loppukäyttäjäkanavat: Palveluvaaka/palveluhakemiston
kansalaisen verkkopalvelu, kunnan portaali/asiointipalvelu,
Suomi.fi
– SADe sote –riippuvuudet: Strukturoitu palaute, spontaani palaute
– Pilotointi: SADe Mielenterveystalo, SADe PSOP
– Tilanne: Toteutusvaiheessa
24.3.2014
Esityksen nimi / Tekijä
6
Palveluhakemisto
THL tai muu
viranomainen
Palveluntuottaja
Kansalainen
Kansallinen sote-palveluhakemistopalvelu
Käyttöliittymä/
portaali
Asiointipalvelut
Hankinnan kohde
Kansalainen
Kunnan sote-portaali
Palveluhakemiston
ylläpitäjän
käyttöliittymä
Kunnan sotepalveluntuottajien
hakupalvelu
Palveluhakemiston
hakupalvelu
Palveluntuottajatietojen ylläpito
Palveluhakemiston
hakupalvelu
Palveluntuottajien
hallinta
Seuranta ja
raportointi
Kansalaisen
verkkopalvelu
Kansalainen
Suomi.fi
Kela –
palveluntuottajarekisteri
Omakanta
Kansalliset tukipalvelut
Vetuma
Virtu
Katso
Sisäiset
tietovarannot
Palveluhakemistotietokanta
Lokitiedot
Tilaajavastuu.fi
Paikkatiedot
Palveluväylä/
integraatiot
Kyselyrajapinta
Pääkaupunkiseudun
palvelukartta
Päivitysrajapinta
Kans. perustietovarannot
Ulkoiset
päätietovarannot
24.3.2014
Sote-org.
rekisteri
PSOP
Koodistot
VTJ
Valveri
TOPI 2
Käyttäjä- ja
käyttövaltuus
rekisteri
YTJ
Esityksen nimi / Tekijä
7
Kansalliset järjestelmät/palvelut/hankkeet
Valtakunnalliset tietovarannot
SADe sote –riippuvuudet – Yleinen sote-tieto
Riippuvuudet on kuvattu
SADe sote –hankkeiden
tavoitetilan näkökulmasta
Valvira
Valveri
Suomi.fi/
Thl.fi
Kela
Palveluntuottajarekisteri
KanTa
THL
TOPI2
Asiointitili
Sote-org.
rekisteri
Avoin
terveystaltio
(esim.Taltioni)
RAI-tilastot
Tilaajavastuu/
YTJ
Koodistot
Kirjautumispalvelu
Paikkatiedot/
kartat
Omakanta
Suostumusten
hallinta
Valtuutusten ja
puolestaasioinnin hallinta
Tunnistaminen
Palveluväylä (kansallinen/sote)
Alueelliset kuntien palvelut / alueellisesti toteutettavat hankkeet
Kuntalaisportaali /
asiointipalvelu
Alueellinen
kytketty
terveystaltio
Kansalaisen
kalenteri
SADe sote –palvelut /-hankkeet
Yksit. & 3.sektori
Duodecim ja
muut sotetietolähteet
Pilotit
Yleinen sote-tieto
ja avuntarpeen
itsearviointi
SADe
Hyvis
SADe
Mielenterveystalo
SADe
PSOP
Hyvis
Mielenterveystalo
PSOP
= määrittely-/toteutus-/pilotointiriippuvuus (SADe sote sisäinen)
= toteutusriippuvuus (SADe sote kansallinen/alueellinen)
24.3.2014
Esityksen nimi / Tekijä
8
Riippuvuudet – SADe sote kansalliset toteutukset
• Yleinen sote-tieto ja avuntarpeen itsearviointi:
– Lähderekisterit/-tiedot: Duodecim Terveyskirjasto ja Terveysportti,
Sosiaaliportti, 3. sektorin toimijat, THL:n omat lähteet (ei
kuvassa), koodistot
– Hyödynnettävät palvelut: Avoin terveystaltio (esim. Taltioni),
alueellinen kytketty terveystaltio
– Loppukäyttäjäkanavat: Kunnan portaali/asiointipalvelu, Suomi.fi
– Pilotointi: SADe Hyvis
– Tilanne: Määrittelyvaiheessa
24.3.2014
Esityksen nimi / Tekijä
9
SADe Sote
Sosiaali- ja terveydenhuollon sähköisen
asioinnin viitearkkitehtuuri
Luonnos v. 0.96
24.3.2014
Esityksen nimi / Tekijä
10
Sosiaali- ja terveydenhuollon sähköisen
asioinnin viitearkkitehtuurin sisällysluettelo
1. JOHDANTO
• Lähtökohdat ja tavoitteet
• Rajaukset ja reunaehdot
2. PERIAATETASON ARKKITEHTUURIKUVAUKSET
• Arkkitehtuuriperiaatteet – velvoittavat/ohjaavat/hyvät käytännöt
• Sidosarkkitehtuurit
• Tietoturvaperiaatteet
• Noudatettavat standardit
3. KÄSITTEELLISEN TASON ARKKITEHTUURIKUVAUKSET
• Sidosryhmät
• Sidosryhmien keskeisiä arkkitehtuurivaatimuksia
• Palvelukartta
• Keskeiset käsitteet
4. LOOGISEN TASON ARKKITEHTUURIKUVAUKSET
• Toimintaprosessi
• Päätietoryhmät
• Loogiset tietovarannot
• Looginen tietojärjestelmäjäsennys
5. ARKKITEHTUURIN HALLINTAPERIAATTEET
6. SOVELTAMISOHJEET
7. LIITTEET
11
1. Johdanto
Rajaukset ja reunaehdot

Sosiaali- ja terveydenhuollon sähköisen asioinnin viitearkkitehtuurissa
kuvattavat asiat:
Sidosarkkitehtuurit
Integraatioperiaatteet
Rajaukset ja reunaehdot
Periaatetaso
Arkkitehtuuriperiaatteet
Kehittämistavoitteet
Tietoturvaperiaatteet
Standardit
Ohjaus
Toiminta
Tieto
Tietojärjestelmä
Teknologia
Sidosryhmät
Käsitteellinen
taso
Looginen
taso
Palvelukartta
Keskeiset käsitteet
Prosessit
Päätietoryhmät
Tietojärjestelmäjäsennys
Loogiset
tietovarannot
Fyysinen
taso
12
4. Loogisen tason arkkitehtuurilinjaukset
Looginen tietojärjestelmäjäsennys
Kansalliset sote-asiointipalvelut
ja -rekisterit
Kansallisten soteasiointipalvelujen
käyttöliittymät
Asioinnin
tekniset
tukipalvelut
Tekniset tukipalvelut (esim.
tunnistautuminen, kertakirjautuminen)
Integraatio/
Palvelujen
ohjaus
Työpöytä-, sovellus- ja tietointegraatiot
Loogiset tietojärjestelmäpalvelut
Käyttöliittymä/
portaali
Asioinnin
peruspalvelut
Palveluvaaka
Suostumukset ja kiellot
(KanTa/KanSa)
Kansallinen
sote-tietopalvelu
(sis. riskitestit)
Asioinnin
substanssipalvelut
Päätietovarannot
eKatselu
Julkishallinnon
asiointipalvelut
ja -rekisterit
suomi.fi
Vetuma
Palveluntarjoajan sote-asiointipalvelut
ja rekisterit
Palveluntarjoajan / kunnan
asiointipalvelun käyttöliittymät
Katso
Tekniset tukipalvelut (esim.
tunnistautuminen, kertakirjautuminen)
Virtu
VIA / muu
palveluväylä
Asiointitili
Työpöytä-, sovellus- ja tietointegraatiot
Terveyskansio
esim. Taltioni
Alueellinen
/paikallinen sotetietopalvelu
Omakanta)
Palveluntarjoajan / kunnan
kuntalaisportaali (esim. Hyvis)
Yhdistetyn
viestinnän
palvelut
Asiointipalvelusopimukset
Turvallinen
viestinvälitys
Alueell./paikallinen
palveluhakemistopalvelu
Esitietopalvelu
Puolesta-asioinnin
valtuutukset
Hoitotahto
Spontaanin
palautteen
palvelu
Strukturoidun
palautteen
palvelu
Omahoitopalvelu
Anonyymi
neuvontapalvelu
Ajanvarauspalvelu
Etäkonsultaatio
ja etähoito
Palveluhakemistopalvelu
Tunnisteellinen
neuvonta ja
hoitoonohjaus
Virtuaalinen
vertaistukipalvelu
Hoitopäiväkirja
Tutkimustulosten ja hoitoviestien välitys
Sote-org.
rekisteri
Yleinen
sote-tieto
KanTa
Verotus
tiedot
Paikkatiedot
Asiakastietorekisteri
Potilastietorekisteri
Palvelutapahtumarekisteri
Palvelusopimukset
Asianhallinnan
tiedot
Valveri
Palveluhakemisto
KanSa
Työllisyysja etuustiedot
VTJ
Paikalliset
koodistot
Palvelu- ja
yksikkötiedot
Resurssitiedot
Käyttäjä- ja
käyttövaltuus
rekisteri
Yleinen
sote-tieto
TOPI
Terveyskansio
(esim. Taltioni)
Koodistot
TilaajaVastuu
Katso,
Virtu
Suostumuksetja kiellot
Terveyskansion DW
Suoritetiedot
Lokitiedot
Palauteet
13
2. Periaatetason arkkitehtuurilinjaukset
Standardisalkku 1/2
•
Standardisalkun tavoitteena on edistää
– tietojärjestelmien yhteentoimivuutta
– palvelujen käytettävyyttä ja saavutettavuutta
– tietoturvaa ja tietosuojaa
•
Ratkaisujen kehittämisessä on pyrittävä soveltuvin osin seuraavien yleisten
standardisuositusten ja määritysten hyödyntämiseen ja noudattamiseen
tapauskohtaisen määrittelyn sijaan (ks. tarkempi erittely liitteessä 2):
Nimi
JHS181
Kuvaus
JHKA-standardisalkku
Lähde/viite
www.jhs-suositukset.fi/suomi/jhs181
SAVI-arkkitehtuurin
standardisalkku
Tikesos
standardisalkku
KanTa
standardisalkku
Julkisen hallinnon sähköisen asiakaspalvelun
viitearkkitehtuuri, standardisalkku
Sosiaalihuollon kansallinen KA, standardisalkku
SAVI-arkkitehtuuri, v.1.0, 2/2013
KanTa-arkkitehtuurissa hyödynnettävät standardit
ja määräykset, suositukset, hyvät käytännöt sekä
soveltamisohjeet
HL7 Finlandin Suomeen sovitetut
rajapintakuvaukset sote-tietojärjestelmiä varten
www.kanta.fi, KanTa-palvelujen voimassa
olevat määritykset
Taltioni kehittäjän opas, tietomalli- ja
rajapintakuvaukset
www.taltioni.fi/fi/kumppanit/kehityssivut
HL7rajapintastandardit
Taltioni-määritykset
www.sosiaaliportti.fi/…/standardisalkku.pdf
www.hl7.fi/hl7-rajapintakartta/
14
2. Periaatetason arkkitehtuurilinjaukset
Standardisalkku 2/2
•
Palvelukohtaiset standardisuositukset ja määritykset
Palvelu/Nimi
Palveluhakemisto:
JHS183 (entinen
JHS145)
Kuvaus
Lähde/viite
Palvelutietojen ryhmittely ja osoitteet
asiointia varten monta toimialaa
kattavissa julkisen sektorin portaaleissa
Jatkossa JHS183, www.jhs-suositukset.fi/suomi/
Sote-tietopalvelu ja
riskitestit:
Palautepalvelu:
Ajanvaraus:
HL7 v3 ajanvarausmääritykset
Ajanvarauskyselyt ja aikojen varaamiset
www.hl7.fi/hl7-rajapintakartta/ajanvarausrajapintojenresursseja hallinnoiviin järjestelmiin
hl7v3-maarittelyt/
alueellista ja kansalaisajanvarausta varten
Turvallinen
viestinvälitys:
-
15
Liite 2.
Standardisalkku (JHS 181) 1/6
•
Sosiaali- ja terveydenhuollon sähköisten asiointipalvelujen kannalta
keskeisiä standardeja:
Nimi
JHS181
Kuvaus
JHKA-standardisalkku
RFC 2141
RFC 2141, URN, Uniform resource name - generic www.ietf.org
syntax
RFC 3986
RFC 3986, URI, Uniform Resource Identifier www.ietf.org
generic syntax
ISO 8601:2004: Representation of dates and times www.iso.org
ISO 8601:2004
Lähde/viite
www.jhs-suositukset.fi/suomi/jhs181
ISO 80000-1:2009
ISO 80000-1:2009, Quantities and units -- Part 1:
General
www.iso.org
ISO 19101-1
ISO 19101-1 Geographic information - Reference
model -- Part 1: Fundamentals
www.iso.org
ISO 6709:2008
ISO 6709:2008 Standard representation of
geographical point position by coordinates
www.iso.org
16
Liite 2.
Standardisalkku (sosiaalihuollon kansallinen
kokonaisarkkitehtuuri) 2/6
Nimi
Kuvaus
Sosiaalihuollon KA Sosiaalihuollon kansallinen KA,
standardisalkku
standardisalkku
Lähde/viite
www.sosiaaliportti.fi/…/standardisalkku.p
df
JHS 159
JHS 159, ISO OID-yksilöintitunnuksen
soveltaminen julkishallinnossa
www.jhs-suositukset.fi/suomi/jhs159
ISO 19005-1/2/3
PDF/A
www.iso.org
HL7 v3 Medical
Records
HL7 Version 3 Standard: Medical Records, Release www.hl7.org
1 (R2011)
HL7 v3 CDA R2
HL7 Version 3 Standard: Clinical Document
Architecture (CDA), Release 2
www.hl7.org
Sosiaalihuollon
asiakasasiakirjojen
metatiedot
SosXML
Sosiaalihuollon asiakasasiakirjojen metatiedot –
määritys, Tikesos-hanke, 2011
www.sosiaaliportti.fi
SosXML, Sosiaalihuollon asiakirjastandardi,
Tikesos-hanke, 2011
www.sosiaaliportti.fi
17
Liite 2.
Standardisalkku (KanTa) 3/6
Nimi
KanTa
standardisalkku
Kuvaus
KanTa-arkkitehtuurissa hyödynnettävät
standardit ja määräykset, suositukset, hyvät
käytännöt sekä soveltamisohjeet
Lähde/viite
www.kanta.fi, KanTa-palvelujen voimassa
olevat määritykset
Kansallisesti
vaadittujen tietojen
välittäminen ydin- ja
erillisjärjestelmien
välillä
HL7-Finland – V3
messaging
Koodistopalvelun
tiedonsiirron tekninen
ohje
Kansallisesti vaadittujen tietojen välittäminen ydinja erillisjärjestelmien välillä, v2.1, HL7 Finland,
2012
www.kanta.fi
HL7-Finland – V3 messaging V 2.20, HL7 Finland,
2010
Koodistopalvelun tiedonsiirron tekninen ohje V2.1,
THL/Stakes, 2007
www.kanta.fi
www.kanta.fi
18
Liite 2.
Standardisalkku (HL7) 4/6
Nimi
HL7rajapintastandardit
HL7-Finland –
Tietotyypit
Kuvaus
Lähde/viite
HL7 Finlandin Suomeen sovitetut
www.hl7.fi/hl7-rajapintakartta/
rajapintakuvaukset sote-tietojärjestelmiä varten
HL7-Finland – Tietotyypit, v1.31
www.kanta.fi
ISO OID-yksilöintitunnuksen käytön
kansall. periaatteet
sote-alalla
Common Message
Element Types
(CMET)
Päätöksentuen CDA
R2
ISO OID-yksilöintitunnuksen käytön kansalliset
periaatteet sosiaali- ja terveysalalla, THL, 2011
www.thl.fi
Open CDA 2007 - Common Message Element
Types (CMET), v0.7, HL7 Finland, 2008
www.kanta.fi
Open CDA 2007 – Päätöksentuen CDA R2 v.3.0 ,
HL7 Finland, 2007
www.kanta.fi
Terveys- ja hoitosuunnitelman CDA
R2 potilaskertomusrakenne
XML-allekirjoituksen
soveltamisopas
Terveys- ja hoitosuunnitelman CDA R2
potilaskertomusrakenne, v1.0, HL7 Finland, 2012
www.kanta.fi
Open CDA 2008 - XML-allekirjoituksen
soveltamisopas v. 1.00, HL7 Finland, 2008
www.kanta.fi
19
Liite 2.
Standardisalkku (ydintietomäärittelyjä) 5/6
Nimi
Asiointi-/äidinkieli
Kuvaus
Lähde/viite
SFS-ISO 639, Kielten nimien tunnukset, SFS, 1993 www.sfs.fi
Kansalaisuus
JHS 123 Valtioiden ja maiden luokitusjärjestelmä,
ISO 3166, SFS-ISO 3166
www.jhs-suositukset.fi, www.sfs.fi
Kotikunta
VRK/THL Kuntakoodit, JHS 110 Kuntien
numerotunnus
www.jhs-suositukset.fi,
Kansallinen koodistopalvelu
Veriryhmä
AR/YDIN Veriryhmä, RhD Veriryhmä
Kansallinen koodistopalvelu
Diagnoosi
ICD-10 tautiluokitus, ICPC 2
perusterveydenhuollon luokitus, AR/YDIN
Diagnoosin tyyppi
Fimea: ATC-luokitus, lääkekoodi, lääkemuoto
Kansallinen koodistopalvelu
Rokotteet
Fimea: ATC-luokitus, rokotekoodi, AR/YDIN
Pistoskohta, AR/YDIN Rokotustapa
Kansallinen koodistopalvelu
Tupakointi
AR/YDIN Tupakointi
Kansallinen koodistopalvelu
Laboratorio
Kuntaliitto: Laboratoriotutkimusnimikkeistö 2010
Kunnat.net
Toimenpiteet
THL - toimenpideluokitus
Kansallinen koodistopalvelu
Lääkitys
Kansallinen koodistopalvelu
20
Liite 2.
Standardisalkku (muut määritykset) 6/6
Nimi
RFC 4791
RFC 5545
Kuvaus
RFC 4791, Calendaring Extensions to WebDAV
(CalDAV)
RFC 5545, Internet Calendaring and Scheduling
Core Object Specification (iCalendar)
Lähde/viite
www.ietf.org
www.ietf.org
21