Documentos de Académico
Documentos de Profesional
Documentos de Cultura
de grficos
Qlik Sense
1.1
Copyright 1993-2015 QlikTech International AB. Reservados todos los derechos.
Contenidos
1 Qu es Qlik Sense?
18
18
18
Modelo de apps
La experiencia asociativa
Colaboracin y movilidad
1.3 Cmo puede desplegar Qlik Sense?
18
18
18
19
19
19
19
19
19
19
19
19
20
20
20
21
22
22
23
25
26
26
28
30
31
33
33
34
37
38
39
40
40
41
41
43
44
44
45
46
48
49
Contenidos
Left
Mapping
NoConcatenate
Outer
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
TableFormat
Delimiter
No eof
Labels
Header is
Record is
Quotes
XML
KML
Let
Map
NullAsNull
NullAsValue
Qualify
50
51
52
52
53
55
55
56
56
57
57
63
64
65
66
67
68
68
70
71
73
76
78
78
79
79
80
81
81
82
88
88
89
90
90
91
92
92
93
94
94
94
95
96
96
97
Contenidos
Rem
Rename field
Rename table
Search
Section
Select
Set
Sleep
SQL
SQLColumns
SQLTables
SQLTypes
Star
Store
Tag
Trace
Unmap
Unqualify
Untag
2.4 Trabajar con variables en el editor de carga de script
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
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
98
99
99
100
101
101
104
104
105
105
106
107
108
108
110
111
111
112
112
113
114
115
115
117
117
118
118
118
119
119
119
120
120
120
121
121
122
122
122
122
124
124
124
125
125
Contenidos
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
125
126
126
126
126
127
127
127
128
128
128
128
129
130
131
132
132
132
133
134
134
134
136
136
138
139
139
139
139
140
141
142
142
142
143
143
144
145
145
146
146
146
148
149
Contenidos
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
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
149
149
149
149
152
152
152
153
154
155
157
158
160
161
164
164
166
167
169
170
171
171
172
173
174
176
177
179
180
181
182
184
185
187
187
187
188
189
191
192
193
194
195
197
198
Contenidos
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
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
198
201
204
205
207
208
210
211
213
214
216
217
218
219
220
220
222
222
224
225
226
226
228
228
230
230
232
233
234
235
236
237
239
240
242
243
245
246
248
249
250
251
251
252
253
253
Contenidos
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
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
253
253
254
254
255
256
257
261
262
263
264
265
266
267
268
269
270
272
273
274
275
276
277
278
279
280
281
282
282
283
284
285
286
287
287
288
289
290
291
292
294
295
296
296
297
298
Contenidos
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 en cadena
Funciones de agregacin en cadena 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
299
300
301
302
303
304
305
306
307
307
310
311
315
317
317
318
318
319
321
322
323
324
326
327
328
329
330
331
332
332
334
335
336
336
337
337
338
338
340
340
341
341
342
342
342
10
Contenidos
autonumber
autonumberhash128
autonumberhash256
fieldvaluecount
IterNo
RecNo
RowNo
RowNo - funcin de grfico
5.5 Funciones de fecha y hora
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
GMT
hour
inday
indaytotime
inlunarweek
inlunarweektodate
inmonth
inmonths
inmonthstodate
inmonthtodate
inquarter
inquartertodate
inweek
inweektodate
344
346
348
351
351
352
353
354
356
356
357
358
358
358
359
359
360
361
364
365
366
366
367
369
370
371
371
373
374
375
377
378
378
378
380
381
383
384
386
388
390
391
392
394
395
11
Contenidos
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
weekend
weekname
weekstart
weekyear
year
yearend
yearname
yearstart
yeartodate
5.6 Funciones exponenciales y logartmicas
397
398
400
401
402
403
405
406
407
407
408
408
409
410
411
413
415
416
417
419
420
421
423
424
425
426
427
427
428
428
429
430
431
433
435
435
436
437
439
440
441
443
444
Funciones de contador
Funciones de campo y seleccin
444
445
12
Contenidos
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
445
446
447
449
450
450
452
453
453
455
462
462
463
463
463
464
464
465
466
466
467
468
469
470
470
471
471
472
473
474
475
476
476
477
478
479
479
480
481
481
482
483
483
484
484
13
Contenidos
Funciones de paridad
Funciones de redondeo
BitCount
Ceil
Combin
Div
Even
Fabs
Fact
Floor
Fmod
Frac
Mod
Odd
Permut
Round
Sign
5.12 Funciones geogrficas
484
485
485
485
486
486
487
487
488
488
489
489
490
490
491
491
492
492
493
493
494
495
496
496
497
498
498
499
499
500
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
500
501
502
502
503
504
508
512
516
518
518
520
522
524
525
14
Contenidos
NoOfRows - funcin de grfico
Peek
Previous
Top - funcin de grfico
Secondarydimensionality
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
527
528
530
531
535
535
537
538
538
539
540
540
541
541
542
543
545
545
546
546
547
548
548
549
549
550
551
553
554
556
558
559
560
562
563
565
567
568
570
571
573
574
575
576
578
15
Contenidos
RangeTextCount
RangeXIRR
RangeXNPV
5.20 Funciones de ranking en grficos
580
581
583
584
584
587
589
589
590
590
591
592
592
593
594
594
595
595
598
599
599
599
600
600
600
601
601
601
602
602
602
603
603
604
604
604
605
605
605
606
606
606
607
607
607
16
Contenidos
GetObjectField - funcin de grfico
ProductVersion
StateName - funcin de grfico
5.24 Funciones de tabla
609
609
610
610
610
612
613
613
614
614
617
617
617
Variables de sistema
Sentencias de script habituales
Sentencias de control de script
Funciones de archivo
Funciones de sistema
6.2 Deshabilitar el modo estndar
617
618
619
620
622
623
Qlik Sense
Qlik Sense Desktop
7 Funciones y sentencias de QlikView no admitidas en Qlik Sense
623
623
624
624
624
625
625
625
626
Cualificador ALL
627
17
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 equipos o en toda la
empresa. Qlik Sense nos permite formular y responder nuestras propias preguntas, as como seguir nuestro
propio camino de investigacin e indagacin en los datos. Qlik Sense nos permite a nosotros y a nuestros
colegas llegar a las decisiones de manera conjunta.
1.1
La mayora de productos de Business Intelligence (BI) ayudan a las personas a responder preguntas que ya
se comprenden de antemano. Pero qu ocurre con las preguntas que se nos van ocurriendo despus o
sobre la marcha? Ese tipo de preguntas que surgen tras leer un informe o visualizar un grfico? Con la
experiencia asociativa de Qlik Sense, podemos hacer todas las preguntas que se nos ocurran y responderlas
una tras otra, avanzando por nuestra propia ruta hacia el conocimiento. Con Qlik Sense podemos explorar
los datos libremente, mediante simples clics de ratn, aprendiendo y profundizando en cada etapa del
camino y descubriendo nuevas rutas de exploracin basadas en nuestros propios descubrimientos.
1.2
Qlik Sense genera vistas de informacin sobre la marcha. Qlik Sense no requiere informes predefinidos o
estticos ni que el usuario dependa de otros departamentos o usuarios, tan solo hacemos clic y aprendemos
cosas. Cada vez que un usuario hace clic, Qlik Sense responde al instante, actualizando cada visualizacin y
vista de Qlik Sense en la app con un nuevo conjunto de datos recin calculados y visualizaciones especficas
a lo que le interesa al usuario.
Modelo de 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 responder a
18
1 Qu es Qlik Sense?
nuestras propias preguntas, seguir haciendo preguntas posteriores de seguimiento, implicar a amigos y
colegas, en cualquier lugar en que nos encontremos.
1.3
Hay dos versiones de Qlik Sensedisponibles para su despliegue, Qlik Sense Desktop y Qlik Sense Server.
1.4
Con Qlik Management Console podemos configurar, gestionar y monitorizar sitios Qlik Sense de una forma
fcil e intuitiva. Podemos gestionar las licencias, el acceso y las normas de seguridad, configurar los nodos y
las conexiones de origen de datos, as como sincronizar el contenido y los usuarios, entre muchas otras
actividades y recursos.
1.5
Qlik Sense le proporciona APIs y SDKs flexibles para desarrollar sus propias extensiones y adaptar e integrar
Qlik Sense con fines muy diversos como, por ejemplo:
Construir clientes
Puede construir clientes en .NET e incrustar objetos Qlik Sense en sus propias aplicaciones. Tambin puede
construir clientes nativos en cualquier lenguaje de programacin que admita la comunicacin WebSocket
mediante el protocolo de cliente de Qlik Sense.
19
2 Sintaxis de script
Sintaxis de script
2.1
En el script se define el nombre de la fuente de datos, los nombres de las tablas y los nombres de los
campos incluidos en la lgica. Adems, estn definidos en el script los campos definidos en los derechos de
acceso.
El script consta de una serie de sentencias que se ejecutan de manera consecutiva.
La sintaxis de la lnea de comandos de Qlik Sense y la sintaxis de script se describen en una notacin
denominada formalismo Backus-Naur o cdigo BNF.
Las primeras lneas de cdigo ya se generan al crearse un nuevo archivo de Qlik Sense. Los valores por
defecto de estas variables de interpretacin numrica se derivan de las configuraciones regionales del
sistema operativo.
En el script se define el nombre de la fuente de datos, los nombres de las tablas y los nombres de los
campos incluidos en la lgica. El script consta de una serie de sentencias de script y palabras clave que se
ejecutan de manera consecutiva.
Para un archivo de tabla con comas, tabuladores o puntos y coma empleados como delimitador, puede
usarse la sentencia LOAD. Por defecto, la sentencia LOAD es la que carga todos los campos del archivo.
Se debe acceder a una base de datos general mediante Microsoft Microsoft ODBC. Aqu se emplean
sentencias SQL estndar. La sintaxis SQL aceptada difiere segn los distintos drivers ODBC.
Todas las sentencias de script deben terminar con un punto y coma " ;".
Se puede acceder a una descripcin ms detallada de la sintaxis de script pulsando en los temas de esta
seccin.
2.2
Qu es el formalismo Backus-Naur?
La sintaxis de la lnea de comandos de Qlik Sense y la sintaxis 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:
()
[]
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
20
2 Sintaxis de script
ejemplo, combinaciones de los de arriba, otros smbolos no concluyentes, cadenas de
texto, etc.
::=
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:
2.3
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.
21
2 Sintaxis de script
Todas las palabras clave del script pueden escribirse con cualquier combinacin de maysculas o
minsculas. Los nombres de campo y de variable utilizados en las sentencias, por supuesto, son sensibles a
maysculas.
Call
La sentencia de control call llama a una subrutina que debe ser definida por una sentencia sub previa.
22
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.
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.
Call
La sentencia de control call llama a una subrutina que debe ser definida por una sentencia sub previa.
23
2 Sintaxis de script
Sintaxis:
Call name ( [ paramlist ])
Argumentos:
Argumento
Descripcin
name
El nombre de la subrutina.
paramlist
Una lista separada por comas de los parmetros que se habrn de enviar a
la subrutina. Cada elemento de la lista puede ser un nombre de campo,
una variable o una expresin arbitraria.
La subrutina invocada mediante una sentencia call debe ir definida por un sub encontrado anteriormente
durante la ejecucin del script.
Los parmetros se copian en la subrutina y, si el parmetro en la sentencia call es una variable y no una
expresin, se copia de nuevo fuera, al salir de la subrutina.
Limitaciones:
Como la sentencia call es una sentencia de control y, como tal, termina con un punto y coma o fin de lnea,
no deber sobrepasar el lmite de una lnea.
Ejemplo1:
// Example 1
Sub INCR (I,J)
I = I + 1
Exit Sub when I < 10
J = J + 1
End Sub
Call INCR (X,Y)
Ejemplo2:
// Example 2 - List all QV related files on disk
sub DoDir (Root)
For Each Ext in 'qvw', 'qvo', 'qvs', 'qvt', 'qvd', 'qvc', 'qvf'
For Each File in filelist (Root&'\*.' &Ext)
LOAD
'$(File)' as Name, FileSize( '$(File)' ) as
Size, FileTime( '$(File)' ) as FileTime
autogenerate 1;
24
2 Sintaxis de script
Next File
Next Ext
For Each Dir in dirlist (Root&'\*' )
Call DoDir (Dir)
Next Dir
End Sub
Call DoDir ('C:')
Do..loop
La sentencia de control do..loop crea un bucle que ejecuta una o varias sentencias hasta cumplirse una
condicin lgica.
Sintaxis:
Do [ ( while | until ) condition ] [statements]
[exit do [ ( when | unless ) condition ] [statements]
loop[ ( while | until ) condition ]
Como la sentencia do..loop es una sentencia de control y como tal termina con un punto y
coma o con un final de lnea, cada una de sus tres clusulas posibles (do,exit do y loop) no
debe sobrepasar el lmite de una lnea.
Argumentos:
Argumento
Descripcin
condition
statements
while / until
La clusula condicional while o until solo debe aparecer una vez en cualquier sentencia
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;
25
2 Sintaxis de script
Let a=a+1;
Loop
Exit script
Esta sentencia de control detiene la ejecucin del script. Puede insertarse en cualquier parte del script.
Sintaxis:
Exit Script [ (when | unless) condition ]
Como la sentencia exit script es una sentencia de control y, como tal, termina con un punto y coma o fin de
lnea, no deber sobrepasar el lmite de una lnea.
Argumentos:
Argumento
Descripcin
condition
when
/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.
26
2 Sintaxis de script
Si se encuentra una clusula exit for dentro del bucle, la ejecucin del script ser transferida a la primera
sentencia tras la clusula next que indica el final del bucle. Una clusula exit for puede hacerse condicional
mediante el uso opcional de un sufijo when o unless.
Como la sentencia for..next es una sentencia de control y como tal termina con un punto y
coma o con un final de lnea, cada una de sus tres clusulas posibles (for..to..step,exit for y
next) no debe sobrepasar el lmite de una lnea.
Argumentos:
Argumento
Descripcin
counter
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
statements
27
2 Sintaxis de script
For each..next
La sentencia de control for each..next crea un bucle que ejecuta una o varias sentencias para cada valor en
una lista separada por comas. Las sentencias que estn dentro del bucle, entre for y next se ejecutarn con
cada valor de la lista.
Sintaxis:
La sintaxis especial hace posible generar listas con los nombres de archivo y directorio en el directorio actual.
Descripcin
var
Es un nombre de variable de script que adquirir un nuevo valor de lista para cada
ejecucin del bucle. Si se especifica var despus de next deber tener el mismo nombre
de variable que el encontrado despus del for each correspondiente.
El valor de la variable var puede ser modificado por sentencias dentro del bucle, pero no es una buena
prctica de programacin.
Si se encuentra una clusula exit for dentro del bucle, la ejecucin del script ser transferida a la primera
sentencia tras la clusula next que indica el final del bucle. Una clusula exit for puede hacerse condicional
mediante el uso opcional de un sufijo when o unless.
Como la sentencia for each..next es una sentencia de control y como tal termina con punto y
coma o con un final de lnea, cada una de sus tres clusulas posibles (for each, exit for y
next) no debe sobrepasar el lmite de una lnea.
Sintaxis:
list := item { , item }
item := constant | (expression) | filelist mask | dirlist mask |
fieldvaluelist mask
Argumento
Descripcin
constant
28
2 Sintaxis de script
Argumento
Descripcin
como una variable y entonces se utilizar el valor de dicha variable. Los nmeros no tienen
que ir entre comillas simples.
expression
mask
Es una mscara de nombre de archivo o de carpeta que puede incluir cualquier carcter
vlido de nombre de archivo, as como los caracteres comodn * y ? estndares.
Puede utilizar rutas de archivo absolutas o rutas lib://.
condition
statements
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.
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.
Esta sintaxis se repite a lo largo de los valores de un campo ya cargado en Qlik Sense.
29
2 Sintaxis de script
autogenerate 1;
next File
next Ext
for each Dir in dirlist (Root&'\*' )
call DoDir (Dir)
next Dir
end sub
call DoDir ('lib://MyData')
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 340) (funcin de script y de grfico)
Sintaxis:
If
condition then
30
2 Sintaxis de script
[ statements ]
{ elseif condition then
[ statements ] }
[ else
[ statements ] ]
end if
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
Ejemplo1:
if a=1 then
LOAD * from abc.csv;
SQL SELECT e, f, g from tab1;
end if
Ejemplo2:
if a=1 then; drop table xyz; end if;
Ejemplo3:
if x>0 then
LOAD * from pos.csv;
elseif x<0 then
LOAD * from neg.csv;
else
LOAD * from zero.txt;
end if
Sub..end sub
La sentencia de control sub..end sub define una subrutina, la cual puede ser invocada mediante una
sentencia call.
Sintaxis:
31
2 Sintaxis de script
Sub name [ ( paramlist )] statements end sub
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
Ejemplo1:
Sub INCR (I,J)
I = I + 1
Exit Sub when I < 10
J = J + 1
End Sub
Call INCR (X,Y)
32
2 Sintaxis de script
Switch..case..default..end switch
La sentencia de control switch es una construccin de script que obliga a que la ejecucin del script siga
diferentes caminos dependiendo del valor de una expresin.
Sintaxis:
Switch expression {case valuelist [ statements ]} [default statements] end
switch
Como la sentencia switch es una sentencia de control y como tal termina con 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
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
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 maysculas o
minsculas. Los nombres de campo y de variable utilizados en las sentencias, por supuesto, son sensibles a
maysculas.
33
2 Sintaxis de script
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.
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.
34
2 Sintaxis de script
Hierarchy (NodeID, ParentID, NodeName, [ParentName], [PathSource],
[PathName], [PathDelimiter], [Depth])(loadstatement | selectstatement)
HierarchBelongsTo
Este prefijo se utiliza para transformar una tabla jerrquica en una tabla que sea til en un modelo de datos
de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y almacenar el
resultado de la sentencia de carga como info de entrada para una transformacin de tabla.
35
2 Sintaxis de script
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.
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.
36
2 Sintaxis de script
Sample
El prefijo sample en una sentencia LOAD o SELECT se usa para cargar una muestra aleatoria de registros
desde la tabla fuente.
Buffer
Los archivos QVD se pueden crear y mantener de forma automtica mediante el prefijo buffer. Este prefijo
puede utilizarse en la mayora de sentencias LOAD y SELECT en el script. Indica que los archivos QVD se
utilizan para enviar a cach el resultado de la sentencia.
Sintaxis:
Buffer [(option [ , option])] ( loadstatement | selectstatement )
option::= incremental | stale [after] amount [(days | hours)]
Si no se utiliza ninguna opcin, el buffer QVD creado por la primera ejecucin del script se usar
indefinidamente.
Los buffers QVD por lo general son eliminados cuando ya no se les hace referencia alguna a lo largo de una
ejecucin completa de script en el documento que los cre, o cuando el documento que los cre ya no existe.
Argumentos:
Argumento
Descripcin
incremental
37
2 Sintaxis de script
Argumento
Descripcin
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)]
Limitaciones:
Existen ciertas limitaciones, siendo la ms destacada que debe haber o bien una sentencia LOAD o una
Ejemplo2:
Buffer (stale after 7 days) SELECT * from MyTable;
Ejemplo3:
Buffer (incremental) LOAD * from MyLog.log;
Bundle
El prefijo Bundle sirve para incluir archivos externos, por ej. archivos de imagen o sonido, u objetos
conectados a un valor de campo, para que se almacenen en el archivo qvf.
Sintaxis:
Bundle [Info] ( loadstatement | selectstatement)
38
2 Sintaxis de script
Para mantener la portabilidad, puede que desee incluir algunos archivos externos en el archivo mismo .qvf.
Para este fin, podemos utilizar el prefijo Bundle. Los archivos con info bundle sern comprimidos durante el
proceso, pero aun as ocuparn un espacio adicional en el archivo y en la RAM. Por lo tanto, tenga en cuenta
el tamao y el nmero de archivos que desee incluir antes de optar por esta solucin.
El prefijo info puede referenciarse desde el diseo como una informacin normal, mediante la funcin info de
grficos, o como un archivo interno mediante la sintaxis especial qmem:// fieldname / fieldvalue o tambin
qmem:// fieldname / < index > donde index es el ndice interno de un valor de campo.
Argumentos:
Argumento
Descripcin
Info
Si una parte de informacin externa como, por ejemplo, una imagen o un archivo de
sonido, se va a conectar a un valor de un campo, esto se hace en una tabla cargada
mediante el prefijo Info.
El prefijo Info puede omitirse cuando se emplee Bundle.
Ejemplo:
Bundle Info LOAD * From flagoecd.csv;
Bundle SQL SELECT * from infotable;
Concatenate
Si dos tablas que van a ser concatenadas tienen diferentes conjuntos de campos, se puede obligar a la
concatenacin de ambas mediante el prefijo Concatenate. Esta sentencia fuerza la concatenacin con una
tabla designada que ya existe, o con la ltima tabla lgica previamente creada.
Sintaxis:
Concatenate[ (tablename ) ] ( loadstatement | selectstatement )
Una concatenacin es en principio lo mismo que una sentencia SQL UNION, pero con dos diferencias:
l
El prefijo Concatenate puede utilizarse independientemente de que las tablas tengan nombres de
campo idnticos o no.
Argumentos:
Argumento
Descripcin
tablename
Ejemplo:
Concatenate LOAD * From file2.csv;
Concatenate SELECT * From table3;
39
2 Sintaxis de script
tab1:
LOAD * From file1.csv;
tab2:
LOAD * From file2.csv;
.. .. ..
Concatenate (tab1) LOAD * From file3.csv;
Crosstable
El prefijo crosstable sirve para convertir una tabla cruzada en una tabla simple.
Sintaxis:
crosstable (attribute field name, data field name [ , n ] ) ( loadstatement
| selectstatement )
Argumentos:
Argumento
Descripcin
attribute field
name
data field
name
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:
40
2 Sintaxis de script
Argumento
Descripcin
Generic
La apertura y carga de una base de datos genrica puede hacerse mediante el prefijo generic.
Sintaxis:
Generic( loadstatement | selectstatement )
Ejemplos:
Generic LOAD * from abc.csv;
Generic SQL SELECT * from table1;
Hierarchy
El prefijo hierarchy sirve para transformar una tabla jerrquica en una tabla que sea til en un modelo de
datos de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y
almacenar el resultado de la sentencia de carga como info de entrada para una transformacin de tabla.
Sintaxis:
Hierarchy (NodeID, ParentID, NodeName, [ParentName], [PathSource],
[PathName], [PathDelimiter], [Depth])(loadstatement | selectstatement)
La tabla de entrada debe ser una tabla de nodos adyacentes. Las tablas de nodos adyacentes son tablas en
las que cada registro se corresponde con un nodo y tiene un campo que contiene una referencia al nodo
padre. En este tipo de tabla, el nodo se almacena en un nico registro, pero puede tener un determinado
nmero de hijos. La tabla puede por supuesto contener campos adicionales que describan atributos para los
nodos.
El prefijo crea una tabla de nodos expandidos, la cual contiene normalmente el mismo nmero de registros
que una tabla de entrada, pero adems, cada nivel de la jerarqua se almacena en un campo aparte. El
campo path puede utilizarse en una estructura arbrea.
41
2 Sintaxis de script
Normalmente, la tabla de entrada tiene exactamente un registro por nodo y en dicho caso la tabla resultante
contendr el mismo nmero de registros. No obstante, a veces hay nodos con mltiples padres, esto es, un
nodo viene representado por varios registros en la tabla de entrada. Si ste es el caso, la tabla resultante
podr contener un nmero mayor de registros que la tabla de entrada.
Todos los nodos con un id paterno que no se encuentre en la columna nodeid (incluidos aquellos nodos que
hayan perdido su id de padre) se considerarn como races. Asimismo, nicamente se cargarn los nodos
que posean una conexin a un nodo raz directa o indirecta evitndose con esto las referencias circulares.
Los campos adicionales que contengan el nombre del nodo padre, la ruta del nodo y la profundidad del nodo
se podrn crear sin problema.
Argumentos:
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
Depth
La cadena empleada para nombrar al nuevo campo Depth, que contiene la profundidad
del nodo en la jerarqua. Se trata de un parmetro opcional. Si se omite, dicho campo no
se crear.
Ejemplo:
Hierarchy(NodeID, ParentID, NodeName) LOAD
NodeID,
ParentID,
NodeName,
Attribute
From data.xls (biff, embedded labels, table is [Sheet1$];
42
2 Sintaxis de script
HierarchyBelongsTo
Este prefijo se utiliza para transformar una tabla jerrquica en una tabla que sea til en un modelo de datos
de Qlik Sense. Puede colocarse inmediatamente antes de una sentencia LOADo SELECT y almacenar el
resultado de la sentencia de carga como info de entrada para una transformacin de tabla.
Sintaxis:
HierarchyBelongsTo (NodeID, ParentID, NodeName, AncestorID, AncestorName,
[DepthDiff])(loadstatement | selectstatement)
La tabla de entrada debe ser una tabla de nodos adyacentes. Las tablas de nodos adyacentes son tablas en
las que cada registro se corresponde con un nodo y tiene un campo que contiene una referencia al nodo
padre. En este tipo de tabla, el nodo se almacena en un nico registro, pero puede tener un determinado
nmero de hijos. La tabla puede por supuesto contener campos adicionales que describan atributos para los
nodos.
El prefijo crea una tabla que contiene todas las relaciones hijo-antepasado de la jerarqua. Los campos de
antepasados pueden de esta forma utilizarse para seleccionar rboles enteros en la jerarqua. La tabla
resultante contiene normalmente varios registros por nodo.
Se puede crear un campo adicional que contenga la diferencia de profundidad entre los nodos.
Argumentos:
Argumento
Descripcin
NodeID
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.
DepthDiff
Es una cadena que se emplea para nombrar el nuevo campo DepthDiff, el cual
contiene la profundidad del nodo en la jerarqua, en relacin al nodo antepasado. Se
trata de un parmetro opcional. Si se omite, dicho campo no se crear.
Ejemplo:
HierarchyBelongsTo (NodeID, ParentID, Node, Tree, ParentName) LOAD
NodeID,
ParentID,
43
2 Sintaxis de script
NodeName
From data.xls (biff, embedded labels, table is [Sheet1$];
Image_Size
Esta sentencia se emplea junto al prefijo Info para redimensionar imgenes desde un sistema gestor de
bases de datos, de forma que stas encajen en los campos.
Sintaxis:
Info [Image_Size(width,height )] ( loadstatement | selectstatement )
Argumentos:
Argumento
Descripcin
width
height
Ejemplo:
Info Image_Size(122,122) SQL SELECT ID, Photo From infotable;
Info
El prefijo info sirve para enlazar informacin externa, como un archivo de texto, una imagen o un vdeo, con
un valor de campo.
Sintaxis:
Info( loadstatement | selectstatement )
Si parte de una informacin externa, como por ej. un archivo de texto, una imagen o un vdeo, se va a
enlazar a un valor de campo, esto se hace en una tabla que se carga mediante el prefijo info. (En algunos
casos ser preferible a almacenar la informacin dentro del archivo qvf, empleando el prefijo bundle. La
tabla deber contener dos columnas nicamente, la primera con los valores de campo que constituirn las
claves hacia la informacin, la segunda con los elementos de informacin, es decir, los nombres de archivo
de las imgenes, etc.
Lo mismo se aplica a, por ejemplo, una imagen procedente de un sistema gestor de bases de datos. En un
campo binario, un objeto blob, la sentencia info select realiza un bundle implcito, es decir, que los datos
binarios sern tomados de inmediato y almacenados en el qvf. Los datos binarios deben ser el segundo
campo en una sentencia SELECT.
Si una imagen necesita redimensionarse, se puede utilizar la clusula image_size.
Ejemplo:
Info LOAD * from flagoecd.csv;
Info SQL SELECT * from infotable;
44
2 Sintaxis de script
Info SQL SELECT Key, Picture From infotable;
Inner
Los prefijos join y keep pueden ir precedidos por el prefijo inner.Si se coloca antes de join especifica que
debe usarse una unin interna (inner join). La tabla resultante contendr por tanto combinaciones de valores
de campo de las dos tablas originales donde los valores de campos de enlace se representan en ambas
tablas. Si se coloca antes de keep, especifica que ambas tablas de datos sin procesar debern ser reducidas
a su interseccin comn antes de ser almacenadas en Qlik Sense.
Sintaxis:
Inner ( Join | Keep) [ (tablename) ](loadstatement |selectstatement )
Argumentos:
Argumento
Descripcin
tablename
loadstatement o selectstatement
Ejemplo1:
Table1
A
aa
cc
ee
Table2
A
xx
yy
QVTable:
SQL SELECT * From table1;
inner join SQL SELECT * From table2;
QVTable
A
aa
xx
Ejemplo2:
45
2 Sintaxis de script
QVTab1:
SQL SELECT * From Table1;
QVTab2:
inner keep SQL SELECT * From Table2;
QVTab1
A
aa
QVTab2
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.
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:
46
2 Sintaxis de script
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.
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).
Ejemplo1:
En las dos tablas a continuacin, la primera indica las horas de inicio y finalizacin de distintos pedidos. La
segunda indica un nmero de eventos. Mediante el prefijo IntervalMatch podemos conectar lgicamente las
dos tablas para averiguar por ej. qu pedidos han resultado afectados por alteraciones y qu pedidos han
sido procesados en qu turnos.
OrderLog
Start
End
Order
01:00
03:35
02:30
07:58
03:04
10:27
07:23
11:43
EventLog
Time
Event
Comment
00:00
Start of shift 1
01:18
Line stop
02:23
04:15
08:00
Start of shift 2
11:43
End of production
Primero hay que cargar las dos tablas como de costumbre, y despus vincular el campo Time a los intervalos
de tiempo definidos por los campos Start y End:
SELECT * from OrderLog;
47
2 Sintaxis de script
SELECT * from Eventlog;
IntervalMatch ( Time ) SELECT Start, End from OrderLog;
Event
Comment
Order
Start
End
00:00
Start of shift 1
01:18
Line stop
01:00
03:35
02:23
01:00
03:35
04:15
02:30
07:58
04:15
03:04
10:27
08:00
Start of shift 2
03:04
10:27
08:00
Start of shift 2
07:23
11:43
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
loadstatement o selectstatement
Ejemplo:
Join LOAD * from abc.csv;
Join SELECT * from table1;
48
2 Sintaxis de script
tab1:
LOAD * from file1.csv;
tab2:
LOAD * from file2.csv;
.. .. ..
join (tab1) LOAD * from file3.csv;
Keep
El prefijo keep es parecido al prefijo join. Al igual que el prefijo join, compara la tabla cargada con una tabla
previamente nombrada o con la ltima tabla de datos creada, pero en lugar de combinar la tabla cargada con
una tabla anterior, tiene el efecto de reducir una o ambas tablas antes de almacenarlas en Qlik Sense, segn
sea la interseccin de los datos de las tablas. La comparacin final equivale a aplicar un join natural entre
todos los campos comunes. La diferencia est en que las dos tablas no se unen, sino que se almacenan en
Qlik Sense como dos tablas independientes de distinto nombre.
Sintaxis:
(inner | left | right) keep [(tablename ) ]( loadstatement |
selectstatement )
El prefijo keep debe ir siempre precedido por uno de los prefijos inner, left o right.
El prefijo explcito join en el lenguaje de script de Qlik Sense ejecuta un full join de las dos tablas. El
resultado es una sola tabla. En muchos casos los joins dan como resultado unas tablas muy grandes. Una de
las principales caractersticas de Qlik Sense es su capacidad de hacer asociaciones entre mltiples tablas en
lugar de unirlas (mediante join). Esto permite ahorrar mucho espacio en la memoria e incrementar la
velocidad de procesamiento, lo que se traduce en una flexibilidad enorme. Los joins explcitos deben evitarse
por lo general en los scripts de Qlik Sense. La funcionalidad keep se ha diseado para reducir el nmero de
casos en los que se tengan que usar joins explcitos.
Argumentos:
Argumento
Descripcin
tablename
loadstatement o selectstatement
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;
49
2 Sintaxis de script
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.
Estaba buscando la funcin de cadena por el mismo nombre? Vase: Left (pgina 601)
Sintaxis:
Left ( Join | Keep) [ (tablename) ](loadstatement | selectstatement)
Argumentos:
Argumento
Descripcin
tablename
loadstatement o selectstatement
Ejemplo:
Table1
A
aa
cc
ee
Table2
A
xx
yy
QVTable:
SELECT * From table1;
Left Join Sselect * From table2;
QVTable
50
2 Sintaxis de script
A
aa
xx
cc
ee
QVTab1:
SELECT * From Table1;
QVTab2:
Left Keep SELECT * From Table2;
QVTab1
A
aa
cc
ee
xx
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;
.. .. ..
Left Keep (tab1) LOAD * From file3.csv;
Mapping
El prefijo mapping sirve para crear una tabla de correspondencias o enlaces, la cual puede utilizarse para,
por ejemplo, reemplazar valores de campo y nombres de campos durante la ejecucin de script.
Sintaxis:
Mapping( loadstatement | selectstatement )
El prefijo mapping puede colocarse antes de una sentencia LOAD o SELECT y almacenar el resultado de
la sentencia de carga como una tabla de correspondencia. Una tabla de enlace se compone de dos
columnas, la primera contiene los valores de comparacin y la segunda contiene los valores de
correspondencia deseados. Las tablas de correspondencia se almacenan temporalmente en la memoria y se
eliminan automticamente tras la ejecucin de script.
51
2 Sintaxis de script
Se puede acceder al contenido de la tabla de correspondencia utilizando, por ejemplo, la sentencia Map
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;
Outer
El prefijo explcito Join puede ir precedido por el prefijo outer para especificar un outer join. En un outer join
se generan todas las combinaciones entre las dos tablas. La tabla resultante contendr por tanto
combinaciones de valores de campo de las dos tablas donde los valores de campos de enlace se representan
en una o ambas tablas. La palabra clave outer es opcional.
Sintaxis:
Outer Join [ (tablename) ](loadstatement |selectstatement )
Argumentos:
Argumento
Descripcin
tablename
loadstatement o selectstatement
Ejemplo:
Table1
52
2 Sintaxis de script
A
aa
cc
ee
xx
yy
Table2
OR
SQL SELECT * from table1;
outer join SQL SELECT * from table2;
Joined table
A
aa
xx
cc
ee
yy
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 605)
Sintaxis:
Right (Join | Keep) [(tablename)](loadstatement |selectstatement )
Argumentos:
53
2 Sintaxis de script
Argumento
Descripcin
tablename
loadstatement o selectstatement
Ejemplos:
Table1
A
aa
cc
ee
Table2
A
xx
yy
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
54
2 Sintaxis de script
Las dos tablas del ejemplo keep estn, por supuesto, asociadas mediante el campo A.
tab1:
LOAD * from file1.csv;
tab2:
LOAD * from file2.csv;
.. .. ..
right keep (tab1) LOAD * from file3.csv;
Sample
El prefijo sample en una sentencia LOAD o SELECT se usa para cargar una muestra aleatoria de registros
desde la tabla fuente.
Sintaxis:
Sample
p ( loadstatement | selectstatement )
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;
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:
55
2 Sintaxis de script
Semantic LOAD * from abc.csv;
Semantic SELECT Object1, Relation, Object2, InverseRelation from table1;
Unless
El prefijo y sufijo unless sirven para crear una clusula condicional, la cual determina si una sentencia o
clusula exit debera ser evaluada o no. Puede verse como una excelente alternativa a la sentencia completa
if..end if.
Sintaxis:
(Unless condition statement | exitstatement Unless condition )
Argumentos:
Argumento
Descripcin
condition
statement
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 )
Sintaxis:
56
2 Sintaxis de script
Argumento
Descripcin
condition
statement
exitstatement
Una clusula exit for, exit do o exit sub, o una sentencia exit script.
Ejemplo1:
exit script when A=1;
Ejemplo2:
when A=1 LOAD * from myfile.csv;
Ejemplo3:
when A=1 unless B=2 drop table Tab1;
Alias
La sentencia alias se utiliza para establecer un alias segn el cual un campo se renombrar cada vez que
aparezca en el script.
Binary file
file ::= [ path ] filename
comment
Ofrece una forma de mostrar los comentarios del campo (metadatos) desde bases de datos y hojas de
57
2 Sintaxis de script
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.
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.
58
2 Sintaxis de script
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.
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
...]]
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.
59
2 Sintaxis de script
Execute commandline
FlushLog
La sentencia FlushLog hace que Qlik Sense guarde el contenido del buffer de script en el archivo de registro
(archivo log) del script.
FlushLog
Force
La sentencia force obliga a Qlik Sense a interpretar los valores de campo de las sentencias LOAD y
SELECT subsiguientes cuando aparecen escritas solo con maysculas o solo con minsculas, como si
estuvieran siempre en maysculas o tal como aparezcan (mezcladas). Esta sentencia permite asociar
valores de campo de tablas segn distintas convenciones.
Force ( capitalization | case upper | case lower | case mixed )
LOAD
La sentencia LOAD carga campos desde un archivo, desde datos definidos en el script, desde una tabla
previamente cargada, desde una pgina web, desde el resultado de una sentencia SELECT posterior, o
bien generando los datos automticamente.
let, al contrario que la sentencia set, evala la expresin del lado derecho del signo igual: ' =' antes de ser
asignada a la variable.
Let variablename=expression
Map ... using
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
60
2 Sintaxis de script
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.
61
2 Sintaxis de script
[Where criterion ]
[Group by fieldlist [having criterion ] ]
[Order by fieldlist [asc | desc] ]
[ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]
Set
La sentencia set se utiliza para definir variables de script. stas pueden servir para sustituir cadenas, rutas,
unidades de disco, etc.
Set variablename=string
Sleep
La sentencia sleep detiene la ejecucin de script por un tiempo especificado.
Sleep n
SQL
La sentencia SQL permite lanzar un comando SQL a travs de una conexin ODBC u OLE DB.
SQL sql_command
SQLColumns
La sentencia sqlcolumns devuelve un conjunto de campos que describen las columnas de una fuente de
datos ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.
SQLColumns
SQLTables
La sentencia sqltables devuelve un conjunto de campos que describen las tablas de una fuente de datos
ODBC u OLE DB, a la que se ha hecho una conexin mediante connect.
SQLTables
SQLTypes
La sentencia sqltypes devuelve un conjunto de campos que describen los tipos de una fuente de datos
ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.
SQLTypes
Star
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.
62
2 Sintaxis de script
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.
Trace string
Unmap
La sentencia Unmap deshabilita el enlace de un valor de campo especificado por una sentencia Map
Unqualify *fieldlist
Untag
Es una opcin que permite eliminar etiquetas de uno o ms campos. Si se intenta desetiquetar un nombre
de campo no presente en la app, se ignora la accin de desetiquetar. Si hubiera mltiples nombres de un
mismo campo o etiqueta, se emplear el ltimo valor.
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:
63
2 Sintaxis de script
Argumento
Descripcin
fieldname
aliasname
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 de Qlik Sense o de un documento de QlikView
11.2 o anterior, incluidos los datos de secciones de acceso.
Sintaxis:
binary file
file ::= [ path ] filename
Argumentos:
Argumento
Descripcin
file
path
Absoluta
Ejemplo: c:\data\
l
Ejemplo: data\
64
2 Sintaxis de script
Solo se permite una sentencia binary en el script y tiene que ser la primera sentencia del
script.
Ejemplos
Binary lib://MyData/customer.qvw;
Binary customer.qvw;
Binary c:\qv\customer.qvw;
Comment field
Ofrece una forma de mostrar los comentarios del campo (metadatos) desde bases de datos y hojas de
clculo. Los nombres de campo que no estn presentes en la app se ignorarn. Si hubiera mltiples nombres
de un mismo campo, se emplear el ltimo valor.
Sintaxis:
comment [fields] *fieldlist using mapname
comment [field] fieldname with comment
La tabla de enlace empleada deber tener dos columnas, la primera con los nombres de campo y la segunda
con los comentarios.
Argumentos:
Argumento
Descripcin
*fieldlist
Es una lista separada por comas con los campos que se han de comentar. El asterisco *
indica la totalidad de campos. Se permite la inclusin de los caracteres comodn * y ? en
los nombres de campo. Puede que sea necesario entrecomillar los nombres de campo
cuando se empleen caracteres comodn.
mapname
fieldname
comment
Ejemplo1:
commentmap:
mapping LOAD * inline [
a,b
Alpha,This field contains text values
Num,This field contains numeric values
];
comment fields using commentmap;
65
2 Sintaxis de script
Ejemplo2:
comment field Alpha with AFieldContainingCharacters;
comment field Num with '*A field containing numbers';
comment Gamma with 'Mickey Mouse field';
Comment table
Ofrece una forma de mostrar los comentarios de una tabla (metadatos) desde bases de datos u hojas de
clculo.
Los nombres de tabla que no estn presentes en la app se ignorarn. Si hubiera mltiples nombres de una
misma tabla, se emplear el ltimo valor. La palabra clave se puede utilizar para leer los comentarios desde
una fuente de datos.
Sintaxis:
comment [tables] tablelist using mapname
Argumentos:
Argumento
Descripcin
tablelist
(table{,table})
mapname
Sintaxis:
Para fijar comentarios individuales se emplea la sintaxis siguiente:
Descripcin
tablename
comment
Ejemplo1:
Commentmap:
mapping LOAD * inline [
a,b
Main,This is the fact table
Currencies, Currency helper table
];
comment tables using commentmap;
66
2 Sintaxis de script
Ejemplo2:
comment table Main with Main fact table;
Connect
La sentencia CONNECT sirve para definir el acceso de Qlik Sense a una base de datos general mediante la
interfaz OLE DB/ODBC. Para ODBC, debemos especificar primero la fuente de datos mediante el
administrador de conexin ODBC.
Sintaxis:
ODBC CONNECT TO connect-string
OLEDB CONNECT TO connect-string
CUSTOM CONNECT TO connect-string
LIB CONNECT TO connection
Argumentos:
Argumento
Descripcin
connectstring
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
Si el ODBC se coloca antes de CONNECT, se utilizar la interfaz ODBC; en caso contrario, se usar OLE
DB.
67
2 Sintaxis de script
Al utilizar LIB CONNECT TO, se conecta con una base de datos con una conexin de datos almacenada
creada en el editor de carga de datos.
Ejemplo1:
ODBC CONNECT TO 'Sales
DBQ=C:\Program Files\Access\Samples\Sales.mdb';
Las sentencias Select (SQL) subsiguientes utilizan la fuente de datos definida por esta sentencia, hasta que
se ejecute una nueva sentencia CONNECT.
Ejemplo2:
LIB CONNECT TO 'MyDataConnection';
Connect32
Esta sentencia de control se utiliza igual que la sentencia de control CONNECT, pero obliga a un sistema de
64 bits a utilizar un proveedor ODBC/OLE DB de 32 bits. No aplicable a connect personalizada.
Connect64
Esta sentencia se utiliza igual que la sentencia CONNECT, pero obliga a utilizar un proveedor de 64 bits. No
aplicable a connect personalizada.
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.
Descripcin
definition_
name
Ejemplo:
68
2 Sintaxis de script
Argumento
Descripcin
Calendar:
tag_list
Una lista de etiquetas separadas por comas para aplicar a campos derivados de la
definicin de campo. Opcional.
Ejemplo:
'$date'
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:
En este ejemplo creamos una definicin de calendario que puede utilizarse para generar campos
relacionados con fechas, como ao y mes, que puedan utilizarse en las dimensiones.
Para probar el calendario necesitamos algunos datos fuente con campos de fecha.
Load * Inline [
OrderID, Terminal, OrderDate, ShippingDate
100001, London, 2012-03-12, 2012-03-14
100002, Berlin, 2012-03-12, 2012-03-16
100003, London, 2012-03-12, 2012-03-14
100004, Paris, 2012-03-12, 2012-03-16
100005, Paris, 2012-03-12, 2012-03-14
100006, Paris, 2012-04-11, 2012-04-22
100007, London, 2012-04-12, 2012-04-14
100008, Paris, 2012-05-12, 2012-05-13
100009, London, 2013-01-12, 2013-03-14
100010, Berlin, 2013-01-12, 2013-03-16
100011, London, 2013-01-12, 2013-03-14
100012, Paris, 2013-01-12, 2013-03-16
100013, Paris, 2013-01-12, 2013-03-14
100014, Berlin, 2013-03-12, 2013-03-16
100015, London, 2013-03-12, 2013-03-14
100016, Berlin, 2013-03-12, 2013-03-16
100017, Paris, 2013-09-12, 2013-10-14
69
2 Sintaxis de script
100018, Berlin, 2013-09-12, 2013-09-16
];
Ahora podemos definir un calendario que cree campos para ao, mes, semana, da de semana y nmero de
da.
Calendar:
DECLARE FIELD DEFINITION TAGGED '$date'
Parameters
first_month_of_year = 1
Fields
Year($1) As Year Tagged '$year',
Month($1) as Month Tagged '$month',
Date($1) as Date Tagged ('$date', '$day'),
Week($1) as Week Tagged '$week',
Weekday($1) as Weekday Tagged '$weekday',
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.
DERIVE FIELDS FROM FIELDS OrderDate,ShippingDate USING Calendar;
Cuando haya recargado el script de datos, podr hallar los campos generados, por ejemplo
OrderDate.Calendar.Weekday en Campos fecha y hora en el panel de activos Campos. Tambin estn
disponibles en el editor de expresiones y cuando cree las dimensiones y pueden usarse como cualquier otro
campo en las visualizaciones.
Descripcin
definition_
name
Ejemplo:
MyCalendar:
existing_
definition
70
2 Sintaxis de script
Argumento
Descripcin
Ejemplo:
Using Calendar
parameter_
assignment
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
Derive [Field[s]] From Explicit [Tag[s]] tag_list Using definition
Derive [Field[s]] From Implicit [Tag[s]] Using definition
Argumentos:
Argumento
Descripcin
definition
Ejemplo: Calendar
field_list
Una lista de campos de datos separados por comas desde la que deberan generarse los
71
2 Sintaxis de script
Argumento
Descripcin
campos derivados, basado en la definicin de campo. Los campos de datos deben ser
campos que ya hayamos cargado en el script.
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'
Ejemplo:
En este ejemplo creamos una definicin de calendario que puede utilizarse para generar campos
relacionados con fechas, como ao y mes, que puedan utilizarse en las dimensiones.
Para probar el calendario necesitamos algunos datos fuente con campos de fecha.
Load * Inline [
OrderID, Terminal, OrderDate, ShippingDate
100001, London, 2012-03-12, 2012-03-14
100002, Berlin, 2012-03-12, 2012-03-16
100003, London, 2012-03-12, 2012-03-14
100004, Paris, 2012-03-12, 2012-03-16
100005, Paris, 2012-03-12, 2012-03-14
100006, Paris, 2012-04-11, 2012-04-22
100007, London, 2012-04-12, 2012-04-14
100008, Paris, 2012-05-12, 2012-05-13
100009, London, 2013-01-12, 2013-03-14
100010, Berlin, 2013-01-12, 2013-03-16
100011, London, 2013-01-12, 2013-03-14
100012, Paris, 2013-01-12, 2013-03-16
100013, Paris, 2013-01-12, 2013-03-14
100014, Berlin, 2013-03-12, 2013-03-16
100015, London, 2013-03-12, 2013-03-14
100016, Berlin, 2013-03-12, 2013-03-16
100017, Paris, 2013-09-12, 2013-10-14
100018, Berlin, 2013-09-12, 2013-09-16
];
Ahora podemos definir un calendario que cree campos para ao, mes, semana, da de semana y nmero de
da.
Calendar:
DECLARE FIELD DEFINITION TAGGED '$date'
Parameters
first_month_of_year = 1
Fields
Year($1) As Year Tagged '$year',
Month($1) as Month Tagged '$month',
Date($1) as Date Tagged ('$date', '$day'),
Week($1) as Week Tagged '$week',
72
2 Sintaxis de script
Weekday($1) as Weekday Tagged '$weekday',
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. Hay tres formas posibles de hacer esto:
l
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;
Cuando haya recargado el script de datos, podr hallar los campos generados, por ejemplo
OrderDate.Calendar.Weekday en Campos fecha y hora en el panel de activos Campos. Tambin estn
disponibles en el editor de expresiones y cuando cree las dimensiones y pueden usarse como cualquier otro
campo en las visualizaciones.
Direct Query
La sentencia DIRECT QUERY permite enlazar tablas mediante una conexin ODBC u OLE DB,
empleando la funcin Direct Discovery.
Sintaxis:
DIRECT QUERY DIMENSION fieldlist [MEASURE fieldlist] [DETAIL fieldlist]
FROM tablelist
[WHERE where_clause]
Las palabras clave DIMENSION , MEASURE y DETAIL 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.
73
2 Sintaxis de script
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 solo en las agregaciones,
deberan seleccionarse con la palabra clave MEASURE.
DETAIL los campos 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
Ejemplos:
DIRECT QUERY
DIMENSION Dim1, Dim2
MEASURE
NATIVE ('X % Y') AS X_MOD_Y
FROM TableName
DIRECT QUERY
DIMENSION Dim1, Dim2
MEASURE X, Y
FROM TableName
WHERE NATIVE ('EMAIL MATCHES "\*.EDU"')
Los siguientes trminos se utilizan como palabras clave y, por lo tanto, no pueden utilizarse
como nombres de columnas o campos sin ir entre comillas: and, as, detach, detail, dimension,
distinct, from, in, is, like, measure, native, not, or, where
Argumentos:
Argumento
Descripcin
fieldlist
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
74
2 Sintaxis de script
Argumento
Descripcin
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 una vista que contiene 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 .
Ejemplo:
En este ejemplo, se utiliza una tabla de base de datos denominada TableName, que contiene campos Dim1,
Dim2, Num1, Num2 y Num3.Dim1 y Dim2 se cargarn en el conjunto de datos Qlik Sense.
DIRECT QUERY DIMENSTION Dim1, Dim2 MEASURE Num1, Num2, Num3 FROM TableName ;
Dim1 y Dim2 estarn disponibles para utilizarlos como dimensiones. Num1, Num2 y Num3 estar disponible
para agregaciones. Dim1 y Dim2 tambin estn disponibles para agregaciones. El tipo de agregaciones para
las que Dim1 y Dim2 pueden utilizarse depende de sus tipos de datos. Por ejemplo, en muchos casos los
campos DIMENSION contienen datos de cadenas tales como nombres o nmeros de cuenta. Dichos
campos no pueden sumarse, pero s pueden contarse: count(Dim1).
75
2 Sintaxis de script
MEASURE
SubTotal
TaxAmt
DETAIL
OrderDate,
FROM MyDB.Sales.SalesOrderHeader;
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.
76
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 maysculas, como el alias Qlik Sense interno incluso aunque el alias se haya especificado como un
caso mixto. La sentencia SQL Select utiliza el nombre de columna devuelto por la base de datos, el cual en
el caso de Oracle es todo en maysculas.
SQL Select STATEID as MyState, STATENAME from STATE_TABLE;
Para evitar este comportamiento, utilice la sentencia LOAD para especificar el alias.
Load STATEID as MyState, STATENAME;
SQL Select STATEID, STATEMENT from STATE_TABLE;
En este ejemplo, la columna "STATEID" es almacenada internamente por Qlik Sense como "MyState".
Se permiten la mayora de expresiones escalares de bases de datos como especificaciones de campos. Las
llamadas a funciones tambin se pueden utilizar en especificaciones de campos. Las expresiones pueden
contener constantes que son booleanas, numricas, o cadenas contenidas en signos de entrecomillado
simple (la inclusin de signos de entrecomillado simple viene representada por signos de entrecomillado
adyacentes).
Ejemplos:
DIRECT QUERY DIMENSION SalesOrderID, RevisionNumber MEASURE SubTotal AS "Sub Total" FROM
AdventureWorks.Sales.SalesOrderHeader
DIRECT QUERY DIMENSION "SalesOrderID" AS "Sales Order ID" MEASURE SubTotal,TaxAmt,(SubTotal-TaxAmt)
AS "Net Total" FROM AdventureWorks.Sales.SalesOrderHeader
DIRECT QUERY DIMENSION (2*Radius*3.14159) AS Circumference, Molecules/6.02e23 AS Moles MEASURE Num1
AS numA FROM TableName
DIRECT QUERY DIMENSION concat(region, 'code') AS region_code MEASURE Num1 AS NumA FROM TableName
Direct Discovery no permite el uso de agregaciones en sentencias LOAD. Si se utilizaran agregaciones, los
resultados seran impredecibles. Una sentencia LOAD como la siguiente no debera utilizarse:
DIRECT QUERY DIMENSION stateid, SUM(amount*7) AS MultiFirst MEASURE amount FROM sales_table
77
2 Sintaxis de script
Directory
La sentencia Directory define en qu directorio buscar archivos de datos en subsiguientes sentencias
Sintaxis:
Directory[path]
Si se lanza la sentencia Directory sin una path o esta se deja fuera, Qlik Sense buscar en el directorio de
trabajo de Qlik Sense.
Argumentos:
Argumento
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
Ejemplo: data\
l
Direccin URL (HTTP o FTP), que apunta a una ubicacin en Internet o una
intranet.
Ejemplo: http://www.qlik.com
Ejemplo:
Directory c:\userfiles\data;
Disconnect
La sentencia Disconnect termina la actual conexin ODBC/OLE DB/Personalizada. Esta sentencia es
opcional.
Sintaxis:
Disconnect
78
2 Sintaxis de script
La conexin terminar automticamente cuando se ejecute una nueva sentencia connect o cuando termine
la ejecucin del script.
Ejemplo:
Disconnect;
Drop field
Se pueden desechar del modelo de datos (y por tanto de la memoria) uno o varios campos de Qlik Sense, en
cualquier momento durante la ejecucin del script mediante una sentencia drop field.
Tanto drop field como drop fields se permiten ambas formas sin diferencia alguna en el
resultado. Si no se especifica tabla alguna, el campo se eliminar de todas las tablas en las
que aparece.
Sintaxis:
Drop field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2
...]]
Drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2
...]]
Ejemplos:
Drop
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 tabla(s) en s.
79
2 Sintaxis de script
l
Los valores de campo en los campos, los cuales vienen exclusivamente desde las tablas eliminadas.
Ejemplos y resultados:
Ejemplo
Resultado
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.
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://.
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.
Haga lo siguiente:
80
2 Sintaxis de 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 valores de campo de las sentencias LOAD y
SELECT subsiguientes cuando aparecen escritas solo con maysculas o solo con minsculas, como si
estuvieran siempre en maysculas o tal como aparezcan (mezcladas). Esta sentencia permite asociar
valores de campo de tablas segn distintas convenciones.
Sintaxis:
Force ( capitalization | case upper | case lower | case mixed )
Si no se especifica nada, se asume force case mixed. La sentencia force es vlida hasta que se incluya una
nueva sentencia force.
La sentencia force no tiene efecto alguno en la seccin de acceso: todos los valores de campos cargados no
son sensibles a maysculas.
Ejemplos:
Force Capitalization;
81
2 Sintaxis de script
Force Case Upper;
Force Case Lower;
Force Case Mixed;
Load
La sentencia LOAD carga campos desde un archivo, desde datos definidos en el script, desde una tabla
previamente cargada, desde una pgina web, desde el resultado de una sentencia SELECT posterior, o
bien generando los datos automticamente.
Sintaxis:
LOAD [ distinct ] *fieldlist
[( from file [ format-spec ] |
from_field fieldassource [format-spec]
inline data [ format-spec ] |
resident table-label |
autogenerate size )]
[ where criterion | while criterion ]
[ group_by groupbyfieldlist ]
[order_by orderbyfieldlist ]
Argumentos:
Argumento
Descripcin
distinct
fieldlist
82
2 Sintaxis de script
Argumento
Descripcin
campo, n se utiliza como posicin final.
l
(U) (orden Intel de bytes). El nmero de las posiciones ledas debe ser 1, 2 4.
Si @startpos: endpos va inmediatamente seguido por el carcter R, los bytes
ledos se interpretarn como un nmero real binario (punto flotante IEEE 32bit o 64 bit). El nmero de las posiciones ledas debe ser 4 u 8.
Si @startpos: endpos va inmediatamente seguido por el carcter B, los bytes
ledos se interpretarn como nmeros BCD (Binary Coded Decimal) de
acuerdo al estndar COMP-3. Se puede especificar cualquier nmero de
bytes.
expression puede ser una funcin numrica o funcin de cadenas basada en uno o
varios campos de la misma tabla. Para ms informacin, vea la sintaxis de las
expresiones.
as is used for assigning a new name to the field.
from
from se utiliza si hay que cargar los datos desde un archivo utilizando una carpeta o
una conexin de datos de archvos web.
file ::= [ path ] filename
Ejemplo: 'lib://Table Files/'
En el modo de elaboracin de scripts de legado, se admiten tambin los diguientes
formatos de ruta:
l
Absoluta
Ejemplo: c:\data\
l
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.
83
2 Sintaxis de script
Argumento
Descripcin
En una instalacin de servidor Qlik Sense, el directorio de trabajo se
especifica en Qlik Sense Repository Service; por defecto es
C:\ProgramData\Qlik\Sense\Apps. Consulte la ayuda de Qlik
Management Console para obtener ms informacin.
filename puede contener los caracteres comodn estndar de DOS (* y ?). Esto
provocar la carga de todos los archivos en el directorio especificado.
format-spec ::= ( fspec-item { , fspec-item } )
La especificacin de formato consiste en una lista de varios elementos de
caracterizacin, entre parntesis.
from_field
inline
resident
resident se utiliza si los datos debieran cargarse desde una tabla previamente
cargada.
table label es una etiqueta que precede a la(s) sentencia(s) LOAD o SELECT, que
crearon la tabla original. La etiqueta debe ir seguida de dos puntos al final de la lnea.
autogenerate
autogenerate se utiliza si los datos deben ser generados automticamente por Qlik
Sense.
size ::= number
Number es un entero que indica el nmero de registros que se han de generar. La lista
de campos no debe contener expresiones que requieran datos de una base de datos.
En estas expresiones slo se permiten constantes y funciones sin parmetros (por ej.
84
2 Sintaxis de script
Argumento
Descripcin
rand() o recno()) .
where
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( ).
group by es una clusula que sirve para definir sobre qu campos debern agregarse
(agruparse) los datos.Los campos de agrupacin debern incluirse de alguna manera
en las expresiones cargadas. Ningn otro campo ms que los de agrupacin deber
emplearse fuera de las funciones de agregacin en las expresiones cargadas.
groupbyfieldlist ::= (fieldname { ,fieldname } )
order_by
order by es una clusula que se utiliza para ordenar los registros de una tabla
residente, antes de que sean procesados por la sentencia load. La tabla residente
puede ordenarse por ms de un campo en orden ascendente o descendente. La
ordenacin se hace principalmente por valores numricos y secundariamente por valor
ASCII nacional. Esta clusula solo puede utilizarse cuando al fuente de datos es una
tabla residente.
Los campos de ordenacin especifican por qu campos est ordenada la tabla
residente. El campo puede especificarse por su nombre o por su nmero en la tabla
residente (el primer nmero de campo es el 1).
orderbyfieldlist ::= fieldname [sortorder ] {, fieldname [sortorder ] }
sortorder sirve tanto para ordenacin ascendente, asc, como descendente, desc. Si
no se especifica sortorder alguno, se asume asc (ascendente).
fieldname, path, filename y aliasname son cadenas que representan lo que sus
respectivos nombres indican. Cualquier campo de la tabla de origen puede utilizarse
como fieldname. No obstante, los campos creados mediante la clusula as
(aliasname) estn fuera de mbito y no pueden utilizarse dentro de la misma
sentencia load.
Si no se especifica ninguna fuente de datos mediante una clusula from, inline, resident, from_field o
autogenerate, los datos se cargarn a partir del resultado de la sentencia SELECT o LOAD
inmediatamente posterior. Dicha sentencia posterior no debera llevar ningn prefijo.
Ejemplos:
Cargar formatos de archivo diferentes
85
2 Sintaxis de script
// LOAD a delimited data file with default options
LOAD * from data1.csv;
// LOAD a delimited data file from a library connection MyData
LOAD * from 'lib://MyData/data1.csv';
// LOAD a delimited file, specifying comma as delimiter and embedded labels
LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels);
// LOAD a delimited file specifying tab as delimiter and embedded labels
LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);
// LOAD a dif file with embedded headers
LOAD * from file2.dif (ansi, dif, embedded labels);
// LOAD three fields from a fixed record file without headers
LOAD @1:2 as ID, @3:25 as Name, @57:80 as City from data4.fix (ansi, fix, no labels, header is 0,
record is 80);
//LOAD a QVX file, specifying an absolute path
LOAD * from C:\qdssamples\xyz.qvx (qvx);
86
2 Sintaxis de script
// Field B will contain a random number between 0 and 1
LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);
Agrupar datos
// LOAD fields grouped (aggregated) by ArtNo
LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo;
// // LOAD fields grouped (aggregated) by Week and ArtNo
LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week,
ArtNo;
87
2 Sintaxis de script
Las notas, en una escala del 1 al 5 representan matemticas, ingls, ciencias e historia. Es posible separar
las notas en distintos valores leyendo cada registro varias veces con una clusula while, usando la funcin
IterNo( ) como un contador. En cada lectura, la nota se extrae mediante la funcin Mid y el asunto se
selecciona mediante la funcin pick. La clusula final while contiene la prueba de comprobacin para ver si
todas las notas se han ledo (cuatro por estudiante en este caso), lo que significa que se debera leer el
registro del siguiente estudiante.
MyTab:
LOAD Student,
mid(Grades,IterNo( ),1) as Grade,
pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from Grades.csv
while IsNum(mid(Grades,IterNo(),1));
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 archivos para la sentencia LOAD que define el conjunto de
caracteres que se emplea 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
88
2 Sintaxis de script
Argumentos:
Argumento
Descripcin
utf8
unicode
ansi
oem
mac
Codepage 10000
codepage
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
TableFormat
El formato de tabla es un especificador de archivo para la sentencia LOAD que define de qu tipo es el
archivo. Si no se especifica nada, se asume un archivo de texto .txt.
txt
En un archivo delimitado de texto, .txt, las columnas de la tabla van separadas por
algn carcter.
fix
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
89
2 Sintaxis de script
html
Si la tabla forma parte de algn archivo o pgina html, deber emplearse html.
xml
qvd
El formato qvd es el formato nativo de los archivos QVD, exportados desde una app de
Qlik Sense.
qvx
Delimiter
Se puede especificar un delimitador arbitrario para archivos de tabla delimitados, mediante el especificador
delimiter is. Este especificador slo tiene sentido en archivos .txt delimitados.
Sintaxis:
delimiter is char
Argumentos:
Argumento
Descripcin
char
"\t"
"\\"
"spaces"
Ejemplo:
LOAD * from a.txt (utf8, txt, delimiter is ',' , embedded labels);
Vea tambin:
p
No eof
El especificador no eof se utiliza para descartar el carcter de fin de lnea cuando cargamos archivos .txt
delimitados.
90
2 Sintaxis de script
Sintaxis:
no eof
Si se utiliza el especificador no eof, el carcter ASCII 26, que de otro modo denota el final de archivo, es
descartado y puede formar parte de un valor de campo.
Este especificador slo tiene sentido en archivos .txt delimitados.
Ejemplo:
LOAD * from a.txt (txt, utf8, embedded labels, delimiter is ' ', no eof);
Vea tambin:
p
Labels
Labels es un especificador de archivo para la sentencia LOAD que define en qu parte de un archivo se
encuentran los nombres de campo.
Sintaxis:
embedded labels|explicit labels|no labels
Los nombres de campo pueden encontrarse en sitios diferentes en el archivo. Si el primer registro contiene
los nombres de los campos, debera usarse la opcin embedded labels. En caso de no encontrar nombres
de campo, se debera usar no labels. En archivos dif, a veces se utiliza una seccin de cabecera aparte, con
nombres de campo explcitos. En tal caso, debe usarse la opcin explicit labels. Si no se especifica nada,
se asume embedded labels, tambin para archivos dif.
Ejemplo1:
LOAD * from a.txt (unicode, txt, delimiter is ',' , embedded labels
Ejemplo2:
LOAD * from a.txt (codePage is 1252, txt, delimiter is ',' , no labels)
Vea tambin:
p
91
2 Sintaxis de script
Header is
Determina el tamao de la cabecera de los archivos de tabla. Se puede especificar una longitud arbitraria de
cabecera mediante el especificador header is. Una cabecera es una seccin de texto no utilizada por Qlik
Sense.
Sintaxis:
header is n
header is line
header is n lines
La longitud de la cabecera se puede dar en bytes (header is n), o en lneas (header is line o header is n
lines). n debe ser un entero positivo que represente la longitud de cabecera. Si no se especifica nada, se
asume header is 0. El especificador header is slo es relevante para archivos de tabla.
Ejemplo:
Este es un ejemplo de una tabla de fuente de datos que contiene una lnea de texto de cabecera que Qlik
Sense no debera interpretar como datos.
*Header line
Col1,Col2
a,B
c,D
Si se usa el especificador header is 1 lines, la primera lnea no se cargar como datos. En el ejemplo, el
especificador embedded labels le dice a Qlik Sense que interprete la primera lnea no excluida como que
contiene etiquetas de campo.
LOAD Col1, Col2
FROM 'lib://files/header.txt'
(txt, embedded labels, delimiter is ',', msq, header is 1 lines);
Vea tambin:
p
Record is
Para archivos de registro fijo, la longitud de registro debe especificarse a travs del especificador record is.
Sintaxis:
Record is n
Record is line
Record is n lines
Argumentos:
92
2 Sintaxis de script
Argumento
Descripcin
line
n lines
Limitaciones:
El especificador record is slo es relevante para archivos fix.
Vea tambin:
p
Quotes
Quotes es un especificador de archivo para la sentencia LOAD que define si se pueden utilizar o no comillas
y la prioridad entre stas y los separadores. Es slo para archivos de texto.
Sintaxis:
no quotes
msq
Si se omite el especificador, se pueden utilizar las comillas estndar dobles o simples (" " o ' '), pero slo si
son el primer y ltimo carcter no en blanco de un valor de campo.
Argumentos:
Argumento
Descripcin
no quotes
msq
93
2 Sintaxis de script
XML
Este especificador de script se utiliza para cargar archivos xml. Las opciones vlidas para la sintaxis del
especificador XML se enumeran en la sintaxis.
Sintaxis:
xmlsax
xmlsimple
pattern is path
xmlsax y xmlsimple son mutuamente excluyentes, slo puede especificarse uno cuando se emplea xml.
Cuando se emplee pattern el archivo se leer desde el principio de la etiqueta especificada hasta el final de
la misma. Si path contiene espacios, deber ir entre comillas.
Para usar xmlsax, debe instalarse el parser Microsoft xml 3.0 o posterior de MSXML. MSXML
viene junto con por ej. Windows XP y MS Internet Explorer 6. Tambin se puede descargar de
la pgina web de Microsoft.
Vea tambin:
p
KML
Este especificador de script se usa cuando se cargan archivos KML que se van a utilizar en una visualizacin
de mapa.
Sintaxis:
kml
El archivo KML puede representar datos de rea (por ejemplo pases o regiones), representados mediante
polgonos, o datos de puntos (por ejemplo ciudades o lugares), representados por puntos en el formulario
[long, lat].
Let
La sentencia let es complementaria a la sentencia set, utilizada para definir variables de script. La sentencia
let, al contrario que la sentencia set, evala la expresin del lado derecho del signo igual: ' =' antes de ser
asignada a la variable.
Sintaxis:
Let variablename=expression
94
2 Sintaxis de script
La palabra let puede omitirse, pero la sentencia se convierte entonces en una sentencia de control. Dicha
sentencia, sin la palabra clave let debe ir en una sola lnea de script y puede terminar tanto con un fin de
lnea como con un punto y coma.
Ejemplos y resultados:
Ejemplo
Resultado
Set x=3+4;
Let y=3+4
z=$(y)+1;
Let T=now();
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
Ejemplos y resultados:
95
2 Sintaxis de script
Ejemplo
Resultado
Map A, B, C Using X;
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.
96
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.
Argumentos:
Argumento
Descripcin
*fieldlist
97
2 Sintaxis de script
Argumento
Descripcin
El asterisco * indica la totalidad de campos. Se permite la inclusin de los caracteres
comodn * y ? en los nombres de campo. Puede que sea necesario entrecomillar los
nombres de campo cuando se empleen caracteres comodn.
Ejemplo1:
Qualify B;
LOAD A,B from x.csv;
LOAD A,B from y.csv;
Las dos tablas x.csv y y.csv se asocian slo mediante A. Resultan tres campos: A, x.B, y.B.
Ejemplo2:
En una base de datos con la que no est familiarizado, puede que quiera empezar asegurndose de que slo
uno o unos pocos campos estn asociados, como se muestra en el ejemplo:
qualify *;
unqualify TransID;
SQL SELECT * from tab1;
SQL SELECT * from tab2;
SQL SELECT * from tab3;
Slo se emplear TransID para las asociaciones entre las tablas tab1, tab2 y tab3.
Rem
La sentencia rem se usa para insertar comentarios en el script o desactivar temporalmente sentencias de
script, sin eliminarlas.
Sintaxis:
Rem string
Todo lo que est entre rem y el siguiente punto y coma ; se considera que es un comentario.
Hay disponibles dos mtodos alternativos para hacer comentarios en el script:
1. Puede crear un comentario en cualquier lugar del script - excepto entre comillas - situando la seccin
en cuestin entre /* y */.
2. Cuando introduzca // en el script, todo el texto que vaya a la derecha en la misma fila se convertir en
un comentario. (Observe la excepcin //: que puede utilizarse como parte de una direccin de
Internet).
Argumentos:
Argumento
Descripcin
string
Es un texto cualquiera.
98
2 Sintaxis de script
Ejemplo:
Rem ** This is a comment **;
/* This is also a comment */
// This is a comment as well
Rename field
Esta funcin de script renombra uno o varios campos de Qlik Sense tras haberlos cargado.
Puede utilizar cualquiera de estas sintaxis: rename field o rename fields.
Sintaxis:
Rename Field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Argumentos:
Argumento
Descripcin
mapname
El nombre de una tabla de enlace previamente cargada que contiene uno o ms pares de
tablas antiguas y nuevas.
oldname
newname
Limitaciones:
Dos campos con diferente nombre no pueden renombrarse con un mismo nombre. El script se ejecutar sin
errores pero el segundo campo no se renombrar.
Ejemplo1:
Rename Field XAZ0007 to Sales;
Ejemplo2:
FieldMap:
Mapping SQL SELECT oldnames, newnames from datadictionary;
Rename Fields using FieldMap;
Rename table
Esta funcin de script renombra una o varias tablas internas de Qlik Sense tras haberlas cargado.
Puede utilizar cualquiera de estas sintaxis: rename table o rename tables.
Sintaxis:
Rename Table (using mapname | oldname to newname{ , oldname to newname })
99
2 Sintaxis de script
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Argumentos:
Argumento
Descripcin
mapname
El nombre de una tabla de enlace previamente cargada que contiene uno o ms pares de
tablas antiguas y nuevas.
oldname
newname
Limitaciones:
Dos tablas con distinto nombre no pueden renombrarse con un mismo nombre. El script se ejecutar sin
errores pero la segunda tabla no se renombrar.
Ejemplo1:
Tab1:
SELECT * from Trans;
Rename Table Tab1 to Xyz;
Ejemplo2:
TabMap:
Mapping LOAD oldnames, newnames from tabnames.csv;
Rename Tables using TabMap;
Search
La sentencia Search se utiliza para incluir o excluir campos en la funcin de herramienta de bsqueda.
Sintaxis:
Search Include *fieldlist
Search Exclude *fieldlist
Puede utilizar varias sentencias Search para refinar la seleccin de campos que se deben incluir. Las
sentencias se evalan de arriba a abajo.
Argumentos:
Argumento
Descripcin
*fieldlist
Lista separada por comas de los campos que se deben incluir o excluir de las bsquedas
en la herramienta global. El asterisco * indica la totalidad de campos. Se permite la
inclusin de los caracteres comodn * y ? en los nombres de campo. Puede que sea
necesario entrecomillar los nombres de campo cuando se empleen caracteres comodn.
100
2 Sintaxis de script
Ejemplo:
Search Include *;
El resultado combinado de estas tres sentencias, en esta secuencia, es que todos los campos que terminen
con ID excepto ProductID se excluyen de bsquedas en la herramienta global.
Section
Con la sentencia section es posible definir si las sentencias subsiguientes LOAD y SELECT debern
considerarse como datos o como una definicin de derechos de acceso.
Sintaxis:
Section (access | application)
Si no se especifica nada, se asume section application. La definicin de section es vlida hasta que se
ejecute una nueva sentencia section.
Ejemplo:
Section access;
Section application;
Select
La seleccin de campos desde una fuente de datos ODBC o proveedor OLE DB se hace mediante
sentencias SQL SELECT estndar. Sin embargo, si las sentencias SELECT son aceptadas o no, depende
del driver ODBC o proveedor OLE DB empleado.
Sintaxis:
Select [all | distinct | distinctrow | top n [percent] ] *fieldlist
From tablelist
[where criterion ]
[group by fieldlist [having criterion ] ]
[order by fieldlist [asc | desc] ]
[ (Inner | Left | Right | Full) join tablename on fieldref = fieldref ]
101
2 Sintaxis de script
Adems, a veces se pueden concatenar varias sentencias SELECT en una sola mediante el uso de un
operador union:
La sentencia SELECT es interpretada por el driver ODBC o proveedor OLE DB, as que podran ocurrir
desviaciones de la sintaxis SQL general dependiendo de las capacidades de los drivers ODBC o proveedor
OLE DB, por ejemplo:
l
El driver ODBC a veces no acepta todos los tipos de comillas listados arriba.
Por favor, tenga en cuenta que no se trata de una descripcin completa de la sentencia SQL
SELECT. Por ej. Las sentencias SELECT pueden anidarse, pueden hacerse varios join en
una sentencia SELECT, el nmero de funciones permitidas en expresiones a veces es muy
grande, etc...
Argumentos:
Argumento
Descripcin
distinct
distinctrow
*fieldlist
102
2 Sintaxis de script
Argumento
Descripcin
from
<, <=, 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
join
join es un cualificador que establece si varias tablas se van a unir en una. Los nombres
de campo y los nombres de tabla deben estar entre comillas si contienen espacios en
blanco o letras de los juegos de caracteres nacionales. Cuando el script es generado
automticamente por Qlik Sense, las comillas empleadas sern las preferidas por el
driver ODBC u OLE DB, segn lo especificado en la definicin de la fuente de datos de la
sentencia Connect.
Ejemplo1:
SELECT * FROM `Categories`;
Ejemplo2:
SELECT `Category ID`, `Category Name` FROM `Categories`;
Ejemplo3:
SELECT `Order ID`, `Product ID`,
`Unit Price` * Quantity * (1-Discount) as NetSales
FROM `Order Details`;
Ejemplo4:
103
2 Sintaxis de script
SELECT `Order Details`.`Order ID`,
Sum(`Order Details`.`Unit Price` * `Order Details`.Quantity) as `Result`
FROM `Order Details`, Orders
where Orders.`Order ID` = `Order Details`.`Order ID`
group by `Order Details`.`Order ID`;
Set
La sentencia set se utiliza para definir variables de script. stas pueden servir para sustituir cadenas, rutas,
unidades de disco, etc.
Sintaxis:
Set variablename=string
Ejemplo1:
Set FileToUse=Data1.csv;
Ejemplo2:
Set Constant="My string";
Ejemplo3:
Set BudgetYear=2012;
Sleep
La sentencia sleep detiene la ejecucin de script por un tiempo especificado.
Sintaxis:
Sleep n
Argumentos:
Argumento
Descripcin
Indicado en milisegundos, donde n es un entero positivo no mayor que 3600000 (esto es, 1
hora). El valor puede ser una expresin.
Ejemplo1:
Sleep 10000;
Ejemplo2:
Sleep t*1000;
104
2 Sintaxis de script
SQL
La sentencia SQL permite lanzar un comando SQL a travs de una conexin ODBC u OLE DB.
Sintaxis:
SQL sql_command
El lanzamiento de sentencias SQL que actualizan la base de datos devolver un error si Qlik Sense ha
abierto la conexin ODBC en modo de solo lectura.
La sintaxis:
SQL SELECT * from tab1;
est permitida, y en documentacin futura ser la sintaxis preferida para SELECT, por razones de
coherencia. El prefijo SQL, sin embargo, ser opcional para sentencias SELECT.
Argumentos:
Argumento
Descripcin
sql_command
Ejemplo1:
SQL leave;
Ejemplo2:
SQL Execute <storedProc>;
SQLColumns
La sentencia sqlcolumns devuelve un conjunto de campos que describen las columnas de una fuente de
datos ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.
Sintaxis:
SQLcolumns
Los campos pueden combinarse con los campos generados por los comandos sqltables y sqltypes para
ofrecer una buena vista general de una determinada base de datos. Los doce campos estndar son:
TABLE_QUALIFIER
TABLE_OWNER
TABLE_NAME
COLUMN_NAME
105
2 Sintaxis de script
DATA_TYPE
TYPE_NAME
PRECISION
LENGTH
SCALE
RADIX
NULLABLE
REMARKS
Para una descripcin detallada de estos campos, consulte un manual de referencia de ODBC.
Ejemplo:
Connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd';
SQLcolumns;
Es posible que algunos drivers ODBC no admitan este comando. Algunos drivers ODBC
pueden crear campos adicionales.
SQLTables
La sentencia sqltables devuelve un conjunto de campos que describen las tablas de una fuente de datos
ODBC u OLE DB, a la que se ha hecho una conexin mediante connect.
Sintaxis:
SQLTables
Los campos pueden combinarse con los campos generados por los comandos sqlcolumns y sqltypes para
ofrecer una buena vista general de una determinada base de datos. Los cinco campos estndar son:
TABLE_QUALIFIER
TABLE_OWNER
TABLE_NAME
TABLE_TYPE
REMARKS
Para una descripcin detallada de estos campos, consulte un manual de referencia de ODBC.
Ejemplo:
106
2 Sintaxis de script
Connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd';
SQLTables;
Es posible que algunos drivers ODBC no admitan este comando. Algunos drivers ODBC
pueden crear campos adicionales.
SQLTypes
La sentencia sqltypes devuelve un conjunto de campos que describen los tipos de una fuente de datos
ODBC u OLE DB, a la cual se ha hecho una conexin mediante connect.
Sintaxis:
SQLTypes
Los campos pueden combinarse con los campos generados por los comandos sqlcolumns y sqltables para
ofrecer una buena vista general de una determinada base de datos. Los quince campos estndar son:
TYPE_NAME
DATA_TYPE
PRECISION
LITERAL_PREFIX
LITERAL_SUFFIX
CREATE_PARAMS
NULLABLE
CASE_SENSITIVE
SEARCHABLE
UNSIGNED_ATTRIBUTE
MONEY
AUTO_INCREMENT
LOCAL_TYPE_NAME
MINIMUM_SCALE
MAXIMUM_SCALE
Para una descripcin detallada de estos campos, consulte un manual de referencia de ODBC.
Ejemplo:
Connect to 'MS Access 7.0 Database; DBQ=C:\Course3\DataSrc\QWT.mbd';
107
2 Sintaxis de script
SQLTypes;
Es posible que algunos drivers ODBC no admitan este comando. Algunos drivers ODBC
pueden crear campos adicionales.
Star
La cadena empleada para representar el conjunto de todos los valores de un campo en una base de datos
puede establecerse mediante la sentencia star. Afecta a las sentencias LOAD y SELECT subsiguientes.
Sintaxis:
Star is[ string ]
Argumentos:
Argumento
Descripcin
string
Es un texto cualquiera. Observe que la cadena debe estar entre comillas si contiene
espacios en blanco.
Si no se especifica nada, se presupone star is;, es decir, no hay smbolo star disponible a
menos que se especifique explcitamente. Esta definicin es vlida hasta que se ejecute
una nueva sentencia star.
Ejemplos:
Star is *;
Star is %;
Star is;
Store
Esta funcin de script crea un archivo QVD o un CSV.
Sintaxis:
Store[ *fieldlist from] table into filename [ format-spec ];
La sentencia crea un archivo explcito QVD o CSV. La sentencia slo puede exportar campos de una tabla
de datos. Si hay que exportar campos de varias tablas, se debe hacer previamente un join explcito en el
script para crear la tabla de datos que se ha de exportar.
Los valores de texto se exportan al archivo CSV en formato UTF-8. Se puede especificar un delimitador,
vase LOAD. La sentencia store a un archivo CSV no permite exportacin a BIFF.
Argumentos:
108
2 Sintaxis de script
Argumento
Descripcin
filename
Absoluta
Ejemplo: c:\data\
l
Ejemplo: data\
Si se omite la ruta, Qlik Sense almacenar el archivo
en el directorio especificado por la sentencia
Directory. Si no hay ninguna sentencia Directory,
Qlik Sense almacenar el archivo en el directorio de
trabajo, C:\Users\{user}
\Documents\Qlik\Sense\Apps.
format-spec ::=( (txt | qvd ) )
Ejemplo:
Store mytable into xyz.qvd (qvd);
Store
109
2 Sintaxis de script
Store Name as a, RegNo as b from mytable into xyz.qvd;
store mytable into myfile.txt (txt);
store * from mytable into 'lib://FolderConnection/myfile.qvd';
Tag
Esta funcin de script permite asignar etiquetas a uno o ms campos. Si se intenta etiquetar un nombre de
campo no presente en la app, se ignora el etiquetado. Si hubiera mltiples nombres de un mismo campo o
etiqueta, se emplear el ltimo valor.
Sintaxis:
Tag fields fieldlist using mapname
Tag field fieldname with tagname
Un campo etiquetado con dimension se mostrar en la parte superior de los controles de seleccin de todos
los campos en Qlik Sense, excepto en el dilogo Editar expresin.
Un campo etiquetado con measure se mostrar en la parte superior de todos los controles de seleccin de
campos del dilogo Editar Expresin.
Argumentos:
Argumento
Descripcin
fieldlist
Es una lista de campos separados por coma, que no deberan etiquetarse ms all del
punto marcado en el script.
mapname
fieldname
tagname
Ejemplo1:
tagmap:
mapping LOAD * inline [
a,b
Alpha,MyTag
Num,MyTag
];
tag fields using tagmap;
Ejemplo2:
tag field Alpha with MyTag2;
110
2 Sintaxis de script
Trace
La sentencia trace escribe una cadena en la ventana de Progreso de Ejecucin de Script y en el archivo
de registro (log) del script, cuando ste se utiliza. Es muy til cuando se desea efectuar una depuracin.
Mediante el empleo de expansiones de signo dlar de variables que se calculan antes de la sentencia trace,
podemos personalizar el mensaje.
Sintaxis:
Trace string
Ejemplo1:
Trace Main table loaded;
Ejemplo2:
Let MyMessage = NoOfRows('MainTable') & ' rows in Main Table';
Trace $(MyMessage);
Unmap
La sentencia Unmap deshabilita el enlace de un valor de campo especificado por una sentencia Map
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;
Unmap A, B, C;
Unmap * ;
111
2 Sintaxis de script
Unqualify
La sentencia Unqualify sirve para desactivar la calificacin de nombres de campo que ha sido previamente
activada mediante la sentencia Qualify.
Sintaxis:
Unqualify *fieldlist
Argumentos:
Argumento
Descripcin
*fieldlist
Ejemplo1:
Unqualify *;
Ejemplo2:
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
mapname
fieldname
tagname
112
2 Sintaxis de script
Ejemplo1:
tagmap:
mapping LOAD * inline [
a,b
Alpha,MyTag
Num,MyTag
];
Untag fields using tagmap;
Ejemplo2:
Untag field Alpha with MyTag2;];
2.4
Una variable en Qlik Sense es una entidad con nombre propio que contiene un valor de datos nico. Una
variable normalmente adquiere su valor de una sentencia Let, Set u otra sentencia de control. En general, el
usuario puede cambiar el valor de una variable en cualquier momento. Las variables pueden contener datos
numricos o alfanumricos.
Si el primer carcter del valor de una variable es un signo igual ' = ', Qlik Sense tratar de evaluar el valor
como una frmula (o expresin de Qlik Sense) y a continuacin mostrar o devolver el resultado en lugar
del texto mismo de la frmula.
Cuando se emplea una variable, sta es sustituida por su valor. Las variables se pueden utilizar en el script
para expansin de signo dlar y en varias sentencias de control. Esto puede resultar de gran utilidad cuando
la misma cadena se repite muchas veces en el script, por ejemplo, una ruta.
Hay algunas variables de sistema especiales que Qlik Sense fija al comienzo de la ejecucin de script,
independientemente de cules fueran sus valores previos.
Cuando se define una variable de script, la sintaxis:
Ejemplos:
set HidePrefix = $ ; // la variable recibir el carcterr "$"
como valor.
113
2 Sintaxis de script
Clculo de variables
Hay varias maneras de utilizar variables con valores calculados en Qlik Sense y el resultado depende de
cmo se defina y de cmo se denomine en una expresin.
En este ejemplo cargamos algunos datos inline:
LOAD * INLINE [
Dim, Sales
A, 150
A, 200
B, 240
B, 230
C, 410
C, 330
];
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 132
pgina 121
Variables de sistema
pgina 115
pgina 119
114
2 Sintaxis de script
Variables de sistema
Las variables del sistema, algunas de las cuales estn definidas por el sistema, proporcionan informacin
sobre el sistema y la app Qlik Sense.
Floppy
Devuelve la letra de la primera unidad de disco que encuentra, normalmente a:. Esta es una variable
definida por el sistema.
Floppy
Esta variable no es posible en modo estndar.
CD
Devuelve la letra de la primera unidad de CD-ROM que encuentre. Si no encuentra ningn CD-ROM,
entonces devuelve c:. Esta es una variable definida por el sistema.
CD
Esta variable no es posible en modo estndar.
Include
La variable include especifica un archivo que contiene un texto que debe ser incluido en el script. As, el
script entero se puede incluir en un archivo. Esta es una variable definida por el usuario.
$(Include
=filename)
HidePrefix
Todos los nombres de campo que comiencen por esta cadena de texto, se ocultarn de la misma manera
que los campos del sistema. Esta es una variable definida por el usuario.
HidePrefix
HideSuffix
Todos los nombres de campo que terminen con esta cadena de texto se ocultarn de la misma forma que los
campos de sistema. Esta es una variable definida por el usuario.
HideSuffix
QvPath
Devuelve la cadena de bsqueda al ejecutable de Qlik Sense: Esta es una variable definida por el sistema.
115
2 Sintaxis de script
QvPath
Esta variable no es posible en modo estndar.
QvRoot
Devuelve el directorio raz del ejecutable de Qlik Sense: Esta es una variable definida por el sistema.
QvRoot
Esta variable no es posible en modo estndar.
QvWorkPath
Devuelve la cadena de bsqueda a la app actual de Qlik Sense. Esta es una variable definida por el sistema.
QvWorkPath
Esta variable no es posible en modo estndar.
QvWorkRoot
Devuelve el directorio raz de la app actual de Qlik Sense. Esta es una variable definida por el sistema.
QvWorkRoot
Esta variable no es posible en modo estndar.
StripComments
Si se fija esta variable en 0, se omitirn las lneas de comentario /*..*/ y // en el script. Si no se define esta
variable, las lneas de comentario se ejecutarn siempre.
StripComments
Verbatim
Normalmente todos los valores de campo son despojados automticamente de sus caracteres precedentes y
posteriores vacos (ASCII 32) antes de ser cargados en la base de datos de Qlik Sense. Si esta variable se
configura en 1, no se eliminarn estos caracteres vacos. El tabulador (ASCII 32) y el espacio fijo (ANSI 160)
nunca sufren esta accin.
Verbatim
OpenUrlTimeout
Esta variable define el tiempo de espera en segundos que Qlik Sense debe respetar cuando recibe datos
procedentes de fuentes URL (por ej. pginas HTML). Si se omite, el tiempo establecido ser de unos 20
minutos.
OpenUrlTimeout
116
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:
117
2 Sintaxis de script
set HideSuffix='%';
Si se emplea esta sentencia, los nombres de campo que terminen con un signo de porcentaje no se
mostrarn en las listas de nombres de campo cuando los campos del sistema estn ocultos.
Include
La variable include especifica un archivo que contiene un texto que debe ser incluido en el script. As, el
script entero se puede incluir en un archivo. Esta es una variable definida por el usuario.
Sintaxis:
$(Include =filename)
Ejemplo:
$(Include=abc.txt);
$(Include=lib://MyDataFiles\abc.txt);
Si no se especifica ninguna ruta, el nombre del archivo estar relacionado con el directorio de trabajo de la
app Qlik Sense. Tambin puede especificar una ruta de archivo absoluta o una ruta a una conexin de
carpeta lib://.
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
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
118
2 Sintaxis de script
Determinados drivers de bases de datos utilizan /*..*/ como ayudas de optimizacin en sentencias SELECT.
Si este es el caso, los comentarios no deberan vaciarse antes de enviar la sentencia SELECT al driver de la
base de datos.
Ejemplo:
set StripComments=0;
SQL SELECT * /* <optimization directive> */ FROM Table ;
set StripComments=1;
Verbatim
Normalmente todos los valores de campo son despojados automticamente de sus caracteres precedentes y
posteriores vacos (ASCII 32) antes de ser cargados en la base de datos de Qlik Sense. Si esta variable se
configura en 1, no se eliminarn estos caracteres vacos. El tabulador (ASCII 32) y el espacio fijo (ANSI 160)
nunca sufren esta accin.
Sintaxis:
Verbatim
Ejemplo:
set Verbatim = 1;
NullDisplay
El smbolo definido sustituir todos los valores NULL desde ODBC en el nivel ms bajo de los datos. Esta es
una variable definida por el usuario.
NullDisplay
NullInterpret
El smbolo definido ser interpretado como NULL cuando aparezca en un archivo de texto, archivo Excel o
en una sentencia inline. Esta es una variable definida por el usuario.
119
2 Sintaxis de script
NullInterpret
NullValue
Si se utiliza la sentencia NullAsValue, el smbolo definido sustituir a todos los valores NULL en los
campos especificados con NullAsValue por la cadena especificada.
NullValue
OtherSymbol
Define un smbolo para que sea tratado como 'todos los dems valores' antes de una sentencia
LOAD/SELECT. Esta es una variable definida por el usuario.
OtherSymbol
NullDisplay
El smbolo definido sustituir todos los valores NULL desde ODBC en el nivel ms bajo de los datos. Esta es
una variable definida por el usuario.
Sintaxis:
NullDisplay
Ejemplo:
set NullDisplay='<NULL>';
NullInterpret
El smbolo definido ser interpretado como NULL cuando aparezca en un archivo de texto, archivo Excel o
en una sentencia inline. Esta es una variable definida por el usuario.
Sintaxis:
NullInterpret
Ejemplos:
set NullInterpret=' ';
set NullInterpret =;
NO devolver valores NULL para valores en blanco en Excel (pero lo har para un archivo de
texto csv)
set NullInterpret ='';
devolver valores NULL para valores en blanco en Excel (pero NO lo har para un archivo de
texto csv)
NullValue
Si se utiliza la sentencia NullAsValue, el smbolo definido sustituir a todos los valores NULL en los
campos especificados con NullAsValue por la cadena especificada.
120
2 Sintaxis de script
Sintaxis:
NullValue
Ejemplo:
NullAsValue Field1, Field2;
set NullValue='<NULL>';
OtherSymbol
Define un smbolo para que sea tratado como 'todos los dems valores' antes de una sentencia
LOAD/SELECT. Esta es una variable definida por el usuario.
Sintaxis:
OtherSymbol
Ejemplo:
set OtherSymbol='+';
LOAD * inline
[X, Y
a, a
b, b];
LOAD * inline
[X, Z
a, a
+, c];
El valor de campo Y=b enlazar ahora con Z=c mediante el otro smbolo.
121
2 Sintaxis de script
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
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).
122
2 Sintaxis de script
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
La El nmero entero define qu da se utilizar como primer da de la semana.
FirstWeekDay
BrokenWeeks
La configuracin define si las semanas estn interrumpidas o no.
BrokenWeeks
ReferenceDay
La configuracin define qu da de enero se establece como da de referencia para definir la semana 1.
ReferenceDay
FirstMonthOfYear
El parmetro define qu mes usar como primer mes del ao, lo cual puede servir para definir aos
financieros que utilicen un desplazamiento mensual, por ejemplo, con inicio el 1 de abril.
Parmetros vlidos son 1 (enero) a 12 (diciembre). El parmetro por defecto es 1.
Sintaxis:
FirstMonthOfYear
Ejemplo:
123
2 Sintaxis de script
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
Ejemplos:
Set BrokenWeeks=0; //(use unbroken weeks)
Set BrokenWeeks=1; //(use broken weeks)
DateFormat
El formato definido reemplaza al formato de fecha del sistema operativo (configuracin regional).
Sintaxis:
DateFormat
Ejemplos:
Set DateFormat='M/D/YY'; //(US format)
Set DateFormat='DD/MM/YY'; //(UK date format)
Set DateFormat='YYYY-MM-DD'; //(ISO date format)
DayNames
El formato definido reemplaza a los nombres de los das de la semana del sistema operativo (configuracin
regional).
Sintaxis:
DayNames
Ejemplo:
124
2 Sintaxis de script
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
La El nmero entero define qu da se utilizar como primer da de la semana.
Sintaxis:
FirstWeekDay
Por defecto, las funciones de Qlik Sense utilizan el lunes como primer da de la semana. Se pueden utilizar
los siguientes valores:
l
0 (= lunes)
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)
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';
125
2 Sintaxis de script
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:
MoneyThousandSep
Ejemplo:
Set MoneyThousandSep=',';
126
2 Sintaxis de script
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:
ThousandSep
Ejemplos:
Set ThousandSep=','; //(for example, seven billion must be specified as: 7,000,000,000)
Set ThousandSep=' ';
127
2 Sintaxis de script
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]';
Ejemplo:
SET DirectCacheSeconds=1800
128
2 Sintaxis de script
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
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.
129
2 Sintaxis de script
SQLQueryPrefix
Esta cadena se enva con cada consulta en particular.
SET SQLSessionPrefix = 'SET QUERY_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) &
' FOR TRANSACTION;';
DirectStringQuoteChar
Podemos especificar un carcter para usar el entrecomillado de cadenas en una consulta generada. La
opcin predefinida es un entrecomillado simple. El carcter especificado debe ir rodeado de smbolos de
entrecomillado simple en la sentencia SET.
SET DirectStringQuoteChar= '"'
DirectIdentifierQuoteStyle
Podemos especificar que se utilice entrecomillado no ANSI en los identificadores en las consultas
generadas. Hoy por hoy, el nico entrecomillado no ANSI disponible es GoogleBQ. El valor predeterminado
es ANSI. Se pueden utilizar maysculas, minsculas y caracteres combinados (ANSI, ansi, Ansi).
SET DirectIdentifierQuoteStyle="GoogleBQ"
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
130
2 Sintaxis de script
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.
Ejemplo:
Set DirectMoneyDecimalSep='.';
DirectMoneyFormat
El smbolo definido reemplaza al formato de moneda de la sentencia SQL generada para cargar datos
utilizando Direct Discovery. El smbolo de moneda para el separador de miles no debera incluirse.
El valor por defecto es '#.0000'
Ejemplo:
Set DirectMoneyFormat='#.0000';
DirectTimeFormat
El formato de hora definido reemplaza al formato de hora de la sentencia SQL generada para cargar datos
utilizando Direct Discovery.
Ejemplo:
Set DirectTimeFormat='hh:mm:ss';
DirectDateFormat
El formato de fecha definido reemplaza al formato de fecha de la sentencia SQL generada para cargar datos
con Direct Discovery.
Ejemplo:
Set DirectDateFormat='MM/DD/YYYY';
DirectTimeStampFormat
El formato definido reemplaza al formato de fecha y hora de la sentencia SQL generada para cargar datos
con Direct Discovery.
131
2 Sintaxis de script
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.
ErrorMode
Esta variable de error establece qu accin llevar a cabo Qlik Sense cuando encuentre un error durante la
ejecucin de script.
ErrorMode
ScriptError
Esta variable de error devuelve el cdigo de error de la ltima sentencia ejecutada en el script.
ScriptError
ScriptErrorCount
Esta variable de error devuelve el nmero total de sentencias que han producido errores durante la actual
ejecucin de script. Esta variable siempre se pone a 0 al principio de la ejecucin del script.
ScriptErrorCount
ScriptErrorList
Esta variable de error contiene una lista concatenada de todos los errores de script que hayan ocurrido
durante la ltima ejecucin de script. Cada error va separado por una lnea.
ScriptErrorList
ErrorMode
Esta variable de error establece qu accin llevar a cabo Qlik Sense cuando encuentre un error durante la
ejecucin de script.
Sintaxis:
ErrorMode
Argumentos:
132
2 Sintaxis de script
Argumento
Descripcin
ErrorMode=1
ErrorMode
Qlik Sense simplemente ignorar el error y continuar la ejecucin del script con la
siguiente sentencia de script.
=0
ErrorMode
=2
Ejemplo:
set ErrorMode=0;
ScriptError
Esta variable de error devuelve el cdigo de error de la ltima sentencia ejecutada en el script.
Sintaxis:
ScriptError
Esta variable ser reestablecida a 0 tras cada sentencia de script ejecutada correctamente. Si ocurre un
error, ser configurada segn un cdigo de error interno de Qlik Sense. Los cdigos de error son valores
duales con un componente numrico y otro de texto. Los siguientes cdigos existen:
Cdigo
de error
Descripcin
Sin Error
Error general
Error de sintaxis
No se encontr el
archivo
No se encontr la base
de datos
133
2 Sintaxis de script
Cdigo
de error
Descripcin
10
No se encontr la tabla
11
No se encontr el
campo
12
13
Error de BIFF
14
15
Error de BIFF de
versin no compatible
16
Error semntico
Ejemplo:
set ErrorMode=0;
LOAD * from abc.qvf;
if ScriptError=8 then
exit script;
//no file;
end if
ScriptErrorCount
Esta variable de error devuelve el nmero total de sentencias que han producido errores durante la actual
ejecucin de script. Esta variable siempre se pone a 0 al principio de la ejecucin del script.
Sintaxis:
ScriptErrorCount
ScriptErrorList
Esta variable de error contiene una lista concatenada de todos los errores de script que hayan ocurrido
durante la ltima ejecucin de script. Cada error va separado por una lnea.
Sintaxis:
ScriptErrorList
2.5
Expresiones de script
Las expresiones pueden usarse tanto en la sentencia LOAD como en la sentencia SELECT. La sintaxis y
las funciones que se describen aqu se refieren a la sentencia LOAD y no a la sentencia SELECT, ya que
esta ltima la interpretar el driver ODBC y no Qlik Sense. Sin embargo, la mayora de los drivers ODBC
son, por lo general, capaces de interpretar las diversas funciones descritas a continuacin.
134
2 Sintaxis de script
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:
constant
fieldref
operator1 expression
function
(expression )
donde:
constant es una cadena (un texto, fecha u hora) entre comillas simples, o un nmero. Las constantes se
escriben sin separadores de miles y con un punto decimal como separador decimal.
fieldref es un nombre de campo de la tabla cargada.
operator1 es un operador unitario (que opera con una expresin, la de la derecha).
operator2 es un operador binario (que opera con dos expresiones, una a cada lado).
function ::= functionname( parameters)
parameters ::= expression { , expression }
El nmero y los tipos de parmetros no son aleatorios. Dependen de la funcin empleada.
Las expresiones y funciones pueden por tanto anidarse libremente, y siempre y cuando la expresin devuelva
un valor interpretable, Qlik Sense no emitir ningn mensaje de error.
135
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 Qlik Sense.
3.1
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
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
Anlisis de
conjuntos
Cualificador
TOTAL y
136
3 Expresiones de visualizacin
Mtodo
Descripcin
anlisis de
conjuntos
Year
Quarter
Sum(Amount)
Sum(TOTAL Amount)
Sum(Amount)/Sum(TOTAL Amount)
3000
3000
100%
2012
Q2
1700
3000
56,7%
2013
Q2
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 %.
Year
Quarter
Sum(Amount)
Sum({1} Amount)
Sum(Amount)/Sum({1} Amount)
3000
10800
27,8%
2012
Q1
1100
0%
2012
Q3
1400
0%
2012
Q4
1800
0%
2012
Q2
1700
1700
100%
2013
Q1
1000
0%
2013
Q3
1100
0%
2013
Q4
1400
0%
2013
Q2
1300
1300
100%
137
3 Expresiones de visualizacin
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
Q2
1700
10800
15,7%
2013
Q2
1300
10800
12%
3.2
La sintaxis completa (sin incluir el uso opcional de parntesis estndar para definir la precedencia) se
describe mediante el formalismo Backus-Naur:
138
3 Expresiones de visualizacin
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}>.
Se puede utilizar un modificador de conjuntos en un identificador de conjuntos o por s solo. No puede
emplearse en una expresin de conjunto. Cuando se utiliza en un identificador de conjuntos, el modificador
deber escribirse inmediatamente tras el identificador de conjunto, por ej. {$<Year = {2007, 2008}>}.
Cuando se emplea por s solo, se interpreta como una modificacin de la seleccin actual.
Hay varias formas de describir la seleccin, tal como se define a continuacin.
Exclusin forzada
Finalmente, para campos en modo and, hay tambin la posibilidad de una exclusin forzada. Si desea forzar
la exclusin de valores especficos de campo, necesitar emplear "~" frente al nombre de campo.
Ejemplos y resultados:
139
3 Expresiones de visualizacin
Ejemplos
Resultados
sum(
{1<Region=
{USA} >} Sales
)
sum( {$<Region
= >} Sales )
sum({<Region
= >} Sales )
Devuelve las ventas de la seleccin actual, pero con nuevas selecciones tanto en
" Year" como en " Region".
sum(
{$<~Ingredient
= {*garlic*}>}
Sales )
Devuelve las ventas de la seleccin actual, pero con una exclusin forzada de todos los
ingredientes que contengan la cadena " garlic".
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 )
sum({$<Year =
{>1978<2004}
>} Sales )
Igual que el anterior, pero ahora con una bsqueda numrica, de forma que se pueda
especificar un rango arbitrario.
Ejemplos y resultados:
140
3 Expresiones de visualizacin
Ejemplos
Resultados
sum({$<Product =
Product +
{OurProduct1}
{OurProduct2} >}
Sales )
sum({$<Year =
Year + ({20*,1997}
{2000}) >} Sales )
sum({$<Year =
(Year +
{20*,1997})
{2000} >} Sales )
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.
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.
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 comienzan por 20, excepto 2000.
Observe que si se incluye 2000 en la seleccin actual, se incluir todava tras la
modificacin. Igual que <Year=Year + ({20*,1997}{2000})>.
141
3 Expresiones de visualizacin
Ejemplos
Resultados
sum({$<Product *=
{OurProduct1} >} Sales
)
Ejemplos y resultados:
Ejemplos
Resultados
sum({$1<Product =
{*Internal*, *Domestic*}>}
Sales )
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.
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.
142
3 Expresiones de visualizacin
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 )
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.
3.4
La sintaxis empleada para expresiones de visualizacin (grfico) y agregaciones se describe en las secciones
siguientes.
143
3 Expresiones de visualizacin
expressionname
operator1 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 }
operator1 aggrexpression
functioninaggr
(aggrexpression )
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.
144
4 Operadores
Operadores
Esta seccin describe los operadores que se pueden utilizar en Qlik Sense. Hay dos tipos de 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.
Ejemplo:
17 bitand 7 devuelve 1
bitor
Bit or.
Ejemplo:
17 bitor 7 devuelve 23
bitxor
Bit or
exclusivo.
Ejemplo:
17 bitxor 7 devuelve 22
>>
Bit right
shift.
145
4 Operadores
Ejemplo:
8 >> 2 devuelve 2
<<
Bit left
shift.
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
and
or
Xor
4.3
Operadores numricos
Todos los operadores numricos usan los valores numricos de los operandos y devuelven un valor numrico
como resultado.
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.
146
4 Operadores
<
Menor que
<=
Menor o
igual que
>
Mayor que
>=
Mayor o
igual que
Igual
<>
Distinto
precedes
ASCII
menor que
Ejemplo:
' 11' precedes ' 2' devuelve True
follows
ASCII
mayor que
Ejemplo:
' 23' follows ' 111' devuelve True
147
4 Operadores
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.
&
Ejemplo:
'abc' & 'xyz' devuelve 'abcxyz'
like
Ejemplo:
'abc' like 'a*' devuelve True (-1)
'abcd' like 'a?c*' devuelve True (-1)
'abc' like 'a??bc' devuelve False (0)
148
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
Una funcin de agregacin agrega sobre el conjunto de registros posibles definidos por la seleccin y
devuelve un solo valor que describe una propiedad de varios registros de los datos, como por ejemplo una
suma o un recuento.
La mayora de funciones de agregacin pueden utilizarse tanto en el script de carga de datos como en las
expresiones de grficos, pero la sintaxis difiere.
149
Sintaxis:
Aggr({[DISTINCT] [NODISTINCT ]} expr, dim{, dimension})
Return data type: dual
Argumentos:
Argumento
Descripcin
expr
Expresin que suele estar compuesta por una funcin de agregacin. By default, the
aggregation function will aggregate over the set of possible records defined by the
selection.
dim
dimension
DISTINCT
NODISTINCT
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 una tabla simple temporal que puede utilizarse
en los grficos. Por ejemplo, estas funciones pueden usarse para buscar el valor mximo por cliente. De este
modo, se podr buscar el valor mnimo de la tabla temporal resultante. La funcin Aggr() nos sirve para
anidar la agregacin inicial y colocar eso en el interior de una funcin de agregacin bsica, por ejemplo,
Sum, Max o Count. Por ejemplo: Min(Aggr(Max(Value),Customer))
Limitaciones:
Cada dimensin debe estar constituida por un nico campo y no puede ser una expresin (dimensin
calculada).
Ejemplos y resultados:
150
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
Cree una tabla con Customer, Product, UnitPrice y UntiSales como dimensiones.
Ejemplo
Resultado
Min(Aggr(Max
(UnitPrice),
Customer))
Customer y devuelve una matriz de valores: 16, 19 y 25. Estos son los valores que
pueden verse en las filas de tabla de la columna de medida.
La agregacin Max(UnitPrice) produce un resultado para cada Product por Customer.
Utilizando esta expresin como el argumento expr en la funcin Aggr() y Customer
como el argumento dim, podemos hallar el resultado de Max(UnitPrice) por Customer.
Efectivamente, hemos construido una lista temporal de valores sin tener que crear un
grfico aparte que contenga dichos valores.
La fila de totales de la medida devuelve el valor 15 como resultado de la funcin Aggr()
incluida en la agregacin Min(). Ig es el valor mnimo de la matriz que devuelve la
expresin Aggr().
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 de cada Customer y Product.
151
Vea tambin:
p Funciones bsicas de agregacin (pgina 152)
Mode (expression )
Only
Only() devuelve un valor si hay nicamente un resultado posible en los datos agregados. Si los registros
152
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)
FirstSortedValue
FirstSortedValue() devuelve el valor de un campo basado en los valores ordenados de otro campo. Por
ejemplo, el producto con el precio de unidad ms bajo.
FirstSortedValue - funcin de grfico([{SetExpression}] [DISTINCT] [TOTAL
[<fld {,fld}>]] value, sort_weight [,rank])
Max
Max() halla el valor ms alto de los datos agregados. Al especificar un rank n, puede hallarse el ensimo
valor ms alto.
Max - funcin de 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
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
153
FirstSortedValue
FirstSortedValue() devuelve el valor de la primera expresin que se corresponde con el primer valor del
orden de clasificacin de la segunda expresin iterada en un nmero de registros, segn lo definido por una
clusula group by.
Sintaxis:
FirstSortedValue ([ distinct ] value, sort-weight [, rank ])
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
value
Expression
La funcin devuelve un valor del campo especificado en value asociado con el resultado de
ordenar el campo sort_weight, teniendo en cuenta rank, si se especifica. Si ms de un
valor obtenido comparte el mismo sort_weight para el rank especificado, la funcin
devuelve NULL.
sort-weight
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
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
MyProductWithLargestOrderByCustomer
AA
BB
DD
154
Resultado
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 '|');
FirstSortedValue:
LOAD Customer,FirstSortedValue(Product, UnitSales) as MyProductWithLargestOrderByCustomer
Resident Temp Group By Customer;
MyProductWithSmallestOrderByCustomer
CC
AA
DD
155
Descripcin
value
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_
SetExpression
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
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
156
Resultado
firstsortedvalue (Product,
UnitPrice)
firstsortedvalue (Product,
UnitPrice, 2)
firstsortedvalue (Customer,
UnitPrice, 3)
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 ( expression[, rank])
Tipo de datos devueltos:numrico
Argumentos:
Argumento
Descripcin
expr
Expression
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.
157
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
Customer
MyMaxRank2
Astrida
10
Betacab
Canutility
Max:
LOAD Customer, Max(UnitSales) as MyMax, Resident Temp Group By
Customer;
Sintaxis:
Max([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] expr [,rank])
Tipo de datos devueltos: numrico
Argumentos:
158
Descripcin
expr
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
TOTAL
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)
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)
159
Resultados
Max(UnitSales, 2)
Max(TOTALUnitSales)
Seleccione Customer B.
Max({1} TOTALUnitSales)
Vea tambin:
p FirstSortedValue - funcin de grfico (pgina 155)
p RangeMax (pgina 560)
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 ( expression[, rank])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
expr
160
Descripcin
Expression
rank
Expression
Ejemplos y resultados:
Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.
Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.
Ejemplo
Resultado
Temp:
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
Customer
MyMinRank2
Astrida
Betacab
Canutility
Min:
LOAD Customer, Min(UnitSales) as MyMin Resident Temp Group By
Customer;
Puede que tambin le convenga echar un vistazo a FirstSortedValue y rangemin, que tienen
una funcionalidad similar a la de la funcin Min.
161
Descripcin
expr
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
TOTAL
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
162
Ejemplos
Resultados
Min(UnitSales)
El valor de un pedido se
calcula a partir del nmero
de unidades vendidas en
(UnitSales) multiplicado por
el precio de unidad.
Min(UnitSales*UnitPrice)
Min(UnitSales, 2)
Min(TOTALUnitSales)
SeleccioneCustomer B.
Min({1} TOTALUnitSales)
Vea tambin:
p FirstSortedValue - funcin de grfico (pgina 155)
p RangeMin (pgina 563)
163
Sintaxis:
Mode ( expression )
Tipo de datos devueltos:dual
Argumento
Descripcin
expr Expression
Limitaciones:
Si ms de un valor es lo que se muestra con ms frecuencia, devuelve NULL.
Ejemplos y resultados:
Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.
Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.
Ejemplo
Resultado
Temp:
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;
164
Descripcin
expr
SetExpression
TOTAL
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
Mode(UnitPrice)
Seleccione
Customer A.
Devuelve NULL (-). Ningn valor nico ocurre ms a menudo que otro.
165
Resultados
Mode(Product)
Realice la
seleccin
Devuelve NULL (-). Ningn valor nico ocurre ms a menudo que otro.
Customer A
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.
Mode)({1}
TOTALUnitPrice)
Vea tambin:
p Avg - funcin de grfico (pgina 205)
p Median - funcin de grfico (pgina 237)
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 ( expression )
Tipo de datos devueltos: dual
Argumento
Descripcin
expr Expression
166
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;
Descripcin
expr
SetExpression
TOTAL
167
Descripcin
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)
Only({<Product={DD}>}
Customer)
Only({<UnitPrice={20}>}
UnitSales)
Only({<UnitPrice={15}>}
UnitSales)
168
Sum
Sum() calcula el total de los valores agregados en la expresin, segn lo definido por una clusula group
by.
Sintaxis:
sum ( [ distinct] expression)
Tipo de datos devueltos:numrico
Argumentos:
Argumento
Descripcin
distinct
expr Expression
Ejemplos y resultados:
Agregue el script de ejemplo en su app y ejectelo. A continuacin, agregue como mnimo los campos de la
columna de resultados en una hoja de su app para ver el resultado.
Para tener el mismo aspecto que en la columna inferior de resultados, en el panel de propiedades, bajo
Ordenar, cambie de Auto a Personalizado, a continuacin deseleccione el orden numrico y alfabtico.
Ejemplo
Resultado
Temp:
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;
169
Descripcin
expr
SetExpression
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:
Customer
Product
UnitSales
UnitPrice
Astrida
AA
16
Astrida
AA
10
15
Astrida
BB
Betacab
BB
10
Betacab
CC
20
170
Product
UnitSales
UnitPrice
Betacab
DD
25
Canutility
AA
15
Canutility
CC
19
Ejemplos
Resultados
Sum(UnitSales)
Sum(UnitSales*UnitPrice)
Sum
(TOTALUnitSales*UnitPrice)
Seleccione Customer B.
Sum({1}
TOTALUnitSales*UnitPrice)
171
Count
Count() se utiliza para agregar el nmero de valores, de texto y numricos en cada dimensin del grfico.
Count - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}
>]]} expr)
MissingCount
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)
172
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 devueltos: Entero
Argumentos:
Argumento
Descripcin
expr
distinct
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
Customer OrdersByCustomer
Astrida 3
Betacab 3
Canutility 2
Divadip 2
173
Resultado
Canutility|AA|3|8|15
Canutility|CC|||19
Divadip|CC|2|4|16
Divadip|DD|3|1|25
] (delimiter is '|');
Count1:
LOAD Customer,Count(OrderNumber) as
OrdersByCustomer Resident Temp Group By
Customer;
TotalOrderNumber
10
TotalOrderNumber
9
Descripcin
expr
SetExpression
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
174
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.
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.
Count (DISTINCT
[Customer])
4, porque al usar el cualificador Distinct, Count solo evala las veces que
aparece una nica vez.
Count (OrderNumber)/Count
({1} TOTALOrderNumber
175
Resultado
seleccionados
Count(TOTAL <Product>
OrderNumber)
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)
Tipo de datos devueltos: Entero
Argumentos:
Argumento
Descripcin
expr
distinct
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.
176
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
TotalMissingCountDistinct
1
Descripcin
expr
set_
expression
DISTINCT
Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.
TOTAL
177
Descripcin
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
Ejemplo
Resultado
MissingCount
([OrderNumber])
"0" cuenta como un valor y no una celda vaca. Sin embargo, si una
medida agrega a 0 para una dimensin esa dimensin no se incluir en
los grficos.
MissingCount
([OrderNumber])
/MissingCount
({1} Total
[OrderNumber])
178
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 devueltos: Entero
Argumentos:
Argumento
Descripcin
expr
distinct
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
Customer NullOrdersByCustomer
Astrida 0
Betacab 0
Canutility 1
179
Resultado
Canutility|AA|3|8|
Canutility|CC|NULL||
] (delimiter is '|');
Set NULLINTERPRET=;
NullCount1:
LOAD Customer,NullCount(OrderNumber) as
NullOrdersByCustomer Resident Temp Group By Customer;
Descripcin
expr
set_
expression
DISTINCT
Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.
TOTAL
Ejemplos y resultados:
Ejemplo
Resultado
NullCount
([OrderNumber])
180
NumericCount
NumericCount() devuelve el nmero de valores numricos encontrados en la expresin, segn lo definido
por una clusula group by.
Sintaxis:
NumericCount ( [ distinct ] expr)
Tipo de datos devueltos: Entero
Argumentos:
Argumento
Descripcin
expr
distinct
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
Customer
Astrida
Betacab
Canutility
Divadip
NumericCountByCustomer
3
2
0
2
181
Resultado
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;
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;
Descripcin
expr
set_
expression
DISTINCT
Si la palabra DISTINCT aparece antes que los argumentos de funcin, los duplicados
resultantes de la evaluacin de los argumentos de funcin sern descartados.
TOTAL
182
Descripcin
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
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])
"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)]
183
TextCount
TextCount() devuelve el nmero de valores de campo no numricos agregados en la expresin, segn lo
definido por una clusula group by.
Sintaxis:
TextCount ( [ distinct ] expr)
Tipo de datos devueltos: Entero
Argumentos:
Argumento
Descripcin
expr
distinct
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
Customer
Astrida
Betacab
Canutility
Divadip
ProductTextCount
3
3
2
2
184
Resultado
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;
LOAD Customer,TextCount(OrderNumber) as
OrderNumberTextCount Resident Temp Group By Customer;
Customer
Astrida
Betacab
Canutility
Divadip
OrderNumberTextCount
0
1
2
0
Descripcin
expr
SetExpression
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
Ejemplos y resultados:
185
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
Ejemplo
Resultado
TextCount
([Product])
"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 puede 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.
186
IRR
187
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 194)([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 de expresin que se repiten 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 devueltos: numrico
Argumentos:
188
Descripcin
value
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.
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;
Sintaxis:
IRR([TOTAL [<fld {,fld}>]] value)
Tipo de datos devueltos: numrico
Argumentos:
189
Descripcin
value
TOTAL
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.
Vea tambin:
p XIRR - funcin de grfico (pgina 194)
p Aggr - funcin de grfico (pgina 149)
190
Descripcin
discount_rate
value
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;
Year
Discount
NPV2_2013
2013
2013
0,1
0,2
-$3456,05
$5666,67
191
Resultado
Descripcin
discount_
rate
value
TOTAL
Limitaciones:
192
Ejemplos y resultados:
Ejemplo
Resultado
NPV(Discount, Payments)
-$540,12
Vea tambin:
p XNPV - funcin de grfico (pgina 197)
p Aggr - funcin de grfico (pgina 149)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
pmt
date
193
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 '|');
2013
XIRR2013
Year
0.5385
Cashflow1:
LOAD Year,XIRR(Payments, Date) as XIRR2013 Resident Cashflow Group By
Year;
date que se repiten a lo largo de las dimensiones del grfico. Todos los pagos son descontados segn una
base de un ao de 365 das.
Sintaxis:
XIRR([TOTAL [<fld {,fld}>]] pmt, date)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
pmt
date
TOTAL
194
Descripcin
pertenecen al valor dimensional actual, es decir, ignora las dimensiones del grfico.
El cualificador TOTAL puede ir seguido de una lista con uno o ms nombres de campo
entre parntesis angulares <fld>. Estos nombres de campo deberan ser un subgrupo de
las variables de dimensin del grfico.
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
Vea tambin:
p
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)
195
Descripcin
discount_
rate
pmt
date
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;
Year
Discount
XNPV2_2013
2013
2013
0,1
0,2
-$3164,35
$6800,00
196
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 devueltos: numrico El resultado tiene un formato numrico predeterminado de moneda.
Argumentos:
Argumento
Descripcin
discount_
rate
pmt
date
TOTAL
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
-$3164,35
197
Vea tambin:
p NPV - funcin de grfico (pgina 192)
p Aggr - funcin de grfico (pgina 149)
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
La funcin Correl() devuelve el coeficiente de correlacin agregado de una serie de coordenadas
representadas por nmeros pareados en x-expression y y-expression, reiteradas sobre un nmero de
registros segn lo definido por una clusula group by.
Kurtosis
([distinct ] expression )
LINEST_B
198
LINEST_f
Esta funcin de script devuelve la estadstica F agregada (r2/(1-r2)) de una regresin lineal definida por la
ecuacin y=mx+b 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_r2
LINEST_R2() devuelve el valor r2 agregado (coeficiente de determinacin) de una regresin lineal definida
por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la xexpression 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
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
LINEST_sey
199
LINEST_ssreg
LINEST_SSREG() devuelve la suma de regresin agregada de los cuadrados de una regresin lineal
definida por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la
x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.
LINEST_SSREG
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
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)
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.
Sterr
([distinct] expression)
STEYX
STEYX() devuelve el error estndar agregado del valor y predicho para cada valor x en la regresin para una
200
STEYX
(y-expression, x-expression)
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.
Fractile - funcin de grfico({[SetExpression] [TOTAL [<fld {, fld}>]]}
expr, fraction)
Kurtosis
Kurtosis() halla la kurtosis del rango de datos agregados en la expresin o campo que se repiten a lo largo
de las dimensiones del grfico.
Kurtosis - funcin de grfico({[SetExpression] [DISTINCT] [TOTAL [<fld{,
fld}>]]} expr)
LINEST_b
LINEST_B() devuelve el valor b agregado (interceptador de y) de una regresin lineal definida por la
ecuacin y=mx+b de una serie de coordenadas representadas por nmeros 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
201
202
203
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 devueltos:numrico
Argumentos:
Argumento
Descripcin
expr
DISTINCT
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
Avg1:
LOAD Customer, Avg(Sales) as MyAverageSalesByCustomer
Resident Temp Group By Customer;
Customer MyAverageSalesByCustomer
Astrida 43.1
Betacab 43.909091
204
Resultado
Canutility 55.909091
Divadip 61
Descripcin
expr
SetExpression
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
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:
205
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)
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.
206
Vea tambin:
p Aggr - funcin de grfico (pgina 149)
Correl
La funcin Correl() devuelve el coeficiente de correlacin agregado de una serie de coordenadas
representadas por nmeros pareados en x-expression y y-expression, reiteradas sobre un nmero de
registros segn lo definido por una clusula group by.
Sintaxis:
Correl(value1, value2)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value1,
value2
Las expresiones o campos que contienen los dos conjuntos de muestra para los que se ha
de medir el coeficiente de correlacin.
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
207
Resultado
Gauri Indu|Female|36|46000
Harry Jones|Male|38|40000
Ian Underwood|Male|40|45000
Jackie Kingsley|Female|23|28000
] (delimiter is '|');
Correl1:
LOAD Grp,
Correl(Age,Salary) as Correl_
Salary Resident Salary Group By
Grp;
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
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
Limitaciones:
208
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 mejorar
la legibilidad.
Correl
({1}
TOTAL
Age,
Salary))
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.
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.
209
Vea tambin:
p Aggr - funcin de grfico (pgina 149)
p Avg - funcin de grfico (pgina 205)
p RangeCorrel (pgina 553)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
expr
fraction
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
210
Resultado
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is '|');
Fractile1:
LOAD Type,
Fractile(Value,0.75) as
MyFractile Resident Table1 Group
By Type;
Descripcin
expr
fraction
SetExpression
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
211
Ejemplos y resultados:
Customer
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
Astrida
46
60
70
13
78
20
45
65
78
12
78
22
Betacab
65
56
22
79
12
56
45
24
32
78
55
15
Canutility
77
68
34
91
24
68
57
36
44
90
67
27
Divadip
57
36
44
90
67
27
57
68
47
90
80
94
Ejemplo
Resultado
Fractile
(Sales,
0.75)
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.
212
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 149)
Kurtosis
Kurtosis() devuelve la curtosis de los datos en la expresin en un nmero de registros definidos por una
clusula group by.
Sintaxis:
Kurtosis([distinct ] expr )
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
expr
distinct
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
213
Resultado
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
'|');
Kurtosis1:
LOAD Type,
Kurtosis(Value) as
MyKurtosis1,
Kurtosis(DISTINCT
Value) as MyKurtosis2
Resident Table1 Group
By Type;
Descripcin
expr
SetExpression
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
214
Descripcin
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.
215
Vea tambin:
p Avg - funcin de grfico (pgina 205)
LINEST_B
LINEST_B() devuelve el valor b agregado (que intercepta a y) de una regresin lineal definida por la
ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la x-expression y
y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula group by.
Sintaxis:
LINEST_B (y-value, x-value[, y0 [, x0 ]])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
216
Descripcin
y_value
x_value
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.
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
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.
217
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
218
Descripcin
y_value
x_value
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.
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
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.
219
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
LINEST_F
Esta funcin de script devuelve la estadstica F agregada (r2/(1-r2)) de una regresin lineal definida por la
ecuacin y=mx+b 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 ]])
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
220
Descripcin
y_value
x_value
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.
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
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.
221
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
222
Descripcin
y_value
x_value
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.
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
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.
223
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
LINEST_R2
LINEST_R2() devuelve el valor r2 agregado (coeficiente de determinacin) de una regresin lineal definida
por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la xexpression 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
224
Descripcin
y_value
x_value
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.
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
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.
225
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 ]])
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
226
Descripcin
y_value
x_value
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.
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
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.
227
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
228
Descripcin
y_value
x_value
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.
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
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.
229
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
230
Descripcin
y_value
x_value
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.
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
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.
231
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
LINEST_SSREG
LINEST_SSREG() devuelve la suma de regresin agregada de los cuadrados de una regresin lineal
definida por la ecuacin y=mx+b para una serie de coordenadas representadas por nmeros pareados en la
x-expression y y-expression que se repiten a lo largo de un nmero de registros definidos por una clusula
group by.
Sintaxis:
LINEST_SSREG (y-value, x-value[, y0 [, x0 ]])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
232
Descripcin
y_value
x_value
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.
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
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.
233
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
y(0), x(0)
Se puede especificar un valor y0 opcional que obligue a la lnea de regresin a pasar por el
eje y en un determinado punto. Especificando tanto y0 como x0 es posible forzar a la lnea
de regresin a que atraviese una nica coordenada fija.
A menos que se especifiquen ambos y0 y x0, la funcin requiere al menos dos pares de
datos vlidos para calcularse. Si se especifican y0 y x0, un nico par de datos bastar.
Limitaciones:
Los valores de texto, valores NULL y valores perdidos en una o ambas partes de un par de datos harn que
se descarte el par de datos completo.
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
234
Descripcin
y_value
x_value
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.
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
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:
235
Vea tambin:
p Un ejemplo de cmo utilizar las funciones linest (pgina 250)
p Avg - funcin de grfico (pgina 205)
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 devueltos:numrico
Argumentos:
Argumento
Descripcin
expr
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
En una tabla con las dimensiones Type y MyMedian, los resultados del clculo
Median() en el script de carga de datos son:
Type MyMedian
Comparison 2.5
Observation 26.5
236
Resultado
48|1
16|2
30|3
32|2
48|1
31|2
22|1
12|3
39|29
19|37
25|2 ] (delimiter is
'|');
Median1:
LOAD Type,
Median(Value) as MyMedian
Resident Table1 Group By
Type;
Descripcin
expr
SetExpression
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
237
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
Median
(Value)
Para una tabla que incluye la dimensin Type y la medida Median(Value), si se muestran los
Totales, el resultado es 19, para Comparison es 2,5 y para Observation es 26,5.
Median
(TOTAL
Value))
19 para todos los valores de Type, porque el cualificador TOTAL significa que las
dimensiones se omiten.
238
Vea tambin:
p Avg - funcin de grfico (pgina 205)
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
expr
DISTINCT
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
En una tabla con las dimensiones Type y MySkew, los resultados del clculo
Skew() en el script de carga de datos son:
Type MySkew
Comparison 0.86414768
Observation 0.32625351
239
Resultado
12|3
39|29
19|37
25|2 ] (delimiter is '|');
Skew1:
LOAD Type,
Skew(Value) as MySkew
Resident Table1 Group By
Type;
Descripcin
expr
SetExpression
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
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:
240
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
Skew
(Value)
Para una tabla que incluya la dimensin Type y la medida Skew(Value), si se muestran los
Totales y el formato numrico est fijado en 3 cifras significativas, el resultado es 0,235. Para
Comparison es 0,864 y para Observation es 0,3265.
Skew
(TOTAL
Value))
0,235 para todos los valores de Type, porque el cualificador TOTAL significa que las
dimensiones se omiten.
Vea tambin:
p Avg - funcin de grfico (pgina 205)
241
Sintaxis:
Stdev([distinct] expr)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
expr
distinct
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 MyStdev, los resultados del clculo
Stdev() en el script de carga de datos son:
Type MyStdev
Comparison 14.61245
Observation 12.50799
Stdev1:
242
Resultado
LOAD Type,
Stdev(Value) as MyStdev
Resident Table1 Group By
Type;
Descripcin
expr
SetExpression
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
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:
243
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
Stdev
(Value)
Para una tabla que incluye la dimensin Type y la medida Stdev(Value), si se muestran los
Totales, el resultado es 15,475, para Comparison es 14,612 y para Observation es 12,508.
Stdev
(TOTAL
Value))
es 15,475 para todos los valores de Type, porque el cualificador TOTAL significa que las
dimensiones se omiten.
Vea tambin:
p Avg - funcin de grfico (pgina 205)
p STEYX - funcin de grfico (pgina 249)
244
Sintaxis:
Sterr ([distinct] expr)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
expr
distinct
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
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
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
245
Resultado
19|37
25|2 ] (delimiter is '|');
Sterr1:
LOAD Type,
Sterr(Value) as MySterr
Resident Table1 Group By
Type;
Descripcin
expr
SetExpression
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
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:
246
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
Sterr
(Value)
Para una tabla que incluye la dimensin Type y la medida Sterr(Value), si se muestran los
Totales, el resultado es 2,447, para Comparison es 3,267 y para Observation es 2,797.
Sterr
(TOTAL
Value))
2,447 para todos los valores de Type, porque el cualificador TOTAL significa que las
dimensiones se omiten.
Vea tambin:
p Avg - funcin de grfico (pgina 205)
p STEYX - funcin de grfico (pgina 249)
247
Descripcin
y_value
x_value
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
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 '|';
STEYX1:
248
Resultado
LOAD Grp,
STEYX(KnownY,
KnownX) as MySTEYX
Resident Trend Group
By Grp;
value y x_value.
Sintaxis:
STEYX([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
y_value
x_value
SetExpression
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
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.
249
Ejemplos y resultados:
Data series
KnownX
17
16
14
11
10
KnownY
15
14
12
10
Ejemplo
Resultado
Steyx(KnownY,KnownX)
Steyx(TOTAL
KnownY,KnownX))
Vea tambin:
p Avg - funcin de grfico (pgina 205)
p Sterr - funcin de grfico (pgina 246)
250
251
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
1. En el editor de carga de datos, haga clic en para ir a la vista de la app, cree una nueva hoja y
brala.
2. Haga clic en @Editar para editar la hoja.
3. Desde Grficos aada un grfico de lneas, y desde Campos aada X como dimensin y Sum(Y)
como medida.
Se crea un grfico de lneas que representa el grfico de X contrastado con Y, desde donde se
calculan las funciones linest.
4. En Grficos, aada una tabla con 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.
252
Result
Linest functions
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 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 una muestra pequea.
Funciones de prueba Z
Un examen estadstico de dos promedios de poblacin. Una prueba z analiza si dos muestras son distintas y
es muy habitual utilizarla cuando dos distribuciones normales tienen variaciones conocidas y cuando un
experimento utiliza una gran tamao de muestra.
253
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 257)
p Funciones de prueba Z (pgina 292)
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:
254
Descripcin
col, row
actual_value
expected_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:
Chi2Test_chi2( Grp, Grade, Count )
Chi2Test_chi2( Gender, Description, Observed, Expected )
Vea tambin:
p Ejemplos de cmo utilizar funciones chi2-test en grficos (pgina 307)
p Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos (pgina 310)
Chi2Test_df
Chi2Test_df() devuelve el valor df (grado de libertad) 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_df(col, row, actual_value[, expected_value])
Tipo de datos devueltos: numrico
Argumentos:
255
Descripcin
col, row
actual_value
expected_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:
Chi2Test_df( Grp, Grade, Count )
Chi2Test_df( Gender, Description, Observed, Expected )
Vea tambin:
p Ejemplos de cmo utilizar funciones chi2-test en grficos (pgina 307)
p Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos (pgina 310)
Todos Qlik Sense Las funciones de prueba chi2 tienen los mismos argumentos.
Sintaxis:
Chi2Test_p(col, row, actual_value[, expected_value])
Tipo de datos devueltos: numrico
Argumentos:
256
Descripcin
col, row
actual_value
expected_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:
Chi2Test_p( Grp, Grade, Count )
Chi2Test_p( Gender, Description, Observed, Expected )
Vea tambin:
p Ejemplos de cmo utilizar funciones chi2-test en grficos (pgina 307)
p Ejemplos de cmo utilizar funciones chi2-test en el script de carga de datos (pgina 310)
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 una muestra pequea.
En los siguientes apartados, las funciones de prueba estadstica de prueba t se agrupan conforme a la
prueba de muestra de estudiante que se aplica a cada tipo de funcin.
Vea: Crear un informe t-test tpico (pgina 311)
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)
257
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])
258
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
259
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
260
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 devueltos: numrico
261
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 )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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:
262
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 )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
TTest_dif
TTest_dif() es una funcin numeric que devuelve la diferencia de medias agregada 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:
263
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 )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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:
264
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 )
TTest_lower( Group, Value, Sig, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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:
265
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 )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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:
266
Descripcin
value
Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.
grp
El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.
eq_var
Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplos:
TTest_sterr( Group, Value )
TTest_sterr( Group, Value, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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.
267
Para poder utilizar esta funcin debemos cargar valores de muestra en el script empleando
crosstable.
Sintaxis:
TTest_t(grp, value[, eq_var])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.
grp
El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.
eq_var
Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplo:
p Crear un informe t-test tpico (pgina 311)
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:
268
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 )
TTest_upper( Group, Value, sig, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 de dos muestras independientes, 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.
269
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
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:
TTestw_conf( Weight, Group, Value )
TTestw_conf( Weight, Group, Value, sig, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
TTestw_df
TTestw_df() devuelve el valor df (grados de libertad) agregado de la prueba t de estudiante de dos series
independientes de valores.
270
Sintaxis:
TTestw_df (weight, grp, value [, eq_var])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
weight
grp
El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.
value
Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.
eq_var
Si se especifica eq_var como False (0), se asumirn variaciones distintas de las dos
muestras. Si se especifica eq_var como True (1), se asumirn variaciones iguales de las
dos muestras.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplos:
TTestw_df( Weight, Group, Value )
TTestw_df( Weight, Group, Value, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
271
Sintaxis:
TTestw_dif (weight, group, value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.
weight
grp
El campo que contiene los nombres de cada uno de los dos grupos de muestra. Si no se
introduce un nombre de campo para el grupo en el script de carga, el campo se nombrar
automticamente como Type.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplos:
TTestw_dif( Weight, Group, Value )
TTestw_dif( Weight, Group, Value, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
272
Sintaxis:
TTestw_lower (weight, grp, value [, sig [, eq_var]])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
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 )
273
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 de dos muestras independientes, 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_sig ( weight, grp, value [, eq_var])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
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.
274
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 de dos muestras independientes, 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_sterr (weight, grp, value [, eq_var])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
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:
275
Ejemplos:
TTestw_sterr( Weight, Group, Value )
TTestw_sterr( Weight, Group, Value, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
TTestw_t
TTestw_t() devuelve el valor t agregado de dos series independientes de valores.
Esta funcin se aplica a dos pruebas t de estudiante de dos muestras independientes, en las que la serie de
datos de entrada se suministra en un formato de dos columnas ponderadas.
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 devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.
weight
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.
276
Ejemplos:
TTestw_t( Weight, Group, Value )
TTestw_t( Weight, Group, Value, false )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 de dos muestras independientes, 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
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.
277
Descripcin
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 )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 sola 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
278
Descripcin
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 311)
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 sola 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
Limitaciones:
279
Ejemplo:
TTest1_df( Value )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 sola 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_dif (value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplo:
TTest1_dif( Value )
280
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 sola 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])
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 311)
281
Sintaxis:
TTest1_sig (value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
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 311)
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 sola 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.
282
Sintaxis:
TTest1_sterr (value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplo:
TTest1_sterr( Value )
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 sola 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 devueltos: numrico
Argumentos:
283
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
Limitaciones:
Los valores de texto, los valores NULL y los valores perdidos en el valor de la expresin darn como resultado
que la funcin devuelva NULL.
Ejemplo:
TTest1_t( Value )
TTest1_upper
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 sola 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
sig
El nivel de significacin de cola 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:
284
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 los datos de entrada se
suministran 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
weight
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 )
285
Vea tambin:
p Crear un informe t-test tpico (pgina 311)
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 los datos de entrada se
suministran 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 devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
weight
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 311)
286
Sintaxis:
TTest1w_dif (weight, value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
weight
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 311)
TTest1w_lower
TTest1w_lower() devuelve el valor agregado para el extremo inferior del intervalo de confianza de una serie
de valores.
287
Sintaxis:
TTest1w_lower (weight, value [, sig ])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
weight
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 311)
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 los datos de entrada se
suministran en un formato de dos columnas ponderadas.
288
Sintaxis:
TTest1w_sig (weight, value)
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
weight
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 311)
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 los datos de entrada se
suministran 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.
289
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
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 311)
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 los datos de entrada se
suministran 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)
Tipo de datos devueltos: numrico
Argumentos:
290
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
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 311)
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 los datos de entrada se
suministran 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])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Las muestras que se han de evaluar. Si no se introduce un nombre de campo para los
valores de muestra en el script de carga, el campo se nombrar automticamente como
Value.
291
Descripcin
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 311)
Funciones de prueba Z
Un examen estadstico de dos promedios de poblacin. Una prueba z analiza si dos muestras son distintas y
es muy habitual utilizarla cuando dos distribuciones normales tienen variaciones conocidas y cuando un
experimento utiliza una 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 315)
ztest_conf
ZTest_conf() devuelve el valor z agregado de una serie de valores.
ZTest_conf (value [, sigma [, sig ])
ztest_dif
292
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.
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.
293
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])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.
sigma
Limitaciones:
294
Ejemplo:
ZTest_z( Value-TestValue )
Vea tambin:
p Ejemplos de cmo utilizar funciones z-test (pgina 315)
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])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.
sigma
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)
295
Vea tambin:
p Ejemplos de cmo utilizar funciones z-test (pgina 315)
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])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.
sigma
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 315)
ZTest_sterr
ZTest_sterr() devuelve el error estndar agregado de la prueba z de la diferencia de media de una serie de
valores.
296
Sintaxis:
ZTest_sterr(value[, sigma])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
valores de muestra.
sigma
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 315)
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]])
Tipo de datos devueltos: numrico
297
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
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 315)
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]])
Tipo de datos devueltos: numrico
Argumentos:
298
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 315)
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:
ZTest_upper (grp, value [, sig [, eq_var]])
Tipo de datos devueltos: numrico
299
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 315)
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.
Si la funcin se utiliza en una expresin de grfico, los valores se repiten a lo largo de las dimensiones del
grfico.
Sintaxis:
300
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
sigma
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 315)
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])
Tipo de datos devueltos: numrico
Argumentos:
301
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
sigma
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 315)
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])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores deben ser devueltos por value. Se asume una media de 0 como muestra. Si
302
Descripcin
desea que el test se realice conforme a otra media distinta, reste dicho valor de los valores
de muestra.
weight
sigma
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 315)
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])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores deben ser devueltos por value. Se asume una media de 0 como muestra. Si
303
Descripcin
desea que el test se realice conforme a otra media distinta, reste dicho valor de los valores
de muestra.
weight
sigma
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 315)
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]])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Se supone una media de poblacin de 0. Si
desea que el test se realice conforme a otra media distinta, reste dicha media valor de los
304
Descripcin
valores de muestra.
weight
sigma
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 315)
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]])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
value
Los valores de muestra que se han de evaluar. Los valores de muestra deben ser
agrupados de forma lgica segn lo especificado por exactamente dos valores en group.
305
Descripcin
Si no se introduce un nombre de campo para los valores de muestra en el script de carga,
el campo se nombrar automticamente como Value.
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 315)
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:
ZTestw_upper (grp, value [, sig [, eq_var]])
Tipo de datos devueltos: numrico
Argumentos:
306
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 315)
307
308
1. En el editor de carga de script, haga clic en para ir a la vista de app y, a continuacin, haga clic en
la hoja que cre anteriormente.
Se abre la vista de hoja.
2. Haga clic en @Editar para editar la hoja.
3. Desde Grficos aada una tabla, y desde Campos aada GrpGrade y Count como dimensiones.
Esta tabla muestra los datos de muestra.
4. Aada otra tabla con la siguiente expresin como dimensin:
ValueList('p','df','Chi2')
Esto usa la funcin de dimensiones sintticas para crear etiquetas para las dimensiones con los
nombres de las tres funciones chi2-test.
Esto produce el efecto de poner el valor resultante de cada funcin chi2-test de la tabla junto a su
dimensin sinttica asociada.
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:
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).
309
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
15
20
26
19
II
10
11
15
21
16
310
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
df
16.00
0.007
II
9.40
0.094
311
Group Statistics
Type
Mean
Standard Deviation
Comparison
20
11.95
14.61245
3.2674431
Observation
20
27.15
12.507997
2.7968933
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
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
15|31
21|1
14|19
46|1
10|34
28|3
48|1
16|2
30|3
32|2
48|1
312
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.
1. En el editor de carga de script, haga clic en para ir a la vista de app y, a continuacin, haga clic en
la hoja que cre anteriormente.
As se abre la vista de hoja.
2. Haga clic en @Editar para editar la hoja.
3. En Grficos aada una tabla y en Campos aada las expresiones siguientes como medidas:
Etiqueta
Expresin
Count(Value)
Mean
Avg(Value)
Standard Deviation
Stdev(Value)
Sterr(Value)
Type
Mean
Standard Deviation
Comparison
20
11.95
14.61245
3.2674431
Observation
20
27.15
12.507997
2.7968933
3. En Grficos aada una tabla con las expresiones siguientes como medidas:
313
Expresin
conf
df
Sig. (2-tailed)
Mean Difference
TTest_dif(Type, Value)
Standard Error
Difference
95% Confidence
Interval of the
Difference (Lower)
95% Confidence
Interval of the
Difference (Upper)
Result
Una tabla Independent Sample Test para estas muestras tendr el aspecto siguiente:
Sig.
t
df
(2taile
d)
Mean
Differenc
e
95%
95%
Standard
Confidenc
Confidenc
Error
Differenc
e Interval
e Interval
of the
of the
Difference
Difference
(Lower)
(Upper)
Equal
Varianc
e not
Assume
d
3.53
4
37.1167173358
23
0.001
15.2
4.30101
6.48625
23.9137
Equal
Varianc
e
Assume
d
3.53
4
38
0.001
15.2
4.30101
6.49306
23.9069
314
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
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.
315
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. Sin embargo, para ZTest Sig, por
ejemplo, utilice el formato numrico: Personalizado y, a continuacin, ajuste 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
Value
5.48
27.15
0.001
2.80
9.71
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:
316
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
(expression)
LastValue
LastValue() devuelve el valor cargado en ltimo lugar en los registros definidos por la expresin, ordenados
por una clusula group by.
(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
317
MinString (expression )
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:
Concat ([ distinct ] string [, delimiter [, sort-weight]])
Tipo de datos devueltos:cadena
Argumentos:
La expresin o campo que contiene la cadena que se ha de procesar.
Argumento
Descripcin
string
delimiter
318
Descripcin
sort-weight
distinct
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;
TeamConcat2
East
Delta-Beta-Gamma-Alpha
West
Eta-Epsilon-Zeta-Theta
319
Descripcin
string
delimiter
sort-weight
SetExpression
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
Ejemplos y resultados:
SalesGroup
Amount
Concat(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
320
Resultado
Concat(Team)
Concat
(DISTINCT
Team,', ')
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 por el valor
de la dimensin Amount. Los resultados pasan a ser DeltaBetaGammaGammaAlpha y
EtaEpsilonZEtaTheta.
FirstValue
FirstValue() devuelve el valor cargado primero en los registros definidos por la expresin, ordenados por una
clusula group by.
Sintaxis:
321
Descripcin
expr
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
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.
Sintaxis:
LastValue ( expr )
Tipo de datos devueltos:dual
322
Descripcin
expr
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.
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 devueltos:dual
Argumentos:
323
Descripcin
expr
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
MaxString1
East
Gamma
West
Zeta
SalesGroup
MaxString2
East
01/11/2013
West
01/12/2013
Concat1:
LOAD SalesGroup,MaxString(Team) as MaxString1 Resident TeamData Group
By SalesGroup;
324
Descripcin
expr
SetExpression
TOTAL
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
Esta tabla representa todos los valores de la dimensin Customer con los valores Product
correspondientes. En una visualizacin de tabla real en una hoja, encontrar una fila para cada
valor de Customer y Product.
Ejemplo
Resultado
MaxString
(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.
325
Resultado
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';'
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:
MinString ( expr )
Tipo de datos devueltos:dual
Argumentos:
Argumento
Descripcin
expr
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
SalesGroup
MinString1
326
Resultado
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 '|');
East
Alpha
West
Epsilon
SalesGroup
MinString2
East
01/05/2013
West
01062/2013
Concat1:
LOAD SalesGroup,MinString(Team) as MinString1 Resident TeamData Group
By SalesGroup;
Descripcin
expr
SetExpression
TOTAL
Ejemplos y resultados:
327
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';'
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 '|');
328
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 ]])
Sintaxis:
ValueList(v1 {,...})
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
v1
Valor esttico (suele ser una cadena, pero puede ser un nmero).
{,...}
Ejemplos y resultados:
Ejemplo
Resultado
ValueList('Number
of Orders',
'Average Order
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
329
Resultado
Size', 'Total
Amount')
=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:
330
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.
Sintaxis:
ValueLoop(from [, to [, step ]])
Tipo de datos devueltos: dual
Argumentos:
Argumentos
Descripcin
from
to
step
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)
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
331
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 149)
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 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, en el que el
color viene definido con los valores de hue, saturation y luminosity entre 0 y 255.
332
RGB (r, g, b)
Color
Color() se utiliza en expresiones para devolver la representacin de color del color nmero n en la paleta
pertinente 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 RGB 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.
l
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.
Colormix2
Colormix2() se utiliza en expresiones para devolver una representacin de color RGB 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
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.
333
SysColor
SysColor() devuelve la representacin de color RGB 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 la representacin de 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
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 la representacin de un color desde un mapa de color que empieza con el color
azul, para 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)
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)
334
(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)
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 devueltos: dual
Argumentos:
Argumento
Descripcin
alpha
r, g, b
Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 255.
Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los
valores de los componentes de color sern ms fciles de ver.Por ejemplo, el verde claro tiene el nmero 4
278 255 360, que en notacin hexadecimal es FF00FF00.Las dos primeras posiciones FF (255) denotan el
factor alpha.Las dos siguientes posiciones 00 denotan la cantidad de red, las dos posiciones siguientes
FF denotan la cantidad de green y las dos ltimas posiciones 00 denotan la cantidad de blue.
335
Sintaxis:
RGB (r, g, b)
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
r, g, b
Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 255.
Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los
valores de los componentes de color sern ms fciles de ver.Por ejemplo, el verde claro tiene el nmero 4
278 255 360, que en notacin hexadecimal es FF00FF00.Las dos primeras posiciones FF (255) denotan el
factor alpha.En las funciones RGB y HSL, ste es siempre FF (opaco).Las dos siguientes posiciones 00
denotan la cantidad de 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, en el que el
color viene definido con los valores de hue, saturation y luminosity entre 0 y 255.
Sintaxis:
HSL (hue, saturation, luminosity)
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
hue,
saturation,
luminosity
336
Todos los argumentos deben ser expresiones que devuelvan enteros en el rango comprendido
entre 0 y 255.
Si se va a interpretar el componente numrico y se le va a asignar el formato en notacin hexadecimal, los
valores de los componentes de color sern ms fciles de ver. Por ejemplo, el verde claro tiene el nmero 4
286 080 100, que en notacin hexadecimal es FF786464. Las dos primeras posiciones FF (255) denotan el
factor alpha.En las funciones RGB y HSL, ste es siempre FF (opaco). Las siguientes dos posiciones 78
denotan el componente de hue, las siguientes dos posiciones 64 denotan la saturation y las ltimas dos
posiciones 64 denotan el componente luminosity.
5.3
Funciones condicionales
Las funciones condicionales evalan todas una condicin y a continuacin devuelven distintas respuestas
dependiendo del valor de la condicin. Las funciones pueden utilizarse en el script de carga de datos y en las
expresiones de grficos.
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.
337
alt
La funcin alt devuelve el primer parmetro que tiene una representacin numrica vlida. Si no se
encuentra tal condicin, devolver el ltimo parmetro. Se puede utilizar cualquier nmero de parmetros.
Sintaxis:
alt(case1[ , case2 , case3 , ...] , else)
La funcin alt se emplea a menudo junto con funciones de interpretacin de nmeros o fechas. De esta
manera, Qlik Sense puede probar distintos formatos de fecha en un orden priorizado. Puede utilizarse para
gestionar los valores NULL en expresiones numricas.
Ejemplos y resultados:
Ejemplo
Resultado
alt(Sales,0) + alt(Margin,0)
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.
338
Descripcin
interval
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
devuelve '20<=x<30'
devuelve '15<=x<25'
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
[ Age, Name
25, John
42, Karen
53, Yoshi];
339
Name
Age
Agegroup
John
25
Karen
42
Yoshi
53
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,
Descripcin
condition
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
Ejemplos y resultados:
Ejemplo
Resultado
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 ])
340
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])
Argumentos:
Argumento
Descripcin
n es un entero entre 1 y N.
Ejemplos y resultados:
341
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.
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.
342
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.
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.
343
Solo 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.
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 *,
344
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:
345
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 autonumberhash128 (pgina 346)
p autonumberhash256 (pgina 348)
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.
Solo 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. Para
utilizar teclas 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
346
Year
Month
Sales
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 *,
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
];
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;
347
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 autonumberhash256 (pgina 348)
p autonumber (pgina 344)
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.
Solo 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. Para
utilizar teclas persistentes entre cargas de datos, independientemente del orden de los datos
fuente, utilice las funciones hash128, hash160 o hash256.
Sintaxis:
autonumberhash256(expression {, expression})
348
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
];
Region
Year
Month
Sales
RYMkey
North
2014
May
245
North
2014
May
347
North
2014
June
127
South
2014
June
645
349
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 autonumberhash128 (pgina 346)
p autonumber (pgina 344)
350
Sintaxis:
fieldvaluecount(fieldname)
Ejemplo:
En este ejemplo, el nmero de regiones se cuenta y se almacena en la variable RegionCount. Este valor, 2
en este caso, puede utilizarse para nuevas transformaciones en las que necesite conocer el nmero de
regiones existentes.
LOAD * INLINE
[ Region, Year, Month, Sales
South, 2014, June, 645
North, 2014, May, 245
North, 2014, May, 347
North, 2014, June, 127
South, 2013, May, 367
South, 2013, July, 221 ];
Let RegionCount = FieldValueCount('Region');
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;
LOAD * INLINE
[StartDate, EndDate
2014-01-22, 2014-01-26
];
351
Resultado
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.
352
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.
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.
353
RecNo( )
RowNo( )
aa
ee
yy
zz
Sintaxis:
RowNo([TOTAL])
Tipo de datos devueltos: Entero
Argumentos:
354
Descripcin
TOTAL
Limitaciones:
Ejemplos y resultados:
Customer
UnitSales
Row in Segment
Row Number
Astrida
Astrida
10
Astrida
Betacab
Betacab
Betacab
25
Canutility
10
Canutility
Divadip
Divadip
Ejemplos
Resultados
Agregue la expresin:
IF( RowNo( )=1, 0, UnitSales / Above(
UnitSales ))
355
Vea tambin:
p Above - funcin de grfico (pgina 504)
5.5
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.
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).
356
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)
month
Esta funcin devuelve un valor dual con un nombre de mes tal y como venga definido en la variable de
entorno MonthNames y un entero entre 1-12. El mes se calcula a partir de la interpretacin de la fecha de la
expresin, conforme a la interpretacin numrica estndar.
month (expression)
year
Esta funcin devuelve un entero que representa el ao en que la expression se interpreta como una fecha
conforme a la interpretacin numrica estndar.
year (expression)
weekyear
Esta funcin devuelve el ao al que pertenece el nmero de semana conforme a la ISO 8601. El nmero de
357
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)
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.
Funciones make
makedate
Esta funcin devuelve una fecha calculada desde el ao YYYY, el mes MM y el dia DD.
makedate (YYYY [ , MM [ , DD ] ])
makeweekdate
Esta funcin devuelve una fecha calculada a partir del ao YYYY, la semana WW y el da de la semana D.
makeweekdate (YYYY [ , WW [ , D ] ])
maketime
Esta funcin devuelve una hora calculada a partir del ao hh, el minuto mm y los segundos ss.
358
addyears (startdate, n)
yeartodate
Esta funcin encuentra si la fecha de entrada cae en el ao de la fecha en la que se carg el script, y
devuelve True en caso afirmativo, y False en caso negativo.
timezone ( )
GMT
Esta funcin devuelve la actual hora Greenwich Mean Time, tal y como lo extrae del reloj del sistema y las
configuraciones horarias de Windows.
GMT ( )
UTC
Devuelve la actual Coordinated Universal Time.
UTC ( )
daylightsaving
Devuelve el ajuste actual de cambio de hora automtico, segn el horario de verano, tal y como se define en
Windows.
daylightsaving ( )
converttolocaltime
Convierte una fecha-hora 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.
setdateyear
(timestamp, year)
setdateyearmonth
359
setdateyearmonth
Funciones in...
inyear
Esta funcin devuelve True si timestamp se encuentra dentro del ao que contiene base_date.
inyeartodate
inquarter
Esta funcin devuelve True si timestamp se encuentra dentro del trimestre que contiene base_date.
inquarter
inquartertodate
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del trimestre que contiene base_
inmonth
Esta funcin devuelve True si timestamp se encuentra dentro del mes que contiene base_date.
inmonthtodate
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.
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.
360
inweek
Esta funcin devuelve True si timestamp se encuentra dentro de la semana que contiene base_date.
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
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
inday
Esta funcin devuelve True si timestamp se encuentra dentro del da que contiene a base_timestamp.
361
362
363
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.
firstworkdate
La funcin firstworkdate devuelve la ltima fecha de inicio para obtener un no_of_workdays (de lunes a
364
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])
Argumentos:
Argumento
Descripcin
startdate
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:
365
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)
Argumentos:
Argumento
Descripcin
startdate
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.
Argumentos:
366
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.
Employess:
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 |);
DoBTable:
Load *,
age(LocalTime(),DateOfBirth) As Age
Resident Employees;
Drop table Employees;
Member
DateOfBirth
Age
John
28/03/1989
25
Linda
10/12/1990
23
Steve
5/2/1992
22
Birg
31/3/1993
21
Raj
19/5/1994
20
Prita
15/9/1994
20
Su
11/12/1994
19
Goran
2/3/1995
19
Sunny
14/5/1996
18
Ajoa
13/6/1996
18
Daphne
7/7/1998
16
Biffy
4/8/2000
14
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:
367
Central America
Kabul
Nairobi
Sydney
Adelaide
Kamchatka
New Caledonia
Taipei
Alaska
Chennai
Karachi
New Delhi
Tallinn
Amsterdam
Chihuahua
Kathmandu
Newfoundland
Tashkent
Arizona
Chongqing
Kolkata
Novosibirsk
Tbilisi
Astana
Copenhagen
Krasnoyarsk
Nuku'alofa
Tehran
Athens
Darwin
Kuala Lumpur
Osaka
Tokyo
Atlantic Time
(Canada)
Dhaka
Kuwait
Urumqi
Auckland
Kyiv
Paris
Warsaw
Azores
Edinburgh
La Paz
Perth
Wellington
Baghdad
Ekaterinburg
Lima
Port Moresby
West Central
Africa
Baku
Fiji
Lisbon
Prague
Vienna
Bangkok
Georgetown
Ljubljana
Pretoria
Vilnius
Beijing
Greenland
London
Quito
Vladivostok
Belgrade
Greenwich Mean
Time : Dublin
Madrid
Riga
Volgograd
Berlin
Guadalajara
Magadan
Riyadh
Yakutsk
Bern
Guam
Mazatlan
Rome
Yerevan
Bogota
Hanoi
Melbourne
Samoa
Zagreb
Brasilia
Harare
Mexico City
Santiago
368
Hawaii
Mid-Atlantic
Sapporo
Brisbane
Helsinki
Minsk
Sarajevo
Brussels
Hobart
Karachi
Saskatchewan
Bucharest
Hong Kong
Kathmandu
Seoul
Budapest
Indiana (East)
Kolkata
Singapore
Buenos Aires
International Date
Line West
Monrovia
Skopje
Cairo
Irkutsk
Monterrey
Sofia
Canberra
Islamabad
Moscow
Solomon Is.
Istanbul
Sri
Jayawardenepura
Caracas
Jakarta
Mumbai
St. Petersburg
Casablanca
Jerusalem
Muscat
Stockholm
Ejemplos y resultados:
Ejemplo
Resultado
ConvertToLocalTime('2007-11-10 23:59:00','Paris')
ConvertToLocalTime(UTC(), 'GMT-05:00')
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)
Ejemplos y resultados:
369
Resultado
day( '1971-10-12' )
devuelve 12
day( '35648' )
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
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
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')
370
Resultado
la tabla.
InvDate
DEnd
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
];
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
InvoiceData:
LOAD *,
DayEnd(InvDate, 1) AS DEnd
Resident TempTable;
Drop table TempTable;
7/7/2014
08/07/2014 23:59:59
4/8/2014
05/08/2014 23:59:59
daylightsaving
Devuelve el ajuste actual de cambio de hora automtico, segn el horario de verano, tal y como se define en
Windows.
Sintaxis:
DaylightSaving( )
Ejemplo:
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:
371
Descripcin
time
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
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')
Devuelve 25/01/2013.
Devuelve 24/01/2013.
Devuelve 25/01/2013.
Mostrar la fecha hora completa permite
visualizar el valor numrico subyacente
correspondiente a '25/01/2013
12:00:00.000.'.
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
372
Resultado
];
2/3/2014
03/03/2014 00:00:00
InvoiceData:
LOAD *,
DayName(InvDate, 1) AS DName
Resident TempTable;
Drop table TempTable;
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_tmonth])
Tipo de datos que devuelve: entero
La funcin emplea siempre aos de 366 das.
Argumentos:
Argumento
Descripcin
timestamp
start_
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')
DayNumberOfQuarter('12/09/2014',3)
373
Resultado
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])
Tipo de datos que devuelve: entero
La funcin emplea siempre aos de 366 das.
Argumentos:
Argumento
Descripcin
timestamp
start_
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
374
Ejemplo
Resultado
DayNumberOfYear('12/09/2014')
DayNumberOfYear('12/09/2014',3)
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;
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
daystart
Esta funcin devuelve un valor correspondiente a una indicacin de fecha y hora con el ltimo milisegundo
del trimestre que contiene la fecha y hora 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
timestamp
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
375
Descripcin
precedentes y los valores positivos indican das subsiguientes.
day_start
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')
DStart
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;
376
Sintaxis:
firstworkdate(end_date, no_of_workdays [, holiday] )
Tipo de datos que devuelve: entero
Argumentos:
Argumento
Descripcin
end_date
no_of_
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
Resultado
firstworkdate ('29/12/2014', 9)
Devuelve 17/12/2014.
ProjectTable:
LOAD *, recno() as InvID, INLINE [
377
Resultado
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:
GMT( )
Ejemplo:
gmt( )
hour
Esta funcin devuelve un entero que representa la hora en que la fraccin de la expression se interpreta
como una hora de acuerdo con la interpretacin numrica estndar.
Sintaxis:
hour(expression)
Ejemplos y resultados:
Ejemplo
Resultado
hour( '09:14:36' )
devuelve 9
hour( '0.5555' )
inday
Esta funcin devuelve True si timestamp se encuentra dentro del da que contiene a base_timestamp.
Sintaxis:
378
Descripcin
timestamp
base_
timestamp
period_no
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve True
Devuelve False
Devuelve False
Devuelve True
Devuelve False
Devuelve True
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
InvTime
InDayEx
28/03/2012
-1 (True)
10/12/2012
0
(False)
5/2/2013
0
(False)
379
Resultado
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 *,
InDay(InvTime, '28/03/2013 00:00:00', 0, 4) AS InDayEx
Resident TempTable;
Drop table TempTable;
indaytotime
Esta funcin devuelve True si timestamp se encuentra dentro de la parte del da que contiene base_
Descripcin
timestamp
base_
timestamp
period_no
380
Resultado
Devuelve True
Devuelve False
Devuelve True
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin indaytotime().
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])
Argumentos:
Argumento
Descripcin
timestamp
381
Descripcin
base_date
period_no
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)
inlunarweek('12/01/2013',
'07/01/2013', 0)
inlunarweek('12/01/2013',
'14/01/2013', -1)
inlunarweek('07/01/2013',
'14/01/2013', -1)
inlunarweek('11/01/2006',
'08/01/2006', 0, 3)
InLWeekPlus4
28/03/2012
0 (False)
10/12/2012
0 (False)
382
Resultado
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
];
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)
InvoiceData:
LOAD *,
InLunarWeek(InvDate, '11/01/2013', 4)
AS InLWeekPlus4
Resident TempTable;
Drop table TempTable;
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])
Argumentos:
Argumento
Descripcin
timestamp
base_date
peroid_no
period_no indican semanas lunares precedentes y los valores positivos indican semanas
lunares subsiguientes.
week_start
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:
383
Resultado
inlunarweektodate('12/01/2013', '13/01/2013',
0)
inlunarweektodate('12/01/2013', '11/01/2013',
0)
inlunarweektodate('12/01/2006', '05/01/2006',
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
];
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.
384
Descripcin
timestamp
base_date
period_no
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve True
inmonth('25/01/2013', '01/04/2013', 0)
Devuelve False
Devuelve False
Devuelve True
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin inmonth().
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)
InvoiceData:
385
Resultado
LOAD *,
InMonth(InvDate, '31/01/2013', 0, 4) AS InMthPlus4
Resident TempTable;
Drop table TempTable;
14/5/2014
0 (False)
13/6/2014
0 (False)
7/7/2014
0 (False)
4/8/2014
0 (False)
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])
Return data type: Booleano
Argumentos:
Argumento
Descripcin
n_months
El nmero de meses que define el periodo. Un entero o una expresin que viene a ser un
entero, que debe ser uno de los siguientes: 1 (equivalente a la funcin inmonth()), 2
(bimensual), 3 (equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).
timestamp
base_date
period_no
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.
386
Resultado
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)
387
Resultado
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)
InvoiceData:
LOAD *,
InMonths(2, InvDate, '11/02/2013', 1) AS InMthsPlus1
Resident TempTable;
Drop table TempTable;
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
])
Argumentos:
Argumento
Descripcin
n_months
El nmero de meses que define el periodo. Un entero o una expresin que viene a ser un
entero, que debe ser uno de los siguientes: 1 (equivalente a la funcin inmonth()), 2
(bimensual), 3 (equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).
timestamp
base_date
period_no
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:
388
Ejemplo
Resultado
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)
389
Resultado
7/7/2014
4/8/2014
];
11/12/2013
0 (False)
2/3/2014
0 (False)
InvoiceData:
LOAD *,
InMonthsToDate(2, InvDate, '15/02/2013', 4) AS
InMths2DPlus4
Resident TempTable;
Drop table TempTable;
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)
Argumentos:
Argumento
Descripcin
timestamp
base_date
period_no
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve True
Devuelve False
Devuelve True
390
Resultado
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
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)
InvoiceData:
LOAD *,
InMonthToDate(InvDate, '31/01/2013', 0, 4) AS InMthPlus42D
Resident TempTable;
Drop table TempTable;
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])
Argumentos:
Argumento
Descripcin
timestamps
base_date
period_no
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:
391
Resultado
Devuelve True
Devuelve False
Devuelve False
Devuelve True
Devuelve False
Devuelve True
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin inquarter().
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_
392
Descripcin
timestamp
base_date
period_no
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
Devuelve True
Devuelve False
Devuelve True
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno
de la funcin
inquartertodate().
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)
393
Sintaxis:
InWeek (timestamp, base_date, period_no[, first_week_day])
Argumentos:
Argumento
Descripcin
timestamp
base_date
period_no
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve True
Devuelve False
Devuelve False
Devuelve True
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.
394
Resultado
date: 11/1/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 *,
InWeek(InvDate, '11/01/2013', 4) AS InWeekPlus4
Resident TempTable;
Drop table TempTable;
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_
Descripcin
timestamp
base_date
period_no
395
Resultado
Devuelve True
Devuelve False
Devuelve False
Porque period_no est especificado como -1, el
dato efectivo con el que se mide timestamp es
11/01/2006.
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.
InWeek2DPlus4
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;
396
Sintaxis:
InYear (timestamp, base_date, period_no [, first_month_of_year])
Return data type: Booleano
Argumentos:
Argumento
Descripcin
timestamp
base_date
period_no
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
Devuelve True
Devuelve False
Devuelve False
Devuelve True
Devuelve True
397
Resultado
InvDate
FinYr1213
28/03/2012
0 (False)
10/12/2012
-1 (True)
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)
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
];
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])
Argumentos:
Argumento
Descripcin
timestamp
base_date
398
Descripcin
period_no
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
Devuelve True
Devuelve False
Devuelve True
Devuelve True
El valor de timestamp entra dentro del ao fiscal
que comienza en el cuarto mes y antes del valor de
base_date.
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.
FinYr2Date
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
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)
399
Resultado
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
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_
Argumentos:
Argumento
Descripcin
start_date
no_of_
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.
400
Resultado
lastworkdate ('19/12/2014', 9)
Devuelve '31/12/2014'
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 ]])
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
Ejemplos y resultados:
401
Ejemplo
Resultado
localtime ()
localtime ('London')
localtime
('GMT+02:00')
localtime ('Paris',1')
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
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.
402
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.
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.
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]])
Argumentos:
403
Descripcin
date
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.
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.
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
404
Resultado
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]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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
405
Resultado
significa que el comienzo del ao cambia a
02/01/2013.
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 ] ])
Argumentos:
Argumento
Descripcin
YYYY
El ao como un entero.
MM
DD
El da como un entero.
Si no se especifica un da, se presupone 1 (el primer da del mes).
406
Resultado
makedate(2012)
devuelve 2012-01-01
makedate(12)
devuelve 2012-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 ] ])
Argumentos:
Argumento
Descripcin
hh
mm
ss
Ejemplos y resultados:
Ejemplo
Resultado
maketime( 22 )
devuelve 22:00:00
maketime( 22, 17 )
devuelve 22:17:00
devuelve 22:17:52
makeweekdate
Esta funcin devuelve una fecha calculada a partir del ao YYYY, la semana WW y el da de la semana D.
Sintaxis:
MakeWeekDate(YYYY [ , WW [ , D ] ])
Argumentos:
407
Descripcin
YYYY
El ao como un entero.
WW
Ejemplos y resultados:
Ejemplo
Resultado
makeweekdate(2014,6,6)
devuelve 2014-02-09
makeweekdate(2014,6,1)
devuelve 2014-02-04
makeweekdate(2014,6)
minute
Esta funcin devuelve un entero que representa el minuto en el que la fraccin de la expression se
interpreta como una hora conforme a la interpretacin numrica estndar.
Sintaxis:
minute(expression)
Ejemplos y resultados:
Ejemplo
Resultado
minute ( '09:14:36' )
devuelve 14
minute ( '0.5555' )
month
Esta funcin devuelve un valor dual con un nombre de mes tal y como venga definido en la variable de
entorno MonthNames y un entero entre 1-12. El mes se calcula a partir de la interpretacin de la fecha de la
expresin, conforme a la interpretacin numrica estndar.
Sintaxis:
month(expression)
Ejemplos y resultados:
408
Resultado
month( '2012-10-12' )
devuelve Oct
month( '35648' )
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
period_no
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/02/2012
23:59:59.
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin monthend().
Podemos mostrar la fecha
409
Resultado
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
];
hora completa
especificando el formato
en el panel de
propiedades.
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])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
period_no
Ejemplos y resultados:
410
Ejemplo
Resultado
monthname('19/10/2013')
monthname('19/10/2013', -1)
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_month, date[, period_no [, first_month_of_year]])
411
Argumentos:
Argumento
Descripcin
n_months
El nmero de meses que define el periodo. Un entero o una expresin que viene a ser un
entero, que debe ser uno de los siguientes: 1 (equivalente a la funcin inmonth()), 2
(bimensual), 3 (equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).
date
period_no
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.
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.
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
InvDate
BiMthsEnd
28/03/2012
30/06/2012
10/12/2012
28/02/2013
412
Resultado
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
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
InvoiceData:
LOAD *,
MonthsEnd(2, InvDate, 1) AS BiMthsEnd
Resident TempTable;
Drop table TempTable;
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 una expresin que viene a ser un
entero, que debe ser uno de los siguientes: 1 (equivalente a la funcin inmonth()), 2
(bimensual), 3 (equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).
date
period_no
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:
413
Ejemplo
Resultado
monthsname(4, '19/10/2013')
monthsname(4, '19/10/2013', 0, 2)
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;
414
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 una expresin que viene a ser un
entero, que debe ser uno de los siguientes: 1 (equivalente a la funcin inmonth()), 2
(bimensual), 3 (equivalente a la funcin inquarter()), 4 (cuatrimestre), o 6 (semestre).
date
period_no
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.
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.
La tabla resultante
415
Resultado
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
period_no
Ejemplos y resultados:
416
Ejemplo
Resultado
monthstart('19/10/2001')
Devuelve 01/10/2001.
monthstart('19/10/2001', -1)
Devuelve 01/09/2001.
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.
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
417
Descripcin
start_date
end_date
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
Resultado
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
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
418
Resultado
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;
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.
Sintaxis:
now([ timer_mode])
Argumentos:
Argumento
Descripcin
timer_mode
Ejemplos y resultados:
Ejemplo
Resultado
now( 0)
now( 1)
now( 2)
419
Sintaxis:
QuarterEnd(date[, period_no[, first_month_of_year]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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.
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin quarterend().
Podemos mostrar la
420
Resultado
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]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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_
Si desea trabajar con aos (fiscales) que no comiencen en enero, especifique un valor
421
Descripcin
month_of_
entre 2 y 12 en first_month_of_year.
year
Ejemplos y resultados:
Ejemplo
Resultado
quartername('29/10/2013')
quartername('29/10/2013', -1)
quartername('29/10/2013', 0, 3)
La tabla resultante
contiene las fechas
originales y una columna
con el valor de retorno de
la funcin quartername().
InvDate
QtrName
28/03/2012
Jan-Mar
2011
Because
this reflects
the fiscal
year starting
in 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
422
Resultado
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_yea]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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.
423
Resultado
quarterstart('29/10/2005', 0, 3)
Devuelve 01/09/2005.
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.
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)
Ejemplos y resultados:
424
Resultado
second( '09:14:36' )
devuelve 36
second( '0.5555' )
setdateyear
Esta funcin devuelve una fecha-hora basada en la fecha timestamp introducida, pero reemplazando el ao
por year.
Sintaxis:
setdateyear (timestamp, year)
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
Devuelve '29/102013'
SetYear:
Load *,
SetDateYear(testdates, 2013) as NewYear
Inline [
testdates
1/11/2012
10/12/2012
testdates
NewYear
1/11/2012
1//11/2013
10/12/2012
10/12/2013
425
Resultado
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
];
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
Devuelve una fecha-hora basada en la fecha timestamp introducida, pero con el ao reemplazado por year
y el mes reemplazado por month..
Sintaxis:
SetDateYearMonth (timestamp, year, month)
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
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
Devuelve '29/03/2013'
426
Resultado
en Fecha y escoger un valor de formato que
muestre la hora.
NewYearMonth
1/11/2012
1//3/2013
10/12/2012
10/3/2013
2/1/2012
2/3/2013
1/5/2013
1/3/2013
19/5/2013
19/3/2013
15/9/2013
15/3/2013
11/12/2013
11/3/2013
2/3/2014
2/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( )
Ejemplo:
timezone( )
today
Esta funcin devuelve la fecha actual segn el reloj del sistema.
Sintaxis:
today([ timer_mode])
Argumentos:
427
Descripcin
timer_mode
Ejemplos y resultados:
Ejemplo
Resultado
Today(
0)
Today(
1)
Today(
2)
UTC
Devuelve la actual Coordinated Universal Time.
Sintaxis:
UTC( )
Ejemplo:
utc( )
week
Esta funcin devuelve un entero que representa el nmero de semana conforme a la ISO 8601. El nmero
de semana se calcula a partir de la interpretacin de la fecha de la expresin, conforme a la interpretacin
numrica estndar.
Sintaxis:
week(expression)
428
Resultado
week( '2012-10-12' )
devuelve 44
week( '35648' )
weekday
Esta funcin devuelve un valor dual con lo siguiente:
l
Sintaxis:
weekday(date [,weekstart=0])
Argumentos:
Argumento
Descripcin
date
weekstart
0 para lunes
1 para martes
2 para mircoles
3 para jueves
4 para viernes
5 para sbado
6 para domingo
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
429
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]])
Argumentos:
Argumento
Descripcin
date
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_
day
0 para lunes
1 para martes
2 para mircoles
3 para jueves
4 para viernes
5 para sbado
6 para domingo
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.
430
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.
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.
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
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]])
431
Descripcin
date
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_
day
0 para lunes
1 para martes
2 para mircoles
3 para jueves
4 para viernes
5 para sbado
6 para domingo
Ejemplos y resultados:
Ejemplo
Resultado
weekname('12/01/20013')
Devuelve 2013/02.
weekname('12/01/20013', -1)
Devuelve 2013/01.
weekname('12/01/20013', 0, 1)
Devuelve 2013/02.
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.
InvDate
WkName
432
Resultado
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
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
InvoiceData:
LOAD *,
WeekName(InvDate, 1) AS WkName
Resident TempTable;
Drop table TempTable;
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]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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_
day
0 para lunes
1 para martes
2 para mircoles
433
Descripcin
l
l
l
l
3 para jueves
4 para viernes
5 para sbado
6 para domingo
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.
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.
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
434
Resultado
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)
Ejemplos y resultados:
Ejemplo
Resultado
weekyear( '1996-12-30' )
weekyear( '1997-01-02' )
devuelve 1997
weekyear( '1997-12-28' )
devuelve 1997
weekyear( '1997-12-30' )
weekyear( '1999-01-02' )
Limitaciones:
Algunos aos la semana #1 empieza en diciembre, por ej. diciembre de 1997. Otros aos comienzan con la
semana #53 del ao anterior, por ej. enero de 1999. Para esos pocos das en los que el nmero de semana
corresponda a otro ao, si aplicamos las funciones year and weekyear obtendremos lgicamente valores
diferentes.
year
Esta funcin devuelve un entero que representa el ao en que la expression se interpreta como una fecha
conforme a la interpretacin numrica estndar.
Sintaxis:
year(expression)
Ejemplos y resultados:
435
Resultado
year( '2012-10-12' )
devuelve 2012
year( '35648' )
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]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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.
La tabla resultante
436
Resultado
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
437
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
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.
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;
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
438
Resultado
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 un valor correspondiente a una indicacin de fecha y hora con el primer milisegundo
del primer da del ao que contiene la fecha date. El formato de salida por defecto ser el DateFormat
definido en el script.
Sintaxis:
YearStart(date[, period_no[, first_month_of_year]])
Tipo de datos que devuelve: dual
Argumentos:
Argumento
Descripcin
date
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.
439
Resultado
yearstart ('19/10/2001')
Devuelve 01/01/2001.
Devuelve 01/01/2000.
yearstart ('19/10/2001', 0, 4)
Devuelve 01/04/2001.
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.
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 encuentra si la fecha de entrada cae en el ao de la fecha en la que se carg el script, y
devuelve True en caso afirmativo, y False en caso negativo.
Sintaxis:
YearToDate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
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.
440
Descripcin
date
La fecha que se ha de evaluar como una indicacin de tiempo, por ejemplo '2012-10-12'.
yearoffset
firstmonth
todaydate
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
devuelve True
devuelve True
devuelve False
yeartodate( '2011-04-30', 0, 5)
devuelve False
yeartodate( '2011-05-01', 0, 5)
devuelve True
5.6
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
441
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:
442
exp
La funcin exponencial natural, e^x, usando el algoritmo natural e como base. El resultado es un nmero
positivo.
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.
443
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
5.7
Funciones 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 447)(field_name)
GetNotSelectedCount
444
Descripcin
field_name
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
en First name.
GetAlternativeCount ([First name])
445
Resultados
Sintaxis:
GetCurrentSelections ([record_sep [,tag_sep [,value_sep [,max_values]]]])
Tipo de datos devueltos: cadena
Argumentos:
Argumentos
Descripcin
record_sep
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
446
Ejemplos
Resultados
GetCurrentSelections ()
Initials.
GetCurrentSelections ()
Initials: JA'
Initials.
'First name
=John
Initials=JA'
Puesto que hemos seleccionado todos los nombres excepto Sue en First name y no
'First
name=NOTSue'
447
Argumentos:
Argumentos
Descripcin
field_name
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
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])
estn seleccionados.
GetExcludedCount
([Initials])
GetExcludedCount
([Initials])
First name.
GetExcludedCount ([First
name])
448
Sintaxis:
GetFieldSelections ( field_name [, value_sep [, max_values]])
Tipo de datos devueltos: cadena
Argumentos:
Argumentos
Descripcin
field_name
value_sep
Es el separador que se ha de colocar entre valores de campo. Por defecto es ', '.
max_values
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
'John'
'John,Peter'
seleccionados.
GetFieldSelections ([First name])
'John; Peter'
seleccionados.
GetFieldSelections ([First name],';
')
449
Resultados
name.
Mark.
GetFieldSelections ([First
name],';',2)
Sintaxis:
GetNotSelectedCount(fieldname [, includeexcluded=false])
Argumentos:
Argumento
Descripcin
fieldname
includeexcluded
Ejemplos:
GetNotSelectedCount( Country )
GetNotSelectedCount( Country, true )
450
Descripcin
field_name
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
GetPossibleCount ([Initials])
451
Descripcin
field_name
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
452
5.8
Funciones de archivo
Las funciones de archivo (solo disponibles en expresiones de script) devuelven informacin acerca del
archivo de tabla que se est leyendo en ese momento. Dichas funciones devolvern NULL para todas las
fuentes de datos excepto para los archivos de tabla (excepcin: ConnectString( )).
Attribute
Esta funcin de script devuelve el valor de las meta etiquetas de diversos formatos de archivo como texto.
Estn disponibles los siguientes formatos de archivo: MP3, WMA, WMV, PNG y JPG. Si el archivo
filename no existe, no se admite como formato de archivo o no contiene una metaetiqueta con el nombre
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
453
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 SHGetFolderPath de Microsoft Windows y
devuelve la ruta. Por ejemplo: MyMusic. Observe que la funcin no utiliza los espacios que se ven en
Windows Explorer.
GetFolderPath ()
QvdCreateTime
Esta funcin de script devuelve la 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).
QvdNoOfFields (filename)
QvdNoOfRecords
Esta funcin de script devuelve el nmero de registros que se encuentran actualmente en un archivo QVD.
454
QvdTableName (filename)
Attribute
Esta funcin de script devuelve el valor de las meta etiquetas de diversos formatos de archivo como texto.
Estn disponibles los siguientes formatos de archivo: MP3, WMA, WMV, PNG y JPG. Si el archivo
filename no existe, no se admite como formato de archivo o no contiene una metaetiqueta con el nombre
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.
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.
Absoluta
Ejemplo: c:\data\
l
Ejemplo: data\
attributename
455
456
Ejemplo2: JPEG
Este script lee todas las posibles meta etiquetas EXIF de archivos JPG en la carpeta MyPictures.
457
458
459
460
Ejemplo4: PNG
Este script lee todas las posibles meta etiquetas PNG en la carpeta MyPictures:
461
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
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()
Ejemplos y resultados:
462
Resultado
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
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
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()
Ejemplos y resultados:
463
Resultado
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
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])
Argumentos:
Argumento
Descripcin
filename
Absoluta
Ejemplo: c:\data\
464
Descripcin
l
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;
FileSize(
'lib://MyData/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 ])
Argumentos:
Argumento
Descripcin
filename
Absoluta
Ejemplo: c:\data\
l
Ejemplo: data\
465
Descripcin
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;
FileTime('xyz.xls' )
GetFolderPath
La funcin GetFolderPath devuelve el valor de la funcin SHGetFolderPath de Microsoft Windows y
devuelve la ruta. Por ejemplo: MyMusic. Observe que la funcin no utiliza los espacios que se ven en
Windows Explorer.
Sintaxis:
GetFolderPath()
Ejemplos:
Este script carga tres rutas comunes de carpetas en una tabla.
LOAD
GetFolderPath('Music') as MyMusic,
GetFolderPath('MyPictures') as MyPictures,
GetFolderPath('Windows') as Windows
AutoGenerate 1;
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)
Argumentos:
466
Descripcin
filename
El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.
Absoluta
Ejemplo: c:\data\
l
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)
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.
467
Descripcin
l
Absoluta
Ejemplo: c:\data\
l
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)
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.
Absoluta
Ejemplo: c:\data\
l
Ejemplo: data\
468
Descripcin
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)
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.
Absoluta
Ejemplo: c:\data\
l
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')
469
QvdTableName
Esta funcin de script devuelve el nombre de la tabla almacenada en un archivo QVD.
Sintaxis:
QvdTableName(filename)
Argumentos:
Argumento
Descripcin
filename
El nombre de un archivo QVD, si es necesario incluyendo la ruta, como una carpeta o una
conexin web de datos.
Absoluta
Ejemplo: c:\data\
l
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-).
470
Para todas las funciones financieras es vital que sea consistente cuando especifique unidades
para rate y nper. Si se realizan pagos mensuales en un prstamo a cinco aos con un 6% de
inters anual, utilice 0,005 (6%/12) para el rate y 60 (5*12) para nper. Si se realizan pagos
anuales en el mismo prstamo, utilice 6% para rate y 5 para nper.
FV
Esta funcin devuelve el valor futuro de una inversin basada en pagos peridicos y constantes y a un
porcentaje de inters constante. El resultado tiene un formato numrico predeterminado en money.
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).
471
Descripcin
strike
time_left
underlying_price
vol
risk_free_rate
type
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.
Ejemplos y resultados:
Ejemplo
Resultado
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. Se presupone una volatilidad del 40% anual y un tipo libre de
inters al 4%.
FV
Esta funcin devuelve el valor futuro de una inversin basada en pagos peridicos y constantes y a un
porcentaje de inters constante. El resultado tiene un formato numrico predeterminado en money.
Sintaxis:
FV(rate, nper, pmt [ ,pv [ , type ] ])
Return data type: numeric. El resultado tiene un formato numrico predeterminado de moneda. .
Argumentos:
Argumento
Descripcin
rate
nper
472
Descripcin
pmt
pv
Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.
fv
Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.
type
Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.
Ejemplos y resultados:
Ejemplo
Resultado
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 ] ])
Return data type: numeric
Argumentos:
Argumento
Descripcin
rate
nper
pmt
pv
Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.
fv
Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
473
Descripcin
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
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. El resultado tiene un formato numrico predeterminado en money.
Argumentos:
Argumento
Descripcin
rate
nper
pmt
pv
Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.
fv
Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.
type
Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.
Ejemplos y resultados:
474
Resultado
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. El resultado tiene un formato numrico
predeterminado en money.
Argumentos:
Argumento
Descripcin
rate
nper
pmt
pv
Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.
fv
Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.
type
Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.
Ejemplos y resultados:
Ejemplo
Resultado
Cul es el valor actual de 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)
475
Sintaxis:
Rate(nper, pmt , pv [ ,fv [ , type ] ])
Return data type: numeric.
La tasa o rate se calcula por iteracin y puede tener cero o ms soluciones. Si los resultados sucesivos de
Descripcin
rate
nper
pmt
pv
Es el valor presente, o la cantidad total, que una serie de pagos futuros vale ahora mismo.
Si se omite pv, se asume que ser de 0 (cero) y se deber incluir el argumento pmt.
fv
Es el valor futuro o el balance de efectivo, que se desea lograr tras haberse realizado el
ltimo pago. Si se omite fv, se asume que ser 0.
type
Debe ser 0 si los pagos estn previstos para el final del periodo y 1 si los pagos se prevn
para el comienzo del periodo. Si se omite type, se asume que ser 0.
Ejemplos y resultados:
Ejemplo
Resultado
Cul es el tipo de inters de un prstamo anual de 10.000 $a cinco aos, con pagos
mensuales de 300 $?
Devuelve
2.00%
Rate(60,-300,10000)
476
Por razones de claridad todas las representaciones numricas se dan con un punto decimal
como separador decimal.
Date
La funcin date da formato de fecha a la expresin conforme a la cadena suministrada como format-code.
Dual ( s , x )
Interval
Esta funcin de script da formato a expression como un intervalo de tiempo conforme a la cadena
suministrada como format-code. Si format-code se omite, se utilizar el formato de hora establecido en la
configuracin del sistema operativo.
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si los parmetros 2-4 se omiten, se usar el formato numrico establecido en el sistema
operativo.
Money (expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])
Num
Esta funcin de script da formato numrico a la expresin expression, conforme a la cadena suministrada
como format-code. El separador de decimales y el separador de miles puede establecerse como tercer y
cuarto parmetro. Si los parmetros 2-4 se omiten, se usa el nmero de formato que est establecido en el
sistema operativo.
477
Date
La funcin date da formato de fecha a la expresin conforme a la cadena suministrada como format-code.
Sintaxis:
Date(expression [ , format-code ])
Otra forma de describirla es verla como una conversin de nmero a cadena. La funcin toma el valor
numrico de la expresin y genera una cadena que representa la fecha conforme al cdigo de formato. La
funcin devuelve un valor dual con ambos, la cadena y el nmero.
Argumentos:
Argumento
Descripcin
format-code
Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
YY-MM-DD
M/D/YY
Formato de Fecha
Ejemplo
Resultados
Configuracin 1
Configuracin 2
Date( A ) dondeA=35648
String:
97-08-06
8/6/97
Number:
35648
35648
String:
97-08-06
8/6/97
Number:
35648
35648
String:
06.08.1997
06.08.1997
Number:
35648.375
35648.375
478
Resultados
Configuracin 1
Configuracin 2
String:
NULL (nada)
97.08.06
Number:
NULL
35648
Dual
Con la funcin dual es posible crear combinaciones arbitrarias de un nmero y una cadena.
Sintaxis:
Dual( s , x )
Asociacin forzada de una representacin de cualquier cadena s con un nmero de representacin fijado en
x.
En Qlik Sense, todos los valores de campo son potencialmente valores duales. Esto significa que los valores
de campo pueden tener un valor tanto numrico como de texto. Un ejemplo lo constituira una fecha, que
podra tener un valor numrico de 40908 y la representacin textual 2011-12-31.
Cuando varios elementos de datos en un slo campo tienen una diferente representacin de cadena, pero el
mismo nmero vlido de representacin, compartirn todos la primera representacin de cadena que se
encuentre.
La funcin dual se utiliza habitualmente al principio del script, antes de que otros datos se lean
en el interior del campo al que afecta, para crear esa representacin de primera cadena, la cual
se mostrar en paneles de filtro.
Ejemplos y resultados:
Ejemplo
Descripcin
Esta definicin de campo crear un campo Quarter con los valores textuales
'Q1' a 'Q4' y asignar al mismo tiempo los valores numricos 1 a 4.
Dual(WeekYear(Date) &
'-W' & Week(Date),
WeekStart(Date)) as
YearWeek
Interval
Esta funcin de script da formato a expression como un intervalo de tiempo conforme a la cadena
suministrada como format-code. Si format-code se omite, se utilizar el formato de hora establecido en la
configuracin del sistema operativo.
Sintaxis:
479
Los intervalos se pueden formatear como hora, das, o como una combinacin de das, horas, minutos,
segundos y fracciones de segundos.
Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
AA-MM-DD
Formato de hora:
hh:mm:ss
Ejemplo
Cadena
Nmero
9:00:00
0,375
33:00:00
1,375
1 09:00
1,375
365
09:00
365,375
00:00:00
Num
Esta funcin de script da formato numrico a la expresin expression, conforme a la cadena suministrada
como format-code. El separador de decimales y el separador de miles puede establecerse como tercer y
cuarto parmetro. Si los parmetros 2-4 se omiten, se usa el nmero de formato que est establecido en el
sistema operativo.
Sintaxis:
Num(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ] )
Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
Formato numrico
# ##0,#
#,##0.#
480
Configuracin
Ejemplo
Resultados
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
A=35648
Num( pi( ), '0,00' )
Money
La funcin money da formato numrico a la expresin expression conforme a la cadena suministrada como
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si los parmetros 2-4 se omiten, se usar el formato numrico establecido en el sistema
operativo.
Sintaxis:
Money(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])
Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
kr # ##0,00
$#,##0.00
Formato de moneda
Configuracin
Configuracin
Cadena:
kr 35 648,00
35,648.00 $
Nmero:
35648,00
35648,00
Cadena:
3,564,800
3,564,800
Nmero:
3564800
3564800
Ejemplo
Resultados
A=3564800
Time
La funcin time da formato a la expresin como una hora conforme a la cadena suministrada como formatcode. Si format-code se omite, se utilizar el formato de hora establecido en la configuracin del sistema
operativo.
Sintaxis:
481
Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
hh:mm:ss
hh.mm.ss
Formato de Hora
Ejemplo
Resultados
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
Configuracin 1
Configuracin 2
Timestamp
Esta funcin da formato a la expression como una fecha y hora de acuerdo con la cadena suministrada
como format-code. Si se omite el cdigo de formato, se utilizan los formatos de fecha y hora establecidos
en el sistema operativo.
Sintaxis:
Timestamp(expression [ , format-code ])
Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
AA-MM-DD
M/D/YY
Configuracin
Configuracin
Ejemplo
Resultados
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
482
Resultados
Configuracin
Configuracin
A=35648
00.00
Nmero:
35648
35648
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.
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.
483
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)
mod
Mod() es una funcin matemtica de mdulo que devuelve el resto no negativo de una divisin entera. El
primer argumento es el dividendo y el segundo argumento es el divisor. Ambos argumentos deben ser
valores enteros.
Mod(integer_number1, integer_number2)
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)
484
BitCount
BitCount() halla el nmero de bits del equivalente binario de un nmero fijados en 1. Esto es, la funcin
devuelve el nmero de bits activados en integer_number, donde integer_number se interpreta como un
entero con signo de 32 bits.
Sintaxis:
BitCount(integer_number)
Tipo de datos devueltos: Entero
Ejemplos y resultados:
Ejemplos
Resultados
BitCount ( 3 )
BitCount ( -1 )
Ceil
Ceil() redondea una cifra hacia arriba hasta el mltiplo ms cercano del intervalo step especificado. El
resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es negativo.
Comprelo con la funcin floor, que redondea los nmeros introducidos hacia abajo.
Sintaxis:
485
Resultados
Ceil( 2.4 )
Devuelve 3
Ceil( 2.6 )
Devuelve 3
Devuelve 3,9
Ceil( 3.88 , 5 )
Devuelve 5
Ceil( 1.1 , 1 )
Devuelve 2
Devuelve 1,5
Devuelve 1,99
Combin
Combin() devuelve el nmero de combinaciones de elementos q que se pueden escoger de un grupo de p
elementos. Segn se representa en la frmula: Combin(p,q) = p! / q!(p-q)! El orden en que se seleccionan
los elementos no es significativo.
Sintaxis:
Combin(p, q)
Tipo de datos devueltos: Entero
Limitaciones:
Los elementos no enteros se truncarn.
Ejemplos y resultados:
Ejemplos
Resultados
Devuelve
6.724.520
Combin( 35,7 )
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:
486
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 devueltos: Booleano
Ejemplos y resultados:
Ejemplos
Resultados
Even( 3 )
Devuelve 0, False
Even( 2 * 10 )
Even( 3.14 )
Devuelve NULL
Fabs
Fabs() devuelve el valor absoluto de x. El resultado es un nmero positivo.
Sintaxis:
fabs(x)
Tipo de datos devueltos: numrico
Ejemplos y resultados:
487
Resultados
fabs( 2.4 )
Devuelve 2,4
fabs( -3.8 )
Devuelve 3,8
Fact
Fact() devuelve el nmero factorial de un entero positivo x.
Sintaxis:
Fact(x)
Tipo de datos devueltos: Entero
Limitaciones:
Si el nmero x no es un entero, ser truncado. Los nmeros no positivos devolvern NULL.
Ejemplos y resultados:
Ejemplos
Resultados
Fact( 1 )
Devuelve 1
Fact( 5 )
Fact( -5 )
Devuelve NULL
Floor
Floor() redondea una cifra hacia abajo hasta el mltiplo ms cercano del intervalo step especificado. El
resultado se reduce por el valor de offset, si se especifica uno, o bien se incrementa si offset es negativo.
Comprelo con la funcin ceil, que redondea los nmeros introducidos al alza.
Sintaxis:
Floor(x[, step[, offset]])
Tipo de datos devueltos: numrico
Ejemplos y resultados:
Ejemplos
Resultados
Floor( 2,4 )
Devuelve 0
Floor( 4,2 )
Devuelve 4
488
Resultados
Devuelve 3,8
Floor( 3.88 , 5 )
Devuelve 0
Floor( 1.1 , 1 )
Devuelve 1
Devuelve 0,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)
Tipo de datos devueltos: numrico
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)
489
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 entera. El
primer argumento es el dividendo y el segundo argumento es el divisor. Ambos argumentos deben ser
valores enteros.
Sintaxis:
Mod(integer_number1, integer_number2)
Tipo de datos devueltos: Entero
Limitaciones:
integer_number2 debe ser mayor que 0.
Ejemplos y resultados:
Ejemplos
Resultados
Mod( 7,2 )
Devuelve 1
Mod( 7.5,2 )
Devuelve NULL
Mod( 9,3 )
Devuelve 0
Mod( -4,3 )
Devuelve 2
Mod( 4,-3 )
Devuelve NULL
Mod( -4,-3 )
Devuelve NULL
Odd
Odd() devuelve True (-1) si integer_number es un entero impar o cero. Devuelve False (0) si integer_
number es un entero par y NULL si integer_number no es un entero.
Sintaxis:
Odd(integer_number)
Tipo de datos devueltos: Booleano
490
Resultados
Odd( 3 )
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. Segn se representa en la frmula: Permut(p,q) = (p)! / (p - q)! El orden en que se
seleccionan los elementos es importante.
Sintaxis:
Permut(p, q)
Tipo de datos devueltos: Entero
Limitaciones:
Los argumentos no enteros sern truncados.
Ejemplos y resultados:
Ejemplos
Resultados
De cuntas formas pueden ser distribuidas las medallas de oro, plata y bronce despus
de una final de 100 m con 8 participantes?
Devuelve
336
Permut( 8,3 )
Round
Round() devuelve el resultado de redondear x hacia arriba o hacia abajo hasta el mltiplo ms cercano de
step. El resultado se incrementa por el valor de offset, si se especifica uno, o bien se reduce si offset es
negativo. El valor predeterminado de step es 1.
Si x est exactamente en medio de un intervalo, se redondea hacia arriba.
Sintaxis:
Round(x[, step[, offset]])
Tipo de datos devueltos: numrico
Ejemplos y resultados:
491
Resultados
Round( 3.8 )
Devuelve 4
Round( 3.8, 4 )
Devuelve 4
Round( 2.5 )
Round( 2, 4 )
Round( 2, 6 )
Round( 3.88 ,
0.1 )
Devuelve 3,9
Round( 3.88 , 5
)
Devuelve 5
Round( 1.1 , 1 ,
0.5 )
Devuelve 1,5
Sign
Sign() devuelve 1, 0 o -1 dependiendo de si x es un nmero positivo, 0 o un nmero negativo.
Sintaxis:
Sign(x)
Tipo de datos devueltos: numrico
Limitaciones:
Si no se encuentra valor numrico alguno, devuelve NULL.
Ejemplos y resultados:
Ejemplos
Resultados
Sign( 66 )
Devuelve 1
Sign( 0 )
Devuelve 0
Sign( - 234 )
Devuelve -1
492
Proyeccin
GeoAggrGeometry
Esta funcin se puede utilizar para agregar diversas reas en un rea mayor, por ejemplo agregando
diversas sub-regiones a una regin.
GeoAggrGeometry(geometry)
GeoBoundingBox
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea y calcular el
GeoBoundingBox ms pequeo que contiene todas las coordenadas.
El valor GeoBoundingBox se representa como una lista de cuatro valores: izquierda, derecha, arriba y abajo.
GeoBoundingBox(geometry)
GeoCountVertex
Esta funcin puede utilizarse para obtener un recuento del nmero de vrtices que contiene una geometra
de polgono.
GeoCountVertex(geometry)
GeoGetBoundingBox
Esta funcin puede utilizarse en scripts y expresiones de grfico para calcular el menor GeoBoundingBox
que contiene todas las coordenadas de una geometra.
El valor GeoBoundingBox se representa como una lista de cuatro valores: izquierda, derecha, arriba y abajo.
GeoGetBoundingBox(geometry)
GeoGetPolygonCenter
493
GeoGetPolygonCenter(geometry)
GeoInvProjectGeometry
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea y aplicar la inversa de una
proyeccin.
GeoInvProjectGeometry(projection, geometry)
GeoMakePoint
Esta funcin puede utilizarse en scripts y expresiones de grfico para crear y etiquetar un punto con la latitud
y la longitud.
GeoMakePoint(latitude, longitude )
GeoProject
Esta funcin puede utilizarse en scripts y expresiones de grfico para aplicar una proyeccin a una
geometra.
GeoProject(projection, geometry)
GeoProjectGeometry
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea y aplicar una proyeccin.
GeoProjectGeometry(projection, geometry)
GeoReduceGeometry
Esta funcin puede utilizarse en los scripts para agregar una geometra a un rea.
GeoReduceGeometry(geometry)
Por razones de claridad todas las representaciones numricas se dan con un punto decimal
como separador decimal.
494
Date#
Esta funcin evala la expresin como una fecha de acuerdo con la cadena suministrada como format-
code.Si el cdigo de formato se omite, se usa la fecha por defecto del sistema operativo.
Date# (pgina 496) (expression [ , format-code ])
Interval#
Esta funcin evala la expression como un intervalo de tiempo de acuerdo con la cadena suministrada
como format-code. Si format code se omite, se utilizar el formato de hora establecido en la configuracin
del sistema operativo.
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si se omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de
script o predeterminado en el sistema operativo.
Money# (pgina 497)(expression [ , format-code [ , decimal-sep [ ,
thousands-sep ] ] ])
Num#
Esta funcin evala la expresin numricamente de acuerdo a la cadena suministrada como format-code. El
separador de decimales y el separador de miles puede establecerse como tercer y cuarto parmetro. Si se
omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de script o
predeterminado en el sistema operativo.
495
Date#
Esta funcin evala la expresin como una fecha de acuerdo con la cadena suministrada como format-
code.Si el cdigo de formato se omite, se usa la fecha por defecto del sistema operativo.
Sintaxis:
Date#(expression [ , format-code ])
Argumentos:
Argumento
Descripcin
format-code
Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
YY-MM-DD
M/D/YY
Formato de Fecha
Resultado con
Resultado con
Parmetro 1
Parmetro 2
Cadena:
06/08/1997
06/08/1997
Nmero:
35648
Cadena:
1997.08.08
1997.08.06
Nmero:
35648
35648
Ejemplo
Resultados
A=1997.08.06
Interval#
Esta funcin evala la expression como un intervalo de tiempo de acuerdo con la cadena suministrada
como format-code. Si format code se omite, se utilizar el formato de hora establecido en la configuracin
del sistema operativo.
Sintaxis:
Interval#(expression [ , format-code ])
496
La funcin interval# generalmente se comporta como la funcin time# pero mientras las horas no pueden
ser mayores que 23:59:59 (valor numrico 0.99999) o menores que 00:00:00 (valor numrico 0.00000) un
intervalo puede tener cualquier valor.
Ejemplos y resultados:
Los ejemplos a continuacin asumen las siguientes configuraciones del sistema:
YY-MM-DD
hh:mm:ss
Formato de hora:
Separador de nmeros decimales:
Ejemplo
Resultado
Cadena:
1 09:00
Nmero:
1,375
Cadena:
1,375
Nmero:
1,375
Money#
Esta funcin da formato numrico a la expresin expression, conforme a la cadena suministrada como
format-code. El separador de decimales y el separador de miles puede establecerse como tercer y cuarto
parmetro. Si se omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de
script o predeterminado en el sistema operativo.
Sintaxis:
Money#(expression [ , format-code [ , decimal-sep [ , thousands-sep ] ] ])
La funcin money# generalmente se comporta igual que la funcin num# pero toma sus valores por defecto
para los separadores de miles y de decimales de las variables de script para el formato de moneda, o de las
configuraciones de sistema para la moneda.
Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
Formato de moneda
kr # ##0,00
$#,##0.00
497
Configuracin
Ejemplo
Resultados
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
$35,648.37
Num#
Esta funcin evala la expresin numricamente de acuerdo a la cadena suministrada como format-code. El
separador de decimales y el separador de miles puede establecerse como tercer y cuarto parmetro. Si se
omiten los parmetros 2-4, se usar el formato numrico establecido mediante variables de script o
predeterminado en el sistema operativo.
Sintaxis:
Num#(expression [ , format-code[ , decimal-sep [ , thousands-sep] ] ])
Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
Formato numrico
# ##0,#
#,##0.#
Ejemplo
Resultados
Cadena:
Nmero:
A=35.648,375
Num#( A, '#.#',',','.' ) donde A=35648,375
Configuracin
Configuracin
2
35.648,375
-
35648,375
35648,375
Cadena:
35.648,375
35.648,375
Nmero:
35648,375
35648,375
Cadena:
35648,375
35648,375
Nmero:
35648375
35648375
Cadena:
abc123,4
abc123,4
Nmero:
123,4
1234
Text
La funcin text obliga a tratar como texto la expresin, incluso si es posible una interpretacin numrica.
Sintaxis:
498
Ejemplos y resultados:
Ejemplo
Resultado
Text( pi( ) )
Cadena:
1234
Nmero:
Cadena:
3,1415926535898
Nmero:
Time#
La funcin time# evala la expresin expression conforme a la cadena suministrada como format-code. Si
se omite el cdigo de formato format-code, se utilizar el formato de hora predeterminado en el sistema
operativo..
Sintaxis:
time#(expression [ , format-code ])
Ejemplos y resultados:
Los ejemplos a continuacin asumen las dos configuraciones siguientes del sistema operativo:
Formato de Hora
hh:mm:ss
hh.mm.ss
Ejemplo
Resultados
Cadena:
9:00:00
Nmero:
0,375
Cadena:
09,00
09,00
Nmero:
0,375
0,375
Configuracin 1
Configuracin 2
9:00:00
-
Timestamp#
La funcin timestamp# evala la expression como una fecha de acuerdo con la cadena suministrada como
format-code. Si se omite el format code, se usar el formato de fecha y hora definido en el sistema
operativo.
Sintaxis:
timestamp#(expression [ , format-code ])
499
Formato de Fecha
YY-MM-DD
M/D/YY
Formato de Hora
hh:mm:ss
hh:mm:ss
Configuracin
Configuracin
Cadena:
8/6/97 09:00:00
8/6/97 09:00:00
Nmero:
Cadena:
1997-08-06 09_
00
1997-08-06 09_
00
Nmero:
35648,375
35648,375
Ejemplo
Resultados
A=8/6/97 09_00
35648,375
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.
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.
500
Funciones de columna
Estas funciones slo pueden emplearse en expresiones de grficos.
Column
Column() devuelve el valor hallado en la columna correspondiente a ColumnNo en una tabla simple,
descartando las dimensiones. Por ejemplo, Column(2) devuelve el valor de la segunda columna de la
medida.
501
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)
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
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
502
Previous (expression )
Vea tambin:
p Funciones de rango (pgina 548)
503
Sintaxis:
Above([TOTAL] expr [ , offset [,count]])
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
expr
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
TOTAL
En la primera fila de un segmento de columna se devuelve un valor NULL, dado que no hay ninguna fila por
encima de esta.
504
Limitaciones:
Las llamadas recursivas devolvern NULL.
Ejemplos y resultados:
Ejemplo1:
505
Esta funcin tambin puede utilizarse en grficos distintos de tablas, por ejemplo en grficos
de barras.
Para los dems tipos de grficos, convierta el grfico a la tabla simple equivalente para que
pueda interpretar fcilmente con qu fila est relacionada la funcin.
Ejemplo2:
En los pantallazos de la tablas mostradas en este ejemplo, se han aadido ms dimensiones a las
visualizaciones: Month y Product. Para grficos con ms de una dimensin, los resultados de las
expresiones que contienen las funciones Above, Below, Top y Bottom dependen del orden en que Qlik
Sense clasifica las dimensiones de columna. Qlik Sense evala las funciones basndose en los segmentos
de columna que resultan de la dimensin que se ordena en ltimo lugar. El criterio de ordenacin de
columna se controla en el panel de propiedades bajo Ordenacin y no es necesariamente el orden en que
las columnas aparecen en una tabla.
En la 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.
Ejemplo3:
En la captura de pantalla de la visualizacin de la tabla para el ejemplo 3, la dimensin ordenada en ltimo
lugar es Product. Esto se consigue 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,
506
Ejemplo4:
Resultado
587
563
603
507
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 Below - funcin de grfico (pgina 508)
p Bottom - funcin de grfico (pgina 512)
p Top - funcin de grfico (pgina 531)
p RangeAvg (pgina 551)
Sintaxis:
Below([TOTAL] expression [ , offset [,count ]])
Tipo de datos devueltos: dual
Argumentos:
508
Descripcin
expr
offset
count
TOTAL
En la ltima fila de un segmento de columna, se devolver un valor NULL, puesto que no hay ninguna fila
bajo esta.
Limitaciones:
Las llamadas recursivas devolvern NULL.
Ejemplos y resultados:
Ejemplo1:
509
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
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
Esta funcin tambin puede utilizarse en grficos distintos de tablas, por ejemplo en grficos
de barras.
Para los dems tipos de grficos, convierta el grfico a la tabla simple equivalente para que
pueda interpretar fcilmente con qu fila est relacionada la funcin.
Para grficos con ms de una dimensin, los resultados de las expresiones que contienen las funciones
Above, Below, Top y Bottom dependen del orden en que Qlik Sense clasifica las dimensiones de
columna. Qlik Sense evala las funciones basndose en los segmentos de columna que resultan de la
510
Ejemplo2:
Resultado
659,67
720
757
-
511
Vea tambin:
p Above - funcin de grfico (pgina 504)
p Bottom - funcin de grfico (pgina 512)
p Top - funcin de grfico (pgina 531)
p RangeAvg (pgina 551)
Sintaxis:
Bottom([TOTAL] expr [ , offset [,count ]])
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
expr
offset
count
TOTAL
512
Limitaciones:
Las llamadas recursivas devolvern NULL.
Ejemplos y resultados:
Ejemplo: 1
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
513
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).
514
Ejemplo: 3
Resultado
659,67
659,67
659,67
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.
515
Vea tambin:
p Top - funcin de grfico (pgina 531)
Sintaxis:
Column(ColumnNo)
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
ColumnNo
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
% 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
516
Product
UnitPrice
UnitSales
Order Value
% Sales
DD
25
505
0.00
AA
15
120
505
23.76
CC
19
505
0.00
Customer
Product
UnitPrice
UnitSales
Order Value
% Sales
AA
15
10
150
295
50.85
AA
16
64
295
21.69
BB
81
295
27.46
Ejemplos
Resultados
SeleccioneCustomer A.
517
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
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.
518
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)
Exists(Employee, 'Bill')
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);
Address
Bill
New York
John
Miami
Steve
Chicago
Address
Mary
London
Lucy
Paris
519
FieldIndex
FieldIndex() devuelve la posicin del valor de campo value en el campo field_name (por orden de carga).
Sintaxis:
FieldIndex(field_name , value)
Tipo de datos devueltos: Entero
Argumentos:
Argumento
Descripcin
field_name
Nombre del campo para el que se requiere el ndice. Debe especificarse como valor de
cadena. Esto implica que el nombre del campo debe escribirse entre comillas simples.
value
Limitaciones:
Si value no encuentra el valor entre los valores de campo del campo field_name, devuelve 0.
Ejemplos y resultados:
El ejemplo siguiente utiliza dos campos: First name y Initials.
520
Initials
John
JA
Sue
SB
Mark
MC
Peter
PD
Jane
JE
Peter
PF
Ejemplos
Resultados
MyJohnPos=1,
MyPeterPos=4,
Peter1:
Load FieldIndex('First
name','Peter') as MyPeterPos
Resident Initials;
521
FieldValue
FieldValue()devuelve el valor del campo encontrado en la posicin elem_no del campo field_name (por
orden de carga).
Sintaxis:
FieldValue(field_name , elem_no)
Tipo de datos devueltos: dual
Argumentos:
Argumento
Descripcin
field_name
Nombre del campo para el que se requiere el valor. Debe especificarse como valor de
cadena. Esto implica que el nombre del campo debe escribirse entre comillas simples.
elem_no
Limitaciones:
Si elem_no es mayor que el nmero de valores de campo, devuelve NULL.
First name
Initials
John
JA
Sue
SB
Mark
MC
Peter
PD
Jane
JE
Peter
PF
522
Ejemplos
Resultados
FieldValue('First name','7')
MyPos1=John,
John1:
Load FieldValue('First name',1)
as MyPos1
Resident Initials;
MyPo2s= - (Null),
name.
Peter1:
Load FieldValue('First name',7)
as MyPos2
Resident Initials;
523
FieldValueCount
FieldValueCount() es una funcin integer que encuentra el nmero de valores distintos en un campo.
Sintaxis:
FieldValueCount(field_name)
Argumentos:
Argumento
Descripcin
field_name
Nombre del campo para el que se requiere el valor. Debe especificarse como valor de
cadena. Esto implica que el nombre del campo debe escribirse entre comillas simples.
Ejemplos y resultados:
El ejemplo siguiente utiliza dos campos: First name y Initials.
Ejemplos
Resultados
FieldValueCount('Initials')
se muestran en el ejemplo:
dos veces.
John1:
Load FieldValueCount('First name') as MyFieldCount1
Resident Initials;
se muestran en el ejemplo:
John1:
Load FieldValueCount('Initials') as MyInitialsCount1
Resident Initials;
524
Initials
John
JA
Sue
SB
Mark
MC
Peter
PD
Jane
JE
Peter
PF
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:
lookup(field_name, match_field_name, match_field_value [, table_name])
Return data type: 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).
525
Descripcin
match_
field_name
match_
field_value
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).
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.
Ejemplos y resultados:
Ejemplo
Resultado
Lookup('Category', 'ProductID',
ProductID, 'ProductList')
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 '|');
InvoiceID
CustomerID
Units
CategoryID
526
Resultado
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 '|');
Astrida
Astrida
Betacab
10
Divadip
Divadip
10
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 542)
Sintaxis:
NoOfRows([TOTAL])
Tipo de datos devueltos: Entero
Argumentos:
Argumento
Descripcin
TOTAL
Ejemplo:
if( RowNo( )= NoOfRows( ), 0, Above( sum( Sales )))
527
Vea tambin:
p RowNo - funcin de grfico (pgina 354)
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 ] ] )
Return data type: 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.
table_name
Limitaciones:
En el primer registro de una tabla interna, la funcin devolver NULL.
Ejemplos y resultados:
Ejemplo
Resultado
528
Resultado
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;
table: 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
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
11
11
11,10
10
11,10,1
8,7
13
13
13,2
13,2,78
78
529
Resultado
*,
IF(ID=Peek(ID), Peek(List)&','&Value,Value)
AS List
RESIDENT T1
ORDER BY ID5 ASC;
DROP TABLE T1;
Previous
Previous() encuentra 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)
Return data type: dual
Argumentos:
Argumento
Descripcin
expr
530
Descripcin
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.
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 '|');
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
Sintaxis:
Top([TOTAL] expr [ , offset [,count ]])
Tipo de datos devueltos: dual
531
Descripcin
expr
offset
count
TOTAL
Limitaciones:
Las llamadas recursivas devolvern NULL.
Ejemplos y resultados:
Ejemplo: 1
532
Astrida.
La tabla tambin muestra medidas ms complejas: una creada a partir de Sum(Sales)+Top(Sum(Sales)) y otra
etiquetada Top offset 3, que se crea utilizando la expresin Sum(Sales)+Top(Sum(Sales), 3) y tiene el
argumento offset establecido en 3. Agrega el valor Sum(Sales) para la fila actual al valor de la tercera fila
desde la fila superior, es decir, la fila actual ms el valor de Canutility.
Ejemplo: 2
En los pantallazos de la tablas mostradas en este ejemplo, se han aadido ms dimensiones a las
visualizaciones: Month y Product. Para grficos con ms de una dimensin, los resultados de las
expresiones que contienen las funciones Above, Below, Top y Bottom dependen del orden en que Qlik
Sense clasifica las dimensiones de columna. Qlik Sense evala las funciones basndose en los segmentos
de columna que resultan de la dimensin que se ordena en ltimo lugar. El criterio de ordenacin de
columna se controla en el panel de propiedades bajo Ordenacin y no es necesariamente el orden en que
las columnas aparecen en una tabla.
533
Segunda tabla para el ejemplo 2. El valor de Top para la medida First value basado en Product (AA
paraAstrida).
Ejemplo: 3
Resultado
603
603
603
603
Monthnames:
LOAD * INLINE [
Month, Monthnumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
534
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 Bottom - funcin de grfico (pgina 512)
p Above - funcin de grfico (pgina 504)
p Sum - funcin de grfico (pgina 170)
p RangeAvg (pgina 551)
p Funciones de rango (pgina 548)
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.
Sintaxis:
secondarydimensionality ( )
La funcin secondarydimensionality siempre devuelve 0 cuando se utiliza fuera de las tablas pivotantes.
535
Esta funcin devuelve NULL en todos los tipos de grfico excepto en las tablas pivotantes.
Argumentos:
Argumento
Descripcin
expression
offset
n, uno por cada n filas de tabla contando hacia la derecha desde la celda original.
TOTAL
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 de campos internos
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
536
Argumentos:
Argumento
Descripcin
expression
offset
TOTAL
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 de campos internos
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
537
Descripcin
expression
offset
n, uno por cada n filas de tabla contando hacia la derecha desde la celda original.
TOTAL
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 de campos internos
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 )
538
Descripcin
expression
offset
TOTAL
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 de campos internos
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
539
Descripcin
TOTAL
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 de campos internos
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 )))
Descripcin
TOTAL
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 de campos internos 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 )))
IsNum
Devuelve -1 (True) si la expresin se puede interpretar como un nmero, si no 0 (False).
540
IsText( expr )
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];
Value
IsNum(Value)
IsText(Value)
23
-1
Green
-1
Blue
-1
12
-1
33Red
-1
ApplyMap
541
ApplyMap
La funcin de script ApplyMap sirve para enlazar (o mapear) cualquier expresin con una tabla de
correspondencia previamente cargada.
Sintaxis:
ApplyMap('map_name', expression [ , default_mapping ] )
Argumentos:
Argumento
Descripcin
map_name
expression
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
542
Salesperson
Country
John
Sweden
Mary
Sweden
Per
Sweden
Preben
Denmark
Olle
Denmark
Ole
Norway
Risttu
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)
Argumentos:
Argumento
Descripcin
map_name
expression
Ejemplo:
543
Model
Description
Twixie
Boomer
Raven
Seedling
SeedlingPlus
Younger
MultiStripe
544
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 ASCII 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
545
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.
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,
546
Esta es la tabla resultante. En la columna ValueNullConv, los valores NULL se representan con -.
ID
Value
ValueNullConv
IsItNull
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
547
NULL
Value
Value
548
RangeOnly(first_expr[, Expression])
RangeSum
RangeSum() devuelve la suma de un rango de valores. Todos los valores no numricos se tratan como 0, a
diferencia del operador + .
RangeSum(first_expr[, Expression])
549
550
Vea tambin:
p Funciones inter registro (pgina 500)
RangeAvg
RangeAvg() devuelve el promedio de un rango. Lo introducido en la funcin puede ser o bien un rango de
valores o una expresin.
Sintaxis:
RangeAvg(first_expr[, Expression])
Tipo de datos devueltos: numrico
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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
Devuelve NULL
La tabla resultante
muestra los valores
devueltos de
RangeTab3:
551
Resultados
MyRangeAvg
12.666
6.333
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().
Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.
MyField
RangeAvg (Above
(MyField,0,3))
10
10
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
RangeTab:
LOAD * INLINE [
552
Vea tambin:
p Avg - funcin de grfico (pgina 205)
p Count - funcin de grfico (pgina 174)
RangeCorrel
RangeCorrel() devuelve el coeficiente de correlacin de dos conjuntos de datos. El coeficiente de
correlacin es una medida de la relacin entre los conjuntos de datos.
Sintaxis:
RangeCorrel(x_values , y_values[, Expression])
Tipo de datos que devuelve: numrico
Si introducimos los valores manualmente, debemos introducirlos como pares (x,y). Por ejemplo, para
evaluar dos series de datos: array 1 y array 2 donde el array 1 = 2,6,9 y array 2 = 3,8,4 tendramos que
escribir RangeCorrel (2,3,6,8,9,4) la cual devuelve 0,269.
Argumentos:
Argumento
Descripcin
x-value, 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, los valores NULL y los valores perdidos se descartan.
Ejemplos y resultados:
553
Resultados
RangeCorrel (2,3,6,8,9,4)
Devuelve 0,269
Vea tambin:
p Correl - funcin de grfico (pgina 208)
RangeCount
RangeCount()devuelve el nmero de valores, de texto y numricos que se encuentran dentro del rango o
expresin especificados.
Sintaxis:
RangeCount(first_expr[, Expression])
Tipo de datos que devuelve: entero
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
Limitaciones:
Los valores NULL no se cuentan.
Ejemplos y resultados:
Ejemplos
Resultados
RangeCount (1,2,4)
Devuelve 3
RangeCount (2,'xyz')
Devuelve 2
RangeCount (null( ))
Devuelve 0
Devuelve 2
554
Resultados
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
];
MyRangeCount
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().
RangeCount(Above(MyField,1,3))
10
18
555
Vea tambin:
p Count - funcin de grfico (pgina 174)
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:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
fractile
Un nmero entre 0 y 1
correspondiente al percentil (cuantil
expresado como fraccin) que se debe
calcular.
first_expr
Expression
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
RangeID
MyRangeFrac
4.5
556
Descripcin
5,5,9
9,4,2
];
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
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.
RangeFractile(0.5, Above(Sum(MyField),0,3))
1,5
557
Vea tambin:
p Above - funcin de grfico (pgina 504)
p Fractile - funcin de grfico (pgina 211)
RangeIRR
RangeIRR() devuelve la tasa de rendimiento interno de una serie de flujos de caja representados por los
nmeros en los valores.
Estos flujos de efectivo no tienen por qu ser constantes y parejos, como lo seran en una anualidad. Sin
embargo, s que han de producirse a intervalos regulares, como por ejemplo, en perodos mensuales o
anuales. La tasa interna de devolucin es el ltimo tipo de inters recibido para una inversin consistente en
pagos (valores negativos) e ingresos (valores positivos) que se suceden durante perodos regulares.
Sintaxis:
RangeIRR(value[, value][, 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.
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
La tabla resultante
muestra los valores
558
Resultados
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 '|');
devueltos de
RangeIRR para cada
uno de los registros de
la tabla.
RangeID
RangeIRR
5.000
0.8708
5.8419
0.9318
-0.2566
Vea tambin:
p Funciones inter registro (pgina 500)
RangeKurtosis
RangeKurtosis() devuelve el valor que corresponde a la funcin kurtosis de un rango de nmeros.
Sintaxis:
RangeKurtosis(first_expr[, Expression])
Tipo de datos devueltos: numrico
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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:
559
Resultados
RangeKurtosis (1,2,4,7)
Devuelve -0,28571428571429
Vea tambin:
p Kurtosis - funcin de grfico (pgina 214)
RangeMax
RangeMax() devuelve los valores numricos ms altos que encuentra en la expresin o campo.
Sintaxis:
RangeMax(first_expr[, Expression])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
Limitaciones:
Si no se encuentra valor numrico alguno, devuelve NULL.
Ejemplos y resultados:
Ejemplos
Resultados
RangeMax (1,2,4)
Devuelve 4
RangeMax (1,'xyz')
Devuelve 1
Devuelve NULL
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
560
Resultados
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];
RangeID
MyRangeMax
10
18
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().
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
561
RangeMaxString
RangeMaxString() devuelve el ltimo valor en el orden de texto que encuentra en una expresin o campo.
Sintaxis:
RangeMaxString(first_expr[, Expression])
Tipo de datos devueltos: cadena
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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
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.
Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.
562
RangeMaxString(Above(MaxString(MyField),0,3))
10
10
abc
abc
abc
def
def
xyz
xyz
xyz
Vea tambin:
p MaxString - funcin de grfico (pgina 324)
RangeMin
RangeMin() devuelve los valores numricos ms bajos que encuentra en la expresin o campo.
Sintaxis:
RangeMin(first_expr[, Expression])
Tipo de datos devueltos: numrico
Argumentos:
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
Limitaciones:
563
Ejemplos y resultados:
Ejemplos
Resultados
RangeMin (1,2,4)
Devuelve 1
RangeMin (1,'xyz')
Devuelve 1
Devuelve NULL
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
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().
RangeMin(Above(MyField,0,3))
10
10
18
564
RangeMin(Above(MyField,0,3))
Vea tambin:
p Min - funcin de grfico (pgina 161)
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:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
Ejemplos y resultados:
565
Resultados
RangeMinString (1,2,4)
Devuelve 1
RangeMinString ('xyz','abc')
Devuelve 'abc'
RangeMinString (5,'abc')
Devuelve 5
RangeMinString (null( ))
Devuelve NULL
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.
Data used in examples:
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
566
Vea tambin:
p MinString - funcin de grfico (pgina 327)
RangeMissingCount
RangeMissingCount() halla el nmero de valores no numricos (incluidos los valores NULL) en una
expresin o campo.
Sintaxis:
RangeMissingCount(first_expr[, Expression])
Tipo de datos que devuelve: entero
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
Ejemplos y resultados:
Ejemplos
Resultados
RangeMissingCount (1,2,4)
Devuelve 0
RangeMissingCount (5,'abc')
Devuelve 1
RangeMissingCount (null( ))
Devuelve 1
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.
Data used in examples:
567
Deshabilite la ordenacin de MyField para garantizar que el ejemplo funcione tal como se
espera.
MyField
RangeMissingCount(Above(MinString(MyField),0,3))
Devuelve 2 porque no hay filas por encima de esta fila as que 2 de los 3 valores faltan.
Devuelve 2 porque slo hay 1 fila por encima de la fila actual y la fila actual es no numrica
('abc').
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').
Vea tambin:
p MissingCount - funcin de grfico (pgina 177)
RangeMode
RangeMode() halla el valor que ms veces aparece (valor de la moda) en la expresin o campo.
Sintaxis:
RangeMode(first_expr {, Expression})
Tipo de datos que devuelve: numrico
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
568
Descripcin
first_expr
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
La tabla resultante
muestra los valores
devueltos de
MyRangeMode para cada
uno de los registros de la
tabla.
RangeTab3:
LOAD recno() as RangeID, RangeMax(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
MyRangeoden
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().
569
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
18
18
Vea tambin:
p Mode - funcin de grfico (pgina 164)
RangeNPV
RangeNPV() devuelve el valor actual neto de una inversin basada en un tipo de descuento y una serie de
pagos futuros (valores negativos) e ingresos (valores positivos). El resultado tiene un formato numrico
predeterminado en money.
Sintaxis:
RangeNPV(discount_rate, value[,value][, Expression])
Tipo de datos que devuelve: numrico
Argumentos:
570
Descripcin
discount_
rate
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
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 500)
RangeNullCount
RangeNullCount() halla el nmero de valores NULL en una expresin o campo.
Sintaxis:
RangeNullCount(firstexpr [, Expression])
571
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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
Devuelve 2
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.
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).
null
'xyz'
Devuelve 1 porque el valor dos filas por encima de la fila actual es un valor NULL.
572
Vea tambin:
p NullCount - funcin de grfico (pgina 180)
RangeNumericCount
RangeNumericCount() halla el nmero de valores numricos en una expresin o campo.
Sintaxis:
RangeNumericCount(first_expr[, Expression])
Tipo de datos devueltos: Entero
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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
573
(MyField) evaluada en la fila actual y dos filas por encima de la fila actual.
Data used in examples:
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
Vea tambin:
p NumericCount - funcin de grfico (pgina 182)
RangeOnly
RangeOnly() es una funcin dual que devuelve un valor si la expresin evala a un nico valor. Si este no
es el caso entonces devuelve NULL.
Sintaxis:
RangeOnly(first_expr[, Expression])
Tipo de datos que devuelve: dual
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
574
Resultados
RangeOnly (1,2,4)
Devuelve NULL
RangeOnly (5,'abc')
Devuelve NULL
Devuelve 'abc'
RangeOnly(10,10,10)
Devuelve 10
Vea tambin:
p Only - funcin de grfico (pgina 167)
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:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
Expression
Las expresiones o campos opcionales que contienen el rango de datos que se han de
medir.
Limitaciones:
Si no se encuentra valor numrico alguno, devuelve NULL.
Ejemplos y resultados:
Ejemplos
Resultados
rangeskew (1,2,4)
Devuelve 0,93521952958283
rangeskew (above
(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.
575
RangeSkew(Above(SalesValue,0,3))
1-20
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 240)
RangeStdev
RangeStdev() halla la desviacin estndar de un rango de nmeros.
Sintaxis:
RangeStdev(first_expr[, Expression])
Tipo de datos devueltos: numrico
Argumentos:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
576
Descripcin
first_expr
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.
RangeStdev(SalesValue, 0,3))
1-20
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
577
Vea tambin:
p Stdev - funcin de grfico (pgina 243)
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:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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
La tabla resultante
muestra los valores
devueltos de
MyRangeSum para cada
uno de los registros de la
RangeTab3:
LOAD recno() as RangeID, Rangesum(Field1,Field2,Field3) as MyRangeSum
INLINE [
578
Resultados
tabla.
RangeID
MyRangeSum
21
12
18
38
19
15
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().
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
579
Vea tambin:
p Sum - funcin de grfico (pgina 170)
p Above - funcin de grfico (pgina 504)
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:
Las expresiones de los argumentos de esta funcin pueden contener funciones inter registro con un tercer
parmetro opcional, las cuales devuelven un rango de valores por s mismas.
Argumento
Descripcin
first_expr
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
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.
Data used in examples:
580
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
Vea tambin:
p TextCount - funcin de grfico (pgina 185)
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])
Tipo de datos que devuelve: numrico
Argumentos:
581
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
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 558)
582
Argumentos:
Argumento
Descripcin
discount_
rate
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
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
RangeID
RangeXNPV
$-49.13
583
Resultados
5|5|9000
9|4|2000
] (delimiter is '|');
$777.78
$98.77
$25.51
$250.83
$20.40
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]])
Sintaxis:
Rank([TOTAL [<fld {, fld}>]] expr[, mode[, fmt]])
Tipo de datos devueltos: dual
Argumentos:
584
Descripcin
expr
mode
fmt
TOTAL
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.
Rango ms bajo en la primera fila, incrementado por uno para cada fila.
fmt
El tercer argumento, fmt, puede tomar los siguientes valores:
585
Descripcin
0 (por defecto)
Valor bajo - valor alto en todas las filas (por ejemplo 3 - 4).
El orden de las filas para el mode 4 y fmt 2 viene determinado por el orden de las dimensiones de grfico.
Ejemplos y resultados:
Cree dos visualizaciones a partir de las dimensiones Product y Sales, as como otra a partir de Product y
UnitSales. Agregue medidas tal como se muestra en la tabla siguiente.
Ejemplos
Resultados
Crea una
tabla con las
dimensiones
Customery
Sales y la
medida Rank
(Sales))
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. Observe que
aunque incluso hay 12 valores de Sales, slo se muestran 11 filas, porque dos valores de
Sales son el mismo (78). El siguiente segmento de columna comienza por Betacab, para
el que el primer valor de Sales en el segmento es 12. El valor de rango de Rank(Sales)
para esto viene dado como 11.
Si la tabla se ordena por Sales, los segmentos de columna consisten en los valores de
Sales y el correspondiente cliente Customer. Como hay dos valores de 12 Sales (para
Astrida y Betacab), el valor de Rank(Sales) para ese segmento de columna es de 1-2, para
cada valor de Customer. Esto es porque hay dos valores de Customer para el valor 12 de
Sales. Si hubiera habido 4 valores, el resultado sera 1-4 para todas las filas. Esto muestra
el aspecto que tendr el resultado para el valor por defecto (0) del argumento fmt.
Reemplace
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)
586
Vea tambin:
p Sum - funcin de grfico (pgina 170)
Esta funcin slo funciona en tablas pivotantes. En todos los dems tipos de grficos
devuelve NULL.
Argumentos:
Argumento
Descripcin
expression
mode
format
TOTAL
587
Descripcin
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.
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.
Valor
Descripcin
0 (por defecto)
Valor bajo &' - '&valor alto de todas las columnas del grupo (por ejemplo 3 -
4).
1
valor bajo en la primera columna, vaco en las siguientes columnas del grupo.
588
Ejemplos:
HRank( sum( Sales ))
HRank( sum( Sales ), 2 )
HRank( sum( Sales ), 0, 1 )
CHIIDIST
Esta funcin devuelve la probabilidad de cola 1 de distribucin de chi2. La distribucin chi2 se asocia a una
prueba chi2.
589
CHIDIST
Esta funcin devuelve la probabilidad de cola 1 de distribucin de chi2. La distribucin chi2 se asocia a una
prueba chi2.
Sintaxis:
CHIDIST (value, degrees_freedom)
Argumentos:
Argumento
Descripcin
value
Es el valor con el cual se desea evaluar la distribucin. El valor no debe ser negativo.
degrees_
freedom
Ejemplos y resultados:
Ejemplo
Resultado
CHIDIST(8, 15 )
Devuelve 0,9237827
CHIINV
Esta funcin devuelve el inverso de la probabilidad de cola uno de la distribucin de chi2.
590
Argumentos:
Argumento
Descripcin
prob
Es una probabilidad asociada con la distribucin chi2. Debe ser un nmero ente 0 y 1.
degrees_freedom
Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.
Ejemplos y resultados:
Ejemplo
Resultado
CHIINV(0.9237827, 15 )
Devuelve 8,0000001
FDIST
Esta funcin devuelve la distribucin F.
Sintaxis:
FDIST(value, degrees_freedom1, degrees_freedom2)
Argumentos:
Argumento
Descripcin
value
Es el valor con el cual se desea evaluar la distribucin. Value no debe ser negativo.
degrees_freedom1
degrees_freedom2
Limitaciones:
591
Ejemplos y resultados:
Ejemplo
Resultado
FDIST(15, 8, 6 )
Devuelve 0,0019369
FINV
Esta funcin devuelve el inverso de la distribucin F.
Sintaxis:
FINV (prob, degrees_freedom1, degrees_freedom2)
Argumentos:
Argumento
Descripcin
prob
degrees_freedom
Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.
Ejemplos y resultados:
Ejemplo
Resultado
FINV(0.0019369, 8, 5 )
Devuelve 15,0000197
NORMDIST
Esta funcin devuelve la distribucin normal acumulativa de la media y la desviacin estndar especificadas.
Si mean = 0 y standard_dev = 1, la funcin devuelve la distribucin normal estndar.
Sintaxis:
NORMDIST(value, mean, standard_dev)
592
Descripcin
value
mean
standard_dev
Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.
Ejemplos y resultados:
Ejemplo
Resultado
NORMDIST(0.5, 0, 1 )
Devuelve 0,691462
NORMINV
Esta funcin devuelve el inverso de la distribucin acumulativa normal de la media y la desviacin estndar
especificadas.
Sintaxis:
NORMINV (prob, mean, standard_dev)
Argumentos:
Argumento
Descripcin
prob
Es una probabilidad asociada con la distribucin normal. Debe ser un nmero ente 0 y 1.
mean
standard_dev
Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.
Ejemplos y resultados:
593
Resultado
NORMINV(0.6914625, 0, 1 )
Devuelve 0,4999717
TDIST
Esta funcin devuelve la probabilidad de distribucin t de student, en la que un valor numrico es un valor
calculado de t para el cual hay que calcular la probabilidad.
Sintaxis:
TDIST (value, degrees_freedom, tails)
Argumentos:
Argumento
Descripcin
value
degrees_freedom
tails
Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.
Ejemplos y resultados:
Ejemplo
Resultado
tdist(1, 30, 2 )
Devuelve 0,3253086
TINV
Esta funcin 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)
Argumentos:
594
Descripcin
prob
Es una probabilidad de cola 2 asociada con la distribucin t. Debe ser un nmero ente
0 y 1.
degrees_
freedom
Limitaciones:
Todos los argumentos deben ser numricos; si no, devuelve NULL.
Ejemplos y resultados:
Ejemplo
Resultado
TINV(0.3253086, 30 )
Devuelve 1
ApplyCodepage
Aplica una pginadecdigo diferente al campo o texto indicado en la expresin. Pginadecdigo debe ir en
formato numrico.
ApplyCodepage(text, codepage)
Capitalize
Esta funcin de devuelve la cadena s con todas las palabras en maysculas.
Capitalize ( s )
Chr
Esta funcin devuelve el carcter ASCII correspondiente al nmero n. El resultado es una cadena.
Chr ( n
Evaluate
595
Evaluate ( s )
FindOneOf
Esta funcin devuelve la posicin de la n ocurrencia en la cadena text de cualquiera de los caracteres que se
encuentren en la cadena characterset. Si n se omite, devuelve la posicin de la primera ocurrencia. Si all
no se encontrara ninguna cadena que se corresponda, devuelve 0.
Index
( s1 , s2[ , n] )
KeepChar
Esta funcin devuelve la cadena s1 menos todos los caracteres no contenidos en la cadena s2.
Left ( s , n
Len
Esta funcin de script devuelve la longitud de la cadena s. El resultado es un entero.
596
Lower
Esta funcin pone en minsculas todos los datos de la expresin.
Lower ( textexpression )
LTrim
Esta funcin devuelve la cadena s con todos los espacios iniciales eliminados.
LTrim (s)
Mid
Esta funcin devuelve la cadena que comienza por el carcter n1 con la longitud de n2 caracteres. Si se
omite n2, la funcin devuelve la parte de ms a la derecha de la cadena que comienza en el carcter n1. Las
posiciones en la cadena se numeran desde 1 y hacia arriba.
Ord ( s
PurgeChar
Esta funcin devuelve la cadena s1 menos todos los caracteres contenidos en la cadena s2.
Repeat ( s, n )
Replace
Esta funcin devuelve una cadena tras haber reemplazado todas las veces en que aparece una determinada
subcadena dentro de la cadena s, por otra subcadena. La funcin no es recursiva y funciona de izquierda a
derecha.
Right ( s , n
RTrim
Esta funcin devuelve la cadena s libre de espacios finales.
RTrim ( s )
597
LOAD, la funcin subfield har que la sentencia LOAD genere automticamente un registro completo de
los datos de entrada de cada subcadena que se encuentra en s.
En su versin de dos parmetros, la funcin subfield genera un registro para cada subcadena que puede ser
extrada de una cadena ms larga s con el delimitador 'delimiter'. Usando varias funciones subfield en la
misma sentencia LOAD, se generar el producto cartesiano de todas las combinaciones.
Trim ( s )
Upper
Esta funcin escribe en maysculas todos los datos de la expresin.
Upper ( textexpression )
Capitalize
Esta funcin de devuelve la cadena s con todas las palabras en maysculas.
Sintaxis:
Capitalize( s )
Ejemplos y resultados:
Ejemplo
Resultado
598
Sintaxis:
Chr( n
Ejemplos y resultados:
Ejemplo
Resultado
Chr(65)
Evaluate
Esta funcin de script devuelve el resultado evaluado de la expresin si la cadena de texto s puede ser
evaluada como una expresin vlida de Qlik Sense. Si s no es una expresin vlida, se devuelve NULL.
Sintaxis:
Evaluate( s )
Esta funcin de script no puede utilizarse en expresiones de grficos.
Ejemplos y resultados:
Ejemplo
Resultado
Evaluate ( 5 * 8 )
Devuelve '40'
FindOneOf
Esta funcin devuelve la posicin de la n ocurrencia en la cadena text de cualquiera de los caracteres que se
encuentren en la cadena characterset. Si n se omite, devuelve la posicin de la primera ocurrencia. Si all
no se encontrara ninguna cadena que se corresponda, devuelve 0.
Sintaxis:
FindOneOf(text , characterset [ , n])
Argumento
Descripcin
text
La cadena original.
characterset
599
Resultado
Devuelve '4'
Devuelve '12'
Devuelve '0'
Hash128
Esta funcin devuelve un hash de 128 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.
Sintaxis:
Hash128(expression {, expression})
Ejemplo:
Hash128 ( 'abc', 'xyz', '123' )
Hash128 ( Region, Year, Month )
Hash160
Esta funcin devuelve un hash de 160 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.
Sintaxis:
Hash160(expression {, expression})
Ejemplo:
Hash160 ( Region, Year, Month )
Hash256
Esta funcin devuelve un hash de 256 bits de los valores de entrada combinados de la expresin. El
resultado es una cadena.
Sintaxis:
Hash256(expression {, expression} )
Ejemplo:
Hash256 ( Region, Year, Month )
600
Sintaxis:
Index( s1 , s2[ , n] )
Ejemplos y resultados:
Para un ejemplo ms complejo, vase la funcin index a continuacin.
Ejemplo
Resultado
Index('abcdefg', 'cd' )
Devuelve 3
Index('abcdefg', 'b', 2)
Devuelve 6
Devuelve 2
Devuelve 1997
Devuelve 07
KeepChar
Esta funcin devuelve la cadena s1 menos todos los caracteres no contenidos en la cadena s2.
Sintaxis:
KeepChar(s1 , s2)
Ejemplos y resultados:
Ejemplo
Resultado
KeepChar ( 'a1b2c3','123' )
Devuelve '123'
Left
Esta funcin devuelve una cadena consistente en los primeros n caracteres de s.
Sintaxis:
Left( s , n
Ejemplos y resultados:
601
Ejemplo
Resultado
Left('abcdef', 3)
Devuelve 'abc'
Devuelve '1997'
1997-07-14
Vea tambin:
p Index (pgina 601)
Len
Esta funcin de script devuelve la longitud de la cadena s. El resultado es un entero.
Sintaxis:
Len( s
Ejemplos y resultados:
Ejemplo
Len(Name) where Name =
Resultado
'Peter'
Devuelve '5'
Lower
Esta funcin pone en minsculas todos los datos de la expresin.
Sintaxis:
Lower( textexpression )
Ejemplos y resultados:
Ejemplo
Resultado
Lower('abcD')
Devuelve 'abcd'
LTrim
Esta funcin devuelve la cadena s con todos los espacios iniciales eliminados.
Sintaxis:
LTrim( s )
Ejemplos y resultados:
602
Resultado
Devuelve 'abc'
Mid
Esta funcin devuelve la cadena que comienza por el carcter n1 con la longitud de n2 caracteres. Si se
omite n2, la funcin devuelve la parte de ms a la derecha de la cadena que comienza en el carcter n1. Las
posiciones en la cadena se numeran desde 1 y hacia arriba.
Sintaxis:
Mid(s, n1[, n2 ])
Ejemplos y resultados:
Para un ejemplo ms complejo, vase la funcin index.
Ejemplo
Resultado
Mid('abcdef',3 )
Devuelve 'cdef'
Mid('abcdef',3, 2 )
Devuelve 'cd'
970714
970714
Devuelve '0714'
Devuelve '07'
Vea tambin:
p Index (pgina 601)
Ord
Esta funcin devuelve el nmero ASCII del primer carcter de la cadena s. El resultado es un entero.
Sintaxis:
Ord( s
Ejemplos y resultados:
Ejemplo
Resultado
Ord('A')
603
Sintaxis:
PurgeChar(s1, s2)
Ejemplos y resultados:
Ejemplo
Resultado
PurgeChar ( 'a1b2c3','123' )
Devuelve 'abc'
Repeat
Esta funcin forma una cadena consistente en la cadena s repetida n veces.
Sintaxis:
Repeat( s, n )
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve '****'
Replace
Esta funcin devuelve una cadena tras haber reemplazado todas las veces en que aparece una determinada
subcadena dentro de la cadena s, por otra subcadena. La funcin no es recursiva y funciona de izquierda a
derecha.
Sintaxis:
Replace(s, fromstring ,tostring)
Argumentos:
Argumento
Descripcin
La cadena original.
fromstring
Es una cadena que puede aparecer una o ms veces dentro de una cadena.
tostring
Ejemplos y resultados:
604
Resultado
Replace('abccde','cc','xyz')
Devuelve 'abxyzde'
Right
Esta funcin devuelve una cadena consistente en los ltimos n caracteres de s.
Sintaxis:
Right( s , n
Ejemplos y resultados:
Ejemplo
Resultado
Right('abcdef', 3)
Devuelve 'def'
Devuelve '14'
1997-07-14
RTrim
Esta funcin devuelve la cadena s libre de espacios finales.
Sintaxis:
RTrim( s )
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve 'abc'
SubField
En su versin de tres parmetros, esta funcin devuelve una determinada subcadena de una cadena s ms
larga con el delimitador 'delimiter'. Index es un entero opcional que denota cul de las subcadenas debe
ser el resultado. Al omitir index cuando se usa subfield en una expresin de campo en una sentencia
LOAD, la funcin subfield har que la sentencia LOAD genere automticamente un registro completo de
los datos de entrada de cada subcadena que se encuentra en s.
En su versin de dos parmetros, la funcin subfield genera un registro para cada subcadena que puede ser
extrada de una cadena ms larga s con el delimitador 'delimiter'. Usando varias funciones subfield en la
misma sentencia LOAD, se generar el producto cartesiano de todas las combinaciones.
Sintaxis:
605
Ejemplos y resultados:
Ejemplo
Resultado
SubStringCount
Esta funcin devuelve el nmero de veces que aparece una subcadena dentro de una cadena de texto. El
resultado es un entero. Si no existe coincidencia alguna, devuelve 0.
Sintaxis:
SubStringCount( text , substring)
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve '2'
TextBetween
Esta funcin devuelve el texto entre aparicin n de beforetext y la aparicin inmediatamente posterior de
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve 'abc'
Devuelve 'de'
Trim
Esta funcin devuelve la cadena s libre de espacios iniciales y finales.
Sintaxis:
Trim( s )
606
Ejemplos y resultados:
Ejemplo
Resultado
Devuelve 'abc'
Devuelve 'abc'
Upper
Esta funcin escribe en maysculas todos los datos de la expresin.
Sintaxis:
Upper( textexpression )
Ejemplos y resultados:
Ejemplo
Resultado
Upper(' abcD')
Devuelve 'ABCD'
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.
ClientPlatform()
Esta funcin devuelve la cadena de agente de usuario del navegador cliente. Puede utilizarse tanto en el
script de carga de datos como en una expresin de grficos.
Ejemplo:
607
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.
GetRegistryString(path, key)
OSUser
Esta funcin devuelve una cadena que contiene el nombre del usuario actual, tal como lo devuelve el
608
OSUser( )
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.
Vea tambin:
p GetFolderPath (pgina 466)
Sintaxis:
GetObjectField ([index])
Ejemplo:
GetObjectField(2)
ProductVersion
Esta funcin devuelve el nmero completo de la versin de Qlik Sense como una cadena.
Sintaxis:
ProductVersion()
609
Sintaxis:
StateName ()
Los estados alternos solo se pueden definir y asignar con Qlik Engine API.
Ejemplo1:
Texto Dinmico
='Region - ' & if(StateName() = '$', 'Default', StateName())
Ejemplo2:
Colores Dinmicos
if(StateName() = 'Group 1', rgb(152, 171, 206),
if(StateName() = 'Group 2', rgb(187, 200, 179),
rgb(210, 210, 210)
)
)
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
610
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()
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;
611
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;
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:
612
Descripcin
field_number
table_name
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)
Argumento
Descripcin
field_name
table_name
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');
613
Sintaxis:
NoOfRows(table_name)
Argumentos:
Argumento
Descripcin
table_name
El nombre de la tabla.
Ejemplo:
LET a = NoOfRows('tab1');
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 p.
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 - p/2 y p/2.
614
tan( x )
atan
Tangente inversa de x. El resultado es un nmero entre - p/2 y p/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 - p y + p.
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 )
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),
615
616
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.
6.1
Variables de sistema
Variable
Modo estndar
Modo de legado
Definicin
Floppy
No admitido
Admitido
Devuelve la letra de la
primera unidad de disco
que encuentra,
normalmente a:.
CD
No admitido
Admitido
Devuelve la letra de la
617
Modo estndar
Modo de legado
Definicin
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.
$(include=...)
La variable include
especifica un archivo
que contiene un texto
que debe ser incluido en
el script. As, el script
entero se puede incluir
en un archivo. Esta es
una variable definida por
el usuario.
Modo estndar
Modo de legado
Definicin
Binary
La sentencia binary se
618
Modo estndar
Modo de legado
Definicin
Connect
La sentencia
CONNECT sirve para
La sentencia Directory
Directory
define en qu directorio
buscar archivos de datos
en subsiguientes
sentencias LOAD,
hasta que se incluya una
nueva sentencia
Directory.
Execute
No admitido
La sentencia Execute
sirve para ejecutar otros
programas mientras Qlik
Sense est cargando
datos. Por ejemplo, para
hacer las conversiones
que sean necesarias.
Devuelve la cadena de
bsqueda al ejecutable
de Qlik Sense:
Devuelve el directorio
raz del ejecutable de
Qlik Sense:
Modo estndar
Modo de legado
Definicin
For each...
619
Modo estndar
Modo de legado
Definicin
filelist mask/dirlist
Resultado devuelto:
Conexin a la librera
ruta absoluta/relativa
mask
Resultado devuelto:
Nombre de la conexin
de librera o la ruta
absoluta, dependiendo
de la entrada.
Funciones de archivo
Funcin
Modo estndar
Modo de legado
Definicin
Attribute()
ConnectString()
Resultado devuelto:
Nombre de la conexin
de 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()
Resultado devuelto:
Conexin a la librera
Resultado devuelto:
Nombre de la conexin
de librera o la ruta
absoluta, dependiendo
de la entrada.
La funcin FileDir
Resultado devuelto:
Conexin a la librera
Resultado devuelto:
Nombre de la conexin
de librera o la ruta
absoluta, dependiendo
de la entrada.
La funcin FilePath
FilePath()
620
Modo estndar
Modo de legado
Definicin
FileSize()
La funcin FileSize
La funcin FileTime
No admitido
Resultado devuelto:
Ruta absoluta
La funcin
GetFolderPath
FileTime()
GetFolderPath()
devuelve el valor de la
funcin
SHGetFolderPath de
Microsoft Windows y
devuelve la ruta. Por
ejemplo: MyMusic.
Observe que la funcin
no utiliza los espacios
que se ven en Windows
Explorer.
QvdCreateTime()
621
Modo estndar
Modo de legado
Definicin
QvdFieldName()
QvdNoOfFields()
QvdNoOfRecords()
QvdTableName()
Funciones de sistema
Funcin
Modo estndar
Modo de legado
Definicin
DocumentPath()
No admitido
Resultado devuelto:
Ruta absoluta
GetRegistryString()
No admitido
Admitido
622
6.2
Podemos deshabilitar el modo estndar, o en otras palabras, establecer el modo de legado, a fin de reutilizar
scripts de carga QlikView que se refieran a rutas de archivo absolutas o relativas as como conexiones de
librera.
Qlik Sense
Para Qlik Sense, el modo estndar puede deshabilitarse en QMC utilizando la propiedad de Modo
estndar.
1 (modo estndar)
0 (modo de legado)
623
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
Esta lista describe las sentencias de script de QlikView no admitidas en Qlik Sense.
Sentencia
Comentarios
Add
Este comando solo es relevante durante la recarga parcial, que no es compatible en Qlik
Sense.
Command
InputField
Este comando solo es relevante durante la recarga parcial, que no es compatible en Qlik
Sense.
Replace
7.2
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
IsPartialReload
MsgBox
NoOfReports
ReportComment
ReportId
ReportName
ReportNumber
624
Muchas 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, pero podran eliminarse en versiones
futuras.
8.1
Esta lista describe las sentencias de script de QlikView cuyo uso no se recomienda en Qlik Sense.
Sentencia
Recomendacin
Command
CustomConnect
8.2
Esta lista describe los parmetros de las sentencias de script de QlikView cuyo uso no se recomienda en Qlik
Sense.
Sentencia
Parmetros
Buffer
LOAD
Bottom
Cellvalue
Col
Colmatch
Colsplit
Colxtr
Compound
625
8.3
Contain
Equal
Every
Expand
Filters
Intarray
Interpret
Length
Longer
Numerical
Pos
Remove
Rotate
Row
Rowcnd
Shorter
Start
Strcnd
Top
Transpose
Unwrap
Esta lista describe las funciones de script y de grfico de QlikView cuyo uso no se recomienda en Qlik Sense.
Funcin
Recomendacin
NumAvg
NumCount
NumMax
NumMin
NumSum
QliktechBlue
QliktechGray
RGB(8, 18, 90) y QliktechGray puede sustituirse por RGB(158, 148, 137) para
obtener los mismos colores.
Vea: Funciones de color (pgina 332)
QlikViewVersion
626
Vrank
WildMatch5
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.
627