Applikasjonen
Skjemabyggeren er et nettbasert verktøy skrevet i React for å generere skjemadefinisjoner. Applikasjonen har ingen avhengigheter til backend-systemer eller APIer.
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 en lokal fil av 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 nettleser sesjon.
"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 bakerste ledd i URL til skjema. Samme tekniske navn benyttes kun på samme skjema med ulikt språk. | 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å samtykkenivå:
Man kan snart, på Helsenorge reservere seg fra å motta skjema til sekundærbruk.
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.
| 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 | |
 | 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
| Ja | http://helsenorge.no/fhir/StructureDefinition/sdf-presentationbuttons |
 | GenererPDF | Om det skal genereres PDF eller ei. | Ja | |
 | 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:
Hvilke knapper som vises, styres som i dag:
| 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 |
|---|---|---|---|---|
 | 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
| |
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
| |
 | 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:
| |
 | 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. | ||
 | 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. |
Egenskaper som kan setter pr item
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 | |
 | Instruks | Gir en forklarende tekst under spørsmålsteksten | Ja | |
 | Validering | Tekstvalidering: I denne seksjonen kan man legge inn regulære uttrykk, sette minimum og maksimum antall tegn i tekstfeltet. | Ja | |
 | 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 |
 | Validering | Dato I denne seksjonen kan man sette minimum og maksimum datoer. Man kan legge inn:
 | Ja | |
 | maxSize | Vedlegg Maksimal størrelse på filvedlegg. Normalt skal ikke større filer sendes, men deles. | Ja | |
 | 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 | |
 | 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:
| 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. | |||
 | 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 | |
 | entryFormat | Skyggetekst for forventet input. I nedtrekkslister kan man angi en forklarende tekst som "velg her" | Ja | |
 | 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
| 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 | |
 | 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 |
| 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 |
 | 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:
Hvilke knapper som vises, styres som i dag:
| Ja | http://helsenorge.no/fhir/StructureDefinition/sdf-save-capabilities |
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 | |
maxValue | Må være <= verdi | Ja | |
minValue | Må være >= verdi | Ja | |
maxLength | Maksimum antall tegn | Nei | - |
minLength | Minimum antall tegn | Ja | |
required | Må fylles ut | Nei | - |
regex | Regulært uttrykk | Ja | |
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 | |
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 | |
fhirPathMinValue | Et programmatisk uttrykk som angir en minimumverdi (FhirPath) | Ja |