Struktur tinjauan Tab Separated Value

Import dan Eksport Struktur Tinjauan dalam Format Tab Separated Value

Ciri ini direka untuk memudahkan penggunaan perisian hamparan seperti LibreOffice, Excel atau Google Docs bagi mengarang dan mengedit tinjauan. Ia benar-benar menghapuskan pergantungan kepada kod SGQA.

Ciri ini menyokong import daripada fail Tab Separated Value (TSV) berkod ASCII atau UTF-8 yang mempunyai sambungan .txt.

Lihat contoh berikut untuk memahami fungsi ini dengan lebih baik.

Bermula

Cara paling mudah ialah mengambil tinjauan sedia ada dan mengeksportnya dalam format Tab Separated Value. Gunakan butang eksport tinjauan yang biasa, dan daripada memilih format .lss, pilih "Tab Separated Values format (*.txt)". Tinjauan akan disimpan sebagai fail Tab Separated Value dalam format yang betul (fail unicode dipisahkan tab), lengkap dengan semua pengepala lajur yang betul.

Mana-mana perisian hamparan yang menyokong nilai dipisahkan tab boleh digunakan (contohnya OpenOffice atau LibreOffice). LimeSurvey mengabaikan sebarang pemformatan dalam hamparan, tetapi anda boleh menambahnya jika ia membantu anda.

Perhatikan bahawa fail yang dieksport berformat UTF-8 dengan Byte Order Mark (BOM) sebagai tiga aksara pertama (tersembunyi). Jika anda mengklik dua kali pada fail .txt dan cuba membukanya terus dengan Excel, fail tersebut tidak akan dibuka dengan betul kerana Excel tidak menyedari bahawa ia berformat UTF-8. Untuk membuka fail ini dengan Excel, buka Excel terlebih dahulu, kemudian pilih File:Open, pilih fail .txt, dan nyatakan kepada Excel bahawa fail tersebut menggunakan pengekodan UTF-8.

Akan terdapat satu baris bagi setiap kumpulan, soalan, subsoalan dan jawapan. Terdapat juga baris untuk pemboleh ubah tinjauan global dan pemboleh ubah tinjauan khusus bahasa. Bahasa utama disenaraikan dahulu, diikuti oleh bahasa sekunder. Jadi, jika terdapat berbilang bahasa, keseluruhan kandungan bahasa asas akan muncul dahulu (contohnya semua kumpulan, soalan, subsoalan dan jawapan). Ini akan diikuti oleh salinan terjemahan bagi setiap bahasa sekunder (dengan bilangan dan susunan baris yang sama tepat untuk set terjemahan).

Hubungan disimpulkan berdasarkan kedekatan. Jadi, soalan yang mengikuti sesuatu kumpulan ialah sebahagian daripada kumpulan itu; subsoalan yang mengikuti sesuatu soalan ialah sebahagian daripada soalan itu, dan jawapan yang mengikuti sesuatu soalan ialah sebahagian daripada soalan itu. Oleh itu, anda tidak perlu mengetahui ID (gid, qid, sqid) bagi mana-mana soalan. ID tersebut akan dikira secara automatik semasa import. Malah, format ini tidak menggunakan gid, qid atau sqid (atau kod SGQA) langsung.

Petua

Matlamat import/eksport Tab Separated Value ialah membolehkan anda mereka bentuk tinjauan anda dengan pantas menggunakan hamparan. Kami menjangkakan anda akan kerap mengimport hamparan itu, menyemak kesahihannya menggunakan ciri "Show Survey Logic", dan mengujinya. Setiap kali anda mengimportnya, anda akan mendapat tinjauan baharu. Jadi, anda mungkin akhirnya mempunyai banyak tinjauan yang separa siap, tetapi itu tidak mengapa. Biasakan diri menjejaki yang mana satu paling terkini, atau hapus yang lama selepas anda mengimport yang baharu. Oleh sebab anda tidak pernah menggunakan kod SGQA dalam Tab Separated Value, anda tidak perlu risau tentang kod yang ditetapkan oleh LimeSurvey untuk kunci tinjauan utama, kumpulan, soalan dan jawapan. Jadi, import dan eksportlah sekerap yang anda mahu.

Berikut ialah beberapa perkara mudah yang boleh anda lakukan dengan pendekatan ini untuk mengarang instrumen:

1. Gunakan Jawapan yang sama untuk banyak soalan. Salin sahaja baris 'A' dan tampal selepas setiap soalan yang sepatutnya mempunyai set yang sama.
2. Gunakan subsoalan yang sama untuk banyak soalan. Salin sahaja baris 'SQ' dan tampal selepas setiap soalan yang memerlukannya.
3. "Pengulangan" - gunakan kumpulan yang sama berkali-kali. Setelah kumpulan itu seperti yang anda mahu, salinnya seberapa banyak kali yang diperlukan. Gunakan penapisan Excel untuk melihat baris 'G' sahaja (untuk kumpulan), dan gunakan ciri seret lajur Excel untuk mengemas kini persamaan kaitan bagi setiap kumpulan (contohnya, untuk banci, kaitan pertama mungkin "numPeople > 1", yang seterusnya sepatutnya "numPeople > 2". Ciri seret akan mengemas kini nombor secara automatik). Tapis mengikut baris 'Q' dan pastikan setiap soalan mempunyai nilai yang unik (contohnya, jika anda menamakan pemboleh ubah g1_q1, g1_q2, g1_qN, gunakan cari/ganti untuk menukar g1 kepada g2 bagi kumpulan kedua; g3 bagi kumpulan ketiga, dan seterusnya).
4. Menyusun semula soalan/kumpulan. Susun semula baris fail hamparan.
5. Menguji modul tinjauan. Bagi tinjauan yang panjang, anda mungkin mahu memecahkan pengujian kepada beberapa modul. Cipta fail hamparan baharu untuk setiap modul, dan hapuskan baris yang tidak diperlukan. Ini mengelakkan keperluan memasukkan banyak data untuk menguji bahagian tinjauan yang kemudian.
6. Menguji soalan wajib. Rungutan lazim bukanlah keperluan menjadikan banyak soalan wajib, tetapi keperluan mematikan ciri wajib semasa pengujian. Cipta hamparan induk dengan nilai wajib ditetapkan kepada nilai akhir yang dikehendaki. Kemudian, untuk mengujinya, hapuskan sahaja lajur "mandatory" dan simpan versi ujian hamparan itu. Apabila anda mengimport versi tersebut, tiada soalan yang akan menjadi wajib. Setelah selesai pengujian, import salinan induk.
7. Menetapkan nilai lalai. Daripada menggunakan GUI, anda boleh memasukkan sebarang nilai lalai yang dikehendaki dalam lajur default. Ini amat membantu bagi kes di mana GUI tidak membenarkan anda memasukkan nilai yang dikehendaki, seperti ungkapan untuk menetapkan nilai lalai bagi item senarai (seperti mengisi senarai daripada atribut peserta tinjauan).
8. Terjemahan. Anda boleh membuat salinan hamparan anda - satu bagi setiap bahasa. Sertakan semua baris untuk bahasa utama, kemudian salin dan tampal di bawahnya, dan gunakan seret untuk menukar medan bahasa kepada bahasa sasaran. Salinan ini boleh diedarkan kepada penterjemah anda, dan disepadukan semula ke dalam satu fail hamparan apabila mereka selesai.
9. Penetapan pukal atribut soalan lanjutan. Anda mungkin mahu semua persamaan anda kelihatan pada mulanya (supaya anda dapat melihat nilainya semasa mengumpul data), tetapi kemudian menyembunyikan kesemuanya sebelum pengeluaran. Tapis hamparan pada class = 'Q' dan jenis soalan = '*' (persamaan), dan tetapkan always_hide kepada 1 untuk setiap soalan tersebut. Begitu juga, katakan selepas anda mencipta tinjauan, anda memutuskan soalan mana yang patut muncul dalam statistik awam. Daripada mengedit setiap soalan melalui GUI, tapis pada class = 'Q', dan tetapkan public_statistics = 1 bagi semua soalan yang patut kelihatan dalam statistik.
10. Cari dan ganti. Katakan anda memutuskan perlu menukar sebahagian frasa merentas semua soalan anda, anda boleh menggunakan cari dan ganti Excel untuk membuat perubahan tersebut. Begitu juga, jika anda memutuskan untuk menamakan semula pemboleh ubah anda secara pukal, cari dan ganti boleh membantu. Jika anda memerlukan cari dan ganti berasaskan ekspresi nalar, anda boleh memilih lajur yang dikehendaki, menyalinnya ke penyunting teks, melakukan cari dan ganti, dan menampal semula lajur itu ke dalam hamparan.
11. Mendapatkan kelulusan. Jika anda menjalankan penyelidikan, anda mungkin mempunyai Lembaga Kajian Institusi yang berkeras untuk melihat teks soalan. Ini mungkin cara yang mudah untuk berkongsinya. Begitu juga untuk perbincangan dengan pelanggan.
12. Persetujuan pasukan. Jika anda cuba membuat sekumpulan orang bersetuju tentang perkataan atau rupa sesuatu soalan atau kumpulan, anda boleh membuat prototaip / mengedit hamparan dengan pantas, mengimportnya, dan menunjukkan kepada pasukan (melalui pratonton soalan atau kumpulan) dengan tepat apa yang akan dilihat oleh pengguna. Dengan cara itu anda boleh mendapat kelulusan pasukan sebelum mereka meninggalkan bilik, tanpa perlu mendokumenkan keperluan, membinanya, dan mendapat kelulusan pada mesyuarat akan datang.
13. Menaik taraf daripada format tinjauan lain. Jika tinjauan anda dalam format XML, Word atau lain-lain, anda boleh mencipta proses penterjemahan untuk memetakannya ke format ini. Walaupun anda juga boleh mencuba memetakan ke format .lss, kelebihan format ini ialah ia tidak memerlukan anda menjejaki hubungan kunci asing antara kumpulan, soalan, subsoalan, jawapan dan nilai lalai.

Had

1. Secara reka bentuk, ciri ini hanya berfungsi dengan betul untuk tinjauan yang menggunakan penamaan qcode (bukannya SGQA). Ciri ini menganggap bahawa nama pemboleh ubah (pengecam soalan) adalah unik sepanjang tinjauan. Nama subsoalan boleh diulang, selagi ia unik dalam skop sesuatu soalan tertentu.

Format Fail

Umum

Kami menggunakan set pengepala lajur yang sama untuk pelbagai tujuan. 14 lajur pertama mempunyai tujuan yang berbeza bergantung pada jenis entiti (contohnya kumpulan, soalan, jawapan). Lajur yang selebihnya ialah senarai mengikut abjad bagi nama medan pangkalan data untuk kod soalan lanjutan. Berikut ialah sintaks bagi setiap jenis entiti

14 lajur pertama ialah:

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: Lajur id dan related_id hanya digunakan untuk kuota dan bersifat pilihan. Jika anda tidak mempunyai kuota, anda boleh terus mengalih keluar 2 lajur ini.

Parameter Global Tinjauan

Terdapat satu baris bagi setiap parameter dalam jadual surveys.

1. class => 'S'
2. name => nama medan pangkalan data
3. text => nilai

Parameter Khusus Bahasa Tinjauan

Terdapat satu baris bagi setiap medan bagi setiap bahasa dalam jadual surveys_languagesettings. Semua entri bagi sesuatu bahasa dikumpulkan sebelum penyisipan ke dalam jadual tersebut.

1. class => 'SL'
2. name => nama medan pangkalan data
3. text => nilai
4. language => bahasa

Kumpulan

Satu baris kumpulan bagi setiap bahasa tinjauan (contohnya, akan terdapat 3 baris kumpulan jika tinjauan mempunyai 3 bahasa).

1. id => pengecam berangka unik bagi kumpulan, bermula dengan nombor 1, gunakan ID yang sama untuk bahasa tambahan yang tergolong dalam kumpulan semasa
2. class => 'G'
3. name => group_name -- pengecam unik bagi kumpulan
4. relevance => grelevance -- persamaan kaitan peringkat kumpulan, tanpa pendakap kurawal
5. text => description -- keterangan kumpulan khusus bahasa
6. language => language -- bahasa bagi kumpulan (contohnya, 'en')

Soalan

Satu baris soalan bagi setiap bahasa tinjauan (contohnya, akan terdapat 3 baris soalan jika tinjauan mempunyai 3 bahasa). Soalan dianggap tergolong dalam kumpulan yang mendahuluinya.

1. id => pengecam berangka unik bagi soalan, bermula dengan nombor 1, gunakan ID yang sama untuk bahasa tambahan yang tergolong dalam soalan semasa
2. class => 'Q'
3. type/scale => type -- jenis soalan (biasanya satu huruf) (contohnya, 'M' ialah Pelbagai pilihan)
4. name => title -- nama soalan yang unik (punca bagi sistem penamaan qcode)
5. relevance => relevance -- persamaan kaitan bagi soalan
6. text => question -- teks soalan khusus bahasa
7. help => help -- teks bantuan khusus bahasa
8. language => language -- bahasa bagi kumpulan (contohnya, 'en')
9. validation => preg -- kriteria pengesahan ekspresi lazim pilihan bagi soalan
10. mandatory => mandatory -- 'Y' jika wajib
11. other => other -- 'Y' jika pilihan "Lain-lain" patut disediakan (hanya untuk sesetengah jenis soalan)
12. default => default -- jika ditetapkan, nilai ini dimasukkan ke dalam jadual defaultvalues untuk soalan ini
13. same_default => same_default -- 'Y' untuk benar, dalam hal ini sebarang defaultvalue yang ditetapkan untuk bahasa utama terpakai pada bahasa lain

Subsoalan

Satu baris subsoalan bagi setiap bahasa tinjauan. Subsoalan dianggap tergolong dalam soalan yang mendahuluinya.

1. id => pengecam berangka unik yang sama seperti yang digunakan untuk soalan. Subsoalan hendaklah menggunakan nilai seterusnya yang tersedia; ID soalan dan ID subsoalan mestilah berbeza (cth. gunakan ID 1 untuk soalan dan ID 2, 3 dan 4 untuk subsoalan yang tergolong dalam soalan 1, ID soalan seterusnya ialah 5 dan seterusnya). Gunakan ID subsoalan yang sama untuk bahasa tambahan bagi subsoalan semasa.
2. class => 'SQ'
3. type/scale => scale_id -- 0 atau 1, bergantung pada jenis soalan (cth. teks tatasusunan akan mempunyai dua skala)
4. name => title -- "nama" subsoalan, cth. yang digunakan untuk exclude_all_others
5. relevance => relevance -- (Akan datang) untuk menyokong kaitan peringkat subsoalan
6. text => question -- teks subsoalan khusus bahasa
7. help => help -- (Akan datang) untuk menyokong teks bantuan peringkat subsoalan
8. language => language -- bahasa bagi subsoalan
9. validation => preg -- (Akan datang) untuk menyokong pengesahan ungkapan nalar peringkat subsoalan (cth. untuk bahagian alamat)
10. mandatory => mandatory -- (Akan datang) untuk menyokong subsoalan wajib (cth. hanya menjadikan beberapa subsoalan wajib)
11. default => default -- jika ditetapkan, ini ialah nilai lalai bagi subsoalan (dimasukkan ke dalam jadual defaultvalues)
12. same_default => same_default -- jika ditetapkan, nilai lalai bagi bahasa utama digunakan untuk semua bahasa lain

Jawapan

Satu baris jawapan bagi setiap bahasa tinjauan (cth. akan ada 3 baris jawapan jika tinjauan mempunyai 3 bahasa). Jawapan dianggap tergolong dalam soalan yang mendahuluinya, dan berada dalam aturan susunan yang dikehendaki.

1. id => gunakan ID yang sama dengan ID soalan yang menjadi tempat jawapan itu tergolong
2. class => 'A'
3. type/scale => scale_id -- 0 atau 1 (cth. untuk dwi-skala)
4. name => code -- pengecam jawapan yang unik
5. relevance => assessment_value -- jika menggunakan pilihan penilaian, ini ialah nilai penilaian bagi jawapan tersebut
6. text => answer -- teks jawapan khusus bahasa
7. language => language -- bahasa bagi jawapan ini (cth. 'en')

Penilaian

Satu baris penilaian bagi setiap bahasa tinjauan (cth. akan ada 3 baris penilaian jika tinjauan mempunyai 3 bahasa). Penilaian ditulis di hujung fail.

1. id => pengecam berangka unik bagi penilaian, bermula dengan nombor 1, gunakan ID yang sama untuk bahasa tambahan bagi penilaian semasa
2. related_id => id kumpulan yang menjadi tempat penilaian semasa tergolong
3. class => 'AS'
4. type/scale => skop penilaian: T-Total (Jumlah), G-group (kumpulan)
5. name => name
6. text => message
7. min_num_value => Minimum
8. max_num_value => Maksimum
9. language => language -- bahasa bagi jawapan ini (cth. 'en')

Kuota

Satu baris bagi setiap kuota. Kuota ditulis di hujung fail.

1. id => pengecam berangka unik bagi kuota, bermula dengan nombor 1
2. class => 'QTA'
3. name => Nama kuota
4. mandatory => limit
5. other => Tindakan kuota
6. default => aktif
7. same_default => Jana sendiri URL

Tetapan bahasa kuota

Satu baris kuota bagi setiap bahasa tinjauan. Tetapan bahasa kuota dianggap tergolong dalam kuota yang mendahuluinya.

1. id => pengecam berangka unik bagi tetapan bahasa kuota, bermula dengan nombor 1. Setiap baris untuk bahasa tinjauan yang berbeza hendaklah mempunyai ID yang berbeza
2. related_id => id kuota bagi kuota yang menjadi tempat tetapan ini tergolong
3. class => 'QTALS'
4. relevance => message
5. text => URL
6. help => Deskripsi URL
7. language => language -- bahasa bagi kuota ini (cth. 'en')

Ahli kuota

Satu baris bagi setiap ahli kuota, tidak bergantung pada bahasa. Baris ahli kuota hendaklah diletakkan serta-merta selepas soalan yang berkaitan dengannya. Ahli kuota dianggap tergolong dalam soalan yang mendahuluinya.

1. id => pengecam berangka unik bagi ahli kuota, bermula dengan nombor 1
2. related_id => id kuota bagi kuota yang menjadi tempat ahli ini tergolong
3. class => 'QTAM'
4. name => kod jawapan

Syarat

Satu baris bagi setiap syarat, tidak bergantung pada bahasa. Baris syarat hendaklah diletakkan serta-merta selepas soalan yang berkaitan dengannya. Syarat dianggap tergolong dalam soalan yang mendahuluinya.

1. id => pengecam berangka unik bagi syarat, bermula dengan nombor 1.
2. related_id => id soalan bagi soalan berkaitan, jika berkenaan
3. class => 'C'
4. type/scale => senario
5. name => nama medan jawapan
6. relevance => Perbandingan Pengendali
7. text => jawapan yang dijangka