Funciones

ABS

(expresión)

valor absoluto de una determinada expresión.

AÑOS

(fecha1;fecha2)

años que hay entre una variable de tipo fecha y otra variable de tipo fecha.

CAMBIA.ESCALA

(expresión;máximo)

valor invertido de una escala, dónde máximo es el mayor valor que se puede alcanzar en la escala.

DESVTIP

(expresión1;expresión2;...;expresiónn)

desviación típica de una serie de expresiones registro a registro.

DIAS

(fecha1;fecha2)

días que hay entre una variable de tipo fecha y otra variable de tipo fecha.

EXP

(expresión)

permite definir una expresión aritmética que puede incluir otras funciones.

EXPON

(expresión)

exponencial de la expresión escrita

HORAS

(hora1;hora2)

horas que hay entre una variable de tipo hora y otra variable de tipo hora.

LAST

(variable_multiple)

devuelve el último valor que se ha escrito en una múltiple.

LN

(expresión)

logaritmo neperiano de una expresión.

LOG

(expresión)

logaritmo base 10 de una expresión.

MAX

(expresión1;expresión2;...;expresiónn)

dadas unas expresiones aritméticas, máximo registro a registro.

MAXINDEX

(expresión1;expresión2;...;expresiónn)

retorna el valor del índice (orden de variable) que cumple con el estadístico máximo. Si ponemos tres variables, 1 será la primera variable, 2 la segunda y 3 la tercera.

MAXRANGO

(variable1; variable2; ...;variablen)

devuelve el valor máximo del rango localizado al realizar trade – offs entre parejas de variables.

MEDIA

(expresión1;expresión2;...;expresiónn)

dadas unas expresiones aritméticas, se calcula la media registro a registro.

MENCIONES

(variable_multiple)

número de items que se contestan en una variable múltiple.

MESES

(fecha1;fecha2)

meses que hay entre una variable de tipo fecha y otra variable de tipo fecha.

MIN

(expresión1;expresión2;...;expresiónn)

dadas unas expresiones aritméticas, mínimo registro a registro.

MININDEX

(expresión1;expresión2;...;expresiónn)

retorna el valor del índice (orden de variable) que cumple con el estadístico mínimo. Si ponemos tres variable 1 será la primera variable, 2 la segunda y 3 la tercera.

MINRANGO

(variable1; variable2; ...;variablen)

devuelve el valor mínimo del rango localizado al realizar trade offs entre parejas de variables.

MINUTOS

(hora1;hora2)

minutos que hay entre una expresión de tipo hora y otra variable de tipo hora.

NUMALEATORIO

(expresión)

cálculo de un número aleatorio entre 0 y el valor de la expresión

NUMERAR

(máximo valor a numerar)

numerar los registros con un máximo. Llegado a ese máximo se reinicia la numeración.

RAIZ.C

(expresión)

raíz cuadrada de una expresión.

RAIZ.N

(n;expresión)

raíz n–ésima de una expresión.

REDONDEA

(expresión;decimales)

redondear según normas internacionales una expresión y con los decimales indicados.

ROUND

(expresión)

redondea a valor Intro

SEGUNDOS

(h1;h2)

segundos que hay entre una variable de tipo hora y otra variable de tipo hora.

SUMA

(expresión1;expresión2;...;expresiónn)

suma las variables numéricas contenidas en la expresión. Se puede utilizar un intervalo de variables con la opción SUMA(VAR1..VARn), es decir, incluyendo 1ª y última variable del intervalo. En caso de haber variables con distinto tipo por medio, no serían contabilizadas.

TRUNCA

(expresión)

elimina la parte decimal de una expresión.

VARIANZA

(expresión1;expresión2;...;expresiónn)

varianza de una serie de expresiones aritméticas registro a registro

XDESVTIP

(expresión1;expresión2;...;expresiónn)

calcula el estadístico del mismo nombre pero no contabilizando los valores perdidos o especiales

XMEDIA

(expresión1;expresión2;...;expresiónn)

calcula el estadístico del mismo nombre pero no contabilizando los valores perdidos o especiales

XSUMA

(expresión1;expresión2;...;expresiónn)

calcula el estadístico del mismo nombre pero no contabilizando los valores perdidos o especiales

XVARIANZA

(expresión1;expresión2;...;expresiónn)

calcula el estadístico del mismo nombre pero no contabilizando los valores perdidos o especiales

ACUMETI

(var1;var2;...;varn)

donde se acumulan los textos de los valores contestados en las variables 1,2 ... hasta n siendo éstas variables de cualquier tipo en una variable alfanumérica.

ACUMVAL

(var1;var2;...;varn)

donde se acumulan los valores contestados en las variables 1,2 ... hasta n siendo éstas variables categoría, numéricas o múltiples en una variable múltiple.

ASIGNAR.VALOR

(Param1;Param2)

(funcionalidad en fase de desarrollo que lee los valores por defecto de la variable en la que es especificada la función; si se acumula más de un valor  por defecto a imputar, será necesario que la variable que contiene las asignaciones de valor sea de tipo múltiple. En esta función, Param2 es la expresión de tipo VAR, COD, EXP, TEXTO, CONCATENAR ... que se imputa a la variable descrita en Param1. Nótese la importancia del tipo de variable según el tipo de información que se calcule e impute.

CARACTERES

(nomvar)

permite comparar el nº de caracteres que se han escrito en un campo abierto.

CALCULAR.EDAD

(fecha1;fecha2)

calcula la edad del individuo en la fecha2.

COD

(nomvar)

muestra la etiqueta del código grabado en la variable NomVar.

CODMUL

(varn;orden)

permite recuperar el texto del código de la variable múltiple indicada en el orden de mención indicado.

COMBINAR

(varn;k;z)

permite realizar combinaciones de respuestas tomadas de K en K de forma ordenada (z=0) o aleatoria (z=1). Esta función se debe escribir en una variable de tipo alfanumérico, siendo separadas las combinaciones con el símbolo #.

CONCATENAR

("literales";cod/var(nombre variable))

permite que en una variable alfanumérica o numérica según el resultado del concatenar sea texto o número o también en un texto, se pueda construir un texto o número utilizando textos literales (entrecomillados) y o la función COD(NomVar) o VAR(NomVar) que devuelve la etiqueta del valor anotado en la variable (código) o VAR(NomVar) que devuelve el valor de la variable). Se pueden encadenar diferentes literales y valores. Por ejemplo: CONCATENAR("El perfil es éste:";" Sexo";COD(SEXO);" Edad";COD(EDAD);" Provincia";VAR(PROVINCIA))

CONTROL.DURACION

(nomvar/nomcomponente)

nos retorna el valor en milisegundos que se ha estado en el campo o video que se está visualizando. Esta función por tanto se puede utilizar para comprobar que al menos se ha estado n segundos viendo un video, lo que combinado con el autoplay, nos permite controlar si se ha visto el video completo.

COORDINADOR

( )

se asigna de forma automática a la entrevista el login del coordinador al cuál está asociado el entrevistador en el momento de realizar la entrevista.

COPY

("Cadena";Índice;Caracteres)

copia de una variable, el números de caracteres indicado desde la posición indicada por el índice.

CUENTA

(Condición a contar;Condición que deben cumplir los datos sobre los que se hace el recuento)

se hace un COUNT en la base de datos con la condición indicada y se retorna el valor del mismo. Por ejemplo CUENTA(D=1;ESTADO=(1;6)) contaría el nº de entrevistas con D=1 entre las entrevistas finalizadas online o Gandia MobiNet. Atención porque el efecto es diferente, ya que en online cuenta sbre la base de datos total, mientras que en Gandia MobiNet cuenta sobre lo que hay en la base de datos del entrevistador.

CUOTA

("condición de la cuota")

carga el valor numérico de la cuota descrita.

CUOTATEORICA

("condición de la cuota")

carga el valor numérico de la cuota descrita.

CUOTASABIERTAS()

( )

devuelve los identificadores de todas las cuotas (de 1 a n según el orden de definición en el cuestionario, ver cuotas)  abiertas en el momento de alcanzar el flujo esa ubicación.

CUOTASABIERTAS

(var1;var2;...;varn;params)

devuelve los identificadores de las cuotas (de 1 a n según el orden de definición en el cuestionario, ver cuotas) abiertas en el momento de alcanzar el flujo esa ubicación, pero solo aquellas cuotas que contienen las variables definidas. Es importante el orden de las mismas, deben estar definidas de izquierda a derecha, del mismo modo que intervienen en la condición.

La función se completa con un parámetro (params) extra, que irá en último lugar y podrá ser: 0 - aleatorio; 1 - valor mínimo cuota real; 2 - valor máximo cuota real; 3 - mayor diferencia entre real y teórico; 4 - menor diferencia entre real y teórico. Si params no existe, equivale a 0.

DATE2NUMBER

(varfecha)

convierte una fecha en un número de fecha. 1/1/1970 es el 0.

DIASEMANA

( )

retorna el día de la semana actual (lunes=1 y domingo=7)

DIASEMANA

(varfecha)

retorna el día de la semana de la variable fecha (lunes=1 y domingo=7)

DIMECUOTA

(vardecuota=vari;vardecuotan=varn)

expresión que nos devuelve la cuota o cuotas a las que pertenece un determinado registro. Sólo admitida como valor por defecto en variables de tipo múltiple. Su expresión podría ser la siguiente: DIMECUOTA(SEX=SEX_1;ED=ED_1;OC=OC_1;HG=HG_1).

El resultado será una variable de tipo múltiple, cuyos códigos serán los índices de cuota.

DIVMUL

(varn;n)

divide la variable de tipo múltiple Varn escribiendo en la variable de destino el orden n de respuesta. 1 sería el primer valor, 2, el segundo hasta n. Lo habitual es dividir una múltiple entre n variables de tipo categoría.

DUPLICADOS

(nomvar1;nomvar2;estado=(0;2;4;5_7;9))

permite poder impedir la repetición de un valor de una variable o conjunto de valores de varias variables (únicos y unidos por el operador lógico Y) entre las entrevistas que contengan los estados de entrevista indicados.

ELIMINAR.VALOR

(Param1;Param2)

elimina el valor indicado en Param2 en la variable Param1 si se cumple la condición.

EXTRAE.FECHA

(AA;NomVar) extrae el año con dos dígitos

(AAAA;NomVar) extrae el año con cuatro dígitos

(M;NomVar) extrae el mes con dígitos sin cero

(MM;NomVar) extrae el mes con dígito con cero

(D;NomVar) extrae el día con dígito sin cero

(DD;NomVar) extrae el día con dígito con cero

función que extrae información de la fecha en otra variable, según argumentos.

EXTRAE.HORA

(H24;NomVar) extrae la hora en formato  24 horas sin cero

(HH24;NomVar) extrae la hora en formato 24 horas con cero

(H;NomVar) extrae la hora en formato  12 horas sin cero

(HH;NomVar) extrae la hora en formato 12 horas con cero

(M;NomVar) extrae el minuto con dígitos sin cero

(MM;NomVar) extrae el minuto con dígito con cero

(S;NomVar) extrae el segundo con dígito sin cero

(SS;NomVar) extrae el segundo con dígito con cero

función que extrae información de la hora en otra variable, según argumentos.

EVAL_SEL

(varn, k)

devuelve k valores de los seleccionados y que cumplan la condición de código en la variable n.

EVALUACUOTA

(vardecuota=vari;vardecuotan=varn)

expresión que nos devuelve un 0 o un 1 si el individuo pertenece a una cuota que está abierta. En esta función se debe indicar que variable se comparan. Dada una estructura de cuotas que relaciona SEXO y OCUP, EDAT y HOGAR, se estima un valor por defecto que es:  EVALUACUOTA (SEX=SEX_1; ED=ED_1; OC=OC_1; HG=HG_1).

EXECMUL

["...."]

ejecuta una instrucción del diseñador esperando que el resultado sea una cadena separada por ";" la instrucción puede ser cualquier función de las expresadas en esta tabla.

EXECNUM

["...."]

ejecuta una instrucción del diseñador esperando que el resultado sea un número real; la instrucción puede ser cualquier función de las expresadas en esta tabla.

EXECTXT

["...."]

ejecuta una instrucción del diseñador esperando que el resultado sea una cadena; la instrucción puede ser cualquier función de las expresadas en esta tabla.

FECHAACTUAL

( )

recupera el valor actual de la fecha del sistema donde se realiza al entrevista.

GPS

listado de posibilidades abajo.

se incorpora una nueva utilidad tanto en diseño como en offline (próximamente en web) la función de poder recoger las coordenadas GPS de la entrevista. Para ello es necesario disponer de un GPS conectado al PC (se supone que portátil) y el diseño de las variables alfanuméricas que contendrán las coordenadas. Se puede trabajar con los tres estándar. Las funciones a asignar se listan a continuación todas tiene como función GPS y como parámetro la parte de la coordenada a recoger):

GPS

(VALIDO)

indica si hay conexión GPS válida (0, no / 1, sí)

GPS

(ALTITUD)

recoge la información de altitud el punto

GPS

(LONG_GRADOSDEC)

recoge la información de longitud (Google MAPS, Open Street Map, etc.)

GPS

(LAT_GRADOSDEC)

recoge la información de latitud (Google MAPS, Open Street Map, etc.)

GPS

(DIRECCION)

obtiene de forma inversa la dirección a partir de las coordenadas de GPS. No es necesario tener las coordenadas en el cuestionario, pero sí necesaria conexión de datos para poder conectar con Google.

GPS

(PRECISION)

obtiene la precisión de la medición GPS en el momento de la captura.

GUID

( )

sobre variables alfanuméricas, devuelve una cadena identificadora única de 32 caracteres con una probabilidad prácticamente imposible de repetir.

GUIDCONTACTO

( )

esta función devuelve el GUID que el contacto tiene asignado en la tabla de campo en el estudio de referencia. Solo utilizable en entrevistas auto administradas.

GUIDREC

( )

asignará en una variable del cuestionario el número de identificación único de la entrevista. Este es el mismo número que ya se está calculando para luego insertar en Gandia Integra.

HORAACTUAL

( )

recupera el valor actual de la hora del sistema donde se realiza al entrevista.

ID_APK

( )

función que devuelve la APK del dispositivo en el que se realiza la entrevista.

ID_BROWSER

( )

función que devuelve el navegador del dispositivo en el que se realiza la entrevista.

ID_DEVICE

( )

función que devuelve el UID del dispositivo en el que se realiza la entrevista.

ID_IDESTUDIO

()

función que guarda el identificador del código del estudio (numérico).

ID_IP

( )

función que devuelve la IP del navegador desde donde se conecta la entrevista.

ID_MODE

( )

función que devuelve el canal por el que se ha hecho la entrevista, siendo los valores a devolver;  los valores que quedarán registrados en la variable son (delante de los : y en mayúsculas):

ID_MODEL

( )

función que devuelve el modelo del dispositivo en el que se realiza la entrevista.

ID_SCREEN

( )

función que devuelve el tamaño de pantalla del dispositivo en el que se realiza la entrevista.

ID_SO

( )

función que devuelve el sistema operativo del dispositivo en el que se realiza la entrevista.

ID_PPI

( )

función que devuelve el número de pixels por pulgada que tiene la pantalla donde se realiza la entrevista.

ID_VERBROWSER

( )

función que devuelve la versión del navegador del dispositivo en el que se realiza la entrevista.

ID_VERSO

( )

función que devuelve la versión del sistema operativo del dispositivo en el que se realiza la entrevista.

IMAGEN

(file)

se muestra el elemento de imagen; sólo utilizable en valores por defecto de componentes de tipo multimedia imagen.

LIMPIAR

( )

esta función utilizable solo en variables de tipo múltiple, permite al ser utilizada en el valor por defecto borrar toda la información contenida en la misma para continuar evaluando las siguientes entradas del valor por defecto.

LISTAVAL

(a;b;n)

devuelve N valores entre el valor A y el valor B.

LOWERCASE

("cadena")

convierte a minúsculas una cadena o variable.

LENGTH

("cadena")

nos devuelve el número de posiciones que tiene una cadena o variable.

MAXFREC

(n;var1;var2;var3;...;vark)

devuelve los n valores más repetidos entre las respuestas dadas a la lista de variables indicada.

MAXFRECVALOR

(n;var1;var2;var3;...;vark)

devuelve la frecuencia de los valores más repetidos entre las respuestas dadas a la lista de variables indicada.

MAXFRECPCT

(n;var1;var2;var3;...;vark)

devuelve el porcentaje de frecuencia de los valores más repetido entre las respuestas dadas a la lista de variables indicada.

MAXORDEN

(#orden a recuperar#;var1;var2;var3....)

recupera el índice de la variable que ocupa el lugar igual a "orden a recuperar" (el máximo valor); esta función podría utilizarse dentro de una expresión.

MAXVALOR

(#orden a recuperar#;var1;var2;var3....)

recupera el valor de la variable que ocupa el lugar igual a "orden a recuperar" (el máximo valor); esta función podría utilizarse dentro de una expresión.

MINORDEN

(#orden a recuperar#;var1;var2;var3....)

recupera el índice de la variable que ocupa el lugar igual a "orden a recuperar" (el mínimo valor); esta función podría utilizarse dentro de una expresión.

MINVALOR

(#orden a recuperar#;var1;var2;var3....)

recupera el valor de la variable que ocupa el lugar igual a "orden a recuperar" (el mínimo valor); esta función podría utilizarse dentro de una expresión.

NUMBER2STRING

(NomVar; nºenteros; nºdecimales)

ajusta con ceros a la izquierda hasta el formato de la variable que se especifica con número de enteros y número de decimales.

NUMBER2DATE

(NomVar)

la variable destino será fecha, usar formato sistema. 1/1/1970 es 0.

NUMBER2TIME

(NomVar)

la variable destino será hora, usar formato sistema. 0 es 00:00:00, y suma de 1000 en 1000 milisegundos. 1000 son las 00:00:01.

ORDMUL

(nomvar)

ordena los valores registrados en una múltiple. para poder preguntar por orden de código tras hacer un DIVMUL.

PAGINA

( )

retorna el número de página de 1 a n, en el que se localiza el flujo de la entrevista.

PARAM

("nomparam")

permite que el campo de la entrevista en que se asigna esta función como valor por defecto, almacene el valor que se le pasa desde la URL de acceso al cuestionario. A esto se denomina uso de parámetros de entrada.

PCT.DURACION

( )

retorna el porcentaje de avance que en el cuestionario llevamos cumplimentado; es una función que se utiliza para las barras de progreso.

POS

("subcadena";"cadena")

busca la subcadena dentro de la cadena y retorna su posición. Por ejemplo buscar si hay una @ en una dirección de e-mail o un punto en una dirección de e-mail.

RANKING

(var1;var2;...;varn)

esta función permite controlar la no repetición de valores y que estos estén ordenados, es decir jerarquizados o haciendo un ranking; si esta función es utilizada por ejemplo (1) en un control al final de 8 variables con códigos de 1 a 8 (primer lugar, segundo lugar, tercer lugar ... octavo lugar) y es igualada a 3, el control NO RANKING(A1; A2; A3; A4; A5; A6; A7; A8)=3, significa que saltará el control si no se han jerarquizado (rankeado) 3 de las ocho posibles o también (2) usada como RANKING(A1; A2; A3; A4; A5; A6; A7; A8)<3, sólo saltará el control si se han jerarquizado menos de 3 opciones de las ocho posibles.

REC_COMBINACION

(vark;n)

recupera los pares creados con la orden COMBINAR, siendo n el orden del par.

REGEXP

(var;"expresion")

permite evaluar expresiones regulares de JavaScript, devolviendo como resultado TRUE si se cumple la condición o FALSE si no se cumple. El catálogo de expresiones regulares es muy amplio y puedes ser consultado en muchos lenguajes que comparten ese código; algunos ejemplos pueden ser ...

REPETIDOS

(var1;var2;var3;...varn)

expresión que nos devuelve un 1 si hay repetidos entre diferentes variables o 0 sin no los hay. Esta función se puede  utilizar tanto en saltos, filtros y controles como en valor por defecto. Si entre las variables indicadas hay repeticiones, la variable que tenga el valor por defecto, recibirá el 1.

SEL_COMBINACION

(vark;n;0/1)

expresión que selecciona n pares creados con la orden COMBINAR, y los introduce en una variable alfanumérica, ordenados (0) o sin ordenar (1). Posteriormente se puede utilizar el REC_COMBINACION para recuperarlos por separado.

SELCUOTA

(Vars;param)

expresión que nos devuelve el valor que debe tener la variable de cuota que falta por elegir. Ejemplo: si tenemos una cuota combinada de SEXO, EDAD y ROTACION, en la variable ROTACION se pondrá un valor por defecto SELCUOTA(SEXO;EDAD), que irá a buscar qué cuotas abiertas tiene ROTACION combinadas con SEXO y EDAD y nos dará el valor que deberá tener ROTACION; la función se completa con un parámetro (params) extra, que irá en último lugar y podrá ser:

SELECCIONAR

(k)

selecciona k objetos que cumplan la condición establecida en los códigos. Semejante funcionalidad que la función EVAL_SEL, pero sin necesitar de variables auxiliares; la selección se realiza de forma aleatoria.

SEMANA.ANYO

(varfecha)

muestra el número de semana del año en el que se encuentra la fecha indicada.

SONIDO

(file)

se muestra el elemento de sonido y se reproduce el archivo; sólo utilizable en valores por defecto de componentes de tipo imagen.

STARTRECORDING

()

función destinada a ser utilizada como referencia en texto o variable, para desencadenar el inicio de una grabación en MobiNet.

STOPRECORDING

()

función destinada a ser utilizada como referencia en texto o variable, para desencadenar el fin de una grabación en MobiNet.

STRING2NUMBER

(NomVar)

ajusta cortando por la izquierda hasta el formato de la variable.

SUBCADENA

(nomvar;"cadena_caracteres")

devuelve TRUE si localiza el texto buscado en la variable indicada. Funciona con cualquier cadena excepto con el espacio en blanco.

TABAUX

(nomcampo_tablacampo)

devuelve el valor del campo del Id_Contacto en la tabla de campo (debe ser un estudio con contactos).

TABLE

(tabla_apoyo[campo_tablapoyo1=var_qst1,campo_tablapoyo2=var_qst2...].campo_tablaapoyo_a_copiar)

nos permite copiar información del campo de la tabla auxiliar (campo_tabla.apoyo_a_copiar) si coinciden los valores de los campos respondidos en el cuestionario (var_qst1, var_qst2) con los que hay en la tabla auxiliar (campo_tablapoyo1, campo_tablapoyo2).

TEXTO

(texto a publicar)

donde texto a publicar es cualquier texto que se quiera imprimir en la página, incluyendo código html.

TREE

(Arbol;var1;...;varn;campo)

escribe el valor del "campo" dependiente del nivel correspondiente de un árbol jerárquico.

TREE.LABEL

(Arbol;var1;...;varn)

equivalente al COD, pero con las variables del árbol.

TREE.VALUE

(Arbol;var1;...;varn)

equivalente al VAR, pero con las variables del árbol.

TRIM

("Cadena")

elimina los espacios en blanco tras la cadena.

TIME2NUMBER

(NomVar)

convertir número en hora, siendo el 0 las 00:00:00. Se aumenta de 1000 en 1000 milisegundos. 1000 son las 00:00:01.

UPPERCASE

("Cadena")

convierte a mayúsculas una variable o cadena.

USUARIO

( )

se guarda en la variable el login del entrevistador.

VALOR

(n)

se guarda el valor seleccionado si se cumple la condición; no muestra la variable; si no se cumple la condición de ninguno de los valores en la variable (se puede encadenar más de uno) se muestra la variable para que sea respondida.

VALORANTERIOR

( )

recupera el valor anterior de la última entrevista finalizada.

VAR

(nomvar)

muestra el valor grabado en la variable de nombre nomvar.

VERSION

( )

esta función devuelve el número de versión del cuestionario con el que se está haciendo la entrevista.

VIDEO

(file)

se muestra el elemento de vídeo y se reproduce el archivo; sólo utilizable en valores por defecto de componentes de tipo multimedia vídeo.