| Beide Seiten der vorigen RevisionVorhergehende Überarbeitung | |
| de:create:checks-php [16.04.2024 21:05] – admin | de:create:checks-php [23.10.2026 14:44] (aktuell) – Externe Bearbeitung 127.0.0.1 |
|---|
| ====== Individuelle Antwortprüfung ====== | ====== Individuelle Antwortprüfung ====== |
| |
| Formale Anforderungen an eine Antwort -- zum Beispiel dass alle Items einer Skala beantwortet wurden oder dass eine offene Texteingabe einem bestimten Muster folgt -- lassen sich mit wenigen Klicks in der Frage festlegen ([[:de:create:checks]]). | Formale Anforderungen an eine Antwort -- zum Beispiel dass alle Items einer Skala beantwortet wurden oder dass eine offene Texteingabe einem bestimmten Muster folgt -- lassen sich mit wenigen Klicks in der Frage festlegen ([[:de:create:checks]]). |
| |
| Komplexere Überprüfungen können mit ein wenig [[:de:create:php|PHP-Code]] realisiert werden. Dabei wird ein PHP-Filter gemeinsam mit der Funktion [[:de:create:functions:repeatpage|repeatPage()]] verwendet. | Komplexere Überprüfungen können mit ein wenig [[:de:create:php|PHP-Code]] realisiert werden. Dabei wird ein PHP-Filter gemeinsam mit der Funktion [[:de:create:functions:repeatpage|repeatPage()]] verwendet. |
| |
| * Sie können __auf der Seite__, deren Antworten geprüft werden sollen, unten die Funktion //Verarbeitung der Antworten mittels PHP// verwenden. | * Sie können __auf der Seite__, deren Antworten geprüft werden sollen, unten die Funktion //Verarbeitung der Antworten mittels PHP// verwenden. |
| * Sie können den PHP-Code auf der Seite __nach__ der Frage ganz oben platziert werden. Wenn also die zu prüfende Frage auf Seite 2 gestellt wird, dann würde der PHP-Code zur Prüfung auf Seite 3 ganz oben stehen. | * Sie können den PHP-Code auf der Seite __nach__ der Frage ganz oben platzieren. Wenn also die zu prüfende Frage auf Seite 2 gestellt wird, dann würde der PHP-Code zur Prüfung auf Seite 3 ganz oben stehen. |
| |
| **Hinweis:** Überlegen Sie vorab, ob eine Überprüfung der Antwort tatsächlich zielführend ist. Das ist dann der Fall, wenn Teilnehmer ihre Angaben versehentlich in einem falschen Format machen. Wenn Sie hingegen erwarten, dass sich die Teilnahmer mangels Motivation ("nur mal durchklicken") oder absichtlich nicht an die Vorgaben halten, dann ist es oftmals besser, die fehlerhaften Angaben in Kauf zu nehmen und bei der Datenbereinigung zu filtern. | **Hinweis:** Überlegen Sie vorab, ob eine Überprüfung der Antwort tatsächlich zielführend ist. Das ist dann der Fall, wenn Teilnehmer ihre Angaben versehentlich in einem falschen Format machen. Wenn Sie hingegen erwarten, dass sich die Teilnehmer mangels Motivation ("nur mal durchklicken") oder absichtlich nicht an die Vorgaben halten, dann ist es oftmals besser, die fehlerhaften Angaben in Kauf zu nehmen und bei der Datenbereinigung zu filtern. |
| |
| **Tipp:** Weitere Details zur Programmierung von PHP-Filtern finden Sie unter [[:de:create:php-filters]]. | **Tipp:** Weitere Details zur Programmierung von PHP-Filtern finden Sie unter [[:de:create:php-filters]]. |
| Eine Fehlermeldung können Sie anzeigen, wenn Sie als Argument in der Funktion ''repeatPage()'' die Kennung eines Textbausteins eintragen (s. unten). Alternativ können Sie auch einen entsprechenden Textbaustein mittels [[:de:create:functions:text|text()]] anzeigen. Für die zweite Variante wählen Sie beim Anlegen des Textbausteins aus, dass der Text im Stil einer //Warnung// angezeigt wird -- dann erhält er dieselbe Formatierung wie die Standard-Fehlermeldungen. | Eine Fehlermeldung können Sie anzeigen, wenn Sie als Argument in der Funktion ''repeatPage()'' die Kennung eines Textbausteins eintragen (s. unten). Alternativ können Sie auch einen entsprechenden Textbaustein mittels [[:de:create:functions:text|text()]] anzeigen. Für die zweite Variante wählen Sie beim Anlegen des Textbausteins aus, dass der Text im Stil einer //Warnung// angezeigt wird -- dann erhält er dieselbe Formatierung wie die Standard-Fehlermeldungen. |
| |
| Im folgenden finden Sie einige Anwendungsbeispiele für individuelle Antwortprüfungen inklusive dem erforderlichen PHP-Code. | Im Folgenden finden Sie einige Anwendungsbeispiele für individuelle Antwortprüfungen inklusive dem erforderlichen PHP-Code. |
| |
| |
| ==== Variante A ==== | ==== Variante A ==== |
| |
| Eine Möglichkeit besteht darin, einfach für jede Zeile (Item) die auswählten Items abzuzählen. Wurde nichts gewählt, kommt die Item-Nummer auf eine Liste ''$missing'' und anschließend werden die Fehler markiert. | Eine Möglichkeit besteht darin, einfach für jede Zeile (Item) die ausgewählten Items abzuzählen. Wurde nichts gewählt, kommt die Item-Nummer auf eine Liste ''$missing'' und anschließend werden die Fehler markiert. |
| |
| Die Funktion [[:de:create:functions:id]] erstellt aus der Kennung der Rubrik ("MA"), der Nummer der Frage (z.B. 1) und der Nummer des Items (z.B. 5) die Variablen-Kennung zum Abruf der Antwort (z.B. "MA01_05"). | Die Funktion [[:de:create:functions:id]] erstellt aus der Kennung der Rubrik ("MA"), der Nummer der Frage (z.B. 1) und der Nummer des Items (z.B. 5) die Variablen-Kennung zum Abruf der Antwort (z.B. "MA01_05"). |
| $missing = array(); | $missing = array(); |
| // Die Funktion getItems() liefert eine Liste mit Item-Nummern (=Zeilen) | // Die Funktion getItems() liefert eine Liste mit Item-Nummern (=Zeilen) |
| // De Konstruktion FOREACH durchläuft diese alle in einer Schleife | // Die Konstruktion FOREACH durchläuft diese alle in einer Schleife |
| foreach (getItems('MA01', 'all') as $item) { | foreach (getItems('MA01', 'all') as $item) { |
| // Alle Spalten (Fragen) für dieses Item in einer FOR-Schleife durchgehen | // Alle Spalten (Fragen) für dieses Item in einer FOR-Schleife durchgehen |
| ===== Konsistenzprüfung Texteingabe ===== | ===== Konsistenzprüfung Texteingabe ===== |
| |
| Bei offenen Texteingaben kann eingestellt werden, dass sie nur Zahlen akzeptieren ([[:de:create:checks#eingabe_von_nummern|Antworten prüfen: Eingabe von Nummern]]). Im folgenden soll überprüft werden, ob in drei Eingabefeldern konsistente Werte eingetragen wurden. | Bei offenen Texteingaben kann eingestellt werden, dass sie nur Zahlen akzeptieren ([[:de:create:checks#eingabe_von_nummern|Antworten prüfen: Eingabe von Nummern]]). Im Folgenden soll überprüft werden, ob in drei Eingabefeldern konsistente Werte eingetragen wurden. |
| |
| * TX01_01 -- Anzahl von Personen im Unternehmen | * TX01_01 -- Anzahl von Personen im Unternehmen |
| ===== Eine von zwei Fragen beantwortet ===== | ===== Eine von zwei Fragen beantwortet ===== |
| |
| Im folgenden Beispiel wir überprüft, ob eine von zwei Texteingabefragen ("TX01_01" oder "TX02_01") ausgefüllt wurde. Wenn keines der Eingabefelder beantwortet wurde, dann wird die Fehlermeldung TX03 gezeigt und die Seite erneut zum Beantworten vorgelegt. | Im folgenden Beispiel wird überprüft, ob eine von zwei Texteingabefragen ("TX01_01" oder "TX02_01") ausgefüllt wurde. Wenn keines der Eingabefelder beantwortet wurde, dann wird die Fehlermeldung TX03 gezeigt und die Seite erneut zum Beantworten vorgelegt. |
| |
| **Tipp:** Die Funktion ''trim()'' entfernt Leerzeichen am Anfang und Ende eines Strings, sodass die Eingabe von Leerzeichen nicht als Eingabe akzeptiert wird. | **Tipp:** Die Funktion ''trim()'' entfernt Leerzeichen am Anfang und Ende eines Strings, sodass die Eingabe von Leerzeichen nicht als Eingabe akzeptiert wird. |