Istraktura ng survey sa Tab Separated Value

Pag-import at Pag-export ng Istraktura ng Survey sa Tab Separated Value

Ang feature na ito ay idinisenyo upang gawing madali ang paggamit ng spreadsheet software tulad ng LibreOffice, Excel o Google Docs sa paggawa at pag-edit ng mga survey. Ganap nitong inaalis ang pagdepende sa mga SGQA code.

Sinusuportahan ng feature na ito ang pag-import mula sa mga file na Tab Separated Value (TSV) na naka-encode sa ASCII o UTF-8 at may extension na .txt.

Tingnan ang sumusunod na halimbawa upang mas maunawaan ang functionality na ito.

Pagsisimula

Ang pinakamadaling paraan ay kumuha ng umiiral na survey at i-export ito sa format na Tab Separated Value. Gamitin ang karaniwang button na Iluwas ang pagsisiyasat, at sa halip na piliin ang format na .lss, piliin ang "Tab Separated Values format (*.txt)". Ise-save ito bilang Tab Separated Value file sa tamang format (tab delimited unicode file), kasama ang lahat ng tamang heading ng column.

Maaaring gamitin ang anumang spreadsheet software na sumusuporta sa tab separated values (hal., OpenOffice o LibreOffice). Binabalewala ng LimeSurvey ang anumang formatting sa loob ng spreadsheet, ngunit malaya kang magdagdag nito kung makakatulong ito sa iyo.

Tandaan na ang na-export na file ay nasa UTF-8 format na may Byte Order Mark (BOM) bilang unang tatlong (nakatagong) karakter. Kung magda-double click ka sa .txt at susubukang buksan ito nang direkta gamit ang Excel, hindi ito magbubukas nang maayos dahil hindi alam ng Excel na naka-format ito sa UTF-8. Upang buksan ang mga file na ito gamit ang Excel, buksan muna ang Excel, pagkatapos piliin ang File:Open, piliin ang .txt file, at sabihin sa Excel na UTF-8 encoding ang gamit nito.

Magkakaroon ng isang row para sa bawat group, tanong, subquestion, at sagot. Mayroon ding mga row para sa mga global na variable ng survey, at para sa mga variable ng survey na partikular sa wika. Unang ililista ang pangunahing wika, kasunod ang anumang pangalawang wika. Kaya, kung maraming wika, unang lalabas ang buong nilalaman ng batayang wika (hal., lahat ng group, tanong, subquestion, at sagot). Susundan ito ng isinaling kopya para sa bawat pangalawang wika (na may eksaktong parehong bilang at pagkakasunud-sunod ng mga row para sa isinaling set).

Hinuhulaan ang mga ugnayan batay sa pagkakalapit. Kaya, ang mga tanong na kasunod ng isang group ay bahagi ng group na iyon; ang mga subquestion na kasunod ng isang tanong ay bahagi ng tanong na iyon, at ang mga sagot na kasunod ng isang tanong ay bahagi ng tanong na iyon. Kaya, hindi mo kailangang malaman ang mga ID (gid, qid, sqid) ng anumang tanong. Awtomatiko itong kokompyutin sa pag-import. Sa katunayan, hindi talaga ginagamit ng format na ito ang gid, qid, o sqid (o mga SGQA code).

Mga Tip

Ang layunin ng pag-import/pag-export ng Tab Separated Value ay hayaan kang mabilis na idisenyo ang iyong survey gamit ang spreadsheet. Inaasahan namin na madalas mong i-import ang sheet, susuriin ang bisa nito gamit ang feature na "Show Survey Logic", at susubukan ito. Sa bawat pag-import mo nito, makakakuha ka ng bagong survey. Kaya, maaaring magkaroon ka ng maraming bahagyang nabuong survey, ngunit ayos lang iyon. Magsanay lang na subaybayan kung alin ang pinakabago, o tanggalin ang luma pagkatapos mong i-import ang bago. Dahil hindi ka kailanman gagamit ng mga SGQA code sa Tab Separated Value, hindi mo na kailangang mag-alala kung anong mga code ang itatalaga ng LimeSurvey para sa pangunahing survey, group, tanong at mga key ng sagot. Kaya, malaya kang mag-import at mag-export nang madalas hangga't gusto mo.

Narito ang ilang kapaki-pakinabang na bagay na maaari mong gawin sa pamamaraang ito ng paggawa ng mga instrumento:

1. Gamitin ang parehong mga sagot para sa maraming tanong. Kopyahin lang ang mga 'A' row at i-paste pagkatapos ng bawat tanong na dapat magkaroon ng parehong set.
2. Gamitin ang parehong mga subquestion para sa maraming tanong. Kopyahin lang ang mga 'SQ' row at i-paste pagkatapos ng bawat tanong na nangangailangan nito.
3. "Looping" - gamitin ang parehong group nang maraming beses. Kapag nasa nais mong ayos na ang group, kopyahin ito nang kasindami ng kailangan. Gamitin ang Excel filtering upang makita lamang ang mga 'G' row (para sa mga group), at gamitin ang Excel column drag feature upang i-update ang mga relevance equation para sa bawat group (hal., para sa isang census, ang unang relevance ay maaaring "numPeople > 1", ang susunod ay dapat "numPeople > 2". Awtomatikong ia-update ng drag feature ang numero). I-filter ayon sa mga 'Q' row at tiyaking may natatanging value ang bawat tanong (hal., kung pinangalanan mo ang iyong mga variable na g1_q1, g1_q2, g1_qN, gamitin ang find/replace upang gawing g2 ang g1 para sa ikalawang group; g3 para sa ikatlo, atbp.).
4. Pagbabago ng pagkakasunud-sunod ng mga tanong/group. Baguhin lang ang pagkakasunud-sunod ng mga row ng spreadsheet file.
5. Pagsubok ng mga module ng survey. Para sa mahahabang survey, maaaring gusto mong hatiin ang pagsubok sa mga module. Gumawa lang ng mga bagong spreadsheet file para sa bawat module, at tanggalin ang anumang row na hindi mo kailangan. Iniiwasan nito ang pangangailangang maglagay ng maraming data upang masubok ang mga susunod na bahagi ng survey.
6. Pagsubok ng mga mandatoryong tanong. Karaniwang reklamo hindi ang pangangailangang gawing mandatoryo ang maraming tanong, kundi ang pangangailangang patayin ang mandatory feature para sa pagsubok. Gawin lang ang master spreadsheet na nakatakda ang mandatory sa mga huling nais na value. Pagkatapos, upang subukan ito, tanggalin lang ang column na "mandatory" at i-save ang test version ng spreadsheet. Kapag in-import mo ang bersyong iyon, walang tanong na magiging mandatoryo. Pagkatapos mong matapos ang pagsubok, i-import ang master copy.
7. Pagtatakda ng mga default. Sa halip na gamitin ang GUI, maaari mong ilagay ang anumang nais na default sa default column. Lalo itong nakatutulong sa mga kaso kung saan hindi ka hinahayaan ng GUI na ilagay ang nais na value, tulad ng mga expression upang itakda ang default para sa mga item ng listahan (tulad ng pagpupuno ng listahan mula sa attribute ng kalahok ng survey).
8. Pagsasalin. Maaari kang gumawa ng mga kopya ng iyong spreadsheet - isa para sa bawat wika. Isama ang lahat ng row para sa pangunahing wika, pagkatapos kopyahin at i-paste ang mga ito sa ibaba, at gamitin ang drag upang palitan ang field ng wika sa target na wika. Maaaring ipamahagi ang mga ito sa iyong mga tagasalin, at pagsamahin muli sa iisang spreadsheet file kapag tapos na sila.
9. Maramihang pagtatakda ng mga advanced na attribute ng tanong. Maaaring gusto mong nakikita ang lahat ng iyong equation sa simula (upang makita mo ang kanilang mga value habang nangongolekta ka ng data), ngunit itago silang lahat bago mag-production. I-filter lang ang spreadsheet ayon sa class = 'Q' at uri ng tanong = '*' (equation), at itakda ang always_hide sa 1 para sa bawat isa sa mga tanong na iyon. Gayundin, halimbawa pagkatapos mong likhain ang survey, magpasya kang aling mga tanong ang dapat lumabas sa pampublikong istatistika. Sa halip na i-edit ang bawat tanong sa pamamagitan ng GUI, mag-filter ayon sa class = 'Q', at itakda ang public_statistics = 1 para sa lahat ng tanong na dapat makita sa istatistika.
10. Find at replace. Halimbawa, kung magpasya kang baguhin ang ilang pananalita sa lahat ng iyong tanong, maaari mong gamitin ang find and replace ng Excel upang gawin ang mga pagbabagong iyon. Gayundin, kung magpasya kang magsagawa ng maramihang pagpapalit ng pangalan ng iyong mga variable, makakatulong ang find and replace. Kung kailangan mo ng find and replace na nakabatay sa regular expression, maaari mong piliin ang nais na column, kopyahin sa isang text editor, gawin ang iyong find and replace, at i-paste pabalik ang column sa spreadsheet.
11. Pagkuha ng mga pag-apruba. Kung nagsasagawa ka ng pananaliksik, maaaring may Institutional Review Board na iginigiit na makita ang teksto ng mga tanong. Maaaring ito ay maginhawang paraan upang ibahagi ito. Gayundin para sa mga talakayan kasama ang kliyente.
12. Pagkakasundo ng koponan. Kung sinusubukan mong pagkasunduin ng isang grupo ang pananalita o hitsura ng isang tanong o group, maaari mong mabilis na i-prototype / i-edit ang spreadsheet, i-import ito, at ipakita sa koponan (sa pamamagitan ng preview ng tanong o group) kung ano mismo ang makikita ng mga user. Sa gayon, makakakuha ka ng pag-apruba mula sa koponan bago pa sila umalis ng silid sa halip na idokumento ang mga kinakailangan, buuin ang mga ito, at kumuha ng pag-apruba sa mga susunod na pulong.
13. Pag-upgrade mula sa ibang format ng survey. Kung ang iyong survey ay nasa XML, Word, o ibang format, maaari kang gumawa ng proseso ng pagsasalin upang i-map ang mga ito sa format na ito. Bagaman maaari mo ring subukang i-map sa .lss format, ang bentahe ng format na ito ay hindi nito kailangang subaybayan mo ang mga ugnayan ng foreign key sa pagitan ng mga group, tanong, subquestion, sagot, at default.

Mga Limitasyon

1. Sa disenyo, gumagana lamang nang maayos ang feature na ito para sa mga survey na gumagamit ng pagpapangalan ng qcode (sa halip na SGQA). Ipinapalagay ng feature na ito na natatangi ang mga pangalan ng variable (mga identifier ng tanong) sa buong survey. Maaaring ulitin ang mga pangalan ng subquestion, basta't natatangi ang mga ito sa saklaw ng isang partikular na tanong.

Format ng File

Pangkalahatan

Ginagamit namin ang parehong set ng mga heading ng column para sa iba't ibang layunin. Ang unang 14 na column ay may iba't ibang gamit depende sa uri ng entity (hal., group, tanong, sagot). Ang natitirang mga column ay alpabetikong listahan ng mga pangalan ng database field para sa mga advanced na code ng tanong. Nasa ibaba ang syntax para sa bawat uri ng entity

Ang unang 14 na column ay:

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: Ang mga column na id at related_id ay ginagamit lamang para sa quota at opsyonal. Kung wala kang quota, maaari mong direktang alisin ang 2 column na ito.

Mga Pangkalahatang Parameter ng Survey

Mayroong isang row bawat parameter sa surveys table.

1. class => 'S'
2. name => pangalan ng database field
3. text => value

Mga Parameter ng Survey na Partikular sa Wika

Mayroong isang row bawat field bawat wika sa surveys_languagesettings table. Kinokolekta ang lahat ng entry para sa isang partikular na wika bago gawin ang insert sa table na iyon.

1. class => 'SL'
2. name => pangalan ng database field
3. text => value
4. language => wika

Mga Group

Isang group row bawat wika ng survey (hal., magkakaroon ng 3 group row kung may 3 wika ang survey).

1. id => natatanging numerong identifier para sa group, simula sa numerong 1, gamitin ang parehong ID para sa karagdagang mga wikang kabilang sa kasalukuyang group
2. class => 'G'
3. name => group_name -- ang natatanging identifier para sa group
4. relevance => grelevance -- ang relevance equation sa antas ng group, nang walang curly braces
5. text => description -- ang paglalarawan ng group na partikular sa wika
6. language => language -- ang wika para sa group (hal., 'en')

Mga Tanong

Isang question row bawat wika ng survey (hal., magkakaroon ng 3 question row kung may 3 wika ang survey). Ipinapalagay na ang mga tanong ay kabilang sa group na nauuna sa kanila.

1. id => natatanging numerong identifier para sa tanong, simula sa numerong 1, gamitin ang parehong ID para sa karagdagang mga wikang kabilang sa kasalukuyang tanong
2. class => 'Q'
3. type/scale => type -- ang (karaniwang isang letrang) uri ng tanong (hal., ang 'M' ay Multiple Choice)
4. name => title -- ang natatanging pangalan ng tanong (ang ugat ng sistema ng pagpapangalan ng qcode)
5. relevance => relevance -- ang relevance equation para sa tanong
6. text => question -- ang teksto ng tanong na partikular sa wika
7. help => help -- ang text ng tulong na partikular sa wika
8. language => language -- ang wika para sa group (hal., 'en')
9. validation => preg -- ang opsyonal na pamantayan sa pag-validate gamit ang regular expression para sa tanong
10. mandatory => mandatory -- 'Y' kung mandatoryo
11. other => other -- 'Y' kung dapat available ang opsyong "Iba pa" (para lamang sa ilang uri ng tanong)
12. default => default -- kung nakatakda, ang value na ito ay ipinapasok sa defaultvalues table para sa tanong na ito
13. same_default => same_default -- 'Y' para sa true, kung saan ang anumang defaultvalue na itinakda para sa pangunahing wika ay ilalapat sa ibang mga wika

Mga Subquestion

Isang subquestion row bawat wika ng survey. Ipinapalagay na ang mga subquestion ay kabilang sa tanong na nauuna sa kanila.

1. id => parehong natatanging numeric identifier na ginagamit para sa mga tanong. Dapat gamitin ng mga subquestion ang susunod na available na value; dapat magkaiba ang mga ID ng tanong at subquestion (hal. gamitin ang ID 1 para sa tanong at ang mga ID 2, 3 at 4 para sa mga subquestion na kabilang sa tanong 1, ang susunod na ID ng tanong ay dapat 5, at iba pa). Gamitin ang parehong ID ng subquestion para sa karagdagang mga wika na kabilang sa kasalukuyang mga subquestion.
2. class => 'SQ'
3. type/scale => scale_id -- 0 o 1, depende sa uri ng tanong (hal. ang array text ay may dalawang scale)
4. name => title -- ang "pangalan" ng subquestion, hal. ang ginagamit para sa exclude_all_others
5. relevance => relevance -- (Sa hinaharap) para suportahan ang relevance sa antas ng subquestion
6. text => question -- ang teksto ng subquestion na partikular sa wika
7. help => help -- (Sa hinaharap) para suportahan ang tulong sa antas ng subquestion
8. language => language -- ang wika para sa subquestion
9. validation => preg -- (Sa hinaharap) para suportahan ang regular expression na pag-validate sa antas ng subquestion (hal. para sa mga bahagi ng address)
10. mandatory => mandatory -- (Sa hinaharap) para suportahan ang mandatoryong subquestion (hal. gawing mandatoryo ang ilang subquestion lamang)
11. default => default -- kung nakatakda, ito ang default na value para sa subquestion (ipinapasok sa defaultvalues table)
12. same_default => same_default -- kung nakatakda, ang default para sa pangunahing wika ay ginagamit para sa lahat ng iba pang wika

Mga Sagot

Isang answer row bawat wika ng survey (hal. magkakaroon ng 3 answer row kung ang survey ay may 3 wika). Ipinapalagay na ang mga sagot ay kabilang sa tanong na nauuna sa kanila, at nasa nais na order sa pag-aayos.

1. id => gamitin ang parehong ID ng tanong na kinabibilangan nito
2. class => 'A'
3. type/scale => scale_id -- 0 o 1 (hal. para sa dual-scale)
4. name => code -- ang natatanging identifier ng sagot
5. relevance => assessment_value -- kung gumagamit ng opsyon sa pagtatasa, ito ang value ng pagtatasa para sa sagot
6. text => answer -- ang teksto ng sagot na partikular sa wika
7. language => language -- ang wika para sa sagot na ito (hal. 'en')

Mga Pagtatasa

Isang assessment row bawat wika ng survey (hal. magkakaroon ng 3 assessment row kung ang survey ay may 3 wika). Isinusulat ang mga pagtatasa sa dulo ng file.

1. id => natatanging numeric identifier para sa pagtatasa, simula sa numerong 1, gamitin ang parehong ID para sa karagdagang mga wika na kabilang sa kasalukuyang pagtatasa
2. related_id => id ng grupo kung saan kabilang ang kasalukuyang pagtatasa
3. class => 'AS'
4. type/scale => saklaw ng pagtatasa: T-Total, G-group
5. name => name
6. text => message
7. min_num_value => Minimum
8. max_num_value => Maximum
9. language => language -- ang wika para sa sagot na ito (hal. 'en')

Mga Quota

Isang row bawat quota. Isinusulat ang mga quota sa dulo ng file.

1. id => natatanging numeric identifier para sa quota, simula sa numerong 1
2. class => 'QTA'
3. name => pangalan ng quota
4. mandatory => limit
5. other => aksyon para sa quota
6. default => aktibo
7. same_default => autoload URL

Mga setting ng wika ng quota

Isang quota row bawat wika ng survey. Ipinapalagay na ang mga setting ng wika ng quota ay kabilang sa quota na nauuna sa kanila.

1. id => natatanging numeric identifier para sa mga setting ng wika ng quota, simula sa numerong 1. Dapat magkaiba ang ID ng bawat row para sa iba't ibang wika ng survey
2. related_id => quota id ng quota kung saan kabilang ang setting na ito
3. class => 'QTALS'
4. relevance => message
5. text => URL
6. help => paglalarawan ng URL
7. language => language -- ang wika para sa quota na ito (hal. 'en')

Mga miyembro ng quota

Isang row bawat miyembro ng quota, hindi nakadepende sa wika. Dapat ilagay ang row ng miyembro ng quota kaagad pagkatapos ng tanong na may kaugnayan dito. Ipinapalagay na ang mga miyembro ng quota ay kabilang sa tanong na nauuna sa kanila.

1. id => natatanging numeric identifier para sa mga miyembro ng quota, simula sa numerong 1
2. related_id => quota id ng quota kung saan kabilang ang miyembrong ito
3. class => 'QTAM'
4. name => code ng sagot

Mga Kondisyon

Isang row bawat kondisyon, hindi nakadepende sa wika. Dapat ilagay ang row ng kondisyon kaagad pagkatapos ng tanong na may kaugnayan dito. Ipinapalagay na ang mga kondisyon ay kabilang sa tanong na nauuna sa kanila.

1. id => natatanging numeric identifier para sa kondisyon, simula sa numerong 1.
2. related_id => ID ng tanong ng kaugnay na tanong, kung naaangkop
3. class => 'C'
4. type/scale => scenario
5. name => pangalan ng answer field
6. relevance => operator ng paghahambing
7. text => inaasahang sagot