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)
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages />
<languages />
__TOC__
__TOC__
=Einleitung=
URL-Feldparameter können im:
* [[URL_fields#End_URL_field|End URL]]-Feld der Umfrage (siehe [[Textelemente|Umfragetextelemente]])
* 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 of setting a URL. This URL is presented to the participant who has finished the survey on the completed page, or you can optionally set the participant to be automatically redirected to the URL.


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.


==Basic fields==
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.


You can use {SAVEDID}, {TOKEN}, {SID} and {LANG} (since 1.71+) in this URL.
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.
* SAVEDID is the id assigned to this particular submission,
* TOKEN is the token used to participate in the survey,
* SID is the survey ID, and
* LANG is the language code


'''Example'''
==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:


<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} in this URL (since 1.82+).
==Antwortfelder==
* {INSERTANS: SGQA} allows adding the response to a specific question in the survey to the final url. This can be useful for sending a response to an external script (ie 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.
 
Zum Beispiel:
 
<code><nowiki>
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
</nowiki></code>


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


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


You can also use any Expression Manager expression (since 1.92+).
{{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].}}


'''Example'''
==Ausdrücke==
 
 
Sie können hier auch einen beliebigen [[ExpressionScript - Presentation|expression]] verwenden.
 
Zum Beispiel:


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


==Passthrough fields (LimeSurvey 2.x or later)==


Starting with version 2.0 you now have to define any additional parameters that should be passed to the end URL in the survey settings (Tab "Panel integration"). 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==


Example:


You defined in the Panel integration tab a parameter named 'foobar'. The survey is started with a link like
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.
 
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>


where XYZ123 is the value you want to pass.
Der XYZ123 ist der Wert, den Sie „übergeben“ möchten.
 
A survey end URL of <code><nowiki>http://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar}</nowiki></code> would then convert to <code><nowiki>http://www.limesurvey.org/test.php?foobarout=XYZ123</nowiki></code>
 
==Passthrough fields (LimeSurvey 1.92 and older)==
 
You can also use a 'passthrough' field name and data value in the end URL.


In some instances you may want to pass a value to the survey at initialization, and then have that value passed through to an external script at the end (for example a marketing firms subsid).
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>


'''Example'''
=Start-URL=


In this case you'd start the survey with the query url "index.php?sid=12345&passthru;=subsid&subsid;=9999".


In your URL you would use {PASSTHRULABEL} and {PASSTHRUVALUE} to reuse these values at the end of the survey.
==Eine Umfrage mit GET-Parametern vorab ausfüllen==


A URL of "http://www.limesurvey.org/test.php?{PASSTHRULABEL}={PASSTHRUVALUE}" would then convert to "http://www.limesurvey.org/test.php?subsid=9999"


==Places to use URL fields==
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.


URL fields can be used in the general survey exit URL (see [[Creating a new survey]] ), and in the URL setting for each individual quota (see [[Quotas]] ).
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.


=Start URL=
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. For multiple question type, you must use [[SGQA identifier]]


Then answer 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 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.}}


'''Example'''


* <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 and & for subsequent parameters. 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. Therefor, 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==


You can prefill, sometimes more easily, answers using URL parameters which can be configure in the [[Survey_settings#Panel_integration|survey settings - panel integration]].
Sie können (manchmal einfachere) Antworten mithilfe von URL-Parametern vorab ausfüllen, die in [[Panel-Integration|Panel-Integration]] konfiguriert werden können.


==Prefilling and hidding the answer==


You can use hidden avanced settings to hide the question to respondant. Prefilling is happen too.
==Antwort vorausfüllen und ausblenden==


==Before 1.92 version==


Before 1.92 version, you must use SGQA and not directly the question code.
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.