Sei sulla pagina 1di 687

Sintaxis de script y funciones de

grficos
Qlik Sense
3.0
Copyright 1993-2016 QlikTech International AB. Reservados todos los derechos.

Copyright 1993-2016 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?

19

1.1 Qu podemos hacer en Qlik Sense?

19

1.2 Cmo funciona Qlik Sense?

19

El modelo de apps
La experiencia asociativa
Colaboracin y movilidad
1.3 Cmo se puede instalar Qlik Sense?

19
19
19
20

Qlik Sense Desktop


Qlik Sense Enterprise
1.4 Cmo administrar y gestionar un sitio Qlik Sense

20
20
20

1.5 Ampliar Qlik Sense y adaptarlo a sus propias necesidades

20

Creacin de extensiones y mashups


Construir clientes
Construir herramientas del servidor
Conexin con otras fuentes de datos
2 Sintaxis de script

20
20
20
21
22

2.1 Introduccin a la sintaxis de script

22

2.2 Qu es el formalismo Backus-Naur?

22

2.3 Sentencias de script y palabras clave

23

Sentencias de control de script


Descripcin general de las sentencias de control de script
Call
Do..loop
Exit script
For..next
For each..next
If..then..elseif..else..end if
Sub..end sub
Switch..case..default..end switch
Prefijos de script
Descripcin general de los prefijos de script
Add
Buffer
Concatenate
Crosstable
First
Generic
Hierarchy
HierarchyBelongsTo
Inner
IntervalMatch
Join
Keep
Left

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

24
24
25
27
27
28
29
32
33
34
35
35
39
40
42
42
43
43
44
46
47
49
52
53
53

Contenidos
Mapping
NoConcatenate
Outer
Replace
Right
Sample
Semantic
Unless
When
Sentencias habituales de script
Descripcin general de las sentencias habituales de script
Alias
Binary
Comment field
Comment table
Connect
Declare
Configurar una nueva definicin de campo
Reutilizar una definicin de campo previa
Derive
Direct Query
Listas de campos en Direct Discovery
Directory
Disconnect
Drop field
Drop table
Execute
FlushLog
Force
Load
Elementos de especificacin de formato
Juego de caracteres
Formato de tabla
Delimiter is
No eof
Labels
Header is
Record is
Quotes
XML
KML
Let
Loosen Table
Map
NullAsNull

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

55
56
57
58
59
61
61
62
62
63
63
70
70
71
72
73
75
75
76
77
78
81
83
84
84
85
86
87
87
89
96
97
98
98
99
99
100
101
101
102
102
103
103
104
105

Contenidos
NullAsValue
Qualify
Rem
Rename field
Rename table
Search
Section
Select
Set
Sleep
SQL
SQLColumns
SQLTables
SQLTypes
Star
Store
Tag
Trace
Unmap
Unqualify
Untag
Directorio de trabajo
Directorio de trabajo de Qlik Sense Desktop
Directorio de trabajo de Qlik Sense
2.4 Trabajar con variables en el editor de carga de datos
General
Definir una variable
Eliminar una variable
Cargar un valor de variable como un valor de campo
Clculo de variables
Variables de sistema
Descripcin general de las variables de sistema
HidePrefix
HideSuffix
Include
OpenUrlTimeout
StripComments
Verbatim
Variables de manejo de valores
Descripcin general de las variables de manejo de valores
NullDisplay
NullInterpret
NullValue
OtherSymbol

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

105
106
107
108
109
109
110
110
113
113
114
115
115
116
117
118
120
121
121
121
122
123
123
123
123
123
124
124
124
124
125
126
128
128
129
129
130
130
130
130
131
131
132
132

Contenidos
Variables de interpretacin numrica
Descripcin general de las variables de interpretacin numrica
Formato de moneda
Formato numrico
Formato de tiempo
BrokenWeeks
DateFormat
DayNames
DecimalSep
FirstWeekDay
LongDayNames
LongMonthNames
MoneyDecimalSep
MoneyFormat
MoneyThousandSep
MonthNames
ReferenceDay
ThousandSep
TimeFormat
TimestampFormat
Variables de Direct Discovery
Variables de sistema de Direct Discovery
Variables de Teradata query banding
Variables de carcter de Direct Discovery
Variables de interpretacin numrica de Direct Discovery
Variables de error
Descripcin general de las variables de error
ErrorMode
ScriptError
ScriptErrorCount
ScriptErrorList
2.5 Expresiones de script
3 Expresiones de visualizacin

132
133
133
133
133
135
135
136
136
136
137
137
137
137
137
138
138
138
139
139
139
139
141
141
142
143
143
144
144
145
146
146
148

3.1 Definir el mbito de agregacin

148

3.2 Sintaxis para conjuntos

150

3.3 Modificadores de conjunto

151

Basada en otro campo


Basada en conjuntos de elementos (una lista de valores de campo en el modificador)
Exclusin forzada
Modificadores de conjunto con operadores de conjunto
Modificadores de conjunto con tareas de operadores de conjunto implcitos
Modificadores de conjunto con bsquedas avanzadas
Modificadores de conjunto con expansiones signo dolar
Modificadores de conjunto con definiciones de valores de campo implcitas

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

151
151
151
152
153
154
154
155

Contenidos
3.4 Expresin de visualizacin y sintaxis de agregacin
Sintaxis general para expresiones de grficos
Sintaxis general para agregaciones:
4 Operadores

156
156
156
158

4.1 Operadores de bit

158

4.2 Operadores lgicos

159

4.3 Operadores numricos

159

4.4 Operadores relacionales

160

4.5 Operadores de cadena

161

5 Funciones en scripts y en expresiones de grfico


5.1 Funciones de agregacin
Uso de las funciones de agregacin en el script de carga de datos
Uso de las funciones de agregacin en expresiones de grficos
Aggr - funcin de grfico
Funciones bsicas de agregacin
Descripcin general de las funciones bsicas de agregacin
Funciones bsicas de agregacin en el script de carga de datos
Funciones bsicas de agregacin en expresiones de grficos
FirstSortedValue
FirstSortedValue - funcin de grfico
Max
Max - funcin de grfico
Min
Min - funcin de grfico
Mode
Mode - funcin de grfico
Only
Only - funcin de grfico
Sum
Sum - funcin de grfico
Funciones de agregacin de contador
Funciones de agregacin de contador en el script de carga de datos
Funciones de agregacin de contador en expresiones de grficos
Count
Count - funcin de grfico
MissingCount
MissingCount - funcin de grfico
NullCount
NullCount - funcin de grfico
NumericCount
NumericCount - funcin de grfico
TextCount
TextCount - funcin de grfico
Funciones de agregacin financiera

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

162
162
162
162
162
166
166
166
167
168
170
172
173
175
177
179
180
181
182
184
185
187
187
187
188
189
191
192
194
195
196
198
199
201
202

Contenidos
Funciones financieras de agregacin en el script de carga de datos
Funciones financieras de agregacin en expresiones de grficos
IRR
IRR - funcin de grfico
NPV
NPV - funcin de grfico
XIRR
XIRR - funcin de grfico
XNPV
XNPV - funcin de grfico
Funciones de agregacin estadstica
Funciones de agregacin estadstica en el script de carga de datos
Funciones de agregacin estadstica en expresiones de grficos
Avg
Avg - funcin de grfico
Correl
Correl - funcin de grfico
Fractile
Fractile - funcin de grfico
Kurtosis
Kurtosis - funcin de grfico
LINEST_B
LINEST_B - funcin de grfico
LINEST_DF
LINEST_DF - funcin de grfico
LINEST_F
LINEST_F - funcin de grfico
LINEST_M
LINEST_M - funcin de grfico
LINEST_R2
LINEST_R2 - funcin de grfico
LINEST_SEB
LINEST_SEB - funcin de grfico
LINEST_SEM
LINEST_SEM - funcin de grfico
LINEST_SEY
LINEST_SEY - funcin de grfico
LINEST_SSREG
LINEST_SSREG - funcin de grfico
LINEST_SSRESID
LINEST_SSRESID - funcin de grfico
Median
Median - funcin de grfico
Skew
Skew - funcin de grfico

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

203
203
204
205
206
208
209
210
211
213
214
214
217
220
221
223
224
226
227
229
231
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
256
257

Contenidos
Stdev
Stdev - funcin de grfico
Sterr
Sterr - funcin de grfico
STEYX
STEYX - funcin de grfico
Un ejemplo de cmo utilizar las funciones linest
Cargar los datos de muestra
Visualizar los resultados de los clculos de scripts de carga de datos
Crear visualizaciones linest de funciones de grficos
Funciones estadsticas de prueba
Funciones de prueba Chi-2
Funciones de prueba T
Funciones de prueba Z
Funciones de prueba Chi2
Chi2Test_chi2
Chi2Test_df
Chi2Test_p - funcin de grfico
Funciones de prueba T
TTest_conf
TTest_df
TTest_dif
TTest_lower
TTest_sig
TTest_sterr
TTest_t
TTest_upper
TTestw_conf
TTestw_df
TTestw_dif
TTestw_lower
TTestw_sig
TTestw_sterr
TTestw_t
TTestw_upper
TTest1_conf
TTest1_df
TTest1_dif
TTest1_lower
TTest1_sig
TTest1_sterr
TTest1_t
TTest1_upper
TTest1w_conf
TTest1w_df

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

259
260
262
263
265
266
268
268
269
269
270
271
271
271
271
272
272
273
274
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
295
296
297
297
298
299
300
301
302
303
304

Contenidos
TTest1w_dif
TTest1w_lower
TTest1w_sig
TTest1w_sterr
TTest1w_t
TTest1w_upper
Funciones de prueba Z
ZTest_z
ZTest_sig
ZTest_dif
ZTest_sterr
ZTest_conf
ZTest_lower
ZTest_upper
ZTestw_z
ZTestw_sig
ZTestw_dif
ZTestw_sterr
ZTestw_conf
ZTestw_lower
ZTestw_upper
Ejemplos de funciones estadsticas de prueba
Ejemplos de cmo utilizar funciones chi2-test en grficos
Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos
Crear un informe t-test tpico
Ejemplos de cmo utilizar funciones z-test
Funciones de agregacin de cadena
Funciones de agregacin de cadenas en el script de carga de datos
Funciones de agregacin de cadenas en grficos
Concat
Concat - funcin de grfico
FirstValue
LastValue
MaxString
MaxString - funcin de grfico
MinString
MinString - funcin de grfico
Funciones para dimensiones sintticas
ValueList - funcin de grfico
ValueLoop - funcin de grfico
Agregaciones anidadas
Agregaciones anidadas con el cualificador TOTAL
5.2 Funciones de color
Funciones de colores predefinidos

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

304
305
306
307
308
309
310
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
326
329
331
334
336
336
337
337
339
341
342
343
344
345
346
348
348
350
351
351
352
354

10

Contenidos
ARGB
RGB
HSL
5.3 Funciones condicionales

355
355
356
357

Descripcin general de las funciones condicionales


alt
class
if
match
mixmatch
pick
wildmatch
5.4 Funciones de contador

357
358
359
360
361
361
361
362
362

Descripcin general de las funciones de contador


autonumber
autonumberhash128
autonumberhash256
IterNo
RecNo
RowNo
RowNo - funcin de grfico
5.5 Funciones de fecha y hora

362
364
366
368
371
371
372
374
375

Descripcin general de las funciones de fecha y hora


Expresiones de tiempo con enteros
Funciones de indicacin de tiempo
Funciones make
Otras funciones de tiempo
Funciones de zona horaria
Funciones de establecimiento de hora
Funciones in...
Funciones start ... end
Funciones de nmero de da
addmonths
addyears
age
converttolocaltime
day
dayend
daylightsaving
dayname
daynumberofquarter
daynumberofyear
daystart
firstworkdate

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

376
376
377
377
378
378
379
379
381
384
384
385
386
387
390
390
391
392
393
394
396
397

11

Contenidos
GMT
hour
inday
indaytotime
inlunarweek
inlunarweektodate
inmonth
inmonths
inmonthstodate
inmonthtodate
inquarter
inquartertodate
inweek
inweektodate
inyear
inyeartodate
lastworkdate
localtime
lunarweekend
lunarweekname
lunarweekstart
makedate
maketime
makeweekdate
minute
month
monthend
monthname
monthsend
monthsname
monthsstart
monthstart
networkdays
now
quarterend
quartername
quarterstart
second
setdateyear
setdateyearmonth
timezone
today
UTC
week
weekday

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

398
399
399
401
403
405
407
409
411
413
415
416
417
419
421
423
425
427
428
429
431
433
434
434
435
435
436
437
439
441
443
445
446
448
449
451
453
455
456
457
458
458
459
460
462

12

Contenidos
weekend
weekname
weekstart
weekyear
year
yearend
yearname
yearstart
yeartodate
5.6 Funciones exponenciales y logartmicas

463
465
466
468
469
469
471
473
475
476

5.7 Funciones de campo

478

Funciones de contador
Funciones de campo y seleccin
GetAlternativeCount - funcin de grfico
GetCurrentSelections - funcin de grfico
GetExcludedCount - funcin de grfico
GetFieldSelections - funcin de grfico
GetNotSelectedCount - funcin de grfico
GetPossibleCount - funcin de grfico
GetSelectedCount - funcin de grfico
5.8 Funciones de archivo

478
478
479
480
481
482
484
484
485
487

Visin global de las funciones de archivo


Attribute
ConnectString
FileBaseName
FileDir
FileExtension
FileName
FilePath
FileSize
FileTime
GetFolderPath
QvdCreateTime
QvdFieldName
QvdNoOfFields
QvdNoOfRecords
QvdTableName
5.9 Funciones financieras

487
489
496
496
497
497
497
498
498
499
500
501
502
503
504
505
506

Visin global de las funciones financieras


BlackAndSchole
FV
nPer
Pmt
PV

507
507
508
509
510
511

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

13

Contenidos
Rate
5.10 Funciones de formato

512
513

Descripcin general de las funciones de formato


ApplyCodepage
Date
Dual
Interval
Money
Num
Time
Timestamp
5.11 Funciones numricas generales

513
514
515
516
517
518
519
520
521
522

Descripcin general de las funciones numricas generales


Funciones de combinacin y permutacin
Funciones de mdulo
Funciones de paridad
Funciones de redondeo
BitCount
Ceil
Combin
Div
Even
Fabs
Fact
Floor
Fmod
Frac
Mod
Odd
Permut
Round
Sign
5.12 Funciones geoespaciales

522
523
523
524
524
524
525
526
527
527
527
528
528
529
530
531
531
532
532
534
534

Descripcin general de las funciones geoespaciales


GeoAggrGeometry
GeoBoundingBox
GeoCountVertex
GeoGetBoundingBox
GeoGetPolygonCenter
GeoInvProjectGeometry
GeoMakePoint
GeoProject
GeoProjectGeometry
GeoReduceGeometry

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

534
536
537
537
538
538
539
539
540
541
541

14

Contenidos
5.13 Funciones de interpretacin

542

Descripcin general de las funciones de interpretacin


Date#
Interval#
Money#
Num#
Text
Time#
Timestamp#
5.14 Funciones inter-registro

543
544
544
545
546
547
548
548
549

Funciones de fila
Funciones de columna
Funciones de campo
Funciones de la tabla pivotante
Funciones inter-registro en el script de carga de datos
Above - funcin de grfico
Below - funcin de grfico
Bottom - funcin de grfico
Column - funcin de grfico
Dimensionality - funcin de grfico
Exists
FieldIndex
FieldValue
FieldValueCount
LookUp
NoOfRows - funcin de grfico
Peek
Previous
Top - funcin de grfico
SecondaryDimensionality - funcin de grfico
After - funcin de grfico
Before - funcin de grfico
First - funcin de grfico
Last - funcin de grfico
ColumnNo - funcin de grfico
NoOfColumns - funcin de grfico
5.15 Funciones lgicas

550
550
551
551
552
553
558
561
566
568
568
570
572
573
574
576
577
580
581
585
585
586
587
588
589
590
590

5.16 Funciones de correspondencia

591

Descripcin general de las funciones de correspondencia


ApplyMap
MapSubstring
5.17 Funciones matemticas

591
592
593
594

5.18 Funciones NULL

595

Descripcin general de las funciones NULL

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

595

15

Contenidos
IsNull
NULL
5.19 Funciones de rango

596
597
598

Funciones de rango bsicas


Funciones de rango de contador
Funciones de rango estadsticas
Funciones de rango financieras
RangeAvg
RangeCorrel
RangeCount
RangeFractile
RangeIRR
RangeKurtosis
RangeMax
RangeMaxString
RangeMin
RangeMinString
RangeMissingCount
RangeMode
RangeNPV
RangeNullCount
RangeNumericCount
RangeOnly
RangeSkew
RangeStdev
RangeSum
RangeTextCount
RangeXIRR
RangeXNPV
5.20 Funciones de ranking en grficos

598
599
599
600
601
603
605
607
609
610
611
613
614
616
618
619
621
622
624
625
626
627
629
631
632
634
635

Rank - funcin de grfico


HRank - funcin de grfico
5.21 Funciones de distribucin estadstica

635
639
641

Descripcin general de las funciones de distribucin estadstica


CHIDIST
CHIINV
FDIST
FINV
NORMDIST
NORMINV
TDIST
TINV
5.22 Funciones de cadena

642
643
643
644
645
645
646
647
647
648

Descripcin general de las funciones de cadena

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

648

16

Contenidos
Capitalize
Chr
Evaluate
FindOneOf
Hash128
Hash160
Hash256
Index
KeepChar
Left
Len
Lower
LTrim
Mid
Ord
PurgeChar
Repeat
Replace
Right
RTrim
SubField
SubStringCount
TextBetween
Trim
Upper
5.23 Funciones de sistema

651
652
652
653
653
654
654
654
655
656
656
657
657
657
658
658
659
660
660
661
661
663
664
664
665
665

Descripcin general de las funciones de sistema


GetObjectField - funcin de grfico
IsPartialReload
ProductVersion
StateName - funcin de grfico
5.24 Funciones de tabla

665
667
668
668
668
669

Vista general de las funciones de tabla


FieldName
FieldNumber
NoOfFields
NoOfRows
5.25 Funciones trigonomtricas e hiperblicas

669
671
671
672
672
672

6 Restriccin de acceso al sistema de archivos

675

6.1 Aspectos de seguridad al conectar a conexiones de datos de ODBC y OLE DB basados


en archivos

675

6.2 Limitaciones en el modo estndar

675

Variables de sistema
Sentencias de script habituales

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

676
677

17

Contenidos
Sentencias de control de script
Funciones de archivo
Funciones de sistema
6.3 Deshabilitar el modo estndar
Qlik Sense
Qlik Sense Desktop
7 Funciones y sentencias de QlikView no admitidas en Qlik Sense

679
679
682
682
682
682
684

7.1 Sentencias de script no admitidas en Qlik Sense

684

7.2 Funciones no admitidas en Qlik Sense

684

7.3 Prefijos no admitidos en Qlik Sense

684

8 Funciones y sentencias no recomendadas en Qlik Sense

685

8.1 Sentencias de script no recomendadas en Qlik Sense

685

8.2 Parmetros de sentencias de script no recomendados en Qlik Sense

685

8.3 Funciones no recomendadas en Qlik Sense

686

Cualificador ALL

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

687

18

1 Qu es Qlik Sense?

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 equipo 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 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 la 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
segn lo que le interesa al usuario.

El modelo de apps
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 green/white/gray. 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 dar respuesta

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

19

1 Qu es Qlik Sense?
a nuestras propias preguntas sobre la marcha, seguir haciendo preguntas posteriores, 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 Enterprise.

Qlik Sense Desktop


Se trata de una versin fcil de instalar, para un nico usuario, que normalmente se instala en un ordenador
local.

Qlik Sense Enterprise


Esta versin se utiliza para instalar sitios Qlik 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 la consola (Qlik Management Console) se pueden configurar, gestionar y supervisar sitios Qlik Sense de
forma fcil e intuitiva. Se pueden gestionar las licencias, el acceso y las normas de seguridad, configurar los
nodos y las conexiones de origen de datos y 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 ofrece APIs y SDKs flexibles para desarrollar sus propias extensiones y adaptar e integrar Qlik
Sense para diferentes propsitos, como por ejemplo:

Creacin de extensiones y mashups


Puede llevar a cabo actividades de desarrollo web con JavaScript para crear extensiones que constituyen una
visualizacin personalizada en las apps Qlik Sense, o bien utilizar APIs de mashups para crear sitios web con
contenido de Qlik Sense.

Construir clientes
Puede construir clientes en .NET e integrar objetos de 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 directorio de usuarios puede crear su propia herramienta para administrar y
gestionar los sitios Qlik Sense.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

20

1 Qu es Qlik Sense?
Conexin con otras fuentes de datos
Puede crear conectores de Qlik Sense para recuperar datos de fuentes de datos personalizados.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

21

2 Sintaxis de script

Sintaxis de script

2.1

Introduccin a la sintaxis de script

En un 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. Un script se compone 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 las configuraciones regionales del
sistema operativo.
El script consta de una serie de sentencias de script y palabras clave que se ejecutan de manera consecutiva.
Todas las sentencias de script deben terminar con un punto y coma " ;".
Puede utilizar expresiones y funciones de las sentencias LOAD para transformar los datos que se hayan
cargado.
Para un archivo de tabla con comas, tabuladores o puntos y coma como delimitadores, puede usarse la
sentencia LOAD. Por defecto, la sentencia LOAD carga todos los campos del archivo.
Se puede acceder a bases de datos generales mediante los conectores de bases de datos ODBC u OLE DB.
. Aqu se emplean sentencias SQL estndar. La sintaxis SQL aceptada difiere segn los distintos drivers
ODBC.
Adems, podemos acceder tambin a otras fuentes de datos utilizando conectores personalizados.

2.2

Qu es el formalismo Backus-Naur?

La sintaxis de la lnea de comandos de Qlik Sense y la sintaxis del script se describen en una notacin
denominada formalismo Backus-Naur o cdigo BNF.
La tabla siguiente ofrece una lista de smbolos que se utilizan en el cdigo BNF, con una descripcin de su
interpretacin:

OR lgico: el smbolo puede emplearse a ambos lados.

()

Parntesis que definen la precedencia: se sirven para estructurar la sintaxis de 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 concluyente que puede dividirse en otros smbolos. Por
ejemplo, combinaciones de los de arriba, otros smbolos no concluyentes, cadenas de
texto, etc.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

22

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 bold face. Por ejemplo, ( debera interpretarse como
un parntesis que define la precedencia, mientras que ( debera 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 de dos tipos, una
sentencia normal 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

23

2 Sintaxis de script
Todas las palabras clave del script pueden escribirse con cualquier combinacin de caracteres en mayscula
o minscula. 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 hallarse dentro de una lnea de script y puede acabar en punto y
coma o 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 caracteres en mayscula
o minscula.

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]

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

24

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 un 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

25

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.

Ejemplo:
Este ejemplo enumera todos los archivos relacionados con Qlik en una carpeta y sus subcarpetas, y
almacena la informacin de archivos en una tabla. Se asume que hemos creado una conexin de datos
denominada Apps a la carpeta.
La subrutina DoDir se llama con la referencia a la carpeta, 'lib://Apps', como parmetro. Dentro de la
subrutina, hay una llamada recursiva, Call DoDir (Dir), que hace que la funcin busque archivos de manera
recursiva en subcarpetas.
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;
Next File
Next Ext
For Each Dir in dirlist (Root&'\*' )
Call DoDir (Dir)
Next Dir
End Sub
Call DoDir ('lib://Apps')

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

26

2 Sintaxis de script
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 un punto y
coma o 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;
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 ]

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

27

2 Sintaxis de script
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
/unless

Una sentencia exit script puede hacerse condicional mediante el uso 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.
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 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

28

2 Sintaxis de script
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.

Ejemplo 1: Cargar una secuencia de archivos


// LOAD files file1.csv..file9.csv
for a=1 to 9
LOAD * from file$(a).csv;
next

Ejemplo 2: 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

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

29

2 Sintaxis de script
[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 un punto
y coma o 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 |
fieldvaluelist 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
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 estndar * y ?.
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

30

2 Sintaxis de script
Argumento

Descripcin

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.
fieldvaluelist
mask

Esta sintaxis se repite a lo largo de los valores de un campo ya cargado en Qlik Sense.

Ejemplo 1: 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

Ejemplo 2: 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)'
FileSize(
FileTime(
autogenerate

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

next File
next Ext
for each Dir in dirlist (Root&'\*' )
call DoDir (Dir)
next Dir
end sub

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

31

2 Sintaxis de script
call DoDir ('lib://MyData')

Ejemplo 3: Se repite a lo largo de los valores de un campo


Este ejemplo se repite a lo largo de la lista de valores cargados de FIELD y genera un campo nuevo,
NEWFIELD. Para cada valor de FIELD, se crearn dos registros de NEWFIELD.
load * inline [
FIELD
one
two
three
];
FOR Each a in FieldValueList('FIELD')
LOAD '$(a)' &'-'&RecNo() as NEWFIELD AutoGenerate 2;
NEXT a

La tabla resultante tiene el siguiente aspecto:

NEWFIELD
one-1
one-2
two-1
two-2
three-1
three-2

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: if (pgina 360) (funcin de script y de grfico)

Sintaxis:
If

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

32

2 Sintaxis de script
Como la sentencia if..then es una sentencia de control y como tal termina con un 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.

Ejemplo 1:
if a=1 then
LOAD * from abc.csv;
SQL SELECT e, f, g from tab1;
end if

Ejemplo 2:
if a=1 then; drop table xyz; end if;

Ejemplo 3:
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

33

2 Sintaxis de script
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.

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

Ejemplo 2: - 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

34

2 Sintaxis de script

Como la sentencia switch es una sentencia de control y como tal termina con un 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
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 caracteres en mayscula
o minscula. 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

35

2 Sintaxis de script
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)]
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
El prefijo crosstable sirve para convertir una tabla cruzada en una tabla simple, esto es, una tabla extensa,
con muchas columnas, se convierte en una tabla larga, con los encabezados de columna colocados en una
sola columna de atributo.

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 se utiliza para transformar una tabla jerrquica padre-hijo en una tabla que sea til en un
modelo de datos 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.

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


[PathName], [PathDelimiter], [Depth])(loadstatement | selectstatement)
HierarchBelongsTo
Este prefijo se utiliza para transformar una tabla jerrquica padre-hijo en una tabla que sea til en un modelo
de datos Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

36

2 Sintaxis de script
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)
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. .

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

37

2 Sintaxis de script
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
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 Join explcito 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 originales donde los valores de campos de enlace se
representan en una o ambas tablas. El prefijo Join explcito puede ir precedido por el prefijo Outer para
especificar un outer join. En un outer join la tabla resultante contendr todos los valores de ambas tablas
originales donde los valores de campos de enlace se representan en una o ambas tablas. La palabra clave
Outer es opcional y es el tipo de join usado de manera predeterminada cuando no se especifica un prefijo
join.

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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

38

2 Sintaxis de script
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
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.

La recarga parcial actualmente slo se admite usando el protocolo Qlik Engine API.

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).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

39

2 Sintaxis de script
Ejemplos y resultados:
Ejemplo

Resultado

Tab1:
LOAD Name, Number FROM
Persons.csv;
Add LOAD Name, Number
FROM newPersons.csv;

Durante una recarga normal, los datos se cargan desde Persons.csv y se


almacenan en la tabla Tab1 de Qlik Sense. Los datos de NewPersons.csv se
concatenan a la misma tabla de Qlik Sense.
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:
SQL SELECT Name,
Number FROM
Persons.csv;
Add LOAD Name, Number
FROM NewPersons.csv
where not exists
(Name);

Se hace una comprobacin de duplicados con el fin de ver si Name existe en la


tabla anteriormente cargada.
Durante una recarga normal, los datos se cargan desde Persons.csv y se
almacenan en la tabla Tab1 de Qlik Sense. Los datos de NewPersons.csv se
concatenan a la misma tabla de Qlik Sense.
Durante una recarga parcial, los datos se cargan desde NewPersons.csv, que
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:
LOAD Name, Number FROM
Persons.csv;
Add Only LOAD Name,
Number FROM
NewPersons.csv where
not exists(Name);

Durante una recarga normal, los datos se cargan desde Persons.csv y se


almacenan en la tabla Tab1 de Qlik Sense. No se considera la sentencia de
carga NewPersons.csv.
Durante una recarga parcial, los datos se cargan desde NewPersons.csv, que
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.
Ela rchivo de buffer se almacena en la subcarpeta Buffers, por lo general

C:\ProgramData\Qlik\Sense\Engine\Buffers (en una instalacin de servidor) o C:\Users\


{user}\Documents\Qlik\Sense\Buffers (Qlik Sense Desktop).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

40

2 Sintaxis de script
El nombre del archivo QVD es un nombre calculado, un hash hexadecimal de 160 bits de toda la sentencia
completa LOAD o SELECT que le sigue, as como otra informacin relevante. Esto significa que cualquier
cambio en la sentencia subsiguiente LOAD o SELECT invalidar el buffer QVD.
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
[(days |
hours)]

amount es un nmero que especifica un periodo de tiempo. Se pueden emplear


decimales. Si se omite la unidad se interpreta como days.
La opcin stale after se utiliza normalmente con bases de datos fuente que 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 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.


Ejemplo 1:
Buffer SELECT * from MyTable;

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

Ejemplo 3:
Buffer (incremental) LOAD * from MyLog.log;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

41

2 Sintaxis de script
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.

Los registros idnticos no se eliminan mediante el prefijo Concatenate.

Argumentos:
Argumento

Descripcin

tablename

El nombre de la tabla existente.

Ejemplo:
Concatenate
Concatenate
tab1:
LOAD * From
tab2:
LOAD * From
.. .. ..
Concatenate

LOAD * From file2.csv;


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

Crosstable
El prefijo crosstable sirve para convertir una tabla cruzada en una tabla simple, esto es, una tabla extensa,
con muchas columnas, se convierte en una tabla larga, con los encabezados de columna colocados en una
sola columna de atributo.

Sintaxis:
crosstable (attribute field name, data field name [ , n ] ) ( loadstatement
| selectstatement )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

42

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

attribute field
name

El campo que contiene los valores de atributos.

data field
name

El campo que contiene los valores de datos.

El nmero de campos cualificadores que preceden a la tabla que se va a transformar de


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

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;

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

43

2 Sintaxis de script
Sintaxis:
Generic( loadstatement | selectstatement )

Las tablas cargadas mediante una sentencia generic no se autoconcatenan.

Ejemplos:
Generic LOAD * from abc.csv;
Generic SQL SELECT * from table1;

Hierarchy
El prefijo hierarchy se utiliza para transformar una tabla jerrquica padre-hijo en una tabla que sea til en un
modelo de datos 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.
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.

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 nmero
indeterminado 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

44

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

NodeID

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

ParentID

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

NodeName

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, ParentName, NodeName, PathName, '\', Depth) LOAD * inline [
NodeID, ParentID, NodeName
1, 4, London
2, 3, Munich
3, 5, Germany
4, 5, UK
5, , Europe
];

Node
ID

Paren
tID

NodeNa
me

NodeNa
me1

NodeNa
me2

NodeNa
me3

ParentN
ame

PathName

Dep
th

London

Europe

UK

London

UK

Europe\UK\London

Munich

Europe

Germany

Munich

Germany

Europe\Germany\
Munich

German
y

Europe

Germany

Europe

Europe\Germany

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

45

2 Sintaxis de script
4

UK

Europe

UK

Europe

Europe\UK

Europe

Europe

Europe

HierarchyBelongsTo
Este prefijo se utiliza para transformar una tabla jerrquica padre-hijo en una tabla que sea til en un modelo
de datos 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.
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.

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
padre. En este tipo de tabla, el nodo se almacena en un nico registro, pero puede tener un nmero
indeterminado 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

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

ParentID

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

NodeName

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

AncestorID

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

46

2 Sintaxis de script
Argumento

Descripcin

DepthDiff

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

Ejemplo:
HierarchyBelongsTo (NodeID, AncestorID, NodeName, AncestorID, AncestorName, DepthDiff) LOAD * inline
[
NodeID, AncestorID, NodeName
1, 4, London
2, 3, Munich
3, 5, Germany
4, 5, UK
5, , Europe
];

NodeID

AncestorID

NodeName

AncestorName

DepthDiff

London

London

London

UK

London

Europe

Munich

Munich

Munich

Germany

Munich

Europe

Germany

Germany

Germany

Europe

UK

UK

UK

Europe

Europe

Europe

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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

47

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 1:
Table1
A

aa

cc

ee

Table2
A

xx

yy

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

QVTable
A

aa

xx

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

QVTab1
A

aa

QVTab2

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

48

2 Sintaxis de script
A

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.
Cuando el prefijo IntervalMatch se ampla con campos clave, 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.
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

Son campos que contienen los atributos adicionales que se van a comparar en la
transformacin.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

49

2 Sintaxis de script
Argumento

Descripcin

loadstatement
or
selectstatement

Debe dar como resultado una tabla, en la que el primer campo contenga el lmite
inferior de cada intervalo, el segundo campo contiene el lmite superior de cada
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 (se descarta como
indefinido).

Ejemplo 1:
En las dos tablas a continuacin, la primera enumera una serie de eventos discretos y la segunda define las
horas de inicio y finalizacin de distintos pedidos. 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.
EventLog:
LOAD * Inline [
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
];
OrderLog:
LOAD * INLINE [
Start, End, Order
01:00, 03:35, A
02:30, 07:58, B
03:04, 10:27, C
07:23, 11:43, D
];
//Link the field Time to the time intervals defined by the fields Start and End.
Inner Join IntervalMatch ( Time )
LOAD Start, End
Resident OrderLog;

La tabla OrderLog contiene ahora una columna adicional: Time. El nmero de registros tambin se
expande.

Time

Start

End

Order

00:00

01:18

01:00

03:35

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

50

2 Sintaxis de script
02:23

01:00

03:35

04:15

02:30

07:58

04:15

03:04

10:27

08:00

03:04

10:27

08:00

07:23

11:43

11:43

07:23

11:43

Ejemplo 2: (mediante keyfield)


El mismo ejemplo que el anterior, aadiendo ProductionLine como campo clave.
EventLog:
LOAD * Inline [
Time, Event, Comment, ProductionLine
00:00, 0, Start of shift 1, P1
01:00, 0, Start of shift 1, P2
01:18, 1, Line stop, P1
02:23, 2, Line restart 50%, P1
04:15, 3, Line speed 100%, P1
08:00, 4, Start of shift 2, P1
09:00, 4, Start of shift 2, P2
11:43, 5, End of production, P1
11:43, 5, End of production, P2
];
OrderLog:
LOAD * INLINE [
Start, End, Order, ProductionLine
01:00, 03:35, A, P1
02:30, 07:58, B, P1
03:04, 10:27, C, P1
07:23, 11:43, D, P2
];
//Link the field Time to the time intervals defined by the fields Start and End and match the values
// to the key ProductionLine.
Inner Join
IntervalMatch ( Time, ProductionLine )
LOAD Start, End, ProductionLine
Resident OrderLog;

Ahora se podra crear un cuadro de tabla como ste:

Start

ProductionLine

Time

Event

Comment

Order

P1

00:00

Start of shift 1

P2

01:00

Start of shift 1

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

End

51

2 Sintaxis de script
P1

01:18

Line stop

01:00

03:35

P1

02:23

Line restart 50%

01:00

03:35

P1

04:15

Line speed 100%

02:30

07:58

P1

04:15

Line speed 100%

03:04

10:27

P1

08:00

Start of shift 2

03:04

10:27

P2

09:00

Start of shift 2

07:23

11:43

P1

11:43

End of production

P2

11:43

End of production

07:23

11:43

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;
.. .. ..

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

52

2 Sintaxis de script
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
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 enorme flexibilidad. 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

53

2 Sintaxis de script
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.

Estaba buscando la funcin de cadena por el mismo nombre? Vase: Left (pgina 656)

Sintaxis:
Left ( 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.

Ejemplo:
Table1
A

aa

cc

ee

Table2
A

xx

yy

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

QVTable
A

aa

xx

cc

ee

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

54

2 Sintaxis de script
QVTab1:
SELECT * From Table1;
QVTab2:
Left Keep SELECT * From Table2;

QVTab1
A

aa

cc

ee

QVTab2
A

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. Mapping ofrece una manera eficaz de sustituir
valores de campo durante la ejecucin del script, por ej. reemplazando US, U.S. o Amrica por USA. 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:
En este ejemplo, se ha cargado una lista de comerciales con un cdigo de pas que representa su pas de
residencia. Se utiliza una tabla que hace corresponder un cdigo de pas con un pas para reemplazar el
cdigo de pas por el nombre del pas. En la tabla de correspondencia solo se definen tres pases, los otros

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

55

2 Sintaxis de script
cdigos de pas se hacen corresponder con 'Rest of the world'.
// Load mapping table of country codes:
map1:
mapping LOAD *
Inline [
CCode, Country
Sw, Sweden
Dk, Denmark
No, Norway
] ;
// Load list of salesmen, mapping country code to country
// If the country code is not in the mapping table, put Rest of the world
Salespersons:
LOAD *,
ApplyMap('map1', CCode,'Rest of the world') As Country
Inline [
CCode, Salesperson
Sw, John
Sw, Mary
Sw, Per
Dk, Preben
Dk, Olle
No, Ole
Sf, Risttu] ;
// We don't need the CCode anymore
Drop Field 'CCode';

La tabla resultante tiene el siguiente aspecto:

Salesperson

Country

John

Sweden

Mary

Sweden

Per

Sweden

Preben

Denmark

Olle

Denmark

Ole

Norway

Risttu

Rest of the world

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 )
Ejemplo:
LOAD A,B from file1.csv;
NoConcatenate LOAD A,B from file2.csv;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

56

2 Sintaxis de script
Outer
El prefijo Join explcito 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 originales donde los valores de campos de enlace se
representan en una o ambas tablas. El prefijo Join explcito puede ir precedido por el prefijo Outer para
especificar un outer join. En un outer join la tabla resultante contendr todos los valores de ambas tablas
originales donde los valores de campos de enlace se representan en una o ambas tablas. La palabra clave
Outer es opcional y es el tipo de join usado de manera predeterminada cuando no se especifica un prefijo
join.

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

aa

cc

ee

xx

yy

Table2

SQL SELECT * from table1;


join SQL SELECT * from table2;

OR
SQL SELECT * from table1;
outer join SQL SELECT * from table2;

Joined table

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

57

2 Sintaxis de script
A

aa

xx

cc

ee

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.

La recarga parcial actualmente slo se admite usando el protocolo Qlik Engine API.

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 completa
(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:
Replace LOAD
* from
File1.csv;

Durante la recarga normal y parcial, la tabla Tab1 de Qlik Sense se borra inicialmente.
Despus, los nuevos datos se cargan desde File1.csv y se almacenan en Tab1.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

58

2 Sintaxis de script
Ejemplo

Resultado

Tab1:
Replace only
LOAD * from
File1.csv;

Durante una recarga normal, esta sentencia se ignora.

Tab1:
LOAD a,b,c
from
File1.csv;
Replace LOAD
a,b,c from
File2.csv;

Durante una recarga normal, el archivo File1.csv se lee primero en la tabla Tab1 de Qlik
Sense, pero luego se borrar de inmediato y se sustituir por los datos nuevos cargados
desde File2.csv. Todos los datos desde File1.csv se pierden.

Tab1:
LOAD a,b,c
from
File1.csv;
Replace only
LOAD a,b,c
from
File2.csv;

Durante una recarga normal, los datos se cargan desde File1.csv y se almacenan en la
tabla Tab1 de Qlik Sense. File2.csv es descartado.

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

Durante una recarga parcial, se borra inicialmente toda la tabla Tab1 de Qlik Sense.
Luego es reemplazada por nuevos datos cargados desde File2.csv.

Durante una recarga parcial, se borra inicialmente toda la tabla Tab1 de Qlik Sense.
Luego es reemplazada por nuevos datos cargados desde File2.csv. Todos los datos
desde File1.csv se pierden.

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.

Estaba buscando la funcin de cadena por el mismo nombre? Vase: Right (pgina 660)

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

59

2 Sintaxis de script
Ejemplos:
Table1
A

aa

cc

ee

xx

yy

Table2

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

QVTable
A

aa

xx

yy

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

QVTab1
A

aa

xx

yy

QVTab2

Las dos tablas del ejemplo keep estn, por supuesto, asociadas mediante el campo A.
tab1:
LOAD * from file1.csv;
tab2:
LOAD * from file2.csv;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

60

2 Sintaxis de script
.. .. ..
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 )

Argumentos:
Argumento

Descripcin

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;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

61

2 Sintaxis de script
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.


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 statement o exitstatement solo se ejecutar si la condicion devuelve True.


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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

62

2 Sintaxis de script
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.

Ejemplo 1:
exit script when A=1;

Ejemplo 2:
when A=1 LOAD * from myfile.csv;

Ejemplo 3:
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 caracteres en mayscula
o minscula. 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 Qlik Sense o de un documento de QlikView 11.2
o anterior, incluidos datos de la seccin de acceso. Otros elementos de la app no se incluyen, por ejemplo,
hojas, historias, visualizaciones, elementos maestros o variables.

Binary file
file ::= [ path ] filename

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

63

2 Sintaxis de script
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
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
Declare
La sentencia Declare se utiliza para crear definiciones de campos y grupos, donde podemos definir
relaciones entre los campos o funciones. Un conjunto de definiciones de campos puede servir para generar
automticamente campos derivados, los cuales se pueden utilizar como dimensiones. Por ejemplo,
podemos crear una definicin de calendario y utilizarla para generar dimensiones relacionadas, como por ej.
ao, mes, semana y da, a partir de un campo fecha.

definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
[Groups group_list ]
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
Derive
La sentencia Derive sirve para generar campos derivados basndose en una definicin de campo creada con
una sentencia Declare. Puede especificar para qu campos de datos derivar campos, o bien derivarlos
explcita o implcitamente basndose en etiquetas de campos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

64

2 Sintaxis de script
Derive [Field[s]] From [Field[s]] field_list Using definition
Derive [Field[s]] From Explicit [Tag[s]] (tag_list) Using definition
Derive [Field[s]] From Implicit [Tag[s]] Using definition
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 buscar archivos de datos en subsiguientes sentencias

LOAD, hasta que se incluya una nueva sentencia 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.

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

65

2 Sintaxis de script
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 nombres de campo y valores de campo de sentencias

LOAD y SELECT subsiguientes cuando aparecen escritas slo con maysculas o slo 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
Loosen Table
Una o varias tablas internas de Qlik Sense pueden declararse explcitamente como parcialmente
desconectadas durante la ejecucin de un script mediante la sentencia Loosen Table. Cuando una tabla
est parcialmente desconectada, todas las asociaciones entre los valores de campo de la tabla se eliminan.
Se puede obtener un efecto similar cargando cada campo de la tabla parcialmente desconectada como
tablas independientes, no conectadas. La desconexin parcial puede ser til durante las pruebas para aislar
temporalmente distintas partes de la estructura de datos. Una tabla parcialmente desconectada se identifica

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

66

2 Sintaxis de script
en el visor de tablas por las lneas de puntos. El uso de una o varias sentencias Loosen Table en el script
har que Qlik Sense ignore cualquier configuracin de tablas parcialmente desconectadas que se haya
establecido antes de la ejecucin del script.

tablename [ , tablename2 ...]


Loosen Tables tablename [ , tablename2 ...]
Map ... using
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 })

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

67

2 Sintaxis de script
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
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

68

2 Sintaxis de script
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
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 uso 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

69

2 Sintaxis de script
mismo campo o etiqueta, se emplear el ltimo valor.

Untag 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.

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
Name, B as
Number, C as
Date;

Los cambios de nombre definidos mediante esta sentencia se usarn en todas las
sentencias SELECT y LOAD subsiguientes. Se podr definir un nuevo alias insertando
una nueva sentencia alias en cualquier posicin sucesiva en el script.

Binary
La sentencia binary sirve para cargar los datos de otra app Qlik Sense o de un documento de QlikView 11.2
o anterior, incluidos datos de la seccin de acceso. Otros elementos de la app no se incluyen, por ejemplo,
hojas, historias, visualizaciones, elementos maestros o variables.

Slo se permite una sentencia binary en el script y debe ser la primera sentencia del script,
incluso antes de las sentencias SET que normalmente se sitan al comienzo del script.

Sintaxis:
binary [path] filename

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

70

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

filename

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

path

La ruta al archivo que debera remitir a una conexin de datos de carpetas. Esto es
necesario si el archivo no est situado en el directorio de trabajo de Qlik Sense.

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 a la app que contiene esta lnea de script.

Ejemplo: data\
Ejemplos
Binary lib://MyData/customer.qvw;

En este ejemplo, customer.qvw debe estar ubicado en la


carpeta conectada a la conexin de datos MyData.

Binary customer.qvw;

En este ejemplo, customer.qvw debe estar ubicado en el


directorio de trabajo de Qlik Sense.

Binary c:\qv\customer.qvw;

Este ejemplo que utiliza una ruta de archivo absoluta slo


funcionar en el modo de script de legado.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

71

2 Sintaxis de script
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.

Ejemplo 1:
commentmap:
mapping LOAD * inline [
a,b
Alpha,This field contains text values
Num,This field contains numeric values
];
comment fields using commentmap;

Ejemplo 2:
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
comment [table] tablename with comment
Argumentos:
Argumento

Descripcin

tablelist

(table{,table})

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

72

2 Sintaxis de script
Argumento

Descripcin

mapname

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


mapping LOAD o mapping SELECT.

tablename

El nombre de la tabla que debera comentarse.

comment

El comentario que deber aadirse a la tabla.

Ejemplo 1:
Commentmap:
mapping LOAD * inline [
a,b
Main,This is the fact table
Currencies, Currency helper table
];
comment tables using Commentmap;

Ejemplo 2:
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.

Actualmente no puede conectar a bases de datos mediante OLE DB/ODBC en Qlik Sense
Cloud.

Sintaxis:
ODBC CONNECT TO connect-string
OLEDB CONNECT TO connect-string
CUSTOM CONNECT TO connect-string
LIB CONNECT TO connection

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

73

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

connectstring

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

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.

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.

Ejemplo 1:
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.

Ejemplo 2:
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

74

2 Sintaxis de script
Declare
La sentencia Declare se utiliza para crear definiciones de campos y grupos, donde podemos definir
relaciones entre los campos o funciones. Un conjunto de definiciones de campos puede servir para generar
automticamente campos derivados, los cuales se pueden utilizar como dimensiones. Por ejemplo,
podemos crear una definicin de calendario y utilizarla para generar dimensiones relacionadas, como por ej.
ao, mes, semana y da, a partir de un campo fecha.
Puede utilizar Declare para configurar una nueva definicin de campo o para crear una definicin de campo
basada en una definicin previa.

Configurar una nueva definicin de campo


Sintaxis:
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
Argumentos:
Argumento

Descripcin

definition_
name

El nombre de la definicin de campo, acabado en dos puntos.

No utilice autoCalendar como nombre para definiciones de campos, porque


este nombre se reserva para plantillas autogeneradas de calendario.

Ejemplo:
Calendar:

tag_list

Una lista de etiquetas separadas por comas para aplicar a campos derivados de la
definicin de campo. Aplicar etiquetas es algo opcional, pero si no aplica etiquetas, que
sirven para especificar el criterio de ordenacin, como $date, $numeric o $text, el campo
derivado se ordenar por orden de carga.

Ejemplo:
'$date'

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

75

2 Sintaxis de script
Argumento

Descripcin

parameter_
list

Una lista de parmetros separados por comas. Un parmetro se define como name=value y
se le asigna un valor de inicio, el cual puede ignorarse cuando se reutiliza una definicin de
campo. Opcional.

Ejemplo:
first_month_of_year = 1

field_list

Una lista de campos separados por comas para generar cuando se utilice la definicin de
campo. Un campo se define como <expression> As field_name tagged tag. Use $1 para
referenciar el campo de datos desde el que se deberan generar los campos derivados.

Ejemplo:
Year($1) As Year tagged '$year'

Ejemplo:
Calendar:
DECLARE FIELD DEFINITION TAGGED '$date'
Parameters
first_month_of_year = 1
Fields
Year($1) As Year Tagged ('$numeric'),
Month($1) as Month Tagged ('$numeric'),
Date($1) as Date Tagged ('$date'),
Week($1) as Week Tagged ('$numeric'),
Weekday($1) as Weekday Tagged ('$numeric'),
DayNumberOfYear($1, first_month_of_year) as DayNumberOfYear Tagged ('$numeric')
;

El calendario ya se ha definido y podemos aplicarlo a los campos de fecha que se han cargado, en este caso
OrderDate y ShippingDate, usando una clusula Derive.

Reutilizar una definicin de campo previa


Sintaxis:
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

76

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

definition_
name

El nombre de la definicin de campo, acabado en dos puntos.

Ejemplo:
MyCalendar:

existing_
definition

La definicin de campo para reutilizar cuando se cree la nueva definicin de campo. La


nueva definicin de campo funcionar de la misma manera que la definicin en la que est
basada, salvo si utilizamos parameter_assignment para cambiar un valor utilizado en las
expresiones de campo.

Ejemplo:
Using Calendar

parameter_
assignment

Una lista de asignaciones de parmetros separadas por comas. Una asignacin de


parmetro se define como name=value e ignora el valor de parmetro establecido en la
definicin del campo base. Opcional.

Ejemplo:
first_month_of_year = 4

Ejemplo:
En este ejemplo reutilizamos la definicin de calendario que se cre en el ejemplo anterior. En este caso
deseamos usar un ao fiscal que comience en abril. Esto se logra asignando el valor 4 al parmetro first_
month_of_year, lo cual afectar al campo DayNumberOfYear que se define.
El ejemplo asume que utilizamos los datos de muestra y la definicin de campo del ejemplo anterior.
MyCalendar:
DECLARE FIELD DEFINITION USING Calendar WITH first_month_of_year=4;
DERIVE FIELDS FROM FIELDS OrderDate,ShippingDate USING MyCalendar;

Cuando haya recargado el script de datos, los campos generados estarn disponibles en el editor de hojas,
con nombres OrderDate.MyCalendar.* y ShippingDate.MyCalendar.*.

Derive
La sentencia Derive sirve para generar campos derivados basndose en una definicin de campo creada con
una sentencia Declare. Puede especificar para qu campos de datos derivar campos, o bien derivarlos
explcita o implcitamente basndose en etiquetas de campos.

Sintaxis:
Derive [Field[s]] From [Field[s]] field_list Using definition

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

77

2 Sintaxis de script
Derive [Field[s]] From Explicit [Tag[s]] tag_list Using definition
Derive [Field[s]] From Implicit [Tag[s]] Using definition
Argumentos:
Argumento

Descripcin

definition

Nombre dela definicin de campo que utilizar cuando derivamos campos.

Ejemplo: Calendar
field_list

Una lista de campos de datos separados por comas desde la que deberan generarse los
campos derivados, basado en la definicin de campo. Los campos de datos deben ser
campos que ya hayamos cargado en el script.

Ejemplo: OrderDate, ShippingDate


tag_list

Una lista de etiquetas separadas por comas. Se generarn campos derivados para todos
los campos de datos con cualquiera de las etiquetas listadas.

Ejemplo: '$date'
Ejemplos:
l

Derivar campos para campos de datos especficos.


En este caso especificamos los campos OrderDate y ShippingDate.
DERIVE FIELDS FROM FIELDS OrderDate,ShippingDate USING Calendar;

Derivar campos para todos los campos con una etiqueta especfica.
En este caso derivamos campos basados en Calendar para todos los campos con una etiqueta $date.
DERIVE FIELDS FROM EXPLICIT TAGS '$date' USING Calendar;

Derivar campos para todos los campos con una etiqueta de definicin de campo.
En este caso derivamos campos para todos los datos de campos con la misma etiqueta que la
definicin de campo Calendar, que en este caso es $date.
DERIVE FIELDS FROM IMPLICIT TAG USING Calendar;

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

Actualmente no puede conectar a bases de datos mediante OLE DB/ODBC en Qlik Sense
Cloud.

Sintaxis:
DIRECT QUERY DIMENSION fieldlist [MEASURE fieldlist] [DETAIL fieldlist]
FROM tablelist
[WHERE where_clause]

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

78

2 Sintaxis de script
Las palabras clave DIMENSION , MEASURE y DETAIL pueden utilizarse en cualquier orden.
Las palabras clave DIMENSION y FROM son obligatorias en todas las sentencias DIRECT QUERY. La
palabra clave FROM debe aparecer despus de la palabra clave 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 DISTINCT o GROUP BY.


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 solo 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 slo en las agregaciones,
deberan seleccionarse con la palabra clave MEASURE.
Los campos DETAIL ofrecen informacin o detalles, como campos de 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 cambios. 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

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"')

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

79

2 Sintaxis de script

Los siguientes trminos se utilizan como palabras clave y por lo tanto no pueden utilizarse
como nombres de columna o campo 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 {,

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.
tablelist

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 vistas que contienen un JOIN efectuado en la base de datos.

where_
clause

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

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, como nombres o nmeros de cuenta. Dichos campos no
pueden sumarse, pero s contarse: count(Dim1).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

80

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 a continuacin 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 cambiar a la siguiente sentencia DIRECT QUERY:


DIRECT QUERY
DIMENSION
SalesOrderID,
RevisionNumber

MEASURE
SubTotal,
TaxAmt

DETAIL
OrderDate
FROM MyDB.Sales.SalesOrderHeader;

Listas de campos en Direct Discovery


Una lista de campos es una lista de especificaciones de campo 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

81

2 Sintaxis de script
Los nombres de campo en 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 en mayscula, como el alias interno de Qlik Sense 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

82

2 Sintaxis de script
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

Directory
La sentencia Directory define en qu directorio buscar archivos de datos en subsiguientes sentencias

LOAD, hasta que se incluya una nueva sentencia Directory.


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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

83

2 Sintaxis de script
Argumentos:
Argumento
path

Descripcin
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
Ejemplos:
Directory lib://Data/;
Directory c:\userfiles\data;

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

Sintaxis:
Disconnect

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

84

2 Sintaxis de script

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
Drop
Drop
Drop

field A;
fields A,B;
field A from X;
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:
l

Las tabla(s) en s.

Todos los campos que no formen parte de las restantes tablas.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

85

2 Sintaxis de script
Ejemplo

Resultado

Tab1:
Load * Inline [
Customer, Items, UnitPrice
Bob, 5, 1.50
];

Una vez creada la tabla Tab2, la tabla Tab1 se


abandona.

Tab2:
LOAD Customer, Sum( Items * UnitPrice ) as Sales
resident Tab1
group by Customer;
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).
Necesita configurar OverrideScriptSecurity como 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.

Si configura OverrideScriptSecurity para que permita la accin Execute, cualquier usuario


podr ejecutar archivos en el servidor. Por ejemplo, un usuario podr adjuntar un archivo
ejecutable a una app y luego ejecutar el archivo en el script de carga de datos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

86

2 Sintaxis de script
Haga lo siguiente:

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


2. Verifique que el archivo incluye [Parmetros 7] en la primera lnea.
3. Inserte una nueva lnea y escriba OverrideScriptSecurity=1.
4. Inserte una lnea vaca al final del script.
5. Guarde el archivo.
6. Sustituya Settings.ini por su archivo editado.
7. Reinicie Qlik Sense Engine Service (QES).

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 nombres de campo y valores de campo de sentencias

LOAD y SELECT subsiguientes cuando aparecen escritas slo con maysculas o slo 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

87

2 Sintaxis de script
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.

Ejemplos y resultados:
Ejemplo

Resultado

Este ejemplo muestra cmo obligar a poner


en mayscula inicial:

La tabla Capitalization contiene los siguientes valores:

FORCE Capitalization;
Capitalization:
LOAD * Inline [
ab
Cd
eF
GH
];

Este ejemplo muestra cmo obligar a poner


en maysculas:
FORCE Case Upper;
CaseUpper:
LOAD * Inline [
ab
Cd
eF
GH
];

Este ejemplo muestra cmo obligar a poner


en minsculas:
FORCE Case Lower;
CaseLower:
LOAD * Inline [
ab
Cd
eF
GH
];

Ab
Cd
Ef
Gh

Todos los valores estn en mayscula inicial.

La tabla CaseUpper contiene los siguientes valores:


AB
CD
EF
GH

Todos los valores estn en maysculas.

La tabla CaseLower contiene los siguientes valores:


ab
cd
ef
gh

Todos los valores estn en minsculas.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

88

2 Sintaxis de script
Ejemplo

Resultado

Este ejemplo muestra cmo obligar a poner


en una combinacin de maysculas y
minsculas:
FORCE Case Mixed;
CaseMixed:
LOAD * Inline [
ab
Cd
eF
GH
];

La tabla CaseMixed contiene los siguientes valores:


ab
Cd
eF
GH

Todos los valores estn tal y como aparecen en el script.

Vea tambin:

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

89

2 Sintaxis de script
Argumento

Descripcin

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 | T] )
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.
@startpos: endpos representa las posiciones inicial y final de un campo en un archivo
con registros de longitud fija. Las posiciones deben ser ambas 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. En el ltimo
campo, n se utiliza como posicin final.
l

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 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 de 32
o 64 bits). 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

90

2 Sintaxis de script
Argumento

Descripcin

from

from se utiliza si hay que cargar los datos desde un archivo utilizando una carpeta o
una conexin de datos de archivos 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.

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.
El nombre de archivo filename puede contener los caracteres comodn estndar del
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

91

2 Sintaxis de script
Argumento

Descripcin

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 deber contener expresiones que requieran datos de una fuente
de datos externa o una tabla previamente cargada, a menos que nos refiramos a un
nico valor de campo de una tabla previamente cargada con la funcin Peek.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

92

2 Sintaxis de script
Argumento

Descripcin

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
de cotejo 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 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 diferentes formatos de archivo
Cargue un archivo de datos delimitados con las opciones predefinidas:
LOAD * from data1.csv;

Cargue un archivo de datos delimitados desde una conexin de librera (MyData):


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

Cargue todos los archivos de datos delimitados desde una conexin de librera (MyData):
LOAD * from 'lib://MyData/*.csv';

Cargue un archivo delimitado, especificando la coma como delimitador y con etiquetas incrustadas:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

93

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

Cargue un archivo delimitado, especificando el tabulador como delimitador y con etiquetas incrustadas:
LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);

Cargue un archivo dif con cabeceras incrustadas:


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

Cargue tres campos desde un archivo de registro de longitud fija sin cabeceras:
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);

Cargue un archivo QVX, especificando una ruta absoluta:


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

Seleccionar ciertos campos, renombrar y calcular campos


Cargue slo tres campos especficos desde un archivo delimitado:
LOAD FirstName, LastName, Number from data1.csv;

Renombre el primer campo como A y el segundo campo como B cuando cargue un archivo sin etiquetas:
LOAD @1 as A, @2 as B from data3.txt (ansi, txt, delimiter is '\t', no labels);

Cargue Name como una concatenacin de FirstName, un carcter de espacio y LastName:


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

Cargue Quantity, Price y Value (el producto de Quantity y Price):


LOAD Quantity, Price, Quantity*Price as Value from data1.csv;

Seleccionar ciertos registros


Cargue slo registros nicos, los registros duplicados sern descartados:
LOAD distinct FirstName, LastName, Number from data1.csv;

Cargue slo registros en los que el campo Litres tenga un valor superior a cero:
LOAD * from Consumption.csv where Litres>0;

Cargue datos que no residan en un archivo y datos autogenerados.


Cargue una tabla con datos inline, dos campos denominados CatID y Category:
LOAD * Inline
[CatID, Category
0,Regular
1,Occasional
2,Permanent];

Cargue una tabla con datos inline, tres campos denominados UserID, Password y Access:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

94

2 Sintaxis de script
LOAD * Inline [UserID, Password, Access
A, ABC456, User
B, VIP789, Admin];

Cargue una tabla con 10.000 filas. El campo A contendr el nmero de registros ledos (1,2,3,4,5...) y el
campo B contendr un nmero aleatorio entre 0 y 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


Primero cargamos un archivo de tabla delimitado y lo denominamos tab1:
tab1:
SELECT A,B,C,D from 'lib://MyData/data1.csv';

Cargue campos desde la tabla tab1 ya cargada como tab2:


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

Cargue campos de la tabla tab1 previamente cargada, pero slo registros donde A sea mayor que B:
tab3:
LOAD A,A+B+C resident tab1 where A>B;

Cargue archivos de la tabla tab1 previamente cargada por A:


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

Cargue campos de la tabla tab1 ya cargada, ordenados por el primer campo, y despus el segundo campo:
LOAD A,B*C as E resident tab1 order by 1,2;

Cargue campos de la tabla tab1 ya cargada ordenados por C descendente y a continuacin B ascendente y
despus el primer campo por orden descendente:
LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des;

Cargar datos de archivos previamente cargados


Cargue el campo Types de la tabla previamente cargada Characters como A:
LOAD A from_field (Characters, Types);

Cargar datos de una tabla subsiguiente (preceding load)


Cargue A, B y campos calculados X e Y desde la Table1 que se carga en la sentencia SELECT posterior:
LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y;
SELECT A,B,C,D from Table1;

Agrupar datos
Cargue campos agrupados (agregados) por ArtNo:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

95

2 Sintaxis de script
LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo;

Cargue campos agrupados (agregados) por Week y 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

Las notas, en una escala del 1 al 5 representan las asignaturas Math, English, Science y History
(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 se almacena en Grade, y la asignatura se selecciona usando la
funcin pick y se almacena en Subject. 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:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

96

2 Sintaxis de script
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 ]

Juego de caracteres
El juego de caracteres es un especificador de archivo para la sentencia LOAD que define el conjunto de
caracteres que se utiliza en el archivo.
Los especificadores ansi, oem y mac ya 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
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 89)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

97

2 Sintaxis de script
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 de texto delimitado, las columnas de la tabla estn separadas por un carcter
delimitador.

fix

En un archivo de registro de longitud fija,cada campo tiene un nmero fijo de caracteres.


Por lo general, muchos archivos de registro de longitud fija contienen registros separados por
un avance de lnea, pero hay opciones ms avanzadas para especificar el tamao de registro
en bytes o para expandirse por ms de una lnea con Record is.

Si los datos contienen caracteres de mltiples bytes, los saltos de campo


podran alinearse mal porque el formato se basa en una longitud fija en bytes.
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.

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 is
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:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

98

2 Sintaxis de script
'\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, a
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 89)

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

Sintaxis:
no eof
Si se utiliza el especificador no eof, los caracteres con el cdigo 26, que de otro modo denota el final de
archivo, se descartan y pueden formar parte de un valor de campo.
Este especificador slo tiene sentido en archivos delimitados de texto.

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

Vea tambin:
p

Load (pgina 89)

Labels
Labels es un especificador de archivo para la sentencia LOAD que define en qu parte de un archivo se
pueden encontrar los nombres de campo.
Sintaxis:
embedded labels|explicit labels|no labels

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

99

2 Sintaxis de script
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.

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

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

Vea tambin:
p

Load (pgina 89)

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);

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

100

2 Sintaxis de script
El resultado es una tabla con dos campos, Col1 y Col2.

Vea tambin:
p

Load (pgina 89)

Record is
Para archivos de registro fijo, la longitud de registro debe especificarse mediante el especificador record is.

Sintaxis:
Record is n
Record is line
Record is n lines
Argumentos:
Argumento

Descripcin

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 89)

Quotes
Quotes es un especificador de archivo para la sentencia LOAD que define si se pueden utilizar comillas o
no, y la prioridad entre stas y los separadores. Es slo para archivos de texto.
Sintaxis:
no quotes
msq
Si se omite el especificador, se utilizan las comillas estndar dobles o simples, esto es, " " o ' ', pero slo si
son el primer y ltimo carcter no en blanco de un valor de campo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

101

2 Sintaxis de script
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.

XML
Este especificador de script se utiliza para cargar archivos xml. Las opciones vlidas para la sintaxis del
especificador XML se listan 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 89)

KML
Este especificador de script se utiliza cuando cargamos archivos KML para utilizarlos en una visualizacin de
mapa.

Sintaxis:
kml

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

102

2 Sintaxis de script
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 forma de [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

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;
Let y=3+4;
z=$(y)+1;

$(x) se evaluar como ' 3+4 '


$(y) se evaluar como ' 7 '
$(z) se evaluar como ' 8 '

Let T=now();

$(T) recibir el valor de la hora actual.

Loosen Table
Una o varias tablas internas de Qlik Sense pueden declararse explcitamente como parcialmente
desconectadas durante la ejecucin de un script mediante la sentencia Loosen Table. Cuando una tabla
est parcialmente desconectada, todas las asociaciones entre los valores de campo de la tabla se eliminan.
Se puede obtener un efecto similar cargando cada campo de la tabla parcialmente desconectada como
tablas independientes, no conectadas. La desconexin parcial puede ser til durante las pruebas para aislar
temporalmente distintas partes de la estructura de datos. Una tabla parcialmente desconectada se identifica
en el visor de tablas por las lneas de puntos. El uso de una o varias sentencias Loosen Table en el script
har que Qlik Sense ignore cualquier configuracin de tablas parcialmente desconectadas que se haya
establecido antes de la ejecucin del script.

Sintaxis:
Loosen Tabletablename [ , tablename2 ...]
Loosen Tablestablename [ , tablename2 ...]

Se puede usar cualquier sintaxis: Loosen Table o Loosen Tables.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

103

2 Sintaxis de script

Cuando Qlik Sense encuentra referencias circulares en la estructura de datos que no pueden
romperse por tablas declaradas como parcialmente desconectadas de forma interactiva o
explcita en el script, se obligar a una o ms tablas adicionales a ser parcialmente
desconectadas hasta que no queden referencias circulares. Cuando esto ocurra, el dilogo
Advertencia Interacin lanza una advertencia.

Ejemplo:
Tab1:
SELECT * from Trans;
Loosen Table Tab1;

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:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

104

2 Sintaxis de script
Ejemplo

Resultado

Map Country Using


Cmap;

Permite hacer corresponder el campo Country mediante el mapa 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 indefinidas. 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

105

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

106

2 Sintaxis de script
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.

Ejemplo 1:
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. El resultado son tres campos: A, x.B, y.B.

Ejemplo 2:
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. Podemos crear un comentario en cualquier lugar del script, excepto entre dos 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).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

107

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

string

Es un texto cualquiera.

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.

No se recomienda utilizar el mismo nombre para un campo y una funcin en Qlik Sense
Se puede usar cualquier 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:
No puede renombrar dos campos de forma que contengan el mismo nombre.

Ejemplo 1:
Rename Field XAZ0007 to Sales;

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

108

2 Sintaxis de script
Rename table
Esta funcin de script renombra una o varias tablas internas de Qlik Sense tras haberlas cargado.
Se puede usar cualquier sintaxis: rename table o rename tables.

Sintaxis:
Rename Table (using mapname | oldname to newname{ , oldname to newname })
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 generar un error si
tratamos de renombrar un campo con el mismo nombre de una tabla previa.

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

Ejemplo 2:
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 bsqueda inteligente.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

109

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

*fieldlist

Lista separada por comas de los campos que se deben incluir o excluir de las bsquedas
en la bsqueda inteligente. 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:
Search Include *;

Incluya todos los campos en sus bsquedas en la bsqueda inteligente.

Search Exclude [*ID];

Excluya todos los campos que terminen en ID de las bsquedas en la


bsqueda inteligente.

Search Exclude '*ID';

Excluya todos los campos que terminen en ID de las bsquedas en la


bsqueda inteligente.

Search Include ProductID;

Incluya el campo ProductID en las bsquedas con bsqueda


inteligente.

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

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 de script y funciones de grficos - Qlik Sense, 3.0

110

2 Sintaxis de script
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 ]

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 general SQL dependiendo de las capacidades de los drivers ODBC o del
proveedor OLE DB, por ejemplo:
l

as a veces no se permite, aliasname debe ir inmediatamente despus de fieldname.

as a veces es obligatorio si se usa un aliasname.

distinct, as,where, group by, order by, o union a veces no se permiten.

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 exhaustiva 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

111

2 Sintaxis de script
Argumento

Descripcin

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 campos aceptados normalmente son: +, -, *, /, &
(concatenacin de cadenas),sum(fieldname), count(fieldname), avg(fieldname)(average),
month(fieldname), etc. Consulte la documentacin del driver ODBC si desea 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 clusula as se usa para asignar un nombre nuevo al campo.

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 o proveedor OLE DB, segn lo especificado en la definicin de la fuente de
datos de la sentencia Connect.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

112

2 Sintaxis de script
Ejemplo 1:
SELECT * FROM `Categories`;

Ejemplo 2:
SELECT `Category ID`, `Category Name` FROM `Categories`;

Ejemplo 3:
SELECT `Order ID`, `Product ID`,
`Unit Price` * Quantity * (1-Discount) as NetSales
FROM `Order Details`;

Ejemplo 4:
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
Ejemplo 1:
Set FileToUse=Data1.csv;

Ejemplo 2:
Set Constant="My string";

Ejemplo 3:
Set BudgetYear=2012;

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

Sintaxis:
Sleep n

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

113

2 Sintaxis de script
Argumentos:
Argumento

Descripcin

Indicado en milisegundos, donde n es un entero positivo no mayor que 3600000 (esto es, 1
hora). El valor puede ser una expresin.

Ejemplo 1:
Sleep 10000;

Ejemplo 2:
Sleep t*1000;

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

Sintaxis:
SQL sql_command

Lanzar sentencias SQL que actualizan la base de datos devolver un error si Qlik Sense ha abierto la
conexin ODBC en modo de slo 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.

Ejemplo 1:
SQL leave;

Ejemplo 2:
SQL Execute <storedProc>;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

114

2 Sintaxis de script
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
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 de script y funciones de grficos - Qlik Sense, 3.0

115

2 Sintaxis de script
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:
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

116

2 Sintaxis de script
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';
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.

Ejemplo:
El ejemplo inferior es un extracto de un script de carga de datos que contiene seccin de acceso.
Star is *;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

117

2 Sintaxis de script
Section Access;
LOAD * INLINE [
ACCESS, USERID, PASSWORD, OMIT
ADMIN, ADMIN, ADMIN,
USER, USER1, U1, SALES
USER, USER2, U2, WAREHOUSE
USER, USER3, U3, EMPLOYEES
USER, USER4, U4, SALES
USER, USER4, U4, WAREHOUSE
USER, USER5, U5, *
];
Section Application;
LOAD * INLINE [
SALES, WAREHOUSE, EMPLOYEES, ORDERS
1, 2, 3, 4
];

Lo siguiente es de aplicacin:
l

El signo Star es *.

El usuario USER1 no puede ver el campo SALES.

El usuario USER2 no puede ver el campo WAREHOUSE .

El usuario USER3 no puede ver el campo EMPLOYEES.

El usuario USER4 se aade dos veces a la solucin para OMITIR dos campos para este usuario,

SALES y WAREHOUSE.
l

El usuario USER5 tiene un asterisco * aadido, lo que significa que todos los campos enumerados
en OMIT no estn disponibles. El signo * significa todos los valores listados, no todos los valores del
campo.

El usuario USER5 no puede ver los campos SALES, WAREHOUSE y EMPLOYEES pero este
usuario puede ver el campo ORDERS.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

118

2 Sintaxis de script
Argumentos:
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 [as aliasname ]


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, incluyendo una ruta vlida a


una conexin de datos de carpetas.

Ejemplo: 'lib://Table Files/target.qvd'


En el modo de elaboracin de scripts de legado, se admiten
tambin los diguientes formatos de ruta:
l

Absoluta

Ejemplo: c:\data\sales.qvd
l

relativa al directorio de trabajo de la app Qlik Sense.

Ejemplo: data\sales.qvd
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

119

2 Sintaxis de script
Ejemplos:
Store
Store
Store
Store
store
store

mytable into xyz.qvd (qvd);


* from mytable into 'lib://FolderConnection/myfile.qvd';
Name, RegNo from mytable into xyz.qvd;
Name as a, RegNo as b from mytable into 'lib://FolderConnection/myfile.qvd';
mytable into myfile.txt (txt);
* from mytable into 'lib://FolderConnection/myfile.qvd';

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

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.

Ejemplo 1:
tagmap:
mapping LOAD * inline [
a,b
Alpha,MyTag
Num,MyTag
];
tag fields using tagmap;

Ejemplo 2:
tag field Alpha with 'MyTag2';

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

120

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 uso de expansiones de signo dlar de variables que se calculan antes de la sentencia trace,
podemos personalizar el mensaje.

Sintaxis:
Trace string
Ejemplo 1:
Trace Main table loaded;

Ejemplo 2:
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.

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

121

2 Sintaxis de script
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.

Ejemplo 1:
Unqualify *;

Ejemplo 2:
Unqualify TransID;

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.

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.

Ejemplo 1:
tagmap:
mapping LOAD * inline [
a,b

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

122

2 Sintaxis de script
Alpha,MyTag
Num,MyTag
];
Untag fields using tagmap;

Ejemplo 2:
Untag field Alpha with MyTag2;

Directorio de trabajo
Si estamos remitiendo a un archivo en una sentencia de script y se omite la ruta, Qlik Sense busca el archivo
en el orden siguiente:

1. El directorio especificado por una sentencia Directory (slo admitido en el modo de script de legado).
2. Si no hay ninguna sentencia Directory, Qlik Sense busca en el directorio de trabajo.

Directorio de trabajo de Qlik Sense Desktop


En Qlik Sense Desktop, el directorio de trabajo es C:\Users\{user}\Documents\Qlik\Sense\Apps.

Directorio de trabajo de Qlik Sense


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.

2.4

Trabajar con variables en el editor de carga de datos

Una variable en Qlik Sense es un contenedor que almacena un valor esttico o un clculo, por ejemplo un
valor numrico o alfanumrico. Cuando utilice la variable en la app, cualquier cambio efectuado en la
variable se aplica en todos los lugares en que se use la variable. Las variables se definen usando el panel de
variables, o en el script utilizando el editor de carga de datos, mientras que la variable adquiere su valor de
una sentencia Let, Set u otras sentencias de control en el script de carga de datos.

Tambin puede trabajar con las variables de Qlik Sense desde el panel de variables cuando
editamos una hoja.

General
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 utiliza 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 ejemplo, una ruta.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

123

2 Sintaxis de script
Hay algunas variables de sistema especiales que Qlik Sense fija al comienzo de la ejecucin de script,
independientemente de cules fueran sus valores previos.

Definir una variable


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.

No se recomienda utilizar el mismo nombre para un campo y una funcin en Qlik Sense

Ejemplos:
set HidePrefix = $ ; // la variable recibir el carcterr "$"

como valor.

let vToday = Num(Today()); // devuelve el nmero de serie de la fecha de hoy.

Eliminar una variable


Si elimina una variable del script y recarga los datos, la variable se mantiene en la app. Si desea eliminar la
variable por completo de la app, deber eliminarla tambin del panel de variables.

Cargar un valor de variable como un valor de campo


Si desea cargar un valor de una variable como un valor de campo en una sentencia LOAD y el resultado de
la expansin dlar es de texto en vez de numrico o una expresin, entonces necesita encerrar la variable
expandida entre comillas simples.

Ejemplo:
El ejemplo a continuacin carga la variable de sistema que contiene las lista de errores de script en una
tabla. Como podr observar, la expansin de ScriptErrorCount en la clusula If no requiere comillas,
mientras que la expansin de ScriptErrorList requiere comillas.
IF $(ScriptErrorCount) >= 1 THEN
LOAD '$(ScriptErrorList)' AS Error AutoGenerate 1;
END IF

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

124

2 Sintaxis de script
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)

350

1560

470

1560

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 143

Variables de interpretacin numrica

pgina 132

Variables de sistema

pgina 125

Variables de manejo de valores

pgina 130

Variables de sistema
Las variables de sistema, algunas de las cuales son definidas por el propio sistema, ofrecen informacin
sobre el sistema y la app Qlik Sense.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

125

2 Sintaxis de script
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/Must_Include especifica un archivo que contiene un texto que debe ser incluido en el
script y evaluado como cdigo de script. Puede almacenar partes de su cdigo de script en un archivo de
texto aparte y reutilizarlo en diversas apps. Esta es una variable definida por el usuario.

$(Include =filename)
$(Must_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.

QvPath

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

126

2 Sintaxis de script

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. Los caracteres del tabulador (ASCII 9) 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 (por ej. pginas HTML). Si se omite, el tiempo establecido ser de unos 20
minutos.

OpenUrlTimeout

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

127

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:
set HideSuffix='%';

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

128

2 Sintaxis de script
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/Must_Include especifica un archivo que contiene un texto que debe ser incluido en el
script y evaluado como cdigo de script. Puede almacenar partes de su cdigo de script en un archivo de
texto aparte y reutilizarlo en diversas apps. Esta es una variable definida por el usuario.

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

Sintaxis:
$(Include=filename)
$(Must_Include=filename)

Hay dos versiones de la variable:


l

Include no genera un error si no encuentra el archivo, fallar en silencio.

Must_Include genera un error si no encuentra el archivo.

Si no se especifica ninguna ruta, el nombre del archivo estar relacionado con el directorio de trabajo de la
app 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.

Ejemplos:
$(Include=abc.txt);
$(Must_Include=lib://MyDataFiles\abc.txt);

OpenUrlTimeout
Esta variable define el tiempo de espera en segundos que Qlik Sense debe respetar cuando recibe datos
procedentes de fuentes URL (por ej. pginas HTML). Si se omite, el tiempo establecido ser de unos 20
minutos.

Sintaxis:
OpenUrlTimeout
Ejemplo:
set OpenUrlTimeout=10;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

129

2 Sintaxis de script
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

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. Los caracteres del tabulador (ASCII 9) y el espacio
fijo (ANSI 160) nunca sufren esta accin.

Sintaxis:
Verbatim
Ejemplo:
set Verbatim = 1;

Variables de manejo de valores


Esta seccin describe 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, y conectores, en el nivel ms bajo de los

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

130

2 Sintaxis de script
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.

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, y conectores, 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

131

2 Sintaxis de script
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.

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 variables de interpretacin numrica vienen definidas por el sistema, es decir, se generan de forma
automtica conforme a la configuracin del sistema operativo al crear una nueva app. En Qlik Sense
Desktop, esto se hace de acuerdo con los parmetros del sistema operativo del ordenador, y en Qlik Sense,
se hace de acuerdo con el sistema operativo del servidor en el que est instalado Qlik Sense.
Las variables se incluyen en la parte superior del script de la nueva app de Qlik Sense y pueden reemplazar a
los ajustes predefinidos del sistema operativo para determinado nmero de configuraciones de formato en el
momento de la ejecucin del script. Pueden eliminarse, editarse o duplicarse libremente.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

132

2 Sintaxis de script

Si desea crear una app para determinadas configuraciones regionales, lo ms fcil


probablemente sea utilizar Qlik Sense Desktop en un ordenador con la configuracin regional
que deseamos en el sistema operativo que crea la app. La app entonces contendr las
configuraciones regionales adecuadas y podr moverla a un servidor Qlik Sense de su
eleccin para seguir con su desarrollo.

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
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

133

2 Sintaxis de script
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
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
Un entero que 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

134

2 Sintaxis de script
financieros que utilicen un desplazamiento mensual, por ejemplo, con inicio el 1 de abril.

Este parmetro actualmente no se usa pero se reserva para un uso futuro.


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.
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.

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)

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

135

2 Sintaxis de script
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
Ejemplos:
Set DecimalSep='.';
Set DecimalSep=',';

FirstWeekDay
Un entero que 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)

1 (= martes)

2 (= mircoles)

3 (= jueves)

4 (= viernes)

5 (= sbado)

6 (= domingo)

Ejemplos:
Set FirstWeekDay=6; //(set Sunday as the first day of the week)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

136

2 Sintaxis de script
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
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 de script y funciones de grficos - Qlik Sense, 3.0

137

2 Sintaxis de script
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';

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)

2 (= 2 de enero)

3 (= 3 de enero)

4 (= 4 de enero)

5 (= 5 de enero)

6 (= 6 de enero)

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 de script y funciones de grficos - Qlik Sense, 3.0

138

2 Sintaxis de script
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:
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 efectuadas 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 los campos que interesa actualizar. 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).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

139

2 Sintaxis de script
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.

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 ampliadas (N<cadena 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 utilizar DISTINCT.

DirectEnableSubquery
En escenarios multi-tabla de alta cardinalidad es posible generar sub consultas en la consulta SQL en lugar
de generar una gran clusula IN. Esto se activa fijando el parmetro DirectEnableSubquery en 'true'. El
valor por defecto es 'false'.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

140

2 Sintaxis de script

Cuando DirectEnableSubquery est habilitado, no podemos cargar tablas que no estn en


modo Direct Discovery.
SET DirectEnableSubquery='true'

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;,
que se enva 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;';

Variables de carcter de Direct Discovery


DirectFieldColumnDelimiter
Podemos fijar el carcter utilizado 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 utilizarlo como smbolo de entrecomillado 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).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

141

2 Sintaxis de script
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.

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'

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

142

2 Sintaxis de script
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 en la sentencia SQL
generada para cargar datos con Direct Discovery.

Ejemplo:
Set DirectTimestampFormat='M/D/YY hh:mm:ss[.fff]';

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

143

2 Sintaxis de script
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 de script se interrumpir y se instar al usuario a


actuar (en modo no por lotes).

ErrorMode

Qlik Sense simplemente ignorar el error y continuar la ejecucin del script con la
siguiente sentencia de script.

=0
ErrorMode
=2

Qlik Sense disparar un mensaje de error "Fall la ejecucin de script..." en el momento


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:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

144

2 Sintaxis de script
Cdigo
de error

Descripcin

Sin Error

Error general

Error de sintaxis

Error general de ODBC

Error general de OLE


DB

Error general en la Base


de Datos Personalizada

Error general de XML

Error general de HTML

No se encontr el
archivo

No se encontr la base
de datos

10

No se encontr la tabla

11

No se encontr el
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 de script y funciones de grficos - Qlik Sense, 3.0

145

2 Sintaxis de 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.
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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

146

2 Sintaxis de script
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

147

3 Expresiones de visualizacin

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 Sintaxis de script y funciones de grficos.

3.1

Definir el mbito de agregacin

Normalmente, hay dos factores que determinan los registros que se utilizan para definir el valor de
agregacin de una expresin. Cuando se trabaja con visualizaciones, estos factores son los siguientes:
l

El valor de dimensin (si la agregacin se realiza en una expresin de grfico)

Selecciones

Juntos, estos factores definen el mbito de la agregacin. Pueden producirse situaciones en las que le
interese que en el clculo se omita la seleccin, las dimensiones o ambas. Para ello, en las funciones de
grfico, utilice el cualificador TOTAL, el anlisis de conjuntos o una combinacin de ambos.

Mtodo

Descripcin

Cualificador
TOTAL

Utilizar el cualificador total en la funcin de agregacin, ignora el valor de dimensin.


La agregacin se realizar en todos los valores de campo posibles.
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.

Anlisis de
conjuntos

Si utiliza el anlisis de conjuntos dentro de su agregacin, se ignora la seleccin. La


agregacin se realizar en todos los valores repartidos por las dimensiones.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

148

3 Expresiones de visualizacin
Mtodo

Descripcin

Cualificador
TOTAL y
anlisis de
conjuntos

Utilizar el cualificador TOTAL y el anlisis de conjuntos dentro de su agregacin, hace que

Cualificador
ALL

Utilizar el cualificador ALL dentro de su agregacin, hace que se descarte la seleccin y las

se ignore la seleccin y descarta las dimensiones.

dimensiones. Se puede lograr el equivalente con la sentencia del anlisis de conjuntos {1}
y el cualificador TOTAL :
=sum(All Sales)
=sum({1} Total Sales)

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 Number formatting, seleccione Number
y desde Formatting, 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

1100

0%

2012

T3

1400

0%

2012

T4

1800

0%

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

149

3 Expresiones de visualizacin
Year

Quarter

Sum(Amount)

Sum({1} Amount)

Sum(Amount)/Sum({1} Amount)

2012

T2

1700

1700

100%

2013

T1

1000

0%

2013

T3

1100

0%

2013

T4

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.

Year

Quarter

Sum

Sum({1} TOTAL

Sum(Amount)/Sum({1} TOTAL

(Amount)

Amount)

Amount)

3000

10800

27,8%

2012

T2

1700

10800

15,7%

2013

T2

1300

10800

12%

Datos utilizados 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

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 } >

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

150

3 Expresiones de visualizacin
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 "

3.3

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}>.
Un modificador de conjunto modifica la seleccin del identificador de conjunto precedente. Si no se remite a
ningn identificador de conjunto, se considera el estado de selecciones 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

151

3 Expresiones de visualizacin
Ejemplos y resultados:
Ejemplos

Resultados

sum( {1<Region=
{USA} >} Sales )

devuelve las ventas en la regin USA, descartando la seleccin actual.

sum( {$<Region =
>} Sales )

Devuelve las ventas de la seleccin actual, pero eliminando la seleccin de "Region".

sum({<Region =
>} Sales )

Devuelve lo mismo que el ejemplo inmediatamente anterior. Cuando se omite el


modificador de conjuntos, se presupone $.

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 =
{2000}, Region =
{US, SE, DE,
UK, FR}>} Sales )

Devuelve las ventas de la seleccin actual, pero con nuevas selecciones tanto en
" Year" como en " Region".

sum(
{$<~Ingredient =
{*garlic*}>}
Sales )

El campo Ingredient est en modo AND.

sum({$<Year =
{2*}>} Sales )

Devuelve las ventas de la seleccin actual, pero con todos los aos que empiecen por
el dgito 2, es decir, del 2000 en adelante, seleccionados en el campo " Year".

sum({$<Year =
{2*,198*}>}
Sales )

Igual que el anterior, pero ahora la dcada de los 80 se incluye en la seleccin.

sum({$<Year =
{>1978<2004}>}
Sales )

Devuelve las ventas de las selecciones actuales, pero con una bsqueda numrica
que sirve para variar el rango de aos para sumar todas las ventas en dichos aos.

Devuelve las ventas de la seleccin actual, pero con una exclusin forzada de todos
los ingredientes que contengan la cadena " garlic".

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

152

3 Expresiones de visualizacin
Ejemplos y resultados:
Ejemplos

Resultados

sum({$<Product =
Product +
{OurProduct1}
{OurProduct2} >}
Sales )

Devuelve las ventas de la seleccin actual, pero con el producto "OurProduct1"


aadido a la lista de productos seleccionados y "OurProduct2" eliminado de la lista
de productos seleccionados.

sum({$<Year =
Year + ({20*,1997}
{2000}) >} Sales )

Devuelve las ventas de la seleccin actual, pero con selecciones adicionales en el


campo "Year": 1997 y todos los que empiezan por 20; sin embargo, no 2000.

sum({$<Year =
(Year +
{20*,1997})
{2000} >} Sales )

Devuelve prcticamente lo mismo que el anterior, pero en este caso se excluir el


2000, incluso si estuviera inicialmente incluido en la seleccin actual. El ejemplo
muestra la importancia de utilizar en ocasiones los parntesis, que ayudan a definir
un orden de prioridad.

sum({$<Year = {*}
{2000}, Product =
{*bearing*} >}
Sales )

Devuelve las ventas de la seleccin actual, pero con una nueva seleccin en
"Year": todos los aos, excepto el 2000; y solo para productos que contengan la
cadena bearing.

Observe que si se incluye 2000 en la seleccin actual, se incluir todava tras la


modificacin.

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 +=
{OurProduct1,
OurProduct2} >} Sales
)

Devuelve las ventas de la seleccin actual, pero empleando una unin implcita
para aadir los productos "OurProduct1" y "OurProduct2" a la lista de productos
seleccionados.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

153

3 Expresiones de visualizacin
Ejemplos

Resultados

sum({$<Year +=
{20*,1997} {2000}
>} Sales )

Devuelve las ventas de la seleccin actual, pero utilizando una unin implcita
para aadir un determinado nmero de aos a la seleccin: 1997 y todos los que
comiencen por "20", excepto 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 *=
{OurProduct1} >}
Sales )

Devuelve las ventas de la seleccin actual, pero solo para la interseccin de


productos actualmente seleccionados y el producto OurProduct1.

Modificadores de conjunto con bsquedas avanzadas


En la definicin de conjuntos se pueden utilizar bsquedas avanzadas empleando comodines y
agregaciones.

Ejemplos y resultados:
Ejemplos

Resultados

sum({$1<Product =
{*Internal*, *Domestic*}>}
Sales )

Devuelve las ventas de la seleccin actual, excluyendo aquellas


transacciones que pertenecen a productos con la cadena "Internal" o
"Domestic" en el nombre del producto.

sum({$<Customer = {=Sum
({1<Year = {2007}>} Sales ) >
1000000}>} Sales )

Devuelve las ventas de la seleccin actual, pero con una nueva seleccin
en el campo "Customer": solo los clientes que durante el ao 2007
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 =
{$(#vLastYear)}>}
Sales )

Devuelve las ventas del ao anterior en relacin con la seleccin actual. Aqu, se
utiliza una variable vLastYear con el ao en cuestin en una expansin de signo
dlar.

sum({$<Year =
{$(#=Only(Year)1)}>} Sales )

Devuelve las ventas del ao anterior en relacin con la seleccin actual. Aqu se
utiliza una expansin signo dlar para calcular el ao anterior.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

154

3 Expresiones de visualizacin
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(
{$<Customer
=P
({1<Product=
{Shoe}>}
Customer)>}
Sales )

Devuelve las ventas de la seleccin actual, pero solo con aquellos clientes que alguna
vez han comprado el producto "Shoe". La funcin de elemento P() aqu devuelve una
lista de posibles clientes, aquellos implcitos por la seleccin "Shoe" en el campo
Product.

sum(
{$<Customer
=P
({1<Product=
{Shoe}>})>}
Sales )

Igual que el anterior. Si se omite el campo en la funcin de elemento, la funcin


devolver los valores posibles del campo especificados en la asignacin externa.

sum(
{$<Customer
=P
({1<Product=
{Shoe}>}
Supplier)>}
Sales )

Devuelve las ventas de la seleccin actual, pero solo con aquellos clientes que alguna
vez han suministrado el producto "Shoe" (Zapato). La funcin de elemento P() aqu
devuelve una lista de posibles proveedores, aquellos implcitos por la seleccin "Shoe"
en el campo Product. La lista de proveedores se utiliza entonces como una seleccin en
el campo Customer.

sum(
{$<Customer
=E
({1<Product=
{Shoe}>})>}
Sales )

Devuelve las ventas de la seleccin actual, pero solo con aquellos clientes que nunca
han comprado el producto "Shoe". La funcin de elemento E() aqu devuelve una lista
de clientes excluidos, aquellos excluidos por la seleccin "Shoe" en el campo Product.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

155

3 Expresiones de visualizacin

3.4

Expresin de visualizacin y sintaxis de agregacin

La sintaxis empleada para expresiones de visualizacin (grfico) 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.

Sintaxis general para agregaciones:


aggrexpression ::= (fieldref

operator1 aggrexpression

aggrexpression operator2 aggrexpression

functioninaggr

(aggrexpression )

fieldref es un nombre de campo.


functionaggr ::= functionname ( parameters2 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

156

3 Expresiones de visualizacin
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

157

4 Operadores

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)

Operadores binarios (toman dos operandos)

La mayora de los operadores son binarios.


Se pueden definir los siguientes operadores:
l

Operadores de bit

Operadores lgicos

Operadores numricos

Operadores relacionales

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
inverso.

Operador unitario. La operacin devuelve el inverso del operando ejecutado bit a bit.

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 1

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
exclusivo.

La operacin devuelve el OR lgico exclusivo de los operandos, ejecutado bit a bit.

Ejemplo:
17 bitxor 7 devuelve 22

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

158

4 Operadores
>>

Bit right
shift.

La operacin devuelve el primer operando desplazado un paso a la derecha. El


nmero de pasos se define en el segundo operando.

Ejemplo:
8 >> 2 devuelve 2

<<

Bit left
shift.

La operacin devuelve el primer operando desplazado a la izquierda. El nmero de


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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

159

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
igual 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 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
igual 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.

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

A diferencia del operador <, no se intenta hacer una interpretacin


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 de cadena, viene antes de la representacin de texto
del valor a la derecha.

Ejemplo:
'1 ' precedes ' 2'

devuelve FALSE

mientras que
' 1' precedes ' 2' devuelve TRUE

puesto que el valor ASCII de un espacio (' ') es de menos valor que
el valor ASCII de un nmero.
Compare esto con:
'1 ' < ' 2'

devuelve TRUE

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

160

4 Operadores
y
' 1' < ' 2' devuelve TRUE

follows

A diferencia del operador >, no se intenta hacer una interpretacin


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 de cadena, viene despus de la representacin de
texto del valor a la derecha.

Ejemplo:
' 2' follows '1 ' devuelve FALSE

mientras que
' 2' follows ' 1' devuelve TRUE
puesto que el valor ASCII de un espacio (' ') es de menos valor que
el valor ASCII de un nmero.
Compare esto con:
' 2' > ' 1' devuelve TRUE

y
' 2' > '1 ' devuelve TRUE

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*' devuelveTrue (-1)
'abc' like 'a??bc' devuelve False (0)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

161

5 Funciones en scripts y en expresiones de grfico

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

5.1

Algunas funciones slo se pueden utilizar en scripts de carga de datos, vienen especificadas como:
funcin de script.
Algunas funciones slo se pueden utilizar en expresiones de grficos, vienen especificadas como:
funcin de grfico.
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.

Funciones de agregacin

La familia de funciones conocidas como funciones de agregacin consta de funciones que toman mltiples
valores de campo como entrada y devuelven un nico resultado, en el que la agregacin viene definida por
una dimensin de grfico o una clusula group by en el script. Las funciones de agregacin incluyen Sum(),

Count(), Min(), Max() y muchas ms...


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 slo pueden utilizarse dentro de sentencias LOAD .

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 para la expresin calculada sobre la dimensin o las dimensiones
establecidas. Por ejemplo, el valor mximo de ventas, por cliente, por regin. La funcin Aggr se utiliza para
agregaciones avanzadas, en las que la funcin Aggr est incluida en otra funcin de agregacin, utilizando

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

162

5 Funciones en scripts y en expresiones de grfico


el conjunto de resultados de la funcin Aggr como entrada a la agregacin en la que se anidada.

Sintaxis:
Aggr({SetExpression}[DISTINCT] [NODISTINCT ] expr, StructuredParameter{,
StructuredParameter})
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

Una expresin que consiste en una funcin de agregacin. Por defecto, la funcin
de agregacin agregar sobre el conjunto de registros posibles definidos por la
seleccin.

StructuredParameter

StructuredParameter consiste en una dimensin y opcionalmente unos criterios


de ordenacin en el formato: (Dimension(Sort-type, Ordering))
La dimensin es un campo y no puede ser una expresin. La dimensin se utiliza
para determinar el conjunto de valores a los que se aplica la expresin Aggr.
Si se incluyen criterios de ordenacin, el conjunto de valores creados por la
funcin Aggr, calculada para la dimensin, se ordena. Esto es importante cuando
el orden de la clasificacin afecta al resultado de la expresin en la que se
engloba la funcin Aggr.
Para ver detalles sobre cmo usar los criterios de ordenacin, vase Aadir

criterios de ordenacin a la dimensin en el parmetro estructurado.


SetExpression

Por defecto, la funcin de agregacin agregar sobre el conjunto de registros


posibles definidos por la seleccin. Se puede definir un conjunto alternativo de
registros mediante una expresin de anlisis de conjuntos.

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 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

163

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 la funcin Aggr() puede compararse con la creacin de un conjunto de resultados temporal (una tabla
virtual), sobre el que podemos aadir otra agregacin. Por ejemplo, calculando un valor promedio de ventas
sumando las ventas por cliente en una sentencia Aggr() y calculando luego la media de los resultados
sumados: Avg(TOTAL Aggr(Sum(Sales),Customer)).

Utilice la funcin Aggr() en dimensiones calculadas si desea crear agregaciones de grficos


anidadas en mltiples niveles.

Limitaciones:
Cada dimensin de una funcin Aggr() debe contener un solo campo y no puede ser una expresin
(dimensin calculada).

Aadir criterios de ordenacin a la dimensin en el parmetro estructurado


En su forma bsica, el argumento StructuredParameter en la sintaxis de la funcin Aggr es una nica
dimensin. La expresin: Aggr(Sum(Sales, Month)) halla el valor total de las ventas de cada mes. No
obstante, cuando se incluye dentro de otra funcin de agregacin puede dar resultados inesperados, a
menos que se utilicen criterios de ordenacin. Esto se produce porque algunas dimensiones pueden
ordenarse numricamente o alfabticamente, etc.
En el argumento StructuredParameter de la funcin Aggr, puede especificar criterios de ordenacin sobre la
dimensin de su expresin. De esta forma, impondr un orden de clasificacin a la tabla que produce la
funcin Aggr.
El argumento StructuredParameter tiene la sintaxis siguiente:

(FieldName, (Sort-type, Ordering))


Los parmetros estructurados pueden anidarse:

(FieldName, (FieldName2, (Sort-type, Ordering)))


El tipo de clasificacin Sort-type puede ser: NUMERIC, TEXT, FREQUENCY, o LOAD_ORDER.
Los tipos de ordenacin asociados con cada tipo de clasificacin son los siguientes:

Tipo de clasificacin

Tipos de ordenacin permitidos

NUMERIC

ASCENDING, DESCENDING o REVERSE

TEXT

ASCENDING, A2Z, DESCENDING, REVERSE o Z2A

FREQUENCY

DESCENDING, REVERSE o ASCENDING

LOAD_ORDER

ASCENDING, ORIGINAL, DESCENDING o REVERSE

Los tipos de ordenacin REVERSE y DESCENDING son equivalentes.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

164

5 Funciones en scripts y en expresiones de grfico


Para el tipo de clasificacin TEXT, los tipos de ordenacin ASCENDING y A2Z son equivalentes, y
DESCENDING, REVERSE, y Z2A son equivalentes.
Para el tipo de clasificacin LOAD_ORDER, los tipos de ordenacin ASCENDING y ORIGINAL, son
equivalentes.

Ejemplos y resultados:
Ejemplo

Resultado

Avg(Aggr(Sum
(UnitSales*UnitPrice),
Customer))

La expresin Aggr(Sum(UnitSales*UnitPrice), Customer) halla el valor total de


ventas por cliente Customer, y devuelve un conjunto de valores: 295, 715 y
120 para los tres valores Customer.
Efectivamente, hemos construido una lista temporal de valores sin tener que
crear una tabla o columna aparte que contenga dichos valores.
Estos valores se utilizan como entrada para la funcin Avg() a fin de hallar el
valor promedio de las ventas, 376,6667. (Debe tener Totales seleccionado en

Presentacin en el panel de propiedades.)


Aggr(NODISTINCT Max
(UnitPrice), Customer)

Un conjunto de valores: 16, 16, 16, 25, 25, 25, 19 y 19. El cualificador
nodistinct indica que el conjunto contiene un elemento por cada fila de datos
fuente: cada uno es el mximo UnitPrice por cada Customer y Product.

max(aggr(sum
(Customers)-above(Sum
(Customers)),
(MonthYear,(NUMERIC,
ASCENDING))))

Utilizando criterios de ordenacin en el argumento StructuredParameter de la


expresin:
max(aggr(sum(Customers)-above(Sum(Customers)), (MonthYear,(NUMERIC,
ASCENDING))))

Sin criterios de ordenacin el resultado de la expresin max(aggr(sum


(Customers)-above(Sum(Customers)), (MonthYear))) depende de cmo est
ordenada la dimensin MonthYear. Puede que no obtengamos el resultado que
deseamos.
Aadiendo valores para tipo de clasificacin y tipo de ordenacin a la
dimensin, otorgamos criterios de ordenacin al parmetro estructurado:
(MonthYear, (NUMERIC, ASCENDING)), donde el tipo de clasificacin NUMERIC y
la ordenacin ASCENDING determinan que MonthYear se ordene de forma
numrica ascendente.
Aqu buscamos hallar el mayor incremento en nmero de clientes, mes tras
mes. Esto podra utilizarse en una visualizacin de KPIs, por ejemplo.
La parte Aggr de la expresin compara el nmero total de clientes de un mes
(dado por MonthYear) con el nmero total del mes anterior.
Como utilizamos criterios de ordenacin con la dimensin: (MonthYear,
(NUMERIC, ASCENDING)), estamos seguros de que Aggr compara los
nmeros de clientes en meses consecutivos en la tabla virtual ordenando los
meses por orden numrico ascendente, y no por orden alfabtico ascendente.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

165

5 Funciones en scripts y en expresiones de grfico


Datos utilizados en los ejemplos:
Cree una tabla con Customer, Product, UnitPrice y UnitSales como dimensiones. Aada la expresin a
la tabla, como una medida.
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|25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');

Vea tambin:
p

Funciones bsicas de agregacin (pgina 166)

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
FirstSortedValue() devuelve el valor de la expresin especificada en value que corresponda al resultado de
ordenar el argumento sort_weight, por ejemplo, el nombre del producto con el precio de unidad ms bajo.
El valor ensimo de la ordenacin se puede especificar en rank. Si ms de un valor obtenido comparte el
mismo sort_weight para el rank especificado, la funcin devuelve NULL. Los valores ordenados se repiten a
lo largo de una serie de registros, definidos por una clusula group by, o se agregan a todo el conjunto
completo de datos si no se ha definido ninguna clusula group by.

FirstSortedValue ([ distinct ] expression, sort_weight [, rank ])


Max
Max() encuentra el valor numrico ms alto de los datos agregados en la expresin, segn lo definido por
una clusula group by. Al especificar un rank n, puede hallarse el valor ensimo ms alto.

Max ( expression[, rank])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

166

5 Funciones en scripts y en expresiones de grfico


Min
Min() devuelve el valor numrico ms bajo de los datos agregados en la expresin, segn lo definido por una
clusula group by. Al especificar un rank n, puede hallarse el ensimo valor ms bajo.

Min ( expression[, rank])


Mode
Mode() devuelve el valor numrico ms repetido, el valor de la moda, de los datos agregados en la
expresin, segn lo definido por una clusula group by. La funcin Mode() puede devolver tanto valores
numricos como valores de texto.

Mode (expression )
Only
Only() devuelve un valor si hay nicamente un resultado posible en los datos agregados. Si los registros
contienen solo un valor entonces devuelve ese valor, si no devuelve NULL. Use la clusula group by para
evaluar varios registros. La funcin Only() puede devolver valores numricos y valores de texto.

Only (expression )
Sum
Sum() calcula el total de los valores agregados en la expresin, segn lo definido por una clusula group
by.
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 la expresin especificada en value que corresponda al resultado de
ordenar el argumento sort_weight, por ejemplo, el nombre del producto con el precio de unidad ms bajo.
El valor ensimo de la ordenacin se puede especificar en rank. Si ms de un valor obtenido comparte el
mismo sort_weight para el rank especificado, la funcin devuelve NULL.

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 valor
ensimo ms alto.
Max - funcin de grfico([{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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

167

5 Funciones en scripts y en expresiones de grfico


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
FirstSortedValue() devuelve el valor de la expresin especificada en value que corresponda al resultado de
ordenar el argumento sort_weight, por ejemplo, el nombre del producto con el precio de unidad ms bajo.
El valor ensimo de la ordenacin se puede especificar en rank. Si ms de un valor obtenido comparte el
mismo sort_weight para el rank especificado, la funcin devuelve NULL. Los valores ordenados se repiten a
lo largo de una serie de registros, definidos por una clusula group by, o se agregan a todo el conjunto
completo de datos si no se ha definido ninguna clusula group by.

Sintaxis:
FirstSortedValue ([ distinct ] value, sort-weight [, rank ])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

value
Expression

La funcin halla el valor de la expresin value que corresponde al resultado de ordenar

sort_weight.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

168

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

sort-weight
Expression

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
Expression

Si se establece un rank "n" mayor que 1, devolver el ensimo valor en orden.

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:
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|12|25|2
Canutility|AA|3|8|3
Canutility|CC|13|19|3
Divadip|AA|9|16|4
Divadip|AA|10|16|4
Divadip|DD|11|10|4
] (delimiter is '|');

Customer MyProductWithSmallestOrderByCustomer
Astrida CC
Betacab AA
Canutility AA
Divadip DD

FirstSortedValue:
LOAD Customer,FirstSortedValue(Product,
UnitSales) as
MyProductWithSmallestOrderByCustomer Resident
Temp Group By Customer;

La funcin ordena UnitSales de menor a mayor,


buscando el valor de Customer con el menor valor
de UnitSales, el orden ms pequeo.
Porque CC se corresponde con el menor valor
(valor de UnitSales=2) para el cliente Astrida. AA
corresponde al pedido ms pequeo (4) para el
cliente Betacab, CC corresponde al pedido ms
pequeo (8) para el cliente Canutility y DD
corresponde al pedido ms pequeo (10) para el
cliente Divadip..

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

169

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Dado que la tabla Temp se carga como en el

Customer MyProductWithLargestOrderByCustomer
Astrida AA
Betacab DD
Canutility CC
Divadip -

ejemplo anterior:
LOAD Customer,FirstSortedValue(Product, UnitSales) as MyProductWithLargestOrderByCustomer
Resident Temp Group By Customer;

Un signo menos precede al argumento sort_


weight, as que la funcin ordena el ms grande
primero.
Porque AA corresponde al pedido ms grande
(valor de UnitSales:18) para el cliente Astrida, DD
corresponde al pedido ms grande (12) para el
cliente Betacab y CC corresponde al pedido ms
grande (13) para el cliente Canutility. Hay dos
valores idnticos para el pedido ms grande (16)
para el cliente Divadip, por lo tanto esto da un
resultado nulo.

Dado que la tabla Temp se carga como en el


ejemplo anterior:
LOAD Customer,FirstSortedValue(distinct Product,
-UnitSales) as
MyProductWithSmallestOrderByCustomer Resident
Temp Group By Customer;

Customer MyProductWithLargestOrderByCustomer
Astrida AA
Betacab DD
Canutility CC
Divadip AA

Esto es igual al ejemplo anterior, excepto en que


se utiliza el cualificador distinct. Esto hace que se
descarte el resultado duplicado de Divadip,
permitiendo que devuelva un valor no nulo.

FirstSortedValue - funcin de grfico


FirstSortedValue() devuelve el valor de la expresin especificada en value que corresponda al resultado de
ordenar el argumento sort_weight, por ejemplo, el nombre del producto con el precio de unidad ms bajo.
El valor ensimo de la ordenacin se puede especificar en rank. Si ms de un valor obtenido comparte el
mismo sort_weight para el rank especificado, la funcin devuelve NULL.

Sintaxis:
FirstSortedValue([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] value,
sort_weight [,rank])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

value

Campo de salida. La funcin halla el valor de la expresin value que corresponde al


resultado de ordenar sort_weight.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

170

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

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 puede 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

UnitSales

UnitPrice

Astrida

AA

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Canutility

CC

19

Ejemplo

Resultado

firstsortedvalue (Product,
UnitPrice)

BB, que es el producto Product con el precio por unidad UnitPrice ms


bajo (9).

firstsortedvalue (Product,
UnitPrice, 2)

BB, que es el Product con el segundo UnitPrice ms bajo (10).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

171

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

firstsortedvalue (Customer, UnitPrice, 2)

Betacab, que es el Customer con el Product que tiene el segundo


UnitPrice (20) ms bajo.

firstsortedvalue (Customer,
UnitPrice, 3)

NULL, porque hay dos valores de Customer (Astrida y Canutility) con el


mismo rank (el tercero ms bajo) UnitPrice (15).
Utilice el cualificador distinct para garantizar que no ocurran resultados
nulos inesperados.

firstsortedvalue (Customer, UnitPrice*UnitSales, 2)

Canutility, que es el Customer con el segundo valor ms alto del pedido


de ventas UnitPrice multiplicado por UnitSales (120).

Datos utilizados 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 '|');

Max
Max() encuentra el valor numrico ms alto de los datos agregados en la expresin, segn lo definido por
una clusula group by. Al especificar un rank n, puede hallarse el valor ensimo ms alto.

Sintaxis:
Max ( expr [, rank])
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

expr
Expression

La expresin o el campo que contiene los datos que se han de medir.

rank
Expression

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

172

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:
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|DD|3|8
Canutility|CC
] (delimiter is '|');

Customer

MyMax

Astrida

18

Betacab

Canutility

Dado que la tabla Temp se carga como en el ejemplo anterior:

Customer

MyMaxRank2

LOAD Customer, Max(UnitSales,2) as MyMaxRank2 Resident Temp Group By


Customer;

Astrida

10

Betacab

Canutility

Max:
LOAD Customer, Max(UnitSales) as MyMax, Resident Temp Group By
Customer;

Max - funcin de grfico


Max() halla el valor ms alto de los datos agregados. Al especificar un rank n, puede hallarse el valor
ensimo 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}] [TOTAL [<fld {,fld}>]] expr [,rank])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

173

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Canutility

CC

19

Ejemplos

Resultados

Max(UnitSales)

10, porque este es el valor ms alto en UnitSales.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

174

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

El valor de un pedido se
calcula a partir del nmero
de unidades vendidas en
(UnitSales) multiplicado por
el precio de unidad.

150, porque este es el valor ms alto del resultado de calcular todos los
valores posibles de (UnitSales)*(UnitPrice).

Max(UnitSales*UnitPrice)
Max(UnitSales, 2)

9, que es el segundo valor ms alto.

Max(TOTALUnitSales)

10, porque el cualificador TOTAL significa que encuentra el valor ms alto


posible, descartando 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,
sea cual sea la seleccin efectuada.

Max({1} TOTALUnitSales)

Datos utilizados 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
p

FirstSortedValue - funcin de grfico (pgina 170)


RangeMax (pgina 611)

Min
Min() devuelve el valor numrico ms bajo de los datos agregados en la expresin, segn lo definido por una
clusula group by. Al especificar un rank n, puede hallarse el ensimo valor ms bajo.

Sintaxis:
Min ( expr [, rank])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

175

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

expr
Expression

La expresin o el campo que contiene los datos que se han de medir.

rank
Expression

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:
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|DD|3|8
Canutility|CC
] (delimiter is '|');

Customer

MyMin

Astrida

Betacab

Canutility

Dado que la tabla Temp se carga como en el ejemplo anterior:

Customer

MyMinRank2

LOAD Customer, Min(UnitSales,2) as MyMinRank2 Resident Temp Group By


Customer;

Astrida

Betacab

Canutility

Min:
LOAD Customer, Min(UnitSales) as MyMin Resident Temp Group By
Customer;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

176

5 Funciones en scripts y en expresiones de grfico


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 que devuelve: 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 puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

177

5 Funciones en scripts y en expresiones de grfico


Customer

Product

UnitSales

UnitPrice

Betacab

CC

20

Betacab

DD

25

Canutility

AA

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
calcula a partir del nmero
de unidades vendidas en
(UnitSales) multiplicado por
el precio de unidad.

40, porque este es el valor no NULL ms bajo del resultado de calcular


todos los valores posibles de (UnitSales)*(UnitPrice).

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, descartando 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,
sea cual sea la seleccin efectuada.

Min({1} TOTALUnitSales)

Datos utilizados 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 '|');

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

178

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p
p

FirstSortedValue - funcin de grfico (pgina 170)


RangeMin (pgina 614)

Mode
Mode() devuelve el valor numrico ms repetido, el valor de la moda, de los datos agregados en la
expresin, segn lo definido por una clusula group by. La funcin Mode() puede devolver tanto valores
numricos como valores de texto.

Sintaxis:
Mode ( expr)
Tipo de datos que devuelve: dual
Argumento

Descripcin

expr Expression

La expresin o el campo que contiene los datos que se han de medir.

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:
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|DD|3|8
Canutility|CC
] (delimiter is '|');

MyMostOftenSoldProduct
AA
porque AA es el nico producto que se ha
vendido ms de una vez.

Mode:
LOAD Customer, Mode(Product) as MyMostOftenSoldProduct
Resident Temp Group By Customer;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

179

5 Funciones en scripts y en expresiones de grfico


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 que devuelve: 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 puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Canutility

CC

19

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

180

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Mode(UnitPrice)

15, porque este es el valor ms comn en UnitSales.

Seleccione
Customer A.

Devuelve NULL (-). Ningn valor nico ocurre ms a menudo que otro.

Mode(Product)

AA, porque este es el valor que ms veces se da en Product.

Seleccione
Customer A.

Devuelve NULL (-). Ningn valor nico ocurre ms a menudo que otro.

Mode
(TOTALUnitPrice)

15, porque el cualificador TOTAL significa que el valor ms comn sigue siendo 15,
incluso descartando las dimensiones del grfico.

Seleccione
Customer B.

15, 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.

Mode)({1}
TOTALUnitPrice)

Datos utilizados 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
p

Avg - funcin de grfico (pgina 221)


Median - funcin de grfico (pgina 254)

Only
Only() devuelve un valor si hay nicamente un resultado posible en los datos agregados. Si los registros
contienen solo un valor entonces devuelve ese valor, si no devuelve NULL. Use la clusula group by para
evaluar varios registros. La funcin Only() puede devolver valores numricos y valores de texto.

Sintaxis:
Only ( expr )
Tipo de datos que devuelve: dual
Argumento

Descripcin

expr Expression

La expresin o el campo que contiene los datos que se han de medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

181

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:
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|DD|3|8
Canutility|CC
] (delimiter is '|');

Customer

MyUniqIDCheck

Astrida

1
porque solo el cliente Astrida tiene
registro completos que incluyen
CustomerID.

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 que devuelve: 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 puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

182

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.

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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Canutility

CC

19

Ejemplos

Resultados

Only({<UnitPrice={9}>}
Product)

BB, porque este es el nico Productque tiene un UnitPrice de "9".

Only({<Product={DD}>}
Customer)

B, porque es el nico Customer que vende un Product llamado "DD".

Only({<UnitPrice={20}>}
UnitSales)

El nmero de UnitSales donde UnitPrice es 20 es 2, porque solo hay un valor


de UnitSales donde UnitPrice = 20.

Only({<UnitPrice={15}>}
UnitSales)

NULL, porque hay dos valores de UnitSales donde UnitPrice = 15.

Datos utilizados en los ejemplos:


ProductData:
LOAD * inline [

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

183

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
] (delimiter is '|');

Sum
Sum() calcula el total de los valores agregados en la expresin, segn lo definido por una clusula group
by.
Sintaxis:
sum ( [ distinct] expr)
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

distinct

Si la palabra distinct figura delante de la expresin, no se considerarn los duplicados.

expr Expression

La expresin o el campo que contiene los datos que se han de medir.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

184

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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|DD|3|8
Canutility|CC
] (delimiter is '|');

Customer

MySum

Astrida

39

Betacab

Canutility

Sum:
LOAD Customer, 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 que devuelve: 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 puede 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 cuando se han omitido algunos 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

185

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:

Customer

Product

UnitSales

UnitPrice

Astrida

AA

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

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
(TOTALUnitSales*UnitPrice)

505 para todas las filas de la tabla, as como el total, porque el


cualificador TOTAL 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
ALL, sea cual sea la seleccin efectuada.

Sum({1}
TOTALUnitSales*UnitPrice)

Datos utilizados 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 '|');

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

186

5 Funciones en scripts y en expresiones de grfico


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.
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
Count() devuelve el nmero de valores agregados en la expresin, segn lo definido por una clusula group
by.
Count ([distinct ] expression | * )
MissingCount
MissingCount() devuelve el nmero de valores agregados que faltan en la expresin, segn lo definido por
una clusula group by.

MissingCount ([ distinct ] expression)


NullCount
NullCount() devuelve el nmero de valores NULL agregados en la expresin, segn lo definido por una
clusula group by.

NullCount ([ distinct ] expression)


NumericCount
NumericCount() devuelve el nmero de valores numricos encontrados en la expresin, segn lo definido
por una clusula group by.

NumericCount ([ distinct ] expression)


TextCount
TextCount() devuelve el nmero de valores de campo no numricos agregados en la expresin, segn lo
definido 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:

Count
Count() se utiliza para agregar el nmero de valores, de texto y numricos en cada dimensin del grfico.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

187

5 Funciones en scripts y en expresiones de grfico


Count - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld
{,fld}>]]} expr)
MissingCount
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
Count() devuelve el nmero de valores agregados en la expresin, segn lo definido por una clusula group
by.
Sintaxis:
Count( [distinct ] expr)
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr Expression

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

188

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:
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 '|');

Customer OrdersByCustomer
Astrida 3
Betacab 3
Canutility 2
Divadip 2

Siempre y cuando la dimensin Customer est


incluida en la tabla en la hoja, de lo contrario, el
resultado de OrdersByCustomer es 3, 2.

Count1:
LOAD Customer,Count(OrderNumber) as
OrdersByCustomer Resident Temp Group By
Customer;

Dado que la tabla Temp se carga como en el


ejemplo anterior:
Dado que la tabla Temp se carga como en el
primer ejemplo:
LOAD Count(distinct OrderNumber) as
TotalOrdersNumber Resident Temp;

TotalOrderNumber
10
TotalOrderNumber
9

Porque hay dos valores de OrderNumber con el


mismo valor, 1.

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

189

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

25

Canutility

AA

15

Canutility

CC

Divadip

AA

Divadip

DD

19
4

16
25

En los ejemplos siguientes se da por sentado que se han seleccionado todos los clientes, excepto si se indica
lo contrario.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

190

5 Funciones en scripts y en expresiones de grfico


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.
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 veces que
aparece una nica vez.

Siempre y cuando el cliente


Canutility est seleccionado

0,2 porque la expresin devuelve el nmero de pedidos del cliente


seleccionado como un porcentaje de pedidos de la totalidad de clientes.
En este caso 2 /10.

Count (OrderNumber)/Count
({1} TOTALOrderNumber

Puesto que los clientes


Astrida y Canutility estn
seleccionados

5 porque ese es el nmero de pedidos de productos slo para los clientes


seleccionados y las celdas vacas se cuentan.

Count(TOTAL <Product>
OrderNumber)

Datos utilizados 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
MissingCount() devuelve el nmero de valores agregados que faltan en la expresin, segn lo definido por
una clusula group by.

Sintaxis:
MissingCount ( [ distinct ] expr)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

191

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr Expression

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.

Ejemplo

Resultado

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 '|');
MissCount1:
LOAD Customer,MissingCount(OrderNumber) as
MissingOrdersByCustomer Resident Temp Group By Customer;

Customer
MissingOrdersByCustomer
Astrida 0
Betacab 1
Canutility 2
Divadip 0

La segunda sentencia da:


TotalMissingCount
3

en una tabla con esa dimensin.

Load MissingCount(OrderNumber) as TotalMissingCount Resident


Temp;

Dado que la tabla Temp se carga como en el ejemplo anterior:

TotalMissingCountDistinct
1

LOAD MissingCount(distinct OrderNumber) as


TotalMissingCountDistinct Resident Temp;

Porque solo hay un


OrderNumber un valor que falta.

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 de script y funciones de grficos - Qlik Sense, 3.0

192

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
MissingCount({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr)
Tipo de datos que devuelve: 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 puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Canutility

CC

19

Divadip

AA

Divadip

DD

16
25

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

193

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

MissingCount([OrderNumber])

3 porque 3 de los 10 campos OrderNumber estn vacos

"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.
MissingCount
([OrderNumber])/MissingCount
({1} Total [OrderNumber])

La expresin devuelve el nmero de pedidos incompletos del cliente


seleccionado como una fraccin de pedidos incompletos de todos los
clientes. Hay un total de 3 valores perdidos para OrderNumber para
todos los clientes. As que, para cada cliente 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
NullCount() devuelve el nmero de valores NULL agregados en la expresin, segn lo definido por una
clusula group by.

Sintaxis:
NullCount ( [ distinct ] expr)
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr Expression

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

194

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

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=;
NullCount1:
LOAD Customer,NullCount(OrderNumber) as
NullOrdersByCustomer Resident Temp Group By Customer;

Customer NullOrdersByCustomer
Astrida 0
Betacab 0
Canutility 1

La segunda sentencia da:


TotalNullCount
1

en una tabla con esa dimensin, dado que


solo un registro contiene un valor null.

LOAD NullCount(OrderNumber) 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 que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

set_
expression

Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles


definidos por la seleccin. Se puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

195

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:
Ejemplo

Resultado

NullCount
([OrderNumber])

1 porque se ha introducido un valor null mediante NullInterpret en la sentencia


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
NumericCount() devuelve el nmero de valores numricos encontrados en la expresin, segn lo definido
por una clusula group by.

Sintaxis:
NumericCount ( [ distinct ] expr)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

196

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr Expression

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.

Ejemplo

Resultado

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|7|1|25
] (delimiter is '|');
NumCount1:
LOAD Customer,NumericCount(OrderNumber) as
NumericCountByCustomer Resident Temp Group By
Customer;

Customer
Astrida
Betacab
Canutility
Divadip

LOAD NumericCount(OrderNumber) as TotalNumericCount


Resident Temp;

La segunda sentencia proporciona:


TotalNumericCount
7
en una tabla con esa dimensin.

Dado que la tabla Temp se carga como en el ejemplo

TotalNumericCountDistinct
6
Porque hay un OrderNumber que duplica otro,
por lo que el resultado es 6, no hay duplicados.

anterior:
LOAD NumericCount(distinct OrderNumber) as
TotalNumeriCCountDistinct Resident Temp;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

NumericCountByCustomer
3
2
0
2

197

5 Funciones en scripts y en expresiones de grfico


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 que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

set_
expression

Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles


definidos por la seleccin. Se puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Canutility

CC

19

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

198

5 Funciones en scripts y en expresiones de grfico


Customer

Product

OrderNumber

UnitSales

Unit Price

Divadip

AA

16

Divadip

DD

25

En los ejemplos siguientes se da por sentado que se han seleccionado todos los clientes, excepto si se indica
lo contrario.

Ejemplo

Resultado

NumericCount
([OrderNumber])

7 porque tres de los 10 campos de OrderNumber estn vacos.

"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
([Product])

0 porque todos los nombres de productos estn en texto. Normalmente puede


utilizar esto para comprobar que a los campos de texto no se les ha dado
contenido numrico.

NumericCount
(DISTINCT
[OrderNumber])/Count
(DISTINCT
[OrderNumber)]

Cuenta el nmero de nmeros de pedido numricos distintos y lo divide por el


nmero de nmeros de pedido numricos y no numricos. Esto ser 1 si todos los
valores de campo son numricos. Normalmente puede utilizar esto para
comprobar que todos los valores de campo son numricos. En el ejemplo, hay 7
valores numricos distintos 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
TextCount() devuelve el nmero de valores de campo no numricos agregados en la expresin, segn lo
definido por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

199

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
TextCount ( [ distinct ] expr)
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

expr Expression

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.

Ejemplo

Resultado

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 '|');
TextCount1:
LOAD Customer,TextCount(Product) as ProductTextCount
Resident Temp Group By Customer;

Customer
Astrida
Betacab
Canutility
Divadip

LOAD Customer,TextCount(OrderNumber) as
OrderNumberTextCount Resident Temp Group By Customer;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

Customer
Astrida
Betacab
Canutility
Divadip

ProductTextCount
3
3
2
2

OrderNumberTextCount
0
1
2
0

200

5 Funciones en scripts y en expresiones de grfico


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 que devuelve: 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 puede 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

16

Astrida

AA

10

15

Astrida

BB

Betacab

BB

10

Betacab

CC

20

Betacab

DD

25

Canutility

AA

15

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

201

5 Funciones en scripts y en expresiones de grfico


Customer

Product

OrderNumber

Canutility

CC

Divadip

AA

Divadip

DD

UnitSales

Unit Price
19

16
25

Ejemplo

Resultado

TextCount
([Product])

10 porque los 10 campos en Product son texto.

"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
([OrderNumber])

3 porque las celdas vacas se cuentan. Normalmente podemos utilizar esto para
verificar que no se haya dado valores de texto a campos numricos o que son distintos
de cero.

TextCount
(DISTINCT
[Product])/Count
([Product)]

Cuenta todos los valores de texto distintos de Product (4), y lo divide por el nmero
total de valores de Product (10). El valor por defecto es 0,4.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

202

5 Funciones en scripts y en expresiones de grfico


Funciones financieras de agregacin en el script de carga de datos
IRR
IRR() devuelve la tasa interna agregada de devolucin de una serie de flujos de efectivo representados por
los nmeros en la expresin que se repite a lo largo de un nmero de registros definidos por una clusula
group by.
IRR (expression)
XIRR
XIRR() devuelve la tasa interna agregada de devolucin de una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por los nmeros pareados de pmt y date que se repiten a lo largo
de un nmero de registros definidos por una clusula group by Todos los pagos son descontados segn una
base de un ao de 365 das.

XIRR (valueexpression, dateexpression )


NPV
NPV() devuelve el valor presente neto agregado de una inversin basada en una tasa discount_rate por
perodo 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 un nmero de registros definidos por una clusula group by.
Se da por sentado que los pagos e ingresos se producen al final de cada perodo.
NPV (rate, expression)
XNPV
XNPV() devuelve el valor presente neto agregado para una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por nmeros pareados en pmt y date , 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. Todos
los pagos son descontados segn una base de un ao de 365 das.

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 en la 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 por perodo
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. Se da por sentado que los pagos e ingresos
se producen al final de cada perodo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

203

5 Funciones en scripts y en expresiones de grfico


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 pareados 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.
XIRR - funcin de grfico (pgina 210)([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 pareados de las expresiones dadas por pmt y

date que se repiten por las dimensiones del grfico. 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
IRR() devuelve la tasa interna agregada de devolucin de una serie de flujos de efectivo representados por
los nmeros en la expresin que se repite a lo largo de un nmero de registros definidos por una clusula
group by.
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.

Sintaxis:
IRR(value)
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

value

La expresin o el campo que contiene los datos que se han de medir.

Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos se descartan.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

204

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.

Ejemplos y resultados:
Ejemplo

Resultado

Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Year

IRR2013

2013

0.1634

Cashflow1:
LOAD Year,IRR(Payments) as IRR2013 Resident Cashflow 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 en la 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)
Tipo de datos que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

205

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, los valores NULL y los valores perdidos se descartan.

Ejemplos y resultados:
Ejemplo

Resultado

IRR
(Payments)

0,1634
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 realizaron
dichos pagos.

Datos utilizados en los ejemplos:


Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Vea tambin:
p
p

XIRR - funcin de grfico (pgina 210)


Aggr - funcin de grfico (pgina 162)

NPV
NPV() devuelve el valor presente neto agregado de una inversin basada en una tasa discount_rate por
perodo 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 un nmero de registros definidos por una clusula group by.
Se da por sentado que los pagos e ingresos se producen al final de cada perodo.
Sintaxis:
NPV(discount_rate, value)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

206

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico. El resultado tiene un formato numrico predeterminado de
moneda.
Argumentos:
Argumento

Descripcin

discount_rate

discount_rate es la tasa de descuento a lo largo del periodo.

value

La expresin o el campo que contiene los datos que se han de medir.

Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos se descartan.

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.

Ejemplo

Resultado

Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Year

NPV1_2013

2013

-$540.12

Cashflow1:
LOAD Year,NPV(0.2, Payments) as NPV1_2013 Resident
Cashflow Group By Year;

Dado que la tabla Cashflow se carga como en el


ejemplo anterior:
LOAD Year,NPV(Discount, Payments) as NPV2_2013
Resident Cashflow Group By Year, Discount;

Tenga en cuenta que la clusula Group By ordena los


resultados por Year y Discount. El primer argumento,
discount_rate, se proporciona como un campo
(Discount), ms que como un nmero especfico y, por
tanto, se requiere un segundo criterio de clasificacin. Un
campo puede contener distintos valores, por lo que los
registros agregados deben clasificarse para permitir
distintos valores de Year y Discount.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

Year

Discount

NPV2_2013

2013
2013

0,1
0,2

-$3456,05
$5666,67

207

5 Funciones en scripts y en expresiones de grfico


NPV - funcin de grfico
NPV() devuelve el valor presente neto agregado de una inversin basada en una discount_rate por perodo
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. 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 que devuelve: numrico El resultado tiene un formato numrico predeterminado de
moneda.
Argumentos:
Argumento

Descripcin

discount_
rate

discount_rate es la tasa de descuento a lo largo del periodo.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

208

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

NPV(Discount, Payments)

-$540,12

Datos utilizados en los ejemplos:


Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Vea tambin:
p
p

XNPV - funcin de grfico (pgina 213)


Aggr - funcin de grfico (pgina 162)

XIRR
XIRR() devuelve la tasa interna agregada de devolucin de una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por los nmeros pareados de pmt y date que se repiten a lo largo
de un nmero de registros definidos por una clusula group by Todos los pagos son descontados segn una
base de un ao de 365 das.

Sintaxis:
XIRR(pmt, date )
Tipo de datos que devuelve: 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.

date

La expresin o el campo que contienen la planificacin de fechas correspondientes a los


pagos de los flujos de caja suministrados en pmt.

Limitaciones:
Los valores de texto, valores NULL y valores perdidos de cualquier parte o ambas partes de un par de datos
harn que se descarte el par de datos completo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

209

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.

Ejemplo

Resultado

Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Year

XIRR2013

2013

0.5385

Cashflow1:
LOAD Year,XIRR(Payments, Date) as XIRR2013 Resident Cashflow 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 pareados 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 que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

210

5 Funciones en scripts y en expresiones de 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,5385

Datos utilizados en los ejemplos:


Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Vea tambin:
p
p

IRR - funcin de grfico (pgina 205)


Aggr - funcin de grfico (pgina 162)

XNPV
XNPV() devuelve el valor presente neto agregado para una planificacin de flujos de efectivo (no
necesariamente peridicos) representados por nmeros pareados en pmt y date , 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. Todos
los pagos son descontados segn una base de un ao de 365 das.

Sintaxis:
XNPV(discount_rate, pmt, date)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

211

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico. El resultado tiene un formato numrico predeterminado de
moneda. .
Argumentos:
Argumento

Descripcin

discount_
rate

discount_rate es la tasa de descuento a lo largo del periodo.

pmt

La expresin o el campo que contiene los datos que se han de medir.

date

La expresin o el campo que contienen la planificacin de fechas correspondientes a los


pagos de los flujos de caja suministrados en pmt.

Limitaciones:
Los valores de texto, valores NULL y valores perdidos de cualquier parte o ambas partes de un par de datos
harn que se descarte el par de datos completo.

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.

Ejemplo

Resultado

Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Year

XNPV1_2013

2013

$2104.37

Cashflow1:
LOAD Year,XNPV(0.2, Payments, Date) as XNPV1_2013
Resident Cashflow Group By Year;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

212

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Dado que la tabla Cashflow se carga como en el

Year

Discount

XNPV2_2013

2013
2013

0,1
0,2

-$3164,35
$6800,00

ejemplo anterior:
LOAD Year,XNPV(Discount, Payments, Date) as XNPV2_
2013 Resident Cashflow Group By Year, Discount;

Tenga en cuenta que la clusula Group By ordena los


resultados por Year y Discount. El primer argumento,
discount_rate, se proporciona como un campo
(Discount), ms que como un nmero especfico y, por
tanto, se requiere un segundo criterio de clasificacin. Un
campo puede contener distintos valores, por lo que los
registros agregados deben clasificarse para permitir
distintos valores de Year y Discount.

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 pareados de las expresiones dadas por pmt y

date que se repiten por las dimensiones del grfico. 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 que devuelve: numrico El resultado tiene un formato numrico predeterminado de
moneda.
Argumentos:
Argumento

Descripcin

discount_
rate

discount_rate es la tasa de descuento a lo largo del periodo.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

213

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)

-$3164,35

Datos utilizados en los ejemplos:


Cashflow:
LOAD 2013 as Year, * inline [
Date|Discount|Payments
2013-01-01|0.1|-10000
2013-03-01|0.1|3000
2013-10-30|0.1|4200
2014-02-01|0.2|6800
] (delimiter is '|');

Vea tambin:
p
p

NPV - funcin de grfico (pgina 208)


Aggr - funcin de grfico (pgina 162)

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
Avg() encuentra el valor medio de los datos agregados en la expresin en un nmero de registros, segn lo
definido por una clusula group by.

Avg

([distinct] expression)

Correl
Correl() devuelve el coeficiente de correlacin agregado de una serie de coordenadas representadas por

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

214

5 Funciones en scripts y en expresiones de grfico


nmeros pareados en x-expression y y-expression, reiteradas en una serie de registros segn lo definido por
una clusula group by.

Correl (x-expression, y-expression)


Fractile
Fractile() encuentra el valor que corresponde al percentil (cuantil) de los datos agregados en la expresin en
un nmero de registros segn lo definido por una clusula group by.

Fractile (expression, fractile)


Kurtosis
Kurtosis() devuelve la curtosis de los datos en la expresin en un nmero de registros definidos por una
clusula group by.

Kurtosis

([distinct ] expression )

LINEST_B
LINEST_B() devuelve el valor b agregado (corte de 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 yexpression 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
LINEST_DF() devuelve el 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 yexpression 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
2

Esta funcin de script devuelve la estadstica F agregada (r /(1-r )) de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros pareados en la x-expression y yexpression 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
LINEST_M() 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 yexpression 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
2

LINEST_R2() devuelve el valor r agregado (coeficiente de determinacin) de una regresin lineal definida
por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros pareados en las

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

215

5 Funciones en scripts y en expresiones de grfico


expresiones x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una
clusula group by.

LINEST_R2 (y-expression, x-expression [, y0 [, x0 ]])


LINEST_seb
LINEST_SEB() 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
LINEST_SEM() 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
LINEST_SEY() devuelve el error estndar agregado del valor y estimado de una regresin lineal definida por
la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pares en x-expression y yexpression 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
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 pareados en las
expresiones 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
LINEST_SSRESID() 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 xexpression 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
Median() devuelve la mediana agregada de los valores en la expresin en un nmero de registros definidos
por una clusula group by.

Median (expression)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

216

5 Funciones en scripts y en expresiones de grfico


Skew
Skew() devuelve la asimetra de expresin a lo largo de un nmero de registros definidos por una clusula
group by.
Skew ([ distinct] expression)
Stdev
Stdev() devuelve la desviacin estndar de los valores dados por la expresin en un nmero de registros
definidos por una clusula group by.

Stdev ([distinct] expression)


Sterr
Sterr() 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
STEYX() 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

217

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 (corte de y) de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros pareados 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 pareados en las expresiones
proporcionados por 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 pareados 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 pareados 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 pareados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

218

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 pareados 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 pareados 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 pareados 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 pareados 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 pareados dados por las
expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.
LINEST_SSRESID - funcin de grfico({[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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

219

5 Funciones en scripts y en expresiones de grfico


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
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 pareados dados por las expresiones y_

value y x_value.
STEYX - funcin de grfico{[SetExpression] [TOTAL [<fld{, fld}>]]} y_value,
x_value)

Avg
Avg() encuentra el valor medio de los datos agregados en la expresin en un nmero de registros, segn lo
definido por una clusula group by.

Sintaxis:
Avg([DISTINCT] expr)
Tipo de datos que devuelve: numrico
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

220

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.

Ejemplo

Resultado

Temp:
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|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');

Customer MyAverageSalesByCustomer
Astrida 48.916667
Betacab 44.916667
Canutility 56.916667
Divadip 63.083333

Esto puede verificarse en la hoja


mediante la creacin de una tabla que
incluya la medida:
Sum(Sales)/12

Avg1:
LOAD Customer, Avg(Sales) as MyAverageSalesByCustomer
Resident Temp Group By Customer;

Dado que la tabla Temp se carga como en el ejemplo


anterior:
LOAD Customer,Avg(DISTINCT Sales) as MyAvgSalesDistinct
Resident Temp Group By Customer;

Customer MyAverageSalesByCustomer
Astrida 43.1
Betacab 43.909091
Canutility 55.909091
Divadip 61

Slo se cuentan los valores distintos.


Divida el total por el nmero de valores no
duplicados.

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 que devuelve: 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 puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

221

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.

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

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
(Sales))

53,458333 para todos los valores de Customer, porque el cualificador TOTAL significa que
las dimensiones se omiten.

Avg(DISTINCT
(Sales))

51,862069 para el total, porque usar el cualificador Distinct significa que solo se evalan
los valores exclusivos de Sales para cada Customer.

Datos utilizados en los ejemplos:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

222

5 Funciones en scripts y en expresiones de grfico


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 Sorting del
panel de propiedades, seleccione Month y active la casilla Sort by expression. En el cuadro de expresin,
escriba Monthnumber.

Vea tambin:
p

Aggr - funcin de grfico (pgina 162)

Correl
Correl() devuelve el coeficiente de correlacin agregado de una serie de coordenadas representadas por
nmeros pareados en x-expression y y-expression, reiteradas en una serie de registros segn lo definido por
una clusula group by.
Sintaxis:
Correl(value1, value2)
Tipo de datos que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

223

5 Funciones en scripts y en expresiones de grfico


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.

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.

Ejemplo

Resultado

Salary:
Load *, 1 as Grp;
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 '|');

En una tabla con la dimensin Correl_Salary, se mostrar el


resultado del clculo Correl() en el script de carga de datos:
0.9270611.

Correl1:
LOAD Grp,
Correl(Age,Salary) as Correl_
Salary Resident Salary Group By
Grp;

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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

224

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 puede 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:
Ejemplo

Resultado

Correl
(Age,
Salary)

Para una tabla que incluya la dimensin Employee name y la medida Correl(Age, Salary), es
resultado es 0,9270611. El resultado solo se muestra para la celda de totales.

Correl
(TOTAL
Age,
Salary))

0,927. Este resultado junto con los siguientes se muestran con tres decimales para una
mejor legibilidad.
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

225

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Correl
({1}
TOTAL
Age,
Salary))

0,927. Independiente de las selecciones. Esto es porque la expresin de conjunto {1}


descarta todas las selecciones y dimensiones.

Correl
(TOTAL
<Gender>
Age,
Salary))

0,927 en la celda del total, 0,939 para todos los valores de Male, y 0,951 para todos los
valores de Female. Esto corresponde a los resultados de hacer las selecciones en un panel
de filtrado basado en Gender.

Datos utilizados 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
p
p

Aggr - funcin de grfico (pgina 162)


Avg - funcin de grfico (pgina 221)
RangeCorrel (pgina 603)

Fractile
Fractile() encuentra el valor que corresponde al percentil (cuantil) de los datos agregados en la expresin en
un nmero de registros segn lo definido por una clusula group by.

Sintaxis:
Fractile(expr, fraction)
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

226

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

fraction

Un nmero entre 0 y 1 correspondiente al percentil (cuantil expresado como fraccin) que


se debe calcular.

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.

Ejemplo

Resultado

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 '|');

En una tabla con las dimensiones Type y MyFractile, los resultados


de los clculos de Fractile() en el script de carga de datos son:
Type MyFractile
Comparison 27.5
Observation 36

Fractile1:
LOAD Type,
Fractile(Value,0.75) as
MyFractile Resident Table1 Group
By Type;

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

227

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 puede 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

228

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Fractile
(Sales,
0.75)

Para una tabla que incluya la dimensin Customer y la medida Fractile([Sales]), si se


muestran los Totales, el resultado es 71,75. Este es el punto en la distribucin de valores

Fractile
(TOTAL
Sales,
0.75))

71,75 para todos los valores de Customer, porque el cualificador TOTAL significa que las
dimensiones se omiten.

Fractile
(DISTINCT
Sales,
0.75)

70 para el total, porque usar el cualificador DISTINCT significa que solo se evalan los
valores exclusivos de Sales para cada Customer.

de Sales por debajo del cual se sitan el 75% de los valores.

Datos utilizados 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 Sorting del
panel de propiedades, seleccione Month y active la casilla Sort by expression. En el cuadro de expresin,
escriba Monthnumber.

Vea tambin:
p

Aggr - funcin de grfico (pgina 162)

Kurtosis
Kurtosis() devuelve la curtosis de los datos en la expresin en un nmero de registros definidos por una
clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

229

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
Kurtosis([distinct ] expr )
Tipo de datos que devuelve: numrico
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

230

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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
'|');

En una tabla con las dimensiones Type, MyKurtosis1 y MyKurtosis2, los


resultados de los clculos de Kurtosis() en el script de carga de datos son:
Type MyKurtosis1 MyKurtosis2
Comparison -1.1612957 -1.4982366
Observation -1.1148768 -0.93540144

Kurtosis1:
LOAD Type,
Kurtosis(Value) as
MyKurtosis1,
Kurtosis(DISTINCT
Value) as MyKurtosis2
Resident Table1 Group
By Type;

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 que devuelve: numrico
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

231

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

SetExpression

Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles


definidos por la seleccin. Se puede 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:

Type

Valu
e

Comparis
on

2
7

3
8

3
1

1
9

3
4

2
9

3
7

Observati
on

35

4
0

1
2

1
5

2
1

1
4

4
6

1
0

2
8

4
8

1
6

3
0

3
2

4
8

3
1

2
2

1
2

3
9

1
9

2
5

Ejemplo

Resultado

Kurtosis
(Value)

Para una tabla que incluya la dimensin Type y la medida Kurtosis(Value), si se muestran los
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
(TOTAL
Value))

1,252 para todos los valores de Type, porque el cualificador TOTAL significa que las
dimensiones se omiten.

Datos utilizados en los ejemplos:


Table1:
crosstable LOAD recno() as ID, * inline [
Observation|Comparison
35|2

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

232

5 Funciones en scripts y en expresiones de grfico


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 221)

LINEST_B
LINEST_B() devuelve el valor b agregado (corte de 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 yexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.
Sintaxis:
LINEST_B (y_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

233

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

LINEST_B - funcin de grfico


LINEST_B() devuelve el valor b agregado (corte de y) de una regresin lineal definida por la ecuacin
y=mx+b de una serie de coordenadas representadas por nmeros pareados 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 que devuelve: 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_
const

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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

234

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_DF
LINEST_DF() devuelve el 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 yexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.
Sintaxis:
LINEST_DF (y_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

235

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados en las expresiones
proporcionados por 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]])
Tipo de datos que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

236

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_F
2

Esta funcin de script devuelve la estadstica F agregada (r /(1-r )) de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros pareados en la x-expression y yexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.

Sintaxis:
LINEST_F (y_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

237

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

238

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_M
LINEST_M() 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 yexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.
Sintaxis:
LINEST_M (y_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

239

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

240

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_R2
2

LINEST_R2() devuelve el valor r agregado (coeficiente de determinacin) de una regresin lineal definida
por la ecuacin y=mx+b de una serie de coordenadas representadas por nmeros pareados en las
expresiones 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_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

241

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

242

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_SEB
LINEST_SEB() 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_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

243

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

244

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_SEM
LINEST_SEM() 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_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

245

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

246

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_SEY
LINEST_SEY() devuelve el error estndar agregado del valor y estimado de una regresin lineal definida por
la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pares en x-expression y yexpression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.
Sintaxis:
LINEST_SEY (y_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

247

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

248

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

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 pareados en las
expresiones 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_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

249

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados dados
por las expresiones x_value e y_value que se repiten a lo largo de las dimensiones del grfico.
Sintaxis:
LINEST_SSREG([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value,
x_value[, y0_const[, x0_const]])
Tipo de datos que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

250

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

LINEST_SSRESID
LINEST_SSRESID() 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 xexpression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.
Sintaxis:
LINEST_SSRESID (y_value, x_value[, y0 [, x0 ]])
Tipo de datos que devuelve: 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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

251

5 Funciones en scripts y en expresiones de grfico


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.

Vea tambin:
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)

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 pareados 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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

252

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.

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
p

Un ejemplo de cmo utilizar las funciones linest (pgina 268)


Avg - funcin de grfico (pgina 221)

Median
Median() devuelve la mediana agregada de los valores en la expresin en un nmero de registros definidos
por una clusula group by.

Sintaxis:
Median (expr)
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Ejemplos y resultados:
Agregue el script de ejemplo en su app y ejectelo. Despus construya una tabla simple con Type y MyMedian
como dimensiones.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

253

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

Los resultados del clculo Median() son:


es MyMedian

Type

Comparison

es 2.5

Observation

es 26.5

Median1:
LOAD Type,
Median(Value) as MyMedian
Resident Table1 Group By Type;

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 que devuelve: 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 puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

254

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.

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:
Agregue el script de ejemplo en su app y ejectelo. Despus construya una tabla simple con Type y Median
(Value) como medida.
Totals debe estar habilitado en las propiedades de la tabla.

Ejemplo

Resultado

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 '|');

Los valores de la mediana de:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

Totals es 19

Comparison

es 2.5

Observation

es 26.5

255

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Avg - funcin de grfico (pgina 221)

Skew
Skew() devuelve la asimetra de expresin a lo largo de un nmero de registros definidos por una clusula
group by.
Sintaxis:
Skew([ distinct] expr)
Tipo de datos que devuelve: numrico
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. Despus construya una tabla simple con Type y MySkew
como dimensiones.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

256

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

Los resultados del clculo Skew() son:


es MySkew

Type

Comparison

es 0.86414768

Observation

es 0.32625351

Skew1:
LOAD Type,
Skew(Value) as MySkew
Resident Table1 Group By Type;

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)
Tipo de datos que devuelve: 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 puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

257

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.

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:
Agregue el script de ejemplo en su app y ejectelo. Despus construya una tabla simple con Type y Skew
(Value) como medida.
Totals debe estar habilitado en las propiedades de la tabla.

Ejemplo

Resultado

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
'|');

Los resultados del clculo Skew(Value) son:


l

Total es 0.23522195

Comparison

es 0.86414768

Observation

es 0.32625351

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

258

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Avg - funcin de grfico (pgina 221)

Stdev
Stdev() devuelve la desviacin estndar de los valores dados por la expresin en un nmero de registros
definidos por una clusula group by.

Sintaxis:
Stdev([distinct] expr)
Tipo de datos que devuelve: numrico
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. Despus construya una tabla simple con Type y MyStdev
como dimensiones.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

259

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

Los resultados del clculo Stdev() son:


es MyStdev

Type

Comparison

es 14.61245

Observation

es 12.507997

Stdev1:
LOAD Type,
Stdev(Value) as MyStdev
Resident Table1 Group By Type;

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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

260

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.

Ejemplos y resultados:
Agregue el script de ejemplo en su app y ejectelo. Despus construya una tabla simple con Type y Stdev
(Value) como medida.
Totals debe estar habilitado en las propiedades de la tabla.

Ejemplo

Resultado

Stdev(Value)
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
'|');

Los resultados del clculo Stdev(Value) son:


l

Total es 15.47529

Comparison

es 14.61245

Observation

es 12.507997

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

261

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p
p

Avg - funcin de grfico (pgina 221)


STEYX - funcin de grfico (pgina 266)

Sterr
Sterr() 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] expr)
Tipo de datos que devuelve: numrico
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.

Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos se descartan.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

262

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

En una tabla con las dimensiones Type y MySterr, los resultados del clculo
Sterr() en el script de carga de datos son:
Type MySterr
Comparison 3.2674431
Observation 2.7968733

Sterr1:
LOAD Type,
Sterr(Value) as MySterr
Resident Table1 Group By
Type;

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 que devuelve: 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 puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

263

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.

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:
Agregue el script de ejemplo en su app y ejectelo. Despus construya una tabla simple con Type y Sterr
(Value) como medida.
Totals debe estar habilitado en las propiedades de la tabla.

Ejemplo

Resultado

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 '|');

Los resultados del clculo Sterr(Value) son:


l

Total es 2.4468583

Comparison

es 3.2674431

Observation

es 2.7968733

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

264

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p
p

Avg - funcin de grfico (pgina 221)


STEYX - funcin de grfico (pgina 266)

STEYX
STEYX() 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_value, x_value)
Tipo de datos que devuelve: 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.

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.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

265

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Trend:
Load *, 1 as Grp;
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
'|');

En una tabla con la dimensin MySTEYX, el resultado del clculo de STEYX() en


los scripts de carga de datos es 2.0714764.

STEYX1:
LOAD Grp,
STEYX(KnownY,
KnownX) as MySTEYX
Resident Trend Group
By Grp;

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 pareados dados por las expresiones y_

value y x_value.
Sintaxis:
STEYX([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_value)
Tipo de datos que devuelve: 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 puede definir un conjunto alternativo de registros mediante
una expresin de anlisis de conjuntos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

266

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.

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:
Agregue el script de ejemplo en su app y ejectelo. Despus construya una tabla simple con KnownY and
KnownX como dimensin y Steyx(KnownY,KnownX) como medida.
Totals debe estar habilitado en las propiedades de la tabla.

Ejemplo

Resultado

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
'|');

El resultado del clculo STEYX(KnownY,KnownX) es 2,071 (Si el formato


numrico est limitado a 3 decimales.)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

267

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p
p

Avg - funcin de grfico (pgina 221)


Sterr - funcin de grfico (pgina 263)

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. Las funciones linest pueden utilizarse en el script de carga de
datos y en las expresiones de grficos.
Le remitimos a los temas de funciones de grficos y scripts linest para obtener 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
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,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

268

5 Funciones en scripts y en expresiones de grfico


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.

Visualizar los resultados de los clculos de scripts de carga de datos


1. Haga lo siguiente:
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 una tabla y desde Campos aada lo siguiente como columnas:
l

Linest_B

Linest_DF

Linest_F

Linest_M

Linest_R2

Linest_SEB

Linest_SEM

Linest_SEY

Linest_SSREG

Linest_SSRESID

La tabla que contiene los resultados de los clculos linest realizados en el script de carga de datos debera
tener el aspecto siguiente:

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

Crear visualizaciones linest de funciones de grficos


Haga lo siguiente:

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

269

5 Funciones en scripts y en expresiones de grfico


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 los elementos siguientes 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 Linest functions 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) )

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

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

270

5 Funciones en scripts y en expresiones de grfico


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.

Funciones de prueba T
Las funciones de prueba t se utilizan para el examen estadstico de dos promedios de poblacin. Una prueba
t de dos muestras analiza si dos muestras son distintas y es muy habitual utilizarla cuando dos distribuciones
normales tienen variaciones desconocidas y cuando un experimento utiliza un tamao de muestra pequeo.

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.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Chi2Test_chi2
Chi2Test_chi2() devuelve el valor agregado de la prueba chi2 de una o dos series de valores.
Chi2Test_chi2(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
valores.
Chi2Test_df(col, row, actual_value[, expected_value])
Chi2Test_p
Chi2Test_p() devuelve el valor p (grado de libertad) agregado de la prueba chi2 de una o dos series de
valores.
Chi2Test_p - funcin de grfico(col, row, actual_value[, expected_value])

Vea tambin:
p

Funciones de prueba T (pgina 274)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

271

5 Funciones en scripts y en expresiones de grfico


p

Funciones de prueba Z (pgina 310)

Chi2Test_chi2
Chi2Test_chi2() devuelve el valor agregado de la prueba chi2 de una o dos series de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Todos Qlik Sense Las funciones de prueba chi2 tienen los mismos argumentos.

Sintaxis:
Chi2Test_chi2(col, row, actual_value[, expected_value])
Tipo de datos que devuelve: 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
p

Ejemplos de cmo utilizar funciones chi2-test en grficos (pgina 326)


Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos (pgina 329)

Chi2Test_df
Chi2Test_df() devuelve el valor df (grado de libertad) agregado de la prueba chi2 de una o dos series de
valores.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

272

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Todos Qlik Sense Las funciones de prueba chi2 tienen los mismos argumentos.

Sintaxis:
Chi2Test_df(col, row, actual_value[, expected_value])
Tipo de datos que devuelve: 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
p

Ejemplos de cmo utilizar funciones chi2-test en grficos (pgina 326)


Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos (pgina 329)

Chi2Test_p - funcin de grfico


Chi2Test_p() devuelve el valor p (grado de libertad) agregado de la prueba chi2 de una o dos series de
valores. 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.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

273

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Todos Qlik Sense Las funciones de prueba chi2 tienen los mismos argumentos.

Sintaxis:
Chi2Test_p(col, row, actual_value[, expected_value])
Tipo de datos que devuelve: 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
p

Ejemplos de cmo utilizar funciones chi2-test en grficos (pgina 326)


Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos (pgina 329)

Funciones de prueba T
Las funciones de prueba t se utilizan para el examen estadstico de dos promedios de poblacin. Una prueba
t de dos muestras analiza si dos muestras son distintas y es muy habitual utilizarla cuando dos distribuciones
normales tienen variaciones desconocidas y cuando un experimento utiliza un tamao de muestra pequeo.
En los siguientes apartados, las funciones estadsticas de prueba t se agrupan conforme a la prueba de
muestra de estudiante que se aplica a cada tipo de funcin.
Vea: Crear un informe t-test tpico (pgina 331)

Dos pruebas t de muestras independientes


Las funciones descritas a continuacin se aplican a pruebas t de estudiante de dos muestras independientes.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

274

5 Funciones en scripts y en expresiones de grfico


ttest_conf
TTest_conf devuelve el valor del intervalo de confianza de prueba t agregado de dos muestras
independientes.
TTest_conf ( grp, value [, sig[, eq_var]])
ttest_df
TTest_df() devuelve el valor t (grados de libertad) agregado de la prueba t de estudiante de dos series
independientes de valores.
TTest_df (grp, value [, eq_var)
ttest_dif
TTest_dif() es una funcin numrica que devuelve la diferencia agregada de medias de una prueba t de
estudiante de dos series independientes de valores.
TTest_dif (grp, value)
ttest_lower
TTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores.
TTest_lower (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.
TTest_sig (grp, value [, eq_var])
ttest_sterr
TTest_sterr() devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de media de
dos series independientes de valores.
TTest_sterr (grp, value [, eq_var])
ttest_t
TTest_t() devuelve el valor t agregado de dos series independientes de valores.
TTest_t (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.
TTest_upper (grp, value [, sig [, eq_var]])
Dos pruebas t ponderadas de muestras 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

275

5 Funciones en scripts y en expresiones de grfico


ttestw_conf
TTestw_conf() devuelve el valor t agregado de dos series independientes de valores.
TTestw_conf (weight, grp, value [, sig[, eq_var]])
ttestw_df
TTestw_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de dos series
independientes de valores.
TTestw_df (weight, grp, value [, eq_var])
ttestw_dif
TTestw_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de dos series
independientes de valores.
TTestw_dif ( 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.
TTestw_lower (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
independientes de valores.
TTestw_sig ( weight, grp, value [, eq_var])
ttestw_sterr
TTestw_sterr() devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de media
de dos series independientes de valores.
TTestw_sterr (weight, grp, value [, eq_var])
ttestw_t
TTestw_t() devuelve el valor t agregado de dos series independientes de valores.
TTestw_t (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.
TTestw_upper (weight, grp, value [, sig [, eq_var]])
Pruebas t de una muestra
Las funciones siguientes se aplican a pruebas t de estudiante de una muestra.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

276

5 Funciones en scripts y en expresiones de grfico


ttest1_conf
TTest1_conf() devuelve el valor del intervalo de confianza agregado de una serie de valores.
TTest1_conf (value [, sig])
ttest1_df
TTest1_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de una serie de
valores.
TTest1_df (value)
ttest1_dif
TTest1_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores.
TTest1_dif (value)
ttest1_lower
TTest1_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores.
TTest1_lower (value [, sig])
ttest1_sig
TTest1_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de una serie
de valores.
TTest1_sig (value)
ttest1_sterr
TTest1_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media
de una serie de valores.
TTest1_sterr (value)
ttest1_t
TTest1_t() devuelve el valor t agregado de una serie de valores.
TTest1_t (value)
ttest1_upper
TTest1_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de una serie
de valores.
TTest1_upper (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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

277

5 Funciones en scripts y en expresiones de grfico


ttest1w_conf
TTest1w_conf() es una funcin numeric que devuelve el valor del intervalo de confianza agregado de una
serie de valores.
TTest1w_conf (weight, value [, sig])
ttest1w_df
TTest1w_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de una serie de
valores.
TTest1w_df (weight, value)
ttest1w_dif
TTest1w_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores.
TTest1w_dif (weight, value)
ttest1w_lower
TTest1w_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores.
TTest1w_lower (weight, value [, sig])
ttest1w_sig
TTest1w_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de una
serie de valores.
TTest1w_sig (weight, value)
ttest1w_sterr
TTest1w_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media
de una serie de valores.
TTest1w_sterr (weight, value)
ttest1w_t
TTest1w_t() devuelve el valor t agregado de una serie de valores.
TTest1w_t ( weight, value)
ttest1w_upper
TTest1w_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de una
serie de valores.
TTest1w_upper (weight, value [, sig])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

278

5 Funciones en scripts y en expresiones de grfico


TTest_conf
TTest_conf devuelve el valor del intervalo de confianza de prueba t agregado de dos muestras
independientes.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_conf ( grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

279

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest_df
TTest_df() devuelve el valor t (grados de libertad) agregado de la prueba t de estudiante de dos series
independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_df (grp, value [, eq_var])
Tipo de datos que devuelve: 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_df( Group, Value )
TTest_df( Group, Value, false )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

280

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest_dif
TTest_dif() es una funcin numrica que devuelve la diferencia agregada de medias de una prueba t de
estudiante de dos series independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_dif (grp, value [, eq_var] )
Tipo de datos que devuelve: 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

281

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest_lower
TTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_lower (grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

282

5 Funciones en scripts y en expresiones de grfico


TTest_lower( Group, Value, Sig, false )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

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.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_sig (grp, value [, eq_var])
Tipo de datos que devuelve: 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_sig( Group, Value )
TTest_sig( Group, Value, false )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

283

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest_sterr
TTest_sterr() devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de media de
dos series independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_sterr (grp, value [, eq_var])
Tipo de datos que devuelve: 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

284

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest_t
TTest_t() devuelve el valor t agregado de dos series independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_t(grp, value[, eq_var])
Tipo de datos que devuelve: 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:
TTest_t( Group, Value, false )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

285

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest_upper
TTest_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest_upper (grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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_upper( Group, Value )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

286

5 Funciones en scripts y en expresiones de grfico


TTest_upper( Group, Value, sig, false )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTestw_conf
TTestw_conf() devuelve el valor t agregado de dos series independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_conf (weight, grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

287

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 t-test tpico (pgina 331)

TTestw_df
TTestw_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de dos series
independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_df (weight, grp, value [, eq_var])
Tipo de datos que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

288

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_df( Weight, Group, Value )
TTestw_df( Weight, Group, Value, false )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTestw_dif
TTestw_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de dos series
independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_dif (weight, grp, value)
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

weight

Cada valor de value puede contarse una o ms veces dependiendo de su correspondiente


valor de peso en weight.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

289

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.

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.

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 t-test tpico (pgina 331)

TTestw_lower
TTestw_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_lower (weight, grp, value [, sig [, eq_var]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

290

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 dos 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 t-test tpico (pgina 331)

TTestw_sig
TTestw_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de dos series
independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

291

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_sig ( weight, grp, value [, eq_var])
Tipo de datos que devuelve: 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_sig( Weight, Group, Value )
TTestw_sig( Weight, Group, Value, false )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTestw_sterr
TTestw_sterr() devuelve el error estndar agregado de la prueba t de estudiante de la diferencia de media
de dos series independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

292

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_sterr (weight, grp, value [, eq_var])
Tipo de datos que devuelve: 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_sterr( Weight, Group, Value )
TTestw_sterr( Weight, Group, Value, false )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTestw_t
TTestw_t() devuelve el valor t agregado de dos series independientes de valores.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

293

5 Funciones en scripts y en expresiones de grfico


Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ttestw_t (weight, grp, value [, eq_var])
Tipo de datos que devuelve: 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 )
TTestw_t( Weight, Group, Value, false )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

294

5 Funciones en scripts y en expresiones de grfico


TTestw_upper
TTestw_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante independientes de dos muestras, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTestw_upper (weight, grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

295

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest1_conf
TTest1_conf() devuelve el valor del intervalo de confianza agregado de una serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_conf (value [, sig ])
Tipo de datos que devuelve: 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 dos 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_conf( Value )
TTest1_conf( Value, 0.005 )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

296

5 Funciones en scripts y en expresiones de grfico


TTest1_df
TTest1_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de una serie de
valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_df (value)
Tipo de datos que devuelve: 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 t-test tpico (pgina 331)

TTest1_dif
TTest1_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

297

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_dif (value)
Tipo de datos que devuelve: 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 t-test tpico (pgina 331)

TTest1_lower
TTest1_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_lower (value [, sig])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

298

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 dos 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 )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest1_sig
TTest1_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de una serie
de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_sig (value)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

299

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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_sig( Value )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest1_sterr
TTest1_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media
de una serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_sterr (value)
Tipo de datos que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

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.

Ejemplo:
TTest1_sterr( Value )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest1_t
TTest1_t() devuelve el valor t agregado de una serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_t (value)
Tipo de datos que devuelve: 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 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

301

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest1_upper
TTest1_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de una serie
de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1_upper (value [, sig])
Tipo de datos que devuelve: 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 dos 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 t-test tpico (pgina 331)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

302

5 Funciones en scripts y en expresiones de grfico


TTest1w_conf
TTest1w_conf() es una funcin numeric que devuelve el valor del intervalo de confianza agregado de una
serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_conf (weight, value [, sig ])
Tipo de datos que devuelve: 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 dos 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 t-test tpico (pgina 331)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

303

5 Funciones en scripts y en expresiones de grfico


TTest1w_df
TTest1w_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de una serie de
valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_df (weight, value)
Tipo de datos que devuelve: 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 t-test tpico (pgina 331)

TTest1w_dif
TTest1w_dif() devuelve la diferencia de medias agregada de una prueba t de estudiante de una serie de
valores.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

304

5 Funciones en scripts y en expresiones de grfico


Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_dif (weight, value)
Tipo de datos que devuelve: 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_dif( Weight, Value )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

TTest1w_lower
TTest1w_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

305

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_lower (weight, value [, sig ])
Tipo de datos que devuelve: 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 dos 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 t-test tpico (pgina 331)

TTest1w_sig
TTest1w_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba t de estudiante de una
serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

306

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
TTest1w_sig (weight, value)
Tipo de datos que devuelve: 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 t-test tpico (pgina 331)

TTest1w_sterr
TTest1w_sterr() devuelve el error estndar agregado de la prueba t del estudiante de la diferencia de media
de una serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_sterr (weight, value)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

307

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 t-test tpico (pgina 331)

TTest1w_t
TTest1w_t() devuelve el valor t agregado de una serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_t ( weight, value)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

308

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 t-test tpico (pgina 331)

TTest1w_upper
TTest1w_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de una
serie de valores.
Esta funcin se aplica a pruebas t de estudiante de una muestra en las que la serie de datos de entrada se
suministra en un formato de dos columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
TTest1w_upper (weight, value [, sig])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

309

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 dos 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_upper( Weight, Value )
TTest1w_upper( Weight, Value, 0.005 )

Vea tambin:
p

Crear un informe t-test tpico (pgina 331)

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.
Las funciones estadsticas de prueba z se agrupan conforme al tipo de datos de entrada que se aplica a la
funcin.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.
Vea: Ejemplos de cmo utilizar funciones z-test (pgina 334)

Funciones de formato de una columna


Las siguientes funciones se aplican a pruebas z con series simples de datos de entrada:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

310

5 Funciones en scripts y en expresiones de grfico


ztest_conf
ZTest_conf() devuelve el valor z agregado de una serie de valores.
ZTest_conf (value [, sigma [, sig ])
ztest_dif
ZTest_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores.
ZTest_dif (value [, sigma])
ztest_sig
ZTest_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de valores.
ZTest_sig (value [, sigma])
ztest_sterr
ZTest_sterr() devuelve el error estndar agregado de la prueba z de la diferencia de media de una serie de
valores.
ZTest_sterr (value [, sigma])
ztest_z
ZTest_z() devuelve el valor z agregado de una serie de valores.
ZTest_z (value [, sigma])
ztest_lower
ZTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores.
ZTest_lower (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.
ZTest_upper (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 agregado z de una serie de valores.
ZTestw_conf (weight, value [, sigma [, sig]])
ztestw_dif
ZTestw_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

311

5 Funciones en scripts y en expresiones de grfico


ZTestw_dif (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.
ZTestw_lower (weight, value [, sigma])
ztestw_sig
ZTestw_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de valores.
ZTestw_sig (weight, value [, sigma])
ztestw_sterr
ZTestw_sterr() devuelve el error estndar agregado de la prueba z de la diferencia de media de una serie de
valores.
ZTestw_sterr (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.
ZTestw_upper (weight, value [, sigma])
ztestw_z
ZTestw_z() devuelve el valor z agregado de una serie de valores.
ZTestw_z (weight, value [, sigma])

ZTest_z
ZTest_z() devuelve el valor z agregado de una serie de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_z(value[, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

312

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 z-test (pgina 334)

ZTest_sig
ZTest_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_sig(value[, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

313

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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_sig(Value-TestValue)

Vea tambin:
p

Ejemplos de cmo utilizar funciones z-test (pgina 334)

ZTest_dif
ZTest_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_dif(value[, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

314

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 z-test (pgina 334)

ZTest_sterr
ZTest_sterr() devuelve el error estndar agregado de la prueba z de la diferencia de media de una serie de
valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_sterr(value[, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

315

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 z-test (pgina 334)

ZTest_conf
ZTest_conf() devuelve el valor z agregado de una serie de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_conf(value[, sigma[, sig]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

316

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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.

sig

El nivel de significacin de cola dos 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 z-test (pgina 334)

ZTest_lower
ZTest_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_lower (grp, value [, sig [, eq_var]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

317

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 dos 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:
ZTest_lower( Group, Value )
ZTest_lower( Group, Value, sig, false )

Vea tambin:
p

Ejemplos de cmo utilizar funciones z-test (pgina 334)

ZTest_upper
ZTest_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

318

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
ZTest_upper (grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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:
ZTest_upper( Group, Value )
ZTest_upper( Group, Value, sig, false )

Vea tambin:
p

Ejemplos de cmo utilizar funciones z-test (pgina 334)

ZTestw_z
ZTestw_z() devuelve el valor z agregado de una serie de valores.
Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

319

5 Funciones en scripts y en expresiones de grfico


Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTestw_z (weight, value [, sigma])
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

value

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 z-test (pgina 334)

ZTestw_sig
ZTestw_sig() devuelve el nivel de significacin agregado de cola 2 de la prueba z de una serie de valores.
Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTestw_sig (weight, value [, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

320

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

value

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 z-test (pgina 334)

ZTestw_dif
ZTestw_dif() devuelve la diferencia de medias agregada de una prueba z de una serie de valores.
Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTestw_dif ( weight, value [, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

321

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

value

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 z-test (pgina 334)

ZTestw_sterr
ZTestw_sterr() devuelve el error estndar agregado de la prueba z de la diferencia de media de una serie de
valores.
Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTestw_sterr (weight, value [, sigma])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

322

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

value

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 z-test (pgina 334)

ZTestw_conf
ZTestw_conf() devuelve el valor del intervalo de confianza agregado z de una serie de valores.
Esta funcin se aplica a pruebas z en las que los datos de entrada se suministran en formato de dos
columnas ponderadas.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTest_conf(weight, value[, sigma[, sig]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

323

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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.

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 dos 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:
ZTestw_conf( Weight, Value-TestValue)

Vea tambin:
p

Ejemplos de cmo utilizar funciones z-test (pgina 334)

ZTestw_lower
ZTestw_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de dos series
independientes de valores.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis:
ZTestw_lower (grp, value [, sig [, eq_var]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

324

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 dos 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 )

Vea tambin:
p

Ejemplos de cmo utilizar funciones z-test (pgina 334)

ZTestw_upper
ZTestw_upper() devuelve el valor agregado para el extremo superior del intervalo de confianza de dos series
independientes de valores.
Esta funcin se aplica a pruebas t de estudiante de muestras independientes.
Si la funcin se utiliza en el script de carga de datos, los valores se repiten a lo largo de varios registros
definidos por una clusula group by.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

325

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
ZTestw_upper (grp, value [, sig [, eq_var]])
Tipo de datos que devuelve: 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 dos 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 )

Vea tambin:
p

Ejemplos de cmo utilizar funciones z-test (pgina 334)

Ejemplos de funciones estadsticas de prueba


En esta seccin aparecen ejemplos de funciones estadsticas de prueba aplicadas a grficos, as como de
scripts de carga de datos.

Ejemplos de cmo utilizar funciones chi2-test en grficos


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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

326

5 Funciones en scripts y en expresiones de grfico


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 ',');
// 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;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

327

5 Funciones en scripts y en expresiones de grfico


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 datos, 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.

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))

Result:
La tabla resultante para las funciones chi2-test de los datos de la Muestra 1 contendr los siguientes valores:

df

Chi2

0.820

2.21

Ejemplo: Muestra 2
Haga lo siguiente:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

328

5 Funciones en scripts y en expresiones de grfico


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).
Result:
La tabla resultante para las funciones chi2-test de los datos de la Muestra 2 contendr los siguientes valores:

df

Chi2

0.000309

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).
Result:
La tabla resultante para las funciones chi2-test de los datos de la Muestra 3 contendr los siguientes valores:

df

Chi2

0.000308

16.2

Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos


Las funciones chi2-test sirven para hallar valores asociados con anlisis estadstico de chi al cuadrado. En
esta seccin se describe cmo utilizar las funciones de prueba de distribucin de chi al cuadrado disponibles
en Qlik Sense, en el script de carga de datos. Le remitimos a los temas de funciones de script chi2-test para
descripciones de la sintaxis y los argumentos.
Este ejemplo utiliza una tabla que contiene el nmero de alumnos que obtienen una nota (A-F) para dos
grupos de estudiantes (I y II).
A

15

20

26

19

II

10

11

15

21

16

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

329

5 Funciones en scripts y en expresiones de grfico


Cargar los datos de muestra
Haga lo siguiente:

1. Cree una nueva app.


2. En el editor de carga de 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
];

3. Haga clic en l para cargar datos.


Ahora ya hemos cargado los datos de muestra.

Cargar los valores de la funcin chi2-test


Ahora cargaremos en una tabla nueva los valores de chi2-test basados en los datos de muestra y los
agruparemos por Grp.
Haga lo siguiente:

1. En el editor de carga de datos, aada lo siguiente al final del script:


// Sample_1 data is pre-aggregated... Note: make sure you set your DecimalSep='.' at the top
of the script.
Chi2_table:
LOAD Grp,
Chi2Test_chi2(Grp, Grade, Count) as chi2,
Chi2Test_df(Grp, Grade, Count) as df,
Chi2Test_p(Grp, Grade, Count) as p
resident Sample_1 group by Grp;

2. Haga clic en l para cargar datos.


Ahora ya hemos cargado los valores de chi2-test en una tabla denominada Chi2_table.

Resultados
Puede ver los valores de chi2-test resultantes en el visor del modelo de datos bajo Vista previa, deberan
tener el aspecto siguiente:
Grp

chi2

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

df

330

5 Funciones en scripts y en expresiones de grfico


I

16.00

0.007

II

9.40

0.094

Crear un informe t-test tpico


Un informe t-test de estudiante tpico incluye tablas con resultados de Group Statistics e 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

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

Sig.
t

df

(2tailed)

Mean
Difference

Standard
Error
Difference

95%

95%

Confidence

Confidence

Interval of

Interval of

the

the

Difference

Difference

(Lower)

(Upper)

Equal
Variance
not
Assumed

3.534

37.116717335823

0.001

15.2

4.30101

6.48625

23.9137

Equal
Variance
Assumed

3.534

38

0.001

15.2

4.30101

6.49306

23.9069

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
12|38

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

331

5 Funciones en scripts y en expresiones de grfico


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.


Crear la tabla Group Statistics
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 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

Count(Value)

Mean

Avg(Value)

Standard Deviation

Stdev(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.
Result:
Una tabla Group Statistics para estas muestras tendr el aspecto siguiente:

Type

Mean

Standard Deviation

Standard Error Mean

Comparison

20

11.95

14.61245

3.2674431

Observation

20

27.15

12.507997

2.7968933

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

332

5 Funciones en scripts y en expresiones de grfico


Crear la tabla Two Independent Sample Student's T-test
Haga lo siguiente:

1. Haga clic en @ Editar para editar la hoja.


2. Aada la expresin siguiente como una dimensin en la tabla.
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))

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
Difference

if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance


Assumed', 1)),TTest_sterr(Type, Value),TTest_sterr(Type, Value, 0))

95% Confidence
Interval of the
Difference (Lower)

if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance


Assumed', 1)),TTest_lower(Type, Value,(1-(95)/100)/2),TTest_lower(Type,
Value,(1-(95)/100)/2, 0))

95% Confidence
Interval of the
Difference (Upper)

if(ValueList (Dual('Equal Variance not Assumed', 0), Dual('Equal Variance


Assumed', 1)),TTest_upper(Type, Value,(1-(95)/100)/2),TTest_upper
(Type, Value,(1-(95)/100)/2, 0))

Result:
Una tabla Independent Sample Test para estas muestras tendr el aspecto siguiente:

Sig.
t

df

(2taile
d)

Equal
Varianc
e not
Assume
d

3.53
4

37.1167173358
23

0.001

Mean
Differenc
e

15.2

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

95%

95%

Standard

Confidenc

Confidenc

Error

e Interval

e Interval

Differenc

of the

of the

Difference

Difference

(Lower)

(Upper)

6.48625

23.9137

4.30101

333

5 Funciones en scripts y en expresiones de grfico

Sig.
t

df

(2taile
d)

Equal
Varianc
e
Assume
d

3.53
4

38

0.001

Mean
Differenc
e

15.2

95%

95%

Standard

Confidenc

Confidenc

Error

e Interval

e Interval

Differenc

of the

of the

Difference

Difference

(Lower)

(Upper)

6.49306

23.9069

4.30101

Ejemplos de cmo utilizar funciones z-test


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 ttest. 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

334

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 fcil de leer si se establece el formato numrico en la mayora de
las medidas como Nmero>Simple en lugar de como Auto. Pero para ZTest Sig, por
ejemplo, utilice el formato de nmeros: Personalizado, y ajuste despus el patrn de formato
a ###.
Result:
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

335

5 Funciones en scripts y en expresiones de grfico


Type

ZTest Conf

ZTest Dif

ZTest Sig

ZTest Sterr

ZTest Z

Value

5.48

27.15

0.001

2.80

9.71

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

4.52

20.49

Funciones de agregacin de cadena


En esta seccin se describen funciones de agregacin relativas a 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 de cadenas en el script de carga de datos


Concat
Concat() se utiliza para combinar valores de cadenas. La 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
FirstValue() devuelve el valor cargado primero en los registros definidos por la expresin, ordenados por una
clusula group by.

Esta funcin solo est disponible como funcin de script.


FirstValue

(expression)

LastValue
LastValue() devuelve el valor cargado en ltimo lugar en los registros definidos por la expresin, ordenados

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

336

5 Funciones en scripts y en expresiones de grfico


por una clusula group by.

Esta funcin solo est disponible como funcin de script.


LastValue

(expression)

MaxString
MaxString() encuentra valores de cadena en la expresin y devuelve el ltimo valor de texto clasificado en
un nmero de registros definidos por una clusula group by.

MaxString (expression )
MinString
MaxString() encuentra valores de cadena en la expresin y devuelve el primer valor de texto clasificado 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
Concat() se utiliza para combinar valores de cadenas. La 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 de script y funciones de grficos - Qlik Sense, 3.0

337

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
Concat ([ distinct ] string [, delimiter [, sort-weight]])
Tipo de datos que devuelve: cadena
Argumentos:
La expresin o campo que contiene la cadena que se ha de procesar.

Argumento

Descripcin

string

La expresin o campo que contiene la cadena que se ha de procesar.

delimiter

Cada valor puede ir separado por la cadena que se encuentra en el delimiter.

sort-weight

El orden de la concatenacin puede definirse en el valor de la dimensin sort-weight, si


existe; la cadena correspondiente al valor ms bajo aparece en primer lugar en la
concatenacin..

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.

Ejemplo

Resultado

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 '|');

SalesGroup

TeamConcat1

East

AlphaBetaDeltaGammaGamma

West

EpsilonEtaThetaZeta

SalesGroup

TeamConcat2

East

Alpha-Beta-Delta-Gamma

West

Epsilon-Eta-Theta-Zeta

Concat1:
LOAD SalesGroup,Concat(Team) as TeamConcat1
Resident TeamData Group By SalesGroup;

Dado que la tabla TeamData se carga como en el


ejemplo anterior:
LOAD SalesGroup,Concat(distinct Team,'-') as
TeamConcat2 Resident TeamData Group By SalesGroup;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

338

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Dado que la tabla TeamData se carga como en el

Puesto que se ha aadido el argumento para


sort-weight, los resultados se ordenan segn

ejemplo anterior:
LOAD SalesGroup,Concat(distinct Team,'-',Amount) as
TeamConcat2 Resident TeamData Group By SalesGroup;

el valor de la dimensin Amount.


SalesGroup

TeamConcat2

East

Delta-Beta-Gamma-Alpha

West

Eta-Epsilon-Zeta-Theta

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 que devuelve: cadena
Argumentos:
Argumento

Descripcin

string

La expresin o campo que contiene la cadena que se ha de procesar.

delimiter

Cada valor puede ir separado por la cadena que se encuentra en el delimiter.

sort-weight

El orden de la concatenacin puede definirse en el valor de la dimensin sort-weight, si


existe; la cadena correspondiente al valor ms bajo aparece en primer lugar en la
concatenacin..

SetExpression

Por defecto, la funcin de agregacin agregar sobre el conjunto de registros posibles


definidos por la seleccin. Se puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

339

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:

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
(DISTINCT
Team,', ')

Beta, Gamma, porque el calificador DISTINCT significa que el resultado Gamma


duplicado se ignora. Adems, el argumento delimitador se define como una coma seguida
por un espacio.

Concat
(TOTAL
<SalesGroup>
Team)

Todos los valores de cadena para todos los valores de Team se concatenan si se 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
<SalesGroup>
Team,';',
Amount)

Al aadir el argumento para sort-weight: Amount, los resultados se ordenan segn el


valor de la dimensin Amount. Los resultados pasan a ser
DeltaBetaGammaGammaAlpha y EtaEpsilonZEtaTheta.

Datos utilizados en el ejemplo:


TeamData:
LOAD * inline [
SalesGroup|Team|Date|Amount

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

340

5 Funciones en scripts y en expresiones de grfico


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 '|');

FirstValue
FirstValue() devuelve el valor cargado primero en los registros definidos por la expresin, ordenados por una
clusula group by.

Esta funcin solo est disponible como funcin de script.

Sintaxis:
FirstValue ( expr)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Limitaciones:
Si no se encuentra ningn valor de texto, 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

341

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

SalesGroup

FirstTeamLoaded

East

Gamma

West

Zeta

FirstValue1:
LOAD SalesGroup,FirstValue(Team) as FirstTeamLoaded Resident
TeamData Group By SalesGroup;

LastValue
LastValue() devuelve el valor cargado en ltimo lugar en los registros definidos por la expresin, ordenados
por una clusula group by.

Esta funcin solo est disponible como funcin de script.

Sintaxis:
LastValue ( expr )
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Limitaciones:
Si no se encuentra ningn valor de texto, 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

342

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

SalesGroup

LastTeamLoaded

East

Beta

West

Theta

LastValue1:
LOAD SalesGroup,LastValue(Team) as LastTeamLoaded Resident
TeamData Group By SalesGroup;

MaxString
MaxString() encuentra valores de cadena en la expresin y devuelve el ltimo valor de texto clasificado en
un nmero de registros definidos por una clusula group by.

Sintaxis:
MaxString ( expr )
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Limitaciones:
Si no se encuentra ningn valor de texto, 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

343

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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 '|');

SalesGroup

MaxString1

East

Gamma

West

Zeta

Dado que la tabla TeamData se carga como en el ejemplo anterior y que el

SalesGroup

MaxString2

script de carga de datos tiene la sentencia SET:


SET DateFormat='DD/MM/YYYY';:

East

01/11/2013

West

01/12/2013

Concat1:
LOAD SalesGroup,MaxString(Team) as MaxString1 Resident TeamData Group
By SalesGroup;

LOAD SalesGroup,MaxString(Date) as MaxString2 Resident TeamData Group


By SalesGroup;

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 que devuelve: 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 puede 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

344

5 Funciones en scripts y en expresiones de grfico


Limitaciones:
Si la expresin no contiene valores con una representacin de cadena. entonces devuelve NULL.

Ejemplos y resultados:

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

Ejemplo

Resultado

MaxString
(Team)

Hay tres valores de 20000 para la dimensin Amount: dos de Gamma (en fechas distintas) y
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
(Date)

2013/11/01 es el mayor valor Date de los tres asociados con la dimensin Amount. 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 '|');

MinString
MaxString() encuentra valores de cadena en la expresin y devuelve el primer valor de texto clasificado en
un nmero de registros definidos por una clusula group by.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

345

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
MinString ( expr )
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

Limitaciones:
Si no se encuentra ningn valor de texto, 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.

Ejemplo

Resultado

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 '|');

SalesGroup

MinString1

East

Alpha

West

Epsilon

Dado que la tabla TeamData se carga como en el ejemplo anterior y que el

SalesGroup

MinString2

script de carga de datos tiene la sentencia SET:


SET DateFormat='DD/MM/YYYY';:

East

01/05/2013

West

01062/2013

Concat1:
LOAD SalesGroup,MinString(Team) as MinString1 Resident TeamData Group
By SalesGroup;

LOAD SalesGroup,MinString(Date) as MinString2 Resident TeamData Group


By SalesGroup;

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 de script y funciones de grficos - Qlik Sense, 3.0

346

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
MinString({[SetExpression] [TOTAL [<fld {, fld}>]]} expr)
Tipo de datos que devuelve: 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 puede 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

West

17000

Epsilon

2013/09/01

West

19000

Zeta

2013/06/01

West

23000

Theta

2013/12/01

Ejemplos

Resultados

MinString
(Team)

Hay tres valores de 20000 para la dimensin Amount: dos de Gamma (en fechas distintas) y
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
(Date)

2013/11/01 es el valor Date ms temprano de los tres asociados con la dimensin Amount.
En este caso se supone que el script tiene la sentencia SET SET DateFormat='YYYY-

MM-DD';'

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

347

5 Funciones en scripts y en expresiones de grfico


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.
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

348

5 Funciones en scripts y en expresiones de grfico

Las dimensiones sintticas no se ven afectadas por las selecciones.

Sintaxis:
ValueList(v1 {,...})
Tipo de datos que devuelve: 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
of Orders',
'Average Order
Size', 'Total
Amount')

Cuando se utiliza para crear una dimensin en una tabla, por ejemplo, esto da
como resultado los tres valores de cadena como etiquetas de fila en la tabla. A
continuacin se puede hacer referencia a ellos en una expresin.

=IF( ValueList
('Number of
Orders', 'Average
Order Size', 'Total
Amount') = 'Number
of Orders', count
(SaleID), IF(
ValueList('Number
of Orders',
'Average Order
Size', 'Total
Amount') = 'Average
Order Size', avg
(Amount), sum
(Amount) ))

Esta expresin toma los valores de la dimensin creada y hace referencia a ellos
en una sentencia IF anidada como entrada para tres funciones de agregacin:

Datos utilizados en los ejemplos:


SalesPeople:
LOAD * INLINE [
SaleID|SalesPerson|Amount|Year
1|1|12|2013

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

349

5 Funciones en scripts y en expresiones de grfico


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.

Sintaxis:
ValueLoop(from [, to [, step ]])
Tipo de datos que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

350

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

ValueLoop
(1, 10)

De este modo se crea una dimensin en una tabla, por ejemplo, que se puede utilizar para
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
(2, 10,2)

Este ejemplo da como resultado valores numerados 2, 4, 6, 8 y 10 porque el argumento step


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)).
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 anidacin
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 162)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

351

5 Funciones en scripts y en expresiones de grfico

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.

Qlik SenseQlik Sense admite las funciones de color qliktechblue y qliktechgray para ofrecer
una buena compatibilidad con versiones anteriores; sin embargo, su utilizacin no se
recomienda.

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, donde el
color viene definido por los valores de hue (tono), saturation (saturacin) y luminosity (luminosidad) de
entre 0 y 1.

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 de rojo r, un componente de verde g y un componente de azul

b con valores de entre 0 y 255.


RGB (r, g, b)
Color
Color() se utiliza en expresiones para devolver la representacin de color del nmero de color n en la paleta
del grfico mostrada en las propiedades del grfico. La representacin de color es un valor dual en el que la
representacin de texto viene en forma de 'RGB(r, g, b)' donde r, g y b son nmeros entre 0 y 255 que
representan el valor de color rojo, verde y azul respectivamente. La representacin numrica es un entero
que representa los componentes de rojo, verde y azul.
Color (n)
Colormix1
Colormix1() se utiliza en expresiones para devolver una representacin de color ARGB a partir de un
degradado de dos colores, basado en un valor entre 0 y 1.
Colormix1 (Value , ColorZero , ColorOne)
Value es un nmero real entre 0 y 1.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

352

5 Funciones en scripts y en expresiones de grfico


l

Si Value = 0 devuelve ColorZero .

Si Value = 1 devuelve ColorOne .

Si 0 < Value < 1 devuelve el correspondiente sombreado intermedio apropiado.

ColorZero es una representacin de color RGB vlida para que el color se asocie al lmite ms bajo del
intervalo.
ColorOne es una representacin de color RGB vlida para que el color se asocie al lmite ms alto del
intervalo.

Ejemplo:
Colormix1(0.5, red(), blue())

devuelve:
ARGB(255,64,0,64) (purple)

Colormix2
Colormix2() se utiliza en expresiones para devolver una representacin de color ARGB a partir de un
degradado de dos colores basados en un valor entre -1 y 1 con posibilidad de especificar un color intermedio
para la posicin central (0).
Colormix2 (Value ,ColorMinusOne , ColorOne[ , ColorZero])
Value es un nmero real entre -1 y 1.
l

Si Value = -1 devuelve el primer color.

Si Value = 1 devuelve el segundo color.

Si -1 < Value < 1 devuelve la mezcla de color apropiada.

ColorMinusOne es una representacin de color RGB vlida para que el color se asocie al lmite ms bajo del
intervalo.
ColorOne es una representacin de color RGB vlida para que el color se asocie al lmite ms alto del
intervalo.
ColorZero es una representacin opcional vlida de color RGB para que el color se asocie con el centro del
intervalo.

SysColor
SysColor() devuelve la representacin de color ARGB para el color del sistema Windows nr, donde nr
corresponde al parmetro de la funcin API de Windows GetSysColor(nr).

SysColor (nr)
ColorMapHue
ColorMapHue() devuelve un valor ARGB de un color desde un mapa de color que vara el componente de
tonalidad del modelo de color HSV. El mapa de color empieza con el color rojo, pasa por el amarillo, el

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

353

5 Funciones en scripts y en expresiones de grfico


verde, el cyan, el azul, el magenta y vuelve al rojo. x debe especificarse como un valor entre 0 y 1.

ColorMapHue (x)
ColorMapJet
ColorMapJet() devuelve un valor ARGB de un color desde un mapa de color que empieza con el color azul,
pasa por el cyan, el amarillo y el naranja para, a continuacin, volver al rojo. x debe especificarse como un
valor entre 0 y 1.
ColorMapJet (x)

Funciones de colores predefinidos


Las funciones siguientes pueden utilizarse en expresiones para colores predefinidos. Cada funcin devuelve
una representacin de color RGB.
De manera opcional, es posible especificar un parmetro para el factor alfa, en cuyo caso se devolver una
representacin de color ARGB. El factor alfa 0 corresponde con una transparencia total, mientras que el
factor alfa de 255 corresponde a una opacidad total. Si no se introduce un valor para alpha, se presupone
255.

Funcin de color

Valor RGB

black ([alpha])

(0,0,0)

blue([alpha])

(0,0,128)

brown([alpha])

(128,128,0)

cyan([alpha])

(0,128,128)

darkgray([alpha])

(128,128,128)

green([alpha])

(0,128,0)

lightblue([alpha])

(0,0,255)

lightcyan([alpha])

(0,255,255)

lightgray([alpha])

(192,192,192)

lightgreen([alpha])

(0,255,0)

lightmagenta([alpha])

(255,0,255)

lightred([alpha])

(255,0,0)

magenta([alpha])

(128,0,128)

red([alpha])

(128,0,0)

white([alpha])

(255,255,255)

yellow([alpha])

(255,255,0)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

354

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplos

Resultados

Blue()

RGB(0,0,128)

Blue(128)

ARGB(128,0,0,128)

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 que devuelve: 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 posiciones siguientes 00 denotan la cantidad de red, las dos posiciones siguientes
FF denotan la cantidad de green y las dos ltimas posiciones 00 denotan la cantidad de blue..

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 de rojo r, un componente de verde g y un componente de azul

b con valores de entre 0 y 255.


Sintaxis:
RGB (r, g, b)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

355

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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.

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 posiciones siguientes 00
denotan la cantidad de red, las dos posiciones siguientes FF denotan la cantidad de green y las dos ltimas
posiciones 00 denotan la cantidad de blue..

HSL
HSL() se utiliza en expresiones para fijar o evaluar las propiedades de color de un objeto grfico, donde el
color viene definido por los valores de hue (tono), saturation (saturacin) y luminosity (luminosidad) de
entre 0 y 1.

Sintaxis:
HSL (hue, saturation, luminosity)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

hue, saturation,
luminosity

valores de los componentes de hue, saturation, y luminosity que oscilan entre


0 y 1.

Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 1.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

356

5 Funciones en scripts y en expresiones de grfico


Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los
valores RGB 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 y RGB (0,255,0). Esto es equivalente a
HSL (80/240, 240/240, 120/240) - un valor HSL de (0.33, 1, 0.5).

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.

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 ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

357

5 Funciones en scripts y en expresiones de grfico


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 ])

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(expr1[ , expr2 , expr3 , ...] , else)
Argumentos:
Argumento

Descripcin

expr1

La primera expresin para comprobar si hay una representacin numrica vlida.

expr2

La segunda expresin para comprobar si hay una representacin numrica vlida.

expr3

La tercera expresin para comprobar si hay una representacin numrica vlida.

else

Valor que devolver si ninguno de los parmetros anteriores tiene una representacin
numrica vlida.

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. Puede utilizarse para
gestionar los valores NULL en expresiones numricas.

Ejemplos y resultados:
Ejemplo

Resultado

alt( date#( dat , 'YYYY/MM/DD' ),


date#( dat , 'MM/DD/YYYY' ),
date#( dat , 'MM/DD/YY' ),
'No valid date' )

Esta expresin comprobar si el campo date contiene una fecha


conforme a cualquiera de los tres formatos de fecha
especificados. Si es as, devolver un valor dual con la cadena
original y una representacin numrica vlida de una fecha. Si
no se encuentra ninguna coincidencia, se devuelve el texto 'No
valid date' (sin ninguna representacin numrica vlida).

alt(Sales,0) + alt(Margin,0)

Esta expresin aade los campos Sales y Margin, sustituyendo


los valores que faltan (NULL) por un 0.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

358

5 Funciones en scripts y en expresiones de grfico


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:
Ejemplo

Resultado

class( var,10 ) con var = 23

devuelve '20<=x<30'

class( var,5,'value' ) con var = 23

devuelve '20<= value <25'

class( var,10,'x',5 ) con var = 23

devuelve '15<=x<25'

Ejemplo de datos en un script de carga:


En este ejemplo cargamos una tabla que contiene el nombre y la edad de las personas. Queremos aadir un
campo que clasifique las personas segn un grupo de edad con un intervalo de diez aos. La tabla de origen
tendr el siguiente aspecto:

Name

Age

John

25

Karen

42

Yoshi

53

Para aadir el campo de clasificacin por grupo de edad, puede aadir una sentencia de load precedente
utilizando la funcin class. En este ejemplo cargamos la tabla de origen mediante Datos Inline.
LOAD *,
class(Age, 10, 'age') As Agegroup;
LOAD * INLINE

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

359

5 Funciones en scripts y en expresiones de grfico


[ Age, Name
25, John
42, Karen
53, Yoshi];

Los datos resultantes que se han cargado quedan as:

Name

Age

Agegroup

John

25

20 <= age < 30

Karen

42

40 <= age < 50

Yoshi

53

50 <= age < 60

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.

Ejemplos y resultados:
Ejemplo

Resultado

if( Amount>= 0, 'OK', 'Alarm' )

Esta expresin comprueba si la cantidad es un nmero positivo


(0 o mayor) y devuelve 'OK' en caso afirmativo. Si la cantidad es
menor que 0, devuelve 'Alarm'.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

360

5 Funciones en scripts y en expresiones de grfico


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 ])

Si desea utilizar una comparacin que no distinga entre maysculas y minsculas, utilice la
funcin mixmatch. Si desea utilizar comodines y una comparacin que no distinga entre
maysculas y minsculas, utilice la funcin wildmatch.
Ejemplos y resultados:
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 ])

Si desea utilizar una comparacin que distinga entre maysculas y minsculas, utilice la
funcin match. Si desea utilizar comodines y una comparacin que no distinga entre
maysculas y minsculas, utilice la funcin wildmatch.
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])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

361

5 Funciones en scripts y en expresiones de grfico


Argumentos:
Argumento

Descripcin

n es un entero entre 1 y N.

Ejemplos y resultados:
Ejemplo

Resultado

pick( N, 'A','B',4, 6 )

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:
wildmatch( str, expr1 [ , expr2,...exprN ])

Si desea usar la comparacin sin comodines, use las funciones match o mixmatch.
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

362

5 Funciones en scripts y en expresiones de grfico


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.
autonumberhash256 (expression {, expression})

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 - script function
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 ( )
RowNo - chart function
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])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

363

5 Funciones en scripts y en expresiones de grfico


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.

Slo es posible conectar claves autonumber que hayan sido generadas en la misma carga de
datos, ya que el valor entero se genera segn el orden de lectura de la tabla. Si necesita utilizar
teclas que son persistentes entre cargas de datos, independientemente del orden de los datos
fuente, utilice las funciones hash128, hash160 o hash256.

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.

Ejemplo: Crear una clave compuesta


En este ejemplo creamos una clave compuesta utilizando la funcin autonumber para conservar la
memoria. El ejemplo es breve con fines de demostracin, pero sera significativo en una tabla con un nmero
elevado de filas.

Region

Year

Month

Sales

North

2014

May

245

North

2014

May

347

North

2014

June

127

South

2014

June

645

South

2013

May

367

South

2013

May

221

Los datos fuente se cargan mediante Datos Inline. Seguidamente, se aade un load precedente que crea
una clave compuesta a partir de los campos Region, Year y Month.
RegionSales:
LOAD *,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

364

5 Funciones en scripts y en expresiones de grfico


AutoNumber(Region&Year&Month) as RYMkey;
LOAD * INLINE
[ Region, Year, Month, Sales
North, 2014,
May,
245
North, 2014,
May,
347
North, 2014,
June,
127
South, 2014,
June,
645
South, 2013,
May, 367
South, 2013,
May,
221
];

La tabla resultante tiene el siguiente aspecto:

Region

Year

Month

Sales

RYMkey

North

2014

May

245

North

2014

May

347

North

2014

June

127

South

2014

June

645

South

2013

May

367

South

2013

May

221

En este ejemplo, puede hacer referencia a RYMkey, por ejemplo 1, en lugar de hacer referencia a la cadena
North2014May si desea enlazar a otra tabla.
Ahora cargaremos una tabla de costes fuente de un modo similar. Los campos Region, Year y Month se
excluyen del load precedente para evitar crear una clave sinttica, ya estamos creando una clave compuesta
con la funcin autonumber, vinculando las tablas.
RegionCosts:
LOAD Costs,
AutoNumber(Region&Year&Month) as RYMkey;
LOAD * INLINE
[ Region, Year, Month, Costs
South, 2013,
May,
167
North, 2014,
May,
56
North, 2014,
June,
199
South, 2014,
June,
64
South, 2013,
May, 172
South, 2013,
May,
126
];

Ahora podemos aadir una visualizacin de tabla a una hoja y aadir los campos Region, Year y Month,
adems de las medidas Sum para las ventas y los costes. La tabla tendra el aspecto siguiente:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

365

5 Funciones en scripts y en expresiones de grfico


Region

Year

Month

Totals

Sum([Sales])

Sum([Costs])

1952

784

North

2014

June

127

199

North

2014

May

592

56

South

2014

June

645

64

South

2013

May

588

465

Vea tambin:
p
p

autonumberhash128 (pgina 366)


autonumberhash256 (pgina 368)

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.

Slo es posible conectar claves autonumberhash128 que hayan sido generadas en la misma
carga de datos, ya que el valor entero se genera segn el orden de lectura de la tabla. Si
necesita utilizar teclas que son persistentes entre cargas de datos, independientemente del
orden de los datos fuente, utilice las funciones hash128, hash160 o hash256.

Sintaxis:
autonumberhash128(expression {, expression})
Ejemplo: Crear una clave compuesta
En este ejemplo creamos una clave compuesta utilizando la funcin autonumberhash128 para conservar la
memoria. El ejemplo es breve con fines de demostracin, pero sera significativo en una tabla con un nmero
elevado de filas.

Region

Year

Month

Sales

North

2014

May

245

North

2014

May

347

North

2014

June

127

South

2014

June

645

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

366

5 Funciones en scripts y en expresiones de grfico


Region

Year

Month

Sales

South

2013

May

367

South

2013

May

221

Los datos fuente se cargan mediante Datos Inline. Seguidamente, se aade un load precedente que crea
una clave compuesta a partir de los campos Region, Year y Month.
RegionSales:
LOAD *,
AutoNumberHash128(Region, Year, Month) as RYMkey;
LOAD * INLINE
[ Region, Year, Month, Sales
North, 2014,
May,
245
North, 2014,
May,
347
North, 2014,
June,
127
South, 2014,
June,
645
South, 2013,
May, 367
South, 2013,
May,
221
];

La tabla resultante tiene el siguiente aspecto:

Region

Year

Month

Sales

RYMkey

North

2014

May

245

North

2014

May

347

North

2014

June

127

South

2014

June

645

South

2013

May

367

South

2013

May

221

En este ejemplo, puede hacer referencia a RYMkey, por ejemplo 1, en lugar de hacer referencia a la cadena
North2014May si desea enlazar a otra tabla.
Ahora cargaremos una tabla de costes fuente de un modo similar. Los campos Region, Year y Month se
excluyen del load precedente para evitar crear una clave sinttica, ya estamos creando una clave compuesta
con la funcin autonumberhash128, vinculando las tablas.
RegionCosts:
LOAD Costs,
AutoNumberHash128(Region, Year, Month) as RYMkey;
LOAD * INLINE
[ Region, Year, Month, Costs

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

367

5 Funciones en scripts y en expresiones de grfico


South,
North,
North,
South,
South,
South,
];

2013,
2014,
2014,
2014,
2013,
2013,

May,
167
May,
56
June,
199
June,
64
May, 172
May,
126

Ahora podemos aadir una visualizacin de tabla a una hoja y aadir los campos Region, Year y Month,
adems de las medidas Sum para las ventas y los costes. La tabla tendra el aspecto siguiente:

Region

Year

Month

Totals

Sum([Sales])

Sum([Costs])

1952

784

North

2014

June

127

199

North

2014

May

592

56

South

2014

June

645

64

South

2013

May

588

465

Vea tambin:
p
p

autonumberhash256 (pgina 368)


autonumber (pgina 364)

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.

Slo es posible conectar claves autonumberhash256 que hayan sido generadas en la misma
carga de datos, ya que el valor entero se genera segn el orden de lectura de la tabla. Si
necesita utilizar teclas que son persistentes entre cargas de datos, independientemente del
orden de los datos fuente, utilice las funciones hash128, hash160 o hash256.

Sintaxis:
autonumberhash256(expression {, expression})

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

368

5 Funciones en scripts y en expresiones de grfico


Ejemplo: Crear una clave compuesta
En este ejemplo creamos una clave compuesta utilizando la funcin autonumberhash256 para conservar la
memoria. El ejemplo es breve con fines de demostracin, pero sera significativo en una tabla con un nmero
elevado de filas.

Region

Year

Month

Sales

North

2014

May

245

North

2014

May

347

North

2014

June

127

South

2014

June

645

South

2013

May

367

South

2013

May

221

Los datos fuente se cargan mediante Datos Inline. Seguidamente, se aade un load precedente que crea
una clave compuesta a partir de los campos Region, Year y Month.
RegionSales:
LOAD *,
AutoNumberHash256(Region, Year, Month) as RYMkey;
LOAD * INLINE
[ Region, Year, Month, Sales
North, 2014,
May,
245
North, 2014,
May,
347
North, 2014,
June,
127
South, 2014,
June,
645
South, 2013,
May, 367
South, 2013,
May,
221
];

La tabla resultante tiene el siguiente aspecto:

Region

Year

Month

Sales

RYMkey

North

2014

May

245

North

2014

May

347

North

2014

June

127

South

2014

June

645

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

369

5 Funciones en scripts y en expresiones de grfico


Region

Year

Month

Sales

RYMkey

South

2013

May

367

South

2013

May

221

En este ejemplo, puede hacer referencia a RYMkey, por ejemplo 1, en lugar de hacer referencia a la cadena
North2014May si desea enlazar a otra tabla.
Ahora cargaremos una tabla de costes fuente de un modo similar. Los campos Region, Year y Month se
excluyen del load precedente para evitar crear una clave sinttica, ya estamos creando una clave compuesta
con la funcin autonumberhash256, vinculando las tablas.
RegionCosts:
LOAD Costs,
AutoNumberHash256(Region, Year, Month) as RYMkey;
LOAD * INLINE
[ Region, Year, Month, Costs
South, 2013,
May,
167
North, 2014,
May,
56
North, 2014,
June,
199
South, 2014,
June,
64
South, 2013,
May, 172
South, 2013,
May,
126
];

Ahora podemos aadir una visualizacin de tabla a una hoja y aadir los campos Region, Year y Month,
adems de las medidas Sum para las ventas y los costes. La tabla tendra el aspecto siguiente:

Region

Year

Month

Totals

Sum([Sales])

Sum([Costs])

1952

784

North

2014

June

127

199

North

2014

May

592

56

South

2014

June

645

64

South

2013

May

588

465

Vea tambin:
p
p

autonumberhash128 (pgina 366)


autonumber (pgina 364)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

370

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
IterNo() as Day,
Date( StartDate + IterNo() - 1 ) as Date
While StartDate + IterNo() - 1 <= EndDate;

Esta sentencia LOAD genera un registropor fecha

LOAD * INLINE
[StartDate, EndDate
2014-01-22, 2014-01-26
];

dentro del rango definido por StartDate y EndDate.


En este ejemplo, la tabla resultante tendr el
siguiente aspecto:

Day

Date

2014-01-22

2014-01-23

2014-01-24

2014-01-25

2014-01-26

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( )

En contraste con RowNo( ), que cuenta las filas en la tabla de Qlik Sense resultante, RecNo( ), cuenta los
registros en la tabla de datos sin procesar y se restablece cuando una tabla de datos sin procesar se
concatena con otra.

Ejemplo: Script de carga de datos


Carga de tabla de datos sin procesar:
Tab1:
LOAD * INLINE
[A, B
1, aa

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

371

5 Funciones en scripts y en expresiones de grfico


2,cc
3,ee];
Tab2:
LOAD * INLINE
[C, D
5, xx
4,yy
6,zz];

Registro de carga y nmeros de fila de las filas seleccionadas:


QTab:
LOAD *,
RecNo( ),
RowNo( )
resident Tab1 where A<>2;
LOAD
C as A,
D as B,
RecNo( ),
RowNo( )
resident Tab2 where A<>5;
//We don't need the source tables anymore, so we drop them
Drop tables Tab1, Tab2;

La tabla Qlik Sense interna resultante:

RecNo( )

RowNo( )

aa

ee

yy

zz

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

372

5 Funciones en scripts y en expresiones de grfico

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.

Ejemplo: Script de carga de datos


Carga de tabla de datos sin procesar:
Tab1:
LOAD * INLINE
[A, B
1, aa
2,cc
3,ee];
Tab2:
LOAD * INLINE
[C, D
5, xx
4,yy
6,zz];

Registro de carga y nmeros de fila de las filas seleccionadas:


QTab:
LOAD *,
RecNo( ),
RowNo( )
resident Tab1 where A<>2;
LOAD
C as A,
D as B,
RecNo( ),
RowNo( )
resident Tab2 where A<>5;
//We don't need the source tables anymore, so we drop them
Drop tables Tab1, Tab2;

La tabla Qlik Sense interna resultante:

RecNo( )

RowNo( )

aa

ee

yy

zz

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

373

5 Funciones en scripts y en expresiones de grfico


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 campos interno.

Sintaxis:
RowNo([TOTAL])
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

TOTAL

Si la tabla es unidimensional o si se utiliza 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.

Ejemplos y resultados:

Customer

UnitSales

Row in Segment

Row Number

Astrida

Astrida

10

Astrida

Betacab

Betacab

Betacab

25

Canutility

10

Canutility
Divadip
Divadip

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

374

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Crea una visualizacin compuesta por una


tabla con las dimensiones Customer,

La columna Row in Segment muestra los resultados 1, 2,

UnitSales y agrega RowNo( ) y RowNo


(TOTAL) como medidas etiquetadas Row
in Segment y Row Number.

3 para el segmento de columna que contiene los valores de


UnitSales para el cliente Astrida. La numeracin de la fila
vuelve a comenzar por 1 de nuevo para el siguiente
segmento de columna, que es Betacab.
La columna Row Number descarga las dimensiones que
pueden utilizarse para contar las filas de la tabla.

Agregue la expresin:
IF( RowNo( )=1, 0, UnitSales / Above(
UnitSales ))

como una medida.

Esta expresin devuelve 0 para la primera fila de cada


segmento de columna, por lo que la columna mostrar:
0, 2,25, 1,1111111, 0, 2,5, 5, 0, 2,375, 0 y 4.

Datos utilizados 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 '|');

Vea tambin:
p

Above - funcin de grfico (pgina 553)

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 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

375

5 Funciones en scripts y en expresiones de grfico


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 no se corresponde con el 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 bien utilice una funcin de interpretacin.
En los ejemplos de cada funcin, se asumen los formatos de fecha y hora predefinidos hh:mm:ss yYYYYMM-DD (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
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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

376

5 Funciones en scripts y en expresiones de grfico


month
Esta funcin devuelve un valor dual: un nombre de mes tal y como venga definido en la variable de entorno
MonthNames y un entero entre 1 y 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)

Funciones de indicacin de tiempo


now
Esta funcin devuelve una fecha-hora con la hora actual segn el reloj del sistema. El valor por defecto es de
1.

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 ] ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

377

5 Funciones en scripts y en expresiones de grfico


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 del ao hh, el minuto mm y los segundos ss.

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 negativo, la fecha
que tiene lugar n meses antes de startdate.

addmonths (startdate, n , [ , mode])


AddYears
Esta funcin devuelve la fecha que tiene lugar n aos despus de startdate o, si n es negativo, la fecha que
tiene lugar n aos antes de startdate.

addyears (startdate, n)
yeartodate
Esta funcin halla si la fecha-hora de entrada cae en el ao de la fecha en que se carg el script, y devuelve
True en caso afirmativo, y False en caso negativo.

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

378

5 Funciones en scripts y en expresiones de grfico


Windows.

daylightsaving ( )
converttolocaltime
Convierte una fecha-hora UTC o GMT a una 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 toma como entrada una fecha-hora timestamp y un ao year y actualiza timestamp con el
ao year especificado en la entrada.

setdateyear

(timestamp, year)

setdateyearmonth
Esta funcin toma como entrada una fecha-hora timestamp, un mes month y un ao year y actualiza

timestamp con year y month especificados en la entrada.


setdateyearmonth

(timestamp, year, month)

Funciones in...
inyear
Esta funcin devuelve True si timestamp se encuentra dentro del ao que contiene base_date.

inyear (date, basedate , shift [, first_month_of_year = 1])


inyeartodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del ao que contiene base_date
hasta e incluido el ltimo milisegundo de base_date.

inyeartodate

(date, basedate , shift [, first_month_of_year = 1])

inquarter
Esta funcin devuelve True si timestamp se encuentra dentro del trimestre que contiene base_date.

inquarter

(date, basedate , shift [, first_month_of_year = 1])

inquartertodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del trimestre que contiene base_

date hasta e incluido el ltimo milisegundo de base_date.


inquartertodate

(date, basedate , shift [, first_month_of_year = 1])

inmonth
Esta funcin devuelve True si timestamp se encuentra dentro del mes que contiene base_date.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

379

5 Funciones en scripts y en expresiones de grfico


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
Esta funcin encuentra si una indicacin de fecha y hora cae dentro del mismo mes, periodo de dos meses,
trimestre, cuatrimestre o semestre dado como una fecha base. Tambin es posible hallar si la fecha-hora cae
dentro de un periodo de tiempo anterior o posterior.

inmonths (n, date, basedate , shift [, first_month_of_year = 1])


inmonthstodate
Esta funcin encuentra si una indicacin de fecha y hora cae dentro del mes, periodo de dos meses,
trimestre, cuatrimestre o semestre hasta e incluido el ltimo milisegundo de base_date. Tambin es posible
hallar si la fecha-hora cae dentro de un periodo anterior o posterior.

inmonthstodate

(n, date, basedate , shift [, first_month_of_year = 1])

inweek
Esta funcin devuelve True si timestamp se encuentra dentro de la semana que contiene base_date.

inweek (date, basedate , shift [, weekstart])


inweektodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte de la semana que contiene base_

date hasta e incluido el ltimo milisegundo de base_date.


inweektodate

(date, basedate , shift [, weekstart])

inlunarweek
Esta funcin halla si timestamp se encuentra dentro de la semana lunar que contiene base_date. Las
semanas lunares en Qlik Sense se definen contando 1 de enero como el primer da de la semana.

inlunarweek

(date, basedate , shift [, weekstart])

inlunarweektodate
Esta funcin halla si timestamp se encuentra dentro de la parte de la semana lunar hasta e incluido el ltimo
milisegundo de base_date. Las semanas lunares en Qlik Sense se definen contando 1 de enero como el
primer da de la semana.

inlunarweektodate

(date, basedate , shift [, weekstart])

inday
Esta funcin devuelve True si timestamp se encuentra dentro del da que contiene a base_timestamp.

inday (timestamp, basetimestamp , shift [, daystart])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

380

5 Funciones en scripts y en expresiones de grfico


indaytotime
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del da que contiene base_

timestamp hasta e incluido el milisegundo exacto de base_timestamp.


indaytotime (timestamp, basetimestamp , shift [, daystart])

Funciones start ... end


yearstart
Esta funcin devuelve una fecha-hora correspondiente al inicio del primer da del ao que contiene 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
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

381

5 Funciones en scripts y en expresiones de grfico


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 la fecha y hora del primer milisegundo del mes, periodo de
dos meses, trimestre, cuatrimestre o semestre que contiene la fecha base. Tambin es posible hallar la
fecha-hora de un periodo anterior o posterior.

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 mes,
periodo de dos meses, trimestre, cuatrimestre o semestre que engloba la fecha base. Tambin es posible
hallar la fecha-hora de un periodo anterior o posterior.

monthsend (n, date [, shift = 0 [, first_month_of_year = 1]])


monthsname
Esta funcin devuelve un valor de visualizacin que representa el rango de meses del periodo (con el mismo
formato que la variable de script MonthNames) as como el ao. El valor numrico subyacente corresponde
a la fecha y hora del primer milisegundo del mes, periodo de dos meses, trimestre, cuatrimestre o semestre
que contiene la fecha base.

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

382

5 Funciones en scripts y en expresiones de grfico


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 en la que se incluye date. Las semanas lunares en Qlik Sense se definen contando 1 de enero como el
primer da de la semana.

lunarweekstart (date [, shift = 0 [,weekoffset = 0]])


lunarweekend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo de
la semana lunar que contiene la date. Las semanas lunares en Qlik Sense se definen contando 1 de enero
como el primer da de la semana.

lunarweekend (date [, shift = 0 [,weekoffset = 0]])


lunarweekname
Esta funcin devuelve un valor que muestra el ao y el nmero de semana lunar correspondiente a una
indicacin de fecha y hora con el primer milisegundo del primer da de la semana que contiene a date. Las
semanas lunares en Qlik Sense se definen contando 1 de enero como el primer da de la semana.

lunarweekname (date [, shift = 0 [,weekoffset = 0]])


daystart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del da contenido en el argumento time. 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 contenido en time. 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 fechahora con el primer milisegundo del da que contiene a time.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

383

5 Funciones en scripts y en expresiones de grfico


dayname (timestamp [, shift = 0 [, dayoffset = 0]])

Funciones de nmero de da
age
La funcin age devuelve la edad en el momento indicado en timestamp (en aos completos) de alguien
nacido en date_of_birth.

age (timestamp, date_of_birth)


networkdays
La funcin 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.


networkdays

(start:date, end_date {, holiday})

firstworkdate
La funcin firstworkdate devuelve la ltima fecha de inicio para obtener un no_of_workdays (de lunes a
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
La funcin lastworkdate devuelve la primera fecha de finalizacin para obtener el no_of_workdays (LunesViernes) si comienza en 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
Esta funcin calcula el nmero de da del ao en el que cae una fecha-hora. El clculo se hace a partir del
primer milisegundo del primer da del ao, pero el primer mes puede desplazarse.

daynumberofyear (date[,firstmonth])
daynumberofquarter
Esta funcin calcula el nmero de da del trimestre en el que cae una fecha-hora.

daynumberofquarter (date[,firstmonth])

addmonths
Esta funcin devuelve la fecha que tiene lugar n meses despus de startdate o, si n es negativo, la fecha
que tiene lugar n meses antes de startdate.

Sintaxis:
AddMonths(startdate, n , [ , mode])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

384

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

startdate

La fecha de inicio como una indicacin de fecha, por ejemplo '2012-10-12'.

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'

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 aos despus de startdate o, si n es negativo, la fecha que
tiene lugar n aos antes de startdate.

Sintaxis:
AddYears(startdate, n)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

startdate

La fecha de inicio como una indicacin de fecha, por ejemplo '2012-10-12'.

El nmero de aos como un entero positivo o negativo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

385

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

addyears ('2010-01-29',3)

devuelve '2013-01-29'

addyears ('2010-01-29',-1)

devuelve '2009-01-29'

age
La funcin age devuelve la edad en el momento indicado en timestamp (en aos completos) de alguien
nacido en date_of_birth.

Sintaxis:
age(timestamp, date_of_birth)
Puede ser una expresin.
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

timestamp

La fecha hora, o expresin que viene a dar una fecha hora, hasta la que calcular el nmero
completo de aos.

date_of_

Fecha de nacimiento de la persona cuya edad se calcula. Puede ser una expresin.

birth
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

age('25/01/2014', '29/10/2012')

Devuelve 1.

age('29/10/2014', '29/10/2012')

Devuelve 2.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

386

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante muestra


los valores devueltos de age
para cada uno de los registros
de la tabla.

Employees:
LOAD * INLINE [
Member|DateOfBirth
John|28/03/1989
Linda|10/12/1990
Steve|5/2/1992
Birg|31/3/1993
Raj|19/5/1994
Prita|15/9/1994
Su|11/12/1994
Goran|2/3/1995
Sunny|14/5/1996
Ajoa|13/6/1996
Daphne|7/7/1998
Biffy|4/8/2000
] (delimiter is |);
AgeTable:
Load *,
age('20/08/2015', DateOfBirth) As Age
Resident Employees;
Drop table Employees;

Member

DateOfBirth

Age

John

28/03/1989

26

Linda

10/12/1990

24

Steve

5/2/1992

23

Birg

31/3/1993

22

Raj

19/5/1994

21

Prita

15/9/1994

20

Su

11/12/1994

20

Goran

2/3/1995

20

Sunny

14/5/1996

19

Ajoa

13/6/1996

19

Daphne

7/7/1998

17

Biffy

4/8/2000

15

converttolocaltime
Convierte una fecha-hora UTC o GMT a una 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]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

timestamp

La indicacin de fecha-hora, o expresin que devuelve una fecha-hora, que se ha de


convertir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

387

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

place

Un lugar o zona horaria de la tabla de lugares y zonas horarias vlidos a continuacin. Otra
posibilidad es usar GMT o UTC para definir la hora local. Son vlidos los siguientes valores
y rangos de desplazamiento de tiempo.
l

GMT

GMT-12:00 - GMT-01:00

GMT+01:00 - GMT+14:00

UTC

UTC-12:00 - UTC-01:00

UTC+01:00 - UTC+14:00

Slo podr utilizar desplazamientos de tiempo estndar. No es posible


utilizar un desplazamiento de tiempo arbitrario, por ejemplo, GMT-04:27.
ignore_dst

Fjelo en True si desea ignorar DST (el horario de verano).

La hora resultante se ajusta a las configuraciones del horario de verano, a menos que el tercer parmetro se
fije en True.

Lugares y zonas horarias vlidos


Abu Dhabi

Central America

Kabul

Newfoundland

Tashkent

Adelaide

Central Time (US &


Canada)

Kamchatka

Novosibirsk

Tbilisi

Alaska

Chennai

Karachi

Nuku'alofa

Tehran

Amsterdam

Chihuahua

Kathmandu

Osaka

Tokyo

Arizona

Chongqing

Kolkata

Pacific Time (US &


Canada)

Urumqi

Astana

Copenhagen

Krasnoyarsk

Paris

Warsaw

Athens

Darwin

Kuala Lumpur

Perth

Wellington

Atlantic Time
(Canada)

Dhaka

Kuwait

Port Moresby

West Central
Africa

Auckland

Eastern Time (US &


Canada)

Kyiv

Prague

Vienna

Azores

Edinburgh

La Paz

Pretoria

Vilnius

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

388

5 Funciones en scripts y en expresiones de grfico


Lugares y zonas horarias vlidos
Baghdad

Ekaterinburg

Lima

Quito

Vladivostok

Baku

Fiji

Lisbon

Riga

Volgograd

Bangkok

Georgetown

Ljubljana

Riyadh

Yakutsk

Beijing

Greenland

London

Rome

Yerevan

Belgrade

Greenwich Mean
Time : Dublin

Madrid

Samoa

Zagreb

Berlin

Guadalajara

Magadan

Santiago

Bern

Guam

Mazatlan

Sapporo

Bogota

Hanoi

Melbourne

Sarajevo

Brasilia

Harare

Mexico City

Saskatchewan

Bratislava

Hawaii

Mid-Atlantic

Seoul

Brisbane

Helsinki

Minsk

Singapore

Brussels

Hobart

Monrovia

Skopje

Bucharest

Hong Kong

Monterrey

Sofia

Budapest

Indiana (East)

Moscow

Solomon Is.

Buenos Aires

International Date
Line West

Mountain Time (US &


Canada)

Sri
Jayawardenepura

Cairo

Irkutsk

Mumbai

St. Petersburg

Canberra

Islamabad

Muscat

Stockholm

Cape Verde Is.

Istanbul

Nairobi

Sydney

Caracas

Jakarta

New Caledonia

Taipei

Casablanca

Jerusalem

New Delhi

Tallinn

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

389

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

ConvertToLocalTime(UTC(), 'GMT-05:00')

Devuelve la hora en la costa este


norteamericana, por ejemplo en Nueva York.

ConvertToLocalTime(UTC(), 'GMT-05:00', True)

Devuelve la hora en la costa este


norteamericana, por ejemplo en Nueva York,
sin ajustarse a las configuraciones del horario
de verano.

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)

Tipo de datos que devuelve: Entero


Ejemplos y resultados:
Ejemplo

Resultado

day( '1971-10-12' )

devuelve 12

day( '35648' )

devuelve 6, porque 35648 = 1997-08-06

dayend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del da contenido en time. El formato de salida por defecto ser el TimestampFormat definido en el script.

Sintaxis:
DayEnd(time[, [period_no[, day_start]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

time

La fecha/hora que se ha de evaluar.

period_no

period_no es un entero, o una expresin que viene a ser un entero, en el que el valor 0
indica el da que contiene a time. Los valores negativos en period_no indican das
precedentes y los valores positivos indican das subsiguientes.

day_start

Para especificar das que no comiencen en la medianoche, indique un desplazamiento


como una fraccin de un da en day_start. Por ejemplo, 0,125 para indicar las 3 AM.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

390

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

dayend('25/01/2013 16:45:00')

Devuelve 25/01/2013 23:59:59.

dayend('25/01/2013 16:45:00', -1)

Devuelve 24/01/2013 23:59:59.

dayend('25/01/2013 16:45:00', 0, 0.5)

Devuelve 26/01/2013 11:59:59.

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.

La tabla resultante contiene las fechas originales y una


columna con el valor de retorno de la funcin dayend().
Podemos mostrar la fecha hora completa especificando el
formato en el panel de propiedades.
InvDate

DEnd

Este ejemplo encuentra la fecha hora que


marca el final del da tras cada fecha de
facturacin en la tabla.

28/03/2012

29/03/2012 23:59:59

10/12/2012

11/12/2012 23:59:59

5/2/2013

07/02/2013 23:59:59

31/3/2013

01/04/2013 23:59:59

19/5/2013

20/05/2013 23:59:59

15/9/2013

16/09/2013 23:59:59

11/12/2013

12/12/2013 23:59:59

2/3/2014

03/03/2014 23:59:59

14/5/2014

15/05/2014 23:59:59

13/6/2014

14/06/2014 23:59:59

7/7/2014

08/07/2014 23:59:59

4/8/2014

05/08/2014 23:59:59

TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
DayEnd(InvDate, 1) AS DEnd
Resident TempTable;
Drop table TempTable;

daylightsaving
Devuelve el ajuste actual de cambio de hora automtico, segn el horario de verano, tal y como se define en
Windows.

Sintaxis:
DaylightSaving( )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

391

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Ejemplo:
daylightsaving( )

dayname
Esta funcin devuelve un valor de fecha, con un valor numrico subyacente correspondiente a una fechahora con el primer milisegundo del da que contiene a time.

Sintaxis:
DayName(time[, period_no [, day_start]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

time

La fecha/hora que se ha de evaluar.

period_no

period_no es un entero, o una expresin que viene a ser un entero, en el que el valor 0
indica el da que contiene a time. Los valores negativos en period_no indican das
precedentes y los valores positivos indican das subsiguientes.

day_start

Para especificar das que no comiencen en la medianoche, indique un desplazamiento


como una fraccin de un da en day_start. Por ejemplo, 0,125 para indicar las 3 AM.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

dayname('25/01/2013 16:45:00')

Devuelve 25/01/2013.

dayname('25/01/2013 16:45:00', -1)

Devuelve 24/01/2013.

dayname('25/01/2013 16:45:00', 0, 0.5 )

Devuelve 25/01/2013.
Mostrar la fecha hora completa permite
visualizar el valor numrico subyacente
correspondiente a '25/01/2013
12:00:00.000.'.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

392

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas


originales y una columna con el valor de
retorno de la funcin dayname().
Podemos mostrar la fecha hora completa
especificando el formato en el panel de
propiedades.

En este ejemplo, el nombre del da se crea a partir de la


fecha hora que marca el comienzo del da posterior a cada
fecha de facturacin en la tabla.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
DayName(InvDate, 1) AS DName
Resident TempTable;
Drop table TempTable;

InvDate

DName

28/03/2012

29/03/2012 00:00:00

10/12/2012

11/12/2012 00:00:00

5/2/2013

07/02/2013 00:00:00

31/3/2013

01/04/2013 00:00:00

19/5/2013

20/05/2013 00:00:00

15/9/2013

16/09/2013 00:00:00

11/12/2013

12/12/2013 00:00:00

2/3/2014

03/03/2014 00:00:00

14/5/2014

15/05/2014 00:00:00

13/6/2014

14/06/2014 00:00:00

7/7/2014

08/07/2014 00:00:00

4/8/2014

05/08/2014 00:00:00

daynumberofquarter
Esta funcin calcula el nmero de da del trimestre en el que cae una fecha-hora.

Sintaxis:
DayNumberOfQuarter(timestamp[,start_month])
Tipo de datos que devuelve: Entero
La funcin emplea siempre aos de 366 das.

Argumentos:
Argumento

Descripcin

timestamp

La fecha que se ha de evaluar.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

393

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

start_

Especificando un start_month de entre 2 y 12 (1 si se omite) el comienzo del ao puede

month

moverse hacia delante, al primer da de cualquier mes. Por ejemplo, si desea trabajar con
un ao fiscal que comience el 1 de marzo, especifique start_month = 3.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

DayNumberOfQuarter('12/09/2014')

Devuelve 74, el nmero de da del trimestre actual.

DayNumberOfQuarter('12/09/2014',3)

Devuelve 12, el nmero de da del trimestre actual.


En este caso, el primer trimestre empieza en marzo (porque
start_month se especifica como 3). Esto significa que el
trimestre actual es el tercer trimestre, que empieza el 1 de
septiembre.

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.

La tabla resultante muestra los valores devueltos de


DayNumberOfQuarter para cada uno de los registros de la tabla.

ProjectTable:
LOAD recno() as InvID, * INLINE [
StartDate
28/03/2014
10/12/2014
5/2/2015
31/3/2015
19/5/2015
15/9/2015
] ;
NrDays:
Load *,
DayNumberOfQuarter(StartDate,4) As
DayNrQtr
Resident ProjectTable;
Drop table ProjectTable;

InvID

StartDate

DayNrQtr

28/03/2014

88

10/12/2014

71

5/2/2015

36

31/3/2015

91

19/5/2015

49

15/9/2015

77

daynumberofyear
Esta funcin calcula el nmero de da del ao en el que cae una fecha-hora. El clculo se hace a partir del
primer milisegundo del primer da del ao, pero el primer mes puede desplazarse.

Sintaxis:
DayNumberOfYear(timestamp[,start_month])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

394

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
La funcin emplea siempre aos de 366 das.

Argumentos:
Argumento

Descripcin

timestamp

La fecha que se ha de evaluar.

start_

Especificando un start_month de entre 2 y 12 (1 si se omite) el comienzo del ao puede

month

moverse hacia delante, al primer da de cualquier mes. Por ejemplo, si desea trabajar con
un ao fiscal que comience el 1 de marzo, especifique start_month = 3.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

DayNumberOfYear('12/09/2014')

Devuelve 256, el nmero de da


contado desde el primer da del
ao.

DayNumberOfYear('12/09/2014',3)

Devuelve 196, el nmero de da


contado desde el da 1 de marzo.

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.

La tabla resultante muestra los


valores devueltos de
DayNumberOfYear para cada
uno de los registros de la tabla.

ProjectTable:
LOAD recno() as InvID, * INLINE [
StartDate
28/03/2014
10/12/2014
5/2/2015
31/3/2015
19/5/2015
15/9/2015
] ;
NrDays:
Load *,
DayNumberOfYear(StartDate,4) As DayNrYear
Resident ProjectTable;
Drop table ProjectTable;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

InvID

StartDate

DayNrYear

28/03/2014

363

10/12/2014

254

5/2/2015

311

31/3/2015

366

19/5/2015

49

15/9/2015

168

395

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 primer milisegundo
del da contenido en el argumento time. El formato de salida por defecto ser el TimestampFormat
definido en el script.

Sintaxis:
DayStart(time[, [period_no[, day_start]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

time

La fecha/hora que se ha de evaluar.

period_no

period_no es un entero, o una expresin que viene a ser un entero, en el que el valor 0
indica el da que contiene a time. Los valores negativos en period_no indican das
precedentes y los valores positivos indican das subsiguientes.

day_start

Para especificar das que no comiencen en la medianoche, indique un desplazamiento


como una fraccin de un da en day_start. Por ejemplo, 0,125 para indicar las 3 AM.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

daystart('25/01/2013 16:45:00')

Devuelve 25/01/2013 00:00:00.

daystart('25/01/2013 16:45:00', -1)

Devuelve 24/01/2013 00:00:00.

daystart('25/01/2013 16:45:00', 0, 0.5 )

Devuelve 25/01/2013 12:00:00.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

396

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas originales y una


columna con el valor de retorno de la funcin daystart().
Podemos mostrar la fecha hora completa especificando
el formato en el panel de propiedades.
InvDate

DStart

Este ejemplo halla la fecha hora que marca el


comienzo del da posterior a cada fecha de
facturacin en la tabla.

28/03/2012

29/03/2012 00:00:00

10/12/2012

11/12/2012 00:00:00

5/2/2013

07/02/2013 00:00:00

31/3/2013

01/04/2013 00:00:00

19/5/2013

20/05/2013 00:00:00

15/9/2013

16/09/2013 00:00:00

11/12/2013

12/12/2013 00:00:00

2/3/2014

03/03/2014 00:00:00

14/5/2014

15/05/2014 00:00:00

13/6/2014

14/06/2014 00:00:00

7/7/2014

08/07/2014 00:00:00

4/8/2014

05/08/2014 00:00:00

TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
DayStart(InvDate, 1) AS DStart
Resident TempTable;
Drop table TempTable;

firstworkdate
La funcin firstworkdate devuelve la ltima fecha de inicio para obtener un no_of_workdays (de lunes a
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} )
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

end_date

La fecha/hora de la fecha final que se ha de evaluar.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

397

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

no_of_

El nmero de das laborables que se ha de alcanzar.

workdays
holiday

Los perodos de vacaciones que deben excluirse de los das laborables. Un periodo de
vacaciones se indica como una fecha inicial y una fecha final, separadas por comas.

Ejemplo: '25/12/2013', '26/12/2013'


Puede especificar ms de un perodo de vacaciones, separados por comas.

Ejemplo: '25/12/2013', '26/12/2013', '31/12/2013', '01/01/2014'


Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

firstworkdate ('29/12/2014', 9)

Devuelve 17/12/2014.

firstworkdate ('29/12/2014', 9, '25/12/2014', '26/12/2014')

Devuelve 15/12/2014 como


periodo de vacaciones de dos
das considerado.

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.

La tabla resultante muestra los


valores devueltos de
FirstWorkDate para cada uno de
los registros de la tabla.

ProjectTable:
LOAD *, recno() as InvID, INLINE [
EndDate
28/03/2015
10/12/2015
5/2/2016
31/3/2016
19/5/2016
15/9/2016
] ;
NrDays:
Load *,
FirstWorkDate(EndDate,120) As StartDate
Resident ProjectTable;
Drop table ProjectTable;

InvID

EndDate

StartDate

28/03/2015

13/10/2014

10/12/2015

26/06/2015

5/2/2016

24/08/2015

31/3/2016

16/10/2015

19/5/2016

04/12/2015

15/9/2016

01/04/2016

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 de script y funciones de grficos - Qlik Sense, 3.0

398

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
GMT( )
Tipo de datos que devuelve: dual
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)

Tipo de datos que devuelve: Entero


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 base_timestamp.

Sintaxis:
InDay (timestamp, base_timestamp, period_no[, day_start])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha y hora que se desea comparar con base_timestamp.

base_

La fecha y hora que se utiliza para evaluar la fecha-hora.

timestamp

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

399

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

period_no

El da puede desplazarse mediante period_no; period_no es un entero, en el que el


valor 0 indica el da que contiene a base_timestamp. Los valores negativos en period_

no indican das precedentes y los valores positivos indican das subsiguientes.


day_start

Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento como una fraccin de un da en day_start, por ejemplo 0,125 para las 3
am.

Ejemplos y resultados:
Ejemplo

Resultado

inday ('12/01/2006 12:23:00', '12/01/2006 00:00:00', 0)

Devuelve True

inday ('12/01/2006 12:23:00', '13/01/2006 00:00', 0)

Devuelve False

inday ('12/01/2006 12:23:00', '12/01/2006 00:00:00', -1)

Devuelve False

inday ('11/01/2006 12:23:00', '12/01/2006 00:00:00', -1)

Devuelve True

inday ('12/01/2006 12:23:00', '12/01/2006 00:00:00', 0, 0.5)

Devuelve False

inday ('12/01/2006 11:23:00', '12/01/2006 00:00:00', 0, 0.5)

Devuelve True

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

400

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una
columna con el valor
de retorno de la
funcin inday().

Este ejemplo comprueba si una fecha de facturacin cae en cualquier hora del
da que comienza con base_timestamp.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvTime
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InDay(InvTime, '28/03/2012 00:00:00', 0) AS InDayEx
Resident TempTable;
Drop table TempTable;

InvTime

InDayEx

28/03/2012

-1 (True)

10/12/2012

0
(False)

5/2/2013

0
(False)

31/3/2013

0
(False)

19/5/2013

0
(False)

15/9/2013

0
(False)

11/12/2013

0
(False)

2/3/2014

0
(False)

14/5/2014

0
(False)

13/6/2014

0
(False)

7/7/2014

0
(False)

4/8/2014

0
(False)

indaytotime
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del da que contiene base_

timestamp hasta e incluido el milisegundo exacto de base_timestamp.


Sintaxis:
InDayToTime (timestamp, base_timestamp, period_no[, day_start])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

401

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha y hora que se desea comparar con base_timestamp.

base_

La fecha y hora que se utiliza para evaluar la fecha-hora.

timestamp
period_no

El da puede desplazarse mediante period_no; period_no es un entero, en el que el


valor 0 indica el da que contiene a base_timestamp. Los valores negativos en period_

no indican das precedentes y los valores positivos indican das subsiguientes.


day_start

(opcional) Si desea trabajar con das que no comiencen en la medianoche, especifique un


desplazamiento como una fraccin de un da en day_start, por ejemplo 0,125 para las 3
am.

Ejemplos y resultados:
Ejemplo

Resultado

indaytotime ('12/01/2006 12:23:00', '12/01/2006 23:59:00', 0)

Devuelve True

indaytotime ('12/01/2006 12:23:00', '12/01/2006 00:00:00', 0)

Devuelve False

indaytotime ('11/01/2006 12:23:00', '12/01/2006 23:59:00', -1)

Devuelve True

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

402

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin indaytotime().

Este ejemplo comprueba si una fecha-hora de una factura cae antes de las
17:00:00 del da que comienza con la fecha-hora base base_timestamp.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvTime
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InDayToTime(InvTime, '28/03/2012 17:00:00', 0) AS InDayExTT
Resident TempTable;
Drop table TempTable;

InvTime

InDayExTT

28/03/2012

-1 (True)

10/12/2012

0 (False)

5/2/2013

0 (False)

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inlunarweek
Esta funcin halla si timestamp se encuentra dentro de la semana lunar que contiene base_date. Las
semanas lunares en Qlik Sense se definen contando 1 de enero como el primer da de la semana.

Sintaxis:
InLunarWeek (timestamp, base_date, period_no[, first_week_day])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar la semana lunar.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

403

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

period_no

La semana lunar puede desplazarse mediante period_no; period_no es un entero, en el


que el valor 0 indica la semana lunar que contiene a base_date. Los valores negativos en

period_no indican semanas lunares precedentes y los valores positivos indican semanas
lunares subsiguientes.
first_week_
day

Un desplazamiento que puede ser mayor que o menor que cero. Esto cambia el comienzo
del ao por el nmero especificado de das y/o fracciones de un da.

Ejemplos y resultados:
Ejemplo

Resultado

inlunarweek('12/01/2013',
'14/01/2013', 0)

Devuelve True. Porque el valor de timestamp, 12/01/2013 cae


en la semana 08/01/2013 a 14/01/2013.

inlunarweek('12/01/2013',
'07/01/2013', 0)

Devuelve False. Porque la fecha base_date 07/01/2013 est


en la semana lunar definida como 01/01/2013 a 07/01/2013.

inlunarweek('12/01/2013',
'14/01/2013', -1)

Devuelve False. Porque especificar un valor period_no de -1


desplaza la semana a la semana previa, 01/01/2013 a
07/01/2013.

inlunarweek('07/01/2013',
'14/01/2013', -1)

Devuelve True. Comparado con el ejemplo anterior, la fecha


hora est en la semana posterior a tenerse en cuenta el
desplazamiento hacia atrs.

inlunarweek('11/01/2006',
'08/01/2006', 0, 3)

Devuelve False. Porque especificar un valor para first_week_


day de 3 significa que el inicio del ao se calcula desde
04/01/2013, y por lo tanto el valor de base_date cae en la
primera semana, y el valor de timestamp cae en la semana de
11/01/2013 a 17/01/2013.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

404

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas originales y una


columna con el valor de retorno de la funcin inlunarweek().

Este ejemplo comprueba si una fecha de


facturacin entra dentro de la semana
desplazada desde el valor de base_date
en cuatro semanas.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InLunarWeek(InvDate, '11/01/2013', 4)
AS InLWeekPlus4
Resident TempTable;
Drop table TempTable;

La funcin devuelve True para el valor de InvDate5/2/2013


porque el valor de base_date, 11/01/2013, se desplaza en
cuatro semanas y por lo tanto cae en la semana de 5/02/2013
a 11/02/2013.
InvDate

InLWeekPlus4

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

-1 (True)

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inlunarweektodate
Esta funcin halla si timestamp se encuentra dentro de la parte de la semana lunar hasta e incluido el ltimo
milisegundo de base_date. Las semanas lunares en Qlik Sense se definen contando 1 de enero como el
primer da de la semana.

Sintaxis:
InLunarWeekToDate (timestamp, base_date, period_no [, first_week_day])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

405

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar la semana lunar.

period_no

La semana lunar puede desplazarse mediante period_no; period_no es un entero, en el


que el valor 0 indica la semana lunar que contiene a base_date. Los valores negativos en

period_no indican semanas lunares precedentes y los valores positivos indican semanas
lunares subsiguientes.
first_week_
day

Un desplazamiento que puede ser mayor que o menor que cero. Esto cambia el comienzo
del ao por el nmero especificado de das y/o fracciones de un da.

Ejemplos y resultados:
Ejemplo

Resultado

inlunarweektodate('12/01/2013', '13/01/2013',
0)

Devuelve True. Porque el valor de timestamp,


12/01/2013 cae en la parte de la semana 08/01/2013
a 13/01/2013.

inlunarweektodate('12/01/2013', '11/01/2013',
0)

Devuelve False. Porque el valor de timestamp es


posterior al valor de base_date incluso aunque
ambas fechas se encuentran en la misma semana
lunar anterior a 12/01/2012.

inlunarweektodate('12/01/2006', '05/01/2006',
1)

Devuelve True. Especificar un valor de 1 en period_


no desplaza la fecha base_date hacia adelante una
semana, de forma que el valor de timestamp cae en
la parte de la semana lunar.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

406

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas originales y


una columna con el valor de retorno de la funcin
inlunarweek().

Este ejemplo comprueba si una fecha de


facturacin entra en la parte de la semana
desplazada desde el valor de base_date en cuatro
semanas.

La funcin devuelve True para el valor de


InvDate5/2/2013 porque el valor de base_date,
11/01/2013, se desplaza en cuatro semanas y por lo
tanto cae en la parte de la semana de 5/02/2013 a
07/02/2013.

TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

InvDate

InLWeek2DPlus4

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

-1 (True)

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

InvoiceData:
LOAD *,
InLunarWeekToDate(InvDate, '07/01/2013', 4) AS
InLWeek2DPlus4
Resident TempTable;
Drop table TempTable;

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inmonth
Esta funcin devuelve True si timestamp se encuentra dentro del mes que contiene base_date.

Sintaxis:
InMonth (timestamp, base_date, period_no[, first_month_of_year])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el mes.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

407

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

period_no

El mes puede desplazarse mediante period_no; period_no es un entero, en el que el


valor 0 indica el mes que contiene a base_date. Los valores negativos en period_no
indican meses precedentes y los valores positivos indican meses posteriores.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Ejemplo

Resultado

inmonth ('25/01/2013', '01/01/2013', 0 )

Devuelve True

inmonth('25/01/2013', '01/04/2013', 0)

Devuelve False

inmonth ('25/01/2013', '01/01/2013', -1)

Devuelve False

inmonth ('25/12/2012', '01/01/2013', -1)

Devuelve True

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin inmonth().

Este ejemplo comprueba si una fecha de facturacin cae en cualquier hora


del cuarto mes tras el mes en base_date, especificando period_no como 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InMonth(InvDate, '31/01/2013', 4) AS InMthPlus4
Resident TempTable;
Drop table TempTable;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

InvDate

InMthPlus4

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

0 (False)

31/3/2013

0 (False)

19/5/2013

-1 (True)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

408

5 Funciones en scripts y en expresiones de grfico


inmonths
Esta funcin encuentra si una indicacin de fecha y hora cae dentro del mismo mes, periodo de dos meses,
trimestre, cuatrimestre o semestre dado como una fecha base. Tambin es posible hallar si la fecha-hora cae
dentro de un periodo de tiempo anterior o posterior.

Sintaxis:
InMonths(n_months, timestamp, base_date, period_no [, first_month_of_year])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

n_months

El nmero de meses que define el periodo. Un entero o expresin que devuelve un entero
que debe ser uno de estos: 1 (equivalente a la funcin inmonth()), 2 (bimensual), 3
(equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el periodo.

period_no

El periodo puede desplazarse mediante period_no, un entero, o expresin que viene a ser
un entero, en el que el valor 0 indica el periodo que contiene a base_date. Los valores
negativos en period_no indican periodos precedentes y los valores positivos indican
periodos subsiguientes.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

inmonths(4, '25/01/2013', '25/04/2013', 0)

Devuelve True. Porque el valor de


timestamp, 25/01/2013, cae dentro
del periodo de cuatro meses de
01/01/2013 a 30/04/2013, en el que
reside el valor de base_date,
25/04/2013.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

409

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

inmonths(4, '25/05/2013', '25/04/2013', 0)

Devuelve False. Porque


25/05/2013 est fuera del mismo
periodo que el ejemplo anterior.

inmonths(4, '25/11/2012', '01/02/2013', -1 )

Devuelve True. Porque el valor de


period_no, -1, desplaza el periodo
de bsqueda hacia atrs un periodo
de cuatro meses (el valor de nmonths), lo cual hace que el
periodo de bsqueda sea
01/09/2012 a 31/12/2012.

inmonths( 4, '25/05/2006', '01/03/2006', 0, 3)

Devuelve True. Porque el valor de


first_month_of_year est fijado en
3, lo cual hace que el periodo de
bsqueda sea de 01/03/2006 a
30/04/2006, en lugar de 01/01/2006
a 30/07/2006.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

410

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las


fechas originales y una columna
con el valor de retorno de la funcin
InMonths().

Este ejemplo comprueba si la fecha de facturacin de la tabla cae


dentro del periodo bimensual que incluye la fecha base_date
desplazada hacia delante en un periodo de dos meses
(especificando period_no como 1).
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InMonths(2, InvDate, '11/02/2013', 1) AS InMthsPlus1
Resident TempTable;
Drop table TempTable;

El periodo de bsqueda es de
01/03/2013 a 30/04/2013, porque
el valor de base_date se desplaza
hacia delante dos meses a partir
del valor especificado en la funcin
(11/02/2013).
InvDate

InMthsPlus1

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

0 (False)

31/3/2013

-1 (True)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inmonthstodate
Esta funcin encuentra si una indicacin de fecha y hora cae dentro del mes, periodo de dos meses,
trimestre, cuatrimestre o semestre hasta e incluido el ltimo milisegundo de base_date. Tambin es posible
hallar si la fecha-hora cae dentro de un periodo anterior o posterior.

Sintaxis:
InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year
])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

411

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

n_months

El nmero de meses que define el periodo. Un entero o expresin que devuelve un entero
que debe ser uno de estos: 1 (equivalente a la funcin inmonth()), 2 (bimensual), 3
(equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el periodo.

period_no

El periodo puede desplazarse mediante period_no, un entero, o expresin que viene a ser
un entero, en el que el valor 0 indica el periodo que contiene a base_date. Los valores
negativos en period_no indican periodos precedentes y los valores positivos indican
periodos subsiguientes.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

inmonthstodate(4, '25/01/2013', '25/04/2013', 0)

Devuelve True. Porque el valor de timestamp,


25/01/2013, cae dentro del periodo de cuatro
meses 01/01/2013 hasta el final de 25/04/2013,
en el que reside el valor de base_date,
25/04/2013.

inmonthstodate(4, '26/04/2013', '25/04/2006', 0)

Devuelve False. Porque 26/04/2013 est fuera


del mismo periodo que el ejemplo anterior.

inmonthstodate(4, '25/09/2005', '01/02/2006', -1)

Devuelve True. Porque el valor de period_no, -1,


desplaza el periodo de bsqueda hacia atrs un
periodo de cuatro meses (el valor de n-months),
lo cual hace que el periodo de bsqueda sea
01/09/2012 a 01/02/2012.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

412

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

inmonthstodate(4, '25/04/2006', '01/06/2006', 0,


3)

Devuelve True. Porque el valor de first_month_


of_year est fijado en 3, lo cual hace que el
periodo de bsqueda sea de 01/03/2006 a
01/06/2006, en lugar de 01/05/2006 a
01/06/2006.

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.

La tabla resultante contiene las fechas originales


y una columna con el valor de retorno de la
funcin InMonths().

Este ejemplo comprueba si la fecha de facturacin de


la tabla cae en la parte del periodo bimensual que
abarca e incluye la fecha base_date desplazada hacia
delante en cuatro periodos de dos meses
(especificando 4 como period_no).
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InMonthsToDate(2, InvDate, '15/02/2013', 4) AS
InMths2DPlus4
Resident TempTable;
Drop table TempTable;

El periodo de bsqueda es de 01/09/2013 a


15/10/2013, porque el valor de base_date se
desplaza hacia delante ocho meses a partir del
valor especificado en la funcin (15/02/2013).
InvDate

InMths2DPlus4

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

0 (False)

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

-1 (True)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

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 (timestamp, base_date, period_no)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

413

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el mes.

period_no

El mes puede desplazarse mediante period_no; period_no es un entero, en el que el


valor 0 indica el mes que contiene a base_date. Los valores negativos en period_no
indican meses precedentes y los valores positivos indican meses posteriores.

Ejemplos y resultados:
Ejemplo

Resultado

inmonthtodate ('25/01/2013', '25/01/2013', 0)

Devuelve True

inmonthtodate ('25/01/2013', '24/01/2013', 0)

Devuelve False

inmonthtodate ('25/01/2013', '28/02/2013', -1)

Devuelve True

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.

La tabla resultante contiene


las fechas originales y una
columna con el valor de
retorno de la funcin
inmonthtodate().

Especificando period_no como 4, este ejemplo comprueba si una fecha


de facturacin cae en el cuarto mes tras el mes de base_date pero antes
del final del da especificado en base_date.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InMonthToDate(InvDate, '31/01/2013', 0, 4) AS InMthPlus42D
Resident TempTable;
Drop table TempTable;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

InvDate

InMthPlus42D

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

0 (False)

31/3/2013

0 (False)

19/5/2013

-1 (True)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

414

5 Funciones en scripts y en expresiones de grfico


inquarter
Esta funcin devuelve True si timestamp se encuentra dentro del trimestre que contiene base_date.

Sintaxis:
InQuarter (timestamp, base_date, period_no[, first_month_of_year])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el trimestre.

period_no

El trimestre puede desplazarse mediante period_no. period_no es un entero, en el que el


valor 0 indica el trimestre que contiene a base_date. Los valores negativos en period_no
indican trimestres precedentes y los valores positivos indican trimestres posteriores.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Ejemplo

Resultado

inquarter ('25/01/2013', '01/01/2013', 0)

Devuelve True

inquarter ('25/01/2013', '01/04/2013', 0)

Devuelve False

inquarter ('25/01/2013', '01/01/2013', -1)

Devuelve False

inquarter ('25/12/2012', '01/01/2013', -1)

Devuelve True

inquarter ('25/01/2013', '01/03/2013', 0, 3)

Devuelve False

inquarter ('25/03/2013', '01/03/2013', 0, 3)

Devuelve True

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

415

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin inquarter().

Este ejemplo comprueba si una fecha de facturacin cae en el cuarto


trimestre del ao fiscal especificado fijando el valor de first_month_of_year
en 4, y teniendo 31/01/2013 como base_date.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InQuarter(InvDate, '31/01/2013', 0, 4) AS Qtr4FinYr1213
Resident TempTable;
Drop table TempTable;

InvDate

Qtr4Fin1213

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

-1 (True)

31/3/2013

-1 (True)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inquartertodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del trimestre que contiene base_

date hasta e incluido el ltimo milisegundo de base_date.


Sintaxis:
InQuarterToDate (timestamp, base_date, period_no [, first_month_of_year])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el trimestre.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

416

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

period_no

El trimestre puede desplazarse mediante period_no. period_no es un entero, en el que el


valor 0 indica el trimestre que contiene a base_date. Los valores negativos en period_no
indican trimestres precedentes y los valores positivos indican trimestres posteriores.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Ejemplo

Resultado

inquartertodate ('25/01/2013', '25/01/2013', 0)

Devuelve True

inquartertodate ( 25/01/2013', '24/01/2013', 0)

Devuelve False

inquartertodate ('25/01/2012', '01/02/2013', -1)

Devuelve True

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno
de la funcin
inquartertodate().

Este ejemplo comprueba si una fecha de facturacin cae en un ao fiscal


especificado fijando el valor de first_month_of_year en 4, y en el cuarto
trimestre, antes del final de 28/02/2013.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InQuarterToDate(InvDate, '28/02/2013', 0, 4) AS Qtr42Date
Resident TempTable;
Drop table TempTable;

InvDate

Qtr42Date

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

-1 (True)

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inweek
Esta funcin devuelve True si timestamp se encuentra dentro de la semana que contiene base_date.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

417

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
InWeek (timestamp, base_date, period_no[, first_week_day])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar la semana.

period_no

La semana puede desplazarse mediante period_no; period_no es un entero, en el que el


valor 0 indica la semana que contiene a base_date. Los valores negativos en el period_

no indican semanas precedentes y los valores positivos indican semanas subsiguientes.


first_week_
day

Por defecto, el primer da de la semana es lunes, comenzando en la medianoche del


domingo al lunes. Para indicar una semana que comience en otro da, especifique un
desplazamiento en first_week_day. Este puede ser un nmero entero de das y/o
fracciones de un da.

Ejemplos y resultados:
Ejemplo

Resultado

inweek ('12/01/2006', '14/01/2006', 0)

Devuelve True

inweek ('12/01/2006', '20/01/2006', 0 )

Devuelve False

inweek ('12/01/2006', '14/01/2006', -1 )

Devuelve False

inweek ('07/01/2006', '14/01/2006', -1)

Devuelve True

inweek ('12/01/2006', '09/01/2006', 0, 3)

Devuelve False
Porque first_week_day se ha especificado como 3
(Jueves), loc ual hace que 09/01/2006 sea el
primer da de la semana que sigue a la semana
que contiene a 12/01/2006.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

418

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas originales y


una columna con el valor de retorno de la funcin
inweek().

Este ejemplo comprueba si una fecha de una


factura cae en cualquier hora de la cuarta semana
posterior a la semana de base_date, especificando
period_no como 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
InWeek(InvDate, '11/01/2013', 4) AS InWeekPlus4
Resident TempTable;
Drop table TempTable;

La fecha InvDate5/2/2013 cae dentro de la


semana que va cuatro semanas despus de base_
date: 11/1/2013.
InvDate

InWeekPlus4

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

-1 (True)

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

inweektodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte de la semana que contiene base_

date hasta e incluido el ltimo milisegundo de base_date.


Sintaxis:
InWeekToDate (timestamp, base_date, period_no [, first_week_day])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

419

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

base_date

La fecha que se utiliza para evaluar la semana.

period_no

La semana puede desplazarse mediante period_no; period_no es un entero, en el que el


valor 0 indica la semana que contiene a base_date. Los valores negativos en el period_

no indican semanas precedentes y los valores positivos indican semanas subsiguientes.


first_week_
day

Por defecto, el primer da de la semana es lunes, comenzando en la medianoche del


domingo al lunes. Para indicar una semana que comience en otro da, especifique un
desplazamiento en first_week_day. Este puede ser un nmero entero de das y/o
fracciones de un da.

Ejemplos y resultados:
Ejemplo

Resultado

inweektodate ('12/01/2006', '12/01/2006', 0)

Devuelve True

inweektodate ('12/01/2006', '11/01/2006', 0)

Devuelve False

inweektodate ('12/01/2006', '18/01/2006', -1)

Devuelve False
Porque period_no est especificado como -1, el
dato efectivo con el que se mide timestamp es
11/01/2006.

inweektodate ( '11/01/2006', '12/01/2006', 0, 3


)

Devuelve False
Porque first_week_day se ha especificado como 3
(Jueves), loc ual hace que 12/01/2006 sea el
primer da de la semana que sigue a la semana
que contiene a 12/01/2006.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

420

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas originales y


una columna con el valor de retorno de la funcin
inweek().
InvDate

InWeek2DPlus4

Este ejemplo comprueba si una fecha de


facturacin cae en la cuarta semana tras la semana
de base_date, especificando period_no como 4 pero
antes del valor de base_date.

28/03/2012

0 (False)

10/12/2012

0 (False)

5/2/2013

-1 (True)

TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

InvoiceData:
LOAD *,
InWeekToDate(InvDate, '11/01/2013', 4) AS
InWeek2DPlus4
Resident TempTable;
Drop table TempTable;

inyear
Esta funcin devuelve True si timestamp se encuentra dentro del ao que contiene base_date.

Sintaxis:
InYear (timestamp, base_date, period_no [, first_month_of_year])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el ao.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

421

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

period_no

El ao puede desplazarse mediante period_no. period_no es un entero, en el que el


valor 0 indica el ao que contiene base_date. Los valores negativos de period_no indican
aos precedentes y los valores positivos indican aos futuros.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

inyear ('25/01/2013', '01/01/2013', 0 )

Devuelve True

inyear ('25/01/2012', '01/01/2013', 0)

Devuelve False

inyear ('25/01/2013', '01/01/2013', -1)

Devuelve False

inyear ('25/01/2012', '01/01/2013', -1 )

Devuelve True

inyear ('25/01/2013', '01/01/2013', 0, 3)

Devuelve False El valor de base_date y


first_month_of_year especifican que
timestamp debe caer dentro de
01/03/2012 y 28/02/2013.

inyear ('25/03/2013', '2013/07/01', 0, 3 )

Devuelve True

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

422

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas


originales y una columna con el valor de
retorno de la funcin inyear().
InvDate

FinYr1213

Este ejemplo comprueba si una fecha de facturacin cae en


el ao fiscal especificado fijando el valor de first_month_of_
year en 4, y teniendo la fecha base_date entre 1/4/2012 y
31/03/2013.

28/03/2012

0 (False)

10/12/2012

-1 (True)

5/2/2013

-1 (True)

TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

31/3/2013

-1 (True)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

Verifica si InvDate est en el ao financiero de 1/04/2012 a


31/03/2013:
InvoiceData:
LOAD *,
InYear(InvDate, '31/01/2013', 0, 4) AS FinYr1213
Resident TempTable;
Drop table TempTable;

inyeartodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del ao que contiene base_date
hasta e incluido el ltimo milisegundo de base_date.

Sintaxis:
InYearToDate (timestamp, base_date, period_no[, first_month_of_year])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

423

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

timestamp

La fecha que desee comparar con base_date.

base_date

La fecha que se utiliza para evaluar el ao.

period_no

El ao puede desplazarse mediante period_no. period_no es un entero, en el que el


valor 0 indica el ao que contiene base_date. Los valores negativos de period_no indican
aos precedentes y los valores positivos indican aos futuros.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Ejemplo

Resultado

inyeartodate ('2013/01/25', '2013/02/01', 0)

Devuelve True

inyeartodate ('2012/01/25', '2013/01/01', 0)

Devuelve False

inyeartodate ('2012/01/25', '2013/02/01', - )

Devuelve True

inyeartodate ('2012/11/25', '2013/01/31', 0, 4)

Devuelve True
El valor de timestamp entra dentro del ao fiscal
que comienza en el cuarto mes y antes del valor de
base_date.

inyeartodate ( '2013/3/31', '2013/01/31', 0, 4 )

Devuelve False
Comparado con el ejemplo anterior, el valor de
timestamp est an dentro del ao fiscal, pero se
encuentra despus del valor de base_date, as que
queda fuera de la parte del ao.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

424

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas originales y


una columna con el valor de retorno de la funcin
inyeartodate().
InvDate

FinYr2Date

Este ejemplo comprueba si una fecha de


facturacin cae en un ao fiscal especificado
fijando el valor de first_month_of_year en 4 y en la
parte del ao anterior al final de 31/01/2013.

28/03/2012

0 (False)

10/12/2012

-1 (True)

5/2/2013

0 (False)

TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

31/3/2013

0 (False)

19/5/2013

0 (False)

15/9/2013

0 (False)

11/12/2013

0 (False)

2/3/2014

0 (False)

14/5/2014

0 (False)

13/6/2014

0 (False)

7/7/2014

0 (False)

4/8/2014

0 (False)

InvoiceData:
LOAD *,
InYearToDate(InvDate, '31/01/2013', 0, 4) AS
FinYr2Date
Resident TempTable;
Drop table TempTable;

lastworkdate
La funcin lastworkdate devuelve la primera fecha de finalizacin para obtener el no_of_workdays (LunesViernes) 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})

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

425

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

start_date

La fecha inicial que se ha de evaluar.

no_of_

El nmero de das laborables que se ha de alcanzar.

workdays
holiday

Los perodos de vacaciones que deben excluirse de los das laborables. Un periodo de
vacaciones se indica como una fecha inicial y una fecha final, separadas por comas.

Ejemplo: '25/12/2013', '26/12/2013'


Puede especificar ms de un perodo de vacaciones, separados por comas.

Ejemplo: '25/12/2013', '26/12/2013', '31/12/2013', '01/01/2014'


Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

lastworkdate ('19/12/2014', 9)

Devuelve '31/12/2014'

lastworkdate ('19/12/2014', 9, '2014-12-25', '2014-12-26')

Devuelve 02/01/2015 como


perodo de vacaciones de dos
das considerado.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

426

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante muestra los


valores devueltos de
LastWorkDate para cada uno de
los registros de la tabla.

ProjectTable:
LOAD *, recno() as InvID, INLINE [
StartDate
28/03/2014
10/12/2014
5/2/2015
31/3/2015
19/5/2015
15/9/2015
] ;
NrDays:
Load *,
LastWorkDate(StartDate,120) As EndDate
Resident ProjectTable;
Drop table ProjectTable;

InvID

StartDate

EndDate

28/03/2014

11/09/2014

10/12/2014

26/05/2015

5/2/2015

27/07/2015

31/3/2015

14/09/2015

19/5/2015

02/11/2015

15/9/2015

29/02/2016

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 ]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

timezone

La timezone se especifica como una cadena que contiene cualquiera de los lugares
geogrficos listados en Time Zone, en el Windows Control Panel para Date and Time
o como una cadena con la forma GMT+hh:mm.
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 y resultados:
Los ejemplos siguientes estn basados en la funcin que se llama el 2014-10-22 12:54:47 hora local, siendo
GMT+01:00 la zona horaria local.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

427

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

localtime ()

Devuelve la hora local 2014-10-22 12:54:47.

localtime ('London')

Devuelve la hora local en Londres, 2014-10-22 11:54:47.

localtime
('GMT+02:00')

Devuelve la hora local en la zona horaria GMT+02:00, 2014-10-22 13:54:47.

localtime ('Paris',1')

Devuelve la hora local en Pars, sin considerar el horario de verano, 2014-10-22


11:54:47.

lunarweekend
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo de
la semana lunar que contiene la date. Las semanas lunares en Qlik Sense se definen contando 1 de enero
como el primer da de la semana.

Sintaxis:
LunarweekEnd(date[, period_no[, first_week_day]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero o una expresin que viene a ser un entero, en el que el valor 0
indica la semana lunar en la que se incluye date. Los valores negativos en period_no
indican semanas lunares precedentes y los valores positivos indican semanas lunares
subsiguientes.

first_week_
day

Un desplazamiento que puede ser mayor que o menor que cero. Esto cambia el comienzo
del ao por el nmero especificado de das y/o fracciones de un da.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

lunarweekend('12/01/2013')

Devuelve 14/01/2013
23:59:59.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

428

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

lunarweekend('12/01/2013', -1)

Devuelve 7/01/2013
23:59:59.

lunarweekend('12/01/2013', 0, 1)

Devuelve 15/01/2013
23:59:59.

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin lunarweekend
(). Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el ltimo da de la semana lunar de cada fecha de


facturacin de la tabla, donde date se desplaza una semana especificando 1
en period_no.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
LunarWeekEnd(InvDate, 1) AS LWkEnd
Resident TempTable;
Drop table TempTable;

InvDate

LWkEnd

28/03/2012

07/04/2012

10/12/2012

22/12/2012

5/2/2013

18/02/2013

31/3/2013

08/04/2013

19/5/2013

27/05/2013

15/9/2013

23/09/2013

11/12/2013

23/12/2013

2/3/2014

11/03/2014

14/5/2014

27/05/2014

13/6/2014

24/06/2014

7/7/2014

15/07/2014

4/8/2014

12/08/2014

lunarweekname
Esta funcin devuelve un valor que muestra el ao y el nmero de semana lunar correspondiente a una
indicacin de fecha y hora con el primer milisegundo del primer da de la semana que contiene a date. Las
semanas lunares en Qlik Sense se definen contando 1 de enero como el primer da de la semana.

Sintaxis:
LunarWeekName(date [, period_no[, first_week_day]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

429

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero o una expresin que viene a ser un entero, en el que el valor 0
indica la semana lunar en la que se incluye date. Los valores negativos en period_no
indican semanas lunares precedentes y los valores positivos indican semanas lunares
subsiguientes.

first_week_
day

Un desplazamiento que puede ser mayor que o menor que cero. Esto cambia el comienzo
del ao por el nmero especificado de das y/o fracciones de un da.

Ejemplos y resultados:
Ejemplo

Resultado

lunarweekname('12/01/2013')

Devuelve 2006/02.

lunarweekname('12/01/2013', -1)

Devuelve 2006/01.

lunarweekname('12/01/2013', 0, 1)

Devuelve 2006/02.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

430

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno
de la funcin
lunarweekname().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

En este ejemplo, por cada fecha de facturacin en la tabla, el nombre de la


semana lunar se crea a partir del ao en el que cae la semana y su nmero de
semana lunar asociado, desplazado una semana especificando period_no
como 1.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
LunarWeekName(InvDate, 1) AS LWkName
Resident TempTable;
Drop table TempTable;

InvDate

LWkName

28/03/2012

2012/14

10/12/2012

2012/51

5/2/2013

2013/07

31/3/2013

2013/14

19/5/2013

2013/21

15/9/2013

2013/38

11/12/2013

2013/51

2/3/2014

2014/10

14/5/2014

2014/21

13/6/2014

2014/25

7/7/2014

2014/28

4/8/2014

2014/32

lunarweekstart
Esta funcin devuelve un valor correspondiente a una fecha y hora con el primer milisegundo de la semana
lunar en la que se incluye date. Las semanas lunares en Qlik Sense se definen contando 1 de enero como el
primer da de la semana.

Sintaxis:
LunarweekStart(date[, period_no[, first_week_day]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

431

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero o una expresin que viene a ser un entero, en el que el valor 0
indica la semana lunar en la que se incluye date. Los valores negativos en period_no
indican semanas lunares precedentes y los valores positivos indican semanas lunares
subsiguientes.

first_week_
day

Un desplazamiento que puede ser mayor que o menor que cero. Esto cambia el comienzo
del ao por el nmero especificado de das y/o fracciones de un da.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

lunarweekstart('12/01/2013')

Devuelve 08/01/2013.

lunarweekstart('12/01/2013', -1)

Devuelve 01/01/2013.

lunarweekstart('12/01/2013', 0, 1 )

Devuelve 09/01/2013.
Porque el desplazamiento especificado
estableciendo first_week_day como 1
significa que el comienzo del ao cambia a
02/01/2013.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

432

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas


originales y una columna con el valor de
retorno de la funcin lunarweekstart().
Podemos mostrar la fecha hora completa
especificando el formato en el panel de
propiedades.

Este ejemplo encuentra el primer da de la semana lunar


de cada fecha de facturacin de la tabla, donde date se
desplaza una semana especificando period_no como 1.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
LunarWeekStart(InvDate, 1) AS LWkStart
Resident TempTable;
Drop table TempTable;

InvDate

LWkStart

28/03/2012

01/04/2012

10/12/2012

16/12/2012

5/2/2013

12/02/2013

31/3/2013

02/04/2013

19/5/2013

21/05/2013

15/9/2013

17/09/2013

11/12/2013

17/12/2013

2/3/2014

05/03/2014

14/5/2014

21/05/2014

13/6/2014

18/06/2014

7/7/2014

09/07/2014

4/8/2014

06/08/2014

makedate
Esta funcin devuelve una fecha calculada desde el ao YYYY, el mes MM y el dia DD.

Sintaxis:
MakeDate(YYYY [ , MM [ , DD ] ])
Tipo de datos que devuelve: dual
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 define da alguno, se presupone 1 (el primero de mes).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

433

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

makedate(2012)

devuelve 2012-01-01

makedate(12)

devuelve 0012-01-01

makedate(2012,12)

devuelve 2012-12-01

makedate(2012,2,14)

devuelve 2012-02-14

maketime
Esta funcin devuelve una hora calculada a partir del ao hh, el minuto mm y los segundos ss.

Sintaxis:
MakeTime(hh [ , mm [ , ss ] ])
Tipo de datos que devuelve: dual
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.

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 ] ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

434

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

YYYY

El ao como un entero.

WW

La semana como un entero.

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(2014,6,6)

devuelve 2014-02-09

makeweekdate(2014,6,1)

devuelve 2014-02-04

makeweekdate(2014,6)

devuelve 2014-02-03 (se asume el da de la semana 0)

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)

Tipo de datos que devuelve: Entero


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: un nombre de mes tal y como venga definido en la variable de entorno
MonthNames y un entero entre 1 y 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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

435

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Ejemplos y resultados:
Ejemplo

Resultado

month( '2012-10-12' )

devuelve Oct

month( '35648' )

devuelve Aug, porque 35648 = 1997-08-06

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[, period_no])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, el cual, si es 0 o se omite, indica el mes que contiene la fecha


date. Los valores negativos en period_no indican meses precedentes y los valores
positivos indican meses posteriores.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

monthend('19/02/2012')

Devuelve 29/02/2012
23:59:59.

monthend('19/02/2001', -1)

Devuelve 31/01/2001
23:59:59.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

436

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin monthend().
Podemos mostrar la fecha
hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el ltimo da del mes de cada fecha de facturacin


de la tabla, donde la fecha base se desplaza cuatro meses especificando
period_no como 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
MonthEnd(InvDate, 4) AS MthEnd
Resident TempTable;
Drop table TempTable;

InvDate

MthEnd

28/03/2012

31/07/2012

10/12/2012

30/04/2013

5/2/2013

30/06/2013

31/3/2013

31/07/2013

19/5/2013

30/09/2013

15/9/2013

31/01//2014

11/12/2013

30/04//2014

2/3/2014

31/07//2014

14/5/2014

30/09/2014

13/6/2014

31/10/2014

7/7/2014

30/11/2014

4/8/2014

31/12/2014

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[, period_no])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

437

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, el cual, si es 0 o se omite, indica el mes que contiene la fecha


date. Los valores negativos en period_no indican meses precedentes y los valores
positivos indican meses posteriores.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

monthname('19/10/2013')

Devuelve Oct 2013.


Porque en ste y los dems
ejemplos, la sentencia
SET Monthnames se fija en
Jan;Feb;Mar, etc.

monthname('19/10/2013', -1)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

Devuelve Sep 2013.

438

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las


fechas originales y una columna con
el valor de retorno de la funcin
monthname(). En

En este ejemplo, por cada fecha de facturacin de la tabla, el


nombre del mes se crea a partir del nombre del mes desplazado
cuatro meses desde base_date, y desde el ao.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
MonthName(InvDate, 4) AS MthName
Resident TempTable;
Drop table TempTable;

InvDate

MthName

28/03/2012

Jul 2012

10/12/2012

Apr 2013

5/2/2013

Jun 2013

31/3/2013

Jul 2013

19/5/2013

Sep 2013

15/9/2013

Jan 2014

11/12/2013

Apr 2014

2/3/2014

Jul 2014

14/5/2014

Sep 2014

13/6/2014

Oct 2014

7/7/2014

Nov 2014

4/8/2014

Dec 2014

monthsend
Esta funcin devuelve un valor correspondiente a una fecha y hora con el ltimo milisegundo del mes,
periodo de dos meses, trimestre, cuatrimestre o semestre que engloba la fecha base. Tambin es posible
hallar la fecha-hora de un periodo anterior o posterior.

Sintaxis:
MonthsEnd(n_months, date[, period_no [, first_month_of_year]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

n_months

El nmero de meses que define el periodo. Un entero o expresin que devuelve un entero
que debe ser uno de estos: 1 (equivalente a la funcin inmonth()), 2 (bimensual), 3
(equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

439

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

El periodo puede desplazarse mediante period_no, un entero, o expresin que viene a ser
un entero, en el que el valor 0 indica el periodo que contiene a base_date. Los valores
negativos en period_no indican periodos precedentes y los valores positivos indican
periodos subsiguientes.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

monthsend(4, '19/07/2013')

Devuelve 31/08/2013.

monthsend(4, '19/10/2013', -1)

Devuelve 31/08/2013.

monthsend(4, '19/10/2013', 0, 2)

Devuelve 31/01/2014.
Porque el inicio del ao
se convierte en el mes 2.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

440

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin MonthsEnd().

Este ejemplo encuentra el final del ltimo da del periodo bimensual de cada
fecha de facturacin, desplazado hacia delante en un periodo de dos meses.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
MonthsEnd(2, InvDate, 1) AS BiMthsEnd
Resident TempTable;
Drop table TempTable;

InvDate

BiMthsEnd

28/03/2012

30/06/2012

10/12/2012

28/02/2013

5/2/2013

30/04/2013

31/3/2013

30/04/2013

19/5/2013

31/08/2013

15/9/2013

31/12/2013

11/12/2013

28/02/2014

2/3/2014

30/06/2014

14/5/2014

31/08/2014

13/6/2014

31/08/2014

7/7/2014

31/10/2014

4/8/2014

31/10/2014

monthsname
Esta funcin devuelve un valor de visualizacin que representa el rango de meses del periodo (con el mismo
formato que la variable de script MonthNames) as como el ao. El valor numrico subyacente corresponde
a la fecha y hora del primer milisegundo del mes, periodo de dos meses, trimestre, cuatrimestre o semestre
que contiene la fecha base.

Sintaxis:
MonthsName(n_months, date[, period_no[, first_month_of_year]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

n_months

El nmero de meses que define el periodo. Un entero o expresin que devuelve un entero
que debe ser uno de estos: 1 (equivalente a la funcin inmonth()), 2 (bimensual), 3
(equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

441

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

El periodo puede desplazarse mediante period_no, un entero, o expresin que viene a ser
un entero, en el que el valor 0 indica el periodo que contiene a base_date. Los valores
negativos en period_no indican periodos precedentes y los valores positivos indican
periodos subsiguientes.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

monthsname(4, '19/10/2013')

Devuelve Sep-Dec 2013.


Porque en ste y los dems ejemplos,
la sentencia SET Monthnames se fija
en Jan;Feb;Mar, etc.

monthsname(4, '19/10/2013', -1)

Devuelve May-Aug 2013.

monthsname(4, '19/10/2013', 0, 2)

Devuelve Oct-Jan 2014.


Porque el ao se ha especificado para
que comience en el mes 2, por lo tanto
el periodo de cuatro meses termina el
primer mes del ao siguiente.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

442

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas


originales y una columna con el valor
de retorno de la funcin monthsname
().

En este ejemplo, por cada fecha de facturacin de la tabla, el


nombre de los meses se crea a partir del rango de meses en el
periodo bimensual y a partir del ao. El rango se desplaza en
4x2 meses especificando period_no como 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

InvDate

MthsName

28/03/2012

Nov-Dec 2012

10/12/2012

Jul-Aug 2013

5/2/2013

Sep-Oct 2013

31/3/2013

Nov-Dec2013

19/5/2013

Jan-Feb 2014

15/9/2013

May-Jun 2014

11/12/2013

Jul-Aug 2014

2/3/2014

Nov-Dec 2014

14/5/2014

Jan-Feb 2015

13/6/2014

Jan-Feb 2015

7/7/2014

Mar-Apr 2015

4/8/2014

Mar-Apr 2015

InvoiceData:
LOAD *,
MonthsName(2, InvDate, 4) AS MthsName
Resident TempTable;
Drop table TempTable;

monthsstart
Esta funcin devuelve un valor correspondiente a la fecha y hora del primer milisegundo del mes, periodo de
dos meses, trimestre, cuatrimestre o semestre que contiene la fecha base. Tambin es posible hallar la
fecha-hora de un periodo anterior o posterior.

Sintaxis:
MonthsStart(n_months, date[, period_no [, first_month_of_year]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

n_months

El nmero de meses que define el periodo. Un entero o expresin que devuelve un entero
que debe ser uno de estos: 1 (equivalente a la funcin inmonth()), 2 (bimensual), 3
(equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

443

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

El periodo puede desplazarse mediante period_no, un entero, o expresin que viene a ser
un entero, en el que el valor 0 indica el periodo que contiene a base_date. Los valores
negativos en period_no indican periodos precedentes y los valores positivos indican
periodos subsiguientes.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

monthsstart(4, '19/10/2013')

Devuelve 1/09/2013.

monthsstart(4, '19/10/2013, -1)

Devuelve 01/05/2013.

monthsstart(4, '19/10/2013', 0, 2 )

Devuelve 01/10/2013.
Porque el inicio del ao se
convierte en el mes 2.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

444

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin MonthsStart().

Este ejemplo encuentra el primer da del periodo bimensual de cada fecha


de facturacin, desplazado hacia delante en un periodo de dos meses.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
MonthsStart(2, InvDate, 1) AS BiMthsStart
Resident TempTable;
Drop table TempTable;

InvDate

BiMthsStart

28/03/2012

01/05/2012

10/12/2012

01/01/2013

5/2/2013

01/03/2013

31/3/2013

01/05/2013

19/5/2013

01/07/2013

15/9/2013

01/11/2013

11/12/2013

01/01/2014

2/3/2014

01/05/2014

14/5/2014

01/07/2014

13/6/2014

01/07/2014

7/7/2014

01/09/2014

4/8/2014

01/09/2014

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[, period_no])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, el cual, si es 0 o se omite, indica el mes que contiene la fecha


date. Los valores negativos en period_no indican meses precedentes y los valores
positivos indican meses posteriores.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

445

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

monthstart('19/10/2001')

Devuelve 01/10/2001.

monthstart('19/10/2001', -1)

Devuelve 01/09/2001.

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin monthstart().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el primer da del mes de cada fecha de facturacin


de la tabla, donde base_date se desplaza cuatro meses especificando
period_no como 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
MonthStart(InvDate, 4) AS MthStart
Resident TempTable;
Drop table TempTable;

InvDate

MthStart

28/03/2012

01/07/2012

10/12/2012

01/04/2013

5/2/2013

01/06/2013

31/3/2013

01/07/2013

19/5/2013

01/09/2013

15/9/2013

01/01/2014

11/12/2013

01/04/2014

2/3/2014

01/07/2014

14/5/2014

01/09/2014

13/6/2014

01/10/2014

7/7/2014

01/11/2014

4/8/2014

01/12/2014

networkdays
La funcin 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.


Sintaxis:
networkdays (start_date, end_date [, holiday])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

446

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

start_date

La fecha inicial que se ha de evaluar.

end_date

La fecha final que se ha de evaluar.

holiday

Los perodos de vacaciones que deben excluirse de los das laborables. Un periodo de
vacaciones se indica como una fecha inicial y una fecha final, separadas por comas.

Ejemplo: '25/12/2013', '26/12/2013'


Puede especificar ms de un perodo de vacaciones, separados por comas.

Ejemplo: '25/12/2013', '26/12/2013', '31/12/2013', '01/01/2014'


Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

networkdays ('19/12/2013', '07/01/2014')

Devuelve 14. Este ejemplo no tiene las


vacaciones en cuenta.

networkdays ('19/12/2013', '07/01/2014',


'25/12/2013', '26/12/2013')

Devuelve 12. Este ejemplo tiene en cuenta las


vacaciones 25/12/2013 to 26/12/2013.

networkdays ('19/12/2013', '07/01/2014',


'25/12/2013', '26/12/2013', '31/12/2013',
'01/01/2014')

Devuelve 10. Este ejemplo tiene en cuenta


dos perodos de vacaciones.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

447

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante muestra los valores


devueltos de NetworkDays para cada uno de
los registros de la tabla.

PayTable:
LOAD recno() as InvID, * INLINE [
InvRec|InvPaid
28/03/2012|28/04/2012
10/12/2012|01/01/2013
5/2/2013|5/3/2013
31/3/2013|01/5/2013
19/5/2013|12/6/2013
15/9/2013|6/10/2013
11/12/2013|12/01/2014
2/3/2014|2/4/2014
14/5/2014|14/6/2014
13/6/2014|14/7/2014
7/7/2014|14/8/2014
4/8/2014|4/9/2014
] (delimiter is '|');
NrDays:
Load *,
NetWorkDays(InvRec,InvPaid) As PaidDays
Resident PayTable;
Drop table PayTable;

InvID

InvRec

InvPaid

PaidDays

28/03/2012

28/04/2012

23

10/12/2012

01/01/2013

17

5/2/2013

5/3/2013

21

31/3/2013

01/5/2013

23

19/5/2013

12/6/2013

18

15/9/2013

6/10/2013

15

11/12/2013

12/01/2014

23

2/3/2014

2/4/2014

23

14/5/2014

14/6/2014

23

10

13/6/2014

14/7/2014

22

11

7/7/2014

14/8/2014

29

12

4/8/2014

4/9/2014

24

now
Esta funcin devuelve una fecha-hora con la hora actual segn el reloj del sistema. El valor por defecto es de
1.

Sintaxis:
now([ timer_mode])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

448

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

timer_mode

Puede tener los siguientes valores:


0 (hora en la que termin la ltima carga de datos)
1 (hora en la que se llam a la funcin)
2 (hora en la que se abri la app)

Si usa la funcin en un script de carga de datos, timer_mode=0 dar como


resultado la hora de la ltima carga de datos finalizada, mientras que timer_
mode=1 proporcionar la hora de la llamada a la funcin en la carga de datos
actual.

Ejemplos y resultados:
Ejemplo

Resultado

now( 0)

Devuelve la hora en la que se complet la ltima carga de datos.

now( 1)

now( 2)

Cuando se usa en una expresin de visualizacin, devuelve la hora de la llamada a la


funcin.
Cuando se usa en un script de carga de datos, devuelve la hora de la llamada a la
funcin en la carga de datos actual.

Devuelve la hora en la que se abri la app.

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[, period_no[, first_month_of_year]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

449

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, en el que el valor 0 indica el trimestre que contiene a date. Los
valores negativos en period_no indican trimestres precedentes y los valores positivos
indican trimestres posteriores.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

quarterend('29/10/2005')

Devuelve 31/12/2005
23:59:59.

quarterend('29/10/2005', -1)

Devuelve 30/09/2005
23:59:59.

quarterend('29/10/2005', 0, 3)

Devuelve 30/11/2005
23:59:59.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

450

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin quarterend().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el ltimo da del trimestre de cada fecha de


facturacin de la tabla, donde el primer mes del ao se especifica como mes
3.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
QuarterEnd(InvDate, 0, 3) AS QtrEnd
Resident TempTable;
Drop table TempTable;

InvDate

QtrEnd

28/03/2012

31/05/2012

10/12/2012

28/02/2013

5/2/2013

28/02/2013

31/3/2013

31/05/2013

19/5/2013

31/05/2013

15/9/2013

30/11/2013

11/12/2013

28/02/2014

2/3/2014

31/05/2014

14/5/2014

31/05/2014

13/6/2014

31/08/2014

7/7/2014

31/08/2014

4/8/2014

31/08/2014

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[, period_no[, first_month_of_year]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

451

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, en el que el valor 0 indica el trimestre que contiene a date. Los
valores negativos en period_no indican trimestres precedentes y los valores positivos
indican trimestres posteriores.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Ejemplo

Resultado

quartername('29/10/2013')

Devuelve Oct-Dec 2013.

quartername('29/10/2013', -1)

Devuelve Jul-Sep 2013.

quartername('29/10/2013', 0, 3)

Devuelve Sep-Nov 2013.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

452

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin quartername().

En este ejemplo, por cada fecha de factura en la tabla, el nombre del


trimestre se crea basndose en el trimestre que contiene a InvID. El primer
mes del ao se especifica como mes 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
QuarterName(InvDate, 0, 4) AS QtrName
Resident TempTable;
Drop table TempTable;

InvDate

QtrName

28/03/2012

Jan-Mar
2011

10/12/2012

Oct-Dec
2012

5/2/2013

Jan-Mar
2012

31/3/2013

Jan-Mar
2012

19/5/2013

Apr-Jun
2013

15/9/2013

Jul-Sep
2013

11/12/2013

Oct-Dec
2013

2/3/2014

Jan-Mar
2013

14/5/2014

Apr-Jun
2014

13/6/2014

Apr-Jun
2014

7/7/2014

Jul-Sep
2014

4/8/2014

Jul-Sep
2014

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[, period_no[, first_month_of_year]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

453

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, en el que el valor 0 indica el trimestre que contiene a date. Los
valores negativos en period_no indican trimestres precedentes y los valores positivos
indican trimestres posteriores.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

quarterstart('29/10/2005')

Devuelve 01/10/2005.

quarterstart('29/10/2005', -1 )

Devuelve 01/07/2005.

quarterstart('29/10/2005', 0, 3)

Devuelve 01/09/2005.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

454

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin quarterstart().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el primer da del trimestre de cada fecha de


facturacin de la tabla, donde el primer mes del ao se especifica como mes
3.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
QuarterStart(InvDate, 0, 3) AS QtrStart
Resident TempTable;
Drop table TempTable;

InvDate

QtrStart

28/03/2012

01/03/2012

10/12/2012

01/12/2012

5/2/2013

01/12/2012

31/3/2013

01/03/2013

19/5/2013

01/03/2013

15/9/2013

01/09/2013

11/12/2013

01/12/2013

2/3/2014

01/03/2014

14/5/2014

01/03/2014

13/6/2014

01/06/2014

7/7/2014

01/06/2014

4/8/2014

01/06/2014

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

455

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
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 toma como entrada una fecha-hora timestamp y un ao year y actualiza timestamp con el
ao year especificado en la entrada.

Sintaxis:
setdateyear (timestamp, year)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

timestamp

Es una indicacin de fecha-hora estndar de Qlik Sense (a menudo solo una fecha).

year

Es un ao de cuatro dgitos.

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

setdateyear ('29/10/2005', 2013)

Devuelve '29/10/2013'

setdateyear ('29/10/2005 04:26:14', 2013)

Devuelve '29/10/2013 04:26:14'


Para ver la parte de la hora en una
visualizacin, debe definir el formato numrico
en Fecha y escoger un valor de formato que
muestre valores de hora.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

456

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante contiene las fechas


originales y una columna en la que el ao se
debe fijar en 2013.

SetYear:
Load *,
SetDateYear(testdates, 2013) as NewYear
Inline [
testdates
1/11/2012
10/12/2012
1/5/2013
2/1/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

testdates

NewYear

1/11/2012

1/11/2013

10/12/2012

10/12/2013

2/1/2012

2/1/2013

1/5/2013

1/5/2013

19/5/2013

19/5/2013

15/9/2013

15/9/2013

11/12/2013

11/12/2013

2/3/2014

2/3/2013

14/5/2014

14/5/2013

13/6/2014

13/6/2013

7/7/2014

7/7/2013

4/8/2014

4/8/2013

setdateyearmonth
Esta funcin toma como entrada una fecha-hora timestamp, un mes month y un ao year y actualiza

timestamp con year y month especificados en la entrada. .


Sintaxis:
SetDateYearMonth (timestamp, year, month)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

timestamp

Es una indicacin 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:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

457

5 Funciones en scripts y en expresiones de grfico


sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

setdateyearmonth ('29/10/2005', 2013, 3)

Devuelve '29/03/2013'

setdateyearmonth ('29/10/2005 04:26:14', 2013, 3)

Devuelve '29/03/2013 04:26:14'


Para ver la parte de la hora en una
visualizacin, debe definir el formato numrico
en Fecha y escoger un valor de formato que
muestre valores de hora.

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.

La tabla resultante contiene las fechas


originales y una columna en la que el ao se
debe fijar en 2013.

SetYearMonth:
Load *,
SetDateYearMonth(testdates, 2013,3) as NewYearMonth
Inline [
testdates
1/11/2012
10/12/2012
2/1/2013
19/5/2013
15/9/2013
11/12/2013
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];

testdates

NewYearMonth

1/11/2012

1/3/2013

10/12/2012

10/3/2013

2/1/2012

2/3/2013

19/5/2013

19/3/2013

15/9/2013

15/3/2013

11/12/2013

11/3/2013

14/5/2014

14/3/2013

13/6/2014

13/3/2013

7/7/2014

7/3/2013

4/8/2014

4/3/2013

timezone
Esta funcin devuelve el nombre de la zona horaria actual tal y como se define en Windows.

Sintaxis:
TimeZone( )
Tipo de datos que devuelve: cadena
Ejemplo:
timezone( )

today
Esta funcin devuelve la fecha actual segn el reloj del sistema.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

458

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
today([ timer_mode])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

timer_mode

Puede tener los siguientes valores:


0 (da en el que termin la ltima carga de datos)
1 (da en el que se llam a la funcin)
2 (da en el que se abri la app)

Si usa la funcin en un script de carga de datos, timer_mode=0 dar como


resultado el da de la ltima carga de datos finalizada, mientras que timer_
mode=1 proporcionar el da de la carga actual de datos.

Ejemplos y resultados:
Ejemplo

Resultado

Today(
0)

Devuelve el da de la ltima carga de datos finalizada.

Today(
1)

Cuando se usa en una expresin de visualizacin, devuelve el da de la llamada a la funcin.


Cuando se usa en un script de carga de datos, esto devuelve el da en el que se inici la carga
de datos actual.

Today(
2)

Devuelve el da en el que se abri la app.

UTC
Devuelve la actual Coordinated Universal Time.

Sintaxis:
UTC( )
Tipo de datos que devuelve: dual
Ejemplo:
utc( )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

459

5 Funciones en scripts y en expresiones de grfico


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(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

Tipo de datos que devuelve: Entero


Argumento

Descripcin

timestamp

La fecha para evaluar como una fecha-hora o una expresin que devuelve una fecha-hora,
para convertir, por ejemplo '2012-10-12'.

first_week_

Si no especificamos first_week_day, se utilizar el valor de la variable FirstWeekDay

day

como primer da de la semana.


Si desea utilizar otro da como primer da de la semana, establezca first_week_day en:
l

0 para lunes

1 para martes

2 para mircoles

3 para jueves

4 para viernes

5 para sbado

6 para domingo

El entero que devuelve la funcin utilizar ahora el primer da de la semana establecido


con first_week_day.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

460

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

broken_

Si no especificamos broken_weeks, se utilizar el valor de la variable BrokenWeeks

weeks

para definir si las semanas se interrumpen o no.


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.
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.


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)

1 (= se utilizan semanas interrumpidas)

reference_

Si no especifica un reference_day, el valor de la variable ReferenceDay se utilizar para

day

definir qu da de enero fijar como da de referencia para definir la semana 1. 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)

2 (= 2 de enero)

3 (= 3 de enero)

4 (= 4 de enero)

5 (= 5 de enero)

6 (= 6 de enero)

7 (= 7 de enero)

Ejemplos y resultados:
Ejemplo

Resultado

week( '2012-10-12' )

devuelve 41

week( '35648' )

devuelve 32, porque 35648 = 1997-08-06

week('2012-10-12', 0, 1)

devuelve 42

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

461

5 Funciones en scripts y en expresiones de grfico


weekday
Esta funcin devuelve un valor dual con lo siguiente:
l

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).

Sintaxis:
weekday(date [,first_week_day=0])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

first_week_

Si no especificamos first_week_day, se utilizar el valor de la variable FirstWeekDay

day

como primer da de la semana.


Si desea utilizar otro da como primer da de la semana, establezca first_week_day en:
l

0 para lunes

1 para martes

2 para mircoles

3 para jueves

4 para viernes

5 para sbado

6 para domingo

El valor devuelto por la funcin utilizar el primer da de la semana establecido con first_

week_day como base (0).


Vea: FirstWeekDay (pgina 136)

Ejemplos y resultados:
A menos que se indique de forma especfica, FirstWeekDay es 0 en estos ejemplos.

Ejemplo

Resultado

weekday( '1971-10-12' )

devuelve 'Verdadero' y 1

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

462

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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:
WeekEnd(date [, period_no[, first_week_day]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

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.

first_week_

Especifica el da en el que se inicia la semana. Si se omite, se utiliza el valor de la variable


FirstWeekDay.

day

Los valores posibles first_week_day son:


l

0 para lunes

1 para martes

2 para mircoles

3 para jueves

4 para viernes

5 para sbado

6 para domingo

Vea: FirstWeekDay (pgina 136)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

463

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

weekend('10/01/2013')

Devuelve 12/01/2013
23:59:59.

weekend('10/01/2013', -1)

Devuelve 06/01/2013
23:59:59.

weekend('10/01/2013', 0, 1)

Devuelve 14/01/2013
23:59:59.

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin weekend().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el ltimo da de la semana que sigue a la semana de


cada fecha de facturacin en la tabla.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
WeekEnd(InvDate, 1) AS WkEnd
Resident TempTable;
Drop table TempTable;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

InvDate

WkEnd

28/03/2012

08/04/2012

10/12/2012

23/12/2012

5/2/2013

17/02/2013

31/3/2013

07/04/2013

19/5/2013

26/05/2013

15/9/2013

22/09/2013

11/12/2013

22/12/2013

2/3/2014

09/03/2014

14/5/2014

25/05/2014

13/6/2014

22/06/2014

7/7/2014

20/07/2014

4/8/2014

17/08/2014

464

5 Funciones en scripts y en expresiones de grfico


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[, period_no[,first_week_day]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

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.

first_week_

Especifica el da en el que se inicia la semana. Si se omite, se utiliza el valor de la variable


FirstWeekDay.

day

Los valores posibles first_week_day son:


l

0 para lunes

1 para martes

2 para mircoles

3 para jueves

4 para viernes

5 para sbado

6 para domingo

Vea: FirstWeekDay (pgina 136)

Ejemplos y resultados:
Ejemplo

Resultado

weekname('12/01/2013')

Devuelve 2013/02.

weekname('12/01/2013', -1)

Devuelve 2013/01.

weekname('12/01/2013', 0, 1)

Devuelve 2013/02.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

465

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una
columna con el valor de
retorno de la funcin
weekname(). Podemos
mostrar la fecha hora
completa especificando
el formato en el panel
de propiedades.

En este ejemplo, por cada fecha de facturacin en la tabla, el nombre de la


semana se crea a partir del ao en el que cae la semana y su nmero de
semana asociado, desplazado una semana especificando period_no como 1.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
WeekName(InvDate, 1) AS WkName
Resident TempTable;
Drop table TempTable;

InvDate

WkName

28/03/2012

2012/14

10/12/2012

2012/51

5/2/2013

2013/07

31/3/2013

2013/14

19/5/2013

2013/21

15/9/2013

2013/38

11/12/2013

2013/51

2/3/2014

2014/10

14/5/2014

2014/21

13/6/2014

2014/25

7/7/2014

2014/29

4/8/2014

2014/33

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 [, period_no[, first_week_day]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

466

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

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.

first_week_

Especifica el da en el que se inicia la semana. Si se omite, se utiliza el valor de la variable


FirstWeekDay.

day

Los valores posibles first_week_day son:


l

0 para lunes

1 para martes

2 para mircoles

3 para jueves

4 para viernes

5 para sbado

6 para domingo

Vea: FirstWeekDay (pgina 136)

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

weekstart('12/01/2013')

Devuelve 07/01/2013.

weekstart('12/01/2013', -1 )

Devuelve 31/11/2012.

weekstart('12/01/2013', 0, 1)

Devuelve 08/01/2013.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

467

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin weekstart().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el primer da de la semana que sigue a la semana de


cada fecha de facturacin en la tabla.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
WeekStart(InvDate, 1) AS WkStart
Resident TempTable;
Drop table TempTable;

InvDate

WkStart

28/03/2012

02/04/2012

10/12/2012

17/12/2012

5/2/2013

11/02/2013

31/3/2013

01/04/2013

19/5/2013

20/05/2013

15/9/2013

16/09/2013

11/12/2013

16/12/2013

2/3/2014

03/03/2014

14/5/2014

19/05/2014

13/6/2014

16/06/2014

7/7/2014

14/07/2014

4/8/2014

11/08/2014

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

468

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
Ejemplos y resultados:
Ejemplo

Resultado

weekyear( '1996-12-30' )

devuelve 1997, porque la semana 1 de 1998 empieza el 1996-12-30

weekyear( '1997-01-02' )

devuelve 1997

weekyear( '1997-12-28' )

devuelve 1997

weekyear( '1997-12-30' )

devuelve 1998, porque la semana 1 de 1998 empieza el 29/12/1997

weekyear( '1999-01-02' )

devuelve 1998, porque la semana 53 de 1998 finaliza el 1999-01-03

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)

Tipo de datos que devuelve: Entero


Ejemplos y resultados:
Ejemplo

Resultado

year( '2012-10-12' )

devuelve 2012

year( '35648' )

devuelve 1997, porque 35648 = 1997-08-06

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[, period_no[, first_month_of_year = 1]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

469

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, en el que el valor 0 indica el ao que contiene a date. Los valores
negativos de period_no indican aos precedentes y los valores positivos indican aos
futuros.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

yearend ( '19/10/2001' )

Devuelve 31/12/2001
23:59:59.

yearend ( '19/10/2001', -1 )

Devuelve 31/12/2000
23:59:59.

yearend ( '19/10/2001', 0, 4)

Devuelve 31/03/2002
23:59:59.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

470

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin yearend().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el ltimo da del ao de cada fecha de facturacin de


la tabla, donde el primer mes del ao se especifica como mes 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
YearEnd(InvDate, 0, 4) AS YrEnd
Resident TempTable;
Drop table TempTable;

InvDate

YrEnd

28/03/2012

31/03/2011

10/12/2012

31/03/2012

5/2/2013

31/03/2013

31/3/2013

31/03/2013

19/5/2013

31/03/2014

15/9/2013

31/03/2014

11/12/2013

31/03/2014

2/3/2014

31/03/2014

14/5/2014

31/03/2015

13/6/2014

31/03/2015

7/7/2014

31/03/2015

4/8/2014

31/03/2015

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[, period_no[, first_month_of_year]] )
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

471

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

period_no

period_no es un entero, en el que el valor 0 indica el ao que contiene a date. Los valores
negativos de period_no indican aos precedentes y los valores positivos indican aos
futuros.

month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year. El valor resultante ser pues una cadena que

year

muestre dos aos.

first_

Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

yearname ( '19/10/2001')

Devuelve 2001.

yearname ( '19/10/2001', -1 )

Devuelve 2000.

yearname ( '19/10/2001', 0, 4)

Devuelve 2001-2002.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

472

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una
columna con el valor
de retorno de la
funcin yearname().

Este ejemplo crea un nombre de dgito cuatro ms cuatro por los aos en los
que encuentra cada fecha de facturacin en la tabla. Esto es porque el primer
mes del ao se especifica como mes 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
YearName(InvDate, 0, 4) AS YrName
Resident TempTable;
Drop table TempTable;

InvDate

YrName

28/03/2012

20112012

10/12/2012

20122013

5/2/2013

20122013

31/3/2013

20122013

19/5/2013

20132014

15/9/2013

20132014

11/12/2013

20132014

2/3/2014

20132014

14/5/2014

20142015

13/6/2014

20142015

7/7/2014

20142015

4/8/2014

20142015

yearstart
Esta funcin devuelve una fecha-hora correspondiente al inicio del primer da del ao que contiene date. El
formato de salida por defecto ser el DateFormat definido en el script.

Sintaxis:
YearStart(date[, period_no[, first_month_of_year]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

473

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

date

La fecha que se ha de evaluar.

period_no

period_no es un entero, en el que el valor 0 indica el ao que contiene a date. Los valores
negativos de period_no indican aos precedentes y los valores positivos indican aos
futuros.

first_
month_of_

Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
entre 2 y 12 en first_month_of_year.

year
Ejemplos y resultados:
Estos ejemplos utilizan el formato de fecha DD/MM/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los
ejemplos segn se ajuste a sus necesidades.

Ejemplo

Resultado

yearstart ('19/10/2001')

Devuelve 01/01/2001.

yearstart ('19/10/2001', -1)

Devuelve 01/01/2000.

yearstart ('19/10/2001', 0, 4)

Devuelve 01/04/2001.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

474

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

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.

La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin yearstart().
Podemos mostrar la
fecha hora completa
especificando el formato
en el panel de
propiedades.

Este ejemplo encuentra el primer da del ao de cada fecha de facturacin


de la tabla, donde el primer mes del ao se especifica como mes 4.
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
YearStart(InvDate, 0, 4) AS YrStart
Resident TempTable;
Drop table TempTable;

InvDate

YrStart

28/03/2012

01/04/2011

10/12/2012

01/04/2012

5/2/2013

01/04/2012

31/3/2013

01/04/2012

19/5/2013

01/04/2013

15/9/2013

01/04/2013

11/12/2013

01/04/2013

2/3/2014

01/04/2013

14/5/2014

01/04/2014

13/6/2014

01/04/2014

7/7/2014

01/04/2014

4/8/2014

01/04/2014

yeartodate
Esta funcin halla si la fecha-hora de entrada cae en el ao de la fecha en que se carg el script, y devuelve
True en caso afirmativo, y False en caso negativo.

Sintaxis:
YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ])

Tipo de datos que devuelve: Booleano


Si no se utiliza ninguno de los parmetros opcionales, el ao hasta la fecha implica cualquier fecha dentro de
un ao natural, desde el 1 de enero hasta e incluido el da de la ltima ejecucin del script.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

475

5 Funciones en scripts y en expresiones de grfico


Argumentos:
Argumento

Descripcin

timestamp

La indicacin de tiempo que se ha de evaluar, por ejemplo '2012-10-12'.

yearoffset

Al especificar un yearoffset, yeartodate devuelve True para el mismo periodo de otro ao.
Un yearoffset negativo indica un ao anterior, y uno positivo un ao futuro. El ao hasta la
fecha ms reciente se obtiene especificando yearoffset = -1. Si se omite, se presupone 0.

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 ejemplo, si desea trabajar
con un ao fiscal que comience el 1 de mayo, especifique 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

yeartodate( '2011-02-01')

devuelve True

yeartodate( '2011-11-18')

devuelve True

yeartodate( '2011-11-19')

devuelve False

yeartodate( '2011-11-19', 0, 1, '2011-12-31')

devuelve True

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 e y deben interpretarse
como nmeros de valor real.

exp
La funcin exponencial natural, e^x, usando el algoritmo natural e como base. El resultado es un nmero
positivo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

476

5 Funciones en scripts y en expresiones de grfico


exp(x )
Ejemplos y resultados:
exp(3) devuelve 20.085.

log
El logaritmo natural de x. La funcin solo se define si x> 0. El resultado es un nmero.

log(x )
Ejemplos y resultados:
log(3) devuelve 1,0986

log10
El logaritmo comn (de base 10) de x. La funcin solo se define si x> 0. El resultado es un nmero.

log10(x )
Ejemplos y resultados:
log10(3) devuelve 0,4771

pow
Devuelve x elevado a la y-sima potencia. El resultado es un nmero.

pow(x,y )
Ejemplos y resultados:
pow(3, 3) devuelve 27

sqr
x al cuadrado (x elevado a 2). El resultado es un nmero.
sqr (x )
Ejemplos y resultados:
sqr(3) devuelve 9

sqrt
Raz cuadrada de x. La funcin solo se define si x >= 0. El resultado es un nmero positivo.

sqrt(x )
Ejemplos y resultados:
sqrt(3) devuelve 1,732

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

477

5 Funciones en scripts y en expresiones de grfico

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 481)(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.
GetCurrentSelections - funcin de grfico([record_sep [,tag_sep [,value_sep
[,max_values]]]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

478

5 Funciones en scripts y en expresiones de grfico


GetFieldSelections
GetFieldSelections() devuelve una string 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 que devuelve: 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


gris) en First name.

en First name.
GetAlternativeCount ([First name])

Puesto que John y Peter estn seleccionados.


GetAlternativeCount ([First name])

Puesto que ningn valor est seleccionado en


First name.

3 puesto que hay 3 valores nicos y excluidos (en


gris) en First name.
0 puesto que no hay selecciones.

GetAlternativeCount ([First name])

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

479

5 Funciones en scripts y en expresiones de grfico


Jane|Elliot|JE|Yes
Peter|Franc|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 que devuelve: 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 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 en First name.

'First name: John'

GetCurrentSelections ()

Teniendo en cuenta que John y Peter estn seleccionados en First name.


GetCurrentSelections ()

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

'First name: John,


Peter'

480

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Puesto que John y Peter estn seleccionados en First name y JA est


seleccionado en Initials.

'First name: John,


Peter

GetCurrentSelections ()

Initials: JA'

Puesto que John est seleccionado en First name y JA est seleccionado en

Initials.

'First name
=John

GetCurrentSelections ( chr(13)&chr(10) , ' = ' )

Initials=JA'

Puesto que hemos seleccionado todos los nombres excepto Sue en First name y no

'First
name=NOTSue'

hay selecciones en Initials.


=GetCurrentSelections(chr(13)&chr(10),'=',',',3)

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|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 que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

481

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 seleccionado en

5 puesto que hay 5 valores excluidos (en gris) en Initials. La sexta celda

First name.

(JA) estar en blanco puesto que est asociada con la seleccin John en
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


seleccionado en First name.

0 puesto que no hay selecciones.

GetExcludedCount
([Initials])

Teniendo en cuenta que


John est seleccionado en

0 puesto que GetExcludedCount() slo se utiliza para campos con


valores asociados, esto es, campos que no tienen selecciones.

First name.
GetExcludedCount ([First
name])

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');

GetFieldSelections - funcin de grfico


GetFieldSelections() devuelve una string 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

482

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
GetFieldSelections ( field_name [, value_sep [, max_values]])
Tipo de datos que devuelve: 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,

Mark estn seleccionados en First


name.

'NOTJane;Peter', ya que el valor 2 es el valor del argumento


max_values. De lo contrario, el resultado habra sido John; Sue;
Mark.

GetFieldSelections ([First
name],';',2)

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

483

5 Funciones en scripts y en expresiones de grfico


John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|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 que devuelve: Entero


Sintaxis:
GetPossibleCount (field_name)
Argumentos:
Argumentos

Descripcin

field_name

El campo que contiene el rango de datos que se han de medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

484

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


seleccin, John, en First name.

seleccionado 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


en First name.

5 puesto que no hay selecciones y hay 5 valores nicos en


First name.

GetPossibleCount ([First name])

Puesto que ningn valor est seleccionado


en First name.

6 puesto que no hay selecciones y hay 6 valores nicos en


Initials.

GetPossibleCount ([Initials])

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|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])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

485

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Entero
Argumentos:
Argumentos

Descripcin

field_name

El campo que contiene el rango de datos que se han de medir.

include_
excluded

Si se configura como True(), el contador incluir los valores seleccionados, los cuales
estn actualmente excluidos por las selecciones en otros campos. Si se configura como
False o se omite, 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 configurado como No, el resultado


seguir siendo 6, ya que el argumento include_excluded
est establecido como True().

Initials y, a continuacin, seleccione el valor


Yes en Has cellphone.
GetSelectedCount ([Initials])

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

486

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. Estas funciones devolvern NULL para todas las fuentes de
datos excepto 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. Se
admiten 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
La funcin ConnectString() devuelve el nombre de la conexin de datos activa en conexiones ODBC u
OLEDB. La funcin devuelve una cadena vaca si no se ha ejecutado ninguna sentencia connect, o tras una
sentencia disconnect.

ConnectString ()
FileBaseName
La funcin FileBaseName devuelve una cadena que contiene el nombre del archivo de tabla que se est
leyendo en ese momento, sin ruta ni extensin.

FileBaseName ()
FileDir
La funcin FileDir devuelve una cadena que contiene la ruta al directorio del archivo de tabla que se est
leyendo en ese momento.

FileDir ()
FileExtension
La funcin FileExtension devuelve una cadena que contiene la extensin del archivo de tabla que se est
leyendo en ese momento.

FileExtension ()
FileName
La funcin FileName devuelve una cadena que contiene el nombre del archivo de tabla que se est leyendo,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

487

5 Funciones en scripts y en expresiones de grfico


sin la ruta pero con la extensin.

FileName ()
FilePath
La funcin FilePath devuelve una cadena que contiene la ruta completa al archivo de tabla que se est
leyendo en ese momento.

FilePath ()
FileSize
La funcin FileSize 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
La funcin FileTime 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
La funcin GetFolderPath devuelve el valor de la funcin de Microsoft Windows SHGetFolderPath. Esta
funcin toma como entrada el nombre de una carpeta Microsoft Windows y devuelve la ruta completa a la
carpeta.

GetFolderPath ()
QvdCreateTime
Esta funcin de script devuelve la fecha y hora de la cabecera XML desde un archivo QVD si lo hubiere; si no,
devuelve 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

488

5 Funciones en scripts y en expresiones de grfico


QvdNoOfRecords (filename)
QvdTableName
Esta funcin de script devuelve el nombre de la tabla almacenada 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. Se
admiten 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 pueden leer un gran nmero de metaetiquetas. Los ejemplos de esta seccin muestran qu etiquetas se
pueden leer para los respectivos tipos de archivo admitidos.

Solo podemos leer meta etiquetas guardadas en el archivo conforme a la especificacin


relevante, por ejemplo ID2v3 para archivos MP3 o EXIF para archivos JPG y ninguna
informacin meta que se haya guardado 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

489

5 Funciones en scripts y en expresiones de grfico


Los ejemplos utilizan la funcin GetFolderPath para hallar las rutas a archivos multimedia. Como

GetFolderPath slo se admite en el modo de legado, necesitamos reemplazar las referencias a


GetFolderPath por una ruta lib:// de conexin a los datos.
Vea: Restriccin de acceso al sistema de archivos (pgina 675)

Ejemplo 1: Archivos MP3


Este script lee todas las posibles meta etiquetas MP3 en la carpeta MyMusic:
// Script to read MP3 meta tags
for each vExt in 'mp3'
for each vFoundFile in filelist( GetFolderPath('MyMusic') & '\*.'& vExt )
FileList:
LOAD FileLongName,
subfield(FileLongName,'\',-1) as FileShortName,
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize,
FileTime(FileLongName) as FileTime,
// ID3v1.0 and ID3v1.1 tags
Attribute(FileLongName, 'Title') as Title,
Attribute(FileLongName, 'Artist') as Artist,
Attribute(FileLongName, 'Album') as Album,
Attribute(FileLongName, 'Year') as Year,
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

490

5 Funciones en scripts y en expresiones de grfico


Attribute(FileLongName, 'TDAT') as TDAT, // Date
Attribute(FileLongName, 'TDLY') as TDLY, // Playlist delay
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
Next vExt

Ejemplo 2: JPEG
Este script lee todas las posibles meta etiquetas EXIF de archivos JPG en la carpeta MyPictures.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

491

5 Funciones en scripts y en expresiones de grfico


// Script to read Jpeg Exif meta tags
for each vExt in 'jpg', 'jpeg', 'jpe', 'jfif', 'jif', 'jfi'
for each vFoundFile in filelist( GetFolderPath('MyPictures') & '\*.'& vExt )
FileList:
LOAD FileLongName,
subfield(FileLongName,'\',-1) as FileShortName,
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize,
FileTime(FileLongName) as FileTime,
// ************
Exif Main (IFD0) Attributes
************
Attribute(FileLongName, 'ImageWidth') as ImageWidth,
Attribute(FileLongName, 'ImageLength') as ImageLength,
Attribute(FileLongName, 'BitsPerSample') as BitsPerSample,
Attribute(FileLongName, 'Compression') as Compression,
// examples: 1=uncompressed, 2=CCITT, 3=CCITT 3, 4=CCITT 4,
//5=LZW, 6=JPEG (old style), 7=JPEG, 8=Deflate, 32773=PackBits RLE,
Attribute(FileLongName, 'PhotometricInterpretation') as PhotometricInterpretation,
// examples: 0=WhiteIsZero, 1=BlackIsZero, 2=RGB, 3=Palette, 5=CMYK, 6=YCbCr,
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,
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,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

492

5 Funciones en scripts y en expresiones de grfico


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,
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,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

493

5 Funciones en scripts y en expresiones de grfico


// 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,
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,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

494

5 Funciones en scripts y en expresiones de grfico


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,
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

Ejemplo 3: Archivos multimedia de Windows


Este script lee todas las posibles meta etiquetas WMA/WMV ASF en la carpeta MyMusic:
/ Script to read WMA/WMV ASF meta tags
for each vExt in 'asf', 'wma', 'wmv'
for each vFoundFile in filelist( GetFolderPath('MyMusic') & '\*.'& vExt )
FileList:
LOAD FileLongName,
subfield(FileLongName,'\',-1) as FileShortName,
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize,
FileTime(FileLongName) as FileTime,
Attribute(FileLongName, 'Title') as Title,
Attribute(FileLongName, 'Author') as Author,
Attribute(FileLongName, 'Copyright') as Copyright,
Attribute(FileLongName, 'Description') as Description,
Attribute(FileLongName, 'Rating') as Rating,
Attribute(FileLongName, 'PlayDuration') as PlayDuration,
Attribute(FileLongName, 'MaximumBitrate') as MaximumBitrate,
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

495

5 Funciones en scripts y en expresiones de grfico


Ejemplo 4: PNG
Este script lee todas las posibles meta etiquetas PNG en la carpeta MyPictures:
// Script to read PNG meta tags
for each vExt in 'png'
for each vFoundFile in filelist( GetFolderPath('MyPictures') & '\*.'& vExt )
FileList:
LOAD FileLongName,
subfield(FileLongName,'\',-1) as FileShortName,
num(FileSize(FileLongName),'# ### ### ###',',',' ') as FileSize,
FileTime(FileLongName) as FileTime,
Attribute(FileLongName, 'Comment') as Comment,
Attribute(FileLongName, 'Creation Time') as Creation_Time,
Attribute(FileLongName, 'Source') as Source,
Attribute(FileLongName, 'Title') as Title,
Attribute(FileLongName, 'Software') as Software,
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

ConnectString
La funcin ConnectString() devuelve el nombre de la conexin de datos activa en conexiones ODBC u
OLEDB. La funcin devuelve una cadena vaca si no se ha ejecutado ninguna sentencia connect, o tras una
sentencia disconnect.

Sintaxis:
ConnectString()

Ejemplos y resultados:
Ejemplo

Resultado

LIB CONNECT TO 'Tutorial ODBC';


ConnectString:
Load ConnectString() as
ConnectString AutoGenerate 1;

Devuelve 'Tutorial ODBC' en el campo ConnectString.


Este ejemplo da por sentado que tenemos una conexin de datos
disponible llamada Tutorial ODBC.

FileBaseName
La funcin FileBaseName devuelve una cadena que contiene el nombre del archivo de tabla que se est
leyendo en ese momento, sin ruta ni extensin.

Sintaxis:
FileBaseName()

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

496

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

LOAD *, filebasename( ) as X from


C:\UserFiles\abc.txt

Devolver "abc" en el campo X para cada registro ledo.

FileDir
La funcin FileDir 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


C:\UserFiles\abc.txt

Devolver "C:\UserFiles" en el campo X para cada registro ledo.

FileExtension
La funcin FileExtension 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


C:\UserFiles\abc.txt

Devolver "txt" en el campo X para cada registro ledo.

FileName
La funcin FileName devuelve una cadena que contiene el nombre del archivo de tabla que se est leyendo,
sin la ruta pero con la extensin.

Sintaxis:
FileName()

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

497

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

LOAD *, FileName( ) as X from


C:\UserFiles\abc.txt

Devolver 'abc.txt' en el campo X para cada registro ledo.

FilePath
La funcin FilePath devuelve una cadena que contiene la ruta completa 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


C:\UserFiles\abc.txt

Devolver 'C:\UserFiles\abc.txt' en el campo X para cada registro ledo.

FileSize
La funcin FileSize 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])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

498

5 Funciones en scripts y en expresiones de grfico


Argumentos:
Argumento

Descripcin

filename

El nombre de un archivo, si es necesario incluyendo la ruta, como una carpeta o una


conexin de datos a archivos web. Si no especificamos un nombre de archivo, se utiliza el
archivo de tabla que se est leyendo actualmente.

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
from abc.txt;

Devolver el tamao del archivo especificado (abc.txt) como un entero en


el campo X de cada registro ledo.

FileSize(
'lib://MyData/xyz.xls' )

Devolver el tamao del archivo xyz.xls.

FileTime
La funcin FileTime 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.

Sintaxis:
FileTime([ filename ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

499

5 Funciones en scripts y en expresiones de grfico


Argumentos:
Argumento

Descripcin

filename

El nombre de un archivo, si es necesario incluyendo la ruta, como una carpeta o una


conexin de datos a 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( )
as X from abc.txt;

Devolver la fecha y hora de la ltima modificacin del archivo (abc.txt), como


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
La funcin GetFolderPath devuelve el valor de la funcin de Microsoft Windows SHGetFolderPath. Esta
funcin toma como entrada el nombre de una carpeta Microsoft Windows y devuelve la ruta completa a la
carpeta.

Esta funcin no es posible en modo estndar.

Sintaxis:
GetFolderPath(foldername)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

500

5 Funciones en scripts y en expresiones de grfico


Argumentos:
Argumento

Descripcin

foldername

Nombre de la carpeta Microsoft Windows.


El nombre de la carpeta no debe contener espacios. Cualquier espacio que se observe en
el nombre de la carpeta en Windows Explorer debe eliminarse.
Ejemplos:

MyMusic
MyDocuments
Ejemplos y resultados:
La finalidad de este ejemplo es obtener las rutas de las siguientes carpetas Microsoft Windows: MyMusic,

MyPictures y Windows. Agregue el script de ejemplo en su app y recrguelo.


LOAD
GetFolderPath('MyMusic') as MyMusic,
GetFolderPath('MyPictures') as MyPictures,
GetFolderPath('Windows') as Windows
AutoGenerate 1;

Una vez que se haya recargado la app, los campos MyMusic, MyPictures y Windows se aaden al modelo
de datos. Cada campo contiene la ruta a la carpeta definida en la entrada. Por ejemplo:
l

C:\Users\smu\Music for the folder MyMusic

C:\Users\smu\Pictures for the folder MyPictures

C:\Windows for the folder Windows

QvdCreateTime
Esta funcin de script devuelve la fecha y hora de la cabecera XML desde un archivo QVD si lo hubiere; si no,
devuelve NULL.

Sintaxis:
QvdCreateTime(filename)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

501

5 Funciones en scripts y en expresiones de grfico


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')
QvdCreateTime('lib://data\MyFile.qvd')

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

502

5 Funciones en scripts y en expresiones de grfico


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)
QvdFieldName ('lib://data\MyFile.qvd', 5)

QvdNoOfFields
Esta funcin de script devuelve el nmero de campos de un archivo QVD.

Sintaxis:
QvdNoOfFields(filename)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

503

5 Funciones en scripts y en expresiones de grfico


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
Ejemplos:
QvdNoOfFields ('MyFile.qvd')
QvdNoOfFields ('C:\MyDir\MyFile.qvd')
QvdNoOfFields ('lib://data\MyFile.qvd')

QvdNoOfRecords
Esta funcin de script devuelve el nmero de registros que se encuentran actualmente en un archivo QVD.

Sintaxis:
QvdNoOfRecords(filename)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

504

5 Funciones en scripts y en expresiones de grfico


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
Ejemplos:
QvdNoOfRecords ('MyFile.qvd')
QvdNoOfRecords ('C:\MyDir\MyFile.qvd')
QvdNoOfRecords ('lib://data\MyFile.qvd')

QvdTableName
Esta funcin de script devuelve el nombre de la tabla almacenada en un archivo QVD.

Sintaxis:
QvdTableName(filename)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

505

5 Funciones en scripts y en expresiones de grfico


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
Ejemplos:
QvdTableName ('MyFile.qvd')
QvdTableName ('C:\MyDir\MyFile.qvd')
QvdTableName ('lib://data\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 sistemtico 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 rate y 60 (5*12) para nper. Si se realizan pagos
anuales en el mismo prstamo, utilice 6% para rate y 5 para nper.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

506

5 Funciones en scripts y en expresiones de grfico


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 inters
anual simple.

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.

Pmt (rate, nper, pv [ ,fv [ , type ] ] )


PV
Esta funcin devuelve el valor actual de una inversin.

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 ] ])

BlackAndSchole
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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

507

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

strike

El precio futuro de compra de las acciones.

time_left

El nmero de perodos de tiempo restantes.

underlying_
price

El valor actual de las acciones.

vol

Volatilidad (del precio de las acciones) expresado como un porcentaje en forma decimal,
por periodo de tiempo.

risk_free_
rate

El tipo libre de riesgo expresado como un porcentaje en forma decimal, por periodo de
tiempo.

call_or_put

El tipo de opcin:
'c', 'call' o cualquier otro valor numrico distinto de cero para opciones de compra.
'p', 'put' o 0 para opciones de venta.

Limitaciones:
El valor de strike, time_left y underlying_price debe ser >0.
El valor de vol y risk_free_rate debe ser: <0 o >0.

Ejemplos y resultados:
Ejemplo

Resultado

BlackAndSchole(130, 4, 68.5, 0.4, 0.04, 'call')

Devuelve
11,245

Esto calcula el precio terico de una opcin de compra de una accin que vale 68,5 hoy, a
un valor de 130 en 4 aos. La frmula presupone una volatilidad del 0,4 (40%) anual y un
tipo libre de riesgo del 0,04 (4%).

FV
Esta funcin devuelve el valor futuro de una inversin basada en pagos peridicos y constantes y a un inters
anual simple.

Sintaxis:
FV(rate, nper, pmt [ ,pv [ , type ] ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

508

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico. El resultado tiene un formato numrico predeterminado de
moneda. .
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. Un pago se indica como un nmero negativo, por ejemplo, -20.

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 0 (cero).

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 inters


es del 6% anual. La factura de pago llega a finales de cada mes. Cul es el total invertido
tras haber pagado la ltima factura?

Devuelve
$786.72

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 ] ])
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

rate

Es el tipo de inters por periodo.

nper

Es el nmero total de pagos en un periodo anual.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

509

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

pmt

Es el pago efectuado en cada periodo. No puede cambiar durante la validez de un periodo


anual. Un pago se indica como un nmero negativo, por ejemplo, -20.

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 0 (cero).

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

Deseamos vender un electrodomstico en cuotas mensuales de 20 $. El tipo de inters es


del 6% anual. La factura de pago llega a finales de cada mes. Cuntos periodos hacen
falta si el valor del dinero recibido tras abonar la ltima factura debera ser igual a 800 $?

Devuelve
36,56

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.

Pmt(rate, nper, pv [ ,fv [ , type ] ] )


Tipo de datos que devuelve: numrico. El resultado tiene un formato numrico predeterminado de
moneda. .
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. Un pago se indica como un nmero negativo, por ejemplo, -20.

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 0 (cero).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

510

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

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


porcentaje anual del 10 por ciento, que debe liquidarse en 8 meses:

Devuelve $2,594.66

Pmt(0.1/12,8,20000)

Para el mismo prstamo, si el pago debe hacerse al inicio del periodo, el pago es:
Pmt(0.1/12,8,20000,0,1)

Devuelve $2,573.21

PV
Esta funcin devuelve el valor actual de una inversin.

PV(rate, nper, pmt [ ,fv [ , type ] ])


Tipo de datos que devuelve: numrico. El resultado tiene un formato numrico predeterminado de
moneda. .
El valor actual es la cantidad total que supone una serie de pagos futuros en el momento presente. Por
ejemplo, cuando usted toma prestado un dinero, la cantidad total del prstamo es el valor actual que debe al
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. Un pago se indica como un nmero negativo, por ejemplo, -20.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

511

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

Cul es el valor actual de una deuda, si debe abonar 100 $al final de cada mes durante
un periodo de 5 aos, dado un inters del 7%?

Devuelve
$5,050.20

PV(0.07/12,12*5,-100,0,0)

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 ] ])
Tipo de datos que devuelve: numrico.
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

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. Un pago se indica como un nmero negativo, por ejemplo, -20.

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 0 (cero).

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
mensuales de 300 $?

Devuelve
2.00%

Rate(60,-300,10000)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

512

5 Funciones en scripts y en expresiones de grfico

5.10 Funciones de formato


Las funciones de formato imponen un formato de presentacin a los campos o expresiones numricos de
entrada. Dependiendo del tipo de datos, podemos especificar los caracteres del separador decimal, el
separador de miles, etc.
Las funciones devuelven todas ellas un valor dual con ambos valores, el de cadena y nmerico, pero puede
pensarse en ellas como que realizan una conversin de nmero a cadena. Dual() es un caso especial, pero
las dems funciones de formato toman el valor numrico de la expresin de entrada y generan una cadena
que representa el nmero.
Por el contrario, las funciones de interpretacin toman expresiones de cadena y devuelven nmeros,
especificando el formato del nmero resultante.
Las funciones pueden utilizarse tanto en scripts de carga de datos como en expresiones de grficos.

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.

ApplyCodepage
ApplyCodepage() aplica un juego de caracteres de pgina de cdigo diferente al campo o texto indicado en
la expresin. El cdigo de pgina codepage debe ir en formato numrico.

ApplyCodepage (text, codepage)


Date
Date() da formato a una expresin como una fecha utilizando el formato establecido en las variables de
sistema del script de carga de datos, o el sistema operativo, o una cadena de formato, si se suministra.
Date (number[, format])
Dual
Dual() combina un nmero y una cadena de caracteres en un solo registro, de modo que la representacin
numrica del registro puede utilizarse para ordenar y hacer clculos, mientras que el valor de la cadena
puede utilizarse con fines de visualizacin.
Dual (text, number)
Interval
Interval() da formato a un nmero como un intervalo de tiempo utilizando el formato establecido en las

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

513

5 Funciones en scripts y en expresiones de grfico


variables de sistema del script de carga de datos, o el sistema operativo, o una cadena de formato, si se
suministra.

Interval (number[, format])


Money
Money() da formato numricamente a una expresin como un valor de moneda, en el formato establecido
en las variables de sistema del script de carga de datos, o en el sistema operativo, a menos que se
suministre una cadena de formato y, opcionalmente, unos separadores decimal y de miles.
Money (number[, format[, dec_sep [, thou_sep]]])
Num
Num() da formato numricamente a una expresin en el formato de nmero establecido en las variables de
sistema del script de carga de datos, o en el sistema operativo, a menos que se suministre una cadena de
formato y, opcionalmente, unos separadores decimal y de miles.
Num (number[, format[, dec_sep [, thou_sep]]])
Time
Time() da formato a una expresin como un valor de hora, en el formato de tiempo definido en las variables
de sistema del script de carga de datos, o el sistema operativo, a menos que se suministre una cadena de
formato.
Time (number[, format])
Timestamp
TimeStamp() da formato a una expresin como una fecha y un valor de hora, en el formato de tiempo
definido en las variables de sistema del script de carga de datos, o el sistema operativo, a menos que se
suministre una cadena de formato.
Timestamp (number[, format])

Vea tambin:
p

Funciones de interpretacin (pgina 542)

ApplyCodepage
ApplyCodepage() aplica un juego de caracteres de pgina de cdigo diferente al campo o texto indicado en
la expresin. El cdigo de pgina codepage debe ir en formato numrico.

Aunque ApplyCodepage se puede utilizar en las expresiones de grfico, se utiliza ms


habitualmente como una funcin de script en el editor de carga de datos. Por ejemplo, a
medida que carga archivos que podran haber sido guardados en diferentes juegos de
caracteres fuera de su control, puede aplicar la pgina de cdigo que representa el conjunto de
caracteres que necesite.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

514

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
ApplyCodepage(text, codepage)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

El campo o texto al que se desea aplicar una pgina de cdigos distinta, dado por el
codepage del argumento.

codepage

Nmero que representa la pgina de cdigos que se aplica al campo o la expresin dada
por el texto text.

Ejemplos y resultados:
Ejemplo

Resultado

LOAD
ApplyCodepage(ROWX,1253)
as GreekProduct,
ApplyCodepage (ROWY,
1255) as HebrewProduct,
ApplyCodepage (ROWZ,
65001) as EnglishProduct;
SQL SELECT ROWX, ROWY,
ROWZ From Products;

Cuando se carga desde SQL la fuente podra tener una combinacin de


distintos juegos de caracteres: cirlico, hebreo, etc. desde el formato UTF-8.
Estos tendran que cargarse fila por fila, aplicando una pgina de cdigos
diferente por cada fila.
El valor codepage 1253 representa el juego de caracteres de griego de
Windows, el valor 1255 representa el hebreo, y el valor 65001 representa al
latn estndar UTF-8.

Vea tambin: Juego de caracteres (pgina 97)

Date
Date() da formato a una expresin como una fecha utilizando el formato establecido en las variables de
sistema del script de carga de datos, o el sistema operativo, o una cadena de formato, si se suministra.
Sintaxis:
Date(number[, format])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

number

El nmero al que se ha de dar formato.

format

La cadena que describe el formato de la cadena resultante. Si no se suministra cadena de


formato alguna, se utiliza el formato de fecha definido en el sistema operativo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

515

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Los ejemplos a continuacin contienen estas dos configuraciones por defecto:
l

Configuracin de fecha 1: YY-MM-DD

Configuracin de fecha 2: M/D/YY

Ejemplo

Resultados

Configuracin 1

Configuracin 2

Date( A )

Cadena:

97-08-06

8/6/97

Nmero:

35648

35648

Cadena:

97.08.06

97.08.06

Nmero:

35648

35648

Cadena:

06.08.1997

06.08.1997

Nmero:

35648.375

35648.375

Cadena:

NULL (nada)

97.08.06

Nmero:

NULL

35648

donde A=35648
Date( A, 'YY.MM.DD' )

donde A=35648
Date( A, 'DD.MM.YYYY' )

donde A=35648.375
Date( A, 'YY.MM.DD' )

donde A=8/6/97

Dual
Dual() combina un nmero y una cadena de caracteres en un solo registro, de modo que la representacin
numrica del registro puede utilizarse para ordenar y hacer clculos, mientras que el valor de la cadena
puede utilizarse con fines de visualizacin.
Sintaxis:
Dual(text, number)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

El valor de cadena que se ha de utilizar junto con el argumento de nmero.

number

El nmero que se ha de utilizar junto con la cadena en el argumento de nmero.

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 de un campo tienen diferentes representaciones de cadena pero una
misma representacin numrica vlida, compartirn todos ellos la primera representacin de cadena de
caracteres que se encuentre.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

516

5 Funciones en scripts y en expresiones de grfico

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

Aada los ejemplos


siguientes a su script y
ejectelo.

El campo DayOfWeek puede utilizarse como una dimensin en una


visualizacin. Por ejemplo, en una tabla de semana los das se ordenan
automticamente segn su secuencia numrica correcta, y no por orden
alfabtico.

Load dual (
NameDay,NumDay ) as
DayOfWeek inline
[ NameDay,NumDay
Monday,0
Tuesday,1
Wednesday,2
Thursday,3
Friday,4
Saturday,5
Sunday,6 ];
Load Dual('Q' & Ceil
(Month(Now())/3), Ceil
(Month(Now())/3)) as
Quarter AutoGenerate
1;

Este ejemplo halla el trimestre actual. Se muestra como Q1 cuando la funcin


Now() se ejecuta en los tres primeros meses del ao, Q2 en los segundos tres

Dual('Q' & Ceil(Month


(Date)/3), Ceil(Month
(Date)/3)) as Quarter

Como en el ejemplo anterior, el campo Quarter se crea con los valores de texto
'Q1' a 'Q4', y se le asignan los valores numricos 1 a 4. Para utilizar esto en el
script, se deben cargar los valores de Date.

Dual(WeekYear(Date) &
'-W' & Week(Date),
WeekStart(Date)) as
YearWeek

Este ejemplo crear un campo YearWeek con valores de texto en el formato


'2012-W22' y al mismo tiempo asignar un valor numrico correspondiente al
nmero de fecha del primer da de la semana, por ejemplo: 41057. Para
utilizar esto en el script, se deben cargar los valores de Date.

meses, etc. No obstante, cuando se utiliza en la ordenacin, el campo Quarter


se comportar como su valor numrico: de 1 a 4.

Interval
Interval() da formato a un nmero como un intervalo de tiempo utilizando el formato establecido en las
variables de sistema del script de carga de datos, o el sistema operativo, o una cadena de formato, si se
suministra.
Podemos formatear los intervalos como una hora, das, o una combinacin de das, horas, minutos,
segundos y fracciones de segundo.

Sintaxis:
Interval(number[, format])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

517

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

number

El nmero al que se ha de dar formato.

format

Cadena que describe cmo ha de formatearse la cadena de intervalo resultante. Si se


omite, se utilizan el formato breve de fecha, el formato de hora y el separador decimal
establecidos en el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin contienen estas dos configuraciones por defecto:
l

Configuracin de formato de fecha 1: YY-MM-DD

Configuracin de formato de fecha 2: hh:mm:ss

Separador de nmeros decimales: ,

Ejemplo

Cadena

Nmero

Interval( A )

9:00:00

0,375

33:00:00

1,375

1 09:00

1,375

365 09:00

365,375

donde A=0,375
Interval( A )

donde A=1,375
Interval( A, 'D hh:mm' )

donde A=1,375
Interval( A-B, 'D hh:mm' )

donde A=97-08-06 09:00:00 y B=96-08-06 00:00:00

Money
Money() da formato numricamente a una expresin como un valor de moneda, en el formato establecido
en las variables de sistema del script de carga de datos, o en el sistema operativo, a menos que se
suministre una cadena de formato y, opcionalmente, unos separadores decimal y de miles.
Sintaxis:
Money(number[, format[, dec_sep[, thou_sep]]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

518

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

number

El nmero al que se ha de dar formato.

format

Cadena que describe cmo ha de formatearse la cadena de moneda resultante.

dec_sep

Cadena que especifica el separador numrico decimal.

thou_sep

Cadena que especifica el separador numrico de miles.

Si los argumentos 2-4 se omiten, se usa el formato de moneda establecido en el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin contienen estas dos configuraciones por defecto:
l

Configuracin de MoneyFormat 1: kr ##0,00, MoneyThousandSep' '

Configuracin de MoneyFormat 2: $#,##0.00, MoneyThousandSep','

Ejemplo

Resultados

Configuracin 1

Configuracin 2

Money( A )

Cadena:

kr 35 648,00

35.648,00 $

Nmero:

35648,00

35648,00

Cadena:

3,564,800

3,564,800

Nmero:

3564800

3564800

donde A=35648
Money( A, '#,##0 ', '.' , ',' )

donde A=3564800

Num
Num() da formato numricamente a una expresin en el formato de nmero establecido en las variables de
sistema del script de carga de datos, o en el sistema operativo, a menos que se suministre una cadena de
formato y, opcionalmente, unos separadores decimal y de miles.
Sintaxis:
Num(number[, format[, dec_sep [, thou_sep]]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

number

El nmero al que se ha de dar formato.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

519

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

format

Cadena que describe cmo ha de formatearse la cadena de fecha resultante. Si se omite,


se utilizar el formato de fecha establecido en el sistema operativo.

dec_sep

Cadena que especifica el separador numrico decimal. Si se omite, se utilizar el valor de


separador decimal de moneda establecido en el script de carga de datos.

thou_sep

Cadena que especifica el separador numrico de miles. Si se omite, se utilizar el valor de


separador de miles para moneda establecido en el script de carga de datos.

Ejemplos y resultados:
Los ejemplos a continuacin contienen estas dos configuraciones por defecto:
l

Configuracin de formato numrico 1: # ##0

Configuracin de formato numrico 2: #,##0

Ejemplo

Resultados

Num( A, '0.0' )

Cadena:

35 648 375

35648,375

Nmero:

35648375

35648,375

Cadena:

35.648,00

35.648,00

Nmero:

35648

35648

Cadena:

3,14

003

Nmero:

3,141592653

3,141592653

donde A=35648,375
Num( A, '#,##0.##', '.' , ',' )

donde A=35648
Num( pi( ), '0,00' )

Configuracin 1

Configuracin 2

Ejemplo

Resultado

Agregue este script de ejemplo a su app y ejectelo.

Field1

contiene los valores 1 y 9.

Despus construya una tabla simple con Field1 y Field2 como


dimensiones.

Field2

contiene los valores 3,14 y

8,2.

Sheet1:
let result= Num( pi( ), '0,00' );
Load * inline
[Field1; Field2
9; 8,2
1; $(result)
](delimiter is ';');

Time
Time() da formato a una expresin como un valor de hora, en el formato de tiempo definido en las variables
de sistema del script de carga de datos, o el sistema operativo, a menos que se suministre una cadena de
formato.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

520

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
Time(number[, format])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

number

El nmero al que se ha de dar formato.

format

Cadena que describe cmo ha de formatearse la cadena de hora resultante. Si se omite,


se utilizan el formato breve de fecha, el formato de hora y el separador decimal
establecidos en el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin contienen estas dos configuraciones por defecto:
l

Configuracin de formato de hora 1: hh:mm:ss

Configuracin de formato de hora 2: hh.mm.ss

Ejemplo

Resultados

Time( A )

Cadena:

9:00:00

09.00.00

Nmero:

0,375

0,375

Cadena:

9:00:00

09.00.00

Nmero:

35648,375

35648,375

Cadena:

23-59

23-59

Nmero:

0,99999

0,99999

donde A=0,375
Time( A )

donde A=35648,375
Time( A, 'hh-mm' )

donde A=0,99999

Configuracin 1

Configuracin 2

Timestamp
TimeStamp() da formato a una expresin como una fecha y un valor de hora, en el formato de tiempo
definido en las variables de sistema del script de carga de datos, o el sistema operativo, a menos que se
suministre una cadena de formato.
Sintaxis:
Timestamp(number[, format])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

521

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

number

El nmero al que se ha de dar formato.

format

Cadena que describe cmo ha de formatearse la cadena de fecha-hora resultante. Si se


omite, se utilizan el formato breve de fecha, el formato de hora y el separador decimal
establecidos en el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin contienen estas dos configuraciones por defecto:
l

Configuracin de formato de fecha-hora 1: YY-MM-DD hh:mm:ss

Configuracin de formato de fecha-hora 2: M/D/YY hh:mm:ss

Ejemplo

Resultados

Timestamp( A )

Cadena:

97-08-06 09:00:00

8/6/97 09:00:00

Nmero:

35648,375

35648,375

Cadena:

1997-08-06 00.00

1997-08-06 00.00

Nmero:

35648

35648

donde A=35648,375
Timestamp( A,'YYYY-MM-DD hh.mm')

donde A=35648

Configuracin 1

Configuracin 2

5.11 Funciones numricas generales


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.

Descripcin general de las funciones numricas generales


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.

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)
div
Div() devuelve la parte de entero de la divisin aritmtica del primer argumento por el segundo argumento.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

522

5 Funciones en scripts y en expresiones de grfico


Ambos parmetros se interpretan como nmeros reales, esto es, no tienen que ser enteros.

Div(integer_number1, integer_number2)
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)
frac
Frac() devuelve la parte fraccionaria de x.
Frac(x)
sign
Sign() devuelve 1, 0 o -1 dependiendo de si x es un nmero positivo, 0 o un nmero negativo.
Sign(x)

Funciones de combinacin y permutacin


combin
Combin() devuelve el nmero de combinaciones de elementos q que se pueden escoger de un grupo de p
elementos. Tal como representa la frmula Combin(p,q) = p! / q!(p-q)! el orden en que se seleccionan los
elementos es importante.
Combin(p, q)
permut
Permut() devuelve el nmero de permutaciones de elementos q que se pueden seleccionar de un grupo de p
elementos. Tal como representa la frmula Permut(p,q) = (p)! / (p - q)! el orden en que se seleccionan
los elementos es importante.
Permut(p, q)

Funciones de mdulo
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 se interpretan como nmeros reales, esto es, no tienen que ser enteros.
Fmod(a, b)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

523

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 de entero. El
primer argumento es el dividendo y el segundo argumento es el divisor. Ambos argumentos deben ser
valores enteros.
Mod(integer_number1, integer_number2)

Funciones de paridad
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)
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)

Funciones de redondeo
ceil
Ceil() redondea una cifra hacia arriba hasta el mltiplo ms cercano del intervalo step desplazado por el
nmero especificado en offset .

Ceil(x[, step[, offset]])


floor
Floor() redondea una cifra hacia abajo hasta el mltiplo ms cercano del intervalo step desplazado por el
nmero especificado en offset .

Floor(x[, step[, offset]])


round
Round() devuelve el resultado de redondear un nmero hacia arriba o hacia abajo hasta el mltiplo ms
cercano de step desplazado por el nmero especificado en offset .

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

524

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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 64 unos en binario, por lo que devuelve el valor 64

Ceil
Ceil() redondea una cifra hacia arriba hasta el mltiplo ms cercano del intervalo step desplazado por el
nmero especificado en offset .
Comprelo con la funcin floor, que redondea los nmeros introducidos hacia abajo.

Sintaxis:
Ceil(x[, step[, offset]])
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

Nmero introducido.

step

Incremento de intervalo. El valor por defecto es de 1.

offset

Define la base del intervalo de step. El valor por defecto es de 0.

Ejemplos y resultados:
Ejemplos

Resultados

Ceil(2.4 )

Devuelve 3
En este ejemplo, el tamao del intervalo step es 1 y la base del intervalo
step es 0.
Los intervalos son ...0 < x <=1, 1 < x <= 2, 2< x <=3, 3< x <=4...

Ceil(4.2 )

Devuelve 5

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

525

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Ceil(3.88 ,0.1)

Devuelve 3,9
En este ejemplo, el tamao del intervalo es 0,1 y la base del intervalo es 0.
Los intervalos son ... 3.7 < x <= 3.8, 3.8 < x <= 3.9, 3.9 < x <= 4.0...

Ceil(3.88 ,5)

Devuelve 5

Ceil(1.1 ,1)

Devuelve 2

Ceil(1.1 ,1,0.5)

Devuelve 1,5
En este ejemplo, el tamao del paso step es 1 y el desplazamiento offset
es 0,5. Esto significa que la base del intervalo de step es 0,5 y no 0.
Los intervalos son ... 0.5 < x <=1.5, 1.5 < x <= 2.5, 2.5< x <=3.5, 3.5< x
<=4.5...

Ceil(1.1 ,1,-0.01)

Devuelve 1,99
Los intervalos son ...-0.01< x <= 0.99, 0.99< x <= 1.99, 1.99 < x <=2.99...

Combin
Combin() devuelve el nmero de combinaciones de elementos q que se pueden escoger de un grupo de p
elementos. Tal como representa la frmula Combin(p,q) = p! / q!(p-q)! el orden en que se seleccionan los
elementos es importante.
Sintaxis:
Combin(p, q)
Tipo de datos que devuelve: 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


de lotera?

Devuelve
6.724.520

Combin( 35,7 )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

526

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 se interpretan como nmeros reales, esto es, no tienen que ser enteros.
Sintaxis:
Div(integer_number1, integer_number2)
Tipo de datos que devuelve: 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

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 que devuelve: Booleano
Ejemplos y resultados:
Ejemplos

Resultados

Even( 3 )

Devuelve 0, False

Even( 2 * 10 )

Devuelve -1, True

Even( 3.14 )

Devuelve NULL

Fabs
Fabs() devuelve el valor absoluto de x. El resultado es un nmero positivo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

527

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
fabs(x)
Tipo de datos que devuelve: 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 que devuelve: 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

Floor
Floor() redondea una cifra hacia abajo hasta el mltiplo ms cercano del intervalo step desplazado por el
nmero especificado en offset .
Comprelo con la funcin ceil, que redondea los nmeros introducidos al alza.

Sintaxis:
Floor(x[, step[, offset]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

528

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

Nmero introducido.

step

Incremento de intervalo. El valor por defecto es de 1.

offset

Define la base del intervalo de step. El valor por defecto es de 0.

Ejemplos y resultados:
Ejemplos

Resultados

Floor(2.4)

Devuelve 2
In this example, the size of the step is 1 and the base of the step interval is 0.
The intervals are ...0 <= x <1, 1 <= x < 2, 2<= x <3, 3<= x <4....

Floor(4.2)

Devuelve 4

Floor(3.88 ,0.1)

Devuelve 3,8
En este ejemplo, el tamao del intervalo es 0,1 y la base del intervalo es 0.
Los intervalos son ... 3.7 <= x < 3.8, 3.8 <= x < 3.9, 3.9 <= x < 4.0...

Floor(3.88 ,5)

Devuelve 0

Floor(1.1 ,1)

Devuelve 1

Floor(1.1 ,1,0.5)

Devuelve 0,5
En este ejemplo, el tamao del paso step es 1 y el desplazamiento offset es
0,5. Esto significa que la base del intervalo de step es 0,5 y no 0.
Los intervalos son ... 0.5 <= x <1.5, 1.5 <= x < 2.5, 2.5<= x <3.5,...

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 se interpretan como nmeros reales, esto es, no tienen que ser enteros.
Sintaxis:
fmod(a, b)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

529

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

Dividendo

Divisor

Ejemplos y resultados:
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

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 que devuelve: numrico
Argumentos:
Argumento

Descripcin

Nmero para el que se devuelve la fraccin.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

530

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplos

Resultados

Frac( 11.43 )

Devuelve 0,43

Frac( -1.4 )

Devuelve 0,6

Mod
Mod() es una funcin matemtica de mdulo que devuelve el resto no negativo de una divisin de entero. 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 que devuelve: 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

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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

531

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: Booleano
Ejemplos y resultados:
Ejemplos

Resultados

Odd( 3 )

Devuelve -1, True

Odd( 2 * 10 )

Devuelve 0, False

Odd( 3.14 )

Devuelve NULL

Permut
Permut() devuelve el nmero de permutaciones de elementos q que se pueden seleccionar de un grupo de p
elementos. Tal como representa 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 que devuelve: 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
de una final de 100 m con 8 participantes?

Devuelve
336

Permut( 8,3 )

Round
Round() devuelve el resultado de redondear un nmero hacia arriba o hacia abajo hasta el mltiplo ms
cercano de step desplazado por el nmero especificado en offset .
Si el nmero que se ha de redondear est exactamente en el medio de un intervalo, se redondea hacia
arriba.

Sintaxis:
Round(x[, step[, offset]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

532

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico

Si est redondeando un nmero de punto flotante puede que observe resultados errneos.
Estos errores de redondeo se deben a que los nmeros de punto flotante estn representados
por un nmero finito de dgitos binarios. Por lo tanto, los resultados se calculan usando un
nmero que ya est redondeado. Si estos errores de redondeo afectan a su trabajo, multiplique
los nmeros para convertirlos en enteros antes de redondear.

Argumentos:
Argumento

Descripcin

Nmero introducido.

step

Incremento de intervalo. El valor por defecto es de 1.

offset

Define la base del intervalo de step. El valor por defecto es de 0.

Ejemplos y resultados:
Ejemplos

Resultados

Round(3.8 )

Devuelve 4
En este ejemplo, el tamao del intervalo step es 1 y la base del intervalo step es 0.
Los intervalos son ...0 <= x <1, 1 <= x < 2, 2<= x <3, 3<= x <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.
En este ejemplo, el tamao del intervalo step es 4 y la base del intervalo step es 0.
Los intervalos son ... 0 <= x <4, 4 <= x <8, 8<= x <12...

Round(2,6 )

Devuelve 0. El valor se redondea a la baja porque 2 es menos de la mitad del intervalo de


paso de 6.
En este ejemplo, el tamao del intervalo step es 6 y la base del intervalo step es 0.
Los intervalos son ... 0 <= x <6, 6 <= x <12, 12<= x <18...

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

533

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Round(3.88
,0.1)

Devuelve 3,9
En este ejemplo, el tamao del intervalo step es 0,1 y la base del intervalo step es 0.
Los intervalos son ... 3.7 <= x <3.8, 3.8 <= x <3.9, 3.9 <= x < 4.0...

Round(3.88
,5)

Devuelve 5

Round(1.1
,1,0.5)

Devuelve 1,5
En este ejemplo, el tamao del intervalo step es 1 y la base del intervalo step es 0,5.
Los intervalos son ... 0.5 <= x <1.5, 1.5 <= x <2.5, 2.5<= x <3.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 que devuelve: 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

5.12 Funciones geoespaciales


Estas funciones se utilizan para manejar datos geoespaciales en visualizaciones de mapas.

Descripcin general de las funciones geoespaciales


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.
Hay dos categoras de funciones geoespaciales: las de agregacin y de no agregacin.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

534

5 Funciones en scripts y en expresiones de grfico


Las funciones de agregacin toman un conjunto geomtrico (puntos o reas) como entrada y devuelven una
geometra simple. Por ejemplo, se pueden fusionar mltiples reas y trazarse en el mapa una nica
demarcacin para la agregacin.
Las funciones de no agregacin toman una nica geometra y devuelven una geometra. Por ejemplo, para
la funcin GeoGetPolygonCenter(), si la geometra de demarcacin de un rea son los datos de entrada,
devuelve la geometra de puntos (longitud y latitud) del centro de dicha rea.
Las siguientes son funciones de agregacin:

GeoAggrGeometry
GeoAggrGeometry() se utiliza para agregar diversas reas en un rea mayor, por ejemplo agregando
diversas sub-regiones a una regin.
GeoAggrGeometry (field_name)
GeoBoundingBox
GeoBoundingBox() se utiliza para agregar una geometra a un rea y calcular el menor recuadro de
demarcacin geoespacial que contiene todas las coordenadas.
GeoBoundingBox (field_name)
GeoCountVertex
GeoCountVertex() se utiliza para hallar el nmero de vrtices que contiene una geometra de un polgono.
GeoCountVertex(field_name)
GeoInvProjectGeometry
GeoInvProjectGeometry() se utiliza para agregar una geometra a un rea y aplicar la inversa de una
proyeccin.
GeoInvProjectGeometry(type, field_name)
GeoProjectGeometry
GeoProjectGeometry() se utiliza para agregar una geometra a un rea y aplicar una proyeccin.
GeoProjectGeometry(type, field_name)
GeoReduceGeometry
GeoReduceGeometry() se usa para reducir el nmero de vrtices de una geometra, y para agregar un
nmero de reas en un rea, pero mostrando an las lneas lmite de las reas individuales.
GeoReduceGeometry (geometry)

Las siguientes son funciones de no agregacin:

GeoGetBoundingBox
GeoGetBoundingBox() se utiliza en scripts y expresiones de grfico para calcular el menor recuadro de

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

535

5 Funciones en scripts y en expresiones de grfico


demarcacin geoespacial que contiene todas las coordenadas de una geometra.

GeoGetBoundingBox (geometry)
GeoGetPolygonCenter
GeoGetPolygonCenter() se utiliza en scripts y expresiones de grfico para calcular y devolver el punto
central de una geometra.
GeoGetPolygonCenter (geometry)
GeoMakePoint
GeoMakePoint() se utiliza en scripts y expresiones de grfico para crear y etiquetar un punto con la latitud y
la longitud.
GeoMakePoint (lat_field_name, long_field_name)
GeoProject
GeoProject() se utiliza en scripts y expresiones de grfico para aplicar una proyeccin a una geometra.
GeoProject (type, field_name)

GeoAggrGeometry
GeoAggrGeometry() se utiliza para agregar diversas reas en un rea mayor, por ejemplo agregando
diversas sub-regiones a una regin.
Sintaxis:
GeoAggrGeometry(field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

Generalmente, GeoAggrGeometry() se utiliza para combinar datos de lmites geoespaciales. Por ejemplo,
podramos tener cdigos postales de reas de una ciudad e ingresos por ventas en cada una de dichas reas.
Si el territorio de un vendedor cubre varias reas de cdigos postales, podra ser til presentar el total de
ventas por territorio de ventas, en vez de reas individuales, y mostrar los resultados en una mapa codificado
por colores.
GeoAggrGeometry() puede calcular la agregacin de las geometras de barrios individuales y generar la
geometra del territorio fusionado en el modelo de datos. En ese caso, se ajustan despus los lmites del
territorio de ventas, y cuando los datos se recargan las nuevas demarcaciones y cifras de ingresos se reflejan
en el mapa.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

536

5 Funciones en scripts y en expresiones de grfico

Las lneas limtrofes de mapas creados usando GeoAggrGeometry() son las de las reas
fusionadas. Si desea mostrar las lneas limtrofes individuales de las reas pre-agregadas,
utilice GeoReduceGeometry().

GeoBoundingBox
GeoBoundingBox() se utiliza para agregar una geometra a un rea y calcular el menor recuadro de
demarcacin geoespacial que contiene todas las coordenadas.
Un valor GeoBoundingBox se representa como una lista de cuatro valores: izquierda, derecha, arriba y abajo.

Sintaxis:
GeoBoundingBox(field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

GeoBoundingBox() agrega un conjunto de geometras y devuelve cuatro coordenadas para el rectngulo


ms pequeo que contiene todas las coordenadas de dicha geometra agregada.
Para visualizar el resultado en un mapa, transfiera la cadena resultante de cuatro coordenadas a un formato
de polgono, etiquete el campo transferido con un formato geopoligonal, y arrastre y suelte ese campo en el
objeto de mapa. Los cuadros rectangulares se mostrarn a continuacin en la visualizacin de mapa.

GeoCountVertex
GeoCountVertex() se utiliza para hallar el nmero de vrtices que contiene una geometra de un polgono.
Sintaxis:
GeoCountVertex(field_name)
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

537

5 Funciones en scripts y en expresiones de grfico


GeoGetBoundingBox
GeoGetBoundingBox() se utiliza en scripts y expresiones de grfico para calcular el menor recuadro de
demarcacin geoespacial que contiene todas las coordenadas de una geometra.
Un cuadro de demarcacin geoespacial, creado mediante la funcin GeoBoundingBox(), se representa como
una lista de cuatro valores: izquierda, derecha, arriba y abajo.

Sintaxis:
GeoGetBoundingBox(field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

No utilice la clusula Group by en el editor de carga de datos con sta y otras funciones
geoespaciales de no agregacin, porque esto ocasionar un error de carga.

GeoGetPolygonCenter
GeoGetPolygonCenter() se utiliza en scripts y expresiones de grfico para calcular y devolver el punto
central de una geometra.
En algunos casos el requisito es trazar un punto en lugar de rellenar con color un rea de un mapa. Si los
datos geoespaciales existentes slo estn disponibles en forma de geometra de rea (por ejemplo, una
frontera), use GeoGetPolygonCenter() para recuperar un par de longitud y latitud para el centro del rea.

Sintaxis:
GeoGetPolygonCenter(field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

538

5 Funciones en scripts y en expresiones de grfico

No utilice la clusula Group by en el editor de carga de datos con sta y otras funciones
geoespaciales de no agregacin, porque esto ocasionar un error de carga.

GeoInvProjectGeometry
GeoInvProjectGeometry() se utiliza para agregar una geometra a un rea y aplicar la inversa de una
proyeccin.
Sintaxis:
GeoInvProjectGeometry(type, field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

type

Un tipo de proyeccin utilizado para transformar la geometra del mapa. Esto puede tomar
uno de dos valores: 'unidad', (opcin por defecto), que deriva en una proyeccin de 1:1, o
'mercator', que utiliza la proyeccin estndar Mercator.

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

Ejemplo:
Ejemplo

Resultado

En una sentencia Load:

La geometra cargada como AreaPolygon se transforma usando la

GeoInvProjectGeometry
('mercator',AreaPolygon)

transformacin inversa de la proyeccin Mercator y se almacena como


InvProjectGeometry para su uso en visualizaciones.

as InvProjectGeometry

GeoMakePoint
GeoMakePoint() se utiliza en scripts y expresiones de grfico para crear y etiquetar un punto con la latitud y
la longitud.
Sintaxis:
GeoMakePoint(lat_field_name, lon_field_name)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

539

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

lat_field_name

Un campo o expresin que se refiere a un campo que representa la latitud del punto.

long_field_
name

Un campo o expresin que se refieren a un campo que representa la longitud del


punto.

No utilice la clusula Group by en el editor de carga de datos con sta y otras funciones
geoespaciales de no agregacin, porque esto ocasionar un error de carga.

GeoProject
GeoProject() se utiliza en scripts y expresiones de grfico para aplicar una proyeccin a una geometra.
Sintaxis:
GeoProject(type, field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

type

Un tipo de proyeccin utilizado para transformar la geometra del mapa. Esto puede tomar
uno de dos valores: 'unidad', (opcin por defecto), que deriva en una proyeccin de 1:1, o
'mercator', que utiliza la proyeccin web estndar Mercator.

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

No utilice la clusula Group by en el editor de carga de datos con sta y otras funciones
geoespaciales de no agregacin, porque esto ocasionar un error de carga.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

540

5 Funciones en scripts y en expresiones de grfico


Ejemplo:
Ejemplo

Resultado

En una sentencia Load:

La proyeccin Mercator se aplica a la geometra cargada como Area, y el

GeoProject
('mercator',Area) as

resultado se almacena como GetProject.

GetProject

GeoProjectGeometry
GeoProjectGeometry() se utiliza para agregar una geometra a un rea y aplicar una proyeccin.
Sintaxis:
GeoProjectGeometry(type, field_name)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

type

Un tipo de proyeccin utilizado para transformar la geometra del mapa. Esto puede tomar
uno de dos valores: 'unidad', (opcin por defecto), que deriva en una proyeccin de 1:1, o
'mercator', que utiliza la proyeccin web estndar Mercator.

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

Ejemplo:
Ejemplo

Resultado

En una sentencia Load:

La geometra cargada como AreaPolygon se transforma usando la

GeoProjectGeometry
('mercator',AreaPolygon) as

proyeccin Mercator y se almacena como ProjectGeometry para su uso

ProjectGeometry

en visualizaciones.

GeoReduceGeometry
GeoReduceGeometry() se usa para reducir el nmero de vrtices de una geometra, y para agregar un
nmero de reas en un rea, pero mostrando an las lneas lmite de las reas individuales.
Sintaxis:
GeoReduceGeometry(field_name[, value])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

541

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

field_name

Un campo o una expresin que se refieren a unc ampo que contiene la geometra que se
ha de representar. Esto podra ser bien un punto (o conjunto de puntos) dndonos la
longitud y la latitud, o un rea.

value

La cantidad de reduccin que se ha de aplicar a la geometra. El rango va de 0 a 1, donde


0 representa ninguna reduccin y 1 representa la reduccin mxima de vrtices.

Usando un valor value de 0,9 o superior con un conjunto de datos complejo


puede reducir el nmero de vrtices a un nivel en el que la representacin
visual no es precisa.

GeoReduceGeometry() tambin realiza una funcin similar a la de GeoAggrGeometry() en el sentido de que


agrega un nmero de reas a un rea. La diferencia est en que las lneas limtrofes individuales de los datos
de la preagregacin se muestran en el mapa si utilizamos GeoReduceGeometry().

5.13 Funciones de interpretacin


Las funciones de interpretacin evalan los contenidos de los distintos campos de texto o expresiones de
entrada e imponen un formato especfico de datos al valor numrico resultante. Con estas funciones
podemos especificar el formato del nmero de acuerdo con el tipo de dato, incluyendo atributos tales como:
separador decimal, separador de miles y formato de fecha.
Las funciones de interpretacin devuelven todas ellas un valor dual con ambos valores, el de cadena y
nmerico, pero puede pensarse en ellas como que realizan una conversin de cadena a nmero. Las
funciones toman el valor de texto de la expresin de entrada y generan un nmero que representa a la
cadena.
Por el contrario, las funciones de formato toman expresiones numricas y devuelven cadenas, especificando
el formato del texto resultante.
Si no se utilizan funciones de interpretacin, Qlik Sense interpreta los datos como una mezcla de nmeros,
fechas, horas, fecha-hora y cadenas de caracteres, empleando las configuraciones por defecto para el
formato numrico, formato de fecha y formato de hora definidos por las variables de script y por el sistema
operativo.
Todas las funciones de interpretacin pueden utilizarse tanto en scripts de carga de datos como en
expresiones de grficos.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

542

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 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#
Date# devuelve una expresin como una fecha en el formato especificado en el segundo argumento, si se
proporciona.Si el cdigo de formato se omite, se usa la fecha por defecto del sistema operativo.
Date# (pgina 544)(text[, format])
Interval#
Interval#() devuelve una expresin de texto como un intervalo de tiempo en el formato establecido por
defecto en el sistema operativo, o en el formato especificado en el segundo argumento, si se suministra.
Interval# (pgina 544)(text[, format])
Money#
Money#() convierte una cadena de texto en un valor de moneda, en el formato definido en el script de carga
o el sistema operativo, a menos que se suministre una cadena de formato. Los smbolos de separador
decimal o de miles personalizados son parmetros opcionales.
Money# (pgina 545)(text[, format[, dec_sep[, thou_sep ] ] ])
Num#
Num#() convierte una cadena de texto en un valor numrico, en el formato numrico establecido en el script
de carga de datos o el sistema operativo. Los smbolos de separador decimal o de miles personalizados son
parmetros opcionales.
Num# (pgina 546)(text[ , format[, dec_sep[ , thou_sep]]])
Text
Text() obliga a tratar como texto la expresin, incluso si es posible una interpretacin numrica.
Text (expr)
Time#
Time#() devuelve una expresin como un valor de hora, en el formato de tiempo definido en el script de
carga de datos o el sistema operativo, a menos que se suministre una cadena de formato..
Time# (pgina 548)(text[, format])
Timestamp#
Timestamp#() devuelve una expresin como un valor de fecha y hora, en el formato de tiempo definido en el

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

543

5 Funciones en scripts y en expresiones de grfico


script de carga de datos o el sistema operativo, a menos que se suministre una cadena de formato.

Timestamp# (pgina 548)(text[, format])

Vea tambin:
p

Funciones de formato (pgina 513)

Date#
Date# devuelve una expresin como una fecha en el formato especificado en el segundo argumento, si se
proporciona.
Sintaxis:
Date#(text[, format])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

La cadena de texto que se ha de evaluar.

format

Cadena que describe cmo ha de formatearse la cadena de fecha resultante. Si se omite,


se utiliza el formato de fecha definido en las variables de sistema del script de carga de
datos, o se utiliza el sistema operativo.

Ejemplos y resultados:
El ejemplo siguiente utiliza el formato de fecha M/D/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior del script de carga de datos.

Ejemplo

Resultados

Agregue este script de ejemplo a su


app y ejectelo.

Si crea una tabla con StringDatey Date como dimensiones, los

Load *,
Num(Date#(StringDate)) as Date;
LOAD * INLINE [
StringDate
8/7/97
8/6/1997

resultados son los siguientes:


StringDate

Date

8/7/97

35649

8/6/1997

35648

Interval#
Interval#() devuelve una expresin de texto como un intervalo de tiempo en el formato establecido por
defecto en el sistema operativo, o en el formato especificado en el segundo argumento, si se suministra.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

544

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
Interval#(text[, format])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

La cadena de texto que se ha de evaluar.

format

Cadena que describe el formato de entrada esperado para utilizarlo en la conversin de la


cadena a un intervalo numrico.
Si se omite, se utilizan el formato breve de fecha, el formato de hora y el separador
decimal establecidos en el sistema operativo.

La funcin interval# convierte un intervalo de tiempo expresado como texto en un equivalente numrico.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
l

Formato de fecha corto: YY-MM-DD

Formato de hora: M/D/YY

Separador de nmeros decimales: ,

Ejemplo

Resultado

Interval#( A, 'D hh:mm' )

1,375

donde A='1 09:00'

Money#
Money#() convierte una cadena de texto en un valor de moneda, en el formato definido en el script de carga
o el sistema operativo, a menos que se suministre una cadena de formato. Los smbolos de separador
decimal o de miles personalizados son parmetros opcionales.
Sintaxis:
Money#(text[, format[, dec_sep [, thou_sep ] ] ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

545

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

La cadena de texto que se ha de evaluar.

format

Cadena que describe el formato de entrada esperado para utilizarlo en la conversin de la


cadena a un intervalo numrico.
Si se omite, se utilizar el formato de moneda establecido en el sistema operativo.

dec_sep

Cadena que especifica el separador numrico decimal. Si se omite, se utilizar el valor de


separador decimal de moneda establecido en el script de carga de datos.

thou_sep

Cadena que especifica el separador numrico de miles. Si se omite, se utilizar el valor de


separador de miles para moneda establecido en el script de carga de datos.

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:
l

Configuracin predefinida de formato de moneda 1: kr # ##0,00

Configuracin predefinida de formato de moneda 2: $#,##0.00

Ejemplo

Resultados

Configuracin 1

Configuracin 2

Money#(A , '# ##0,00 kr' )

Cadena:

35 648.37 kr

35 648.37 kr

Nmero:

35648,37

3564837

Cadena:

35.648,37 $

35.648,37 $

Nmero:

35648,37

35648,37

donde A=35 648,37 kr


Money#( A, ' $#', '.', ',' )

donde A= $35,648.37

Num#
Num#() convierte una cadena de texto en un valor numrico, en el formato numrico establecido en el script
de carga de datos o el sistema operativo. Los smbolos de separador decimal o de miles personalizados son
parmetros opcionales.
Sintaxis:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

546

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

La cadena de texto que se ha de evaluar.

format

Cadena que describe cmo ha de formatearse la cadena de fecha resultante. Si se omite,


se utilizar el formato numrico establecido en el sistema operativo.

dec_sep

Cadena que especifica el separador numrico decimal. Si se omite, se utilizar el valor de


separador decimal de moneda establecido en el script de carga de datos.

thou_sep

Cadena que especifica el separador numrico de miles. Si se omite, se utilizar el valor de


separador de miles para moneda establecido en el script de carga de datos.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
l

Configuracin predefinida de formato de nmero 1: # ##0

Configuracin predefinida de formato de nmero 2: #,##0

Ejemplo

Resultados

Configuracin 1

Configuracin 2

Num#( A, '#.#', '.' , ',')

Cadena:

35.648,375

35.648,375

Nmero:

35648,375

35648,375

donde A=35.648,375

Text
Text() obliga a tratar como texto la expresin, incluso si es posible una interpretacin numrica.
Sintaxis:
Text (expr)
Tipo de datos que devuelve: dual
Ejemplos y resultados:
Ejemplo

Resultado

Text( A )

Cadena:

1234

Nmero:

Cadena:

3,1415926535898

Nmero:

donde A=1234
Text( pi( ) )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

547

5 Funciones en scripts y en expresiones de grfico


Time#
Time#() devuelve una expresin como un valor de hora, en el formato de tiempo definido en el script de
carga de datos o el sistema operativo, a menos que se suministre una cadena de formato..
Sintaxis:
time#(text[, format])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

La cadena de texto que se ha de evaluar.

format

Cadena que describe cmo ha de formatearse la cadena de hora resultante. Si se omite,


se utilizan el formato breve de fecha, el formato de hora y el separador decimal
establecidos en el sistema operativo.

Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
l

Configuracin predefinida de formato de hora 1: hh:mm:ss

Configuracin predefinida de formato de hora 2: hh.mm.ss

Ejemplo

Resultados

Configuracin 1

Configuracin 2

time#( A )

Cadena:

9:00:00

9:00:00

Nmero:

0,375

Cadena:

09.00

09.00

Nmero:

0,375

0,375

donde A=09:00:00
time#( A, 'hh.mm' )

donde A=09,00

Timestamp#
Timestamp#() devuelve una expresin como un valor de fecha y hora, en el formato de tiempo definido en el
script de carga de datos o el sistema operativo, a menos que se suministre una cadena de formato.
Sintaxis:
timestamp#(text[, format])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

548

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

text

La cadena de texto que se ha de evaluar.

format

Cadena que describe cmo ha de formatearse la cadena de fecha-hora resultante. Si se


omite, se utilizan el formato breve de fecha, el formato de hora y el separador decimal
establecidos en el sistema operativo. ISO 8601 se admite para fechas-hora.

Ejemplos y resultados:
El ejemplo siguiente utiliza el formato de fecha M/D/YYYY. El formato de fecha se especifica en la
sentencia SET DateFormat en la parte superior del script de carga de datos.

Ejemplo

Resultados

Agregue este script de ejemplo a su


app y ejectelo.

Si crea una tabla con String y TS como dimensiones, los


resultados son los siguientes:

Load *,
Timestamp(Timestamp#(String)) as
TS;
LOAD * INLINE [
String
2015-09-15T12:13:14
1952-10-16T13:14:00+0200
1109-03-01T14:15
];

String

TS

2015-09-15T12:13:14

9/15/2015 12:13:14 PM

1952-10-16T13:14:00+0200

10/16/1952 11:14:00 AM

1109-03-01T14:15

3/1/1109 2:15:00 PM

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.
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 utilizando funciones grficas de Inter-Registro 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

549

5 Funciones en scripts y en expresiones de grfico


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 encima de la fila actual en el equivalente de tabla simple del grfico.

Above - funcin de grfico([TOTAL [<fld{,fld}>]] expr [ , offset [,count]])


Below
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 efecta 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])

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,

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

550

5 Funciones en scripts y en expresiones de grfico


descartando las dimensiones. Por ejemplo, Column(2) devuelve el valor de la segunda columna de la
medida.

Column - funcin de grfico(ColumnNo)


Dimensionality
Dimensionality() devuelve el nmero de dimensiones para la fila actual. En el caso de las tablas pivotantes,
la funcin devuelve el nmero total de columnas de dimensin que no tienen un contenido agregado, es
decir, que no contienen sumas parciales o contenidos adicionales contrados.
Dimensionality - funcin de grfico ( )
Secondarydimensionality
SecondaryDimensionality() devuelve el nmero de filas de tabla pivotante de las dimensiones que no
tienen contenido agregado, es decir, que no contienen sumas parciales o contenidos agregados contrados.
Esta funcin es equivalente a la funcin dimensionality() para dimensiones horizontales de tablas
pivotantes.
SecondaryDimensionality - 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 integer que encuentra el nmero de valores distintos en un campo.
FieldValueCount(field_name)

Funciones de la tabla pivotante


Estas funciones slo pueden emplearse en expresiones de grficos.

After
After() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal y
como aparecen en la columna tras la columna actual dentro de un segmento de fila en la tabla pivotante.
After - funcin de grfico([TOTAL] expression [ , offset [,n]])
Before
Before() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

551

5 Funciones en scripts y en expresiones de grfico


y como aparecen en la columna antes de la columna actual dentro de un segmento de fila en la tabla
pivotante.

Before - funcin de grfico([TOTAL] expression [ , offset [,n]])


First
First() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal y
como aparecen stos en la primera columna del segmento de fila actual en la tabla pivotante. Esta funcin
devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.
First - funcin de grfico([TOTAL] expression [ , offset [,n]])
Last
Last() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal y
como aparecen stos en la ltima columna del segmento de fila actual en la tabla pivotante. Esta funcin
devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.
Last - funcin de grfico([TOTAL] expression [ , offset [,n]])
ColumnNo
ColumnNo() devuelve el nmero de la columna actual dentro del segmento de fila actual en una tabla
pivotante. La primera columna es la nmero 1.
ColumnNo - funcin de grfico([TOTAL])
NoOfColumns
NoOfColumns() devuelve el nmero de columnas del segmento de fila actual en una tabla pivotante.
NoOfColumns - funcin de grfico([TOTAL])

Funciones inter-registro en el script de carga de datos


Exists
Exists() determina si un valor de campo especfico ya se ha cargado en el campo en el script de carga de
datos. La funcin devuelve TRUEo FALSE, por lo que se puede usar en la clusula where de una sentencia

LOADo una sentenciaIF.


Exists (field [ , expression ]
LookUp
Lookup() mira en una tabla ya cargada y devuelve el valor de field_name correspondiente a la primera
aparicin del valor match_field_value en el campo match_field_name. La tabla puede ser la actual u otra
cargada anteriormente.

LookUp (fieldname, matchfieldname, matchfieldvalue [, tablename])


Peek
Peek() encuentra el valor de un campo de una tabla para una fila que ya se ha cargado o que existe en la
memoria interna. El nmero de fila se puede especificar, as como la tabla.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

552

5 Funciones en scripts y en expresiones de grfico


Peek (fieldname [ , row [ , tablename ] ]
Previous
Previous() halla el valor de la expresin expr usando datos del registro de entrada que no se han descartado
por una clusula where. En el primer registro de una tabla interna, la funcin devolver NULL.

Previous (expression )

Vea tambin:
p

Funciones de rango (pgina 598)

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 encima de la fila actual en el equivalente de tabla simple del grfico.

Sintaxis:
Above([TOTAL] expr [ , offset [,count]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.

offset

Especificar un offset n mayor que 0 nos permite mover la evaluacin de la expresin n filas
ms arriba de la fila actual.
Especificar un offset de 0 evaluar la expresin en la fila actual.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin Above sea
equivalente a una funcin Below con el correspondiente nmero de offset positivo.

count

Al especificar un tercer argumento 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 598)

TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

553

5 Funciones en scripts y en expresiones de grfico


En la primera fila de un segmento de columna se devuelve un valor NULL, dado que no hay ninguna fila por
encima de 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.

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 campos 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 a modo de 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) para 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).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

554

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 otros tipos de grficos, convierta el grfico a la tabla simple equivalente para que pueda
interpretar fcilmente con qu fila est relacionada la funcin.

Ejemplo 2:
En los pantallazos de la tablas mostradas en este ejemplo, se han aadido ms dimensiones a las
visualizaciones Month and 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

555

5 Funciones en scripts y en expresiones de grfico


Ejemplo 3:
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 moviendo 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 slo hay dos productos, AA y

BB, solo hay un resultado que no sea null en cada serie. En la fila BB, para el mes Jan, el valor de Above
(Sum(Sales)) es 46. En la fila AA, el valor es Null. El valor de cada fila AA siempre ser null para cualquier
mes, puesto que no hay ningn Product por encima de AA. La segunda serie se evala conforme a AA y

BB para el mes Feb para el valor de Customer, Astrida. Cuando se hayan acabado todos los meses para
el valor Astrida, la secuencia se repetir con el segundo valor Customer, Betacab y as sucesivamente.

Visualizacin de la tabla para el ejemplo 3.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

556

5 Funciones en scripts y en expresiones de grfico

Ejemplo 4:

Resultado

La funcin Above puede utilizarse como


entrada para las funciones de rango. Por
ejemplo: RangeAvg (Above(Sum(Sales),1,3)).

En los argumentos de la funcin Above(), offset se


establece en 1 y count se establece en 3. La funcin
busca los resultados de la expresin Sum(Sales) en las
tres filas inmediatamente encima de la fila actual del
segmento de columna (donde hay una fila). Estos tres
valores se utilizan como entrada para la funcin
RangeAvg(), que buscar la media de los valores en el
rango de nmeros proporcionado.
Una tabla con el valor Customer como dimensin
ofrecer los resultados siguientes para la expresin
RangeAvg().
Astrida

Betacab

587

Canutility

563

Divadip:

603

Datos utilizados 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 Sorting del
panel de propiedades, seleccione Month y active la casilla Sort by expression. En el cuadro de expresin,
escriba Monthnumber.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

557

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p
p
p
p

Below - funcin de grfico (pgina 558)


Bottom - funcin de grfico (pgina 561)
Top - funcin de grfico (pgina 581)
RangeAvg (pgina 601)

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] expr [ , offset [,count ]])
Tipo de datos que devuelve: 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.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin Below sea
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 598)

TOTAL

Si la tabla es unidimensional o si se utiliza 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

558

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 campos interno.

Limitaciones:
Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:
Ejemplo 1:

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 Betacab muestra el resultado de
la adicin de los valores de Sum(Sales) para las filas Astrida + Astrida (539+587). El resultado de la fila

Canutility muestra el resultado de la adicin de los valores de Sum(Sales) a Betacab + Betacab


(539+683).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

559

5 Funciones en scripts y en expresiones de grfico


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.
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 otros 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 ms detalles.

Ejemplo 2:

Resultado

La funcin Below puede utilizarse como entrada

En los argumentos de la funcin Below(), offset se

para las funciones de rango. Por ejemplo: RangeAvg


(Below(Sum(Sales),1,3)).

establece en 1 y count se establece en 3. La


funcin busca los resultados de la expresin Sum

(Sales) en las tres filas inmediatamente debajo de


la fila actual del segmento de columna (donde hay
una fila). Estos tres valores se utilizan como
entrada para la funcin RangeAvg(), que buscar la
media de los valores en el rango de nmeros
proporcionado.
Una tabla con el valor Customer como dimensin
ofrecer los resultados siguientes para la expresin
RangeAvg().
Astrida

659,67

Betacab

720

Canutility

757

Divadip:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

560

5 Funciones en scripts y en expresiones de grfico


Datos utilizados 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 Sorting del
panel de propiedades, seleccione Month y active la casilla Sort by expression. En el cuadro de expresin,
escriba Monthnumber.

Vea tambin:
p
p
p
p

Above - funcin de grfico (pgina 553)


Bottom - funcin de grfico (pgina 561)
Top - funcin de grfico (pgina 581)
RangeAvg (pgina 601)

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 ]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

561

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: 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.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin Bottom
sea 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 ms de 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 598)

TOTAL

Si la tabla es unidimensional o si se utiliza 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 campos interno.

Limitaciones:
Las llamadas recursivas devolvern NULL.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

562

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo: 1

Visualizacin de la tabla para el ejemplo 1.

En el pantallazo de la tabla mostrada a modo de 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.
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 and 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.)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

563

5 Funciones en scripts y en expresiones de grfico

Primera tabla para el ejemplo 2. El valor de Bottom para la medida End value basado en Month (Dec).

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 ms detalles.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

564

5 Funciones en scripts y en expresiones de grfico

Ejemplo: 3

Resultado

La funcin Bottom puede utilizarse como entrada

En los argumentos de la funcin Bottom(), offset

para las funciones de rango. Por ejemplo: RangeAvg


(Bottom(Sum(Sales),1,3)).

se establece en 1 y count se establece en 3. La


funcin busca los resultados de la expresin Sum

(Sales) en las tres filas que comienzan con la fila


inmediatamente encima de la fila inferior del
segmento de columna (debido al valor offset=1) y
en las dos filas encima (donde hay una fila). Estos
tres valores se utilizan como entrada para la funcin
RangeAvg(), que buscar la media de los valores
en el rango de nmeros proporcionado.
Una tabla con el valor Customer como dimensin
ofrecer los resultados siguientes para la expresin
RangeAvg().
Astrida

659,67

Betacab

659,67

Canutility

659,67

Divadip:

659,67

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 Sorting del
panel de propiedades, seleccione Month y active la casilla Sort by expression. En el cuadro de expresin,
escriba Monthnumber.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

565

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Top - funcin de grfico (pgina 581)

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 que devuelve: 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

Customer

Product

UnitPrice

UnitSales

Order Value

Total Sales Value

% Sales

AA

15

10

150

505

29.70

AA

16

64

505

12.67

BB

81

505

16.04

BB

10

50

505

9.90

CC

20

40

505

7.92

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

566

5 Funciones en scripts y en expresiones de grfico


Customer

Product

UnitPrice

UnitSales

Order Value

Total Sales Value

% Sales

DD

25

505

0.00

AA

15

120

505

23.76

CC

19

505

0.00

Ejemplo: Porcentaje de ventas para el cliente seleccionado

Customer

Product

UnitPrice

UnitSales

Order Value

Total Sales Value

% Sales

AA

15

10

150

295

50.85

AA

16

64

295

21.69

BB

81

295

27.46

Ejemplos

Resultados

Order Value se aade a la tabla como


una medida con la expresin: Sum
(UnitPrice*UnitSales).

El resultado de Column(1) se toma de la columna Order Value,


porque esta es la primera columna de la medida.

Total Sales Value se aade como una


medida con la expresin: Sum(TOTAL
UnitPrice*UnitSales)

El resultado de Column(2) se toma de la columna Total Sales


Value, porque esta es la segunda columna de la medida.
Vea los resultados en la columna % Sales en el ejemplo
Porcentaje de ventas totales (pgina 566).

% 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 567).


Datos utilizados 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 '|');

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

567

5 Funciones en scripts y en expresiones de grfico


Dimensionality - funcin de grfico
Dimensionality() devuelve el nmero de dimensiones para la fila actual. En el caso de las tablas pivotantes,
la funcin devuelve el nmero total de columnas de dimensin que no tienen un contenido agregado, es
decir, que no contienen sumas parciales o contenidos adicionales contrados.
Sintaxis:
Dimensionality ( )
Tipo de datos que devuelve: 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. Para todo tipo de grficos, excepto la tabla pivotante, devolver el nmero de
dimensiones de todas las filas excepto el total, que ser 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
Exists() determina si un valor de campo especfico ya se ha cargado en el campo en el script de carga de
datos. La funcin devuelve TRUEo FALSE, por lo que se puede usar en la clusula where de una sentencia

LOADo una sentenciaIF.


Sintaxis:
Exists(field_name [, expr])
Tipo de datos que devuelve: Booleano
Argumentos:
Argumento

Descripcin

field_name

Es un nombre o una expresin de texto que evala un nombre de campo que debe
buscarse. El campo deber figurar entre los datos cargados hasta entonces por el script.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

568

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

expr

Es una expresin que evala el valor del campo para buscar en el campo especificado en
field-name. Si se omite, se asume el valor del registro actual en el campo especificado.

Ejemplos y resultados:
Ejemplo

Resultado

Exists (Employee)

Devuelve -1 (True) si el valor del campo Employee en el


registro actual ya existe en cualquier registro previamente
ledo que contenga ese campo.

Exists(Employee, 'Bill')

Devuelve -1 (True) si se encuentra el valor 'Bill' en el


contenido actual del campo Employee.
Las sentencias Exists (Employee, Employee) y Exists
(Employee) son equivalentes.

Employees:
LOAD * inline [
Employee|ID|Salary
Bill|001|20000
John|002|30000
Steve|003|35000
] (delimiter is '|');
Citizens:
Load * inline [
Name|Address
Bill|New York
Mary|London
Steve|Chicago
Lucy|Paris
John|Miami
] (delimiter is '|');
EmployeeAddresses:
Load Name as Employee, Address Resident
Citizens where Exists (Employee, Name);

Esto da como resultado una tabla denominada


EmployeeAddresses en el modelo de datos, que puede
mostrarse como una visualizacin de tabla utilizando las
dimensiones Employee y Address.
La clusula where: where Exists (Employee, Name)
significa que en la tabla nueva slo se cargan los nombres
de la tabla Citizens que tambin estn en Employees. La
sentencia Drop elimina las tablas temporales Employees y
Citizens para evitar confusiones.
Employee

Address

Bill

New York

John

Miami

Steve

Chicago

Drop Tables Employees, Citizens;

Reemplazando la sentencia en los datos de


muestra del ejemplo anterior que crea la
tabla EmployeeAddresses por lo siguiente,
utilizando where not Exists.
NonEmployee:
Load Name as Employee, Address Resident
Citizens where not Exists (Employee,
Name);

La clusula where incluye not: where not Exists


(Employee, Name) significa que en la tabla nueva slo se
cargan los nombres de la tabla Citizens que no estn en
Employees.
Employee

Address

Mary

London

Lucy

Paris

Datos utilizados en el ejemplo:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

569

5 Funciones en scripts y en expresiones de grfico


Employees:
LOAD * inline [
Employee|ID|Salary
Bill|001|20000
John|002|30000
Steve|003|35000
] (delimiter is '|');
Citizens:
Load * inline [
Name|Address
Bill|New York
Mary|London
Steve|Chicago
Lucy|Paris
John|Miami
] (delimiter is '|');
EmployeeAddresses:
Load Name as Employee, Address Resident Citizens where Exists (Employee, Name);
Drop Tables Employees, Citizens;

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 que devuelve: Entero
Argumentos:
Argumento

Descripcin

field_name

Nombre del campo para el que se requiere el ndice. Por ejemplo, la columna de una tabla.
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:
Los ejemplos siguientes utilizan el campo: First name de la tabla Names.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

570

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Aada los datos del ejemplo a su app


y ejectelo.

La tabla Names se carga como en los datos de muestra:

Funcin de grfico: En una tabla que


contenga la dimensin First name,
aada como medida:
FieldIndex ('First name','John')

porque 'John' aparece primero en el orden de carga del campo


First name. Obsrvese que en un panel de filtrado John
aparecera como el nmero 2 empezando desde arriba puesto
que est ordenado alfabticamente y no en el orden de carga.

FieldIndex ('First name','Peter')

porque FieldIndex() devuelve slo un valor, que es el primero


que aparece segn el orden de carga.

Funcin de script: Dada la tabla


Names cargada, los datos son
similares a los que se muestran en el
ejemplo:
John1:
Load FieldIndex('First
name','John') as MyJohnPos
Resident Names;

MyJohnPos=1,

Peter1:
Load FieldIndex('First
name','Peter') as MyPeterPos
Resident Names;

MyPeterPos=4,

porque 'John' aparece primero en el orden de carga


del campo First name. Obsrvese que en un panel de filtrado

John aparecera como el nmero 2 empezando desde arriba


puesto que est ordenado alfabticamente y no en el orden de
carga.
porque FieldIndex() devuelve slo un valor, que es

el primero que aparece segn el orden de carga.

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
John1:
Load FieldIndex('First name','John') as MyJohnPos
Resident Names;
Peter1:
Load FieldIndex('First name','Peter') as MyPeterPos
Resident Names;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

571

5 Funciones en scripts y en expresiones de grfico


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 que devuelve: dual
Argumentos:
Argumento

Descripcin

field_name

Nombre del campo para el que se requiere el valor. Por ejemplo, la columna de una tabla.
Debe especificarse como valor de cadena. Esto implica que el nombre del campo debe
escribirse entre comillas simples.

elem_no

La posicin o el nmero de posicin del campo (elemento), siguiendo el orden de carga,


para la que se devuelve el valor. Esto podra corresponder a la fila de una tabla, pero
depende del orden en que los elementos (las filas) se carguen.

Limitaciones:
Si elem_no es mayor que el nmero de valores de campo, devuelve NULL.

Ejemplos y resultados:
Los ejemplos siguientes utilizan el campo: First name de la tabla Names.

Ejemplos

Resultados

Aada los datos del ejemplo a su


app y ejectelo.

La tabla Names se carga como en los datos de muestra:

Funcin de grfico: En una tabla que


contenga la dimensin First name,
aada como medida:
FieldValue('First name','1')

John, puesto que John aparece primero en el orden de carga del


campo First name. Obsrvese que en un panel de filtrado John
aparecera como el nmero 2 empezando desde arriba, despus
de Jane, puesto que est ordenado alfabticamente y no en el
orden de carga.

FieldValue('First name','7')

NULL, puesto que hay solo 6 valores en el campo First name.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

572

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Funcin de script: Dada la tabla


Names cargada, los datos son
similares a los que se muestran en el
ejemplo:
John1:
Load FieldValue('First name',1) as
MyPos1
Resident Names;

MyPos1=John,

Peter1:
Load FieldValue('First name',7) as
MyPos2
Resident Names;

MyPo2s= - (Null),

ya que 'John' aparece primero en el orden de carga


del campo First name.

puesto que hay solo 6 valores en el campo First

name.

Datos utilizados en el ejemplo:


Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
John1:
Load FieldValue('First name',1) as MyPos1
Resident Names;
Peter1:
Load FieldValue('First name',7) as MyPos2
Resident Names;

FieldValueCount
FieldValueCount() es una funcin integer que encuentra el nmero de valores distintos en un campo.
Sintaxis:
FieldValueCount(field_name)
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

field_name

Nombre del campo para el que se requiere el valor. Por ejemplo, la columna de una
tabla.Debe especificarse como valor de cadena. Esto implica que el nombre del campo
debe escribirse entre comillas simples.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

573

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Los ejemplos siguientes utilizan el campo: First name de la tabla Names.

Ejemplos

Resultados

Aada los datos del ejemplo a su app y ejectelo.

La tabla Names se carga como en


los datos de muestra:

Funcin de grfico: En una tabla que contenga la dimensin First


name, aada como medida:
FieldValueCount('First name')

5 puesto que Peter aparece dos


veces.

FieldValueCount('Initials')

6 puesto que Initials slo tiene


valores distintos.

Funcin de script; Dada la tabla Names cargada, los datos son


similares a los que se muestran en el ejemplo:
John1:
Load FieldValueCount('First name') as MyFieldCount1
Resident Names;

MyFieldCount1=5 puesto que 'John'

John1:
Load FieldValueCount('Initials') as MyInitialsCount1
Resident Names;

MyFieldCount1=6 puesto que 'Initials'

aparece dos veces.

solo tiene valores distintos.

Datos utilizados en el ejemplo:


Datos utilizados en los ejemplos:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
FieldCount1:
Load FieldValueCount('First name') as MyFieldCount1
Resident Names;
FieldCount2:
Load FieldValueCount('Initials') as MyInitialsCount1
Resident Names;

LookUp
Lookup() mira en una tabla ya cargada y devuelve el valor de field_name correspondiente a la primera
aparicin del valor match_field_value en el campo match_field_name. La tabla puede ser la actual u otra
cargada anteriormente.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

574

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
lookup(field_name, match_field_name, match_field_value [, table_name])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

nombre_
campo

Nombre del campo para el que se requiere el valor devuelto.El valor de entrada debe
suministrarse como una cadena (por ejemplo, literales entrecomillados).

match_
field_name

Nombre del campo en el que buscar match_field_value. El valor de entrada debe

match_
field_value

Valor que debe buscarse en el campomatch_field_name.

table_name

Nombre de la tabla en la que buscar el valor. El valor de entrada debe suministrarse como
una cadena (por ejemplo, literales entrecomillados).

suministrarse como una cadena (por ejemplo, literales entrecomillados).

Si table_name se omite, se da por sentado que se trata de la tabla actual.

Los argumentos sin comillas se refieren a la tabla actual. Para referirse a otras tablas, encierre
un argumento entre comillas simples.

Limitaciones:
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 est bien definido. Tanto field_name como

match_field_name deben ser campos de una misma tabla, la cual viene especificada mediante table_
name.
Si no se encuentra ninguna correspondencia, se devuelve NULL.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

575

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

Los datos de muestra utilizan la funcin


Lookup() de la siguiente manera:

En primer lugar se carga la tabla ProductList.


La funcin Lookup() se utiliza para crear la tabla

Lookup('Category', 'ProductID',
ProductID, 'ProductList')

OrderData. Especifica el tercer argumento como

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.

en el segundo argumento 'ProductID' en ProductList, tal

ProductList:
Load * Inline [
ProductID|Product|Category|Price
1|AA|1|1
2|BB|1|3
3|CC|2|8
4|DD|3|2
] (delimiter is '|');

La sentencia drop elimina la tabla ProductList del modelo

OrderData:
Load *, Lookup('Category', 'ProductID',
ProductID, 'ProductList') as CategoryID
Inline [
InvoiceID|CustomerID|ProductID|Units
1|Astrida|1|8
1|Astrida|2|6
2|Betacab|3|10
3|Divadip|3|5
4|Divadip|4|10
] (delimiter is '|');

ProductID. Es el campo para el que debe buscarse el valor


como indica el entrecomillado simple utilizado.
La funcin devuelve el valor de Category (en la tabla

ProductList), que se carga como CategoryID.

de datos porque no es necesaria y la tabla OrderData


queda con el resultado siguiente:
ProductID

InvoiceID

CustomerID

Units

CategoryID

Astrida

Astrida

Betacab

10

Divadip

Divadip

10

Drop Table ProductList

La funcin Lookup() es flexible y permite acceder a cualquier tabla previamente cargada. Sin
embargo, es lenta comparada con la funcin Applymap().

Vea tambin:
p

ApplyMap (pgina 592)

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

576

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 campos interno.

Sintaxis:
NoOfRows([TOTAL])
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Ejemplo:
if( RowNo( )= NoOfRows( ), 0, Above( sum( Sales )))

Vea tambin:
p

RowNo - funcin de grfico (pgina 374)

Peek
Peek() encuentra el valor de un campo de una tabla para una fila que ya se ha cargado o que existe en la
memoria interna. El nmero de fila se puede especificar, as como la tabla.
Sintaxis:
Peek(field_name[, row_no[, table_name ] ])
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

nombre_
campo

Nombre del campo para el que se requiere el valor devuelto.El valor de entrada debe
suministrarse como una cadena (por ejemplo, literales entrecomillados).

row_no

La fila de la tabla que especifica el campo requerido. Puede ser una expresin, pero debe
resolverse en 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

577

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

table_name

Una etiqueta de tabla que no finaliza en dos puntos. Si no se establece table_name, 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 table_name.

Limitaciones:
En el primer registro de una tabla interna, la funcin devolver NULL.

Ejemplos y resultados:
Ejemplo

Resultado

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.

EmpCode = 101, porque Peek(EmployeeCode,0)


devuelve el primer valor de EmployeeCode en la tabla
EmployeeDates.

EmployeeDates:
Load * Inline [
EmployeeCode|StartDate|EndDate
101|02/11/2010|23/06/2012
102|01/11/2011|30/11/2013
103|02/01/2012|
104|02/01/2012|31/03/2012
105|01/04/2012|31/01/2013
106|02/11/2013|
] (delimiter is '|');
FirstEmployee:
Load EmployeeCode, Peek(EmployeeCode,0) As
EmpCode
Resident EmployeeDates;

FirstEmployee:
Load EmployeeCode, Peek(EmployeeCode,2,'EmployeeDates') As EmpCode
Resident EmployeeDates;

Al sustituir el valor del argumento row_no, devuelve


los valores de otras filas de la tabla, del siguiente
modo:
Peek(EmployeeCode,2) devuelve el tercer valor de la

tabla: 102.
No obstante, tenga en cuenta que sin especificar la
tabla como tercer argumento table_no, la funcin hace
referencia a la tabla actual (en este caso, interna). El
resultado de Peek(EmployeeCode,-2) son varios
valores:
EmployeeCode
101
102
103
104
105
106

EmpCode
101
102
103
104

Al especificar el argumento table_no como


'EmployeeDates',

la funcin devuelve el valor del segundo


al ltimo de EmployeeCode en la tabla EmployeeDates:
105.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

578

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

La funcin Peek() puede utilizarse para

Cree una tabla en una hoja en su app con ID, List y

referenciar datos que an no se han cargado.

Value como las dimensiones.

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.

ID

List

Value

6,3

6,3,4

T1:
LOAD * inline [
ID|Value
1|3
1|4
1|6
3|7
3|8
2|1
2|11
5|2
5|78
5|13
] (delimiter is '|');
T2:
LOAD
*,
IF(ID=Peek(ID), Peek(List)&','&Value,Value)
AS List
RESIDENT T1
ORDER BY ID ASC;
DROP TABLE T1;

11

11

11,10

10

11,10,1

8,7

13

13

13,2

13,2,78

78

La sentencia IF() se crea desde una tabla temporal


T1.
Peek(ID) remite al campo ID en la fila previa de la

tabla actual T2.


Peek(List) remite al campo List en la fila previa de la
tabla T2, actualmente construida al tiempo que se
evala la expresin.
La sentencia se evala de la siguiente forma:
si el valor actual de ID es el mismo que el valor
anterior de ID, escriba el valor de Peek(List)
concatenado con el valor actual de Value. En caso
contrario, escriba el valor actual de Value solamente.
Si Peek(List) ya contiene un resultado concatenado,
el nuevo resultado de Peek(List) se concatenar a
este.

Observe la clusula Order by.


Especifica cmo se ordena la tabla (por
ID, en orden ascendente). Sin esto, la
funcin Peek() usar cualquier criterio
de ordenacin arbitrario de la tabla
interna, lo que puede producir
resultados impredecibles.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

579

5 Funciones en scripts y en expresiones de grfico


Previous
Previous() halla el valor de la expresin expr usando datos del registro de entrada que no se han descartado
por una clusula where. En el primer registro de una tabla interna, la funcin devolver NULL.

Sintaxis:
Previous(expr)
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

expr

La expresin o el campo que contiene los datos que se han de medir.


La expresin puede contener funcione previous() anidadas para acceder a los registros
ms adelante. 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.

Limitaciones:
En el primer registro de una tabla interna, la funcin devolver 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

580

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Sales2013:
Load *, (Sales - Previous(Sales) )as Increase Inline [
Month|Sales
1|12
2|13
3|15
4|17
5|21
6|21
7|22
8|23
9|32
10|35
11|40
12|41
] (delimiter is '|');

Al usar la funcin Previous() en la


sentencia Load, podemos comparar
el valor actual de Sales con el valor
precedente, y usarlo en un tercer
campo, Increase.
Month
1
2
3
4
5
6
7
8
9
10
11
12

Sales
12
13
15
17
21
21
22
23
32
35
40
41

Increase
1
2
2
4
0
1
1
9
3
5
1

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 efecta 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 que devuelve: 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

581

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

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 598)

TOTAL

Si la tabla es unidimensional o si se utiliza 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 campos interno.

Limitaciones:
Las llamadas recursivas devolvern NULL.

Ejemplos y resultados:
Ejemplo: 1

En el pantallazo de la tabla mostrada a modo de 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

582

5 Funciones en scripts y en expresiones de grfico


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
En los pantallazos de la tablas mostradas en este ejemplo, se han aadido ms dimensiones a las
visualizaciones Month and 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).

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

583

5 Funciones en scripts y en expresiones de grfico

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 ms detalles.

Ejemplo: 3

Resultado

La funcin Top puede utilizarse como entrada para

En los argumentos de la funcin Top(), offset se

las funciones de rango. Por ejemplo: RangeAvg (Top


(Sum(Sales),1,3)).

establece en 1 y count se establece en 3. La


funcin busca los resultados de la expresin Sum

(Sales) en las tres filas que comienzan con la fila


inmediatamente debajo de la fila inferior del
segmento de columna (debido al valor offset=1) y
en las dos filas debajo (donde hay una fila). Estos
tres valores se utilizan como entrada para la funcin
RangeAvg(), que buscar la media de los valores
en el rango de nmeros proporcionado.
Una tabla con el valor Customer como dimensin
ofrecer los resultados siguientes para la expresin
RangeAvg().
Astrida

603

Betacab

603

Canutility

603

Divadip:

603

Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

584

5 Funciones en scripts y en expresiones de grfico


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 Sorting del
panel de propiedades, seleccione Month y active la casilla Sort by expression. En el cuadro de expresin,
escriba Monthnumber.

Vea tambin:
p
p
p
p
p

Bottom - funcin de grfico (pgina 561)


Above - funcin de grfico (pgina 553)
Sum - funcin de grfico (pgina 185)
RangeAvg (pgina 601)
Funciones de rango (pgina 598)

SecondaryDimensionality - funcin de grfico


SecondaryDimensionality() devuelve el nmero de filas de tabla pivotante de las dimensiones que no
tienen contenido agregado, es decir, que no contienen sumas parciales o contenidos agregados contrados.
Esta funcin es equivalente a la funcin dimensionality() para dimensiones horizontales de tablas
pivotantes.
Sintaxis:
SecondaryDimensionality( )
Tipo de datos que devuelve: Entero
Limitaciones:
A menos que se utilice en tablas pivotantes, la funcin SecondaryDimensionality siempre devuelve 0.

After - funcin de grfico


After() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal y
como aparecen en la columna tras la columna actual dentro de un segmento de fila en la tabla pivotante.
Sintaxis:
after([ total ] expr [ , offset [,n ]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

585

5 Funciones en scripts y en expresiones de grfico

Esta funcin devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.

Argumentos:
Argumento

Descripcin

expression

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 ms


a la derecha de la fila actual.
Especificar un offset de 0 evaluar la expresin en la fila actual.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin After sea
equivalente a una funcin Before con el correspondiente nmero de offset positivo.

Al especificar un tercer parmetro n mayor que 1, la funcin devolver un rango de valores

n, uno por cada n filas de tabla contando hacia la derecha desde la celda original.
TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

En la ltima columna de un segmento de fila devolver un valor NULL, puesto que no hay una columna tras
sta.
Si la tabla pivotante tiene mltiples dimensiones horizontales, el segmento de fila actual incluir slo
columnas con los mismos valores que la columna actual en todas las filas de dimensin excepto la fila que
muestra la ltima dimensin horizontal del orden de campo. El criterio de ordenacin entre campos para
dimensiones horizontales en tablas pivotantes viene definido simplemente por el orden de las dimensiones
de arriba a abajo..

Ejemplo:
after( sum( Sales ))
after( sum( Sales ), 2 )
after( total sum( Sales ))
rangeavg (after(sum(x),1,3)) devuelve una media de los tres resultados de la funcin sum(x) evaluada en

las tres columnas inmediatamente a la derecha de la columna actual.

Before - funcin de grfico


Before() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal
y como aparecen en la columna antes de la columna actual dentro de un segmento de fila en la tabla
pivotante.
Sintaxis:
before([ total ] expr [ , offset [,n ]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

586

5 Funciones en scripts y en expresiones de grfico

Esta funcin devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.

Argumentos:
Argumento

Descripcin

expression

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 a la


izquierda de la fila actual.
Especificar un offset de 0 evaluar la expresin en la fila actual.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin Before sea
equivalente a una funcin After con el correspondiente nmero de offset positivo.

Al especificar un tercer parmetro n mayor que 1, la funcin devolver un rango de n


valores, uno por cada n filas de tabla contando hacia la izquierda desde la celda original.

TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

En la primera columna de un segmento de fila devolver un valor NULL, puesto que no hay una columna
antes de sta.
Si la tabla pivotante tiene mltiples dimensiones horizontales, el segmento de fila actual incluir slo
columnas con los mismos valores que la columna actual en todas las filas de dimensin excepto la fila que
muestra la ltima dimensin horizontal del orden de campo.El criterio de ordenacin entre campos para
dimensiones horizontales en tablas pivotantes viene definido simplemente por el orden de las dimensiones
de arriba a abajo..

Ejemplos:
before( sum( Sales ))
before( sum( Sales ), 2 )
before( total sum( Sales ))
rangeavg (before(sum(x),1,3)) devuelve una media de los tres resultados de la funcin sum(x) evaluada en

las tres columnas inmediatamente a la izquierda de la columna actual.

First - funcin de grfico


First() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal y
como aparecen stos en la primera columna del segmento de fila actual en la tabla pivotante. Esta funcin
devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.
Sintaxis:
first([ total ] expr [ , offset [,n ]])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

587

5 Funciones en scripts y en expresiones de grfico


Argumentos:
Argumento

Descripcin

expression

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 ms


a la derecha de la fila actual.
Especificar un offset de 0 evaluar la expresin en la fila actual.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin First sea
equivalente a una funcin Last con el correspondiente nmero de offset positivo.

Al especificar un tercer parmetro n mayor que 1, la funcin devolver un rango de valores

n, uno por cada n filas de tabla contando hacia la derecha desde la celda original.
TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Si la tabla pivotante tiene mltiples dimensiones horizontales, el segmento de fila actual incluir slo
columnas con los mismos valores que la columna actual en todas las filas de dimensin excepto la fila que
muestra la ltima dimensin horizontal del orden de campo.El criterio de ordenacin entre campos para
dimensiones horizontales en tablas pivotantes viene definido simplemente por el orden de las dimensiones
de arriba a abajo..

Ejemplos:
first( sum( Sales ))
first( sum( Sales ), 2 )
first( total sum( Sales )

rangeavg (first(sum(x),1,5)) devuelve una media de los resultados de la funcin sum(x)


evaluada en las cinco columnas ms a la izquierda del segmento de fila actual.

Last - funcin de grfico


Last() devuelve el valor de una expresin evaluada con los valores de dimensin de una tabla pivotante tal y
como aparecen stos en la ltima columna del segmento de fila actual en la tabla pivotante. Esta funcin
devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.
Sintaxis:
last([ total ] expr [ , offset [,n ]])
Argumentos:
Argumento

Descripcin

expression

La expresin o el campo que contiene los datos que se han de medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

588

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

offset

Al especificar un offset n mayor que 1, se mueve la evaluacin de la expresin n filas a la


izquierda de la fila actual.
Especificar un offset de 0 evaluar la expresin en la fila actual.
Especificar un nmero de offset (desplazamiento) negativo har que la funcin First sea
equivalente a una funcin Last con el correspondiente nmero de offset positivo.

Al especificar un tercer parmetro n mayor que 1, la funcin devolver un rango de n


valores, uno por cada n filas de tabla contando hacia la izquierda desde la celda original.

TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Si la tabla pivotante tiene mltiples dimensiones horizontales, el segmento de fila actual incluir slo
columnas con los mismos valores que la columna actual en todas las filas de dimensin excepto la fila que
muestra la ltima dimensin horizontal del orden de campo.El criterio de ordenacin entre campos para
dimensiones horizontales en tablas pivotantes viene definido simplemente por el orden de las dimensiones
de arriba a abajo..

Ejemplo:
last( sum( Sales ))
last( sum( Sales ), 2 )
last( total sum( Sales )
rangeavg (last(sum(x),1,5)) devuelve una media de los resultados de la funcin sum(x) evaluada en las

cinco columnas ms a la derecha del segmento de fila actual.

ColumnNo - funcin de grfico


ColumnNo() devuelve el nmero de la columna actual dentro del segmento de fila actual en una tabla
pivotante. La primera columna es la nmero 1.
Sintaxis:
ColumnNo([total])
Argumentos:
Argumento

Descripcin

TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Si la tabla pivotante tiene mltiples dimensiones horizontales, el segmento de fila actual incluir slo
columnas con los mismos valores que la columna actual en todas las filas de dimensin excepto la fila que

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

589

5 Funciones en scripts y en expresiones de grfico


muestra la ltima dimensin horizontal del orden de campo.El criterio de ordenacin entre campos para
dimensiones horizontales en tablas pivotantes viene definido simplemente por el orden de las dimensiones
de arriba a abajo..

Ejemplo:
if( ColumnNo( )=1, 0, sum( Sales ) / before( sum( Sales )))

NoOfColumns - funcin de grfico


NoOfColumns() devuelve el nmero de columnas del segmento de fila actual en una tabla pivotante.
Sintaxis:
NoOfColumns([total])
Argumentos:
Argumento

Descripcin

TOTAL

Si la tabla es unidimensional o si se utiliza el cualificador TOTAL como argumento, el


segmento de columna actual es siempre igual a la columna entera.

Si la tabla pivotante tiene mltiples dimensiones horizontales, el segmento de fila actual incluir slo
columnas con los mismos valores que la columna actual en todas las filas de dimensin excepto en la fila que
muestra la ltima dimensin en el orden de campo.El criterio de ordenacin entre campos para dimensiones
horizontales en tablas pivotantes viene definido simplemente por el orden de las dimensiones de arriba a
abajo..

Ejemplo:
if( ColumnNo( )=NoOfColumns( ), 0, after( sum( Sales )))

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).

IsText( expr )

Ambos IsNum y IsText devuelven 0 si la expresin es NULL.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

590

5 Funciones en scripts y en expresiones de grfico


Ejemplo:
El ejemplo a continuacin carga una tabla inline con valores de texto y valores numricos, y aade dos
campos para verificar si el valor es un valor numrico o de texto.
Load *, IsNum(Value), IsText(Value)
Inline [
Value
23
Green
Blue
12
33Red];

La tabla resultante tiene el siguiente aspecto:

Value

IsNum(Value)

IsText(Value)

23

-1

Green

-1

Blue

-1

12

-1

33Red

-1

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
La funcin de script ApplyMap sirve para enlazar (o mapear) el resultado de una expresin con una tabla de
correspondencia previamente cargada.

ApplyMap ('mapname', expr [ , defaultexpr ] )


MapSubstring
La funcin de script MapSubstring sirve para hacer corresponder (mapear) partes de cualquier expresin
con una tabla de correspondencias previamente cargada. La correspondencia (o mapeado) es sensible a

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

591

5 Funciones en scripts y en expresiones de grfico


maysculas y no repetitivo y las subcadenas se asocian de izquierda a derecha.

MapSubstring ('mapname', expr)

ApplyMap
La funcin de script ApplyMap sirve para enlazar (o mapear) el resultado de una expresin con una tabla de
correspondencia previamente cargada.

Sintaxis:
ApplyMap('map_name', expression [ , default_mapping ] )
Tipo de datos que devuelve: dual
Argumentos:
Argumento

Descripcin

map_name

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.

expression

La expresin, el resultado de lo que debe mapearse o enlazarse.

default_
mapping

Si se indica, este valor se utilizar como valor por defecto cuando la tabla de
correspondencia no contenga ningn valor coincidente para expression. Si no se indica, el
valor de expression se devolver tal cual es.

Ejemplo:
En este ejemplo, se ha cargado una lista de comerciales con un cdigo de pas que representa su pas de
residencia. Se utiliza una tabla que hace corresponder un cdigo de pas con un pas para reemplazar el
cdigo de pas por el nombre del pas. En la tabla de correspondencia solo se definen tres pases, los otros
cdigos de pas se hacen corresponder con 'Rest of the world'.
// Load mapping table of country codes:
map1:
mapping LOAD *
Inline [
CCode, Country
Sw, Sweden
Dk, Denmark
No, Norway
] ;
// Load list of salesmen, mapping country code to country
// If the country code is not in the mapping table, put Rest of the world
Salespersons:
LOAD *,
ApplyMap('map1', CCode,'Rest of the world') As Country
Inline [
CCode, Salesperson
Sw, John
Sw, Mary

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

592

5 Funciones en scripts y en expresiones de grfico


Sw, Per
Dk, Preben
Dk, Olle
No, Ole
Sf, Risttu] ;
// We don't need the CCode anymore
Drop Field 'CCode';

La tabla resultante tiene el siguiente aspecto:

Salesperson

Country

John

Sweden

Mary

Sweden

Per

Sweden

Preben

Denmark

Olle

Denmark

Ole

Norway

Risttu

Rest of the world

MapSubstring
La funcin de script MapSubstring sirve para hacer corresponder (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 asocian de izquierda a derecha.

Sintaxis:
MapSubstring('map_name', expression)

Tipo de datos que devuelve: cadena


Argumentos:
Argumento

Descripcin

map_name

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.

expression

La expresin cuyo resultado debe ser enlazado por las subcadenas.

Ejemplo:
En este ejemplo cargamos una lista de modelos de producto. Cada modelo tiene un conjunto de atributos
que se describen mediante un cdigo compuesto. Si utilizamos la tabla de correspondencia con la funcin
MapSubstring, podemos expandir los cdigos de atributo en una descripcin.
map2:
mapping LOAD *

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

593

5 Funciones en scripts y en expresiones de grfico


Inline [
AttCode, Attribute
R, Red
Y, Yellow
B, Blue
C, Cotton
P, Polyester
S, Small
M, Medium
L, Large
] ;
Productmodels:
LOAD *,
MapSubString('map2', AttCode) as Description
Inline [
Model, AttCode
Twixie, R C S
Boomer, B P L
Raven, Y P M
Seedling, R C L
SeedlingPlus, R C L with hood
Younger, B C with patch
MultiStripe, R Y B C S/M/L
] ;
// We don't need the AttCode anymore
Drop Field 'AttCode';

La tabla resultante tiene el siguiente aspecto:

Model

Description

Twixie

Red Cotton Small

Boomer

Blue Polyester Large

Raven

Yellow Polyester Medium

Seedling

Red Cotton Large

SeedlingPlus

Red Cotton Large with hood

Younger

Blue Cotton with patch

MultiStripe

Red Yellow Blue Cotton Small/Medium/Large

5.17 Funciones matemticas


En esta seccin se describen funciones para constantes matemticas y valores 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

594

5 Funciones en scripts y en expresiones de grfico


e
Esta funcin devuelve la base de los logaritmos naturales, e (2,71828...).

e( )
false
La funcin devuelve un valor dual con valor de texto 'False' y valor numrico 0, el cual puede usarse como un
falso lgico en las expresiones.

false( )
pi
La funcin devuelve el valor de (3.14159...).

pi( )
rand
La funcin devuelve un nmero aleatorio entre 0 y 1. Puede servir para crear datos de muestra.

rand( )
Ejemplo:
Este script a modo de ejemplo crea una tabla de 1000 registros con caracteres en mayscula seleccionados
de manera aleatoria, es decir, caracteres en el rango de 65 a 91 (65+26).
Load
Chr( Floor(rand() * 26) + 65) as UCaseChar,
RecNo() as ID
Autogenerate 1000;

true
La funcin devuelve un valor dual con valor de texto 'True' y valor numrico -1, el cual puede usarse como un
verdadero lgico en las expresiones.

true( )

5.18

Funciones NULL

En esta seccin se describen funciones para devolver o detectar valores NULL.


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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

595

5 Funciones en scripts y en expresiones de grfico


Null
La funcin Null devuelve un valor NULL.

NULL( )
IsNull
La funcin IsNull comprueba si el valor de una expresin es NULL y, si lo es, devuelve -1 (True); si no lo es,
devuelve 0 (False).

IsNull (expr )

IsNull
La funcin IsNull comprueba si el valor de una expresin es NULL y, si lo es, devuelve -1 (True); si no lo es,
devuelve 0 (False).

Sintaxis:
IsNull(expr )
Una cadena de longitud cero no se considera un valor NULL y har que IsNull devuelva False.

Ejemplo: Script de carga de datos


En este ejemplo, se carga una tabla inline con cuatro filas, en la que las tres primeras lneas no contienen
nada, - o 'NULL', en la columna Value. Convertimos estos valores en verdaderas representaciones de valor
NULL con el LOAD precedente del medio mediante la funcin Null.
El primer LOAD precedente aade un campo que verifica si el valor es NULL, con ayuda de la funcin

IsNull.
NullsDetectedAndConverted:
LOAD *,
If(IsNull(ValueNullConv), 'T', 'F') as IsItNull;
LOAD *,
If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value ) as ValueNullConv;
LOAD * Inline
[ID, Value
0,
1,NULL
2,3,Value];

Esta es la tabla resultante. En la columna ValueNullConv, los valores NULL se representan con -.

ID

Value

ValueNullConv

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

IsItNull

596

5 Funciones en scripts y en expresiones de grfico


0

NULL

Value

Value

NULL
La funcin Null devuelve un valor NULL.

Sintaxis:
Null( )
Ejemplo: Script de carga de datos
En este ejemplo, se carga una tabla inline con cuatro filas, en la que las tres primeras lneas no contienen
nada, - o 'NULL', en la columna Value. Queremos convertir estos valores a representaciones valores de
NULL.
El LOAD precedente del centro realiza la conversin usando la funcin Null.
El primer LOAD precedente aade una comprobacin de campo si el valor es NULL, solo para fines
ilustrativos en este ejemplo.
NullsDetectedAndConverted:
LOAD *,
If(IsNull(ValueNullConv), 'T', 'F') as IsItNull;
LOAD *,
If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value ) as ValueNullConv;
LOAD * Inline
[ID, Value
0,
1,NULL
2,3,Value];

Esta es la tabla resultante. En la columna ValueNullConv, los valores NULL se representan con -.

ID

Value

ValueNullConv

IsItNull

NULL

Value

Value

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

597

5 Funciones en scripts y en expresiones de grfico

5.19 Funciones de rango


Las funciones de rango son funciones que toman un conjunto de valores y producen un nico valor como
resultado. Todas las funciones de rango pueden utilizarse tanto en el script de carga de datos como en las
expresiones de grficos.
Por ejemplo, en una visualizacin, una funcin de rango puede calcular un valor nico a partir de un conjunto
entre registros. En el script de carga de datos, una funcin de rango puede calcular un nico valor a partir de
un conjunto de valores en una tabla interna.

Las funciones de rango reemplazan a las siguientes funciones generales numricas:


numsum,numavg, numcount,nummin y nummax, las cuales deben considerarse
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
RangeMin() 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 devuelve un nico valor. Si este no es
el caso entonces devuelve NULL.

RangeOnly(first_expr[, Expression])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

598

5 Funciones en scripts y en expresiones de grfico


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, tanto de texto como numricos en una expresin o campo.
RangeCount(first_expr[, Expression])
RangeMissingCount
RangeMissingCount() devuelve 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 la media, o 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])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

599

5 Funciones en scripts y en expresiones de grfico


RangeFractile
RangeFractile() devuelve el valor que corresponde al ensimo fractile (cuantil) de un rango de nmeros.
RangeFractile(fractile, first_expr[ ,Expression])
RangeKurtosis
RangeKurtosis() devuelve el valor que corresponde a la kurtosis de un rango de nmeros.
RangeKurtosis(first_expr[, Expression])
RangeSkew
RangeSkew() devuelve el valor que corresponde a la asimetra de un rango de nmeros.
RangeSkew(first_expr[, Expression])
RangeStdev
RangeStdev() halla la desviacin estndar de un rango de nmeros.
RangeStdev(expr1[, Expression])

Funciones de rango financieras


RangeIRR
RangeIRR() devuelve la tasa de rendimiento interno de una serie de flujos de caja representados por los
valores introducidos.
RangeIRR (value[, value][, Expression])
RangeNPV
RangeNPV() devuelve el valor actual neto de una inversin basada en un tipo de descuento y una serie de
pagos peridicos futuros (valores negativos) e ingresos (valores positivos). El resultado tiene un formato
numrico predeterminado en money.
RangeNPV (discount_rate, value[, value][, Expression])
RangeXIRR
RangeXIRR() devuelve la tasa de rendimiento interno 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.
RangeXIRR (values, dates[, Expression])
RangeXNPV
RangeXNPV() devuelve el valor actual neto de una planificacin de flujos de caja que no tienen que ser
necesariamente peridicos. 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.
RangeXNPV (discount_rate, values, dates[, Expression])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

600

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Funciones inter-registro (pgina 549)

RangeAvg
RangeAvg() devuelve la media, o 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 que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

601

5 Funciones en scripts y en expresiones de grfico


Ejemplos

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.

La tabla resultante
muestra los valores
devueltos de
MyRangeAvg para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD recno() as RangeID, RangeAvg(Field1,Field2,Field3) as MyRangeAvg
INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangeAvg

12.666

6.333

Ejemplo con expresin:


RangeAvg (Above(MyField),0,3))

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. Especificando el tercer argumento como 3, la funcin
Above() devuelve tres valores, en los que hay suficientes filas por encima, las cuales se toman como entrada
para la funcin RangeAvg().
Datos utilizados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField

RangeAvg (Above
(MyField,0,3))

10

10

Como sta es la fila superior, el rango consiste en un valor


solamente.

Slo hay una fila por encima de esta fila, as que el rango es:
10,2.

6,6666666667

El equivalente a RangeAvg(10,2,8)

18

9,333333333

10. 333333333

10,6666666667

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

602

5 Funciones en scripts y en expresiones de grfico


RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;

Vea tambin:
p
p

Avg - funcin de grfico (pgina 221)


Count - funcin de grfico (pgina 189)

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_value , y_value[, Expression])
Tipo de datos que devuelve: numrico
La serie de datos debe introducirse 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, yvalue

Cada valor representa un valor nico o un rango de valores devueltos por una funcin interregistro con un tercer parmetro opcional. 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, valores nulos y valores perdidos devuelven NULL.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

603

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplos

Resultados

RangeCorrel (2,3,6,8,9,4,8,5)

Devuelve 0,2492. Esta funcin puede cargarse en el script o


aadirse a una visualizacin en el editor de expresiones.

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.

En una tabla con ID1 como dimensin y la medida:


RangeCorrel(x1,y1,x2,y2,x3,y3,x4,y4,x5,y5,x6,y6)), la
funcin RangeCorrel() halla el valor de Correl sobre el

RangeList:
Load * Inline [
ID1|x1|y1|x2|y2|x3|y3|x4|y4|x5|y5|x6|y6
01|46|60|70|13|78|20|45|65|78|12|78|22
02|65|56|22|79|12|56|45|24|32|78|55|15
03|77|68|34|91|24|68|57|36|44|90|67|27
04|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|');

rango de seis pares x,y, para cada uno de los valores ID1.
ID1

MyRangeCorrel

01

-0.9517

02

-0.5209

03

-0.5209

04

-0.1599

XY:
LOAD recno() as RangeID, * Inline [
X|Y
2|3
6|8
9|4
8|5
](delimiter is '|');
XY:
LOAD recno() as RangeID, * Inline [
X|Y
2|3
6|8
9|4
8|5
](delimiter is '|');

En una tabla con RangeID como dimensin y la medida:


RangeCorrel(Below(X,0,4,BelowY,0,4)), la funcin
RangeCorrel() utiliza los resultados de las funciones Below

(), las cuales, debido al tercer argumento (count) fijado en 4,


producen un rango de cuatro valores x-y desde la tabla
cargada XY.
RangeID

MyRangeCorrel2

01

0.2492

02

-0.9959

03

-1.0000

04

El valor de RangeID 01 es el mismo que introducir


manualmente RangeCorrel(2,3,6,8,9,4,8,5). Para los otros
valores de RangeID, las series producidas por la funcin son
Below(): (6,8,9,4,8,5), (9,4,8,5) y (8,5), la ltima de las
cuales produce un resultado nulo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

604

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

Correl - funcin de grfico (pgina 224)

RangeCount
RangeCount() devuelve el nmero de valores, tanto de texto como numricos en una expresin o campo.
Sintaxis:
RangeCount(first_expr[, Expression])
Tipo de datos que devuelve: Entero
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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 contar.

Expression

Las expresiones o campos opcionales que contienen el rango de datos que se han de
contar.

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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

605

5 Funciones en scripts y en expresiones de grfico


Ejemplos

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.

La tabla resultante muestra


los valores devueltos de
MyRangeCount para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD recno() as RangeID, RangeCount(Field1,Field2,Field3) as
MyRangeCount INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangeCount

Ejemplo con expresin:


RangeCount (Above(MyField,1,3))

Devuelve el nmero de valores contenidos enlos tres resultados de MyField. Especificando el segundo y
tercer argumentos de la funcin Above() como 3, devuelve los valores de los tres campos por encima de la
fila actual, en los que hay suficientes filas, las cuales se toman como entrada para la funcin RangeSum().
Datos utilizados en los ejemplos:

MyField

RangeCount(Above(MyField,1,3))

10

18

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

606

5 Funciones en scripts y en expresiones de grfico


] ;

Vea tambin:
p

Count - funcin de grfico (pgina 189)

RangeFractile
RangeFractile() devuelve el valor que corresponde al ensimo fractile (cuantil) de un rango de nmeros.

RangeFractile() utiliza una interpolacin lineal entre los rangos ms prximos al calcular el
percentil.

Sintaxis:
RangeFractile(fractile, first_expr[, Expression])
Tipo de datos que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

607

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

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.

La tabla resultante muestra los


valores devueltos de MyRangeFrac
para cada uno de los registros de la
tabla.

RangeTab:
LOAD recno() as RangeID, RangeFractile
(0.5,Field1,Field2,Field3) as MyRangeFrac INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangeFrac

11

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),0,3))

En este ejemplo, la funcin inter-registro Above() contiene los argumentos opcionales offset y count. Esto
produce un rango de resultados que puede utilizarse como entrada para cualquiera de las funciones de
rango. En este caso, Above(Sum(MyField),0,3) devuelve los valores de MyField para la fila actual y dos filas
por encima. Estos valores sirven de entrada para la funcin RangeFractile(). Por lo tanto, para la fila inferior
de la tabla siguiente, este es el equivalente de RangeFractile(0.5, 3,4,6), es decir, el clculo del percentil
0,5 para las series 3, 4 y 6. En las dos primeras filas de la tabla siguiente, el nmero de valores del rango se
reduce de manera acorde donde no hay ninguna fila encima de la fila actual. Se obtendrn resultados
similares para las dems funciones inter-registro.

MyField

RangeFractile(0.5, Above(Sum(MyField),0,3))

1,5

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

608

5 Funciones en scripts y en expresiones de grfico


MyField

RangeFractile(0.5, Above(Sum(MyField),0,3))

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
1
2
3
4
5
6
] ;

Vea tambin:
p
p

Above - funcin de grfico (pgina 553)


Fractile - funcin de grfico (pgina 227)

RangeIRR
RangeIRR() devuelve la tasa de rendimiento interno de una serie de flujos de caja representados por los
valores introducidos.
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][, Expression])
Tipo de datos que devuelve: numrico
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.

Expression

Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

609

5 Funciones en scripts y en expresiones de grfico


Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos

Resultados

RangeIRR(-70000,12000,15000,18000,21000,26000)

Devuelve 0,0866

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.

La tabla resultante
muestra los valores
devueltos de
RangeIRR para cada
uno de los registros de
la tabla.

RangeTab3:
LOAD *,
recno() as RangeID,
RangeIRR(Field1,Field2,Field3) as RangeIRR;
LOAD * INLINE [
Field1|Field2|Field3
-10000|5000|6000
-2000|NULL|7000
-8000|'abc'|8000
-1800|11000|9000
-5000|5000|9000
-9000|4000|2000
] (delimiter is '|');

RangeID

RangeIRR

0.0639

0.8708

5.8419

0.9318

-0.2566

Vea tambin:
p

Funciones inter-registro (pgina 549)

RangeKurtosis
RangeKurtosis() devuelve el valor que corresponde a la kurtosis de un rango de nmeros.
Sintaxis:
RangeKurtosis(first_expr[, Expression])
Tipo de datos que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

610

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

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 (1,2,4,7)

Devuelve -0,28571428571429

Vea tambin:
p

Kurtosis - funcin de grfico (pgina 231)

RangeMax
RangeMax() devuelve los valores numricos ms altos que encuentra en la expresin o campo.
Sintaxis:
RangeMax(first_expr[, Expression])
Tipo de datos que devuelve: 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:
Ejemplos

Resultados

RangeMax (1,2,4)

Devuelve 4

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

611

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

RangeMax (1,'xyz')

Devuelve 1

RangeMax (null( ), 'abc')

Devuelve NULL

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.

La tabla resultante
muestra los valores
devueltos de
MyRangeMax para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD recno() as RangeID, RangeMax(Field1,Field2,Field3) as MyRangeMax
INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangeMax

10

18

Ejemplo con expresin:


RangeMax (Above(MyField,0,3))

Devuelve el valor mximo en el rango de tres valores de MyField calculados en la fila actual y dos filas por
encima de la fila actual. Especificando el tercer argumento como 3, la funcin Above() devuelve tres valores,
en los que hay suficientes filas por encima, las cuales se toman como entrada para la funcin RangeMax().
Datos utilizados 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

10

10

10

18

18

18

18

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

612

5 Funciones en scripts y en expresiones de grfico


Datos utilizados en los ejemplos:
RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;

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 que devuelve: cadena
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.
Datos utilizados en los ejemplos:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

613

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

RangeMaxString(Above(MaxString(MyField),0,3))

10

10

abc

abc

abc

def

def

xyz

xyz

xyz

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
'def'
'xyz'
9
] ;

Vea tambin:
p

MaxString - funcin de grfico (pgina 344)

RangeMin
RangeMin() devuelve los valores numricos ms bajos que encuentra en la expresin o campo.
Sintaxis:
RangeMin(first_expr[, Expression])
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

first_expr

La expresin o el campo que contiene los datos que se han de medir.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

614

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

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

RangeMin (1,2,4)

Devuelve 1

RangeMin (1,'xyz')

Devuelve 1

RangeMin (null( ), 'abc')

Devuelve NULL

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.

La tabla resultante
muestra los valores
devueltos de
MyRangeMin para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD recno() as RangeID, RangeMin(Field1,Field2,Field3) as MyRangeMin
INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangeMin

Ejemplo con expresin:


RangeMin (Above(MyField,0,3)

Devuelve el valor mnimo en el rango de tres valores de MyField calculados en la fila actual y dos filas por
encima de la fila actual. Especificando el tercer argumento como 3, la funcin Above() devuelve tres valores,
en los que hay suficientes filas por encima, las cuales se toman como entrada para la funcin RangeMin().
Datos utilizados en los ejemplos:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

615

5 Funciones en scripts y en expresiones de grfico


MyField

RangeMin(Above(MyField,0,3))

10

10

18

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;

Vea tambin:
p

Min - funcin de grfico (pgina 177)

RangeMinString
RangeMinString() devuelve el primer valor en el orden de texto que encuentra en una expresin o campo.
Sintaxis:
RangeMinString(first_expr[, Expression])
Tipo de datos que devuelve: cadena
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

616

5 Funciones en scripts y en expresiones de grfico


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 utilizados 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

def

xyz

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
'def'
'xyz'
9
] ;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

617

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

MinString - funcin de grfico (pgina 346)

RangeMissingCount
RangeMissingCount() devuelve el nmero de valores no numricos (incluidos los valores NULL) en una
expresin o campo.
Sintaxis:
RangeMissingCount(first_expr[, Expression])
Tipo de datos que devuelve: Entero
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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 contar.

Expression

Las expresiones o campos opcionales que contienen el rango de datos que se han de
contar.

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.

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

618

5 Funciones en scripts y en expresiones de grfico


RangeMissingCount
MyField

(Above(MinString

Explanation

(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').

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').

Devuelve 2 porque 2 de las 3 filas incluyen valores no


numricos (' xyz' y 'def').

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
'def'
'xyz'
9
] ;

Vea tambin:
p

MissingCount - funcin de grfico (pgina 192)

RangeMode
RangeMode() halla el valor que ms veces aparece (valor de la moda) en la expresin o campo.
Sintaxis:
RangeMode(first_expr {, Expression})

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

619

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.

Ejemplos y resultados:
Ejemplos

Resultados

RangeMode (1,2,9,2,4)

Devuelve 2

RangeMode ('a',4,'a',4)

Devuelve NULL

RangeMode (null( ))

Devuelve NULL

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.

La tabla resultante
muestra los valores
devueltos de
MyRangeMode para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD recno() as RangeID, RangeMode(Field1,Field2,Field3) as MyRangeMode
INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangMode

Ejemplo con expresin:


RangeMode (Above(MyField,0,3))

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

620

5 Funciones en scripts y en expresiones de grfico


Devuelve el valor que se da con mayor frecuencia en los tres resultados de la funcin MyField evaluada en la
fila actual y dos filas por encima de la fila actual. Especificando el tercer argumento como 3, la funcin
Above() devuelve tres valores, en los que hay suficientes filas por encima, las cuales se toman como entrada
para la funcin RangeMode().
Datos utilizados en el ejemplo:
RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField

RangeMode(Above(MyField,0,3))

10

Devuelve 10 porque no hay filas por encima as que el valor nico es el que aparece con mayor
frecuencia.

18

Vea tambin:
p

Mode - funcin de grfico (pgina 180)

RangeNPV
RangeNPV() devuelve el valor actual neto de una inversin basada en un tipo de descuento y una serie de
pagos peridicos futuros (valores negativos) e ingresos (valores positivos). El resultado tiene un formato
numrico predeterminado en money.
Para flujos de caja que no sean necesariamente peridicos, vase RangeXNPV (pgina 634).

Sintaxis:
RangeNPV(discount_rate, value[,value][, Expression])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

621

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

discount_
rate

Es el tipo de inters por periodo.

value

Es un pago o ingreso que tiene lugar al final de cada periodo. Cada valor puede ser un
valor nico o un rango de valores devueltos por una funcin inter-registro con un tercer
parmetro opcional.

Expression

Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos se descartan.

Ejemplos

Resultados

RangeNPV(0.1,-10000,3000,4200,6800)

Devuelve 1188,44

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.

La tabla resultante
muestra los valores
devueltos de
RangeNPV para cada
uno de los registros de
la tabla.

RangeTab3:
LOAD *,
recno() as RangeID,
RangeNPV(Field1,Field2,Field3) as RangeNPV;
LOAD * INLINE [
Field1|Field2|Field3
10|5|-6000
2|NULL|7000
8|'abc'|8000
18|11|9000
5|5|9000
9|4|2000
] (delimiter is '|');

RangeID

RangeNPV

$-49.13

$777.78

$98.77

$25.51

$250.83

$20.40

Vea tambin:
p

Funciones inter-registro (pgina 549)

RangeNullCount
RangeNullCount() halla el nmero de valores NULL en una expresin o campo.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

622

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
RangeNullCount(first_expr [, Expression])
Tipo de datos que devuelve: Entero
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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

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.

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).

'abc'

Devuelve 1 porque solo hay una fila por encima de la fila actual as que uno de los tres valores
falta (=NULL).

Devuelve 0 porque ninguna de las tres filas es un valor NULL.

Datos utilizados en los ejemplos:


RangeTab:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

623

5 Funciones en scripts y en expresiones de grfico


LOAD * INLINE [
MyField
10
'abc'
8
] ;

Vea tambin:
p

NullCount - funcin de grfico (pgina 195)

RangeNumericCount
RangeNumericCount() halla el nmero de valores numricos en una expresin o campo.
Sintaxis:
RangeNumericCount(first_expr[, Expression])
Tipo de datos que devuelve: Entero
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

624

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

RangeNumericCount(Above(MaxString(MyField),0,3))

10

abc

def

xyz

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
def
xyz
9
] ;

Vea tambin:
p

NumericCount - funcin de grfico (pgina 198)

RangeOnly
RangeOnly() es una funcin dual que devuelve un valor si la expresin devuelve un nico valor. Si este no es
el caso entonces devuelve NULL.

Sintaxis:
RangeOnly(first_expr[, Expression])
Tipo de datos que devuelve: dual
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro las cuales devuelven un rango de
valores por s mismas.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

625

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

RangeOnly (1,2,4)

Devuelve NULL

RangeOnly (5,'abc')

Devuelve NULL

RangeOnly (null( ), 'abc')

Devuelve 'abc'

RangeOnly(10,10,10)

Devuelve 10

Vea tambin:
p

Only - funcin de grfico (pgina 182)

RangeSkew
RangeSkew() devuelve el valor que corresponde a la asimetra de un rango de nmeros.
Sintaxis:
RangeSkew(first_expr[, Expression])
Tipo de datos que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

626

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplos

Resultados

rangeskew (1,2,4)

Devuelve 0,93521952958283

rangeskew (above
(SalesValue,0,3))

Devuelve una asimetra mvil del rango de tres valores que devuelve la funcin
above() calculada en la fila actual y dos filas por encima de la fila actual.

Datos utilizados en el ejemplo:

CustID

RangeSkew(Above(SalesValue,0,3))

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
] ;

Vea tambin:
p

Skew - funcin de grfico (pgina 257)

RangeStdev
RangeStdev() halla la desviacin estndar de un rango de nmeros.
Sintaxis:
RangeStdev(first_expr[, Expression])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

627

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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 (1,2,4)

Devuelve 1,5275252316519

RangeStdev (null(
))

Devuelve NULL

RangeStdev (above
(SalesValue),0,3))

Devuelve un estndar mvil del rango de tres valores que devuelve la funcin
above() calculada en la fila actual y dos filas por encima de la fila actual.

Datos utilizados en el ejemplo:

CustID

RangeStdev(SalesValue, 0,3))

1-20

-,43,841, 34,192, 18,771, 20,953, 41,138, 47,655, 36,116, 32,716, 25,325,


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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

628

5 Funciones en scripts y en expresiones de grfico


124
176
113
95
32
42
92
61
21
] ;

Vea tambin:
p

Stdev - funcin de grfico (pgina 260)

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 que devuelve: numrico
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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:
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

629

5 Funciones en scripts y en expresiones de grfico


Ejemplos

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.

La tabla resultante
muestra los valores
devueltos de
MyRangeSum para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD recno() as RangeID, Rangesum(Field1,Field2,Field3) as MyRangeSum
INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];

RangeID

MyRangeSum

21

12

18

38

19

15

Ejemplo con expresin:


RangeSum (Above(MyField,0,3))

Devuelve la suma de los tres valores de MyField): desde la fila actual y dos filas por encima de la fila actual.
Especificando el tercer argumento como 3, la funcin Above() devuelve tres valores, en los que hay
suficientes filas por encima, las cuales se toman como entrada para la funcin RangeSum().
Datos utilizados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField

RangeSum(Above(MyField,0,3))

10

10

12

20

18

28

31

32

Datos utilizados en los ejemplos:


RangeTab:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

630

5 Funciones en scripts y en expresiones de grfico


LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;

Vea tambin:
p
p

Sum - funcin de grfico (pgina 185)


Above - funcin de grfico (pgina 553)

RangeTextCount
RangeTextCount() devuelve el nmero de valores de texto de una expresin o campo.
Sintaxis:
RangeTextCount(first_expr[, Expression])
Tipo de datos que devuelve: Entero
Argumentos:
Los argumentos de esta funcin pueden contener funciones inter-registro 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))

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

631

5 Funciones en scripts y en expresiones de grfico


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 utilizados en los ejemplos:

Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.

MyField

MaxString(MyField)

RangeTextCount(Above(Sum(MyField),0,3))

10

10

abc

abc

def

def

xyz

xyz

Datos utilizados en los ejemplos:


RangeTab:
LOAD * INLINE [
MyField
10
'abc'
8
null()
'xyz'
9
] ;

Vea tambin:
p

TextCount - funcin de grfico (pgina 201)

RangeXIRR
RangeXIRR() devuelve la tasa de rendimiento interno 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(values, dates[, Expression])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

632

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

values

Un flujo de caja o una serie de flujos de caja correspondientes a una planificacin de pagos
por fechas. Cada valor puede ser un valor nico o un rango de valores devueltos por una
funcin inter-registro con un tercer parmetro opcional. La serie de valores deber
contener al menos un valor positivo y otro negativo.

dates

Una fecha de pago o una planificacin de pagos en varias fechas, que se corresponde con
los pagos de los flujos de caja.

Expression

Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.

Limitaciones:
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.

Ejemplos

Resultados

RangeXIRR(-2500,'2008-01-01',2750,'2008-09-01')

Devuelve 0,1532

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.

La tabla resultante
muestra los valores
devueltos de
RangeXIRR para cada
uno de los registros de
la tabla.

RangeTab3:
LOAD *,
recno() as RangeID,
RangeXIRR(Field1,Field2,Field3) as RangeXIRR;
LOAD * INLINE [
Field1|Field2|Field3
10|5|-6000
2|NULL|7000
8|'abc'|8000
18|11|9000
5|5|9000
9|4|2000
] (delimiter is '|');

RangeID

RangeXIRR

0.5893

0.5089

0.4476

0.4476

2.5886

Vea tambin:
p

RangeIRR (pgina 609)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

633

5 Funciones en scripts y en expresiones de grfico


RangeXNPV
RangeXNPV() devuelve el valor actual neto de una planificacin de flujos de caja que no tienen que ser
necesariamente peridicos. 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(discount_rate, values, dates[, Expression])
Tipo de datos que devuelve: numrico
Argumentos:
Argumento

Descripcin

discount_
rate

Es el tipo de inters por periodo.

values

Un flujo de caja o una serie de flujos de caja correspondientes a una planificacin de pagos
por fechas. Cada valor puede ser un valor nico o un rango de valores devueltos por una
funcin inter-registro con un tercer parmetro opcional. La serie de valores deber
contener al menos un valor positivo y otro negativo.

dates

Una fecha de pago o una planificacin de pagos en varias fechas, que se corresponde con
los pagos de los flujos de caja.

Limitaciones:
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.

Ejemplos

Resultados

RangeXNPV(0.1, -2500,'2008-01-01',2750,'2008-09-01')

Devuelve 80,25

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

634

5 Funciones en scripts y en expresiones de grfico


Ejemplos

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.

La tabla resultante
muestra los valores
devueltos de
RangeXNPV para cada
uno de los registros de la
tabla.

RangeTab3:
LOAD *,
recno() as RangeID,
RangeXNPV(Field1,Field2,Field3) as RangeNPV;
LOAD * INLINE [
Field1|Field2|Field3
10|5|-6000
2|NULL|7000
8|'abc'|8000
18|11|9000
5|5|9000
9|4|2000
] (delimiter is '|');

RangeID

RangeXNPV

$-49.13

$777.78

$98.77

$25.51

$250.83

$20.40

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
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]])
HRank
HRank() evala la expresin y compara el resultado con el resultado de las otras columnas que contienen el
segmento de fila actual de una tabla pivotante. La funcin devuelve el ranking de la columna actual dentro
del segmento.
HRank - funcin de grfico([TOTAL] 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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

635

5 Funciones en scripts y en expresiones de grfico


Para grficos que no sean tablas, se define el segmento de columna actual tal como aparece en su
equivalente en la tabla simple.

Sintaxis:
Rank([TOTAL] expr[, mode[, fmt]])
Tipo de datos que devuelve: 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 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 campos 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.
En caso de que varias filas compartan un mismo ranking, el texto y la representacin numrica pueden
controlarse mediante los parmetros mode y fmt.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

636

5 Funciones en scripts y en expresiones de grfico


Valor

Descripcin

Rango ms bajo en todas las filas.

Rango promedio en todas las filas.

Rango ms alto en todas las filas.

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).

Valor bajo en todas las filas.

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

637

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Cree una
tabla con las
dimensiones
Customer y
Sales y la
medida Rank

El resultado depende del orden de las dimensiones. Si la tabla est ordenada por
Customer, la tabla lista todos los valores de Sales para Astrida, despus Betacab, etc. Los
resultados de Rank(Sales) mostrarn 10 para el valor 12 de Sales, 9 para el valor 13 de
Sales, etc., con el valor de rango de 1 devuelto para el valor 78 de Sales. 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.

(Sales)

Customer

Sales

Rank(Sales)

Astrida

12

10

Astrida

13

Astrida

20

Astrida

22

Astrida

45

Astrida

46

Astrida

60

Astrida

65

Astrida

70

Astrida

78

Betcab

12

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.

Customer

Sales

Rank(Sales)

Astrida

12

1-2

Betacab

12

1-2

Astrida

13

Betacab

15

Astrida

20

Astrida

22

1-2

Betacab

22

1-2

Betacab

24

1-2

Canutility

24

1-2

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

638

5 Funciones en scripts y en expresiones de grfico


Ejemplos

Resultados

Reemplace
la dimensin
Customer
por Product
y aada la
medida Rank

Esto devuelve el valor 1 en la primera fila de cada segmento de columna con las dems
filas en blanco, ya que los argumentos mode y fmt estn configurados con los valores 1 y
2 respectivamente.

(Sales,1,2)

Datos utilizados 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

Sum - funcin de grfico (pgina 185)

HRank - funcin de grfico


HRank() evala la expresin y compara el resultado con el resultado de las otras columnas que contienen el
segmento de fila actual de una tabla pivotante. La funcin devuelve el ranking de la columna actual dentro
del segmento.
Sintaxis:
HRank([ total ] expr [ , mode [, fmt ] ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

639

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: dual

Esta funcin slo funciona en tablas pivotantes. En todos los dems tipos de grficos
devuelve NULL.

Argumentos:
Argumento

Descripcin

expression

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 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 campos 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.

Si la tabla pivotante es unidimensional o si la expresin va precedida por el cualificador total, el segmento de


fila actual siempre es igual a la fila entera. Si la tabla pivotante tiene mltiples dimensiones horizontales, el
segmento de fila actual incluir slo columnas con los mismos valores que la columna actual en todas las
filas de dimensin excepto la fila que muestra la ltima dimensin horizontal del orden de campo.
El ranking se devuelve como valor dual, el cual, en el caso de que cada columna tenga un ranking nico, ser
entre 1 y el nmero de columnas del segmento de columna actual.
En caso de que varias filas compartan un mismo ranking, el texto y la representacin numrica pueden
controlarse mediante los argumentos mode y format.
El segundo argumento mode, especifica la representacin numrica del resultado de la funcin.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

640

5 Funciones en scripts y en expresiones de grfico


Valor

Descripcin

0 (por defecto)

Si todos los puestos de ranking dentro del grupo compartido caen dentro del
extremo ms bajo del valor intermedio del ranking completo, todas las filas
tendrn el rango ms bajo dentro del grupo compartido.
Si todos los puestos del ranking dentro del grupo compartido caen dentro del
extremo ms alto del valor intermedio del ranking completo, todas las
columnas recibirn el rango ms alto 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.

Rango ms bajo en todas las columnas del grupo.

Rango medio en todas las columnas del grupo.

Rango ms alto en todas las columnas del grupo.

Rango ms bajo en la primera columna, luego incrementado en uno por cada


columna del grupo

El tercer parmetro format, especifica la representacin de texto del resultado de la funcin:

Valor

Descripcin

0 (por defecto)

Valor bajo &' - '&valor alto de todas las columnas del grupo (por ejemplo 3 -

4).
1

Rango ms bajo en todas las columnas del grupo.

valor bajo en la primera columna, vaco en las siguientes columnas del grupo.

El orden de las columnas para mode 4 y format 2 viene determinado por el orden de las dimensiones de
grfico.

Ejemplos:
HRank( sum( Sales ))
HRank( sum( Sales ), 2 )
HRank( sum( Sales ), 0, 1 )

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 de funciones Cephes. Para referencias y detalles sobre los algoritmos utilizados,
exactitud, etc. consulte: http://www.netlib.org/cephes/. La librera de funciones Cephes se utiliza bajo
permiso.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

641

5 Funciones en scripts y en expresiones de grfico


Las funciones de distribucin estadstica DIST miden la probabilidad de la funcin de distribucin en el punto
de la distribucin dado por el valor suministrado. Las funciones INV calculan el valor, dada la probabilidad de
la distribucin. Por contraste, los grupos de funciones estadsticas de agregacin calculan los valores
agregados de series de valores estadsticos de prueba para diversas pruebas estadsticas de hiptesis.
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.

CHIDIST
CHIDIST() devuelve la probabilidad de cola 1 de distribucin de chi2 . La distribucin chi2 se asocia a una
prueba chi2 .
CHIDIST (value, degrees_freedom)
CHIINV
CHIINV() devuelve el inverso de la probabilidad de cola 1 de distribucin de chi2 .
CHIINV (prob, degrees_freedom)
NORMDIST
NORMDIST() 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
NORMINV() devuelve el inverso de la distribucin acumulativa normal de la media y la desviacin estndar
especificadas.
NORMINV (prob, mean, standard_dev)
TDIST
TDIST() devuelve la probabilidad de distribucin t de estudiante, en la que un valor numrico es un valor
calculado de t para el cual se ha de calcular la probabilidad.
TDIST (value, degrees_freedom, tails)
TINV
TINV() devuelve el valor t de la distribucin t de estudiante como una funcin de la probabilidad y los grados
de libertad.
TINV (prob, degrees_freedom)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

642

5 Funciones en scripts y en expresiones de grfico


FDIST
FDIST() devuelve la distribucin de probabilidad F.
FDIST (value, degrees_freedom1, degrees_freedom2)
FINV
FINV() devuelve la inversa de la distribucin de probabilidad F.
FINV (prob, degrees_freedom1, degrees_freedom2)

Vea tambin:
p

Funciones de agregacin estadstica (pgina 214)

CHIDIST
CHIDIST() devuelve la probabilidad de cola 1 de distribucin de chi2 . La distribucin chi2 se asocia a una
prueba chi2 .
Sintaxis:
CHIDIST(value, degrees_freedom)
Tipo de datos que devuelve: nmero
Argumentos:
Argumento

Descripcin

value

Es el valor con el cual se desea evaluar la distribucin. El valor no debe ser negativo.

degrees_freedom

Es un entero positivo que indica el nmero de grados de libertad.

Esta funcin se relaciona con la funcin CHIINV de la siguiente manera:


If prob = CHIDIST(value,df), then CHIINV(prob, df) = value

Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

CHIDIST(8, 15)

Devuelve 0,9238

CHIINV
CHIINV() devuelve el inverso de la probabilidad de cola 1 de distribucin de chi2 .

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

643

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
CHIINV(prob, degrees_freedom)
Tipo de datos que devuelve: nmero
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.

Esta funcin se relaciona con la funcin CHIDIST de la siguiente manera:


If prob = CHIDIST(value,df), then CHIINV(prob, df) = value

Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

CHIINV(0.9237827, 15 )

Devuelve 8,0000

FDIST
FDIST() devuelve la distribucin de probabilidad F.
Sintaxis:
FDIST(value, degrees_freedom1, degrees_freedom2)
Tipo de datos que devuelve: nmero
Argumentos:
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.

Esta funcin se relaciona con la funcin FINV de la siguiente manera:


If prob = FDIST(value, df1, df2), then FINV(prob, df1, df2) = value

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

644

5 Funciones en scripts y en expresiones de grfico


Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

FDIST(15, 8, 6)

Devuelve 0,0019

FINV
FINV() devuelve la inversa de la distribucin de probabilidad F.
Sintaxis:
FINV(prob, degrees_freedom1, degrees_freedom2)
Tipo de datos que devuelve: nmero
Argumentos:
Argumento

Descripcin

prob

Es una probabilidad asociada con la distribucin de probabilidad F y debe ser un


nmero entre 0 y 1.

degrees_
freedom

Es un entero que indica el nmero de grados de libertad.

Esta funcin se relaciona con la funcin FDIST de la siguiente manera:


If prob = FDIST(value, df1, df2), then FINV(prob, df1, df2) = value

Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

FINV(0.0019369, 8, 6)

Devuelve 15,0000

NORMDIST
NORMDIST() 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)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

645

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: nmero
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.

Esta funcin se relaciona con la funcin NORMINV de la siguiente manera:


If prob = NORMDIST(value, m, sd), then NORMINV(prob, m, sd) = value

Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

NORMDIST(0.5, 0, 1)

Devuelve 0,6915

NORMINV
NORMINV() devuelve el inverso de la distribucin acumulativa normal de la media y la desviacin estndar
especificadas.
Sintaxis:
NORMINV(prob, mean, standard_dev)
Tipo de datos que devuelve: nmero
Argumentos:
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.

Esta funcin se relaciona con la funcin NORMDIST de la siguiente manera:


If prob = NORMDIST(value, m, sd), then NORMINV(prob, m, sd) = value

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

646

5 Funciones en scripts y en expresiones de grfico


Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

NORMINV(0.6914625, 0, 1 )

Devuelve 0,5000

TDIST
TDIST() devuelve la probabilidad de distribucin t de estudiante, en la que un valor numrico es un valor
calculado de t para el cual se ha de calcular la probabilidad.
Sintaxis:
TDIST(value, degrees_freedom, tails)
Tipo de datos que devuelve: nmero
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 bien 1 (distribucin de cola uno) o 2 (distribucin de cola dos).

Esta funcin se relaciona con la funcin TINV de la siguiente manera:


If prob = TDIST(value, df ,2), then TINV(prob, df) = value

Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.

Ejemplos y resultados:
Ejemplo

Resultado

TDIST(1, 30, 2)

Devuelve 0,3253

TINV
TINV() devuelve el valor t de la distribucin t de estudiante como una funcin de la probabilidad y los grados
de libertad.
Sintaxis:
TINV(prob, degrees_freedom)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

647

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: nmero
Argumentos:
Argumento

Descripcin

prob

Es una probabilidad de cola 2 asociada con la distribucin t. 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.
Esta funcin se relaciona con la funcin TDIST de la siguiente manera:
If prob = TDIST(value, df ,2), then TINV(prob, df) = value.

Ejemplos y resultados:
Ejemplo

Resultado

TINV(0.3253086, 30 )

Devuelve 1,0000

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.

Capitalize
Capitalize() devuelve la cadena con todas las palabras con su letra inicial en mayscula.
Capitalize (text)
Chr
Chr() devuelve el carcter Unicode correspondiente al entero introducido.
Chr (int)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

648

5 Funciones en scripts y en expresiones de grfico


Evaluate
Evaluate() halla si la cadena de texto introducida puede ser evaluada como una expresin Qlik Sense vlida,
y, si es as, devuelve el valor de la expresin en forma de cadena. Si la cadena introducida no es una
expresin vlida, devuelve NULL.
Evaluate (expression_text)
FindOneOf
FindOneOf() busca una cadena a fin de hallar la posicin de cualquier carcter de un conjunto de caracteres
suministrados. Devuelve la posicin de la primera vez que aparece cualquier carcter del conjunto
especificado en la bsqueda a menos que se suministre un tercer argumento (con un valor mayor que 1). Si
no encuentra ninguna correspondencia, devuelve 0.
FindOneOf (text, char_set[, count])
Hash128
Hash128() devuelve un cdigo hash de 128 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena de 22 caracteres.
Hash128 (expr{, expression})
Hash160
Hash160() devuelve un cdigo hash de 160 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena de 27 caracteres.
Hash160 (expr{, expression})
Hash256
Hash256() devuelve un cdigo hash de 256 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena de 43 caracteres.
Hash256 (expr{, expression})
Index
Index() busca una cadena para hallar la posicin de inicio de la ensima vez que aparece una subcadena
suministrada. Un tercer argumento opcional proporciona el valor de n, el cual se considera 1 si se omite. Un
valor negativo busca desde el final de la cadena. Las posiciones en la cadena se numeran desde 1 y hacia
arriba.
Index

(text, substring[, count])

KeepChar
KeepChar() devuelve una cadena que consiste en la primera cadena, 'text', menos cualquiera de los
caracteres NO contenidos en la segunda cadena, "keep_chars".
KeepChar (text, keep_chars)
Left
Left() devuelve una cadena que consiste en los primeros n caracteres (los situados ms a la izquierda) de la

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

649

5 Funciones en scripts y en expresiones de grfico


cadena introducida, donde el nmero de caracteres viene determinado por el segundo argumento.

Left (text, count)


Len
Len() devuelve la longitud de la cadena introducida.
Len (text)
Lower
Lower() pone todos los caracteres de la cadena introducida en letra minscula.
Lower (text)
LTrim
LTrim() devuelve la cadena introducida libre de espacios iniciales.
LTrim (text)
Mid
Mid() devuelve la parte de la cadena de entrada que comienza en la posicin del carcter definido por el
segundo argumento, 'start', y devolviendo el nmero de caracteres definidos por el tercer argumento, 'count'.
Si 'count' se omite, devuelve el resto de la cadena de entrada. El primer carcter de la cadena de entrada se
enumera como 1.
Mid (text, start[, count])
Ord
Ord() devuelve el nmero de punto de cdigo Unicode del primer carcter de la cadena introducida.
Ord (char )
PurgeChar
PurgeChar() devuelve una cadena que contiene los caracteres de la cadena introducida ('text'), menos los
caracteres contenidos en el segundo argumento ('remove_chars').
PurgeChar (text, remove_chars)
Repeat
Repeat() forma una cadena que consiste en la cadena introducida, repetida el nmero de veces definido por
el segundo argumento.
Repeat (text[, repeat_count])
Replace
Replace() devuelve una cadena tras haber reemplazado todas las veces en que aparece una determinada
subcadena dentro de la cadena introducida por otra subcadena. La funcin no es recursiva y funciona de
izquierda a derecha.
Replace (text, from_str, to_str)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

650

5 Funciones en scripts y en expresiones de grfico


Right
Right() devuelve una cadena que consiste en los ltimos caracteres (los situados ms a la derecha) de la
cadena introducida, donde el nmero de caracteres viene determinado por el segundo argumento.
Right (text, count)
RTrim
RTrim() devuelve la cadena introducida libre de espacios finales.
RTrim (text)
SubField
Subfield() se utiliza para extraer componentes de una subcadena de un campo de cadena superior, donde
los campos de registro originales constan de dos o ms partes separadas por un delimitador.
SubField (text, delimiter[, field_no ])
SubStringCount
SubstringCount() devuelve el nmero de veces que aparece la subcadena especificada en el texto de la
cadena introducida. Si no existe coincidencia alguna, devuelve 0.
SubStringCount ( text, substring)
TextBetween
TextBetween() devuelve el texto de la cadena de entrada que se da entre los caracteres especificados como
delimitadores.
TextBetween (text, sub_string)
Trim
Trim() devuelve la cadena introducida libre de todos los espacios iniciales y finales.
Trim (text)
Upper
Upper() convierte todos los caracteres de la cadena introducida en mayscula para todos los caracteres de
texto de la expresin. Los nmeros y smbolos se ignoran.
Upper (text)

Capitalize
Capitalize() devuelve la cadena con todas las palabras con su letra inicial en mayscula.
Sintaxis:
Capitalize(text)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

651

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

Capitalize ( 'my little pony' )

Devuelve 'My Little Pony'

Capitalize ( 'AA bb cC Dd')

Devuelve 'Aa Bb Cc Dc'

Chr
Chr() devuelve el carcter Unicode correspondiente al entero introducido.
Sintaxis:
Chr(int)
Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

Chr(65)

Devuelve la cadena 'A'

Evaluate
Evaluate() halla si la cadena de texto introducida puede ser evaluada como una expresin Qlik Sense vlida,
y, si es as, devuelve el valor de la expresin en forma de cadena. Si la cadena introducida no es una
expresin vlida, devuelve NULL.
Sintaxis:
Evaluate(expression_text)
Tipo de datos que devuelve: dual

Esta funcin de script no puede utilizarse en expresiones de grficos.


Ejemplos y resultados:
Ejemplo

Resultado

Evaluate ( 5 * 8 )

Devuelve '40'

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

652

5 Funciones en scripts y en expresiones de grfico


FindOneOf
FindOneOf() busca una cadena a fin de hallar la posicin de cualquier carcter de un conjunto de caracteres
suministrados. Devuelve la posicin de la primera vez que aparece cualquier carcter del conjunto
especificado en la bsqueda a menos que se suministre un tercer argumento (con un valor mayor que 1). Si
no encuentra ninguna correspondencia, devuelve 0.
Sintaxis:
FindOneOf(text, char_set[, count])
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

text

La cadena original.

char_set

Un conjunto de caracteres que buscar en text.

count

Define qu ocurrencia de carcter buscar. Por ejemplo, un valor de 2 busca la segunda vez
que aparece un carcter.

Ejemplos y resultados:
Ejemplo

Resultado

FindOneOf( 'my example


text string', 'et%s')

Devuelve '4'

FindOneOf( 'my example


text string', 'et%s', 3)

Devuelve '12' Porque la bsqueda es de cualquiera de los caracteres: e, t, %


o s y "t" es la tercera vez que aparece y se encuentra en la posicin 12.

FindOneOf( 'my example


text string', '%&')

Devuelve '0'

Hash128
Hash128() devuelve un cdigo hash de 128 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena de 22 caracteres.
Sintaxis:
Hash128(expr{, expression})
Tipo de datos que devuelve: cadena
Ejemplo:
Hash128 ( 'abc', 'xyz', '123' )
Hash128 ( Region, Year, Month )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

653

5 Funciones en scripts y en expresiones de grfico


Hash160
Hash160() devuelve un cdigo hash de 160 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena de 27 caracteres.
Sintaxis:
Hash160(expr{, expression})
Tipo de datos que devuelve: cadena
Ejemplo:
Hash160 ( 'abc', 'xyz', '123' )
Hash160 ( Region, Year, Month )

Hash256
Hash256() devuelve un cdigo hash de 256 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena de 43 caracteres.
Sintaxis:
Hash256(expr{, expression})
Tipo de datos que devuelve: cadena
Ejemplo:
Hash256 ( 'abc', 'xyz', '123' )
Hash256 ( Region, Year, Month )

Index
Index() busca una cadena para hallar la posicin de inicio de la ensima vez que aparece una subcadena
suministrada. Un tercer argumento opcional proporciona el valor de n, el cual se considera 1 si se omite. Un
valor negativo busca desde el final de la cadena. Las posiciones en la cadena se numeran desde 1 y hacia
arriba.
Sintaxis:
Index(text, substring[, count])
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

text

La cadena original.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

654

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

substring

Una cadena de caracteres que buscar en text.

count

Define qu ocurrencia de substring buscar. Por ejemplo, un valor de 2 busca la segunda


vez que aparece un carcter.

Ejemplos y resultados:
Ejemplo

Resultado

Index('abcdefg', 'cd' )

Devuelve 3

Index('abcdabcd', 'b', 2)

Devuelve 6 (la segunda vez que aparece 'b')

Index('abcdabcd', 'b',-2)

Devuelve 2 (la segunda vez que aparece 'b'


empezando por el final)

Left( Date, Index( Date,'-') -1 ) where Date =

Devuelve 1997

1997-07-14
Mid( Date, Index( Date, '-', 2 ) -2, 2 ) where

Devuelve 07

Date = 1997-07-14

KeepChar
KeepChar() devuelve una cadena que consiste en la primera cadena, 'text', menos cualquiera de los
caracteres NO contenidos en la segunda cadena, "keep_chars".
Sintaxis:
KeepChar(text, keep_chars)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

keep_chars

Una cadena que contiene los caracteres de text que se han de guardar.

Ejemplos y resultados:
Ejemplo

Resultado

KeepChar ( 'a1b2c3','123' )

Devuelve '123'

KeepChar ( 'a1b2c3','1234' )

Devuelve '123'

KeepChar ( 'a1b22c3','1234' )

Devuelve '1223'

KeepChar ( 'a1b2c3','312' )

Devuelve '123'

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

655

5 Funciones en scripts y en expresiones de grfico

Vea tambin:
p

PurgeChar (pgina 658)

Left
Left() devuelve una cadena que consiste en los primeros n caracteres (los situados ms a la izquierda) de la
cadena introducida, donde el nmero de caracteres viene determinado por el segundo argumento.
Sintaxis:
Left(text, count)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

count

Define el nmero de caracteres que se han de incluir desde la parte izquierda de la cadena
text.

Ejemplos y resultados:
Ejemplo

Resultado

Left('abcdef', 3)

Devuelve 'abc'

Vea: Index (pgina 654), que permite un anlisis de cadena ms complejo.

Len
Len() devuelve la longitud de la cadena introducida.
Sintaxis:
Len(text)
Tipo de datos que devuelve: Entero

Ejemplos y resultados:
Ejemplo

Resultado

Len('Peter')

Devuelve '5'

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

656

5 Funciones en scripts y en expresiones de grfico


Lower
Lower() pone todos los caracteres de la cadena introducida en letra minscula.
Sintaxis:
Lower(text)
Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

Lower('abcD')

Devuelve 'abcd'

LTrim
LTrim() devuelve la cadena introducida libre de espacios iniciales.
Sintaxis:
LTrim(text)
Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

LTrim( ' abc' )

Devuelve 'abc'

LTrim( 'abc ' )

Devuelve 'abc '

Vea tambin:
p

RTrim (pgina 661)

Mid
Mid() devuelve la parte de la cadena de entrada que comienza en la posicin del carcter definido por el
segundo argumento, 'start', y devolviendo el nmero de caracteres definidos por el tercer argumento, 'count'.
Si 'count' se omite, devuelve el resto de la cadena de entrada. El primer carcter de la cadena de entrada se
enumera como 1.
Sintaxis:
Mid(text, start[, count])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

657

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

start

Entero que define la posicin del primer carcter de text que incluir.

count

Define la longitud de cadena de la cadena de salida. Si se omite, se incluirn todos los


caracteres desde la posicin definida por start.

Ejemplos y resultados:
Ejemplo

Resultado

Mid('abcdef',3 )

Devuelve 'cdef'

Mid('abcdef',3, 2 )

Devuelve 'cd'

Vea tambin:
p

Index (pgina 654)

Ord
Ord() devuelve el nmero de punto de cdigo Unicode del primer carcter de la cadena introducida.
Sintaxis:
Ord(char)
Tipo de datos que devuelve: Entero
Ejemplos y resultados:
Ejemplo

Resultado

Ord('A')

Devuelve el entero 65.

Ord('Ab')

Devuelve el entero 65.

PurgeChar
PurgeChar() devuelve una cadena que contiene los caracteres de la cadena introducida ('text'), menos los
caracteres contenidos en el segundo argumento ('remove_chars').
Sintaxis:
PurgeChar(text, remove_chars)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

658

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

remove_chars

Una cadena que contiene los caracteres de text que se han de eliminar.

Tipo de datos que devuelve: cadena


Ejemplos y resultados:
Ejemplo

Resultado

PurgeChar ( 'a1b2c3','123' )

Devuelve 'abc'

PurgeChar ( 'a1b2c3','312' )

Devuelve 'abc'

Vea tambin:
p

KeepChar (pgina 655)

Repeat
Repeat() forma una cadena que consiste en la cadena introducida, repetida el nmero de veces definido por
el segundo argumento.
Sintaxis:
Repeat(text[, repeat_count])
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

repeat_
count

Define el nmero de veces que los caracteres de la cadena text se han de repetir en la
cadena de salida.

Ejemplos y resultados:
Ejemplo
Repeat( ' * ', rating ) when rating =

Resultado
4

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

Devuelve '****'

659

5 Funciones en scripts y en expresiones de grfico


Replace
Replace() devuelve una cadena tras haber reemplazado todas las veces en que aparece una determinada
subcadena dentro de la cadena introducida por otra subcadena. La funcin no es recursiva y funciona de
izquierda a derecha.
Sintaxis:
Replace(text, from_str, to_str)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

from_str

Una cadena que puede aparecer una o ms veces dentro de la cadena de entrada text.

to_str

La cadena que reemplazar todas las instancias de from_str dentro de la cadena text.

Ejemplos y resultados:
Ejemplo

Resultado

Replace('abccde','cc','xyz')

Devuelve 'abxyzde'

Vea tambin:

Right
Right() devuelve una cadena que consiste en los ltimos caracteres (los situados ms a la derecha) de la
cadena introducida, donde el nmero de caracteres viene determinado por el segundo argumento.
Sintaxis:
Right(text, count)
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

count

Define el nmero de caracteres que se han de incluir desde la parte derecha de la cadena
text.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

660

5 Funciones en scripts y en expresiones de grfico


Ejemplos y resultados:
Ejemplo

Resultado

Right('abcdef', 3)

Devuelve 'def'

RTrim
RTrim() devuelve la cadena introducida libre de espacios finales.
Sintaxis:
RTrim(text)
Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

RTrim( ' abc' )

Devuelve ' abc'

RTrim( 'abc ' )

Devuelve 'abc'

Vea tambin:
p

LTrim (pgina 657)

SubField
Subfield() se utiliza para extraer componentes de una subcadena de un campo de cadena superior, donde
los campos de registro originales constan de dos o ms partes separadas por un delimitador.
La funcin Subfield() debe utilizarse, por ejemplo, para extraer el nombre y apellido de una lista de registros
que contienen nombres completos, las partes que componen el nombre de una ruta, o para extraer datos de
tablas separadas por comas.
Si utiliza la funcin Subfield() en una sentencia LOAD con el parmetro opcional field_no excluido, se
generar un registro completo por cada subcadena. Si se cargan varios campos utilizando Subfield() se
crean los productos cartesianos de todas las combinaciones.

Sintaxis:
SubField(text, delimiter[, field_no ])

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

661

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original. Puede ser un texto escrito directamente en el cdigo, una variable, una
expansin de signo dlar, u otra expresin.

delimiter

Un carcter dentro de la entrada text que divide la cadena en partes componentes.

field_no

El tercer parmetro opcional es un entero que especifica cul de las subcadenas de la


cadena padre text debe devolverse. Un valor negativo hace que la subcadena se extraiga
del lado derecho de la cadena. Es decir, que la cadena de bsqueda es de derecha a
izquierda, en lugar de izquierda a derecha, si field_no es un valor positivo.

SubField() puede utilizarse en lugar de utilizar combinaciones complejas de funciones como


Len(), Right(), Left(), Mid() y otras funciones de cadenas.
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 ';'

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.
FullName:
LOAD * inline [
Name
'Dave Owen'
'Joe Tem'
];

Name

FirstName

Surname

Dave
Owen

Dave

Owen

Joe
Tem

Joe

Tem

SepNames:
Load Name,
SubField(Name, ' ',1) as FirstName,
SubField(Name, ' ',-1) as Surname
Resident FullName;
Drop Table FullName;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

662

5 Funciones en scripts y en expresiones de grfico


Ejemplo

Resultado

Supongamos que tenemos una variable que contiene un nombre de


ruta vMyPath,
Set vMyPath=\Users\ext_jrb\Documents\Qlik\Sense\Apps;.

Este ejemplo muestra cmo utilizando mltiples instancias de la


funcin Subfield(), cada una con el parmetro field_no eliminado,

En un grfico de texto e imagen,


podemos aadir una medida,
como:
SubField(vMyPath, '\',-3), que da
como resultado 'Qlik', porque es la
tercera subcadena desde el
extremo derecho de la variable
vMyPath.

Instrument

Player

Project

Guitar

Mike

Music

cartesianos de todas las combinaciones. La opcin DISTINCT sirve

Guitar

Mike

Video

para evitar crear registros duplicados.

Guitar

Mike

OST

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.

Guitar

Neil

Music

Guitar

Neil

Video

Guitar

Neil

OST

Synth

Jen

Music

Synth

Jen

Video

Synth

Jen

OST

Synth

Jo

Music

Synth

Neil

Music

Synth

Neil

Video

Synth

Neil

OST

desde dentro de la misma sentencia LOAD podemos crear productos

LOAD DISTINCT
Instrument,
SubField(Player,',') as Player,
SubField(Project,',') as Project;
Load * inline [
Instrument|Player|Project
Guitar|Neil,Mike|Music,Video
Guitar|Neil|Music,OST
Synth|Neil,Jen|Music,Video,OST
Synth|Jo|Music
Guitar|Neil,Mike|Music,OST
] (delimiter is '|');

SubStringCount
SubstringCount() devuelve el nmero de veces que aparece la subcadena especificada en el texto de la
cadena introducida. Si no existe coincidencia alguna, devuelve 0.
Sintaxis:
SubStringCount(text, sub_string)
Tipo de datos que devuelve: Entero
Argumentos:
Argumento

Descripcin

text

La cadena original.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

663

5 Funciones en scripts y en expresiones de grfico


Argumento

Descripcin

sub_string

Una cadena que puede aparecer una o ms veces dentro de la cadena de entrada text.

Ejemplos y resultados:
Ejemplo

Resultado

SubStringCount ( 'abcdefgcdxyz', 'cd' )

Devuelve '2'

SubStringCount ( 'abcdefgcdxyz', 'dc' )

Devuelve '0'

TextBetween
TextBetween() devuelve el texto de la cadena de entrada que se da entre los caracteres especificados como
delimitadores.
Sintaxis:
TextBetween(text, delimiter1, delimiter2[, n])
Tipo de datos que devuelve: cadena
Argumentos:
Argumento

Descripcin

text

La cadena original.

delimiter1

Especifica el primer carcter delimitador (o cadena) que buscar en text.

delimiter2

Especifica el segundo carcter delimitador (o cadena) que buscar en text.

Define entre qu aparicin del par delimitador se ha de buscar. Por ejemplo, un valor de 2
devuelve los caracteres entre la segunda vez que aparece delimiter1 y la segunda vez que
aparece delimiter2.

Ejemplos y resultados:
Ejemplo

Resultado

TextBetween('<abc>', '<', '>')

Devuelve 'abc'

TextBetween('<abc><de>', '<', '>',2)

Devuelve 'de'

Trim
Trim() devuelve la cadena introducida libre de todos los espacios iniciales y finales.
Sintaxis:
Trim(text)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

664

5 Funciones en scripts y en expresiones de grfico


Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

Trim( ' abc' )

Devuelve 'abc'

Trim( 'abc ' )

Devuelve 'abc'

Trim( ' abc ' )

Devuelve 'abc'

Upper
Upper() convierte todos los caracteres de la cadena introducida en mayscula para todos los caracteres de
texto de la expresin. Los nmeros y smbolos se ignoran.
Sintaxis:
Upper(text)
Tipo de datos que devuelve: cadena
Ejemplos y resultados:
Ejemplo

Resultado

Upper(' abcD')

Devuelve 'ABCD'

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


documento QlikView, la propiedad de autor se mantendr.

ClientPlatform()

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

665

5 Funciones en scripts y en expresiones de grfico


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.

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( )
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( )
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

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

666

5 Funciones en scripts y en expresiones de grfico


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)
Esta funcin no es posible en modo estndar.

IsPartialReload
Esta funcin devuelve -1 (True) si la recarga actual es parcial, si no, devuelve 0 (False).

IsPartialReload ()
OSUser
Esta funcin devuelve una cadena que contiene el nombre del usuario actualmente conectado. Puede
utilizarse tanto en el script de carga de datos como en una expresin de grficos.

OSUser( )
En Qlik Sense Desktop, esta funcin siempre devuelve 'Personal\Me'.

ProductVersion
Esta funcin devuelve el nmero completo de la versin de Qlik Sense como una cadena.

ProductVersion ()
ReloadTime
Esta funcin devuelve una fecha-hora indicando el momento en que finaliz la ltima carga de datos. Puede
utilizarse tanto en el script de carga de datos como en una expresin de grficos.

ReloadTime( )
StateName
Esta funcin de grfico devuelve el nombre del estado del objeto en el que se ha utilizado. Un desarrollador
de Qlik Sense puede utilizar esta funcin para introducir texto dinmico y colores cuando se modifique el
estado de un objeto. Es importante observar que esta funcin opera en objetos nicamente. No puede
emplearse en una expresin de grfico para determinar el estado al que hace referencia la expresin.

StateName - funcin de grfico()

Vea tambin:
p

GetFolderPath (pgina 500)

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 de script y funciones de grficos - Qlik Sense, 3.0

667

5 Funciones en scripts y en expresiones de grfico


Sintaxis:
GetObjectField ([index])
Ejemplo:
GetObjectField(2)

IsPartialReload
Esta funcin devuelve -1 (True) si la recarga actual es parcial, si no, devuelve 0 (False).

Sintaxis:
IsPartialReload()

ProductVersion
Esta funcin devuelve el nmero completo de la versin de Qlik Sense como una cadena.

Sintaxis:
ProductVersion()

StateName - funcin de grfico


Esta funcin de grfico devuelve el nombre del estado del objeto en el que se ha utilizado. Un desarrollador
de Qlik Sense puede utilizar esta funcin para introducir texto dinmico y colores cuando se modifique el
estado de un objeto. Es importante observar que esta funcin opera en objetos nicamente. No puede
emplearse en una expresin de grfico para determinar el estado al que hace referencia la expresin.

Sintaxis:
StateName ()
Los estados alternos solo se pueden definir y asignar con Qlik Engine API.

Ejemplo 1:
Texto Dinmico
='Region - ' & if(StateName() = '$', 'Default', StateName())

Ejemplo 2:
Colores Dinmicos
if(StateName() = 'Group 1', rgb(152, 171, 206),
if(StateName() = 'Group 2', rgb(187, 200, 179),
rgb(210, 210, 210)
)
)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

668

5 Funciones en scripts y en expresiones de grfico

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 solo puede
utilizarse en una expresin 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
La funcin de script FieldName 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 (field_number ,table_name)


FieldNumber
La funcin de script FieldNumber 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_name ,table_name)


NoOfFields
La funcin de script NoOfFields 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 (table_name)
NoOfRows
La funcin NoOfRows 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 (table_name)
NoOfTables
Esta funcin de script devuelve el nmero de tablas previamente cargadas.

NoOfTables()

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

669

5 Funciones en scripts y en expresiones de grfico


TableName
Esta funcin de script devuelve el nombre de la tabla con el nmero especificado.

TableName(table_number)
TableNumber
Esta funcin de script devuelve el nmero de la tabla especificada. La primera tabla tiene el nmero 0.
Si table_name no existe, devuelve NULL.

TableNumber(table_name)
Ejemplo:
En este ejemplo, queremos crear una tabla con informacin sobre las tablas y los campos que se han
cargado.
Primero, cargamos algunos datos de ejemplo. Esto crea las dos tablas que usaremos para ilustrar las
funciones de tabla descritas en esta seccin.
Characters:
Load Chr(RecNo()+Ord('A')-1) as Alpha, RecNo() as Num autogenerate 26;
ASCII:
Load
if(RecNo()>=65 and RecNo()<=90,RecNo()-64) as Num,
Chr(RecNo()) as AsciiAlpha,
RecNo() as AsciiNum
autogenerate 255
Where (RecNo()>=32 and RecNo()<=126) or RecNo()>=160 ;

A continuacin, iteramos a travs de las tablas que hemos cargado, usando la funcin NoOfTables, y
despus a travs de los campos de cada tabla, usando la funcin NoOfFields y la informacin de carga
usando las funciones de la tabla.
//Iterate through the loaded tables
For t = 0 to NoOfTables() - 1
//Iterate through the fields of table
For f = 1 to NoOfFields(TableName($(t)))
Tables:
Load
TableName($(t)) as Table,
TableNumber(TableName($(t))) as TableNo,
NoOfRows(TableName($(t))) as TableRows,
FieldName($(f),TableName($(t))) as Field,
FieldNumber(FieldName($(f),TableName($(t))),TableName($(t))) as FieldNo
Autogenerate 1;
Next f
Next t;

La tabla resultante, Tables, tendr el siguiente aspecto:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

670

5 Funciones en scripts y en expresiones de grfico


Table

TableNo

TableRows

Field

FieldNo

Characters

26

Alpha

Characters

26

Num

ASCII

191

Num

ASCII

191

AsciiAlpha

ASCII

191

AsciiNum

FieldName
La funcin de script FieldName 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(field_number ,table_name)
Argumentos:
Argumento

Descripcin

field_number

El nmero de campo al que desee hacer referencia.

table_name

La tabla que contiene el campo al que desea hacer referencia.

Ejemplo:
LET a = FieldName(4,'tab1');

FieldNumber
La funcin de script FieldNumber 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_name ,table_name)
Argumentos:
Argumento

Descripcin

field_name

El nombre del campo.

table_name

El nombre de la tabla que contiene el campo.

Si el campo field_name no existe en table_name o table_name no existe, la funcin devuelve 0.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

671

5 Funciones en scripts y en expresiones de grfico


Ejemplo:
LET a = FieldNumber('Customer','tab1');

NoOfFields
La funcin de script NoOfFields 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(table_name)
Argumentos:
Argumento

Descripcin

table_name

El nombre de la tabla.

Ejemplo:
LET a = NoOfFields('tab1');

NoOfRows
La funcin NoOfRows 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(table_name)
Argumentos:
Argumento

Descripcin

table_name

El nombre de la tabla.

Ejemplo:
LET a = NoOfRows('tab1');

5.25 Funciones trigonomtricas e hiperblicas


En esta seccin se describen funciones para realizar operaciones trigonomtricas e hiperblicas. En todas
las funciones, los argumentos son expresiones que devuelven ngulos medidos en radianes, donde x debe
interpretarse como un valor real.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

672

5 Funciones en scripts y en expresiones de grfico


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
Coseno inverso de x. La funcin solo se define si -1x1. El resultado es un nmero entre 0 y .

acos( x )
sin
Seno de x. El resultado es un nmero entre -1 y 1.

sin( x )
asin
Seno inverso de x. La funcin solo se define si -1x1. El resultado es un nmero entre - /2 y /2.

asin( x )
tan
Tangente de x. El resultado es un nmero real.

tan( x )
atan
Tangente inversa de x. El resultado es un nmero entre - /2 y /2.

atan( x )
atan2
Generalizacin bidimensional de la funcin tangente inversa. Devuelve el ngulo entre el origen y el punto
representado por las coordenadas x e y. El resultado es un nmero entre - y + .

atan2( y,x )
cosh
Coseno hiperblico de x. El resultado es un nmero real positivo.

cosh( x )
sinh
Seno hiperblico de x. El resultado es un nmero real.

sinh( x )

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

673

5 Funciones en scripts y en expresiones de grfico


tanh
Tangente hiperblico de x. El resultado es un nmero real.

tanh( x )
Ejemplos:
El siguiente cdigo de script carga una tabla de muestra y a continuacin carga una tabla que contiene las
operaciones trigonomtricas e hiperblicas sobre los valores.
SampleData:
LOAD * Inline
[Value
-1
0
1];
Results:
Load *,
cos(Value),
acos(Value),
sin(Value),
asin(Value),
tan(Value),
atan(Value),
atan2(Value, Value),
cosh(Value),
sinh(Value),
tanh(Value)
RESIDENT SampleData;
Drop Table SampleData;

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

674

6 Restriccin de acceso al sistema de archivos

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.

No se puede deshabilitar el modo estndar en Qlik Sense Cloud.

6.1

Aspectos de seguridad al conectar a conexiones de


datos de ODBC y OLE DB basados en archivos

Las conexiones de datos ODBC y OLE DB que utilizan drivers basados en archivos mostrarn la ruta al
archivo de datos conectado en la cadena de conexin. La ruta se puede exponer cuando la conexin se edite,
en el dilogo de seleccin de datos, o en determinadas consultas SQL. Este es el caso tanto en el modo
estndar como en el modo de legado.

Si exponer la ruta al archivo de datos supone un problema, se recomienda conectarse al


archivo de datos empleando una conexin de datos de carpeta, si fuera posible.

6.2

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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

675

6 Restriccin de acceso al sistema de archivos


Variables de sistema
Variable

Modo estndar / Qlik


Sense Cloud

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 CDROM 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
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

676

6 Restriccin de acceso al sistema de archivos


Variable
$(include=...)

Modo estndar / Qlik

Modo de legado

Definicin

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La variable
Include/Must_Include

Modo de legado

Definicin

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La sentencia binary se

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La sentencia
CONNECT sirve para

Sense Cloud
Datos de entrada que
admite: Conexin a la
librera

especifica un archivo
que contiene un texto
que debe ser incluido en
el script y evaluado
como cdigo de script.
Puede almacenar partes
de su cdigo de script en
un archivo de texto
aparte y reutilizarlo en
diversas apps. Esta es
una variable definida por
el usuario.

Sentencias de script habituales


Sentencia
Binary

Connect

Modo estndar / Qlik


Sense Cloud

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

usa para cargar datos


desde otra app.

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.

677

6 Restriccin de acceso al sistema de archivos


Sentencia
Directory

Modo estndar / Qlik


Sense Cloud
Datos de entrada que
admite: Conexin a la
librera

Modo de legado

Definicin

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La sentencia Directory
define en qu directorio
buscar archivos de datos
en subsiguientes
sentencias LOAD,
hasta que se incluya una
nueva sentencia
Directory.

Execute

No admitido

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

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

LOAD from ...

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Devuelve la cadena de
bsqueda al ejecutable
de Qlik Sense:

Store into ...

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Devuelve el directorio
raz del ejecutable de
Qlik Sense:

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

678

6 Restriccin de acceso al sistema de archivos


Sentencias de control de script
Sentencia
For each...
filelist mask/dirlist mask

Modo estndar / Qlik


Sense Cloud
Datos de entrada que
admite: Conexin a la
librera
Datos que devuelve:
Conexin a la librera

Modo de legado

Definicin

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La sintaxis filelist mask


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

Datos que devuelve:


Conexin a la librera o
la ruta absoluta,
dependiendo de los
datos de entrada.

La sintaxis dirlist mask


produce una lista de
todos los directorios en
el directorio actual,
separados por coma,
que coincidan con la
mscara de nombre de
archivo.

Funciones de archivo
Funcin

Modo estndar / Qlik


Sense Cloud

Modo de legado

Definicin

Attribute()

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Devuelve el valor de las


meta etiquetas de
diversos archivos de
medios como texto.

ConnectString()

Datos que devuelve:


Nombre de la conexin a
la librera

Nombre de la conexin
de librera o conexin
actual, dependiendo de
la entrada

Devuelve la cadena de
conexin para una
conexin ODBC u OLE
DB.

FileDir()

Datos que devuelve:


Conexin a la librera

Datos que devuelve:


Conexin a la librera o
la ruta absoluta,
dependiendo de los
datos de entrada.

La funcin FileDir

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

devuelve una cadena


que contiene la ruta al
directorio del archivo de
tabla que se est
leyendo en ese
momento.

679

6 Restriccin de acceso al sistema de archivos


Funcin
FilePath()

FileSize()

FileTime()

Modo estndar / Qlik

Modo de legado

Definicin

Datos que devuelve:


Conexin a la librera

Datos que devuelve:


Conexin a la librera o
la ruta absoluta,
dependiendo de los
datos de entrada.

La funcin FilePath

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La funcin FileSize

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

La funcin FileTime

Sense Cloud

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

devuelve una cadena


que contiene la ruta
completa al archivo de
tabla que se est
leyendo en ese
momento.

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.

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.

680

6 Restriccin de acceso al sistema de archivos


Funcin
GetFolderPath()

Modo estndar / Qlik


Sense Cloud
No admitido

Modo de legado

Definicin

Datos que devuelve:


Ruta absoluta

La funcin
GetFolderPath
devuelve el valor de la
funcin de Microsoft
Windows

SHGetFolderPath. Esta
funcin toma como
entrada el nombre de
una carpeta Microsoft
Windows y devuelve la
ruta completa a la
carpeta.
QvdCreateTime()

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Esta funcin de script


devuelve la fecha y hora
de la cabecera XML
desde un archivo QVD
si lo hubiere; si no,
devuelve NULL.

QvdFieldName()

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Esta funcin de script


devuelve el nombre del
campo nmero fieldno,
si ste existe en un
archivo QVD (si no,
devuelve NULL).

QvdNoOfFields()

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Esta funcin de script


devuelve el nmero de
campos de un archivo
QVD.

QvdNoOfRecords()

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Esta funcin de script


devuelve el nmero de
registros que se
encuentran actualmente
en un archivo QVD.

QvdTableName()

Datos de entrada que


admite: Conexin a la
librera

Datos de entrada que


admite: Conexin a la
librera o ruta
absoluta/relativa

Esta funcin de script


devuelve el nombre de
la tabla almacenada en
un archivo QVD.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

681

6 Restriccin de acceso al sistema de archivos


Funciones de sistema
Modo estndar / Qlik

Funcin

Sense Cloud

Modo de legado

Definicin

DocumentPath()

No admitido

Datos que devuelve:


Ruta absoluta

Esta funcin devuelve


una cadena que
contiene la ruta
completa a la app actual
de Qlik Sense.

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.

6.3

Deshabilitar el modo estndar

Podemos deshabilitar el modo estndar, o en otras palabras, establecer un modo de legado, para poder
reutilizar scripts de carga de QlikView que se refieren 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.

No se puede deshabilitar el modo estndar en Qlik Sense Cloud.

Qlik Sense
Para Qlik Sense, el modo estndar puede deshabilitarse en QMC utilizando la propiedad de Modo

estndar.

Qlik Sense Desktop


En Qlik Sense Desktop, podemos establecer el modo estndar/de legado en Settings.ini.
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.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

682

6 Restriccin de acceso al sistema de archivos


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)

0 (modo de legado)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

683

7 Funciones y sentencias de QlikView no admitidas en Qlik Sense

Funciones y sentencias de QlikView no


admitidas en Qlik Sense

La mayora de las funciones y sentencias se pueden usar en scripts de carga de QlikView, y las expresiones
de grficos tambin son compatibles en Qlik Sense, aunque hay algunas excepciones, tal y como se describe
aqu.

7.1

Sentencias de script no admitidas en Qlik Sense

Esta lista describe las sentencias de script de QlikView no admitidas en Qlik Sense.

Sentencia

Comentarios

Command

Utilice SQL en su lugar.

InputField

7.2

Funciones no admitidas en Qlik Sense

Esta lista describe las sentencias de script de QlikView y las funciones de grfico no admitidas en Qlik
Sense.
l

GetCurrentField

GetExtendedProperty

Input

InputAvg

InputSum

MsgBox

NoOfReports

ReportComment

ReportId

ReportName

ReportNumber

7.3

Prefijos no admitidos en Qlik Sense

Esta lista describe los prefijos de QlikView no admitidos en Qlik Sense.


l

Bundle

Image_Size

Info

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

684

8 Funciones y sentencias no recomendadas en Qlik Sense

Funciones y sentencias no recomendadas en


Qlik Sense

La mayora de las funciones y sentencias que pueden utilizarse en los scripts de carga y las expresiones de
grficos de QlikView tambin se admiten en Qlik Sense, pero en algunas ocasiones su uso no se recomienda
en Qlik Sense. Por razones de compatibilidad siguen funcionando de la forma prevista, pero se recomienda
actualizar el cdigo segn las recomendaciones de esta seccin, porque podran eliminarse en versiones
futuras.

8.1

Sentencias de script no recomendadas en Qlik Sense

Esta lista describe las sentencias de script de QlikView cuyo uso no se recomienda en Qlik Sense.

Sentencia

Recomendacin

Command

Utilice SQL en su lugar.

CustomConnect

Utilice Custom Connect en su lugar.

8.2

Parmetros de sentencias de script no


recomendados en Qlik Sense

Esta lista describe los parmetros de las sentencias de script de QlikView cuyo uso no se recomienda en Qlik
Sense.

Sentencia

Parmetros

Buffer

Utilice Incremental en lugar de:


l

Inc (no recomendado)

Incr (no recomendado)

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

685

8 Funciones y sentencias no recomendadas en Qlik Sense


Sentencia

Parmetros

LOAD

Los asistentes de transformacin de archivos de QlikView generan las siguientes palabras


clave de parmetros. La funcionalidad se conserva cuando vuelven a cargarse los datos, pero
Qlik Sense no ofrece soporte guiado/asistentes para generar la sentencia con estos
parmetros:

8.3

Bottom

Cellvalue

Col

Colmatch

Colsplit

Colxtr

Compound

Contain

Equal

Every

Expand

Filters

Intarray

Interpret

Length

Longer

Numerical

Pos

Remove

Rotate

Row

Rowcnd

Shorter

Start

Strcnd

Top

Transpose

Unwrap

Funciones no recomendadas en Qlik Sense

Esta lista describe las funciones de script y de grfico de QlikView cuyo uso no se recomienda en Qlik Sense.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

686

8 Funciones y sentencias no recomendadas en Qlik Sense


Funcin

Recomendacin

NumAvg

Utilice funciones range en su lugar.

NumCount

Vea: Funciones de rango (pgina 598)

NumMax
NumMin
NumSum
QliktechBlue

Utilice otras funciones de color en su lugar. QliktechBlue() puede sustituirse por

QliktechGray

RGB(8, 18, 90) y QliktechGray puede sustituirse por RGB(158, 148, 137) para
obtener los mismos colores.
Vea: Funciones de color (pgina 352)

QlikViewVersion

Utilice ProductVersion en su lugar.


Vea: ProductVersion (pgina 668)

QVUser
Year2Date

Utilice YearToDate en su lugar.

Vrank

Utilice Rank en su lugar.

WildMatch5

Utilice WildMatch en su lugar.

Cualificador ALL
En QlikView, el cualificador ALL puede aparecer antes de una expresin. Esto equivale a usar {1} TOTAL.
En tal caso, el clculo se har sobre todos los valores de campo del documento, descartando las
dimensiones del grfico y las selecciones actuales. Siempre devuelve el mismo valor, independientemente
del estado lgico del documento. Si se emplea el cualificador ALL, no se podr utilizar una expresin de
conjunto, puesto que el cualificador ALL ya define un conjunto por s mismo. Por razones de legado, o
herencia, el cualificador ALL an funciona en esta versin de Qlik Sense, pero pudiera ser eliminado en
versiones futuras.

Sintaxis de script y funciones de grficos - Qlik Sense, 3.0

687

Potrebbero piacerti anche