Actions

URL fields/ja: Difference between revisions

From LimeSurvey Manual

(Created page with "式マネージャーの式を使うことまできます。")
No edit summary
(42 intermediate revisions by 3 users not shown)
Line 5: Line 5:


=はじめに=
=はじめに=


URLフィールドパラメーターは、以下のケースで使用できます。
URLフィールドパラメーターは、以下のケースで使用できます。
Line 10: Line 11:
* クオータルールのURLフィールド（詳細は[[Survey quotas/ja|アンケートクオータ]]）
* クオータルールのURLフィールド（詳細は[[Survey quotas/ja|アンケートクオータ]]）
* アンケートの開始URLフィールド
* アンケートの開始URLフィールド


=終了URL=
=終了URL=


アンケートの終わり、またはクオータによってアンケートが切断されるときに、終了URLを設定するオプションがあります。このURLは、最終ページでアンケートを終了した参加者に提示されるか、または設定により該当のURLに自動的にリダイレクトされるようにすることができます。利用するには、[[Text elements/ja|アンケートテキスト要素]]パネルで終了URLを入力し、[[Presentation/ja|表示]]パネルでアンケート完了時自動読込URLを有効にします。
アンケートの終わり、またはクオータによってアンケートが切断されるときに、終了URLを設定するオプションがあります。このURLは、最終ページでアンケートを終了した参加者に提示されるか、または設定により該当のURLに自動的にリダイレクトされるようにすることができます。利用するには、[[Text elements/ja|アンケートテキスト要素]]パネルで終了URLを入力し、[[Presentation/ja|表示]]パネルでアンケート完了時自動読込URLを有効にします。


ただし、このURLの機能を拡張するために使用できるフィールドがいくつかあります。
しかし、LimeSurveyは数多くのURLフィールドを使用できるようになっており、それによりアンケートの機能を強化することができます。




==基本的なフィールド==
==基本的なフィールド==


URLに'''{SAVEDID}'''、'''{TOKEN}'''、'''{SID}'''、'''{LANG}'''を使用できます。
URLに'''{SAVEDID}'''、'''{TOKEN}'''、'''{SID}'''、'''{LANG}'''を使用できます。
Line 31: Line 35:
<nowiki>http://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}</nowiki>
<nowiki>http://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}</nowiki>
</code>
</code>


==回答フィールド==
==回答フィールド==


'''{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>
http://www.limesurvey.org/test.php?email={INSERTANS:1234X56X7}
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
</nowiki></code>
</nowiki></code>


 
アンケート参加者が回答を行う際、常に新しいセッションにするには、URLに"newtest/y"を追加します。
ただし、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という回答と関連しています。  


（参考: https://www.limesurvey.org/forum/can-i-do-this-with-limesurvey/115371-prefilling-survey-answers-using-the-survey-url-version-3）
{{Note|"newtest/y"の必要性に関する詳細については、こちらの[https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not-using-newtest-y フォーラムスレッド]を参照してください。}}


==式==
==式==


[[Expression Manager/ja|式マネージャー]]の式を使うことまできます。


For example:
[[ExpressionScript - Presentation/ja|式]]を使うこともできます。
 
例:


<code><nowiki>
<code><nowiki>
Line 65: Line 69:
</nowiki></code>
</nowiki></code>


==Passthrough fields==


To use passhtrough fields, you have to define any additional parameters that should be passed into the end URL in the survey settings (read more about the LimeSurvey [[Panel integration|panel integration]] feature). To use such a parameter in the end URL, just insert the tag '''{PASSTHRU:<paramname>}''' where ''<paramname>'' is the name of your input parameter.
==パススルーフィールド==


Let's suppose that you defined [[Panel integration|a parameter]] named "foobar". The survey is started with a link like
 
パススルーフィールドを使用するには、パネル統合で変数名を定義しなければなりません。対象となる質問を割り当てない場合、変数は回答に保存されません（詳細は、LimeSurveyの[[Panel integration/ja|パネル統合]]機能を参照）。このパラメータを終了URLで使用するには、'''{PASSTHRU:<paramname>}'''タグを挿入します。ここで、''<paramname>''は入力パラメータの名前です。
 
"foobar"という名前の[[Panel integration/ja|パラメーター]]を定義したとしましょう。アンケートのリンクは、次のようになります。


<code>
<code>
Line 75: Line 81:
</code>
</code>


The XYZ123 is the value you want "to pass".
XYZ123はパスされる値です。


The end URL of a survey with the following URL <code><nowiki>http://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> would then be converted to <code><nowiki>http://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>
<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>に変換されます。


=開始URL=


{{Alert|title=Attention|text=Please note that the passthrough fields can be used only with LimeSurvey 2.x or later!}}


=Start URL=
==GETパラメーターを使ってアンケート回答をプリセットする==




==Prefilling a survey using GET parameters==
[[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識別子]]を使用する必要があります。


You can prefill all answer except upload and equation question type. You can use [[Expression Manager#Access to Variables|qcode naming]] for the parameters and set the value for single question types. For multiple question type, you must use a [[SGQA identifier]].
回答をプリセットするには、単一選択の場合は、回答コードを使用する必要があります。複数選択の場合、回答を"チェック"するにはYを使用する必要があります。


Then answer are set to the pre-filled value, for single choice option, you must use the code of the answer, for multi choice question, you must use Y if you want to check the answer.
開始URLの'''例''':


Here are some start URL '''examples''':
* <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=最初のGETパラメーターは"?"を使用します、それ以降のパラメータは "&"です。すでに"?"を含むURLにGETパラメータを追加するには"&"を使用する必要があります。}}
{{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>}}


* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Fill the question with code Q1 with <nowiki>'prefilled'</nowiki>
* <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=A1</nowiki></code> : Check the answer <nowiki>'A1'</nowiki> at the sub question SQ001 of question  number 1 in group 1 .
* <code><nowiki>http://ls.example.org/1234?1234X1X1SQ001=Y</nowiki></code> : Check the  sub question SQ001 at question  number 1 in group 1.


{{Hint|Text=GET parameters use "?" for the first parameter and "&" for the subsequent ones. If you already have "?" in your URL, you must use "&" to add more GET parameters.}}
==URLパラメータータブのGETパラメーターを使用したアンケートのプリセット==
{{Hint|Text=The extra GET parameters are only filled when the survey starts anew. Therefore, for testing, always add newtest=Y to start a fresh survey. For example: <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>}}




==Prefilling a survey using GET parameters using URL parameters tab==
[[Panel integration/ja|パネル統合]]で設定できるURLパラメーターを使用して、あらかじめ回答をセットすることができます。


You can prefill (sometimes easier) answers using URL parameters which can be configured in the [[Panel integration|panel integration]].


==回答のプリセットと非表示==


==Prefilling and hiding the answer==


You can use hidden advanced settings to hide the question from your respondents. If so, the question still remains prefilled.
非表示の詳細設定を使用して、質問を回答者から見えないようにすることができます。この場合でも、質問の回答はプリセットされています。

Revision as of 01:02, 22 May 2020

Other languages:


はじめに

URLフィールドパラメーターは、以下のケースで使用できます。


終了URL

アンケートの終わり、またはクオータによってアンケートが切断されるときに、終了URLを設定するオプションがあります。このURLは、最終ページでアンケートを終了した参加者に提示されるか、または設定により該当のURLに自動的にリダイレクトされるようにすることができます。利用するには、アンケートテキスト要素パネルで終了URLを入力し、表示パネルでアンケート完了時自動読込URLを有効にします。

しかし、LimeSurveyは数多くの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という回答と関連しています。

"newtest/y"の必要性に関する詳細については、こちらのフォーラムスレッドを参照してください。

式

式を使うこともできます。

例:

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がチェックされます。


 Hint: 最初のGETパラメーターは"?"を使用します、それ以降のパラメータは "&"です。すでに"?"を含むURLにGETパラメータを追加するには"&"を使用する必要があります。
 Hint: 追加のGETパラメータは、アンケートが新たに始まるときにのみ入力されます。したがって、テスト段階では、newtest=Yを追加して新たなアンケートを開始させます。例: http://ls.example.org/1234?QTEXT=prefilled&newtest=Y


 Hint: 追加のGETパラメーターはアンケートを新たに開始するときのみ有効です。したがって、テストの際は、常にnewtest=Yを追加して新しいアンケートを開始します。例: http://ls.example.org/1234?QTEXT=prefilled&newtest=Y


URLパラメータータブのGETパラメーターを使用したアンケートのプリセット

パネル統合で設定できるURLパラメーターを使用して、あらかじめ回答をセットすることができます。


回答のプリセットと非表示

非表示の詳細設定を使用して、質問を回答者から見えないようにすることができます。この場合でも、質問の回答はプリセットされています。

Retrieved from "http://manual.limesurvey.org/index.php?title=URL_fields/ja&oldid=151515"