Page Comparison

...

• 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. (Ikke implementert i REST API enda).

REST API

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

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

  • Eks: POST [base]/Task (Støtte for å levere skjemaoppgave som Task med POST tilgjengeliggjøres i Produksjon i R 21.7, dvs. 22. juni 2021).oppgave/v1/Task

  • Ikke implementert enda: Eks: POST [base]/oppgave/v1 (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 etter støtte fro Task via Rest Api’et.

...

• 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

• Lagre skjemainstans : Update (HTTP PUT): Det forutsettes at ekstern utfyller selv bestemme ressursens ID. Denne må være en UUID. Se detaljer her.

  • Eks: PUT [base]/skjema/v1/DocumentReference/fe0e4d02-0d0a-43be-8784-0ac336fefec3

• Hente skjemainstans: Read (HTTP GET): Lagret skjemainstans hentes direkte basert på ressurs ID. Se detaljer her.

  • Eks: GET [base]/skjema/v1/DocumentReference/fe0e4d02-0d0a-43be-8784-0ac336fefec3

...

• Lagre skjemainstans: Create (HTTP POST): Her bestemmer Helsenorge ressursens ID. Det forventes ikke at ekstern skjemautfyller “husker” returnert ressurs.id. Se detaljer her.

  • Eks: POST [base]/skjema/v1/DocumentReference

• Hente lagret dokument: Search (HTTP POST): Her skal det benyttes innbyggers fødselsnummer og skjemaoppgavens Identifier” slik disse er angitt i DocumentReference.

  • Eks: POST [base]/skjema/v1/DocumentReference/_search?

    • Body: Content-Type: application/x-www-form-urlencoded + subject.identifier=urn:oid:2.16.578.1.12.4.1.4.1|01126222358&related.identifier=urn:ietf:rfc:3986|urn:uuid:3a5ca27f-949a-429d-ae67-d19567bc37b8

      • Der: 01126222358 = Innbyggers fødselsnummer (det er valgt POST og parametere i body fordi innbyggers fødselsnummer aldri skal være i URL’er)

      • Der: 3a5ca27f-949a-429d-ae67-d19567bc37b8 = er Task.Identifier slik denne er knyttet opp i DocumentReference som et relatert dokument. Se her for detaljer.

...

• 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 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]/skjema/v1/DocumentReference/1db43884-89f4-4e6a-a396-0cc49761ce9f (Hvis kun PDF)

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

  • Eks: POST [base]/skjema/v1/DocumentReference

Meldingsbasert integrasjon (AMQP)

...