serialCheck()

int serialCheck(string Teilnahmecode)

Die Funktion serialCheck() verrät, ob ein Teilnahmecode gültig ist und ob sie bereits verwendet wurde. Diese Funktion kann hilfreich sein, wenn man eine Teilnahmecode manuell abfragen möchte.

Wichtig: Mit der Funktion kann lediglich der Status eines Teilnahmecodes geprüft werden – der Teilnahmecode wird am Ende des Interviews nicht als „verbraucht“ markiert.

Rückgabewert

Als Ergebnis liefert serialCheck() einen der folgenden Codes.

Code	Bedeutung
-1	Es wurde kein Teilnahmecode angegeben
0	Der Teilnahmecode ist im Befragungsprojekt nicht bekannt
1	Der Teilnahmecode wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)
2	Mit dem Teilnahmecode wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen
3	Der Teilnahmecode wurde noch nicht verwendet

Beispiel

Das folgende Beispiel geht davon aus, dass auf der vorhergehenden Seite im Texteingabefeld „AB01_01“ ein Teilnahmecode erfragt wurde. Der PHP-Code prüft nun, ob der angegebene Teilnahmecode gültig ist. Falls nicht, zeigt der PHP-Code mittels repeatPage einen Textbaustein als Fehlermeldung sowie erneut die vorige Seite.

$serial = value('AB01_01');
$status = serialCheck($serial);
 
if ($status == -1) {
  repeatPage('serialVoid');
} elseif ($status == 0) {
  repeatPage('serialWrong');
} elseif ($status == 1) {
  repeatPage('serialUsed');
}