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 Teilnahmeschlüssels (Seriennummer) 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 CSV (Character Separated Values) ab. Das ist nichts anderes als eine Textdatei, 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 (CSV) die CSV-Datei 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.

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

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.

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.

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.

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();  // Der Seriennummer 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);

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 „Seriennummer“) 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 Seriennummer (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');