Actions

URL fields/de: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
(Updating to match new version of source page)
 
(42 intermediate revisions by 3 users not shown)
Line 4: Line 4:




=Introduction=
=Einleitung=


URL fields parameters can be used in the:
 
* End URL field of the survey (see the [[Survey texts|survey texts wiki section]]);
URL-Feldparameter können im:
* URL field of the quota rule (read more about [[Survey quotas|survey quotas here]])
* [[URL_fields#End_URL_field|End URL]]-Feld der Umfrage (siehe [[Textelemente|Umfragetextelemente]])  
* Start URL field of the survey.
* URL-Feld der Kontingentregel verwendet werden (Lesen Sie mehr über Umfragequoten [[Umfragequoten|hier]])
* [[URL_fields#Start_URL|Start-URL]] Feld der Umfrage (siehe [[Textelemente|Umfragetextelemente]]).




==End-URL Feld==
==End-URL Feld==


At the end of a survey or when a quota causes a survey to terminate, there is the option to set an ending URL. This URL is presented to the participant who has finished the survey on the end page or you can optionally set the participant to be automatically redirected to the respective URL. This can be done by filling in the End URL option from the [[Survey texts]] panel and by enabling the automatic load of the end URL from the [[Presentation]] panel once a survey is completed .


However, there are a number of fields available to be used to enhance the functionality of this URL.
„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|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.
 
If you go to “Survey participants” in the survey side menu and change the survey to be in “closed access mode“, after pre adding participants there with each having a token, the token parameter will be added in the end url.


==Grundlegende Felder==


==Basic fields==


You can use '''{SAVEDID}''', '''{TOKEN}''', '''{SID}''' and '''{LANG}''' in this URL:
Sie können ''''{SAVEDID}'', ''''{TOKEN}'', ''''{SID}'' und ''''{LANG}'' in der End-URL:!N verwenden !*'''SAVEDID''' ist die dieser bestimmten Einreichung zugewiesene ID;
*'''SAVEDID''' is the id assigned to this particular submission;
*'''TOKEN''' ist das Token, mit dem an der Umfrage teilgenommen wird;
*'''TOKEN''' is the token used to participate in the survey;
*'''SID''' ist die Umfrage-ID;
*'''SID''' is the survey ID;
*'''LANG''' ist der Sprachcode.
*'''LANG''' is the language code.


For example:
Zum Beispiel:


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


==Answer fields==


You can also use '''{INSERTANS:SGQA}'''. This URL field allows you to add the response to a specific question in the survey into the end URL. This can be useful for sending a response to an external script (ie an email address collected during the survey).
==Antwortfelder==
 
 
Sie können auch ''''{INSERTANS:SGQA}'' oder [[ExpressionScript - Presentation#Qcode_Variable_Naming|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:
 
<code><nowiki>
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
</nowiki></code>


For example:
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.


<code><nowiki>
<code><nowiki>
http://www.limesurvey.org/test.php?email={INSERTANS:1234X56X7}
https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y
</nowiki></code>
</nowiki></code>


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.
{{Hinweis|Weitere Einzelheiten zur Notwendigkeit von „newtest/y“ finden Sie unter [https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not -using-newtest-y Forenthread].}}
==Ausdrücke==


==Expressions==


You can also use any [[Expression Manager|Expression Manager]] expression here.
Sie können hier auch einen beliebigen [[ExpressionScript - Presentation|expression]] verwenden.


For example:
Zum Beispiel:


<code><nowiki>
<code><nowiki>
Line 54: 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.
==Passthrough-Felder==
 
 
Um Passthrough-Felder zu verwenden, müssen Sie die Variablennamen über die Panel-Integration definieren. Wenn Sie keine Zielfrage zuweisen, werden die Variablen nicht in Antworten gespeichert (lesen Sie mehr über die LimeSurvey-Funktion [[Panel-Integration|Panel-Integration]]). Um einen solchen Parameter in der End-URL zu verwenden, fügen Sie einfach das Tag ''''{PASSTHRU:<paramname> }''' Wo ''<paramname> '' ist der Name Ihres Eingabeparameters.


Let's suppose that you defined [[Panel integration|a parameter]] named "foobar". The survey is started with a link like
Nehmen wir an, Sie haben einen [[Panel-Integration|Parameter]] mit dem Namen „foobar“ definiert. Die Umfrage wird mit einem Link wie diesem gestartet:


<code>
<code>
<nowiki>http://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123</nowiki>
<nowiki>https://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123</nowiki>
</code>
</code>


The XYZ123 is the value you want "to pass".
Der XYZ123 ist der Wert, den Sie „übergeben“ möchten.
 
Die End-URL einer Umfrage mit der folgenden URL<nowiki> <code>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</code></nowiki> würde dann umgewandelt werden<nowiki> <code>https://www.limesurvey.org/test.php?foobarout=XYZ123</code></nowiki>
 
=Start-URL=
 


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>
==Eine Umfrage mit GET-Parametern vorab ausfüllen==




{{Alert|title=Attention|text=Please note that the passthrough fields can be used only with LimeSurvey 2.x or later!}}
Sie können alle Antworten mit Ausnahme des Fragetyps [[Question_type_-_File_upload|upload]] und [[Fragetyp - Gleichung|Gleichungsfragetyp]] vorab ausfüllen. Sie können [[ExpressionScript – Presentation#Access to Variables|qcode naming]] für Parameter verwenden und den Wert für einzelne Fragetypen festlegen oder den [[SGQA-Bezeichner]] verwenden.


=Start URL=
Anschließend werden die Antworten auf den vorausgefüllten Wert gesetzt. Für die Single-Choice-Option müssen Sie den Code der Antwort verwenden, für die Multi-Choice-Frage müssen Sie Y verwenden, wenn Sie die Antwort vorausfüllen möchten.


Hier sind einige Beispiele für Start-URLs:


==Prefilling a survey using GET parameters==
*<nowiki> <code>http://ls.example.org/1234?QTEXT=prefilled</code></nowiki> : Füllen Sie die Frage mit dem Code QTEXT aus<nowiki> 'vorbefüllt'</nowiki>
*<nowiki> <code>https://ls.example.org/1234?MULTI_SQ001=prefilled</code></nowiki> {{NewIn|v=3.14.1}} : Füllen Sie die Unterfrage SQ001 der Frage mit dem Titel MULTI aus<nowiki> 'vorbefüllt'</nowiki> (zum Beispiel für eine Frage mit mehreren Texten).
*<nowiki> <code>https://ls.example.org/1234?single=-oth-&single_other=Other%20text</code></nowiki> {{NewIn|v=3.14.1}} : Wählen Sie die „andere“ Antwortoption einer Single-Choice-Frage aus und füllen Sie den anderen Wert mit dem Text „Anderer Text“ aus.
*<nowiki> <code>https://ls.example.org/1234?1234X1X1SQ001=prefilled</code></nowiki> : Füllen Sie die Unterfrage SQ001 der Frage mit der ID: 1 aus der Gruppe mit der ID: 1 aus<nowiki> 'vorbefüllt'</nowiki>
*<nowiki> <code>https://ls.example.org/1234?1234X1X1SQ001=A1</code></nowiki> : Antwortmöglichkeit vorwählen<nowiki> 'A1'</nowiki> der Unterfrage SQ001 der Frage mit der ID: 1 aus der Gruppe mit der ID: 1.
*<nowiki> <code>https://ls.example.org/1234?1234X1X1SQ001=Y</code></nowiki> : Wählen Sie die Unterfrage SQ001 der Frage mit der ID 1 aus der Gruppe mit der ID: 1 vorab aus.


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]].


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.
{{Hint|Text=GET-Parameter verwenden „?“ für den ersten Parameter und „&“ für die folgenden. Wenn Sie bereits „?“ haben In Ihrer URL müssen Sie „&“ verwenden, um weitere GET-Parameter hinzuzufügen.}}


Here are some start URL '''examples''':


* <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled</nowiki></code> : Fill the question with code Q1 with <nowiki>'prefilled'</nowiki>
{{Hint|Text=Die zusätzlichen GET-Parameter werden nur ausgefüllt, wenn die Umfrage erneut beginnt. Fügen Sie daher zum Testen immer newtest=Y hinzu, um eine neue Umfrage zu starten. Zum Beispiel:<nowiki> <code>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</code></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.}}
==Vorausfüllen einer Umfrage mithilfe von GET-Parametern mithilfe von URL-Parametern tab==
{{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==
Sie können (manchmal einfachere) Antworten mithilfe von URL-Parametern vorab ausfüllen, die in [[Panel-Integration|Panel-Integration]] konfiguriert werden können.


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


==Antwort vorausfüllen und ausblenden==


==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.
Sie können das [[QS:Hidden|hidden-Attribut]] einer Frage verwenden, um sie vor Ihren Befragten zu verbergen. Wenn ja, bleibt die Frage immer noch vorab ausgefüllt.

Latest revision as of 16:54, 2 April 2024


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.

If you go to “Survey participants” in the survey side menu and change the survey to be in “closed access mode“, after pre adding participants there with each having a token, the token parameter will be added in the end url.

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.

Template:Hinweis

Ausdrücke

Sie können hier auch einen beliebigen expression verwenden.

Zum Beispiel:

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


Passthrough-Felder

Um Passthrough-Felder zu verwenden, müssen Sie die Variablennamen über die Panel-Integration definieren. Wenn Sie keine Zielfrage zuweisen, werden die Variablen nicht in Antworten gespeichert (lesen Sie mehr über die LimeSurvey-Funktion Panel-Integration). Um einen solchen Parameter in der End-URL zu verwenden, fügen Sie einfach das Tag '{PASSTHRU:<paramname> } Wo <paramname> ist der Name Ihres Eingabeparameters.

Nehmen wir an, Sie haben einen Parameter mit dem Namen „foobar“ definiert. Die Umfrage wird mit einem Link wie diesem gestartet:

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

Der XYZ123 ist der Wert, den Sie „übergeben“ möchten.

Die End-URL einer Umfrage mit der folgenden URL <code>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</code> würde dann umgewandelt werden <code>https://www.limesurvey.org/test.php?foobarout=XYZ123</code>

Start-URL

Eine Umfrage mit GET-Parametern vorab ausfüllen

Sie können alle Antworten mit Ausnahme des Fragetyps upload und Gleichungsfragetyp vorab ausfüllen. Sie können qcode naming für Parameter verwenden und den Wert für einzelne Fragetypen festlegen oder den SGQA-Bezeichner verwenden.

Anschließend werden die Antworten auf den vorausgefüllten Wert gesetzt. Für die Single-Choice-Option müssen Sie den Code der Antwort verwenden, für die Multi-Choice-Frage müssen Sie Y verwenden, wenn Sie die Antwort vorausfüllen möchten.

Hier sind einige Beispiele für Start-URLs:

  • <code>http://ls.example.org/1234?QTEXT=prefilled</code> : Füllen Sie die Frage mit dem Code QTEXT aus 'vorbefüllt'
  • <code>https://ls.example.org/1234?MULTI_SQ001=prefilled</code> (New in 3.14.1 ) : Füllen Sie die Unterfrage SQ001 der Frage mit dem Titel MULTI aus 'vorbefüllt' (zum Beispiel für eine Frage mit mehreren Texten).
  • <code>https://ls.example.org/1234?single=-oth-&single_other=Other%20text</code> (New in 3.14.1 ) : Wählen Sie die „andere“ Antwortoption einer Single-Choice-Frage aus und füllen Sie den anderen Wert mit dem Text „Anderer Text“ aus.
  • <code>https://ls.example.org/1234?1234X1X1SQ001=prefilled</code> : Füllen Sie die Unterfrage SQ001 der Frage mit der ID: 1 aus der Gruppe mit der ID: 1 aus 'vorbefüllt'
  • <code>https://ls.example.org/1234?1234X1X1SQ001=A1</code> : Antwortmöglichkeit vorwählen 'A1' der Unterfrage SQ001 der Frage mit der ID: 1 aus der Gruppe mit der ID: 1.
  • <code>https://ls.example.org/1234?1234X1X1SQ001=Y</code> : Wählen Sie die Unterfrage SQ001 der Frage mit der ID 1 aus der Gruppe mit der ID: 1 vorab aus.


 Hint: GET-Parameter verwenden „?“ für den ersten Parameter und „&“ für die folgenden. Wenn Sie bereits „?“ haben In Ihrer URL müssen Sie „&“ verwenden, um weitere GET-Parameter hinzuzufügen.


 Hint: Die zusätzlichen GET-Parameter werden nur ausgefüllt, wenn die Umfrage erneut beginnt. Fügen Sie daher zum Testen immer newtest=Y hinzu, um eine neue Umfrage zu starten. Zum Beispiel: <code>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</code>


Vorausfüllen einer Umfrage mithilfe von GET-Parametern mithilfe von URL-Parametern tab

Sie können (manchmal einfachere) Antworten mithilfe von URL-Parametern vorab ausfüllen, die in Panel-Integration konfiguriert werden können.


Antwort vorausfüllen und ausblenden

Sie können das hidden-Attribut einer Frage verwenden, um sie vor Ihren Befragten zu verbergen. Wenn ja, bleibt die Frage immer noch vorab ausgefüllt.