Documentation

formgen Variablen und Dynamisierungen

Einleitung

Durch die Einbettung von formgen Befehlen kann man die Ausgabe (z.B. Fragentemplates) sehr flexibel gestalten.
Folgende Variablen stehen zur Verfügung:

Variablen

Kontext: Start-/Endeseite

Variablenname	Beschreibung
startTitle1	Title1
startTitle2	Title2
startTitle3	Title3
startBody	Body Startseite
endBody	Body Endeseite
body	Neue Variable body, Start und Endebody
isStartPage	'true' wenn gerade Startseite angezeigt wird
isEndPage	'true' wenn gerade Endseite angezeigt wird

Kontext: Fragebogen

Variablenname	Beschreibung
userID	Aktuelle userID
vorgnr	Aktuelle Vorgnr
language	Aktuelle Sprache (ISO Code)
runmode	Aktueller Runmode (runtime, preview, print)
page	Aktuelle Seitenummer
pagecount	Anzahl der Seiten insgesamt
pagetitle	Seitentitel
pageident	Pageidentifier (Seitennummer vor einer Rotation)
progress	Fortschritt in ganzzahligen Prozent
author	Fragebogen Autor
title	Fragebogen Titel
canEnterQuestionaire	Darf der Benutzer in den Fragebogen geleitet werden?
isFilledComplete	'true' falls der Fragebogen schon komplett ausgefüllt wurde
responseStatus	Response Status
isLastPage	'true' falls letzte Seite erreicht
questionaireError	'true' falls Fehler im Fragebogen
questionaireErrorText	Text der Fehlermeldung
questionaireErrorTexts	Texte der Fehlermeldung, Array
questionaireEnd	'true' wenn Ende erreicht
questionaireTarget	Enthält die TargetURL

Kontext: Frage

Variablenname	Beschreibung
questionTitle	Fragentitel
questionText1	Fragetext 1
questionText2	Fragetext 2
questionCode	Fragencode
questionError	'true' falls Fehler in dieser Frage aufgetreten ist
questionErrorText	Enthält den Fehlertext
questionID	Aktuelle QUE_ID
questionIndex	Zähler über die Questions (beginnt bei 0)
questionNum	Laufende Nummer der Frage, nicht sichtbare Fragen werden nicht mitgezählt
questionAnswerCount	Anzahl der Antwortmöglichkeiten
questionPicture	Enthält den Image-Tag, falls für die Frage ein Bild definiert ist
questionPictureSrc	Enthält nur die Src zum Image Tag
freetext	'true' falls zusätzliche Freitexteingabe möglich (Kompatibilität)
questionFreetext	'true' falls zusätzliche Freitexteingabe möglich
questionInput	'true' falls Pflichteingabefeld

Kontext: Antwort

Variablenname	Beschreibung
answerIndex	Zähler über die Answers (beginnt bei 0)
answerNum	Laufende Nummer
answerText	Antworttext
answerName	HTML-Name des Input-Items
answerValue	Wert der Antwort
answerCode	Frei definierbarer Antwortcode
answerGroup	Antwortgruppe
answerPoints	Punkte dieser Antwort
answerChecked	Enthält das Wort "checked", falls Antwort ausgewählt
answerSelected	Enthält das Wort "selected", falls Antwort ausgewählt
answerPicture	Enthält den img-Tag, falls Bild vorhanden

Kontext: Matrix

Variablenname	Beschreibung
matrixIndex	Zähler über die Matrix
matrixValue	Wert des Matrixpunktes
matrixName	Matrix Name
matrixGroup	Matrix Gruppe
matrixRating	Matrix Rating

In den Templates sind außer den Standard-formgen-Tags, diese speziellen Frage-Tags möglich.

Befehl	Beschreibung
[question answers -group "gruppe"] ... [/question]	Iteriert über alle Antworten der aktuellen Frage des Fragebogens.   Alle Variablen, die sich auf eine Antwort beziehen, werden entsprechend gesetzt.   Mit Hilfe der Option -group kann eine bestimmt Gruppe selektiert werden.
[question matrix -group "gruppe"] ... [/question]	Iteriert über alle Matrix-Punkte der aktuellen Frage des Fragebogens.   Alle Variablen, die sich auf eine Matrix-Antwort beziehen, werden entsprechend gesetzt.   Mit Hilfe der Option -group kann eine bestimmt Gruppe selektiert werden.
[question freetext] ... [/question]	Gibt den Body aus, falls bei dieser Frage eine Freitextantwort erlaubt ist.   Alle Variablen, die sich auf eine Antwort beziehen, werden entsprechend gesetzt.
[question picture] ... [/question]	Gibt den Body aus, falls zu dieser Frage ein Bild existiert.   In der Variable questionPicture kann der entsprechende Image-Tag abgegriffen werden.