Enkätstruktur i tabbseparerade värden

Import och export av enkätstruktur i tabbseparerade värden

Den här funktionen gör det enkelt att använda kalkylprogram som LibreOffice, Excel eller Google Docs för att skapa och redigera enkäter. Det eliminerar helt beroendet av SGQA-koder.

Funktionen stöder import från filer med tabbseparerade värden (TSV) som är kodade i ASCII eller UTF-8 och har filändelsen .txt.

Titta på följande exempel för att få en bättre förståelse för funktionen.

Komma igång

Det enklaste sättet är att ta en befintlig enkät och exportera den i formatet tabbseparerade värden. Använd den vanliga knappen för att exportera enkäten, och välj "Tab Separated Values format (*.txt)" i stället för .lss-formatet. Enkäten sparas som en fil med tabbseparerade värden i rätt format (tabbavgränsad unicode-fil), med alla korrekta kolumnrubriker.

Alla kalkylprogram som stöder tabbseparerade värden fungerar (t.ex. OpenOffice eller LibreOffice). LimeSurvey ignorerar all formatering i kalkylbladet, men du kan gärna lägga till formatering om det hjälper dig.

Observera att den exporterade filen är i UTF-8-format med Byte Order Mark (BOM) som de tre första (dolda) tecknen. Om du dubbelklickar på .txt-filen och försöker öppna den direkt i Excel öppnas den inte korrekt, eftersom Excel inte förstår att filen är UTF-8-formaterad. För att öppna sådana filer i Excel, starta först Excel, välj sedan Arkiv:Öppna, välj .txt-filen och ange att Excel ska använda UTF-8-kodning.

Det finns en rad för varje grupp, fråga, delfråga och svar. Det finns också rader för globala enkätvariabler och för språkspecifika enkätvariabler. Huvudspråket listas först, följt av eventuella sekundära språk. Om det finns flera språk visas alltså hela innehållet för startspråket först (t.ex. alla grupper, frågor, delfrågor och svar). Därefter följer en översatt kopia för varje sekundärt språk (med exakt samma antal rader i samma ordning för den översatta uppsättningen).

Relationer avgörs av närhet. Frågor som följer efter en grupp tillhör den gruppen, delfrågor som följer efter en fråga tillhör den frågan, och svar som följer efter en fråga tillhör den frågan. Du behöver alltså inte känna till ID:n (gid, qid, sqid) för några frågor. Dessa beräknas automatiskt vid import. Faktum är att det här formatet inte använder gid, qid eller sqid (eller SGQA-koder) alls.

Tips

Syftet med import och export av tabbseparerade värden är att du snabbt ska kunna utforma din enkät i ett kalkylblad. Vi räknar med att du ofta importerar kalkylbladet, kontrollerar att det är giltigt med funktionen "Visa enkätlogik" och testar det. Varje gång du importerar det får du en ny enkät. Du kan alltså få många delvis färdiga enkäter, men det är inget problem. Vänj dig bara vid att hålla reda på vilken som är den senaste, eller radera den gamla när du har importerat den nya. Eftersom du aldrig använder SGQA-koder i tabbseparerade värden behöver du aldrig oroa dig för vilka koder LimeSurvey tilldelar som nycklar för enkät, grupp, fråga och svar. Importera och exportera därför gärna så ofta du vill.

Här är några praktiska saker du kan göra med det här arbetssättet:

1. Använd samma svar för många frågor. Kopiera bara raderna med 'A' och klistra in dem efter varje fråga som ska ha samma uppsättning.
2. Använd samma delfrågor för många frågor. Kopiera bara raderna med 'SQ' och klistra in dem efter varje fråga som behöver dem.
3. "Loopar" - använd samma grupp många gånger. När gruppen ser ut som du vill, kopiera den så många gånger som behövs. Använd Excels filtrering för att bara visa raderna med 'G' (för grupper) och använd Excels dragfunktion för kolumner för att uppdatera relevansekvationerna för varje grupp (t.ex. för en folkräkning kan den första relevansen vara "numPeople > 1" och nästa "numPeople > 2". Dragfunktionen uppdaterar numret automatiskt). Filtrera på raderna med 'Q' och se till att varje fråga har ett unikt värde (t.ex. om du döper dina variabler till g1_q1, g1_q2, g1_qN, använd sök/ersätt för att ändra g1 till g2 för den andra gruppen, g3 för den tredje osv.).
4. Ändra ordning på frågor/grupper. Ändra helt enkelt ordningen på raderna i kalkylbladsfilen.
5. Testa enkätmoduler. För långa enkäter kan du vilja dela upp testningen i moduler. Skapa helt enkelt nya kalkylbladsfiler för varje modul och radera de rader du inte behöver. Då slipper du ange mycket data för att testa senare delar av enkäten.
6. Testa obligatoriska frågor. En vanlig klagomål är inte att många frågor behöver vara obligatoriska, utan att man behöver stänga av funktionen obligatorisk vid testning. Skapa huvudkalkylbladet med obligatorisk inställd på de slutliga värdena. För att testa det raderar du bara kolumnen "mandatory" och sparar testversionen av kalkylbladet. När du importerar den versionen är ingen av frågorna obligatorisk. När du är klar med testningen importerar du huvudkopian.
7. Ange standardvärden. I stället för att använda det grafiska gränssnittet kan du ange önskade standardvärden i kolumnen default. Det är särskilt användbart i fall där det grafiska gränssnittet inte låter dig ange det önskade värdet, som uttryck för att ange standardvärdet för listobjekt (t.ex. för att fylla en lista från ett attribut hos en enkätdeltagare).
8. Översättning. Du kan skapa kopior av ditt kalkylblad - en per språk. Ta med alla rader för huvudspråket, kopiera och klistra in dem nedanför, och använd dragfunktionen för att ändra språkfältet till målspråket. Dessa kan skickas till dina översättare och slås ihop till en enda kalkylbladsfil igen när de är klara.
9. Massinställning av avancerade frågeattribut. Du kanske vill att alla dina ekvationer ska vara synliga från början (så att du kan se deras värden medan du samlar in data), men sedan dölja dem alla innan enkäten tas i bruk. Filtrera helt enkelt kalkylbladet på class = 'Q' och frågetyp = '*' (ekvation), och ange always_hide till 1 för var och en av dessa frågor. På samma sätt, om du efter att ha skapat enkäten bestämmer vilka frågor som ska visas i publik statistik: i stället för att redigera varje fråga via det grafiska gränssnittet, filtrera på class = 'Q' och ange public_statistics = 1 för alla frågor som ska vara synliga i statistiken.
10. Sök och ersätt. Om du bestämmer dig för att ändra någon formulering i alla dina frågor kan du använda Excels sök och ersätt för att göra ändringarna. På samma sätt kan sök och ersätt komma till undsättning om du vill byta namn på många variabler på en gång. Om du behöver sök och ersätt baserat på reguljära uttryck kan du markera önskad kolumn, kopiera den till en textredigerare, göra din sökning och ersättning och klistra tillbaka kolumnen i kalkylbladet.
11. Få godkännanden. Om du bedriver forskning kan du ha en etikprövningsnämnd som kräver att få se frågornas text. Det här kan vara ett bekvämt sätt att dela den. Detsamma gäller vid diskussioner med en kund.
12. Teamets samsyn. Om du försöker få en grupp att enas om formuleringen eller utseendet på en fråga eller grupp kan du snabbt skapa en prototyp/redigera kalkylbladet, importera det och visa teamet (via förhandsvisning av fråga eller grupp) exakt vad användarna kommer att se. På så sätt kan du få teamets godkännande innan de lämnar rummet, i stället för att dokumentera krav, bygga dem och få godkännande vid framtida möten.
13. Uppgradera från andra enkätformat. Om din enkät finns i XML, Word eller något annat format kan du skapa en översättningsprocess för att mappa dem till det här formatet. Du kan visserligen också försöka mappa till .lss-formatet, men fördelen med det här formatet är att du slipper hålla reda på främmande nycklar mellan grupper, frågor, delfrågor, svar och standardvärden.

Begränsningar

1. Funktionen är avsiktligt utformad så att den bara fungerar korrekt för enkäter som använder qcode-namngivning (i stället för SGQA). Den förutsätter att variabelnamn (frågeidentifierare) är unika i hela enkäten. Delfrågenamn kan upprepas, så länge de är unika inom en viss frågas omfång.

Filformat

Allmänt

Vi använder samma uppsättning kolumnrubriker för flera ändamål. De första 14 kolumnerna har olika syften beroende på typen av entitet (t.ex. grupp, fråga, svar). De återstående kolumnerna är en alfabetisk lista över databasfältnamnen för de avancerade frågekoderna. Nedan visas syntaxen för varje entitetstyp

De första 14 kolumnerna är:

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: Kolumnerna id och related_id används bara för kvoter och är valfria. Om du inte har några kvoter kan du ta bort dessa två kolumner direkt.

Globala enkätparametrar

Det finns en rad per parameter i tabellen surveys.

1. class => 'S'
2. name => databasfältets namn
3. text => värde

Språkspecifika enkätparametrar

Det finns en rad per fält och språk i tabellen surveys_languagesettings. Alla poster för ett givet språk samlas ihop innan de infogas i den tabellen.

1. class => 'SL'
2. name => databasfältets namn
3. text => värde
4. language => språk

Grupper

En grupprad per enkätspråk (t.ex. skulle det finnas 3 grupprader om enkäten har 3 språk).

1. id => unik numerisk identifierare för gruppen, med start på nummer 1; använd samma ID för ytterligare språk som tillhör den aktuella gruppen
2. class => 'G'
3. name => group_name -- gruppens unika identifierare
4. relevance => grelevance -- relevansekvationen på gruppnivå, utan klammerparenteser
5. text => description -- gruppens språkspecifika beskrivning
6. language => language -- gruppens språk (t.ex. 'en')

Frågor

En frågerad per enkätspråk (t.ex. skulle det finnas 3 frågerader om enkäten har 3 språk). Frågor antas tillhöra den grupp som föregår dem.

1. id => unik numerisk identifierare för frågan, med start på nummer 1; använd samma ID för ytterligare språk som tillhör den aktuella frågan
2. class => 'Q'
3. type/scale => type -- den (oftast en bokstav långa) frågetypen (t.ex. är 'M' flervalsfråga)
4. name => title -- det unika frågenamnet (roten i namngivningssystemet för qcode)
5. relevance => relevance -- relevansekvationen för frågan
6. text => question -- frågans språkspecifika text
7. help => help -- den språkspecifika hjälptexten
8. language => language -- gruppens språk (t.ex. 'en')
9. validation => preg -- de valfria valideringskriterierna för frågan i form av ett reguljärt uttryck
10. mandatory => mandatory -- 'Y' om obligatorisk
11. other => other -- 'Y' om alternativet "Annat" ska vara tillgängligt (endast för vissa frågetyper)
12. default => default -- om angivet infogas detta värde i tabellen defaultvalues för den här frågan
13. same_default => same_default -- 'Y' för sant, och då gäller alla standardvärden som angetts för huvudspråket även för andra språk

Delfrågor

En delfrågerad per enkätspråk. Delfrågor antas tillhöra frågan som föregår dem.

1. id => samma unika numeriska identifierare som används för frågorna. Delfrågor ska använda nästa lediga värde, och fråge-ID och delfråge-ID ska vara olika (använd t.ex. ID 1 för frågan och ID 2, 3 och 4 för delfrågor som tillhör fråga 1, nästa fråge-ID ska då vara 5 och så vidare). Använd samma delfråge-ID för ytterligare språk som tillhör aktuella delfrågor.
2. class => 'SQ'
3. type/scale => scale_id -- 0 eller 1, beroende på frågetyp (t.ex. samling med text har två skalor)
4. name => title -- delfrågans "namn", t.ex. det som används för exclude_all_others
5. relevance => relevance -- (Framtida) för att stödja relevans på delfrågenivå
6. text => question -- delfrågans språkspecifika text
7. help => help -- (Framtida) för att stödja hjälptext på delfrågenivå
8. language => language -- språket för delfrågan
9. validation => preg -- (Framtida) för att stödja validering med reguljärt uttryck på delfrågenivå (t.ex. för adressdelar)
10. mandatory => mandatory -- (Framtida) för att stödja obligatoriska delfrågor (t.ex. för att göra endast några få delfrågor obligatoriska)
11. default => default -- om angivet är detta standardvärdet för delfrågan (infogas i tabellen defaultvalues)
12. same_default => same_default -- om angivet används standardvärdet för huvudspråket för alla andra språk

Svar

En svarsrad per enkätspråk (t.ex. skulle det finnas 3 svarsrader om enkäten har 3 språk). Svar antas tillhöra frågan som föregår dem och ligga i önskad sorteringsordning.

1. id => använd samma ID som ID för frågan som svaret tillhör
2. class => 'A'
3. type/scale => scale_id -- 0 eller 1 (t.ex. för dubbla skalor)
4. name => code -- den unika svarsidentifieraren
5. relevance => assessment_value -- om utvärderingsalternativet används är detta utvärderingsvärdet för svaret
6. text => answer -- svarets språkspecifika text
7. language => language -- språket för detta svar (t.ex. 'en')

Utvärderingar

En utvärderingsrad per enkätspråk (t.ex. skulle det finnas 3 utvärderingsrader om enkäten har 3 språk). Utvärderingar skrivs i slutet av filen.

1. id => unik numerisk identifierare för utvärderingen, med start på nummer 1, använd samma ID för ytterligare språk som tillhör aktuell utvärdering
2. related_id => ID för den grupp som aktuell utvärdering tillhör
3. class => 'AS'
4. type/scale => utvärderingens omfattning: T-Totalt, G-grupp
5. name => namn
6. text => meddelande
7. min_num_value => Minimum
8. max_num_value => Maximum
9. language => language -- språket för detta svar (t.ex. 'en')

Kvoter

En rad per kvot. Kvoter skrivs i slutet av filen.

1. id => unik numerisk identifierare för kvoten, med start på nummer 1
2. class => 'QTA'
3. name => kvotens namn
4. mandatory => gräns
5. other => kvotåtgärd
6. default => aktiv
7. same_default => länkadress att ladda automatiskt

Språkinställningar för kvot

En kvotrad per enkätspråk. Språkinställningar för kvot antas tillhöra kvoten som föregår dem.

1. id => unik numerisk identifierare för språkinställningarna för kvoten, med start på nummer 1. Varje rad för olika enkätspråk ska ha olika ID
2. related_id => ID för den kvot som denna inställning tillhör
3. class => 'QTALS'
4. relevance => meddelande
5. text => URL
6. help => länkbeskrivning
7. language => language -- språket för denna kvot (t.ex. 'en')

Kvotmedlemmar

En rad per kvotmedlem, inte språkberoende. Raden för kvotmedlemmen ska placeras direkt efter den fråga den hör till. Kvotmedlemmar antas tillhöra frågan som föregår dem.

1. id => unik numerisk identifierare för kvotmedlemmen, med start på nummer 1
2. related_id => ID för den kvot som denna medlem tillhör
3. class => 'QTAM'
4. name => svarskod

Villkor

En rad per villkor, inte språkberoende. Raden för villkoret ska placeras direkt efter den fråga det hör till. Villkor antas tillhöra frågan som föregår dem.

1. id => unik numerisk identifierare för villkoret, med start på nummer 1.
2. related_id => fråge-ID för den relaterade frågan, om tillämpligt
3. class => 'C'
4. type/scale => scenario
5. name => fältnamn för svar
6. relevance => jämförelseoperator
7. text => förväntat svar