====== 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 ''[[:de:create:functions:preset|preset()]]'')

Die Fragetypen [[:de:create:questions:extselect|Erweiterte Auswahl]] und [[:de:create:questions:suggest|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 ''[[:de:create:functions:dbget|dbGet()]]'' und ''[[:de:create:functions:dbset|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 ''[[:de:create:functions:dbkeys|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.

===== Funktion =====

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:

^Schlüssel^Daten (Kombinationen)^
|A1|(Apfelbaum, Äpfel)|
|A2|(Birnbaum, Birnen)|
|A3|(Clementinenbaum, Clementinen)|
|B1|(6)|
|B2|(12)|
|B3|(18)|
|B4|(24)|
|B5|(30)|


===== Daten einlesen =====

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:

|A1|Apfelbaum|Äpfel|
|A2|Birnbaum|Birnen|
|A3|Clementinenbaum|Clementinen|
|B1|6| |
|B2|12| |
|B3|18| |
|B4|24| |
|B5|30| |

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 ([[multilang|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.


===== Daten ändern =====

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 ''[[:de:create:functions:dbset|dbSet()]]'' können Einträge in der **Datenbank für Inhalte** auch während des Interviews geändert oder gelöscht werden.


===== Beispiel 1: Umfangreiches Testmaterial =====

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 [[:de:create:random_urns|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:

^Schlüssel^Titel^Text^
|a1|Streik der Lokführer: Gesellschaft als Geisel|Das Streikrecht ist aus guten Gründen in der Verfassung ...|
|a2|Die Funktion von Junckers Netzwerk|EU-Kommissionschef Juncker pflegt Beziehungen mit Europas Führungskräften...|
|a3|Carsten Maschmeyer verklagt Schweizer Bank|Der Investor Carsten Maschmeyer hat nach Informationen der Süddeutschen ...|

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. [[:de:create:random_urns|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:

<code php>
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>
');
</code>


===== Beispiel 2: 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.

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:

<code php>
$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);
</code>

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:

<code php>
$key = 'FS-'.caseSerial();
$sender = dbGet($key);
question('NU03', $sender);
</code>


===== Beispiel 3: 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:

<code php>
$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>');
</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.

<code php>
$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>
');
</code>


===== Beispiel 4: 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 "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.

|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 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.

<code php>
$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');
</code>


===== Beispiel 5: 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-<Seriennummer>" 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 ''[[:de:create:functions:value]]'').

<code php>
$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);
</code>