Teknisk beskrivelse

Applikasjonen

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å lagres en lokal fil med Questionnaire-en i json-format.

Sikkerhet

Applikasjonen har ingen koblinger til API eller til andre systemer.

Brukerstyrt flyt

 

Forklaring:

  • "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 nettlesersesjon.

  • "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.

Disse bruksmønstrene representerer de primære handlingene en bruker kan utføre i Skjemabyggeren. Brukeren kan enten laste opp et eksisterende spørreskjema, starte et nytt eller fortsette arbeidet på et tidligere lagret spørreskjema. Deretter kan de utvikle spørreskjemaet ved å tilpasse innhold og struktur, og til slutt laste det ned som en JSON-fil.

Egenskaper som kan settes i en skjemadefinisjon. 

Skjemadefinisjoner som genereres av Skjemabyggeren inneholder global og lokal helsenorge funksjonalitet. Lokale utvidelser håndteres i Helsenorges skjemautfyller, men skal oversees og ikke tas hensyn til i andre fhir-baserte skjemautfyllere. 

Dette gjelder utvidelser der Extension URI er , merket med "NHN.no" og "Ehelse.no". 

 

Trenger du mer informasjon om praktisk bruk av skjemabyggeren, se brukerveiledningen. 

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 siste ledd i URL til skjema. Alle 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 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 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 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

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

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.  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.  

Egenskaper som kan setter pr item

Felt i skjemabygger

Navn

Beskrivelse

Extension

Extension Uri

Felt i skjemabygger

Navn

Beskrivelse

Extension

Extension Uri

 

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:

"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" } ]

 

 

Validering

Skjemautfylleren støtter et begrenset sett funksjonelle valideringsregler. Deler av definisjonene for valideringsreglene er innebygget i FHIR-standarden mens andre er egenutviklete extensions eller hentet fra FHIR sitt eget Extensibility registry. For at skjemaet skal kunne ferdigstilles er det påkrevet at all informasjon lagt inn av brukeren i overensstemmelse med valideringsreglene

Navn

Beskrivelse

Extension

Extension Uri

Navn

Beskrivelse

Extension

Extension Uri

maxDecimalPlaces

Antall tillatte desimalplasser

Ja

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

maxValue

Må være <= verdi

Ja

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

minValue

Må være >= verdi

Ja

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

maxLength

Maksimum antall tegn

Nei

-

minLength

Minimum antall tegn

Ja

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

required

Må fylles ut

Nei

-

regex

Regulært uttrykk

Ja

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

maxOccurs

Maksimum antall ganger en repeterende gruppe eller spørsmål kan forekomme. Eller maksimum valg som må være utført ved flervalgspørsmål.

Ja

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

minOccurs

Minimum antall ganger en repeterende gruppe eller spørsmål kan forekomme. Eller minimum valg som må være utført ved flervalgspørsmål

Ja

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

maxSize

Størrelsebegrensning på vedlegg

Ja

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

fhirPathValidation

Et programmatisk uttrykk som angir en valideringsregel (FhirPath)

Ja

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

fhirPathMaxValue

Et programmatisk uttrykk som angir en maksverdi (FhirPath)

Ja

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

fhirPathMinValue

Et programmatisk uttrykk som angir en minimumverdi (FhirPath)

Ja

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

Mattematiske uttrykk

Man kan ved hjelp av FHIR-path-uttrykk gjøre diverse beregninger i skjemautfylleren. Det er i feltet “Kalkuleringsformel” disse utrykkende settes. Man oppgir LinkID for de ulike feltene man skal begrene på i uttrykket. Man kan benytte datatypene Quantity (value.value), Integer (value) og Decimal (value).

Navn

Beskrivelse

Uttrykk

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