Nøglekoncepter
Oversigt over formulardesign
Hvad er en XLSForm?
rtSurvey bruger en udvidet version af XLSForm-standarden til formulardesign og tilbyder kraftfulde funktioner til oprettelse af avancerede undersøgelser. Denne guide introducerer dig til nøglekoncepterne i formulardesign i rtSurvey, fra grundlæggende XLSForm-struktur til avancerede rtSurvey-specifikke funktioner.
Med XLSForms kan du oprette formularer i et menneskevenligt format ved hjælp af det velkendte Excel-værktøj, hvilket gør det tilgængeligt for næsten alle. Denne standard muliggør nem deling og samarbejde om formularoprettelse.
Selvom XLSForms er begyndervenlige, giver de også erfarne brugere mulighed for at oprette komplekse formularer.
rtSurvey giver en konsistent måde at inkorporere avancerede funktionaliteter såsom spring-logik i formularer på tværs af forskellige web- og mobil-dataindsamlingsplatforme.
XLSForm-struktur
En XLSForm består typisk af to primære regneark:
- survey: Definerer formularens struktur og indhold.
- choices: Angiver svarmuligheder til multiple-choice-spørgsmål.
Et valgfrit settings-regneark kan give yderligere formularspecifikationer.
Det er vigtigt at bemærke, at de obligatoriske kolonner i survey- og choices-regnearkene skal være til stede, for at formularen fungerer korrekt. Valgfrie kolonner i begge regneark giver yderligere kontrol over adfærden for hver post i formularen, men er ikke afgørende.
Kolonnerne i din Excel-arbejdsmappe kan vises i vilkårlig rækkefølge, og valgfrie kolonner kan stå tomme. Det er dog afgørende at bruge den præcise syntaks og navngivningskonventioner, der er angivet i XLSForm-dokumentationen, for at formularen fungerer korrekt.
Survey-regnearket
Survey-regnearket er der, hvor du definerer formularens struktur og indhold. Hver række i survey-regnearket repræsenterer et spørgsmål eller element i din formular. Følgende kolonner er obligatoriske i survey-regnearket:
type: Angiver den type post, du forventer som svar på spørgsmålet.name: Angiver det unikke variabelnavn for denne post. Navne skal starte med et bogstav eller en understregning og må kun indeholde bogstaver, cifre, bindestreger, understregninger og punktummer. Navne er versalfølsomme.label: Indeholder den faktiske tekst, du ser for spørgsmålet i formularen.
| type | name | label |
|---|---|---|
| today | today | |
| select_one gender | gender | Respondentens køn? |
| integer | age | Respondentens alder? |
Choices-regnearket
choices-regnearket bruges til at angive svarmuligheder til multiple-choice-spørgsmål. Hver række repræsenterer en svarmulighed. Følgende kolonner er obligatoriske i choices-regnearket:
list_name: Grupperer et sæt relaterede svarmuligheder.name: Angiver det unikke variabelnavn for denne svarmulighed.label: Viser svarmuligheden præcis, som du ønsker, den skal vises i formularen.
| list_name | name | label |
|---|---|---|
| gender | transgender | Transkønnet |
| gender | female | Kvinde |
| gender | male | Mand |
| gender | other | Andet |
Kolonnerne du tilføjer til din Excel-arbejdsmappe, hvad enten de er obligatoriske eller valgfrie, kan vises i vilkårlig rækkefølge. Valgfrie kolonner kan udelades fuldstændigt. Rækker eller kolonner kan stå tomme for at hjælpe med læsbarheden, men data efter 20 tilstødende tomme kolonner eller rækker på et ark behandles ikke. Al .xlsx-filformatering ignoreres, så du kan bruge skillelinjer, farver og anden skriftformatering for at gøre formularen mere læsbar.
Én ting at huske på, når du opretter formularer i Excel, er, at den syntaks, du bruger, skal være præcis. Hvis du f.eks. skriver Choices eller choice i stedet for choices, fungerer formularen ikke.
Settings-regnearket
Settings-regnearket er valgfrit, men giver dig mulighed for at angive metadata og adfærd på formularniveau. Almindelige kolonner i settings-regnearket inkluderer:
| Kolonne | Beskrivelse |
|---|---|
| form_title | Formularens titel som vist til brugerne |
| form_id | En unik identifikator til formularen, bruges i datastyring og API-kald |
| default_language | Standardsprogkoden til flersprogede formularer (f.eks. ‘da’ for dansk) |
| version | Formularens versionsnummer, nyttigt til sporing af ændringer |
| instance_name | Udtryk til generering af et unikt navn til hver formularindsendelse |
| generation | Heltal, der markerer formularens generation. Øg ved strukturelle ændringer |
| family | Identifikator til gruppering af relaterede formularer på tværs af strukturelle ændringer |
Settings-regnearket i rtSurvey kan også inkludere yderligere konfigurationer, der er specifikke for rtSurveys udvidede funktionaliteter. Se rtSurvey-dokumentationen for en komplet liste over understøttede indstillinger.
Nøglekomponenter i survey-regnearket
Survey-regnearket er kernen i dit formulardesign. Her er en oversigt over dets nøglekomponenter:
| Komponent | Beskrivelse |
|---|---|
| type | Angiver spørgsmålstypen (f.eks. text, integer, select_one) |
| name | Unik identifikator til spørgsmålet |
| label | Den tekst, der vises til respondenten |
| hint | Yderligere vejledning til respondenten |
| appearance | Ændrer, hvordan spørgsmålet vises |
| relevant | Bestemmer, hvornår spørgsmålet skal stilles (spring-logik) |
| constraint | Validerer svaret |
| calculation | Beregner værdier baseret på andre svar |
| required | Angiver, om spørgsmålet skal besvares |
Hver af disse komponenter spiller en afgørende rolle i at skabe effektive og virkningsfulde undersøgelser.
Spørgsmålstyper
XLSForm understøtter et antal spørgsmålstyper. Her er blot nogle af de muligheder, du kan indtaste i kolonnen type i survey-regnearket i din XLSForm:
| Spørgsmålstype | Svarinput |
|---|---|
| integer | Heltalsinput (dvs. hele tal). |
| decimal | Decimalinput. |
| range | Range-input (herunder vurdering) |
| text | Fritekstsvar. |
| select_one [options] | Multiple-choice-spørgsmål; kun ét svar kan vælges. |
| select_multiple [options] | Multiple-choice-spørgsmål; flere svar kan vælges. |
| select_one_from_file [file] | Multiple-choice fra fil; kun ét svar kan vælges. |
| select_multiple_from_file [file] | Multiple-choice fra fil; flere svar kan vælges. |
| rank [options] | Rang-spørgsmål; sortering af en liste. |
| note | Viser en note på skærmen, tager intet input. |
| geopoint | Indsaml en enkelt GPS-koordinat. |
| geotrace | Registrér en linje af to eller flere GPS-koordinater. |
| geoshape | Registrér et polygon af flere GPS-koordinater; det sidste punkt er det samme som det første. |
| date | Datoinput. |
| time | Tidsinput. |
| dateTime | Accepterer både dato- og tidsinput. |
| image | Tag et billede eller upload en billedfil. |
| audio | Tag en lydoptagelse eller upload en lydfil. |
| background-audio | Lyd optages i baggrunden, mens formularen udfyldes. |
| video | Tag en videooptagelse eller upload en videofil. |
| file | Generelt filinput (txt, pdf, xls, xlsx, doc, docx, rtf, zip) |
| barcode | Scan en stregkode, kræver stregkodescanner-appen installeret. |
| calculate | Udfør en beregning; se afsnittet Beregning nedenfor. |
| acknowledge | Bekræftelsesprompt, der sætter værdien til “OK”, hvis valgt. |
| hidden | Et felt uden tilknyttet UI-element, som kan bruges til at gemme en konstant |
| xml-external | Tilføjer en reference til en ekstern XML-datafil |
Labels
Labels er den tekst, der vises til respondenter for hvert spørgsmål. De er afgørende for klar kommunikation i undersøgelser.
- Grundlæggende brug: I kolonnen
labelskal du indtaste spørgsmålsteksten. - Flere sprog: Brug yderligere kolonner som
label::Danskoglabel::Engelsktil flersprogede undersøgelser. - Formatering: rtSurvey understøtter grundlæggende HTML-formatering i labels til fremhævelse eller struktur.
Eksempel:
| type | name | label | label::French |
|------|------|-------|---------------|
| text | name | Hvad er dit navn? | Quel est votre nom? |
Hints
Hints giver yderligere vejledning til respondenter uden at belemre den primære spørgsmålstekst.
- Brug: Tilføj hints i kolonnen
hint. - Synlighed: Hints vises typisk under den primære spørgsmålstekst.
- Flersproglige: Ligesom labels kan hints specificeres for flere sprog ved hjælp af
hint::Sprog-kolonner.
Eksempel:
| type | name | label | hint |
|------|------|-------|------|
| integer | age | Hvor gammel er du? | Angiv venligst din alder i år |
Appearance
Kolonnen appearance i rtSurvey giver mulighed for tilpasning af, hvordan spørgsmål vises.
- Standardvalgmuligheder: Inkluderer ‘multiline’ til tekst, ‘horizontal’ til select-spørgsmål.
- rtSurvey-udvidelser:
- Tidsinput: Forskellige urbetjeningsindstillinger (f.eks.
inline,inline-1line) - Farvetilpasning: Brug funktionen
colors()til at ændre ikonfarver
- Tidsinput: Forskellige urbetjeningsindstillinger (f.eks.
Relevant
Kolonnen relevant implementerer spring-logik og bestemmer, hvornår et spørgsmål skal vises.
- Syntaks: Brug XPath-udtryk til at definere betingelser.
- Variabler: Reference til andre spørgsmålsnavne ved hjælp af
${question_name}.
Required
Kolonnen required angiver, om et spørgsmål skal besvares.
- Grundlæggende brug: Brug ‘yes’ eller ’true’ for at gøre et spørgsmål obligatorisk.
- Avanceret: Kan bruge udtryk til betinget krav.
Repeats
Repeats giver en gruppe af spørgsmål mulighed for at blive besvaret flere gange.
- Brug: Brug
begin repeat- ogend repeat-rækker til at definere en gentaget gruppe. - Navngivning: Giv hver gentagelsesgruppe et unikt navn.
Medier
rtSurvey understøtter forskellige medietyper i undersøgelser, herunder billeder, lyd og video.
rtSurvey-udvidelser
rtSurvey udvider XLSForm-standarden ved at understøtte yderligere muligheder såsom grid layout, html format og mange nye widgets.
Grid-layout
rtSurvey giver din formular mulighed for at efterligne udseendet af traditionelle papirundersøgelser ved at komprimere flere spørgsmål på én række.