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.

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. 

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.  

type

Spørsmålstyper og komponenter. 

Nei

required

Angir om det er påkrevet å besvare spørsmålet. I utgangspunktet skal man kun stille spørsmål man trenger å få svar på (GDPR), derved markeres ikke obligatoriske spørsmål spesielt. Ikke obligatoriske spørsmål markeres i Helsenorges utfyller med (valgfritt).

Nei

text

Spørsmålstekst. Denne kan være ren tekst, eller overstyres av markdown.

Nei

markdown

Angivelse av seksjon-/spørsmålsteksten i markdown-format. Benyttes for visningsseksjoner og som forklarende tekst på spørsmålstekster, eller instrukser

Ja

http://hl7.org/fhir/StructureDefinition/rendering-markdown

Instruks

Gir en forklarende tekst under spørsmålsteksten

Ja

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

Validering

Tekstvalidering:

I denne seksjonen kan man legge inn regulære uttrykk, sette minimum og maksimum antall tegn i tekstfeltet. 

Ja

http://hl7.org/fhir/StructureDefinition/minLength

http://hl7.org/fhir/StructureDefinition/regex

Validering

Tall, Antall med enhet

I denne seksjonen kan man legge inn om tallfeltet skal ha desimaler, sette minimum og maksimum verdi. 

Ja

http://hl7.org/fhir/StructureDefinition/maxDecimalPlaces

http://hl7.org/fhir/StructureDefinition/minValue

http://hl7.org/fhir/StructureDefinition/maxValue

Validering

Dato

I denne seksjonen kan man sette minimum og maksimum datoer. 

Man kan legge inn: 

• En fast dato

• Dagens dato

• Dagens dato + antall dager, uker, mnd, år

• Dagens dato - antall dager, uker mnd, år

Ja

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

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

maxSize

Vedlegg

Maksimal størrelse på filvedlegg. Normalt skal ikke større filer sendes, men deles. 

Ja

http://hl7.org/fhir/StructureDefinition/maxSize

validationText

Forklarende valideringstekst som overstyrer standard valideringstekst. 

Se lenger ned for detaljer om valideringsregler.

Det er noen generelle valideringstekster som kommer fra skjemautfylleren. Brukes ikke Helsenorges skjemautfyller, må annen utfyller ha egne tekster, eller benytte skjemadefinisjonens validationText.

Skjemautfyllerens tekster ved obligatorisk felt: 

Tekstfelt: Fyll ut feltet

Dato: Velg dato, eller skriv dato på denne måten: dd.mm.åååå.

Dato og tid: Velg dato og tid, eller skriv dato og tid på denne måten: dd.mm.åååå og tt:mm.

Tid: Velg tid, eller skriv tid på denne måten: tt:mm.

Desimaltall: Fyll ut feltet med et desimaltall.

Heltall: Fyll ut feltet med et heltall.

Kvantitet: Fyll ut feltet med xxx.

Enkeltvalg: Velg ett av alternativene.

Flervalg: Velg ett eller flere av alternativene.

Ja

http://ehelse.no/fhir/StructureDefinition/validationtext

EnableWhen

Sporvalg - Funksjon for å åpne/lukke items eller grupper.

Har følgende operatorer:  exists | = | != | > | < | >= | <=

I tillegg et attributt som indikerer om et eller alle kriteriene skal tilfredsstilles:

"enableBehavior" All, Any

Følgende datatyper støttes: 

• boolean    

• decimal    

• integer    

• date    

• dateTime    

• time    

• string    

• Coding    

• Quantity    

• reference    

Ja

http://hl7.org/fhir/valueset-questionnaire-enable-operator.html

https://www.hl7.org/fhir/valueset-questionnaire-enable-behavior.html

code

Merking av elementer med koder

Elementer kan merkes med null eller flere koder, Dette kan være kliniske koder som ICNP, ICD, LIONC eller SNOMED CT, eller for eksempel koder for korresponderende elementer i arketyper. 

Klassisk eksempel er der man bruker en kodeverdi for å angi systolisk/diastolisk blodtrykk, kroppstemperatur, osv. Eksempel på kodeverk er SNOMED CT, ICD-10, LOINC, osv.

Code er også benyttet teknisk for mapping av data, samt for å muliggjøre funksjonalitet i løsninger som benytter skjemadefinisjonen.  Bruk av kodeverk er svært nyttig der man integrerer flere systemer.

nei

Avanserte innstillinger

readOnly

Skrivebeskyttet felt

Nei

linkId

Unik identifikator for spørsmålet. Det genereres en guid, som kan overstyres med egen navngivning. Pass på at denne må være unik i skjemaet om man oppgir det selv. 

Nei

Funksjon for å hente data fra et likt definert datafelt, med samme regler over i strukturen. Benytter FHIR-path for å kopiere data.

http://hl7.org/fhir/ValueSet/questionnaire-item-control

http://hl7.org/fhir/StructureDefinition/cqf-expression

sdf-calculatedExpression

Felt for å benytte FHIR-path for gjøre kalkulasjoner. Elementen må være av datatypen quantity: 

{ "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-unit", "valueCoding": { "code": "Score", "display": "Sum", "system": "http://ehelse.no/Score" } }, 

Feltene det skal kalkuleres med, må også være av datatypen quantity, men kan ha ulike typer feks kg, men trenger ikke kodes ytterligere. 

Eksempel FHIR path: 

QuestionnaireResponse.descendants().where(linkId='Value1').answer.value.value + QuestionnaireResponse.descendants().where(linkId='Value2').answer.value.value)

Ja

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

fhirpath andre ressurser

Det er tre personrelaterte ressurser på Helsenorge man kan hente informasjon fra, og hente data fra inn i skjema. Dette er innbygger selv, den som presenterer innbygger og fastlegen til innbygger.

Informasjonen hentes via fhir-pathr uttrykk, og elles inn i skjema. 

Disse feltene skal i utgangspunktet være read-only og skal ikke endres i denne konteksten, fordi dataene stammer fra andre kilder.  

I verktøyet er det ulike valg for disse pre-definerte spørringene. 

Eksempel:

Patient.identifier.where(use = 'official' and (system = 'urn:oid:2.16.578.1.12.4.1.4.1' or system = 'urn:oid:2.16.578.1.12.4.1.4.2')).value

Ja

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

entryFormat

Skyggetekst for forventet input. I nedtrekkslister kan man angi en forklarende tekst som "velg her"

Ja

http://hl7.org/fhir/StructureDefinition/entryFormat

initial

Pre-utfylt verdi. 

Nei

hyperlink-target

Normalt skal alle lenker åpnes i ny arkfane. I situasjoner der man fra en veileder på helsenorge skal hoppe videre til en annen side, kan denne funksjonen benyttes, så fremt det er greit å forlate kontekst og ingen data skal fylles ut. 

Angir om lenke skal åpnes i ny eller egen fane som benyttes på enkeltelementer. Settes i Skjemabyggeren pr element som default, og kan så overstyres pr. Item 

• 1 er default -  - åpnes i ny fane 

• 2 er åpner i samme fane 

Ja

http://helsenorge.no/fhir/StructureDefinition/sdf-hyperlink-target

prefiks

Strengverdi ("prefix") som legger seg foran spørsmålsteksten (text) 

Nei

definition

Lenke til definisjonen av elementet

Nei

repeats

En boolean verdi som angir om gruppe eller element kan repeteres. 

Nei

repeatstext

Tekst på knappen i brukergrensesnittet for å legge til en gruppe eller et element.

Ja

http://ehelse.no/fhir/StructureDefinition/repeatstext

questionnaire-minOccurs

Minimum antall repetisjoner

Ja

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

questionnaire-maxOccurs

Maksimum antall repetisjoner. Må alltid settes

Ja

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

guidanceaction

En relativ url til en side på helsenorge. Benyttes til å sende innbygger videre til en side på Helsenorge etter at skje er ferdigstilt. Det er aktiverte elementer, og siste element med referanse til annen side som benyttes. 

Ja

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

guidanceparameter

Angis på et felt der verdien skal overføres til destinasjonen til guidanceAction. Benyttes for å merke elementer for videre bruk. Intern bruk på Helsenorge. 

Ja

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

itemControl - help

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

Ja

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

hidden

Angir om og hvor elementet skal vises. Hidden er en extension. 

De andre er det benyttet "code" for å kunne støtte de ulike visningsalternativene.  http://helsenorge.no/fhir/CodeSystem/RenderOptions

Ja

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

Save-capabilties

Lagringsattributtet som er definert globalt på skjemadefinisjonen, kan overstyres på elementnivå. 

Det betyr at man ved hjelp av regler i skjemaet, f.eks. kan sørge for at et skjema, avhengig av utfall, kan sendes, kun lagres, eller bare avsluttes.  

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

Score / Ordinal value / Question score

Answer option:

Mulighet for å angi en ordinalValue som kan benyttes i skåring. Det settes også en code, som indikerer at dette elementet benyttes i skåring (score), samt en kode som sier at det er et spørsmål (Question score).

Man kan oppgi verdiene når man etablerer kodeverket:

Image Added

"code": [ { "system": "http://ehelse.no/Score", "code": "score", "display": "score" }

{ "system": "http://ehelse.no/scoringFormulas", "code": "QS", "display": "Question score" } ],

Extension

http://hl7.org/fhir/StructureDefinition/ordinalValue

Score / Section score / Total score

Decimal / Integer / Quantity:

Man kan sette to “codes” for å indikere at det er et summeringsfelt for skåring. Det er en “code”som indikerer at elementet benyttes i skåring (score) samt en “code” som indikerer at det er en seksjonssum (section score) eller totalsum (total score). Section score summerer overliggende verdier i spørsmål merket med QS i en gruppe. Total score summerer alle overliggende verdier i spørsmål merket med QS i hele Questionnaire.

"code": [ { "system": "http://ehelse.no/Score", "code": "score", "display": "score" }

{ "system": "http://ehelse.no/scoringFormulas", "code": "SS", "display": "Section score" } ]

{ "system": "http://ehelse.no/scoringFormulas", "code": "TS", "display": "Total score" } ]