Generelt om de tekniske grensesnittene
Forretningsinnhold
Alt forretningsinnhold i grensesnittene i HN-skjemaløsning er representert ved FHIR ressurser
Nåværende versjoner av grensesnittene støtter kun FHIR R4
Følgende FHIR ressurser benyttes:
Questionnaire: Skjema definisjon. Denne har noen extensions for utvidet funksjonalitet i HN-skjemautfyller.
QuestionnaireResponse: Skjema svar (i strukturert format).
Task: (Skjema)oppgave – benytte også for andre oppgavetyper
DocumentReference:
PDF-versjon av skjemasvar
Skjemasvar i proprietære formater.
Bundle: Benyttes der mer enn en av ressursene over finnes i samme paylolad
Task + Questionnaire: Dersom ekstern aktør sender skjemadefinisjon sammen med Oppgave
QuestionnaireResponse + Questionnaire + DocumentReference(PDF): Skjemasvar fra Helsenorge til aktør
(Detaljer finnes her: Benyttede FHIR Ressurser i Skjemaløsningen )
Tekniske grensesnitt
Vi støtter to tekniske integrasjonsmetoder for innsending- og endring av skjemaoppgave fra Aktør:
AMQP og KITH-hodemelding som transportmekanisme (hodemeldingen har kun ett «Document» som er FHIR ressursen)
HTTP REST-kall
For levering av skjemasvar fra Helsenorge til Aktør, støttes pr. nå kun AMQP
Integrasjon med ekstern skjemautfyller:
Mellomlagring av kladd på Helsenorge og etterfølgende uthenting av kladd: Kun REST
Denne funksjonaliteten skal kun benyttes i samråd med Helsenorge i tilfeller der mellomlagring er hensiktsmessig
Levering av innbyggers kopi (PDF) av skjemasvar til HN: Både AMQP og REST
Det er alltid samme payload i AMQP-meldingen («Document» i Hodemeldingen) som body i REST-kall.
Positiv respons:
AMQP: Positiv APPREC
REST: HTTP 200 eller 201
Negativ respons:
AMQP: Negativ APPREC med detaljert feilinformasjon (samme feilinformasjon som returneres ved REST)
REST: HTTP feilkode, med detaljert feilinformasjon (Lenke til feilkoder)
Oppsummering
Funksjon | Retning | AMQP-meldingstype | REST-operasjon | Payload |
---|---|---|---|---|
Sende inn skjemaoppgave | Fra aktør til Helsenorge | DIALOG_INNBYGGER_OPPGAVEFORESPØRSEL | POST | FHIR: Task eller Bundle |
Endre allerede innsendt oppgave | Fra aktør til Helsenorge | DIALOG_INNBYGGER_OPPGAVEFORESPØRSEL | PATCH | FHIRPath Patch |
Motta skjemasvar | Fra Helsenorge til aktør | DIALOG_INNBYGGER_SKJEMAINNSENDING | Ikke støttet | FHIR; Bundle |
Grensesnitt dersom ekstern skjemautfyller benyttes (dvs. annen skjemautfyller enn den som er integrert i Helsenorge) | ||||
Ekstern skjemautfyller: Lever innbyggers kopi av skjemasvar | Fra ekstern skjemautfyller til Helsenorge | DIALOG_INNBYGGER_SKJEMAUTFYLLER | POST | FHIR: DocumentReference |
Ekstern skjemautfyller: Lagre kladd på HN | Fra ekstern skjemautfyller til Helsenorge | Ikke støttet via AMQP | POST | FHIR: DocumentReference |
Ekstern skjemautfyller: Hente kladd på HN (for videre utfylling) | Fra ekstern skjemautfyller til Helsenorge | Ikke støttet via AMQP | POST _search | Retur fra Helsenorge: FHIR: DocumentReference |