Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

de:create:functions:serialcheck [12.01.2015 20:21] (aktuell)
admin ausgelagert aus functions-proc
Zeile 1: Zeile 1:
 +====== 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 ''[[:de:create:functions:repeatpage|repeatPage]]'' einen Textbaustein als Fehlermeldung sowie erneut die vorige Seite.
 +
 +<code php>
 +$serial = value('AB01_01');
 +$status = serialCheck($serial);
 +
 +if ($status == -1) {
 +  repeatPage('serialVoid');
 +} elseif ($status == 0) {
 +  repeatPage('serialWrong');
 +} elseif ($status == 1) {
 +  repeatPage('serialUsed');
 +}
 +</code>
de/create/functions/serialcheck.txt · Zuletzt geändert: 12.01.2015 20:21 von admin
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki