Hva er en verktøystartoppgave?
En helseaktør benytter verktøystartoppgave for å sende et verktøy til en innbygger/pasient slik at innbygger må ta aktivt stilling til å bruke verktøyet. De fleste verktøy kan innbygger finne og starte selv i verktøyoversikten på Helsenorge, mens noen krever forskriving av behandler. Ved å sende verktøy som oppgave forskriver helseaktør verktøyet til innbygger.
Innbygger får et varsel på Helsenorge om mottatt oppgave og vil finne informasjon om verktøyet gjennom å utføre oppgaven. Ved å takke ja til å ta verktøyet i bruk legger verktøyet seg automatisk i ‘Mine verktøy’ og det vil være enkelt å finne tilbake til og fortsette bruk av verktøyet.
Oppgaven gis med en frist slik at innbygger varsles når fristen nærmer seg.
Hvis innbygger takker nei til bruk av verktøyet og verktøyet krever forskrivning får innbygger beskjed om å kontakte behandler for ny forskrivning.
Hvordan sende en verktøystartoppgave til innbygger?
Bruk av Oppgave - FHIR Task
En verktøystartoppgave representeres alltid som en oppgave i form av en FHIR-ressurs av typen Task
Hvordan FHIR Task skal benyttes er beskrevet i detalj her: FHIR Task - Oppgave , se eksempel under
Sending av oppgave til innbygger
En verktøystartoppgave sendes til Helsenorge via Oppgave-API: Oppgave API
Eksempel på innsending av verktøystartoppgave
Meldingsbasert bruk av API - Hodemelding med FHIR Task
Bruk av REST-API
Request
curl -X POST \
-H "Content-Type: application/xml" -H "Authorization: Bearer <access_token>"\
-d 'FHIR Task i xml' \
<BaseUrl/oppgave/v1/task> (For BaseUrl, se: Testmiljøer og endepunkter )
FHIR Task i xml (samme innhold som Document i Hodemelding):
Respons
HTTP respons:
OK: 201 - created. Ved suksessfull opprettelse av ressursen og påfølgende respons vil
Locationheaderen være satt inneholdende logisk id , i tillegg returneres den opprettede ressursen i sin helhet.Feil: 400 - error + FHIR OperationOutcome