Datenbank für Inhalte

In den Spezialfunktionen findet sich eine Datenbank für Inhalte. Dies ist eine projektinterne Miniatur-Datenbank (nicht-relational), in der Daten für die Verwendung im Fragebogen abgelegt oder sogar während des Interviews geändert werden können. Das führt zu vielfältigen Möglichkeiten, z.B.

• Eine größere Anzahl von Textfragmenten effizient verwalten
• Werte an nachfolgende Interviews übergeben
• Daten über mehrere Interviews hinweg verwalten (z.B. Quoten zählen, Stimuli systematisch rotieren) bzw. Daten zwischen Interviews austauschen
• Anhand des Personenkennung, dem Teilnahmecode oder der Referenz personalisierte Daten einblenden (Daten im Interview zuspielen)
• Eingabefelder im Fragebogen individuell vorbelegen (in Kombination mit preset())

Die Fragetypen Erweiterte Auswahl und Texteingabe mit Auswahlempfehlung bieten darüber hinaus die Möglichkeit, auf die Datenbank zuzugreifen. So lassen sich sehr umfangreiche und/oder dynamische Auswahlfragen programmieren.

Um mittels PHP-Code auf die Datenbank zuzugreifen, dienen die Befehle dbGet() und dbSet(). Mit dem Befehl dbGet() werden die Daten zu einem Schlüssel ausgelesen, mit dbSet() können Daten in die Datenbank geschrieben werden. Mit dem Befehl dbKeys() lassen sich die verfügbaren Schlüssel auflisten.

Wichtig: Bitte beachten Sie, dass die Daten in der Datenbank für Inhalte beim Export des Projekts noch nicht exportiert werden. Beim Archivieren eines Projekts werden die Daten nicht archiviert, sondern gelöscht. Eine Änderung dieses Verhaltens ist in kommenden Programmversionen angedacht.

In der Datenbank für Inhalte können Paare aus jeweils einem Schlüssel (eine Kennung) und Daten hinterlegt werden.

• Der Schlüssel kann eine Zahl oder ein kurzer Text (max. 64 Zeichen) sein.
  • Wenn man Schlüssel für unterschiedliche Kategorien benötigt, kann man dem Zahlencode einfach einen Buchstaben voranstellen, z.B. A1, A2 und A3 für Kategorie 1 sowie B2, B2, B3 und B4 für Kategorie 2.
  • Der Schlüssel darf zu Beginn und am Ende keine Leerzeichen enthalten (diese werden abgeschnitten). Steuerzeichen (Tabulator o.ä.) werden entfernt. Leerzeichen und Sonderzeichen sind hingegen erlaubt.
• Die Daten sind jeweils Kombinationen (Arrays) aus einer oder mehreren Texten und/oder Zahlen. Zahlen werden wie Texte behandelt und liegen später im Fragebogen als Text vor (z.B. '1'). Steuerzeichen (z.B. Zeilenumbrüche) sind in den Texten nicht möglich – HTML-Tags selbstverständlich schon.

Im Fragebogen kann man dann anhand des Schlüssels die hinterlegten Daten abrufen. Bildlich dargestellt könnte eine Datenbank folgende Paare aus Schlüsseln und Daten enthalten:

Die Daten müssen zunächst in einer Tabelle vorliegen, z.B. in Excel oder OpenOffice Calc:

• Dabei muss die erste Spalte den Schlüssel enthalten,
• die weiteren Spalten enthalten die Daten.
• In der ersten Zeile dürften keine Überschriften stehen, die Tabelle muss sofort mit Daten beginnen.

Um die oben dargestellten Datenbankeinträge zu erzeugen, würde Ihre Tabelle aussehen wie folgt:

Diese Tabelle speichern Sie im Dateiformat XLSX (Excel) oder CSV (Character Separated Values) ab. CSV-Dateien sind Textdateien, in der die Werte hintereinander stehen und durch ein vorgegebenes Zeichen (z.B. einen Tabulator) getrennt sind.

Wählen Sie unter Spezialfunktionen → Datenbank für Inhalte nun bei Daten einlesen die Tabelle aus und bestätigen mit OK. Im folgenden Fenster werden noch ein paar Details abgefragt – normalerweise erkennt SoSci Survey die korrekten Format-Einstellungen der Datei automatisch.

Hinweis: Jede Zeile in der Tabelle muss mindestens 2 Spalten haben. Zeilen, die nur einen Schlüssel oder gar keine Daten enthalten, werden beim Import ignoriert.

Wenn Sie in einem mehrsprachigen Projekt arbeiten, können Sie für unterschiedliche Sprachversionen unterschiedliche Daten hinterlegen. Das Programm prüft beim Abruf eines Datenbank-Eintrags, ob für die aktuelle Sprachversion ein eigener Eintrag vorliegt – und wenn nicht, wird der Eintrag aus der Basissprache verwendet (Mehrsprachige Befragungen).

Sie können in der Import-Datei festlegen, für welche Sprache ein Eintrag gedacht ist. Erstellen Sie dazu eine Spalte mit dem Namen LANGUAGE.

Die Datenbank für Inhalte kann auch JSON-Objekte speichern. Diese können nicht über dbGet() sondern nur über dbRetrieve() abgerufen werden. Anders als „normale“ Datenbankeinträge können hier auch keine unterschiedlichen Sprachversionen hinterlegt werden.

Geben Sie als LANGUAGE den Code „qcb“ ein, um JSON-Objekte als solche zu importieren. Für JSON-Einträge ist nur eine Spalte erlaubt.

Sofern Sie die Daten ändern möchten, importieren Sie eine neue/weitere CSV-Datei. Doppelte Schlüssel werden dabei aktualisiert (überschrieben). Ansonsten werden bestehende Schlüssel nicht verändert.

Um Einträge zu löschen, können Sie im Karteireiter „Einträge Löschen“ entweder einzelne Einträge entfernen oder die gesamte Datenbank (alle Einträge) löschen.

Mit der Funktion dbSet() können Einträge in der Datenbank für Inhalte auch während des Interviews geändert oder gelöscht werden.

Falls die Daten während der Erhebung mittels dbSet() aktualisiert wurden, kann man den Inhalt der „Datenbank für Inhalte“ jederzeit als CSV-Datei herunterladen:

Spezialfunktionen → Datenbank für Inhalte → Knopf „Herunterladen“

In einer Studie sollen 500 Zeitungsartikel von unterschiedlichen Personen beurteilt werden. Die Artikel entstammen einer elektronischen Datenbank und liegen bereits in tabellarischer Form vor. Damit jeder Artikel gleich häufig beurteilt wird, kommt eine Randomisierung mit Urnen zum Einsatz. Aber es wäre denkbar ineffizient, 500 Textbausteine einzeln anzulegen.

Zunächst müssen die Artikel in die projektinterne Datenbank importiert werden. Dazu wird in einer Tabellenkalkulation eine Tabelle mit den 500 Artikeln wie folgt angelegt:

Die Tabelle wird als CSV-Datei gespeichert. Die erste Zeile dient hier nur der Beschriftung – der der CSV-Datei sollte sie nicht enthalten sein. Unter Spezialfunktionen → Datenbank für Inhalte wird die CSV-Datei in das Projekt importiert.

In der Urne „artikel“ liegen die Zahlen 1 bis 500 (jeweils eine Zahl pro Zeile). Details zur Urnenziehung s. Randomisierung mit Urnen.

Im Fragebogen wird ein Zettel aus der Urne entnommen, mittels dbGet() der Eintrag aus der Datenbank ausgelesen und anschließend via html() der Artikel angezeigt:

urnDraw('artikel', 'IV01');
$key = 'a'.value('IV01_01');  // Ein "a" vor die Zahl schreiben
$inhalt = dbGet($key);
 
html('
  <h2>'.$inhalt[0].'</h2>
  <div>'.$inhalt[1].'</div>
');

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 (Mehrwellige Befragungen bei Selbstrekrutierung), 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.

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 (valueMean(), 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('<h1>Ergebnisse</h1><p>Bitte notieren Sie <strong>'.$code.'</strong></p>');

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:

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('
  <p>Ausgeschlafenheit: '.$result[0].'%</p>
  <p>Schlauheit: '.$result[1].'%</p>
  <p>Gemütlichkeit: '.$result[2].'%</p>
');

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.

Der Code wird im personalisierten 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');

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-<Teilnahmecode>“ a-priori Daten hinterlegt (3 Einträge pro Person, also Indizes 0 bis 2). In Befragungswelle 1 soll nun eine Produktpräferenz aus Frage PP01 als viertes Datum (Index 3) ergänzt werden. Der folgende PHP-Code könnte dann auf der Seite nach der Seite mit PP01 stehen (s. Hinweise zu value()).

$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);

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:

1. 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“.
2. 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.
3. 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 Erweiterte Auswahl erstellt. Die Optionen sollen diese beiden Fragen 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 Texteingabe mit Auswahlempfehlung 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 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'.