Table of Contents |
---|
...
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/TaskIkke 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)
...