FlowScript

Los comandos son instrucciones que se ejecutarán cuando FlowScript se ejecute. Es posible añadir uno o más comandos, con o sin condición. Cada comando debe terminar con el signo «;» (punto y coma)..

Los comandos posibles son:

• Función GoTo (salto)
• Función GoToRnd (salto aleatorio)
• Función Ot (fuera del target)
• Asignar un valor a un campo de nominativo
• Asignar respuestas
• SetVariable (asignar campos de nominativos y respuestas avanzadas).

GoTo #

Saltar a la página o pregunta especificada.

Ejemplo de un salto simple:

goto(P3);

salta a la página P3.

Ejemplo de un salto con secuencia:

goto(P3, P5, P10);

salta a la página P3, luego a la página P5, luego a la página P10.

GoToRnd #

Muestra páginas o preguntas específicas de forma aleatoria, terminando siempre con la página o pregunta especificada como último parámetro.

Por ejemplo:

gotornd(P5, P6, P10);

Mostrará las páginas P5 y P6 de forma aleatoria, luego terminará con la página P10.

Ot #

Envía al nominativo con la entrevista en curso fuera de objetivo.

Ejemplo de fuera de objetivo con condición:

if(Q1==1 && Q2==3) ot();

Si en la pregunta Q1 se seleccionó la respuesta con código 1 y en la pregunta Q2 se seleccionó la respuesta con código 3, se sale fuera de objetivo.

Asignar valor a campo de nominativo #

Permite asignar un valor a cualquier campo de nominativo.

Ejemplo:

{CarBrand} = Jaguar;

Asigna «Jaguar» al campo de nominativo CarBrand.

Ejemplo con condición:

if (Q1==3 && Q2==1) {Subscription} = Netflix;

Si en la pregunta Q1 se seleccionó la respuesta con código 3 y en la pregunta Q2 se seleccionó la respuesta con código 1, asigna «Netflix» al campo de nominativo Subscription.

Asignar respuesta #

Permite asignar una respuesta a cualquier pregunta del cuestionario.

Ejemplo de selección de respuesta:

Q15 = 3;

Selecciona la respuesta con código 3 en la pregunta Q15.

Ejemplo de selección de elección múltiple:

Q15 = '3,4,8';

Selecciona las respuestas con códigos 3, 4 y 8 en la pregunta Q15.

Ejemplo de relleno de una respuesta abierta de una pregunta:

[Q12] = 'Estoy muy satisfecho';

Rellena la respuesta abierta en la pregunta Q12.

Las condiciones permiten especificar el caso en el que uno o más comandos deben ejecutarse. Una condición, en su forma simple, está compuesta por la instrucción if y por una expresión de comparación. A continuación va seguida del comando a ejecutar si la condición es verdadera.

if(Q1==1) ot();

Si en la pregunta Q1 se seleccionó la respuesta con código 1, se sale fuera de target.

Es posible utilizar diferentes símbolos de comparación y operadores lógicos para combinar múltiples condiciones.

if(Q1>5 && Q2!=1) goto(P5);

Si en la pregunta Q1 se seleccionó una respuesta con código mayor que 5 y en la pregunta Q2 no se seleccionó la respuesta con código 1, se envía a la página P5.

Es posible utilizar expresiones con múltiples factores para realizar cálculos algebraicos o para combinar texto de respuestas abiertas, campos de nominativos y secuencias.

if([Q1]+[Q2]<100) goto(P5);

Si la suma del número introducido en la respuesta abierta de las preguntas Q1 y Q2 es inferior a 100, se envía a la página P1.

Centrémonos en todos los temas necesarios para crear condiciones de cualquier nivel de complejidad:

• Símbolos de comparación
• Operadores lógicos
• if…then (para especificar los comandos a ejecutar cuando la condición es verdadera)
• if…then…else (para añadir comandos a ejecutar cuando la condición es falsa)
• while (ejecuta comandos mientras la condición sea verdadera)
• Lista de funciones para usar en condiciones

Símbolos de comparación #

Los símbolos de comparación para usar dentro de las expresiones de las condiciones son:

• == igual
• != diferente
• < menor
• > mayor
• <= menor o igual
• >= mayor o igual

Operadores lógicos #

Las condiciones pueden combinarse entre sí utilizando paréntesis y los operadores lógicos habituales:

• && y
• || o
• ! negación

Ejemplo:

( Q1==1 || Q1==2) && ( Q2==1||Q2==2 )

Si en la pregunta Q1 se seleccionó la opción con código 1 o con código 2, y en la pregunta Q2 se seleccionó la opción con código 1 o con código 2.

( !Q1==1 ) || ( (Q2== 1 || Q2==2) && (Q3==1||Q3==2) )

Si la condición «Q1 igual a 1» no es verdadera, o si en la pregunta Q2 se seleccionó la opción con código 1 o con código 2, y en Q3 se seleccionó la opción con código 1 o con código 2.

If…then #

La instrucción if…then permite establecer la condición en la que uno o más comandos deben ejecutarse

if(condición) comando;

Si la condición es verdadera, ejecutar el comando.

Ejemplo:

if(Q8==3 && [Q2]<18) ot();

Si en la pregunta Q8 se seleccionó la opción con código 3 y en la respuesta abierta de la pregunta Q2 se introdujo un valor inferior a 18, se sale fuera de target.

Ejemplo de condición con múltiples comandos:

if(Q2==3 && Q2!=1) { {Car_Owned}=ningún; ot(); }

Si en la pregunta Q2 se seleccionó la opción con código 3 y en la pregunta Q2 no se seleccionó la opción 1, el campo de nominativo «Car_Owned» se rellenará con «ningún», luego se sale fuera de target.

If…then…else #

La instrucción if…then…else amplía las posibilidades de la instrucción if…then permitiendo añadir comandos a ejecutar cuando la condición es falsa.

La sintaxis es la siguiente:

if(<span style="font-size: revert;">condición</span>) {comando si la condición es verdadera} else {comando si la condición es falsa}

Por ejemplo:

if(Q1==1) goto(P2); else goto(P5);

Si en la pregunta Q1 se seleccionó la opción de respuesta con código 1, se envía a la página P2, de lo contrario (si la condición es falsa) se va a la página P5..

While #

While permite repetir uno o más comandos mientras la condición sea verdadera. Con la instrucción while es posible crear bucles dentro del FlowScript. El uso de esta instrucción generalmente se limita a necesidades particularmente complejas. No debe confundirse con los bucles de secciones del cuestionario

La sintaxis es la siguiente:

while(<span style="font-size: revert;">condición</span>) comando;

For example:

{j}=0; 
while ({j} <= {i})
	{
		{total}= {total}+[Q1][{j}];
		{j}++;
	}

Asigna el valor 0 a la variable j.

Si el valor de la variable j es inferior al valor de la variable i, rellena el campo «total» añadiendo el valor anterior del campo «total» a la cantidad introducida en la pregunta abierta Q1 de j, luego incrementa el campo j en 1.

Las siguientes funciones fueron desarrolladas para gestionar excepciones especiales y pueden utilizarse tanto dentro de condiciones como de comandos. El uso de estas funciones generalmente se limita a requisitos complejos específicos.

Shorthand if…then…else #

En FlowScript es posible utilizar la instrucción if…then…else incluso en la forma conocida como «shorthand». Esta forma es necesaria para utilizar las condiciones dentro de otros comandos o para introducir el texto dinámico en el cuerpo del cuestionario. Técnicamente, la forma «shorthand» del if permite añadir una condición dentro de funciones que solo aceptan expresiones. A pesar de la diferente sintaxis, la lógica y el funcionamiento no difieren del funcionamiento normal del if…then…else.

condición ? expresión_condición_verdadera : expresión_condición_falsa

Por ejemplo:

(Q1==1)?'privado':'empresa'

Si en la pregunta Q1 se seleccionó la opción con código 1, devuelve la secuencia «privado», de lo contrario devuelve «empresa».

(Q1==1)?{código_fiscal}:{número_identificación_fiscal}

Si en la pregunta Q1 se seleccionó la opción con código 1, devuelve el valor del campo de nominativo llamado «código_fiscal», de lo contrario devuelve «número_identificación_fiscal».

([Q1]>1)?'¿Qué edad tienen tus hijos?':'¿Qué edad tiene tu hijo?'

Si en la pregunta abierta Q1 se introdujo un número mayor que 1 (número de hijos), se mostrará el texto de la pregunta en forma plural, de lo contrario se mostrará la forma singular.

En el siguiente ejemplo mostraremos cómo crear condiciones if else «shorthand» combinadas.

( [Q1]>=4 ) ? 'positivo' : ( [Q1]<=2 ) ? 'negativo' : ( [Q1]==3 ) ? 'neutro' : ' '

i en la pregunta abierta Q1 se introdujo un valor mayor o igual a 4, el sistema devuelve la secuencia «positivo», de lo contrario comprueba si se introdujo un valor menor o igual a 2 y en este caso devuelve la secuencia «negativo»; de lo contrario comprueba si se introdujo el valor 3: en este caso devolverá la secuencia «neutro», de lo contrario devolverá una secuencia vacía.

FlowScript da prioridad a la velocidad de programación y a la simplicidad de las expresiones, a expensas de la ortodoxia del lenguaje. Esto genera algunas peculiaridades que pueden confundir a un usuario experto en otros lenguajes de programación.

Secuencias con o sin comillas simples, ¿cuáles son las diferencias? #

La sintaxis completa y correcta de las secuencias requiere el uso de comillas simples. Si la secuencia incluye solo una palabra (es decir, sin espacios), es posible omitir las comillas simples.

Por lo tanto, la sintaxis [D1]==Marco is equal to [D1]=='Marco'.

La condición [D1]=='muy satisfecho' no puede escribirse sin comillas simples, ya que son necesarias para determinar el inicio y el final de una secuencia.

Asimetría de las comparaciones #

Los elementos que se comparan dentro de las condiciones (los elementos antes y después del operador de comparación) NO son iguales. El que aparece después del operador de comparación siempre se interpreta como una secuencia, mientras que el que precede al operador, si es una secuencia libre (sin comillas simples), se interpreta como un código de pregunta.

Por ejemplo, la condición D1==1 verifica si en la pregunta con código D1 se dio una respuesta con código 1″. Si invierto el orden de los elementos obtendré la condición 1==D1 que significa «verifica si en la pregunta con código 1 se dio una respuesta con código D1», lo cual es completamente diferente.

Por lo tanto, tenga siempre presente que las comparaciones NO son, en general, invertibles.