Revision as of 07:44, 7 September 2023

Other languages:

Estructura

La primera parte del artículo describirá para qué se pueden utilizar las expresiones y dónde encontrar/agregar una expresión. La segunda parte proporciona ejemplos sobre cómo utilizar Expression.

Categorías de Expresiones

LimeSurvey utiliza expresiones para los siguientes propósitos:

Relevancia

Propósito: Ocultar grupos de preguntas/preguntas

La relevancia controla si un grupo de preguntas o una pregunta se muestra u oculta. Si el resultado de la expresión es "verdadero" (es decir, 1), se mostrará el elemento. De lo contrario (si el resultado de la Expresión es "falso" (es decir, 0)), el elemento quedará oculto.

Tipo	Muestra/oculta	Dónde encontrar
Grupo de preguntas Relevancia	grupo de preguntas	Crear/Editar grupo de preguntas -> "Ecuación de relevancia:"
Relevancia de la pregunta	pregunta	Crear/Editar pregunta -> "Ecuación de relevancia:"
Relevancia de la subpregunta	subpregunta	Editar subpreguntas -> "Ecuación de relevancia:"

Validación

Propósito: Validar aportes/acciones sobre preguntas/subpreguntas/respuestas

La validación controla si la aportación del encuestado a una pregunta o acción es válida o no. Si el resultado de la expresión es "verdadero" (es decir, 1), se aplicará la clase "buena" al elemento y al mensaje de validación. De lo contrario, si el resultado de la expresión es "falso" (es decir, 0)), se aplicará la clase "error" al elemento y al mensaje de validación. Puede declarar un estilo para estas clases en template.css.

Tipo	Valida	Dónde encontrar	Captura de pantalla
Validación de pregunta	pregunta	Crear/Editar pregunta -> "Pestaña Lógica" - > "Ecuación de validación de preguntas"
Validación de subpreguntas	subpreguntas	Crear/Editar pregunta -> "Pestaña Lógica" -> " Ecuación de validación de subpreguntas"	‎

Salida de texto

Propósitos: (Hacer algo) y escribir algún texto

Se puede utilizar una expresión para escribir algún texto. Por ejemplo, puede probar o calcular algo y especificar el resultado según el resultado de la prueba o cálculo. También se puede utilizar para insertar el texto de la pregunta, las respuestas, los tipos de preguntas, etc. de una pregunta utilizada antes de utilizar la Expresión. La salida de texto se puede utilizar en todos los lugares donde se muestra un texto y puede devolver todo tipo de resultados.

Caso de uso	Descripción
Micro sastrería	Ajustar un texto, por ejemplo, escribir "Señor" o "Señora" dependiendo de una pregunta de género formulada anteriormente
Cálculo	Calcule un valor y escríbalo, por ejemplo, "Su ingreso familiar es xxx"
Referencia	Inserte un texto de un elemento, por ejemplo, "Tu nombre es xxx. ¿Cuántos años tienes?"

Almacenamiento de respuestas

Propósitos: (Hacer algo) (escribir algún texto) y almacenar algo en la base de datos

El tipo de pregunta de ecuación se puede utilizar para almacenar algo en la base de datos. Puede hacer algo con una Expresión, mostrar la pregunta de Ecuación (que es similar a visualización de texto) y almacenar el resultado de la Expresión en la base de datos. Almacena la respuesta en la tabla de respuestas. Luego, el resultado se puede utilizar dentro de la función de estadísticas o también se puede importar a uno de los formatos proporcionados por la función de exportación de LimeSurvey.

Ejemplos de expresiones

Inserte una respuesta de una pregunta anterior

Propósito	Insertar una respuesta de una pregunta anterior
Tipo	Referencia
Ejemplo	Pregunta uno (código de pregunta " Q00"): ¿En qué ciudad vives? Pregunta dos (código de pregunta "Q01") ¿Cuánto tiempo ha vivido en la CIUDAD? Para hacer: La respuesta de la pregunta uno debe usarse en lugar de "CIUDAD" de la segunda pregunta.
Expresión	{QOO}
Descripción	¡La respuesta proporcionada en Q00 reemplaza el campo Q00 de la segunda pregunta
Pasos	Crear/Editar pregunta dos Inserte "¿Cuánto tiempo ha vivido en {QOO} (años)?" en el campo de texto de la pregunta

Usar una pregunta de ecuación oculta para autocompletar una respuesta

Problema: Imagina que tienes dos preguntas Q1 y Q2. La primera pregunta pregunta a los encuestados por su edad. La pregunta 2 divide a los encuestados en tres grupos: la edad es menor de 20 años, la edad es 20 años y la edad es mayor que 20 años. Entonces, la pregunta 2 debe hacer uso de los valores "1", "2", "3", que corresponden a las condiciones anteriores. Además, no debemos olvidarnos de hacer invisible la pregunta Q2 (la pregunta no se mostrará en la encuesta, pero los valores se realizarán a través del "proceso en segundo plano" dentro de la tabla de respuestas).

Para completar la base de datos usando el tipo de pregunta Ecuación:

Primero, cree una pregunta con el código Q1 como pregunta de entrada numérica.
Luego cree otra pregunta con el código Q2 como pregunta de ecuación.
En el capítulo de la pestaña "Configuración de visualización" de la P2:
- establezca el campo "Ocultar siempre esta pregunta" como "Activado"
- escriba en el campo "Ecuación" la expresión:

 {si(Q1.NAOK < 20, "1", si(Q1.NAOK > 20, "3", "2"))}

Crear una página de resumen usando marcadores de posición

Este tutorial demuestra cómo puede crear una descripción general al final de la encuesta, enumerando todas las preguntas y respuestas a través de marcadores de posición de ExpressionScript. También muestra cómo limite dicha descripción general a las preguntas respondidas únicamente.

Nuestro ejemplo se puede descargar desde aquí: Ejemplo de encuesta de marcadores de posición de encuesta.

Tipos de preguntas que se utilizan aquí:

1. Preguntas de opción única/preguntas de texto único/numéricas

Lista (desplegable)
Lista (radio) [L]
Sí/No [Y]
Texto libre largo [T ]
Texto libre breve [S]
Entrada numérica [N]
Ecuación [*]

2. Pregunta con subpreguntas

Texto breve múltiple [Q]
Elección múltiple [M]
Matriz [F]
Matriz (Sí/No/Incierto) [C]!N !*Matriz (elección de 10 puntos) [B]

3. Preguntas con 2 escalas

Array dual scale [1]

4. Preguntas con escalas X e Y

Array (Números) [:]

5. Preguntas de máscara

Visualización de texto [X]

En este ejemplo simple, nuestra descripción general será una lista simple con:

- Texto de la pregunta: Respuesta del usuario

Preguntas de opción única/texto único/preguntas numéricas

Para todos estos tipos de preguntas, Limesurvey almacenará una única respuesta:

¡Lista (desplegable)
Lista (radio)
Lista con comentario
5 puntos de elección
Sí/No
Texto libre corto
Texto libre largo!N !*Texto libre enorme
Entrada numérica
Ecuación
Fecha
Sexo

Suponiendo que el código de la pregunta es q1, podemos hacer referencia al texto de la pregunta y responder usando:

- {q1.pregunta}: {q1.mostrado}

Ejemplo:

- ¿Cuántos años tienes?: 25

Si desea comprobar si se respondió esa pregunta, puede incluir una declaración IF alrededor de su salida:

{if(!is_empty(q1),join("- ",q1.question,": ",q1.shown),"")}

Esto se "traduce" a: SI la pregunta con código q1 no está vacía, genera "- " Y el texto de la pregunta Y ": " Y el texto de la respuesta (la función join() une elementos como una nueva cadena; DE LO CONTRARIO: no genera nada (" " significa cadena vacía).

Pregunta con subpreguntas

Para todos estos tipos de preguntas, LimeSurvey utiliza subpreguntas:

¡Múltiples textos cortos
Múltiples opciones
Múltiples opciones con comentarios
Matriz
Matriz (5 puntos a elegir)
Matriz (10 puntos a elegir)
Matriz (Sí /No/Incierto)
Matriz (Aumentar/Igual/Disminuir)
Matriz por columna

Suponiendo que el código de la pregunta es q2 y las subpreguntas están numeradas SQ001, SQ002 (numeración automática realizada por LimeSurvey), podemos hacer referencia al texto de la pregunta y responder usando:

- {q2_SQ001.question}: {q2_SQ001.mostrado}

- {q2_SQ002.question}: {q2_SQ002.mostrado}

Para preguntas de opción múltiple, ahora tiene sentido mostrar el texto de la subpregunta marcada pero mostrar una Y para cada opción seleccionada:

- {q2_SQ001.question}: {q2_SQ001}

- {q2_SQ002.question}: {q2_SQ002}

...

Tenga en cuenta que actualmente no es posible generar el texto de las preguntas con subpreguntas; consulte esta solicitud de función.

Ejemplo 1 (asumiendo que el tipo de pregunta es de opción múltiple)

- ¿Conoces estas marcas de coches?

--Mercedes: Sí

-- Audi: No

-- Volvo: Sí

Si desea generar solo elementos marcados, puede colocar una declaración IF alrededor de su salida y verificar el valor de la casilla de verificación:

{ if( q2_SQ001=="Y", unirse( "- ", q2_SQ001.question, ": ", q2_SQ001.shown ), "" ) }

Utilice la función listifop si desea generar una lista solo de los elementos seleccionados, por ejemplo: Mercedes, Volvo

{ listifop( 'valor', '==', 'Y', 'pregunta', ', ', that.q2.sgqa ) }

Donde that.q2 se expande a todas las subpreguntas de q2. Consulte self, this and that para obtener más detalles.

Ejemplo 2 (asumiendo que el tipo de pregunta es Matriz (elección de 10 puntos))

- Califique la calidad de las marcas de automóviles a continuación en una escala de 1 = muy mala a 10 = muy buena.

--Mercedes: 7

-- Audi: 9

-- Volvo: 9

If you want to output rated items only you can put an IF statement around your output and check if the current sub question was answered by using:

{ if( ! is_empty( q3_SQ001 ), join( "- ", q3_SQ001.question, ": ", q3_SQ001.shown ), "" ) }

Use the listifop function if for example you want to only output a list of the selected items greater than eight, eg: Audi / Volvo

{ listifop( 'value', '>', 8, 'question', ' / ', that.q3.sgqa ) }

Question with two scales

This applies to the dual scale question type only.

Let's assume that the following codes are being used:

Question code: q4
Subquestion codes: SQ001, SQ002, ...
Answer codes scale 1: A1, A2, ...
Answer codes scale 2: B1, B2, ...

To refer to the result of a certain subquestion on a certain scale, you need to use QuestionCode . '_' . SubQuestionCode . '_' . ScaleID. Note that "ScaleID" is 0 for the first scale and 1 for the other!
Example for referring to the answer of the third subquestion and second scale: q4_SQ003_1 - Question 4, subquestion 3, second scale.

Let's output the results for both scales and the first two subquestions:

- {q4_SQ001_0.question}: {q4_SQ001_0.shown} / {q4_SQ001_1.shown}

- {q4_SQ002_0.question}: {q4_SQ002_0.shown} / {q4_SQ002_1.shown}

To output the subquestion text, you need to add the scale ID to the placeholder (though the texts are the same for both scales). So instead of {q4_SQ001.question} we have to use {q4_SQ001_0.question} or {q4_SQ001_1.question}.

If you want to export/display the results of subquestions with at least one answer only, use this syntax for each subquestion:

{if(count(q4_SQ001_0,q4_SQ001_1)>0,join("- ",q4_SQ001_0.question,": ",q4_SQ001_0.shown," / ",q4_SQ001_1.shown),"")}

Question with X and Y scales

This applies to all matrix questions which allow an answer for every cell (not just every row as shown previously):

Array Texts
Array Numbers

Assumed codes used:

Question code: q5
Subquestion codes: SQ001, SQ002, ...
Answer codes: A1, A2, ...

To refer to the result of a certain subquestion from a certain column, you need to use QuestionCode . '_' . SubQuestionCode . '_' . AnswerCode. Example for referring to the answer of the third subquestion and second column: q5_SQ003_A2.

Let's output the results for columns 1-3 of the first two subquestions:

- {q5_SQ001_A1.question}: {q5_SQ001_A1.shown} | {q5_SQ001_A2.shown} | {q5_SQ001_A3.shown}

- {q5_SQ002_A1.question}: {q5_SQ002_A1.shown} | {q5_SQ002_A2.shown} | {q5_SQ002_A3.shown}

Since for these question types each cell (combination of X axes and Y axes) equals one answer option, a test for existing data needs to be done for each cell. Example:

{if(!is_empty(q5_SQ001_A1),join("- ",q5_SQ001_A1.question,": ",q5_SQ001_A1.shown),"")}

To output the subquestion text you need to add the answer code to the placeholder (though the texts are the same for all answer options). So instead of {q5_SQ001.question} we have to use {q5_SQ001_A1.question} or {q5_SQ001_A2.question}.

Hide question if answer from previous question is empty

Purpose	Hide question if answer from previous question is empty
Type	Question Relevance
Example	Question one: question code "name", question text "What's your name?" Question two: question text "{name}, how old are you?" To do: Hide question two if the textfield of question one is empty
Expression	!is_empty(name)
Description	is_empty() determines whether a variable is considered to be empty. The "!" negates the result. So if the variable is not empty the Expression will be true and the question is shown
Steps	Create/edit question two Insert "!is_empty(name)" into "Relevance equation:"
Sample File	Hide_question_if_empty_question_group.zip

Hide question group if answer from previous question is Yes or No

Purpose	Hide question group if answer from previous question is Yes or No
Type	Question group Relevance
Example	Page one, Question Group one, Question one: question code "PET", question text "Do you have a pet?" -Yes -No Page two, Question Group two: Title "About your pet(s)" To do: Show/Hide question group two if answer from question one is Yes/No
Expression	PET == "Y"
Description	PET is the question code for the question you want to check the answer. If you don't use a suffix EM will use "Qcode.code". So you compare the answer code from the PET question to the value "Y". If the participant answers "Yes" the Expression is true and the question group "About your pet(s)" will be shown.
Steps	Create/edit question group two Insert "PET == "Y"" into "Relevance equation:"
Sample File	Hide_question group_if_answer_from_previous_question_is_Yes_or_No.zip

Display value of a multiple answer input question field

Purpose	Display value of a multiple answer input question field
Type	Reference
Example	Question one: question code "AskChildAge", question text "How old are your children?". Subquestions codes -Child1 -Child2 -Child3 - ChildXXX Question two: question code "ReportChildAge" question text "About your first child: - CHILD1 is AGE1."
Expression	{AskChildAge_Child1.question}, {AskChildAge_Child1.value}
Description	You want to use the value of a subquestion in a following question. You can access the subquestion value with this kind of expression: QcodeQuestion_QcodeSubquestion.value
Steps	Create/edit the second question Insert this text in the description: "About your first child: - {AskChildAge_Child1.question} is {AskChildAge_Child1.value}."
Sample File	Display_value_of_a_multiple_answer_input_question_field.zip

Validate number of boxes ticked per row for an "Array (Numbers) Checkbox" question

Purpose	Validate number of boxes ticked per row
Type	Validation
Example	Question of type "Array Numbers (Checkbox Layout)"
Expression	sum(...)
Description	(sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) determines whether at least X checkboxes in row A are checked. If you want to check all three rows (A, B, C), you can connect the expression using "&&": (sum(Test_A_1, Test_A_2, Test_A_3, Test_A_4, Test_A_5) <= X) && (sum(Test_B_1, Test_B_2, Test_B_3, Test_B_4, Test_B_5) <= X) && (sum(Test_C_1, Test_C_2, Test_C_3, Test_C_4, Test_C_5) <= X)
Steps	Create/edit question of type "Array Numbers (Checkbox Layout)". Insert the above expression into "Question validation equation" at the advanced question settings (you might have to adjust variable namings!).
Sample File	Validate number of boxes ticker per row for an Array (Numbers) Checkbox.lss

Calculate difference between two dates

Purpose	Calculate difference between two dates
Type	Relevance / Equation question type / Validation
Example	Question one (date/time, code: DOB): What is your date of birth? Question two (date/time, code: datetoday): What is the date today? Question three (boilerplate): You are XXXX days old. To do: Calculate and display the number of days between the date given in question 1 and the question 2.
Expression	{(strtotime(datetoday)-strtotime(DOB))/60/60/24}
Description	strtotime calculates the number of seconds between the 1st of January 1970 and the given date. The above expression calculates the number of seconds between the two given dates. The term "/60/60/24" just calculates the number of days from the number of seconds. Instead of asking for the "datetoday", you can also use strtotime('now') or simply time(), which directly returns the number of seconds from January 1970 until now (i.e. the time the survey was taken). Thus you could quickly figure out the age of a person in years with the equation {(time() - strtotime(DOB)) / 60 / 60 / 24 / 365.25} In any of these cases, it is critical that the date is entered in a proper format, otherwise the strtotime() function will not work right.
Steps	Create two date questions (for the date of birth and for today's date) and a boilerplate question. In the question text of the boilerplate question insert: "On {datetoday} you were {(strtotime(today)-strtotime(dob))/60/60/24} days days old." Please note: The function strtotime can work with MANY but not all date formats. If you run into problems set your survey's date format to mm/dd/yyyy or yyyy-mm-dd or dd.mm.yyyy"
Sample File	Date_difference.zip

Using ExpressionScript for Assessments

Here comes another example on how to use the ExpressionScript with Array type questions and assessments:</ br>

Let's say you have 2 array questions and you want to save the results of the calculation data to your database. It is actually simple, you will need to create and test your arrays and submit a dummy response to see if it works and gives you the results in the completed page.

Implementation details:

add a question of type equation
add the following line assuming that Q1 is your array question code while Q2 is the second one:
- ```
{sum(Q1_SQ001.value,Q2_SQ001.value)}
```

Note that SQ001 is the default code for any subquestion. If you change the subquestion code, adjust the equation above accordingly.

Using em_validation_q in array

You can use the question validation equation to control an array with any condition.