Hva er en generisk oppgave

For noen typer oppgaver utføres hele, eller deler, av oppgaven i en arbeidsflyt på Helsenorge. Dette gjelder blant annet Skjemaoppgaver og Samtykkeforespørsler.

For oppgaver man vil at innbygger skal utføre, men der oppgave i sin helhet utføres i et annet system (utenfor Helsenorge) har vi definert en generisk oppgavetype.

Overordnet om integrasjon mellom eksternt system og Helsenorge

Arbeidsflyten for denne type oppgaver er som følger:

1. Helseaktøren sender oppgaven til innbygger via Helsenorge.

2. Innbygger varsles om mottatt oppgave og kan logge seg inn på Helsenorge å finne mottatt oppgave.

3. Innbygger kan se oppgavens innhold, se frister, samt starte oppgaven i eksternt system (via lenke som avsender sendte med i oppgaven)

   1. Innbygger vil også påminnes om eventuelt ikke utført oppgave når fristen nærmer seg

4. Eksternt system må understøtte single-sign-on via Helsenorge innloggingsløsning: 03 - Innbygger innlogging - Helsenorge som OpenID Connect provider

5. Når innbygger har fullført oppgaven i eksternt system, skal dette systemet rapportere tilbake til Helsenorge at oppgaven er utført.

Oppgave - FHIR Task

• En generisk oppgave representeres alltid som en FHIR ressurs av typen Task (http://hl7.org/fhir/task.html )

• Hvordan FHIR Task skal benyttes for er beskrevet i detalj her: FHIR Task - Oppgave

  • Merk at FHIR Task.focus er av type “Task” for generiske oppgaver

Innsending av generisk oppgave

REST API

Hente AksessToken

• API-klienten må på forhånd være definert i Helsenorge sikkerhetstjeneste med de ødvedig tilganger til API

• API-klienten må hente AksessToken for å kunne benytte API. Se sikkerhetsmodell 01 - System til System - V2

Etterfølgende kall til REST-API

• AksessToken må inkluderes i Authorization header: Se: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/23789578/02+-+Kall+til+Helsenorge+og+PVK+API+er+og+bruk+av+AccessToken

• (HTTP POST): https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1254654012/FHIR+-+REST+Operasjoner#Create---HTTP-POST

  • Eks Task: POST [base]/oppgave/v1/Task

• Eksempel på Payload (FHIR Task):

Meldingsbasert integrasjon (AMQP)

Innsending av skjemaoppgave som Hodemelding med FHIR Task eller FHIR Bundle er beskrevet her: AMQP Oppgaveforespørsel

Eksempel på Hodemelding med generisk oppgave (Vedlegg dokument er det samme som payload ved rest kall):

Oppdatere status på Helsenorge når oppgave er utført (i eksternt system)

Oppgavens status endres ved å benytte FHIRPath Patch. Se her: Oppdaterer allerede innsendt oppgave

• Varsling av innbygger skal undertrykkes som angitt i referansen over

• Task.status skal endres. Se her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1679360035/Oppdatering+av+attributter+p+Task+FhirPatch#Status-alene%2C-oppgave-ferdig-utf%C3%B8rt-i-eksternt-system-(Task.status)