Differences

This shows you the differences between two versions of the page.

--- en:create:functions:serialcheck [14.01.2015 16:56] – created alexander.ritter
+++ en:create:functions:serialcheck [24.01.2015 13:09] – [Return Value] alexander.ritter
@@ Line 1: / Line 1: @@
 ====== serialCheck() ======
-''int **serialCheck**(string //Seriennummer//)''
+''int **serialCheck**(string //authorizationCode//)''
-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.
+The function ''serialCheck()'' reveals whether an //authorizationCode//  is valid, and whether it has already been used. This function can be helpful in calling up an authorization code manually.
-**Wichtig:** Mit der Funktion kann lediglich der Status einer Seriennummer geprüft werden -- die Seriennummer wird am Ende des Interviews nicht als "verbraucht" markiert.
+**Note:** Only the status of an authorization code can be checked with this function -- the authorization code will not be marked as "used" at the end of the questionnaire.
-===== Rückgabewert =====
-Als Ergebnis liefert ''serialCheck()'' einen der folgenden Codes.
+===== Return Value =====
-^Code^Bedeutung^
+''serialCheck()'' generates one of the following codes:
-|-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|
+^Code^Meaning^
+|-1|No authorization code specified|
+|0|Authorization code not recognized in the survey project|
+|1|Authorization code already used (questionnaire is thus completed)|
+|2|Questionnaire was already called up with the authorization code, but not completed|
+|3|Authorization code yet to be used|
-===== 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.
+===== Example =====
+The following example assumes that an authorization code was asked for on the previous page in the text input field "AB01_01". The PHP code now checks, if the authorization code specified is valid. If not, the PHP code shows a text element as an error message, and redisplays the previous page with ''[[:en:create:functions:repeatpage|repeatPage]]''
 <code php>