Page Comparison

...

Gjennom bruk av FHIR-ressurser i skjemaløsningen har vi lagt til rette for at flere av grensesnittene som er beskrevet i den overordnede beskrivelse kan benytte forskjellig teknologi for integrasjon. For disse kan aktøren velge om man ønsker å benytte meldingsbasert integrasjon eller integrasjon via API’er. For noen av grensesnittene støttes kun en av integrasjonsmetodene. Dette vil framgå av beskrivelsen av hvert enkelt grensesnitt under.

En rekke av REST-grensesnittene (som alternativ til meldingsformidling) er under utvikling (våren 2021). Endelig release dato gis på forespørsel.

XML-eksempler på payload ved REST-kall og Meldingsinnhold ved meldingsbaert integrasjon finnes på denne siden: XML eksempler

...

• En skjemaoppgave er alltid representert ved en FHIR Task: Detaljert beskrivelse: FHIR Task - Oppgave

• I noen tilfeller kan en ekstern aktør ha behov for å sende med skjemadefinisjonen som skal benyttes. I slikt tilfelle skal det benyttes en FHIR Bundle med FHIR Task og Skjemadefinisjon.

REST API

Rest-API er under implementering, ta kontakt for release-dato.

Her kan aktør benytte to alternative aksjoner:

• Update (HTTP PUT): Denne benyttes dersom aktøren selv ønsker å bestemme ressursens ID. Denne må i så fall være en UUID. Kan PUT kan ikke benyttes for Bundle.

  • Eks: PUT [base]/Task/ee94ef9e-e2ca-48e6-953d-98fc1c5b2eed

• (HTTP POST): Her bestemmer Helsenorge ressursens ID. Se detaljer her.

  • Eks: POST [base]/Task

  • Eks: POST [base] (Skal benyttes Transaction for Bundle) - Bundle benyttes dersom man skal sende med selve skjemadefinisjonen som en del av oppgaven. Slik støtte for Bundle, vil implementeres noe etter støtte fro Task via Rest Api’et.

Meldingsbasert integrasjon (AMQP)

Innsending av skjemaoppgave som Hodemelding med FHIR Task eller FHIR Bundle er beskrevet i kapittel 3.26 Oppgaveforespørsel i Implementasjonsguiden

1.2 Sending av ferdig utfylt skjemasvar fra Helsenorge til aktør

Payload

• Helsenorge sender alltid mer enn en FHIR ressurs i et skjemasvar. Dette er alltid en FHIR Bundle. Det finnes to varianter (se Bruksscenarier):

  • Skjemasvar der Helsenorge sin skjemautfyller benyttes: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1008369665/Benyttede+FHIR+Ressurser#Standardisert-skjemarespons-FHIR-QuestionnaireResponse

  • Skjemasvar der det er benyttet proprietære skjemasvar (ekstern skjemautfyller): https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1008369665/Benyttede+FHIR+Ressurser#Propriet%C3%A6r-strukturert-skjemarespons-(kan-benyttes-ved-ekstern-utfyller)

    • Merk! Dette er et bruksscenarie som ikke er support enda (vår 2021), implementeres avhengig av behov.

...

• Ekstern skjemautfyller antas å ha proprietært format for delvis utfylt skjema. Dette lagres som en binær octetstreng på Helsenorge og representeres via FHIR ressursen: FHIR DocumentReference

REST API

Rest-API er under implementering, ta kontakt for release-dato.

Scenario a): Ekstern skjemautfyller “husker” mellomlagret dokument sin ressurs.id

...

• Ekstern skjemautfyller sender selv skjemasvar til aktør og sender kun lesbar kopi av svaret til innbygger på Helsenorge: FHIR DocumentReference med PDF Se her for detaljer

• Dersom Helsenorge skal formidle skjemasvar til aktør, sender ekstern skjemautfyller både skjemasvar i sitt eget (proprietære) format samt innbyggers lesbare kopi i en FHIR Bundle: Se her for detaljer

  • Merk! Dette er et bruksscenarie som ikke er support enda (vår 2021), implementeres avhengig av behov.

REST API

Rest-API er under implementering, ta kontakt for release-dato.

Her kan ekstern skjemautfyller benytte to alternative aksjoner HTTP verb for å lager PDF’en:

• Update (HTTP PUT): Denne benyttes dersom aktøren selv ønsker å bestemme ressursens ID. Denne må i så fall være en UUID. Se detaljer her.

  • Eks: PUT [base]/DocumentReference/1db43884-89f4-4e6a-a396-0cc49761ce9f (Hvis kun PDF)

• Create (HTTP POST): Her bestemmer Helsenorge ressursens ID. (Hvis kun PDF)

  • Eks: POST [base]/DocumentReference

Hvis Bundle (både proprietært skjemasvar og PDF i samme FHIR ressurs):

• Create (HTTP POST): Her bestemmer Helsenorge ressursens ID.

  • Eks: POST [base] - Det benyttes FHIR Bundle med “transaction”

...