Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
de:survey:url [27.08.2019 11:27] – [Auswahl des Fragebogens (q)] adminde:survey:url [20.03.2024 21:19] (aktuell) – alte Version wiederhergestellt (19.12.2023 07:31) admin
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/%%''. 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. **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.
Zeile 22: Zeile 22:
 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: 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)   * [[#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)   * [[#sprachversion_vorgeben_l|l - Sprachversion vorgeben]] (für mehrsprachige Befragungsprojekte)
   * [[#passwort_password|password - Passwort für passwortgeschützten Fragebogen]]   * [[#passwort_password|password - Passwort für passwortgeschützten Fragebogen]]
Zeile 42: Zeile 42:
 ==== Hinweise ==== ==== 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.Bmittels 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. **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 74: Zeile 74:
 ===== Auswahl des Fragebogens (q) ===== ===== 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 man im Befragungsprojekt mehrere Fragebögen angelegt hat, kann man 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ählenDieser wird immer dann verwendetwenn der Link zum Befragungsprojekt ohne genauere Spezifikation eines Fragebogens aufgerufen wird. Falls notwendigkann man in diesem Fragebogen auch eine [[:de:create:random_questionnaire]] einbauen.
-  - //Gezielte Auswahl:// Um gezielt einen Fragebogen auszuwählenverwendet 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.
  
  
Zeile 95: Zeile 102:
  
  
-===== Seriennummer übergeben (s) =====+===== Teilnahmecode übergeben (s) ===== 
 + 
 +Eine besondere Form der Markierung stellt der Teilnahmecode dar ([[:de:survey:serials]]). Dies ist ein Einmal-Passwort, das einem Teilnehmer Zugang zum Fragebogen mit [[:de:create:access|Zugriffsbeschränkung]] //Teilnahmecode// gewährt.
  
-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.+Damit das funktioniert, muss jeder Teilnehmer einen gültigen Teilnahmecode bekommen. Natürlich soll er diesen nicht unbedingt per Hand eintippen -- deshalb kann der Teilnahmecode mit dem Parameter ''s'' an den Link geheftet werden''%%https://www.soscisurvey.de/demo/?s=AB123456%%''.
  
-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%%''.+Teilnahmecodes dürfen nur Buchstaben (A-Z) und Ziffern (0-9) enthalten.
  
-**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.+**Tipp:** Wenn man mittels Teilnahmecode 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 einen individuellen Teilnahmecode erhalten, also vorab bekannt sein.
  
-**Wichtig:** Mit einer Seriennummer kann man den Fragebogen nur einmal vollständig ausfüllen. Mehr Details s. [[:/de:survey:mailing#seriennummern|Serienummern]].+**Wichtig:** Mit einem Teilnahmecode kann man den Fragebogen nur einmal vollständig ausfüllen. Mehr Details s. [[:/de:survey:mailing#Teilnahmecodes|Serienummern]].
  
  
Zeile 139: Zeile 148:
 ===== Benutzerdefinierte Variablen ===== ===== 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]] kann man unter bestimmten Voraussetzungen beliebige Variablen aus dem Fragebogen-Link einlesen.
  
 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'' 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. 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.
de/survey/url.1566898025.txt.gz · Zuletzt geändert: 27.08.2019 11:27 von admin
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki