HJÆLP TIL AVANCEREDE UDTRYK I SURVEYXACT

Transkript

1 HJÆLP TIL AVANCEREDE UDTRYK I SURVEYXACT GENERELT OM AKTIVERINGER, VALIDERINGER OG REFERENCER Du kan opbygge valideringer, aktiveringer og referencer ved hjælp af udtryk i SurveyXact. En aktiveringsbetingelse er et logisk udtryk, der afgør, om det element, aktiveringen er tilknyttet, skal vises for respondenten. I denne forbindelse kan et element være en side, et helt spørgsmål, en række/kolonne i et spørgsmålsbatteri, en svarkategori eller et tekstelement. Er udtrykket sandt, vises elementet. Hvis udtrykket er falsk, vises det ikke. En valideringsbetingelse er et logisk udtryk, der afgør, om respondenten skal have lov til at gå videre til næste side i det elektroniske skema, eller om respondenten skal have en valideringsfejl. Er alle valideringsbetingelser på en side sande (dvs. opfyldte), får respondenten lov til at gå videre i spørgeskemaet - ellers ikke. En reference er et udtryk, der i modsætning til aktiverings- og valideringsudtryk, ikke er enten sandt eller falsk, men derimod returnerer (dvs. har som resultat) en bestemt værdi eller en tekst. Værdien indsættes på det sted i spørgeskemaet, som referencen angiver. Såvel aktiveringer, valideringer og referencer opbygges af variable fra spørgeskemaet og baggrundsskemaet. De variable du kan bruge, vises i boksen til venstre. Bemærk, at såvel variable fra baggrundsskemaet som fra selve spørgeskemaet kan bruges, men at variable på samme side (eller senere i skemaet) ikke kan anvendes til en aktiveringsbetingelse og/ eller en reference (undtagen i valideringsmeddelelser), da værdien af disse ikke kendes på det tidspunkt udtrykket evalueres. For valideringsbetingelser er det kun variable på efterfølgende sider, som ikke kan anvendes. I boksen til højre angives selve udtrykket. De variable, du vil bruge i selve udtrykket, kan skrives direkte ved at angive variabelnavnet i en firkantet parantes [variabelnavn], eller du kan vælge variablen (og for single-choice variabel en bestemt svarmulighed) til venstre og klikke på pilen, så den føres over i udtryksboksen. Bemærk, at når der i spørgeskemaet henvises til variable i baggrundsskemaet, skal du have navnet på baggrundsskemaet med. I de fleste af de følgende funktioner kan man bruge både rå værdier og variabler med [variabelnavn] notationen.

2 OVERSIGT OVER UDTRYK OG FUNKTIONER LOGISK UDTRYK ER SAND, HVIS... EKSEMPEL [variabelnavn].[label værdi]... svarmuligheden tilhørende den pågældende label værdi er valgt på skalaen/variablen [s_1].[1.0] [variabelnavn] IS NULL... variablen/spørgsmålet er blank/tom/missing [s_1] IS NULL NOT (udtryk)... udtrykket i parentesen er FALSK NOT ([s_1].[1.0]) (udtryk1) AND (udtryk2)... begge udtryk er SAND ( [s_1].[1.0] ) AND ( [s_2].[2.0] ) (udtryk1) OR (udtryk2)... enten udtryk1 eller udtryk2 er SAND ( [s_1].[1.0] ) OR ( [s_2].[2.0] ) [variabelnavn] <, <=, >, >=, = X [variabelnavn1] <, <=, >, >=, = [variabelnavn2] [variabelnavn]... en numerisk variabel er henholdsvis mindre end, mindre end eller lig, større end, større end eller lig og lig en bestemt værdi (X)... en numerisk variabel er henholdsvis mindre end, mindre end eller lig, større end, større end eller lig og lig en anden numerisk variabel Hvis variabelnavn er en single-choice variabel så er udtrykket SAND hvis spørgsmålet er udfyldt. [s_3] >= 18.0 [s_3] <= [s_4] [s_1] = SAND hvis s_1 er besvaret af respondenten. KONTROL FUNKTIONER IIF(logisk, værdi1, værdi2) Funktion som antager værdien værdi1, hvis udtryk er SAND og værdi2 ellers. Typen som IFF en returnere er typen af den værdi som bliver returneret og kan derfor være forskellig afhængig af logisk IIF([s_1]>1.0, Første svarmulighed valgt, Første svarmulighed ikke valgt ) NUMERISKE FUNKTIONER tal1 + tal2 tal1 tal2 tal1 / tal2 tal1 * tal2 [variabelnavn] SUM(tal1, tal2, ) AVERAGE(tal1, tal2, ) VALUE(værdi) Funktion som henholdsvis lægger to numeriske variable sammen, trækker dem fra hinanden, dividerer dem med hinanden og ganger dem med hinanden. Hvis variablen ikke er en numerisk åben variabel, som indeholder en værdi, giver hele udtrykket blank/tom/ missing/null. Resulterer i den numeriske værdi som respondenten har indtastet i spørgeskemaet. Summerer tallene. Hvis tal Antager værdien 0, hvis variablen/ spørgsmålet er blank/tom/missing eller et tekstspørgsmål, labelværdien for den valgte svarmulighed ved single-choice (ved flere kryds i multiple-choice spørgsmål, den mindste labelværdi) og værdien selv for numeriske variable. Typen er altid et tal. Udregner gennemsnittet af tallene. Der ses bort fra eventuelt tomme/ missing/blanke variable i beregningen. Dog gælder, at hvis begge/ alle variable er tomme giver funktionen selv tom/missing/blank. Konverterer en variabel til en numerisk værdi. En numerisk variabel bliver til en numerisk værdi. En skalavariabel bliver til den valgte ikke-manglende værdi. En multiple-choice variabel bliver værdien til den mindste af de valgte label værdier. [s_3]+[s_4], = 3 [s_3]-[s_4], 1 2 = -1 [s_3]/[s_4], 3 / 6 = 0.5 [s_3]*[s_4], 2 * 3 = 6 [s_1] SUM([s_3]) SUM(1, 2, 3) = 6 AVERAGE(1.0, 2.0, 3.0) = 2.0 AVERAGE([s_1], [s_2]) AVERAGE([s_1], [s_2], [s_3],[s_4]) POW(tal1, tal2) Opløfter tal1 til tal2 ene potens POW([s_4],[s_3]) eller POW(2.0,8.0) = 256.0

3 VALIDERINGS FUNKTIONER REQUIRED([variabelnavn]) COUNTCHECKED([variabel navn1]) CHECKDEPEND([variabel1].[labelværdi], [variabel2]) SAND hvis spørgsmålet er udfyldt. Er en forkortelse af NOT([variabelnavn] IS NULL) Optæller antallet af krydser respondenten har sat hvis variabelnavn1 er et multiple-choice eller singlechoice spørgsmål. Giver NULL hvis variabelnavn1 er en tekst variabel. Hvis respondenten skal svare på et single-choice spørgsmål men har mulighed for at skrive sit eget svar udover de faste svar muligheder benyttes denne funktion til at validere at dette er sket. variabel1 henviser altså til single-choice variablen og variabel2 til tekst variablen. REQUIRED([s_1]) COUNTCHECKED([s_1]) = 3 hvis s_1 er en multiple-choice variabel og har 3 markerede spørgsmål. COUNTCHECKED([s_2]) = 1 hvis s_2 er et single-choice spørgsmål og det er besvaret. COUNTCHECKED([s_3]) = NULL hvis s_3 er et tekst spørgsmål. CHECKDEPEND([s_1].[5.0], [s_1_1]) Hvor s_1 er en single-choice variabel, 5.0 er label-værdien på andet svarmuligheden og s_1_1 er det tekst spørgsmål hvor respondenten kan angive sit svar som ikke er blandt de faste valgmuligheder. VALID (tekst) Kontrollerer at den givne tekst er en gyldig efter RFC 821. Dette forhindrer mange fejl. AFRUNDINGS FUNKTIONER ROUND(tal) Afrunder værdien med de almindelige afrundings regler ROUND([s_4]), ROUND(4.5) = 5, ROUND(4.4) = 4, ROUND(4.6) = 5 ROUND(tal, tal_decimaler) Afrunder tal til tal_decimaler decimaler efter de almindelige afrundings regler ROUND(4.56, 1) = 4.6, ROUND(4.5, 1)=4.5 ROUNDUP(tal) Runder tal op til nærmeste heltal længere væk fra 0. Altså symmetrisk omkring 0. ROUNDUP([s_4]), ROUNDUP(4.5) = 5, ROUNDUP(4.4) = 5, ROUND- UP(4.6) = 5 ROUNDUP(-4.4) = -5, ROUND- UP(-4.6) = -5 ROUNDUP(tal, tal_decimaler) Runder tal op til nærmeste tal med tal_decimaler decimaler længere væk fra 0 ROUNDUP(4.567, 2) = 4.57 ROUNDUP(-4.567, 2) = ROUNDDOWN(tal) Runder tal ned til nærmeste heltal tættere på nul. ROUNDDOWN( ) = 3 ROUNDDOWN(3.14) = 3 ROUNDDOWN(tal, tal_decimaler) CEILING(tal) CEILING(tal, tal_decimaler) FLOOR(tal) Runder tal ned til nærmeste tal tættere på nul med tal_decimaler decimaler Runder tal op til nærmeste hele tal. Altid imod et større tal. Runder tal op til nærmeste komma tal med tal_decimaler decimaler. Runder tal ned til nærmeste heltal. Altid imod et mindre tal. ROUNDDOWN( , 2) = 2.71 ROUNDDOWN(3.14, 1) = 3.1 CEILING([s_3]) for at afrunde s_3 til nærmeste hele tal. CEILING(-2.7) = -2 CEILING(2.4) = 3 CEILING([s_3], 2) for at runde s_3 op til to decimaler. FLOOR(2.76, 1) = 2,7 FLOOR(-2.76) = -2.8 FLOOR(tal, tal_decimaler) Runder tal ned til nærmeste komma tal med tal_decimaler. FLOOR(2.76, 1) = 2,7 FLOOR(-2.76) = -2.8

4 KONTROL FUNKTIONER NUMBER(værdi) STRING(værdi) Konverterer en tekst til et tal. Hvis værdi ikke er et tal returneres intet. Konverterer værdi til tekst udgaven af værdien. Hvis værdi er NULL returneres den tomme streng. NUMBER([s_5]) eller NUMBER( 2.0 ) = 2.0 eller NUMBER( tre ) = NULL TIDSFUNKTIONER DATE(værdi) DATE(værdi, tekst_dato_format) VALIDDATE(værdi) TIME(værdi) TIME(værdi, tekst_time_format) VALIDTIME(værdi) DATETIME(værdi) DATETIME(værdi, tekst_datetime_ format) VALIDDATETIME(værdi) TIMEDIFF(værdi1, værdi2) DATEDIFF(værdi1, værdi2) Forsøger at konverterer værdi til en dato. Datoens format skal være yyyy-mm-dd hvor yyyy er år, mm er måned og dd er dagen. Hvis den givne værdi ikke er en gyldig dato antager udtrykket værdien NULL Giver større frihed end den forrige da man selv kan bestemme hvilket format man vil anvende. Formatet er beskrevet på SimpleDateFormat Kontrollerer at den givne værdi er en dato i det korrekte format nemlig yyyy-mm-dd hvor yyyy er årstal, mm er månede og dd er dagen Forsøger at konverterer værdi til et klokkeslæt. Formatet skal overholde HH:mm:ss. Samme som ovenover men du kan selv specificere formatet (se SimpleDateFormat) Kontrollerer at det givne klokkeslæt har det korrekte format nemlig HH:mm:ss, hvor HH er timer, mm er minutter og ss er sekunder. Hvis værdi følger mønsteret yyyy-mm-dd HH:mm:ss konverteres den til et Time objekt som indeholder både dato og klokkeslæt. Samme som ovenover men du kan selv specificere formatet (se SimpleDateFormat) Hvis værdi følger mønsteret yyyy-mm-dd HH:mm:ss bliver udtrykket SAND Antallet af sekunders forskel mellem de to værdier. Hvis en eller begge værdier ikke er tider returneres NULL Antallet af dages forskel mellem de to værdier. Hvis en eller begge værdier ikke er dato er returneres NULL DATE([s_1]), DATE( ) = dags dato, DATE( ) = NULL, DATE( 3. november 2001 ) = NULL DATE( , dd-mm-yy ) = dags dato VALIDDATE ([s_1]), VALIDDATE ( ) = SAND, VALIDDATE ( ) = FALSK TIME( 14:47:42 ) er gyldig VALIDTIME([s_1]), VALIDTIME( 14:47:42 ) = FALSK, VALIDTIME( 20:80:30 ) = FALSK DATETIME( :42:42 ) er gyldig TIMEDIFF( :42:42, :42:29 ) = 13 TIMEDIFF([s_1],[s_2]) TIMEDIFF( 3.14, ) = NULL DATEDIFF( , )=1 DATEDIFF( , )=-42 NOW() Returnerer nuværende dato og klokkeslet. STRING(NOW()) = :37:43 Klik her for at se en skridt-for-skridt guide om oprettelse af datovalideringer.

5 TEKSTFUNKTIONER [variabelnavn] Hvis variabelnavn refererer til en tekst variabel evaluerer udtrykket til en tekst. [s_1] LENGTH(tekst) Beregner længden af et svar på en åben tekst variabel LENGTH([s_5]) CONTAINS(tekst1, tekst2) SUBSTR(tekst, tal1, tal2) SAND hvis tekst1 indeholder tekst2. Store og små bogstaver er ikke betydende. Svare til at klippe en printet tekst i stykker hvor man starter med at klippe før bogstavet på position tal1 og klipper igen efter tal2 bogstaver. Mellemrum og tegn skal også tælles med. CONTAINS([s_5], blå ) CONTAINS( himlen ER blå, er ) = SAND CONTAINS( grøn gul blå, [s_6]) SUBSTR( Dette er en tekst, 9, 8) = en tekst MÆNGDEFUNKTIONER COUNTEQ(værdi1, værdi2, ) IN(værdi1, værdi2, ) SET(værdi1, værdi2, ) LIST(værdi1, værdi2, ) COUNTA(værdi1, værdi2, ) MAP(værdi1,værdi2,værdi3, værdi4, ) LOOKUP(værdi, map) Beregner hvor mange gange værdi1 forekommer blandt de efterfølgende værdier. Kan fx bruges til at validere spørgsmål hvor respondenten skal prioritere mellem forskellige faste svar og kun må bruge hvert tal 1 gang Hvis en værdi optræder både som værdi1 og som en af de følgende værdier bliver IN( ) SAND hvis værdi1 ikke findes bliver IN( ) FALSK. Kan bruge både SET og LIST Konverterer alle værdierne til en ægte mængde dvs. hvis 2 eller flere af værdierne er ens bliver kun en af dem taget med i mængden. Det resultere også i at alle værdierne skal evalueres helt da de ellers ikke kan sammenlignes for at fjerne overflødige værdier. Samler et antal værdier i en liste. Alle værdierne bliver evalueret inden de bliver indsat i listen. Tæller hvor mange af værdierne som ikke er missing/null. Værdierne kan også være SET og LIST Opretter et map hvor værdierne skiftevis er nøgle og værdi. Altså værdi1 er nøgle og værdi2 er værdi etc. Bruges til at få værdier ud af et map. Hvis værdi findes som nøgle i map så returneres den tilhørende værdi fra mappet. COUNTEQ( blå, grøn, hvid, blå, Blå, rød ) = 1 COUNTEQ(1.0, [s_1], [s_2]) = 1 AND COUNTEQ(2.0, [s_1], [s_2]) = 1) er SAND hvis 1 og 2 er brugt præcist 1 gang hver. IN( blå, SET( rød, grøn ), blå, pink ) = SAND, IN( Rød, SET( rød, grøn ), blå, pink ) = FALSK, IN( rød, SET( rød, grøn ), blå, pink ) = SAND SET([s_1], DATE( ), [s_2], En tekst ) SET( EN, TO, EN ) = SET( EN, TO ) LIST( EN, TO, EN ) = LIST( EN, TO, EN ) MAP(1.0, blå, 2.0, grøn, 3.0, pink ) LOOKUP(1.0, [c_1]) = blå hvis c_1 er sat til det map som er beskrevet ovenover.

6 HÅNDTERING AF MISSING VALUES/TOMME BESVARELSER I UDTRYK Udtrykket [spm02] > 10 giver ikke nogen mening, hvis spm02 ikke indeholder en værdi (er ubesvaret). Udtrykket er således hverken sandt eller falsk. I såvel aktiverings- som valideringsbetingelser håndteres dette ved at se bort fra betingelsen. Valideringsbetingelsen [spm02] > 10 vil således ikke give anledning til en valideringsfejl, selvom spm02 er ubesvaret. Tilsvarende vil et element med aktiveringsbetingelsen [spm02] > 10 blive aktiveret, selvom spm02 er blank. Ønsker du en anderledes reaktion kan du blot tilføje AND NOT([spm02] IS NULL). Hele udtrykket vil nu være falsk, hvis spm02 er ubesvaret, og elementet vil ikke blive aktiveret, dvs. respondenten vil få en valideringsfejl. En anden mulighed er at anvende SUM([spm02]) > 10. Hvis spm2 er ubesvaret, vil SUM([spm2]) være lig 0 og udtrykket dermed falsk. EKSEMPLER PÅ AKTIVERINGSBETINGELSER (A) Nedenfor vises en række eksempler på aktiveringsbetingelser (valideringsbetingelser opbygges på samme måde). Aktiveringsbetingelse: [spm01].[2] Elementet aktiveres, hvis svarkategorien med labelværdi 2 er valgt på skalaen med variabelnavnet spm01. Hvis spm01 er ubesvaret, aktiveres elementet ikke. Aktiveringsbetingelse: [spm02] > 10 Elementet aktiveres, hvis den åbne numeriske variabel spm02 er udfyldt med et tal, som er større end 10. I stedet for > kan også anvendes <, <=, >=, = og <>. Aktiveringsbetingelse: [spm02] > 10 AND REQUIRED([spm02]) Hvis du tillader, at spm02 kan være ubesvaret (se valideringsbetingelser), men ikke vil have aktiveret elementet, hvis det er ubesvaret, skal du benytte ovenstående aktiveringsbetingelse. Her er sammensat to udtryk med operatoren AND, hvilket betyder, at elementet kun vil blive aktiveret, hvis begge udtryk er sande. REQUIRED([spm02]) betyder, at spm02 ikke er ubesvaret/missing. Hvis dette ikke er opfyldt, vil hele udtrykket være falsk (elementet vil ikke blive vist). Aktiveringsbetingelse: ([spm01].[1] OR [spm01].[2] OR [spm01].[3]) AND [spm02] >= 0 Elementet aktiveres, hvis respondenten har valgt svarmulighederne med labelværdierne 1, 2 eller 3 i spm01 og samtidig har skrevet et tal i spm02, som er større end eller lig nul. Hvis der kun er fire svarmuligheder på skalaen i spm01, kunne aktiveringsbetingelsen også være skrevet som: Aktiveringsbetingelse: NOT ([spm01].[4]) AND REQUIRED([spm01]) AND [spm02] >= 0 Aktiveringsbetingelse: SUM([spm03], [spm04], [spm05]) >= 100 Elementet aktiveres, hvis summen af de tal, som respondenten har angivet i spm03, spm04 og spm05, er større eller lig 100. Hvis et af spørgsmålene er ubesvarede, regnes de med som 0. Aktiveringsbetingelse: AVERAGE([spm06], [spm07], [spm08]) < 3 Spm06, spm07 og spm08 hører til 3 tilfredshedsspørgsmål på en 5-punktsskala (1=meget utilfreds, 2=utilfreds, 3=hverken eller, 4=tilfreds, 5=meget tilfreds). Hvis du ønsker en side med nogle uddybende spørgsmål aktiveret (f.eks. hvis respondenten gennemsnitligt er utilfreds med de tre spørgsmål) kan du benytte følgende: Aktiveringsbetingelse: SUM([spm06]) <= 2 AND REQUIRED([spm6]) Spm06 er den samme som ovenfor. Nu ønskes et bestemt element aktiveret, hvis respondenten har svaret utilfreds eller meget utilfreds. Elementet ønskes ikke aktiveret, hvis spm06 ikke indeholder en værdi, og derfor er sidste den af betingelsen nødvendig. Ovenstående er i øvrigt det samme som betingelsen: [spm06].[1] OR [spm06].[2].

7 Aktiveringsbetingelse: COUNTCHECKED([spm09]) > 1 Der ønskes kun et bestemt element aktiveret, hvis respondenten i multiple-choice-spørgsmålet (spm09) har valgt mere end én af svarmulighederne. EKSEMPLER PÅ VALIDERINGSBETINGELSER (V) Valideringsbetingelse: SUM([spm01]) >= SUM([spm02]) I spm01 bedes en virksomhed angive den samlede omsætning. I spm02 bedes virksomheden angive den omsætning, som er relateret til Internettet. Nu ønskes det sikret, at respondenten ikke angiver et større tal i spm02 end i spm01. Valideringsbetingelse: CHECKDEPEND([spm09].[7], [spm10]) Spm09 er et single-choice spørgsmål, hvor der til svarmulighed 7 Andet (labelværdi 7) er knyttet et åbent tekstfelt [spm10], hvor respondenten kan uddybe sit svar. I dette tilfælde ønsker man at sikre, at respondenten faktisk skriver noget i tekstfeltet, hvis han/hun vælger svarmulighed 7 (Andet), og at der ikke KAN skrives noget i tekstfeltet, hvis ikke svarmulighed 7 er valgt. Valideringsbetingelse: COUNTCHECKED([spm90]) <= 3 Vi har bedt respondenten om maks. at sætte 3 kryds i spm09, og ønsker at sikre at respondenten overholder dette. EKSEMPLER PÅ REFERENCER (E) Reference: [spm02] Indsætter den værdi eller tekst, som respondenten har indtastet i spm02. Bemærk at dette ikke fungerer, hvis spm02 hører til en skalavariabel. I sådanne situationer skal du benytte IIF-funktionen til at styre, hvilken tekst referencen skal returnere, hvis en bestemt svarmulighed er valgt (se nedenfor) eller evt. anvende SUM- eller AVERAGE-funktionen til at få labelværdien vist. Reference: IIF([Kon].[1], Hr., Fru ) Hvis respondenten har valgt svarmuligheden med labelværdien 1, indsættes teksten Hr., og ellers indsættes teksten Fru.. I forlængelse kunne der med fordel indsættes en reference til en variabel fra baggrundsskemaet indeholdende navnet på respondenten. Så ville både køn og navn fremgå.