Štruktúra prieskumu vo formáte hodnôt oddelených tabulátormi

Import a export štruktúry prieskumu vo formáte hodnôt oddelených tabulátormi

Táto funkcia uľahčuje používanie tabuľkového softvéru, ako je LibreOffice, Excel alebo Google Docs, na tvorbu a úpravu prieskumov. Úplne odstráni závislosť na kódoch SGQA.

Táto funkcia podporuje import súborov s hodnotami oddelenými tabulátormi (TSV) v kódovaní ASCII alebo UTF-8 s príponou .txt.

Pozrite si nasledujúci príklad, aby ste lepšie pochopili túto funkcionalitu.

Začíname

Najjednoduchší spôsob je vziať existujúci prieskum a exportovať ho vo formáte hodnôt oddelených tabulátormi. Použite bežné tlačidlo na export prieskumu a namiesto formátu .lss vyberte „Tab Separated Values format (*.txt)“. Prieskum sa uloží ako súbor s hodnotami oddelenými tabulátormi v správnom formáte (unicode súbor oddelený tabulátormi) so všetkými správnymi hlavičkami stĺpcov.

Vyhovuje akýkoľvek tabuľkový softvér, ktorý podporuje hodnoty oddelené tabulátormi (napr. OpenOffice alebo LibreOffice). LimeSurvey ignoruje všetko formátovanie v tabuľke, ale pokojne ho pridajte, ak vám pomáha.

Upozornenie: exportovaný súbor je vo formáte UTF-8 so značkou poradia bajtov (BOM) ako prvými tromi (skrytými) znakmi. Ak dvojitým kliknutím na súbor .txt skúsite otvoriť priamo v Exceli, neotvorí sa správne, pretože Excel nerozpozná, že ide o formát UTF-8. Ak chcete tieto súbory otvoriť v Exceli, najprv spustite Excel, potom vyberte Súbor:Otvoriť, vyberte súbor .txt a nastavte v Exceli kódovanie UTF-8.

Pre každú skupinu, otázku, podotázku a odpoveď bude existovať jeden riadok. Existujú aj riadky pre globálne premenné prieskumu a pre premenné prieskumu špecifické pre daný jazyk. Primárny jazyk bude uvedený ako prvý, po ňom nasledujú všetky sekundárne jazyky. Ak teda existuje viac jazykov, najprv sa zobrazí celý obsah základného jazyka (napr. všetky skupiny, otázky, podotázky a odpovede). Potom nasleduje preložená kópia pre každý sekundárny jazyk (s presne rovnakým počtom a poradím riadkov pre preloženú sadu).

Vzťahy sa odvodzujú podľa blízkosti. Otázky nasledujúce po skupine teda patria do tejto skupiny; podotázky nasledujúce po otázke patria k tejto otázke a odpovede nasledujúce po otázke patria k tejto otázke. Preto nemusíte poznať ID (gid, qid, sqid) žiadnej otázky. Tie sa vypočítajú automaticky pri importe. Tento formát v skutočnosti vôbec nepoužíva gid, qid ani sqid (ani kódy SGQA).

Tipy

Cieľom importu/exportu hodnôt oddelených tabulátormi je umožniť vám rýchlo navrhnúť prieskum pomocou tabuľky. Očakávame, že tabuľku budete často importovať, overovať jej platnosť pomocou funkcie „Zobraziť logiku prieskumu“ a testovať ju. Pri každom importe získate nový prieskum. Môže sa teda stať, že budete mať veľa čiastočne vytvorených prieskumov, ale to je v poriadku. Len si zvyknite sledovať, ktorý je najnovší, alebo po importe nových odstráňte starý. Keďže vo formáte hodnôt oddelených tabulátormi nikdy nepoužívate kódy SGQA, nemusíte sa starať o to, aké kódy LimeSurvey priraďuje primárnym kľúčom prieskumu, skupiny, otázky a odpovede. Importujte a exportujte teda tak často, ako chcete.

Tu je niekoľko praktických vecí, ktoré môžete s týmto prístupom k tvorbe nástrojov robiť:

1. Použitie rovnakých odpovedí pre viacero otázok. Stačí skopírovať riadky „A“ a vložiť ich za každú otázku, ktorá má mať rovnakú sadu.
2. Použitie rovnakých podotázok pre viacero otázok. Stačí skopírovať riadky „SQ“ a vložiť ich za každú otázku, ktorá ich potrebuje.
3. „Cyklenie“ – opakované použitie tej istej skupiny. Keď má skupina požadovanú podobu, skopírujte ju toľkokrát, koľkokrát je potrebné. Pomocou filtrovania v Exceli zobrazte iba riadky „G“ (skupiny) a pomocou funkcie ťahania stĺpca v Exceli aktualizujte rovnice relevantnosti pre každú skupinu (napr. pri sčítaní ľudu môže byť prvá relevantnosť „numPeople > 1“, ďalšia „numPeople > 2“. Funkcia ťahania číslo automaticky aktualizuje). Vyfiltrujte riadky „Q“ a uistite sa, že každá otázka má jedinečnú hodnotu (napr. ak premenné pomenujete g1_q1, g1_q2, g1_qN, použite nájdi/nahraď na zmenu g1 na g2 pre druhú skupinu; g3 pre tretiu atď.).
4. Zmena poradia otázok/skupín. Jednoducho zmeňte poradie riadkov v tabuľkovom súbore.
5. Testovanie modulov prieskumu. Pri dlhých prieskumoch možno budete chcieť rozdeliť testovanie na moduly. Jednoducho vytvorte nové tabuľkové súbory pre každý modul a odstráňte všetky riadky, ktoré nepotrebujete. Tým sa vyhnete nutnosti zadávať veľa údajov pri testovaní neskorších častí prieskumu.
6. Testovanie povinných otázok. Častou sťažnosťou nie je potreba nastaviť veľa otázok ako povinné, ale potreba vypnúť povinnosť pri testovaní. Jednoducho vytvorte hlavnú tabuľku s hodnotami povinnosti nastavenými na konečné požadované hodnoty. Potom na otestovanie stačí odstrániť stĺpec „mandatory“ a uložiť testovaciu verziu tabuľky. Keď túto verziu importujete, žiadna z otázok nebude povinná. Po dokončení testovania importujte hlavnú kópiu.
7. Nastavenie predvolených hodnôt. Namiesto používania grafického rozhrania môžete požadované predvolené hodnoty zadať do stĺpca default. Je to užitočné najmä v prípadoch, keď grafické rozhranie nedovoľuje zadať požadovanú hodnotu, napríklad výrazy na nastavenie predvolenej hodnoty pre položky zoznamu (napríklad naplnenie zoznamu z atribútu respondenta prieskumu).
8. Preklad. Môžete vytvoriť kópie tabuľky – jednu pre každý jazyk. Zahrňte všetky riadky pre primárny jazyk, potom ich skopírujte a vložte pod seba a pomocou ťahania zmeňte pole jazyka na cieľový jazyk. Tieto súbory môžete rozdistribuovať prekladateľom a po dokončení ich znova zlúčiť do jedného tabuľkového súboru.
9. Hromadné nastavenie pokročilých atribútov otázok. Možno budete chcieť, aby všetky rovnice boli na začiatku viditeľné (aby ste videli ich hodnoty pri zbere údajov), ale pred nasadením do ostrej prevádzky ich všetky skryť. Jednoducho vyfiltrujte tabuľku podľa class = 'Q' a typ otázky = '*' (rovnica) a pre každú z týchto otázok nastavte always_hide na 1. Podobne, povedzme, že po vytvorení prieskumu sa rozhodnete, ktoré otázky sa majú zobrazovať vo verejných štatistikách. Namiesto úpravy každej otázky cez grafické rozhranie vyfiltrujte class = 'Q' a nastavte public_statistics = 1 pre všetky otázky, ktoré majú byť viditeľné v štatistikách.
10. Nájdi a nahraď. Povedzme, že sa rozhodnete zmeniť formuláciu vo všetkých otázkach – na tieto zmeny môžete použiť funkciu nájsť a nahradiť v Exceli. Podobne, ak sa rozhodnete hromadne premenovať premenné, môže pomôcť nájdi a nahraď. Ak potrebujete hľadanie a nahradzovanie založené na regulárnych výrazoch, môžete vybrať požadovaný stĺpec, skopírovať ho do textového editora, vykonať nájdi a nahraď a stĺpec vložiť späť do tabuľky.
11. Získavanie schválení. Ak robíte výskum, možno máte etickú komisiu, ktorá trvá na tom, že chce vidieť text otázok. Toto môže byť pohodlný spôsob, ako ho zdieľať. Podobne pri diskusiách s klientom.
12. Konsenzus tímu. Ak sa snažíte, aby sa skupina zhodla na formulácii alebo vzhľade otázky či skupiny, môžete rýchlo vytvoriť prototyp/upraviť tabuľku, importovať ju a ukázať tímu (cez náhľad otázky alebo skupiny) presne to, čo uvidia používatelia. Tak môžete získať schválenie tímu ešte pred odchodom z miestnosti, namiesto dokumentovania požiadaviek, ich implementácie a získavania schválenia na budúcich stretnutiach.
13. Prechod z iných formátov prieskumov. Ak je váš prieskum vo formáte XML, Word alebo inom, môžete vytvoriť proces prekladu na namapovanie do tohto formátu. Hoci by ste mohli skúsiť aj mapovanie do formátu .lss, výhodou tohto formátu je, že nevyžaduje sledovanie vzťahov cudzích kľúčov medzi skupinami, otázkami, podotázkami, odpoveďami a predvolenými hodnotami.

Obmedzenia

1. Z dôvodu návrhu táto funkcia správne funguje iba pre prieskumy, ktoré používajú pomenovanie qcode (nie SGQA). Táto funkcia predpokladá, že názvy premenných (identifikátory otázok) sú v rámci celého prieskumu jedinečné. Názvy podotázok sa môžu opakovať, ak sú jedinečné v rámci konkrétnej otázky.

Formát súboru

Všeobecne

Rovnakú sadu hlavičiek stĺpcov používame na viacero účelov. Prvých 14 stĺpcov slúži na rôzne účely v závislosti od typu entity (napr. skupina, otázka, odpoveď). Zvyšné stĺpce sú abecedný zoznam názvov databázových polí pre pokročilé kódy otázok. Nižšie je syntax pre každý typ entity

Prvých 14 stĺpcov je:

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: Stĺpce id a related_id sa používajú iba pre kvóty a sú voliteľné. Ak nemáte kvóty, môžete tieto 2 stĺpce priamo odstrániť.

Globálne parametre prieskumu

Pre každý parameter v tabuľke surveys existuje jeden riadok.

1. class => 'S'
2. name => názov databázového poľa
3. text => hodnota

Parametre prieskumu špecifické pre jazyk

Pre každé pole a každý jazyk v tabuľke surveys_languagesettings existuje jeden riadok. Všetky záznamy pre daný jazyk sa zhromažďujú pred vložením do tejto tabuľky.

1. class => 'SL'
2. name => názov databázového poľa
3. text => hodnota
4. language => jazyk

Skupiny

Jeden riadok skupiny na každý jazyk prieskumu (napr. ak má prieskum 3 jazyky, budú 3 riadky skupiny).

1. id => jedinečný číselný identifikátor skupiny, začínajúci číslom 1, pre ďalšie jazyky patriace k aktuálnej skupine použite rovnaké ID
2. class => 'G'
3. name => group_name -- jedinečný identifikátor skupiny
4. relevance => grelevance -- rovnica relevantnosti na úrovni skupiny, bez zložených zátvoriek
5. text => description -- popis skupiny špecifický pre jazyk
6. language => language -- jazyk skupiny (napr. 'en')

Otázky

Jeden riadok otázky na každý jazyk prieskumu (napr. ak má prieskum 3 jazyky, budú 3 riadky otázky). Predpokladá sa, že otázky patria do skupiny, ktorá im predchádza.

1. id => jedinečný číselný identifikátor otázky, začínajúci číslom 1, pre ďalšie jazyky patriace k aktuálnej otázke použite rovnaké ID
2. class => 'Q'
3. type/scale => type -- (zvyčajne jednopísmenový) typ otázky (napr. 'M' je Možnosť výberu viacerých možností)
4. name => title -- jedinečný názov otázky (základ systému pomenovania qcode)
5. relevance => relevance -- rovnica relevantnosti pre otázku
6. text => question -- text otázky špecifický pre jazyk
7. help => help -- pomocný text špecifický pre jazyk
8. language => language -- jazyk skupiny (napr. 'en')
9. validation => preg -- voliteľné kritériá validácie regulárnym výrazom pre otázku
10. mandatory => mandatory -- 'Y' ak je povinná
11. other => other -- 'Y' ak má byť k dispozícii možnosť „Iné“ (iba pre niektoré typy otázok)
12. default => default -- ak je nastavené, táto hodnota sa vloží do tabuľky defaultvalues pre túto otázku
13. same_default => same_default -- 'Y' pre áno, v tom prípade sa každá predvolená hodnota nastavená pre primárny jazyk použije aj pre ostatné jazyky

Podotázky

Jeden riadok podotázky na každý jazyk prieskumu. Predpokladá sa, že podotázky patria k otázke, ktorá im predchádza.

1. id => rovnaký jedinečný číselný identifikátor, ktorý sa používa pre otázky. Podotázky by mali používať ďalšiu dostupnú hodnotu, ID otázky a podotázky by sa mali líšiť (napr. použite ID 1 pre otázku a ID 2, 3 a 4 pre podotázky patriace k otázke 1, ID ďalšej otázky by malo byť 5 atď.). Pre ďalšie jazyky patriace k aktuálnej podotázke použite rovnaké ID podotázky.
2. class => 'SQ'
3. type/scale => scale_id -- 0 alebo 1, v závislosti od typu otázky (napr. textové pole bude mať dve škály)
4. name => title -- „meno“ podotázky, napr. to, ktoré sa používa pre exclude_all_others
5. relevance => relevance -- (v budúcnosti) na podporu relevantnosti na úrovni podotázky
6. text => question -- text podotázky špecifický pre jazyk
7. help => help -- (v budúcnosti) na podporu pomocníka na úrovni podotázky
8. language => language -- jazyk podotázky
9. validation => preg -- (v budúcnosti) na podporu validácie pomocou regulárneho výrazu na úrovni podotázky (napr. pre časti adresy)
10. mandatory => mandatory -- (v budúcnosti) na podporu povinnosti na úrovni podotázky (napr. aby boli povinné iba niektoré podotázky)
11. default => default -- ak je nastavené, ide o predvolenú hodnotu podotázky (vkladá sa do tabuľky defaultvalues)
12. same_default => same_default -- ak je nastavené, predvolená hodnota pre primárny jazyk sa použije pre všetky ostatné jazyky

Odpovede

Jeden riadok odpovede na každý jazyk prieskumu (napr. ak má prieskum 3 jazyky, budú 3 riadky odpovede). Predpokladá sa, že odpovede patria k otázke, ktorá im predchádza, a že sú v požadovanom poradí.

1. id => použite rovnaké ID ako má otázka, ku ktorej odpoveď patrí
2. class => 'A'
3. type/scale => scale_id -- 0 alebo 1 (napr. pri otázke s dvoma škálami)
4. name => code -- jedinečný identifikátor odpovede
5. relevance => assessment_value -- ak používate možnosť hodnotenia, ide o hodnotu hodnotenia odpovede
6. text => answer -- text odpovede špecifický pre jazyk
7. language => language -- jazyk tejto odpovede (napr. 'en')

Hodnotenia

Jeden riadok hodnotenia na každý jazyk prieskumu (napr. ak má prieskum 3 jazyky, budú 3 riadky hodnotenia). Hodnotenia sa zapisujú na koniec súboru.

1. id => jedinečný číselný identifikátor hodnotenia, začínajúci číslom 1, pre ďalšie jazyky patriace k aktuálnemu hodnoteniu použite rovnaké ID
2. related_id => ID skupiny, ku ktorej aktuálne hodnotenie patrí
3. class => 'AS'
4. type/scale => rozsah hodnotenia: T-celkové, G-skupina
5. name => name
6. text => message
7. min_num_value => Minimum
8. max_num_value => Maximum
9. language => language -- jazyk tejto odpovede (napr. 'en')

Kvóty

Jeden riadok na každú kvótu. Kvóty sa zapisujú na koniec súboru.

1. id => jedinečný číselný identifikátor kvóty, začínajúci číslom 1
2. class => 'QTA'
3. name => názov kvóty
4. mandatory => limit
5. other => akcia kvóty
6. default => aktívna
7. same_default => autonačítanie URL

Jazykové nastavenia kvót

Jeden riadok kvóty na každý jazyk prieskumu. Predpokladá sa, že jazykové nastavenia kvóty patria ku kvóte, ktorá im predchádza.

1. id => jedinečný číselný identifikátor jazykových nastavení kvóty, začínajúci číslom 1. Každý riadok pre iný jazyk prieskumu by mal mať iné ID
2. related_id => ID kvóty, ku ktorej toto nastavenie patrí
3. class => 'QTALS'
4. relevance => message
5. text => URL
6. help => popis URL
7. language => language -- jazyk tejto kvóty (napr. 'en')

Členovia kvóty

Jeden riadok na každého člena kvóty, nezávisle od jazyka. Riadok člena kvóty by mal byť umiestnený bezprostredne za otázkou, s ktorou súvisí. Predpokladá sa, že členovia kvóty patria k otázke, ktorá im predchádza.

1. id => jedinečný číselný identifikátor člena kvóty, začínajúci číslom 1
2. related_id => ID kvóty, ku ktorej tento člen patrí
3. class => 'QTAM'
4. name => kód odpovede

Podmienky

Jeden riadok na každú podmienku, nezávisle od jazyka. Riadok podmienky by mal byť umiestnený bezprostredne za otázkou, s ktorou súvisí. Predpokladá sa, že podmienky patria k otázke, ktorá im predchádza.

1. id => jedinečný číselný identifikátor podmienky, začínajúci číslom 1.
2. related_id => ID súvisiacej otázky, ak je relevantné
3. class => 'C'
4. type/scale => scenár
5. name => názov poľa odpovede
6. relevance => operátor porovnania
7. text => očakávaná odpoveď