Innledning

Gjennom bruk av FHIR-ressurser i skjemaløsningen har vi lagt til rette for at aktørene kan benytte forskjellig teknologi for integrasjon. Aktøren velger om man ønsker å benytte meldingsbasert integrasjon eller integrasjon via API’er.

Oppdatere innsendt oppgave

• Alle oppgaver er representert ved en FHIR Task: Detaljert beskrivelse: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/742948883

• Noen av feltene på en allerede innsendt oppgave kan endres i ettertid:

  • Oppgavens status (Task.status)

  • Tekst med grunn for at siste statusendring skjedde (Task.statusReason)

  • Det kan legges til tekstlige notater (Task.note)

  • Fristene kan endres:

    • Task.restriction.periode.end

    • Eventuelt også extension: Task.restriction.http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline MERK: Dersom opsjonen med “deadline” extension benyttes i opprinnelig oppgave, må denne alltid også settes ved FHIR PATCH dersom Task.restriction.period.end endres (selv om den ikke er endret). Man må altså angi begge elementer i Task.restriction ved en PATCH.

  • Beskrivelsen kan endres (Task.description)

• Ved oppdatering av et eller flere av disse benyttes FHIR PATCH (Se underside for detaljer: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1679360035 )

Følgende begrensninger/forretningsregler er definert på Helsenorge for hva som kan oppdateres når:

• Følgende felter kan ikke oppdateres

  • Dersom:

    • Task.status = “completed”', “cancelled” eller “entered-in-error”.

    • Oppgavens gyldighet er passert, dvs. nåværende tidspunkt er etter det siste av:

      • Task.restriction.periode.end

      • Task.restriction.http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline

  • Følgende felter kan da ikke lenger opdateres

    • Gyldighet (Task.restriction.periode.end og/eller Task.restriction.http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline)

    • Beskrivelse (Task.description)

    • Status (Task.status)

    • Begrunnelse for siste status oppdatering (Task.statusReason)

• Begrunnelse for siste status oppdatering (Task.statusReason kan kun settes når Status (Task.status) endres samtidig

• Angivelse av gyldighet

  • Gyldighet (Task.restriction.periode.end og/eller Task.restriction.http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline) må være frem i tid (minst en dag)

  • Task.restriction.http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline) må være senere enn Task.restriction.periode.end

• Notat til oppgaven (Task.note) kan når som helst legges til oppgaven

REST API

• Det benyttes sikkerhetsmodell system-til-system: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1886191617

• (HTTP POST):

  • Eks Task: PATCH [base]/oppgave/v1/Task/[id]

  • Se underside for FHIRPath Patch eksempler:

Meldingsbasert integrasjon (AMQP)

Vi vil også tillate PATCH ved hjelp av Meldingsformidling. Positiv APREC tilbake fra Helsenorge indikerer at PATCH-operasjonen var vellykket.

Hodemelding + vedlegg:

• Vedlegg av typeie Bundle

  • Bundle.type = “transaction”

  • Bundle.entry = FHIRPatch (samme som i REST-API)

  • Bundle.request

    • method = “PATCH”

    • url = “Task/[id] (samme id som i URL ved REST kall)

Eksempel på FHIRPath Patch via meldingsformidling (benytter kansellering av oppgave, dvs. oppdatere Task.status samt sette Task.statusReason):

Open

Undertrykke varsling av innbygger ved endring

Når oppgaver mottas vil alltid innbygger varsles. Dersom ikke noe angis vil innbygger også varsles når et eller flere elementer på oppgaven endres.

Det er (så langt) identifisert en UseCases der man ikke ønsker at innbygger skal varsles når et element endres. Dette er når en oppgave i sin helhet utføres i eksternt system, og dette systemet endrer oppgaves status på Helsenorge til “completed”. Det kan også være at aktøren i andre UseCases ikke ønsker varsling ved endring. For å gi avsender mulighet til å undertrykke varsling (ved endring) er det innført et nytt metadatafelt for dette formål som kan settes for FHIRPath patch ressursen (Parameters).