Variablen in SoSci Survey

In dieser Anleitung ist an vielen Stellen von Variablen die Rede. Beschreibt man Variablen für Programmierer, so sind es Speicherplätze für Daten (z.B. für eine Zahl oder einen Text). Ein Mathematiker würde dagegen sagen, eine Variable ist ein Platzhalter für veränderliche (Zahlen-)werte.

In SoSci Survey können Sie auf verschiedene Arten von Variablen treffen:

• PHP-Variablen sind Bestandteil der Programmiersprache PHP. Sie tauchen direkt im PHP-Code (also ein Element PHP-Code beim Zusammenstellen des Fragebogens) auf und werden mit einem Dollar-Zeichen als Variablen erkennbar, z.B. $alter = 5;. Diese Anweisung speichert den Wert 5 in der Variable $alter. PHP-Variablen werden weiter unten ausführlicher beschrieben.
• Daten-Variablen nehmen die Antworten des Befragten auf. Sie kommen im Datensatz vor, den man bei einer Befragung erhebt. Jedes Interview erzeugt einen neuen Fall im Datensatz und enthält eine Reihe von Variablen. Die Variablen-Übersicht listet alle Daten-Variablen, die in einem Befragungsprojekt vorkommen. So gehört z.B. zu jedem Item einer Skala eine Daten-Variable. Die Antwort, die ein Befragter gegeben hat, kann mit der Funktion value() ermittelt werden.
• Interview-Variablen sind eine Ergänzung zu den PHP-Variablen. PHP-Variablen gelten nämlich nur innerhalb eines PHP-Code Elements. Will man einen Wert aber auch später verwenden (z.B. eine gewürfelte Zahl), so kann man die Variable mittels registerVariable() für weitere Seiten verfügbar machen oder (falls man den Wert in der Auswertung benötigt) mittels put() in eine interne Variable speichern.
• Interne Variablen sind spezielle Daten-Variablen. Sie gehören nicht zu einer normalen Frage, sondern zu einer Frage vom Typ Interne Variablen. Jedes Item in so einer Frage erzeugt eine interne Variable, die auch im Datensatz auftaucht. Mit der Funktion put() kann man einen Wert in eine interne Variable und damit in den Datensatz speichern.

Variablen werden in PHP mit einem Dollar-Zeichen geschrieben, z.B. $version. Mit einem einfachen Gleichheitszeichen (=) wird ihnen ein Wert zugewiesen. Mit einem doppelten Gleichheitszeichen (==) wird dieser Wert mit einem anderen Wert verglichen.

$version = 1;
if ($version == 1) {
  text('stimulus1');
} else{
  text('stimulus2');
}

$version = random(1, 2);
if ($version == 1) {
  text('stimulus1');
} else{
  text('stimulus2');
}

Hinweis: Eine Variable bleibt normalerweise nur innerhalb eines PHP-Code Elements erhalten. Wenn Sie den Wert auf einer späteren Seite wieder brauchen, verwenden Sie registerVariable() oder put() und value().

Beispiel für Rechnung

// Auf Seite 1 eine Frage stellen
question('AB01');  // Texteingabe für eine Zahl

// Auf Seite 2 mit der angegeben Zahl rechnen
$nummer = value('AB01');  // Zuweisen der angegeben Zahl zur Variable $nummer
$nummer = (int)$nummer;   // Sicherstellen, dass es eine Zahl ist
$ergebnis = 2 * $nummer;  // Zahl mit 2 multiplizieren
// Etwas schreiben - Texte werden in PHP mit einem Punkt verbunden
 html('<p>Sie haben die Hälfte von '.$ergebnis.' angegeben</p>');

Um den Inhalt einer Variable über das Interview hinaus im Datensatz zu speichern, verwenden Sie eine interne Variable (s. oben) in Verbindung mit der Funktion put().

Speichern einer Randomisierung

$items = random_items('AB01'); // Randomisierte Reihenfolge der Items
                               // Für Frage AB01 in $items speichern
html('<p>Zur Kontrolle: '.$items.'</p>');  // Reihenfolge anschreiben
put('IV01_01', $items);    // Reihenfolge in eine interne Variable IV01_01 speichern
question('AB01', $items);  // Frage mit randomisierten Items stellen