Generisk oppgave - utføres i system utenfor Helsenorge
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
Hvordan FHIR Task skal benyttes er beskrevet i detalj her: FHIR Task - Oppgave , se eksempel under
Merk at FHIR Task.focus er av type “Task” for generiske oppgaver
Innsending av generisk oppgave
Her benyttes Oppgave API (som understøtter både Meldingsbasert- og REST integrasjon): Oppgave API
XML-eksempler på innsending av generisk oppgave
Eksempel på Payload (FHIR Task):
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: Oppdatering av attributter på Task (FhirPatch) | Status alene, oppgave ferdig utført i eksternt system (Task.status)