Вы находитесь на странице: 1из 560

Gua de Sintaxis de script y funciones

de grficos
Qlik Sense
1.0.3
Copyright 1993-2015 QlikTech International AB. Reservados todos los derechos.
Copyright 1993-2015 QlikTech International AB. Reservados todos los derechos.

Qlik, QlikTech, Qlik Sense, QlikView, Sense y el logotipo de Qlik son marcas comerciales registradas
en varios pases o que QlikTech International AB usa como marcas comerciales. Las dems marcas
comerciales mencionadas en este documento son marcas comerciales de sus respectivos propietarios.
Contenidos

1 Qu es Qlik Sense? 11
1.1 Qu podemos hacer en Qlik Sense? 11
1.2 Cmo funciona Qlik Sense? 11
Modelo de app 11
La experiencia asociativa 11
Colaboracin y movilidad 11
1.3 Cmo se puede instalar Qlik Sense? 12
Qlik Sense Desktop 12
Qlik Sense Server 12
1.4 Cmo administrar y gestionar un sitio Qlik Sense 12
1.5 Ampliar Qlik Sense y adaptarlo a sus propias necesidades 12
construir extensiones y mashups 12
Construir clientes 12
Construir herramientas del servidor 12
Conexin con otras fuentes de datos 12
2 Sintaxis de script 13
2.1 Introduccin a la sintaxis de script 13
2.2 Qu es el formalismo Backus-Naur? 13
2.3 Sentencias de script y palabras clave 14
Sentencias de control de script 15
Prefijos de script 26
Sentencias habituales de script 52
2.4 Variables de script 102
Clculo de variables 103
Variables de sistema 104
Variables de manejo de valores 108
Variables de interpretacin numrica 110
Variables de Direct Discovery 117
Variables de error 121
2.5 Expresiones de script 123
3 Expresiones de visualizacin 125
3.1 Definir el mbito de agregacin 125
3.2 Analizar conjuntos de datos - Anlisis de conjuntos 127
Construir una expresin de conjunto 128
Identificadores de conjunto 129
Operadores de conjunto 130
Modificadores de conjunto 131
Sintaxis para conjuntos 136
3.3 Sintaxis 137
Sintaxis general para expresiones de grficos 137
Sintaxis general para agregaciones: 137
4 Operadores 139
4.1 Operadores de bit 139
4.2 Operadores lgicos 140

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 3


Contenidos

4.3 Operadores numricos 140


4.4 Operadores relacionales 141
4.5 Operadores de cadena 142
5 Funciones en scripts y en expresiones de grfico 143
5.1 Funciones de agregacin 143
Uso de las funciones de agregacin en el script de carga de datos 143
Uso de las funciones de agregacin en expresiones de grficos 143
Aggr - funcin de grfico 143
Funciones bsicas de agregacin 146
Funciones de agregacin de contador 165
Funciones de agregacin financiera 180
Funciones de agregacin estadstica 189
Funciones estadsticas de prueba 236
Funciones de agregacin en cadena 331
Funciones para dimensiones sintticas 339
Agregaciones anidadas 342
5.2 Funciones de color 343
ARGB 344
RGB 344
HSL 345
5.3 Funciones condicionales 345
Descripcin general de las funciones condicionales 346
alt 347
class 347
if 348
match 348
mixmatch 349
pick 349
wildmatch 349
5.4 Funciones de contador 350
Descripcin general de las funciones de contador 350
autonumber 351
autonumberhash128 352
autonumberhash256 352
fieldvaluecount 352
IterNo 353
RecNo 353
RowNo 353
RowNo - funcin de grfico 354
5.5 Funciones de fecha y hora 356
Descripcin general de las funciones de fecha y hora 356
addmonths 365
addyears 366
age 366
converttolocaltime 367

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 4


Contenidos

day 368
dayend 369
daylightsaving 369
dayname 370
daynumberofquarter 370
daynumberofyear 371
daystart 372
firstworkdate 372
GMT 373
hour 373
inday 373
indaytotime 374
inlunarweek 375
inlunarweektodate 375
inmonth 376
inmonths 377
inmonthstodate 377
inmonthtodate 378
inquarter 379
inquartertodate 379
inweek 380
inweektodate 381
inyear 381
inyeartodate 382
lastworkdate 383
localtime 383
lunarweekend 384
lunarweekname 385
lunarweekstart 385
makedate 386
maketime 387
makeweekdate 387
minute 388
month 388
monthend 389
monthname 389
monthsend 390
monthsname 391
monthsstart 391
monthstart 392
networkdays 393
now 393
quarterend 394
quartername 394
quarterstart 395
second 396

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 5


Contenidos

setdateyear 396
setdateyearmonth 397
timezone 397
today 397
UTC 398
week 398
weekday 398
weekend 399
weekname 400
weekstart 401
weekyear 402
year 402
yearend 403
yearname 403
yearstart 404
yeartodate 405
5.6 Funciones exponenciales y logartmicas 406
5.7 Funciones de campo 407
Funciones de contador 407
Funciones de campo y seleccin 407
GetAlternativeCount - funcin de grfico 408
GetCurrentSelections - funcin de grfico 409
GetExcludedCount - funcin de grfico 410
GetFieldSelections - funcin de grfico 411
GetNotSelectedCount - funcin de grfico 413
GetPossibleCount - funcin de grfico 413
GetSelectedCount - funcin de grfico 414
5.8 Funciones de archivo 416
Visin global de las funciones de archivo 416
Attribute 418
ConnectString 426
FileBaseName 426
FileDir 426
FileExtension 427
FileName 427
FilePath 427
FileSize 428
FileTime 428
GetFolderPath 429
QvdCreateTime 430
QvdFieldName 431
QvdNoOfFields 431
QvdNoOfRecords 432
QvdTableName 433
5.9 Funciones financieras 434

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 6


Contenidos

Visin global de las funciones financieras 434


Black and Scholes 435
FV 435
nPer 436
Pmt 437
PV 438
Rate 439
5.10 Funciones de formato 439
Descripcin general de las funciones de formato 440
Date 441
Dual 442
Interval 442
Num 443
Money 444
Time 444
Timestamp 445
5.11 Funciones numricas generales en grficos 446
BitCount 448
Ceil 448
Combin 449
Div 450
Even 450
Fabs 451
Fact 451
Floor 452
Fmod 452
Frac 453
Mod 454
Odd 454
Permut 455
Round 455
Sign 456
5.12 Funciones geogrficas 457
Descripcin general de las funciones geogrficas 457
5.13 Funciones de interpretacin 458
Descripcin general de las funciones de interpretacin 459
Date# 460
Interval# 460
Money# 461
Num# 462
Text 462
Time# 463
Timestamp# 463
5.14 Funciones inter-registro 464
Funciones de fila 464

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 7


Contenidos

Funciones de columna 465


Funciones de campo 466
Funciones inter registro en el script de carga de datos 466
Above - funcin de grfico 467
Bottom - funcin de grfico 471
Below - funcin de grfico 475
Column - funcin de grfico 478
Dimensionality - funcin de grfico 480
Exists 480
FieldIndex 481
FieldValue 482
FieldValueCount 483
LookUp 484
NoOfRows - funcin de grfico 485
Peek 486
Previous 487
Top - funcin de grfico 487
5.15 Funciones lgicas 490
5.16 Funciones de Correspondencia 491
Descripcin general de las funciones de Correspondencia 491
ApplyMap 491
MapSubstring 492
5.17 Constantes matemticas y funciones libres de parmetros 493
5.18 Funciones NULL 493
Descripcin general de las funciones NULL 494
IsNull 494
NULL 494
5.19 Funciones de rango 494
Funciones de rango bsicas 495
Funciones de rango de contador 495
Funciones de rango estadsticas 496
RangeAvg 497
RangeCorrel 498
RangeCount 499
RangeFractile 500
RangeIRR 502
RangeKurtosis 502
RangeMax 503
RangeMaxString 505
RangeMin 506
RangeMinString 507
RangeMissingCount 509
RangeMode 510
RangeNPV 513
RangeNullCount 513

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 8


Contenidos

RangeNumericCount 515
RangeOnly 516
RangeSkew 517
RangeStdev 519
RangeSum 520
RangeTextCount 522
RangeXIRR 523
RangeXNPV 524
5.20 Funciones de ranking en grficos 524
Rank - funcin de grfico 525
VRank - funcin de grfico 528
5.21 Funciones de distribucin estadstica 528
Descripcin general de las funciones de distribucin estadstica 528
CHIDIST 529
CHIINV 530
FDIST 530
FINV 531
NORMDIST 532
NORMINV 532
TDIST 533
TINV 534
5.22 Funciones de cadena 534
Descripcin general de las funciones de cadena 534
Capitalize 538
Chr 538
Evaluate 538
FindOneOf 539
Hash128 539
Hash160 539
Hash256 540
Index 540
KeepChar 540
Left 541
Len 541
Lower 541
LTrim 542
Mid 542
Ord 543
PurgeChar 543
Repeat 543
Replace 544
Right 544
RTrim 544
SubField 545
SubStringCount 545

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 9


Contenidos

TextBetween 546
Trim 546
Upper 546
5.23 Funciones de sistema 547
Descripcin general de las funciones de sistema 547
GetExtendedProperty - funcin de grfico 549
GetObjectField - funcin de grfico 549
QlikViewVersion 549
5.24 Funciones de tabla 549
Vista general de las funciones de tabla 550
FieldName 551
FieldNumber 551
NoOfFields 551
NoOfRows 552
5.25 Funciones trigonomtricas e hiperblicas 552
5 Restriccin de acceso al sistema de archivos 554
5.26 Limitaciones en el modo estndar 554
Variables de sistema 554
Sentencias de script habituales 555
Sentencias de control de script 556
Funciones de archivo 557
Funciones de sistema 559
5.27 Deshabilitar el modo estndar 559
Qlik Sense 559
Qlik Sense Desktop 559

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 10


1 Qu es Qlik Sense?

1 Qu es Qlik Sense?
Qlik Sense es una plataforma de anlisis de datos. Con Qlik Sense podemos analizar datos y descubrir
cosas por nosotros mismos. Podemos compartir los conocimientos y analizar datos en equipos o en toda la
empresa. Qlik Sense nos permite formular y responder nuestras propias preguntas, as como seguir nuestro
propio camino de investigacin e indagacin en los datos. Qlik Sense nos permite a nosotros y a nuestros
colegas llegar a las decisiones de manera conjunta.

1.1 Qu podemos hacer en Qlik Sense?


La mayora de productos de Business Intelligence (BI) ayudan a las personas a responder preguntas que ya
se comprenden de antemano. Pero qu ocurre con las preguntas que se nos van ocurriendo despus o
sobre la marcha? Ese tipo de preguntas que surgen tras leer un informe o visualizar un grfico? Con la
experiencia asociativa de Qlik Sense, podemos hacer todas las preguntas que se nos ocurran y responderlas
una tras otra, avanzando por nuestra propia ruta hacia el conocimiento. Con Qlik Sense podemos explorar
los datos libremente, mediante simples clics de ratn, aprendiendo y profundizando en cada etapa del
camino y descubriendo nuevas rutas de exploracin basadas en nuestros propios descubrimientos.

1.2 Cmo funciona Qlik Sense?


Qlik Sense genera vistas de informacin sobre la marcha. Qlik Sense no requiere informes predefinidos o
estticos ni que el usuario dependa de otros departamentos o usuarios, tan solo hacemos clic y aprendemos
cosas. Cada vez que un usuario hace clic, Qlik Sense responde al instante, actualizando cada visualizacin y
vista de Qlik Sense en la app con un nuevo conjunto de datos recin calculados y visualizaciones especficas
a lo que le interesa al usuario.

Modelo de app
En lugar de desplegar y gestionar complejas aplicaciones de negocio, podemos crear nuestras propias apps
de Qlik Sense y reutilizarlas, modificarlas o compartirlas con otros. El modelo de apps nos permite formular y
dar respuesta a todas nuestras preguntas espontneas, sin tener que recurrir a un experto para que elabore
un nuevo informe o visualizacin.

La experiencia asociativa
Qlik Sense gestiona automticamente todas las relaciones de los datos y presenta la informacin al usuario
mediante una codificacin de colores verde/blanco/gris. Las selecciones se muestran de color verde, los
datos asociados se visualizan en blanco y los datos excluidos (no asociados) se ven de color gris. Este
feedback instantneo anima a los usuarios a pensar en nuevas preguntas y continuar explorando y
descubriendo cosas.

Colaboracin y movilidad
Qlik Sense permite adems colaborar con otros colegas siempre que lo necesite y sin importar dnde se
encuentren. Todas las capacidades de Qlik Sense, entre las que se incluyen la experiencia asociativa y la
colaboracin, estn disponibles en dispositivos mviles. Con Qlik Sense, podemos formular y responder a

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 11


1 Qu es Qlik Sense?

nuestras propias preguntas, seguir haciendo preguntas posteriores de seguimiento, implicar a amigos y
colegas, en cualquier lugar en que nos encontremos.

1.3 Cmo se puede instalar Qlik Sense?


Hay dos versiones de Qlik Sense para instalar, Qlik Sense Desktop y Qlik Sense Server.

Qlik Sense Desktop


Esta es una versin fcil de instalar para un solo usuario que normalmente se instala en un ordenador local.

Qlik Sense Server


Esta versin se utiliza para instalar sitiosQlik Sense. Un sitio es un conjunto de una o ms mquinas de
servidor conectadas a un repositorio lgico comn o a un nodo central.

1.4 Cmo administrar y gestionar un sitio Qlik Sense


Con Qlik Management Console podemos configurar, gestionar y monitorizar sitios Qlik Sense de una forma
fcil e intuitiva. Podemos gestionar las licencias, el acceso y las normas de seguridad, configurar los nodos y
las conexiones de origen de datos, as como sincronizar el contenido y los usuarios, entre muchas otras
actividades y recursos.

1.5 Ampliar Qlik Sense y adaptarlo a sus propias


necesidades
Qlik Sense le proporciona APIs y SDKs flexibles para desarrollar sus propias extensiones y adaptar e integrar
Qlik Sense para diferentes propsitos como, por ejemplo:

construir extensiones y mashups


Aqu podemos hacer desarrollo web utilizando JavaScript para construir extensiones que son visualizaciones
personalizadas en las apps Qlik Sense, o bien podemos utilizar API de mashups para crear sitios web con
contenido de Qlik Sense.

Construir clientes
Puede construir clientes en .NET e incrustar objetos Qlik Sense en sus propias aplicaciones. Tambin puede
construir clientes nativos en cualquier lenguaje de programacin que admita la comunicacin WebSocket
mediante el protocolo de cliente de Qlik Sense.

Construir herramientas del servidor


Con las APIs de servicios y de directorios de usuarios puede crear su propia herramienta para administrar y
gestionar los sitios Qlik Sense.

Conexin con otras fuentes de datos


Puede crear conectores de Qlik Sense para recuperar datos de fuentes de datos personalizados.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 12


2 Sintaxis de script

2 Sintaxis de script

2.1 Introduccin a la sintaxis de script


En el script se define el nombre de la fuente de datos, los nombres de las tablas y los nombres de los
campos incluidos en la lgica. Adems, estn definidos en el script los campos definidos en los derechos de
acceso.

El script consta de una serie de sentencias que se ejecutan de manera consecutiva.

La sintaxis de la lnea de comandos de Qlik Sense y la sintaxis de script se describen en una notacin
denominada formalismo Backus-Naur o cdigo BNF.

Las primeras lneas de cdigo ya se generan al crearse un nuevo archivo de Qlik Sense. Los valores por
defecto de estas variables de interpretacin numrica se derivan de la configuracin regional del sistema
operativo.

En el script se define el nombre de la fuente de datos, los nombres de las tablas y los nombres de los
campos incluidos en la lgica. El script consta de una serie de sentencias de script y palabras clave que se
ejecutan de manera consecutiva.

Para un archivo de tabla con comas, tabuladores o puntos y coma empleados como delimitador, puede
usarse la sentencia LOAD. Por defecto, la sentencia LOAD es la que carga todos los campos del archivo.

Se debe acceder a una base de datos general mediante Microsoft Microsoft ODBC. Aqu se emplean
sentencias SQL estndar. La sintaxis SQL aceptada difiere entre diferentes drivers ODBC.

Todas las sentencias de script deben terminar con un punto y coma " ;".

Se puede acceder a una descripcin ms detallada de la sintaxis de script pulsando en los temas de esta
seccin.

2.2 Qu es el formalismo Backus-Naur?


La sintaxis de la lnea de comandos de Qlik Sense y la sintaxis de script se describen en una notacin
denominada formalismo Backus-Naur o cdigo BNF. A continuacin una breve descripcin del cdigo BNF:

Los siguientes smbolos deben ser interpretados as:

| O lgico: el smbolo puede emplearse a ambos lados.

() Los parntesis definen precedencia: sirven para estructurar la sintaxis BNF.

[] Los corchetes indican que los elementos que encierran son opcionales.

{} Llaves: los elementos incluidos entre llaves pueden repetirse ninguna o ms veces.

Smbolo Una categora sintctica no terminal: puede dividirse en otros smbolos, por ej.,
combinaciones de los anteriores, otros smbolos no concluyentes, cadenas de texto, etc.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 13


2 Sintaxis de script

::= Marca el comienzo de un bloque que define un smbolo.

LOAD Un smbolo final que consiste en una cadena de texto. Debe escribirse tal cual en el script.

Todos los smbolos terminales se imprimen en estilo negrita. Por ejemplo, "(" debera interpretarse como un
parntesis que define precedencia, mientras que " ( debe interpretarse como un carcter que ha de
imprimirse en el script.

Ejemplo:

La descripcin de la sentencia alias es:

alias fieldname as aliasname { , fieldname as aliasname}

Esto debe interpretarse como la cadena de texto "alias", seguida de un nombre de campo arbitrario, seguido
por la cadena de texto "as", seguida por un nombre de alias arbitrario. Se puede dar cualquier nmero de
combinaciones adicionales de "fieldname as alias", separadas por comas.

Por ej. las siguientes sentencias son correctas:

alias a as first;
alias a as first, b as second;
alias a as first, b as second, c as third;

Y estas sentencias no son correctas:

alias a as first b as second;


alias a as first { , b as second };

2.3 Sentencias de script y palabras clave


El script de Qlik Sense se compone de diversas sentencias. Una sentencia puede ser una sentencia habitual
de script o una sentencia de control de script. Ciertas sentencias pueden ir precedidas de prefijos.

Las sentencias ms comunes se utilizan habitualmente para manipular datos de varias formas. Estas
sentencias pueden escribirse sobre cualquier nmero de filas en el script y deben terminar siempre en punto
y coma ";".

Las sentencias de control en cambio se suelen emplear para controlar el flujo de ejecucin del script. Hay
que mantener cada clusula de una sentencia de control dentro de una lnea en el script. Estas clusulas
pueden terminar en punto y coma, o en un final de lnea.

La aplicacin de prefijos es posible con sentencias habituales, pero nunca con las sentencias de control. Sin
embargo, los prefijos when y unless s pueden emplearse como sufijos en unas cuantas sentencias de
control especficas.

En la siguiente seccin hallar una lista ordenada alfabticamente con todas las sentencias de script,
sentencias de control y prefijos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 14


2 Sintaxis de script

Todas las palabras clave del script pueden escribirse con cualquier combinacin de maysculas o
minsculas. Los nombres de campo y de variable utilizados en las sentencias, por supuesto, son sensibles a
maysculas.

Sentencias de control de script


El script de Qlik Sense se compone de diversas sentencias. Una sentencia puede ser de dos tipos, una
sentencia normal de script o una sentencia de control de script.

Las sentencias de control en cambio se suelen emplear para controlar el flujo de ejecucin del script. Cada
clusula de una sentencia de control debe estar dentro de una lnea de script y puede estar terminada por un
punto y coma o por un final de lnea.

Los prefijos no se aplican nunca a sentencias de control, a excepcin de los prefijos when y unless que s
pueden utilizarse con unas pocas sentencias de control especficas.

Todas las palabras clave del script pueden escribirse con cualquier combinacin de maysculas o
minsculas.

Descripcin general de las sentencias de control de script


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Call
La sentencia de control call llama a una subrutina que debe ser definida por una sentencia sub previa.

Call name ( [ paramlist ])

Do..loop
La sentencia de control do..loop crea un bucle que ejecuta una o varias sentencias hasta cumplirse una
condicin lgica.

Do..loop [ ( while | until ) condition ] [statements]


[exit do [ ( when | unless ) condition ] [statements]
loop [ ( while | until ) condition ]

Exit script
Esta sentencia de control detiene la ejecucin del script. Puede insertarse en cualquier parte del script.

Exit script[ (when | unless) condition ]

For each ..next


La sentencia de control for each..next crea un bucle que ejecuta una o varias sentencias para cada valor en
una lista separada por comas. Las sentencias que estn dentro del bucle, entre for y next se ejecutarn con
cada valor de la lista.

For each..next var in list


[statements]

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 15


2 Sintaxis de script

[exit for [ ( when | unless ) condition ]


[statements]
next [var]

For..next
La sentencia de control for..next crea un bucle con un contador. Las sentencias que estn dentro del bucle,
encerradas entre for y next sern ejecutadas para cada valor de la variable contador entre los lmites inferior
y superior especificados.

For..next counter = expr1 to expr2 [ stepexpr3 ]


[statements]
[exit for [ ( when | unless ) condition ]
[statements]
Next [counter]

If..then
La sentencia de control if..then crea una clusula condicional que hace que la ejecucin del script siga
diferentes caminos dependiendo de una o varias condiciones lgicas fijadas.

Como la sentencia if..then es una sentencia de control y como tal termina con punto y coma o
con un final de lnea, cada una de sus cuatro posibles clusulas (if..then,elseif..then, else y
end if) no debe sobrepasar el lmite de una lnea.

If..then..elseif..else..end if condition then


[ statements ]
{ elseif condition then
[ statements ] }
[ else
[ statements ] ]
end if

Sub
La sentencia de control sub..end sub define una subrutina, la cual puede ser invocada mediante una
sentencia call.

Sub..end sub name [ ( paramlist )] statements end sub

Switch
La sentencia de control switch es una construccin de script que obliga a que la ejecucin del script siga
diferentes caminos dependiendo del valor de una expresin.

Switch..case..default..end switch expression {case valuelist [ statements


]} [default statements] end switch

Call
La sentencia de control call llama a una subrutina que debe ser definida por una sentencia sub previa.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 16


2 Sintaxis de script

Sintaxis:

Call name ( [ paramlist ])

Argumentos:

Argumento Descripcin

name El nombre de la subrutina.

paramlist Una lista separada por comas de los parmetros que se habrn de enviar a
la subrutina. Cada elemento de la lista puede ser un nombre de campo,
una variable o una expresin arbitraria.

La subrutina invocada mediante una sentencia call debe ir definida por un sub encontrado anteriormente
durante la ejecucin del script.

Los parmetros se copian en la subrutina y, si el parmetro en la sentencia call es una variable y no una
expresin, se copia de nuevo fuera, al salir de la subrutina.

Limitaciones:

Como la sentencia call es una sentencia de control y, como tal, termina con un punto y coma o fin de lnea,
no deber sobrepasar el lmite de una lnea.

Ejemplo1:

// Example 1
Sub INCR (I,J)

I = I + 1
Exit Sub when I < 10
J = J + 1

End Sub
Call INCR (X,Y)

Ejemplo2:

// Example 2 - List all QV related files on disk


sub DoDir (Root)

For Each Ext in 'qvw', 'qvo', 'qvs', 'qvt', 'qvd', 'qvc', 'qvf'

For Each File in filelist (Root&'\*.' &Ext)

LOAD

'$(File)' as Name, FileSize( '$(File)' ) as


Size, FileTime( '$(File)' ) as FileTime
autogenerate 1;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 17


2 Sintaxis de script

Next File

Next Ext
For Each Dir in dirlist (Root&'\*' )

Call DoDir (Dir)

Next Dir

End Sub
Call DoDir ('C:')

Do..loop
La sentencia de control do..loop crea un bucle que ejecuta una o varias sentencias hasta cumplirse una
condicin lgica.

Sintaxis:

Do [ ( while | until ) condition ] [statements]


[exit do [ ( when | unless ) condition ] [statements]
loop[ ( while | until ) condition ]

Como la sentencia do..loop es una sentencia de control y como tal termina con punto y coma
o con un final de lnea, cada una de sus tres clusulas posibles (do, exit do y loop) no debe
sobrepasar el lmite de una lnea.

Argumentos:

Argumento Descripcin

condition Es una expresin lgica que se evala como True o False.

statements Es cualquier grupo de una o varias sentencias de script de Qlik Sense.

while / until La clusula condicional while o until solo debe aparecer una vez en cualquier sentencia
do..loop, es decir, o bien despus de do o despus de loop. Cada condicin se interpreta
slo la primera vez que se encuentra pero se evala cada vez que se encuentra en el
bucle.

exit do Si se encuentra una clusula exit do dentro del bucle, la ejecucin del script ser
transferida a la primera sentencia tras la clusula loop que indica el final del bucle. Una
clusula exit do puede hacerse condicional mediante el uso opcional de un sufijo when o
unless.

Ejemplo:

// LOAD files file1.csv..file9.csv


Set a=1;
Do while a<10
LOAD * from file$(a).csv;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 18


2 Sintaxis de script

Let a=a+1;
Loop

Exit script
Esta sentencia de control detiene la ejecucin del script. Puede insertarse en cualquier parte del script.

Sintaxis:

Exit Script [ (when | unless) condition ]

Como la sentencia exit script es una sentencia de control y, como tal, termina con un punto y coma o fin de
lnea, no deber sobrepasar el lmite de una lnea.

Argumentos:

Argumento Descripcin

condition Es una expresin lgica que se evala como True o False.

when Una sentencia exit script puede hacerse condicional mediante el uso
/unless opcional de un sufijo when o una clusula unless.

Ejemplos:

//Exit script
Exit Script;

//Exit script when a condition is fulfilled


Exit Script when a=1

For..next
La sentencia de control for..next crea un bucle con un contador. Las sentencias que estn dentro del bucle,
encerradas entre for y next sern ejecutadas para cada valor de la variable contador entre los lmites inferior
y superior especificados.

Sintaxis:

For counter = expr1 to expr2 [ step expr3 ]


[statements]
[exit for [ ( when | unless ) condition ]
[statements]
Next [counter]

Las expresiones expr1, expr2 y expr3 slo se evalan la primera vez que se entra en el bucle. El valor de la
variable contador puede ser modificado por sentencias dentro del bucle, pero no es una buena prctica de
programacin.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 19


2 Sintaxis de script

Si se encuentra una clusula exit for dentro del bucle, la ejecucin del script ser transferida a la primera
sentencia tras la clusula next que indica el final del bucle. Una clusula exit for puede hacerse condicional
mediante el uso opcional de un sufijo when o unless.

Como la sentencia for..next es una sentencia de control y como tal termina con un punto y
coma o con un final de lnea, cada una de sus tres clusulas posibles (for..to..step,exit for y
next) no debe sobrepasar el lmite de una lnea.

Argumentos:

Argumento Descripcin

counter Es un nombre de variable. Si se especifica counter despus de next deber tener el


mismo nombre de variable que el encontrado despus del for correspondiente.

expr1 Es una expresin que determina el primer valor de la variable counter para la que se debe
ejecutar el bucle.

expr2 Es una expresin que determina el valor que indica el incremento de la variable counter
cada vez que el bucle ha sido ejecutado.

expr3 Es una expresin que determina el valor que indica el incremento de la variable counter
cada vez que el bucle ha sido ejecutado.

condition Es una expresin lgica que se evala como True o False.

statements Es cualquier grupo de una o varias sentencias de script de Qlik Sense.

Ejemplo1: Cargar una secuencia de archivos

// LOAD files file1.csv..file9.csv


for a=1 to 9

LOAD * from file$(a).csv;

next

Ejemplo2: Cargar un nmero aleatorio de archivos

En este ejemplo, se supone que hay archivos de datos x1.csv, x3.csv, x5.csv, x7.csv y x9.csv. La carga se
interrumpe en un punto aleatorio mediante la condicin if rand( )<0.5 then.

for counter=1 to 9 step 2

set filename=x$(counter).csv;
if rand( )<0.5 then

exit for unless counter=1

end if
LOAD a,b from $(filename);

next

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 20


2 Sintaxis de script

For each..next
La sentencia de control for each..next crea un bucle que ejecuta una o varias sentencias para cada valor en
una lista separada por comas. Las sentencias que estn dentro del bucle, entre for y next se ejecutarn con
cada valor de la lista.

Sintaxis:

La sintaxis especial hace posible generar listas con los nombres de archivo y directorio en el directorio actual.

for each var in list


[statements]
[exit for [ ( when | unless ) condition ]
[statements]
next [var]

Argumentos:

Argumento Descripcin

var Es un nombre de variable de script que adquirir un nuevo valor de lista para cada
ejecucin del bucle. Si se especifica var despus de next deber tener el mismo nombre
de variable que el encontrado despus del for each correspondiente.

El valor de la variable var puede ser modificado por sentencias dentro del bucle, pero no es una buena
prctica de programacin.

Si se encuentra una clusula exit for dentro del bucle, la ejecucin del script ser transferida a la primera
sentencia tras la clusula next que indica el final del bucle. Una clusula exit for puede hacerse condicional
mediante el uso opcional de un sufijo when o unless.

Como la sentencia for each..next es una sentencia de control y como tal termina con punto y
coma o con un final de lnea, cada una de sus tres clusulas posibles (for each, exit for y
next) no debe sobrepasar el lmite de una lnea.

Sintaxis:

list := item { , item }


item := constant | (expression) | filelist mask | dirlist mask

Argumento Descripcin

constant Es cualquier nmero o cadena. Obsrvese que una cadena introducida directamente en el
script debe ir entre comillas simples. Una cadena sin entrecomillado simple se interpretar
como una variable y entonces se utilizar el valor de dicha variable. Los nmeros no tienen

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 21


2 Sintaxis de script

Argumento Descripcin

que ir entre comillas simples.

expression Es una expresin cualquiera.

mask Es una mscara de nombre de archivo o de carpeta que puede incluir cualquier carcter
vlido de nombre de archivo, as como los caracteres comodn * y ? estndares.

Puede utilizar rutas de archivo absolutas o rutas lib://.

condition Es una expresin lgica que se evala como True o False.

statements Es cualquier grupo de una o varias sentencias de script de Qlik Sense.

filelist mask Esta sintaxis produce una lista de todos los archivos incluidos en el directorio actual,
separados por coma, que coincidan con la mscara de nombre de archivo.

Este argumento admite nicamente conexiones de librera en modo


estndar.

dirlist mask Esta sintaxis produce una lista con todas las carpetas de la carpeta actual (separadas por
comas) que coincidan con la mscara de nombre de archivo.

Este argumento admite nicamente conexiones de librera en modo


estndar.

Ejemplo1: Cargar una lista de archivos

// LOAD the files1.csv, 3.csv, 7.csv and xyz.csv


for each a in 1,3,7,'xyz'
LOAD * from file$(a).csv;
next

Ejemplo2: Crear una lista de archivos en el disco

Este ejemplo carga una lista de todos los campos Qlik Sense relacionados en una carpeta.

sub DoDir (Root)


for each Ext in 'qvw', 'qva', 'qvo', 'qvs', 'qvc', 'qvf', 'qvd'

for each File in filelist (Root&'\*.' &Ext)

LOAD
'$(File)' as Name,
FileSize( '$(File)' ) as Size,
FileTime( '$(File)' ) as FileTime
autogenerate 1;

next File

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 22


2 Sintaxis de script

next Ext
for each Dir in dirlist (Root&'\*' )

call DoDir (Dir)

next Dir

end sub

call DoDir ('lib://MyData')

If..then..elseif..else..end if
La sentencia de control if..then crea una clusula condicional que hace que la ejecucin del script siga
diferentes caminos dependiendo de una o varias condiciones lgicas fijadas.

Vea tambin: if (pgina 348) (funcin de script y de grfico)

Sintaxis:

If condition then
[ statements ]
{ elseif condition then
[ statements ] }
[ else
[ statements ] ]
end if

Como la sentencia if..then es una sentencia de control y como tal termina con punto y coma o con un final
de lnea, cada una de sus cuatro posibles clusulas (if..then, elseif..then, else y end if) no debe sobrepasar
el lmite de una lnea.

Argumentos:

Argumento Descripcin

condition Es una expresin lgica que puede ser evaluada como True o False.

statements Es cualquier grupo de una o varias sentencias de script de Qlik Sense.

Ejemplo1:

if a=1 then

LOAD * from abc.csv;


SQL SELECT e, f, g from tab1;

end if

Ejemplo2:

if a=1 then; drop table xyz; end if;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 23


2 Sintaxis de script

Ejemplo3:

if x>0 then

LOAD * from pos.csv;

elseif x<0 then

LOAD * from neg.csv;

else

LOAD * from zero.txt;

end if

Sub..end sub
La sentencia de control sub..end sub define una subrutina, la cual puede ser invocada mediante una
sentencia call.

Sintaxis:

Sub name [ ( paramlist )] statements end sub

Los argumentos se copian en la subrutina y, si el correspondientes argumento en la sentencia call es un


nombre de variable, se copia de nuevo al salir de la subrutina.

Si una subrutina contiene ms parmetros formales que parmetros reales aprobados por una sentencia
call, los parmetros extra se inicializarn como NULL pudindose emplear como variables locales dentro de
la subrutina.

Como la sentencia sub es una sentencia de control y como tal termina con punto y coma o con un final de
lnea, cada una de sus dos clusulas posibles (sub y end sub) no debe sobrepasar el lmite de una lnea.

Argumentos:

Argumento Descripcin

name El nombre de la subrutina.

paramlist Una lista separada por comas con los nombres de variables de los parmetros formales de
la subrutina. Estos pueden utilizarse como cualquier variable dentro de la subrutina.

statements Es cualquier grupo de una o varias sentencias de script de Qlik Sense.

Ejemplo1:

Sub INCR (I,J)


I = I + 1
Exit Sub when I < 10
J = J + 1
End Sub
Call INCR (X,Y)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 24


2 Sintaxis de script

Ejemplo2: - transferencia de parmetros

Sub ParTrans (A,B,C)


A=A+1
B=B+1
C=C+1
End Sub
A=1
X=1
C=1
Call ParTrans (A, (X+1)*2)
El resultado de lo anterior ser que localmente, dentro de la subrutina, A se inicializar a 1, B se inicializar a
4 y C se inicializar a NULL.

Al salir de la subrutina, la variable global A obtendr 2 como valor (copiado de la subrutina). El segundo
parmetro real (X+1)*2 no ser copiado puesto que no es una variable. Por ltimo, la variable global C no
se ver afectada por la llamada de la subrutina.

Switch..case..default..end switch
La sentencia de control switch es una construccin de script que obliga a que la ejecucin del script siga
diferentes caminos dependiendo del valor de una expresin.

Sintaxis:

Switch expression {case valuelist [ statements ]} [default statements] end


switch

Como la sentencia switch es una sentencia de control y como tal termina con punto y coma o
con un final de lnea, cada una de sus cuatro posibles clusulas (switch,case, default y end
switch) no debe sobrepasar el lmite de una lnea.

Argumentos:

Argumento Descripcin

expression Es una expresin cualquiera.

valuelist Una lista de valores separados por comas, con los que se compara el valor de expresin.
La ejecucin del script continuar con las sentencias del primer grupo que se haya hallado
que contienen un valor en listavalores igual al valor de expresin. Cada valor de
listavalores puede ser una expresin cualquiera. Si no se encuentra correspondencia
alguna en la clusula case, se ejecutarn las sentencias de la clusula default, si se
especificaron.

statements Es cualquier grupo de una o varias sentencias de script de Qlik Sense.

Ejemplo:

Switch I

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 25


2 Sintaxis de script

Case 1
LOAD '$(I): CASE 1' as case autogenerate 1;
Case 2
LOAD '$(I): CASE 2' as case autogenerate 1;
Default
LOAD '$(I): DEFAULT' as case autogenerate 1;
End Switch

Prefijos de script
La aplicacin de prefijos es posible con sentencias habituales, pero nunca con las sentencias de control. Sin
embargo, los prefijos when y unless s pueden emplearse como sufijos en unas cuantas sentencias de
control especficas.

Todas las palabras clave del script pueden escribirse con cualquier combinacin de maysculas o
minsculas. Los nombres de campo y de variable utilizados en las sentencias, por supuesto, son sensibles a
maysculas.

Descripcin general de los prefijos de script


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Add
El prefijo add puede aadirse a cualquier sentencia LOAD, SELECT o map...using en el script. Slo tiene
sentido durante las recargas parciales.

Add [only] (loadstatement | selectstatement | mapstatement)

Buffer
Los archivos QVD se pueden crear y mantener de forma automtica mediante el prefijo buffer. Este prefijo
puede utilizarse en la mayora de sentencias LOAD y SELECT en el script. Indica que los archivos QVD se
utilizan para enviar a cach el resultado de la sentencia.

Buffer[(option [ , option])] ( loadstatement | selectstatement )


option::= incremental | stale [after] amount [(days | hours)]

Bundle
El prefijo Bundle sirve para incluir archivos externos, por ej. archivos de imagen o sonido, u objetos
conectados a un valor de campo, para que se almacenen en el archivo qvf.

Bundle [Info] ( loadstatement | selectstatement)

Concatenate
Si dos tablas que van a ser concatenadas tienen diferentes conjuntos de campos, se puede obligar a la
concatenacin de ambas mediante el prefijo Concatenate.

Concatenate[ (tablename ) ] ( loadstatement | selectstatement )

Crosstable

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 26


2 Sintaxis de script

El prefijo crosstable sirve para convertir una tabla cruzada en una tabla simple.

Crosstable (attribute field name, data field name [ , n ] ) ( loadstatement


| selectstatement )

First
El prefijo First en una sentencia LOAD o SELECT (SQL) se usa para cargar una nmero mximo fijo de
registros desde una tabla fuente.

First n( loadstatement | selectstatement )

Generic
La apertura y carga de una base de datos genrica puede hacerse mediante el prefijo generic.

Generic ( loadstatement | selectstatement )

Hierarchy
El prefijo hierarchy sirve para transformar una tabla jerrquica en una tabla que sea til en un modelo de
datos de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y utilizar
el resultado de la sentencia de carga como informacin de entrada para una transformacin de tabla.

Hierarchy (NodeID, ParentID, NodeName, [ParentName], [PathSource],


[PathName], [PathDelimiter], [Depth])(loadstatement | selectstatement)

HierarchBelongsTo
Este prefijo se utiliza para transformar una tabla jerrquica en una tabla que sea til en un modelo de datos
de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y almacenar el
resultado de la sentencia de carga como info de entrada para una transformacin de tabla.

HierarchyBelongsTo (NodeID, ParentID, NodeName, AncestorID, AncestorName,


[DepthDiff])(loadstatement | selectstatement)

Image_Size
Esta sentencia se emplea junto al prefijo Info para redimensionar imgenes desde un sistema gestor de
bases de datos, de forma que stas encajen en los campos.

Info [Image_Size(width,height )] ( loadstatement | selectstatement )

Info
El prefijo info sirve para enlazar informacin externa, como un archivo de texto, una imagen o un vdeo, con
un valor de campo.

Info( loadstatement | selectstatement )

Inner
Los prefijos join y keep pueden ir precedidos por el prefijo inner.Si se coloca antes de join especifica que
debe usarse una unin interna (inner join). La tabla resultante contendr por tanto combinaciones de valores
de campo de las dos tablas originales donde los valores de campos de enlace se representan en ambas

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 27


2 Sintaxis de script

tablas. Si se coloca antes de keep, especifica que ambas tablas de datos sin procesar debern ser reducidas
a su interseccin comn antes de ser almacenadas en Qlik Sense. .

Inner ( Join | Keep) [ (tablename) ](loadstatement |selectstatement )

IntervalMatch
El prefijo ampliado IntervalMatch se utiliza para crear una tabla que hace correspondencias de valores
numricos discretos a uno o ms intervalos numricos, y al mismo tiempo enlaza los valores de una o ms
claves adicionales.

IntervalMatch (matchfield)(loadstatement | selectstatement )


IntervalMatch (matchfield,keyfield1 [ , keyfield2, ... keyfield5 ] )
(loadstatement | selectstatement )

Join
El prefijo join une la tabla cargada con una tabla ya existente o con la ltima tabla de datos creada.

[Inner | Outer | Left | Right ] Join [ (tablename ) ]( loadstatement |


selectstatement )

Keep
El prefijo keep es parecido al prefijo join. Al igual que el prefijo join, compara la tabla cargada con una tabla
previamente nombrada o con la ltima tabla de datos creada, pero en lugar de combinar la tabla cargada con
una tabla anterior, tiene el efecto de reducir una o ambas tablas antes de almacenarlas en Qlik Sense, segn
sea la interseccin de los datos de las tablas. La comparacin final equivale a aplicar un join natural entre
todos los campos comunes. La diferencia est en que las dos tablas no se unen, sino que se almacenan en
Qlik Sense como dos tablas independientes de distinto nombre.

(Inner | Left | Right) Keep [(tablename ) ]( loadstatement |


selectstatement )

Left
Los prefijos Join y Keep pueden ir precedidos por el prefijo left.

Si se usa antes de join especifica que se debe usar un left join. La tabla resultante slo contendr
combinaciones de valores de campo de las tablas iniciales donde los valores de campos de enlace se
representan en la primera tabla. Si se usa antes de keep, especifica que la segunda tabla de datos sin
procesar debe ser reducida a su interseccin comn con la primera tabla antes de almacenarse en Qlik
Sense.

Left ( Join | Keep) [ (tablename) ](loadstatement |selectstatement )

Mapping
El prefijo mapping sirve para crear una tabla de correspondencias o enlaces, la cual puede utilizarse para,
por ejemplo, reemplazar valores de campo y nombres de campos durante la ejecucin de script.

Mapping ( loadstatement | selectstatement )

NoConcatenate

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 28


2 Sintaxis de script

El prefijo NoConcatenate obliga a tratar dos tablas cargadas con idnticos conjuntos de campos como si
fueran dos tablas internas aparte, porque de otra forma se concatenaran de forma automtica.

NoConcatenate( loadstatement | selectstatement )

Outer
El prefijo explcito Join puede ir precedido por el prefijo outer para especificar un outer join. En un outer join
se generan todas las combinaciones entre las dos tablas. La tabla resultante contendr por tanto
combinaciones de valores de campo de las dos tablas donde los valores de campos de enlace se representan
en una o ambas tablas. La palabra clave outer es opcional.

Outer Join [ (tablename) ](loadstatement |selectstatement )

Replace
El prefijo replace sirve para desechar la tabla completa de Qlik Sense y reemplazarla por una tabla nueva
que se haya cargado o seleccionado.

Replace[only](loadstatement |selectstatement |map...usingstatement)

Right
Los prefijos Join y Keep pueden ir precedidos por el prefijo right.

Si se usa antes de join especifica que se debe usar un enlace derecho (right join). La tabla resultante
contendr slo combinaciones de valores de campo de las dos tablas donde los valores de campos de enlace
se representan en la segunda tabla. Si se usa antes de keep, especifica que la primera tabla de datos pura
debe ser reducida a su interseccin comn con la segunda tabla antes de ser almacenada en Qlik Sense.

Right (Join | Keep) [(tablename)](loadstatement |selectstatement )

Sample
El prefijo sample en una sentencia LOAD o SELECT se usa para cargar una muestra aleatoria de registros
desde la tabla fuente.

Sample p ( loadstatement | selectstatement )

Semantic
Las tablas que contienen relaciones entre registros pueden cargarse mediante el prefijo semantic. Pueden
ser por ejemplo referencias dentro de una tabla, donde un registro apunte a otro, como por ej. a un
predecesor o antepasado.

Semantic ( loadstatement | selectstatement)

Unless
El prefijo y sufijo unless sirven para crear una clusula condicional, la cual determina si una sentencia o
clusula exit debera ser evaluada o no. Puede verse como una excelente alternativa a la sentencia completa
if..end if.

(Unless condition statement | exitstatement Unless condition )

When

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 29


2 Sintaxis de script

El prefijo y sufijo when sirven para crear una clusula condicional que determina si una sentencia o clusula
exit debera ejecutarse o no. Puede verse como una excelente alternativa a la sentencia completa if..end if.

( When condition statement | exitstatement when condition )

Add
El prefijo add puede aadirse a cualquier sentencia LOAD, SELECT o map...using en el script. Slo tiene
sentido durante las recargas parciales.

Sintaxis:

Add [only] (loadstatement | selectstatement | mapstatement)

Durante una recarga parcial, la tabla Qlik Sense, para la que se genera un nombre de tabla mediante la
sentencia add LOAD/add SELECT (siempre y cuando dicha tabla exista), se anexar con el resultado de
una sentencia add LOAD/add SELECT. No comprueba duplicados. Por lo tanto, una sentencia que use el
prefijo add, normalmente incluir o bien un cualificador distinct o una clusula where que har que los
duplicados se guarden. La sentencia map...using hace que la correspondencia se produzca tambin
durante la ejecucin parcial de script.

Argumentos:

Argumento Descripcin

only Es un cualificador opcional que indica que la sentencia debe ser ignorada durante
recargas normales (no parciales).

Ejemplos y resultados:

Ejemplo Resultado
Tab1: Durante una recarga normal, los datos se cargan desde Persons.csv y se
LOAD Name, Number FROM
almacenan en la tabla Tab1 de Qlik Sense. Los datos de NewPersons.csv se
Persons.csv;
Add LOAD Name, Number concatenan a la misma tabla de Qlik Sense.
FROM newPersons.csv;
Durante una recarga parcial, los datos se cargan desde NewPersons.csv y se
anexan a la tabla Tab1 de Qlik Sense. No se hace comprobacin de
duplicados.
Tab1: El control de duplicados se hace buscando Name en la tabla de datos
SQL SELECT Name,
previamente cargada (vase la funcin exists en Funciones inter-registro).
Number FROM
Persons.csv;
Durante una recarga normal, los datos se cargan desde Persons.csv y se
Add LOAD Name, Number
FROM NewPersons.csv almacenan en la tabla Tab1 de Qlik Sense. Los datos de NewPersons.csv se
where not exists concatenan a la misma tabla de Qlik Sense.
(Name);
Durante una recarga parcial, los datos se cargan desde NewPersons.csv, que

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 30


2 Sintaxis de script

Ejemplo Resultado

est anexado a la tabla Tab1 de Qlik Sense. Se hace una comprobacin de


duplicados con el fin de ver si Name existe en la tabla anteriormente cargada.
Tab1: Durante una recarga normal, los datos se cargan desde Persons.csv y se
LOAD Name, Number FROM
almacenan en la tabla Tab1 de Qlik Sense. No se considera la sentencia de
Persons.csv;
Add Only LOAD Name, carga NewPersons.csv.
Number FROM
NewPersons.csv where Durante una recarga parcial, los datos se cargan desde NewPersons.csv, que
not exists(Name); est anexado a la tabla Tab1 de Qlik Sense. Se hace una comprobacin de
duplicados con el fin de ver si Name existe en la tabla anteriormente cargada.

Buffer
Los archivos QVD se pueden crear y mantener de forma automtica mediante el prefijo buffer. Este prefijo
puede utilizarse en la mayora de sentencias LOAD y SELECT en el script. Indica que los archivos QVD se
utilizan para enviar a cach el resultado de la sentencia.

Sintaxis:

Buffer [(option [ , option])] ( loadstatement | selectstatement )


option::= incremental | stale [after] amount [(days | hours)]

Si no se utiliza ninguna opcin, el buffer QVD creado por la primera ejecucin del script se usar
indefinidamente.

Los buffers QVD por lo general son eliminados cuando ya no se les hace referencia alguna a lo largo de una
ejecucin completa de script en el documento que los cre, o cuando el documento que los cre ya no existe.

Argumentos:

Argumento Descripcin

incremental La opcin incremental activa la capacidad de leer solo parte de un archivo subyacente. El
tamao previo del archivo se almacena en la cabecera XML del archivo QVD. Esto resulta
de especial utilidad con archivos de registro. Todos los registros previamente cargados
son ledos desde el archivo QVD, mientras que los nuevos registros subsiguientes son
ledos de la fuente original y al final se crea un archivo QVD actualizado. Tenga en cuenta
que la opcin incremental solo puede utilizarse con sentencias LOAD de carga y archivos
de texto y que no puede emplearse para carga incremental cuando los datos antiguos
hayan sido modificados o borrados.

stale [after] amount es un nmero que especifica un periodo de tiempo. Se pueden emplear
amount decimales. Si se omite la unidad se interpreta como days.
[(days | La opcin de stale after se utiliza normalmente con fuentes de Bases de Datos que
hours)] carecen de una simple marca de tiempo en los datos originales. Entonces, en su lugar, se
especifica una caducidad para la utilizacin de la captura QVD, un tiempo lmite para

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 31


2 Sintaxis de script

Argumento Descripcin

poder utilizarla. Una clusula de stale after lo que hace es establecer un perodo de
tiempo (de caducidad), desde el momento de la creacin del buffer QVD; tras dicho
perodo este buffer ya no se considerar vlido. Primero se emplear el buffer QVD como
fuente de datos y transcurrido dicho perodo se utilizar la fuente de datos original. Luego
se actualizar el archivo buffer QVD automticamente y comenzar un nuevo perodo.

Limitaciones:

Existen ciertas limitaciones, siendo la ms destacada que debe haber o bien una sentencia LOAD o una
SELECT en la parte central de cualquier sentencia compleja.

Ejemplo1:

Buffer SELECT * from MyTable;

Ejemplo2:

Buffer (stale after 7 days) SELECT * from MyTable;

Ejemplo3:

Buffer (incremental) LOAD * from MyLog.log;

Bundle
El prefijo Bundle sirve para incluir archivos externos, por ej. archivos de imagen o sonido, u objetos
conectados a un valor de campo, para que se almacenen en el archivo qvf.

Sintaxis:

Bundle [Info] ( loadstatement | selectstatement)

Para mantener la portabilidad, puede que desee incluir algunos archivos externos en el archivo mismo .qvf.
Para este fin, podemos utilizar el prefijo Bundle. Los archivos con info bundle sern comprimidos durante el
proceso, pero aun as ocuparn un espacio adicional en el archivo y en la RAM. Por lo tanto, tenga en cuenta
el tamao y el nmero de archivos que desee incluir antes de optar por esta solucin.

El prefijo info puede referenciarse desde el diseo como una informacin normal, mediante la funcin info de
grficos, o como un archivo interno mediante la sintaxis especial qmem:// fieldname / fieldvalue o tambin
qmem:// fieldname / < index > donde index es el ndice interno de un valor de campo.

Argumentos:

Argumento Descripcin

Info Si una parte de informacin externa como, por ejemplo, una imagen o un archivo de

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 32


2 Sintaxis de script

Argumento Descripcin

sonido, se va a conectar a un valor de un campo, esto se hace en una tabla cargada


mediante el prefijo Info.
El prefijo Info puede omitirse cuando se emplee Bundle.

Ejemplo:

Bundle Info LOAD * From flagoecd.csv;


Bundle SQL SELECT * from infotable;

Concatenate
Si dos tablas que van a ser concatenadas tienen diferentes conjuntos de campos, se puede obligar a la
concatenacin de ambas mediante el prefijo Concatenate. Esta sentencia fuerza la concatenacin con una
tabla designada que ya existe, o con la ltima tabla lgica previamente creada.

Sintaxis:

Concatenate[ (tablename ) ] ( loadstatement | selectstatement )

Una concatenacin es en principio lo mismo que una sentencia SQL UNION, pero con dos diferencias:

l El prefijo Concatenate puede utilizarse independientemente de que las tablas tengan nombres de
campo idnticos o no.
l Los registros idnticos no se eliminan mediante el prefijo Concatenate.

Argumentos:

Argumento Descripcin

tablename El nombre de la tabla existente.

Ejemplo:

Concatenate LOAD * From file2.csv;


Concatenate SELECT * From table3;
tab1:
LOAD * From file1.csv;
tab2:
LOAD * From file2.csv;
.. .. ..
Concatenate (tab1) LOAD * From file3.csv;

Crosstable
El prefijo crosstable sirve para convertir una tabla cruzada en una tabla simple.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 33


2 Sintaxis de script

crosstable (attribute field name, data field name [ , n ] ) ( loadstatement


| selectstatement )

Argumentos:

Argumento Descripcin

attribute El campo que contiene los valores de atributos.


field name

data field El campo que contiene los valores de datos.


name

n Es el nmero de campos cualificadores que preceden a la tabla que se va a transformar a


una forma genrica. Por defecto es 1.

Una crosstable es un tipo habitual de tabla, que ofrece una matriz de valores entre dos o ms listas
ortogonales de datos de cabecera, de las que una es utilizada como cabeceras de columna. Un ejemplo
tpico sera el de una columna por mes. El resultado del prefijo crosstable es que las cabeceras de columna
(por ej. los nombres de meses) se almacenarn en un campo, el campo de atributo, y los datos de columna
(los nmeros de mes) se almacenarn en un segundo campo: el campo de datos.

Ejemplos:

Crosstable (Month, Sales) LOAD * from ex1.csv;


Crosstable (Month,Sales,2) LOAD * from ex2.csv;
Crosstable (A,B) SELECT * from table3;

First
El prefijo First en una sentencia LOAD o SELECT (SQL) se usa para cargar una nmero mximo fijo de
registros desde una tabla fuente.

Sintaxis:

First n ( loadstatement | selectstatement )

Argumentos:

Argumento Descripcin

n Es una expresin arbitraria que devuelve un entero indicando el nmero mximo de


registros que se ha de leer.

n puede ir entre parntesis, como (n), pero no es obligatorio.

Ejemplos:

First 10 LOAD * from abc.csv;


First (1) SQL SELECT * from Orders;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 34


2 Sintaxis de script

Generic
La apertura y carga de una base de datos genrica puede hacerse mediante el prefijo generic.

Sintaxis:

Generic( loadstatement | selectstatement )

Las tablas cargadas a travs de una sentencia generic no se auto-concatenan.

Ejemplos:

Generic LOAD * from abc.csv;


Generic SQL SELECT * from table1;

Hierarchy
El prefijo hierarchy sirve para transformar una tabla jerrquica en una tabla que sea til en un modelo de
datos de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y utilizar
el resultado de la sentencia de carga como informacin de entrada para una transformacin de tabla.

Sintaxis:

Hierarchy (NodeID, ParentID, NodeName, [ParentName], [PathSource],


[PathName], [PathDelimiter], [Depth])(loadstatement | selectstatement)

La tabla de entrada debe ser una tabla de nodos adyacentes. Las tablas de nodos adyacentes son tablas en
las que cada registro se corresponde con un nodo y tiene un campo que contiene una referencia al nodo
padre. En este tipo de tabla, el nodo se almacena en un nico registro, pero puede tener un determinado
nmero de hijos. La tabla puede por supuesto contener campos adicionales que describan atributos para los
nodos.

El prefijo crea una tabla de nodos expandidos, la cual contiene normalmente el mismo nmero de registros
que una tabla de entrada, pero adems, cada nivel de la jerarqua se almacena en un campo aparte. El
campo path puede utilizarse en una estructura arbrea.

Normalmente, la tabla de entrada tiene exactamente un registro por nodo y en dicho caso la tabla resultante
contendr el mismo nmero de registros. No obstante, a veces hay nodos con mltiples padres, esto es, un
nodo viene representado por varios registros en la tabla de entrada. Si ste es el caso, la tabla resultante
podr contener un nmero mayor de registros que la tabla de entrada.

Todos los nodos con un id paterno que no se encuentre en la columna nodeid (incluidos aquellos nodos que
hayan perdido su id de padre) se considerarn como races. Asimismo, nicamente se cargarn los nodos
que posean una conexin a un nodo raz directa o indirecta evitndose con esto las referencias circulares.

Los campos adicionales que contengan el nombre del nodo padre, la ruta del nodo y la profundidad del nodo
se podrn crear sin problema.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 35


2 Sintaxis de script

Argumento Descripcin

NodeID NodeID es el nombre del campo que contiene el ID de nodo. Este campo debe existir en
la tabla de entrada.

ParentID ParentID es el nombre del campo que contiene el ID de nodo del nodo padre. Este
campo debe existir en la tabla de entrada.

NodeName NodeName es el nombre del campo que contiene el nombre del nodo. Este campo debe
existir en la tabla de entrada.

ParentName Es una cadena que se utiliza para nombrar el nuevo campo ParentName. Si se omite,
dicho campo no se crear.

ParentSource Es el nombre del campo que contiene el nombre del nodo empleado para crear la ruta al
nodo. Se trata de un parmetro opcional. Si se omite, se utilizar NodeName.

PathName Es una cadena que se utiliza para nombrar el nuevo campo Path, el cual contiene la ruta
de la raz al nodo. Se trata de un parmetro opcional. Si se omite, dicho campo no se
crear.

PathDelimiter La cadena empleada como delimitador en el nuevo campo Path. Se trata de un


parmetro opcional. Si se omite, se utilizar "/".

Depth La cadena empleada para nombrar al nuevo campo Depth, que contiene la profundidad
del nodo en la jerarqua. Se trata de un parmetro opcional. Si se omite, dicho campo no
se crear.

Ejemplo:

Hierarchy(NodeID, ParentID, NodeName) LOAD


NodeID,
ParentID,
NodeName,
Attribute
From data.xls (biff, embedded labels, table is [Sheet1$];

HierarchyBelongsTo
Este prefijo se utiliza para transformar una tabla jerrquica en una tabla que sea til en un modelo de datos
de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y almacenar el
resultado de la sentencia de carga como info de entrada para una transformacin de tabla.

Sintaxis:

HierarchyBelongsTo (NodeID, ParentID, NodeName, AncestorID, AncestorName,


[DepthDiff])(loadstatement | selectstatement)

La tabla de entrada debe ser una tabla de nodos adyacentes. Las tablas de nodos adyacentes son tablas en
las que cada registro se corresponde con un nodo y tiene un campo que contiene una referencia al nodo

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 36


2 Sintaxis de script

padre. En este tipo de tabla, el nodo se almacena en un nico registro, pero puede tener un determinado
nmero de hijos. La tabla puede por supuesto contener campos adicionales que describan atributos para los
nodos.

El prefijo crea una tabla que contiene todas las relaciones hijo-antepasado de la jerarqua. Los campos de
antepasados pueden de esta forma utilizarse para seleccionar rboles enteros en la jerarqua. La tabla
resultante contiene normalmente varios registros por nodo.

Se puede crear un campo adicional que contenga la diferencia de profundidad entre los nodos.

Argumentos:

Argumento Descripcin

NodeID NodeID es el nombre del campo que contiene el ID de nodo. Este campo debe existir en
la tabla de entrada.

ParentID ParentID es el nombre del campo que contiene el ID de nodo del nodo padre. Este
campo debe existir en la tabla de entrada.

NodeName NodeName es el nombre del campo que contiene el nombre del nodo. Este campo debe
existir en la tabla de entrada.

AncestorID Es una cadena que se emplea para nombrar el nuevo campo de ID del antepasado, el
cual contiene el ID del nodo antepasado.

AncestorName Es una cadena que se emplea para nombrar el nuevo campo del antepasado, el cual
contiene el nombre del nodo antepasado.

DepthDiff Es una cadena que se emplea para nombrar el nuevo campo DepthDiff, el cual
contiene la profundidad del nodo en la jerarqua, en relacin al nodo antepasado. Se
trata de un parmetro opcional. Si se omite, dicho campo no se crear.

Ejemplo:

HierarchyBelongsTo (NodeID, ParentID, Node, Tree, ParentName) LOAD


NodeID,
ParentID,
NodeName
From data.xls (biff, embedded labels, table is [Sheet1$];

Image_Size
Esta sentencia se emplea junto al prefijo Info para redimensionar imgenes desde un sistema gestor de
bases de datos, de forma que stas encajen en los campos.

Sintaxis:

Info [Image_Size(width,height )] ( loadstatement | selectstatement )

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 37


2 Sintaxis de script

Argumento Descripcin

width El ancho de la imagen especificado en pxeles.

height La altura de la imagen especificada en pxeles.

Ejemplo:

Info Image_Size(122,122) SQL SELECT ID, Photo From infotable;

Info
El prefijo info sirve para enlazar informacin externa, como un archivo de texto, una imagen o un vdeo, con
un valor de campo.

Sintaxis:

Info( loadstatement | selectstatement )

Si parte de una informacin externa, como por ej. un archivo de texto, una imagen o un vdeo, se va a
enlazar a un valor de campo, esto se hace en una tabla que se carga mediante el prefijo info. (En algunos
casos ser preferible a almacenar la informacin dentro del archivo qvf, empleando el prefijo bundle. La
tabla deber contener dos columnas nicamente, la primera con los valores de campo que constituirn las
claves hacia la informacin, la segunda con los elementos de informacin, es decir, los nombres de archivo
de las imgenes, etc.

Lo mismo se aplica a, por ejemplo, una imagen procedente de un sistema gestor de bases de datos. En un
campo binario, un objeto blob, la sentencia info select realiza un bundle implcito, es decir, que los datos
binarios sern tomados de inmediato y almacenados en el qvf. Los datos binarios deben ser el segundo
campo en una sentencia SELECT.

Si una imagen necesita redimensionarse, se puede utilizar la clusula image_size.

Ejemplo:

Info LOAD * from flagoecd.csv;


Info SQL SELECT * from infotable;
Info SQL SELECT Key, Picture From infotable;

Inner
Los prefijos join y keep pueden ir precedidos por el prefijo inner.Si se coloca antes de join especifica que
debe usarse una unin interna (inner join). La tabla resultante contendr por tanto combinaciones de valores
de campo de las dos tablas originales donde los valores de campos de enlace se representan en ambas
tablas. Si se coloca antes de keep, especifica que ambas tablas de datos sin procesar debern ser reducidas
a su interseccin comn antes de ser almacenadas en Qlik Sense.

Sintaxis:

Inner ( Join | Keep) [ (tablename) ](loadstatement |selectstatement )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 38


2 Sintaxis de script

Argumentos:

Argumento Descripcin

tablename Tabla designada que debe compararse con la tabla cargada.

loadstatement o selectstatement La sentencia LOAD o SELECT para la tabla cargada.

Ejemplo1:

Table1

A B
1 aa
2 cc
3 ee

Table2

A C
1 xx
4 yy

QVTable:
SQL SELECT * From table1;
inner join SQL SELECT * From table2;

QVTable

A B C

1 aa xx

Ejemplo2:

QVTab1:
SQL SELECT * From Table1;
QVTab2:
inner keep SQL SELECT * From Table2;

QVTab1

A B

1 aa

QVTab2

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 39


2 Sintaxis de script

A C

1 xx

Las dos tablas del ejemplo keep estn, por supuesto, asociadas mediante el campo A.

IntervalMatch
El prefijo ampliado IntervalMatch se utiliza para crear una tabla que hace correspondencias de valores
numricos discretos a uno o ms intervalos numricos, y al mismo tiempo enlaza los valores de una o ms
claves adicionales.

Sintaxis:

IntervalMatch (matchfield)(loadstatement | selectstatement )


IntervalMatch (matchfield,keyfield1 [ , keyfield2, ... keyfield5 ] )
(loadstatement | selectstatement )

El prefijo IntervalMatch debe colocarse antes de una sentencia LOAD o SELECT que carga los intervalos.
El campo que contiene los puntos de datos discretos (Hora en el ejemplo de ms abajo) y las claves
adicionales deben haberse cargado ya en Qlik Sense antes de la sentencia con el prefijo IntervalMatch. El
prefijo no lee por s mismo este campo desde la tabla de la base de datos. El prefijo transforma la tabla
cargada de intervalos y claves en una tabla que contiene una columna adicional: los puntos de datos
numricos discretos. Tambin ampla el nmero de registros de forma que la nueva tabla contiene un
registro por combinacin posible de puntos de datos discretos, intervalo y valor del campo(s) clave.

Los intervalos pueden solaparse y los valores discretos se enlazarn con todos los intervalos coincidentes.

Para evitar que los lmites de intervalo indefinidos se descarten, es necesario permitir a los valores NULL
hacer corresponder los campos que constituyen los lmites superior o inferior del intervalo. Esto se hace
mediante la sentencia NullAsValue o mediante un test explcito que reemplaza los valores NULL por un
valor numrico antes o despus de cualquiera de los puntos de datos numricos discretos.

Argumentos:

Argumento Descripcin

matchfield Es el campo que contiene los valores numricos discretos que se van a enlazar con los
intervalos.

keyfield(s) Son campos que contienen los atributos adicionales que se van a comparar en la
transformacin.

loadstatement Debe dar como resultado una tabla, en la que el primer campo contenga el lmite
or inferior de cada intervalo, el segundo campo contiene el lmite superior de cada
selectstatement intervalo, y en caso de usar comparacin de claves, el tercer campo y subsiguientes
contienen el/los campos clave presentes en la sentencia IntervalMatch. Los intervalos
estn siempre cerrados, es decir, los puntos finales estn incluidos en el intervalo. En
caso de tener lmites no numricos, no se considera el intervalo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 40


2 Sintaxis de script

Ejemplo1:

En las dos tablas a continuacin, la primera indica las horas de inicio y finalizacin de distintos pedidos. La
segunda indica un nmero de eventos. Mediante el prefijo IntervalMatch podemos conectar lgicamente las
dos tablas para averiguar por ej. qu pedidos han resultado afectados por alteraciones y qu pedidos han
sido procesados en qu turnos.

OrderLog
Start End Order

01:00 03:35 A

02:30 07:58 B

03:04 10:27 C

07:23 11:43 D

EventLog
Time Event Comment

00:00 0 Start of shift 1

01:18 1 Line stop

02:23 2 Line restart 50%

04:15 3 Line speed 100%

08:00 4 Start of shift 2

11:43 5 End of production

Primero hay que cargar las dos tablas como de costumbre, y despus vincular el campo Time a los intervalos
de tiempo definidos por los campos Start y End:

SELECT * from OrderLog;


SELECT * from Eventlog;
IntervalMatch ( Time ) SELECT Start, End from OrderLog;

Ahora ya se puede crear el siguiente cuadro de tabla en Qlik Sense:

Tablebox
Time Event Comment Order Start End
00:00 0 Start of shift 1 - - -
01:18 1 Line stop A 01:00 03:35
02:23 2 Line restart 50% A 01:00 03:35

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 41


2 Sintaxis de script

04:15 3 Line speed 100% B 02:30 07:58


04:15 3 Line speed 100% C 03:04 10:27
08:00 4 Start of shift 2 C 03:04 10:27
08:00 4 Start of shift 2 D 07:23 11:43
11:43 5 End of production D 07:23 11:43

Ejemplo2: (usando el campo clave)

Inner Join IntervalMatch (Date,Key) LOAD FirstDate, LastDate, Key resident Key;

Join
El prefijo join une la tabla cargada con una tabla ya existente o con la ltima tabla de datos creada.

Sintaxis:

[inner | outer | left | right ]Join [ (tablename ) ]( loadstatement |


selectstatement )

El join es una unin natural que se realiza sobre todos los campos comunes. La sentencia join debe ir
siempre precedida de uno de los prefijos inner, outer, left o right.

Argumentos:

Argumento Descripcin

tablename Tabla designada que debe compararse con la tabla cargada.

loadstatement o selectstatement La sentencia LOAD o SELECT para la tabla cargada.

Ejemplo:

Join LOAD * from abc.csv;

Join SELECT * from table1;

tab1:
LOAD * from file1.csv;
tab2:
LOAD * from file2.csv;
.. .. ..
join (tab1) LOAD * from file3.csv;

Keep
El prefijo keep es parecido al prefijo join. Al igual que el prefijo join, compara la tabla cargada con una tabla
previamente nombrada o con la ltima tabla de datos creada, pero en lugar de combinar la tabla cargada con
una tabla anterior, tiene el efecto de reducir una o ambas tablas antes de almacenarlas en Qlik Sense, segn

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 42


2 Sintaxis de script

sea la interseccin de los datos de las tablas. La comparacin final equivale a aplicar un join natural entre
todos los campos comunes. La diferencia est en que las dos tablas no se unen, sino que se almacenan en
Qlik Sense como dos tablas independientes de distinto nombre.

Sintaxis:

(inner | left | right) keep [(tablename ) ]( loadstatement |


selectstatement )

El prefijo keep debe ir siempre precedido por uno de los prefijos inner, left o right.

El prefijo explcito join en el lenguaje de script de Qlik Sense ejecuta un full join de las dos tablas. El
resultado es una sola tabla. En muchos casos los joins dan como resultado unas tablas muy grandes. Una de
las principales caractersticas de Qlik Sense es su capacidad de hacer asociaciones entre mltiples tablas en
lugar de unirlas (mediante join). Esto permite ahorrar mucho espacio en la memoria e incrementar la
velocidad de procesamiento, lo que se traduce en una flexibilidad enorme. Los joins explcitos deben evitarse
por lo general en los scripts de Qlik Sense. La funcionalidad keep se ha diseado para reducir el nmero de
casos en los que se tengan que usar joins explcitos.

Argumentos:

Argumento Descripcin

tablename Tabla designada que debe compararse con la tabla cargada.

loadstatement o selectstatement La sentencia LOAD o SELECT para la tabla cargada.

Ejemplo:

Inner Keep LOAD * from abc.csv;


Left Keep SELECT * from table1;
tab1:
LOAD * from file1.csv;
tab2:
LOAD * from file2.csv;
.. .. ..
Left Keep (tab1) LOAD * from file3.csv;

Left
Los prefijos Join y Keep pueden ir precedidos por el prefijo left.

Si se usa antes de join especifica que se debe usar un left join. La tabla resultante slo contendr
combinaciones de valores de campo de las tablas iniciales donde los valores de campos de enlace se
representan en la primera tabla. Si se usa antes de keep, especifica que la segunda tabla de datos sin
procesar debe ser reducida a su interseccin comn con la primera tabla antes de almacenarse en Qlik
Sense.

Sintaxis:

Left ( Join | Keep) [ (tablename) ](loadstatement | selectstatement)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 43


2 Sintaxis de script

Argumentos:

Argumento Descripcin

tablename Tabla designada que debe compararse con la tabla cargada.

loadstatement o selectstatement La sentencia LOAD o SELECT para la tabla cargada.

Ejemplo:

Table1

A B

1 aa

2 cc

3 ee

Table2

A C

1 xx

4 yy

QVTable:
SELECT * From table1;
Left Join Sselect * From table2;

QVTable

A B C

1 aa xx

2 cc

3 ee

QVTab1:
SELECT * From Table1;
QVTab2:
Left Keep SELECT * From Table2;

QVTab1

A B

1 aa

2 cc

3 ee

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 44


2 Sintaxis de script

QVTab2

A C

1 xx

Las dos tablas del ejemplo keep estn, por supuesto, asociadas mediante el campo A.

tab1:
LOAD * From file1.csv;
tab2:
LOAD * From file2.csv;
.. .. ..
Left Keep (tab1) LOAD * From file3.csv;

Mapping
El prefijo mapping sirve para crear una tabla de correspondencias o enlaces, la cual puede utilizarse para,
por ejemplo, reemplazar valores de campo y nombres de campos durante la ejecucin de script.

Sintaxis:

Mapping( loadstatement | selectstatement )

El prefijo mapping puede colocarse antes de una sentencia LOAD o SELECT y almacenar el resultado de
la sentencia de carga como una tabla de correspondencia. Una tabla de enlace se compone de dos
columnas, la primera contiene los valores de comparacin y la segunda contiene los valores de
correspondencia deseados. Las tablas de correspondencia se almacenan temporalmente en la memoria y se
eliminan automticamente tras la ejecucin de script.

Se puede acceder al contenido de la tabla de correspondencia utilizando, por ejemplo, la sentencia Map
Using, la sentencia Rename Field, la funcin Applymap() o la funcin Mapsubstring().

Ejemplo:

Mapping LOAD * from x.csv


Mapping SQL SELECT a, b from map1
map1:
mapping LOAD * inline [
x,y
US,USA
U.S.,USA
America,USA ];

NoConcatenate
El prefijo NoConcatenate obliga a tratar dos tablas cargadas con idnticos conjuntos de campos como si
fueran dos tablas internas aparte, porque de otra forma se concatenaran de forma automtica.

Sintaxis:

NoConcatenate( loadstatement | selectstatement )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 45


2 Sintaxis de script

Ejemplo:

LOAD A,B from file1.csv;


NoConcatenate LOAD A,B from file2.csv;

Outer
El prefijo explcito Join puede ir precedido por el prefijo outer para especificar un outer join. En un outer join
se generan todas las combinaciones entre las dos tablas. La tabla resultante contendr por tanto
combinaciones de valores de campo de las dos tablas donde los valores de campos de enlace se representan
en una o ambas tablas. La palabra clave outer es opcional.

Sintaxis:

Outer Join [ (tablename) ](loadstatement |selectstatement )

Argumentos:

Argumento Descripcin

tablename Tabla designada que debe compararse con la tabla cargada.

loadstatement o selectstatement La sentencia LOAD o SELECT para la tabla cargada.

Ejemplo:

Table1

A B

1 aa

2 cc

3 ee

Table2

A C

1 xx

4 yy

SQL SELECT * from table1;


join SQL SELECT * from table2;
OR

SQL SELECT * from table1;


outer join SQL SELECT * from table2;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 46


2 Sintaxis de script

Joined table

A B C

1 aa xx

2 cc -

3 ee -

4 - yy

Replace
El prefijo replace sirve para desechar la tabla completa de Qlik Sense y reemplazarla por una tabla nueva
que se haya cargado o seleccionado.

Sintaxis:

Replace [only](loadstatement |selectstatement |map...usingstatement)

El prefijo replace puede aadirse a cualquier sentencia LOAD, SELECT o map...using en el script. La
sentencia replace LOAD/ replace SELECT tiene el efecto de borrar toda la tabla de Qlik Sense (para la
que se genera un nombre de tabla mediante la sentencia replace LOAD/ replace SELECT) y sustituirla por
una tabla nueva que contiene el resultado de la sentencia replace LOAD/ replace SELECT. El efecto es el
mismo durante recargas parciales y completas. La sentencia replace map...using hace que la
correspondencia se produzca tambin durante la ejecucin parcial de script.

Argumentos:

Argumento Descripcin

only Es un cualificador opcional que indica que la sentencia debe ser ignorada durante recargas
normales (no parciales).

Ejemplos y resultados:

Ejemplo Resultado
Tab1: Durante la recarga normal y parcial, la tabla Tab1 de Qlik Sense se borra inicialmente.
Replace LOAD
Despus, los nuevos datos se cargan desde File1.csv y se almacenan en Tab1.
* from
File1.csv;

Tab1: Durante una recarga normal, esta sentencia se ignora.


Replace only
LOAD * from Durante la recarga parcial, cualquier tabla de Qlik Sense que antes se llamara Tab1 se
File1.csv;
borra inicialmente. Despus, los nuevos datos se cargan desde File1.csv y se almacenan
en Tab1.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 47


2 Sintaxis de script

Ejemplo Resultado
Tab1: Durante una recarga normal, el archivo File1.csv se lee primero en la tabla Tab1 de Qlik
LOAD a,b,c
Sense, pero luego se borrar de inmediato y se sustituir por los datos nuevos cargados
from
File1.csv;
desde File2.csv. Todos los datos desde File1.csv se pierden.
Replace LOAD
a,b,c from
Durante una recarga parcial, se borra inicialmente toda la tabla Tab1 de Qlik Sense.
File2.csv; Luego es reemplazada por nuevos datos cargados desde File2.csv.

Tab1: Durante una recarga normal, los datos se cargan desde File1.csv y se almacenan en la
LOAD a,b,c
tabla Tab1 de Qlik Sense. File2.csv es descartado.
from
File1.csv;
Durante una recarga parcial, se borra inicialmente toda la tabla Tab1 de Qlik Sense.
Replace only
LOAD a,b,c
Luego es reemplazada por nuevos datos cargados desde File2.csv. Todos los datos
from desde File1.csv se pierden.
File2.csv;

Right
Los prefijos Join y Keep pueden ir precedidos por el prefijo right.

Si se usa antes de join especifica que se debe usar un enlace derecho (right join). La tabla resultante
contendr slo combinaciones de valores de campo de las dos tablas donde los valores de campos de enlace
se representan en la segunda tabla. Si se usa antes de keep, especifica que la primera tabla de datos pura
debe ser reducida a su interseccin comn con la segunda tabla antes de ser almacenada en Qlik Sense.

Sintaxis:

Right (Join | Keep) [(tablename)](loadstatement |selectstatement )

Argumentos:

Argumento Descripcin

tablename Tabla designada que debe compararse con la tabla cargada.

loadstatement o selectstatement La sentencia LOAD o SELECT para la tabla cargada.

Ejemplos:

Table1

A B

1 aa

2 cc

3 ee

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 48


2 Sintaxis de script

Table2

A C

1 xx

4 yy

QVTable:
SQL SELECT * from table1;
right join SQL SELECT * from table2;

QVTable

A B C

1 aa xx

4 - yy

QVTab1:
SQL SELECT * from Table1;
QVTab2:
right keep SQL SELECT * from Table2;

QVTab1

A B

1 aa

QVTab2

A C

1 xx

4 yy

Las dos tablas del ejemplo keep estn, por supuesto, asociadas mediante el campo A.

tab1:
LOAD * from file1.csv;
tab2:
LOAD * from file2.csv;
.. .. ..
right keep (tab1) LOAD * from file3.csv;

Sample
El prefijo sample en una sentencia LOAD o SELECT se usa para cargar una muestra aleatoria de registros
desde la tabla fuente.

Sintaxis:

Sample p ( loadstatement | selectstatement )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 49


2 Sintaxis de script

Argumentos:

Argumento Descripcin

p Es una expresin aleatoria que devuelve un nmero mayor que 0 y menor o igual a 1. El
nmero indica la probabilidad de que se lea o no un registro de datos

Todos los registros se leern pero solo algunos de ellos sern cargados en Qlik Sense.

Ejemplo:

Sample 0.15 SQL SELECT * from Longtable;


Sample(0.15) LOAD * from Longtab.csv;

Los parntesis estn permitidos, pero no son obligatorios.

Semantic
Las tablas que contienen relaciones entre registros pueden cargarse mediante el prefijo semantic. Pueden
ser por ejemplo referencias dentro de una tabla, donde un registro apunte a otro, como por ej. a un
predecesor o antepasado.

Sintaxis:

Semantic( loadstatement | selectstatement)

La carga mediante semantic crear campos semnticos que pueden mostrarse en paneles de filtrado para
usarlos para navegar en los datos.

No se pueden concatenar tablas que hayan sido cargadas mediante una sentencia semantic.

Ejemplo:

Semantic LOAD * from abc.csv;


Semantic SELECT Object1, Relation, Object2, InverseRelation from table1;

Unless
El prefijo y sufijo unless sirven para crear una clusula condicional, la cual determina si una sentencia o
clusula exit debera ser evaluada o no. Puede verse como una excelente alternativa a la sentencia completa
if..end if.

Sintaxis:

(Unless condition statement | exitstatement Unless condition )

La sentencia statement o exitstatement slo se ejecutar si la condition devuelve False.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 50


2 Sintaxis de script

El prefijo unless se puede usar en sentencias que a su vez ya contienen una o varias sentencias, incluidos
prefijos when o unless adicionales.

Argumentos:

Argumento Descripcin

condition Es una expresin lgica que se evala como True o False.

statement Cualquier sentencia de script de Qlik Sense, excepto las sentencias de


control.

exitstatement Una clusula exit for, exit do o exit sub, o una sentencia exit script.

Ejemplos:

exit script unless A=1;


unless A=1 LOAD * from myfile.csv;
unless A=1 when B=2 drop table Tab1;

When
El prefijo y sufijo when sirven para crear una clusula condicional que determina si una sentencia o clusula
exit debera ejecutarse o no. Puede verse como una excelente alternativa a la sentencia completa if..end if.

Sintaxis:

(when condition statement | exitstatement when condition )

La sentencia o la sentenciaexit solo ser ejecutada si la condicin devuelve True.

El prefijo when se puede usar en sentencias que a su vez ya contienen una o varias sentencias, incluidos
prefijos when o unless adicionales.

Sintaxis:

Argumento Descripcin

condition Es una expresin lgica que se evala como True o False.

statement Cualquier sentencia de script de Qlik Sense, excepto las sentencias de control.

exitstatement Una clusula exit for, exit do o exit sub, o una sentencia exit script.

Ejemplo1:

exit script when A=1;

Ejemplo2:

when A=1 LOAD * from myfile.csv;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 51


2 Sintaxis de script

Ejemplo3:

when A=1 unless B=2 drop table Tab1;

Sentencias habituales de script


Las sentencias ms comunes se utilizan habitualmente para manipular datos de varias formas. Estas
sentencias pueden escribirse sobre cualquier nmero de filas en el script y deben terminar siempre en punto
y coma ";".

Todas las palabras clave del script pueden escribirse con cualquier combinacin de maysculas o
minsculas. Los nombres de campo y de variable utilizados en las sentencias, por supuesto, son sensibles a
maysculas.

Descripcin general de las sentencias habituales de script


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Alias
La sentencia alias se utiliza para establecer un alias segn el cual un campo se renombrar cada vez que
aparezca en el script.

Alias fieldname as aliasname {,fieldname as aliasname}

Binary
La sentencia binary sirve para cargar los datos de otra app de Qlik Sense o de un documento de QlikView
11.2 o anterior, incluidos los datos de secciones de acceso.

Binary file
file ::= [ path ] filename

comment
Ofrece una forma de mostrar los comentarios del campo (metadatos) desde bases de datos y hojas de
clculo. Los nombres de campo que no estn presentes en la app se ignorarn. Si hubiera mltiples nombres
de un mismo campo, se emplear el ltimo valor.

Comment field *fieldlist using mapname


Comment field fieldname with comment

comment table
Ofrece una forma de mostrar los comentarios de una tabla (metadatos) desde bases de datos u hojas de
clculo.

Comment table tablelist using mapname


Comment table tablename with comment

Connect

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 52


2 Sintaxis de script

La sentencia CONNECT sirve para definir el acceso de Qlik Sense a una base de datos general mediante la
interfaz OLE DB/ODBC. Para ODBC, debemos especificar primero la fuente de datos mediante el
administrador de conexin ODBC.

ODBC Connect TO connect-string [ ( access_info ) ]


OLEDB CONNECT TO connect-string [ ( access_info ) ]
CUSTOM CONNECT TO connect-string [ ( access_info ) ]
LIB CONNECT TO connection

Direct Query
La sentencia DIRECT QUERY permite enlazar tablas mediante una conexin ODBC u OLE DB,
empleando la funcin Direct Discovery.

Direct Query [path]

Directory
La sentencia Directory define en qu directorio se han de buscar archivos de datos en sentencias LOAD
subguientes.<span class="statement" MadCap:conditions="Primary.NotToTranslate"> </span>La
sentencia son es vlida, hasta que se introduce una nueva sentencias Directory.

Directory [path]

Disconnect
La sentencia Disconnect termina la actual conexin ODBC/OLE DB/Personalizada. Esta sentencia es
opcional.

Disconnect

drop field
Se pueden desechar del modelo de datos (y por tanto de la memoria) uno o varios campos de Qlik Sense, en
cualquier momento durante la ejecucin del script mediante una sentencia drop field.

Tanto drop field como drop fields se permiten ambas formas sin diferencia alguna en el
resultado. Si no se especifica tabla alguna, el campo se eliminar de todas las tablas en las
que aparece.

Drop field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2


...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2
...]]

drop table
Se pueden desechar del modelo de datos (y por tanto de la memoria) una o varias tablas internas de Qlik
Sense, en cualquier momento durante la ejecucin del script mediante una sentencia drop table.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 53


2 Sintaxis de script

Las formas drop table y drop tables se aceptan ambas.

Drop table tablename [, tablename2 ...]


drop tables[ tablename [, tablename2 ...]

Execute
La sentencia Execute sirve para ejecutar otros programas mientras Qlik Sense est cargando datos. Por
ejemplo, para hacer las conversiones que sean necesarias.

Execute commandline

FlushLog
La sentencia FlushLog hace que Qlik Sense guarde el contenido del buffer de script en el archivo de registro
(archivo log) del script.

FlushLog

Force
La sentencia force obliga a Qlik Sense a interpretar los valores de campo de las sentencias LOAD y
SELECT subsiguientes cuando aparecen escritas solo con maysculas o solo con minsculas, como si
estuvieran siempre en maysculas o tal como aparezcan (mezcladas). Esta sentencia permite asociar
valores de campo de tablas segn distintas convenciones.

Force ( capitalization | case upper | case lower | case mixed )

LOAD
La sentencia LOAD carga campos desde un archivo, desde datos definidos en el script, desde una tabla
previamente cargada, desde una pgina web, desde el resultado de una sentencia SELECT posterior, o
bien generando los datos automticamente.

Load [ distinct ] *fieldlist


[( from file [ format-spec ] |
from_field fieldassource [format-spec]
inline data [ format-spec ] |
resident table-label |
autogenerate size )]
[ where criterion | while criterion ]
[ group_by groupbyfieldlist ]
[order_by orderbyfieldlist ]

Let
La sentencia let es complementaria a la sentencia set, utilizada para definir variables de script. La sentencia
let, al contrario que la sentencia set, evala la expresin del lado derecho del signo igual: ' =' antes de ser
asignada a la variable.

Let variablename=expression

Map ... using

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 54


2 Sintaxis de script

La sentencia map ... using sirve para enlazar (mapear) un determinado valor de campo o expresin con los
valores de una tabla de correspondencias especfica. La tabla de correspondencias se crea mediante la
sentencia Mapping.

Map *fieldlist Using mapname

NullAsNull
La sentencia NullAsNull deshabilita la conversin de valores NULL a valores de cadena previamente
establecidos por una sentencia NullAsValue.

NullAsNull *fieldlist

NullAsValue
La sentencia NullAsValue especifica para qu campos se debern convertir los valores NULL hallados en
valores.

NullAsValue *fieldlist

Qualify
La sentencia Qualify sirve para activar o desactivar la calificacin de nombres de campo, es decir, que los
nombres de campo recibirn el nombre de la tabla como prefijo.

Qualify *fieldlist

Rem
La sentencia rem se usa para insertar comentarios en el script o desactivar temporalmente sentencias de
script, sin eliminarlas.

Rem string

Rename Field
Esta funcin de script renombra uno o varios campos de Qlik Sense tras haberlos cargado.

Rename field (using mapname | oldname to newname{ , oldname to newname })

Rename Fields (using mapname | oldname to newname{ , oldname to newname })

Rename Table
Esta funcin de script renombra una o varias tablas internas de Qlik Sense tras haberlas cargado.

Rename table (using mapname | oldname to newname{ , oldname to newname })


Rename Tables (using mapname | oldname to newname{ , oldname to newname })

Section
Con la sentencia section es posible definir si las sentencias subsiguientes LOAD y SELECT debern
considerarse como datos o como una definicin de derechos de acceso.

Section (access | application)

Select

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 55


2 Sintaxis de script

La seleccin de campos desde una fuente de datos ODBC o proveedor OLE DB se hace mediante
sentencias SQL SELECT estndar. Sin embargo, si las sentencias SELECT son aceptadas o no, depende
del driver ODBC o proveedor OLE DB empleado.

Select [all | distinct | distinctrow | top n [percent] ] *fieldlist

From tablelist

[Where criterion ]

[Group by fieldlist [having criterion ] ]

[Order by fieldlist [asc | desc] ]

[ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]

Set
La sentencia set se utiliza para definir variables de script. stas pueden servir para sustituir cadenas, rutas,
unidades de disco, etc.

Set variablename=string

Sleep
La sentencia sleep detiene la ejecucin de script por un tiempo especificado.

Sleep n

SQL
La sentencia SQL permite lanzar un comando SQL a travs de una conexin ODBC u OLE DB.

SQL sql_command

SQLColumns
La sentencia sqlcolumns devuelve un conjunto de campos que describen las columnas de una fuente de
datos ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.

SQLColumns

SQLTables
La sentencia sqltables devuelve un conjunto de campos que describen las tablas de una fuente de datos
ODBC u OLE DB, a la que se ha hecho una conexin mediante connect.

SQLTables

SQLTypes
La sentencia sqltypes devuelve un conjunto de campos que describen los tipos de una fuente de datos
ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.

SQLTypes

Star

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 56


2 Sintaxis de script

La cadena empleada para representar el conjunto de todos los valores de un campo en una base de datos
puede establecerse mediante la sentencia star. Afecta a las sentencias LOAD y SELECT subsiguientes.

Star is [ string ]

Store
Esta funcin de script crea un archivo QVD o un CSV.

Store [ *fieldlist from] table into filename [ format-spec ];

Tag
Esta funcin de script permite asignar etiquetas a uno o ms campos. Si se intenta etiquetar un nombre de
campo no presente en la app, se ignora el etiquetado. Si hubiera mltiples nombres de un mismo campo o
etiqueta, se emplear el ltimo valor.

Tag fields fieldlist using mapname


Tag field fieldname with tagname

Trace
La sentencia trace escribe una cadena en la ventana de Progreso de Ejecucin de Script y en el archivo
de registro (log) del script, cuando ste se utiliza. Es muy til cuando se desea efectuar una depuracin.
Mediante el empleo de expansiones de signo dlar de variables que se calculan antes de la sentencia trace,
podemos personalizar el mensaje.

Trace string

Unmap
La sentencia Unmap deshabilita el enlace de un valor de campo especificado por una sentencia Map
Using anterior, para campos cargados en lo sucesivo.

Unmap *fieldlist

Unqualify
La sentencia Unqualify sirve para desactivar la calificacin de nombres de campo que ha sido previamente
activada mediante la sentencia Qualify.

Unqualify *fieldlist

Untag
Es una opcin que permite eliminar etiquetas de uno o ms campos. Si se intenta desetiquetar un nombre
de campo no presente en la app, se ignora la accin de desetiquetar. Si hubiera mltiples nombres de un
mismo campo o etiqueta, se emplear el ltimo valor.

Untag Field fields fieldlist using mapname


Untag field fieldname with tagname

Alias
La sentencia alias se utiliza para establecer un alias segn el cual un campo se renombrar cada vez que
aparezca en el script.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 57


2 Sintaxis de script

Sintaxis:

alias fieldname as aliasname {,fieldname as aliasname}

Argumentos:

Argumento Descripcin

fieldname El nombre del campo en sus datos fuente

aliasname Un nombre alias que desee utilizar en vez

Ejemplos y resultados:

Ejemplo Resultado
Alias ID_N as
NameID;

Alias A as Los cambios de nombre definidos mediante esta sentencia se usarn en todas las
Name, B as
sentencias SELECT y LOAD subsiguientes. Se podr definir un nuevo alias insertando
Number, C as
Date;
una nueva sentencia alias en cualquier posicin sucesiva en el script.

Binary
La sentencia binary sirve para cargar los datos de otra app de Qlik Sense o de un documento de QlikView
11.2 o anterior, incluidos los datos de secciones de acceso.

Sintaxis:

binary file
file ::= [ path ] filename

Argumentos:

Argumento Descripcin

file El nombre del archivo, incluida la extensin del archivo .qvw o .qvf.

path La ruta al archivo como una conexin de datos de carpetas.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l absoluta

Ejemplo: c:\data\

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 58


2 Sintaxis de script

Argumento Descripcin

l relativa a la app que contiene esta lnea de script

Ejemplo: data\

Solo se permite una sentencia binary en el script y tiene que ser la primera sentencia del
script.

Ejemplos
Binary lib://MyData/customer.qvw;

Binary customer.qvw;

Binary c:\qv\customer.qvw;

Comment field
Ofrece una forma de mostrar los comentarios del campo (metadatos) desde bases de datos y hojas de
clculo. Los nombres de campo que no estn presentes en la app se ignorarn. Si hubiera mltiples nombres
de un mismo campo, se emplear el ltimo valor.

Sintaxis:

comment [fields] *fieldlist using mapname


comment [field] fieldname with comment

La tabla de enlace empleada deber tener dos columnas, la primera con los nombres de campo y la segunda
con los comentarios.

Argumentos:

Argumento Descripcin

*fieldlist Es una lista separada por comas con los campos que se han de comentar. El asterisco *
indica la totalidad de campos. Se permite la inclusin de los caracteres comodn * y ? en
los nombres de campo. Puede que sea necesario entrecomillar los nombres de campo
cuando se empleen caracteres comodn.

mapname Es el nombre de una tabla de correspondencia leda previamente en una sentencia


mapping LOAD o mapping SELECT.

fieldname El nombre del campo que debera comentarse.

comment El comentario que deber aadirse al campo.

Ejemplo1:

commentmap:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 59


2 Sintaxis de script

mapping LOAD * inline [


a,b
Alpha,This field contains text values
Num,This field contains numeric values
];
comment fields using commentmap;

Ejemplo2:

comment field Alpha with AFieldContainingCharacters;


comment field Num with '*A field containing numbers';
comment Gamma with 'Mickey Mouse field';

Comment table
Ofrece una forma de mostrar los comentarios de una tabla (metadatos) desde bases de datos u hojas de
clculo.

Los nombres de tabla que no estn presentes en la app se ignorarn. Si hubiera mltiples nombres de una
misma tabla, se emplear el ltimo valor. La palabra clave se puede utilizar para leer los comentarios desde
una fuente de datos.

Sintaxis:

comment [tables] tablelist using mapname

Argumentos:

Argumento Descripcin

tablelist (table{,table})

mapname Es el nombre de una tabla de correspondencia leda previamente en una sentencia


mapping LOAD o mapping SELECT.

Sintaxis:

Para fijar comentarios individuales se emplea la sintaxis siguiente:

comment [table] tablename with comment

Argumentos:

Argumento Descripcin

tablename El nombre de la tabla que debera comentarse.

comment El comentario que deber aadirse a la tabla.

Ejemplo1:

Commentmap:
mapping LOAD * inline [

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 60


2 Sintaxis de script

a,b
Main,This is the fact table
Currencies, Currency helper table
];
comment tables using commentmap;

Ejemplo2:

comment table Main with Main fact table;

Connect
La sentencia CONNECT sirve para definir el acceso de Qlik Sense a una base de datos general mediante la
interfaz OLE DB/ODBC. Para ODBC, debemos especificar primero la fuente de datos mediante el
administrador de conexin ODBC.

Esta sentencia admite nicamente conexiones de datos de carpetas en modo estndar.

Sintaxis:

ODBC CONNECT TO connect-string


OLEDB CONNECT TO connect-string
CUSTOM CONNECT TO connect-string
LIB CONNECT TO connection

Argumentos:

Argumento Descripcin

connect- connect-string ::= datasourcename { ; conn-spec-item }

string La cadena de conexin es el nombre de la fuente de datos y una lista


opcional de uno o ms elementos de especificacin de conexin. Si el
nombre de la fuente de datos contienen espacios en blanco, o si se lista
cualquiera de los elementos de especificacin de la conexin, la cadena de
conexin deber ir entre comillas.

datasourcename debe ser una fuente de datos definida por ODBC o una
cadena que defina a un proveedor OLE DB.

conn-spec-item ::=DBQ=database_specifier |DriverID=driver_


specifier |UID=userid |PWD=password

Los elementos posibles de especificacin de conexin pueden variar segn


las diferentes bases de datos. En algunas bases de datos, es posible que
haya otros elementos ms aparte de los sealados arriba. Para OLE DB,
algunos de los elementos especficos de conexin son obligatorios y no
opcionales.

connection El nombre de una conexin de datos almacenada en el editor de carga de


datos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 61


2 Sintaxis de script

Si el ODBC se coloca antes de CONNECT, se utilizar la interfaz ODBC; en caso contrario, se usar OLE
DB.

Al utilizar LIB CONNECT TO, se conecta con una base de datos con una conexin de datos almacenada
creada en el editor de carga de datos.

Ejemplo1:

ODBC CONNECT TO 'Sales


DBQ=C:\Program Files\Access\Samples\Sales.mdb';
Las sentencias Select (SQL) subsiguientes utilizan la fuente de datos definida por esta sentencia, hasta que
se ejecute una nueva sentencia CONNECT.

Ejemplo2:

LIB CONNECT TO 'MyDataConnection';

Connect32
Esta sentencia de control se utiliza igual que la sentencia de control CONNECT, pero obliga a un sistema de
64 bits a utilizar un proveedor ODBC/OLE DB de 32 bits. No aplicable a connect personalizada.

Connect64
Esta sentencia se utiliza igual que la sentencia CONNECT, pero obliga a utilizar un proveedor de 64 bits. No
aplicable a connect personalizada.

Direct Query
La sentencia DIRECT QUERY permite enlazar tablas mediante una conexin ODBC u OLE DB,
empleando la funcin Direct Discovery.

Sintaxis:

DIRECT QUERY DIMENSION fieldlist [MEASURE fieldlist] [DETAIL fieldlist]


FROM tablelist
[WHERE where_clause]

Las palabras clave DIMENSION , MEASURE y DETAIL se pueden usar en cualquier orden.

Las palabras clave DIMENSION y FROM son obligatorias en todas las sentencias DIRECT QUERY. La
palabra clave FROM debe aparecer antes de la palabra DIMENSION .

Los campos especificados directamente tras la palabra clave DIMENSION se cargan en la memoria y
pueden utilizarse para crear asociaciones entre los datos en memoria y los datos de Direct Discovery.

La sentencia DIRECT QUERY no puede contener clusulas de DISTINCT o GROUP BY.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 62


2 Sintaxis de script

Utilizando la palabra clave MEASURE puede definir campos de los que Qlik Sense es consciente a un nivel
meta. Los datos reales de un campo de medida residen slo en la base de datos durante el proceso de
carga de datos, y se recuperan conforme a las expresiones de grfico que se utilicen en una visualizacin.

Normalmente, los campos con valores discretos que se emplearn como dimensiones deberan cargarse con
la palabra clave DIMENSION , mientras que los datos numricos que se utilizarn en las agregaciones slo
deberan seleccionarse con la palabra clave MEASURE.

Los campos DETAIL ofrecen informacin o detalles, como por ej. campos "Comentario", que un usuario
puede querer mostrar en un cuadro de tabla que descienda a los detalles. Los campos DETAIL no pueden
utilizarse en expresiones de grfico.

Por diseo, la sentencia DIRECT QUERY es neutra en cuanto a los datos para fuentes de datos que
admiten SQL. Por esa razn, la misma sentencia DIRECT QUERY puede utilizarse en distintas bases de
datos SQL sin cambiar. Direct Discovery genera consultas adecuadas para la base de datos segn se
necesiten.

Se puede emplear la sintaxis nativa de la fuente de datos cuando el usuario conozca la base de datos que
desea consultar y desee explotar extensiones especficas de la base de datos en SQL. La sintaxis nativa que
admite la fuente de datos:

l Como expresiones de campos en clusulas DIMENSION y MEASURE


l Como el contenido de la clusula WHERE

Ejemplos:

DIRECT QUERY

DIMENSION Dim1, Dim2


MEASURE

NATIVE ('X % Y') AS X_MOD_Y

FROM TableName
DIRECT QUERY

DIMENSION Dim1, Dim2


MEASURE X, Y
FROM TableName
WHERE NATIVE ('EMAIL MATCHES "\*.EDU"')

Los siguientes trminos se utilizan como palabras clave y, por lo tanto, no pueden utilizarse
como nombres de columnas o campos sin ir entre comillas: and, as, detach, detail, dimension,
distinct, from, in, is, like, measure, native, not, or, where

Argumentos:

Argumento Descripcin

fieldlist Una lista de especificaciones de campos separadas por comas, fieldname {,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 63


2 Sintaxis de script

Argumento Descripcin

fieldname} . Una especificacin de campo puede ser un nombre de campo, en cuyo caso
se utiliza el mismo nombre para el nombre de la columna de la base de datos y el nombre
del campo Qlik Sense. O una especificacin de campo puede ser un "campo alias," en
cuyo caso se da un nombre de campo Qlik Sense a una expresin de base de datos o
nombre de columna.

listatabla es el nombre de una tabla o vista de la base de datos desde la que se cargan los datos.
Por lo general se trata de una vista que contiene un JOIN efectuado en la base de datos.

where_ La sintaxis completa de las clusulas WHERE de la base de datos no se define aqu, pero
clause se permiten la mayora de "expresiones relacionales" SQL, incluido el uso de llamadas a
funciones, el operador LIKE de cadenas, IS NULL y IS NOT NULL y IN. BETWEEN no
se incluye.

NOT es un operador unario, a diferencia de un modificador o determinadas palabras clave.

Ejemplos:

WHERE x > 100 AND "Region Code" IN ('south', 'west')


WHERE Code IS NOT NULL and Code LIKE '%prospect'
WHERE NOT X in (1,2,3)
Este ltimo ejemplo no puede escribirse como:

WHERE X NOT in (1,2,3)

Ejemplo:

En este ejemplo, se utiliza una tabla de base de datos denominada TableName, que contiene campos Dim1,
Dim2, Num1, Num2 y Num3.Dim1 y Dim2 se cargarn en el conjunto de datos Qlik Sense.

DIRECT QUERY DIMENSTION Dim1, Dim2 MEASURE Num1, Num2, Num3 FROM TableName ;

Dim1 y Dim2 estarn disponibles para utilizarlos como dimensiones. Num1, Num2 y Num3 estar disponible
para agregaciones. Dim1 y Dim2 tambin estn disponibles para agregaciones. El tipo de agregaciones para
las que Dim1 y Dim2 pueden utilizarse depende de sus tipos de datos. Por ejemplo, en muchos casos los
campos DIMENSION contienen datos de cadenas tales como nombres o nmero de cuenta. Dichos campos
no pueden sumarse,pero s pueden contarse: count(Dim1).

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 64


2 Sintaxis de script

Las sentencias DIRECT QUERY se escriben directamente en el editor de script. Para


simplificar la construccin de sentencias DIRECT QUERY, podemos generar una sentencia
SELECT desde una conexin de datos, y luego editar el script generado para cambiarlo a una
sentencia DIRECT QUERY.
Por ejemplo, la sentencia SELECT:

SQL SELECT
SalesOrderID,
RevisionNumber,
OrderDate,
SubTotal
TaxAmt
FROM MyDB.Sales.SalesOrderHeader;

podra modificarse a la siguiente sentencia DIRECT QUERY:

DIRECT QUERY
DIMENSION
SalesOrderID,
RevisionNumber,

MEASURE
SubTotal
TaxAmt
DETAIL
OrderDate,
FROM MyDB.Sales.SalesOrderHeader;

Listas de campos Direct Discovery


Una lista de campos es una lista de especificaciones de campos separadas por comas, fieldname {,
fieldname}. Una especificacin de campo puede ser un nombre de campo, en cuyo caso se utiliza el mismo
nombre para el nombre de la columna de la base de datos y el nombre del campo. O una especificacin de
campo puede ser un "campo alias," en cuyo caso se da un nombre de campo Qlik Sense a una expresin de
base de datos o nombre de columna.

Los nombres de campo pueden ser o nombres simples o nombres entrecomillados. Un nombre simple
comienza con un carcter alfabtico Unicode y va seguido de cualquier combinacin de caracteres
alfabticos o numricos o guiones bajos. Los nombres entrecomillados comienzan con unas comillas dobles
y contienen cualquier secuencia de caracteres. Si un nombre entrecomillado contiene comillas dobles, esas
comillas dobles se representan empleando dos signos de dobles comillas adyacentes.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 65


2 Sintaxis de script

Los nombres de campo de Qlik Sense son sensibles a maysculas. Los nombres de campo de las bases de
datos pueden ser o no sensibles a maysculas, dependiendo de la base de datos concreta. Una consulta
Direct Discovery preserva el caso de todos los identificadores de campos y alias. En el ejemplo a
continuacin, el alias "MyState" se utiliza internamente para almacenar los datos de la columna de la base
de datos "STATEID".

DIRECT QUERY Dimension STATEID as MyState Measure AMOUNT from SALES_TABLE;

Esto difiere del resultado de una sentencia SQL Select con un alias. Si el alias no se entrecomilla
explcitamente, el resultado por defecto es el de una columna devuelta por la base de datos destino. En el
ejemplo siguiente, la sentencia SQL Select en una base de datos Oracle crea "MYSTATE,", con todas las
letras maysculas, como el alias Qlik Sense interno incluso aunque el alias se haya especificado como un
caso mixto. La sentencia SQL Select utiliza el nombre de columna devuelto por la base de datos, el cual en
el caso de Oracle es todo en maysculas.

SQL Select STATEID as MyState, STATENAME from STATE_TABLE;

Para evitar este comportamiento, utilice la sentencia LOAD para especificar el alias.

Load STATEID as MyState, STATENAME;


SQL Select STATEID, STATEMENT from STATE_TABLE;

En este ejemplo, la columna "STATEID" es almacenada internamente por Qlik Sense como "MyState".

Se permiten la mayora de expresiones escalares de bases de datos como especificaciones de campos. Las
llamadas a funciones tambin se pueden utilizar en especificaciones de campos. Las expresiones pueden
contener constantes que son booleanas, numricas o cadenas contenidas en signos de entrecomillado
simple (la inclusin de signos de entrecomillado simple viene representada por signos de entrecomillado
adyacentes).

Ejemplos:

DIRECT QUERY DIMENSION SalesOrderID, RevisionNumber MEASURE SubTotal AS "Sub Total" FROM
AdventureWorks.Sales.SalesOrderHeader
DIRECT QUERY DIMENSION "SalesOrderID" AS "Sales Order ID" MEASURE SubTotal,TaxAmt,(SubTotal-TaxAmt)
AS "Net Total" FROM AdventureWorks.Sales.SalesOrderHeader
DIRECT QUERY DIMENSION (2*Radius*3.14159) AS Circumference, Molecules/6.02e23 AS Moles MEASURE Num1
AS numA FROM TableName
DIRECT QUERY DIMENSION concat(region, 'code') AS region_code MEASURE Num1 AS NumA FROM TableName

Direct Discovery no permite el uso de agregaciones en sentencias LOAD. Si se utilizaran agregaciones, los
resultados seran impredecibles. Una sentencia LOAD como la siguiente no debera utilizarse:

DIRECT QUERY DIMENSION stateid, SUM(amount*7) AS MultiFirst MEASURE amount FROM sales_table
El SUM no debera estar en la sentencia LOAD.

Direct Discovery tampoco admite funciones Qlik Sense en sentencias Direct Query. Por ejemplo, la
siguiente especificacin de un campo DIMENSION da como resultado un fallo cuando el campo "Mth" se
emplea como una dimensin en un grfico:

month(ModifiedDate) as Mth

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 66


2 Sintaxis de script

Directory
La sentencia Directory define en qu directorio se han de buscar archivos de datos en sentencias LOAD
subguientes.<span class="statement" MadCap:conditions="Primary.NotToTranslate"> </span>La
sentencia son es vlida, hasta que se introduce una nueva sentencias Directory.

Esta sentencia no tiene efecto alguno en el modo de script estndar.

Sintaxis:

Directory[path]

Si se lanza la sentencia Directory sin una path o esta se deja fuera, Qlik Sense buscar en el directorio de
trabajo de Qlik Sense.

Argumentos:

Argumento Descripcin

path Texto que se puede interpretar como la ruta al archivo qvf.

La ruta es la ruta del archivo, que puede ser:

l Absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet.

Ejemplo: http://www.qlik.com

Ejemplo:

Directory c:\userfiles\data;

Disconnect
La sentencia Disconnect termina la actual conexin ODBC/OLE DB/Personalizada. Esta sentencia es
opcional.

Sintaxis:

Disconnect

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 67


2 Sintaxis de script

La conexin terminar automticamente cuando se ejecute una nueva sentencia connect o cuando termine
la ejecucin del script.

Ejemplo:

Disconnect;

Drop field
Se pueden desechar del modelo de datos (y por tanto de la memoria) uno o varios campos de Qlik Sense, en
cualquier momento durante la ejecucin del script mediante una sentencia drop field.

Tanto drop field como drop fields se permiten ambas formas sin diferencia alguna en el
resultado. Si no se especifica tabla alguna, el campo se eliminar de todas las tablas en las
que aparece.

Sintaxis:

Drop field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2


...]]
Drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2
...]]

Ejemplos:

Drop field A;
Drop fields A,B;
Drop field A from X;
Drop fields A,B from X,Y;

Drop table
Se pueden desechar del modelo de datos (y por tanto de la memoria) una o varias tablas internas de Qlik
Sense, en cualquier momento durante la ejecucin del script mediante una sentencia drop table.

Sintaxis:

drop table tablename [, tablename2 ...]


drop tables [ tablename [, tablename2 ...]

Las formas drop table y drop tables se aceptan ambas.

Los elementos siguientes se perdern como resultado de esto:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 68


2 Sintaxis de script

l Las tabla(s) en s.
l Todos los campos que no formen parte de las restantes tablas.
l Los valores de campo en los campos, los cuales vienen exclusivamente desde las tablas eliminadas.

Ejemplos y resultados:

Ejemplo Resultado
drop table Orders, Salesmen, T456a; Esta lnea da como resultado que las tres
tablas sean eliminadas de la memoria.

Tab1: Como resultado slo los agregados se


mantienen en la memoria. Los datos trans se
SQL SELECT* from Trans;
LOAD Customer, Sum( sales ) resident Tab1 group by descartan.
Month;
drop table Tab1;

Execute
La sentencia Execute sirve para ejecutar otros programas mientras Qlik Sense est cargando datos. Por
ejemplo, para hacer las conversiones que sean necesarias.

Esta sentencia no se admite en modo estndar.

Sintaxis:

execute commandline

Argumentos:

Argumento Descripcin

commandline Es un texto que puede ser interpretado por el sistema operativo como una
lnea de comando. Puede hacer referencia a una ruta de archivo absoluta
o a una ruta de carpeta lib://.

Si desea utilizar Execute se deben cumplir las siguientes condiciones:

l Debe estar en modo de legado (aplicable a Qlik Sense y Qlik Sense Desktop).
l Necesita configurar OverrideScriptSecurity en 1 en Settings.ini (aplicable a Qlik Sense).
Settings.ini est ubicado en C:\ProgramData\Qlik\Sense\Engine\ y por lo general es un archivo
vaco.

Haga lo siguiente:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 69


2 Sintaxis de script

1. Haga una copia de Settings.ini y bralo en un editor de texto.


2. Inserte una lnea vaca.
3. Introduzca OverrideScriptSecurity=1.
4. Guarde el archivo.
5. Sustituya Settings.ini por su archivo editado.

Si Qlik Sense se est ejecutando como un servicio, algunos comandos puede que no se
comporten de la forma esperada.

Ejemplo:

Execute C:\Program Files\Office12\Excel.exe;


Execute lib://win\notepad.exe // win is a folder connection referring to c:\windows

FlushLog
La sentencia FlushLog hace que Qlik Sense guarde el contenido del buffer de script en el archivo de registro
(archivo log) del script.

Sintaxis:

FlushLog

El contenido del buffer se escribe en el archivo .log de registro. Este comando puede ser til para depurar,
puesto que recibiremos datos que de otro modo se podran haber perdido en una ejecucin fallida de script.

Ejemplo:

FlushLog;

Force
La sentencia force obliga a Qlik Sense a interpretar los valores de campo de las sentencias LOAD y
SELECT subsiguientes cuando aparecen escritas solo con maysculas o solo con minsculas, como si
estuvieran siempre en maysculas o tal como aparezcan (mezcladas). Esta sentencia permite asociar
valores de campo de tablas segn distintas convenciones.

Sintaxis:

Force ( capitalization | case upper | case lower | case mixed )

Si no se especifica nada, se asume force case mixed. La sentencia force es vlida hasta que se incluya una
nueva sentencia force.

La sentencia force no tiene efecto alguno en la seccin de acceso: todos los valores de campos cargados no
son sensibles a maysculas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 70


2 Sintaxis de script

Ejemplos:

Force Capitalization;
Force Case Upper;
Force Case Lower;
Force Case Mixed;

Load
La sentencia LOAD carga campos desde un archivo, desde datos definidos en el script, desde una tabla
previamente cargada, desde una pgina web, desde el resultado de una sentencia SELECT posterior, o
bien generando los datos automticamente.

Sintaxis:

LOAD [ distinct ] *fieldlist


[( from file [ format-spec ] |
from_field fieldassource [format-spec]
inline data [ format-spec ] |
resident table-label |
autogenerate size )]
[ where criterion | while criterion ]
[ group_by groupbyfieldlist ]
[order_by orderbyfieldlist ]

Argumentos:

Argumento Descripcin

distinct distinct es un predicado empleado nicamente si el primero de los registros


duplicados debe cargarse.

fieldlist *fieldlist ::= ( * | field {, field } )


Una lista de los campos que se van a cargar. El asterisco * como una lista de campos
indica la totalidad de campos de la tabla.
field ::= ( fieldref | expression ) [as aliasname ]
La definicin de campo debe contener siempre una referencia literal a un
campo existente, o a una expresin.
fieldref ::= ( fieldname |@fieldnumber |@startpos:endpos [ I | U | R| B ] )
fieldname es un texto idntico a un nombre de campo de la tabla. Tenga en cuenta
que el nombre de campo debe ir entre comillas dobles rectas o corchetes si contiene
por ejemplo espacios. A veces los nombres de campo no estn disponibles de forma
explcita. Entonces se usa una nomenclatura diferente:

@fieldnumber representa el nmero de campo en un archivo de tabla delimitado.


Debe ser un nmero entero positivo precedido de "@". La numeracin se hace
siempre desde 1 hasta el nmero de campos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 71


2 Sintaxis de script

Argumento Descripcin

@startpos: endpos representa las posiciones inicial y final de un campo en un archivo


con registros de longitud fija. Las posiciones deben ser nmeros enteros positivos. Los
dos nmeros debern ir precedidos de "@" y separados por dos puntos. La
numeracin se hace siempre desde 1 hasta el nmero de posiciones. Si
@startpos: endpos va seguido inmediatamente de los caracteres I oU, los bytes
ledos se interpretarn como un binario con signo (I) o un entero sin signo (U) (orden
Intel de bytes). El nmero de las posiciones ledas debe ser 1, 2 4. Si
@startpos: endpos va inmediatamente seguido por el carcter R, los bytes ledos se
interpretarn como un nmero real binario (punto flotante IEEE 32-bit o 64 bit). El
nmero de las posiciones ledas debe ser 4 u 8. Si @startpos: endpos va
inmediatamente seguido por el carcter B, los bytes ledos se interpretarn como
nmeros BCD (Binary Coded Decimal) de acuerdo al estndar COMP-3. Se puede
especificar cualquier nmero de bytes.

expression puede ser una funcin numrica o funcin de cadenas basada en uno o
varios campos de la misma tabla. Para ms informacin, vea la sintaxis de las
expresiones.

as se utiliza para asignar un nuevo nombre al campo.

from from se utiliza si hay que cargar los datos desde un archivo utilizando una carpeta o
una conexin de datos de archvos web.

file ::= [ path ] filename

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet.

Ejemplo: http://www.qlik.com

Si se omite la ruta, Qlik Sense buscar el archivo en el directorio especificado por la


sentencia Directory. Si no hay ninguna sentencia Directory, Qlik Sense buscar en
el directorio de trabajo, C:\Users\{user}\Documents\Qlik\Sense\Apps.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 72


2 Sintaxis de script

Argumento Descripcin

En una instalacin de servidor Qlik Sense, el directorio de trabajo se


especifica en Qlik Sense Repository Service; por defecto es
C:\ProgramData\Qlik\Sense\Apps. Consulte la ayuda de Qlik
Management Console para obtener ms informacin.

filename puede contener los caracteres comodn estndar de DOS (* y ?). Esto
provocar la carga de todos los archivos en el directorio especificado.
format-spec ::= ( fspec-item { , fspec-item } )
La especificacin de formato consiste en una lista de varios elementos de
caracterizacin, entre parntesis.

from_field from_field se utiliza si los datos debieran cargarse desde un archivo previamente
cargado.
fieldassource::=(tablename, fieldname)

El campo es el nombre de los tablename y fieldname anteriormente cargados.


format-spec ::= ( fspec-item {, fspec-item } )
La especificacin de formato consiste en una lista de varios elementos de
caracterizacin, entre parntesis.

inline inline se utiliza si los datos deben introducirse en el script y no cargarse desde un
fichero.
data ::= [ text ]

Los datos introducidos por una clusula inline deben estar entre comillas o corchetes.
El texto en su interior se interpreta de la misma manera que el contenido de un
archivo. Por lo tanto, donde inserte una nueva lnea en un archivo de texto, debe
hacerlo tambin en el texto de una clusula inline, por ejemplo pulsando la tecla Intro
cuando escriba en el script.
format-spec ::= ( fspec-item {, fspec-item } )
La especificacin de formato consiste en una lista de varios elementos de
caracterizacin, entre parntesis.

resident resident se utiliza si los datos debieran cargarse desde una tabla previamente
cargada.
table label es una etiqueta que precede a la(s) sentencia(s) LOAD o SELECT, que
crearon la tabla original. La etiqueta debe ir seguida de dos puntos al final de la lnea.

autogenerate autogenerate se utiliza si los datos deben ser generados automticamente por Qlik
Sense.
size ::= number

Number es un entero que indica el nmero de registros que se han de generar. La lista
de campos no debe contener expresiones que requieran datos de una base de datos.
En estas expresiones slo se permiten constantes y funciones sin parmetros (por ej.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 73


2 Sintaxis de script

Argumento Descripcin

rand() or recno()) .

where where es una clusula empleada para establecer si un registro debe ir incluido en la
seleccin o no. Se incluye la seleccin si criterion es True.
criterion es una expresin lgica.

while while es una clusula que se utiliza para establecer si un registro deber leerse
repetidamente. Se lee el mismo registro siempre y cuando criterion sea True. Con el
fin de resultar til, una clusula while ha de incluir la funcin IterNo( ).

criterion es una expresin lgica.

group_by group by es una clusula que sirve para definir sobre qu campos debern agregarse
(agruparse) los datos.Los campos de agrupacin debern incluirse de alguna manera
en las expresiones cargadas. Ningn otro campo ms que los de agrupacin deber
emplearse fuera de las funciones de agregacin en las expresiones cargadas.

groupbyfieldlist ::= (fieldname { ,fieldname } )

order_by order by es una clusula que se utiliza para ordenar los registros de una tabla
residente, antes de que sean procesados por la sentencia load. La tabla residente
puede ordenarse por ms de un campo en orden ascendente o descendente. La
ordenacin se hace principalmente por valores numricos y secundariamente por valor
ASCII nacional. Esta clusula solo puede utilizarse cuando al fuente de datos es una
tabla residente.
Los campos de ordenacin especifican por qu campos est ordenada la tabla
residente. El campo puede especificarse por su nombre o por su nmero en la tabla
residente (el primer nmero de campo es el 1).

orderbyfieldlist ::= fieldname [sortorder ] {, fieldname [sortorder ] }

sortorder sirve tanto para ordenacin ascendente, asc, como descendente, desc. Si
no se especifica sortorder alguno, se asume asc (ascendente).

fieldname, path, filename y aliasname son cadenas que representan lo que sus
respectivos nombres indican. Cualquier campo de la tabla de origen puede utilizarse
como fieldname. No obstante, los campos creados mediante la clusula as
(aliasname) estn fuera de mbito y no pueden utilizarse dentro de la misma
sentencia load.

Si no se especifica ninguna fuente de datos mediante una clusula f from, inline, resident, from_field o
autogenerate, los datos se cargarn a partir del resultado de la sentencia SELECT o LOAD
inmediatamente posterior. Dicha sentencia posterior no debera llevar ningn prefijo.

Ejemplos:

Cargar formatos de archivo diferentes

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 74


2 Sintaxis de script

// LOAD a delimited data file with default options


LOAD * from data1.csv;

// LOAD a delimited data file from a library connection MyData


LOAD * from 'lib://MyData/data1.csv';

// LOAD a delimited file, specifying comma as delimiter and embedded labels


LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels);

// LOAD a delimited file specifying tab as delimiter and embedded labels


LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);

// LOAD a dif file with embedded headers


LOAD * from file2.dif (ansi, dif, embedded labels);

// LOAD three fields from a fixed record file without headers


LOAD @1:2 as ID, @3:25 as Name, @57:80 as City from data4.fix (ansi, fix, no labels, header is 0,
record is 80);

//LOAD a QVX file, specifying an absolute path


LOAD * from C:\qdssamples\xyz.qvx (qvx);

Seleccionar ciertos campos, renombrar y calcular campos


// LOAD only three specific fields
LOAD FirstName, LastName, Number from data1.csv;

// Rename first field as A and second field as B when loading a file without labels
LOAD @1 as A, @2 as B from data3.txt' (ansi, txt, delimiter is '\t', no labels);

// LOAD Name as a concatenation of FirstName, a space, and LastName


LOAD FirstName&' '&LastName as Name from data1.csv;

//LOAD Quantity, Price and Value (the product of Quantity and Price)
LOAD Quantity, Price, Quantity*Price as Value from data1.csv;

Seleccionar ciertos registros


// LOAD only unique records, duplicate records will be discarded
LOAD distinct FirstName, LastName, Number from data1.csv;

// LOAD only records where the field Litres has a value above zero
LOAD * from Consumption.csv where Litres>0;

Cargar datos que no residen en archivo y datos autogenerados


// LOAD a table with inline data, fields CatID and Category
LOAD * Inline
[CatID, Category
0,Regular
1,Occasional
2,Permanent];

// LOAD a table with inline data, fields UserID, Password and Access
LOAD * Inline [UserID, Password, Access
A, ABC456, User
B, VIP789, Admin];

// LOAD a table with 10 000 rows


// Field A will contain the number of the read record (1,2,3,4,5...)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 75


2 Sintaxis de script

// Field B will contain a random number between 0 and 1


LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);

El parntesis despus de autogenerate se permite, pero no es obligatorio.

Cargar datos de una tabla previamente cargada


tab1:
SELECT A,B,C,D from transtable;

// LOAD fields from already loaded table tab1


LOAD A,B,month(C),A*B+D as E resident tab1;

// LOAD fields from already loaded table tab1 but only records where A is larger than B
LOAD A,A+B+C resident tab1 where A>B;

// LOAD fields from already loaded table tab1 ordered by A


LOAD A,B*C as E resident tab1 order by A;

// LOAD fields from already loaded table tab1, ordered by the first field, then the second field
LOAD A,B*C as E resident tab1 order by 1,2;

// LOAD fields from already loaded table tab1 ordered by C descending, then B ascending,
// then first field descending
LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des

Cargar datos de archivos previamente cargados


// LOAD field Types from previously loaded table Characters as A
LOAD A from_field (Characters, Types)

Cargar datos desde una tabla subsiguiente


// LOAD A, B and calculated fields C and D from Table1 that is loaded in succeeding statement
LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y;
SELECT A,B,C,D from Table1;

Agrupar datos
// LOAD fields grouped (aggregated) by ArtNo
LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo;
// // LOAD fields grouped (aggregated) by Week and ArtNo
LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week,
ArtNo;

Leer un registro de forma repetida


En este ejemplo hay un archivo de entrada Grades.csv que contiene las notas de cada estudiante
condensadas en un campo:

Student,Grades
Mike,5234
John,3345
Pete,1234
Paul,3352

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 76


2 Sintaxis de script

Las notas, en una escala del 1 al 5 representan matemticas, ingls, ciencias e historia. Es posible separar
las notas en distintos valores leyendo cada registro varias veces con una clusula while, usando la funcin
IterNo( ) como un contador. En cada lectura, la nota se extrae mediante la funcin Mid y el asunto se
selecciona mediante la funcin pick. La clusula final while contiene la prueba de comprobacin para ver si
todas las notas se han ledo (cuatro por estudiante en este caso), lo que significa que se debera leer el
registro del siguiente estudiante.

MyTab:
LOAD Student,
mid(Grades,IterNo( ),1) as Grade,
pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from Grades.csv
while IsNum(mid(Grades,IterNo(),1));

El resultado es una tabla que contiene los siguientes datos:

Elementos de especificacin de formato


Cada elemento de especificacin de formato define una determinada propiedad del archivo de tabla:

fspec-item ::= [ansi | oem | mac | UTF-8 | Unicode | txt | fix | dif | biff | ooxml | html | xml |
kml | qvd | qvx | delimiter is char | no eof | embedded labels | explicit labels | no labels | table is
[tablename] | header is n | header is line | header is n lines | comment is string | record is n |
record is line | record isn lines | no quotes |msq | filters (filter specifiers) ]

Juego de caracteres
El juego de caracteres es un especificador de archivos para la sentencia LOAD que define el conjunto de
caracteres que se emplea en el archivo.

Los especificadores ansi, oem y mac se utilizaban en QlikView y an funcionan. Sin embargo, no se
generarn cuando se cree la sentencia LOAD con Qlik Sense.

Sintaxis:

utf8 | unicode | ansi | oem | mac | codepage is

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 77


2 Sintaxis de script

Argumentos:

Argumento Descripcin

utf8 Juego de caracteres UTF-8

unicode Juego de caracteres Unicode

ansi Windows, codepage 1252

oem DOS, OS/2, AS400 y otros

mac Codepage 10000

codepage Con el especificador codepage , se puede utilizar cualquier codepage de Windows como
is N.

Limitaciones:

La conversin desde el juego de caracteres oem no est implementada para MacOS. Si no se especifica
ninguno, se asume el valor codepage 1252 en Windows.

Ejemplo:

LOAD * from a.txt (utf8, txt, delimiter is ',' , embedded labels)


LOAD * from a.txt (unicode, txt, delimiter is ',' , embedded labels)
LOAD * from a.txt (codepage is 10000, txt, delimiter is ',' , no labels)

Vea tambin:

p Load (pgina 71)

Formato de tabla
El formato de tabla es un especificador de archivo para la sentencia LOAD que define de qu tipo es el
archivo. Si no se especifica nada, se asume un archivo de texto .txt.

txt En un archivo delimitado de texto, .txt, las columnas de la tabla van separadas por
algn carcter.

fix En un archivo de registro de longitud fija,.fix, cada columna tiene un nmero fijo de
caracteres de ancho.

dif En un archivo .dif (Data Interchange Format) se utiliza un formato especial para definir
la tabla.

biff Qlik Sense tambin puede interpretar datos en archivos Excel estndar por medio del
formato biff (Binary Interchange File Format).

ooxml Excel 2007 y versiones posteriores usan el formato ooxml .xslx.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 78


2 Sintaxis de script

html Si la tabla forma parte de algn archivo o pgina html, deber emplearse html.

xml xml (lenguaje de marcado extensible) es un lenguaje de marcado habitual que se utiliza
para representar estructuras de datos en un formato textual.

qvd El formato qvd es el formato nativo de los archivos QVD, exportados desde una app de
Qlik Sense.

qvx qvx es un formato de espacio/archivo para una salida de alto rendimiento en Qlik
Sense.

Delimiter
Se puede especificar un delimitador arbitrario para archivos de tabla delimitados, mediante el especificador
delimiter is. Este especificador slo tiene sentido en archivos .txt delimitados.

Sintaxis:

delimiter is char

Argumentos:

Argumento Descripcin

char Especifica un nico carcter de los caracteres 127 ASCII.

Se pueden aplicar adems los siguientes valores:

"\t" representa un signo de tabulacin, con o sin comillas.

"\\" representa un carcter de barra invertida (\ ).

"spaces" representa todas las combinaciones de uno o ms espacios. Los


caracteres no imprimibles, con un valor ASCII inferior a 32, con la
excepcin de CR y LF, se interpretarn como espacios.

Si no se especifica nada, se asume delimiter is ','.

Ejemplo:

LOAD * from a.txt (utf8, txt, delimiter is ',' , embedded labels);

Vea tambin:

p Load (pgina 71)

No eof
El especificador no eof se utiliza para descartar el carcter de fin de lnea cuando cargamos archivos .txt
delimitados.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 79


2 Sintaxis de script

Sintaxis:

no eof

Si se utiliza el especificador no eof, el carcter ASCII 26, que de otro modo denota final de fila, es
descartado y puede formar parte de un valor de campo.

Este especificador slo tiene sentido en archivos .txt delimitados.

Ejemplo:

LOAD * from a.txt (txt, utf8, embedded labels, delimiter is ' ', no eof);

Vea tambin:

p Load (pgina 71)

Labels
Labels es un especificador de archivo para la sentencia LOAD que define en qu parte de un archivo se
encuentran los nombres de campo.

Sintaxis:

embedded labels|explicit labels|no labels

Los nombres de campo pueden encontrarse en sitios diferentes en el archivo. Si el primer registro contiene
los nombres de los campos, debera usarse la opcin embedded labels. En caso de no encontrar nombres
de campo, se debera usar no labels. En archivos dif, a veces se utiliza una seccin de cabecera aparte, con
nombres de campo explcitos. En tal caso, debe usarse la opcin explicit labels. Si no se especifica nada,
se asume embedded labels, tambin para archivos dif.

Ejemplo1:

LOAD * from a.txt (unicode, txt, delimiter is ',' , embedded labels

Ejemplo2:

LOAD * from a.txt (codePage is 1252, txt, delimiter is ',' , no labels)

Vea tambin:

p Load (pgina 71)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 80


2 Sintaxis de script

Header is
Determina el tamao de la cabecera de los archivos de tabla. Se puede especificar una longitud arbitraria de
cabecera mediante el especificador header is. Una cabecera es una seccin de texto no utilizada por Qlik
Sense.

Sintaxis:

header is n
header is line
header is n lines

La longitud de la cabecera se puede dar en bytes (header is n), o en lneas (header is line o header is n
lines). n debe ser un entero positivo que represente la longitud de cabecera. Si no se especifica nada, se
asume header is 0. El especificador header is slo es relevante para archivos de tabla.

Ejemplo:

Este es un ejemplo de una tabla de fuente de datos que contiene una lnea de texto de cabecera que Qlik
Sense no debera interpretar como datos.
*Header line
Col1,Col2
a,B
c,D
Si se usa el especificador header is 1 lines, la primera lnea no se cargar como datos. En el ejemplo, el
especificador embedded labels le dice a Qlik Sense que interprete la primera lnea no excluida como que
contiene etiquetas de campo.
LOAD Col1, Col2
FROM 'lib://files/header.txt'
(txt, embedded labels, delimiter is ',', msq, header is 1 lines);
El resultado es una tabla con dos campos, Col1 y Col2.

Vea tambin:

p Load (pgina 71)

Record is
Para archivos de registro fijo, la longitud de registro debe especificarse a travs del especificador record is.

Sintaxis:

Record is n
Record is line
Record is n lines

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 81


2 Sintaxis de script

Argumento Descripcin

n Especifica la longitud de registro en bytes.

line Especifica la longitud de registro en una lnea.

n lines Especifica la longitud de registro en lneas donde n es un entero positivo que representa la
longitud de registro.

Limitaciones:

El especificador record is slo es relevante para archivos fix.

Vea tambin:

p Load (pgina 71)

Quotes
Quotes es un especificador de archivo para la sentencia LOAD que define si se pueden utilizar o no comillas
y la prioridad entre stas y los separadores. Es slo para archivos de texto.

Sintaxis:

no quotes
msq

Si se omite el especificador, se pueden utilizar las comillas estndar dobles o simples (" " o ' '), pero slo si
son el primer y ltimo carcter no en blanco de un valor de campo.

Argumentos:

Argumento Descripcin

no quotes Se utiliza si los smbolos de entrecomillado no se aceptan en un archivo de texto.

msq Sirve para especificar un estilo de comillas modernas, que permite un contenido de
mltiples lneas en los campos. Los campos que contengan caracteres de final de lnea
deben ir entre comillas dobles.

Una limitacin de la opcin msq es que si un carcter de comillas dobles (") aparece por s
solo como primer o ltimo carcter en el contenido de un campo, se interpretar como el
inicio o el final del contenido de mltiples lneas, lo cual puede dar lugar a resultados
inesperados en el conjunto de datos cargado. En este caso conviene aplicar las comillas
estndar, omitiendo el especificador.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 82


2 Sintaxis de script

XML
Este especificador de script se utiliza para cargar archivos xml. Las opciones vlidas para la sintaxis del
especificador XML se enumeran en la sintaxis.

Sintaxis:

xmlsax
xmlsimple
pattern is path

xmlsax y xmlsimple son mutuamente excluyentes, slo puede especificarse uno cuando se emplea xml.
Cuando se emplee pattern el archivo se leer desde el principio de la etiqueta especificada hasta el final de
la misma. Si path contiene espacios, deber ir entre comillas.

Para usar xmlsax, debe instalarse el parser Microsoft xml 3.0 o posterior de MSXML. MSXML
viene junto con por ej. Windows XP y MS Internet Explorer 6. Tambin se puede descargar de
la pgina web de Microsoft.

Vea tambin:

p Load (pgina 71)

KML
Este especificador de script se usa cuando se cargan archivos KML que se van a utilizar en una visualizacin
de mapa.

Sintaxis:

kml

El archivo KML puede representar datos de rea (por ejemplo pases o regiones), representados mediante
polgonos, o datos de puntos (por ejemplo ciudades o lugares), representados por puntos en el formulario
[long, lat].

Let
La sentencia let es complementaria a la sentencia set, utilizada para definir variables de script. La sentencia
let, al contrario que la sentencia set, evala la expresin del lado derecho del signo igual: ' =' antes de ser
asignada a la variable.

Sintaxis:

Let variablename=expression

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 83


2 Sintaxis de script

La palabra let puede omitirse, pero la sentencia se convierte entonces en una sentencia de control. Dicha
sentencia, sin la palabra clave let debe ir en una sola lnea de script y puede terminar tanto con un fin de
lnea como con un punto y coma.

Ejemplos y resultados:

Ejemplo Resultado
Set x=3+4; $(x) se evaluar como "3+4"
Let y=3+4
z=$(y)+1; $(y) se evaluar como " 7"

$(z) se evaluar como " 8"

Let T=now(); $(T) recibir el valor de la hora actual.

Map
La sentencia map ... using sirve para enlazar (mapear) un determinado valor de campo o expresin con los
valores de una tabla de correspondencias especfica. La tabla de correspondencias se crea mediante la
sentencia Mapping.

Sintaxis:

Map *fieldlist Using mapname

La correspondencia automtica se hace para los campos cargados tras la sentencia Map Using y hasta
finalizar el script, o hasta que encuentre una sentencia Unmap.

La correspondencia es lo ltimo que se hace en la cadena de eventos, cuando ya falta poco para que el
campo se almacene en la tabla interna en Qlik Sense. Esto significa que la correspondencia o mapeado no
se realiza cada vez que se encuentra un nombre de campo como parte de una expresin sino ms bien
cuando el valor se almacena bajo un nombre de campo en la tabla interna. Si es necesario asignar en el nivel
de expresin, la funcin Applymap() se tiene que utilizar en su lugar.

Argumentos:

Argumento Descripcin

*fieldlist Una lista de campos separados por coma, que debe hacerse corresponder desde este
punto del script. El asterisco * indica la totalidad de campos. Se permite la inclusin de
los caracteres comodn * y ? en los nombres de campo. Puede que sea necesario
entrecomillar los nombres de campo cuando se empleen caracteres comodn.

mapname Es el nombre de una tabla de correspondencia leda previamente en una sentencia


mapping load o mapping select.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 84


2 Sintaxis de script

Ejemplo Resultado

Map Country Using Permite hacer corresponder el campo Country mediante el mapa Cmap.
Cmap;

Map A, B, C Using X; Permite hacer corresponder los campos A, B y C mediante el mapa X.

Map * Using GenMap; Permite hacer corresponder todos los campos empleando GenMap.

NullAsNull
La sentencia NullAsNull deshabilita la conversin de valores NULL a valores de cadena previamente
establecidos por una sentencia NullAsValue.

Sintaxis:

NullAsNull *fieldlist

La sentencia NullAsValue opera como un conmutador y puede activarse o desactivarse mltiples veces en
el script, mediante una sentencia NullAsValue o una sentencia NullAsNull.

Argumentos:

Argumento Descripcin

*fieldlist Es una lista de campos separados por comas en los que se ha de aplicar NullAsNull. El
asterisco * indica la totalidad de campos. Se permite la inclusin de los caracteres
comodn * y ? en los nombres de campo. Puede que sea necesario entrecomillar los
nombres de campo cuando se empleen caracteres comodn.

Ejemplo:

NullAsNull A,B;
LOAD A,B from x.csv;

NullAsValue
La sentencia NullAsValue especifica para qu campos se debern convertir los valores NULL hallados en
valores.

Sintaxis:

NullAsValue *fieldlist

Por defecto, Qlik Sense considera los valores NULL como entidades inexistentes o no definidas. Sin
embargo, algunos contextos de bases de datos consideran estos valores NULL como valores especiales en
lugar de valores simplemente inexistentes. El hecho de que los valores NULL normalmente no se puedan
enlazar con otros valores NULL se puede evitar, mediante la sentencia NullAsValue.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 85


2 Sintaxis de script

La sentencia NullAsValue opera como un conmutador y funcionar en sucesivas sentencias de carga. Se


puede desactivar mediante la sentencia NullAsNull.

Argumentos:

Argumento Descripcin

*fieldlist Es una lista de campos separados por comas en los que se ha de aplicar NullAsValue. El
asterisco * indica la totalidad de campos. Se permite la inclusin de los caracteres
comodn * y ? en los nombres de campo. Puede que sea necesario entrecomillar los
nombres de campo cuando se empleen caracteres comodn.

Ejemplo:

NullAsValue A,B;
Set NullValue = 'NULL';
LOAD A,B from x.csv;

Qualify
La sentencia Qualify sirve para activar o desactivar la calificacin de nombres de campo, es decir, que los
nombres de campo recibirn el nombre de la tabla como prefijo.

Sintaxis:

Qualify *fieldlist

Es posible suspender el join automtico entre campos con el mismo nombre en tablas diferentes a travs de
la sentencia qualify, que califica el nombre de un campo con su nombre de la tabla correspondiente. Si
estn calificados, se renombrarn el/los nombre(s) del campo cuando se encuentre en una tabla. El nuevo
nombre ir expresado de la siguiente forma: tablename.fieldname. Tablename equivale a la etiqueta de la
tabla actual, o, si no hay etiqueta, al nombre que aparece tras from en sentencias LOAD y SELECT.

La calificacin se har para todos los campos cargados tras la sentencia qualify.

Por defecto, al iniciar la ejecucin de un script, est desactivada la calificacin. La calificacin de un nombre
de campo se puede activar en cualquier momento mediante una sentencia qualify. Y se puede desactivar
en cualquier momento empleando una sentencia Unqualify.

La sentencia qualify no debera emplearse junto con una recarga parcial.

Argumentos:

Argumento Descripcin

*fieldlist Es un listado de campos separados por comas en los que se ha de aplicar la cualificacin.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 86


2 Sintaxis de script

Argumento Descripcin

El asterisco * indica la totalidad de campos. Se permite la inclusin de los caracteres


comodn * y ? en los nombres de campo. Puede que sea necesario entrecomillar los
nombres de campo cuando se empleen caracteres comodn.

Ejemplo1:

Qualify B;
LOAD A,B from x.csv;
LOAD A,B from y.csv;
Las dos tablas x.csv y y.csv se asocian slo mediante A. Resultan tres campos: A, x.B, y.B.

Ejemplo2:

En una base de datos con la que no est familiarizado, puede que quiera empezar asegurndose de que slo
uno o unos pocos campos estn asociados, como se muestra en el ejemplo:

qualify *;
unqualify TransID;
SQL SELECT * from tab1;
SQL SELECT * from tab2;
SQL SELECT * from tab3;
Slo se emplear TransID para las asociaciones entre las tablas tab1, tab2 y tab3.

Rem
La sentencia rem se usa para insertar comentarios en el script o desactivar temporalmente sentencias de
script, sin eliminarlas.

Sintaxis:

Rem string

Todo lo que est entre rem y el siguiente punto y coma ; se considera que es un comentario.

Hay disponibles dos mtodos alternativos para hacer comentarios en el script:

1. Puede crear un comentario en cualquier lugar del script - excepto entre comillas - situando la seccin
en cuestin entre /* y */.
2. Cuando introduzca // en el script, todo el texto que vaya a la derecha en la misma fila se convertir en
un comentario. (Observe la excepcin //: que puede utilizarse como parte de una direccin de
Internet).

Argumentos:

Argumento Descripcin

string Es un texto cualquiera.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 87


2 Sintaxis de script

Ejemplo:

Rem ** This is a comment **;


/* This is also a comment */
// This is a comment as well

Rename field
Esta funcin de script renombra uno o varios campos de Qlik Sense tras haberlos cargado.

Puede utilizar cualquiera de estas sintaxis: rename field o rename fields.

Sintaxis:

Rename Field (using mapname | oldname to newname{ , oldname to newname })


Rename Fields (using mapname | oldname to newname{ , oldname to newname })

Argumentos:

Argumento Descripcin

mapname El nombre de una tabla de enlace previamente cargada que contiene uno o ms pares de
tablas antiguas y nuevas.

oldname El nombre del antiguo campo.

newname El nombre del nuevo campo.

Limitaciones:

Dos campos con diferente nombre no pueden renombrarse con un mismo nombre. El script se ejecutar sin
errores pero el segundo campo no se renombrar.

Ejemplo1:

Rename Field XAZ0007 to Sales;

Ejemplo2:

FieldMap:
Mapping SQL SELECT oldnames, newnames from datadictionary;
Rename Fields using FieldMap;

Rename table
Esta funcin de script renombra una o varias tablas internas de Qlik Sense tras haberlas cargado.

Puede utilizar cualquiera de estas sintaxis: rename table o rename tables.

Sintaxis:

Rename Table (using mapname | oldname to newname{ , oldname to newname })

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 88


2 Sintaxis de script

Rename Tables (using mapname | oldname to newname{ , oldname to newname })

Argumentos:

Argumento Descripcin

mapname El nombre de una tabla de enlace previamente cargada que contiene uno o ms pares de
tablas antiguas y nuevas.

oldname El nombre de la tabla antigua.

newname El nombre de la nueva tabla.

Limitaciones:

Dos tablas con distinto nombre no pueden renombrarse con un mismo nombre. El script se ejecutar sin
errores pero la segunda tabla no se renombrar.

Ejemplo1:

Tab1:
SELECT * from Trans;
Rename Table Tab1 to Xyz;

Ejemplo2:

TabMap:
Mapping LOAD oldnames, newnames from tabnames.csv;
Rename Tables using TabMap;

Search
La sentencia Search se utiliza para incluir o excluir campos en la funcin de herramienta de bsqueda.

Sintaxis:

Search Include *fieldlist


Search Exclude *fieldlist

Puede utilizar varias sentencias Search para refinar la seleccin de campos que se deben incluir. Las
sentencias se evalan de arriba a abajo.

Argumentos:

Argumento Descripcin

*fieldlist Lista separada por comas de los campos que se deben incluir o excluir de las bsquedas
en la herramienta global. El asterisco * indica la totalidad de campos. Se permite la
inclusin de los caracteres comodn * y ? en los nombres de campo. Puede que sea
necesario entrecomillar los nombres de campo cuando se empleen caracteres comodn.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 89


2 Sintaxis de script

Ejemplo:

Search Include *; Incluya todos los campos en bsquedas en la herramienta de


bsqueda.
Search Exclude *ID; Excluya todos los campos que terminen en ID de las bsquedas en la
herramienta de bsqueda.
Search Include ProductID; Incluya el campo ProductID en bsquedas en la herramienta de
bsqueda.

El resultado combinado de estas tres sentencias, en esta secuencia, es que todos los campos que terminen
con ID excepto ProductID se excluyen de bsquedas en la herramienta global.

Section
Con la sentencia section es posible definir si las sentencias subsiguientes LOAD y SELECT debern
considerarse como datos o como una definicin de derechos de acceso.

Sintaxis:

Section (access | application)

Si no se especifica nada, se asume section application. La definicin de section es vlida hasta que se
ejecute una nueva sentencia section.

Ejemplo:

Section access;
Section application;

Select
La seleccin de campos desde una fuente de datos ODBC o proveedor OLE DB se hace mediante
sentencias SQL SELECT estndar. Sin embargo, si las sentencias SELECT son aceptadas o no, depende
del driver ODBC o proveedor OLE DB empleado.

Sintaxis:

Select [all | distinct | distinctrow | top n [percent] ] *fieldlist

From tablelist

[where criterion ]

[group by fieldlist [having criterion ] ]

[order by fieldlist [asc | desc] ]

[ (Inner | Left | Right | Full) join tablename on fieldref = fieldref ]

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 90


2 Sintaxis de script

Adems, a veces se pueden concatenar varias sentencias SELECT en una sola mediante el uso de un
operador union:

selectstatement Union selectstatement

La sentencia SELECT es interpretada por el driver ODBC o proveedor OLE DB, as que podran ocurrir
desviaciones de la sintaxis SQL general dependiendo de las capacidades de los drivers ODBC o proveedor
OLE DB, por ejemplo:

l as a veces no se permite, aliasname debe ir inmediatamente despus de fieldname.


l as a veces es obligatorio si se usa un aliasname.
l distinct, as,where, group by, order by, o union a veces no se permiten.
l El driver ODBC a veces no acepta todos los tipos de comillas listados arriba.

Por favor, tenga en cuenta que no se trata de una descripcin completa de la sentencia SQL
SELECT. Por ej. Las sentencias SELECT pueden anidarse, pueden hacerse varios join en
una sentencia SELECT, el nmero de funciones permitidas en expresiones a veces es muy
grande, etc...

Argumentos:

Argumento Descripcin

distinct distinct es un predicado que se utiliza si las combinaciones duplicadas de valores en los
campos seleccionados slo debieran cargarse una vez.

distinctrow distinctrow es un predicado que se utiliza si los registros duplicados en la tabla de origen
slo debieran cargarse una vez.

*fieldlist *fieldlist ::= (*| field ) {, field }


Una lista de los campos que se van a seleccionar. El asterisco * indica la totalidad de
campos de la tabla.
fieldlist ::= field {, field }
Una lista de uno o ms campos, separados por comas.
field ::= ( fieldref | expression ) [as aliasname ]
La expresin puede ser una funcin numrica o de cadena basada en uno o varios
campos. Algunos de los operadores y funciones aceptados normalmente son: +, -, *, /, &
(concatenacin de cadenas),sum(fieldname), count(fieldname), avg(fieldname)(average),
month(fieldname), etc. Vase la documentacin del driver ODBC para ms informacin.
fieldref ::= [ tablename. ] fieldname
Las cadenas tablename y fieldname son cadenas de texto idnticas a lo que su propio
nombre indica. Deben estar entre comillas dobles rectas si contienen p.ej. espacios.
La clasula as clause sirve para asignar un nuevo nombre al campo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 91


2 Sintaxis de script

Argumento Descripcin

from tablelist ::= table {, table }

La lista de las tablas de las que se van a seleccionar los campos.

table ::= tablename [ [as ] aliasname ]

El tablename puede o no estar entre comillas.

where where es una clusula empleada para establecer si un registro debe ir incluido en la
seleccin o no.
criterion es una expresin lgica que a veces puede ser muy compleja. Algunos de los
operadores aceptados son: operadores numricos y funciones, =, <> o #(no igual), >, >=,
<, <=, and, or,not, exists,some, all,in y tambin nuevas sentencias SELECT. Vea la
documentacin del driver ODBC o proveedor OLE DB si desea ms informacin.

group by group by es una clusula que sirve para agregar (agrupar) varios registros en uno.
Dentro de un grupo, para un determinado campo, todos los registros deben tener el
mismo valor, o el campo slo podr utilizarse desde dentro de una expresin, p.ej. como
una suma o una media. La expresin basada en uno o varios campos se define en la
expresin del smbolo de campo.

having having es una clusula que sirve para calificar grupos de la misma manera que se usa la
clusula where para calificar registros.

order by order by es una clusula que se emplea para establecer el criterio de ordenacin de la
tabla resultante de la sentencia SELECT.

join join es un cualificador que establece si varias tablas se van a unir en una. Los nombres
de campo y los nombres de tabla deben estar entre comillas si contienen espacios en
blanco o letras de los juegos de caracteres nacionales. Cuando el script es generado
automticamente por Qlik Sense, las comillas empleadas sern las preferidas por el
driver ODBC u OLE DB, segn lo especificado en la definicin de la fuente de datos de la
sentencia Connect.

Ejemplo1:

SELECT * FROM `Categories`;

Ejemplo2:

SELECT `Category ID`, `Category Name` FROM `Categories`;

Ejemplo3:

SELECT `Order ID`, `Product ID`,


`Unit Price` * Quantity * (1-Discount) as NetSales
FROM `Order Details`;

Ejemplo4:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 92


2 Sintaxis de script

SELECT `Order Details`.`Order ID`,


Sum(`Order Details`.`Unit Price` * `Order Details`.Quantity) as `Result`
FROM `Order Details`, Orders
where Orders.`Order ID` = `Order Details`.`Order ID`
group by `Order Details`.`Order ID`;

Set
La sentencia set se utiliza para definir variables de script. stas pueden servir para sustituir cadenas, rutas,
unidades de disco, etc.

Sintaxis:

Set variablename=string

Ejemplo1:

Set FileToUse=Data1.csv;

Ejemplo2:

Set Constant="My string";

Ejemplo3:

Set BudgetYear=2012;

Sleep
La sentencia sleep detiene la ejecucin de script por un tiempo especificado.

Sintaxis:

Sleep n

Argumentos:

Argumento Descripcin

n Indicado en milisegundos, donde n es un entero positivo no mayor que 3600000 (esto es, 1
hora). El valor puede ser una expresin.

Ejemplo1:

Sleep 10000;

Ejemplo2:

Sleep t*1000;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 93


2 Sintaxis de script

SQL
La sentencia SQL permite lanzar un comando SQL a travs de una conexin ODBC u OLE DB.

Sintaxis:

SQL sql_command

El lanzamiento de sentencias SQL que actualizan la base de datos devolver un error si Qlik Sense ha
abierto la conexin ODBC en modo de solo lectura.

La sintaxis:

SQL SELECT * from tab1;


est permitida, y en documentacin futura ser la sintaxis preferida para SELECT, por razones de
coherencia. El prefijo SQL, sin embargo, ser opcional para sentencias SELECT.

Argumentos:

Argumento Descripcin

sql_command Un comando SQL vlido.

Ejemplo1:

SQL leave;

Ejemplo2:

SQL Execute <storedProc>;

SQLColumns
La sentencia sqlcolumns devuelve un conjunto de campos que describen las columnas de una fuente de
datos ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.

Sintaxis:

SQLcolumns

Los campos pueden combinarse con los campos generados por los comandos sqltables y sqltypes para
ofrecer una buena vista general de una determinada base de datos. Los doce campos estndar son:

TABLE_QUALIFIER

TABLE_OWNER

TABLE_NAME

COLUMN_NAME

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 94


2 Sintaxis de script

DATA_TYPE

TYPE_NAME

PRECISION

LENGTH

SCALE

RADIX

NULLABLE

REMARKS

Para una descripcin detallada de estos campos, consulte un manual de referencia de ODBC.

Ejemplo:

Connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd';


SQLcolumns;

Es posible que algunos drivers ODBC no admitan este comando. Algunos drivers ODBC
pueden crear campos adicionales.

SQLTables
La sentencia sqltables devuelve un conjunto de campos que describen las tablas de una fuente de datos
ODBC u OLE DB, a la que se ha hecho una conexin mediante connect.

Sintaxis:

SQLTables

Los campos pueden combinarse con los campos generados por los comandos sqlcolumns y sqltypes para
ofrecer una buena vista general de una determinada base de datos. Los cinco campos estndar son:

TABLE_QUALIFIER

TABLE_OWNER

TABLE_NAME

TABLE_TYPE

REMARKS

Para una descripcin detallada de estos campos, consulte un manual de referencia de ODBC.

Ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 95


2 Sintaxis de script

Connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd';


SQLTables;

Es posible que algunos drivers ODBC no admitan este comando. Algunos drivers ODBC
pueden crear campos adicionales.

SQLTypes
La sentencia sqltypes devuelve un conjunto de campos que describen los tipos de una fuente de datos
ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.

Sintaxis:

SQLTypes

Los campos pueden combinarse con los campos generados por los comandos sqlcolumns y sqltables para
ofrecer una buena vista general de una determinada base de datos. Los quince campos estndar son:

TYPE_NAME

DATA_TYPE

PRECISION

LITERAL_PREFIX

LITERAL_SUFFIX

CREATE_PARAMS

NULLABLE

CASE_SENSITIVE

SEARCHABLE

UNSIGNED_ATTRIBUTE

MONEY

AUTO_INCREMENT

LOCAL_TYPE_NAME

MINIMUM_SCALE

MAXIMUM_SCALE

Para una descripcin detallada de estos campos, consulte un manual de referencia de ODBC.

Ejemplo:

Connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd';

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 96


2 Sintaxis de script

SQLTypes;

Es posible que algunos drivers ODBC no admitan este comando. Algunos drivers ODBC
pueden crear campos adicionales.

Star
La cadena empleada para representar el conjunto de todos los valores de un campo en una base de datos
puede establecerse mediante la sentencia star. Afecta a las sentencias LOAD y SELECT subsiguientes.

Sintaxis:

Star is[ string ]

Argumentos:

Argumento Descripcin

string Es un texto cualquiera. Observe que la cadena debe estar entre comillas si contiene
espacios en blanco.

Si no se especifica nada, se presupone star is;, es decir, no hay smbolo star disponible a
menos que se especifique explcitamente. Esta definicin es vlida hasta que se ejecute
una nueva sentencia star.

Ejemplos:

Star is *;
Star is %;
Star is;

Store
Esta funcin de script crea un archivo QVD o un CSV.

Sintaxis:

Store[ *fieldlist from] table into filename [ format-spec ];

La sentencia crea un archivo explcito QVD o CSV. La sentencia slo puede exportar campos de una tabla
de datos. Si hay que exportar campos de varias tablas, se debe hacer previamente un join explcito en el
script para crear la tabla de datos que se ha de exportar.

Los valores de texto se exportan al archivo CSV en formato UTF-8. Se puede especificar un delimitador,
vase LOAD. La sentencia store a un archivo CSV no permite exportacin a BIFF.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 97


2 Sintaxis de script

Argumento Descripcin

*fieldlist::= ( * | field ) { , field } ) Una lista de los campos que se van a seleccionar. Usar un
asterisco * indica la totalidad de campos.

field::= fieldname [asaliasname ]

fieldname es un texto idntico a un nombre de campo en la


table. (Tenga en cuenta que el nombre de campo debe ir
entre comillas dobles rectas o corchetes si contiene por
ejemplo espacios u otros caracteres no estndar.)

aliasname es un nombre alternativo para el campo que ha de


usarse en el archivo QVD o CSV resultante.

table Es una tabla etiquetada en el script, ya cargada, que se usar


como fuente de datos.

filename El nombre del archivo destino como una conexin de datos de


carpetas.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten


tambin los diguientes formatos de ruta:

l absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

Si se omite la ruta, Qlik Sense almacenar el archivo


en el directorio especificado por la sentencia
Directory. Si no hay ninguna sentencia Directory,
Qlik Sense almacenar el archivo en el directorio de
trabajo, C:\Users\{user}
\Documents\Qlik\Sense\Apps.

format-spec ::=( (txt | qvd ) ) La especificacin de formato consiste en txt para los archivos
de texto, o el texto qvd para los archivos qvd. Si se omite la
especificacin de formato, se presupone qvd.

Ejemplo:

Store mytable into xyz.qvd (qvd);


Store * from mytable into xyz.qvd;
Store Name, RegNo from mytable into xyz.qvd;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 98


2 Sintaxis de script

Store Name as a, RegNo as b from mytable into xyz.qvd;


store mytable into myfile.txt (txt);
store * from mytable into 'lib://FolderConnection/myfile.qvd';

Los dos primeros ejemplos tienen una funcin idntica.

Tag
Esta funcin de script permite asignar etiquetas a uno o ms campos. Si se intenta etiquetar un nombre de
campo no presente en la app, se ignora el etiquetado. Si hubiera mltiples nombres de un mismo campo o
etiqueta, se emplear el ltimo valor.

Sintaxis:

Tag fields fieldlist using mapname


Tag field fieldname with tagname

Un campo etiquetado con dimension se mostrar en la parte superior de los controles de seleccin de todos
los campos en Qlik Sense, excepto en el dilogo Editar expresin.

Un campo etiquetado con measure se mostrar en la parte superior de todos los controles de seleccin de
campos del dilogo Editar Expresin.

Argumentos:

Argumento Descripcin

fieldlist Es una lista de campos separados por coma, que no deberan etiquetarse ms all del
punto marcado en el script.

mapname Es el nombre de una tabla de correspondencia leda previamente en una sentencia


mapping Load load o mapping Select select.

fieldname El nombre del campo que debera etiquetarse.

tagname Es el nombre de la etiqueta que debera aplicarse al campo.

Ejemplo1:

tagmap:
mapping LOAD * inline [
a,b
Alpha,MyTag
Num,MyTag
];
tag fields using tagmap;

Ejemplo2:

tag field Alpha with MyTag2;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 99


2 Sintaxis de script

Trace
La sentencia trace escribe una cadena en la ventana de Progreso de Ejecucin de Script y en el archivo
de registro (log) del script, cuando ste se utiliza. Es muy til cuando se desea efectuar una depuracin.
Mediante el empleo de expansiones de signo dlar de variables que se calculan antes de la sentencia trace,
podemos personalizar el mensaje.

Sintaxis:

Trace string

Ejemplo1:

Trace Main table loaded;

Ejemplo2:

Let MyMessage = NoOfRows('MainTable') & ' rows in Main Table';


Trace $(MyMessage);

Unmap
La sentencia Unmap deshabilita el enlace de un valor de campo especificado por una sentencia Map
Using anterior, para campos cargados en lo sucesivo.

Sintaxis:

Unmap *fieldlist

Argumentos:

Argumento Descripcin

*fieldlist es una lista separada por comas de los campos que ya no deberan enlazarse a partir de
este punto del script. El asterisco * indica la totalidad de campos. Se permite la inclusin
de los caracteres comodn * y ? en los nombres de campo. Puede que sea necesario
entrecomillar los nombres de campo cuando se empleen caracteres comodn.

Ejemplos y resultados:

Ejemplo Resultado

Unmap Country; Desactiva la correspondencia del campo Country.

Unmap A, B, C; Desactiva la correspondencia de los campos A, B y C.

Unmap * ; Impide enlaces de todos los campos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 100


2 Sintaxis de script

Unqualify
La sentencia Unqualify sirve para desactivar la calificacin de nombres de campo que ha sido previamente
activada mediante la sentencia Qualify.

Sintaxis:

Unqualify *fieldlist

Argumentos:

Argumento Descripcin

*fieldlist Es un listado de campos separados por comas en los que se ha de aplicar la cualificacin.
El asterisco * indica la totalidad de campos. Se permite la inclusin de los caracteres
comodn * y ? en los nombres de campo. Puede que sea necesario entrecomillar los
nombres de campo cuando se empleen caracteres comodn.

Para ms informacin le remitimos a la documentacin de la sentencia Qualify.

Ejemplo1:

Unqualify *;

Ejemplo2:

Unqualify TransID;

Untag Field
Es una opcin que permite eliminar etiquetas de uno o ms campos. Si se intenta desetiquetar un nombre
de campo no presente en la app, se ignora la accin de desetiquetar. Si hubiera mltiples nombres de un
mismo campo o etiqueta, se emplear el ltimo valor.

Sintaxis:

Untag fields fieldlist using mapname


Untag field fieldname with tagname

Argumentos:

Argumento Descripcin

fieldlist Un listado de campos separados por comas cuyas etiquetas se han de eliminar.

mapname Es el nombre de una tabla de correspondencia leda previamente en una sentencia


mapping LOAD o mapping SELECT .

fieldname El nombre del campo que debera desetiquetarse.

tagname Es el nombre de la etiqueta que debera eliminarse del campo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 101


2 Sintaxis de script

Ejemplo1:

tagmap:
mapping LOAD * inline [
a,b
Alpha,MyTag
Num,MyTag
];
Untag fields using tagmap;

Ejemplo2:

Untag field Alpha with MyTag2;];

2.4 Variables de script


Una variable en Qlik Sense es una entidad con nombre propio que contiene un valor de datos nico. Una
variable normalmente adquiere su valor de una sentencia Let, Set u otra sentencia de control. En general, el
usuario puede cambiar el valor de una variable en cualquier momento.

Las variables pueden contener datos numricos o alfanumricos. Si el primer carcter del valor de una
variable es un signo igual ' = ', Qlik Sense tratar de evaluar el valor como una frmula (o expresin de Qlik
Sense) y a continuacin mostrar o devolver el resultado en lugar del texto mismo de la frmula.

Cuando se emplea una variable, sta es sustituida por su valor. Las variables se pueden utilizar en el script
para expansin de signo dlar y en varias sentencias de control. Esto puede resultar de gran utilidad cuando
la misma cadena se repite muchas veces en el script, por ej. una ruta.

Hay algunas variables de sistema especiales que Qlik Sense fija al comienzo de la ejecucin de script,
independientemente de cules fueran sus valores previos.

Cuando se define una variable de script, la sintaxis:

set variablename = string


or

let variable = expression


se utiliza. El comando Set asigna el texto a la derecha del signo igual de la variable, mientras que el
comando Let evala la expresin.

Las variables son sensibles a maysculas.

Ejemplos:

set HidePrefix = $ ; // la variable recibir el carcterr "$" como valor.

let vToday = Num(Today()); // devuelve el nmero de serie de la fecha de hoy.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 102


2 Sintaxis de script

Clculo de variables
Hay varias maneras de utilizar variables con valores calculados en Qlik Sense y el resultado depende de
cmo se defina y de cmo se denomine en una expresin.

En este ejemplo cargamos algunos datos inline:

LOAD * INLINE [
Dim, Sales
A, 150
A, 200
B, 240
B, 230
C, 410
C, 330
];
Vamos a definir dos variables:

Let vSales = 'Sum(Sales)' ;


Let vSales2 = '=Sum(Sales)' ;
En la segunda variable, aadimos un signo igual antes de la expresin. De este modo la variable se calcular
antes de que se expanda y se evale la expresin.

Si se utiliza la variable vSales tal cual, como por ejemplo en una medida, el resultado ser la cadena Sum
(Sales), es decir, no se realiza ningn clculo.

Si se aade una expansin de signo dlar y se llama a $(vSales) en la expresin, la variable se expande y se
muestra la suma de Sales.

Por ltimo, si se llama a $(vSales2), la variable se calcular antes de que se expanda. Esto significa que el
resultado que se muestra es la suma total de Sales. La diferencia entre usar =$(vSales) y =$(vSales2) como
expresiones de medida puede apreciarse en este grfico, en el que se muestran los resultados:

Dim $(vSales) $(vSales2)

A 350 1560

B 470 1560

C 740 1560

Como se puede ver, $(vSales) da como resultado la suma parcial de un valor de dimensin, mientras que
$(vSales2) da como resultado la suma total.

Estn disponibles las siguientes variables de script:

Variables de error pgina 121

Variables de interpretacin numrica pgina 110

Variables de sistema pgina 104

Variables de manejo de valores pgina 108

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 103


2 Sintaxis de script

Variables de sistema
Las variables del sistema, algunas de las cuales estn definidas por el sistema, proporcionan informacin
sobre el sistema y la app de Qlik Sense.

Descripcin general de las variables de sistema


Algunas de las funciones se describen a continuacin tras la vista genrica. Para esas funciones, puede
hacer clic en el nombre de la funcin en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Floppy
Devuelve la letra de la primera unidad de disco que encuentra, normalmente a:. Esta es una variable
definida por el sistema.

Floppy

Esta variable no es posible en modo estndar.

CD
Devuelve la letra de la primera unidad de CD-ROM que encuentre. Si no encuentra ningn CD-ROM,
entonces devuelve c:. Esta es una variable definida por el sistema.

CD

Esta variable no es posible en modo estndar.

Include
La variable include especifica un archivo que contiene un texto que debe ser incluido en el script. As, el
script entero se puede incluir en un archivo. Esta es una variable definida por el usuario.

$(Include =filename)

HidePrefix
Todos los nombres de campo que comiencen por esta cadena de texto, se ocultarn de la misma manera
que los campos del sistema. Esta es una variable definida por el usuario.

HidePrefix

HideSuffix
Todos los nombres de campo que terminen con esta cadena de texto se ocultarn de la misma forma que los
campos de sistema. Esta es una variable definida por el usuario.

HideSuffix

QvPath
Devuelve la cadena de bsqueda al ejecutable de Qlik Sense: Esta es una variable definida por el sistema.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 104


2 Sintaxis de script

QvPath

Esta variable no es posible en modo estndar.

QvRoot
Devuelve el directorio raz del ejecutable de Qlik Sense: Esta es una variable definida por el sistema.

QvRoot

Esta variable no es posible en modo estndar.

QvWorkPath
Devuelve la cadena de bsqueda a la app actual de Qlik Sense. Esta es una variable definida por el sistema.

QvWorkPath

Esta variable no es posible en modo estndar.

QvWorkRoot
Devuelve el directorio raz de la app actual de Qlik Sense. Esta es una variable definida por el sistema.

QvWorkRoot

Esta variable no es posible en modo estndar.

StripComments
Si se fija esta variable en 0, se omitirn las lneas de comentario /*..*/ y // en el script. Si no se define esta
variable, las lneas de comentario se ejecutarn siempre.

StripComments

Verbatim
Normalmente todos los valores de campo son despojados automticamente de sus caracteres precedentes y
posteriores vacos (ASCII 32) antes de ser cargados en la base de datos de Qlik Sense. Si esta variable se
configura en 1, no se eliminarn estos caracteres vacos. El tabulador (ASCII 32) y el espacio fijo (ANSI 160)
nunca sufren esta accin.

Verbatim

OpenUrlTimeout
Esta variable define el tiempo de espera en segundos que Qlik Sense debe respetar cuando recibe datos
procedentes de fuentes URL (p. ej. pginas HTML). Si se omite, el tiempo establecido ser de unos 20
minutos.

OpenUrlTimeout

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 105


2 Sintaxis de script

WinPath
Devuelve la cadena de bsqueda a Windows. Esta es una variable definida por el sistema.

WinPath

Esta variable no es posible en modo estndar.

WinRoot
Devuelve el directorio raz de Windows. Esta es una variable definida por el sistema.

WinRoot

Esta variable no es posible en modo estndar.

CollationLocale
Especifica qu datos locales utilizar para el criterio de ordenacin y la correspondencia de bsquedas. El
valor es un nombre de tipo cultural relativo a un dato local, por ejemplo 'en-US'.Esta es una variable definida
por el sistema.

CollationLocale

HidePrefix
Todos los nombres de campo que comiencen por esta cadena de texto, se ocultarn de la misma manera
que los campos del sistema. Esta es una variable definida por el usuario.

Sintaxis:

HidePrefix

Ejemplo:

set HidePrefix='_' ;

Si se usa esta sentencia, los nombres de campo que comiencen con guin bajo no se mostrarn en las listas
de nombres de campo cuando los campos del sistema estn ocultos.

HideSuffix
Todos los nombres de campo que terminen con esta cadena de texto se ocultarn de la misma forma que los
campos de sistema. Esta es una variable definida por el usuario.

Sintaxis:

HideSuffix

Ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 106


2 Sintaxis de script

set HideSuffix='%';

Si se emplea esta sentencia, los nombres de campo que terminen con un signo de porcentaje no se
mostrarn en las listas de nombres de campo cuando los campos del sistema estn ocultos.

Include
La variable include especifica un archivo que contiene un texto que debe ser incluido en el script. As, el
script entero se puede incluir en un archivo. Esta es una variable definida por el usuario.

Esta variable admite nicamente conexiones de datos de carpetas en modo estndar.

Sintaxis:

$(Include =filename)

Ejemplo:

$(Include=abc.txt);
$(Include=lib:\\MyDataFiles\abc.txt);
Si no se especifica ninguna ruta, el nombre del archivo estar relacionado con el directorio de trabajo de la
app de Qlik Sense. Tambin puede especificar una ruta de archivo absoluta o una ruta a una conexin de
carpeta lib:\\.

No se puede aplicar la construccin set Include =filename.

OpenUrlTimeout
Esta variable define el tiempo de espera en segundos que Qlik Sense debe respetar cuando recibe datos
procedentes de fuentes URL (p. ej. pginas HTML). Si se omite, el tiempo establecido ser de unos 20
minutos.

Sintaxis:

OpenUrlTimeout

Ejemplo:

set OpenUrlTimeout=10

StripComments
Si se fija esta variable en 0, se omitirn las lneas de comentario /*..*/ y // en el script. Si no se define esta
variable, las lneas de comentario se ejecutarn siempre.

Sintaxis:

StripComments

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 107


2 Sintaxis de script

Determinados drivers de bases de datos utilizan /*..*/ como ayudas de optimizacin en sentencias SELECT.
Si este es el caso, los comentarios no deberan vaciarse antes de enviar la sentencia SELECT al driver de la
base de datos.

Se recomienda que esta variable se establezca en 1 inmediatamente por detrs de la(s)


sentencia(s) donde se necesite.

Ejemplo:

set StripComments=0;
SQL SELECT * /* <optimization directive> */ FROM Table ;
set StripComments=1;

Verbatim
Normalmente todos los valores de campo son despojados automticamente de sus caracteres precedentes y
posteriores vacos (ASCII 32) antes de ser cargados en la base de datos de Qlik Sense. Si esta variable se
configura en 1, no se eliminarn estos caracteres vacos. El tabulador (ASCII 32) y el espacio fijo (ANSI 160)
nunca sufren esta accin.

Sintaxis:

Verbatim

Ejemplo:

set Verbatim = 1;

Variables de manejo de valores


En esta seccin se describen las variables que se utilizan para la gestin de valores NULL y otros valores.

Descripcin general de las variables de manejo de valores


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

NullDisplay
El smbolo definido sustituir todos los valores NULL desde ODBC en el nivel ms bajo de los datos. Esta es
una variable definida por el usuario.

NullDisplay

NullInterpret
El smbolo definido ser interpretado como NULL cuando aparezca en un archivo de texto, archivo Excel o
en una sentencia inline. Esta es una variable definida por el usuario.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 108


2 Sintaxis de script

NullInterpret

NullValue
Si se utiliza la sentencia NullAsValue, el smbolo definido sustituir a todos los valores NULL en los
campos especificados con NullAsValue por la cadena especificada.

NullValue

OtherSymbol
Define un smbolo para que sea tratado como 'todos los dems valores' antes de una sentencia
LOAD/SELECT. Esta es una variable definida por el usuario.

OtherSymbol

NullDisplay
El smbolo definido sustituir todos los valores NULL desde ODBC en el nivel ms bajo de los datos. Esta es
una variable definida por el usuario.

Sintaxis:

NullDisplay

Ejemplo:

set NullDisplay='<NULL>';

NullInterpret
El smbolo definido ser interpretado como NULL cuando aparezca en un archivo de texto, archivo Excel o
en una sentencia inline. Esta es una variable definida por el usuario.

Sintaxis:

NullInterpret

Ejemplos:

set NullInterpret=' ';


set NullInterpret =;

NO devolver valores NULL para valores en blanco en Excel (pero lo har para un archivo de
texto csv)

set NullInterpret ='';

devolver valores NULL para valores en blanco en Excel (pero NO lo har para un archivo de
texto csv)

NullValue
Si se utiliza la sentencia NullAsValue, el smbolo definido sustituir a todos los valores NULL en los
campos especificados con NullAsValue por la cadena especificada.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 109


2 Sintaxis de script

Sintaxis:

NullValue

Ejemplo:

NullAsValue Field1, Field2;


set NullValue='<NULL>';

OtherSymbol
Define un smbolo para que sea tratado como 'todos los dems valores' antes de una sentencia
LOAD/SELECT. Esta es una variable definida por el usuario.

Sintaxis:

OtherSymbol

Ejemplo:

set OtherSymbol='+';
LOAD * inline
[X, Y
a, a
b, b];
LOAD * inline
[X, Z
a, a
+, c];
El valor de campo Y=b enlazar ahora con Z=c mediante el otro smbolo.

Variables de interpretacin numrica


Las siguientes variables vienen definidas por el sistema, es decir, se generan de forma automtica conforme
a la configuracin del sistema operativo al crear una nueva app. Las variables de interpretacin numrica se
incluyen en la parte superior del script de la nueva app de Qlik Sense y pueden sustituir los ajustes
predefinidos del sistema operativo para cierto nmero de configuraciones de formato en el momento de la
ejecucin del script. Pueden eliminarse, editarse o duplicarse libremente.

Descripcin general de las variables de interpretacin numrica


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Formato de moneda
MoneyDecimalSep
El separador de decimales definido reemplaza al smbolo decimal para moneda del sistema operativo
(configuracin regional).

MoneyDecimalSep

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 110


2 Sintaxis de script

MoneyFormat
El smbolo definido reemplaza el smbolo de moneda del sistema operativo (configuracin regional).

MoneyFormat

MoneyThousandSep
El separador de miles definido reemplaza el smbolo de agrupacin de dgitos para moneda del sistema
operativo (configuracin regional).

MoneyThousandSep

Formato numrico
DecimalSep
El separador de decimales reemplaza al smbolo decimal del sistema operativo (configuracin regional).

DecimalSep

ThousandSep
El separador de miles definido reemplaza al smbolo de agrupacin de dgitos del sistema operativo
(configuracin regional).

ThousandSep

Formato de tiempo
DateFormat
El formato definido reemplaza al formato de fecha del sistema operativo (configuracin regional).

DateFormat

TimeFormat
El formato definido reemplaza el formato de hora del sistema operativo (configuracin regional).

TimeFormat

TimestampFormat
El formato definido reemplaza los formatos de fecha y hora del sistema operativo (configuracin Regional).

TimestampFormat

MonthNames
El formato definido reemplaza los nombres de los meses del sistema operativo (configuracin regional).

MonthNames

LongMonthNames
El formato definido reemplaza los nombres completos de meses del sistema operativo (configuracin
regional).

LongMonthNames

DayNames

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 111


2 Sintaxis de script

El formato definido reemplaza a los nombres de los das de la semana del sistema operativo (configuracin
regional).

DayNames

LongDayNames
El formato definido reemplaza los nombres completos de das de la semana del sistema operativo
(configuracin regional).

LongDayNames

FirstWeekDay
La El nmero entero define qu da se utilizar como primer da de la semana.

FirstWeekDay

BrokenWeeks
La configuracin define si las semanas estn interrumpidas o no.

BrokenWeeks

ReferenceDay
La configuracin define qu da de enero se establece como da de referencia para definir la semana 1.

ReferenceDay

FirstMonthOfYear
El parmetro define qu mes usar como primer mes del ao, lo cual puede servir para definir aos
financieros que utilicen un desplazamiento mensual, por ejemplo, con inicio el 1 de abril.

Parmetros vlidos son 1 (enero) a 12 (diciembre). El parmetro por defecto es 1.

Sintaxis:

FirstMonthOfYear

Ejemplo:

Set FirstMonthOfYear=4; //Sets the year to start in April

BrokenWeeks
La configuracin define si las semanas estn interrumpidas o no.

Sintaxis:

BrokenWeeks
Por defecto, las funciones de Qlik Sense utilizan semanas ininterrumpidas. Esto significa que:

l En algunos aos, la semana 1 empieza en diciembre y, en otros, la semana 52 o 53 contina en


enero.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 112


2 Sintaxis de script

l La semana 1 siempre incluye 4 das de enero como mnimo.

La alternativa consiste en utilizar semanas interrumpidas.

l La semana 52 o 53 no contina en enero.


l La semana 1 empieza el 1 de enero y, en la mayora de los casos, no es una semana completa.

Se pueden utilizar los siguientes valores:

l 0 (= se utilizan semanas ininterrumpidas)


l 1 (= se utilizan semanas interrumpidas)

Ejemplos:

Set BrokenWeeks=0; //(use unbroken weeks)


Set BrokenWeeks=1; //(use broken weeks)

DateFormat
El formato definido reemplaza al formato de fecha del sistema operativo (configuracin regional).

Sintaxis:

DateFormat

Ejemplos:

Set DateFormat='M/D/YY'; //(US format)


Set DateFormat='DD/MM/YY'; //(UK date format)
Set DateFormat='YYYY-MM-DD'; //(ISO date format)

DayNames
El formato definido reemplaza a los nombres de los das de la semana del sistema operativo (configuracin
regional).

Sintaxis:

DayNames

Ejemplo:

Set DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';

DecimalSep
El separador de decimales reemplaza al smbolo decimal del sistema operativo (configuracin regional).

Sintaxis:

DecimalSep

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 113


2 Sintaxis de script

Ejemplos:

Set DecimalSep='.';
Set DecimalSep=',';

FirstWeekDay
La El nmero entero define qu da se utilizar como primer da de la semana.

Sintaxis:

FirstWeekDay
Por defecto, las funciones de Qlik Sense utilizan el lunes como primer da de la semana. Se pueden utilizar
los siguientes valores:

l 0 (= lunes)
l 1 (= martes)
l 2 (= mircoles)
l 3 (= jueves)
l 4 (= viernes)
l 5 (= sbado)
l 6 (= domingo)

Ejemplos:

Set FirstWeekDay=6; //(set Sunday as the first day of the week)

LongDayNames
El formato definido reemplaza los nombres completos de das de la semana del sistema operativo
(configuracin regional).

Sintaxis:

LongDayNames

Ejemplo:

Set LongDayNames='Monday;Tuesday;Wednesday;Thursday;Friday;Saturday;Sunday';

LongMonthNames
El formato definido reemplaza los nombres completos de meses del sistema operativo (configuracin
regional).

Sintaxis:

LongMonthNames

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 114


2 Sintaxis de script

Ejemplo:

Set LongMonthNames='January;February;March;April;May;June - -

MoneyDecimalSep
El separador de decimales definido reemplaza al smbolo decimal para moneda del sistema operativo
(configuracin regional).

Sintaxis:

MoneyDecimalSep

Ejemplo:

Set MoneyDecimalSep='.';

MoneyFormat
El smbolo definido reemplaza el smbolo de moneda del sistema operativo (configuracin regional).

Sintaxis:

MoneyFormat

Ejemplo:

Set MoneyFormat='$ #,##0.00; ($ #,##0.00)';

MoneyThousandSep
El separador de miles definido reemplaza el smbolo de agrupacin de dgitos para moneda del sistema
operativo (configuracin regional).

Sintaxis:

MoneyThousandSep

Ejemplo:

Set MoneyThousandSep=',';

MonthNames
El formato definido reemplaza los nombres de los meses del sistema operativo (configuracin regional).

Sintaxis:

MonthNames

Ejemplo:

Set MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 115


2 Sintaxis de script

ReferenceDay
La configuracin define qu da de enero se establece como da de referencia para definir la semana 1.

Sintaxis:

ReferenceDay
Por defecto, las funciones de Qlik Sense utilizan 4 como da de referencia. Esto significa que la semana 1
debe incluir el 4 de enero o, dicho de otro modo, que la semana 1 siempre debe incluir 4 das de enero como
mnimo.

Se pueden utilizar los siguientes valores para establecer un da de referencia diferente:

l 1 (= 1 de enero)
l 2 (= 2 de enero)
l 3 (= 3 de enero)
l 4 (= 4 de enero)
l 5 (= 5 de enero)
l 6 (= 6 de enero)
l 7 (= 7 de enero)

Ejemplos:

Set ReferenceDay=3; //(set January 3 as the reference day)

ThousandSep
El separador de miles definido reemplaza al smbolo de agrupacin de dgitos del sistema operativo
(configuracin regional).

Sintaxis:

ThousandSep

Ejemplos:

Set ThousandSep=','; //(for example, seven billion must be specified as: 7,000,000,000)
Set ThousandSep=' ';

TimeFormat
El formato definido reemplaza el formato de hora del sistema operativo (configuracin regional).

Sintaxis:

TimeFormat

Ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 116


2 Sintaxis de script

Set TimeFormat='hh:mm:ss';

TimestampFormat
El formato definido reemplaza los formatos de fecha y hora del sistema operativo (configuracin Regional).

Sintaxis:

TimestampFormat

Ejemplo:

Set TimestampFormat='M/D/YY hh:mm:ss[.fff]';

Variables de Direct Discovery


Variables de sistema de Direct Discovery
DirectCacheSeconds
Podemos poner un lmite de cach a los resultados de la consulta efectuada a Direct Discovery en grficos.
Una vez que se haya alcanzado este lmite, Qlik Sense borrar la cach cuando se hagan nuevas consultas
de Direct Discovery. Qlik Sense consulta a la fuente de datos las selecciones realizadas y crea la cach de
nuevo segn el lmite de tiempo designado. El resultado de cada combinacin de selecciones se enva a
cach por separado. Es decir, la cach se actualiza con cada seleccin de manera independiente, de modo
que una seleccin actualiza la cach solo para los campos seleccionados, y una segunda seleccin actualiza
la cach en sus campos relevantes. Si la segunda seleccin incluye campos que se actualizaron en la
primera seleccin, no se actualizarn en la cach de nuevo si no se ha alcanzado el lmite de envo a cach.

La cach de Direct Discovery no se aplica a las visualizaciones de Tabla. Las selecciones de tabla consultan
la fuente de datos constantemente.

El valor lmite debe fijarse en segundos. El lmite de la cach por defecto es de 1800 segundos (30 minutos).

El valor utilizado para DirectCacheSeconds es el valor establecido en el momento en que se ejecuta la


sentencia DIRECT QUERY. El valor no puede cambiarse en tiempo de ejecucin.

Ejemplo:

SET DirectCacheSeconds=1800

DirectConnectionMax
Podemos hacer llamadas paralelas, asncronas, a la base de datos, empleando la funcin de conexin
directa. La sintaxis de script de carga para configurar la capacidad de conexin directa es la siguiente:

SET DirectConnectionMax=10
El parmetro numrico especifica el nmero mximo de conexiones a la base de datos que el cdigo Direct
Discovery debera emplear mientras actualiza los objetos de una hoja. El parmetro predeterminado es 1.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 117


2 Sintaxis de script

Esta variable debera utilizarse con cuidado. Si se configura en mayor que 1 esto sabemos que
dar problemas al conectar a Microsoft SQL Server.

DirectUnicodeStrings
Direct Discovery admite la seleccin de datos Unicode ampliados, utilizando el formato SQL estndar para
literales de cadenas de caracteres ampliadoas (Ncadena ampliada) tal y como lo requieren algunas bases
de datos, sobre todo SQL Server. El uso de esta sintaxis puede activarse para Direct Discovery mediante la
variable de script DirectUnicodeStrings.

Fijar esta variable en 'true' (verdadero) habilitar el uso del marcador de caracteres ANSI del estndar N
frente a los literales de cadena. No todas las bases de datos admiten este estndar. El parmetro
predeterminado es 'false', 'falso'.

DirectDistinctSupport
Cuando se selecciona el valor de un campo DIMENSION en un objeto Qlik Sense, se genera una consulta
para la base de datos fuente. Cuando la consulta requiere agrupamiento, Direct Discovery usa la palabra
clave DISTINCT para seleccionar solo valores nicos. Algunas bases de datos, no obstante, requieren la
palabra clave GROUP BY. Fije DirectDistinctSupport en "false" para generar GROUP BY en lugar de
DISTINCT en consultas de valores nicos.

SET DirectDistinctSupport=false
Si se fija DirectDistinctSupported como verdadero, entonces se utiliza DISTINCT. Si no se fija, el
comportamiento predeterminado supone emplear DISTINCT.

Variables de Teradata query banding


Teradata query banding es una funcin que permite a las aplicaciones de empresa colaborar con la base de
datos Teradata subyacente para ofrecer una mejor contabilidad, priorizacin y gestin de la carga de trabajo.
Utilizando query banding podemos incluir metadatos, como por ejemplo unas credenciales de usuario, en
una consulta.

Hay dos variables disponibles, ambas son cadenas que se evalan y envan a la base de datos.

SQLSessionPrefix
Esta cadena se enva al crear una conexin a la base de datos.

SET SQLSessionPrefix = 'SET QUERY_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) & ' FOR
SESSION;';
Si OSuser() por ejemplo devuelve WA\sbt, esto devolver SET QUERY_BAND = 'Who=WA\sbt;' FOR SESSION;, lo
cual es enviado a la base de datos al crearse la conexin.

SQLQueryPrefix
Esta cadena se enva con cada consulta en particular.

SET SQLSessionPrefix = 'SET QUERY_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) &
' FOR TRANSACTION;';

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 118


2 Sintaxis de script

Variables de carcter de Direct Discovery


DirectFieldColumnDelimiter
Podemos fijar el carcter empleado como delimitador de campos en sentencias Direct Query para bases de
datos que requieran un carcter distinto de la coma como delimitador de campos. El carcter especificado
debe ir rodeado de smbolos de entrecomillado simple en la sentencia SET.

SET DirectFieldColumnDelimiter= '|'

DirectStringQuoteChar
Podemos especificar un carcter para usar el entrecomillado de cadenas en una consulta generada. La
opcin predefinida es un entrecomillado simple. El carcter especificado debe ir rodeado de smbolos de
entrecomillado simple en la sentencia SET.

SET DirectStringQuoteChar= '"'

DirectIdentifierQuoteStyle
Podemos especificar que se utilice entrecomillado no ANSI en los identificadores en las consultas
generadas. Hoy por hoy, el nico entrecomillado no ANSI disponible es GoogleBQ. El valor predeterminado
es ANSI. Se pueden utilizar maysculas, minsculas y caracteres combinados (ANSI, ansi, Ansi).

SET DirectIdentifierQuoteStyle="GoogleBQ"
Por ejemplo, el entrecomillado ANSI se emplea en la sentencia SELECT a continuacin:

SELECT [Quarter] FROM [qvTest].[sales] GROUP BY [Quarter]


Cuando DirectIdentifierQuoteStyle est fijado en "GoogleBQ", la sentencia SELECT utilizar las comillas
del siguiente modo:

SELECT [Quarter] FROM [qvTest.sales] GROUP BY [Quarter]

DirectIdentifierQuoteChar
Podemos especificar un carcter para controlar el entrecomillado de identificadores en una consulta
generada. Esto se puede fijar o bien en un carcter (como un smbolo de entrecomillado doble) o dos (como
un par de corchetes). La opcin predeterminada es un entrecomillado doble.

SET DirectIdentifierQuoteChar='YYYY-MM-DD'

DirectTableBoxListThreshold
Cuando se utilizan campos Direct Discovery en una visualizacin de Tabla, se establece un umbral o lmite
para limitar el nmero de filas mostradas. El lmite por defecto es de 1000 registros. El parmetro del lmite
predefinido se puede modificar configurando la variable DirectTableBoxListThreshold en el script de
carga. Por ejemplo:

SET DirectTableBoxListThreshold=5000
El parmetro del lmite se aplica nicamente a visualizaciones de Tabla que contengan campos de Direct
Discovery. Las visualizaciones de Tabla que contienen campos solo en memoria no estn limitadas por el
parmetro DirectTableBoxListThreshold.

No se mostrar ningn campo en la visualizacin de Tabla hasta que la seleccin contenga menos registros
que el lmite del umbral.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 119


2 Sintaxis de script

Variables de interpretacin numrica de Direct Discovery


DirectMoneyDecimalSep
El separador decimal definido reemplaza al smbolo decimal de moneda en la sentencia SQL generada para
cargar datos utilizando Direct Discovery. Este carcter debe coincidir con el carcter utilizado en
DirectMoneyFormat.

El valor por defecto es '.'

Ejemplo:

Set DirectMoneyDecimalSep='.';

DirectMoneyFormat
El smbolo definido reemplaza al formato de moneda de la sentencia SQL generada para cargar datos
utilizando Direct Discovery. El smbolo de moneda para el separador de miles no debera incluirse.

El valor por defecto es '#.0000'

Ejemplo:

Set DirectMoneyFormat='#.0000';

DirectTimeFormat
El formato de hora definido reemplaza al formato de hora de la sentencia SQL generada para cargar datos
utilizando Direct Discovery.

Ejemplo:

Set DirectTimeFormat='hh:mm:ss';

DirectDateFormat
El formato de fecha definido reemplaza al formato de fecha de la sentencia SQL generada para cargar datos
con Direct Discovery.

Ejemplo:

Set DirectDateFormat='MM/DD/YYYY';

DirectTimeStampFormat
El formato definido reemplaza al formato de fecha y hora de la sentencia SQL generada para cargar datos
con Direct Discovery.

Ejemplo:

Set DirectTimestampFormat='M/D/YY hh:mm:ss[.fff]';

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 120


2 Sintaxis de script

Variables de error
Los valores de las cinco variables en total sobrevivirn a la ejecucin del script. La primera variable,
ErrorMode, la introduce el usuario, y las tres ltimas las produce Qlik Sense con informacin sobre errores en
el script.

Descripcin general de las variables de error


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

ErrorMode
Esta variable de error establece qu accin llevar a cabo Qlik Sense cuando encuentre un error durante la
ejecucin de script.

ErrorMode

ScriptError
Esta variable de error devuelve el cdigo de error de la ltima sentencia ejecutada en el script.

ScriptError

ScriptErrorCount
Esta variable de error devuelve el nmero total de sentencias que han producido errores durante la actual
ejecucin de script. Esta variable siempre se pone a 0 al principio de la ejecucin del script.

ScriptErrorCount

ScriptErrorList
Esta variable de error contiene una lista concatenada de todos los errores de script que hayan ocurrido
durante la ltima ejecucin de script. Cada error va separado por una lnea.

ScriptErrorList

ErrorMode
Esta variable de error establece qu accin llevar a cabo Qlik Sense cuando encuentre un error durante la
ejecucin de script.

Sintaxis:

ErrorMode

Argumentos:

Argumento Descripcin

ErrorMode=1 El parmetro por defecto. La ejecucin del script se interrumpir y se instar al usuario a
actuar (en modo no por lotes).

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 121


2 Sintaxis de script

Argumento Descripcin

ErrorMode Qlik Sense simplemente ignorar el error y continuar la ejecucin del script con la
=0 siguiente sentencia de script.

ErrorMode Qlik Sense disparar un mensaje de error "Fall la ejecucin de script..." en el momento
=2 justo en que se produce el fallo, sin instar al usuario a actuar de antemano.

Ejemplo:

set ErrorMode=0;

ScriptError
Esta variable de error devuelve el cdigo de error de la ltima sentencia ejecutada en el script.

Sintaxis:

ScriptError

Esta variable ser reestablecida a 0 tras cada sentencia de script ejecutada correctamente. Si ocurre un
error, ser configurada segn un cdigo de error interno de Qlik Sense. Los cdigos de error son valores
duales con un componente numrico y otro de texto. Los siguientes cdigos existen:

Cdigo
Descripcin
de error

0 Sin Error

1 Error general

2 Error de sintaxis

3 Error general de ODBC

4 Error general de OLE


DB

5 Error general en la Base


de Datos Personalizada

6 Error general de XML

7 Error general de HTML

8 No se encontr el
archivo

9 No se encontr la base
de datos

10 No se encontr la tabla

11 No se encontr el

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 122


2 Sintaxis de script

Cdigo
Descripcin
de error

campo

12 Archivo con formato


incorrecto

13 Error de BIFF

14 Error de BIFF cifrado

15 Error de BIFF de
versin no compatible

16 Error semntico

Ejemplo:

set ErrorMode=0;
LOAD * from abc.qvf;
if ScriptError=8 then
exit script;
//no file;
end if

ScriptErrorCount
Esta variable de error devuelve el nmero total de sentencias que han producido errores durante la actual
ejecucin de script. Esta variable siempre se pone a 0 al principio de la ejecucin del script.

Sintaxis:

ScriptErrorCount

ScriptErrorList
Esta variable de error contiene una lista concatenada de todos los errores de script que hayan ocurrido
durante la ltima ejecucin de script. Cada error va separado por una lnea.

Sintaxis:

ScriptErrorList

2.5 Expresiones de script


Las expresiones pueden usarse tanto en la sentencia LOAD como en la sentencia SELECT. La sintaxis y
las funciones que se describen aqu se refieren a la sentencia LOAD y no a la sentencia SELECT, ya que
esta ltima la interpretar el driver ODBC y no Qlik Sense. Sin embargo, la mayora de los drivers ODBC
son, por lo general, capaces de interpretar las diversas funciones descritas a continuacin.

Las expresiones se componen de funciones, campos y operadores, combinados en una sintaxis.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 123


2 Sintaxis de script

Todas las expresiones de un script de Qlik Sense devuelven un nmero y/o una cadena, segn corresponda.
Las funciones lgicas y los operadores devuelven 0 para False y -1 para True. Las conversiones de nmero a
cadena y viceversa estn implcitas. Los operadores lgicos y las funciones interpretan 0 como False y todo
lo dems como True.

La sintaxis general para una expresin es la siguiente:

expression ::= (constant constant |


fieldref |
operator1 expression |
expression operator2 expression |
function |
(expression ) )

donde:

constant es una cadena (un texto, fecha u hora) entre comillas simples, o un nmero. Las constantes se
escriben sin separadores de miles y con un punto decimal como separador decimal.

fieldref es un nombre de campo de la tabla cargada.

operator1 es un operador unitario (que opera con una expresin, la de la derecha).

operator2 es un operador binario (que opera con dos expresiones, una a cada lado).

function ::= functionname( parameters)

parameters ::= expression { , expression }

El nmero y los tipos de parmetros no son aleatorios. Dependen de la funcin empleada.

Las expresiones y funciones pueden por tanto anidarse libremente, y siempre y cuando la expresin devuelva
un valor interpretable, Qlik Sense no emitir ningn mensaje de error.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 124


3 Expresiones de visualizacin

3 Expresiones de visualizacin
Una expresin es una combinacin de funciones, campos y operadores matemticos (+ * / =). Las
expresiones se utilizan para procesar los datos de una app y producir un resultado visible en una
visualizacin. Las expresiones no se limitan al uso en medidas. Podemos crear visualizaciones ms potentes
y dinmicas, con expresiones para ttulos, subttulos, pies de pgina e incluso dimensiones.

Esto implica, por ejemplo, que en lugar de que el ttulo de una visualizacin sea texto esttico, puede estar
formado por una expresin cuyo resultado vare en funcin de las selecciones realizadas.

Para obtener informacin ms detallada sobre las funciones de script y las funciones de
grfico, consulte la ayuda online de Qlik Sense.

Vea tambin:

p Expresiones de script (pgina 123)

3.1 Definir el mbito de agregacin


Por norma general, hay dos restricciones distintas que, de forma conjunta, determinan qu registros son
relevantes para una agregacin, es decir:

l El valor de dimensin (si la agregacin se realiza en un grfico)


l Seleccin

Estas restricciones combinadas definen el mbito de agregacin. Pueden producirse situaciones en las que
le interese que en el clculo se omita la seleccin, las dimensiones o ambas. En las funciones de grfico ello
se puede lograr si se utiliza el cualificador TOTAL, el anlisis de conjuntos o una combinacin del
cualificador TOTAL y el anlisis de conjuntos.

Mtodo Descripcin

Cualificador Si se utiliza el cualificador total en la funcin de agregacin, se omite el valor de


TOTAL dimensin.

La agregacin se realizar en todos los campos posibles. valores.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares. Estos nombres de campo deberan ser un subgrupo de las
variables de dimensin del grfico. En este caso, el clculo se realiza ignorando todas las
variables de dimensin del grfico excepto las listadas, es decir, que devolver un valor por
cada combinacin de valores de campo de los campos de dimensin listados. Tambin los
campos que no constituyan actualmente una dimensin de un grfico pueden incluirse en
la lista. Esto puede resultar til en el caso de dimensiones de grupo, en las que los campos

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 125


3 Expresiones de visualizacin

Mtodo Descripcin

de dimensin no son fijos. Listar todas las variables del grupo har que la funcin opere
correctamente cuando el nivel jerrquico vare.

Anlisis de Si se usa el anlisis de conjuntos en la agregacin, se omite la seleccin. La agregacin se


conjuntos realizar en todos los valores repartidos por las dimensiones.

Cualificador Si se usa el anlisis de conjuntos en la agregacin, se omite la seleccin y las dimensiones.


TOTAL y
anlisis de
Este mtodo se corresponde al uso del cualificador ALL.
conjuntos

Ejemplo: Cualificador TOTAL

En el ejemplo siguiente se muestra cmo el cualificador TOTALse puede utilizar para calcular una
proporcin relativa Si suponemos que se ha seleccionado Q2, al usar TOTALse calcular la suma de todos
los valores omitiendo las dimensiones.

Year Quarter Sum(Amount) Sum(TOTAL Amount) Sum(Amount)/Sum(TOTAL Amount)

3000 3000 100%

2012 T2 1700 3000 56,7%

2013 T2 1300 3000 43,3%

Para mostrar los nmeros como porcentaje, en el panel de propiedades, en la medida que
desea que se muestre como valor de porcentaje, en Formato numrico, seleccione Nmero
y desde Formato, elija Simple junto con uno de los formatos de %.

Ejemplo: Anlisis de conjuntos

En el ejemplo siguiente se muestra cmo se puede utilizar el anlisis de conjuntos para comparar conjuntos
de datos antes de efectuar cualquier seleccin. Si suponemos que se ha seleccionado Q2 al usar el anlisis
de conjuntos con la definicin de conjunto {1] se calcular la suma de todos los valores omitiendo cualquier
seleccin pero dividida por las dimensiones.

Year Quarter Sum(Amount) Sum({1} Amount) Sum(Amount)/Sum({1} Amount)

3000 10800 27,8%

2012 T1 0 1100 0%

2012 T3 0 1400 0%

2012 T4 0 1800 0%

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 126


3 Expresiones de visualizacin

Year Quarter Sum(Amount) Sum({1} Amount) Sum(Amount)/Sum({1} Amount)

2012 T2 1700 1700 100%

2013 T1 0 1000 0%

2013 T3 0 1100 0%

2013 T4 0 1400 0%

2013 T2 1300 1300 100%

Ejemplo: Cualificador TOTAL y anlisis de conjuntos

En el ejemplo siguiente se muestra cmo se pueden combinar el anlisis de conjuntos y el cualificador


TOTAL para comparar conjuntos de datos antes de efectuar cualquier seleccin y en todas las dimensiones.
Si suponemos que se ha seleccionado Q2 al usar el anlisis de conjuntos con la definicin de conjunto {1] y
el cualificador TOTAL se calcular la suma de todos los valores omitiendo cualquier seleccin y las
dimensiones.

Sum Sum({1} TOTAL Sum(Amount)/Sum({1} TOTAL


Year Quarter
(Amount) Amount) Amount)

3000 10800 27,8%

2012 T2 1700 10800 15,7%

2013 T2 1300 10800 12%

Datos empleados en los ejemplos:

AggregationScope:
LOAD * inline [
Year Quarter Amount
2012 Q1 1100
2012 Q2 1700
2012 Q3 1400
2012 Q4 1800
2013 Q1 1000
2013 Q2 1300
2013 Q3 1100
2013 Q4 1400] (delimiter is ' ');

3.2 Analizar conjuntos de datos - Anlisis de conjuntos


Las funciones de agregacin por defecto agregan sobre la seleccin actual de valores de campo. Nos
podemos referir a la seleccin actual como un conjunto de valores de campo. Podemos definir otros
conjuntos de valores de campo y utilizarlos en nuestras visualizaciones en lugar de la seleccin actual. Por
ejemplo, es posible que, en un cuadro de mando, desee mostrar la cuota de mercado de un determinado
producto en todas las regiones, con independencia de las selecciones actuales.

A la definicin de un conjunto de valores de campo se la conoce como "definicin de una expresin de


conjunto" y el uso de las expresiones de conjunto para analizar datos se denomina "anlisis de conjuntos".

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 127


3 Expresiones de visualizacin

Las expresiones de conjunto solo estn disponibles para visualizaciones (no en scripts).

Las expresiones de conjunto siempre comienzan y terminan en corchetes. Por ejemplo, sum({1} Sales)
donde {1} es una expresin de conjunto.

Construir una expresin de conjunto


En una expresin de conjunto debemos identificar siempre cmo se relaciona el conjunto de valores de
campo que estamos definiendo con el campo o expresin que estemos evaluando. Por ejemplo, estamos
evaluando el conjunto completo de valores de campo o la inversa de la seleccin actual? Tras haber
identificado esta relacin podemos modificar la seleccin de valores dentro del campo (esto es opcional).

Dicho brevemente, una expresin de conjunto incluye un identificador y un modificador opcional. Los
modificadores van separados de los identificadores mediante parntesis angulares, de la siguiente manera:

{set_identifier<set_modifier>}

Podemos utilizar operadores en ambos identificadores y modificadores para manipular las relaciones de
campo y las selecciones. De manera adicional, Qlik Sense nos permite combinar los modificadores con
expansiones de signo de dlar, bsquedas avanzadas y definiciones de campos implcitos, tal como se
describe en los temas siguientes.

Ejemplo:

Para entender bien las cuestiones bsicas de las expresiones de conjuntos, veamos un ejemplo de uso.
Queremos crear un cuadro de mando que muestre las visualizaciones siguientes de ventas de valores en
USA:

1. El total de ventas en USA por grupo de producto independientemente de la seleccin actual


2. Las ventas en USA por grupo de producto teniendo en cuenta la seleccin actual

Nuestros datos de ventas son globales pero se dividen por Region. Los grupos de producto se encuentran en
el campo ProductGroup mientras que los valores de ventas se encuentran en el campo Sales.

En circunstancias normales podramos crear una visualizacin con la dimensin ProductGroup y la medida
sum(Sales). Las selecciones del usuario en Region y ProductGroup determinaran entonces lo que se va a
mostrar. Sin embargo aqu lo que queremos es que la visualizacin (1) superior muestre siempre la misma
regin y selecciones y la visualizacin (2) muestre siempre la misma regin. Vamos a expresar lo que
queremos ver en cada visualizacin mediante una expresin de conjunto:

1. set_expression={todas las Sales <de Region USA>}


2. set_expression={seleccin actual de Sales< de Region USA>}

Teniendo en cuenta que:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 128


3 Expresiones de visualizacin

l el cualificador de " all" es 1


l el cualificador de current selection es $
l La sintaxis de los modificadores en este caso es set_modifier = <field_name={field_
value,[field_value]}

Obtenemos las siguientes medidas para nuestras visualizaciones empleando expresiones de conjunto:

1. sum({1<Region={USA}>} Sales)
2. sum({$<Region={USA}>} Sales)

Identificadores de conjunto
Los identificadores de conjunto definen la relacin entre la expresin de conjunto y los valores de campo o
expresin que se est evaluando.

Los identificadores de conjunto pueden combinarse utilizando operadores de conjuntos.

Identificador Descripcin

1 Representa el conjunto completo de todos los registros de la aplicacin.

$ Representa los registros de la seleccin actual.

La expresin de conjunto {$} es por tanto equivalente a no declarar una expresin de


conjunto.

{1-$} es la ms interesante, puesto que define lo inverso de la seleccin


actual, esto es, todo lo que la seleccin actual excluye.

$N Las selecciones de la pila Atrs pueden utilizarse como identificadores de conjuntos, por
medio del signo dlar: $1 representa la seleccin previa, esto es, la equivalente a pulsar
el botn Atrs.

Cualquier entero sin signo puede utilizarse en la notacin Atrs. $0 representa la


seleccin actual.

$_N Las selecciones de la pila Adelante pueden utilizarse como identificadores de conjuntos,
por medio del signo dlar: $_1 representa un paso hacia adelante, esto es, equivale a
pulsar el botn Atrs.

Cualquier entero sin signo puede utilizarse en la notacin Adelante. $0 representa la


seleccin actual.

bookmark_id | Se pueden utilizar marcadores de servidor y de app como identificadores de conjunto. Se


bookmark_ puede emplear el ID o el nombre del marcador. Por ejemplo BM01o MyBookMark.
name
nicamente se utiliza la parte de la seleccin de un marcador. Los valores no se incluyen.
Por lo tanto no es posible utilizar campos de entrada en los marcadores para el anlisis
de conjuntos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 129


3 Expresiones de visualizacin

Ejemplos y resultados:

Ejemplos Resultados

sum({$} Sales ) Devuelve las ventas de la seleccin actual, es decir, lo mismo que sum(Sales)

sum({$1} Sales ) Devuelve las ventas de la seleccin anterior.

sum({$_2} Sales ) Devuelve las ventas de la segunda seleccin siguiente, esto es, de dos pasos hacia
delante. Slo tiene sentido si se efectuaron dos operaciones hacia Atrs.

sum({1} Sales ) Devuelve el total de ventas de la aplicacin, descartando la seleccin pero no la


dimensin. Si se utiliza en un grfico con Products, por ejemplo, como
dimensin, cada producto recibir un valor diferente.

sum({1} Total Sales Devuelve el total de ventas de la aplicacin, descartando tanto la seleccin como
) la dimensin, es decir, lo mismo que sum(All Sales).

sum({BM01} Sales Devuelve las ventas del marcador BM01.


)

sum({MyBookMark} Devuelve las ventas del marcador MyBookMark.


Sales )

sum({Server\BM01} Devuelve las ventas del marcador de servidor BM01.


Sales)

sum Devuelve las ventas del marcador de la app MyBookMark.


({App\MyBookmark}
Sales)

Vea tambin:

p Operadores de conjunto (pgina 130)

Operadores de conjunto
Hay diversos operadores de conjunto que se pueden utilizar en las expresiones de conjunto. Todos los
operadores de conjunto emplean conjuntos como operandos y devuelven un conjunto como resultado.

El orden de precedencia es el siguiente:

1. Menos unario (complementario)


2. Interseccin y Diferencia simtrica
3. Unin y Exclusin.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 130


3 Expresiones de visualizacin

Dentro de un grupo,la expresin se evala de izquierda a derecha. Se pueden definir rdenes alternativos
mediante el uso de parntesis estndar, los cuales pueden ser necesarios porque los operadores de
conjuntos no conmutan. Por ejemplo, A+(B-C) es diferente de (A+B)-C el cual a su vez es diferente de (A-
C)+B.

El uso de operadores de conjuntos junto con expresiones bsicas de agregacin que incluyan
campos procedentes de mltiples tablas de Qlik Sense puede acarrear resultados
impredecibles y debera evitarse. Por ejemplo, si Quantity y Price son campos de distintas
tablas, entonces la expresin sum({$*BM01}Quantity*Price) debera evitarse.

Argumentos:

Operador Descripcin

+ Unin. Esta operacin binaria devuelve un conjunto compuesto por los registros que
pertenecen a cualquiera de los dos operandos de conjunto.

- Exclusin. Esta operacin binaria devuelve un conjunto formado por los registros que
pertenecen al primero, pero no al segundo, de los operandos de conjunto. Adems, cuando
se emplee como operador unario, devuelve el otro conjunto complementario.

* Interseccin. Esta operacin binaria devuelve un conjunto formado por los registros que
pertenecen a ambos operandos de conjunto.

/ Diferencia simtrica (XOR). Esta operacin binaria devuelve un conjunto formado por los
registros que pertenecen a cualquiera, pero no ambos, de los operandos de conjunto.

Ejemplos y resultados:

Ejemplos Resultados
sum( {1-$} Sales ) Devuelve las ventas de todo lo excluido por la seleccin actual.
sum( {$*BM01} Sales ) Returns sales for the intersection between the current selection and bookmark
BM01
sum( {-($+BM01)} Sales Devuelve las ventas excluidas por la seleccin actual y el marcador BM01.
)

Modificadores de conjunto
Un conjunto puede modificarse mediante una seleccin adicional o una modificada. Dicha modificacin se
puede escribir en la expresin de conjunto.

El modificador consta de uno o varios nombres de campo, cada uno de ellos seguido por una seleccin que
debera efectuarse en el campo, todo ello enmarcado por signos de comillas angulares < >. Por ejemplo:
<Year={2007,+2008},Region={US}>. Los nombres de campo y los valores de campo pueden registrarse de la
forma habitual, por ejemplo, <[Sales Region]={West coast, South America}>.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 131


3 Expresiones de visualizacin

Se puede utilizar un modificador de conjuntos en un identificador de conjuntos o por s solo. No puede


emplearse en una expresin de conjunto. Cuando se utiliza en un identificador de conjuntos, el modificador
deber escribirse inmediatamente tras el identificador de conjunto, por ej. {$<Year = {2007, 2008}>}.
Cuando se emplea por s solo, se interpreta como una modificacin de la seleccin actual.

Hay varias formas de describir la seleccin, tal como se define a continuacin.

Basada en otro campo


Una forma simple sera realizar una seleccin basada en los valores seleccionados de otro campo, por ej.
<OrderDate = DeliveryDate> Este modificador tomar los valores seleccionados de DeliveryDatey los
aplicar como seleccin a OrderDate. Si hay muchos valores distintos, ms de varios cientos, entonces esta
operacin consume mucha CPU y debera evitarse.

Basada en conjuntos de elementos (una lista de valores de campo en el


modificador)
El caso ms habitual es una seleccin basada en una lista de valores de campo encerrada entre llaves y con
los valores separados por comas, por ej. <Year = {2007, 2008}>. Las llaves aqu definen un conjunto de
elementos, donde stos pueden referirse, o bien a valores de campo, o a bsquedas de valores de campo.
Una bsqueda siempre viene definida por el empleo de comillas dobles, por ej. <Ingredient = {"*Garlic*"}>
seleccionar todas las recetas que incluyan la cadena 'garlic' (ajo). Las bsquedas no son sensibles a
maysculas y tambin se realizan sobre los valores excluidos.

Los conjuntos vacos de elementos, bien de forma explcita, por ej. <Product = {}>, o de forma implcita, por
ej. <Product = {"Perpetuum Mobile"}> (una bsqueda sin resultados) implican cero productos, esto es,
devolvern un conjunto de registros no asociados a producto alguno. Observe que este conjunto no se puede
lograr por medio de las selecciones habituales, a menos que se efecte una seleccin en otro campo, por ej.
TransactionID.

Exclusin forzada
Finalmente, para campos en modo and, hay tambin la posibilidad de una exclusin forzada. Si desea forzar
la exclusin de valores especficos de campo, necesitar emplear "~" frente al nombre de campo.

Ejemplos y resultados:

Ejemplos Resultados
sum( devuelve las ventas en la regin USA, descartando la seleccin actual.
{1<Region=
{USA} >} Sales
)

sum( {$<Region Devuelve las ventas de la seleccin actual, pero eliminando la seleccin de "Region".
= >} Sales )

sum({<Region Devuelve lo mismo que el ejemplo inmediatamente anterior. Cuando se omite el


= >} Sales ) modificador de conjuntos, se presupone $.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 132


3 Expresiones de visualizacin

Ejemplos Resultados

La sintaxis de los dos ejemplos anteriores se interpreta como "cero


selecciones" en "Region", esto es, todas las regiones incluidas en otras
selecciones sern posibles. No es equivalente a la sintaxis <Region = {}>
(ni a ningn otro texto a la derecha del signo igual, devolviendo
implcitamente un conjunto de elementos vaco), lo cual se interpreta
como sin regin.

sum({$<Year = Devuelve las ventas de la seleccin actual, pero con nuevas selecciones tanto en
{2000}, Region " Year" como en " Region".
= {US, SE, DE,
UK, FR}>}
Sales )

sum( Devuelve las ventas de la seleccin actual, pero con una exclusin forzada de todos los
{$<~Ingredient ingredientes que contengan la cadena " garlic".
= {*garlic*}>}
Sales )

sum({$<Year = Devuelve las ventas de la seleccin actual, pero con todos los aos que empiecen por
{2*}>} Sales ) el dgito 2, es decir, del 2000 en adelante, seleccionados en el campo " Year".

sum({$<Year = Igual que el anterior, pero ahora la dcada de los 80 se incluye en la seleccin.
{2*,198*}>}
Sales )

sum({$<Year = Igual que el anterior, pero ahora con una bsqueda numrica, de forma que se pueda
{>1978<2004} especificar un rango arbitrario.
>} Sales )

Modificadores de conjunto con operadores de conjunto


La seleccin dentro de un campo puede definirse empleando operadores de conjunto y trabajando en
diversos conjuntos de elementos. Por ejemplo: el modificador <Year = {"20*", 1997} - {2000}>
seleccionar todos los aos que comienzan por 20 adems de 1997, excepto 2000.

Ejemplos y resultados:

Ejemplos Resultados

sum({$<Product = Devuelve las ventas de la seleccin actual, pero con el producto "OurProduct1"
Product + aadido a la lista de productos seleccionados y "OurProduct2" eliminado de la lista
{OurProduct1} de productos seleccionados.
{OurProduct2} >}
Sales )

sum({$<Year = Devuelve las ventas de la seleccin actual, pero con selecciones adicionales en el

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 133


3 Expresiones de visualizacin

Ejemplos Resultados

Year + ({20*,1997} campo Year: 1997 y todos los que comienzan por 20, excepto 2000.
{2000}) >} Sales )
Observe que si se incluye 2000 en la seleccin actual, se incluir todava tras la
modificacin.

sum({$<Year = Devuelve prcticamente lo mismo que el anterior, pero en este caso se excluir el
(Year + 2000, incluso si estuviera inicialmente incluido en la seleccin actual. El ejemplo
{20*,1997}) muestra la importancia de utilizar en ocasiones los parntesis, que ayudan a
{2000} >} Sales ) definir un orden de prioridad.

sum({$<Year = {*} Devuelve las ventas de la seleccin actual, pero con una nueva seleccin en
{2000}, Product = "Year": todos los aos, excepto el 2000; y solo para productos que contengan la
{*bearing*} >} cadena bearing.
Sales )

Modificadores de conjunto con tareas de operadores de conjunto implcitos


Esta notacin define nuevas selecciones, descartando la seleccin actual efectuada en el campo. No
obstante, si desea basar su seleccin en la seleccin actual del campo y aadir valores de campo, puede que
le convenga un modificador <Year = Year + {2007, 2008}>. Una forma ms corta pero equivalente de
escribir esto es la siguiente:<Year += {2007, 2008}>, es decir, el operador de asignacin define una unin de
forma implcita. Las intersecciones implcitas, exclusiones y diferencias simtricas tambin se pueden definir
empleando *=, = y /=.

Ejemplos y resultados:

Ejemplos Resultados

sum({$<Product += Devuelve las ventas de la seleccin actual, pero empleando una unin implcita
{OurProduct1, para aadir los productos "OurProduct1" y "OurProduct2" a la lista de productos
OurProduct2} >} Sales seleccionados.
)

sum({$<Year += Devuelve las ventas de la seleccin actual, pero utilizando una unin implcita
{20*,1997} {2000} para aadir un determinado nmero de aos a la seleccin: 1997 y todos los que
>} Sales ) comienzan por 20 pero no el 2000.

Observe que si se incluye 2000 en la seleccin actual, se incluir todava tras la


modificacin. Igual que <Year=Year + ({20*,1997}{2000})>.

sum({$<Product *= Devuelve las ventas de la seleccin actual, pero solo para la interseccin de
{OurProduct1} >} productos actualmente seleccionados y el producto OurProduct1.
Sales )

Modificadores de conjunto con bsquedas avanzadas


En la definicin de conjuntos se pueden utilizar bsquedas avanzadas empleando comodines y
agregaciones.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 134


3 Expresiones de visualizacin

Ejemplos y resultados:

Ejemplos Resultados

sum({$1<Product = Devuelve las ventas de la seleccin actual, excluyendo aquellas


{*Internal*, *Domestic*}>} transacciones que pertenecen a productos con la cadena "Internal" o
Sales ) "Domestic" en el nombre del producto.

sum({$<Customer = {=Sum Devuelve las ventas de la seleccin actual, pero con una nueva seleccin
({1<Year = {2007}>} Sales ) en el campo "Customer": solo los clientes que durante el ao 2007
> 1000000}>} Sales ) tuvieron unas ventas totales superiores a 1000000.

Modificadores de conjunto con expansiones signo dolar


Se pueden emplear variables y otras expansiones de signo dolar en las expresiones de conjunto.

Ejemplos y resultados:

Ejemplos Resultados

sum({$<Year = Devuelve las ventas del ao anterior en relacin con la seleccin actual. Aqu, se
{$(#vLastYear)}>} utiliza una variable vLastYear con el ao en cuestin en una expansin de signo
Sales ) dlar.

sum({$<Year = Devuelve las ventas del ao anterior en relacin con la seleccin actual. Aqu se
{$(#=Only(Year)-1)} utiliza una expansin signo dlar para calcular el ao anterior.
>} Sales )

Modificadores de conjunto con definiciones de valores de campo implcitas


Lo siguiente describe cmo podemos definir un conjunto de valores de campo empleando una definicin de
conjunto anidada.

En tales casos, se han de emplear las funciones de elementos P() y E(), las cuales representan el conjunto
de elementos de valores posibles y valores excluidos de un campo, respectivamente. Dentro de los
parntesis, se puede especificar una expresin de conjunto y un campo, por ej. P({1} Customer). Estas
funciones no podrn emplearse en otras expresiones:

Ejemplos y resultados:

Ejemplos Resultados

sum( Devuelve las ventas de la seleccin actual, pero solo con aquellos clientes que alguna
{$<Customer vez han suministrado el producto "Shoe". La funcin de elemento P() aqu devuelve una
=P lista de posibles clientes, aquellos implcitos por la seleccin "Shoe" en el campo
({1<Product= Product.
{Shoe}>}
Customer)>}

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 135


3 Expresiones de visualizacin

Ejemplos Resultados

Sales )

sum( Igual que el anterior. Si se omite el campo en la funcin de elemento, la funcin


{$<Customer devolver los valores posibles del campo especificados en la asignacin externa.
=P
({1<Product=
{Shoe}>})>}
Sales )

sum( Devuelve las ventas de la seleccin actual, pero slo con aquellos clientes que alguna
{$<Customer vez han suministrado el producto Shoe (Zapato). La funcin de elemento P() aqu
=P devuelve una lista de posibles proveedores, aquellos implcitos por la seleccin "Shoe"
({1<Product= en el campo Product. La lista de proveedores se utiliza entonces como una seleccin en
{Shoe}>} el campo Customer.
Supplier)>}
Sales )

sum( Devuelve las ventas de la seleccin actual, pero slo con aquellos clientes que nunca
{$<Customer han comprado el producto "Shoe". La funcin de elemento E() aqu devuelve una lista
=E de clientes excluidos, aquellos excluidos por la seleccin "Shoe" en el campo Product.
({1<Product=
{Shoe}>})>}
Sales )

Sintaxis para conjuntos


La sintaxis completa (sin incluir el uso opcional de parntesis estndar para definir la precedencia) se
describe mediante el formalismo Backus-Naur:

set_expression ::= { set_entity { set_operator set_entity } }


set_entity ::= set_identifier [ set_modifier ]
set_identifier ::= 1 | $ | $N | $_N | bookmark_id | bookmark_name
set_operator ::= + | - | * | /
set_modifier ::= < field_selection {, field_selection } >
field_selection ::= field_name [ = | += | = | *= | /= ] element_set_
expression
element_set_expression ::= element_set { set_operator element_set }
element_set ::= [ field_name ] | { element_list } | element_function
element_list ::= element { , element }
element_function ::= ( P | E ) ( [ set_expression ] [ field_name ] )
element ::= field_value | " search_mask "

Vea tambin:

p Qu es el formalismo Backus-Naur? (pgina 13)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 136


3 Expresiones de visualizacin

3.3 Sintaxis
La sintaxis empleada para expresiones de grficos y agregaciones se describe en las secciones siguientes.

Sintaxis general para expresiones de grficos


expression ::= (constant |

expressionname |

operator1 expression |

expression operator2 expression |

function |

aggregation function |

(expression ) )

donde:

constant es una cadena (un texto, fecha u hora) entre comillas simples, o un nmero. Las constantes se
escriben sin separador de miles y con un punto decimal como separador decimal.

expressionname es el nombre (etiqueta) de otra expresin en el mismo grfico.

operator1 es un operador unitario (que opera con una expresin, la de la derecha).

operator2 es un operador binario (que opera con dos expresiones, una a cada lado).

function ::= functionname ( parameters )


parameters ::= expression { , expression }
El nmero y los tipos de parmetros no son aleatorios. Dependen de la funcin empleada.

aggregationfunction ::= aggregationfunctionname ( parameters2 )


parameters2 ::= aggrexpression { , aggrexpression }
El nmero y los tipos de parmetros no son aleatorios. Dependen de la funcin empleada.

Vea tambin:

p Operadores (pgina 139)

Sintaxis general para agregaciones:


aggrexpression ::= (fieldref |

operator1 aggrexpression |

aggrexpression operator2 aggrexpression |

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 137


3 Expresiones de visualizacin

functioninaggr |

(aggrexpression ) )

fieldref es un nombre de campo.

functionaggr ::= functionname ( parameters2 )


Las expresiones y funciones pueden anidarse libremente y, mientras que fieldref est siempre dentro de una
sola funcin de agregacin y la expresin devuelva un valor interpretable, Qlik Sense no emitir ningn
mensaje de error.

Vea tambin:

p Operadores (pgina 139)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 138


4 Operadores

4 Operadores
Esta seccin describe los operadores que se pueden utilizar en Qlik Sense. Hay dos tipos de operadores:

l Operadores unarios (toman slo un operando)


l Operadores binarios (toman dos operandos)

La mayora de los operadores son binarios.

Se pueden definir los siguientes operadores:

l Operadores de bit
l Operadores lgicos
l Operadores Numricos
l Operadores relacionales
l Operadores de cadena

4.1 Operadores de bit


Todos los operadores de bit convierten (truncan) los operandos en enteros con signo (32 bits) y devuelven el
resultado de la misma forma. Todas las operaciones se realizan bit a bit. Si un operando no puede
interpretarse como un nmero, la operacin devolver NULL.

bitnot Bit Operador unitario. La operacin devuelve el inverso del operando ejecutado bit a bit.
inverso.
Ejemplo:

bitnot 17 devuelve -18

bitand Bit and. La operacin devuelve el AND lgico de los operandos ejecutados bit a bit.

Ejemplo:

17 bitand 7 devuelve 8

bitor Bit or. La operacin devuelve el OR lgico de los operandos ejecutados bit a bit.

Ejemplo:

17 bitor 7 devuelve 23

bitxor Bit or La operacin devuelve el OR lgico exclusivo o de los operandos, ejecutado bit a bit.
exclusivo.
Ejemplo:

17 bitxor 7 devuelve 22

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 139


4 Operadores

>> Bit right La operacin devuelve el primer operando desplazado un paso a la derecha. El
shift. nmero de pasos se define en el segundo operando.

Ejemplo:

8 >> 2 devuelve 2

<< Bit left La operacin devuelve el primer operando desplazado a la izquierda. El nmero de
shift. pasos se define en el segundo operando.

Ejemplo:

8 << 2 devuelve 32

4.2 Operadores lgicos


Todos los operadores lgicos interpretan los operandos de forma lgica y devuelven True (-1) o False (0)
como resultado.

not Lgica inversa. Uno de los pocos operadores unitarios. La operacin devuelve
la lgica inversa del operando.

and And lgico. La operacin devuelve el and lgico de los operandos.

or Or lgico. La operacin devuelve el or lgico de los operandos.

Xor Or lgico exclusivo. La operacin devuelve el or lgico exclusivo de los


operandos. Por ejemplo, acta igual que el or lgico pero con la diferencia de
que el resultado es False si ambos operandos son True.

4.3 Operadores numricos


Todos los operadores numricos usan los valores numricos de los operandos y devuelven un valor numrico
como resultado.

+ Signo para nmero positivo (operador unitario) o suma aritmtica. La


operacin binaria devuelve la suma de los dos operandos.

- Signo para nmero negativo (operador unitario) o substraccin aritmtica. La


operacin unitaria devuelve el operando multiplicado por -1, y la operacin
binaria la diferencia entre los dos operadores.

* Multiplicacin aritmtica. La operacin devuelve el producto de los dos


operandos.

/ Divisin aritmtica. La operacin devuelve el resto entre dos operandos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 140


4 Operadores

4.4 Operadores relacionales


Todos los operadores relacionales comparan los valores de los operandos y devuelven True (-1) o False (0)
como resultado. Todos los operadores relacionales son binarios.

< Menor que Se hace una comparacin numrica si ambos operadores pueden
ser interpretados numricamente. La operacin devuelve el valor
lgico de la evaluacin de la comparacin.

<= Menor o Se hace una comparacin numrica si ambos operadores pueden


igual que ser interpretados numricamente. La operacin devuelve el valor
lgico de la evaluacin de la comparacin.

> Mayor que Se hace una comparacin numrica si ambos operadores pueden
ser interpretados numricamente. La operacin devuelve el valor
lgico de la evaluacin de la comparacin.

>= Mayor o Se hace una comparacin numrica si ambos operadores pueden


igual que ser interpretados numricamente. La operacin devuelve el valor
lgico de la evaluacin de la comparacin.

= Igual Se hace una comparacin numrica si ambos operadores pueden


ser interpretados numricamente. La operacin devuelve el valor
lgico de la evaluacin de la comparacin.

<> Distinto Se hace una comparacin numrica si ambos operadores pueden


ser interpretados numricamente. La operacin devuelve el valor
lgico de la evaluacin de la comparacin.

precedes Menor que A diferencia del operador < no se intenta hacer una interpretacin
(ASCII) numrica de los valores del argumento antes de la comparacin. La
operacin devuelve true si el valor de la izquierda del operador tiene
una representacin de texto, la cual en una comparacin ASCII,
viene antes de la representacin de texto del valor de la derecha.

Ejemplo:

' 11' precedes ' 2' devuelve True

compare esto con:

' 11' < ' 2' devuelve False

follows Mayor que A diferencia del operador > no se intenta hacer una interpretacin
(ASCII) numrica de los valores del argumento antes de la comparacin. La
operacin devuelve verdadero si el valor de la izquierda del
operador tiene una representacin de texto, la cual, en una
comparacin ASCII, viene despus de la representacin de texto
del valor de la derecha.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 141


4 Operadores

Ejemplo:

' 23' follows ' 111' devuelve True

compare esto con:

' 23' > ' 111' devuelve False

4.5 Operadores de cadena


Hay dos operadores de cadena. Uno utiliza los valores cadena de los operandos y devuelve una cadena
como resultado. El otro compara los operandos y devuelve un valor booleano que indica la correspondencia.

& Concatenacin de cadenas. La operacin devuelve una cadena de texto, que


consiste en los dos operandos, uno tras otro.

Ejemplo:
'abc' & 'xyz' devuelve 'abcxyz'

like Comparacin de cadenas con caracteres comodn. La operacin devuelve un


True booleano (-1) si la cadena antes del operador se corresponde con la
cadena que hay tras el operador. La segunda cadena puede contener los
caracteres comodn * (cualquier nmero de caracteres arbitrarios) o ? (un
carcter cualquiera).

Ejemplo:
'abc' like 'a*' devuelve True (-1)
'abcd' like 'a?c*' devuelve True (-1)
'abc' like 'a??bc' devuelve False (0)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 142


5 Funciones en scripts y en expresiones de grfico

5 Funciones en scripts y en expresiones de


grfico
Esta seccin describe las funciones que se pueden utilizar en scripts de carga de datos Qlik Sense y en
expresiones de grficos para transformar y agregar datos.

Muchas funciones se pueden utilizar de idntica manera tanto en scripts de carga de datos como en
expresiones de grficos, pero hay algunas excepciones:

l Algunas funciones slo se pueden utilizar en scripts de carga de datos, vienen especificadas como:
funcin de script.
l Algunas funciones slo se pueden utilizar en expresiones de grficos, vienen especificadas como:
funcin de grfico.
l Algunas funciones se pueden utilizar tanto en scripts de carga de datos como en expresiones de
grficos, pero hay diferencias en los parmetros y aplicacin. Estas se describen aparte, en otros
temas, especificadas como funcin de script o funcin de grfico.

5.1 Funciones de agregacin


Una funcin de agregacin agrega sobre el conjunto de registros posibles definidos por la seleccin y
devuelve un solo valor que describe una propiedad de varios registros de los datos, como por ejemplo una
suma o un recuento.

La mayora de funciones de agregacin pueden utilizarse tanto en el script de carga de datos como en las
expresiones de grficos, pero la sintaxis difiere.

Uso de las funciones de agregacin en el script de carga de datos


Las funciones de agregacin solo se pueden utilizar en listas de campos para sentencias LOAD con una
clusula group by.

Uso de las funciones de agregacin en expresiones de grficos


La expresin del argumento de una funcin de agregacin no deber contener otra funcin de agregacin.

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Una funcin de agregacin agrega sobre el conjunto de registros posibles definidos por la seleccin. Se
puede definir no obstante un conjunto alternativo de registros utilizando una expresin de conjunto.

Aggr - funcin de grfico


Aggr() devuelve una matriz de valores de la expresin calculada sobre las dimensiones. La funcin Aggr se
utiliza para agregaciones avanzadas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 143


5 Funciones en scripts y en expresiones de grfico

Las funciones bsicas de agregacin, como Sum, Min y Avg, devuelven un nico valor numrico, mientras
que el resultado de una funcin de agregacin avanzada puede compararse con una tabla simple temporal
que puede utilizarse en los grficos. Para obtener una agregacin final de esta tabla temporal, la funcin
Aggr debera colocarse dentro de una funcin de agregacin bsica, por ejemplo, Sum, Max o Count.

Al emplear esta funcin en dimensiones calculadas, se puede obtener la agregacin de


grficos anidada en mltiples niveles.

Sintaxis:

Aggr({[DISTINCT] [NODISTINCT ]} expr, dim{, Expression})

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin.

dim Campo nico. No puede ser una expresin.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

DISTINCT Si el argumento de la expresin va precedido por el cualificador distinct o si no se utiliza


cualificador alguno, cada combinacin distinta de valores de dimensin generar
nicamente un solo valor de retorno. Esta es la forma habitual de hacer agregaciones:
cada combinacin distinta de valores de dimensin generar una lnea del grfico.

NODISTINCT Si el argumento de la expresin va precedido por el cualificador nodistinct, cada


combinacin de valores de dimensin puede generar ms de un valor de retorno,
dependiendo de la estructura de datos subyacente. Si slo hay una dimensin, la funcin
aggr devolver un conjunto con el mismo nmero de elementos como filas en los datos
fuente.

Limitaciones:

Cada dimensin debe estar constituida por un nico campo y no puede ser una expresin (dimensin
calculada).

Ejemplos y resultados:

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 144


5 Funciones en scripts y en expresiones de grfico

Customer Product UnitSales UnitPrice

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Betacab DD 25 25

Canutility AA 8 15

Canutility CC - 19

Cree una tabla con Customer, Product, UnitPrice y UntiSales como dimensiones.

Ejemplo Resultado
Aggr(Max Un conjunto de valores: 16, 20, 15 y 25 La expresin halla el mximo UnitPrice por
(UnitPrice),
Customer.
Customer)

La agregacin Max(UnitPrice) produce un resultado para cada Product por Customer.


Utilizando esta expresin como el argumento expr en la funcin Aggr() y Customer como
el argumento dim, podemos hallar el resultado de Max(UnitPrice) por Customer.
Min(Aggr(Max 15. La expresin halla el mximo UnitPrice por Customer, y halla el valor mnimo del
(UnitPrice),
resultado.
Customer))

Utilizando la expresin Aggr como entrada de la funcin Min(), se halla el valor mnimo
del conjunto producido por Aggr(). Efectivamente, al encerrar la funcin Aggr() en otra
agregacin, hemos construido una lista temporal de valores sin tener que crear un grfico
aparte que contenga dichos valores.
Aggr Un conjunto de valores: 16, 16, 16, 25, 25, 25, 15, 15, 25 y 25. El cualificador nodistinct
(NODISTINCT
indica que el conjunto contiene un elemento por cada fila de datos fuente: cada uno es el
Max
(UnitPrice),
mximo UnitPrice de cada Customer y Product.
Customer)

Datos empleados en los ejemplos:

Temp:
LOAD * inline [
Customer Product UnitSales UnitPrice
Astrida AA 4 16
Astrida AA 10 15
Astrida BB 9 9
Betacab BB 5 10
Betacab CC 2 20
Betacab DD 1 25 25
Canutility AA 8 15
Canutility CC 19

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 145


5 Funciones en scripts y en expresiones de grfico

] (delimiter is ' ');

Funciones bsicas de agregacin


Descripcin general de las funciones bsicas de agregacin
Las funciones bsicas de agregacin son un grupo de las funciones de agregacin ms comunes.

Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Funciones bsicas de agregacin en el script de carga de datos


firstsortedvalue
Esta funcin de script devuelve el primer valor de una expresin ordenada por su correspondiente sort-
weight cuando la expresin se repite a lo largo de un determinado nmero de registros, definidos por una
clusula group by.

firstsortedvalue ([ distinct ] expression [, sort-weight [, n ]])

max
Esta funcin de script devuelve el valor numrico mximo de la expresin hallado en un nmero de registros
definidos por una clusula group by.

max ( expression[, rank])

min
Esta funcin de script devuelve el valor numrico mnimo de la expresin hallado en un nmero de registros
definidos por una clusula group by.

min ( expression[, rank])

mode
Esta funcin de script devuelve el valor mode, esto es, el valor que se da con mayor frecuencia, en la
expresin en varios registros, tal y como viene definido por una clusula group by. mode puede devolver
valores numricos as como de texto.

mode (expression )

only
Esta funcin de script devuelve el valor de una expresin o campo que se repite por uno o ms registros. Si
los registros contienen solo un valor entonces devuelve ese valor, si no devuelve NULL. Utilice la clusula
group by para evaluar mltiples registros.only puede devolver valores numricos y de texto.

only (expression )

sum

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 146


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve la suma de la expresin a lo largo de un nmero de registros definidos por
una clusula group by clause.
sum ([distinct]expression)

Funciones bsicas de agregacin en expresiones de grficos


Las funciones de agregacin en grficos slo pueden emplearse sobre campos en expresiones de grficos.
La expresin del argumento de una funcin de agregacin no deber contener otra funcin de agregacin.

FirstSortedValue
FirstSortedValue() devuelve el valor de un campo basado en los valores ordenados de otro campo. Por
ejemplo, el producto con el precio de unidad ms bajo.

FirstSortedValue - funcin de grfico([{SetExpression}] [DISTINCT] [TOTAL


[<fld {,fld}>]] value, sort_weight [,rank])

Max
Max() halla el valor ms alto de los datos agregados. Al especificar un rank n, puede hallarse el ensimo
valor ms alto.
Max - funcin de grficoMax() halla el valor ms alto de los datos
agregados. Al especificar un rank n, puede hallarse el ensimo valor ms
alto. Puede que tambin le convenga echar un vistazo a FirstSortedValue y
rangemax, que tienen una funcionalidad similar a la de la funcin Max. Max
([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] expr [,rank])Tipo de
datos devueltos:numrico ArgumentoDescripcinexprLa expresin o el campo
que contiene los datos que se han de medir.rankEl valor de rank se fija por
defecto en 1, que se corresponde con el valor ms alto. Si establecemos
rank en 2 devolver el segundo valor ms alto. Si rank se fija en 3,
devolver el tercer valor ms alto y as sucesivamente.SetExpressionPor
defecto, la funcin de agregacin agregar sobre el conjunto de registros
posibles definidos por la seleccin. Se podra definir un conjunto
alternativo de registros mediante una expresin de anlisis de conjuntos.
TOTALSi la palabra TOTAL aparece antes de los argumentos de la funcin, el
clculo se realiza con todos los valores posibles segn las selecciones
actuales, y no solo con los que pertenecen al valor dimensional actual, es
decir, ignora las dimensiones del grfico. El cualificador TOTAL puede ir
seguido de una lista con uno o ms nombres de campo entre parntesis
angulares <fld>. Estos nombres de campo deberan ser un subgrupo de las
variables de dimensin del grfico. CustomerProductUnitSalesUnitPrice
AstridaAA416AstridaAA1015AstridaBB99BetacabBB510BetacabCC220BetacabDD-
25CanutilityAA815CanutilityCC-19EjemplosResultadosMax(UnitSales)10, porque
este es el valor ms alto en UnitSales.El valor de un pedido se calcula a
partir del nmero de unidades vendidas en (UnitSales) multiplicado por el
precio de unidad.Max(UnitSales*UnitPrice)150, porque este es el valor ms
alto del resultado de calcular todos los valores posibles de (UnitSales)*
(UnitPrice).Max(UnitSales, 2)9, que es el segundo valor ms alto. valor.Max

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 147


5 Funciones en scripts y en expresiones de grfico

(TOTAL UnitSales)10, porque el cualificador TOTAL significa que se


encuentra el valor ms alto posible, omitiendo las dimensiones del grfico.
Para un grfico con Customer como dimensin, el cualificador TOTAL
asegurar que se devuelve el valor mximo en todo el conjunto de datos, en
lugar del valor mximo UnitSales para cada cliente.Seleccione Customer
B.Max({1} TOTAL UnitSales)10, independientemente de la seleccin realizada,
ya que la expresin Set Analysis {1} define el conjunto de registros que se
debe evaluar como ALL, sea cual sea la seleccin efectuada.Datos empleados
en los ejemplos:ProductData:LOAD * inline
[Customer|Product|UnitSales|UnitPriceAstrida|AA|4|16Astrida|AA|10|15Astrida
|BB|9|9Betacab|BB|5|10Betacab|CC|2|20Betacab|DD||25Canutility|AA|8|15Canuti
lity|CC||19] (delimiter is '|'); FirstSortedValue RangeMax
([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] expr [,rank])

Min
Min() halla el valor ms bajo de los datos agregados. Al especificar un rank n, puede hallarse el ensimo
valor ms bajo.

Min - funcin de grfico([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}


>]] expr [,rank])

Mode
Mode() halla el valor que ms veces aparece (el valor de la moda) en los datos agregados. La funcin Mode
() puede procesar tanto valores numricos como valores de texto.

Mode - funcin de grfico({[SetExpression] [TOTAL [<fld {,fld}>]]} expr)

Only
Only() devuelve un valor si hay nicamente un resultado posible en los datos agregados. Por ejemplo, al
buscar el nico producto donde el precio de unidad es = 9 devolver un valor NULL en caso de que ms de un
producto tenga un precio de unidad de 9.

Only - funcin de grfico([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}


>]] expr)

Sum
Sum() calcula el total de valores especificados por la expresin o campo en los datos agregados.

Sum - funcin de grfico([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}


>]] expr])

firstsortedvalue
Esta funcin de script devuelve el primer valor de una expresin ordenada por su correspondiente sort-
weight cuando la expresin se repite a lo largo de un determinado nmero de registros, definidos por una
clusula group by.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 148


5 Funciones en scripts y en expresiones de grfico

firstsortedvalue ([ distinct ] value, sort-weight [, rank ])

Argumentos:

Argumento Descripcin

value La funcin devuelve un valor del campo especificado en value asociado con el resultado de
ordenar el campo sort_weight, teniendo en cuenta rank, si se especifica. Si ms de un
valor obtenido comparte el mismo sort_weight para el rank especificado, la funcin
devuelve NULL.

sort-weight La expresin que contiene los datos que se han de ordenar. Encuentra el primer valor (y el
ms bajo) de sort_weight, desde el que se determina el correspondiente valor de la
expresin value. Si coloca un signo menos delante de sort_weight, la funcin devuelve el
ltimo valor (el ms alto) en orden. .

rank Si se establece un rank "n" mayor que 1, devolver el ensimo valor en orden.
Expression

distinct Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: MyProductWithLargestOrderByCustomer
LOAD * inline [ AA
Customer|Product|OrderNumber|UnitSales|CustomerID BB
Astrida|AA|1|10|1 DD
Astrida|AA|7|18|1 porque AA corresponde al pedido ms grande
Astrida|BB|4|9|1
(valor de UnitSales:18) para el cliente Astrida, BB
Astrida|CC|6|2|1
Betacab|AA|5|4|2 corresponde al pedido ms grande (5) para el
Betacab|BB|2|5|2 cliente Betacab y DD corresponde al pedido ms
Betacab|DD grande (8) para el cliente Canutility.
Canutility|DD|3|8
Canutility|CC
] (delimiter is '|');

FirstSortedValue:
LOAD Customer,FirstSortedValue(Product, -
UnitSales) as MyProductWithLargestOrderByCustomer
Resident Temp Group By Customer;

Dado que la tabla Temp se carga como en el MyProductWithSmallestOrderByCustomer


CC

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 149


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

ejemplo anterior: AA
DD
LOAD Customer,FirstSortedValue(Product, porque CC corresponde al pedido ms pequeo
UnitSales) as (2) para el cliente Astrida, AA corresponde al
MyProductWithSmallestOrderByCustomer Resident
pedido ms pequeo (4) para el cliente Betacab y
Temp Group By Customer;
DD corresponde al pedido ms pequeo (8) para
el cliente Canutility (slo hay un pedido vlido por
cliente Canutility as que es a la vez el ms
pequeo y el ms grande).

Dado que la tabla Temp se carga como en el MySecondLargetsOrderCustomer


AA
ejemplo anterior:
AA
-
LOAD Customer, FirstSortedValue(Product, -
UnitSales,2) as My2ndProductOrderCustomer, Nota: El campo slo mostrar AA una vez, porque
Resident Temp Group By Customer; es el segundo pedido ms grande para ambos
clientes Astrida y Betacab.

FirstSortedValue - funcin de grfico


FirstSortedValue() devuelve el valor de un campo basado en los valores ordenados de otro campo. Por
ejemplo, el producto con el precio de unidad ms bajo.

Sintaxis:

FirstSortedValue([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] value,


sort_weight [,rank])

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

value Campo de salida. La funcin devuelve un valor del campo especificado en value
asociado con el resultado de ordenar el campo sort_weight, teniendo en cuenta rank,
si se especifica. Si ms de un valor obtenido comparte el mismo sort_weight para el
rank especificado, la funcin devuelve NULL.

sort_weight Campo de entrada. La expresin que contiene los datos que se han de ordenar.
Encuentra el primer valor (y el ms bajo) de sort_weight, desde el que se determina el
correspondiente valor de la expresin value. Si coloca un signo menos delante de sort_
weight, la funcin devuelve el ltimo valor (el ms alto) en orden.

rank Si se establece un rank "n" mayor que 1, devolver el ensimo valor en orden.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 150


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Betacab DD - 25

Canutility AA 8 15

Canutility CC - 19

Ejemplo Resultado
firstsortedvalue (Product, BB, que es el Productcon el UnitPrice(9) ms bajo.
UnitPrice)

firstsortedvalue (Product, BB, que es el Productcon el segundo UnitPrice(10) ms bajo.


UnitPrice, 2)

firstsortedvalue (Customer, - B, que es el Customercon el Product que tiene el segundoUnitPrice


UnitPrice, 2)
(20) ms bajo.
firstsortedvalue (Customer, NULL, porque hay dos valores de Customer (A y C) con el mismorank
UnitPrice, 3)
(el tercero ms bajo) UnitPrice(15).
firstsortedvalue (Customer, - A, que es el Customer con el segundo valor ms alto del pedido de
UnitPrice*UnitSales, 2)
ventas UnitPrice multiplicado por UnitSales (120).

Datos empleados en los ejemplos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 151


5 Funciones en scripts y en expresiones de grfico

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

max
Esta funcin de script devuelve el valor numrico mximo de la expresin hallado en un nmero de registros
definidos por una clusula group by.

Sintaxis:

max ( expression[, rank])

Argumentos:

Argumento Descripcin

rank El valor de rank se fija por defecto en 1, que se corresponde con el valor ms alto. Si
establecemos rank en 2 devolver el segundo valor ms alto. Si rank se fija en 3,
devolver el tercer valor ms alto y as sucesivamente.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: Customer MyMax
LOAD * inline [ A 18
Customer|Product|OrderNumber|UnitSales|CustomerID B 5
Astrida|AA|1|10|1 C 8
Astrida|AA|7|18|1
Astrida|BB|4|9|1
Astrida|CC|6|2|1
Betacab|AA|5|4|2
Betacab|BB|2|5|2
Betacab|DD
Canutility|DD|3|8
Canutility|CC

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 152


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
] (delimiter is '|');

Max:
LOAD Customer, Max(UnitSales) as MyMax, Resident Temp Group By Customer;

Dado que la tabla Temp se carga como en el ejemplo anterior: Customer MyMaxRank2
A 10
LOAD Customer, Max(UnitSales,2) as MyMaxRank2, Resident Temp Group By B 4
Customer; C -

Max - funcin de grfico


Max() halla el valor ms alto de los datos agregados. Al especificar un rank n, puede hallarse el ensimo
valor ms alto.

Puede que tambin le convenga echar un vistazo a FirstSortedValue y rangemax, que tienen
una funcionalidad similar a la de la funcin Max.

Sintaxis:

Max([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] expr [,rank])

Tipo de datos devueltos:numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

rank El valor de rank se fija por defecto en 1, que se corresponde con el valor ms alto. Si
establecemos rank en 2 devolver el segundo valor ms alto. Si rank se fija en 3,
devolver el tercer valor ms alto y as sucesivamente.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 153


5 Funciones en scripts y en expresiones de grfico

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Betacab DD - 25

Canutility AA 8 15

Canutility CC - 19

Ejemplos Resultados
Max(UnitSales) 10, porque este es el valor ms alto en UnitSales.

El valor de un pedido se 150, porque este es el valor ms alto del resultado de calcular todos los
calcula a partir del nmero valores posibles de (UnitSales)*(UnitPrice).
de unidades vendidas en
(UnitSales) multiplicado por
el precio de unidad.

Max(UnitSales*UnitPrice)

Max(UnitSales, 2) 9, que es el segundo valor ms alto. valor.


Max(TOTALUnitSales) 10, porque el cualificador TOTAL significa que se encuentra el valor ms
alto posible, omitiendo las dimensiones del grfico. Para un grfico con
Customer como dimensin, el cualificador TOTAL asegurar que se
devuelve el valor mximo en todo el conjunto de datos, en lugar del valor
mximo UnitSales para cada cliente.

Seleccione Customer B. 10, independientemente de la seleccin realizada, ya que la expresin Set


Analysis {1} define el conjunto de registros que se debe evaluar como ALL,
Max({1} TOTALUnitSales)
sea cual sea la seleccin efectuada.

Datos empleados en los ejemplos:

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 154


5 Funciones en scripts y en expresiones de grfico

Canutility|CC||19
] (delimiter is '|');

Vea tambin:

p FirstSortedValue - funcin de grfico (pgina 150)

p RangeMax (pgina 503)

min
Esta funcin de script devuelve el valor numrico mnimo de la expresin hallado en un nmero de registros
definidos por una clusula group by.

Sintaxis:

min ( expression[, rank])

Argumentos:

Argumento Descripcin

rank El valor de rank por defecto es 1, que se corresponde con el valor ms bajo. Si
establecemos rank en 2 devolver el segundo valor ms bajo. Si rank se fija en 3,
devolver el tercer valor ms bajo y as sucesivamente.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: Customer MyMin
LOAD * inline [ A 2
Customer|Product|OrderNumber|UnitSales|CustomerID B 4
Astrida|AA|1|10|1 C 8
Astrida|AA|7|18|1
Astrida|BB|4|9|1
Astrida|CC|6|2|1
Betacab|AA|5|4|2
Betacab|BB|2|5|2
Betacab|DD
Canutility|DD|3|8
Canutility|CC
] (delimiter is '|');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 155


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Min:
LOAD Customer, Min(UnitSales) as MyMin, Resident Temp Group By Customer;

Dado que la tabla Temp se carga como en el ejemplo anterior: Customer MyMinRank2
A 9
LOAD Customer, Min(UnitSales,2) as MyMinRank2, Resident Temp Group By B 5
Customer; C -

Min - funcin de grfico


Min() halla el valor ms bajo de los datos agregados. Al especificar un rank n, puede hallarse el ensimo
valor ms bajo.

Puede que tambin le convenga echar un vistazo a FirstSortedValue y rangemin, que tienen
una funcionalidad similar a la de la funcin Min.

Sintaxis:

Min({[SetExpression] [TOTAL [<fld {,fld}>]]} expr [,rank])

Tipo de datos devueltos:numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

rank El valor de rank se fija por defecto en 1, que se corresponde con el valor ms alto. Si
establecemos rank en 2 devolver el segundo valor ms alto. Si rank se fija en 3,
devolver el tercer valor ms alto y as sucesivamente.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 156


5 Funciones en scripts y en expresiones de grfico

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Betacab DD - 25

Canutility AA 8 15

Canutility CC - 19

La funcinMin() debe devolver un valor no NULL de la matriz de valores dada segn la


expresin, en caso de que haya una. Por lo tanto en los ejemplos, porque hay valores NULL en
los datos, la funcin devuelve el primer valor no NULL evaluado de la expresin.

Ejemplos Resultados
Min(UnitSales) 2, porque este es el valor no NULL ms bajo en UnitSales.

El valor de un pedido se 40, porque este es el valor no NULL ms bajo del resultado de calcular
calcula a partir del nmero todos los valores posibles de (UnitSales)*(UnitPrice).
de unidades vendidas en
(UnitSales) multiplicado por
el precio de unidad.

Min(UnitSales*UnitPrice)

Min(UnitSales, 2) 4, que es el segundo valor ms bajo (despus de los valores NULL).


Min(TOTALUnitSales) 2, porque el cualificador TOTAL significa que se encuentra el valor ms
bajo posible, omitiendo las dimensiones del grfico. Para un grfico con
Customer como dimensin, el cualificador TOTAL asegurar que se
devuelve el valor mnimo en todo el conjunto de datos, en lugar del valor
mnimo UnitSales para cada cliente.

SeleccioneCustomer B. 40, independientemente de la seleccin realizada, ya que la expresin Set


Analysis {1} define el conjunto de registros que se debe evaluar como ALL,
Min({1} TOTALUnitSales)
sea cual sea la seleccin efectuada.

Datos empleados en los ejemplos:

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 157


5 Funciones en scripts y en expresiones de grfico

Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

Vea tambin:

p FirstSortedValue - funcin de grfico (pgina 150)

p RangeMin (pgina 506)

mode
Esta funcin de script devuelve el valor mode, esto es, el valor que se da con mayor frecuencia, en la
expresin en varios registros, tal y como viene definido por una clusula group by. mode puede devolver
valores numricos as como de texto.

Sintaxis:

mode ( expression )

Limitaciones:

Si ms de un valor es lo que se muestra con ms frecuencia, devuelve NULL.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: MyMostOftenSoldProduct
LOAD * inline [ AA
Customer|Product|OrderNumber|UnitSales|CustomerID porque AA es el nico producto que se ha
Astrida|AA|1|10|1
vendido ms de una vez.
Astrida|AA|7|18|1
Astrida|BB|4|9|1
Astrida|CC|6|2|1
Betacab|AA|5|4|2
Betacab|BB|2|5|2
Betacab|DD
Canutility|DD|3|8
Canutility|CC
] (delimiter is '|');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 158


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

Mode:
LOAD Customer, Mode(Product) as MyMostOftenSoldProduct,
Resident Temp Group By Customer;

Mode - funcin de grfico


Mode() halla el valor que ms veces aparece (el valor de la moda) en los datos agregados. La funcin Mode
() puede procesar tanto valores numricos como valores de texto.

Sintaxis:

Mode({[SetExpression] [TOTAL [<fld {,fld}>]]} expr)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 159


5 Funciones en scripts y en expresiones de grfico

Customer Product UnitSales UnitPrice

Betacab DD - 25

Canutility AA 8 15

Canutility CC - 19

Ejemplos Resultados
Mode(UnitPrice) 15, porque este es el valor ms comn en UnitSales.

Seleccione Devuelve NULL (-). Ningn valor nico ocurre ms a menudo que otro.
Customer A.

Mode(Product) AA, porque este es el valor que ms veces se da en Product.


Realice la
seleccin Devuelve NULL (-). Ningn valor nico ocurre ms a menudo que otro.
Customer A

Mode 15, porque el cualificador TOTAL significa que el valor ms comn sigue siendo 15,
(TOTALUnitPrice)
omitiendo las dimensiones del grfico.

Seleccione 15, independientemente de la seleccin realizada, ya que la expresin Set Analysis


Customer B. {1} define el conjunto de registros que se debe evaluar como ALL, sea cual sea la
seleccin efectuada.
Mode)({1}
TOTALUnitPrice)

Datos empleados en los ejemplos:

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

Vea tambin:

p Avg - funcin de grfico (pgina 196)

p Median - funcin de grfico (pgina 224)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 160


5 Funciones en scripts y en expresiones de grfico

only
Esta funcin de script devuelve el valor de una expresin o campo que se repite por uno o ms registros. Si
los registros contienen solo un valor entonces devuelve ese valor, si no devuelve NULL. Utilice la clusula
group by para evaluar mltiples registros.only puede devolver valores numricos y de texto.

Sintaxis:

only ( expression )

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: Customer MyUniqIDCheck
LOAD * inline [ A 1
Customer|Product|OrderNumber|UnitSales|CustomerID porque solo el cliente A tiene
Astrida|AA|1|10|1
registros completos en los que se
Astrida|AA|7|18|1
Astrida|BB|4|9|1 incluye el IDCliente.
Astrida|CC|6|2|1
Betacab|AA|5|4|2
Betacab|BB|2|5|2
Betacab|DD
Canutility|DD|3|8
Canutility|CC
] (delimiter is '|');

Only:
LOAD Customer, Only(CustomerID) as MyUniqIDCheck,
Resident Temp Group By Customer;

Only - funcin de grfico


Only() devuelve un valor si hay nicamente un resultado posible en los datos agregados. Por ejemplo, al
buscar el nico producto donde el precio de unidad es = 9 devolver un valor NULL en caso de que ms de un
producto tenga un precio de unidad de 9.

Sintaxis:

Only([{SetExpression}] [TOTAL [<fld {,fld}>]] expr)

Tipo de datos devueltos: dual

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 161


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Use Only() cuando desee un resultado NULL si hay varios valores posibles en los datos de
muestra.

Ejemplos y resultados:

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Betacab DD - 25

Canutility AA 8 15

Canutility CC - 19

Ejemplos Resultados
Only({<UnitPrice={9}>} BB, porque este es el nico Productque tiene un UnitPrice de "9".
Product)

Only({<Product={DD}>} B, porque es el nico Customer que vende un Product llamado "DD".


Customer)

Only({<UnitPrice={20}>} El nmero de UnitSales donde UnitPrice es 20 es 2, porque solo hay un valor


UnitSales)
de UnitSales donde UnitPrice = 20.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 162


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados
Only({<UnitPrice={15}>} NULL, porque hay dos valores de UnitSales donde UnitPrice = 15.
UnitSales)

Datos empleados en los ejemplos:

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

sum
Esta funcin de script devuelve la suma de la expresin a lo largo de un nmero de registros definidos por
una clusula group by clause.

Sintaxis:

sum ( [ distinct] expression)

Argumentos:

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: Customer MySum
LOAD * inline [
Customer|Product|OrderNumber|UnitSales|CustomerID A 39
Astrida|AA|1|10|1
Astrida|AA|7|18|1 B 9
Astrida|BB|4|9|1
Astrida|CC|6|2|1
C 8

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 163


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Betacab|AA|5|4|2
Betacab|BB|2|5|2
Betacab|DD
Canutility|DD|3|8
Canutility|CC
] (delimiter is '|');

Sum:
LOAD SCustomer, Sum(UnitSales) as MySum, Resident Temp Group By Customer;

Sum - funcin de grfico


Sum() calcula el total de valores especificados por la expresin o campo en los datos agregados.

Sintaxis:

Sum([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] expr])

Tipo de datos devueltos:numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

Aunque el cualificador DISTINCT es compatible, debe utilizarlo con


cuidado, ya que puede hacer que el lector piense, por error, que se muestra
un valor total porque se han omitido datos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 164


5 Funciones en scripts y en expresiones de grfico

Customer Product UnitSales UnitPrice

Astrida AA 4 16

Astrida AA 10 15

Astrida BB 9 9

Betacab BB 5 10

Betacab CC 2 20

Betacab DD - 25

Canutility AA 8 15

Canutility CC - 19

Ejemplos Resultados
Sum(UnitSales) 38. El total de los valores en UnitSales.
Sum(UnitSales*UnitPrice) 505. El total de UnitPrice multiplicado por UnitSales agregado.
Sum 505 para todas las filas, as como el total, dado que el cualificador TOTAL
(TOTALUnitSales*UnitPrice)
implica que el resultado de la suma sigue siendo 505, descartando las
dimensiones del grfico.

Seleccione Customer B. 505, independientemente de la seleccin realizada, ya que la expresin


Set Analysis {1} define el conjunto de registros que se debe evaluar como
Sum({1}
TOTALUnitSales*UnitPrice)
ALL, sea cual sea la seleccin efectuada.

Datos empleados en los ejemplos:

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

Funciones de agregacin de contador


Las funciones de agregacin de contador devuelven diversos tipos de cuentas de una expresin que se repite
a lo largo de un nmero de registros en un script de carga de datos, o un nmero de valores en una
dimensin de un grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 165


5 Funciones en scripts y en expresiones de grfico

Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Funciones de agregacin de contador en el script de carga de datos


count
Devuelve la cuenta de expresin a lo largo de un nmero de registros definidos por una clusula group by.

count ([distinct ] expression | * )

MissingCount
Devuelve la cuenta de perdidos y nulos de la expresin que se repite sobre un nmero de registros definidos
por una clusula group by.

MissingCount ([ distinct ] expression)

NullCount
Devuelve la cuenta de expresin NULL a lo largo de un nmero de registros definidos por una clusula group
by.

NullCount ([ distinct ] expression)

NumericCount
Devuelve la cuenta numrica de la expresin sobre un nmero de registros definidos por una clusula group
by.

NumericCount ([ distinct ] expression)

TextCount
Devuelve la cuenta de valores de texto de la expresin que se repite sobre un numero de registros definidos
por una clusula group by.

TextCount ([ distinct ] expression)

Funciones de agregacin de contador en expresiones de grficos


Se pueden utilizar las siguientes funciones de agregacin de contador en grficos:

Las funciones de agregacin en grficos slo pueden emplearse sobre campos en expresiones
de grficos. La expresin del argumento de una funcin de agregacin no deber contener otra
funcin de agregacin.

Count
Count() se utiliza para agregar el nmero de valores, de texto y numricos en cada dimensin del grfico.

Count - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}


>]]} expr)

MissingCount

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 166


5 Funciones en scripts y en expresiones de grfico

MissingCount() se utiliza para agregar el nmero de valores que faltan en cada dimensin del grfico. Los
valores perdidos son todos valores no numricos.

MissingCount - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld


{,fld}>]] expr)

NullCount
NullCount() se utiliza para agregar el nmero de valores NULL en cada dimensin del grfico.

NullCount - funcin de grfico({[SetExpression][DISTINCT] [TOTAL [<fld


{,fld}>]]} expr)

NumericCount
NumericCount() agrega el nmero de valores numricos en cada dimensin del grfico.

NumericCount - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld


{,fld}>]]} expr)

TextCount
TextCount() se utiliza para agregar el nmero de valores de campo no numricos en cada dimensin del
grfico.

TextCount - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld


{,fld}>]]} expr)

count
Devuelve la cuenta de expresin a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

count ( [distinct ] expr | * )

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 167


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Temp: Customer OrdersByCustomer
LOAD * inline [ Astrida 3
Customer|Product|OrderNumber|UnitSales|UnitPrice Betacab 3
Astrida|AA|1|4|16 Canutility 2
Astrida|AA|7|10|15 Divadip 2
Astrida|BB|4|9|9 siempre y cuando la dimensin Customer est
Betacab|CC|6|5|10
incluida en la tabla en la hoja, si no, el resultado de
Betacab|AA|5|2|20
Betacab|BB|1|25| 25 OrdersByCustomer es 3, 2.
Canutility|AA|3|8|15
Canutility|CC|||19
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');

Count1:
LOAD Customer,Count(OrderNumber) as
OrdersByCustomer Resident Temp Group By
Customer;

Dado que la tabla Temp se carga como en el TotalOrderNumber


10
ejemplo anterior:

LOAD Customer,Count(OrderNumber) as
TotalOrdersNumber Resident Temp;

Dado que la tabla Temp se carga como en el TotalOrderNumber


9
ejemplo anterior:
porque hay dos valores de OrderNumber con el
LOAD Customer,Count(distinct OrderNumber) as mismo valor, 1.
TotalOrdersNumber Resident Temp;

Count - funcin de grfico


Count() se utiliza para agregar el nmero de valores, de texto y numricos en cada dimensin del grfico.

Sintaxis:

Count({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 168


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Customer Product OrderNumber UnitSales Unit Price

Astrida AA 1 4 16

Astrida AA 7 10 15

Astrida BB 4 9 9

Betacab BB 6 5 10

Betacab CC 5 2 20

Betacab DD 1 25 25

Canutility AA 3 8 15

Canutility CC 19

Divadip AA 2 4 16

Divadip DD 3 25

En los siguientes ejemplos se da por sentado que se han seleccionado todos los clientes, excepto donde se
indique lo contrario.

Ejemplo Resultado
Count(OrderNumber) 10, porque hay 10 campos que podran tener un valor para OrderNumber,
y todos los registros, incluso los vacos, se cuentan.

"0" cuenta como un valor y no una celda vaca. Sin


embargo, si una medida agrega a 0 para una dimensin esa
dimensin no se incluir en los grficos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 169


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Count (Customer) 10 porque Count evala el nmero de veces que aparece en todos los
campos.
Count (DISTINCT [Customer]) 4, porque al usar el cualificador Distinct, Count solo evala las
ocurrencias nicas.

Siempre y cuando el cliente 0,2 porque la expresin devuelve el nmero de pedidos del cliente
Canutility est seleccionado seleccionado como un porcentaje de pedidos de todos los clientes. En
este caso 2 /10.
Count (OrderNumber)/Count
({1} TOTALOrderNumber

Puesto que los clientes 5 porque ese es el nmero de pedidos de productos slo para los clientes
Astrida y Canutility estn seleccionados y las celdas vacas se cuentan.
seleccionados

Count(TOTAL <Product>
OrderNumber)

Datos empleados en los ejemplos:

Temp:
LOAD * inline [
Customer|Product|OrderNumber|UnitSales|UnitPrice
Astrida|AA|1|4|16
Astrida|AA|7|10|15
Astrida|BB|4|9|9
Betacab|CC|6|5|10
Betacab|AA|5|2|20
Betacab|BB|1|25| 25
Canutility|AA|3|8|15
Canutility|CC|||19
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');

MissingCount
Devuelve la cuenta de perdidos y nulos de la expresin que se repite sobre un nmero de registros definidos
por una clusula group by.

Sintaxis:

MissingCount ( [ distinct ] expr)

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 170


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Ejemplo Resultado
Temp: Customer
LOAD * inline [ MissingOrdersByCustomer
Customer|Product|OrderNumber|UnitSales|UnitPrice Astrida 0
Astrida|AA|1|4|16 Betacab 1
Astrida|AA|7|10|15 Canutility 2
Astrida|BB|4|9|9 Divadip 0
Betacab|CC|6|5|10 La segunda sentencia da:
Betacab|AA|5|2|20
Betacab|BB||| 25 TotalMissingCount
Canutility|AA|||15 3
Canutility|CC| ||19 en una tabla con esa dimensin.
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');
MissCount1:
LOAD Customer,MissingCount(OrderNumber) as
MissingOrdersByCustomer Resident Temp Group By Customer;

Load MissingCount(OrderNumber2) as TotalMissingCount Resident


Temp

Dado que la tabla Temp se carga como en el ejemplo anterior: TotalMissingCountDistinct


1
LOAD Customer,MissingCount(distinct OrderNumber) as porque slo hay un
TotalMissingCountDistinct Resident Temp; OrderNumber un valor perdido.

MissingCount - funcin de grfico


MissingCount() se utiliza para agregar el nmero de valores que faltan en cada dimensin del grfico. Los
valores perdidos son todos valores no numricos.

Sintaxis:

MissingCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]] expr)

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 171


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

set_ Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
expression definidos por la seleccin. Se podra definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Customer Product OrderNumber UnitSales Unit Price

Astrida AA 1 4 16

Astrida AA 7 10 15

Astrida BB 4 9 9

Betacab BB 6 5 10

Betacab CC 5 2 20

Betacab DD 25

Canutility AA 15

Canutility CC 19

Divadip AA 2 4 16

Divadip DD 3 25

Ejemplo Resultado
MissingCount 3 porque 3 de los 10 campos OrderNumber estn vacos
([OrderNumber])

"0" cuenta como un valor y no una celda vaca. Sin embargo, si una
medida agrega a 0 para una dimensin esa dimensin no se incluir en
los grficos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 172


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
MissingCount La expresin devuelve el nmero de pedidos incompletos del cliente seleccionado
([OrderNumber])
como una fraccin de pedidos incompletos de todos los clientes. Hay un total de 3
/MissingCount
valores perdidos para OrderNumber para todos los clientes. As que, para cada cliente
({1} Total
[OrderNumber]) Customer que tenga un valor perdido para producto Product el resultado es 1/3.

Datos utilizados en el ejemplo:

Temp:
LOAD * inline [
Customer|Product|OrderNumber|UnitSales|UnitPrice
Astrida|AA|1|4|16
Astrida|AA|7|10|15
Astrida|BB|4|9|9
Betacab|CC|6|5|10
Betacab|AA|5|2|20
Betacab|BB||| 25
Canutility|AA|||15
Canutility|CC| ||19
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');

NullCount
Devuelve la cuenta de expresin NULL a lo largo de un nmero de registros definidos por una clusula group
by.

Sintaxis:

NullCount ( [ distinct ] expr)

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 173


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Set NULLINTERPRET = NULL; Customer
Temp: NullOrdersByCustomer
LOAD * inline [ Astrida 0
Customer|Product|OrderNumber|UnitSales|CustomerID Betacab 0
Astrida|AA|1|10|1 Canutility 1
Astrida|AA|7|18|1 La segunda sentencia
Astrida|BB|4|9|1
da:
Astrida|CC|6|2|1
Betacab|AA|5|4|2
TotalNullCount
Betacab|BB|2|5|2
1
Betacab|DD|||
Canutility|AA|3|8|
en una tabla con esa
Canutility|CC|NULL|| dimensin.
] (delimiter is '|');
Set NULLINTERPRET=;
NullCount1:
LOAD Customer,NullCount(OrderNumber) as NullOrdersByCustomer Resident
Temp Group By Customer;

LOAD NullCount(OrderNumber2) as TotalNullCount Resident Temp

NullCount - funcin de grfico


NullCount() se utiliza para agregar el nmero de valores NULL en cada dimensin del grfico.

Sintaxis:

NullCount({[SetExpression][DISTINCT] [TOTAL [<fld {,fld}>]]} expr)

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

set_ Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
expression definidos por la seleccin. Se podra definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 174


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplo Resultado

NullCount 1 porque se ha introducido un valor null mediante NullInterpret en la sentencia


([OrderNumber]) LOAD inline.

Datos utilizados en el ejemplo:

Set NULLINTERPRET = NULL;


Temp:
LOAD * inline [
Customer|Product|OrderNumber|UnitSales|CustomerID
Astrida|AA|1|10|1
Astrida|AA|7|18|1
Astrida|BB|4|9|1
Astrida|CC|6|2|1
Betacab|AA|5|4|2
Betacab|BB|2|5|2
Betacab|DD|||
Canutility|AA|3|8|
Canutility|CC|NULL||
] (delimiter is '|');
Set NULLINTERPRET=;

NumericCount
Devuelve la cuenta numrica de la expresin sobre un nmero de registros definidos por una clusula group
by.

Sintaxis:

NumericCount ( [ distinct ] expr)

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplos y resultados:

Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.

Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 175


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Temp: Customer
LOAD * inline [ NumericCountByCustomer
Customer|Product|OrderNumber|UnitSales|UnitPrice Astrida 0
Astrida|AA|1|4|16 Betacab 1
Astrida|AA|7|10|15 Canutility 2
Astrida|BB|4|9|9 Divadip 0
Betacab|CC|6|5|10 La segunda sentencia da:
Betacab|AA|5|2|20
Betacab|BB||| 25 TotalNumericCount
Canutility|AA|||15 3
Canutility|CC| ||19 en una tabla con esa dimensin.
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');
NumCount1:
LOAD Customer,NumericCount(OrderNumber) as NumericCountByCustomer
Resident Temp Group By Customer;

Load NumericgCount(OrderNumber2) as TotalNumericCount Resident


Temp

Dado que la tabla Temp se carga como en el ejemplo anterior: TotalNumericCountDistinct


1
LOAD Customer,NumericCount(distinct OrderNumber) as porque slo hay un
TotalNumeriCCountDistinct Resident Temp; OrderNumber un valor perdido.

NumericCount - funcin de grfico


NumericCount() agrega el nmero de valores numricos en cada dimensin del grfico.

Sintaxis:

NumericCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

set_ Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
expression definidos por la seleccin. Se podra definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 176


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Customer Product OrderNumber UnitSales Unit Price

Astrida AA 1 4 16

Astrida AA 7 10 15

Astrida BB 4 9 1

Betacab BB 6 5 10

Betacab CC 5 2 20

Betacab DD 25

Canutility AA 15

Canutility CC 19

Divadip AA 2 4 16

Divadip DD 3 25

En los siguientes ejemplos se da por sentado que se han seleccionado todos los clientes, excepto donde se
indique lo contrario.

Ejemplo Resultado
NumericCount 7 porque tres de los 10 campos de OrderNumber estn vacos.
([OrderNumber])

"0" cuenta como un valor y no una celda vaca. Sin embargo, si una
medida agrega a 0 para una dimensin esa dimensin no se incluir en
los grficos.

NumericCount 0 porque todos los nombres de productos estn en texto. Normalmente puede utilizar
([Product])
esto para comprobar que a los campos de texto no se les ha dado contenido numrico.
NumericCount Cuenta el nmero de nmeros de orden numricos distintos y lo divide por el nmero
(DISTINCT
de nmeros de orden numricos y no numricos. Esto ser 1 si todos los valores de
[OrderNumber])
campo son numricos. Normalmente puede utilizar esto para comprobar que todos los

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 177


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
/Count(DISTINCT valores de campo son numricos. En el ejemplo, hay 7 valores numricos distintos
[OrderNumber)]
para OrderNumber de 8 distintos numricos y no numricos, as que la expresin
devuelve 0.875.

Datos utilizados en el ejemplo:

Temp:
LOAD * inline [
Customer|Product|OrderNumber|UnitSales|UnitPrice
Astrida|AA|1|4|16
Astrida|AA|7|10|15
Astrida|BB|4|9|9
Betacab|CC|6|5|10
Betacab|AA|5|2|20
Betacab|BB||| 25
Canutility|AA|||15
Canutility|CC| ||19
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');

TextCount
Devuelve la cuenta de valores de texto de la expresin que se repite sobre un numero de registros definidos
por una clusula group by.

Sintaxis:

TextCount ( [ distinct ] expression)

Argumentos:

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplo:

LOAD Month, TextCount(Item) as NumberOfTextItems from abc.csv group by Month;

TextCount - funcin de grfico


TextCount() se utiliza para agregar el nmero de valores de campo no numricos en cada dimensin del
grfico.

Sintaxis:

TextCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)

Tipo de datos devueltos: Entero

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 178


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Customer Product OrderNumber UnitSales Unit Price

Astrida AA 1 4 16

Astrida AA 7 10 15

Astrida BB 4 9 1

Betacab BB 6 5 10

Betacab CC 5 2 20

Betacab DD 25

Canutility AA 15

Canutility CC 19

Divadip AA 2 4 16

Divadip DD 3 25

Ejemplo Resultado
TextCount 10 porque los 10 campos en Product son texto.
([Product])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 179


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

"0" cuenta como un valor y no una celda vaca. Sin embargo, si una
medida agrega a 0 para una dimensin esa dimensin no se incluir en
los grficos. Las celdas vacas se evalan como que no son texto y no
se cuentan en TextCount.

TextCount 3 porque las celdas vacas se cuentan. Normalmente puede utilizar esto para
([OrderNumber])
comprobar que a los campos numricos no se les ha dado contenido de texto o no son
cero.
TextCount Cuenta todos los valores de texto distintos de Product (4), y lo divide por el nmero
(DISTINCT
total de valores de Product (10). El valor por defecto es 0,4.
[Product])
/Count
([Product)]

Datos utilizados en el ejemplo:

Temp:
LOAD * inline [
Customer|Product|OrderNumber|UnitSales|UnitPrice
Astrida|AA|1|4|16
Astrida|AA|7|1|15
Astrida|BB|4|9|9
Betacab|CC|6|5|10
Betacab|AA|5|2|20
Betacab|BB|||| 25
Canutility|AA|||15
Canutility|CC|||19
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');

Funciones de agregacin financiera


En esta seccin se describen las funciones de agregacin para operaciones financieras relacionadas con los
pagos y el flujo de caja.

Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Funciones financieras de agregacin en el script de carga de datos


IRR
Esta funcin de script devuelve la tasa interna agregada de devolucin de una serie de flujos de efectivo
representados por los nmeros de expresin que se repiten a lo largo de un nmero de registros definidos por
una clusula group by.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 180


5 Funciones en scripts y en expresiones de grfico

IRR (expression)

XIRR
Esta funcin de script devuelve la tasa interna agregada de devolucin de una planificacin de flujos de
efectivo (no necesariamente peridicos) representados por los nmeros pareados de valueexpression y
dateexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by

XIRR (valueexpression, dateexpression )

NPV
Esta funcin de script devuelve el valor presente neto agregado de una inversin basada en una tasa de
descuento y una serie de pagos futuros (valores negativos) e ingresos (valores positivos) representados por
los nmeros en expresin que se repiten a lo largo de un nmero de registros definidos por una clusula
group by. El resultado tiene un formato numrico predeterminado de moneda.

NPV (rate, expression)

XNPV
Esta funcin de script devuelve el valor presente neto agregado para una planificacin de flujos de efectivo
(no necesariamente peridicos) representados por nmeros pareados en valueexpression y
dateexpression , que se repiten a lo largo de un nmero de registros definidos por una clusula group by.
Rate es el tipo de inters por perodo. El resultado tiene un formato numrico predeterminado en money.

XNPV (rate, valueexpression, dateexpression)

Funciones financieras de agregacin en expresiones de grficos


Se pueden utilizar las siguientes funciones de agregacin financiera en grficos.

irr
IRR() devuelve la tasa interna agregada de devolucin de una serie de flujos de efectivo representados por
los nmeros de expresin proporcionados por value que se repiten en las dimensiones del grfico.

IRR - funcin de grfico[TOTAL [<fld {,fld}>]] value)

npv
NPV() devuelve el valor presente neto agregado de una inversin basada en una discount_rate y una serie
de pagos futuros (valores negativos) e ingresos (valores positivos) representados por los nmeros de value
que se repiten a lo largo de las dimensiones del grfico. El resultado tiene un formato numrico
predeterminado de moneda. Se da por sentado que los pagos e ingresos se producen al final de cada
perodo.

NPV - funcin de grfico([TOTAL [<fld {,fld}>]] discount_rate, value)

xirr
XIRR() devuelve la tasa de retorno interna agregada de una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por los nmeros emparejados de las expresiones dadas por pmt y
date que se repiten a lo largo de las dimensiones del grfico. Todos los pagos son descontados segn una

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 181


5 Funciones en scripts y en expresiones de grfico

base de un ao de 365 das.

XIRR - funcin de grfico (pgina 186)([TOTAL [<fld {,fld}>]] pmt, date)

xnpv
XNPV() devuelve el valor presente neto agregado de una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por los nmeros emparejados de las expresiones dadas por pmt y
date que se repiten por las dimensiones del grfico. El resultado tiene un formato numrico predeterminado
de moneda. Todos los pagos son descontados segn una base de un ao de 365 das.

XNPV - funcin de grfico([TOTAL [<fld{,fld}>]] discount_rate, pmt, date)

IRR
Esta funcin de script devuelve la tasa interna agregada de devolucin de una serie de flujos de efectivo
representados por los nmeros de expresin que se repiten a lo largo de un nmero de registros definidos por
una clusula group by.

Sintaxis:

IRR(expression)

Estos flujos de efectivo no tienen por qu ser constantes y parejos, como lo seran en una anualidad. Sin
embargo, s que han de producirse a intervalos regulares, como por ejemplo, en perodos mensuales o
anuales. La tasa interna de devolucin es el ltimo tipo de inters recibido para una inversin consistente en
pagos (valores negativos) e ingresos (valores positivos) que se suceden durante perodos regulares. La
funcin necesita al menos un valor positivo y uno negativo para calcular.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplo:

LOAD Year, IRR(Payments) as IRate from abc.csv


group by Year;

IRR - funcin de grfico


IRR() devuelve la tasa interna agregada de devolucin de una serie de flujos de efectivo representados por
los nmeros de expresin proporcionados por value que se repiten en las dimensiones del grfico.

Estos flujos de efectivo no tienen por qu ser constantes y parejos, como lo seran en una anualidad. Sin
embargo, s que han de producirse a intervalos regulares, como por ejemplo, en perodos mensuales o
anuales. La tasa interna de devolucin es el ltimo tipo de inters recibido para una inversin consistente en
pagos (valores negativos) e ingresos (valores positivos) que se suceden durante perodos regulares. La
funcin necesita al menos un valor positivo y uno negativo para ser evaluada.

Sintaxis:

IRR([TOTAL [<fld {,fld}>]] value)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 182


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value La expresin o el campo que contiene los datos que se han de medir.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos y resultados:

Ejemplo Resultado
IRR 0,1634
(Payments)
Se supone que los pagos son peridicos por naturaleza, por ejemplo, mensuales.

El campo Fecha se usa en el ejemplo XIRR donde los pagos pueden no ser
peridicos, siempre y cuando especifique las fechas en las que se realizarn
dichos pagos.

Datos empleados en los ejemplos::

Cashflow:
LOAD 2012 as Year, * inline [
Date,Discount,Payments
2012-01-01, 0.1,-10000
2012-03-01,0.1,3000
2012-10-30,0.1,4200
2013-02-01,0.1,6800];

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 183


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p XIRR - funcin de grfico (pgina 186)

p Aggr - funcin de grfico (pgina 143)

NPV
Esta funcin de script devuelve el valor presente neto agregado de una inversin basada en una tasa de
descuento y una serie de pagos futuros (valores negativos) e ingresos (valores positivos) representados por
los nmeros en expresin que se repiten a lo largo de un nmero de registros definidos por una clusula
group by. El resultado tiene un formato numrico predeterminado de moneda.

Sintaxis:

NPV(rate, expression)

Rate es el tipo de inters por perodo. Los pagos e ingresos se da por sentado que se producen al final de
cada perodo.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplo:

LOAD Year, npv(0.05, Payments) as PValue from abc.csv group by Year;

NPV - funcin de grfico


NPV() devuelve el valor presente neto agregado de una inversin basada en una discount_rate y una serie
de pagos futuros (valores negativos) e ingresos (valores positivos) representados por los nmeros de value
que se repiten a lo largo de las dimensiones del grfico. El resultado tiene un formato numrico
predeterminado de moneda. Se da por sentado que los pagos e ingresos se producen al final de cada
perodo.

Sintaxis:

NPV([TOTAL [<fld {,fld}>]] discount_rate, value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

discount_ discount_rate es la tasa de descuento a lo largo del periodo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 184


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

rate

value La expresin o el campo que contiene los datos que se han de medir.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares. Estos nombres de campo deberan ser un subgrupo de las
variables de dimensin del grfico. En este caso, el clculo se realiza ignorando todas las
variables de dimensin del grfico excepto las listadas, es decir, que devolver un valor por
cada combinacin de valores de campo de los campos de dimensin listados. Tambin los
campos que no constituyan actualmente una dimensin de un grfico pueden incluirse en
la lista. Esto puede resultar til en el caso de dimensiones de grupo, en las que los campos
de dimensin no son fijos. Listar todas las variables del grupo har que la funcin opere
correctamente cuando el nivel jerrquico vare.

Limitaciones:

discount_rate y value no deben contener funciones de agregacin, a menos que dichas agregaciones
internas contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos y resultados:

Ejemplo Resultado
NPV(Discount, Payments) 1188,44

Datos empleados en los ejemplos::

Cashflow:
LOAD 2012 as Year, * inline [
Date,Discount,Payments
2012-01-01, 0.1,-10000
2012-03-01,0.1,3000
2012-10-30,0.1,4200
2013-02-01,0.1,6800];

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 185


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p XNPV - funcin de grfico (pgina 188)

p Aggr - funcin de grfico (pgina 143)

XIRR
Esta funcin de script devuelve la tasa interna agregada de devolucin de una planificacin de flujos de
efectivo (no necesariamente peridicos) representados por los nmeros pareados de valueexpression y
dateexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by

Sintaxis:

XIRR(valueexpression, dateexpression )

Todos los pagos son descontados segn una base de un ao de 365 das.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos de cualquier parte o ambas partes de un par de
datos harn que se descarte el par de datos completo.

Ejemplo:

LOAD S Year, XIRR(Payments, PayDates) as Irate from abc.csv group by Year;

XIRR - funcin de grfico


XIRR() devuelve la tasa de retorno interna agregada de una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por los nmeros emparejados de las expresiones dadas por pmt y
date que se repiten a lo largo de las dimensiones del grfico. Todos los pagos son descontados segn una
base de un ao de 365 das.

Sintaxis:

XIRR([TOTAL [<fld {,fld}>]] pmt, date)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

pmt Pagos.La expresin o el campo que contiene los flujos de caja correspondientes a la
planificacin de pagos suministrada en date.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 186


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

date La expresin o el campo que contienen la planificacin de fechas correspondientes a los


pagos de los flujos de caja suministrados en pmt.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

pmt y date no deben contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplos y resultados:

Ejemplo Resultado
XIRR(Payments, Date) 0,5361

Datos empleados en los ejemplos::

Cashflow:
LOAD 2012 as Year, * inline [
Date,Discount,Payments
2012-01-01, 0.1,-10000
2012-03-01,0.1,3000
2012-10-30,0.1,4200
2013-02-01,0.1,6800];

Vea tambin:

p IRR - funcin de grfico (pgina 182)

p Aggr - funcin de grfico (pgina 143)

XNPV
Esta funcin de script devuelve el valor presente neto agregado para una planificacin de flujos de efectivo
(no necesariamente peridicos) representados por nmeros pareados en valueexpression y
dateexpression , que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 187


5 Funciones en scripts y en expresiones de grfico

Rate es el tipo de inters por perodo. El resultado tiene un formato numrico predeterminado en money.

Sintaxis:

XNPV(rate, valueexpression, dateexpression)

Todos los pagos son descontados segn una base de un ao de 365 das.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos de cualquier parte o ambas partes de un par de
datos harn que se descarte el par de datos completo.

Ejemplo:

LOAD Year, npv(0.05, Payments, PayDates) as PValue from abc.csv group by Year;

XNPV - funcin de grfico


XNPV() devuelve el valor presente neto agregado de una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por los nmeros emparejados de las expresiones dadas por pmt y
date que se repiten por las dimensiones del grfico. El resultado tiene un formato numrico predeterminado
de moneda. Todos los pagos son descontados segn una base de un ao de 365 das.

Sintaxis:

XNPV([TOTAL [<fld{,fld}>]] discount_rate, pmt, date)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

discount_ discount_rate es la tasa de descuento a lo largo del periodo.


rate

pmt Pagos.La expresin o el campo que contiene los flujos de caja correspondientes a la
planificacin de pagos suministrada en date.

date La expresin o el campo que contienen la planificacin de fechas correspondientes a los


pagos de los flujos de caja suministrados en pmt.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se realiza
con todos los valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 188


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

discount_rate,pmt y date no deben contener funciones de agregacin, a menos que dichas agregaciones
internas contengan los cualificadores TOTAL o ALL. Para agregaciones anidadas ms avanzadas, utilice la
funcin de agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplos y resultados:

Ejemplo Resultado
XNPV(Discount, Payments, Date) 2964,24USD

Datos empleados en los ejemplos::

Cashflow:
LOAD 2012 as Year, * inline [
Date,Discount,Payments
2012-01-01, 0.1,-10000
2012-03-01,0.1,3000
2012-10-30,0.1,4200
2013-02-01,0.1,6800];

Vea tambin:

p NPV - funcin de grfico (pgina 184)

p Aggr - funcin de grfico (pgina 143)

Funciones de agregacin estadstica


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Funciones de agregacin estadstica en el script de carga de datos


Se pueden utilizar las siguientes funciones de agregacin estadstica en scripts.

avg
Esta funcin de script devuelve la media de la expresin a lo largo de un nmero de registros definidos por
una clusula group by.

avg ([distinct] expression)

correl
Esta funcin de script devuelve el coeficiente de correlacin agregado de una serie de coordenadas

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 189


5 Funciones en scripts y en expresiones de grfico

representadas por nmeros pares en las x-expression e y-expression, reiteradas sobre un nmero de
registros definidos por una clusula group by.

correl (x-expression, y-expression)

fractile
Esta funcin de script devuelve el fractile de la expresin a lo largo de un nmero de registros definidos por
una clusula group by

fractile (expression, fractile)

kurtosis
Esta funcin de script devuelve la kurtosis de la expresin a lo largo de un nmero de registros definidos por
una clusula group by.

kurtosis ([distinct ] expression )

linest_b
Esta funcin de script devuelve el valor b agregado (que intercepta a y) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

linest_b (y-expression, x-expression [, y0 [, x0 ]])

linest_df
Esta funcin de script devuelve los grados de libertad agregados de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

linest_df (y-expression, x-expression [, y0 [, x0 ]])

linest_f
Esta funcin de script devuelve la estadstica F agregada (r2/(1-r2)) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

linest_f (y-expression, x-expression [, y0 [, x0 ]])

linest_m
Esta funcin de script devuelve el valor m agregado (pendiente) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

linest_m (y-expression, x-expression [, y0 [, x0 ]])

linest_r2
Esta funcin de script devuelve el valor r2 agregado (coeficiente de determinacin) de una regresin lineal
definida por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la
x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 190


5 Funciones en scripts y en expresiones de grfico

group by.

linest_r2 (y-expression, x-expression [, y0 [, x0 ]])

linest_seb
Esta funcin de script devuelve el error estndar agregado del valor b de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

linest_seb (y-expression, x-expression [, y0 [, x0 ]])

linest_sem
Esta funcin de script devuelve el error estndar agregado del valor m de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

linest_sem (y-expression, x-expression [, y0 [, x0 ]])

linest_sey
Esta funcin de script devuelve el error estndar agregado de la estimacin y de una regresin lineal definida
por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-
expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

linest_sey (y-expression, x-expression [, y0 [, x0 ]])

linest_ssreg
Esta funcin de script devuelve la suma de regresin agregada de los cuadrados de una regresin lineal
definida por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la
x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

linest_ssreg (y-expression, x-expression [, y0 [, x0 ]])

linest_ssresid
Esta funcin de script devuelve la suma residual agregada de los cuadrados de una regresin lineal definida
por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-
expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

linest_ssresid (y-expression, x-expression [, y0 [, x0 ]])

median
Esta funcin de script devuelve la mediana agregada de la expresin a lo largo de un nmero de registros
definidos por una clusula group by.

median (expression)

skew

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 191


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve la asimetra de la expresin a lo largo de un nmero de registros definidos
por una clusula group by.

skew ([ distinct] expression)

stdev
Esta funcin de script devuelve la desviacin estndar de la expresin a lo largo de un nmero de registros
definidos por una clusula group by.

stdev ([distinct] expression)

sterr
Esta funcin de script devuelve el error estndar agregado (stdev/sqrt(n)) de una serie de valores
representados por expresin que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

sterr ([distinct] expression)

steyx
Esta funcin de script devuelve el error estndar agregado del valor y predicho para cada valor x en la
regresin para una serie de coordenadas representadas por nmeros pareados en la x-expression y y-
expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

steyx (y-expression, x-expression)

Funciones de agregacin estadstica en expresiones de grficos


Se pueden utilizar las siguientes funciones de agregacin estadstica en grficos:

avg
Avg() devuelve la media agregada de los valores que encuentra en la expresin o campo que se repiten en
las dimensiones del grfico.

Avg - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld{, fld}


>]]} expr)

correl
Correl() devuelve el coeficiente de correlacin agregado de dos conjuntos de datos. La funcin de
correlacin es una medida de la relacin entre los conjuntos de datos y se agrega para pares de valores (x,y)
que se repiten por las dimensiones del grfico.

Correl - funcin de grfico({[SetExpression] [TOTAL [<fld {, fld}>]]}


value1, value2 )

fractile
Fractile() halla el valor que corresponde al percentil (cuantil) de los datos agregados en el rango dado por la
expresin que se repite a lo largo de las dimensiones del grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 192


5 Funciones en scripts y en expresiones de grfico

Fractile - funcin de grfico({[SetExpression] [TOTAL [<fld {, fld}>]]}


expr, fraction)

kurtosis
Kurtosis() halla la kurtosis del rango de datos agregados en la expresin o campo que se repiten a lo largo
de las dimensiones del grfico.

Kurtosis - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld{,


fld}>]]} expr)

linest_b
LINEST_B() devuelve el valor b agregado (interceptador de y) de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_R2 - funcin de grfico({[SetExpression] [TOTAL [<fld{ ,fld}>]] }y_


value, x_value[, y0_const[, x0_const]])

linest_df
LINEST_DF() devuelve los grados de libertad agregados de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las expresiones x_
value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_DF - funcin de grfico({[SetExpression] [TOTAL [<fld{, fld}>]]} y_


value, x_value [, y0_const [, x0_const]])

linest_f
LINEST_F() devuelve la estadstica F agregada (r2/(1-r2)) de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las expresiones x_
value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_F - funcin de grfico({[SetExpression] [TOTAL[<fld{, fld}>]]} y_


value, x_value [, y0_const [, x0_const]])

linest_m
LINEST_M() devuelve el valor m agregado (pendiente) de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las expresiones x_
value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_M - funcin de grfico({[SetExpression] [TOTAL[<fld{, fld}>]]} y_


value, x_value [, y0_const [, x0_const]])

linest_r2
LINEST_R2() devuelve el valor r2 agregado (coeficiente de determinacin) de una regresin lineal definida
por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 193


5 Funciones en scripts y en expresiones de grfico

LINEST_R2 - funcin de grfico({[SetExpression] [TOTAL [<fld{ ,fld}>]] }y_


value, x_value[, y0_const[, x0_const]])

linest_seb
LINEST_SEB() devuelve el error estndar agregado del valor b de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_SEB - funcin de grfico({[SetExpression] [TOTAL [<fld{ ,fld}>]] }y_


value, x_value[, y0_const[, x0_const]])

linest_sem
LINEST_SEM() devuelve el error estndar agregado del valor m de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_SEM - funcin de grfico([{set_expression}][ distinct ] [total [<fld


{,fld}>] ] y-expression, x-expression [, y0 [, x0 ]] )

linest_sey
LINEST_SEY() devuelve el error estndar agregado de la estimacin y de una regresin lineal definida por
la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_SEY - funcin de grfico({[SetExpression] [TOTAL [<fld{ ,fld}>]] }y_


value, x_value[, y0_const[, x0_const]])

linest_ssreg
LINEST_SSREG() devuelve la suma de regresin agregada de los cuadrados de una regresin lineal
definida por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados
dados por las expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_SSREG - funcin de grfico({[SetExpression] [TOTAL [<fld{ ,fld}>]] }


y_value, x_value[, y0_const[, x0_const]])

linest_ssresid
LINEST_SSRESID() devuelve la suma residual agregada de los cuadrados de una regresin lineal definida
por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

LINEST_SSRESID - funcin de grficoLINEST_SSRESID() devuelve la suma


residual agregada de los cuadrados de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros
emparejados dados por las expresiones x_value e y_value que se repiten a lo
largo de las dimensiones del grfico. LINEST_SSRESID([{SetExpression}]
[DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_value[, y0_const[, x0_const]])
Tipo de datos devueltos: numrico ArgumentoDescripciny_valueLa expresin o

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 194


5 Funciones en scripts y en expresiones de grfico

campo que contiene el rango de valores y que se han de medir.x_valueLa


expresin o campo que contiene el rango de valores x que se han de
medir.y0, x0Se puede especificar un valor y0 opcional que obligue a la
lnea de regresin a pasar por el eje y en un determinado punto.
Especificando tanto y0 como x0 es posible forzar a la lnea de regresin a
que atraviese una nica coordenada fija. A menos que se especifiquen ambos
y0 y x0, la funcin requiere al menos dos pares de datos vlidos para
calcularse. Si se especifican y0 y x0, un nico par de datos
bastar. SetExpressionPor defecto, la funcin de agregacin agregar sobre
el conjunto de registros posibles definidos por la seleccin. Se podra
definir un conjunto alternativo de registros mediante una expresin de
anlisis de conjuntos. DISTINCTSi la palabra DISTINCT aparece antes que los
argumentos de funcin, los duplicados resultantes de la evaluacin de los
argumentos de funcin sern descartados. TOTALSi la palabra TOTAL aparece
antes de los argumentos de la funcin, el clculo se realiza con todos los
valores posibles segn las selecciones actuales, y no solo con los que
pertenecen al valor dimensional actual, es decir, ignora las dimensiones
del grfico. El cualificador TOTAL puede ir seguido de una lista con uno o
ms nombres de campo entre parntesis angulares <fld>. Estos nombres de
campo deberan ser un subgrupo de las variables de dimensin del grfico.Se
puede especificar un valor y0 opcional que obligue a la lnea de regresin
a pasar por el eje y en un determinado punto. Especificando tanto y0 como
x0 es posible forzar a la lnea de regresin a que atraviese una nica
coordenada fija. La expresin no debe contener funciones de agregacin, a
menos que dichas agregaciones internas contengan el cualificador TOTAL.
Para agregaciones anidadas ms avanzadas, utilice la funcin de agregacin
avanzada Aggr en combinacin con dimensiones calculadas. Los valores de
texto, valores NULL y valores perdidos en una o ambas partes de un par de
datos harn que se descarte el par de datos completo. An example of how to
use linest functionsavg({[SetExpression] [TOTAL [<fld{ ,fld}>]] }y_value,
x_value[, y0_const[, x0_const]])

median
Median() devuelve el valor de la mediana del rango de valores agregados en la expresin que se repite a lo
largo de las dimensiones del grfico.

Median - funcin de grfico({[SetExpression] [TOTAL [<fld{, fld}>]]} expr)

skew
Skew() devuelve la asimetra agregada de la expresin o campo que se repiten en las dimensiones del
grfico.

Skew - funcin de grfico{[SetExpression] [DISTINCT] [TOTAL [<fld{ ,fld}


>]]} expr)

stdev

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 195


5 Funciones en scripts y en expresiones de grfico

Stdev() halla la desviacin estndar del rango de datos agregados en la expresin o campo que se repiten a
lo largo de las dimensiones del grfico.

Stdev - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld{, fld}


>]]} expr)

sterr
Sterr() halla el valor de error estndar de la media, (stdev/sqrt(n)), de la serie de valores agregados en la
expresin que se repite a lo largo de las dimensiones del grfico.

Sterr - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL[<fld{, fld}


>]]} expr)

steyx
STEYX() devuelve el error estndar agregado al predecir valores y para cada valor x en una regresin lineal
definida por una serie de coordenadas representadas por nmeros emparejados dados por las expresiones
y_value y x_value.

STEYX - funcin de grfico{[SetExpression] [TOTAL [<fld{, fld}>]]} y_value,


x_value)

avg
Esta funcin de script devuelve la media de la expresin a lo largo de un nmero de registros definidos por
una clusula group by.

Sintaxis:

avg([distinct] expression)

Argumentos:

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplo:

LOAD Month, avg(Sales) as AverageSalesPerMonth from abc.csv group by Month;

Avg - funcin de grfico


Avg() devuelve la media agregada de los valores que encuentra en la expresin o campo que se repiten en
las dimensiones del grfico.

Sintaxis:

Avg([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Tipo de datos devueltos: numrico

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 196


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Ejemplos y resultados:

Customer Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec

Astrida 46 60 70 13 78 20 45 65 78 12 78 22

Betacab 65 56 22 79 12 56 45 24 32 78 55 15

Canutility 77 68 34 91 24 68 57 36 44 90 67 27

Divadip 57 36 44 90 67 27 57 68 47 90 80 94

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 197


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
Avg(Sales) Para una tabla que incluya la dimensin Customer y la medida Avg([Sales]), si se
muestran los Totales, el resultado es 2566.
Avg([TOTAL 53,458333 para todos los valores de Customer, porque el cualificador TOTAL significa que
(Sales))
las dimensiones se omiten.
Avg(DISTINCT 51,862069 para el total, porque usar el cualificador Distinct significa que solo se evalan
(Sales))
los valores exclusivos de Sales para cada Customer.

Datos empleados en los ejemplos:

Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];
Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');
Para ordenar los meses correctamente cuando cree sus visualizaciones, dirjase a la seccin Ordenar del
panel de propiedades, seleccione Mes y active la casilla Ordenar por expresin. En el cuadro de
expresin, escriba Monthnumber.

Vea tambin:

p Aggr - funcin de grfico (pgina 143)

correl
Esta funcin de script devuelve el coeficiente de correlacin agregado de una serie de coordenadas
representadas por nmeros pares en las x-expression e y-expression, reiteradas sobre un nmero de
registros definidos por una clusula group by.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 198


5 Funciones en scripts y en expresiones de grfico

correl(x-expression, y-expression)

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Month, correl(X,Y) as CC from abc.csv group by Month;

Correl - funcin de grfico


Correl() devuelve el coeficiente de correlacin agregado de dos conjuntos de datos. La funcin de
correlacin es una medida de la relacin entre los conjuntos de datos y se agrega para pares de valores (x,y)
que se repiten por las dimensiones del grfico.

Sintaxis:

Correl([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] value1, value2 )

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value1, value2 Las expresiones o campos que contienen los dos conjuntos de muestra para los que se
ha de medir el coeficiente de correlacin.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 199


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplos y resultados:

Ejemplo Resultado
Correl Para una tabla que incluya la dimensin Employee name y la medida Correl(Age, Salary), es
(Age,
resultado es 0,9270611. El resultado solo se muestra para la celda de totales.
Salary)

Correl 0,927. Este resultado junto con los siguientes se muestran con tres decimales para mejorar
(TOTAL
la legibilidad.
Age,
Salary)) Si crea un panel de filtrado con la dimensin Gender, y efecta selecciones desde el mismo,
ver el resultado 0,951 cuando Female est seleccionado y 0,939 si Male est seleccionado.
Esto es porque la seleccin excluye todos los resultados que no pertenecen al otro valor de
Gender.
Correl 0,927. Independiente de las selecciones. Esto es porque la expresin de conjunto {1}
({1}
descarta todas las selecciones y dimensiones.
TOTAL
Age,
Salary))

Correl 0,927 en la celda del total, 0,939 para todos los valores de Male, y 0.951 para todos los
(TOTAL
valores de Female. Esto corresponde a los resultados de hacer las selecciones en un panel
<Gender>
de filtrado basado en Gender.
Age,
Salary))

Datos empleados en los ejemplos:

Salary:
LOAD * inline [
"Employee name"|Gender|Age|Salary
Aiden Charles|Male|20|25000
Brenda Davies|Male|25|32000
Charlotte Edberg|Female|45|56000
Daroush Ferrara|Male|31|29000
Eunice Goldblum|Female|31|32000
Freddy Halvorsen|Male|25|26000
Gauri Indu|Female|36|46000
Harry Jones|Male|38|40000
Ian Underwood|Male|40|45000
Jackie Kingsley|Female|23|28000
] (delimiter is '|');

Vea tambin:

p Aggr - funcin de grfico (pgina 143)

p Avg - funcin de grfico (pgina 196)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 200


5 Funciones en scripts y en expresiones de grfico

p RangeCorrel (pgina 498)

fractile
Esta funcin de script devuelve el fractile de la expresin a lo largo de un nmero de registros definidos por
una clusula group by

Sintaxis:

fractile(expression, fractile)

Ejemplo:

LOAD Class, fractile( Grade, 0.75 ) as F from abc.csv group by Class;

Fractile - funcin de grfico


Fractile() halla el valor que corresponde al percentil (cuantil) de los datos agregados en el rango dado por la
expresin que se repite a lo largo de las dimensiones del grfico.

Sintaxis:

Fractile([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr,


fraction)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

fraction Un nmero entre 0 y 1 correspondiente al percentil (cuantil expresado como fraccin)


que se debe calcular.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 201


5 Funciones en scripts y en expresiones de grfico

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Ejemplos y resultados:

Customer Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec

Astrida 46 60 70 13 78 20 45 65 78 12 78 22

Betacab 65 56 22 79 12 56 45 24 32 78 55 15

Canutility 77 68 34 91 24 68 57 36 44 90 67 27

Divadip 57 36 44 90 67 27 57 68 47 90 80 94

Ejemplo Resultado
Fractile Para una tabla que incluya la dimensin Customer y la medida Fractile([Sales]), si se
(Sales,
muestran los Totales, el resultado es 71,75. Este es el punto en la distribucin de valores
0.75)
de Sales por debajo del cual se sitan el 75% de los valores.
Fractile 71,75 para todos los valores de Customer, porque el cualificador TOTAL significa que las
(TOTAL
dimensiones se omiten.
Sales,
0.75))

Fractile 70 para el total, porque usar el cualificador DISTINCT significa que solo se evalan los
(DISTINCT
valores exclusivos de Sales para cada Customer.
Sales,
0.75)

Datos empleados en los ejemplos:

Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];
Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 202


5 Funciones en scripts y en expresiones de grfico

Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');
Para ordenar los meses correctamente cuando cree sus visualizaciones, dirjase a la seccin Ordenar del
panel de propiedades, seleccione Mes y active la casilla Ordenar por expresin. En el cuadro de
expresin, escriba Monthnumber.

Vea tambin:

p Aggr - funcin de grfico (pgina 143)

kurtosis
Esta funcin de script devuelve la kurtosis de la expresin a lo largo de un nmero de registros definidos por
una clusula group by.

Sintaxis:

kurtosis([distinct ] expression )

Argumentos:

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Ejemplo:

LOAD Month, kurtosis(Sales) as SalesKurtosis from abc.csv group by Month;

Kurtosis - funcin de grfico


Kurtosis() halla la kurtosis del rango de datos agregados en la expresin o campo que se repiten a lo largo
de las dimensiones del grfico.

Sintaxis:

Kurtosis([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 203


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Ejemplos y resultados:

Valu
Type
e

Comparis 2 2 3 3 1 1 1 3 3 1 2 3 2 1 2 1 3 2 3 2
on 7 8 1 9 4 9 7

Observati 35 4 1 1 2 1 4 1 2 4 1 3 3 4 3 2 1 3 1 2
on 0 2 5 1 4 6 0 8 8 6 0 2 8 1 2 2 9 9 5

Ejemplo Resultado
Kurtosis Para una tabla que incluya la dimensin Type y la medida Kurtosis(Value), si se muestran los
(Value)
Totales para la tabla, y el formato numrico est fijado en 3 cifras significativas, el resultado
es 1.252. Para Comparison es 1,161 y para Observation es 1,115.
Kurtosis 1,252 para todos los valores de Type, ya que el cualificador TOTAL indica que las dimensiones
(TOTAL
se omiten.
Value))

Datos empleados en los ejemplos:

Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27
12|38
15|31

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 204


5 Funciones en scripts y en expresiones de grfico

21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');

Vea tambin:

p Avg - funcin de grfico (pgina 196)

linest_b
Esta funcin de script devuelve el valor b agregado (que intercepta a y) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

linest_b (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_b(Y,X) as Z from abc.csv group by Key;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 205


5 Funciones en scripts y en expresiones de grfico

LINEST_B - funcin de grfico


LINEST_B() devuelve el valor b agregado (interceptador de y) de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_B([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value [, y0_const [ , x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0_const, x0_ Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
const el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 206


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_df
Esta funcin de script devuelve los grados de libertad agregados de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

linest_df (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_df(Y,X) as Z from abc.csv group by Key;

LINEST_DF - funcin de grfico


LINEST_DF() devuelve los grados de libertad agregados de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las expresiones x_
value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_DF([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value [, y0_const [, x0_const]])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 207


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 208


5 Funciones en scripts y en expresiones de grfico

linest_f
Esta funcin de script devuelve la estadstica F agregada (r2/(1-r2)) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

linest_f (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_f(Y,X) as Z from abc.csv group by Key;

LINEST_F - funcin de grfico


LINEST_F() devuelve la estadstica F agregada (r2/(1-r2)) de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las expresiones x_
value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_F([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value [, y0_const [, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 209


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_m
Esta funcin de script devuelve el valor m agregado (pendiente) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 210


5 Funciones en scripts y en expresiones de grfico

linest_m (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_m(Y,X) as Z from abc.csv group by Key;

LINEST_M - funcin de grfico


LINEST_M() devuelve el valor m agregado (pendiente) de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las expresiones x_
value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_M([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value [, y0_const [, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 211


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_r2
Esta funcin de script devuelve el valor r2 agregado (coeficiente de determinacin) de una regresin lineal
definida por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la
x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

Sintaxis:

linest_r2 (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 212


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_r2(Y,X) as Z from abc.csv group by Key;

LINEST_R2 - funcin de grfico


LINEST_R2() devuelve el valor r2 agregado (coeficiente de determinacin) de una regresin lineal definida
por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_R2([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value[, y0_const[, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 213


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_seb
Esta funcin de script devuelve el error estndar agregado del valor b de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

linest_seb (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 214


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_seb(Y,X) as Z from abc.csv group by Key;

LINEST_SEB - funcin de grfico


LINEST_SEB() devuelve el error estndar agregado del valor b de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_SEB([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value[, y0_const[, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 215


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_sem
Esta funcin de script devuelve el error estndar agregado del valor m de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

linest_sem (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 216


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_sem(Y,X) as Z from abc.csv group by Key;

LINEST_SEM - funcin de grfico


LINEST_SEM() devuelve el error estndar agregado del valor m de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_SEM([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value[, y0_const[, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 217


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_sey
Esta funcin de script devuelve el error estndar agregado de la estimacin y de una regresin lineal definida
por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-
expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

Sintaxis:

linest_sey (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_sey(Y,X) as Z from abc.csv group by Key;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 218


5 Funciones en scripts y en expresiones de grfico

LINEST_SEY - funcin de grfico


LINEST_SEY() devuelve el error estndar agregado de la estimacin y de una regresin lineal definida por
la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_SEY([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_


value[, y0_const[, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 219


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

linest_ssreg
Esta funcin de script devuelve la suma de regresin agregada de los cuadrados de una regresin lineal
definida por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la
x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

Sintaxis:

linest_ssreg (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_ssreg(Y,X) as Z from abc.csv group by Key;

LINEST_SSREG - funcin de grfico


LINEST_SSREG() devuelve la suma de regresin agregada de los cuadrados de una regresin lineal
definida por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados
dados por las expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 220


5 Funciones en scripts y en expresiones de grfico

LINEST_SSREG([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value,


x_value[, y0_const[, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 221


5 Funciones en scripts y en expresiones de grfico

p Avg - funcin de grfico (pgina 196)

linest_ssresid
Esta funcin de script devuelve la suma residual agregada de los cuadrados de una regresin lineal definida
por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-
expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

Sintaxis:

linest_ssresid (y-expression, x-expression [, y0 [, x0 ]])

Argumentos:

Argumento Descripcin

y(0), x(0) Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, linest_ssresid(Y,X) as Z from abc.csv group by Key;

LINEST_SSRESID - funcin de grfico


LINEST_SSRESID() devuelve la suma residual agregada de los cuadrados de una regresin lineal definida
por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros emparejados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

LINEST_SSRESID([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value,


x_value[, y0_const[, x0_const]])

Tipo de datos devueltos: numrico

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 222


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y que se han de medir.

x_value La expresin o campo que contiene el rango de valores x que se han de medir.

y0, x0 Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por
el eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la
lnea de regresin a que atraviese una nica coordenada fija.

A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos


dos pares de datos vlidos para calcularse. Si se especifican y0 y x0, un
nico par de datos bastar.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el eje y en un
determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea de regresin a que atraviese
una nica coordenada fija.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Vea tambin:

p Un ejemplo de cmo utilizar las funciones linest (pgina 234)

p Avg - funcin de grfico (pgina 196)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 223


5 Funciones en scripts y en expresiones de grfico

median
Esta funcin de script devuelve la mediana agregada de la expresin a lo largo de un nmero de registros
definidos por una clusula group by.

Sintaxis:

median (expression)

Ejemplo:

LOAD Class, Median(Grade) as MG from abc.csv group by Class;

Median - funcin de grfico


Median() devuelve el valor de la mediana del rango de valores agregados en la expresin que se repite a lo
largo de las dimensiones del grfico.

Sintaxis:

Median([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 224


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Valu
Type
e

Comparis 2 2 3 3 1 1 1 3 3 1 2 3 2 1 2 1 3 2 3 2
on 7 8 1 9 4 9 7

Observati 35 4 1 1 2 1 4 1 2 4 1 3 3 4 3 2 1 3 1 2
on 0 2 5 1 4 6 0 8 8 6 0 2 8 1 2 2 9 9 5

Ejemplo Resultado
Median Para una tabla que incluye la dimensin Type y la medida Median(Value), si se muestran los
(Value)
Totales, el resultado es 19, para Comparison es 2,5 y para Observation es 26,5.
Median 19 para todos los valores de Type, porque el cualificador TOTAL significa que las
(TOTAL
dimensiones se omiten.
Value))

Datos empleados en los ejemplos:

Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27
12|38
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');

Vea tambin:

p Avg - funcin de grfico (pgina 196)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 225


5 Funciones en scripts y en expresiones de grfico

skew
Esta funcin de script devuelve la asimetra de la expresin a lo largo de un nmero de registros definidos
por una clusula group by.

Sintaxis:

skew([ distinct] expression)

Ejemplo:

LOAD Month, skew(Sales) as SalesSkew from abc.csv group by Month;

Skew - funcin de grfico


Skew() devuelve la asimetra agregada de la expresin o campo que se repiten en las dimensiones del
grfico.

Sintaxis:

Skew([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 226


5 Funciones en scripts y en expresiones de grfico

Valu
Type
e

Comparis 2 2 3 3 1 1 1 3 3 1 2 3 2 1 2 1 3 2 3 2
on 7 8 1 9 4 9 7

Observati 35 4 1 1 2 1 4 1 2 4 1 3 3 4 3 2 1 3 1 2
on 0 2 5 1 4 6 0 8 8 6 0 2 8 1 2 2 9 9 5

Ejemplo Resultado
Skew Para una tabla que incluya la dimensin Type y la medida Skew(Value), si se muestran los
(Value)
Totales y el formato numrico est fijado en 3 cifras significativas, el resultado es 0,235. Para
Comparison es 0,864 y para Observation es 0,3265.

Skew 0,235 para todos los valores de Type, ya que el cualificador TOTAL indica que las dimensiones
(TOTAL
se omiten.
Value))

Datos empleados en los ejemplos:

Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27
12|38
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');

Vea tambin:

p Avg - funcin de grfico (pgina 196)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 227


5 Funciones en scripts y en expresiones de grfico

stdev
Esta funcin de script devuelve la desviacin estndar de la expresin a lo largo de un nmero de registros
definidos por una clusula group by.

Sintaxis:

stdev([distinct] expression)

Argumentos:

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

LOAD Month, stdev(Sales) as SalesStandardDeviation from abc.csv group by Month;

Stdev - funcin de grfico


Stdev() halla la desviacin estndar del rango de datos agregados en la expresin o campo que se repiten a
lo largo de las dimensiones del grfico.

Sintaxis:

Stdev([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 228


5 Funciones en scripts y en expresiones de grfico

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Ejemplos y resultados:

Valu
Type
e

Comparis 2 2 3 3 1 1 1 3 3 1 2 3 2 1 2 1 3 2 3 2
on 7 8 1 9 4 9 7

Observati 35 4 1 1 2 1 4 1 2 4 1 3 3 4 3 2 1 3 1 2
on 0 2 5 1 4 6 0 8 8 6 0 2 8 1 2 2 9 9 5

Ejemplo Resultado
Stdev Para una tabla que incluye la dimensin Type y la medida Stdev(Value), si se muestran los
(Value)
Totales, el resultado es 15,475, para Comparison es 14,612 y para Observation es 12,508.
Stdev es 15,475 para todos los valores de Type, porque el cualificador TOTAL significa que las
(TOTAL
dimensiones se omiten.
Value))

Datos empleados en los ejemplos:

Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27
12|38
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 229


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Avg - funcin de grfico (pgina 196)

p STEYX - funcin de grfico (pgina 232)

sterr
Esta funcin de script devuelve el error estndar agregado (stdev/sqrt(n)) de una serie de valores
representados por expresin que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.

Sintaxis:

sterr ([distinct] expression)

Argumentos:

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplo:

LOAD Key, sterr(X) as Z from abc.csv group by Key;

Sterr - funcin de grfico


Sterr() halla el valor de error estndar de la media, (stdev/sqrt(n)), de la serie de valores agregados en la
expresin que se repite a lo largo de las dimensiones del grfico.

Sintaxis:

Sterr([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 230


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

definidos por la seleccin. Se podra definir un conjunto alternativo de registros


mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos y resultados:

Valu
Type
e

Comparis 2 2 3 3 1 1 1 3 3 1 2 3 2 1 2 1 3 2 3 2
on 7 8 1 9 4 9 7

Observati 35 4 1 1 2 1 4 1 2 4 1 3 3 4 3 2 1 3 1 2
on 0 2 5 1 4 6 0 8 8 6 0 2 8 1 2 2 9 9 5

Ejemplo Resultado
Sterr Para una tabla que incluye la dimensin Type y la medida Sterr(Value), si se muestran los
(Value)
Totales, el resultado es 2,447, para Comparison es 3,267 y para Observation es 2,797.
Sterr 2,447 para todos los valores de Type, porque el cualificador TOTAL significa que las
(TOTAL
dimensiones se omiten.
Value))

Datos empleados en los ejemplos:

Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 231


5 Funciones en scripts y en expresiones de grfico

12|38
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');

Vea tambin:

p Avg - funcin de grfico (pgina 196)

p STEYX - funcin de grfico (pgina 232)

steyx
Esta funcin de script devuelve el error estndar agregado del valor y predicho para cada valor x en la
regresin para una serie de coordenadas representadas por nmeros pareados en la x-expression y y-
expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:

steyx (y-expression, x-expression)

Limitaciones:

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplo:

LOAD Key, steyx(Y,X) as Z from abc.csv group by Key;

STEYX - funcin de grfico


STEYX() devuelve el error estndar agregado al predecir valores y para cada valor x en una regresin lineal
definida por una serie de coordenadas representadas por nmeros emparejados dados por las expresiones
y_value y x_value.

Sintaxis:

STEYX([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_value)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 232


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

y_value La expresin o campo que contiene el rango de valores y conocidos que se han de
medir.

x_value La expresin o campo que contiene el rango de valores x conocidos que se han de
medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

La expresin no debe contener funciones de agregacin, a menos que dichas agregaciones internas
contengan el cualificador TOTAL. Para agregaciones anidadas ms avanzadas, utilice la funcin de
agregacin avanzada Aggr en combinacin con dimensiones calculadas.

Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.

Ejemplos y resultados:

Data series

KnownX 17 16 14 11 10 8 7 6 5 5 5 4

KnownY 15 14 12 9 9 10 6 2 3 5 8 7

Ejemplo Resultado
Steyx(KnownY,KnownX) 2,071 (Si el formato numrico est limitado a 3 decimales.)
Steyx(TOTAL 2,071 en todas las dimensiones, si no se realizan selecciones.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 233


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
KnownY,KnownX)) 2,121 en todas las dimensiones, si se han realizado las selecciones 4, 5 y 6 para
KnownX, por ejemplo.

Datos empleados en los ejemplos:

Trend:
LOAD * inline [
Month,KnownY,KnownX
Jan,2,6
Feb,3,5
Mar,9,11
Apr,6,7
May,8,5
Jun,7,4
Jul,5,5
Aug,10,8
Sep,9,10
Oct,12,14
Nov,15,17
Dec,14,16
] (delimiter is ',';

Vea tambin:

p Avg - funcin de grfico (pgina 196)

p Sterr - funcin de grfico (pgina 230)

Un ejemplo de cmo utilizar las funciones linest


Las funciones linest sirven para hallar valores asociados con anlisis de regresin lineal. Esta seccin
describe cmo construir las visualizaciones utilizando datos de muestra para hallar los valores de las
funciones linest disponibles en Qlik Sense. Le remitimos a los temas de funciones de grficos linest para
descripciones de la sintaxis y argumentos.

Cargar los datos de muestra


Haga lo siguiente:

1. Cree una nueva app.


2. En el editor de carga de datos, introduzca lo siguiente:
T1:
LOAD *, 1 as Grp;
LOAD * inline [
X |Y
1| 0
2|1
3|3
4| 8
5| 14

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 234


5 Funciones en scripts y en expresiones de grfico

6| 20
7| 0
8| 50
9| 25
10| 60
11| 38
12| 19
13| 26
14| 143
15| 98
16| 27
17| 59
18| 78
19| 158
20| 279 ] (delimiter is '|');
R1:
LOAD
Grp,
linest_B(Y,X) as Linest_B,
linest_DF(Y,X) as Linest_DF,
linest_F(Y,X) as Linest_F,
linest_M(Y,X) as Linest_M,
linest_R2(Y,X) as Linest_R2,
linest_SEB(Y,X,1,1) as Linest_SEB,
linest_SEM(Y,X) as Linest_SEM,
linest_SEY(Y,X) as Linest_SEY,
linest_SSREG(Y,X) as Linest_SSREG,
linest_SSRESID(Y,X) as Linest_SSRESID
resident T1 group by Grp;

3. Haga clic en l para cargar los datos.

Crear visualizaciones linest de funciones de grficos


1. En el editor de carga de datos, haga clic en para ir a la vista de la app, cree una nueva hoja y
brala.

2. Haga clic en @Editar para editar la hoja.


3. Desde Grficos aada un grfico de lneas, y desde Campos aada X como dimensin y Sum(Y)
como medida.
Se crea un grfico de lneas que representa el grfico de X contrastado con Y, desde donde se
calculan las funciones linest.
4. En Grficos, aada una tabla con las siguientes expresiones como dimensiones:
ValueList('Linest_b', 'Linest_df','Linest_f', 'Linest_m','Linest_r2','Linest_SEB','Linest_
SEM','Linest_SEY','Linest_SSREG','Linest_SSRESID')
Esto usa la funcin de dimensiones sintticas para crear etiquetas para las dimensiones con los
nombres de las funciones linest. Puede cambiar la etiqueta a Funciones Linest para ahorrar
espacio.
5. Aada la siguiente expresin a la tabla como medida:
Pick(Match(ValueList('Linest_b', 'Linest_df','Linest_f', 'Linest_m','Linest_r2','Linest_
SEB','Linest_SEM','Linest_SEY','Linest_SSREG','Linest_SSRESID'),'Linest_b', 'Linest_
df','Linest_f', 'Linest_m','Linest_r2','Linest_SEB','Linest_SEM','Linest_SEY','Linest_
SSREG','Linest_SSRESID'),Linest_b(Y,X),Linest_df(Y,X),Linest_f(Y,X),Linest_m(Y,X),Linest_r2
(Y,X),Linest_SEB(Y,X,1,1),Linest_SEM(Y,X),Linest_SEY(Y,X),Linest_SSREG(Y,X),Linest_SSRESID
(Y,X) )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 235


5 Funciones en scripts y en expresiones de grfico

Esto muestra el valor del resultado de cada funcin linest contrastado con el correspondiente nombre
de la dimensin sinttica. El resultado de Linest_b(Y,X) se muestra junto a linest_b, etc.

Resultado

Linest functions Linest function results

Linest_b -35.047

Linest_df 18

Linest_f 20.788

Linest_m 8.605

Linest_r2 0.536

Linest_SEB 22.607

Linest_SEM 1.887

Linest_SEY 48.666

Linest_SSREG 49235.014

Linest_SSRESID 42631.186

Las tablas de los datos de muestra que contengan una medida que utilice funciones linest presentaran el
siguiente aspecto:

Linest_B Linest_DF Linest_F Linest_M Linest_R2 Linest_SEB

-35.047 18 20.788 8.605 0.536 22.607

Linest_SEM Linest_SEY Linest_SSREG Linest_SSRESID

1.887 48.666 49235.014 42631.186

Funciones estadsticas de prueba


En esta seccin se describen las funciones de prueba estadsticas, que se dividen en tres categoras: Las
funciones pueden utilizarse tanto en el script de carga de datos como en expresiones de grficos, pero la
sintaxis difiere.

Funciones de prueba Chi-2


Generalmente se utiliza en el estudio de variables cualitativas. Uno puede comparar las frecuencias
observadas en una tabla de frecuencia de una direccin con frecuencias esperadas, o estudiar la conexin
entre dos variables en una tabla de contingencias.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 236


5 Funciones en scripts y en expresiones de grfico

Funciones de prueba T
Un examen estadstico de dos promedios de poblacin. Una prueba t de dos muestras analiza si dos
muestras son distintas. Es muy habitual utilizarla cuando dos distribuciones normales tienen variaciones
conocidas y cuando un experimento utiliza una muestra pequea.

Funciones de prueba Z
Un examen estadstico de dos promedios de poblacin. Una prueba z de dos muestras analiza si dos
muestras son distintas y es muy habitual cuando dos distribuciones normales tienen variaciones
conocidas y cuando un experimento usa un gran tamao de muestra.

Funciones de prueba Chi2


Generalmente se utiliza en el estudio de variables cualitativas. Uno puede comparar las frecuencias
observadas en una tabla de frecuencia de una direccin con frecuencias esperadas, o estudiar la conexin
entre dos variables en una tabla de contingencias.

Funciones e prueba Chi2 en el script de carga de datos


Chi2Test_p
Esta funcin de script devuelve el valor agregado p (significacin) de la prueba chi2 agregado de una o dos
series de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Chi2Test_p (col, row, observed_value [, expected_value])

Chi2Test_df
Esta funcin de script devuelve el valor df agregado (grados de libertad ) de la prueba chi2 de una o dos
series de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Chi2Test_df (col, row, observed_value [, expected_value])

Chi2Test_chi2
Esta funcin de script devuelve el valor chi2 agregado de una o dos series de valores que se repiten a lo largo
de varios registros definidos por una clusula group by.

Chi2Test_chi2 (col, row, observed_value [, expected_value])

Funciones de prueba chi2 en grficos


Chi2Test_chi2
Chi2Test_chi2() devuelve el valor agregado de la prueba chi2 de una o dos series de valores que se repiten
a lo largo de las dimensiones del grfico.

Chi2Test_chi2 - funcin de grfico(col, row, actual_value[, expected_


value])

chi2test_df
Chi2Test_df() devuelve el valor df (grado de libertad) agregado de la prueba chi2 de una o dos series de

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 237


5 Funciones en scripts y en expresiones de grfico

valores que se repiten a lo largo de las dimensiones del grfico.

Chi2Test_df - funcin de grfico(col, row, actual_value[, expected_value])

Chi2test_p
Chi2Test_p() devuelve el valor p (significacin) de la prueba chi2 de una o dos series de valores que se
repiten a lo largo de las dimensiones del grfico.

Chi2Test_p - funcin de grfico(col, row, actual_value[, expected_value])

Vea tambin:

p Funciones de prueba t en grficos (pgina 242)

p Funciones de prueba z en grficos (pgina 301)

Chi2Test_chi2
Esta funcin de script devuelve el valor chi2 agregado de una o dos series de valores que se repiten a lo largo
de varios registros definidos por una clusula group by.

Sintaxis:

Chi2Test_chi2 (col, row, observed_value [, expected_value])

Argumentos:

Argumento Descripcin

col La columna especificada en la matriz de valores que se estn probando.

row La fila especificada en la matriz de valores que se estn probando.

observed_value El valor observado de los datos en la columna y fila col y row especificadas.

expected_value El valor esperado para la distribucin en la columna y fila col y row especificadas.

Ejemplo:

LOAD Year, Chi2Test_chi2(Gender,Description,Observed,Expected) as X from abc.csv group by Year;

Chi2Test_chi2 - funcin de grfico


Chi2Test_chi2() devuelve el valor agregado de la prueba chi2 de una o dos series de valores que se repiten
a lo largo de las dimensiones del grfico.

Todas las funciones de prueba Qlik Sensechi2 tienen los mismos argumentos.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 238


5 Funciones en scripts y en expresiones de grfico

Chi2Test_chi2(col, row, actual_value[, expected_value])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

col, row La columna y fila especificadas en la matriz de valores que se estn probando..

actual_value El valor observado de los datos en la columna y fila col y row especificadas.

expected_value El valor esperado para la distribucin en la columna y fila col y row especificadas.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

Chi2Test_chi2( Grp, Grade, Count )


Chi2Test_chi2( Gender, Description, Observed, Expected )

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba chi2 (pgina 323)

Chi2Test_df
Esta funcin de script devuelve el valor df agregado (grados de libertad ) de la prueba chi2 de una o dos
series de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

Chi2Test_df (col, row, observed_value [, expected_value])

Argumentos:

Argumento Descripcin

col La columna especificada en la matriz de valores que se estn probando.

row La fila especificada en la matriz de valores que se estn probando.

observed_value El valor observado de los datos en la columna y fila col y row especificadas.

expected_value El valor esperado para la distribucin en la columna y fila col y row especificadas.

Ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 239


5 Funciones en scripts y en expresiones de grfico

LOAD Year, Chi2Test_df(Gender,Description,Observed,Expected) as X from abc.csv group by Year;

Chi2Test_df - funcin de grfico


Chi2Test_df() devuelve el valor df (grado de libertad) agregado de la prueba chi2 de una o dos series de
valores que se repiten a lo largo de las dimensiones del grfico.

Todas las funciones de prueba Qlik Sensechi2 tienen los mismos argumentos.

Sintaxis:

Chi2Test_df(col, row, actual_value[, expected_value])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

col, row La columna y fila especificadas en la matriz de valores que se estn probando.

actual_value El valor observado de los datos en la columna y fila col y row especificadas.

expected_value El valor esperado para la distribucin en la columna y fila col y row especificadas.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

Chi2Test_df( Grp, Grade, Count )


Chi2Test_df( Gender, Description, Observed, Expected )

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba chi2 (pgina 323)

Chi2Test_p - funcin de grfico


Chi2Test_p() devuelve el valor p (significacin) de la prueba chi2 de una o dos series de valores que se
repiten a lo largo de las dimensiones del grfico. La prueba puede realizarse sobre los valores de actual_
value, probando las variaciones dentro de la matriz de col y row que se haya especificado, o bien
comparando los valores de actual_value con los correspondientes valores de expected_value, si se
especifican.

Todas las funciones de prueba Qlik Sensechi2 tienen los mismos argumentos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 240


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

Chi2Test_p(col, row, actual_value[, expected_value])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

col, row La columna y fila especificadas en la matriz de valores que se estn probando.

actual_value El valor observado de los datos en la columna y fila col y row especificadas.

expected_value El valor esperado para la distribucin en la columna y fila col y row especificadas.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

Chi2Test_p( Grp, Grade, Count )


Chi2Test_p( Gender, Description, Observed, Expected )

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba chi2 (pgina 323)

Chi2Test_p
Esta funcin de script devuelve el valor agregado p (significacin) de la prueba chi2 agregado de una o dos
series de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

La prueba puede realizarse sobre los valores de observed_value, probando las variaciones dentro de la
matriz de col y row que se haya especificado, o bien comparando los valores de observed_value con los
correspondientes valores de expected_values. Los valores de texto, valores NULL y valores inexistentes en
las expresiones de valores darn como resultado que la funcin devuelva NULL.

Sintaxis:

Chi2Test_p (col, row, observed_value [, expected_value])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 241


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

col La columna especificada en la matriz de valores que se estn probando.

row La fila especificada en la matriz de valores que se estn probando.

observed_value El valor observado de los datos en la columna y fila col y row especificadas.

expected_value El valor esperado para la distribucin en la columna y fila col y row especificadas.

Ejemplo:

LOAD Year, Chi2Test_p(Gender,Description,Observed,Expected) as X from abc.csv group by Year

Funciones de prueba t en grficos


Un examen estadstico de dos promedios de poblacin. Una prueba t de dos muestras analiza si dos
muestras son distintas. Es muy habitual utilizarla cuando dos distribuciones normales tienen variaciones
conocidas y cuando un experimento utiliza una muestra pequea.

En los siguientes apartados, las funciones de prueba estadstica de prueba t se agrupan conforme a la
prueba de muestra de estudiante que se aplica a cada tipo de funcin.

Funciones de prueba t en el script de carga de datos


Dos pruebas t de muestra independientes
Las ocho funciones descritas a continuacin se aplican a pruebas t de estudiante de dos muestras
independientes.

TTest_t
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

TTest_t (group, value [, eq_var = true])

TTest_df
Esta funcin de script devuelve el valor df (degrees of freedom, grados de libertad) agregado de la prueba t
de estudiante de dos series independientes de valores que se repiten a lo largo de varios registros definidos
por una clusula group by.

TTest_df (group, value [, eq_var = true])

TTest_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
dos series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

TTest_sig (group, value [, eq_var = true])

TTest_dif

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 242


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest_dif (group, value [, eq_var = true])

TTest_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de dos series independientes de valores que se repiten a lo largo de varios registros definidos por una
clusula group by.

TTest_sterr (group, value [, eq_var = true])

TTest_conf
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

TTest_conf (group, value [, sig = 0.025 [, eq_var = true]])

TTest_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest_lower (group, value [, sig = 0.025 [, eq_var = true]])

TTest_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

TTest_upper (group, value [, sig = 0.025 [, eq_var = true]])

Dos pruebas t ponderadas de muestra independientes


Las ocho funciones que a continuacin se describen se aplican a pruebas t de estudiante de dos muestras
independientes, en las que la serie de datos de entrada se suministra en un formato de dos columnas
ponderadas.

TTestw_t
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

TTestw_t (weight, group, value [, eq_var = true])

TTestw_df
Esta funcin de script devuelve el valor df (degrees of freedom, grados de libertad) agregado de la prueba t
de estudiante de dos series independientes de valores que se repiten a lo largo de varios registros definidos
por una clusula group by.

TTestw_df (weight, group, value [, eq_var = true])

TTestw_sig

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 243


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
dos series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

TTestw_sig (weight, group, value [, eq_var = true])

TTestw_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTestw_dif (weight, group, value [, eq_var = true])

TTestw_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de dos series independientes de valores que se repiten a lo largo de varios registros definidos por una
clusula group by.

TTestw_sterr (weight, group, value [, eq_var = true])

TTestw_conf
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

TTestw_conf (weight, group, value [, sig = 0.025 [, eq_var = true]])

TTestw_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTestw_lower (weight, group, value [, sig = 0.025 [, eq_var = true]])

TTestw_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

TTestw_upper (weight, group, value [, sig = 0.025 [, eq_var = true]])

Pruebas t de una muestra


Las ocho funciones siguientes se aplican a pruebas t de estudiante de una muestra.

TTest1_t
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

TTest1_t (value)

TTest1_df
Esta funcin de script devuelve el valor df (degrees of freedom, grados de libertad) agregado de la prueba t

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 244


5 Funciones en scripts y en expresiones de grfico

de estudiante de una serie independiente de valores que se repiten a lo largo de varios registros definidos por
una clusula group by.

TTest1_df (value)

TTest1_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
una serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1_sig (value)

TTest1_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1_dif (value)

TTest1_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de una serie de valores que se repiten a lo largo de varios registros definidos por una clusula group
by.

TTest1_sterr (value)

TTest1_conf
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

TTest1_conf (value [, sig = 0.025 ])

TTest1_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1_lower (value [, sig = 0.025 ])

TTest1_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1_upper (value [, sig = 0.025 ])

Pruebas t ponderadas de una muestra


Las ocho funciones siguientes se aplican a pruebas t de estudiante de una muestra en las que los datos de
entrada se suministran en un formato de dos columnas ponderadas.

TTest1w_t
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 245


5 Funciones en scripts y en expresiones de grfico

TTest1w_t (weight, value)

TTest1w_df
Esta funcin de script devuelve el valor t (degrees of freedom, grados de libertad) agregado de la prueba df
de estudiante de una serie independiente de valores que se repiten a lo largo de varios registros definidos por
una clusula group by.

TTest1w_df (weight, value)

TTestw_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
una serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1w_sig (weight, value)

TTest1w_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1w_dif (weight, value)

TTest1w_sterr
Esta funcin de script devuelve el error estndar agregado de la diferencia de medias de una serie de valores
que se repiten a lo largo de varios registros definidos por una clusula group by.clusula.

TTest1w_sterr (weight, value)

TTest1w_conf
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

TTest1w_conf (weight, value [, sig = 0.025 ])

TTest1w_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1w_lower (weight, value [, sig = 0.025 ])

TTest1w_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

TTest1w_upper (weight, value [, sig = 0.025 ])

Funciones de prueba t en expresiones de grfico

Ejemplo:

p Crear un informe de prueba t tpico (pgina 326)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 246


5 Funciones en scripts y en expresiones de grfico

Dos pruebas t de muestra independientes


Las funciones descritas a continuacin se aplican a pruebas t de estudiante de dos muestras independientes.

ttest_conf
TTest_conf devuelve el valor del intervalo de confianza de prueba t agregado de dos muestras
independientes que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de muestras independientes.

TTest_conf - funcin de grfico ( grp, value [, sig[, eq_var]])

ttest_df
TTest_df() devuelve el valor agregado de la prueba t de estudiante (grado de libertad) de dos series de
valores independientes que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a
pruebas t de estudiante de muestras independientes.

TTest_df - funcin de grfico (grp, value [, eq_var)

ttest_dif
TTest_dif() es una funcin numrica que devuelve la diferencia de medias agregada de una prueba t de
estudiante de dos series independientes de valores que se repiten a lo largo de las dimensiones de un
grfico.Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

TTest_dif - funcin de grfico (grp, value)

ttest_lower
TTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a
pruebas t de estudiante de muestras independientes.

TTest_lower - funcin de grfico (grp, value [, sig[, eq_var]])

ttest_sig
TTest_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de dos series
independientes de valores no pareadas que se repiten a lo largo de las dimensiones del grfico.Esta funcin
se aplica a pruebas t de estudiante de muestras independientes.

TTest_sig - funcin de grfico (grp, value [, eq_var])

ttest_sterr
TTest_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media de
dos series independientes de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se
aplica a pruebas t de estudiante de muestras independientes.

TTest_sterr - funcin de grfico (grp, value [, eq_var])

ttest_t
TTest_t() devuelve el valor t agregado de dos series independientes de valores que se repiten a lo largo de

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 247


5 Funciones en scripts y en expresiones de grfico

las dimensiones del grfico.Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

TTest_t - funcin de grfico (grp, value [, eq_var])

ttest_upper
TTest_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a
pruebas t de estudiante de muestras independientes.

TTest_upper - funcin de grfico (grp, value [, sig [, eq_var]])

Dos pruebas t ponderadas de muestra independientes


Las funciones siguientes se aplican a dos pruebas t de estudiante de dos muestras independientes, en las
que la serie de los datos de entrada se suministra en un formato de dos columnas ponderadas.

ttestw_conf
TTestw_conf() devuelve el valor t agregado de dos series independientes de valores que se repiten a lo
largo de las dimensiones del grfico.Esta funcin se aplica a dos pruebas t de estudiante de dos muestras
independientes, en las que la serie de datos de entrada se suministra en un formato de dos columnas
ponderadas.

TTestw_conf - funcin de grfico (weight, grp, value [, sig[, eq_var]])

ttestw_df
TTestw_df() devuelve el valor df (grado de libertad) agregado de la prueba t de estudiante de dos series de
valores independientes que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a dos
pruebas t de estudiante de dos muestras independientes, en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.

TTestw_df - funcin de grfico (weight, grp, value [, eq_var])

ttestw_dif
TTestw_dif() devuelve la diferencia de media agregada de la prueba t de estudiante de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grficoEsta funcin se aplica a
dos pruebas t de estudiante de dos muestras independientes, en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.

TTestw_dif - funcin de grfico ( weight, grp, value)

ttestw_lower
TTestw_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a
dos pruebas t de estudiante de dos muestras independientes, en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.

TTestw_lower - funcin de grfico (weight, grp, value [, sig[, eq_var]])

ttestw_sig
TTestw_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de dos series

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 248


5 Funciones en scripts y en expresiones de grfico

independientes de valores no pareadas que se repiten a lo largo de las dimensiones del grfico.Esta funcin
se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de datos de
entrada se suministra en un formato de dos columnas ponderadas.

TTestw_sig - funcin de grfico ( weight, grp, value [, eq_var])

ttestw_sterr
TTestw_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media
de dos series independientes de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin
se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de datos de
entrada se suministra en un formato de dos columnas ponderadas.

TTestw_sterr - funcin de grfico (weight, grp, value [, eq_var])

ttestw_t
TTestw_t() devuelve el valor t agregado de dos series independientes de valores que se repiten a lo largo de
las dimensiones del grfico.

TTestw_t - funcin de grfico (weight, grp, value [, eq_var])

ttestw_upper
TTestw_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se
aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de datos de entrada
se suministra en un formato de dos columnas ponderadas.

TTestw_upper - funcin de grfico (weight, grp, value [, sig [, eq_var]])

Pruebas t de una muestra


Las funciones siguientes se aplican a pruebas t de estudiante de una muestra.

ttest1_conf
TTest1_conf() devuelve el valor del intervalo de confianza agregado de una serie de valores que se repiten a
lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

TTest1_conf - funcin de grfico (value [, sig])

ttest1_df
TTest1_df() devuelve el valor df (grado de libertad) agregado de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una sola muestra.

TTest1_df - funcin de grfico (value)

ttest1_dif
TTest1_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una sola muestra.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 249


5 Funciones en scripts y en expresiones de grfico

TTest1_dif - funcin de grfico (value)

ttest1_lower
TTest1_lower() devuelve el valor agregado, para el extremo inferior del intervalo de confianza, de una serie
de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una sola muestra.

TTest1_lower - funcin de grfico (value [, sig])

ttest1_sig
TTest1_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba t de estudiante de una serie
de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una sola muestra.

TTest1_sig - funcin de grfico (value)

ttest1_sterr
TTest1_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba t de estudiante
para una serie de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a
pruebas t de estudiante de una sola muestra.

TTest1_sterr - funcin de grfico (value)

ttest1_t
TTest1_t() devuelve el valor t agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

TTest1_t - funcin de grfico (value)

ttest1_upper
TTest1_upper() devuelve el valor agregado, para el extremo superior del intervalo de confianza, de una
serie de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una sola muestra.

TTest1_upper - funcin de grfico (value [, sig])

Pruebas t ponderadas de una muestra


Las funciones siguientes se aplican a pruebas t de estudiante de una muestra en las que los datos de
entrada se suministran en un formato de dos columnas ponderadas.

ttest1w_conf
TTest1w_conf() es una funcin numrica que devuelve el valor de intervalo de confianza agregado de una
serie de valores que se repiten a lo largo de las dimensiones de un grfico.Esta funcin se aplica a pruebas t
de estudiante de una muestra en las que los datos de entrada se suministran en un formato de dos columnas
ponderadas.

TTest1w_conf - funcin de grfico (weight, value [, sig])

ttest1w_df

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 250


5 Funciones en scripts y en expresiones de grfico

TTest1w_df() devuelve el valor df (grado de libertad) agregado de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una muestra en las que los datos de entrada se suministran en un formato de dos columnas
ponderadas.

TTest1w_df - funcin de grfico (weight, value)

ttest1w_dif
TTest1w_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una muestra en las que los datos de entrada se suministran en un formato de dos columnas
ponderadas.

TTest1w_dif - funcin de grfico (weight, value)

ttest1w_lower
TTest1w_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una muestra en las que los datos de entrada se suministran en un formato de dos columnas
ponderadas.

TTest1w_lower - funcin de grfico (weight, value [, sig])

ttest1w_sig
TTest1w_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba t de estudiante de una
serie de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una muestra en las que los datos de entrada se suministran en un formato de dos columnas
ponderadas.

TTest1w_sig - funcin de grfico (weight, value)

ttest1w_sterr
TTest1w_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba t de
estudiante para una serie de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se
aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se suministran en un
formato de dos columnas ponderadas.

TTest1w_sterr - funcin de grfico (weight, value)

ttest1w_t
TTest1_t() devuelve el valor t agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada
se suministran en un formato de dos columnas ponderadas.

TTest1w_t - funcin de grfico ( weight, value)

ttest1w_upper
TTest1w_upper() devuelve el valor agregado, para el extremo superior del intervalo de confianza, de una

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 251


5 Funciones en scripts y en expresiones de grfico

serie de valores que se repiten a lo largo de las dimensiones del grfico.Esta funcin se aplica a pruebas t de
estudiante de una muestra en las que los datos de entrada se suministran en un formato de dos columnas
ponderadas.

TTest1w_upper - funcin de grfico (weight, value [, sig])

TTest_conf
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest_conf (group, value [, sig = 0.025 [, eq_var = true]])

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_conf(Group, Value) as X from abc.csv group by Year;

TTest_conf - funcin de grfico


TTest_conf devuelve el valor del intervalo de confianza de prueba t agregado de dos muestras
independientes que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 252


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

TTest_conf ( grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_conf( Group, Value )


TTest_conf( Group, Value, Sig, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest_df
Esta funcin de script devuelve el valor df (degrees of freedom, grados de libertad) agregado de la prueba t
de estudiante de dos series independientes de valores que se repiten a lo largo de varios registros definidos
por una clusula group by.

Sintaxis:

TTest_df (group, value [, eq_var = true])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 253


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_df(Group, Value) as X from abc.csv group by Year;

TTest_df - funcin de grfico


TTest_df() devuelve el valor agregado de la prueba t de estudiante (grado de libertad) de dos series de
valores independientes que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

TTest_df (grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 254


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_df( Group, Value )


TTest_df( Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest_dif (group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 255


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_dif(Group, Value) as X from abc.csv group by Year;

TTest_dif - funcin de grfico


TTest_dif() es una funcin numrica que devuelve la diferencia de medias agregada de una prueba t de
estudiante de dos series independientes de valores que se repiten a lo largo de las dimensiones de un
grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

TTest_dif (grp, value [, eq_var] )

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_dif( Group, Value )


TTest_dif( Group, Value, false )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 256


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest_lower (group, value [, sig = 0.025 [, eq_var = true]])

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_lower(Group, Value) as X from abc.csv group by Year;

TTest_lower - funcin de grfico


TTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 257


5 Funciones en scripts y en expresiones de grfico

TTest_lower (grp, value [, sig [, eq_var]])

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_lower( Group, Value )


TTest_lower( Group, Value, Sig, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
dos series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

Sintaxis:

TTest_sig (group, value [, eq_var = true])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 258


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ttest_sig(Group, Value) as X from abc.csv group by Year;

TTest_sig - funcin de grfico


TTest_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de dos series
independientes de valores no pareadas que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

TTest_sig (grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 259


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_sig( Group, Value )


TTest_sig( Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de dos series independientes de valores que se repiten a lo largo de varios registros definidos por una
clusula group by.

Sintaxis:

TTest_sterr (group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 260


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_sterr(Group, Value) as X from abc.csv group by Year;

TTest_sterr - funcin de grfico


TTest_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media de
dos series independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

TTest_sterr (grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_sterr( Group, Value )


TTest_sterr( Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 261


5 Funciones en scripts y en expresiones de grfico

TTest_t
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest_t (group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_t(Group, Value) as X from abc.csv group by Year;

TTest_t - funcin de grfico


TTest_t() devuelve el valor t agregado de dos series independientes de valores que se repiten a lo largo de
las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Para poder utilizar esta funcin debemos cargar valores de muestra en el script empleando
crosstable.

Sintaxis:

TTest_t(grp, value[, eq_var])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 262


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

p Crear un informe de prueba t tpico (pgina 326)

TTest_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

Sintaxis:

TTest_upper (group, value [, sig = 0.025 [, eq_var = true]])

Argumentos:

Argumento Descripcin

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 263


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

Si no se introduce un nombre de campo para los valores de muestra en el script de carga,


el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest_upper(Group, Value) as X from abc.csv group by Year;

TTest_upper - funcin de grfico


TTest_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

TTest_upper (grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 264


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest_upper( Group, Value )


TTest_upper( Group, Value, sig, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_conf
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTestw_conf (weight, group, value [, sig = 0.025 [, eq_var = true]])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 265


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_conf(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_conf - funcin de grfico


TTestw_conf() devuelve el valor t agregado de dos series independientes de valores que se repiten a lo
largo de las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_conf (weight, grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 266


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_conf( Weight, Group, Value )


TTestw_conf( Weight, Group, Value, sig, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_df
Esta funcin de script devuelve el valor df (degrees of freedom, grados de libertad) agregado de la prueba t
de estudiante de dos series independientes de valores que se repiten a lo largo de varios registros definidos
por una clusula group by.

Sintaxis:

TTestw_df (weight, group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 267


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_df(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_df - funcin de grfico


TTestw_df() devuelve el valor df (grado de libertad) agregado de la prueba t de estudiante de dos series de
valores independientes que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_df (weight, grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_df( Weight, Group, Value )


TTestw_df( Weight, Group, Value, false )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 268


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTestw_dif (weight, group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_dif(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_dif - funcin de grfico


TTestw_dif() devuelve la diferencia de media agregada de la prueba t de estudiante de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 269


5 Funciones en scripts y en expresiones de grfico

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_dif (weight, group, value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_dif( Weight, Group, Value )


TTestw_dif( Weight, Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTestw_lower (weight, group, value [, sig = 0.025 [, eq_var = true]])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 270


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_lower(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_lower - funcin de grfico


TTestw_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_lower (weight, grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 271


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_lower( Weight, Group, Value )


TTestw_lower( Weight, Group, Value, sig, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
dos series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

Sintaxis:

TTestw_sig (weight, group, value [, eq_var = true])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 272


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_sig(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_sig - funcin de grfico


TTestw_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de dos series
independientes de valores no pareadas que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_sig ( weight, grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 273


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_sig( Weight, Group, Value )


TTestw_sig( Weight, Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de dos series independientes de valores que se repiten a lo largo de varios registros definidos por una
clusula group by.

Sintaxis:

TTestw_sterr (weight, group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 274


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_sterr(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_sterr - funcin de grfico


TTestw_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media
de dos series independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_sterr (weight, grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 275


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_sterr( Weight, Group, Value )


TTestw_sterr( Weight, Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_t
Esta funcin de script devuelve el valor t agregado de dos series independientes de valores que se repiten a
lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTestw_t (weight, group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 276


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LLoad Year, TTestw_t(Weight, Group, Value) as X from abc.csv group by Year;

TTestw_t - funcin de grfico


TTestw_t() devuelve el valor t agregado de dos series independientes de valores que se repiten a lo largo de
las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

ttestw_t (weight, grp, value [, eq_var])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_t( Weight, Group, Value )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 277


5 Funciones en scripts y en expresiones de grfico

TTestw_t( Weight, Group, Value, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTestw_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de varios registros definidos por una clusula
group by.

Sintaxis:

TTestw_upper (weight, group, value [, sig = 0.025 [, eq_var = true]])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_upper(Weight, Group, Value) as X from abc.csv group by Year;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 278


5 Funciones en scripts y en expresiones de grfico

TTestw_upper - funcin de grfico


TTestw_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis:

TTestw_upper (weight, grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTestw_upper( Weight, Group, Value )


TTestw_upper( Weight, Group, Value, sig, false )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 279


5 Funciones en scripts y en expresiones de grfico

TTest1_conf
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

TTest1_conf (value [, sig = 0.025 ])

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_conf(Value) as X from abc.csv group by Year;

TTest1_conf - funcin de grfico


TTest1_conf() devuelve el valor del intervalo de confianza agregado de una serie de valores que se repiten a
lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_conf (value [, sig ])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

valor Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 280


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest1_conf( Value )
TTest1_conf( Value, 0.005 )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1_df
Esta funcin de script devuelve el valor df (degrees of freedom, grados de libertad) agregado de la prueba t
de estudiante de una serie independiente de valores que se repiten a lo largo de varios registros definidos por
una clusula group by.

Sintaxis:

TTest1_df (value)

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_df(Value) as X from abc.csv group by Year;

TTest1_df - funcin de grfico


TTest1_df() devuelve el valor df (grado de libertad) agregado de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_df (value)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 281


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1_df( Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest1_dif (value)

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_dif(Value) as X from abc.csv group by Year;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 282


5 Funciones en scripts y en expresiones de grfico

TTest1_dif - funcin de grfico


TTest1_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_dif (value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1_dif( Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest1_lower (value [, sig = 0.025 ])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 283


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

value Los valores deben ser devueltos por value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_lower(Value) as X from abc.csv group by Year;

TTest1_lower - funcin de grfico


TTest1_lower() devuelve el valor agregado, para el extremo inferior del intervalo de confianza, de una serie
de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_lower (value [, sig])

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest1_lower( Value )
TTest1_lower( Value, 0.005 )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 284


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
una serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest1_sig (value)

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_sig(Value) as X from abc.csv group by Year;

TTest1_sig - funcin de grfico


TTest1_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba t de estudiante de una serie
de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_sig (value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 285


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1_sig( Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de una serie de valores que se repiten a lo largo de varios registros definidos por una clusula group
by.

Sintaxis:

TTest1_sterr (value)

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_sterr(Value) as X from abc.csv group by Year;

TTest1_sterr - funcin de grfico


TTest1_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba t de estudiante
para una serie de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_sterr (value)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 286


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1_sterr( Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1_t
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

TTest1_t (value)

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ttest1_t(Value) as X from abc.csv group by Year;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 287


5 Funciones en scripts y en expresiones de grfico

TTest1_t - funcin de grfico


TTest1_t() devuelve el valor t agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_t (value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1_t( Value )

TTest1_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest1_upper (value [, sig = 0.025 ])

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 288


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1_upper(Value) as X from abc.csv group by Year;

TTest1_upper - funcin de grfico


TTest1_upper() devuelve el valor agregado, para el extremo superior del intervalo de confianza, de una
serie de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una sola muestra.

Sintaxis:

TTest1_upper (value [, sig])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest1_upper( Value )
TTest1_upper( Value, 0.005 )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 289


5 Funciones en scripts y en expresiones de grfico

TTest1w_conf
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

TTest1w_conf (weight, value [, sig = 0.025 ])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_conf(Weight, Value) as X from abc.csv group by Year;

TTest1w_conf - funcin de grfico


TTest1w_conf() es una funcin numrica que devuelve el valor de intervalo de confianza agregado de una
serie de valores que se repiten a lo largo de las dimensiones de un grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_conf (weight, value [, sig ])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 290


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

valores de muestra en el script de carga, el campo se nombrar automticamente como


Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest1w_conf( Weight, Value )


TTest1w_conf( Weight, Value, 0.005 )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1w_df
Esta funcin de script devuelve el valor t (degrees of freedom, grados de libertad) agregado de la prueba df
de estudiante de una serie independiente de valores que se repiten a lo largo de varios registros definidos por
una clusula group by.

Sintaxis:

TTest1w_df (weight, value)

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 291


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_df(Weight, Value) as X from abc.csv group by Year;

TTest1w_df - funcin de grfico


TTest1w_df() devuelve el valor df (grado de libertad) agregado de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_df (weight, value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1w_df( Weight, Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1w_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba t de estudiante de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 292


5 Funciones en scripts y en expresiones de grfico

TTest1w_dif (weight, value)

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_dif(Weight, Value) as X from abc.csv group by Year;

TTest1w_dif - funcin de grfico


TTest1w_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_dif (weight, value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 293


5 Funciones en scripts y en expresiones de grfico

Ejemplo:

TTest1w_dif( Weight, Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1w_lower
Esta funcin de script devuelve el valor agregado del extremo inferior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest1w_lower (weight, value [, sig = 0.025 ])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_lower(Weight, Value) as X from abc.csv group by Year;

TTest1w_lower - funcin de grfico


TTest1w_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_lower (weight, value [, sig ])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 294


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest1w_lower( Weight, Value )


TTest1w_lower( Weight, Value, 0.005 )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1w_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de
una serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

TTest1w_sig (weight, value)

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 295


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_sig(Weight, Value) as X from abc.csv group by Year;

TTest1w_sig - funcin de grfico


TTest1w_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba t de estudiante de una
serie de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_sig (weight, value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1w_sig( Weight, Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 296


5 Funciones en scripts y en expresiones de grfico

TTest1w_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de
media de dos series independientes de valores que se repiten a lo largo de varios registros definidos por una
clusula group by.

Sintaxis:

TTestw_sterr (weight, group, value [, eq_var = true])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

group El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTestw_sterr(Weight, Group, Value) as X from abc.csv group by Year;

TTest1w_sterr - funcin de grfico


TTest1w_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba t de
estudiante para una serie de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_sterr (weight, value)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 297


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1w_sterr( Weight, Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1w_t
Esta funcin de script devuelve el valor t agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

TTest1w_t (weight, value)

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 298


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_t(Weight, Value) as X from abc.csv group by Year;

TTest1w_t - funcin de grfico


TTest1w_t() es una funcin numrica que devuelve el valor t agregado de una serie de valores que se
repiten a lo largo de las dimensiones de un grfico. Esta funcin se aplica a pruebas t de estudiante de una
muestra en las que los datos de entrada se suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_t ( weight, value)

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

TTest1w_t( Weight, Value )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

TTest1w_upper
Esta funcin de script devuelve el valor agregado del extremo superior del intervalo de confianza de una serie
de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 299


5 Funciones en scripts y en expresiones de grfico

TTest1w_upper (weight, value [, sig = 0.025 ])

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, TTest1w_upper(Weight, Value) as X from abc.csv group by Year;

TTest1w_upper - funcin de grfico


TTest1w_upper() devuelve el valor agregado, para el extremo superior del intervalo de confianza, de una
serie de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de una muestra en las que los datos de entrada se
suministran en un formato de dos columnas ponderadas.

Sintaxis:

TTest1w_upper (weight, value [, sig])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 300


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

TTest1w_upper( Weight, Value )


TTest1w_upper( Weight, Value, 0.005 )

Vea tambin:

p Crear un informe de prueba t tpico (pgina 326)

Funciones de prueba z en grficos


Un examen estadstico de dos promedios de poblacin. Una prueba z de dos muestras analiza si dos
muestras son distintas y es muy habitual cuando dos distribuciones normales tienen variaciones
conocidas y cuando un experimento usa un gran tamao de muestra.

A continuacin las funciones estadsticas de prueba z se agrupan conforme al tipo de datos de entrada que
se aplica a la funcin.

Funciones de prueba z en el script de carga de datos


Funciones de formato de una columna
Las cinco funciones siguientes se aplican a pruebas z.

ZTest_z
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

ZTest_z (value [, sigma])

ZTest_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

ZTest_sig (value [, sigma])

ZTest_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba z de una serie de valores que
se repiten a lo largo de varios registros definidos por una clusula group by.

ZTest_dif (value [, sigma])

ZTest_sterr

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 301


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve el error estndar agregado de la prueba z de la diferencia de media de una
serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

ZTest_sterr (value [, sigma])

ZTest_conf
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

ZTest_conf (value [, sigma [, sig = 0.025 ])

Funciones de formato de dos columnas ponderadas


Las cinco funciones siguientes se aplican a pruebas z en las que los datos de entrada se suministran en
formato de dos columnas ponderadas.

ZTestw_z
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

ZTestw_z (weight, value [, sigma])

ZTestw_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

ZTestw_sig (weight, value [, sigma])

ZTestw_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba z de una serie de valores que
se repiten a lo largo de varios registros definidos por una clusula group by.

ZTestw_dif (weight, value [, sigma])

ZTestw_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba z de la diferencia de media de una
serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

ZTestw_sterr (weight, value [, sigma])

ZTestw_conf
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

ZTestw_conf (weight, value [, sigma [, sig = 0.025 ]])

Funciones de prueba z en expresiones de grfico


Funciones de formato de una columna
Las siguientes funciones se aplican a pruebas z con series simples de datos de entrada:

ztest_conf

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 302


5 Funciones en scripts y en expresiones de grfico

ZTest_conf() devuelve el valor z agregado de una serie de valores que se repiten a lo largo de las
dimensiones del grfico.

ZTest_conf - funcin de grfico (value [, sigma [, sig ])

ztest_dif
ZTest_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores que se
repiten a lo largo de las dimensiones del grfico.

ZTest_dif - funcin de grfico (value [, sigma])

ztest_sig
ZTest_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba z de una serie de valores que
se repiten a lo largo de las dimensiones del grfico.

ZTest_sig - funcin de grfico (value [, sigma])

ztest_sterr
ZTest_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba z para una serie
de valores que se repiten a lo largo de las dimensiones del grfico.

ZTest_sterr - funcin de grfico (value [, sigma])

ztest_z
ZTest_z() devuelve el valor z agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.

ZTest_z - funcin de grfico (value [, sigma])

ztest_lower
ZTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

ZTest_lower - funcin de grfico (grp, value [, sig [, eq_var]])

ztest_upper
ZTest_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

ZTest_upper - funcin de grfico (grp, value [, sig [, eq_var]])

Funciones de formato de dos columnas ponderadas


Las funciones siguientes se aplican a pruebasz en las que los datos de entrada se suministran en formato de
dos columnas ponderadas.

ztestw_conf
ZTestw_conf() devuelve el valor del intervalo de confianza z agregado de una serie de valores que se repiten
a lo largo de las dimensiones del grfico.

ZTestw_conf - funcin de grfico (weight, value [, sigma [, sig]])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 303


5 Funciones en scripts y en expresiones de grfico

ztestw_dif
ZTestw_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores que se
repiten a lo largo de las dimensiones del grfico.

ZTestw_dif - funcin de grfico (weight, value [, sigma])

ztestw_lower
ZTestw_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

ZTestw_lower - funcin de grfico (weight, value [, sigma])

ztestw_sig
ZTestw_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba z de una serie de valores
que se repiten a lo largo de las dimensiones del grfico.

ZTestw_sig - funcin de grfico (weight, value [, sigma])

ztestw_sterr
ZTestw_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba z para una
serie de valores que se repiten a lo largo de las dimensiones del grfico.

ZTestw_sterr - funcin de grfico (weight, value [, sigma])

ztestw_upper
ZTestw_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de las dimensiones del grfico.

ZTestw_upper - funcin de grfico (weight, value [, sigma])

ztestw_z
ZTestw_z() devuelve el valor z agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.

ZTestw_z - funcin de grfico (weight, value [, sigma])

ZTest_z
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

ZTest_z (value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 304


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTest_z(Value-TestValue) as X from abc.csv group by Year;

ZTest_z - funcin de grfico


ZTest_z() devuelve el valor z agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.

Sintaxis:

ZTest_z(value[, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTest_z( Value-TestValue )

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 305


5 Funciones en scripts y en expresiones de grfico

ZTest_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

ZTest_sig (value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTest_sig(Value-TestValue) as X from abc.csv group by Year;

ZTest_sig - funcin de grfico


ZTest_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba z de una serie de valores que
se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

ZTest_sig(value[, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 306


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTest_sig(Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTest_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba z de una serie de valores que
se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

ZTest_dif (value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTest_dif(Value-TestValue) as X from abc.csv group by Year

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 307


5 Funciones en scripts y en expresiones de grfico

ZTest_dif - funcin de grfico


ZTest_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores que se
repiten a lo largo de las dimensiones del grfico.

Sintaxis:

ZTest_dif(value[, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTest_dif(Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTest_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba z de la diferencia de media de una
serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

ZTest_sterr (value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 308


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTest_sterr(Value-TestValue) as X from abc.csv group by Year;

ZTest_sterr - funcin de grfico


ZTest_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba z para una serie
de valores que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

ZTest_sterr(value[, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTest_sterr(Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 309


5 Funciones en scripts y en expresiones de grfico

ZTest_conf
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

ZTest_conf (value [, sigma [, sig = 0.025 ])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTest_conf(Value-TestValue) as X from abc.csv group by Year;

ZTest_conf - funcin de grfico


ZTest_conf() devuelve el valor z agregado de una serie de valores que se repiten a lo largo de las
dimensiones del grfico.

Sintaxis:

ZTest_conf(value[, sigma[, sig]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 310


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTest_conf(Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTest_lower - funcin de grfico


ZTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

ZTest_lower (grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 311


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

ZTest_lower( Group, Value )


ZTest_lower( Group, Value, sig, false )

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTest_upper - funcin de grfico


ZTest_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

ZTest_upper (grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 312


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

ZTest_upper( Group, Value )


ZTest_upper( Group, Value, sig, false )

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTestw_z
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

ZTestw_z (weight, value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 313


5 Funciones en scripts y en expresiones de grfico

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTestw_z(Weight,Value-TestValue) as X from abc.csv group by Year;

ZTestw_z - funcin de grfico


ZTestw_z() devuelve el valor z agregado de una serie de valores que se repiten a lo largo de las dimensiones
del grfico.

Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.

Sintaxis:

ZTestw_z (weight, value [, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

valor Los valores deben ser devueltos por value. Se asume una media de 0 como muestra. Si
desea que el test se realice conforme a otra media distinta, reste dicho valor de los valores
de muestra.

weight Cada valor de muestra en value puede contarse una o ms veces dependiendo de su
correspondiente valor de peso en weight.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTestw_z( Weight, Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 314


5 Funciones en scripts y en expresiones de grfico

ZTestw_sig
Esta funcin de script devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de
valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

ZTestw_sig (weight, value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTestw_sig(Weight,Value-TestValue) as X from abc.csv group by Year;

ZTestw_sig - funcin de grfico


ZTestw_sig() devuelve el nivel de significacin de cola 2 agregado de la prueba z de una serie de valores
que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.

Sintaxis:

ZTestw_sig (weight, value [, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 315


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

valor Los valores deben ser devueltos por value. Se asume una media de 0 como muestra. Si
desea que el test se realice conforme a otra media distinta, reste dicho valor de los valores
de muestra.

weight Cada valor de muestra en value puede contarse una o ms veces dependiendo de su
correspondiente valor de peso en weight.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTestw_sig( Weight, Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTestw_dif
Esta funcin de script devuelve la diferencia de media agregada de la prueba z de una serie de valores que
se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

ZTestw_dif (weight, value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 316


5 Funciones en scripts y en expresiones de grfico

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTestw_dif(Weight,Value-TestValue) as X from abc.csv group by Year;

ZTestw_dif - funcin de grfico


ZTestw_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores que se
repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.

Sintaxis:

ZTestw_dif ( weight, value [, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

valor Los valores deben ser devueltos por value. Se asume una media de 0 como muestra. Si
desea que el test se realice conforme a otra media distinta, reste dicho valor de los valores
de muestra.

weight Cada valor de muestra en value puede contarse una o ms veces dependiendo de su
correspondiente valor de peso en weight.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTestw_dif( Weight, Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 317


5 Funciones en scripts y en expresiones de grfico

ZTestw_sterr
Esta funcin de script devuelve el error estndar agregado de la prueba z de la diferencia de media de una
serie de valores que se repiten a lo largo de varios registros definidos por una clusula group by.

Sintaxis:

ZTestw_sterr (weight, value [, sigma])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTestw_sterr(Weight,Value-TestValue) as X from abc.csv group by Year;

ZTestw_sterr - funcin de grfico


ZTestw_sterr() devuelve el error estndar agregado de la diferencia de medias de una prueba z para una
serie de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.

Sintaxis:

ZTestw_sterr (weight, value [, sigma])

Tipo de datos devueltos: numrico

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 318


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

valor Los valores deben ser devueltos por value. Se asume una media de 0 como muestra. Si
desea que el test se realice conforme a otra media distinta, reste dicho valor de los valores
de muestra.

weight Cada valor de muestra en value puede contarse una o ms veces dependiendo de su
correspondiente valor de peso en weight.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplo:

ZTestw_sterr( Weight, Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTestw_conf
Esta funcin de script devuelve el valor z agregado de una serie de valores que se repiten a lo largo de varios
registros definidos por una clusula group by.

Sintaxis:

ZTestw_conf (weight, value [, sigma [, sig = 0.025 ]])

Se supone una media de poblacin de 0. Si desea que el test se realice conforme a otra media distinta, reste
dicho valor de los valores de muestra.

Argumentos:

Argumento Descripcin

weight Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente
valor de peso en weight.

value Los valores deben ser devueltos por value.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 319


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

utilizar la desviacin estndar de la muestra.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, valores NULL y los valores perdidos en value darn como resultado que la funcin
devuelva NULL.

Ejemplo:

LOAD Year, ZTestw_conf(Weight,Value-TestValue) as X from abc.csv group by Year;

ZTestw_conf - funcin de grfico


ZTestw_conf() devuelve el valor del intervalo de confianza z agregado de una serie de valores que se repiten
a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.

Sintaxis:

ZTest_conf(weight, value[, sigma[, sig]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

valor Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.

weight Cada valor de muestra en value puede contarse una o ms veces dependiendo de su
correspondiente valor de peso en weight.

sigma Si se conoce, la desviacin estndar se puede indicar en sigma. Si se omite sigma, se


utilizar la desviacin estndar de la muestra.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 320


5 Funciones en scripts y en expresiones de grfico

Ejemplo:

ZTestw_conf( Weight, Value-TestValue)

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTestw_lower - funcin de grfico


ZTestw_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Sintaxis:

ZTestw_lower (grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

ZTestw_lower( Group, Value )


ZTestw_lower( Group, Value, sig, false )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 321


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

ZTestw_upper - funcin de grfico


ZTestw_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos
series independientes de valores que se repiten a lo largo de las dimensiones del grfico.

Esta funcin se aplica a pruebas t de estudiante de muestras independientes.

Sintaxis:

ZTestw_upper (grp, value [, sig [, eq_var]])

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

value Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.

grp El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.

sig El nivel de significacin de cola 2 se puede especificar en sig. Si se omite, sig se fijar en
0,025, dando como resultado un intervalo de confianza del 95%.

eq_var Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.

Limitaciones:

Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.

Ejemplos:

ZTestw_upper( Group, Value )


ZTestw_upper( Group, Value, sig, false )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 322


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Ejemplos de cmo utilizar funciones de prueba z (pgina 329)

Ejemplos de funciones estadsticas de prueba para grficos


En esta seccin aparecen ejemplos de funciones estadsticas de prueba aplicadas a grficos.

Ejemplos de cmo utilizar funciones de prueba chi2


Las funciones chi2-test sirven para hallar valores asociados con anlisis estadstico de chi al cuadrado. Esta
seccin describe cmo construir visualizaciones utilizando datos de muestra para hallar los valores de las
funciones de prueba de distribucin de Chi al cuadrado disponibles en Qlik Sense. Le remitimos a los temas
de funciones de grficos chi2-test para descripciones de la sintaxis y argumentos.

Cargar los datos para las muestras


Hay tres conjuntos de datos de muestra que describen tres muestras estadsticas diferentes para cargarlas
en el script.

Haga lo siguiente:

1. Cree una nueva app.


2. Al cargar datos, introduzca lo siguiente:
// Sample_1 data is pre-aggregated... Note: make sure you set your DecimalSep='.' at the top
of the script.
Sample_1:
LOAD * inline [
Grp,Grade,Count
I,A,15
I,B,7
I,C,9
I,D,20
I,E,26
I,F,19
II,A,10
II,B,11
II,C,7
II,D,15
II,E,21
II,F,16
];
// Sample_2 data is pre-aggregated: If raw data is used, it must be aggregated using count
()...
Sample_2:
LOAD * inline [
Sex,Opinion,OpCount
1,2,58
1,1,11
1,0,10
2,2,35
2,1,25
2,0,23 ] (delimiter is ',');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 323


5 Funciones en scripts y en expresiones de grfico

// Sample_3a data is transformed using the crosstable statement...


Sample_3a:
crosstable(Gender, Actual) LOAD
Description,
[Men (Actual)] as Men,
[Women (Actual)] as Women;
LOAD * inline [
Men (Actual),Women (Actual),Description
58,35,Agree
11,25,Neutral
10,23,Disagree ] (delimiter is ',');
// Sample_3b data is transformed using the crosstable statement...
Sample_3b:
crosstable(Gender, Expected) LOAD
Description,
[Men (Expected)] as Men,
[Women (Expected)] as Women;
LOAD * inline [
Men (Expected),Women (Expected),Description
45.35,47.65,Agree
17.56,18.44,Neutral
16.09,16.91,Disagree ] (delimiter is ',');
// Sample_3a and Sample_3b will result in a (fairly harmless) Synthetic Key...

3. Haga clic en l para cargar datos.

Crear visualizaciones chi2-test de funciones de grficos

Ejemplo: Muestra 1

Haga lo siguiente:

1. En el editor de carga de script, haga clic en para ir a la vista de app y, a continuacin, haga clic en
la hoja que cre anteriormente.
Se abre la vista de hoja.

2. Haga clic en @Editar para editar la hoja.


3. Desde Grficos aada una tabla, y desde Campos aada GrpGrade y Count como dimensiones.
Esta tabla muestra los datos de muestra.
4. Aada otra tabla con la siguiente expresin como dimensin:
ValueList('p','df','Chi2')
Esto usa la funcin de dimensiones sintticas para crear etiquetas para las dimensiones con los
nombres de las tres funciones chi2-test.
5. Aada la siguiente expresin a la tabla como medida:
IF(ValueList('p','df','Chi2')='p',Chi2Test_p(Grp,Grade,Count),
IF(ValueList('p','df','Chi2')='df',Chi2Test_df(Grp,Grade,Count),
Chi2Test_Chi2(Grp,Grade,Count)))
Esto produce el efecto de poner el valor resultante de cada funcin chi2-test de la tabla junto a su
dimensin sinttica asociada.
6. Establezca el Formato numrico de la medida en Nmero y 3Cifras significativas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 324


5 Funciones en scripts y en expresiones de grfico

En la expresin de la medida, podra utilizar la siguiente expresin en vez: Pick(Match


(ValueList('p','df','Chi2'),'p','df','Chi2'),Chi2Test_p(Grp,Grade,Count),Chi2Test_df
(Grp,Grade,Count),Chi2Test_Chi2(Grp,Grade,Count))

Resultado

La tabla resultante para las funciones chi2-test de los datos de la Muestra 1 contendr los siguientes valores:

p df Chi2

0.820 5 2.21

Ejemplo: Muestra 2

Haga lo siguiente:

1. En la hoja que estaba editando en el ejemplo de la Muestra 1, en Grficos, aada una tabla y, en
Campos, aada Sex, Opinion y OpCount como dimensiones.
2. Haga una copia de la tabla de resultados de la Muestra 1 utilizando los comandos Copiar y Pegar.
Edite la expresin de la medida y reemplace los argumentos en las tres funciones chi2-test por los
nombres de los campos empleados en los datos de la Muestra 2, por ejemplo: Chi2Test_p
(Sex,Opinion,OpCount).

Resultado

La tabla resultante para las funciones chi2-test de los datos de la Muestra 2 contendr los siguientes valores:

p df Chi2

0.000309 2 16.2

Ejemplo: Muestra 3

Haga lo siguiente:

1. Cree dos tablas ms de la misma manera que en los ejemplos de los datos para la Muestra 1 y
Muestra 2. En la tabla de dimensiones, utilice los campos siguientes como dimensiones: Gender,
Description, Actual y Expected.
2. En la tabla de resultados, utilice los nombres de los campos empleados en los datos de la Muestra 3,
por ejemplo: Chi2Test_p(Gender,Description,Actual,Expected).

Resultado

La tabla resultante para las funciones chi2-test de los datos de la Muestra 3 contendr los siguientes valores:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 325


5 Funciones en scripts y en expresiones de grfico

p df Chi2

0.000308 2 16.2

Crear un informe de prueba t tpico


Un informe t-test de estudio tpico incluye tablas con resultados de Group Statistics y Independent
Samples Test. En las siguientes secciones, crearemos estas tablas con las funciones Qlik Senset-test
aplicadas a dos grupos de muestras independientes: Observation y Comparison. Las tablas
correspondientes para estas muestras tendrn el siguiente aspecto:

Group Statistics

Type N Mean Standard Deviation Standard Error Mean

Comparison 20 11.95 14.61245 3.2674431

Observation 20 27.15 12.507997 2.7968933

Independent Sample Test

95% 95%
Confidence Confidence
Sig. Standard
Mean Interval of Interval of
t df (2- Error
Difference the the
tailed) Difference
Difference Difference
(Lower) (Upper)

Equal 3.534 37.116717335823 0.001 15.2 4.30101 6.48625 23.9137


Variance
not
Assumed

Equal 3.534 38 0.001 15.2 4.30101 6.49306 23.9069


Variance
Assumed

Cargar los datos de muestra


Haga lo siguiente:

1. Cree una nueva app con una nueva hoja y abra dicha hoja.
2. Introduzca lo siguiente en el editor de carga de script:
Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 326


5 Funciones en scripts y en expresiones de grfico

12|38
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');
En este script de carga, recno() debe incluirse porque crosstable requiere tres argumentos. As
pues, recno() simplemente proporciona un argumento extra, en este caso un ID para cada fila. Sin l,
los valores de muestra de Comparison no se cargaran.

3. Haga clic en l para cargar datos.

Creacin de la tabla Group Statistics


1. En el editor de carga de script, haga clic en para ir a la vista de app y, a continuacin, haga clic en
la hoja que cre anteriormente.
As se abre la vista de hoja.

2. Haga clic en @Editar para editar la hoja.


3. En Grficos aada una tabla y en Campos aada las expresiones siguientes como medidas:
Etiqueta Expresin

N Count(Value)

Mean Avg(Value)

Standard Deviation Std(Value)

Standard Error Mean Sterr(Value)

4. Aada Type como una dimensin en la tabla.


5. Haga clic en Sorting y coloque Type al principio de la lista de ordenacin.
Resultado

Una tabla Group Statistics para estas muestras tendr el aspecto siguiente:
Type N Mean Standard Deviation Standard Error Mean

Comparison 20 11.95 14.61245 3.2674431

Observation 20 27.15 12.507997 2.7968933

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 327


5 Funciones en scripts y en expresiones de grfico

Creacin de la tabla Two Independent Sample Student's T-test

1. Haga clic en @Editar para editar la hoja.


2. Aada la expresin siguiente como una dimensin en la tabla. =ValueList (Dual('Equal Variance not
Assumed', 0), Dual('Equal Variance Assumed', 1))

3. En Grficos aada una tabla con las expresiones siguientes como medidas:
Etiqueta Expresin

conf if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance


Assumed', 1)),TTest_conf(Type, Value),TTest_conf(Type, Value, 0))

t if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance


Assumed', 1)),TTest_t(Type, Value),TTest_t(Type, Value, 0))

df if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance


Assumed', 1)),TTest_df(Type, Value),TTest_df(Type, Value, 0))

Sig. (2-tailed) if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance
Assumed', 1)),TTest_sig(Type, Value),TTest_sig(Type, Value, 0))

Mean Difference TTest_dif(Type, Value)

Standard Error if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance
Difference Assumed', 1)),TTest_sterr(Type, Value),TTest_sterr(Type, Value, 0))

95% Confidence if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance
Interval of the Assumed', 1)),TTest_lower(Type, Value,(1-(95)/100)/2),TTest_lower(Type,
Difference (Lower) Value,(1-(95)/100)/2, 0))

95% Confidence if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance
Interval of the Assumed', 1)),TTest_upper(Type, Value,(1-(95)/100)/2),TTest_upper
Difference (Upper) (Type, Value,(1-(95)/100)/2, 0))

Resultado
Una tabla Independent Sample Test para estas muestras tendr el aspecto siguiente:
95% 95%
Sig. Standard Confidenc Confidenc
Mean
(2- Error e Interval e Interval
t df Differenc
taile Differenc of the of the
e
d) e Difference Difference
(Lower) (Upper)

Equal 3.53 37.1167173358 0.001 15.2 4.30101 6.48625 23.9137


Varianc 4 23
e not
Assume
d

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 328


5 Funciones en scripts y en expresiones de grfico

95% 95%
Sig. Standard Confidenc Confidenc
Mean
(2- Error e Interval e Interval
t df Differenc
taile Differenc of the of the
e
d) e Difference Difference
(Lower) (Upper)

Equal 3.53 38 0.001 15.2 4.30101 6.49306 23.9069


Varianc 4
e
Assume
d

Ejemplos de cmo utilizar funciones de prueba z


Las funciones z-test sirven para hallar valores asociados con anlisis estadsticos z-test para grandes
muestras de datos (por lo general, superiores a 30) y en los que se conoce la varianza. Esta seccin describe
cmo construir las visualizaciones utilizando datos de muestra para hallar los valores de las funciones z-test
disponibles en Qlik Sense. Le remitimos a los temas de funciones de grficos z-test para descripciones de la
sintaxis y argumentos.

Cargar los datos de muestra


Los datos de muestra utilizados aqu son los mismos que los utilizados en los ejemplos de las funciones t-
test. Por lo general, el tamao de los datos de muestra se considerara demasiado pequeo para el anlisis
de pruebas z, pero es suficiente para ilustrar el uso de las distintas funciones z-test en Qlik Sense.

Haga lo siguiente:

1. Cree una nueva app con una nueva hoja y abra dicha hoja.

Si cre una app para las funciones t-test, podra utilizarla y crear una nueva hoja para
estas funciones.

2. En el editor de carga de datos, introduzca lo siguiente:


Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2
40|27
12|38
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 329


5 Funciones en scripts y en expresiones de grfico

32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');
En este script de carga, recno() debe incluirse porque crosstable requiere tres argumentos. As
pues, recno() simplemente proporciona un argumento extra, en este caso un ID para cada fila. Sin l,
los valores de muestra de Comparison no se cargaran.

3. Haga clic en l para cargar datos.

Crear visualizaciones z-test de funciones de grficos


Haga lo siguiente:

1. En el editor de carga de datos, haga clic en para ir a la vista de app y, a continuacin, haga clic en
la hoja que cre al cargar los datos.
Se abre la vista de hoja.

2. Haga clic en @Editar para editar la hoja.


3. Desde Grficos aada una tabla, y desde Campos aada Type como dimensin.
4. Aada las siguientes expresiones a la tabla como medidas.

Etiqueta Expresin

ZTest Conf ZTest_conf(Value)

ZTest Dif ZTest_dif(Value)

ZTest Sig ZTest_sig(Value)

ZTest Sterr ZTest_sterr(Value)

ZTest Z ZTest_z(Value)

Puede que desee ajustar el formato numrico de las medidas para tener unos valores con
sentido. La tabla ser ms legible si se establece el formato numrico de la mayora de las
medidas como Nmero>Simple en lugar de como Auto. Sin embargo, para ZTest Sig, por
ejemplo, utilice el formato numrico: Personalizado y, a continuacin, ajuste el patrn de
formato a ###.

Resultado

La tabla resultante para las funciones z-test de los datos de muestra contendr los siguientes valores:

Type ZTest Conf ZTest Dif ZTest Sig ZTest Sterr ZTest Z

Comparison 6.40 11.95 0.000123 3.27 3.66

Value 5.48 27.15 0.001 2.80 9.71

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 330


5 Funciones en scripts y en expresiones de grfico

Crear visualizaciones z-testw de funciones de grficos


Las funciones z-testw se utilizan cuando la serie de datos de entrada se da en un formato ponderado de dos
columnas. Las expresiones requieren un valor para el argumento weight. Los ejemplos siguientes utilizan el
valor 2, aunque puede utilizar una expresin que define un valor para weight para cada observacin.

Ejemplos y resultados:

Si utiliza los mismos datos de muestra y el mismo formato numrico que para las funciones z-test, la tabla
resultante para las funciones z-testw contendr los valores siguientes:

Type ZTestw Conf ZTestw Dif ZTestw Sig ZTestw Sterr ZTestw Z

Comparison 3.53 2.95 5.27e-005 1.80 3.88

Value 2.97 34.25 0 4.52 20.49

Funciones de agregacin en cadena


En esta seccin se describen funciones de agregacin relacionadas con las cadenas.

Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Funciones de agregacin en cadena en el script de carga de datos


concat
Esta funcin de script devuelve una concatenacin agregada de cadenas, con todos los valores de expresin
que se repiten en un cierto nmero de registros definidos por una clusula group by.

concat ([ distinct ] expression [, delimiter [, sort-weight]])

FirstValue
Esta funcin de script devuelve el primer valor por orden de carga de la expresin a lo largo de un nmero de
registros definidos por una clusula group by.

Esta funcin solo est disponible como funcin de script.

FirstValue (expression)

LastValue
Esta funcin de script devuelve el ltimo valor por orden de carga de la expresin a lo largo de un nmero de
registros definidos por una clusula group by.

Esta funcin solo est disponible como funcin de script.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 331


5 Funciones en scripts y en expresiones de grfico

LastValue (expression)

MaxString
Esta funcin de script devuelve el ltimo valor de texto de la expresin hallado en un nmero de registros
definidos por una clusula group by.

MaxString (expression )

MinString
Esta funcin de script devuelve el primer valor de texto de la expresin hallado en un nmero de registros
definidos por una clusula group by.

MinString (expression )

Funciones de agregacin de cadenas en grficos


Las siguientes funciones de grficos estn disponibles para agregacin de cadenas en grficos.

Concat
Concat()se utiliza para combinar valores de cadenas. Esta funcin devuelve la concatenacin agregada de
cadenas de todos los valores de la expresin que se evalan en cada dimensin.

Concat - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld{, fld}


>]] string[, delimiter[, sort_weight]])

MaxString
MaxString() halla valores de cadena en la expresin o campo y devuelve el ltimo valor de texto en el orden
del texto.

MaxString - funcin de grfico({[SetExpression] [TOTAL [<fld{, fld}>]]}


expr)

MinString
MinString() halla valores de cadena en la expresin o campo y devuelve el primer valor de texto en el orden
del texto.

MinString - funcin de grfico({[SetExpression] [TOTAL [<fld {, fld}>]]}


expr)

concat
Esta funcin de script devuelve una concatenacin agregada de cadenas, con todos los valores de expresin
que se repiten en un cierto nmero de registros definidos por una clusula group by.

Sintaxis:

concat ([ distinct ] expression [, delimiter [, sort-weight]])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 332


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

distinct Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

delimiter Cada valor puede ir separado por la cadena que se encuentra en el delimitador.

sort-weight El orden de la concatenacin puede definirse en sort-weight. sort_weight devuelve un


valor numrico en el que el valor ms bajo determina el elemento que se ha de clasificar
primero.

Ejemplo:

LOAD Department, concat(Name,';') as NameList from abc.csv group by Department;

Concat - funcin de grfico


Concat()se utiliza para combinar valores de cadenas. Esta funcin devuelve la concatenacin agregada de
cadenas de todos los valores de la expresin que se evalan en cada dimensin.

Sintaxis:

Concat({[SetExpression] [DISTINCT] [TOTAL [<fld{, fld}>]] string[,


delimiter[, sort_weight]])

Tipo de datos devueltos: cadena

Argumentos:

Argumento Descripcin

string La expresin o campo que contienen la cadena que se ha de medir.

delimiter Cada valor puede ir separado por la cadena que se encuentra en el delimitador.

sort-weight El orden de la concatenacin puede definirse en sort-weight.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

DISTINCT Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 333


5 Funciones en scripts y en expresiones de grfico

SalesGroup Amount Concat(Team) Concat(TOTAL <SalesGroup> Team)

East 25000 Alpha AlphaBetaDeltaGammaGamma

East 20000 BetaGammaGamma AlphaBetaDeltaGammaGamma

East 14000 Delta AlphaBetaDeltaGammaGamma

West 17000 Epsilon EpsilonEtaThetaZeta

West 14000 Eta EpsilonEtaThetaZeta

West 23000 Theta EpsilonEtaThetaZeta

West 19000 Zeta EpsilonEtaThetaZeta

Ejemplo Resultado
Concat(Team) La tabla se crea a partir de las dimensiones SalesGroup y Amount, as como de
las variaciones de la medida Concat(Team). Al ignorar el resultado Totales, tenga
en cuenta que aunque haya datos para ocho valores de Team repartidos en dos
valores de SalesGroup, el nico resultado de la medida Concat(Team) que
concatena ms de un valor de cadena Team en la tabla es la fila que contiene la
dimensin Amount 20000, que da el resultado BetaGammaGamma. Esto se debe
a que hay tres valores para Amount 20000 en los datos de entrada. Todos los
dems resultados permanecen sin concatenar cuando la medida se distribuye por
las dimensiones, porque solo hay un valor de Team para cada combinacin de
SalesGroup y Amount.
Concat Beta, Gamma, porque el calificador DISTINCT significa que el resultado Gamma
([DISTINCT,Team,',)
duplicado se ignora. Adems, el argumento delimitador se define como una coma
seguida por un espacio.
Concat (TOTAL Todos los valores de cadena para todos los valores de Team se concatenan si se
<SalesGroup> Team)
utiliza el calificador TOTAL. Si se especifica la seleccin de campo
<SalesGroup>, se dividen los resultados en los dos valores de la dimensin
SalesGroup. Para SalesGroup East, los resultados son
AlphaBetaDeltaGammaGamma. Para SalesGroup West, los resultados son
EpsilonEtaThetaZeta.
Concat (TOTAL Al aadir el argumento para sort-weight: Amount, los resultados se ordenan por
<SalesGroup>
el valor de la dimensin Amount. Los resultados pasan a ser
Team,';', Amount)
DeltaBetaGammaGammaAlpha y EtaEpsilonZEtaTheta.

Datos utilizados en el ejemplo:

TeamData:
LOAD * inline [
SalesGroup|Team|Date|Amount
East|Gamma|01/05/2013|20000
East|Gamma|02/05/2013|20000
West|Zeta|01/06/2013|19000

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 334


5 Funciones en scripts y en expresiones de grfico

East|Alpha|01/07/2013|25000
East|Delta|01/08/2013|14000
West|Epsilon|01/09/2013|17000
West|Eta|01/10/2013|14000
East|Beta|01/11/2013|20000
West|Theta|01/12/2013|23000
] (delimiter is '|');

FirstValue
Esta funcin de script devuelve el primer valor por orden de carga de la expresin a lo largo de un nmero de
registros definidos por una clusula group by.

Esta funcin solo est disponible como funcin de script.

Sintaxis:

FirstValue ( expression)

Limitaciones:

Si no se encuentra ningn valor de texto, devuelve NULL.

Ejemplo:

LOAD City, FirstValue(Name), as FirstName from abc.csv group by City;

LastValue
Esta funcin de script devuelve el ltimo valor por orden de carga de la expresin a lo largo de un nmero de
registros definidos por una clusula group by.

Esta funcin solo est disponible como funcin de script.

Sintaxis:

LastValue ( expression)

Limitaciones:

Si no se encuentra ningn valor de texto, devuelve NULL.

Ejemplo:

LOAD City, LastValue(Name), as FirstName from abc.csv group by City;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 335


5 Funciones en scripts y en expresiones de grfico

MaxString
Esta funcin de script devuelve el ltimo valor de texto de la expresin hallado en un nmero de registros
definidos por una clusula group by.

Sintaxis:

MaxString ( expression )

Limitaciones:

Si no se encuentra ningn valor de texto, devuelve NULL.

Ejemplo:

LOAD Month, MaxString(Month) as LastSalesMonth from abc.csv group by Year;

MaxString - funcin de grfico


MaxString() halla valores de cadena en la expresin o campo y devuelve el ltimo valor de texto en el orden
del texto.

Sintaxis:

MaxString({[SetExpression] [TOTAL [<fld{, fld}>]]} expr)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

Si la expresin no contiene valores con una representacin de cadena. entonces devuelve NULL.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 336


5 Funciones en scripts y en expresiones de grfico

SalesGroup Amount MaxString(Team) MaxString(Date)

East 14000 Delta 2013/08/01

East 20000 Gamma 2013/11/01

East 25000 Alpha 2013/07/01

West 14000 Eta 2013/10/01

West 17000 Epsilon 2013/09/01

West 19000 Zeta 2013/06/01

West 23000 Theta 2013/12/01

Esta tabla representa todos los valores de la dimensin Customer con los valores Product
correspondientes. En una visualizacin de tabla real en una hoja, encontrar una fila para cada
valor de Customer y Product.

Ejemplo Resultado
MaxString Hay tres valores de 20000 para la dimensin Amount: dos de Gamma (en fechas distintas) y
(Team)
uno de Beta. Por tanto, el resultado de la medida MaxString (Team) es Gamma, porque este
es el valor ms alto en las cadenas ordenadas.
MaxString 2013/11/01 es el mayor valor Date de los tres asociados con la dimensin Amount. En este
(Date))
caso se supone que el script tiene la sentencia SET SET DateFormat='YYYY-MM-DD';'

Datos utilizados en el ejemplo:

TeamData:
LOAD * inline [
SalesGroup|Team|Date|Amount
East|Gamma|01/05/2013|20000
East|Gamma|02/05/2013|20000
West|Zeta|01/06/2013|19000
East|Alpha|01/07/2013|25000
East|Delta|01/08/2013|14000
West|Epsilon|01/09/2013|17000
West|Eta|01/10/2013|14000
East|Beta|01/11/2013|20000
West|Theta|01/12/2013|23000
] (delimiter is '|');

MinString
Esta funcin de script devuelve el primer valor de texto de la expresin hallado en un nmero de registros
definidos por una clusula group by.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 337


5 Funciones en scripts y en expresiones de grfico

MinString ( expression )

Limitaciones:

Si no se encuentra ningn valor de texto, devuelve NULL.

Ejemplo:

LOAD Month, MinString(Month) as FirstSalesMonth from abc.csv group by Year;

MinString - funcin de grfico


MinString() halla valores de cadena en la expresin o campo y devuelve el primer valor de texto en el orden
del texto.

Sintaxis:

MinString({[SetExpression] [TOTAL [<fld {, fld}>]]} expr)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

SetExpression Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles
definidos por la seleccin. Se podra definir un conjunto alternativo de registros
mediante una expresin de anlisis de conjuntos.

TOTAL Si la palabra TOTAL aparece antes de los argumentos de la funcin, el clculo se


realiza con todos los valores posibles segn las selecciones actuales, y no solo con los
que pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Ejemplos y resultados:

SalesGroup Amount MinString(Team) MinString(Date)

East 14000 Delta 2013/08/01

East 20000 Beta 2013/05/01

East 25000 Alpha 2013/07/01

West 14000 Eta 2013/10/01

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 338


5 Funciones en scripts y en expresiones de grfico

SalesGroup Amount MinString(Team) MinString(Date)

West 17000 Epsilon 2013/09/01

West 19000 Zeta 2013/06/01

West 23000 Theta 2013/12/01

Ejemplos Resultados
MinString Hay tres valores de 20000 para la dimensin Amount: dos de Gamma (en fechas distintas) y
(Team)
uno de Beta. Por tanto, el resultado de la medida MinString (Team) es Beta, porque este es
el primer valor en las cadenas ordenadas.
MinString 2013/11/01 es el valor Date ms temprano de los tres asociados con la dimensin Amount.
(Date)
En este caso se supone que el script tiene la sentencia SET SET DateFormat='YYYY-
MM-DD';'

Datos utilizados en el ejemplo:

TeamData:
LOAD * inline [
SalesGroup|Team|Date|Amount
East|Gamma|01/05/2013|20000
East|Gamma|02/05/2013|20000
West|Zeta|01/06/2013|19000
East|Alpha|01/07/2013|25000
East|Delta|01/08/2013|14000
West|Epsilon|01/09/2013|17000
West|Eta|01/10/2013|14000
East|Beta|01/11/2013|20000
West|Theta|01/12/2013|23000
] (delimiter is '|');

Funciones para dimensiones sintticas


Una dimensin sinttica se crea en la app a partir de los valores generados desde las funciones para
dimensiones sintticas y no directamente desde campos en el modelo de datos. Cuando se utilizan valores
generados por una funcin de dimensiones sintticas en un grfico como dimensin calculada, se crea una
dimensin sinttica. Las dimensiones sintticas permiten crear, por ejemplo, grficos con dimensiones a
partir de valores derivados de los datos, es decir, dimensiones dinmicas.

Las dimensiones sintticas no se ven afectadas por las selecciones.

Se pueden utilizar las siguientes funciones de dimensiones sintticas en grficos.

ValueList
ValueList() devuelve un conjunto de valores mostrados que, cuando se utilicen en una dimensin calculada,
formarn una dimensin sinttica.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 339


5 Funciones en scripts y en expresiones de grfico

ValueList - funcin de grfico (v1 {, Expression})

ValueLoop
ValueLoop() devuelve un conjunto de valores que se repiten y que cuando se utilizan en una dimensin
calculada forman una dimensin sinttica.
ValueLoop - funcin de grfico(from [, to [, step ]])

ValueList - funcin de grfico


ValueList() devuelve un conjunto de valores mostrados que, cuando se utilicen en una dimensin calculada,
formarn una dimensin sinttica.

En los grficos con una dimensin sinttica creada con la funcin ValueList es posible
referenciar el valor de la dimensin correspondiente a una celda especfica de la expresin
restableciendo la funcin ValueList con los mismos parmetros que en la expresin del
grfico. La funcin, por supuesto, puede utilizarse en cualquier parte del diseo, pero aparte de
su uso en las dimensiones sintticas, slo tendr sentido dentro de una funcin de agregacin.

Las dimensiones sintticas no se ven afectadas por las selecciones.

Sintaxis:

ValueList(v1 {,...})

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

v1 Valor esttico (suele ser una cadena, pero puede ser un nmero).

{,...} Lista opcional de valores estticos.

Ejemplos y resultados:

Ejemplo Resultado
ValueList('Number Cuando se utiliza para crear una dimensin en una tabla, por ejemplo, esto da
of Orders',
como resultado los tres valores de cadena como etiquetas de fila en la tabla. A
'Average Order
continuacin se puede hacer referencia a ellos en una expresin.
Size', 'Total
Amount')

=IF( ValueList Esta expresin toma los valores de la dimensin creada y hace referencia a ellos
('Number of
en una sentencia IF anidada como entrada para tres funciones de agregacin:
Orders', 'Average
Order Size',

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 340


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
'Total Amount') =
'Number of
Orders', count
(SaleID),

if( ValueList
('Number of
Orders', 'Average
Order Size',
'Total Amount') =
'Average Order
Size', avg
(Amount), sum
(Amount) ))

Datos empleados en los ejemplos:

SalesPeople:
LOAD * INLINE [
SaleID|SalesPerson|Amount|Year
1|1|12|2013
2|1||23|2013
3|1|17|2013
4|2|9| 2013
5|2|14|2013
6|2|29|2013
7|2|4| 2013
8|1|15|2012
9|1|16|2012
10|2|11| 2012
11|2|17|2012
12|2|7| 2012
] (delimiter is '|');

ValueLoop - funcin de grfico


ValueLoop() devuelve un conjunto de valores que se repiten y que cuando se utilizan en una dimensin
calculada forman una dimensin sinttica.
Los valores generados comenzarn con el valor from y terminarn con el valor to incluyendo los valores
intermedios en incrementos de paso.

En los grficos con una dimensin sinttica creada con la funcin ValueLoop es posible
referenciar el valor de la dimensin correspondiente a una celda especfica de la expresin
restableciendo la funcin ValueLoop con los mismos parmetros que en la expresin del
grfico. La funcin, por supuesto, puede utilizarse en cualquier parte del diseo, pero aparte de
su uso en las dimensiones sintticas, slo tendr sentido dentro de una funcin de agregacin.

Las dimensiones sintticas no se ven afectadas por las selecciones.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 341


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

ValueLoop(from [, to [, step ]])

Tipo de datos devueltos: dual

Argumentos:

Argumentos Descripcin

from Valor inicial del conjunto de valores que se han de generar.

to Valor final del conjunto de valores que se han de generar.

step Tamao del incremento entre valores.

Ejemplos y resultados:

Ejemplo Resultado
ValueLoop De este modo se crea una dimensin en una tabla, por ejemplo, que se puede utilizar para
(1, 10)
fines tales como la creacin de etiquetas numeradas. Este ejemplo se traduce en valores
numerados del 1 al 10. A continuacin se puede hacer referencia a estos valores en una
expresin.
ValueLoop Este ejemplo da como resultado valores numerados 2, 4, 6, 8 y 10 porque el argumento step
(2, 10,2)
tiene un valor de 2.

Agregaciones anidadas
Puede que nos encontremos con situaciones en las que necesitemos aplicar una agregacin al resultado de
otra agregacin. Esto se conoce con el nombre de agregaciones anidadas.

Por regla general, no se permite anidar agregaciones en una expresin de grfico en Qlik Sense. La
anidacin slo se permite bajo estas condiciones:

l Si utilizamos el cualificador TOTAL en la funcin de agregacin interna.

No se permiten ms de 100 niveles de anidacin.

Agregaciones anidadas con el cualificador TOTAL

Ejemplo:

Digamos, por ejemplo, que se desea calcular la suma del campo Sales, pero incluyendo nicamente las
transacciones con una OrderDate igual a la del ao anterior. El ao anterior se puede obtener mediante la
funcin de agregacin Max(TOTAL Year(OrderDate)).

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 342


5 Funciones en scripts y en expresiones de grfico

La agregacin siguiente arrojara el resultado deseado:

Sum(If(Year(OrderDate)=Max(TOTAL Year(OrderDate)), Sales))


La inclusin del cualificador TOTAL es absolutamente necesaria para que se acepte este tipo de agregacin
en Qlik Sense y tambin es necesaria para realizar la comparacin deseada. Este tipo de necesidad de
anidamiento es bastante comn y debera emplearse siempre que sea posible.

Vea tambin:

p Aggr - funcin de grfico (pgina 143)

5.2 Funciones de color


Estas funciones se pueden utilizar en expresiones asociadas con la configuracin y evaluacin de las
propiedades de color de los objetos grficos, as como tambin en los scripts de carga de datos.

QlikView admite diversas funciones de color que estn disponibles en Qlik Sense por razones
de compatibilidad, pero el uso de las mismas no se recomienda: blue, color, colormaphue,
colormapjet, colormix1, colormix2, cyan, darkgray, green, lightblue, lightcyan,
lightgray, lightmagenta, lightred, magenta, qliktechblue, qliktechgray, red, syscolor,
white, yellow.

ARGB
ARGB() se utiliza en expresiones para fijar o evaluar las propiedades de color de un objeto grfico, en el que
el color viene definido por un componente rojo r, un componente verde g y un componente azul b con un
factor alfa (de opacidad) alpha.

ARGB(alpha, r, g, b)

HSL
HSL() se utiliza en expresiones para fijar o evaluar las propiedades de color de un objeto grfico, en el que el
color viene definido con los valores de hue, saturation y luminosity entre 0 y 255.

HSL (hue, saturation, luminosity)

RGB
RGB() se utiliza en las expresiones para fijar o evaluar las propiedades de color de un objeto grfico, en el
que el color viene definido por un componente rojo r, un componente verde g y un componente azul b..

RGB (r, g, b)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 343


5 Funciones en scripts y en expresiones de grfico

ARGB
ARGB() se utiliza en expresiones para fijar o evaluar las propiedades de color de un objeto grfico, en el que
el color viene definido por un componente rojo r, un componente verde g y un componente azul b con un
factor alfa (de opacidad) alpha.

Sintaxis:

ARGB(alpha, r, g, b)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

alpha Valor de transparencia en el rango de 0 - 255. 0 se corresponde con una transparencia


total y 255 corresponde a una opacidad total.

r, g, b Los valores de rojo, verde y azul. Un valor de 0 corresponde a ninguna aportacin y un


valor de 255 corresponde a una aportacin total.

Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 255.

Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los


valores de los componentes de color sern ms fciles de ver.Por ejemplo, el verde claro tiene el nmero 4
278 255 360, que en notacin hexadecimal es FF00FF00.Las dos primeras posiciones FF (255) denotan el
factor alpha.Las dos siguientes posiciones 00 denotan la cantidad de rojo, las dos posiciones siguientes
FF denotan la cantidad de verde y las dos ltimas posiciones 00 denotan la cantidad de azul.

RGB
RGB() se utiliza en las expresiones para fijar o evaluar las propiedades de color de un objeto grfico, en el
que el color viene definido por un componente rojo r, un componente verde g y un componente azul b..

Sintaxis:

RGB (r, g, b)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

r, g, b Los valores de rojo, verde y azul. Un valor de 0 corresponde a ninguna aportacin y un


valor de 255 corresponde a una aportacin total.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 344


5 Funciones en scripts y en expresiones de grfico

Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 255.

Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los


valores de los componentes de color sern ms fciles de ver.Por ejemplo, el verde claro tiene el nmero 4
278 255 360, que en notacin hexadecimal es FF00FF00.Las dos primeras posiciones FF (255) denotan el
factor alpha.En las funciones RGB y HSL, ste es siempre FF (opaco).Las dos siguientes posiciones 00
denotan la cantidad de rojo, las dos posiciones siguientes FF denotan la cantidad de verde y las dos
ltimas posiciones 00 denotan la cantidad de azul.

HSL
HSL() se utiliza en expresiones para fijar o evaluar las propiedades de color de un objeto grfico, en el que el
color viene definido con los valores de hue, saturation y luminosity entre 0 y 255.

Sintaxis:

HSL (hue, saturation, luminosity)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

hue, Los valores de los componentes de hue, saturation y luminosity. Un valor de 0 corresponde
saturation, a ninguna contribucin y una valor de 255 corresponde a una contribucin completa.
luminosity

Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 255.

Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los


valores de los componentes de color sern ms fciles de ver. Por ejemplo, el verde claro tiene el nmero 4
286 080 100, que en notacin hexadecimal es FF786464. Las dos primeras posiciones FF (255) denotan el
factor alpha.En las funciones RGB y HSL, ste es siempre FF (opaco). Las siguientes dos posiciones 78
denotan el componente de hue, las siguientes dos posiciones 64 denotan la saturation y las ltimas dos
posiciones 64 denotan el componente luminosity.

5.3 Funciones condicionales


Las funciones condicionales evalan todas una condicin y a continuacin devuelven distintas respuestas
dependiendo del valor de la condicin. Las funciones pueden utilizarse en el script de carga de datos y en las
expresiones de grficos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 345


5 Funciones en scripts y en expresiones de grfico

Descripcin general de las funciones condicionales


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

alt
La funcin alt devuelve el primer parmetro que tiene una representacin numrica vlida. Si no se
encuentra tal condicin, devolver el ltimo parmetro. Se puede utilizar cualquier nmero de parmetros.

alt (case1[ , case2 , case3 , ...] , else)

class
La funcin class asigna el primer parmetro a un intervalo de clase. El resultado es un valor dual con
a<=x<b como el valor textual, donde a y b son los lmites superior e inferior del contenedor y el lmite inferior
es un valor numrico.

class (expression, interval [ , label [ , offset ]])

if
La funcin if devuelve un valor dependiendo de si la condicin suministrada con la funcin devuelve True o
False.

if (condition , then , else)

match
La funcin match compara el primer parmetro con todos los siguientes y devuelve el nmero de expresin
que corresponda. La comparacin es sensible a maysculas.

match ( str, expr1 [ , expr2,...exprN ])

mixmatch
La funcin mixmatch compara el primer parmetro con todos los siguientes y devuelve el nmero de
expresin que corresponda. La comparacin no es sensible a maysculas.

mixmatch ( str, expr1 [ , expr2,...exprN ])

pick
La funcin devuelve la n-nsima expresin de la lista.

pick (n, expr1[ , expr2,...exprN])

wildmatch
La funcin wildmatch compara el primer parmetro con todos los siguientes y devuelve el nmero de
expresin que corresponda. Permite el uso de caracteres comodn ( * y ?) en las cadenas de comparacin.
La comparacin no es sensible a maysculas.

wildmatch ( str, expr1 [ , expr2,...exprN ])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 346


5 Funciones en scripts y en expresiones de grfico

alt
La funcin alt devuelve el primer parmetro que tiene una representacin numrica vlida. Si no se
encuentra tal condicin, devolver el ltimo parmetro. Se puede utilizar cualquier nmero de parmetros.

Sintaxis:

alt(case1[ , case2 , case3 , ...] , else)

La funcin alt se emplea a menudo junto con funciones de interpretacin de nmeros o fechas. De esta
manera, Qlik Sense puede probar distintos formatos de fecha en un orden priorizado.

Ejemplos y resultados:

Ejemplo Resultado
alt( date#( dat , 'YYYY/MM/DD' ), Esta expresin comprobar si el campo date contiene una fecha
date#( dat , 'MM/DD/YYYY' ),
conforme a cualquiera de los tres formatos de fecha
date#( dat , 'MM/DD/YY' ),
'No valid date' ) especificados. Si es as, devolver un valor dual con la cadena
original y una representacin numrica vlida de una fecha. Si
no se encuentra tal condicin, devuelve el texto 'No hay fecha
vlida' (sin ninguna representacin numrica vlida).

class
La funcin class asigna el primer parmetro a un intervalo de clase. El resultado es un valor dual con
a<=x<b como el valor textual, donde a y b son los lmites superior e inferior del contenedor y el lmite inferior
es un valor numrico.

Sintaxis:

class(expression, interval [ , label [ , offset ]])

Argumentos:

Argumento Descripcin

interval Un nmero que especifica el ancho del contenedor.

label Una cadena arbitraria que puede reemplazar a la "x" en el texto del resultado.

offset Un nmero que puede utilizarse como desplazamiento desde el punto de partida por
defecto de la clasificacin.El punto de partida por defecto normalmente es 0..

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 347


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

class( var,10 ) with var = 23 devuelve '20<=x<30'

class( var,5,'value' ) with var = 23 devuelve '20<= value <25'

class( var,10,'x',5 ) with var = 23 devuelve '15<=x<25'

if
La funcin if devuelve un valor dependiendo de si la condicin suministrada con la funcin devuelve True o
False.

Sintaxis:

if(condition , then , else)

La funcin if tiene tres parmetros, condition, then y else, los cuales son todos expresiones. Las otras dos,
then y else, pueden ser de cualquier tipo.

Argumentos:

Argumento Descripcin

condition La expresin que se interpreta de una manera lgica.

then La expresin que puede ser de cualquier tipo. Si la condition es True, la funcin if devuelve
el valor de la expresin then.

else La expresin que puede ser de cualquier tipo. Si la condition es False, la funcin if
devuelve el valor de la expresin else.

Ejemplo:

if( Amount>= 0, 'OK', 'Alarm' )

match
La funcin match compara el primer parmetro con todos los siguientes y devuelve el nmero de expresin
que corresponda. La comparacin es sensible a maysculas.

Sintaxis:

match( str, expr1 [ , expr2,...exprN ])

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 348


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
match( M, 'Jan','Feb','Mar') devuelve 2 si M = Feb

devuelve 0 si M = Apro jan

mixmatch
La funcin mixmatch compara el primer parmetro con todos los siguientes y devuelve el nmero de
expresin que corresponda. La comparacin no es sensible a maysculas.

Sintaxis:

mixmatch( str, expr1 [ , expr2,...exprN ])

Ejemplos y resultados:

Ejemplo Resultado
mixmatch( M, 'Jan','Feb','Mar') devuelve 1 si M = jan

pick
La funcin devuelve la n-nsima expresin de la lista.

Sintaxis:

pick(n, expr1[ , expr2,...exprN])

Argumentos:

Argumento Descripcin

n n is an integer between 1 and N.

Ejemplos y resultados:

Ejemplo Resultado
pick( N'A''B'4, , , ) devuelve 'B' si N = 2
devuelve 4 si N = 3

wildmatch
La funcin wildmatch compara el primer parmetro con todos los siguientes y devuelve el nmero de
expresin que corresponda. Permite el uso de caracteres comodn ( * y ?) en las cadenas de comparacin.
La comparacin no es sensible a maysculas.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 349


5 Funciones en scripts y en expresiones de grfico

wildmatch( str, expr1 [ , expr2,...exprN ])

Ejemplos y resultados:

Ejemplo Resultado
wildmatch( M, 'ja*','fe?','mar') devuelve 1 si M = January

devuelve 2 si M = fex

5.4 Funciones de contador


En esta seccin se describen las funciones relacionadas con los contadores de registros durante la
evaluacin de sentencias LOAD en el script de carga de datos. La nica funcin que puede utilizarse en las
expresiones de grficos es RowNo().

Algunas funciones de contador no tienen ningn parmetro, pero los parntesis finales siempre son
necesarios no obstante.

Descripcin general de las funciones de contador


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

autonumber
Esta funcin de script devuelve un entero nico por cada valor distinto evaluado de expression que
encuentra durante la ejecucin de script. Esta funcin se puede utilizar por ej. para crear un representacin
compacta de memoria de una clave compleja.

autonumber (expression[ , AutoID])

autonumberhash128
Esta funcin de script calcula un hash de 128 bits de los valores de entrada combinados de la expresin y
devuelve un nico entero por cada valor hash distinto encontrado durante la ejecucin de script. Esta funcin
se puede utilizar por ejemplo para crear un representacin compacta de memoria de una clave compleja.
autonumberhash128 (expression {, expression})

autonumberhash256
Esta funcin de script calcula un hash de 256 bits de los valores de entrada combinados de la expresin y
devuelve un nico entero por cada valor de resumen diferente encontrado durante la ejecucin de script.
Esta funcin se puede utilizar por ej. para crear un representacin compacta de memoria de una clave
compleja.

Esta funcin solo est disponible como funcin de script.

autonumberhash256 (expression {, expression})

fieldvaluecount

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 350


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve el nmero de valores distintos en un campo. fieldname debe suministrarse
como una cadena (por ejemplo, un texto literal entrecomillado).
fieldvaluecount (fieldname)

IterNo
Esta funcin de script devuelve un entero que indica para qu vez es evaluado un registro nico en una
sentencia LOAD con una clusula while. La primera repeticin tiene el nmero 1. La funcin IterNo slo
tiene sentido si se emplea junto con una clusula while.

IterNo ( )

RecNo
Esta funcin de script devuelve un entero con el nmero de la fila actual de un tabla interna. El primer
registro es el nmero 1.

RecNo ( )

RowNo
Esta funcin devuelve un entero para indicar la posicin de la fila actual en la tabla interna de Qlik Sense
resultante. La primera fila es la nmero 1.

RowNo ( )

autonumber
Esta funcin de script devuelve un entero nico por cada valor distinto evaluado de expression que
encuentra durante la ejecucin de script. Esta funcin se puede utilizar por ej. para crear un representacin
compacta de memoria de una clave compleja.

Sintaxis:

autonumber(expression[ , AutoID])

Argumentos:

Argumento Descripcin

AutoID Si la funcin autonumber se usa para diferentes claves dentro del script, para crear
mltiples instancias de contador, se puede usar el parmetro opcional AutoID para
nombrar cada contador.

Ejemplo1:

autonumber( Region&Year&Month )

Ejemplo2:

autonumber( Region&Year&Month, 'Ctr1' )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 351


5 Funciones en scripts y en expresiones de grfico

autonumberhash128
Esta funcin de script calcula un hash de 128 bits de los valores de entrada combinados de la expresin y
devuelve un nico entero por cada valor hash distinto encontrado durante la ejecucin de script. Esta funcin
se puede utilizar por ejemplo para crear un representacin compacta de memoria de una clave compleja.

Sintaxis:

autonumberhash128(expression {, expression})

Ejemplo:

autonumberhash128 ( Region, Year, Month )

autonumberhash256
Esta funcin de script calcula un hash de 256 bits de los valores de entrada combinados de la expresin y
devuelve un nico entero por cada valor de resumen diferente encontrado durante la ejecucin de script.
Esta funcin se puede utilizar por ej. para crear un representacin compacta de memoria de una clave
compleja.

Esta funcin solo est disponible como funcin de script.

Sintaxis:

autonumberhash256(expression {, expression})

Ejemplo:

Autonumberhash256 ( Region, Year, Month )

fieldvaluecount
Esta funcin de script devuelve el nmero de valores distintos en un campo. fieldname debe suministrarse
como una cadena (por ejemplo, un texto literal entrecomillado).

Sintaxis:

fieldvaluecount(fieldname)

Ejemplo:

let x = fieldvaluecount('Alfa');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 352


5 Funciones en scripts y en expresiones de grfico

IterNo
Esta funcin de script devuelve un entero que indica para qu vez es evaluado un registro nico en una
sentencia LOAD con una clusula while. La primera repeticin tiene el nmero 1. La funcin IterNo slo
tiene sentido si se emplea junto con una clusula while.

Sintaxis:

IterNo( )

Ejemplos y resultados:

Ejemplo Resultado
LOAD Esta sentencia LOAD genera un registropor fecha
StartDate,
dentro del rango definido por StartDate y EndDate.
EndDate,
IterNo() as DayWithinRange,
Date( StartDate + IterNo() 1 ) as Date
While StartDate + IterNo() 1 <= EndDate

RecNo
Esta funcin de script devuelve un entero con el nmero de la fila actual de un tabla interna. El primer
registro es el nmero 1.

Sintaxis:

RecNo( )

RowNo
Esta funcin devuelve un entero para indicar la posicin de la fila actual en la tabla interna de Qlik Sense
resultante. La primera fila es la nmero 1.

Sintaxis:

RowNo( [TOTAL])

A diferencia de RecNo( ), la cual cuenta los registros en la tabla de datos pura, la funcin RowNo( ) no
cuenta los registros excluidos por las clusulas where y no se reinicia cuando una tabla pura de datos se
concatena con otra.

Si se utiliza una load precedente, es decir, un nmero de sentencias LOAD apiladas que se
leen desde la misma tabla, puede usar solamente RowNo() en la sentencia LOAD superior.
Si se utiliza RowNo() en sentencias LOAD subsiguientes, se devuelve 0.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 353


5 Funciones en scripts y en expresiones de grfico

Ejemplo: Script de carga de datos

Tablas de datos puras:

Tab1.csv

A B
1 aa
2 cc
3 ee

Tab2.csv

A B
5 xx

4 yy
6 zz

QVTab:
LOAD *, RecNo( ), RowNo( ) from Tab1.csv where A<>2;
LOAD *, RecNo( ), RowNo( ) from Tab2.csv where A<>5;

La tabla Qlik Sense interna resultante:

QVTab

A B RecNo( ) RowNo( )

1 aa 1 1
3 ee 3 2
4 yy 2 3
6 zz 3 4

RowNo - funcin de grfico


RowNo() devuelve el nmero de la fila actual en el segmento de columna actual en una tabla. Para los
grficos en modo mapa de bits, RowNo()devuelve el nmero de la fila actual en el equivalente de la tabla
simple.

Si la tabla o el equivalente de tabla tiene mltiples dimensiones verticales, el segmento de columna actual
incluir slo filas con los mismos valores que la fila actual en todas las columnas de dimensin excepto para
la columna que muestra la ltima dimensin en el orden de campo interno.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 354


5 Funciones en scripts y en expresiones de grfico

RowNo([TOTAL])

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

TOTAL Si la tabla es uni-dimensional o si se usa el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

Limitaciones:

A diferencia de RecNo(), que cuenta los registros en la tabla de datos pura, la funcin RowNo() no cuenta
los registros excluidos por las clusulas where y no se reinicia cuando una tabla pura de datos se concatena
con otra. La primera fila es la nmero 1.

Ejemplos y resultados:

Ejemplos Resultados
if( RowNo( )=1, 0, sum( Sales ) / Above( sum( Sales ))) La primera fila es la nmero 1..

Ejemplo: Cuando los registros se excluyen, se concatenan las tablas y se cuentan las filas.

Tab1.csv:
A B
1 aa
2 cc
3 ee

Tab2.csv:
A B
5 xx
4 yy
6 zz

QVTab:
LOAD *, RecNo( ), RowNo( ) from Tab1.csv where A<>2;
LOAD *, RecNo( ), RowNo( ) from Tab2.csv where A<>5;

La tabla Qlik Sense interna resultante:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 355


5 Funciones en scripts y en expresiones de grfico

A B RecNo() RowNo()

1 aa 1 1

3 ee 3 2

4 yy 2 3

6 zz 3 4

Vea tambin:

p Above - funcin de grfico (pgina 467)

5.5 Funciones de fecha y hora


Las funciones de fecha y hora de Qlik Sense se usan para transformar y convertir valores de fecha y hora.
Todas las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de
grficos.

Las funciones de fecha y hora estn basadas en un nmero de serie de fecha-hora que es igual al nmero de
das transcurridos desde el 30 de diciembre de 1899. El valor entero representa el da, y el valor fraccional
representa la hora del da.

Qlik Sense utiliza el valor numrico del parmetro, por tanto, un nmero tambin es vlido como parmetro
cuando no tiene formato de fecha u hora. Si el parmetro carece de un valor numrico, p. ej. si fuera una
cadena, entonces Qlik Sense trata de interpretar la cadena conforme a las variables de fecha y hora del
sistema operativo.

Si el formato de hora utilizado en el parmetro no se corresponde con el establecido en el sistema operativo,


Qlik Sense no podr realizar una interpretacin correcta. Para resolver este problema, modifique la
configuracin o utilice una funcin de interpretacin.

En los ejemplos a continuacin, los formatos de fecha y hora predeterminados son hh:mm:ssy AAAA-MM-
DD (estndar ISO 8601).

Descripcin general de las funciones de fecha y hora


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Expresiones de tiempo con enteros


second
Esta funcin devuelve un entero que representa el segundo en que la fraccin de la expression se interpreta
como una hora conforme a la interpretacin numrica estndar.

second (expression)

minute

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 356


5 Funciones en scripts y en expresiones de grfico

Esta funcin devuelve un entero que representa el minuto en el que la fraccin de la expression se
interpreta como una hora conforme a la interpretacin numrica estndar.

minute (expression)

hour
Esta funcin devuelve un entero que representa la hora en que la fraccin de la expression se interpreta
como una hora de acuerdo con la interpretacin numrica estndar.

hour (expression)

day
Esta funcin devuelve un entero que representa el da en que la fraccin de la expression se interpreta
como una fecha conforme a la interpretacin numrica estndar.

day (expression)

week
Esta funcin devuelve un entero que representa el nmero de semana conforme a la ISO 8601. El nmero
de semana se calcula a partir de la interpretacin de la fecha de la expresin, conforme a la interpretacin
numrica estndar.

week (expression)

month
Esta funcin devuelve un valor dual con un nombre de mes tal y como venga definido en la variable de
entorno MonthNames y un entero entre 1-12. El mes se calcula a partir de la interpretacin de la fecha de la
expresin, conforme a la interpretacin numrica estndar.

month (expression)

year
Esta funcin devuelve un entero que representa el ao en que la expression se interpreta como una fecha
conforme a la interpretacin numrica estndar.

year (expression)

weekyear
Esta funcin devuelve el ao al que pertenece el nmero de semana conforme a la ISO 8601. El nmero de
semana vara entre 1 y 52 aproximadamente.

weekyear (expression)

weekday
Esta funcin devuelve un valor dual con lo siguiente: El nombre del da del modo definido en la variable de
entorno DayNames. Un nmero entero entre 0 y 6 correspondiente al da nominal de la semana (0-6).

weekday (date)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 357


5 Funciones en scripts y en expresiones de grfico

Funciones de indicacin de tiempo


now
Esta funcin devuelve una fecha-hora con la hora actual segn el reloj del sistema.

now ([ timer_mode])

today
Esta funcin devuelve la fecha actual segn el reloj del sistema.

today ([timer_mode])

LocalTime
Esta funcin devuelve una fecha y hora con la hora actual segn el reloj del sistema y una determinada zona
horaria.

localtime ([timezone [, ignoreDST ]])

Funciones make
makedate
Esta funcin devuelve una fecha calculada desde el ao YYYY, el mes MM y el dia DD.

makedate (YYYY [ , MM [ , DD ] ])

makeweekdate
Esta funcin devuelve una fecha calculada a partir del ao YYYY, la semana WW y el da de la semana D.

makeweekdate (YYYY [ , WW [ , D ] ])

maketime
Esta funcin devuelve una hora calculada a partir de la hora hh, el minuto mm, el segundo ss, con una
fraccin fff hasta el milisegundo.

maketime (hh [ , mm [ , ss [ .fff ] ] ])

Otras funciones de tiempo


AddMonths
Esta funcin devuelve la fecha que tiene lugar n meses despus de startdate o, si n es negativa, la fecha
que tiene lugar n meses antes de startdate.

addmonths (startdate, n , [ , mode])

AddYears
Esta funcin devuelve la fecha que tiene lugar n meses despus de startdate o, si n es negativa, la fecha
que tiene lugar n meses antes de startdate.

addmonths (startdate, n)

yeartodate

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 358


5 Funciones en scripts y en expresiones de grfico

Esta funcin devuelve True si unadate se encuentra dentro del ao de la fecha, si no, False.

yeartodate (date [ , yearoffset [ , firstmonth [ , todaydate] ] ])

Funciones de zona horaria


timezone
Esta funcin devuelve el nombre de la zona horaria actual tal y como se define en Windows.

timezone ( )

GMT
Esta funcin devuelve la actual hora Greenwich Mean Time, tal y como lo extrae del reloj del sistema y las
configuraciones horarias de Windows.

GMT ( )

UTC
Devuelve la actual Coordinated Universal Time.

UTC( )

daylightsaving
Devuelve el ajuste actual de cambio de hora automtico, segn el horario de verano, tal y como se define en
Windows.

daylightsaving ( )

converttolocaltime
Convierte una fecha-hora en UTC o GMT a hora local, con la forma de un valor dual. El lugar puede ser
cualquier ciudad, poblacin o zona horaria del mundo.

converttolocaltime (timestamp [, place [, ignore_dst=false]])

Funciones de establecimiento de hora


setdateyear
Esta funcin devuelve una fecha-hora basada en la entrada timestamp, pero reemplazando el ao por year.

setdateyear (timestamp, year)

setdateyearmonth
Devuelve una fecha-hora basada en la timestamp de entrada pero con el ao reemplazado por year y el
mes reemplazado por month.

setdateyearmonth (timestamp, year, month)

inyear
Esta funcin devuelve True si date se encuentra dentro del ao que contiene basedate.

inyear (date, basedate , shift [, first_month_of_year = 1])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 359


5 Funciones en scripts y en expresiones de grfico

Funciones in...
inyeartodate
Esta funcin devuelve True si date se encuentra dentro de la parte del ao que contiene basedate hasta e
incluido el ltimo milisegundo de basedate.

inyeartodate (date, basedate , shift [, first_month_of_year = 1])

inquarter
Esta funcin devuelve True si date se encuentra dentro del trimestre que contiene basedate.

inquarter (date, basedate , shift [, first_month_of_year = 1])

inquartertodate
Esta funcin devuelve True si date se encuentra dentro de la parte del trimestre que contiene basedate
hasta e incluido el ltimo milisegundo de basedate.

inquartertodate (date, basedate , shift [, first_month_of_year = 1])

inmonth
Esta funcin devuelve True si date se encuentra dentro del mes que contiene basedate.

inmonth (date, basedate , shift)

inmonthtodate
Esta funcin de script devuelve True si date se encuentra dentro de la parte del mes que contiene basedate
hasta e incluido el ltimo milisegundo de basedate.

inmonthtodate (date, basedate , shift)

inmonths
Devuelve True si date se encuentra dentro del desplazamiento n del mes (alineado desde el 1 de enero) que
contiene basedate.

inmonths (n, date, basedate , shift [, first_month_of_year = 1])

inmonthstodate
Esta funcin devuelve True si date se encuentra dentro del desplazamiento n del mes (alineado desde el 1
de enero) que contiene basedate.

inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])

inweek
Esta funcin devuelve True si date se encuentra dentro de la semana que contiene basedate.

inweek (date, basedate , shift [, weekstart])

inweektodate
Esta funcin devuelve True si date se encuentra dentro de la parte de la semana que contiene basedate

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 360


5 Funciones en scripts y en expresiones de grfico

hasta e incluido el ltimo milisegundo de basedate.

inweektodate (date, basedate , shift [, weekstart])

inlunarweek
Esta funcin devuelve True si date se encuentra dentro de la semana lunar (periodos de 7 das consecutivos
que comienzan el 1 de enero de cada ao) que contiene a basedate.

inlunarweek (date, basedate , shift [, weekstart])

inlunarweektodate
Esta funcin devuelve True si date se encuentra dentro de la parte de la semana lunar (el periodo de 7 das
consecutivos, empezando desde el 1 de enero de cada ao) que contiene a basedatehasta, e incluido el
ltimo milisegundo de basedate.

inlunarweektodate (date, basedate , shift [, weekstart])

inday
Esta funcin devuelve True si timestamp se encuentra dentro del da que contiene a basetimestamp.

inday (timestamp, basetimestamp , shift [, daystart])

indaytotime
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del da que contiene
basetimestamp hasta e incluido el milisegundo exacto de basetimestamp.

indaytotime (timestamp, basetimestamp , shift [, daystart])

Funciones start ... end


yearstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da del ao que contiene la fecha date. El formato de salida por defecto ser el DateFormat
definido en el script.

yearstart ( date [, shift = 0 [, first_month_of_year = 1]])

yearend
Esta funcin devuelve un valor correspondiente a una fecha-hora con el ltimo milisegundo del ltimo da del
ao que contiene la fecha date. El formato de salida por defecto ser el DateFormat definido en el script.

yearend ( date [, shift = 0 [, first_month_of_year = 1]])

yearname
Esta funcin devuelve un ao de cuatro dgitos con un valor numrico correspondiente a una fecha-hora con
el primer milisegundo del primer da del ao que contiene la fecha date.

yearname (date [, shift = 0 [, first_month_of_year = 1]] )

quarterstart

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 361


5 Funciones en scripts y en expresiones de grfico

Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del trimestre que contiene a date. El formato de salida por defecto ser el DateFormat definido en el script.

quarterstart (date [, shift = 0 [, first_month_of_year = 1]])

quarterend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del trimestre que contiene la date. El formato de salida por defecto ser el DateFormat definido en el script.

quarterend (date [, shift = 0 [, first_month_of_year = 1]])

quartername
Esta funcin devuelve un valor que muestra los meses del trimestre (formateado conforme a la variable de
script MonthNames) y el ao, con un valor numrico subyacente correspondiente a una fecha y hora con el
primer milisegundo del primer da del trimestre.

quartername (date [, shift = 0 [, first_month_of_year = 1]])

monthstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da del mes que contiene la fecha date. El formato de salida por defecto ser el DateFormat
definido en el script.

monthstart (date [, shift = 0])

monthend
Esta funcin devuelve un valor correspondiente a una fecha y hora con el ltimo milisegundo del ltimo da
del mes que contiene la fecha date. El formato de salida por defecto ser el DateFormat definido en el
script.

monthend (date [, shift = 0])

monthname
Esta funcin devuelve un valor que muestra el mes (formateado segn la variable de script MonthNames) y
el ao, con un valor numrico subyacente correspondiente a una fecha y hora con el primer milisegundo del
primer da del mes.

monthname (date [, shift = 0])

monthsstart
Esta funcin devuelve un valor correspondiente a una fecha y hora con el primer milisegundo del periodo
mensual n (comenzando desde el 1 de enero) que contiene la fecha date. El formato de salida por defecto
ser el DateFormat definido en el script.

monthsstart (n, date [, shift = 0 [, first_month_of_year = 1]])

monthsend
Esta funcin devuelve un valor correspondiente a una fecha y hora con el ltimo milisegundo del periodo

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 362


5 Funciones en scripts y en expresiones de grfico

mensual n (comenzando desde el 1 de enero) que contiene la fecha date. El formato de salida por defecto
ser el DateFormat definido en el script.

monthsend (n, date [, shift = 0 [, first_month_of_year = 1]])

monthsname
Esta funcin devuelve un valor que muestra los meses del periodo (formateados segn la variable de script
MonthNames) y el ao con un valor numrico subyacente correspondiente a una fecha y hora con el primer
milisegundo del periodo n de meses (empezando desde el 1 de enero) que contiene la date.

monthsname (n, date [, shift = 0 [, first_month_of_year = 1]])

weekstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da (Lunes) de la semana natural que contiene la fecha date. El formato de salida predeterminado
es el DateFormat definido en el script.

weekstart (date [, shift = 0 [,weekoffset = 0]])

weekend
Esta funcin devuelve un valor correspondiente a una indicacin de tiempo (una fecha y hora) con el ltimo
milisegundo del ltimo da (domingo) de la semana natural que contiene a date. El formato de salida
predefinido ser el DateFormat definido en el script.

weekend (date [, shift = 0 [,weekoffset = 0]])

weekname
Esta funcin devuelve un valor que muestra el ao y el nmero de semana, con un valor numrico
subyacente correspondiente a una indicacin de fecha y hora con el primer milisegundo del primer da de la
semana que contiene a date.

weekname (date [, shift = 0 [,weekoffset = 0]])

lunarweekstart
Esta funcin devuelve un valor correspondiente a una fecha y hora con el primer milisegundo de la semana
lunar (el periodo consecutivo de 7 das que comienza el 1 de enero de cada ao) que contiene la fecha date.
El formato de salida por defecto ser el DateFormat definido en el script.

lunarweekstart (date [, shift = 0 [,weekoffset = 0]])

lunarweekend
Esta funcin devuelve un valor correspondiente a una indicacin de tiempo (fecha y hora) con el ltimo
milisegundo de la semana lunar (periodos consecutivos de 7 das que comienzan el 1 de enero de cada ao)
que contiene a la fecha. El formato de salida por defecto ser el DateFormat definido en el script.

lunarweekend (date [, shift = 0 [,weekoffset = 0]])

lunarweekname
Esta funcin devuelve un valor que muestra el ao y nmero de semana, con un valor numrico subyacente

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 363


5 Funciones en scripts y en expresiones de grfico

correspondiente a una fecha y hora, con el primer milisegundo del primer da de la semana lunar (periodo de
7 das consecutivos comenzando desde el 1 de enero) que contiene la fecha.

lunarweekname (date [, shift = 0 [,weekoffset = 0]])

daystart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del trimestre que contiene la fecha y hora timestamp. El formato de salida por defecto ser el
TimestampFormat definido en el script.

daystart (timestamp [, shift = 0 [, dayoffset = 0]])

dayend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del da. El formato de salida por defecto ser el TimestampFormat definido en el script.

dayend (timestamp [, shift = 0 [, dayoffset = 0]])

dayname
Esta funcin devuelve un valor de fecha, con un valor numrico subyacente correspondiente a una fecha-
hora con el primer milisegundo del da que contiene a timestamp.

dayname (timestamp [, shift = 0 [, dayoffset = 0]])

Funciones de nmero de da
age
Devuelve la edad que tiene, en el momento indicado en timestamp (en aos completos), alguien nacido en
date_of_birth.

age (timestamp, date_of_birth)

networkdays
Devuelve el nmero de das laborables (lunes-viernes) situados entre start_date y end_date (ambos
inclusive) teniendo en cuenta la lista opcional de holiday. Todos los parmetros debern ser fechas o
marcas temporales vlidas.

networkdays (start:date, end_date {, holiday})

firstworkdate
Devuelve la ltima fecha de inicio para obtener un no_of_workdays (de lunes-viernes) sin sobrepasar end_
date teniendo en cuenta la lista opcional de vacaciones. end_date y holiday deben ser fechas y horas
vlidas.

firstworkdate (end_date, no_of_workdays {, holiday} )

lastworkdate
Devuelve la primera fecha de finalizacin para obtener el no_of_workdays (lunes-viernes) si comienza en

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 364


5 Funciones en scripts y en expresiones de grfico

start_date y teniendo en cuenta cualquier holiday opcionalmente indicadas.start_date y holiday deben ser
fechas o fecha-hora vlidas.

lastworkdate (start_date, no_of_workdays {, holiday})

daynumberofyear
Devuelve el nmero de da del ao, conforme a una fecha-hora con el primer milisegundo del primer da del
ao que contiene a date.

daynumberofyear (date[,firstmonth])

daynumberofquarter
Devuelve el nmero de da del trimestre segn una fechahora con el primer milisegundo del primer da del
trimestre que contiene a date.

daynumberofquarter (date[,firstmonth])

addmonths
Esta funcin devuelve la fecha que tiene lugar n meses despus de startdate o, si n es negativa, la fecha
que tiene lugar n meses antes de startdate.

Sintaxis:

AddMonths(startdate, n , [ , mode])

Argumentos:

Argumento Descripcin

startdate La fecha de inicio como una indicacin de fecha, por ejemplo '2012-10-12'.

n El nmero de meses como un entero positivo o negativo.

mode mode especifica si el mes se aade relativo al comienzo del mes o al final del mes. Si la
fecha de entrada es el 28 o posterior y mode est fijado en 1, la funcin devolver una
fecha que indica la misma distancia del final del mes que la fecha de entrada. Por defecto
es 0.

Ejemplos y resultados:

Ejemplo Resultado
addmonths ('2003-01-29',3) devuelve '2003-04-29'
addmonths ('2003-01-29',3,0) devuelve '2003-04-29'
addmonths ('2003-01-29',3,1) devuelve '2003-04-28'
addmonths ('2003-01-29',1,0) devuelve '2003-02-28'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 365


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
addmonths ('2003-01-29',1,1) devuelve '2003-02-26'
addmonths ('2003-02-28',1,0) devuelve '2003-03-28'
addmonths ('2003-02-28',1,1) devuelve '2003-03-31'

addyears
Esta funcin devuelve la fecha que tiene lugar n meses despus de startdate o, si n es negativa, la fecha
que tiene lugar n meses antes de startdate.

Sintaxis:

AddYears(startdate, n)

Argumentos:

Argumento Descripcin

startdate La fecha de inicio como una indicacin de fecha, por ejemplo '2012-10-12'.

n El nmero de aos como un entero positivo o negativo.

Ejemplos y resultados:

Ejemplo Resultado
addyears ('2010-01-29',3) devuelve '2013-01-29'
addyears ('2010-01-29',-1) devuelve '2009-01-29'

age
Devuelve la edad que tiene, en el momento indicado en timestamp (en aos completos), alguien nacido en
date_of_birth.

Sintaxis:

age(timestamp, date_of_birth)

Ejemplos y resultados:

Ejemplo Resultado
age('2007-01-25', '2005-10-29') Devuelve 1
age('2007-10-29', '2005-10-29') Devuelve 2

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 366


5 Funciones en scripts y en expresiones de grfico

converttolocaltime
Convierte una fecha-hora en UTC o GMT a hora local, con la forma de un valor dual. El lugar puede ser
cualquier ciudad, poblacin o zona horaria del mundo.

Sintaxis:

ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])

Tambin GMT, GMT-01:00, GMT+04:00 etc. son lugares vlidos.

El tiempo resultante tiene en cuenta y se ajusta a los cambios por ahorro energtico, a menos que el tercer
parmetro se fije en True()

Lugares y zonas horarias vlidos

Abu Dhabi Central America Kabul Nairobi Sydney

Adelaide Central Time (US & Kamchatka New Caledonia Taipei


Canada)

Alaska Chennai Karachi New Delhi Tallinn

Amsterdam Chihuahua Kathmandu Newfoundland Tashkent

Arizona Chongqing Kolkata Novosibirsk Tbilisi

Astana Copenhagen Krasnoyarsk Nuku'alofa Tehran

Athens Darwin Kuala Lumpur Osaka Tokyo

Atlantic Time Dhaka Kuwait Pacific Time (US & Urumqi


(Canada) Canada)

Auckland Eastern Time (US & Kyiv Paris Warsaw


Canada)

Azores Edinburgh La Paz Perth Wellington

Baghdad Ekaterinburg Lima Port Moresby West Central


Africa

Baku Fiji Lisbon Prague Vienna

Bangkok Georgetown Ljubljana Pretoria Vilnius

Beijing Greenland London Quito Vladivostok

Belgrade Greenwich Mean Madrid Riga Volgograd


Time : Dublin

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 367


5 Funciones en scripts y en expresiones de grfico

Lugares y zonas horarias vlidos

Berlin Guadalajara Magadan Riyadh Yakutsk

Bern Guam Mazatlan Rome Yerevan

Bogota Hanoi Melbourne Samoa Zagreb

Brasilia Harare Mexico City Santiago

Bratislava Hawaii Mid-Atlantic Sapporo

Brisbane Helsinki Minsk Sarajevo

Brussels Hobart Karachi Saskatchewan

Bucharest Hong Kong Kathmandu Seoul

Budapest Indiana (East) Kolkata Singapore

Buenos Aires International Date Monrovia Skopje


Line West

Cairo Irkutsk Monterrey Sofia

Canberra Islamabad Moscow Solomon Is.

Cape Verde Is. Istanbul Mountain Time (US & Sri


Canada) Jayawardenepura

Caracas Jakarta Mumbai St. Petersburg

Casablanca Jerusalem Muscat Stockholm

Ejemplos y resultados:

Ejemplo Resultado
ConvertToLocalTime(2007-11-10 23:59:00,Paris) Devuelve 2007-11-11 00:59:00 y la
correspondiente representacin interna de
fecha-hora.
ConvertToLocalTime(UTC(), GMT-05:00) Devuelve la hora en la costa este
norteamericana, por ej. en Nueva York.

day
Esta funcin devuelve un entero que representa el da en que la fraccin de la expression se interpreta
como una fecha conforme a la interpretacin numrica estndar.

Sintaxis:

day(expression)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 368


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplo Resultado
day( '1971-10-12' ) devuelve 30

dayend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del da. El formato de salida por defecto ser el TimestampFormat definido en el script.

Sintaxis:

DayEnd(timestamp [, shift = 0 [, dayoffset = 0]])

Argumentos:

Argumento Descripcin

timestamp La fecha/hora que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el da que contiene a timestamp. Los valores
negativos en shift indican das precedentes y los valores positivos indican das
subsiguientes.

dayoffset Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento en una fraccin del da en dayoffset, por ejemplo 0,125 para las 3am.

Ejemplos y resultados:

Ejemplo Resultado
dayend ( '2006-01-25 16:45' ) Devuelve '2006-01-25 23:59:59' con un valor numrico
subyacente correspondiente a '2006-01-25 23:59:59.999'
dayend ( '2006-01-25 16:45', -1 ) Devuelve '2006-01-24 23:59:59' con un valor numrico
subyacente correspondiente a '2006-01-24 23:59:59.999'
dayend ('2006-01-25 16:45', 0, 0.5 ) Devuelve '2006-01-26 11:59:59' con un valor numrico
subyacente correspondiente a '2006-01-26 11:59:59.999'

daylightsaving
Devuelve el ajuste actual de cambio de hora automtico, segn el horario de verano, tal y como se define en
Windows.

Sintaxis:

DaylightSaving( )

Ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 369


5 Funciones en scripts y en expresiones de grfico

daylightsaving( )

dayname
Esta funcin devuelve un valor de fecha, con un valor numrico subyacente correspondiente a una fecha-
hora con el primer milisegundo del da que contiene a timestamp.

Sintaxis:

DayName(timestamp [, shift = 0 [, dayoffset = 0]])

Argumentos:

Argumento Descripcin

timestamp La fecha/hora que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el da que contiene a timestamp. Los valores
negativos en shift indican das precedentes y los valores positivos indican das
subsiguientes.

dayoffset Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento en una fraccin del da en dayoffset, por ejemplo 0,125 para las 3am.

Ejemplos y resultados:

Ejemplo Resultado
dayname ( '2006-01-25 16:45' ) Devuelve '2006-01-25' con un valor numrico subyacente
correspondiente a '2006-01-25 00:00:00.000'
dayname ( '2006-01-25 16:45', -1 ) Devuelve '2006-01-24' con un valor numrico subyacente
correspondiente a '2006-01-24 00:00:00.000'
dayname ('2006-01-25 16:45', 0, 0.5 ) Devuelve '2006-01-25' con un valor numrico subyacente
correspondiente a '2006-01-25 12:00:00.000'

daynumberofquarter
Devuelve el nmero de da del trimestre segn una fechahora con el primer milisegundo del primer da del
trimestre que contiene a date.

Sintaxis:

DayNumberOfQuarter(date[,firstmonth])

La funcin emplea siempre aos de 366 das.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 370


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

date La fecha que se ha de evaluar.

firstmonth Especificando un firstmonth de entre 1 y 12 (1 si se omite) el comienzo del ao puede


moverse hacia delante, al primer da de cualquier mes. Si por ej, quiere trabajar con un
ao fiscal que comience el 1 de marzo, especifique firstmonth = 3.

Ejemplos y resultados:

Ejemplo Resultado
DayNumberOfQuarter(Date) Devuelve el nmero de da, contado desde el primer da del
primer trimestre.
DayNumberOfQuarter(Date,3) Devuelve el nmero de da del trimestre, contado desde el uno
de marzo.

daynumberofyear
Devuelve el nmero de da del ao, conforme a una fecha-hora con el primer milisegundo del primer da del
ao que contiene a date.

Sintaxis:

DayNumberOfYear(date[,firstmonth])

La funcin emplea siempre aos de 366 das.

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

firstmonth Especificando un firstmonth de entre 1 y 12 (1 si se omite) el comienzo del ao puede


moverse hacia delante, al primer da de cualquier mes. Si por ej, quiere trabajar con un
ao fiscal que comience el 1 de marzo, especifique firstmonth = 3.

Ejemplos y resultados:

Ejemplo Resultado
DayNumberOfYear(date) Devuelve el nmero de da, contado desde el primer da del ao.
DayNumberOfYear(date,3) Devuelve el nmero de da, contado desde el primer da de marzo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 371


5 Funciones en scripts y en expresiones de grfico

daystart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del trimestre que contiene la fecha y hora timestamp. El formato de salida por defecto ser el
TimestampFormat definido en el script.

Sintaxis:

DayStart(timestamp [, shift = 0 [, dayoffset = 0]])

Argumentos:

Argumento Descripcin

timestamp La fecha/hora que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el da que contiene a timestamp. Los valores
negativos en shift indican das precedentes y los valores positivos indican das
subsiguientes.

dayoffset Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento en una fraccin del da en dayoffset, por ejemplo 0,125 para las 3am.

Ejemplos y resultados:

Ejemplo Resultado
daystart ( '2006-01-25 16:45' ) Devuelve '2006-01-25 00:00:00' con un valor numrico
subyacente correspondiente a '2006-01-25 00:00:00.000'
daystart ( '2006-01-25 16:45', -1 ) Devuelve '2006-01-24 00:00:00' con un valor numrico
subyacente correspondiente a '2006-01-24 00:00:00.000'
daystart ('2006-01-25 16:45', 0, 0.5 ) Devuelve '2006-01-25 12:00:00' con un valor numrico
subyacente correspondiente a '2006-01-25 12:00:00.000'

firstworkdate
Devuelve la ltima fecha de inicio para obtener un no_of_workdays (de lunes-viernes) sin sobrepasar end_
date teniendo en cuenta la lista opcional de vacaciones. end_date y holiday deben ser fechas y horas
vlidas.

Sintaxis:

firstworkdate(end_date, no_of_workdays {, holiday} )

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 372


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
firstworkdate ('2007-03-01', 9) Devuelve '2007-02-19'
firstworkdate ('2006-12-31', 8, '2006-12-25', '2006-12-26') Devuelve '2006-12-18'

GMT
Esta funcin devuelve la actual hora Greenwich Mean Time, tal y como lo extrae del reloj del sistema y las
configuraciones horarias de Windows.

Sintaxis:

GMT( )

Ejemplo:

gmt( )

hour
Esta funcin devuelve un entero que representa la hora en que la fraccin de la expression se interpreta
como una hora de acuerdo con la interpretacin numrica estndar.

Sintaxis:

hour(expression)

Ejemplos y resultados:

Ejemplo Resultado
hour( '09:14:36' ) devuelve 9
hour( '0.5555' ) devuelve 13 (Porque 0.5555 = 13:19:55 )

inday
Esta funcin devuelve True si timestamp se encuentra dentro del da que contiene a basetimestamp.

Sintaxis:

InDay (timestamp, basetimestamp , shift [, daystart])

Argumentos:

Argumento Descripcin

timestamp La fecha y hora que se desea comparar con basetimestamp.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 373


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

basetimestamp La fecha y hora que se utiliza para evaluar la fecha-hora.

shift El da puede desplazarse mediante shift; shift es un entero, en el que el valor 0 indica
el da que contiene a basetimestamp. Los valores negativos en shift indican das
precedentes y los valores positivos indican das subsiguientes.

daystart Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento en una fraccin del da en daystart, por ejemplo 0,125 para las 3am.

Ejemplos y resultados:

Ejemplo Resultado
inday ( '2006-01-12 12:23', '2006-01-12 00:00', 0 ) Devuelve True
inday ( '2006-01-12 12:23', '2006-01-13 00:00', 0 ) Devuelve False
inday ( '2006-01-12 12:23', '2006-01-12 00:00', -1 ) Devuelve False
inday ( '2006-01-11 12:23', '2006-01-12 00:00', -1 ) Devuelve True
inday ( '2006-01-12 12:23', '2006-01-12 00:00', 0, 0.5 ) Devuelve False
inday ( '2006-01-12 11:23', '2006-01-12 00:00', 0, 0.5 ) Devuelve True

indaytotime
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del da que contiene
basetimestamp hasta e incluido el milisegundo exacto de basetimestamp.

Sintaxis:

InDayToTime (timestamp, basetimestamp , shift [, daystart])

Argumentos:

Argumento Descripcin

timestamp La fecha y hora que se desea comparar con basetimestamp.

basetimestamp La fecha y hora que se utiliza para evaluar la fecha-hora.

shift El da puede desplazarse mediante shift; shift es un entero, en el que el valor 0 indica
el da que contiene a basetimestamp. Los valores negativos en shift indican das
precedentes y los valores positivos indican das subsiguientes.

daystart Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento en una fraccin del da en daystart, por ejemplo 0,125 para las 3am.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 374


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
indaytotime ( '2006-01-12 12:23', '2006-01-12 23:59', 0 ) Devuelve True
indaytotime ( '2006-01-12 12:23', '2006-01-12 00:00', 0 ) Devuelve False
indaytotime ( '2006-01-11 12:23', '2006-01-12 23:59', -1 ) Devuelve True

inlunarweek
Esta funcin devuelve True si date se encuentra dentro de la semana lunar (periodos de 7 das consecutivos
que comienzan el 1 de enero de cada ao) que contiene a basedate.

Sintaxis:

InLunarWeek (date, basedate , shift [, weekstart])

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar la semana lunar.

shift La semana lunar puede desplazarse mediante shift; shift es un entero, en el que el valor 0
indica la semana lunar que contiene a basedate. Los valores negativos en shift indican
semanas lunares precedentes y los valores positivos indican semanas lunares
subsiguientes.

weekstart Si desea trabajar con un desplazamiento para el inicio de las semanas lunares, puede
indicar uno en das en weekstart. Este puede ser un nmero real que indique das y/o
fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
inlunarweek ( '2006-01-12', '2006-01-14', 0 ) Devuelve True
inlunarweek ( '2006-01-12', '2006-01-20', 0 ) Devuelve False
inlunarweek ( '2006-01-12', '2006-01-14', -1 ) Devuelve False
inlunarweek ( '2006-01-07', '2006-01-14', -1 ) Devuelve True
inlunarweek ( '2006-01-11', '2006-01-08', 0, 3 ) Devuelve False

inlunarweektodate
Esta funcin devuelve True si date se encuentra dentro de la parte de la semana lunar (el periodo de 7 das
consecutivos, empezando desde el 1 de enero de cada ao) que contiene a basedatehasta, e incluido el
ltimo milisegundo de basedate.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 375


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

InLunarWeekToDate (date, basedate , shift [, weekstart])

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar la semana lunar.

shift La semana lunar puede desplazarse mediante shift; shift es un entero, en el que el valor 0
indica la semana lunar que contiene a basedate. Los valores negativos en shift indican
semanas lunares precedentes y los valores positivos indican semanas lunares
subsiguientes.

weekstart Si desea trabajar con un desplazamiento para el inicio de las semanas lunares, puede
indicar uno en das en weekstart. Este puede ser un nmero real que indique das y/o
fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
inlunarweektodate ( '2006-01-12', '2006-01-12', 0 ) Devuelve True
inlunarweektodate ( '2006-01-12', '2006-01-11', 0 ) Devuelve False
inlunarweektodate ( '2006-01-12', '2006-01-05', 1 ) Devuelve True

inmonth
Esta funcin devuelve True si date se encuentra dentro del mes que contiene basedate.

Sintaxis:

InMonth (date, basedate , shift)

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el mes.

shift El mes puede desplazarse mediante shift; shift es un entero, en el que el valor 0 indica el
mes que contiene a basedate. Los valores negativos en shift indican meses precedentes
y los valores positivos indican meses posteriores.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 376


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
inmonth ( '2006-01-25', '2006-01-01', 0 ) Devuelve True
inmonth( '2006-01-25', '2006-04-01', 0 ) Devuelve False
inmonth ( '2006-01-25', '2006-01-01', -1 ) Devuelve False
inmonth ( '2005-12-25', '2006-01-01', -1 ) Devuelve True

inmonths
Devuelve True si date se encuentra dentro del desplazamiento n del mes (alineado desde el 1 de enero) que
contiene basedate.

Sintaxis:

InMonths (n, date, basedate , shift [, first_month_of_year = 1])

Argumentos:

Argumento Descripcin

n Un entero que debe ser (1), 2, (3), 4 6.

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el periodo.

shift El periodo puede desplazarse mediante shift; shift es un entero, en el que el valor 0 indica
el periodo que contiene a basedate. Los valores negativos en shift indican periodos
precedentes y los valores positivos indican periodos subsiguientes.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
inmonthstodate ( 4, '2006-01-25', '2006-04-25', 0 ) Devuelve True
inmonthstodate ( 4, '2006-04-25', '2006-04-24', 0 ) Devuelve False
inmonthstodate ( 4, '2005-11-25', '2006-02-01', -1 ) Devuelve True

inmonthstodate
Esta funcin devuelve True si date se encuentra dentro del desplazamiento n del mes (alineado desde el 1
de enero) que contiene basedate.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 377


5 Funciones en scripts y en expresiones de grfico

InMonths (n, date, basedate , shift [, first_month_of_year = 1])

Argumentos:

Argumento Descripcin

n Un entero que debe ser (1), 2, (3), 4 6.

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el periodo.

shift El periodo puede desplazarse mediante shift; shift es un entero, en el que el valor 0 indica
el periodo que contiene a basedate. Los valores negativos en shift indican periodos
precedentes y los valores positivos indican periodos subsiguientes.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
inmonthstodate ( 4, '2006-01-25', '2006-04-25', 0 ) Devuelve True
inmonthstodate ( 4, '2006-04-25', '2006-04-24', 0 ) Devuelve False
inmonthstodate ( 4, '2005-11-25', '2006-02-01', -1 ) Devuelve True

inmonthtodate
Esta funcin de script devuelve True si date se encuentra dentro de la parte del mes que contiene basedate
hasta e incluido el ltimo milisegundo de basedate.

Sintaxis:

InMonthToDate (date, basedate , shift)

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el mes.

shift El mes puede desplazarse mediante shift; shift es un entero, en el que el valor 0 indica el
mes que contiene a basedate. Los valores negativos en shift indican meses precedentes
y los valores positivos indican meses posteriores.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 378


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
inmonthtodate ( '2006-01-25', '2006-01-25', 0 ) Devuelve True
inmonthtodate ( '2006-01-25', '2006-01-24', 0 ) Devuelve False
inmonthtodate ( '2006-01-25', '2006-02-28', -1 ) Devuelve True

inquarter
Esta funcin devuelve True si date se encuentra dentro del trimestre que contiene basedate.

Sintaxis:

InQuarter (date, basedate , shift [, first_month_of_year = 1])

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el trimestre.

shift El trimestre puede desplazarse mediante shift. shift es un entero, en el que el valor 0
indica el trimestre que contiene a basedate. Los valores negativos en shift indican
trimestres precedentes y los valores positivos indican trimestres posteriores.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
inquarter ( '2006-01-25', '2006-01-01', 0 ) Devuelve True
inquarter ( '2006-01-25', '2006-04-01', 0 ) Devuelve False
inquarter ( '2006-01-25', '2006-01-01', -1 ) Devuelve False
inquarter ( '2005-12-25', '2006-01-01', -1 ) Devuelve True
inquarter ( '2006-01-25', '2006-03-01', 0, 3 ) Devuelve False
inquarter ( '2006-03-25', '2006-03-01', 0, 3 ) Devuelve True

inquartertodate
Esta funcin devuelve True si date se encuentra dentro de la parte del trimestre que contiene basedate
hasta e incluido el ltimo milisegundo de basedate.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 379


5 Funciones en scripts y en expresiones de grfico

InQuarterToDate (date, basedate , shift [, first_month_of_year = 1])

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el trimestre.

shift El trimestre puede desplazarse mediante shift. shift es un entero, en el que el valor 0
indica el trimestre que contiene a basedate. Los valores negativos en shift indican
trimestres precedentes y los valores positivos indican trimestres posteriores.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
inquartertodate ( '2006-01-25', '2006-01-25', 0 ) Devuelve True
inquartertodate ( '2006-01-25', '2006-01-24', 0 ) Devuelve False
inquartertodate ( '2005-12-25', '2006-02-01', -1 ) Devuelve True

inweek
Esta funcin devuelve True si date se encuentra dentro de la semana que contiene basedate.

Sintaxis:

InWeek (date, basedate , shift [, weekstart])

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar la semana.

shift La semana puede desplazarse mediante shift; shift es un entero, en el que el valor 0
indica la semana que contiene a basedate. Los valores negativos en el shift indican
semanas precedentes y los valores positivos indican semanas subsiguientes.

weekstart Si desea trabajar con semanas que no comiencen en la medianoche del domingo al lunes,
puede indicar un desplazamiento en das en weekstart. Este puede ser un nmero real
que indique das y/o fracciones de un da.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 380


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
inweek ( '2006-01-12', '2006-01-14', 0 ) Devuelve True
inweek ( '2006-01-12', '2006-01-20', 0 ) Devuelve False
inweek ( '2006-01-12', '2006-01-14', -1 ) Devuelve False
inweek ( '2006-01-07', '2006-01-14', -1 ) Devuelve True
inweek ( '2006-01-12', '2006-01-09', 0, 3 ) Devuelve False

inweektodate
Esta funcin devuelve True si date se encuentra dentro de la parte de la semana que contiene basedate
hasta e incluido el ltimo milisegundo de basedate.

Sintaxis:

InWeekToDate (date, basedate , shift [, weekstart])

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar la semana.

shift La semana puede desplazarse mediante shift; shift es un entero, en el que el valor 0
indica la semana que contiene a basedate. Los valores negativos en el shift indican
semanas precedentes y los valores positivos indican semanas subsiguientes.

weekstart Si desea trabajar con semanas que no comiencen en la medianoche del domingo al lunes,
puede indicar un desplazamiento en das en weekstart. Este puede ser un nmero real
que indique das y/o fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
inweektodate ( '2006-01-12', '2006-01-12', 0 ) Devuelve True
inweektodate ( '2006-01-12', '2006-01-11', 0 ) Devuelve False
inweektodate ( '2006-01-12', '2006-01-05', -1 ) Devuelve False

inyear
Esta funcin devuelve True si date se encuentra dentro del ao que contiene basedate.

Sintaxis:

InYear (date, basedate , shift [, first_month_of_year = 1])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 381


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el ao.

shift El ao puede desplazarse mediante shift. shift es un entero, en el que el valor 0 indica el
ao que contiene a basedate. Los valores negativos de shift indican aos precedentes y
los valores positivos indican aos futuros.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
inyear ( '2006-01-25', '2006-01-01', 0 ) Devuelve True
inyear ( '2005-01-25', '2006-01-01', 0 ) Devuelve False
inyear ( '2006-01-25', '2006-01-01', -1 ) Devuelve False
inyear ( '2005-01-25', '2006-01-01', -1 ) Devuelve True
inyear ( '2006-01-25', '2006-07-01', 0, 3 ) Devuelve False
inyear ( '2006-03-25', '2006-07-01', 0, 3 ) Devuelve True

inyeartodate
Esta funcin devuelve True si date se encuentra dentro de la parte del ao que contiene basedate hasta e
incluido el ltimo milisegundo de basedate.

Sintaxis:

InYearToDate (date, basedate , shift [, first_month_of_year = 1])

Argumento Descripcin

date La fecha que desee comparar con basedate.

basedate La fecha que se utiliza para evaluar el ao.

shift El ao puede desplazarse mediante shift. shift es un entero, en el que el valor 0 indica el
ao que contiene a basedate. Los valores negativos de shift indican aos precedentes y
los valores positivos indican aos futuros.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 382


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
inyeartodate ( '2006-01-25', '2006-02-01', 0 ) Devuelve True
inyear ( '2005-01-25', '2006-01-01', 0 ) Devuelve False
inyear ( '2005-01-25', '2006-02-01', -1 ) Devuelve True

lastworkdate
Devuelve la primera fecha de finalizacin para obtener el no_of_workdays (lunes-viernes) si comienza en
start_date y teniendo en cuenta cualquier holiday opcionalmente indicadas.start_date y holiday deben ser
fechas o fecha-hora vlidas.

Sintaxis:

lastworkdate(start_date, no_of_workdays {, holiday})

Ejemplos y resultados:

Ejemplo Resultado
lastworkdate ('2007-02-19', 9) Devuelve '2007-03-01'
lastworkdate ('2006-12-18', 8, '2006-12-25', '2006-12-26') Devuelve '2006-12-29'

localtime
Esta funcin devuelve una fecha y hora con la hora actual segn el reloj del sistema y una determinada zona
horaria.

Sintaxis:

LocalTime([timezone [, ignoreDST ]])

Argumentos:

Argumento Descripcin

timezone La zona horaria timezone se especifica como una cadena que contiene cualquiera de los
lugares geogrficos listados en Zona Horaria, en el Panel de Control de Windows
para Fecha y Hora o como una cadena con la forma 'GMT+hh:mm'.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 383


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

Si no se especifica zona horaria, devolver la hora local.

ignoreDST Si ignoreDST es -1 (True) se ignorarn las configuraciones del horario de verano.

Ejemplos:

localtime ('Paris')
localtime ('GMT+01:00')
localtime ('Paris',-1)
localtime()

lunarweekend
Esta funcin devuelve un valor correspondiente a una indicacin de tiempo (fecha y hora) con el ltimo
milisegundo de la semana lunar (periodos consecutivos de 7 das que comienzan el 1 de enero de cada ao)
que contiene a la fecha. El formato de salida por defecto ser el DateFormat definido en el script.

Sintaxis:

LunarweekEnd(date [, shift = 0 [,weekoffset = 0]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica la semana lunar que contiene a date. Los
valores negativos en shift indican semanas lunares precedentes y los valores positivos
indican semanas lunares subsiguientes.

weekoffset Si desea trabajar con un desplazamiento para el inicio de las semanas lunares, puede
indicar uno en das en weekoffset.Este puede ser un nmero real que indique das y/o
fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
lunarweekend ( '2006-01-12' ) Devuelve '2006-01-14' con un valor numrico subyacente
correspondiente a '2006-01-14 23:59:59.999'
lunarweekend ( '2006-01-12', -1 ) Devuelve '2006-01-07' con un valor numrico subyacente
correspondiente a '2006-01-07 23:59:59.999'
lunarweekend ( '2006-01-12', 0, 1 ) Devuelve '2006-01-15' con un valor numrico subyacente
correspondiente a '2006-01-15 23:59:59.999'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 384


5 Funciones en scripts y en expresiones de grfico

lunarweekname
Esta funcin devuelve un valor que muestra el ao y nmero de semana, con un valor numrico subyacente
correspondiente a una fecha y hora, con el primer milisegundo del primer da de la semana lunar (periodo de
7 das consecutivos comenzando desde el 1 de enero) que contiene la fecha.

Sintaxis:

LunarWeekName(date [, shift = 0 [,weekoffset = 0]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica la semana lunar que contiene a date. Los
valores negativos en shift indican semanas lunares precedentes y los valores positivos
indican semanas lunares subsiguientes.

weekoffset Si desea trabajar con un desplazamiento para el inicio de las semanas lunares, puede
indicar uno en das en weekoffset.Este puede ser un nmero real que indique das y/o
fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
lunarweekname ( '2006-01-12' ) Devuelve '2006/02' con un valor numrico subyacente
correspondiente a '2006-01-08 00:00:00.000'
lunarweekname ( '2006-01-12', -1 ) Devuelve '2006/01' con un valor numrico subyacente
correspondiente a '2006-01-01 00:00:00.000'
lunarweekname ( '2006-01-12', 0, 1 ) Devuelve '2006/02' con un valor numrico subyacente
correspondiente a '2006-01-09 00:00:00.000'

lunarweekstart
Esta funcin devuelve un valor correspondiente a una fecha y hora con el primer milisegundo de la semana
lunar (el periodo consecutivo de 7 das que comienza el 1 de enero de cada ao) que contiene la fecha date.
El formato de salida por defecto ser el DateFormat definido en el script.

Sintaxis:

LunarweekStart(date [, shift = 0 [,weekoffset = 0]])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 385


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica la semana lunar que contiene a date. Los
valores negativos en shift indican semanas lunares precedentes y los valores positivos
indican semanas lunares subsiguientes.

weekoffset Si desea trabajar con un desplazamiento para el inicio de las semanas lunares, puede
indicar uno en das en weekoffset.Este puede ser un nmero real que indique das y/o
fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
lunarweekstart ( '2006-01-12' ) Devuelve '2006-01-08' con un valor numrico subyacente
correspondiente a '2006-01-08 00:00:00.000'
lunarweekstart ( '2006-01-12', -1 ) Devuelve '2006-01-01' con un valor numrico subyacente
correspondiente a '2006-01-01 00:00:00.000'
lunarweekstart ( '2006-01-12', 0, 1 ) Devuelve '2006-01-09' con un valor numrico subyacente
correspondiente a '2006-01-09 00:00:00.000'

makedate
Esta funcin devuelve una fecha calculada desde el ao YYYY, el mes MM y el dia DD.

Sintaxis:

MakeDate(YYYY [ , MM [ , DD ] ])

Argumentos:

Argumento Descripcin

YYYY El ao como un entero.

MM El mes como un entero. Si no se especifica un mes, se presupone 1 (Enero).

DD El da como un entero.
Si no se especifica un da, se presupone 1 (el primer da del mes).

Ejemplos y resultados:

Ejemplo Resultado
makedate(2012) devuelve 2012-01-01
makedate(12) devuelve 2012-01-01

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 386


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
makedate(2012,12) devuelve 2012-01-01
makedate(2012,2,14) devuelve 2012-12-01

maketime
Esta funcin devuelve una hora calculada a partir de la hora hh, el minuto mm, el segundo ss, con una
fraccin fff hasta el milisegundo.

Sintaxis:

MakeTime(hh [ , mm [ , ss [ .fff ] ] ])

Argumentos:

Argumento Descripcin

hh La hora como un entero.

mm El minuto como un entero.

Si no se especifica minuto, se presupone 00.

ss El segundo como un entero.

Si no se especifica segundo, se presupone 00.

.fff Una fraccin de un segundo como un entero.

Si no se especifica una fraccin de segundo, se presupone 000.

Ejemplos y resultados:

Ejemplo Resultado
maketime( 22 ) devuelve 22-00-00
maketime( 22, 17 ) devuelve 22-17-00
maketime( 22, 17, 52 ) devuelve 22-17-52

makeweekdate
Esta funcin devuelve una fecha calculada a partir del ao YYYY, la semana WW y el da de la semana D.

Sintaxis:

MakeWeekDate(YYYY [ , WW [ , D ] ])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 387


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

YYYY El ao como un entero.

WW La semana como un entero.

D El da de la semana como un entero.

Si no se especifica da de la semana alguno, se presupone 0 (Lunes).

Ejemplos y resultados:

Ejemplo Resultado
makeweekdate(1999,6,6) devuelve 1999-02-14
makeweekdate(1999,6,6) devuelve 1999-02-08

minute
Esta funcin devuelve un entero que representa el minuto en el que la fraccin de la expression se
interpreta como una hora conforme a la interpretacin numrica estndar.

Sintaxis:

minute(expression)

Ejemplos y resultados:

Ejemplo Resultado
minute ( '09:14:36' ) devuelve 14
minute ( '0.5555' ) devuelve 19 (Porque 0.5555 = 13:19:55 )

month
Esta funcin devuelve un valor dual con un nombre de mes tal y como venga definido en la variable de
entorno MonthNames y un entero entre 1-12. El mes se calcula a partir de la interpretacin de la fecha de la
expresin, conforme a la interpretacin numrica estndar.

Sintaxis:

month(expression)

Ejemplos y resultados:

Ejemplo Resultado
month( '2012-10-12' ) devuelve Oct

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 388


5 Funciones en scripts y en expresiones de grfico

monthend
Esta funcin devuelve un valor correspondiente a una fecha y hora con el ltimo milisegundo del ltimo da
del mes que contiene la fecha date. El formato de salida por defecto ser el DateFormat definido en el
script.

Sintaxis:

MonthEnd(date [, shift = 0])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el mes que contiene a date. Los valores
negativos en shift indican meses precedentes y los valores positivos indican meses
posteriores.

Ejemplos y resultados:

Ejemplo Resultado
monthend ( '2001-02- Devuelve '2001-02-28' con un valor numrico subyacente correspondiente a
19' )
'2001-02-28 23:59:59.999'
monthend ( '2001-02- Devuelve '2001-01-31' con un valor numrico subyacente correspondiente a
19', -1 )
'2001-01-31 23:59:59.999'

monthname
Esta funcin devuelve un valor que muestra el mes (formateado segn la variable de script MonthNames) y
el ao, con un valor numrico subyacente correspondiente a una fecha y hora con el primer milisegundo del
primer da del mes.

Sintaxis:

MonthName(date [, shift = 0])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el mes que contiene a date. Los valores
negativos en shift indican meses precedentes y los valores positivos indican meses
posteriores.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 389


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplo Resultado
monthname ( '2001-10- Devuelve 'Oct 2001' con un valor numrico subyacente correspondiente a
19' )
'2001-10-01 00:00:00.000'
monthname ( '2001-10- Devuelve 'Sep 2001' con un valor numrico subyacente correspondiente a
19', -1 )
'2001-09-01 00:00:00.000'

monthsend
Esta funcin devuelve un valor correspondiente a una fecha y hora con el ltimo milisegundo del periodo
mensual n (comenzando desde el 1 de enero) que contiene la fecha date. El formato de salida por defecto
ser el DateFormat definido en el script.

Sintaxis:

MonthsEnd(n, date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Argumento Descripcin

n n debe ser (1), 2, (3), 4 6.

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el periodo que contiene a date. Los valores
negativos en shift indican periodos precedentes y los valores positivos indican periodos
subsiguientes.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
monthsend ( 4, '2001-07- Devuelve '2001-08-31' con un valor numrico subyacente correspondiente a
19' )
'2001-08-31 23:59:59.999'
monthsend ( 4, '2001-10- Devuelve '2001-08-31' con un valor numrico subyacente correspondiente a
19', -1 )
'2001-08-31 23:59:59.999'
monthsend ( 4, '2001-10- Devuelve '2002-01-31' con un valor numrico subyacente correspondiente a
19', 0, 2 )
'2002-01-31 23:59:59.999'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 390


5 Funciones en scripts y en expresiones de grfico

monthsname
Esta funcin devuelve un valor que muestra los meses del periodo (formateados segn la variable de script
MonthNames) y el ao con un valor numrico subyacente correspondiente a una fecha y hora con el primer
milisegundo del periodo n de meses (empezando desde el 1 de enero) que contiene la date.

Sintaxis:

MonthsName(n, date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Argumento Descripcin

n n debe ser (1), 2, (3), 4 6.

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el periodo que contiene a date. Los valores
negativos en shift indican periodos precedentes y los valores positivos indican periodos
subsiguientes.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
monthsname ( 4, '2001-10- Devuelve 'Sep-Dec 2001' con un valor numrico subyacente
19' )
correspondiente a '2001-09-01 00:00:00.000'
monthsname ( 4, '2001-10- Devuelve 'May-Aug 2001' con un valor numrico subyacente
19', -1 )
correspondiente a '2001-05-01 00:00:00.000'
monthsname ( 4, '2001-10- Devuelve 'Oct-Jan 2002' con un valor numrico subyacente correspondiente
19', 0, 2 )
a '2001-10-01 00:00:00.000'

monthsstart
Esta funcin devuelve un valor correspondiente a una fecha y hora con el primer milisegundo del periodo
mensual n (comenzando desde el 1 de enero) que contiene la fecha date. El formato de salida por defecto
ser el DateFormat definido en el script.

Sintaxis:

MonthsStart(n, date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 391


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

n Un entero que debe ser (1), 2, (3), 4 6.

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el periodo que contiene a date. Los valores
negativos en shift indican periodos precedentes y los valores positivos indican periodos
subsiguientes.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
monthsstart ( 4, '2001-10- Devuelve '2001-09-01' con un valor numrico subyacente correspondiente
19' )
a '2001-09-01 00:00:00.000
monthsstart ( 4, '2001-10- Devuelve '2001-05-01' con un valor numrico subyacente correspondiente
19', -1 )
a '2001-05-01 00:00:00.000'
monthsstart ( 4, '2001-10- Devuelve '2001-10-01' con un valor numrico subyacente correspondiente
19', 0, 2 )
a '2001-10-01 00:00:00.000'

monthstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da del mes que contiene la fecha date. El formato de salida por defecto ser el DateFormat
definido en el script.

Sintaxis:

MonthStart(date [, shift = 0])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el mes que contiene a date. Los valores
negativos en shift indican meses precedentes y los valores positivos indican meses
posteriores.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 392


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
monthstart ( '2001-10- Devuelve '2001-10-01' con un valor numrico subyacente correspondiente a
19' )
'2001-10-01 00:00:00.000'
monthstart ( '2001-10- Devuelve '2001-09-01' con un valor numrico subyacente correspondiente a
19', -1 )
'2001-09-01 00:00:00.000'

networkdays
Devuelve el nmero de das laborables (lunes-viernes) situados entre start_date y end_date (ambos
inclusive) teniendo en cuenta la lista opcional de holiday. Todos los parmetros debern ser fechas o
marcas temporales vlidas.

Sintaxis:

networkdays (start:date, end_date {, holiday})

Ejemplos y resultados:

Ejemplo Resultado
networkdays ('2007-02-19', '2007-03-01') Devuelve 9
networkdays ('2006-12-18', '2006-12-31', '2006-12-25', '2006-12-26') Devuelve 8

now
Esta funcin devuelve una fecha-hora con la hora actual segn el reloj del sistema.

Sintaxis:

now([ timer_mode])

Argumentos:

Argumento Descripcin

timer_mode Puede tener los siguientes valores:

0Hora a la que se ejecut el script


1Hora a la que se invoc la funcin
2Hora a la que se abri la app

Por defecto timer_mode es 1. timer_mode = 1 debe emplearse con cuidado, ya que


consulta al sistema operativo cada segundo y de ah que pueda ralentizar el rendimiento
del sistema.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 393


5 Funciones en scripts y en expresiones de grfico

quarterend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del trimestre que contiene la date. El formato de salida por defecto ser el DateFormat definido en el script.

Sintaxis:

QuarterEnd(date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el trimestre que contiene a date. Los valores
negativos en shift indican trimestres precedentes y los valores positivos indican trimestres
posteriores.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
quarterend ( '2005-10- Devuelve '2005-12-31' con un valor numrico subyacente correspondiente a
29' )
'2005-12-31 23:59:59.999'
quarterend( '2005-10- Devuelve '2005-09-30' con un valor numrico subyacente correspondiente a
29', -1 )
'2005-09-30 23:59:59.999'
quarterend ( '2005-10- Devuelve '2005-11-30' con un valor numrico subyacente correspondiente a
29', 0, 3 )
'2005-11-30 23:59:59.999'

quartername
Esta funcin devuelve un valor que muestra los meses del trimestre (formateado conforme a la variable de
script MonthNames) y el ao, con un valor numrico subyacente correspondiente a una fecha y hora con el
primer milisegundo del primer da del trimestre.

Sintaxis:

QuarterName(date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 394


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el trimestre que contiene a date. Los valores
negativos en shift indican trimestres precedentes y los valores positivos indican trimestres
posteriores.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
quartername ( '2005-10- Devuelve 'Oct-Dec 2005' con un valor numrico subyacente correspondiente
29' )
a '2005-10-01 00:00:00.000'
quartername ( '2005-10- Devuelve 'Jul-Sep 2005' con un valor numrico subyacente correspondiente
29', -1 )
a '2005-07-01 00:00:00.000'
quartername ( '2005-10- Devuelve 'Sep-Nov 2005' con un valor numrico subyacente correspondiente
29', 0, 3 )
a '2005-09-01 00:00:00.000'

quarterstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del trimestre que contiene a date. El formato de salida por defecto ser el DateFormat definido en el script.

Sintaxis:

QuarterStart(date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el trimestre que contiene a date. Los valores
negativos en shift indican trimestres precedentes y los valores positivos indican trimestres
posteriores.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 395


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
quarterstart ( '2005-10- Devuelve '2005-10-01' con un valor numrico subyacente correspondiente a
29' )
'2005-10-01 00:00:00.000
quarterstart ( '2005-10- Devuelve '2005-07-01' con un valor numrico subyacente correspondiente a
29', -1 )
'2005-07-01 00:00:00.000'
quarterstart ( '2005-10- Devuelve '2005-09-01' con un valor numrico subyacente correspondiente a
29', 0, 3 )
'2005-09-01 00:00:00.000

second
Esta funcin devuelve un entero que representa el segundo en que la fraccin de la expression se interpreta
como una hora conforme a la interpretacin numrica estndar.

Sintaxis:

second (expression)

Ejemplos y resultados:

Ejemplo Resultado
second( '09:14:36' ) devuelve 36
second( '0.5555' ) devuelve 55 (Porque 0.5555 = 13:19:55 )

setdateyear
Esta funcin devuelve una fecha-hora basada en la entrada timestamp, pero reemplazando el ao por year.

Sintaxis:

setdateyear (timestamp, year)

Argumentos:

Argumento Descripcin

timestamp Es una marca de fecha-hora estndar de Qlik Sense (a menudo solo una fecha).

year Es un ao de cuatro dgitos.

Ejemplos y resultados:

Ejemplo Resultado
setdateyear ('2005-10-29', 2006) Devuelve '2006-10-29'
setdateyear ('2005-10-29 04:26', 2006) Devuelve '2006-10-29 04:26'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 396


5 Funciones en scripts y en expresiones de grfico

setdateyearmonth
Devuelve una fecha-hora basada en la timestamp de entrada pero con el ao reemplazado por year y el
mes reemplazado por month..

Sintaxis:

SetDateYearMonth (timestamp, year, month)

Argumentos:

Argumento Descripcin

timestamp Es una marca de fecha-hora estndar de Qlik Sense (a menudo solo una fecha).

year Es un ao de cuatro dgitos.

month Es un mes de uno o dos dgitos.

Ejemplos y resultados:

Ejemplo Resultado
setdateyearmonth ('2005-10-29', 2006, 3) Devuelve '2006-03-29'
setdateyearmonth ('2005-10-29 04:26', 2006, 3) Devuelve '2006-03-29 04:26'

timezone
Esta funcin devuelve el nombre de la zona horaria actual tal y como se define en Windows.

Sintaxis:

TimeZone( )

Ejemplo:

timezone( )

today
Esta funcin devuelve la fecha actual segn el reloj del sistema.

Sintaxis:

today([ timer_mode])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 397


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

timer_mode Puede tener los siguientes valores:

0 Instante en el que se ejecut el script

1 Instante en el que se llam a la funcin

2 Instante en el que se abri la app

Por defecto timer_mode es 1. timer_mode = 1 debe emplearse con cuidado, ya que


consulta al sistema operativo cada segundo y de ah que pueda ralentizar el rendimiento
del sistema.

UTC
Devuelve la actual Coordinated Universal Time.

Sintaxis:

UTC( )

Ejemplo:

utc( )

week
Esta funcin devuelve un entero que representa el nmero de semana conforme a la ISO 8601. El nmero
de semana se calcula a partir de la interpretacin de la fecha de la expresin, conforme a la interpretacin
numrica estndar.

Sintaxis:

week(expression)

Ejemplos y resultados:

Ejemplo Resultado
week( '2012-10-12' ) devuelve 44

weekday
Esta funcin devuelve un valor dual con lo siguiente:

l El nombre del da del modo definido en la variable de entorno DayNames.


l Un nmero entero entre 0 y 6 correspondiente al da nominal de la semana (0-6).

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 398


5 Funciones en scripts y en expresiones de grfico

weekday(date [,weekstart=0])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

weekstart Si no se especifica weekstart, se utilizar el valor de la variable FirstWeekDay como


primer da de la semana.

Si desea utilizar otro da como primer da de la semana, establezca weekstart en:

l 0 para lunes
l 1 para martes
l 2 para mircoles
l 3 para jueves
l 4 para viernes
l 5 para sbado
l 6 para domingo

El valor devuelto por la funcin utilizar el primer da de la semana establecido con


weekstart como base (0).

Vea tambin: FirstWeekDay (pgina 114)

Ejemplos y resultados:
A menos que se indique de forma especfica, FirstWeekDay se encuentra establecido en 0 en estos
ejemplos.

Ejemplo Resultado
weekday( '1971-10-12' ) devuelve 'Verdadero' y 1
weekday( '1971-10-12' , 6) devuelve 'Tue' y 2.

En este ejemplo, se utiliza el domingo (6) como primer da de la semana.


SET FirstWeekDay = 6; devuelve 'Tue' y 2.

...
weekday( '1971-10-12')

weekend
Esta funcin devuelve un valor correspondiente a una indicacin de tiempo (una fecha y hora) con el ltimo
milisegundo del ltimo da (domingo) de la semana natural que contiene a date. El formato de salida
predefinido ser el DateFormat definido en el script.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 399


5 Funciones en scripts y en expresiones de grfico

WeekEnd(date [, shift = 0 [,weekoffset = 0]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica la semana que contiene a date. Los valores
negativos en el desplazamiento indican semanas precedentes y los valores positivos
indican semanas subsiguientes.

weekoffset Si desea trabajar con semanas que no comiencen en la medianoche del domingo al lunes,
puede indicar un desplazamiento en das en weekoffset.Este puede ser un nmero real
que indique das y/o fracciones de un da.

Ejemplos y resultados:

Ejemplo Resultado
weekend ( '2006-01-12' Devuelve '2006-01-15' con un valor numrico subyacente correspondiente a
)
'2006-01-15 23:59:59.999'
weekend ( '2006-01- Devuelve '2006-01-08' con un valor numrico subyacente correspondiente a
12', -1 )
'2006-01-08 23:59:59.999
weekend ( '2006-01- Devuelve '2006-01-16' con un valor numrico subyacente correspondiente a
12', 0, 1 )
'2006-01-16 23:59:59.999'

weekname
Esta funcin devuelve un valor que muestra el ao y el nmero de semana, con un valor numrico
subyacente correspondiente a una indicacin de fecha y hora con el primer milisegundo del primer da de la
semana que contiene a date.

Sintaxis:

WeekName(date [, shift = 0 [,weekoffset = 0]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica la semana que contiene a date. Los valores
negativos en el desplazamiento indican semanas precedentes y los valores positivos
indican semanas subsiguientes.

weekoffset Si desea trabajar con semanas que no comiencen en la medianoche del domingo al lunes,
puede indicar un desplazamiento en das en weekoffset.Este puede ser un nmero real
que indique das y/o fracciones de un da.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 400


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplo Resultado
weekname ( '2006-01-12' Devuelve '2006/02' con un valor numrico subyacente correspondiente a
)
'2006-01-09 00:00:00.000'
weekname ( '2006-01-12', Devuelve '2006/01' con un valor numrico subyacente correspondiente a
-1 )
'2006-01-02 00:00:00.000'
weekname ( '2006-01-12', Devuelve '2006/02' con un valor numrico subyacente correspondiente a
0, 1 )
'2006-01-10 00:00:00.000'

weekstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da (Lunes) de la semana natural que contiene la fecha date. El formato de salida predeterminado
es el DateFormat definido en el script.

Sintaxis:

WeekStart(date [, shift = 0 [,weekstart = 0]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica la semana que contiene a date. Los valores
negativos en el desplazamiento indican semanas precedentes y los valores positivos
indican semanas subsiguientes.

weekstart Si no se especifica weekstart, se utilizar el valor de la variable FirstWeekDay como


primer da de la semana.

Si desea utilizar otro da como primer da de la semana, establezca weekstart en:

l 0 para lunes
l 1 para martes
l 2 para mircoles
l 3 para jueves
l 4 para viernes
l 5 para sbado
l 6 para domingo

Vea tambin: FirstWeekDay (pgina 114)

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 401


5 Funciones en scripts y en expresiones de grfico

FirstWeekDay se ha establecido en 0 en estos ejemplos.

Ejemplo Resultado
weekstart ( '2006-01- Devuelve '2006-01-09' con un valor numrico subyacente correspondiente a
12' )
'2006-01-09 00:00:00.000'
weekstart ( '2006-01- Devuelve '2006-01-02' con un valor numrico subyacente correspondiente a
12', -1 )
'2006-01-02 00:00:00.000'
weekstart ( '2006-01- Devuelve '2006-01-10' con un valor numrico subyacente correspondiente a
12', 0, 1 )
'2006-01-10 00:00:00.000'

weekyear
Esta funcin devuelve el ao al que pertenece el nmero de semana conforme a la ISO 8601. El nmero de
semana vara entre 1 y 52 aproximadamente.

Sintaxis:

weekyear(expression)

Ejemplos y resultados:

Ejemplo Resultado
weekyear( '1996-12-30' ) devuelve 1997
weekyear( '1997-01-02' ) devuelve 1997
weekyear( '1997-12-30' ) devuelve 1997
weekyear( '1999-01-02' ) devuelve 1998

Limitaciones:

Algunos aos la semana #1 empieza en diciembre, por ej. diciembre de 1997. Otros aos comienzan con la
semana #53 del ao anterior, por ej. enero de 1999. Para esos pocos das en los que el nmero de semana
corresponda a otro ao, si aplicamos las funciones year and weekyear obtendremos lgicamente valores
diferentes.

year
Esta funcin devuelve un entero que representa el ao en que la expression se interpreta como una fecha
conforme a la interpretacin numrica estndar.

Sintaxis:

year(expression)

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 402


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
year( '2012-10-12' ) devuelve 2012

yearend
Esta funcin devuelve un valor correspondiente a una fecha-hora con el ltimo milisegundo del ltimo da del
ao que contiene la fecha date. El formato de salida por defecto ser el DateFormat definido en el script.

Sintaxis:

YearEnd( date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el ao que contiene a date. Los valores
negativos de shift indican aos precedentes y los valores positivos indican aos futuros.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Ejemplo Resultado
yearend ( '2001-10-19' Devuelve '2001-12-31' con un valor numrico subyacente correspondiente a
)
'2001-12-31 23:59:59.999'
yearend ( '2001-10- Devuelve '2000-12-31' con un valor numrico subyacente correspondiente a
19', -1 )
'2000-12-31 23:59:59.999'
yearend ( '2001-10- Devuelve '2002-03-31' con un valor numrico subyacente correspondiente a
19', 0, 4 )
'2002-03-31 23:59:59.999'

yearname
Esta funcin devuelve un ao de cuatro dgitos con un valor numrico correspondiente a una fecha-hora con
el primer milisegundo del primer da del ao que contiene la fecha date.

Sintaxis:

YearName(date [, shift = 0 [, first_month_of_year = 1]] )

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 403


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el ao que contiene a date. Los valores
negativos de shift indican aos precedentes y los valores positivos indican aos futuros.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year. El valor resultante ser pues una cadena que
year muestre dos aos.

Ejemplos y resultados:

Ejemplo Resultado
yearname ( '2001-10- Devuelve '2001' con un valor numrico subyacente correspondiente a '2001-
19')
01-01 00:00:00.000'
yearname ( '2001-10- Devuelve '2000' con un valor numrico subyacente correspondiente a '2000-
19', -1 )
01-01 00:00:00.000'
yearname ( '2001-10- Devuelve '2001-2002' con un valor numrico subyacente correspondiente a
19', 0, 4 )
'2001-04-01 00:00:00.000'

yearstart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da del ao que contiene la fecha date. El formato de salida por defecto ser el DateFormat
definido en el script.

Sintaxis:

YearStart( date [, shift = 0 [, first_month_of_year = 1]])

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar.

shift shift es un entero, en el que el valor 0 indica el ao que contiene a date. Los valores
negativos de shift indican aos precedentes y los valores positivos indican aos futuros.

first_ Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
month_of_ entre 2 y 12 en first_month_of_year.
year

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 404


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
yearstart ( '2001-10- Devuelve '2001-01-01' con un valor numrico subyacente correspondiente a
19' )
'2001-01-01 00:00:00.000'
yearstart ( '2001-10- Devuelve '2000-01-01' con un valor numrico subyacente correspondiente a
19', -1 )
'2000-01-01 00:00:00.000'
yearstart ( '2001-10- Devuelve '2001-04-01' con un valor numrico subyacente correspondiente a
19', 0, 4 )
'2001-04-01 00:00:00.000'

yeartodate
Esta funcin devuelve True si unadate se encuentra dentro del ao de la fecha, si no, False.

Sintaxis:

YearToDate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])

Si no se utiliza ninguno de los parmetros optativos, el ao de la fecha implica cualquier fecha de un ao


natural desde el 1 de enero hasta el da de la ltima ejecucin del script, incluido.

Argumentos:

Argumento Descripcin

date La fecha que se ha de evaluar como una indicacin de tiempo, por ejemplo '2012-10-12'.

yearoffset Si se especifica un yearoffset (0 si se omite), la funcin puede trasponerse para que


devuelva True para el mismo perodo pero de otro ao. Un yearoffset negativo indica aos
anteriores, mientras que uno positivo indica aos futuros. El ao anterior a la fecha se
obtiene especificando yearoffset = -1.

firstmonth Especificando un firstmonth de entre 1 y 12 (1 si se omite) el comienzo del ao puede


moverse hacia delante, al primer da de cualquier mes. Si por ej, deseamos trabajar con
un ao fiscal que comience el 1 de mayo, especificamos firstmonth = 5.

todaydate Especificando una todaydate (o fecha/hora de la ltima ejecucin de script, en caso de


omitirse) podemos desplazar el da utilizado como lmite superior del perodo.

Ejemplos y resultados:
Los ejemplos a continuacin asumen como el ltimo momento de recarga = 2011-11-18

Ejemplo Resultado
yeartodate( '2010-11-18') devuelve False

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 405


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado
yeartodate( '2011-02-01') devuelve True
yeartodate( '2011-11-18') devuelve True
yeartodate( '2011-11-19') devuelve False
yeartodate( '2010-11-18', -1) devuelve True
yeartodate( '2011-11-18', -1) devuelve False
yeartodate( '2011-04-30', 0, 5) devuelve False
yeartodate( '2011-05-01', 0, 5) devuelve True

5.6 Funciones exponenciales y logartmicas


En esta seccin se describen funciones relacionadas con los clculos exponenciales y logartmicos. Todas
las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de grficos.

En las funciones que hay a continuacin, los parmetros son expresiones donde x debe interpretarse como
un nmero de valor real.

exp
Funcin exponencial del logaritmo natural en base e. El resultado es un nmero positivo.

exp(x )

log
El logaritmo natural de x. La funcin solo se define si x> 0. El resultado es un nmero.

log(x )

log10
El logaritmo en base 10 de x. La funcin solo se define si x> 0. El resultado es un nmero.

log10(x )

pow
Devuelve x elevado a la y-sima potencia. El resultado es un nmero.

pow(x,y )

sqr
Raz cuadrada de x. El resultado es un nmero.

sqr (x )

sqrt
Raz cuadrada de x. La funcin solo se define si x >= 0. El resultado es un nmero positivo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 406


5 Funciones en scripts y en expresiones de grfico

sqrt(x )

5.7 Funciones de campo


Estas funciones slo pueden emplearse en expresiones de grficos.

Las funciones de campo devuelven enteros o cadenas que identifican diferentes aspectos de las selecciones
de campo.

Funciones de contador
GetSelectedCount
GetSelectedCount() halla el nmero de valores seleccionados (verde) en un campo.

GetSelectedCount - funcin de grfico (field_name [, include_excluded])

GetAlternativeCount
GetAlternativeCount() se utiliza para hallar el nmero de valores alternativos (gris claro) en el campo
identificado.

GetAlternativeCount - funcin de grfico (field_name)

GetPossibleCount
GetPossibleCount() se utiliza para hallar el nmero de valores posibles en el campo identificado. Si el
campo identificado incluye selecciones, los campos seleccionados (de color verde) se cuentan. De lo
contrario, se cuentan los valores asociados (de color blanco).

GetPossibleCount - funcin de grfico(field_name)

GetExcludedCount
GetExcludedCount() se utiliza para hallar el nmero de valores excluidos (gris oscuro) en el campo
identificado.

GetExcludedCount - funcin de grfico (pgina 410)(field_name)

GetNotSelectedCount
Esta funcin de grfico devuelve el nmero de valores no seleccionados en el campo fieldname. El campo
deber estar en modoAnd para que esta funcin sea aplicable.

GetNotSelectedCount - funcin de grfico(fieldname [,


includeexcluded=false])

Funciones de campo y seleccin


GetCurrentSelections
GetCurrentSelections() devuelve las selecciones actuales de la app.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 407


5 Funciones en scripts y en expresiones de grfico

GetCurrentSelections - funcin de grfico([record_sep [,tag_sep [,value_sep


[,max_values]]]])

GetFieldSelections
GetFieldSelections() devuelve una cadena con las selecciones actuales de un campo.

GetFieldSelections - funcin de grfico ( field_name [, value_sep [, max_


values]])

GetAlternativeCount - funcin de grfico


GetAlternativeCount() se utiliza para hallar el nmero de valores alternativos (gris claro) en el campo
identificado.

Sintaxis:

GetAlternativeCount (field_name)

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

field_name El campo que contiene el rango de datos que se han de medir.

Ejemplos y resultados:

En el ejemplo que se muestra a continuacin se utilizan dos campos cargados en distintos paneles de
filtrado, uno para el nombre First name y otro para Initials.

Ejemplos Resultados

Teniendo en cuenta que John est seleccionado 4 puesto que hay 4 valores nicos y excluidos (en
en First name. gris) en First name.

GetAlternativeCount ([First name])

Puesto que John y Peter estn seleccionados. 3 puesto que hay 3 valores nicos y excluidos (en
gris) en First name.
GetAlternativeCount ([First name])

Puesto que ningn valor est seleccionado en 0 puesto que no hay selecciones.
First name.

GetAlternativeCount ([First name])

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 408


5 Funciones en scripts y en expresiones de grfico

John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

GetCurrentSelections - funcin de grfico


GetCurrentSelections() devuelve las selecciones actuales de la app.

Si queremos utilizar opciones, es necesario especificar record_sep. Para especificar una nueva lnea
configure record_sep en chr(13)&chr(10).

Si se seleccionan todos menos uno o dos valores, se emplear el formato "NOT x,y" o "NOT y"
respectivamente. Si selecciona todos los valores y la cuenta de todos ellos es mayor que max_values, el
texto ALL se devolver.

Sintaxis:

GetCurrentSelections ([record_sep [,tag_sep [,value_sep [,max_values]]]])

Tipo de datos devueltos: cadena

Argumentos:

Argumentos Descripcin

record_sep Es el separador que se ha de colocar entre los registros de campo. La opcin predefinida
es <CR><LF> que implica o significa una nueva lnea.

tag_sep Es el separador que se ha de colocar entre la pestaa del nombre de campo y los valores
de campo. El valor predeterminado es ': '.

value_sep Es el separador que se ha de colocar entre valores de campo. Por defecto es ', '.

max_values Es el nmero mximo de valores de campo que se han de listar de manera individual.
Cuando se seleccione un nmero mayor de valores se utilizar el formato 'valores x de y'
en su lugar. El valor por defecto es 6.

Ejemplos y resultados:

En el ejemplo a continuacin se utilizan dos campos cargados en distintos paneles de filtrado, uno para el
nombre First name y otro para Initials.

Ejemplos Resultados

Teniendo en cuenta que John est seleccionado en First name. 'First name: John'

GetCurrentSelections ()

Puesto que John y Peter estn seleccionados en First name. 'First name: John,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 409


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados
GetCurrentSelections () Peter'

Puesto que John est seleccionado en First name y JA est seleccionado en 'First name: John;
Initials. Peter

GetCurrentSelections () Initials: JA'

Puesto que John est seleccionado en First name y JA est seleccionado en 'First name
Initials. =John

GetCurrentSelections ( chr(13)&chr(10) , ' = ' ) Initials=JA'

Puesto que hemos seleccionado todos los nombres excepto Sue en First name y no 'First
hay selecciones en Initials. name=NOTSue'

=GetCurrentSelections(chr(13)&chr(10),'=',',',3)

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"
John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

GetExcludedCount - funcin de grfico


GetExcludedCount() se utiliza para hallar el nmero de valores excluidos (gris oscuro) en el campo
identificado.

Sintaxis:

GetExcludedCount (field_name)

Tipo de datos devueltos: cadena

Limitaciones:

GetExcludedCount() solo se utiliza para campos con valores asociados, esto es, campos que no tienen
selecciones. Para campos con selecciones GetExcludedCount() devolver 0.

Argumentos:

Argumentos Descripcin

field_name El campo que contiene el rango de datos que se han de medir.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 410


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

En el ejemplo que se muestra a continuacin se utilizan dos campos cargados en distintos paneles de
filtrado, uno para el nombre First name y otro para Initials.

Ejemplos Resultados

Teniendo en cuenta que 5 puesto que hay 5 valores excluidos (en gris) en Initials. La sexta celda
John est seleccionado en (JA) estar en blanco puesto que est asociada con la seleccin John en
First name. First name.

GetExcludedCount
([Initials])

Puesto que John y Peter 3 puesto que Peter est asociado a 2 valores en Initials.
estn seleccionados.

GetExcludedCount
([Initials])

Puesto que ningn valor est 0 puesto que no hay selecciones.


seleccionado en First name.

GetExcludedCount
([Initials])

Teniendo en cuenta que 0 puesto que GetExcludedCount() slo se utiliza para campos con
John est seleccionado en valores asociados, esto es, campos que no tienen selecciones.
First name.

GetExcludedCount ([First
name])

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"
John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

GetFieldSelections - funcin de grfico


GetFieldSelections() devuelve una cadena con las selecciones actuales de un campo.

Si se seleccionan todos los valores menos uno, se emplear el formato "NOT x,y" o "NOT y"
respectivamente. Si selecciona todos los valores y la cuenta de todos ellos es mayor que max_values, el
texto ALL se devolver.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 411


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

GetFieldSelections ( field_name [, value_sep [, max_values]])

Tipo de datos devueltos: cadena

Argumentos:

Argumentos Descripcin

field_name El campo que contiene el rango de datos que se han de medir.

value_sep Es el separador que se ha de colocar entre valores de campo. Por defecto es ', '.

max_values Es el nmero mximo de valores de campo que se han de listar de manera individual.
Cuando se seleccione un nmero mayor de valores se utilizar el formato 'valores x de y'
en su lugar. El valor por defecto es 6.

Ejemplos y resultados:

En el ejemplo que se muestra a continuacin se utilizan dos campos cargados en distintos paneles de
filtrado, uno para el nombre First name y otro para Initials.

Ejemplos Resultados

Teniendo en cuenta que John est 'John'


seleccionado en First name.

GetFieldSelections ([First name])

Puesto que John y Peter estn 'John,Peter'


seleccionados.

GetFieldSelections ([First name])

Puesto que John y Peter estn 'John; Peter'


seleccionados.

GetFieldSelections ([First name],';


')

Teniendo en cuenta que John, Sue, 'NOTJane;Peter', ya que el valor 2 es el valor del argumento
Mark estn seleccionados en First max_values. De lo contrario, el resultado habra sido John; Sue;
name. Mark.

GetFieldSelections ([First
name],';',2)

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 412


5 Funciones en scripts y en expresiones de grfico

John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

GetNotSelectedCount - funcin de grfico


Esta funcin de grfico devuelve el nmero de valores no seleccionados en el campo fieldname. El campo
deber estar en modoAnd para que esta funcin sea aplicable.

Sintaxis:

GetNotSelectedCount(fieldname [, includeexcluded=false])

Argumentos:

Argumento Descripcin

fieldname El nombre del campo que se ha de evaluar.

includeexcluded Si includeexcluded se afirma como True, se contabilizarn los valores seleccionados


que hayan sido excluidos por las selecciones de otro campo.

Ejemplos:

GetNotSelectedCount( Country )
GetNotSelectedCount( Country, true )

GetPossibleCount - funcin de grfico


GetPossibleCount() se utiliza para hallar el nmero de valores posibles en el campo identificado. Si el
campo identificado incluye selecciones, los campos seleccionados (de color verde) se cuentan. De lo
contrario, se cuentan los valores asociados (de color blanco). .

Para campos con selecciones, GetPossibleCount() devuelve el nmero de campos (en verde)
seleccionados.

Tipo de datos devueltos: Entero

Sintaxis:

GetPossibleCount (field_name)

Argumentos:

Argumentos Descripcin

field_name El campo que contiene el rango de datos que se han de medir.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 413


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

En el ejemplo que se muestra a continuacin se utilizan dos campos cargados en distintos paneles de
filtrado, uno para el nombre First name y otro para Initials.

Ejemplos Resultados

Teniendo en cuenta que John est 1 puesto que hay 1 valor en Initials asociado con la
seleccionado en First name. seleccin, John, en First name.

GetPossibleCount ([Initials])

Teniendo en cuenta que John est 1 puesto que hay 1 seleccin, John, en First name.
seleccionado en First name.

GetPossibleCount ([First name])

Teniendo en cuenta que Peter est 2 puesto que Peter est asociado a 2 valores en Initials.
seleccionado en First name.

GetPossibleCount ([Initials])

Puesto que ningn valor est seleccionado 5 puesto que no hay selecciones y hay 5 valores nicos en
en First name. First name.

GetPossibleCount ([First name])

Puesto que ningn valor est seleccionado 6 puesto que no hay selecciones y hay 6 valores nicos en
en First name. Initials.

GetPossibleCount ([Initials])

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"
John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

GetSelectedCount - funcin de grfico


GetSelectedCount() halla el nmero de valores seleccionados (verde) en un campo.

Sintaxis:

GetSelectedCount (field_name [, include_excluded])

Tipo de datos devueltos: Entero

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 414


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumentos Descripcin

field_name El campo que contiene el rango de datos que se han de medir.

include_ Si se configura como True(), el contador incluir los valores seleccionados, los cuales
excluded estn actualmente excluidos por las selecciones en otros campos. Si es False o est
omitido, dichos valores no se incluirn.

Ejemplos y resultados:

En el ejemplo a continuacin se utilizan tres campos cargados en distintos paneles de filtrado, uno para el
nombre First name, otro para Initials y otro para Has cellphone.

Ejemplos Resultados

Teniendo en cuenta que John est 1 como un valor est seleccionado en First name.
seleccionado en First name.

GetSelectedCount ([First name])

Teniendo en cuenta que John est 0 como ningn valor est seleccionado en Initials.
seleccionado en First name.

GetSelectedCount ([Initials])

Si no realiza ninguna seleccin en . First 6. Aunque las selecciones con Initials MC y PD tienen
name, seleccione todos los valores en Has cellphone establecido en No, el resultado seguir
Initials y, a continuacin, seleccione el valor siendo 6, ya que el argumento include_excluded est
Yes en Has cellphone. establecido en True().

GetSelectedCount ([Initials])

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"
John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 415


5 Funciones en scripts y en expresiones de grfico

5.8 Funciones de archivo


Las funciones de archivo (solo disponibles en expresiones de script) devuelven informacin acerca del
archivo de tabla que se est leyendo en ese momento. Dichas funciones devolvern NULL para todas las
fuentes de datos excepto para los archivos de tabla (excepcin: ConnectString( )).

Visin global de las funciones de archivo


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Attribute
Esta funcin de script devuelve el valor de las meta etiquetas de diversos formatos de archivo como texto.
Estn disponibles los siguientes formatos de archivo: MP3, WMA, WMV, PNG y JPG. Si el archivo
filename no existe, no se admite como formato de archivo o no contiene una metaetiqueta con el nombre
attributename, se devuelve NULL.

Attribute (filename, attributename)

ConnectString
Esta funcin de script devuelve la cadena connect activa para conexiones ODBC u OLEDB. Devuelve una
cadena vaca si no se ha ejecutado ninguna sentencia connect, o tras una sentencia disconnect.

ConnectString ()

FileBaseName
Esta funcin de script devuelve una cadena que contiene el nombre del archivo de tabla que se est leyendo,
sin ruta ni extensin.

FileBaseName ()

FileDir
Esta funcin de script devuelve una cadena que contiene la ruta al directorio del archivo de tabla que se est
leyendo en ese momento.

FileDir ()

FileExtension
Esta funcin de script devuelve una cadena que contiene la extensin del archivo de tabla que se est
leyendo en ese momento.

FileExtension ()

FileName
Esta funcin de script devuelve una cadena que contiene el nombre del archivo de tabla que se est leyendo,
sin la ruta pero con la extensin.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 416


5 Funciones en scripts y en expresiones de grfico

FileName ()

FilePath
Esta funcin de script devuelve una cadena que contiene la ruta completa de acceso al archivo de tabla que
se est leyendo en ese momento.

FilePath ()

FileSize
Esta funcin de script devuelve un entero que contiene el tamao en bytes del archivo filename o, si no se
especifica filename alguno, del archivo de tabla que se est leyendo en ese momento.

FileSize ()

FileTime
Esta funcin de script devuelve una marca de tiempo con la fecha y hora de la ltima modificacin efectuada
en el archivo filename. Si no se especifica filename, la funcin se referir al archivo de tabla que se est
leyendo en ese momento.

FileTime ([ filename ])

GetFolderPath
Esta funcin de script devuelve el valor de la funcin SHGetFolderPath de Microsoft Windows y devuelve la
ruta. Por ejemplo: MyMusic. Observe que la funcin no utiliza los espacios que se ven en Windows
Explorer.

GetFolderPath ()

QvdCreateTime
Esta funcin de script devuelve la marca de tiempo de la cabecera XML desde un archivo QVD si lo hubiere
(si no, NULL).

QvdCreateTime (filename)

QvdFieldName
Esta funcin de script devuelve el nombre del campo nmero fieldno, si ste existe en un archivo QVD (si
no, devuelve NULL).

QvdFieldName (filename , fieldno)

QvdNoOfFields
Esta funcin de script devuelve el nmero de campos de un archivo QVD.

QvdNoOfFields (filename)

QvdNoOfRecords
Esta funcin de script devuelve el nmero de registros que se encuentran actualmente en un archivo QVD.

QvdNoOfRecords (filename)

QvdTableName

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 417


5 Funciones en scripts y en expresiones de grfico

Esta funcin de script devuelve el nombre de la tabla contenida en un archivo QVD.

QvdTableName (filename)

Attribute
Esta funcin de script devuelve el valor de las meta etiquetas de diversos formatos de archivo como texto.
Estn disponibles los siguientes formatos de archivo: MP3, WMA, WMV, PNG y JPG. Si el archivo
filename no existe, no se admite como formato de archivo o no contiene una metaetiqueta con el nombre
attributename, se devuelve NULL.

Sintaxis:

Attribute(filename, attributename)

Se puede utilizar un amplio nmero de meta etiquetas, por ej. Artista o Fecha de Foto.

Slo podemos leer meta etiquetas guardadas en el archivo conforme a la especificacin


relevante, por ejemplo ID2v3 para archivos MP3 o EXIF para archivos JPG, no meta
informacin guardada en el Explorador de archivos de Windows.

Argumentos:

Argumento Descripcin

filename El nombre de un archivo de medios con la ruta incluida, si fuera necesario, como una
conexin a datos de carpetas.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

attributename Es el nombre de una meta etiqueta.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 418


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do
// Script to read MP3 meta tags Script
for each vExt in 'mp3'
para leer
for each vFoundFile in filelist( GetFolderPath('MyMusic') & '\*.'& vExt )
todas las
FileList:
LOAD FileLongName, posibles
subfield(FileLongName,'\',-1) as FileShortName, meta
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize, etiqueta
FileTime(FileLongName) as FileTime, s MP3
// ID3v1.0 and ID3v1.1 tags
en la
Attribute(FileLongName, 'Title') as Title,
Attribute(FileLongName, 'Artist') as Artist, carpeta
Attribute(FileLongName, 'Album') as Album, MyMusi
Attribute(FileLongName, 'Year') as Year, c
Attribute(FileLongName, 'Comment') as Comment,
Attribute(FileLongName, 'Track') as Track,
Attribute(FileLongName, 'Genre') as Genre,
// ID3v2.3 tags
Attribute(FileLongName, 'AENC') as AENC, // Audio encryption
Attribute(FileLongName, 'APIC') as APIC, // Attached picture
Attribute(FileLongName, 'COMM') as COMM, // Comments
Attribute(FileLongName, 'COMR') as COMR, // Commercial frame
Attribute(FileLongName, 'ENCR') as ENCR, // Encryption method registration
Attribute(FileLongName, 'EQUA') as EQUA, // Equalization
Attribute(FileLongName, 'ETCO') as ETCO, // Event timing codes
Attribute(FileLongName, 'GEOB') as GEOB, // General encapsulated object
Attribute(FileLongName, 'GRID') as GRID, // Group identification registration
Attribute(FileLongName, 'IPLS') as IPLS, // Involved people list
Attribute(FileLongName, 'LINK') as LINK, // Linked information
Attribute(FileLongName, 'MCDI') as MCDI, // Music CD identifier
Attribute(FileLongName, 'MLLT') as MLLT, // MPEG location lookup table
Attribute(FileLongName, 'OWNE') as OWNE, // Ownership frame
Attribute(FileLongName, 'PRIV') as PRIV, // Private frame
Attribute(FileLongName, 'PCNT') as PCNT, // Play counter
Attribute(FileLongName, 'POPM') as POPM, // Popularimeter
Attribute(FileLongName, 'POSS') as POSS, // Position synchronisation frame
Attribute(FileLongName, 'RBUF') as RBUF, // Recommended buffer size
Attribute(FileLongName, 'RVAD') as RVAD, // Relative volume adjustment
Attribute(FileLongName, 'RVRB') as RVRB, // Reverb
Attribute(FileLongName, 'SYLT') as SYLT, // Synchronized lyric/text
Attribute(FileLongName, 'SYTC') as SYTC, // Synchronized tempo codes
Attribute(FileLongName, 'TALB') as TALB, // Album/Movie/Show title
Attribute(FileLongName, 'TBPM') as TBPM, // BPM (beats per minute)
Attribute(FileLongName, 'TCOM') as TCOM, // Composer
Attribute(FileLongName, 'TCON') as TCON, // Content type
Attribute(FileLongName, 'TCOP') as TCOP, // Copyright message
Attribute(FileLongName, 'TDAT') as TDAT, // Date
Attribute(FileLongName, 'TDLY') as TDLY, // Playlist delay

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 419


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do
Attribute(FileLongName, 'TENC') as TENC, // Encoded by
Attribute(FileLongName, 'TEXT') as TEXT, // Lyricist/Text writer
Attribute(FileLongName, 'TFLT') as TFLT, // File type
Attribute(FileLongName, 'TIME') as TIME, // Time
Attribute(FileLongName, 'TIT1') as TIT1, // Content group description
Attribute(FileLongName, 'TIT2') as TIT2, // Title/songname/content description
Attribute(FileLongName, 'TIT3') as TIT3, // Subtitle/Description refinement
Attribute(FileLongName, 'TKEY') as TKEY, // Initial key
Attribute(FileLongName, 'TLAN') as TLAN, // Language(s)
Attribute(FileLongName, 'TLEN') as TLEN, // Length
Attribute(FileLongName, 'TMED') as TMED, // Media type
Attribute(FileLongName, 'TOAL') as TOAL, // Original album/movie/show title
Attribute(FileLongName, 'TOFN') as TOFN, // Original filename
Attribute(FileLongName, 'TOLY') as TOLY, // Original lyricist(s)/text writer(s)
Attribute(FileLongName, 'TOPE') as TOPE, // Original artist(s)/performer(s)
Attribute(FileLongName, 'TORY') as TORY, // Original release year
Attribute(FileLongName, 'TOWN') as TOWN, // File owner/licensee
Attribute(FileLongName, 'TPE1') as TPE1, // Lead performer(s)/Soloist(s)
Attribute(FileLongName, 'TPE2') as TPE2, // Band/orchestra/accompaniment
Attribute(FileLongName, 'TPE3') as TPE3, // Conductor/performer refinement
Attribute(FileLongName, 'TPE4') as TPE4, // Interpreted, remixed, or otherwise
modified by
Attribute(FileLongName, 'TPOS') as TPOS, // Part of a set
Attribute(FileLongName, 'TPUB') as TPUB, // Publisher
Attribute(FileLongName, 'TRCK') as TRCK, // Track number/Position in set
Attribute(FileLongName, 'TRDA') as TRDA, // Recording dates
Attribute(FileLongName, 'TRSN') as TRSN, // Internet radio station name
Attribute(FileLongName, 'TRSO') as TRSO, // Internet radio station owner
Attribute(FileLongName, 'TSIZ') as TSIZ, // Size
Attribute(FileLongName, 'TSRC') as TSRC, // ISRC (international standard recording
code)
Attribute(FileLongName, 'TSSE') as TSSE, // Software/Hardware and settings used for
encoding
Attribute(FileLongName, 'TYER') as TYER, // Year
Attribute(FileLongName, 'TXXX') as TXXX, // User defined text information frame
Attribute(FileLongName, 'UFID') as UFID, // Unique file identifier
Attribute(FileLongName, 'USER') as USER, // Terms of use
Attribute(FileLongName, 'USLT') as USLT, // Unsychronized lyric/text transcription
Attribute(FileLongName, 'WCOM') as WCOM, // Commercial information
Attribute(FileLongName, 'WCOP') as WCOP, // Copyright/Legal information
Attribute(FileLongName, 'WOAF') as WOAF, // Official audio file webpage
Attribute(FileLongName, 'WOAR') as WOAR, // Official artist/performer webpage
Attribute(FileLongName, 'WOAS') as WOAS, // Official audio source webpage
Attribute(FileLongName, 'WORS') as WORS, // Official internet radio station
homepage
Attribute(FileLongName, 'WPAY') as WPAY, // Payment
Attribute(FileLongName, 'WPUB') as WPUB, // Publishers official webpage
Attribute(FileLongName, 'WXXX') as WXXX; // User defined URL link frame
LOAD @1:n as FileLongName Inline "$(vFoundFile)" (fix, no labels);
Next vFoundFile

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 420


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do

// Script to read Jpeg Exif meta tags Script


for each vExt in 'jpg', 'jpeg', 'jpe', 'jfif', 'jif', 'jfi'
para leer
for each vFoundFile in filelist( GetFolderPath('MyPictures') & '\*.'& vExt )
todas las
FileList:
LOAD FileLongName, posibles
subfield(FileLongName,'\',-1) as FileShortName, meta
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize, etiqueta
FileTime(FileLongName) as FileTime, s EXIF
// ************ Exif Main (IFD0) Attributes ************
de
Attribute(FileLongName, 'ImageWidth') as ImageWidth,
Attribute(FileLongName, 'ImageLength') as ImageLength, archivos
Attribute(FileLongName, 'BitsPerSample') as BitsPerSample, JPG en
Attribute(FileLongName, 'Compression') as Compression, la
// examples: 1=uncompressed, 2=CCITT, 3=CCITT 3, 4=CCITT 4, carpeta
//5=LZW, 6=JPEG (old style), 7=JPEG, 8=Deflate, 32773=PackBits RLE,
MyMusi
Attribute(FileLongName, 'PhotometricInterpretation') as PhotometricInterpretation,
// examples: 0=WhiteIsZero, 1=BlackIsZero, 2=RGB, 3=Palette, 5=CMYK, 6=YCbCr, c
Attribute(FileLongName, 'ImageDescription') as ImageDescription,
Attribute(FileLongName, 'Make') as Make,
Attribute(FileLongName, 'Model') as Model,
Attribute(FileLongName, 'StripOffsets') as StripOffsets,
Attribute(FileLongName, 'Orientation') as Orientation,
// examples: 1=TopLeft, 2=TopRight, 3=BottomRight, 4=BottomLeft,
// 5=LeftTop, 6=RightTop, 7=RightBottom, 8=LeftBottom,
Attribute(FileLongName, 'SamplesPerPixel') as SamplesPerPixel,
Attribute(FileLongName, 'RowsPerStrip') as RowsPerStrip,
Attribute(FileLongName, 'StripByteCounts') as StripByteCounts,
Attribute(FileLongName, 'XResolution') as XResolution,
Attribute(FileLongName, 'YResolution') as YResolution,
Attribute(FileLongName, 'PlanarConfiguration') as PlanarConfiguration,
// examples: 1=chunky format, 2=planar format,
Attribute(FileLongName, 'ResolutionUnit') as ResolutionUnit,
// examples: 1=none, 2=inches, 3=centimeters,
Attribute(FileLongName, 'TransferFunction') as TransferFunction,
Attribute(FileLongName, 'Software') as Software,
Attribute(FileLongName, 'DateTime') as DateTime,
Attribute(FileLongName, 'Artist') as Artist,
Attribute(FileLongName, 'HostComputer') as HostComputer,
Attribute(FileLongName, 'WhitePoint') as WhitePoint,
Attribute(FileLongName, 'PrimaryChromaticities') as PrimaryChromaticities,
Attribute(FileLongName, 'YCbCrCoefficients') as YCbCrCoefficients,
Attribute(FileLongName, 'YCbCrSubSampling') as YCbCrSubSampling,
Attribute(FileLongName, 'YCbCrPositioning') as YCbCrPositioning,
// examples: 1=centered, 2=co-sited,
Attribute(FileLongName, 'ReferenceBlackWhite') as ReferenceBlackWhite,
Attribute(FileLongName, 'Rating') as Rating,
Attribute(FileLongName, 'RatingPercent') as RatingPercent,
Attribute(FileLongName, 'ThumbnailFormat') as ThumbnailFormat,
// examples: 0=Raw Rgb, 1=Jpeg,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 421


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do
Attribute(FileLongName, 'Copyright') as Copyright,
Attribute(FileLongName, 'ExposureTime') as ExposureTime,
Attribute(FileLongName, 'FNumber') as FNumber,
Attribute(FileLongName, 'ExposureProgram') as ExposureProgram,
// examples: 0=Not defined, 1=Manual, 2=Normal program, 3=Aperture priority,
4=Shutter priority,
// 5=Creative program, 6=Action program, 7=Portrait mode, 8=Landscape mode, 9=Bulb,
Attribute(FileLongName, 'ISOSpeedRatings') as ISOSpeedRatings,
Attribute(FileLongName, 'TimeZoneOffset') as TimeZoneOffset,
Attribute(FileLongName, 'SensitivityType') as SensitivityType,
// examples: 0=Unknown, 1=Standard output sensitivity (SOS), 2=Recommended
exposure index (REI),
// 3=ISO speed, 4=Standard output sensitivity (SOS) and Recommended exposure index
(REI),
//5=Standard output sensitivity (SOS) and ISO Speed, 6=Recommended exposure index
(REI) and ISO Speed,
// 7=Standard output sensitivity (SOS) and Recommended exposure index (REI) and ISO
speed,
Attribute(FileLongName, 'ExifVersion') as ExifVersion,
Attribute(FileLongName, 'DateTimeOriginal') as DateTimeOriginal,
Attribute(FileLongName, 'DateTimeDigitized') as DateTimeDigitized,
Attribute(FileLongName, 'ComponentsConfiguration') as ComponentsConfiguration,
// examples: 1=Y, 2=Cb, 3=Cr, 4=R, 5=G, 6=B,
Attribute(FileLongName, 'CompressedBitsPerPixel') as CompressedBitsPerPixel,
Attribute(FileLongName, 'ShutterSpeedValue') as ShutterSpeedValue,
Attribute(FileLongName, 'ApertureValue') as ApertureValue,
Attribute(FileLongName, 'BrightnessValue') as BrightnessValue, // examples: -
1=Unknown,
Attribute(FileLongName, 'ExposureBiasValue') as ExposureBiasValue,
Attribute(FileLongName, 'MaxApertureValue') as MaxApertureValue,
Attribute(FileLongName, 'SubjectDistance') as SubjectDistance,
// examples: 0=Unknown, -1=Infinity,
Attribute(FileLongName, 'MeteringMode') as MeteringMode,
// examples: 0=Unknown, 1=Average, 2=CenterWeightedAverage, 3=Spot,
// 4=MultiSpot, 5=Pattern, 6=Partial, 255=Other,
Attribute(FileLongName, 'LightSource') as LightSource,
// examples: 0=Unknown, 1=Daylight, 2=Fluorescent, 3=Tungsten, 4=Flash, 9=Fine
weather,
// 10=Cloudy weather, 11=Shade, 12=Daylight fluorescent,
// 13=Day white fluorescent, 14=Cool white fluorescent,
// 15=White fluorescent, 17=Standard light A, 18=Standard light B, 19=Standard
light C,
// 20=D55, 21=D65, 22=D75, 23=D50, 24=ISO studio tungsten, 255=other light source,
Attribute(FileLongName, 'Flash') as Flash,
Attribute(FileLongName, 'FocalLength') as FocalLength,
Attribute(FileLongName, 'SubjectArea') as SubjectArea,
Attribute(FileLongName, 'MakerNote') as MakerNote,
Attribute(FileLongName, 'UserComment') as UserComment,
Attribute(FileLongName, 'SubSecTime') as SubSecTime,
Attribute(FileLongName, 'SubsecTimeOriginal') as SubsecTimeOriginal,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 422


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do
Attribute(FileLongName, 'SubsecTimeDigitized') as SubsecTimeDigitized,
Attribute(FileLongName, 'XPTitle') as XPTitle,
Attribute(FileLongName, 'XPComment') as XPComment,
Attribute(FileLongName, 'XPAuthor') as XPAuthor,
Attribute(FileLongName, 'XPKeywords') as XPKeywords,
Attribute(FileLongName, 'XPSubject') as XPSubject,
Attribute(FileLongName, 'FlashpixVersion') as FlashpixVersion,
Attribute(FileLongName, 'ColorSpace') as ColorSpace, // examples: 1=sRGB,
65535=Uncalibrated,
Attribute(FileLongName, 'PixelXDimension') as PixelXDimension,
Attribute(FileLongName, 'PixelYDimension') as PixelYDimension,
Attribute(FileLongName, 'RelatedSoundFile') as RelatedSoundFile,
Attribute(FileLongName, 'FocalPlaneXResolution') as FocalPlaneXResolution,
Attribute(FileLongName, 'FocalPlaneYResolution') as FocalPlaneYResolution,
Attribute(FileLongName, 'FocalPlaneResolutionUnit') as FocalPlaneResolutionUnit,
// examples: 1=None, 2=Inch, 3=Centimeter,
Attribute(FileLongName, 'ExposureIndex') as ExposureIndex,
Attribute(FileLongName, 'SensingMethod') as SensingMethod,
// examples: 1=Not defined, 2=One-chip color area sensor, 3=Two-chip color area
sensor,
// 4=Three-chip color area sensor, 5=Color sequential area sensor,
// 7=Trilinear sensor, 8=Color sequential linear sensor,
Attribute(FileLongName, 'FileSource') as FileSource,
// examples: 0=Other, 1=Scanner of transparent type,
// 2=Scanner of reflex type, 3=Digital still camera,
Attribute(FileLongName, 'SceneType') as SceneType,
// examples: 1=A directly photographed image,
Attribute(FileLongName, 'CFAPattern') as CFAPattern,
Attribute(FileLongName, 'CustomRendered') as CustomRendered,
// examples: 0=Normal process, 1=Custom process,
Attribute(FileLongName, 'ExposureMode') as ExposureMode,
// examples: 0=Auto exposure, 1=Manual exposure, 2=Auto bracket,
Attribute(FileLongName, 'WhiteBalance') as WhiteBalance,
// examples: 0=Auto white balance, 1=Manual white balance,
Attribute(FileLongName, 'DigitalZoomRatio') as DigitalZoomRatio,
Attribute(FileLongName, 'FocalLengthIn35mmFilm') as FocalLengthIn35mmFilm,
Attribute(FileLongName, 'SceneCaptureType') as SceneCaptureType,
// examples: 0=Standard, 1=Landscape, 2=Portrait, 3=Night scene,
Attribute(FileLongName, 'GainControl') as GainControl,
// examples: 0=None, 1=Low gain up, 2=High gain up, 3=Low gain down, 4=High gain
down,
Attribute(FileLongName, 'Contrast') as Contrast,
// examples: 0=Normal, 1=Soft, 2=Hard,
Attribute(FileLongName, 'Saturation') as Saturation,
// examples: 0=Normal, 1=Low saturation, 2=High saturation,
Attribute(FileLongName, 'Sharpness') as Sharpness,
// examples: 0=Normal, 1=Soft, 2=Hard,
Attribute(FileLongName, 'SubjectDistanceRange') as SubjectDistanceRange,
// examples: 0=Unknown, 1=Macro, 2=Close view, 3=Distant view,
Attribute(FileLongName, 'ImageUniqueID') as ImageUniqueID,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 423


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do
Attribute(FileLongName, 'BodySerialNumber') as BodySerialNumber,
Attribute(FileLongName, 'CMNT_GAMMA') as CMNT_GAMMA,
Attribute(FileLongName, 'PrintImageMatching') as PrintImageMatching,
Attribute(FileLongName, 'OffsetSchema') as OffsetSchema,
// ************ Interoperability Attributes ************
Attribute(FileLongName, 'InteroperabilityIndex') as InteroperabilityIndex,
Attribute(FileLongName, 'InteroperabilityVersion') as InteroperabilityVersion,
Attribute(FileLongName, 'InteroperabilityRelatedImageFileFormat') as
InteroperabilityRelatedImageFileFormat,
Attribute(FileLongName, 'InteroperabilityRelatedImageWidth') as
InteroperabilityRelatedImageWidth,
Attribute(FileLongName, 'InteroperabilityRelatedImageLength') as
InteroperabilityRelatedImageLength,
Attribute(FileLongName, 'InteroperabilityColorSpace') as
InteroperabilityColorSpace,
// examples: 1=sRGB, 65535=Uncalibrated,
Attribute(FileLongName, 'InteroperabilityPrintImageMatching') as
InteroperabilityPrintImageMatching,
// ************ GPS Attributes ************
Attribute(FileLongName, 'GPSVersionID') as GPSVersionID,
Attribute(FileLongName, 'GPSLatitudeRef') as GPSLatitudeRef,
Attribute(FileLongName, 'GPSLatitude') as GPSLatitude,
Attribute(FileLongName, 'GPSLongitudeRef') as GPSLongitudeRef,
Attribute(FileLongName, 'GPSLongitude') as GPSLongitude,
Attribute(FileLongName, 'GPSAltitudeRef') as GPSAltitudeRef,
// examples: 0=Above sea level, 1=Below sea level,
Attribute(FileLongName, 'GPSAltitude') as GPSAltitude,
Attribute(FileLongName, 'GPSTimeStamp') as GPSTimeStamp,
Attribute(FileLongName, 'GPSSatellites') as GPSSatellites,
Attribute(FileLongName, 'GPSStatus') as GPSStatus,
Attribute(FileLongName, 'GPSMeasureMode') as GPSMeasureMode,
Attribute(FileLongName, 'GPSDOP') as GPSDOP,
Attribute(FileLongName, 'GPSSpeedRef') as GPSSpeedRef,
Attribute(FileLongName, 'GPSSpeed') as GPSSpeed,
Attribute(FileLongName, 'GPSTrackRef') as GPSTrackRef,
Attribute(FileLongName, 'GPSTrack') as GPSTrack,
Attribute(FileLongName, 'GPSImgDirectionRef') as GPSImgDirectionRef,
Attribute(FileLongName, 'GPSImgDirection') as GPSImgDirection,
Attribute(FileLongName, 'GPSMapDatum') as GPSMapDatum,
Attribute(FileLongName, 'GPSDestLatitudeRef') as GPSDestLatitudeRef,
Attribute(FileLongName, 'GPSDestLatitude') as GPSDestLatitude,
Attribute(FileLongName, 'GPSDestLongitudeRef') as GPSDestLongitudeRef,
Attribute(FileLongName, 'GPSDestLongitude') as GPSDestLongitude,
Attribute(FileLongName, 'GPSDestBearingRef') as GPSDestBearingRef,
Attribute(FileLongName, 'GPSDestBearing') as GPSDestBearing,
Attribute(FileLongName, 'GPSDestDistanceRef') as GPSDestDistanceRef,
Attribute(FileLongName, 'GPSDestDistance') as GPSDestDistance,
Attribute(FileLongName, 'GPSProcessingMethod') as GPSProcessingMethod,
Attribute(FileLongName, 'GPSAreaInformation') as GPSAreaInformation,
Attribute(FileLongName, 'GPSDateStamp') as GPSDateStamp,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 424


5 Funciones en scripts y en expresiones de grfico

Resulta
Ejemplo
do
Attribute(FileLongName, 'GPSDifferential') as GPSDifferential;
// examples: 0=No correction, 1=Differential correction,
LOAD @1:n as FileLongName Inline "$(vFoundFile)" (fix, no labels);
Next vFoundFile
Next vExt

/ Script to read WMA/WMV ASF meta tags Script


for each vExt in 'asf', 'wma', 'wmv'
para leer
for each vFoundFile in filelist( GetFolderPath('MyMusic') & '\*.'& vExt )
todas las
FileList:
LOAD FileLongName, posibles
subfield(FileLongName,'\',-1) as FileShortName, meta
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize, etiqueta
FileTime(FileLongName) as FileTime, s
Attribute(FileLongName, 'Title') as Title,
WMA/W
Attribute(FileLongName, 'Author') as Author,
Attribute(FileLongName, 'Copyright') as Copyright, MV ASF
Attribute(FileLongName, 'Description') as Description, en la
Attribute(FileLongName, 'Rating') as Rating, carpeta
Attribute(FileLongName, 'PlayDuration') as PlayDuration, MyMusi
Attribute(FileLongName, 'MaximumBitrate') as MaximumBitrate,
c
Attribute(FileLongName, 'WMFSDKVersion') as WMFSDKVersion,
Attribute(FileLongName, 'WMFSDKNeeded') as WMFSDKNeeded,
Attribute(FileLongName, 'IsVBR') as IsVBR,
Attribute(FileLongName, 'ASFLeakyBucketPairs') as ASFLeakyBucketPairs,
Attribute(FileLongName, 'PeakValue') as PeakValue,
Attribute(FileLongName, 'AverageLevel') as AverageLevel;
LOAD @1:n as FileLongName Inline "$(vFoundFile)" (fix, no labels);
Next vFoundFile
Next vExt

// Script to read PNG meta tags Script


for each vExt in 'png'
para leer
for each vFoundFile in filelist( GetFolderPath('MyPictures') & '\*.'& vExt )
todas las
FileList:
LOAD FileLongName, posibles
subfield(FileLongName,'\',-1) as FileShortName, meta
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize, etiqueta
FileTime(FileLongName) as FileTime, s PNG
Attribute(FileLongName, 'Comment') as Comment,
en la
Attribute(FileLongName, 'Creation Time') as Creation_Time,
Attribute(FileLongName, 'Source') as Source, carpeta
Attribute(FileLongName, 'Title') as Title, MyPictu
Attribute(FileLongName, 'Software') as Software, res
Attribute(FileLongName, 'Author') as Author,
Attribute(FileLongName, 'Description') as Description,
Attribute(FileLongName, 'Copyright') as Copyright;
LOAD @1:n as FileLongName Inline "$(vFoundFile)" (fix, no labels);
Next vFoundFile
Next vExt

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 425


5 Funciones en scripts y en expresiones de grfico

ConnectString
Esta funcin de script devuelve la cadena connect activa para conexiones ODBC u OLEDB. Devuelve una
cadena vaca si no se ha ejecutado ninguna sentencia connect, o tras una sentencia disconnect.

Sintaxis:

ConnectString()

Esta funcin admite slo conexiones de datos de carpetas en modo estndar.

FileBaseName
Esta funcin de script devuelve una cadena que contiene el nombre del archivo de tabla que se est leyendo,
sin ruta ni extensin.

Sintaxis:

FileBaseName()

Ejemplos y resultados:

Ejemplo Resultado
LOAD *, filebasename( ) as X from Devolver "abc" en el campo X para cada registro ledo.
C:\UserFiles\abc.txt

FileDir
Esta funcin de script devuelve una cadena que contiene la ruta al directorio del archivo de tabla que se est
leyendo en ese momento.

Sintaxis:

FileDir()

Esta funcin admite slo conexiones de datos de carpetas en modo estndar.

Ejemplos y resultados:

Ejemplo Resultado
Load *, filedir( ) as X from Devolver "C:\UserFiles" en el campo X para cada registro ledo.
C:\UserFiles\abc.txt

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 426


5 Funciones en scripts y en expresiones de grfico

FileExtension
Esta funcin de script devuelve una cadena que contiene la extensin del archivo de tabla que se est
leyendo en ese momento.

Sintaxis:

FileExtension()

Ejemplos y resultados:

Ejemplo Resultado
LOAD *, FileExtension( ) as X from Devolver "txt" en el campo X para cada registro ledo.
C:\UserFiles\abc.txt

FileName
Esta funcin de script devuelve una cadena que contiene el nombre del archivo de tabla que se est leyendo,
sin la ruta pero con la extensin.

Sintaxis:

FileName()

Ejemplos y resultados:

Ejemplo Resultado
LOAD *, FileName( ) as X from Devolver 'abc.txt' en el campo X de cada registro ledo.
C:\UserFiles\abc.txt

FilePath
Esta funcin de script devuelve una cadena que contiene la ruta completa de acceso al archivo de tabla que
se est leyendo en ese momento.

Sintaxis:

FilePath()

Esta funcin admite slo conexiones de datos de carpetas en modo estndar.

Ejemplos y resultados:

Ejemplo Resultado
Load *, FilePath( ) as X from Devuelve 'C:\UserFiles\abc.txt' en el campo X de cada registro ledo.
C:\UserFiles\abc.txt

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 427


5 Funciones en scripts y en expresiones de grfico

FileSize
Esta funcin de script devuelve un entero que contiene el tamao en bytes del archivo filename o, si no se
especifica filename alguno, del archivo de tabla que se est leyendo en ese momento.

Sintaxis:

FileSize([filename])

Argumentos:

Argumento Descripcin

filename El nombre de un archivo, si es necesario incluyendo la ruta, como una carpeta o una
conexin de datos de archivos web.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet.

Ejemplo: http://www.qlik.com

Ejemplos y resultados:

Ejemplo Resultado
LOAD *, FileSize( ) as X Devolver el tamao del archivo especificado (abc.txt) como un entero en
from abc.txt;
el campo X de cada registro ledo.
FileSize( Devolver el tamao del archivo xyz.xls.
'lib://MyData/xyz.xls' )

FileTime
Esta funcin de script devuelve una marca de tiempo con la fecha y hora de la ltima modificacin efectuada
en el archivo filename. Si no se especifica filename, la funcin se referir al archivo de tabla que se est
leyendo en ese momento.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 428


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

FileTime([ filename ])

Argumentos:

Argumento Descripcin

filename El nombre de un archivo, si es necesario incluyendo la ruta, como una carpeta o una
conexin de datos de archivos web.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet.

Ejemplo: http://www.qlik.com

Ejemplos y resultados:

Ejemplo Resultado
LOAD *, FileTime( ) Devolver la fecha y hora de la ltima modificacin del archivo (abc.txt), como
as X from abc.txt;
una marca de tiempo en el campo X de cada registro ledo.

FileTime('xyz.xls' ) Devolver una marca de tiempo de la ltima modificacin efectuada en el


archivo xyz.xls.

GetFolderPath
Esta funcin de script devuelve el valor de la funcin SHGetFolderPath de Microsoft Windows y devuelve la
ruta. Por ejemplo: MyMusic. Observe que la funcin no utiliza los espacios que se ven en Windows
Explorer.

Esta funcin no es posible en modo estndar.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 429


5 Funciones en scripts y en expresiones de grfico

GetFolderPath()

Ejemplos:

GetFolderPath('MyMusic')
GetFolderPath('MyPictures')
GetFolderPath('MyVideos')
GetFolderPath('MyReceivedFiles')
GetFolderPath('MyShapes')
GetFolderPath('ProgramFiles')
GetFolderPath('Windows')

QvdCreateTime
Esta funcin de script devuelve la marca de tiempo de la cabecera XML desde un archivo QVD si lo hubiere
(si no, NULL).

Sintaxis:

QvdCreateTime(filename)

Argumentos:

Argumento Descripcin

filename El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l Absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet.

Ejemplo: http://www.qlik.com

Ejemplo:

QvdCreateTime('MyFile.qvd')
QvdCreateTime('C:\MyDir\MyFile.qvd')

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 430


5 Funciones en scripts y en expresiones de grfico

QvdFieldName
Esta funcin de script devuelve el nombre del campo nmero fieldno, si ste existe en un archivo QVD (si
no, devuelve NULL).

Sintaxis:

QvdFieldName(filename , fieldno)

Argumentos:

Argumento Descripcin

filename El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l Absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet

Ejemplo: http://www.qlik.com

fieldno Es el nmero del archivo (con base 0) dentro de la tabla contenida en el archivo QVD.

Ejemplos:

QvdFieldName ('MyFile.qvd', 3)
QvdFieldName ('C:\MyDir\MyFile.qvd', 5)

QvdNoOfFields
Esta funcin de script devuelve el nmero de campos de un archivo QVD.

Sintaxis:

QvdNoOfFields(filename)

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 431


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

filename El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l Absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet

Ejemplo: http://www.qlik.com

Ejemplos:

QvdNoOfFields ('MyFile.qvd')
QvdNoOfFields ('C:\MyDir\MyFile.qvd')

QvdNoOfRecords
Esta funcin de script devuelve el nmero de registros que se encuentran actualmente en un archivo QVD.

Sintaxis:

QvdNoOfRecords(filename)

Argumentos:

Argumento Descripcin

filename El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l Absoluta

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 432


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet

Ejemplo: http://www.qlik.com

Ejemplos:

QvdNoOfRecords ('MyFile.qvd')
QvdNoOfRecords ('C:\MyDir\MyFile.qvd')

QvdTableName
Esta funcin de script devuelve el nombre de la tabla contenida en un archivo QVD.

Sintaxis:

QvdTableName(filename)

Argumentos:

Argumento Descripcin

filename El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.

Ejemplo: 'lib://Table Files/'

En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes


formatos de ruta:

l Absoluta

Ejemplo: c:\data\

l relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\

l direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet

Ejemplo: http://www.qlik.com

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 433


5 Funciones en scripts y en expresiones de grfico

Ejemplos:

QvdTableName ('MyFile.qvd')
QvdTableName ('C:\MyDir\MyFile.qvd')

5.9 Funciones financieras


Las funciones financieras pueden utilizarse en el script de carga de datos y en las expresiones de grficos
para calcular pagos y tipos de inters.
Para todos los argumentos, el dinero que se abona se representa mediante nmeros negativos. El dinero
que se recibe se representa en nmeros positivos.
Estos son los argumentos que se utilizan en las funciones financieras (a excepcin de los que comienzan por
range-).

Para todas las funciones financieras es vital que sea consistente cuando especifique unidades
para rate y nper. Si se realizan pagos mensuales en un prstamo a cinco aos con un 6% de
inters anual, utilice 0,005 (6%/12) para el rate y 60 (5*12) para nper. Si se realizan pagos
anuales en el mismo prstamo, utilice 6% para rate y 5 para nper.

Visin global de las funciones financieras


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

FV
Esta funcin devuelve el valor futuro de una inversin basada en pagos peridicos y constantes y a un
porcentaje de inters constante. El resultado tiene un formato numrico predeterminado en money.

FV (rate, nper, pmt [ ,pv [ , type ] ])

nPer
Esta funcin devuelve el nmero de periodos para una inversin basada en pagos peridicos y constantes y a
un tipo de inters constante.

nPer (rate, pmt, pv [ ,fv [ , type ] ])

Pmt
Esta funcin devuelve el pago de un prstamo basado en pagos peridicos y constantes y a un tipo
constante de inters. El resultado tiene un formato numrico predeterminado en money.

Pmt (rate, nper, pv [ ,fv [ , type ] ] )

PV
Esta funcin devuelve el valor actual de una inversin. El resultado tiene un formato numrico
predeterminado en money.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 434


5 Funciones en scripts y en expresiones de grfico

PV (rate, nper, pmt [ ,fv [ , type ] ])

Rate
Esta funcin devuelve el tipo de inters por periodo en una anualidad. El resultado tiene un formato de
nmero Fix con dos decimales y %.

Rate (nper, pmt , pv [ ,fv [ , type ] ])

Black and Scholes


El modelo Black and Scholes es un modelo matemtico para instrumentos derivados de mercados
financieros. La formula calcula el valor hipottico (terico) de una opcin. En Qlik Sense, la funcin
BlackAndSchole devuelve el valor de acuerdo con la frmula Black and Scholes no modificada (opciones
de estilo europeo).

BlackAndSchole(strike , time_left , underlying_price , vol , risk_free_rate


, type)
Strike es el precio futuro de compra del stock.

Time_left es el nmero de periodos de tiempo restantes.

Underlying_ es el valor actual del stock.


price

Vol es la volatilidad en % por periodo de tiempo.

Risk_free_ es el tanto por ciento de inters de riesgo en % por periodo de tiempo.


rate

Type es 'c', 'call' o cualquier valor numrico distinto de cero para opciones de llamada y 'p', 'put'
o 0 para opciones put.

Ejemplo:

BlackAndSchole(130, 4, 68.5, 0.4, 0.04, 'call')


devuelve 11,245...

(Este es el precio hipottico de una opcin de compra en 4 aos a un valor de 130 por accin el cual es hoy
68.5 asumiendo la volatilidad de 40% por ao y un tanto por ciento de inters de riesgo del 4%)

FV
Esta funcin devuelve el valor futuro de una inversin basada en pagos peridicos y constantes y a un
porcentaje de inters constante. El resultado tiene un formato numrico predeterminado en money.

Sintaxis:

FV(rate, nper, pmt [ ,pv [ , type ] ])

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 435


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

rate Es el tipo de inters por periodo.

nper Es el nmero total de pagos en un periodo anual.

pmt Es el pago efectuado en cada periodo. No puede cambiar durante la validez de un periodo
anual. Si se omite pmt, debe incluirse el argumento pv.

pv Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.

fv Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.

type Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.

Ejemplos y resultados:

Ejemplo Resultado

Est pagando un nuevo grabador de vdeo a 36 cuotas mensuales de 20 $. El tipo de Devuelve


inters es del 6% anual. La letra llega al final de cada mes. Cul es el valor total del dinero $786.72
invertido despus de haber pagado la ltima factura?

FV(0.005,36,-20)

nPer
Esta funcin devuelve el nmero de periodos para una inversin basada en pagos peridicos y constantes y a
un tipo de inters constante.

Sintaxis:

nPer(rate, pmt, pv [ ,fv [ , type ] ])

Argumentos:

Argumento Descripcin

rate Es el tipo de inters por periodo.

nper Es el nmero total de pagos en un periodo anual.

pmt Es el pago efectuado en cada periodo. No puede cambiar durante la validez de un periodo
anual. Si se omite pmt, debe incluirse el argumento pv.

pv Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.

fv Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 436


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

type Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.

Ejemplos y resultados:

Ejemplo Resultado

Desea vender un grabador de vdeo con cuotas mensuales de 20 $. El tipo de inters es del Devuelve
6% anual. La letra llega al final de cada mes. Cuntos periodos hacen falta si el valor del 36
dinero que ha recibido tras cobrar la ltima letra debera ser igual a 786.72 $?

nPer(0.005,-20,0,800)

Pmt
Esta funcin devuelve el pago de un prstamo basado en pagos peridicos y constantes y a un tipo
constante de inters. El resultado tiene un formato numrico predeterminado en money.

Pmt(rate, nper, pv [ ,fv [ , type ] ] )

Para hallar la cantidad total desembolsada a lo largo de la duracin del prstamo, multiplique el valor pmt
devuelto por nper.

Argumentos:

Argumento Descripcin

rate Es el tipo de inters por periodo.

nper Es el nmero total de pagos en un periodo anual.

pmt Es el pago efectuado en cada periodo. No puede cambiar durante la validez de un periodo
anual. Si se omite pmt, debe incluirse el argumento pv.

pv Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.

fv Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.

type Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.

Ejemplos y resultados:

Ejemplo Resultado

La frmula siguiente devuelve el pago mensual de un prstamo de 20.000 $en un Devuelve -

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 437


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

porcentaje anual del 10 por ciento, que debe liquidarse en 8 meses: $2,594.66

Pmt(0.1/12,8,20000)

Para el mismo prstamo, si el pago pertenece al comienzo del primer periodo, el pago es: Devuelve -
$2,573.21
Pmt(0.1/12,8,20000,0,1)

PV
Esta funcin devuelve el valor actual de una inversin. El resultado tiene un formato numrico
predeterminado en money.

PV(rate, nper, pmt [ ,fv [ , type ] ])

El valor actual es la cantidad total que una serie de pagos futuros vale en el momento presente. Por ejemplo,
cuando usted presta dinero, el prstamo total es el valor actual del prestamista.

Argumentos:

Argumento Descripcin

rate Es el tipo de inters por periodo.

nper Es el nmero total de pagos en un periodo anual.

pmt Es el pago efectuado en cada periodo. No puede cambiar durante la validez de un periodo
anual. Si se omite pmt, debe incluirse el argumento pv.

pv Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.

fv Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.

type Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.

Ejemplos y resultados:

Ejemplo Resultado

Cul es el valor actual de un pago de $100 percibido por usted al final de cada mes Devuelve -
durante un periodo de 5 aos, efectuado a un inters del 7%? $5,050.20

PV(0.07/12,12*5,100,0,0)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 438


5 Funciones en scripts y en expresiones de grfico

Rate
Esta funcin devuelve el tipo de inters por periodo en una anualidad. El resultado tiene un formato de
nmero Fix con dos decimales y %.

Sintaxis:

Rate(nper, pmt , pv [ ,fv [ , type ] ])

La tasa o rate se calcula por iteracin y puede tener cero o ms soluciones. Si los resultados sucesivos de
rate no coinciden, se devolver un valor NULL.

Argumentos:

Argumento Descripcin

rate Es el tipo de inters por periodo.

nper Es el nmero total de pagos en un periodo anual.

pmt Es el pago efectuado en cada periodo. No puede cambiar durante la validez de un periodo
anual. Si se omite pmt, debe incluirse el argumento pv.

pv Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.

fv Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.

type Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.

Ejemplos y resultados:

Ejemplo Resultado

Cul es el tipo de inters de un prstamo anual de 10.000 $a cinco aos, con pagos Devuelve
mensuales de 300 $? 2.18%

Rate(60,-300,10000)

5.10 Funciones de formato


Las funciones de formato determinan el formato de visualizacin de los campos o expresiones. Con estas
funciones es posible fijar un separador decimal, un separador de miles, etc. Las funciones pueden utilizarse
tanto en scripts de carga de datos como en expresiones de grficos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 439


5 Funciones en scripts y en expresiones de grfico

Por razones de claridad todas las representaciones numricas se dan con un punto decimal
como separador decimal.

Descripcin general de las funciones de formato


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Date
La funcin date da formato de fecha a la expresin conforme a la cadena suministrada como format-code.

Date (expression [ , format-code ])

Dual
Con la funcin dual es posible crear combinaciones arbitrarias de un nmero y una cadena.

Dual ( s , x )

Interval
Esta funcin de script da formato a expression como un intervalo de tiempo conforme a la cadena
suministrada como format-code. Si el cdigo de formato se omite, se utilizar el formato de hora
establecido en el sistema operativo.

Interval (expression [ , format-code ])

Money
La funcin money da formato numrico a la expresin expression conforme a la cadena suministrada como
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si los parmetros 2-4 se omiten, se usar el formato numrico establecido en el sistema
operativo.

Money (expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])

Num
Esta funcin de script da formato numrico a la expresin expression, conforme a la cadena suministrada
como format-code. El separador de decimales y el separador de miles puede establecerse como tercer y
cuarto parmetro. Si los parmetros 2-4 se omiten, se usa el nmero de formato que est establecido en el
sistema operativo.

Num (expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ] )

Time
La funcin time da formato a la expresin como una hora conforme a la cadena suministrada como format-
code. Si format-code se omite, se utilizar el formato de hora establecido en la configuracin del sistema
operativo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 440


5 Funciones en scripts y en expresiones de grfico

Time (expression [ , format-code ])

Timestamp
Esta funcin da formato a la expression como una fecha-hora de acuerdo con la cadena suministrada como
format-code. Si se omite el cdigo de formato, se usa el formato de fecha-hora establecido en el sistema
operativo.

Timestamp (expression [ , format-code ])

Date
La funcin date da formato de fecha a la expresin conforme a la cadena suministrada como format-code.

Sintaxis:

Date(expression [ , format-code ])

Otra forma de describirla es verla como una conversin de nmero a cadena. La funcin toma el valor
numrico de la expresin y genera una cadena que representa la fecha conforme al cdigo de formato. La
funcin devuelve un valor dual con ambos, la cadena y el nmero.

Argumentos:

Argumento Descripcin

format-code La cadena que describe el formato de la cadena resultante. Si el cdigo de formato se


omite, se emplea el formato de fecha establecido por el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de Fecha YY-MM-DD M/D/YY

Ejemplo Resultados Configuracin 1 Configuracin 2

Date( A ) donde A=35648 Cadena: 97-08-06 8/6/97

Nmero: 35648 35648

Date( A, 'YY.MM.DD' ) donde A=35648 Cadena: 97-08-06 8/6/97

Nmero: 35648 35648

Date( A, 'DD.MM.YY' ) donde A=35648.375 Cadena: 06.08.1997 06.08.1997

Nmero: 35648.375 35648.375

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 441


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultados Configuracin 1 Configuracin 2

Date( A, 'YY.MM.DD' ) donde A=8/6/97 Cadena: NULL (nada) 97.08.06

Nmero: NULL 35648

Dual
Con la funcin dual es posible crear combinaciones arbitrarias de un nmero y una cadena.

Sintaxis:

Dual( s , x )

Asociacin forzada de una representacin de cualquier cadena s con un nmero de representacin fijado en
x.

En Qlik Sense, todos los valores de campo son potencialmente valores duales. Esto significa que los valores
de campo pueden tener un valor tanto numrico como de texto. Un ejemplo lo constituira una fecha, que
podra tener un valor numrico de 40908 y la representacin textual 2011-12-31.

Cuando varios elementos de datos en un slo campo tienen una diferente representacin de cadena, pero el
mismo nmero vlido de representacin, compartirn todos la primera representacin de cadena que se
encuentre.

La funcin dual se utiliza habitualmente al principio del script, antes de que otros datos se lean
en el interior del campo al que afecta, para crear esa representacin de primera cadena, la cual
se mostrar en paneles de filtro.

Ejemplos y resultados:

Ejemplo Descripcin

Dual('Q' & Ceil(Month Esta definicin de campo crear un campo Quarter con los valores textuales
(Date)/3), Ceil(Month 'Q1' a 'Q4' y asignar al mismo tiempo los valores numricos 1 a 4.
(Date)/3)) as Quarter

Dual(WeekYear(Date) & Esta definicin de campo crear un campo YearWeek con valores de texto en
'-W' & Week(Date), el formato '2012-W22' asignar al mismo tiempo un valor numrico
WeekStart(Date)) as correspondiente al nmero de fecha del primer da de la semana, por ej.
YearWeek 41057.

Interval
Esta funcin de script da formato a expression como un intervalo de tiempo conforme a la cadena
suministrada como format-code. Si el cdigo de formato se omite, se utilizar el formato de hora
establecido en el sistema operativo.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 442


5 Funciones en scripts y en expresiones de grfico

Interval(expression [ , format-code ])

Los intervalos se pueden formatear como hora, das, o como una combinacin de das, horas, minutos,
segundos y fracciones de segundos.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:

Formato de fecha corta: YY-MM-DD

Formato de hora: hh:mm:ss

Separador de decimales: .

Ejemplo Cadena Nmero

Interval( A ) donde A=0,37 9:00:00 0,375

Interval( A ) donde A=1,375 33:00:00 1,375

Interval( A, 'D hh:mm' ) donde A=1,375 1 09:00 1,375

Interval( A-B, 'D hh:mm' ) donde A=97-08-06 09:00:00 y B=96-08-06 00:00:00 365 09:00 365,375

Num
Esta funcin de script da formato numrico a la expresin expression, conforme a la cadena suministrada
como format-code. El separador de decimales y el separador de miles puede establecerse como tercer y
cuarto parmetro. Si los parmetros 2-4 se omiten, se usa el nmero de formato que est establecido en el
sistema operativo.

Sintaxis:

Num(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ] )

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:

Configuracin por defecto 1 Configuracin por defecto 2

Formato numrico # ##0,# #,##0.#

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 443


5 Funciones en scripts y en expresiones de grfico

Configuracin Configuracin
Ejemplo Resultados
1 2

Num( A, '0.0' ) donde A=35648,375 Cadena: 35 648 375 35648,375

Nmero: 35648375 35648,375

Num( A, '#,##0.##', '.' , ',' ) donde Cadena: 35.648,00 35.648,00


A=35648
Nmero: 35648 35648
Num( pi( ), '0,00' ) Cadena: 3,14 003

Nmero: 3,141592653 3,141592653

Money
La funcin money da formato numrico a la expresin expression conforme a la cadena suministrada como
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si los parmetros 2-4 se omiten, se usar el formato numrico establecido en el sistema
operativo.

Sintaxis:

Money(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de moneda kr # ##0,00 $#,##0.00

Configuracin Configuracin
Ejemplo Resultados
1 2

Money( A ) donde A=35648 Cadena: kr 35 648,00 $35,648.00

Nmero: 35648,00 35648,00

Money( A, '#,##0 ', '.' , ',' ) donde Cadena: 3,564,800 3,564,800


A=3564800
Nmero: 3564800 3564800

Time
La funcin time da formato a la expresin como una hora conforme a la cadena suministrada como format-
code. Si format-code se omite, se utilizar el formato de hora establecido en la configuracin del sistema
operativo.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 444


5 Funciones en scripts y en expresiones de grfico

Time( expression [ , format-code ])

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de Hora hh:mm:ss hh.mm.ss

Ejemplo Resultados Configuracin 1 Configuracin 2

Time( A ) donde A=0,375 Cadena: 9:00:00 09.00.00

Nmero: 0,375 0,375

Time( A ) donde A=35648,375 Cadena: 9:00:00 09.00.00

Nmero: 35648,375 35648,375

Time( A, 'hh-mm' ) donde A=0,99999 Cadena: 23-59 23-59

Nmero: 0,99999 0,99999

Timestamp
Esta funcin da formato a la expression como una fecha-hora de acuerdo con la cadena suministrada como
format-code. Si se omite el cdigo de formato, se usa el formato de fecha-hora establecido en el sistema
operativo.

Sintaxis:

Timestamp(expression [ , format-code ])

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:

Configuracin por defecto Configuracin por defecto


1 2

Formato de timestamp (una YY-MM-DD M/D/YY


fechahora)

Configuracin Configuracin
Ejemplo Resultados
1 2

Timestamp( A ) donde A=35648,375 Cadena: 97-08-06 8/6/97 09:00:00

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 445


5 Funciones en scripts y en expresiones de grfico

Configuracin Configuracin
Ejemplo Resultados
1 2

09:00:00

Nmero: 35648,375 35648,375

Timestamp( A,'YYYY-MM-DD hh.mm') donde Cadena: 1997-08-06 00.00 1997-08-06


A=35648 00.00

Nmero: 35648 35648

5.11 Funciones numricas generales en grficos


En estas funciones numricas generales los argumentos son expresiones donde x debera interpretarse
como un nmero de valor real. Todas las funciones pueden utilizarse tanto en scripts de carga de datos como
en expresiones de grficos.

bitcount
BitCount() halla el nmero de bits del equivalente binario de un nmero fijados en 1. Esto es, la funcin
devuelve el nmero de bits activados en integer_number, donde integer_number se interpreta como un
entero con signo de 32 bits.

BitCount(integer_number)

ceil
Ceil() redondea una cifra hacia arriba hasta el mltiplo ms cercano del intervalo step especificado. El
resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es negativo.

Ceil(x[, step[, offset]])

combin
Combin() devuelve el nmero de combinaciones de elementos q que se pueden escoger de un grupo de p
elementos. Segn se representa en la frmula: Combin(p,q) = p! / q!(p-q)! El orden en que se seleccionan
los elementos no es significativo.

Combinp, q)

div
Div() devuelve la parte de entero de la divisin aritmtica del primer argumento por el segundo argumento.
Ambos parmetros son interpretados como nmeros reales, esto es, no tienen que ser enteros.

Div(integer_number1, integer_number2)

even
Even() devuelve True (-1) si integer_number es un entero par o cero. Devuelve False (0) si integer_
number es un entero impar y NULL si integer_number no es un entero.

Even(integer_number)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 446


5 Funciones en scripts y en expresiones de grfico

fabs
Fabs() devuelve el valor absoluto de x. El resultado es un nmero positivo.

Fabs(x)

fact
Fact() devuelve el nmero factorial de un entero positivo x.

Fact(x)

floor
Floor() redondea una cifra hacia abajo hasta el mltiplo ms cercano del intervalo step especificado. El
resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es negativo.

Floor(x[, step[, offset]])

fmod
fmod() es una funcin generalizada de mdulo que devuelve la parte restante de la divisin entera del primer
argumento (dividendo) por el segundo argumento (divisor). El resultado es un nmero real. Ambos
argumentos son interpretados como nmeros reales, esto es, no tienen que ser enteros.

Fmod(a, b)

frac
Frac() devuelve la parte fraccionaria de x.

Frac(x)

mod
Mod() es una funcin matemtica de mdulo que devuelve el resto no negativo de una divisin entera. El
primer argumento es el dividendo y el segundo argumento es el divisor. Ambos argumentos deben ser
valores enteros.

Mod(integer_number1, integer_number2)

odd
Odd() devuelve True (-1) si integer_number es un entero impar o cero. Devuelve False (0) si integer_
number es un entero par y NULL si integer_number no es un entero.

Odd(integer_number)

permut
Permut() devuelve el nmero de permutaciones de elementos q que se pueden seleccionar de un grupo de
p elementos. Segn se representa en la frmula: Permut(p,q) = (p)! / (p - q)! El orden en que se
seleccionan los elementos es importante.

Permut(p, q)

round

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 447


5 Funciones en scripts y en expresiones de grfico

Round() devuelve el resultado de redondear x hacia arriba o hacia abajo hasta el mltiplo ms cercano de
step. El resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es
negativo.

Round( x [ , base [ , offset ]])

sign
Sign() devuelve 1, 0 o -1 dependiendo de si x es un nmero positivo, 0 o un nmero negativo.

Sign(x)

BitCount
BitCount() halla el nmero de bits del equivalente binario de un nmero fijados en 1. Esto es, la funcin
devuelve el nmero de bits activados en integer_number, donde integer_number se interpreta como un
entero con signo de 32 bits.

Sintaxis:

BitCount(integer_number)

Tipo de datos devueltos: Entero

Ejemplos y resultados:

Ejemplos Resultados
BitCount ( 3 ) 3 equivale al binario 101, por lo que devuelve el valor 2
BitCount ( -1 ) -1 equivale a 32 unos en binario, por lo que devuelve el valor 32

Ceil
Ceil() redondea una cifra hacia arriba hasta el mltiplo ms cercano del intervalo step especificado. El
resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es negativo.

Comprelo con la funcin floor, que redondea los nmeros introducidos hacia abajo.

Sintaxis:

Ceil(x[, step[, offset]])

Tipo de datos devueltos: Entero

Ejemplos y resultados:

Ejemplos Resultados
Ceil( 2.4 ) Devuelve 4

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 448


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados
Ceil( 2.6 ) Devuelve 6
Ceil( 3.88 , 0.1 ) Devuelve 3,9
Ceil( 3.88 , 5 ) Devuelve 5
Ceil( 1.1 , 1 ) Devuelve 2
Ceil( 1.1 , 1 , 0.5 ) Devuelve 1,5
Ceil( 1.1 , 1 , -0.01 ) Devuelve 1,99

Vea tambin:

p Floor (pgina 452)

Combin
Combin() devuelve el nmero de combinaciones de elementos q que se pueden escoger de un grupo de p
elementos. Segn se representa en la frmula: Combin(p,q) = p! / q!(p-q)! El orden en que se seleccionan
los elementos no es significativo.

Sintaxis:

Combin(p, q)

Tipo de datos devueltos: Entero

Limitaciones:

Los elementos no enteros se truncarn.

Ejemplos y resultados:

Ejemplos Resultados

Cuntas combinaciones de 7 nmeros pueden obtenerse de un total de 35 nmeros Devuelve


de lotera? 6.724.520

Combin( 35,7 )

Vea tambin:

p Permut (pgina 455)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 449


5 Funciones en scripts y en expresiones de grfico

Div
Div() devuelve la parte de entero de la divisin aritmtica del primer argumento por el segundo argumento.
Ambos parmetros son interpretados como nmeros reales, esto es, no tienen que ser enteros.

Sintaxis:

Div(integer_number1, integer_number2)

Tipo de datos devueltos: Entero

Ejemplos y resultados:

Ejemplos Resultados
Div( 7,2 ) Devuelve 3
Div( 7.1,2.3 ) Devuelve 3
Div( 9,3 ) Devuelve 3
Div( -4,3 ) Devuelve -1
Div( 4,-3 ) Devuelve -1
Div( -4,-3 ) Devuelve 1

Vea tambin:

p Mod (pgina 454)

Even
Even() devuelve True (-1) si integer_number es un entero par o cero. Devuelve False (0) si integer_
number es un entero impar y NULL si integer_number no es un entero.

Sintaxis:

Even(integer_number)

Tipo de datos devueltos: Entero

Ejemplos y resultados:

Ejemplos Resultados
Even( 3 ) Devuelve 0, False
Even( 2 * 10 ) Devuelve -1, True
Even( 3.14 ) Devuelve NULL

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 450


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Odd (pgina 454)

Fabs
Fabs() devuelve el valor absoluto de x. El resultado es un nmero positivo.

Sintaxis:

fabs(x)

Tipo de datos devueltos: numrico

Ejemplos y resultados:

Ejemplos Resultados
fabs( 2.4 ) Devuelve 2,4
fabs( -3.8 ) Devuelve 3,8

Fact
Fact() devuelve el nmero factorial de un entero positivo x.

Sintaxis:

Fact(x)

Tipo de datos devueltos: Entero

Limitaciones:

Si el nmero x no es un entero, ser truncado. Los nmeros no positivos devolvern NULL.

Ejemplos y resultados:

Ejemplos Resultados
Fact( 1 ) Devuelve 1
Fact( 5 ) Devuelve 120 (1 * 2 * 3 * 4 * 5 = 120 )
Fact( -5 ) Devuelve NULL

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 451


5 Funciones en scripts y en expresiones de grfico

Floor
Floor() redondea una cifra hacia abajo hasta el mltiplo ms cercano del intervalo step especificado. El
resultado se reduce por el valor de offset, si se especifica uno, o bien se incrementa si offset es negativo.

Comprelo con la funcin ceil, que redondea los nmeros introducidos al alza.

Sintaxis:

Floor(x[, step[, offset]])

Tipo de datos devueltos: numrico

Ejemplos y resultados:

Ejemplos Resultados
Floor( 2,4 ) Devuelve 0
Floor( 4,2 ) Devuelve 4
Floor( 3.88 , 0.1 ) Devuelve 3,8
Floor( 3.88 , 5 ) Devuelve 0
Floor( 1.1 , 1 ) Devuelve 1
Floor( 1.1 , 1 , 0.5 ) Devuelve 0,5

Vea tambin:

p Frac (pgina 453)

p Ceil (pgina 448)

Fmod
fmod() es una funcin generalizada de mdulo que devuelve la parte restante de la divisin entera del primer
argumento (dividendo) por el segundo argumento (divisor). El resultado es un nmero real. Ambos
argumentos son interpretados como nmeros reales, esto es, no tienen que ser enteros.

Sintaxis:

fmod(a, b)

Tipo de datos devueltos: numrico

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 452


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados
fmod( 7,2 ) Devuelve 1
fmod( 7.5,2 ) Devuelve 1,5
fmod( 9,3 ) Devuelve 0
fmod( -4,3 ) Devuelve -1
fmod( 4,-3 ) Devuelve 1
fmod( -4,-3 ) Devuelve -1

Vea tambin:

p Div (pgina 450)

Frac
Frac() devuelve la parte fraccionaria de x.

La fraccin se define de tal manera que Frac(x ) + Floor(x ) = x. Dicho de una manera simple, esto
significa que la parte fraccional de un nmero positivo es la diferencia entre el nmero (x) y el entero que le
precede.

Por ejemplo:
La parte fraccional de 11.43 =11.43 - 11 = 0.43

Para un nmero negativo como, por ejemplo, -1,4, Floor(-1.4) = -2, lo que produce el resultado siguiente:
La parte fraccional de -1,4 =1,4 - (-2) =-1,4 + 2 =0,6

Sintaxis:

Frac(x)

Tipo de datos devueltos: numrico

Ejemplos y resultados:

Ejemplos Resultados
Frac( 11.43 ) Devuelve 0,43
Frac( -1.4 ) Devuelve 0,6

Vea tambin:

p Floor (pgina 452)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 453


5 Funciones en scripts y en expresiones de grfico

Mod
Mod() es una funcin matemtica de mdulo que devuelve el resto no negativo de una divisin entera. El
primer argumento es el dividendo y el segundo argumento es el divisor. Ambos argumentos deben ser
valores enteros.

Sintaxis:

Mod(integer_number1, integer_number2)

Tipo de datos devueltos: Entero

Limitaciones:

integer_number2 debe ser mayor que 0.

Ejemplos y resultados:

Ejemplos Resultados
Mod( 7,2 ) Devuelve 1
Mod( 7.5,2 ) Devuelve NULL
Mod( 9,3 ) Devuelve 0
Mod( -4,3 ) Devuelve 2
Mod( 4,-3 ) Devuelve NULL
Mod( -4,-3 ) Devuelve NULL

Vea tambin:

p Div (pgina 450)

Odd
Odd() devuelve True (-1) si integer_number es un entero impar o cero. Devuelve False (0) si integer_
number es un entero par y NULL si integer_number no es un entero.

Sintaxis:

Odd(integer_number)

Tipo de datos devueltos: Entero

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 454


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados
Odd( 3 ) Devuelve -1, True
Odd( 2 * 10 ) Devuelve 0, False
Odd( 3.14 ) Devuelve NULL

Vea tambin:

p Even (pgina 450)

Permut
Permut() devuelve el nmero de permutaciones de elementos q que se pueden seleccionar de un grupo de
p elementos. Segn se representa en la frmula: Permut(p,q) = (p)! / (p - q)! El orden en que se
seleccionan los elementos es importante.

Sintaxis:

Permut(p, q)

Tipo de datos devueltos: Entero

Limitaciones:

Los argumentos no enteros sern truncados.

Ejemplos y resultados:

Ejemplos Resultados

De cuntas formas pueden ser distribuidas las medallas de oro, plata y bronce despus Devuelve
de una final de 100 m con 8 participantes? 336

Permut( 8,3 )

Vea tambin:

p Combin (pgina 449)

Round
Round() devuelve el resultado de redondear x hacia arriba o hacia abajo hasta el mltiplo ms cercano de
step. . El resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es
negativo. El valor predeterminado de step es 1.

Si x est exactamente en el medio de un intervalo, se redondea hacia arriba.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 455


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

Round(x[, step[, offset]])

Tipo de datos devueltos: numrico

Ejemplos y resultados:

Ejemplos Resultados
Round( 3.8 ) Devuelve 4
Round( 3.8.4 ) Devuelve 4
Round( 2.5 ) Devuelve 3. El valor se redondea al alza porque 2,5 es exactamente la mitad del
intervalo de paso predeterminado.
Round( 2.4 ) Devuelve 4. El valor se redondea al alza porque 2 es exactamente la mitad del
intervalo de paso de 4.
Round( 2.6 ) Devuelve 0
Round( 3.88 , Devuelve 3,9
0.1 )

Round( 3.88 , 5 Devuelve 5


)

Round( 1.1 , 1 , Devuelve 1,5


0.5 )

Sign
Sign() devuelve 1, 0 o -1 dependiendo de si x es un nmero positivo, 0 o un nmero negativo.

Sintaxis:

Sign(x)

Tipo de datos devueltos: numrico

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Ejemplos Resultados
Sign( 66 ) Devuelve 1
Sign( 0 ) Devuelve 0
Sign( - 234 ) Devuelve -1

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 456


5 Funciones en scripts y en expresiones de grfico

5.12 Funciones geogrficas


Estas funciones s utilizan para manejar los datos geogrficos de las visualizaciones de mapas.

Descripcin general de las funciones geogrficas


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Parmetros utilizados en las funciones geogrficas


Geometra Puede ser cualquiera de los valores siguientes:

l un punto (latitud, longitud)


l un rea

Proyeccin Con el sistema de proyeccin Mercator, es posible representar mapas en formato


cuadrado y corregir la deformacin que se produce con el ajuste.

Puede ser cualquiera de los valores siguientes:

l 'unit' (valor predeterminado): la proyeccin es 1:1


l 'mercator'

GeoAggrGeometry
Esta funcin se puede utilizar para agregar diversas reas en una rea mayor, por ejemplo agregando
diversas sub-regiones a una regin.

GeoAggrGeometry(geometry)

GeoBoundingBox
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea y calcular el
GeoBoundingBox ms pequeo que contiene todas las coordenadas.

El valor GeoBoundingBox se representa como una lista de cuatro valores: izquierda, derecha, arriba y abajo.

GeoBoundingBox(geometry)

GeoGetBoundingBox
Esta funcin puede utilizarse en scripts y expresiones de grfico para calcular el menor GeoBoundingBox
que contiene todas las coordenadas de una geometra.

El valor GeoBoundingBox se representa como una lista de cuatro valores: izquierda, derecha, arriba y abajo.

GeoGetBoundingBox(geometry)

GeoGetPolygonCenter
Esta funcin puede utilizarse en scripts y expresiones de grfico para calcular y devolver el punto central de

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 457


5 Funciones en scripts y en expresiones de grfico

una geometra.

GeoGetPolygonCenter(geometry)

GeoInvProjectGeometry
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea y aplicar la inversa de una
proyeccin.

GeoInvProjectGeometry(projection, geometry)

GeoMakePoint
Esta funcin puede utilizarse en scripts y expresiones de grfico para crear y etiquetar un punto con la latitud
y la longitud.

GeoMakePoint(latitude, longitude )

GeoProject
Esta funcin puede utilizarse en scripts y expresiones de grfico para aplicar una proyeccin a una
geometra.

GeoProject(projection, geometry)

GeoProjectGeometry
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea y aplicar una proyeccin.

GeoProjectGeometry(projection, geometry)

GeoReduceGeometry
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea.

GeoReduceGeometry(geometry)

5.13 Funciones de interpretacin


Las funciones de interpretacin interpretan los contenidos de los campos o expresiones. Con estas funciones
se puede determinar el tipo de datos, el separador de decimales, el separador de miles, etc. empleados.
Todas las funciones pueden utilizarse tanto en scripts de carga de datos como en expresiones de grficos.

Si no se usan funciones de interpretacin, Qlik Sense interpreta los datos como una mezcla de nmeros,
fechas, horas, fecha-hora y cadenas, empleando las configuraciones por defecto para formato numrico,
formato de fecha y formato de hora definidos por las variables de script y por el sistema operativo.

Por razones de claridad todas las representaciones numricas se dan con un punto decimal
como separador decimal.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 458


5 Funciones en scripts y en expresiones de grfico

Descripcin general de las funciones de interpretacin


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Date#
Esta funcin evala la expresin como una fecha de acuerdo con la cadena suministrada como format-
code.Si el cdigo de formato se omite, se usa la fecha por defecto del sistema operativo.

Date# (expression [ , format-code ])

Interval#
Esta funcin evala la expression como un intervalo de tiempo de acuerdo con la cadena suministrada
como format-code. Si format code se omite, se utilizar el formato de hora establecido en la configuracin
del sistema operativo.

Interval# (expression [ , format-code ])

Money#
Esta funcin da formato numrico a la expresin expression, conforme a la cadena suministrada como
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si se omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de
script o predeterminado en el sistema operativo.

Money# (expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])

Num#
Esta funcin evala la expresin numricamente de acuerdo a la cadena suministrada como format-code. El
separador de decimales y el separador de miles puede establecerse como tercer y cuarto parmetro. Si se
omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de script o
predeterminado en el sistema operativo.

Num# (expression [ , format-code[ , decimal-sep [ , thousands-sep] ] ])

Text
La funcin text obliga a tratar como texto la expresin, incluso si es posible una interpretacin numrica.

Text(expression )

Time#
La funcin time# evala la expresin expression conforme a la cadena suministrada como format-code. Si
se omite el cdigo de formato format-code, se utilizar el formato de hora predeterminado en el sistema
operativo..

Time# (expression [ , format-code ])

Timestamp#
La funcin timestamp# evala la expression como fecha de acuerdo con la cadena suministrada como

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 459


5 Funciones en scripts y en expresiones de grfico

cd-formato. Si se omite el format code, se usar el formato de fecha y hora definido en el sistema
operativo.

Timestamp#(expression [ , format-code ])

Date#
Esta funcin evala la expresin como una fecha de acuerdo con la cadena suministrada como format-
code.Si el cdigo de formato se omite, se usa la fecha por defecto del sistema operativo.

Sintaxis:

Date#(expression [ , format-code ])

Argumentos:

Argumento Descripcin

format-code La cadena que describe el formato de la cadena resultante. Si el cdigo de formato se


omite, se emplea el formato de fecha establecido por el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de Fecha YY-MM-DD M/D/YY

Resultado con Resultado con


Ejemplo Resultados
Parmetro 1 Parmetro 2

Date#( A ) donde A=8/6/97 Cadena: 06/08/1997 06/08/1997

Nmero: - 35648

Date#( A, 'YYYY.MM.DD' ) donde Cadena: 1997.08.08 1997.08.06


A=1997.08.06
Nmero: 35648 35648

Interval#
Esta funcin evala la expression como un intervalo de tiempo de acuerdo con la cadena suministrada
como format-code. Si format code se omite, se utilizar el formato de hora establecido en la configuracin
del sistema operativo.

Sintaxis:

Interval#(expression [ , format-code ])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 460


5 Funciones en scripts y en expresiones de grfico

La funcin interval# generalmente se comporta como la funcin time# pero mientras las horas no pueden
ser mayores que 23:59:59 (valor numrico 0.99999) o menores que 00:00:00 (valor numrico 0.00000) un
intervalo puede tener cualquier valor.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:

Formato de fecha corta: YY-MM-DD

Formato de hora: hh:mm:ss

Separador de decimales: .

Ejemplo Resultado

Interval#( A, 'D hh:mm' ) donde A=1 09:00 Cadena: 1 09:00

Nmero: 1,375

Interval#( A-B ) donde A=97-08-06 09:00:00 y B=97-08-05 00:00:00 Cadena: 1,375

Nmero: 1,375

Money#
Esta funcin da formato numrico a la expresin expression, conforme a la cadena suministrada como
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si se omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de
script o predeterminado en el sistema operativo.

Sintaxis:

Money#(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])

La funcin money# generalmente se comporta igual que la funcin num# pero toma sus valores por defecto
para los separadores de miles y de decimales de las variables de script para el formato de moneda, o de las
configuraciones de sistema para la moneda.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de moneda kr # ##0,00 $#,##0.00

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 461


5 Funciones en scripts y en expresiones de grfico

Configuracin Configuracin
Ejemplo Resultados
1 2

Money#( , '# ##0,00 kr' ) donde A=35 648,37 kr Cadena: 35 648.37 kr 35 648.37 kr

Nmero: 35648,37 3564837

Money#( A, ' $#', '.', ',' ) donde A= Cadena: $35,648.37 $35,648.37


$35.648,37
Nmero: 35648,37 35648,37

Num#
Esta funcin evala la expresin numricamente de acuerdo a la cadena suministrada como format-code. El
separador de decimales y el separador de miles puede establecerse como tercer y cuarto parmetro. Si se
omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de script o
predeterminado en el sistema operativo.

Sintaxis:

Num#(expression [ , format-code[ , decimal-sep [ , thousands-sep] ] ])

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:

Configuracin por defecto 1 Configuracin por defecto 2

Formato numrico # ##0,# #,##0.#

Configuracin Configuracin
Ejemplo Resultados
1 2

Num#( A, '#' ) donde A=35.648,375 Cadena: 35.648,375 35648,375

Nmero: - 35648,375

Num#( A, '#.#', '.' , ',') donde Cadena: 35.648,375 35.648,375


A=35.648,375
Nmero: 35648,375 35648,375

Num#( A, '#.#',',','.' ) donde A=35648,375 Cadena: 35648,375 35648,375

Nmero: 35648375 35648375

Num#( A, 'abc#,#' ) donde A=abc123,4 Cadena: abc123,4 abc123,4

Nmero: 123,4 1234

Text
La funcin text obliga a tratar como texto la expresin, incluso si es posible una interpretacin numrica.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 462


5 Funciones en scripts y en expresiones de grfico

Text (expression )

Ejemplos y resultados:

Ejemplo Resultado

Text( A ) donde A=1234 Cadena: 1234

Nmero: -
Text( pi( ) ) Cadena: 3,1415926535898

Nmero: -

Time#
La funcin time# evala la expresin expression conforme a la cadena suministrada como format-code. Si
se omite el cdigo de formato format-code, se utilizar el formato de hora predeterminado en el sistema
operativo..

Sintaxis:

time#(expression [ , format-code ])

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de Hora hh:mm:ss hh.mm.ss

Ejemplo Resultados Configuracin 1 Configuracin 2

time#( A ) donde A=09:00:00 Cadena: 9:00:00 9:00:00

Nmero: 0,375 -

time#( A, 'hh.mm' ) donde A=09,00 Cadena: 09,00 09,00

Nmero: 0,375 0,375

Timestamp#
La funcin timestamp# evala la expression como fecha de acuerdo con la cadena suministrada como
cd-formato. Si se omite el format code, se usar el formato de fecha y hora definido en el sistema
operativo.

Sintaxis:

timestamp#(expression [ , format-code ])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 463


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:

Configuracin por defecto 1 Configuracin por defecto 2

Formato de Fecha YY-MM-DD M/D/YY

Formato de Hora hh:mm:ss hh:mm:ss

Configuracin Configuracin
Ejemplo Resultados
1 2

timestamp#( A ) donde A=8/6/97 09:00:00 Cadena: 8/6/97 09:00:00 8/6/97 09:00:00

Nmero: - 35648,375

timestamp#( A, 'YYYY-MM-DD hh_mm' ) donde Cadena: 1997-08-06 09_ 1997-08-06 09_


A=8/6/97 09_00 00 00

Nmero: 35648,375 35648,375

5.14 Funciones inter-registro


Las Funciones inter registro se utilizan:

l En el script de carga de datos, cuando se necesite un valor de otros registros de datos cargados
anteriormente para la evaluacin del registro actual.
l En una expresin de grficos, cuando se necesite otro valor del conjunto de datos de una
visualizacin.

No se permite ordenar por valores -y- en los grficos ni ordenar por columnas de expresin en
tablas simples cuando se est empleando funciones Inter Registro de grficos en cualquiera
de las expresiones del grfico. Estas alternativas de ordenacin estn por lo tanto
automticamente deshabilitadas.

Suprimir valores cero se desactiva automticamente cuando se utilizan dichas funciones.

Funciones de fila
Estas funciones slo pueden emplearse en expresiones de grficos.
Above
Above() evala una expresin situada una fila por encima de la fila actual con un segmento de columna en
una tabla. La fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma
predeterminada la fila situada directamente encima. Para los grficos que no sean tablas, Above() devuelve
la fila por encima de la actual columna en el equivalente de tabla simple del grfico.

Above - funcin de grfico([TOTAL [<fld{,fld}>]] expr [ , offset [,count]])

Below

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 464


5 Funciones en scripts y en expresiones de grfico

Below() evala una expresin situada una fila por debajo de la fila actual con un segmento de columna en
una tabla. La fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma
predeterminada la fila situada directamente debajo. Para los grficos que no sean tablas, Below() devuelve
la fila debajo de la actual columna en el equivalente de tabla simple del grfico.

Below - funcin de grfico([TOTAL[<fld{,fld}>]] expression [ , offset


[,count ]])

Bottom
Bottom() evala una expresin situada en la ltima fila (inferior) de un segmento de columna en una tabla.
La fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma
predeterminada la fila inferior. Para los grficos que no sean tablas, la evaluacin se realiza en la ltima fila
de la columna actual en el equivalente de tabla simple del grfico.

Bottom - funcin de grfico([TOTAL[<fld{,fld}>]] expr [ , offset [,count


]])

Top
Top() evala una expresin situada en la primera fila (superior) de un segmento de columna en una tabla. La
fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma predeterminada
la fila superior. Para los grficos que no sean tablas, la evaluacin de Top()se realiza en la primera fila de la
columna actual en el equivalente de tabla simple del grfico.

Top - funcin de grfico([TOTAL [<fld{,fld}>]] expr [ , offset [,count ]])

NoOfRows
NoOfRows() devuelve el nmero de filas del segmento de columna actual en una tabla. Para los grficos en
modo mapa de bits, NoOfRows()devuelve el nmero de filas en el equivalente de la tabla simple.

NoOfRows - funcin de grfico([TOTAL])

RowNo
RowNo() devuelve el nmero de la fila actual en el segmento de columna actual en una tabla. Para los
grficos en modo mapa de bits, RowNo()devuelve el nmero de la fila actual en el equivalente de la tabla
simple.

RowNo - funcin de grfico([TOTAL])

Funciones de columna
Estas funciones slo pueden emplearse en expresiones de grficos.
Column
Column() devuelve el valor hallado en la columna correspondiente a ColumnNo en una tabla simple,
descartando las dimensiones. Por ejemplo, Column(2) devuelve el valor de la segunda columna de la
medida.

Column - funcin de grfico(ColumnNo)

Dimensionality

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 465


5 Funciones en scripts y en expresiones de grfico

Dimensionality() devuelve el nmero de dimensiones para la fila actual.

Dimensionality - funcin de grfico ( )

Funciones de campo
FieldIndex
FieldIndex() devuelve la posicin del valor de campo value en el campo field_name (por orden de carga).

FieldIndex(field_name , value)

FieldValue
FieldValue()devuelve el valor del campo encontrado en la posicin elem_no del campo field_name (por
orden de carga).

FieldValue(field_name , elem_no)

FieldValueCount
FieldValueCount() es una funcin de entero que encuentra el nmero de valores distintos en un campo.

FieldValueCount(field_name)

Funciones inter registro en el script de carga de datos


Exists
Esta funcin de script determina si existe un valor especfico en un campo especificado de los datos
cargados hasta ese momento. Field es un nombre o una expresin de texto que evala un nombre de
campo.

Exists (field [ , expression ]

LookUp
Esta funcin de script devuelve el valor de fieldname correspondiente a la primera aparicin del valor
matchfieldvalue, en el campo matchfieldname.

LookUp (fieldname, matchfieldname, matchfieldvalue [, tablename])

Peek
Esta funcin de script devuelve los contenidos de fieldname en el registro especificado por row en la tabla
interna tablename. Los datos se recuperan desde la base de datos asociativa de Qlik Sense.

Peek (fieldname [ , row [ , tablename ] ]

Previous
Esta funcin de script devuelve el valor de expression usando datos desde el registro previamente insertado
que no ha sido descartado debido a una clusula where. En el primer registro de una tabla interna, la funcin
devolver NULL.

Previous (expression )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 466


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

Funciones de rango (pgina 494)

Above - funcin de grfico


Above() evala una expresin situada una fila por encima de la fila actual con un segmento de columna en
una tabla. La fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma
predeterminada la fila situada directamente encima. Para los grficos que no sean tablas, Above() devuelve
la fila por encima de la actual columna en el equivalente de tabla simple del grfico.

Sintaxis:

Above([TOTAL] expr [ , offset [,count]])

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

offset Al especificar un offset n mayor que 1, se puede mover la evaluacin de la expresin n


filas por encima de la fila actual.

Especificar un offset de 0 evaluar la expresin en la fila actual.

Al especificar un nmero de offset negativo, la funcin Above ser equivalente a una


funcin Below con el correspondiente nmero de offset positivo.

count Al especificar un tercer parmetro count mayor que 1, la funcin devolver un rango de
valores count, uno por cada count filas de tabla contando hacia arriba desde la celda
original. De esta manera, la funcin puede utilizarse como argumento en cualquiera de las
funciones de rango especiales. Funciones de rango (pgina 494)

TOTAL Si la tabla es uni-dimensional o si se usa el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

En la primera fila de un segmento de columna se devuelve un valor NULL, dado que no hay ninguna fila por
encima de esta.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 467


5 Funciones en scripts y en expresiones de grfico

Un segmento de columna se define como un subconjunto consecutivo de celdas que tienen


los mismos valores para las dimensiones de la ordenacin actual. Las funciones inter registro
se calculan en el segmento de columna excluida la dimensin ms a la derecha del grfico de
tabla simple equivalente. Si solo hay una dimensin en el grfico o si se especifica el
calificador TOTAL, la expresin se evala en toda la tabla.

Si la tabla o el equivalente de tabla tiene mltiples dimensiones verticales, el segmento de


columna actual incluir slo filas con los mismos valores que la fila actual en todas las
columnas de dimensin excepto para la columna que muestra la ltima dimensin en el orden
de campo interno.

Limitaciones:

Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:

Ejemplo1:

Visualizacin de la tabla para el ejemplo 1.

En el pantallazo de la tabla mostrada en este ejemplo, la visualizacin de tabla se crea a partir de la


dimensin Customer y las medidas: Sum(Sales) y Above(Sum(Sales)).

La columna Above(Sum(Sales)) devuelve NULL para la fila Customer que contiene Astrida, ya que no
hay ninguna fila por encima de ella. El resultado de la fila Betacab muestra el valor de Sum(Sales) para
Astrida, el resultado de Canutility muestra el valor de Sum(Sales) para Betacab, etc.

Para la columna etiquetada Sum(Sales)+Above(Sum(Sales)), la fila de Betacab muestra el resultado de


la adicin de los valores de Sum(Sales) a las filas Betacab + Astrida (539+587). El resultado de la fila
Canutility muestra el resultado de la adicin de los valores de Sum(Sales) a Canutility + Betacab
(683+539).

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 468


5 Funciones en scripts y en expresiones de grfico

La medida etiquetada Above offset 3 creada utilizando la expresin Sum(Sales)+Above(Sum(Sales), 3) tiene


el argumento offset configurado en 3, y produce el efecto de tomar el valor de la fila tres filas por encima de
la fila actual. Aade el valor de Sum(Sales) del cliente Customer actual al valor del cliente Customer tres
filas por encima. Los valores que devuelve para las tres primeras filas Customer son null.

La tabla tambin muestra medidas ms complejas: una creada a partir de Sum(Sales)+Above(Sum(Sales)) y


otra etiquetada Higher?, la cual se crea a partir de IF(Sum(Sales)>Above(Sum(Sales)), 'Higher').

Esta funcin tambin puede utilizarse en grficos distintos de tablas, por ejemplo en grficos
de barras.

Para los dems tipos de grficos, convierta el grfico a la tabla simple equivalente para que
pueda interpretar fcilmente con qu fila est relacionada la funcin.

Ejemplo2:

En las capturas de pantalla de la tablas mostradas en este ejemplo, se han agregado ms dimensiones a las
visualizaciones: Month y Product Para grficos con ms de una dimensin, los resultados de las
expresiones que contienen las funciones Above, Below, Top y Bottom dependen del orden en que Qlik
Sense clasifica las dimensiones de columna. Qlik Sense evala las funciones basndose en los segmentos
de columna que resultan de la dimensin que se ordena en ltimo lugar. El criterio de ordenacin de
columna se controla en el panel de propiedades bajo Ordenacin y no es necesariamente el orden en que
las columnas aparecen en una tabla.

En la captura de pantalla siguiente de la visualizacin de la tabla del ejemplo 2, la dimensin ordenada en


ltimo lugar es Month, de modo que la funcin Above se evala por meses. Hay una serie de resultados
para cada valor Product para cada mes (Jan a Aug) - un segmento de columna. Esto va seguido de una
serie para el siguiente segmento de columna: por cada Month para el siguiente Product. Habr un
segmento de columna por cada valor Customer para cada Product.

Visualizacin de la tabla para el ejemplo 2.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 469


5 Funciones en scripts y en expresiones de grfico

Ejemplo3:

En la captura de pantalla de la visualizacin de la tabla para el ejemplo 3, la dimensin ordenada en ltimo


lugar es Product. Esto se consigue al mover la dimensin Product a la posicin 3 de la pestaa Ordenar del
panel de propiedades. La funcin Above se evala con cada Product, y como solo hay dos productos, AA y
BB, solo hay un resultado que no sea null en cada serie. La fila BB de Jan muestra el valor de Sum(Sales)
para la fila AA, el valor es null. El valor de cada fila AA siempre ser nulo, ya que AA no est presente en el
primer valor de Product en el segmento de columna. La segunda serie se evala conforme a AA y BB para
Feb, y as sucesivamente con el primer valor de Customer, Astrida. Cuando se hayan acabado todos los
meses para el primer valor Customer, la secuencia se repite para el segundo valor Customer, etc.

Visualizacin de la tabla para el ejemplo 3.

Ejemplo4: Resultado

La funcin Above puede utilizarse como entrada Devuelve la media de los tres resultados de la
para las funciones de rango. Por ejemplo: RangeAvg funcin Sum(Sales) evaluada en las tres filas
(Above(Sum(Sales),1,3)). inmediatamente encima de la fila actual.

Datos empleados en los ejemplos:

Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 470


5 Funciones en scripts y en expresiones de grfico

];
Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');
Para ordenar los meses correctamente cuando cree sus visualizaciones, dirjase a la seccin Ordenar del
panel de propiedades, seleccione Mes y active la casilla Ordenar por expresin. En el cuadro de
expresin, escriba Monthnumber.

Vea tambin:

p Below - funcin de grfico (pgina 475)

p Bottom - funcin de grfico (pgina 471)

p Top - funcin de grfico (pgina 487)

p RangeAvg (pgina 497)

Bottom - funcin de grfico


Bottom() evala una expresin situada en la ltima fila (inferior) de un segmento de columna en una tabla.
La fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma
predeterminada la fila inferior. Para los grficos que no sean tablas, la evaluacin se realiza en la ltima fila
de la columna actual en el equivalente de tabla simple del grfico.

Sintaxis:

Bottom([TOTAL] expr [ , offset [,count ]])

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

offset Al especificar un offset n mayor que 1, la evaluacin de la expresin se mueve n filas por
encima de la fila inferior.

Al especificar un nmero de offset negativo, la funcin Bottom ser equivalente a una


funcin Top con el correspondiente nmero de offset positivo.

count Si se especifica un tercer parmetro count mayor que 1, la funcin devolver un rango de
valores count, uno por cada una de las ltimas filas count del segmento de columna

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 471


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

actual. De esta manera, la funcin puede utilizarse como argumento en cualquiera de las
funciones de rango especiales. Funciones de rango (pgina 494)

TOTAL Si la tabla es uni-dimensional o si se usa el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Un segmento de columna se define como un subconjunto consecutivo de celdas que tienen


los mismos valores para las dimensiones de la ordenacin actual. Las funciones inter registro
se calculan en el segmento de columna excluida la dimensin ms a la derecha del grfico de
tabla simple equivalente. Si solo hay una dimensin en el grfico o si se especifica el
calificador TOTAL, la expresin se evala en toda la tabla.

Si la tabla o el equivalente de tabla tiene mltiples dimensiones verticales, el segmento de


columna actual incluir slo filas con los mismos valores que la fila actual en todas las
columnas de dimensin excepto para la columna que muestra la ltima dimensin en el orden
de campo interno.

Limitaciones:

Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:

Ejemplo: 1

Visualizacin de la tabla para el ejemplo 1.

En el pantallazo de la tabla mostrada en este ejemplo, la visualizacin de tabla se crea a partir de la


dimensin Customer y las medidas: Sum(Sales) y Bottom(Sum(Sales)).

La columna Bottom(Sum(Sales)) devuelve 757 para todas las filas porque ste es el valor de la fila inferior:
Divadip.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 472


5 Funciones en scripts y en expresiones de grfico

La tabla tambin muestra medidas ms complejas: una creada a partir de Sum(Sales)+Bottom(Sum(Sales)) y


otra etiquetada Bottom offset 3, que se crea utilizando la expresin Sum(Sales)+Bottom(Sum(Sales), 3) y
tiene el argumento offset establecido en 3. Agrega el valor Sum(Sales) para la fila actual al valor de la
tercera fila desde la ltima fila, es decir, la fila actual ms el valor de Betacab.

Ejemplo: 2

En los pantallazos de la tablas mostradas en este ejemplo, se han aadido ms dimensiones a las
visualizaciones: Month y Product Para grficos con ms de una dimensin, los resultados de las
expresiones que contienen las funciones Above, Below, Top y Bottom dependen del orden en que Qlik
Sense clasifica las dimensiones de columna. Qlik Sense evala las funciones basndose en los segmentos
de columna que resultan de la dimensin que se ordena en ltimo lugar. El criterio de ordenacin de
columna se controla en el panel de propiedades bajo Ordenacin y no es necesariamente el orden en que
las columnas aparecen en una tabla.

En la primera tabla, la expresin se evala basndose en Month y, en la segunda, basndose en Product.


La medida End value contiene la expresin Bottom(Sum(Sales)). La fila inferior de Month es Dec y el valor
de Dec, as como el valor de Product que se muestra en la captura de pantalla, es 22. (Algunas filas se han
editado fuera de la captura de pantalla para ahorrar espacio.)

Primera tabla para el ejemplo 2. El valor de Bottom para la medida End value basado en Month (Dec).

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 473


5 Funciones en scripts y en expresiones de grfico

Segunda tabla para el ejemplo 2. El valor de Bottom para la medida End value basado en Product (BB
paraAstrida).

Le remitimos al Ejemplo: 2 de la funcin Above para obtener ms detalles.

Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];
Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');
Para ordenar los meses correctamente cuando cree sus visualizaciones, dirjase a la seccin Ordenar del
panel de propiedades, seleccione Mes y active la casilla Ordenar por expresin. En el cuadro de
expresin, escriba Monthnumber.

Vea tambin:

p Top - funcin de grfico (pgina 487)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 474


5 Funciones en scripts y en expresiones de grfico

Below - funcin de grfico


Below() evala una expresin situada una fila por debajo de la fila actual con un segmento de columna en
una tabla. La fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma
predeterminada la fila situada directamente debajo. Para los grficos que no sean tablas, Below() devuelve
la fila debajo de la actual columna en el equivalente de tabla simple del grfico.

Sintaxis:

Below([TOTAL] expression [ , offset [,count ]])

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

offset Al especificar un offset n mayor que 1, se mueve la evaluacin de la expresin n filas por
debajo de la fila actual.

Especificar un offset de 0 evaluar la expresin en la fila actual.

Al especificar un nmero de offset negativo, la funcin Below ser equivalente a una


funcin Above con el correspondiente nmero de offset positivo.

count Especificando un tercer parmetro count mayor que 1, la funcin devolver un rango de
valores count, uno por cada count filas de tabla contando hacia abajo desde la celda
original. De esta manera, la funcin puede utilizarse como argumento en cualquiera de las
funciones de rango especiales. Funciones de rango (pgina 494)

TOTAL Si la tabla es uni-dimensional o si se usa el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

En la ltima fila de un segmento de columna, se devolver un valor NULL, puesto que no hay ninguna fila
bajo esta.

Un segmento de columna se define como un subconjunto consecutivo de celdas que tienen


los mismos valores para las dimensiones de la ordenacin actual. Las funciones inter registro
se calculan en el segmento de columna excluida la dimensin ms a la derecha del grfico de
tabla simple equivalente. Si solo hay una dimensin en el grfico o si se especifica el
calificador TOTAL, la expresin se evala en toda la tabla.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 475


5 Funciones en scripts y en expresiones de grfico

Si la tabla o el equivalente de tabla tiene mltiples dimensiones verticales, el segmento de


columna actual incluir slo filas con los mismos valores que la fila actual en todas las
columnas de dimensin excepto para la columna que muestra la ltima dimensin en el orden
de campo interno.

Limitaciones:

Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:

Ejemplo1:

Visualizacin de la tabla para el ejemplo 1.

En la tabla mostrada en la captura de pantalla del ejemplo 1, la visualizacin de tabla se crea a partir de la
dimensin Customer y las medidas: Sum(Sales) y Below(Sum(Sales)).

La columna Below(Sum(Sales)) devuelve NULL para la fila Customer que contiene Divadip, ya que no
hay ninguna fila por debajo de ella. El resultado de la fila Canutility muestra el valor de Sum(Sales) para
Divadip, el resultado de Betacab muestra el valor de Sum(Sales) para Canutility, etc.

La tabla tambin muestra medidas ms complejas que podr ver en las columnas etiquetadas de la forma
siguiente: Sum(Sales)+Below(Sum(Sales)), Below +Offset 3 y Higher?. Estas expresiones funcionan tal
como se describe en los prrafos siguientes.

Para la columna etiquetada Sum(Sales)+Below(Sum(Sales)), la fila de Astrida muestra el resultado de la


adicin de los valores de Sum(Sales) a las filas Betacab + Astrida (539+587). El resultado de la fila
Betacab muestra el resultado de la adicin de los valores de Sum(Sales) a Canutility + Betacab
(539+683).

La medida etiquetada Below +Offset 3 creada utilizando la expresin Sum(Sales)+Below(Sum(Sales), 3)


tiene el argumento offset configurado en 3, y produce el efecto de tomar el valor de la fila tres filas por
debajo de la fila actual. Aade el valor de Sum(Sales) del cliente Customer actual al valor del cliente
Customer tres filas por debajo. Los valores de las tres filas Customer ms bajas son null.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 476


5 Funciones en scripts y en expresiones de grfico

La medida etiquetada Higher? se crea a partir de la expresin: IF(Sum(Sales)>Below(Sum(Sales)),


'Higher'). Esta expresin compara los valores de la fila actual de la medida Sum(Sales) con la fila que tiene
debajo. Si la fila actual tiene un valor mayor, se mostrar el texto "Higher".

Esta funcin tambin puede utilizarse en grficos distintos de tablas, por ejemplo en grficos
de barras.

Para los dems tipos de grficos, convierta el grfico a la tabla simple equivalente para que
pueda interpretar fcilmente con qu fila est relacionada la funcin.

Para grficos con ms de una dimensin, los resultados de las expresiones que contienen las funciones
Above, Below, Top y Bottom dependen del orden en que Qlik Sense clasifica las dimensiones de
columna. Qlik Sense evala las funciones basndose en los segmentos de columna que resultan de la
dimensin que se ordena en ltimo lugar. El criterio de ordenacin de columna se controla en el panel de
propiedades bajo Ordenacin y no es necesariamente el orden en que las columnas aparecen en una
tabla.Le remitimos al Ejemplo: 2 de la funcin Above para obtener ms detalles.

Ejemplo2: Resultado

La funcin Below puede utilizarse como entrada Devuelve una media de los tres resultados de la
para las funciones de rango. Por ejemplo: RangeAvg funcin Sum(Sales) evaluada en las tres filas
(Below(Sum(Sales),1,3)). inmediatamente debajo de la fila actual.

Datos empleados en los ejemplos:

Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];
Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 477


5 Funciones en scripts y en expresiones de grfico

Para ordenar los meses correctamente cuando cree sus visualizaciones, dirjase a la seccin Ordenar del
panel de propiedades, seleccione Mes y active la casilla Ordenar por expresin. En el cuadro de
expresin, escriba Monthnumber.

Vea tambin:

p Above - funcin de grfico

p Bottom - funcin de grfico (pgina 471)

p Top - funcin de grfico (pgina 487)

p RangeAvg (pgina 497)

Column - funcin de grfico


Column() devuelve el valor hallado en la columna correspondiente a ColumnNo en una tabla simple,
descartando las dimensiones. Por ejemplo, Column(2) devuelve el valor de la segunda columna de la
medida.

Sintaxis:

Column(ColumnNo)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

ColumnNo Nmero de columna de una columna en la tabla que contiene una medida.

La funcin Column() descarta las columnas de dimensin.

Limitaciones:

Si ColumnNo hace referencia a una columna para la que no hay una medida, devuelve un valor NULL.

Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:

Ejemplo: Porcentaje de ventas totales

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 478


5 Funciones en scripts y en expresiones de grfico

Customer Product UnitPrice UnitSales Order Value Total Sales Value % Sales

A AA 15 10 150 505 29.70

A AA 16 4 64 505 12.67

A BB 9 9 81 505 16.04

B BB 10 5 50 505 9.90

B CC 20 2 40 505 7.92

B DD 25 - 0 505 0.00

C AA 15 8 120 505 23.76

C CC 19 - 0 505 0.00

Ejemplo: Porcentaje de ventas para el cliente seleccionado

Customer Product UnitPrice UnitSales Order Value Total Sales Value % Sales

A AA 15 10 150 295 50.85

A AA 16 4 64 295 21.69

A BB 9 9 81 295 27.46

Ejemplos Resultados

Order Value se aade a la tabla como El resultado de Column(1) se toma de la columna Order Value,
una medida con la expresin: Sum porque esta es la primera columna de la medida.
(UnitPrice*UnitSales).
El resultado de Column(2) se toma de la columna Total Sales
Total Sales Value se aade como una Value, porque esta es la segunda columna de la medida.
medida con la expresin: Sum(TOTAL
UnitPrice*UnitSales) Vea los resultados en la columna % Sales en el ejemplo
Porcentaje de ventas totales (pgina 478).
% Sales se aade como una medida
con la expresin: 100*Column(1)/Column
(2)

SeleccioneCustomer A. La seleccin cambia el valor Total Sales Value, y por lo tanto las
%Sales. Vase el ejemplo Porcentaje de ventas para el cliente
seleccionado (pgina 479).

Datos empleados en los ejemplos:

ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 479


5 Funciones en scripts y en expresiones de grfico

Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD||25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

Dimensionality - funcin de grfico


Dimensionality() devuelve el nmero de dimensiones para la fila actual.

Sintaxis:

Dimensionality ( )

Tipo de datos devueltos:Entero

Limitaciones:

Esta funcin solo est disponible en los grficos. Devuelve el nmero de dimensiones en todas las filas,
excepto el total, que ser de 0.

Ejemplo:

La dimensionalidad suele utilizarse cuando desea realizar un clculo solo si hay un valor presente para una
dimensin.

Ejemplo Resultado

Para una tabla que contenga la dimensin UnitSales, puede que solo desee indicar el envo
de una factura:
IF(Dimensionality()=3, "Invoiced").

Exists
Esta funcin de script determina si existe un valor especfico en un campo especificado de los datos
cargados hasta ese momento. Field es un nombre o una expresin de texto que evala un nombre de
campo.

Sintaxis:

Exists(field [ , expression ] )

El campo deber figurar entre los datos cargados hasta entonces por el script. Expression es una expresin
que evala el valor del campo para buscar en el campo especificado. Si se omite, se asume el valor del
registro actual en el campo especificado.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 480


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

Exists(Month, 'Jan') Devuelve -1 (True) si se encuentra el valor 'Jan' en el


contenido actual del campo Month.

Exists(IDnr, IDnr) Devuelve -1 (True) si el valor del campo IDnr en el


registro actual ya existe en cualquier registro
previamente ledo que contenga ese campo.

Exists (IDnr) Es idntico al ejemplo anterior.

Load Employee, ID, Salary from Employees.csv; Solo son ledos los comentarios referidos a aquellos
Load FirstName& ' ' &LastName as Employee, ciudadanos que son empleados.
Comment from Citizens.csv where Exists
(Employee, FirstName& ' ' &LastName);

Load A, B, C, from Employees.csv where not Esto equivale a hacer un distinct load en el campo A.
Exists (A);

FieldIndex
FieldIndex() devuelve la posicin del valor de campo value en el campo field_name (por orden de carga).

Sintaxis:

FieldIndex(field_name , value)

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

field_name Nombre del campo para el que se requiere el ndice. Debe especificarse como valor de
cadena. Esto implica que el nombre del campo debe escribirse entre comillas simples.

value El valor del campo field_name.

Limitaciones:

Si value no encuentra el valor entre los valores de campo del campo field_name, devuelve 0.

Ejemplos y resultados:

El ejemplo siguiente utiliza dos campos: First name e Initials

First name Initials

John JA

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 481


5 Funciones en scripts y en expresiones de grfico

First name Initials

Sue SB

Mark MC

Peter PD

Jane JE

Peter PF

Ejemplos Resultados
FieldIndex 1, ya que 'John' aparece primero en el orden de carga del campo First name.
('First
Obsrvese que en un panel de filtrado John aparecera como el nmero 2 empezando
name','John')
desde arriba puesto que est ordenado alfabticamente y no en el orden de carga.
FieldIndex 4, ya que FieldIndex() devuelve solo un valor, que es el primero que aparece segn el
('First
orden de carga.
name','Peter')

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"
John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

FieldValue
FieldValue()devuelve el valor del campo encontrado en la posicin elem_no del campo field_name (por
orden de carga).

Sintaxis:

FieldValue(field_name , elem_no)

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

field_name Nombre del campo para el que se requiere el valor. Debe especificarse como valor de
cadena. Esto implica que el nombre del campo debe escribirse entre comillas simples.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 482


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

elem_no La posicin o el nmero de posicin del campo (elemento), siguiendo el orden de carga,
para la que el valor es devuelto.

Limitaciones:

Si elem_no es mayor que el nmero de valores de campo, devuelve NULL.

First name Initials

John JA

Sue SB

Mark MC

Peter PD

Jane JE

Peter PF

Ejemplos y resultados:

El ejemplo siguiente utiliza dos campos: First name e Initials

Ejemplos Resultados
FieldValue John como John aparece primero en el orden de carga del campo First name. Obsrvese
('First
que en un panel de filtrado John aparecera como el nmero 2 empezando desde arriba,
name','1')
despus de Jane, puesto que est ordenado alfabticamente y no en el orden de carga.
FieldValue NULL puesto que hay solo 6 valores en el campo First name.
('First
name','7')

Datos utilizados en el ejemplo:

Initials:
LOAD * inline [
"First name"|Initials|"Has cellphone"
John|JA|Yes
Sue|SB|Yes
Mark|MC |No
Peter|PD|No
Jane|JE|Yes
Peter|PF|Yes ] (delimiter is '|');

FieldValueCount
FieldValueCount() es una funcin de entero que encuentra el nmero de valores distintos en un campo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 483


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

FieldValueCount(field_name)

Argumentos:

Argumento Descripcin

field_name Nombre del campo para el que se requiere el valor. Debe especificarse como valor de
cadena. Esto implica que el nombre del campo debe escribirse entre comillas simples.

Ejemplos y resultados:

El ejemplo siguiente utiliza dos campos: First name e Initials

Ejemplos Resultados
FieldValueCount('First name') 5 puesto que Peter aparece dos veces.
FieldValueCount('Initials') 6 puesto que Initials slo tiene valores distintos.

Datos utilizados en el ejemplo:

First name Initials

John JA

Sue SB

Mark MC

Peter PD

Jane JE

Peter PF

LookUp
Esta funcin de script devuelve el valor de fieldname correspondiente a la primera aparicin del valor
matchfieldvalue, en el campo matchfieldname.

Sintaxis:

lookup(fieldname, matchfieldname, matchfieldvalue [, tablename])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 484


5 Funciones en scripts y en expresiones de grfico

El orden de bsqueda es el orden de carga, a menos que la tabla sea el resultado de operaciones complejas,
como uniones entre diversas tablas, en cuyo caso el orden no estar bien definido. Tanto fieldname como
matchfieldname deben ser campos de una misma tabla, la cual viene especificada mediante tablename.

Si no se encuentra ninguna correspondencia, se devuelve NULL.

Argumentos:

Argumento Descripcin

fieldname Nombre del campo para devolver el valor. El valor de entrada debe suministrarse como
una cadena (por ejemplo, literales entrecomillados).

matchfieldname Nombre del campo en el que buscar matchfieldvalue. El valor de entrada debe
suministrarse como una cadena (por ejemplo, literales entrecomillados).

matchfieldvalue Valor que debe buscarse en el campo matchfieldname

tablename Nombre de la tabla. El valor de entrada debe suministrarse como una cadena (por
ejemplo, literales entrecomillados).

Si tablename se omite, se da por sentado que se trata de la tabla actual.

Ejemplo:

LookUp('Price', 'ProductID', InvoicedProd, 'pricelist')

NoOfRows - funcin de grfico


NoOfRows() devuelve el nmero de filas del segmento de columna actual en una tabla. Para los grficos en
modo mapa de bits, NoOfRows()devuelve el nmero de filas en el equivalente de la tabla simple.

Si la tabla o el equivalente de tabla tiene mltiples dimensiones verticales, el segmento de columna actual
incluir slo filas con los mismos valores que la fila actual en todas las columnas de dimensin excepto para
la columna que muestra la ltima dimensin en el orden de campo interno.

Sintaxis:

NoOfRows([TOTAL])

Tipo de datos devueltos: Entero

Argumentos:

Argumento Descripcin

TOTAL Si la tabla es uni-dimensional o si se usa el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 485


5 Funciones en scripts y en expresiones de grfico

if( RowNo( )= NoOfRows( ), 0, Above( sum( Sales )))

Vea tambin:

p RowNo - funcin de grfico (pgina 354)

Peek
Esta funcin de script devuelve los contenidos de fieldname en el registro especificado por row en la tabla
interna tablename. Los datos se recuperan desde la base de datos asociativa de Qlik Sense.

Sintaxis:

Peek(fieldname [ , row [ , tablename ] ] )

Argumentos:

Argumento Descripcin

Fieldname Debe suministrarse como una cadena (es decir, un texto literal entrecomillado).

Row Debe ser un entero. 0 indica el primer registro, 1 el segundo y as sucesivamente. Los
nmeros negativos indican un orden desde el final de la tabla. -1 indica el ltimo registro
ledo.

Si no se especifica row, se presupone -1.

Tablename Una etiqueta de tabla que no finaliza en dos puntos. Si no se establece tablename, se
asume la tabla actual. Si se utiliza fuera de la sentencia LOAD o referido a otra tabla,
habr de incluirse el nombre de tabla tablename.

Ejemplos y resultados:

Ejemplo Resultado

Peek('Sales' ) Devuelve el valor de Sales en el registro previo ledo (equivalente a


Previous(Sales)).

Peek('Sales', 2 ) Devuelve el valor de Sales desde el tercer registro ledo desde la


tabla interna actual.

Peek('Sales', -2 ) Devuelve el valor de Sales desde el segundo ltimo registro ledo


dentro de la tabla actual.

Peek('Sales', 0, 'Tab1' ) Devuelve el valor de Sales desde el primer registro ledo en la tabla
de entrada etiquetada como Tab1.

LOAD A, B, numsum(B, Peek( Crea una acumulacin de B en Bsum.


'Bsum' ) ) as Bsum...;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 486


5 Funciones en scripts y en expresiones de grfico

Previous
Esta funcin de script devuelve el valor de expression usando datos desde el registro previamente insertado
que no ha sido descartado debido a una clusula where. En el primer registro de una tabla interna, la funcin
devolver NULL.

Sintaxis:

Previous(expression )

La funcin previous puede anidarse para acceder a registros anteriores. Los datos se recuperan
directamente de la fuente de entrada; esto tambin hace posible consultar los campos que no se hayan
cargado en Qlik Sense, es decir, aunque no se hayan almacenado en la base de datos asociativa.

Ejemplos:

LOAD *, Sales / Previous(Sales) as Increase from ...;


LOAD A, Previous(Previous( A )) as B from ...;

Top - funcin de grfico


Top() evala una expresin situada en la primera fila (superior) de un segmento de columna en una tabla. La
fila para la que se calcula depende del valor de offset. Si est presente, se tomar de forma predeterminada
la fila superior. Para los grficos que no sean tablas, la evaluacin de Top()se realiza en la primera fila de la
columna actual en el equivalente de tabla simple del grfico.

Sintaxis:

Top([TOTAL] expr [ , offset [,count ]])

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

offset Especificar un offsetde n mayor que 1 nos permite mover la evaluacin de la expresin n
filas por debajo de la fila superior.

Especificar un nmero de offset (desplazamiento) negativo har que la funcin Top sea
equivalente a una funcin Bottom con el correspondiente nmero de offset positivo.

count Si se especifica un tercer parmetro count mayor que 1, la funcin devolver un rango de
valores count, uno por cada una de las ltimas filas count del segmento de columna
actual. De esta manera, la funcin puede utilizarse como argumento en cualquiera de las
funciones de rango especiales. Funciones de rango (pgina 494)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 487


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

TOTAL Si la tabla es uni-dimensional o si se usa el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Un segmento de columna se define como un subconjunto consecutivo de celdas que tienen


los mismos valores para las dimensiones de la ordenacin actual. Las funciones inter registro
se calculan en el segmento de columna excluida la dimensin ms a la derecha del grfico de
tabla simple equivalente. Si solo hay una dimensin en el grfico o si se especifica el
calificador TOTAL, la expresin se evala en toda la tabla.

Si la tabla o el equivalente de tabla tiene mltiples dimensiones verticales, el segmento de


columna actual incluir slo filas con los mismos valores que la fila actual en todas las
columnas de dimensin excepto para la columna que muestra la ltima dimensin en el orden
de campo interno.

Limitaciones:

Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:

Ejemplo: 1

En el pantallazo de la tabla mostrada en este ejemplo, la visualizacin de tabla se crea a partir de la


dimensin Customer y las medidas: Sum(Sales) y Top(Sum(Sales)).

La columna Top(Sum(Sales)) devuelve 587 para todas las filas porque ste es el valor de la fila superior:
Astrida.

La tabla tambin muestra medidas ms complejas: una creada a partir de Sum(Sales)+Top(Sum(Sales)) y otra
etiquetada Top offset 3, que se crea utilizando la expresin Sum(Sales)+Top(Sum(Sales), 3) y tiene el
argumento offset establecido en 3. Agrega el valor Sum(Sales) para la fila actual al valor de la tercera fila
desde la fila superior, es decir, la fila actual ms el valor de Canutility.

Ejemplo: 2

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 488


5 Funciones en scripts y en expresiones de grfico

En los pantallazos de la tablas mostradas en este ejemplo, se han aadido ms dimensiones a las
visualizaciones: Month y Product Para grficos con ms de una dimensin, los resultados de las
expresiones que contienen las funciones Above, Below, Top y Bottom dependen del orden en que Qlik
Sense clasifica las dimensiones de columna. Qlik Sense evala las funciones basndose en los segmentos
de columna que resultan de la dimensin que se ordena en ltimo lugar. El criterio de ordenacin de
columna se controla en el panel de propiedades bajo Ordenacin y no es necesariamente el orden en que
las columnas aparecen en una tabla.

Primera tabla para el ejemplo 2. El valor de Top para la medida First value basado en Month (Jan).

Segunda tabla para el ejemplo 2. El valor de Top para la medida First value basado en Product (AA
paraAstrida).

Le remitimos al Ejemplo: 2 de la funcin Above para obtener ms detalles.

Monthnames:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 489


5 Funciones en scripts y en expresiones de grfico

LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];
Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');
Para ordenar los meses correctamente cuando cree sus visualizaciones, dirjase a la seccin Ordenar del
panel de propiedades, seleccione Mes y active la casilla Ordenar por expresin. En el cuadro de
expresin, escriba Monthnumber.

Vea tambin:

p Bottom - funcin de grfico (pgina 471)

p Above - funcin de grfico (pgina 467)

p Sum - funcin de grfico (pgina 164)

p RangeAvg (pgina 497)

p Funciones de rango (pgina 494)

5.15 Funciones lgicas


En esta seccin se describen funciones de gestin de operaciones lgicas. Todas las funciones pueden
utilizarse tanto en el script de carga de datos como en las expresiones de grficos.

IsNum
Devuelve -1 (True) si la expresin se puede interpretar como un nmero, si no 0 (False).

IsNum( expr )

IsText
Devuelve -1 (True) si la expresin tiene una representacin de texto, si no 0 (False).

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 490


5 Funciones en scripts y en expresiones de grfico

IsText( expr )

5.16 Funciones de Correspondencia


En esta seccin se describen funciones de gestin de tablas de correspondencia. Las tablas de
correspondencias pueden utilizarse para reemplazar valores de campo o nombres de campo durante la
ejecucin de script.

Las funciones de correspondencia slo pueden utilizarse en el script de carga de datos.

Descripcin general de las funciones de Correspondencia


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

ApplyMap
Esta funcin de script sirve para enlazar (o mapear) cualquier expresin con una tabla de correspondencia
previamente cargada.

ApplyMap ('mapname', expr [ , defaultexpr ] )

MapSubstring
Esta funcin de script sirve para hacer corresponder (o mapear) partes de cualquier expresin con una tabla
de correspondencias previamente cargada. La correspondencia (o mapeado) es sensible a maysculas y no
repetitivo y las subcadenas se hacen corresponder de izquierda a derecha.

MapSubstring ('mapname', expr)

ApplyMap
Esta funcin de script sirve para enlazar (o mapear) cualquier expresin con una tabla de correspondencia
previamente cargada.

Sintaxis:

ApplyMap('mapname', expr [ , defaultexpr ] )

Argumentos:

Argumento Descripcin

mapname El nombre de una tabla de correspondencia que ha sido creada previamente mediante la
sentencia mapping load o la mapping select. Su nombre debe ir entre comillas
simples.

expr La expresin, el resultado de lo que debe mapearse o enlazarse.

defaultexpr Una expresin opcional que debe utilizarse como valor de enlace por defecto si la tabla de
correspondencia no contiene ningn valor que coincida con expr. Si no se da ningn valor
por defecto, el valor de expr se devolver tal cual.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 491


5 Funciones en scripts y en expresiones de grfico

Ejemplo:

// Assume the following mapping table:


map1:
mapping LOAD * inline [
x, y
1, one
2, two
3, three ] ;

ApplyMap ('map1', 2 ) devuelve "dos"

ApplyMap ('map1', 4 ) devuelve 4

ApplyMap ('map1', 5, 'xxx') devuelve "xxx"

ApplyMap ('map1', 1, 'xxx') devuelve "uno"

ApplyMap ('map1', 5, null( ) ) devuelve NULL

ApplyMap ('map1', 3, null( ) ) devuelve "tres"

MapSubstring
Esta funcin de script sirve para hacer corresponder (o mapear) partes de cualquier expresin con una tabla
de correspondencias previamente cargada. La correspondencia (o mapeado) es sensible a maysculas y no
repetitivo y las subcadenas se hacen corresponder de izquierda a derecha.

Sintaxis:

MapSubstring('mapname', expr)

Esta funcin puede emplearse para enlazar partes de cualquier expresin de una tabla de correspondencia
(o enlace) previamente cargada. El enlace es sensible a maysculas y no recursivo. Las subcadenas se
enlazan desde la izquierda hacia la derecha.

Argumentos:

Argumento Descripcin

mapname Es el nombre de una tabla de correspondencia leda previamente en una sentencia


mapping load o mapping select. El nombre debe ir entre comillas simples rectas. Expr
es la expresin cuyo resultado debe ser enlazado por las subcadenas.

Ejemplo:

// Assume the following mapping table:


map1:
mapping LOAD * inline [
x, y

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 492


5 Funciones en scripts y en expresiones de grfico

1, <one>
aa, XYZ
x, b ] ;

MapSubstring ('map1', 'A123') devuelve "A<one>23"

MapSubstring ('map1', 'baaar') devuelve "bXYZar"

MapSubstring ('map1', 'xaa1') devuelve "bXYZ<one>"

5.17 Constantes matemticas y funciones libres de


parmetros
En esta seccin se describen funciones para constantes matemticas y valor booleanos. Estas funciones no
tienen ningn parmetro, pero los parntesis siempre son necesarios.

Todas las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de
grficos.

e
Esta funcin devuelve la base de los logaritmos naturales, e.(2,71828...)

e( )

false
Devuelve un valor dual con valor de texto 'falso' y valor numrico 0, el cual puede ser usado como un false
lgico en las expresiones.

false( )

pi
La funcin devuelve el valor de (3,14159...)

pi( )

rand
Devuelve un nmero aleatorio entre 0 y 1.

rand( )

true
Devuelve un valor dual con valor de texto 'verdadero' y valor numrico -1, el cual puede utilizarse como un
true lgico en expresiones.

true( )

5.18 Funciones NULL


En esta seccin se describen funciones para devolver o detectar valores NULL.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 493


5 Funciones en scripts y en expresiones de grfico

Todas las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de
grficos.

Descripcin general de las funciones NULL


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Null
La funcin Null devuelve un valor NULL.

NULL( )

IsNull
La funcin IsNull evala si el valor del parmetro es NULL y, si lo es, devuelve -1 (True), si no, 0 (False).
Observe que una cadena de longitud cero no se considera un valor NULL y har que IsNull devuelva False.

IsNull (expr )

IsNull
La funcin IsNull evala si el valor del parmetro es NULL y, si lo es, devuelve -1 (True), si no, 0 (False).
Observe que una cadena de longitud cero no se considera un valor NULL y har que IsNull devuelva False.

Sintaxis:

IsNull(expr )

Ejemplo:

If(IsNull( x ), 0, x )

NULL
La funcin Null devuelve un valor NULL.

Sintaxis:

Null( )

Ejemplo:

If(len(trim(x))= 0 or x=NULL, Null(), x )

5.19 Funciones de rango


Todas las funciones de rango pueden utilizarse tanto en el script de carga de datos como en las expresiones
de grficos.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 494


5 Funciones en scripts y en expresiones de grfico

Las funciones de rango reemplazan a las siguientes funciones numricas generales:


numsum,numavg, numcount,nummin and nummax, las cuales han quedado obsoletas.

Funciones de rango bsicas


RangeMax
RangeMax() devuelve los valores numricos ms altos que encuentra en la expresin o campo.

RangeMax(first_expr {, Expression})

RangeMaxString
RangeMaxString() devuelve el ltimo valor en el orden de texto que encuentra en una expresin o campo.

RangeMaxString(first_expr {, Expression})

RangeMin
Min() devuelve los valores numricos ms bajos que encuentra en la expresin o campo.

RangeMin(first_expr {, Expression})

RangeMinString
RangeMinString() devuelve el primer valor en el orden de texto que encuentra en una expresin o campo.

RangeMinString(first_expr {, Expression})

RangeMode
RangeMode() halla el valor que ms veces aparece (valor de la moda) en la expresin o campo.

RangeMode(first_expr {, Expression})

RangeOnly
RangeOnly() es una funcin dual que devuelve un valor si la expresin evala a un nico valor. Si este no
es el caso entonces devuelve NULL.

RangeOnly(first_expr {, Expression})

RangeSum
RangeSum() devuelve la suma de un rango de valores. Todos los valores no numricos se tratan como 0, a
diferencia del operador + .

RangeSum(first_expr {, Expression})

Funciones de rango de contador


RangeCount
RangeCount()devuelve el nmero de valores, de texto y numricos que se encuentran dentro del rango o

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 495


5 Funciones en scripts y en expresiones de grfico

expresin especificados.

RangeCount(first_expr {, Expression})

RangeMissingCount
RangeMissingCount() halla el nmero de valores no numricos (incluidos los valores NULL) en una
expresin o campo.

RangeMissingCount(first_expr {, Expression})

RangeNullCount
RangeNullCount() halla el nmero de valores NULL en una expresin o campo.

RangeNullCount(first_expr {, Expression})

RangeNumericCount
RangeNumericCount() halla el nmero de valores numricos en una expresin o campo.

RangeNumericCount(first_expr {, Expression})

RangeTextCount
RangeTextCount() devuelve el nmero de valores de texto de una expresin o campo.

RangeTextCount(first_expr {, Expression})

Funciones de rango estadsticas


RangeAvg
RangeAvg() devuelve el promedio de un rango. Lo introducido en la funcin puede ser o bien un rango de
valores o una expresin.

RangeAvg(first_expr {, Expression})

RangeCorrel
RangeCorrel() devuelve el coeficiente de correlacin de dos conjuntos de datos. El coeficiente de
correlacin es una medida de la relacin entre los conjuntos de datos.

RangeCorrel(x_values , y_values {,Expression})

RangeFractile
RangeFractile() devuelve el valor que corresponde al ensimo percentil (cuantil) de un rango de nmeros.

RangeFractile(fractile, first_expr { ,Expression})

RangeKurtosis
RangeKurtosis() devuelve el valor que corresponde a la funcin kurtosis de un rango de nmeros.

RangeKurtosis(expr1 [ , expr2, ... exprN ])

RangeSkew

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 496


5 Funciones en scripts y en expresiones de grfico

RangeSkew() devuelve el valor que corresponde a la asimetra de un rango de nmeros.

RangeSkew(expr1 [ , expr2, ... exprN ])

RangeStdev
RangeStdev() halla la desviacin estndar de un rango de nmeros.

RangeStdev(expr1 [ , expr2, ... exprN ])

Vea tambin:

p Funciones inter-registro (pgina 464)

RangeAvg
RangeAvg() devuelve el promedio de un rango. Lo introducido en la funcin puede ser o bien un rango de
valores o una expresin.

Sintaxis:

RangeAvg(first_expr {, Expression})

Tipo de datos devueltos: numrico

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Ejemplos Resultados
RangeAvg (1,2,4) Devuelve 2,33333333
RangeAvg (1,'xyz') Devuelve 1
RangeAvg (null( ), 'abc') Devuelve NULL

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 497


5 Funciones en scripts y en expresiones de grfico

Ejemplo con expresin:

RangeAvg (MyField, Above(MyField), Above(Above(MyField)))

Devuelve una media mvil del resultado del rango de tres valores de MyField calculados en la fila actual y
dos filas ms arriba con respecto a la fila actual.

Datos empleados en los ejemplos:

MyField RangeAvg (Above(Above(MyField), Above(Above(MyField)))

10 10

2 6

8 6,666666667

18 9,333333333

5 10,33333333

9 10,66666667

RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] (delimiter is '|');

Vea tambin:

p Avg - funcin de grfico (pgina 196)

p Count - funcin de grfico (pgina 168)

RangeCorrel
RangeCorrel() devuelve el coeficiente de correlacin de dos conjuntos de datos. El coeficiente de
correlacin es una medida de la relacin entre los conjuntos de datos.

Sintaxis:

RangeCorrel(x_values , y_values {, Expression})

Tipo de datos devueltos: numrico

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 498


5 Funciones en scripts y en expresiones de grfico

Si introducimos los valores manualmente, debemos introducirlos como pares (x,y). Por ejemplo, para
evaluar dos series de datos: array 1 y array 2 donde el array 1 = 2,6,9 y array 2 = 3,8,4 tendramos que
escribir RangeCorrel (2,3,6,8,9,4) la cual devuelve 0,269.

Argumentos:

Argumento Descripcin

x-value, y- Cada valor representa un valor nico o un rango de valores devueltos por una funcin inter-
value registro con un tercer parmetro opcional (ver pgina). Cada valor o rango de valores debe
corresponder con un x-value o rango de y-values.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

La funcin necesita al menos dos pares de coordenadas para poder calcularse.

Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos y resultados:

Ejemplos Resultados
RangeCorrel (2,3,6,8,9,4) Devuelve 0,269

Vea tambin:

p Correl - funcin de grfico (pgina 199)

RangeCount
RangeCount()devuelve el nmero de valores, de texto y numricos que se encuentran dentro del rango o
expresin especificados.

Sintaxis:

RangeCount(first_expr {,Expression})

Tipo de datos devueltos: Entero

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 499


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Los valores NULL no se cuentan.

Ejemplos y resultados:

Ejemplos Resultados
RangeCount (1,2,4) Devuelve 3
RangeCount (2,'xyz') Devuelve 2
RangeCount (null( )) Devuelve 0
RangeCount (2,'xyz', null()) Devuelve 2

Ejemplo con expresin:

RangeCount (Above(Sum(MyField),1,3))
Devuelve el nmero de valores dentro de los tres resultados de la funcin Sum(MyField) sobre la fila actual.

Datos empleados en los ejemplos:

MyField RangeCount(Above(Sum(MyField),1,3))

23 0

63 1

74 2

89 3

44 3

54 3

Vea tambin:

p Count - funcin de grfico (pgina 168)

RangeFractile
RangeFractile() devuelve el valor que corresponde al ensimo percentil (cuantil) de un rango de nmeros.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 500


5 Funciones en scripts y en expresiones de grfico

Sintaxis:

RangeFractile(fractile, first_expr { ,Expression})

Tipo de datos devueltos: numrico

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

fractile Un nmero entre 0 y 1 correspondiente al percentil (cuantil expresado como fraccin) que
se debe calcular.

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeFractile (0.24,1,2,4,6) Devuelve 1,72
RangeFractile(0.5,1,2,3,4,6) Devuelve 3
RangeFractile (0.5,1,2,5,6) Devuelve 3,5

Ejemplo con expresin:

RangeFractile (0.5, Above(Sum(MyField),1,3))

Devuelve el percentil de un rango de valores de los tres resultados de la funcin Sum(MyField) encima de la
fila actual.

Datos empleados en los ejemplos:

MyField RangeFractile(0.5, Above(Sum(MyField),1,3))

1 -

2 1

3 2

4 3

6 3

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 501


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Fractile - funcin de grfico (pgina 201)

RangeIRR
Esta funcin de script devuelve la tasa de rendimiento interno de una serie de flujos de caja representados
por los nmeros en los valores. Estos flujos de efectivo no tienen por qu ser constantes y parejos, como lo
seran en una anualidad. Sin embargo, s que han de producirse a intervalos regulares, como por ejemplo,
en perodos mensuales o anuales. La tasa interna de devolucin es el ltimo tipo de inters recibido para una
inversin consistente en pagos (valores negativos) e ingresos (valores positivos) que se suceden durante
perodos regulares.

Sintaxis:

RangeIRR( value { ,value} )

Argumentos:

Argumento Descripcin

Value Un nico valor, o un rango de valores, devueltos por una funcin inter-registro con un tercer
parmetro opcional. La funcin necesita al menos un valor positivo y otro negativo para
poder calcular. Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos:

RangeIRR(-70000,12000,15000,18000,21000,26000) devuelve 0,0866

RangeIRR(above(sum(value), 0, 10))
RangeIRR(above(total value, 0, rowno(total)))

Vea tambin:

p Funciones inter-registro (pgina 464)

RangeKurtosis
RangeKurtosis() devuelve el valor que corresponde a la funcin kurtosis de un rango de nmeros.

Sintaxis:

RangeKurtosis(first_expr { ,Expression})

Tipo de datos devueltos: numrico

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 502


5 Funciones en scripts y en expresiones de grfico

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Ejemplos Resultados
RangeKurtosis Devuelve -0,28571428571429
(1,2,4,7)

RangeKurtosis (Above Devuelve una kurtosis mvil del resultado de la expresin count(MyField)
(Count(MyField),0,3))
interna calculada en la fila actual y dos filas por encima de la fila actual.

Datos empleados en los ejemplos:

RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] (delimiter is '|');

Vea tambin:

p Kurtosis - funcin de grfico (pgina 203)

RangeMax
RangeMax() devuelve los valores numricos ms altos que encuentra en la expresin o campo.

Sintaxis:

RangeMax(first_expr { , Expression})

Tipo de datos devueltos: numrico

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 503


5 Funciones en scripts y en expresiones de grfico

Argumentos:

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Ejemplos Resultados
RangeMax (1,2,4) Devuelve 4
RangeMax (1,'xyz') Devuelve 1
RangeMax (null( ), 'abc') Devuelve NULL

Ejemplo con expresin:

RangeMax (Above(Sum(MyField),1,3))

Devuelve el mayor de los tres resultados de la funcin Sum(MyField) por encima de la fila actual.

La primera fila devolver NULL porque no hay ninguna fila por encima de ella sobre la que agregar.

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField RangeMax (Above(Sum(MyField),1,3))

10 -

2 10

8 10

18 10

5 18

9 18

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 504


5 Funciones en scripts y en expresiones de grfico

Datos empleados en los ejemplos:

RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] (delimiter is '|');

RangeMaxString
RangeMaxString() devuelve el ltimo valor en el orden de texto que encuentra en una expresin o campo.

Sintaxis:

RangeMaxString(first_expr { , Expression})

Tipo de datos devueltos: cadena

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeMaxString (1,2,4) Devuelve 4

RangeMaxString ('xyz','abc') Devuelve 'xyz'


RangeMaxString (5,'abc') Devuelve 'abc'
RangeMaxString (null( )) Devuelve NULL

Ejemplo con expresin:

RangeMaxString (Above(MaxString(MyField),0,3))

Devuelve el ltimo (en el orden del texto) de los tres resultados de la funcin MaxString(MyField) evaluada
en la fila actual y dos filas por encima de la fila actual.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 505


5 Funciones en scripts y en expresiones de grfico

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField RangeMaxString(Above(MaxString(MyField),0,3))

10 10

abc abc

8 abc

def def

xyz xyz

9 xyz

Vea tambin:

p MaxString - funcin de grfico (pgina 336)

RangeMin
Min() devuelve los valores numricos ms bajos que encuentra en la expresin o campo.

Sintaxis:

RangeMin(first_expr {,Expression})

Tipo de datos devueltos: numrico

Argumentos:

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 506


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados
RangeMin (1,2,4) Devuelve 1
RangeMin (1,'xyz') Devuelve 1
RangeMin (null( ), 'abc') Devuelve NULL

Ejemplo con expresin:

RangeMin (Above(Sum(MyField),0,3))

Devuelve el menor de los tres resultados de la funcin Sum(MyField) evaluada en la fila actual y dos filas
por encima de la fila actual.

MyField RangeMin(Above(Sum(MyField),0,3))

10 10

2 2

8 2

18 2

5 5

9 5

Datos empleados en los ejemplos:

RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] (delimiter is '|');

Vea tambin:

p Min - funcin de grfico (pgina 156)

RangeMinString
RangeMinString() devuelve el primer valor en el orden de texto que encuentra en una expresin o campo.

Sintaxis:

RangeMinString(first_expr {, Expression})

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 507


5 Funciones en scripts y en expresiones de grfico

Tipo de datos devueltos: cadena

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeMinString (1,2,4) Devuelve 1
RangeMinString ('xyz','abc') Devuelve 'abc'
RangeMinString (5,'abc') Devuelve 5
RangeMinString (null( )) Devuelve NULL

Ejemplo con expresin:

RangeMinString (Above(MinString(MyField),0,3))

Devuelve el primero (en el criterio de ordenacin del texto) de los tres resultados de la funcin MinString
(MyField) evaluada en la fila actual y dos filas por encima de la fila actual.

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField RangeMinString(Above(MinString(MyField),0,3))

10 10

abc 10

8 8

def 8

xyz 8

9 9

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 508


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p MinString - funcin de grfico (pgina 338)

RangeMissingCount
RangeMissingCount() halla el nmero de valores no numricos (incluidos los valores NULL) en una
expresin o campo.

Sintaxis:

RangeMissingCount(first_expr {, Expression})

Tipo de datos devueltos: Entero

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeMissingCount (1,2,4) Devuelve 0
RangeMissingCount (5,'abc') Devuelve 1
RangeMissingCount (null( )) Devuelve 1

Ejemplo con expresin:

RangeMissingCount (Above(MinString(MyField),0,3))

Devuelve el nmero de valores no numricos que encuentre en los tres resultados de la funcin MinString
(MyField) evaluada en la fila actual y dos filas por encima de la fila actual.

Datos empleados en los ejemplos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 509


5 Funciones en scripts y en expresiones de grfico

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField RangeMissingCount(Above(MinString(MyField),0,3))

10 Devuelve 2 porque no hay filas por encima de esta fila as que 2 de los 3 valores faltan.

abc Devuelve 2 porque slo hay 1 fila por encima de la fila actual y la fila actual es no numrica
('abc').

8 Devuelve 1 porque 1 de las 3 filas incluye un valor no numrico ('abc').

def Devuelve 2 porque 2 de las 3 filas incluyen valores no numricos ('def' y 'abc').

xyz Devuelve 2 porque 2 de las 3 filas incluyen valores no numricos (' xyz' y 'def').

9 Devuelve 2 porque 2 de las 3 filas incluyen valores no numricos (' xyz' y 'def').

Vea tambin:

p MissingCount - funcin de grfico (pgina 171)

RangeMode
RangeMode() halla el valor que ms veces aparece (valor de la moda) en la expresin o campo.

Sintaxis:

RangeMode(first_expr {, Expression})

Tipo de datos devueltos: numrico

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si ms de un valor comparte la frecuencia ms alta, devuelve NULL.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 510


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplos Resultados
RangeMode (1,2,9,2,4) Devuelve 2
RangeMode ('a',4,'a',4) Devuelve NULL
RangeMode (null( )) Devuelve NULL

Ejemplo con expresin:

RangeMode (Above(Sum(Temperature),0,3))

Devuelve el valor que se da con mayor frecuencia en los tres resultados de la funcin Sum(Temperature)
evaluada en la fila actual y dos filas por encima de la fila actual.

Datos utilizados en el ejemplo:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

Region City Temperature RangeMode(Above(Sum(Temperature),0,3))

A A 18 18

A B 17 -

A C 16 -

A D 18 -

A E 16 16

A F 20 -

A G 22 -

A H 20 20

Ejemplo con una expresin en un nico campo con Sum():

RangeMode (Above(Sum(MyField),0,3))

Devuelve el valor que se da con mayor frecuencia en los tres resultados de la funcin Sum(MyField)
evaluada en la fila actual y dos filas por encima de la fila actual.

Datos utilizados en el ejemplo:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 511


5 Funciones en scripts y en expresiones de grfico

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

Sum
MyField RangeMode(Above(Sum(MyField),0,3))
(MyField)

10 10 Devuelve 10 porque no hay filas por encima as que el valor nico es el que
aparece con mayor frecuencia.

2 2

8 8

18 18

5 5

9 18 Devuelve 18 porque RangeMode est evaluando Sum(MyField) donde 18


aparece dos veces en 3 filas.

7 7

El orden de carga debe mantenerse en la tabla simple.

angeTemp:
LOAD * INLINE [
Region|City|Temperature
A|A|18
A|B|17
A|C|16
A|D|18
A|E|16
A|F|20
A|G|22
A|H|20
] (delimiter is '|');

Vea tambin:

p Mode - funcin de grfico (pgina 159)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 512


5 Funciones en scripts y en expresiones de grfico

RangeNPV
Esta funcin de script devuelve el valor actual neto de una inversin basada en un tipo (rate) de descuento y
una serie de pagos futuros (valores negativos) e ingresos (valores positivos). El resultado tiene un formato
numrico predeterminado en money.

Sintaxis:

RangeNPV ( rate, value { ,value} )

Argumentos:

Argumento Descripcin

rate Es el tipo de inters por periodo.

value Es un pago o ingreso que tiene lugar al final de cada periodo. Cada valor es un valor nico
o un rango de valores devueltos por una funcin inter-registro con un tercer parmetro
opcional. Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos:

RangeNPV(0.1,-10000,3000,4200,6800) devuelve 1188,44

RangeNPV(0.05, above(sum(value), 0, 10))


RangeNPV(0.05, above(total value, 0, rowno(total)))

Vea tambin:

p Funciones inter-registro (pgina 464)

RangeNullCount
RangeNullCount() halla el nmero de valores NULL en una expresin o campo.

Sintaxis:

RangeNullCount(firstexpr [,Expression})

Tipo de datos devueltos: Entero

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 513


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeNullCount (1,2,4) Devuelve 0
RangeNullCount (5,'abc') Devuelve 0
RangeNullCount (null( ), null( )) Devuelve 2

Ejemplo con expresin:

RangeNullCount (Above(Sum(MyField),0,3))

Devuelve el nmero de valores NULL que encuentre en los tres resultados de la funcin Sum(MyField)
evaluada en la fila actual y dos filas por encima de la fila actual.

Datos empleados en los ejemplos:

Copiar MyField en el ejemplo siguiente no dar como resultado un valor NULL.

MyField RangeNullCount(Above(Sum(MyField),0,3))

10 Devuelve 2 porque no hay filas por encima de esta fila as que 2 de los 3 valores faltan
(=NULL).

2 Devuelve 1 porque solo hay 1 fila por encima de la fila actual as que 1 de los 3 valores falta
(=NULL).

8 Devuelve 1 porque 1 de las 3 filas incluye un valor no numrico ('abc').

null Devuelve 1 porque la fila actual es un valor NULL.

5 Devuelve 1 porque la fila superior es un valor NULL.

9 Devuelve 1 porque el valor 2 filas por encima de la fila actual es un valor NULL.

Vea tambin:

p NullCount - funcin de grfico (pgina 174)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 514


5 Funciones en scripts y en expresiones de grfico

RangeNumericCount
RangeNumericCount() halla el nmero de valores numricos en una expresin o campo.

Sintaxis:

RangeNumericCount(first_expr {, Expression})

Tipo de datos devueltos: Entero

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeNumericCount (1,2,4) Devuelve 3
RangeNumericCount (5,'abc') Devuelve 1
RangeNumericCount (null( )) Devuelve 0

Ejemplo con expresin:

RangeNumericCount (Above(MaxString(MyField),0,3))

Devuelve el nmero de valores numricos que encuentre en los tres resultados de la funcin MaxString
(MyField) evaluada en la fila actual y dos filas por encima de la fila actual.

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField RangeNumericCount(Above(MaxString(MyField),0,3))

10 1

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 515


5 Funciones en scripts y en expresiones de grfico

MyField RangeNumericCount(Above(MaxString(MyField),0,3))

abc 1

8 2

def 1

xyz 1

9 1

Vea tambin:

p NumericCount - funcin de grfico (pgina 176)

RangeOnly
RangeOnly() es una funcin dual que devuelve un valor si la expresin evala a un nico valor. Si este no
es el caso entonces devuelve NULL.

Sintaxis:

RangeOnly(first_expr {, Expression})

Tipo de datos devueltos: dual

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeOnly (1,2,4) Devuelve NULL
RangeOnly (5,'abc') Devuelve NULL
RangeOnly (null( ), 'abc') Devuelve 'abc'
RangeOnly(10,10,10) Devuelve 10

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 516


5 Funciones en scripts y en expresiones de grfico

Ejemplo con expresin:

RangeOnly (Above(Sum(MyField),0,3))

Devuelve un valor si los tres resultados de la funcin Sum(MyField) evaluada en la fila actual y dos filas por
encima de la fila actual contienen exactamente un valor.

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

Sum
MyField RangeOnly(Above(Sum(MyField),0,3))
(MyField)

10 10 Devuelve 10 porque no hay filas por encima de esta fila as que 2 de los 3
valores faltan (=NULL).

abc 0

8 8

def 0

xyz 0

9 9

Vea tambin:

p Only - funcin de grfico (pgina 161)

RangeSkew
RangeSkew() devuelve el valor que corresponde a la asimetra de un rango de nmeros.

Sintaxis:

RangeSkew(first_expr{,Expression})

Tipo de datos devueltos: numrico

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 517


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Ejemplos Resultados
rangeskew (1,2,4) Devuelve 0,93521952958283
rangeskew (above Devuelve una asimetra mvil del resultado de la expresin count(x) interna
(count(x),0,3))
calculada en la fila actual y dos filas ms arriba de la fila actual.

Datos utilizados en el ejemplo:

CustID RangeSkew(SalesValue, Above(SalesValue, Above(Above(SalesValue)))

1-20 -, -, 0,5676, 0,8455, 1,0127, -0,8741, 1,7243, -1,7186, 1,5518, 1,4332, 0,

1,1066, 1,3458, 1,5636, 1,5439, 0,6952, -0,3766

SalesTable:
LOAD recno() as CustID, * inline [
SalesValue
101
163
126
139
167
86
83
22
32
70
108
124
176
113
95
32
42
92
61
21
] ;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 518


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Skew - funcin de grfico (pgina 226)

RangeStdev
RangeStdev() halla la desviacin estndar de un rango de nmeros.

Sintaxis:

RangeStdev(first_expr{,Expression})

Tipo de datos devueltos: numrico

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

Si no se encuentra valor numrico alguno, devuelve NULL.

Ejemplos y resultados:

Ejemplos Resultados
RangeStdev Devuelve 1,5275252316519
(1,2,4)

RangeStdev (null( Devuelve NULL


))

RangeStdev (above Devuelve una desviacin estndar mvil del resultado de la expresin count(x)
(count(x),0,3))
interna calculada en la fila actual y dos filas ms arriba de la fila actual.

Datos utilizados en el ejemplo:

CustID RangeStdev(SalesValue, Above(SalesValue, Above(Above(SalesValue)))

1-20 -,43,841, 34,192, 18,771, 20,953, 41,138, 47,655, 36,116, 32,716, 25,325,

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 519


5 Funciones en scripts y en expresiones de grfico

CustID RangeStdev(SalesValue, Above(SalesValue, Above(Above(SalesValue)))

38000, 27,737, 35,553, 33,650, 42,532, 33,858, 32,146, 25,239, 35,595

SalesTable:
LOAD recno() as CustID, * inline [
SalesValue
101
163
126
139
167
86
83
22
32
70
108
124
176
113
95
32
42
92
61
21
] ;

Vea tambin:

p Stdev - funcin de grfico (pgina 228)

RangeSum
RangeSum() devuelve la suma de un rango de valores. Todos los valores no numricos se tratan como 0, a
diferencia del operador + .

Sintaxis:

RangeSum(first_expr {,Expression})

Tipo de datos devueltos: numrico

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 520


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:

La funcin RangeSum trata todos los valores no-numricos como 0, a diferencia del operador + .

Ejemplos y resultados:

Ejemplos Resultados
RangeSum (1,2,4) Devuelve 7
RangeSum (5,'abc') Devuelve 5
RangeSum (null( )) Devuelve 0

Ejemplo con expresin:

RangeSum (Above(Sum(MyField),0,3))

Devuelve la suma de los tres resultados de la funcin Sum(MyField) evaluada en la fila sobre la fila actual y
dos filas por encima de la fila actual.

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField Sum(MyField) RangeSum(Above(Sum(MyField),0,3))

10 10 10

abc 0 10

8 8 18

def 0 8

xyz 0 8

9 9 9

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 521


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Sum - funcin de grfico (pgina 164)

RangeTextCount
RangeTextCount() devuelve el nmero de valores de texto de una expresin o campo.

Sintaxis:

RangeTextCount(first_expr {, Expression})

Tipo de datos devueltos: Entero

Argumentos:

Las expresiones de los argumentos de esta funcin pueden contener funciones inter-registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.

Argumento Descripcin

first_expr La expresin o el campo que contiene los datos que se han de medir.

Expression Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Ejemplos y resultados:

Ejemplos Resultados
RangeTextCount (1,2,4) Devuelve 0
RangeTextCount (5,'abc') Devuelve 1
RangeTextCount (null( )) Devuelve 0

Ejemplo con expresin:

RangeTextCount (Above(MaxString(MyField),0,3))

Devuelve el nmero de valores de texto que encuentre dentro de los tres resultados de la funcin MaxString
(MyField) evaluada en la fila por debajo de la actual, la fila actual y la fila superior a la fila actual.

Datos empleados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 522


5 Funciones en scripts y en expresiones de grfico

MyField MaxString(MyField) RangeTextCount(Above(Sum(MyField),0,3))

10 10 0

abc abc 1

8 8 1

def def 2

xyz xyz 2

9 9 2

Vea tambin:

p TextCount - funcin de grfico (pgina 178)

RangeXIRR
Esta funcin de script devuelve la tasa interna de rendimiento de un plan de flujos de caja que no tienen por
qu ser necesariamente peridicos. Para calcular la tasa de rendimiento interno de una serie de flujos de
caja peridicos, utilice la funcin RangeIRR.

Sintaxis:

RangeXIRR(value, date { ,value, date} )

Argumentos:

Argumento Descripcin

value Un flujo de caja o una serie de flujos de caja correspondientes a una planificacin de pagos
por fechas. Cada valor es un valor nico o un rango de valores devueltos por una funcin
inter-registro con un tercer parmetro opcional. Los valores de texto, los valores NULL y los
valores perdidos se descartan. Todos los pagos son descontados segn una base de un
ao de 365 das. La serie de valores deber contener al menos un valor positivo y otro
negativo.

date Una fecha de pago o una planificacin de pagos en varias fechas, que se corresponde con
los pagos de los flujos de caja.

Ejemplos:

RangeXIRR(-2500,'2008-01-01',2750,'2008-09-01') returns 0,1532

RangeXIRR (above(sum(value), 0, 10), above(date, 0, 10))


RangeXIRR(above(total value,0,rowno(total)),
above(total date,0,rowno(total)))

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 523


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p RangeIRR (pgina 502)

RangeXNPV
Esta funcin de script devuelve el valor actual neto de una planificacin de flujos de caja que no es
necesariamente peridico. El resultado tiene un formato numrico predeterminado de moneda. Para
calcular el valor actual neto de una serie de flujos de caja peridicos, utilice la funcin RangeNPV.

Sintaxis:

RangeXNPV(rate, value, date { ,value, date} )

Argumentos:

Argumento Descripcin

rate Es el tipo de inters por periodo.

value Un flujo de caja o una serie de flujos de caja correspondientes a una planificacin de pagos
por fechas. Cada valor es un valor nico o un rango de valores devueltos por una funcin
inter-registro con un tercer parmetro opcional. Los valores de texto, los valores NULL y los
valores perdidos se descartan. Todos los pagos son descontados segn una base de un
ao de 365 das. La serie de valores deber contener al menos un valor positivo y otro
negativo.

date Una fecha de pago o una planificacin de pagos en varias fechas, que se corresponde con
los pagos de los flujos de caja.

Ejemplos:

RangeXNPV(0.1, -2500,'2008-01-01',2750,'2008-09-01') returns 80,25

RangeXNPV(0.1, above(sum(value), 0, 10), above(date, 0, 10))


RangeXNPV(0.1, above(total value,0,rowno(total)),

5.20 Funciones de ranking en grficos


Estas funciones slo pueden emplearse en expresiones de grficos.

Suprimir valores cero se desactiva automticamente cuando se utilizan dichas funciones. Los
valores nulos NULL se descartan.

Rank

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 524


5 Funciones en scripts y en expresiones de grfico

Rank() evala las filas del grfico en la expresin y muestra, por cada fila, la posicin relativa del valor de la
dimensin evaluada en la expresin. Esta funcin, cuando evala la expresin, compara el resultado con el
resultado de las otras filas que contienen el segmento de columna actual y devuelve la clasificacin de la fila
actual dentro del segmento.

Rank - funcin de grfico([TOTAL [<fld {, fld}>]] expr[, mode[, fmt]])

VRank
VRank() realiza la misma funcin que la funcin Rank. Se puede utilizar cualquiera de ellas.

VRank - funcin de grfico([TOTAL [<fld {,fld}>]] expr[, mode[, fmt]])

Rank - funcin de grfico


Rank() evala las filas del grfico en la expresin y muestra, por cada fila, la posicin relativa del valor de la
dimensin evaluada en la expresin. Esta funcin, cuando evala la expresin, compara el resultado con el
resultado de las otras filas que contienen el segmento de columna actual y devuelve la clasificacin de la fila
actual dentro del segmento.

Para grficos que no sean tablas, se define el segmento de columna actual segn su apariencia en su
equivalente en la tabla simple.

Sintaxis:

Rank([TOTAL [<fld {, fld}>]] expr[, mode[, fmt]])

Tipo de datos devueltos: dual

Argumentos:

Argumento Descripcin

expr La expresin o el campo que contiene los datos que se han de medir.

mode Especifica la representacin numrica del resultado de la funcin.

fmt Especifica la representacin de texto del resultado de la funcin.

TOTAL Si el grfico es de una dimensin o si la expresin va precedida por el cualificador TOTAL,


la funcin se evaluar en toda la columna. Si la tabla o el equivalente de tabla tiene
mltiples dimensiones verticales, el segmento de columna actual incluir solo filas con los
mismos valores que la fila actual en todas las columnas de dimensin excepto la columna
que muestra la ltima dimensin en el orden de campo interno.

El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.

El ranking se devuelve como un valor dual, el cual, en el caso de que cada fila tenga una clasificacin nica
ser un entero entre 1 y el nmero de filas del segmento de columna actual.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 525


5 Funciones en scripts y en expresiones de grfico

En caso de que varias filas compartan un mismo ranking, el texto y la representacin numrica pueden
controlarse mediante los parmetros mode y fmt de la siguiente manera:

mode
El segundo argumento, mode, puede tomar los siguientes valores:

Valor Descripcin

0 (por defecto) Si todos los rangos dentro del grupo compartido caen dentro del extremo ms
bajo del valor de en medio del ranking entero, todas las filas reciben el rango
menor dentro del grupo compartido.

Si todos los rangos dentro del grupo compartido caen dentro del extremo ms
alto del valor de en medio del ranking entero, todas las filas reciben el rango
menor dentro del grupo compartido.

Si todos los rangos dentro del grupo compartido se salen del valor central del
ranking completo, todas las filas reciben el valor correspondiente a la media
del ranking superior e inferior en el segmento de columna completo.

1 Rango ms bajo en todas las filas.

2 Rango promedio en todas las filas.

3 Rango ms alto en todas las filas.

4 Rango ms bajo en la primera fila, incrementado por uno para cada fila.

fmt
El tercer argumento, fmt, puede tomar los siguientes valores:

Valor Descripcin

0 (por defecto) Valor bajo &' - '& valor alto en todas las filas (por ejemplo 3 - 4).

1 Valor bajo en todas las filas.

2 Valor ms bajo en la primera fila, espacio en blanco en las siguientes filas.

El orden de las filas para el mode 4 y fmt 2 viene determinado por el orden de las dimensiones de grfico.

Ejemplos y resultados:

Cree dos visualizaciones a partir de las dimensiones Product y Sales, as como otra a partir de Product y
UnitSales. Agregue medidas tal como se muestra en la tabla siguiente.

Ejemplos Resultados

Cree una El resultado depende del orden de las dimensiones. Si la tabla est ordenada por
tabla con las Customer, la tabla lista todos los valores de Sales para Astrida, despus Betacab, etc. Los
dimensiones resultados de Rank(Sales) mostrarn 10 para el valor 12 de Sales, 9 para el valor 13 de

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 526


5 Funciones en scripts y en expresiones de grfico

Ejemplos Resultados

y Sales y la Sales, etc., con el valor de rango de 1 devuelto para el valor 78 de Sales. Observe que
medida Rank aunque incluso hay 12 valores de Sales, slo se muestran 11 filas, porque dos valores de
(Sales)) Sales son el mismo (78). El siguiente segmento de columna comienza por Betacab, para
el que el primer valor de Sales en el segmento es 12. El valor de rango de Rank(Sales)
para esto viene dado como 11.

Si la tabla se ordena por Sales, los segmentos de columna consisten en los valores de
Sales y el correspondiente cliente Customer. Como hay dos valores de 12 Sales (para
Astrida y Betacab), el valor de Rank(Sales) para ese segmento de columna es de 1-2, para
cada valor de Customer. Esto es porque hay dos valores de Customer para el valor 12 de
Sales. Si hubiera habido 4 valores, el resultado sera 1-4 para todas las filas. Esto muestra
el aspecto que tendr el resultado para el valor por defecto (0) del argumento fmt.

Reemplace Esto devuelve el valor 1 en la primera fila de cada segmento de columna con las dems
la dimensin filas en blanco, ya que los argumentos mode y fmt estn configurados con los valores 1 y
Customer 2 respectivamente.
por Product
y aada la
medida Rank
(Sales,1,2)

Datos empleados en los ejemplos:

ProductData:
Load * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD|0|25
Canutility|AA|8|15
Canutility|CC|0|19
] (delimiter is '|');

Sales2013:
crosstable (Month, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');

Vea tambin:

p VRank - funcin de grfico (pgina 528)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 527


5 Funciones en scripts y en expresiones de grfico

p Sum - funcin de grfico (pgina 164)

VRank - funcin de grfico


VRank() realiza la misma funcin que la funcin Rank. Se puede utilizar cualquiera de ellas.

Sintaxis:

VRank([TOTAL [<fld {,fld}>]] expr[, mode[, fmt]])

Tipo de datos devueltos: dual

Vea tambin:

p Rank - funcin de grfico (pgina 525)

5.21 Funciones de distribucin estadstica


Las funciones de distribucin estadstica que se describen a continuacin se implementan todas en Qlik
Sense mediante la librera Cephes. Para referencias y detalles sobre los algoritmos utilizados, grado de
exactitud, etc., consultehttp://www.netlib.org/cephes/. La librera de funciones Cephes se utiliza bajo
permiso.

Todas las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de
grficos.

Descripcin general de las funciones de distribucin estadstica


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

CHIIDIST
Esta funcin devuelve la probabilidad de cola 1 de distribucin de chi2. La distribucin chi2 se asocia a una
prueba chi2.

CHIDIST (value, degrees_freedom)

CHIINV
Esta funcin devuelve el inverso de la probabilidad de cola uno de la distribucin de chi2 distribution.

CHIINV (prob, degrees_freedom)

NORMDIST
Esta funcin devuelve la distribucin normal acumulativa de la media y la desviacin estndar especificadas.
Si mean = 0 y standard_dev = 1, la funcin devuelve la distribucin normal estndar.

NORMDIST (value, mean, standard_dev)

NORMINV

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 528


5 Funciones en scripts y en expresiones de grfico

Esta funcin devuelve el inverso de la distribucin acumulativa normal de la media y la desviacin estndar
especificadas.

NORMINV (prob, mean, standard_dev)

TDIST
Esta funcin devuelve la probabilidad de distribucin t de student, en la que un valor numrico es un valor
calculado de t para el cual hay que calcular la probabilidad.

TDIST (value, degrees_freedom, tails)

TINV
Esta funcin devuelve el valor t de la distribucin t de student como una funcin de la probabilidad y los
grados de libertad.

TINV (prob, degrees_freedom)

FDIST
Esta funcin devuelve la distribucin F.

FDIST (value, degrees_freedom1, degrees_freedom2)

FINV
Esta funcin devuelve el inverso de la distribucin F.

FINV (prob, degrees_freedom1, degrees_freedom2)

CHIDIST
Esta funcin devuelve la probabilidad de cola 1 de distribucin de chi2. La distribucin chi2 se asocia a una
prueba chi2.

Sintaxis:

CHIDIST (value, degrees_freedom)

Esta funcin se relaciona con la funcin CHIINV de la siguiente manera:

If prob = CHIDIST(value,df), then CHIINV(prob, df) = value.

Argumentos:

Argumento Descripcin

value Es el valor con el cual se desea evaluar la distribucin. El valor no debe ser negativo.

degrees_ Es un entero positivo que indica el nmero de grados de libertad. Ambos argumentos
freedom deben ser numricos; si no, se devuelve NULL.

Ejemplos y resultados:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 529


5 Funciones en scripts y en expresiones de grfico

Ejemplo Resultado

CHIDIST(8, 15 ) Devuelve 0,9237827

CHIINV
Esta funcin devuelve el inverso de la probabilidad de cola uno de la distribucin de chi2 distribution.

Sintaxis:

CHIINV (prob, degrees_freedom)

Esta funcin se relaciona con la funcin CHIDIST de la siguiente manera:

If prob = chidist(value,df), then chiinv(prob, df) = value.

Argumentos:

Argumento Descripcin

prob Es una probabilidad asociada con la distribucin chi2. Debe ser un nmero ente 0 y 1.

degrees_freedom Es un entero que indica el nmero de grados de libertad.

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

CHIINV(0.9237827, 15 ) Devuelve 8,0000001

FDIST
Esta funcin devuelve la distribucin F.

Sintaxis:

FDIST(value, degrees_freedom1, degrees_freedom2)

Esta funcin se relaciona con la funcin FINV de la siguiente manera:

If prob = FDIST(value, df1, df2), then FINV(prob, df1, df2) = value.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 530


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

value Es el valor con el cual se desea evaluar la distribucin. Value no debe ser negativo.

degrees_freedom1 Es un entero positivo que indica el nmero de grados de libertad del numerador.

degrees_freedom2 Es un entero positivo que indica el nmero de grados de libertad del denominador.

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

FDIST(15, 8, 6 ) Devuelve 0,0019369

FINV
Esta funcin devuelve el inverso de la distribucin F.

Sintaxis:

FINV (prob, degrees_freedom1, degrees_freedom2)

Esta funcin se relaciona con la funcin FDIST de la siguiente manera:

If prob = fdist(value, df1, df2), then finv(prob, df1, df2) = value.

Argumentos:

Argumento Descripcin

prob Es una probabilidad asociada con la distribucin F y debe ser un nmero entre 0 y 1.

degrees_freedom Es un entero que indica el nmero de grados de libertad.

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

FINV(0.0019369, 8, 5 ) Devuelve 15,0000197

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 531


5 Funciones en scripts y en expresiones de grfico

NORMDIST
Esta funcin devuelve la distribucin normal acumulativa de la media y la desviacin estndar especificadas.
Si mean = 0 y standard_dev = 1, la funcin devuelve la distribucin normal estndar.

Sintaxis:

NORMDIST(value, mean, standard_dev)

Esta funcin se relaciona con la funcin NORMINV de la siguiente manera:

If prob = normdist(value, m, sd), then norminv(prob, m, sd) = value.

Argumentos:

Argumento Descripcin

value Es el valor con el cual se desea evaluar la distribucin.

mean Es un valor que indica la media aritmtica para la distribucin.

standard_dev Es un valor positivo que muestra la desviacin estndar de la distribucin.

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

NORMDIST(0.5, 0, 1 ) Devuelve 0,691462

NORMINV
Esta funcin devuelve el inverso de la distribucin acumulativa normal de la media y la desviacin estndar
especificadas.

Sintaxis:

NORMINV (prob, mean, standard_dev)

Esta funcin se relaciona con la funcin NORMDIST de la siguiente manera:

If prob = NORMDIST(value, m, sd), then NORMINV(prob, m, sd) = value.

Argumentos:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 532


5 Funciones en scripts y en expresiones de grfico

Argumento Descripcin

prob Es una probabilidad asociada con la distribucin normal. Debe ser un nmero ente 0 y 1.

mean Es un valor que indica la media aritmtica para la distribucin.

standard_dev Es un valor positivo que muestra la desviacin estndar de la distribucin.

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

NORMINV(0.6914625, 0, 1 ) Devuelve 0,4999717

TDIST
Esta funcin devuelve la probabilidad de distribucin t de student, en la que un valor numrico es un valor
calculado de t para el cual hay que calcular la probabilidad.

Sintaxis:

TDIST (value, degrees_freedom, tails)

Esta funcin se relaciona con la funcin TINV de la siguiente manera:

If prob = tdist(value, df ,2), then tinv(prob, df) = value.

Argumentos:

Argumento Descripcin

value Es el valor conforme al cual se desea evaluar la distribucin y no debe ser negativo.

degrees_freedom Es un entero positivo que indica el nmero de grados de libertad.

tails Debe ser o 1 (distribucin de cola uno) o 2 (distribucin de cola dos).

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

chdist(1, 30, 2 ) Devuelve 0,3253086

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 533


5 Funciones en scripts y en expresiones de grfico

TINV
Esta funcin devuelve el valor t de la distribucin t de student como una funcin de la probabilidad y los
grados de libertad.

Sintaxis:

TINV (prob, degrees_freedom)

Esta funcin se relaciona con la funcin TDIST de la siguiente manera:

If prob = tdist(value, df ,2), then tinv(prob, df) = value.

Argumentos:

Argumento Descripcin

prob Es una probabilidad de cola 2 asociada con la distribucin t. Debe ser un nmero ente
0 y 1.

degrees_ Es un entero que indica el nmero de grados de libertad.


freedom

Limitaciones:

Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:

Ejemplo Resultado

TINV(0.3253086, 30 ) Devuelve 1

5.22 Funciones de cadena


En esta seccin se describen funciones para la gestin y manipulacin de cadenas. En las funciones que se
exponen a continuacin, los parmetros son expresiones donde s debe interpretarse como una cadena de
caracteres.

Todas las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de
grficos, excepto Evaluate que slo puede utilizarse en el script de carga de datos.

Descripcin general de las funciones de cadena


Cada funcin se define en detalle tras la vista general. Tambin puede hacer clic en el nombre de la funcin
en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

ApplyCodepage

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 534


5 Funciones en scripts y en expresiones de grfico

Aplica una pginadecdigo diferente al campo o texto indicado en la expresin. Pginadecdigo debe ir en
formato numrico.

ApplyCodepage(text, codepage)

Capitalize
Esta funcin de devuelve la cadena s con todas las palabras en maysculas.

Capitalize ( s )

Chr
Esta funcin devuelve el carcter ASCII correspondiente al nmero n. El resultado es una cadena.

Chr ( n )

Evaluate
Esta funcin de script devuelve el resultado evaluado de la expresin si la cadena de texto s puede ser
evaluada como una expresin vlida de Qlik Sense. Si s no es una expresin vlida, se devuelve NULL.

Evaluate ( s )

FindOneOf
Esta funcin devuelve la posicin de la n ocurrencia en la cadena text de cualquiera de los caracteres que se
encuentren en la cadena characterset. Si n se omite, devuelve la posicin de la primera ocurrencia. Si all
no se encontrara ninguna cadena que se corresponda, devuelve 0.

FindOneOf (text , characterset [ , n])

Hash128
Esta funcin devuelve un hash de 128 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.

Hash128 (expression {, expression})

Hash160
Esta funcin devuelve un hash de 160 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.

Hash160 (expression {, expression})

Hash256
Esta funcin devuelve un hash de 256 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.

Hash256 (expression {, expression} )

Index
Esta funcin devuelve la posicin de inicio de la n-sima vez que aparece la subcadena s2 en la cadena s1.
Si se omite n, se asume la primera ocurrencia. Si n es negativo, la bsqueda se hace comenzando desde el

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 535


5 Funciones en scripts y en expresiones de grfico

final de la cadena s1. El resultado es un entero. Las posiciones en la cadena se numeran desde 1 y hacia
arriba.

Index ( s1 , s2[ , n] )

KeepChar
Esta funcin devuelve la cadena s1 menos todos los caracteres no contenidos en la cadena s2.

KeepChar (s1 , s2)

Left
Esta funcin devuelve una cadena consistente en los primeros n caracteres de s.

Left ( s , n )

Len
Esta funcin de script devuelve la longitud de la cadena s. El resultado es un entero.

Len ( s )

Lower
Esta funcin pone en minsculas todos los datos de la expresin.

Lower ( textexpression )

LTrim
Esta funcin devuelve la cadena s con todos los espacios iniciales eliminados.

LTrim (s)

Mid
Esta funcin devuelve la cadena que comienza por el carcter n1 con la longitud de n2 caracteres. Si se
omite n2, la funcin devuelve la parte de ms a la derecha de la cadena que comienza en el carcter n1. Las
posiciones en la cadena se numeran desde 1 y hacia arriba.

Mid (s, n1[, n2 ])

Ord
Esta funcin devuelve el nmero ASCII del primer carcter de la cadena s. El resultado es un entero.

Ord ( s )

PurgeChar
Esta funcin devuelve la cadena s1 menos todos los caracteres contenidos en la cadena s2.

PurgeChar (s1, s2)

Repeat
Esta funcin forma una cadena consistente en la cadena s repetida n veces.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 536


5 Funciones en scripts y en expresiones de grfico

Repeat ( s, n )

Replace
Esta funcin devuelve una cadena tras haber reemplazado todas las veces en que aparece una determinada
subcadena dentro de la cadena s, por otra subcadena. La funcin no es recursiva y funciona de izquierda a
derecha.

Replace (s, fromstring ,tostring)

Right
Esta funcin devuelve una cadena consistente en los ltimos n caracteres de s.

Right ( s , n )

RTrim
Esta funcin devuelve la cadena s libre de espacios finales.

RTrim ( s )

SubField
En su versin de tres parmetros, esta funcin devuelve una determinada subcadena de una cadena s ms
larga con el delimitador 'delimiter'. Index es un entero opcional que denota cul de las subcadenas debe
ser el resultado. Al omitir index cuando se usa subfield en una expresin de campo en una sentencia
LOAD, la funcin subfield har que la sentencia LOAD genere automticamente un registro completo de
los datos de entrada de cada subcadena que se encuentra en s.

En su versin de dos parmetros, la funcin subfield genera un registro para cada subcadena que puede ser
extrada de una cadena ms larga s con el delimitador 'delimiter'. Usando varias funciones subfield en la
misma sentencia LOAD, se generar el producto cartesiano de todas las combinaciones.

SubField ( s, 'delimiter' [ , index ] )

SubStringCount
Esta funcin devuelve el nmero de veces que aparece una subcadena dentro de una cadena de texto. El
resultado es un entero. Si no existe coincidencia alguna, devuelve 0.

SubStringCount ( text , substring)

TextBetween
Esta funcin devuelve el texto entre aparicin n de beforetext y la aparicin inmediatamente posterior de
aftertext dentro de la cadena s.

TextBetween (s , beforetext , aftertext [, n ])

Trim
Esta funcin devuelve la cadena s libre de espacios iniciales y finales.

Trim ( s )

Upper

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 537


5 Funciones en scripts y en expresiones de grfico

Esta funcin escribe en maysculas todos los datos de la expresin.

Upper ( textexpression )

Capitalize
Esta funcin de devuelve la cadena s con todas las palabras en maysculas.

Sintaxis:

Capitalize( s )

Ejemplos y resultados:

Ejemplo Resultado
Capitalize ( 'my little pony' ) Devuelve 'My Little Pony'
Capitalize ( 'AA bb cC Dd') Devuelve 'Aa Bb Cc Dc'

Chr
Esta funcin devuelve el carcter ASCII correspondiente al nmero n. El resultado es una cadena.

Sintaxis:

Chr( n )

Ejemplos y resultados:

Ejemplo Resultado

Chr(65) Devuelve la cadena 'A'

Evaluate
Esta funcin de script devuelve el resultado evaluado de la expresin si la cadena de texto s puede ser
evaluada como una expresin vlida de Qlik Sense. Si s no es una expresin vlida, se devuelve NULL.

Sintaxis:

Evaluate( s )

Esta funcin de script no puede utilizarse en expresiones de grficos.

Ejemplos y resultados:

Ejemplo Resultado
Evaluate ( 5 * 8 ) Devuelve '40'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 538


5 Funciones en scripts y en expresiones de grfico

FindOneOf
Esta funcin devuelve la posicin de la n ocurrencia en la cadena text de cualquiera de los caracteres que se
encuentren en la cadena characterset. Si n se omite, devuelve la posicin de la primera ocurrencia. Si all
no se encontrara ninguna cadena que se corresponda, devuelve 0.

Sintaxis:

FindOneOf(text , characterset [ , n])

Argumento Descripcin

text La cadena original.

characterset Un conjunto de caracteres que evaluar.

n El nmero de veces que aparece el carcter que se ha de evaluar.

Ejemplos y resultados:

Ejemplo Resultado
FindOneOf( 'my example text string', 'et%s') Devuelve '4'
FindOneOf( 'my example text string', 'et%s', 3) Devuelve '12'
FindOneOf( 'my example text string', '%&') Devuelve '0'

Hash128
Esta funcin devuelve un hash de 128 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.

Sintaxis:

Hash128(expression {, expression})

Ejemplo:

Hash128 ( 'abc', 'xyz', '123' )


Hash128 ( Region, Year, Month )

Hash160
Esta funcin devuelve un hash de 160 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.

Sintaxis:

Hash160(expression {, expression})

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 539


5 Funciones en scripts y en expresiones de grfico

Ejemplo:

Hash160 ( Region, Year, Month )

Hash256
Esta funcin devuelve un hash de 256 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.

Sintaxis:

Hash256(expression {, expression} )

Ejemplo:

Hash256 ( Region, Year, Month )

Index
Esta funcin devuelve la posicin de inicio de la n-sima vez que aparece la subcadena s2 en la cadena s1.
Si se omite n, se asume la primera ocurrencia. Si n es negativo, la bsqueda se hace comenzando desde el
final de la cadena s1. El resultado es un entero. Las posiciones en la cadena se numeran desde 1 y hacia
arriba.

Sintaxis:

Index( s1 , s2[ , n] )

Ejemplos y resultados:
Para un ejemplo ms complejo, vase la funcin index a continuacin.

Ejemplo Resultado

Index('abcdefg', 'cd' ) Devuelve 3

Index('abcdefg', 'b', 2) Devuelve 6

Index('abcdefg', 'b', -2) Devuelve 2

Left( Date, Index( Date,'-') -1 ) where Date = 1997-07-14 Devuelve 1997

Mid( Date, Index( Date, '-', 2 ) -2, 2 ) where Date = 1997-07-14 Devuelve 07

KeepChar
Esta funcin devuelve la cadena s1 menos todos los caracteres no contenidos en la cadena s2.

Sintaxis:

KeepChar(s1 , s2)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 540


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplo Resultado
KeepChar ( 'a1b2c3','123' ) Devuelve '123'

Left
Esta funcin devuelve una cadena consistente en los primeros n caracteres de s.

Sintaxis:

Left( s , n )

Ejemplos y resultados:
Para un ejemplo ms complejo, vase la funcin index.

Ejemplo Resultado
Left('abcdef', 3) Devuelve 'abc'

Left(Date, 4) where Date = 1997-07-14 Devuelve '1997'

Vea tambin:

p Index (pgina 540)

Len
Esta funcin de script devuelve la longitud de la cadena s. El resultado es un entero.

Sintaxis:

Len( s )

Ejemplos y resultados:

Ejemplo Resultado

Len(Name) where Name = 'Peter' Devuelve '5'

Lower
Esta funcin pone en minsculas todos los datos de la expresin.

Sintaxis:

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 541


5 Funciones en scripts y en expresiones de grfico

Lower( textexpression )

Ejemplos y resultados:

Ejemplo Resultado
Lower('abcD') Devuelve 'abcd'

LTrim
Esta funcin devuelve la cadena s con todos los espacios iniciales eliminados.

Sintaxis:

LTrim( s )

Ejemplos y resultados:

Ejemplo Resultado
LTrim( ' abc' ) Devuelve 'abc'
LTrim( 'abc ' ) Devuelve 'abc '

Mid
Esta funcin devuelve la cadena que comienza por el carcter n1 con la longitud de n2 caracteres. Si se
omite n2, la funcin devuelve la parte de ms a la derecha de la cadena que comienza en el carcter n1. Las
posiciones en la cadena se numeran desde 1 y hacia arriba.

Sintaxis:

Mid(s, n1[, n2 ])

Ejemplos y resultados:
Para un ejemplo ms complejo, vase la funcin index.

Ejemplo Resultado
Mid('abcdef',3 ) Devuelve 'cdef'
Mid('abcdef',3, 2 ) Devuelve 'cd'

Mid( Date,3 ) where Date = 970714 Devuelve '0714'

Mid( Date,3,2 ) where Date = 970714 Devuelve '07'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 542


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p Index (pgina 540)

Ord
Esta funcin devuelve el nmero ASCII del primer carcter de la cadena s. El resultado es un entero.

Sintaxis:

Ord( s )

Ejemplos y resultados:

Ejemplo Resultado
Ord('A') Devuelve el nmero '65'

PurgeChar
Esta funcin devuelve la cadena s1 menos todos los caracteres contenidos en la cadena s2.

Sintaxis:

PurgeChar(s1, s2)

Ejemplos y resultados:

Ejemplo Resultado
PurgeChar ( 'a1b2c3','123' ) Devuelve 'abc'

Repeat
Esta funcin forma una cadena consistente en la cadena s repetida n veces.

Sintaxis:

Repeat( s, n )

Ejemplos y resultados:

Ejemplo Resultado

Repeat( ' * ', rating ) when rating = 4 Devuelve '****'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 543


5 Funciones en scripts y en expresiones de grfico

Replace
Esta funcin devuelve una cadena tras haber reemplazado todas las veces en que aparece una determinada
subcadena dentro de la cadena s, por otra subcadena. La funcin no es recursiva y funciona de izquierda a
derecha.

Sintaxis:

Replace(s, fromstring ,tostring)

Argumentos:

Argumento Descripcin

s La cadena original.

fromstring Es una cadena que puede aparecer una o ms veces dentro de una cadena.

tostring Es la cadena que reemplazar a todas las instancias de fromstring dentro de la cadena.

Ejemplos y resultados:

Ejemplo Resultado
Replace('abccde','cc','xyz') Devuelve 'abxyzde'

Right
Esta funcin devuelve una cadena consistente en los ltimos n caracteres de s.

Sintaxis:

Right( s , n )

Ejemplos y resultados:

Ejemplo Resultado
Right('abcdef', 3) Devuelve 'def'

Right( Date,2 ) where Date = 1997-07-14 Devuelve '14'

RTrim
Esta funcin devuelve la cadena s libre de espacios finales.

Sintaxis:

RTrim( s )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 544


5 Funciones en scripts y en expresiones de grfico

Ejemplos y resultados:

Ejemplo Resultado
RTrim( ' abc' ) Devuelve ' abc'
RTrim( 'abc ' ) Devuelve 'abc'

SubField
En su versin de tres parmetros, esta funcin devuelve una determinada subcadena de una cadena s ms
larga con el delimitador 'delimiter'. Index es un entero opcional que denota cul de las subcadenas debe
ser el resultado. Al omitir index cuando se usa subfield en una expresin de campo en una sentencia
LOAD, la funcin subfield har que la sentencia LOAD genere automticamente un registro completo de
los datos de entrada de cada subcadena que se encuentra en s.

En su versin de dos parmetros, la funcin subfield genera un registro para cada subcadena que puede ser
extrada de una cadena ms larga s con el delimitador 'delimiter'. Usando varias funciones subfield en la
misma sentencia LOAD, se generar el producto cartesiano de todas las combinaciones.

Sintaxis:

SubField ( s, 'delimiter' [ , index ] )

Ejemplos y resultados:

Ejemplo Resultado
SubField(S, ';' ,2) Devuelve 'cde' si S es 'abc;cde;efg'
SubField(S, ';' ,1) Devuelve NULL si S es una cadena vaca.
SubField(S, ';' ,1) Devuelve una cadena vaca si S es ';'

SubStringCount
Esta funcin devuelve el nmero de veces que aparece una subcadena dentro de una cadena de texto. El
resultado es un entero. Si no existe coincidencia alguna, devuelve 0.

Sintaxis:

SubStringCount( text , substring)

Ejemplos y resultados:

Ejemplo Resultado
SubStringCount ( 'abcdefgcdxyz', 'cd' ) Devuelve '2'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 545


5 Funciones en scripts y en expresiones de grfico

TextBetween
Esta funcin devuelve el texto entre aparicin n de beforetext y la aparicin inmediatamente posterior de
aftertext dentro de la cadena s.

Sintaxis:

TextBetween(s , beforetext , aftertext [, n ])

Ejemplos y resultados:

Ejemplo Resultado
TextBetween('<abc>', '<', '>') Devuelve 'abc'
TextBetween('<abc><de>', '<', '>',2) Devuelve 'de'

Trim
Esta funcin devuelve la cadena s libre de espacios iniciales y finales.

Sintaxis:

Trim( s )

Ejemplos y resultados:

Ejemplo Resultado
Trim( ' abc' ) Devuelve ' abc'
Trim( 'abc ' ) Devuelve 'abc'
Trim( ' abc ' ) Devuelve 'abc'

Upper
Esta funcin escribe en maysculas todos los datos de la expresin.

Sintaxis:

Upper( textexpression )

Ejemplos y resultados:

Ejemplo Resultado
Upper(' abcD') Devuelve 'ABCD'

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 546


5 Funciones en scripts y en expresiones de grfico

5.23 Funciones de sistema


Las funciones de sistema permiten acceder a las propiedades del sistema, de un dispositivo y de la app de
Qlik Sense.

Descripcin general de las funciones de sistema


Algunas de las funciones se describen a continuacin tras la vista genrica. Para esas funciones, puede
hacer clic en el nombre de la funcin en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

Author()
Esta funcin devuelve una cadena que contiene la propiedad de autor de la actual app. Puede utilizarse
tanto en el script de carga de datos como en una expresin de grficos.

La propiedad de autor no puede fijarse en la versin actual de Qlik Sense. Si migra un


documewnto QlikView, la propiedad de autor se mantendr.

ClientPlatform()
Esta funcin devuelve la cadena de agente de usuario del navegador cliente. Puede utilizarse tanto en el
script de carga de datos como en una expresin de grficos..

Ejemplo:

Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114


Safari/537.36

ComputerName
Esta funcin devuelve una cadena con el nombre del ordenador, tal como lo devuelve el sistema operativo.
Puede utilizarse tanto en el script de carga de datos como en una expresin de grficos..

ComputerName( )

DocumentName
Esta funcin devuelve una cadena con el nombre de la app actual de Qlik Sense, sin la ruta de acceso pero
s con la extensin. Puede utilizarse tanto en el script de carga de datos como en una expresin de grficos.

DocumentName( )

DocumentPath
Esta funcin devuelve una cadena que contiene la ruta completa a la app actual de Qlik Sense. Puede
utilizarse tanto en el script de carga de datos como en una expresin de grficos.

DocumentPath( )

Esta funcin no es posible en modo estndar.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 547


5 Funciones en scripts y en expresiones de grfico

DocumentTitle
Esta funcin devuelve una cadena que contiene el ttulo de la app actual de Qlik Sense. Puede utilizarse
tanto en el script de carga de datos como en una expresin de grficos.

DocumentTitle( )

OSuser
Esta funcin devuelve una cadena que contiene el nombre del usuario actual, tal como lo devuelve el
sistema operativo. Puede utilizarse tanto en el script de carga de datos como en una expresin de grficos..

OSuser( )

QlikViewVersion
Esta funcin devuelve el nmero completo de la versin de Qlik Sense como una cadena (p. ej.
7.52.3797.0409.3).

QlikViewVersion ()

ReloadTime
Esta funcin devuelve una fecha-hora indicando el momento en que termin la ltima carga de datos. Puede
utilizarse tanto en el script de carga de datos como en una expresin de grficos..

ReloadTime( )

GetExtendedProperty
Esta funcin devuelve el valor de una propiedad ampliada determinada en el objeto de hoja con el
correspondiente ID de objeto. Si no se especifica objectid, se utilizar el objeto de hoja que contiene la
expresin. La propiedad ampliada para un objeto de extensin se define en su archivo de definicin.

GetExtendedProperty - funcin de grfico(name[, objectid])

GetObjectField
Esta funcin devuelve el nombre de la dimensin. Index es un nmero entero opcional que declara cul de
las dimensiones utilizadas debera ser el resultado.

GetObjectField - funcin de grfico([index])

GetRegistryString
Esta funcin devuelve el valor de una clave en el registro de Windows. Puede utilizarse tanto en el script de
carga de datos como en una expresin de grficos..

GetRegistryString(path, key)

GetCollationLocale
Esta funcin de script devuelve el nombre del lugar de cotejo que se est utilizando. Si no se ha establecido
la variable CollationLocale, devuelve el lugar real de la mquina del usuario.

GetCollationLocale( )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 548


5 Funciones en scripts y en expresiones de grfico

Vea tambin:

p GetFolderPath (pgina 429)

GetExtendedProperty - funcin de grfico


Esta funcin devuelve el valor de una propiedad ampliada determinada en el objeto de hoja con el
correspondiente ID de objeto. Si no se especifica objectid, se utilizar el objeto de hoja que contiene la
expresin. La propiedad ampliada para un objeto de extensin se define en su archivo de definicin.

Sintaxis:

GetExtendedProperty (name[, objectid])

Ejemplo:

GetExtendedProperty ('Greeting')

GetObjectField - funcin de grfico


Esta funcin devuelve el nombre de la dimensin. Index es un nmero entero opcional que declara cul de
las dimensiones utilizadas debera ser el resultado.

Sintaxis:

GetObjectField ([index])

Ejemplo:

GetObjectField(2)

QlikViewVersion
Esta funcin devuelve el nmero completo de la versin de Qlik Sense como una cadena (p. ej.
7.52.3797.0409.3).

Sintaxis:

QlikViewVersion()

5.24 Funciones de tabla


Las funciones de tabla devuelven informacin sobre la tabla de datos que se est leyendo en ese momento.
Si no se especifica nombre de tabla alguno y la funcin se emplea dentro de una sentencia LOAD, se asume
la tabla actual.

Todas las funciones pueden utilizarse en el script de carga de datos, mientras que NoOfRows slo puede
utilizarse en una expresin de grfico.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 549


5 Funciones en scripts y en expresiones de grfico

Vista general de las funciones de tabla


Algunas de las funciones se describen a continuacin tras la vista genrica. Para esas funciones, puede
hacer clic en el nombre de la funcin en la sintaxis para acceder de inmediato a los detalles de dicha funcin.

FieldName
Esta funcin de script devuelve el nombre del campo con el nmero especificado dentro de una tabla
cargada previamente. Si la funcin se utiliza dentro de una sentencia LOAD, no debe referirse a la tabla que
se est cargando en ese momento.

FieldName (nr ,'TableName')

FieldNumber
Esta funcin de script devuelve el nmero de un campo especificado dentro de una tabla cargada
previamente. Si la funcin se utiliza dentro de una sentencia LOAD, no debe referirse a la tabla que se est
cargando en ese momento.

FieldNumber ('field ' ,'TableName')

NoOfFields
Esta funcin de script devuelve el nmero de campos de una tabla previamente cargada. Si la funcin se
utiliza dentro de una sentencia LOAD, no debe referirse a la tabla que se est cargando en ese momento.

NoOfFields ([ 'TableName ' ])

NoOfRows
Esta funcin devuelve el nmero de filas (registros) de una tabla cargada previamente. Si la funcin se utiliza
dentro de una sentencia LOAD, no debe referirse a la tabla que se est cargando en ese momento.

NoOfRows (['TableName ' ])

NoOfTables
Esta funcin de script devuelve el nmero de tablas previamente cargadas.

NoOfTables()

TableName
Esta funcin de script devuelve el nombre de la tabla con el nmero especificado.

TableName([ 'TableNumber' ])

TableNumber
Esta funcin de script devuelve el nmero de la tabla especificada.

TableNumber([ 'TableName' ])

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 550


5 Funciones en scripts y en expresiones de grfico

FieldName
Esta funcin de script devuelve el nombre del campo con el nmero especificado dentro de una tabla
cargada previamente. Si la funcin se utiliza dentro de una sentencia LOAD, no debe referirse a la tabla que
se est cargando en ese momento.

Sintaxis:

FieldName(nr ,'TableName')

Ejemplo:

LET a = FieldName(4,'tab1');
T1:
LOAD a, b, c, d from abc.csv
T2:
LOAD FieldName (2, 'T1') Autogenerate 1;

FieldNumber
Esta funcin de script devuelve el nmero de un campo especificado dentro de una tabla cargada
previamente. Si la funcin se utiliza dentro de una sentencia LOAD, no debe referirse a la tabla que se est
cargando en ese momento.

Sintaxis:

FieldNumber('field ' ,'TableName')

Ejemplo:

LET a = FieldNumber('Customer','tab1');
T1:
LOADa, b, c, d from abc.csv
T2:
LOAD FieldNumber ('b', 'T1') Autogenerate 1;

NoOfFields
Esta funcin de script devuelve el nmero de campos de una tabla previamente cargada. Si la funcin se
utiliza dentro de una sentencia LOAD, no debe referirse a la tabla que se est cargando en ese momento.

Sintaxis:

NoOfFields([ 'TableName ' ])

Ejemplo:

LET a = NoOfFields('tab1');
LOAD *, NoOfFields( ) from abc.csv;

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 551


5 Funciones en scripts y en expresiones de grfico

NoOfRows
Esta funcin devuelve el nmero de filas (registros) de una tabla cargada previamente. Si la funcin se utiliza
dentro de una sentencia LOAD, no debe referirse a la tabla que se est cargando en ese momento.

Sintaxis:

NoOfRows(['TableName ' ])

Ejemplo:

LET a = NoOfRows('tab1');
LOAD * from abc.csv where NoOfRows( )<30;

5.25 Funciones trigonomtricas e hiperblicas


En esta seccin se describen funciones para realizar operaciones trigonomtricas e hiperblicas. En las
funciones que hay a continuacin, los parmetros son expresiones donde x debe interpretarse como un
nmero de valor real.

Todos los ngulos se miden en radianes.

Todas las funciones pueden utilizarse tanto en el script de carga de datos como en las expresiones de
grficos.

cos
Coseno de x. El resultado es un nmero entre -1 y 1.

cos( x )

acos
Arco coseno de x. La funcin solo se define si -1x1. El resultado es un nmero entre 0 y p.

acos( x )

sin
Seno de x. El resultado es un nmero entre -1 y 1.

sin( x )

asin
Arco seno de x. La funcin solo se define si -1x1. El resultado es un nmero entre - p/2 y p/2.

asin( x )

tan
Tangente de x. El resultado es un nmero.

tan( x )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 552


5 Funciones en scripts y en expresiones de grfico

atan
Arco tangente de x. El resultado es un nmero entre - p/2 y p/2.

atan( x )

atan2
Generalizacin bidimensional de la funcin arco tangente. Devuelve el ngulo entre el origen y el punto
representado por las coordenadas x e y. El resultado es un nmero entre - p y + p.

atan2( y,x )

cosh
Coseno hiperblico de x. El resultado es un nmero positivo.

cosh( x )

sinh
Seno hiperblico de x. El resultado es un nmero.

sinh( x )

tanh
Tangente hiperblica de x. El resultado es un nmero.

tanh( x )

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 553


5 Restriccin de acceso al sistema de archivos

5 Restriccin de acceso al sistema de archivos


Por razones de seguridad, Qlik Sense en modo estndar no admite rutas relativas o absolutas en el script de
carga de datos ni funciones o variables que expongan el sistema de archivos.

Sin embargo, como las rutas relativas y absolutas se utilizaban en QlikView, es posible deshabilitar el modo
estndar y utilizar el modo de legado a fin de poder reutilizar los scripts de carga de QlikView.

Deshabilitar el modo estndar puede crear un riesgo de seguridad al exponer el sistema de


archivos.

Vea tambin: Deshabilitar el modo estndar (pgina 559)

5.26 Limitaciones en el modo estndar


Algunas sentencias, variables y funciones no se pueden utilizar o presentan limitaciones en el modo
estndar. Utilizar sentencias no admitidas en el script de carga de datos produce un error cuando el script de
carga se ejecuta. Pueden surgir mensajes de error en el archivo de registro del script. Utilizar variables y
funciones no admitidas no produce mensajes de error o entradas en el archivo de registro, sino que la funcin
devuelve NULL.

No hay indicacin alguna de que una variable, sentencia o funcin no se admita cuando estemos editando el
script de carga de datos.

Variables de sistema
Variable Modo estndar Modo de legado Definicin

Floppy No admitido Admitido Devuelve la letra de la


primera unidad de disco
que encuentra,
normalmente a:.

CD No admitido Admitido Devuelve la letra de la


primera unidad de CD-
ROM que encuentre. Si
no encuentra ningn
CD-ROM, entonces
devuelve c:.

QvPath No admitido Admitido Devuelve la cadena de


bsqueda al ejecutable
de Qlik Sense:

QvRoot No admitido Admitido Devuelve el directorio

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 554


5 Restriccin de acceso al sistema de archivos

Variable Modo estndar Modo de legado Definicin

raz del ejecutable de


Qlik Sense:

QvWorkPath No admitido Admitido Devuelve la cadena de


bsqueda a la app
actual de Qlik Sense.

QvWorkRoot No admitido Admitido Devuelve el directorio


raz de la app actual de
Qlik Sense.

WinPath No admitido Admitido Devuelve la cadena de


bsqueda a Windows.

WinRoot No admitido Admitido Devuelve el directorio


raz de Windows.

$(include=...) Entrada admitida: Entrada que admite: La variable include


Conexin a la librera Conexin a la librera o especifica un archivo
ruta absoluta/relativa que contiene un texto
que debe ser incluido en
el script. As, el script
entero se puede incluir
en un archivo. Esta es
una variable definida por
el usuario.

Sentencias de script habituales


Sentencia Modo estndar Modo de legado Definicin

Binary Entrada Entrada que La sentencia binary se utiliza para cargar datos
admitida: admite: Conexin de otra app.
Conexin a la a la librera o ruta
librera absoluta/relativa

Connect Entrada Entrada que La sentencia CONNECT sirve para definir el


admitida: admite: Conexin acceso de Qlik Sense a una base de datos
Conexin a la a la librera o ruta general mediante la interfaz OLE DB/ODBC.
librera absoluta/relativa Para ODBC, debemos especificar primero la
fuente de datos mediante el administrador de
conexin ODBC.

Directory Con la conexin Entrada que La sentencia Directory define en qu directorio


de librera, esta admite: Conexin se han de buscar archivos de datos en

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 555


5 Restriccin de acceso al sistema de archivos

Sentencia Modo estndar Modo de legado Definicin

sentencia no a la librera o ruta subguientes.<span class="statement"


tiene efecto en absoluta/relativa MadCap:conditions="Primary.NotToTranslate">
el script </span>La sentencia son es vlida, hasta que
subsiguiente. se introduce una nueva sentencias Directory.

Execute No admitido Entrada que La sentencia Execute sirve para ejecutar otros
admite: Conexin programas mientras Qlik Sense est cargando
a la librera o ruta datos. Por ejemplo, para hacer las conversiones
absoluta/relativa que sean necesarias.

Load from ... Entrada Entrada que Devuelve la cadena de bsqueda al ejecutable
admitida: admite: Conexin de Qlik Sense:
Conexin a la a la librera o ruta
librera absoluta/relativa

Store into ... Entrada Entrada que Devuelve el directorio raz del ejecutable de Qlik
admitida: admite: Conexin Sense:
Conexin a la a la librera o ruta
librera absoluta/relativa

Sentencias de control de script


Sentencia Modo estndar Modo de legado Definicin

For each... Entrada admitida: Entrada que admite: La sintaxis filelist mask
Conexin a la librera Conexin a la librera o produce una lista de
filelist mask/dirlist mask
ruta absoluta/relativa todos los archivos en el
Resultado devuelto:
directorio actual,
Conexin a la librera Resultado devuelto:
separados por coma,
Nombre de la conexin
que coincidan con la
de librera o la ruta
mscara filelist mask.
absoluta, dependiendo
La sintaxis dirlist mask
de la entrada.
produce una lista de
todos los directorios en
el directorio actual,
separados por coma,
que coincidan con la
mscara de nombre de
archivo.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 556


5 Restriccin de acceso al sistema de archivos

Funciones de archivo
Funcin Modo estndar Modo de legado Definicin

Attribute() Entrada admitida: Entrada que admite: Devuelve el valor de las


Conexin a la librera Conexin a la librera o meta etiquetas de
ruta absoluta/relativa diversos archivos de
medios como texto.

ConnectString() Resultado devuelto: Nombre de la conexin Devuelve la cadena de


Nombre de la conexin de librera o conexin conexin para una
de librera actual, dependiendo de conexin ODBC u OLE
la entrada DB.

FileDir() Resultado devuelto: Resultado devuelto: Esta funcin de script


Conexin a la librera Nombre de la conexin devuelve una cadena
de librera o la ruta que contiene la ruta al
absoluta, dependiendo directorio del archivo de
de la entrada. tabla que se est
leyendo en ese
momento.

FilePath() Resultado devuelto: Resultado devuelto: Esta funcin de script


Conexin a la librera Nombre de la conexin devuelve una cadena
de librera o la ruta que contiene la ruta
absoluta, dependiendo completa de acceso al
de la entrada. archivo de tabla que se
est leyendo en ese
momento.

FileSize() Entrada admitida: Entrada que admite: Esta funcin de script


Conexin a la librera Conexin a la librera o devuelve un entero que
ruta absoluta/relativa contiene el tamao en
bytes del archivo
filename o, si no se
especifica filename
alguno, del archivo de
tabla que se est
leyendo en ese
momento.

FileTime() Entrada admitida: Entrada que admite: Esta funcin de script


Conexin a la librera Conexin a la librera o devuelve una marca de
ruta absoluta/relativa tiempo con la fecha y
hora de la ltima
modificacin efectuada

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 557


5 Restriccin de acceso al sistema de archivos

Funcin Modo estndar Modo de legado Definicin

en el archivo filename.
Si no se especifica
filename, la funcin se
referir al archivo de
tabla que se est
leyendo en ese
momento.

GetFolderPath() No admitido Resultado devuelto: Esta funcin de script


Ruta absoluta devuelve el valor de la
funcin
SHGetFolderPath de
Microsoft Windows y
devuelve la ruta. Por
ejemplo: MyMusic.
Observe que la funcin
no utiliza los espacios
que se ven en Windows
Explorer.

QvdCreateTime() Entrada admitida: Entrada que admite: Esta funcin de script


Conexin a la librera Conexin a la librera o devuelve la marca de
ruta absoluta/relativa tiempo de la cabecera
XML desde un archivo
QVD si lo hubiere (si no,
NULL).

QvdFieldName() Entrada admitida: Entrada que admite: Esta funcin de script


Conexin a la librera Conexin a la librera o devuelve el nombre del
ruta absoluta/relativa campo nmero fieldno,
si ste existe en un
archivo QVD (si no,
devuelve NULL).

QvdTableName() Entrada admitida: Entrada que admite: Esta funcin de script


Conexin a la librera Conexin a la librera o devuelve el nombre de
ruta absoluta/relativa la tabla contenida en un
archivo QVD.

QvdNoFields() Entrada admitida: Entrada que admite: Esta funcin de script


Conexin a la librera Conexin a la librera o devuelve el nmero de
ruta absoluta/relativa campos de un archivo
QVD.

QvdNoRecords() Entrada admitida: Entrada que admite: Esta funcin de script

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 558


5 Restriccin de acceso al sistema de archivos

Funcin Modo estndar Modo de legado Definicin

Conexin a la librera Conexin a la librera o devuelve el nmero de


ruta absoluta/relativa registros que se
encuentran actualmente
en un archivo QVD.

Funciones de sistema
Funcin Modo estndar Modo de legado Definicin

GetRegistryString() No admitido Admitido Devuelve el valor de una


clave de registro
nombrada, con una ruta
de registro determinada.
Esta funcin puede
emplearse en los
grficos y en el script por
igual.

DocumentPath() No admitido Resultado devuelto: Esta funcin devuelve


Ruta absoluta una cadena que
contiene la ruta
completa a la app actual
de Qlik Sense.

5.27 Deshabilitar el modo estndar


Podemos deshabilitar el modo estndar, o en otras palabras, establecer el modo de legado, a fin de reutilizar
scripts de carga QlikView que se refieran a rutas de archivo absolutas o relativas as como conexiones de
librera.

Deshabilitar el modo estndar puede crear un riesgo de seguridad al exponer el sistema de


archivos.

Qlik Sense
Para Qlik Sense, el modo estndar puede deshabilitarse en QMC utilizando la propiedad de Modo
estndar.

Vea tambin: Qlik Management Console: Propiedades de motor avanzadas (slo en ingls)

Qlik Sense Desktop


En Qlik Sense Desktop, podemos establecer el modo estndar/de legado en Settings.ini.

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 559


5 Restriccin de acceso al sistema de archivos

Haga lo siguiente:

1. Abra C:\Users\{user}\Documents\Qlik\Sense\Settings.ini en un editor de texto.


2. Cambie StandardReload=1 a StandardReload=0.
3. Guarde el archivo e inicie Qlik Sense Desktop, el cual se ejecutar en modo de legado.

Las configuraciones disponibles para la recarga estndar son:

l 1 (modo estndar)
l 0 (modo de legado)

Gua de Sintaxis de script y funciones de grficos - Qlik Sense, 1.0.3 560

Вам также может понравиться