Tabseparert verdi-struktur for undersøkelser

Import og eksport av undersøkelsesstruktur med tabseparerte verdier

Denne funksjonen gjør det enkelt å bruke regnearkprogramvare som LibreOffice, Excel eller Google Docs til å lage og redigere undersøkelser. Det eliminerer helt avhengigheten av SGQA-koder.

Funksjonen støtter import fra ASCII- eller UTF-8-kodede filer med tabseparerte verdier (TSV) som har filtypen .txt.

Se dette eksempelet for å få en bedre forståelse av denne funksjonaliteten.

Kom i gang

Den enkleste måten er å ta en eksisterende undersøkelse og eksportere den i format med tabseparerte verdier. Bruk den vanlige knappen for å eksportere undersøkelse, og velg «Tab Separated Values format (*.txt)» i stedet for .lss-formatet. Undersøkelsen lagres som en fil med tabseparerte verdier i riktig format (tabulatorseparert Unicode-fil), med alle riktige kolonneoverskrifter.

All regnearkprogramvare som støtter tabseparerte verdier fungerer fint (f.eks. OpenOffice eller LibreOffice). LimeSurvey ignorerer all formatering i regnearket, men du kan gjerne legge til noe hvis det hjelper deg.

Merk at den eksporterte filen er i UTF-8-format med Byte Order Mark (BOM) som de tre første (skjulte) tegnene. Hvis du dobbeltklikker på .txt-filen og prøver å åpne den direkte i Excel, åpnes den ikke riktig fordi Excel ikke forstår at den er UTF-8-formatert. For å åpne disse filene i Excel må du først åpne Excel, deretter velge File:Open, velge .txt-filen og fortelle Excel at den bruker UTF-8-koding.

Det er én rad for hver gruppe, hvert spørsmål, hvert underspørsmål og hvert svar. Det finnes også rader for globale undersøkelsesvariabler og for språkspesifikke undersøkelsesvariabler. Hovedspråket står først, etterfulgt av eventuelle sekundære språk. Hvis det er flere språk, vises altså hele innholdet i grunnspråket først (f.eks. alle grupper, spørsmål, underspørsmål og svar). Deretter følger en oversatt kopi for hvert sekundære språk (med nøyaktig samme antall og rekkefølge på radene i det oversatte settet).

Relasjoner utledes ut fra plassering. Spørsmål som står etter en gruppe, hører til den gruppen; underspørsmål som står etter et spørsmål, hører til det spørsmålet, og svar som står etter et spørsmål, hører til det spørsmålet. Du trenger derfor ikke å kjenne ID-ene (gid, qid, sqid) til noen spørsmål. Disse beregnes automatisk ved import. Dette formatet bruker faktisk ikke gid, qid eller sqid (eller SGQA-koder) i det hele tatt.

Tips

Målet med import/eksport av tabseparerte verdier er at du raskt skal kunne utforme undersøkelsen din i et regneark. Vi forventer at du ofte importerer arket, kontrollerer at det er gyldig ved hjelp av funksjonen «Vis undersøkelseslogikk», og tester det. Hver gang du importerer det, får du en ny undersøkelse. Du kan derfor ende opp med mange delvis utviklede undersøkelser, men det er helt greit. Bare vend deg til å holde styr på hvilken som er den nyeste, eller slett den gamle etter at du har importert den nye. Siden du aldri bruker SGQA-koder i tabseparerte verdier, trenger du aldri å bekymre deg for hvilke koder LimeSurvey tildeler som nøkler for hovedundersøkelsen, gruppene, spørsmålene og svarene. Importer og eksporter derfor så ofte du vil.

Her er noen praktiske ting du kan gjøre med denne tilnærmingen til å lage instrumenter:

1. Bruk de samme svarene for mange spørsmål. Kopier 'A'-radene og lim dem inn etter hvert spørsmål som skal ha det samme settet.
2. Bruk de samme underspørsmålene for mange spørsmål. Kopier 'SQ'-radene og lim dem inn etter hvert spørsmål som trenger dem.
3. «Løkker» – bruk den samme gruppen mange ganger. Når gruppen er slik du vil ha den, kopierer du den så mange ganger som nødvendig. Bruk Excel-filtrering for å vise bare 'G'-radene (for grupper), og bruk Excels funksjon for å dra i kolonner til å oppdatere relevansligningene for hver gruppe (f.eks. for en folketelling kan den første relevansen være «numPeople > 1», den neste bør være «numPeople > 2». Dra-funksjonen oppdaterer tallet automatisk). Filtrer på 'Q'-rader og sørg for at hvert spørsmål har en unik verdi (f.eks. hvis du gir variablene navnene g1_q1, g1_q2, g1_qN, bruker du finn/erstatt til å endre g1 til g2 for den andre gruppen, g3 for den tredje osv.).
4. Endre rekkefølgen på spørsmål/grupper. Endre ganske enkelt rekkefølgen på radene i regnearkfilen.
5. Testing av undersøkelsesmoduler. For lange undersøkelser kan det være lurt å dele opp testingen i moduler. Opprett nye regnearkfiler for hver modul, og slett alle rader du ikke trenger. Da slipper du å legge inn mye data for å teste senere deler av undersøkelsen.
6. Testing av obligatoriske spørsmål. En vanlig klage er ikke at mange spørsmål må gjøres obligatoriske, men at man må slå av den obligatoriske funksjonen under testing. Opprett hovedregnearket med obligatorisk satt til de endelige ønskede verdiene. For å teste det sletter du bare kolonnen «mandatory» og lagrer testversjonen av regnearket. Når du importerer den versjonen, vil ingen av spørsmålene være obligatoriske. Når du er ferdig med testingen, importerer du hovedkopien.
7. Angi standardverdier. I stedet for å bruke det grafiske grensesnittet kan du skrive inn ønskede standardverdier i standardkolonnen (default). Dette er særlig nyttig i tilfeller der det grafiske grensesnittet ikke lar deg angi ønsket verdi, for eksempel uttrykk for å angi standardverdien for listeelementer (som å fylle en liste fra en attributt for en deltaker).
8. Oversettelse. Du kan lage kopier av regnearket – én per språk. Ta med alle radene for hovedspråket, kopier og lim dem inn nedenfor, og bruk dra-funksjonen til å endre språkfeltet til målspråket. Disse kan sendes til oversetterne og settes sammen igjen i én regnarkfil når de er ferdige.
9. Masseinnstilling av avanserte spørsmålsattributter. Du vil kanskje at alle ligningene dine skal være synlige til å begynne med (slik at du kan se verdiene deres mens du samler inn data), men skjule dem alle før produksjon. Filtrer regnearket på class = 'Q' og question type = '*' (ligning), og sett always_hide til 1 for hvert av disse spørsmålene. På samme måte, si at du etter å ha opprettet undersøkelsen bestemmer hvilke spørsmål som skal vises i offentlig statistikk. I stedet for å redigere hvert spørsmål via det grafiske grensesnittet filtrerer du på class = 'Q' og setter public_statistics = 1 for alle spørsmål som skal være synlige i statistikken.
10. Finn og erstatt. Hvis du bestemmer deg for å endre formuleringer i alle spørsmålene dine, kan du bruke Excels finn og erstatt til å gjøre endringene. På samme måte kan finn og erstatt komme til unnsetning hvis du vil gi nytt navn til mange variabler samtidig. Hvis du trenger finn og erstatt basert på regulære uttrykk, kan du velge ønsket kolonne, kopiere den til et tekstredigeringsprogram, utføre finn og erstatt der og lime kolonnen inn i regnearket igjen.
11. Innhenting av godkjenninger. Hvis du driver med forskning, kan du ha en etisk komité som krever å se teksten i spørsmålene. Dette kan være en praktisk måte å dele den på. Det samme gjelder diskusjoner med en kunde.
12. Enighet i teamet. Hvis du prøver å få en gruppe til å bli enig om formuleringen eller utseendet til et spørsmål eller en gruppe, kan du raskt lage en prototype / redigere regnearket, importere det og vise teamet (via forhåndsvisning av spørsmål eller gruppe) nøyaktig hva brukerne vil se. På den måten kan du få teamets godkjenning før de forlater rommet, i stedet for å måtte dokumentere krav, bygge dem og få godkjenning på senere møter.
13. Oppgradering fra andre undersøkelsesformater. Hvis undersøkelsen din er i XML, Word eller et annet format, kan du lage en oversettelsesprosess for å konvertere dem til dette formatet. Selv om du også kan prøve å konvertere til .lss-formatet, er fordelen med dette formatet at du ikke trenger å holde styr på fremmednøkkelrelasjoner mellom grupper, spørsmål, underspørsmål, svar og standardverdier.

Begrensninger

1. Etter design fungerer denne funksjonen bare riktig for undersøkelser som bruker qcode-navngiving (i stedet for SGQA). Funksjonen forutsetter at variabelnavn (spørsmålsidentifikatorer) er unike i hele undersøkelsen. Navn på underspørsmål kan gjentas, så lenge de er unike innenfor et bestemt spørsmål.

Filformat

Generelt

Vi bruker de samme kolonneoverskriftene til flere formål. De første 14 kolonnene har ulike formål avhengig av typen enhet (f.eks. gruppe, spørsmål, svar). De resterende kolonnene er en alfabetisk liste over databasefeltnavnene for de avanserte spørsmålskodene. Nedenfor er syntaksen for hver enhetstype

De første 14 kolonnene er:

1. id ^{(New in 3.14.0 )}
2. related_id ^{(New in 3.14.0 )}
3. class
4. type/scale
5. name
6. relevance
7. text
8. help
9. language
10. validation
11. mandatory
12. other
13. default
14. same_default

 Hint: Kolonnene id og related_id brukes bare for kvoter og er valgfrie. Hvis du ikke har kvoter, kan du fjerne disse to kolonnene direkte.

Globale undersøkelsesparametere

Det er én rad per parameter i surveys-tabellen.

1. class => 'S'
2. name => databasefeltnavn
3. text => verdi

Språkspesifikke undersøkelsesparametere

Det er én rad per felt per språk i surveys_languagesettings-tabellen. Alle oppføringer for et gitt språk samles før de settes inn i den tabellen.

1. class => 'SL'
2. name => databasefeltnavn
3. text => verdi
4. language => språk

Grupper

Én grupperad per undersøkelsesspråk (f.eks. vil det være 3 grupperader hvis undersøkelsen har 3 språk).

1. id => unik numerisk identifikator for gruppen, som starter med tallet 1; bruk samme ID for flere språk som tilhører gjeldende gruppe
2. class => 'G'
3. name => group_name -- den unike identifikatoren for gruppen
4. relevance => grelevance -- relevansligningen på gruppenivå, uten krøllparenteser
5. text => description -- den språkspesifikke beskrivelsen av gruppen
6. language => language -- språket for gruppen (f.eks. 'en')

Spørsmål

Én spørsmålsrad per undersøkelsesspråk (f.eks. vil det være 3 spørsmålsrader hvis undersøkelsen har 3 språk). Spørsmål antas å tilhøre gruppen som står foran dem.

1. id => unik numerisk identifikator for spørsmålet, som starter med tallet 1; bruk samme ID for flere språk som tilhører gjeldende spørsmål
2. class => 'Q'
3. type/scale => type -- spørsmålstypen (vanligvis én bokstav) (f.eks. er 'M' flervalg)
4. name => title -- det unike spørsmålsnavnet (roten i qcode-navngivingssystemet)
5. relevance => relevance -- relevansligningen for spørsmålet
6. text => question -- den språkspesifikke teksten til spørsmålet
7. help => help -- den språkspesifikke hjelpeteksten
8. language => language -- språket for gruppen (f.eks. 'en')
9. validation => preg -- de valgfrie valideringskriteriene med regulært uttrykk for spørsmålet
10. mandatory => mandatory -- 'Y' hvis obligatorisk
11. other => other -- 'Y' hvis alternativet «Annet» skal være tilgjengelig (bare for enkelte spørsmålstyper)
12. default => default -- hvis angitt, settes denne verdien inn i defaultvalues-tabellen for dette spørsmålet
13. same_default => same_default -- 'Y' for sant, og da gjelder en eventuell standardverdi angitt for hovedspråket også for andre språk

Underspørsmål

Én underspørsmålsrad per undersøkelsesspråk. Underspørsmål antas å tilhøre spørsmålet som står foran dem.

1. id => samme unike numeriske identifikator som brukes for spørsmålene. Underspørsmål bør bruke neste tilgjengelige verdi, og ID-ene for spørsmål og underspørsmål må være forskjellige (bruk f.eks. ID 1 for spørsmålet og ID 2, 3 og 4 for underspørsmål som tilhører spørsmål 1, neste spørsmåls-ID bør være 5, og så videre). Bruk samme underspørsmåls-ID for ytterligere språk som tilhører gjeldende underspørsmål.
2. class => 'SQ'
3. type/scale => scale_id -- 0 eller 1, avhengig av spørsmålstype (f.eks. vil et matrisespørsmål med tekst ha to skalaer)
4. name => title -- «navnet» på underspørsmålet, f.eks. det som brukes for exclude_all_others
5. relevance => relevance -- (Fremtidig) for å støtte relevans på underspørsmålsnivå
6. text => question -- den språkspesifikke teksten til underspørsmålet
7. help => help -- (Fremtidig) for å støtte hjelpetekst på underspørsmålsnivå
8. language => language -- språket for underspørsmålet
9. validation => preg -- (Fremtidig) for å støtte validering med regulære uttrykk på underspørsmålsnivå (f.eks. for adressedeler)
10. mandatory => mandatory -- (Fremtidig) for å støtte obligatoriske underspørsmål (f.eks. for å gjøre bare noen få underspørsmål obligatoriske)
11. default => default -- hvis satt, er dette standardverdien for underspørsmålet (settes inn i tabellen defaultvalues)
12. same_default => same_default -- hvis satt, brukes standardverdien for hovedspråket for alle andre språk

Svar

Én svarrad per undersøkelsesspråk (f.eks. vil det være 3 svarrader hvis undersøkelsen har 3 språk). Svar antas å tilhøre spørsmålet som står foran dem, og å stå i ønsket rekkefølge.

1. id => bruk samme ID som ID-en til spørsmålet svaret tilhører
2. class => 'A'
3. type/scale => scale_id -- 0 eller 1 (f.eks. for spørsmål med to skalaer)
4. name => code -- den unike svarkoden
5. relevance => assessment_value -- hvis vurderingsfunksjonen brukes, er dette vurderingsverdien for svaret
6. text => answer -- den språkspesifikke teksten til svaret
7. language => language -- språket for dette svaret (f.eks. 'en')

Vurderinger

Én vurderingsrad per undersøkelsesspråk (f.eks. vil det være 3 vurderingsrader hvis undersøkelsen har 3 språk). Vurderinger skrives på slutten av filen.

1. id => unik numerisk identifikator for vurderingen, med start på 1. Bruk samme ID for ytterligere språk som tilhører gjeldende vurdering
2. related_id => ID-en til gruppen som gjeldende vurdering tilhører
3. class => 'AS'
4. type/scale => vurderingens omfang: T-Total, G-gruppe
5. name => name
6. text => message
7. min_num_value => Minimum
8. max_num_value => Maksimum
9. language => language -- språket for dette svaret (f.eks. 'en')

Kvoter

Én rad per kvote. Kvoter skrives på slutten av filen.

1. id => unik numerisk identifikator for kvoten, med start på 1
2. class => 'QTA'
3. name => navn på kvote
4. mandatory => limit
5. other => når kvote er oppnådd
6. default => aktiv
7. same_default => last URL automatisk

Språkinnstillinger for kvote

Én kvoterad per undersøkelsesspråk. Språkinnstillinger for kvote antas å tilhøre kvoten som står foran dem.

1. id => unik numerisk identifikator for språkinnstillingene for kvoten, med start på 1. Hver rad for ulike undersøkelsesspråk må ha forskjellig ID
2. related_id => ID-en til kvoten innstillingen tilhører
3. class => 'QTALS'
4. relevance => message
5. text => URL
6. help => URL-beskrivelse
7. language => language -- språket for denne kvoten (f.eks. 'en')

Kvotemedlemmer

Én rad per kvotemedlem, ikke språkavhengig. Raden for kvotemedlemmet skal plasseres rett etter spørsmålet den gjelder. Kvotemedlemmer antas å tilhøre spørsmålet som står foran dem.

1. id => unik numerisk identifikator for kvotemedlemmet, med start på 1
2. related_id => ID-en til kvoten medlemmet tilhører
3. class => 'QTAM'
4. name => svarkode

Betingelser

Én rad per betingelse, ikke språkavhengig. Betingelsesraden skal plasseres rett etter spørsmålet den gjelder. Betingelser antas å tilhøre spørsmålet som står foran dem.

1. id => unik numerisk identifikator for betingelsen, med start på 1.
2. related_id => ID-en til det relaterte spørsmålet, hvis aktuelt
3. class => 'C'
4. type/scale => scenario
5. name => feltnavn for svaret
6. relevance => sammenligningsoperator
7. text => forventet svar