SKAL IKKE BENYTTES - AMQP Dialog Oppgave

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. Prosessene og meldingene som er beskrevet her er basert på første implementasjon av løsningen og er erstattet av mer generell løsning.

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 https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1510572033: 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 https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1510768659: En kommunikasjonsprosess der en ekstern skjemautfyller kan formidle et skjema som innbygger har fylt ut til Helsenorge for videre behandling. Videre behandling vil normalt være å lagre utfylt skjema for inbygger på Helseorge i en lesbar (PDF) versjon.

Prosessen Dialog Oppgave inneholder flere ulike funksjoner knyttet til skjemaoppgaver:

Med skjemaoppgave til utfylling kan helsepersonell sende et skjema til innbygger.
Med skjemaoppgave ferdigstilt kan en skjemautfyller sende et ferdig utfyllt skjema til innbygger på helsenorge.no.
Med skjemaoppgave til innsending kan helsenorge.no sende et ferdig utfylt skjema til en skjemamottaker. Dette kan være den som sendte skjema til innbygger eller en annen mottaker.

API-navn	DIALOG_INNBYGGER_OPPGAVE
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.1 Feb 1, 2018
Status	SKAL IKKE BENYTTES
API-dokumentasjon sist endret	Feb 11, 2021
Teknologi	AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Følgende prosesser skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Oppgave	Basisversjon for kommunikasjonsprosess	1.1

Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes for de ulike versjonene.

Versjon

Rolle

Funksjon

Meldingsinnhold

1.1

Innbygger

TilInnsending (A)

Applikasjonskvittering (A)

Dialogmelding 1.1

Helsepersonell

TilUtfylling (A)

Ferdigstill

Applikasjonskvittering (A)

Dialogmelding 1.1

Prosessen Dialog Oppgave inneholder flere ulike funksjoner knyttet til skjemaoppgaver. Sekvensdiagram for de ulike funksjonene er vist under.

Skjemaoppgave til utfylling:

Skjemaoppgave ferdigstilt:

Skjemaoppgave til innsending:

Forespørsel om skjemaoppgave til utfylling

Forespørsel om skjemaoppgave til utfylling fra helsepersonell til innbygger.

Tjeneste	Forespørsel om utfylling av skjemaoppgave til innbygger
Bruksområde	Brukes når en skjemautsender skal sende en skjemaoppgave til innbygger
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174397 Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_OPPGAVE" DN="Skjematjeneste for innbygger"/>` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Ja" V="J"/>`
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Lovlige kodeverdier som kan brukes i TypeForesp: SKOU – Skjemaoppgave til utfylling XML eksempel: `<Foresporsel> <TypeForesp V="SKOU" DN="Skjemaoppgave til utfylling" S="2.16.578.1.12.4.1.1. 7601"/> <EmneSporsmal>Beskrivende emne som leses av innbygger</Sporsmal> <Sporsmal>Beskrivende innhold/skjemainstruksjoner</Sporsmal> </Foresporsel>` RollerRelatertNotat Benyttes ikke for denne prosessen
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Ikke aktuelt å bruke for denne tjenesten.
Map	Obligatorisk, og benyttes i henhold til beskrivelse under Innholdsstandarder for (skjema)oppgave - Ikke-standardisert informasjonsobjekt «Map» lenger ned på denne siden. Obligatoriske elementer i Metadata-seksjonen: Deadline SchemaName Valgfrie elementer i Metadata-seksjonen: ResourceType Påkrevet når NHNs skjemakatalog benyttes Tag Påkrevet når NHN skjemakatalog benyttes ExternalId Påkrevet når integrasjonsparten benytter egen skjemakatalog/skjemautfyller ExternalUri Påkrevet når integrasjonsparten benytter egen skjemakatalog/skjemautfyller Utelates når E-helses skjemautfyller benyttes Reminder ValidTo SupportsRepresentation DescriptionAboutReceivers RenditionOfSchema Lovlige kodeverdier som kan benyttes i ResourceType: Questionnaire Lovlig format i Tag: {key}\|{value} Obligatoriske elementer i ContactInformation-seksjonen: Name PhoneNumber Organization Valgfrie elementer i ContactInformation-seksjonen: Role DescriptionAboutPointOfContact Recipients-seksjonen er valgfri XML-eksempel, se varianter under: XML-eksempel når E-helses skjemakatalog og skjemautfyller benyttes: XML-eksempel når integrasjonspart bruker egen skjemakatalog og skjemautfyller:
Skjemamodell	Valgfritt element, og benyttes i henhold til beskrivelse under Informasjonsmodeller for utveksling av skjemainnhold lenger ned på denne siden.
Skjemadata	Ikke aktuelt å benytte for denne tjenesten.
Bundle	Obligatorisk dersom meldingsutvekslingen inneholder minimum to FHIR-ressurser.
Resource references	Valgfrie elementer, kan benyttes dersom man ønsker å utveksle berikingsinnhold.
Self-contained resources	Ikke aktuelt å benytte for denne tjenesten.

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel om skjemaoppgave ferdigstilt

Resultat av utfylling av skjema fra helsepersonell til innbygger.

Tjeneste	Ferdig utfylt skjema til innbygger (kopi)
Bruksområde	Brukes fra skjemautfyller når innbygger ferdigstiller skjemaet
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Lovlige kodeverdier som kan brukes i TypeForesp: SKIF – Skjemainstans ferdigstilt XML-eksempel:
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som skal være med dersom det er tillatt for innbygger å motta kopi av utfylt skjema. Se for korrekt bruk.
Map	Obligatorisk element: ExternalId XML-eksempel:
Skjemamodell	Ikke aktuelt å benytte for denne tjenesten.
Skjemadata	Valgfri informasjon. Benyttes dersom skjemautsender og skjemautfyller støtter utveksling av skjemainnhold. Benyttes i henhold til informasjonsmodeller for utveksling av skjemainnhold under Ytterligere informasjon på denne siden.
Bundle	Ikke aktuelt å benytte for denne tjenesten.
Resource references	Ikke aktuelt å benytte for denne tjenesten.
Self-contained resources	Ikke aktuelt å benytte for denne tjenesten.

Skjemaoppgave til innsending

Innsending av skjemaoppgave fra innbygger.

Tjeneste	Forespørsel om utfylling av skjemaoppgave til innsending
Bruksområde	Brukes av Helsenorge.no når ferdigstilte skjema som ble mottatt av SKIF skal sendes til kopimottakere av skjema.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Lovlige kodeverdier som kan brukes i TypeForesp: SKOI – Skjemaoppgave til innsending XML-eksempel:
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som skal være med dersom helsenorge mottok binært vedlegg fra skjemautfyller.
Map	Obligatorisk Obligatoriske elementer: ExternalId XML-eksempel:
Skjemamodell	Ikke aktuelt å benytte for denne tjenesten.
Skjemadata	Valgfri informasjon. Benyttes dersom støtter utveksling av skjemainnhold. Benyttes i henhold til informasjonsmodeller for utveksling av skjemainnhold under Ytterligere informasjon på denne siden.
Bundle	Ikke aktuelt å benytte for denne tjenesten.
Resource references	Ikke aktuelt å benytte for denne tjenesten.
Self-contained resources	Ikke aktuelt å benytte for denne tjenesten.

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her:

Ytterligere informasjon

Eksempelmeldinger

Innholdsstandarder for (skjema)oppgave

Informasjonsmodeller for utveksling av skjemainnhold

Denne seksjonen beskriver ulike informasjonsstandarder og -modeller som brukes for å utveksle skjemainnhold.