serialCheck()

int serialCheck(string Seriennummer)

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

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

Rückgabewert

Als Ergebnis liefert serialCheck() einen der folgenden Codes.

Code	Bedeutung
-1	Es wurde keine Seriennummer angegeben
0	Die Seriennummer ist im Befragungsprojekt nicht bekannt
1	Die Seriennummer wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)
2	Mit der Seriennummer wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen
3	Die Seriennummer wurde noch nicht verwendet

Beispiel

Das folgende Beispiel geht davon aus, dass auf der vorhergehenden Seite im Texteingabefeld „AB01_01“ eine Seriennummer erfragt wurde. Der PHP-Code prüft nun, ob die angegebene Seriennummer 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');
}