Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:survey:url [17.06.2020 00:06] – alte Version wiederhergestellt (25.05.2020 16:48) admin
+++ de:survey:url [25.11.2025 12:18] (aktuell) – alte Version wiederhergestellt (12.11.2025 14:04) admin
@@ Zeile 1: / Zeile 1: @@
 ====== Der Link zum Fragebogen ======
-Jede Internetseite hat eine eindeutige Adresse, die URL. So auch der Fragebogen. Damit Internetnutzer auf den Fragebogen zugreifen können, benötigen sie diese Adresse. Normalerweise wird diese Adresse als Link auf einer Website verknüpft oder man schickt sie direkt (z.B. via E-Mail) an die potenziellen Teilnehmer.
+Wie jede Internetseite besitzt auch der Fragebogen eine eindeutige Adresse (URL), die für den Zugriff benötigt wird. Üblicherweise wird diese Adresse als Link auf einer Website hinterlegt oder direkt, zum Beispiel per E-Mail, an die potenziellen Teilnehmer:innen versendet.
@@ Zeile 8: / Zeile 8: @@
 Zunächst einmal setzt sich die Adresse des Fragebogen aus der URL von SoSci Survey (z.B. ''%%https://www.soscisurvey.de%%'') und dem Projektverzeichnis (z.B. ''demo'') zusammen. Zwischen den beiden Bestandteilen steht ein Schrägstrich (''/''). Ebenso steht ein Schrägstrich am Ende, weil ja ein (Projekt-)Verzeichnis und keine Datei gemeint ist: ''%%https://www.soscisurvey.de/demo/%%''.
-Den Link zu Ihrem Befragungsprojekt finden Sie unter **Befragungsprojekt** -> **Projekt-Einstellungen** -> Karteireiter //Allgemeines// -> //Projektverzeichnis//. Dort können Sie das Projektverzeichnis auch ändern -- allerdings nur solange der //Befragungszeitraum// noch nicht angelaufen ist. Sie können den Befragungszeitraum bei Bedarf jederzeit ändern (z.B. den Beginn des Zeitraums auf das morgige Datum einstellen).
+Den Link zu Ihrem Befragungsprojekt finden Sie unter **Befragungsprojekt** -> **Projekt-Einstellungen** -> Karteireiter //Fragebogen veröffentlichen// -> //Projektverzeichnis//. Dort können Sie das Projektverzeichnis auch ändern -- allerdings nur solange der //Befragungszeitraum// noch nicht angelaufen ist. Sie können den Befragungszeitraum bei Bedarf jederzeit ändern (z.B. den Beginn des Zeitraums auf das morgige Datum einstellen).
 **Hinweis:** Lässt man den Schrägstrich am Ende weg, wird der Teilnehmer dennoch automatisch auf das Verzeichnis weitergeleitet -- daran zu sehen, dass der Schrägstrich in der Adressezeile des Browsers ergänzt wird. Diese Weiterleitung dauert allerdings einen kurzen Moment.
+===== QR-Codes =====
+{{ :de:survey:fig.qr-code-soscisurvey.png?nolink|QR Code SoSci Survey}} Ein QR-Code ist eine visuelle Darstellung eines textes, zum Beispiel einer URL. Der QR-Code rechts kodiert z.B. den Link ''%%https://www.soscisurvey.de%%''.
+SoSci Survey stellt unter **Fragebogen zusammenstellen** -> **Fragebögen verwalten** und in den **Projekt-Einstellungen** (Zahnrad rechts oben) im Karteireiter "Fragebogen veröffentlichen" QR-Codes zur Verfügung.
+Sie können unabhängig davon aber auch Links mit zusätzlichen Parametern (s. unten) mit geeigneten Internetdiensten in QR-Codes übersetzen.
+Wenn Sie einen Fragebogen offline und/oder online nehmen, ändert sich dadurch nicht der Link zum Fragebogen. Eventuell erstellte QR-Codes bleiben dementsprechend ebenfalls gültig.
 ===== Parameter im Fragebogen-Link =====
-Im Link kann man SoSci Survey weitere Anweisungen und Informationen übermitteln. Etwa welcher Fragebogen geöffnet werden soll (wenn es im Projekt mehrere gibt) oder dass der Datensatz eine Markierung/Referenz erhält (z.B. in welche Teilgruppe der Teilnehmer gehört).
+Im Link lassen sich SoSci Survey weitere Anweisungen und Informationen übermitteln. Etwa welcher Fragebogen geöffnet werden soll (wenn es im Projekt mehrere gibt) oder dass der Datensatz eine Markierung/Referenz erhält (z.B. in welche Teilgruppe die Teilnehmer:innen gehören).
@@ Zeile 22: / Zeile 32: @@
 Die Anweisungen/Informationen (Parameter) sind immer gleich aufgebaut: Es gibt einen Schlüssel, der angibt um welchen Parameter es sich handelt, und einen Wert, der für diesen Parameter übermittelt werden soll. Parameter bzw. Schlüssel sind verfügbar:
-  * [[#auswahl_des_fragebogens_q|q - Auswahl eines Fragebogen]] (falls im Projekt mehrere Fragebögen angelegt wurden)
+  * [[#auswahl_des_fragebogens_q|q - Auswahl des Fragebogens]] (falls im Projekt mehrere Fragebögen angelegt wurden)
   * [[#einen_link_markieren_r|r - Referenz/Markierung des Datensatzes]] (Variable REF)
-  * [[#seriennummer_uebergeben_s|s - Seriennummer/Teilnahmecode des Teilnehmers]] (Variable SERIAL)
+  * [[#teilnahmecode_uebergeben_s|s - Teilnahmecode des Teilnehmers]] (Variable SERIAL)
   * [[#sprachversion_vorgeben_l|l - Sprachversion vorgeben]] (für mehrsprachige Befragungsprojekte)
   * [[#passwort_password|password - Passwort für passwortgeschützten Fragebogen]]
@@ Zeile 33: / Zeile 43: @@
 ==== Verwendung im Link ====
-Um Parameter im Link festzulegen, muss man sich ein wenig mit der GET-Syntax des HTTP-Protokolls befassen:
+Um Parameter im Link festzulegen, muss sich ein wenig mit der GET-Syntax des HTTP-Protokolls befasst werden:
   * Zwischen Schlüssel und Wert steht ein Gleichheitszeichen (''='')\\ ''q=fragebogen2''
@@ Zeile 42: / Zeile 52: @@
 ==== Hinweise ====
-**Warnung:** Wenn Sie einen Link in Outlook oder Word einfügen, dann wird unterschieden zwischen dem Text, der angezeigt wird und wohin der Link tatsächlich verweist (zum Ausprobieren: [[https://duckduckgo.com/?q=hyperlink|www.soscisurvey.de]]). Wenn Sie etwas am Link ändern, dann ändern Sie u.U. nur den Text, nicht aber den dahinter liegenden Link!
+**Warnung:** Wenn Sie einen Link in Outlook oder Word einfügen, dann wird unterschieden zwischen dem Text, der angezeigt wird und wohin der Link tatsächlich verweist (zum Ausprobieren: [[https://duckduckgo.com/?q=hyperlink|www.soscisurvey.de]]). Wenn Sie den Link in einer E-Mail oder einem Dokument ändern, dann stellen Sie bitte sicher (z.B. mittels Rechtsklick -> //Hyperlink bearbeiten//), dass nicht nur der angezeigte Text, sondern auch der dahinter liegende Link geändert wurde.
 **Hinweis:** Um die nachfolgend dokumentierten Parameter zu verwenden, sind __keine__ Anpassungen in SoSci Survey bzw. in den Projekt-Einstellungen erforderlich. Kopieren Sie einfach den [[#die_url_des_befragungsprojekts|regulären Link zum Fragebogen]] (z.B. ''%%https://www.soscisurvey.de/example/%%''), schreiben Sie die Parameter (z.B. ''%%?r=Berlin%%'') dahinter und fügen Sie den so ergänzten Link (''%%https://www.soscisurvey.de/example/?r=Berlin%%'') in einer E-Mail oder als Link auf einer Website ein.
@@ Zeile 48: / Zeile 58: @@
 **Hinweis:** Lesen Sie bitte [[#verwendung_im_link|oben]], was es mit dem Fragezeichen (''?'') und dem kaufmännischen Und (''&'') auf sich hat und wie diese im Link verwendet werden.
-**Hinweis:** Die Schlüssel für die Parameter kann man ggf. unter **Befragungsprojekt** -> **Projekt-Einstellungen** -> Karteireiter //Spezielles// -> //Variablen im Link zum Fragebogen// anpassen. Normalerweise ist das aber __nicht__ notwendig und wir raten i.A. davon ab, die Schlüssel zu ändern.
+**Hinweis:** Die Schlüssel für die Parameter können ggf. unter **Befragungsprojekt** -> **Projekt-Einstellungen** -> Karteireiter //Spezielles// -> //Variablen im Link zum Fragebogen// angepasst werden. Normalerweise ist das aber __nicht__ notwendig und wir raten i.A. davon ab, die Schlüssel zu ändern.
@@ Zeile 74: / Zeile 84: @@
 ===== Auswahl des Fragebogens (q) =====
-Falls man im Befragungsprojekt mehrere Fragebögen angelegt hat, kann man entscheiden, welcher Fragebogen angezeigt wird. Dafür gibt es zwei Möglichkeiten:
+Falls Sie im Befragungsprojekt mehrere Fragebögen angelegt haben, können Sie entscheiden, welcher Fragebogen angezeigt wird.
-  - //Standard-Fragebogen:// Wenn von mehreren angelegten Fragebögen nur einer verwendet werden soll, so definiert man diesen unter **Fragebogen zusammenstellen** -> //Zufallsauswahl für Fragebögen// als Standard-Fragebogen. Wann immer man das Projektverzeichnis __ohne__ weitere Angaben aufruft, wird nun dieser Fragebogen angezeigt.
+Unter **Fragebogen zusammenstellen** -> **Fragebögen verwalten** können Sie einen //Standard-Fragebogen// auswählen. Dieser wird immer dann verwendet, wenn der Link zum Befragungsprojekt ohne genauere Spezifikation eines Fragebogens aufgerufen wird. Falls notwendig, kann in diesem Fragebogen auch eine [[:de:create:random_questionnaire]] eingebaut werden.
-  - //Gezielte Auswahl:// Um gezielt einen Fragebogen auszuwählen, verwendet man den Parameter ''q'' und die Kennung des Fragebogens. Zur Auswahl des Fragebogens "fb" im Projekt "demo" also z.B. ''%%https://www.soscisurvey.de/demo/?q=fb%%''.
-Weiterhin ist eine [[:de:create:random_questionnaire]] realisierbar.
+Die Auswahl eines Fragebogens im Link erfolgt über den Parameter ''q'' und die Kennung des gewünschten Fragebogens. Zur Auswahl des Fragebogens "fb" im Projekt "demo" würde man also z.B. folgenden Link versenden:
+<code>
+https://www.soscisurvey.de/demo/?q=fb
+</code>
+**Tipp:** Wenn Sie mehrere Fragebögen im Befragungsprojekt erstellt haben, finden Sie unter **Fragebogen zusammenstellen** -> **Fragebögen verwalten** bereits alle entsprechenden //Internet-Adressen (URLs) zum Aufruf eines Fragebogens// aufgelistet.
+**Tipp:** Wenn Sie [[:de:survey:mailing|Serienmail versenden]], dann legen Sie den gewünschten Fragebogen direkt in der Serienmail im Karteireiter //Fragebogen-Link// fest. Die Auswahl des Fragebogens wird dann zusammen mit den weiteren Einstellungen im individuellen Teilnahmelink hinterlegt.
 ===== Einen Link markieren (r) =====
-Manchmal möchte man Links "markieren". Das kann z.B. der Fall sein, wenn man den Fragebogen über Foren und Banner bewirbt und nachprüfen möchte, auf welchem Wege der Teilnehmer zur Befragung gefunden hat.
+Manchmal besteht der Wunsch Links zu "markieren". Das kann beispielsweise der Fall sein, wenn der Fragebogen über Foren und Banner beworben wird und überprüft werden soll, auf welchem Weg die Teilnehmer:innen zur Befragung gelangt sind.
-Die Markierung ist ebenfalls sinnvoll, wenn man eine eindeutige Teilnehmer-Kennung im Datensatz speichern will: Wenn man zwei Fragebögen z.B. an zwei Personen schickt, die aber irgendwie zusammengehören (z.B. Mann und Frau in einer Beziehung) und die beiden Befragungen nachher eindeutig einander zuordnen will, so markiert man beide Links mit derselben Kennung.
+Die Markierung ist ebenfalls sinnvoll, wenn eine eindeutige Teilnehmer:innen-Kennung im Datensatz gespeichert werden soll: Wenn zwei Fragebögen beispielsweise an zwei Personen geschickt werden, die irgendwie zusammengehören (z. B. Menschen in einer festen Partnerschaft), und die beiden Befragungen sollen nachher eindeutig einander zugeordnet werdern, so markieren Sie beide Links mit derselben Kennung.
-Eine Kennung oder Referenz kann man mit dem Parameter ''r'' übergeben. Der Text wird in der Variable REF direkt in den Datensatz geschrieben. Beim Anklicken des Links ''%%https://www.soscisurvey.de/demo/?r=12345%%'' wird beispielsweise die Referenz "12345" im Datensatz vermerkt.
+Eine Kennung oder Referenz kann mit dem Parameter ''r'' übergeben werden. Der Text wird in der Variable REF direkt in den Datensatz geschrieben. Beim Anklicken des Links ''%%https://www.soscisurvey.de/demo/?r=12345%%'' wird beispielsweise die Referenz "12345" im Datensatz vermerkt.
-**Hinweis:** Prinzipiell kann man in der Referenz alle Zeichen bis auf einfache (''%%'%%'') und doppelte Anführungszeichen (''%%"%%'') sowie ist-gleich-Zeichen (''%%=%%'') und das kaufmännische Und (''&'') verwenden. Leerzeichen und Sonderzeichen können Probleme machen, sie werden u.U. vom Browser falsch übertragen. Falls man Probleme vermeiden will, sollte man sich daher in der Referenz auf Buchstaben, Zahlen und den Unterstrich (_) beschränken.
+**Hinweis:** Prinzipiell können in der Referenz alle Zeichen bis auf einfache (''%%'%%'') und doppelte Anführungszeichen (''%%"%%'') sowie ist-gleich-Zeichen (''%%=%%'') und das kaufmännische Und (''&'') verwendet werden. Leerzeichen und Sonderzeichen können Probleme machen, sie werden u.U. vom Browser falsch übertragen. Um Probleme zu vermeiden, sollte sich daher in der Referenz auf Buchstaben, Zahlen und den Unterstrich (_) beschränkt werden.
 **Hinweis:** Bitte lesen Sie die [[#hinweise|Hinweise]] (oben).
-===== Seriennummer übergeben (s) =====
+===== Teilnahmecode übergeben (s) =====
-Eine besondere Form der Markierung stellt die Seriennummer dar. Dies ist ein Einmal-Passwort, das einem Teilnehmer Zugang zum Fragebogen mit [[:de:create:access|Zugriffsbeschränkung]] //Seriennummer// gewährt.
+Eine besondere Form der Markierung stellt der Teilnahmecode dar ([[:de:survey:serials]]). Dies ist ein Einmal-Passwort, das Teilnehmer:innen Zugang zum Fragebogen mit [[:de:create:access|Zugriffsbeschränkung]] //Teilnahmecode// gewährt.
-Damit das funktioniert, muss jeder Teilnehmer eine gültige Seriennummer bekommen. Natürlich soll er sie nicht unbedingt per Hand eintippen -- deshalb kann die Seriennummer mit dem Parameter ''s'' an den Link geheftet werden: ''%%https://www.soscisurvey.de/demo/?s=AB123456%%''.
+Damit das funktioniert, muss jede teilnehmende Person einen gültigen Teilnahmecode erhalten. Dieser muss nicht per Hand eingetippt werden, sondern kann mit dem Parameter "s" an den Link angehängt werden: ''%%https://www.soscisurvey.de/demo/?s=AB123456%%''.
-**Tipp:** Wenn man mittels Seriennummer personalisierte Links verschickt, dann können die Teilnehmer die Befragung unterbrechen und später mit dem personalisieren Link wieder fortsetzen. Das funktioniert auch, wenn der Fragebogen prinzipiell öffentlich zugänglich ist. Allerdings muss jeder Teilnehmer eine individuelle Seriennummer erhalten, also vorab bekannt sein.
+Teilnahmecodes dürfen nur Buchstaben (A-Z) und Ziffern (0-9) enthalten.
-**Wichtig:** Mit einer Seriennummer kann man den Fragebogen nur einmal vollständig ausfüllen. Mehr Details s. [[:/de:survey:mailing#seriennummern|Serienummern]].
+**Tipp:** Wenn mittels Teilnahmecode personalisierte Links verschickt werden, können Teilnehmer:innen die Befragung unterbrechen und später mit dem personalisieren Link wieder fortsetzen. Das funktioniert auch, wenn der Fragebogen prinzipiell öffentlich zugänglich ist. Allerdings muss jede teilnehmende Person einen individuellen Teilnahmecode erhalten, d. h., er muss ihr vorab bekannt sein.
+**Wichtig:** Mit einem Teilnahmecode kann man den Fragebogen nur einmal vollständig ausfüllen. Mehr Details s. [[:/de:survey:serials]].
@@ Zeile 115: / Zeile 134: @@
 ===== Passwort (password) =====
-Falls man den Fragebogen durch ein Passwort geschützt hat, kann man selbiges im Link übergeben. Der Parameter dafür lautet ''password''. Lautet das Passwort "geheim", so würde folgender Link Zugriff auf den Fragebogen gewähren: ''%%https://www.soscisurvey.de/demo/?password=geheim%%''.
+Wurde der Fragebogen durch ein Passwort geschützt, kann dieses im Link übergeben werden. Der Parameter dafür lautet ''password''. Lautet das Passwort "geheim", so würde folgender Link Zugriff auf den Fragebogen gewähren: ''%%https://www.soscisurvey.de/demo/?password=geheim%%''.
 Die Adresse des Fragebogens im Projektverzeichnis wird jedoch nicht geändert und lautet daher nach wie vor ''%%https://www.soscisurvey.de/demo/%%''.
-Es macht natürlich wenig Sinn, einen Link mit Passwort auf einer Website zu platzieren. Wenn jeder den Link anklicken kann, ist der Passwort-Schutz wertlos. Sinnvoller ist die Übergabe des Passworts, wenn man eine E-Mail verschickt. Die sichere Lösung ist hier aber die Serienmail.
+Es macht natürlich wenig Sinn, einen Link mit Passwort auf einer Website zu platzieren. Wenn jede Person den Link anklicken kann, ist der Passwort-Schutz wertlos. Sinnvoller ist es, das Passwort in einer E-Mail zu übergeben. Die sicherste Lösung ist hier die Serienmail.
@@ Zeile 132: / Zeile 150: @@
 ===== Teilnahmecode Serienmails (d) =====
-Verschickt man eine [[mailing|Serienmail]] via SoSci Survey und verwendet den Platzhalter ''%link%'' für personalisierte Links, so fügt SoSci Survey den Parameter ''d'' (delivery ID) an.
+Wird eine [[mailing|Serienmail]] via SoSci Survey verschickt und der Platzhalter ''%link%'' für personalisierte Links verwendet, so fügt SoSci Survey den Parameter ''d'' (delivery ID) an.
-Hierbei handelt es sich um einen Programm-internen Code, der pro Serienmail und Teilnehmer neu erstellt wird. Den Parameter ''d'' sollte man daher i.d.R. SoSci Survey überlassen und nicht selbst verwenden.
+Hierbei handelt es sich um einen Programm-internen Code, der pro Serienmail und Teilnehmer:in neu erstellt wird. Der Parameter ''d'' sollte daher i.d.R. SoSci Survey überlassen und nicht selbst verwendet werden.
 ===== Benutzerdefinierte Variablen =====
-Mit dem Fragetyp [[:de:create:questions:client|Gerät und übermittelte Variablen]] oder der PHP-Funktion ''[[:de:create:functions:readget|readGET()]]'' kann man unter bestimmten Voraussetzungen beliebige Variablen aus dem Fragebogen-Link einlesen.
+Mit dem Fragetyp [[:de:create:questions:client|Gerät und übermittelte Variablen]] können unter bestimmten Voraussetzungen beliebige Variablen aus dem Fragebogen-Link eingelesen werden.
 Neben den oben genannten Variablen (''q'', ''r'', ''s'', ''d'', ''l'', ''password'') sollten folgende reservierte Variablen nicht verwendet werden, um benutzerdefinierte Daten zu übermitteln: ''a'', ''act'', ''adid'', ''ajax'', ''debug'', ''file'', ''image'', ''info'', ''library'', ''script'', ''sp'', ''t''
 Wenn Sie sicherstellen möchten, dass eine benutzerdefinierte Variable nicht mit Standard-Variablen von SoSci Survey kollidiert, wählen Sie einen Namen, der mit ''u'' beginnt. Solche Variablen sind explizit für die benutzerdefinierte Nutzung reserviert.