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
Payload
Alle oppgaver er representert ved en FHIR Task: Detaljert beskrivelse: FHIR Task - Oppgave
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.period
Eventuelt også extension: Task.restriction.
http://helsenorge.no/fhir/StructureDefinition/hn-task-deadline
MERK: Dersom “deadline” extension benyttes, må denne alltid settes, selv om den ikke er endret, dersom man endrer verdier i Task.period via Patch.
Beskrivelsen kan endres (Task.description)
Ved oppdatering av et eller flere av disse benyttes: http://hl7.org/fhir/fhirpatch.html (Se underside for detaljer: Oppdatering av attributter på Task (FhirPatch) )
REST API
Det benyttes sikkerhetsmodell system-til-system: 01 - System til System
(HTTP POST): https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1254654012/FHIR+-+REST+Operasjoner#Patch---HTTP-PATCH
Eks Task:
PATCH [base]
/oppgave/v1/Task/[id]Se underside for FHIRPath Patch eksempler: Oppdatering av attributter på Task (FhirPatch)
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 type: http://hl7.org/fhir/bundle.html
Bundle.type = “transaction”
Bundle.entry = http://hl7.org/fhir/fhirpatch.html (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):
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).
<?xml version="1.0" encoding="UTF-8"?> <Parameters xmlns="http://hl7.org/fhir"> <meta> <tag> <system value="http://helsenorge.no/fhir/varsling"/> <code value="1"/> <display value="Innbygger skal ikke varsles."/> </tag> </meta> <!-- FHIRPath PATCH --> <parameter> ................. </parameter> </Parameters>