/
Verktøystartoppgave

Verktøystartoppgave

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 at behandler/helseaktør sender dem (se https://helsenorge.atlassian.net/wiki/x/noCEb).

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 at behandler/helseaktør sender det får innbygger beskjed om å kontakte behandler/helseaktør for å sende på nytt.

Hvordan sende en verktøystartoppgave til innbygger?

Bruk av Oppgave - FHIR Task

Sending av oppgave til innbygger

En verktøystartoppgave sendes til Helsenorge via Oppgave-API: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2109734913 , eller i en forenklet utgave via Verktøy-API: https://helsenorge.atlassian.net/wiki/x/JYGEb

Under er en oversikt over forskjellene og hva som brukes når.

Sende ut verktøy til innbygger med Verktøy-APIet

Sende ut verktøy til innbygger med Oppgave-APIet (verktøystartoppgave)

Sende ut verktøy til innbygger med Verktøy-APIet

Sende ut verktøy til innbygger med Oppgave-APIet (verktøystartoppgave)

  • Lettvekts-API som er enkelt å implementere og ta i bruk. Mye av logikken og kompleksiteten er standardisert og håndteres av Helsenorge.

  • Kan kun implementeres og brukes for å sende et bestemt verktøy (som regel fra behandlerdelen av verktøyet selv)

  • Støtter retur av pseudo-ID for eldre integrasjonsformer

  • Standardisert FHIR-API med mye fleksibilitet og valg knyttet til forretningslogikk og bruk som kan brukes til å sende ulike typer av oppgaver til innbyggere. Det å starte å bruke et verktøy er en spesifikk oppgavetype blant mange andre som også tilbys.

  • Enkelt å ta i bruk hvis løsningen allerede sender ut oppgaver i andre sammenhenger, men høy brukerterskel ved førstegangs implementasjon. Dermed mest egnet for større aktører og systemer som har behov for å sende ut flere typer av oppgaver.

  • Kan på sikt brukes av EPJer eller andre systemer for å velge blant et utvalg av verktøy som de skal kunne sende ut (som en erstatning for Verktøyformidleren)

  • Har ikke støtte for retur av pseudo-ID

Dokumentasjon og mer informasjon: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1820623141

Dokumentasjon og mer informasjon: se denne siden

Eksempel på innsending av verktøystartoppgave via Oppgave-API

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: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1552384092 )

 

FHIR Task i xml (samme innhold som Document i Hodemelding):

Response

  • HTTP response:

    • OK: 201 - created. Ved suksessfull opprettelse av ressursen og påfølgende respons vil Location headeren være satt inneholdende logisk id , i tillegg returneres den opprettede ressursen i sin helhet.

    • Feil: 400 - error + FHIR OperationOutcome

 

For eksempel på innsending via Verktøy-API, se https://helsenorge.atlassian.net/wiki/x/JYGEb .