caseSerial()

string caseSerial()

Die Funktion caseSerial() liefert den Wert, der im Datensatz in der Variable SERIAL gespeichert wird. Dies ist zum Beispiel sinnvoll, wenn man dem Befragten einen personalisierten Link zu einem weiteren Fragebogenprojekt anzeigen möchte.

Sofern der Teilnehmer via Serienmail eingeladen wurde, liefert caseSerial() die Personenkennung des Teilnehmers.
Sofern zum Start des Interviews ein Teilnahmecode verwendet wurde (wahlweise im Link übergeben oder per Hand eingegeben), wird diese von caseSerial() zurückgegeben.

Hinweis: Ein Teilnahmecode im Link zum Fragebogen wird unabhängig davon gespeichert, ob der Fragebogen nur via Teilnahmecode oder öffentlich zugänglich ist. Zum Übergeben einer Kennung, die kein Teilnahmecode ist, sollte allerdings besser die dafür ausgelegte Referenz verwendet werden.

Beispiel

Hinweis: Wenn Sie mit Serienmails arbeiten, ist die Funktion mailSchedule() in aller Regel zielführender als das nachfolgende Beispiel. Lesen Sie ggf. auch das Kapitel Mehrwellige Befragungen bei Selbstrekrutierung.

html('
  <p>Rufen Sie nächste Woche bitte diesen
  <a href="http://www.soscisurvey.de/project2/?s='.caseSerial().'">
  Fragebogen</a> auf!</p>
');

Der Teilnahmecode bzw. die Personenkennung steht auch über den Platzhalter %caseSerial% zur Verfügung. Der nachfolgende PHP-Code hat dieselbe Funktion wie der obige.

html('
  <p>Rufen Sie nächste Woche bitte diesen
  <a href="http://www.soscisurvey.de/project2/?s=%caseSerial%">
  Fragebogen</a> auf!</p>
');