Struktura upitnika u formatu vrijednosti odvojenih tabulatorom

Uvoz i izvoz strukture upitnika u formatu vrijednosti odvojenih tabulatorom

Ova je značajka osmišljena kako bi olakšala korištenje softvera za proračunske tablice, poput LibreOfficea, Excela ili Google Docsa, za izradu i uređivanje upitnika. Ovo u potpunosti eliminira ovisnost o SGQA kôdovima.

Ova značajka podržava uvoz iz datoteka s vrijednostima odvojenim tabulatorom (TSV) kodiranih u ASCII ili UTF-8 formatu, s ekstenzijom .txt.

Pogledajte sljedeći primjer kako biste bolje razumjeli ovu funkcionalnost.

Početak rada

Najjednostavniji način je uzeti postojeći upitnik i izvesti ga u formatu vrijednosti odvojenih tabulatorom. Koristite uobičajeni gumb za izvoz upitnika te umjesto formata .lss odaberite „Tab Separated Values format (*.txt)”. Upitnik će biti spremljen kao datoteka s vrijednostima odvojenim tabulatorom u ispravnom formatu (unicode datoteka odvojena tabulatorima), sa svim ispravnim naslovima stupaca.

Prikladan je bilo koji softver za proračunske tablice koji podržava vrijednosti odvojene tabulatorom (npr. OpenOffice ili LibreOffice). LimeSurvey zanemaruje sva oblikovanja unutar proračunske tablice, ali slobodno ih dodajte ako vam pomažu.

Imajte na umu da je izvezena datoteka u UTF-8 formatu s oznakom redoslijeda bajtova (BOM) kao prva tri (skrivena) znaka. Ako dvaput kliknete na .txt datoteku i pokušate je izravno otvoriti u Excelu, neće se ispravno otvoriti jer Excel ne prepoznaje da je u UTF-8 formatu. Za otvaranje ovih datoteka u Excelu najprije otvorite Excel, zatim odaberite File:Open, odaberite .txt datoteku i recite Excelu da koristi UTF-8 kodiranje.

Postojat će jedan redak za svaku grupu, pitanje, potpitanje i odgovor. Također postoje retci za globalne varijable upitnika i za varijable upitnika specifične za jezik. Prvo će biti naveden osnovni jezik, a zatim svi dodatni jezici. Dakle, ako postoji više jezika, cijeli sadržaj osnovnog jezika pojavit će se prvi (npr. sve grupe, pitanja, potpitanja i odgovori). Nakon toga slijedi prevedena kopija za svaki dodatni jezik (s potpuno istim brojem i redoslijedom redaka za prevedeni skup).

Odnosi se zaključuju prema blizini. Dakle, pitanja koja slijede nakon grupe dio su te grupe; potpitanja koja slijede nakon pitanja dio su tog pitanja, a odgovori koji slijede nakon pitanja dio su tog pitanja. Stoga ne morate znati ID-ove (gid, qid, sqid) ni za jedno pitanje. Oni će se automatski izračunati prilikom uvoza. Zapravo, ovaj format uopće ne koristi gid, qid ili sqid (niti SGQA kôdove).

Savjeti

Cilj uvoza/izvoza u formatu vrijednosti odvojenih tabulatorom je da vam omogući brzo osmišljavanje upitnika pomoću proračunske tablice. Očekujemo da ćete često uvoziti tablicu, provjeravati njezinu ispravnost pomoću značajke „Prikaži logiku upitnika” i testirati je. Svaki put kad je uvezete, dobit ćete novi upitnik. Tako možete završiti s mnogo djelomično razvijenih upitnika, ali to je u redu. Samo steknite naviku pratiti koji je najnoviji ili izbrišite stari nakon što uvezete novi. Budući da u formatu vrijednosti odvojenih tabulatorom nikada ne koristite SGQA kôdove, ne trebate brinuti koje kôdove LimeSurvey dodjeljuje primarnim ključevima upitnika, grupe, pitanja i odgovora. Stoga slobodno uvozite i izvozite koliko god često želite.

Evo nekoliko praktičnih stvari koje možete učiniti ovim pristupom izradi instrumenata:

1. Koristite iste odgovore za mnoga pitanja. Samo kopirajte retke 'A' i zalijepite ih nakon svakog pitanja koje treba imati isti skup.
2. Koristite ista potpitanja za mnoga pitanja. Samo kopirajte retke 'SQ' i zalijepite ih nakon svakog pitanja kojem su potrebni.
3. „Petlje” - koristite istu grupu više puta. Nakon što grupu uredite kako želite, kopirajte je onoliko puta koliko je potrebno. Koristite Excelovo filtriranje za prikaz samo redaka 'G' (za grupe) i koristite Excelovu značajku povlačenja stupca za ažuriranje jednadžbi relevantnosti za svaku grupu (npr. za popis stanovništva prva relevantnost može biti "numPeople > 1", sljedeća bi trebala biti "numPeople > 2". Značajka povlačenja automatski će ažurirati broj). Filtrirajte po recima 'Q' i osigurajte da svako pitanje ima jedinstvenu vrijednost (npr. ako varijable nazovete g1_q1, g1_q2, g1_qN, upotrijebite pronađi/zamijeni za pretvaranje g1 u g2 za drugu grupu; g3 za treću itd.).
4. Promjena redoslijeda pitanja/grupa. Jednostavno promijenite redoslijed redaka u datoteci proračunske tablice.
5. Testiranje modula upitnika. Za duge upitnike možda ćete htjeti podijeliti testiranje na module. Jednostavno izradite nove datoteke proračunskih tablica za svaki modul, brišući sve retke koji vam nisu potrebni. Time izbjegavate potrebu za unosom velike količine podataka kako biste testirali kasnije dijelove upitnika.
6. Testiranje obaveznih pitanja. Česta primjedba nije potreba da se mnoga pitanja učine obaveznima, nego potreba da se obavezno isključi radi testiranja. Jednostavno izradite glavnu proračunsku tablicu s obaveznim postavljenim na konačne željene vrijednosti. Zatim, za testiranje, samo izbrišite stupac „mandatory” i spremite testnu verziju proračunske tablice. Kad uvezete tu verziju, nijedno pitanje neće biti obavezno. Nakon što završite testiranje, uvezite glavnu kopiju.
7. Postavljanje zadanih vrijednosti. Umjesto korištenja grafičkog sučelja, možete unijeti sve željene zadane vrijednosti u stupac default. To je posebno korisno u slučajevima kada vam grafičko sučelje ne dopušta unos željene vrijednosti, poput izraza za postavljanje zadane vrijednosti stavki popisa (npr. popunjavanje popisa iz atributa ispitanika upitnika).
8. Prijevod. Možete izraditi kopije svoje proračunske tablice - po jednu za svaki jezik. Uključite sve retke za osnovni jezik, zatim ih kopirajte i zalijepite ispod te povlačenjem promijenite polje jezika u ciljni jezik. Njih možete distribuirati prevoditeljima i ponovno ih integrirati u jednu datoteku proračunske tablice kad završe.
9. Skupno postavljanje naprednih atributa pitanja. Možda želite da sve vaše jednadžbe na početku budu vidljive (kako biste mogli vidjeti njihove vrijednosti dok prikupljate podatke), a zatim ih sve sakriti prije puštanja u produkciju. Jednostavno filtrirajte proračunsku tablicu po class = 'Q' i vrsta pitanja = '*' (jednadžba) te postavite always_hide na 1 za svako od tih pitanja. Slično tome, recimo da nakon izrade upitnika odlučite koja bi se pitanja trebala pojaviti u javnim statistikama. Umjesto da svako pitanje uređujete putem grafičkog sučelja, filtrirajte po class = 'Q' i postavite public_statistics = 1 za sva pitanja koja bi trebala biti vidljiva u statistici.
10. Pronađi i zamijeni. Recimo da odlučite promijeniti neku formulaciju u svim pitanjima; možete koristiti Excelovo pronađi i zamijeni za te promjene. Slično tome, ako odlučite skupno preimenovati varijable, pronađi i zamijeni može pomoći. Ako vam je potrebno pronalaženje i zamjena temeljeno na regularnim izrazima, možete odabrati željeni stupac, kopirati ga u uređivač teksta, obaviti pronalaženje i zamjenu te zalijepiti stupac natrag u proračunsku tablicu.
11. Dobivanje odobrenja. Ako provodite istraživanje, možda imate etičko povjerenstvo koje inzistira na uvidu u tekst pitanja. Ovo može biti prikladan način za njegovo dijeljenje. Slično vrijedi i za razgovore s klijentom.
12. Konsenzus tima. Ako pokušavate postići da se skupina složi oko formulacije ili izgleda pitanja ili grupe, možete brzo izraditi prototip / urediti proračunsku tablicu, uvesti je i timu pokazati (putem pregleda pitanja ili grupe) točno što će korisnici vidjeti. Na taj način možete dobiti odobrenje tima prije nego što napuste prostoriju, umjesto da morate dokumentirati zahtjeve, izraditi ih i dobiti odobrenje na budućim sastancima.
13. Nadogradnja iz drugih formata upitnika. Ako je vaš upitnik u XML-u, Wordu ili drugom formatu, možete izraditi proces prevođenja kojim ćete ih preslikati u ovaj format. Iako biste mogli pokušati i preslikavanje u format .lss, prednost ovog formata je što ne zahtijeva praćenje odnosa stranih ključeva između grupa, pitanja, potpitanja, odgovora i zadanih vrijednosti.

Ograničenja

1. Po dizajnu, ova značajka ispravno radi samo za upitnike koji koriste imenovanje qcode (a ne SGQA). Ova značajka pretpostavlja da su nazivi varijabli (identifikatori pitanja) jedinstveni u cijelom upitniku. Nazivi potpitanja mogu se ponavljati, sve dok su jedinstveni unutar opsega pojedinog pitanja.

Format datoteke

Općenito

Isti skup naslova stupaca koristimo u više svrha. Prvih 14 stupaca služi različitim svrhama ovisno o vrsti entiteta (npr. grupa, pitanje, odgovor). Preostali stupci abecedni su popis naziva polja baze podataka za napredne kodove pitanja. U nastavku je sintaksa za svaku vrstu entiteta

Prvih 14 stupaca su:

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: Stupci id i related_id koriste se samo za kvote i neobavezni su. Ako nemate kvote, ova 2 stupca možete izravno ukloniti.

Globalni parametri upitnika

Postoji jedan redak po parametru u tablici surveys.

1. class => 'S'
2. name => naziv polja baze podataka
3. text => vrijednost

Parametri upitnika specifični za jezik

Postoji jedan redak po polju po jeziku u tablici surveys_languagesettings. Svi unosi za pojedini jezik prikupljaju se prije umetanja u tu tablicu.

1. class => 'SL'
2. name => naziv polja baze podataka
3. text => vrijednost
4. language => jezik

Grupe

Jedan redak grupe po jeziku upitnika (npr. bit će 3 retka grupe ako upitnik ima 3 jezika).

1. id => jedinstveni numerički identifikator grupe, počevši od broja 1; koristite isti ID za dodatne jezike koji pripadaju trenutnoj grupi
2. class => 'G'
3. name => group_name -- jedinstveni identifikator grupe
4. relevance => grelevance -- jednadžba relevantnosti na razini grupe, bez vitičastih zagrada
5. text => description -- opis grupe specifičan za jezik
6. language => language -- jezik grupe (npr. 'en')

Pitanja

Jedan redak pitanja po jeziku upitnika (npr. bit će 3 retka pitanja ako upitnik ima 3 jezika). Pretpostavlja se da pitanja pripadaju grupi koja im prethodi.

1. id => jedinstveni numerički identifikator pitanja, počevši od broja 1; koristite isti ID za dodatne jezike koji pripadaju trenutnom pitanju
2. class => 'Q'
3. type/scale => type -- (obično jednoslovna) vrsta pitanja (npr. 'M' je višestruki izbor)
4. name => title -- jedinstveni naziv pitanja (korijen sustava imenovanja qcode)
5. relevance => relevance -- jednadžba relevantnosti za pitanje
6. text => question -- tekst pitanja specifičan za jezik
7. help => help -- tekst pomoći specifičan za jezik
8. language => language -- jezik grupe (npr. 'en')
9. validation => preg -- neobavezni kriterij provjere pitanja regularnim izrazom
10. mandatory => mandatory -- 'Y' ako je obavezno
11. other => other -- 'Y' ako opcija „Ostalo” treba biti dostupna (samo za neke vrste pitanja)
12. default => default -- ako je postavljeno, ova se vrijednost umeće u tablicu defaultvalues za ovo pitanje
13. same_default => same_default -- 'Y' za istinito, u kojem slučaju se svaka zadana vrijednost postavljena za osnovni jezik primjenjuje na ostale jezike

Potpitanja

Jedan redak potpitanja po jeziku upitnika. Pretpostavlja se da potpitanja pripadaju pitanju koje im prethodi.

1. id => isti jedinstveni numerički identifikator koji se koristi za pitanja. Potpitanja trebaju koristiti sljedeću dostupnu vrijednost, a ID-jevi pitanja i potpitanja moraju biti različiti (npr. koristite ID 1 za pitanje, a ID-jeve 2, 3 i 4 za potpitanja koja pripadaju pitanju 1, ID sljedećeg pitanja trebao bi biti 5 i tako dalje). Koristite isti ID potpitanja za dodatne jezike koji pripadaju trenutnom potpitanju.
2. class => 'SQ'
3. type/scale => scale_id -- 0 ili 1, ovisno o vrsti pitanja (npr. tekstualni niz imat će dvije skale)
4. name => title -- "ime" potpitanja, npr. ono koje se koristi za exclude_all_others
5. relevance => relevance -- (Budućnost) za podršku relevantnosti na razini potpitanja
6. text => question -- tekst potpitanja specifičan za jezik
7. help => help -- (Budućnost) za podršku pomoći na razini potpitanja
8. language => language -- jezik potpitanja
9. validation => preg -- (Budućnost) za podršku provjere regularnim izrazom na razini potpitanja (npr. za dijelove adrese)
10. mandatory => mandatory -- (Budućnost) za podršku obaveznosti na razini potpitanja (npr. da samo nekoliko potpitanja bude obavezno)
11. default => default -- ako je postavljeno, ovo je zadana vrijednost potpitanja (upisuje se u tablicu defaultvalues)
12. same_default => same_default -- ako je postavljeno, zadana vrijednost za primarni jezik koristi se za sve ostale jezike

Odgovori

Jedan redak odgovora po jeziku upitnika (npr. bila bi 3 retka odgovora ako upitnik ima 3 jezika). Pretpostavlja se da odgovori pripadaju pitanju koje im prethodi i da su u željenom redoslijedu sortiranja.

1. id => koristite isti ID kao ID pitanja kojem odgovor pripada
2. class => 'A'
3. type/scale => scale_id -- 0 ili 1 (npr. za dvostruku skalu)
4. name => code -- jedinstveni identifikator odgovora
5. relevance => assessment_value -- ako se koristi opcija procjene, ovo je vrijednost procjene za odgovor
6. text => answer -- tekst odgovora specifičan za jezik
7. language => language -- jezik ovog odgovora (npr. 'en')

Procjene

Jedan redak procjene po jeziku upitnika (npr. bila bi 3 retka procjene ako upitnik ima 3 jezika). Procjene se zapisuju na kraju datoteke.

1. id => jedinstveni numerički identifikator procjene, počevši od broja 1, koristite isti ID za dodatne jezike koji pripadaju trenutnoj procjeni
2. related_id => ID grupe kojoj trenutna procjena pripada
3. class => 'AS'
4. type/scale => opseg procjene: T-Ukupno, G-grupa
5. name => name
6. text => message
7. min_num_value => Minimum
8. max_num_value => Maksimum
9. language => language -- jezik ovog odgovora (npr. 'en')

Kvote

Jedan redak po kvoti. Kvote se zapisuju na kraju datoteke.

1. id => jedinstveni numerički identifikator kvote, počevši od broja 1
2. class => 'QTA'
3. name => naziv kvote
4. mandatory => limit
5. other => akcija kvote
6. default => aktivna
7. same_default => URL za samoučitavanje

Postavke jezika za kvotu

Jedan redak kvote po jeziku upitnika. Pretpostavlja se da postavke jezika za kvotu pripadaju kvoti koja im prethodi.

1. id => jedinstveni numerički identifikator postavki jezika za kvotu, počevši od broja 1. Svaki redak za različite jezike upitnika treba imati različit ID
2. related_id => ID kvote kojoj ove postavke pripadaju
3. class => 'QTALS'
4. relevance => poruka
5. text => URL
6. help => opis URL-a
7. language => language -- jezik ove kvote (npr. 'en')

Članovi kvote

Jedan redak po članu kvote, neovisno o jeziku. Redak člana kvote treba postaviti odmah nakon pitanja na koje se odnosi. Pretpostavlja se da članovi kvote pripadaju pitanju koje im prethodi.

1. id => jedinstveni numerički identifikator članova kvote, počevši od broja 1
2. related_id => ID kvote kojoj ovaj član pripada
3. class => 'QTAM'
4. name => kôd odgovora

Uvjeti

Jedan redak po uvjetu, neovisno o jeziku. Redak uvjeta treba postaviti odmah nakon pitanja na koje se odnosi. Pretpostavlja se da uvjeti pripadaju pitanju koje im prethodi.

1. id => jedinstveni numerički identifikator uvjeta, počevši od broja 1.
2. related_id => ID povezanog pitanja, ako je primjenjivo
3. class => 'C'
4. type/scale => scenarij
5. name => naziv polja odgovora
6. relevance => operator usporedbe
7. text => očekivani odgovor