Jenis pertanyaan - Tanggal

Deskripsi singkat

Jenis pertanyaan ini dapat digunakan untuk menanyakan tanggal tertentu, waktu, atau kombinasi tanggal dan waktu. Peserta dapat memilih nilainya dari kalender popup atau dari kotak tarik-turun. Validasi, tanggal minimum, dan/atau tanggal maksimum dapat ditentukan oleh administrator survei. Berbagai format tanggal dan waktu didukung.

Contoh: Example_Date_Time.zip

Opsi umum

Wajib diisi

Deskripsi

Opsi ini memungkinkan administrator survei meminta responden untuk menjawab pertanyaan survei tertentu. Jika pertanyaan wajib tidak dijawab, responden tidak dapat melanjutkan ke halaman berikutnya. Jika Anda memiliki pertanyaan dengan beberapa subpertanyaan dan hanya subpertanyaan tertentu yang harus dijawab, gunakan atribut jawaban minimum yang terdapat di tab Logika.

Jika Anda menggunakan salah satu tema bawaan dan atribut pertanyaan wajib diaktifkan, tanda bintang merah akan ditampilkan di samping pertanyaan. Jika Anda ingin menyembunyikannya, silakan lihat petunjuk ini.

Opsi yang tersedia

• On - Pertanyaan harus dijawab sebelum peserta dapat melanjutkan ke halaman berikutnya - opsi jawaban 'Tidak dijawab' tidak pernah ditampilkan.
• Soft - Jika pertanyaan tidak dijawab, peringatan akan ditampilkan saat mencoba melanjutkan ke halaman berikutnya - namun, peserta dapat memilih untuk mengabaikan peringatan tersebut dan melanjutkan. Perlu diperhatikan bahwa opsi 'Tidak dijawab' tetap ditampilkan (jika diaktifkan di pengaturan presentasi survei)
• Off (default) - Pertanyaan boleh dibiarkan tidak dijawab

Kondisi

Deskripsi

Jika nilai hasil kondisi adalah "1" atau "true", pertanyaan tersebut "relevan" dalam konteks survei, yaitu ditampilkan kepada peserta survei. Jika tidak, pertanyaan akan disembunyikan. Setiap pertanyaan survei memungkinkan Anda menentukan persamaan yang berhubungan. Fungsi ini merupakan pengganti kondisi dan mendukung logika kondisional yang jauh lebih kompleks.

Penyorotan Sintaks

Setiap kali Anda menyimpan kondisi, kondisi tersebut akan dievaluasi dan sintaksnya disorot. Setiap kesalahan akan diberi kode warna sehingga Anda dapat dengan cepat menemukan dan memperbaikinya.

 Hint: Untuk memeriksa apakah semua kondisi digunakan dengan benar dalam survei Anda, baca tentang fitur tampilkan file logika kami.

Nilai yang valid

• Kondisi apa pun yang menggunakan sintaks ExpressionScript, tanpa tanda kurung kurawal di sekelilingnya.

Contoh

Berikut adalah contoh-contoh yang baik dari penyorotan sintaks.

Tampilan

Tampilkan kotak tarik-turun (dropdown_dates)

Deskripsi

Jika diaktifkan, jenis pertanyaan tanggal/waktu akan menampilkan kotak tarik-turun kepada responden untuk memilih tanggal/waktu, sebagai pengganti popup default.

Opsi yang tersedia

• Aktif
• Nonaktif (default)

Contoh

Jika diaktifkan, pertanyaan akan ditampilkan dengan cara berikut:

Sembunyikan keterangan (hide_tip)

Deskripsi

Sebagian besar pertanyaan biasanya menyertakan keterangan seperti "Harap pilih salah satu opsi berikut" atau teks petunjuk tentang cara mengisi pertanyaan. Atribut ini memungkinkan Anda untuk menonaktifkan atau mengaktifkan keterangan/petunjuk tersebut.

Keterangan/petunjuk ini mencakup pesan kriteria validasi (seperti jumlah jawaban min/maks, Nilai total setara/min/maks). Jika hide_tip diaktifkan, pesan-pesan ini akan disembunyikan. Namun, jika pengguna memasukkan data yang tidak valid, keterangan akan muncul. Keterangan akan berwarna merah, lalu berubah menjadi hijau setelah kriteria validasi terpenuhi.

Opsi yang tersedia

• Aktif - keterangan/petunjuk disembunyikan;
• Nonaktif (default).

Jenis penampilan bulan (month_display_style)

Deskripsi

Bulan dapat ditampilkan kepada responden dengan tiga cara: menggunakan nama pendek (Jan, Feb, dst.), nama lengkap (Januari, Februari, dst.), atau nomor/urutan bulan dalam kalender tahunan (01 untuk Januari, 02 untuk Februari, dan seterusnya).

Opsi yang tersedia

• Nama pendek
• Nama lengkap
• Angka

Urutan jawaban terbalik (reverse)

Deskripsi

Jika diaktifkan, urutan jawaban akan dibalik.

Opsi yang tersedia

• Aktif
• Nonaktif (default)

Contoh

Misalkan Anda ingin menggunakan jenis pertanyaan Larik (Angka). Jika opsi ini dinonaktifkan (nilai default), jawaban yang dapat dipilih oleh peserta survei adalah: "1, 2, 3, ... , 10". Jika diaktifkan, pengaturan ini akan membalik urutan jawaban yang tersedia: "10, 9, 8, ... , 1".

Tema pertanyaan (question_theme)

Deskripsi

Fitur ini memungkinkan Anda menggunakan tema khusus untuk pertanyaan yang bersangkutan.

Opsi yang tersedia

• Tema pertanyaan yang Anda buat, yang terdapat di bawah Tema pertanyaan pada panel Tema.

Lihat: Tema pertanyaan

Catatan: Fitur ini sedang dalam pengembangan saat ini.

Selalu sembunyikan pertanyaan ini (hidden)

Deskripsi

Jika diaktifkan, pertanyaan akan selalu disembunyikan - tidak akan ditampilkan kepada partisipan survei. Fungsi ini dapat digunakan dalam skenario berikut:

• Jika Anda ingin mengisi pertanyaan terlebih dahulu melalui URL dan tidak ingin pertanyaan tersebut ditampilkan di layar. Hal ini menggantikan semua kondisi yang digunakan dalam survei karena pertanyaan yang bersangkutan bahkan tidak disertakan di halaman.
• Jika Anda ingin menyimpan atau menghitung nilai secara langsung melalui ExpressionScript - Presentasi.

Catatan: Jenis pertanyaan umum yang digunakan dengan fungsi ini adalah jenis Persamaan.

Opsi yang tersedia

• Aktif
• Nonaktif (default)

Kelas CSS (css_class)

Deskripsi

Jika Anda ingin menambahkan kelas CSS khusus pada pertanyaan tertentu, Anda dapat memasukkan nama kelas CSS di kotak ini. Pastikan Anda memberi spasi kosong di antara nama-nama kelas yang berbeda.

Nilai yang valid

• Teks apa pun dengan spasi di antara nama-nama kelas CSS yang berbeda.

 Hint: Anda juga dapat menyisipkan ekspresi di kotak ini ^{(New in 3.0.0 )}. Perlu diingat bahwa hasil ekspresi tidak akan diperbarui secara dinamis.

  Menurut W3C, nama kelas CSS hanya boleh berisi karakter [a-zA-Z, dan 0-9] serta karakter ISO 10646 U+00A1 ke atas, ditambah tanda hubung (-) dan garis bawah (_). Nama tersebut tidak boleh diawali dengan angka, atau tanda hubung yang diikuti angka. LimeSurvey melakukan encoding pada kelas CSS, tetapi tidak memperbaikinya sepenuhnya.

Tanggal minimum (date_min)

Deskripsi

Atribut pertanyaan ini dapat digunakan untuk menetapkan nilai minimum pada pertanyaan tanggal (dalam format y-m-d atau string bahasa Inggris yang valid - lihat detail di bawah). Atribut ini dapat digunakan untuk opsi tampilan popup maupun tarik-turun. Jika tanggal minimum tidak ditetapkan, maka 1.1.1900 digunakan sebagai default.

  Opsi validasi Expression Manager juga dapat digunakan untuk menetapkan "tanggal minimum". Namun, jika Anda menggunakan kalender popup dan ekspresi tersebut bergantung pada pertanyaan sebelumnya yang berada di halaman yang sama, tahun tidak akan ditampilkan dengan benar di kalender popup.

Nilai yang valid

• Nilai tanggal apa pun dalam format YYYY-MM-DD (mis., 2017-08-24);
• Nilai tahun apa pun;
• String bahasa Inggris apa pun : "now", "-10 years", "tomorrow";
• Referensi ke pertanyaan tanggal/waktu lain : AnotherDateQuestion (menggunakan kode pertanyaan);
• Ekspresi : Dengan ekspresi, tanggal minimum dapat dihitung secara dinamis. Misalnya, Anda dapat menggunakan tanggal dari jawaban sebelumnya + 3 hari sebagai minimum untuk pertanyaan saat ini dengan memasukkan: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Tanggal maksimum (date_max)

Deskripsi

Atribut pertanyaan ini dapat digunakan untuk menetapkan nilai maksimum pada pertanyaan tanggal (dalam format y-m-d atau string bahasa Inggris valid lainnya - lihat di bawah untuk opsi lainnya). Atribut ini dapat digunakan untuk opsi tampilan popup maupun tarik-turun.

  Opsi validasi Expression Manager juga dapat digunakan untuk menetapkan "tanggal maksimum". Namun, jika Anda menggunakan kalender popup dan ekspresi tersebut bergantung pada pertanyaan sebelumnya yang berada di halaman yang sama, tahun tidak akan ditampilkan dengan benar di kalender popup.

Nilai yang valid

• Nilai tanggal apa pun dalam format YYYY-MM-DD (mis., 2018-08-24);
• Nilai tahun apa pun;
• String bahasa Inggris apa pun : "now", "-10 years", "tomorrow";
• Referensi ke pertanyaan tanggal/waktu lain : AnotherDateQuestion (menggunakan kode pertanyaan);
• Ekspresi: Dengan ekspresi, tanggal dapat dihitung secara dinamis. Misalnya, Anda dapat menggunakan tanggal dari jawaban sebelumnya + 3 hari sebagai tanggal maksimum untuk pertanyaan ini dengan memasukkan: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Bantuan relevansi untuk survei dapat dicetak (printable_survey_relevance_help)

Deskripsi

Jika Anda ingin mencetak survei, Anda juga dapat mencetak persamaan yang berhubungan untuk setiap pertanyaan. Namun, jika Anda ingin menampilkan penjelasan, bukan ekspresi, pada formulir cetak, isi kotak ini dengan teks penjelasan untuk persamaan yang berhubungan tersebut.

Nilai yang valid

• Teks dan/atau angka apa pun yang ingin Anda tampilkan pada formulir cetak.

Input

Format tanggal/waktu

Deskripsi

Opsi pertanyaan ini dapat digunakan untuk menentukan format tanggal khusus. Jika dikosongkan, format tanggal survei akan digunakan.

Nilai yang valid

• Format d/dd, m/mm, yy/yyyy, H/HH, M/MM dapat digunakan untuk menampilkan tanggal dan/atau waktu, sedangkan "-", ".", "/", ":" dapat digunakan sebagai pemisah.

Contoh

• yyyy-mm-dd - tahun-bulan-hari;
• dd.mm.yyyy HH:MM - hari.bulan.tahun Jam:Menit;
• HH:MM - Jam:Menit (hanya waktu yang dapat dipilih);
• yyyy/mm - tahun/bulan.

Interval langkah menit (minute_step_interval)

Deskripsi

 Hint: This feature changed with version 3.14.12

Opsi ini hanya digunakan jika format input menggunakan menit ("MM").

Nilai yang valid

• Nilai numerik apa pun yang lebih kecil dari 60. Menambahkan nilai yang lebih besar dari 60 tidak berguna -> hanya "0" atau "00" yang akan ditampilkan sebagai jawaban yang mungkin di kotak tarik-turun.

Contoh

Pada contoh di bawah ini, opsi interval langkah menit diatur ke 7:

Logika

Nama grup pengacakan (random_group)

Deskripsi

Pengaturan ini menempatkan pertanyaan ke dalam grup pengacakan tertentu. Semua pertanyaan dalam grup tersebut akan ditampilkan dalam urutan acak kepada responden survei.

Anda dapat menemukan contoh survei yang menggunakan nama grup pengacakan di contoh survei ExpressionScript.

Nilai yang valid

Cukup masukkan string apa pun yang Anda inginkan (misalnya: 'group1'). Semua pertanyaan yang memiliki string yang sama pada kolom nama grup pengacakan akan diacak posisinya dalam survei (=saling bertukar tempat secara acak).

Pratinjau Untuk melihat pratinjau pertanyaan, gunakan fungsi pratinjau survei alih-alih fungsi pratinjau grup pertanyaan, karena fungsi yang kedua dilaporkan tidak menampilkan pertanyaan dalam urutan acak.

Persamaan validasi pertanyaan (em_validation_q)

Deskripsi

Ini adalah persamaan yang digunakan untuk memvalidasi seluruh pertanyaan (misalnya, semua bagiannya secara kolektif untuk pertanyaan dengan banyak jawaban). Jika pertanyaan gagal memenuhi kriteria validasi, pesan em_validation_q_tip akan ditampilkan (menggunakan gaya CSS .error). Tip ini menggunakan gaya CSS .em_q_fn_validation, yang disembunyikan secara default di dalam template.css.

Perbedaan utama antara fitur ini dan persamaan validasi subpertanyaan (opsi em_validation_sq) adalah bahwa pada fitur ini, jika pertanyaan (atau bagian pertanyaan) gagal validasi, pesan kesalahan dapat ditampilkan. Pada validasi subpertanyaan, setiap sel isian teks (misalnya, pada jenis pertanyaan larik, tetapi juga dapat diterapkan pada jenis pertanyaan dengan isian tunggal) akan diberi gaya sehingga warna latar belakangnya menjadi merah (muda).

Nilai yang valid

• Persamaan apa pun yang menggunakan sintaks ExpressionScript, tanpa tanda kurung kurawal di sekelilingnya.

Contoh

• Anda ingin mengumpulkan informasi demografis dari pengguna melalui pertanyaan Beberapa teks pendek, dan Anda ingin memvalidasi bahwa pengguna telah memasukkan alamat surel dan nomor telepon yang valid.

Contoh ini menunjukkan tampilan pertanyaan dengan jawaban yang tidak valid:

Dan inilah tampilannya dengan satu jawaban yang tidak valid:

Berikut cara mengedit pertanyaan untuk memasukkan informasi tersebut:

Dan berikut sebagian keluaran Show Logic File yang memungkinkan Anda memeriksa keakuratan ekspresi Anda dan memastikan tidak ada kesalahan sintaks:

Seperti yang Anda lihat, persamaan validasi menguji bahwa surel dan nomor telepon keduanya kosong atau cocok dengan filter persamaan reguler.

Tip validasi hanya menampilkan pesan peringatan jika telepon atau surel tampak tidak valid.

 Hint: Untuk membuat pesan validasi yang kompleks, baca tentang penggunaan ExpressionScript.

Jika Anda ingin mengimpor contoh di atas ke instalasi LimeSurvey Anda, unduh berkas .lsq berikut: Em_validation_q_example.zip.

 Hint: Ingat, LimeSuvey menggunakan sintaks Perl untuk persamaan reguler, jadi persamaan tersebut harus diawali dan diakhiri dengan / (karakter garis miring)!

Tips untuk persamaan validasi seluruh pertanyaan (em_validation_q_tip)

Deskripsi

Jika Anda menggunakan persamaan validasi pertanyaan, Anda dapat menggunakan kotak ini untuk menampilkan pesan opsional sebagai tips pertanyaan tentang cara pertanyaan tersebut harus diisi.

Nilai yang valid

• String atau persamaan apa pun yang menggunakan sintaks ExpressionScript.

Contoh

Lihat contoh pada bagian wiki persamaan validasi pertanyaan - contoh tersebut menunjukkan cara menyesuaikan tips untuk menampilkan bagian mana dari pertanyaan Beberapa teks pendek yang tidak memenuhi kriteria validasi.

Lainnya

Sisipkan pemisah halaman pada versi cetak (page_break)

Deskripsi

Atribut ini hanya aktif saat Anda benar-benar mencetak survei dari Tampilan Cetak. Atribut ini memaksa pemisah halaman sebelum pertanyaan.

Opsi yang tersedia

• Aktif
• Nonaktif (default)

Statistik

Tampilkan grafik (display_chart)

Deskripsi

Atribut ini memungkinkan administrator survei memilih apakah grafik yang berisi hasil pertanyaan akan ditampilkan kepada partisipan survei setelah mereka selesai mengisi survei.

Catatan: Agar grafik ditampilkan di halaman terakhir, Anda harus mengaktifkan opsi berikut:

• Pengaturan survei Statistik publik dari Pengaturan presentasi & navigasi
• Pengaturan survei Tampilkan grafik dari Pengaturan presentasi & navigasi
• Atribut pertanyaan Statistik publik, dan
• atribut pertanyaan Tampilkan grafik.

Opsi yang tersedia

• On
• Off (default)

Jenis grafik (chart_type)

Deskripsi

Atribut ini memungkinkan administrator survei memilih jenis grafik yang akan ditampilkan kepada responden setelah ia selesai mengisi survei.

Catatan: Jangan lupa mengubah pengaturan pertanyaan dan pengaturan survei agar grafik ditampilkan di akhir survei. Untuk detail lebih lanjut, lihat bagian wiki tentang atribut pertanyaan Tampilkan grafik.

Opsi yang tersedia

• Grafik batang
• Grafik Lingkaran
• Radar
• Garis
• PolarArea
• Doughnut

Tanggal dan ExpressionScript: Validasi dan perhitungan lanjutan

Limesurvey (versi 2.05 ke atas) memudahkan validasi tanggal menggunakan kolom date_min dan date_max (lihat di atas). Gunakan kolom tersebut jika memungkinkan. Jika Anda memerlukan validasi yang lebih lanjut, Anda dapat bekerja (dan menghitung) dengan tanggal menggunakan ExpressionScript dan fungsi strtotime(). Fungsi ini menghitung jumlah detik sejak 1 Januari 1970 hingga tanggal tertentu.

Contoh: jika Anda ingin menampilkan dalam teks pertanyaan jumlah hari yang telah berlalu sejak tanggal keberangkatan (yang ditanyakan pada pertanyaan sebelumnya) hingga hari ini, Anda dapat menggunakan ekspresi {(strtotime("now")-strtotime(departure))/60/60/24}.

Perlu diperhatikan bahwa strtotime() bekerja dengan banyak format yang berbeda, tetapi tidak semuanya! Misalnya, format tanggal default Limesurvey (MM-DD-YYYY) TIDAK berfungsi dengan strtotime(). Atur survei Anda agar menggunakan salah satu format tanggal berikut untuk menghindari masalah: YYYY-MM-DD, YYYY/MM/DD, DD.MM.YYYY, MM/DD/YYYY atau DD-MM-YYYY.

  Tanggal di Limesurvey disimpan sebagai string (format teks). ExpressionScript mengonversi semua tanggal dalam sebuah ekspresi ke format standar "yyyy-mm-dd HH:MM:SS". Hal ini membuat perbandingan tanggal dalam ekspresi menjadi jauh lebih mudah (misalnya "date1>date2"). Jika Anda memerlukan string tanggal dalam format yang digunakan saat pertanyaan diajukan, gunakan atribut ".shown" (misalnya: Anda lahir pada {birthdate.shown}.)