| |
| de:create:functions:serialcheck [12.01.2015 20:21] – ausgelagert aus functions-proc admin | de:create:functions:serialcheck [09.07.2023 17:39] (aktuell) – Seriennummern wurden in Teilnahmecodes umbenannt admin |
|---|
| ====== serialCheck() ====== | ====== serialCheck() ====== |
| |
| ''int **serialCheck**(string //Seriennummer//)'' | ''int **serialCheck**(string //Teilnahmecode//)'' |
| |
| 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. | 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. |
| |
| **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 ===== | ===== Rückgabewert ===== |
| |
| ^Code^Bedeutung^ | ^Code^Bedeutung^ |
| |-1|Es wurde keine Seriennummer angegeben| | |-1|Es wurde kein Teilnahmecode angegeben| |
| |0|Die Seriennummer ist im Befragungsprojekt nicht bekannt| | |0|Der Teilnahmecode ist im Befragungsprojekt nicht bekannt| |
| |1|Die Seriennummer wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)| | |1|Der Teilnahmecode wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)| |
| |2|Mit der Seriennummer wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen| | |2|Mit dem Teilnahmecode wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen| |
| |3|Die Seriennummer wurde noch nicht verwendet| | |3|Der Teilnahmecode wurde noch nicht verwendet| |
| |
| |
| ===== Beispiel ===== | ===== 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 ''[[:de:create:functions:repeatpage|repeatPage]]'' einen Textbaustein als Fehlermeldung sowie erneut die vorige Seite. | 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 ''[[:de:create:functions:repeatpage|repeatPage]]'' einen Textbaustein als Fehlermeldung sowie erneut die vorige Seite. |
| |
| <code php> | <code php> |
