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:
Helseaktøren sender oppgaven til innbygger via Helsenorge.
Innbygger varsles om mottatt oppgave og kan logge seg inn på Helsenorge å finne mottatt oppgave.
Innbygger kan se oppgavens innhold, se frister, samt starte oppgaven i eksternt system (via lenke som avsender sendte med i oppgaven)
Innbygger vil også påminnes om eventuelt ikke utført oppgave når fristen nærmer seg
Eksternt system må understøtte single-sign-on via Helsenorge innloggingsløsning: 03 - Innbygger innlogging - Helsenorge som OpenID Connect provider
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
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 når oppgave er utført (i eksternt system)
Oppgavens status endres ved å benytte FHIRPath Patch. Se her: Oppdaterer allerede innsendt oppgave (Kommer H1 - 2022)
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)