Question type - Date/de: Difference between revisions
From LimeSurvey Manual
(Created page with "{{QS:date_max/de}}") |
(Created page with "{{QS:em_validation_q/de}}") |
||
Line 33: | Line 33: | ||
{{QS:em_validation_q}} | {{QS:em_validation_q/de}} | ||
{{QS:em_validation_q_tip}} | {{QS:em_validation_q_tip}} |
Revision as of 08:41, 19 September 2017
Kurzbeschreibung
Mit diesem Fragetyp kann ein Datum, eine Uhrzeit oder eine Kombination von Datum und Uhrzeit erhoben werden. Datum und Uhrzeit können direkt eingegeben werden, aus einem Popup-Kalender oder aus Drop-Down-Boxen ausgewählt werden. Zur Validierung können Minimal- und Maximaldaten festgelegt werden. Verschiedene Datums-und Zeitformate werden unterstützt. Einige Funktionen sind erst ab LimeSurvey Version 2.05+ verfügbar.
Basis-Einstellungen
Pflichtangabe
Beschreibung:
Mit dieser Option wird festgelegt, ob eine bestimmte Frage von Umfrageteilnehmern zum Fortfahren beantwortet werden muss. Müssen nur bestimmte Unterfragen beantwortet werden, verwenden Sie das Attribut minimale Antwort in der Registerkarte Logik (nur bei Matrix- oder Mehrfachauswahlfragen).
Verfügbare Optionen:
- An – Die Frage muss beantwortet werden, bevor der Teilnehmer zur nächsten Seite gehen kann – die Antwortoption „Keine Antwort“ wird nie angezeigt.
- Weich – Wenn die Frage nicht beantwortet wird, wird eine Warnung angezeigt, wenn versucht wird, zur nächsten Seite zu gelangen – der Teilnehmer kann die Warnung jedoch ignorieren und fortfahren. Beachten Sie, dass die Option „Keine Antwort“ weiterhin angezeigt wird (falls in den Einstellungen der Umfragepräsentation aktiviert)
- Aus (Standard) – Frage kann unbeantwortet bleiben
Bedingung (früher „Relevanzgleichung“)
Beschreibung:
Ist der Ergebniswert der Bedingung „1“ oder „wahr“, ist die Frage im Umfragekontext „relevant“, wird also dem Umfrageteilnehmer angezeigt. Wenn nicht, wird die Frage ausgeblendet. Für jede Umfragefrage können Sie eine Relevanzgleichung angeben. Diese Funktion ist der Nachfolger von conditions und unterstützt eine wesentlich komplexere bedingte Logik.
Syntax-Hervorhebung:
Wenn Sie die Bedingung speichern, wird sie ausgewertet und syntaktisch hervorgehoben. Eventuelle Fehler werden farblich gekennzeichnet, sodass Sie sie schnell erkennen und beheben können.
Gültige Werte:
- Jede Bedingung, die die Syntax ExpressionScript ohne umgebende geschweifte Klammern verwendet.
Beispiel
Hier finden Sie Beispiele für die Syntax-Hervorhebung (derzeit nur auf Englisch).
Erweiterte Einstellungen
Umgekehrte Antwortreihenfolge (reverse)
Beschreibung
Bei Aktivierung wird die Reihenfolge der Antworten umgekehrt.
Verfügbare Optionen
- An
- Aus (Standard)
Beispiel
Nehmen wir an, Sie möchten den Fragetyp „Array (Zahlen)“ verwenden. Wenn diese Option deaktiviert ist (Standardwert), kann ein Umfrageteilnehmer folgende Antwortmöglichkeiten auswählen: „1, 2, 3, ..., 10“. Wenn diese Einstellung aktiviert ist, wird die Reihenfolge der verfügbaren Antworten umgekehrt: „10, 9, 8, ... , 1“.
Randomisierungsgruppenname (random_group)
Beschreibung
Dabei werden die Fragen in eine bestimmte Zufallsgruppe eingeteilt, wobei den Umfrageteilnehmern alle in der angegebenen Gruppe enthaltenen Fragen in zufälliger Reihenfolge angezeigt werden.
Eine Beispielumfrage mit dem Namen der Randomisierungsgruppe finden Sie in ExpressionScript-Beispielumfrage.
Gültige Werte
Geben Sie einfach eine beliebige Zeichenfolge ein (zum Beispiel: „Gruppe1“). Alle Fragen, die im Feld „Randomisierungsgruppenname“ die gleiche Zeichenfolge festgelegt haben, erhalten ihren Platz in der Umfrage randomisiert (=zufällig untereinander ausgetauscht).
Vorschau
Um eine Vorschau der Fragen anzuzeigen, verwenden Sie die Funktion „Umfragevorschau“ anstelle der Funktion „Fragengruppenvorschau“, da bei der zweiten Funktion Berichten zufolge die Fragen nicht in zufälliger Reihenfolge angezeigt werden.
Anzeige als Klappboxen (Dropdownfelder)
Beschreibung
Wenn diese Option aktiviert ist, zeigt der Fragetyp „Datum/Uhrzeit“ den Befragten anstelle des Standard-Popups ein Dropdown-Feld an, in dem sie Datum/Uhrzeit auswählen können.
Verfügbare Optionen
- Ja
- Nein (Standard)
Beispiel
Wenn es aktiviert ist, wird die Frage wie folgt angezeigt:
Beschreibung
Wenn diese Option aktiviert ist, wird die Frage immer ausgeblendet und den Umfrageteilnehmern nicht angezeigt. Diese Funktion kann in folgenden Szenarien verwendet werden:
- Wenn Sie eine Frage mit einer URL vorfüllen möchten und diese nicht auf dem Bildschirm angezeigt werden soll. Dies überschreibt alle in der Umfrage verwendeten Bedingungen, da die jeweilige Frage nicht einmal in die Seite eingebettet wird.
- Wenn Sie einen Wert im laufenden Betrieb über das Expressionscript speichern oder berechnen möchten.
Verfügbare Optionen
- Ein
- Aus (Standard)
Mindestdatum (date_min)
Beschreibung
Dieses Fragenattribut kann verwendet werden, um den Mindestwert für eine Datumsfrage festzulegen (im j-m-t Format oder einer beliebigen gültigen englischen Zeichenfolge - siehe unten für weitere Details). Es kann sowohl für Popup- als auch für Dropdown-Anzeigeoptionen verwendet werden. Wenn kein Mindestdatum festgelegt ist, wird 1.1.1900 als Standard verwendet.
Gültige Werte
- Beliebiger Datumswert im Format JJJJ-MM-TT (z. B. 24.08.2017);
- Beliebiger Jahreswert
- Beliebige Englishe Ausdrücke: " now "," -10 years ","tomorrow"
- Verweis auf eine andere Datums- / Zeitfrage: AnotherDateQuestion (unter Verwendung des Fragencodes)
- Ausdrücke: Mit Ausdrücken kann ein Mindestdatum dynamisch berechnet werden. Sie können beispielsweise ein Datum aus einer vorherigen Antwort + mindestens 3 Tage für die aktuelle Frage verwenden, indem Sie folgendes eingeben: Date("Y-m-d", strtotime (departuredate) + 3*60*60*24)"
Maximales Datum (date_max)
Beschreibung
Dieses Frageattribut kann verwendet werden, um den Maximalwert für die Datumsfrage festzulegen (im YMD-Format oder einer anderen gültigen englischen Zeichenfolge – weitere Optionen finden Sie unten). Es kann sowohl für Popup- als auch für Dropdown-Anzeigeoptionen verwendet werden.
Gültige Werte
- Beliebiger Datumswert im Format „JJJJ-MM-TT“ (z. B. „24.08.2018“);
- Beliebiger Jahreswert;
- Beliebige englische Zeichenfolge: „now“, „-10 Jahre“, „morgen“;
- Verweis auf eine andere Datums-/Uhrzeitfrage: AnotherDateQuestion (unter Verwendung des Fragecodes);
- Ausdrücke: Mit Ausdrücken kann ein Datum dynamisch berechnet werden. Sie können beispielsweise ein Datum aus einer vorherigen Antwort + 3 Tage als maximales Datum für die aktuelle Frage verwenden, indem Sie Folgendes eingeben: date("Ymd",strtotime(departuredate)+3*60*60*24).
Datum/Zeit-Format
Beschreibung
Dieses Fragetattribut kann dafür verwendet werden ein spezielles Datums-Anzeigeformat anzugeben. Wenn dies leer gelassen wird, wird das Standard-Umfrageformat genutzt.
Gültige Werte
- Die Formate d/dd,m/mm,yy/yyyyy,H/HH,M/MMM können zur Anzeige von Datum und/oder Uhrzeit verwendet werden, während "-", ".", "/", ":" als Trennzeichen verwendet werden können.
Beispiele
- yyyyy-mm-dd - Jahr-Monat-Tag;
- dd.mm.yyyyy HH:MM - Tag.Monat.Jahr Stunde:Minute;
- HH:MM - Stunde:Minute (nur die Uhrzeit kann ausgewählt werden);
- yyyy/mm - Jahr/Monat.
Fragenvalidierungsgleichung (em_validation_q)
Beschreibung
Dies ist eine Gleichung, die verwendet wird, um die gesamte Frage zu validieren (z. B. alle ihre Teile zusammen für eine Frage mit mehreren Antworten). Wenn die Frage die Validierungskriterien nicht erfüllt, wird die Meldung em_validation_q_tip angezeigt (sie verwendet den CSS-Stil .error). Dieser Tipp verwendet den CSS-Stil .em_q_fn_validation, der standardmäßig in template.css ausgeblendet ist.
Der Hauptunterschied zwischen dieser Funktion und den Validierungsgleichungen für Unterfragen (em_validation_sq-Option) besteht darin, dass bei dieser Funktion eine Fehlermeldung angezeigt werden kann, wenn die Validierung der Frage (oder der Fragenteile) fehlschlägt. Für die Unterfragevalidierung wird jede Texteingabezelle (z. B. in einem Array-Fragentyp, kann aber auch auf Einzeleingabe-Fragetypen angewendet werden) so gestaltet, dass die Hintergrundfarbe (hell)rot ist.
Gültige Werte
- Jede Gleichung, die die Syntax ExpressionScript ohne umgebende geschweifte Klammern verwendet.
Beispiel
- Sie möchten über eine Frage mit mehreren kurzen Texten demografische Informationen von Benutzern sammeln und überprüfen, ob der Benutzer eine gültige E-Mail-Adresse und Telefonnummer eingegeben hat.
Dieses Beispiel zeigt, wie die Frage mit ungültigen Antworten aussieht:
Und so sieht es mit einer ungültigen Antwort aus:
So bearbeiten Sie eine Frage, um diese Informationen einzugeben:
Und hier ist ein Teil der Ausgabe von Show Logic File, mit der Sie die Genauigkeit Ihres Ausdrucks überprüfen und sicherstellen können, dass keine Syntaxfehler vorliegen:
Wie Sie sehen können, testet die Validierungsgleichung, ob sowohl die E-Mail-Adresse als auch die Telefonnummer entweder leer sind oder einem regulären Ausdrucksfilter entsprechen.
Der Validierungstipp zeigt die Warnmeldung nur an, wenn die Telefonnummer oder E-Mail ungültig erscheint.
Wenn Sie das obige Beispiel in Ihre LimeSurvey-Installation importieren möchten, laden Sie die folgende .lsq-Datei herunter: Em_validation_q_example.zip.
Tip for whole question validation equation (em_validation_q_tip)
Description
If you are using the question validation equation, you can use this box in order to display an optional message as question tip on how the question has to be filled out.
Valid values
- Any string or equation that makes use of the ExpressionScript syntax.
Example
See the example from the question validation equation wiki section- it shows how the tip can be tailored to show which parts of a multiple short text question fail the validation criteria.
Sub-question validation equation (em_validation_sq)
Description
This is an equation that is used to validate each subquestion (text field) individually. Any text field that does not pass these validation conditions will have its background color turned pink (using the .em_sq_fn_validation CSS style) to highlight the error. Note that this is available in addition to the regular expression-based validation option.
Valid values
Any equation that makes use of the ExpressionScript syntax, without surrounding curly braces.
Examples
For example, if you want to allow only numbers that are a multiple of 3 as answers, the equation would be:
(this / 3) == floor(this/3)
The reserved variable this is automatically replaced by a reference to the active text entry cell.
Tip for sub-question validation equation (em_validation_sq_tip)
Description
If you are using em_validation_sq, this is an optional message/tip that will be displayed if the introduced answer is incorrect.
Valid values
- Any string
Example
- Continuing the example of validating emails, the tip might be "Please enter valid email addresses."
Insert page break in printable view (page_break)
Description
This attribute is only active when you actually print a survey from the Printable View. It forces a page break before the question.
Available options
- On
- Off (default)
Dates and Expression Manager: Advanced validation and calculation
Limesurvey versions 2.05+ and above make it fairly easy to validate dates using the date_min and date_max fields (see above). Use these whenever possible. If you need to do more fancy stuff, you may be able to work (and calculate) with dates using Expression Manager and the function strtotime() (New in 2.0 build 130515). It calculates the number of seconds from the 1st January 1970 to a given date. Example: if you want to display in a question text the number of days that have passed since a departure date (asked in a previous question) and today, you can can use the expression {(strtotime("now")-strtotime(departure))/60/60/24}. Please be aware that strtotime() works with a lot of different but not ALL date formats. Limesurvey's default date format (MM-DD-YYYY) does NOT work with strtotime(). Please set your survey to use one of the following date formats to avoid problems: YYYY-MM-DD, YYYY/MM/DD, DD.MM.YYYY, MM/DD/YYYY, DD-MM-YYYY.