Actions

URL-Felder

From LimeSurvey Manual

Revision as of 07:01, 13 July 2023 by Maren.fritz (talk | contribs) (Created page with "Im obigen Szenario bezieht sich die URL auf eine Umfrage mit der ID = 48315, der Gruppe =2, der Frage=22 und den Antwortcodes = 2007 und 2008.")


Einleitung

URL-Feldparameter können im:


End-URL Feld

„Am Ende einer Umfrage oder wenn ein Kontingent dazu führt, dass eine Umfrage beendet wird“, besteht die Möglichkeit, eine End-URL festzulegen. Diese URL wird dem Teilnehmer, der die Umfrage beendet hat, auf der Endseite angezeigt oder Sie können optional einstellen, dass der Teilnehmer automatisch auf die entsprechende URL weitergeleitet wird. Dies kann durch Ausfüllen der End-URL-Option im Bereich Textelemente der Umfrage und durch Aktivieren des automatischen Ladens der End-URL aus dem Bereich Präsentation erfolgen, sobald eine Umfrage abgeschlossen ist.

LimeSurvey bietet jedoch die Möglichkeit, URL-Felder auf viele andere Arten zu verwenden, wodurch Sie wiederum die Funktionalität Ihrer Umfrage verbessern können.


Grundlegende Felder

Sie können '{SAVEDID}, '{TOKEN}, '{SID} und '{LANG} in der End-URL:!N verwenden !*SAVEDID ist die dieser bestimmten Einreichung zugewiesene ID;

  • TOKEN ist das Token, mit dem an der Umfrage teilgenommen wird;
  • SID ist die Umfrage-ID;
  • LANG ist der Sprachcode.

Zum Beispiel:

https://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}


Antwortfelder

Sie können auch ''{INSERTANS:SGQA} oder ExpressionScript-Variablen verwenden. Mit diesem URL-Feld können Sie die Antwort auf eine bestimmte Frage in der Umfrage in die End-URL einfügen. Dies kann nützlich sein, um eine Antwort an ein externes Skript (z. B. eine während der Umfrage erfasste E-Mail-Adresse) zu senden.

Zum Beispiel:

https://www.limesurvey.org/test.php?email={EMAILADDRESS}

Es ist wichtig, „newtest/y“ zur URL hinzuzufügen, um eine neue Sitzung zu erzwingen, wann immer Ihre Umfrageteilnehmer Ihre Umfrage ausfüllen möchten.

https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y

Im obigen Szenario bezieht sich die URL auf eine Umfrage mit der ID = 48315, der Gruppe =2, der Frage=22 und den Antwortcodes = 2007 und 2008.

For more details on the necessity of "newtest/y", check the following forum thread.

Expressions

You can also use any expression here.

For example:

http://www.limesurvey.org/test.php?gender={if(sex=='Male','M','F')}&name;={name}


Passthrough fields

To use passthrough fields, you must define the variable names via panel integration. If you don't assign a target question, the variables will not be saved into responses (read more about the LimeSurvey 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 a parameter named "foobar". The survey is started with a link like this one:

https://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123

The XYZ123 is the value you want "to pass".

The end URL of a survey with the following URL https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar} would then be converted to https://www.limesurvey.org/test.php?foobarout=XYZ123

Start URL

Prefilling a survey using GET parameters

You can prefill all answers except the upload and equation question type. You can use qcode naming for parameters and set the value for single question types or use the SGQA identifier.

Then, answers are set to the prefilled 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 prefill the answer.

Here are some start URL examples:

  • http://ls.example.org/1234?QTEXT=prefilled : Fill in the question with code QTEXT with 'prefilled'
  • https://ls.example.org/1234?MULTI_SQ001=prefilled (New in 3.14.1 ) : Fill in the subquestion SQ001 of question with title MULTI with 'prefilled' (for a multiple text question for example).
  • https://ls.example.org/1234?single=-oth-&single_other=Other%20text (New in 3.14.1 ) : Select the "other" answer option of a single choice question and fill in the other value with the text "Other text".
  • https://ls.example.org/1234?1234X1X1SQ001=prefilled : Fill in the subquestion SQ001 of question with ID: 1 from group with ID: 1 with 'prefilled'
  • https://ls.example.org/1234?1234X1X1SQ001=A1 : Preselect the answer option 'A1' of the subquestion SQ001 of question with ID: 1 from group that has ID: 1.
  • https://ls.example.org/1234?1234X1X1SQ001=Y : Preselect the subquestion SQ001 of the question that has the ID 1, from the group that has ID: 1.


 Hint: 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.


 Hint: The extra GET parameters are only filled in when the survey starts anew. Therefore, for testing, always add newtest=Y to start a fresh survey. For example: http://ls.example.org/1234?QTEXT=prefilled&newtest=Y


Prefilling a survey using GET parameters using URL parameters tab

You can prefill (sometimes easier) answers using URL parameters which can be configured in panel integration.


Prefilling and hiding the answer

You can use the hidden attribute of a question to hide it from your respondents. If so, the question still remains prefilled.