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