Kapitel 3. Fragedefinitionen

Fragen im Q. Skript werden einfach aneinandergereiht. Die Reihenfolge der Fragen ist hierbei nebensächlich, da die Abfolge im Fragebogen durch Screens und Blöcke festgelegt wird. Folgende Standardfragetypen sind in Q. verfügbar:

Die Eigenschaften oder Attribute einer Frage unterscheiden sich von Fragetyp zu Fragetyp. Allerdings gibt es einige, die allen Fragen gemein sind. Das folgende Listing greift inhaltlich etwas voraus, fasst aber kurz zusammen, welche Attribute sich grundsätzlich für jede Fragedefinition anwenden lassen.

Fragetyp NAME;
Text = "TEXT";
Title = "TITLE";
LABELLIST
Javascript = "JAVASCRIPT";
Css = "CSS";
SortId = "SORTID";
HtmlPreText  = "HTMLPRETEXT";
HtmlPostText = "HTMLPOSTTEXT";
PreHelptext  = "PREHELPTEXT";
PostHelptext = "POSTHELPTEXT";
PreInterviewerHelptext  = "PREINTERVIEWERHELPTEXT";
PostInterviewerHelptext = "POSTINTERVIEWERHELPTEXT";
InitActionBlock = { ... };
ContinueActionBlock = { ... };
ShowMaxLabels = NUMBER;
Nomissing = YES/NO;
Flt = BEDINGUNG;
Assert BEDINGUNG "Fehlertext bei Verstoß";
    

Eine SingleQ ermöglicht eine 1-aus-N Auswahl. Wie bei allen anderen Fragen auch, sind Fragetext und -titel optional. Antwortlabels sind hingegen zwingend erforderlich. Die Labeldefinition kann sehr komplex werden. Vollständige Ausführungen zu den Labels gibt es in „ Antwortlabel “.

Die SingleQ (und auch die MultiQ) gibt es mit unterschiedlichen Anordnungen, die mit dem HTML-Skript-Parameter singleQFormat umgeschaltet werden können:

// HTML{ singleQFormat = standard; };
// HTML{ singleQFormat = table; };
HTML{ singleQFormat = select; };

SingleQ lieblingsmarke;
Text = "Welche dieser Marken ist Ihre Lieblingsmarke?";
labels=
1 "Marke A"
2 "Marke B"
3 "Marke C"
4 "Keine davon"
;
    

Um den Antwort-Code zu speichern, verwendet Q. den Namen der Frage als Variablennamen. In diesem Beispiel wäre bei der Auswahl »Marke C« der Wert 3 in der Variablen lieblingsmarke gespeichert.

"lieblingsmarke" "3"
    

Weiterhin lassen sich SingleQs mit @insert(select FRAGENAME) auch als Auswahlliste an beliebigen Stellen in Textbereichen einbetten. Sie müssen hierzu, ohne selbst als Frage dargestellt zu werden, mit im jeweiligen Screen positioniert sein. Beispiel:

HTML { input=no; };
singleq sonstige;
labels=
1 "Sonstige Variante A"
2 "Sonstige Variante B"
;
HTML { input=yes; };

multiq hauptfrage;
text="Welche Variante bevorzugen Sie?";
labels=
1 "Variante a"
2 "Variante b"
3 "Variante c"
9 "sonstige, bitte auswählen: @insert(select sonstige)"
;
Screen scr = column(hauptfrage sonstige); 
    

Details zum HTML Parameter input finden sich in „HTML-Parameter“.

Alternative Auswahlmöglichkeiten

Die SingleQ kann auch eine Kombination aus Eingabefeld und Liste bieten und verkürzt die Liste durch eine inkrementelle Suche nach den bereits eingegebenen Zeichen.

HTML{ singleQFormat = select; };
SingleQ strassen;
text="Bitte wählen Sie eine Straße...";
labels=
9999 ""
1 "Amselweg"
2 "Drosselgasse"
3 "Finkensteg"
4 "Meisenstraße"
5 "Fasanenweg"
;
assert (strassen ne 9999) "Bitte wählen Sie aus.";
javascript="$('.strassen .qselect').combobox();";
      

Zusätzlich muss HTML{ singleQClass="GSingleQ"; }; gesetzt sein, was normalerweise in der Datei gbuttons.q im text-Verzeichnis erfolgt.

Eine weitere Möglichkeit besteht darin, durch die möglichen Werte zu scrollen. Der Name der Javascript-Funktion, die diesen Mechanismus bereit stellt, bezieht sich zwar auf das Mausrad, aber es funktioniert genauso gut mit dem Finger auf dem Tablet.

HTML{ singleQFormat = select; };
singleq stunde;
labels =
99 "Std"
1  "1"
// ...
23 "23"
24 "24"
;
javascript="
  createWheelSelector($('.stunde .qselect'), 60, './media/@insert(_surveyname)/scrollerimages/');
";
assert (stunde ne 99) "Bitte die Stunde wählen.";

// createWheelSelector(SELECTBOX, WIDTH-IN-PX, PATH-TO-LAYOUT-IMAGES);
      

Der Funktionsaufruf createWheelSelector bekommt mehrere Parameter mitgeliefert. Zum einen muss der Fragen- bzw. Variablenname als CSS-Klassenname mitgegeben werden (hier: ».stunde«). An zweiter Stelle steht im Funktionsaufruf die Breite in Pixeln (hier: 60) und zuletzt erhält die Funktion den Pfad zu den grafischen Elementen. Die Vorlagen für die grafischen Elemente finden sich im Verzeichnis root/media/demo_singleq_select/scrollerimages. Die grafischen Elemente sind notwendig, weil sie hervorheben, welcher Wert gewählt wurde.

Abbildung 3.1. SingleQ-Alternativen: Liste, Liste mit Suche, scrollbare Liste

Neben der SingleQ stellt die MultiQ ein syntaktisch identisches Gegenstück dar, welches eine N-aus-M Auswahl ermöglicht. Der HTML-Skript-Parameter singleQFormatschaltet, abgesehen von der Option select auch die Anordnung einer MultiQ um, siehe auch „ SingleQ “.

MultiQ lieblingsmarken;
Text = "Welche dieser Marken kennen Sie?"
labels=
1 "Marke A"
2 "Marke B"
3 "Marke C"
4 "Keine davon" single
;
    

Q. speichert die Eingabe in einem Array mit den Codes der Auswahl (in der Reihenhfolge, in der die Auswahl getroffen wurde) und trägt für die nicht ausgewählten Label den Missing-Wert ein. Wenn der Klick auf "Marke C" vor dem Klick auf "Marke B" erfolgte, speichert Q (bei einem Missing-Wert von 99):

"lieblingsmarken" "3 2 99 99"
    

Dabei spielt es keine Rolle wie häufig die Auswahl getroffen und zurück genommen wurde, Q. speichert die zuletzt getroffene Auswahl.

Bei der Abfrage der Variablen ergibt sich ein wesentlicher Unterschied zur SingleQ. Da die Variable einer SingleQ nur einen Wert speichert, können Bedingungen für Filter oder Plausibilitätsprüfungen mittels assert mit dem Gleichheitsoperator eq arbeiten. MultiQ-Fragen speichern dagegen mehrere Werte, und so ist eine mit eq formulierte Prüfung nur bedingt sinnvoll. Mit dem obigen Beispiel der Werte »3 2 99 99« für die Variable »lieblingsmarke«, liefe

flt=( lieblingsmarke eq 2 ) changepbar(1);
    

ins Leere, auch wenn »2« zur Ergebnismenge gehört (der Filter funktionierte nur, wenn die Menge nur aus »2« und missing-Werten bestünde). Daher sollte bei einer MultiQ zur Prüfung in verwendet werden:

flt=( 2 in lieblingsmarke ) changepbar(1);
    

Bei einer offenen Frage erscheint an Stelle von Antwortlabels ein Eingabebereich für Freitext. Breite und Höhe des Bereichs werden durch die HTML-Skript-Parameter textAreaRows (Anzahl der Zeilen) und textAreaCols (Spalten) festgelegt. Wünscht man nur eine Zeile, wird technisch aus der Fläche automatisch eine Zeile. Zusätzlich und vorrangig lässt sich der Eingabebereich auch über CSS formatieren. Mehr dazu in „Grafische Formatierung und Layout“.

HTML{ textAreaRows = 4; };
HTML{ textAreaCols = 80; };
OpenQ likes;
text = "Was gefällt Ihnen an dieser Marke besonders gut?";
    

Den eingegebenen Text der OpenQ speichert Q. in einer Zeichenkette:

"likes" "Design Verarbeitung"

Die Syntax entspricht der einer OpenQ, allerdings wird zur Darstellung ein Passwort-Feld (mit Punkten als Platzhalter für die Buchstaben) benutzt.

Eine TextQ ist genau genommen keine Frage, sondern nur ein Textbildschirm. Die Syntax entspricht der OpenQ, aber es wird kein Texteingabefeld angezeigt. Eine TextQ kann einen Fragetext haben, einen Titel, und den eigentlichen Text (dieser wird also nicht zwingend im Fragetext angegeben), das Schlüsselwort hierzu lautet screentext. Beispiel:

TextQ intervieweranweisung;
Text = "Intervieweranweisung";
screenText="Lieber Interviewer, bitte tun Sie nun dieses und jenes!";
    

Eine NumQ bietet die Möglichkeit, einen oder mehrere numerische Werte offen abzufragen (z.B. Alter, Postleitzahl usw.). Jedes Label korrespondiert mit einem Eingabefeld. Die erwartete Eingabe des Befragten kann exakt gesteuert werden. Die Definition erfolgt über das OpenNumFormat.

Das Format schränkt die Eingabemöglichkeiten der Befragten bei einer NumQ ein.

      OpenNumFormat NAME = VMIN VMAX NMIN NMAX WMIN WMAX [EXCL] "ERR";
    

Über NAME wird das OpenNumformat mit format an einzelne Labels gebunden. Es legt die Anzahl der Vorkommastellen VMIN bis VMAX, die Anzahl der Nachkommastellen NMIN bis NMAX und den Wertebereich insgesamt WMIN bis WMAX fest. Optional kann ein Wert für eine Enthaltungsoption EXCL außerhalb des eigentlichen Wertebereichs bestimmt werden (s.u.). Verstößt die Eingabe eines Befragten gegen diese Vorgaben, wird die Fehlermeldung ERR ausgegeben. Es können auch negative Werte verwendet werden. Vorzeichen (-/+) werden für die *MIN/*MAX-Werte nicht mitgezählt. Gleiches gilt für Dezimaltrennzeichen. Hier sind sowohl der Punkt als auch das Komma gültig und gleichwertig. 1000er Trennzeichen werden nicht unterstützt.

OpenNumFormat rating = 1 2 0 0 -10 10 "Bitte nur ganze Zahlen zwischen -10 und 10.";
NumQ nq;
Text="Bitte bewerten Sie alle Marken zwischen -10 und 10.";
labels=
1 "Marke A" format rating
2 "Marke B" format rating
3 "Marke C" format rating
;
          

Das eigentliche Eingabefeld der NumQ kann innerhalb des Labeltextes mit @input beliebig platziert werden, etwa mitten im Textfluss. Im weiteren Skriptverlauf lässt sich ein eingegebener Wert mit FRAGENAME.LABELCODE verwenden. Die direkte Referenz auf FRAGENAME liefert die Summe aller Eingaben zurück.

NumQ nq;
Text="Bitte bewerten Sie alle Marken zwischen -10 und 10.";
labels=
1 "Für Marke A vergebe ich @input Punkte" format rating
2 "Für Marke B vergebe ich @input Punkte" format rating
3 "Für Marke C vergebe ich @input Punkte" format rating
;
assert(nq gt 0)                             "Bitte mehr Plus- als Minuspunkte vergeben";
assert(nq.1 lt 0 or nq.2 lt 0 or nq.3 lt 0) "Mindestens einmal negativen Wert vergeben.";
    

Wie bei anderen Fragen auch, kann mit dem Schlüsselwort open in einer NumQ auch ein offenes Eingabefeld als Label angeboten werden. Mit @open lässt sich auch festlegen wo das Eingabefeld erscheinen soll.

NumQ nq;
Text="Bitte bewerten Sie alle Marken zwischen -10 und 10.";
labels=
1 "Für Marke A vergebe ich @input Punkte"    format rating
2 "Für Marke B vergebe ich @input Punkte"    format rating
3 "Für @open vergebe ich @input Punkte" open format rating
;

Die Eingabe einer NumQ speichert Q. immer in einem Array. Auch wenn mit einer NumQ nur ein Wert abgefragt wird, erscheint daher im Skriptcheck eine Mahnung, wenn die Variable nur summarisch über den Namen der Frage in einer Prüfung oder Bedingung verwendet wird, anstelle des genauen Variablennamens.

Opennumformat onf_sterne = 1 6 0 0 0 999999 "Verzählt!";
NumQ sterne;
Text="Weißt du wieviel Sternlein stehen?";
labels=
1 "@input Sterne" format onf_sterne
;
    

Die Eingabe »367485« speichert Q. als

"sterne.1" "367485"
    

Ein Vergleich wie sterne gt 1000 funktioniert zwar, veranlasst aber die angesprochene Mahnung im Skriptcheck. Besser wäre die Prüfung mit sterne.1 gt 1000. Bei den Eingaben »3, -4, 7« im vorangegangenen Beispiel »Bitte bewerten sie alle Marken« legte Q. die Werte in dieser Form ab:

"nq.1" "3"
"nq.2" "-4"
"nq.3" "7"
    

HTML{ numQClass = "GNumQ"; };
noAnswerLabel= "Keine Angabe";
OpenNumFormat rating_EXCL = 1 2 0 0 -10 10 99 "Bitte nur ganze Zahlen zwischen -10 und 10.";
OpenNumFormat rating = 1 2 0 0 -10 10 "Bitte nur ganze Zahlen zwischen -10 und 10.";
NumQ nq;
Text="Bitte bewerten Sie alle Marken zwischen -10 und 10.";
labels=
1 "Marke A" format rating_EXCL
2 "Marke B" format rating_EXCL
3 "Marke C" format rating
;	
      

HTML{ setProperty( "unspecified_button_checked" "round_cl.png" ); };
HTML{ setProperty( "unspecified_button_unchecked" "round_ac.png" ); };
      

Mit einer SingleGridQ kann ein Gitter aus Skalen dargestellt werden, beispielsweise eine Liste von Items untereinander. Sowohl die gridItems als auch die Antwortkategorien gridLabels werden in Form von Label-Listen angegeben. Für jedes Item kann nur eine Antwortmöglichkeit ausgewählt werden. Es können auch mehrere Gruppen von Antwortlabels nebeneinander stehen. Die Zeile mit den Antwortlabels kann alle n Items wiederholt werden (sinnvoll bei langen Itemlisten).

Die allgemeine Syntax ist:

SingleGridQ name;
Text="Fragetext";
gridItems=
Wert Text
...;
gridLabels=
Wert Text
...
;
    

Es gibt verschiedene Varianten der SingleGridQ.

SingleGridQ standardgrid;
text="Wie sehr stimmen Sie den folgenden Aussagen zu?";
gridItems=
1 "item 1"
2 "item 2"
3 "item 3"
4 "item 4"
5 "item 5"
;
gridLabels=
1 "stimme voll und ganz zu"
2 "stimme eher zu"
3 "teils/teils"
4 "stimme eher nicht zu"
5 "stimme überhaupt nicht zu"
;
      

SingleGridQ transponiert;
text="Wie wahrscheinlich werden Sie diese Städte besuchen?";
gridItems=
1 "Rom"
2 "Berlin"
3 "London"
;
gridLabels=
1 "bestimmt nicht besuchen"
2 "wahrscheinlich nicht besuchen"
3 "weiß nicht"
4 "wahrscheinlich besuchen"
5 "ganz sicher besuchen"
;
transpose;
showAllErrors;
      

SingleGridQ zweifragen;
text="Bitte beurteilen Sie die genannten Städte.";
gridItems=
1 "Rom"
2 "Berlin"
3 "London"
;
gridLabels=
1 "gut"
2 "mittel"
3 "schlecht"
;
gridLabels=
1 "ja"
2 "nein"
;
gridLabelHeader=("Wie gefällt Ihnen die Stadt insgesamt?" 
                 "Haben Sie die Stadt schon einmal besucht?");
anchorText="Bitte beurteilen!";
      

GRIDNAME.ITEMCODE.LABELGRUPPE
      

Beispiele:
Hat der Befragte bereits London besucht?  (zweifragen.3.2 eq 1)
Hat der Befragte London nicht besucht?    (zweifragen.3.2 eq 2)
Fand der Befragte Rom schlecht?           (zweifragen.1.1 eq 3)
Fand der Befragte Rom gut oder mittel?    ([1 2] in zweifragen.1.1)
      

SingleGridQ bipolar;
text="Directionals";
gridItems=
1 "zu süss|zu sauer"
2 "zu weich|zu hart"
3 "zu billig|zu teuer"
4 "zu gross|zu klein"
;
gridLabels=
1 "(1)"
2 "(2)"
3 "(3)"
4 "(4)"
5 "(5)"
;
bipolar;
      

Die MultiGridQ funktioniert entsprechend der SingleGridQ, nur dass es hier möglich ist, für jedes Item mehrere Antwortmöglichkeiten zu geben.

Alle zuvor erläuterten Funktionalitäten und Frageattribute der SingleGridQ lassen sich analog auch auf die MultiGridQ anwenden.

Die bei der MultiQ möglichen Eigenschaften der Antwortlabels, single und always, greifen auch bei der MultiGridQ.

Da die Datenablage parallel zur SingleGridQ etwas komplizierter wird, folgt hier ein etwas ausführlicheres Beispiel. Eine MultiGrid-Frage mit folgendem Code

multigridq s1;
text="Gadgets";
gridlabels=
2 "Fernsehen"
4 "Zeitung" 
6 "Kino"
8 "weiß nicht" single 
;
griditems=
1 "Telefon"
2 "Kamera"
3 "Tablet"
4 "Phablet"
95 "Anderes" open
;
    

stellt Q. wie folgt dar und verwendet, wie oben angesprochen, systematische Variablennamen für die Griditems und ordnet ihnen die durch die Labels vorgegebenen Werte zu.

Abbildung 3.2. Datenablage einer MultiGridQ

Und wie es die Grafik schon andeutet, speichert die MutliGrid-Frage die Eingabe in dieser Form (_missing = -1):

"s1.1.1" "2 4 6 -1"
"s1.2.1" "4 6 -1 -1"
"s1.3.1" "8 -1 -1 -1"
"s1.4.1" "6 -1 -1 -1"
"s1.95.1" "4 -1 -1 -1"
"s1.95.open" "Brille"
    

Um sicher zu stellen, dass nur Leute interviewt werden, die nicht »weiß nicht« zu Phablets sagen, sähe die assert-Formulierung so aus:

assert( not( 8 in s1.4.1 )) "Sorry" exit 2;
    

Außerdem soll, solange nicht »weiß nicht« zur offenen Nennung angekreuzt wird, sicher gestellt werden, dass das Eingabefeld auch ausgefüllt ist:

if( [2 4 6] in s1.95.1 ) assert( num(s1.95.open) gt 0 ) "Bitte Gadget eintragen"; 
    

Wie im Rahmen der MultiQ (s. „ MultiQ “) bereits erläutert, sind Prüfungen von MultiQ-Variablen mit dem Gleichheitsoperator eq nur bedingt sinnvoll, weil MultiQ-Fragen Ergebnismengen speichern. Da MultiGridQ-Fragen aus einzelnen MultiQ-Fragen zusammen gesetzt sind, gilt hier das Gleiche.

Viele Fragen bieten eine Liste von vorgegebenen Antwortmöglichkeiten (Label), aus denen der Befragte eine oder mehrere auswählt. GESS Q. eröffnet verschiedene Möglichkeiten, diese Liste zu gestalten. In diesem Kapitel sollen zunächst die Möglichkeiten von Labellisten beschrieben und anschließend an konkreten Beispielen verdeutlicht werden.

Eine Labelliste wird im Rahmen der Fragedefinition innerhalb des Statements labels= ... ; definiert. Hiermit lässt sich eine beliebige Abfolge von einzelnen Labels oder Labelgruppen definieren. Allgemein ausgedrückt:

labels=
[LABEL | LABELGROUP | splitcolumn]+
;
    

LABEL können optional mit einem oder mehreren Parametern versehen werden:

LABELCODE "LABELTEXT" [always] [flt] [open] [random] [single] 
    

Um all das konkret darzustellen, ein paar Beispiele:

Angenommen, es soll eine Liste von Automarken abgefragt werden. Die Defintion der Frage wäre:

MultiQ marken;
labels=
1 "Audi"
2 "BMW"
3 "Mercedes-Benz"
;
    

Diese sollen nun in zufälliger Reihenfolge erscheinen (d.h., von Interview zu Interview verschieden). Daher setzen wir ein random hinter jedes Label:

MultiQ marken;
labels=
1 "Audi" random
2 "BMW" random
3 "Mercedes-Benz" random
;
    

In einer weiteren Frage sollen nun zu jeder Marke je drei Modelle auf Bekanntheit abgefragt werden. Hier die simple Version der Labeldefinition:

MultiQ modelle;
labels=
1 "Audi A4"
2 "Audi A6"
3 "Audi A8"
4 "BMW 3er"
5 "BMW 5er"
6 "BMW 7er"
7 "Mercedes-Benz C-Klasse"
8 "Mercedes-Benz E-Klasse"
9 "Mercedes-Benz S-Klasse"
;
    

Um das etwas schöner aussehen zu lassen, sollen die Marken als reine Textzeile über den Labels stehen:

MultiQ modelle;
labels=
text " "
text "Audi"
1 "A4"
2 "A6"
3 "A8"
text ""
text "BMW"
4 "3er"
5 "5er"
6 "7er"
text ""
text "Mercedes-Benz"
7 "C-Klasse"
8 "E-Klasse"
9 "S-Klasse"
;
    

Die einzelnen Marken sollen nun, wie bei der Markenbekanntheitsfrage, in zufälliger Reihenfolge erscheinen, inklusiv ihrer mittels text eingefügten Überschriften. Dazu fassen wir sie zu Gruppen zusammen, und geben den Gruppen das random-Attribut:

MultiQ modelle;
labels=
group (
text ""
text "Audi"
1 "A4"
2 "A6"
3 "A8"
) random
group (
text ""
text "BMW"
4 "3er"
5 "5er"
6 "7er"
) random
group (
text ""
text "Mercedes-Benz"
7 "C-Klasse"
8 "E-Klasse"
9 "S-Klasse"
) random
;
    

Die einzelnen Modelle sollen nun innerhalb der Marken ebenfalls zufällig verteilt werden:

MultiQ modelle;
labels=
group (
text " "
text "Audi"
1 "A4" random
2 "A6" random
3 "A8" random
) random
group (
text " "
text "BMW"
4 "3er" random
5 "5er" random
6 "7er" random
) random
group (
text " "
text "Mercedes-Benz"
7 "C-Klasse" random
8 "E-Klasse" random
9 "S-Klasse" random
) random
;
    

Außerdem sollen die Modelle einer Marke nur dann abgefragt werden, wenn die Marke insgesamt vorher als bekannt angegeben wurde. Hierzu wird jede Labelgruppe mit einem Filter versehen. Dazu soll noch eine exklusive Antwortmöglichkeit keine davon erscheinen, wofür das Attribut single genutzt wird. Das sieht dann so aus:

MultiQ modelle;
labels=
group (
text " "
text "Audi"
1 "A4" random
2 "A6" random
3 "A8" random ) random flt (marken eq 1)
group (
text " "
text "BMW"
4 "3er" random
5 "5er" random
6 "7er" random ) random flt (marken eq 2)
group (
text " "
text "Mercedes-Benz"
7 "C-Klasse" random
8 "E-Klasse" random
9 "S-Klasse" random ) random flt (marken eq 3)
text " "
10 "keine davon" single
;
    

Die mögliche Komplexität der Labeldefinitionen wird hier erkennbar. Wie genau man die Zeilenumbrüche setzt ist egal, theroetisch könnte man auch alles in eine Zeile hintereinander schreiben.

Bei der NumQ kann außerdem noch der Platzhalter @input an die Stelle des Labeltextest eingefügt werden, an der das Eingabefeld erscheinen soll. Siehe „ NumQ “.

NumQ punkte;
Text="Bitte verteilen Sie 10 Punkte auf diese Marken";
labels=1 "Marke A: @input Punkte" format f1
2 "Marke B: @input Punkte" format f1
3 "Marke C: @input Punkte" format f1
4 "Marke D: @input Punkte" format f1
5 "sonstige Marke (bitte angeben) @open : @input Punkte" format f1;