Ausdrucksmanager

Hinweis: Dieses Feature steht erst seit LimeSurvey 1.92 zur Verfügung.

Was ist der Ausdrucksmanager?

Übersicht

Um Umfragen auf die eigenen Bedürfnisse anzupassen benötigt man in der Regel folgende Möglichkeiten:

1. "Navigation/Verzweigungen" - verändert die Reihenfolge der Fragen z.B. auf Grundlage der Antworten auf vorangegangene Fragen.
2. "Tailoring/Piping" - Anpassung des Fragetextes (in Bezug auf vorangegangene Frage oder die Anzahl oder das Geschlecht des Teilnehmers), oder von Berichten (Bewertungs-scores oder spezifische Empfehlungen).
3. "Validierung" - stellt sicher, daß die gegebene Anwort bestimmten Kriterien entspricht (z.B. einem Maximal- oder Minimalwert oder einem bestimmten Eingabemuster).

Mit Hilfe des Ausdrucksmanagers ("Expression Manager", EM) ist es möglich all dies in intuitiver Art und Weise umzusetzen. Nahezu alles, was man mit einer mathematischen Formel beschreiben kann, kann auch als Ausdruck dienen; sogar der Aufruf von Funktionen ist möglich. EM stellt augenblicklich >70 Funktionen bereit und kann mit relativ wenig Aufwand erweitert werden. Sämtliche Variablen aus der jeweiligen Umfrage stehen unter ihrem "menschen-lesbaren" Variablennamen zur Verfügung.

Die folgenden Abschnitte beschreiben wo der Ausdrucksmanager zu Einsatz kommt.

Relevanz (für Navigation/Verzweigung)

Einige Umfrageapplikationen verwenden eine "Sprung-Logik", so dass, wenn Sie die Frage 1 mit der Option C beantworten, dann springe Sie zu Frage 5. Dieser Ansatz ist sehr begrenzt, da es schwer zu validieren ist, und leicht schief geht, wenn Sie Fragen neu ordnen. AM verwendet eine Boolesche Relevanz-Gleichung um zu spezifizieren unter welchen Bedingungen eine Frage gültig sein könnte. Wenn die Frage relevant ist, dann wird die Frage gestellt, ansonsten ist Sie Nicht Anwendbar, und der Wert NULL wird in der Datenbank gespeichert. Dies ist ähnlich zu dem, was über dem Bedingungseditor gemacht werden kann, aber mit EM können Sie einfacher viel komplexere und leistungsfähige Kriterien festlegen (und Sie können Variablennamen statt SGQA Namensgebung nutzen).

Dieses Bild zeigt einen Weg, um die Relevanz-Logik für eine Umfrage zu überprüfen. Es berechnet den Body-Mass-Index (BMI). Die Relevanz Gleichung wird in eckigen Klammern direkt nach dem Variablennamen (grün) gezeigt. So sind die Bedeutung von Gewicht (weight), weight_units, Größe (height) und height_units alle 1, was bedeutet, dass diese Fragen immer gestellt werden. Allerdings ist die Relevanz für BMI {! IS_EMPTY (height) und! IS_EMPTY (weight)}, was bedeutet, dass der BMI nur berechnet wird, wenn der Teilnehmer einen Wert für Höhe und Gewicht eingibt(wodurch das Risiko einer Division durch Null vermieden wird). Auch wird die Frage Bericht (Report) nur angezeigt, wenn der Teilnehmer Antworten auf vier Fragen (height, height_units, weight, weight_units) gibt.

Relevanz wird an folgenden Stellen gezeigt und ist bearbeitbar:

Betrachten / Bearbeiten der Relevanz auf Fragenebene

Diese Gleichung berechnet den Body-Mass-Index (BMI). Dies wird nur gefragt, wenn die Person vorher ihre Größe und Gewicht eingegeben hat.

Dies ist der Bearbeitungs-Bildschirm für die BMI Frage.

Beachten Sie, dass Sie geschweiften Klammern nicht nutzen dürfen, wenn Sie eine Relevanz Gleichung eingeben.

Betrachten / Bearbeiten Relevanz auf Gruppenebene

Dies ist eine Stichprobenerhebung. Auf der ersten Seite werden Sie gefragt, wie viele Personen bei Ihnen wohnen, und speichert dies in der Variablen "cohabs". Diese Seite wird nur angezeigt, wenn Sie mehr als einen Mitbewohner haben (also für die zweite Person, die mit Ihnen zusammen lebt) und auch nur, wenn Sie angegeben haben, wie Person 1 mit Ihnen verwandt ist (p1_rel).

Wie Sie sehen, hat die Gruppe auch Relevanzkriterien auf Frageebene, so dass jede Frage erst erscheint, wenn Sie die Frage davor beantwortet haben (z.B. {!Is_empty (p1_sex)} ). EM kombiniert für Sie die Relevanz auf Gruppen- und Fragenebene. Fragen in einer Gruppe werden nur dann gestellt, wenn die Gruppe als Ganzes relevant ist. Dann wird nur die Teilmenge der relevanten Fragen innerhalb der Gruppe abgefragt.

So sieht es aus, wenn man die Relevanz auf Gruppenebene für diese Frage bearbeitet:

Beachten Sie, dass Sie geschweiften Klammern nicht nutzen dürfen, wenn Sie eine Relevanzgleichung eingeben.

Tailoring/Piping

Mit EM können Sie einfach und komplex das bedingte Anpassen Ihrer Fragen durchführen. Manchmal brauchen Sie nur eine einfache Ersetzung, zum Beispiel: "Sie haben angegeben, dass Sie [ Produkt] gekauft haben. Was hat Ihnen am besten gefallen?" Manchmal brauchen Sie eine bedingte Ersetzung wie "[ Herr/Frau] [ NachName], wären Sie bereit, unsere Umfrage auszufüllen? ". In diesem Fall möchten Sie Herrn oder Frau basierend auf dem Geschlecht der Person verwenden. In anderen Fällen benötigen Sie eine noch komplexere Substitution (zum Beispiel basierend auf einer mathematischen Berechnung). EM unterstützt jede dieser Arten von Anpassung/Ersetzung.

Bedingte Gleichungen

Das Body-Mass-Index (BMI) Beispiel zeigt die Möglichkeit, den BMI einer Person zu berechnen, sogar wenn sie Größe und Gewicht in metrischen oder nicht metrischen Einheiten eingeben lassen möchten.

Hier ist weight_kg {if (weight_units == 'kg', Gewicht, Gewicht * .453592)}. Diese if() - Funktion bedeutet, dass, wenn der Teilnehmer das Gewicht in Kilogramm eingegeben hat, dieser Wert verwendet wird. Andernfalls muss der eingegebene Wert (der in Pfund angegeben wurde) mit .453592 multipliziert werden, um ihn in Kilogramm zu konvertieren. Die Variable height_m verwendet einen ähnlichen Ansatz, um die Höhe der Person in Metern zu berechnen, selbst wenn sie ihre Größe in Zoll eingegeben hat.

Der BMI berechnet die Gewichtsformel als {weight_kg / (height_m * height_m)}.

Zum Schluss passt der Bericht über Bedingungen die Nachricht an die Angaben des Teilnehmers an und teilt ihm mit, was er eingegeben hat. ("Sie sagten, dass Sie 2 Meter groß sind und 70 kg wiegen.")

Obwohl in dem obigen Bild nicht gut dargestellt, verwendet weight_status verschachtelte if() - Anweisungen, um die Person als untergewichtig bis übergewichtig zu klassifizieren. Sie können die Gleichung in der Logikansicht anzeigen lassen.

Im Bearbeitungsfenster für diese Frage können Sie zwei Dinge sehen:

1. Die Anpassung muss Ausdrücke mit geschweiften Klammern umgeben
2. Ausdrücke können sich über mehrere Zeilen erstrecken, wenn Sie, wie in diesem Fall, die Lesbarkeit erleichtern möchten, um die verschachtelte bedingte Logik zu lesen.

Maßgeschneiderte Fragen, Antworten und Berichte

Hinweis: Die dynamische Anpassung funktioniert möglicherweise nicht, wenn Antwortoptionen in Auswahlfeldern auf derselben Fragenseite verfügbar gemacht werden. Dies resultiert aus der Tatsache, dass die Anpassung einen Tag einfügt, der innerhalb der Auswahloptionen ungültig ist.

Dieses Beispiel zeigt den BMI-Bericht.

Hier ist das Bearbeitungs-Fenster für die gleiche Frage.

Wie Sie sehen können, wird alles in geschweiften Klammern als Ausdruck behandelt und ist daher im vorherigen Bild syntaktisch hervorgehoben (farblich gekennzeichnet). Wenn Sie Tippfehler hatten (z. B. falsch geschriebene oder undefinierte Variablennamen oder Funktionen), würde EM einen Fehler wie diesen anzeigen, der zeigt, dass height_unit ein undefinierter Variablenname ist (eigentlich heißt er height_units) und rnd() eine undefinierte Funktion ist (Der richtige Funktionsname ist Round()). In beiden Fällen sind die Fehler mit einem roten Rahmen versehen, um das Erkennen und Beheben zu erleichtern.

Sie sehen auch, dass Sie schnell komplexe Berichte erstellen können, beispielsweise eine Tabelle mit eingegebenen Werten oder maßgeschneiderte Ratschläge.

Bitte denken Sie daran, dass alle Anpassungen Ausdrücke mit geschweiften Klammern umgeben müssen, damit LimeSurvey weiß, welche Teile der Frage Freitext sind und welche über den Ausdrucksmanager analysiert werden sollten.

Validierung

EM steuert, wie die meisten erweiterten Frageoptionen funktionieren. Diese steuern Aspekte wie die minimale/maximale Anzahl von Antworten; Min./Max. Einzelwerte; Min/Max-Summenwerte; und Überprüfen, ob die eingegebenen Werte mit den angegebenen Zeichenfolgenmustern übereinstimmen. Sie geben diese erweiterten Frageoptionen weiterhin wie gewohnt ein. Jetzt wird jedoch jeder Wert in einem dieser Felder als Ausdruck betrachtet, sodass Sie Min/Max-Kriterien mit komplexen bedingten Beziehungen zu anderen Fragen haben können.

Da die erweiterte Frageoption in all diesen Fällen immer als Ausdruck betrachtet wird, verwenden Sie bei der Angabe keine geschweiften Klammern.

Die Seiten Beispielumfragen zeigen viele Arbeitsbeispiele für die Verwendung von Ausdrücken für Validierungen.

Einführung

LimeSurvey verwendet das neue Expression Manager (EM)-Modul, mit dem LimeSurvey komplexere Verzweigungen, Bewertungen, Validierungen und Anpassungen unterstützen kann. Es ersetzt die Art und Weise, wie LimeSurvey Ersetzungen, Bedingungen und Bewertungen im Backend verwaltet. Außerdem wird die Verarbeitung erheblich beschleunigt, da die meisten Datenbanklesevorgänge zur Laufzeit entfallen. EM wurde von Dr. Thomas White (TMSWhite) entwickelt.

Diese Wiki-Seite ist die maßgebliche Referenz für die Syntax und Funktionalität von Expression Manager.

Schlüsseldefinitionen

1. Ausdruck: Alles, was von geschweiften Klammern umgeben ist
   • Solange direkt nach der öffnenden Klammer oder vor der schließenden geschweiften Klammer kein Leerzeichen steht.
   • Der Inhalt von Ausdrücken wird von EM ausgewertet, sodass sie mathematische Formeln, Funktionen und komplexe Zeichenfolgen- und Datumsverarbeitung enthalten können.
2. Tailoring: Manchmal auch „Piping“ genannt, ist dies der Prozess von Text bedingt ändern
   • Sie haben Zugriff auf alle „Ersatzfelder“, Teilnehmerdaten und Antwortdaten.
   • Sie haben außerdem einfacheren Zugriff auf Fragen, Antworten und deren Eigenschaften.
3. Relevanz-Gleichung: Ein neues Fragenattribut, das die Sichtbarkeit der Frage steuert
   • Wenn eine Relevanzgleichung vorhanden ist, wird die Frage nur angezeigt, wenn die Relevanz „wahr“ ergibt.
   • Intern alle array_filter und array_filter_exclude Befehle erhalten Relevanz auf Unterfrageebene.
4. Gleichung Fragetyp: Ein neuer Fragetyp, der Berechnungen oder Berichte in der Datenbank speichert
   • Es ähnelt einer Boilerplate-Frage, deren Inhalt wird jedoch in gespeichert die Datenbank, auch wenn Sie „Diese Frage immer ausblenden“ eingestellt haben.
5. Fragecode: Dies ist der bevorzugte Variablenname für EM
   • Dies kann ein beschreibender Name sein, der den Zweck der Frage angibt, was das Lesen komplexer Logik erleichtert.
   • Gültige Fragecodes sollten NICHT mit einer Zahl beginnen. Wenn Sie also den Fragecode zum Nummerieren Ihrer Fragen verwenden, verwenden Sie einfach „q1“, „q1a“ oder „g1q2“.
   • Dies ist derzeit der Variablenname, wenn Sie Daten nach SPSS oder R exportieren. Wenn Sie also statistische Analysen durchführen, haben Sie dies wahrscheinlich bereits eindeutig festgelegt.

Muss ich den AM benutzen?

Die kurze Antwort ist Nein (aber auch Ja).

EM ist vollständig abwärtskompatibel mit bestehenden Umfragen. Wenn Sie also gerne Bedingungen und Bewertungen im Stil verwenden möchten, den LimeSurvey in Versionen <= 1.91+ verwendet hat, können Sie dies weiterhin tun.

EM ersetzt jedoch vollständig die Art und Weise, wie LimeSurvey intern mit Bedingungen umgeht. Obwohl Sie den Bedingungen-Editor weiterhin zum Erstellen und Verwalten von Bedingungen verwenden können, konvertiert LimeSurvey 1.92 diese in die entsprechenden Relevanzgleichungen. Im Rahmen des Upgrades konvertiert LimeSurvey 1.92 automatisch alle vorhandenen Bedingungen in Relevanzgleichungen.

Dies sollte Ihnen das Beste aus beiden Welten bieten – Sie können LimeSurvey weiterhin wie gewohnt verwenden, sehen aber das Relevance Equation-Äquivalent, sodass Sie nach und nach direkt zu Relevance Equations wechseln können, wann immer Sie es für richtig halten.

Kann ich eine Mischung aus Bedingungen und Relevanz nutzen?

Ja. Für einige Fragen können Sie den Bedingungen-Editor und für andere den Relevanz-Editor verwenden. Bedingungen werden automatisch in Relevanz konvertiert, wenn Sie die Frage speichern.

Beachten Sie, dass wir bei Verwendung des Bedingungen-Editors davon ausgehen, dass diese Bedingungen alle manuell eingegebenen Relevanzgleichungen überschreiben sollen. Wenn Sie also über bestehende Bedingungen verfügen und die Relevanz manuell bearbeiten möchten, löschen Sie bitte zuerst die Bedingungen für diese Frage. Kopieren Sie insbesondere die generierte Relevanzgleichung in einen Texteditor, löschen Sie über das Menü „Bedingungen“ alle Bedingungen für diese Frage (wodurch auch die Relevanz gelöscht wird), bearbeiten Sie dann die Frage und fügen Sie die generierte Relevanzgleichung aus dem Texteditor wieder ein das Relevanzfeld für diese Frage (und speichern Sie die Frage). Wenn genügend Nachfrage zum Löschen von Bedingungen besteht, ohne die generierte Relevanzgleichung zu löschen, könnten wir einen Massenkonvertierungsprozess hinzufügen.

Wie soll ich zwischen Bedingungen und Relevanz wählen?

Hier ist eine Liste der Vor- und Nachteile jedes Stils:

Stil	Vorteile	Nachteile
Bedingungen	1. Schöne GUI zum Erstellen einfacher Bedingungen 2. GUI gut dokumentiert und vom Support-Team verständlich	1. Unterstützt nur einfache Vergleiche und funktioniert nicht gut mit UND/ODER-Bedingungen 2. Kaskadierende Bedingungen funktionieren unregelmäßig 3. Langsam – datenbankintensiv, kann daher lange Umfragen verlangsamen 4. Einige haben Probleme mit den Nachladebedingungen gemeldet 5. Die GUI lässt sich nicht gut skalieren, wenn es Dutzende, Hunderte oder Tausende von Fragen gibt 6. Die Konvertierung papierbasierter Umfragen kann langsam sein, da SGQA-Namen verwendet werden müssen 7. Oft ist ein Programmierer erforderlich, um die für komplexe Verzweigungen benötigte Logik individuell zu programmieren
Relevanz	1. Unterstützt sehr komplexe Logik, einschließlich über 80 Funktionen und Mathematik-/String-Operatoren 2. Perfekte Unterstützung für kaskadierende Logik 3. Schnell – keine zusätzlichen Datenbankaufrufe, unterstützt daher Umfragen mit mehr als 1000 Fragen 4. Keine Probleme beim Neuladen der Logik, da keine SGQA-Codes erforderlich sind 5. Syntax-Hervorhebungsskalen für Umfragen mit mehr als 1000 Fragen 6. Einfach und schnell zu verwenden für Gruppen, die bestehende papierbasierte Umfragen computerisieren möchten. 7. Unterstützt problemlos halbstrukturierte Interviews und epidemiologische Umfragen, ohne dass ein Programmierer erforderlich ist	1. Keine GUI für einfache Bedingungen – verwenden Sie stattdessen Syntaxhervorhebung 2. Neu, daher haben Support-Teams EM noch nicht gemeistert.

Das Fazit lautet: Wenn Sie mit der Funktionsweise von LimeSurvey 1.91+ zufrieden sind, gibt es keinen Grund, Ihre Vorgehensweise zu ändern.

Was sind andere Vorteile der Verwendung von AM?

Hier sind einige der anderen Gründe, weshalb Sie EM verwenden können:

1. Berechnungen – Sie können jede erdenkliche Berechnung erstellen:
   • Sie haben Zugriff auf alle gängigen mathematischen Operatoren und Funktionen
   • Sie haben Zugriff auf über 70 mathematische, Datums- und Zeichenfolgenverarbeitungsfunktionen
   • Es ist für Entwickler ziemlich einfach, neue Funktionen hinzuzufügen, wenn Benutzer sie benötigen
2. Berechnungen in der Datenbank speichern
   • Sie können jetzt einfache und komplexe Berechnungen und/oder Skalenergebnisse berechnen und diese in der Datenbank speichern, ohne dass JavaScript erforderlich ist
   • Sie verwenden dazu den Fragetyp „Gleichung“
3. Bewertungen
   • Sie können jetzt Bewertungen erstellen oder Ergebnisse aus jedem Fragetyp skalieren, und nicht nur aus der Teilmenge, die früher unterstützt wurde
   • Sie können Tailoring verwenden, um laufende oder Gesamtbewertungsergebnisse überall dort anzuzeigen, wo Sie sie benötigen – sogar auf derselben Seite
   • Sie haben mehr Kontrolle über die Berichte, die auf der Grundlage dieser Bewertungsergebnisse generiert wurden
   • Sie können Bewertungsergebnisse in der Datenbank speichern, ohne dass JavaScript erforderlich ist
   • Sie können Bewertungsergebnisse ausblenden, ohne dass JavaScript oder CSS erforderlich sind
4. Ersatzfelder
   • Anstatt {INSERTANS:SGQA} zu verwenden, können Sie einfach den Fragecode verwenden – das erleichtert das Lesen und Validieren
   • Dadurch wird auch die häufige Notwendigkeit vermieden, Fragen zu bearbeiten, um den SGQA-Code zu ändern, damit alles funktioniert
5. Tailoring – Sie können Text basierend auf anderen Werten bedingt anzeigen
   • Verwenden Sie den passenden Titel für einen Betreff, z. B. „Hallo [ Herr/Frau Smith]"
   • Geben Sie grammatikalisch korrekte Sätze aus, wenn Singular/Plural wichtig sind: (z. B. „Sie haben 1 Kind“ vs. „Sie haben 2 Kinder")
   • Konjugieren Sie Verben entsprechend und Substantive basierend auf dem Geschlecht und der Pluralität des Subjekts
6. Neue Variablenattribute – Sie können auf Folgendes zugreifen, um Ihre Anpassung vorzunehmen:
   • (kein Suffix) – ein Alias für qcode.code
   • .code – der ausgewählte Antwortcode für die Frage, wenn er relevant ist (sonst leer), oder der Textwert, wenn es sich nicht um eine codierte Frage handelt
   • .NAOK – wie .code, kann aber Teil von Berechnungen oder Listen sein, auch wenn irrelevant
   • .value – der Bewertungswert für die Frage, wenn sie relevant ist (sonst leer), oder der Textwert, wenn es sich nicht um eine codierte Frage handelt – verfügbar, wenn Bewertungen für die Umfrage aktiviert sind, andernfalls immer null
   • .valueNAOK – das Gleiche wie .value, kann aber Teil von Berechnungen oder Listen sein, auch wenn es irrelevant ist
   • .shown – die Antwort, wie sie dem Benutzer angezeigt wird (dies ist die Aufgabe von {INSERTANS:xxx})
   • .qid – die Frage-ID
   • .gid – die Gruppen-ID
   • .sgqa – der SGQA-Wert für die Frage
   • .jsName – der korrekte Javascript-Variablenname für die Frage, unabhängig davon, ob auf dieser oder einer anderen Seite definiert
   • .qseq – die Fragensequenz (beginnend bei 0)
   • .gseq – die Gruppensequenz (beginnend bei 0)
   • .obligatorisch – ob die Frage obligatorisch ist (J/N)
   • .question – der Text der Frage
   • .relevance – die Relevanzgleichung für die Frage
   • .grelevance – die Relevanzgleichung für die Gruppe
   • .relevanceStatus – ob die Frage aktuell relevant ist oder nicht (boolean (kann in PHP und JS unterschiedlich sein))
   • .type – der Fragetyp (der einstellige Code)
7. Dynamische On-Page-Änderungen
   • Alle Relevanz-, Berechnungs- und Anpassungsfunktionen funktionieren dynamisch auf einer Seite – Änderungen an Werten aktualisieren die Seite also sofort
   • Sie haben also Fragen, die dynamisch angezeigt werden oder verschwinden, je nachdem, ob sie relevant sind
   • Fragen werden basierend auf den Antworten auf der Seite auch dynamisch angepasst, sodass Sie laufende Summen, maßgeschneiderte Sätze und benutzerdefinierte Berichte sehen können
8. Neuer Dateneingabebildschirm
   • Zusätzlich zur Verwendung mit dem aktuellen Dateneingabesystem können Sie einfach Survey-All-In-One verwenden
   • Dies unterstützt die On-Page-Relevanz und -Anpassung, sodass Dateneingabesachbearbeiter schnell durchblättern können und nur noch die relevanten Antworten eingeben müssen
   • Dies kann von entscheidender Bedeutung sein, wenn Ihre Dateneingabeperson die Anpassung sehen muss, die ebenfalls dynamisch ist
9. Macht die meisten benutzerdefinierten JavaScript-Anforderungen überflüssig
   • EM unterstützt problemlos komplizierte Berechnungen und Bewertungen, Anpassung und bedingte Logik
   • Einige Dinge benötigen weiterhin JavaScript (wie benutzerdefinierte Layouts und das bedingte Ausblenden von Fragen-Unterelementen), aber Ihr JavaScript kann die EM-Funktionen verwenden, sodass Sie auf Fragen über Ihren Qcode statt über SGQA zugreifen können und Sie können auf eine der oben aufgeführten Frageneigenschaften zugreifen

Welche weiteren hilfreichen neuen Funktionen bietet EM?

Unabhängig davon, ob Sie weiterhin den Bedingungseditor verwenden oder Relevanzgleichungen manuell erstellen, erhalten Sie diese zusätzlichen Vorteile:

1. Sie können komplexere Validierungskriterien erstellen
   • Alle erweiterten Frageattribute (wie max_answers, min_num_value_n, max_num_value) können Ausdrücke verwenden. So können Ihre Min/Max-Kriterien leicht auf der Grundlage früherer Antworten angepasst werden, selbst wenn diese sich auf derselben Seite befinden.
   • EM übernimmt auch alle auf regulären Ausdrücken basierenden Validierungen, sodass Sie Preg und Gleichung robust kombinieren können. basierend auf Frageattributen.
2. Einfaches Neuanordnen (oder Löschen) von Fragen und Gruppen
   • Vor Version 1.92 konnten Sie Fragen oder Gruppen nicht neu anordnen, wenn LimeSurvey dachte, dass eine solche Neuordnung kaputt gehen könnte Bedingungen, unter denen sie verwendet wurden. Ebenso konnten Sie Fragen nicht löschen, wenn andere Fragen davon abhingen.
   • Mit der Syntaxhervorhebung von EM ist es leicht zu erkennen und zu überprüfen, ob Sie versuchen, Fragen zu verwenden, bevor sie deklariert werden. Deshalb haben Sie jetzt die Möglichkeit, Fragen und Gruppen jederzeit neu anzuordnen oder zu löschen. EM aktualisiert die gesamte Syntaxhervorhebung, um Ihnen potenzielle Fehler anzuzeigen.
   • Die Ansicht für die Neuordnung von Fragen wurde verbessert, um diese Überprüfung zu erleichtern. Jetzt werden die Relevanzgleichung und die Anpassung der Frage angezeigt, sodass Sie sofort sehen können, ob Variablen rosa werden (was bedeutet, dass sie vor der Deklaration verwendet werden).
3. Der Fragen-/Gruppennavigationsindex ist immer verfügbar und genau
   • Vor Version 1.92 waren diese Indizes bei komplexen Bedingungen nicht verfügbar.
   • Mit EM können wir garantieren, dass sie korrekt sind.
   • Betreffs können sogar zu einer früheren Frage zurückspringen und die Antwort ändern, dann vorwärts springen (oder abschicken)
     • Beim Vorwärtsspringen validiert EM alle dazwischen liegenden Fragen/Gruppen erneut.
     • Wenn Fragen irrelevant werden, werden sie in der Datenbank auf NULL gesetzt damit Ihre Daten intern konsistent sind.
     • Wenn Fragen relevant werden oder erneut Pflicht- oder Validierungsregeln nicht bestehen, stoppt EM auf dieser Seite und zwingt den Benutzer, diese Fragen zu beantworten, bevor er zum endgültigen Ziel springt.
4. Automatische Konvertierung von Bedingungen in Relevanz
   • Wenn Sie Ihre Datenbank aktualisieren, werden für alle vorhandenen Umfragen, die über Bedingungen verfügen, Relevanzgleichungen generiert.
   • Wenn Sie eine Umfrage importieren, werden nach Bedarf Relevanzgleichungen erstellt.
   • Wann immer Sie Bedingungen hinzufügen, löschen oder ändern, generiert EM die entsprechende Relevanzgleichung.
5. Praktische Syntaxhervorhebung
   • Wenn EM die Relevanzgleichung anzeigt, wird auch der Qcode angezeigt, auch wenn Sie haben einen SGQA-Code eingegeben, da wir davon ausgehen, dass dieser leichter zu lesen ist.
   • Alle Variablen sind farblich gekennzeichnet, um anzuzeigen, ob sie vor oder nach der aktuellen Frage (oder vor oder nach der aktuellen Gruppe) deklariert wurden. Dadurch können Sie schnell Fälle erkennen und beheben, in denen Sie versuchen, Variablen für Relevanz (einschließlich Array_Filter), Anpassung oder Validierungsgleichungen zu verwenden, bevor Sie sie deklarieren.
   • Außerdem, wenn Sie mit der Maus über die farbcodierte Variable fahren, sehen Sie die wichtigsten Metadaten zu dieser Frage. Dazu gehören die Gruppensequenznummer, die Fragesequenznummer, der Qcode, der Text der Frage und alle verfügbaren Antwortoptionen (wenn es sich um einen Fragetyp mit aufgezählten Antwortoptionen handelt).
     • Die Liste der Antwortoptionen verwendet diese Syntax : 'answers':{key:val, ... }.
     • key hat die Syntax 'scale~code', wobei scale die Antwortskala ist (z. B. für Dual Scale) und „code“ ist der Antwortcode.
     • val hat die Syntax 'value~shown', wobei value steht der Bewertungswert (bei Verwendung von Bewertungen, andernfalls „Code“) (z. B. Qcode.value), und „shown“ ist der Anzeigewert, wie er vom Subjekt gesehen wird (z. B. Qcode.shown).
     • Dies bedeutet, dass viele Umfragen Berechnungen verwenden können, ohne dass der Bewertungsmodus erforderlich ist. Wenn Sie Antwortoptionen aufgelistet haben, die eindeutig, nicht dezimal und nicht negativ sind, können Sie einfach Berechnungen anhand der Qcode.code-Werte durchführen.
6. Einfache Überprüfung der gesamten Umfragelogik und des Inhalts
   • Das gibt es eine neue Funktion „Umfragelogik anzeigen“, mit der Sie alles über die Umfrage (oder Gruppe oder Frage) auf einer einzigen Seite sehen können.
   • Es zeigt die Gruppen-, Frage-, Unterfrage- und Antwortebenendetails für den ausgewählten Bereich an (Umfrage vs. Gruppe vs. Frage).
   • Es zeigt auch die Relevanz, die Relevanz auf Unterfrageebene (für array_filter und array_filter_exclude) und die generierte Validierungsgleichung (für preg und alle Validierungsregeln wie Min/Max-Summe/Anzahl von Werten) und alle nicht leeren Frageattribute.
   • Alles ist syntaxhervorgehoben, sodass Sie potenzielle Syntaxfehler erkennen können (wie unausgeglichene Klammern oder die Verwendung von Variablen, bevor sie deklariert wurden).
   • Die Syntax- Das Hervorheben unterstützt die schnelle Navigation und Bearbeitung der Umfrage.
     • Wenn Sie auf einen Variablennamen klicken, wird ein Browserfenster (oder eine Registerkarte) geöffnet, in dem Ihnen diese Frage angezeigt wird und Sie sie bearbeiten können.
     • Wenn Sie auf einen Gruppennamen klicken, wird ein Browserfenster (oder eine Registerkarte) geöffnet, in dem die Gruppen-Neuordnungsansicht angezeigt wird, sodass Sie Fragen einfach verschieben können.
     • Alle Fragenattribute werden auch syntaktisch hervorgehoben. Auf diese Weise können Sie Ausdrücke in erweiterten Frageoptionen festlegen und anzeigen (z. B. die maximale/minimale Anzahl/Summe der Werte auf einem Ausdruck basieren).
   • Der EM-Autor verwendete eine ähnliche Ansicht (etwas übersichtlicher), um seinen zusammenarbeitenden Epidemiologen und Institutionen zu helfen. Das Review Board validiert und autorisiert Umfragen mit Tausenden von Fragen in stark verzweigten und maßgeschneiderten strukturierten Interviews.

Erste Schritte

Der beste Einstieg in EM ist:

• Installieren Sie die neueste stabile Version von http://www.limesurvey.org/en/download.
• Importieren und erkunden Sie die Beispielumfragen.
• Entdecken Sie die Anwendungsfälle und Anleitungen und Schritt-für-Schritt-Beispiele.
• Entdecken Sie die EM-Dokumentation (diese Seite).
• Untersuchen Sie die integrierte EM-Testsuite
  • Wählen Sie in jeder Umfrage unter „Tools“ die EM-Option aus
  • Verfügbare Funktionen listet die über 70 Funktionen und Syntax auf
  • Einheitentests von isolierten Ausdrücke
    • zeigt Beispiele für die Verwendung aller EM-Funktionen und -Operatoren sowie die PHP- und JavaScript-Ergebnisse
    • Beachten Sie, dass es in den PHP- und JavaScript-Versionen nur wenige Funktionen gibt, die unterschiedliche Ergebnisse generieren. Auf dieser Seite erfahren Sie dies Planen Sie Ihre EM-Logik entsprechend.

Welche Funktionalität erweitert/ersetzt der Ausdrucksmanager? (LimeSurvey <= 1.91+)

Bewertungen => Gleichungen und Micro-Tailoring

Mit Bewertungen konnten Benutzer Punktzahlen aus einer Sammlung von Fragen erstellen. Jedoch passten sie sich nicht dynamisch an die aktuelle Seite an und die Werte waren nicht in der Datenbank abgespeichert. Man musste außerdem die LimeSurvey Datenbanken anpassen.

Ersatz => Micro-Tailoring

Benutzer konnten einige Nachrichten und Fragen anhand der vorherigen Antworten anpassen. Eine Frage könnte zum Beispiel {TOKEN:VORNAME}, und Sie sagten noch, dass {INSERTANS:111X3X4} Ihre Lieblingssportart wäre sein. Jedoch konnte man nicht bedingt anpassen, Verben konjugieren oder Nomen deklinieren ohne JavaScript zu benutzen.

Ersatzteile => Micro-Tailoring

Benutzer könnten einige Nachrichten und Fragen basierend auf früheren Antworten anpassen. Eine Frage könnte beispielsweise lauten: „{TOKEN:FIRSTNAME}, Sie sagten, {INSERTANS:111X3X4} sei Ihr Lieblingssport.“ Allerdings war es ohne ausgefallenes JavaScript nicht möglich, bedingte Anpassungen vorzunehmen (z. B. „Herr“ oder „Frau“ je nach Geschlecht der Person zu sagen) oder Verben zu konjugieren oder Substantive zu deklinieren. Autoren konnten Umfragen implementieren, die scheinbar maßgeschneiderte Fragen stellten, aber es waren separate Fragen für jede Permutation und komplexe Bedingungen erforderlich, um zu entscheiden, welche Fragen angezeigt werden sollten.

Validierung

Fragen konnten mit regulären Ausdrücken, oder mit Minimal- oder Maximalwerten validiert werden. Außerdem konnte man eine SGQA Antwort als Mindest- oder Höchstbetrag nehmen. Jedoch konnten Berechnungen von anderen Variablen ohne JavaScript nicht für die Überprüfungen verwendet werden.

Gleichungen

Gleichungen wurden ohne JavaScript nicht unterstützt.

Gleichungs-Fragetyp

Gleichungen konnten ohne JavaScript nicht in der Datenbank abgespeichert werden (zum Beispiel die Endpunktzahl für eine Beurteilung).

Wie wird der Ausdrucksmanager diese Funktion ersetzen oder erweitern?

Der Ausdrucksmanager ist ein neues Modul in LimeSurvey, es stark vereinfacht komplexe Funktionen zu unterstützen für die früher angepasstes JavaScript verwendet werden musste. Er ersetzt auch die Art und Weise mit der LimeSurvey Bedingungen und Beurteilungen verwaltet.

Neue Bezeichnungsweisen des Ausdrucksmanagers

Der Ausdrucksmanager "denkt" über seine Funktionalität folgend:

• Relevanzbasierte Verzweigung - ist eine Frage relevant, stelle sie, ansonsten nicht (z.B. mach sie unsichtbar)
• Anpassung - Sobald du weißt, welche Fragen gestellt werden sollten, wird durch das Micro-Tailoring angegeben wie die Fragen zu stellen sind. Dadurch können sie nicht nur einfache Dinge austauschen (wie z.B. {TOKEN:VORNAME}), sondern auch die Konjungation von Verben und Deklination von Substantiven basierend auf dem Geschlecht und der Anzahl der Subjekte durchführen. Es erlaubt dir auch die Antwort danach zu verändern, ob die anderen Fragen (oder wie die anderen Fragen) beantwortet wurden.
• Gleichung - Der Ausdrucksmanager fügt auch einen neuen Fragetypen namens Gleichungen hinzu, der die Ergebnisse der Ausdrücke speichert. Der eine Zeichentyp für Gleichungen ist das Asterixzeichen "*".

Relevanz und Kaskadierende Relevanz

Jeder Fragetyp verfügt jetzt über eine Relevanzoption, die steuert, ob die Frage angezeigt wird. EM verarbeitet jede der Relevanzgleichungen in der Reihenfolge, in der sie in der Umfrage erscheinen sollen. Wenn der Ausdruck wahr ist (oder fehlt – zur Unterstützung älterer Umfragen), wird die Frage angezeigt. Wenn es nicht relevant ist, wird die Frage ausgeblendet und der Wert wird in der Datenbank auf NULL gesetzt. Wenn in einer Gruppe keine relevanten Fragen vorhanden sind, wird die gesamte Gruppe übersprungen.

Wenn außerdem eine der Variablen in einem Ausdruck irrelevant ist, wird der Ausdruck immer als falsch ausgewertet. Dies ermöglicht kaskadierende Relevanz, sodass Sie nicht für jede Frage sehr lange Relevanzgleichungen schreiben müssen.

Sagen wir mal, dass es 5 Fragen, Q1-Q5 gibt. Du willst aber nur, dass Q2 angezeigt wird, wenn Q1 beantwortet wurde, und Q3 wenn Q2 beantwortet wurde und so weiter. Die notwendigen Gleichungen wären dann:

Frage-Nummer	Relevanz	Frage
Q1	1	Wie heißen Sie?
Q2	Q1	{Q1}, wie alt sind Sie?
Q3	Q2	Also, Sie sind {Q2} Jahre alt. Sind Sie verheiratet?
Q4	Q3 == "Y"	{Q1}, wie lange sind Sie schon verheiratet?
Q5	Q4	Wie viele Kinder haben Sie, {Q1}?

Diese Berechnungen werden auch von JavaScript unterstützt - also können Sie die Fragen auf einer Seite platzieren und alles funktioniert weiterhin.

Solange Sie sich auf derselben Seite befinden, sind alle von Ihnen eingegebenen Daten weiterhin vorhanden, nur ausgeblendet. Wenn Sie also einige Informationen eingeben, dann eine Option auswählen, die sie irrelevant macht, und sie dann wieder relevant machen, sind Ihre Antworten weiterhin verfügbar. Sobald Sie jedoch zu einer anderen Seite wechseln, gehen alle irrelevanten Antworten aufgrund der Integrität des Datensatzes verloren.

Relevanz auf Gruppenebene

Expression Manager unterstützt auch Relevanz auf Gruppenebene. Dies erleichtert die Implementierung von Schleifen. Angenommen, Sie möchten Informationen über bis zu 10 Entitäten (z. B. Produkte oder Personen in einem Haushalt) sammeln. Dabei ermitteln Sie zunächst, für wie viele Entitäten eine Nachverfolgung erforderlich ist (z. B. indem Sie fragen, wie viele Personen in einem Haushalt leben, oder Personen überprüfen lassen, welche Produkte ihnen aus einer langen Liste gefallen). Nachdem Sie wissen, wie viele Entitäten einer Nachverfolgung bedürfen, können Sie die Relevanz auf Gruppenebene wie {count >= 1}, {count >=2}, ... {count >= 10} für jede der 10 Follow-up-Gruppen verwenden. Fragen stellen. Innerhalb jeder Gruppe können Sie eine bedingte Logik auf Fragenebene verwenden (z. B. geschlechts- oder altersspezifische Folgefragen für jedes Thema). Die Fragen- und Gruppenrelevanzgleichungen werden mit UND verknüpft, um zu bestimmen, welche angezeigt werden sollen.

Tailoring/Piping

Alles innerhalb von geschweiften Klammern wird nun als Ausdruck behandelt (mit einer Ausnahme, die unten beschrieben wird). Ausdrücke haben zugang zu allen LimeReplacement-Feldern, zu allen Variablen (über verschiedene Aliase), allen typischen Gleichungsoperatoren (mathematisch, logisch und Vergleich) und dutzenden Funktionen (die sogar dynamisch auf Client-Seite funktionieren).

Durch die Benutzung dieser Gleichungen, kannst du z.B. solche Dinge machen:

1. Den Befragten maßgeschneiderte Nachrichten abhängig von früheren Antworten zeigen.
2. Beurteilungen erstellen und die Beurteilungsergebnisse (oder bedingte Verzweigungen oder Nachrichten) basierend auf diesen Ergebnissen anzeigen lassen. Alles ohne das Beurteilungsmodul selber zu benutzen.
3. Verben konjugieren und Nomen deklinieren.
4. Sich Zusammenfassungen der Antworten vor der "Antworten anzeigen" Seite am Ende der Umfrage anzeigen lassen.

Gleichungen

Es gibt einen neuen Fragetyp namens Gleichung. Er ist wie eine Boilerplate-Frage, bis darauf, dass er den gezeigten Wert in der Datenbank speichert. Also wenn der Gleichungs-Frage-Text eine Beurteilungs-Berechnung enthält, dann würde dieser Wert in der Datenbank in einer Variable, die in öffentlichen oder begrenzten Statistiken angezeigt werden kann, gespeichert werden.

Dies löst ein häufiges Featurerequest Beurteilungs-Wertungen in der Datenbank speichern zu können.

Syntax

Alles innerhalb von geschweiften Klammern wird jetzt als Ausdruck angesehen (mit einer Ausnahme: es darf keine führenden oder nachfolgenden Leerzeichen geben - dies ist notwendig, damit der Ausdrucksmanager nicht versucht eingebettetes JavaScript auszuführen).

Beachten Sie, dass Ausdrücke sich über mehrere Zeilen erstrecken können, solange nach der öffnenden geschweiften Klammer oder vor der schließenden geschweiften Klammer kein Leerzeichen steht. Dies ist besonders hilfreich für verschachtelte if()-Anweisungen wie diese:

{if(is_empty(PFTotals),
 '',
 if(PFTotals >= -5 && PFTotals <= -4,
 'Very Soft',
 if(PFTotals >= -3 && PFTotals <= -2,
 'Soft',
 if(PFTotals == -1,
 'Etwas weich',
 if(PFTotals == 0,
 'Moderate',! N! if(PFTotals == 1,
 'Etwas schwer',
 if(PFTotals >= 2 && PFTotals <= 3,
 'Hard',
 if(PFTotals >= 4 && PFTotals <= 5,
 'Sehr schwer',
 ''
 )
 )
 )
 )
 )
 )
 )
)}

Expression Manager unterstützt die folgende Syntax:

• Alle standardmäßigen mathematischen Operatoren (z. B. +,-,*,/,!)
• Alle standardmäßigen Vergleichsoperatoren (z. B. <,<=,==,!=,>,>=, plus diese Äquivalente: lt,le,eq,ne,gt,ge)
• Klammern (damit Sie Unterausdrücke gruppieren können)
• Bedingungsoperatoren (z. B. &&, | | und diese Äquivalente: und, oder)
• Zeichenfolgen in einfachen und doppelten Anführungszeichen (die jeweils Zeichenfolgen mit dem anderen Anführungszeichentyp einbetten können)
• Kommaoperator (kann also eine Liste von Ausdrücken haben und nur das Endergebnis zurückgeben)
• Zuweisungsoperator (=)
• Vordefinierte Variablen (zur Bezugnahme auf Fragen, Frageattribute und Antworten) – z. B. alle SGQA-Codes
• Vordefinierte Funktionen (es gibt bereits über 70 und es ist einfach, weitere hinzuzufügen)

Operatoren

Die EM-Syntax folgt der normalen Operatorpriorität:

Level	Operator(s)	Description
1	()	Klammern zum Gruppieren oder Aufrufen von Funktionen
2	! - +	unäre Operatoren: nicht, Negation, unär-plus
3	* /	mal, dividieren
4	+ -	plus , minus
5	< <= > >= lt le gt ge	relative Vergleiche
6	== != eq ne	Gleichheitsvergleiche
7	und	logisches UND
8	oder	logisches ODER
9	=	Zuweisung Operator
10	,	Kommaoperator

Warnung mit Plus-Operator (+)

Aus Gründen der Konsistenz zwischen JavaScript und PHP führt der Plusoperator (+) eine Addition aus, wenn beide Operanden numerisch sind, führt jedoch eine Verkettung durch, wenn beide Teile nicht numerische Zeichenfolgen sind. Wir empfehlen jedoch die Verwendung der Funktion „join()“ für die Verkettung und der Funktion „sum()“ für die Addition, da dies Ihre Absicht klarer macht und unerwartete Ergebnisse vermeidet, wenn Sie Zeichenfolgen erwartet haben, aber stattdessen Zahlen erhalten (oder umgekehrt).

Warnung mit Nichtübereinstimmung zwischen Zahl und Zeichenfolge und alphabetischem Vergleich

Wenn Sie Werte mit Relativ- oder Gleichheitsvergleichen vergleichen möchten, achten Sie auf Typkonflikte. Der vom Benutzer eingegebene Wert oder der ausgewählte Antwortcode kann als Zahl verwendet werden, wenn es sich eindeutig um eine Zahl handelt. Wenn Sie einen der Werte mit " umgeben, wird der Vergleich als Text erzwungen (alphabetischer Vergleich). Wenn Sie numerisch vergleichen möchten, Setzen Sie die Zahl niemals in Anführungszeichen, " .

Beispielsweise ist Q0.NAOK > "50" wahr, wenn Q0.NAOK eine numerische Frage mit 9 als Wert ist. Dies liegt daran, dass der Operator > davon ausgeht, dass es sich um einen alphabetischen und nicht um einen numerischen Vergleich handelt.

Um den ganzzahligen Wert sicher zu vergleichen, können Sie intval(Q0.NAOK) > 50 verwenden. Denken Sie daran, wenn Q0.NAOK keine Zahl (leer oder eine Zeichenfolge) ist, dann intval(Q0. NAOK) === 0. Um den Zeichenfolgenwert ("A" < "B") zu vergleichen, verwenden Sie strcmp direkt: strcmp(Q0.NAOK,"B") oder strcmp(Q0.NAOK,"A5") .

Vorsicht bei der Verwendung des Zuweisungsoperators (=)

Beachten Sie, dass Sie die Zuweisungsoperatoren nur dann verwenden sollten, wenn dies unbedingt erforderlich ist, da sie zu unerwarteten Nebenwirkungen führen können. Wenn Sie beispielsweise den Wert einer vorherigen Antwort ändern, wird die kaskadierende Relevanz und Validierungslogik zwischen dieser Frage und der aktuellen Frage nicht neu berechnet, sodass Sie möglicherweise intern inkonsistente Daten erhalten (z. B. Fragen, die beantwortet bleiben, aber beantwortet werden sollten, wurden auf NULL gesetzt oder Fragen, die übersprungen wurden, aber beantwortet werden sollten). Wenn Sie einer Variablen einen Wert zuweisen möchten, sollten Sie im Allgemeinen einen Fragetyp „Gleichung“ erstellen und einen Ausdruck verwenden, um seinen Wert festzulegen. Da es jedoch seltene Fälle gibt, in denen Menschen diesen Operator wirklich benötigen, haben wir ihn zur Verfügung gestellt.

Um Sie vor diesem Operator zu warnen, wird er in den Syntaxgleichungen in roter Schrift angezeigt (damit Sie ihn nicht mit „==“ verwechseln).

Verwendung des Zuweisungsoperators

Die Hauptgründe, warum Sie die Zuweisung verwenden möchten, sind:

• Sie müssen den Standardwert für eine Frage festlegen, die keine Standardwerte über eine Gleichung akzeptiert (z. B. Listenradio, wobei Sie über die Benutzeroberfläche eine der Antwortoptionen auswählen, aber keine Gleichung eingeben können). Seien Sie jedoch vorsichtig, da LimeSurvey nicht validieren kann, ob Ihre Gleichung eine der zulässigen Antworten für diese Frage generiert.
• Sie müssen die Antwort auf eine vorherige Frage basierend auf einer späteren Antwort zwangsweise ändern.
• Sie benötigen ein komplexes Kontingent: Verwenden Sie eine versteckte Einzelauswahl für das Kontingent und legen Sie es mithilfe von Zuweisung fest.
• usw.

Zu diesem Zweck können Sie alle Expression-Manager-Systeme verwenden.

  Die Zuweisung erfolgt nur in PHP. Dadurch werden keine Werte auf derselben Seite aktualisiert, sondern nur, wenn der Benutzer mit Weiter, Zurück, Speichern … navigiert.

  Wenn Sie für diesen Zweck keinen Typ Gleichungsfrage verwenden: Die Zuweisung erfolgt erst, nachdem die Logik der aktuellen Seite abgeschlossen ist. Die empfohlene Methode besteht darin, immer eine Gleichungsfrage zu verwenden.

Einige Beispiele:

• Legen Sie die Antwort auf eine kurze Textfrage in Kleinbuchstaben fest: {QCODE=strtolower(QCODE.NAOK)}
• Legen Sie zu Beginn einer Umfrage eine Standardantwort auf einen Array-Fragetyp fest: {Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}
• Legen Sie zu Beginn einer Umfrage eine Standardantwort auf einen Array-Text-Fragetyp fest: {Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}
• Antwort mit Bedingung festlegen: {QCODE=if(YesNo="Y","A1","")}

XSS-Sicherheit

Wenn XSS aktiviert ist, können einige Ausdrucksmanagersysteme nicht verwendet werden:

• Beginnen Sie mit einem HTML-Tag im Ausdruck, enden Sie aber mit einem anderen Ausdruck.
• Verwenden Sie einen komplexen Ausdruck in der URL.

<html>Beispiele und Problemumgehungen:

• {if( 1 ,"","")}information{if( 1 ,"","")} ist mit der XSS-Sicherheit fehlerhaft, hier können Sie stattdessen verwenden {if(1,"

<strong>information</strong>","information")};

• <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a>, here you can use an equation question because using a complete question code is OK : <a href="/script.php?value={EQUATION.NAOK}">next</a> . information","information")} {if(1," ;
• <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a> , here you can use an equation question because using a complete question code is OK : <a href="/script.php?value={EQUATION.NAOK}">next</a> .

Zugang zu Variablen

Expression Manager bietet schreibgeschützten Zugriff auf alle Variablen, die wir benötigen. Aus Gründen der Abwärtskompatibilität bietet es Zugriff auf Folgendes:

• TOKEN:xxx – der Wert eines TOKEN (z. B. TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (Nur für NICHT anonyme Umfragen).
• INSERTANS:SGQA – der Anzeigewert einer Antwort (z. B. „Ja“). Für Expression Manager ist es dasselbe wie die Verwendung von {QCODE.shown}.
• Alle {XXX}-Werte, die von Vorlagen verwendet werden.
• Im Fragetext können Sie {QID} ersetzen durch die Frage-ID und {SGQ} ersetzt durch den SGQA der Frage.

Zusätzlich erlaubt dir der Ausdrucksmanager dich auf Variablen über die Frage-Nummer zu beziehen (auch als Titel in der Datenbank bezeichnet). Dies ist auch das Label der Variable, welches genutzt wird, wenn Sie Ihre Daten zu SPSS, R oder SAS exportieren. Zum Beispiel, wenn Sie Fragen zu dem Namen, Alter und Geschlecht haben, könnten sie ihre Variablen "name", "alter" und "geschlecht" nennen. Dies macht die Gleichungen jedem leichter Verständlich und macht es möglich die Fragen durch zu mischen ohne ein Auge auf die Gruppen und Fragennummern haben zu müssen.

Wichtig: Es ist nur sicher, auf Variablen zu verweisen, die in vorherigen Seiten oder Fragen vorkommen.

Außerdem erlaubt der Ausdrucksmanager auf bestimmte Eigenschaften der Fragen zuzugreifen.

Syntax	Bedeutung	Beispiel	Beispiel Ergebnis
Qcode	Der Code-Wert der Frage, wenn relevant (sonst leer)	{gender}	'M'
Qcode.NAOK	das gleiche wie Qcode - siehe die Diskussion über NAOK	{gender.NAOK}	'M'
Qcode.shown	der Anzeigewert der Frage	{gender.shown}	'Male'
Qcode.question	der Fragetext	{gender.question}	'What is your gender?'
Qcode.mandatory	ob die Frage verpflichtend ist (J/N)	{gender.mandatory}	'N'
Qcode.qid	die interne Nummer der Frage (nicht die fortlaufende Nummer)	{gender.qid}	337
Qcode.type	der Fragetyp	{gender.type}	'G'
Qcode.jsName	der Javascriptname der Frage	{gender.jsName}	'java1827X3X337'

HTML-Editor-Problem

  Dieses Problem wurde nach 2.05 Build 140803 behoben

Wenn Sie den HTML-Editor verwenden, werden einige Zeichen durch HTML-Entitäten ersetzt.

• & durch &
• < durch <
• > durch >

Wenn Sie einen HTML-Editor verwenden, müssen Sie:

• und für & verwenden
• lt für <
• le für <=
• gt für >
• ge für >=

Qcode-Variablenbenennung

Hier sind die Details, wie ein Qcode konstruiert wird (und auf einige Eigenschaften zugegriffen wird), geordnet nach Fragetyp. Generell werden Qcodes wie folgt konstruiert:

Fragecode . '_' . SubQuestionID . '_' . ScaleId

Für „Kommentar“ und „Sonstiges“ lauten die Fragecodes „QuestionCode_comment“ und „QuestionCode_other“.

Typ	Beschreibung	Code	Unterfragen	Antwortoptionen	Skalen	Antwortcode	Antwort angezeigt	Relevanz
5	5 Punktauswahl-Optionsfelder	Q1		1-5		{Q1}	{Q1.shown}	{Q1==3}
B	Array (10 Punkte Auswahl) Optionsfelder	Q2	|1-10		{Q2_L2}	{Q2_L2.shown}	{Q2_L2==7}
A	Array (5 Punktauswahl) Optionsfelder	Q3	|1-5		{Q3_1}	{Q3_1.shown}	{Q3_1>=3}
1	Array (Flexible Labels) Dual Scale	Q4	sq1-sq5	0 :a1-a3	1:b1-b3	{Q4_sq1_0}	{Q4_sq1_1.shown}	{Q4_sq1_1=='b2'}
H	Array (flexibel) - Spaltenformat	Q5	1-5	s,m,t		{Q5_1}	{Q5_1.shown}	{Q5_1=='s'}
F	Array (flexibel) – Zeilenformat	Q6	|1-5		{Q6_F3}	{Q6_F3.shown}	{Q6_F3==4}
E	Array (Erhöhen/Gleich/Verringern) Optionsfelder	Q7	1- 7	I,S,D		{Q7_4}	{Q7_4.shown}	{Q7_4=='D'}
:	Array (Multi Flexi) 1 bis 10	Q8	ls1,todo ,ls2	min,max,avg		{Q8_ls1_max}	{Q8_ls2_avg.shown}	{Q8_ls2_min==7}
;	Array (Multi Flexi) Text	Q9	hp,st,sw	1., 2., 3.		{Q9_hp_3rd}	{Q9_hp_3rd.shown}	{Q9_hp_3rd=='Peter'}
C	Array (Ja/Unsicher/Nein) Optionsfelder	Q10	1-5	Y,N,U		{Q10_1}	{Q10_1.shown}	{Q10_3=='Y'}
X	Boilerplate Question	Q11					{Q11.shown}
D	Datum	Q12				{Q12}	{Q12.shown}
*	Gleichung	Q13				{Q13}	{Q13.shown}	{Q13>5}
~124~	Datei-Upload (zeichnet die Anzahl der hochgeladenen Dateien auf)	Q14				{Q14}		{Q14>0}
G	Dropdown-Liste „Geschlecht“	Q15		M,F		{Q15}	{Q15.shown}	{Q15=='M'}
U	Riesiger Freitext	Q16				{Q16}	{Q16.shown}	{strlen(Q16)>100}
I	Sprachfrage	Q17				{Q17}	{Q17.shown}	{Q17=='en'}
!	Liste - Dropdown	Q18		1-5		{Q18}	{Q18.shown}	{Q18==3}
L	Listen-Dropdown-/Radio-Button-Liste	Q19		AZ		{Q19}	{Q19.shown}	{Q19=='X'}
O	Liste mit Kommentar-Dropdown/Radio-Button-Liste + Textbereich	Q20		AF		{Q20},{Q20comment}	{Q20.shown}	{Q20=='B'}
T	Langer Freitext	Q21				{Q21}	{Q21.shown}	{strstr(Q21,'hello')>0}
M	Multiple-Choice-Kontrollkästchen	Q22	|		{Q22_E}, {Q22_other}	{Q22_E.shown}, {Q22_other.shown}	{Q22_E=='Y'}
P	Multiple Choice mit Kommentaren Kontrollkästchen + Text	Q23	AF			{Q23_D}, {Q23_Dcomment}	{Q23_D.shown}	{!is_empty(Q23)}
K	Mehrfache numerische Frage	Q24	self,mom,dad			{Q24_self}	{Q24_self.shown}	{Q24_self>30}
Q	Mehrfacher Kurztext	Q25	AF			{Q25_B}	{Q25_B.shown}	{substr(Q25_B,1,1)=='Q'}
N	Numerischer Fragetyp	Q26				{Q26}	{Q26.shown}	{Q26 > 30}
R	Ranking-Stil	Q27	1-4			{Q27_1}	{Q27_1.shown}	{Q27_1==3}
S	Kurzer Freitext	Q28				{Q28}	{Q28.shown}	{Q28=='mine'}
Y	Ja/Nein-Optionsfelder	Q29				{Q29}	{Q29.shown}	{Q29=='Y'}

Die reservierten Variablen „this“, „self“ und „that“

Sehr oft möchten Sie alle Teile einer Frage auswerten, z. B. zählen, wie viele Unterfragen beantwortet wurden, oder die Ergebnisse summieren. In anderen Fällen möchten Sie nur bestimmte Zeilen oder Spalten einer Frage verarbeiten (z. B. um die Zeilen- oder Spaltensummen abzurufen und sie in der Datenbank zu speichern). Diese reservierten Variablen machen diesen Prozess relativ schmerzlos.

Die Variable „diese“ wird ausschließlich in den erweiterten Frageoptionen „Validierungsgleichung für ganze Fragen“ und „Validierungsgleichung für Unterfragen“ verwendet. Es wird auf die Variablennamen jeder Zelle innerhalb dieser Fragen erweitert. Wenn Sie also sicherstellen möchten, dass jeder Eintrag größer als drei ist, würden Sie die „Unterfrage-Validierungsgleichung“ auf (dies > 3) setzen.

Die Variablen „self“ und „that“ sind leistungsfähiger und dienen als Makros, die vor der Verarbeitung von Gleichungen erweitert werden. Die Syntaxoptionen sind:

• self
• self.suffix
• self.sub-selector
• self.sub-selector. Suffix

„Suffix“ ist eines der normalen Qcode-Suffixe (z. B. NAOK, Wert, angezeigt).

„Unterselektor“ ist einer von:

• Kommentaren – nur Unterfragen, die Kommentare sind (z. B. aus Multiple-Choice mit Kommentar und Liste mit Kommentar)
• keine Kommentare – nur Unterfragen, die keine Kommentare sind

*sq_X – wobei X eine Zeilen- oder Spaltenkennung ist. Es werden nur Unterfragen ausgewählt, die mit Muster X übereinstimmen. Beachten Sie, dass die Suche nach der vollständigen Code-ID erfolgt, dann sq_X zutrifft und die Unterfragen nX, Achten Sie auf den Fragetyp mit zwei Skalen, bei dem die Unterfragencodes QCODE_SQCODE_1 und QCODE_SQCODE_1 sind, und auf den Fragetyp mit der Rangfolge, bei dem die Unterfragencodes QCODE_1, QCODE_2 ....

• nosq_X sind – wobei X eine Zeilen- oder Spaltenkennung ist. Es werden nur Unterfragen ausgewählt, die nicht mit Muster X übereinstimmen. Beachten Sie, dass die Suche nach der vollständigen Code-ID und dann nach der nosq_X-Übereinstimmung erfolgt und die Unterfragen nX, X, Xn nicht umfasst

Beispiele:

• Wurde ein Teil einer Frage beantwortet? {count(self.NAOK)>0}
• Wie hoch ist die Bewertungspunktzahl für diese Frage? {sum(self.value)}

Sie können diese auch verwenden, um Zeilen- und Spaltensummen zu erhalten. Angenommen, Sie haben ein Zahlenarray mit den Zeilen AE und den Spalten 1–5.

• Wie hoch ist die Gesamtsumme? {sum(self.NAOK)}
• Wie hoch ist die Summe von Zeile B? {sum(self.sq_B.NAOK)}
• Wie hoch ist die Summe von Spalte 3? {sum(self.sq_3.NAOK)}

Die Variable „that“ ähnelt der Variable „self“, ermöglicht Ihnen jedoch die Bezugnahme auf andere Fragen. Seine Syntax ist:

• that.qname
• that.qname.suffix
• that.qname.sub-selector
• that.qname.sub-selector.suffix

„qname“ ist der Fragename ohne Unterfrageerweiterungen. Angenommen, Sie erstellen eine Frage „q1“, das ist ihr „qname“.

Beispiele:

• Wurde ein Teil der Frage q1 beantwortet? {count(that.q1.NAOK)>0}
• Wie hoch ist die Bewertungspunktzahl für q2? {sum(that.q2.NAOK)}
• Wie hoch ist die Gesamtsumme von q3? {sum(that.q3.NAOK)}
• Wie hoch ist die Summe der Zeile C in q4? {sum(that.q4.sq_C.NAOK)}
• Wie hoch ist die Summe von Spalte 2 in q4? {sum(that.q4.sq_2.NAOK)}

Die Variablen „self“ und „that“ können für jede Relevanz, Validierung oder Anpassung verwendet werden.

Die einzige Einschränkung besteht darin, dass bei Verwendung der Funktion Logikdatei anzeigen der erweiterte Wert von „self“ und „that“ angezeigt wird. Dadurch können Sie die tatsächlich generierte Gleichung sehen, sodass Sie (und Expression Manager) überprüfen können, ob die Variablen vorhanden sind. Dies kann verwirrend erscheinen, da möglicherweise recht lange Gleichungen angezeigt werden. Wenn Sie jedoch die Frage bearbeiten, sehen Sie die ursprüngliche Gleichung mit „selbst“ und/oder „das“.

Beachten Sie außerdem, dass Sie diese Variablen nicht verwenden sollten, wenn (a) Sie jede in einer Gleichung verwendete Variable explizit benennen möchten oder (b) Variablen verwenden, die keine Unterfragen haben (z. B. Fragen mit einer Antwort). In diesen Fällen ist es übertrieben, einer Variablen das Präfix „that“ voranzustellen, und Sie laufen Gefahr, unerwartete Ergebnisse zu erhalten.

Verwendung von NAOK

NAOK -> „Nicht anwendbar“ (NA) ist in Ordnung (OK)

Die Verwendung von NAOK bedeutet, dass alle oder einige der Variablen irrelevant sind (z. B. „Nicht anwendbar“ (NA) ist in Ordnung (OK)).

Wenn Sie eine Variable aus einer Frage in eine beliebige Gleichung einfügen: Wenn diese Frage (oder Unterfrage) durch eine Bedingung ausgeblendet ist: Dadurch werden alle Gleichungen deaktiviert.

Zum Beispiel: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) gibt immer eine leere Zeichenfolge aus, wenn eine Unterfrage von Q1 gefiltert wird. Um die Anzahl der überprüften Unterfragen in einer solchen Frage zu zählen, kann count(Q1_SQ1.NAOK,Q1_SQ2.NAOK verwendet werden ,Q1_SQ3.NAOK,Q1_SQ4.NAOK). Wenn die Unterfrage ausgeblendet ist: Der Ausdrucksmanager gibt eine leere Zeichenfolge zurück.

Ohne NAOK: Wenn eine Frage oder eine Unterfrage ausgeblendet ist: Expression Manager gibt immer eine leere Zeichenfolge zurück, dasselbe gilt für die Rückgabe von „false“.

Die angezeigten .NAOK-Codes verwenden immer das NAOK-System (leere Zeichenfolge, wenn ausgeblendet). Wenn Sie jedoch den Code der Antwort benötigen, ist es immer eine gute Idee, .NAOK nach dem Fragecode hinzuzufügen. Außer wenn Sie es brauchen und wissen, was Sie tun.

Ein weiteres Beispiel und Informationen finden Sie unter Overriding Cascading Conditions.

Zugriff auf Funktionen

Der Ausdrucksmanager liefert Zugang zu mathematischen, zeichenketten und nutzerdefinierten Funktionen, wie folgend gezeigt. Er hat PHP und JavaScript Äquivalenten für diese Funktionen, sodass diese server- und clientsetig identisch arbeiten. Es ist einfach neue Funktionen hinzuzufügen.

Implementierte Funktionen

Die folgenden Funktionen sind momentan verfügbar:

Funktion	Bedeutung	Syntax
abs	Absoluter Wert	number abs(number)
acos	Arkuskosinus	number acos(number)
die Funktion addslashes	Quote string with slashes	string addslashes(string)
asin	Arkussinus	number asin(number)
atan	Arkustangens	number atan(number)
atan2	Arkustangens zweier Variablen	number atan2(number, number)
ceil	Aufrunden	number ceil(number)
checkdate	Gibt true(1) zurück, wenn es ein nach dem Gregorianischen Kalender gültiges Datum ist	bool checkdate(month,day,year)
cos	Kosinus	number cos(number)
date	Formatiere eine lokales Datum/Zeit	string date(format [, timestamp=time()])
exp	Berechnet den Exponenten von e	number exp(number)
floor	Abrunden	number floor(number)
gmdate	Ein GMT Datum/Zeit formatieren	string gmdate(format [, timestamp=time()])
html_entity_decode	Konvertiert alle HTML Zeichen in geeignete Zeichen (immer mit ENT_QUOTES und UTF-8)	string html_entity_decode(string)
htmlentities	Wandelt alle geeigneten Zeichen in entsprechende HTML-Zeichen (immer mit ENT_QUOTES und UTF-8)	string htmlentities(string)
expr_mgr_htmlspecialchars	Konvertiere Sonderzeichen in HTML-Zeichen (immer mit ENT_QUOTES und UTF-8)	string htmlspecialchars(string)
expr_mgr_htmlspecialchars_decode	Konvertiere HTML-Sonderzeichen zurück in Zeichen (immer mit ENT_QUOTES und UTF-8)	string htmlspecialchars_decode(string)
idate	Formatiere Zeit / Datum als ganze Zahl	string idate(string [, timestamp=time()])
if	Excel-Style if(test,result_if_true,result_if_false)	if(test,result_if_true,result_if_false)
implode	Verbindet Array-Elemente mit einem String	string implode(glue,arg1,arg2,...,argN)
intval	Bekomm den ganzzahligen Wert einer Variablen	int intval(number [, base=10])
is_bool	Prüft ob eine Variable ein Boolean ist	bool is_bool(var)
is_empty	Bestimmen Sie, ob eine Variable als leer betrachtet wird	bool is_empty(var)
is_float	Prüft ob die Variable ein Float ist	bool is_float(var)
is_int	Prüft ob die Variable ein Integer ist	bool is_int(var)
is_nan	Prüft ob die Variable eine Nummer ist	bool is_nan(var)
is_null	Prüft ob eine Variable NULL ist	bool is_null(var)
is_numeric	Prüft ob eine Variable eine Zahl oder ein numerischer String ist	bool is_numeric(var)
is_string	Prüft ob die Variable ein String ist	bool is_string(var)
list	Gibt eine komma-seperierte List der Werte zurück	string list(arg1, arg2, ... argN)
log	Natürlicher Logarithmus	number log(number)
ltrim	Entfernt Leerzeichen (oder andere Zeichen) vom Anfang eines Strings	string ltrim(string [, charlist])
max	Findet den höchsten Wert	number max(arg1, arg2, ... argN)
min	Findet den niedrigsten Wert	number min(arg1, arg2, ... argN)
mktime	UNIX-Timestamp/Zeitstempel für ein Datum (jedes der 6 Argumente ist optional)	number mktime([hour [, minute [, second [, month [, day [, year ]]]]]])
nl2br	Fügt HTML-Zeilenumbrüche vor allen Zeilenumbrüchen eines Strings	string nl2br(string)
number_format	Formatiert eine Zahl mit Tausender-Gruppierung	string number_format(number)
pi	Wert von pi	number pi()
pow	Exponentialausdruck	number pow(base, exp)
quoted_printable_decode	Konvertiert einen quoted-printable String in einen 8-Bit-String	string quoted_printable_decode(string)
quoted_printable_encode	Konvertiert einen 8-Bit-String in einen quoted-printable String	string quoted_printable_encode(string)
quotemeta	Zitat Metazeichen	string quotemeta(string)
rand	Generiere eine Zufallszahl	int rand() OR int rand(min, max)
round	Rundet eine Zahl auf einer optionalen Genauigkeit	number round(val [, precision])
rtrim	Entfernt Leerzeichen (oder andere Zeichen) vom Ende eines Strings	string rtrim(string [, charlist])
sin	Sinus	number sin(arg)
sprintf	Gibt einen formatierten String zurück	string sprintf(format, arg1, arg2, ... argN)
sqrt	Quadratwurzel	number sqrt(arg)
stddev	Berechne die Sample-Standardabweichung für die Liste der Nummern	number stddev(arg1, arg2, ... argN)
str_pad	Fülle einen String auf eine bestimmte Länge mit einem anderen String	string str_pad(input, pad_length [, pad_string])
str_repeat	Wiederhole einen String	string str_repeat(input, multiplier)
str_replace	Ersetzen Sie alle Vorkommen des Suchstrings mit dem Ersatz-String	string str_replace(search, replace, subject)
strcasecmp	Binärsichere Groß-und Kleinschreibungs String-Vergleich	int strcasecmp(str1, str2)
strcmp	Binärsicherer String-Vergleich	int strcmp(str1, str2)
strip_tags	Entfernt HTML-und PHP-Tags aus einem String	string strip_tags(str, allowable_tags)
stripos	Findet das erste Vorkommen eines  Case-Insensitiven Strings	int stripos(haystack, needle [, offset=0])
stripslashes	Entfernt die Anführungszeichen einer Zeichenfolge in Anführungszeichen	string stripslashes(string)
stristr	Case-Insensitiven strstr	string stristr(haystack, needle [, before_needle=false])
strlen	String-Länge	int strlen(string)
strpos	Findet das erste Vorkommen eines Strings	int strpos(haystack, needle [ offset=0])
strrev	Umkehren einer Zeichenfolge	string strrev(string)
strstr	Findet das erste Vorkommen eines Strings	string strstr(haystack, needle)
strtolower	Setzt einen String in Kleinbuchstaben	string strtolower(string)
strtoupper	Setzt einen String in Großbuchstaben	string strtoupper(string)
substr	Gibt einen Teil eines Strings zurück	string substr(string, start [, length])
sum	Berechne die Summe der Werte in einem Array	number sum(arg1, arg2, ... argN)
tan	Tangens	number tan(arg)
time	Liefert die aktuelle UNIX-Timestamp	number time()
trim	Entfernt Leerzeichen (oder andere Zeichen) vom Anfang und Ende eines Strings	string trim(string [, charlist])
ucwords	Großbuchstaben den ersten Buchstaben jedes Wortes in einem String	string ucwords(string)

Geplante Funktionen (oder die zumindest in Betracht gezogen werden)

Andere Funktionen, die geplant (oder die zumindest in Betracht gezogen) sind, aber bis jetzt noch nicht enthalten sind, sind in der folgenden Liste aufgezählt. Einige von diesen sind für die Abwärtskompatibilität mit anderen Umfragetools.

Syntax	Bedeutung	Kommentare
e()	gibt den Wert von e
formatDate(X, PAT)	gibt den Zeichenfolgenwert von Datum Formatmuster PAT
getAnsOption(X)	Kern-Plugin ExpressionAnswerOptions
getAnsOption(X,Y)	Kern-Plugin ExpressionAnswerOptions
getRelevance(X)	gibt die Relevanzgleichung für Frage X zurück
getStartTime()	gibt zurück das Datum, das der Systemzeit entspricht, als das Interview gestartet wurde
getType(X)	gibt den String-Namen des Datentyps zurück – z. B. *NA*, wenn isNA()
gotoFirst()	springt zum ersten relevanten Satz von Fragen – dies verstößt gegen den normalen Ablauf des Systems
gotoNext()	springt zum nächsten Satz von relevante Fragen – dies verstößt gegen den normalen Ablauf des Systems
gotoPrevious()	springt zum vorherigen Satz relevanter Fragen – dies verstößt gegen den normalen Ablauf des Systems		-	isAsked(X)	gibt true zurück, wenn die Antwort weder *NA*, *INVALID* noch *UNASKED* ist
isInvalid(X)	gibt true zurück, wenn die Antwort ist vom Typ *INVALID*
isNA(X)	gibt true zurück, wenn die Antwort vom Typ *NA*
isNotUnderstood(X ist )	gibt true zurück, wenn die Antwort vom Typ *HUH*
isRefused(X)	gibt true zurück, wenn die Antwort vom Typ *REFUSED* ist
jumpTo(X)	springt zu der Gruppe, die die benannte Frage enthält – dies verstößt gegen den normalen Fluss des Systems
jumpToFirstUnasked()	Springe zur ersten nicht gestellten Frage und umgehe so zuvor beantwortete Fragen. Dies verstößt gegen den normalen Fluss des Systems
lastIndexOf(X,Y)	gibt den letzten Index (Basis 0) der Zeichenfolge Y in Zeichenfolge X zurück. Gibt -1 zurück, wenn Y nicht in X
list(X,..) enthalten ist.	Eine Zeichenfolge, die eine durch Kommas getrennte Liste der positiven Werte enthält, wobei die letzten beiden durch „und“ getrennt werden.
mean(X,...)	gibt den Mittelwert einer Liste zurück der Werte
numAnsOptions(X)	gibt die Anzahl der Antwortoptionen zurück, die Frage X hat
orlist(X,...)	eine Zeichenfolge, die eine durch Kommas getrennte Liste der positiven Werte enthält, wobei die letzten beiden durch „oder“ getrennt werden.
parseDate(X,PAT)	gibt den Datumswert von Zeichenfolge X zurück, analysiert mit Java-Datum Formatmuster PAT
parseNumber(X,PAT)	gibt den numerischen Wert der Zeichenfolge ,attributeList,attributeTitleList	questionList = durch Pipes getrennte Liste von Fragen-IDs; attributeList = durch Pipes getrennte Liste von Attributen (wie Fragenummer, Titel, Text, Typ – damit Sie entscheiden können, was angezeigt werden soll); attributeTitleList = durch Pipes getrennte Liste von Tabellenüberschriften, damit der Bericht internationalisiert werden kann.
showTheseResponses(questionsList,attributeList,attributeTitleList)	questionList = durch Pipes getrennte Liste von Fragen-IDs; attributeList = durch Pipes getrennte Liste von Attributen (wie Fragenummer, Titel, Text, Typ – damit Sie entscheiden können, was angezeigt werden soll); attributeTitleList = durch Pipes getrennte Liste von Tabellenüberschriften, damit der Bericht internationalisiert werden kann.

Der Ausdrucksmanager weiß, welche Variablen lokal sind

Um ordnungsgemäß JavaScript für die Seite zu konstruieren muss der Ausdrucksmanager wissen, welche Variablen auf der Seite gesetzt sind und wie ihre ID ist (e.g. für document.getElementById(x)). Er muss auch wissen, welche Variablen auf anderen Seiten gesetzt sind (sodass sichergestellt werden kann, dass die benötigten <input type='hidden' value='x'> Felder präsent und ausgefüllt sind).

Kaskadierende Bedingungen

Um es genauer zu sagen, wenn eine der Variablen irrelevant ist, wird die gesamte Gleichung irrelevant (false). In der folgenden Tabelle bedeutet N/A zum Beispiel, dass eine der Variablen nicht relevant war.

Operator	Beispiel	a	b	Ergebnis
+ (unär)	+a	N/A		false
!	!a	N/A		false
== (oder Gleichung)	a == b	N/A	5	false
== (oder Gleichung)	a == b	N/A	0	false
== (oder Gleichung)	a == b	N/A	N/A	false
!= (oder ne)	a != b	N/A	5	false
!= (oder ne)	a != b	N/A	N/A	false
!= (oder ne)	a != b	N/A	0	false
> (oder gt)	a > b	N/A	5	false
>= (oder ge)	a >= b	N/A	5	false
< (oder lt)	a < b	N/A	5	false
<= (oder le)	a <= b	N/A	5	false
und	a und b	N/A	5	falsch
und	a und b	N/A	N/A	-	oder	a oder b	N/A	N/A	false
or	a oder b	N/A	5	false
+	a + b	N/A	5	falsch
*	a * b	N/A	5	false
/	a / b	5	N/A	false
(exp)	(a && b)	N/A	5	false
|(b + b) > (a && b)	N/A	5	false
function	sum(a,b,b)	N/A	5	false
function	max(a,b)	N/A	5	false
function	min(a,b )	N/A	5	false
function	implode(', ',a,b,a,b)	N/A	5	-	function	if(a,a,b)	N/A	5	false
function	is_empty(a)	N/ A		false
function	is_empty(a)	0 (oder leer)		true
function	!is_empty(a)	N/A		false

Überschreiben kaskadierender Bedingungen

Angenommen, Sie möchten eine laufende Summe aller relevanten Antworten anzeigen. Sie könnten versuchen, die Gleichung {sum(q1,q2,q3,...,qN)} zu verwenden. Dies wird jedoch intern übersetzt in LEMif(LEManyNA('q1','q2','q3',...,'qN'),,sum(LEMval('q1'),LEMval('q2') ,LEMval('q3'),...,LEMval('qN'))). Wenn also einer der Werte q1-qN irrelevant ist, gibt die Gleichung immer „falsch“ zurück. In diesem Fall zeigt sum() 0 an, bis alle Fragen beantwortet sind.

Um dies zu umgehen, kann jeder Variablen das Suffix „.NAOK“ hinzugefügt werden (was bedeutet, dass „Nicht anwendbar“ in Ordnung ist). In solchen Fällen tritt das folgende Verhalten auf. Angenommen, Sie haben eine Variable q1.NAOK

1. q1, die nicht zur LEManyNA()-Klausel hinzugefügt wurde
2. LEMval('q1') prüft weiterhin, ob die Antwort relevant ist, und gibt sie zurück '' Wenn dies nicht der Fall ist (so werden einzelne irrelevante Antworten ignoriert, aber nicht der gesamte Ausdruck ungültig).

Somit ist die Lösung zu dem laufende-Summe-Problem, die Gleichung sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK) zu benutzen.

Die Benutzung des .NAOK Suffixes lässt Autoren auch Umfragen gestalten, die verschiedene mögliche Pfade haben, aber dies kommt später. Zum Beispiel, sagen wir das Subjekt beantwortet die Umfrage in einem Umfang außerhalb des normalen Antwortbereiches. Der Autor könnte das Subjekt benachrichtigen, dass es möglicherweise keine richtigen Ergebnisse bekommen würde und dann fragen ob es so wirklich mit der Umfrage fortfahren wolle. Wenn es Ja sagt, wird der Rest der Fragen gezeigt. Die Bedingungen der restlichen Fragen würden validieren, ob die ersten Antworten in einem normalen Bereich beantwortet wurden, oder ob das Subjekt Ja zu der Frage gesagt hat, die nur dann relevant ist, wenn die anderen Antworten außerhalb des normalen Bereiches lagen.

Wie unterstützt der Ausdrucksmanager Bedingungs-Mikro-Anpassungen?

Hier ist ein Beispiel für Mikro-Anpassungen (der Frage-Typ=='expr' bedeutet Gleichung):

Frage-Nummer	Relevanz	Frage-Typ	Frage
name	1	text	Wie heißen Sie?
age	1	text	Wie alt sind Sie?
badage	age	expr	{(age<16) oder (age>80)}
agestop	badage	message	Sorry, {name}, Sie sind zu {if( (age<16),'jung',if( (age>80),'alt','middle-aged') ) } für diesen Test.
kids	!badage	yesno	Haben Sie Kinder?
parents	1	expr	{!badage && kids=='Y'}
numKids	parents	text	Wie viele Kinder haben Sie?
kid1	parents && numKids >= 1	text	Wie alt ist Ihr erstes Kind?
kid2	parents && numKids >= 2	text	Wie alt ist Ihr zweites Kind?
kid3	parents && numKids >= 3	text	Wie alt ist Ihr drittes Kind?
kid4	parents && numKids >= 4	text	Wie alt ist Ihr viertes Kind?
kid5	parents && numKids >= 5	text	Wie alt ist Ihr fünftes Kind?
sumage	1	expr	{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)}
report	parents	yesno	{name}, Sie haben behauptet Sie seien {age} und hätten {numKids}.  Die Summe der Alter ihrere ersten {min(numKids,5)} Kinder ist {sumage}

Alle diese Fragen können auf einer einzelnen Seite sein (e.g. in der gleichen Gruppe) und nur relevante Fragen werden angezeigt. Weiterhin, indem sie das Alter der Kinder eintragen wird der sum() Ausdruck in der letzten Frage dynamisch die Seite aktualisieren.

Der Ausdrucksmanager stellt diese Funktionalität zur Verfügung indem jeder Ausdruck mit einem benannten Element eingefasst wird. Jedes mal wenn sich ein Wert verändert, berechnet es den Ausdruck der in dem Element erscheinen sollte neu und aktualisiert die Anzeige. Sie können duzende oder sogar hunderte von solchen zugeschnittenen Elementen auf der gleichen Seite haben und die Seite wird diese wieder innerhalb einer einzigen Bildschirmaktualisierung anzeigen.

Abbildung von LimeSurvey 1.91+ zur Ausdrucksmanager Funktionalität

Alte Funktion	Neue Funktion	Kommentare
Bedingungen	Relevanz	-	Bewertungen	Gleichung	Alle Bewertungsergebnisse können in eine Gleichung umstrukturiert werden. Dadurch wird einerseits sichergestellt, dass der Score in die Datenbank geschrieben wird, andererseits können Sie dynamische Änderungen am Score-Wert auf der aktuellen Seite sehen
Replacements	Expression Manager	Die Kern-Engine übernimmt die Eingabezeichenfolge und behandelt alles in geschweiften Klammern als Ausdruck – es verarbeitet also alle historischen Ersetzungstypen. Um eingebettetes JavaScript nicht durcheinander zu bringen, verarbeitet Expression Manager Inhalte nur zwischen geschweiften Klammern, solange (a) innerhalb der geschweiften Klammern kein führender oder nachgestellter Leerraum vorhanden ist – z. B. ist {expr} ein Ausdruck, aber { expr}, {expr }, und { expr } sind keine Ausdrücke. Darüber hinaus verarbeitet Expression Manager keine Inhalte innerhalb seiner eigenen Zeichenfolgen (z. B. generiert {list('hi','there {braces}')} "hi there {braces}"). Es ignoriert auch maskierte geschweifte Klammern (z. B. \{dies ist kein Ausdruck\})
Validierung	Ausdrucksmanager	Der Plan besteht darin, die aktuellen Min/Max-Frageattribute zu übernehmen und einen Ausdrucksmanager zu haben sie verarbeiten. Auf diese Weise können die Min/Max-Werte selbst Ausdrücke sein

Beziehung zu LimeSurvey Ideen / Feature-Requests

Um die Eingabe und Validierung von Ausdrücken zu erleichtern, bietet EM eine Syntaxhervorhebung mit den folgenden Funktionen:

Typen und Bedeutungen der Syntaxhervorhebung

Farbe	Beispiel	Bedeutung	Tooltip	Kommentare
tan background	Sample	the ganze Gleichung	keine	Alles in geschweiften Klammern, das als Gleichung erkannt wird (z. B. gibt es keine führenden oder nachgestellten Leerzeichen), wird farblich mit einem hellbraunen Hintergrund versehen, um es besser vom umgebenden Text unterscheiden zu können
blue text	Beispiel	Funktionsname	Bedeutung und zulässige Syntax	Funktionsnamen oder Dinge, die Funktionen sein sollten, da ihnen eine öffnende Klammer folgt, werden in fettem blauem Text dargestellt. Tooltips zeigen die Bedeutung und zulässige Syntax für die Funktion.
grey text	Sample	string	none	Einfache und doppelte Anführungszeichen werden in grauem Text angezeigt
cyanfarbener Text	Beispiel	Variablensatz auf derselben Seite,	[Name oder SGQA-Code]: Frage; Wert; Antwortliste mit Codes für jeden Wert	Jede Variable, die auf derselben Seite wie die aktuelle Frage festgelegt ist, wird in cyanfarbenem Text angezeigt, was bedeutet, dass sie in Javascript aktualisiert werden kann. Der Tooltip zeigt seinen Namen (wenn Sie INSERTANS:xxx verwendet haben) oder den SGQA-Code (wenn Sie das neue Benennungssystem verwendet haben), die eigentliche Frage und ihren aktuellen Wert (oder leer, wenn nicht festgelegt). Wenn der Fragetyp Antworten von einem Aufzählungswertesatz erwartet, wird die Zuordnung der Codes zu Anzeigewerten angezeigt.
green text	Beispiel	Variablensatz auf einer vorherigen Seite	[Name oder SGQA-Code]: Frage; Wert; Antwortliste mit Codes für jeden Wert	Jede Variable, die auf einer vorherigen Seite festgelegt wurde, wird in fettem grünem Text angezeigt. Der Tooltip zeigt seinen Namen (wenn Sie INSERTANS:xxx verwendet haben) oder den SGQA-Code (wenn Sie das neue Benennungssystem verwendet haben), die eigentliche Frage und ihren aktuellen Wert (oder leer, wenn nicht festgelegt). Wenn der Fragetyp Antworten von einem Aufzählungswertesatz erwartet, wird die Zuordnung der Codes zu Anzeigewerten angezeigt.
bold pink text	Sample	Variable wird auf einer späteren Seite festgelegt , im Allgemeinen: zu Beginn der Umfrage leer, kann aber mit einem Index gefüllt oder nach vorne verschoben werden	[Name oder SGQA-Code]: Frage; Wert; Antwortliste mit Codes für jeden Wert	Jede Variable, die auf einer nächsten Seite festgelegt wird, wird in fettem rosa Text angezeigt. Der Tooltip zeigt seinen Namen (wenn Sie INSERTANS:xxx verwendet haben) oder den SGQA-Code (wenn Sie das neue Benennungssystem verwendet haben), die eigentliche Frage und ihren aktuellen Wert (oder leer, wenn nicht festgelegt). Wenn der Fragetyp Antworten von einem Aufzählungswertesatz erwartet, wird die Zuordnung der Codes zu Anzeigewerten angezeigt.
bold tan text	Beispiel	ein Lime-Ersatzwert	der Wert	Lime-Ersatzzeichenfolgen (wie {TOKEN:xxx}, {PRIVACY_MESSAGE}) werden in fettem hellbraunem Text angezeigt.
roter Text	Beispiel	Zuweisungsoperator (=)	Warnmeldung	Wenn Sie einen der Zuweisungsoperatoren (=) verwenden, wird dieser Operator in rotem Text angezeigt. Dies soll dazu beitragen, eine versehentliche Neuzuweisung von Werten zu verhindern, wenn Sie eigentlich prüfen wollten, ob a == b, anstatt den Wert von a = b festzulegen.
normaler schwarzer Text	Sample	Interpunktion	none	Alle anderen Interpunktion innerhalb des Ausdrucks werden als normaler schwarzer Text angezeigt.
rot umrandeter Text	eine fette rote Linie umgibt der Fehler	Syntaxfehler	Beschreibung des Fehlers	Alle erkannten Syntaxfehler werden angezeigt, indem der Fehler mit einem roten Kästchen umgeben wird. Der Tooltip zeigt den Fehler an. Beispiele hierfür sind nicht übereinstimmende Klammern, die Verwendung undefinierter Funktionen, die Übergabe der falschen Anzahl von Argumenten an Funktionen, schlecht strukturierte Ausdrücke (z. B. fehlende Operatoren zwischen Variablen), der Versuch, einer schreibgeschützten Variablen einen neuen Wert zuzuweisen, der Versuch, nicht definierten Variablen Werte zuzuweisen. Variablen oder die Verwendung einer nicht unterstützten Syntax. Beachten Sie, dass das Syntaxfehlererkennungssystem möglicherweise nur einen Fehler in einem Ausdruck meldet, selbst wenn mehrere Fehler vorliegen. Wenn jedoch Fehler erkannt werden, wird mindestens ein Fehler angezeigt.

Zusätzliche Themen

Expression Manager-Beispielumfragen

Anwendungsfälle und Anleitungen

Schritt-für-Schritt-Beispiele

Expression Manager statistic functions

Referenz für Entwickler

RoadMap/Status/ToDo-Liste