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:Upravljalnik izrazov}}<languages /> __TOC__ <div class="simplebox"> Opomba: Ta funkcija je dosegljiva v LimeSurvey-u 1.92 ali novejši. </div> <span id="Quick_Start_Tutorial"></span> =Vodnik za hitri začetek= <span id="Overview"></span> ==Pregled== Ko prilagajate svoje ankete, običajno potrebujete način, da določite naslednje: #'''Navigacija/Razvejanje''' – dovolite, da odgovori subjekta spremenijo vrstni red zastavljenih vprašanj #''''Tailoring/ Piping''' - kako ubesediti vprašanje (na primer sklicevanje na prejšnje odgovore ali spreganje stavkov glede na število ali spol vaših predmetov) ali kako ustvariti poročila po meri (kot so rezultati ocenjevanja ali prilagojeni nasveti). #''''Validacija''' – zagotavljanje, da odgovori izpolnjujejo določena merila, kot so najmanjše in največje vrednosti, ali ujemanje z vnosnim vzorcem Expression Manager (EM) ponuja intuitiven način za določanje logike za vsako od teh funkcij. Skoraj vse, kar lahko zapišete kot standardno matematično enačbo, je veljaven izraz, tudi če kličete funkcije. EM trenutno omogoča dostop do 80 funkcij in ga je mogoče enostavno razširiti, da podpira več. Omogoča tudi dostop do vaših spremenljivk z uporabo človeku berljivih imen spremenljivk (namesto imen SGQA). Naslednji razdelki prikazujejo glavna mesta, kjer se uporablja Expression Manager <span id="Relevance_(Controlling_Navigation/Branching)"></span> ==Ustreznost (nadzor navigacije/razvejanje)== Nekatere ankete uporabljajo "Pojdi na logiko", tako da če odgovorite na vprašanje 1 z možnostjo C, potem skočite na vprašanje 5. Ta pristop je zelo omejujoč, saj ga je težko preveriti in se zlahka prekine, ko morate preurediti vprašanja. EM uporablja Boolovo relevantno enačbo za določanje vseh pogojev, pod katerimi bi lahko bilo vprašanje veljavno. Če je vprašanje relevantno, se prikaže vprašanje, sicer ni uporabno, vrednost NULL pa je shranjena v bazi podatkov. To je podobno tistemu, kar lahko storite prek urejevalnika pogojev, vendar vam EM omogoča enostavno določanje veliko bolj zapletenih in zmogljivih kriterijev (in omogoča uporabo imena spremenljivke namesto poimenovanja SGQA). Ta slika prikazuje en način za pregled logike ustreznosti za anketo. Izračunava indeks telesne mase. Enačba ustreznosti je prikazana v oglatem oklepaju takoj za imenom spremenljivke (ki je zelene barve). Torej je ustreznost teže, teže_enot, višine in višine enot 1, kar pomeni, da so ta vprašanja vedno postavljena. Vendar pa je relevantnost za ITM {!is_empty(height) in !is_empty(weight)}, kar pomeni, da bo ITM izračunan samo, če subjekt vnese vrednost za višino in težo (s čimer se izognemo tveganju deljenja z ničlo napaka). Poleg tega je vprašanje Poročilo prikazano samo, če preiskovanec odgovori na vsa štiri glavna vprašanja (višina, višina_enote, teža, teže_enote). [[Datoteka:tutorial1.jpg]] Ustreznost je prikazana in jo je mogoče urejati na naslednjih mestih: <span id="Viewing_/_Editing_Question-Level_Relevance"></span> ===Ogled/urejanje Ustreznost na ravni vprašanja=== Ta enačba izračuna indeks telesne mase (ITM). Vpraša se le, ali oseba najprej vnese svojo višino in težo. [[Datoteka:tutorial2.jpg]] To je zaslon za urejanje vprašanja ITM. [[Datoteka:tutorial3.jpg]] Upoštevajte, da ne uporabite zavitih oklepajev, ko vnašate enačbo ustreznosti. <span id="Viewing_/_Editing_Group-Level_Relevance"></span> ===Ogled/urejanje ustreznosti na ravni skupine=== To je vzorčna popisna raziskava. Prva stran vpraša, koliko ljudi živi z vami, in to shrani v spremenljivko "cohabs". Ta stran je prikazana samo, če imate več kot enega sostanovalca (torej je prikazana za drugo osebo, ki živi z vami), prav tako pa je prikazana samo, če ste navedli, kako je oseba ena povezana z vami (p1_rel). [[Datoteka:tutorial4.jpg]] Kot lahko vidite, ima skupina tudi kriterije ustreznosti na ravni vprašanja, tako da se vsako vprašanje pojavi šele, ko odgovorite na vprašanje pred njim (npr. {!is_empty(p1_sex)}). EM za vas združuje ustreznost na ravni skupine in vprašanja. Vprašanja v skupini se zastavljajo samo, če je pomembna skupina kot celota. Nato se zastavi samo podmnožica vprašanj znotraj skupine, ki so pomembna. Tukaj je zaslon za urejanje ustreznosti na ravni skupine za to vprašanje: [[Datoteka:tutorial5.jpg]] Upoštevajte, da ne uporabite zavitih oklepajev, ko vnašate enačbo ustreznosti. <span id="Tailoring/Piping"></span> ==Krojenje/Piping== EM vam omogoča preprosto in zapleteno pogojno prilagajanje vaših vprašanj. Včasih potrebujete preprosto zamenjavo, na primer: "Rekel si, da si kupil<nowiki> [</nowiki> Izdelek]. Kaj vam je bilo pri tem najbolj všeč?". Včasih potrebujete pogojno zamenjavo, kot je "<nowiki> [</nowiki> Gospod Gospa.]<nowiki> [</nowiki> Priimek], bi bili pripravljeni izpolniti našo anketo?". V tem primeru želite uporabiti g. ali gospa glede na spol osebe. Drugič potrebujete še bolj zapleteno zamenjavo (na primer na podlagi matematičnega izračuna) EM podpira vsako od teh vrst krojenja/cevovodov. <span id="Conditional_Equations"></span> ===Pogojne enačbe=== Primer indeksa telesne mase prikazuje zmožnost izračuna ITM osebe, čeprav ji dovolite, da svojo višino in težo vnese v metričnih ali nemetričnih enotah. [[Datoteka:tailoring7.jpg]] Tu je weight_kg {if(weight_units == 'kg', teža, teža * .453592)}. Ta funkcija if() pomeni, da če je subjekt vnesel težo v kilogramih, uporabite to vrednost, sicer pomnožite vneseno vrednost (ki je bila v funtih) z 0,453592, da jo pretvorite v kilograme. Spremenljivka height_m uporablja podoben pristop za izračun višine osebe v metrih, tudi če je vnesla svojo višino v palcih. ITM izračuna formulo teže kot {teža_kg / (višina_m * višina_m)}. Nazadnje poročilo pogojno prilagodi sporočilo subjektu in mu pove, kaj je vnesel. ("Rekli ste, da ste visoki 2 metra in težki 70 kg.") Čeprav na zgornji sliki ni dobro prikazano, weight_status uporablja ugnezdene stavke if(), da kategorizira osebo kot prenizko telesno težo do zelo debelo. Njegovo enačbo si lahko ogledate v prikazu Logic View [[Datoteka:tailoring8.jpg]] V oknu za urejanje tega vprašanja lahko vidite dve stvari: #Tailoring mora obdati izraze z zavitimi oklepaji #Izrazi lahko zajemajo več vrstic, če želite, kot v tem primeru, olajšati branje ugnezdena pogojna logika. [[Datoteka:tailoring9.jpg]] <span id="Tailored_Questions,_Answers,_and_Reports"></span> ===Prilagojena vprašanja, odgovori in poročila=== <div class="simplebox">Opomba: dinamično prilagajanje morda ne bo delovalo, če so možnosti odgovora na voljo v izbirnih poljih na isti strani z vprašanji. To je posledica dejstva, da krojaški vstavki a<nowiki></nowiki> <span>oznaka, ki ni veljavna znotraj izbranih možnosti.</span> Ta primer prikazuje poročilo ITM. [[Datoteka:tailoring10.jpg]] Tukaj je okno za urejanje istega vprašanja. [[Datoteka:tailoring11.jpg]] Kot lahko vidite, je vse v zavitih oklepajih obravnavano kot izraz, zato je sintaksa poudarjena (barvno kodirana) na prejšnji sliki. Če bi imeli kakršne koli tipkarske napake (na primer napačno črkovana ali nedefinirana imena ali funkcije spremenljivk), bi EM prikazal napako, kot je ta, ki kaže, da je height_unit nedefinirano ime spremenljivke (pravzaprav je height_units), rnd() pa je nedefinirana funkcija (pravilno ime funkcije je round()). V obeh primerih so napake obdane z rdečim poljem, da jih lažje opazimo in odpravimo. [[Datoteka:tailoring12.jpg]] Opazite lahko tudi, da lahko hitro ustvarite kompleksna poročila, kot je tabela vnesenih vrednosti ali prilagojeni nasveti. Zapomnite si, da mora vsako prilagajanje obdati izraze z zavitimi oklepaji, tako da LimeSurvey ve, kateri deli vprašanja so prosto besedilo in katere je treba razčleniti z upraviteljem izrazov. <span id="Validation"></span> ==Potrjevanje== EM nadzoruje, kako deluje večina naprednih možnosti vprašanj. Ti nadzorni vidiki, kot so najmanjše/največje število odgovorov; min/max posamezne vrednosti; min/max vsota vrednosti; in preverjanje, ali se vnesene vrednosti ujemajo z določenimi vzorci nizov. Še naprej vnašate te napredne možnosti vprašanj kot običajno. Vendar pa se zdaj katera koli vrednost v enem od teh polj šteje za izraz, tako da lahko imate minimalna/največja merila s kompleksnimi pogojnimi razmerji do drugih vprašanj. V vseh teh primerih, ker se možnost naprednega vprašanja vedno obravnava kot izraz, pri določanju ne uporabite zavitih oklepajev. Strani [[Vzorčne ankete upravitelja izrazov|Vzorčne ankete]] prikazujejo številne delujoče primere uporabe izrazov za validacije. <span id="Introduction"></span> =Uvod= LimeSurvey uporablja nov modul Expression Manager (EM), ki bo LimeSurveyju omogočil podporo za bolj zapleteno razvejanje, ocenjevanje, validacijo in prilagajanje. Zamenjal bo način, kako LimeSurvey upravlja zamenjave, pogoje in ocene v ozadju. Prav tako bo znatno pospešil obdelavo, saj odpravlja večino branj baze podatkov med izvajanjem. EM je razvil dr. Thomas White (TMSWhite). Ta stran wiki je dokončna referenca za sintakso in funkcionalnost Expression Managerja. ==Ključne definicije== #''Izraz''': Vse, kar je obdano z zavitimi oklepaji #*Dokler ni praznega prostora takoj za začetnim oklepajem ali pred zaključnim zavitim oklepajem #*Vsebino izrazov ovrednoti EM, tako da lahko vsebujejo matematične formule, funkcije ter zapleteno obdelavo nizov in datumov. #''''Krojenje'''': včasih imenovano "cevovod", je to proces pogojno spreminjanje besedila #*Imate dostop do vseh 'nadomestnih polj', podatkov o udeležencih in podatkov o odzivih. #*Imate tudi lažji dostop do vprašanj, odgovorov in njihovih lastnosti. #'' Enačba 'Relevantnost''': nov atribut vprašanja, ki nadzoruje vidnost vprašanja #*Če obstaja enačba relevantnosti, potem je vprašanje prikazano le, če je relevantnost ocenjena kot res. #*Interno, vsi array_filter in array_filter_exclude ukazi postanejo relevantni na ravni podvprašanja #'''Equation''' Vrsta vprašanja: Nova vrsta vprašanja, ki shranjuje izračune ali poročila v zbirko podatkov #*Je kot vprašanje Boilerplate, vendar se njegova vsebina shrani v baze podatkov, tudi če nastavite "Vedno skrij to vprašanje" #'''Koda vprašanja''': To je prednostno ime spremenljivke za EM #*To je lahko opisno ime, ki označuje namen vprašanja , kar olajša branje zapletene logike #*Veljavne kode vprašanj se NE smejo začeti s številko, zato, ko uporabljate kodo vprašanja za oštevilčenje vprašanj, preprosto uporabite »q1«, »q1a« ali »g1q2«.! N!#*To je tisto, kar trenutno postane ime spremenljivke, če izvozite podatke v SPSS ali R, tako da, če izvajate statistično analizo, ste to verjetno že naredili edinstveno. <span id="Do_I_have_to_use_EM?"></span> ==Ali moram uporabiti EM?== Kratek odgovor je Ne (a tudi da). EM je popolnoma nazaj združljiv z obstoječimi raziskavami. Če torej z veseljem uporabljate pogoje in ocene v slogu, ki ga je LimeSurvey uporabljal v različicah <= 1.91+, lahko to počnete še naprej. Vendar pa EM popolnoma nadomesti način, na katerega LimeSurvey interno obravnava pogoje. Čeprav lahko še vedno uporabljate urejevalnik pogojev za ustvarjanje in upravljanje pogojev, jih bo LimeSurvey 1.92 pretvoril v enakovredne enačbe ustreznosti. Kot del nadgradnje bo LimeSurvey 1.92 samodejno pretvoril vse obstoječe pogoje v enačbe ustreznosti. To bi vam moralo dati najboljše iz obeh svetov – lahko nadaljujete z uporabo LimeSurvey, kot ste navajeni, vendar boste videli ekvivalent Relevance Equation, tako da lahko postopoma preidete neposredno na Relevance Equations, kadar koli se vam zdi primerno. <span id="Can_I_mix_use_of_Conditions_and_Relevance?"></span> ==Ali lahko kombiniram uporabo pogojev in ustreznosti?== ja Za nekatera vprašanja lahko uporabite urejevalnik pogojev, za druga pa urejevalnik ustreznosti. Ko shranite vprašanje, se pogoji samodejno pretvorijo v ustreznost. Upoštevajte, da predpostavljamo, da če uporabljate urejevalnik pogojev, želite, da ti pogoji prepišejo vsako ročno vneseno enačbo ustreznosti. Torej, če imate obstoječe pogoje in želite ročno urediti ustreznost, najprej izbrišite pogoje za to vprašanje. Natančneje, kopirajte ustvarjeno enačbo ustreznosti v urejevalnik besedil, uporabite meni Pogoji, da izbrišete vse pogoje za to vprašanje (s čimer boste izbrisali tudi ustreznost), nato uredite vprašanje in prilepite ustvarjeno enačbo ustreznosti iz urejevalnika besedil nazaj v polje ustreznosti za to vprašanje (in shranite vprašanje). Če obstaja dovolj povpraševanja po izbrisu pogojev brez izbrisa ustvarjene enačbe pomembnosti, lahko dodamo postopek množične pretvorbe. <span id="How_should_I_choose_between_Conditions_and_Relevance?"></span> ==Kako naj izbiram med pogoji in ustreznostjo?== Tukaj je seznam prednosti in slabosti vsakega sloga: {| class="wikitable" !Slog!!Prednosti!!Slabosti |- |Pogoji||1. Lep GUI za ustvarjanje preprostih pogojev<br/> 2. GUI je dobro dokumentiran in ga razume skupina za podporo||1. Podpira samo preproste primerjave in ne pogojuje dobro IN/ALI<br/> 2. Kaskadni pogoji delujejo neredno<br/> 3. Počasen - podatkovna baza je intenzivna, zato lahko upočasni dolge ankete<br/> 4. Nekateri so poročali o težavah s pogoji ponovnega nalaganja<br/> 5. GUI se ne prilagaja dobro, če je vprašanj na desetine, stotine ali tisoče<br/> 6. Pretvorba anket v papirni obliki je morda počasna, ker morajo uporabljati imena SGQA<br/> 7. Pogosto potrebujejo programerja za kodiranje logike po meri, potrebne za kompleksno razvejanje |- |Ustreznost||1. Podpira zelo kompleksno logiko, vključno z 80+ funkcijami in matematičnimi/niznimi operaterji<br/> 2. Popolna podpora za kaskadno logiko<br/> 3. Hitro – brez dodatnih klicev baze podatkov, zato podpira 1000+ anket z vprašanji<br/> 4. Brez težav z logiko ponovnega nalaganja, saj ne zahteva kod SGQA<br/> 5. Označevanje sintakse meri na 1000+ anket z vprašanji<br/> 6. Enostaven in hiter za uporabo za skupine, ki želijo računalniško obdelati obstoječe papirnate ankete.<br/> 7. Preprosto podpira polstrukturirane intervjuje in epidemiološke raziskave, ne da bi potrebovali programerje||1. Brez GUI za preproste pogoje - namesto tega uporabite označevanje sintakse<br/> 2. Novo, zato podporne ekipe še niso obvladale EM. |} Bistvo je, da če ste zadovoljni z delovanjem LimeSurvey 1.91+, ni razloga, da bi spreminjali svoje početje. <span id="What_are_some_other_benefits_of_using_EM?"></span> ==Katere so druge prednosti uporabe EM?== Tukaj je nekaj drugih razlogov, zakaj bi morda želeli uporabiti EM. #Izračuni - ustvarite lahko poljuben izračun, ki vam pade na pamet: #*Imate dostop do vseh običajnih matematičnih operatorjev in funkcij #* Imate dostop do 70+ matematičnih funkcij, funkcij za obdelavo datumov in nizov #*Razvijalcem je dokaj enostavno dodati nove funkcije, če jih uporabniki potrebujejo #Shranjevanje izračunov v zbirko podatkov #*Zdaj lahko izračunate preproste in zapletene izračune in/ali ocene na lestvici IN jih shranite v zbirko podatkov, ne da bi potrebovali JavaScript. #*Za to uporabite vrsto vprašanja Equation. #Ocene #*Zdaj lahko ustvarite ocene ali lestvice rezultatov iz katere koli vrste vprašanja, ne samo iz podmnožice, ki je bila prej podprta #*Uporabite lahko prilagoditev za prikaz tekočih ali skupnih rezultatov ocenjevanja, kjer koli je to potrebno – tudi na isti strani #*Imate več nadzora nad poročili, ustvarjenimi na podlagi teh ocenjevalnih rezultatov #*Ocenjevalne rezultate lahko shranite v bazo podatkov, ne da bi potrebovali JavaScript #*Ocenjevalne rezultate lahko skrijete, ne da bi potrebovali JavaScript ali CSS #Nadomestna polja # *Namesto uporabe {INSERTANS:SGQA} lahko uporabite samo kodo vprašanja - to olajša branje in preverjanje. #*S tem se tudi izognete pogosti potrebi po urejanju vprašanj za spreminjanje kode SGQA, da bo vse delovalo . #Prilagoditev - besedilo lahko pogojno prikažete na podlagi drugih vrednosti #*Uporabite ustrezen naslov za zadevo, na primer (npr. »Pozdravljeni<nowiki> [</nowiki> G./Mrs.] Smith") #*Izdaj slovnično pravilne stavke, ki temeljijo na ednini/množini: (npr. "Imaš 1 otroka" proti "Imaš 2 otroka") #*Ustrezno spreženi glagoli in zaklanjajte samostalnike glede na spol in množino osebka. #Novi atributi spremenljivk - za prilagajanje lahko dostopate do naslednjega: #* (brez pripone) - vzdevek za qcode.code #*. koda - izbrana koda odgovora na vprašanje, če je relevantno (sicer prazno), ali besedilna vrednost, če ni kodirano vprašanje #*.NAOK - enako kot .code, vendar je lahko del izračunov ali seznamov tudi če je nepomembno #*.value - vrednost ocene za vprašanje, če je relevantno (sicer prazno), ali besedilna vrednost, če ni kodirano vprašanje -- na voljo, če so ocene omogočene za anketo, sicer vedno zero #*.valueNAOK - enako kot .value, vendar je lahko del izračunov ali seznamov, tudi če ni pomembno #*.shown - odgovor, kot je prikazan uporabniku (to počne {INSERTANS:xxx} ) #*.qid - ID vprašanja #*.gid - ID skupine #*.sgqa - vrednost SGQA za vprašanje #*.jsName - pravilno ime spremenljivke javascript za vprašanje, ne glede na to, ali je definirano na tej ali drugi strani #*.qseq - zaporedje vprašanj (začenši z 0) #*.gseq - zaporedje skupine (začenši z 0) #*. obvezno - ali je vprašanje obvezno (Y/N) #*.question - besedilo vprašanja #*.relevance - enačba relevantnosti za vprašanje #*.grelevance - enačba relevantnosti za skupino #*.relevanceStatus - ali je vprašanje trenutno relevantno ali ne (logična vrednost (lahko se razlikuje v PHP in JS)) #*.type - vrsta vprašanja (koda z enim znakom)!N !#Dinamične spremembe na strani #*Vsa ustreznost, izračuni in prilagajanje delujejo dinamično na strani – tako spremembe vrednosti takoj posodobijo stran #*Vaša vprašanja se torej dinamično pojavljajo/izginejo glede na to, ali so ustrezni #*Vprašanja so tudi dinamično prilagojena glede na odgovore na strani, tako da lahko vidite tekoče vsote, prilagojene stavke in prilagojena poročila. #Nov zaslon za vnos podatkov #*Poleg uporabe trenutnem sistemu za vnos podatkov, lahko preprosto uporabite Survey-All-In-One. #*To podpira ustreznost in prilagajanje na strani, tako da lahko uradniki za vnos podatkov hitro pregledajo in bodo morali vnesti samo ustrezne odzive #*To je lahko ključnega pomena, če mora vaša oseba za vnos podatkov videti prilagoditev, ki je tudi dinamična. #Odpravlja potrebo po večini JavaScripta po meri #*EM enostavno podpira zapletene izračune, točkovanje , prilagajanje in pogojna logika. #*Nekatere stvari bodo še vedno potrebovale JavaScript (na primer postavitve po meri in pogojno skrivanje podelementov vprašanj), vendar lahko vaš JavaScript uporablja funkcije EM, tako da lahko dostopate do vprašanj z njihovo Qcode namesto SGQA in dostop do katere koli zgoraj navedene lastnosti vprašanja. <span id="What_are_some_other_helpful_new_features_enabled_by_EM?"></span> ==Katere so druge uporabne nove funkcije, ki jih omogoča EM?== Ne glede na to, ali boste še naprej uporabljali urejevalnik pogojev ali ročno sestavljali enačbe ustreznosti, boste prejeli te dodatne prednosti: #Ustvarite lahko bolj zapletena merila za preverjanje veljavnosti #*Vse napredne atribute vprašanj (kot so max_answers, min_num_value_n, max_num_value) lahko uporablja izraze. Tako je mogoče vaša najmanjša/največja merila preprosto prilagoditi glede na predhodne odgovore, tudi če so na isti strani. #*EM obravnava tudi vsa preverjanja, ki temeljijo na regularnih izrazih, tako da lahko robustno kombinirate preg in enačbo- na podlagi atributov vprašanj. #Enostavno prerazvrščanje (ali brisanje) vprašanj in skupin #*Pred različico 1.92 niste mogli prerazporediti vprašanj ali skupin, če je LimeSurvey menil, da bi se takšno prerazporejanje lahko pokvarilo pogojih, v katerih so bili uporabljeni. Podobno ne morete izbrisati vprašanj, če so bila od njih odvisna katera koli druga vprašanja. #*Z označevanjem sintakse EM je preprosto videti in potrditi, ali poskušate uporabiti vprašanja, preden so navedena. Tako vam zdaj omogočamo, da vprašanja in skupine preuredite ali izbrišete, kadar koli želite. EM bo posodobil vse označevanje sintakse, da vam bo pokazal morebitne napake. #*Pogled vprašanj za ponovno vrstni red je bil izboljšan za pomoč pri takem pregledu. Zdaj prikazuje enačbo pomembnosti vprašanja in njegovo prilagajanje, tako da lahko takoj vidite, ali katera koli spremenljivka postane rožnata (kar pomeni, da se uporabi, preden se razglasi). #Navigacijski indeks vprašanj/skupin je vedno na voljo in točen #* Pred različico 1.92 ti indeksi niso bili na voljo, če so bili zapleteni pogoji #*Z EM lahko zagotovimo, da so točni. #*Subjekt lahko celo skoči nazaj na prejšnje vprašanje, spremeni odgovor , nato skočite naprej (ali pošljite) #**Pri skoku naprej bo EM ponovno preveril vsa vmesna vprašanja/skupine. #**Če katero koli vprašanje postane nepomembno, bo v zbirki podatkov razglašeno za NULL. tako da so vaši podatki interno skladni #**Če kakršna koli vprašanja postanejo pomembna ali na novo ne izpolnjujejo obveznih ali pravil preverjanja, se bo EM ustavil na tej strani in prisilil uporabnika, da odgovori na ta vprašanja, preden skoči na končni cilj. #Samodejna pretvorba pogojev v ustreznost #*Ko nadgradite svojo zbirko podatkov, bodo za vse obstoječe ankete, ki imajo pogoje, ustvarjene enačbe ustreznosti #*Kadar koli uvozite anketo, bodo po potrebi ustvarjene enačbe ustreznosti #*Kadar koli dodate, izbrišete ali spremenite pogoje, bo EM ustvaril ustrezno enačbo ustreznosti. #Priročno označevanje sintakse #*Ko EM prikaže enačbo pomembnosti, bo prikazal Qcode, tudi če vnesli ste kodo SGQA, saj predvidevamo, da bo to lažje brati. #*Vse spremenljivke so barvno kodirane, da pokažejo, ali so bile deklarirane pred ali za trenutnim vprašanjem (ali pred ali za trenutno skupino). To vam omogoča hitro odkrivanje in popravljanje primerov, ko poskušate uporabiti spremenljivke za ustreznost (vključno z array_filter), prilagajanje ali validacijske enačbe, preden jih objavite. #*Poleg tega, če z miško premaknete nad barvno kodirano spremenljivko , boste videli najpomembnejše metapodatke o tem vprašanju. To vključuje zaporedje skupine #, zaporedje vprašanja #, kodo Q, besedilo vprašanja in vse razpoložljive izbire odgovorov (če gre za vrsto vprašanja z oštevilčenimi možnostmi odgovorov). #**Seznam izbir odgovorov uporablja to sintakso : 'odgovori':{ključ:val, ... }. #**''ključ'' ima sintakso ''''lestvica~koda'''', kjer je ''lestvica'' lestvica odgovorov (npr. za dvojno lestvico) in ''koda'' je koda odgovora. #**''val'' ima sintakso ''''prikazana vrednost'''', kjer je ''vrednost'' vrednost ocene (če uporabljate ocene, drugače ''koda'')(npr. Qcode.value) in ''prikazano'' je prikazana vrednost, kot jo vidi subjekt (npr. Qcode.shown) #**To pomeni, da lahko številne raziskave uporabljajo izračune, ne da bi potrebovali način ocenjevanja. Če ste našteli možnosti odgovorov, ki so edinstveni, nedecimalni in nenegativni, lahko preprosto izračunate vrednosti Qcode.code. #Enostaven pregled celotne logike in vsebine ankete #*Obstaja nova funkcija Prikaži logiko ankete, ki vam omogoča ogled vsega o anketi (ali skupini ali vprašanju) na eni strani. #*Prikaže podrobnosti na ravni skupine, vprašanja, podvprašanja in odgovora za izbran obseg (anketa v primerjavi s skupino v primerjavi z vprašanjem) #*Prikaže tudi ustreznost, ustreznost na ravni podvprašanja (za array_filter in array_filter_exclude) in ustvarjeno validacijsko enačbo (za preg in morebitna validacijska pravila, kot je najmanjša/največja vsota/število vrednosti) in vsi atributi vprašanj, ki niso prazni. #*Vse je skladenjsko označeno, tako da lahko vidite morebitne sintaksne napake (kot so neuravnoteženi oklepaji ali uporaba spremenljivk, preden so bile deklarirane) #*Skladnja- Highligting podpira hitro navigacijo in urejanje ankete. #**Če kliknete ime spremenljivke, se odpre okno brskalnika (ali zavihek), ki vam prikaže to vprašanje in vam omogoča urejanje. #** Če kliknete ime skupine, se odpre okno (ali zavihek) brskalnika, ki prikazuje pogled za preurejanje skupine, tako da lahko preprosto premikate vprašanja. #**Vsi atributi vprašanja so sintaktično označeni. To vam omogoča nastavitev in ogled izrazov v naprednih možnostih vprašanj (na primer določanje največjega/najmanjšega števila/vsote vrednosti na izrazu) #*Avtor EM je uporabil podoben pogled (malo čistejši), da je svojim sodelujočim epidemiologom in institucijam omogočil Nadzorni odbor potrdi in odobri ankete s tisoči vprašanj v zelo razvejanih in prilagojenih strukturiranih intervjujih <span id="Getting_Started"></span> =Začetek= Najboljši način, da začnete z EM je: *Namestiti najnovejšo stabilno različico s http://www.limesurvey.org/en/download *Uvoziti in raziskati [[ExpressionScript sample surveys|vzorčne ankete ]]. *Raziščite [[ExpressionScript How-tos|primere uporabe in navodila]] in [[ExpressionScript examples|primere po korakih]]. *Raziščite dokumentacijo EM (ta stran)! N!*Preglejte vgrajeno zbirko testov EM **V kateri koli anketi pod orodji izberite možnost EM **Razpoložljive funkcije navajajo 70+ funkcij in sintakso **Preizkusi enot izoliranih Izrazi ***prikazuje primere uporabe vseh funkcij in operatorjev EM ter rezultatov PHP in JavaScript ***upoštevajte, da obstaja nekaj funkcij, ki ustvarjajo različne rezultate v različicah PHP in JavaScript, zato vam ta stran omogoča ustrezno načrtujte svojo EM logiko. <span id="What_Functionality_does_Expression_Manager_Extend/Replace?_(LimeSurvey_<=_1.91+)"></span> =Katero funkcionalnost razširi/zamenja Expression Manager? (LimeSurvey <= 1,91+)= <span id="Conditions_=>_Relevance"></span> ==Pogoji => Ustreznost== Pogoji so nadzorovali, katera vprašanja so vidna. Splošna sintaksa je bila ''Vrednost operaterja SGQA'', na primer ''111X2X3 == "Y"''. Pogoje je bilo mogoče kombinirati z IN ali ALI, vendar je bilo mešanje IN in ALI težko. Sami pogoji so bili shranjeni v ločeni tabeli, velik del kode LimeSurvey pa je bil namenjen upravljanju pogojev. Zaradi obsežnega dostopa do baze podatkov lahko obdelava velikega števila pogojev povzroči opazne težave z delovanjem. Poleg tega, ko so bili vprašanjem ali skupinam dodeljeni pogoji, jih pogosto ni bilo dovoljeno preurediti ali izbrisati. <span id="Assessments_=>_Equations_and_Micro-Tailoring"></span> ==Ocenjevanja => Enačbe in mikro krojenje== Ocene uporabnikom omogočajo ustvarjanje rezultatov na lestvici iz zbirke vprašanj. Vendar se na trenutni strani niso mogli dinamično spremeniti in njihove vrednosti niso bile shranjene v zbirki podatkov. <span id="Replacements_=>_Micro-Tailoring"></span> ==Zamenjave => Mikro krojenje== Uporabniki lahko prilagodijo nekatera sporočila in vprašanja na podlagi predhodnih odgovorov. Vprašanje je lahko na primer: »{TOKEN:FIRSTNAME}, rekli ste, da je {INSERTANS:111X3X4} vaš najljubši šport«. Vendar pa ni bilo mogoče izvesti pogojnega prilagajanja (kot recimo »gospod« ali »gospa«, odvisno od spola osebe) ali spregati glagolov ali zavrniti samostalnikov brez modnega JavaScripta. Avtorji so lahko izvajali ankete, za katere se je zdelo, da prilagajajo vprašanja, vendar so zahtevala ločena vprašanja za vsako permutacijo in zapletene pogoje za odločitev, katera vprašanja prikazati. <span id="Validation"></span> ==Potrjevanje== Vprašanje je mogoče potrditi z regularnimi izrazi ali najmanjšimi/največjimi vrednostmi ali pustiti, da odgovor SGQA služi kot najmanjša ali največja vrednost. Vendar validacije ne morejo temeljiti na izračunih drugih spremenljivk brez modnega JavaScripta. <span id="Equations"></span> ==Enačbe== Enačbe niso bile podprte brez modnega JavaScripta. <span id="Equation_Question_Type"></span> ==Enačba Vrsta vprašanja== Enačb ni bilo mogoče shraniti v zbirko podatkov (npr. končnega rezultata za oceno) brez modnega JavaScripta. <span id="How_Will_Expression_Manager_Replace/Extend_That_Functionality?"></span> =Kako bo Expression Manager nadomestil/razširil to funkcionalnost?= Expression Manager je nov osrednji modul znotraj LimeSurvey, ki omogoča veliko lažjo podporo vrsti kompleksne funkcionalnosti, ki je prej zahtevala JavaScript po meri. Prav tako nadomešča način, na katerega LimeSurvey trenutno upravlja pogoje in ocene. <span id="New_Terminology_When_Referring_to_Expression_Manager_(EM)"></span> ==Nova terminologija pri sklicevanju na Expression Manager (EM)== EM "razmišlja" o svoji funkcionalnosti v naslednjih izrazih: *'''Relevance-based Branching''' - če je vprašanje relevantno, ga postavite, sicer ne (npr. naredite ga nevidnega in označite kot NULL v bazi podatkov). Na voljo je novo polje Ustreznost za vse vrste vprašanj in tudi za vsako skupino (tako da lahko nabor pogojev uporabite za celotno skupino, ne da bi morali kopirati isti pogoj za vsako vprašanje in/ali združiti skupino in pogoj na ravni vprašanja logic). *'''Tailoring''' - Ko veste, katera vprašanja je treba postaviti, krojenje (včasih imenovano ''piping'') določa, kako naj se vprašanje postavi. To vam omogoča ne samo podporo preproste zamenjave (kot je {TOKEN:FIRSTNAME}), ampak tudi spreganje glagolov in sklanjanje samostalnikov glede na spol ali število vaših subjektov. Prav tako vam omogoča, da spremenite sporočilo, ki ga pošljete subjektu glede na to, ali je odgovoril (ali kako je odgovoril) na druga vprašanja. *''Equations'''' - EM doda novo vrsto vprašanja, imenovano Equation, ki shrani rezultat izraza. Rezultati teh enačb se izračunajo in zapišejo v bazo podatkov, tudi če jih skrijete na strani. Tako so uporabne za skrite izračune točkovanja, navigacijo na podlagi zapletenih enačb, ocene in poročila, ki jih je treba ustvariti in zlahka dostopna v bazi podatkov. <span id="Relevance_and_Cascading_Relevance"></span> ===Ustreznost in kaskadna ustreznost=== Vsaka vrsta vprašanja ima zdaj možnost Ustreznost, ki nadzira, ali je vprašanje prikazano. EM obdela vsako od enačb ustreznosti v vrstnem redu, v katerem naj bi se pojavile v anketi. Če je izraz resničen (ali manjka – za podporo starim anketam), bo vprašanje prikazano. Če ni relevantno, bo vprašanje skrito, vrednost pa bo v zbirki podatkov označena z NULL. Če v skupini ni ustreznih vprašanj, bo celotna skupina preskočena. Poleg tega, če je katera od spremenljivk v izrazu nepomembna, potem je izraz vedno ovrednoten kot false. To omogoča kaskadno ustreznost, tako da vam ni treba pisati zelo dolgih enačb ustreznosti za vsako vprašanje. Recimo, da imate 5 vprašanj Q1-Q5 in želite prikazati samo Q2, če je bil odgovor na Q1, in Q3, če je bil odgovor na Q2 itd. Enačbe ustreznosti so lahko: {| class="wikitable" !Koda vprašanja!!Ustreznost!!Vprašanje |- |Q1||1||Kako ti je ime? |- |Q2||Q1 ||{Q1}, koliko si star? |- |Q3||Q2||Torej, star si {Q2} let. Ste poročeni? |- |Q4||Q3 == "Y"||{Q1}, koliko časa ste poročeni? |- |Q5||Q4|| Koliko otrok imaš, {Q1}? |} Izračuni ustreznosti delujejo tudi v JavaScriptu – tako da bi lahko vsa zgornja vprašanja postavili na eno stran in bi še vedno delovalo po pričakovanjih. Pravzaprav EM popolnoma nadomešča način, kako EM obdeluje formate anket Anketa vs. Skupina vs. Vprašanje naenkrat. Zdaj vsi uporabljajo popolnoma enak navigacijski mehanizem, tako da delujejo enako ne glede na slog raziskovanja. Dokler ste na isti strani, bodo vsi podatki, ki ste jih vnesli, še vedno tam, samo skriti. Torej, če vnesete nekaj informacij, nato izberete možnost, ki jih naredi nepomembne, nato pa jih znova naredite ustrezne, bodo vaši odgovori še vedno na voljo. Vendar takoj, ko se premaknete na drugo stran, bodo vsi nepomembni odgovori izgubljeni zaradi celovitosti nabora podatkov. <span id="Group-Level_Relevance"></span> ===Ustreznost na ravni skupine=== Expression Manager podpira tudi ustreznost na ravni skupine. To olajša izvajanje zanke. Recimo, da želite zbrati informacije o do 10 subjektih (kot so izdelki ali ljudje v gospodinjstvu), pri čemer najprej določite, koliko subjektov potrebuje nadaljnje ukrepanje (na primer tako, da vprašate, koliko ljudi živi v gospodinjstvu, ali da ljudi preverijo kateri izdelki so jim všeč z dolgega seznama). Ko veste, koliko subjektov potrebuje nadaljnje ukrepanje, lahko uporabite ustreznost na ravni skupine, kot je {count >= 1}, {count >=2}, ... {count >= 10} za vsako od 10 skupin spremljanja. gor vprašanja. Znotraj vsake skupine imate lahko pogojno logiko na ravni vprašanja (npr. dodatna vprašanja glede spola ali starosti za vsak predmet). Vprašanje in enačbe ustreznosti na ravni skupine se povežejo z IN, da se določi, katera naj bo prikazana. <span id="Tailoring_/_Piping"></span> ===Krojenje / Piping=== Karkoli v zavitih oklepajih se zdaj obravnava kot izraz (z eno izjemo, ki je opisana spodaj). Izrazi imajo dostop do vseh polj LimeReplacementFields, vseh spremenljivk (prek več vzdevkov), vseh tipičnih operatorjev enačb (matematičnih, logičnih in primerjalnih) in na desetine funkcij (ki delujejo celo dinamično na strani odjemalca). Z uporabo teh enačb lahko naredite stvari, kot so: #Pogojno prikažite prilagojena sporočila anketirancem na podlagi predhodnih odgovorov #Ustvarite ocene in pokažite rezultate ocenjevanja (ali pogojno razvejajte ali prikažite sporočila) na podlagi teh rezultatov, vse brez uporabe samega modula za ocenjevanje #Spregajte glagole in zavrnite samostalnike v vprašanjih, odgovorih in poročilih. #Prikažite povzetke odgovorov pred stranjo »Pokažite svoje odgovore« na koncu ankete <span id="Equations"></span> ===Enačbe=== Obstaja nova vrsta vprašanja, imenovana Enačba. Je kot Boilerplate vprašanja, le da shrani vrednost tega, kar je prikazano v bazi podatkov. Torej, če besedilo Equation Question vsebuje izračun ocene, bi bila ta vrednost shranjena v zbirki podatkov v spremenljivki, ki jo je mogoče prikazati v javnih ali zasebnih statistikah. To rešuje običajno zahtevo za shranjevanje rezultatov ocenjevanja v bazi podatkov <span id="Syntax"></span> ==Sintaksa== Vse, kar je v zavitih oklepajih, se zdaj obravnava kot izraz (z eno izjemo: ne sme biti presledkov na začetku ali na koncu – to je potrebno za zagotovitev, da upravitelj izrazov ne poskuša obdelati vdelanega JavaScripta). Upoštevajte, da je v redu, če izrazi obsegajo več vrstic, če za začetnim zavitim oklepajem ali pred zaključnim zavitim oklepajem ni presledka. To je še posebej koristno za ugnezdene stavke if(), kot je ta: <syntaxhighlight lang="java">{if(is_empty(PFTotals), '', if(PFTotals >= -5 && PFTotals <= -4, 'Zelo mehko', if(PFTotals >= -3 && PFTotals <= -2, 'Mehko', if(PFTotals == -1, 'Nekoliko mehko', if(PFTotals == 0, 'Zmerno', if(PFTotals == 1, 'Nekoliko težko', if(PFTotals >= 2 && PFTotals <= 3, 'Hard', if(PFTotals >= 4 && PFTotals <= 5, 'Zelo težko', '' ) ) ) ) ) ) ) )} </syntaxhighlight> <div id="EMsyntax">Expression Manager podpira naslednjo sintakso:</div> *Vsi standardni matematični operatorji (npr. +,-,*,/,!) *Vsi standardni primerjalni operatorji (npr. <,<=,==,!=,>,>=, plus ti ustrezniki: lt,le,eq,ne,gt,ge) *Oklepaji (da lahko združite podizraze) *Pogojni operatorji (npr. &&,| | in ti ustrezniki: in,ali) * Nizi z enojnimi in dvojnimi narekovaji (ki lahko vsak vdela nize z drugo vrsto narekovajev) *Operator vejice (tako ima lahko seznam izrazov in samo vrne končni rezultat) *Operator dodelitve (=) *Vnaprej določene spremenljivke (za sklicevanje na vprašanja, atribute vprašanj in odgovore) - npr. vse kode SGQA *Vnaprej določene funkcije (obstaja že 70+ in jih je preprosto dodati več) <span id="Operators"></span> === Operaterji === Sintaksa EM sledi običajni prednosti operatorja: {| class="wikitable" !Raven!!Operator(ji)!!Opis |- |1||()||oklepaji za združevanje ali klicanje funkcij |- | 2||! - +||unarni operatorji: ne, negacija, unarni-plus |- |3||* /||krat, deli |- |4||+ -||plus , minus |- |5||< <= > >= lt le gt ge||relativne primerjave |- |6||== != eq ne||primerjave enakosti |- |7||in||logično IN |- |8||ali||logično ALI |- |9||=||dodelitev operator |- |10||,||vejica operator |} <span id="Warning_with_plus_operator_(+)"></span> ==== Opozorilo z operatorjem plus (+) ==== Zaradi skladnosti med JavaScriptom in PHP operater plus (+) sešteva, če sta oba operanda številska, vendar združuje, če sta oba dela neštevilska niza. Vendar pa '''priporočamo uporabo funkcije join() za veriženje in funkcije sum() za seštevanje''', saj je s tem vaš namen jasnejši in se izognete nepričakovanim rezultatom, če ste pričakovali nize, a namesto tega dobili številke (ali obratno obratno). <span id="Warning_with_mismatch_between_number_and_string_and_alphabetic_comparison"></span> ==== Opozorilo z neujemanjem med številom in nizom ter abecedno primerjavo ==== Ko želite primerjati vrednost z relativnimi primerjavami ali primerjavami enakosti, bodite pozorni na neujemanje vrste. Vrednost, ki jo vnese uporabnik, ali izbrana koda odgovora se lahko uporabi kot številka, če je očitno številka. Če eno od vrednosti obdate z <code>"</code> , bo primerjava vsiljena kot besedilo (abecedna primerjava). Če želite primerjati številčno, številke nikoli ne obkrožite z narekovaji, <code>"</code> . Na primer <code>Q0.NAOK > "50"</code> velja, če je Q0.NAOK številsko vprašanje z vrednostjo 9. To je zato, ker bo operator <code>></code> domneval, da gre za abecedno primerjavo in ne za številko. <div class="mw-translate-fuzzy"> Če želite zagotoviti primerjavo celoštevilske vrednosti, lahko uporabite <code>[[Expression_Manager#Implemented_Functions|intval]](Q0.NAOK) > 50</code> , samo zapomnite si, če Q0.NAOK ni število (prazno ali niz), potem intval(Q0. NAOK) === 0. Za primerjavo vrednosti niza ("A" < "B") neposredno uporabite [[Expression_Manager#Implemented_Functions|strcmp]]: <code>strcmp(Q0.NAOK,"B")</code> ali <code>strcmp(Q0.NAOK,"A5")</code> . </div> <span id="Caution_about_using_Assignment_Operator_(=)"></span> ===Previdno pri uporabi operatorja dodelitve (=)=== Opomba: izogibajte se uporabi operatorjev dodelitve, razen če je to nujno potrebno, saj lahko povzročijo nepričakovane stranske učinke. Če na primer spremenite vrednost prejšnjega odgovora, se kaskadna ustreznost in logika preverjanja veljavnosti med tem vprašanjem in trenutnim vprašanjem ne izračunata znova, tako da lahko na koncu dobite notranje neskladne podatke (npr. vprašanja, na katera ostane odgovor, vendar bi morala imeti bila NULLed ali vprašanja, ki so preskočena, a bi nanje morali odgovoriti). Na splošno velja, da če želite spremenljivki dodeliti vrednost, ustvarite vrsto vprašanja Equation in uporabite izraz za nastavitev njene vrednosti. Vendar pa ljudje redko potrebujejo tega operaterja, zato smo ga dali na voljo. Da bi vas opozorili na ta operator, je v sintaksnih enačbah prikazan z rdečo pisavo (da ga ne zamenjate z "==") ===Uporaba operatorja dodelitve=== Glavni razlogi, zakaj boste morda želeli uporabiti dodelitev, so: * Nastaviti morate privzeto vrednost za vprašanje, ki ne sprejema privzetih vrednosti prek enačbe (kot je seznam radio, kjer vam uporabniški vmesnik omogoča izbiro ene od možnosti odgovora, ne dovoljuje pa vnosa enačbe). Vendar bodite previdni, saj LimeSurvey ne bo mogel potrditi, da vaša enačba ustvari enega od dovoljenih odgovorov za to vprašanje. * Odgovor na prejšnje vprašanje morate na silo spremeniti na podlagi kasnejšega odgovora * Potrebujete zapleteno kvoto: uporabite eno skrito posamezno izbiro za kvoto in jo nastavite z dodelitvijo * itd... V ta namen lahko uporabite vse sisteme upravljanja izrazov. {{Opozorilo|Dodeljevanje se izvaja samo v PHP. To ne posodobi nobenih vrednosti na isti strani, ampak le, ko uporabnik krmari z naslednjim, prejšnjim, shrani ….}} {{Opozorilo|Če za ta namen ne uporabljate tipa [[Question_type_-_Equation|vprašanja z enačbo]]: dodelitev se izvede šele, ko je dokončana logika trenutne strani. Priporočena metoda je, da vedno uporabite [[Question_type_-_Equation|vprašanje z enačbo]].}} Nekaj primerov: * Nastavite odgovor na kratko besedilno vprašanje z malimi črkami: <code>{QCODE=strtolower(QCODE.NAOK)}</code> * Nastavite privzeti odgovor na vrsto vprašanja niza na začetku ankete: <code>{Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}</code> * Nastavite privzeti odgovor na vrsto vprašanja v polju besedila na začetku ankete: <code>{Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}</code> * Nastavite odgovor s pogojem: <code>{QCODE=if(YesNo="Y","A1","")}</code> <span id="XSS_security"></span> == Varnost XSS == Z omogočenim XSS nekaterih sistemov za upravljanje izrazov ni mogoče uporabiti: * začetek oznake HTML v izrazu, vendar končanje v drugem izrazu * uporaba kompleksnega izraza v URL-ju. Primer in rešitev * <code>{if( 1 ,"<strong>","")}information{if( 1 ,"</strong>","")}</code> je poškodovana z varnostjo XSS, tukaj lahko uporabite <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> ==Dostop do spremenljivk== Expression Manager omogoča dostop samo za branje do spremenljivk, ki jih morda potrebujemo. Za združljivost s prejšnjimi različicami omogoča dostop do naslednjega: *TOKEN:xxx - vrednost TOKEN-a (npr. TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (samo za NEanonimne ankete). *[[Dodajanje question#Information_from_previous_answers|INSERTANS:SGQA]] - prikazna vrednost odgovora (npr. "Da"). Za Expression Manager je enako kot pri uporabi {QCODE.shown}. *Vse [[The_template_editor#Keywords|{XXX} vrednosti, ki jih uporabljajo predloge]]. *V besedilu vprašanja lahko zamenjate {QID} z ID-jem vprašanja in {SGQ}, ki ga nadomesti SGQA vprašanja Poleg tega vam Expression Manager omogoča sklicevanje na spremenljivke s kodo vprašanja (stolpec 'naslov' v tabeli vprašanj v bazi podatkov). To je tudi oznaka spremenljivke, ki se uporablja, ko izvozite podatke v SPSS, R ali SAS. Na primer, če imate vprašanja o imenu, starosti in spolu, lahko te spremenljivke imenujete »ime«, »starost« in »spol« namesto »12345X13X22«, »12345X13X23«. ' in ''12345X13X24''. To olajša branje enačb vsem in potrdi logiko, poleg tega pa omogoča mešanje vprašanj, ne da bi morali slediti številkam skupin ali vprašanj. <div class='simplebox'> '''Pomembno:''' Varno je le sklicevanje na spremenljivke, ki se pojavljajo na prejšnjih straneh ali vprašanjih. </div> Poleg tega vam Expression Manager omogoča dostop do številnih lastnosti vprašanja: {| class="wikitable" !Sintaksa!!Pomen!!Primer!!Primer Rezultat |- |Qcode||vzdevek za Qcode.code||{implode(',',name,gender )}||'Tom','M' |- |Qcode.code||izbrana koda odgovora na vprašanje, če je ustrezna (sicer prazna), ali besedilna vrednost, če ni kodirano vprašanje||{implode(',',name.code,gender.code)}||'Tom','M' |- |Qcode.NAOK||enako kot Qcode - glejte razpravo o NAOK||{gender.NAOK}||'M' |- |Qcode.value||vrednost ocene za vprašanje, če je relevantno (sicer prazno), ali vrednost besedila, če ni kodirano vprašanje||{gender.value}||'1' |- |Qcode.valueNAOK||enako kot Qcode.value - glej razpravo o NAOK||{gender.valueNAOK}||'1 ' |- |Qcode.shown||prikazana vrednost za vprašanje||{implode(',',name.shown,gender.shown)}||'Tom','Male'!N !|- |Qcode.question||besedilo vprašanja||{gender.question}||'Kakšen je vaš spol?' |- |Qcode.mandatory||ali je vprašanje je obvezno (Y/N)||{gender.mandatory}||'N' |- |Qcode.qid||notranja številka vprašanja (ne zaporedna številka)||{gender.qid} ||337 |- |Qcode.type||tip vprašanja||{gender.type}||'G' |- |Qcode.jsName||pravilno ime javascript za vprašanje, ne glede na to, ali je navedeno na tej strani ali zunaj nje||{gender.jsName}||'java1827X3X337' |- |Qcode.gid||notranja številka skupine (ne zaporedna številka)|| {gender.gid}||3 |- |Qcode.qseq||zaporedna številka vprašanja, začenši z 0||{gender.qseq}||5 |- |Qcode.gseq||zaporedna številka skupine, začenši z 0||{gender.gseq}||1 |- |Qcode.relevanceStatus||ali je vprašanje trenutno relevantno (0 ali 1 )||{gender.relevanceStatus}||1 |- |Qcode.relevance||enačba ustreznosti na ravni vprašanja||{gender.relevance}||'!is_empty(name)' |- |Qcode.grelevance||enačba ustreznosti na ravni skupine||{gender.grelevance}||'num_children >= 5' |- |Qcode.sgqa||vrednost SGQA za to vprašanje||{gender.sgqa}||'1827X3X337' |} <span id="HTML_editor_issue"></span> === Težava z urejevalnikom HTML=== {{Opozorilo|Ta težava je odpravljena po različici 2.05 build 140803}} Če uporabljate urejevalnik HTML, so nekateri znaki nadomeščeni z entitetami HTML. * & z & * < z < * > z > Če uporabljate urejevalnik HTML, morate uporabiti : * in za & * lt for < * le for <= * gt for > * ge za >= <span id="Qcode_Variable_Naming"></span> ==Poimenovanje spremenljivke Qcode== Tukaj so podrobnosti o tem, kako sestaviti Qcode (in dostopati do nekaterih lastnosti) glede na vrsto vprašanja. Na splošno so kode Q zgrajene kot: QuestionCode . '_'. ID podvprašanja. '_'. ScaleId Za '''komentar''' in '''drugo''' sta kodi vprašanja QuestionCode_comment in QuestionCode_other {| class="wikitable" !Tip!!Opis!!Koda!!SubQs!!Možnosti odgovorov!!Lestvice!!Koda odgovora!!Odgovor je prikazan!!Ustreznost |- |5||5 Izbirni gumbi za izbiro točke||Q1|| ||1-5|| ||{Q1}||{Q1.shown}||{Q1==3} |- |B||Matrika (izbira 10 točk) izbirni gumbi||Q2||L1-L6| |1-10|| ||{Q2_L2}||{Q2_L2.shown}||{Q2_L2==7} |- |A||Matrika (izbira 5 točk) izbirni gumbi||Q3||1-5| |1–5|| ||{Q3_1}||{Q3_1.shown}||{Q3_1>=3} |- |1||Matrika (prilagodljive oznake) dvojna lestvica||Q4||sq1-sq5||0 :a1-a3||1:b1-b3||{Q4_sq1_0}||{Q4_sq1_1.shown}||{Q4_sq1_1=='b2'} |- |H||Matrika (prilagodljiva) - Oblika stolpca||Q5||1-5||s,m,t|| ||{Q5_1}||{Q5_1.shown}||{Q5_1=='s'} |- |F||Matrika (prilagodljiva) – oblika vrstice||Q6||F1-F5| |1–5|| ||{Q6_F3}||{Q6_F3.shown}||{Q6_F3==4} |- |E||Matrika (povečanje/enako/zmanjšanje) radijskih gumbov||Q7||1- 7||I,S,D|| ||{Q7_4}||{Q7_4.shown}||{Q7_4=='D'} |- |:||Matrika (Multi Flexi) 1 do 10||Q8||ls1,todo ,ls2||min,max,avg|| ||{Q8_ls1_max}||{Q8_ls2_avg.shown}||{Q8_ls2_min==7} |- |;||Array (Multi Flexi) Besedilo||Q9||hp,st,sw|| 1.,2.,3.|| ||{Q9_hp_3rd}||{Q9_hp_3rd.shown}||{Q9_hp_3rd=='Peter'} |- |C||Array (Da/Negotovo/Ne) Radio-Buttons||Q10|| 1–5||D,N,U|| ||{Q10_1}||{Q10_1.shown}||{Q10_3=='Y'} |- |X||Standardno vprašanje||Q11|| || || || ||{Q11.shown}|| |- |D||Datum||Q12|| || || ||{Q12}||{Q12.shown}|| |- |*||Enačba||Q13|| || || ||{Q13}||{Q13.shown}||{Q13>5} |- |~124~||Nalaganje datoteke (zabeleženo število naloženih datotek)||Q14|| || || ||{Q14}|| ||{Q14>0} |- |G||Spustni seznam za spol||Q15|| ||M,Ž|| ||{Q15}||{Q15.shown}||{Q15=='M'} |- |U||Ogromno prosto besedilo||Q16|| || || ||{Q16}||{Q16.shown}||{strlen(Q16)>100} |- |I||Jezikovno vprašanje||Q17|| || || ||{Q17}||{Q17.shown}||{Q17=='en'} |- |!||Seznam – spustni meni||Q18|| ||1-5|| ||{Q18}||{Q18.shown}||{Q18==3} |- |L||Spustni seznam/seznam radijskih gumbov||Q19|| ||AZ|| ||{Q19}||{Q19.shown}||{Q19=='X'} |- |O||Seznam s spustnim seznamom komentarjev/seznam izbirnih gumbov + besedilno polje||Q20 || ||AF|| ||{Q20},{Q20comment}||{Q20.shown}||{Q20=='B'} |- |T||Dolgo prosto besedilo||Q21|| || || ||{Q21}||{Q21.shown}||{strstr(Q21,'hello')>0} |- |M||Potrditveno polje z več možnostmi||Q22||AF, other| | || ||{Q22_E}, {Q22_other}||{Q22_E.shown}, {Q22_other.shown}||{Q22_E=='Y'} |- |P||Več možnosti s potrditvenim poljem za komentarje + Besedilo||Q23||AF|| || ||{Q23_D}, {Q23_Dcomment}||{Q23_D.shown}||{!is_empty(Q23)} |- |K||Vprašanje z več številkami||Q24||jaz,mama,oče || || ||{Q24_self}||{Q24_self.shown}||{Q24_self>30} |- |Q||Večkratno kratko besedilo||Q25||AF|| || ||{Q25_B}||{Q25_B.shown}||{substr(Q25_B,1,1)=='Q'} |- |N||Vrsta številskega vprašanja||Q26|| || || ||{Q26}||{Q26.shown}||{Q26 > 30} |- |R||Slog razvrstitve||Q27||1-4|| || ||{Q27_1}||{Q27_1.shown}||{Q27_1==3} |- |S||Kratko prosto besedilo||Q28|| || || ||{Q28}||{Q28.shown}||{Q28=='moje'} |- |Y||Da/Ne radijski gumbi||Q29|| || || ||{Q29}||{Q29.shown}||{Q29=='Y'} |} <span id="The_reserved_'this',_'self',_and_'that'_variables"></span> ==Rezervirane spremenljivke 'this', 'self' in 'that'== Precej pogosto želite ovrednotiti vse dele vprašanja, na primer prešteti, koliko podvprašanj je bilo odgovorjenih, ali sešteti ocene. Včasih želite obdelati samo določene vrstice ali stolpce vprašanja (na primer pridobiti vsote vrstic ali stolpcev in jih shraniti v bazo podatkov). Zaradi teh rezerviranih spremenljivk je ta postopek relativno neboleč. Spremenljivka 'ta' se uporablja izključno v naprednih možnostih vprašanj »Enačba za preverjanje veljavnosti celotnega vprašanja« in »Enačba za preverjanje veljavnosti podvprašanja«. Razširi se na imena spremenljivk vsake celice znotraj teh vprašanj. Torej, če se želite prepričati, da je vsak vnos večji od tri, nastavite »Enačbo potrjevanja podvprašanja« na (to > 3). Spremenljivki 'jaz' in 'ta' sta močnejši in služita kot makra, ki se razširita pred obdelavo enačb. Možnosti sintakse so: *self *self.''suffix'' *self.''sub-selector'' *self.''sub-selector''.'' pripona'' ''pripona'' je katera koli običajna pripona qcode (npr. NAOK, vrednost, prikazano) ''podizbirnik'' je eden izmed: *komentarjev - samo podvprašanja, ki so komentarji (npr. iz izbire več s komentarjem in seznama s komentarjem) *brez komentarjev - samo podvprašanja, ki niso komentarji *sq_X - kjer je X identifikator vrstice ali stolpca. Izbrana so samo podvprašanja, ki se ujemajo z vzorcem X. Upoštevajte, da se iskanje izvaja po celotnem identifikatorju kode, nato se sq_X ujema in vključuje podvprašanja nX, X, Xn (npr. če uporabljate sq_1, so bila vključena podvprašanja a1, 1a, 1, 11 ali 001). Bodite pozorni na vrsto vprašanja z dvojno lestvico, kjer sta kodi podvprašanj QCODE_SQCODE_1 in QCODE_SQCODE_1, in na vrsto vprašanja za razvrščanje, kjer je koda podvprašanj QCODE_1,QCODE_2 .... *nosq_X – kjer je X identifikator vrstice ali stolpca. Izbrana so samo podvprašanja, ki se ne ujemajo z vzorcem X. Upoštevajte, da se iskanje izvaja po celotnem identifikatorju kode, nato se ujema nosq_X in ne vključuje podvprašanj nX, X, Xn Primeri: *Je bil kateri koli del vprašanja odgovorjen? {count(self.NAOK)>0} *Kakšna je ocena za to vprašanje? {sum(self.value)} Te lahko uporabite tudi za pridobivanje skupnih vrednosti vrstic in stolpcev. Recimo, da imate niz števil z vrsticami AE in stolpci 1-5. *Kakšna je skupna vsota? {sum(self.NAOK)} *Kolikšna je vsota vrstice B? {sum(self.sq_B.NAOK)} *Kolikšna je vsota stolpca 3? {sum(self.sq_3.NAOK)} Spremenljivka 'that' je podobna spremenljivki 'self', vendar vam omogoča, da se sklicujete na druga vprašanja. Njegova sintaksa je: *that.''qname'' *that.''qname''.''suffix'' *that.''qname''.''pod-izbirnik' ' *that.''qname''.''podizbirnik''.''pripona'' ''qname'' je ime vprašanja brez razširitev podvprašanja. Torej, recimo, da ustvarite vprašanje "q1", to je njegovo "qname" Primeri: *Ali ste odgovorili na kateri koli del vprašanja q1? {count(that.q1.NAOK)>0} *Kakšna je ocena za q2? {sum(that.q2.NAOK)} *Kolikšna je skupna vsota q3? {sum(that.q3.NAOK)} *Kolikšna je vsota vrstice C v q4? {sum(that.q4.sq_C.NAOK)} *Kolikšna je vsota stolpca 2 v q4? {sum(that.q4.sq_2.NAOK)} Spremenljivki 'jaz' in 'to' se lahko uporabita pri kateri koli ustreznosti, validaciji ali prilagajanju. Eno opozorilo je, da ko uporabite funkcijo [[Pokaži logično datoteko|Pokaži logično datoteko]], vam bo prikazala razširjeno vrednost 'sebe' in 'to'. To vam omogoča, da vidite dejansko enačbo, ki bo ustvarjena, tako da lahko vi (in upravitelj izrazov) preverite, ali spremenljivke obstajajo. To se morda zdi zmedeno, saj lahko vidite precej dolge enačbe. Vendar, če uredite vprašanje, boste videli prvotno enačbo z uporabo 'sebe' in/ali 'to' Upoštevajte tudi, da teh spremenljivk ne smete uporabljati, če (a) želite izrecno poimenovati vsako spremenljivko, uporabljeno v enačbi, ali (b) uporabite spremenljivke, ki nimajo podvprašanj (npr. vprašanja z enim odgovorom). V teh primerih je predpona spremenljivke s 'to' pretirana in tvegate, da boste dobili nepričakovane rezultate. <span id="Usage_of_NAOK"></span> ==Uporaba NAOK== NAOK --> "Ni primerno" (NA) je v redu (OK) Uporaba NAOK pomeni, da so vse ali nekatere spremenljivke nepomembne (npr. "Ni uporabno" (NA) je v redu (OK)). Ko vstavite neko spremenljivko iz vprašanja v katero koli enačbo: če je to vprašanje (ali podvprašanje) skrito zaradi pogoja: to onemogoči vse enačbe. Na primer: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) poda vedno prazen niz, če je eno podvprašanje Q1 filtrirano. Število označenih podvprašanj v takem vprašanju lahko preštejete s count(Q1_SQ1.NAOK,Q1_SQ2.NAOK ,Q1_SQ3.NAOK,Q1_SQ4.NAOK). Če je podvprašanje skrito :Upravitelj izrazov vrne prazen niz. Brez NAOK : če je eno vprašanje ali eno podvprašanje skrito : Expression Manager vrne vedno prazen niz, enako kot false. Prikazano .vedno uporablja sistem NAOK (prazen niz, če je skrit), če pa potrebujete kodo odgovora: vedno je dobro dodati .NAOK za kodo vprašanja. Razen če ga potrebujete in veste, kaj počnete. Drug primer in informacije so na voljo na [[#Overriding_Cascading_Conditions|Preglasitev kaskadnih pogojev]] <span id="Access_to_Functions"></span> ==Dostop do funkcij== Expression Manager omogoča dostop do matematičnih, nizovnih in uporabniško definiranih funkcij, kot je prikazano spodaj. Za te funkcije ima ekvivalente PHP in JavaScript, tako da delujejo enako na strani strežnika (PHP) in strani odjemalca (JavaScript). Dodajanje novih funkcij je preprosto. <span id="Implemented_Functions"></span> ===Implementirane funkcije=== Trenutno so na voljo naslednje funkcije: {| 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> ===Funkcije, ki so načrtovane ali obravnavane=== Druge funkcije, ki so načrtovane (ali se obravnavajo), vendar še niso izvedene, vključujejo naslednje. Nekateri od teh so namenjeni za nazaj združljivost z drugim raziskovalnim orodjem. {| class="wikitable" !Sintaksa!!Pomen!!Komentarji |- |e()||vrne vrednost e|| |- |formatDate(X, PAT)||vrni vrednost niza datuma X, oblikovano v skladu z vzorcem zapisa podatkov Java PAT|| |- |formatNumber(X,PAT)||vrni vrednost niza števila X, oblikovano v skladu s številko Java vzorec formata PAT|| |- |getAnsOption(X)|| [[ExpressionAnswerOptions|Osnovni vtičnik ExpressionAnswerOptions ]] || |- |getAnsOption(X,Y)|| [[ExpressionAnswerOptions|Osnovni vtičnik ExpressionAnswerOptions ]] || |- |getRelevance(X)||vrne enačbo pomembnosti za vprašanje X|| |- |getStartTime()||vrne datum, ki ustreza sistemskemu času, ko se je intervju začel|| |- |getType(X)||vrne ime niza podatkovnega tipa - npr. *NA*, če jeNA()|| |- |gotoFirst()||skoči na prvi ustrezen niz vprašanj - to krši normalni tok sistema|| |- |gotoNext()||skoči na naslednji niz vprašanj relevantna vprašanja - to krši običajni tok sistema|| |- |gotoPrevious()||skoči na prejšnji niz relevantnih vprašanj - to krši normalen tok sistema|| | - |isAsked(X)||vrne true, če odgovor ni niti *NA*, *INVALID*, niti *UNASKED*|| |- |isInvalid(X)||vrne true, če odgovor je tipa *INVALID*|| |- |isNA(X)||vrne true, če je odgovor tipa *NA*|| |- |isNotUnderstood(X)||vrne true, če je odgovor tipa *HUH*|| |- |isRefused(X)||vrne true, če je odgovor tipa *REFUSED*|| |- isSpecial(X)||vrne true, če je odgovor tipa *UNASKED*, *NA*, *REFUSED*, *INVALID*, *UNKNOWN* ali *HUH*|| |- |isUnknown(X)||vrne true, če je odgovor tipa *UNKNOWN*|| |- |jumpTo(X)||skoči v skupino, ki vsebuje imenovano vprašanje -- to krši običajno tok sistema|| |- |jumpToFirstUnasked()||skok na prvo nepostavljeno vprašanje <strike>in tako zaobide prejšnja odgovorjena vprašanja</strike> , kar krši normalni tok sistema|| |- | lastIndexOf(X,Y)||vrne zadnji indeks (osnova 0) niza Y v nizu X. Vrne -1, če Y ni v X|| |- |list(X,.. .)||niz, ki vsebuje z vejicami ločen seznam pozitivnih vrednosti z "in", ki ločuje zadnji dve || |- |mean(X,...)||vrne povprečje seznama vrednosti|| |- |numAnsOptions(X)||vrne število možnosti odgovora, ki jih ima vprašanje X|| |- |orlist(X,...)|| niz, ki vsebuje seznam pozitivnih vrednosti, ločenih z vejicami, z "ali" loči zadnji dve || |- |parseDate(X,PAT)||vrne datumsko vrednost niza X, razčlenjeno z datumom Java vzorec formata PAT|| |- |parseNumber(X,PAT)||vrne številsko vrednost niza X, razčlenjenega z vzorcem formata števila Java PAT|| |- |showAllResponsesExcept( questionList ,attributeList,attributeTitleList)||questionList = s črto ločen seznam identifikatorjev vprašanj; attributeList = s črto ločen seznam atributov (kot je vprašanje #, naslov, besedilo, vrsta - tako da se lahko odločite, kaj želite prikazati); attributeTitleList = z navpičnimi črtami ločen seznam glav tabel, tako da lahko internacionalizirate poročilo.|| |- |showTheseResponses( questionList,attributeList,attributeTitleList)||questionList = z navpičnimi črtami ločen seznam identifikatorjev vprašanj; attributeList = s črto ločen seznam atributov (kot je vprašanje #, naslov, besedilo, vrsta - tako da se lahko odločite, kaj želite prikazati); attributeTitleList = s črto ločen seznam glav tabel, tako da lahko internacionalizirate poročilo.|| |} <span id="Expression_Manager_Knows_Which_Variables_are_Local"></span> ==Upravitelj izrazov ve, katere spremenljivke so lokalne== Da pravilno zgradi JavaScript za stran, mora Expression Manager vedeti, katere spremenljivke so nastavljene na strani in kakšen je njihov ID JavaScript (npr. za document.getElementById(x)). Prav tako mora vedeti, katere spremenljivke so nastavljene na drugih straneh (da lahko zagotovi, da so potrebne<input type='hidden' value='x'> polja so prisotna in poseljena). <span id="Cascading_Conditions"></span> ==Kaskadni pogoji== Če je katera od spremenljivk nepomembna, bo celotna enačba nepomembna (napačna). Na primer, v naslednji tabeli N/A pomeni, da ena od spremenljivk ni bila ustrezna {| class="wikitable" !Operator!!Primer!!a!!b!!Rezultat |- |<nowiki> + (enarni)</nowiki> ||<nowiki> +a</nowiki> ||N/V|| ||false |- |- (enarno)||-a||N/A|| ||false |- |!||!a||N/A|| ||false |- |== (ali eq)||a == b||N/A||5||false |- |== (ali eq) ||a == b||N/A||0||false |- |== (ali eq)||a == b||N/A||N/A|| false |- |!= (ali ne)||a != b||N/A||5|| false |- |!= (ali ne)||a != b||N/A||N/A|| false |- |!= (ali ne)||a != b||N/A||0||false |- |> (ali gt)||a > b||N/A||5|| false |- |>= (ali ge)||a >= b||N/A||5||false |- |< (ali lt)||a < b||N/A||5||false |- |<= (ali le)||a <= b||N/A||5||false |- |in||a in b||N/A||5||false |- |in||a in b||N/A||N/A||false! N!|- |ali||a ali b||N/A||N/A||false |- |ali||a ali b||N/A||5 ||false |- |<nowiki> +</nowiki> ||a + b||N/A||5||false |- |-||a - b||N/A||5||false |- |*||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||false |- |funkcija||vsota(a,b,b)||N/A|| 5||false |- |funkcija||max(a,b)||N/A||5||false |- |funkcija||min(a,b)||N/A||5||false |- |funkcija||implode(', ',a,b,a,b)||N/A||5||false! N!|- |funkcija||if(a,a,b)||N/A||5||false |- |funkcija||je_prazna(a)||N/ A|| ||false |- |funkcija||je_prazna(a)||0 (ali prazno)|| ||true |- |funkcija||!je_prazna(a)||N/A|| ||false |} <span id="Overriding_Cascading_Conditions"></span> ===Preglasitev kaskadnih pogojev=== Recimo, da želite prikazati seštevek vseh ustreznih odgovorov. Lahko poskusite uporabiti enačbo {sum(q1,q2,q3,...,qN)}. Vendar se to interno prevede v LEMif(LEManyNA('q1','q2','q3',...,'qN'),'',sum(LEMval('q1'),LEMval('q2') ,LEMval('q3'),...,LEMval('qN'))). Torej, če je katera od vrednosti q1-qN nepomembna, bo enačba vedno vrnila false. V tem primeru bo vsota () prikazovala 0, dokler ne odgovorite na vsa vprašanja. Da bi se temu izognili, lahko vsaki spremenljivki dodamo pripono ".NAOK" (kar pomeni, da je Not Applicable OK). V takih primerih se pojavi naslednje vedenje. Recimo, da imate spremenljivko q1.NAOK #q1 ni dodan členu LEManyNA() #LEMval('q1') bo še naprej preverjal, ali je odgovor ustrezen, in vrnil<nowiki> ''</nowiki> če ni (zato bodo posamezni nepomembni odgovori prezrti, vendar ne bodo razveljavili celotnega izraza). Torej je rešitev tekočega skupnega problema uporaba enačbe sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK). Uporaba pripone .NAOK avtorjem omogoča tudi oblikovanje anket, ki imajo več možnih poti, vendar se pozneje združijo na skupne poti. Recimo, da subjekti na anketo odgovorijo na način, ki je izven običajnega obsega odgovorov. Avtor bi lahko subjekte opozoril, da morda ne bodo dobili veljavnih rezultatov, in jih vprašal, ali res želijo nadaljevati z raziskavo. Če odgovorijo z Da, bodo prikazana preostala vprašanja. Pogoj za "preostala vprašanja" bi preverjal, ali je bil odgovor na začetne odgovore znotraj običajnega obsega ALI ali je preiskovanec rekel pritrdilno na vprašanje, ki je pomembno le, če je odgovoril zunaj običajnega obsega. <span id="How_does_Expression_Manager_Support_Conditional_Micro-Tailoring?"></span> ==Kako Expression Manager podpira pogojno mikro krojenje?== Tukaj je primer mikrokrojenja (kjer Question Type=='expr' pomeni enačbo): {| class="wikitable" !Koda vprašanja!!Ustreznost!!Vrsta vprašanja!!Vprašanje |- |ime||1||besedilo||Kako ti je ime? |- |age||1||text||Koliko si star? |- |značka||!is_empty(age)||expr||{(starost<16) ali (starost>80)} |- |agestop||značka||sporočilo||Oprosti, {name}, tudi ti si {if( (starost<16),'young',if( (starost>80), 'star','srednjih let') ) } za ta test. |- |otroci||!značka||dano||Imate otroke? |- |starši ||1||expr||{!badage && kids=='Y'} |- |numKids||starši||text||Koliko otrok imate? |- |kid1||starši && numKids >= 1||besedilo||Koliko je star vaš prvi otrok? |- |kid2||starši && numKids >= 2||besedilo||Koliko je star vaš drugi otrok? |- |kid3||starši && numKids >= 3||text||Koliko je star vaš tretji otrok? |- |kid4||starši && numKids > = 4||text||Koliko je star vaš četrti otrok? |- |kid5||starši && numKids >= 5||text||Koliko je star vaš peti otrok? |- |sumage||1||expr||{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)} |- |poročilo||starši| |yesno||{name}, rekli ste, da ste stari {age} in da imate {numKids}. Vsota starosti vaših prvih {min(numKids,5)} otrok je {sumage} |} Vsa ta vprašanja so lahko na eni strani (npr. v isti skupini), prikazana pa bodo le ustrezna vprašanja. Poleg tega, ko vnesete starost otrok, se izraz sum() v zadnjem vprašanju dinamično posodablja na strani. <html>Upravitelj izrazov zagotavlja to funkcionalnost tako, da vsak izraz obda z imenovanim<nowiki></nowiki> <span>element. Vsakič, ko se vrednost spremeni, znova izračuna izraz, ki bi se moral pojaviti v njej</span><nowiki></nowiki> <span><span>element in regenerira zaslon. Na isti strani imate lahko na desetine ali celo stotine takšnih prilagojenih izrazov in stran jih bo ponovno prikazala vse ob eni sami osvežitvi zaslona.</span></span> <span id="Mapping_of_LimeSurvey_1.91+_to_Expression_Manager_Functionality"></span> ==Preslikava LimeSurvey 1.91+ v funkcijo Expression Manager== {| class="wikitable" !Stara funkcija!!Nova funkcija!!Komentarji |- |Pogoji||Ustreznost||Uporabite lahko zelo zapletene pogojne enačbe in dostopate do širšega nabora spremenljivk!N !|- |Ocene||Enačba||Vsak rezultat ocenjevanja je mogoče prestrukturirati v enačbo. To zagotavlja, da se rezultat zapiše v zbirko podatkov, poleg tega pa vam omogoča ogled dinamičnih sprememb vrednosti rezultata na trenutni strani |- |Zamenjave||Upravitelj izrazov||Jedrni mehanizem sprejme vhodni niz in vse v zavitih oklepajih obravnava kot izraz - tako obravnava vse vrste zgodovinskih zamenjav. Da ne bi pokvaril vdelanega JavaScripta, Expression Manager obdeluje samo vsebino med zavitimi oklepaji, če (a) v zavitih oklepajih ni presledka na začetku ali na koncu – npr. {expr} je izraz, vendar {expr}, {expr }, in {expr} nista izraza. Poleg tega Expression Manager ne obdeluje vsebine znotraj lastnih nizov (npr. {list('hi','there {braces}')} ustvari "hi there {braces}"). Prav tako ignorira ubežne zavite oklepaje (npr. \{to ni izraz\}) |- |Preverjanje||Upravitelj izrazov||Načrt je, da vzamemo trenutne najmanjše/največje atribute vprašanja in imamo upravitelja izrazov jih obdelati. Tako so lahko najmanjše/maksimalne vrednosti same izrazi |} <span id="Syntax_Highlighting"></span> =Označevanje sintakse= Za pomoč pri vnosu in preverjanju izrazov EM zagotavlja označevanje sintakse z naslednjimi funkcijami: <span id="Types_and_Meanings_of_Syntax_Highlighting"></span> ==Vrste in pomen označevanja sintakse== {| class="wikitable" !Barva!!Vzorec!!Pomen!!Namig!!Komentarji |- |rjavo ozadje||style='background-color: #eee8aa'|Vzorec|| celotna enačba||nič||Vse, kar je v zavitih oklepajih, kar je prepoznano kot enačba (npr. ni uvodne ali končne črte), bo barvno kodirano s rjavim ozadjem, da se bo lažje razlikovalo od okoliškega besedila |- |krepko rdeče besedilo||style='color:#ff0000; background-color:#eee8aa'|''''Vzorec'''||Napaka||Nekaj pojasnil o napaki||Lahko je neznana spremenljivka ali napaka v funkciji, .... Anketa je lahko popolnoma pokvarjena, to ne ni prikazan javnemu uporabniku. |- |modro besedilo||style='color:#0000ff; background-color:#eee8aa'|Vzorec||ime funkcije||pomen in dovoljena sintaksa||imena funkcij ali stvari, ki bi morale biti funkcije, ker jim sledi začetni oklepaj, so predstavljene v krepkem modrem besedilu. Opisi orodij prikazujejo pomen in dovoljeno sintakso za funkcijo. |- |sivo besedilo||style='color:#808080; background-color:#eee8aa'|Vzorec||string||brez||nizi z enojnimi in dvojnimi narekovaji so prikazani v sivem besedilu |- |cyan text||style='color:#4169e1; background-color:#eee8aa'|Vzorec||nastavljena spremenljivka na isti strani,||<nowiki> [</nowiki> ime ali koda SGQA]: vprašanje; vrednost; Seznam odgovorov, ki prikazuje kode za vsako vrednost||Katera koli spremenljivka, ki je nastavljena na isti strani kot trenutno vprašanje, je prikazana v cian besedilu, kar kaže, da jo je mogoče posodobiti v javascriptu. Opis orodja prikazuje njegovo ime (če ste uporabili INSERTANS:xxx) ali kodo SGQA (če ste uporabili nov sistem poimenovanja), dejansko vprašanje in njegovo trenutno vrednost (ali prazno, če ni nastavljeno). Če vrsta vprašanja pričakuje odgovore iz nabora oštevilčenih vrednosti, je preslikava kod v prikazane vrednosti prikazana. |- |zeleno besedilo||style='color:#008000; background-color:#eee8aa'|Vzorec||spremenljivke, nastavljene na prejšnji strani||<nowiki> [</nowiki> ime ali koda SGQA]: vprašanje; vrednost; Seznam odgovorov, ki prikazuje kode za vsako vrednost||Katera koli spremenljivka, ki je nastavljena na prejšnji strani, je prikazana s krepkim zelenim besedilom. Opis orodja prikazuje njegovo ime (če ste uporabili INSERTANS:xxx) ali kodo SGQA (če ste uporabili nov sistem poimenovanja), dejansko vprašanje in njegovo trenutno vrednost (ali prazno, če ni nastavljeno). Če vrsta vprašanja pričakuje odgovore iz nabora oštevilčenih vrednosti, je preslikava kod v prikazane vrednosti prikazana. |- |krepko roza besedilo||style='color:#9370db; barva ozadja:#eee8aa'|Vzorec||nastavljena spremenljivka na poznejši strani <sup>na splošno: prazna na začetku ankete, lahko pa se zapolni z indeksom ali premakne prejšnjo</sup> ||<nowiki> [</nowiki> ime ali koda SGQA]: vprašanje; vrednost; Seznam odgovorov, ki prikazuje kode za vsako vrednost||Vsaka spremenljivka, ki je nastavljena na naslednji strani, je prikazana v krepkem rožnatem besedilu. Opis orodja prikazuje njegovo ime (če ste uporabili INSERTANS:xxx) ali kodo SGQA (če ste uporabili nov sistem poimenovanja), dejansko vprašanje in njegovo trenutno vrednost (ali prazno, če ni nastavljeno). Če vrsta vprašanja pričakuje odgovore iz nabora oštevilčenih vrednosti, je preslikava kod v prikazane vrednosti prikazana. |- |krepko rumeno besedilo||style='color:#a0522d; background-color:#eee8aa'|Vzorec||nadomestna vrednost limete||vrednost||Nizovi zamenjave apna (kot {TOKEN:xxx}, {PRIVACY_MESSAGE}) so prikazani v krepkem rjavem besedilu. |- |rdeče besedilo||style='color:#ff4500; background-color:#eee8aa'|Vzorec||operator dodelitve (=) ||opozorilno sporočilo||Če uporabite enega od operatorjev dodelitve (=), bo ta operator prikazan v rdečem besedilu. To naj bi pomagalo preprečiti nenamerno ponovno dodelitev vrednosti, ko ste dejansko želeli preveriti, ali je a == b namesto nastavitve vrednosti a = b. |- |običajno črno besedilo||style=' barva: črna; barva ozadja:#eee8aa'|Vzorec||ločila||brez||Vsa druga ločila v izrazu so prikazana kot običajno črno besedilo. |- |besedilo v rdečem polju||obkroža krepka rdeča črta napaka||napaka v sintaksi||opis napake||Vse odkrite napake v sintaksi so prikazane tako, da napako obdajo z rdečim poljem. Opis orodja prikazuje napako. Primeri vključujejo neujemajoče se oklepaje, uporabo nedefiniranih funkcij, posredovanje napačnega števila argumentov funkcijam, slabo strukturirane izraze (npr. manjkajoči operatorji med spremenljivkami), poskus dodelitve nove vrednosti spremenljivki, ki je samo za branje, poskus dodelitve vrednosti ne- spremenljivk ali z uporabo nepodprte sintakse. Upoštevajte, da lahko sistem za odkrivanje napak v sintaksi sporoči samo eno napako v izrazu, tudi če je napak več; če pa so odkrite kakršne koli napake, bo prikazana vsaj ena napaka. |} <span id="Additional_Reading"></span> =Dodatno branje= <span id="Expression_Manager_sample_surveys"></span> ==[[Vzorčne ankete Expression Manager|Vzorčne ankete Expression Manager]]== ==[[ExpressionScript How-tos|Use Cases and HowTos]]== ==[[ExpressionScript examples|Step-by-Step examples]]== ==[[StatFunctions|Expression Manager statistic functions]]== <span id="Reference_for_Developers"></span> ==[[Upravitelj izrazov za razvijalce|Referenca za razvijalce]]== <span id="RoadMap/Status/ToDo_List"></span> ==[[Načrt programa Expression Manager|Casovni načrt/stanje/seznam opravil]]==