55m5Hj40-FBKYQwLn-tRcBAUJn-5mF8ArS0
0wDcxXUD-myDUR6RD-6Atr9Qse-XJEwRN61
QmmWWJgJ-8A8vuCcX-Llc2a10t-pDCqUSie
ANVE251r-pqT5Rerm-oU30Ujzq-BHibeuZA
EENIjrr1-35rTXjxr-qsiTa8dk-YPVVx42i
PMt5KNjZ-MoN3Fj5Q-Lmgl4Viz-hAQYKXvG
55m5Hj40-FBKYQwLn-tRcBAUJn-5mF8ArS0, 0wDcxXUD-myDUR6RD-6Atr9Qse-XJEwRN61, QmmWWJgJ-8A8vuCcX-Llc2a10t-pDCqUSie, ...
"55m5Hj40-FBKYQwLn-tRcBAUJn-5mF8ArS0",
"0wDcxXUD-myDUR6RD-6Atr9Qse-XJEwRN61",
"QmmWWJgJ-8A8vuCcX-Llc2a10t-pDCqUSie",
"ANVE251r-pqT5Rerm-oU30Ujzq-BHibeuZA",
"EENIjrr1-35rTXjxr-qsiTa8dk-YPVVx42i",
"PMt5KNjZ-MoN3Fj5Q-Lmgl4Viz-hAQYKXvG"
Beim Import ist die Verlosung mit der Nummer 1 vorausgewählt. Ändern Sie die Vorauswahl, wenn Sie die Gutscheine separat von anderen Gutscheincodes verwalten möchten.
===== Ausgabe von Gutscheincodes =====
Für die Auswahl von Gutscheincodes verwenden Sie die Funktion ''voucher()''.
''string|NULL **voucher**(string //Personenkennung//, [int //Verlosung//], [bool //Neuentnahme//])''
* //Personenkennung// -- Eine eindeutige Kennung für die Person, welche den Gutschein erhält
* //Verlosung// -- (optional) Die Nummer der Verlosung, aus welcher der Gutscheincode entnommen werden soll
* //Neuentnahme// -- (optional) Soll für die Personenkennung ein Gutscheincode entnommen werden, falls für diese Verlosung bisher noch keiner für diese Personenkennung entnommen wurde (Standard: ''true''). Wenn Sie hier ''false'' einsetzen und wenn für den Personencode in der Verlosung noch kein Code entnommen wurde, dann ist der Rückgabewert ''null''.
Die Funktion ''voucher()'' liefert für eine Kombination aus Personenkennung und Verlosung immer denselben Gutscheincode. Die Seite mit dem Gutscheincode kann daher mehrfach angezeigt werden. Sie können außerdem einen separaten Fragebogen bereitstellen, auf welchem die Befragten den Gutscheincode nochmal einsehen können.
Sofern in der angegebenen Verlosung kein Gutscheincode mehr zur Verfügung steht, gibt die Funktion ''null'' zurück.
**Hinweis:** Wenn Sie den Fragebogen als Projektleitung testen, dann liefert ''voucher()'' nur einen Dummy-Gutscheincode (zum Beispiel ''EXAMPLE-123456-7890''). Die echten Gutscheincodes werden nur für Interviews (MODE=interview) verwendet.
==== Anzeige eines Gutscheincodes im Fragebogen ====
Als Personenkennung biete sich die Personenkennung des Adresseintrags beim Serienmail-Versand (SERIAL) an beziehungsweise ein Teilnahmecode. Beide sind über ''caseSerial()'' verfügbar.
$person = caseSerial();
$voucher = voucher($person);
html('Ihr Gutscheincode lautet: '.$voucher.'
');
Soll für dieselbe Person in einer späteren Erhebungswelle ein weiterer Gutschein ausgegeben werden, würden Sie Gutscheincodes für die Verlosung Nr. 2 importieren und die 2 in der Funktion ''voucher()'' angeben:
$person = caseSerial();
$voucher = voucher($person, 2);
html('Ihr Gutscheincode für Welle 2: '.$voucher.'
');
Sehen Sie zusätzlich die Möglichkeit vor, dass während der Erhebung alle Gutscheincodes aufgebraucht werden.
$person = caseSerial();
$voucher = voucher($person);
if ($voucher) {
html('Ihr Gutscheincode lautet: '.$voucher.'
');
} else {
html('Es sind keine Gutscheincodes mehr verfügbar, bitte schreiben Sie uns an ....
');
}
In öffentlichen Fragebögen kann auch die Fallnummer als Personenkennung verwendet werden. Achten Sie dann aber unbedingt darauf, das automatische Ausfüllen durch Bots zu unterbinden.
// Diese Variante nur mit größter Vorsicht einsetzen!
$person = 'C'.caseNumber();
$voucher = voucher($person);
html('Gutscheincode für dieses Interview: '.$voucher.'
');
==== Gutscheincode erneut anzeigen ====
Wenn Befragte den Code nicht notiert haben, können Sie einen zusätzlichen Fragenbogen erstellen, welcher den Gutscheincode erneut anzeigt. Hier verwenden Sie den dritten Parameter der Funktion ''voucher()'' mit dem Wert ''false''. So wird sichergestellt, dass eine Person, welche den ursprünglichen Fragebogen nicht ausgefüllt und dabei einen Gutschein bekommen hat, sich selbigen über die "Abkürzung" erschleicht.
$person = caseSerial();
$voucher = voucher($person, 1, false);
html('Ihr Gutscheincode aus Welle 1 lautet immer noch: '.$voucher.'
');