Actions

Fragetyp: Mehrfache numerische Eingabe

From LimeSurvey Manual

Revision as of 16:12, 28 January 2019 by C schmitz (talk | contribs) (Created page with "<onlyinclude>{{#ifeq:{{{transcludesection|short_description}}}|short_description|")

Kurze Beschreibung

This question type is a variation of the "Numerical input" question type. It allows multiple text boxes to be created, each of them allowing the survey respondents to enter only numbers. Each text box corresponds to an subquestion, the subquestion text being the label for the input.



Example: Multiple_numerical_input_question_type_example.zip

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


Validierung (mit regulären Ausdrücken) (preg_validation)

Beschreibung

Mit dieser Option können Sie einen regulären Ausdruck angeben, mit dem Sie alle Teile einer Frage validieren können.

Wenn eine Frage oder ein Unterfragewert die Validierungsanforderungen nicht erfüllt, wird die Hintergrundfarbe des Texteingabefelds in Rot geändert, damit Benutzer leicht erkennen können, welche Teile der Frage korrigiert werden müssen. Somit können Sie eine On-Page-Validierung durchführen. Auf diese Weise müssen Sie nicht darauf warten, dass der Benutzer auf die Schaltfläche „Senden“ klickt, um die entsprechende Frage zu bestätigen.

Gültige Werte

  • Jeder gültige reguläre Ausdruck

Beispiel



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


Präfix (Präfix)

Beschreibung

Ein Textwert, der als Präfix vor den Texteingabefeldern angezeigt wird. Das Präfix wird direkt links neben der Eingabe angezeigt.

Wenn der Bildschirm klein ist, wird das Präfix über der Eingabe angezeigt. Wenn Sie es links belassen möchten (New in 3.0.0 ): Fügen Sie der Frage die Klasse suffix-prefix-force hinzu.

Gültige Werte

  • Alle Zeichen oder Zeichensätze, die vor der Eingabe angezeigt werden sollen

Beispiel

Wenn Sie für dieses Attribut den Wert „$“ eingeben, wird unmittelbar vor dem Texteingabefeld ein Dollarzeichen angezeigt.



Suffix (Suffix)

Beschreibung

Ein Textwert, der an ein Texteingabefeld angehängt werden soll. Das Suffix wird direkt rechts neben der Eingabe angezeigt.

Auf dem kleinen Bildschirm wird unter der Eingabe das Sufix angezeigt. Wenn Sie es bei right (New in 3.0.0 ) belassen möchten: Fügen Sie der Frage die Klasse suffix-prefix-force hinzu.

Gültige Werte

  • Alle Zeichen oder Zeichensätze, die nach der Eingabe angezeigt werden sollen

Beispiel

Die Eingabe eines Werts von „%“ für dieses Attribut würde dazu führen, dass unmittelbar nach dem Texteingabefeld ein Prozentzeichen angezeigt wird.



Label column width (label_column_width)

Description

The label column width option allows you to set the width of the label/subquestion (of the wrapper of each label). Please note that this option does not set the width of the column where the labels are located.

Available options

  • Default: If selected, a default value will be allocated to have both the label and its corresponding text input box on the same line. For example, if the text input box width is 92% and the label column width is set to default, the label and its corresponding answer text box will be displayed on the same row. If the width of the label "wrapper" was higher than 7%, then the text input box would be displayed on the next line.
  • Hidden: If chosen, the first column (that contains subquestions) will not be displayed to the survey respondent.
  • 8%; 17% ... 92%; 100%: the bigger the selected value, the larger the width of the subquestion.

Example: If you wish to have each subquestion displayed on its own row, increase the width to 100%, the text input box being then displayed under each subquestion.


Hinweis verstecken

Beschreibung

Die meisten Fragen zeigen in der Regel einen Hinweis, wie „Bitte wählen Sie eine der folgenden Optionen“ oder einen ähnlichen Hinweistext, wie man die Frage ausfüllen soll. Mit dieser Einstellung können Sie diese Tipps/Hinweise ausschalten.

Diese Tipps/Hinweise enthalten Meldungen zu Validierungskriterien (wie z.B. min/max Anzahl der Antworten, min/max/gleicher Summenwert). Wenn die Einstellung aktiviert ist, werden diese Meldungen ausgeblendet. Wenn der Benutzer jedoch ungültige Daten eingibt, erscheinen die Tipps. Sie werden rot eingefärbt und auf grün geändert, sobald die Validierungskriterien erfüllt sind.

Verfügbare Optionen

  • An - Tipps/Hinweise werden versteckt
  • Aus (Standard).



Breite Eingabefeld (text_input_width)

Beschreibung

Dieses Attribut legt die Breite der Texteingabefelder fest (des "Wrappers" der Texteingabefelder). Das Eingabefeld wird verwendet, um eine Antwort auf die (Teile-) Frage einzugeben. Wenn der Wert der Breite ausreichend hoch ist, wird das Texteingabefeld in der nächsten Zeile angezeigt. Bitte beachten Sie, dass diese Option nicht die Größe der Eingabe oder die Breite der gesamten Spalte festlegt!

Verfügbare Optionen

  • Standard: Wenn diese Option ausgewählt ist, wird diesem Attribut ein Standardwert zugewiesen, sodass sowohl die Beschriftung als auch das entsprechende Texteingabefeld in derselben Zeile stehen. Wenn die Breite des Texteingabefelds beispielsweise 41% beträgt, ist der Wert der Breite des Texteingabefelds ein Wert, der sowohl die Beschriftung als auch das Eingabefeld in derselben Zeile zulässt (in diesem Fall 58%). Wenn die Breite des Texteingabefelds höher als 58% ist, wird das Texteingabefeld in der nächsten Zeile angezeigt
  • 8%; 17 %...92% , 100%: Je größer der ausgewählte Wert ist, desto breiter ist das Texteingabefeld.

Beispiel

  • Wenn das Eingabeelement unter der Unterfrage / Beschriftung angezeigt werden soll, wählen Sie die Option 100% aus der Dropdown-Liste.



Zufällige Antwortreihenfolge (random_order)

Beschreibung

  Für Antwortoptionen veraltet : Ab 5.5.0 wird dieses Attribut nicht mehr zum Sortieren von Antwortoptionen verwendet. Bitte lesen Sie QS:Answer_order


Dieses Attribut bewirkt, dass LimeSurvey die bestehende Reihenfolge der Antwortoptionen/Unterfragen ignoriert und sie stattdessen zufällig anordnet. Mit dieser Option kann der Umfrageersteller die Verzerrung der Umfrage verringern. Bitte beachten Sie, dass bei einer Frage mit Unterfragen die Reihenfolge der Unterfragen zufällig ist und nicht die Reihenfolge der Antwortoptionen.

Verfügbare Optionen

  • Ja - Beim Starten der Umfrage einmalig ein zufällige Reihenfolge setzen
  • Nein (Standard)



Text input box size (input_box_size)

 Hint: This features is available starting in version 3.0.0


Description

This function allows you to set the size of the text area (the text input box). By default, LimeSurvey forces the input box to be displayed with a default size. This can be overridden by making use of this function.

To move the box on the next line, you need to increase the size of the wrapper. To do so, increase the value of the text input width attribute.

Valid values

  • Any numeric value


Question theme (question_theme)

Description

It allows you to use customized themes for the respective question.

Available options

  • Your created question themes which are located under the Question themes in the Themes panel.

See: https://manual.limesurvey.org/Question_themes

Note: This feature is under development at the moment.


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)


CSS class (css_class)

Description

If you want to add special CSS classes to certain questions, you can enter the CSS class name(s) in this box. Make sure you leave an empty space between different class names.

Valid values

  • Any text string with a space between different CSS class names.
 Hint: You can also insert an expression in this box (New in 3.0.0 ). Remember that the output of the expression will not be updated dynamically.


  According to the W3C, CSS class names can contain only the characters [a-zA-Z, and 0-9] and ISO 10646 characters U+00A1 and higher, plus the hyphen (-) and the underscore (_). They cannot start with a digit, or a hyphen followed by a digit. LimeSurvey encodes CSS classes, but it does not fix it totally.



Relevance help for printable survey (printable_survey_relevance_help)

Description

If you wish to print a survey, you can also print the relevance equations for each question. But, if you wish to offer instead an explanation rather than the expression on the printed form, fill in this box with the text explanation for the relevance equation.

Valid values

  • Any text and/or numbers you wish to be displayed on the printable form.


Input

Minimum value of the numeric input (min_num_value_n)

Description

Minimum value of the numeric input that can be introduced in the input box by the respondent.

Valid values

  • Any integer value above 0
  • Any number
  • Any SGQA code
  • Any question code (variable name)
  • Any equation, using ExpressionScript syntax, without surrounding curly braces.



Equals sum value (equals_num_value)

Description

Sets the sum total of all predefined answers that will be accepted. For example: Setting a value of 20 for this attribute would mean that the only acceptable total for all items would be 20. A value of 15 or 60 would be unacceptable.

If the option Value range allows missing is set : the sum value are not checked if whole questions are not answered.

Valid values

  • Any number value
  • Any SGQA code
  • Any question code (variable name)
  • Any equation, using ExpressionScript syntax, without surrounding curly braces.



Integer only (num_value_int_only)

Description

If enabled, the respondents will be able to introduce in the box only integer values.

Available options

  • Yes
  • No (default)



Maximaler Summenwert (max_num_value)

Beschreibung

Diese Einstellung ist in den Eingabefragen für mehrere numerische und numerische Arrays verfügbar. Wenn dieses Attribut festgelegt ist, müssen die Eingabewerte (abhängig von der Art der Frage) dieses Kriterium erfüllen – die (Summe der) Zahl(en) muss kleiner sein als der Wert, den Sie in dieses Feld eingeben. Andernfalls kann die Befragte ihre Antwort nicht einreichen.

'Gültige Werte

  • Jeder ganzzahlige Wert über 0
  • Jede Zahl
  • Jeder SGQA-Code
  • Jeder Fragecode (Variablenname)
  • Jede Gleichung, die [ [ExpressionScript - Presentation|ExpressionScript]]-Syntax, ohne umgebende geschweifte Klammern.

Beispiel

  • Das Festlegen eines Wertes von 20 würde bedeuten, dass der Gesamtwert aller in allen Eingabefeldern für diese Frage eingegebenen Zahlen 20 nicht überschreiten darf. Summen von 21 wären nicht zulässig. Insgesamt wären 15 akzeptabel.



Minimum sum value (min_num_value)

Description

This setting is available in the multiple numeric and numeric array input questions. When this attribute is set, the input value(s) (depending on the type of question) must meet this criteria - the (sum of) number(s) has to be higher than the value you type in this box. Otherwise, the respondents will not be able to submit her answer(s).

If the option Value range allows missing is set : the minimum sum value are not checked if whole questions are not answered.

Valid values

  • Any integer value above 0
  • Any number (using . (dot) for decimal separator)
  • Any SGQA code
  • Any question code (variable name)
  • Any equation, using ExpressionScript syntax, without surrounding curly braces.

Example

  • Setting a value of 10 would mean that the total value of all numbers entered in all input boxes fr this question may not be smaller than 10. Totals of 9 would not be allowed. A total of 12 would be acceptable.



Maximale Zeichenzahl (maximum_chars)

Beschreibung

Dadurch können Sie die maximale Anzahl an Zeichen festlegen, die für eine textbasierte Frage eingegeben werden können. Die Eingabe eines Wertes von beispielsweise 20 bedeutet, dass der Teilnehmer nicht mehr als 20 Zeichen eingeben kann.

'Gültige Werte

  • Jeder ganzzahlige Wert über 0



Wertebereich erlaubt das Fehlen (value_range_allows_missing)

Beschreibung

Dieses Attribut gilt für den Fragetyp „Mehrfachnumerisch“. Wenn diese Option aktiviert ist, kann ein Umfrageteilnehmer die Beantwortung der Frage mit mehreren Zahlen überspringen, auch wenn equal_num_value oder min_num_value festgelegt sind.

'Verfügbare Optionen

  • Ein (Standard)
  • Aus



Maximalwert der numerischen Eingabe (max_num_value_n)

Beschreibung

Maximaler Wert der numerischen Eingabe, der vom Teilnehmer in das Eingabefeld eingegeben werden kann.

Gültige Werte

  • Beliebiger ganzzahliger Wert über 0
  • Beliebige Zahl
  • Beliebiger SGQA Code
  • Beliebiger Fragencode (Variablenname)
  • Beliebige Gleichung mit ExpressionScript -Syntax, ohne umschließende geschweifte Klammern.


Logic

Minimale Antwortanzahl (min_answers)

Beschreibung

Dies Funktion kann genutzt werden, um sicherzustellen, dass ein Benutzer mindestens eine bestimmte Anzahl Antworten einer Mehrfachauswahl wählt.

Gültige Werte

  • Beliebiger ganzzahliger Wert über 0!
  • Beliebige Zahl
  • Beliebiger SGQA Code
  • Beliebiger Fragencode (Variablenname)
  • Beliebige Gleichung mit ExpressionScript -Syntax, ohne umschließende geschweifte Klammern.

Beispiel

Bei der Einstellung X (eine zufällige Zahl) können die Benutzer das Umfrageformular senden, wenn sie mindestens X Kontrollkästchen aktivieren. Wenn diese Option für das Ranking von Fragen verwendet wird, wird sichergestellt, dass mindestens drei Elemente eingestuft werden, bevor der Teilnehmer die Antworten / Umfrage absenden kann.

Bitte beachten Sie, dass Sie die Frage auf nicht Pflichtfrage setzen müssen, wenn Sie dieses Attribut mit Ranking-Fragen verwenden. Andernfalls müssen alle Elemente eingestuft werden, was nicht intuitiv ist, wenn Sie auch die Funktion min_answers verwenden.



Maximale Antworten (max_answers)

Beschreibung

Mit diesem Wert kann man beim Fragetyp "Mehrfachauswahl" die Anzahl der maximal ausgewählten Antworten festlegen.

Gültige Werte

  • Beliebige Zahl
  • Beliebiger SGQA Code
  • Beliebiger Fragencode (Variablenname)
  • Beliebige Gleichung mit ExpressionScript-Syntax, ohne umschließende geschweifte Klammern.

Beispiel

Bei der Einstellung 2 kann der Benutzer höchstens zwei Kontrollkästchen oder ein Kontrollkästchen aktivieren und das Feld "Andere" (falls vorhanden) ausfüllen. Für den Fragetyp Rangfolge könnte der Teilnehmer maximal zwei Elemente auswählen.



Matrix Filter (array_filter)

Beschreibung

Mit der Einstellung „Array-Filter“ können Sie jede Multiple-Choice-Frage verwenden, um auszuwählen oder festzulegen, welche Antworten in einer nachfolgenden Liste, einem Array oder einer Multiple-Choice-Frage angezeigt werden.

Die nachfolgenden Fragen können nach jedem Array-Fragentyp gefiltert werden, einschließlich:
  • Multiple Choice
  • Multiple Choice mit Kommentaren
  • Multiple Short Text
  • Multiple Numeric
  • Array (5 Punkte, 10 Punkte, Ja/Nein/Unbekannt, Erhöhen/Gleich/Verringern, Spalte)
  • Array (Dual Scale, Text, Numbers)
  • Ranking

Darüber hinaus kann jeder dieser Fragetypen gefiltert werden.

Die einzige Ausnahme ist „Array (Spalte)“, das andere Fragen filtern kann, sich selbst jedoch nicht.

'So stellen Sie einen Filter ein

Um einen Filter festzulegen, geben Sie den Fragecode einer Frage mit mehreren Optionen in das Array-Filterfeld der Frage ein, die Sie gerade bearbeiten. Die jeweilige Frage wird als Informationsquelle für die aktuelle Frage verwendet, wobei die ausgewählten Antworten der vorherigen Frage abgerufen und als Antwortoptionen für die aktuelle Frage verwendet werden. 'Zum Beispiel: Wenn der Code Ihrer Quellfrage mit mehreren Optionen „Q1“ lautet, geben Sie „Q1“ in das Feld „Array-Filter“ ein, um den Filtervorgang der Antworten zu starten. In der array_filter-ed-Frage werden nur die Antwortoptionen angezeigt, die in Frage Q1 ausgewählt wurden.

Wenn Sie möchten, dass über diese Option weitere Fragen gefiltert werden, geben Sie die Fragecodes durch Semikolons (;) getrennt in das Feld ein.
  Die in der ersten Frage verwendeten Unterfragecodes müssen mit den Unterfragecodes der zweiten Frage übereinstimmen. Andernfalls filtert die Funktion „Array-Filter“ die Antworten auf die erste Frage nicht. Hinweis: Wenn Sie die Antwortoption „Andere“ aus der ersten Frage filtern möchten, müssen Sie in der zweiten Frage eine Unterfrage für diese Antwort angeben und der Unterfragecode für diese Antwort muss „Andere“ lauten. Sehen Sie sich das folgende Beispiel an, um besser zu verstehen, wie das gesamte System funktioniert.


Wenn die Mehrfachauswahl eine andere Einstellung zulässt: Sie können „Andere“ für den Unterfragecode auswählen und filtern, ob „Andere“ aktiviert ist oder nicht.

Kaskadierung

Die ausgewählten Optionen können kaskadiert angezeigt werden. Das bedeutet, dass Sie eine Frage auswählen können, die eine andere Frage filtert, die eine andere Frage filtert usw.

Matrix Filter Beispiel

Schauen wir uns das folgende Beispiel an, um die Leistungsfähigkeit dieser Einstellung besser zu verstehen:


Datei:array_filter_with_multipe_short_text.jpg


Im Screenshot von oben haben wir zwei Fragen bekommen. Bei der ersten handelt es sich um einen Fragetyp „mehrerer Kurztext“, während es sich bei der zweiten um einen Fragetyp „Array mit zwei Skalen“ handelt. Die Antworten, die Sie in der ersten Frage geben, werden in der zweiten aufgeführt. Technisch gesehen werden die Antworten, die Sie auf die Unterfragen der ersten Frage geben, gefiltert und in der zweiten Frage angezeigt.

Dieses Beispiel kann über den folgenden Link heruntergeladen werden: limesurvey_group_32.lsg. Importieren Sie diese Fragengruppe in Ihre LimeSurvey-Installation.



Matrix-Ausschlussfilter

Beschreibung

Mit der Einstellung "Matrix-Ausschlussfilter" können Sie eine beliebige Multiple-Choice-Frage verwenden, um auszuwählen oder festzulegen, welche Antwortoptionen in einer nachfolgenden Liste, einer AMtrix oder einer Multiple-Choice-Frage NICHT angezeigt werden.

Es können die nachfolgenden Fragetypen gefiltert werden auf Basis jedes Matrix-Fragetypen, inklusive:
  • Mehrfachauswahl
  • Mehrfachauswahl mit Kommentaren
  • Mehrfache kurze Texte
  • Mehrfach numerische Eingabe
  • Matrix (5 Punkt 10 Punkt, Ja/Nein/Unbekannt, Abnahme/Gleich/Zunahme, Nach Spalte)
  • Matrix (Doppel-Skala, Text, Zahlen)
  • Reihenfolge

Außerdem kann jeder dieser Fragetypen an sich gefiltert werden.

Die einzige Ausnahme ist der Matrix (nach Spalte)-Fragetyp, der andere Fragen filtern kann, aber selbst nicht gefiltert werden kann.

Einrichtung

Geben Sie den Fragecode einer Frage mit mehreren Optionen in das Feld Matrix-Ausschlussfilter der Frage ein, die Sie gerade bearbeiten. Die jeweilige Frage wird als Informationsquelle für die aktuelle Frage verwendet, wobei die nicht ausgewählten Antworten aus der vorherigen Frage abgerufen und als Antwortoptionen für die aktuelle Frage verwendet werden. Wenn Ihr Quellcode für Mehrfachoptionen beispielsweise "Q1" lautet, geben Sie "Q1" in das Feld "Matrix-Ausschlussfilter" ein, um den Filterprozess der Antworten zu starten. In Ihrer Frage werden nur die Antwortoptionen angezeigt, die in Frage Q1 NICHT ausgewählt wurden.

Wenn Sie möchten, dass weitere Fragen über diese Option gefiltert werden, geben Sie die Fragencodes in das durch Semikolons (;) getrennte Feld ein.
  Die in der ersten Frage verwendeten Teilfragecodes müssen mit den Teilfragecodes der zweiten Frage übereinstimmen. Andernfalls filtert die Matrix-Ausschlussfilterfunktion die Antworten auf die erste Frage nicht. Sehen Sie sich das folgende Beispiel an, um besser zu verstehen, wie das gesamte System funktioniert.


Kaskadierung

Die ausgewählten Optionen können in Kaskade angezeigt werden. Dies bedeutet, dass Sie eine Frage auswählen können, die eine andere Frage filtert, die eine weitere Frage filtert und so weiter.

Beispiel

Sehen Sie sich das folgende Beispiel an:



Im Screenshot von oben haben wir zwei Fragen. Die erste ist ein Multiple-Choice-Fragetyp, während die zweite ein Multiple-Choice-Fragetyp mit Kommentaren ist. Die Antworten, die Sie in der ersten Frage geben, werden von der zweiten ausgeschlossen. Wenn Sie beispielsweise die Option ComfortUpdate (mit dem Teilfragecode 'SQ1') und die Option Plugin ('SQ4') auswählen, werden die Teilfragen 'SQ1' und 'SQ4' in der zweiten Frage ausgeschlossen. In unserem Screenshot können wir beobachten, dass nur die nicht ausgewählten Optionen der ersten Frage in der zweiten angezeigt werden.

Dieses Beispiel kann unter folgendem Link heruntergeladen werden: Limesurvey_group_array_filter_exclude.zip. Import dieser Fragegruppe in Ihre LimeSurvey-Installation.



Array filter style (array_filter_style)

Description

This function allows you to choose how the array filtered subquestions are displayed. They can either be "hidden" or "disabled".

To learn how to filter subquestions, please read the following wiki section.

Available options

  • Hidden (default) - if this option is selected, then the previously selected subquestions will not be displayed in the second question.
  • Disabled - if this option is selected, then the previously selected subquestions will be greyed out and become unselectable.

Example

If you wish to use the "disabled" option, then the previously selected subquestions will be displayed like this:



Exclusive option (exclusive_option)

Description

The exclusive option attribute takes the code of an answer in a multiple option question so that when clicked on its corresponding checkbox, all the other previously checked options will get unchecked and get marked as read-only (=disabled). This function was created to ensure the data integrity when one of the multiple options in a multiple option question implies that no other option can be selected too. Basically, this feature marks the other attributes as being irrelevant.

It is also possible to have multiple exclusive options. These must be separated by semicolons.

Example

For a short explanation on answer codes, check first the following wiki section. Once understood, introduce the "AnswerCode" that will trigger the function once selected.

Below, you may see an example where the exclusive option attribute is used.

You can see in the first screenshot that some non-LimeSurvey options are selected:



If you click on the marked option (which is entered in the exclusive option box), the other options will get unmarked and disabled, being left only with the current option checked:



To take a closer look at our example, import the .lsq file into your LimeSurvey installation:

File:Example exclusive option question.zip.



Randomization group name (random_group)

Description

It places the questions into a specified randomization group, all questions included in the specified group being displayed in a random order to the survey respondents.

You can find a sample survey using randomization group name in ExpressionScript sample survey.

Valid values

Just enter any string you like (for example: 'group1'). All question which have set the same string within the randomization group name box will have their place in the survey randomized (=randomly exchanged among each other).


Preview To preview the questions use the preview survey instead of the preview question group function, as the second has been reported to not show the questions in a randomized order.



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:

Datei:validation-invalid-both.jpg

Und so sieht es mit einer ungültigen Antwort aus:

Datei:validation-invalid-phone.jpg

So bearbeiten Sie eine Frage, um diese Informationen einzugeben:

Datei:validation-gui.jpg

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:

Datei:validation-logic.jpg

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.

 Hint: Um komplexe Validierungsmeldungen zu erstellen, lesen Sie mehr über die Verwendung von ExpressionScript.


Wenn Sie das obige Beispiel in Ihre LimeSurvey-Installation importieren möchten, laden Sie die folgende .lsq-Datei herunter: Em_validation_q_example.zip.

 Hint: Denken Sie daran, LimeSuvey verwendet die Perl-Syntax für reguläre Ausdrücke, daher sollten sie mit / (Schrägstrich) beginnen und enden!



Validierungshinweis für die gesamte Frage

Beschreibung

Wenn Sie die Fragevalidierungsgleichung verwenden, können Sie dieses Feld verwenden, um eine optionale Nachricht als Frage-Tipp anzuzeigen, wie die Frage ausgefüllt werden muss.

Gültige Werte

Beispiel

Siehe das Beispiel aus dem Fragenvalidierungsgleichung Wiki-Abschnitt – er zeigt, wie der Tipp angepasst werden kann, um zu zeigen, welche Teile einer Frage mit mehreren kurzen Texten die Validierungskriterien nicht erfüllen.



Unterfrage-Validierungsgleichung (em_validation_sq)

Beschreibung

Dies ist eine Gleichung, die verwendet wird, um jede Unterfrage (Textfeld) einzeln zu validieren. Bei jedem Textfeld, das diese Validierungsbedingungen nicht erfüllt, wird die Hintergrundfarbe rosa geändert (unter Verwendung des CSS-Stils .em_sq_fn_validation), um den Fehler hervorzuheben. Beachten Sie, dass dies zusätzlich zur auf regulären Ausdrücken basierenden Validierungsoption verfügbar ist.

Gültige Werte

Jede Gleichung, die die Syntax ExpressionScript ohne umgebende geschweifte Klammern verwendet.

Beispiele

Wenn Sie beispielsweise nur Zahlen als Antworten zulassen möchten, die ein Vielfaches von 3 sind, würde die Gleichung wie folgt aussehen:

(dieses / 3) == Boden(dieses/3)

Die reservierte Variable this wird automatisch durch einen Verweis auf die aktive Texteingabezelle ersetzt.



Hinweis für die Validierungsgleichung für Teilfragen

Beschreibung

Wenn Sie Validierung von Teilfragen verwenden, ist dies eine optionale Nachricht / ein optionaler Hinweis, der angezeigt wird, wenn die eingegebene Antwort falsch ist.

Gültige Werte

  • Irgendeine Zeichenkette

Beispiel

  • Wenn Sie das Beispiel zur Validierung von E-Mails nehmen, lautet der Tipp möglicherweise "Bitte geben Sie eine gültige E-Mail-Adresse ein."


Other

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)


Slider

If you enable the slider option (see "use slider layout"), the usual input box is converted into a slider which can be adjusted via different additional slider settings (see below). The general look of the slider (colors, handle graphic) is determined via CSS which is defined by the .ui-slider class in the default template.


Slider-Layout verwenden (slider_layout)

Beschreibung

Wenn dieses Frageattribut auf „Ein“ gesetzt ist, ändert es das Layout der Frage, sodass es wie ein Schieberegler aussieht.

'Verfügbare Optionen

  • Ein
  • Aus (Standard)



Slider orientation (slider_orientation)

Description

The slider can be oriented either horizontally or vertically.

Available options

  • Horizontal
  • Vertical



Slider handle shape (slider_handle_shape)

Description

The shape of the handle can be changed with the help of this question attribute. Click on the dropdown list to see all the available options.

Valid values

  • Circle (default)
  • Square
  • Triangle
  • Custom - it is defined in CSS using the Font Awesome font.



Slider handle Unicode shape (slider_handle_unicode_shape)

Description

Type in here the unicode code defined in CSS. To use it, select custom from the handle shape dropdown list.

Valid values

  • Any Font Awesome Unicode characters



Slider-Minimalwert (slider_min)

Beschreibung

Wenn „slider_layout“ festgelegt ist, legt dieses Frageattribut den Wert des linken Endes des Schiebereglers fest. Standardmäßig ist dieser Wert auf 0 gesetzt. Mit dem Ausdrucksmanager kann (ohne geschweifte Klammern) ein Mindestwert eingestellt werden. Bitte beachten Sie jedoch, dass dieser Wert berechnet werden muss, „bevor“ der Ausdruck angezeigt wird. Beispielsweise wird kein benutzerdefinierter Wert angezeigt, wenn der Ausdruck und die im jeweiligen Ausdruck verwendeten Frage- und/oder Frage-Antwort-Codes auf derselben Seite angezeigt werden. In diesem Fall verwendet das Attribut den Standardwert 0.

  Achtung : Bitte beachten Sie, dass dem Benutzer unter der Frage ein logischer Fehler angezeigt wird, wenn der in das Feld eingegebene Ausdruck einen Fehler enthält.


Gültige Werte

  • Beliebige Zahl
  • Ausdrücke, ohne geschweifte Klammern.



Slider-Maximalwert (slider_max)

Beschreibung

Wenn „slider_layout“ festgelegt ist, legt dieses Frageattribut den Wert des rechten Endes des Schiebereglers fest. Standardmäßig ist dieser Wert auf 100 eingestellt. Mit dem Ausdrucksmanager kann (ohne geschweifte Klammern) ein Maximalwert eingestellt werden. Bitte beachten Sie jedoch, dass dieser Wert berechnet werden muss, „bevor“ der Ausdruck angezeigt wird. Beispielsweise wird kein benutzerdefinierter Wert angezeigt, wenn der Ausdruck und die im jeweiligen Ausdruck verwendeten Frage- und/oder Frage-Antwort-Codes auf derselben Seite angezeigt werden. In diesem Fall verwendet das Attribut den Standardwert 100.

  Achtung : Bitte beachten Sie, dass, wenn der in das Feld eingegebene Ausdruck einen Fehler enthält, dem Admin-Benutzer (mit Bearbeitungsrechten für die Umfrage) unterhalb der Frage ein logischer Fehler angezeigt wird, nicht jedoch dem öffentlichen Benutzer.


Gültige Werte

  • Beliebige Zahl
  • Ausdrücke, ohne geschweifte Klammern.



Slider-Genauigkeit (slider_accuracy)

Beschreibung

Wenn „slider_layout“ aktiviert ist, legt dieses Frageattribut den Schrittwert des Schiebereglers fest. Der Expression Manager kann ebenfalls verwendet werden (ohne geschweifte Klammern). Bitte beachten Sie jedoch, dass dieser Wert berechnet werden muss, „bevor“ der Ausdruck angezeigt wird. Beispielsweise wird kein benutzerdefinierter Wert verwendet, wenn der Ausdruck und die im jeweiligen Ausdruck verwendeten Frage- und/oder Frage-Antwort-Codes auf derselben Seite angezeigt werden. In diesem Fall verwendet das Frageattribut den Standardwert 1.

  Achtung : Bitte beachten Sie, dass dem Benutzer unter der Frage ein logischer Fehler angezeigt wird, wenn der in das Feld eingegebene Ausdruck einen Fehler enthält.


Gültige Werte

  • Jeder positive numerische Wert
  • Ausdrücke, ohne geschweifte Klammern.



Slider startet an der mittleren Position (slider_middlestart)

Beschreibung

Wenn aktiviert, wird der Griff in der Mitte des Schiebereglers angezeigt.

'Hinweis Dieses Frageattribut hat nichts mit dem Attribut Schieberegler-Anfangswert zu tun. „‚Slider-Anfangswert‘“ übertrumpft „‚Slider beginnt in der Mittelposition‘“, falls beide aktiv sind.

'Verfügbare Optionen

  • Ein
  • Aus (Standard)



Slider initial value (slider_initial_value)

Description

If the slider option is enabled, you can use type in this field a value that will represent the default start value of the slider. By default, this value correspond to the slider's minimum value. To customize it, you may also use expressions. Please note that the custom value has to be calculated before the expression is displayed. For example, no custom value is displayed if the expression and the question and/or question answer codes used within the respective expression are displayed on the same page. If this happens, then the question attribute will inherit the value established in the "slider minimum value" field.

  Attention : Please note that if the expression typed within the box contains an error, a logic error will be displayed to the user below the question.


Valid values



Slider reverse (slider_reverse)

Description

If enabled, the direction of the slider will be reversed, while the maximum value will be displayed on the left-end of the slider and the minimum value on the right side.

Available options

  • On
  • Off (default)



Slider reset (slider_reset)

Description

If enabled, a reset button is added on the screen to allow survey participants to reset the slider to "0" or to the initial value of the slider (if used).

Available options

  • On
  • Off (default): no reset slider button is displayed




Slider-Anfangswert (slider_default)

Beschreibung

Wenn das „Slider-Layout“ aktiviert ist, können Sie dieses Frageattribut verwenden, um den Anfangswert festzulegen, der in der Datenbank gespeichert wird. Wenn die Frage beispielsweise obligatorisch ist und der Umfrageteilnehmer die Antwort abschickt, ohne den Schieberegler zu bewegen, wird davon ausgegangen, dass er oder sie die Frage mit dem Standardwert beantwortet hat.

'Verfügbare Optionen

  • Ein (Standard)
  • Aus



Mindest- und Höchstwert des Schiebereglers anzeigen (slider_showminmax)

Beschreibung

Aktivieren Sie diese Option, um den minimalen und maximalen Wert unter dem Schieberegler anzuzeigen.

'Verfügbare Optionen

  • Ein
  • Aus (Standard)



Schieberegler für Texttrennzeichen links/rechts (slider_separator)

Beschreibung

Dieses Frageattribut legt das Trennzeichen fest, das zum Anzeigen von Textbeschriftungen auf der linken und rechten Seite des Schiebereglers verwendet wird.

Nehmen wir an, Sie möchten von Ihren Befragten herausfinden, welche Früchte sie gerne essen. Legen Sie zunächst den Texttrenner im Feld „Schieberegler links/rechts Texttrenner“ fest – in diesem Beispiel verwenden wir einen einfachen vertikalen Balken: „ | “.

Formatieren Sie dann Ihre Unterfragen wie folgt:

Unterfragetext |' Linke Schieberegler-Beschriftung | Rechte Schieberegler-Beschriftung

'Gültige Optionen

  • Beliebiges Zeichen

'Beispiel

Statistics

Show in public statistics (public_statistics)

Description

This attribute allows the survey administrator to chose if a particular question results should be displayed to the survey participants after they submitted the survey.

Note: To have the statistics displayed on the last page, do not forget to enable this functionality from the presentation & navigation settings. Otherwise, no statistics link will be displayed at the end of your survey.

The default setting for each question is 'Off' (=Do not show the question statistics to the respondents). You have to enable this for every single question if you want to show the survey statistics of that (those) particular question(s) to the survey participants after the survey submission.

Available options

  • On
  • Off (default)



Display chart (display_chart)

Description

This attribute allows the survey administrator to choose if a chart that contains the question results should be displayed to the survey participants after they filled out the survey.

Note: To have the chart displayed on the last page, you have to enable the following options:


Available options

  • On
  • Off (default)



Chart type (chart_type)

Description

This attribute allows the survey administrator to choose which type of chart will be displayed to the respondent once he/she finished filling out the survey.

Note: Do not forget to change the question and survey settings in order to have the charts displayed at the end on the survey. For more details, check the wiki section on the display chart question attribute.

Available options

  • Bar chart
  • Pie chart
  • Radar
  • Line
  • PolarArea
  • Doughnut