Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 28 Next »

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.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: Oppdatering av attributter på Task (FhirPatch) )

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

    • 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

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):

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>

  • No labels