Actions

QS

Em validation q/ja: Difference between revisions

From LimeSurvey Manual

(Created page with "{{Hint|Text=LimeSuveyは正規表現にPerlの構文を使用しますので 始めと終わりが/(スラッシュ)になります。}} </onlyinclude>")
No edit summary
 
(11 intermediate revisions by 2 users not shown)
Line 3: Line 3:


===質問の検証式 (em_validation_q) ===
===質問の検証式 (em_validation_q) ===


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


The main difference between this feature and the subquestion validation equations ([[QS:Em_validation_sq|em_validation_sq option]]) is that for this feature, if the question (or question parts) fail validation, then an error message could be shown. For the subquestion validation, each text entry cell (e.g., in an array question type, but it can also be applied to single entry question types) will be styled so that the background color is (light) red.
本機能とサブ質問の検証式([[QS:Em_validation_sq|em_validation_sq オプション]])との大きな違いは、質問または質問の一部が検証エラーとなると、エラーメッセージが表示される点です。サブ質問の検証式では、それぞれのテキスト入力欄(例えば配列質問タイプにおいてですが、単一入力する質問タイプでも機能します)の背景が(薄い)赤色になります。


'''有効な値'''
'''有効な値'''


*[[Expression Manager/ja|式マネージャー]]の構文に従うすべての式(中括弧は外す)。
*[[ExpressionScript - Presentation/ja|ExpressionScript]]の構文に従うすべての式(中括弧は外す)。


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


The validation tip only shows the warning message if the phone or email appears invalid.
電話番号やメールアドレスが無効な場合、検証TIPはワーニングメッセージだけ表示します。


{{Hint|Text=より複雑な検証メッセージを作成する場合は、[[Expression Manager/ja|式マネージャー]]の使用方法を参照してください。}}
{{Hint|Text=より複雑な検証メッセージを作成する場合は、[[ExpressionScript - Presentation/ja|ExpressionScript]]の使用方法を参照してください。}}


LimeSurveyに上記の例をインポートする場合は、この.lsqファイルをダウンロードしてください。[[Media:Em validation q example.zip|Em_validation_q_example.zip]]
LimeSurveyに上記の例をインポートする場合は、この.lsqファイルをダウンロードしてください。[[Media:Em validation q example.zip|Em_validation_q_example.zip]]
Line 46: Line 47:
</onlyinclude>
</onlyinclude>


[[Category:Question Settings]][[Category:Question Logic Options]]
[[Category:Question Settings/ja]][[Category:Question Logic Options]]
 
 
わずかに異なる別の例が下からダウンロードできます。この例は、3つのサブ質問フィールドのすべてを空にはできず、少なくとも1つ(対応する正規表現に従って)記入しなければならないというものです。質問は[[Media:Limesurvey_question_id_question_validation.zip|こちら]]からダウンロードしてください。

Latest revision as of 01:07, 22 May 2020


質問の検証式 (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の構文を使用しますので 始めと終わりが/(スラッシュ)になります。


わずかに異なる別の例が下からダウンロードできます。この例は、3つのサブ質問フィールドのすべてを空にはできず、少なくとも1つ(対応する正規表現に従って)記入しなければならないというものです。質問はこちらからダウンロードしてください。