====== caseNumber() ======

''int **caseNumber**()''

Jedes Interview im Befragungsprojekt hat eine eindeutige Nummer, die auch im Datensatz als Variable CASE auftaucht ([[:de:results:variables|Zusätzliche Variablen in der Datenausgabe]]). Mit der Funktion ''caseNumber()'' kann diese Nummer abgefragt werden.

===== Beispiel 1 =====

Vielleicht soll sich der Teilnehmer die Nummer seines Fragebogens notieren, um später eine individuelle Auswertung anzufordern.

<code php>
html('<p>Dies ist der Fragebogens Nr. '.caseNumber().'</p>');
</code>

Allerdings könnte man für dieses Ergebnis auch einfach den [[:de:create:placeholders##vordefinierte_platzhalter|vordefinierten Platzhalter]] ''%caseNumber%'' verwenden:

<code php>
html('<p>Dies ist der Fragebogens Nr. %caseNumber%</p>');
</code>


===== Beispiel 2 =====

Oder die Studie umfasst mehrere Fragebögen, etwas weil der zweite Fragebogen (Beurteilung eines Stimulus) mehrfach ausgefüllt werden kann, während der erste Fragebogen (Stammdaten) nur einmal ausgefüllt wird.

Die unterschiedlichen Datensätze eines Teilnehmers können dann anhand der Fallnummer zugeordnet werden. Der folgende PHP-Code im ersten Fragebogen leitet den Teilnehmer zu einem anderen Fragebogen und übermittelt die Fallnummer als Referenz ([[:de:survey:url|Der Link zum Fragebogen]]).
 
<code php>
$num = caseNumber();
$url = 'https://www.soscisurvey.de/followup/?r='.$num;
redirect($url);
</code>

Oder dasselbe etwas kompakter:

<code php>
redirect('https://www.soscisurvey.de/followup/?r='.caseNumber());
</code>

Die Funktion ''redirect()'' unterstützt Platzhalter ebenso wie ''html()'' und Textbausteine:

<code php>
redirect('https://www.soscisurvey.de/followup/?r=%caseNumber%');
</code>

Am Ende des zweiten Fragebogens würde dann erfragt, ob der Teilnehmer noch einen anderen Stimulus bewerten möchte. Hier müsste dann nicht die Fallnummer, sondern die Referenz (also die Fallnummer aus dem ersten Fragebogen) übermittelt werden:

<code php>
redirect('https://www.soscisurvey.de/followup/?r=%reference%');
</code>