Inhaltsverzeichnis

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.

CodeBedeutung
-1Es wurde kein Teilnahmecode angegeben
0Der Teilnahmecode ist im Befragungsprojekt nicht bekannt
1Der Teilnahmecode wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)
2Mit dem Teilnahmecode wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen
3Der 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');
}