Actions

質問タイプ - 配列(テキスト)

From LimeSurvey Manual

This page is a translated version of the page Question type - Array (Texts) and the translation is 100% complete.

概略

配列(テキスト)質問タイプは、縦軸のサブ質問と横軸のサブ質問でできた、テキストボックスの配列に回答する質問タイプです。


例: Array_Texts_Example_text.zip

この質問タイプで数字の回答に限定することもでき("数字のみ"の質問属性を参照)、合計を表示によって縦・横・両方の合計を表示させることもできます。


例: Array Texts Example text numbers.zip

全般オプション

回答必須

説明

このオプションにより、アンケートの質問に回答者が必ず答えるようにすることができます。回答必須の質問に回答しない場合、回答者は先に進むことができません。ある質問に複数のサブ質問があり、特定のサブ質問のみを回答必須とする場合は、ロジックタブの下にある最小回答数属性を使用します。

プレインストールされたテーマを使用している場合、必須の質問属性を有効にすると、質問の横に赤いアスタリスクが表示されます。 表示したくない場合は、こちらを参照してください。


設定可能な値

  • オン - 参加者が次のページに進む前に質問に回答する必要があります。回答の選択肢に「回答なし」は表示されません。
  • ソフト - 質問に回答せずに次のページに進もうとすると警告が表示されますが、参加者は警告を無視して先に進むことができます。「回答なし」オプションは表示されます(アンケートの表示設定で有効になっている場合)。
  • オフ(規定値) - 質問に回答しなくてもよくなります


条件(以前の"出現条件")

説明

条件の結果値が「1」または「true」になると、質問がアンケートの中で「関連する」、つまりアンケート参加者に提示されます。その他の場合は質問は表示されません。どのような質問でも関連式を指定することができます。この関数は条件の後継であり、より複雑な条件ロジックをサポートします。

構文ハイライト

条件を保存するたびに、検証され構文がハイライトされます。エラーにも色がつくので、すぐに気づいて直すことができます。

 Hint: アンケートのすべての条件が正しく使用されているか確認するには、ロジックファイルを参照してください。


有効な値

構文ハイライトによい例があります。



(正規表現を使った)検証 (preg_validation)

説明

この設定は、質問内のすべての値の検証に使う正規表現を指定するものです。

質問やサブ質問への回答のどれかがこの検証要件に適合しない場合、テキスト入力欄の背景色が赤くなり、回答者が直すべき場所に気づきやすくなっています。回答者が送信ボタンを押さなくてもそれぞれの質問を検証することができます。

有効な値

  • 有効な任意の正規表現


表示

(サブ)質問幅 (subquestion_width)

説明

パーセント形式でサブ質問の列幅を設定します。例えば、この値を60に設定すると、質問の幅の60%がサブ質問テキスト(最も左の列)に割り当てられます。残りの幅が回答オプションに均等に割り当てられます。

有効な値

  • 1から100までの整数


TIP非表示 (hide_tip)

説明

多くの質問では、「以下からひとつだけ選択してください」のような注記(tip)や質問への回答方法を示すテキストが表示されます。この属性で、tipやヒントを表示するかしないかを設定できます。

こうしたtipやヒントには、検証基準(最小/最大回答数、最小/最大/合計値)に関するメッセージが含まれます。hide_tipをオンにすると、こうしたメッセージは表示されませんが、無効なデータを入力するとtipが表示されます。赤色で表示されますが、検証基準を満たすと緑色になります。

利用可能な設定値

  • オン - tipやヒント非表示
  • オフ(規定値)



回答のランダム表示(random_order)

説明

  非推奨の回答オプション : 5.5.0から、この属性は回答の選択肢の順序付けには使用されなくなりました。QS:Answer_order/jaを参照してください。


この属性により、回答の選択肢/サブ質問の順番は無視され、ランダムに並べ替えられます。このオプションにより、アンケートの偏りをなくすことができます。サブ質問がある場合、サブ質問の順番はランダムになりますが、回答の選択肢の順番はランダムにはなりません。

有効な値

  • はい - 参加者がアンケートを開始するときにランダム化する
  • いいえ(規定値)



テキスト入力ボックスのサイズ (input_box_size)

 Hint: この機能は、バージョン3.0.0以降で使用できます。


説明

この機能は、テキスト領域(テキスト入力ボックス)のサイズを指定するものです。何も設定しなければ、LimeSurveyは入力ボックスを既定のサイズで表示します。この設定で既定の動作を変えることができます。

ボックスを次の行に移動させたい場合、ラッパーのサイズを大きくします。テキスト入力幅属性の値を大きくします。

有効な値

  • 任意の数値


ヘッダー繰り返し (repeat_headers)

説明

このオプションは、質問に多数のサブ質問を設けるときに使用します。ヘッダーを再表示するまでのサブ質問の数を設定します。

有効な値

  • 任意の整数
  • 0(規定値) - ヘッダー繰り返し機能がオフになります。


質問テンプレート (question_theme)

説明

それぞれの質問にカスタマイズされたテンプレートを適用することができます。

利用可能な設定

  • テンプレートパネルの質問テンプレートにある作成済みの質問テンプレート

参照: Question themes

注意: この機能は現在開発中です。


この質問をいつも隠す (hidden)

説明

オンにすると、その質問は常に表示されません。この機能は以下のような場合に使用します。

  • 質問にURLをあらかじめ入力しておき、それを画面に表示させたくない場合。それぞれの質問がページに埋め込まれないため、アンケートで使用される条件が無効になります。
  • ExpressionScriptで値をその場で保存または計算したい場合。
注意: この機能で使用する一般的な質問タイプはです。

利用可能な設定値

  • オン
  • オフ(規定値)


CSS クラス (css_class)

説明

特定の質問に特別な CSS クラスを追加するときは、この欄に CSS クラス名を入力します。クラス名を列挙するときはスペースで区切ります。

有効な値

  • 任意の文字列と CSS クラスを区切るスペース
 Hint: この欄にを入力することもできます (New in 3.0.0 )。式の結果は動的に更新されないので注意してください。


  W3C によると, CSS クラス名は文字 [a-zA-Z, and 0-9] と ISO 10646 の U+00A1 以降の文字、 ハイフン(-)、アンダースコア(_)のみが使えます。数字で始めたり、ハイフンの後に数字を続けることはできません。LimeSurvey は CSS クラスをエンコードしますが、完全ではありません。



入力

最大入力文字数 (input_max_characters)

説明

それぞれの質問の回答用テキストボックスにアンケート回答者が入力できる最大の文字数を設定します。

有効な値

  • 任意の数値

  • アンケート参加者に短く簡潔な回答をさせたい場合、最大入力文字数に小さな値(10-15など)を設定します。


ロジック

最小回答数 (min_answers)

説明

この機能は、複数選択質問で一定数の回答を選択させる場合に使用します。

有効な値

  • 0より大きい整数
  • 任意の数
  • 任意のSGQAコード
  • 任意の質問コード(変数名)
  • ExpressionScript構文を使用した任意の式(中括弧は除く)

Xと設定すると、利用者は少なくともX個のチェックボックスを選択しないとアンケートを送信できません。このオプションを順位づけに適用する場合は、少なくともX位まで順位づけする必要があります。

この属性を順位づけ質問で使用する場合、その質問は必須ではないと設定する必要があります。必須にすると、min_answers機能を使用する直感と異なり、すべてを順位づけしなければなりません。



最大回答数 (max_answers)

説明

複数選択質問で利用者が選択できる回答の上限数を設定するときに使用します。

有効な値

  • 任意の数値
  • 任意のSGQAコード
  • 任意の質問コード(変数名)
  • ExpressionScript構文を使用した任意の式(中括弧は除く)

2に設定すると、利用者は多くとも2つのチェックボックス、または1つのチェックボックスと「その他」欄(ある場合)に回答できます。順位づけ質問タイプでは、最大2位まで選択できます。


配列フィルター (array_filter)

説明

配列フィルター設定は複数選択質問に使うことができ、回答結果を後続のリスト、配列、複数選択質問に表示させることができます。

以下の配列質問タイプにより、後続の質問がフィルターされます。
  • 複数選択
  • コメントつき複数選択
  • 自由回答(短い・複数)
  • 数字入力(複数)
  • 配列(5点、10点、はい/いいえ/どちらでもない、増加/同じ/減少、軸反転)
  • 配列(二元スケール、テキスト、数字)
  • 順位付け

さらに、それぞれの質問タイプをフィルタリングすることができます。

唯一の例外は、軸を反転した配列で、他の質問をフィルタリングできますが、それ自身にはできません。

フィルターのセット方法

フィルターをセットするには、編集中の質問の配列フィルターボックスに複数選択質問の質問コードを入力します。それぞれの質問が現在の質問の情報源として使用され、前問で選択された回答が現在の質問の回答の選択肢として引用され使用されます。例えば、ソースとなる複数選択質問のコードが"Q1"の場合、回答のフィルタリングプロセスを起動するため、'配列フィルター'ボックスに"Q1"と入力します。質問Q1で選択された回答のみが、配列フィルターされた質問で表示されます。

このオプションを通じて複数の質問をフィルタリングしたい場合は、ボックスに質問コードをセミコロン(;)で区切って入力します。
  最初の質問で使用するサブ質問コードは2つ目のサブ質問コードと一致しなければなりません。一致しないと、配列フィルター機能による回答フィルタリングができません。全体としてどのように機能するか、下記の例で確認してください。


複数選択でその他の設定を許可する場合、サブ質問コードにその他を選択し、チェックするかどうかでフィルターすることができます。

カスケーディング

設定するとカスケードして表示されます。つまり、他の質問をフィルターする質問を選択し、フィルターされた質問によってさらに他の質問をフィルターする、といったことが可能です。

配列フィルターの例

この設定を理解するため、下記の例を参照してください。



上のスクリーンショットでは、2つの質問があります。1つ目は自由回答(短い・複数)質問タイプで、2つ目は二元スケール配列質問タイプです。1つ目の質問で回答した内容が2つ目の質問に反映されます。技術的には、1つ目の質問のサブ質問の回答が2つ目の質問を限定し表示しています。

この例は、以下のリンクからダウンロードできます。 limesurvey_group_32.lsgLimeSurveyにこの質問グループをインポートします。



除外フィルター配列 (array_filter_exclude)

説明

除外フィルター配列設定は複数選択質問に使うことができ、回答結果を後続のリスト、配列、複数選択質問に表示させないようにすることができます。

以下の配列質問タイプにより、後続の質問がフィルターされます。
  • 複数選択
  • コメントつき複数選択
  • 自由回答(短い・複数)
  • 数字入力(複数)
  • 配列(5点、10点、はい/いいえ/どちらでもない、増加/同じ/減少、軸反転)
  • 配列(二元スケール、テキスト、数字)
  • 順位付け

さらに、それぞれの質問タイプをフィルタリングすることができます。

唯一の例外は、軸を反転した配列で、他の質問をフィルタリングできますが、それ自身にはできません。

設定方法

編集中の質問の除外フィルター配列 に複数選択質問の質問コードを入力します。それぞれの質問が現在の質問の情報源として使用され、前問で選択されなかった回答が現在の質問の回答の選択肢として引用され使用されます。例えば、ソースとなる複数選択質問のコードが"Q1"の場合、回答のフィルタリングプロセスを起動するため、'除外フィルター配列'ボックスに"Q1"と入力します。質問Q1で選択されなかった回答のみが表示されます。

このオプションを通じて複数の質問をフィルタリングしたい場合は、ボックスに質問コードをセミコロン(;)で区切って入力します。
  最初の質問で使用するサブ質問コードは2つ目のサブ質問コードと一致しなければなりません。一致しないと、除外フィルター配列機能による回答フィルタリングができません。全体としてどのように機能するか、下記の例で確認してください。


カスケーディング

設定するとカスケードして表示されます。つまり、他の質問をフィルターする質問を選択し、フィルターされた質問によってさらに他の質問をフィルターする、といったことが可能です。

以下の例を参照してください。



上のスクリーンショットでは、2つの質問があります。1つ目は複数選択質問タイプで、2つ目はコメントつき複数選択質問タイプです。1つ目の質問で回答した内容が2つ目の質問では除外されます。例えば、ComfortUpdate(サブ質問コードは'SQ1')とPlugin('SQ4') を選択すると、2つ目のサブ質問で対応する'SQ1'と'SQ4'が除外されます。スクリーンショットでは、1つ目の質問で選択されなかったものだけが2つ目の質問で表示されます。

この例は、以下のリンクからダウンロードできます。 Limesurvey_group_array_filter_exclude.zip LimeSurveyにこの質問グループをインポートします。



配列フィルターの形式 (array_filter_style)

説明

この機能では、フィルターされたサブ質問をどのように表示するかを設定します。"隠す"か"無効"のどちらかになります。

サブ質問のフィルタリング方法は、こちらのウィキセクションを参照してください。

設定可能な値

  • 隠す(規定値) - 選択すると、選択されたサブ質問は後続の質問に表示されません。
  • 無効 - 選択すると、選択されたサブ質問はグレーアウトされ、選択できないようになります。

"無効"を選択すると、選択されたサブ質問は以下のように表示されます。



ランダムグループ名 (random_group)

説明

質問を特定のランダムグループに入れることにより、そのグループ内のすべての質問をランダムな順番でアンケート回答者に提示するものです。

ランダムグループ名を使用した例は、ExpressionScriptのサンプルアンケートにあります。

有効な値

任意の文字列(例:'group1')を入力します。ランダムグループ名ボックスに同じ名前がセットされたすべての質問がアンケートの中でランダムになります(お互いにランダムに入れ替わる)。


プレビュー 質問をプレビューするには、質問グループのプレビュー機能ではなくアンケートのプレビューを使用します。前者では、質問をランダムな順序で表示できないと報告されているためです。



質問の検証式 (em_validation_q)

説明

質問全体(複数選択質問をまとめて)を検証する式です。検証条件に合致しない場合、em_validation_q_tip で設定したメッセージが表示されます(CSSスタイルは.errorとなります)。このTIPは.em_q_fn_validationというCSSスタイルが使われ、template.cssの既定では非表示となります。

本機能とサブ質問の検証式(em_validation_sq オプション)との大きな違いは、質問または質問の一部が検証エラーとなると、エラーメッセージが表示される点です。サブ質問の検証式では、それぞれのテキスト入力欄(例えば配列質問タイプにおいてですが、単一入力する質問タイプでも機能します)の背景が(薄い)赤色になります。

有効な値

  • 自由回答(短い・複数)で利用者の情報を集め、有効なメールアドレスと電話番号が入力されたか検証したいとき

この例は無効な回答がいくつかある場合にどのように見えるかを示します。

これはひとつだけ、無効な回答がある場合の見え方です。

これは、情報を入力するためにどのように質問を編集するかを示します。

これは、ロジックファイルの出力の一部で、式が正しいか、構文エラーがないかをチェックできます。

お分かりのように、検証式はメールアドレスと電話番号が空白か正規表現フィルターにマッチするかテストしています。

電話番号やメールアドレスが無効な場合、検証TIPはワーニングメッセージだけ表示します。

 Hint: より複雑な検証メッセージを作成する場合は、ExpressionScriptの使用方法を参照してください。


LimeSurveyに上記の例をインポートする場合は、この.lsqファイルをダウンロードしてください。Em_validation_q_example.zip

 Hint: LimeSuveyは正規表現にPerlの構文を使用しますので 始めと終わりが/(スラッシュ)になります。



質問の検証式のTIP (em_validation_q_tip)

説明

質問の検証式を使用する際、質問のTIPとしてどのように入力すべきか表示するときに使います。

有効な値

例として、質問の検証式ウィキセクションの例を参照してください。自由回答(短い・複数)で検証エラーとなった部分でどのようにTIPが表示されるかがわかります。



サブ質問の検証式 (em_validation_sq)

説明

各々のサブ質問(テキスト)を検証するための式です。検証条件に適合しないテキスト欄はエラーであることを示すため、背景色がピンク色になります(.em_sq_fn_validation CSSスタイルを使用)。正規表現ベースの検証も可能です。

有効な値

例えば、回答を3の倍数に限定する場合、式は次のようになります。

(this / 3) == floor(this/3)

予約値thisは、テキスト入力欄の入力値に自動的に置き換えられます。



サブ質問の検証式のTIP (em_validation_sq_tip)

説明

em_validation_sqを使用する際、入力した回答が正しくないときに表示されるメッセージ/TIPを設定します。

有効な値

  • 任意の文字列

  • メールアドレスを検証する場合は、TIPは、"正しいメールアドレスを入力してください"のようになります。


その他

印刷用ビューで改ページするか (page_break)

説明

この属性は、印刷用ビューからアンケートを実際に印刷するときだけアクティブになります。質問ので改ページします。

設定可能な値

  • オン
  • オフ(規定値)


数字のみ (numbers_only)

説明

このオプションをオンにすると、参加者はテキストボックスに数字のみ入力できるようになります。

式質問タイプでは、この設定は結果が文字列ではなく数字だけでなければならないことになります。小数点について式が正しく計算/変換されます。

質問タイプによる動作

  1. 既定値: 数字以外の値が入力されたら、テキストボックスがすぐに消去され、正しい値を入力できるようになります。
  2. 配列(テキスト): 数字のみオプションがオフの場合、"合計を表示"と"総計を表示"オプションが無効にされ、合計欄が表示されません。
  3. : このオプションをオンにすると、式の結果を強制的に数値に変換します。式の結果が数字ではない(かつ空白でない)場合、式は NaN を返し、結果テーブルには空文字列が保存されます。

利用可能な設定値

  • オン
  • オフ(既定値)



合計を表示 (show_totals)

説明

オンにすると、行・列またはその両方の合計が表示されます。

合計は、数字のみオプションがオンの時だけ表示されます。

利用可能な選択肢

  • オフ(規定値)
  • 行と列



総計を表示 (show_grand_total)

説明

オンにすると、配列の右下に列または行の総計が表示されます。

総計は、数字のみオプションがオンの時だけ表示されます。

利用可能な設定値

  • オン
  • オフ(規定値)


統計

チャートの表示 (display_chart)

説明

この属性により、アンケート管理者は、アンケート参加者に対し、アンケート送信後に質問の結果を含むチャートを表示するかを選択することができます。

注意: 最後のページでグラフを表示するには、以下の設定をオンにする必要があります。


利用可能な設定値

  • オン
  • オフ(規定値)



チャートタイプ (chart_type)

説明

この属性により、アンケート管理者は、アンケート参加者に対し、アンケート送信後にどのようなチャートを表示するかを選択することができます。

注意: アンケート終了時にチャートを表示するには質問とアンケートの設定を変更する必要があります。詳細は、チャート表示属性に関するウィキセクションを参照してください。

利用可能な選択肢

  • 棒グラフ
  • 円グラフ
  • レーダー
  • ライン
  • 鶏頭図
  • ドーナツ