LimeSurvey Manual
Menu
Navigation
Main page
Recent changes
Random page
Help
Search
Special pages
Printable version
Recent changes
Help
English
Log in
Actions
Translate
Language statistics
Message group statistics
Export
Special
Export translations
Settings
Group
Activating a survey
Adding answers or subquestions
Administering LimeSurvey
Alternatives to the LimeSurvey import function
Assessments
Backup entire database
Batch deletion
Category:Advanced Question Settings
Category:General Question Options
Category:Question Settings
Central Participant Database
Changing an active survey
Check data integrity
Check question logic
Check survey logic - Advanced
Closing a survey
ComfortUpdate
Copy question
Custom translation
Data encryption
Data entry
Data policy settings
DateFunctions
Default answers
Delete question
Delete survey
Display/Export survey
Edit question
Email bounce tracking system
Email templates
Export question
Export responses
Exporting results
Expression Manager
Expression Manager sample surveys
ExpressionScript - Presentation
ExpressionScript Engine - Quick start guide
ExpressionScript examples
ExpressionScript How-tos
ExpressionScript sample surveys
Extension compatibility
Failed email notifications
First login - your user preferences
General FAQ
General settings
Getting started
Global settings
Google API howto
Home page settings
How to design a good survey (guide)
Import responses
Importing a survey
Installation - LimeSurvey CE
Installation FAQ
Installation of the LimeSurvey XAMPP package
Installation security hints
Installation using a command line interface (CLI)
Installation Version 1.92 or older
Iterate survey
Label sets
LDAP settings
License
LimeSurvey Manual
LimeSurvey PRO vs LimeSurvey CE
LimeSurvey Users
LimeSurvey Video-Tutorial
LimeSurvey-compatible hosting companies
List question groups
List questions
Localization
Major version upgrade
Make your plugin compatible with LS4
Manage user groups
Manage users
Menu configuration
Menu entries configuration
Multilingual survey
New Template System in LS3.x
Not categorized and advanced features
Notifications & data
Optional settings
Overview
Panel integration
Participant settings
Plugin manager
Plugin menu
Plugins - advanced
Presentation
Preview function
Problems & solutions
Publication & access
QS:Allowed filetypes
QS:Alphasort
QS:Answer width
QS:Array filter
QS:Array filter exclude
QS:Array filter style
QS:Assessment value
QS:Autocheck exclusive option
QS:Category separator
QS:Chart type
QS:Choice column width
QS:Choice header
QS:Code filter
QS:Commented checkbox
QS:CSS Class
QS:Date max
QS:Date min
QS:Date time format
QS:Display chart
QS:Display columns
QS:Display map
QS:Display rows
QS:Display type
QS:Dropdown dates
QS:Dropdown dates year max
QS:Dropdown dates year min
QS:Dropdown prefix
QS:Dropdown prepostfix
QS:Dropdown separators
QS:Dropdown size
QS:Dualscale headerA
QS:Dualscale headerB
QS:Em validation q
QS:Em validation q tip
QS:Em validation sq
QS:Em validation sq tip
QS:Encryption
QS:Equals num value
QS:Equation
QS:Exclusive option
QS:Get order previous q
QS:Hidden
QS:Hide tip
QS:Input box size
QS:Input boxes
QS:Input max characters
QS:Label column width
QS:Location city
QS:Location country
QS:Location defaultcoordinates
QS:Location mapheight
QS:Location mapservice
QS:Location mapwidth
QS:Location mapzoom
QS:Location nodefaultfromip
QS:Location postal
QS:Location state
QS:Mandatory
QS:Max answers
QS:Max filesize
QS:Max num value
QS:Max num value n
QS:Max num value sgqa
QS:Max subquestions
QS:Maximum chars
QS:Maximum number of files
QS:Min answers
QS:Min num value
QS:Min num value n
QS:Minimum number of files
QS:Minute step interval
QS:Month display style
QS:Multiflexible checkbox
QS:Multiflexible max
QS:Multiflexible min
QS:Multiflexible step
QS:Num value int only
QS:Numbers only
QS:Other
QS:Other comment mandatory
QS:Other numbers only
QS:Other Position
QS:Other replace text
QS:Page break
QS:Prefix
QS:Preg validation
QS:Printable survey relevance help
QS:Public statistics
QS:Question theme
QS:Random group
QS:Random order
QS:Rank header
QS:Relevance
QS:Remove text or uncheck checkbox
QS:Repeat headers
QS:Reverse
QS:Samechoiceheight
QS:Samelistheight
QS:Scale export
QS:Show comment
QS:Show grand total
QS:Show title
QS:Show totals
QS:Showpopups
QS:Slider accuracy
QS:Slider default
QS:Slider handle shape
QS:Slider handle Unicode shape
QS:Slider initial value
QS:Slider layout
QS:Slider max
QS:Slider middlestart
QS:Slider min
QS:Slider orientation
QS:Slider rating
QS:Slider reset
QS:Slider reverse
QS:Slider separator
QS:Slider showminmax
QS:Subquestion width
QS:Suffix
QS:Text input width
QS:Theme editor - advanced options
QS:Time limit
QS:Time limit action
QS:Time limit countdown message
QS:Time limit disable next
QS:Time limit disable prev
QS:Time limit message
QS:Time limit message delay
QS:Time limit message style
QS:Time limit timer style
QS:Time limit warning
QS:Time limit warning display time
QS:Time limit warning message
QS:Time limit warning style
QS:Use dropdown
QS:Value range allows missing
Question groups - introduction
Question toolbar options
Question type - 5 point choice
Question type - Array
Question type - Array (10 point choice)
Question type - Array (5 point choice)
Question type - Array (Increase-Same-Decrease)
Question type - Array (Numbers)
Question type - Array (Texts)
Question type - Array (Yes-No-Uncertain)
Question type - Array by column
Question type - Array dual scale
Question type - Date
Question type - Equation
Question type - File upload
Question type - Gender
Question type - Huge free text
Question type - Language switch
Question type - List (Dropdown)
Question type - List (Radio)
Question type - List with comment
Question type - Long free text
Question type - Multiple choice
Question type - Multiple choice with comments
Question type - Multiple numerical input
Question type - Multiple short text
Question type - Numerical input
Question type - Ranking
Question type - Short free text
Question type - Text display
Question type - Yes-No
Question types
Questions - introduction
QueXML PDF Export
Quick start guide - LimeSurvey 2.50+
Quick start guide - LimeSurvey 3.0+
Quick-translation
Regenerate question codes
Reorder questions and question groups
Reset conditions
Resources
Responses & statistics
Responses (survey results)
Running a survey safely
Setting conditions
SGQA identifier
Statistics
Survey group permissions
Survey menu
Survey participants
Survey permissions
Survey quotas
Survey settings
Survey settings version 2
Survey structure
Survey toolbar options
Surveys - introduction
Surveys - management
Tab Separated Value survey structure
Template:Deprecated
Template:DeprecatedIn
Template:Example
Template:FeatureChange
Template:FeatureStarting
Template:Hint
Template:NewIn
Template:UpdatedIn
Testing a survey
Text elements
Theme editor
Theme options
Themes
Timing statistics
Tools
Transferring an installation
Translating LimeSurvey
Troubleshooting
TwoFactorAdminLogin
Upgrading from a previous version
URL fields
Using regular expressions
Version change log
Version guide
View saved but not submitted responses
Workarounds
Language
aa - Afar
ab - Abkhazian
abs - Ambonese Malay
ace - Achinese
acm - Iraqi Arabic
ady - Adyghe
ady-cyrl - Adyghe (Cyrillic script)
aeb - Tunisian Arabic
aeb-arab - Tunisian Arabic (Arabic script)
aeb-latn - Tunisian Arabic (Latin script)
af - Afrikaans
aln - Gheg Albanian
alt - Southern Altai
am - Amharic
ami - Amis
an - Aragonese
ang - Old English
ann - Obolo
anp - Angika
ar - Arabic
arc - Aramaic
arn - Mapuche
arq - Algerian Arabic
ary - Moroccan Arabic
arz - Egyptian Arabic
as - Assamese
ase - American Sign Language
ast - Asturian
atj - Atikamekw
av - Avaric
avk - Kotava
awa - Awadhi
ay - Aymara
az - Azerbaijani
azb - South Azerbaijani
ba - Bashkir
ban - Balinese
ban-bali - Balinese (Balinese script)
bar - Bavarian
bbc - Batak Toba
bbc-latn - Batak Toba (Latin script)
bcc - Southern Balochi
bci - Baoulé
bcl - Central Bikol
bdr - West Coast Bajau
be - Belarusian
be-tarask - Belarusian (Taraškievica orthography)
bew - Betawi
bg - Bulgarian
bgn - Western Balochi
bh - Bhojpuri
bho - Bhojpuri
bi - Bislama
bjn - Banjar
blk - Pa'O
bm - Bambara
bn - Bangla
bo - Tibetan
bpy - Bishnupriya
bqi - Bakhtiari
br - Breton
brh - Brahui
bs - Bosnian
btm - Batak Mandailing
bto - Iriga Bicolano
bug - Buginese
bxr - Russia Buriat
ca - Catalan
cbk-zam - Chavacano
cdo - Min Dong Chinese
ce - Chechen
ceb - Cebuano
ch - Chamorro
cho - Choctaw
chr - Cherokee
chy - Cheyenne
ckb - Central Kurdish
co - Corsican
cps - Capiznon
cpx - Pu-Xian Min
cpx-hans - Pu-Xian Min (Simplified Han script)
cpx-hant - Pu-Xian Min (Traditional Han script)
cpx-latn - Pu-Xian Min (Latin script)
cr - Cree
crh - Crimean Tatar
crh-cyrl - Crimean Tatar (Cyrillic script)
crh-latn - Crimean Tatar (Latin script)
crh-ro - Crimean Tatar (Romania)
cs - Czech
csb - Kashubian
cu - Church Slavic
cv - Chuvash
cy - Welsh
da - Danish
dag - Dagbani
de - German
de-at - Austrian German
de-ch - Swiss High German
de-formal - German (formal address)
dga - Dagaare
din - Dinka
diq - Zazaki
dsb - Lower Sorbian
dtp - Central Dusun
dty - Doteli
dv - Divehi
dz - Dzongkha
ee - Ewe
egl - Emilian
el - Greek
eml - Emiliano-Romagnolo
en - English
en-ca - Canadian English
en-gb - British English
eo - Esperanto
es - Spanish
es-419 - Latin American Spanish
es-formal - Spanish (formal address)
et - Estonian
eu - Basque
ext - Extremaduran
fa - Persian
fat - Fanti
ff - Fula
fi - Finnish
fit - Tornedalen Finnish
fj - Fijian
fo - Faroese
fon - Fon
fr - French
frc - Cajun French
frp - Arpitan
frr - Northern Frisian
fur - Friulian
fy - Western Frisian
ga - Irish
gaa - Ga
gag - Gagauz
gan - Gan Chinese
gan-hans - Gan (Simplified)
gan-hant - Gan (Traditional)
gcr - Guianan Creole
gd - Scottish Gaelic
gl - Galician
gld - Nanai
glk - Gilaki
gn - Guarani
gom - Goan Konkani
gom-deva - Goan Konkani (Devanagari script)
gom-latn - Goan Konkani (Latin script)
gor - Gorontalo
got - Gothic
gpe - Ghanaian Pidgin
grc - Ancient Greek
gsw - Alemannic
gu - Gujarati
guc - Wayuu
gur - Frafra
guw - Gun
gv - Manx
ha - Hausa
hak - Hakka Chinese
haw - Hawaiian
he - Hebrew
hi - Hindi
hif - Fiji Hindi
hif-latn - Fiji Hindi (Latin script)
hil - Hiligaynon
hno - Northern Hindko
ho - Hiri Motu
hr - Croatian
hrx - Hunsrik
hsb - Upper Sorbian
hsn - Xiang Chinese
ht - Haitian Creole
hu - Hungarian
hu-formal - Hungarian (formal address)
hy - Armenian
hyw - Western Armenian
hz - Herero
ia - Interlingua
id - Indonesian
ie - Interlingue
ig - Igbo
igl - Igala
ii - Sichuan Yi
ik - Inupiaq
ike-cans - Eastern Canadian (Aboriginal syllabics)
ike-latn - Eastern Canadian (Latin script)
ilo - Iloko
inh - Ingush
io - Ido
is - Icelandic
it - Italian
iu - Inuktitut
ja - Japanese
jam - Jamaican Creole English
jbo - Lojban
jut - Jutish
jv - Javanese
ka - Georgian
kaa - Kara-Kalpak
kab - Kabyle
kai - Karekare
kbd - Kabardian
kbd-cyrl - Kabardian (Cyrillic script)
kbp - Kabiye
kcg - Tyap
kea - Kabuverdianu
kg - Kongo
khw - Khowar
ki - Kikuyu
kiu - Kirmanjki
kj - Kuanyama
kjh - Khakas
kjp - Eastern Pwo
kk - Kazakh
kk-arab - Kazakh (Arabic script)
kk-cn - Kazakh (China)
kk-cyrl - Kazakh (Cyrillic script)
kk-kz - Kazakh (Kazakhstan)
kk-latn - Kazakh (Latin script)
kk-tr - Kazakh (Turkey)
kl - Kalaallisut
km - Khmer
kn - Kannada
ko - Korean
ko-kp - Korean (North Korea)
koi - Komi-Permyak
kr - Kanuri
krc - Karachay-Balkar
kri - Krio
krj - Kinaray-a
krl - Karelian
ks - Kashmiri
ks-arab - Kashmiri (Arabic script)
ks-deva - Kashmiri (Devanagari script)
ksh - Colognian
ksw - S'gaw Karen
ku - Kurdish
ku-arab - Kurdish (Arabic script)
ku-latn - Kurdish (Latin script)
kum - Kumyk
kus - Kʋsaal
kv - Komi
kw - Cornish
ky - Kyrgyz
la - Latin
lad - Ladino
lb - Luxembourgish
lbe - Lak
lez - Lezghian
lfn - Lingua Franca Nova
lg - Ganda
li - Limburgish
lij - Ligurian
liv - Livonian
lki - Laki
lld - Ladin
lmo - Lombard
ln - Lingala
lo - Lao
loz - Lozi
lrc - Northern Luri
lt - Lithuanian
ltg - Latgalian
lus - Mizo
luz - Southern Luri
lv - Latvian
lzh - Literary Chinese
lzz - Laz
mad - Madurese
mag - Magahi
mai - Maithili
map-bms - Basa Banyumasan
mdf - Moksha
mg - Malagasy
mh - Marshallese
mhr - Eastern Mari
mi - Māori
min - Minangkabau
mk - Macedonian
ml - Malayalam
mn - Mongolian
mnc - Manchu
mnc-latn - Manchu (Latin script)
mnc-mong - Manchu (Mongolian script)
mni - Manipuri
mnw - Mon
mo - Moldovan
mos - Mossi
mr - Marathi
mrh - Mara
mrj - Western Mari
ms - Malay
ms-arab - Malay (Jawi script)
mt - Maltese
mus - Muscogee
mwl - Mirandese
my - Burmese
myv - Erzya
mzn - Mazanderani
na - Nauru
nah - Nāhuatl
nan - Min Nan Chinese
nap - Neapolitan
nb - Norwegian Bokmål
nds - Low German
nds-nl - Low Saxon
ne - Nepali
new - Newari
ng - Ndonga
nia - Nias
niu - Niuean
nl - Dutch
nl-informal - Dutch (informal address)
nmz - Nawdm
nn - Norwegian Nynorsk
no - Norwegian
nod - Northern Thai
nog - Nogai
nov - Novial
nqo - N’Ko
nrm - Norman
nso - Northern Sotho
nv - Navajo
ny - Nyanja
nyn - Nyankole
nys - Nyungar
oc - Occitan
ojb - Northwestern Ojibwa
olo - Livvi-Karelian
om - Oromo
or - Odia
os - Ossetic
pa - Punjabi
pag - Pangasinan
pam - Pampanga
pap - Papiamento
pcd - Picard
pcm - Nigerian Pidgin
pdc - Pennsylvania German
pdt - Plautdietsch
pfl - Palatine German
pi - Pali
pih - Norfuk / Pitkern
pl - Polish
pms - Piedmontese
pnb - Western Punjabi
pnt - Pontic
prg - Prussian
ps - Pashto
pt - Portuguese
pt-br - Brazilian Portuguese
pwn - Paiwan
qu - Quechua
qug - Chimborazo Highland Quichua
rgn - Romagnol
rif - Riffian
rki - Arakanese
rm - Romansh
rmc - Carpathian Romani
rmy - Vlax Romani
rn - Rundi
ro - Romanian
roa-tara - Tarantino
rsk - Pannonian Rusyn
ru - Russian
rue - Rusyn
rup - Aromanian
ruq - Megleno-Romanian
ruq-cyrl - Megleno-Romanian (Cyrillic script)
ruq-latn - Megleno-Romanian (Latin script)
rw - Kinyarwanda
ryu - Okinawan
sa - Sanskrit
sah - Yakut
sat - Santali
sc - Sardinian
scn - Sicilian
sco - Scots
sd - Sindhi
sdc - Sassarese Sardinian
sdh - Southern Kurdish
se - Northern Sami
se-fi - Northern Sami (Finland)
se-no - Northern Sami (Norway)
se-se - Northern Sami (Sweden)
sei - Seri
ses - Koyraboro Senni
sg - Sango
sgs - Samogitian
sh - Serbo-Croatian
sh-cyrl - Serbo-Croatian (Cyrillic script)
sh-latn - Serbo-Croatian (Latin script)
shi - Tachelhit
shi-latn - Tachelhit (Latin script)
shi-tfng - Tachelhit (Tifinagh script)
shn - Shan
shy - Shawiya
shy-latn - Shawiya (Latin script)
si - Sinhala
simple - Simple English
sjd - Kildin Sami
sje - Pite Sami
sk - Slovak
skr - Saraiki
skr-arab - Saraiki (Arabic script)
sl - Slovenian
sli - Lower Silesian
sm - Samoan
sma - Southern Sami
smn - Inari Sami
sms - Skolt Sami
sn - Shona
so - Somali
sq - Albanian
sr - Serbian
sr-ec - Serbian (Cyrillic script)
sr-el - Serbian (Latin script)
srn - Sranan Tongo
sro - Campidanese Sardinian
ss - Swati
st - Southern Sotho
stq - Saterland Frisian
sty - Siberian Tatar
su - Sundanese
sv - Swedish
sw - Swahili
syl - Sylheti
szl - Silesian
szy - Sakizaya
ta - Tamil
tay - Tayal
tcy - Tulu
tdd - Tai Nuea
te - Telugu
tet - Tetum
tg - Tajik
tg-cyrl - Tajik (Cyrillic script)
tg-latn - Tajik (Latin script)
th - Thai
ti - Tigrinya
tk - Turkmen
tl - Tagalog
tly - Talysh
tly-cyrl - Talysh (Cyrillic script)
tn - Tswana
to - Tongan
tok - Toki Pona
tpi - Tok Pisin
tr - Turkish
tru - Turoyo
trv - Taroko
ts - Tsonga
tt - Tatar
tt-cyrl - Tatar (Cyrillic script)
tt-latn - Tatar (Latin script)
tum - Tumbuka
tw - Twi
ty - Tahitian
tyv - Tuvinian
tzm - Central Atlas Tamazight
udm - Udmurt
ug - Uyghur
ug-arab - Uyghur (Arabic script)
ug-latn - Uyghur (Latin script)
uk - Ukrainian
ur - Urdu
uz - Uzbek
uz-cyrl - Uzbek (Cyrillic script)
uz-latn - Uzbek (Latin script)
ve - Venda
vec - Venetian
vep - Veps
vi - Vietnamese
vls - West Flemish
vmf - Main-Franconian
vmw - Makhuwa
vo - Volapük
vot - Votic
vro - Võro
wa - Walloon
wal - Wolaytta
war - Waray
wls - Wallisian
wo - Wolof
wuu - Wu Chinese
wuu-hans - Wu Chinese (Simplified)
wuu-hant - Wu Chinese (Traditional)
xal - Kalmyk
xh - Xhosa
xmf - Mingrelian
xsy - Saisiyat
yi - Yiddish
yo - Yoruba
yrl - Nheengatu
yue - Cantonese
yue-hans - Cantonese (Simplified)
yue-hant - Cantonese (Traditional)
za - Zhuang
zea - Zeelandic
zgh - Standard Moroccan Tamazight
zh - Chinese
zh-cn - Chinese (China)
zh-hans - Simplified Chinese
zh-hant - Traditional Chinese
zh-hk - Chinese (Hong Kong)
zh-mo - Chinese (Macau)
zh-my - Chinese (Malaysia)
zh-sg - Chinese (Singapore)
zh-tw - Chinese (Taiwan)
zu - Zulu
Format
Export for off-line translation
Export in native format
Export in CSV format
Fetch
{{DISPLAYTITLE:Udtryksmanager}}<languages /> __TOC__ <div class="simplebox">Bemærk: Denne funktion er kun tilgængelig i LimeSurvey 1.92 eller nyere.</div> =Quick Start Tutorial= <span id="Overview"></span> ==Oversigt== Når du tilpasser dine undersøgelser, har du typisk brug for en måde at specificere følgende på: #'''Navigation/Branching''' - at lade et emnes svar ændre rækkefølgen, som spørgsmålene stilles i #'''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 <span id="Relevance_(Controlling_Navigation/Branching)"></span> ==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). [[File:tutorial1.jpg]] Relevans vises og kan redigeres følgende steder: <span id="Viewing_/_Editing_Question-Level_Relevance"></span> ===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. [[File:tutorial2.jpg]] Dette er redigeringsskærmen for BMI-spørgsmålet. [[File:tutorial3.jpg]] Bemærk, at du ikke bruger de krøllede klammeparenteser, når du indtaster en relevansligning. <span id="Viewing_/_Editing_Group-Level_Relevance"></span> ===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). [[File:tutorial4.jpg]] 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: [[File:tutorial5.jpg]] Bemærk, at du ikke bruger de krøllede klammeparenteser, når du indtaster en relevansligning. <span id="Tailoring/Piping"></span> ==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<nowiki> [</nowiki> Produkt]. Hvad kunne du bedst lide ved det?". Nogle gange har du brug for betinget substitution som "<nowiki> [</nowiki> Hr og Fru.]<nowiki> [</nowiki> 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. <span id="Conditional_Equations"></span> ===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. [[File:tailoring7.jpg]] 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 [[File:tailoring8.jpg]] Fra redigeringsvinduet for dette spørgsmål kan du se to ting: #Tiloring skal omgive udtryk med Curly Braces #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. [[File:tailoring9.jpg]] <span id="Tailored_Questions,_Answers,_and_Reports"></span> ===Skræddersyede spørgsmål, svar og rapporter=== <div class="simplebox">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<nowiki></nowiki> <span>tag, som ikke er gyldigt i udvalgte muligheder.</span> Dette eksempel viser BMI-rapporten. [[File:tailoring10.jpg]] Her er redigeringsvinduet for det samme spørgsmål. [[File:tailoring11.jpg]] 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. [[File:tailoring12.jpg]] 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. [[Expression Manager sample surveys|Sample Surveys]] sider viser mange fungerende eksempler på brug af udtryk til valideringer. <span id="Introduction"></span> =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== #'''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. #'''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. #'' '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 #'''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" #'''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. <span id="Do_I_have_to_use_EM?"></span> ==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. <span id="Can_I_mix_use_of_Conditions_and_Relevance?"></span> ==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. <span id="How_should_I_choose_between_Conditions_and_Relevance?"></span> ==Hvordan skal jeg vælge mellem betingelser og relevans?== Her er en liste over fordele og ulemper ved hver stil: {| class="wikitable" !Style!!Fordele!!Udele |- |Betingelser||1. God GUI til at skabe enkle forhold<br/> 2. GUI veldokumenteret og forstået af supportteam||1. Understøtter kun simple sammenligninger og AND/ELLER betingelser godt<br/> 2. Kaskadeforhold fungerer uregelmæssigt<br/> 3. Langsom - databaseintensiv, kan derfor bremse lange undersøgelser<br/> 4. Nogle rapporterede problemer med genindlæsningsforhold<br/> 5. GUI skalerer ikke godt, når der er snesevis, hundredvis eller tusindvis af spørgsmål<br/> 6. Kan være langsom til at konvertere papirbaserede undersøgelser, da de skal bruge SGQA-navne<br/> 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<br/> 2. Perfekt støtte til cascading logik<br/> 3. Hurtigt - ingen ekstra databasekald, så understøtter 1000+ spørgsmålsundersøgelser<br/> 4. Ingen problemer med at genindlæse logik, da det ikke kræver SGQA-koder<br/> 5. Syntaks-fremhævning skalerer til 1000+ spørgsmålsundersøgelser<br/> 6. Nem og hurtig at bruge for grupper, der ønsker at computerisere eksisterende papirbaserede suveys.<br/> 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<br/> 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. <span id="What_are_some_other_benefits_of_using_EM?"></span> ==Hvad er nogle andre fordele ved at bruge EM?== Her er nogle af de andre grunde til, at du måske vil bruge EM. #Beregninger - du kan lave enhver beregning, du kan tænke på: #*Du har adgang til alle almindelige matematiske operatorer og funktioner #* Du har adgang til mere end 70 matematiske, dato- og strengbehandlingsfunktioner #*Det er ret nemt for udviklere at tilføje nye funktioner, hvis brugerne har brug for dem #Storing Calculations to Database #*Du kan nu beregne enkle og komplekse beregninger og/eller skalaer, OG få dem gemt i databasen uden brug af JavaScript. #*Du bruger spørgsmålstypen Ligning til at opnå dette. #Assessments #*Du kan nu oprette vurderinger eller skala score fra enhver spørgsmålstype, ikke kun den delmængde, der plejede at blive understøttet #*Du kan bruge skræddersyet til at vise løbende eller samlede vurderingsresultater, hvor som helst det er nødvendigt - selv på samme side #*Du har mere kontrol over de rapporter, der er genereret baseret på disse vurderingsresultater #*Du kan gemme vurderingsresultater i databasen uden at skulle bruge JavaScript #*Du kan skjule vurderingsresultater uden at skulle bruge JavaScript eller CSS #Replacement Fields # *I stedet for at bruge {INSERTANS:SGQA} kan du bare bruge Spørgsmålskoden - dette gør det nemmere at læse og validere. #*Dette undgår også det almindelige behov for at redigere spørgsmål for at ændre SGQA-koden for at få alt til at fungere . #Tailoring - du kan betinget vise tekst baseret på andre værdier #*Brug den passende titel til et emne, som (f.eks. "Hej<nowiki> [</nowiki> Mr./Mrs.] Smith") #*Output grammatisk korrekte sætninger baseret på ental/plural materie: (f.eks. "Du har 1 barn" vs. "Du har 2 børn") #*Bøjte verber passende og afvis navneord baseret på emnets køn og flertal. #New Variable Attributes - du kan få adgang til følgende for at skræddersy: #* (ingen suffiks) - et alias for qcode.code #*. kode - den valgte svarkode for spørgsmålet, hvis det er relevant (ellers tomt), eller tekstværdien, hvis det ikke er et kodet spørgsmål #*.NAOK - samme som .kode, men kan indgå i beregninger eller lister selvom det er irrelevant #*.value - vurderingsværdien for spørgsmålet, hvis det er relevant (ellers blank), eller tekstværdien, hvis det ikke er et kodet spørgsmål -- tilgængelige er vurderinger aktiveret for undersøgelsen, ellers altid nul #*.valueNAOK - samme som .value, men kan være en del af beregninger eller lister, selvom det er irrelevant #*.vist - svaret som vist for brugeren (det er hvad {INSERTANS:xxx} gør ) #*.qid - spørgsmåls-ID #*.gid - gruppe-ID #*.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ålssekvensen (startende fra 0) #*.gseq - gruppesekvensen (startende fra 0) #*. obligatorisk - om spørgsmålet er obligatorisk (J/N) #*.spørgsmål - spørgsmålets tekst #*.relevans - relevansligningen for spørgsmålet #*.grelevance - relevansligningen for gruppen #*.relevanceStatus - om spørgsmålet er relevant eller ej (boolesk (kan være forskellig i PHP og JS)) #*.type - spørgsmålstypen (en-tegnskoden)!N !#Dynamiske ændringer på siden #*Al relevans, beregning og tilpasning fungerer dynamisk på en side - så ændringer i værdier opdaterer siden øjeblikkeligt #*Så du har spørgsmål dynamisk vises/forsvinder baseret på, om de er relevante #*Spørgsmål er også dynamisk skræddersyet baseret på svar på siden, så du kan se løbende totaler, skræddersyede sætninger og tilpassede rapporter. #New Data Entry Screen #*Ud over at bruge det nuværende dataindtastningssystem, kan du bare bruge Survey-All-In-One. #*Dette understøtter relevansen på siden og skræddersyet, så dataindtastningsassistenter kan hurtigt gå igennem, og de skal kun indtaste relevante svar #*Dette kan være afgørende, hvis din dataindtastningsperson har brug for at se skræddersyet, som også er dynamisk. #Eliminerer behovet for de fleste tilpassede JavaScript #*EM understøtter nemt komplicerede beregninger, scoring , skræddersyet og betinget logik. #*Nogle ting vil stadig have JavaScript (som brugerdefinerede layouts og betinget skjule spørgsmåls underelementer), men din JavaScript kan bruge EM-funktionerne, så du kan få adgang til spørgsmål ved deres Qcode i stedet for SGQA , og få adgang til en af de spørgsmålsegenskaber, der er angivet ovenfor. <span id="What_are_some_other_helpful_new_features_enabled_by_EM?"></span> ==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: #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. #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). #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. #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. #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. #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 <span id="Getting_Started"></span> =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 [[ExpressionScript-eksempelundersøgelserne|eksempelundersøgelserne]]. *Udforsk [[ExpressionScript How-tos|use cases and HowTos]] og [[ExpressionScript-eksempler|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. <span id="What_Functionality_does_Expression_Manager_Extend/Replace?_(LimeSurvey_<=_1.91+)"></span> =Hvilken funktionalitet udvider/erstater Expression Manager? (LimeSurvey <= 1,91+)= <span id="Conditions_=>_Relevance"></span> ==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. <span id="Assessments_=>_Equations_and_Micro-Tailoring"></span> ==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. <span id="Replacements_=>_Micro-Tailoring"></span> ==Udskiftninger => Mikroskræddersyet== Brugere kunne skræddersy nogle beskeder og spørgsmål baseret på tidligere svar. For eksempel kan et spørgsmål være, ''{TOKEN:FIRSTNAME}, du sagde, at {INSERTANS:111X3X4} var din yndlingssport''. Det var dog ikke muligt at lave betinget skræddersyning (som at sige "Hr." eller "Fru." afhængigt af personens køn), eller konjugere verber eller afvise navneord uden fancy JavaScript. Forfattere kunne implementere undersøgelser, der syntes at skræddersy spørgsmål, men det krævede separate spørgsmål for hver permutation og komplekse betingelser for at beslutte, hvilke spørgsmål der skulle vises. ==Validation== Spørgsmålet kunne valideres med regulære udtryk eller minimum/maksimum værdier, eller lade et SGQA svar tjene som minimum eller maksimum værdi. Valideringer kunne dog ikke baseres på beregninger af andre variabler uden fancy JavaScript. <span id="Equations"></span> ==Ligninger== Ligninger blev ikke understøttet uden fancy JavaScript. <span id="Equation_Question_Type"></span> ==Ligningsspørgsmålstype== Ligninger kunne ikke gemmes i databasen (f.eks. den endelige score for en vurdering) uden fancy JavaScript. <span id="How_Will_Expression_Manager_Replace/Extend_That_Functionality?"></span> =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å. <span id="New_Terminology_When_Referring_to_Expression_Manager_(EM)"></span> ==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. <span id="Relevance_and_Cascading_Relevance"></span> ===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: {| class="wikitable" !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. <span id="Group-Level_Relevance"></span> ===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. <span id="Tailoring_/_Piping"></span> ===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: #Vis betinget skræddersyede beskeder til respondenterne baseret på tidligere svar #Opret vurderinger og vis vurderingsresultater (eller betinget forgrening eller vis beskeder) baseret på disse resultater, alt uden at bruge selve vurderingsmodulet #Konjuger verber og afvis navneord i spørgsmål, svar og rapporter. #Vis sammendrag af svar før siden "Vis dine svar" i slutningen af undersøgelsen <span id="Equations"></span> ===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 <span id="Syntax"></span> ==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: <syntaxhighlight lang="java">{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', '' ) ) ) ) ) ) ) )} </syntaxhighlight> <div id="EMsyntax">Expression Manager understøtter følgende syntaks:</div> *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) <span id="Operators"></span> === Operatører === EM-syntaks følger normal operatorprioritet: {| class="wikitable" !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 |} <span id="Warning_with_plus_operator_(+)"></span> ==== 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). <span id="Warning_with_mismatch_between_number_and_string_and_alphabetic_comparison"></span> ==== 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 <code>"</code> , vil det tvinge sammenligningen som tekst (alfabetisk sammenligning). Hvis du vil sammenligne numerisk, omgiv aldrig tallet med anførselstegn, <code>"</code> . For eksempel er <code>Q0.NAOK > "50"</code> sandt, hvis Q0.NAOK er et numerisk spørgsmål med 9 som værdi. Dette skyldes, at operatoren <code>></code> vil antage, at det er alfabetisk sammenligning og ikke numerisk. <div class="mw-translate-fuzzy"> For at være sikker på at sammenligne heltalsværdier, kan du bruge <code>[[Expression_Manager#Implemented_Functions|intval]](Q0.NAOK) > 50</code> , 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 [[Expression_Manager#Implemented_Functions|strcmp]] direkte : <code>strcmp(Q0.NAOK,"B")</code> eller <code>strcmp(Q0.NAOK,"A5")</code> . </div> <span id="Caution_about_using_Assignment_Operator_(=)"></span> ===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. {{Alert|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 ….}} {{Alert|Hvis du ikke bruger en [[Question_type_-_Equation|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 [[Question_type_-_Equation|equation question]].}} Et eksempel: * Indstil svar på et kort tekstspørgsmål med små bogstaver: <code>{QCODE=strtolower(QCODE.NAOK)}</code> * Indstil et standardsvar til en matrixspørgsmålstype ved starten af en undersøgelse: <code>{Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}</code> * Indstil et standardsvar til en array-tekstspørgsmålstype ved starten af en undersøgelse: <code>{Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}</code> * Indstil et svar med betingelse: <code>{QCODE=if(YesNo="Y","A1","")}</code> <span id="XSS_security"></span> == 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 * <code>{if( 1 ,"<strong>","")}information{if( 1 ,"</strong>","")}</code> er brudt med XSS-sikkerhed, her kan du bruge <code>{if(1," <strong>information</strong>","information")}</code> * <code><a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a></code> , here you can use an equation question because using a complete question code is OK : <code><a href="/script.php?value={EQUATION.NAOK}">next</a></code></code> <strong>information</strong>","information")}</code> <code>{if(1," * <code><a href="/script.php?value={if(QCODE == "Y","yes","no")}">next</a></code> , here you can use an equation question because using a complete question code is OK : <code><a href="/script.php?value={EQUATION.NAOK}">next</a></code></code> <span id="Access_to_Variables"></span> ==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). *[[Tilføjelse af en question#Information_from_previous_answers|INSERTANS:SGQA]] - visningsværdien af et svar (f.eks. "Ja"). For Expression Manager er det det samme som ved at bruge {QCODE.shown}. *Alle [[The_template_editor#Keywords|{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. <div class='simplebox'> '''Vigtigt:''' Det er kun sikkert at henvise til variabler, der forekommer på foregående sider eller spørgsmål. </div> Ydermere giver Expression Manager dig adgang til mange egenskaber for spørgsmålet: {| class="wikitable" !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' |} <span id="HTML_editor_issue"></span> === HTML-editor problem=== {{Alert|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 >= <span id="Qcode_Variable_Naming"></span> ==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: Spørgsmålskode. '_'. Underspørgsmåls-ID. '_'. ScaleId For '''kommentar''' og '''andet''' er spørgsmålskoden QuestionCode_comment og QuestionCode_other {| class="wikitable" !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||L1-L6| |1-10|| ||{Q2_L2}||{Q2_L2.shown}||{Q2_L2==7} |- |A||Array (5 Point Choice) Radio-knapper||Q3||1-5| |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||F1-F5| |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||AF, andet| | || ||{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'} |} <span id="The_reserved_'this',_'self',_and_'that'_variables"></span> ==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|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. <span id="Usage_of_NAOK"></span> ==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|Overriding Cascading Conditions]] <span id="Access_to_Functions"></span> ==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. <span id="Implemented_Functions"></span> ===Implementerede funktioner=== Følgende funktioner er i øjeblikket tilgængelige: {| class="wikitable" !Function!!Meaning!!Syntax |- |[http://www.php.net/manual/en/function.abs.php abs]||Absolute value||number abs(number) |- |[http://www.php.net/manual/en/function.acos.php acos]||Arc cosine||number acos(number) |- |[http://www.php.net/manual/en/function.addslashes.php addslashes]||Quote string with slashes||string addslashes(string) |- |[http://www.php.net/manual/en/function.asin.php asin]||Arc sine||number asin(number) |- |[http://www.php.net/manual/en/function.atan.php atan]||Arc tangent||number atan(number) |- |[http://www.php.net/manual/en/function.atan2.php atan2]||Arc tangent of two variables||number atan2(number, number) |- |[http://www.php.net/manual/en/function.ceil.php ceil]||Round fractions up||number ceil(number) |- |[http://www.php.net/manual/en/function.checkdate.php 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) |- |[http://www.php.net/manual/en/function.cos.php 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) |- |[http://www.php.net/manual/en/function.date.php date]||Format a local date/time||string date(format <nowiki>[</nowiki>, timestamp=time()]) |- |[http://www.php.net/manual/en/function.exp.php exp]||Calculates the exponent of e||number exp(number) |- |fixnum||Display numbers with comma as radix separator, if needed||string fixnum(number) |- |[http://www.php.net/manual/en/function.floor.php floor]||Round fractions down||number floor(number) |- |[http://www.php.net/manual/en/function.gmdate.php gmdate]||Format a GMT date/time||string gmdate(format <nowiki>[</nowiki>, timestamp=time()]) |- |[http://www.php.net/manual/en/function.html-entity-decode.php html_entity_decode]||Convert all HTML entities to their applicable characters (always uses ENT_QUOTES and UTF-8)||string html_entity_decode(string) |- |[http://www.php.net/manual/en/function.htmlentities.php htmlentities]||Convert all applicable characters to HTML entities (always uses ENT_QUOTES and UTF-8)||string htmlentities(string) |- |[http://www.php.net/manual/en/function.htmlspecialchars.php expr_mgr_htmlspecialchars]||Convert special characters to HTML entities (always uses ENT_QUOTES and UTF-8)||string htmlspecialchars(string) |- |[http://www.php.net/manual/en/function.htmlspecialchars-decode.php expr_mgr_htmlspecialchars_decode]||Convert special HTML entities back to characters (always uses ENT_QUOTES and UTF-8)||string htmlspecialchars_decode(string) |- |[http://www.php.net/manual/en/function.idate.php idate]||Format a local time/date as integer||string idate(string <nowiki>[</nowiki>, timestamp=time()]) |- |if{{UpdatedIn|3.0.2}}||Excel-style if(test,result_if_true<nowiki>[</nowiki>,result_if_false = ""<nowiki>]</nowiki>)||if(test,result_if_true<nowiki>[</nowiki>,result_if_false = ""<nowiki>]</nowiki>) |- |[http://www.php.net/manual/en/function.implode.php implode]||Join array elements with a string||string implode(glue,arg1,arg2,...,argN) |- |[http://www.php.net/manual/en/function.intval.php intval]||Get the integer value of a variable||int intval(number <nowiki>[</nowiki>, base=10]) |- |[http://www.php.net/manual/en/function.empty.php is_empty]||Determine whether a variable is considered to be empty||bool is_empty(var) |- |[http://www.php.net/manual/en/function.is-float.php is_float]||Finds whether the type of a variable is float||bool is_float(var) |- |[http://www.php.net/manual/en/function.is-int.php is_int]||Find whether the type of a variable is integer||bool is_int(var) |- |[http://www.php.net/manual/en/function.is-nan.php is_nan]||Finds whether a value is not a number||bool is_nan(var) |- |[http://www.php.net/manual/en/function.is-null.php is_null]||Finds whether a variable is NULL||bool is_null(var) |- |[http://www.php.net/manual/en/function.is-numeric.php is_numeric]||Finds whether a variable is a number or a numeric string||bool is_numeric(var) |- |[http://www.php.net/manual/en/function.is-string.php is_string]||Find whether the type of a variable is string||bool is_string(var) |- |join{{NewIn|2.0|b=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{{NewIn|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) |- |[http://www.php.net/manual/en/function.log.php log]|| The logarithm of number to base, if given, or the natural logarithm. ||number log(number,base=e) |- |[http://www.php.net/manual/en/function.ltrim.php ltrim]||Strip whitespace (or other characters) from the beginning of a string||string ltrim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.max.php max]||Find highest value||number max(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.min.php min]||Find lowest value||number min(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.mktime.php 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) |- |[http://www.php.net/manual/en/function.nl2br.php nl2br]||Inserts HTML line breaks before all newlines in a string||string nl2br(string) |- |[http://www.php.net/manual/en/function.number-format.php number_format]||Format a number with grouped thousands||string number_format(number) |- |pi||Get value of pi||number pi() |- |[http://www.php.net/manual/en/function.pow.php pow]||Exponential expression||number pow(base, exp) |- |[http://www.php.net/manual/en/function.quoted-printable-decode.php quoted_printable_decode]||Convert a quoted-printable string to an 8 bit string||string quoted_printable_decode(string) |- |[http://www.php.net/manual/en/function.quoted-printable-encode.php quoted_printable_encode]||Convert a 8 bit string to a quoted-printable string||string quoted_printable_encode(string) |- |[http://www.php.net/manual/en/function.quotemeta.php quotemeta]||Quote meta characters||string quotemeta(string) |- |[http://www.php.net/manual/en/function.rand.php rand]||Generate a random integer, see [[Expression Manager sample surveys#Randomly Ask One Question Per Group|this example]]||int rand() OR int rand(min, max) |- |regexMatch||compare a string to a [[Using regular expressions|regular expression]]||bool regexMatch(pattern,input) |- |[http://www.php.net/manual/en/function.round.php round]||Rounds a number to an optional precision||number round(val <nowiki>[</nowiki>, precision]) |- |[http://www.php.net/manual/en/function.rtrim.php rtrim]||Strip whitespace (or other characters) from the end of a string||string rtrim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.sin.php sin]||Sine||number sin(arg) |- |[http://www.php.net/manual/en/function.sprintf.php sprintf]||Return a formatted string||string sprintf(format, arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.sqrt.php sqrt]||Square root||number sqrt(arg) |- |stddev||Calculate the Sample Standard Deviation for the list of numbers||number stddev(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.str-pad.php str_pad]||Pad a string to a certain length with another string||string str_pad(input, pad_length <nowiki>[</nowiki>, pad_string]) |- |[http://www.php.net/manual/en/function.str-repeat.php str_repeat]||Repeat a string||string str_repeat(input, multiplier) |- |[http://www.php.net/manual/en/function.str-replace.php str_replace]||Replace all occurrences of the search string with the replacement string||string str_replace(search, replace, subject) |- |[http://www.php.net/manual/en/function.strcasecmp.php strcasecmp]||Binary safe case-insensitive string comparison||int strcasecmp(str1, str2) |- |[http://www.php.net/manual/en/function.strcmp.php strcmp]||Binary safe string comparison||int strcmp(str1, str2) |- |[http://www.php.net/manual/en/function.strip-tags.php strip_tags]||Strip HTML and PHP tags from a string||string strip_tags(str, allowable_tags) |- |[http://www.php.net/manual/en/function.stripos.php stripos]||Find position of first occurrence of a case-insensitive unicode string (starting by 0, return false if not found)|||int stripos(haystack, needle <nowiki>[</nowiki>, offset=0]) |- |[http://www.php.net/manual/en/function.stripslashes.php stripslashes]||Un-quotes a quoted string||string stripslashes(string) |- |[http://www.php.net/manual/en/function.stristr.php stristr]||Case-insensitive strstr||string stristr(haystack, needle <nowiki>[</nowiki>, before_needle=false]) |- |[http://www.php.net/manual/en/function.strlen.php strlen]||Get string length||int strlen(string) |- |[http://www.php.net/manual/en/function.strpos.php strpos]||Find position of first occurrence of an unicode string (starting by 0, return false if not found)||int strpos(haystack, needle <nowiki>[</nowiki> offset=0]) |- |[http://www.php.net/manual/en/function.strrev.php strrev]||Reverse a string||string strrev(string) |- |[http://www.php.net/manual/en/function.strstr.php strstr]||Find first occurrence of a string||string strstr(haystack, needle<nowiki>[</nowiki>, before_needle=false]) |- |[http://www.php.net/manual/en/function.strtolower.php strtolower]||Make a string lowercase||string strtolower(string) |- |[http://www.php.net/manual/en/function.strtotime.php strtotime]||Parse about any English textual datetime description into a Unix timestamp||int strtotime(string) |- |[http://www.php.net/manual/en/function.strtoupper.php strtoupper]||Make a string uppercase||string strtoupper(string) |- |[http://www.php.net/manual/en/function.substr.php substr]||Return part of an unicode string||string substr(string, start <nowiki>[</nowiki>, 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) |- |[http://www.php.net/manual/en/function.tan.php tan]||Tangent||number tan(arg) |- |[http://www.php.net/manual/en/function.time.php time]||Return current UNIX timestamp||number time() |- |[http://www.php.net/manual/en/function.trim.php trim]||Strip whitespace (or other characters) from the beginning and end of a string||string trim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.ucwords.php 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) |} <span id="Functions_that_are_Planned_or_Being_Considered"></span> ===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. {| class="wikitable" !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)|| [[ExpressionAnswerOptions|Kerneplugin ExpressionAnswerOptions]] || |- |getAnsOption(X,Y)|| [[ExpressionAnswerOptions|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 <strike>og omgå dermed tidligere besvarede spørgsmål,</strike> dette overtræder systemets normale flow|| |- | lastIndexOf(X,Y)||returnerer det sidste indeks (base 0) af streng Y i streng X. Returnerer -1, hvis Y ikke er indeholdt i X| |- |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.|| |} <span id="Expression_Manager_Knows_Which_Variables_are_Local"></span> ==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). <span id="Cascading_Conditions"></span> ==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 {| class="wikitable" !Operator!!Eksempel!!a!!b!!Resultat |- |<nowiki> + (ulært)</nowiki> ||<nowiki> +a</nowiki> ||N/A|| ||false |- |- (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 |- |<nowiki> +</nowiki> ||a + 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 |- |(exp) op (exp)| |(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 |} <span id="Overriding_Cascading_Conditions"></span> ===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 #q1 er ikke tilføjet til LEManyNA()-sætningen #LEMval('q1') vil fortsætte med at kontrollere, om svaret er relevant, og vil vende tilbage<nowiki> ''</nowiki> 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. <span id="How_does_Expression_Manager_Support_Conditional_Micro-Tailoring?"></span> ==Hvordan understøtter Expression Manager Conditional Micro-Tailoring?== Her er et eksempel på mikro-skræddersyning (hvor spørgsmålstype=='udtr.' betyder en ligning): {| class="wikitable" !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||forældre| |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<nowiki></nowiki> <span>element. Hver gang en værdi ændres, genberegner den det udtryk, der skal vises i den</span><nowiki></nowiki> <span><span>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.</span></span> <span id="Mapping_of_LimeSurvey_1.91+_to_Expression_Manager_Functionality"></span> ==Kortlægning af LimeSurvey 1.91+ til Expression Manager-funktionalitet== {| class="wikitable" !Gammel funktion!!Ny funktion!!Kommentarer |- |Betingelser||Relevans||Du kan bruge meget komplekse betingede ligninger og få adgang til et bredere udvalg af variabler!N !|- |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 |} <span id="Syntax_Highlighting"></span> =Syntaksfremhævning= For at hjælpe med at indtaste og validere udtryk tilbyder EM syntaksfremhævning med følgende funktioner: <span id="Types_and_Meanings_of_Syntax_Highlighting"></span> ==Typer og betydninger af syntaksfremhævning== {| class="wikitable" !Farve!!Eksempel!!Betydning!!Værktøjstip!!Kommentarer |- |tan baggrund||style='baggrundsfarve: #eee8aa'|Eksempel||den hel ligning||ingen||Alt inden for krøllede klammeparenteser, der genkendes som en ligning (der er f.eks. ingen indledende eller efterstillede hvidt tempo) vil blive farvekodet med en solbrun baggrund for at hjælpe med at skelne det fra omgivende tekst |- |fed rød tekst||style='color:#ff0000; background-color:#eee8aa'|'''Sample'''||En fejl||Nogle forklaring på fejl||Kan være en ukendt variabel eller en funktionsfejl, .... Undersøgelsen kan være fuldstændig brudt, dette ikke 't show to public user. |- |blue text||style='color:#0000ff; background-color:#eee8aa'|Eksempel||funktionsnavn||betydning og tilladte syntaks||funktionsnavne, eller ting, der burde være funktioner, da de efterfølges af en indledende parentes, vises med fed blå tekst. Værktøjstip viser betydningen og den tilladte syntaks for funktionen. |- |grå tekst||style='color:#808080; background-color:#eee8aa'|Eksempel||streng||ingen||enkelte og dobbelte citerede strenge vises i grå tekst |- |cyan tekst||style='color:#4169e1; baggrundsfarve:#eee8aa'|Eksempel||variabelsæt på samme side,||<nowiki> [</nowiki> navn eller SGQA-kode]: spørgsmål; værdi; svarliste, der viser koder for hver værdi||Enhver variabel, der er indstillet på samme side til det aktuelle spørgsmål, vises i cyan tekst, hvilket viser, at den kan opdateres i javascript. Værktøjstippet viser dets navn (hvis du brugte INSERTANS:xxx) eller SGQA-kode (hvis du brugte det nye navnesystem), det faktiske spørgsmål og dets aktuelle værdi (eller blank, hvis den ikke er angivet). Hvis spørgsmålstypen forventer svar fra et opregnet værdisæt, vises tilknytningen af koderne til visningsværdier. |- |grøn tekst||style='color:#008000; baggrundsfarve:#eee8aa'|Eksempel||variabelsæt på en tidligere side||<nowiki> [</nowiki> navn eller SGQA-kode]: spørgsmål; værdi; svarliste, der viser koder for hver værdi||Enhver variabel, der er indstillet på en tidligere side, vises med fed grøn tekst. Værktøjstippet viser dets navn (hvis du brugte INSERTANS:xxx) eller SGQA-kode (hvis du brugte det nye navnesystem), det faktiske spørgsmål og dets aktuelle værdi (eller blank, hvis den ikke er angivet). Hvis spørgsmålstypen forventer svar fra et opregnet værdisæt, vises tilknytningen af koderne til visningsværdier. |- |fed pink text||style='color:#9370db; background-color:#eee8aa'|Eksempel||variabelsæt på en senere side <sup>generelt : tom ved undersøgelsens start, men kan udfyldes med indeks eller flytte forrige</sup> ||<nowiki> [</nowiki> navn eller SGQA-kode]: spørgsmål; værdi; svarliste, der viser koder for hver værdi||Enhver variabel, der er indstillet på en næste side, vises med fed lyserød tekst. Værktøjstippet viser dets navn (hvis du brugte INSERTANS:xxx) eller SGQA-kode (hvis du brugte det nye navnesystem), det faktiske spørgsmål og dets aktuelle værdi (eller blank, hvis den ikke er angivet). Hvis spørgsmålstypen forventer svar fra et opregnet værdisæt, vises tilknytningen af koderne til visningsværdier. |- |fed tan text||style='color:#a0522d; baggrundsfarve:#eee8aa'|Eksempel||en lime-erstatningsværdi||værdien||Lime-erstatningsstrenge (som {TOKEN:xxx}, {PRIVACY_MESSAGE}) vises med fed tan tekst. |- |rød tekst||style='color:#ff4500; background-color:#eee8aa'|Eksempel||tildelingsoperator (=) ||advarselsmeddelelse||Hvis du bruger en af tildelingsoperatorerne (=), vil denne operator blive vist i rød tekst. Dette er beregnet til at hjælpe med at forhindre utilsigtet gentildeling af værdier, når du virkelig havde til hensigt at kontrollere, om a == b i stedet for at indstille værdien af a = b. |- |normal sort tekst||style=' farve:sort; baggrundsfarve:#eee8aa'|Eksempel||tegnsætning||ingen||Al anden tegnsætning i udtrykket vises som normal sort tekst. |- |tekst med rød boks||en fed rød linje omgiver fejlen||syntaksfejl||beskrivelsen af fejlen||Alle opdagede syntaksfejl vises ved at omgive fejlen med et rødt felt. Værktøjstippet viser fejlen. Eksempler inkluderer umatchede parenteser, brug af udefinerede funktioner, videregivelse af det forkerte antal argumenter til funktioner, dårligt strukturerede 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 ikke- variabler eller ved at bruge ikke-understøttet syntaks. Bemærk, at syntaksfejldetekteringssystemet muligvis kun rapporterer én fejl i et udtryk, selvom der er flere fejl; men hvis der opdages fejl, vil mindst én fejl blive vist. |} <span id="Additional_Reading"></span> =Yderligere læsning= <span id="Expression_Manager_sample_surveys"></span> ==[[Expression Manager prøveundersøgelser|Expression Manager prøveundersøgelser]]== <span id="Use_Cases_and_HowTos"></span> ==[[ExpressionScript How-tos|Use Cases og HowTos]]== <span id="Step-by-Step_examples"></span> ==[[ExpressionScript-eksempler|Trin-for-trin-eksempler]]== ==[[StatFunctions|Expression Manager statistic functions]]== <span id="Reference_for_Developers"></span> ==[[Expression Manager for udviklere|Reference for udviklere]]== ==[[Expression Manager roadmap|RoadMap/Status/ToDo List]]==