URL fields/ja: Difference between revisions
From LimeSurvey Manual
Bravehorse (talk | contribs) Created page with "==式==" |
Bravehorse (talk | contribs) No edit summary |
||
(48 intermediate revisions by 3 users not shown) | |||
Line 4: | Line 4: | ||
<span id="Introduction"></span> | |||
=はじめに= | =はじめに= | ||
URLフィールドパラメーターは、以下のケースで使用できます。 | URLフィールドパラメーターは、以下のケースで使用できます。 | ||
Line 11: | Line 13: | ||
* アンケートの開始URLフィールド | * アンケートの開始URLフィールド | ||
<span id="End_URL_field"></span> | |||
=終了URL= | =終了URL= | ||
アンケートの終わり、またはクオータによってアンケートが切断されるときに、終了URLを設定するオプションがあります。このURLは、最終ページでアンケートを終了した参加者に提示されるか、または設定により該当のURLに自動的にリダイレクトされるようにすることができます。利用するには、[[Text elements/ja|アンケートテキスト要素]]パネルで終了URLを入力し、[[Presentation/ja|表示]]パネルでアンケート完了時自動読込URLを有効にします。 | アンケートの終わり、またはクオータによってアンケートが切断されるときに、終了URLを設定するオプションがあります。このURLは、最終ページでアンケートを終了した参加者に提示されるか、または設定により該当のURLに自動的にリダイレクトされるようにすることができます。利用するには、[[Text elements/ja|アンケートテキスト要素]]パネルで終了URLを入力し、[[Presentation/ja|表示]]パネルでアンケート完了時自動読込URLを有効にします。 | ||
しかし、LimeSurveyは数多くのURLフィールドを使用できるようになっており、それによりアンケートの機能を強化することができます。 | |||
アンケートのサイドメニューで「アンケート参加者」に移動し、アンケートを「クローズ型」に変更し、トークンを持つ参加者を事前に追加すると、終了URLにトークンパラメーターが追加されます。 | |||
<span id="Basic_fields"></span> | |||
==基本的なフィールド== | ==基本的なフィールド== | ||
URLに'''{SAVEDID}'''、'''{TOKEN}'''、'''{SID}'''、'''{LANG}'''を使用できます。 | URLに'''{SAVEDID}'''、'''{TOKEN}'''、'''{SID}'''、'''{LANG}'''を使用できます。 | ||
Line 32: | Line 40: | ||
</code> | </code> | ||
<span id="Answer_fields"></span> | |||
==回答フィールド== | ==回答フィールド== | ||
'''{INSERTANS:SGQA}'''を使用することもできます。このURLフィールドでは、アンケートの特定の質問に対する回答を終了URLに追加することができます。これは、外部スクリプトに回答(アンケートで収集したメールアドレスなど)を送信する場合に便利です。 | |||
'''{INSERTANS:SGQA}'''、または[[ExpressionScript - Presentation/ja#Qcode.E5.A4.89.E6.95.B0.E3.81.AE.E5.91.BD.E5.90.8D|ExpressionScript変数]]を使用することもできます。このURLフィールドでは、アンケートの特定の質問に対する回答を終了URLに追加することができます。これは、外部スクリプトに回答(アンケートで収集したメールアドレスなど)を送信する場合に便利です。 | |||
例: | 例: | ||
<code><nowiki> | <code><nowiki> | ||
https://www.limesurvey.org/test.php?email={EMAILADDRESS} | |||
</nowiki></code> | </nowiki></code> | ||
アンケート参加者が回答を行う際、常に新しいセッションにするには、URLに"newtest/y"を追加します。 | |||
<code><nowiki> | <code><nowiki> | ||
https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y | https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y | ||
</nowiki></code> | </nowiki></code> | ||
このURLは、 pertains to a survey with ID = 48315、group =2、question=22、answercodes = 2007 および 2008という回答と関連しています。 | このURLは、 pertains to a survey with ID = 48315、group =2、question=22、answercodes = 2007 および 2008という回答と関連しています。 | ||
{{Note|"newtest/y"の必要性に関する詳細については、こちらの[https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not-using-newtest-y フォーラムスレッド]を参照してください。}} | |||
<span id="Expressions"></span> | |||
==式== | ==式== | ||
[[ExpressionScript - Presentation/ja|式]]を使うこともできます。 | |||
例: | |||
<code><nowiki> | <code><nowiki> | ||
Line 65: | Line 75: | ||
</nowiki></code> | </nowiki></code> | ||
<span id="Passthrough_fields"></span> | |||
==パススルーフィールド== | |||
パススルーフィールドを使用するには、パネル統合で変数名を定義しなければなりません。対象となる質問を割り当てない場合、変数は回答に保存されません(詳細は、LimeSurveyの[[Panel integration/ja|パネル統合]]機能を参照)。このパラメータを終了URLで使用するには、'''{PASSTHRU:<paramname>}'''タグを挿入します。ここで、''<paramname>''は入力パラメータの名前です。 | |||
"foobar"という名前の[[Panel integration/ja|パラメーター]]を定義したとしましょう。アンケートのリンクは、次のようになります。 | |||
<code> | <code> | ||
Line 75: | Line 88: | ||
</code> | </code> | ||
XYZ123はパスされる値です。 | |||
<code><nowiki>http://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code>という終了URLが<code><nowiki>http://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>に変換されます。 | |||
<span id="Start_URL"></span> | |||
=開始URL= | |||
= | <span id="Prefilling_a_survey_using_GET_parameters"></span> | ||
==GETパラメーターを使ってアンケート回答をプリセットする== | |||
[[Question_type_-_File_upload/ja|ファイルアップロード]]や[[Question type - Equation/ja|式の質問タイプ]]以外のすべての回答を事前にセットすることができます。パラメーターに[[ExpressionScript - Presentation/ja#.E9.96.A2.E6.95.B0.E3.81.B8.E3.81.AE.E3.82.A2.E3.82.AF.E3.82.BB.E3.82.B9|qcode名]]を使用し、択一の質問タイプに値をセットするか、[[SGQA identifier/ja|SGQA識別子]]を使用することができます。 | |||
回答をプリセットするには、単一選択の場合は、回答コードを使用する必要があります。複数選択の場合、回答を"チェック"するにはYを使用する必要があります。 | |||
開始URLの'''例''': | |||
* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : コードがQTEXTの質問の回答として<nowiki>'prefilled'</nowiki>がセットされます。 | |||
* <code><nowiki>http://ls.example.org/1234?MULTI_SQ001=prefilled</nowiki></code> {{NewIn/ja|v=3.14.1}} : タイトルがMULTIとなっている質問のサブ質問SQ001の回答を<nowiki>'prefilled'</nowiki>とする。 (例えば複数のテキスト質問向け) | |||
* <code><nowiki>http://ls.example.org/1234?single=-oth-&single_other=Other%20text</nowiki></code> {{NewIn/ja|v=3.14.1}} : 択一質問で「その他」をチェックし、その他に"Other text"と記入する。 | |||
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=prefilled</nowiki></code> : Fill the sub question SQ001 of question number 1 in group 1 with <nowiki>'prefilled'</nowiki> | |||
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=prefilled</nowiki></code> : グループ1、質問番号1のサブ質問SQ001の回答として<nowiki>'prefilled'</nowiki>がセットされます。 | |||
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=A1</nowiki></code> : グループ1、質問番号1のサブ質問SQ001で回答<nowiki>'A1'</nowiki>がチェックされます。 | |||
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=Y</nowiki></code> : グループ1、質問番号1でサブ質問SQ001がチェックされます。 | |||
{{Hint|Text= | {{Hint|Text=最初のGETパラメーターは"?"を使用します、それ以降のパラメータは "&"です。すでに"?"を含むURLにGETパラメータを追加するには"&"を使用する必要があります。}} | ||
{{Hint|Text= | {{Hint|Text=追加のGETパラメータは、アンケートが新たに始まるときにのみ入力されます。したがって、テスト段階では、newtest=Yを追加して新たなアンケートを開始させます。例: <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>}} | ||
{{Hint|Text=追加のGETパラメーターはアンケートを新たに開始するときのみ有効です。したがって、テストの際は、常にnewtest=Yを追加して新しいアンケートを開始します。例: <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>}} | |||
<span id="Prefilling_a_survey_using_GET_parameters_using_URL_parameters_tab"></span> | |||
==URLパラメータータブのGETパラメーターを使用したアンケートのプリセット== | |||
[[Panel integration/ja|パネル統合]]で設定できるURLパラメーターを使用して、あらかじめ回答をセットすることができます。 | |||
<span id="Prefilling_and_hiding_the_answer"></span> | |||
==回答のプリセットと非表示== | |||
非表示の詳細設定を使用して、質問を回答者から見えないようにすることができます。この場合でも、質問の回答はプリセットされています。 |
Latest revision as of 01:23, 13 April 2024
はじめに
URLフィールドパラメーターは、以下のケースで使用できます。
- アンケートの終了URLフィールド(アンケートテキストエレメントを参照)
- クオータルールのURLフィールド(詳細はアンケートクオータ)
- アンケートの開始URLフィールド
終了URL
アンケートの終わり、またはクオータによってアンケートが切断されるときに、終了URLを設定するオプションがあります。このURLは、最終ページでアンケートを終了した参加者に提示されるか、または設定により該当のURLに自動的にリダイレクトされるようにすることができます。利用するには、アンケートテキスト要素パネルで終了URLを入力し、表示パネルでアンケート完了時自動読込URLを有効にします。
しかし、LimeSurveyは数多くのURLフィールドを使用できるようになっており、それによりアンケートの機能を強化することができます。
アンケートのサイドメニューで「アンケート参加者」に移動し、アンケートを「クローズ型」に変更し、トークンを持つ参加者を事前に追加すると、終了URLにトークンパラメーターが追加されます。
基本的なフィールド
URLに{SAVEDID}、{TOKEN}、{SID}、{LANG}を使用できます。
- SAVEDIDは、アンケートの投稿ごとに割り当てられるIDです。
- TOKENは、アンケートで使用されたトークンです。
- SIDは、アンケートIDです。
- LANGは、言語コードです。
例:
http://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}
回答フィールド
{INSERTANS:SGQA}、またはExpressionScript変数を使用することもできます。このURLフィールドでは、アンケートの特定の質問に対する回答を終了URLに追加することができます。これは、外部スクリプトに回答(アンケートで収集したメールアドレスなど)を送信する場合に便利です。
例:
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
アンケート参加者が回答を行う際、常に新しいセッションにするには、URLに"newtest/y"を追加します。
https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y
このURLは、 pertains to a survey with ID = 48315、group =2、question=22、answercodes = 2007 および 2008という回答と関連しています。
式
式を使うこともできます。
例:
http://www.limesurvey.org/test.php?gender={if(sex=='Male','M','F')}&name;={name}
パススルーフィールド
パススルーフィールドを使用するには、パネル統合で変数名を定義しなければなりません。対象となる質問を割り当てない場合、変数は回答に保存されません(詳細は、LimeSurveyのパネル統合機能を参照)。このパラメータを終了URLで使用するには、{PASSTHRU:<paramname>}タグを挿入します。ここで、<paramname>は入力パラメータの名前です。
"foobar"という名前のパラメーターを定義したとしましょう。アンケートのリンクは、次のようになります。
http://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123
XYZ123はパスされる値です。
http://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}
という終了URLがhttp://www.limesurvey.org/test.php?foobarout=XYZ123
に変換されます。
開始URL
GETパラメーターを使ってアンケート回答をプリセットする
ファイルアップロードや式の質問タイプ以外のすべての回答を事前にセットすることができます。パラメーターにqcode名を使用し、択一の質問タイプに値をセットするか、SGQA識別子を使用することができます。
回答をプリセットするには、単一選択の場合は、回答コードを使用する必要があります。複数選択の場合、回答を"チェック"するにはYを使用する必要があります。
開始URLの例:
http://ls.example.org/1234?QTEXT=prefilled
: コードがQTEXTの質問の回答として'prefilled'がセットされます。http://ls.example.org/1234?MULTI_SQ001=prefilled
(3.14.1 から追加) : タイトルがMULTIとなっている質問のサブ質問SQ001の回答を'prefilled'とする。 (例えば複数のテキスト質問向け)http://ls.example.org/1234?single=-oth-&single_other=Other%20text
(3.14.1 から追加) : 択一質問で「その他」をチェックし、その他に"Other text"と記入する。http://ls.example.org/1234?1234X1X1SQ001=prefilled
: Fill the sub question SQ001 of question number 1 in group 1 with 'prefilled'http://ls.example.org/1234?1234X1X1SQ001=prefilled
: グループ1、質問番号1のサブ質問SQ001の回答として'prefilled'がセットされます。http://ls.example.org/1234?1234X1X1SQ001=A1
: グループ1、質問番号1のサブ質問SQ001で回答'A1'がチェックされます。http://ls.example.org/1234?1234X1X1SQ001=Y
: グループ1、質問番号1でサブ質問SQ001がチェックされます。
http://ls.example.org/1234?QTEXT=prefilled&newtest=Y
http://ls.example.org/1234?QTEXT=prefilled&newtest=Y
URLパラメータータブのGETパラメーターを使用したアンケートのプリセット
パネル統合で設定できるURLパラメーターを使用して、あらかじめ回答をセットすることができます。
回答のプリセットと非表示
非表示の詳細設定を使用して、質問を回答者から見えないようにすることができます。この場合でも、質問の回答はプリセットされています。