Innledning
Første versjon av skjemløsningen på Helsenorge ble laget som en pilot. Etterhvert som man høstet erfaring med denne, og stadig flere aktører tok den i bruk, ble løsningen redesignet. Grensesnittene i den gamle løsningen som avvikles nå er:
Sende en skjemaoppgave fra aktør til innbygger
Motta skjemasvar fra Helsenorge etter at skjema er fylt ut (enten uten at det er benyttet skjemaopphave eller som resultat av en skjemaoppgave)
(De opprinnelige grensesnittene mellom Helsenorge og ekstern skjemautfyller er allerede avviklet).
Endringens omfang
Opprinnelig kommunikasjonsprosess er splittet opp
Skjemaløsningen på Helsenorge er en generell tjeneste der innbygger kan fylle ut et skjema og utfylt skjema kan sendes til en eller flere mottagere. Opprinnelig ble prosessen alltid startet med at innbygger fikk en skjemaoppgave.
Ny mer generell implementasjon består av tre ulike prosesser som kan være uavhengige av hverandre:
Dialog Oppgaveforespørsel Oppgave API: Generell prosess der en ekstern aktør kan be om at innbygger utfører en bestemt oppgave. Dette kan være flere typer oppgave. Hva oppgaven innebærer styres av den ressurs oppgaven referer til. For «skjemaoppgaver» vil dette være referanse til et FHIR Questionnaire.
Dialog Skjemainnsending AMQP Skjemainnsending: En kommunikasjonsprosess der Helsenorge på vegne av innbygger sender et ferdig utfylt skjema til en (eller flere) mottagere. Utfylt skjema vil normalt være en FHIR QuestionnaireResponse.
(Dialog Skjemautfyller:) Denne er allerede tatt i bruk av alle ekstrene skjemautfyllere som er integrert med Helsenorge. Dette er en kommunikasjonsprosess der en ekstern skjemautfyller kan formidle en PDF-kopi av utfyltskjema tilbake til innbygger (Helsenorge).
Flere funksjoner tilbys både via API og Meldingsformidling
Oppgaveforespørsel tilbys både via API og Meldingsformidling
Enkelte elementer i en oppgave kan endres etter at den sendt til innbygger
(Dialog med ekstern skjemautfyller
Mellomlagring av delvis utfylt skjema tilbys kun gjennom API
Innsending av innbyggers PDF-kopi av utfylt skjema tilbys både via API og meldingsformidling)
Endring i innhold i melding / payload i API’er
Det undertsøttes ikke lenger FHIR STU3, kun FHIR STU 4 støttes.
Alle (hode)meldinger inneholder kun ett “Document”. Dette er en FHIR Bundle.
Ved Skjemainnsending fra Helsenorge til aktør, er PDF-versjonen av skjemasvaret nå en FHIR DocumentReference i FHIR Bundelen.
Ved meldingsbasert integrasjon benyttes ikke lenger “Dialog melding”.
Same Payload i API’ene som “Document” innhold i Hodemelding, dvs. en FHIR Bundle
Her finnes mer detaljert informasjon om endringene fra tidligere kommunikasjonsprosess: Endringer fra tidligere versjon av skjemaløsningen
Hva må Helseaktøren gjøre
Aktører som sender skjemaoppgaver til innbygger via Helsenorge
Ta i bruk den nye kommunikasjonsprosessen DIALOG_INNBYGGER_OPPGAVEFORESPØRSEL
alternativt benytte REST Oppgave API: Begge alternativer er dokumentert her: Oppgave API
Tilpasse seg ny innholdstandard (FHIR Task)
Dersom det ønskes meldingbasert innsending av oppgave: Sette opp støtte for denne kommunikasjonsprosessen i Adresseregisteret (for den/de HERID’er som skal sende inn oppgaven)
Dersom det alternativt ønskes benyttet API: Registrere API-klient og be om tilgang til API’et. Se her: 01 - System til System
Test i et eller flere av testsystemene.
Når test er gjennomført, produksjonsett.
Aktører som mottar skjemasvar fra Helsenorge
Tilpasse meldingsmottaket/systemet sitt til å motta ny meldingstype: DIALOG_INNBYGGER_SKJEMAINNSENDING. Denne er dokumentert her: AMQP Skjemainnsending
Tilpasse seg endret innholdstandard:
FHIR STU 4 (i dtedet for FHIR STU 3)
Kun en FHIR bundle som innhold. PDF er ikke et eget “document” i Hodemeldingen, men en FHIR DocumentReference inne i Bundelen
Sette opp støtte for denne kommunikasjonsprosessen i Adresseregisteret (for den/de HERID’er som skal motta skjemasvar)
Helsenorge vil automatisk sende den nye meldingstypen når skjemasvar skal formidles dersom det i AR er satt opp støtte for denne meldingstypen hos mottager.
Test i et eller flere av testsystemene.
Når test er gjennomført, produksjonsett.
Tidsaspekt
Tidligere kommuniaksjonsprosess ønskes i utganspunktet avviklet i løpet av 2024.