LimeSurvey Manual
Menu
Navigation
Main page
Recent changes
Random page
Help
Search
Special pages
Printable version
Recent changes
Help
English
Log in
Actions
Translate
Language statistics
Message group statistics
Export
Special
Export translations
Settings
Group
Activating a survey
Adding answers or subquestions
Administering LimeSurvey
Alternatives to the LimeSurvey import function
Assessments
Backup entire database
Batch deletion
Category:Advanced Question Settings
Category:General Question Options
Category:Question Settings
Central Participant Database
Changing an active survey
Check data integrity
Check question logic
Check survey logic - Advanced
Closing a survey
ComfortUpdate
Copy question
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:Administrador de expresiones}}<languages /> __TOC__ <div class="simplebox">Nota: Esta función solo está disponible en LimeSurvey 1.92 o posterior.</div> <span id="Quick_Start_Tutorial"></span> =Tutorial de inicio rápido= <span id="Overview"></span> ==Descripción general== Al personalizar sus encuestas, normalmente necesita una forma de especificar lo siguiente: #'''Navegación/Brancación''': permitir que las respuestas de un sujeto cambien el orden en el que se formulan las preguntas.N!#'''Adaptación/ Piping''': cómo formular la pregunta (como hacer referencia a respuestas anteriores o conjugar oraciones según el número o el género de los sujetos) o cómo generar informes personalizados (como puntuaciones de evaluaciones o consejos personalizados). #'''Validación''': garantizar que las respuestas pasen ciertos criterios, como valores mínimos y máximos, o que coincidan con un patrón de entrada Expression Manager (EM) proporciona una forma intuitiva de especificar la lógica para cada una de esas funciones. Casi cualquier cosa que puedas escribir como una ecuación matemática estándar es una expresión válida, incluso si estás llamando funciones. Actualmente, EM proporciona acceso a 80 funciones y se puede ampliar fácilmente para admitir más. También le permite acceder a sus variables utilizando nombres de variables legibles por humanos (en lugar de nombres SGQA). Las siguientes secciones muestran los principales lugares donde se utiliza Expression Manager. <span id="Relevance_(Controlling_Navigation/Branching)"></span> ==Relevancia (control de navegación/ramificación)== Algunas encuestas utilizan "Ir a lógica", de modo que si responde la pregunta 1 con la opción C, salte a la pregunta 5. Este enfoque es muy limitante, ya que es difícil de validar y se rompe fácilmente cuando tiene que reordenar las preguntas. EM utiliza una ecuación de relevancia booleana para especificar todas las condiciones bajo las cuales una pregunta podría ser válida. Si la pregunta es relevante, se muestra; de lo contrario, no es aplicable y el valor NULL se almacena en la base de datos. Esto es similar a lo que se puede hacer a través del editor de condiciones, pero EM le permite especificar fácilmente criterios mucho más complejos y poderosos (y le permite usar el nombre de la variable en lugar del nombre SGQA). Esta imagen muestra una forma de revisar la lógica de relevancia de una encuesta. Calcula el índice de masa corporal. La ecuación de relevancia se muestra entre corchetes justo después del nombre de la variable (que está en verde). Entonces, la relevancia de peso, unidades_peso, altura y unidades_altura son todas 1, lo que significa que esas preguntas siempre se hacen. Sin embargo, la relevancia para el IMC es {!is_empty(altura) y !is_empty(peso)}, lo que significa que el IMC solo se calculará si el sujeto ingresa un valor tanto para la altura como para el peso (evitando así el riesgo de una división por cero error). Además, la pregunta del Informe solo se muestra si el sujeto responde las cuatro preguntas principales (altura, unidades_altura, peso, unidades_peso). [[File:tutorial1.jpg]] La relevancia se muestra y se puede editar en los siguientes lugares: <span id="Viewing_/_Editing_Question-Level_Relevance"></span> ===Ver/Editar la relevancia a nivel de pregunta=== Esta ecuación calcula el índice de masa corporal (IMC). Sólo se pregunta si la persona ingresa primero su altura y peso. [[File:tutorial2.jpg]] Esta es la pantalla de edición para la pregunta de IMC. [[File:tutorial3.jpg]] Tenga en cuenta que no utiliza llaves cuando ingresa una ecuación de relevancia. <span id="Viewing_/_Editing_Group-Level_Relevance"></span> ===Ver/Editar la relevancia a nivel de grupo=== Esta es una encuesta de censo de muestra. La primera página pregunta cuántas personas viven con usted y lo almacena en la variable "cohabs". Esta página solo se muestra si tiene más de un conviviente (por lo que se muestra para la segunda persona que convive con usted), y también solo se muestra si especificó cómo se relaciona la Persona Uno con usted (p1_rel). [[File:tutorial4.jpg]] Como puede ver, el grupo también tiene criterios de relevancia a nivel de pregunta, de modo que cada pregunta solo aparece una vez que haya respondido la pregunta anterior (por ejemplo, {!is_empty(p1_sex)}). EM combina la relevancia a nivel de grupo y de pregunta para usted. Las preguntas en un grupo sólo se hacen si el grupo en su conjunto es relevante. Luego, sólo se formula el subconjunto de preguntas dentro del grupo que sean relevantes. Aquí está la pantalla para editar la relevancia a nivel de grupo para esa pregunta: [[File:tutorial5.jpg]] Tenga en cuenta que no utiliza llaves cuando ingresa una ecuación de relevancia. <span id="Tailoring/Piping"></span> ==Sastrería/Tuberías== EM le permite realizar fácilmente una adaptación condicional simple y compleja de sus preguntas. A veces sólo necesitas una simple sustitución, como decir: "Dijiste que compraste<nowiki> [</nowiki> Producto]. ¿Qué es lo que más te gustó de esto?". A veces necesitas una sustitución condicional como "<nowiki> [</nowiki> SR Sra.]<nowiki> [</nowiki> Apellido], ¿estaría dispuesto a completar nuestra encuesta?". En este caso, desea utilizar Sr. o Sra. según el género de la persona. Otras veces necesita una sustitución aún más compleja (por ejemplo, basada en un cálculo matemático). EM admite cada uno de estos tipos de confección/tubería. <span id="Conditional_Equations"></span> ===Ecuaciones condicionales=== El ejemplo del índice de masa corporal muestra la capacidad de calcular el IMC de una persona, incluso permitiéndole ingresar su altura y peso en unidades métricas o no métricas. [[File:tailoring7.jpg]] Aquí peso_kg es {if(peso_units == 'kg', peso, peso * .453592)}. Esta función if() significa que si el sujeto ingresó el peso usando kilogramos, use ese valor; de lo contrario, multiplique el valor ingresado (que estaba en libras) por .453592 para convertirlo a kilogramos. La variable altura_m utiliza un enfoque similar para calcular la altura de la persona en metros, incluso si ingresó su altura en pulgadas. El IMC calcula la fórmula del peso como {peso_kg / (altura_m * altura_m)}. Por último, el informe adapta condicionalmente el mensaje al sujeto y le dice lo que ingresó. ("Dijiste que mides 2 metros y pesas 70 kg"). Aunque no se muestra bien en la imagen de arriba, Weight_status utiliza declaraciones if() anidadas para clasificar a la persona desde bajo peso hasta obesidad severa. Puedes ver su ecuación en Mostrar vista lógica. [[File:tailoring8.jpg]] Desde la ventana de edición de esta pregunta, puede ver dos cosas: #La adaptación debe rodear las expresiones con llaves #Las expresiones pueden abarcar varias líneas si, como en este caso, desea que sea más fácil leer el Lógica condicional anidada. [[File:tailoring9.jpg]] <span id="Tailored_Questions,_Answers,_and_Reports"></span> ===Preguntas, respuestas e informes personalizados=== <div class="simplebox">Nota: Es posible que la personalización dinámica no funcione si las opciones de respuesta están disponibles en cuadros de selección en la misma página de preguntas. Esto se debe al hecho de que la sastrería inserta un<nowiki></nowiki> <span>etiqueta que no es válida dentro de las opciones de selección.</span> Este ejemplo muestra el informe de IMC. [[File:tailoring10.jpg]] Aquí está la ventana de edición para la misma pregunta. [[File:tailoring11.jpg]] Como puede ver, todo lo que esté entre llaves se trata como una expresión, por lo que se resalta la sintaxis (codificada por colores) en la imagen anterior. Si tuviera algún error tipográfico (como funciones o nombres de variables mal escritos o no definidos), EM mostraría un error, como este, mostrando que height_unit es un nombre de variable no definido (en realidad es height_units) y rnd() es una función no definida. (el nombre correcto de la función es round()). En ambos casos, los errores están rodeados por un cuadro rojo para que sea más fácil detectarlos y corregirlos. [[File:tailoring12.jpg]] También puede ver que puede crear rápidamente informes complejos, como una tabla de valores ingresados o consejos personalizados. Recuerde que toda personalización debe rodear las expresiones con llaves, para que LimeSurvey sepa qué partes de la pregunta son texto libre y cuáles deben analizarse a través del Administrador de expresiones. <span id="Validation"></span> ==Validación== EM controla cómo funcionan la mayoría de las opciones de preguntas avanzadas. Estos aspectos de control como el número mínimo/máximo de respuestas; valores individuales mínimo/máximo; valores de suma mínimo/máximo; y verificar que los valores ingresados coincidan con los patrones de cadena especificados. Continúe ingresando esas opciones de preguntas avanzadas como de costumbre. Sin embargo, ahora cualquier valor en uno de esos campos se considera una expresión, por lo que puede tener criterios mínimo/máximo con relaciones condicionales complejas con otras preguntas. En todos estos casos, dado que la opción de pregunta avanzada siempre se considera una expresión, no se utilizan llaves al especificarla. Las páginas de [[Encuestas de muestra de Expression Manager|Encuestas de muestra]] muestran muchos ejemplos prácticos del uso de expresiones para validaciones. <span id="Introduction"></span> =Introducción= LimeSurvey utiliza el nuevo módulo Expression Manager (EM) que permitirá a LimeSurvey admitir ramificaciones, evaluaciones, validación y personalización más complejas. Reemplazará la forma en que LimeSurvey administra los reemplazos, las condiciones y las evaluaciones en el back-end. También acelerará considerablemente el procesamiento ya que elimina la mayoría de las lecturas de la base de datos en tiempo de ejecución. EM fue desarrollado por el Dr. Thomas White (TMSWhite). Esta página wiki es la referencia definitiva para la sintaxis y la funcionalidad de Expression Manager. ==Definiciones clave== #'''Expresión''': ¡Cualquier cosa rodeada por llaves #*¡Siempre y cuando no haya espacios en blanco inmediatamente después de la llave de apertura o antes de la llave de cierre #*El contenido de las Expresiones es evaluado por EM, por lo que pueden contener fórmulas matemáticas, funciones y procesamiento complejo de cadenas y fechas. #'''Sastrería''': A veces llamado "piping", este es el proceso de modificando texto condicionalmente #*Tiene acceso a todos los 'campos de reemplazo', datos de participantes y datos de respuesta. #*También tiene acceso más fácil a preguntas, respuestas y sus propiedades. #'' 'Relevancia''' Ecuación: ¡Un nuevo atributo de pregunta que controla la visibilidad de la pregunta #*Si hay una ecuación de relevancia, entonces la pregunta solo se muestra si la relevancia se evalúa como verdadera. #*Internamente, todos los array_filter y array_filter_exclude ¡los comandos se vuelven relevantes a nivel de subpregunta #'''Ecuación''' Tipo de pregunta: ¡Un nuevo tipo de pregunta que guarda cálculos o informes en la base de datos #*Es como una pregunta repetitiva, pero su contenido se guarda en la base de datos incluso si configura "Ocultar siempre esta pregunta" #'''Código de pregunta''': este es el nombre de variable preferido para EM #*Este puede ser un nombre descriptivo que indique el propósito de la pregunta. , ¡lo que facilita la lectura de lógica compleja #*Los códigos de preguntas válidos NO deben comenzar con un número, por lo que cuando utilice el código de pregunta para numerar sus preguntas, simplemente use "q1", "q1a" o "g1q2". N!#*Esto es lo que actualmente se convierte en el nombre de la variable si exporta datos a SPSS o R, por lo que si realiza un análisis estadístico, probablemente ya lo haya hecho único. <span id="Do_I_have_to_use_EM?"></span> ==¿Tengo que usar EM?== La respuesta corta es No (pero también sí). EM es totalmente compatible con las encuestas existentes. Entonces, si está contento de usar Condiciones y Evaluaciones en el estilo que usó LimeSurvey en las versiones <= 1.91+, puede continuar haciéndolo. Sin embargo, EM reemplaza por completo la forma en que LimeSurvey trata internamente las Condiciones. Aunque aún puede usar el Editor de condiciones para crear y administrar condiciones, LimeSurvey 1.92 las convertirá en ecuaciones de relevancia equivalentes. Como parte de la actualización, LimeSurvey 1.92 convertirá automáticamente todas las condiciones existentes en ecuaciones de relevancia. Esto debería brindarle lo mejor de ambos mundos: puede continuar usando LimeSurvey como está acostumbrado, pero verá el equivalente de la Ecuación de relevancia para que pueda migrar gradualmente a Ecuaciones de relevancia directamente cuando lo considere conveniente. <span id="Can_I_mix_use_of_Conditions_and_Relevance?"></span> ==¿Puedo combinar el uso de Condiciones y Relevancia?== Sí. Puede utilizar el editor de Condiciones para algunas preguntas y el editor de Relevancia para otras. Las condiciones se convierten automáticamente a Relevancia cuando guarda la pregunta. Tenga en cuenta que asumimos que, si está utilizando el editor de condiciones, desea que esas condiciones sobrescriban cualquier ecuación de relevancia ingresada manualmente. Por lo tanto, si tiene Condiciones existentes y desea editar manualmente la Relevancia, primero elimine las Condiciones para esa pregunta. Específicamente, copie la ecuación de relevancia generada en un editor de texto, use el menú Condiciones para eliminar todas las condiciones para esa pregunta (lo que también eliminará la relevancia), luego edite la pregunta y pegue la ecuación de relevancia generada desde el editor de texto nuevamente en el campo de relevancia para esa pregunta (y guarde la pregunta). Si hay suficiente demanda para eliminar condiciones sin eliminar la ecuación de relevancia generada, podríamos agregar un proceso de conversión masiva. <span id="How_should_I_choose_between_Conditions_and_Relevance?"></span> ==¿Cómo debo elegir entre Condiciones y Relevancia?== Aquí hay una lista de pros y contras de cada estilo: {| class="wikitable" !Estilo!!Pros!!Contras |- |Condiciones||1. Bonita GUI para crear condiciones simples<br/> 2. GUI bien documentada y comprendida por el equipo de soporte||1. Solo admite comparaciones simples y no establece bien las condiciones Y/O<br/> 2. Las condiciones en cascada funcionan de forma errática<br/> 3. Lento: requiere mucha base de datos, por lo que puede ralentizar las encuestas largas.<br/> 4. Algunos problemas reportados con las condiciones de recarga.<br/> 5. La GUI no escala bien cuando hay docenas, cientos o miles de preguntas.<br/> 6. Puede ser lento convertir encuestas en papel ya que deben usar nombres SGQA<br/> 7. ¡A menudo se necesita un programador para codificar la lógica personalizada necesaria para bifurcaciones complejas |- |Relevancia||1. Admite lógica muy compleja, incluidas más de 80 funciones y operadores matemáticos/de cadenas<br/> 2. Soporte perfecto para lógica en cascada<br/> 3. Rápido: sin llamadas adicionales a la base de datos, por lo que admite más de 1000 encuestas de preguntas<br/> 4. No hay problemas con la lógica de recarga ya que no requiere códigos SGQA<br/> 5. El resaltado de sintaxis escala a más de 1000 encuestas de preguntas<br/> 6. Fácil y rápido de usar para grupos que desean informatizar encuestas en papel existentes.<br/> 7. Admite fácilmente entrevistas semiestructuradas y encuestas epidemiológicas sin necesidad de programadores||1. Sin GUI para condiciones simples: use resaltado de sintaxis en su lugar<br/> 2. Nuevo, por lo que los equipos de soporte aún no dominan EM. |} La conclusión es que si está satisfecho con el funcionamiento de LimeSurvey 1.91+, no hay razón para cambiar lo que hace. <span id="What_are_some_other_benefits_of_using_EM?"></span> ==¿Cuáles son algunos otros beneficios de usar EM?== Estas son algunas de las otras razones por las que quizás quieras usar EM. #Cálculos: puedes crear cualquier cálculo que se te ocurra: #*Tienes acceso a todos los operadores y funciones matemáticos comunes #* ¡Tiene acceso a más de 70 funciones matemáticas, de fecha y de procesamiento de cadenas #*¡Es bastante fácil para los desarrolladores agregar nuevas funciones si los usuarios las necesitan #¡Almacenamiento de cálculos en la base de datos #*Ahora puede calcular cálculos simples y complejos y/o puntuaciones de escala Y tenerlos almacenados en la base de datos sin necesidad de JavaScript. #*Utiliza el tipo de pregunta Ecuación para lograr esto. #Evaluaciones #*Ahora puede crear evaluaciones o escalar puntuaciones de cualquier tipo de pregunta, no solo del subconjunto que solía ser admitido. N!#*Puedes usar Tailoring para mostrar puntuaciones de evaluación totales o en ejecución en cualquier lugar que sea necesario, ¡incluso en la misma página #*Tienes más control sobre los informes generados en función de esos puntajes de evaluación #*¡Puede almacenar puntajes de evaluación en la base de datos sin necesidad de JavaScript #*¡Puede ocultar puntajes de evaluación sin necesidad de JavaScript o CSS #Campos de reemplazo # *En lugar de usar {INSERTANS:SGQA}, puedes usar el Código de pregunta; esto hace que sea más fácil de leer y validar. #*Esto también evita la necesidad común de editar preguntas para cambiar el código SGQA y que todo funcione . #Sastrería: ¡puede mostrar texto condicionalmente basándose en otros valores #*Utilice el título apropiado para un tema, como (por ejemplo, "Hola<nowiki> [</nowiki> Sr./Sra.] Smith") #*Emite oraciones gramaticalmente correctas basadas en materia singular/plural: (por ejemplo, "Tienes 1 hijo" frente a "Tienes 2 hijos") #*Conjugar verbos apropiadamente y rechazar sustantivos según el género y la pluralidad del sujeto. #Nuevos atributos variables: puede acceder a lo siguiente para personalizarlo: #* (sin sufijo): un alias para qcode.code #*. código: el código de respuesta seleccionado para la pregunta si es relevante (en caso contrario, en blanco), o el valor del texto si no es una pregunta codificada. N!#*.NAOK: igual que .code, pero puede ser parte de cálculos o listas incluso si es irrelevante #*.value: el valor de evaluación para la pregunta si es relevante (de lo contrario, en blanco), o el valor del texto si no es una pregunta codificada; disponible si las evaluaciones están habilitadas para la encuesta; de lo contrario, siempre zero #*.valueNAOK - igual que .value, pero puede ser parte de cálculos o listas incluso si son irrelevantes #*.shown - la respuesta tal como se muestra al usuario (esto es lo que hace {INSERTANS:xxx} ) #*.qid - el ID de la pregunta #*.gid - el ID del grupo #*.sgqa - el valor SGQA para la pregunta #*.jsName - el nombre correcto de la variable javascript para la pregunta, independientemente de si está definida en esta página u otra #*.qseq - la secuencia de preguntas (a partir de 0) #*.gseq - la secuencia de grupo (a partir de 0) #*. obligatorio - si la pregunta es obligatoria (S/N) #*.question - el texto de la pregunta #*.relevance - la ecuación de relevancia para la pregunta #*.grelevance - la ecuación de relevancia para el grupo #*.relevanceStatus - si la pregunta es actualmente relevante o no (booleana (puede ser diferente en PHP y JS)) #*.type - el tipo de pregunta (el código de un carácter)!N !#¡Cambios dinámicos en la página #*Toda la relevancia, el cálculo y la personalización funcionan dinámicamente en una página, por lo que los cambios en los valores actualizan instantáneamente la página.N!#*Entonces, tiene preguntas que aparecen/desaparecen dinámicamente según si ¡son relevantes #*Las preguntas también se adaptan dinámicamente en función de las respuestas en la página, para que pueda ver totales acumulados, oraciones adaptadas e informes personalizados. #Nueva pantalla de entrada de datos #*Además de usar Con el sistema de entrada de datos actual, puede utilizar Survey-All-In-One. #*Esto respalda la relevancia y la personalización de la página, de modo que los empleados de entrada de datos puedan pasar rápidamente y solo tendrán que ingresar el respuestas relevantes #*Esto puede ser crítico si su persona de ingreso de datos necesita ver la adaptación, que también es dinámica. #Elimina la necesidad de la mayoría de JavaScript personalizado #*EM admite fácilmente cálculos complicados, puntuación , personalización y lógica condicional. #*Algunas cosas aún necesitarán JavaScript (como diseños personalizados y subelementos de preguntas que se ocultan condicionalmente), pero su JavaScript puede usar las funciones EM para que pueda acceder a las preguntas mediante su Qcode en lugar de SGQA. y acceda a cualquiera de las propiedades de las preguntas enumeradas anteriormente. <span id="What_are_some_other_helpful_new_features_enabled_by_EM?"></span> ==¿Cuáles son algunas otras funciones nuevas útiles habilitadas por EM?== Independientemente de si continúa usando el Editor de condiciones o redacta manualmente ecuaciones de relevancia, obtendrá estos beneficios adicionales: #¡Puede crear criterios de validación más complejos #*Todos los atributos de preguntas avanzadas (como max_answers, min_num_value_n, max_num_value) puede utilizar expresiones. Por lo tanto, sus criterios mínimo/máximo se pueden ajustar fácilmente en función de respuestas anteriores, incluso si están en la misma página. #*EM también maneja toda la validación basada en expresiones regulares, por lo que puede combinar de manera sólida preg y ecuación- atributos de preguntas basados. #Fácil reordenamiento (o eliminación) de preguntas y grupos #*Antes de la versión 1.92, no se podían reordenar preguntas o grupos si LimeSurvey pensaba que dicho reordenamiento podría fallar. condiciones en las que fueron utilizados. De manera similar, no puede eliminar preguntas si otras preguntas dependen de ellas. #*Con el resaltado de sintaxis de EM, es fácil ver y validar si intenta utilizar preguntas antes de declararlas. Por lo tanto, ahora le permitimos reordenar o eliminar preguntas y grupos cuando lo desee. EM actualizará todo el resaltado de sintaxis para mostrarle errores potenciales. #*La vista de preguntas de reordenamiento se ha mejorado para ayudar con dicha revisión. Ahora muestra la ecuación de relevancia y la adaptación de la pregunta, para que pueda ver inmediatamente si alguna variable se vuelve rosa (lo que significa que se usa antes de ser declarada). #El índice de navegación de preguntas/grupos siempre está disponible y es preciso.N!#* ¡Antes de la versión 1.92, estos índices no estaban disponibles si había condiciones complejas #*Con EM, podemos garantizar que son precisos. #*Los sujetos pueden incluso retroceder, a una pregunta anterior, cambiar la respuesta , luego salte hacia adelante (o envíe) #**Al saltar hacia adelante, EM volverá a validar todas las preguntas/grupos intermedios. #**Si alguna pregunta se vuelve irrelevante, se anulará en la base de datos ¡para que sus datos sean internamente consistentes #**Si alguna pregunta se vuelve relevante o recientemente no cumple con las reglas obligatorias o de validación, EM se detendrá en esa página y obligará al usuario a responder esas preguntas antes de saltar a su destino final. #¡Conversión automática de condiciones a relevancia #*Cuando actualice su base de datos, ¡todas las encuestas existentes que tengan condiciones tendrán ecuaciones de relevancia generadas para ellas #*Siempre que importe una encuesta, se crearán ecuaciones de relevancia según sea necesario #*Siempre que agregue, elimine o modifique condiciones, EM generará la ecuación de relevancia adecuada. #Resaltado de sintaxis conveniente #*Cuando EM muestre la ecuación de relevancia, mostrará el código Q, incluso si ingresó un código SGQA, ya que suponemos que será más fácil de leer. #*Todas las variables están codificadas por colores para mostrar si fueron declaradas antes o después de la pregunta actual (o antes o después del grupo actual). Esto le permite detectar y solucionar rápidamente casos en los que intenta utilizar variables para relevancia (incluido array_filter), adaptación o ecuaciones de validación antes de declararlas. #*Además, si pasa el mouse sobre la variable codificada por colores , verá los metadatos más importantes sobre esa pregunta. Esto incluye el número de secuencia de grupo, el número de secuencia de preguntas, el código Q, el texto de la pregunta y todas las opciones de respuesta disponibles (si es un tipo de pregunta con opciones de respuesta enumeradas). #**La lista de opciones de respuesta utiliza esta sintaxis. : 'answers':{key:val, ... }. #**''key'' tiene la sintaxis ''''scale~code'''' donde ''scale'' es la escala de respuesta (por ejemplo, para escala dual) y ''código'' es el código de respuesta. #**''val'' tiene la sintaxis ''''valor~mostrado'''' donde ''valor'' es el valor de la evaluación (si se utilizan evaluaciones; de lo contrario, ''código'') (por ejemplo, Qcode.value) y ''mostrado'' es el valor mostrado tal como lo ve el sujeto (por ejemplo, Qcode.shown) #**Este Esto significa que muchas encuestas pueden utilizar cálculos sin necesidad del modo de evaluación. Si ha enumerado opciones de respuesta que son únicas, no decimales y no negativas, simplemente puede hacer cálculos con los valores de Qcode.code. #Revisión fácil de toda la lógica y el contenido de la encuesta #*Hay una nueva función Mostrar lógica de encuesta que le permite ver todo sobre la encuesta (o grupo o pregunta) en una sola página. #*Muestra los detalles del nivel de grupo, pregunta, subpregunta y respuesta para el alcance seleccionado (encuesta versus grupo versus pregunta) #*También muestra la relevancia, la relevancia a nivel de subpregunta (para array_filter y array_filter_exclude) y la ecuación de validación generada (para preg y cualquier regla de validación como suma mínima/máxima/número de valores) y todos los atributos de preguntas que no están en blanco. #*Todo está resaltado con sintaxis para que pueda ver posibles errores de sintaxis (como paréntesis desequilibrados o uso de variables antes de que fueran declaradas) #*La sintaxis- resaltar admite una navegación y edición rápidas de la encuesta. #**Si hace clic en el nombre de una variable, se abre una ventana (o pestaña) del navegador que le muestra esa pregunta y le permite editarla. #** Si hace clic en el nombre de un grupo, se abre una ventana (o pestaña) del navegador que muestra la vista de reordenamiento del grupo para que pueda mover las preguntas fácilmente. #**Todos los atributos de las preguntas también están resaltados en la sintaxis. ¡Esto le permite configurar y ver expresiones dentro de opciones avanzadas de preguntas (como basar el número máximo/mínimo/suma de valores en una expresión) #*El autor de EM usó una vista similar (un poco más limpia) para permitir que sus colaboradores epidemiólogos e instituciones La Junta de Revisión valida y autoriza encuestas con miles de preguntas en entrevistas estructuradas altamente ramificadas y personalizadas. <span id="Getting_Started"></span> =Empezando= La mejor manera de comenzar con EM es: *Instalar la última versión estable desde http://www.limesurvey.org/en/download *Importar y explorar las [[encuestas de muestra de ExpressionScript|encuestas de muestra ]]. *Explore los [[ExpressionScript How-tos|casos de uso y procedimientos]] y [[ExpressionScript ejemplos|ejemplos paso a paso]]. *Explore la documentación de EM (esta página)! N!*¡Examine el conjunto de pruebas EM integrado **¡Desde cualquier encuesta, en herramientas, seleccione la opción EM **Funciones disponibles enumera más de 70 funciones y sintaxis **Pruebas unitarias de aislamiento ¡Expresiones ***muestra ejemplos del uso de todas las funciones y operadores de EM, y los resultados de PHP y JavaScript.N!***tenga en cuenta que hay pocas funciones que generan resultados diferentes en las versiones de PHP y JavaScript, por lo que esta página le permite planifique su lógica EM en consecuencia. <span id="What_Functionality_does_Expression_Manager_Extend/Replace?_(LimeSurvey_<=_1.91+)"></span> =¿Qué funcionalidad amplía/reemplaza el Administrador de expresiones? (LimeEncuesta <= 1.91+)= <span id="Conditions_=>_Relevance"></span> ==Condiciones => Relevancia== Las condiciones controlaban qué preguntas eran visibles. La sintaxis general era ''Valor del operador SGQA'', como ''111X2X3 == "Y"''. Las condiciones se podían combinar con AND u OR juntas, pero mezclar AND y OR era difícil. Las condiciones mismas se almacenaron en una tabla separada y gran parte del código de LimeSurvey se dedicó a administrar las condiciones. Debido al amplio acceso a la base de datos, el procesamiento de una gran cantidad de condiciones podría causar problemas de rendimiento notables. Además, una vez que había asignado condiciones a preguntas o grupos, a menudo no se le permitía reordenarlos ni eliminarlos. <span id="Assessments_=>_Equations_and_Micro-Tailoring"></span> ==Evaluaciones => Ecuaciones y Microadaptación== Las evaluaciones permiten a los usuarios crear puntuaciones a escala a partir de una colección de preguntas. Sin embargo, no pudieron cambiar dinámicamente en la página actual y sus valores no se almacenaron en la base de datos. <span id="Replacements_=>_Micro-Tailoring"></span> ==Reemplazos => Micro-Sastrería== Los usuarios pueden personalizar algunos mensajes y preguntas basándose en respuestas anteriores. Por ejemplo, una pregunta podría ser: ''{TOKEN:FIRSTNAME}, dijiste que {INSERTANS:111X3X4} era tu deporte favorito''. Sin embargo, no era posible hacer una adaptación condicional (como decir "Sr." o "Sra." dependiendo del género de la persona), ni conjugar verbos o declinar sustantivos sin JavaScript sofisticado. Los autores podían implementar encuestas que parecían adaptar las preguntas, pero requerían preguntas separadas para cada permutación y condiciones complejas para decidir qué preguntas mostrar. <span id="Validation"></span> ==Validación== La pregunta se puede validar con expresiones regulares o valores mínimo/máximo, o dejar que una respuesta SGQA sirva como valor mínimo o máximo. Sin embargo, las validaciones no podrían basarse en cálculos de otras variables sin JavaScript sofisticado. <span id="Equations"></span> ==Ecuaciones== Las ecuaciones no eran compatibles sin JavaScript sofisticado. <span id="Equation_Question_Type"></span> ==Tipo de pregunta de ecuación== Las ecuaciones no se podían guardar en la base de datos (por ejemplo, la puntuación final de una evaluación) sin un sofisticado JavaScript. <span id="How_Will_Expression_Manager_Replace/Extend_That_Functionality?"></span> =¿Cómo reemplazará o ampliará el Administrador de expresiones esa funcionalidad?= Expression Manager es un nuevo módulo central dentro de LimeSurvey que hace que sea mucho más fácil admitir el tipo de funcionalidad compleja que solía requerir JavaScript personalizado. También está reemplazando la forma en que LimeSurvey gestiona actualmente las Condiciones y Evaluaciones. <span id="New_Terminology_When_Referring_to_Expression_Manager_(EM)"></span> ==Nueva terminología al hacer referencia al Administrador de expresiones (EM)== EM "piensa" en su funcionalidad en los siguientes términos: *'''Bifurcación basada en relevancia''' - si una pregunta es relevante, hágala; de lo contrario, no lo haga (por ejemplo, hágala invisible y márquela como NULL en la base de datos). Hay un nuevo campo Relevancia para todos los tipos de preguntas y también para cada grupo (de modo que puede aplicar un conjunto de condiciones a un grupo completo sin tener que copiar la misma condición a cada pregunta y/o combinar condicionales a nivel de pregunta y de grupo logic). *'''Sastrería''' - Una vez que sepa qué preguntas se deben formular, la adaptación (a veces llamada ''piping'') especifica cómo se debe formular la pregunta. Esto le permite admitir no solo la sustitución simple (como {TOKEN:FIRSTNAME}), sino también la conjugación de verbos y la declinación de sustantivos según el género o el número de sujetos. También le permite cambiar el mensaje que envía a un sujeto en función de si respondió (o cómo respondió) otras preguntas. *'''Ecuaciones''': EM agrega un nuevo tipo de pregunta llamada Ecuación que almacena el resultado. de una expresión. Los resultados de estas ecuaciones se calculan y escriben en la base de datos, incluso si los oculta en la página. Por lo tanto, son útiles para cálculos de puntuación ocultos, navegación basada en ecuaciones complejas, evaluaciones e informes que deben generarse y estar fácilmente disponibles en la base de datos. <span id="Relevance_and_Cascading_Relevance"></span> ===Relevancia y relevancia en cascada=== Cada tipo de pregunta ahora tiene una opción de Relevancia que controla si se muestra la pregunta. EM procesa cada una de las Ecuaciones de Relevancia en el orden en que deberían aparecer en la encuesta. Si la expresión es verdadera (o falta, para admitir encuestas heredadas), se mostrará la pregunta. Si no es relevante, la pregunta se ocultará y el valor se anulará en la base de datos. Si no hay preguntas relevantes en un grupo, se omitirá todo el grupo. Además, si alguna de las variables dentro de una expresión es irrelevante, la expresión siempre se evalúa como falsa. Esto permite la relevancia en cascada para que no tenga que escribir ecuaciones de relevancia muy largas para cada pregunta. Supongamos que tiene 5 preguntas Q1-Q5 y solo desea mostrar la Q2 si se respondió la Q1 y la Q3 si se respondió la Q2, etc. Las ecuaciones de relevancia podrían ser: {| class="wikitable" !Código de pregunta!!Relevancia!!Pregunta |- |Q1||1||¿Cuál es tu nombre? |- |Q2||Q1 ||{Q1}, ¿cuántos años tienes? |- |Q3||Q2||Entonces, tienes {Q2} años. ¿Estás casado? |- |Q4||Q3 == "Y"||{Q1}, ¿cuánto tiempo llevas casado? |- |Q5||Q4|| ¿Cuántos hijos tienes, {Q1}? |} Los cálculos de relevancia también funcionan en JavaScript, por lo que podrías colocar todas las preguntas anteriores en una página y seguiría funcionando como se esperaba. De hecho, EM reemplaza totalmente la forma en que EM procesa los formatos de encuesta, de encuesta, de grupo o de pregunta a la vez. Ahora todos utilizan exactamente el mismo motor de navegación, por lo que funcionan de manera idéntica independientemente del estilo de la encuesta. Mientras estés en la misma página, todos los datos que hayas ingresado seguirán ahí, pero ocultos. Entonces, si ingresa cierta información, luego elige una opción que la hace irrelevante y luego la vuelve relevante nuevamente, sus respuestas aún estarán disponibles. Sin embargo, tan pronto como pase a una página diferente, todas las respuestas irrelevantes se perderán para la integridad del conjunto de datos. <span id="Group-Level_Relevance"></span> ===Relevancia a nivel de grupo=== Expression Manager también admite relevancia a nivel de grupo. Esto facilita la implementación del bucle. Supongamos que desea recopilar información sobre hasta 10 entidades (como productos o personas en un hogar), donde primero determina cuántas entidades necesitan seguimiento (por ejemplo, preguntando cuántas personas viven en un hogar o haciendo que las personas verifiquen qué productos les gustan de una larga lista). Después de saber cuántas entidades necesitan seguimiento, puede utilizar la relevancia a nivel de grupo como {count >= 1}, {count >=2}, ... {count >= 10} para cada uno de los 10 grupos de seguimiento. hacer preguntas. Dentro de cada grupo, puede tener lógica condicional a nivel de preguntas (por ejemplo, preguntas de seguimiento específicas de género o edad para cada tema). Las ecuaciones de relevancia a nivel de grupo y de pregunta se combinan con AND para determinar cuál debe mostrarse. <span id="Tailoring_/_Piping"></span> ===Sastrería / Tubería=== Todo lo que esté entre llaves ahora se trata como una expresión (con una excepción que se describe a continuación). Las expresiones tienen acceso a todos los LimeReplacementFields, todas las variables (a través de varios alias), todos los operadores de ecuaciones típicos (matemáticos, lógicos y de comparación) y docenas de funciones (que incluso funcionan dinámicamente en el lado del cliente). Usando estas ecuaciones, puede hacer cosas como: #Mostrar condicionalmente mensajes personalizados a los encuestados en función de respuestas anteriores #Crear evaluaciones y mostrar los resultados de las evaluaciones (o bifurcar o mostrar mensajes condicionalmente) según esos resultados, todo ¡sin usar el módulo Evaluaciones en sí #Conjuga verbos y declina sustantivos dentro de preguntas, respuestas e informes. #Mostrar resúmenes de respuestas antes de la página "Muestre sus respuestas" al final de la encuesta <span id="Equations"></span> ===Ecuaciones=== Hay un nuevo tipo de pregunta llamado Ecuación. Es como una pregunta repetitiva, excepto que almacena el valor de lo que se muestra en la base de datos. Por lo tanto, si el texto de la pregunta de ecuación contiene un cálculo de evaluación, ese valor se almacenará en la base de datos en una variable que se puede mostrar dentro de las estadísticas públicas o privadas. Esto resuelve una solicitud común para almacenar puntuaciones de evaluación dentro de la base de datos. <span id="Syntax"></span> ==Sintaxis== Todo lo contenido entre llaves ahora se considera una expresión (con una excepción: no debe haber espacios en blanco al principio ni al final; esto es necesario para garantizar que el Administrador de expresiones no intente procesar JavaScript incrustado). Tenga en cuenta que está bien que las expresiones abarquen varias líneas, siempre y cuando no haya espacios en blanco después de la llave de apertura o antes de la llave de cierre. Esto es especialmente útil para declaraciones if() anidadas como esta: <syntaxhighlight lang="java">{if(is_empty(PFTotals), '', if(PFTotals >= -5 && PFTotals <= -4, 'Muy suave', if(PFTotals >= -3 && PFTotals <= -2, 'Suave', if(PFTotals == -1, 'Algo suave', if(PFTotals == 0, 'Moderado',! N! if(PFTotals == 1, 'Algo difícil', if(PFTotals >= 2 && PFTotals <= 3, 'Difícil', if(PFTotals >= 4 && PFTotals <= 5, 'Muy difícil', '' ) ) ) ) ) ) ) )}</syntaxhighlight> <div id="EMsyntax">Expression Manager admite la siguiente sintaxis:</div> *Todos los operadores matemáticos estándar (por ejemplo, +,-,*,/,!) *Todos los operadores de comparación estándar (por ejemplo, <,<=,==,!=,>,>=, más estos equivalentes: lt,le,eq,ne,gt,ge) *Paréntesis (para que pueda agrupar subexpresiones) *Operadores condicionales (por ejemplo, &&,| | y estos equivalentes: and,or) * Cadenas entre comillas simples y dobles (que pueden incrustar cadenas con el otro tipo de comillas) *Operador de coma (para que pueda tener una lista de expresiones y simplemente devolver el resultado final) *Operador de asignación (=)!N !*Variables predefinidas (para hacer referencia a preguntas, atributos de preguntas y respuestas), por ejemplo, todos los códigos SGQA *Funciones predefinidas (ya hay más de 70 y es fácil agregar más) <span id="Operators"></span> === Operadores === La sintaxis EM sigue la precedencia normal de operadores: {| class="wikitable" !Nivel!!Operador(es)!!Descripción |- |1||()||paréntesis para agrupar o llamar funciones |- | 2||! - +||operadores unarios: no, negación, unario-más |- |3||* /||veces, dividir |- |4||+ -||más , menos |- |5||< <= > >= lt le gt ge||comparaciones relativas |- |6||== != eq ne||comparaciones de igualdad |- |7||y||lógico AND |- |8||o||lógico OR |- |9||=||asignación operador |- |10||,||operador de coma |} <span id="Warning_with_plus_operator_(+)"></span> ==== Advertencia con operador más (+) ==== Para mantener la coherencia entre JavaScript y PHP, el operador más (+) suma si ambos operandos son numéricos, pero concatena si ambas partes son cadenas no numéricas. Sin embargo, '''recomendamos usar la función join() para la concatenación y la función sum() para la suma''', ya que esto aclara su intención y evita resultados inesperados si esperaba cadenas pero en su lugar obtuvo números (o viceversa). <span id="Warning_with_mismatch_between_number_and_string_and_alphabetic_comparison"></span> ==== Advertencia con falta de coincidencia entre número y cadena y comparación alfabética ==== Cuando desee comparar valores con comparaciones relativas o de igualdad, preste atención a la falta de coincidencia de tipos. El valor ingresado por el usuario o el código de respuesta seleccionado se puede usar como número si es claramente un número. Si rodea uno de los valores con <code>"</code> , forzará la comparación como texto (comparación alfabética). Si desea comparar numéricamente, nunca escriba el número entre comillas, <code>"</code> . Por ejemplo <code>Q0.NAOK > "50"</code> es verdadero si Q0.NAOK es una pregunta numérica con 9 como valor. Esto se debe a que el operador <code>></code> asumirá que es una comparación alfabética y no numérica. <div class="mw-translate-fuzzy"> Para asegurarse de comparar el valor entero, puede usar <code>[[Expression_Manager#Implemented_Functions|intval]](Q0.NAOK) > 50</code> , solo recuerde si Q0.NAOK no es un número (vacío o una cadena), entonces intval(Q0. NAOK) === 0. Para comparar el valor de la cadena ("A" < "B") use [[Expression_Manager#Implemented_Functions|strcmp]] directamente: <code>strcmp(Q0.NAOK,"B")</code> o <code>strcmp(Q0.NAOK,"A5")</code> . </div> <span id="Caution_about_using_Assignment_Operator_(=)"></span> ===Precaución sobre el uso del operador de asignación (=)=== Tenga en cuenta que debe evitar el uso de operadores de asignación a menos que sea absolutamente necesario, ya que pueden causar efectos secundarios inesperados. Por ejemplo, si cambia el valor de una respuesta anterior, la relevancia en cascada y la lógica de validación entre esa pregunta y la pregunta actual no se vuelven a calcular, por lo que podría terminar con datos internamente inconsistentes (por ejemplo, preguntas que permanecen respondidas pero deberían haber sido respondidas han sido anuladas, o preguntas que se omitieron pero que deberían haber sido respondidas). En general, si desea asignar un valor a una variable, debe crear un tipo de pregunta de ecuación y usar una expresión para establecer su valor. Sin embargo, hay ocasiones excepcionales en las que la gente realmente necesita este operador, por lo que lo ponemos a disposición. Para ayudarle a advertirle sobre este operador, se muestra en fuente roja dentro de las ecuaciones de sintaxis (para que no lo confunda con "==") ===Uso del operador de asignación=== Las principales razones por las que puede querer utilizar la asignación son: * Debe establecer el valor predeterminado para una pregunta que no acepta valores predeterminados mediante ecuación (como lista de radio, donde la interfaz de usuario le permite elegir una de las opciones de respuesta, pero no le permite ingresar una ecuación). Sin embargo, tenga cuidado, ya que LimeSurvey no podrá validar que su ecuación genere una de las respuestas permitidas para esa pregunta. * ¡Necesita cambiar a la fuerza la respuesta a una pregunta anterior basándose en una respuesta posterior * Necesita una cuota compleja: use una única opción oculta para la cuota y configúrela usando la asignación * etc... Puede utilizar todo el sistema de gestión de expresiones para este propósito. {{Alerta|La asignación se realiza sólo en PHP. Esto no actualiza ningún valor en la misma página, sino solo cuando el usuario navega con siguiente, anterior, guardar….}} {{Alerta|Si no utiliza un tipo [[Question_type_-_Equation|pregunta de ecuación]] para este propósito: la asignación se realiza solo después de que se completa la lógica de la página actual. El método recomendado es utilizar siempre una [[Question_type_-_Equation|pregunta de ecuación]].}} Algún ejemplo: * Establecer respuesta a una pregunta de texto breve en minúsculas: <code>{QCODE=strtolower(QCODE.NAOK)}</code> * Establecer una respuesta predeterminada a un tipo de pregunta de matriz al inicio de una encuesta: <code>{Q1_SQ1=((is_empty(Q1_SQ1.NAOK),"A99",Q1_SQ1.NAOK)}</code> * Establezca una respuesta predeterminada para un tipo de pregunta de textos de matriz al inicio de una encuesta: <code>{Q1_SQY1_SQX1 = ((is_empty(Q1_SQY1_SQX1.NAOK),"Inserted answer", Q1_SQY1_SQX1.NAOK)}</code> * Establece una respuesta con condición: <code>{QCODE=if(YesNo="Y","A1","")}</code> <span id="XSS_security"></span> == Seguridad XSS == Con la habilitación XSS, algunos sistemas de gestión de expresiones no se pueden utilizar: * iniciando una etiqueta HTML en la expresión pero terminando en otra expresión * usa una expresión compleja en la URL. ¡Ejemplo y solución alternativa * <code>{if( 1 ,"<strong>","")}information{if( 1 ,"</strong>","")}</code> funciona con la seguridad XSS, aquí puedes usar <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> <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> ==Acceso a Variables== Expression Manager proporciona acceso de solo lectura a cualquier variable que podamos necesitar. Para compatibilidad con versiones anteriores, proporciona acceso a lo siguiente: *TOKEN:xxx: el valor de un TOKEN (por ejemplo, TOKEN:FIRSTNAME, TOKEN:ATTRIBUTE_5) (solo para encuestas NO anónimas). *[[Agregar un question#Information_from_previous_answers|INSERTANS:SGQA]] - el valor mostrado de una respuesta (por ejemplo, "Sí"). Para Expression Manager es lo mismo que usar {QCODE.shown}. *Todos los [[The_template_editor#Keywords|{XXX} valores usados por las plantillas]]. *En el texto de la pregunta, puede usar {QID} reemplazado por el ID de la pregunta y {SGQ} reemplazado por el SGQA de la pregunta Además, Expression Manager le permite hacer referencia a variables mediante el código de pregunta (la columna 'título' en la tabla de preguntas dentro de la base de datos). Esta es también la etiqueta de variable que se utiliza cuando exporta sus datos a SPSS, R o SAS. Por ejemplo, si tiene preguntas sobre nombre, edad y sexo, puede llamar a esas variables "nombre", "edad" y "género" en lugar de "12345X13X22", "12345X13X23". ' y ''12345X13X24''. Esto hace que las ecuaciones sean más fáciles de leer y validar para todos, además hace posible barajar las preguntas sin tener que realizar un seguimiento de los números de grupo o de pregunta. <div class='simplebox'> '''Importante:''' Sólo es seguro hacer referencia a variables que aparecen en páginas o preguntas anteriores. </div> Además, Expression Manager le permite acceder a muchas propiedades de la pregunta: {| class="wikitable" !Sintaxis!!Significado!!Ejemplo!!Resultado del ejemplo |- |Qcode||un alias para Qcode.code||{implode(',',nombre,género )}||'Tom','M' |- |Qcode.code||el código de respuesta seleccionado para la pregunta si es relevante (de lo contrario, en blanco), o el valor del texto si no es pregunta codificada||{implode(',',name.code,gender.code)}||'Tom','M' |- |Qcode.NAOK||igual que Qcode - ver discusión de NAOK||{gender.NAOK}||'M' |- |Qcode.value||el valor de evaluación de la pregunta si es relevante (de lo contrario, en blanco), o el valor del texto si no lo es una pregunta codificada||{gender.value}||'1' |- |Qcode.valueNAOK||igual que Qcode.value - ver discusión sobre NAOK||{gender.valueNAOK}||'1 ' |- |Qcode.shown||el valor de visualización para la pregunta||{implode(',',name.shown,gender.shown)}||'Tom','Male'!N !|- |Qcode.question||el texto de la pregunta||{gender.question}||'¿Cuál es tu género?' |- |Qcode.mandatory||si la pregunta es obligatorio (Y/N)||{gender.mandatory}||'N' |- |Qcode.qid||el número de pregunta interna (no el número secuencial)||{gender.qid} ||337 |- |Qcode.type||el tipo de pregunta||{gender.type}||'G' |- |Qcode.jsName||el nombre javascript correcto para la pregunta, independientemente de si está declarada dentro o fuera de esta página||{gender.jsName}||'java1827X3X337' |- |Qcode.gid||el número de grupo interno (no el número secuencial)|| {gender.gid}||3 |- |Qcode.qseq||el número secuencial de la pregunta, comenzando desde 0||{gender.qseq}||5 |- |Qcode.gseq||el número secuencial del grupo, comenzando desde 0||{gender.gseq}||1 |- |Qcode.relevanceStatus||si la pregunta es actualmente relevante (0 o 1 )||{gender.relevanceStatus}||1 |- |Qcode.relevance||la ecuación de relevancia a nivel de pregunta||{gender.relevance}||'!is_empty(name)' |- |Qcode.grelevance||la ecuación de relevancia a nivel de grupo||{gender.grelevance}||'num_children >= 5' |- |Qcode.sgqa||el valor SGQA para esta pregunta||{gender.sgqa}||'1827X3X337' |} <span id="HTML_editor_issue"></span> === Problema con el editor HTML === {{Alerta|Este problema se solucionó después de la versión 2.05, compilación 140803}} Si utiliza el editor HTML, algunos caracteres se reemplazan por entidades HTML. * & by & * < by < * > by > Si usa el editor HTML, debe usar : * y para & * lt para < * le for <= * gt for > * ge para >= <span id="Qcode_Variable_Naming"></span> ==Nombre de variables de Qcode== Aquí están los detalles de cómo construir un Qcode (y acceder a algunas propiedades) por tipo de pregunta. En general, los Qcodes se construyen como: Código de pregunta. '_'. ID de subpregunta. '_'. ID de escala Para '''comentario''' y '''otro''', los códigos de pregunta son QuestionCode_comment y QuestionCode_other {| class="wikitable" !Tipo!!Descripción!!Código!!Subpreguntas!!Opciones de respuesta!!Escalas!!Código de respuesta!!Respuesta mostrada!!Relevancia |- |5||5 Botones de opción de elección de punto||Q1|| ||1-5|| ||{Q1}||{Q1.shown}||{Q1==3} |- |B||Matriz (elección de 10 puntos) Botones de radio||Q2||L1-L6| |1-10|| ||{Q2_L2}||{Q2_L2.shown}||{Q2_L2==7} |- |A||Botones de radio de matriz (elección de 5 puntos)||Q3||1-5| |1-5|| ||{Q3_1}||{Q3_1.shown}||{Q3_1>=3} |- |1||Matriz (Etiquetas flexibles) Escala dual||Q4||sq1-sq5||0 :a1-a3||1:b1-b3||{Q4_sq1_0}||{Q4_sq1_1.shown}||{Q4_sq1_1=='b2'} |- |H||Matriz (Flexible) - Formato de columna||Q5||1-5||s,m,t|| ||{Q5_1}||{Q5_1.shown}||{Q5_1=='s'} |- |F||Matriz (Flexible) - Formato de fila||Q6||F1-F5| |1-5|| ||{Q6_F3}||{Q6_F3.shown}||{Q6_F3==4} |- |E||Botones de radio de matriz (aumentar/igual/disminuir)||Q7||1- 7||I,S,D|| ||{Q7_4}||{Q7_4.shown}||{Q7_4=='D'} |- |:||Matriz (Multi Flexi) 1 a 10||Q8||ls1,todo ,ls2||mín,máx,promedio|| ||{Q8_ls1_max}||{Q8_ls2_avg.shown}||{Q8_ls2_min==7} |- |;||Texto de matriz (Multi Flexi)||Q9||hp,st,sw|| 1º,2º,3º|| ||{Q9_hp_3rd}||{Q9_hp_3rd.shown}||{Q9_hp_3rd=='Peter'} |- |C||Matriz (Sí/Incierto/No) Botones de radio||Q10|| 1-5||S,N,U|| ||{Q10_1}||{Q10_1.shown}||{Q10_3=='Y'} |- |X||Pregunta repetitiva||P11|| || || || ||{P11.mostrado}|| |- |D||Fecha||P12|| || || ||{Q12}||{Q12.mostrado}|| |- |*||Ecuación||P13|| || || ||{Q13}||{Q13.shown}||{Q13>5} |- |~124~||Carga de archivos (registra el número de archivos cargados)||Q14|| || || ||{P14}|| ||{Q14>0} |- |G||Lista desplegable de género||P15|| ||M,F|| ||{Q15}||{Q15.shown}||{Q15=='M'} |- |U||Texto libre enorme||Q16|| || || ||{P16}||{P16.shown}||{strlen(Q16)>100} |- |I||Pregunta de idioma||P17|| || || ||{Q17}||{Q17.shown}||{Q17=='en'} |- |!||Lista - Desplegable||Q18|| ||1-5|| ||{Q18}||{Q18.shown}||{Q18==3} |- |L||Lista desplegable/lista de botones de radio||Q19|| ||AZ|| ||{Q19}||{Q19.shown}||{Q19=='X'} |- |O||Lista con lista desplegable de comentarios/botones de radio + área de texto||Q20 || ||AF|| ||{Q20},{Q20comentario}||{Q20.shown}||{Q20=='B'} |- |T||Texto libre largo||Q21|| || || ||{Q21}||{Q21.shown}||{strstr(Q21,'hello')>0} |- |M||Casilla de verificación de opción múltiple||Q22||AF, otro| | || ||{Q22_E}, {Q22_other}||{Q22_E.shown}, {Q22_other.shown}||{Q22_E=='Y'} |- |P||Casilla de verificación de opción múltiple con comentarios + Texto||P23||AF|| || ||{Q23_D}, {Q23_Dcomment}||{Q23_D.shown}||{!is_empty(Q23)} |- |K||Pregunta numérica múltiple||Q24||yo,mamá,papá || || ||{Q24_self}||{Q24_self.shown}||{Q24_self>30} |- |Q||Múltiples textos cortos||Q25||AF|| || ||{Q25_B}||{Q25_B.shown}||{substr(Q25_B,1,1)=='Q'} |- |N||Tipo de pregunta numérica||Q26|| || || ||{Q26}||{Q26.shown}||{Q26 > 30} |- |R||Estilo de clasificación||Q27||1-4|| || ||{Q27_1}||{Q27_1.shown}||{Q27_1==3} |- |S||Texto libre corto||Q28|| || || ||{Q28}||{Q28.mostrado}||{Q28=='mío'} |- |Y||Sí/No botones de radio||Q29|| || || ||{Q29}||{Q29.mostrado}||{Q29=='Y'} |} <span id="The_reserved_'this',_'self',_and_'that'_variables"></span> ==Las variables reservadas 'esto', 'yo' y 'aquello' == Muy a menudo, desea evaluar todas las partes de una pregunta, como contar cuántas subpreguntas se han respondido o sumar las puntuaciones. Otras veces, desea procesar solo ciertas filas o columnas de una pregunta (como obtener las sumas de las filas o columnas y almacenarlas en la base de datos). Estas variables reservadas hacen que el proceso sea relativamente sencillo. La variable 'esta' se utiliza exclusivamente dentro de las opciones avanzadas de preguntas "Ecuación de validación de toda la pregunta" y "Ecuación de validación de subpreguntas". Se expande a los nombres de variables de cada una de las celdas dentro de esas preguntas. Por lo tanto, si desea asegurarse de que cada entrada sea mayor que tres, deberá establecer la "Ecuación de validación de subpreguntas" en (esto > 3). Las variables "yo" y "ese" son más poderosas y sirven como macros que se expanden antes de procesar las ecuaciones. Las opciones de sintaxis son: *self *self.''suffix'' *self.''sub-selector'' *self.''sub-selector''.'' sufijo'' ''sufijo'' es cualquiera de los sufijos normales de qcode (por ejemplo, NAOK, valor, mostrado) ''subselector'' es uno de: *comentarios - sólo subpreguntas que son comentarios (por ejemplo, de opción múltiple con comentario y lista con comentario) *nocomments - sólo subpreguntas que no son comentarios *sq_X: donde X es un identificador de fila o columna. Solo se seleccionan las subpreguntas que coinciden con el patrón X. Tenga en cuenta que la búsqueda se realiza en el identificador de código completo, luego sq_X coincide e incluye las subpreguntas nX, X, Xn (por ejemplo, si usa sq_1, se incluyeron las subpreguntas a1, 1a, 1, 11 o 001). Preste atención al tipo de pregunta de escala dual donde el código de subpreguntas es QCODE_SQCODE_1 y QCODE_SQCODE_1 y al tipo de pregunta de clasificación donde el código de subpregunta es QCODE_1,QCODE_2 .... *nosq_X - donde X es un identificador de fila o columna. Solo se seleccionan las subpreguntas que no coinciden con el patrón X. Tenga en cuenta que la búsqueda se realiza en el identificador de código completo, luego nosq_X coincide y no incluye las subpreguntas nX, X, Xn Ejemplos: *¿Se ha respondido alguna parte de una pregunta? {count(self.NAOK)>0} *¿Cuál es la puntuación de evaluación para esta pregunta? {suma(valor propio)} También puede utilizarlos para obtener totales de filas y columnas. Supongamos que tiene una serie de números con filas AE y columnas 1-5. *¿Cuál es el total general? {sum(self.NAOK)} *¿Cuál es el total de la fila B? {sum(self.sq_B.NAOK)} *¿Cuál es el total de la columna 3? {suma(self.sq_3.NAOK)} La variable "esa" es como la variable "yo", pero le permite hacer referencia a otras preguntas. Su sintaxis es: *that.''qname'' *that.''qname''.''suffix'' *that.''qname''.''sub-selector' ' *ese.''qname''.''sub-selector''.''suffix'' ''qname'' es el nombre de la pregunta sin extensiones de subpregunta. Entonces, digamos que crea una pregunta 'q1', ese es su ''qname'' Ejemplos: *¿Se ha respondido alguna parte de la pregunta q1? {count(that.q1.NAOK)>0} *¿Cuál es la puntuación de evaluación para el segundo trimestre? {sum(that.q2.NAOK)} *¿Cuál es el total general de q3? {sum(that.q3.NAOK)} *¿Cuál es el total de la fila C en el cuarto trimestre? {sum(that.q4.sq_C.NAOK)} *¿Cuál es el total de la columna 2 en q4? {suma(that.q4.sq_2.NAOK)} Las variables 'yo' y 'aquello' se pueden utilizar con cualquier relevancia, validación o adaptación. La única advertencia es que cuando utiliza la función [[Mostrar archivo lógico|Mostrar archivo lógico]], le mostrará el valor ampliado de 'yo' y 'eso'. Esto le permite ver la ecuación real que se generará para que usted (y el Administrador de expresiones) puedan validar que las variables existen. Esto puede parecer confuso ya que es posible que veas ecuaciones bastante largas. Sin embargo, si edita la pregunta, verá la ecuación original usando "yo" y/o "eso". También tenga en cuenta que no debe utilizar estas variables si (a) desea nombrar explícitamente cada variable utilizada en una ecuación, o (b) utiliza variables que no tienen subpreguntas (por ejemplo, preguntas de respuesta única). En esos casos, anteponer una variable con "eso" es excesivo y se corre el riesgo de obtener resultados inesperados. <span id="Usage_of_NAOK"></span> ==Uso de NAOK== NAOK --> "No aplicable" (NA) está bien (OK) Usar NAOK significa que todas o algunas de las variables son irrelevantes (por ejemplo, "No aplicable" (NA) está bien (OK)). Cuando colocas alguna variable de una pregunta en cualquier ecuación: si esta pregunta (o subpregunta) está oculta por condición: esto desactiva todas las ecuaciones. Por ejemplo: count(Q1_SQ1,Q1_SQ2,Q1_SQ3,Q1_SQ4) siempre proporciona una cadena vacía si se filtra una subpregunta de Q1. Para contar el número de subpreguntas marcadas en dicha pregunta se puede contar(Q1_SQ1.NAOK,Q1_SQ2.NAOK ,Q1_SQ3.NAOK,Q1_SQ4.NAOK). Si la subpregunta está oculta: el administrador de expresiones devuelve una cadena vacía. Sin NAOK: si una pregunta o una subpregunta está oculta: el Administrador de expresiones siempre devuelve una cadena vacía, lo mismo ocurre con falso. El .mostrado siempre usa el sistema NAOK (cadena vacía si está oculto), pero si necesita el código de la respuesta: siempre es una buena idea agregar .NAOK después del código de la pregunta. Excepto si lo necesitas y sabes lo que haces. Se proporciona otro ejemplo e información en [[#Overriding_Cascading_Conditions|Anulación de condiciones en cascada]] <span id="Access_to_Functions"></span> ==Acceso a funciones== Expression Manager proporciona acceso a funciones matemáticas, de cadenas y definidas por el usuario, como se muestra a continuación. Tiene equivalentes de PHP y JavaScript para estas funciones, de modo que funcionan de manera idéntica en el lado del servidor (PHP) y en el lado del cliente (JavaScript). Es fácil agregar nuevas funciones. <span id="Implemented_Functions"></span> ===Funciones implementadas=== Actualmente están disponibles las siguientes funciones: {| class="wikitable" !Function!!Meaning!!Syntax |- |[http://www.php.net/manual/en/function.abs.php abs]||Absolute value||number abs(number) |- |[http://www.php.net/manual/en/function.acos.php acos]||Arc cosine||number acos(number) |- |[http://www.php.net/manual/en/function.addslashes.php addslashes]||Quote string with slashes||string addslashes(string) |- |[http://www.php.net/manual/en/function.asin.php asin]||Arc sine||number asin(number) |- |[http://www.php.net/manual/en/function.atan.php atan]||Arc tangent||number atan(number) |- |[http://www.php.net/manual/en/function.atan2.php atan2]||Arc tangent of two variables||number atan2(number, number) |- |[http://www.php.net/manual/en/function.ceil.php ceil]||Round fractions up||number ceil(number) |- |[http://www.php.net/manual/en/function.checkdate.php checkdate]||Returns true(1) if it is a valid date in gregorian calendar||bool checkdate(month,day,year) |- |convert_value||Convert a numerical value using a inputTable and outputTable of numerical values||number convert_value(fValue, iStrict, sTranslateFromList, sTranslateToList) |- |[http://www.php.net/manual/en/function.cos.php cos]||Cosine||number cos(number) |- |count||count the number of answered (non-blank) questions in the list||number count(arg1, arg12, ..., argN) |- |countif||Count the number of answered questions in the list equal to the first argument||number countif(matches, arg1, arg2, ... argN) |- |countifop||Count the number of answered questions in the list which pass the criteria (arg op value)||number countifop(op, value, arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.date.php date]||Format a local date/time||string date(format <nowiki>[</nowiki>, timestamp=time()]) |- |[http://www.php.net/manual/en/function.exp.php exp]||Calculates the exponent of e||number exp(number) |- |fixnum||Display numbers with comma as radix separator, if needed||string fixnum(number) |- |[http://www.php.net/manual/en/function.floor.php floor]||Round fractions down||number floor(number) |- |[http://www.php.net/manual/en/function.gmdate.php gmdate]||Format a GMT date/time||string gmdate(format <nowiki>[</nowiki>, timestamp=time()]) |- |[http://www.php.net/manual/en/function.html-entity-decode.php html_entity_decode]||Convert all HTML entities to their applicable characters (always uses ENT_QUOTES and UTF-8)||string html_entity_decode(string) |- |[http://www.php.net/manual/en/function.htmlentities.php htmlentities]||Convert all applicable characters to HTML entities (always uses ENT_QUOTES and UTF-8)||string htmlentities(string) |- |[http://www.php.net/manual/en/function.htmlspecialchars.php expr_mgr_htmlspecialchars]||Convert special characters to HTML entities (always uses ENT_QUOTES and UTF-8)||string htmlspecialchars(string) |- |[http://www.php.net/manual/en/function.htmlspecialchars-decode.php expr_mgr_htmlspecialchars_decode]||Convert special HTML entities back to characters (always uses ENT_QUOTES and UTF-8)||string htmlspecialchars_decode(string) |- |[http://www.php.net/manual/en/function.idate.php idate]||Format a local time/date as integer||string idate(string <nowiki>[</nowiki>, timestamp=time()]) |- |if{{UpdatedIn|3.0.2}}||Excel-style if(test,result_if_true<nowiki>[</nowiki>,result_if_false = ""<nowiki>]</nowiki>)||if(test,result_if_true<nowiki>[</nowiki>,result_if_false = ""<nowiki>]</nowiki>) |- |[http://www.php.net/manual/en/function.implode.php implode]||Join array elements with a string||string implode(glue,arg1,arg2,...,argN) |- |[http://www.php.net/manual/en/function.intval.php intval]||Get the integer value of a variable||int intval(number <nowiki>[</nowiki>, base=10]) |- |[http://www.php.net/manual/en/function.empty.php is_empty]||Determine whether a variable is considered to be empty||bool is_empty(var) |- |[http://www.php.net/manual/en/function.is-float.php is_float]||Finds whether the type of a variable is float||bool is_float(var) |- |[http://www.php.net/manual/en/function.is-int.php is_int]||Find whether the type of a variable is integer||bool is_int(var) |- |[http://www.php.net/manual/en/function.is-nan.php is_nan]||Finds whether a value is not a number||bool is_nan(var) |- |[http://www.php.net/manual/en/function.is-null.php is_null]||Finds whether a variable is NULL||bool is_null(var) |- |[http://www.php.net/manual/en/function.is-numeric.php is_numeric]||Finds whether a variable is a number or a numeric string||bool is_numeric(var) |- |[http://www.php.net/manual/en/function.is-string.php is_string]||Find whether the type of a variable is string||bool is_string(var) |- |join{{NewIn|2.0|b=130129}}||Join elements as a new string||join(arg1, arg2, ... argN) |- |list||Return comma-separated list of non-blank values||string list(arg1, arg2, ... argN) |- |listifop{{NewIn|3.16.1}}||Return a 'glue'-separated list of the specified question property (retProp) from questions in the list which pass the criteria (cmpProp op value)||string listifop(cmpProp, op, value, retProp, glue, sgqa1, sgqa2, ... sgqaN) |- |[http://www.php.net/manual/en/function.log.php log]|| The logarithm of number to base, if given, or the natural logarithm. ||number log(number,base=e) |- |[http://www.php.net/manual/en/function.ltrim.php ltrim]||Strip whitespace (or other characters) from the beginning of a string||string ltrim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.max.php max]||Find highest value||number max(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.min.php min]||Find lowest value||number min(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.mktime.php mktime]||Get UNIX timestamp for a date (each of the 6 arguments are optional)||number mktime([hour [, minute [, second [, month [, day [, year ]]]]]]) |- |modulo-function||The modulo function is '''not supported''' yet. You can use the floor() function instead||floor(x/y)==(x/y) |- |[http://www.php.net/manual/en/function.nl2br.php nl2br]||Inserts HTML line breaks before all newlines in a string||string nl2br(string) |- |[http://www.php.net/manual/en/function.number-format.php number_format]||Format a number with grouped thousands||string number_format(number) |- |pi||Get value of pi||number pi() |- |[http://www.php.net/manual/en/function.pow.php pow]||Exponential expression||number pow(base, exp) |- |[http://www.php.net/manual/en/function.quoted-printable-decode.php quoted_printable_decode]||Convert a quoted-printable string to an 8 bit string||string quoted_printable_decode(string) |- |[http://www.php.net/manual/en/function.quoted-printable-encode.php quoted_printable_encode]||Convert a 8 bit string to a quoted-printable string||string quoted_printable_encode(string) |- |[http://www.php.net/manual/en/function.quotemeta.php quotemeta]||Quote meta characters||string quotemeta(string) |- |[http://www.php.net/manual/en/function.rand.php rand]||Generate a random integer, see [[Expression Manager sample surveys#Randomly Ask One Question Per Group|this example]]||int rand() OR int rand(min, max) |- |regexMatch||compare a string to a [[Using regular expressions|regular expression]]||bool regexMatch(pattern,input) |- |[http://www.php.net/manual/en/function.round.php round]||Rounds a number to an optional precision||number round(val <nowiki>[</nowiki>, precision]) |- |[http://www.php.net/manual/en/function.rtrim.php rtrim]||Strip whitespace (or other characters) from the end of a string||string rtrim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.sin.php sin]||Sine||number sin(arg) |- |[http://www.php.net/manual/en/function.sprintf.php sprintf]||Return a formatted string||string sprintf(format, arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.sqrt.php sqrt]||Square root||number sqrt(arg) |- |stddev||Calculate the Sample Standard Deviation for the list of numbers||number stddev(arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.str-pad.php str_pad]||Pad a string to a certain length with another string||string str_pad(input, pad_length <nowiki>[</nowiki>, pad_string]) |- |[http://www.php.net/manual/en/function.str-repeat.php str_repeat]||Repeat a string||string str_repeat(input, multiplier) |- |[http://www.php.net/manual/en/function.str-replace.php str_replace]||Replace all occurrences of the search string with the replacement string||string str_replace(search, replace, subject) |- |[http://www.php.net/manual/en/function.strcasecmp.php strcasecmp]||Binary safe case-insensitive string comparison||int strcasecmp(str1, str2) |- |[http://www.php.net/manual/en/function.strcmp.php strcmp]||Binary safe string comparison||int strcmp(str1, str2) |- |[http://www.php.net/manual/en/function.strip-tags.php strip_tags]||Strip HTML and PHP tags from a string||string strip_tags(str, allowable_tags) |- |[http://www.php.net/manual/en/function.stripos.php stripos]||Find position of first occurrence of a case-insensitive unicode string (starting by 0, return false if not found)|||int stripos(haystack, needle <nowiki>[</nowiki>, offset=0]) |- |[http://www.php.net/manual/en/function.stripslashes.php stripslashes]||Un-quotes a quoted string||string stripslashes(string) |- |[http://www.php.net/manual/en/function.stristr.php stristr]||Case-insensitive strstr||string stristr(haystack, needle <nowiki>[</nowiki>, before_needle=false]) |- |[http://www.php.net/manual/en/function.strlen.php strlen]||Get string length||int strlen(string) |- |[http://www.php.net/manual/en/function.strpos.php strpos]||Find position of first occurrence of an unicode string (starting by 0, return false if not found)||int strpos(haystack, needle <nowiki>[</nowiki> offset=0]) |- |[http://www.php.net/manual/en/function.strrev.php strrev]||Reverse a string||string strrev(string) |- |[http://www.php.net/manual/en/function.strstr.php strstr]||Find first occurrence of a string||string strstr(haystack, needle<nowiki>[</nowiki>, before_needle=false]) |- |[http://www.php.net/manual/en/function.strtolower.php strtolower]||Make a string lowercase||string strtolower(string) |- |[http://www.php.net/manual/en/function.strtotime.php strtotime]||Parse about any English textual datetime description into a Unix timestamp||int strtotime(string) |- |[http://www.php.net/manual/en/function.strtoupper.php strtoupper]||Make a string uppercase||string strtoupper(string) |- |[http://www.php.net/manual/en/function.substr.php substr]||Return part of an unicode string||string substr(string, start <nowiki>[</nowiki>, length]) |- |sum||Calculate the sum of values in an array||number sum(arg1, arg2, ... argN) |- |sumifop||Sum the values of answered questions in the list which pass the criteria (arg op value)||number sumifop(op, value, arg1, arg2, ... argN) |- |[http://www.php.net/manual/en/function.tan.php tan]||Tangent||number tan(arg) |- |[http://www.php.net/manual/en/function.time.php time]||Return current UNIX timestamp||number time() |- |[http://www.php.net/manual/en/function.trim.php trim]||Strip whitespace (or other characters) from the beginning and end of a string||string trim(string <nowiki>[</nowiki>, charlist]) |- |[http://www.php.net/manual/en/function.ucwords.php ucwords]||Uppercase the first character of each word in a string||string ucwords(string) |- |unique||Returns true if all non-empty responses are unique||boolean unique(arg1, ..., argN) |} <span id="Functions_that_are_Planned_or_Being_Considered"></span> ===Funciones planificadas o consideradas=== Otras funciones que están planificadas (o que se están considerando) pero que aún no se han implementado incluyen las siguientes. Algunos de estos son para compatibilidad con versiones anteriores de otra herramienta de encuesta. {| class="wikitable" !Sintaxis!!Significado!!Comentarios |- |e()||devuelve el valor de e|| |- |formatDate(X, PAT)||devuelve el valor de cadena de la fecha X formateado según el patrón de formato de datos de Java PAT|| |- |formatNumber(X,PAT)||devuelve el valor de cadena del número X formateado según el número de Java patrón de formato PAT|| |- |getAnsOption(X)|| [[ExpressionAnswerOptions|Complemento principal ExpressionAnswerOptions ]] || |- |getAnsOption(X,Y)|| [[ExpressionAnswerOptions|Complemento principal ExpressionAnswerOptions ]] || |- |getRelevance(X)||devuelve la ecuación de relevancia para la pregunta X|| |- |getStartTime()||returns la fecha correspondiente a la hora del sistema cuando se inició la entrevista|| |- |getType(X)||devuelve el nombre de cadena del tipo de datos - por ejemplo, *NA* si esNA()|| |- |gotoFirst()||salta al primer conjunto de preguntas relevantes: esto viola el flujo normal del sistema|| |- |gotoNext()||salta al siguiente conjunto de preguntas relevantes - esto viola el flujo normal del sistema|| |- |gotoPrevious()||salta al conjunto anterior de preguntas relevantes - esto viola el flujo normal del sistema|| | - |isAsked(X)||devuelve verdadero si la respuesta no es *NA*, *INVALID*, ni *UNASKED*|| |- |isInvalid(X)||devuelve verdadero si la respuesta es de tipo *INVALID*|| |- |isNA(X)||devuelve verdadero si la respuesta es de tipo *NA*|| |- |isNotUnderstood(X )||devuelve verdadero si la respuesta es del tipo *HUH*|| |- |isRefused(X)||devuelve verdadero si la respuesta es del tipo *REFUSED*|| |-! N!|isSpecial(X)||devuelve verdadero si la respuesta es del tipo *UNASKED*, *NA*, *REFUSED*, *INVALID*, *UNKNOWN* o *HUH*|| |-!N !|isUnknown(X)||devuelve verdadero si la respuesta es del tipo *UNKNOWN*|| |- |jumpTo(X)||saltar al grupo que contiene la pregunta nombrada - esto viola lo normal flujo del sistema|| |- |jumpToFirstUnasked()||saltar a la primera pregunta no formulada <strike>, evitando así las preguntas respondidas anteriormente,</strike> esto viola el flujo normal del sistema|| |- | lastIndexOf(X,Y)||devuelve el último índice (base 0) de la cadena Y en la cadena X. Devuelve -1 si Y no está contenido en X|| |- |list(X,.. .)||una cadena que contiene una lista separada por comas de los valores positivos con "y" separando los dos últimos|| |- |mean(X,...)||devuelve la media de una lista de valores|| |- |numAnsOptions(X)||devuelve el número de opciones de respuesta que tiene la pregunta X|| |- |orlist(X,...)|| una cadena que contiene una lista de valores positivos separados por comas, con "o" separando los dos últimos|| |- |parseDate(X,PAT)||devuelve el valor de fecha de la cadena X analizada con la fecha de Java patrón de formato PAT|| |- |parseNumber(X,PAT)||devuelve el valor numérico de la cadena X analizada con el patrón de formato numérico de Java PAT|| |- |showAllResponsesExcept( questionList ,attributeList,attributeTitleList)||questionList = lista delimitada por barras verticales de identificadores de preguntas; atributoList = lista de atributos delimitados por barras verticales (como número de pregunta, título, texto, tipo, para que pueda decidir qué mostrar); atributoTitleList = lista delimitada por barras verticales de encabezados de tabla, por lo que se puede internacionalizar el informe.|| |- |showTheseResponses( questionList,attributeList,attributeTitleList)||questionList = lista delimitada por barras verticales de identificadores de preguntas; atributoList = lista de atributos delimitados por barras verticales (como número de pregunta, título, texto, tipo, para que pueda decidir qué mostrar); atributoTitleList = lista delimitada por barras verticales de encabezados de tabla, para poder internacionalizar el informe.|| |} <span id="Expression_Manager_Knows_Which_Variables_are_Local"></span> ==El Administrador de expresiones sabe qué variables son locales== Para crear correctamente JavaScript para la página, Expression Manager necesita saber qué variables están configuradas en la página y cuál es su ID de JavaScript (por ejemplo, para document.getElementById(x)). También debe saber qué variables se configuran en otras páginas (para poder garantizar que se cumplan las condiciones necesarias<input type='hidden' value='x'> los campos están presentes y poblados). <span id="Cascading_Conditions"></span> ==Condiciones en cascada== Si alguna de las variables es irrelevante, toda la ecuación será irrelevante (falsa). Por ejemplo, en la siguiente tabla, N/A significa que una de las variables no era relevante {| class="wikitable" !Operador!!Ejemplo!!a!!b!!Resultado |- |<nowiki> + (unario)</nowiki> ||<nowiki> +a</nowiki> ||N/A|| ||falso |- |- (unario)||-a||N/A|| ||falso |- |!||!a||N/A|| ||falso |- |== (o eq)||a == b||N/A||5||falso |- |== (o eq) ||a == b||N/A||0||falso |- |== (o eq)||a == b||N/A||N/A|| falso |- |!= (o ne)||a != b||N/A||5|| falso |- |!= (o ne)||a != b||N/A||N/A|| falso |- |!= (o ne)||a != b||N/A||0||falso |- |> (o gt)||a >b||N/A||5|| falso |- |>= (o ge)||a >= b||N/A||5||falso |- |< (o lt)||a < b||N/A||5||falso |- |<= (o le)||a <= b||N/A||5||falso |- |y||a y b||N/A||5||falso |- |y||a y b||N/A||N/A||falso! N!|- |o||a o b||N/A||N/A||falso |- |o||a o b||N/A||5 ||falso |- |<nowiki> +</nowiki> ||a + b||N/A||5||falso |- |-||a - b||N/A||5||falso |- |*||a * b||N/A||5||falso |- |/||a / b||5||N/A||falso |-! N!|()||(a)||N/A|| ||falso |- |(exp)||(a && b)||N/A||5||falso |- |(exp) op (exp)| |(b + b) > (a && b)||N/A||5||falso |- |función||suma(a,b,b)||N/A|| 5||falso |- |función||max(a,b)||N/A||5||falso |- |función||min(a,b )||N/A||5||falso |- |función||implosionar(', ',a,b,a,b)||N/A||5||falso! N!|- |función||si(a,a,b)||N/A||5||falso |- |función||está_vacío(a)||N/ Un|| ||falso |- |función||is_empty(a)||0 (o en blanco)|| ||verdadero |- |función||!is_empty(a)||N/A|| ||falso |} <span id="Overriding_Cascading_Conditions"></span> ===Anulación de condiciones en cascada=== Supongamos que desea mostrar un total acumulado de todas las respuestas relevantes. Podrías intentar utilizar la ecuación {suma(q1,q2,q3,...,qN)}. Sin embargo, esto se traduce internamente a LEMif(LEManyNA('q1','q2','q3',...,'qN'),'',sum(LEMval('q1'),LEMval('q2') ,LEMval('q3'),...,LEMval('qN'))). Entonces, si alguno de los valores q1-qN es irrelevante, la ecuación siempre devolverá falso. En este caso, sum() mostrará 0 hasta que se respondan todas las preguntas. Para evitar esto, a cada variable se le puede agregar un sufijo ".NAOK" (lo que significa que No aplicable está bien). En tales casos, se produce el siguiente comportamiento. Supongamos que tiene una variable q1.NAOK #q1 no se agrega a la cláusula LEManyNA() #LEMval('q1') continuará verificando si la respuesta es relevante y devolverá<nowiki> ''</nowiki> si no es así (las respuestas individuales irrelevantes serán ignoradas, pero no anularán la expresión completa). Entonces, la solución al problema del total acumulado es usar la ecuación suma (q1.NAOK,q2.NAOK,q3.NAOK,...,qN.NAOK). El uso del sufijo .NAOK también permite a los autores diseñar encuestas que tienen varias rutas posibles pero que luego convergen en rutas comunes. Por ejemplo, digamos que los sujetos responden una encuesta de una manera que está fuera del rango normal de respuestas. El autor podría alertar a los sujetos de que es posible que no obtengan resultados válidos y preguntarles si realmente quieren continuar con la encuesta. Si dicen que Sí, se mostrarán el resto de las preguntas. La condición para el "resto de las preguntas" verificaría si las respuestas iniciales fueron respondidas dentro del rango normal O si el sujeto dijo Sí a la pregunta que solo es relevante si respondió fuera del rango normal. <span id="How_does_Expression_Manager_Support_Conditional_Micro-Tailoring?"></span> ==¿Cómo admite Expression Manager la microadaptación condicional?== A continuación se muestra un ejemplo de microadaptación (donde Tipo de pregunta=='expr' significa una Ecuación): {| class="wikitable" !Código de pregunta!!Relevancia!!Tipo de pregunta!!Pregunta |- |nombre||1||texto||¿Cuál es tu nombre? |-! N!|edad||1||text||¿Cuántos años tienes? |- |badage||!is_empty(edad)||expr||{(edad<16) o (edad>80 )} |- |agestop||badage||message||Lo siento, {nombre}, tú también eres {if( (edad<16),'joven',if( (edad>80), 'viejo','mediana edad') ) } para esta prueba. |- |kids||!badage||yesno||¿Tienes hijos? |- |padres ||1||expr||{!badage && kids=='Y'} |- |numKids||parents||text||¿Cuántos hijos tienes? |-! N!|kid1||parents && numKids >= 1||text||¿Cuántos años tiene tu primer hijo? |- |kid2||parents && numKids >= 2||text||¿Cuántos años tiene? tu segundo hijo? |- |kid3||parents && numKids >= 3||text||¿Cuántos años tiene tu tercer hijo? |- |kid4||parents && numKids > = 4||text||¿Cuántos años tiene tu cuarto hijo? |- |kid5||parents && numKids >= 5||text||¿Cuántos años tiene tu quinto hijo? |-! N!|suma||1||expr||{suma(niño1.NAOK,niño2.NAOK,niño3.NAOK,niño4.NAOK,niño5.NAOK)} |- |informe||padres| |síno||{nombre}, dijiste que tienes {edad} y que tienes {numKids}. La suma de las edades de tus primeros {min(numKids,5)} hijos es {sumage} |} Todas estas preguntas pueden estar en una sola página (por ejemplo, en el mismo grupo) y solo se mostrarán las preguntas relevantes. Además, a medida que ingresa las edades de los niños, la expresión sum() en la última pregunta se actualizará dinámicamente en la página. <html>Expression Manager proporciona esta funcionalidad al rodear cada expresión con un nombre<nowiki></nowiki> <span>elemento. Cada vez que un valor cambia, vuelve a calcular la expresión que debería aparecer en ese</span><nowiki></nowiki> <span><span>elemento y regenera la pantalla. Puede tener docenas, o incluso cientos, de expresiones personalizadas en la misma página, y la página las volverá a mostrar todas en una sola actualización de pantalla.</span></span> <span id="Mapping_of_LimeSurvey_1.91+_to_Expression_Manager_Functionality"></span> ==Asignación de LimeSurvey 1.91+ a la funcionalidad del Administrador de expresiones== {| class="wikitable" !Característica antigua!!Nueva característica!!Comentarios |- |Condiciones||Relevancia||¡Puedes usar ecuaciones condicionales muy complejas y acceder a una gama más amplia de variables!N !|- |Evaluaciones||Ecuación||Cualquier puntuación de evaluación se puede reestructurar en una ecuación. ¡Esto garantiza que la puntuación se escriba en la base de datos y también le permite ver cambios dinámicos en el valor de la puntuación en la página actual |- |Replacements||Expression Manager||El motor central toma la cadena de entrada y trata todo lo que está entre llaves como una expresión, por lo que maneja todos los tipos de reemplazos históricos. Para evitar estropear el JavaScript incrustado, Expression Manager solo procesa el contenido entre llaves siempre y cuando (a) no haya espacios en blanco al principio o al final dentro de las llaves; por ejemplo, {expr} es una expresión, pero { expr}, {expr}, y { expr } no son expresiones. Además, Expression Manager no procesa contenido dentro de sus propias cadenas (por ejemplo, {list('hi','there {braces}')} genera "hola {braces}"). ¡También ignora las llaves de escape (por ejemplo, \{esto no es una expresión\}) |- |Validación||Administrador de expresiones||El plan es tomar los atributos de pregunta mínimos y máximos actuales y tener el Administrador de expresiones procesarlos. ¡De esa manera los valores mínimo/máximo pueden ser expresiones en sí mismos |} <span id="Syntax_Highlighting"></span> =Resaltado de sintaxis= Para ayudar a ingresar y validar expresiones, EM proporciona resaltado de sintaxis con las siguientes características: <span id="Types_and_Meanings_of_Syntax_Highlighting"></span> ==Tipos y significados del resaltado de sintaxis== {| class="wikitable" !Color!!Muestra!!Significado!!Información sobre herramientas!!Comentarios |- |fondo tostado||estilo='color-de-fondo: #eee8aa'|Muestra||el ecuación completa||ninguno||Todo lo que esté entre llaves y que se reconozca como una ecuación (por ejemplo, no hay espacios en blanco al principio o al final) se codificará por colores con un fondo color canela para ayudar a distinguirlo del texto circundante.N!|-!N !|texto rojo en negrita||style='color:#ff0000; background-color:#eee8aa'|'''Muestra'''||Un error||Alguna explicación del error||Puede ser una variable desconocida o un error en la función, .... La encuesta puede estar totalmente rota, este don No se muestra al usuario público. |- |blue text||style='color:#0000ff; background-color:#eee8aa'|Muestra||nombre de función||significado y sintaxis permitida||los nombres de funciones, o cosas que deberían ser funciones ya que van seguidas de un paréntesis de apertura, se presentan en texto azul en negrita. La información sobre herramientas muestra el significado y la sintaxis permitida para la función. |- |grey text||style='color:#808080; background-color:#eee8aa'|Muestra||cadena||ninguna||las cadenas entre comillas simples y dobles se muestran en texto gris |- |texto cian||style='color:#4169e1; background-color:#eee8aa'|Muestra||variable configurada en la misma página,||<nowiki> [</nowiki> nombre o código SGQA]: pregunta; valor; Lista de respuestas que muestra códigos para cada valor||Cualquier variable que esté configurada en la misma página de la pregunta actual se muestra en texto cian, lo que indica que se puede actualizar en javascript. La información sobre herramientas muestra su nombre (si usó INSERTANS:xxx) o el código SGQA (si usó el nuevo sistema de nombres), la pregunta real y su valor actual (o en blanco si no está configurado). Si el tipo de pregunta espera respuestas de un conjunto de valores enumerados, la asignación de los códigos para mostrar valores es show. |- |green text||style='color:#008000; background-color:#eee8aa'|Muestra||variable establecida en una página anterior||<nowiki> [</nowiki> nombre o código SGQA]: pregunta; valor; respuestaLista que muestra códigos para cada valor||Cualquier variable que se establezca en una página anterior se muestra en texto verde en negrita. La información sobre herramientas muestra su nombre (si usó INSERTANS:xxx) o el código SGQA (si usó el nuevo sistema de nombres), la pregunta real y su valor actual (o en blanco si no está configurado). Si el tipo de pregunta espera respuestas de un conjunto de valores enumerados, la asignación de los códigos para mostrar valores es show. |- |bold pink text||style='color:#9370db; background-color:#eee8aa'|Muestra||variable establecida en una página posterior <sup>en general: vacía al inicio de la encuesta, pero se puede completar con un índice o pasar a la anterior</sup> ||<nowiki> [</nowiki> nombre o código SGQA]: pregunta; valor; respuestaLista que muestra códigos para cada valor||Cualquier variable que se establezca en la página siguiente se muestra en texto rosa en negrita. La información sobre herramientas muestra su nombre (si usó INSERTANS:xxx) o el código SGQA (si usó el nuevo sistema de nombres), la pregunta real y su valor actual (o en blanco si no está configurado). Si el tipo de pregunta espera respuestas de un conjunto de valores enumerados, la asignación de los códigos para mostrar valores es show. |- |bold tan text||style='color:#a0522d; background-color:#eee8aa'|Muestra||un valor de reemplazo de lima||el valor||Las cadenas de reemplazo de lima (como {TOKEN:xxx}, {PRIVACY_MESSAGE}) se muestran en texto tostado en negrita. |- |texto rojo||style='color:#ff4500; background-color:#eee8aa'|Muestra||operador de asignación (=) ||mensaje de advertencia||Si utiliza uno de los operadores de asignación (=), ese operador se mostrará en texto rojo. Esto está destinado a ayudar a evitar la reasignación accidental de valores cuando realmente quería verificar si a == b en lugar de establecer el valor de a = b. |- |normal black text||style=' de color negro; background-color:#eee8aa'|Muestra||puntuación||none||Todos los demás signos de puntuación dentro de la expresión se muestran como texto negro normal. |- |texto en cuadro rojo||una línea roja en negrita rodea el error||error de sintaxis||descripción del error||Cualquier error de sintaxis detectado se muestra rodeando el error con un cuadro rojo. La información sobre herramientas muestra el error. Los ejemplos incluyen paréntesis no coincidentes, uso de funciones no definidas, pasar el número incorrecto de argumentos a funciones, expresiones mal estructuradas (por ejemplo, operadores faltantes entre variables), intentar asignar un nuevo valor a una variable de solo lectura, intentar asignar valores a variables no definidas. variables o el uso de sintaxis no compatible. Tenga en cuenta que el sistema de detección de errores de sintaxis solo puede informar un error en una expresión incluso si hay varios errores; sin embargo, si se detecta algún error, se mostrará al menos uno. |} <span id="Additional_Reading"></span> =Lectura adicional= <span id="Expression_Manager_sample_surveys"></span> ==[[Encuestas de muestra de Expression Manager|Encuestas de muestra de Expression Manager]]== <span id="Use_Cases_and_HowTos"></span> ==[[Procedimientos de ExpressionScript|Casos de uso y procedimientos]]== <span id="Step-by-Step_examples"></span> ==[[Ejemplos de ExpressionScript|Ejemplos paso a paso]]== ==[[StatFunctions|Expression Manager statistic functions]]== <span id="Reference_for_Developers"></span> ==[[Administrador de expresiones para desarrolladores|Referencia para desarrolladores]]== <span id="RoadMap/Status/ToDo_List"></span> ==[[Hoja de ruta del Administrador de expresiones|Mapa de ruta/Estado/Lista de tareas pendientes]]==