Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

de:create:functions:casetoken [12.01.2015 19:58] (aktuell)
admin augelagert aus functions-proc
Zeile 1: Zeile 1:
 +====== caseToken() ======
  
 +''​string **caseToken**()''​
 +
 +Jedes Interview hat eine interne Kennung (Token), anhand derer es im Verlauf der Befragung identifiziert wird. Die Kennung erscheint nach dem ersten Klick auf "​Weiter"​ auch in der Adresszeile des Browsers (z.B. %%https://​www.soscisurvey.de/​demo/?​t=%%__12345abcde__).
 +
 +Mithilfe der Kennung ist es möglich, das laufende Interview zu verlassen, eine andere Tätigkeit auszuführen (z.B. auf einer Website surfen) und anschließend das Interview fortzusetzen. Voraussetzung ist, dass die externe Website die interne Kennung speichert und beim Link zurück zum Fragebogen als GET-Variable ''​t''​ übergibt ([[:​de:​survey:​url|Der Link zum Fragebogen]]).
 +
 +**Wichtig:​** Die externe Website muss das Interview-Token aktiv entgegennehmen,​ speichern und im Link zurück zum Fragebogen wieder ergänzen. Dies ist in aller Regel nur möglich, wenn die externe Website eine serverseitige Scriptsprache (z.B. PHP oder AS) einsetzt. Das Speichern und Zurückgeben der Kennung muss dann gesondert auf der externen Website implementiert werden.
 +
 +**Wichtig:​** Die Interview-Kennung ist im Datensatz nicht ersichtlich. Wenn Sie auf der externen Website Daten sammeln und diese dem Interview zuordnen möchten, so übergeben Sie auch die Fallnummer (''​[[:​de:​create:​functions:​casenumber|caseNumber()]]''​).
 +
 +**Tipp:** Die Interview-Kennung ist auch über den [[:​de:​create:​placeholders#​vordefinierte_platzhalter|vordefinierten Platzhalter]] %caseToken% verfügbar (s. Beispiel).
 +
 +
 +===== Beispiel =====
 +
 +Im folgenden Beispiel wird Interview-Kennung (Token) und Fall-Nummer an eine externe Website ''​%%www.s2survey.net%%''​ übermittelt,​ zu welcher der Teilnehmer mittels ''​[[:​de:​create:​functions:​redirect|redirect()]]''​ geschickt wird.
 +
 +<code php>
 +redirect('​https://​www.s2survey.net/?​tk='​.caseToken().'&​num='​.caseNumber(),​ true);
 +</​code>​
 +
 +Anstatt der Funktionen kann im Befehl ''​redirect()''​ auch einfach der entsprechende Platzhalter verwendet werden.
 +
 +<code php>
 +redirect('​https://​www.s2survey.net/?​tk=%caseToken%&​num=%caseNumber%',​ true);
 +</​code>​
de/create/functions/casetoken.txt · Zuletzt geändert: 12.01.2015 19:58 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