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:
Ekstern skjemautfyller kan selv “huske” kontekst dvs. ta vare på DocumentReference.Id mellom lagring og uthenting av mellomlagret dokument.
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ødselsnummerDer:
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)
...