Innledning
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.
Innsending av skjemaoppgave
Payload
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. Se detaljert spesifikasjon av Bundle
REST API
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. Se detaljer her.
Eks:
PUT [base]/Task/ee94ef9e-e2ca-48e6-953d-98fc1c5b2eed
Eks:
PUT [base]/Bundle/79e159f5-dfbe-415d-922e-48477f336a43
Create (HTTP POST): Her bestemmer Helsenorge ressursens ID. Se detaljer her.
Eks:
POST [base]
Meldingsbasert integrasjon (AMQP)
Innsending av Hodemelding med FHIR Task er FHIR Bundle er beskrevet i kapittel 3.26 Oppgaveforespørsel i Implementasjonsguiden
Sending av ferdig utfylt skjemasvar fra Helsenorge
KOMMER
Ekstern skjemautfyller mellomlagrer delvis utfylt skjema på Helsenorge
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
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
Meldingsbasert integrasjon (AMQP)
Denne funksjonen tilbys ikke med meldingsformidling.