urnDraw('artikel', 'IV01');
$key = 'a'.value('IV01_01'); // Ein "a" vor die Zahl schreiben
$inhalt = dbGet($key);
html('
'.$inhalt[0].'
'.$inhalt[1].'
');
==== Daten zwischen Interviews austauschen ====
In der Vorerhebung einer Tagebuchstudie wird abgefragt, welche Fernsehsender eine Person nutzt. In den weiteren Erhebungen der Tagebuchstudie wird die tägliche Nutzungsdauer für die jeweiligen Sender abgefragt. Dazu sollen in einer offenen Texteingabe nur jene Sender angeboten werden, die in der Vorerhebung ausgewählt wurden.
Für die gesamte Tagebuchstudie kommt die Serienmail-Funktion von SoSci Survey zum Einsatz. Über ''caseSerial()'' kann daher in jedem Fragebogen ein eindeutiger Personen-Code ermittelt werden.
**Hinweis:** Falls die E-Mail-Adresse im ersten Fragebogen erst erhoben wird ([[:de:survey:opt-in-live]]), verwenden Sie in diesem Fragebogen statt ''caseSerial()'' bitte ''value()'' mit der Kennung der Opt-In-Frage.
In der Vorerhebung werden die genutzten Fernsehsender mit der Mehrfachauswahl "FS01" auf Seite 2 des Fragebogens abgefragt. Auf Seite 3 (oder später) wird die Auswahl in der Datenbank vermerkt:
$sender = getItems('FS01', 'is', 2);
$key = 'FS-'.caseSerial(); // Dem Teilnahmecode wird noch ein "FS-" vorangestellt, damit in der Datenbank auch noch andere Inhalte gespeichert werden können.
dbSet($key, $sender);
In den täglichen Fragebögen wird die Nutzungsdauer für die Sender mittels offener Texteingabe "NU03" abgefragt. Diese Frage enthält dieselben Items wie Mehrfachauswahl "FS01" in derselben Reihenfolge. Folgender PHP-Code liest die Daten aus der Datenbank und zeigt nur die entsprechenden Eingabefelder an:
$key = 'FS-'.caseSerial();
$sender = dbGet($key);
question('NU03', $sender);
**Wichtig:** ''dbGet()'' liefert immer ein Array -- auch wenn man mit ''dbSet()'' nur einen einzelnen Wert speichert.
Wenn man im ersten Fragebogen einen einzelnen Wert speichert, muss man im anderen Fragebogen mittels eckiger Klammer (''[0]'') auf das erste (und einzige) Array-Element zugreifen.
$group = value('RG01');
$key = 'RG-'.caseSerial(); // Auch hier wird ein Präfix für den Datenbank-Eintrag verwendet, um alle Optionen offen zu halten
dbSet($key, $group);
$key = 'RG-'.caseSerial();
$data = dbGet($key);
if ($data) {
$group = $data[0];
// Zwischenspeichern des Werts in eine interne Variable,
// um den Wert später via value() zu verwenden (optional)
put('IV01_01', $group);
} else {
// Fehlermeldung anzeigen, dass etwas schief gelaufen ist
show('XY01');
put('IV01_01', -1);
}
Der PHP-Code für den zweiten Fragebogen sieht auch den Fall vor, dass in der Datenbank für Inhalte kein passender Eintrag gefunden wird. Das könnte z.B. passieren, wenn die Befragte den ersten Fragebogen nicht bis zum ''dbSet()'' ausgefüllt hat.
==== Auswertung zuspielen ====
In einer Befragung müssen die Teilnehmer mehrere lange Skalen ausfüllen. Als Dankeschön können Sie 2 Wochen später eine Auswertung ihrer Ergebnisse einsehen. Die Auswertung kann nicht live erfolgen (''[[:de:create:functions:valuemean|valueMean()]]'', [[:de:create:points|Punkte für Antworten zählen]]), weil zunächst die Normwerte aus der Stichprobe bestimmt werden müssen. Zum Abruf ihrer Ergebnisse müssen die Teilnehmer einen Code notieren, weil die Erhebung anonym erfolgt.
Im ersten Fragebogen wird also lediglich ein 8-stelliger Zufallscode erstellt, im Datensatz gespeichert und angezeigt:
$chars = 'ABCDEFHKLMNPRSTUVWXYZ23456789'; // Zeichen, die man i.d.R. nicht verwechseln kann
$code = '';
for ($i=0; $i<8; $i++) {
$code.= $chars[mt_rand(0, strlen($chars)-1)];
}
// Code im Datensatz speichern (mit vorangestelltem "X-")
put('IV02_01', 'X-'.$code);
// Code anzeigen
html('Ergebnisse
Bitte notieren Sie '.$code.'
');
Die Daten werden nach der Erhebung ausgewertet und für jeden Teilnehmer werden drei Ergebnis-Werte berechnet. Diese werden -- zusammen mit dem Code aus IV02_01 -- in einer Tabelle und als CSV-Datei gespeichert:
|X-ABCDEF12|7|19|8|
|X-CDEFG234|24|16|19|
|X-ZU7652AB|15|95|80|
Im zweiten Fragebogen müssen die Teilnehmer zunächst ihren Code eingeben (offene Texteingabe "AB01_01"). Auf der zweiten Seite wird dann geprüft, ob der Code in der Datenbank vorhanden ist und wenn ja, dann werden die Ergebnisse angezeigt.
$key = 'X-'.value('AB01_01'); // Auch hier wird wieder das X vorangestellt
$result = dbGet($key);
// Bei falschem Code, die Code-Abfrage (vorige Seite) nochmal anzeigen
if ($result === false) {
text('wrong code');
repeatPage();
}
// Ansonsten wird das Ergebnis angezeigt
html('
Ausgeschlafenheit: '.$result[0].'%
Schlauheit: '.$result[1].'%
Gemütlichkeit: '.$result[2].'%
');
==== Daten a-priori zuspielen ====
In einer (nicht-anonymen) Kundenbefragung sind einige Stammdaten bereits bekannt -- sie sollen im Fragebogen aber aktualisiert/vervollständigt werden. Die Kunden erhalten personalisierte Links (Zugriff "Teilnahmecode") mit einem Code, der jedem Kunden vorab zugeteilt wurde. Hierfür werden 12-stellige Zufallscodes verwendet, damit man nicht einfach die Codes anderer Kunden erraten und deren Daten abrufen kann, wie es bei einer fortlaufenden Kundennummer leicht möglich wäre.
Es wird eine Tabelle erstellt, die als erste Spalte den Code enthält und daneben die Stammdaten. Die Tabelle wird als CSV-Datei gespeichert und in die projektinterne Datenbank importiert.
|12345678ABCD|SoSci Survey GmbH|Marianne-Brandt-Str.|29|80807|München|
|9876542UBGAD|Musterfirma AG|Musterweg|7|12345|Musterstadt|
|72KU635485UG|MSD-Media GbR|Korbinianstr.|17|||
Der Code wird im personalisierten [[:de:survey:url|Link zum Fragebogen]] als Teilnahmecode (''s'') übergeben und steht im PHP-Code daher via ''caseSerial()'' zur Verfügung.
Die offene Texteingabe "ST01" hat folgende Eingabefelder: Firma (01), Straße (02), Hausnummer (03), PLZ (04), Ort (05). Mittels ''prepare()'' werden nun die bekannten Daten eingetragen -- der Kunde kann sie beim Ausfüllen ggf. anpassen.
$key = caseSerial();
$info = dbGet($key);
if ($info !== false) {
preset('ST01_01', $info[0]);
preset('ST01_02', $info[1]);
preset('ST01_03', $info[2]);
preset('ST01_04', $info[3]);
preset('ST01_05', $info[4]);
}
// Jetzt noch die Frage anzeigen
question('ST01');
==== Daten ergänzen ====
Um während des Interviews einen Eintrag in der Datenbank für Inhalte zu ergänzen, muss dieser ausgelesen, ergänzt und dann wieder geschrieben werden.
Zum Beispiel wurden unter dem Schlüssel "FS-
$key = 'FS-'.caseSerial();
// Daten auslesen
$data = dbGet($key);
if ($data === false) {
// Keine Daten gefunden - vielleicht eine Warnung anzeigen
$data = array(-8, -8, -8); // ... und das Datenelement initialisieren
}
// Die Antwort aus PP01 ergänzen
$data[3] = value('PP01');
// Eintrag erneut speichern
$data = dbSet($key, $data);
==== Auswahloptionen sukzessive einschränken ====
Die Datenbank für Inhalte kann auch dafür verwendet werden, um lange Auswahllisten schrittweise einzuschränken. Im folgenden Beispiel soll zunächst ein Stadtteil ausgewählt werden und dann im nächsten Schritt eine Haltstelle innerhalb des Stadtteils.
Dafür wird in der Datenbank für Inhalte zunächst eine Liste angelegt, welche die Stadtteile beinhaltet und die Haltestellen. Wichtig ist die Vergabe geeigneter Datenbankschlüssel. Diese müssen folgende Kriterien erfüllen:
- Stadtteile und Haltestellen benötigen ein unterschiedliches Präfix, das heißt, die Schlüssel müssen z.B. mit unterschiedlichen Buchstaben beginnen. Im Beispiel beginnen die Schlüssel für Stadtteile mit "S" und jene für die Haltestellen mit "H".
- Die Haltestellen, welche zu einem Stadtteil gehören, müssen nach dem "H" denselben weiteren Code verwenden. Alle Haltestellen in Stadtteil A würden also z.B. mit "H01" beginnen.
- Es spart Arbeit, wenn man den Antwortcode für die Stadtteile so wählt, dass sie mit den Präfixen der Haltestellen-Schlüssel übereinstimmen. Also z.B. Code 1 für Stadtteil A und entsprechend die Präfixe "H01" für die zugehörigen Haltestellen.
Die Liste für den Import könnte also wie folgt aussehen:
S01 1 Stadtteil A
S02 2 Stadtteil B
S03 3 Stadtteil C
...
S50 50 Stadtteil Zeta
H0101 101 Haltestelle "Ammersberg" in Stadtteil A
H0102 102 Haltestelle "Breitenbach" in Stadtteil A
H0103 103 Haltestelle "Clemensstraße" in Stadtteil A
...
H5017 5015 Haltestelle "Zwiebelturm" in Stadtteil Zeta
Nun werden im Fragenkatalog zwei Fragen vom Typ [[:de:create:questions:extselect]] erstellt. Die Optionen sollen diese beiden Fragen [[:de:create:questions:extselect#optionen_aus_der_datenbank|aus der Datenbank beziehen]]. Als Präfix in der Frage für die Stadtteile stellen Sie "S" ein und als Datenbank-Präfix für die Haltestellen-Frage ein "H". Die Vorschau zeigt nun zunächst alle Haltestellen.
**Tipp:** Anstatt einer erweiterten Auswahl können Sie auch eine [[:de:create:questions:suggest]] verwenden. Das ist dann sinvoll, wenn Sie z.B. bei den Stadtteilen sehr viele Antwortoptionen haben.
Wenn die Vorschau der Fragen Ihren Wünschen entspricht (nur bei den Haltestellen eben noch zu viele anzeigt), dann geht es nun and **Fragebogen zusammenstellen**. Dort platzieren Sie die Fragen nach den Stadteilen ("AF01" im Beispiel) auf eine Seite. Auf der nächsten Seite wird dann mit ein wenig PHP-Code und der Funktion ''[[:de:create:functions:question]]'' die Frage für die Haltestellen ("AF02") platziert. Und zwar wird hier mit dem Parameter ''%%'filter'%%'' sichergestellt, dass nur die passenden Haltestellen angezeigt werden.
// Erst einmal den ausgewählten Stadtteil auslesen
$stadtteil = value('AF01');
// Dann das Präfix für die passenden Haltestellen erstellen
$prefix = 'H'.sprintf('%02d', $stadtteil);
// Dann die Frage nach dem Stadtteil mit den passenden Optionen zeigen.
question('AF02', 'filter='.$prefix);
Die Funktion ''sprintf()'' sorgt dafür, dass der Antwortcode aus AF01 zweistellig (Formatcode ''%02d'') ausgegeben wird aus ''1'' wird dadurch der String ''%%'01'%%''.
Der Punkt (''.'') dient in PHP dazu, Strings zu verketten. Wenn in der Variable ''$prefix'' also z.B. "H01" gespeichert ist, dann wird aus ''%%'filter='.$prefix%%'' ein ''%%'filter=H01'%%''.