Sende inn skjemaoppgave og motta skjemasvar
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. Aktøren velger 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.
Detaljert teknisk dokumentasjon finnes på denne siden (med undersider): Teknisk detalj dokumentasjon - skjemaløsning
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: Benyttede FHIR Ressurser i Skjemaløsningen | Innsending av Oppgave til Innbygger (Helsenorge) der skjemadefinisjonen er med
API
Her benyttes Oppgave API (som understøtter både Meldingsbasert- og REST integrasjon): Oppgave API
Sending av ferdig utfylt skjemasvar fra Helsenorge til aktør
Dette grensesnittet er så langt kun relevant dersom Helsenorge sin egen skjemautfyller benyttes. Hvis annen skjemautfyller benyttes, må svaret distribueres direkte fra ekstern skjemautfyller til Helseforetaket.
Payload
Helsenorge sender alltid mer enn en FHIR ressurs i et skjemasvar. Dette benyttes derfor alltid en FHIR Bundle. Det finnes to varianter, der kun det første så langt er implementert (se Bruksscenarier):
Skjemasvar der Helsenorge sin skjemautfyller benyttes: Benyttede FHIR Ressurser i Skjemaløsningen | Standardisert skjemarespons FHIR QuestionnaireResponse
MERK! Ikke implementert enda: Skjemasvar der det er benyttet proprietære skjemasvar (ekstern skjemautfyller): Benyttede FHIR Ressurser i Skjemaløsningen | Proprietær strukturert skjemarespons (kan benyttes ved ekstern utfyller)
Dette er et bruksscenarie som ikke er support for enda (høst 2024), implementeres avhengig av behov fra sektoren.
REST API
Foreløpig støtter Helsenorge ikke å “poste” skjemasvar til en FHIR-server hos mottager. Kun meldingsbasert integrasjon støttes for formidling av skjemasvar.
Meldingsbasert integrasjon (AMQP)
Innsending av skjemasvar som Hodemelding med FHIR Bundle er beskrevet her: AMQP Skjemainnsending