Generisk oppgave - utføres i system utenfor Helsenorge

Owned by Kenneth Myhra
Last updated: Nov 23, 2023 by sven.christiansen

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

  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

Innsending av generisk oppgave

Her benyttes Oppgave API (som understøtter både Meldingsbasert- og REST integrasjon): https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2109734913

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:

  • Varsling av innbygger skal undertrykkes som angitt i referansen over

  • Task.status skal endres. Se her: