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.09.2022 21:10] – [Filterung] admin
@@ Zeile 8: / Zeile 8: @@
-===== Funktionsweise=====
+===== Minimal-Quotierung =====
+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.
+==== 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 erfolgt in folgenden Schritten: