式マネージャー サンプルアンケート
From LimeSurvey Manual
はじめに
式マネージャーの使い方を学ぶベストな方法は、実際の例を試して、必要に合わせて変更することです。
以下のサンプルアンケートで、式マネージャーを使ってアンケートを強化する方法を確認し、テストすることができます。これらのアンケートは、配布されている LimeSurvey の /docs/demosurveys フォルダー内にあります。
出現条件、文言調整、式
概要
次の例では、各回答者の BMI（体格指数）を計算します。 この例で使用している機能は以下のとおりです。
式マネージャー機能のデモ
- 条件 - 強力な条件付きロジックのサポート。
- パイピング・文言調整 - 回答と質問メタデータのパイピングまたは文言調整が可能です。
- 動的文言調整 - 質問に答えると、ページ上でレポートが変更されます。
- 細かい文言調整 - if()文を使用した文およびレポートの条件付き文言調整
- 式 - 計算を非表示にしても計算を実行し、結果をデータベースに保存できる新しい質問タイプ #条件付き検証 - 最小許容値などの検証基準を条件式に基づいて設定できます。
- 条件検証 - 許容する最小値などの検証基準を、式にもとづくなど条件で処理できます。
スクリーンショット
この例では、体重と身長から太りすぎかどうかを判断する体格指数を計算します。最初は、次の4つの必須質問が表示されます。
情報を入力すると（メートル法またはそれ以外の単位を使用するかどうかも選択）、入力した内容の要約と体重の状態を示すレポートが表示されます。
ここでは、メートル法以外の単位を使用して、結果がどのように動的に変化するかを示す例を紹介します。
カスタムJavaScriptを使わずに、内部でデータをメートル法（必要な場合）に変換し、メートル法で身長、体重、BMI、および体重の状態をデータベースに格納する式タイプの質問があります。
次の例では、個別のレポート内で数学およびその他の関数を使用する方法を確認できます。これは、データを入力する前のページの様子です。未入力または数値以外が入力されている場合に"NaN"または"ゼロ除算"を表示するのではなく、空白のセルを表示するための条件付きロジックがあります。
数字が入力されると、ページ上のレポートが変化して、実行した計算とその結果が表示されます。
このサンプルアンケートには他にも多くの例があります。例えば、以下のスクリーンショットは、動的出現条件を使用したページの例を示しています。ヘルプテキストでは、さまざまな年齢層、特に矛盾する回答の組み合わせを試みることによって生成される面白いメッセージを見てください。また、複数の子供がいると回答した場合、"あなたの子供と一緒に楽しんでください"ではなく、"あなたのX人の子供たちと楽しんでください"というメッセージが表示されます。これは、文章を性別や数に合わせて簡単に微調整する方法を示しています。性別や数に基づいて、動詞や名詞を変化させることもできます。
ダウンロード
サンプルアンケートにアクセスするには、LS3_em_tailoring.zipリンクをクリックしてください。
サンプル調査
概要
これは、世帯に何人の人がいるかを尋ねる調査の例です。
グループレベルの出現条件を使って質問の"ループ"を簡単に実装する例を示しています。Person 1のグループを作成した後、そのグループをエクスポートします。SGQAコードの代わりにp1_nameのようなqcode変数名を使用していたので、テキストエディタを使ってグループを何度も素早く編集して再インポートできます（例えば、すべての変数に一意の変数名があり、グループレベルのロジックが正しくなるよう、繰り返しグループを編集して再インポートするのに約10秒かかります）。
質問のコピー機能もありますが、上記のオプションとほど速くはできません。
これは、アンケートが本当に終了するまで（たとえば、必要なすべてのグループが完了するまで）、終了メッセージが表示されないようにする方法も示しています。
EM機能のデモ
- Group-level relevance - The follow-up groups (Person 1-5) only show for up to the number of cohabitants specified;
- Tailoring - The final report summarizes the demographic data for each cohabitant;
- Progressive question display - Whether in group or all-in-one mode, subsequent questions only show as soon as the preceding ones are answered.
スクリーンショット
The survey generates a tailored report showing the demographics of the specified number of cohabitants:
If you switch to question-at-a-time mode, you see that the index tailors the questions. Since the user said that the person is a woman, it asks "What is her name". And since we answered "Mary", the next question says "How old is Mary"?
ダウンロード
To download the survey sample, click here: LS3_group_relevance.zip.
配列フィルターの入れ子
概要
このアンケートは、Joy Lane Research, LLCのアンケートデザインに基づいています。
スクリーンショット
次の点に着目してください。
- Q02は、Q01でチェックされた製品のセットのみを（array_filterを使用して）表示します
- Q02には、Q01の"その他の電子"フィールドに入力されたテキスト（"Another product"）も表示されます
- Q04は、Q02でチェックされた製品のみを表示します（配列フィルタの入れ子）
- Q05はQ02でチェックされていない製品を表示します（入れ子のarray_filter_excludeを使用）
ダウンロード
上の例をダウンロードするには、次のリンクをクリックしてください。 LS2_cascading_array_filterのアンケート例
すべての質問タイプと属性を使用したパイピング/文言調整
概要
変数の命名方法（SGQAやQcode）がわからなくても心配いりません。主なドキュメンテーションでは、Qcode変数名の作成方法について説明していますが、実際のデモを見るのが一番です。このアンケートでは、式マネージャーを使用して質問の属性と回答にアクセスする方法を示します。
この例では、このアンケートを編集する際、組み込みのHTMLエディターをオフにする（またはポップアップモードに変換する）ことをお勧めします。HTMLエディターが大きなHTMLレポートを編集モードで表示するには、1分以上かかることがあります。
コンテンツ
- すべての質問タイプの例
- "その他"を使用できるすべての質問タイプが含まれているので、変数命名にどのように影響するかを見ることができます
- 既定値を受け入れるすべての質問タイプの既定値
- 文言調整 - ページ内、および別ページのレポートには、16種類のEMドット表記の接尾辞がすべて表示されています
- これらのレポートには、現在入力されているすべてのデータが表示されます（回答画面印刷の代わりに印刷用レポートを生成する方法がわかります）
- すべての変数に対するQcodeとSGQAによる適切な命名
スクリーンショット
これは巨大なアンケートであるため、スクリーンショットを表示しないことにしました。ダウンロードして確かめてください。
ダウンロード
アンケートをダウンロードするには、次のリンクをクリックしてください。 LS3_EM_question_attributes.lss
従来型の検証
概要
これは、式を使用するすべての検証タイプと、検証をサポートする質問タイプにどのように影響するかを示すものです。多くの場合、検証ヒントは非表示であり、検証基準に適合しなかった場合にのみ表示されます（したがって、検証基準に適合すると消えます）。
デモで使われている検証タイプ
- min_num_value_n - 回答の最小値
- max_num_value_n - 回答の最大値
- min_answers - 回答数の下限
- max_answers 回答数の上限
- multiflexible_min - 回答の最小値（マルチフレックスナンバー質問タイプの場合）
- multiflexible_max - 回答の最大値（ドロップダウン質問タイプの場合）
- min_num_value - 質問に対する全回答の合計の最小値
- max_num_value - 質問に対する全回答の合計の最大値
- equals_num_value - 質問に対する全回答の合計と一致すべき数値
- validation - 質問の正規表現検証で、個々のセルに適用可能
スクリーンショット
新しいCSSスタイルを使用すると、それぞれの検証タイプに別々のヒントが表示されます。表示されている場合は、hide_tipオプションで非表示にすることができます。既定では、質問が検証基準に適合しなかった場合は赤いフォントで表示し、検証基準に適合した場合は緑で表示します。
ユーザーは検証エラーのあるページを送信できません。間違った情報を入力した場合、すぐに警告されます。
この例のように、配列内の個々のセルで検証することができます。この例では、正規表現検証により、各エントリーが適切にフォーマットされた米国の電話番号（市外局番を含む）であることが保証されています。
ダウンロード
上の例をダウンロードするには、LS3_Validation_tests.zipをクリックしてください。
検証式
概要
場合によっては、従来の最小/最大基準を使用しても達成できないカスタム検証が必要な場合もあります。このためには、質問レベルあるいはサブ質問レベルで複雑な検証式を構築できるem_validation_qやem_validation_sqオプションを使用する必要があります。
サブ質問レベルでは、変数名を知らなくても配列内の各セルを簡単に検証できるよう、"this"変数も導入されています。詳細については、こちらをクリックしてください。
EM機能のデモ
- em_validation_q - 質問全体が有効かを決定する式です。
- em_validation_q_tip - 質問がem_validation_qの条件に適合しない場合に表示するメッセージです。
- em_validation_sq - 各サブ質問（配列のセル）が有効かを決定する式です。
- em_validation_sq_tip - サブ質問のいずれかが有効でない場合に表示されるメッセージです。
一般に、em_validation_sqを使用すると、無効なセルがあればそのセルの背景色が赤色に変わり、エラーがあることを示します。
スクリーンショット
この質問では、検証式を適用して、子供の年齢を降順で入力するようにしています。
q1_sq1 >= q1_sq2 && q1_sq2 >= q1_sq3 && q1_sq3 >= q1_sq4
以下の例では、検証式を適用することによって、指定された行について、回答された質問の数が3つ以下になるようになります。
(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= 3) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= 3) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= 3)
これを以下のように書くこともできます。LimeSurveyは実行時に自動的に上記の式に変換します。
(sum(self.sq_A) <= 3) && (sum(self.sq_B) <= 3) && (sum(self.sq_C) <= 3)
ダウンロード
上記の例で使用したアンケートサンプルをダウンロードするには、ls2_test_em_sq_validation.lssリンクをクリックしてください。
サブ質問の出現条件
概要
これは、array_filterと検証基準がどのように相互作用するかを示しています。合計に適用される検証では、出現条件を満たす（可視の）値のみが考慮されます。
EM機能のデモ
また、コアの質問で回答された質問の数を動的にレポートします。
スクリーンショット
可視行の数を変更すると、合計が動的に変更されます。サブ質問を出現条件を満たさないとマークしても、値はクリアされませんが、いかなる式にも影響しません。
最初の質問"どの行が下に表示されるべきか"について、"5番目のサブ質問"をチェックするとどうなるか確認してください。 2番目の"Enter some numbers（何か数字を入力してください）"という質問の合計が5になっていることに注意してください。その質問のサブ質問5の値はまだ14です（ここで、サブ質問5のチェックを外すと、14の値が再び表示されます）。その値は現在のところ出現条件を満たさないので合計に寄与しません。送信時に出現していないとき項目のデータはすべてクリアされますが（データベースではNULLに設定されます）、ユーザーが回答を変更する必要がある場合に備えて、ページ内で保持されています。
ダウンロード
この例をダウンロードするにはここをクリックしてください。 ls2_subquestion_relevance.lss
カンマを小数点として使用する
概要
式マネージャーは、有効な数値のみを数値フィールドに入力できるようにします。無効な数値を入力すると、何かが間違っていることが警告されます（fruityテーマの場合、質問全体が「赤色」になります）。
数値は常に、データベース内の小数点記号としてピリオドを使用したものに変換されることに注意してください。これにより、統計分析が適切に機能します。
小数点記号を変更するには、設定タブにあるテキストエレメントオプションにアクセスし、小数点で設定してください。
小数点について、詳細はこちらをクリックしてください。
小数点記号を使用する質問の種類
- 数値入力 [N]
- 複数数値入力 [K]
- 配列（数値） [:]
- 配列（テキスト） [;]でnumbers_only属性を使用する場合
- リスト（ラジオ） [L]でother_numbers_only属性を使用する場合
- 短いフリーテキスト [S]でnumbers_only属性を使用する場合
- 複数の短いテキスト [Q]で numbers_only属性を使用する場合
- 複数選択 [M]で other_numbers_only属性を使用する場合
- コメント付きの複数選択 [P]でother_numbers_only属性を使用する場合
スクリーンショット
以下のスクリーンショットではカンマを小数点記号として使用する例を確認できます。
ダウンロード
上記の例をダウンロードするには、次のリンクをクリックします。 ls2_comma_as_radix_separator.lss
グループのランダム化
概要
このアンケートでは、random_group属性を使用する方法を示します。
この属性を使用すると、アンケートを開始するたびに質問の順序がランダム化されます。ただし、ひとたびアンケートが開始されれば、言語を変更してもランダム化の順序は固定されたままになります。
スクリーンショット
以下の例を一緒にチェックしてみましょう。最初のページのランダム化された質問は、Q1、Q4、Q7になります。2番目のページのランダム化された質問は、Q2、Q5、Q8になります。
このアンケートを初めてテストしたときにランダム化が行われました。
2回目にアンケートをテストしたときは、ランダム化の結果が異なります。
しかし、（アンケートを再開せずに）フランス語に切り替えても、ランダム化された順序はそのまま残りました。
ダウンロード
上記の例をダウンロードするには、次のリンクをクリックしてください。 Randomization_Group_Test.lss
グループごとにランダムに質問する
概要
このアンケートでは、グループごとに質問をランダムに表示するようにアンケートを設定する方法を示します。アンケートの中にはそれぞれ6つの質問からなる5つのグループがあります。当初、グループ0には、ask1-ask5と呼ばれる隠された式タイプの質問が5つ設定されています。それぞれの質問テキストフィールドには{floor(rand(1,6.9999))}という値が設定されています。つまり、ask1-ask5変数の値はそれぞれ1〜6になります。次に、グループ内の各質問には"ask1==N"（Nはグループ内のN番目の質問を指す）のような出現条件の式があります（グループ1の3番目の質問は出現条件の式"ask1==3"を持つ）。
このアンケートは、1ページにすべての質問を配置するモード、グループごとにページを変えるモード、質問ごとにページを変えるモードそれぞれで同じように機能します。ランダム化は最初のグループに設定され、そのグループは実際は隠されており（ask1-ask5の質問のすべてが隠されているため）、ランダム化は回答者ごとに同じままです。別の回答者は、これとは異なるランダム化が実行されます。
機能のデモ
- 式質問タイプ
- ランダム化関数
- 条件（if）関数
スクリーンショット
これはGroup0で、式質問タイプを使用して、各グループ（4つの質問のみを持つ最後のグループを除く）ごとに1から6までのランダム値を選択します。"if()"関数は、まずask1がすでに設定されているかどうかをチェックし、そうであれば、その値を使用することに注意してください。値が設定されていない場合は、ランダム値を使用してask1の値を設定します。
このグループは、Group0の変数（ask4）を使用して、4つめのグループ内でどの質問が表示されるかを制御する方法を示しています。
ダウンロード
このアンケートの例をダウンロードするには、こちらをクリックしてください。 Random questions within a group survey example
グループ（質問のサブセット）内の特定の数の質問をランダムに質問する
これは、1つのグループのすべてのランダム化された質問で、グループごと改ページまたは全質問1ページのフォーマットが使用されている場合にのみ適用されます。
概要
このアンケートでは、グループ内の質問のサブセットからランダムに尋ねる方法を示します。たとえば、グループ内にある10の質問のうち5つをランダムに質問します。
アンケートには10の質問を含む1つのグループがあります。すべての質問には同じランダム化グループ名が割り当てられます。これにより、ページの読み込み時にランダムな順序で表示されます。各質問には、グループ内の他のすべての質問の"relevanceStatus"の合計が、表示する質問の数よりも少なくなるような出現条件の式が与えられます。質問がレンダリングされるときに、relevanceStatusが割り当てられているので、先行する質問の数を適切に合計します。
したがって、10のうち5つ質問する例では、Q1の方程式は次のようになります。
sum(Q2.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5
Q2の場合は、次のようになります。
sum(Q1.relevanceStatus, Q3.relevanceStatus, Q4.relevanceStatus, Q5.relevanceStatus, Q6.relevanceStatus, Q7.relevanceStatus, Q8.relevanceStatus, Q9.relevanceStatus, Q10.relevanceStatus) LT 5
以下同様。
機能のデモ
ダウンロード
この例をダウンロードするには、次のリンクをクリックしてください。 Random 5 out of 10 survey example
ユーザが入力した商品リストの順位付け
概要
以下の例は、ユーザーが関心を持つであろう一連の製品をリストとして提示し、それらの製品を評価（順位付け）させる方法を示しています。
EM機能のデモ
- 回答の文言調整 - 商品を評価するとき、ラベルは前の複数選択質問のコメントフィールドから引用します
- 尺度の調整 - 尺度の見出しのような高度な質問オプションの文言の調整できます。
スクリーンショット
この画像は、前の質問で製品1、3、5が選択されているとき、array_filter属性を使用してその3つしか表示されないことを示しています。さらに、2番目の質問の行ラベルは、製品番号（コメントフィールドに何も入力されていない場合）またはコメントフィールドの内容になっています。
この画像は、質問文がどのように調整されるかを示しています。
これは、その質問に対するロジックファイルの表示です。これにより、条件付きロジックが必要に応じて動作することを確認できます（構文エラーがないかどうかなど）。
次の画像には、5点の評価尺度（オプション1-5）、尺度のタイトル、および評価したい製品を指定したグループが表示されています。最後の質問は、配列の質問の各々を調整できることを示しています。
次の画像は、最後の質問の論理ファイルビューを示しています。ご覧のように、サブ質問、回答、尺度のヘッダーを調整することができます。
ダウンロード
この例をダウンロードするには、次のリンクをクリックしてください。Rating user-entered list of products survey example