/
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 vil finne informasjon om verktøyet gjennom å gjø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.

🔔Varsler for oppgaver er beskrevet her: Oppgaver til innbygger | Varsler til innbygger

Hvordan sende en verktøystartoppgave til innbygger?

Det er tre måter en helseaktør kan sende verktøy til innbygger:

  • Som ‘tips’ via Verktøyformidleren (nasjonale verktøy)

  • Som del av behandling/forløp:

    • Via OppgaveAPI

    • Via VerktøyAPI (forenklet utgave av OppgaveAPI)

 

Under er en oversikt over forskjellene i APIene og hva som brukes når:

Sende ut verktøy til innbygger med VerktøyAPIet

Sende ut verktøy til innbygger med OppgaveAPIet

Sende ut verktøy til innbygger med VerktøyAPIet

Sende ut verktøy til innbygger med OppgaveAPIet

  • 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

  • Hvis verktøyet benytter tilpasset tilgangsstyring for å kun tillate enkelte representasjonsforhold i bruk av verktøyet vil dette kunne påvirke representanters tilgang til å kunne utføre oppgaven på vegne av innbygger

  • Standardisert FHIR-API med mye fleksibilitet og valg knyttet til forretningslogikk og bruk som benyttes 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 ett verktøy blant flere som de skal kunne sende ut (som en erstatning for Verktøyformidleren)

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

  • Tilgang til å utføre oppgaven følger sentral tilgangsstyring på Helsenorge, evt spesifikke regler for utførelse satt i oppgaven (FHIR Task)

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

En oppgave på Helsenorge representeres alltid i form av en FHIR-ressurs av typen Task, så også for verktøystartoppgave. Hvordan FHIR Task skal benyttes er beskrevet i detalj her: FHIR Task - Oppgave

Meldingsbasert bruk av API - Hodemelding med FHIR Task

Bruk av REST-API

FHIR Task xml:

Merk: Samme innhold som ‘Document’ i hodemelding.

 

Request xml:

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

 

Response xml:

  • 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 .