Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Sending av ferdig utfylt skjemasvar fra Helsenorge

KOMMER

Ekstern skjemautfyller mellomlagrer delvis utfylt skjema på Helsenorge

Payload

...

Innledning

  • Denne funksjonaliteten er kun tilgjengelig dersom innbyggers utfylling er resultat av en skjemaoppgave (dvs. FHIR Task).

  • Det understøttes to scenarier:

    1. Ekstern skjemautfyller kan selv “huske” kontekst dvs. ta vare på DocumentReference.Id mellom lagring og uthenting av mellomlagret dokument.

    2. Ekstern skjemautfyller har ikke kontekst informasjon, men må søke opp mellomlagret dokument basert på innbyggers fødselsnummer og kunnskap om skjemaoppgavens “identifier” (dvs. Task.Identifier).

Payload

  • 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

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]/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]/DocumentReference/fe0e4d02-0d0a-43be-8784-0ac336fefec3

Scenario b): Ekstern skjemautfyller har ikke kontekst, men må søke opp mellomlagret dokument

  • 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]

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

    • Eks: POST [base]/DocumentReference/_search?subject.identifier=urn:oid:2.16.578.1.12.4.1.4.1|01126222358&related.identifier=urn:ietf:rfc:3986|urn:uid:3a5ca27f-949a-429d-ae67-d19567bc37b8

      • Der: 01126222358 = Innbyggers fødselsnummer

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

Meldingsbasert integrasjon (AMQP)

...