LimeSurvey Manual
Menu
Navigation
Main page
Recent changes
Random page
Help
Search
Special pages
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
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:Ausdrucksmanager}}<languages /> __TOC__ <div class="simplebox"> Hinweis: Dieses Feature steht erst seit LimeSurvey 1.92 zur Verfügung. </div> <span id="Quick_Start_Tutorial"></span> =Was ist der Ausdrucksmanager?= <span id="Overview"></span> ==Übersicht== Um Umfragen auf die eigenen Bedürfnisse anzupassen benötigt man in der Regel folgende Möglichkeiten: #"Navigation/Verzweigungen" - verändert die Reihenfolge der Fragen z.B. auf Grundlage der Antworten auf vorangegangene Fragen. #"Tailoring/Piping" - Anpassung des Fragetextes (in Bezug auf vorangegangene Frage oder die Anzahl oder das Geschlecht des Teilnehmers), oder von Berichten (Bewertungs-scores oder spezifische Empfehlungen). #"Validierung" - stellt sicher, daß die gegebene Anwort bestimmten Kriterien entspricht (z.B. einem Maximal- oder Minimalwert oder einem bestimmten Eingabemuster). Mit Hilfe des Ausdrucksmanagers ("Expression Manager", EM) ist es möglich all dies in intuitiver Art und Weise umzusetzen. Nahezu alles, was man mit einer mathematischen Formel beschreiben kann, kann auch als Ausdruck dienen; sogar der Aufruf von Funktionen ist möglich. EM stellt augenblicklich >70 Funktionen bereit und kann mit relativ wenig Aufwand erweitert werden. Sämtliche Variablen aus der jeweiligen Umfrage stehen unter ihrem "menschen-lesbaren" Variablennamen zur Verfügung. Die folgenden Abschnitte beschreiben wo der Ausdrucksmanager zu Einsatz kommt. <span id="Relevance_(Controlling_Navigation/Branching)"></span> ==Relevanz (für Navigation/Verzweigung)== Einige Umfrageapplikationen verwenden eine "Sprung-Logik", so dass, wenn Sie die Frage 1 mit der Option C beantworten, dann springe Sie zu Frage 5. Dieser Ansatz ist sehr begrenzt, da es schwer zu validieren ist, und leicht schief geht, wenn Sie Fragen neu ordnen. AM verwendet eine Boolesche Relevanz-Gleichung um zu spezifizieren unter welchen Bedingungen eine Frage gültig sein könnte. Wenn die Frage relevant ist, dann wird die Frage gestellt, ansonsten ist Sie Nicht Anwendbar, und der Wert NULL wird in der Datenbank gespeichert. Dies ist ähnlich zu dem, was über dem Bedingungseditor gemacht werden kann, aber mit EM können Sie einfacher viel komplexere und leistungsfähige Kriterien festlegen (und Sie können Variablennamen statt SGQA Namensgebung nutzen). Dieses Bild zeigt einen Weg, um die Relevanz-Logik für eine Umfrage zu überprüfen. Es berechnet den Body-Mass-Index (BMI). Die Relevanz Gleichung wird in eckigen Klammern direkt nach dem Variablennamen (grün) gezeigt. So sind die Bedeutung von Gewicht (weight), weight_units, Größe (height) und height_units alle 1, was bedeutet, dass diese Fragen immer gestellt werden. Allerdings ist die Relevanz für BMI {! IS_EMPTY (height) und! IS_EMPTY (weight)}, was bedeutet, dass der BMI nur berechnet wird, wenn der Teilnehmer einen Wert für Höhe und Gewicht eingibt(wodurch das Risiko einer Division durch Null vermieden wird). Auch wird die Frage Bericht (Report) nur angezeigt, wenn der Teilnehmer Antworten auf vier Fragen (height, height_units, weight, weight_units) gibt. [[File:tutorial1.jpg]] Relevanz wird an folgenden Stellen gezeigt und ist bearbeitbar: <span id="Viewing_/_Editing_Question-Level_Relevance"></span> ===Betrachten / Bearbeiten der Relevanz auf Fragenebene=== Diese Gleichung berechnet den Body-Mass-Index (BMI). Dies wird nur gefragt, wenn die Person vorher ihre Größe und Gewicht eingegeben hat. [[File:tutorial2.jpg]] Dies ist der Bearbeitungs-Bildschirm für die BMI Frage. [[File:tutorial3.jpg]] Beachten Sie, dass Sie geschweiften Klammern nicht nutzen dürfen, wenn Sie eine Relevanz Gleichung eingeben. <span id="Viewing_/_Editing_Group-Level_Relevance"></span> ===Betrachten / Bearbeiten Relevanz auf Gruppenebene=== Dies ist eine Stichprobenerhebung. Auf der ersten Seite werden Sie gefragt, wie viele Personen bei Ihnen wohnen, und speichert dies in der Variablen "cohabs". Diese Seite wird nur angezeigt, wenn Sie mehr als einen Mitbewohner haben (also für die zweite Person, die mit Ihnen zusammen lebt) und auch nur, wenn Sie angegeben haben, wie Person 1 mit Ihnen verwandt ist (p1_rel). [[File:tutorial4.jpg]] Wie Sie sehen, hat die Gruppe auch Relevanzkriterien auf Frageebene, so dass jede Frage erst erscheint, wenn Sie die Frage davor beantwortet haben (z.B. {!Is_empty (p1_sex)} ). EM kombiniert für Sie die Relevanz auf Gruppen- und Fragenebene. Fragen in einer Gruppe werden nur dann gestellt, wenn die Gruppe als Ganzes relevant ist. Dann wird nur die Teilmenge der relevanten Fragen innerhalb der Gruppe abgefragt. So sieht es aus, wenn man die Relevanz auf Gruppenebene für diese Frage bearbeitet: [[File:tutorial5.jpg]] Beachten Sie, dass Sie geschweiften Klammern nicht nutzen dürfen, wenn Sie eine Relevanzgleichung eingeben. ==Tailoring/Piping== Mit EM können Sie einfach und komplex das bedingte Anpassen Ihrer Fragen durchführen. Manchmal brauchen Sie nur eine einfache Ersetzung, zum Beispiel: "Sie haben angegeben, dass Sie <nowiki>[ </nowiki>Produkt] gekauft haben. Was hat Ihnen am besten gefallen?" Manchmal brauchen Sie eine bedingte Ersetzung wie "<nowiki>[ </nowiki>Herr/Frau] <nowiki>[</nowiki> NachName], wären Sie bereit, unsere Umfrage auszufüllen? ". In diesem Fall möchten Sie Herrn oder Frau basierend auf dem Geschlecht der Person verwenden. In anderen Fällen benötigen Sie eine noch komplexere Substitution (zum Beispiel basierend auf einer mathematischen Berechnung). EM unterstützt jede dieser Arten von Anpassung/Ersetzung. <span id="Conditional_Equations"></span> ===Bedingte Gleichungen=== Das Body-Mass-Index (BMI) Beispiel zeigt die Möglichkeit, den BMI einer Person zu berechnen, sogar wenn sie Größe und Gewicht in metrischen oder nicht metrischen Einheiten eingeben lassen möchten. [[File:tailoring7.jpg]] Hier ist weight_kg {if (weight_units == 'kg', Gewicht, Gewicht * .453592)}. Diese if() - Funktion bedeutet, dass, wenn der Teilnehmer das Gewicht in Kilogramm eingegeben hat, dieser Wert verwendet wird. Andernfalls muss der eingegebene Wert (der in Pfund angegeben wurde) mit .453592 multipliziert werden, um ihn in Kilogramm zu konvertieren. Die Variable height_m verwendet einen ähnlichen Ansatz, um die Höhe der Person in Metern zu berechnen, selbst wenn sie ihre Größe in Zoll eingegeben hat. Der BMI berechnet die Gewichtsformel als {weight_kg / (height_m * height_m)}. Zum Schluss passt der Bericht über Bedingungen die Nachricht an die Angaben des Teilnehmers an und teilt ihm mit, was er eingegeben hat. ("Sie sagten, dass Sie 2 Meter groß sind und 70 kg wiegen.") Obwohl in dem obigen Bild nicht gut dargestellt, verwendet weight_status verschachtelte if() - Anweisungen, um die Person als untergewichtig bis übergewichtig zu klassifizieren. Sie können die Gleichung in der Logikansicht anzeigen lassen. [[File:tailoring8.jpg]] Im Bearbeitungsfenster für diese Frage können Sie zwei Dinge sehen: #Die Anpassung muss Ausdrücke mit geschweiften Klammern umgeben #Ausdrücke können sich über mehrere Zeilen erstrecken, wenn Sie, wie in diesem Fall, die Lesbarkeit erleichtern möchten, um die verschachtelte bedingte Logik zu lesen. [[File:tailoring9.jpg]] <span id="Tailored_Questions,_Answers,_and_Reports"></span> ===Maßgeschneiderte Fragen, Antworten und Berichte=== <div class="simplebox">Hinweis: Die dynamische Anpassung funktioniert möglicherweise nicht, wenn Antwortoptionen in Auswahlfeldern auf derselben Fragenseite verfügbar gemacht werden. Dies resultiert aus der Tatsache, dass die Anpassung einen <nowiki></nowiki> <span>Tag einfügt, der innerhalb der Auswahloptionen ungültig ist.</span> Dieses Beispiel zeigt den BMI-Bericht. [[File:tailoring10.jpg]] Hier ist das Bearbeitungs-Fenster für die gleiche Frage. [[File:tailoring11.jpg]] Wie Sie sehen können, wird alles in geschweiften Klammern als Ausdruck behandelt und ist daher im vorherigen Bild syntaktisch hervorgehoben (farblich gekennzeichnet). Wenn Sie Tippfehler hatten (z. B. falsch geschriebene oder undefinierte Variablennamen oder Funktionen), würde EM einen Fehler wie diesen anzeigen, der zeigt, dass height_unit ein undefinierter Variablenname ist (eigentlich heißt er height_units) und rnd() eine undefinierte Funktion ist (Der richtige Funktionsname ist Round()). In beiden Fällen sind die Fehler mit einem roten Rahmen versehen, um das Erkennen und Beheben zu erleichtern. [[File:tailoring12.jpg]] Sie sehen auch, dass Sie schnell komplexe Berichte erstellen können, beispielsweise eine Tabelle mit eingegebenen Werten oder maßgeschneiderte Ratschläge. Bitte denken Sie daran, dass alle Anpassungen Ausdrücke mit geschweiften Klammern umgeben müssen, damit LimeSurvey weiß, welche Teile der Frage Freitext sind und welche über den Ausdrucksmanager analysiert werden sollten. <span id="Validation"></span> ==Validierung== EM steuert, wie die meisten erweiterten Frageoptionen funktionieren. Diese steuern Aspekte wie die minimale/maximale Anzahl von Antworten; Min./Max. Einzelwerte; Min/Max-Summenwerte; und Überprüfen, ob die eingegebenen Werte mit den angegebenen Zeichenfolgenmustern übereinstimmen. Sie geben diese erweiterten Frageoptionen weiterhin wie gewohnt ein. Jetzt wird jedoch jeder Wert in einem dieser Felder als Ausdruck betrachtet, sodass Sie Min/Max-Kriterien mit komplexen bedingten Beziehungen zu anderen Fragen haben können. Da die erweiterte Frageoption in all diesen Fällen immer als Ausdruck betrachtet wird, verwenden Sie bei der Angabe keine geschweiften Klammern. Die Seiten [[Expression Manager-Beispielumfragen|Beispielumfragen]] zeigen viele Arbeitsbeispiele für die Verwendung von Ausdrücken für Validierungen. <span id="Introduction"></span> =Einführung= LimeSurvey verwendet das neue Expression Manager (EM)-Modul, mit dem LimeSurvey komplexere Verzweigungen, Bewertungen, Validierungen und Anpassungen unterstützen kann. Es ersetzt die Art und Weise, wie LimeSurvey Ersetzungen, Bedingungen und Bewertungen im Backend verwaltet. Außerdem wird die Verarbeitung erheblich beschleunigt, da die meisten Datenbanklesevorgänge zur Laufzeit entfallen. EM wurde von Dr. Thomas White (TMSWhite) entwickelt. Diese Wiki-Seite ist die maßgebliche Referenz für die Syntax und Funktionalität von Expression Manager. ==Schlüsseldefinitionen== #'''Ausdruck''': Alles, was von geschweiften Klammern umgeben ist #*Solange direkt nach der öffnenden Klammer oder vor der schließenden geschweiften Klammer kein Leerzeichen steht. #*Der Inhalt von Ausdrücken wird von EM ausgewertet, sodass sie mathematische Formeln, Funktionen und komplexe Zeichenfolgen- und Datumsverarbeitung enthalten können. #'''Tailoring''': Manchmal auch „Piping“ genannt, ist dies der Prozess von Text bedingt ändern #*Sie haben Zugriff auf alle „Ersatzfelder“, Teilnehmerdaten und Antwortdaten. #*Sie haben außerdem einfacheren Zugriff auf Fragen, Antworten und deren Eigenschaften. #'''Relevanz'''-Gleichung: Ein neues Fragenattribut, das die Sichtbarkeit der Frage steuert #*Wenn eine Relevanzgleichung vorhanden ist, wird die Frage nur angezeigt, wenn die Relevanz „wahr“ ergibt. #*Intern alle array_filter und array_filter_exclude Befehle erhalten Relevanz auf Unterfrageebene. #'''Gleichung''' Fragetyp: Ein neuer Fragetyp, der Berechnungen oder Berichte in der Datenbank speichert #*Es ähnelt einer Boilerplate-Frage, deren Inhalt wird jedoch in gespeichert die Datenbank, auch wenn Sie „Diese Frage immer ausblenden“ eingestellt haben. #'''Fragecode''': Dies ist der bevorzugte Variablenname für EM #*Dies kann ein beschreibender Name sein, der den Zweck der Frage angibt, was das Lesen komplexer Logik erleichtert. #*Gültige Fragecodes sollten NICHT mit einer Zahl beginnen. Wenn Sie also den Fragecode zum Nummerieren Ihrer Fragen verwenden, verwenden Sie einfach „q1“, „q1a“ oder „g1q2“. #*Dies ist derzeit der Variablenname, wenn Sie Daten nach SPSS oder R exportieren. Wenn Sie also statistische Analysen durchführen, haben Sie dies wahrscheinlich bereits eindeutig festgelegt. <span id="Do_I_have_to_use_EM?"></span> ==Muss ich den AM benutzen?== Die kurze Antwort ist Nein (aber auch Ja). EM ist vollständig abwärtskompatibel mit bestehenden Umfragen. Wenn Sie also gerne Bedingungen und Bewertungen im Stil verwenden möchten, den LimeSurvey in Versionen <= 1.91+ verwendet hat, können Sie dies weiterhin tun. EM ersetzt jedoch vollständig die Art und Weise, wie LimeSurvey intern mit Bedingungen umgeht. Obwohl Sie den Bedingungen-Editor weiterhin zum Erstellen und Verwalten von Bedingungen verwenden können, konvertiert LimeSurvey 1.92 diese in die entsprechenden Relevanzgleichungen. Im Rahmen des Upgrades konvertiert LimeSurvey 1.92 automatisch alle vorhandenen Bedingungen in Relevanzgleichungen. Dies sollte Ihnen das Beste aus beiden Welten bieten – Sie können LimeSurvey weiterhin wie gewohnt verwenden, sehen aber das Relevance Equation-Äquivalent, sodass Sie nach und nach direkt zu Relevance Equations wechseln können, wann immer Sie es für richtig halten. <span id="Can_I_mix_use_of_Conditions_and_Relevance?"></span> ==Kann ich eine Mischung aus Bedingungen und Relevanz nutzen?== Ja. Für einige Fragen können Sie den Bedingungen-Editor und für andere den Relevanz-Editor verwenden. Bedingungen werden automatisch in Relevanz konvertiert, wenn Sie die Frage speichern. Beachten Sie, dass wir bei Verwendung des Bedingungen-Editors davon ausgehen, dass diese Bedingungen alle manuell eingegebenen Relevanzgleichungen überschreiben sollen. Wenn Sie also über bestehende Bedingungen verfügen und die Relevanz manuell bearbeiten möchten, löschen Sie bitte zuerst die Bedingungen für diese Frage. Kopieren Sie insbesondere die generierte Relevanzgleichung in einen Texteditor, löschen Sie über das Menü „Bedingungen“ alle Bedingungen für diese Frage (wodurch auch die Relevanz gelöscht wird), bearbeiten Sie dann die Frage und fügen Sie die generierte Relevanzgleichung aus dem Texteditor wieder ein das Relevanzfeld für diese Frage (und speichern Sie die Frage). Wenn genügend Nachfrage zum Löschen von Bedingungen besteht, ohne die generierte Relevanzgleichung zu löschen, könnten wir einen Massenkonvertierungsprozess hinzufügen. <span id="How_should_I_choose_between_Conditions_and_Relevance?"></span> ==Wie soll ich zwischen Bedingungen und Relevanz wählen?== Hier ist eine Liste der Vor- und Nachteile jedes Stils: {| class="wikitable" !Stil!!Vorteile!!Nachteile |- |Bedingungen||1. Schöne GUI zum Erstellen einfacher Bedingungen<br/> 2. GUI gut dokumentiert und vom Support-Team verständlich||1. Unterstützt nur einfache Vergleiche und funktioniert nicht gut mit UND/ODER-Bedingungen<br/> 2. Kaskadierende Bedingungen funktionieren unregelmäßig<br/> 3. Langsam – datenbankintensiv, kann daher lange Umfragen verlangsamen<br/> 4. Einige haben Probleme mit den Nachladebedingungen gemeldet<br/> 5. Die GUI lässt sich nicht gut skalieren, wenn es Dutzende, Hunderte oder Tausende von Fragen gibt<br/> 6. Die Konvertierung papierbasierter Umfragen kann langsam sein, da SGQA-Namen verwendet werden müssen<br/> 7. Oft ist ein Programmierer erforderlich, um die für komplexe Verzweigungen benötigte Logik individuell zu programmieren |- |Relevanz||1. Unterstützt sehr komplexe Logik, einschließlich über 80 Funktionen und Mathematik-/String-Operatoren<br/> 2. Perfekte Unterstützung für kaskadierende Logik<br/> 3. Schnell – keine zusätzlichen Datenbankaufrufe, unterstützt daher Umfragen mit mehr als 1000 Fragen<br/> 4. Keine Probleme beim Neuladen der Logik, da keine SGQA-Codes erforderlich sind<br/> 5. Syntax-Hervorhebungsskalen für Umfragen mit mehr als 1000 Fragen<br/> 6. Einfach und schnell zu verwenden für Gruppen, die bestehende papierbasierte Umfragen computerisieren möchten.<br/> 7. Unterstützt problemlos halbstrukturierte Interviews und epidemiologische Umfragen, ohne dass ein Programmierer erforderlich ist||1. Keine GUI für einfache Bedingungen – verwenden Sie stattdessen Syntaxhervorhebung<br/> 2. Neu, daher haben Support-Teams EM noch nicht gemeistert. |} Das Fazit lautet: Wenn Sie mit der Funktionsweise von LimeSurvey 1.91+ zufrieden sind, gibt es keinen Grund, Ihre Vorgehensweise zu ändern. <span id="What_are_some_other_benefits_of_using_EM?"></span> ==Was sind andere Vorteile der Verwendung von AM?== Hier sind einige der anderen Gründe, weshalb Sie EM verwenden können: #Berechnungen – Sie können jede erdenkliche Berechnung erstellen: #*Sie haben Zugriff auf alle gängigen mathematischen Operatoren und Funktionen #* Sie haben Zugriff auf über 70 mathematische, Datums- und Zeichenfolgenverarbeitungsfunktionen #*Es ist für Entwickler ziemlich einfach, neue Funktionen hinzuzufügen, wenn Benutzer sie benötigen #Berechnungen in der Datenbank speichern #*Sie können jetzt einfache und komplexe Berechnungen und/oder Skalenergebnisse berechnen und diese in der Datenbank speichern, ohne dass JavaScript erforderlich ist #*Sie verwenden dazu den Fragetyp „Gleichung“ #Bewertungen #*Sie können jetzt Bewertungen erstellen oder Ergebnisse aus jedem Fragetyp skalieren, und nicht nur aus der Teilmenge, die früher unterstützt wurde #*Sie können Tailoring verwenden, um laufende oder Gesamtbewertungsergebnisse überall dort anzuzeigen, wo Sie sie benötigen – sogar auf derselben Seite #*Sie haben mehr Kontrolle über die Berichte, die auf der Grundlage dieser Bewertungsergebnisse generiert wurden #*Sie können Bewertungsergebnisse in der Datenbank speichern, ohne dass JavaScript erforderlich ist #*Sie können Bewertungsergebnisse ausblenden, ohne dass JavaScript oder CSS erforderlich sind #Ersatzfelder #*Anstatt {INSERTANS:SGQA} zu verwenden, können Sie einfach den Fragecode verwenden – das erleichtert das Lesen und Validieren #*Dadurch wird auch die häufige Notwendigkeit vermieden, Fragen zu bearbeiten, um den SGQA-Code zu ändern, damit alles funktioniert #Tailoring – Sie können Text basierend auf anderen Werten bedingt anzeigen #*Verwenden Sie den passenden Titel für einen Betreff, z. B. „Hallo<nowiki> [</nowiki> Herr/Frau Smith]" #*Geben Sie grammatikalisch korrekte Sätze aus, wenn Singular/Plural wichtig sind: (z. B. „Sie haben 1 Kind“ vs. „Sie haben 2 Kinder") #*Konjugieren Sie Verben entsprechend und Substantive basierend auf dem Geschlecht und der Pluralität des Subjekts #Neue Variablenattribute – Sie können auf Folgendes zugreifen, um Ihre Anpassung vorzunehmen: #* (kein Suffix) – ein Alias für qcode.code #*.code – der ausgewählte Antwortcode für die Frage, wenn er relevant ist (sonst leer), oder der Textwert, wenn es sich nicht um eine codierte Frage handelt #*.NAOK – wie .code, kann aber Teil von Berechnungen oder Listen sein, auch wenn irrelevant #*.value – der Bewertungswert für die Frage, wenn sie relevant ist (sonst leer), oder der Textwert, wenn es sich nicht um eine codierte Frage handelt – verfügbar, wenn Bewertungen für die Umfrage aktiviert sind, andernfalls immer null #*.valueNAOK – das Gleiche wie .value, kann aber Teil von Berechnungen oder Listen sein, auch wenn es irrelevant ist #*.shown – die Antwort, wie sie dem Benutzer angezeigt wird (dies ist die Aufgabe von {INSERTANS:xxx}) #*.qid – die Frage-ID #*.gid – die Gruppen-ID #*.sgqa – der SGQA-Wert für die Frage #*.jsName – der korrekte Javascript-Variablenname für die Frage, unabhängig davon, ob auf dieser oder einer anderen Seite definiert #*.qseq – die Fragensequenz (beginnend bei 0) #*.gseq – die Gruppensequenz (beginnend bei 0) #*.obligatorisch – ob die Frage obligatorisch ist (J/N) #*.question – der Text der Frage #*.relevance – die Relevanzgleichung für die Frage #*.grelevance – die Relevanzgleichung für die Gruppe #*.relevanceStatus – ob die Frage aktuell relevant ist oder nicht (boolean (kann in PHP und JS unterschiedlich sein)) #*.type – der Fragetyp (der einstellige Code) #Dynamische On-Page-Änderungen #*Alle Relevanz-, Berechnungs- und Anpassungsfunktionen funktionieren dynamisch auf einer Seite – Änderungen an Werten aktualisieren die Seite also sofort #*Sie haben also Fragen, die dynamisch angezeigt werden oder verschwinden, je nachdem, ob sie relevant sind #*Fragen werden basierend auf den Antworten auf der Seite auch dynamisch angepasst, sodass Sie laufende Summen, maßgeschneiderte Sätze und benutzerdefinierte Berichte sehen können #Neuer Dateneingabebildschirm #*Zusätzlich zur Verwendung mit dem aktuellen Dateneingabesystem können Sie einfach Survey-All-In-One verwenden #*Dies unterstützt die On-Page-Relevanz und -Anpassung, sodass Dateneingabesachbearbeiter schnell durchblättern können und nur noch die relevanten Antworten eingeben müssen #*Dies kann von entscheidender Bedeutung sein, wenn Ihre Dateneingabeperson die Anpassung sehen muss, die ebenfalls dynamisch ist #Macht die meisten benutzerdefinierten JavaScript-Anforderungen überflüssig #*EM unterstützt problemlos komplizierte Berechnungen und Bewertungen, Anpassung und bedingte Logik #*Einige Dinge benötigen weiterhin JavaScript (wie benutzerdefinierte Layouts und das bedingte Ausblenden von Fragen-Unterelementen), aber Ihr JavaScript kann die EM-Funktionen verwenden, sodass Sie auf Fragen über Ihren Qcode statt über SGQA zugreifen können und Sie können auf eine der oben aufgeführten Frageneigenschaften zugreifen <span id="What_are_some_other_helpful_new_features_enabled_by_EM?"></span> ==Welche weiteren hilfreichen neuen Funktionen bietet EM?== Unabhängig davon, ob Sie weiterhin den Bedingungseditor verwenden oder Relevanzgleichungen manuell erstellen, erhalten Sie diese zusätzlichen Vorteile: #Sie können komplexere Validierungskriterien erstellen #*Alle erweiterten Frageattribute (wie max_answers, min_num_value_n, max_num_value) können Ausdrücke verwenden. So können Ihre Min/Max-Kriterien leicht auf der Grundlage früherer Antworten angepasst werden, selbst wenn diese sich auf derselben Seite befinden. #*EM übernimmt auch alle auf regulären Ausdrücken basierenden Validierungen, sodass Sie Preg und Gleichung robust kombinieren können. basierend auf Frageattributen. #Einfaches Neuanordnen (oder Löschen) von Fragen und Gruppen #*Vor Version 1.92 konnten Sie Fragen oder Gruppen nicht neu anordnen, wenn LimeSurvey dachte, dass eine solche Neuordnung kaputt gehen könnte Bedingungen, unter denen sie verwendet wurden. Ebenso konnten Sie Fragen nicht löschen, wenn andere Fragen davon abhingen. #*Mit der Syntaxhervorhebung von EM ist es leicht zu erkennen und zu überprüfen, ob Sie versuchen, Fragen zu verwenden, bevor sie deklariert werden. Deshalb haben Sie jetzt die Möglichkeit, Fragen und Gruppen jederzeit neu anzuordnen oder zu löschen. EM aktualisiert die gesamte Syntaxhervorhebung, um Ihnen potenzielle Fehler anzuzeigen. #*Die Ansicht für die Neuordnung von Fragen wurde verbessert, um diese Überprüfung zu erleichtern. Jetzt werden die Relevanzgleichung und die Anpassung der Frage angezeigt, sodass Sie sofort sehen können, ob Variablen rosa werden (was bedeutet, dass sie vor der Deklaration verwendet werden). #Der Fragen-/Gruppennavigationsindex ist immer verfügbar und genau #*Vor Version 1.92 waren diese Indizes bei komplexen Bedingungen nicht verfügbar. #*Mit EM können wir garantieren, dass sie korrekt sind. #*Betreffs können sogar zu einer früheren Frage zurückspringen und die Antwort ändern, dann vorwärts springen (oder abschicken) #**Beim Vorwärtsspringen validiert EM alle dazwischen liegenden Fragen/Gruppen erneut. #**Wenn Fragen irrelevant werden, werden sie in der Datenbank auf NULL gesetzt damit Ihre Daten intern konsistent sind. #**Wenn Fragen relevant werden oder erneut Pflicht- oder Validierungsregeln nicht bestehen, stoppt EM auf dieser Seite und zwingt den Benutzer, diese Fragen zu beantworten, bevor er zum endgültigen Ziel springt. #Automatische Konvertierung von Bedingungen in Relevanz #*Wenn Sie Ihre Datenbank aktualisieren, werden für alle vorhandenen Umfragen, die über Bedingungen verfügen, Relevanzgleichungen generiert. #*Wenn Sie eine Umfrage importieren, werden nach Bedarf Relevanzgleichungen erstellt. #*Wann immer Sie Bedingungen hinzufügen, löschen oder ändern, generiert EM die entsprechende Relevanzgleichung. #Praktische Syntaxhervorhebung #*Wenn EM die Relevanzgleichung anzeigt, wird auch der Qcode angezeigt, auch wenn Sie haben einen SGQA-Code eingegeben, da wir davon ausgehen, dass dieser leichter zu lesen ist. #*Alle Variablen sind farblich gekennzeichnet, um anzuzeigen, ob sie vor oder nach der aktuellen Frage (oder vor oder nach der aktuellen Gruppe) deklariert wurden. Dadurch können Sie schnell Fälle erkennen und beheben, in denen Sie versuchen, Variablen für Relevanz (einschließlich Array_Filter), Anpassung oder Validierungsgleichungen zu verwenden, bevor Sie sie deklarieren. #*Außerdem, wenn Sie mit der Maus über die farbcodierte Variable fahren, sehen Sie die wichtigsten Metadaten zu dieser Frage. Dazu gehören die Gruppensequenznummer, die Fragesequenznummer, der Qcode, der Text der Frage und alle verfügbaren Antwortoptionen (wenn es sich um einen Fragetyp mit aufgezählten Antwortoptionen handelt). #**Die Liste der Antwortoptionen verwendet diese Syntax : 'answers':{key:val, ... }. #**''key'' hat die Syntax ''''scale~code'''', wobei ''scale'' die Antwortskala ist (z. B. für Dual Scale) und „code“ ist der Antwortcode. #**''val'' hat die Syntax ''''value~shown'''', wobei ''value'' steht der Bewertungswert (bei Verwendung von Bewertungen, andernfalls „Code“) (z. B. Qcode.value), und „shown“ ist der Anzeigewert, wie er vom Subjekt gesehen wird (z. B. Qcode.shown). #**Dies bedeutet, dass viele Umfragen Berechnungen verwenden können, ohne dass der Bewertungsmodus erforderlich ist. Wenn Sie Antwortoptionen aufgelistet haben, die eindeutig, nicht dezimal und nicht negativ sind, können Sie einfach Berechnungen anhand der Qcode.code-Werte durchführen. #Einfache Überprüfung der gesamten Umfragelogik und des Inhalts #*Das gibt es eine neue Funktion „Umfragelogik anzeigen“, mit der Sie alles über die Umfrage (oder Gruppe oder Frage) auf einer einzigen Seite sehen können. #*Es zeigt die Gruppen-, Frage-, Unterfrage- und Antwortebenendetails für den ausgewählten Bereich an (Umfrage vs. Gruppe vs. Frage). #*Es zeigt auch die Relevanz, die Relevanz auf Unterfrageebene (für array_filter und array_filter_exclude) und die generierte Validierungsgleichung (für preg und alle Validierungsregeln wie Min/Max-Summe/Anzahl von Werten) und alle nicht leeren Frageattribute. #*Alles ist syntaxhervorgehoben, sodass Sie potenzielle Syntaxfehler erkennen können (wie unausgeglichene Klammern oder die Verwendung von Variablen, bevor sie deklariert wurden). #*Die Syntax- Das Hervorheben unterstützt die schnelle Navigation und Bearbeitung der Umfrage. #**Wenn Sie auf einen Variablennamen klicken, wird ein Browserfenster (oder eine Registerkarte) geöffnet, in dem Ihnen diese Frage angezeigt wird und Sie sie bearbeiten können. #** Wenn Sie auf einen Gruppennamen klicken, wird ein Browserfenster (oder eine Registerkarte) geöffnet, in dem die Gruppen-Neuordnungsansicht angezeigt wird, sodass Sie Fragen einfach verschieben können. #**Alle Fragenattribute werden auch syntaktisch hervorgehoben. Auf diese Weise können Sie Ausdrücke in erweiterten Frageoptionen festlegen und anzeigen (z. B. die maximale/minimale Anzahl/Summe der Werte auf einem Ausdruck basieren). #*Der EM-Autor verwendete eine ähnliche Ansicht (etwas übersichtlicher), um seinen zusammenarbeitenden Epidemiologen und Institutionen zu helfen. Das Review Board validiert und autorisiert Umfragen mit Tausenden von Fragen in stark verzweigten und maßgeschneiderten strukturierten Interviews. <span id="Getting_Started"></span> =Erste Schritte= Der beste Einstieg in EM ist: *Installieren Sie die neueste stabile Version von http://www.limesurvey.org/en/download. *Importieren und erkunden Sie die [[ExpressionScript-Beispielumfragen|Beispielumfragen]]. *Entdecken Sie die [[ExpressionScript-Anleitungen|Anwendungsfälle und Anleitungen]] und [[ExpressionScript-Beispiele|Schritt-für-Schritt-Beispiele]]. *Entdecken Sie die EM-Dokumentation (diese Seite). *Untersuchen Sie die integrierte EM-Testsuite **Wählen Sie in jeder Umfrage unter „Tools“ die EM-Option aus **Verfügbare Funktionen listet die über 70 Funktionen und Syntax auf **Einheitentests von isolierten Ausdrücke ***zeigt Beispiele für die Verwendung aller EM-Funktionen und -Operatoren sowie die PHP- und JavaScript-Ergebnisse ***Beachten Sie, dass es in den PHP- und JavaScript-Versionen nur wenige Funktionen gibt, die unterschiedliche Ergebnisse generieren. Auf dieser Seite erfahren Sie dies Planen Sie Ihre EM-Logik entsprechend. <span id="What_Functionality_does_Expression_Manager_Extend/Replace?_(LimeSurvey_<=_1.91+)"></span> =Welche Funktionalität erweitert/ersetzt der Ausdrucksmanager? (LimeSurvey <= 1.91+)= <span id="Conditions_=>_Relevance"></span> ==Bewertungen => Gleichungen und Micro-Tailoring== Mit Bewertungen konnten Benutzer Punktzahlen aus einer Sammlung von Fragen erstellen. Jedoch passten sie sich nicht dynamisch an die aktuelle Seite an und die Werte waren nicht in der Datenbank abgespeichert. Man musste außerdem die LimeSurvey Datenbanken anpassen. <span id="Assessments_=>_Equations_and_Micro-Tailoring"></span> ==Ersatz => Micro-Tailoring== Benutzer konnten einige Nachrichten und Fragen anhand der vorherigen Antworten anpassen. Eine Frage könnte zum Beispiel ''{TOKEN:VORNAME}, und Sie sagten noch, dass {INSERTANS:111X3X4} Ihre Lieblingssportart wäre'' sein. Jedoch konnte man nicht bedingt anpassen, Verben konjugieren oder Nomen deklinieren ohne JavaScript zu benutzen. <span id="Replacements_=>_Micro-Tailoring"></span> ==Ersatzteile => Micro-Tailoring== Benutzer könnten einige Nachrichten und Fragen basierend auf früheren Antworten anpassen. Eine Frage könnte beispielsweise lauten: „{TOKEN:FIRSTNAME}, Sie sagten, {INSERTANS:111X3X4} sei Ihr Lieblingssport.“ Allerdings war es ohne ausgefallenes JavaScript nicht möglich, bedingte Anpassungen vorzunehmen (z. B. „Herr“ oder „Frau“ je nach Geschlecht der Person zu sagen) oder Verben zu konjugieren oder Substantive zu deklinieren. Autoren konnten Umfragen implementieren, die scheinbar maßgeschneiderte Fragen stellten, aber es waren separate Fragen für jede Permutation und komplexe Bedingungen erforderlich, um zu entscheiden, welche Fragen angezeigt werden sollten. <span id="Validation"></span> ==Validierung== Fragen konnten mit regulären Ausdrücken, oder mit Minimal- oder Maximalwerten validiert werden. Außerdem konnte man eine SGQA Antwort als Mindest- oder Höchstbetrag nehmen. Jedoch konnten Berechnungen von anderen Variablen ohne JavaScript nicht für die Überprüfungen verwendet werden. <span id="Equations"></span> ==Gleichungen== Gleichungen wurden ohne JavaScript nicht unterstützt. <span id="Equation_Question_Type"></span> ==Gleichungs-Fragetyp== Gleichungen konnten ohne JavaScript nicht in der Datenbank abgespeichert werden (zum Beispiel die Endpunktzahl für eine Beurteilung). <span id="How_Will_Expression_Manager_Replace/Extend_That_Functionality?"></span> =Wie wird der Ausdrucksmanager diese Funktion ersetzen oder erweitern?= Der Ausdrucksmanager ist ein neues Modul in LimeSurvey, es stark vereinfacht komplexe Funktionen zu unterstützen für die früher angepasstes JavaScript verwendet werden musste. Er ersetzt auch die Art und Weise mit der LimeSurvey Bedingungen und Beurteilungen verwaltet. <span id="New_Terminology_When_Referring_to_Expression_Manager_(EM)"></span> ==Neue Bezeichnungsweisen des Ausdrucksmanagers== Der Ausdrucksmanager "denkt" über seine Funktionalität folgend: *'''Relevanzbasierte Verzweigung''' - ist eine Frage relevant, stelle sie, ansonsten nicht (z.B. mach sie unsichtbar) *'''Anpassung''' - Sobald du weißt, welche Fragen gestellt werden sollten, wird durch das Micro-Tailoring angegeben wie die Fragen zu stellen sind. Dadurch können sie nicht nur einfache Dinge austauschen (wie z.B. {TOKEN:VORNAME}), sondern auch die Konjungation von Verben und Deklination von Substantiven basierend auf dem Geschlecht und der Anzahl der Subjekte durchführen. Es erlaubt dir auch die Antwort danach zu verändern, ob die anderen Fragen (oder wie die anderen Fragen) beantwortet wurden. *'''Gleichung''' - Der Ausdrucksmanager fügt auch einen neuen Fragetypen namens Gleichungen hinzu, der die Ergebnisse der Ausdrücke speichert. Der eine Zeichentyp für Gleichungen ist das Asterixzeichen "*". <span id="Relevance_and_Cascading_Relevance"></span> ===Relevanz und Kaskadierende Relevanz=== Jeder Fragetyp verfügt jetzt über eine Relevanzoption, die steuert, ob die Frage angezeigt wird. EM verarbeitet jede der Relevanzgleichungen in der Reihenfolge, in der sie in der Umfrage erscheinen sollen. Wenn der Ausdruck wahr ist (oder fehlt – zur Unterstützung älterer Umfragen), wird die Frage angezeigt. Wenn es nicht relevant ist, wird die Frage ausgeblendet und der Wert wird in der Datenbank auf NULL gesetzt. Wenn in einer Gruppe keine relevanten Fragen vorhanden sind, wird die gesamte Gruppe übersprungen. Wenn außerdem eine der Variablen in einem Ausdruck irrelevant ist, wird der Ausdruck immer als falsch ausgewertet. Dies ermöglicht kaskadierende Relevanz, sodass Sie nicht für jede Frage sehr lange Relevanzgleichungen schreiben müssen. Sagen wir mal, dass es 5 Fragen, Q1-Q5 gibt. Du willst aber nur, dass Q2 angezeigt wird, wenn Q1 beantwortet wurde, und Q3 wenn Q2 beantwortet wurde und so weiter. Die notwendigen Gleichungen wären dann: {| |Frage-Nummer||Relevanz||Frage |- |Q1||1||Wie heißen Sie? |- |Q2||Q1||{Q1}, wie alt sind Sie? |- |Q3||Q2||Also, Sie sind {Q2} Jahre alt. Sind Sie verheiratet? |- |Q4||Q3 == "Y"||{Q1}, wie lange sind Sie schon verheiratet? |- |Q5||Q4||Wie viele Kinder haben Sie, {Q1}? |- | |} Diese Berechnungen werden auch von JavaScript unterstützt - also können Sie die Fragen auf einer Seite platzieren und alles funktioniert weiterhin. Solange Sie sich auf derselben Seite befinden, sind alle von Ihnen eingegebenen Daten weiterhin vorhanden, nur ausgeblendet. Wenn Sie also einige Informationen eingeben, dann eine Option auswählen, die sie irrelevant macht, und sie dann wieder relevant machen, sind Ihre Antworten weiterhin verfügbar. Sobald Sie jedoch zu einer anderen Seite wechseln, gehen alle irrelevanten Antworten aufgrund der Integrität des Datensatzes verloren. <span id="Group-Level_Relevance"></span> ===Relevanz auf Gruppenebene=== Expression Manager unterstützt auch Relevanz auf Gruppenebene. Dies erleichtert die Implementierung von Schleifen. Angenommen, Sie möchten Informationen über bis zu 10 Entitäten (z. B. Produkte oder Personen in einem Haushalt) sammeln. Dabei ermitteln Sie zunächst, für wie viele Entitäten eine Nachverfolgung erforderlich ist (z. B. indem Sie fragen, wie viele Personen in einem Haushalt leben, oder Personen überprüfen lassen, welche Produkte ihnen aus einer langen Liste gefallen). Nachdem Sie wissen, wie viele Entitäten einer Nachverfolgung bedürfen, können Sie die Relevanz auf Gruppenebene wie {count >= 1}, {count >=2}, ... {count >= 10} für jede der 10 Follow-up-Gruppen verwenden. Fragen stellen. Innerhalb jeder Gruppe können Sie eine bedingte Logik auf Fragenebene verwenden (z. B. geschlechts- oder altersspezifische Folgefragen für jedes Thema). Die Fragen- und Gruppenrelevanzgleichungen werden mit UND verknüpft, um zu bestimmen, welche angezeigt werden sollen. <span id="Tailoring_/_Piping"></span> ==Tailoring/Piping== Alles innerhalb von geschweiften Klammern wird nun als Ausdruck behandelt (mit einer Ausnahme, die unten beschrieben wird). Ausdrücke haben zugang zu allen LimeReplacement-Feldern, zu allen Variablen (über verschiedene Aliase), allen typischen Gleichungsoperatoren (mathematisch, logisch und Vergleich) und dutzenden Funktionen (die sogar dynamisch auf Client-Seite funktionieren). Durch die Benutzung dieser Gleichungen, kannst du z.B. solche Dinge machen: #Den Befragten maßgeschneiderte Nachrichten abhängig von früheren Antworten zeigen. #Beurteilungen erstellen und die Beurteilungsergebnisse (oder bedingte Verzweigungen oder Nachrichten) basierend auf diesen Ergebnissen anzeigen lassen. Alles ohne das Beurteilungsmodul selber zu benutzen. #Verben konjugieren und Nomen deklinieren. #Sich Zusammenfassungen der Antworten vor der "Antworten anzeigen" Seite am Ende der Umfrage anzeigen lassen. <span id="Equations"></span> ===Gleichungen=== Es gibt einen neuen Fragetyp namens Gleichung. Er ist wie eine Boilerplate-Frage, bis darauf, dass er den gezeigten Wert in der Datenbank speichert. Also wenn der Gleichungs-Frage-Text eine Beurteilungs-Berechnung enthält, dann würde dieser Wert in der Datenbank in einer Variable, die in öffentlichen oder begrenzten Statistiken angezeigt werden kann, gespeichert werden. Dies löst ein häufiges Featurerequest Beurteilungs-Wertungen in der Datenbank speichern zu können. ==Syntax== Alles innerhalb von geschweiften Klammern wird jetzt als Ausdruck angesehen (mit einer Ausnahme: es darf keine führenden oder nachfolgenden Leerzeichen geben - dies ist notwendig, damit der Ausdrucksmanager nicht versucht eingebettetes JavaScript auszuführen). Beachten Sie, dass Ausdrücke sich über mehrere Zeilen erstrecken können, solange nach der öffnenden geschweiften Klammer oder vor der schließenden geschweiften Klammer kein Leerzeichen steht. Dies ist besonders hilfreich für verschachtelte if()-Anweisungen wie diese: <syntaxhighlight lang="java">{if(is_empty(PFTotals), '', if(PFTotals >= -5 && PFTotals <= -4, 'Very Soft', if(PFTotals >= -3 && PFTotals <= -2, 'Soft', if(PFTotals == -1, 'Etwas weich', if(PFTotals == 0, 'Moderate',! N! if(PFTotals == 1, 'Etwas schwer', if(PFTotals >= 2 && PFTotals <= 3, 'Hard', if(PFTotals >= 4 && PFTotals <= 5, 'Sehr schwer', '' ) ) ) ) ) ) ) )} </syntaxhighlight> <div id="EMsyntax">Expression Manager unterstützt die folgende Syntax:</div> *Alle standardmäßigen mathematischen Operatoren (z. B. +,-,*,/,!) *Alle standardmäßigen Vergleichsoperatoren (z. B. <,<=,==,!=,>,>=, plus diese Äquivalente: lt,le,eq,ne,gt,ge) *Klammern (damit Sie Unterausdrücke gruppieren können) *Bedingungsoperatoren (z. B. &&, | | und diese Äquivalente: und, oder) * Zeichenfolgen in einfachen und doppelten Anführungszeichen (die jeweils Zeichenfolgen mit dem anderen Anführungszeichentyp einbetten können) *Kommaoperator (kann also eine Liste von Ausdrücken haben und nur das Endergebnis zurückgeben) *Zuweisungsoperator (=) *Vordefinierte Variablen (zur Bezugnahme auf Fragen, Frageattribute und Antworten) – z. B. alle SGQA-Codes *Vordefinierte Funktionen (es gibt bereits über 70 und es ist einfach, weitere hinzuzufügen) <span id="Operators"></span> === Operatoren === Die EM-Syntax folgt der normalen Operatorpriorität: {| class="wikitable" !Level!!Operator(s)!!Description |- |1||()||Klammern zum Gruppieren oder Aufrufen von Funktionen |- | 2||! - +||unäre Operatoren: nicht, Negation, unär-plus |- |3||* /||mal, dividieren |- |4||+ -||plus , minus |- |5||< <= > >= lt le gt ge||relative Vergleiche |- |6||== != eq ne||Gleichheitsvergleiche |- |7||und||logisches UND |- |8||oder||logisches ODER |- |9||=||Zuweisung Operator |- |10||,||Kommaoperator |} <span id="Warning_with_plus_operator_(+)"></span> ==== Warnung mit Plus-Operator (+) ==== Aus Gründen der Konsistenz zwischen JavaScript und PHP führt der Plusoperator (+) eine Addition aus, wenn beide Operanden numerisch sind, führt jedoch eine Verkettung durch, wenn beide Teile nicht numerische Zeichenfolgen sind. Wir empfehlen jedoch die Verwendung der Funktion „join()“ für die Verkettung und der Funktion „sum()“ für die Addition, da dies Ihre Absicht klarer macht und unerwartete Ergebnisse vermeidet, wenn Sie Zeichenfolgen erwartet haben, aber stattdessen Zahlen erhalten (oder umgekehrt). <span id="Warning_with_mismatch_between_number_and_string_and_alphabetic_comparison"></span> ==== Warnung mit Nichtübereinstimmung zwischen Zahl und Zeichenfolge und alphabetischem Vergleich ==== Wenn Sie Werte mit Relativ- oder Gleichheitsvergleichen vergleichen möchten, achten Sie auf Typkonflikte. Der vom Benutzer eingegebene Wert oder der ausgewählte Antwortcode kann als Zahl verwendet werden, wenn es sich eindeutig um eine Zahl handelt. Wenn Sie einen der Werte mit <code>"</code> umgeben, wird der Vergleich als Text erzwungen (alphabetischer Vergleich). Wenn Sie numerisch vergleichen möchten, Setzen Sie die Zahl niemals in Anführungszeichen, <code>"</code> . Beispielsweise ist <code>Q0.NAOK > "50"</code> wahr, wenn Q0.NAOK eine numerische Frage mit 9 als Wert ist. Dies liegt daran, dass der Operator <code>></code> davon ausgeht, dass es sich um einen alphabetischen und nicht um einen numerischen Vergleich handelt. <div class="mw-translate-fuzzy"> Um den ganzzahligen Wert sicher zu vergleichen, können Sie <code>[[Expression_Manager#Implemented_Functions|intval]](Q0.NAOK) > 50</code> verwenden. Denken Sie daran, wenn Q0.NAOK keine Zahl (leer oder eine Zeichenfolge) ist, dann intval(Q0. NAOK) === 0. Um den Zeichenfolgenwert ("A" < "B") zu vergleichen, verwenden Sie [[Expression_Manager#Implemented_Functions|strcmp]] direkt: <code>strcmp(Q0.NAOK,"B")</code> oder <code>strcmp(Q0.NAOK,"A5")</code> . </div> <span id="Caution_about_using_Assignment_Operator_(=)"></span> ===Vorsicht bei der Verwendung des Zuweisungsoperators (=)=== Beachten Sie, dass Sie die Zuweisungsoperatoren nur dann verwenden sollten, wenn dies unbedingt erforderlich ist, da sie zu unerwarteten Nebenwirkungen führen können. Wenn Sie beispielsweise den Wert einer vorherigen Antwort ändern, wird die kaskadierende Relevanz und Validierungslogik zwischen dieser Frage und der aktuellen Frage nicht neu berechnet, sodass Sie möglicherweise intern inkonsistente Daten erhalten (z. B. Fragen, die beantwortet bleiben, aber beantwortet werden sollten, wurden auf NULL gesetzt oder Fragen, die übersprungen wurden, aber beantwortet werden sollten). Wenn Sie einer Variablen einen Wert zuweisen möchten, sollten Sie im Allgemeinen einen Fragetyp „Gleichung“ erstellen und einen Ausdruck verwenden, um seinen Wert festzulegen. Da es jedoch seltene Fälle gibt, in denen Menschen diesen Operator wirklich benötigen, haben wir ihn zur Verfügung gestellt. Um Sie vor diesem Operator zu warnen, wird er in den Syntaxgleichungen in roter Schrift angezeigt (damit Sie ihn nicht mit „==“ verwechseln). ===Verwendung des Zuweisungsoperators=== Die Hauptgründe, warum Sie die Zuweisung verwenden möchten, sind: * Sie müssen den Standardwert für eine Frage festlegen, die keine Standardwerte über eine Gleichung akzeptiert (z. B. Listenradio, wobei Sie über die Benutzeroberfläche eine der Antwortoptionen auswählen, aber keine Gleichung eingeben können). Seien Sie jedoch vorsichtig, da LimeSurvey nicht validieren kann, ob Ihre Gleichung eine der zulässigen Antworten für diese Frage generiert. * Sie müssen die Antwort auf eine vorherige Frage basierend auf einer späteren Antwort zwangsweise ändern. * Sie benötigen ein komplexes Kontingent: Verwenden Sie eine versteckte Einzelauswahl für das Kontingent und legen Sie es mithilfe von Zuweisung fest. * usw. Zu diesem Zweck können Sie alle Expression-Manager-Systeme verwenden. {{Alert|Die Zuweisung erfolgt nur in PHP. Dadurch werden keine Werte auf derselben Seite aktualisiert, sondern nur, wenn der Benutzer mit Weiter, Zurück, Speichern … navigiert.}} {{Alert|Wenn Sie für diesen Zweck keinen Typ [[Question_type_-_Equation|Gleichungsfrage]] verwenden: Die Zuweisung erfolgt erst, nachdem die Logik der aktuellen Seite abgeschlossen ist. Die empfohlene Methode besteht darin, immer eine [[Question_type_-_Equation|Gleichungsfrage]] zu verwenden.}} Einige Beispiele: * Legen Sie die Antwort auf eine kurze Textfrage in Kleinbuchstaben fest: <code>{QCODE=strtolower(QCODE.NAOK)}</code> * Legen Sie zu Beginn einer Umfrage eine Standardantwort auf einen Array-Fragetyp fest: <code>{Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}</code> * Legen Sie zu Beginn einer Umfrage eine Standardantwort auf einen Array-Text-Fragetyp fest: <code>{Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}</code> * Antwort mit Bedingung festlegen: <code>{QCODE=if(YesNo="Y","A1","")}</code> <span id="XSS_security"></span> == XSS-Sicherheit == Wenn XSS aktiviert ist, können einige Ausdrucksmanagersysteme nicht verwendet werden: * Beginnen Sie mit einem HTML-Tag im Ausdruck, enden Sie aber mit einem anderen Ausdruck. * Verwenden Sie einen komplexen Ausdruck in der URL. <html>Beispiele und Problemumgehungen: * <code>{if( 1 ,"<strong>","")}information{if( 1 ,"</strong>","")}</code> ist mit der XSS-Sicherheit fehlerhaft, hier können Sie stattdessen verwenden <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> ==Zugang zu Variablen== Expression Manager bietet schreibgeschützten Zugriff auf alle Variablen, die wir benötigen. Aus Gründen der Abwärtskompatibilität bietet es Zugriff auf Folgendes: *TOKEN:xxx – der Wert eines TOKEN (z. B. TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (Nur für NICHT anonyme Umfragen). *[[Hinzufügen eines Frage#Information_aus_vorherigen_Antworten|INSERTANS:SGQA]] – der Anzeigewert einer Antwort (z. B. „Ja“). Für Expression Manager ist es dasselbe wie die Verwendung von {QCODE.shown}. *Alle [[The_template_editor#Keywords|{XXX}-Werte, die von Vorlagen verwendet werden]]. *Im Fragetext können Sie {QID} ersetzen durch die Frage-ID und {SGQ} ersetzt durch den SGQA der Frage. Zusätzlich erlaubt dir der Ausdrucksmanager dich auf Variablen über die Frage-Nummer zu beziehen (auch als Titel in der Datenbank bezeichnet). Dies ist auch das Label der Variable, welches genutzt wird, wenn Sie Ihre Daten zu SPSS, R oder SAS exportieren. Zum Beispiel, wenn Sie Fragen zu dem Namen, Alter und Geschlecht haben, könnten sie ihre Variablen "name", "alter" und "geschlecht" nennen. Dies macht die Gleichungen jedem leichter Verständlich und macht es möglich die Fragen durch zu mischen ohne ein Auge auf die Gruppen und Fragennummern haben zu müssen. <div class='simplebox'> '''Wichtig:''' Es ist nur sicher, auf Variablen zu verweisen, die in vorherigen Seiten oder Fragen vorkommen. </div> Außerdem erlaubt der Ausdrucksmanager auf bestimmte Eigenschaften der Fragen zuzugreifen. {| |Syntax||Bedeutung||Beispiel||Beispiel Ergebnis |- |Qcode||Der Code-Wert der Frage, wenn relevant (sonst leer)||{gender}||'M' |- |Qcode.NAOK||das gleiche wie Qcode - siehe die Diskussion über NAOK||{gender.NAOK}||'M' |- |Qcode.shown||der Anzeigewert der Frage||{gender.shown}||'Male' |- |Qcode.question||der Fragetext||{gender.question}||'What is your gender?' |- |Qcode.mandatory||ob die Frage verpflichtend ist (J/N)||{gender.mandatory}||'N' |- |Qcode.qid||die interne Nummer der Frage (nicht die fortlaufende Nummer)||{gender.qid}||337 |- |Qcode.type||der Fragetyp||{gender.type}||'G' |- |Qcode.jsName||der Javascriptname der Frage||{gender.jsName}||'java1827X3X337' |- | |} <span id="HTML_editor_issue"></span> === HTML-Editor-Problem=== {{Alert|Dieses Problem wurde nach 2.05 Build 140803 behoben}} Wenn Sie den HTML-Editor verwenden, werden einige Zeichen durch HTML-Entitäten ersetzt. * & durch & * < durch < * > durch > Wenn Sie einen HTML-Editor verwenden, müssen Sie: * und für & verwenden * lt für < * le für <= * gt für > * ge für >= <span id="Qcode_Variable_Naming"></span> ==Qcode-Variablenbenennung== Hier sind die Details, wie ein Qcode konstruiert wird (und auf einige Eigenschaften zugegriffen wird), geordnet nach Fragetyp. Generell werden Qcodes wie folgt konstruiert: Fragecode . '_' . SubQuestionID . '_' . ScaleId Für „Kommentar“ und „Sonstiges“ lauten die Fragecodes „QuestionCode_comment“ und „QuestionCode_other“. {| class="wikitable" !Typ!!Beschreibung!!Code!!Unterfragen!!Antwortoptionen!!Skalen!!Antwortcode!!Antwort angezeigt!!Relevanz |- |5||5 Punktauswahl-Optionsfelder||Q1|| ||1-5|| ||{Q1}||{Q1.shown}||{Q1==3} |- |B||Array (10 Punkte Auswahl) Optionsfelder||Q2||L1-L6| |1-10|| ||{Q2_L2}||{Q2_L2.shown}||{Q2_L2==7} |- |A||Array (5 Punktauswahl) Optionsfelder||Q3||1-5| |1-5|| ||{Q3_1}||{Q3_1.shown}||{Q3_1>=3} |- |1||Array (Flexible Labels) Dual Scale||Q4||sq1-sq5||0 :a1-a3||1:b1-b3||{Q4_sq1_0}||{Q4_sq1_1.shown}||{Q4_sq1_1=='b2'} |- |H||Array (flexibel) - Spaltenformat||Q5||1-5||s,m,t|| ||{Q5_1}||{Q5_1.shown}||{Q5_1=='s'} |- |F||Array (flexibel) – Zeilenformat||Q6||F1-F5| |1-5|| ||{Q6_F3}||{Q6_F3.shown}||{Q6_F3==4} |- |E||Array (Erhöhen/Gleich/Verringern) Optionsfelder||Q7||1- 7||I,S,D|| ||{Q7_4}||{Q7_4.shown}||{Q7_4=='D'} |- |:||Array (Multi Flexi) 1 bis 10||Q8||ls1,todo ,ls2||min,max,avg|| ||{Q8_ls1_max}||{Q8_ls2_avg.shown}||{Q8_ls2_min==7} |- |;||Array (Multi Flexi) Text||Q9||hp,st,sw|| 1., 2., 3.|| ||{Q9_hp_3rd}||{Q9_hp_3rd.shown}||{Q9_hp_3rd=='Peter'} |- |C||Array (Ja/Unsicher/Nein) Optionsfelder||Q10|| 1-5||Y,N,U|| ||{Q10_1}||{Q10_1.shown}||{Q10_3=='Y'} |- |X||Boilerplate Question||Q11|| || || || ||{Q11.shown}|| |- |D||Datum||Q12|| || || ||{Q12}||{Q12.shown}|| |- |*||Gleichung||Q13|| || || ||{Q13}||{Q13.shown}||{Q13>5} |- |~124~||Datei-Upload (zeichnet die Anzahl der hochgeladenen Dateien auf)||Q14|| || || ||{Q14}|| ||{Q14>0} |- |G||Dropdown-Liste „Geschlecht“||Q15|| ||M,F|| ||{Q15}||{Q15.shown}||{Q15=='M'} |- |U||Riesiger Freitext||Q16|| || || ||{Q16}||{Q16.shown}||{strlen(Q16)>100} |- |I||Sprachfrage||Q17|| || || ||{Q17}||{Q17.shown}||{Q17=='en'} |- |!||Liste - Dropdown||Q18|| ||1-5|| ||{Q18}||{Q18.shown}||{Q18==3} |- |L||Listen-Dropdown-/Radio-Button-Liste||Q19|| ||AZ|| ||{Q19}||{Q19.shown}||{Q19=='X'} |- |O||Liste mit Kommentar-Dropdown/Radio-Button-Liste + Textbereich||Q20 || ||AF|| ||{Q20},{Q20comment}||{Q20.shown}||{Q20=='B'} |- |T||Langer Freitext||Q21|| || || ||{Q21}||{Q21.shown}||{strstr(Q21,'hello')>0} |- |M||Multiple-Choice-Kontrollkästchen||Q22||AF, other| | || ||{Q22_E}, {Q22_other}||{Q22_E.shown}, {Q22_other.shown}||{Q22_E=='Y'} |- |P||Multiple Choice mit Kommentaren Kontrollkästchen + Text||Q23||AF|| || ||{Q23_D}, {Q23_Dcomment}||{Q23_D.shown}||{!is_empty(Q23)} |- |K||Mehrfache numerische Frage||Q24||self,mom,dad || || ||{Q24_self}||{Q24_self.shown}||{Q24_self>30} |- |Q||Mehrfacher Kurztext||Q25||AF|| || ||{Q25_B}||{Q25_B.shown}||{substr(Q25_B,1,1)=='Q'} |- |N||Numerischer Fragetyp||Q26|| || || ||{Q26}||{Q26.shown}||{Q26 > 30} |- |R||Ranking-Stil||Q27||1-4|| || ||{Q27_1}||{Q27_1.shown}||{Q27_1==3} |- |S||Kurzer Freitext||Q28|| || || ||{Q28}||{Q28.shown}||{Q28=='mine'} |- |Y||Ja/Nein-Optionsfelder||Q29|| || || ||{Q29}||{Q29.shown}||{Q29=='Y'} |} <span id="The_reserved_'this',_'self',_and_'that'_variables"></span> ==Die reservierten Variablen „this“, „self“ und „that“== Sehr oft möchten Sie alle Teile einer Frage auswerten, z. B. zählen, wie viele Unterfragen beantwortet wurden, oder die Ergebnisse summieren. In anderen Fällen möchten Sie nur bestimmte Zeilen oder Spalten einer Frage verarbeiten (z. B. um die Zeilen- oder Spaltensummen abzurufen und sie in der Datenbank zu speichern). Diese reservierten Variablen machen diesen Prozess relativ schmerzlos. Die Variable „diese“ wird ausschließlich in den erweiterten Frageoptionen „Validierungsgleichung für ganze Fragen“ und „Validierungsgleichung für Unterfragen“ verwendet. Es wird auf die Variablennamen jeder Zelle innerhalb dieser Fragen erweitert. Wenn Sie also sicherstellen möchten, dass jeder Eintrag größer als drei ist, würden Sie die „Unterfrage-Validierungsgleichung“ auf (dies > 3) setzen. Die Variablen „self“ und „that“ sind leistungsfähiger und dienen als Makros, die vor der Verarbeitung von Gleichungen erweitert werden. Die Syntaxoptionen sind: *self *self.''suffix'' *self.''sub-selector'' *self.''sub-selector''.'' Suffix'' „Suffix“ ist eines der normalen Qcode-Suffixe (z. B. NAOK, Wert, angezeigt). „Unterselektor“ ist einer von: *Kommentaren – nur Unterfragen, die Kommentare sind (z. B. aus Multiple-Choice mit Kommentar und Liste mit Kommentar) *keine Kommentare – nur Unterfragen, die keine Kommentare sind *sq_X – wobei X eine Zeilen- oder Spaltenkennung ist. Es werden nur Unterfragen ausgewählt, die mit Muster X übereinstimmen. Beachten Sie, dass die Suche nach der vollständigen Code-ID erfolgt, dann sq_X zutrifft und die Unterfragen nX, Achten Sie auf den Fragetyp mit zwei Skalen, bei dem die Unterfragencodes QCODE_SQCODE_1 und QCODE_SQCODE_1 sind, und auf den Fragetyp mit der Rangfolge, bei dem die Unterfragencodes QCODE_1, QCODE_2 .... *nosq_X sind – wobei X eine Zeilen- oder Spaltenkennung ist. Es werden nur Unterfragen ausgewählt, die nicht mit Muster X übereinstimmen. Beachten Sie, dass die Suche nach der vollständigen Code-ID und dann nach der nosq_X-Übereinstimmung erfolgt und die Unterfragen nX, X, Xn nicht umfasst Beispiele: *Wurde ein Teil einer Frage beantwortet? {count(self.NAOK)>0} *Wie hoch ist die Bewertungspunktzahl für diese Frage? {sum(self.value)} Sie können diese auch verwenden, um Zeilen- und Spaltensummen zu erhalten. Angenommen, Sie haben ein Zahlenarray mit den Zeilen AE und den Spalten 1–5. *Wie hoch ist die Gesamtsumme? {sum(self.NAOK)} *Wie hoch ist die Summe von Zeile B? {sum(self.sq_B.NAOK)} *Wie hoch ist die Summe von Spalte 3? {sum(self.sq_3.NAOK)} Die Variable „that“ ähnelt der Variable „self“, ermöglicht Ihnen jedoch die Bezugnahme auf andere Fragen. Seine Syntax ist: *that.''qname'' *that.''qname''.''suffix'' *that.''qname''.''sub-selector'' *that.''qname''.''sub-selector''.''suffix'' „qname“ ist der Fragename ohne Unterfrageerweiterungen. Angenommen, Sie erstellen eine Frage „q1“, das ist ihr „qname“. Beispiele: *Wurde ein Teil der Frage q1 beantwortet? {count(that.q1.NAOK)>0} *Wie hoch ist die Bewertungspunktzahl für q2? {sum(that.q2.NAOK)} *Wie hoch ist die Gesamtsumme von q3? {sum(that.q3.NAOK)} *Wie hoch ist die Summe der Zeile C in q4? {sum(that.q4.sq_C.NAOK)} *Wie hoch ist die Summe von Spalte 2 in q4? {sum(that.q4.sq_2.NAOK)} Die Variablen „self“ und „that“ können für jede Relevanz, Validierung oder Anpassung verwendet werden. Die einzige Einschränkung besteht darin, dass bei Verwendung der Funktion [[Logikdatei anzeigen|Logikdatei anzeigen]] der erweiterte Wert von „self“ und „that“ angezeigt wird. Dadurch können Sie die tatsächlich generierte Gleichung sehen, sodass Sie (und Expression Manager) überprüfen können, ob die Variablen vorhanden sind. Dies kann verwirrend erscheinen, da möglicherweise recht lange Gleichungen angezeigt werden. Wenn Sie jedoch die Frage bearbeiten, sehen Sie die ursprüngliche Gleichung mit „selbst“ und/oder „das“. Beachten Sie außerdem, dass Sie diese Variablen nicht verwenden sollten, wenn (a) Sie jede in einer Gleichung verwendete Variable explizit benennen möchten oder (b) Variablen verwenden, die keine Unterfragen haben (z. B. Fragen mit einer Antwort). In diesen Fällen ist es übertrieben, einer Variablen das Präfix „that“ voranzustellen, und Sie laufen Gefahr, unerwartete Ergebnisse zu erhalten. <span id="Usage_of_NAOK"></span> ==Verwendung von NAOK== NAOK -> „Nicht anwendbar“ (NA) ist in Ordnung (OK) Die Verwendung von NAOK bedeutet, dass alle oder einige der Variablen irrelevant sind (z. B. „Nicht anwendbar“ (NA) ist in Ordnung (OK)). Wenn Sie eine Variable aus einer Frage in eine beliebige Gleichung einfügen: Wenn diese Frage (oder Unterfrage) durch eine Bedingung ausgeblendet ist: Dadurch werden alle Gleichungen deaktiviert. Zum Beispiel: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) gibt immer eine leere Zeichenfolge aus, wenn eine Unterfrage von Q1 gefiltert wird. Um die Anzahl der überprüften Unterfragen in einer solchen Frage zu zählen, kann count(Q1_SQ1.NAOK,Q1_SQ2.NAOK verwendet werden ,Q1_SQ3.NAOK,Q1_SQ4.NAOK). Wenn die Unterfrage ausgeblendet ist: Der Ausdrucksmanager gibt eine leere Zeichenfolge zurück. Ohne NAOK: Wenn eine Frage oder eine Unterfrage ausgeblendet ist: Expression Manager gibt immer eine leere Zeichenfolge zurück, dasselbe gilt für die Rückgabe von „false“. Die angezeigten .NAOK-Codes verwenden immer das NAOK-System (leere Zeichenfolge, wenn ausgeblendet). Wenn Sie jedoch den Code der Antwort benötigen, ist es immer eine gute Idee, .NAOK nach dem Fragecode hinzuzufügen. Außer wenn Sie es brauchen und wissen, was Sie tun. Ein weiteres Beispiel und Informationen finden Sie unter [[#Overriding_Cascading_Conditions|Overriding Cascading Conditions]]. <span id="Access_to_Functions"></span> ==Zugriff auf Funktionen== Der Ausdrucksmanager liefert Zugang zu mathematischen, zeichenketten und nutzerdefinierten Funktionen, wie folgend gezeigt. Er hat PHP und JavaScript Äquivalenten für diese Funktionen, sodass diese server- und clientsetig identisch arbeiten. Es ist einfach neue Funktionen hinzuzufügen. <span id="Implemented_Functions"></span> ===Implementierte Funktionen=== Die folgenden Funktionen sind momentan verfügbar: {| |Funktion||Bedeutung||Syntax |- |[http://www.php.net/manual/en/function.checkdate.php abs]||Absoluter Wert||number abs(number) |- |[http://www.php.net/manual/en/function.acos.php acos]||Arkuskosinus||number acos(number) |- |[http://www.php.net/manual/en/function.addslashes.php die Funktion addslashes]||Quote string with slashes||string addslashes(string) |- |[http://www.php.net/manual/en/function.asin.php asin]||Arkussinus||number asin(number) |- |[http://www.php.net/manual/en/function.atan.php atan]||Arkustangens||number atan(number) |- |[http://www.php.net/manual/en/function.atan2.php atan2]||Arkustangens zweier Variablen||number atan2(number, number) |- |[http://www.php.net/manual/en/function.ceil.php ceil]||Aufrunden||number ceil(number) |- |[http://www.php.net/manual/en/function.checkdate.php checkdate]||Gibt true(1) zurück, wenn es ein nach dem Gregorianischen Kalender gültiges Datum ist||bool checkdate(month,day,year) |- |[http://www.php.net/manual/en/function.cos.php cos]||Kosinus||number cos(number) |- |[http://www.php.net/manual/en/function.date.php date]||Formatiere eine lokales Datum/Zeit||string date(format <nowiki>[</nowiki>, timestamp=time()]) |- |[http://www.php.net/manual/en/function.exp.php exp]||Berechnet den Exponenten von e||number exp(number) |- |[http://www.php.net/manual/en/function.floor.php floor]||Abrunden||number floor(number) |- |[http://www.php.net/manual/en/function.gmdate.php gmdate]||Ein GMT Datum/Zeit formatieren||string gmdate(format <nowiki>[</nowiki>, timestamp=time()]) |- |[http://www.php.net/manual/en/function.html-entity-decode.php html_entity_decode]||Konvertiert alle HTML Zeichen in geeignete Zeichen (immer mit ENT_QUOTES und UTF-8)||string html_entity_decode(string) |- |[http://www.php.net/manual/en/function.htmlentities.php htmlentities]||Wandelt alle geeigneten Zeichen in entsprechende HTML-Zeichen (immer mit ENT_QUOTES und UTF-8)||string htmlentities(string) |- |[http://www.php.net/manual/en/function.htmlspecialchars.php expr_mgr_htmlspecialchars]||Konvertiere Sonderzeichen in HTML-Zeichen (immer mit ENT_QUOTES und UTF-8)||string htmlspecialchars(string) |- |[http://www.php.net/manual/en/function.htmlspecialchars-decode.php expr_mgr_htmlspecialchars_decode]||Konvertiere HTML-Sonderzeichen zurück in Zeichen (immer mit ENT_QUOTES und UTF-8)||string htmlspecialchars_decode(string) |- |[http://www.php.net/manual/en/function.idate.php idate]||Formatiere Zeit / Datum als ganze Zahl||string idate(string <nowiki>[</nowiki>, timestamp=time()]) |- |if||Excel-Style if(test,result_if_true,result_if_false)||if(test,result_if_true,result_if_false) |- |[http://www.php.net/manual/en/function.implode.php implode]||Verbindet Array-Elemente mit einem String||string implode(glue,arg1,arg2,...,argN) |- |[http://www.php.net/manual/en/function.intval.php intval]||Bekomm den ganzzahligen Wert einer Variablen||int intval(number <nowiki>[</nowiki>, base=10]) |- |[http://www.php.net/manual/en/function.is-bool.php is_bool]||Prüft ob eine Variable ein Boolean ist||bool is_bool(var) |- |[http://www.php.net/manual/en/function.empty.php is_empty]||Bestimmen Sie, ob eine Variable als leer betrachtet wird||bool is_empty(var) |- |[http://www.php.net/manual/en/function.is-float.php is_float]||Prüft ob die Variable ein Float ist||bool is_float(var) |- |[http://www.php.net/manual/en/function.is-int.php is_int]||Prüft ob die Variable ein Integer ist||bool is_int(var) |- |[http://www.php.net/manual/en/function.is-nan.php is_nan]||Prüft ob die Variable eine Nummer ist||bool is_nan(var) |- |[http://www.php.net/manual/en/function.is-null.php is_null]||Prüft ob eine Variable NULL ist||bool is_null(var) |- |[http://www.php.net/manual/en/function.is-numeric.php is_numeric]||Prüft ob eine Variable eine Zahl oder ein numerischer String ist||bool is_numeric(var) |- |[http://www.php.net/manual/en/function.is-string.php is_string]||Prüft ob die Variable ein String ist||bool is_string(var) |- |list||Gibt eine komma-seperierte List der Werte zurück||string list(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.log.php log]||Natürlicher Logarithmus||number log(number) |- |[http://www.php.net/manual/en/function.ltrim.php ltrim]||Entfernt Leerzeichen (oder andere Zeichen) vom Anfang eines Strings||string ltrim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.max.php max]||Findet den höchsten Wert||number max(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.min.php min]||Findet den niedrigsten Wert||number min(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.mktime.php mktime]||UNIX-Timestamp/Zeitstempel für ein Datum (jedes der 6 Argumente ist optional)||number mktime([hour [, minute [, second [, month [, day [, year ]]]]]]) |- |[http://www.php.net/manual/en/function.nl2br.php nl2br]||Fügt HTML-Zeilenumbrüche vor allen Zeilenumbrüchen eines Strings||string nl2br(string) |- |[http://www.php.net/manual/en/function.number-format.php number_format]||Formatiert eine Zahl mit Tausender-Gruppierung||string number_format(number) |- |pi||Wert von pi||number pi() |- |[http://www.php.net/manual/en/function.pow.php pow]||Exponentialausdruck||number pow(base, exp) |- |[http://www.php.net/manual/en/function.quoted-printable-decode.php quoted_printable_decode]||Konvertiert einen quoted-printable String in einen 8-Bit-String||string quoted_printable_decode(string) |- |[http://www.php.net/manual/en/function.quoted-printable-encode.php quoted_printable_encode]||Konvertiert einen 8-Bit-String in einen quoted-printable String||string quoted_printable_encode(string) |- |[http://www.php.net/manual/en/function.quotemeta.php quotemeta]||Zitat Metazeichen||string quotemeta(string) |- |[http://www.php.net/manual/en/function.rand.php rand]||Generiere eine Zufallszahl||int rand() OR int rand(min, max) |- |[http://www.php.net/manual/en/function.round.php round]||Rundet eine Zahl auf einer optionalen Genauigkeit||number round(val <nowiki>[</nowiki>, precision]) |- |[http://www.php.net/manual/en/function.rtrim.php rtrim]||Entfernt Leerzeichen (oder andere Zeichen) vom Ende eines Strings||string rtrim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.sin.php sin]||Sinus||number sin(arg) |- |[http://www.php.net/manual/en/function.sprintf.php sprintf]||Gibt einen formatierten String zurück||string sprintf(format, arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.sqrt.php sqrt]||Quadratwurzel||number sqrt(arg) |- |stddev||Berechne die Sample-Standardabweichung für die Liste der Nummern||number stddev(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.str-pad.php str_pad]||Fülle einen String auf eine bestimmte Länge mit einem anderen String||string str_pad(input, pad_length <nowiki>[</nowiki>, pad_string]) |- |[http://www.php.net/manual/en/function.str-repeat.php str_repeat]||Wiederhole einen String||string str_repeat(input, multiplier) |- |[http://www.php.net/manual/en/function.str-replace.php str_replace]||Ersetzen Sie alle Vorkommen des Suchstrings mit dem Ersatz-String||string str_replace(search, replace, subject) |- |[http://www.php.net/manual/en/function.strcasecmp.php strcasecmp]||Binärsichere Groß-und Kleinschreibungs String-Vergleich||int strcasecmp(str1, str2) |- |[http://www.php.net/manual/en/function.strcmp.php strcmp]||Binärsicherer String-Vergleich||int strcmp(str1, str2) |- |[http://www.php.net/manual/en/function.strip-tags.php strip_tags]||Entfernt HTML-und PHP-Tags aus einem String||string strip_tags(str, allowable_tags) |- |[http://www.php.net/manual/en/function.stripos.php stripos]||Findet das erste Vorkommen eines Case-Insensitiven Strings||int stripos(haystack, needle <nowiki>[</nowiki>, offset=0]) |- |[http://www.php.net/manual/en/function.stripslashes.php stripslashes]||Entfernt die Anführungszeichen einer Zeichenfolge in Anführungszeichen||string stripslashes(string) |- |[http://www.php.net/manual/en/function.stristr.php stristr]||Case-Insensitiven strstr||string stristr(haystack, needle <nowiki>[</nowiki>, before_needle=false]) |- |[http://www.php.net/manual/en/function.strlen.php strlen]||String-Länge||int strlen(string) |- |[http://www.php.net/manual/en/function.strpos.php strpos]||Findet das erste Vorkommen eines Strings||int strpos(haystack, needle <nowiki>[</nowiki> offset=0]) |- |[http://www.php.net/manual/en/function.strrev.php strrev]||Umkehren einer Zeichenfolge||string strrev(string) |- |[http://www.php.net/manual/en/function.strstr.php strstr]||Findet das erste Vorkommen eines Strings||string strstr(haystack, needle) |- |[http://www.php.net/manual/en/function.strtolower.php strtolower]||Setzt einen String in Kleinbuchstaben||string strtolower(string) |- |[http://www.php.net/manual/en/function.strtoupper.php strtoupper]||Setzt einen String in Großbuchstaben||string strtoupper(string) |- |[http://www.php.net/manual/en/function.substr.php substr]||Gibt einen Teil eines Strings zurück||string substr(string, start <nowiki>[</nowiki>, length]) |- |sum||Berechne die Summe der Werte in einem Array||number sum(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.tan.php tan]||Tangens||number tan(arg) |- |[http://www.php.net/manual/en/function.time.php time]||Liefert die aktuelle UNIX-Timestamp||number time() |- |[http://www.php.net/manual/en/function.trim.php trim]||Entfernt Leerzeichen (oder andere Zeichen) vom Anfang und Ende eines Strings||string trim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.ucwords.php ucwords]||Großbuchstaben den ersten Buchstaben jedes Wortes in einem String||string ucwords(string) |- | |} <span id="Functions_that_are_Planned_or_Being_Considered"></span> ===Geplante Funktionen (oder die zumindest in Betracht gezogen werden)=== Andere Funktionen, die geplant (oder die zumindest in Betracht gezogen) sind, aber bis jetzt noch nicht enthalten sind, sind in der folgenden Liste aufgezählt. Einige von diesen sind für die Abwärtskompatibilität mit anderen Umfragetools. {| class="wikitable" !Syntax!!Bedeutung!!Kommentare |- |e()||gibt den Wert von e|| |- |formatDate(X, PAT)||gibt den Zeichenfolgenwert von Datum Formatmuster PAT|| |- |getAnsOption(X)|| [[ExpressionAnswerOptions|Kern-Plugin ExpressionAnswerOptions ]] || |- |getAnsOption(X,Y)|| [[ExpressionAnswerOptions|Kern-Plugin ExpressionAnswerOptions ]] || |- |getRelevance(X)||gibt die Relevanzgleichung für Frage X zurück|| |- |getStartTime()||gibt zurück das Datum, das der Systemzeit entspricht, als das Interview gestartet wurde|| |- |getType(X)||gibt den String-Namen des Datentyps zurück – z. B. *NA*, wenn isNA()|| |- |gotoFirst()||springt zum ersten relevanten Satz von Fragen – dies verstößt gegen den normalen Ablauf des Systems|| |- |gotoNext()||springt zum nächsten Satz von relevante Fragen – dies verstößt gegen den normalen Ablauf des Systems|| |- |gotoPrevious()||springt zum vorherigen Satz relevanter Fragen – dies verstößt gegen den normalen Ablauf des Systems|| | - |isAsked(X)||gibt true zurück, wenn die Antwort weder *NA*, *INVALID* noch *UNASKED* ist|| |- |isInvalid(X)||gibt true zurück, wenn die Antwort ist vom Typ *INVALID*|| |- |isNA(X)||gibt true zurück, wenn die Antwort vom Typ *NA*|| |- |isNotUnderstood(X ist )||gibt true zurück, wenn die Antwort vom Typ *HUH*|| |- |isRefused(X)||gibt true zurück, wenn die Antwort vom Typ *REFUSED* ist|| |-! N!|isSpecial(X)||gibt true zurück, wenn die Antwort vom Typ *UNASKED*, *NA*, *REFUSED*, *INVALID*, *UNKNOWN* oder *HUH* ist|| |-!N !|isUnknown(X)||gibt true zurück, wenn die Antwort vom Typ *UNKNOWN* ist|| |- |jumpTo(X)||springt zu der Gruppe, die die benannte Frage enthält – dies verstößt gegen den normalen Fluss des Systems|| |- |jumpToFirstUnasked()||Springe zur ersten nicht gestellten Frage <strike>und umgehe so zuvor beantwortete Fragen.</strike> Dies verstößt gegen den normalen Fluss des Systems|| |- | lastIndexOf(X,Y)||gibt den letzten Index (Basis 0) der Zeichenfolge Y in Zeichenfolge X zurück. Gibt -1 zurück, wenn Y nicht in X|| |- |list(X,..) enthalten ist.||Eine Zeichenfolge, die eine durch Kommas getrennte Liste der positiven Werte enthält, wobei die letzten beiden durch „und“ getrennt werden.|| |- |mean(X,...)||gibt den Mittelwert einer Liste zurück der Werte|| |- |numAnsOptions(X)||gibt die Anzahl der Antwortoptionen zurück, die Frage X hat|| |- |orlist(X,...)|| eine Zeichenfolge, die eine durch Kommas getrennte Liste der positiven Werte enthält, wobei die letzten beiden durch „oder“ getrennt werden.|| |- |parseDate(X,PAT)||gibt den Datumswert von Zeichenfolge X zurück, analysiert mit Java-Datum Formatmuster PAT|| |- |parseNumber(X,PAT)||gibt den numerischen Wert der Zeichenfolge ,attributeList,attributeTitleList||questionList = durch Pipes getrennte Liste von Fragen-IDs; attributeList = durch Pipes getrennte Liste von Attributen (wie Fragenummer, Titel, Text, Typ – damit Sie entscheiden können, was angezeigt werden soll); attributeTitleList = durch Pipes getrennte Liste von Tabellenüberschriften, damit der Bericht internationalisiert werden kann.|| |- |showTheseResponses(questionsList,attributeList,attributeTitleList)||questionList = durch Pipes getrennte Liste von Fragen-IDs; attributeList = durch Pipes getrennte Liste von Attributen (wie Fragenummer, Titel, Text, Typ – damit Sie entscheiden können, was angezeigt werden soll); attributeTitleList = durch Pipes getrennte Liste von Tabellenüberschriften, damit der Bericht internationalisiert werden kann.|| |} <span id="Expression_Manager_Knows_Which_Variables_are_Local"></span> ==Der Ausdrucksmanager weiß, welche Variablen lokal sind== Um ordnungsgemäß JavaScript für die Seite zu konstruieren muss der Ausdrucksmanager wissen, welche Variablen auf der Seite gesetzt sind und wie ihre ID ist (e.g. für document.getElementById(x)). Er muss auch wissen, welche Variablen auf anderen Seiten gesetzt sind (sodass sichergestellt werden kann, dass die benötigten <input type='hidden' value='x'> Felder präsent und ausgefüllt sind). <span id="Cascading_Conditions"></span> ==Kaskadierende Bedingungen== Um es genauer zu sagen, wenn eine der Variablen irrelevant ist, wird die gesamte Gleichung irrelevant (false). In der folgenden Tabelle bedeutet N/A zum Beispiel, dass eine der Variablen nicht relevant war. {| class="wikitable" !Operator!!Beispiel!!a!!b!!Ergebnis |- |<nowiki> + (unär)</nowiki> ||<nowiki> +a</nowiki> ||N/A|| ||false |- |- (unär)||-a||N/A|| ||false |- |!||!a||N/A|| ||false |- |== (oder Gleichung)||a == b||N/A||5||false |- |== (oder Gleichung) ||a == b||N/A||0||false |- |== (oder Gleichung)||a == b||N/A||N/A|| false |- |!= (oder ne)||a != b||N/A||5|| false |- |!= (oder ne)||a != b||N/A||N/A|| false |- |!= (oder ne)||a != b||N/A||0||false |- |> (oder gt)||a > b||N/A||5|| false |- |>= (oder ge)||a >= b||N/A||5||false |- |< (oder lt)||a < b||N/A||5||false |- |<= (oder le)||a <= b||N/A||5||false |- |und||a und b||N/A||5||falsch |- |und||a und b||N/A||N/A||falsch! N!|- |oder||a oder b||N/A||N/A||false |- |or||a oder b||N/A||5 ||false |- |<nowiki> +</nowiki> ||a + b||N/A||5||falsch |- |-||a - b||N/A||5||falsch |- |*||a * b||N/A||5||false |- |/||a / b||5||N/A||false |-! N!|()||(a)||N/A|| ||false |- |(exp)||(a && b)||N/A||5||false |- |(exp) op (exp)| |(b + b) > (a && b)||N/A||5||false |- |function||sum(a,b,b)||N/A|| 5||false |- |function||max(a,b)||N/A||5||false |- |function||min(a,b )||N/A||5||false |- |function||implode(', ',a,b,a,b)||N/A||5||false! N!|- |function||if(a,a,b)||N/A||5||false |- |function||is_empty(a)||N/ A|| ||false |- |function||is_empty(a)||0 (oder leer)|| ||true |- |function||!is_empty(a)||N/A|| ||false |} <span id="Overriding_Cascading_Conditions"></span> ===Überschreiben kaskadierender Bedingungen=== Angenommen, Sie möchten eine laufende Summe aller relevanten Antworten anzeigen. Sie könnten versuchen, die Gleichung {sum(q1,q2,q3,...,qN)} zu verwenden. Dies wird jedoch intern übersetzt in LEMif(LEManyNA('q1','q2','q3',...,'qN'),'',sum(LEMval('q1'),LEMval('q2') ,LEMval('q3'),...,LEMval('qN'))). Wenn also einer der Werte q1-qN irrelevant ist, gibt die Gleichung immer „falsch“ zurück. In diesem Fall zeigt sum() 0 an, bis alle Fragen beantwortet sind. Um dies zu umgehen, kann jeder Variablen das Suffix „.NAOK“ hinzugefügt werden (was bedeutet, dass „Nicht anwendbar“ in Ordnung ist). In solchen Fällen tritt das folgende Verhalten auf. Angenommen, Sie haben eine Variable q1.NAOK #q1, die nicht zur LEManyNA()-Klausel hinzugefügt wurde #LEMval('q1') prüft weiterhin, ob die Antwort relevant ist, und gibt sie zurück<nowiki> ''</nowiki> Wenn dies nicht der Fall ist (so werden einzelne irrelevante Antworten ignoriert, aber nicht der gesamte Ausdruck ungültig). Somit ist die Lösung zu dem laufende-Summe-Problem, die Gleichung sum(q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK) zu benutzen. Die Benutzung des .NAOK Suffixes lässt Autoren auch Umfragen gestalten, die verschiedene mögliche Pfade haben, aber dies kommt später. Zum Beispiel, sagen wir das Subjekt beantwortet die Umfrage in einem Umfang außerhalb des normalen Antwortbereiches. Der Autor könnte das Subjekt benachrichtigen, dass es möglicherweise keine richtigen Ergebnisse bekommen würde und dann fragen ob es so wirklich mit der Umfrage fortfahren wolle. Wenn es Ja sagt, wird der Rest der Fragen gezeigt. Die Bedingungen der restlichen Fragen würden validieren, ob die ersten Antworten in einem normalen Bereich beantwortet wurden, oder ob das Subjekt Ja zu der Frage gesagt hat, die nur dann relevant ist, wenn die anderen Antworten außerhalb des normalen Bereiches lagen. <span id="How_does_Expression_Manager_Support_Conditional_Micro-Tailoring?"></span> ==Wie unterstützt der Ausdrucksmanager Bedingungs-Mikro-Anpassungen?== Hier ist ein Beispiel für Mikro-Anpassungen (der Frage-Typ=='expr' bedeutet Gleichung): {| |Frage-Nummer||Relevanz||Frage-Typ||Frage |- |name||1||text||Wie heißen Sie? |- |age||1||text||Wie alt sind Sie? |- |badage||age||expr||{(age<16) oder (age>80)} |- |agestop||badage||message||Sorry, {name}, Sie sind zu {if( (age<16),'jung',if( (age>80),'alt','middle-aged') ) } für diesen Test. |- |kids||!badage||yesno||Haben Sie Kinder? |- |parents||1||expr||{!badage && kids=='Y'} |- |numKids||parents||text||Wie viele Kinder haben Sie? |- |kid1||parents && numKids >= 1||text||Wie alt ist Ihr erstes Kind? |- |kid2||parents && numKids >= 2||text||Wie alt ist Ihr zweites Kind? |- |kid3||parents && numKids >= 3||text||Wie alt ist Ihr drittes Kind? |- |kid4||parents && numKids >= 4||text||Wie alt ist Ihr viertes Kind? |- |kid5||parents && numKids >= 5||text||Wie alt ist Ihr fünftes Kind? |- |sumage||1||expr||{sum(kid1.NAOK,kid2.NAOK,kid3.NAOK,kid4.NAOK,kid5.NAOK)} |- |report||parents||yesno||{name}, Sie haben behauptet Sie seien {age} und hätten {numKids}. Die Summe der Alter ihrere ersten {min(numKids,5)} Kinder ist {sumage} |- | |} Alle diese Fragen können auf einer einzelnen Seite sein (e.g. in der gleichen Gruppe) und nur relevante Fragen werden angezeigt. Weiterhin, indem sie das Alter der Kinder eintragen wird der sum() Ausdruck in der letzten Frage dynamisch die Seite aktualisieren. Der Ausdrucksmanager stellt diese Funktionalität zur Verfügung indem jeder Ausdruck mit einem benannten <span> Element eingefasst wird. Jedes mal wenn sich ein Wert verändert, berechnet es den Ausdruck der in dem <span> Element erscheinen sollte neu und aktualisiert die Anzeige. Sie können duzende oder sogar hunderte von solchen zugeschnittenen Elementen auf der gleichen Seite haben und die Seite wird diese wieder innerhalb einer einzigen Bildschirmaktualisierung anzeigen. <span id="Mapping_of_LimeSurvey_1.91+_to_Expression_Manager_Functionality"></span> ==Abbildung von LimeSurvey 1.91+ zur Ausdrucksmanager Funktionalität== {| class="wikitable" !Alte Funktion!!Neue Funktion!!Kommentare |- |Bedingungen||Relevanz||Sie können sehr komplexe bedingte Gleichungen verwenden und auf einen größeren Bereich von Variablen zugreifen!N !|- |Bewertungen||Gleichung||Alle Bewertungsergebnisse können in eine Gleichung umstrukturiert werden. Dadurch wird einerseits sichergestellt, dass der Score in die Datenbank geschrieben wird, andererseits können Sie dynamische Änderungen am Score-Wert auf der aktuellen Seite sehen |- |Replacements||Expression Manager||Die Kern-Engine übernimmt die Eingabezeichenfolge und behandelt alles in geschweiften Klammern als Ausdruck – es verarbeitet also alle historischen Ersetzungstypen. Um eingebettetes JavaScript nicht durcheinander zu bringen, verarbeitet Expression Manager Inhalte nur zwischen geschweiften Klammern, solange (a) innerhalb der geschweiften Klammern kein führender oder nachgestellter Leerraum vorhanden ist – z. B. ist {expr} ein Ausdruck, aber { expr}, {expr }, und { expr } sind keine Ausdrücke. Darüber hinaus verarbeitet Expression Manager keine Inhalte innerhalb seiner eigenen Zeichenfolgen (z. B. generiert {list('hi','there {braces}')} "hi there {braces}"). Es ignoriert auch maskierte geschweifte Klammern (z. B. \{dies ist kein Ausdruck\}) |- |Validierung||Ausdrucksmanager||Der Plan besteht darin, die aktuellen Min/Max-Frageattribute zu übernehmen und einen Ausdrucksmanager zu haben sie verarbeiten. Auf diese Weise können die Min/Max-Werte selbst Ausdrücke sein |} <span id="Syntax_Highlighting"></span> =Beziehung zu LimeSurvey Ideen / Feature-Requests= Um die Eingabe und Validierung von Ausdrücken zu erleichtern, bietet EM eine Syntaxhervorhebung mit den folgenden Funktionen: <span id="Types_and_Meanings_of_Syntax_Highlighting"></span> ==Typen und Bedeutungen der Syntaxhervorhebung== {| class="wikitable" !Farbe!!Beispiel!!Bedeutung!!Tooltip!!Kommentare |- |tan background||style='background-color: #eee8aa'|Sample||the ganze Gleichung||keine||Alles in geschweiften Klammern, das als Gleichung erkannt wird (z. B. gibt es keine führenden oder nachgestellten Leerzeichen), wird farblich mit einem hellbraunen Hintergrund versehen, um es besser vom umgebenden Text unterscheiden zu können |-!N !|fetter roter Text||style='color:#ff0000; background-color:#eee8aa'|'''Sample'''||Ein Fehler||Einige Erklärung zum Fehler||Kann eine unbekannte Variable oder ein Funktionsfehler sein, .... Die Umfrage kann völlig kaputt sein, das ist Don Wird nicht für öffentliche Benutzer angezeigt. |- |blue text||style='color:#0000ff; Hintergrundfarbe:#eee8aa'|Beispiel||Funktionsname||Bedeutung und zulässige Syntax||Funktionsnamen oder Dinge, die Funktionen sein sollten, da ihnen eine öffnende Klammer folgt, werden in fettem blauem Text dargestellt. Tooltips zeigen die Bedeutung und zulässige Syntax für die Funktion. |- |grey text||style='color:#808080; background-color:#eee8aa'|Sample||string||none||Einfache und doppelte Anführungszeichen werden in grauem Text angezeigt |- |cyanfarbener Text||style='color:#4169e1; Hintergrundfarbe:#eee8aa'|Beispiel||Variablensatz auf derselben Seite,||<nowiki> [</nowiki>Name oder SGQA-Code]: Frage; Wert; Antwortliste mit Codes für jeden Wert||Jede Variable, die auf derselben Seite wie die aktuelle Frage festgelegt ist, wird in cyanfarbenem Text angezeigt, was bedeutet, dass sie in Javascript aktualisiert werden kann. Der Tooltip zeigt seinen Namen (wenn Sie INSERTANS:xxx verwendet haben) oder den SGQA-Code (wenn Sie das neue Benennungssystem verwendet haben), die eigentliche Frage und ihren aktuellen Wert (oder leer, wenn nicht festgelegt). Wenn der Fragetyp Antworten von einem Aufzählungswertesatz erwartet, wird die Zuordnung der Codes zu Anzeigewerten angezeigt. |- |green text||style='color:#008000; Hintergrundfarbe:#eee8aa'|Beispiel||Variablensatz auf einer vorherigen Seite||<nowiki> [</nowiki>Name oder SGQA-Code]: Frage; Wert; Antwortliste mit Codes für jeden Wert||Jede Variable, die auf einer vorherigen Seite festgelegt wurde, wird in fettem grünem Text angezeigt. Der Tooltip zeigt seinen Namen (wenn Sie INSERTANS:xxx verwendet haben) oder den SGQA-Code (wenn Sie das neue Benennungssystem verwendet haben), die eigentliche Frage und ihren aktuellen Wert (oder leer, wenn nicht festgelegt). Wenn der Fragetyp Antworten von einem Aufzählungswertesatz erwartet, wird die Zuordnung der Codes zu Anzeigewerten angezeigt. |- |bold pink text||style='color:#9370db; background-color:#eee8aa'|Sample||Variable wird auf einer späteren Seite festgelegt <sup>, im Allgemeinen: zu Beginn der Umfrage leer, kann aber mit einem Index gefüllt oder nach vorne verschoben werden</sup> ||<nowiki> [</nowiki>Name oder SGQA-Code]: Frage; Wert; Antwortliste mit Codes für jeden Wert||Jede Variable, die auf einer nächsten Seite festgelegt wird, wird in fettem rosa Text angezeigt. Der Tooltip zeigt seinen Namen (wenn Sie INSERTANS:xxx verwendet haben) oder den SGQA-Code (wenn Sie das neue Benennungssystem verwendet haben), die eigentliche Frage und ihren aktuellen Wert (oder leer, wenn nicht festgelegt). Wenn der Fragetyp Antworten von einem Aufzählungswertesatz erwartet, wird die Zuordnung der Codes zu Anzeigewerten angezeigt. |- |bold tan text||style='color:#a0522d; background-color:#eee8aa'|Beispiel||ein Lime-Ersatzwert||der Wert||Lime-Ersatzzeichenfolgen (wie {TOKEN:xxx}, {PRIVACY_MESSAGE}) werden in fettem hellbraunem Text angezeigt. |- |roter Text||style='color:#ff4500; Hintergrundfarbe:#eee8aa'|Beispiel||Zuweisungsoperator (=) ||Warnmeldung||Wenn Sie einen der Zuweisungsoperatoren (=) verwenden, wird dieser Operator in rotem Text angezeigt. Dies soll dazu beitragen, eine versehentliche Neuzuweisung von Werten zu verhindern, wenn Sie eigentlich prüfen wollten, ob a == b, anstatt den Wert von a = b festzulegen. |- |normaler schwarzer Text||style=' Farbe: Schwarz; background-color:#eee8aa'|Sample||Interpunktion||none||Alle anderen Interpunktion innerhalb des Ausdrucks werden als normaler schwarzer Text angezeigt. |- |rot umrandeter Text||eine fette rote Linie umgibt der Fehler||Syntaxfehler||Beschreibung des Fehlers||Alle erkannten Syntaxfehler werden angezeigt, indem der Fehler mit einem roten Kästchen umgeben wird. Der Tooltip zeigt den Fehler an. Beispiele hierfür sind nicht übereinstimmende Klammern, die Verwendung undefinierter Funktionen, die Übergabe der falschen Anzahl von Argumenten an Funktionen, schlecht strukturierte Ausdrücke (z. B. fehlende Operatoren zwischen Variablen), der Versuch, einer schreibgeschützten Variablen einen neuen Wert zuzuweisen, der Versuch, nicht definierten Variablen Werte zuzuweisen. Variablen oder die Verwendung einer nicht unterstützten Syntax. Beachten Sie, dass das Syntaxfehlererkennungssystem möglicherweise nur einen Fehler in einem Ausdruck meldet, selbst wenn mehrere Fehler vorliegen. Wenn jedoch Fehler erkannt werden, wird mindestens ein Fehler angezeigt. |} <span id="Additional_Reading"></span> =Zusätzliche Themen= <span id="Expression_Manager_sample_surveys"></span> ==[[Expression Manager-Beispielumfragen|Expression Manager-Beispielumfragen]]== <span id="Use_Cases_and_HowTos"></span> ==[[ExpressionScript-Anleitungen|Anwendungsfälle und Anleitungen]]== <span id="Step-by-Step_examples"></span> ==[[ExpressionScript-Beispiele|Schritt-für-Schritt-Beispiele]]== ==[[StatFunctions|Expression Manager statistic functions]]== <span id="Reference_for_Developers"></span> ==[[Expression Manager für Entwickler|Referenz für Entwickler]]== <span id="RoadMap/Status/ToDo_List"></span> ==[[Expression Manager-Roadmap|RoadMap/Status/ToDo-Liste]]==