Sende skjemaoppgave og motta skjemasvar

Sende 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 ( her finnes også fullstendige XML-eksempler)

  • Hvis ekstern aktør sender flere skjema definisjoner som har forskjellige språk/språkvarianter legges alle definisjonene inn i FHIR Bundle og en av disse er referert fra FHIR Task.

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):

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