Kanta PHR:n Sandboxympäristöt. Eeva Turkka

Samankaltaiset tiedostot
Kanta PHR:n CapabilityStatement ja REST-API. Eeva Turkka

Kanta PHR:n CapabilityStatement ja REST-API. Eeva Turkka

Kansallinen Omakannan Omatietovaranto, kansalaisen hyvinvointitiedon tallennuspaikka

HL7 Finland koulutus. FHIR profilointi osa , Helsinki. Tietohiisi, Mika Tuomainen

Omatietovaranto. Sovellustoimittajat

HL7 Finland koulutus. FHIR profilointi osa , Helsinki. Tietohiisi, Mika Tuomainen

Sosiaalihuollon asiakastiedon arkiston validointipalvelu. Käyttöohje

Omatietovaranto. Hyvinvointipalvelujen iltapäivä kanta.fi/phr

Sosiaalihuollon asiakastiedon arkiston validointipalvelu

WithMe Preventive occupational health trial

T Hypermediadokumentin laatiminen. Sisältö. Tavoitteet. Mitä on www-ohjelmointi? Arkkitehtuuri (yleisesti) Interaktiivisuuden keinot

GroupWise Calendar Publishing Host User

Omatietovaranto. Ajankohtaista. Anna Korpela, Kela Anniina Pylsy, THL

Onecapital Invoicer XML API

HL7 Finland koulutus. FHIR perusteet , Helsinki. Tietohiisi, Mika Tuomainen

Omatietovaranto. Jari Suhonen, THL Jari Suhoenn/ OPER

Mainosankkuri.fi-palvelun käyttöohjeita

Omatietovaranto tilannekatsaus

Järjestelmäarkkitehtuuri (TK081702)

Palvelukuvaus Omakannan Omatietovaranto

Sivuston tiedotakcpshop.de.websiteoutlook.com

Action Request System

Tietokantasovellus (4 op) - Web-sovellukset ja niiden toteutus

Suuli api dokumentaatio

EMVHost Online SUBJECT: EMVHOST ONLINE CLIENT - AUTOMAATTISIIRROT COMPANY: EMVHost Online Client sovelluksen käyttöohje AUTHOR: DATE:

Mittaustietojen SAF-aineistokuvaus kaasudatahubiin

Ilmonet ja rajapinnat Pääkaupunkiseudun kansalais- ja työväenopistojen kurssit

Kasvuseula. Omatietovaranto kommentointikokous, kesäkuu Juha Leppänen VTT 2018

WWW-sivut HTML-kielellä esitettyä hypertekstiaineistoa

MultiSender -mobiilisovellus

OSI ja Protokollapino

Wordpress-julkaisualusta. Mediatekniikan seminaari Harri Viitala

F-Secure KEY salasanojenhallintaohjelman käyttöönotto PC -laitteella

Kansalaisen Omakannan Omatietovaranto. ammattilaisten uusien työtapojen mahdollistaja

Written by Administrator Monday, 05 September :14 - Last Updated Thursday, 23 February :36

Tekstiviestipalvelun rajapintakuvaus

XPages käyttö ja edut Jarkko Pietikäinen toimitusjohtaja, Netwell Oy

DYNAMIC CARE PLANNING (DCP) JA DYNAMIC CARE TEAM MANAGEMENT (DCTM) IHE-PROFIILIT. Konstantin Hyppönen IHE-Finland

Taustaa. CGI-ohjelmointi

HL7 Finland koulutus. FHIR profilointi perusteet , Helsinki. Tietohiisi, Mika Tuomainen

Sivuston tiedotmysiteworthcheck.com

Avoin metsätieto - Rajapintapalvelut

Laajuus 5 op Luennot: 12 x 2t Harjoitukset: 7 viikkoharjoitusta harjoitusten tekemiseen saatavissa apua 2 ryhmää / harjoitus

Omakannan omatietovaranto aka Kansallinen PHR. Konstantin Hyppönen, Kanta-palvelut, Kela HL7 Finland PH SIG -kokous

Veronumero.fi Tarkastaja rajapinta

Putteri Käyttöliittymä ja ulkoasu

F-Secure KEY salasanojenhallintaohjelman käyttöönotto Mac -laitteella

CLOUDBACKUP TSM varmistusohjelmiston asennus

KYMENLAAKSON AMMATTIKORKEAKOULU Tietotekniikan koulutusohjelma / Tietoverkkotekniikka. Joni Korjala APACHE WWW-PALVELIN Seminaarityö 2012

DXL Library ja DXL-kielen olemus. Pekka Mäkinen SoftQA Oy http/

OMA SÄÄSTÖPANKIN TUNNISTUSPALVELUN PALVELUKUVAUS

HAKURATKAISUN ANATOMIA - KURKISTUS PELLIN ALLE

Visma Nova. Visma Nova ASP käyttö ja ohjeet

Käyttäjähallintapalvelun REST-rajapinnat

Trimble Feedback Mobile app ja rajapinnat Kuvaus

K U U L A L A A K E R I LUOTTAMUKSELLINEN 1(6)

Digikoulu Pilviteknologiat - Tunti 1001: Tiedon varastointi Amazon Simple Storage Service (Amazon S3) palveluun

WEB SERVICES RAJAPINTA SAMLINKIN TEKNINEN RAJAPINTAKUVAUS OHJELMISTOTALOILLE

Palvelukuvaus 1 (10) Handelsbankenin tunnistuspalvelun palvelukuvaus

POP PANKIN TUNNISTUSPALVELUN PALVELUKUVAUS

Tapahtumakalenteri & Jäsentietojärjestelmä Ylläpito

Verkkotietopisteen sähköisen rajapinnan ohje ja tekninen kuvaus

PIKAOHJE Web of Science tietokantojen käyttöön

PRINTER DRIVER PÄÄKÄYTTÄJÄN OPAS

Sukupuu -ohjelma. Ossi Väre ( ) Joni Virtanen ( )

ETÄTERMINAALIYHTEYS SELAIMELLA

PH SIG tietosisältömäärittelyn rooli kansallisessa kehittämisessä

JWT 2016 luento 11. to klo Aulikki Hyrskykari. PinniB Aulikki Hyrskykari

Sivuston nopeus. Poista hahmonnuksen estävä JavaScript ja CSS sivun yläosan sisällöstä

Hyvinvoinnin tulevaisuus on pian täällä

Omakannan Omatietovaranto palvelun asiakastestaus

Toimintaympäristön kuvaus. LTC-Otso Myyjän työkalu (POC)

Sivuston nopeus. Poista hahmonnuksen estävä JavaScript ja CSS sivun yläosan sisällöstä

EASY Tiedostopalvelin - mobiilin käyttöopas

Sivuston tiedotqbooksupportpho nenumber.com

Sivuston tiedotemreemir.com

Työasemien hallinta Microsoft System Center Configuration Manager Jarno Mäki Head of Training Operations M.Eng, MCT, MCSE:Security, MCTS

MY STANDARD -OHJE. mystandard.hansaworld.com. Standard ERP Pilvipalvelu Sivu 1/6

ZENworks Application Virtualization 11

Software Signing System System overview and key domain concepts

Kuljetus- ja sovelluskerroksen tietoturvaratkaisut. Transport Layer Security (TLS) TLS:n suojaama sähköposti

Valppaan asennus- ja käyttöohje

WWW-ohjelmointi ANTTI SAND TIETA12

X-Road ja WFS-rajapinnat, uudet APIt. Pekka Latvala , KaPA ja paikkatietoinfrastruktuurin kärkiteeman työpaja

Verkkotietopisteen sähköisen rajapinnan käyttöönotto

Tässä ohjeessa käydään läpi sosiaalisen median verkkopalveluiden lisätoimintojen lisääminen verkkosivuillesi.

10 Nykyaikainen WWW-arkkitehtuuri

SeaMonkey pikaopas - 1

Digiroad-aineiston hyödyntäminen rajapintapalveluiden kautta MapInfo

Arkkitehtuuri. Ylätason sovellusarkkitehtuuri

OP Tunnistuksen välityspalvelu

Mark Summary Form. Taitaja Skill Number 205 Skill Tietokoneet ja verkot. Competitor Name

REST rajapintana mobiilikehityksessä

Miten Internet toimii. Jyry Suvilehto T Johdatus tietoliikenteeseen ja multimediatekniikkaan kevät 2010

Kieliversiointityökalu Java-ohjelmistoon. Ohje

Gree Smart -sovelluksen (WiFi) asennus- ja käyttöohje: Hansol-sarjan ilmalämpöpumput WiFi-ominaisuuksilla

Tilastokeskuksen rajapintapalveluiden käyttöönotto MapInfo - ohjelmistossa Ohjeita laatiessa on käytetty MapInfon versiota 11.5.

Käyttötilastot - lokakuussa 2008

Sivuston tiedotreviewproducts.org

Transkriptio:

Kanta PHR:n Sandboxympäristöt Eeva Turkka 16.4.2018

Mikä on Sandbox Sandbox on Kanta PHR:n avoin kehitys- ja kokeiluympäristö, jota voi käyttää itsenäisesti Sandboxin sovellukset noudattavat Kanta PHR: toimintoja, esimerkiksi FHIRin osalta tuettuina ovat samat resurssit kuin oikeassa Kanta PHR:ssä Ympäristöä voi käyttää kehittämiseen ja kokeiluun vapaasti

Reunaehtoja Ympäristössä ei saa käyttää oikeiden henkilöiden henkilötunnisteita, eli hetut on valittava 9xx -avaruudesta Oikeaa henkilötietoa ja potilastietoa ympäristöön ei saa tallentaa Tiedon säilymistä ei taata ja koska tunnistamatonta sandboxia voi käyttää vapaasti, voi joku muukin käyttää tietoja jos sattuu tietämään pseudonyymin Virallisia julkaistuja profiileja ei saa ylikirjoittaa, mutta näiden rinnalle voi tehdä omia testiprofiileja 3

Kanta.fi sivuston ohjeet löytyvät englanninkieliseltä sivustolta http://www.kanta.fi/en/web/ammattilaisille/tarkeaa-tietoa-kehittajille

Ympäristöt Client tunnistuksen kanssa Client ilman tunnistusta FHIR-palvelin Auktorisoiva FHIR-palvelin OAuth2.0- palvelin FHIR-data OAuth2.0-data 5

Sandboxit Sandbox 1: http://fhirsandbox.kanta.fi/phr-resourceserver/basestu3/ - Vain resurssipalvelin - Resurssihakuja ja tallennuksia voi kokeilla käyttöliittymällä Sandbox 2: https://fhirsandbox2.kanta.fi/phr-resourceserver/basestu3/ https://fhirsandbox2-auth.kanta.fi/phr-authserver-sandbox/ Resurssipalvelin ja auktorisointipalvelin 6

Resurssipalvelin ilman tunnistusta 7

FHIR-palvelin http://fhirsandbox.kanta.fi/phr-resourceserver/basestu3/ FHIRin REST-Crudin mukaiset toiminnot Create Read Update Delete Search https://www.hl7.org/fhir/http.html 8

Käyttöliittymä http://fhirsandbox.kanta.fi/phr-resourceserver-ui/ 9

Potilaan lisääminen ei tunnistusta Luo uusi uuid. Verkossa on sivustoja, version 4 satunnaisuuid käy 91db836a-b62a-49af-8e7a-a94ed90a41d5 { "resourcetype": "Patient", "id": "91db836a-b62a-49af-8e7a-a94ed90a41d5", "meta": { "profile": [ "http://phr.kanta.fi/structuredefinition/fiphr-patient-stu3" ] }, "identifier": [ { "system": "urn:ietf:rfc:3986", "value": "91db836a-b62a-49af-8e7a-a94ed90a41d5" } ], "active": true } Potilas lisätään poikkeuksellisesti UPDATE-pyyntönä, jolloin resurssille saa määrättyä uuidin. Tähän uuidiin viitataan myöhemmin mittauksista. 10

11

Käyttöliittymästä näkee esimerkkikutsun 12

Potilaan tallennus Request PUT http://fhirsandbox.kanta.fi/phr- resourceserver/basestu3/patient/4813f08b-beea-4007-a7dc- 033c072d0293?_format=json&_pretty=true Request Headers Accept-Charset: utf-8 Accept: application/fhir+json;q=1.0, application/json+fhir;q=0.9 User-Agent: HAPI-FHIR/2.4 (FHIR Client; FHIR 3.0.1/DSTU3; apache) Accept-Encoding: gzip Content-Type: application/fhir+json; charset=utf-8 13

Vastaus Response Response Headers HTTP/1.1 200 OK X-Powered-By: Servlet/3.1 X-Powered-By: HAPI FHIR 3.2.0 REST Server (FHIR Server; FHIR 3.0.1/DSTU3) ETag: W/"1" Location: http://fhirsandbox.kanta.fi/phr- resourceserver/basestu3/patient/4813f08b-beea- 4007-a7dc-033c072d0293/_history/1 Content-Language: en-us Date: Mon, 16 Apr 2018 07:13:17 GMT 14

Mittaustuloksen lisääminen potilaalle Esimerkkiresurssit löytyvät Simplifierista Edellä luotu potilas-viittaus lisätään subject-kenttään Myös mittauksen tekijä on potilas itse valuequantityyn (tai vastaavaan value-tyyppiseen tietoon) lisätään mittaustulos { "resourcetype": "Observation", "meta": { "profile": [ "http://phr.kanta.fi/structuredefinition/fiphr-bodyweight-stu3" ] }, "language": "fi", "text": { "status": "generated", "div": "<div>code: Body weight (29463-7)<br />Time: 20.11.2017 11:46<br />Result: 78 kg</div>" }, "identifier": [ { "system": "urn:ietf:rfc:3986", "value": "urn:uuid:3aa26139-13ed-4f2a-bdf4-11dd5fd40f0f" } ], "status": "final", "category": [ { "coding": [ { "code": "vital-signs", "system": "http://hl7.org/fhir/observation-category" } ] } ], "code": { "coding": [ { "code": "29463-7", "display": "Body weight", "system": "http://loinc.org" } ] }, "subject": { "reference": "Patient/91db836a-b62a-49af-8e7a-a94ed90a41d5" }, "effectivedatetime": "2017-11-20T11:46:00+02:00", "issued": "2017-11-20T11:46:00+02:00", "performer": [ { "reference": "Patient/91db836a-b62a-49af-8e7a-a94ed90a41d5" } ], "valuequantity": { "value": 78, "unit": "kg", "system": "http://unitsofmeasure.org", "code": "kg" } } 15

Omat profiilit Jokaisessa resurssissa on viitattava profiiliin Profiili ludoaan sandboxiin tallentamalla sinne StructureDefinitiontyyppinen resurssi, jossa on tallennettuna profiilin rajaukset Resurssi on tallennettava json-muotoisena ja siinä on oltava mukana snapshot-osio, jota validointi hyödyntää Statuksen tulee olla experimental draft Profiileihin viitataan urlilla ja sen alun pitäisi olla http://phr.kanta.fi ja loppuosan ei pidä alkaa fiphr, joka on varattu hyväksytyille virallisille profiileille 16

Esimerkki { "resourcetype":"structuredefinition", "id":"test1-patient-stu3", "url":"http://phr.kanta.fi/structuredefinition/test1-patient-stu3", } 17

Työkaluja käyttöliittymän lisäksi Postman plugin selaimeen, jolla voi lähettää fhir-pyyntöjä Curlilla voi kätevästi lähettää.json-tiedostoja Resurssit ovat jsonia, joten json-editorista tai ainakin ymmärtävästä työkalusta on apua 18

Resurssipalvelin tunnistuksen kanssa 19

Tunnistautuminen Oauthilla Tunnistavassa sandboxissa on käytössä OAuth2.0 tunnistus Sandbox-clientit voivat käyttää Authorization code flowta ja client secret tunnistusta Ideana on, että sovellus ohjaa käyttäjän tunnistautumaan ja antamaan luvan sovellukselle käyttää käyttäjän tietoja Tällä luvalla sovellus voi esimerkiksi tallentaa ja hakea tietoa. https://fhirsandbox2-auth.kanta.fi/phr-authserver-sandbox/ 20

Resurssipyynnöt tokenin kanssa Luvan saanut sovellus saa käyttöönsä access tokenin Access tokenin kanssa sovellus voi lähettää resurssipyynnön fhirpalvelimelle lisäten Authorization-headeriin tokenin FHIR-palvelin tokenin tietojen perusteella tarkastaa onko sovelluksella lupa kyseiseen pyyntöön, esimerkiksi tallentaa viitatulle potilaalle tietoja https://fhirsandbox2.kanta.fi/phr-resourceserver/basestu3/ Ei vastaa ilman access tokenia 21

Ohjeet tunnistavan Sandboxin käyttöön Sandboxille on oma auktorisointiopas Kanta.fi-sivuilla Käyttäjätunnusten itserekisteröinti https://fhirsandbox2-auth.kanta.fi/phr-authserversandbox/registeruser Tunnistuksesta lisää ensi kerralla Mistä aiheista haluatte kuulla tarkemmin? 22

Avoimia FHIR-kirjastoja ja työkaluja alkuunpääsemiseksi Hapi, java-toteutus FHIRille, sisältää mm. palvelimen, clientin ja paljon muuta: http://hapifhir.io/ Spark,.NET FHIR-palvelin: https://github.com/firelyteam/spark Fhir.js on JavaScript fhir-clientti: https://github.com/fhir/fhir.js Rubylle fhir-client: https://github.com/fhir-crucible/fhir_client Lisäksi paljon toteutuschattia on chat.fhir.org:issa (kaikille kehittäjille tutun Stackoverflown lisäksi) https://chat.fhir.org/ 23

Kiitos Eeva Turkka Software architect eeva.turkka@citrus.fi 24