Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:survey:quota [22.07.2022 09:26] – Fehlersuche ergänzt admin
+++ de:survey:quota [09.01.2023 22:25] (aktuell) – [Minimal-Quotierung] admin
@@ Zeile 8: / Zeile 8: @@
-===== Funktionsweise=====
+===== Minimal-Quotierung =====
-Die Quotierung erfolgt in folgenden Schritten:
+Mitunter soll eine Erhebung mit dem Erreichen einer bestimmten Anzahl von Fällen beendet werden.
+Legen Sie im Fragenkatalog einen Text an, welcher nach Erreichen der Fallzahl angezeigt werden soll und fügen Sie auf der ersten Seite des Fragebogens ganz oben folgenden PHP-Code ein. Der Beispiel-Code geht davon aus, dass der Text die Kennung "QS01" hat und die Erhebung nach 250 ausgefüllten Fragebögen enden soll.
+<code php>
+// Abgeschlossene Fragebögen zählen
+$finished = statistic('count', 'FINISHED');
+// Filter zum Quotenstopp
+if ($finished >= 250) {
+  // Text anzeigen
+  text('QS01');
+  // Weiter-Knopf ausblenden
+  buttonHide();
+  // Keine weiteren Inhalte dieser Seite zeigen
+  pageStop();
+}
+</code>
+**Hinweis:** Dieser PHP-Code zähle alle Fälle mit MODE "interview" und FINISHED 1. Dies können auch Fälle sein, bei denen mittels ''redirect()'' ein Screenout erfolgt. Im Debug-Modus werden die Fälle unabhängig von der Variable MODE gezählt.
+Setzen Sie die Zählung abgeschlossener Fälle mittels ''%%'FINISHED'%%'' __nicht__ zusätzlich zu einer differenzierteren Quotierung ein. Fälle, die aufgrund eines Quota-Out mittels ''redirect()'' abgewiesen wurden, werden von ''statistic('count', 'FINISHED')'' als abgeschlossene Fälle gezählt. In solchen Fällen können Sie stattdessen mit der Häufigkeit von LASTPAGE arbeiten. Wenn der ''redirect()''-Befehl auf Seite 25 steht und alle Befragten vorher Seite 24 beantworten, könnte der Code wie folgt aussehen.
+<code php>
+// Relevante Fragebögen zählen
+$finished = statistic('count', 'LASTPAGE', 24);
+// Filter zum Quotenstopp
+// (weiter wie oben)
+</code>
+==== Filterung ====
+Falls Sie sicherstellen möchten, dass nur Fälle mit bestimmten Eigenschaften gezählt werden, legen Sie eine [[:de:create:questions:internal|interne Variable]] an (im folgenden Beispiel "QS02_01") und geben Sie dieser Variable nur dann den Wert 2, wenn ein Fall die gewünschten Kriterien erfüllt. Wenn zum Beispiel der folgende PHP-Code auf der vorletzten Seite des Fragebogens platziert wird, dann werden nur Fälle gezählt, welche die vorletzte Seite erreichen und bis dorthin mindestens 10 Minuten (600 Sekunden) benötigt haben.
+<code php>
+$time = caseTime('hitherto');
+if ($time >= 600) {
+  put('QS02_01', 2);
+}
+</code>
+Der eigentliche Quotestopp bezieht sich dann nicht mehr auf die Variable "FINISHED", sondern auf die interne Variable. Auf der ersten Seite des Fragebogens würde dann z.B. der folgende PHP-Code platziert.
+<code php>
+// Gültige Fragebögen zählen
+$valid = statistic('count', 'QS02_01', 2);
+// Filter wie oben
+if ($valid >= 250) {
+  text('QS01');
+  buttonHide();
+  pageStop();
+}
+</code>
+===== Funktionsweise Quotierung =====
+Die Quotierung nach demografischen Gruppen erfolgt in folgenden Schritten:
   - Abfrage der Quoten-Merkmale einer Person mittels ''[[:de:create:functions:value]]''.