Udtryksmanager

Hurtig startvejledning

Oversigt

Når du tilpasser dine undersøgelser, har du typisk brug for en måde at specificere følgende på:

1. Navigation/Branching - at lade et emnes svar ændre rækkefølgen, som spørgsmålene stilles i
2. Skræddersy/ Piping - hvordan man formulerer spørgsmålet (såsom at henvise til tidligere svar eller konjugere sætninger baseret på antallet eller køn af dine emner), eller hvordan man genererer tilpassede rapporter (som vurderingsresultater eller skræddersyede råd).

#Validation - sikring af, at svar opfylder visse kriterier, såsom min. og maks. værdier, eller matcher et inputmønster

Expression Manager (EM) giver en intuitiv måde at specificere logikken for hver af disse funktioner. Næsten alt, hvad du kan skrive som en standard matematisk ligning, er et gyldigt udtryk, selvom du kalder funktioner. EM giver i øjeblikket adgang til 80 funktioner og kan nemt udvides til at understøtte flere. Det giver dig også adgang til dine variabler ved at bruge menneskelæselige variabelnavne (i stedet for SGQA-navne).

De følgende afsnit viser de vigtigste steder, hvor Expression Manager bruges

Relevans (styring af navigation/forgrening)

Nogle undersøgelser bruger "Goto Logic", sådan at hvis du besvarer spørgsmål 1 med mulighed C, så spring til spørgsmål 5. Denne tilgang er meget begrænsende, da den er svær at validere og let går i stykker, når du skal omarrangere spørgsmål. EM bruger en boolsk relevansligning til at specificere alle de betingelser, hvorunder et spørgsmål kan være gyldigt. Hvis spørgsmålet er relevant, så vises spørgsmålet, ellers er det Not Applicable, og værdien NULL gemmes i databasen. Dette svarer til, hvad der kan gøres via Conditions-editoren, men EM lader dig nemt angive meget mere komplekse og kraftfulde kriterier (og lader dig bruge variabelnavnet i stedet for SGQA-navngivning).

Dette billede viser en måde at gennemgå relevanslogikken for en undersøgelse. Den beregner Body Mass Index. Relevansligningen er vist i firkantet parentes lige efter variabelnavnet (som er i grønt). Så relevansen af vægt, vægt_enheder, højde og højde_enheder er alle 1, hvilket betyder, at disse spørgsmål altid stilles. Relevansen for BMI er dog {!er_tom(højde) og !er_tom(vægt)}, hvilket betyder, at BMI kun vil blive beregnet, hvis forsøgspersonen indtaster en værdi for både højde og vægt (derved undgås risikoen for en divider med nul fejl). Rapportspørgsmålet vises også kun, hvis emnet besvarer alle fire hovedspørgsmål (højde, højdeenheder, vægt, vægtenheder).

Relevans vises og kan redigeres følgende steder:

Visning/redigering af relevans på spørgsmålsniveau

Denne ligning beregner Body Mass Index (BMI). Der spørges kun om personen først indtaster sin højde og vægt.

Dette er redigeringsskærmen for BMI-spørgsmålet.

Bemærk, at du ikke bruger de krøllede klammeparenteser, når du indtaster en relevansligning.

Visning/redigering af relevans på gruppeniveau

Dette er en stikprøveundersøgelse. Den første side spørger, hvor mange mennesker der bor hos dig og gemmer det i "cohabs"-variablen. Denne side vises kun, hvis du har mere end én samlever (så den vises for den anden person, der bor sammen med dig), og viser også kun, hvis du har angivet, hvordan Person One er relateret til dig (p1_rel).

Som du kan se, har gruppen også relevanskriterier på spørgsmålsniveau, således at hvert spørgsmål først vises, når du har besvaret spørgsmålet før det (f.eks. {!er_tom(p1_sex)}). EM kombinerer relevansen på gruppe- og spørgsmålsniveau for dig. Spørgsmål i en gruppe stilles kun, hvis gruppen som helhed er relevant. Derefter stilles kun den delmængde af spørgsmål inden for gruppen, der er relevante.

Her er skærmbilledet til redigering af relevansen på gruppeniveau for det spørgsmål:

Bemærk, at du ikke bruger de krøllede klammeparenteser, når du indtaster en relevansligning.

Skræddersy/rørføring

EM lader dig nemt lave en enkel og kompleks betinget skræddersyning af dine spørgsmål. Nogle gange har du bare brug for simpel erstatning, som at sige, "Du sagde, du købte [ Produkt]. Hvad kunne du bedst lide ved det?". Nogle gange har du brug for betinget substitution som " [ Hr og Fru.] [ Efternavn], vil du være villig til at udfylde vores undersøgelse?". I dette tilfælde vil du bruge hr. eller fru baseret på personens køn. Andre gange har du brug for endnu mere kompleks substitution (såsom baseret på en matematisk beregning) EM understøtter hver af disse typer skræddersy/rør.

Betingede ligninger

Body Mass Index-eksemplet viser evnen til at beregne en persons BMI, selv mens de lader dem indtaste deres højde og vægt i metriske eller ikke-metriske enheder.

Her er vægt_kg {if(vægt_enheder == 'kg', vægt, vægt * .453592)}. Denne if()-funktion betyder, at hvis emnet indtastede vægten ved hjælp af kilogram, skal du bruge denne værdi, ellers gange den indtastede værdi (som var i pund) med 0,453592 for at konvertere den til kilogram. Variablen height_m bruger en lignende tilgang til at beregne personens højde i meter, selvom han indtastede sin højde i tommer.

BMI beregner vægtformlen som {vægt_kg / (højde_m * højde_m)}.

Endelig skræddersyr rapporten betinget budskabet til emnet og fortæller ham, hvad han indtastede. ("Du sagde, du er 2 meter høj og vejer 70 kg.")

Selvom det ikke er godt vist i ovenstående billede, bruger weight_status indlejrede if()-udsagn til at kategorisere personen som undervægtig til svært overvægtig. Du kan se dens ligning i Vis logikvisning

Fra redigeringsvinduet for dette spørgsmål kan du se to ting:

1. Tiloring skal omgive udtryk med Curly Braces
2. Expressions kan spænde over flere linjer, hvis du som i dette tilfælde vil gøre det nemmere at læse indlejret betinget logik.

Skræddersyede spørgsmål, svar og rapporter

Bemærk: Dynamisk skræddersyning virker muligvis ikke, hvis svarmulighederne er tilgængelige i udvalgte felter på samme spørgsmålsside. Dette skyldes, at skræddersyede skær a tag, som ikke er gyldigt i udvalgte muligheder.

Dette eksempel viser BMI-rapporten.

Her er redigeringsvinduet for det samme spørgsmål.

Som du kan se, behandles alt i krøllede seler som et udtryk, så syntaks-fremhævet (farvekodet) i det foregående billede. Hvis du havde stavefejl (såsom fejlstavede eller udefinerede variabelnavne eller funktioner), ville EM vise en fejl, såsom denne, der viser, at height_unit er et udefineret variabelnavn (det er faktisk højde_enheder), og rnd() er en udefineret funktion (det rigtige funktionsnavn er round()). I begge tilfælde er fejlene omgivet af en rød boks for at gøre det nemmere at opdage og rette dem.

Du kan også se, at du hurtigt kan lave komplekse rapporter, såsom en tabel med indtastede værdier eller skræddersyet rådgivning.

Husk, at al skræddersyning skal omgive udtryk med Curly Braces, så LimeSurvey ved, hvilke dele af spørgsmålet der er fri tekst, og hvilke der skal analyseres gennem Expression Manager.

Validation

EM styrer, hvordan de fleste af de avancerede spørgsmålsmuligheder fungerer. Disse kontrollerer aspekter som min/max antal svar; min/max individuelle værdier; min/max sumværdier; og kontrollere, at indtastede værdier matcher specificerede strengmønstre. Du fortsætter med at indtaste disse avancerede spørgsmålsmuligheder som normalt. Men nu betragtes enhver værdi i et af disse felter som et udtryk, så du kan have min/max-kriterier med komplekse betingede relationer til andre spørgsmål.

I alle disse tilfælde, da den avancerede spørgsmålsmulighed altid betragtes som et udtryk, bruger du ikke krøllede klammer, når du angiver det.

Sample Surveys sider viser mange fungerende eksempler på brug af udtryk til valideringer.

Introduktion

LimeSurvey bruger det nye Expression Manager (EM) modul, som vil lade LimeSurvey understøtte mere kompleks forgrening, vurderinger, validering og skræddersyning. Det vil erstatte, hvordan LimeSurvey administrerer erstatninger, betingelser og vurderinger på back-end. Det vil også fremskynde behandlingen betydeligt, da det eliminerer de fleste runtime-databaselæsninger. EM blev udviklet af Dr. Thomas White (TMSWhite).

Denne wiki-side er den definitive reference til Expression Manager-syntaks og funktionalitet.

Nøgledefinitioner

1. Udtryk: Alt omgivet af krøllede seler
   • Så længe der ikke er et hvidt mellemrum umiddelbart efter åbningsbøjlen eller før den afsluttende krøllede bøjle

#*Indholdet af udtryk evalueres af EM, så de kan indeholde matematiske formler, funktioner og kompleks streng- og datobehandling.

1. Tailoring: Nogle gange kaldet "piping", dette er processen med betinget modificerende tekst
   • Du har adgang til alle 'erstatningsfelter', deltagerdata og svardata.
   • Du har også lettere adgang til spørgsmål, svar og deres egenskaber.
2. 'Relevans' Ligning: En ny spørgsmålsattribut, der styrer spørgsmålets synlighed
   • Hvis der er en relevansligning, vises spørgsmålet kun, hvis relevansen evalueres til sand.
   • Internt, alle array_filter og array_filter_exclude kommandoer bliver relevans på underspørgsmålsniveau
3. Ligning Spørgsmålstype: En ny spørgsmålstype, der gemmer beregninger eller rapporter til databasen
   • Det er ligesom et Boilerplate-spørgsmål, men dets indhold gemmes til databasen, selvom du indstiller "Always Hide this Question"
4. Spørgsmålskode: Dette er det foretrukne variabelnavn for EM
   • Dette kan være et beskrivende navn, der angiver formålet med spørgsmålet , hvilket gør det lettere at læse kompleks logik
   • Gyldige spørgsmålskoder bør IKKE starte med et tal, så når du bruger spørgsmålskoden til at nummerere dine spørgsmål, skal du blot bruge "q1", eller "q1a" eller "g1q2".! N!#*Dette er det, der i øjeblikket bliver variabelnavnet, hvis du eksporterer data til SPSS eller R, så hvis du laver statistisk analyse, har du sikkert allerede gjort dette unikt.

Skal jeg bruge EM?

Det korte svar er nej (men også ja).

EM er fuldstændig bagudkompatibel med eksisterende undersøgelser. Så hvis du er glad for at bruge betingelser og vurderinger i den stil, som LimeSurvey brugte i versioner <= 1.91+, kan du fortsætte med at gøre det.

EM erstatter dog fuldstændig hvordan LimeSurvey internt håndterer Betingelser. Selvom du stadig kan bruge Conditions Editor til at oprette og administrere betingelser, vil LimeSurvey 1.92 konvertere dem til de tilsvarende relevansligninger. Som en del af opgraderingen vil LimeSurvey 1.92 automatisk konvertere alle eksisterende betingelser til relevansligninger.

Dette burde give dig det bedste fra begge verdener - du kan fortsætte med at bruge LimeSurvey, som du er vant til, men vil se den tilsvarende relevansligning, så du gradvist kan migrere direkte til relevansligninger, når det passer dig.

Kan jeg blande brug af betingelser og relevans?

Ja. Du kan bruge Betingelseseditoren til nogle spørgsmål og Relevanseditoren til andre. Betingelser konverteres automatisk til relevans, når du gemmer spørgsmålet.

Bemærk, vi antager, at hvis du bruger Betingelseseditoren, at du ønsker, at disse Betingelser skal overskrive enhver manuelt indtastet relevansligning. Så hvis du har eksisterende betingelser og ønsker at redigere relevansen manuelt, skal du først slette betingelserne for det spørgsmål. Kopier specifikt den genererede relevansligning til en teksteditor, brug menuen Betingelser til at slette alle betingelserne for det pågældende spørgsmål (hvilket også vil slette relevansen), rediger derefter spørgsmålet og indsæt den genererede relevansligning fra teksteditoren tilbage i relevansfeltet for det spørgsmål (og gem spørgsmålet). Hvis der er tilstrækkelig efterspørgsel efter at slette betingelser uden at slette den genererede relevansligning, kunne vi tilføje en massekonverteringsproces.

Hvordan skal jeg vælge mellem betingelser og relevans?

Her er en liste over fordele og ulemper ved hver stil:

Style	Fordele	Udele
Betingelser	1. God GUI til at skabe enkle forhold 2. GUI veldokumenteret og forstået af supportteam	1. Understøtter kun simple sammenligninger og AND/ELLER betingelser godt 2. Kaskadeforhold fungerer uregelmæssigt 3. Langsom - databaseintensiv, kan derfor bremse lange undersøgelser 4. Nogle rapporterede problemer med genindlæsningsforhold 5. GUI skalerer ikke godt, når der er snesevis, hundredvis eller tusindvis af spørgsmål 6. Kan være langsom til at konvertere papirbaserede undersøgelser, da de skal bruge SGQA-navne 7. Har ofte brug for en programmør til at specialkode logik, der er nødvendig for kompleks forgrening
Relevans	1. Understøtter meget kompleks logik, inklusive 80+ funktioner og matematik/streng-operatorer 2. Perfekt støtte til cascading logik 3. Hurtigt - ingen ekstra databasekald, så understøtter 1000+ spørgsmålsundersøgelser 4. Ingen problemer med at genindlæse logik, da det ikke kræver SGQA-koder 5. Syntaks-fremhævning skalerer til 1000+ spørgsmålsundersøgelser 6. Nem og hurtig at bruge for grupper, der ønsker at computerisere eksisterende papirbaserede suveys. 7. Understøtter let semi-strukturerede interviews og epidemiologiske undersøgelser uden behov for en programmør	1. Ingen GUI til simple forhold - brug syntax-fremhævning i stedet 2. Nyt, så supportteams har ikke mestret EM endnu.

Bunden er, at hvis du er tilfreds med, hvordan LimeSurvey 1.91+ fungerer, er der ingen grund til at ændre, hvad du gør.

Hvad er nogle andre fordele ved at bruge EM?

Her er nogle af de andre grunde til, at du måske vil bruge EM.

1. Beregninger - du kan oprette enhver beregning, du kan komme på:
   • Du har adgang til alle almindelige matematiske operatorer og funktioner
   • Du har adgang til mere end 70 matematiske funktioner samt funktioner til dato- og strengbehandling
   • Det er forholdsvis nemt for udviklere at tilføje nye funktioner, hvis brugerne har brug for dem
2. Lagring af beregninger i databasen
   • Du kan nu udføre enkle og komplekse beregninger og/eller skalascorer OG få dem gemt i databasen uden at bruge JavaScript.
   • Det gør du ved hjælp af spørgsmålstypen Ligning.
3. Evalueringer
   • Du kan nu oprette evalueringer eller skalascorer ud fra alle spørgsmålstyper, ikke kun den delmængde, der tidligere blev understøttet
   • Du kan bruge skræddersyning til at vise løbende eller samlede evalueringsscorer, hvor som helst der er brug for det - også på samme side
   • Du har mere kontrol over de rapporter, der genereres på baggrund af disse evalueringsscorer
   • Du kan gemme evalueringsscorer i databasen uden at bruge JavaScript
   • Du kan skjule evalueringsscorer uden at bruge JavaScript eller CSS
4. Erstatningsfelter
   • Brug spørgsmålskoden til at indsætte værdier fra svar på tidligere spørgsmål - det gør det nemmere at læse og validere.
5. Skræddersyning - du kan vise tekst betinget af andre værdier
   • Brug den passende titel for et emne, f.eks. ("Hej [hr./fru] Hansen")
   • Generer grammatisk korrekte sætninger, når ental/flertal har betydning: (f.eks. "Du har 1 barn" i forhold til "Du har 2 børn")
   • Bøj verber og navneord korrekt ud fra emnets køn og antal.
6. Nye variabelattributter - du kan få adgang til følgende, når du skræddersyr:
   • (intet suffiks) - et alias for qcode.code
   • .code - den valgte svarkode for spørgsmålet, hvis det er relevant (ellers tom), eller tekstværdien, hvis det ikke er et kodet spørgsmål
   • .NAOK - samme som .code, men kan indgå i beregninger eller lister, selv om det er irrelevant
   • .value - evalueringsværdien for spørgsmålet, hvis det er relevant (ellers tom), eller tekstværdien, hvis det ikke er et kodet spørgsmål -- tilgængelig, hvis evalueringer er aktiveret for undersøgelsen, ellers altid nul
   • .valueNAOK - samme som .value, men kan indgå i beregninger eller lister, selv om det er irrelevant
   • .shown - svaret, som det vises for brugeren
   • .qid - spørgsmåls-ID'et
   • .gid - gruppe-ID'et
   • .sgqa - SGQA-værdien for spørgsmålet
   • .jsName - det korrekte JavaScript-variabelnavn for spørgsmålet, uanset om det er defineret på denne side eller en anden
   • .qseq - spørgsmålets rækkefølge (startende fra 0)
   • .gseq - gruppens rækkefølge (startende fra 0)
   • .mandatory - om spørgsmålet er obligatorisk (Y/N)
   • .question - spørgsmålets tekst
   • .relevance - relevansligningen for spørgsmålet
   • .grelevance - relevansligningen for gruppen
   • .relevanceStatus - om spørgsmålet aktuelt er relevant eller ej (boolesk (kan være forskellig i PHP og JS))
   • .type - spørgsmålstypen (koden på ét tegn)
7. Dynamiske ændringer på siden
   • Al relevans, beregning og skræddersyning fungerer dynamisk på en side - så ændringer i værdier opdaterer straks siden
   • Spørgsmål kan således dukke dynamisk op eller forsvinde, afhængigt af om de er relevante
   • Spørgsmål skræddersys også dynamisk ud fra besvarelserne på siden, så du kan se løbende totaler, skræddersyede sætninger og tilpassede rapporter.
8. Ny skærm til dataindtastning
   • Ud over at bruge det nuværende dataindtastningssystem kan du bare bruge Survey-All-In-One.
   • Det understøtter relevans og skræddersyning på siden, så dataindtastere hurtigt kan tabulere sig igennem og kun skal indtaste de relevante besvarelser
   • Det kan være afgørende, hvis din dataindtaster har brug for at se skræddersyningen, som også er dynamisk.
9. Fjerner behovet for det meste tilpasset JavaScript
   • EM understøtter nemt komplicerede beregninger, scoring, skræddersyning og betinget logik.
   • Nogle ting kræver stadig JavaScript (f.eks. brugerdefinerede layouts og betinget skjulning af underelementer i spørgsmål), men dit JavaScript kan bruge EM-funktionerne, så du kan få adgang til spørgsmål via deres Qcode i stedet for SGQA og få adgang til alle de spørgsmålsegenskaber, der er nævnt ovenfor.

Hvad er nogle andre nyttige nye funktioner aktiveret af EM?

Uanset om du fortsætter med at bruge Conditions Editor eller manuelt komponerer relevansligninger, får du disse yderligere fordele:

1. Du kan oprette mere komplekse valideringskriterier
   • Alle de avancerede spørgsmålsattributter (såsom max_answers, min_num_value_n, max_num_value) kan bruge udtryk. Så dine min/max-kriterier kan nemt justeres baseret på tidligere svar, selvom de er på samme side.
   • EM håndterer også al regulært udtryksbaseret validering, så du robust kan kombinere præg og ligning- baseret spørgsmålsegenskaber.
2. Easy Genbestilling (eller sletning) af spørgsmål og grupper
   • Før version 1.92 kunne du ikke omarrangere spørgsmål eller grupper, hvis LimeSurvey mente, at en sådan ombestilling kunne gå i stykker forhold, hvorunder de blev brugt. På samme måde kunne du ikke slette spørgsmål, hvis andre spørgsmål afhang af dem.
   • Med EM's syntaksfremhævning er det nemt at se og validere, om du forsøger at bruge spørgsmål, før de er deklareret. Så vi lader dig nu genbestille eller slette spørgsmål og grupper, når du vil. EM vil opdatere al syntaksfremhævning for at vise dig potentielle fejl.
   • Visningen om genbestillingsspørgsmål er blevet forbedret for at hjælpe med en sådan gennemgang. Den viser nu spørgsmålets relevansligning og tilpasning, så du med det samme kan se, om nogen variable bliver lyserøde (hvilket betyder, at de bliver brugt, før de erklæres).
3. Spørgsmåls-/Gruppenavigationsindekset er altid tilgængeligt og nøjagtigt
   • Før version 1.92 var disse indekser ikke tilgængelige, hvis der var komplekse forhold
   • Med EM kan vi garantere, at de er nøjagtige.
   • Fagerne kan endda hoppe tilbage til et tidligere spørgsmål, ændre svaret , spring derefter frem (eller indsend)
     • Når du hopper fremad, vil EM genvalidere alle de mellemliggende spørgsmål/grupper.
     • Hvis nogen spørgsmål bliver irrelevante, bliver de NULLED i databasen så dine data er internt konsistente
     • Hvis nogen spørgsmål bliver relevante eller nyligt mislykkedes obligatoriske eller valideringsregler, vil EM stoppe på den side og tvinge brugeren til at besvare disse spørgsmål, før han hopper til deres endelige destination.
4. Automatisk konvertering af betingelser til relevans
   • Når du opgraderer din database, vil alle eksisterende undersøgelser, der har betingelser, have relevansligninger genereret for dem
   • Når du importerer en undersøgelse, oprettes relevansligninger efter behov
   • Når du tilføjer, sletter eller ændrer betingelser, vil EM generere den passende relevansligning.
5. Convenient Syntax Highlighting
   • Når EM viser relevansligningen, vil den vise Qcode, selvom du indtastede en SGQA-kode, da vi antager, at denne vil være nemmere at læse.
   • Alle variabler er farvekodede for at vise, om de blev erklæret før eller efter det aktuelle spørgsmål (eller før eller efter den aktuelle gruppe). Dette giver dig mulighed for hurtigt at opdage og rette tilfælde, hvor du forsøger at bruge variabler til relevans (inklusive array_filter), skræddersy eller valideringsligninger, før du erklærer dem.
   • Hvis du desuden holder musen over den farvekodede variabel , vil du se de vigtigste metadata om det spørgsmål. Dette inkluderer grupperækkefølgenr., spørgsmålsrækkefølgenr., Qcode, teksten til spørgsmålet og alle tilgængelige svarvalg (hvis det er en spørgsmålstype med optalte svarvalg).
     • Listen over svarvalg bruger denne syntaks : 'svar':{nøgle:val, ... }.
     • nøgle har syntaksen 'skala~kode' hvor skala er svarskalaen (f.eks. for dobbelt skala), og kode er svarkoden.
     • val har syntaksen 'værdi~vist', hvor værdi er vurderingsværdien (hvis du bruger vurderinger, ellers kode)(f.eks. Qcode.value), og vist er visningsværdien som set af emnet (f.eks. Qcode.shown)
     • This betyder, at mange undersøgelser kan bruge beregninger uden behov for vurderingstilstand. Hvis du har opregnet svarmuligheder, der er unikke, ikke-decimale og ikke-negative, kan du blot lave beregninger på Qcode.code-værdierne.
6. Nem gennemgang af hele undersøgelsens logik og indhold
   • Der er en ny Vis undersøgelseslogik-funktion, der lader dig se alt om undersøgelsen (eller gruppen eller spørgsmålet) på en enkelt side.
   • Det viser gruppe-, spørgsmåls-, underspørgsmåls- og svarniveaudetaljerne for det valgte omfang (undersøgelse vs. gruppe vs. spørgsmål)
   • Det viser også relevansen, relevansen på underspørgsmålsniveau (for array_filter og array_filter_exclude) og den genererede valideringsligning (for preg og eventuelle valideringsregler som min/max sum/antal af værdier), og alle ikke-blanke spørgsmålsattributter.
   • Alt er syntaks-fremhævet, så du kan se potentielle syntaksfejl (såsom ubalancerede parenteser eller brug af variabler, før de blev erklæret)
   • Syntaks- highligting understøtter hurtig navigation og redigering af undersøgelsen.
     • Hvis du klikker på et variabelnavn, åbner det et browservindue (eller fane), der viser dig det spørgsmål og lader dig redigere det.
     • Hvis du klikker på et gruppenavn, åbner det et browservindue (eller fane), der viser gruppe-genbestillingsvisningen, så du nemt kan flytte rundt på spørgsmål.
     • Alle spørgsmålsattributter er også syntaks fremhævede. Dette giver dig mulighed for at indstille og se udtryk inden for avancerede spørgsmålsmuligheder (som at basere maks./min. antal/sum af værdier på et udtryk)
   • EM-forfatteren brugte lignende visning (lidt renere) til at lade sine samarbejdende epidemiologer og institutionelle Review Board validerer og godkender undersøgelser med tusindvis af spørgsmål i meget forgrenede og skræddersyede strukturerede interviews

Kom godt i gang

Den bedste måde at komme i gang med EM på er at:

• Installere den seneste stabile version fra http://www.limesurvey.org/en/download
• Importere og udforske eksempelundersøgelserne.
• Udforsk use cases and HowTos og trin-for-trin eksempler.
• Udforsk EM-dokumentationen (denne side)! N!*Undersøg den indbyggede EM-testpakke
  • Vælg valgmuligheden EM under værktøjer fra enhver undersøgelse
  • Tilgængelige funktioner viser de 70+ funktioner og syntaks
  • Enhedstest af isolerede Expressions
    • viser eksempler på brug af alle EM-funktioner og -operatorer, og PHP- og JavaScript-resultaterne
    • bemærk, at der er få funktioner, der genererer forskellige resultater i PHP- og JavaScript-versionerne, så denne side giver dig mulighed for planlæg din EM-logik i overensstemmelse hermed.

Hvilken funktionalitet udvider/erstater Expression Manager? (LimeSurvey <= 1,91+)

Betingelser => Relevans

Forhold styrede, hvilke spørgsmål der er synlige. Den generelle syntaks var SGQA-operatorværdi, som 111X2X3 == "Y". Betingelser kunne være AND eller OR sammen, men det var svært at blande AND og OR. Selve betingelserne blev gemt i en separat tabel, og en stor del af LimeSurveys kode var afsat til at administrere betingelser. På grund af omfattende databaseadgang kan behandling af et stort antal forhold forårsage mærkbare ydeevneproblemer. Desuden, når du først havde fået tildelt betingelser til spørgsmål eller grupper, fik du ofte ikke lov til at omarrangere eller slette dem.

Vurderinger => Ligninger og mikroskræddersyet

Vurderinger lader brugere oprette skalaresultater ud fra en samling spørgsmål. De kunne dog ikke ændre sig dynamisk på den aktuelle side, og deres værdier blev ikke gemt i databasen.

Udskiftninger => Mikroskræddersyet

Brugere kunne skræddersy nogle beskeder og spørgsmål ud fra tidligere besvarelser. Et spørgsmål kunne f.eks. være {TOKEN:FIRSTNAME}, du sagde, at {SPORT.shown} var din yndlingssport. Det var dog ikke muligt at lave betinget skræddersyning (f.eks. at sige "hr." eller "fru" afhængigt af personens køn) eller at bøje verber og navneord uden avanceret JavaScript. Forfattere kunne lave undersøgelser, der så ud til at skræddersy spørgsmål, men det krævede separate spørgsmål for hver kombination og komplekse betingelser for at afgøre, hvilke spørgsmål der skulle vises.

Validation

Spørgsmål kunne valideres med regulære udtryk eller minimums-/maksimumsværdier, eller ved at lade en besvarelse fungere som minimums- eller maksimumsværdi. Valideringer kunne dog ikke baseres på beregninger af andre variabler uden avanceret JavaScript.

Ligninger

Ligninger blev ikke understøttet uden fancy JavaScript.

Ligningsspørgsmålstype

Ligninger kunne ikke gemmes i databasen (f.eks. den endelige score for en vurdering) uden fancy JavaScript.

Hvordan erstatter/udvider Expression Manager denne funktionalitet?

Expression Manager er et nyt kernemodul i LimeSurvey, der gør det meget nemmere at understøtte den type kompleks funktionalitet, der før krævede tilpasset JavaScript. Det erstatter også den måde, LimeSurvey i øjeblikket administrerer betingelser og vurderinger på.

Ny terminologi ved henvisning til Expression Manager (EM)

EM "tænker" på sin funktionalitet på følgende måde:

• Relevance-based Branching - hvis et spørgsmål er relevant, så stil det, ellers lad være (f.eks. gør det usynligt, og marker det som NULL i databasen). Der er et nyt relevansfelt for alle spørgsmålstyper og også for hver gruppe (så du kan anvende et sæt betingelser på en hel gruppe uden at skulle kopiere den samme betingelse til hvert spørgsmål og/eller kombinere gruppe- og spørgsmålsniveau betinget logik).
• Tailoring - Når du ved, hvilke spørgsmål der skal stilles, specificerer tailoring (nogle gange kaldet piping), hvordan spørgsmålet skal stilles. Dette giver dig mulighed for at understøtte ikke kun simpel substitution (som {TOKEN:FIRSTNAME}), men også bøjning af verber og deklination af substantiver baseret på køn eller antal af dine emner. Det giver dig også mulighed for at ændre den besked, du leverer til et emne baseret på, om de besvarede (eller hvordan de besvarede) andre spørgsmål.
• Ligninger - EM tilføjer en ny spørgsmålstype kaldet Equation, som gemmer resultatet af et Udtryk. Disse ligningsresultater beregnes og skrives til databasen, selvom du skjuler dem på siden. De er således nyttige til skjulte scoringsberegninger, navigation baseret på komplekse ligninger, vurderinger og rapporter, der bør genereres og let tilgængelige i databasen.

Relevans og kaskaderelevans

Hver spørgsmålstype har nu en mulighed for Relevans, som styrer, om spørgsmålet vises. EM behandler hver af relevansligningerne i den rækkefølge, de skal vises i undersøgelsen. Hvis udtrykket er sandt (eller mangler - for at understøtte ældre undersøgelser), vil spørgsmålet blive vist. Hvis det ikke er relevant, så vil spørgsmålet blive skjult, og værdien NULLed i databasen. Hvis der ikke er relevante spørgsmål i en gruppe, vil hele gruppen blive sprunget over.

Desuden, hvis nogen af variablerne i et udtryk er irrelevante, evalueres udtrykket altid til falsk. Dette muliggør Cascading Relevance, så du ikke behøver at skrive meget lange Relevans-ligninger for hvert spørgsmål.

Lad os sige, at du har 5 spørgsmål Q1-Q5, og du kun ønsker at vise Q2, hvis Q1 blev besvaret, og Q3, hvis Q2 blev besvaret, osv. Relevansligningerne kan være:

Spørgsmålskode	Relevans	Spørgsmål
Q1	1	Hvad er dit navn?
Q2	Q1	{Q1}, hvor gammel er du?
Q3	Q2	Så du er {Q2} år gammel. Er du gift?
Q4	Q3 == "Y"	{Q1}, hvor længe har du været gift?
Q5	Q4	Hvor mange børn har du, {Q1}?

Relevansberegningerne fungerer også i JavaScript - så du kunne lægge alle ovenstående spørgsmål på én side, og det ville stadig fungere som forventet. Faktisk erstatter EM fuldstændig, hvordan EM behandler undersøgelsesformater vs. gruppe vs. Spørgsmål ad gangen. De bruger nu alle den nøjagtig samme navigationsmotor, så de fungerer identisk uanset undersøgelsesstil.

Så længe du er på samme side, vil alle data, du indtastede, stadig være der, bare skjult. Så hvis du indtaster nogle oplysninger, så vælg en mulighed, der gør dem irrelevante, og gør dem relevante igen, dine svar vil stadig være tilgængelige. Men så snart du flytter til en anden side, vil alle irrelevante svar gå tabt på grund af datasættets integritet.

Relevans på gruppeniveau

Expression Manager understøtter også relevans på gruppeniveau. Dette gør det nemmere at implementere looping. Lad os sige, at du vil indsamle oplysninger om op til 10 enheder (såsom produkter eller personer i en husstand), hvor du først bestemmer, hvor mange enheder der skal følges op (såsom ved at spørge, hvor mange mennesker der bor i en husstand, eller få folk til at tjekke hvilke produkter de kan lide fra en lang liste). Efter at have vidst, hvor mange enheder der har brug for opfølgning, kan du bruge relevans på gruppeniveau som {count >= 1}, {count >=2}, ... {count >= 10} for hver af de 10 grupper af opfølgnings- stille spørgsmål. Inden for hver gruppe kan du have betinget logik på spørgsmålsniveau (f.eks. køn eller aldersspecifikke opfølgningsspørgsmål til hvert emne). Spørgsmålet og relevansligningerne på gruppeniveau er OG-sammensat for at bestemme, hvilke der skal vises.

Skræddersy / rørføring

Alt inden for krøllede seler behandles nu som et udtryk (med én undtagelse beskrevet nedenfor). Udtryk har adgang til alle LimeReplacementFields, alle variablerne (via flere aliaser), alle typiske ligningsoperatorer (matematisk, logisk og sammenligning) og snesevis af funktioner (der endda fungerer dynamisk på klientsiden).

Ved at bruge disse ligninger kan du gøre ting som:

1. Vis betinget skræddersyede beskeder til respondenterne baseret på tidligere svar
2. Opret vurderinger og vis vurderingsresultater (eller betinget forgrening eller vis beskeder) baseret på disse resultater, alt uden at bruge selve vurderingsmodulet
3. Konjuger verber og afvis navneord i spørgsmål, svar og rapporter.
4. Vis sammendrag af svar før siden "Vis dine svar" i slutningen af undersøgelsen

Ligninger

Der er en ny spørgsmålstype kaldet ligning. Det er som et Boilerplate-spørgsmål, bortset fra at det gemmer værdien af det, der vises i databasen. Så hvis ligningsspørgsmålsteksten indeholder en vurderingsberegning, vil denne værdi blive gemt i databasen i en variabel, der kan vises i offentlige eller private statistikker.

Dette løser en fælles anmodning om lagring af vurderingsresultater i databasen

Syntaks

Alt, der er indeholdt i krøllede klammeparenteser, betragtes nu som et udtryk (med én undtagelse: der må ikke være nogen indledende eller afsluttende mellemrum - dette er nødvendigt for at sikre, at Expression Manager ikke forsøger at behandle indlejret JavaScript).

Bemærk, det er OK, at udtryk spænder over flere linjer, så længe der ikke er mellemrum efter den indledende krøllede klammeparentes eller før den afsluttende krøllede klammeparentes. Dette er især nyttigt for indlejrede if()-sætninger som dette:

{if(er_empty(PFTotals),
 '',
 if(PFTotals >= -5 && PFTtotals <= -4,
 'Meget blød',
 if(PFTotals >= -3 && PFTotals <= -2,
 'Blød',
 if(PFTotals == -1,
 'Somewhat Soft',
 if(PFTotals == 0,
 'Moderate',
 if(PFTotals == 1,
 'Somewhat Hard',
 if(PFTotals >= 2 && PFTtotals <= 3,
 'Hard',
 if(PFTotals >= 4 && PFTtotals <= 5,
 'Meget hårdt',
 ''
 )
 )
 )
 )
 )
 )
 )
)}

Expression Manager understøtter følgende syntaks:

• Alle matematiske standardoperatorer (f.eks. +,-,*,/,!)
• Alle standard sammenligningsoperatorer (f.eks. <,<=,==,!=,>,>= plus disse ækvivalenter: lt,le,eq,ne,gt,ge)
• Parentes (så du kan gruppere underudtryk)
• Betingede operatorer (f.eks. &&,| | og disse ækvivalenter: og,eller)
• Enkelte og dobbelte citerede strenge (som hver kan indlejre strenge med den anden citattype)
• Kommaoperator (så kan have en liste over udtryk og bare returnere det endelige resultat)
• Tildelingsoperator (=)
• Foruddefinerede variabler (for at henvise til spørgsmål, spørgsmålsegenskaber og svar) - f.eks. alle SGQA-koderne
• Foruddefinerede funktioner (der er allerede 70+, og det er nemt at tilføje flere)

Operatører

EM-syntaks følger normal operatorprioritet:

Level	Operator(er)	Beskrivelse
1	()	parenteser til gruppering eller opkald af funktioner
2	! - +	unære operatorer: ikke, negation, unær-plus
3	* /	gange, divider
4	+ -	plus , minus
5	< <= > >= lt le gt ge	relative sammenligninger
6	== != eq ne	lighedssammenligninger
7	og	logisk OG
8	eller	logisk ELLER
9	=	tildeling operator
10	,	komma operator

Advarsel med plusoperator (+)

For at skabe sammenhæng mellem JavaScript og PHP tilføjer plusoperatoren (+), hvis begge operander er numeriske, men sammenkæder, hvis begge dele er ikke-numeriske strenge. Men vi anbefaler at bruge join()-funktionen til sammenkædning og sum()-funktionen til addition, da det gør din hensigt mere tydelig og undgår uventede resultater, hvis du forventede strenge, men fik tal i stedet for (eller vice omvendt).

Advarsel med uoverensstemmelse mellem tal og streng og alfabetisk sammenligning

Når du vil sammenligne værdi med relative eller lighedssammenligninger, skal du være opmærksom på typemismatch. Værdi indtastet af bruger eller valgt svarkode kan bruges som tal, hvis det tydeligt er et tal. Hvis du omgiver en af værdierne med " , vil det tvinge sammenligningen som tekst (alfabetisk sammenligning). Hvis du vil sammenligne numerisk, omgiv aldrig tallet med anførselstegn, " .

For eksempel er Q0.NAOK > "50" sandt, hvis Q0.NAOK er et numerisk spørgsmål med 9 som værdi. Dette skyldes, at operatoren > vil antage, at det er alfabetisk sammenligning og ikke numerisk.

For at være sikker på at sammenligne heltalsværdier, kan du bruge intval(Q0.NAOK) > 50 , husk blot hvis Q0.NAOK ikke er et tal (tom eller en streng), så intval(Q0. NAOK) === 0. For at sammenligne strengværdi ("A" < "B") brug strcmp direkte : strcmp(Q0.NAOK,"B") eller strcmp(Q0.NAOK,"A5") .

Forsigtig ved brug af Assignment Operator (=)

Bemærk, du bør undgå at bruge tildelingsoperatørerne, medmindre det er absolut nødvendigt, da de kan forårsage uventede bivirkninger. Hvis du f.eks. ændrer værdien af et tidligere svar, genberegnes den kaskaderelevans og valideringslogik mellem det spørgsmål og det aktuelle spørgsmål ikke, så du kan ende med internt inkonsistente data (f.eks. spørgsmål, der forbliver besvaret, men som burde have blevet NULLET, eller spørgsmål, der er sprunget over, men som burde være blevet besvaret). Generelt, hvis du vil tildele en værdi til en variabel, bør du oprette en ligningsspørgsmålstype og bruge et udtryk til at indstille dens værdi. Der er dog nogle sjældne tidspunkter, hvor folk virkelig har brug for denne operatør, så vi stillede den til rådighed.

For at advare dig om denne operator er den vist med rød skrift i syntaksligningerne (så du ikke forveksler den med "==")

Brug af Assignment Operator

De vigtigste grunde til, at du måske vil bruge opgaven er:

• Du skal indstille standardværdien for et spørgsmål, der ikke accepterer standardindstillinger via ligning (såsom listeradio, hvor brugergrænsefladen lader dig vælge en af svarmulighederne, men ikke lader dig indtaste en ligning). Vær dog forsigtig, da LimeSurvey ikke vil være i stand til at validere, at din ligning genererer et af de tilladte svar på det spørgsmål.
• Du skal med magt ændre svaret på et tidligere spørgsmål baseret på et senere svar
• Du har brug for kompleks kvote: brug et skjult enkelt valg til kvote og sæt det ved hjælp af tildeling
• osv...

Du kan bruge alle expression manager-systemer til dette formål.

  Tildeling udføres kun i PHP. Dette opdaterer ikke nogen værdier på samme side, men kun når brugeren navigerer med næste, forrige, gem ….

  Hvis du ikke bruger en equation question type til dette formål: opgaven udføres først efter logikken på den aktuelle side er færdig. Den anbefalede metode er altid at bruge et equation question.

Et eksempel:

• Indstil svar på et kort tekstspørgsmål med små bogstaver: {QCODE=strtolower(QCODE.NAOK)}
• Indstil et standardsvar til en matrixspørgsmålstype ved starten af en undersøgelse: {Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}
• Indstil et standardsvar til en array-tekstspørgsmålstype ved starten af en undersøgelse: {Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}
• Indstil et svar med betingelse: {QCODE=if(YesNo="Y","A1","")}

XSS sikkerhed

Med XSS aktiveret, kan nogle udtrykshåndteringssystemer ikke bruges:

• starter et HTML-tag i udtryk, men slutter med et andet udtryk
• brug et komplekst udtryk i URL.

Eksempel og løsning

• {if( 1 ,"","")}information{if( 1 ,"","")} er brudt med XSS-sikkerhed, her kan du bruge {if(1,"

<strong>information</strong>","information")}

• <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a> , here you can use an equation question because using a complete question code is OK : <a href="/script.php?value={EQUATION.NAOK}">next</a> information","information")} {if(1,"
• <a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a> , here you can use an equation question because using a complete question code is OK : <a href="/script.php?value={EQUATION.NAOK}">next</a>

Adgang til variabler

Expression Manager giver skrivebeskyttet adgang til de variabler, vi måtte have brug for. For bagudkompatibilitet giver den adgang til følgende:

• TOKEN:xxx - værdien af et TOKEN (f.eks. TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (Kun for IKKE anonym undersøgelse).
• INSERTANS:SGQA - visningsværdien af et svar (f.eks. "Ja"). For Expression Manager er det det samme som ved at bruge {QCODE.shown}.
• Alle {XXX}-værdier brugt af skabeloner.
• I spørgsmålsteksten kan du bruge {QID} erstattet af spørgsmåls-id og {SGQ} erstattet af spørgsmålets SGQA

Derudover lader Expression Manager dig henvise til variabler ved hjælp af spørgsmålskoden (kolonnen 'titel' i spørgsmålstabellen i databasen). Dette er også den variable etiket, der bruges, når du eksporterer dine data til SPSS, R eller SAS. Hvis du f.eks. har spørgsmål om navn, alder og køn, kan du kalde disse variabler navn, alder og køn i stedet for 12345X13X22, 12345X13X23' ', og 12345X13X24. Dette gør ligninger nemmere for alle at læse og validere logikken, plus gør det muligt at blande spørgsmål uden at skulle holde styr på gruppe- eller spørgsmålsnumre.

Vigtigt: Det er kun sikkert at henvise til variabler, der forekommer på foregående sider eller spørgsmål.

Ydermere giver Expression Manager dig adgang til mange egenskaber for spørgsmålet:

Syntaks	Betydning	Eksempel	Eksempelresultat
Qcode	et alias for Qcode.code	{implode(',',navn,køn )}	'Tom','M'
Qcode.code	den valgte svarkode for spørgsmålet, hvis den er relevant (ellers tom), eller tekstværdien, hvis den ikke er en kodet spørgsmål	{implode(',',name.code,gender.code)}	'Tom','M'
Qcode.NAOK	samme som Qcode - se diskussion af NAOK	{gender.NAOK}	'M'
Qcode.value	vurderingsværdien for spørgsmålet, hvis det er relevant (ellers tomt), eller tekstværdien, hvis det ikke er et kodet spørgsmål	{gender.value}	'1'
Qcode.valueNAOK	samme som Qcode.value - se diskussion om NAOK	{gender.valueNAOK}	'1 '
Qcode.shown	visningsværdien for spørgsmålet	{implode(',',name.shown,gender.shown)}	'Tom','Mand'
Qcode.question	teksten til spørgsmålet	{gender.question}	'Hvad er dit køn?'
Qcode.mandatory	om spørgsmålet er obligatorisk (J/N)	{gender.mandatory}	'N'
Qcode.qid	det interne spørgsmålsnummer (ikke løbenummeret)	{gender.qid}	337
Qcode.type	spørgsmålstypen	{gender.type}	'G'
Qcode.jsName	det korrekte javascript-navn for spørgsmålet, uanset om det er erklæret på eller uden for denne side	{gender.jsName}	'java1827X3X337'
Qcode.gid	det interne gruppenummer (ikke løbenummeret)	{gender.gid}	3
Qcode.qseq	spørgsmålets løbenummer, startende fra 0	{gender.qseq}	5
Qcode.gseq	gruppens fortløbende nummer, startende fra 0	{gender.gseq}	1
Qcode.relevanceStatus	om spørgsmålet i øjeblikket er relevant (0 eller 1)	{gender.relevanceStatus}	1
Qcode.relevance	relevansligningen på spørgsmålsniveau	{gender.relevance}	'!er_tom(navn)'
Qcode.grelevance	relevansligningen på gruppeniveau	{gender.grelevance}	'antal_børn >= 5'
Qcode.sgqa	SGQA-værdien for dette spørgsmål	{gender.sgqa}	'1827X3X337'

HTML-editor problem

  Dette problem er rettet efter 2.05 build 140803

Hvis du bruger HTML-editor, erstattes nogle tegn af HTML-enheder.

• & af &
• < af <
• > af >

Hvis du bruger HTML-editor, skal du bruge :

• og for &
• lt for <
• le for <=
• gt for >
• ge for >=

Qcode variabel navngivning

Her er detaljerne om, hvordan man konstruerer en Qcode (og får adgang til nogle egenskaber) efter spørgsmålstype. Generelt er Qcodes konstrueret som:

 QuestionCode . '_' . SubQuestionCode . '_' . ScaleId

Underspørgsmålskode og skala-ID skal bruges eller ej afhængigt af spørgsmålstypen - se tabellen nedenfor. For kommentar og andet er spørgsmålskoderne QuestionCode_comment og QuestionCode_other

Type	Beskrivelse	Kode	Underspørgsmål	Svarmuligheder	Skalaer	Svarkode	Svar vist	Relevans
5	5 Punktvalg radio-knapper	Q1		1-5		{Q1}	{Q1.shown}	{Q1==3}
B	Array (10 Point Choice) Radio-knapper	Q2	|1-10		{Q2_L2}	{Q2_L2.shown}	{Q2_L2==7}
A	Array (5 Point Choice) Radio-knapper	Q3	|1-5		{Q3_1}	{Q3_1.shown}	{Q3_1>=3}
1	Array (fleksible etiketter) Dobbelt skala	Q4	sq1-sq5	0 :a1-a3	1:b1-b3	{Q4_sq1_0}	{Q4_sq1_1.shown}	{Q4_sq1_1=='b2'}
H	Array (fleksibel) - Kolonneformat	Q5	1-5	s,m,t		{Q5_1}	{Q5_1.shown}	{Q5_1=='s'}
F	Array (fleksibel) - Rækkeformat	Q6	|1-5		{Q6_F3}	{Q6_F3.shown}	{Q6_F3==4}
E	Array (Forøg/Samme/Reducer) Radio-knapper	Q7	1- 7	I,S,D		{Q7_4}	{Q7_4.shown}	{Q7_4=='D'}
:	Array (Multi Flexi) 1 Til 10	Q8	ls1,todo ,ls2	min.,maks.,gennemsnit		{Q8_ls1_max}	{Q8_ls2_avg.shown}	{Q8_ls2_min==7}
;	Array (Multi Flexi) Tekst	Q9	hp,st,sw	1., 2., 3.		{Q9_hp_3rd}	{Q9_hp_3rd.shown}	{Q9_hp_3rd=='Peter'}
C	Array (Ja/Usikker/Nej) Radio-knapper	Q10	1-5	Y,N,U		{Q10_1}	{Q10_1.shown}	{Q10_3=='Y'}
X	Boilerplate-spørgsmål	Q11					{Q11.shown}
D	Dato	Q12				{Q12}	{Q12.shown}
*	Ligning	Q13				{Q13}	{Q13.shown}	{Q13>5}
~124~	Filupload (registrerer antallet af uploadede filer)	Q14				{Q14}		{Q14>0}
G	Køn Drop-Down List	Q15		M,F		{Q15}	{Q15.shown}	{Q15=='M'}
U	Kæmpe gratis tekst	Q16				{Q16}	{Q16.shown}	{strlen(Q16)>100}
I	Sprogspørgsmål	Q17				{Q17}	{Q17.shown}	{Q17=='da'}
!	Liste - Dropdown	Q18		1-5		{Q18}	{Q18.shown}	{Q18==3}
L	List drop-down/radioknapliste	Q19		AZ		{Q19}	{Q19.shown}	{Q19=='X'}
O	Liste med kommentar drop-down/radioknapliste + tekstområde	Q20		AF		{Q20},{Q20comment}	{Q20.shown}	{Q20=='B'}
T	Lang fritekst	Q21				{Q21}	{Q21.shown}	{strstr(Q21,'hello')>0}
M	Multiple Choice Checkbox	Q22	|		{Q22_E}, {Q22_other}	{Q22_E.shown}, {Q22_other.shown}	{Q22_E=='Y'}
P	Multiple Choice with Comments Checkbox + Tekst	Q23	AF			{Q23_D}, {Q23_Dcomment}	{Q23_D.shown}	{!is_empty(Q23)}
K	Multiple numerisk spørgsmål	Q24	selv,mor,far			{Q24_self}	{Q24_self.shown}	{Q24_self>30}
Q	Flere kort tekst	Q25	AF			{Q25_B}	{Q25_B.shown}	{substr(Q25_B,1,1)=='Q'}
N	Numerisk spørgsmålstype	Q26				{Q26}	{Q26.shown}	{Q26 > 30}
R	Rankingstil	Q27	1-4			{Q27_1}	{Q27_1.shown}	{Q27_1==3}
S	Kort fritekst	Q28				{Q28}	{Q28.shown}	{Q28=='min'}
Y	Ja/Nej radioknapper	Q29				{Q29}	{Q29.shown}	{Q29=='Y'}

De reserverede 'dette', 'selv' og 'det' variabler

Ganske ofte vil du vurdere alle dele af et spørgsmål, såsom at tælle hvor mange underspørgsmål der er blevet besvaret, eller summere scores. Andre gange vil du kun behandle bestemte rækker eller kolonner i et spørgsmål (såsom at hente række- eller kolonnesummerne og gemme dem i databasen). Disse reserverede variabler gør denne proces relativt smertefri.

'Denne'-variablen bruges udelukkende i de avancerede spørgsmålsmuligheder "Hele spørgsmålsvalideringsligning" og "Sub-spørgsmålsvalideringsligning". Det udvides til variabelnavnene på hver af cellerne i disse spørgsmål. Så hvis du vil sikre dig, at hver post er større end tre, skal du indstille "Underspørgsmålsvalideringsligningen" til (dette > 3).

Variablen 'selv' og 'den' er mere kraftfulde og tjener som makroer, der udvides før ligninger behandles. Syntaksvalgene er:

• self
• self.suffiks
• self.sub-selector
• self.sub-selector. suffiks

suffiks er et af de normale qcode-suffikser (f.eks. NAOK, værdi, vist)

undervælger er en af:

• kommentarer - kun underspørgsmål, der er kommentarer (f.eks. fra multiple choice med kommentar og liste med kommentar)
• nocomments - kun underspørgsmål, der ikke er kommentarer

*sq_X - hvor X er en række- eller kolonne-id. Kun underspørgsmål, der matcher mønster X, er valgt. Bemærk, at søgningen udføres på komplet kode-id, derefter matcher sq_X og inkluderer underspørgsmål nX, X, Xn (f.eks. hvis du bruger sq_1, var underspørgsmål a1, 1a, 1, 11 eller 001 inkluderet). Vær opmærksom på spørgsmålstype i dobbelt skala, hvor underspørgsmålskoden er QCODE_SQCODE_1 og QCODE_SQCODE_1 og på rangeringsspørgsmålstypen, hvor underspørgsmålskoden er QCODE_1, QCODE_2 ....

• nosq_X - hvor X er en række- eller kolonne-id. Kun underspørgsmål, der ikke matcher mønster X, er valgt. Bemærk, at søgningen udføres på komplet kode-id, derefter matcher nosq_X og inkluderer ikke underspørgsmål nX, X, Xn

Eksempler:

• Er nogen del af et spørgsmål blevet besvaret? {count(self.NAOK)>0}
• Hvad er vurderingsresultatet for dette spørgsmål? {sum(selv.værdi)}

Du kan også bruge disse til at få række- og kolonnetotaler. Lad os sige, at du har en række tal med rækker AE og kolonne 1-5.

• Hvad er totalsummen? {sum(selv.NAOK)}
• Hvad er totalen af række B? {sum(self.sq_B.NAOK)}
• Hvad er summen af kolonne 3? {sum(self.sq_3.NAOK)}

Variablen 'det' er ligesom 'selv'-variablen, men lader dig henvise til andre spørgsmål. Dens syntaks er:

• that.qname
• that.qname.suffiks
• that.qname.sub-selector' '
• that.qname.undervælger.suffiks

qname er spørgsmålets navn uden nogen underspørgsmålsudvidelser. Så sig, at du opretter et spørgsmål 'q1', det er dets qname

Eksempler:

• Er nogen del af spørgsmål q1 blevet besvaret? {count(that.q1.NAOK)>0}
• Hvad er vurderingsresultatet for q2? {sum(that.q2.NAOK)}
• Hvad er den samlede sum af q3? {sum(that.q3.NAOK)}
• Hvad er den samlede række af række C i q4? {sum(that.q4.sq_C.NAOK)}
• Hvad er summen af kolonne 2 i q4? {sum(that.q4.sq_2.NAOK)}

Variablerne 'selv' og 'det' kan bruges i enhver relevans, validering eller skræddersyet.

Den ene advarsel er, at når du bruger funktionen Vis logikfil, vil den vise dig den udvidede værdi af 'selv' og 'det'. Dette lader dig se den faktiske ligning, der vil blive genereret, så du (og Expression Manager) kan validere, at variablerne eksisterer. Dette kan virke forvirrende, da du kan se ret lange ligninger. Men hvis du redigerer spørgsmålet, vil du se den originale ligning ved hjælp af 'selv' og/eller 'det'

Bemærk også, at du ikke skal bruge disse variable, hvis (a) du eksplicit ønsker at navngive hver variabel, der bruges i en ligning, eller (b) bruge variabler, der ikke har underspørgsmål (f.eks. enkeltsvarsspørgsmål). I de tilfælde er det overdrevent at præfikse en variabel med 'det', og du risikerer at få uventede resultater.

Brug af NAOK

NAOK --> "Ikke relevant" (NA) er i orden (OK)

Brug af NAOK betyder, at alle eller nogle af variablerne er irrelevante (f.eks. "Ikke relevant" (NA) er i orden (OK)).

Når du sætter en variabel fra spørgsmål i en ligning: hvis dette spørgsmål (eller underspørgsmål) er skjult af betingelse: dette deaktiverer alle ligninger.

For eksempel: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) angiv altid en tom streng, hvis et underspørgsmål til Q1 er filtreret. Tælle antallet af kontrollerede underspørgsmål i et sådant spørgsmål kan tælles(Q1_SQ1.NAOK,Q1_SQ2.NAOK ,Q1_SQ3.NAOK,Q1_SQ4.NAOK). Hvis underspørgsmålet er skjult: Udtryksmanager returnerer en tom streng.

Uden NAOK: hvis et spørgsmål eller et underspørgsmål er skjult: Expression Manager returnerer altid en tom streng, det samme for at returnere falsk.

De .viste bruger altid NAOK-systemet (tom streng, hvis den er skjult), men hvis du har brug for koden til svaret: det er altid en god idé at tilføje .NAOK efter spørgsmålskoden. Undtagen hvis du har brug for det og ved hvad du gør.

Et andet eksempel og oplysninger findes på Overriding Cascading Conditions

Adgang til funktioner

Expression Manager giver adgang til matematiske, strenge og brugerdefinerede funktioner, som vist nedenfor. Det har PHP- og JavaScript-ækvivalenter til disse funktioner, så de fungerer identisk på serversiden (PHP) og klientsiden (JavaScript). Det er nemt at tilføje nye funktioner.

Implementerede funktioner

Følgende funktioner er i øjeblikket tilgængelige:

Function	Meaning	Syntax
abs	Absolute value	number abs(number)
acos	Arc cosine	number acos(number)
addslashes	Quote string with slashes	string addslashes(string)
asin	Arc sine	number asin(number)
atan	Arc tangent	number atan(number)
atan2	Arc tangent of two variables	number atan2(number, number)
ceil	Round fractions up	number ceil(number)
checkdate	Returns true(1) if it is a valid date in gregorian calendar	bool checkdate(month,day,year)
convert_value	Convert a numerical value using a inputTable and outputTable of numerical values	number convert_value(fValue, iStrict, sTranslateFromList, sTranslateToList)
cos	Cosine	number cos(number)
count	count the number of answered (non-blank) questions in the list	number count(arg1, arg12, ..., argN)
countif	Count the number of answered questions in the list equal to the first argument	number countif(matches, arg1, arg2, ... argN)
countifop	Count the number of answered questions in the list which pass the criteria (arg op value)	number countifop(op, value, arg1, arg2, ... argN)
date	Format a local date/time	string date(format [, timestamp=time()])
exp	Calculates the exponent of e	number exp(number)
fixnum	Display numbers with comma as radix separator, if needed	string fixnum(number)
floor	Round fractions down	number floor(number)
gmdate	Format a GMT date/time	string gmdate(format [, timestamp=time()])
html_entity_decode	Convert all HTML entities to their applicable characters (always uses ENT_QUOTES and UTF-8)	string html_entity_decode(string)
htmlentities	Convert all applicable characters to HTML entities (always uses ENT_QUOTES and UTF-8)	string htmlentities(string)
expr_mgr_htmlspecialchars	Convert special characters to HTML entities (always uses ENT_QUOTES and UTF-8)	string htmlspecialchars(string)
expr_mgr_htmlspecialchars_decode	Convert special HTML entities back to characters (always uses ENT_QUOTES and UTF-8)	string htmlspecialchars_decode(string)
idate	Format a local time/date as integer	string idate(string [, timestamp=time()])
if (Updated in 3.0.2 )	Excel-style if(test,result_if_true[,result_if_false = ""])	if(test,result_if_true[,result_if_false = ""])
implode	Join array elements with a string	string implode(glue,arg1,arg2,...,argN)
intval	Get the integer value of a variable	int intval(number [, base=10])
is_empty	Determine whether a variable is considered to be empty	bool is_empty(var)
is_float	Finds whether the type of a variable is float	bool is_float(var)
is_int	Find whether the type of a variable is integer	bool is_int(var)
is_nan	Finds whether a value is not a number	bool is_nan(var)
is_null	Finds whether a variable is NULL	bool is_null(var)
is_numeric	Finds whether a variable is a number or a numeric string	bool is_numeric(var)
is_string	Find whether the type of a variable is string	bool is_string(var)
join (New in 2.0 build 130129)	Join elements as a new string	join(arg1, arg2, ... argN)
list	Return comma-separated list of non-blank values	string list(arg1, arg2, ... argN)
listifop (New in 3.16.1 )	Return a 'glue'-separated list of the specified question property (retProp) from questions in the list which pass the criteria (cmpProp op value)	string listifop(cmpProp, op, value, retProp, glue, sgqa1, sgqa2, ... sgqaN)
log	The logarithm of number to base, if given, or the natural logarithm.	number log(number,base=e)
ltrim	Strip whitespace (or other characters) from the beginning of a string	string ltrim(string [, charlist])
max	Find highest value	number max(arg1, arg2, ... argN)
min	Find lowest value	number min(arg1, arg2, ... argN)
mktime	Get UNIX timestamp for a date (each of the 6 arguments are optional)	number mktime([hour [, minute [, second [, month [, day [, year ]]]]]])
modulo-function	The modulo function is not supported yet. You can use the floor() function instead	floor(x/y)==(x/y)
nl2br	Inserts HTML line breaks before all newlines in a string	string nl2br(string)
number_format	Format a number with grouped thousands	string number_format(number)
pi	Get value of pi	number pi()
pow	Exponential expression	number pow(base, exp)
quoted_printable_decode	Convert a quoted-printable string to an 8 bit string	string quoted_printable_decode(string)
quoted_printable_encode	Convert a 8 bit string to a quoted-printable string	string quoted_printable_encode(string)
quotemeta	Quote meta characters	string quotemeta(string)
rand	Generate a random integer, see this example	int rand() OR int rand(min, max)
regexMatch	compare a string to a regular expression	bool regexMatch(pattern,input)
round	Rounds a number to an optional precision	number round(val [, precision])
rtrim	Strip whitespace (or other characters) from the end of a string	string rtrim(string [, charlist])
sin	Sine	number sin(arg)
sprintf	Return a formatted string	string sprintf(format, arg1, arg2, ... argN)
sqrt	Square root	number sqrt(arg)
stddev	Calculate the Sample Standard Deviation for the list of numbers	number stddev(arg1, arg2, ... argN)
str_pad	Pad a string to a certain length with another string	string str_pad(input, pad_length [, pad_string])
str_repeat	Repeat a string	string str_repeat(input, multiplier)
str_replace	Replace all occurrences of the search string with the replacement string	string str_replace(search, replace, subject)
strcasecmp	Binary safe case-insensitive string comparison	int strcasecmp(str1, str2)
strcmp	Binary safe string comparison	int strcmp(str1, str2)
strip_tags	Strip HTML and PHP tags from a string	string strip_tags(str, allowable_tags)
stripos	Find position of first occurrence of a case-insensitive unicode string (starting by 0, return false if not found)	int stripos(haystack, needle [, offset=0])
stripslashes	Un-quotes a quoted string	string stripslashes(string)
stristr	Case-insensitive strstr	string stristr(haystack, needle [, before_needle=false])
strlen	Get string length	int strlen(string)
strpos	Find position of first occurrence of an unicode string (starting by 0, return false if not found)	int strpos(haystack, needle [ offset=0])
strrev	Reverse a string	string strrev(string)
strstr	Find first occurrence of a string	string strstr(haystack, needle[, before_needle=false])
strtolower	Make a string lowercase	string strtolower(string)
strtotime	Parse about any English textual datetime description into a Unix timestamp	int strtotime(string)
strtoupper	Make a string uppercase	string strtoupper(string)
substr	Return part of an unicode string	string substr(string, start [, length])
sum	Calculate the sum of values in an array	number sum(arg1, arg2, ... argN)
sumifop	Sum the values of answered questions in the list which pass the criteria (arg op value)	number sumifop(op, value, arg1, arg2, ... argN)
tan	Tangent	number tan(arg)
time	Return current UNIX timestamp	number time()
trim	Strip whitespace (or other characters) from the beginning and end of a string	string trim(string [, charlist])
ucwords	Uppercase the first character of each word in a string	string ucwords(string)
unique	Returns true if all non-empty responses are unique	boolean unique(arg1, ..., argN)

Funktioner, der er planlagt eller overvejet

Andre funktioner, der er planlagt (eller overvejes), men som endnu ikke er implementeret, omfatter følgende. Nogle af disse er til bagudkompatibilitet med et andet undersøgelsesværktøj.

Syntaks	Betydning	Kommentarer
e()	returnerer værdien af e
formatDate(X, PAT)	returner strengværdien for dato X formateret i henhold til Java-dataformatmønsteret PAT
formatNumber(X,PAT)	returner strengværdien for nummer X formateret i henhold til Java-nummer formatmønster PAT
getAnsOption(X)	Kerneplugin ExpressionAnswerOptions
getAnsOption(X,Y)	Kerneplugin ExpressionAnswerOptions
getRelevance(X)	returnerer relevansligningen for spørgsmål X
getStartTime()	returnerer datoen svarende til systemtidspunktet, da interviewet blev startet
getType(X)	returnerer strengnavnet på datatypen - fx *NA* if isNA()
gotoFirst()	hopper til det første relevante sæt spørgsmål - dette overtræder systemets normale flow
gotoNext()	hopper til næste sæt af relevante spørgsmål - dette krænker systemets normale flow
gotoPrevious()	springer til det forrige sæt af relevante spørgsmål - dette krænker systemets normale flow		-	isAsked(X)	returnerer sandt, hvis svaret hverken er *NA*, *UGYLDIG* eller *UNASKED*
isInvalid(X)	returnerer sandt, hvis svaret er af typen *INVALID*
isNA(X)	returnerer sandt, hvis svaret er af typen *NA*
isNotUnderstood(X)	returnerer sandt, hvis svaret if af typen *HUH*
isRefused(X)	returnerer sandt, hvis svaret er af typen *REFUSED*
isSpecial(X)	returnerer sandt, hvis svaret er af typen *UNASKED*, *NA*, *AFVISET*, *UGYLDIG*, *UKENDT* eller *HUH*
isUnknown(X)	returnerer sandt, hvis svaret er af typen *UNKNOWN*
jumpTo(X)	spring til gruppen, der indeholder det navngivne spørgsmål -- dette overtræder normalen systemets flow
jumpToFirstUnasked()	spring til det første ustillede spørgsmål og omgå dermed tidligere besvarede spørgsmål, dette overtræder systemets normale flow
lastIndexOf(X,Y)
list(X,.. .)	en streng, der indeholder en kommasepareret liste over de positive værdier, hvor "og" adskiller de sidste to
mean(X,...)	returnerer middelværdien af en liste af værdier
numAnsOptions(X)	returnerer antallet af svarmuligheder, som spørgsmål X har
orlist(X,...)	en streng, der indeholder en kommasepareret liste over de positive værdier, hvor "eller" adskiller de sidste to
parseDate(X,PAT)	returnerer datoværdien af streng X parset med Java-dato formatmønster PAT
parseNumber(X,PAT)	returnerer den numeriske værdi af streng X parset med Java-talformatmønster PAT
showAllResponsesExcept( questionList ,attributeList,attributeTitleList)	questionList = rørsepareret liste over spørgsmåls-id'er; attributeList = pipe-separeret liste over attributter (som spørgsmål #, titel, tekst, type - så du kan bestemme, hvad der skal vises); attributeTitleList = pipe-separeret liste over tabeloverskrifter, så kan internationalisere rapporten.
showTheseResponses( questionList,attributeList,attributeTitleList)	questionList = pipe-separeret liste over spørgsmåls-id'er; attributeList = pipe-separeret liste over attributter (som spørgsmål #, titel, tekst, type - så du kan bestemme, hvad der skal vises); attributeTitleList = pipe-separeret liste over tabeloverskrifter, så rapporten kan internationaliseres.

Expression Manager ved, hvilke variabler der er lokale

For at kunne bygge JavaScript til siden korrekt, skal Expression Manager vide, hvilke variabler der er indstillet på siden, og hvad deres JavaScript ID er (f.eks. for document.getElementById(x)). Den skal også vide, hvilke variabler der er indstillet på andre sider (så den kan sikre, at den nødvendige<input type='hidden' value='x'> felter er til stede og udfyldt).

Cascading betingelser

Hvis nogen af variablerne er irrelevante, vil hele ligningen være irrelevant (falsk). For eksempel betyder N/A i følgende tabel, at en af variablerne ikke var relevant

Operator	Eksempel	a	b	Resultat
+ (ulært)	+a	N/A		false
!	!a	N/A		falsk
== (eller lign.)	a == b	N/A	5	falsk
== (eller lign.)	a == b	N/A	0	falsk
== (eller lign.)	a == b	N/A	N/A	falsk
!= (eller ne)	a != b	N/A	5	falsk
!= (eller ne)	a != b	N/A	N/A	false
!= (eller ne)	a != b	N/A	0	false
> (eller gt)	a > b	N/A	5	false
>= (eller ge)	a >= b	N/A	5	false
< (eller lt)	a < b	N/A	5	false
<= (eller le)	a <= b	N/A	5	false
og	a og b	N/A	5	falsk
og	a og b	N/A	N/A	falsk
or	a eller b	N/A	N/A	false
or	a eller b	N/A	5	falsk
+	a + b	N/A	5	falsk
*	a * b	N/A	5	false
/	a / b	5	N/A	false
()	(a)	N/A		false
(exp)	(a && b)	N/A	5	false
|(b + b) > (a && b)	N/A	5	falsk
funktion	sum(a,b,b)	N/A	5	falsk
funktion	max(a,b)	N/A	5	falsk
funktion	min(a,b)	N/A	5	falsk
function	implode(', ',a,b,a,b)	N/A	5	false
funktion	hvis(a,a,b)	N/A	5	falsk
funktion	er_tom(a)	N/ A		false
funktion	er_tom(a)	0 (eller tom)		true
funktion	!is_empty(a)	N/A		false

Tilsidesættende kaskadeforhold

Lad os sige, at du vil vise en løbende sum af alle relevante svar. Du kan prøve at bruge ligningen {sum(q1,q2,q3,...,qN)}. Dette bliver dog internt oversat til LEMif(LEManyNA('q1','q2','q3',...,'qN'),,sum(LEMval('q1'),LEMval('q2') ,LEMval('q3'),...,LEMval('qN'))). Så hvis nogen af værdierne q1-qN er irrelevante, vil ligningen altid returnere falsk. I dette tilfælde vil sum() vise 0, indtil alle spørgsmål er besvaret.

For at komme uden om dette kan hver variabel have tilføjet et ".NAOK"-suffiks (hvilket betyder, at Not Applicable er OK). I sådanne tilfælde opstår følgende adfærd. Lad os sige, at du har en variabel q1.NAOK

1. q1 er ikke tilføjet til LEManyNA()-sætningen
2. LEMval('q1') vil fortsætte med at kontrollere, om svaret er relevant, og vil vende tilbage '' hvis det ikke er (så individuelle irrelevante svar vil blive ignoreret, men de vil ikke annullere hele udtrykket).

Så løsningen på det løbende totalproblem er at bruge ligningssummen(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK).

Brugen af .NAOK-suffikset giver også forfattere mulighed for at designe undersøgelser, der har flere mulige stier, men derefter konvergere på fælles stier senere. Lad os f.eks. sige, at forsøgspersoner besvarer en undersøgelse på en måde, der ligger uden for det normale svarområde. Forfatteren kunne advare forsøgspersonerne om, at de muligvis ikke får gyldige resultater, og spørge dem, om de virkelig ønsker at fortsætte med undersøgelsen. Hvis de siger Ja, så vil resten af spørgsmålene blive vist. Betingelsen for "resten af spørgsmålene" ville kontrollere, om de indledende svar blev besvaret inden for normalområdet ELLER om forsøgspersonen sagde ja til spørgsmålet, der kun er relevant, hvis de svarede uden for normalområdet.

Hvordan understøtter Expression Manager Conditional Micro-Tailoring?

Her er et eksempel på mikro-skræddersyning (hvor spørgsmålstype=='udtr.' betyder en ligning):

Spørgsmålskode	Relevans	Spørgsmålstype	Spørgsmål
navn	1	tekst	Hvad er dit navn?
alder	1	tekst	Hvor gammel er du?
badage	!is_empty(age)	expr	{(alder<16) eller (alder>80)}
agestop	badage	meddelelse	Beklager, {navn}, du er for {if( (alder<16),'young',if( (alder>80), 'gammel','midaldrende') ) } til denne test.
kids	!badage	yesno	Har du børn?
forældre	1	expr	{!badage && kids=='Y'}
numBørn	forældre	tekst	Hvor mange børn har du?
kid1	forældre && numKids >= 1	text	Hvor gammelt er dit første barn?
kid2	forældre && numKids >= 2	tekst	Hvor gammel er dit andet barn?
kid3	forældre && numKids >= 3	text	Hvor gammelt er dit tredje barn?
kid4	forældre && numKids > = 4	text	Hvor gammelt er dit fjerde barn?
kid5	forældre && numKids >= 5	text	Hvor gammelt er dit femte barn?
sumage	1	expr	{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)}
rapport	|yesno	{name}, du sagde, at du er {age}, og at du har {numKids}. Summen af alderen på dine første {min(antalBørn,5)} børn er {sumage}

Alle disse spørgsmål kan være på en enkelt side (f.eks. i samme gruppe), og kun de relevante spørgsmål vises. Når du indtaster børns alder, vil sum()-udtrykket i det sidste spørgsmål desuden opdateres dynamisk på siden.

<html>Expression Manager giver denne funktionalitet ved at omgive hvert udtryk med en navngiven element. Hver gang en værdi ændres, genberegner den det udtryk, der skal vises i den element og regenererer displayet. Du kan have snesevis eller endda hundredvis af sådanne skræddersyede udtryk på den samme side, og siden vil vise dem alle igen på en enkelt skærmopdatering.

Kortlægning af LimeSurvey 1.91+ til Expression Manager-funktionalitet

Gammel funktion	Ny funktion	Kommentarer
Betingelser	Relevans	-	Evalueringer	Ligning	Enhver vurderingsscore kan omstruktureres til en ligning. Dette sikrer både, at scoren skrives til databasen, og lader dig også se dynamiske ændringer af scoreværdien på den aktuelle side
Replacements	Expression Manager	Kernemotoren tager inputstrengen og behandler alt indenfor krøllede seler som et udtryk - så det håndterer alle historiske erstatningstyper. For at undgå at ødelægge indlejret JavaScript, behandler Expression Manager kun indhold mellem krøllede klammeparenteser, så længe (a) der ikke er noget mellemrum inden for de krøllede klammeparenteser - f.eks. er {expr} et udtryk, men { expr}, {expr }, og { udtr. } er ikke udtryk. Ydermere behandler Expression Manager ikke indhold inden for sine egne strenge (f.eks. genererer {list('hi','there {braces}')} "hi there {braces}"). Den ignorerer også undslupne krøllede klammeparenteser (f.eks. \{dette er ikke et udtryk\})
Validation	Expression Manager	Planen er at tage de nuværende min/max spørgsmålsattributter og have Expression Manager behandle dem. På den måde kan min/max-værdierne være selve udtryk

Syntaksfremhævning

For at hjælpe med at indtaste og validere udtryk tilbyder EM syntaksfremhævning med følgende funktioner:

Typer og betydninger af syntaksfremhævning

Farve	Eksempel	Betydning	Værktøjstip	Kommentarer
beige baggrund	Eksempel	hele ligningen	ingen	Alt inden for krøllede parenteser, der genkendes som en ligning (dvs. uden indledende eller efterfølgende mellemrum), farvekodes med beige baggrund, så det er nemmere at skelne fra den omgivende tekst
fed rød tekst	Eksempel	En fejl	En forklaring på fejlen	Kan være en ukendt variabel eller en fejl i en funktion, .... Undersøgelsen kan være helt ødelagt, men dette vises ikke for offentlige brugere.
blå tekst	Eksempel	funktionsnavn	betydning og tilladt syntaks	funktionsnavne, eller ting der burde være funktioner, fordi de efterfølges af en startparentes, vises med fed blå tekst. Værktøjstip viser funktionens betydning og tilladte syntaks.
grå tekst	Eksempel	streng	ingen	strenge i enkelte og dobbelte anførselstegn vises med grå tekst
cyan tekst	Eksempel	variabel angivet på samme side,	[navn eller SGQA-kode]: spørgsmål; værdi; svarliste, der viser koder for hver værdi	Enhver variabel, der er angivet på samme side som det aktuelle spørgsmål, vises med cyan tekst, hvilket viser, at den kan opdateres i JavaScript. Værktøjstippet viser dens navn, selve spørgsmålet og dens nuværende værdi (eller tom, hvis den ikke er angivet). Hvis spørgsmålstypen forventer besvarelser fra et opregnet værdisæt, vises koderne og deres visningsværdier.
grøn tekst	Eksempel	variabel angivet på en tidligere side	[navn eller SGQA-kode]: spørgsmål; værdi; svarliste, der viser koder for hver værdi	Enhver variabel, der er angivet på en tidligere side, vises med fed grøn tekst. Værktøjstippet viser dens navn, selve spørgsmålet og dens nuværende værdi (eller tom, hvis den ikke er angivet). Hvis spørgsmålstypen forventer besvarelser fra et opregnet værdisæt, vises koderne og deres visningsværdier.
fed lyserød tekst	Eksempel	variabel angivet på en senere side generelt: tom ved start af undersøgelsen, men kan udfyldes via indeks eller ved at gå tilbage	[navn eller SGQA-kode]: spørgsmål; værdi; svarliste, der viser koder for hver værdi	Enhver variabel, der er angivet på en senere side, vises med fed lyserød tekst. Værktøjstippet viser dens navn, selve spørgsmålet og dens nuværende værdi (eller tom, hvis den ikke er angivet). Hvis spørgsmålstypen forventer besvarelser fra et opregnet værdisæt, vises koderne og deres visningsværdier.
fed beige tekst	Eksempel	en Lime-erstatningsværdi	værdien	Lime-erstatningsstrenge (som {TOKEN:xxx}, {PRIVACY_MESSAGE}) vises med fed beige tekst.
rød tekst	Eksempel	tildelingsoperator (=)	advarselsmeddelelse	Hvis du bruger tildelingsoperatoren (=), vises den med rød tekst. Det skal hjælpe med at forhindre utilsigtet gentildeling af værdier, når du i virkeligheden ville kontrollere, om a == b, i stedet for at sætte værdien a = b.
normal sort tekst	Eksempel	tegnsætning	ingen	Al anden tegnsætning i udtrykket vises som normal sort tekst.
tekst med rød kasse	en fed rød linje omgiver fejlen	syntaksfejl	beskrivelse af fejlen	Alle registrerede syntaksfejl vises ved, at fejlen omgives af en rød kasse. Værktøjstippet viser fejlen. Eksempler er ulige antal parenteser, brug af udefinerede funktioner, forkert antal argumenter til funktioner, dårligt opbyggede udtryk (f.eks. manglende operatorer mellem variabler), forsøg på at tildele en ny værdi til en skrivebeskyttet variabel, forsøg på at tildele værdier til noget, der ikke er variabler, eller brug af ikke-understøttet syntaks. Bemærk, at systemet til registrering af syntaksfejl muligvis kun rapporterer én fejl i et udtryk, selv om der er flere; men hvis der registreres fejl, vises mindst én fejl.

Yderligere læsning

Expression Manager prøveundersøgelser

Use Cases og HowTos

Trin-for-trin-eksempler

Statistikfunktioner i Expression Manager

Reference for udviklere

RoadMap/Status/ToDo List