Enterprise Feedback Suite

Transkript

1 Enterprise Feedback Suite LUA-Filter Version: Datum:

2 2014 QuestBack GmbH Die in dieser Publikation enthaltene Information ist Eigentum der QuestBack GmbH. Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus ist nur mit ausdrücklicher schriftlicher Genehmigung durch die QuestBack GmbH gestattet. Diese Publikation wird ohne jegliche Gewähr bereitgestellt. Enthaltene Informationen können ohne vorherige Ankündigung geändert werden. Zudem übernimmt QuestBack keine Garantie für die Exaktheit oder Vollständigkeit der Informationen, Texte, Grafiken, Links und sonstigen in dieser Publikation enthaltenen Elemente. Bei dieser Publikation handelt es sich um eine vorläufige Version, die gültigen Lizenzverträgen oder anderen Vereinbarungen mit QuestBack nicht unterliegt. Die von der QuestBack GmbH und/oder von ihren Vertriebsfirmen angebotenen Softwareprodukte können Softwarekomponenten anderer Softwarehersteller enthalten. Alle Produkte können länderspezifische Unterschiede aufweisen. QuestBack, Enterprise Feedback Suite, EFS, EFS Survey, EFS Panel, EFS Employee und EFS Leadership, weitere im Text erwähnte QuestBack-Produkte und -Dienstleistungen sowie die entsprechen Logos sind Marken und können eingetragene Marken von Quest- Back in Deutschland und anderen Ländern weltweit sein. Alle anderen Namen von Produkten und Dienstleistungen sind Marken der jeweiligen Firmen. Deutschland QuestBack GmbH Gustav-Heinemann-Ufer 72a Köln Norwegen (Hauptsitz) QuestBack AS Løvenskiolds gate Oslo

3 Inhaltsverzeichnis Inhaltsverzeichnis 1 LUA in EFS Survey Häufigkeit bisher abgeschlossener Interviews vergleichen Realisierung mit alternativer Filterbedingung Realisierung mit LUA Count-Funktion als Alternative zur Quotierung verwen Realisierung mit alternativer Filterbedingung Realisierung mit LUA Antwortmuster vergleichen Realisierung mit alternativer Filterbedingung Realisierung mit LUA Prüfen, was Teilnehmer gesehen haben Realisierung mit alternativer Filterbedingung Realisierung mit LUA Quotierung per Filter Realisierung mit alternativer Filterbedingung Realisierung mit LUA

4 4 Inhaltsverzeichnis

5 1 LUA in EFS Survey 1 LUA in EFS Survey LUA-Filter bieten insbesondere Nutzern mit Programmierkenntnissen mehr Freiheit: Filter, die mit EFS-Standardfilterdefinitionen oder alternativen Filterbedingungen bisher nur mühsam realisiert werden konnten, können mit der Skriptsprache LUA u.u. einfacher und effektiver realisiert werden. Beispielsweise steht eine Funktion zur Verfügung, die den Umgang mit System-Missings erheblich erleichtert. Wirklich komplexe Filterbedingungen können leichter abgebildet werden. Im folgen werden Beispiellösungen für verschiedene Scenarien vorgestellt, die beim Programmieren von Filtern in EFS häufiger vorkommen. Eine Dokumentation zu den LUA-Funktionen finden Sie in Kapitel des EFS Survey -Handbuchs. Detaillierte Informationen über die Skriptsprache LUA finden Sie auf der offiziellen Homepage 5

6 2 Häufigkeit bisher abgeschlossener Interviews vergleichen 2 Häufigkeit bisher abgeschlossener Interviews vergleichen Die folge Filterbedingung prüft, welche von mehreren Möglichkeiten von den Teilnehmern bisher am häufigsten gewählt wurde. Wurden bis zu dem Zeitpunkt, zu dem ein Teilnehmer den Filter passiert, v_1 oder v_2 am häufigsten gewählt, soll der Filter zutreffen. Wurde v_3 häufiger gewählt, trifft die Bedingung auf den aktuellen Teilnehmer nicht zu. 2.1 Realisierung mit alternativer Filterbedingung (count['v_1 = 1'] > count['v_2 = 1'] ) AND (count['v_1 = 1'] > count['v_3 = 1'] ) OR (count['v_2 = 1'] > count['v_1 = 1'] ) AND (count['v_2 = 1'] > count['v_3 = 1'] ) 2.2 Realisierung mit LUA Vorteile Schnelligkeit: Jede count-abfrage belastet den Server. In der alternativen Filterbedingung oben werden count-abfragen für dieselbe Variable mehrmals ausgeführt. Bei der unten gezeigten LUA-Bedingung ist nur eine count-abfrage für jede Variable erforderlich. Kürze und Übersichtlichkeit: Je mehr Variablen abgeprüft werden sollen, desto länger und unübersichtlicher wird die alternative Filterbedingung oben. Bei dem LUA-Filter werden die zu untersuchen Variablen lediglich im Abschnitt configuration einmal aufgeführt. Einfacher wartbar und konfigurierbar: Bei Änderungen muss man lediglich die zwei Arrays im Abschnitt configuration anpassen. Die Lösung kann auch von Nichtprogrammierern per Copy&Paste übernommen und angepasst werden. -- configuration vars={"v_1","v_2","v_3"} relevant_filter_vars={"v_1","v_2"} -- no need to change anything here counts={} max=nil max_var=nil for k,v in ipairs(vars) do local count=count(v) if max==nil or max<count then max_var=v max=count 6

7 2 Häufigkeit bisher abgeschlossener Interviews vergleichen for k,v in pairs(relevant_filter_vars) do if v==max_var then return true return false 7

8 3 Count-Funktion als Alternative zur Quotierung verwen 3 Count-Funktion als Alternative zur Quotierung verwen Es gibt folge Quoten: Quote 2: Quotengröße: 71. Quotenbedingung: v_94 soll beantwortet worden sein. Quote 3: Quotengröße: 139. Quotenbedingung: v_94 soll beantwortet worden sein. Quote 4: Quotengröße: 48. Quotenbedingung: v_94 soll beantwortet worden sein. Quote 5: Quotengröße: 42. Quotenbedingung: v_94 soll beantwortet worden sein. Die Filterbedingung soll alle diejenigen Teilnehmer identifizieren, die in eine dieser Quoten gefallen sind (d.h. die ID der jeweiligen Quote steht in der Variable quota) und die Frage v_94 beantwortet haben, bevor die jeweils vorgegebene Quotengröße erreicht wurde. 3.1 Realisierung mit alternativer Filterbedingung (count["quota = 2 AND v_94!=-77"]<=71 count["quota = 3 AND v_94!=-77"]<=139 count["quota = 4 AND v_94!=-77"] <= 48 count["quota = 5 AND v_94!=-77"]<=42) 3.2 Realisierung mit LUA Vorteil Einfachere Wartung (keine Tippfehler ;) ) quotas={[2]=71,[3]=139,[4]=48,[5]=42} for k,v in pairs(quotas) do if count("quota="..k.." AND v_94!=-77")<=v then return true return false 8

9 4 Antwortmuster vergleichen 4 Antwortmuster vergleichen Ein Filter soll prüfen, ob die Summe der Antworten aus einem Antwortstrang1 gleich der Summe der Antworten aus einem Antwortstrang2 ist. Im folgen Beispiel wird um der Kürze willen nur eine dieser Summen gebildet. 4.1 Realisierung mit alternativer Filterbedingung Die in der alternativen Filterbedingung verwete Syntax ( v_x > 0? 1 :0) ermöglicht es, Ausblbedingungen und nicht beantwortete Items zu berücksichtigten: ( Hat der Teilnehmer geantwortet, ist v_x > 0. Mit v_x > 0? 1 wird der Wert einheitlich = 1 gesetzt. Hat der Teilnehmer ein Item nicht gesehen oder nicht geantwortet d.h. v_x kleiner gleich 0, wird der entspreche Faktor = 0 gesetzt. Dies ist nötig, weil Missing- Werte wie -77 die Summenberechnung stören würden. ( v_135 > 0? 1 :0) + ( v_136> 0? 1 :0) + ( v_137 > 0? 1 :0) + ( v_138 > 0? 1 :0) +( v_139 > 0? 1 :0) +( v_140 > 0? 1 :0) + ( v_141 > 0? 1 :0) + ( v_142 > 0? 1 :0) + ( v_143> 0? 1 :0) + ( v_144 > 0? 1 :0) + ( v_145 > 0? 1 :0) + ( v_146 > 0? 1 :0) + ( v_147 > 0? 1 :0) + ( v_148 > 0? 1 :0) + ( v_149 > 0? 1 :0) + ( v_150 > 0? 1 :0) + ( v_151 > 0? 1 :0) +( v_152 > 0? 1 :0) +( v_153 > 0? 1 :0) +( v_154 > 0? 1 :0) +( v_155 > 0? 1 :0) +( v_156 > 0? 1 :0) +( v_157 > 0? 1 :0) +( v_158 > 0? 1 :0) +( v_159 > 0? 1 :0) + ( v_160 > 0? 1 :0) + ( v_161 > 0? 1 :0) + ( v_162 > 0? 1 :0) + ( v_163 > 0? 1 :0) + ( v_164 > 0? 1 :0) +( v_165 > 0? 1 :0) +( v_166 > 0? 1 :0) +( v_167> 0? 1 :0) +( v_168 > 0? 1 :0) +( v_169> 0? 1 :0) + ( v_170 > 0? 1 :0) +( v_171 > 0? 1 :0) +( v_172 > 0? 1 :0) +( v_173 > 0? 1 :0) ) 4.2 Realisierung mit LUA Vorteil Weniger Tippen, d.h. auch weniger Möglichkeiten, aus Versehen Fehler einzubauen. sum=0 for i=135,173 do if _G["v_"..i]>0 then sum=sum+1 9

10 5 Prüfen, was Teilnehmer gesehen haben 5 Prüfen, was Teilnehmer gesehen haben Der Filter soll Teilnehmer identifizieren, die bei allen genannten Variablen nichts gesehen haben. 5.1 Realisierung mit alternativer Filterbedingung Ähnlich wie im vorhergehen Beispiel soll die alternative Filterbedingung Ausblbedingungen und nicht beantwortete Items berücksichtigten: Hat der Teilnehmer geantwortet, ist v_x >= 0. Mit der Syntax v_x >= 0? v_x wird der Wert auf v_x gesetzt. Hat der Teilnehmer ein Item nicht gesehen oder nicht geantwortet d.h. v_x kleiner gleich 0, wird der entspreche Faktor = 0 gesetzt. Dies ist nötig, weil Missing- Werte wie -77 die Summenberechnung stören würden. ((v_864 >= 0? v_864 : 0) + (v_865 >= 0? v_865 : 0) + (v_866 >= 0? v_866 : 0) + (v_867 >= 0? v_867 : 0) + (v_868 >= 0? v_868 : 0) + (v_869 >= 0? v_869 : 0) + (v_870 >= 0? v_870 : 0) + (v_871 >= 0? v_871 : 0) + (v_872 >= 0? v_872 : 0) + (v_873 >= 0? v_873 : 0) + (v_874 >= 0? v_874 : 0) + (v_875 >= 0? v_875 : 0) + (v_876 >= 0? v_876 : 0) + (v_877 >= 0? v_877 : 0) + (v_1312 >= 0? v_1312 : 0) + (v_879 >= 0? v_879 : 0) + (v_880 >= 0? v_880 : 0) + (v_881 >= 0? v_881 : 0) = 0) 5.2 Realisierung mit LUA Vorteile Weniger Tippen. d.h. auch weniger Möglichkeiten, aus Versehen Fehler einzubauen. Schneller: Bei der ersten Variable, die größer oder gleich 0 ist, wird abgebrochen. Wenn erforderlich, kann man Zwischenwerte erzeugen, in Variablen abspeichern und weiterverwen. -- variable v_878 has been deleted and created again. simple mapping ;) v_878=v_1312 for i=864,881 do 10

11 5 Prüfen, was Teilnehmer gesehen haben if _G["v_"..i]>0 then return false return true 11

12 6 Quotierung per Filter 6 Quotierung per Filter Der Filter, der im folgen Beispiel erstellt wird, ersetzt eine Quotierung: Teilnehmer, auf die die Filterbedingung zutrifft, werden ausgescreent. 6.1 Realisierung mit alternativer Filterbedingung Mit der Filterbedingung wird für jede Quote einzeln abgefragt, 1. ob der Teilnehmer die Quotenbedingung erfüllt. 2. ob die Quote bereits voll ist. Dazu dient der count-teil der Bedingung. Die Quotengröße ist 84. (((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=1 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=1"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=2 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=2"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=3 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=3"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=4 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=4"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=5 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=5"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=6 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=6"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=7 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=7"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=8 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=8"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=9 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=9"]>84) or ((v_194049=1 and (v_193499=1 or v_ =2) and c_0002=10 ) and count ["v_194049=1 and (v_193499=1 or v_ =2) and c_0002=10"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=1 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=1"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=2 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=2"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=3 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=3"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=4 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=4"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=5 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=5"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=6 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=6"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=7 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=7"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=8 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=8"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=9 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=9"]>84) or ((v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=10 ) and count ["v_194035=1 and v_194049!=1 and v_193499>0 and c_0002=10"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=1 ) and count 12

13 6 Quotierung per Filter ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=1"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=2 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=2"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=3 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=3"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=4 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=4"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=5 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=5"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=6 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=6"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=7 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=7"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=8 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=8"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=9 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=9"]>84) or ((v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=10 ) and count ["v_194049=1 and (v_193499=3 or v_191921= 2)and c_0002=10"]>84) or ((v_194035=1 and v_194049!=1) and v_191921=2) or v_193946=5) 6.2 Realisierung mit LUA Vorteil Der Filter ist wesentlich besser konfigurierbar und leichter erweiterbar. fill_grade=84 categories=10 base_conditions={"v_194049=1 and (v_193499=1 or v_ =2)","v_194035=1 and v_194049!=1 and v_193499>0"} function check_quota(condition) f=assert(loadstring("return "..rex_pcre.gsub(condition,"(!= =)",function(s) if s=="=" then return "==" else return "~=" ))) result=f() if not (f()) then return false if (count(condition)>fill_grade) then return true if ((v_194035=1 and v_194049!=1) and v_191921=2) or v_193946=5 then return true for i=1,10 do 13

14 6 Quotierung per Filter for key,condition in ipairs(base_conditions) do if check_quota(condition.." and c_0002="..i) then return true 14