Question type - Date/de

Kurzbeschreibung

This question type can be used to ask for a certain date which can be entered directly, using the JavaScript calendar or by using a drop-down representation. Since version 1.80 you can also specify a minimum and maximum value for drop-down dates.

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

Wenn Sie eines der vorinstallierten Designvorlagen verwenden und Pflichtangabe aktiviert ist, wird neben der Frage ein rotes Sternchen angezeigt. Wenn Sie dieses ausblenden möchten, schauen Sie bitte in unsere FAQ.

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

QS:Defaults/de

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.

 Hint: Um zu überprüfen, ob alle Bedingungen in Ihrer Umfrage korrekt verwendet werden, lesen Sie mehr über unsere Funktion Logikdatei anzeigen.

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:

Datei:D_Date_DD.jpg

Diese Frage immer verstecken (hidden)

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.

'Hinweis:' Ein häufiger Fragetyp, der mit dieser Funktion verwendet wird, ist der Fragetyp Gleichung.

Verfügbare Optionen

• Ein
• Aus (Standard)

Mindestjahr (dropdown_dates_year_min)

Beschreibung

Mit diesem Frageattribut kann der minimale Jahreswert für die Kalenderfrage festgelegt werden. Dies gilt sowohl für die Dropdown- als auch für die Popup-Variante des Kalenders.

Gültige Werte

Beliebiger Jahreswert

Maximales Jahr (dropdown_dates_year_max)

Beschreibung

Mit diesem Frageattribut kann der maximale Jahreswert für die Kalenderfrage festgelegt werden. Dies gilt sowohl für die Dropdown- als auch für die Popup-Variante des Kalenders.

Gültige Werte

Beliebiger Jahreswert

Minimum date (date_min)

Description

This question attribute can be used to set the minimum value for a date question (in y-m-d format or any English valid string - see below for more details). It can be used for both popup and dropdown display options. If a minimum date is not set, then 1.1.1900 is used as default.

  The Expression Manager validation option can also be used for setting up a "minimum date". However, if you you use the popup calendar and the expression relies on a previous question located on the same page, the year will not be displayed correctly in the popup calendar.

Valid values

• Any date value in format YYYY-MM-DD (eg., 2017-08-24);
• Any year value;
• Any English string : "now", "-10 years", "tomorrow";
• Reference to another date/time question : AnotherDateQuestion (using the question code);
• Expressions : With expressions, a minimum date can be dynamically calculated. For example, you can use a date from a previous answer + 3 days as a minimum for the present question by entering: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Maximum date (date_max)

Description

This question attribute can be used to set the maximum value for the date question (in y-m-d format or any other English valid string - see below for more options). It can be used for both popup and dropdown display options.

  The Expression Manager validation option can also be used for setting up a "maximum date". However, if you use the popup calendar and the expression relies on a previous question located on the same page, the year will not be displayed correctly in the popup calendar.

Valid values

• Any date value in format YYYY-MM-DD (eg., 2018-08-24);
• Any year value;
• Any English string : "now", "-10 years", "tomorrow";
• Reference to another date/time question : AnotherDateQuestion (using the question code);
• Expressions: With expressions, a date can be dynamically calculated. For example, you can use a date from a previous answer + 3 days as a maximum date for the present question by entering: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Question validation equation (em_validation_q)

Description

This is an equation that is used to validate the entire question (e.g, all of its parts collectively for a multi-answer question). If the question fails the validation criteria, then em_validation_q_tip message will be displayed (it uses the CSS style .error). This tip uses the .em_q_fn_validation CSS style, which is hidden by default within template.css.

The main difference between this feature and the subquestion validation equations (em_validation_sq option) is that for this feature, if the question (or question parts) fail validation, then an error message could be shown. For the subquestion validation, each text entry cell (e.g., in an array question type, but it can also be applied to single entry question types) will be styled so that the background color is (light) red.

Valid values

• Any equation that makes use of the ExpressionScript syntax, without surrounding curly braces.

Example

• You want to collect demographic information from users via a multiple short text question, and you want to validate that the user has entered a valid email address and phone number.

This example shows how the question looks with invalid answers:

And here is what it looks like with one invalid answer:

Here is how you edit a question to enter that information:

And here is part of the Show Logic File output that lets you check the accuracy of your expression and ensure that there are no syntax errors:

As you can see, the validation equation tests that both the email and phone number are either empty or match a regular expression filter.

The validation tip only shows the warning message if the phone or email appears invalid.

 Hint: In order to create complex validation messages, read about the usage of the ExpressionScript.

If you wish to import the example from above into your LimeSurvey installation, download the following .lsq file: Em_validation_q_example.zip.

 Hint: Remember, LimeSuvey uses the Perl syntax for regular expressions, so they should start and end with / (slash character)!

Validation on date

  Dates in Limesurvey are saved as a string (text format).

To really be able to work (and calculate) with dates, these have to be converted to a number format. The function strtotime ^{(New in 2.0 build 130515)} , which calculates the number of seconds from the 1st January 1970 to a given date can be used for this. Using strtotime() one can for example enforce that only dates before "today" are entered using the following expression: strtotime(self)<=strtotime("now"). Or enforce that that only dates after a certain date can be entered: strtotime(self)>strtotime("2013-03-27")

  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.

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.

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)