Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Skjemabyggeren er et nettbasert verktøy skrevet i React for å generere skjemadefinisjoner. Applikasjonen har ingen avhengigheter til backend-systemer eller APIer og bruker lokal fillagring på brukers maskin.

Skjemadefinisjoner kan lastes inn ved at bruker trykker "Last opp skjema" og deretter velger en fil fra "Åpne fil"-dialogboksen som åpnes. På samme måte når bruker trykker "Lagre" så lastes ned lagres en lokal fil av med Questionnaire-en i json-format.

...

  • "Bruker" representerer brukeren av Skjemabyggeren.

  • "Last opp spørreskjema" er et bruksmønster der brukeren kan laste opp et eksisterende spørreskjema fra en fil.

  • "Start nytt spørreskjema" er et bruksmønster der brukeren kan begynne å lage et nytt spørreskjema fra bunnen av.

  • "Fortsett spørreskjema" er et bruksmønster der brukeren kan fortsette arbeidet på spørreskjemaet fra forrige nettleser sesjonnettlesersesjon.

  • "Utvikle spørreskjema" er et bruksmønster der brukeren kan legge til, redigere eller slette spørsmål og konfigurere ulike egenskaper for spørreskjemaet, som spørsmålstype, alternativer, poengsetting/skåring osv.

  • "Last ned spørreskjema" er et bruksmønster der brukeren kan eksportere det ferdige spørreskjemaet som en JSON-fil. JSON-filen inneholder strukturen og detaljene i spørreskjemaet, og kan enkelt deles og lagres.

...

Skjemadetaljer

Navn

Beskrivelse

Extension 

Extension Uri

Id

Unik ID som benyttes for alle versjoner. Kan settes manuelt, eller via guid som default

Nei

Language

Angivelse av språk. Angis i hht. BCP-47 (http://tools.ietf.org/html/bcp47 )

Hovedspråket er Norsk Bokmål.

Bruker kan endre språk på skjemaet og skjemautfyllerens komponenter og tekster.  Skjemautfyller er på følgende språk: Norsk Bokmål, Norsk Nynorsk, Engelsk og Nordsamisk. Språk på følgende format: nb-NO.

Språk legges til og oversettes i egen seksjon - se senere. 

Nei

Version

Funksjonell versjon i skjemadefinisjonen

Nei

Name

Teknisk navn er bakerste siste ledd i URL til skjema. Samme tekniske navn benyttes kun på samme skjema med ulikt språkAlle språkversjoner av et skjema har samme, unike “Teknisk navn”

Nei

Title

Tittel - Overskrift, vises som H1 i skjemaet

Nei

Status

Status. Er påkrevet. draft | active | retired | unknown

Nei

Date

Funksjonell dato. Dato for siste endring av spørreskjemaet.

Nei

Publisher

Tekstlig representasjon av organisatorisk eier

Nei

Description

Beskrivelse av innholdet i spørreskjemaet. Dette vises ikke i utfylleren, men vil være relevant for aktører som skal velge et passende skjema som skal benyttes. Kan benyttes f.eks. i verktøykatalogen

Nei

Purpose

Beskriver hvorfor skjemaet er laget, og hvorfor design og funksjonalitet er om det er. Kan referere til bakgrunnsmateriale og forskning, for eksempel "instrumenter" relatert til skjemaet.

Nei

Contact

Kontaktinformasjon til organisatorisk eier av skjema.

Nei

Copyright

Restriksjoner på bruk, betaling osv.

Nei

security

Benyttes til kategorisering av skjema, samt til tilgangsstyring med tanke på ut fra samtykkenivå: 

  • Registerinnsyn (Basis) 

  • Journalinnsyn (Basis +) 

  • Helsetjeneste (Full) Helsetjeneste, Forvaltning, Sekundærbruk. 

Man kan snart, på Helsenorge reservere seg fra å motta skjema til sekundærbruk. 

  1. Helseregister    

Brukes for informasjon og tjenester knyttet til innbyggers innsyn og rettigheter i ulike registre, for eksempel besvare innsynsforespørsler

2. Pasientjournal    

Brukes for informasjon og tjenester knyttet til innbyggers personvernrettigheter i pasientjournal, for eksempel besvare innsynsforespørsler

3. Helsehjelp    

Brukes for informasjon og tjenester knyttet til innbyggers direkte behandling, helsehjelp og forebygging og hvordan videre behandlingsløp, oppfølging og informasjon skal håndteres, for eksempel sende oppgaver, timeavtaler eller annet til innbygger ifm. pasientforløp

4. Forvaltning    

Brukes for informasjon og tjenester knyttet til helseforvaltning og helseøkonomiforvaltning, for eksempel sende ut vedtak

5. Sekundærbruk

Brukes for informasjon og tjenester knyttet til forskning, helseundersøkelser og annen sekundærbruk, for eksempel invitere til deltakelse og sende ut informasjon fra forskningsprosjekter og helseundersøkelser

"security": [ { "code": "3", "display": "Helsehjelp", "system": "urn:oid:2.16.578.1.12.4.1.1.7618" } ]

Nei

Skrivetilgang som hjelde rpå gjelder på Helsenorge

  • Standardinnstilling for skrivetilgang:

    • Innbygger selv

    • Foreldre på vegne av barn under 12 år

    • Foreldre på vegne av barn 12-16 år

    • Representant med tildelt fullmakt

    • Representant med ordinær fullmakt

  • Avvik fra dette kan settes ved å velge en eller flere, i tillegg til innbygger selv som alltid er satt på: 

    • Kun innbygger selv (alltid på i gui)

    • Foreldre på vegne av barn under 12 år

    • Foreldre på vegne av barn 12-16 år

    • Representant med ordinær fullmakt

    • Representant med tildelt fullmakt

    • Innbyggere på adressesperre kode 7 (Kommer senere)med adressesperre

Nei

Skjemainnstillinger

Endpoint

Mottaker. Kun til bruk der skjemaet skal sendes til predefinerte mottakere. (Format: Endpoint/32)

Det kan også angis mottakere i selve skjemadefinisjonen i et eget skjemaelement, slik at dette feltet ikke er obligatorisk.

Ja

http://ehelse.no/fhir/StructureDefinition/sdf-endpoint

AuthenticationRequirement

Om den som skal fylle ut skjemaet må logge seg inn eller ei.

Ja

http://ehelse.no/fhir/StructureDefinition/sdf-authenticationrequirement

presentationbuttons

Vising av knapperad

  • static

  • none

Ja

http://helsenorge.no/fhir/StructureDefinition/sdf-presentationbuttons

GenererPDF

Om det skal genereres PDF eller ei. 

Ja

http://ehelse.no/fhir/StructureDefinition/sdf-generatepdf

Skjule tekster i PDF

En kan skjule hjelpetekster, instruksjoner og sidebartekster i PDF, for bedre lesbarhet. 

"system":"http://helsenorge.no/fhir/CodeSystem/AttachmentRenderOptions"

"code": "hide-help", "display": "Hide help texts" 

"hide-sublabel", "display": "Hide sublabel texts"

"code": "hide-sidebar", "display": "Hide sidebar texts"

Ja

http://helsenorge.no/fhir/StructureDefintion/sdf-itemControl-visibility

binary

Angir hvilken documentReference som benyttes. Altså relasjonen mellom questionnaire og documentReference

Document reference og binary må lastes opp i skjemakatalogen for å kunne benyttes på helsenorge.

Format: "Binary/1234"

Ja

http://helsenorge.no/fhir/StructureDefinition/sdf-questionnaire-print-version

navigator

Angir om navigator skal være på eller av "navigator" skrur den på

Ja

http://helsenorge.no/fhir/StructureDefinition/sdf-questionnaire-navgiator-state

saveCapabilities

Lagringsattributter er definert globalt på skjemadefinisjonen.

Det er følgende alternativer i dag:

  • 3 Ingen lagring

  • 2 Kun lagring 

  • 1 Lagring og mellomlagring.  

Hvilke knapper som vises, styres som i dag: 

  1. Send inn (Om det er endepunkt. Også ved videresending med endepunkt)

  2. Fullfør (Ikke endepunkt, ikke videresending)

  3. Gå videre (Ikke endepunkt, kun videresending)

  4. Mellomlagre (Styres av saveCapabilities Er på i 1 og 2)

Ja

http://helsenorge.no/fhir/StructureDefinition/sdf-save-capabilities

useContext

Kun for bruk av NHN

Nei

"system": "http://helsenorge.no/fhir/CodeSystem/workflow", "code": "request", "display": "Henvendelse"

Sidebar - hjelpeskuffen på Helsenorge

SOTHeaders

Standardtekst fra Helsenorge.

Samarbeidspartner supplerer med egen tekst. Se retningslinjer for dette.  

"system": "http://hl7.org/fhir/ValueSet/questionnaire-item-control", "code": "sidebar"

{ "system": "http://ehelse.no/fhir/ValueSet/SOTHeaders", "code": "SOT-1", "display": "SOT-1" }

Ja

http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl

SOTHeaders

Standardtekst fra Helsenorge.

Samarbeidspartner supplerer med egen tekst. Se retningslinjer for dette. 

"system": "http://hl7.org/fhir/ValueSet/questionnaire-item-control", "code": "sidebar"

{ "system": "http://ehelse.no/fhir/ValueSet/SOTHeaders", "code": "SOT-2", "display": "SOT-2" }

Ja

http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl

SOTHeaders

Samarbeidspartner supplerer med egen tekst. Se retningslinjer for dette. 

"system": "http://hl7.org/fhir/ValueSet/questionnaire-item-control", "code": "sidebar"

{ "system": "http://ehelse.no/fhir/ValueSet/SOTHeaders", "code": "SOT-3", "display": "SOT-3" } ],

Ja

http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl

Språk

language

For hvert språk som etableres, genereres det en questionnaire pr språk med en unik id, men med samme tekniske navn. Det muliggjør språkvalg når man henter opp skjema via teknisk navn. I situasjoner der en skal lenke direkte til skjema, uten språkvalg, kan en benytte unik id.

"language": "nb-NO"

"language": "nn-NO"

Man kan i verktøyet oversette tekster til de ulike språkene. 

Nei

...

Spørsmålstyper og komponenter

...

Felt i Skjemabygger

...

Seksjon

...

Spørsmålstype

...

Brukergrensesnittkontroll

...

Notat

Alle datatyper som defineres må følge FHIR-standarden. https://www.hl7.org/fhir/R4/datatypes-definitions.html

Felt i Skjemabygger

Seksjon

Spørsmålstype

Brukergrensesnittkontroll

Notat

display

Forklarende tekst

Forklarende tekst ment til å veilede brukeren

group

Seksjon/gruppe

Seksjon som må ha minimum ett spørsmålselement, den øverste gruppen starter på h2 deretter benyttes en mindre font nedover

ItemControl på grupper. http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl

  • summary-container: De gruppene som er merket med "summary-container" får en ekstra merking i PDF rendring

  • summary: Legger kodede groups først i PDF, Datatype: group

  • grid: En gruppeseksjon merket med itemControl = 'grid' indikerer at underordnede elementer av typen = 'group' i rutenett-delen er rader, og spørsmål under radgruppene er organisert som kolonner i rutenettet.

  • gtable: Tabell med visning av repeterende grupper

  • table: Tabell med svaralternativer som kolonner, med underliggende items i siste kollonne

  • table-hn1: Tabell med spørsmål og svar i to kolonner

  • table-hn2: Tabell med egendefinerte kolonner og overskrifter

question

boolean

Sjekkbox

decimal

Numerisk kontroll

Man aktiverer desimaltall under "Validering" på elementet.

Desimaldelen er synlig, men det er kun heltallsdelen som påvirkes av opp-/nedknappene. Desimaldelen må manuelt endres. 

integer

Numerisk kontroll

Samme som desimal, men uten desimaldelen.

date og dateTime

Datokontroll

Man kan velge mellom ulike datoformat

time

Tidskontroll

Kun tidsdelen vises

string

Tekstboks

Inntastingsfelt som kun vises på en linje

text

Større tekstboks, type TextArea

Inntastingsfelt som kan vises over X antall linjer. 

Itemcontrol på text  http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl

  • help: viser et spørsmålstegn og når man trykker på den vises hjelpeteksten Datatype: text

  • help-link: viser et spørsmålstegn og når man trykker på den vises hjelpeteksten som hentes fra en ekstern kilde Datatype: text

  • inline: Teksten vises som en ekspanderende seksjon Datatype: text

  • highlight: Gir et uthevet tekstfelt. Benyttes først i skjema som første item. Datatype: text

  • sidebar: Gir tekst i hjelpeskuffen. Må kombineres med en code som plasserer teksten rett sted.  Datatype: text. Se egen seksjon for dette over “Sidebar - hjelpeskuffen på Helsenorge”

choice

Radio-buttons/Sjekkbokser/nedtrekksliste

Dersom det er flere enn 6 mulige valg vises en nedtrekksliste, ved 6 valg eller færre vises radio-buttons.

Det er også mulig å overstyre standardinnstillingene for hvilken kontroll som velges ved å benytte utvidelsen itemControl.

Alternativer har to varianter "option" og "options"

ItemControl på alternativer http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl

Enkeltvalg-/flervalgspørsmål (choice): designer av skjema kan velge mellom:

  • drop-down

  • check-box

  • radio-button

choice - option

Dersom man ikke skal gjenbruke et kodeverk kan man håndkode valgene ved å bruke dette attributtet.

NB: Denne benyttes der det er mulig å adressere et skjema til en ekstern mottaker.
NB2: Denne benyttes også ved skåring, viser til annen seksjon (senere)

choice - options

En referanse til et kodeverk for enkeltvalg- og flervalgspørsmål.

Disse kodeverkene kan gjenbrukes og defineres under menyvalget "Valg"

open-choice

Radio-buttons/Sjekkbokser/nedtrekksliste

Som over, i tillegg er det et fritekstfelt dersom man velger "Annet"

attachment

Opplastingskomponent

Kontroll for å laste opp vedlegg i JPG,PDF og PNG format.

quantity

Numerisk kontroll med visning av måleenhet

Samme som desimal- og heltall, i tillegg til tekstlig visning av måleenhet bak kontrollen

Man kan angi enheter i brukergrensesnittet, eller velge en predefinert. kan angi enheter i brukergrensesnittet, eller velge en predefinert.  Egendefinerte enheter må følge FHIR-standarden: https://www.hl7.org/fhir/R4/datatypes-definitions.html#Quantity

Enheter hentes fra følgende kodeverk:   http://unitsofmeasure.org

choice

Mottakerliste

Kontroll i verktøyet som gjør arbeidet med å oppgi endepunkter/mottakere lettere, der sluttbruker skal velge mottaker selv.

Man oppgir visningsnavn og endepunkt (HerID) på dette formatet "Endpoint/23" 

choice

Mottakerkomponent

Komponent som gjør arbeidet med å oppgi endepunkter/mottakere lettere, der sluttbruker skal velge mottaker selv. Vedlikehold gjøres enkelt på HelsenorgeAdmin, og justeringer på tekster og mottakere kan gjøres uten å oppdatere skjemaet.  

...

Navn

Beskrivelse

Uttrykk

KMI

Beregning der en henter Quantity-data fra to felt Høyde og Vekt.

QuestionnaireResponse.descendants().where(linkId='Vekt').answer.value.value / ((QuestionnaireResponse.descendants().where(linkId='Hoyde').answer.value.value/10000) * QuestionnaireResponse.descendants().where(linkId='Hoyde').answer.value.value)

Legg merke til at value.value benyttes ved kvantiteter, men ved tallverdier for øvrig benyttes kun value i utrykkene.

Egendefinerte enheter må følge FHIR-standarden: https://www.hl7.org/fhir/R4/datatypes-definitions.html#Quantity

QuestionnaireResponse.descendants().where(linkId='Livvidde').answer.value.value / QuestionnaireResponse.descendants().where(linkId='Hoftevidde').answer.value.value)

Legg merke til at value.value benyttes ved kvantiteter, men ved tallverdier for øvrig benyttes kun value i utrykkene.

Egendefinerte enheter må følge FHIR-standarden: https://www.hl7.org/fhir/R4/datatypes-definitions.html#Quantity