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)
 
(36 intermediate revisions by 3 users not shown)
Line 4: Line 4:




=Introduction=
=Einleitung=




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




Line 16: Line 16:




'''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 [[Text elements|Survey text elements]] panel and by enabling the automatic load of the end URL from the [[Presentation]] panel once a survey is completed .
„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.


But, LimeSurvey offers the possibility to use URL fields in many other ways which in turn allows you to enhance the functionality of your survey.
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.


==Basic fields==
==Grundlegende Felder==




You can use '''{SAVEDID}''', '''{TOKEN}''', '''{SID}''', and '''{LANG}''' in the end 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>
Line 37: Line 37:




==Answer fields==
==Antwortfelder==




You can also use '''{INSERTANS:SGQA}''' or [[Expression_Manager#Qcode_Variable_Naming|Expression Manager variables]]. 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 (i.e. an email address collected during the survey).
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.


For example:
Zum Beispiel:


<code><nowiki>
<code><nowiki>
Line 48: Line 48:
</nowiki></code>
</nowiki></code>


It is important to add "newtest/y" to the URL to force a new session whenever your survey participants wants to fill in your survey.
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>
Line 54: Line 54:
</nowiki></code>
</nowiki></code>


In the above scenario, the URL pertains to a survey with ID = 48315, group =2, question=22 and answercodes = 2007 and 2008.  
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.  


{{Note|For more details on the necessity of "newtest/y", check the following [https://www.limesurvey.org/forum/installation-a-update-issues/108334-use-case-for-not-using-newtest-y forum thread].}}
{{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].}}


==Expressions==
==Ausdrücke==




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


For example:
Zum Beispiel:


<code><nowiki>
<code><nowiki>
Line 70: Line 70:




==Passthrough fields==
==Passthrough-Felder==




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|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.
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 this one:
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>
Line 81: Line 81:
</code>
</code>


The XYZ123 is the value you want "to pass".
Der XYZ123 ist der Wert, den Sie „übergeben“ möchten.


The end URL of a survey with the following URL <code><nowiki>https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> would then be converted to <code><nowiki>https://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>
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=
=Start-URL=




==Prefilling a survey using GET parameters==
==Eine Umfrage mit GET-Parametern vorab ausfüllen==




You can prefill all answers except the [[Question_type_-_File_upload|upload]] and [[Question type - Equation|equation question type]]. You can use [[Expression Manager - presentation#Access to Variables|qcode naming]] for parameters and set the value for single question types. For the multiple question type, you must use a [[SGQA identifier]].
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.


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


Here are some start URL examples:
Hier sind einige Beispiele für Start-URLs:


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




{{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.}}
{{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.}}




{{Hint|Text=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: <code><nowiki>http://ls.example.org/1234?QTEXT=prefilled&newtest=Y</nowiki></code>}}
{{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> }}


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


==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 [[Panel integration|panel integration]].


==Antwort vorausfüllen und ausblenden==


==Prefilling and hiding the answer==


 
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.
You can use the [[QS:Hidden|hidden attribute]] of a question to hide it from your respondents. If so, the question still remains prefilled.

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.